{"uid":"cap_fv24Dnu6mG3pTi6VueYm-","slug":"a2a-artifact-handoff-c024f68f","name":"A2A Artifact Handoff","description":"Compile agent outputs against a receiver contract and return a verified handoff package.","url":"https://a2a-artifact-handoff.onrender.com/v1/handoffs/compile","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"ttlHours":{"type":"integer","title":"Ttlhours","default":24,"maximum":720,"minimum":1},"sourceOutputs":{"type":"array","items":{"type":"object","title":"SourceOutput","required":["id","filename","mediaType"],"properties":{"id":{"type":"string","title":"Id","maxLength":80,"minLength":1},"role":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Role","default":null},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content","default":null},"filename":{"type":"string","title":"Filename","maxLength":200,"minLength":1},"mediaType":{"type":"string","title":"Mediatype","maxLength":120,"minLength":3},"contentBase64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contentbase64","default":null}},"description":"One output produced by the source agent."},"title":"Sourceoutputs","minItems":1},"handoffContext":{"type":"object","title":"HandoffContext","required":["objective"],"properties":{"status":{"type":"string","title":"Status","default":"completed","maxLength":80},"decisions":{"type":"array","items":{"type":"string"},"title":"Decisions"},"objective":{"type":"string","title":"Objective","maxLength":2000,"minLength":1},"assumptions":{"type":"array","items":{"type":"string"},"title":"Assumptions"},"sourceAgent":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Sourceagent","default":null},"destinationAgent":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Destinationagent","default":null},"unresolvedIssues":{"type":"array","items":{"type":"string"},"title":"Unresolvedissues"}}},"receiverContract":{"type":"object","title":"ReceiverContract","required":["destinationCapability","requiredOutputs"],"properties":{"constraints":{"type":"object","title":"ContractConstraints","examples":[{"maxFileBytes":100000,"requireSha256":true}],"properties":{"maxFileBytes":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Maxfilebytes","default":null,"description":"Optional maximum size in bytes for each delivered artifact."},"requireSha256":{"type":"boolean","title":"Requiresha256","default":true,"description":"Require SHA-256 integrity metadata for delivered artifacts."}},"description":"Runtime constraint values. Provide requireSha256 and optionally maxFileBytes; do not copy JSON Schema definitions into this field."},"contractVersion":{"type":"string","title":"Contractversion","default":"0.1"},"requiredOutputs":{"type":"array","items":{"type":"object","title":"OutputRequirement","examples":[{"id":"report","filename":"report.md","required":true,"acceptedMediaTypes":["text/markdown"]},{"id":"evidence","filename":"evidence.csv","required":true,"acceptedMediaTypes":["text/csv"],"requiredCsvColumns":["channel","score","evidence"]},{"id":"summary","filename":"summary.json","required":true,"requiredJsonKeys":["recommendation","confidence"],"acceptedMediaTypes":["application/json"]}],"required":["id","acceptedMediaTypes"],"properties":{"id":{"type":"string","title":"Id","maxLength":80,"minLength":1,"description":"Stable requirement identifier. Use the matching source output id when known; use filename only for the delivered filename."},"filename":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Filename","default":null,"description":"Filename required by the receiving agent."},"required":{"type":"boolean","title":"Required","default":true,"description":"Whether this deliverable is mandatory."},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Description","default":null},"requiredJsonKeys":{"type":"array","items":{"type":"string"},"title":"Requiredjsonkeys","description":"Use only when acceptedMediaTypes contains application/json. Leave empty for Markdown, text, CSV, images, and other media types."},"acceptedMediaTypes":{"type":"array","items":{"type":"string"},"title":"Acceptedmediatypes","minItems":1,"description":"Media types accepted for this deliverable, for example text/markdown, text/csv, or application/json."},"requiredCsvColumns":{"type":"array","items":{"type":"string"},"title":"Requiredcsvcolumns","description":"Use only when acceptedMediaTypes contains text/csv. Leave empty for Markdown, text, JSON, images, and other media types."}},"description":"One deliverable expected by the receiving agent."},"title":"Requiredoutputs","minItems":1},"destinationCapability":{"type":"string","title":"Destinationcapability","maxLength":200,"minLength":1}},"description":"Machine-readable input contract declared by the receiving agent."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RlzBdO8cB6js8yIuDqvzN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Compiles agent outputs against a receiver contract and returns a verified, time-limited handoff package for agent-to-agent artifact transfer.","exampleAgentPrompt":"Compile my agent's outputs — a JSON report (report.json) and a PDF summary (summary.pdf) — against the receiver contract that requires both files, with the objective 'Quarterly financial analysis complete', mark the status as completed, and set a 48-hour TTL on the handoff package.","exampleUseCases":[{"title":"Research agent passing findings to writer agent","prompt":"My research agent just finished gathering data and produced a markdown file called findings.md — can you compile it into a verified handoff package for the writer agent, with the objective 'compile competitive landscape research', a 24-hour TTL, and ensure it satisfies the writer agent's contract requiring a markdown artifact?"},{"title":"Data pipeline stage handoff with SHA256 verification","prompt":"Package the outputs from my data-processing agent — a CSV file called results.csv — into a handoff bundle for the analytics agent, objective 'ETL stage 2 complete', with SHA256 verification required, max file size 500KB, and a 12-hour TTL."},{"title":"Multi-file code generation agent handoff","prompt":"My code-gen agent produced three files: main.py, utils.py, and requirements.txt — compile them into a verified handoff package for the code-review agent, with the objective 'initial scaffold generation done', decisions noting 'chose FastAPI over Flask', and a 72-hour TTL before the package expires."}],"resultDescription":"A verified handoff package containing the compiled agent outputs validated against the receiver contract, including contract compliance status, artifact metadata (IDs, filenames, media types), handoff context (objective, decisions, assumptions, unresolved issues), source and destination agent identifiers, and a TTL-bounded expiry timestamp for the package.","failureModes":["Receiver contract validation failure — outputs do not satisfy requiredOutputs spec, returns contract mismatch error","File size constraint violation — artifact exceeds maxFileBytes limit specified in contract constraints","Invalid media type — submitted content type does not match contract expectations","Missing required outputs — sourceOutputs array lacks entries matching receiver contract's requiredOutputs","TTL out of range — ttlHours below 1 or above 720 returns validation error","Empty or malformed content — neither content nor contentBase64 provided for an output item","Payment failure — x402 USDC payment not completed, returns 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when coordinating multi-agent pipelines where one agent's outputs must be formally handed off to another agent with contract compliance verification. It is the right choice when the receiving agent has declared a receiver contract specifying required file types, size constraints, or SHA256 integrity checks. Prefer this over ad-hoc file passing when auditability, TTL-bounded artifact lifecycle management, and structured handoff context (decisions, assumptions, unresolved issues) are required between pipeline stages.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:38:19.177Z","isFirstParty":false}