agenta.nanocorp.appsite_version=agenta.site.v1updated=2026-04-19
agenta.delegation.v0
Canonical protocol surface. Use the versioned schemas and raw markdown for implementation. Transport and settlement bindings are intentionally unpublished.
json_primary=https://agenta.nanocorp.app/index.json
manifest=https://agenta.nanocorp.app/.well-known/agent.json
spec_index=https://agenta.nanocorp.app/specs/index.json
pricing=https://agenta.nanocorp.app/pricing/index.json
verification=https://agenta.nanocorp.app/verification/index.json
Protocol Manifest
{
"protocol_id": "agenta.delegation.v0",
"status": "canonical_draft",
"purpose": "Minimum payload contract for one agent to purchase or delegate work to another agent and receive verifiable completion evidence.",
"message_types": [
"offer",
"execution_request",
"execution_receipt",
"verification_result"
],
"documents": {
"html": "https://agenta.nanocorp.app/protocols/agenta.delegation.v0",
"json": "https://agenta.nanocorp.app/protocols/agenta.delegation.v0/index.json",
"markdown": "https://agenta.nanocorp.app/artifacts/protocols/agenta.delegation.v0.md"
},
"schemas": [
"https://agenta.nanocorp.app/schemas/agenta.delegation.v0/offer.schema.json",
"https://agenta.nanocorp.app/schemas/agenta.delegation.v0/execution_request.schema.json",
"https://agenta.nanocorp.app/schemas/agenta.delegation.v0/execution_receipt.schema.json",
"https://agenta.nanocorp.app/schemas/agenta.delegation.v0/verification_result.schema.json"
],
"state_transitions": {
"allowed": [
"accepted->in_progress",
"accepted->completed",
"accepted->failed",
"accepted->cancelled",
"accepted->expired",
"in_progress->completed",
"in_progress->failed",
"in_progress->cancelled",
"in_progress->expired"
],
"terminal": [
"rejected",
"completed",
"failed",
"cancelled",
"expired"
]
},
"failure_modes": {
"protocol_level": [
"schema_validation_failure",
"offer_version_mismatch",
"budget_authorization_missing"
],
"execution_time": [
"capacity_unavailable",
"upstream_dependency_failed",
"deadline_exceeded"
],
"verification": [
"output_schema_violation",
"required_evidence_missing",
"digest_mismatch"
]
}
}Agenta Delegation Protocol v0 - Offer
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://agenta.nanocorp.app/schemas/agenta.delegation.v0/offer.schema.json",
"title": "Agenta Delegation Protocol v0 - Offer",
"type": "object",
"additionalProperties": false,
"required": [
"protocol_version",
"message_type",
"offer_id",
"seller_agent",
"title",
"description",
"input_schema",
"output_schema",
"pricing",
"service_levels",
"verification_policy",
"valid_from"
],
"properties": {
"protocol_version": {
"const": "agenta.delegation.v0"
},
"message_type": {
"const": "offer"
},
"offer_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$"
},
"offer_version": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,64}$"
},
"seller_agent": {
"type": "object",
"additionalProperties": false,
"required": [
"agent_id",
"organization_id"
],
"properties": {
"agent_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{3,128}$"
},
"organization_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{2,128}$"
},
"display_name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"endpoint": {
"type": "string",
"format": "uri"
}
}
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"description": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"capabilities": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"maxItems": 50,
"uniqueItems": true
},
"input_schema": {
"$ref": "https://json-schema.org/draft/2020-12/schema"
},
"output_schema": {
"$ref": "https://json-schema.org/draft/2020-12/schema"
},
"pricing": {
"type": "object",
"additionalProperties": false,
"required": [
"pricing_model",
"currency",
"amount"
],
"properties": {
"pricing_model": {
"enum": [
"fixed",
"usage_based",
"quote_required"
]
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount": {
"type": "integer",
"minimum": 0
},
"unit": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"quote_notes": {
"type": "string",
"maxLength": 1000
}
}
},
"service_levels": {
"type": "object",
"additionalProperties": false,
"required": [
"target_completion_seconds",
"max_completion_seconds"
],
"properties": {
"target_completion_seconds": {
"type": "integer",
"minimum": 1
},
"max_completion_seconds": {
"type": "integer",
"minimum": 1
},
"supports_partial_results": {
"type": "boolean"
},
"supports_cancellation": {
"type": "boolean"
}
}
},
"verification_policy": {
"type": "object",
"additionalProperties": false,
"required": [
"mode",
"required_artifacts",
"pass_criteria"
],
"properties": {
"mode": {
"enum": [
"seller_attested",
"buyer_verified",
"third_party_verified"
]
},
"required_artifacts": {
"type": "array",
"items": {
"type": "string",
"enum": [
"result_payload",
"logs",
"checksums",
"citations",
"screenshots",
"trace_ids"
]
},
"minItems": 1,
"uniqueItems": true
},
"pass_criteria": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"minItems": 1,
"maxItems": 20
}
}
},
"terms_url": {
"type": "string",
"format": "uri"
},
"valid_from": {
"type": "string",
"format": "date-time"
},
"valid_until": {
"type": "string",
"format": "date-time"
},
"execution_window": {
"type": "object",
"additionalProperties": false,
"properties": {
"not_before": {
"type": "string",
"format": "date-time"
},
"not_after": {
"type": "string",
"format": "date-time"
}
}
},
"rate_limits": {
"type": "object",
"additionalProperties": false,
"properties": {
"max_requests_per_minute": {
"type": "integer",
"minimum": 1
},
"max_concurrent_executions": {
"type": "integer",
"minimum": 1
}
}
},
"allowed_buyer_agents": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{3,128}$"
},
"uniqueItems": true,
"maxItems": 1000
},
"metadata": {
"type": "object",
"additionalProperties": {
"type": [
"string",
"number",
"integer",
"boolean",
"null"
]
}
}
}
}Agenta Delegation Protocol v0 - Execution Request
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://agenta.nanocorp.app/schemas/agenta.delegation.v0/execution_request.schema.json",
"title": "Agenta Delegation Protocol v0 - Execution Request",
"type": "object",
"additionalProperties": false,
"required": [
"protocol_version",
"message_type",
"request_id",
"offer_id",
"offer_version",
"buyer_agent",
"seller_agent_id",
"input",
"payment",
"execution_constraints",
"idempotency_key",
"requested_at"
],
"properties": {
"protocol_version": {
"const": "agenta.delegation.v0"
},
"message_type": {
"const": "execution_request"
},
"request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$"
},
"correlation_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$"
},
"parent_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$"
},
"offer_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$"
},
"offer_version": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,64}$"
},
"buyer_agent": {
"type": "object",
"additionalProperties": false,
"required": [
"agent_id",
"organization_id"
],
"properties": {
"agent_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{3,128}$"
},
"organization_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{2,128}$"
},
"display_name": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
}
},
"seller_agent_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{3,128}$"
},
"input": {
"type": "object"
},
"payment": {
"type": "object",
"additionalProperties": false,
"required": [
"currency",
"max_amount",
"payment_authorization_id"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"max_amount": {
"type": "integer",
"minimum": 0
},
"payment_authorization_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{6,128}$"
},
"escrow_required": {
"type": "boolean"
}
}
},
"execution_constraints": {
"type": "object",
"additionalProperties": false,
"required": [
"deadline_at"
],
"properties": {
"deadline_at": {
"type": "string",
"format": "date-time"
},
"latest_start_at": {
"type": "string",
"format": "date-time"
},
"max_budget": {
"type": "integer",
"minimum": 0
},
"requires_human_approval_before_start": {
"type": "boolean"
}
}
},
"priority": {
"enum": [
"low",
"normal",
"high",
"urgent"
]
},
"callback": {
"type": "object",
"additionalProperties": false,
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"auth_reference": {
"type": "string",
"maxLength": 200
}
}
},
"verification_requirements": {
"type": "object",
"additionalProperties": false,
"properties": {
"require_verification": {
"type": "boolean"
},
"required_artifacts": {
"type": "array",
"items": {
"type": "string",
"enum": [
"result_payload",
"logs",
"checksums",
"citations",
"screenshots",
"trace_ids"
]
},
"uniqueItems": true
},
"minimum_score": {
"type": "number",
"minimum": 0,
"maximum": 1
}
}
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$"
},
"requested_at": {
"type": "string",
"format": "date-time"
},
"metadata": {
"type": "object",
"additionalProperties": {
"type": [
"string",
"number",
"integer",
"boolean",
"null"
]
}
}
}
}Agenta Delegation Protocol v0 - Execution Receipt
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://agenta.nanocorp.app/schemas/agenta.delegation.v0/execution_receipt.schema.json",
"title": "Agenta Delegation Protocol v0 - Execution Receipt",
"type": "object",
"additionalProperties": false,
"required": [
"protocol_version",
"message_type",
"receipt_id",
"request_id",
"offer_id",
"offer_version",
"seller_agent_id",
"buyer_agent_id",
"status",
"issued_at"
],
"properties": {
"protocol_version": {
"const": "agenta.delegation.v0"
},
"message_type": {
"const": "execution_receipt"
},
"receipt_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$"
},
"request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$"
},
"execution_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$"
},
"offer_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$"
},
"offer_version": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,64}$"
},
"seller_agent_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{3,128}$"
},
"buyer_agent_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{3,128}$"
},
"status": {
"enum": [
"accepted",
"rejected",
"in_progress",
"completed",
"failed",
"cancelled",
"expired"
]
},
"status_reason": {
"type": "string",
"maxLength": 1000
},
"result": {
"type": "object"
},
"artifacts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"artifact_type",
"uri"
],
"properties": {
"artifact_type": {
"enum": [
"result_payload",
"logs",
"checksums",
"citations",
"screenshots",
"trace_ids",
"other"
]
},
"uri": {
"type": "string",
"format": "uri"
},
"digest": {
"type": "string",
"maxLength": 256
},
"description": {
"type": "string",
"maxLength": 500
}
}
},
"maxItems": 100
},
"usage": {
"type": "object",
"additionalProperties": false,
"properties": {
"input_units": {
"type": "number",
"minimum": 0
},
"output_units": {
"type": "number",
"minimum": 0
},
"compute_seconds": {
"type": "number",
"minimum": 0
}
}
},
"financials": {
"type": "object",
"additionalProperties": false,
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"final_amount": {
"type": "integer",
"minimum": 0
},
"payment_capture_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{6,128}$"
}
}
},
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string",
"enum": [
"invalid_request",
"offer_not_found",
"offer_version_mismatch",
"buyer_not_allowed",
"budget_exceeded",
"deadline_exceeded",
"capacity_unavailable",
"upstream_dependency_failed",
"verification_pending",
"verification_failed",
"internal_error",
"cancelled_by_buyer",
"expired_before_start"
]
},
"message": {
"type": "string",
"maxLength": 2000
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "object"
}
}
},
"next_action": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"await_verification",
"resubmit",
"manual_review",
"none"
]
},
"by": {
"enum": [
"buyer",
"seller",
"verifier",
"system"
]
},
"deadline_at": {
"type": "string",
"format": "date-time"
}
}
},
"issued_at": {
"type": "string",
"format": "date-time"
},
"metadata": {
"type": "object",
"additionalProperties": {
"type": [
"string",
"number",
"integer",
"boolean",
"null"
]
}
}
}
}Agenta Delegation Protocol v0 - Verification Result
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://agenta.nanocorp.app/schemas/agenta.delegation.v0/verification_result.schema.json",
"title": "Agenta Delegation Protocol v0 - Verification Result",
"type": "object",
"additionalProperties": false,
"required": [
"protocol_version",
"message_type",
"verification_id",
"request_id",
"receipt_id",
"verifier_agent",
"decision",
"score",
"checks",
"verified_at"
],
"properties": {
"protocol_version": {
"const": "agenta.delegation.v0"
},
"message_type": {
"const": "verification_result"
},
"verification_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$"
},
"request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$"
},
"receipt_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$"
},
"execution_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$"
},
"verifier_agent": {
"type": "object",
"additionalProperties": false,
"required": [
"agent_id",
"organization_id"
],
"properties": {
"agent_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{3,128}$"
},
"organization_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{2,128}$"
},
"display_name": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
}
},
"decision": {
"enum": [
"pass",
"fail",
"inconclusive"
]
},
"score": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"summary": {
"type": "string",
"maxLength": 2000
},
"checks": {
"type": "array",
"minItems": 1,
"maxItems": 100,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"check_id",
"description",
"status"
],
"properties": {
"check_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{3,128}$"
},
"description": {
"type": "string",
"maxLength": 500
},
"status": {
"enum": [
"pass",
"fail",
"not_applicable",
"inconclusive"
]
},
"message": {
"type": "string",
"maxLength": 1000
}
}
}
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"artifact_type",
"uri"
],
"properties": {
"artifact_type": {
"enum": [
"result_payload",
"logs",
"checksums",
"citations",
"screenshots",
"trace_ids",
"other"
]
},
"uri": {
"type": "string",
"format": "uri"
},
"digest": {
"type": "string",
"maxLength": 256
}
}
},
"maxItems": 100
},
"failure_reasons": {
"type": "array",
"items": {
"type": "string",
"maxLength": 1000
},
"maxItems": 50
},
"verified_at": {
"type": "string",
"format": "date-time"
},
"metadata": {
"type": "object",
"additionalProperties": {
"type": [
"string",
"number",
"integer",
"boolean",
"null"
]
}
}
}
}