changedOutput schema / (root)
Previous value: -nullNew value: +{
+ "additionalProperties": true,
+ "anyOf": [
+ {
+ "required": [
+ "status"
+ ]
+ },
+ {
+ "required": [
+ "code",
+ "message"
+ ]
+ }
+ ],
+ "description": "Free retry admission or a tool error. Only failed token_risk and tx_guard jobs have one manual retry; risk_panel jobs are ineligible and require support review. A failed status alone does not prove retry eligibility. Read agent_guidance.payment and analysis. A missing receipt or result does not prove no charge or refund.",
+ "properties": {
+ "agent_guidance": {
+ "description": "Optional additive agent instructions; does not replace x402 headers or the original result.",
+ "properties": {
+ "analysis": {
+ "properties": {
+ "explanation": {
+ "type": "string"
+ },
+ "result_available": {
+ "type": "boolean"
+ },
+ "status": {
+ "enum": [
+ "not_started",
+ "waiting_for_payment",
+ "queued",
+ "running",
+ "processing",
+ "completed",
+ "failed",
+ "review_required",
+ "not_reported"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "result_available",
+ "explanation"
+ ],
+ "type": "object"
+ },
+ "code": {
+ "type": "string"
+ },
+ "documentation": {
+ "type": "string"
+ },
+ "examples": {
+ "items": {
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "instructions": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "next_action": {
+ "type": "string"
+ },
+ "payment": {
+ "properties": {
+ "background_reconciliation_available": {
+ "const": false,
+ "type": "boolean"
+ },
+ "charge_outcome": {
+ "enum": [
+ "not_applicable",
+ "not_charged",
+ "charged",
+ "unconfirmed"
+ ],
+ "type": "string"
+ },
+ "explanation": {
+ "type": "string"
+ },
+ "legacy_charged_note": {
+ "type": "string"
+ },
+ "new_authorization_allowed": {
+ "type": "boolean"
+ },
+ "next_action": {
+ "type": "string"
+ },
+ "status": {
+ "enum": [
+ "not_required",
+ "not_started",
+ "not_settled",
+ "confirmation_pending",
+ "settled",
+ "reconciliation_required",
+ "unconfirmed"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "charge_outcome",
+ "explanation",
+ "next_action"
+ ],
+ "type": "object"
+ },
+ "payment_allowed": {
+ "description": "Advisory only; server preflight enforces input validity.",
+ "type": "boolean"
+ },
+ "payment_status": {
+ "enum": [
+ "settled",
+ "not_charged",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ "request_example": {
+ "description": "Recommended NEXT action. A blueprint is not executable until its required original context or actual inputs are supplied. No signing or payment is performed by returning this object.",
+ "properties": {
+ "body_fields": {
+ "type": "object"
+ },
+ "effects": {
+ "properties": {
+ "analysis": {
+ "enum": [
+ "none",
+ "read_operation_schema",
+ "read_existing_job",
+ "request_free_token_analysis",
+ "read_advisor_catalog",
+ "resume_or_recover_existing_job",
+ "start_or_complete_analysis",
+ "attempt_free_retry"
+ ],
+ "type": "string"
+ },
+ "payment": {
+ "enum": [
+ "none",
+ "may_settle_original_authorization",
+ "may_settle_reviewed_authorization"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "payment",
+ "analysis"
+ ],
+ "type": "object"
+ },
+ "executable": {
+ "type": "boolean"
+ },
+ "explanation": {
+ "type": "string"
+ },
+ "method": {
+ "type": "string"
+ },
+ "new_authorization_allowed": {
+ "type": "boolean"
+ },
+ "payment_proof_required": {
+ "type": "boolean"
+ },
+ "request_source": {
+ "type": "string"
+ },
+ "requires": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "http",
+ "mcp",
+ "original_context",
+ "original_request",
+ "manual",
+ "none"
+ ],
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ },
+ "url_template": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "executable",
+ "explanation",
+ "effects",
+ "payment_proof_required",
+ "new_authorization_allowed"
+ ],
+ "type": "object"
+ },
+ "schema": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "charged": {
+ "description": "Legacy: true confirms settlement, false reports no settled charge for this attempt, null means unconfirmed. Never infer a refund or no charge from null.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "code": {
+ "description": "Error code when the tool cannot fulfill this request.",
+ "type": "string"
+ },
+ "created_at": {
+ "type": "number"
+ },
+ "delivery_state": {
+ "description": "Legacy ledger state when returned by a job/retry observation.",
+ "type": "string"
+ },
+ "error": {
+ "type": "string"
+ },
+ "eta_s": {
+ "description": "Estimated queue delay, not a completion deadline.",
+ "type": "number"
+ },
+ "id": {
+ "description": "Legacy opaque job identifier.",
+ "type": "string"
+ },
+ "instructions": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "job_id": {
+ "description": "Opaque server-returned job identifier; preserve it exactly.",
+ "type": "string"
+ },
+ "kind": {
+ "description": "Stored job kind when exposed; production paid checks use token_risk, tx_guard or risk_panel.",
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "next_action": {
+ "type": "string"
+ },
+ "payment_receipt": {
+ "description": "Decoded receipt when available after settlement; historical encoded receipts may remain only in receipt_header.",
+ "properties": {
+ "network": {
+ "type": "string"
+ },
+ "success": {
+ "type": "boolean"
+ },
+ "transaction": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "payment_status": {
+ "description": "Legacy ledger or error field. Use agent_guidance.payment for the explicit charge outcome.",
+ "enum": [
+ "reserved",
+ "prepared",
+ "claiming",
+ "uncertain",
+ "settled",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ "prepaid": {
+ "type": "boolean"
+ },
+ "receipt_header": {
+ "description": "Stored receipt when available. This is not a new payment proof to authorize or replay.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "result": {
+ "description": "Conditional result. Paid results are released only after confirmed settlement; token/transaction jobs expose the saved paid response envelope, while prepaid panels expose their analysis object when ready. Legacy non-purchase jobs may expose their result directly. Absence never proves no charge."
+ },
+ "retry_after_s": {
+ "description": "Free polling delay, not a deadline or instruction to authorize payment.",
+ "minimum": 1,
+ "type": "integer"
+ },
+ "status": {
+ "description": "Analysis and payment are separate facts. ready/done can mean work finished while its paid result is still withheld; needs_review can concern payment or analysis. Read agent_guidance.payment and analysis.",
+ "enum": [
+ "awaiting_payment",
+ "queued",
+ "running",
+ "processing",
+ "done",
+ "ready",
+ "failed",
+ "payment_processing",
+ "needs_review"
+ ],
+ "type": "string"
+ },
+ "status_tool": {
+ "description": "Free tool to observe the existing retry; normally get_job_result.",
+ "type": "string"
+ },
+ "status_url": {
+ "description": "Free GET path for this existing job; no settlement or analysis restart.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "agent_guidance"
+ ],
+ "type": "object"
+}
