Agent Counterparty Action Contract

{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://machinerealms.com/schemas/agent-counterparty-contract.schema.json","title":"Agent Counterparty Action Contract","type":"object","additionalProperties":false,"required":["version","action_id","action_schema_version","authority","idempotency","outcomes","receipt","recovery","evidence_lifecycle"],"properties":{"version":{"type":"string","minLength":1,"maxLength":64},"action_id":{"type":"string","minLength":1,"maxLength":191},"action_schema_version":{"type":"string","minLength":1,"maxLength":64},"canonical_endpoint":{"type":["string","null"],"format":"uri"},"authority":{"type":"object","additionalProperties":false,"required":["identity_requirement","mandate_requirement","scope","human_approval_rule"],"properties":{"identity_requirement":{"type":"string","maxLength":500},"mandate_requirement":{"type":"string","maxLength":1000},"scope":{"type":"array","maxItems":64,"items":{"type":"string","minLength":1,"maxLength":191}},"human_approval_rule":{"type":"string","maxLength":1000},"expires_at":{"type":["string","null"],"format":"date-time"},"budget_limit_minor":{"type":["integer","null"],"minimum":0},"currency":{"type":["string","null"],"pattern":"^[A-Z]{3}$"},"revocation_check":{"type":["string","null"],"maxLength":1000}}},"idempotency":{"type":"object","additionalProperties":false,"required":["required","same_key_same_intent_required","replay_behavior"],"properties":{"required":{"type":"boolean"},"same_key_same_intent_required":{"type":"boolean"},"dedupe_window_seconds":{"type":["integer","null"],"minimum":0},"replay_behavior":{"type":"string","maxLength":1000}}},"commercial":{"type":["object","null"],"additionalProperties":false,"properties":{"currency":{"type":["string","null"],"pattern":"^[A-Z]{3}$"},"unit_of_work":{"type":["string","null"],"maxLength":300},"price_known_before_authorization":{"type":"boolean"},"quote_expires_at":{"type":["string","null"],"format":"date-time"},"charge_point":{"type":["string","null"],"maxLength":500},"partial_result_billing_rule":{"type":["string","null"],"maxLength":1000}}},"outcomes":{"type":"object","additionalProperties":false,"required":["states","unknown_distinct_from_failed","completion_evidence"],"properties":{"states":{"type":"array","minItems":1,"maxItems":32,"items":{"enum":["accepted","committed","completed","partial","failed","unknown"]}},"unknown_distinct_from_failed":{"const":true},"completion_evidence":{"type":"string","maxLength":1000}}},"receipt":{"type":"object","additionalProperties":false,"required":["issued","proof_boundaries"],"properties":{"issued":{"type":"boolean"},"fields":{"type":"array","maxItems":64,"items":{"type":"string","minLength":1,"maxLength":191}},"proof_boundaries":{"type":"array","minItems":1,"maxItems":32,"items":{"type":"string","minLength":1,"maxLength":500}}}},"recovery":{"type":"object","additionalProperties":false,"required":["retry_rule","unknown_outcome_rule","human_escalation_rule"],"properties":{"status_endpoint":{"type":["string","null"],"format":"uri"},"retry_rule":{"type":"string","maxLength":1200},"unknown_outcome_rule":{"type":"string","maxLength":1200},"human_escalation_rule":{"type":"string","maxLength":1200}}},"evidence_lifecycle":{"type":"object","additionalProperties":false,"required":["freshness_state"],"properties":{"observed_at":{"type":["string","null"],"format":"date-time"},"valid_until":{"type":["string","null"],"format":"date-time"},"freshness_state":{"enum":["current","stale","unknown"]},"challenge_state":{"enum":["unchallenged","challenged","resolved","unknown"]},"challenged_at":{"type":["string","null"],"format":"date-time"},"supersedes":{"type":["string","null"],"maxLength":191},"superseded_by":{"type":["string","null"],"maxLength":191},"revoked_at":{"type":["string","null"],"format":"date-time"},"revocation_reason":{"type":["string","null"],"maxLength":1000},"source_version":{"type":["string","null"],"maxLength":191}}}}}