{"success":true,"schema_version":"1.0.0","request_id":"req_0ecf93f451f44ed1b0d574249ba891e7","timestamp":"2026-11-01T14:49:07.624Z","result":{"id":"F01","name":"inspect_pdf","title":"PDF诊断与元数据","status":"available","phase":"P0","group":"read","description":"Determine page count, dimensions, encryption, text availability and supported features before planning another operation. Do not use this to extract full document text or validate the truth of its contents. Inputs: 1–1 immutable authorized files and the typed parameters below. Returns an asynchronous job, not the final PDF. Poll get_pdf_job, then read artifacts and the receipt. The operation creates stored outputs and may incur charges; specify a cost ceiling. ready文件可完整诊断；restricted仅隔离受限诊断，可能无法取得页数；检测到签名不等于签名有效，不自动解密。","rest":{"method":"POST","path":"/api/v1/pdf/inspect"},"required_scopes":["jobs:create","files:read","pdf:extract"],"engine":"container","rest_input_schema":{"type":"object","properties":{"file_ids":{"type":"array","description":"Ordered authorized immutable inputs","items":{"type":"string","description":"Authorized immutable file ID.","pattern":"^fil_[A-Za-z0-9_-]+$"},"minItems":1,"maxItems":1},"parameters":{"type":"object","properties":{"pages":{"type":"array","description":"One-based page numbers; omitted means all pages.","items":{"type":"integer","description":"Page number","minimum":1},"minItems":1,"maxItems":2000},"include_fonts":{"type":"boolean","description":"Include font inventory","default":false},"include_security_flags":{"type":"boolean","description":"Include active-content and signature flags","default":true}},"required":[],"additionalProperties":false},"execution":{"$ref":"#/components/schemas/Execution"},"client_task_id":{"type":"string","description":"Caller correlation, not an authorization token","maxLength":128}},"required":["file_ids","parameters","execution"],"additionalProperties":false},"input_schema":{"type":"object","properties":{"file_ids":{"type":"array","description":"Ordered authorized immutable inputs","items":{"type":"string","description":"Authorized immutable file ID.","pattern":"^fil_[A-Za-z0-9_-]+$"},"minItems":1,"maxItems":1},"parameters":{"type":"object","properties":{"pages":{"type":"array","description":"One-based page numbers; omitted means all pages.","items":{"type":"integer","description":"Page number","minimum":1},"minItems":1,"maxItems":2000},"include_fonts":{"type":"boolean","description":"Include font inventory","default":false},"include_security_flags":{"type":"boolean","description":"Include active-content and signature flags","default":true}},"required":[],"additionalProperties":false},"execution":{"$ref":"#/components/schemas/Execution"},"client_task_id":{"type":"string","description":"Caller correlation, not an authorization token","maxLength":128},"idempotency_key":{"type":"string","description":"Required project/operation scoped deduplication key shared with REST Idempotency-Key","minLength":8,"maxLength":128}},"required":["file_ids","parameters","execution","idempotency_key"],"additionalProperties":false},"output_schema":{"type":"object","properties":{"success":{"const":true},"schema_version":{"const":"1.0.0"},"request_id":{"type":"string","description":"Request ID"},"timestamp":{"type":"string","description":"Server response time","format":"date-time"},"result":{"$ref":"#/components/schemas/Job"},"sources":{"type":"array","description":"Input provenance","items":{"$ref":"#/components/schemas/Source"},"minItems":0,"maxItems":100},"cache":{"type":"object","properties":{"hit":{"type":"boolean"},"age_seconds":{"type":"integer","description":"Cache age","minimum":0}},"required":["hit","age_seconds"],"additionalProperties":false},"next_actions":{"type":"array","description":"Non-executing suggestions","items":{"type":"object","properties":{"tool":{"type":"string","description":"Tool name"},"arguments":{"type":"object"},"reason":{"type":"string","description":"Reason"},"required_scopes":{"type":"array","description":"Scopes still enforced","items":{"type":"string","description":"Scope"},"minItems":0,"maxItems":20},"requires_confirmation":{"type":"boolean"}},"required":["tool","arguments","reason","required_scopes","requires_confirmation"],"additionalProperties":false},"minItems":0,"maxItems":10}},"required":["success","schema_version","request_id","timestamp","result","sources","next_actions"],"additionalProperties":false},"result_artifact_types":["inspection.json"],"limits_and_semantics":"ready文件可完整诊断；restricted仅隔离受限诊断，可能无法取得页数；检测到签名不等于签名有效，不自动解密。","acceptance":"数字PDF/扫描PDF/混合PDF分别给出逐页文字状态；损坏与需密码区分。","mcp_annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"idempotency":"REST Idempotency-Key / MCP idempotency_key required; shared project/operation deduplication for at least 24h.","doc_url":"/api/v1/capabilities/inspect_pdf","accepted_input_media_types":["application/pdf"],"accepted_file_states":["ready","restricted"],"availability_reason":"Worker runtime enabled"},"sources":[],"cache":{"hit":false,"age_seconds":0},"next_actions":[]}