문서 계산 작업 조회
snapshot = client.document_job(job_ref)
print(snapshot["state"], snapshot["review"], snapshot["diagnostics"])현재 Client의 Project에서 Host가 접수한 작업을 조회합니다. 반환값은 독립된 사전 복사본이며 수정해도 작업에 반영되지 않습니다. 닫힌 Client는 사용할 수 없습니다.
state는 queued, running, succeeded, failed, cancelled, indeterminate 중 하나입니다. 계산이 성공하면 resultRef가 정확한 결과를 가리키고 review는 pending으로 시작합니다. 검토 후에는 accepted 또는 refused가 됩니다. 계산 성공과 검토 승인은 Report 반영 완료를 뜻하지 않습니다.
cancellationRequested는 취소 요청 여부입니다. 실행 중인 로컬 작업은 요청 후에도 worker가 종료를 확인하기 전까지 running일 수 있습니다. diagnostics는 저장된 구조화 진단입니다. 상태 조회는 원본 PDF나 분석 결과를 다시 읽지 않으므로 실패한 작업의 원본이 없어도 진단을 조회할 수 있습니다. 필드 형식은 작업 snapshot V1에 정의돼 있습니다.
sourceRef는 원본 PDF 바이트의 참조입니다. requestRef는 계산 요청과 접수 출처를 함께 묶은 불변 기록의 참조이며, 요청 본문만 해시한 값이나 읽기 권한을 뜻하지 않습니다.
현재 지원 범위는 안정적인 principal을 사용하는 단독 로컬 세션입니다. 관리형 Host의 현재 문서 권한을 해석할 수 없으면 거절합니다. 새 계산 접수는 Host가 명시적으로 활성화한 엔진을 사용하고 Runtime이 실행을 맡습니다. 이 조회 API는 엔진을 설치하거나 계산을 시작하지 않습니다.