{ "openapi": "3.1.0", "info": { "title": "PennyBot: 13 x402 Evidence and Readiness Services", "version": "0.17.3", "description": "Thirteen machine-payable services for public URL observations/assertions, website release and agent metadata checks, x402 preflight, PDF citations, IRS form editions and FIRE/IRIS migration, redacted 1099 readiness, year-end close checklists, tax-year source diffs, ledger/1099-K reconciliation, and submitted-text agent/MCP release security review. Exact input/output schemas, examples, prices, billing rules and durable replay semantics support agent selection. Runtime PAYMENT-REQUIRED remains authoritative.", "x-guidance": "Select the smallest scoped evidence service matching your task. Compare product-specific input limits, billing rules, examples and non-claims. These deterministic services do not promise search rank, semantic truth, tax/legal advice, security certification, browser execution or unconditional recovery. Paid results can include valid negative findings. Replay retains the original observation and does not renew source freshness.", "contact": { "url": "https://playbrightgaming.com/contact_page.php" } }, "servers": [ { "url": "https://playbrightgaming.com" } ], "paths": { "/agent-services/verify-url": { "get": { "operationId": "pennybotRealityReceipt", "summary": "Observe and hash one public HTTP(S) response", "description": "Returns a pennybot.url-receipt.v2 observation after x402 payment. Runtime HTTP 402 is authoritative for payment terms.", "tags": [ "verification", "url", "evidence", "sha256", "agent-tools" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.000900" }, "priceAtomic": "900", "protocols": [ { "x402": {} } ], "network": "eip155:84532", "asset": "USDC", "accountRequired": false, "apiKeyRequired": false, "runtimeAuthority": "HTTP 402 PAYMENT-REQUIRED" }, "parameters": [ { "name": "url", "in": "query", "required": true, "description": "One public HTTP(S) URL. Strict public/global-unicast egress; ports 80/443; <=2048 characters; no credentials/fragments; all redirects revalidated; HTTPS downgrade refused.", "schema": { "type": "string", "format": "uri", "maxLength": 2048, "example": "https://playbrightgaming.com/agents/pennybot-test-vector.txt" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Choose a unique cryptographically random value before the signed purchase; retain it privately with the exact original request and authorization. This is a bearer recovery credential, not a public order label. Never reuse for different input.", "schema": { "type": "string", "minLength": 32, "maxLength": 128, "pattern": "^[A-Za-z0-9_-]+$" } }, { "name": "PAYMENT-SIGNATURE", "in": "header", "required": false, "description": "Omit on the initial valid request to receive HTTP 402 and PAYMENT-REQUIRED. For a purchase, send the base64-encoded x402 payment authorization for those exact terms. This is a per-purchase payment authorization, not an account API key. Retain the original authorization and private Idempotency-Key for recovery; do not sign a new payment merely because delivery is uncertain.", "schema": { "type": "string", "contentEncoding": "base64" } } ], "responses": { "200": { "description": "Successful observation receipt after payment and target fetch.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicUrlReceipt" }, "example": { "receiptVersion": "pennybot.url-receipt.v2", "byteContract": "raw-content-encoded-body", "requestedUrl": "https://playbrightgaming.com/agents/pennybot-test-vector.txt", "finalUrl": "https://playbrightgaming.com/agents/pennybot-test-vector.txt", "status": 200, "contentType": "text/plain", "contentEncoding": "identity", "byteLength": 29, "sha256": "d053565c5bbce20a8970214dd6b46b226e11efd911366267afd8e80b759cf987", "fetchedAt": "2026-10-04T00:00:00.000Z" } } }, "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } }, "X-PennyBot-Result-SHA256": { "description": "SHA-256 of exact retained JSON response bytes.", "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "PAYMENT-RESPONSE": { "description": "Successful first settlement response when present. Not emitted a second time on replay; absence alone does not prove zero charge.", "schema": { "type": "string" } } } }, "202": { "description": "Original order is still processing; do not create a new payment authorization.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotProcessing" } } } }, "400": { "description": "Invalid query/request/URL." }, "402": { "description": "x402 Payment Required. PAYMENT-REQUIRED contains current payment and Bazaar call metadata." }, "403": { "description": "Destination blocked by egress/redirect policy." }, "405": { "description": "Method not allowed." }, "409": { "description": "Original request conflicts or retained result is not ready/available for this order state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRecoveryError" } } } }, "410": { "description": "Original retained result expired. No new work or payment is created. Contains order/settlement headers, not a result-hash header or a second PAYMENT-RESPONSE.", "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRetainedOutputExpired" }, "example": { "order_id": "ord_00000000-0000-4000-8000-000000000000", "error": "retained_output_expired" } } } }, "413": { "description": "Response body exceeds 1 MB." }, "429": { "description": "Global rate or concurrency limit reached." }, "502": { "description": "Invalid redirect or upstream/protocol failure." }, "503": { "description": "Durable storage, recovery, evidence, or service temporarily unavailable. Payment state must be checked separately after a signed attempt." }, "504": { "description": "Fetch/provider/pipeline timeout." } }, "x-example-provenance": "Input/output are illustrative shapes, not a current live observation or a guaranteed verdict. Output examples may describe independent synthetic fixtures.", "externalDocs": { "url": "https://playbrightgaming.com/agents/reality-receipt.md" }, "x-recovery": { "persistentOrderState": true, "sameOriginalRequestRequired": true, "originalIdempotencyKeyRecommended": true, "keyIsBearerCredential": true, "sameSignedAuthorizationReplay": true, "replayReturnsOriginalBody": true, "reexecuteOnReplay": false, "automaticResettleOnReplay": false, "secondPaymentResponseOnReplay": false, "automaticNewAuthorizationRetrySafe": false, "recoveryEndpoint": "https://playbrightgaming.com/agent-services/recover/{order_id}", "acknowledgmentEndpoint": "https://playbrightgaming.com/agent-services/ack/{order_id}", "documentation": "https://playbrightgaming.com/agents/delivery-recovery.md", "resultRetention": { "configuredSeconds": 900, "startsAt": "durable_result_preparation", "localCopyRecommended": true, "uncertainSettlementMayDelayDeletion": true, "freshWindowAfterReconciliation": false }, "retentionGuarantee": null, "settlementUncertainty": "Original identity is reconciled read-only. Retained output may be available while settlement remains uncertain.", "expiredRetainedOutput": { "httpStatus": 410, "error": "retained_output_expired", "appliesTo": [ "purchase_replay", "recover" ], "doesNotCreateNewPayment": true }, "legacyReplay": "Known original orders retain their original result bytes, schema and price. Current advertised terms apply only to new purchases." } } }, "/agent-services/agent-metadata-parity": { "post": { "description": "Compare declared routes, methods, payment terms, resource bindings, structural I/O schemas and service identity across selected public HTTPS metadata. Any INCONCLUSIVE finding makes the report no-charge, including an overall FAIL. Structural supported profiles only; no semantic truth, remote tool execution, paid delivery proof, crawling, authentication, or external schema reference resolution.", "operationId": "pennybotAgentMetadataParity", "requestBody": { "content": { "application/json": { "example": { "origin": "https://playbrightgaming.com", "documents": [ { "kind": "openapi", "path": "/openapi.json" }, { "kind": "llms", "path": "/llms.txt" }, { "kind": "x402", "path": "/.well-known/x402" }, { "kind": "catalog", "path": "/agents/services.json" } ] }, "schema": { "$ref": "#/components/schemas/agent-metadata-parity__input" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "claims": { "paidDelivery": false, "semanticTruth": false, "toolExecution": false }, "coverage": { "comparedFields": 0, "comparedRoutePairs": 0, "parsedSources": 0, "truncatedFindings": false }, "documents": [ { "complete": false, "contentEncoding": null, "contentType": null, "declarations": 0, "decodedBodySha256": null, "decodedBytes": null, "finalUrl": null, "kind": "openapi", "observedAt": "2026-10-06T16:01:55.129Z", "profile": null, "rawBodySha256": null, "rawBytes": null, "reason": "RESPONSE_TOO_LARGE", "redirects": [], "requestedUrl": "https://playbrightgaming.com/openapi.json", "status": null }, { "complete": true, "contentEncoding": "identity", "contentType": "text/plain", "declarations": 0, "decodedBodySha256": "e14844a5aa956525da674ce53e1c3abdaf3209a1f58595f49983be1bb68e5740", "decodedBytes": 21389, "finalUrl": "https://playbrightgaming.com/llms.txt", "kind": "llms", "observedAt": "2026-10-06T16:01:55.213Z", "profile": null, "rawBodySha256": "e14844a5aa956525da674ce53e1c3abdaf3209a1f58595f49983be1bb68e5740", "rawBytes": 21389, "reason": "NO_EXPLICIT_LLMS_ROUTES", "redirects": [], "requestedUrl": "https://playbrightgaming.com/llms.txt", "status": 200 }, { "complete": true, "contentEncoding": "identity", "contentType": "application/json", "declarations": 0, "decodedBodySha256": "a22f5fd8aa262f22e53754dee29457c91be48a75e0fec50723cd5495d5615935", "decodedBytes": 1671, "finalUrl": "https://playbrightgaming.com/.well-known/x402", "kind": "x402", "observedAt": "2026-10-06T16:01:55.252Z", "profile": null, "rawBodySha256": "a22f5fd8aa262f22e53754dee29457c91be48a75e0fec50723cd5495d5615935", "rawBytes": 1671, "reason": "UNSUPPORTED_X402_DESCRIPTOR", "redirects": [], "requestedUrl": "https://playbrightgaming.com/.well-known/x402", "status": 200 }, { "complete": true, "contentEncoding": "identity", "contentType": "application/json", "declarations": 0, "decodedBodySha256": "386186f72e234800da496dce9cec5aab8d1b67ef0207ed94b5dca8fe1a1736ce", "decodedBytes": 96125, "finalUrl": "https://playbrightgaming.com/agents/services.json", "kind": "catalog", "observedAt": "2026-10-06T16:01:55.339Z", "profile": null, "rawBodySha256": "386186f72e234800da496dce9cec5aab8d1b67ef0207ed94b5dca8fe1a1736ce", "rawBytes": 96125, "reason": "UNSUPPORTED_CATALOG_PROFILE", "redirects": [], "requestedUrl": "https://playbrightgaming.com/agents/services.json", "status": 200 } ], "evidenceId": "sha256:3ad39a7f148b9a9183d1910f4e92859db6f02a10c6301bd3c9676c89a7b177a1", "findings": [ { "code": "RESPONSE_TOO_LARGE", "detail": "Document could not be compared under the bounded profile.", "id": "f0001", "refs": [ { "label": "OBSERVED", "location": "HTTP", "sourceUrl": "https://playbrightgaming.com/openapi.json", "valueSha256": null } ], "verdict": "INCONCLUSIVE" }, { "code": "NO_EXPLICIT_LLMS_ROUTES", "detail": "Document could not be compared under the bounded profile.", "id": "f0002", "refs": [ { "label": "OBSERVED", "location": "HTTP", "sourceUrl": "https://playbrightgaming.com/llms.txt", "valueSha256": "e14844a5aa956525da674ce53e1c3abdaf3209a1f58595f49983be1bb68e5740" } ], "verdict": "INCONCLUSIVE" }, { "code": "UNSUPPORTED_X402_DESCRIPTOR", "detail": "Document could not be compared under the bounded profile.", "id": "f0003", "refs": [ { "label": "OBSERVED", "location": "HTTP", "sourceUrl": "https://playbrightgaming.com/.well-known/x402", "valueSha256": "a22f5fd8aa262f22e53754dee29457c91be48a75e0fec50723cd5495d5615935" } ], "verdict": "INCONCLUSIVE" }, { "code": "UNSUPPORTED_CATALOG_PROFILE", "detail": "Document could not be compared under the bounded profile.", "id": "f0004", "refs": [ { "label": "OBSERVED", "location": "HTTP", "sourceUrl": "https://playbrightgaming.com/agents/services.json", "valueSha256": "386186f72e234800da496dce9cec5aab8d1b67ef0207ed94b5dca8fe1a1736ce" } ], "verdict": "INCONCLUSIVE" }, { "code": "INSUFFICIENT_COMPARABLE_DECLARATIONS", "detail": "At least two parsed sources and a matched route with comparable fields are required.", "id": "f0005", "refs": [], "verdict": "INCONCLUSIVE" } ], "hashSemantics": "rawBodySha256 hashes complete HTTP entity bytes before decoding; decodedBodySha256 hashes decoded UTF-8 document bytes. Transfer framing excluded; incomplete entities have no hash.", "observedAt": "2026-10-06T16:01:55.129Z", "origin": "https://playbrightgaming.com", "requestSha256": "3627d54c42ecd3b24b9734bfdf5f23beb65f4856a09a55d2c04a50a6057050dc", "ruleSetVersion": "agent-metadata-parity/1.0.0", "signature": null, "usage": { "decodedBytes": 119185, "rawBytes": 119185, "redirects": 0, "requests": 4 }, "verdict": "INCONCLUSIVE", "warnings": [ "DECLARED_METADATA_IS_NOT_OBSERVED_CAPABILITY_EXECUTION", "NO_BROWSER_JAVASCRIPT_CRAWL_AUTH_OR_LINK_FOLLOWING", "STRUCTURAL_SCHEMA_COMPARISON_NOT_SEMANTIC_EQUIVALENCE", "UNSIGNED_CHECKSUM_NOT_AUTHENTICATED_ATTESTATION", "ONLY_SELECTED_SUPPORTED_FIELDS_ARE_COMPARED" ] }, "schema": { "$ref": "#/components/schemas/agent-metadata-parity__output" } } }, "description": "Successful work matching the output contract", "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } }, "X-PennyBot-Result-SHA256": { "description": "SHA-256 of exact retained JSON response bytes.", "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "PAYMENT-RESPONSE": { "description": "Successful first settlement response when present. Not emitted a second time on replay; absence alone does not prove zero charge.", "schema": { "type": "string" } } } }, "202": { "description": "Original order is still processing; do not create a new payment authorization.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotProcessing" } } } }, "400": { "content": { "application/json": { "schema": { "oneOf": [ { "allOf": [ { "$ref": "#/components/schemas/agent-metadata-parity__failure" }, { "properties": { "error": { "properties": { "code": { "const": "INVALID_INPUT" }, "retryable": { "const": false } }, "type": "object" } }, "type": "object" } ] } ] } } }, "description": "INVALID_INPUT: Invalid definition or blocked caller URL; no work or settlement.", "x-failure-semantics": [ { "code": "INVALID_INPUT", "description": "Invalid definition or blocked caller URL; no work or settlement.", "httpStatus": 400, "retryable": false } ] }, "402": { "description": "x402 Payment Required with authoritative live terms and Bazaar metadata. No metadata fetch or charge for the unpaid challenge." }, "409": { "description": "Original request conflicts or retained result is not ready/available for this order state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRecoveryError" } } } }, "410": { "description": "Original retained result expired. No new work or payment is created. Contains order/settlement headers, not a result-hash header or a second PAYMENT-RESPONSE.", "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRetainedOutputExpired" }, "example": { "order_id": "ord_00000000-0000-4000-8000-000000000000", "error": "retained_output_expired" } } } }, "413": { "content": { "application/json": { "schema": { "oneOf": [ { "allOf": [ { "$ref": "#/components/schemas/agent-metadata-parity__failure" }, { "properties": { "error": { "properties": { "code": { "const": "LIMIT_EXCEEDED" }, "retryable": { "const": false } }, "type": "object" } }, "type": "object" } ] } ] } } }, "description": "LIMIT_EXCEEDED: Input/output definition exceeds hard bounds; no settlement.", "x-failure-semantics": [ { "code": "LIMIT_EXCEEDED", "description": "Input/output definition exceeds hard bounds; no settlement.", "httpStatus": 413, "retryable": false } ] }, "429": { "content": { "application/json": { "schema": { "oneOf": [ { "allOf": [ { "$ref": "#/components/schemas/agent-metadata-parity__failure" }, { "properties": { "error": { "properties": { "code": { "const": "BUSY" }, "retryable": { "const": true } }, "type": "object" } }, "type": "object" } ] } ] } } }, "description": "BUSY: Four audits already active; no queue or settlement.", "x-failure-semantics": [ { "code": "BUSY", "description": "Four audits already active; no queue or settlement.", "httpStatus": 429, "retryable": true } ] }, "500": { "content": { "application/json": { "schema": { "oneOf": [ { "allOf": [ { "$ref": "#/components/schemas/agent-metadata-parity__failure" }, { "properties": { "error": { "properties": { "code": { "const": "INTERNAL_ERROR" }, "retryable": { "const": false } }, "type": "object" } }, "type": "object" } ] } ] } } }, "description": "INTERNAL_ERROR: Internal validation or implementation failure; no settlement.", "x-failure-semantics": [ { "code": "INTERNAL_ERROR", "description": "Internal validation or implementation failure; no settlement.", "httpStatus": 500, "retryable": false } ] }, "503": { "description": "Durable storage, recovery, evidence, or service temporarily unavailable. Payment state must be checked separately after a signed attempt." } }, "summary": "Agent Metadata Parity Check", "tags": [ "metadata-parity", "openapi", "llms", "agent-card", "x402", "evidence" ], "x-billing": { "PASS": "chargeable only when every finding is determinate", "FAIL": "chargeable only when every finding is determinate", "INCONCLUSIVE": "no-charge", "anyInconclusiveFinding": "no-charge, including an overall FAIL", "declaredServiceFailure": "no-charge" }, "x-cost": { "class": "small", "pricingRationale": "0.005 USDC per fully determined report. Bounded documents and parsing; no production cost or margin claim. Any INCONCLUSIVE finding is no-charge." }, "x-latency": { "basis": "estimate", "expectedP50Ms": 250, "expectedP95Ms": 3000 }, "x-limits": { "inputBytes": 16384, "outputBytes": 131072, "perDocumentBytes": 262144, "aggregateRawBytes": 1048576, "aggregateDecodedBytes": 1048576, "documents": 6, "routes": 32, "findings": 160, "requests": 8, "redirects": 2, "deadlineMs": 10000, "concurrency": 4 }, "x-selection": { "chooseWhen": [ "You need deterministic cross-document declaration checks for one public HTTPS origin.", "You can use the explicit supported OpenAPI, llms, x402, factory catalog/service-info or agent-card profiles." ], "doNotChooseWhen": [ "You need semantic correctness, tool execution, paid delivery, full standards validation, authenticated metadata, crawling or browser/JavaScript rendering.", "You need arbitrary schema dialects or external reference resolution; unsupported forms remain INCONCLUSIVE." ] }, "x-stage": "live", "x-x402": { "amount": "0.005", "atomicAmount": "5000", "currency": "USDC", "decimals": 6, "network": "eip155:84532", "scheme": "exact", "status": "live-runtime-authoritative", "resource": "https://playbrightgaming.com/agent-services/agent-metadata-parity" }, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005000" }, "priceAtomic": "5000", "protocols": [ { "x402": {} } ], "network": "eip155:84532", "asset": "USDC", "accountRequired": false, "apiKeyRequired": false, "runtimeAuthority": "HTTP 402 PAYMENT-REQUIRED" }, "x-durability": { "persistentOrderState": true, "sameSignedAuthorizationReplayReturnsSameOrder": true, "sameEvidenceReplay": true, "automaticResettleOnReplay": false }, "x-testnet-endpoint": "https://playbrightgaming.com/agent-services/agent-metadata-parity", "x-staging-definition-sha256": "771fc3733e0d73cb647dd64f5d2bff060a5644baeae0fcecb145d455da074b14", "x-example-provenance": "Input/output are illustrative shapes, not a current live observation or a guaranteed verdict. Output examples may describe independent synthetic fixtures.", "externalDocs": { "url": "https://playbrightgaming.com/agents/agent-metadata-parity.md" }, "x-recovery": { "persistentOrderState": true, "sameOriginalRequestRequired": true, "originalIdempotencyKeyRecommended": true, "keyIsBearerCredential": true, "sameSignedAuthorizationReplay": true, "replayReturnsOriginalBody": true, "reexecuteOnReplay": false, "automaticResettleOnReplay": false, "secondPaymentResponseOnReplay": false, "automaticNewAuthorizationRetrySafe": false, "recoveryEndpoint": "https://playbrightgaming.com/agent-services/recover/{order_id}", "acknowledgmentEndpoint": "https://playbrightgaming.com/agent-services/ack/{order_id}", "documentation": "https://playbrightgaming.com/agents/delivery-recovery.md", "resultRetention": { "configuredSeconds": 900, "startsAt": "durable_result_preparation", "localCopyRecommended": true, "uncertainSettlementMayDelayDeletion": true, "freshWindowAfterReconciliation": false }, "retentionGuarantee": null, "settlementUncertainty": "Original identity is reconciled read-only. Retained output may be available while settlement remains uncertain.", "expiredRetainedOutput": { "httpStatus": 410, "error": "retained_output_expired", "appliesTo": [ "purchase_replay", "recover" ], "doesNotCreateNewPayment": true }, "legacyReplay": "Known original orders retain their original result bytes, schema and price. Current advertised terms apply only to new purchases." }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Choose a unique cryptographically random value before the signed purchase; retain it privately with the exact original request and authorization. This is a bearer recovery credential, not a public order label. Never reuse for different input.", "schema": { "type": "string", "minLength": 32, "maxLength": 128, "pattern": "^[A-Za-z0-9_-]+$" } }, { "name": "PAYMENT-SIGNATURE", "in": "header", "required": false, "description": "Omit on the initial valid request to receive HTTP 402 and PAYMENT-REQUIRED. For a purchase, send the base64-encoded x402 payment authorization for those exact terms. This is a per-purchase payment authorization, not an account API key. Retain the original authorization and private Idempotency-Key for recovery; do not sign a new payment merely because delivery is uncertain.", "schema": { "type": "string", "contentEncoding": "base64" } } ] } }, "/agent-services/x402-readiness-preflight": { "post": { "description": "Observe one exact public HTTPS bodyless GET, HEAD or OPTIONS request without paying the target. Check x402 v2 exact EVM EIP-3009 challenge declarations, resource binding, price arithmetic, EIP-712 metadata and supported Bazaar request compatibility. Any INCONCLUSIVE finding makes the report no-charge, including an overall FAIL. Unpaid observation does not prove settlement, replay safety, delivery correctness, merchant honesty, actual signability or general security. No caller credentials, cookies, arbitrary headers, signing, wallets, settlement execution, browser/remote-tool execution, arbitrary crawl or security certification. The target is never probed with POST or another mutating method. The seven-second budget cancels DNS/sockets and stops new work. Bounded synchronous JS cannot provide a hard real-time preemption guarantee. Query values are literal data encoded once with URLSearchParams, including public HTTPS URL values. Route-only resource identifiers do not establish query binding and remain INCONCLUSIVE/no-charge. Unsupported Bazaar URI/schema constraints remain INCONCLUSIVE; query examples are not required literals and metadata equality is not cryptographic binding.", "operationId": "pennybotX402ReadinessPreflight", "requestBody": { "content": { "application/json": { "example": { "endpoint": "https://playbrightgaming.com", "method": "GET", "path": "/agent-services-mainnet/verify-url", "query": [ { "name": "url", "value": "https://playbrightgaming.com/agents/pennybot-test-vector.txt" } ], "bodyShape": { "type": "none" } }, "schema": { "$ref": "#/components/schemas/x402-readiness-preflight__input" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "claims": { "actualSignability": false, "deliveryCorrectness": false, "generalSecurity": false, "merchantHonesty": false, "paidSettlement": false, "replaySafety": false }, "evidenceId": "sha256:3ace29bc72b095aa3c5c804508e0da029e670072a2e86dcec5e4097f657b125b", "findings": [ { "check": "http_status", "code": "HTTP_402", "detail": "Observed HTTP status 402.", "option": null, "pointer": "", "verdict": "PASS" }, { "check": "challenge_header", "code": "PAYMENT_REQUIRED_PRESENT", "detail": "A single v2 header was observed.", "option": null, "pointer": "", "verdict": "PASS" }, { "check": "challenge_encoding", "code": "CHALLENGE_DECODED", "detail": "Strict canonical base64, UTF-8 and duplicate-free bounded JSON decoded.", "option": null, "pointer": "", "verdict": "PASS" }, { "check": "x402_version", "code": "X402_V2", "detail": "Numeric x402Version 2 declared.", "option": null, "pointer": "/x402Version", "verdict": "PASS" }, { "check": "resource_binding", "code": "RESOURCE_QUERY_BINDING_UNPROVEN", "detail": "Declared resource matches origin and path but omits this query. Route-level identifiers are supported; exact query binding was not established by this unpaid observation.", "option": null, "pointer": "/resource/url", "verdict": "INCONCLUSIVE" }, { "check": "exact_request", "code": "EXACT_REQUEST_OBSERVED", "detail": "The intended safe method, path and query were sent without a body.", "option": null, "pointer": "", "verdict": "PASS" }, { "check": "request_compatibility", "code": "REQUEST_SCHEMA_UNSUPPORTED", "detail": "The declaration is absent or outside the bounded bodyless Bazaar schema profile.", "option": null, "pointer": "/extensions/bazaar", "verdict": "INCONCLUSIVE" }, { "check": "scheme", "code": "EXACT_SCHEME", "detail": "Only the exact EVM EIP-3009 metadata profile is understood.", "option": 0, "pointer": "/accepts/0/scheme", "verdict": "PASS" }, { "check": "network", "code": "NETWORK_KNOWN", "detail": "Network format and caller expectation checked against the frozen local registry.", "option": 0, "pointer": "/accepts/0/network", "verdict": "PASS" }, { "check": "asset", "code": "ASSET_KNOWN", "detail": "Address syntax, expected asset and frozen token metadata checked; no chain lookup.", "option": 0, "pointer": "/accepts/0/asset", "verdict": "PASS" }, { "check": "atomic_amount", "code": "ATOMIC_AMOUNT_VALID", "detail": "Require a canonical positive decimal integer string within uint256.", "option": 0, "pointer": "/accepts/0/amount", "verdict": "PASS" }, { "check": "display_price", "code": "DISPLAY_PRICE_DERIVED", "detail": "Exact integer arithmetic using the frozen USDC six-decimal registry; not a market USD valuation.", "option": 0, "pointer": "/accepts/0/amount", "verdict": "PASS" }, { "check": "pay_to", "code": "PAY_TO_FORMAT_VALID", "detail": "Nonzero EVM address syntax and optional caller expectation only; ownership and honesty unproven.", "option": 0, "pointer": "/accepts/0/payTo", "verdict": "PASS" }, { "check": "payment_timeout", "code": "PAYMENT_TIMEOUT_PRESENT", "detail": "Declared payment timeout is separate from the seven-second probe deadline; values over one day are unsupported.", "option": 0, "pointer": "/accepts/0/maxTimeoutSeconds", "verdict": "PASS" }, { "check": "eip712_domain", "code": "EIP712_DOMAIN_PRESENT", "detail": "Require bounded nonempty extra.name/version and match known domain metadata; no signing performed.", "option": 0, "pointer": "/accepts/0/extra", "verdict": "PASS" }, { "check": "signability_metadata", "code": "SIGNABILITY_METADATA_PRESENT", "detail": "Only metadata prerequisites are checked; no wallet, signature, balance, authorization, nonce, facilitator or settlement is tested.", "option": 0, "pointer": "/accepts/0/extra", "verdict": "PASS" } ], "limitations": [ "Unpaid probing cannot prove paid settlement, replay safety, delivery correctness, merchant honesty, or general security.", "PASS means the supported metadata checks passed for this observation, not that payment or signing will succeed.", "Only safe, bodyless GET/HEAD/OPTIONS are sent. Credentials, mutating methods, request bodies and crawling are rejected.", "Token and domain metadata use a frozen local registry; no chain, wallet, balance, nonce or facilitator is queried.", "Error bodies are opaque raw bytes, including gzip. Raw entity hashes exclude HTTP framing; challenge header hashes cover parsed field values.", "Evidence is an unsigned checksum, not proof of origin. All advertised options are checked; FAIL dominates unknowns.", "The seven-second budget cancels DNS/sockets and stops new work. Bounded synchronous JS cannot provide a hard real-time preemption guarantee.", "Route-only resource identifiers are supported declarations, but omitted query binding remains INCONCLUSIVE/no charge. Unsupported URI/schema constraints remain unknown; metadata equality is not cryptographic binding." ], "observation": { "bodyShape": { "type": "none" }, "complete": true, "contentEncoding": "identity", "decodedChallengeSha256": "0623c9a914b5034f93e872fafc416f5af513cdc0dc4bf26c745aadc506c23eb8", "failure": null, "finalUrl": "https://playbrightgaming.com/agent-services-mainnet/verify-url?url=https%3A%2F%2Fplaybrightgaming.com%2Fagents%2Fpennybot-test-vector.txt", "headerSha256": "529416ccf0431b7f9644c7ec711d58290e6319c673a61c3803527bd4cccdc8d5", "httpStatus": 402, "method": "GET", "observedAt": "2026-10-06T16:40:57.205Z", "paymentRequiredValues": [ "eyJ4NDAyVmVyc2lvbiI6MiwiZXJyb3IiOiJQYXltZW50IHJlcXVpcmVkIiwicmVzb3VyY2UiOnsidXJsIjoiaHR0cHM6Ly9wbGF5YnJpZ2h0Z2FtaW5nLmNvbS9hZ2VudC1zZXJ2aWNlcy1tYWlubmV0L3ZlcmlmeS11cmwiLCJkZXNjcmlwdGlvbiI6IlB1YmxpYyBVUkwgdmVyaWZpY2F0aW9uIEFQSSBmb3IgQUkgYWdlbnRzLiBJbmRlcGVuZGVudGx5IGZldGNoIG9uZSBwdWJsaWMgSFRUUChTKSBVUkwgYW5kIHJldHVybiB0YXJnZXQgSFRUUCBzdGF0dXMsIGZpbmFsIFVSTCwgcmF3IHJlc3BvbnNlLWJvZHkgU0hBLTI1NiBjb250ZW50IGZpbmdlcnByaW50LCBjb250ZW50IHR5cGUvZW5jb2RpbmcsIGJ5dGUgbGVuZ3RoLCBhbmQgVVRDIG9ic2VydmF0aW9uIHRpbWUuIFVzZSBmb3IgVVJMIGludGVncml0eSB2ZXJpZmljYXRpb24sIHdlYnNpdGUgY2hhbmdlIGRldGVjdGlvbiwgY29udGVudCBmaW5nZXJwcmludHMsIGFuZCB3ZWIgZXZpZGVuY2UuIFJlY2VpcHQgdjIgaGFzaGVzIGNvbnRlbnQtZW5jb2RlZCBieXRlcyB3aXRob3V0IGFwcGxpY2F0aW9uIGRlY29tcHJlc3Npb247IDEgTUIgbWF4LCBvbmUgNy1zZWNvbmQgZmV0Y2ggZGVhZGxpbmUsIG1heCB0aHJlZSByZWRpcmVjdHMsIHBvcnRzIDgwLzQ0MyBvbmx5LiIsIm1pbWVUeXBlIjoiYXBwbGljYXRpb24vanNvbiIsInNlcnZpY2VOYW1lIjoiUHVibGljIFVSTCBDaGVjayArIFNIQS0yNTYgLSBQZW5ueUJvdCIsInRhZ3MiOlsicHVibGljLXVybC1jaGVjayIsInVybC12ZXJpZmljYXRpb24iLCJ1cmwtZGlnZXN0IiwiaHR0cC1zdGF0dXMiLCJzaGEyNTYiLCJjb250ZW50LWhhc2giLCJjb250ZW50LWZpbmdlcnByaW50IiwidXJsLWludGVncml0eSIsIndlYnNpdGUtY2hhbmdlLWRldGVjdGlvbiIsImluZGVwZW5kZW50LWZldGNoIiwid2ViLWV2aWRlbmNlIiwiYWdlbnQtdG9vbHMiXX0sImFjY2VwdHMiOlt7InNjaGVtZSI6ImV4YWN0IiwibmV0d29yayI6ImVpcDE1NTo4NDUzIiwiYW1vdW50IjoiOTAwIiwiYXNzZXQiOiIweDgzMzU4OWZDRDZlRGI2RTA4ZjRjN0MzMkQ0ZjcxYjU0YmRBMDI5MTMiLCJwYXlUbyI6IjB4YjJhNmI5N2I3NjMzNGNhZWY0YmRiZTJkNWE1ZDc4NDk0MTAxM2JiMyIsIm1heFRpbWVvdXRTZWNvbmRzIjozMDAsImV4dHJhIjp7Im5hbWUiOiJVU0QgQ29pbiIsInZlcnNpb24iOiIyIn19XSwiZXh0ZW5zaW9ucyI6eyJiYXphYXIiOnsiaW5mbyI6eyJpbnB1dCI6eyJ0eXBlIjoiaHR0cCIsInF1ZXJ5UGFyYW1zIjp7InVybCI6Imh0dHBzOi8vZXhhbXBsZS5jb20vIn0sIm1ldGhvZCI6IkdFVCJ9LCJvdXRwdXQiOnsidHlwZSI6Impzb24iLCJleGFtcGxlIjp7InJlY2VpcHRWZXJzaW9uIjoicGVubnlib3QudXJsLXJlY2VpcHQudjIiLCJieXRlQ29udHJhY3QiOiJyYXctY29udGVudC1lbmNvZGVkLWJvZHkiLCJyZXF1ZXN0ZWRVcmwiOiJodHRwczovL2V4YW1wbGUuY29tLyIsImZpbmFsVXJsIjoiaHR0cHM6Ly9leGFtcGxlLmNvbS8iLCJzdGF0dXMiOjIwMCwiY29udGVudFR5cGUiOiJ0ZXh0L3BsYWluIiwiY29udGVudEVuY29kaW5nIjoiaWRlbnRpdHkiLCJieXRlTGVuZ3RoIjozLCJzaGEyNTYiOiJiYTc4MTZiZjhmMDFjZmVhNDE0MTQwZGU1ZGFlMjIyM2IwMDM2MWEzOTYxNzdhOWNiNDEwZmY2MWYyMDAxNWFkIiwiZmV0Y2hlZEF0IjoiMjAyNi0xMC0wNFQwMDowMDowMC4wMDBaIn19fSwic2NoZW1hIjp7IiRzY2hlbWEiOiJodHRwczovL2pzb24tc2NoZW1hLm9yZy9kcmFmdC8yMDIwLTEyL3NjaGVtYSIsInR5cGUiOiJvYmplY3QiLCJwcm9wZXJ0aWVzIjp7ImlucHV0Ijp7InR5cGUiOiJvYmplY3QiLCJwcm9wZXJ0aWVzIjp7InR5cGUiOnsidHlwZSI6InN0cmluZyIsImNvbnN0IjoiaHR0cCJ9LCJtZXRob2QiOnsidHlwZSI6InN0cmluZyIsImVudW0iOlsiR0VUIl19LCJxdWVyeVBhcmFtcyI6eyJ0eXBlIjoib2JqZWN0IiwiYWRkaXRpb25hbFByb3BlcnRpZXMiOmZhbHNlLCJyZXF1aXJlZCI6WyJ1cmwiXSwicHJvcGVydGllcyI6eyJ1cmwiOnsidHlwZSI6InN0cmluZyIsImZvcm1hdCI6InVyaSIsIm1heExlbmd0aCI6MjA0OCwiZGVzY3JpcHRpb24iOiJPbmUgcHVibGljIEhUVFAoUykgVVJMLCBwb3J0cyA4MC80NDM7IG5vIGNyZWRlbnRpYWxzLCBmcmFnbWVudHMsIGxvY2FsL3Jlc2VydmVkIGFkZHJlc3NlcyBvciBIVFRQUyBkb3duZ3JhZGUgcmVkaXJlY3RzLiJ9fX19LCJyZXF1aXJlZCI6WyJ0eXBlIiwibWV0aG9kIl0sImFkZGl0aW9uYWxQcm9wZXJ0aWVzIjpmYWxzZX0sIm91dHB1dCI6eyJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJ0eXBlIjp7InR5cGUiOiJzdHJpbmcifSwiZXhhbXBsZSI6eyJ0eXBlIjoib2JqZWN0IiwicmVxdWlyZWQiOlsicmVjZWlwdFZlcnNpb24iLCJieXRlQ29udHJhY3QiLCJyZXF1ZXN0ZWRVcmwiLCJmaW5hbFVybCIsInN0YXR1cyIsImNvbnRlbnRUeXBlIiwiY29udGVudEVuY29kaW5nIiwiYnl0ZUxlbmd0aCIsInNoYTI1NiIsImZldGNoZWRBdCJdLCJwcm9wZXJ0aWVzIjp7InJlY2VpcHRWZXJzaW9uIjp7ImNvbnN0IjoicGVubnlib3QudXJsLXJlY2VpcHQudjIifSwiYnl0ZUNvbnRyYWN0Ijp7ImNvbnN0IjoicmF3LWNvbnRlbnQtZW5jb2RlZC1ib2R5In0sInJlcXVlc3RlZFVybCI6eyJ0eXBlIjoic3RyaW5nIn0sImZpbmFsVXJsIjp7InR5cGUiOiJzdHJpbmcifSwic3RhdHVzIjp7InR5cGUiOiJpbnRlZ2VyIn0sImNvbnRlbnRUeXBlIjp7InR5cGUiOlsic3RyaW5nIiwibnVsbCJdfSwiY29udGVudEVuY29kaW5nIjp7InR5cGUiOiJzdHJpbmcifSwiYnl0ZUxlbmd0aCI6eyJ0eXBlIjoiaW50ZWdlciJ9LCJzaGEyNTYiOnsidHlwZSI6InN0cmluZyJ9LCJmZXRjaGVkQXQiOnsidHlwZSI6InN0cmluZyJ9fX19LCJyZXF1aXJlZCI6WyJ0eXBlIl19fSwicmVxdWlyZWQiOlsiaW5wdXQiXX19fX0=" ], "rawBodySha256": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a", "rawBytes": 2, "redirects": [], "requestedUrl": "https://playbrightgaming.com/agent-services-mainnet/verify-url?url=https%3A%2F%2Fplaybrightgaming.com%2Fagents%2Fpennybot-test-vector.txt" }, "options": [ { "amount": "900", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "currency": "USDC", "decimals": 6, "displayPrice": "0.0009", "domainName": "USD Coin", "domainVersion": "2", "index": 0, "maxTimeoutSeconds": 300, "network": "eip155:8453", "payTo": "0xb2a6b97b76334caef4bdbe2d5a5d784941013bb3", "scheme": "exact", "signability": "METADATA_PRESENT", "verdict": "PASS" } ], "requestSha256": "84065499791645a854591f38909fb1f4411211b80486517c5dd35d4ff68c5b41", "ruleSetVersion": "x402-readiness-preflight/1.0.1", "signature": null, "startedAt": "2026-10-06T16:40:57.048Z", "usage": { "rawBytes": 2, "redirects": 0, "requests": 1 }, "verdict": "INCONCLUSIVE" }, "schema": { "oneOf": [ { "$ref": "#/components/schemas/x402-readiness-preflight__output" }, { "$ref": "#/components/schemas/x402-readiness-preflight__legacy_1_0_0_output" } ] } } }, "description": "Validated result; new purchases use 1.0.1. Exact replay/recovery of retained original orders preserves their original 1.0.0 schema and bytes. Any INCONCLUSIVE finding is no-charge, including within an overall FAIL.", "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } }, "X-PennyBot-Result-SHA256": { "description": "SHA-256 of exact retained JSON response bytes.", "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "PAYMENT-RESPONSE": { "description": "Successful first settlement response when present. Not emitted a second time on replay; absence alone does not prove zero charge.", "schema": { "type": "string" } } } }, "202": { "description": "Original order is still processing; do not create a new payment authorization.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotProcessing" } } } }, "400": { "content": { "application/json": { "schema": { "oneOf": [ { "allOf": [ { "$ref": "#/components/schemas/x402-readiness-preflight__failure" }, { "properties": { "error": { "properties": { "code": { "const": "INVALID_INPUT" }, "retryable": { "const": false } }, "type": "object" } }, "type": "object" } ] } ] } } }, "description": "INVALID_INPUT: Unsafe, malformed or unsupported request definition; no network or charge.", "x-failure-semantics": [ { "code": "INVALID_INPUT", "description": "Unsafe, malformed or unsupported request definition; no network or charge.", "httpStatus": 400, "retryable": false } ] }, "402": { "description": "x402 Payment Required with authoritative lane-specific terms and Bazaar metadata. No target request or charge for this unpaid challenge." }, "409": { "description": "Original request conflicts or retained result is not ready/available for this order state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRecoveryError" } } } }, "410": { "description": "Original retained result expired. No new work or payment is created. Contains order/settlement headers, not a result-hash header or a second PAYMENT-RESPONSE.", "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRetainedOutputExpired" }, "example": { "order_id": "ord_00000000-0000-4000-8000-000000000000", "error": "retained_output_expired" } } } }, "413": { "content": { "application/json": { "schema": { "oneOf": [ { "allOf": [ { "$ref": "#/components/schemas/x402-readiness-preflight__failure" }, { "properties": { "error": { "properties": { "code": { "const": "LIMIT_EXCEEDED" }, "retryable": { "const": false } }, "type": "object" } }, "type": "object" } ] } ] } } }, "description": "LIMIT_EXCEEDED: Input/output hard cap exceeded; no charge.", "x-failure-semantics": [ { "code": "LIMIT_EXCEEDED", "description": "Input/output hard cap exceeded; no charge.", "httpStatus": 413, "retryable": false } ] }, "429": { "content": { "application/json": { "schema": { "oneOf": [ { "allOf": [ { "$ref": "#/components/schemas/x402-readiness-preflight__failure" }, { "properties": { "error": { "properties": { "code": { "const": "BUSY" }, "retryable": { "const": true } }, "type": "object" } }, "type": "object" } ] } ] } } }, "description": "BUSY: Four requests active; no queue or charge.", "x-failure-semantics": [ { "code": "BUSY", "description": "Four requests active; no queue or charge.", "httpStatus": 429, "retryable": true } ] }, "500": { "content": { "application/json": { "schema": { "oneOf": [ { "allOf": [ { "$ref": "#/components/schemas/x402-readiness-preflight__failure" }, { "properties": { "error": { "properties": { "code": { "const": "INTERNAL_ERROR" }, "retryable": { "const": false } }, "type": "object" } }, "type": "object" } ] } ] } } }, "description": "INTERNAL_ERROR: Internal failure; no charge.", "x-failure-semantics": [ { "code": "INTERNAL_ERROR", "description": "Internal failure; no charge.", "httpStatus": 500, "retryable": false } ] }, "503": { "description": "Durable storage, recovery, evidence, or service temporarily unavailable. Payment state must be checked separately after a signed attempt." } }, "summary": "Exact-Request x402 Readiness Preflight", "tags": [ "x402", "preflight", "payment-required", "eip712", "evidence" ], "x-billing": { "PASS": "chargeable only for a delivered, serialized, validated result with no INCONCLUSIVE findings", "FAIL": "chargeable only for a delivered, serialized, validated result with no INCONCLUSIVE findings", "INCONCLUSIVE": "no-charge", "anyInconclusiveFinding": "no-charge, including an overall FAIL", "declaredServiceFailure": "no-charge", "invalidOversizeBusyInternal": "no-charge" }, "x-cost": { "class": "small", "pricingRationale": "0.005 USDC per delivered, serialized, validated result with no INCONCLUSIVE findings. Bounded local benchmarks do not establish Internet cost or margin." }, "x-latency": { "basis": "estimate", "expectedP50Ms": 250, "expectedP95Ms": 2500 }, "x-limits": { "inputBytes": 8192, "outputBytes": 131072, "terminalRawBodyBytes": 1048576, "headersPerHopBytes": 16384, "encodedChallengeBytes": 12288, "deadlineMs": 7000, "redirects": 3, "requests": 4, "dnsAnswers": 64, "paymentOptions": 8, "findings": 128, "activeOperations": 4, "queue": 0, "queryPairs": 16 }, "x-selection": { "chooseWhen": [ "You need deterministic diagnostics for one bodyless GET, HEAD or OPTIONS challenge, including exact path and query.", "You can use the bounded x402 v2 exact EVM EIP-3009 and Bazaar declaration profiles." ], "doNotChooseWhen": [ "You need payment signing, settlement, replay safety, merchant trust, paid delivery or general security proof.", "You need POST/PUT/PATCH/DELETE, request bodies, credentials, arbitrary schema evaluation or crawling.", "You need live chain verification or unsupported asset/domain metadata; these remain INCONCLUSIVE." ] }, "x-stage": "live", "x-x402": { "amount": "0.005", "atomicAmount": "5000", "currency": "USDC", "decimals": 6, "network": "eip155:84532", "scheme": "exact", "status": "live-runtime-authoritative", "resource": "https://playbrightgaming.com/agent-services/x402-readiness-preflight" }, "x-staging-definition-sha256": "cac6013180a88751a89857efe00899931580f88704524e29a56561e343ac5ed3", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005000" }, "priceAtomic": "5000", "protocols": [ { "x402": {} } ], "network": "eip155:84532", "asset": "USDC", "accountRequired": false, "apiKeyRequired": false, "runtimeAuthority": "HTTP 402 PAYMENT-REQUIRED" }, "x-budget-caveat": "The seven-second budget cancels DNS/sockets and stops new work. Bounded synchronous JS cannot provide a hard real-time preemption guarantee.", "x-claims": { "paidSettlement": false, "replaySafety": false, "deliveryCorrectness": false, "merchantHonesty": false, "generalSecurity": false, "actualSignability": false }, "x-durability": { "persistentOrderState": true, "sameSignedAuthorizationReplayReturnsSameOrder": true, "sameEvidenceReplay": true, "sameResponseBodyReplay": true, "automaticResettleOnReplay": false, "refetchOnReplay": false, "changedRequestUnderUsedAuthorization": "rejected" }, "x-testnet-endpoint": "https://playbrightgaming.com/agent-services/x402-readiness-preflight", "x-example-provenance": "Input/output are illustrative shapes, not a current live observation or a guaranteed verdict. Output examples may describe independent synthetic fixtures.", "externalDocs": { "url": "https://playbrightgaming.com/agents/x402-readiness-preflight.md" }, "x-recovery": { "persistentOrderState": true, "sameOriginalRequestRequired": true, "originalIdempotencyKeyRecommended": true, "keyIsBearerCredential": true, "sameSignedAuthorizationReplay": true, "replayReturnsOriginalBody": true, "reexecuteOnReplay": false, "automaticResettleOnReplay": false, "secondPaymentResponseOnReplay": false, "automaticNewAuthorizationRetrySafe": false, "recoveryEndpoint": "https://playbrightgaming.com/agent-services/recover/{order_id}", "acknowledgmentEndpoint": "https://playbrightgaming.com/agent-services/ack/{order_id}", "documentation": "https://playbrightgaming.com/agents/delivery-recovery.md", "resultRetention": { "configuredSeconds": 900, "startsAt": "durable_result_preparation", "localCopyRecommended": true, "uncertainSettlementMayDelayDeletion": true, "freshWindowAfterReconciliation": false }, "retentionGuarantee": null, "settlementUncertainty": "Original identity is reconciled read-only. Retained output may be available while settlement remains uncertain.", "expiredRetainedOutput": { "httpStatus": 410, "error": "retained_output_expired", "appliesTo": [ "purchase_replay", "recover" ], "doesNotCreateNewPayment": true }, "legacyReplay": "Known original orders retain their original result bytes, schema and price. Current advertised terms apply only to new purchases." }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Choose a unique cryptographically random value before the signed purchase; retain it privately with the exact original request and authorization. This is a bearer recovery credential, not a public order label. Never reuse for different input.", "schema": { "type": "string", "minLength": 32, "maxLength": 128, "pattern": "^[A-Za-z0-9_-]+$" } }, { "name": "PAYMENT-SIGNATURE", "in": "header", "required": false, "description": "Omit on the initial valid request to receive HTTP 402 and PAYMENT-REQUIRED. For a purchase, send the base64-encoded x402 payment authorization for those exact terms. This is a per-purchase payment authorization, not an account API key. Retain the original authorization and private Idempotency-Key for recovery; do not sign a new payment merely because delivery is uncertain.", "schema": { "type": "string", "contentEncoding": "base64" } } ] } }, "/agent-services/pdf-citation-evidence": { "post": { "description": "PDF text extraction with page citations and exact quote matching. Extract embedded text from one PDF into JSON with original page numbers, document/page SHA-256 hashes, stable citation references and Unicode code-point offsets. Supply canonical base64 JSON or one public HTTPS PDF URL; optionally select page ranges and check up to 16 exact quotes. $0.003 USDC on Base per fully determined result; up to 2 MiB and 25 total pages. A deterministic missing-quote result is chargeable; image-only PDFs and uncertain extraction are no-charge. No OCR, layout reconstruction or claim verification. No OCR, image rendering, visual fidelity, semantic or legal truth claim, provider/origin/timestamp attestation. Evidence and receipt are unsigned checksums only. Hidden text can differ from visible appearance; extraction order is not a visual-layout guarantee.", "operationId": "pennybotPdfCitationEvidence", "requestBody": { "content": { "application/json": { "example": { "pdfBase64": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgID4+CmVuZG9iagoyIDAgb2JqCjw8IC9UeXBlIC9QYWdlcyAvQ291bnQgMSAvS2lkcyBbNCAwIFJdID4+CmVuZG9iagozIDAgb2JqCjw8IC9UeXBlIC9Gb250IC9TdWJ0eXBlIC9UeXBlMSAvQmFzZUZvbnQgL0hlbHZldGljYSAvRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZyA+PgplbmRvYmoKNCAwIG9iago8PCAvVHlwZSAvUGFnZSAvUGFyZW50IDIgMCBSIC9NZWRpYUJveCBbMCAwIDYxMiA3OTJdIC9SZXNvdXJjZXMgPDwgL0ZvbnQgPDwgL0YxIDMgMCBSID4+ICA+PiAvQ29udGVudHMgNSAwIFIgPj4KZW5kb2JqCjUgMCBvYmoKPDwgL0xlbmd0aCA1NSA+PgpzdHJlYW0KQlQgL0YxIDEyIFRmIDcyIDcyMCBUZCAoQWxwaGEgYmV0YS4gQWxwaGEgYWdhaW4uKSBUaiBFVAplbmRzdHJlYW0KZW5kb2JqCnhyZWYKMCA2CjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDAxNSAwMDAwMCBuIAowMDAwMDAwMDY1IDAwMDAwIG4gCjAwMDAwMDAxMjIgMDAwMDAgbiAKMDAwMDAwMDIxOSAwMDAwMCBuIAowMDAwMDAwMzQ2IDAwMDAwIG4gCnRyYWlsZXIKPDwgL1NpemUgNiAvUm9vdCAxIDAgUiA+PgpzdGFydHhyZWYKNDUxCiUlRU9GCg==", "quotes": [ "Alpha" ] }, "schema": { "$ref": "#/components/schemas/pdf-citation-evidence__input" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "evidence": { "code": "EXTRACTED", "document": { "bytes": 634, "metadata": {}, "pageCount": 1, "sha256": "8391ad8cf2894f702de37dce5ab7b531d9dda7232d82043ff328ed58021557d5" }, "ignoredActiveContent": false, "pages": [ { "end": 24, "pageNumber": 1, "reference": "pdfcite:v1:sha256:8391ad8cf2894f702de37dce5ab7b531d9dda7232d82043ff328ed58021557d5:page:1:text:0fe819b05d78625668ff82204b5ca46d52ef92088fc33cf478ffdf59c356bf45:chars:0-24", "start": 0, "text": "Alpha beta. Alpha again.", "textSha256": "0fe819b05d78625668ff82204b5ca46d52ef92088fc33cf478ffdf59c356bf45", "warnings": [] } ], "parser": { "cpuSeconds": 4, "isolation": "windows-job-object", "memoryBytes": 201326592, "name": "pypdf", "version": "6.1.1", "wallMs": 5500 }, "quotes": [ { "matches": [ { "end": 5, "pageNumber": 1, "reference": "pdfcite:v1:sha256:8391ad8cf2894f702de37dce5ab7b531d9dda7232d82043ff328ed58021557d5:page:1:text:0fe819b05d78625668ff82204b5ca46d52ef92088fc33cf478ffdf59c356bf45:chars:0-5", "start": 0 }, { "end": 17, "pageNumber": 1, "reference": "pdfcite:v1:sha256:8391ad8cf2894f702de37dce5ab7b531d9dda7232d82043ff328ed58021557d5:page:1:text:0fe819b05d78625668ff82204b5ca46d52ef92088fc33cf478ffdf59c356bf45:chars:12-17", "start": 12 } ], "quote": "Alpha", "verdict": "PASS" } ], "requestSha256": "d03fc28e6f4e3bff8827ca26227ed8444901501b6b2d3b9c6baa510ec6535720", "ruleSet": "pdf-citation-evidence/1.0.0+pypdf-6.1.1", "selectedPages": [ 1 ], "semantics": { "documentSha256": "sha256 of complete PDF bytes after HTTP Content-Encoding decoding; uploads use exact supplied bytes", "evidenceId": "sha256 of sorted-key-json-v1 evidence object; timestamps excluded; parser version and request hash included", "extraction": "pypdf plain content-stream order; hidden text may be included; no OCR, layout, visual, truth or legal attestation", "httpSha256": "sha256 of complete final HTTP entity before Content-Encoding decoding; excludes headers and HTTP transfer framing", "offsets": "zero-based Unicode code points in returned page text; half-open [start,end); no Unicode or whitespace normalization", "pageSha256": "sha256 of UTF-8 extracted page text after CRLF/CR to LF only; not a hash of serialized page objects or appearance" }, "source": { "contentEncoding": null, "contentType": null, "finalUrl": null, "httpStatus": null, "mode": "upload", "rawBodySha256": null, "rawBytes": null, "redirects": [], "requestedUrl": null }, "verdict": "PASS", "warnings": [] }, "evidenceId": "sha256:8cc2d6c34045075a0670f4f926f42d43fc5f561b750b5003f5bf7e06a962bd7a", "fetchedAt": null, "observedAt": "2026-10-04T18:00:00.000Z", "receipt": { "payloadSha256": "f93c37cad48db0c6eb2a4550ff26015a1aac3d457b63094623243017cad3b076", "serialization": "sorted-key-json-v1", "signature": null }, "schemaVersion": "1.0" }, "schema": { "$ref": "#/components/schemas/pdf-citation-evidence__output" } } }, "description": "Successful work matching the output contract", "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } }, "X-PennyBot-Result-SHA256": { "description": "SHA-256 of exact retained JSON response bytes.", "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "PAYMENT-RESPONSE": { "description": "Successful first settlement response when present. Not emitted a second time on replay; absence alone does not prove zero charge.", "schema": { "type": "string" } } } }, "202": { "description": "Original order is still processing; do not create a new payment authorization.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotProcessing" } } } }, "400": { "content": { "application/json": { "schema": { "oneOf": [ { "allOf": [ { "$ref": "#/components/schemas/pdf-citation-evidence__failure" }, { "properties": { "error": { "properties": { "code": { "const": "INVALID_INPUT" }, "retryable": { "const": false } }, "type": "object" } }, "type": "object" } ] } ] } } }, "description": "INVALID_INPUT: Malformed or unsupported request; no charge.", "x-failure-semantics": [ { "code": "INVALID_INPUT", "description": "Malformed or unsupported request; no charge.", "httpStatus": 400, "retryable": false } ] }, "402": { "description": "x402 Payment Required with authoritative lane-specific 3000-atomic terms, exact resource/service identity and Bazaar metadata. No PDF fetch or parse occurs for this unsigned challenge." }, "409": { "description": "Original request conflicts or retained result is not ready/available for this order state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRecoveryError" } } } }, "410": { "description": "Original retained result expired. No new work or payment is created. Contains order/settlement headers, not a result-hash header or a second PAYMENT-RESPONSE.", "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRetainedOutputExpired" }, "example": { "order_id": "ord_00000000-0000-4000-8000-000000000000", "error": "retained_output_expired" } } } }, "413": { "content": { "application/json": { "schema": { "oneOf": [ { "allOf": [ { "$ref": "#/components/schemas/pdf-citation-evidence__failure" }, { "properties": { "error": { "properties": { "code": { "const": "LIMIT_EXCEEDED" }, "retryable": { "const": false } }, "type": "object" } }, "type": "object" } ] } ] } } }, "description": "LIMIT_EXCEEDED: Ingress or response cap exceeded; no charge.", "x-failure-semantics": [ { "code": "LIMIT_EXCEEDED", "description": "Ingress or response cap exceeded; no charge.", "httpStatus": 413, "retryable": false } ] }, "429": { "content": { "application/json": { "schema": { "oneOf": [ { "allOf": [ { "$ref": "#/components/schemas/pdf-citation-evidence__failure" }, { "properties": { "error": { "properties": { "code": { "const": "BUSY" }, "retryable": { "const": true } }, "type": "object" } }, "type": "object" } ] } ] } } }, "description": "BUSY: Two active requests; no queue and no charge.", "x-failure-semantics": [ { "code": "BUSY", "description": "Two active requests; no queue and no charge.", "httpStatus": 429, "retryable": true } ] }, "500": { "content": { "application/json": { "schema": { "oneOf": [ { "allOf": [ { "$ref": "#/components/schemas/pdf-citation-evidence__failure" }, { "properties": { "error": { "properties": { "code": { "const": "INTERNAL_ERROR" }, "retryable": { "const": false } }, "type": "object" } }, "type": "object" } ] } ] } } }, "description": "INTERNAL_ERROR: Internal execution or verification failure; no charge.", "x-failure-semantics": [ { "code": "INTERNAL_ERROR", "description": "Internal execution or verification failure; no charge.", "httpStatus": 500, "retryable": false } ] }, "503": { "description": "Durable storage, recovery, evidence, or service temporarily unavailable. Payment state must be checked separately after a signed attempt." } }, "summary": "Extract PDF text with page citations and exact quote matching", "tags": [ "pdf", "pdf-text-extraction", "document-processing", "page-citations", "quote-matching", "embedded-text", "sha256", "evidence" ], "x-billing": { "PASS": "chargeable only for delivered, serialized, validated evidence with no INCONCLUSIVE state", "FAIL": "deterministic exact-quote FAIL is chargeable only for delivered, serialized, validated evidence with no INCONCLUSIVE state", "INCONCLUSIVE": "no-charge", "NEEDS_OCR": "no-charge", "invalidOversizeResourceLimitBusyInternalCorruptedEvidence": "no-charge", "noChargeOutcomes": "authenticated complete outcomes are durable and replayable after accepted request binding and successful storage; incomplete transport, no accepted authorization, or unavailable storage never settle and do not promise retained delivered bytes" }, "x-cost": { "class": "small", "pricingRationale": "0.003 USDC per delivered, serialized, validated PASS or deterministic exact-quote FAIL with no INCONCLUSIVE state. Bounded local timing is not measured Internet cost, demand, throughput or margin." }, "x-latency": { "basis": "estimate", "expectedP50Ms": 500, "expectedP95Ms": 1200 }, "x-limits": { "inputBytes": 2810000, "pdfBytes": 2097152, "totalPages": 25, "outputBytes": 1048576, "parserStdoutBytes": 1048576, "quotes": 16, "quoteCodePoints": 512, "matchesPerQuote": 256, "pageRanges": 25, "deadlineMs": 13000, "activeRequests": 2, "singleton": true, "queue": 0, "parserProcessCommitBytes": 201326592, "parserUserCpuSeconds": 4, "parserWallMs": 5500, "parserActiveProcesses": 1, "killOnJobClose": true, "upstreamDeadlineMs": 7000, "rawHttpBytes": 2097152, "decodedPdfBytes": 2097152, "headersPerHopBytes": 16384, "redirects": 3, "requests": 4, "deadlineScope": "PDF service work only", "paidRequestTimeoutMs": 25000, "paidRequestTimeoutScope": "separate outer paid-request envelope including bounded payment/recovery/storage" }, "x-selection": { "chooseWhen": [ "You need exact quotes and stable code-point references in embedded PDF text.", "You can accept a conservative bounded parser profile and independently verify supplied PDF bytes." ], "doNotChooseWhen": [ "You need OCR, visual layout, image understanding, semantic verification or legal attestation.", "You need credentials, internal URLs, encrypted PDFs, more than 2 MiB or 25 pages, unsupported encodings.", "You require authenticated origin, timestamp or provider attestation; receipts are unsigned." ] }, "x-stage": "live", "x-x402": { "amount": "0.003", "atomicAmount": "3000", "currency": "USDC", "decimals": 6, "network": "eip155:84532", "scheme": "exact", "status": "live-runtime-authoritative", "resource": "https://playbrightgaming.com/agent-services/pdf-citation-evidence" }, "x-staging-definition-sha256": "0e3e7c446111d4377597fcc4ca2c3a11380a4d2b78788939a1181e3ca859a41f", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.003000" }, "priceAtomic": "3000", "protocols": [ { "x402": {} } ], "network": "eip155:84532", "asset": "USDC", "accountRequired": false, "apiKeyRequired": false, "runtimeAuthority": "HTTP 402 PAYMENT-REQUIRED" }, "x-claims": { "ocr": false, "imageRendering": false, "visualFidelity": false, "semanticTruth": false, "legalTruth": false, "providerAttestation": false, "originAttestation": false, "timestampAttestation": false, "signedReceipt": false }, "x-durability": { "persistentOrderState": true, "sameSignedAuthorizationReplayReturnsSameOrder": true, "sameEvidenceReplay": true, "sameResponseBodyReplay": true, "sameReceiptIdentityReplay": true, "secondPaymentResponseOnReplay": false, "refetchOnReplay": false, "reparseOnReplay": false, "reexecuteOnReplay": false, "automaticResettleOnReplay": false, "changedRequestUnderUsedAuthorization": "rejected", "noChargeResultsDurable": true, "uncertainSettlement": "held for read-only recovery; never blindly resubmitted", "noChargeDurabilityScope": "authenticated complete outcomes are durable and replayable after accepted request binding and successful storage; incomplete transport, no accepted authorization, or unavailable storage never settle and do not promise retained delivered bytes" }, "x-testnet-endpoint": "https://playbrightgaming.com/agent-services/pdf-citation-evidence", "x-example-provenance": "Input/output are illustrative shapes, not a current live observation or a guaranteed verdict. Output examples may describe independent synthetic fixtures.", "externalDocs": { "url": "https://playbrightgaming.com/agents/pdf-citation-evidence.md" }, "x-recovery": { "persistentOrderState": true, "sameOriginalRequestRequired": true, "originalIdempotencyKeyRecommended": true, "keyIsBearerCredential": true, "sameSignedAuthorizationReplay": true, "replayReturnsOriginalBody": true, "reexecuteOnReplay": false, "automaticResettleOnReplay": false, "secondPaymentResponseOnReplay": false, "automaticNewAuthorizationRetrySafe": false, "recoveryEndpoint": "https://playbrightgaming.com/agent-services/recover/{order_id}", "acknowledgmentEndpoint": "https://playbrightgaming.com/agent-services/ack/{order_id}", "documentation": "https://playbrightgaming.com/agents/delivery-recovery.md", "resultRetention": { "configuredSeconds": 900, "startsAt": "durable_result_preparation", "localCopyRecommended": true, "uncertainSettlementMayDelayDeletion": true, "freshWindowAfterReconciliation": false }, "retentionGuarantee": null, "settlementUncertainty": "Original identity is reconciled read-only. Retained output may be available while settlement remains uncertain.", "expiredRetainedOutput": { "httpStatus": 410, "error": "retained_output_expired", "appliesTo": [ "purchase_replay", "recover" ], "doesNotCreateNewPayment": true }, "legacyReplay": "Known original orders retain their original result bytes, schema and price. Current advertised terms apply only to new purchases." }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Choose a unique cryptographically random value before the signed purchase; retain it privately with the exact original request and authorization. This is a bearer recovery credential, not a public order label. Never reuse for different input.", "schema": { "type": "string", "minLength": 32, "maxLength": 128, "pattern": "^[A-Za-z0-9_-]+$" } }, { "name": "PAYMENT-SIGNATURE", "in": "header", "required": false, "description": "Omit on the initial valid request to receive HTTP 402 and PAYMENT-REQUIRED. For a purchase, send the base64-encoded x402 payment authorization for those exact terms. This is a per-purchase payment authorization, not an account API key. Retain the original authorization and private Idempotency-Key for recovery; do not sign a new payment merely because delivery is uncertain.", "schema": { "type": "string", "contentEncoding": "base64" } } ] } }, "/agent-services/irs-form-instruction-version-check": { "post": { "summary": "IRS Form/Instruction Version Check", "description": "Check reviewed public US federal form or instruction editions by explicit tax year and return CURRENT, STALE, UNKNOWN or CONFLICT with bounded source hashes and applicability evidence. CURRENT is relative to the reviewed snapshot, not a live IRS guarantee. UNKNOWN anywhere makes the whole request no-charge. Independent public-document evidence only: no tax advice, filing, taxpayer applicability/treatment determination, IRS/SSA affiliation, or schema-compliance certification.", "operationId": "pennybotIrsFormInstructionVersionCheck", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/irs-form-instruction-version-check__input" }, "example": { "tax_year": 2026, "jurisdiction": "US-federal", "filing_year": 2027, "artifact_kind": "instructions", "identifiers": [ { "identifier": "1099-NEC", "caller_revision": "12/2026" }, { "identifier": "W-2" } ] } } } }, "responses": { "200": { "description": "Delivered Product7 evidence result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/irs-form-instruction-version-check__output" }, "example": { "boundary": "Public document edition evidence only; no tax advice, treatment determination or filing.", "contract_version": "1.0.0", "evaluated_at": "2026-10-05T02:00:00+00:00", "fee_eligibility": { "currency": "USDC", "eligible": true, "price_atomic": "5000", "rule": "ALL_RESULTS_DETERMINATE_CURRENT_STALE_CONFLICT", "settlement_claimed": false, "unknown_anywhere_no_charge": true }, "jurisdiction": "US-federal", "limitations": [ "Independent public document edition evidence utility; not affiliated with or endorsed by the IRS or SSA.", "No tax advice, tax treatment determination, taxpayer applicability determination, filing, preparation, submission, or account access.", "No schema-content or schema-compliance claim; unavailable schema evidence remains UNKNOWN.", "CURRENT is relative to the reviewed local snapshot and requested tax year, not a live IRS guarantee.", "Caller document bytes are never received; an optional SHA-256 digest is compared only to reviewed captured bytes.", "Whole-document semantic equivalence is not assessed.", "Any UNKNOWN result makes the entire request no-charge.", "Settlement status is not claimed by this body; x402 payment headers and durable order state are authoritative for settlement." ], "mode": "snapshot_replay", "results": [ { "applicability": { "filing_years": [ 2027 ], "scope": "Document edition only for the enumerated tax year; no determination of taxpayer applicability.", "tax_years": [ 2026 ] }, "artifact_kind": "instructions", "authoritative_url": "https://www.irs.gov/instructions/i1099mec", "caller_comparison": { "bytes": "not_supplied", "caller_document_verified": false, "revision": "matches_reviewed_edition", "semantic_equivalence": "not_assessed" }, "caveats": [ "Public document edition evidence only; no tax advice, treatment determination or filing.", "CURRENT is relative to the reviewed snapshot and requested tax year, not a live IRS check.", "Hashes identify exact bytes; they do not establish semantic equivalence or authenticate an origin.", "Caller file bytes are never received or verified. Hash comparison compares the supplied digest with a verified captured digest." ], "curated_revision": "12/2026", "document_bytes_verified": true, "evidence_issues": [], "evidence_refs": [ { "excerpt_sha256": "137a7ff8bf6917ec04d37098c582de2e11d77acb2892d1500c7ac2b34aee5acb", "extracted_sha256": "68a6c4fec48295267cf12ce1a13e794f697661b2445f151177336c5386773f7d", "line_end": 336, "line_start": 336, "page": null, "raw_file": "sources/nec_2026.raw", "raw_sha256": "6857e6e771e5a361b8757a62cfae4d1da098f98be02f779d3f4063b5fc2e4898", "record_id": "1099-NEC:instructions:2026", "source_id": "nec_2026", "text_file": "sources/nec_2026.txt", "url": "https://www.irs.gov/instructions/i1099mec" }, { "excerpt_sha256": "4fac8ae891007fe41d386c0849010c4e7db02fc3a10dd0e8cdb32650b3443787", "extracted_sha256": "68a6c4fec48295267cf12ce1a13e794f697661b2445f151177336c5386773f7d", "line_end": 760, "line_start": 760, "page": null, "raw_file": "sources/nec_2026.raw", "raw_sha256": "6857e6e771e5a361b8757a62cfae4d1da098f98be02f779d3f4063b5fc2e4898", "record_id": "1099-NEC:instructions:2026", "source_id": "nec_2026", "text_file": "sources/nec_2026.txt", "url": "https://www.irs.gov/instructions/i1099mec" }, { "excerpt_sha256": "0001931679b8a6194586504264e3e335124527cc999d5a922d366270e90abafe", "extracted_sha256": "68a6c4fec48295267cf12ce1a13e794f697661b2445f151177336c5386773f7d", "line_end": 356, "line_start": 356, "page": null, "raw_file": "sources/nec_2026.raw", "raw_sha256": "6857e6e771e5a361b8757a62cfae4d1da098f98be02f779d3f4063b5fc2e4898", "record_id": "1099-NEC:instructions:2026", "source_id": "nec_2026", "text_file": "sources/nec_2026.txt", "url": "https://www.irs.gov/instructions/i1099mec" }, { "excerpt_sha256": "0001931679b8a6194586504264e3e335124527cc999d5a922d366270e90abafe", "extracted_sha256": "68a6c4fec48295267cf12ce1a13e794f697661b2445f151177336c5386773f7d", "line_end": 356, "line_start": 356, "page": null, "raw_file": "sources/nec_2026.raw", "raw_sha256": "6857e6e771e5a361b8757a62cfae4d1da098f98be02f779d3f4063b5fc2e4898", "record_id": "1099-NEC:instructions:2026", "source_id": "nec_2026", "text_file": "sources/nec_2026.txt", "url": "https://www.irs.gov/instructions/i1099mec" } ], "extracted_sha256": "68a6c4fec48295267cf12ce1a13e794f697661b2445f151177336c5386773f7d", "identifier": "1099-NEC", "observed_at": "2026-10-05T01:23:47.028609+00:00", "raw_sha256": "6857e6e771e5a361b8757a62cfae4d1da098f98be02f779d3f4063b5fc2e4898", "reason": "reviewed_edition_for_requested_year", "schema_availability": "UNKNOWN", "source_id": "nec_2026", "status": "CURRENT", "tax_year": 2026, "valid_until": "2026-11-04T01:23:47.028609+00:00" }, { "applicability": { "filing_years": [ 2027 ], "scope": "Document edition only for the enumerated tax year; no determination of taxpayer applicability.", "tax_years": [ 2026 ] }, "artifact_kind": "instructions", "authoritative_url": "https://www.irs.gov/instructions/iw2w3", "caller_comparison": { "bytes": "not_supplied", "caller_document_verified": false, "revision": "not_supplied", "semantic_equivalence": "not_assessed" }, "caveats": [ "Public document edition evidence only; no tax advice, treatment determination or filing.", "CURRENT is relative to the reviewed snapshot and requested tax year, not a live IRS check.", "Hashes identify exact bytes; they do not establish semantic equivalence or authenticate an origin.", "Caller file bytes are never received or verified. Hash comparison compares the supplied digest with a verified captured digest." ], "curated_revision": "2026", "document_bytes_verified": true, "evidence_issues": [], "evidence_refs": [ { "excerpt_sha256": "d1e5c8a2e4f5a288885a7d972d5647225638a68304071815b3a644799680a4de", "extracted_sha256": "d9adc61b64aba83f63b34007c573268165494f03c4c7ff68c16dd1793afeb1f3", "line_end": 1, "line_start": 1, "page": null, "raw_file": "sources/w2_2026.raw", "raw_sha256": "c874671ccf898cc44fbc79b4e14c3a7d1808e9eaaaf25638d94ef8fdff6d651e", "record_id": "W-2:instructions:2026", "source_id": "w2_2026", "text_file": "sources/w2_2026.txt", "url": "https://www.irs.gov/instructions/iw2w3" }, { "excerpt_sha256": "9d44abd456ef494cb75a71c13bb55943e2b261979bfbed437da3cd81f8258987", "extracted_sha256": "d9adc61b64aba83f63b34007c573268165494f03c4c7ff68c16dd1793afeb1f3", "line_end": 1931, "line_start": 1931, "page": null, "raw_file": "sources/w2_2026.raw", "raw_sha256": "c874671ccf898cc44fbc79b4e14c3a7d1808e9eaaaf25638d94ef8fdff6d651e", "record_id": "W-2:instructions:2026", "source_id": "w2_2026", "text_file": "sources/w2_2026.txt", "url": "https://www.irs.gov/instructions/iw2w3" }, { "excerpt_sha256": "d1e5c8a2e4f5a288885a7d972d5647225638a68304071815b3a644799680a4de", "extracted_sha256": "d9adc61b64aba83f63b34007c573268165494f03c4c7ff68c16dd1793afeb1f3", "line_end": 1, "line_start": 1, "page": null, "raw_file": "sources/w2_2026.raw", "raw_sha256": "c874671ccf898cc44fbc79b4e14c3a7d1808e9eaaaf25638d94ef8fdff6d651e", "record_id": "W-2:instructions:2026", "source_id": "w2_2026", "text_file": "sources/w2_2026.txt", "url": "https://www.irs.gov/instructions/iw2w3" } ], "extracted_sha256": "d9adc61b64aba83f63b34007c573268165494f03c4c7ff68c16dd1793afeb1f3", "identifier": "W-2", "observed_at": "2026-10-05T01:23:47.029865+00:00", "raw_sha256": "c874671ccf898cc44fbc79b4e14c3a7d1808e9eaaaf25638d94ef8fdff6d651e", "reason": "reviewed_edition_for_requested_year", "schema_availability": "UNKNOWN", "source_id": "w2_2026", "status": "CURRENT", "tax_year": 2026, "valid_until": "2026-11-04T01:23:47.029865+00:00" } ], "service": "irs-form-instruction-version-check" } } }, "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } }, "X-PennyBot-Result-SHA256": { "description": "SHA-256 of exact retained JSON response bytes.", "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "PAYMENT-RESPONSE": { "description": "Successful first settlement response when present. Not emitted a second time on replay; absence alone does not prove zero charge.", "schema": { "type": "string" } } } }, "202": { "description": "Original order is still processing; do not create a new payment authorization.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotProcessing" } } } }, "400": { "description": "INVALID_INPUT; no-charge", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/irs-form-instruction-version-check__failure" } } } }, "402": { "description": "x402 Payment Required; runtime PAYMENT-REQUIRED terms are authoritative" }, "409": { "description": "Original request conflicts or retained result is not ready/available for this order state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRecoveryError" } } } }, "410": { "description": "Original retained result expired. No new work or payment is created. Contains order/settlement headers, not a result-hash header or a second PAYMENT-RESPONSE.", "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRetainedOutputExpired" }, "example": { "order_id": "ord_00000000-0000-4000-8000-000000000000", "error": "retained_output_expired" } } } }, "413": { "description": "LIMIT_EXCEEDED; no-charge", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/irs-form-instruction-version-check__failure" } } } }, "422": { "description": "UNSUPPORTED_INPUT; no-charge", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/irs-form-instruction-version-check__failure" } } } }, "429": { "description": "Admission/rate limit; no-charge" }, "503": { "description": "TIMEOUT or EVIDENCE_UNAVAILABLE; no-charge", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/irs-form-instruction-version-check__failure" } } } } }, "x-x402": { "amount": "0.005", "atomicAmount": "5000", "currency": "USDC", "decimals": 6, "network": "eip155:84532", "scheme": "exact", "status": "live-runtime-authoritative", "resource": "https://playbrightgaming.com/agent-services/irs-form-instruction-version-check" }, "x-testnet-endpoint": "https://playbrightgaming.com/agent-services/irs-form-instruction-version-check", "x-billing": { "CURRENT": "chargeable only when every requested item is determinate and the validated result is delivered", "STALE": "chargeable only when every requested item is determinate and the validated result is delivered", "CONFLICT": "chargeable determinate evidence; retain all conflicting evidence rather than choosing a winner", "UNKNOWN": "no-charge; UNKNOWN anywhere makes the whole request no-charge", "declaredFailures": "invalid/unsupported/oversize/timeout/evidence-unavailable/busy/internal/storage/delivery failures are no-charge", "rule": "ALL_RESULTS_DETERMINATE_CURRENT_STALE_CONFLICT" }, "x-privacy": { "taxpayerPiiAccepted": false, "rawDocumentsAccepted": false, "credentialsAccepted": false, "allowed": "approved public document identifiers, tax year/artifact kind/jurisdiction, optional public revision label and optional SHA-256 digest" }, "x-claims": { "taxAdvice": false, "taxTreatmentDetermination": false, "taxpayerApplicabilityDetermination": false, "filingPreparationSubmission": false, "irsAffiliationOrEndorsement": false, "ssaAffiliationOrEndorsement": false, "liveIrsAccountAccess": false, "schemaCompliance": false, "callerDocumentBytesVerified": false, "semanticEquivalence": false }, "x-durability": { "persistentOrderState": true, "sameSignedAuthorizationReplayReturnsSameOrder": true, "sameResponseBodyReplay": true, "secondPaymentResponseOnReplay": false, "reexecuteOnReplay": false, "automaticResettleOnReplay": false, "changedRequestUnderUsedAuthorization": "rejected", "uncertainSettlement": "held for read-only chain/nonce recovery; never blindly resubmitted" }, "x-limits": { "inputBytes": 16384, "outputBytes": 262144, "identifiers": 20, "workerMs": 6500, "pipelineMs": 15000, "activeRequests": 1 }, "x-source-policy": { "officialIrsOnlyWithinReviewedCatalog": true, "thirdPartyTaxSources": false, "changedBytes": "explicit review required; matching labels do not establish semantic equivalence", "ambiguousUnavailable": "UNKNOWN/no-charge" }, "x-example-provenance": "Input/output are illustrative shapes, not a current live observation or a guaranteed verdict. Output examples may describe independent synthetic fixtures.", "externalDocs": { "url": "https://playbrightgaming.com/agents/irs-form-instruction-version-check.md" }, "x-recovery": { "persistentOrderState": true, "sameOriginalRequestRequired": true, "originalIdempotencyKeyRecommended": true, "keyIsBearerCredential": true, "sameSignedAuthorizationReplay": true, "replayReturnsOriginalBody": true, "reexecuteOnReplay": false, "automaticResettleOnReplay": false, "secondPaymentResponseOnReplay": false, "automaticNewAuthorizationRetrySafe": false, "recoveryEndpoint": "https://playbrightgaming.com/agent-services/recover/{order_id}", "acknowledgmentEndpoint": "https://playbrightgaming.com/agent-services/ack/{order_id}", "documentation": "https://playbrightgaming.com/agents/delivery-recovery.md", "resultRetention": { "configuredSeconds": 900, "startsAt": "durable_result_preparation", "localCopyRecommended": true, "uncertainSettlementMayDelayDeletion": true, "freshWindowAfterReconciliation": false }, "retentionGuarantee": null, "settlementUncertainty": "Original identity is reconciled read-only. Retained output may be available while settlement remains uncertain.", "expiredRetainedOutput": { "httpStatus": 410, "error": "retained_output_expired", "appliesTo": [ "purchase_replay", "recover" ], "doesNotCreateNewPayment": true }, "legacyReplay": "Known original orders retain their original result bytes, schema and price. Current advertised terms apply only to new purchases." }, "x-source-freshness": { "earliestRelevantExpiryUtc": "2026-11-04T01:23:47.028609Z", "checkedAtDate": "2026-10-06", "runtimeAutomaticSourceRefresh": false, "notice": "Captured reviewed evidence, not continuous source monitoring. These are snapshot validity bounds, not a guarantee that an authority has not changed. Expired or unusable required evidence yields UNKNOWN/no charge. A later reviewed release may replace these bounds; inspect result evidence." }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Choose a unique cryptographically random value before the signed purchase; retain it privately with the exact original request and authorization. This is a bearer recovery credential, not a public order label. Never reuse for different input.", "schema": { "type": "string", "minLength": 32, "maxLength": 128, "pattern": "^[A-Za-z0-9_-]+$" } }, { "name": "PAYMENT-SIGNATURE", "in": "header", "required": false, "description": "Omit on the initial valid request to receive HTTP 402 and PAYMENT-REQUIRED. For a purchase, send the base64-encoded x402 payment authorization for those exact terms. This is a per-purchase payment authorization, not an account API key. Retain the original authorization and private Idempotency-Key for recovery; do not sign a new payment merely because delivery is uncertain.", "schema": { "type": "string", "contentEncoding": "base64" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005000" }, "priceAtomic": "5000", "protocols": [ { "x402": {} } ], "network": "eip155:84532", "asset": "USDC", "accountRequired": false, "apiKeyRequired": false, "runtimeAuthority": "HTTP 402 PAYMENT-REQUIRED" } } }, "/agent-services/fire-iris-migration-readiness": { "post": { "summary": "FIRE-to-IRIS Migration Readiness", "description": "Evaluate declared FIRE/IRIS migration prerequisites against bounded, reviewed public IRS evidence. The requested channel returns READY, NOT_READY, NOT_APPLICABLE, or UNKNOWN. READY is a planning result only, not filing authorization, live access, tax advice, compliance certification, or IRS acceptance. Production XML validation remains UNSUPPORTED because full TY2026 IRIS SOR schema bytes are not in the accepted corpus; SSA EFW2 validation is OUTSIDE_SCOPE.", "operationId": "pennybotFireIrisMigrationReadiness", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/fire-iris-migration-readiness__input" }, "example": { "tax_year": 2026, "filing_channel": "IRIS_A2A", "form_types": [ "1099-NEC" ], "volume_by_form": { "1099-NEC": 50 }, "tcc_status": "active", "readiness_flags": { "portal_tcc_confirmed": "yes", "portal_access_ready": "yes", "portal_batch_plan_ready": "yes", "a2a_tcc_confirmed": "yes", "fire_test_required": "no", "ir_application_change_required": "no", "corrections_required": "no", "schema_package_acquired": "yes" }, "software_vendor_support": "yes", "api_client_ready": "yes", "ats_status": "passed", "schema_version": "TY2026-v1.0" } } } }, "responses": { "200": { "description": "Delivered Product8 readiness snapshot", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/fire-iris-migration-readiness__output" }, "example": { "caveats": [ "No transmissions, filing, applications, tax determinations or approval guarantees.", "Caller declarations are unverified; no credentials or identities accepted.", "Portal readiness never establishes A2A readiness.", "IRIS form-family routing is a planning direction, not verified TY2026 per-channel schema compatibility.", "Prior-year and correction details fail closed even when general correction capability is documented.", "Source expiry is checked at execution; snapshot replays do not renew evidence.", "Unsigned local hashes detect drift against the seal; they are not authenticated agency attestations." ], "channel_paths": [ { "channel": "FIRE", "check_ids": [ "tax_year_scope", "correction_routing", "migration_rule_evidence", "form_channel_routing", "fire_ty2026_transition", "fire_filing_window", "fire_testing_window", "ir_application_changes" ], "production_ready": false, "readiness_basis": "Declared prerequisites and bounded public evidence only", "status": "NOT_READY" }, { "channel": "IRIS_PORTAL", "check_ids": [ "tax_year_scope", "correction_routing", "migration_rule_evidence", "form_channel_routing", "ir_application_changes", "iris_portal_tcc", "portal_access", "portal_batch_plan" ], "production_ready": false, "readiness_basis": "Declared prerequisites and bounded public evidence only", "status": "READY" }, { "channel": "IRIS_A2A", "check_ids": [ "tax_year_scope", "correction_routing", "migration_rule_evidence", "form_channel_routing", "ir_application_changes", "iris_a2a_tcc", "a2a_api_client", "a2a_schema_package", "a2a_ats", "a2a_software", "a2a_schema_version", "production_xml_validation" ], "production_ready": false, "readiness_basis": "Declared prerequisites and bounded public evidence only", "status": "UNKNOWN" }, { "channel": "THIRD_PARTY", "check_ids": [ "tax_year_scope", "correction_routing", "migration_rule_evidence", "form_channel_routing", "ir_application_changes", "third_party_support", "third_party_iris_path", "third_party_fulfillment" ], "production_ready": false, "readiness_basis": "Declared prerequisites and bounded public evidence only", "status": "UNKNOWN" } ], "checks": [ { "applies_to": [ "FIRE", "IRIS_PORTAL", "IRIS_A2A", "THIRD_PARTY" ], "basis": "LOCAL_POLICY", "check_id": "tax_year_scope", "detail": "", "reason": "TY2026 migration planning", "rule_ids": [ "local:tax_year_scope" ], "source_refs": [], "status": "READY" }, { "applies_to": [ "FIRE", "IRIS_PORTAL", "IRIS_A2A", "THIRD_PARTY" ], "basis": "DECLARED_AND_PUBLIC_EVIDENCE", "check_id": "correction_routing", "detail": "General IRIS correction capability does not establish a specific correction path. FIRE is unavailable after shutdown, including prior-year returns and corrections.", "reason": "No corrections declared", "rule_ids": [ "prior_correction_routing_2026", "local:correction_routing" ], "source_refs": [ "general_2026:428-428:7bd85722e27c", "iris:239-240:143afbfde1aa" ], "status": "NOT_APPLICABLE" }, { "applies_to": [ "FIRE", "IRIS_PORTAL", "IRIS_A2A", "THIRD_PARTY" ], "basis": "PUBLIC_EVIDENCE", "check_id": "migration_rule_evidence", "detail": "", "reason": "TY2026 migration planning requires usable, non-conflicting transition evidence", "rule_ids": [ "fire_iris_transition_2026", "local:migration_rule_evidence" ], "source_refs": [ "fire:245-252:a1fe060ebef1" ], "status": "READY" }, { "applies_to": [ "FIRE", "IRIS_PORTAL", "IRIS_A2A", "THIRD_PARTY" ], "basis": "PUBLIC_EVIDENCE", "check_id": "form_channel_routing", "detail": "", "reason": "Each declared form needs a supported planning route; corrections and unsupported years fail closed", "rule_ids": [ "iris_form_family_2026", "local:form_channel_routing" ], "source_refs": [ "iris:288-291:781909ee1072", "fire:246-254:c7afda83ecbf" ], "status": "READY" }, { "applies_to": [ "FIRE" ], "basis": "PUBLIC_EVIDENCE", "check_id": "fire_ty2026_transition", "detail": "", "reason": "Current FIRE users must transition to IRIS for TY2026 returns filed in 2027", "rule_ids": [ "fire_iris_transition_2026", "local:fire_ty2026_transition" ], "source_refs": [ "fire:245-252:a1fe060ebef1" ], "status": "NOT_READY" }, { "applies_to": [ "FIRE" ], "basis": "PUBLIC_EVIDENCE_AND_CLOCK", "check_id": "fire_filing_window", "detail": "", "reason": "Before published cutoff; this does not verify FIRE eligibility or current system availability", "rule_ids": [ "fire_submission_cutoff_2026", "local:fire_filing_window" ], "source_refs": [ "fire:250-250:4fbff9eda442" ], "status": "READY" }, { "applies_to": [ "FIRE" ], "basis": "DECLARED_AND_PUBLIC_EVIDENCE", "check_id": "fire_testing_window", "detail": "", "reason": "Date-only operational cutoff; no weekend rollover or invented closing time", "rule_ids": [ "fire_test_cutoff_2026", "local:fire_testing_window" ], "source_refs": [ "fire:248-248:b485f50b08aa" ], "status": "NOT_APPLICABLE" }, { "applies_to": [ "FIRE", "IRIS_PORTAL", "IRIS_A2A", "THIRD_PARTY" ], "basis": "DECLARED_AND_PUBLIC_EVIDENCE", "check_id": "ir_application_changes", "detail": "", "reason": "Nov 9 concerns changes to IR Applications for TCC; it is not a universal new-application deadline", "rule_ids": [ "fire_tcc_change_cutoff_2026", "local:ir_application_changes" ], "source_refs": [ "fire:249-249:2abcef802f1f" ], "status": "NOT_APPLICABLE" }, { "applies_to": [ "IRIS_PORTAL" ], "basis": "DECLARED", "check_id": "iris_portal_tcc", "detail": "No TCC value or account lookup. A FIRE TCC or Portal TCC never proves A2A enrollment.", "reason": "IRIS TCC status is active; channel-specific confirmation is yes", "rule_ids": [ "iris_portal_prerequisites_2026", "local:iris_portal_tcc" ], "source_refs": [ "iris:246-255:52f59ade729a" ], "status": "READY" }, { "applies_to": [ "IRIS_A2A" ], "basis": "DECLARED", "check_id": "iris_a2a_tcc", "detail": "No TCC value or account lookup. A FIRE TCC or Portal TCC never proves A2A enrollment.", "reason": "IRIS TCC status is active; channel-specific confirmation is yes", "rule_ids": [ "iris_a2a_prerequisites_2026", "local:iris_a2a_tcc" ], "source_refs": [ "iris:278-286:d20951a63974" ], "status": "READY" }, { "applies_to": [ "IRIS_PORTAL" ], "basis": "DECLARED", "check_id": "portal_access", "detail": "", "reason": "Caller-declared Portal access only", "rule_ids": [ "iris_portal_prerequisites_2026", "local:portal_access" ], "source_refs": [ "iris:246-255:52f59ade729a" ], "status": "READY" }, { "applies_to": [ "IRIS_PORTAL" ], "basis": "DECLARED_AND_PUBLIC_EVIDENCE", "check_id": "portal_batch_plan", "detail": "", "reason": "Declared total fits one batch of up to 100; no return content evaluated", "rule_ids": [ "iris_portal_prerequisites_2026", "local:portal_batch_plan" ], "source_refs": [ "iris:246-255:52f59ade729a" ], "status": "READY" }, { "applies_to": [ "IRIS_A2A" ], "basis": "DECLARED", "check_id": "a2a_api_client", "detail": "", "reason": "API Client ID readiness is separate from TCC; no ID or secret is received", "rule_ids": [ "iris_a2a_prerequisites_2026", "local:a2a_api_client" ], "source_refs": [ "iris:278-286:d20951a63974" ], "status": "READY" }, { "applies_to": [ "IRIS_A2A" ], "basis": "DECLARED", "check_id": "a2a_schema_package", "detail": "", "reason": "Caller-declared package acquisition; package bytes unavailable to this service", "rule_ids": [ "iris_a2a_prerequisites_2026", "local:a2a_schema_package" ], "source_refs": [ "iris:278-286:d20951a63974" ], "status": "READY" }, { "applies_to": [ "IRIS_A2A" ], "basis": "DECLARED", "check_id": "a2a_ats", "detail": "", "reason": "Caller-declared ATS status; no observed ATS acceptance", "rule_ids": [ "iris_a2a_prerequisites_2026", "local:a2a_ats" ], "source_refs": [ "iris:278-286:d20951a63974" ], "status": "READY" }, { "applies_to": [ "IRIS_A2A" ], "basis": "DECLARED", "check_id": "a2a_software", "detail": "", "reason": "Caller-declared software/vendor support; no vendor contacted", "rule_ids": [ "iris_a2a_prerequisites_2026", "local:a2a_software" ], "source_refs": [ "iris:278-286:d20951a63974" ], "status": "READY" }, { "applies_to": [ "IRIS_A2A" ], "basis": "DECLARED", "check_id": "a2a_schema_version", "detail": "", "reason": "Version label declared; matching package, tax-year applicability and contents remain unverified", "rule_ids": [ "iris_a2a_prerequisites_2026", "local:a2a_schema_version" ], "source_refs": [ "iris:278-286:d20951a63974" ], "status": "READY" }, { "applies_to": [ "IRIS_A2A" ], "basis": "CORPUS_LIMITATION", "check_id": "production_xml_validation", "detail": "UNSUPPORTED. No XML was received, generated or validated.", "reason": "Full TY2026 IRIS SOR schema bytes are absent from accepted corpus; public announcements are not schema contents", "rule_ids": [ "local:production_xml_validation" ], "source_refs": [], "status": "UNKNOWN" }, { "applies_to": [ "THIRD_PARTY" ], "basis": "DECLARED", "check_id": "third_party_support", "detail": "", "reason": "Software/vendor support declaration only", "rule_ids": [ "iris_a2a_prerequisites_2026", "local:third_party_support" ], "source_refs": [ "iris:278-286:d20951a63974" ], "status": "READY" }, { "applies_to": [ "THIRD_PARTY" ], "basis": "DECLARED", "check_id": "third_party_iris_path", "detail": "", "reason": "Provider IRIS migration support declaration only", "rule_ids": [ "fire_iris_transition_2026", "local:third_party_iris_path" ], "source_refs": [ "fire:245-252:a1fe060ebef1" ], "status": "UNKNOWN" }, { "applies_to": [ "THIRD_PARTY" ], "basis": "CORPUS_LIMITATION", "check_id": "third_party_fulfillment", "detail": "", "reason": "Provider channel, delegation, authorization and delivery are not observed", "rule_ids": [ "local:third_party_fulfillment" ], "source_refs": [], "status": "UNKNOWN" } ], "declared": { "api_client_ready": "yes", "ats_status": "passed", "filing_channel": "IRIS_A2A", "form_types": [ "1099-NEC" ], "readiness_flags": { "a2a_tcc_confirmed": "yes", "corrections_required": "no", "fire_test_required": "no", "ir_application_change_required": "no", "portal_access_ready": "yes", "portal_batch_plan_ready": "yes", "portal_tcc_confirmed": "yes", "schema_package_acquired": "yes" }, "schema_version": "TY2026-v1.0", "software_vendor_support": "yes", "tax_year": 2026, "tcc_status": "active", "volume_by_form": { "1099-NEC": 50 } }, "evaluated_at": "2026-10-05T02:35:00+00:00", "evidence_issues": [], "fee_eligibility": { "currency": "USDC", "eligible": false, "price_atomic": "50000", "rule": "OVERALL_DETERMINATE_READY_NOT_READY_NOT_APPLICABLE", "settlement_claimed": false, "unknown_overall_no_charge": true }, "filing_channel": "IRIS_A2A", "form_routing": [ { "declared_count": 50, "form_type": "1099-NEC", "planning_channels": [ "IRIS_PORTAL", "IRIS_A2A" ], "production_route_verified": false, "reason": "IRIS migration planning; exact per-channel TY2026 package acceptance not verified", "route": "IRIS_CHANNEL_REVIEW", "rule_ids": [ "iris_form_family_2026" ], "source_refs": [ "iris:288-291:781909ee1072", "fire:246-254:c7afda83ecbf" ], "status": "READY" } ], "limitations": [ "Independent low-data FIRE-to-IRIS migration planning snapshot; not affiliated with or endorsed by the IRS or SSA.", "No tax advice, tax treatment determination, taxpayer applicability determination, filing, preparation, submission, or account application/access.", "No taxpayer identity, TCC value, credentials, secrets, return contents, XML, transmissions or uploaded tax documents are accepted.", "READY is limited to declared planning prerequisites plus bounded reviewed public evidence; it is not production readiness, filing authorization or IRS acceptance.", "Production XML validation is UNSUPPORTED because full TY2026 IRIS SOR schema bytes are not in the accepted corpus.", "SSA EFW2 validation is OUTSIDE_SCOPE; W-2/W-3 remain separately routed to SSA.", "Caller declarations such as TCC state, API Client ID readiness, ATS status and vendor support are not independently observed.", "Evidence freshness is checked at execution; expired or unavailable rule evidence fails closed to UNKNOWN.", "Overall UNKNOWN and declared/service failures are no-charge; unrelated unknowns on non-requested alternative channels do not invalidate a determinate requested snapshot.", "Settlement status is not claimed by this body; x402 payment headers and durable order state are authoritative for settlement." ], "missing_prerequisites": [], "mode": "snapshot_replay", "observed": { "accounts_checked": false, "ats_acceptance_observed": false, "live_system_availability_observed": false, "schema_bytes_available": false, "source_evidence": [ { "excerpt_sha256": "b485f50b08aa87f4e0cdbc6baffa1de72cf3227318f8afed585bbb68b296508c", "headers_sha256": "9bf1898cb8ae6d25f4ee19bb100a6b58b1c197d48f372e02d2366342effe4e0e", "kind": "CAPTURED_PUBLIC_SOURCE", "line_end": 248, "line_start": 248, "observed_at": "2026-10-05T01:23:49.102244+00:00", "raw_sha256": "8fb9d0c6ddc08356edc83167a0ab63dbf0384185115157d45d7fe300fedfefd9", "ref_id": "fire:248-248:b485f50b08aa", "source_id": "fire", "text_sha256": "016610637221941060a480d7f56e6174acb2f6527a10cbf27eecfa2569f5b9e7", "url": "https://www.irs.gov/newsroom/irs-reminder-information-return-e-file-system-transitioning-to-a-new-platform", "valid_until": "2026-10-12T01:23:49.102244+00:00" }, { "excerpt_sha256": "2abcef802f1f0ce50d2e486094f371aaff4455d9c5933daa4ea28a2bf60f73b8", "headers_sha256": "9bf1898cb8ae6d25f4ee19bb100a6b58b1c197d48f372e02d2366342effe4e0e", "kind": "CAPTURED_PUBLIC_SOURCE", "line_end": 249, "line_start": 249, "observed_at": "2026-10-05T01:23:49.102244+00:00", "raw_sha256": "8fb9d0c6ddc08356edc83167a0ab63dbf0384185115157d45d7fe300fedfefd9", "ref_id": "fire:249-249:2abcef802f1f", "source_id": "fire", "text_sha256": "016610637221941060a480d7f56e6174acb2f6527a10cbf27eecfa2569f5b9e7", "url": "https://www.irs.gov/newsroom/irs-reminder-information-return-e-file-system-transitioning-to-a-new-platform", "valid_until": "2026-10-12T01:23:49.102244+00:00" }, { "excerpt_sha256": "4fbff9eda442ef0ac92b3f93cb3722e0434e4a253f5cb139841ff7640df4fcb6", "headers_sha256": "9bf1898cb8ae6d25f4ee19bb100a6b58b1c197d48f372e02d2366342effe4e0e", "kind": "CAPTURED_PUBLIC_SOURCE", "line_end": 250, "line_start": 250, "observed_at": "2026-10-05T01:23:49.102244+00:00", "raw_sha256": "8fb9d0c6ddc08356edc83167a0ab63dbf0384185115157d45d7fe300fedfefd9", "ref_id": "fire:250-250:4fbff9eda442", "source_id": "fire", "text_sha256": "016610637221941060a480d7f56e6174acb2f6527a10cbf27eecfa2569f5b9e7", "url": "https://www.irs.gov/newsroom/irs-reminder-information-return-e-file-system-transitioning-to-a-new-platform", "valid_until": "2026-10-12T01:23:49.102244+00:00" }, { "excerpt_sha256": "7bd85722e27cf2374a411e15ed594ac1416f89f1ea69705cc3d6aefcd9cce74a", "headers_sha256": "aac12ecf0df8fe0c54eb02bb1dd501342b051b76e1dbbfca17dabead93a16130", "kind": "CAPTURED_PUBLIC_SOURCE", "line_end": 428, "line_start": 428, "observed_at": "2026-10-05T01:23:49.102177+00:00", "raw_sha256": "19ac4f5e08a4ac1c0ff32df3519c6172e6081d5ce207d6885e96838f6ee84e7a", "ref_id": "general_2026:428-428:7bd85722e27c", "source_id": "general_2026", "text_sha256": "428b17832177482404a01402ab22dcadf2accfdb7e831a428a7ac792aa9754fd", "url": "https://www.irs.gov/publications/p1099", "valid_until": "2026-11-04T01:23:49.102177+00:00" }, { "excerpt_sha256": "143afbfde1aa0e0a4d5d82b67d589f89fb038e36f20783b0ffef128d0f74d037", "headers_sha256": "8c3da7cc880faeccbda7edf4e4293fb2b7dd51bea35641445d5242d09df1d2d4", "kind": "CAPTURED_PUBLIC_SOURCE", "line_end": 240, "line_start": 239, "observed_at": "2026-10-05T01:23:49.678551+00:00", "raw_sha256": "501f6f99d7dc43a531b255e4c21803058dee0a661db5610e62ff9cceceeb036f", "ref_id": "iris:239-240:143afbfde1aa", "source_id": "iris", "text_sha256": "b68779a7d8d3e9cc8df7fad0947eb083b3bee634a93e109a54645badb9130ef5", "url": "https://www.irs.gov/filing/e-file-information-returns-with-iris", "valid_until": "2026-10-12T01:23:49.678551+00:00" }, { "excerpt_sha256": "781909ee10721bd6154e5969cc359b35a888108b7fb52a893d58e9af847ce352", "headers_sha256": "8c3da7cc880faeccbda7edf4e4293fb2b7dd51bea35641445d5242d09df1d2d4", "kind": "CAPTURED_PUBLIC_SOURCE", "line_end": 291, "line_start": 288, "observed_at": "2026-10-05T01:23:49.678551+00:00", "raw_sha256": "501f6f99d7dc43a531b255e4c21803058dee0a661db5610e62ff9cceceeb036f", "ref_id": "iris:288-291:781909ee1072", "source_id": "iris", "text_sha256": "b68779a7d8d3e9cc8df7fad0947eb083b3bee634a93e109a54645badb9130ef5", "url": "https://www.irs.gov/filing/e-file-information-returns-with-iris", "valid_until": "2026-10-12T01:23:49.678551+00:00" }, { "excerpt_sha256": "c7afda83ecbf44b5fab7248e3672a10b52278b88732c00097c22322bb598ed60", "headers_sha256": "9bf1898cb8ae6d25f4ee19bb100a6b58b1c197d48f372e02d2366342effe4e0e", "kind": "CAPTURED_PUBLIC_SOURCE", "line_end": 254, "line_start": 246, "observed_at": "2026-10-05T01:23:49.102244+00:00", "raw_sha256": "8fb9d0c6ddc08356edc83167a0ab63dbf0384185115157d45d7fe300fedfefd9", "ref_id": "fire:246-254:c7afda83ecbf", "source_id": "fire", "text_sha256": "016610637221941060a480d7f56e6174acb2f6527a10cbf27eecfa2569f5b9e7", "url": "https://www.irs.gov/newsroom/irs-reminder-information-return-e-file-system-transitioning-to-a-new-platform", "valid_until": "2026-10-12T01:23:49.102244+00:00" }, { "excerpt_sha256": "a1fe060ebef1114e6da5209df174c13b780fa0587c0440755d1cbd93c0043435", "headers_sha256": "9bf1898cb8ae6d25f4ee19bb100a6b58b1c197d48f372e02d2366342effe4e0e", "kind": "CAPTURED_PUBLIC_SOURCE", "line_end": 252, "line_start": 245, "observed_at": "2026-10-05T01:23:49.102244+00:00", "raw_sha256": "8fb9d0c6ddc08356edc83167a0ab63dbf0384185115157d45d7fe300fedfefd9", "ref_id": "fire:245-252:a1fe060ebef1", "source_id": "fire", "text_sha256": "016610637221941060a480d7f56e6174acb2f6527a10cbf27eecfa2569f5b9e7", "url": "https://www.irs.gov/newsroom/irs-reminder-information-return-e-file-system-transitioning-to-a-new-platform", "valid_until": "2026-10-12T01:23:49.102244+00:00" }, { "excerpt_sha256": "52f59ade729ac9545668b1c1c7b18689f6ae059f390c4b8599bd39862e9c9415", "headers_sha256": "8c3da7cc880faeccbda7edf4e4293fb2b7dd51bea35641445d5242d09df1d2d4", "kind": "CAPTURED_PUBLIC_SOURCE", "line_end": 255, "line_start": 246, "observed_at": "2026-10-05T01:23:49.678551+00:00", "raw_sha256": "501f6f99d7dc43a531b255e4c21803058dee0a661db5610e62ff9cceceeb036f", "ref_id": "iris:246-255:52f59ade729a", "source_id": "iris", "text_sha256": "b68779a7d8d3e9cc8df7fad0947eb083b3bee634a93e109a54645badb9130ef5", "url": "https://www.irs.gov/filing/e-file-information-returns-with-iris", "valid_until": "2026-10-12T01:23:49.678551+00:00" }, { "excerpt_sha256": "d20951a63974f54fe5d668846d6fa5616ffb73baf5a0bdf199ca7374d9c5eeec", "headers_sha256": "8c3da7cc880faeccbda7edf4e4293fb2b7dd51bea35641445d5242d09df1d2d4", "kind": "CAPTURED_PUBLIC_SOURCE", "line_end": 286, "line_start": 278, "observed_at": "2026-10-05T01:23:49.678551+00:00", "raw_sha256": "501f6f99d7dc43a531b255e4c21803058dee0a661db5610e62ff9cceceeb036f", "ref_id": "iris:278-286:d20951a63974", "source_id": "iris", "text_sha256": "b68779a7d8d3e9cc8df7fad0947eb083b3bee634a93e109a54645badb9130ef5", "url": "https://www.irs.gov/filing/e-file-information-returns-with-iris", "valid_until": "2026-10-12T01:23:49.678551+00:00" } ] }, "operational_timeline": [ { "automatic_weekend_rollover": false, "cutoff_id": "FIRE_TEST", "cutoff_utc": null, "evidence_status": "READY", "phase": "BEFORE_DAY", "published_date": "2026-11-01", "published_time": null, "reason": "reviewed_hash_checked_fresh_evidence", "rule_ids": [ "fire_test_cutoff_2026" ], "scope": "FIRE test files only", "snapshot_only": false, "source_refs": [ "fire:248-248:b485f50b08aa" ], "timezone": "America/New_York" }, { "automatic_weekend_rollover": false, "cutoff_id": "IR_APPLICATION_CHANGES", "cutoff_utc": null, "evidence_status": "READY", "phase": "BEFORE_DAY", "published_date": "2026-11-09", "published_time": null, "reason": "reviewed_hash_checked_fresh_evidence", "rule_ids": [ "fire_tcc_change_cutoff_2026" ], "scope": "Changes to IR Applications for TCC; not a universal deadline for all new applications", "snapshot_only": false, "source_refs": [ "fire:249-249:2abcef802f1f" ], "timezone": "America/New_York" }, { "automatic_weekend_rollover": false, "cutoff_id": "FIRE_FILING", "cutoff_utc": "2026-11-19T20:00:00+00:00", "evidence_status": "READY", "phase": "BEFORE_INSTANT", "published_date": "2026-11-19", "published_time": "15:00:00-05:00", "reason": "reviewed_hash_checked_fresh_evidence", "rule_ids": [ "fire_submission_cutoff_2026" ], "scope": "Last FIRE filing day at 3:00 p.m. ET", "snapshot_only": false, "source_refs": [ "fire:250-250:4fbff9eda442" ], "timezone": "America/New_York" } ], "overall_status": "UNKNOWN", "production_xml_validation": "UNSUPPORTED", "readiness_semantics": "READY is a bounded planning check, not filing authorization, live access, tax advice or certification.", "scope": "PUBLIC_PRODUCTION_SNAPSHOT", "service_version": "1.0.0", "ssa_efw2_validation": "OUTSIDE_SCOPE", "tax_year": 2026, "tcc_processing_guidance": { "approval_guaranteed": false, "guaranteed_approval_date": null, "is_sla": false, "reason": "reviewed_hash_checked_fresh_evidence", "rule_ids": [ "tcc_processing_guidance_2026" ], "scope": "Typical guidance; processing times vary. No application date or computed approval deadline.", "source_refs": [ "general_2026:428-428:7bd85722e27c" ], "status": "READY", "typical_processing_business_days": 45 }, "unknown_items": [ "production_xml_validation", "third_party_iris_path", "third_party_fulfillment" ] } } }, "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } }, "X-PennyBot-Result-SHA256": { "description": "SHA-256 of exact retained JSON response bytes.", "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "PAYMENT-RESPONSE": { "description": "Successful first settlement response when present. Not emitted a second time on replay; absence alone does not prove zero charge.", "schema": { "type": "string" } } } }, "202": { "description": "Original order is still processing; do not create a new payment authorization.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotProcessing" } } } }, "400": { "description": "INVALID_INPUT; no-charge", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/fire-iris-migration-readiness__failure" } } } }, "402": { "description": "x402 Payment Required; runtime PAYMENT-REQUIRED terms are authoritative" }, "409": { "description": "Original request conflicts or retained result is not ready/available for this order state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRecoveryError" } } } }, "410": { "description": "Original retained result expired. No new work or payment is created. Contains order/settlement headers, not a result-hash header or a second PAYMENT-RESPONSE.", "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRetainedOutputExpired" }, "example": { "order_id": "ord_00000000-0000-4000-8000-000000000000", "error": "retained_output_expired" } } } }, "413": { "description": "LIMIT_EXCEEDED; no-charge", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/fire-iris-migration-readiness__failure" } } } }, "503": { "description": "TIMEOUT or EVIDENCE_UNAVAILABLE; no-charge", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/fire-iris-migration-readiness__failure" } } } } }, "x-x402": { "amount": "0.05", "atomicAmount": "50000", "currency": "USDC", "decimals": 6, "network": "eip155:84532", "scheme": "exact", "status": "live-runtime-authoritative", "resource": "https://playbrightgaming.com/agent-services/fire-iris-migration-readiness" }, "x-testnet-endpoint": "https://playbrightgaming.com/agent-services/fire-iris-migration-readiness", "x-billing": { "READY": "chargeable when the requested snapshot is determinate, evidence issues are empty, and the validated result is delivered", "NOT_READY": "chargeable determinate planning answer when evidence issues are empty and the validated result is delivered", "NOT_APPLICABLE": "chargeable determinate planning answer when evidence issues are empty and the validated result is delivered", "UNKNOWN": "no-charge", "declaredFailures": "invalid/oversize/timeout/evidence-unavailable/internal/storage/delivery failures are no-charge", "rule": "OVERALL_DETERMINATE_READY_NOT_READY_NOT_APPLICABLE" }, "x-privacy": { "taxpayerPiiAccepted": false, "tccValuesAccepted": false, "credentialsAccepted": false, "returnContentsAccepted": false, "rawDocumentsAccepted": false, "xmlAccepted": false, "allowed": "tax year, enumerated filing channel/forms/readiness flags, per-form counts, public schema-version label, and correction years only" }, "x-claims": { "taxAdvice": false, "taxTreatmentDetermination": false, "taxpayerApplicabilityDetermination": false, "filingOrSubmission": false, "accountApplicationOrAccess": false, "approvalGuarantee": false, "irsAffiliationOrEndorsement": false, "ssaAffiliationOrEndorsement": false, "schemaComplianceCertification": false, "productionXmlValidation": false, "ssaEfw2Validation": false }, "x-durability": { "persistentOrderState": true, "sameSignedAuthorizationReplayReturnsSameOrder": true, "sameResponseBodyReplay": true, "secondPaymentResponseOnReplay": false, "reexecuteOnReplay": false, "automaticResettleOnReplay": false, "changedRequestUnderUsedAuthorization": "rejected", "uncertainSettlement": "read-only chain/nonce recovery; never blindly resubmitted" }, "x-limits": { "inputBytes": 16384, "outputBytes": 262144, "formTypes": 5, "correctionYears": 10, "workerMs": 6500, "pipelineMs": 15000 }, "x-source-policy": { "reviewedPublicIrsEvidence": true, "runtimeEvidenceExpiryEnforced": true, "changedBytes": "explicit scoped review required; whole-document semantic equivalence is not inferred", "ambiguousUnavailableExpired": "UNKNOWN/no-charge" }, "x-example-provenance": "Input/output are illustrative shapes, not a current live observation or a guaranteed verdict. Output examples may describe independent synthetic fixtures.", "externalDocs": { "url": "https://playbrightgaming.com/agents/fire-iris-migration-readiness.md" }, "x-recovery": { "persistentOrderState": true, "sameOriginalRequestRequired": true, "originalIdempotencyKeyRecommended": true, "keyIsBearerCredential": true, "sameSignedAuthorizationReplay": true, "replayReturnsOriginalBody": true, "reexecuteOnReplay": false, "automaticResettleOnReplay": false, "secondPaymentResponseOnReplay": false, "automaticNewAuthorizationRetrySafe": false, "recoveryEndpoint": "https://playbrightgaming.com/agent-services/recover/{order_id}", "acknowledgmentEndpoint": "https://playbrightgaming.com/agent-services/ack/{order_id}", "documentation": "https://playbrightgaming.com/agents/delivery-recovery.md", "resultRetention": { "configuredSeconds": 900, "startsAt": "durable_result_preparation", "localCopyRecommended": true, "uncertainSettlementMayDelayDeletion": true, "freshWindowAfterReconciliation": false }, "retentionGuarantee": null, "settlementUncertainty": "Original identity is reconciled read-only. Retained output may be available while settlement remains uncertain.", "expiredRetainedOutput": { "httpStatus": 410, "error": "retained_output_expired", "appliesTo": [ "purchase_replay", "recover" ], "doesNotCreateNewPayment": true }, "legacyReplay": "Known original orders retain their original result bytes, schema and price. Current advertised terms apply only to new purchases." }, "x-source-freshness": { "earliestRelevantExpiryUtc": "2026-10-12T01:23:49.102244Z", "sourceExpiriesUtc": { "FIRE": "2026-10-12T01:23:49.102244Z", "IRIS": "2026-10-12T01:23:49.678551Z" }, "checkedAtDate": "2026-10-06", "runtimeAutomaticSourceRefresh": false, "notice": "Captured reviewed evidence, not continuous source monitoring. These are snapshot validity bounds, not a guarantee that an authority has not changed. Expired or unusable required evidence yields UNKNOWN/no charge. A later reviewed release may replace these bounds; inspect result evidence." }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Choose a unique cryptographically random value before the signed purchase; retain it privately with the exact original request and authorization. This is a bearer recovery credential, not a public order label. Never reuse for different input.", "schema": { "type": "string", "minLength": 32, "maxLength": 128, "pattern": "^[A-Za-z0-9_-]+$" } }, { "name": "PAYMENT-SIGNATURE", "in": "header", "required": false, "description": "Omit on the initial valid request to receive HTTP 402 and PAYMENT-REQUIRED. For a purchase, send the base64-encoded x402 payment authorization for those exact terms. This is a per-purchase payment authorization, not an account API key. Retain the original authorization and private Idempotency-Key for recovery; do not sign a new payment merely because delivery is uncertain.", "schema": { "type": "string", "contentEncoding": "base64" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "priceAtomic": "50000", "protocols": [ { "x402": {} } ], "network": "eip155:84532", "asset": "USDC", "accountRequired": false, "apiKeyRequired": false, "runtimeAuthority": "HTTP 402 PAYMENT-REQUIRED" } } }, "/agent-services/redacted-1099-readiness": { "post": { "summary": "Redacted 1099 Readiness", "description": "Classify each supplied opaque vendor record as CANDIDATE, NOT_CANDIDATE, REVIEW, or UNKNOWN under narrowly modeled reviewed predicates. This is reviewer-queue evidence, not a filing obligation, tax advice, tax treatment, worker/entity/foreign-status determination, or taxpayer identity verification.", "operationId": "pennybotRedacted1099Readiness", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/redacted-1099-readiness__input" }, "example": { "tax_year": 2026, "jurisdiction": "US-federal", "record_context": "original", "reviewed_policy_ids": [ "covered_business_scope_reviewed_v1", "complete_original_annual_rows_reviewed_v1", "federal_backup_withholding_reviewed_v1", "tpso_settlement_rows_reviewed_v1" ], "vendor_facts": [ { "vendor_id": "v_0000000000000001", "us_status": "us", "entity_class": "reviewed_covered_noncorporate", "service_class": "nec_services_reviewed", "w9_presence": "present", "tin_presence": "present" } ], "payments": [ { "row_id": "r_0000000000000001", "vendor_id": "v_0000000000000001", "payment_date": "2026-06-15", "amount_cents": 200000, "currency": "USD", "payment_channel": "direct", "withholding_cents": 0 } ] } } } }, "responses": { "200": { "description": "Delivered redacted 1099 reviewer-queue evidence", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/redacted-1099-readiness__output" }, "example": { "accepted_rule_version": "pennybot-tax-intelligence-foundation-20261004", "accepted_rules_sha256": "339ca26f6b10dba66ed35506a542f88c3521b542a5310248dd56112fbc3f3ff5", "assessed_at_utc": "2026-10-05T03:15:00+00:00", "caveats": [ "Reviewer queue only; no legal file/no-file, worker-status, entity-exception, foreign-status or tax-treatment determination.", "NOT_CANDIDATE means only the explicitly modeled predicate was not met on supplied reviewed facts; income below a reporting threshold may still be taxable.", "Declarations are unverified. No W-9, TIN, identity, account, annual completeness or payment processor was checked.", "Card/TPSO rows are excluded from NEC/MISC arithmetic. The TPSO predicate is separate and is not the business payer's filing obligation.", "No state rules, taxpayer documents, filings, corrections, refunds, or unsupported special-category determinations.", "Source freshness is a local evidence policy, not a guarantee of current law. Snapshot replay does not renew evidence." ], "counts": { "CANDIDATE": 1, "NOT_CANDIDATE": 0, "REVIEW": 0, "UNKNOWN": 0 }, "evidence_mode": "snapshot_replay", "fee_eligibility": { "currency": "USDC", "eligible": true, "price_atomic": "50000", "rule": "ALL_VENDORS_CANDIDATE_NOT_CANDIDATE_REVIEW_AND_RULE_EVIDENCE_READY", "settlement_claimed": false, "unknown_batch_no_charge": true }, "hash_encoding": "UTF8-sorted-compact-JSON", "jurisdiction": "US-federal", "limitations": [ "Reviewer-queue evidence only; never a legal file/no-file or filing-obligation determination.", "No taxpayer identity, names, TIN values, identifier hashes, credentials, account data, return contents, XML or document uploads are accepted.", "Opaque vendor_id and row_id values must be random caller-generated tokens and must not encode or hash identities.", "Caller declarations about entity class, US status, W-9/TIN presence, reviewed scope policies and annual completeness are not independently observed.", "CANDIDATE means a modeled reviewed predicate fired; it does not prove a filing obligation or tax treatment.", "NOT_CANDIDATE means only the modeled predicate did not fire on supplied reviewed facts; income may still be taxable or reportable under another rule.", "REVIEW is a determinate reviewer-queue outcome for incomplete/unsupported/ambiguous declarations and can be a paid answer; it is not a legal conclusion.", "UNKNOWN indicates unavailable/stale/conflicting required rule evidence and makes the whole batch no-charge.", "Payment-card/TPSO rows are excluded from NEC/MISC arithmetic; the TPSO predicate is separate settlement reconciliation and never the business payer filing obligation.", "No worker-status, entity-exception, foreign-treatment, state-rule, correction/refund, unsupported special-category or tax-treatment determination.", "Evidence freshness is enforced at execution; snapshot replay never renews accepted source evidence.", "Settlement status is not claimed in the result body; x402 payment response and durable order state are authoritative." ], "reviewed_policy_ids": [ "complete_original_annual_rows_reviewed_v1", "covered_business_scope_reviewed_v1", "federal_backup_withholding_reviewed_v1", "tpso_settlement_rows_reviewed_v1" ], "rule_checks": [ { "reason": "accepted_fresh_hash_checked_rule", "rule_ids": [ "nec_covered_threshold_2026" ], "source_refs": [ "nec_2026:597-599:fce70be2c890" ], "status": "READY", "topic": "nec_covered_threshold" } ], "scope": "PUBLIC_PRODUCTION_SNAPSHOT", "service_version": "redacted-1099-readiness-1.0.0", "source_evidence": [ { "excerpt_sha256": "fce70be2c890256bf7657904444ca22b9de0ae64af5b5218b699e6303b709597", "headers_sha256": "7bbde253dd7654dc9db3f184a661ccbc59e4156604ebdc16ff9fd8a82f86051e", "line_end": 599, "line_start": 597, "ref_id": "nec_2026:597-599:fce70be2c890", "retrieved_utc": "2026-10-05T01:23:47.028609+00:00", "source_id": "nec_2026", "source_sha256": "6857e6e771e5a361b8757a62cfae4d1da098f98be02f779d3f4063b5fc2e4898", "text_sha256": "68a6c4fec48295267cf12ce1a13e794f697661b2445f151177336c5386773f7d", "url": "https://www.irs.gov/instructions/i1099mec", "valid_until_utc": "2026-11-04T01:23:47.028609+00:00" } ], "source_manifest_sha256": "e77bc60e8363ab45fd3a5dd7804b38320e3da101bd877954aaaa127ef6d56047", "synthetic_inputs": false, "tax_year": 2026, "vendors": [ { "ambiguity_flags": [], "arithmetic_trace": [ { "amount_cents": 200000, "disposition": "included_nec_misc", "nec_misc_running_cents": 200000, "nec_misc_running_withholding_cents": 0, "payment_channel": "direct", "payment_date": "2026-06-15", "row_id": "r_0000000000000001", "tpso_running_cents": 0, "tpso_running_withholding_cents": 0, "withholding_cents": 0 } ], "candidate_kind": "NEC", "excluded_rows": [], "filing_determination": false, "included_row_ids": [ "r_0000000000000001" ], "missing_facts": [], "nec_misc": { "amount_cents": 200000, "amount_predicate": "MET", "backup_withholding_predicate": "NOT_EVALUATED", "threshold_cents": 200000, "withholding_cents": 0 }, "reasons": [ "covered_amount_threshold_met" ], "review_required": true, "rule_ids": [ "nec_covered_threshold_2026" ], "source_refs": [ "nec_2026:597-599:fce70be2c890" ], "status": "CANDIDATE", "tpso": { "comparison": "gross_cents > 2000000 AND transactions > 200", "gross_cents": 0, "payer_filing_obligation_determined": false, "predicate": "NOT_EVALUATED", "transactions": 0, "withholding_cents": 0 }, "tpso_included_row_ids": [], "vendor_id": "v_0000000000000001" } ] } } }, "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } }, "X-PennyBot-Result-SHA256": { "description": "SHA-256 of exact retained JSON response bytes.", "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "PAYMENT-RESPONSE": { "description": "Successful first settlement response when present. Not emitted a second time on replay; absence alone does not prove zero charge.", "schema": { "type": "string" } } } }, "202": { "description": "Original order is still processing; do not create a new payment authorization.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotProcessing" } } } }, "400": { "description": "INVALID_INPUT; no-charge", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/redacted-1099-readiness__failure" } } } }, "402": { "description": "x402 Payment Required; runtime PAYMENT-REQUIRED terms are authoritative" }, "409": { "description": "Original request conflicts or retained result is not ready/available for this order state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRecoveryError" } } } }, "410": { "description": "Original retained result expired. No new work or payment is created. Contains order/settlement headers, not a result-hash header or a second PAYMENT-RESPONSE.", "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRetainedOutputExpired" }, "example": { "order_id": "ord_00000000-0000-4000-8000-000000000000", "error": "retained_output_expired" } } } }, "413": { "description": "LIMIT_EXCEEDED; no-charge", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/redacted-1099-readiness__failure" } } } }, "503": { "description": "TIMEOUT or EVIDENCE_UNAVAILABLE; no-charge", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/redacted-1099-readiness__failure" } } } } }, "x-x402": { "amount": "0.05", "atomicAmount": "50000", "currency": "USDC", "decimals": 6, "network": "eip155:84532", "scheme": "exact", "status": "live-runtime-authoritative", "resource": "https://playbrightgaming.com/agent-services/redacted-1099-readiness" }, "x-testnet-endpoint": "https://playbrightgaming.com/agent-services/redacted-1099-readiness", "x-billing": { "CANDIDATE": "chargeable only when every required rule check is READY and batch UNKNOWN count is zero", "NOT_CANDIDATE": "chargeable under the same evidence-ready rule; means only the modeled predicate did not fire", "REVIEW": "chargeable determinate reviewer-queue result when all required rule evidence is READY", "UNKNOWN": "no-charge; any UNKNOWN makes the batch no-charge", "declaredFailures": "invalid/oversize/timeout/evidence-unavailable/internal/storage/delivery failures are no-charge", "rule": "ALL_VENDORS_CANDIDATE_NOT_CANDIDATE_REVIEW_AND_RULE_EVIDENCE_READY" }, "x-privacy": { "taxpayerIdentityAccepted": false, "tinValuesAccepted": false, "identifierHashesAccepted": false, "namesAccepted": false, "credentialsAccepted": false, "accountDataAccepted": false, "returnContentsAccepted": false, "rawDocumentsAccepted": false, "allowed": "random opaque vendor/row tokens, integer-cent redacted payment rows, enumerated classification/presence/channel facts and reviewed policy IDs" }, "x-claims": { "legalFilingDetermination": false, "filingObligationDetermination": false, "taxAdvice": false, "taxTreatmentDetermination": false, "workerStatusInference": false, "entityExceptionInference": false, "foreignStatusInference": false, "stateRules": false, "correctionsOrRefunds": false, "w9TinIdentityVerification": false, "tpsoAsBusinessPayerObligation": false }, "x-durability": { "persistentOrderState": true, "sameSignedAuthorizationReplayReturnsSameOrder": true, "sameResponseBodyReplay": true, "secondPaymentResponseOnReplay": false, "reexecuteOnReplay": false, "automaticResettleOnReplay": false, "changedRequestUnderUsedAuthorization": "rejected", "uncertainSettlement": "read-only chain/nonce recovery; never blindly resubmitted" }, "x-limits": { "inputBytes": 2097152, "outputBytes": 8388608, "vendors": 1000, "payments": 10000, "currency": "USD", "workerMs": 8500, "pipelineMs": 18000 }, "x-source-policy": { "reviewedPublicIrsEvidence": true, "runtimeEvidenceExpiryEnforced": true, "changedBytes": "fresh scoped excerpt review required; whole-document equivalence is not inferred", "ambiguousUnavailableExpired": "UNKNOWN/no-charge" }, "x-example-provenance": "Input/output are illustrative shapes, not a current live observation or a guaranteed verdict. Output examples may describe independent synthetic fixtures.", "externalDocs": { "url": "https://playbrightgaming.com/agents/redacted-1099-readiness.md" }, "x-recovery": { "persistentOrderState": true, "sameOriginalRequestRequired": true, "originalIdempotencyKeyRecommended": true, "keyIsBearerCredential": true, "sameSignedAuthorizationReplay": true, "replayReturnsOriginalBody": true, "reexecuteOnReplay": false, "automaticResettleOnReplay": false, "secondPaymentResponseOnReplay": false, "automaticNewAuthorizationRetrySafe": false, "recoveryEndpoint": "https://playbrightgaming.com/agent-services/recover/{order_id}", "acknowledgmentEndpoint": "https://playbrightgaming.com/agent-services/ack/{order_id}", "documentation": "https://playbrightgaming.com/agents/delivery-recovery.md", "resultRetention": { "configuredSeconds": 900, "startsAt": "durable_result_preparation", "localCopyRecommended": true, "uncertainSettlementMayDelayDeletion": true, "freshWindowAfterReconciliation": false }, "retentionGuarantee": null, "settlementUncertainty": "Original identity is reconciled read-only. Retained output may be available while settlement remains uncertain.", "expiredRetainedOutput": { "httpStatus": 410, "error": "retained_output_expired", "appliesTo": [ "purchase_replay", "recover" ], "doesNotCreateNewPayment": true }, "legacyReplay": "Known original orders retain their original result bytes, schema and price. Current advertised terms apply only to new purchases." }, "x-source-freshness": { "earliestRelevantExpiryUtc": "2026-11-04T01:23:47.028609Z", "checkedAtDate": "2026-10-06", "runtimeAutomaticSourceRefresh": false, "notice": "Captured reviewed evidence, not continuous source monitoring. These are snapshot validity bounds, not a guarantee that an authority has not changed. Expired or unusable required evidence yields UNKNOWN/no charge. A later reviewed release may replace these bounds; inspect result evidence." }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Choose a unique cryptographically random value before the signed purchase; retain it privately with the exact original request and authorization. This is a bearer recovery credential, not a public order label. Never reuse for different input.", "schema": { "type": "string", "minLength": 32, "maxLength": 128, "pattern": "^[A-Za-z0-9_-]+$" } }, { "name": "PAYMENT-SIGNATURE", "in": "header", "required": false, "description": "Omit on the initial valid request to receive HTTP 402 and PAYMENT-REQUIRED. For a purchase, send the base64-encoded x402 payment authorization for those exact terms. This is a per-purchase payment authorization, not an account API key. Retain the original authorization and private Idempotency-Key for recovery; do not sign a new payment merely because delivery is uncertain.", "schema": { "type": "string", "contentEncoding": "base64" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "priceAtomic": "50000", "protocols": [ { "x402": {} } ], "network": "eip155:84532", "asset": "USDC", "accountRequired": false, "apiKeyRequired": false, "runtimeAuthority": "HTTP 402 PAYMENT-REQUIRED" } } }, "/agent-services/year-end-close-readiness": { "post": { "summary": "Year-End Close Readiness Audit", "description": "Evaluate a bounded caller-supplied close checklist as READY, NOT_READY, REVIEW, or UNKNOWN. Caller policy defines readiness. No bank access, raw statements, audit assurance, GAAP/tax certification, balance verification, accounting entries, fraud detection, or tax/legal advice.", "operationId": "pennybotYearEndCloseReadiness", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/year-end-close-readiness__input" }, "example": { "period": { "start": "2026-12-01", "end": "2026-12-31", "basis": "accrual" }, "account_manifest": [ { "account_id": "a_0000000000000001", "account_type": "cash", "last_reconciled_date": "2026-12-31", "statement_present": true, "declared_balance_cents": 1250000, "close_status": "complete" }, { "account_id": "a_0000000000000002", "account_type": "credit_card", "last_reconciled_date": "2026-12-30", "statement_present": true, "declared_balance_cents": -24500, "close_status": "complete" } ], "exception_counts": { "unreconciled_items": 0, "unclassified_transactions": 0, "missing_documents": 0, "duplicate_entries": 0, "open_adjustments": 0, "unmatched_payments": 0, "other_review_items": 0 }, "inventory_count_status": "not_applicable", "fixed_asset_review_status": "complete", "payroll_reconciliation_status": "complete", "checklist_policy": { "policy_id": "p_demo_close", "version": "1.0", "checks": [ { "check_id": "cash_statement", "mode": "required", "predicate": "STATEMENT_PRESENT", "dependencies": [], "account_types": [ "cash" ] }, { "check_id": "cash_reconciled", "mode": "required", "predicate": "RECONCILED_ON_OR_AFTER", "dependencies": [ "cash_statement" ], "account_types": [ "cash" ], "max_days_before_period_end": 0 }, { "check_id": "exceptions_clear", "mode": "required", "predicate": "EXCEPTION_COUNT_AT_MOST", "dependencies": [], "category": "unreconciled_items", "max_count": 0 }, { "check_id": "payroll_status", "mode": "review", "predicate": "STATUS_IN", "dependencies": [], "fact": "payroll_reconciliation_status", "allowed_statuses": [ "complete", "not_applicable" ] } ] } } } } }, "responses": { "200": { "description": "Delivered close-readiness evidence", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/year-end-close-readiness__output" }, "example": { "blocked_prerequisites": [], "checks": [ { "account_refs": [ "a_0000000000000001" ], "check_id": "cash_statement", "cutoff": null, "evidence_refs": [ "irs_pub583", "irs_record_transactions" ], "fact_refs": [], "mode": "required", "predicate": "STATEMENT_PRESENT", "prerequisite_refs": [], "reason": "all_selected_statements_declared_present", "status": "PASS" }, { "account_refs": [ "a_0000000000000001" ], "check_id": "cash_reconciled", "cutoff": "2026-12-31", "evidence_refs": [ "irs_pub583", "irs_record_transactions" ], "fact_refs": [], "mode": "required", "predicate": "RECONCILED_ON_OR_AFTER", "prerequisite_refs": [ "cash_statement" ], "reason": "all_selected_reconciliations_meet_cutoff", "status": "PASS" }, { "account_refs": [], "check_id": "exceptions_clear", "cutoff": null, "evidence_refs": [ "irs_pub583", "irs_record_transactions" ], "fact_refs": [], "mode": "required", "predicate": "EXCEPTION_COUNT_AT_MOST", "prerequisite_refs": [], "reason": "exception_count_within_caller_threshold", "status": "PASS" }, { "account_refs": [], "check_id": "payroll_status", "cutoff": null, "evidence_refs": [ "irs_pub583", "irs_record_transactions" ], "fact_refs": [], "mode": "review", "predicate": "STATUS_IN", "prerequisite_refs": [], "reason": "declared_status_allowed_by_caller_policy", "status": "PASS" } ], "counts": { "FAIL": 0, "PASS": 4, "REVIEW": 0, "UNKNOWN": 0 }, "evaluated_at_utc": "2026-10-06T05:35:29.109997+00:00", "evidence_mode": "snapshot_replay", "fee_eligibility": { "currency": "USDC", "eligible": true, "price_atomic": "50000", "rule": "READY_NOT_READY_REVIEW_IF_NO_UNKNOWN_AND_VALIDATED", "settlement_claimed": false, "unknown_no_charge": true }, "limitations": [ "Caller policy defines readiness; PennyBot does not supply a universal close checklist.", "Missing evidence is not proof of accounting error.", "Passing this checklist is not audit assurance, GAAP compliance, tax readiness certification, financial statement assurance, tax advice, or legal advice.", "No adjusting entries, journal entries, corrections, filing decisions, tax positions, or materiality judgments are generated.", "Declared balances are checked for presence only; balance correctness is not verified.", "No bank verification, external account access, transaction retrieval, fraud detection, or taxpayer identity verification occurs.", "Caller declarations are unverified, including account type, reconciliation date, statement presence, statuses, exception counts, and summary balances.", "Cash/accrual basis is preserved as caller metadata and is not converted into accounting advice.", "Accepted public IRS context supports general recordkeeping importance only; it does not define checklist completeness.", "Snapshot replay preserves prior evidence context and never renews current source freshness." ], "missing_evidence": [], "overall_status": "READY", "overdue_reconciliations": [], "period": { "basis": "accrual", "end": "2026-12-31", "start": "2026-12-01" }, "policy_id": "p_demo_close", "policy_sha256": "bb09a176450ce2303d8d3218a518e83384118a162b8a33f101944e67650ea461", "policy_version": "1.0", "request_sha256": "7289a5586364bb00216fbc5ddcdae57ed2538784e2ff658773a0f700b64e04f7", "scope": "PUBLIC_PRODUCTION_SNAPSHOT", "service": "year-end-close-readiness", "service_version": "year-end-close-readiness-1.0.0", "source_evidence": [ { "retrieved_utc": "2026-10-06T05:34:59.682Z", "role": "general_recordkeeping_context", "sha256": "8e4c0a2a7cb0fed04f16671e38ccbf79547bbf01f08d22bc8c0f61ca71243af5", "source_id": "irs_pub583", "url": "https://www.irs.gov/publications/p583", "valid_until_utc": "2026-11-05T05:35:29.109997+00:00" }, { "retrieved_utc": "2026-10-06T05:35:00.034Z", "role": "general_recordkeeping_context", "sha256": "9d4ee215d5812ab414e8d64d4ffbbea3409f463099bbe75aa47d442d7634701d", "source_id": "irs_record_transactions", "url": "https://www.irs.gov/businesses/small-businesses-self-employed/how-should-i-record-my-business-transactions", "valid_until_utc": "2026-11-05T05:35:29.109997+00:00" } ], "source_fresh_for_current_use": true, "unmet_check_ids": [], "unresolved_exception_counts": [] } } }, "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } }, "X-PennyBot-Result-SHA256": { "description": "SHA-256 of exact retained JSON response bytes.", "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "PAYMENT-RESPONSE": { "description": "Successful first settlement response when present. Not emitted a second time on replay; absence alone does not prove zero charge.", "schema": { "type": "string" } } } }, "202": { "description": "Original order is still processing; do not create a new payment authorization.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotProcessing" } } } }, "400": { "description": "INVALID_INPUT; no-charge" }, "402": { "description": "x402 Payment Required; runtime terms authoritative" }, "409": { "description": "Original request conflicts or retained result is not ready/available for this order state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRecoveryError" } } } }, "410": { "description": "Original retained result expired. No new work or payment is created. Contains order/settlement headers, not a result-hash header or a second PAYMENT-RESPONSE.", "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRetainedOutputExpired" }, "example": { "order_id": "ord_00000000-0000-4000-8000-000000000000", "error": "retained_output_expired" } } } }, "413": { "description": "LIMIT_EXCEEDED; no-charge" }, "503": { "description": "TIMEOUT/EVIDENCE_UNAVAILABLE; no-charge" } }, "x-x402": { "amount": "0.05", "atomicAmount": "50000", "currency": "USDC", "decimals": 6, "network": "eip155:84532", "scheme": "exact", "status": "live-runtime-authoritative", "resource": "https://playbrightgaming.com/agent-services/year-end-close-readiness" }, "x-billing": { "READY": "chargeable when validated with zero UNKNOWN", "NOT_READY": "chargeable determinate caller-policy failure with zero UNKNOWN", "REVIEW": "chargeable determinate reviewer-needed result with zero UNKNOWN", "UNKNOWN": "no-charge", "declaredFailures": "invalid/oversize/timeout/evidence-unavailable/storage/delivery failures are no-charge", "rule": "READY_NOT_READY_REVIEW_IF_NO_UNKNOWN_AND_VALIDATED" }, "x-privacy": { "opaqueAccountIdsOnly": true, "namesAccepted": false, "bankAccountNumbersAccepted": false, "taxpayerIdsAccepted": false, "credentialsAccepted": false, "rawStatementsAccepted": false, "transactionFeedsAccepted": false, "documentsAccepted": false, "arbitraryExecutablePolicyAccepted": false }, "x-claims": { "auditAssurance": false, "gaapCompliance": false, "taxReadinessCertification": false, "taxAdvice": false, "legalAdvice": false, "adjustingEntries": false, "journalEntries": false, "balanceCorrectness": false, "bankVerification": false, "fraudDetection": false }, "x-durability": { "persistentOrderState": true, "sameSignedAuthorizationReplayReturnsSameOrder": true, "sameResponseBodyReplay": true, "secondPaymentResponseOnReplay": false, "reexecuteOnReplay": false, "automaticResettleOnReplay": false, "changedRequestUnderUsedAuthorization": "rejected", "uncertainSettlement": "read-only recovery; never blindly resubmitted" }, "x-limits": { "inputBytes": 1048576, "outputBytes": 4194304, "accounts": 500, "combinedAccountsChecks": 1000 }, "x-source-policy": { "callerPolicyDefinesReadiness": true, "reviewedPublicContext": true, "runtimeEvidenceExpiryEnforced": true, "snapshotReplayDoesNotRenewFreshness": true }, "x-example-provenance": "Input/output are illustrative shapes, not a current live observation or a guaranteed verdict. Output examples may describe independent synthetic fixtures.", "externalDocs": { "url": "https://playbrightgaming.com/agents/year-end-close-readiness.md" }, "x-recovery": { "persistentOrderState": true, "sameOriginalRequestRequired": true, "originalIdempotencyKeyRecommended": true, "keyIsBearerCredential": true, "sameSignedAuthorizationReplay": true, "replayReturnsOriginalBody": true, "reexecuteOnReplay": false, "automaticResettleOnReplay": false, "secondPaymentResponseOnReplay": false, "automaticNewAuthorizationRetrySafe": false, "recoveryEndpoint": "https://playbrightgaming.com/agent-services/recover/{order_id}", "acknowledgmentEndpoint": "https://playbrightgaming.com/agent-services/ack/{order_id}", "documentation": "https://playbrightgaming.com/agents/delivery-recovery.md", "resultRetention": { "configuredSeconds": 900, "startsAt": "durable_result_preparation", "localCopyRecommended": true, "uncertainSettlementMayDelayDeletion": true, "freshWindowAfterReconciliation": false }, "retentionGuarantee": null, "settlementUncertainty": "Original identity is reconciled read-only. Retained output may be available while settlement remains uncertain.", "expiredRetainedOutput": { "httpStatus": 410, "error": "retained_output_expired", "appliesTo": [ "purchase_replay", "recover" ], "doesNotCreateNewPayment": true }, "legacyReplay": "Known original orders retain their original result bytes, schema and price. Current advertised terms apply only to new purchases." }, "x-source-freshness": { "basis": "caller_supplied_policy", "externalSourceExpiryApplicable": false, "checkedAtDate": "2026-10-06", "runtimeAutomaticSourceRefresh": false, "notice": "Evaluates caller-supplied policy; no external tax-source expiry is asserted." }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Choose a unique cryptographically random value before the signed purchase; retain it privately with the exact original request and authorization. This is a bearer recovery credential, not a public order label. Never reuse for different input.", "schema": { "type": "string", "minLength": 32, "maxLength": 128, "pattern": "^[A-Za-z0-9_-]+$" } }, { "name": "PAYMENT-SIGNATURE", "in": "header", "required": false, "description": "Omit on the initial valid request to receive HTTP 402 and PAYMENT-REQUIRED. For a purchase, send the base64-encoded x402 payment authorization for those exact terms. This is a per-purchase payment authorization, not an account API key. Retain the original authorization and private Idempotency-Key for recovery; do not sign a new payment merely because delivery is uncertain.", "schema": { "type": "string", "contentEncoding": "base64" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "priceAtomic": "50000", "protocols": [ { "x402": {} } ], "network": "eip155:84532", "asset": "USDC", "accountRequired": false, "apiKeyRequired": false, "runtimeAuthority": "HTTP 402 PAYMENT-REQUIRED" } } }, "/agent-services/tax-year-rule-diff-evidence": { "post": { "summary": "Tax-Year Rule Diff Evidence", "description": "Compare bounded accepted public IRS source pairs and curated topics. Reports TEXT_CHANGED/TEXT_UNCHANGED separately from FACT_CHANGED/FACT_UNCHANGED/BASELINE_NOT_MODELED, with explicit CONFLICT/UNKNOWN states. Text or byte changes are not automatically legal rule changes. No personalized tax/legal advice, filing determination, compliance certification, or comprehensive legal-change claim.", "operationId": "pennybotTaxYearRuleDiffEvidence", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/tax-year-rule-diff-evidence__input" }, "example": { "baseline_source_ids": [ "nec_2025" ], "current_source_ids": [ "nec_2026" ], "tax_years": { "from": 2025, "to": 2026 }, "topics": [ "backup_withholding_exception", "nec_covered_threshold", "misc_fields" ], "caller_assertions": [ { "assertion_id": "as_nec_threshold", "topic": "nec_covered_threshold", "field_path": "changes.threshold.after.amount_cents", "expected_value": 200000 } ] } } } }, "responses": { "200": { "description": "Delivered tax-year rule diff evidence", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/tax-year-rule-diff-evidence__output" }, "example": { "byte_change_is_rule_change": false, "caller_assertions": [ { "assertion_id": "as_nec_threshold", "expected_value": 200000, "field_path": "changes.threshold.after.amount_cents", "observed_value": 200000, "reason": "caller_assertion_compared_to_curated_field", "status": "MATCH", "topic": "nec_covered_threshold" } ], "comprehensive_legal_change_history": false, "corpus_sha256": "06a4c02a5fa91baa65614807850bf95e033d14b6dc3543f8d8dfb6c5e4073928", "evaluated_at_utc": "2026-10-06T07:40:10.687000+00:00", "evidence_mode": "snapshot_replay", "evidence_valid_until_utc": "2026-11-04T01:23:47.028609+00:00", "fee_eligibility": { "conflict_no_charge": true, "currency": "USDC", "eligible": true, "price_atomic": "20000", "rule": "COMPLETE_ONLY_IF_VALIDATED", "settlement_claimed": false, "unknown_no_charge": true }, "limitations": [ "Captured-source text change is not by itself a legal rule change.", "Curated fact deltas are reviewed evidence from the accepted Tax Intelligence Foundation, not personalized applicability.", "This service is not a comprehensive legal or regulatory change history.", "Proposed, draft, final, archived, superseded, and current sources must remain distinct authority states.", "No tax or legal advice, filing determination, compliance certification, or personalized applicability conclusion is provided.", "Caller assertions are software regression checks against the curated corpus, not official IRS statements.", "Fresh whole-page bytes may change without rewriting the accepted corpus; scoped reviewed evidence is the requalification boundary.", "Snapshot replay never renews current source freshness." ], "overall_status": "COMPLETE", "request_sha256": "94ae2a9de0bed7fb3a6c277495ec8beccfcdbd2fdd8ddb9cceb32103ab975d3a", "requested_source_pairs": [ { "baseline_source_id": "nec_2025", "current_source_id": "nec_2026" } ], "scope": "PUBLIC_PRODUCTION_SNAPSHOT", "service": "tax-year-rule-diff-evidence", "service_version": "tax-year-rule-diff-1.0.0", "source_fresh_for_current_use": true, "source_review_sha256": "60c027ad4440283699c58bde661143756591902617195ba0372b074455fa5460", "tax_years": { "from": 2025, "to": 2026 }, "topic_results": [ { "after_evidence": [ { "exact_extracted_text": "You must also file Form 1099-MISC for each person from whom you have withheld any federal income tax (report in box 4) under the backup withholding rules regardless of the amount of the payment.", "excerpt_sha256": "6524c1838b03025b84b96291a4a21930f0d9c771e38d8423f6b4b44d68d7069e", "line_end": 409, "line_start": 409, "page": null, "source_id": "nec_2026", "source_sha256": "6857e6e771e5a361b8757a62cfae4d1da098f98be02f779d3f4063b5fc2e4898", "text_sha256": "68a6c4fec48295267cf12ce1a13e794f697661b2445f151177336c5386773f7d", "url": "https://www.irs.gov/instructions/i1099mec" }, { "exact_extracted_text": "You must also file Form 1099-NEC for each person from whom you have withheld any federal income tax (report in box 4) under the backup withholding rules regardless of the amount of the payment.", "excerpt_sha256": "246af713c6c0680958e00c0a77cfa30774814056c9195e052033654fefb1da6d", "line_end": 603, "line_start": 603, "page": null, "source_id": "nec_2026", "source_sha256": "6857e6e771e5a361b8757a62cfae4d1da098f98be02f779d3f4063b5fc2e4898", "text_sha256": "68a6c4fec48295267cf12ce1a13e794f697661b2445f151177336c5386773f7d", "url": "https://www.irs.gov/instructions/i1099mec" } ], "after_rule_id": "backup_withholding_exception_2026", "before_evidence": [ { "exact_extracted_text": "Y ou must also file Form 1099-NEC for each person from \nwhom you have withheld any federal income tax (report in \nbox 4) under the backup withholding rules regardless of the \namount of the payment.", "excerpt_sha256": "1f3079a7b1dafa74566c119bb30d34361002d9214d475716878df6ef5f083b5b", "line_end": 875, "line_start": 872, "page": 7, "source_id": "nec_2025", "source_sha256": "372a0f683aa10650889d4ddcbe96b33bc0998ab31fdbf6e36d2262e3f1542dce", "text_sha256": "c13215e694de43470ba8278df56324f1b2e632ca229e165013f2fd066ddcb8db", "url": "https://www.irs.gov/pub/irs-prior/i1099mec--2025.pdf" }, { "exact_extracted_text": "Y ou must also file Form 1099-MISC for each person from \nwhom you have withheld any federal income tax (report in \nbox 4) under the backup withholding rules regardless of the \namount of the payment.", "excerpt_sha256": "7d9ea6fc785005063941d027c6c1f2fdae141d015e209f92bac66c026d2e7796", "line_end": 156, "line_start": 153, "page": 2, "source_id": "nec_2025", "source_sha256": "372a0f683aa10650889d4ddcbe96b33bc0998ab31fdbf6e36d2262e3f1542dce", "text_sha256": "c13215e694de43470ba8278df56324f1b2e632ca229e165013f2fd066ddcb8db", "url": "https://www.irs.gov/pub/irs-prior/i1099mec--2025.pdf" } ], "before_rule_id": "backup_withholding_exception_2025", "changes": {}, "fact_status": "FACT_UNCHANGED", "filing_year_applicability": { "from": 2026, "to": 2027 }, "official_text_interpretation": false, "reason": "reviewed_foundation_delta", "source_pair_id": "nec_misc_2025_2026", "tax_year_applicability": { "from": 2025, "to": 2026 }, "text_spans": [ { "after_lines": [ "You must also file Form 1099-MISC for each person from whom you have withheld any federal income tax (report in box 4) under the backup withholding rules regardless of the amount of the payment.", "You must also file Form 1099-NEC for each person from whom you have withheld any federal income tax (report in box 4) under the backup withholding rules regardless of the amount of the payment." ], "before_lines": [ "Y ou must also file Form 1099-NEC for each person from", "whom you have withheld any federal income tax (report in", "box 4) under the backup withholding rules regardless of the", "amount of the payment.", "Y ou must also file Form 1099-MISC for each person from", "whom you have withheld any federal income tax (report in", "box 4) under the backup withholding rules regardless of the", "amount of the payment." ], "kind": "CHANGED" } ], "text_status": "TEXT_CHANGED", "topic": "backup_withholding_exception" }, { "after_evidence": [ { "exact_extracted_text": "File Form 1099-NEC, Nonemployee Compensation, for each person in the course of your business during the year to whom you have paid at least $2,000 in:\nServices performed by someone who is not your employee (including parts and materials) (box 1a); or\nPayments to an attorney (box 1a). (See Payments to attorneys , later.)", "excerpt_sha256": "fce70be2c890256bf7657904444ca22b9de0ae64af5b5218b699e6303b709597", "line_end": 599, "line_start": 597, "page": null, "source_id": "nec_2026", "source_sha256": "6857e6e771e5a361b8757a62cfae4d1da098f98be02f779d3f4063b5fc2e4898", "text_sha256": "68a6c4fec48295267cf12ce1a13e794f697661b2445f151177336c5386773f7d", "url": "https://www.irs.gov/instructions/i1099mec" } ], "after_rule_id": "nec_covered_threshold_2026", "before_evidence": [ { "exact_extracted_text": "Specific Instructions for Form \n1099-NEC\nFile Form 1099-NEC, Nonemployee Compensation, for each \nperson in the course of your business to whom you have paid \nthe following during the year.\n• At least $600 in:\n1. Services performed by someone who is not your \nemployee (including parts and materials) (box 1); or\n2. Payments to an attorney (box 1). (See Payments to \nattorneys, later.)", "excerpt_sha256": "9c1b34a57d38022d28098d8daee3dc6d81020fe29aff43c0b06864c9014110d2", "line_end": 864, "line_start": 855, "page": 7, "source_id": "nec_2025", "source_sha256": "372a0f683aa10650889d4ddcbe96b33bc0998ab31fdbf6e36d2262e3f1542dce", "text_sha256": "c13215e694de43470ba8278df56324f1b2e632ca229e165013f2fd066ddcb8db", "url": "https://www.irs.gov/pub/irs-prior/i1099mec--2025.pdf" } ], "before_rule_id": "nec_covered_threshold_2025", "changes": { "box_field": { "after": [ "1a" ], "before": [ "1" ] }, "fact": { "after": { "covered_payments": [ "nonemployee_services_including_parts_materials", "attorney_fees" ], "currency": "USD", "minimum_inclusive": 2000 }, "before": { "covered_payments": [ "nonemployee_services_including_parts_materials", "attorney_fees" ], "currency": "USD", "minimum_inclusive": 600 } }, "threshold": { "after": { "amount_cents": 200000, "basis": "annual_covered_payments_per_payee", "currency": "USD", "operator": "gte" }, "before": { "amount_cents": 60000, "basis": "annual_covered_payments_per_payee", "currency": "USD", "operator": "gte" } } }, "fact_status": "FACT_CHANGED", "filing_year_applicability": { "from": 2026, "to": 2027 }, "official_text_interpretation": false, "reason": "reviewed_foundation_delta", "source_pair_id": "nec_misc_2025_2026", "tax_year_applicability": { "from": 2025, "to": 2026 }, "text_spans": [ { "after_lines": [ "File Form 1099-NEC, Nonemployee Compensation, for each person in the course of your business during the year to whom you have paid at least $2,000 in:", "Services performed by someone who is not your employee (including parts and materials) (box 1a); or", "Payments to an attorney (box 1a). (See Payments to attorneys , later.)" ], "before_lines": [ "Specific Instructions for Form", "1099-NEC", "File Form 1099-NEC, Nonemployee Compensation, for each", "person in the course of your business to whom you have paid", "the following during the year.", "• At least $600 in:", "1. Services performed by someone who is not your", "employee (including parts and materials) (box 1); or", "2. Payments to an attorney (box 1). (See Payments to", "attorneys, later.)" ], "kind": "CHANGED" } ], "text_status": "TEXT_CHANGED", "topic": "nec_covered_threshold" }, { "after_evidence": [ { "exact_extracted_text": "Box 13a. Cash Tips\nEnter the total amount designated as cash tips included in box 3. Cash tips include tips paid in cash or charged by customers.\nBox 13b. Treasury Tipped Occupation Code(s) (TTOC)\nEnter the TTOC for the payee’s tipped occupation(s). Enter up to two code(s) based on the occupation(s) that the tips were received in. If tips were received in more than two occupations, include the Treasury Tipped Occupation Code for any two of the three or more occupations in which tips were received. If any tips were received in a nonqualifying occupation, then “000” must be input as one of the occupation code(s). See IRS.gov/TTOC for the applicable code(s).\nBox 14. Overtime Compensation\nEnter the total amount of qualified overtime compensation included in box 3. Qualified overtime compensation is compensation that is paid to an individual required under section 7 of the Fair Labor Standards Act (FLSA) of 1938 that is more than the regular rate at which the individual is paid. For example, only the “half” portion of “time-and-a-half” compensation would be reported in box 14. For more information about overtime compensation, go to Overtime Pay.", "excerpt_sha256": "e93a350e6db95519344129476c947776cac5f3cca4a8c3eba4d404c0c18f2524", "line_end": 590, "line_start": 585, "page": null, "source_id": "nec_2026", "source_sha256": "6857e6e771e5a361b8757a62cfae4d1da098f98be02f779d3f4063b5fc2e4898", "text_sha256": "68a6c4fec48295267cf12ce1a13e794f697661b2445f151177336c5386773f7d", "url": "https://www.irs.gov/instructions/i1099mec" } ], "after_rule_id": "misc_fields_2026", "before_evidence": [], "before_rule_id": null, "changes": {}, "fact_status": "BASELINE_NOT_MODELED", "filing_year_applicability": { "from": 2026, "to": 2027 }, "official_text_interpretation": false, "reason": "baseline_not_modeled_in_accepted_foundation", "source_pair_id": "nec_misc_2025_2026", "tax_year_applicability": { "from": 2025, "to": 2026 }, "text_spans": [], "text_status": "BASELINE_NOT_MODELED", "topic": "misc_fields" } ] } } }, "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } }, "X-PennyBot-Result-SHA256": { "description": "SHA-256 of exact retained JSON response bytes.", "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "PAYMENT-RESPONSE": { "description": "Successful first settlement response when present. Not emitted a second time on replay; absence alone does not prove zero charge.", "schema": { "type": "string" } } } }, "202": { "description": "Original order is still processing; do not create a new payment authorization.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotProcessing" } } } }, "400": { "description": "INVALID_INPUT; no-charge" }, "402": { "description": "x402 Payment Required; runtime terms authoritative" }, "409": { "description": "Original request conflicts or retained result is not ready/available for this order state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRecoveryError" } } } }, "410": { "description": "Original retained result expired. No new work or payment is created. Contains order/settlement headers, not a result-hash header or a second PAYMENT-RESPONSE.", "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRetainedOutputExpired" }, "example": { "order_id": "ord_00000000-0000-4000-8000-000000000000", "error": "retained_output_expired" } } } }, "413": { "description": "LIMIT_EXCEEDED; no-charge" }, "503": { "description": "EVIDENCE_UNAVAILABLE; no-charge" } }, "x-x402": { "amount": "0.02", "atomicAmount": "20000", "currency": "USDC", "decimals": 6, "network": "eip155:84532", "scheme": "exact", "status": "live-runtime-authoritative", "resource": "https://playbrightgaming.com/agent-services/tax-year-rule-diff-evidence" }, "x-billing": { "COMPLETE": "chargeable only when validated against accepted unexpired evidence", "CONFLICT": "no-charge", "UNKNOWN": "no-charge", "declaredFailures": "invalid/oversize/evidence-unavailable/storage/delivery failures are no-charge", "assertionMismatch": "determinate evidence state within COMPLETE, not a legal conclusion", "baselineNotModeled": "determinate evidence state within COMPLETE, not a legal conclusion", "rule": "COMPLETE_ONLY_IF_VALIDATED" }, "x-privacy": { "publicSourceIdsOnly": true, "arbitraryUrlsAccepted": false, "callerSourceTextAccepted": false, "taxpayerDataAccepted": false, "namesTinsAccepted": false, "accountDataAccepted": false, "documentsAccepted": false, "secretsAccepted": false, "executableAssertionsAccepted": false }, "x-claims": { "textChangeIsLegalRuleChange": false, "comprehensiveLegalChangeHistory": false, "taxAdvice": false, "legalAdvice": false, "filingDetermination": false, "personalizedApplicability": false, "complianceCertification": false }, "x-durability": { "persistentOrderState": true, "sameSignedAuthorizationReplayReturnsSameOrder": true, "sameResponseBodyReplay": true, "secondPaymentResponseOnReplay": false, "reexecuteOnReplay": false, "automaticResettleOnReplay": false, "changedRequestUnderUsedAuthorization": "rejected", "uncertainSettlement": "read-only recovery; never blindly resubmitted" }, "x-limits": { "inputBytes": 262144, "outputBytes": 2097152, "sourcePairs": 20, "topics": 100, "callerAssertions": 100 }, "x-source-policy": { "acceptedCuratedPublicIrsEvidence": true, "runtimeEvidenceExpiryEnforced": true, "wholePageByteChangeIsSemanticEquivalence": false, "snapshotReplayRenewsFreshness": false, "acceptedTaxYears": { "from": 2025, "to": 2026 } }, "x-example-provenance": "Input/output are illustrative shapes, not a current live observation or a guaranteed verdict. Output examples may describe independent synthetic fixtures.", "externalDocs": { "url": "https://playbrightgaming.com/agents/tax-year-rule-diff-evidence.md" }, "x-recovery": { "persistentOrderState": true, "sameOriginalRequestRequired": true, "originalIdempotencyKeyRecommended": true, "keyIsBearerCredential": true, "sameSignedAuthorizationReplay": true, "replayReturnsOriginalBody": true, "reexecuteOnReplay": false, "automaticResettleOnReplay": false, "secondPaymentResponseOnReplay": false, "automaticNewAuthorizationRetrySafe": false, "recoveryEndpoint": "https://playbrightgaming.com/agent-services/recover/{order_id}", "acknowledgmentEndpoint": "https://playbrightgaming.com/agent-services/ack/{order_id}", "documentation": "https://playbrightgaming.com/agents/delivery-recovery.md", "resultRetention": { "configuredSeconds": 900, "startsAt": "durable_result_preparation", "localCopyRecommended": true, "uncertainSettlementMayDelayDeletion": true, "freshWindowAfterReconciliation": false }, "retentionGuarantee": null, "settlementUncertainty": "Original identity is reconciled read-only. Retained output may be available while settlement remains uncertain.", "expiredRetainedOutput": { "httpStatus": 410, "error": "retained_output_expired", "appliesTo": [ "purchase_replay", "recover" ], "doesNotCreateNewPayment": true }, "legacyReplay": "Known original orders retain their original result bytes, schema and price. Current advertised terms apply only to new purchases." }, "x-source-freshness": { "earliestRelevantExpiryUtc": "2026-11-04T01:23:47.028609Z", "checkedAtDate": "2026-10-06", "runtimeAutomaticSourceRefresh": false, "notice": "Captured reviewed evidence, not continuous source monitoring. These are snapshot validity bounds, not a guarantee that an authority has not changed. Expired or unusable required evidence yields UNKNOWN/no charge. A later reviewed release may replace these bounds; inspect result evidence." }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Choose a unique cryptographically random value before the signed purchase; retain it privately with the exact original request and authorization. This is a bearer recovery credential, not a public order label. Never reuse for different input.", "schema": { "type": "string", "minLength": 32, "maxLength": 128, "pattern": "^[A-Za-z0-9_-]+$" } }, { "name": "PAYMENT-SIGNATURE", "in": "header", "required": false, "description": "Omit on the initial valid request to receive HTTP 402 and PAYMENT-REQUIRED. For a purchase, send the base64-encoded x402 payment authorization for those exact terms. This is a per-purchase payment authorization, not an account API key. Retain the original authorization and private Idempotency-Key for recovery; do not sign a new payment merely because delivery is uncertain.", "schema": { "type": "string", "contentEncoding": "base64" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "priceAtomic": "20000", "protocols": [ { "x402": {} } ], "network": "eip155:84532", "asset": "USDC", "accountRequired": false, "apiKeyRequired": false, "runtimeAuthority": "HTTP 402 PAYMENT-REQUIRED" } } }, "/agent-services/ledger-1099-reconciliation-evidence": { "post": { "summary": "Ledger-vs-1099 Reconciliation Evidence", "description": "Reconcile bounded 2026 US-federal Form 1099-K box 1a summaries against opaque ledger rows using caller-declared gross/net basis, finite channel/adjustment policy, and explicit signed arithmetic adjustments. COMPLETE, REVIEW, CONFLICT, and UNKNOWN remain evidence states. A reconciliation delta is not underreported income, does not prove a form is incorrect, and does not determine deductibility, tax treatment, fraud, filing, banking, authenticity, or journal entries.", "operationId": "pennybotLedger1099ReconciliationEvidence", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ledger-1099-reconciliation-evidence__input" }, "example": { "tax_year": 2026, "jurisdiction": "US-federal", "ledger_basis": "net_settlement", "ledger": [ { "row_id": "lr_001", "vendor_id": "v_marketplace", "payment_date": "2026-02-10", "amount_cents": 94000, "channel": "third_party_network" } ], "form_summaries": [ { "document_id": "d_1099k_001", "vendor_id": "v_marketplace", "form_type": "1099-K", "box": "1a", "amount_cents": 100000, "correction_status": "original" } ], "mapping_policy": { "policy_id": "pol_1099k_net_to_gross", "version": "1.0", "comparison_mode": "net_to_gross_with_explicit_adjustments", "channels": [ "third_party_network" ], "allowed_adjustment_types": [ "fee", "refund", "credit", "shipping", "discount", "cash_equivalent", "other_explicit" ] }, "adjustments": [ { "adjustment_id": "adj_fee_001", "vendor_id": "v_marketplace", "type": "fee", "amount_cents": 6000, "direction": "add_to_ledger_for_form_compare", "source_ref": "src_processor_fee" } ], "tolerance_cents": 0 } } } }, "responses": { "200": { "description": "Delivered ledger-vs-1099 reconciliation evidence", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ledger-1099-reconciliation-evidence__output" }, "example": { "deductibility_determined": false, "difference_is_underreported_income": false, "difference_proves_form_incorrect": false, "evaluated_at_utc": "2026-10-06T09:27:01.571202+00:00", "evidence_checksum": "4812196f7586a714cf1ccedba9475e40b9e31e2fabf75c0e63f6a0b49e7103d9", "evidence_context": { "accepted_source_hashes": { "irs_1099k_2026.body": "719edd8fba57de3c5d7a3ed7d68b434390f8e0dbf6005fae7f6ba8afd098b02f", "irs_1099k_2026.txt": "f760198efb4dde43090408ebb0dd9eb4a36d1b1f79a7ccc6ce477d0f0a90dbf1", "irs_recordkeeping.body": "f8c050d6d7ba36cca658061ea440595cd3453dee83564e921bba6885aac77d64", "irs_recordkeeping.txt": "40a1ac85dbf2476029f15df1ca5c40385bc302fc2ed84bde0704a4cf3f64a091" }, "irs_context": [ "1099-K box 1a is gross before listed adjustment categories", "recipient guidance says compare gross amount against records", "recordkeeping guidance says business transactions generate supporting documents" ], "market_context_affects_results": false, "review_sha256": "f6188cfce8dfa6f833a88d839ef74fc01a5f46a27cd731111d985a0f3b72fce1", "valid_until_utc": "2026-11-05T09:24:54.684000+00:00" }, "evidence_mode": "snapshot_replay", "evidence_valid_until_utc": "2026-11-05T09:24:54.684000+00:00", "fee_eligibility": { "conflict_no_charge": true, "currency": "USDC", "eligible": true, "price_atomic": "30000", "review_no_charge": true, "rule": "FRESH_COMPLETE_ONLY_IF_VALIDATED", "settlement_claimed": false, "stale_no_charge": true, "unknown_no_charge": true }, "group_results": [ { "active_document_id": "d_1099k_001", "adjustment_effect_cents": 6000, "adjustment_ids": [ "adj_fee_001" ], "adjustment_trace": [ { "adjustment_id": "adj_fee_001", "amount_cents": 6000, "direction": "add_to_ledger_for_form_compare", "signed_effect_cents": 6000, "source_ref": "src_processor_fee", "type": "fee" } ], "delta_cents": 0, "form_amount_cents": 100000, "formula": "reconstructed_form_total = ledger_total + signed_explicit_adjustments", "ledger_row_ids": [ "lr_001" ], "ledger_total_cents": 94000, "reconstructed_form_total_cents": 100000, "status": "MATCH", "tolerance_cents": 0, "vendor_id": "v_marketplace", "warnings": [] } ], "journal_entries_generated": false, "limitations": [ "Initial v1 supports Form 1099-K box 1a only.", "A reconciliation difference is not underreported income and does not prove a Form 1099-K is incorrect.", "Fees, refunds, credits, shipping, discounts, cash equivalents, and other adjustments are caller-supplied arithmetic facts; the service does not determine deductibility or tax treatment.", "No tax or legal advice, filing determination, amended-return recommendation, fraud finding, bank verification, form authenticity, or identity/TIN verification is provided.", "No journal entry or adjusting entry is generated or posted.", "Original, corrected, and superseded form summaries remain distinct; ambiguous correction state fails to CONFLICT instead of silently choosing.", "Market pricing evidence never affects request outcomes.", "Fresh whole-page source bytes may change without rewriting the bounded reconciliation contract; snapshot replay never renews current freshness." ], "overall_status": "COMPLETE", "policy_sha256": "690175b3e0f9dedc4eb0e7bff23fc12cb12c6b534f3973f2c29417fc8fe7df4f", "request_sha256": "112a4c7bfff87555b90ae204735c614dd7548c6416477996dc90dc388b3f3cbd", "scope": "PUBLIC_PRODUCTION_SNAPSHOT", "service": "ledger-1099-reconciliation-evidence", "service_version": "ledger-1099-reconciliation-1.0.0", "source_fresh_for_current_use": true, "supported_scope": { "box": "1a", "form_type": "1099-K", "jurisdiction": "US-federal", "tax_year": 2026 }, "unmatched_adjustment_ids": [], "unmatched_form_document_ids": [], "unmatched_ledger_row_ids": [] } } }, "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } }, "X-PennyBot-Result-SHA256": { "description": "SHA-256 of exact retained JSON response bytes.", "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "PAYMENT-RESPONSE": { "description": "Successful first settlement response when present. Not emitted a second time on replay; absence alone does not prove zero charge.", "schema": { "type": "string" } } } }, "202": { "description": "Original order is still processing; do not create a new payment authorization.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotProcessing" } } } }, "400": { "description": "INVALID_INPUT; no-charge" }, "402": { "description": "x402 Payment Required; runtime terms authoritative" }, "409": { "description": "Original request conflicts or retained result is not ready/available for this order state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRecoveryError" } } } }, "410": { "description": "Original retained result expired. No new work or payment is created. Contains order/settlement headers, not a result-hash header or a second PAYMENT-RESPONSE.", "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRetainedOutputExpired" }, "example": { "order_id": "ord_00000000-0000-4000-8000-000000000000", "error": "retained_output_expired" } } } }, "413": { "description": "LIMIT_EXCEEDED or ARITHMETIC_OVERFLOW; no-charge" }, "503": { "description": "EVIDENCE_UNAVAILABLE; no-charge" } }, "x-x402": { "amount": "0.03", "atomicAmount": "30000", "currency": "USDC", "decimals": 6, "network": "eip155:84532", "scheme": "exact", "status": "live-runtime-authoritative", "resource": "https://playbrightgaming.com/agent-services/ledger-1099-reconciliation-evidence" }, "x-billing": { "COMPLETE": "chargeable only when validated and source-fresh", "REVIEW": "no-charge", "CONFLICT": "no-charge", "UNKNOWN": "no-charge", "staleSnapshotReplay": "no-charge", "declaredFailures": "invalid/oversize/arithmetic/evidence-unavailable/storage/delivery failures are no-charge", "determinateDelta": "may be COMPLETE and chargeable but is not an underreported-income or form-error conclusion", "rule": "FRESH_COMPLETE_ONLY_IF_VALIDATED" }, "x-privacy": { "opaqueIdsOnly": true, "rawTaxFormsAccepted": false, "namesAccepted": false, "tinsAccepted": false, "accountNumbersAccepted": false, "bankFeedsAccepted": false, "credentialsAccepted": false, "arbitraryUrlsAccepted": false, "sourceDocumentsAccepted": false, "executablePolicyAccepted": false }, "x-claims": { "differenceIsUnderreportedIncome": false, "differenceProvesFormIncorrect": false, "deductibilityDetermined": false, "taxAdvice": false, "legalAdvice": false, "filingDetermination": false, "bankVerification": false, "formAuthenticity": false, "fraudDetection": false, "journalEntriesGenerated": false }, "x-durability": { "persistentOrderState": true, "sameSignedAuthorizationReplayReturnsSameOrder": true, "sameResponseBodyReplay": true, "secondPaymentResponseOnReplay": false, "reexecuteOnReplay": false, "automaticResettleOnReplay": false, "changedRequestUnderUsedAuthorization": "rejected", "uncertainSettlement": "read-only recovery; never blindly resubmitted" }, "x-limits": { "inputBytes": 262144, "outputBytes": 4194304, "ledgerRows": 10000, "formSummaries": 1000, "adjustments": 1000 }, "x-source-policy": { "taxYear": 2026, "jurisdiction": "US-federal", "formType": "1099-K", "box": "1a", "runtimeEvidenceExpiryEnforced": true, "snapshotReplayRenewsFreshness": false, "marketContextAffectsResults": false }, "x-example-provenance": "Input/output are illustrative shapes, not a current live observation or a guaranteed verdict. Output examples may describe independent synthetic fixtures.", "externalDocs": { "url": "https://playbrightgaming.com/agents/ledger-1099-reconciliation-evidence.md" }, "x-recovery": { "persistentOrderState": true, "sameOriginalRequestRequired": true, "originalIdempotencyKeyRecommended": true, "keyIsBearerCredential": true, "sameSignedAuthorizationReplay": true, "replayReturnsOriginalBody": true, "reexecuteOnReplay": false, "automaticResettleOnReplay": false, "secondPaymentResponseOnReplay": false, "automaticNewAuthorizationRetrySafe": false, "recoveryEndpoint": "https://playbrightgaming.com/agent-services/recover/{order_id}", "acknowledgmentEndpoint": "https://playbrightgaming.com/agent-services/ack/{order_id}", "documentation": "https://playbrightgaming.com/agents/delivery-recovery.md", "resultRetention": { "configuredSeconds": 900, "startsAt": "durable_result_preparation", "localCopyRecommended": true, "uncertainSettlementMayDelayDeletion": true, "freshWindowAfterReconciliation": false }, "retentionGuarantee": null, "settlementUncertainty": "Original identity is reconciled read-only. Retained output may be available while settlement remains uncertain.", "expiredRetainedOutput": { "httpStatus": 410, "error": "retained_output_expired", "appliesTo": [ "purchase_replay", "recover" ], "doesNotCreateNewPayment": true }, "legacyReplay": "Known original orders retain their original result bytes, schema and price. Current advertised terms apply only to new purchases." }, "x-source-freshness": { "earliestRelevantExpiryUtc": "2026-11-05T09:24:54.684Z", "basis": "review_validity_window", "checkedAtDate": "2026-10-06", "runtimeAutomaticSourceRefresh": false, "notice": "Captured reviewed evidence, not continuous source monitoring. These are snapshot validity bounds, not a guarantee that an authority has not changed. Expired or unusable required evidence yields UNKNOWN/no charge. A later reviewed release may replace these bounds; inspect result evidence." }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Choose a unique cryptographically random value before the signed purchase; retain it privately with the exact original request and authorization. This is a bearer recovery credential, not a public order label. Never reuse for different input.", "schema": { "type": "string", "minLength": 32, "maxLength": 128, "pattern": "^[A-Za-z0-9_-]+$" } }, { "name": "PAYMENT-SIGNATURE", "in": "header", "required": false, "description": "Omit on the initial valid request to receive HTTP 402 and PAYMENT-REQUIRED. For a purchase, send the base64-encoded x402 payment authorization for those exact terms. This is a per-purchase payment authorization, not an account API key. Retain the original authorization and private Idempotency-Key for recovery; do not sign a new payment merely because delivery is uncertain.", "schema": { "type": "string", "contentEncoding": "base64" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "priceAtomic": "30000", "protocols": [ { "x402": {} } ], "network": "eip155:84532", "asset": "USDC", "accountRequired": false, "apiKeyRequired": false, "runtimeAuthority": "HTTP 402 PAYMENT-REQUIRED" } } }, "/agent-services/agent-release-security-audit": { "post": { "summary": "Agent/MCP Release Security Audit", "description": "Audit a bounded submitted-text release bundle using 16 deterministic release-risk rules across JavaScript/Python dependencies, GitHub Actions, MCP/agent permissions, Docker, OpenAPI, secret-bearing filenames, and public discovery configuration. Results are evidence-backed PASS, WARN, FAIL, or INCONCLUSIVE reports, with INVALID_INPUT and UNSUPPORTED_INPUT handled as no-charge outcomes. This service does not fetch repositories or URLs and does not provide penetration testing, malware clearance, exploit-absence proof, security certification, live advisory intelligence, runtime behavior proof, or signed attestation.", "operationId": "pennybotAgentReleaseSecurityAudit", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agent-release-security-audit__input" }, "example": { "files": [ { "path": "package.json", "kind": "text_utf8", "content": "{\"name\":\"sample-agent\",\"private\":true,\"dependencies\":{}}" } ] } } } }, "responses": { "200": { "description": "Delivered deterministic release-security audit output. Completed PASS/WARN/FAIL/INCONCLUSIVE may be chargeable; INVALID_INPUT/UNSUPPORTED_INPUT are no-charge. New purchases use the current 4000-atomic output schema; authenticated exact replay of an existing former-price order retains its original 100000-atomic output schema and bytes.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/agent-release-security-audit__output" }, { "$ref": "#/components/schemas/agent-release-security-audit__legacy_100000_output" } ] }, "example": { "fee_eligibility": { "currency": "USDC", "eligible": true, "failure_no_charge": true, "invalid_no_charge": true, "price_atomic": "4000", "rule": "COMPLETED_IN_SCOPE_ONLY", "settlement_claimed": false, "unsupported_no_charge": true }, "findings": [ { "evidence_excerpt": "package.json without supported lockfile", "file_sha256": "1aa05ee0958cf2092b5360c8730ca59faff0ba1a4f75273d0b22e5b0815a4820", "line": 1, "message": "package.json is present but no supported JavaScript lockfile is included in the submitted bundle.", "path": "package.json", "remediation": "Commit package-lock.json, pnpm-lock.yaml, or yarn.lock and verify it in CI.", "rule_id": "R006", "severity": "LOW", "surface": "javascript" } ], "findings_truncated": false, "reason": null, "scope": "PUBLIC_PRODUCTION_SNAPSHOT", "status": "WARN" } } }, "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } }, "X-PennyBot-Result-SHA256": { "description": "SHA-256 of exact retained JSON response bytes.", "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "PAYMENT-RESPONSE": { "description": "Successful first settlement response when present. Not emitted a second time on replay; absence alone does not prove zero charge.", "schema": { "type": "string" } } } }, "202": { "description": "Original order is still processing; do not create a new payment authorization.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotProcessing" } } } }, "400": { "description": "Transport INVALID_INPUT; no-charge" }, "402": { "description": "x402 Payment Required; runtime terms authoritative" }, "409": { "description": "Original request conflicts or retained result is not ready/available for this order state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRecoveryError" } } } }, "410": { "description": "Original retained result expired. No new work or payment is created. Contains order/settlement headers, not a result-hash header or a second PAYMENT-RESPONSE.", "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRetainedOutputExpired" }, "example": { "order_id": "ord_00000000-0000-4000-8000-000000000000", "error": "retained_output_expired" } } } }, "413": { "description": "LIMIT_EXCEEDED; no-charge" }, "500": { "description": "INTERNAL_ERROR; no-charge" }, "503": { "description": "EVIDENCE_UNAVAILABLE; no-charge" }, "504": { "description": "TIMEOUT; no-charge" } }, "x-x402": { "amount": "0.004", "atomicAmount": "4000", "currency": "USDC", "decimals": 6, "network": "eip155:84532", "scheme": "exact", "status": "live-runtime-authoritative", "resource": "https://playbrightgaming.com/agent-services/agent-release-security-audit" }, "x-billing": { "PASS": "chargeable when completed in-scope and durably retained", "WARN": "chargeable when completed in-scope and durably retained", "FAIL": "chargeable when completed in-scope and durably retained", "INCONCLUSIVE": "chargeable when completed in-scope and durably retained", "INVALID_INPUT": "no-charge", "UNSUPPORTED_INPUT": "no-charge", "LIMIT_EXCEEDED": "no-charge", "INTERNAL_ERROR": "no-charge", "TIMEOUT": "no-charge", "transportStorageDeliveryFailures": "no-charge", "rule": "COMPLETED_IN_SCOPE_ONLY" }, "x-privacy": { "submittedTextOnly": true, "externalFetch": false, "repositoryFetch": false, "urlFetch": false, "binaryAnalysis": false }, "x-claims": { "penetrationTesting": false, "exploitAbsenceProof": false, "securityCertification": false, "malwareClearance": false, "runtimeBehaviorProof": false, "dependencyVulnerabilityDatabaseCoverage": false, "promptInjectionImmunity": false, "supplyChainProvenanceAttestation": false, "liveAdvisoryIntelligence": false, "signedAttestation": false }, "x-durability": { "persistentOrderState": true, "sameSignedAuthorizationReplayReturnsSameOrder": true, "sameResponseBodyReplay": true, "secondPaymentResponseOnReplay": false, "reexecuteOnReplay": false, "automaticResettleOnReplay": false, "changedRequestUnderUsedAuthorization": "rejected", "uncertainSettlement": "read-only recovery; never blindly resubmitted" }, "x-limits": { "inputBytes": 2300000, "outputBytes": 524288, "files": 512, "fileUtf8Bytes": 262144, "totalUtf8Bytes": 2097152, "findings": 200 }, "x-audit-scope": { "rules": 16, "frozenFixtures": 18, "submittedTextOnly": true, "externalFetch": false, "deterministic": true, "findingEvidence": [ "rule id", "surface", "severity", "message", "remediation", "submitted path", "line", "submitted-file SHA-256", "bounded excerpt" ] }, "x-example-provenance": "Input/output are illustrative shapes, not a current live observation or a guaranteed verdict. Output examples may describe independent synthetic fixtures.", "externalDocs": { "url": "https://playbrightgaming.com/agents/agent-release-security-audit.md" }, "x-recovery": { "persistentOrderState": true, "sameOriginalRequestRequired": true, "originalIdempotencyKeyRecommended": true, "keyIsBearerCredential": true, "sameSignedAuthorizationReplay": true, "replayReturnsOriginalBody": true, "reexecuteOnReplay": false, "automaticResettleOnReplay": false, "secondPaymentResponseOnReplay": false, "automaticNewAuthorizationRetrySafe": false, "recoveryEndpoint": "https://playbrightgaming.com/agent-services/recover/{order_id}", "acknowledgmentEndpoint": "https://playbrightgaming.com/agent-services/ack/{order_id}", "documentation": "https://playbrightgaming.com/agents/delivery-recovery.md", "resultRetention": { "configuredSeconds": 900, "startsAt": "durable_result_preparation", "localCopyRecommended": true, "uncertainSettlementMayDelayDeletion": true, "freshWindowAfterReconciliation": false }, "retentionGuarantee": null, "settlementUncertainty": "Original identity is reconciled read-only. Retained output may be available while settlement remains uncertain.", "expiredRetainedOutput": { "httpStatus": 410, "error": "retained_output_expired", "appliesTo": [ "purchase_replay", "recover" ], "doesNotCreateNewPayment": true }, "legacyReplay": "Known original orders retain their original result bytes, schema and price. Current advertised terms apply only to new purchases." }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Choose a unique cryptographically random value before the signed purchase; retain it privately with the exact original request and authorization. This is a bearer recovery credential, not a public order label. Never reuse for different input.", "schema": { "type": "string", "minLength": 32, "maxLength": 128, "pattern": "^[A-Za-z0-9_-]+$" } }, { "name": "PAYMENT-SIGNATURE", "in": "header", "required": false, "description": "Omit on the initial valid request to receive HTTP 402 and PAYMENT-REQUIRED. For a purchase, send the base64-encoded x402 payment authorization for those exact terms. This is a per-purchase payment authorization, not an account API key. Retain the original authorization and private Idempotency-Key for recovery; do not sign a new payment merely because delivery is uncertain.", "schema": { "type": "string", "contentEncoding": "base64" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.004000" }, "priceAtomic": "4000", "protocols": [ { "x402": {} } ], "network": "eip155:84532", "asset": "USDC", "accountRequired": false, "apiKeyRequired": false, "runtimeAuthority": "HTTP 402 PAYMENT-REQUIRED" } } }, "/agent-services/url-assertions": { "post": { "operationId": "pennybotUrlAssertions", "summary": "URL Assertion + Evidence Receipt", "description": "Evaluate caller-defined assertions against one public HTTP(S) response. PASS and target FAIL are chargeable delivered answers. INCONCLUSIVE and declared service failures are no-charge. Runtime HTTP 402 is authoritative for payment terms.", "tags": [ "url-assertions", "url-verification", "release-check", "web-evidence" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005000" }, "priceAtomic": "5000", "protocols": [ { "x402": {} } ], "network": "eip155:84532", "asset": "USDC", "accountRequired": false, "apiKeyRequired": false, "runtimeAuthority": "HTTP 402 PAYMENT-REQUIRED" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/url-assertions__input" }, "example": { "url": "https://playbrightgaming.com/agents/pennybot-test-vector.txt", "expectedStatus": 200 } } } }, "responses": { "200": { "description": "Delivered URL assertion evidence receipt. verdict is PASS, FAIL, or INCONCLUSIVE.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/url-assertions__output" }, "example": { "assertions": [ { "code": "OBSERVATION_COMPLETE", "id": "observation", "kind": "observation", "verdict": "PASS" }, { "code": "STATUS_MATCH", "id": "status", "kind": "status", "verdict": "PASS" } ], "byteLength": 29, "contentEncoding": "identity", "contentType": "text/plain", "decodedByteLength": 29, "evidenceId": "sha256:dcb42c756e4e496ff727aa1ad58356f879c6ecd914a668b8b3b524dcc91e34b0", "finalUrl": "https://playbrightgaming.com/agents/pennybot-test-vector.txt", "hashSemantics": "sha256 of complete HTTP entity bytes before content decoding; excludes transfer framing", "observedAt": "2026-10-06T16:01:54.401Z", "observedStatus": 200, "rawBodySha256": "d053565c5bbce20a8970214dd6b46b226e11efd911366267afd8e80b759cf987", "receipt": { "format": "pennybot-url-assertions-receipt-v1", "payload": { "assertions": [ { "code": "OBSERVATION_COMPLETE", "id": "observation", "kind": "observation", "verdict": "PASS" }, { "code": "STATUS_MATCH", "id": "status", "kind": "status", "verdict": "PASS" } ], "byteLength": 29, "contentEncoding": "identity", "contentType": "text/plain", "decodedByteLength": 29, "finalUrl": "https://playbrightgaming.com/agents/pennybot-test-vector.txt", "hashSemantics": "sha256 of complete HTTP entity bytes before content decoding; excludes transfer framing", "observedAt": "2026-10-06T16:01:54.401Z", "observedStatus": 200, "rawBodySha256": "d053565c5bbce20a8970214dd6b46b226e11efd911366267afd8e80b759cf987", "redirects": [], "requestSha256": "55be11bbd637170a41ec89534b2293482135fc19653c75f27430b0859199c3e3", "requestedUrl": "https://playbrightgaming.com/agents/pennybot-test-vector.txt", "ruleSetVersion": "url-assertions/1.0.0", "semanticTruthClaim": false, "truncated": false, "unsupported": false, "unsupportedReasons": [], "verdict": "PASS" }, "serialization": "sorted-key-json-v1", "signature": null }, "redirects": [], "requestSha256": "55be11bbd637170a41ec89534b2293482135fc19653c75f27430b0859199c3e3", "requestedUrl": "https://playbrightgaming.com/agents/pennybot-test-vector.txt", "ruleSetVersion": "url-assertions/1.0.0", "semanticTruthClaim": false, "truncated": false, "unsupported": false, "unsupportedReasons": [], "verdict": "PASS" } } }, "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } }, "X-PennyBot-Result-SHA256": { "description": "SHA-256 of exact retained JSON response bytes.", "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "PAYMENT-RESPONSE": { "description": "Successful first settlement response when present. Not emitted a second time on replay; absence alone does not prove zero charge.", "schema": { "type": "string" } } } }, "202": { "description": "Original order is still processing; do not create a new payment authorization.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotProcessing" } } } }, "400": { "description": "Invalid assertion request." }, "402": { "description": "x402 Payment Required with authoritative live payment terms and Bazaar discovery metadata." }, "409": { "description": "Original request conflicts or retained result is not ready/available for this order state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRecoveryError" } } } }, "410": { "description": "Original retained result expired. No new work or payment is created. Contains order/settlement headers, not a result-hash header or a second PAYMENT-RESPONSE.", "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRetainedOutputExpired" }, "example": { "order_id": "ord_00000000-0000-4000-8000-000000000000", "error": "retained_output_expired" } } } }, "413": { "description": "Input, target, or output limit exceeded." }, "422": { "description": "Blocked/non-public target." }, "429": { "description": "Service busy." }, "502": { "description": "Upstream unavailable." }, "503": { "description": "Durable storage, recovery, evidence, or service temporarily unavailable. Payment state must be checked separately after a signed attempt." }, "504": { "description": "Deadline exceeded." } }, "x-billing": { "PASS": "chargeable", "FAIL": "chargeable", "INCONCLUSIVE": "no-charge", "declaredServiceFailure": "no-charge" }, "x-durability": { "persistentOrderState": true, "sameSignedAuthorizationReplayReturnsSameOrder": true, "automaticResettleOnReplay": false }, "x-testnet-endpoint": "https://playbrightgaming.com/agent-services/url-assertions", "x-example-provenance": "Input/output are illustrative shapes, not a current live observation or a guaranteed verdict. Output examples may describe independent synthetic fixtures.", "externalDocs": { "url": "https://playbrightgaming.com/agents/url-assertions.md" }, "x-recovery": { "persistentOrderState": true, "sameOriginalRequestRequired": true, "originalIdempotencyKeyRecommended": true, "keyIsBearerCredential": true, "sameSignedAuthorizationReplay": true, "replayReturnsOriginalBody": true, "reexecuteOnReplay": false, "automaticResettleOnReplay": false, "secondPaymentResponseOnReplay": false, "automaticNewAuthorizationRetrySafe": false, "recoveryEndpoint": "https://playbrightgaming.com/agent-services/recover/{order_id}", "acknowledgmentEndpoint": "https://playbrightgaming.com/agent-services/ack/{order_id}", "documentation": "https://playbrightgaming.com/agents/delivery-recovery.md", "resultRetention": { "configuredSeconds": 900, "startsAt": "durable_result_preparation", "localCopyRecommended": true, "uncertainSettlementMayDelayDeletion": true, "freshWindowAfterReconciliation": false }, "retentionGuarantee": null, "settlementUncertainty": "Original identity is reconciled read-only. Retained output may be available while settlement remains uncertain.", "expiredRetainedOutput": { "httpStatus": 410, "error": "retained_output_expired", "appliesTo": [ "purchase_replay", "recover" ], "doesNotCreateNewPayment": true }, "legacyReplay": "Known original orders retain their original result bytes, schema and price. Current advertised terms apply only to new purchases." }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Choose a unique cryptographically random value before the signed purchase; retain it privately with the exact original request and authorization. This is a bearer recovery credential, not a public order label. Never reuse for different input.", "schema": { "type": "string", "minLength": 32, "maxLength": 128, "pattern": "^[A-Za-z0-9_-]+$" } }, { "name": "PAYMENT-SIGNATURE", "in": "header", "required": false, "description": "Omit on the initial valid request to receive HTTP 402 and PAYMENT-REQUIRED. For a purchase, send the base64-encoded x402 payment authorization for those exact terms. This is a per-purchase payment authorization, not an account API key. Retain the original authorization and private Idempotency-Key for recovery; do not sign a new payment merely because delivery is uncertain.", "schema": { "type": "string", "contentEncoding": "base64" } } ] } }, "/agent-services/website-release-audit": { "post": { "description": "Audit one public HTTPS page plus five static discovery documents. Delivered PASS, FAIL, and INCONCLUSIVE reports are chargeable results. Declared service failures are no-charge. No SEO ranking, security certification, semantic truth, browser crawl, authentication, or paid endpoint invocation is claimed. Runtime HTTP 402 is authoritative.", "operationId": "pennybotWebsiteReleaseAudit", "requestBody": { "content": { "application/json": { "example": { "url": "https://playbrightgaming.com/agents/public-url-check.html" }, "schema": { "$ref": "#/components/schemas/website-release-audit__input" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "checks": [ { "code": "MATCH", "detail": "Expected 200; observed 200.", "id": "page.status", "verdict": "PASS" }, { "code": "STATIC_HEAD_PARSED", "detail": "Explicit HTML head parsed under the documented static profile.", "id": "page.parse", "verdict": "PASS" }, { "code": "MATCH", "detail": "Observed \"Public URL Check API - HTTP Status + SHA-256 - $0.0009/check\"; requires nonempty value.", "id": "page.title", "verdict": "PASS" }, { "code": "MATCH", "detail": "Observed \"Independent public URL status and SHA-256 for AI agents. $0.0009 USDC on Base with x402. Exact receipt schema, limits, free hash fixture and buyer quickstart.\"; requires nonempty value.", "id": "page.description", "verdict": "PASS" }, { "code": "MATCH", "detail": "Canonical https://playbrightgaming.com/agents/public-url-check.html; expected https://playbrightgaming.com/agents/public-url-check.html.", "id": "page.canonical", "verdict": "PASS" }, { "code": "MATCH", "detail": "Observed robots/googlebot meta: [\"index,follow,max-snippet:-1\"]; noindex/none must be absent.", "id": "page.robots", "verdict": "PASS" }, { "code": "MISSING_HEADER", "detail": "Selected header absent.", "id": "header.strict-transport-security", "verdict": "FAIL" }, { "code": "MISSING_HEADER", "detail": "Selected header absent.", "id": "header.content-security-policy", "verdict": "FAIL" }, { "code": "MISSING_HEADER", "detail": "Selected header absent.", "id": "header.x-content-type-options", "verdict": "FAIL" }, { "code": "MISSING_HEADER", "detail": "Selected header absent.", "id": "header.referrer-policy", "verdict": "FAIL" }, { "code": "MISSING_HEADER", "detail": "Selected header absent.", "id": "header.x-frame-options", "verdict": "FAIL" }, { "code": "HTTP_200", "detail": "Complete 200 response received.", "id": "robots.reachable", "verdict": "PASS" }, { "code": "PROFILE_PARSED", "detail": "Parsed bounded document profile; no linked resource fetched.", "id": "robots.parse", "verdict": "PASS" }, { "code": "MISSING_DOCUMENT", "detail": "Expected 200; observed 404.", "id": "sitemap.reachable", "verdict": "FAIL" }, { "code": "NON_200_NOT_PARSED", "detail": "No complete supported document to parse.", "id": "sitemap.parse", "verdict": "INCONCLUSIVE" }, { "code": "HTTP_200", "detail": "Complete 200 response received.", "id": "llms.reachable", "verdict": "PASS" }, { "code": "PROFILE_PARSED", "detail": "Parsed bounded document profile; no linked resource fetched.", "id": "llms.parse", "verdict": "PASS" }, { "code": "HTTP_200", "detail": "Complete 200 response received.", "id": "x402.reachable", "verdict": "PASS" }, { "code": "UNSUPPORTED_X402_PROFILE", "detail": "Discovery interpretation stopped at the documented profile boundary.", "id": "x402.parse", "verdict": "INCONCLUSIVE" }, { "code": "RESPONSE_TOO_LARGE", "detail": "Observed no complete response; usable discovery not established.", "id": "openapi.reachable", "verdict": "INCONCLUSIVE" }, { "code": "RESPONSE_TOO_LARGE", "detail": "No complete supported document to parse.", "id": "openapi.parse", "verdict": "INCONCLUSIVE" }, { "code": "DOCUMENTS_UNAVAILABLE", "detail": "Both supported x402 and OpenAPI documents are required.", "id": "parity.x402_openapi_paths", "verdict": "INCONCLUSIVE" }, { "code": "DOCUMENTS_UNAVAILABLE", "detail": "Both supported x402 and OpenAPI documents are required.", "id": "parity.paid_terms", "verdict": "INCONCLUSIVE" }, { "code": "EXPLICIT_LLMS_CONTRACTS_UNAVAILABLE", "detail": "Supported x402 and explicit llms METHOD /path references are required.", "id": "parity.llms_paid_paths", "verdict": "INCONCLUSIVE" }, { "code": "INCOMPLETE_ORIGIN_EVIDENCE", "detail": "Compared supported canonical/base, sitemap, robots Sitemap, OpenAPI server, x402 and llms origin/link references to https://playbrightgaming.com; references are never fetched.", "id": "parity.origin_references", "verdict": "INCONCLUSIVE" } ], "claims": { "paidEndpointDelivery": false, "securityCertification": false, "semanticTruth": false, "seoRanking": false }, "documents": [ { "complete": true, "contentEncoding": "identity", "contentType": "text/html", "decodedBytes": 4654, "finalUrl": "https://playbrightgaming.com/agents/public-url-check.html", "id": "page", "observedAt": "2026-10-06T16:01:54.613Z", "rawBodySha256": "3f51bc270b6f2c9bda8b2741aab5793a706f63bd7c5f3f4d687e7dd4981a0002", "rawBytes": 4654, "reason": null, "redirects": [], "requestedUrl": "https://playbrightgaming.com/agents/public-url-check.html", "status": 200 }, { "complete": true, "contentEncoding": "identity", "contentType": "text/plain", "decodedBytes": 211, "finalUrl": "https://playbrightgaming.com/robots.txt", "id": "robots", "observedAt": "2026-10-06T16:01:54.729Z", "rawBodySha256": "5cda2c41af2e72f170b75175ce1d1d985685dd5021e6460beb9178c83ff6cfe5", "rawBytes": 211, "reason": null, "redirects": [], "requestedUrl": "https://playbrightgaming.com/robots.txt", "status": 200 }, { "complete": true, "contentEncoding": "identity", "contentType": "text/html; charset=iso-8859-1", "decodedBytes": null, "finalUrl": "https://playbrightgaming.com/sitemap.xml", "id": "sitemap", "observedAt": "2026-10-06T16:01:54.768Z", "rawBodySha256": "f4aab84e430f1dd5c4beb1917be63261dd656e74eb162df0107e38a7e466af1c", "rawBytes": 307, "reason": "NON_200_NOT_PARSED", "redirects": [], "requestedUrl": "https://playbrightgaming.com/sitemap.xml", "status": 404 }, { "complete": true, "contentEncoding": "identity", "contentType": "text/plain", "decodedBytes": 21389, "finalUrl": "https://playbrightgaming.com/llms.txt", "id": "llms", "observedAt": "2026-10-06T16:01:54.876Z", "rawBodySha256": "e14844a5aa956525da674ce53e1c3abdaf3209a1f58595f49983be1bb68e5740", "rawBytes": 21389, "reason": null, "redirects": [], "requestedUrl": "https://playbrightgaming.com/llms.txt", "status": 200 }, { "complete": true, "contentEncoding": "identity", "contentType": "application/json", "decodedBytes": 1671, "finalUrl": "https://playbrightgaming.com/.well-known/x402", "id": "x402", "observedAt": "2026-10-06T16:01:54.916Z", "rawBodySha256": "a22f5fd8aa262f22e53754dee29457c91be48a75e0fec50723cd5495d5615935", "rawBytes": 1671, "reason": null, "redirects": [], "requestedUrl": "https://playbrightgaming.com/.well-known/x402", "status": 200 }, { "complete": false, "contentEncoding": null, "contentType": null, "decodedBytes": null, "finalUrl": null, "id": "openapi", "observedAt": "2026-10-06T16:01:54.917Z", "rawBodySha256": null, "rawBytes": null, "reason": "RESPONSE_TOO_LARGE", "redirects": [], "requestedUrl": "https://playbrightgaming.com/openapi.json", "status": null } ], "evidenceId": "sha256:743738201afcd330ffc2b27bb444ad61f884905740342cbd3232d9c8697be93d", "hashSemantics": "SHA-256 of complete HTTP entity bytes before content decoding; excludes transfer framing. Missing/incomplete bodies have no hash.", "observedAt": "2026-10-06T16:01:54.528Z", "page": { "complete": true, "contentEncoding": "identity", "contentType": "text/html", "decodedBytes": 4654, "finalUrl": "https://playbrightgaming.com/agents/public-url-check.html", "id": "page", "observedAt": "2026-10-06T16:01:54.613Z", "rawBodySha256": "3f51bc270b6f2c9bda8b2741aab5793a706f63bd7c5f3f4d687e7dd4981a0002", "rawBytes": 4654, "reason": null, "redirects": [], "requestedUrl": "https://playbrightgaming.com/agents/public-url-check.html", "status": 200 }, "requestSha256": "539b8b21826f2aa7f1427a1ca8a315eb5c2b4cfead0dbde11e4387fd0c5bd708", "ruleSetVersion": "website-release-audit/1.0.0", "signature": null, "usage": { "decodedBytesAdmitted": 27925, "rawBytesAdmitted": 28232, "redirects": 0, "requests": 6 }, "verdict": "FAIL", "warnings": [ "DECLARED_SERVICE_PATHS_ARE_DOCUMENTATION_CHECKS_NO_PAID_OPERATION_IS_INVOKED", "DOCUMENT_OPENAPI_RESPONSE_TOO_LARGE", "DOCUMENT_SITEMAP_NON_200_NOT_PARSED", "DOCUMENT_X402_UNSUPPORTED_X402_PROFILE", "HEADER_CHECKS_ARE_SELECTED_FACTS_NOT_SECURITY_POLICY_VALIDATION", "LLMS_EXPLICIT_METHOD_PATH_AND_ORIGIN_LINK_PROFILE_ONLY", "NO_SEO_RANKING_SECURITY_CERTIFICATION_SEMANTIC_TRUTH_OR_PAID_DELIVERY_CLAIM", "ROBOTS_SYNTAX_ONLY_NOT_CRAWLER_ACCESS_OR_INDEXING_PREDICTION", "STATIC_OBSERVATION_ONLY_NO_BROWSER_JS_OR_CRAWL", "UNSIGNED_EVIDENCE_NOT_AN_AUTHENTICATED_WITNESS" ] }, "schema": { "$ref": "#/components/schemas/website-release-audit__output" } } }, "description": "Successful work matching the output contract", "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } }, "X-PennyBot-Result-SHA256": { "description": "SHA-256 of exact retained JSON response bytes.", "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "PAYMENT-RESPONSE": { "description": "Successful first settlement response when present. Not emitted a second time on replay; absence alone does not prove zero charge.", "schema": { "type": "string" } } } }, "202": { "description": "Original order is still processing; do not create a new payment authorization.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotProcessing" } } } }, "400": { "content": { "application/json": { "schema": { "oneOf": [ { "allOf": [ { "$ref": "#/components/schemas/website-release-audit__failure" }, { "properties": { "error": { "properties": { "code": { "const": "INVALID_INPUT" }, "retryable": { "const": false } }, "type": "object" } }, "type": "object" } ] } ] } } }, "description": "INVALID_INPUT: Invalid or policy-blocked caller input; no delivered report and no settlement.", "x-failure-semantics": [ { "code": "INVALID_INPUT", "description": "Invalid or policy-blocked caller input; no delivered report and no settlement.", "httpStatus": 400, "retryable": false } ] }, "402": { "description": "x402 Payment Required with authoritative live terms and Bazaar discovery metadata." }, "409": { "description": "Original request conflicts or retained result is not ready/available for this order state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRecoveryError" } } } }, "410": { "description": "Original retained result expired. No new work or payment is created. Contains order/settlement headers, not a result-hash header or a second PAYMENT-RESPONSE.", "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRetainedOutputExpired" }, "example": { "order_id": "ord_00000000-0000-4000-8000-000000000000", "error": "retained_output_expired" } } } }, "413": { "content": { "application/json": { "schema": { "oneOf": [ { "allOf": [ { "$ref": "#/components/schemas/website-release-audit__failure" }, { "properties": { "error": { "properties": { "code": { "const": "LIMIT_EXCEEDED" }, "retryable": { "const": false } }, "type": "object" } }, "type": "object" } ] } ] } } }, "description": "LIMIT_EXCEEDED: Oversized input or output; no delivered report and no settlement. Target limits appear inside delivered reports.", "x-failure-semantics": [ { "code": "LIMIT_EXCEEDED", "description": "Oversized input or output; no delivered report and no settlement. Target limits appear inside delivered reports.", "httpStatus": 413, "retryable": false } ] }, "429": { "content": { "application/json": { "schema": { "oneOf": [ { "allOf": [ { "$ref": "#/components/schemas/website-release-audit__failure" }, { "properties": { "error": { "properties": { "code": { "const": "BUSY" }, "retryable": { "const": true } }, "type": "object" } }, "type": "object" } ] } ] } } }, "description": "BUSY: Four audit slots occupied; no queue, report or settlement.", "x-failure-semantics": [ { "code": "BUSY", "description": "Four audit slots occupied; no queue, report or settlement.", "httpStatus": 429, "retryable": true } ] }, "500": { "content": { "application/json": { "schema": { "oneOf": [ { "allOf": [ { "$ref": "#/components/schemas/website-release-audit__failure" }, { "properties": { "error": { "properties": { "code": { "const": "INTERNAL_ERROR" }, "retryable": { "const": false } }, "type": "object" } }, "type": "object" } ] } ] } } }, "description": "INTERNAL_ERROR: Internal implementation, validation or serialization failure; not a delivered target result and no settlement.", "x-failure-semantics": [ { "code": "INTERNAL_ERROR", "description": "Internal implementation, validation or serialization failure; not a delivered target result and no settlement.", "httpStatus": 500, "retryable": false } ] }, "503": { "description": "Durable storage, recovery, evidence, or service temporarily unavailable. Payment state must be checked separately after a signed attempt." } }, "summary": "Website Release / Agent-Readiness Audit", "tags": [ "website-release", "agent-readiness", "release-audit", "web-evidence" ], "x-billing": { "PASS": "chargeable", "FAIL": "chargeable", "INCONCLUSIVE": "chargeable", "declaredServiceFailure": "no-charge" }, "x-cost": { "class": "small", "pricingRationale": "Proposed 0.01 USDC. Six resources, 1 MiB page, 256 KiB per file, 2 MiB aggregate raw and decoded, 10 request attempts, four total followed redirects and 15-second total deadline. Local benchmarks are not hosting-cost measurements." }, "x-definition-sha256": "8e43553f4fa9b9bcf46cc4a9d47fcb6a8ff85fce660c9c56a2929832edf05330", "x-latency": { "basis": "estimate", "expectedP50Ms": 200, "expectedP95Ms": 3000 }, "x-limits": { "maxConcurrency": 4, "maxExternalRequests": 10, "maxInputBytes": 16384, "maxOutputBytes": 65536, "maxUpstreamBytes": 2097152, "timeoutMs": 15000 }, "x-selection": { "chooseWhen": [ "You need one static page and five discovery files checked against explicit release expectations.", "Target FAIL and INCONCLUSIVE are useful delivered audit results, each proposed at 0.01 USDC." ], "doNotChooseWhen": [ "You need SEO ranking, security certification, semantic truth, paid endpoint delivery, a browser, JavaScript, authentication or a crawl.", "You need full OpenAPI validation, all x402 dialects or crawler policy evaluation; unsupported document profiles remain INCONCLUSIVE.", "You need a deployed endpoint: this prototype has no HTTP ingress or real payment integration." ] }, "x-stage": "definition-only", "x-x402": { "amount": "0.01", "atomicAmount": "10000", "currency": "USDC", "decimals": 6, "network": "eip155:845322", "scheme": "exact", "status": "illustrative-unmeasured" }, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "priceAtomic": "10000", "protocols": [ { "x402": {} } ], "network": "eip155:84532", "asset": "USDC", "accountRequired": false, "apiKeyRequired": false, "runtimeAuthority": "HTTP 402 PAYMENT-REQUIRED" }, "x-durability": { "persistentOrderState": true, "sameSignedAuthorizationReplayReturnsSameOrder": true, "automaticResettleOnReplay": false }, "x-testnet-endpoint": "https://playbrightgaming.com/agent-services/website-release-audit", "x-example-provenance": "Input/output are illustrative shapes, not a current live observation or a guaranteed verdict. Output examples may describe independent synthetic fixtures.", "externalDocs": { "url": "https://playbrightgaming.com/agents/website-release-audit.md" }, "x-recovery": { "persistentOrderState": true, "sameOriginalRequestRequired": true, "originalIdempotencyKeyRecommended": true, "keyIsBearerCredential": true, "sameSignedAuthorizationReplay": true, "replayReturnsOriginalBody": true, "reexecuteOnReplay": false, "automaticResettleOnReplay": false, "secondPaymentResponseOnReplay": false, "automaticNewAuthorizationRetrySafe": false, "recoveryEndpoint": "https://playbrightgaming.com/agent-services/recover/{order_id}", "acknowledgmentEndpoint": "https://playbrightgaming.com/agent-services/ack/{order_id}", "documentation": "https://playbrightgaming.com/agents/delivery-recovery.md", "resultRetention": { "configuredSeconds": 900, "startsAt": "durable_result_preparation", "localCopyRecommended": true, "uncertainSettlementMayDelayDeletion": true, "freshWindowAfterReconciliation": false }, "retentionGuarantee": null, "settlementUncertainty": "Original identity is reconciled read-only. Retained output may be available while settlement remains uncertain.", "expiredRetainedOutput": { "httpStatus": 410, "error": "retained_output_expired", "appliesTo": [ "purchase_replay", "recover" ], "doesNotCreateNewPayment": true }, "legacyReplay": "Known original orders retain their original result bytes, schema and price. Current advertised terms apply only to new purchases." }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Choose a unique cryptographically random value before the signed purchase; retain it privately with the exact original request and authorization. This is a bearer recovery credential, not a public order label. Never reuse for different input.", "schema": { "type": "string", "minLength": 32, "maxLength": 128, "pattern": "^[A-Za-z0-9_-]+$" } }, { "name": "PAYMENT-SIGNATURE", "in": "header", "required": false, "description": "Omit on the initial valid request to receive HTTP 402 and PAYMENT-REQUIRED. For a purchase, send the base64-encoded x402 payment authorization for those exact terms. This is a per-purchase payment authorization, not an account API key. Retain the original authorization and private Idempotency-Key for recovery; do not sign a new payment merely because delivery is uncertain.", "schema": { "type": "string", "contentEncoding": "base64" } } ] } }, "/agent-services/recover/{order_id}": { "get": { "operationId": "recoverOriginalPennyBotOrderTestnet", "summary": "Recover original retained output without creating a new payment", "description": "GET with original Idempotency-Key; no body or query. Returns original retained result bytes and settlement/hash headers, or processing/not-ready/error state. This does not execute the purchased work again, blindly resubmit settlement, or emit a second PAYMENT-RESPONSE. Retained output is not proof of successful settlement.", "parameters": [ { "name": "order_id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^ord_[0-9a-f-]+$" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "description": "The same private bearer key used for the original signed purchase.", "schema": { "type": "string", "minLength": 32, "maxLength": 128, "pattern": "^[A-Za-z0-9_-]+$" } } ], "externalDocs": { "url": "https://playbrightgaming.com/agents/delivery-recovery.md" }, "responses": { "200": { "description": "Original product result bytes. Validate against the purchased product schema and inspect X-PennyBot-Settlement separately.", "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } }, "X-PennyBot-Result-SHA256": { "description": "SHA-256 of exact retained JSON response bytes.", "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "PAYMENT-RESPONSE": { "description": "Successful first settlement response when present. Not emitted a second time on replay; absence alone does not prove zero charge.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object" } } } }, "202": { "description": "Still processing.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotProcessing" } } } }, "400": { "description": "Missing/malformed original key, body/query, or invalid request." }, "403": { "description": "Recovery credential does not authorize this order." }, "409": { "description": "Original order has no ready retained output." }, "410": { "description": "Original retained result expired. No new work or payment is created. Contains order/settlement headers, not a result-hash header or a second PAYMENT-RESPONSE.", "headers": { "X-PennyBot-Order": { "description": "Durable order ID; retain with your private recovery key.", "schema": { "type": "string" } }, "X-PennyBot-Settlement": { "description": "Settlement state, separate from delivery. Replay can return original bytes while settlement remains uncertain.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotRetainedOutputExpired" }, "example": { "order_id": "ord_00000000-0000-4000-8000-000000000000", "error": "retained_output_expired" } } } }, "503": { "description": "Original output or reconciliation unavailable; retain credentials and report the incident." } } } }, "/agent-services/ack/{order_id}": { "post": { "operationId": "acknowledgeOriginalPennyBotResultTestnet", "summary": "Acknowledge receipt of an exact retained result hash", "description": "Optional delivery acknowledgment after validating the received bytes. Same original key, X-Result-SHA256 header; no body/query. Does not authorize another charge or assert satisfaction.", "parameters": [ { "name": "order_id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^ord_[0-9a-f-]+$" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "description": "The same private bearer key used for the original signed purchase.", "schema": { "type": "string", "minLength": 32, "maxLength": 128, "pattern": "^[A-Za-z0-9_-]+$" } }, { "name": "X-Result-SHA256", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } ], "responses": { "200": { "description": "Acknowledged exact hash.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PennyBotAcknowledgment" } } } }, "400": { "description": "Invalid key/hash/request." }, "403": { "description": "Wrong order credential." }, "409": { "description": "Result hash or order state conflict." }, "503": { "description": "Acknowledgment unavailable." } } } } }, "components": { "schemas": { "agent-metadata-parity__failure": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "enum": [ "INVALID_INPUT", "LIMIT_EXCEEDED", "INTERNAL_ERROR", "BUSY" ], "type": "string" }, "message": { "type": "string" }, "retryable": { "type": "boolean" } }, "required": [ "code", "message", "retryable" ], "type": "object" }, "ok": { "const": false } }, "required": [ "ok", "error" ], "type": "object" }, "agent-metadata-parity__input": { "additionalProperties": false, "properties": { "documents": { "items": { "additionalProperties": false, "properties": { "kind": { "enum": [ "openapi", "llms", "x402", "catalog", "service-info", "agent-card" ] }, "path": { "maxLength": 256, "minLength": 1, "pattern": "^/[A-Za-z0-9_./~-]*$", "type": "string" } }, "required": [ "kind", "path" ], "type": "object" }, "maxItems": 6, "minItems": 2, "type": "array", "uniqueItems": true, "example": [ { "kind": "openapi", "path": "/openapi.json" }, { "kind": "llms", "path": "/llms.txt" }, { "kind": "x402", "path": "/.well-known/x402" }, { "kind": "catalog", "path": "/agents/services.json" } ] }, "origin": { "maxLength": 2048, "minLength": 1, "pattern": "^https://", "type": "string", "example": "https://playbrightgaming.com" }, "paths": { "items": { "additionalProperties": false, "properties": { "method": { "enum": [ "GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS", "TRACE" ] }, "path": { "maxLength": 256, "minLength": 1, "pattern": "^/[A-Za-z0-9_./~-]*$", "type": "string" } }, "required": [ "method", "path" ], "type": "object" }, "maxItems": 8, "type": "array", "uniqueItems": true } }, "required": [ "origin" ], "type": "object" }, "agent-metadata-parity__output": { "additionalProperties": false, "properties": { "claims": { "additionalProperties": false, "properties": { "paidDelivery": { "const": false }, "semanticTruth": { "const": false }, "toolExecution": { "const": false } }, "required": [ "semanticTruth", "toolExecution", "paidDelivery" ], "type": "object" }, "coverage": { "additionalProperties": false, "properties": { "comparedFields": { "maximum": 100000, "minimum": 0, "type": "integer" }, "comparedRoutePairs": { "maximum": 15360, "minimum": 0, "type": "integer" }, "parsedSources": { "maximum": 6, "minimum": 0, "type": "integer" }, "truncatedFindings": { "type": "boolean" } }, "required": [ "parsedSources", "comparedRoutePairs", "comparedFields", "truncatedFindings" ], "type": "object" }, "documents": { "items": { "additionalProperties": false, "properties": { "complete": { "type": "boolean" }, "contentEncoding": { "anyOf": [ { "maxLength": 16384, "minLength": 0, "type": "string" }, { "type": "null" } ] }, "contentType": { "anyOf": [ { "maxLength": 16384, "minLength": 0, "type": "string" }, { "type": "null" } ] }, "declarations": { "maximum": 32, "minimum": 0, "type": "integer" }, "decodedBodySha256": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] }, "decodedBytes": { "anyOf": [ { "maximum": 262144, "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "finalUrl": { "anyOf": [ { "maxLength": 2048, "minLength": 1, "type": "string" }, { "type": "null" } ] }, "kind": { "enum": [ "openapi", "llms", "x402", "catalog", "service-info", "agent-card" ] }, "observedAt": { "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$", "type": "string" }, "profile": { "anyOf": [ { "maxLength": 64, "minLength": 1, "type": "string" }, { "type": "null" } ] }, "rawBodySha256": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] }, "rawBytes": { "anyOf": [ { "maximum": 262144, "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "reason": { "anyOf": [ { "maxLength": 64, "minLength": 1, "type": "string" }, { "type": "null" } ] }, "redirects": { "items": { "additionalProperties": false, "properties": { "from": { "maxLength": 2048, "minLength": 1, "type": "string" }, "status": { "maximum": 399, "minimum": 300, "type": "integer" }, "to": { "maxLength": 2048, "minLength": 1, "type": "string" } }, "required": [ "from", "to", "status" ], "type": "object" }, "maxItems": 2, "type": "array" }, "requestedUrl": { "maxLength": 2048, "minLength": 1, "type": "string" }, "status": { "anyOf": [ { "maximum": 599, "minimum": 200, "type": "integer" }, { "type": "null" } ] } }, "required": [ "kind", "requestedUrl", "finalUrl", "status", "rawBodySha256", "decodedBodySha256", "rawBytes", "decodedBytes", "contentType", "contentEncoding", "observedAt", "complete", "reason", "profile", "declarations", "redirects" ], "type": "object" }, "maxItems": 6, "minItems": 2, "type": "array" }, "evidenceId": { "pattern": "^sha256:[a-f0-9]{64}$", "type": "string" }, "findings": { "items": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "detail": { "maxLength": 384, "minLength": 1, "type": "string" }, "id": { "maxLength": 64, "minLength": 1, "type": "string" }, "refs": { "items": { "additionalProperties": false, "properties": { "label": { "enum": [ "DECLARED", "OBSERVED" ] }, "location": { "maxLength": 1024, "minLength": 0, "type": "string" }, "sourceUrl": { "maxLength": 2048, "minLength": 1, "type": "string" }, "valueSha256": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] } }, "required": [ "sourceUrl", "location", "label", "valueSha256" ], "type": "object" }, "maxItems": 2, "type": "array" }, "verdict": { "enum": [ "PASS", "FAIL", "INCONCLUSIVE" ] } }, "required": [ "id", "verdict", "code", "detail", "refs" ], "type": "object" }, "maxItems": 160, "minItems": 1, "type": "array" }, "hashSemantics": { "maxLength": 256, "minLength": 1, "type": "string" }, "observedAt": { "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$", "type": "string" }, "origin": { "maxLength": 2048, "minLength": 1, "type": "string" }, "requestSha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "ruleSetVersion": { "const": "agent-metadata-parity/1.0.0" }, "signature": { "type": "null" }, "usage": { "additionalProperties": false, "properties": { "decodedBytes": { "maximum": 1048576, "minimum": 0, "type": "integer" }, "rawBytes": { "maximum": 1048576, "minimum": 0, "type": "integer" }, "redirects": { "maximum": 2, "minimum": 0, "type": "integer" }, "requests": { "maximum": 8, "minimum": 0, "type": "integer" } }, "required": [ "requests", "redirects", "rawBytes", "decodedBytes" ], "type": "object" }, "verdict": { "enum": [ "PASS", "FAIL", "INCONCLUSIVE" ] }, "warnings": { "items": { "maxLength": 256, "minLength": 1, "type": "string" }, "maxItems": 16, "type": "array" } }, "required": [ "ruleSetVersion", "origin", "requestSha256", "observedAt", "verdict", "documents", "findings", "coverage", "usage", "claims", "warnings", "hashSemantics", "signature", "evidenceId" ], "type": "object" }, "x402-readiness-preflight__failure": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "enum": [ "INVALID_INPUT", "LIMIT_EXCEEDED", "INTERNAL_ERROR", "BUSY" ], "type": "string" }, "message": { "type": "string" }, "retryable": { "type": "boolean" } }, "required": [ "code", "message", "retryable" ], "type": "object" }, "ok": { "const": false } }, "required": [ "ok", "error" ], "type": "object" }, "x402-readiness-preflight__input": { "type": "object", "additionalProperties": false, "properties": { "endpoint": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^https://", "example": "https://playbrightgaming.com" }, "method": { "enum": [ "GET", "HEAD", "OPTIONS" ], "example": "GET" }, "path": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": "^/[A-Za-z0-9_./~%-]*$", "example": "/agent-services-mainnet/verify-url" }, "query": { "type": "array", "maxItems": 16, "items": { "type": "object", "additionalProperties": false, "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 48, "pattern": "^[A-Za-z][A-Za-z0-9_-]*$" }, "value": { "type": "string", "minLength": 0, "maxLength": 128, "pattern": "^[A-Za-z0-9 ._~:/?#\\[\\]@!$&'()*+,;=%-]*$", "description": "Literal query data, encoded once with URLSearchParams; do not pre-encode. URL-looking values must pass the public HTTPS, no-credentials and no-fragment runtime guard. Nested URL query values are checked to a maximum depth of 4, without fetching or DNS-resolving them." } }, "required": [ "name", "value" ] }, "example": [ { "name": "url", "value": "https://playbrightgaming.com/agents/pennybot-test-vector.txt" } ] }, "bodyShape": { "type": "object", "additionalProperties": false, "properties": { "type": { "const": "none" } }, "required": [ "type" ], "example": { "type": "none" } }, "expected": { "type": "object", "additionalProperties": false, "properties": { "network": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^eip155:[1-9][0-9]{0,15}$" }, "asset": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "amount": { "type": "string", "minLength": 1, "maxLength": 78, "pattern": "^(0|[1-9][0-9]*)$" }, "displayPrice": { "type": "string", "minLength": 1, "maxLength": 86, "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$" }, "payTo": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [] } }, "required": [ "endpoint", "method", "path", "bodyShape" ] }, "x402-readiness-preflight__output": { "type": "object", "additionalProperties": false, "properties": { "ruleSetVersion": { "const": "x402-readiness-preflight/1.0.1" }, "requestSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "startedAt": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$" }, "observation": { "type": "object", "additionalProperties": false, "properties": { "requestedUrl": { "type": "string", "minLength": 1, "maxLength": 2048 }, "method": { "enum": [ "GET", "HEAD", "OPTIONS" ] }, "bodyShape": { "type": "object", "additionalProperties": false, "properties": { "type": { "const": "none" } }, "required": [ "type" ] }, "finalUrl": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 2048 }, { "type": "null" } ] }, "httpStatus": { "anyOf": [ { "type": "integer", "minimum": 200, "maximum": 599 }, { "type": "null" } ] }, "observedAt": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$" }, "complete": { "type": "boolean" }, "failure": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 64 }, { "type": "null" } ] }, "rawBodySha256": { "anyOf": [ { "type": "string", "pattern": "^[a-f0-9]{64}$" }, { "type": "null" } ] }, "rawBytes": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 1048576 }, { "type": "null" } ] }, "contentEncoding": { "anyOf": [ { "type": "string", "minLength": 0, "maxLength": 16384 }, { "type": "null" } ] }, "paymentRequiredValues": { "type": "array", "maxItems": 128, "items": { "type": "string", "minLength": 0, "maxLength": 16384 } }, "headerSha256": { "anyOf": [ { "type": "string", "pattern": "^[a-f0-9]{64}$" }, { "type": "null" } ] }, "decodedChallengeSha256": { "anyOf": [ { "type": "string", "pattern": "^[a-f0-9]{64}$" }, { "type": "null" } ] }, "redirects": { "type": "array", "maxItems": 3, "items": { "type": "object", "additionalProperties": false, "properties": { "from": { "type": "string", "minLength": 1, "maxLength": 2048 }, "to": { "type": "string", "minLength": 1, "maxLength": 2048 }, "status": { "type": "integer", "minimum": 0, "maximum": 399 } }, "required": [ "from", "to", "status" ] } } }, "required": [ "requestedUrl", "method", "bodyShape", "finalUrl", "httpStatus", "observedAt", "complete", "failure", "rawBodySha256", "rawBytes", "contentEncoding", "paymentRequiredValues", "headerSha256", "decodedChallengeSha256", "redirects" ] }, "verdict": { "enum": [ "PASS", "FAIL", "INCONCLUSIVE" ] }, "findings": { "type": "array", "maxItems": 128, "minItems": 1, "items": { "type": "object", "additionalProperties": false, "properties": { "check": { "type": "string", "minLength": 1, "maxLength": 64 }, "option": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 7 }, { "type": "null" } ] }, "verdict": { "enum": [ "PASS", "FAIL", "INCONCLUSIVE" ] }, "code": { "type": "string", "minLength": 1, "maxLength": 64 }, "pointer": { "type": "string", "minLength": 0, "maxLength": 256 }, "detail": { "type": "string", "minLength": 1, "maxLength": 384 } }, "required": [ "check", "option", "verdict", "code", "pointer", "detail" ] } }, "options": { "type": "array", "maxItems": 8, "items": { "type": "object", "additionalProperties": false, "properties": { "index": { "type": "integer", "minimum": 0, "maximum": 7 }, "verdict": { "enum": [ "PASS", "FAIL", "INCONCLUSIVE" ] }, "scheme": { "anyOf": [ { "type": "string", "minLength": 0, "maxLength": 80 }, { "type": "null" } ] }, "network": { "anyOf": [ { "type": "string", "minLength": 0, "maxLength": 80 }, { "type": "null" } ] }, "asset": { "anyOf": [ { "type": "string", "minLength": 0, "maxLength": 80 }, { "type": "null" } ] }, "amount": { "anyOf": [ { "type": "string", "minLength": 0, "maxLength": 78 }, { "type": "null" } ] }, "displayPrice": { "anyOf": [ { "type": "string", "minLength": 0, "maxLength": 86 }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 12 }, { "type": "null" } ] }, "decimals": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 18 }, { "type": "null" } ] }, "payTo": { "anyOf": [ { "type": "string", "minLength": 0, "maxLength": 80 }, { "type": "null" } ] }, "maxTimeoutSeconds": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "domainName": { "anyOf": [ { "type": "string", "minLength": 0, "maxLength": 128 }, { "type": "null" } ] }, "domainVersion": { "anyOf": [ { "type": "string", "minLength": 0, "maxLength": 64 }, { "type": "null" } ] }, "signability": { "enum": [ "METADATA_PRESENT", "MISSING_OR_INVALID", "UNSUPPORTED" ] } }, "required": [ "index", "verdict", "scheme", "network", "asset", "amount", "displayPrice", "currency", "decimals", "payTo", "maxTimeoutSeconds", "domainName", "domainVersion", "signability" ] } }, "usage": { "type": "object", "additionalProperties": false, "properties": { "requests": { "type": "integer", "minimum": 0, "maximum": 4 }, "redirects": { "type": "integer", "minimum": 0, "maximum": 3 }, "rawBytes": { "type": "integer", "minimum": 0, "maximum": 1048576 } }, "required": [ "requests", "redirects", "rawBytes" ] }, "claims": { "type": "object", "additionalProperties": false, "properties": { "paidSettlement": { "const": false }, "replaySafety": { "const": false }, "deliveryCorrectness": { "const": false }, "merchantHonesty": { "const": false }, "generalSecurity": { "const": false }, "actualSignability": { "const": false } }, "required": [ "paidSettlement", "replaySafety", "deliveryCorrectness", "merchantHonesty", "generalSecurity", "actualSignability" ] }, "limitations": { "type": "array", "maxItems": 10, "items": { "type": "string", "minLength": 1, "maxLength": 384 } }, "signature": { "type": "null" }, "evidenceId": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "required": [ "ruleSetVersion", "requestSha256", "startedAt", "observation", "verdict", "findings", "options", "usage", "claims", "limitations", "signature", "evidenceId" ] }, "pdf-citation-evidence__failure": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "enum": [ "INVALID_INPUT", "LIMIT_EXCEEDED", "INTERNAL_ERROR", "BUSY" ], "type": "string" }, "message": { "type": "string" }, "retryable": { "type": "boolean" } }, "required": [ "code", "message", "retryable" ], "type": "object" }, "ok": { "const": false } }, "required": [ "ok", "error" ], "type": "object" }, "pdf-citation-evidence__input": { "additionalProperties": false, "oneOf": [ { "properties": { "pdfBase64": {} }, "required": [ "pdfBase64" ] }, { "properties": { "url": {} }, "required": [ "url" ] } ], "properties": { "pageRanges": { "items": { "additionalProperties": false, "properties": { "end": { "maximum": 25, "minimum": 1, "type": "integer" }, "start": { "maximum": 25, "minimum": 1, "type": "integer" } }, "required": [ "start", "end" ], "type": "object" }, "maxItems": 25, "type": "array" }, "pdfBase64": { "maxLength": 2796204, "minLength": 4, "pattern": "^[A-Za-z0-9+/]*={0,2}$", "type": "string", "example": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgID4+CmVuZG9iagoyIDAgb2JqCjw8IC9UeXBlIC9QYWdlcyAvQ291bnQgMSAvS2lkcyBbNCAwIFJdID4+CmVuZG9iagozIDAgb2JqCjw8IC9UeXBlIC9Gb250IC9TdWJ0eXBlIC9UeXBlMSAvQmFzZUZvbnQgL0hlbHZldGljYSAvRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZyA+PgplbmRvYmoKNCAwIG9iago8PCAvVHlwZSAvUGFnZSAvUGFyZW50IDIgMCBSIC9NZWRpYUJveCBbMCAwIDYxMiA3OTJdIC9SZXNvdXJjZXMgPDwgL0ZvbnQgPDwgL0YxIDMgMCBSID4+ICA+PiAvQ29udGVudHMgNSAwIFIgPj4KZW5kb2JqCjUgMCBvYmoKPDwgL0xlbmd0aCA1NSA+PgpzdHJlYW0KQlQgL0YxIDEyIFRmIDcyIDcyMCBUZCAoQWxwaGEgYmV0YS4gQWxwaGEgYWdhaW4uKSBUaiBFVAplbmRzdHJlYW0KZW5kb2JqCnhyZWYKMCA2CjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDAxNSAwMDAwMCBuIAowMDAwMDAwMDY1IDAwMDAwIG4gCjAwMDAwMDAxMjIgMDAwMDAgbiAKMDAwMDAwMDIxOSAwMDAwMCBuIAowMDAwMDAwMzQ2IDAwMDAwIG4gCnRyYWlsZXIKPDwgL1NpemUgNiAvUm9vdCAxIDAgUiA+PgpzdGFydHhyZWYKNDUxCiUlRU9GCg==" }, "quotes": { "items": { "maxLength": 512, "minLength": 1, "type": "string" }, "maxItems": 16, "type": "array", "example": [ "Alpha" ] }, "url": { "maxLength": 2048, "minLength": 1, "type": "string" } }, "required": [], "type": "object", "title": "PDF Text Extraction, Page Citations & Quote Matching — input" }, "pdf-citation-evidence__output": { "additionalProperties": false, "properties": { "evidence": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "document": { "anyOf": [ { "additionalProperties": false, "properties": { "bytes": { "maximum": 2097152, "minimum": 0, "type": "integer" }, "metadata": { "additionalProperties": false, "properties": { "Author": { "maxLength": 512, "minLength": 0, "type": "string" }, "CreationDate": { "maxLength": 512, "minLength": 0, "type": "string" }, "Creator": { "maxLength": 512, "minLength": 0, "type": "string" }, "ModDate": { "maxLength": 512, "minLength": 0, "type": "string" }, "Producer": { "maxLength": 512, "minLength": 0, "type": "string" }, "Subject": { "maxLength": 512, "minLength": 0, "type": "string" }, "Title": { "maxLength": 512, "minLength": 0, "type": "string" } }, "required": [], "type": "object" }, "pageCount": { "anyOf": [ { "maximum": 25, "minimum": 1, "type": "integer" }, { "type": "null" } ] }, "sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" } }, "required": [ "sha256", "bytes", "pageCount", "metadata" ], "type": "object" }, { "type": "null" } ] }, "ignoredActiveContent": { "type": "boolean" }, "pages": { "items": { "additionalProperties": false, "properties": { "end": { "maximum": 32000, "minimum": 0, "type": "integer" }, "pageNumber": { "maximum": 25, "minimum": 1, "type": "integer" }, "reference": { "maxLength": 300, "minLength": 1, "type": "string" }, "start": { "const": 0 }, "text": { "maxLength": 32000, "minLength": 0, "type": "string" }, "textSha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "warnings": { "items": { "maxLength": 64, "minLength": 1, "type": "string" }, "maxItems": 8, "type": "array" } }, "required": [ "pageNumber", "text", "textSha256", "start", "end", "reference", "warnings" ], "type": "object" }, "maxItems": 25, "type": "array" }, "parser": { "additionalProperties": false, "properties": { "cpuSeconds": { "const": 4 }, "isolation": { "anyOf": [ { "enum": [ "windows-job-object", "posix-rlimit" ] }, { "type": "null" } ] }, "memoryBytes": { "const": 201326592 }, "name": { "const": "pypdf" }, "version": { "const": "6.1.1" }, "wallMs": { "const": 5500 } }, "required": [ "name", "version", "isolation", "memoryBytes", "cpuSeconds", "wallMs" ], "type": "object" }, "quotes": { "items": { "additionalProperties": false, "properties": { "matches": { "items": { "additionalProperties": false, "properties": { "end": { "maximum": 32000, "minimum": 0, "type": "integer" }, "pageNumber": { "maximum": 25, "minimum": 1, "type": "integer" }, "reference": { "maxLength": 300, "minLength": 1, "type": "string" }, "start": { "maximum": 32000, "minimum": 0, "type": "integer" } }, "required": [ "pageNumber", "start", "end", "reference" ], "type": "object" }, "maxItems": 256, "type": "array" }, "quote": { "maxLength": 512, "minLength": 1, "type": "string" }, "verdict": { "enum": [ "PASS", "FAIL", "INCONCLUSIVE" ] } }, "required": [ "quote", "verdict", "matches" ], "type": "object" }, "maxItems": 16, "type": "array" }, "requestSha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "ruleSet": { "const": "pdf-citation-evidence/1.0.0+pypdf-6.1.1" }, "selectedPages": { "items": { "maximum": 25, "minimum": 1, "type": "integer" }, "maxItems": 25, "type": "array" }, "semantics": { "additionalProperties": false, "properties": { "documentSha256": { "const": "sha256 of complete PDF bytes after HTTP Content-Encoding decoding; uploads use exact supplied bytes" }, "evidenceId": { "const": "sha256 of sorted-key-json-v1 evidence object; timestamps excluded; parser version and request hash included" }, "extraction": { "const": "pypdf plain content-stream order; hidden text may be included; no OCR, layout, visual, truth or legal attestation" }, "httpSha256": { "const": "sha256 of complete final HTTP entity before Content-Encoding decoding; excludes headers and HTTP transfer framing" }, "offsets": { "const": "zero-based Unicode code points in returned page text; half-open [start,end); no Unicode or whitespace normalization" }, "pageSha256": { "const": "sha256 of UTF-8 extracted page text after CRLF/CR to LF only; not a hash of serialized page objects or appearance" } }, "required": [ "documentSha256", "pageSha256", "offsets", "extraction", "httpSha256", "evidenceId" ], "type": "object" }, "source": { "additionalProperties": false, "properties": { "contentEncoding": { "anyOf": [ { "maxLength": 100, "minLength": 0, "type": "string" }, { "type": "null" } ] }, "contentType": { "anyOf": [ { "maxLength": 200, "minLength": 0, "type": "string" }, { "type": "null" } ] }, "finalUrl": { "anyOf": [ { "maxLength": 2048, "minLength": 1, "type": "string" }, { "type": "null" } ] }, "httpStatus": { "anyOf": [ { "maximum": 599, "minimum": 200, "type": "integer" }, { "type": "null" } ] }, "mode": { "enum": [ "upload", "url" ] }, "rawBodySha256": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] }, "rawBytes": { "anyOf": [ { "maximum": 2097152, "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "redirects": { "items": { "additionalProperties": false, "properties": { "from": { "maxLength": 2048, "minLength": 1, "type": "string" }, "status": { "maximum": 308, "minimum": 301, "type": "integer" }, "to": { "maxLength": 2048, "minLength": 1, "type": "string" } }, "required": [ "from", "to", "status" ], "type": "object" }, "maxItems": 3, "type": "array" }, "requestedUrl": { "anyOf": [ { "maxLength": 2048, "minLength": 1, "type": "string" }, { "type": "null" } ] } }, "required": [ "mode", "requestedUrl", "finalUrl", "httpStatus", "rawBodySha256", "rawBytes", "contentEncoding", "contentType", "redirects" ], "type": "object" }, "verdict": { "enum": [ "PASS", "FAIL", "INCONCLUSIVE" ] }, "warnings": { "items": { "maxLength": 64, "minLength": 1, "type": "string" }, "maxItems": 16, "type": "array" } }, "required": [ "ruleSet", "requestSha256", "verdict", "code", "document", "source", "pages", "quotes", "selectedPages", "warnings", "ignoredActiveContent", "semantics", "parser" ], "type": "object" }, "evidenceId": { "pattern": "^sha256:[a-f0-9]{64}$", "type": "string" }, "fetchedAt": { "anyOf": [ { "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$", "type": "string" }, { "type": "null" } ] }, "observedAt": { "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$", "type": "string" }, "receipt": { "additionalProperties": false, "properties": { "payloadSha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "serialization": { "const": "sorted-key-json-v1" }, "signature": { "type": "null" } }, "required": [ "serialization", "payloadSha256", "signature" ], "type": "object" }, "schemaVersion": { "const": "1.0" } }, "required": [ "schemaVersion", "evidence", "evidenceId", "observedAt", "fetchedAt", "receipt" ], "type": "object", "title": "PDF Text Extraction, Page Citations & Quote Matching — output" }, "irs-form-instruction-version-check__input": { "type": "object", "additionalProperties": false, "properties": { "tax_year": { "type": "integer", "minimum": 1900, "maximum": 2200, "example": 2026 }, "jurisdiction": { "const": "US-federal", "example": "US-federal" }, "filing_year": { "type": "integer", "minimum": 1900, "maximum": 2200, "example": 2027 }, "artifact_kind": { "type": "string", "enum": [ "form", "instructions", "schema_metadata" ], "example": "instructions" }, "identifiers": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "identifier": { "type": "string", "enum": [ "1099-NEC", "1099-MISC", "W-2", "W-3", "1099-K", "PUB-1099", "1040-ES", "SSA-EFW2", "IRIS-SOR" ] }, "caller_revision": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[A-Za-z0-9 .()/\\-]{1,80}$", "not": { "pattern": "\\b(?:\\d{3}-\\d{2}-\\d{4}|\\d{2}-\\d{7}|\\d{9})\\b" } }, "caller_sha256": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[0-9a-fA-F]{64}$" } }, "required": [ "identifier" ] }, "minItems": 1, "maxItems": 20, "example": [ { "identifier": "1099-NEC", "caller_revision": "12/2026" }, { "identifier": "W-2" } ] } }, "required": [ "tax_year", "identifiers" ] }, "irs-form-instruction-version-check__output": { "type": "object", "additionalProperties": false, "required": [ "service", "contract_version", "mode", "evaluated_at", "jurisdiction", "results", "fee_eligibility", "boundary", "limitations" ], "properties": { "service": { "const": "irs-form-instruction-version-check" }, "contract_version": { "const": "1.0.0" }, "mode": { "type": "string", "enum": [ "current_snapshot", "snapshot_replay" ] }, "evaluated_at": { "type": "string", "minLength": 1, "maxLength": 50 }, "jurisdiction": { "const": "US-federal" }, "results": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "identifier": { "type": "string", "enum": [ "1099-NEC", "1099-MISC", "W-2", "W-3", "1099-K", "PUB-1099", "1040-ES", "SSA-EFW2", "IRIS-SOR" ] }, "artifact_kind": { "type": "string", "enum": [ "form", "instructions", "schema_metadata" ] }, "tax_year": { "type": "integer", "minimum": 1900, "maximum": 2200 }, "status": { "type": "string", "enum": [ "CURRENT", "STALE", "UNKNOWN", "CONFLICT" ] }, "reason": { "type": "string", "minLength": 1, "maxLength": 256 }, "curated_revision": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 80 }, { "type": "null" } ] }, "applicability": { "anyOf": [ { "type": "object", "additionalProperties": false, "properties": { "tax_years": { "type": "array", "items": { "type": "integer", "minimum": 1900, "maximum": 2200 }, "minItems": 1, "maxItems": 2 }, "filing_years": { "type": "array", "items": { "type": "integer", "minimum": 1900, "maximum": 2200 }, "minItems": 1, "maxItems": 3 }, "scope": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "required": [ "tax_years", "filing_years", "scope" ] }, { "type": "null" } ] }, "observed_at": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 50, "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,7})?(Z|[+-]\\d{2}:\\d{2})$" }, { "type": "null" } ] }, "source_id": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256 }, { "type": "null" } ] }, "authoritative_url": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^https://[^\\s]+$" }, { "type": "null" } ] }, "raw_sha256": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[0-9a-f]{64}$" }, { "type": "null" } ] }, "extracted_sha256": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[0-9a-f]{64}$" }, { "type": "null" } ] }, "valid_until": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 50, "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,7})?(Z|[+-]\\d{2}:\\d{2})$" }, { "type": "null" } ] }, "schema_availability": { "const": "UNKNOWN" }, "document_bytes_verified": { "type": "boolean" }, "caller_comparison": { "type": "object", "additionalProperties": false, "properties": { "revision": { "type": "string", "enum": [ "not_supplied", "not_compared", "matches_reviewed_edition", "reviewed_superseded_edition", "unrecognized_revision" ] }, "bytes": { "type": "string", "enum": [ "not_supplied", "not_compared", "exact_match", "matches_reviewed_older_bytes", "mismatch" ] }, "caller_document_verified": { "const": false }, "semantic_equivalence": { "const": "not_assessed" } }, "required": [ "revision", "bytes", "caller_document_verified", "semantic_equivalence" ] }, "caveats": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 1500 }, "minItems": 1, "maxItems": 12 }, "evidence_refs": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "record_id": { "type": "string", "minLength": 1, "maxLength": 256 }, "source_id": { "type": "string", "minLength": 1, "maxLength": 256 }, "url": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^https://[^\\s]+$" }, "raw_file": { "type": "string", "minLength": 1, "maxLength": 256 }, "text_file": { "type": "string", "minLength": 1, "maxLength": 256 }, "raw_sha256": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[0-9a-f]{64}$" }, "extracted_sha256": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[0-9a-f]{64}$" }, "line_start": { "type": "integer", "minimum": 1 }, "line_end": { "type": "integer", "minimum": 1 }, "page": { "anyOf": [ { "type": "integer", "minimum": 1 }, { "type": "null" } ] }, "excerpt_sha256": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[0-9a-f]{64}$" } }, "required": [ "record_id", "source_id", "url", "raw_file", "text_file", "raw_sha256", "extracted_sha256", "line_start", "line_end", "page", "excerpt_sha256" ] }, "minItems": 0, "maxItems": 64 }, "evidence_issues": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "source_id": { "type": "string", "minLength": 1, "maxLength": 256 }, "code": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "source_id", "code" ] }, "minItems": 0, "maxItems": 20 } }, "required": [ "identifier", "artifact_kind", "tax_year", "status", "reason", "curated_revision", "applicability", "observed_at", "source_id", "authoritative_url", "raw_sha256", "extracted_sha256", "valid_until", "schema_availability", "document_bytes_verified", "caller_comparison", "caveats", "evidence_refs", "evidence_issues" ] }, "minItems": 1, "maxItems": 20 }, "fee_eligibility": { "type": "object", "additionalProperties": false, "required": [ "eligible", "price_atomic", "currency", "rule", "unknown_anywhere_no_charge", "settlement_claimed" ], "properties": { "eligible": { "type": "boolean" }, "price_atomic": { "const": "5000" }, "currency": { "const": "USDC" }, "rule": { "const": "ALL_RESULTS_DETERMINATE_CURRENT_STALE_CONFLICT" }, "unknown_anywhere_no_charge": { "const": true }, "settlement_claimed": { "const": false } } }, "boundary": { "const": "Public document edition evidence only; no tax advice, treatment determination or filing." }, "limitations": { "type": "array", "minItems": 6, "maxItems": 12, "items": { "type": "string", "minLength": 1, "maxLength": 512 } } } }, "irs-form-instruction-version-check__failure": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "object", "additionalProperties": false, "required": [ "code", "message", "retryable" ], "properties": { "code": { "type": "string", "enum": [ "INVALID_INPUT", "UNSUPPORTED_INPUT", "LIMIT_EXCEEDED", "EVIDENCE_UNAVAILABLE", "TIMEOUT" ] }, "message": { "type": "string", "minLength": 1, "maxLength": 512 }, "retryable": { "type": "boolean" } } } } }, "fire-iris-migration-readiness__input": { "type": "object", "additionalProperties": false, "properties": { "tax_year": { "type": "integer", "minimum": 1900, "maximum": 2200, "example": 2026 }, "filing_channel": { "type": "string", "enum": [ "FIRE", "IRIS_PORTAL", "IRIS_A2A", "THIRD_PARTY" ], "example": "IRIS_A2A" }, "form_types": { "type": "array", "items": { "type": "string", "enum": [ "1099-NEC", "1099-MISC", "1099-K", "W-2", "W-3" ] }, "minItems": 1, "maxItems": 5, "uniqueItems": true, "example": [ "1099-NEC" ] }, "volume_by_form": { "type": "object", "additionalProperties": false, "properties": { "1099-NEC": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "1099-MISC": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "1099-K": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "W-2": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "W-3": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [], "example": { "1099-NEC": 50 } }, "tcc_status": { "type": "string", "enum": [ "absent", "pending", "active", "unknown" ], "example": "active" }, "readiness_flags": { "type": "object", "additionalProperties": false, "properties": { "portal_tcc_confirmed": { "type": "string", "enum": [ "yes", "no", "unknown" ] }, "a2a_tcc_confirmed": { "type": "string", "enum": [ "yes", "no", "unknown" ] }, "portal_access_ready": { "type": "string", "enum": [ "yes", "no", "unknown" ] }, "portal_batch_plan_ready": { "type": "string", "enum": [ "yes", "no", "unknown" ] }, "fire_test_required": { "type": "string", "enum": [ "yes", "no", "unknown" ] }, "ir_application_change_required": { "type": "string", "enum": [ "yes", "no", "unknown" ] }, "schema_package_acquired": { "type": "string", "enum": [ "yes", "no", "unknown" ] }, "corrections_required": { "type": "string", "enum": [ "yes", "no", "unknown" ] }, "third_party_iris_support_confirmed": { "type": "string", "enum": [ "yes", "no", "unknown" ] } }, "required": [], "example": { "portal_tcc_confirmed": "yes", "portal_access_ready": "yes", "portal_batch_plan_ready": "yes", "a2a_tcc_confirmed": "yes", "fire_test_required": "no", "ir_application_change_required": "no", "corrections_required": "no", "schema_package_acquired": "yes" } }, "software_vendor_support": { "type": "string", "enum": [ "yes", "no", "unknown" ], "example": "yes" }, "api_client_ready": { "type": "string", "enum": [ "yes", "no", "unknown" ], "example": "yes" }, "ats_status": { "type": "string", "enum": [ "passed", "pending", "unknown" ], "example": "passed" }, "schema_version": { "anyOf": [ { "type": "string", "maxLength": 24, "pattern": "^(?:TY2026-)?v?[0-9]{1,2}\\.[0-9]{1,2}(?:\\.[0-9]{1,2})?$" }, { "type": "null" } ], "example": "TY2026-v1.0" }, "correction_years": { "type": "array", "items": { "type": "integer", "minimum": 1900, "maximum": 2200 }, "minItems": 0, "maxItems": 10, "uniqueItems": true } }, "required": [ "tax_year", "filing_channel", "form_types", "volume_by_form", "tcc_status", "readiness_flags" ], "allOf": [ { "if": { "properties": { "form_types": { "type": "array", "contains": { "const": "1099-NEC" } } } }, "then": { "properties": { "volume_by_form": { "type": "object", "properties": { "1099-NEC": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "1099-NEC" ] } } }, "else": { "properties": { "volume_by_form": { "type": "object", "properties": { "1099-NEC": false } } } } }, { "if": { "properties": { "form_types": { "type": "array", "contains": { "const": "1099-MISC" } } } }, "then": { "properties": { "volume_by_form": { "type": "object", "properties": { "1099-MISC": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "1099-MISC" ] } } }, "else": { "properties": { "volume_by_form": { "type": "object", "properties": { "1099-MISC": false } } } } }, { "if": { "properties": { "form_types": { "type": "array", "contains": { "const": "1099-K" } } } }, "then": { "properties": { "volume_by_form": { "type": "object", "properties": { "1099-K": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "1099-K" ] } } }, "else": { "properties": { "volume_by_form": { "type": "object", "properties": { "1099-K": false } } } } }, { "if": { "properties": { "form_types": { "type": "array", "contains": { "const": "W-2" } } } }, "then": { "properties": { "volume_by_form": { "type": "object", "properties": { "W-2": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "W-2" ] } } }, "else": { "properties": { "volume_by_form": { "type": "object", "properties": { "W-2": false } } } } }, { "if": { "properties": { "form_types": { "type": "array", "contains": { "const": "W-3" } } } }, "then": { "properties": { "volume_by_form": { "type": "object", "properties": { "W-3": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "W-3" ] } } }, "else": { "properties": { "volume_by_form": { "type": "object", "properties": { "W-3": false } } } } } ] }, "fire-iris-migration-readiness__output": { "type": "object", "additionalProperties": false, "properties": { "service_version": { "const": "1.0.0" }, "mode": { "type": "string", "enum": [ "current", "snapshot_replay" ] }, "evaluated_at": { "type": "string", "maxLength": 40, "pattern": "^\\d{4}-\\d{2}-\\d{2}T.*(?:Z|[+-]\\d{2}:\\d{2})$" }, "tax_year": { "type": "integer", "minimum": 1900, "maximum": 2200 }, "filing_channel": { "type": "string", "enum": [ "FIRE", "IRIS_PORTAL", "IRIS_A2A", "THIRD_PARTY" ] }, "overall_status": { "type": "string", "enum": [ "READY", "NOT_READY", "UNKNOWN", "NOT_APPLICABLE" ] }, "readiness_semantics": { "type": "string", "maxLength": 1200 }, "declared": { "type": "object", "additionalProperties": false, "properties": { "tax_year": { "type": "integer", "minimum": 1900, "maximum": 2200 }, "filing_channel": { "type": "string", "enum": [ "FIRE", "IRIS_PORTAL", "IRIS_A2A", "THIRD_PARTY" ] }, "form_types": { "type": "array", "items": { "type": "string", "enum": [ "1099-NEC", "1099-MISC", "1099-K", "W-2", "W-3" ] }, "minItems": 1, "maxItems": 5, "uniqueItems": true }, "volume_by_form": { "type": "object", "additionalProperties": false, "properties": { "1099-NEC": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "1099-MISC": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "1099-K": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "W-2": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "W-3": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [] }, "tcc_status": { "type": "string", "enum": [ "absent", "pending", "active", "unknown" ] }, "readiness_flags": { "type": "object", "additionalProperties": false, "properties": { "portal_tcc_confirmed": { "type": "string", "enum": [ "yes", "no", "unknown" ] }, "a2a_tcc_confirmed": { "type": "string", "enum": [ "yes", "no", "unknown" ] }, "portal_access_ready": { "type": "string", "enum": [ "yes", "no", "unknown" ] }, "portal_batch_plan_ready": { "type": "string", "enum": [ "yes", "no", "unknown" ] }, "fire_test_required": { "type": "string", "enum": [ "yes", "no", "unknown" ] }, "ir_application_change_required": { "type": "string", "enum": [ "yes", "no", "unknown" ] }, "schema_package_acquired": { "type": "string", "enum": [ "yes", "no", "unknown" ] }, "corrections_required": { "type": "string", "enum": [ "yes", "no", "unknown" ] }, "third_party_iris_support_confirmed": { "type": "string", "enum": [ "yes", "no", "unknown" ] } }, "required": [] }, "software_vendor_support": { "type": "string", "enum": [ "yes", "no", "unknown" ] }, "api_client_ready": { "type": "string", "enum": [ "yes", "no", "unknown" ] }, "ats_status": { "type": "string", "enum": [ "passed", "pending", "unknown" ] }, "schema_version": { "anyOf": [ { "type": "string", "maxLength": 24, "pattern": "^(?:TY2026-)?v?[0-9]{1,2}\\.[0-9]{1,2}(?:\\.[0-9]{1,2})?$" }, { "type": "null" } ] }, "correction_years": { "type": "array", "items": { "type": "integer", "minimum": 1900, "maximum": 2200 }, "minItems": 0, "maxItems": 10, "uniqueItems": true } }, "required": [ "tax_year", "filing_channel", "form_types", "volume_by_form", "tcc_status", "readiness_flags" ], "allOf": [ { "if": { "properties": { "form_types": { "type": "array", "contains": { "const": "1099-NEC" } } } }, "then": { "properties": { "volume_by_form": { "type": "object", "properties": { "1099-NEC": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "1099-NEC" ] } } }, "else": { "properties": { "volume_by_form": { "type": "object", "properties": { "1099-NEC": false } } } } }, { "if": { "properties": { "form_types": { "type": "array", "contains": { "const": "1099-MISC" } } } }, "then": { "properties": { "volume_by_form": { "type": "object", "properties": { "1099-MISC": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "1099-MISC" ] } } }, "else": { "properties": { "volume_by_form": { "type": "object", "properties": { "1099-MISC": false } } } } }, { "if": { "properties": { "form_types": { "type": "array", "contains": { "const": "1099-K" } } } }, "then": { "properties": { "volume_by_form": { "type": "object", "properties": { "1099-K": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "1099-K" ] } } }, "else": { "properties": { "volume_by_form": { "type": "object", "properties": { "1099-K": false } } } } }, { "if": { "properties": { "form_types": { "type": "array", "contains": { "const": "W-2" } } } }, "then": { "properties": { "volume_by_form": { "type": "object", "properties": { "W-2": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "W-2" ] } } }, "else": { "properties": { "volume_by_form": { "type": "object", "properties": { "W-2": false } } } } }, { "if": { "properties": { "form_types": { "type": "array", "contains": { "const": "W-3" } } } }, "then": { "properties": { "volume_by_form": { "type": "object", "properties": { "W-3": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "W-3" ] } } }, "else": { "properties": { "volume_by_form": { "type": "object", "properties": { "W-3": false } } } } } ] }, "observed": { "type": "object", "additionalProperties": false, "properties": { "accounts_checked": { "const": false }, "ats_acceptance_observed": { "const": false }, "live_system_availability_observed": { "const": false }, "schema_bytes_available": { "const": false }, "source_evidence": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "ref_id": { "type": "string", "maxLength": 120 }, "source_id": { "type": "string", "maxLength": 80 }, "url": { "type": "string", "maxLength": 1500 }, "raw_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "text_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "headers_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "excerpt_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "line_start": { "type": "integer", "minimum": 1 }, "line_end": { "type": "integer", "minimum": 1 }, "observed_at": { "type": "string", "maxLength": 40, "pattern": "^\\d{4}-\\d{2}-\\d{2}T.*(?:Z|[+-]\\d{2}:\\d{2})$" }, "valid_until": { "type": "string", "maxLength": 40, "pattern": "^\\d{4}-\\d{2}-\\d{2}T.*(?:Z|[+-]\\d{2}:\\d{2})$" }, "kind": { "type": "string", "enum": [ "SYNTHETIC_FIXTURE", "CAPTURED_PUBLIC_SOURCE" ] } }, "required": [ "ref_id", "source_id", "url", "raw_sha256", "text_sha256", "headers_sha256", "excerpt_sha256", "line_start", "line_end", "observed_at", "valid_until", "kind" ] }, "minItems": 0, "maxItems": 40 } }, "required": [ "accounts_checked", "ats_acceptance_observed", "live_system_availability_observed", "schema_bytes_available", "source_evidence" ] }, "checks": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "check_id": { "type": "string", "maxLength": 100 }, "status": { "type": "string", "enum": [ "READY", "NOT_READY", "UNKNOWN", "NOT_APPLICABLE" ] }, "reason": { "type": "string", "maxLength": 1200 }, "applies_to": { "type": "array", "items": { "type": "string", "enum": [ "FIRE", "IRIS_PORTAL", "IRIS_A2A", "THIRD_PARTY" ] }, "minItems": 1, "maxItems": 4 }, "basis": { "type": "string", "enum": [ "DECLARED", "LOCAL_POLICY", "PUBLIC_EVIDENCE", "PUBLIC_EVIDENCE_AND_CLOCK", "DECLARED_AND_PUBLIC_EVIDENCE", "CORPUS_LIMITATION" ] }, "rule_ids": { "type": "array", "items": { "type": "string", "maxLength": 100 }, "minItems": 0, "maxItems": 20 }, "source_refs": { "type": "array", "items": { "type": "string", "maxLength": 120 }, "minItems": 0, "maxItems": 50 }, "detail": { "type": "string", "maxLength": 1200 } }, "required": [ "check_id", "status", "reason", "applies_to", "basis", "rule_ids", "source_refs", "detail" ] }, "minItems": 1, "maxItems": 30 }, "channel_paths": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "channel": { "type": "string", "enum": [ "FIRE", "IRIS_PORTAL", "IRIS_A2A", "THIRD_PARTY" ] }, "status": { "type": "string", "enum": [ "READY", "NOT_READY", "UNKNOWN", "NOT_APPLICABLE" ] }, "check_ids": { "type": "array", "items": { "type": "string", "maxLength": 100 }, "minItems": 0, "maxItems": 30 }, "readiness_basis": { "type": "string", "maxLength": 1200 }, "production_ready": { "const": false } }, "required": [ "channel", "status", "check_ids", "readiness_basis", "production_ready" ] }, "minItems": 4, "maxItems": 4 }, "form_routing": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "form_type": { "type": "string", "enum": [ "1099-NEC", "1099-MISC", "1099-K", "W-2", "W-3" ] }, "declared_count": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "route": { "type": "string", "enum": [ "SSA", "IRIS_CHANNEL_REVIEW", "UNKNOWN" ] }, "status": { "type": "string", "enum": [ "READY", "NOT_READY", "UNKNOWN", "NOT_APPLICABLE" ] }, "planning_channels": { "type": "array", "items": { "type": "string", "enum": [ "IRIS_PORTAL", "IRIS_A2A" ] }, "minItems": 0, "maxItems": 2 }, "reason": { "type": "string", "maxLength": 1200 }, "rule_ids": { "type": "array", "items": { "type": "string", "maxLength": 100 }, "minItems": 0, "maxItems": 20 }, "source_refs": { "type": "array", "items": { "type": "string", "maxLength": 120 }, "minItems": 0, "maxItems": 50 }, "production_route_verified": { "const": false } }, "required": [ "form_type", "declared_count", "route", "status", "planning_channels", "reason", "rule_ids", "source_refs", "production_route_verified" ] }, "minItems": 1, "maxItems": 5 }, "operational_timeline": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "cutoff_id": { "type": "string", "enum": [ "FIRE_TEST", "IR_APPLICATION_CHANGES", "FIRE_FILING" ] }, "published_date": { "type": "string", "enum": [ "2026-11-01", "2026-11-09", "2026-11-19" ] }, "published_time": { "anyOf": [ { "const": "15:00:00-05:00" }, { "type": "null" } ] }, "timezone": { "const": "America/New_York" }, "cutoff_utc": { "anyOf": [ { "const": "2026-11-19T20:00:00+00:00" }, { "type": "null" } ] }, "scope": { "type": "string", "maxLength": 1200 }, "automatic_weekend_rollover": { "const": false }, "phase": { "type": "string", "enum": [ "BEFORE_DAY", "ON_PUBLISHED_DAY_TIME_UNSPECIFIED", "AFTER_DAY", "BEFORE_INSTANT", "AT_OR_AFTER_INSTANT" ] }, "evidence_status": { "type": "string", "enum": [ "READY", "UNKNOWN" ] }, "reason": { "type": "string", "maxLength": 1200 }, "rule_ids": { "type": "array", "items": { "type": "string", "maxLength": 100 }, "minItems": 0, "maxItems": 20 }, "source_refs": { "type": "array", "items": { "type": "string", "maxLength": 120 }, "minItems": 0, "maxItems": 50 }, "snapshot_only": { "type": "boolean" } }, "required": [ "cutoff_id", "published_date", "published_time", "timezone", "cutoff_utc", "scope", "automatic_weekend_rollover", "phase", "evidence_status", "reason", "rule_ids", "source_refs", "snapshot_only" ] }, "minItems": 3, "maxItems": 3 }, "tcc_processing_guidance": { "type": "object", "additionalProperties": false, "properties": { "typical_processing_business_days": { "const": 45 }, "status": { "type": "string", "enum": [ "READY", "UNKNOWN" ] }, "reason": { "type": "string", "maxLength": 1200 }, "is_sla": { "const": false }, "approval_guaranteed": { "const": false }, "guaranteed_approval_date": { "const": null }, "scope": { "type": "string", "maxLength": 1200 }, "rule_ids": { "type": "array", "items": { "type": "string", "maxLength": 100 }, "minItems": 0, "maxItems": 20 }, "source_refs": { "type": "array", "items": { "type": "string", "maxLength": 120 }, "minItems": 0, "maxItems": 50 } }, "required": [ "typical_processing_business_days", "status", "reason", "is_sla", "approval_guaranteed", "guaranteed_approval_date", "scope", "rule_ids", "source_refs" ] }, "evidence_issues": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "topic": { "type": "string", "maxLength": 100 }, "reason": { "type": "string", "maxLength": 1200 }, "rule_ids": { "type": "array", "items": { "type": "string", "maxLength": 100 }, "minItems": 0, "maxItems": 20 } }, "required": [ "topic", "reason", "rule_ids" ] }, "minItems": 0, "maxItems": 20 }, "missing_prerequisites": { "type": "array", "items": { "type": "string", "maxLength": 100 }, "minItems": 0, "maxItems": 30 }, "unknown_items": { "type": "array", "items": { "type": "string", "maxLength": 100 }, "minItems": 0, "maxItems": 30 }, "production_xml_validation": { "const": "UNSUPPORTED" }, "ssa_efw2_validation": { "const": "OUTSIDE_SCOPE" }, "caveats": { "type": "array", "items": { "type": "string", "maxLength": 1200 }, "minItems": 1, "maxItems": 12 }, "scope": { "const": "PUBLIC_PRODUCTION_SNAPSHOT" }, "fee_eligibility": { "type": "object", "additionalProperties": false, "required": [ "eligible", "price_atomic", "currency", "rule", "unknown_overall_no_charge", "settlement_claimed" ], "properties": { "eligible": { "type": "boolean" }, "price_atomic": { "const": "50000" }, "currency": { "const": "USDC" }, "rule": { "const": "OVERALL_DETERMINATE_READY_NOT_READY_NOT_APPLICABLE" }, "unknown_overall_no_charge": { "const": true }, "settlement_claimed": { "const": false } } }, "limitations": { "type": "array", "minItems": 8, "maxItems": 16, "items": { "type": "string", "minLength": 1, "maxLength": 512 } } }, "required": [ "service_version", "mode", "evaluated_at", "tax_year", "filing_channel", "overall_status", "readiness_semantics", "declared", "observed", "checks", "channel_paths", "form_routing", "operational_timeline", "tcc_processing_guidance", "evidence_issues", "missing_prerequisites", "unknown_items", "production_xml_validation", "ssa_efw2_validation", "caveats", "scope", "fee_eligibility", "limitations" ] }, "fire-iris-migration-readiness__failure": { "type": "object", "additionalProperties": false, "required": [ "ok", "chargeable", "code", "http_status" ], "properties": { "ok": { "const": false }, "chargeable": { "const": false }, "code": { "type": "string", "enum": [ "INVALID_INPUT", "LIMIT_EXCEEDED", "EVIDENCE_UNAVAILABLE", "TIMEOUT" ] }, "http_status": { "type": "integer", "enum": [ 400, 413, 503 ] } } }, "redacted-1099-readiness__input": { "type": "object", "additionalProperties": false, "properties": { "tax_year": { "type": "integer", "enum": [ 2025, 2026 ], "example": 2026 }, "jurisdiction": { "const": "US-federal", "example": "US-federal" }, "record_context": { "type": "string", "enum": [ "original", "correction", "unknown" ], "example": "original" }, "vendor_facts": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "vendor_id": { "type": "string", "maxLength": 18, "pattern": "^v_[0-9a-f]{16}$" }, "us_status": { "type": "string", "enum": [ "us", "foreign", "unknown" ] }, "entity_class": { "type": "string", "enum": [ "reviewed_covered_noncorporate", "corporation", "uncertain", "unknown" ] }, "service_class": { "type": "string", "enum": [ "nec_services_reviewed", "misc_rents_reviewed", "misc_royalties_reviewed", "attorney_fees", "attorney_gross_proceeds", "fish_purchases", "fishing_boat", "direct_sales", "substitute_payments", "other_special", "unknown" ] }, "w9_presence": { "type": "string", "enum": [ "present", "missing", "unknown", "conflicting" ] }, "tin_presence": { "type": "string", "enum": [ "present", "missing", "unknown", "conflicting" ] } }, "required": [ "vendor_id", "us_status", "entity_class", "service_class", "w9_presence", "tin_presence" ] }, "minItems": 1, "maxItems": 1000, "uniqueItems": true, "example": [ { "vendor_id": "v_0000000000000001", "us_status": "us", "entity_class": "reviewed_covered_noncorporate", "service_class": "nec_services_reviewed", "w9_presence": "present", "tin_presence": "present" } ] }, "payments": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "row_id": { "type": "string", "maxLength": 18, "pattern": "^r_[0-9a-f]{16}$" }, "vendor_id": { "type": "string", "maxLength": 18, "pattern": "^v_[0-9a-f]{16}$" }, "payment_date": { "type": "string", "maxLength": 10, "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$", "description": "Real Gregorian calendar date; runtime rejects impossible dates." }, "amount_cents": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "currency": { "const": "USD" }, "payment_channel": { "type": "string", "enum": [ "direct", "payment_card", "tpso", "unknown", "mixed", "contradictory" ] }, "withholding_cents": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "row_id", "vendor_id", "payment_date", "amount_cents", "currency", "payment_channel", "withholding_cents" ] }, "minItems": 0, "maxItems": 10000, "uniqueItems": true, "example": [ { "row_id": "r_0000000000000001", "vendor_id": "v_0000000000000001", "payment_date": "2026-06-15", "amount_cents": 200000, "currency": "USD", "payment_channel": "direct", "withholding_cents": 0 } ] }, "reviewed_policy_ids": { "type": "array", "items": { "type": "string", "enum": [ "covered_business_scope_reviewed_v1", "complete_original_annual_rows_reviewed_v1", "federal_backup_withholding_reviewed_v1", "tpso_settlement_rows_reviewed_v1" ] }, "minItems": 0, "maxItems": 4, "uniqueItems": true, "example": [ "covered_business_scope_reviewed_v1", "complete_original_annual_rows_reviewed_v1", "federal_backup_withholding_reviewed_v1", "tpso_settlement_rows_reviewed_v1" ] } }, "required": [ "tax_year", "jurisdiction", "record_context", "vendor_facts", "payments" ] }, "redacted-1099-readiness__output": { "type": "object", "additionalProperties": false, "properties": { "service_version": { "const": "redacted-1099-readiness-1.0.0" }, "tax_year": { "type": "integer", "enum": [ 2025, 2026 ] }, "jurisdiction": { "const": "US-federal" }, "evidence_mode": { "type": "string", "enum": [ "current", "snapshot_replay", "fixed_synthetic_demo" ] }, "assessed_at_utc": { "type": "string", "maxLength": 40, "pattern": "^\\d{4}-\\d{2}-\\d{2}T.*(?:Z|[+-]\\d{2}:\\d{2})$" }, "synthetic_inputs": { "type": "boolean" }, "accepted_rule_version": { "const": "pennybot-tax-intelligence-foundation-20261004" }, "accepted_rules_sha256": { "type": "string", "maxLength": 64, "pattern": "^[0-9a-f]{64}$" }, "source_manifest_sha256": { "type": "string", "maxLength": 64, "pattern": "^[0-9a-f]{64}$" }, "hash_encoding": { "const": "UTF8-sorted-compact-JSON" }, "reviewed_policy_ids": { "type": "array", "items": { "type": "string", "enum": [ "covered_business_scope_reviewed_v1", "complete_original_annual_rows_reviewed_v1", "federal_backup_withholding_reviewed_v1", "tpso_settlement_rows_reviewed_v1" ] }, "minItems": 0, "maxItems": 4, "uniqueItems": true }, "vendors": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "vendor_id": { "type": "string", "maxLength": 18, "pattern": "^v_[0-9a-f]{16}$" }, "status": { "type": "string", "enum": [ "CANDIDATE", "NOT_CANDIDATE", "REVIEW", "UNKNOWN" ] }, "candidate_kind": { "type": "string", "enum": [ "NEC", "MISC_RENTS", "MISC_ROYALTIES", "UNSUPPORTED", "TPSO_RECONCILIATION" ] }, "reasons": { "type": "array", "items": { "type": "string", "maxLength": 300 }, "minItems": 0, "maxItems": 40 }, "missing_facts": { "type": "array", "items": { "type": "string", "maxLength": 300 }, "minItems": 0, "maxItems": 40 }, "ambiguity_flags": { "type": "array", "items": { "type": "string", "maxLength": 300 }, "minItems": 0, "maxItems": 40 }, "review_required": { "type": "boolean" }, "filing_determination": { "const": false }, "included_row_ids": { "type": "array", "items": { "type": "string", "maxLength": 18, "pattern": "^r_[0-9a-f]{16}$" }, "minItems": 0, "maxItems": 10000 }, "excluded_rows": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "row_id": { "type": "string", "maxLength": 18, "pattern": "^r_[0-9a-f]{16}$" }, "reason": { "type": "string", "enum": [ "outside_tax_year", "negative_requires_review", "channel_requires_review", "included_nec_misc", "separate_tpso", "payment_card_excluded" ] } }, "required": [ "row_id", "reason" ] }, "minItems": 0, "maxItems": 10000 }, "tpso_included_row_ids": { "type": "array", "items": { "type": "string", "maxLength": 18, "pattern": "^r_[0-9a-f]{16}$" }, "minItems": 0, "maxItems": 10000 }, "arithmetic_trace": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "row_id": { "type": "string", "maxLength": 18, "pattern": "^r_[0-9a-f]{16}$" }, "payment_date": { "type": "string", "maxLength": 10, "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$", "description": "Real Gregorian calendar date; runtime rejects impossible dates." }, "amount_cents": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "withholding_cents": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "payment_channel": { "type": "string", "enum": [ "direct", "payment_card", "tpso", "unknown", "mixed", "contradictory" ] }, "disposition": { "type": "string", "enum": [ "outside_tax_year", "negative_requires_review", "channel_requires_review", "included_nec_misc", "separate_tpso", "payment_card_excluded" ] }, "nec_misc_running_cents": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "nec_misc_running_withholding_cents": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "tpso_running_cents": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "tpso_running_withholding_cents": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "row_id", "payment_date", "amount_cents", "withholding_cents", "payment_channel", "disposition", "nec_misc_running_cents", "nec_misc_running_withholding_cents", "tpso_running_cents", "tpso_running_withholding_cents" ] }, "minItems": 0, "maxItems": 10000 }, "nec_misc": { "type": "object", "additionalProperties": false, "properties": { "amount_cents": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "withholding_cents": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "threshold_cents": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "amount_predicate": { "type": "string", "enum": [ "MET", "NOT_MET", "NOT_EVALUATED", "UNKNOWN" ] }, "backup_withholding_predicate": { "type": "string", "enum": [ "MET", "NOT_MET", "NOT_EVALUATED", "UNKNOWN" ] } }, "required": [ "amount_cents", "withholding_cents", "threshold_cents", "amount_predicate", "backup_withholding_predicate" ] }, "tpso": { "type": "object", "additionalProperties": false, "properties": { "gross_cents": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "withholding_cents": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "transactions": { "type": "integer", "minimum": 0, "maximum": 10000 }, "predicate": { "type": "string", "enum": [ "MET", "NOT_MET", "NOT_EVALUATED", "UNKNOWN" ] }, "comparison": { "const": "gross_cents > 2000000 AND transactions > 200" }, "payer_filing_obligation_determined": { "const": false } }, "required": [ "gross_cents", "withholding_cents", "transactions", "predicate", "comparison", "payer_filing_obligation_determined" ] }, "rule_ids": { "type": "array", "items": { "type": "string", "maxLength": 100 }, "minItems": 0, "maxItems": 10 }, "source_refs": { "type": "array", "items": { "type": "string", "maxLength": 120 }, "minItems": 0, "maxItems": 50 } }, "required": [ "vendor_id", "status", "candidate_kind", "reasons", "missing_facts", "ambiguity_flags", "review_required", "filing_determination", "included_row_ids", "excluded_rows", "tpso_included_row_ids", "arithmetic_trace", "nec_misc", "tpso", "rule_ids", "source_refs" ] }, "minItems": 1, "maxItems": 1000 }, "counts": { "type": "object", "additionalProperties": false, "properties": { "CANDIDATE": { "type": "integer", "minimum": 0, "maximum": 1000 }, "NOT_CANDIDATE": { "type": "integer", "minimum": 0, "maximum": 1000 }, "REVIEW": { "type": "integer", "minimum": 0, "maximum": 1000 }, "UNKNOWN": { "type": "integer", "minimum": 0, "maximum": 1000 } }, "required": [ "CANDIDATE", "NOT_CANDIDATE", "REVIEW", "UNKNOWN" ] }, "rule_checks": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "topic": { "type": "string", "maxLength": 100 }, "status": { "type": "string", "enum": [ "READY", "UNKNOWN" ] }, "reason": { "type": "string", "maxLength": 300 }, "rule_ids": { "type": "array", "items": { "type": "string", "maxLength": 100 }, "minItems": 0, "maxItems": 10 }, "source_refs": { "type": "array", "items": { "type": "string", "maxLength": 120 }, "minItems": 0, "maxItems": 50 } }, "required": [ "topic", "status", "reason", "rule_ids", "source_refs" ] }, "minItems": 0, "maxItems": 10 }, "source_evidence": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "ref_id": { "type": "string", "maxLength": 120 }, "source_id": { "type": "string", "maxLength": 80 }, "url": { "type": "string", "maxLength": 1500, "pattern": "^https://www\\.irs\\.gov/" }, "source_sha256": { "type": "string", "maxLength": 64, "pattern": "^[0-9a-f]{64}$" }, "text_sha256": { "type": "string", "maxLength": 64, "pattern": "^[0-9a-f]{64}$" }, "headers_sha256": { "type": "string", "maxLength": 64, "pattern": "^[0-9a-f]{64}$" }, "excerpt_sha256": { "type": "string", "maxLength": 64, "pattern": "^[0-9a-f]{64}$" }, "line_start": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "line_end": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "retrieved_utc": { "type": "string", "maxLength": 40, "pattern": "^\\d{4}-\\d{2}-\\d{2}T.*(?:Z|[+-]\\d{2}:\\d{2})$" }, "valid_until_utc": { "type": "string", "maxLength": 40, "pattern": "^\\d{4}-\\d{2}-\\d{2}T.*(?:Z|[+-]\\d{2}:\\d{2})$" } }, "required": [ "ref_id", "source_id", "url", "source_sha256", "text_sha256", "headers_sha256", "excerpt_sha256", "line_start", "line_end", "retrieved_utc", "valid_until_utc" ] }, "minItems": 0, "maxItems": 50 }, "caveats": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "minItems": 1, "maxItems": 10, "const": [ "Reviewer queue only; no legal file/no-file, worker-status, entity-exception, foreign-status or tax-treatment determination.", "NOT_CANDIDATE means only the explicitly modeled predicate was not met on supplied reviewed facts; income below a reporting threshold may still be taxable.", "Declarations are unverified. No W-9, TIN, identity, account, annual completeness or payment processor was checked.", "Card/TPSO rows are excluded from NEC/MISC arithmetic. The TPSO predicate is separate and is not the business payer's filing obligation.", "No state rules, taxpayer documents, filings, corrections, refunds, or unsupported special-category determinations.", "Source freshness is a local evidence policy, not a guarantee of current law. Snapshot replay does not renew evidence." ] }, "scope": { "const": "PUBLIC_PRODUCTION_SNAPSHOT" }, "fee_eligibility": { "type": "object", "additionalProperties": false, "required": [ "eligible", "price_atomic", "currency", "rule", "unknown_batch_no_charge", "settlement_claimed" ], "properties": { "eligible": { "type": "boolean" }, "price_atomic": { "const": "50000" }, "currency": { "const": "USDC" }, "rule": { "const": "ALL_VENDORS_CANDIDATE_NOT_CANDIDATE_REVIEW_AND_RULE_EVIDENCE_READY" }, "unknown_batch_no_charge": { "const": true }, "settlement_claimed": { "const": false } } }, "limitations": { "type": "array", "minItems": 8, "maxItems": 20, "items": { "type": "string", "minLength": 1, "maxLength": 600 } } }, "required": [ "service_version", "tax_year", "jurisdiction", "evidence_mode", "assessed_at_utc", "synthetic_inputs", "accepted_rule_version", "accepted_rules_sha256", "source_manifest_sha256", "hash_encoding", "reviewed_policy_ids", "vendors", "counts", "rule_checks", "source_evidence", "caveats", "scope", "fee_eligibility", "limitations" ] }, "redacted-1099-readiness__failure": { "type": "object", "additionalProperties": false, "required": [ "ok", "chargeable", "code", "http_status" ], "properties": { "ok": { "const": false }, "chargeable": { "const": false }, "code": { "type": "string", "enum": [ "INVALID_INPUT", "LIMIT_EXCEEDED", "EVIDENCE_UNAVAILABLE", "TIMEOUT" ] }, "http_status": { "type": "integer", "enum": [ 400, 413, 503 ] } } }, "year-end-close-readiness__input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "YearEndCloseReadinessRequest", "type": "object", "additionalProperties": false, "required": [ "period", "account_manifest", "exception_counts", "checklist_policy" ], "properties": { "period": { "type": "object", "additionalProperties": false, "required": [ "start", "end", "basis" ], "properties": { "start": { "type": "string", "format": "date" }, "end": { "type": "string", "format": "date" }, "basis": { "type": "string", "enum": [ "cash", "accrual" ] } }, "example": { "start": "2026-12-01", "end": "2026-12-31", "basis": "accrual" } }, "account_manifest": { "type": "array", "minItems": 1, "maxItems": 500, "items": { "type": "object", "additionalProperties": false, "required": [ "account_id", "account_type", "last_reconciled_date", "statement_present" ], "properties": { "account_id": { "type": "string", "pattern": "^a_[0-9a-f]{16}$" }, "account_type": { "type": "string", "enum": [ "cash", "savings", "credit_card", "loan", "receivable", "payable", "inventory", "fixed_asset", "payroll", "tax", "equity", "other" ] }, "last_reconciled_date": { "oneOf": [ { "type": "string", "format": "date" }, { "type": "null" } ] }, "statement_present": { "type": "boolean" }, "declared_balance_cents": { "type": "integer", "minimum": -9000000000000000, "maximum": 9000000000000000 }, "close_status": { "type": "string", "enum": [ "not_started", "in_progress", "review", "complete", "not_applicable", "unknown" ] } } }, "example": [ { "account_id": "a_0000000000000001", "account_type": "cash", "last_reconciled_date": "2026-12-31", "statement_present": true, "declared_balance_cents": 1250000, "close_status": "complete" }, { "account_id": "a_0000000000000002", "account_type": "credit_card", "last_reconciled_date": "2026-12-30", "statement_present": true, "declared_balance_cents": -24500, "close_status": "complete" } ] }, "exception_counts": { "type": "object", "additionalProperties": false, "required": [ "unreconciled_items", "unclassified_transactions", "missing_documents", "duplicate_entries", "open_adjustments", "unmatched_payments", "other_review_items" ], "properties": { "unreconciled_items": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "unclassified_transactions": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "missing_documents": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "duplicate_entries": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "open_adjustments": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "unmatched_payments": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "other_review_items": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "example": { "unreconciled_items": 0, "unclassified_transactions": 0, "missing_documents": 0, "duplicate_entries": 0, "open_adjustments": 0, "unmatched_payments": 0, "other_review_items": 0 } }, "trial_balance_totals": { "type": "object", "additionalProperties": false, "required": [ "debit_cents", "credit_cents" ], "properties": { "debit_cents": { "type": "integer", "minimum": -9000000000000000, "maximum": 9000000000000000 }, "credit_cents": { "type": "integer", "minimum": -9000000000000000, "maximum": 9000000000000000 } } }, "inventory_count_status": { "type": "string", "enum": [ "complete", "in_progress", "review_required", "not_applicable", "unknown" ], "example": "not_applicable" }, "fixed_asset_review_status": { "type": "string", "enum": [ "complete", "in_progress", "review_required", "not_applicable", "unknown" ], "example": "complete" }, "payroll_reconciliation_status": { "type": "string", "enum": [ "complete", "in_progress", "review_required", "not_applicable", "unknown" ], "example": "complete" }, "checklist_policy": { "type": "object", "additionalProperties": false, "required": [ "policy_id", "version", "checks" ], "properties": { "policy_id": { "type": "string", "pattern": "^p_[0-9a-z][0-9a-z_.-]{2,63}$" }, "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+(?:\\.[0-9]+)?$" }, "checks": { "type": "array", "minItems": 1, "maxItems": 1000, "items": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "check_id", "mode", "predicate", "account_types" ], "properties": { "check_id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{1,47}$" }, "mode": { "type": "string", "enum": [ "required", "review" ] }, "dependencies": { "type": "array", "maxItems": 32, "uniqueItems": true, "items": { "type": "string", "pattern": "^[a-z][a-z0-9_]{1,47}$" } }, "predicate": { "const": "STATEMENT_PRESENT" }, "account_types": { "type": "array", "minItems": 1, "maxItems": 12, "uniqueItems": true, "items": { "type": "string", "enum": [ "cash", "savings", "credit_card", "loan", "receivable", "payable", "inventory", "fixed_asset", "payroll", "tax", "equity", "other" ] } } } }, { "type": "object", "additionalProperties": false, "required": [ "check_id", "mode", "predicate", "account_types" ], "properties": { "check_id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{1,47}$" }, "mode": { "type": "string", "enum": [ "required", "review" ] }, "dependencies": { "type": "array", "maxItems": 32, "uniqueItems": true, "items": { "type": "string", "pattern": "^[a-z][a-z0-9_]{1,47}$" } }, "predicate": { "const": "BALANCE_PRESENT" }, "account_types": { "type": "array", "minItems": 1, "maxItems": 12, "uniqueItems": true, "items": { "type": "string", "enum": [ "cash", "savings", "credit_card", "loan", "receivable", "payable", "inventory", "fixed_asset", "payroll", "tax", "equity", "other" ] } } } }, { "type": "object", "additionalProperties": false, "required": [ "check_id", "mode", "predicate", "account_types" ], "properties": { "check_id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{1,47}$" }, "mode": { "type": "string", "enum": [ "required", "review" ] }, "dependencies": { "type": "array", "maxItems": 32, "uniqueItems": true, "items": { "type": "string", "pattern": "^[a-z][a-z0-9_]{1,47}$" } }, "predicate": { "const": "RECONCILED_ON_OR_AFTER" }, "account_types": { "type": "array", "minItems": 1, "maxItems": 12, "uniqueItems": true, "items": { "type": "string", "enum": [ "cash", "savings", "credit_card", "loan", "receivable", "payable", "inventory", "fixed_asset", "payroll", "tax", "equity", "other" ] } }, "cutoff_date": { "type": "string", "format": "date" }, "max_days_before_period_end": { "type": "integer", "minimum": 0, "maximum": 366 } }, "oneOf": [ { "required": [ "cutoff_date" ], "not": { "required": [ "max_days_before_period_end" ] } }, { "required": [ "max_days_before_period_end" ], "not": { "required": [ "cutoff_date" ] } } ] }, { "type": "object", "additionalProperties": false, "required": [ "check_id", "mode", "predicate", "category", "max_count" ], "properties": { "check_id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{1,47}$" }, "mode": { "type": "string", "enum": [ "required", "review" ] }, "dependencies": { "type": "array", "maxItems": 32, "uniqueItems": true, "items": { "type": "string", "pattern": "^[a-z][a-z0-9_]{1,47}$" } }, "predicate": { "const": "EXCEPTION_COUNT_AT_MOST" }, "category": { "type": "string", "enum": [ "unreconciled_items", "unclassified_transactions", "missing_documents", "duplicate_entries", "open_adjustments", "unmatched_payments", "other_review_items" ] }, "max_count": { "type": "integer", "minimum": 0, "maximum": 1000000 } } }, { "type": "object", "additionalProperties": false, "required": [ "check_id", "mode", "predicate", "fact", "allowed_statuses" ], "properties": { "check_id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{1,47}$" }, "mode": { "type": "string", "enum": [ "required", "review" ] }, "dependencies": { "type": "array", "maxItems": 32, "uniqueItems": true, "items": { "type": "string", "pattern": "^[a-z][a-z0-9_]{1,47}$" } }, "predicate": { "const": "STATUS_IN" }, "fact": { "type": "string", "enum": [ "inventory_count_status", "fixed_asset_review_status", "payroll_reconciliation_status" ] }, "allowed_statuses": { "type": "array", "minItems": 1, "maxItems": 5, "uniqueItems": true, "items": { "type": "string", "enum": [ "complete", "in_progress", "review_required", "not_applicable", "unknown" ] } } } }, { "type": "object", "additionalProperties": false, "required": [ "check_id", "mode", "predicate", "account_types", "min_count" ], "properties": { "check_id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{1,47}$" }, "mode": { "type": "string", "enum": [ "required", "review" ] }, "dependencies": { "type": "array", "maxItems": 32, "uniqueItems": true, "items": { "type": "string", "pattern": "^[a-z][a-z0-9_]{1,47}$" } }, "predicate": { "const": "ACCOUNT_COUNT_AT_LEAST" }, "account_types": { "type": "array", "minItems": 1, "maxItems": 12, "uniqueItems": true, "items": { "type": "string", "enum": [ "cash", "savings", "credit_card", "loan", "receivable", "payable", "inventory", "fixed_asset", "payroll", "tax", "equity", "other" ] } }, "min_count": { "type": "integer", "minimum": 0, "maximum": 500 } } } ] } } }, "example": { "policy_id": "p_demo_close", "version": "1.0", "checks": [ { "check_id": "cash_statement", "mode": "required", "predicate": "STATEMENT_PRESENT", "dependencies": [], "account_types": [ "cash" ] }, { "check_id": "cash_reconciled", "mode": "required", "predicate": "RECONCILED_ON_OR_AFTER", "dependencies": [ "cash_statement" ], "account_types": [ "cash" ], "max_days_before_period_end": 0 }, { "check_id": "exceptions_clear", "mode": "required", "predicate": "EXCEPTION_COUNT_AT_MOST", "dependencies": [], "category": "unreconciled_items", "max_count": 0 }, { "check_id": "payroll_status", "mode": "review", "predicate": "STATUS_IN", "dependencies": [], "fact": "payroll_reconciliation_status", "allowed_statuses": [ "complete", "not_applicable" ] } ] } } } }, "year-end-close-readiness__output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "YearEndCloseReadinessOutput", "type": "object", "additionalProperties": false, "required": [ "service", "service_version", "evaluated_at_utc", "evidence_mode", "source_fresh_for_current_use", "period", "policy_id", "policy_version", "policy_sha256", "request_sha256", "overall_status", "counts", "checks", "missing_evidence", "overdue_reconciliations", "unresolved_exception_counts", "blocked_prerequisites", "unmet_check_ids", "source_evidence", "limitations", "scope", "fee_eligibility" ], "properties": { "service": { "const": "year-end-close-readiness" }, "service_version": { "const": "year-end-close-readiness-1.0.0" }, "evaluated_at_utc": { "type": "string" }, "evidence_mode": { "type": "string", "enum": [ "current", "snapshot_replay" ] }, "source_fresh_for_current_use": { "type": "boolean" }, "period": { "type": "object", "additionalProperties": false, "required": [ "start", "end", "basis" ], "properties": { "start": { "type": "string", "format": "date" }, "end": { "type": "string", "format": "date" }, "basis": { "type": "string", "enum": [ "cash", "accrual" ] } } }, "policy_id": { "type": "string" }, "policy_version": { "type": "string" }, "policy_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "request_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "overall_status": { "type": "string", "enum": [ "READY", "NOT_READY", "REVIEW", "UNKNOWN" ] }, "counts": { "type": "object", "additionalProperties": false, "required": [ "PASS", "FAIL", "REVIEW", "UNKNOWN" ], "properties": { "PASS": { "type": "integer", "minimum": 0 }, "FAIL": { "type": "integer", "minimum": 0 }, "REVIEW": { "type": "integer", "minimum": 0 }, "UNKNOWN": { "type": "integer", "minimum": 0 } } }, "checks": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "check_id", "status", "reason", "predicate", "mode", "fact_refs", "account_refs", "prerequisite_refs", "cutoff", "evidence_refs" ], "properties": { "check_id": { "type": "string" }, "status": { "type": "string", "enum": [ "PASS", "FAIL", "REVIEW", "UNKNOWN" ] }, "reason": { "type": "string" }, "predicate": { "type": "string" }, "mode": { "type": "string", "enum": [ "required", "review" ] }, "fact_refs": { "type": "array", "items": { "type": "string" } }, "account_refs": { "type": "array", "items": { "type": "string" } }, "prerequisite_refs": { "type": "array", "items": { "type": "string" } }, "cutoff": { "oneOf": [ { "type": "string" }, { "type": "null" } ] }, "evidence_refs": { "type": "array", "items": { "type": "string" } } } } }, "missing_evidence": { "type": "array", "items": { "type": "object" } }, "overdue_reconciliations": { "type": "array", "items": { "type": "object" } }, "unresolved_exception_counts": { "type": "array", "items": { "type": "object" } }, "blocked_prerequisites": { "type": "array", "items": { "type": "object" } }, "unmet_check_ids": { "type": "array", "items": { "type": "string" } }, "source_evidence": { "type": "array", "items": { "type": "object" } }, "limitations": { "type": "array", "minItems": 8, "items": { "type": "string" } }, "scope": { "const": "PUBLIC_PRODUCTION_SNAPSHOT" }, "fee_eligibility": { "type": "object", "additionalProperties": false, "required": [ "eligible", "price_atomic", "currency", "rule", "unknown_no_charge", "settlement_claimed" ], "properties": { "eligible": { "type": "boolean" }, "price_atomic": { "const": "50000" }, "currency": { "const": "USDC" }, "rule": { "const": "READY_NOT_READY_REVIEW_IF_NO_UNKNOWN_AND_VALIDATED" }, "unknown_no_charge": { "const": true }, "settlement_claimed": { "const": false } } } } }, "year-end-close-readiness__failure": { "type": "object", "additionalProperties": false, "required": [ "ok", "chargeable", "code", "http_status" ], "properties": { "ok": { "const": false }, "chargeable": { "const": false }, "code": { "type": "string", "enum": [ "INVALID_INPUT", "LIMIT_EXCEEDED", "EVIDENCE_UNAVAILABLE", "TIMEOUT" ] }, "http_status": { "type": "integer", "enum": [ 400, 413, 503 ] } } }, "tax-year-rule-diff-evidence__input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "TaxYearRuleDiffRequest", "type": "object", "additionalProperties": false, "required": [ "baseline_source_ids", "current_source_ids", "tax_years", "topics" ], "properties": { "baseline_source_ids": { "type": "array", "minItems": 1, "maxItems": 20, "uniqueItems": true, "items": { "type": "string", "enum": [ "nec_2025", "nec_2026", "w2_2025", "w2_2026" ] }, "example": [ "nec_2025" ] }, "current_source_ids": { "type": "array", "minItems": 1, "maxItems": 20, "uniqueItems": true, "items": { "type": "string", "enum": [ "nec_2025", "nec_2026", "w2_2025", "w2_2026" ] }, "example": [ "nec_2026" ] }, "tax_years": { "type": "object", "additionalProperties": false, "required": [ "from", "to" ], "properties": { "from": { "const": 2025 }, "to": { "const": 2026 } }, "example": { "from": 2025, "to": 2026 } }, "topics": { "type": "array", "minItems": 1, "maxItems": 100, "uniqueItems": true, "items": { "type": "string", "enum": [ "backup_withholding_exception", "misc_covered_threshold", "misc_fields", "nec_covered_threshold", "nec_fields", "w2_fields", "w2_w3_deadline" ] }, "example": [ "backup_withholding_exception", "nec_covered_threshold", "misc_fields" ] }, "caller_assertions": { "type": "array", "maxItems": 100, "items": { "type": "object", "additionalProperties": false, "required": [ "assertion_id", "topic", "field_path", "expected_value" ], "properties": { "assertion_id": { "type": "string", "pattern": "^as_[a-z0-9_]{1,47}$" }, "topic": { "type": "string", "enum": [ "backup_withholding_exception", "misc_covered_threshold", "misc_fields", "nec_covered_threshold", "nec_fields", "w2_fields", "w2_w3_deadline" ] }, "field_path": { "type": "string", "enum": [ "changes.due_date_rule.after.day", "changes.due_date_rule.after.kind", "changes.due_date_rule.after.month", "changes.due_date_rule.after.published_adjusted_date", "changes.due_date_rule.before.day", "changes.due_date_rule.before.kind", "changes.due_date_rule.before.month", "changes.due_date_rule.before.published_adjusted_date", "changes.fact.after.currency", "changes.fact.after.deduction_eligibility_determined", "changes.fact.after.fields.cash_tips_included_in_1a", "changes.fact.after.fields.cash_tips_reported_to_employer", "changes.fact.after.fields.nonemployee_compensation", "changes.fact.after.fields.other", "changes.fact.after.fields.qualified_overtime", "changes.fact.after.fields.qualified_overtime_included_in_1a", "changes.fact.after.fields.treasury_tipped_occupation_codes", "changes.fact.after.minimum_inclusive", "changes.fact.after.nonqualifying_occupation_sentinel", "changes.fact.after.published_due_date", "changes.fact.after.recipient_agency", "changes.fact.after.ttoc_max_codes", "changes.fact.before.currency", "changes.fact.before.dedicated_2026_TP_TT_14b_fields", "changes.fact.before.dedicated_2026_tip_overtime_fields", "changes.fact.before.fields.nonemployee_compensation", "changes.fact.before.minimum_inclusive", "changes.fact.before.published_due_date", "changes.fact.before.recipient_agency", "changes.threshold.after.amount_cents", "changes.threshold.after.basis", "changes.threshold.after.currency", "changes.threshold.after.operator", "changes.threshold.before.amount_cents", "changes.threshold.before.basis", "changes.threshold.before.currency", "changes.threshold.before.operator", "status" ] }, "expected_value": { "type": [ "string", "integer", "boolean", "null" ] } } }, "example": [ { "assertion_id": "as_nec_threshold", "topic": "nec_covered_threshold", "field_path": "changes.threshold.after.amount_cents", "expected_value": 200000 } ] } } }, "tax-year-rule-diff-evidence__output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "TaxYearRuleDiffOutput", "type": "object", "additionalProperties": false, "required": [ "service", "service_version", "evaluated_at_utc", "evidence_mode", "source_fresh_for_current_use", "evidence_valid_until_utc", "corpus_sha256", "source_review_sha256", "request_sha256", "tax_years", "requested_source_pairs", "overall_status", "topic_results", "caller_assertions", "limitations", "byte_change_is_rule_change", "comprehensive_legal_change_history", "scope", "fee_eligibility" ], "properties": { "service": { "const": "tax-year-rule-diff-evidence" }, "service_version": { "const": "tax-year-rule-diff-1.0.0" }, "evaluated_at_utc": { "type": "string" }, "evidence_mode": { "type": "string", "enum": [ "current", "snapshot_replay" ] }, "source_fresh_for_current_use": { "type": "boolean" }, "evidence_valid_until_utc": { "type": "string" }, "corpus_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "source_review_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "request_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "tax_years": { "type": "object", "additionalProperties": false, "required": [ "from", "to" ], "properties": { "from": { "const": 2025 }, "to": { "const": 2026 } } }, "requested_source_pairs": { "type": "array", "items": { "type": "object" } }, "overall_status": { "type": "string", "enum": [ "COMPLETE", "CONFLICT", "UNKNOWN" ] }, "topic_results": { "type": "array", "items": { "type": "object" } }, "caller_assertions": { "type": "array", "items": { "type": "object" } }, "limitations": { "type": "array", "minItems": 8, "items": { "type": "string" } }, "byte_change_is_rule_change": { "const": false }, "comprehensive_legal_change_history": { "const": false }, "scope": { "const": "PUBLIC_PRODUCTION_SNAPSHOT" }, "fee_eligibility": { "type": "object", "additionalProperties": false, "required": [ "eligible", "price_atomic", "currency", "rule", "conflict_no_charge", "unknown_no_charge", "settlement_claimed" ], "properties": { "eligible": { "type": "boolean" }, "price_atomic": { "const": "20000" }, "currency": { "const": "USDC" }, "rule": { "const": "COMPLETE_ONLY_IF_VALIDATED" }, "conflict_no_charge": { "const": true }, "unknown_no_charge": { "const": true }, "settlement_claimed": { "const": false } } } } }, "tax-year-rule-diff-evidence__failure": { "type": "object", "additionalProperties": false, "required": [ "ok", "chargeable", "code", "http_status" ], "properties": { "ok": { "const": false }, "chargeable": { "const": false }, "code": { "type": "string", "enum": [ "INVALID_INPUT", "LIMIT_EXCEEDED", "EVIDENCE_UNAVAILABLE" ] }, "http_status": { "type": "integer", "enum": [ 400, 413, 503 ] } } }, "ledger-1099-reconciliation-evidence__input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Ledger1099ReconciliationRequest", "type": "object", "additionalProperties": false, "required": [ "tax_year", "jurisdiction", "ledger_basis", "ledger", "form_summaries", "mapping_policy" ], "properties": { "tax_year": { "const": 2026, "example": 2026 }, "jurisdiction": { "const": "US-federal", "example": "US-federal" }, "ledger_basis": { "type": "string", "enum": [ "gross_sales", "net_settlement" ], "example": "net_settlement" }, "ledger": { "type": "array", "maxItems": 10000, "items": { "type": "object", "additionalProperties": false, "required": [ "row_id", "vendor_id", "payment_date", "amount_cents", "channel" ], "properties": { "row_id": { "type": "string", "pattern": "^lr_[a-z0-9_]{1,47}$" }, "vendor_id": { "type": "string", "pattern": "^v_[a-z0-9_]{1,47}$" }, "payment_date": { "type": "string", "pattern": "^2026-[0-9]{2}-[0-9]{2}$" }, "amount_cents": { "type": "integer", "minimum": 1, "maximum": 9000000000000000 }, "channel": { "type": "string", "enum": [ "payment_card", "third_party_network" ] } } }, "example": [ { "row_id": "lr_001", "vendor_id": "v_marketplace", "payment_date": "2026-02-10", "amount_cents": 94000, "channel": "third_party_network" } ] }, "form_summaries": { "type": "array", "minItems": 1, "maxItems": 1000, "items": { "type": "object", "additionalProperties": false, "required": [ "document_id", "vendor_id", "form_type", "box", "amount_cents", "correction_status" ], "properties": { "document_id": { "type": "string", "pattern": "^d_[a-z0-9_]{1,47}$" }, "vendor_id": { "type": "string", "pattern": "^v_[a-z0-9_]{1,47}$" }, "form_type": { "const": "1099-K" }, "box": { "const": "1a" }, "amount_cents": { "type": "integer", "minimum": 1, "maximum": 9000000000000000 }, "correction_status": { "type": "string", "enum": [ "original", "corrected", "superseded" ] } } }, "example": [ { "document_id": "d_1099k_001", "vendor_id": "v_marketplace", "form_type": "1099-K", "box": "1a", "amount_cents": 100000, "correction_status": "original" } ] }, "mapping_policy": { "type": "object", "additionalProperties": false, "required": [ "policy_id", "version", "comparison_mode", "channels", "allowed_adjustment_types" ], "properties": { "policy_id": { "type": "string", "pattern": "^pol_[a-z0-9_]{1,47}$" }, "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+$" }, "comparison_mode": { "type": "string", "enum": [ "gross_to_gross", "net_to_gross_with_explicit_adjustments" ] }, "channels": { "type": "array", "minItems": 1, "maxItems": 2, "uniqueItems": true, "items": { "type": "string", "enum": [ "payment_card", "third_party_network" ] } }, "allowed_adjustment_types": { "type": "array", "maxItems": 7, "uniqueItems": true, "items": { "type": "string", "enum": [ "cash_equivalent", "credit", "discount", "fee", "other_explicit", "refund", "shipping" ] } } }, "example": { "policy_id": "pol_1099k_net_to_gross", "version": "1.0", "comparison_mode": "net_to_gross_with_explicit_adjustments", "channels": [ "third_party_network" ], "allowed_adjustment_types": [ "fee", "refund", "credit", "shipping", "discount", "cash_equivalent", "other_explicit" ] } }, "adjustments": { "type": "array", "maxItems": 1000, "items": { "type": "object", "additionalProperties": false, "required": [ "adjustment_id", "vendor_id", "type", "amount_cents", "direction", "source_ref" ], "properties": { "adjustment_id": { "type": "string", "pattern": "^adj_[a-z0-9_]{1,47}$" }, "vendor_id": { "type": "string", "pattern": "^v_[a-z0-9_]{1,47}$" }, "type": { "type": "string", "enum": [ "cash_equivalent", "credit", "discount", "fee", "other_explicit", "refund", "shipping" ] }, "amount_cents": { "type": "integer", "minimum": 1, "maximum": 9000000000000000 }, "direction": { "type": "string", "enum": [ "add_to_ledger_for_form_compare", "subtract_from_ledger_for_form_compare" ] }, "source_ref": { "type": "string", "pattern": "^src_[a-z0-9_]{1,47}$" } } }, "example": [ { "adjustment_id": "adj_fee_001", "vendor_id": "v_marketplace", "type": "fee", "amount_cents": 6000, "direction": "add_to_ledger_for_form_compare", "source_ref": "src_processor_fee" } ] }, "tolerance_cents": { "type": "integer", "minimum": 0, "maximum": 1000000, "example": 0 } } }, "ledger-1099-reconciliation-evidence__output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Ledger1099ReconciliationOutput", "type": "object", "additionalProperties": false, "required": [ "service", "service_version", "supported_scope", "evaluated_at_utc", "evidence_mode", "source_fresh_for_current_use", "evidence_valid_until_utc", "request_sha256", "policy_sha256", "overall_status", "group_results", "unmatched_ledger_row_ids", "unmatched_form_document_ids", "unmatched_adjustment_ids", "evidence_context", "evidence_checksum", "limitations", "difference_is_underreported_income", "difference_proves_form_incorrect", "deductibility_determined", "journal_entries_generated", "scope", "fee_eligibility" ], "properties": { "service": { "const": "ledger-1099-reconciliation-evidence" }, "service_version": { "const": "ledger-1099-reconciliation-1.0.0" }, "supported_scope": { "type": "object" }, "evaluated_at_utc": { "type": "string" }, "evidence_mode": { "type": "string", "enum": [ "current", "snapshot_replay" ] }, "source_fresh_for_current_use": { "type": "boolean" }, "evidence_valid_until_utc": { "type": "string" }, "request_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "policy_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "overall_status": { "type": "string", "enum": [ "COMPLETE", "REVIEW", "CONFLICT", "UNKNOWN" ] }, "group_results": { "type": "array", "items": { "type": "object" } }, "unmatched_ledger_row_ids": { "type": "array", "items": { "type": "string" } }, "unmatched_form_document_ids": { "type": "array", "items": { "type": "string" } }, "unmatched_adjustment_ids": { "type": "array", "items": { "type": "string" } }, "evidence_context": { "type": "object" }, "evidence_checksum": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "limitations": { "type": "array", "minItems": 8, "items": { "type": "string" } }, "difference_is_underreported_income": { "const": false }, "difference_proves_form_incorrect": { "const": false }, "deductibility_determined": { "const": false }, "journal_entries_generated": { "const": false }, "scope": { "const": "PUBLIC_PRODUCTION_SNAPSHOT" }, "fee_eligibility": { "type": "object", "additionalProperties": false, "required": [ "eligible", "price_atomic", "currency", "rule", "review_no_charge", "conflict_no_charge", "unknown_no_charge", "stale_no_charge", "settlement_claimed" ], "properties": { "eligible": { "type": "boolean" }, "price_atomic": { "const": "30000" }, "currency": { "const": "USDC" }, "rule": { "const": "FRESH_COMPLETE_ONLY_IF_VALIDATED" }, "review_no_charge": { "const": true }, "conflict_no_charge": { "const": true }, "unknown_no_charge": { "const": true }, "stale_no_charge": { "const": true }, "settlement_claimed": { "const": false } } } } }, "ledger-1099-reconciliation-evidence__failure": { "type": "object", "additionalProperties": false, "required": [ "ok", "chargeable", "code", "http_status" ], "properties": { "ok": { "const": false }, "chargeable": { "const": false }, "code": { "type": "string", "enum": [ "INVALID_INPUT", "LIMIT_EXCEEDED", "ARITHMETIC_OVERFLOW", "EVIDENCE_UNAVAILABLE" ] }, "http_status": { "type": "integer", "enum": [ 400, 413, 503 ] } } }, "agent-release-security-audit__input": { "additionalProperties": false, "properties": { "files": { "items": { "additionalProperties": false, "properties": { "content": { "maxLength": 262144, "type": "string" }, "kind": { "const": "text_utf8" }, "path": { "maxLength": 240, "minLength": 1, "type": "string" } }, "required": [ "path", "kind", "content" ], "type": "object" }, "maxItems": 512, "minItems": 1, "type": "array", "example": [ { "path": "package.json", "kind": "text_utf8", "content": "{\"name\":\"sample-agent\",\"private\":true,\"dependencies\":{}}" } ] } }, "required": [ "files" ], "type": "object" }, "agent-release-security-audit__output": { "additionalProperties": false, "properties": { "findings": { "items": { "additionalProperties": false, "properties": { "evidence_excerpt": { "maxLength": 180, "type": "string" }, "file_sha256": { "maxLength": 64, "minLength": 1, "pattern": "^[0-9a-f]{64}$", "type": "string" }, "line": { "minimum": 1, "type": "integer" }, "message": { "maxLength": 800, "minLength": 1, "type": "string" }, "path": { "maxLength": 240, "minLength": 1, "type": "string" }, "remediation": { "maxLength": 1000, "minLength": 1, "type": "string" }, "rule_id": { "maxLength": 8, "minLength": 1, "type": "string" }, "severity": { "enum": [ "INFO", "LOW", "MEDIUM", "HIGH", "CRITICAL" ], "type": "string" }, "surface": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "rule_id", "surface", "severity", "message", "remediation", "path", "line", "file_sha256", "evidence_excerpt" ], "type": "object" }, "maxItems": 200, "type": "array" }, "findings_truncated": { "type": "boolean" }, "reason": { "maxLength": 500, "type": [ "string", "null" ] }, "status": { "enum": [ "PASS", "WARN", "FAIL", "INCONCLUSIVE", "INVALID_INPUT", "UNSUPPORTED_INPUT", "INTERNAL_ERROR", "TIMEOUT" ], "type": "string" }, "scope": { "const": "PUBLIC_PRODUCTION_SNAPSHOT" }, "fee_eligibility": { "type": "object", "additionalProperties": false, "required": [ "eligible", "price_atomic", "currency", "rule", "invalid_no_charge", "unsupported_no_charge", "failure_no_charge", "settlement_claimed" ], "properties": { "eligible": { "type": "boolean" }, "price_atomic": { "const": "4000" }, "currency": { "const": "USDC" }, "rule": { "const": "COMPLETED_IN_SCOPE_ONLY" }, "invalid_no_charge": { "const": true }, "unsupported_no_charge": { "const": true }, "failure_no_charge": { "const": true }, "settlement_claimed": { "const": false } } } }, "required": [ "status", "reason", "findings", "findings_truncated", "scope", "fee_eligibility" ], "type": "object" }, "agent-release-security-audit__failure": { "type": "object", "additionalProperties": false, "required": [ "ok", "error", "chargeable" ], "properties": { "ok": { "const": false }, "error": { "type": "object", "additionalProperties": false, "required": [ "code", "message", "retryable" ], "properties": { "code": { "type": "string", "enum": [ "INVALID_INPUT", "UNSUPPORTED_INPUT", "LIMIT_EXCEEDED", "INTERNAL_ERROR", "TIMEOUT", "EVIDENCE_UNAVAILABLE" ] }, "message": { "type": "string" }, "retryable": { "type": "boolean" } } }, "chargeable": { "const": false } } }, "url-assertions__failure": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "enum": [ "INVALID_INPUT", "TARGET_BLOCKED", "UPSTREAM_UNAVAILABLE", "LIMIT_EXCEEDED", "TIMEOUT", "INTERNAL_ERROR", "BUSY" ], "type": "string" }, "message": { "type": "string" }, "retryable": { "type": "boolean" } }, "required": [ "code", "message", "retryable" ], "type": "object" }, "ok": { "const": false } }, "required": [ "ok", "error" ], "type": "object" }, "url-assertions__input": { "additionalProperties": false, "properties": { "expectedContentType": { "maxLength": 128, "minLength": 1, "type": "string" }, "expectedSha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "expectedStatus": { "anyOf": [ { "maximum": 599, "minimum": 200, "type": "integer" }, { "items": { "maximum": 599, "minimum": 200, "type": "integer" }, "maxItems": 8, "minItems": 1, "type": "array", "uniqueItems": true } ], "example": 200 }, "forbiddenHeaders": { "items": { "maxLength": 128, "minLength": 1, "pattern": "^[!#$%&'*+.^_`|~0-9A-Za-z-]+$", "type": "string" }, "maxItems": 20, "minItems": 1, "type": "array", "uniqueItems": true }, "forbiddenText": { "items": { "maxLength": 1024, "minLength": 1, "type": "string" }, "maxItems": 10, "minItems": 1, "type": "array" }, "jsonAssertions": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "op": { "const": "exists" }, "pointer": { "maxLength": 512, "minLength": 0, "type": "string" }, "value": { "type": "boolean" } }, "required": [ "pointer", "op", "value" ], "type": "object" }, { "additionalProperties": false, "properties": { "op": { "const": "equals" }, "pointer": { "maxLength": 512, "minLength": 0, "type": "string" }, "value": {} }, "required": [ "pointer", "op", "value" ], "type": "object" }, { "additionalProperties": false, "properties": { "op": { "const": "type" }, "pointer": { "maxLength": 512, "minLength": 0, "type": "string" }, "value": { "enum": [ "null", "boolean", "number", "integer", "string", "array", "object" ] } }, "required": [ "pointer", "op", "value" ], "type": "object" } ] }, "maxItems": 20, "minItems": 1, "type": "array" }, "requiredHeaders": { "additionalProperties": { "additionalProperties": false, "properties": { "match": { "enum": [ "exact", "contains" ] }, "value": { "maxLength": 1024, "minLength": 0, "type": "string" } }, "required": [ "match", "value" ], "type": "object" }, "maxProperties": 20, "minProperties": 1, "propertyNames": { "maxLength": 128, "minLength": 1, "pattern": "^[!#$%&'*+.^_`|~0-9A-Za-z-]+$", "type": "string" }, "type": "object" }, "requiredText": { "items": { "maxLength": 1024, "minLength": 1, "type": "string" }, "maxItems": 10, "minItems": 1, "type": "array" }, "url": { "maxLength": 2048, "minLength": 1, "pattern": "^https?://", "type": "string", "example": "https://playbrightgaming.com/agents/pennybot-test-vector.txt" } }, "required": [ "url" ], "type": "object" }, "url-assertions__output": { "additionalProperties": false, "properties": { "assertions": { "items": { "additionalProperties": false, "properties": { "code": { "pattern": "^[A-Z][A-Z0-9_]+$", "type": "string" }, "id": { "maxLength": 160, "minLength": 1, "type": "string" }, "kind": { "maxLength": 40, "minLength": 1, "type": "string" }, "verdict": { "enum": [ "PASS", "FAIL", "INCONCLUSIVE" ] } }, "required": [ "id", "kind", "verdict", "code" ], "type": "object" }, "maxItems": 84, "minItems": 1, "type": "array" }, "byteLength": { "maximum": 1048576, "minimum": 0, "type": "integer" }, "contentEncoding": { "maxLength": 16384, "minLength": 1, "type": "string" }, "contentType": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "decodedByteLength": { "anyOf": [ { "maximum": 1048576, "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "evidenceId": { "pattern": "^sha256:[a-f0-9]{64}$", "type": "string" }, "finalUrl": { "maxLength": 2048, "minLength": 1, "type": "string" }, "hashSemantics": { "const": "sha256 of complete HTTP entity bytes before content decoding; excludes transfer framing" }, "observedAt": { "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$", "type": "string" }, "observedStatus": { "maximum": 599, "minimum": 200, "type": "integer" }, "rawBodySha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "receipt": { "additionalProperties": false, "properties": { "format": { "const": "pennybot-url-assertions-receipt-v1" }, "payload": { "additionalProperties": false, "properties": { "assertions": { "items": { "additionalProperties": false, "properties": { "code": { "pattern": "^[A-Z][A-Z0-9_]+$", "type": "string" }, "id": { "maxLength": 160, "minLength": 1, "type": "string" }, "kind": { "maxLength": 40, "minLength": 1, "type": "string" }, "verdict": { "enum": [ "PASS", "FAIL", "INCONCLUSIVE" ] } }, "required": [ "id", "kind", "verdict", "code" ], "type": "object" }, "maxItems": 84, "minItems": 1, "type": "array" }, "byteLength": { "maximum": 1048576, "minimum": 0, "type": "integer" }, "contentEncoding": { "maxLength": 16384, "minLength": 1, "type": "string" }, "contentType": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "decodedByteLength": { "anyOf": [ { "maximum": 1048576, "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "finalUrl": { "maxLength": 2048, "minLength": 1, "type": "string" }, "hashSemantics": { "const": "sha256 of complete HTTP entity bytes before content decoding; excludes transfer framing" }, "observedAt": { "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$", "type": "string" }, "observedStatus": { "maximum": 599, "minimum": 200, "type": "integer" }, "rawBodySha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "redirects": { "items": { "additionalProperties": false, "properties": { "from": { "maxLength": 2048, "minLength": 1, "type": "string" }, "status": { "maximum": 599, "minimum": 200, "type": "integer" }, "to": { "maxLength": 2048, "minLength": 1, "type": "string" } }, "required": [ "from", "to", "status" ], "type": "object" }, "maxItems": 3, "type": "array" }, "requestSha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "requestedUrl": { "maxLength": 2048, "minLength": 1, "type": "string" }, "ruleSetVersion": { "const": "url-assertions/1.0.0" }, "semanticTruthClaim": { "const": false }, "truncated": { "const": false }, "unsupported": { "type": "boolean" }, "unsupportedReasons": { "items": { "maxLength": 64, "minLength": 1, "type": "string" }, "maxItems": 5, "type": "array" }, "verdict": { "enum": [ "PASS", "FAIL", "INCONCLUSIVE" ] } }, "required": [ "ruleSetVersion", "verdict", "assertions", "requestedUrl", "finalUrl", "redirects", "observedStatus", "contentType", "contentEncoding", "byteLength", "decodedByteLength", "rawBodySha256", "observedAt", "truncated", "unsupported", "unsupportedReasons", "requestSha256", "hashSemantics", "semanticTruthClaim" ], "type": "object" }, "serialization": { "const": "sorted-key-json-v1" }, "signature": { "type": "null" } }, "required": [ "format", "serialization", "signature", "payload" ], "type": "object" }, "redirects": { "items": { "additionalProperties": false, "properties": { "from": { "maxLength": 2048, "minLength": 1, "type": "string" }, "status": { "maximum": 599, "minimum": 200, "type": "integer" }, "to": { "maxLength": 2048, "minLength": 1, "type": "string" } }, "required": [ "from", "to", "status" ], "type": "object" }, "maxItems": 3, "type": "array" }, "requestSha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "requestedUrl": { "maxLength": 2048, "minLength": 1, "type": "string" }, "ruleSetVersion": { "const": "url-assertions/1.0.0" }, "semanticTruthClaim": { "const": false }, "truncated": { "const": false }, "unsupported": { "type": "boolean" }, "unsupportedReasons": { "items": { "maxLength": 64, "minLength": 1, "type": "string" }, "maxItems": 5, "type": "array" }, "verdict": { "enum": [ "PASS", "FAIL", "INCONCLUSIVE" ] } }, "required": [ "ruleSetVersion", "verdict", "assertions", "requestedUrl", "finalUrl", "redirects", "observedStatus", "contentType", "contentEncoding", "byteLength", "decodedByteLength", "rawBodySha256", "observedAt", "truncated", "unsupported", "unsupportedReasons", "requestSha256", "hashSemantics", "semanticTruthClaim", "evidenceId", "receipt" ], "type": "object" }, "PennyBotProcessing": { "type": "object", "required": [ "order_id", "status" ], "properties": { "order_id": { "type": "string" }, "status": { "const": "processing" } } }, "PennyBotRecoveryError": { "type": "object", "properties": { "error": { "type": "string" }, "order_id": { "type": "string" }, "status": { "type": "string" }, "reason": { "type": [ "string", "null" ] } } }, "PennyBotRetainedOutputExpired": { "type": "object", "additionalProperties": false, "required": [ "order_id", "error" ], "properties": { "order_id": { "type": "string" }, "error": { "const": "retained_output_expired" } } }, "PennyBotAcknowledgment": { "type": "object", "required": [ "order_id", "delivery", "scope" ], "properties": { "order_id": { "type": "string" }, "delivery": { "const": "response_delivered" }, "scope": { "const": "authenticated_exact_hash" } } }, "agent-release-security-audit__legacy_100000_output": { "additionalProperties": false, "properties": { "findings": { "items": { "additionalProperties": false, "properties": { "evidence_excerpt": { "maxLength": 180, "type": "string" }, "file_sha256": { "maxLength": 64, "minLength": 1, "pattern": "^[0-9a-f]{64}$", "type": "string" }, "line": { "minimum": 1, "type": "integer" }, "message": { "maxLength": 800, "minLength": 1, "type": "string" }, "path": { "maxLength": 240, "minLength": 1, "type": "string" }, "remediation": { "maxLength": 1000, "minLength": 1, "type": "string" }, "rule_id": { "maxLength": 8, "minLength": 1, "type": "string" }, "severity": { "enum": [ "INFO", "LOW", "MEDIUM", "HIGH", "CRITICAL" ], "type": "string" }, "surface": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "rule_id", "surface", "severity", "message", "remediation", "path", "line", "file_sha256", "evidence_excerpt" ], "type": "object" }, "maxItems": 200, "type": "array" }, "findings_truncated": { "type": "boolean" }, "reason": { "maxLength": 500, "type": [ "string", "null" ] }, "status": { "enum": [ "PASS", "WARN", "FAIL", "INCONCLUSIVE", "INVALID_INPUT", "UNSUPPORTED_INPUT", "INTERNAL_ERROR", "TIMEOUT" ], "type": "string" }, "scope": { "const": "PUBLIC_PRODUCTION_SNAPSHOT" }, "fee_eligibility": { "type": "object", "additionalProperties": false, "required": [ "eligible", "price_atomic", "currency", "rule", "invalid_no_charge", "unsupported_no_charge", "failure_no_charge", "settlement_claimed" ], "properties": { "eligible": { "type": "boolean" }, "price_atomic": { "const": "100000" }, "currency": { "const": "USDC" }, "rule": { "const": "COMPLETED_IN_SCOPE_ONLY" }, "invalid_no_charge": { "const": true }, "unsupported_no_charge": { "const": true }, "failure_no_charge": { "const": true }, "settlement_claimed": { "const": false } } } }, "required": [ "status", "reason", "findings", "findings_truncated", "scope", "fee_eligibility" ], "type": "object", "description": "Historical original-order replay only: former 100000-atomic price. New purchases use 4000 atomic. Original retained bytes are not rewritten after a price change." }, "website-release-audit__failure": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "enum": [ "INVALID_INPUT", "LIMIT_EXCEEDED", "INTERNAL_ERROR", "BUSY" ], "type": "string" }, "message": { "type": "string" }, "retryable": { "type": "boolean" } }, "required": [ "code", "message", "retryable" ], "type": "object" }, "ok": { "const": false } }, "required": [ "ok", "error" ], "type": "object" }, "website-release-audit__input": { "additionalProperties": false, "properties": { "expectedCanonical": { "maxLength": 2048, "minLength": 1, "pattern": "^https://", "type": "string" }, "expectedDescription": { "maxLength": 2048, "minLength": 1, "type": "string" }, "expectedStatus": { "maximum": 599, "minimum": 200, "type": "integer" }, "expectedTitle": { "maxLength": 1024, "minLength": 1, "type": "string" }, "servicePaths": { "items": { "additionalProperties": false, "properties": { "method": { "enum": [ "GET", "POST" ] }, "path": { "maxLength": 256, "minLength": 1, "pattern": "^/[A-Za-z0-9_./~-]*$", "type": "string" } }, "required": [ "method", "path" ], "type": "object" }, "maxItems": 4, "type": "array", "uniqueItems": true }, "url": { "maxLength": 2048, "minLength": 1, "pattern": "^https://", "type": "string", "example": "https://playbrightgaming.com/agents/public-url-check.html" } }, "required": [ "url" ], "type": "object" }, "website-release-audit__output": { "additionalProperties": false, "properties": { "checks": { "items": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "detail": { "maxLength": 512, "minLength": 0, "type": "string" }, "id": { "maxLength": 96, "minLength": 1, "type": "string" }, "verdict": { "enum": [ "PASS", "FAIL", "INCONCLUSIVE" ] } }, "required": [ "id", "verdict", "code", "detail" ], "type": "object" }, "maxItems": 48, "minItems": 1, "type": "array" }, "claims": { "additionalProperties": false, "properties": { "paidEndpointDelivery": { "const": false }, "securityCertification": { "const": false }, "semanticTruth": { "const": false }, "seoRanking": { "const": false } }, "required": [ "seoRanking", "securityCertification", "semanticTruth", "paidEndpointDelivery" ], "type": "object" }, "documents": { "items": { "additionalProperties": false, "properties": { "complete": { "type": "boolean" }, "contentEncoding": { "anyOf": [ { "maxLength": 16384, "minLength": 0, "type": "string" }, { "type": "null" } ] }, "contentType": { "anyOf": [ { "maxLength": 16384, "minLength": 0, "type": "string" }, { "type": "null" } ] }, "decodedBytes": { "anyOf": [ { "maximum": 1048576, "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "finalUrl": { "anyOf": [ { "maxLength": 2048, "minLength": 1, "type": "string" }, { "type": "null" } ] }, "id": { "maxLength": 64, "minLength": 1, "type": "string" }, "observedAt": { "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$", "type": "string" }, "rawBodySha256": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] }, "rawBytes": { "anyOf": [ { "maximum": 1048576, "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "reason": { "anyOf": [ { "maxLength": 64, "minLength": 1, "type": "string" }, { "type": "null" } ] }, "redirects": { "items": { "additionalProperties": false, "properties": { "from": { "maxLength": 2048, "minLength": 1, "type": "string" }, "status": { "maximum": 599, "minimum": 200, "type": "integer" }, "to": { "maxLength": 2048, "minLength": 1, "type": "string" } }, "required": [ "from", "to", "status" ], "type": "object" }, "maxItems": 3, "type": "array" }, "requestedUrl": { "maxLength": 2048, "minLength": 1, "type": "string" }, "status": { "anyOf": [ { "maximum": 599, "minimum": 200, "type": "integer" }, { "type": "null" } ] } }, "required": [ "id", "requestedUrl", "finalUrl", "status", "rawBodySha256", "rawBytes", "decodedBytes", "contentType", "contentEncoding", "observedAt", "complete", "reason", "redirects" ], "type": "object" }, "maxItems": 6, "minItems": 6, "type": "array" }, "evidenceId": { "pattern": "^sha256:[a-f0-9]{64}$", "type": "string" }, "hashSemantics": { "const": "SHA-256 of complete HTTP entity bytes before content decoding; excludes transfer framing. Missing/incomplete bodies have no hash." }, "observedAt": { "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$", "type": "string" }, "page": { "additionalProperties": false, "properties": { "complete": { "type": "boolean" }, "contentEncoding": { "anyOf": [ { "maxLength": 16384, "minLength": 0, "type": "string" }, { "type": "null" } ] }, "contentType": { "anyOf": [ { "maxLength": 16384, "minLength": 0, "type": "string" }, { "type": "null" } ] }, "decodedBytes": { "anyOf": [ { "maximum": 1048576, "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "finalUrl": { "anyOf": [ { "maxLength": 2048, "minLength": 1, "type": "string" }, { "type": "null" } ] }, "id": { "maxLength": 64, "minLength": 1, "type": "string" }, "observedAt": { "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$", "type": "string" }, "rawBodySha256": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] }, "rawBytes": { "anyOf": [ { "maximum": 1048576, "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "reason": { "anyOf": [ { "maxLength": 64, "minLength": 1, "type": "string" }, { "type": "null" } ] }, "redirects": { "items": { "additionalProperties": false, "properties": { "from": { "maxLength": 2048, "minLength": 1, "type": "string" }, "status": { "maximum": 599, "minimum": 200, "type": "integer" }, "to": { "maxLength": 2048, "minLength": 1, "type": "string" } }, "required": [ "from", "to", "status" ], "type": "object" }, "maxItems": 3, "type": "array" }, "requestedUrl": { "maxLength": 2048, "minLength": 1, "type": "string" }, "status": { "anyOf": [ { "maximum": 599, "minimum": 200, "type": "integer" }, { "type": "null" } ] } }, "required": [ "id", "requestedUrl", "finalUrl", "status", "rawBodySha256", "rawBytes", "decodedBytes", "contentType", "contentEncoding", "observedAt", "complete", "reason", "redirects" ], "type": "object" }, "requestSha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "ruleSetVersion": { "const": "website-release-audit/1.0.0" }, "signature": { "type": "null" }, "usage": { "additionalProperties": false, "properties": { "decodedBytesAdmitted": { "maximum": 2097152, "minimum": 0, "type": "integer" }, "rawBytesAdmitted": { "maximum": 2097152, "minimum": 0, "type": "integer" }, "redirects": { "maximum": 4, "minimum": 0, "type": "integer" }, "requests": { "maximum": 10, "minimum": 0, "type": "integer" } }, "required": [ "requests", "redirects", "rawBytesAdmitted", "decodedBytesAdmitted" ], "type": "object" }, "verdict": { "enum": [ "PASS", "FAIL", "INCONCLUSIVE" ] }, "warnings": { "items": { "maxLength": 256, "minLength": 1, "type": "string" }, "maxItems": 32, "type": "array" } }, "required": [ "ruleSetVersion", "verdict", "checks", "page", "documents", "requestSha256", "evidenceId", "observedAt", "warnings", "usage", "claims", "hashSemantics", "signature" ], "type": "object" }, "PublicUrlReceipt": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://playbrightgaming.com/agents/receipt.schema.json", "title": "PennyBot Reality Receipt v2", "type": "object", "additionalProperties": false, "required": [ "receiptVersion", "byteContract", "requestedUrl", "finalUrl", "status", "contentType", "contentEncoding", "byteLength", "sha256", "fetchedAt" ], "properties": { "receiptVersion": { "const": "pennybot.url-receipt.v2" }, "byteContract": { "const": "raw-content-encoded-body" }, "requestedUrl": { "type": "string", "format": "uri" }, "finalUrl": { "type": "string", "format": "uri" }, "status": { "type": "integer", "minimum": 200, "maximum": 599 }, "contentType": { "type": [ "string", "null" ] }, "contentEncoding": { "type": "string" }, "byteLength": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "fetchedAt": { "type": "string", "format": "date-time" } } }, "x402-readiness-preflight__legacy_1_0_0_output": { "additionalProperties": false, "properties": { "claims": { "additionalProperties": false, "properties": { "actualSignability": { "const": false }, "deliveryCorrectness": { "const": false }, "generalSecurity": { "const": false }, "merchantHonesty": { "const": false }, "paidSettlement": { "const": false }, "replaySafety": { "const": false } }, "required": [ "paidSettlement", "replaySafety", "deliveryCorrectness", "merchantHonesty", "generalSecurity", "actualSignability" ], "type": "object" }, "evidenceId": { "pattern": "^sha256:[a-f0-9]{64}$", "type": "string" }, "findings": { "items": { "additionalProperties": false, "properties": { "check": { "maxLength": 64, "minLength": 1, "type": "string" }, "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "detail": { "maxLength": 384, "minLength": 1, "type": "string" }, "option": { "anyOf": [ { "maximum": 7, "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "pointer": { "maxLength": 256, "minLength": 0, "type": "string" }, "verdict": { "enum": [ "PASS", "FAIL", "INCONCLUSIVE" ] } }, "required": [ "check", "option", "verdict", "code", "pointer", "detail" ], "type": "object" }, "maxItems": 128, "minItems": 1, "type": "array" }, "limitations": { "items": { "maxLength": 384, "minLength": 1, "type": "string" }, "maxItems": 10, "type": "array" }, "observation": { "additionalProperties": false, "properties": { "bodyShape": { "additionalProperties": false, "properties": { "type": { "const": "none" } }, "required": [ "type" ], "type": "object" }, "complete": { "type": "boolean" }, "contentEncoding": { "anyOf": [ { "maxLength": 16384, "minLength": 0, "type": "string" }, { "type": "null" } ] }, "decodedChallengeSha256": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] }, "failure": { "anyOf": [ { "maxLength": 64, "minLength": 1, "type": "string" }, { "type": "null" } ] }, "finalUrl": { "anyOf": [ { "maxLength": 2048, "minLength": 1, "type": "string" }, { "type": "null" } ] }, "headerSha256": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] }, "httpStatus": { "anyOf": [ { "maximum": 599, "minimum": 200, "type": "integer" }, { "type": "null" } ] }, "method": { "enum": [ "GET", "HEAD", "OPTIONS" ] }, "observedAt": { "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$", "type": "string" }, "paymentRequiredValues": { "items": { "maxLength": 16384, "minLength": 0, "type": "string" }, "maxItems": 128, "type": "array" }, "rawBodySha256": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] }, "rawBytes": { "anyOf": [ { "maximum": 1048576, "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "redirects": { "items": { "additionalProperties": false, "properties": { "from": { "maxLength": 2048, "minLength": 1, "type": "string" }, "status": { "maximum": 399, "minimum": 0, "type": "integer" }, "to": { "maxLength": 2048, "minLength": 1, "type": "string" } }, "required": [ "from", "to", "status" ], "type": "object" }, "maxItems": 3, "type": "array" }, "requestedUrl": { "maxLength": 2048, "minLength": 1, "type": "string" } }, "required": [ "requestedUrl", "method", "bodyShape", "finalUrl", "httpStatus", "observedAt", "complete", "failure", "rawBodySha256", "rawBytes", "contentEncoding", "paymentRequiredValues", "headerSha256", "decodedChallengeSha256", "redirects" ], "type": "object" }, "options": { "items": { "additionalProperties": false, "properties": { "amount": { "anyOf": [ { "maxLength": 78, "minLength": 0, "type": "string" }, { "type": "null" } ] }, "asset": { "anyOf": [ { "maxLength": 80, "minLength": 0, "type": "string" }, { "type": "null" } ] }, "currency": { "anyOf": [ { "maxLength": 12, "minLength": 1, "type": "string" }, { "type": "null" } ] }, "decimals": { "anyOf": [ { "maximum": 18, "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "displayPrice": { "anyOf": [ { "maxLength": 86, "minLength": 0, "type": "string" }, { "type": "null" } ] }, "domainName": { "anyOf": [ { "maxLength": 128, "minLength": 0, "type": "string" }, { "type": "null" } ] }, "domainVersion": { "anyOf": [ { "maxLength": 64, "minLength": 0, "type": "string" }, { "type": "null" } ] }, "index": { "maximum": 7, "minimum": 0, "type": "integer" }, "maxTimeoutSeconds": { "anyOf": [ { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "network": { "anyOf": [ { "maxLength": 80, "minLength": 0, "type": "string" }, { "type": "null" } ] }, "payTo": { "anyOf": [ { "maxLength": 80, "minLength": 0, "type": "string" }, { "type": "null" } ] }, "scheme": { "anyOf": [ { "maxLength": 80, "minLength": 0, "type": "string" }, { "type": "null" } ] }, "signability": { "enum": [ "METADATA_PRESENT", "MISSING_OR_INVALID", "UNSUPPORTED" ] }, "verdict": { "enum": [ "PASS", "FAIL", "INCONCLUSIVE" ] } }, "required": [ "index", "verdict", "scheme", "network", "asset", "amount", "displayPrice", "currency", "decimals", "payTo", "maxTimeoutSeconds", "domainName", "domainVersion", "signability" ], "type": "object" }, "maxItems": 8, "type": "array" }, "requestSha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "ruleSetVersion": { "const": "x402-readiness-preflight/1.0.0" }, "signature": { "type": "null" }, "startedAt": { "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$", "type": "string" }, "usage": { "additionalProperties": false, "properties": { "rawBytes": { "maximum": 1048576, "minimum": 0, "type": "integer" }, "redirects": { "maximum": 3, "minimum": 0, "type": "integer" }, "requests": { "maximum": 4, "minimum": 0, "type": "integer" } }, "required": [ "requests", "redirects", "rawBytes" ], "type": "object" }, "verdict": { "enum": [ "PASS", "FAIL", "INCONCLUSIVE" ] } }, "required": [ "ruleSetVersion", "requestSha256", "startedAt", "observation", "verdict", "findings", "options", "usage", "claims", "limitations", "signature", "evidenceId" ], "type": "object", "description": "Historical result schema for exact replay/recovery of retained original 1.0.0 orders only; new purchases emit 1.0.1." } } } }