{ "openapi": "3.1.0", "info": { "title": "A2A", "description": "Tectonic Agentic AI Platform \u2014 Module 22: standardised agent-to-agent delegation and capability negotiation, cross-vendor federation over the A2A protocol.", "version": "0.1.0" }, "paths": { "/v1/a2a/delegate": { "post": { "tags": [ "a2a" ], "summary": "Delegate", "operationId": "delegate_v1_a2a_delegate_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DelegateRequest" } } }, "required": true }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskSchema" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/a2a/tasks": { "get": { "tags": [ "a2a" ], "summary": "List Tasks", "operationId": "list_tasks_v1_a2a_tasks_get", "parameters": [ { "name": "tenant_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tenant Id" } }, { "name": "direction", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Direction" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 50, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Offset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskListResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/a2a/tasks/{task_id}": { "get": { "tags": [ "a2a" ], "summary": "Get Task", "operationId": "get_task_v1_a2a_tasks__task_id__get", "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Task Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskSchema" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/a2a/tasks/{task_id}/cancel": { "post": { "tags": [ "a2a" ], "summary": "Cancel Task", "operationId": "cancel_task_v1_a2a_tasks__task_id__cancel_post", "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Task Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskSchema" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/a2a/access-policies/{caller_agent_id}": { "put": { "tags": [ "a2a" ], "summary": "Set Access Policy", "operationId": "set_access_policy_v1_a2a_access_policies__caller_agent_id__put", "parameters": [ { "name": "caller_agent_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Caller Agent Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetAccessPolicyRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccessPolicySchema" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/a2a/rpc": { "post": { "tags": [ "a2a" ], "summary": "Rpc", "operationId": "rpc_v1_a2a_rpc_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonRpcRequestSchema" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonRpcResponseSchema" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [] } }, "/.well-known/agent.json": { "get": { "summary": "Agent Card", "operationId": "agent_card__well_known_agent_json_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Agent Card Well Known Agent Json Get" } } } } }, "security": [] } }, "/healthz": { "get": { "summary": "Healthz", "operationId": "healthz_healthz_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [] } }, "/metrics": { "get": { "summary": "Metrics", "operationId": "metrics_metrics_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [] } } }, "components": { "schemas": { "AccessPolicySchema": { "properties": { "caller_agent_id": { "type": "string", "title": "Caller Agent Id" }, "tenant_id": { "type": "string", "title": "Tenant Id" }, "allowed_skills": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Allowed Skills" } }, "type": "object", "required": [ "caller_agent_id", "tenant_id", "allowed_skills" ], "title": "AccessPolicySchema" }, "DelegateRequest": { "properties": { "target_agent_url": { "type": "string", "title": "Target Agent Url" }, "skill_id": { "type": "string", "title": "Skill Id" }, "input_message": { "additionalProperties": true, "type": "object", "title": "Input Message", "default": {} } }, "type": "object", "required": [ "target_agent_url", "skill_id" ], "title": "DelegateRequest" }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" }, "JsonRpcRequestSchema": { "properties": { "jsonrpc": { "type": "string", "title": "Jsonrpc", "default": "2.0" }, "method": { "type": "string", "title": "Method" }, "params": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Params" }, "id": { "anyOf": [ { "type": "string" }, { "type": "integer" }, { "type": "null" } ], "title": "Id" } }, "type": "object", "required": [ "method" ], "title": "JsonRpcRequestSchema" }, "JsonRpcResponseSchema": { "properties": { "jsonrpc": { "type": "string", "title": "Jsonrpc", "default": "2.0" }, "id": { "anyOf": [ { "type": "string" }, { "type": "integer" }, { "type": "null" } ], "title": "Id" }, "result": { "anyOf": [ {}, { "type": "null" } ], "title": "Result" }, "error": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Error" } }, "type": "object", "title": "JsonRpcResponseSchema" }, "SetAccessPolicyRequest": { "properties": { "allowed_skills": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Allowed Skills" } }, "type": "object", "title": "SetAccessPolicyRequest" }, "TaskListResponse": { "properties": { "items": { "items": { "$ref": "#/components/schemas/TaskSchema" }, "type": "array", "title": "Items" }, "total": { "type": "integer", "title": "Total" }, "limit": { "type": "integer", "title": "Limit" }, "offset": { "type": "integer", "title": "Offset" } }, "type": "object", "required": [ "items", "total", "limit", "offset" ], "title": "TaskListResponse" }, "TaskSchema": { "properties": { "id": { "type": "string", "title": "Id" }, "tenant_id": { "type": "string", "title": "Tenant Id" }, "direction": { "type": "string", "title": "Direction" }, "peer_agent_url": { "type": "string", "title": "Peer Agent Url" }, "skill_id": { "type": "string", "title": "Skill Id" }, "status": { "type": "string", "title": "Status" }, "input_message": { "additionalProperties": true, "type": "object", "title": "Input Message" }, "output_artifacts": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Output Artifacts" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Error" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At" } }, "type": "object", "required": [ "id", "tenant_id", "direction", "peer_agent_url", "skill_id", "status", "input_message", "output_artifacts", "error", "created_at", "updated_at" ], "title": "TaskSchema" }, "ValidationError": { "properties": { "loc": { "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "type": "array", "title": "Location" }, "msg": { "type": "string", "title": "Message" }, "type": { "type": "string", "title": "Error Type" }, "input": { "title": "Input" }, "ctx": { "type": "object", "title": "Context" } }, "type": "object", "required": [ "loc", "msg", "type" ], "title": "ValidationError" } }, "securitySchemes": { "ServiceBearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT", "description": "Service-to-service HS256 JWT bearer auth (security/jwt_auth.py): every inbound request must carry `Authorization: Bearer `, verified against this module's own service_name as the required audience (TECTONIC_JWT_SHARED_SECRET, one shared signing key across every module in this deployment). Not a user-facing OAuth/OIDC flow -- see this module's README for the full design note." } } }, "security": [ { "ServiceBearerAuth": [] } ] }