{"openapi":"3.1.0","info":{"title":"Task402 Agent Evidence Tools","version":"0.3.0","description":"Deterministic PDF, web evidence, OpenAPI, and Base read-only chain tools for agents."},"servers":[{"url":"https://task402.xyz"}],"paths":{"/v1/pricing":{"get":{"operationId":"pricing","responses":{"200":{"description":"Machine-readable pricing and limits."}}}},"/v1/tools":{"get":{"operationId":"tools","responses":{"200":{"description":"Task-oriented tool catalog."}}}},"/v1/web/evidence":{"post":{"operationId":"web_evidence","description":"Paid bounded extraction from a public HTTPS page; no cookies, authentication, or JavaScript execution.","security":[{"x402Payment":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebEvidenceRequest"}}}},"responses":{"200":{"description":"Cited evidence result."},"402":{"description":"Payment required."}}}},"/v1/openapi/inspect":{"post":{"operationId":"inspect_openapi","description":"Inspect a caller-supplied OpenAPI JSON document without fetching remote references.","security":[{"x402Payment":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenApiSpecRequest"}}}},"responses":{"200":{"description":"OpenAPI operation inventory."},"402":{"description":"Payment required."}}}},"/v1/openapi/request-plan":{"post":{"operationId":"plan_api_request","description":"Generate a safe request plan without executing the request.","security":[{"x402Payment":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenApiPlanRequest"}}}},"responses":{"200":{"description":"Request plan."},"402":{"description":"Payment required."}}}},"/v1/openapi/diff":{"post":{"operationId":"diff_openapi","description":"Compare two caller-supplied OpenAPI JSON documents.","security":[{"x402Payment":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenApiDiffRequest"}}}},"responses":{"200":{"description":"Deterministic API diff."},"402":{"description":"Payment required."}}}},"/v1/chain/balance":{"post":{"operationId":"get_chain_balance","description":"Read a native Base balance through a fixed public RPC.","security":[{"x402Payment":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainBalanceRequest"}}}},"responses":{"200":{"description":"Native balance."},"402":{"description":"Payment required."}}}},"/v1/chain/transaction":{"post":{"operationId":"get_chain_transaction","description":"Read one Base transaction and receipt.","security":[{"x402Payment":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainTransactionRequest"}}}},"responses":{"200":{"description":"Transaction status."},"402":{"description":"Payment required."}}}},"/v1/chain/erc20-balance":{"post":{"operationId":"get_erc20_balance","description":"Read one ERC-20 balance on Base.","security":[{"x402Payment":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erc20BalanceRequest"}}}},"responses":{"200":{"description":"Token balance."},"402":{"description":"Payment required."}}}},"/v1/pdf":{"post":{"operationId":"generate_pdf","description":"Paid x402 PDF generation.","security":[{"x402Payment":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeneratePdfRequest"},"example":{"title":"Quarterly report","markdown":"# Summary"}}}},"responses":{"201":{"description":"Generated job."},"402":{"description":"Payment required."}}}},"/v1/documents":{"post":{"operationId":"ingest_document","description":"Paid x402 PDF indexing.","security":[{"x402Payment":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8}},{"name":"X-Document-Recovery-Key","in":"header","required":true,"schema":{"type":"string","minLength":32}},{"name":"X-File-Name","in":"header","required":false,"schema":{"type":"string","maxLength":180}}],"requestBody":{"required":true,"content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"responses":{"201":{"description":"Indexed document."},"402":{"description":"Payment required."},"503":{"description":"Uncertain settlement; do not resubmit automatically."}}}},"/v1/documents/{id}":{"get":{"operationId":"inspect_document","security":[{"documentCapability":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Document metadata and page coverage."}}}},"/v1/documents/{id}/map":{"get":{"operationId":"get_document_map","security":[{"documentCapability":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Page map and positioned text blocks."}}}},"/v1/documents/{id}/search":{"post":{"operationId":"search_document","security":[{"documentCapability":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}}},"responses":{"200":{"description":"Bounded text matches."}}}},"/v1/documents/{id}/batch-search":{"post":{"operationId":"batch_search_document","security":[{"documentCapability":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchSearchRequest"}}}},"responses":{"200":{"description":"Bounded results for multiple queries."}}}},"/v1/documents/{id}/context":{"post":{"operationId":"prepare_document_context","security":[{"documentCapability":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContextRequest"}}}},"responses":{"200":{"description":"Bounded cited context pack."}}}},"/v1/documents/{id}/fields":{"post":{"operationId":"extract_document_fields","security":[{"documentCapability":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FieldsRequest"}}}},"responses":{"200":{"description":"Literal labeled values with page evidence."}}}},"/v1/documents/{id}/read":{"post":{"operationId":"read_document","security":[{"documentCapability":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["pages"],"properties":{"pages":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"integer","minimum":1}}}}}}},"responses":{"200":{"description":"Native text from selected pages."}}}},"/v1/documents/{id}/citation":{"post":{"operationId":"verify_document_citation","security":[{"documentCapability":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["page","quote"],"properties":{"page":{"type":"integer","minimum":1},"quote":{"type":"string","minLength":5,"maxLength":500}}}}}},"responses":{"200":{"description":"Citation presence result with evidence."}}}},"/v1/documents/compare":{"post":{"operationId":"compare_pdfs","security":[{"documentCapability":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["leftId","leftCapability","rightId","rightCapability"],"properties":{"leftId":{"type":"string","format":"uuid"},"leftCapability":{"type":"string"},"rightId":{"type":"string","format":"uuid"},"rightCapability":{"type":"string"}}}}}},"responses":{"200":{"description":"Page-aligned native-text comparison."}}}},"/v1/documents/{id}/validate":{"post":{"operationId":"validate_pdf_text","security":[{"documentCapability":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Text and page-count validation result."}}}},"/v1/documents/{id}/pages/{page}/render":{"get":{"operationId":"render_pdf_page_region","security":[{"documentCapability":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"page","in":"path","required":true,"schema":{"type":"integer","minimum":1}},{"name":"x","in":"query","required":false,"schema":{"type":"number","minimum":0,"maximum":1}},{"name":"y","in":"query","required":false,"schema":{"type":"number","minimum":0,"maximum":1}},{"name":"width","in":"query","required":false,"schema":{"type":"number","minimum":0.001,"maximum":1}},{"name":"height","in":"query","required":false,"schema":{"type":"number","minimum":0.001,"maximum":1}},{"name":"scale","in":"query","required":false,"schema":{"type":"number","minimum":0.5,"maximum":3}}],"responses":{"200":{"description":"Bounded PNG page region.","content":{"image/png":{}}}}}},"/v1/jobs/{id}":{"get":{"operationId":"get_pdf_job","security":[{"documentCapability":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Generation status and capability URLs."}}}},"/v1/jobs/{id}/download":{"get":{"operationId":"download_pdf","security":[{"documentCapability":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Generated application/pdf artifact."}}}}},"components":{"parameters":{"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128}}},"securitySchemes":{"documentCapability":{"type":"http","scheme":"bearer","description":"Short-lived document capability returned after paid indexing."},"x402Payment":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"Base64 encoded x402 v2 payment payload returned by the agent wallet."}},"schemas":{"GeneratePdfRequest":{"type":"object","required":["title","markdown"],"additionalProperties":false,"properties":{"title":{"type":"string","minLength":1,"maxLength":160},"markdown":{"type":"string","minLength":1,"maxLength":245760}}},"SearchRequest":{"type":"object","required":["query"],"additionalProperties":false,"properties":{"query":{"type":"string","minLength":1,"maxLength":200},"page":{"type":"integer","minimum":1},"limit":{"type":"integer","minimum":1,"maximum":20}}},"BatchSearchRequest":{"type":"object","required":["queries"],"additionalProperties":false,"properties":{"queries":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"string","minLength":1,"maxLength":200}},"page":{"type":"integer","minimum":1},"limit":{"type":"integer","minimum":1,"maximum":20}}},"ContextRequest":{"type":"object","required":["query"],"additionalProperties":false,"properties":{"query":{"type":"string","minLength":1,"maxLength":200},"maxChars":{"type":"integer","minimum":1000,"maximum":32000},"pages":{"type":"array","maxItems":100,"items":{"type":"integer","minimum":1}}}},"FieldsRequest":{"type":"object","required":["fields"],"additionalProperties":false,"properties":{"fields":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"object","required":["name","label"],"additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"label":{"type":"string","minLength":1,"maxLength":160},"page":{"type":"integer","minimum":1}}}}}},"WebEvidenceRequest":{"type":"object","required":["url"],"additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","maxLength":2048},"query":{"type":"string","maxLength":200},"max_chars":{"type":"integer","minimum":2000,"maximum":24000}}},"OpenApiSpecRequest":{"type":"object","required":["spec"],"properties":{"spec":{"type":["object","string"]}}},"OpenApiPlanRequest":{"type":"object","required":["spec"],"properties":{"spec":{"type":["object","string"]},"operation_id":{"type":"string"},"path":{"type":"string"},"method":{"type":"string"}}},"OpenApiDiffRequest":{"type":"object","required":["before","after"],"properties":{"before":{"type":["object","string"]},"after":{"type":["object","string"]}}},"ChainBalanceRequest":{"type":"object","required":["address"],"additionalProperties":false,"properties":{"network":{"type":"string","enum":["eip155:8453","eip155:84532"]},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"block":{}}},"ChainTransactionRequest":{"type":"object","required":["tx_hash"],"additionalProperties":false,"properties":{"network":{"type":"string","enum":["eip155:8453","eip155:84532"]},"tx_hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}}},"Erc20BalanceRequest":{"type":"object","required":["token","address"],"additionalProperties":false,"properties":{"network":{"type":"string","enum":["eip155:8453","eip155:84532"]},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"block":{}}}}}}