{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://beyond10x.github.io/a2a/downloads/a2a.schema.json", "title": "A2A v1.0.1 JSON Schema bundle", "description": "Every JSON Schema of generated/schema/schema/ in the a2a repository, generated from its ESS specification. Each file is an embedded resource under $defs, keyed ., with the $id schema//.", "$defs": { "commands.a2a.discovery.GetExtendedAgentCard": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/commands/a2a.discovery.GetExtendedAgentCard.schema.json", "title": "Get extended agent card input", "description": "Return the Agent Card an authenticated client may see, possibly with more skills than the public card (A2A v1.0.1 section 3.1.11; JSON-RPC GetExtendedAgentCard; GET /extendedAgentCard).", "x-ess-name": "a2a.discovery.GetExtendedAgentCard", "x-ess-kind": "command-input", "type": "object", "properties": { "tenant": { "type": "string" } }, "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:7517b162d14db4ecbca2cd456db32ba5672bdf0d968f71fecd351117d157e2b1", "regenerate": "ess generate" } }, "commands.a2a.tasks.CancelTask": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/commands/a2a.tasks.CancelTask.schema.json", "title": "Cancel task input", "description": "Ask the agent to cancel a task (A2A v1.0.1 section 3.1.5; JSON-RPC CancelTask; POST /tasks/{id}:cancel).", "x-ess-name": "a2a.tasks.CancelTask", "x-ess-kind": "command-input", "type": "object", "properties": { "tenant": { "type": "string" }, "id": { "$ref": "#/$defs/a2a.tasks.TaskId" }, "metadata": {} }, "required": [ "id" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:cd9b938709cdd7dd4911a36c3dcf4d8555f19a658081e1271cfe4a172b6004be", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "commands.a2a.tasks.CompleteTask": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/commands/a2a.tasks.CompleteTask.schema.json", "title": "Complete task input", "description": "The task finished successfully (TASK_STATE_COMPLETED).", "x-ess-name": "a2a.tasks.CompleteTask", "x-ess-kind": "command-input", "type": "object", "properties": { "id": { "$ref": "#/$defs/a2a.tasks.TaskId" }, "status_message": { "$ref": "#/$defs/a2a.tasks.Message" } }, "required": [ "id" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:32d642749d9c220ed926e2a65bd76d732809d75ded71e1479580ebc381f48fe7", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Message": { "title": "Message", "description": "One turn of communication between client and agent (A2A v1.0.1 section 4.1.4).", "x-ess-name": "a2a.tasks.Message", "x-ess-kind": "struct", "type": "object", "properties": { "messageId": { "x-ess-field": "message_id", "type": "string" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "role": { "$ref": "#/$defs/a2a.tasks.Role" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } }, "referenceTaskIds": { "x-ess-field": "reference_task_ids", "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.TaskId" } } }, "required": [ "messageId", "role", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.Role": { "title": "Role", "x-ess-name": "a2a.tasks.Role", "x-ess-kind": "enum", "type": "string", "enum": [ "ROLE_USER", "ROLE_AGENT" ] }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "commands.a2a.tasks.CreateTaskPushNotificationConfig": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/commands/a2a.tasks.CreateTaskPushNotificationConfig.schema.json", "title": "Create push notification config input", "description": "Register a webhook for a task's updates (A2A v1.0.1 section 3.1.7; JSON-RPC CreateTaskPushNotificationConfig; POST /tasks/{task_id}/pushNotificationConfigs).", "x-ess-name": "a2a.tasks.CreateTaskPushNotificationConfig", "x-ess-kind": "command-input", "type": "object", "properties": { "tenant": { "type": "string" }, "id": { "$ref": "#/$defs/a2a.tasks.PushNotificationConfigId" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "url": { "type": "string" }, "token": { "type": "string" }, "authentication": { "$ref": "#/$defs/a2a.tasks.AuthenticationInfo" } }, "required": [ "taskId", "url" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:660bf3a982118057925079565b1815cf2c4b1623cab2b0e483ad7557ef033144", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.AuthenticationInfo": { "title": "AuthenticationInfo", "x-ess-name": "a2a.tasks.AuthenticationInfo", "x-ess-kind": "struct", "type": "object", "properties": { "scheme": { "type": "string" }, "credentials": { "type": "string" } }, "required": [ "scheme" ], "additionalProperties": false }, "a2a.tasks.PushNotificationConfigId": { "title": "PushNotificationConfigId", "x-ess-name": "a2a.tasks.PushNotificationConfigId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "commands.a2a.tasks.DeleteTaskPushNotificationConfig": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/commands/a2a.tasks.DeleteTaskPushNotificationConfig.schema.json", "title": "Delete push notification config input", "description": "Remove a push-notification configuration; deleting it again has the same effect (A2A v1.0.1 section 3.1.10; JSON-RPC DeleteTaskPushNotificationConfig; DELETE /tasks/{task_id}/pushNotificationConfigs/{id}).", "x-ess-name": "a2a.tasks.DeleteTaskPushNotificationConfig", "x-ess-kind": "command-input", "type": "object", "properties": { "tenant": { "type": "string" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "id": { "$ref": "#/$defs/a2a.tasks.PushNotificationConfigId" } }, "required": [ "taskId", "id" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:e73ef6f69222036f3fac7ff6406adcdcfecbed5225405c7ed850a4d26979ff0a", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.PushNotificationConfigId": { "title": "PushNotificationConfigId", "x-ess-name": "a2a.tasks.PushNotificationConfigId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "commands.a2a.tasks.FailTask": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/commands/a2a.tasks.FailTask.schema.json", "title": "Fail task input", "description": "The task finished with an error (TASK_STATE_FAILED).", "x-ess-name": "a2a.tasks.FailTask", "x-ess-kind": "command-input", "type": "object", "properties": { "id": { "$ref": "#/$defs/a2a.tasks.TaskId" }, "status_message": { "$ref": "#/$defs/a2a.tasks.Message" } }, "required": [ "id" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:13a223cacf51fb4ab353f82b1cc34e4e54eba30d2b6b7520b4ae08fb6b58aa04", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Message": { "title": "Message", "description": "One turn of communication between client and agent (A2A v1.0.1 section 4.1.4).", "x-ess-name": "a2a.tasks.Message", "x-ess-kind": "struct", "type": "object", "properties": { "messageId": { "x-ess-field": "message_id", "type": "string" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "role": { "$ref": "#/$defs/a2a.tasks.Role" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } }, "referenceTaskIds": { "x-ess-field": "reference_task_ids", "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.TaskId" } } }, "required": [ "messageId", "role", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.Role": { "title": "Role", "x-ess-name": "a2a.tasks.Role", "x-ess-kind": "enum", "type": "string", "enum": [ "ROLE_USER", "ROLE_AGENT" ] }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "commands.a2a.tasks.GetTask": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/commands/a2a.tasks.GetTask.schema.json", "title": "Get task input", "description": "Read a task's current state (A2A v1.0.1 section 3.1.3; JSON-RPC GetTask; GET /tasks/{id}).", "x-ess-name": "a2a.tasks.GetTask", "x-ess-kind": "command-input", "type": "object", "properties": { "tenant": { "type": "string" }, "id": { "$ref": "#/$defs/a2a.tasks.TaskId" }, "historyLength": { "x-ess-field": "history_length", "type": "integer" } }, "required": [ "id" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:f81473cefa5384072934e4be5ceb8f4c158e24c0ffb4a8279283615d0cfbd446", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "commands.a2a.tasks.GetTaskPushNotificationConfig": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/commands/a2a.tasks.GetTaskPushNotificationConfig.schema.json", "title": "Get push notification config input", "description": "Read one push-notification configuration (A2A v1.0.1 section 3.1.8; JSON-RPC GetTaskPushNotificationConfig; GET /tasks/{task_id}/pushNotificationConfigs/{id}).", "x-ess-name": "a2a.tasks.GetTaskPushNotificationConfig", "x-ess-kind": "command-input", "type": "object", "properties": { "tenant": { "type": "string" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "id": { "$ref": "#/$defs/a2a.tasks.PushNotificationConfigId" } }, "required": [ "taskId", "id" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:fe386c191b7e0d72fa735a0cac219241625b4592cd841fa72e9c4bb7268354a2", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.PushNotificationConfigId": { "title": "PushNotificationConfigId", "x-ess-name": "a2a.tasks.PushNotificationConfigId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "commands.a2a.tasks.ListTaskPushNotificationConfigs": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/commands/a2a.tasks.ListTaskPushNotificationConfigs.schema.json", "title": "List push notification configs input", "description": "Read every active push-notification configuration of a task (A2A v1.0.1 section 3.1.9; JSON-RPC ListTaskPushNotificationConfigs; GET /tasks/{task_id}/pushNotificationConfigs).", "x-ess-name": "a2a.tasks.ListTaskPushNotificationConfigs", "x-ess-kind": "command-input", "type": "object", "properties": { "tenant": { "type": "string" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "pageSize": { "x-ess-field": "page_size", "type": "integer" }, "pageToken": { "x-ess-field": "page_token", "type": "string" } }, "required": [ "taskId" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:02cb576547d10dd1b8e4f1101816b9fa4f6a130ee45112da3fe5e03c1bb79776", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "commands.a2a.tasks.RejectTask": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/commands/a2a.tasks.RejectTask.schema.json", "title": "Reject task input", "description": "The agent declines the task (TASK_STATE_REJECTED).", "x-ess-name": "a2a.tasks.RejectTask", "x-ess-kind": "command-input", "type": "object", "properties": { "id": { "$ref": "#/$defs/a2a.tasks.TaskId" }, "status_message": { "$ref": "#/$defs/a2a.tasks.Message" } }, "required": [ "id" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:e6d74b8e0f085b9c036dec63091375f00d4962f704fab49ff16fc3d0b9df357e", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Message": { "title": "Message", "description": "One turn of communication between client and agent (A2A v1.0.1 section 4.1.4).", "x-ess-name": "a2a.tasks.Message", "x-ess-kind": "struct", "type": "object", "properties": { "messageId": { "x-ess-field": "message_id", "type": "string" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "role": { "$ref": "#/$defs/a2a.tasks.Role" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } }, "referenceTaskIds": { "x-ess-field": "reference_task_ids", "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.TaskId" } } }, "required": [ "messageId", "role", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.Role": { "title": "Role", "x-ess-name": "a2a.tasks.Role", "x-ess-kind": "enum", "type": "string", "enum": [ "ROLE_USER", "ROLE_AGENT" ] }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "commands.a2a.tasks.RequireAuth": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/commands/a2a.tasks.RequireAuth.schema.json", "title": "Require authorization input", "description": "The agent needs the client to authorize (TASK_STATE_AUTH_REQUIRED, section 7.6).", "x-ess-name": "a2a.tasks.RequireAuth", "x-ess-kind": "command-input", "type": "object", "properties": { "id": { "$ref": "#/$defs/a2a.tasks.TaskId" }, "status_message": { "$ref": "#/$defs/a2a.tasks.Message" } }, "required": [ "id" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:22134af5faf10c63fa40c04ce839cd509a592b6b99acfa3b7d84b420b6ae2d20", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Message": { "title": "Message", "description": "One turn of communication between client and agent (A2A v1.0.1 section 4.1.4).", "x-ess-name": "a2a.tasks.Message", "x-ess-kind": "struct", "type": "object", "properties": { "messageId": { "x-ess-field": "message_id", "type": "string" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "role": { "$ref": "#/$defs/a2a.tasks.Role" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } }, "referenceTaskIds": { "x-ess-field": "reference_task_ids", "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.TaskId" } } }, "required": [ "messageId", "role", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.Role": { "title": "Role", "x-ess-name": "a2a.tasks.Role", "x-ess-kind": "enum", "type": "string", "enum": [ "ROLE_USER", "ROLE_AGENT" ] }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "commands.a2a.tasks.RequireInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/commands/a2a.tasks.RequireInput.schema.json", "title": "Require input input", "description": "The agent needs more input from the client (TASK_STATE_INPUT_REQUIRED, section 3.4.3).", "x-ess-name": "a2a.tasks.RequireInput", "x-ess-kind": "command-input", "type": "object", "properties": { "id": { "$ref": "#/$defs/a2a.tasks.TaskId" }, "status_message": { "$ref": "#/$defs/a2a.tasks.Message" } }, "required": [ "id" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:33f4b7c1ac0c6990a7c8e761ae9c116d3b4ee36572a2927168447743c4a00ab4", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Message": { "title": "Message", "description": "One turn of communication between client and agent (A2A v1.0.1 section 4.1.4).", "x-ess-name": "a2a.tasks.Message", "x-ess-kind": "struct", "type": "object", "properties": { "messageId": { "x-ess-field": "message_id", "type": "string" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "role": { "$ref": "#/$defs/a2a.tasks.Role" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } }, "referenceTaskIds": { "x-ess-field": "reference_task_ids", "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.TaskId" } } }, "required": [ "messageId", "role", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.Role": { "title": "Role", "x-ess-name": "a2a.tasks.Role", "x-ess-kind": "enum", "type": "string", "enum": [ "ROLE_USER", "ROLE_AGENT" ] }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "commands.a2a.tasks.SendMessage": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/commands/a2a.tasks.SendMessage.schema.json", "title": "Send message input", "description": "Send a message to the agent, which answers with a task tracking its work or with a direct message (A2A v1.0.1 section 3.1.1; JSON-RPC SendMessage; POST /message:send).", "x-ess-name": "a2a.tasks.SendMessage", "x-ess-kind": "command-input", "type": "object", "properties": { "tenant": { "type": "string" }, "message": { "$ref": "#/$defs/a2a.tasks.Message" }, "configuration": { "$ref": "#/$defs/a2a.tasks.SendMessageConfiguration" }, "metadata": {} }, "required": [ "message" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:3ef52b5a545d19990f2a8ab31dc04a4f3039c65f4f906ed9726b1e6c1de23cc2", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.AuthenticationInfo": { "title": "AuthenticationInfo", "x-ess-name": "a2a.tasks.AuthenticationInfo", "x-ess-kind": "struct", "type": "object", "properties": { "scheme": { "type": "string" }, "credentials": { "type": "string" } }, "required": [ "scheme" ], "additionalProperties": false }, "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Message": { "title": "Message", "description": "One turn of communication between client and agent (A2A v1.0.1 section 4.1.4).", "x-ess-name": "a2a.tasks.Message", "x-ess-kind": "struct", "type": "object", "properties": { "messageId": { "x-ess-field": "message_id", "type": "string" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "role": { "$ref": "#/$defs/a2a.tasks.Role" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } }, "referenceTaskIds": { "x-ess-field": "reference_task_ids", "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.TaskId" } } }, "required": [ "messageId", "role", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.PushNotificationConfigId": { "title": "PushNotificationConfigId", "x-ess-name": "a2a.tasks.PushNotificationConfigId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Role": { "title": "Role", "x-ess-name": "a2a.tasks.Role", "x-ess-kind": "enum", "type": "string", "enum": [ "ROLE_USER", "ROLE_AGENT" ] }, "a2a.tasks.SendMessageConfiguration": { "title": "SendMessageConfiguration", "x-ess-name": "a2a.tasks.SendMessageConfiguration", "x-ess-kind": "struct", "type": "object", "properties": { "acceptedOutputModes": { "x-ess-field": "accepted_output_modes", "type": "array", "items": { "type": "string" } }, "taskPushNotificationConfig": { "$ref": "#/$defs/a2a.tasks.TaskPushNotificationConfig", "x-ess-field": "task_push_notification_config" }, "historyLength": { "x-ess-field": "history_length", "type": "integer" }, "returnImmediately": { "x-ess-field": "return_immediately", "type": "boolean" } }, "additionalProperties": false }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskPushNotificationConfig": { "title": "TaskPushNotificationConfig", "description": "The wire form of a push-notification configuration (proto TaskPushNotificationConfig).", "x-ess-name": "a2a.tasks.TaskPushNotificationConfig", "x-ess-kind": "struct", "type": "object", "properties": { "tenant": { "type": "string" }, "id": { "$ref": "#/$defs/a2a.tasks.PushNotificationConfigId" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "url": { "type": "string" }, "token": { "type": "string" }, "authentication": { "$ref": "#/$defs/a2a.tasks.AuthenticationInfo" } }, "required": [ "url" ], "additionalProperties": false } } }, "commands.a2a.tasks.SendStreamingMessage": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/commands/a2a.tasks.SendStreamingMessage.schema.json", "title": "Send streaming message input", "description": "Send a message and stream the answer: one message, or the task followed by its status and artifact updates until it is terminal (A2A v1.0.1 section 3.1.2; JSON-RPC SendStreamingMessage; POST /message:stream).", "x-ess-name": "a2a.tasks.SendStreamingMessage", "x-ess-kind": "command-input", "type": "object", "properties": { "tenant": { "type": "string" }, "message": { "$ref": "#/$defs/a2a.tasks.Message" }, "configuration": { "$ref": "#/$defs/a2a.tasks.SendMessageConfiguration" }, "metadata": {} }, "required": [ "message" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:542679646fed4ddff00d2e07f4bc3ff17943ccc0be46b0109ebd473dd3697ec7", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.AuthenticationInfo": { "title": "AuthenticationInfo", "x-ess-name": "a2a.tasks.AuthenticationInfo", "x-ess-kind": "struct", "type": "object", "properties": { "scheme": { "type": "string" }, "credentials": { "type": "string" } }, "required": [ "scheme" ], "additionalProperties": false }, "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Message": { "title": "Message", "description": "One turn of communication between client and agent (A2A v1.0.1 section 4.1.4).", "x-ess-name": "a2a.tasks.Message", "x-ess-kind": "struct", "type": "object", "properties": { "messageId": { "x-ess-field": "message_id", "type": "string" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "role": { "$ref": "#/$defs/a2a.tasks.Role" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } }, "referenceTaskIds": { "x-ess-field": "reference_task_ids", "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.TaskId" } } }, "required": [ "messageId", "role", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.PushNotificationConfigId": { "title": "PushNotificationConfigId", "x-ess-name": "a2a.tasks.PushNotificationConfigId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Role": { "title": "Role", "x-ess-name": "a2a.tasks.Role", "x-ess-kind": "enum", "type": "string", "enum": [ "ROLE_USER", "ROLE_AGENT" ] }, "a2a.tasks.SendMessageConfiguration": { "title": "SendMessageConfiguration", "x-ess-name": "a2a.tasks.SendMessageConfiguration", "x-ess-kind": "struct", "type": "object", "properties": { "acceptedOutputModes": { "x-ess-field": "accepted_output_modes", "type": "array", "items": { "type": "string" } }, "taskPushNotificationConfig": { "$ref": "#/$defs/a2a.tasks.TaskPushNotificationConfig", "x-ess-field": "task_push_notification_config" }, "historyLength": { "x-ess-field": "history_length", "type": "integer" }, "returnImmediately": { "x-ess-field": "return_immediately", "type": "boolean" } }, "additionalProperties": false }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskPushNotificationConfig": { "title": "TaskPushNotificationConfig", "description": "The wire form of a push-notification configuration (proto TaskPushNotificationConfig).", "x-ess-name": "a2a.tasks.TaskPushNotificationConfig", "x-ess-kind": "struct", "type": "object", "properties": { "tenant": { "type": "string" }, "id": { "$ref": "#/$defs/a2a.tasks.PushNotificationConfigId" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "url": { "type": "string" }, "token": { "type": "string" }, "authentication": { "$ref": "#/$defs/a2a.tasks.AuthenticationInfo" } }, "required": [ "url" ], "additionalProperties": false } } }, "commands.a2a.tasks.StartWorking": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/commands/a2a.tasks.StartWorking.schema.json", "title": "Start working input", "description": "The agent works on the task (TASK_STATE_WORKING).", "x-ess-name": "a2a.tasks.StartWorking", "x-ess-kind": "command-input", "type": "object", "properties": { "id": { "$ref": "#/$defs/a2a.tasks.TaskId" }, "status_message": { "$ref": "#/$defs/a2a.tasks.Message" } }, "required": [ "id" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:b1cfd2c651c4c5a695d16fcc7f849a3b93a423c349257c0fe3fb56fdb2b7f135", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Message": { "title": "Message", "description": "One turn of communication between client and agent (A2A v1.0.1 section 4.1.4).", "x-ess-name": "a2a.tasks.Message", "x-ess-kind": "struct", "type": "object", "properties": { "messageId": { "x-ess-field": "message_id", "type": "string" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "role": { "$ref": "#/$defs/a2a.tasks.Role" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } }, "referenceTaskIds": { "x-ess-field": "reference_task_ids", "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.TaskId" } } }, "required": [ "messageId", "role", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.Role": { "title": "Role", "x-ess-name": "a2a.tasks.Role", "x-ess-kind": "enum", "type": "string", "enum": [ "ROLE_USER", "ROLE_AGENT" ] }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "commands.a2a.tasks.SubscribeToTask": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/commands/a2a.tasks.SubscribeToTask.schema.json", "title": "Subscribe to task input", "description": "Open a stream of a task's updates, starting with the task itself (A2A v1.0.1 section 3.1.6; JSON-RPC SubscribeToTask; GET /tasks/{id}:subscribe).", "x-ess-name": "a2a.tasks.SubscribeToTask", "x-ess-kind": "command-input", "type": "object", "properties": { "tenant": { "type": "string" }, "id": { "$ref": "#/$defs/a2a.tasks.TaskId" } }, "required": [ "id" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:c8e6695794dd29e5381a661e8caf96ab5388409e4f56e2b8c1cc2a2edb92b6ca", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "commands.a2a.tasks.UpdateArtifact": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/commands/a2a.tasks.UpdateArtifact.schema.json", "title": "Update artifact input", "description": "The agent generates an artifact of the task, or a chunk of one (TaskArtifactUpdateEvent).", "x-ess-name": "a2a.tasks.UpdateArtifact", "x-ess-kind": "command-input", "type": "object", "properties": { "id": { "$ref": "#/$defs/a2a.tasks.TaskId" }, "artifact": { "$ref": "#/$defs/a2a.tasks.Artifact" }, "append": { "type": "boolean" }, "last_chunk": { "type": "boolean" } }, "required": [ "id", "artifact", "append", "last_chunk" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:2d1ab7ce5495c98aa24ece1972d08449f38f64e8f356097fd5cb48b89c9200bd", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.Artifact": { "title": "Artifact", "description": "An output the agent produced for a task (A2A v1.0.1 section 4.1.7).", "x-ess-name": "a2a.tasks.Artifact", "x-ess-kind": "struct", "type": "object", "properties": { "artifactId": { "x-ess-field": "artifact_id", "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } } }, "required": [ "artifactId", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "entities.a2a.tasks.PushNotificationConfig": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/entities/a2a.tasks.PushNotificationConfig.schema.json", "title": "PushNotificationConfig", "description": "A webhook the agent posts task updates to. A2A v1.0.1 section 3.1.7: \"The configuration MUST persist until task completion or explicit deletion\"; it states no end of a configuration, so it lives until DeleteTaskPushNotificationConfig removes it.", "x-ess-name": "a2a.tasks.PushNotificationConfig", "x-ess-kind": "entity", "type": "object", "properties": { "row": { "$ref": "#/$defs/a2a.tasks.PushNotificationConfigRow" }, "config_id": { "$ref": "#/$defs/a2a.tasks.PushNotificationConfigId" }, "task_id": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-relation": { "name": "push_notification_configs", "kind": "owns", "source": "a2a.tasks.Task", "target": "a2a.tasks.PushNotificationConfig", "cardinality": "many", "via": "task_id" } }, "tenant": { "type": "string" }, "url": { "type": "string" }, "token": { "type": "string" }, "authentication": { "$ref": "#/$defs/a2a.tasks.AuthenticationInfo" }, "state": { "$ref": "#/$defs/a2a.tasks.PushNotificationConfig.State" } }, "required": [ "row", "config_id", "task_id", "url", "state" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:855f73986d12d7e4b065e5ab7ccb6701c6e809b28f92ea8d1f8f9cd4e7a3e02c", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.AuthenticationInfo": { "title": "AuthenticationInfo", "x-ess-name": "a2a.tasks.AuthenticationInfo", "x-ess-kind": "struct", "type": "object", "properties": { "scheme": { "type": "string" }, "credentials": { "type": "string" } }, "required": [ "scheme" ], "additionalProperties": false }, "a2a.tasks.PushNotificationConfig.State": { "title": "State", "x-ess-name": "a2a.tasks.PushNotificationConfig.State", "x-ess-kind": "enum", "type": "string", "enum": [ "Active" ] }, "a2a.tasks.PushNotificationConfigId": { "title": "PushNotificationConfigId", "x-ess-name": "a2a.tasks.PushNotificationConfigId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.PushNotificationConfigRow": { "title": "PushNotificationConfigRow", "x-ess-name": "a2a.tasks.PushNotificationConfigRow", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "entities.a2a.tasks.Task": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/entities/a2a.tasks.Task.schema.json", "title": "Task", "description": "A stateful unit of work an agent runs for a client. Its lifecycle state is the wire `status.state`; the other status members are fields here.", "x-ess-name": "a2a.tasks.Task", "x-ess-kind": "entity", "type": "object", "properties": { "id": { "$ref": "#/$defs/a2a.tasks.TaskId" }, "context_id": { "$ref": "#/$defs/a2a.tasks.ContextId" }, "tenant": { "type": "string" }, "status_message": { "$ref": "#/$defs/a2a.tasks.Message" }, "status_timestamp": { "type": "string", "format": "date-time" }, "artifacts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Artifact" } }, "history": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Message" } }, "metadata": {}, "state": { "$ref": "#/$defs/a2a.tasks.Task.State" } }, "required": [ "id", "context_id", "state" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:855f73986d12d7e4b065e5ab7ccb6701c6e809b28f92ea8d1f8f9cd4e7a3e02c", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.Artifact": { "title": "Artifact", "description": "An output the agent produced for a task (A2A v1.0.1 section 4.1.7).", "x-ess-name": "a2a.tasks.Artifact", "x-ess-kind": "struct", "type": "object", "properties": { "artifactId": { "x-ess-field": "artifact_id", "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } } }, "required": [ "artifactId", "parts" ], "additionalProperties": false }, "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Message": { "title": "Message", "description": "One turn of communication between client and agent (A2A v1.0.1 section 4.1.4).", "x-ess-name": "a2a.tasks.Message", "x-ess-kind": "struct", "type": "object", "properties": { "messageId": { "x-ess-field": "message_id", "type": "string" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "role": { "$ref": "#/$defs/a2a.tasks.Role" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } }, "referenceTaskIds": { "x-ess-field": "reference_task_ids", "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.TaskId" } } }, "required": [ "messageId", "role", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.Role": { "title": "Role", "x-ess-name": "a2a.tasks.Role", "x-ess-kind": "enum", "type": "string", "enum": [ "ROLE_USER", "ROLE_AGENT" ] }, "a2a.tasks.Task.State": { "title": "State", "x-ess-name": "a2a.tasks.Task.State", "x-ess-kind": "enum", "type": "string", "enum": [ "AuthRequired", "Canceled", "Completed", "Failed", "InputRequired", "Rejected", "Submitted", "Working" ] }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "errors.a2a.discovery.ExtendedAgentCardNotConfigured": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/errors/a2a.discovery.ExtendedAgentCardNotConfigured.schema.json", "title": "ExtendedAgentCardNotConfigured payload", "description": "ExtendedAgentCardNotConfiguredError (JSON-RPC -32007, gRPC FAILED_PRECONDITION, HTTP 400): the agent declares the capability but has no extended card configured.", "x-ess-name": "a2a.discovery.ExtendedAgentCardNotConfigured", "x-ess-kind": "error-payload", "type": "object", "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:fd6e236f9268dfc425adefc676a773eb653989f7364fe301b6ffab5767c2238a", "regenerate": "ess generate" } }, "errors.a2a.discovery.ExtensionSupportRequired": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/errors/a2a.discovery.ExtensionSupportRequired.schema.json", "title": "ExtensionSupportRequired payload", "description": "ExtensionSupportRequiredError (JSON-RPC -32008, gRPC FAILED_PRECONDITION, HTTP 400): the agent card marks an extension required and the request does not declare it.", "x-ess-name": "a2a.discovery.ExtensionSupportRequired", "x-ess-kind": "error-payload", "type": "object", "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:6153f62e08e051fd6b40715e41766e419d21987a19c2e95ed05592f676a7735d", "regenerate": "ess generate" } }, "errors.a2a.discovery.UnsupportedOperation": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/errors/a2a.discovery.UnsupportedOperation.schema.json", "title": "UnsupportedOperation payload", "description": "UnsupportedOperationError (JSON-RPC -32004, gRPC FAILED_PRECONDITION, HTTP 400): the agent card does not declare capabilities.extendedAgentCard.", "x-ess-name": "a2a.discovery.UnsupportedOperation", "x-ess-kind": "error-payload", "type": "object", "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:dc0fd8a72c25e8d665fd3a386b88b03332eecffc7266ad80f99c9f2717381214", "regenerate": "ess generate" } }, "errors.a2a.discovery.VersionNotSupported": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/errors/a2a.discovery.VersionNotSupported.schema.json", "title": "VersionNotSupported payload", "description": "VersionNotSupportedError (JSON-RPC -32009, gRPC FAILED_PRECONDITION, HTTP 400): the A2A-Version the request names is not supported by the agent.", "x-ess-name": "a2a.discovery.VersionNotSupported", "x-ess-kind": "error-payload", "type": "object", "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:4f6677e61158e9b5aaabc183770fc90f77b7947dcb4ac58272ffebe0f3c5ff62", "regenerate": "ess generate" } }, "errors.a2a.tasks.ContentTypeNotSupported": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/errors/a2a.tasks.ContentTypeNotSupported.schema.json", "title": "ContentTypeNotSupported payload", "description": "ContentTypeNotSupportedError (JSON-RPC -32005, gRPC INVALID_ARGUMENT, HTTP 400): a media type of the message's parts is not supported by the agent.", "x-ess-name": "a2a.tasks.ContentTypeNotSupported", "x-ess-kind": "error-payload", "type": "object", "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:5f7ba5bb3d6a57c9f2269aa491998d8eabd54e762b88033842599b017903225a", "regenerate": "ess generate" } }, "errors.a2a.tasks.ContextMismatch": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/errors/a2a.tasks.ContextMismatch.schema.json", "title": "ContextMismatch payload", "description": "InvalidParamsError (JSON-RPC -32602, gRPC INVALID_ARGUMENT, HTTP 400): the message's contextId differs from the contextId of the task it names.", "x-ess-name": "a2a.tasks.ContextMismatch", "x-ess-kind": "error-payload", "type": "object", "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:0dedf288e67d3417ce033d711532cc33c4809a72381690b3645f8addc6f70dd9", "regenerate": "ess generate" } }, "errors.a2a.tasks.ContextNotAccepted": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/errors/a2a.tasks.ContextNotAccepted.schema.json", "title": "ContextNotAccepted payload", "description": "InvalidParamsError (JSON-RPC -32602, gRPC INVALID_ARGUMENT, HTTP 400): the agent cannot accept the contextId the client provided.", "x-ess-name": "a2a.tasks.ContextNotAccepted", "x-ess-kind": "error-payload", "type": "object", "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:7615598a029e2964d1aa60f9b61ad9d7cf39ea5acef22a7bd77f077e0da8ec04", "regenerate": "ess generate" } }, "errors.a2a.tasks.ExtensionSupportRequired": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/errors/a2a.tasks.ExtensionSupportRequired.schema.json", "title": "ExtensionSupportRequired payload", "description": "ExtensionSupportRequiredError (JSON-RPC -32008, gRPC FAILED_PRECONDITION, HTTP 400): the agent card marks an extension required and the request does not declare it.", "x-ess-name": "a2a.tasks.ExtensionSupportRequired", "x-ess-kind": "error-payload", "type": "object", "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:e9acdb59a82551a210448cb69199b9b6bcda617dfa56aa3e85e7daf562a9a638", "regenerate": "ess generate" } }, "errors.a2a.tasks.InvalidAgentResponse": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/errors/a2a.tasks.InvalidAgentResponse.schema.json", "title": "InvalidAgentResponse payload", "description": "InvalidAgentResponseError (JSON-RPC -32006, gRPC INTERNAL, HTTP 500): an agent returned a response that does not conform to the specification for the current method.", "x-ess-name": "a2a.tasks.InvalidAgentResponse", "x-ess-kind": "error-payload", "type": "object", "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:b64ee1fd81f7163ee236eac3a016b07edc3fa385f1eeba2b5a2b6060840001f1", "regenerate": "ess generate" } }, "errors.a2a.tasks.PushNotificationNotSupported": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/errors/a2a.tasks.PushNotificationNotSupported.schema.json", "title": "PushNotificationNotSupported payload", "description": "PushNotificationNotSupportedError (JSON-RPC -32003, gRPC FAILED_PRECONDITION, HTTP 400): the agent card does not declare capabilities.pushNotifications.", "x-ess-name": "a2a.tasks.PushNotificationNotSupported", "x-ess-kind": "error-payload", "type": "object", "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:73bec9d3694bcc55e6fd49008a1ecbd59bcb99ca8727747d307e0768522feac3", "regenerate": "ess generate" } }, "errors.a2a.tasks.ResourceExhausted": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/errors/a2a.tasks.ResourceExhausted.schema.json", "title": "ResourceExhausted payload", "description": "Not an A2A error (gRPC RESOURCE_EXHAUSTED, HTTP 429): the agent already holds as many tasks per tenant, messages per task history, or push-notification configurations per task as it keeps, so the request stored nothing.", "x-ess-name": "a2a.tasks.ResourceExhausted", "x-ess-kind": "error-payload", "type": "object", "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:c1adf15d93d11eb500b586bced5998cb38b5efe5e6efd8a08667a6a1acaff706", "regenerate": "ess generate" } }, "errors.a2a.tasks.TaskNotCancelable": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/errors/a2a.tasks.TaskNotCancelable.schema.json", "title": "TaskNotCancelable payload", "description": "TaskNotCancelableError (JSON-RPC -32002, gRPC FAILED_PRECONDITION, HTTP 400): the task is not in a cancelable state.", "x-ess-name": "a2a.tasks.TaskNotCancelable", "x-ess-kind": "error-payload", "type": "object", "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:1253a486e1707b6b74830d1313fe347efece1e353ab7a3e58faa93977d7e75dc", "regenerate": "ess generate" } }, "errors.a2a.tasks.TaskNotFound": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/errors/a2a.tasks.TaskNotFound.schema.json", "title": "TaskNotFound payload", "description": "TaskNotFoundError (JSON-RPC -32001, gRPC NOT_FOUND, HTTP 404): the task, or the push-notification configuration, does not exist or is not accessible to the caller.", "x-ess-name": "a2a.tasks.TaskNotFound", "x-ess-kind": "error-payload", "type": "object", "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:f04f601d40f4b5ff49749ab61d218ede008c7ef6a25d1f1a70b13d598841e2a9", "regenerate": "ess generate" } }, "errors.a2a.tasks.TaskStateConflict": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/errors/a2a.tasks.TaskStateConflict.schema.json", "title": "TaskStateConflict payload", "description": "The task is not in a state this agent-side move starts from, so nothing moved.", "x-ess-name": "a2a.tasks.TaskStateConflict", "x-ess-kind": "error-payload", "type": "object", "properties": { "state": { "$ref": "#/$defs/a2a.tasks.Task.State" } }, "required": [ "state" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:3509e522ba85bfa9ee3e0c204d79c99adb75f7fef22c4efce53ee1d76e7b7b9d", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.Task.State": { "title": "State", "x-ess-name": "a2a.tasks.Task.State", "x-ess-kind": "enum", "type": "string", "enum": [ "AuthRequired", "Canceled", "Completed", "Failed", "InputRequired", "Rejected", "Submitted", "Working" ] } } }, "errors.a2a.tasks.UnsupportedOperation": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/errors/a2a.tasks.UnsupportedOperation.schema.json", "title": "UnsupportedOperation payload", "description": "UnsupportedOperationError (JSON-RPC -32004, gRPC FAILED_PRECONDITION, HTTP 400): the operation, or an aspect of it, is not supported by this agent.", "x-ess-name": "a2a.tasks.UnsupportedOperation", "x-ess-kind": "error-payload", "type": "object", "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:9e5cbbd57973dfa3584e48d261ea36853c60e5c86a5573fa834d2a9ebec585c5", "regenerate": "ess generate" } }, "errors.a2a.tasks.VersionNotSupported": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/errors/a2a.tasks.VersionNotSupported.schema.json", "title": "VersionNotSupported payload", "description": "VersionNotSupportedError (JSON-RPC -32009, gRPC FAILED_PRECONDITION, HTTP 400): the A2A-Version the request names is not supported by the agent.", "x-ess-name": "a2a.tasks.VersionNotSupported", "x-ess-kind": "error-payload", "type": "object", "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:c8b40d793824c0ca42ebdc599af1f63e273856806a4f2f7612e4a3e93e0ccf01", "regenerate": "ess generate" } }, "events.a2a.tasks.MessageStreamResponse": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/events/a2a.tasks.MessageStreamResponse.schema.json", "title": "Message stream response payload", "description": "One element of the stream SendStreamingMessage answers with (proto StreamResponse; A2A v1.0.1 sections 3.1.2 and 3.2.3).", "x-ess-name": "a2a.tasks.MessageStreamResponse", "x-ess-kind": "event-payload", "type": "object", "properties": { "task": { "$ref": "#/$defs/a2a.tasks.TaskSnapshot" }, "message": { "$ref": "#/$defs/a2a.tasks.Message" }, "statusUpdate": { "$ref": "#/$defs/a2a.tasks.TaskStatusUpdateEvent", "x-ess-field": "status_update" }, "artifactUpdate": { "$ref": "#/$defs/a2a.tasks.TaskArtifactUpdateEvent", "x-ess-field": "artifact_update" } }, "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:4f5201f0763140b7f507e9bf10d641bc231bd7e127eeb818d320025453c3b326", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.Artifact": { "title": "Artifact", "description": "An output the agent produced for a task (A2A v1.0.1 section 4.1.7).", "x-ess-name": "a2a.tasks.Artifact", "x-ess-kind": "struct", "type": "object", "properties": { "artifactId": { "x-ess-field": "artifact_id", "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } } }, "required": [ "artifactId", "parts" ], "additionalProperties": false }, "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Message": { "title": "Message", "description": "One turn of communication between client and agent (A2A v1.0.1 section 4.1.4).", "x-ess-name": "a2a.tasks.Message", "x-ess-kind": "struct", "type": "object", "properties": { "messageId": { "x-ess-field": "message_id", "type": "string" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "role": { "$ref": "#/$defs/a2a.tasks.Role" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } }, "referenceTaskIds": { "x-ess-field": "reference_task_ids", "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.TaskId" } } }, "required": [ "messageId", "role", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.Role": { "title": "Role", "x-ess-name": "a2a.tasks.Role", "x-ess-kind": "enum", "type": "string", "enum": [ "ROLE_USER", "ROLE_AGENT" ] }, "a2a.tasks.TaskArtifactUpdateEvent": { "title": "TaskArtifactUpdateEvent", "description": "\"A task delta where an artifact has been generated\" (a2a.proto TaskArtifactUpdateEvent; A2A v1.0.1 section 4.2.2).", "x-ess-name": "a2a.tasks.TaskArtifactUpdateEvent", "x-ess-kind": "struct", "type": "object", "properties": { "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "artifact": { "$ref": "#/$defs/a2a.tasks.Artifact" }, "append": { "type": "boolean" }, "lastChunk": { "x-ess-field": "last_chunk", "type": "boolean" }, "metadata": {} }, "required": [ "taskId", "contextId", "artifact" ], "additionalProperties": false }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskSnapshot": { "title": "TaskSnapshot", "description": "The wire form of a task, proto message Task (A2A v1.0.1 section 4.1.1).", "x-ess-name": "a2a.tasks.TaskSnapshot", "x-ess-kind": "struct", "type": "object", "properties": { "id": { "$ref": "#/$defs/a2a.tasks.TaskId" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "status": { "$ref": "#/$defs/a2a.tasks.TaskStatus" }, "artifacts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Artifact" } }, "history": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Message" } }, "metadata": {} }, "required": [ "id", "status" ], "additionalProperties": false }, "a2a.tasks.TaskState": { "title": "TaskState", "x-ess-name": "a2a.tasks.TaskState", "x-ess-kind": "enum", "type": "string", "enum": [ "TASK_STATE_SUBMITTED", "TASK_STATE_WORKING", "TASK_STATE_COMPLETED", "TASK_STATE_FAILED", "TASK_STATE_CANCELED", "TASK_STATE_INPUT_REQUIRED", "TASK_STATE_REJECTED", "TASK_STATE_AUTH_REQUIRED" ] }, "a2a.tasks.TaskStatus": { "title": "TaskStatus", "x-ess-name": "a2a.tasks.TaskStatus", "x-ess-kind": "struct", "type": "object", "properties": { "state": { "$ref": "#/$defs/a2a.tasks.TaskState" }, "message": { "$ref": "#/$defs/a2a.tasks.Message" }, "timestamp": { "type": "string", "format": "date-time" } }, "required": [ "state" ], "additionalProperties": false }, "a2a.tasks.TaskStatusUpdateEvent": { "title": "TaskStatusUpdateEvent", "description": "\"An event sent by the agent to notify the client of a change in a task's status\" (a2a.proto TaskStatusUpdateEvent; A2A v1.0.1 section 4.2.1).", "x-ess-name": "a2a.tasks.TaskStatusUpdateEvent", "x-ess-kind": "struct", "type": "object", "properties": { "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "status": { "$ref": "#/$defs/a2a.tasks.TaskStatus" }, "metadata": {} }, "required": [ "taskId", "contextId", "status" ], "additionalProperties": false } } }, "events.a2a.tasks.PushNotificationConfigCreated": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/events/a2a.tasks.PushNotificationConfigCreated.schema.json", "title": "PushNotificationConfigCreated payload", "x-ess-name": "a2a.tasks.PushNotificationConfigCreated", "x-ess-kind": "event-payload", "type": "object", "properties": { "row": { "$ref": "#/$defs/a2a.tasks.PushNotificationConfigRow" }, "config_id": { "$ref": "#/$defs/a2a.tasks.PushNotificationConfigId" }, "task_id": { "$ref": "#/$defs/a2a.tasks.TaskId" } }, "required": [ "row", "config_id", "task_id" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:f50259d1bc41c44913dd47af280bcafe2764e026c78d8fcba80990dae1502234", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.PushNotificationConfigId": { "title": "PushNotificationConfigId", "x-ess-name": "a2a.tasks.PushNotificationConfigId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.PushNotificationConfigRow": { "title": "PushNotificationConfigRow", "x-ess-name": "a2a.tasks.PushNotificationConfigRow", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "events.a2a.tasks.PushNotificationConfigDeleted": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/events/a2a.tasks.PushNotificationConfigDeleted.schema.json", "title": "PushNotificationConfigDeleted payload", "x-ess-name": "a2a.tasks.PushNotificationConfigDeleted", "x-ess-kind": "event-payload", "type": "object", "properties": { "config_id": { "$ref": "#/$defs/a2a.tasks.PushNotificationConfigId" }, "task_id": { "$ref": "#/$defs/a2a.tasks.TaskId" } }, "required": [ "config_id", "task_id" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:2178c547106992cf0a6699de240de4e17185b498289fc9127edbb2912cf1a664", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.PushNotificationConfigId": { "title": "PushNotificationConfigId", "x-ess-name": "a2a.tasks.PushNotificationConfigId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "events.a2a.tasks.TaskArtifactUpdated": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/events/a2a.tasks.TaskArtifactUpdated.schema.json", "title": "TaskArtifactUpdated payload", "description": "An artifact the agent generated; streamed and pushed as the a2a.proto message TaskArtifactUpdateEvent, whose task_id, context_id and artifact it marks REQUIRED.", "x-ess-name": "a2a.tasks.TaskArtifactUpdated", "x-ess-kind": "event-payload", "type": "object", "properties": { "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "artifact": { "$ref": "#/$defs/a2a.tasks.Artifact" }, "append": { "type": "boolean" }, "lastChunk": { "x-ess-field": "last_chunk", "type": "boolean" } }, "required": [ "taskId", "contextId", "artifact" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:60f69f75db47d1e74fa69a768b0728b0dd52fd1aea74cb3d80d47ef54784f3bc", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.Artifact": { "title": "Artifact", "description": "An output the agent produced for a task (A2A v1.0.1 section 4.1.7).", "x-ess-name": "a2a.tasks.Artifact", "x-ess-kind": "struct", "type": "object", "properties": { "artifactId": { "x-ess-field": "artifact_id", "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } } }, "required": [ "artifactId", "parts" ], "additionalProperties": false }, "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "events.a2a.tasks.TaskCreated": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/events/a2a.tasks.TaskCreated.schema.json", "title": "TaskCreated payload", "x-ess-name": "a2a.tasks.TaskCreated", "x-ess-kind": "event-payload", "type": "object", "properties": { "task_id": { "$ref": "#/$defs/a2a.tasks.TaskId" } }, "required": [ "task_id" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:8bd680775554d38410ee7f83ccdc2a797b4b258d5fbff7ed0bb63d4c4a79e8ad", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "events.a2a.tasks.TaskStatusUpdated": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/events/a2a.tasks.TaskStatusUpdated.schema.json", "title": "TaskStatusUpdated payload", "description": "Emitted on every lifecycle move; streamed and pushed as TaskStatusUpdateEvent, whose task_id, context_id and status a2a.proto marks REQUIRED.", "x-ess-name": "a2a.tasks.TaskStatusUpdated", "x-ess-kind": "event-payload", "type": "object", "properties": { "task_id": { "$ref": "#/$defs/a2a.tasks.TaskId" }, "context_id": { "$ref": "#/$defs/a2a.tasks.ContextId" }, "status": { "$ref": "#/$defs/a2a.tasks.TaskStatus" } }, "required": [ "task_id", "context_id", "status" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:4a61e009cbbd4e24a251298c316c8ba0a3c003ce2f77dee4985d45575aaf63f2", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Message": { "title": "Message", "description": "One turn of communication between client and agent (A2A v1.0.1 section 4.1.4).", "x-ess-name": "a2a.tasks.Message", "x-ess-kind": "struct", "type": "object", "properties": { "messageId": { "x-ess-field": "message_id", "type": "string" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "role": { "$ref": "#/$defs/a2a.tasks.Role" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } }, "referenceTaskIds": { "x-ess-field": "reference_task_ids", "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.TaskId" } } }, "required": [ "messageId", "role", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.Role": { "title": "Role", "x-ess-name": "a2a.tasks.Role", "x-ess-kind": "enum", "type": "string", "enum": [ "ROLE_USER", "ROLE_AGENT" ] }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskState": { "title": "TaskState", "x-ess-name": "a2a.tasks.TaskState", "x-ess-kind": "enum", "type": "string", "enum": [ "TASK_STATE_SUBMITTED", "TASK_STATE_WORKING", "TASK_STATE_COMPLETED", "TASK_STATE_FAILED", "TASK_STATE_CANCELED", "TASK_STATE_INPUT_REQUIRED", "TASK_STATE_REJECTED", "TASK_STATE_AUTH_REQUIRED" ] }, "a2a.tasks.TaskStatus": { "title": "TaskStatus", "x-ess-name": "a2a.tasks.TaskStatus", "x-ess-kind": "struct", "type": "object", "properties": { "state": { "$ref": "#/$defs/a2a.tasks.TaskState" }, "message": { "$ref": "#/$defs/a2a.tasks.Message" }, "timestamp": { "type": "string", "format": "date-time" } }, "required": [ "state" ], "additionalProperties": false } } }, "events.a2a.tasks.TaskSubscriptionResponse": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/events/a2a.tasks.TaskSubscriptionResponse.schema.json", "title": "Task subscription response payload", "description": "One element of the stream SubscribeToTask answers with (proto StreamResponse; A2A v1.0.1 sections 3.1.6 and 3.2.3).", "x-ess-name": "a2a.tasks.TaskSubscriptionResponse", "x-ess-kind": "event-payload", "type": "object", "properties": { "task": { "$ref": "#/$defs/a2a.tasks.TaskSnapshot" }, "message": { "$ref": "#/$defs/a2a.tasks.Message" }, "statusUpdate": { "$ref": "#/$defs/a2a.tasks.TaskStatusUpdateEvent", "x-ess-field": "status_update" }, "artifactUpdate": { "$ref": "#/$defs/a2a.tasks.TaskArtifactUpdateEvent", "x-ess-field": "artifact_update" } }, "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:afaa3a79bcecc09d74240c618618f4749ab1f260c76c4eb345d0a02e0148c9b0", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.Artifact": { "title": "Artifact", "description": "An output the agent produced for a task (A2A v1.0.1 section 4.1.7).", "x-ess-name": "a2a.tasks.Artifact", "x-ess-kind": "struct", "type": "object", "properties": { "artifactId": { "x-ess-field": "artifact_id", "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } } }, "required": [ "artifactId", "parts" ], "additionalProperties": false }, "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Message": { "title": "Message", "description": "One turn of communication between client and agent (A2A v1.0.1 section 4.1.4).", "x-ess-name": "a2a.tasks.Message", "x-ess-kind": "struct", "type": "object", "properties": { "messageId": { "x-ess-field": "message_id", "type": "string" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "role": { "$ref": "#/$defs/a2a.tasks.Role" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } }, "referenceTaskIds": { "x-ess-field": "reference_task_ids", "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.TaskId" } } }, "required": [ "messageId", "role", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.Role": { "title": "Role", "x-ess-name": "a2a.tasks.Role", "x-ess-kind": "enum", "type": "string", "enum": [ "ROLE_USER", "ROLE_AGENT" ] }, "a2a.tasks.TaskArtifactUpdateEvent": { "title": "TaskArtifactUpdateEvent", "description": "\"A task delta where an artifact has been generated\" (a2a.proto TaskArtifactUpdateEvent; A2A v1.0.1 section 4.2.2).", "x-ess-name": "a2a.tasks.TaskArtifactUpdateEvent", "x-ess-kind": "struct", "type": "object", "properties": { "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "artifact": { "$ref": "#/$defs/a2a.tasks.Artifact" }, "append": { "type": "boolean" }, "lastChunk": { "x-ess-field": "last_chunk", "type": "boolean" }, "metadata": {} }, "required": [ "taskId", "contextId", "artifact" ], "additionalProperties": false }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskSnapshot": { "title": "TaskSnapshot", "description": "The wire form of a task, proto message Task (A2A v1.0.1 section 4.1.1).", "x-ess-name": "a2a.tasks.TaskSnapshot", "x-ess-kind": "struct", "type": "object", "properties": { "id": { "$ref": "#/$defs/a2a.tasks.TaskId" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "status": { "$ref": "#/$defs/a2a.tasks.TaskStatus" }, "artifacts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Artifact" } }, "history": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Message" } }, "metadata": {} }, "required": [ "id", "status" ], "additionalProperties": false }, "a2a.tasks.TaskState": { "title": "TaskState", "x-ess-name": "a2a.tasks.TaskState", "x-ess-kind": "enum", "type": "string", "enum": [ "TASK_STATE_SUBMITTED", "TASK_STATE_WORKING", "TASK_STATE_COMPLETED", "TASK_STATE_FAILED", "TASK_STATE_CANCELED", "TASK_STATE_INPUT_REQUIRED", "TASK_STATE_REJECTED", "TASK_STATE_AUTH_REQUIRED" ] }, "a2a.tasks.TaskStatus": { "title": "TaskStatus", "x-ess-name": "a2a.tasks.TaskStatus", "x-ess-kind": "struct", "type": "object", "properties": { "state": { "$ref": "#/$defs/a2a.tasks.TaskState" }, "message": { "$ref": "#/$defs/a2a.tasks.Message" }, "timestamp": { "type": "string", "format": "date-time" } }, "required": [ "state" ], "additionalProperties": false }, "a2a.tasks.TaskStatusUpdateEvent": { "title": "TaskStatusUpdateEvent", "description": "\"An event sent by the agent to notify the client of a change in a task's status\" (a2a.proto TaskStatusUpdateEvent; A2A v1.0.1 section 4.2.1).", "x-ess-name": "a2a.tasks.TaskStatusUpdateEvent", "x-ess-kind": "struct", "type": "object", "properties": { "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "status": { "$ref": "#/$defs/a2a.tasks.TaskStatus" }, "metadata": {} }, "required": [ "taskId", "contextId", "status" ], "additionalProperties": false } } }, "responses.a2a.discovery.GetExtendedAgentCard": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/responses/a2a.discovery.GetExtendedAgentCard.schema.json", "title": "Get extended agent card response", "description": "Return the Agent Card an authenticated client may see, possibly with more skills than the public card (A2A v1.0.1 section 3.1.11; JSON-RPC GetExtendedAgentCard; GET /extendedAgentCard).", "x-ess-name": "a2a.discovery.GetExtendedAgentCard", "x-ess-kind": "command-response", "type": "object", "properties": { "card": { "$ref": "#/$defs/a2a.discovery.AgentCard" } }, "required": [ "card" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:7517b162d14db4ecbca2cd456db32ba5672bdf0d968f71fecd351117d157e2b1", "regenerate": "ess generate" }, "$defs": { "a2a.discovery.APIKeySecurityScheme": { "title": "APIKeySecurityScheme", "x-ess-name": "a2a.discovery.APIKeySecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "description": { "type": "string" }, "location": { "type": "string" }, "name": { "type": "string" } }, "required": [ "location", "name" ], "additionalProperties": false }, "a2a.discovery.AgentCapabilities": { "title": "AgentCapabilities", "x-ess-name": "a2a.discovery.AgentCapabilities", "x-ess-kind": "struct", "type": "object", "properties": { "streaming": { "type": "boolean" }, "pushNotifications": { "x-ess-field": "push_notifications", "type": "boolean" }, "extensions": { "type": "array", "items": { "$ref": "#/$defs/a2a.discovery.AgentExtension" } }, "extendedAgentCard": { "x-ess-field": "extended_agent_card", "type": "boolean" } }, "additionalProperties": false }, "a2a.discovery.AgentCard": { "title": "AgentCard", "description": "Self-describing manifest of an agent (A2A v1.0.1 section 4.4.1).", "x-ess-name": "a2a.discovery.AgentCard", "x-ess-kind": "struct", "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "supportedInterfaces": { "x-ess-field": "supported_interfaces", "type": "array", "items": { "$ref": "#/$defs/a2a.discovery.AgentInterface" } }, "provider": { "$ref": "#/$defs/a2a.discovery.AgentProvider" }, "version": { "type": "string" }, "documentationUrl": { "x-ess-field": "documentation_url", "type": "string" }, "capabilities": { "$ref": "#/$defs/a2a.discovery.AgentCapabilities" }, "securitySchemes": { "x-ess-field": "security_schemes", "type": "object", "additionalProperties": { "$ref": "#/$defs/a2a.discovery.SecurityScheme" }, "x-ess-map-key": "String" }, "securityRequirements": { "x-ess-field": "security_requirements", "type": "array", "items": { "$ref": "#/$defs/a2a.discovery.SecurityRequirement" } }, "defaultInputModes": { "x-ess-field": "default_input_modes", "type": "array", "items": { "type": "string" } }, "defaultOutputModes": { "x-ess-field": "default_output_modes", "type": "array", "items": { "type": "string" } }, "skills": { "type": "array", "items": { "$ref": "#/$defs/a2a.discovery.AgentSkill" } }, "signatures": { "type": "array", "items": { "$ref": "#/$defs/a2a.discovery.AgentCardSignature" } }, "iconUrl": { "x-ess-field": "icon_url", "type": "string" } }, "required": [ "name", "description", "supportedInterfaces", "version", "capabilities", "defaultInputModes", "defaultOutputModes", "skills" ], "additionalProperties": false }, "a2a.discovery.AgentCardSignature": { "title": "AgentCardSignature", "x-ess-name": "a2a.discovery.AgentCardSignature", "x-ess-kind": "struct", "type": "object", "properties": { "protected": { "type": "string" }, "signature": { "type": "string" }, "header": {} }, "required": [ "protected", "signature" ], "additionalProperties": false }, "a2a.discovery.AgentExtension": { "title": "AgentExtension", "x-ess-name": "a2a.discovery.AgentExtension", "x-ess-kind": "struct", "type": "object", "properties": { "uri": { "type": "string" }, "description": { "type": "string" }, "required": { "type": "boolean" }, "params": {} }, "additionalProperties": false }, "a2a.discovery.AgentInterface": { "title": "AgentInterface", "description": "A URL and protocol binding the agent is reached at (proto AgentInterface).", "x-ess-name": "a2a.discovery.AgentInterface", "x-ess-kind": "struct", "type": "object", "properties": { "url": { "type": "string" }, "protocolBinding": { "x-ess-field": "protocol_binding", "type": "string" }, "tenant": { "type": "string" }, "protocolVersion": { "x-ess-field": "protocol_version", "type": "string" } }, "required": [ "url", "protocolBinding", "protocolVersion" ], "additionalProperties": false }, "a2a.discovery.AgentProvider": { "title": "AgentProvider", "x-ess-name": "a2a.discovery.AgentProvider", "x-ess-kind": "struct", "type": "object", "properties": { "url": { "type": "string" }, "organization": { "type": "string" } }, "required": [ "url", "organization" ], "additionalProperties": false }, "a2a.discovery.AgentSkill": { "title": "AgentSkill", "x-ess-name": "a2a.discovery.AgentSkill", "x-ess-kind": "struct", "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "examples": { "type": "array", "items": { "type": "string" } }, "inputModes": { "x-ess-field": "input_modes", "type": "array", "items": { "type": "string" } }, "outputModes": { "x-ess-field": "output_modes", "type": "array", "items": { "type": "string" } }, "securityRequirements": { "x-ess-field": "security_requirements", "type": "array", "items": { "$ref": "#/$defs/a2a.discovery.SecurityRequirement" } } }, "required": [ "id", "name", "description", "tags" ], "additionalProperties": false }, "a2a.discovery.AuthorizationCodeOAuthFlow": { "title": "AuthorizationCodeOAuthFlow", "x-ess-name": "a2a.discovery.AuthorizationCodeOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "authorizationUrl": { "x-ess-field": "authorization_url", "type": "string" }, "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" }, "pkceRequired": { "x-ess-field": "pkce_required", "type": "boolean" } }, "required": [ "authorizationUrl", "tokenUrl", "scopes" ], "additionalProperties": false }, "a2a.discovery.ClientCredentialsOAuthFlow": { "title": "ClientCredentialsOAuthFlow", "x-ess-name": "a2a.discovery.ClientCredentialsOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "required": [ "tokenUrl", "scopes" ], "additionalProperties": false }, "a2a.discovery.DeviceCodeOAuthFlow": { "title": "DeviceCodeOAuthFlow", "x-ess-name": "a2a.discovery.DeviceCodeOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "deviceAuthorizationUrl": { "x-ess-field": "device_authorization_url", "type": "string" }, "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "required": [ "deviceAuthorizationUrl", "tokenUrl", "scopes" ], "additionalProperties": false }, "a2a.discovery.HTTPAuthSecurityScheme": { "title": "HTTPAuthSecurityScheme", "x-ess-name": "a2a.discovery.HTTPAuthSecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "description": { "type": "string" }, "scheme": { "type": "string" }, "bearerFormat": { "x-ess-field": "bearer_format", "type": "string" } }, "required": [ "scheme" ], "additionalProperties": false }, "a2a.discovery.ImplicitOAuthFlow": { "title": "ImplicitOAuthFlow", "description": "Deprecated in A2A v1.0.1.", "x-ess-name": "a2a.discovery.ImplicitOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "authorizationUrl": { "x-ess-field": "authorization_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "additionalProperties": false }, "a2a.discovery.MutualTlsSecurityScheme": { "title": "MutualTlsSecurityScheme", "x-ess-name": "a2a.discovery.MutualTlsSecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "description": { "type": "string" } }, "additionalProperties": false }, "a2a.discovery.OAuth2SecurityScheme": { "title": "OAuth2SecurityScheme", "x-ess-name": "a2a.discovery.OAuth2SecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "description": { "type": "string" }, "flows": { "$ref": "#/$defs/a2a.discovery.OAuthFlows" }, "oauth2MetadataUrl": { "x-ess-field": "oauth2_metadata_url", "type": "string" } }, "required": [ "flows" ], "additionalProperties": false }, "a2a.discovery.OAuthFlows": { "title": "OAuthFlows", "x-ess-name": "a2a.discovery.OAuthFlows", "x-ess-kind": "struct", "type": "object", "properties": { "authorizationCode": { "$ref": "#/$defs/a2a.discovery.AuthorizationCodeOAuthFlow", "x-ess-field": "authorization_code" }, "clientCredentials": { "$ref": "#/$defs/a2a.discovery.ClientCredentialsOAuthFlow", "x-ess-field": "client_credentials" }, "implicit": { "$ref": "#/$defs/a2a.discovery.ImplicitOAuthFlow" }, "password": { "$ref": "#/$defs/a2a.discovery.PasswordOAuthFlow" }, "deviceCode": { "$ref": "#/$defs/a2a.discovery.DeviceCodeOAuthFlow", "x-ess-field": "device_code" } }, "additionalProperties": false }, "a2a.discovery.OpenIdConnectSecurityScheme": { "title": "OpenIdConnectSecurityScheme", "x-ess-name": "a2a.discovery.OpenIdConnectSecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "description": { "type": "string" }, "openIdConnectUrl": { "x-ess-field": "open_id_connect_url", "type": "string" } }, "required": [ "openIdConnectUrl" ], "additionalProperties": false }, "a2a.discovery.PasswordOAuthFlow": { "title": "PasswordOAuthFlow", "description": "Deprecated in A2A v1.0.1.", "x-ess-name": "a2a.discovery.PasswordOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "additionalProperties": false }, "a2a.discovery.SecurityRequirement": { "title": "SecurityRequirement", "x-ess-name": "a2a.discovery.SecurityRequirement", "x-ess-kind": "struct", "type": "object", "properties": { "schemes": { "type": "object", "additionalProperties": { "$ref": "#/$defs/a2a.discovery.StringList" }, "x-ess-map-key": "String" } }, "required": [ "schemes" ], "additionalProperties": false }, "a2a.discovery.SecurityScheme": { "title": "SecurityScheme", "x-ess-name": "a2a.discovery.SecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "apiKeySecurityScheme": { "$ref": "#/$defs/a2a.discovery.APIKeySecurityScheme", "x-ess-field": "api_key_security_scheme" }, "httpAuthSecurityScheme": { "$ref": "#/$defs/a2a.discovery.HTTPAuthSecurityScheme", "x-ess-field": "http_auth_security_scheme" }, "oauth2SecurityScheme": { "$ref": "#/$defs/a2a.discovery.OAuth2SecurityScheme", "x-ess-field": "oauth2_security_scheme" }, "openIdConnectSecurityScheme": { "$ref": "#/$defs/a2a.discovery.OpenIdConnectSecurityScheme", "x-ess-field": "open_id_connect_security_scheme" }, "mtlsSecurityScheme": { "$ref": "#/$defs/a2a.discovery.MutualTlsSecurityScheme", "x-ess-field": "mtls_security_scheme" } }, "additionalProperties": false }, "a2a.discovery.StringList": { "title": "StringList", "x-ess-name": "a2a.discovery.StringList", "x-ess-kind": "struct", "type": "object", "properties": { "list": { "type": "array", "items": { "type": "string" } } }, "required": [ "list" ], "additionalProperties": false } } }, "responses.a2a.tasks.CancelTask": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/responses/a2a.tasks.CancelTask.schema.json", "title": "Cancel task response", "description": "Ask the agent to cancel a task (A2A v1.0.1 section 3.1.5; JSON-RPC CancelTask; POST /tasks/{id}:cancel).", "x-ess-name": "a2a.tasks.CancelTask", "x-ess-kind": "command-response", "type": "object", "properties": { "task": { "$ref": "#/$defs/a2a.tasks.TaskSnapshot" } }, "required": [ "task" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:cd9b938709cdd7dd4911a36c3dcf4d8555f19a658081e1271cfe4a172b6004be", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.Artifact": { "title": "Artifact", "description": "An output the agent produced for a task (A2A v1.0.1 section 4.1.7).", "x-ess-name": "a2a.tasks.Artifact", "x-ess-kind": "struct", "type": "object", "properties": { "artifactId": { "x-ess-field": "artifact_id", "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } } }, "required": [ "artifactId", "parts" ], "additionalProperties": false }, "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Message": { "title": "Message", "description": "One turn of communication between client and agent (A2A v1.0.1 section 4.1.4).", "x-ess-name": "a2a.tasks.Message", "x-ess-kind": "struct", "type": "object", "properties": { "messageId": { "x-ess-field": "message_id", "type": "string" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "role": { "$ref": "#/$defs/a2a.tasks.Role" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } }, "referenceTaskIds": { "x-ess-field": "reference_task_ids", "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.TaskId" } } }, "required": [ "messageId", "role", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.Role": { "title": "Role", "x-ess-name": "a2a.tasks.Role", "x-ess-kind": "enum", "type": "string", "enum": [ "ROLE_USER", "ROLE_AGENT" ] }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskSnapshot": { "title": "TaskSnapshot", "description": "The wire form of a task, proto message Task (A2A v1.0.1 section 4.1.1).", "x-ess-name": "a2a.tasks.TaskSnapshot", "x-ess-kind": "struct", "type": "object", "properties": { "id": { "$ref": "#/$defs/a2a.tasks.TaskId" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "status": { "$ref": "#/$defs/a2a.tasks.TaskStatus" }, "artifacts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Artifact" } }, "history": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Message" } }, "metadata": {} }, "required": [ "id", "status" ], "additionalProperties": false }, "a2a.tasks.TaskState": { "title": "TaskState", "x-ess-name": "a2a.tasks.TaskState", "x-ess-kind": "enum", "type": "string", "enum": [ "TASK_STATE_SUBMITTED", "TASK_STATE_WORKING", "TASK_STATE_COMPLETED", "TASK_STATE_FAILED", "TASK_STATE_CANCELED", "TASK_STATE_INPUT_REQUIRED", "TASK_STATE_REJECTED", "TASK_STATE_AUTH_REQUIRED" ] }, "a2a.tasks.TaskStatus": { "title": "TaskStatus", "x-ess-name": "a2a.tasks.TaskStatus", "x-ess-kind": "struct", "type": "object", "properties": { "state": { "$ref": "#/$defs/a2a.tasks.TaskState" }, "message": { "$ref": "#/$defs/a2a.tasks.Message" }, "timestamp": { "type": "string", "format": "date-time" } }, "required": [ "state" ], "additionalProperties": false } } }, "responses.a2a.tasks.CreateTaskPushNotificationConfig": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/responses/a2a.tasks.CreateTaskPushNotificationConfig.schema.json", "title": "Create push notification config response", "description": "Register a webhook for a task's updates (A2A v1.0.1 section 3.1.7; JSON-RPC CreateTaskPushNotificationConfig; POST /tasks/{task_id}/pushNotificationConfigs).", "x-ess-name": "a2a.tasks.CreateTaskPushNotificationConfig", "x-ess-kind": "command-response", "type": "object", "properties": { "config": { "$ref": "#/$defs/a2a.tasks.TaskPushNotificationConfig" } }, "required": [ "config" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:660bf3a982118057925079565b1815cf2c4b1623cab2b0e483ad7557ef033144", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.AuthenticationInfo": { "title": "AuthenticationInfo", "x-ess-name": "a2a.tasks.AuthenticationInfo", "x-ess-kind": "struct", "type": "object", "properties": { "scheme": { "type": "string" }, "credentials": { "type": "string" } }, "required": [ "scheme" ], "additionalProperties": false }, "a2a.tasks.PushNotificationConfigId": { "title": "PushNotificationConfigId", "x-ess-name": "a2a.tasks.PushNotificationConfigId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskPushNotificationConfig": { "title": "TaskPushNotificationConfig", "description": "The wire form of a push-notification configuration (proto TaskPushNotificationConfig).", "x-ess-name": "a2a.tasks.TaskPushNotificationConfig", "x-ess-kind": "struct", "type": "object", "properties": { "tenant": { "type": "string" }, "id": { "$ref": "#/$defs/a2a.tasks.PushNotificationConfigId" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "url": { "type": "string" }, "token": { "type": "string" }, "authentication": { "$ref": "#/$defs/a2a.tasks.AuthenticationInfo" } }, "required": [ "url" ], "additionalProperties": false } } }, "responses.a2a.tasks.GetTask": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/responses/a2a.tasks.GetTask.schema.json", "title": "Get task response", "description": "Read a task's current state (A2A v1.0.1 section 3.1.3; JSON-RPC GetTask; GET /tasks/{id}).", "x-ess-name": "a2a.tasks.GetTask", "x-ess-kind": "command-response", "type": "object", "properties": { "task": { "$ref": "#/$defs/a2a.tasks.TaskSnapshot" } }, "required": [ "task" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:f81473cefa5384072934e4be5ceb8f4c158e24c0ffb4a8279283615d0cfbd446", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.Artifact": { "title": "Artifact", "description": "An output the agent produced for a task (A2A v1.0.1 section 4.1.7).", "x-ess-name": "a2a.tasks.Artifact", "x-ess-kind": "struct", "type": "object", "properties": { "artifactId": { "x-ess-field": "artifact_id", "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } } }, "required": [ "artifactId", "parts" ], "additionalProperties": false }, "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Message": { "title": "Message", "description": "One turn of communication between client and agent (A2A v1.0.1 section 4.1.4).", "x-ess-name": "a2a.tasks.Message", "x-ess-kind": "struct", "type": "object", "properties": { "messageId": { "x-ess-field": "message_id", "type": "string" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "role": { "$ref": "#/$defs/a2a.tasks.Role" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } }, "referenceTaskIds": { "x-ess-field": "reference_task_ids", "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.TaskId" } } }, "required": [ "messageId", "role", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.Role": { "title": "Role", "x-ess-name": "a2a.tasks.Role", "x-ess-kind": "enum", "type": "string", "enum": [ "ROLE_USER", "ROLE_AGENT" ] }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskSnapshot": { "title": "TaskSnapshot", "description": "The wire form of a task, proto message Task (A2A v1.0.1 section 4.1.1).", "x-ess-name": "a2a.tasks.TaskSnapshot", "x-ess-kind": "struct", "type": "object", "properties": { "id": { "$ref": "#/$defs/a2a.tasks.TaskId" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "status": { "$ref": "#/$defs/a2a.tasks.TaskStatus" }, "artifacts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Artifact" } }, "history": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Message" } }, "metadata": {} }, "required": [ "id", "status" ], "additionalProperties": false }, "a2a.tasks.TaskState": { "title": "TaskState", "x-ess-name": "a2a.tasks.TaskState", "x-ess-kind": "enum", "type": "string", "enum": [ "TASK_STATE_SUBMITTED", "TASK_STATE_WORKING", "TASK_STATE_COMPLETED", "TASK_STATE_FAILED", "TASK_STATE_CANCELED", "TASK_STATE_INPUT_REQUIRED", "TASK_STATE_REJECTED", "TASK_STATE_AUTH_REQUIRED" ] }, "a2a.tasks.TaskStatus": { "title": "TaskStatus", "x-ess-name": "a2a.tasks.TaskStatus", "x-ess-kind": "struct", "type": "object", "properties": { "state": { "$ref": "#/$defs/a2a.tasks.TaskState" }, "message": { "$ref": "#/$defs/a2a.tasks.Message" }, "timestamp": { "type": "string", "format": "date-time" } }, "required": [ "state" ], "additionalProperties": false } } }, "responses.a2a.tasks.GetTaskPushNotificationConfig": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/responses/a2a.tasks.GetTaskPushNotificationConfig.schema.json", "title": "Get push notification config response", "description": "Read one push-notification configuration (A2A v1.0.1 section 3.1.8; JSON-RPC GetTaskPushNotificationConfig; GET /tasks/{task_id}/pushNotificationConfigs/{id}).", "x-ess-name": "a2a.tasks.GetTaskPushNotificationConfig", "x-ess-kind": "command-response", "type": "object", "properties": { "config": { "$ref": "#/$defs/a2a.tasks.TaskPushNotificationConfig" } }, "required": [ "config" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:fe386c191b7e0d72fa735a0cac219241625b4592cd841fa72e9c4bb7268354a2", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.AuthenticationInfo": { "title": "AuthenticationInfo", "x-ess-name": "a2a.tasks.AuthenticationInfo", "x-ess-kind": "struct", "type": "object", "properties": { "scheme": { "type": "string" }, "credentials": { "type": "string" } }, "required": [ "scheme" ], "additionalProperties": false }, "a2a.tasks.PushNotificationConfigId": { "title": "PushNotificationConfigId", "x-ess-name": "a2a.tasks.PushNotificationConfigId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskPushNotificationConfig": { "title": "TaskPushNotificationConfig", "description": "The wire form of a push-notification configuration (proto TaskPushNotificationConfig).", "x-ess-name": "a2a.tasks.TaskPushNotificationConfig", "x-ess-kind": "struct", "type": "object", "properties": { "tenant": { "type": "string" }, "id": { "$ref": "#/$defs/a2a.tasks.PushNotificationConfigId" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "url": { "type": "string" }, "token": { "type": "string" }, "authentication": { "$ref": "#/$defs/a2a.tasks.AuthenticationInfo" } }, "required": [ "url" ], "additionalProperties": false } } }, "responses.a2a.tasks.ListTaskPushNotificationConfigs": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/responses/a2a.tasks.ListTaskPushNotificationConfigs.schema.json", "title": "List push notification configs response", "description": "Read every active push-notification configuration of a task (A2A v1.0.1 section 3.1.9; JSON-RPC ListTaskPushNotificationConfigs; GET /tasks/{task_id}/pushNotificationConfigs).", "x-ess-name": "a2a.tasks.ListTaskPushNotificationConfigs", "x-ess-kind": "command-response", "type": "object", "properties": { "configs": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.TaskPushNotificationConfig" } }, "nextPageToken": { "x-ess-field": "next_page_token", "type": "string" } }, "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:02cb576547d10dd1b8e4f1101816b9fa4f6a130ee45112da3fe5e03c1bb79776", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.AuthenticationInfo": { "title": "AuthenticationInfo", "x-ess-name": "a2a.tasks.AuthenticationInfo", "x-ess-kind": "struct", "type": "object", "properties": { "scheme": { "type": "string" }, "credentials": { "type": "string" } }, "required": [ "scheme" ], "additionalProperties": false }, "a2a.tasks.PushNotificationConfigId": { "title": "PushNotificationConfigId", "x-ess-name": "a2a.tasks.PushNotificationConfigId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskPushNotificationConfig": { "title": "TaskPushNotificationConfig", "description": "The wire form of a push-notification configuration (proto TaskPushNotificationConfig).", "x-ess-name": "a2a.tasks.TaskPushNotificationConfig", "x-ess-kind": "struct", "type": "object", "properties": { "tenant": { "type": "string" }, "id": { "$ref": "#/$defs/a2a.tasks.PushNotificationConfigId" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "url": { "type": "string" }, "token": { "type": "string" }, "authentication": { "$ref": "#/$defs/a2a.tasks.AuthenticationInfo" } }, "required": [ "url" ], "additionalProperties": false } } }, "responses.a2a.tasks.SendMessage": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/responses/a2a.tasks.SendMessage.schema.json", "title": "Send message response", "description": "Send a message to the agent, which answers with a task tracking its work or with a direct message (A2A v1.0.1 section 3.1.1; JSON-RPC SendMessage; POST /message:send).", "x-ess-name": "a2a.tasks.SendMessage", "x-ess-kind": "command-response", "type": "object", "properties": { "task": { "$ref": "#/$defs/a2a.tasks.TaskSnapshot" }, "message": { "$ref": "#/$defs/a2a.tasks.Message", "x-ess-field": "reply" } }, "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:3ef52b5a545d19990f2a8ab31dc04a4f3039c65f4f906ed9726b1e6c1de23cc2", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.Artifact": { "title": "Artifact", "description": "An output the agent produced for a task (A2A v1.0.1 section 4.1.7).", "x-ess-name": "a2a.tasks.Artifact", "x-ess-kind": "struct", "type": "object", "properties": { "artifactId": { "x-ess-field": "artifact_id", "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } } }, "required": [ "artifactId", "parts" ], "additionalProperties": false }, "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Message": { "title": "Message", "description": "One turn of communication between client and agent (A2A v1.0.1 section 4.1.4).", "x-ess-name": "a2a.tasks.Message", "x-ess-kind": "struct", "type": "object", "properties": { "messageId": { "x-ess-field": "message_id", "type": "string" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "role": { "$ref": "#/$defs/a2a.tasks.Role" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } }, "referenceTaskIds": { "x-ess-field": "reference_task_ids", "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.TaskId" } } }, "required": [ "messageId", "role", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.Role": { "title": "Role", "x-ess-name": "a2a.tasks.Role", "x-ess-kind": "enum", "type": "string", "enum": [ "ROLE_USER", "ROLE_AGENT" ] }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskSnapshot": { "title": "TaskSnapshot", "description": "The wire form of a task, proto message Task (A2A v1.0.1 section 4.1.1).", "x-ess-name": "a2a.tasks.TaskSnapshot", "x-ess-kind": "struct", "type": "object", "properties": { "id": { "$ref": "#/$defs/a2a.tasks.TaskId" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "status": { "$ref": "#/$defs/a2a.tasks.TaskStatus" }, "artifacts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Artifact" } }, "history": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Message" } }, "metadata": {} }, "required": [ "id", "status" ], "additionalProperties": false }, "a2a.tasks.TaskState": { "title": "TaskState", "x-ess-name": "a2a.tasks.TaskState", "x-ess-kind": "enum", "type": "string", "enum": [ "TASK_STATE_SUBMITTED", "TASK_STATE_WORKING", "TASK_STATE_COMPLETED", "TASK_STATE_FAILED", "TASK_STATE_CANCELED", "TASK_STATE_INPUT_REQUIRED", "TASK_STATE_REJECTED", "TASK_STATE_AUTH_REQUIRED" ] }, "a2a.tasks.TaskStatus": { "title": "TaskStatus", "x-ess-name": "a2a.tasks.TaskStatus", "x-ess-kind": "struct", "type": "object", "properties": { "state": { "$ref": "#/$defs/a2a.tasks.TaskState" }, "message": { "$ref": "#/$defs/a2a.tasks.Message" }, "timestamp": { "type": "string", "format": "date-time" } }, "required": [ "state" ], "additionalProperties": false } } }, "responses.a2a.tasks.SendStreamingMessage": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/responses/a2a.tasks.SendStreamingMessage.schema.json", "title": "Send streaming message response", "description": "Send a message and stream the answer: one message, or the task followed by its status and artifact updates until it is terminal (A2A v1.0.1 section 3.1.2; JSON-RPC SendStreamingMessage; POST /message:stream).", "x-ess-name": "a2a.tasks.SendStreamingMessage", "x-ess-kind": "command-response", "type": "object", "properties": { "task": { "$ref": "#/$defs/a2a.tasks.TaskSnapshot" }, "message": { "$ref": "#/$defs/a2a.tasks.Message", "x-ess-field": "reply" } }, "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:542679646fed4ddff00d2e07f4bc3ff17943ccc0be46b0109ebd473dd3697ec7", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.Artifact": { "title": "Artifact", "description": "An output the agent produced for a task (A2A v1.0.1 section 4.1.7).", "x-ess-name": "a2a.tasks.Artifact", "x-ess-kind": "struct", "type": "object", "properties": { "artifactId": { "x-ess-field": "artifact_id", "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } } }, "required": [ "artifactId", "parts" ], "additionalProperties": false }, "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Message": { "title": "Message", "description": "One turn of communication between client and agent (A2A v1.0.1 section 4.1.4).", "x-ess-name": "a2a.tasks.Message", "x-ess-kind": "struct", "type": "object", "properties": { "messageId": { "x-ess-field": "message_id", "type": "string" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "role": { "$ref": "#/$defs/a2a.tasks.Role" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } }, "referenceTaskIds": { "x-ess-field": "reference_task_ids", "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.TaskId" } } }, "required": [ "messageId", "role", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.Role": { "title": "Role", "x-ess-name": "a2a.tasks.Role", "x-ess-kind": "enum", "type": "string", "enum": [ "ROLE_USER", "ROLE_AGENT" ] }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskSnapshot": { "title": "TaskSnapshot", "description": "The wire form of a task, proto message Task (A2A v1.0.1 section 4.1.1).", "x-ess-name": "a2a.tasks.TaskSnapshot", "x-ess-kind": "struct", "type": "object", "properties": { "id": { "$ref": "#/$defs/a2a.tasks.TaskId" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "status": { "$ref": "#/$defs/a2a.tasks.TaskStatus" }, "artifacts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Artifact" } }, "history": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Message" } }, "metadata": {} }, "required": [ "id", "status" ], "additionalProperties": false }, "a2a.tasks.TaskState": { "title": "TaskState", "x-ess-name": "a2a.tasks.TaskState", "x-ess-kind": "enum", "type": "string", "enum": [ "TASK_STATE_SUBMITTED", "TASK_STATE_WORKING", "TASK_STATE_COMPLETED", "TASK_STATE_FAILED", "TASK_STATE_CANCELED", "TASK_STATE_INPUT_REQUIRED", "TASK_STATE_REJECTED", "TASK_STATE_AUTH_REQUIRED" ] }, "a2a.tasks.TaskStatus": { "title": "TaskStatus", "x-ess-name": "a2a.tasks.TaskStatus", "x-ess-kind": "struct", "type": "object", "properties": { "state": { "$ref": "#/$defs/a2a.tasks.TaskState" }, "message": { "$ref": "#/$defs/a2a.tasks.Message" }, "timestamp": { "type": "string", "format": "date-time" } }, "required": [ "state" ], "additionalProperties": false } } }, "responses.a2a.tasks.SubscribeToTask": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/responses/a2a.tasks.SubscribeToTask.schema.json", "title": "Subscribe to task response", "description": "Open a stream of a task's updates, starting with the task itself (A2A v1.0.1 section 3.1.6; JSON-RPC SubscribeToTask; GET /tasks/{id}:subscribe).", "x-ess-name": "a2a.tasks.SubscribeToTask", "x-ess-kind": "command-response", "type": "object", "properties": { "task": { "$ref": "#/$defs/a2a.tasks.TaskSnapshot" } }, "required": [ "task" ], "additionalProperties": false, "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:c8e6695794dd29e5381a661e8caf96ab5388409e4f56e2b8c1cc2a2edb92b6ca", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.Artifact": { "title": "Artifact", "description": "An output the agent produced for a task (A2A v1.0.1 section 4.1.7).", "x-ess-name": "a2a.tasks.Artifact", "x-ess-kind": "struct", "type": "object", "properties": { "artifactId": { "x-ess-field": "artifact_id", "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } } }, "required": [ "artifactId", "parts" ], "additionalProperties": false }, "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Message": { "title": "Message", "description": "One turn of communication between client and agent (A2A v1.0.1 section 4.1.4).", "x-ess-name": "a2a.tasks.Message", "x-ess-kind": "struct", "type": "object", "properties": { "messageId": { "x-ess-field": "message_id", "type": "string" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "role": { "$ref": "#/$defs/a2a.tasks.Role" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } }, "referenceTaskIds": { "x-ess-field": "reference_task_ids", "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.TaskId" } } }, "required": [ "messageId", "role", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.Role": { "title": "Role", "x-ess-name": "a2a.tasks.Role", "x-ess-kind": "enum", "type": "string", "enum": [ "ROLE_USER", "ROLE_AGENT" ] }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskSnapshot": { "title": "TaskSnapshot", "description": "The wire form of a task, proto message Task (A2A v1.0.1 section 4.1.1).", "x-ess-name": "a2a.tasks.TaskSnapshot", "x-ess-kind": "struct", "type": "object", "properties": { "id": { "$ref": "#/$defs/a2a.tasks.TaskId" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "status": { "$ref": "#/$defs/a2a.tasks.TaskStatus" }, "artifacts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Artifact" } }, "history": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Message" } }, "metadata": {} }, "required": [ "id", "status" ], "additionalProperties": false }, "a2a.tasks.TaskState": { "title": "TaskState", "x-ess-name": "a2a.tasks.TaskState", "x-ess-kind": "enum", "type": "string", "enum": [ "TASK_STATE_SUBMITTED", "TASK_STATE_WORKING", "TASK_STATE_COMPLETED", "TASK_STATE_FAILED", "TASK_STATE_CANCELED", "TASK_STATE_INPUT_REQUIRED", "TASK_STATE_REJECTED", "TASK_STATE_AUTH_REQUIRED" ] }, "a2a.tasks.TaskStatus": { "title": "TaskStatus", "x-ess-name": "a2a.tasks.TaskStatus", "x-ess-kind": "struct", "type": "object", "properties": { "state": { "$ref": "#/$defs/a2a.tasks.TaskState" }, "message": { "$ref": "#/$defs/a2a.tasks.Message" }, "timestamp": { "type": "string", "format": "date-time" } }, "required": [ "state" ], "additionalProperties": false } } }, "types.a2a.discovery.APIKeySecurityScheme": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.discovery.APIKeySecurityScheme.schema.json", "$ref": "#/$defs/a2a.discovery.APIKeySecurityScheme", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:ff9e28c31a519eb2bc9ea22a9f329f9f63e36019b8700db572587301d5067871", "regenerate": "ess generate" }, "$defs": { "a2a.discovery.APIKeySecurityScheme": { "title": "APIKeySecurityScheme", "x-ess-name": "a2a.discovery.APIKeySecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "description": { "type": "string" }, "location": { "type": "string" }, "name": { "type": "string" } }, "required": [ "location", "name" ], "additionalProperties": false } } }, "types.a2a.discovery.AgentCapabilities": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.discovery.AgentCapabilities.schema.json", "$ref": "#/$defs/a2a.discovery.AgentCapabilities", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:4ac7383fa7f99f9cb16f6f93148bacd2a507590df1aebb7d6f5a7c3ab10f1842", "regenerate": "ess generate" }, "$defs": { "a2a.discovery.AgentCapabilities": { "title": "AgentCapabilities", "x-ess-name": "a2a.discovery.AgentCapabilities", "x-ess-kind": "struct", "type": "object", "properties": { "streaming": { "type": "boolean" }, "pushNotifications": { "x-ess-field": "push_notifications", "type": "boolean" }, "extensions": { "type": "array", "items": { "$ref": "#/$defs/a2a.discovery.AgentExtension" } }, "extendedAgentCard": { "x-ess-field": "extended_agent_card", "type": "boolean" } }, "additionalProperties": false }, "a2a.discovery.AgentExtension": { "title": "AgentExtension", "x-ess-name": "a2a.discovery.AgentExtension", "x-ess-kind": "struct", "type": "object", "properties": { "uri": { "type": "string" }, "description": { "type": "string" }, "required": { "type": "boolean" }, "params": {} }, "additionalProperties": false } } }, "types.a2a.discovery.AgentCard": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.discovery.AgentCard.schema.json", "$ref": "#/$defs/a2a.discovery.AgentCard", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:03db969e21c257e912037a6665f21cdbcebb48d18f742772e1c3ad032c58f819", "regenerate": "ess generate" }, "$defs": { "a2a.discovery.APIKeySecurityScheme": { "title": "APIKeySecurityScheme", "x-ess-name": "a2a.discovery.APIKeySecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "description": { "type": "string" }, "location": { "type": "string" }, "name": { "type": "string" } }, "required": [ "location", "name" ], "additionalProperties": false }, "a2a.discovery.AgentCapabilities": { "title": "AgentCapabilities", "x-ess-name": "a2a.discovery.AgentCapabilities", "x-ess-kind": "struct", "type": "object", "properties": { "streaming": { "type": "boolean" }, "pushNotifications": { "x-ess-field": "push_notifications", "type": "boolean" }, "extensions": { "type": "array", "items": { "$ref": "#/$defs/a2a.discovery.AgentExtension" } }, "extendedAgentCard": { "x-ess-field": "extended_agent_card", "type": "boolean" } }, "additionalProperties": false }, "a2a.discovery.AgentCard": { "title": "AgentCard", "description": "Self-describing manifest of an agent (A2A v1.0.1 section 4.4.1).", "x-ess-name": "a2a.discovery.AgentCard", "x-ess-kind": "struct", "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "supportedInterfaces": { "x-ess-field": "supported_interfaces", "type": "array", "items": { "$ref": "#/$defs/a2a.discovery.AgentInterface" } }, "provider": { "$ref": "#/$defs/a2a.discovery.AgentProvider" }, "version": { "type": "string" }, "documentationUrl": { "x-ess-field": "documentation_url", "type": "string" }, "capabilities": { "$ref": "#/$defs/a2a.discovery.AgentCapabilities" }, "securitySchemes": { "x-ess-field": "security_schemes", "type": "object", "additionalProperties": { "$ref": "#/$defs/a2a.discovery.SecurityScheme" }, "x-ess-map-key": "String" }, "securityRequirements": { "x-ess-field": "security_requirements", "type": "array", "items": { "$ref": "#/$defs/a2a.discovery.SecurityRequirement" } }, "defaultInputModes": { "x-ess-field": "default_input_modes", "type": "array", "items": { "type": "string" } }, "defaultOutputModes": { "x-ess-field": "default_output_modes", "type": "array", "items": { "type": "string" } }, "skills": { "type": "array", "items": { "$ref": "#/$defs/a2a.discovery.AgentSkill" } }, "signatures": { "type": "array", "items": { "$ref": "#/$defs/a2a.discovery.AgentCardSignature" } }, "iconUrl": { "x-ess-field": "icon_url", "type": "string" } }, "required": [ "name", "description", "supportedInterfaces", "version", "capabilities", "defaultInputModes", "defaultOutputModes", "skills" ], "additionalProperties": false }, "a2a.discovery.AgentCardSignature": { "title": "AgentCardSignature", "x-ess-name": "a2a.discovery.AgentCardSignature", "x-ess-kind": "struct", "type": "object", "properties": { "protected": { "type": "string" }, "signature": { "type": "string" }, "header": {} }, "required": [ "protected", "signature" ], "additionalProperties": false }, "a2a.discovery.AgentExtension": { "title": "AgentExtension", "x-ess-name": "a2a.discovery.AgentExtension", "x-ess-kind": "struct", "type": "object", "properties": { "uri": { "type": "string" }, "description": { "type": "string" }, "required": { "type": "boolean" }, "params": {} }, "additionalProperties": false }, "a2a.discovery.AgentInterface": { "title": "AgentInterface", "description": "A URL and protocol binding the agent is reached at (proto AgentInterface).", "x-ess-name": "a2a.discovery.AgentInterface", "x-ess-kind": "struct", "type": "object", "properties": { "url": { "type": "string" }, "protocolBinding": { "x-ess-field": "protocol_binding", "type": "string" }, "tenant": { "type": "string" }, "protocolVersion": { "x-ess-field": "protocol_version", "type": "string" } }, "required": [ "url", "protocolBinding", "protocolVersion" ], "additionalProperties": false }, "a2a.discovery.AgentProvider": { "title": "AgentProvider", "x-ess-name": "a2a.discovery.AgentProvider", "x-ess-kind": "struct", "type": "object", "properties": { "url": { "type": "string" }, "organization": { "type": "string" } }, "required": [ "url", "organization" ], "additionalProperties": false }, "a2a.discovery.AgentSkill": { "title": "AgentSkill", "x-ess-name": "a2a.discovery.AgentSkill", "x-ess-kind": "struct", "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "examples": { "type": "array", "items": { "type": "string" } }, "inputModes": { "x-ess-field": "input_modes", "type": "array", "items": { "type": "string" } }, "outputModes": { "x-ess-field": "output_modes", "type": "array", "items": { "type": "string" } }, "securityRequirements": { "x-ess-field": "security_requirements", "type": "array", "items": { "$ref": "#/$defs/a2a.discovery.SecurityRequirement" } } }, "required": [ "id", "name", "description", "tags" ], "additionalProperties": false }, "a2a.discovery.AuthorizationCodeOAuthFlow": { "title": "AuthorizationCodeOAuthFlow", "x-ess-name": "a2a.discovery.AuthorizationCodeOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "authorizationUrl": { "x-ess-field": "authorization_url", "type": "string" }, "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" }, "pkceRequired": { "x-ess-field": "pkce_required", "type": "boolean" } }, "required": [ "authorizationUrl", "tokenUrl", "scopes" ], "additionalProperties": false }, "a2a.discovery.ClientCredentialsOAuthFlow": { "title": "ClientCredentialsOAuthFlow", "x-ess-name": "a2a.discovery.ClientCredentialsOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "required": [ "tokenUrl", "scopes" ], "additionalProperties": false }, "a2a.discovery.DeviceCodeOAuthFlow": { "title": "DeviceCodeOAuthFlow", "x-ess-name": "a2a.discovery.DeviceCodeOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "deviceAuthorizationUrl": { "x-ess-field": "device_authorization_url", "type": "string" }, "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "required": [ "deviceAuthorizationUrl", "tokenUrl", "scopes" ], "additionalProperties": false }, "a2a.discovery.HTTPAuthSecurityScheme": { "title": "HTTPAuthSecurityScheme", "x-ess-name": "a2a.discovery.HTTPAuthSecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "description": { "type": "string" }, "scheme": { "type": "string" }, "bearerFormat": { "x-ess-field": "bearer_format", "type": "string" } }, "required": [ "scheme" ], "additionalProperties": false }, "a2a.discovery.ImplicitOAuthFlow": { "title": "ImplicitOAuthFlow", "description": "Deprecated in A2A v1.0.1.", "x-ess-name": "a2a.discovery.ImplicitOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "authorizationUrl": { "x-ess-field": "authorization_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "additionalProperties": false }, "a2a.discovery.MutualTlsSecurityScheme": { "title": "MutualTlsSecurityScheme", "x-ess-name": "a2a.discovery.MutualTlsSecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "description": { "type": "string" } }, "additionalProperties": false }, "a2a.discovery.OAuth2SecurityScheme": { "title": "OAuth2SecurityScheme", "x-ess-name": "a2a.discovery.OAuth2SecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "description": { "type": "string" }, "flows": { "$ref": "#/$defs/a2a.discovery.OAuthFlows" }, "oauth2MetadataUrl": { "x-ess-field": "oauth2_metadata_url", "type": "string" } }, "required": [ "flows" ], "additionalProperties": false }, "a2a.discovery.OAuthFlows": { "title": "OAuthFlows", "x-ess-name": "a2a.discovery.OAuthFlows", "x-ess-kind": "struct", "type": "object", "properties": { "authorizationCode": { "$ref": "#/$defs/a2a.discovery.AuthorizationCodeOAuthFlow", "x-ess-field": "authorization_code" }, "clientCredentials": { "$ref": "#/$defs/a2a.discovery.ClientCredentialsOAuthFlow", "x-ess-field": "client_credentials" }, "implicit": { "$ref": "#/$defs/a2a.discovery.ImplicitOAuthFlow" }, "password": { "$ref": "#/$defs/a2a.discovery.PasswordOAuthFlow" }, "deviceCode": { "$ref": "#/$defs/a2a.discovery.DeviceCodeOAuthFlow", "x-ess-field": "device_code" } }, "additionalProperties": false }, "a2a.discovery.OpenIdConnectSecurityScheme": { "title": "OpenIdConnectSecurityScheme", "x-ess-name": "a2a.discovery.OpenIdConnectSecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "description": { "type": "string" }, "openIdConnectUrl": { "x-ess-field": "open_id_connect_url", "type": "string" } }, "required": [ "openIdConnectUrl" ], "additionalProperties": false }, "a2a.discovery.PasswordOAuthFlow": { "title": "PasswordOAuthFlow", "description": "Deprecated in A2A v1.0.1.", "x-ess-name": "a2a.discovery.PasswordOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "additionalProperties": false }, "a2a.discovery.SecurityRequirement": { "title": "SecurityRequirement", "x-ess-name": "a2a.discovery.SecurityRequirement", "x-ess-kind": "struct", "type": "object", "properties": { "schemes": { "type": "object", "additionalProperties": { "$ref": "#/$defs/a2a.discovery.StringList" }, "x-ess-map-key": "String" } }, "required": [ "schemes" ], "additionalProperties": false }, "a2a.discovery.SecurityScheme": { "title": "SecurityScheme", "x-ess-name": "a2a.discovery.SecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "apiKeySecurityScheme": { "$ref": "#/$defs/a2a.discovery.APIKeySecurityScheme", "x-ess-field": "api_key_security_scheme" }, "httpAuthSecurityScheme": { "$ref": "#/$defs/a2a.discovery.HTTPAuthSecurityScheme", "x-ess-field": "http_auth_security_scheme" }, "oauth2SecurityScheme": { "$ref": "#/$defs/a2a.discovery.OAuth2SecurityScheme", "x-ess-field": "oauth2_security_scheme" }, "openIdConnectSecurityScheme": { "$ref": "#/$defs/a2a.discovery.OpenIdConnectSecurityScheme", "x-ess-field": "open_id_connect_security_scheme" }, "mtlsSecurityScheme": { "$ref": "#/$defs/a2a.discovery.MutualTlsSecurityScheme", "x-ess-field": "mtls_security_scheme" } }, "additionalProperties": false }, "a2a.discovery.StringList": { "title": "StringList", "x-ess-name": "a2a.discovery.StringList", "x-ess-kind": "struct", "type": "object", "properties": { "list": { "type": "array", "items": { "type": "string" } } }, "required": [ "list" ], "additionalProperties": false } } }, "types.a2a.discovery.AgentCardSignature": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.discovery.AgentCardSignature.schema.json", "$ref": "#/$defs/a2a.discovery.AgentCardSignature", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:0e0b4fff2856c251e77be1f09e8ce6d5c7910084c98c30a2b30a2fbb6868bb05", "regenerate": "ess generate" }, "$defs": { "a2a.discovery.AgentCardSignature": { "title": "AgentCardSignature", "x-ess-name": "a2a.discovery.AgentCardSignature", "x-ess-kind": "struct", "type": "object", "properties": { "protected": { "type": "string" }, "signature": { "type": "string" }, "header": {} }, "required": [ "protected", "signature" ], "additionalProperties": false } } }, "types.a2a.discovery.AgentExtension": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.discovery.AgentExtension.schema.json", "$ref": "#/$defs/a2a.discovery.AgentExtension", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:790d59a9f34b19c5a585e3a94d6937cf4a0fccbd67204ed0e577aaa113934f27", "regenerate": "ess generate" }, "$defs": { "a2a.discovery.AgentExtension": { "title": "AgentExtension", "x-ess-name": "a2a.discovery.AgentExtension", "x-ess-kind": "struct", "type": "object", "properties": { "uri": { "type": "string" }, "description": { "type": "string" }, "required": { "type": "boolean" }, "params": {} }, "additionalProperties": false } } }, "types.a2a.discovery.AgentInterface": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.discovery.AgentInterface.schema.json", "$ref": "#/$defs/a2a.discovery.AgentInterface", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:b2b41dbc6b619759eff8f5d035734781be5eea39ab252d751ca85075c4eb944c", "regenerate": "ess generate" }, "$defs": { "a2a.discovery.AgentInterface": { "title": "AgentInterface", "description": "A URL and protocol binding the agent is reached at (proto AgentInterface).", "x-ess-name": "a2a.discovery.AgentInterface", "x-ess-kind": "struct", "type": "object", "properties": { "url": { "type": "string" }, "protocolBinding": { "x-ess-field": "protocol_binding", "type": "string" }, "tenant": { "type": "string" }, "protocolVersion": { "x-ess-field": "protocol_version", "type": "string" } }, "required": [ "url", "protocolBinding", "protocolVersion" ], "additionalProperties": false } } }, "types.a2a.discovery.AgentProvider": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.discovery.AgentProvider.schema.json", "$ref": "#/$defs/a2a.discovery.AgentProvider", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:0677e7ad7c0fcb3ec3a3c27b76e5adcc43e040a821bb8509cdb59ad4290c234e", "regenerate": "ess generate" }, "$defs": { "a2a.discovery.AgentProvider": { "title": "AgentProvider", "x-ess-name": "a2a.discovery.AgentProvider", "x-ess-kind": "struct", "type": "object", "properties": { "url": { "type": "string" }, "organization": { "type": "string" } }, "required": [ "url", "organization" ], "additionalProperties": false } } }, "types.a2a.discovery.AgentSkill": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.discovery.AgentSkill.schema.json", "$ref": "#/$defs/a2a.discovery.AgentSkill", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:430ddf6b57385fb2bab83bc04f27bae55f3ddc5ec203bd1049d183a412003301", "regenerate": "ess generate" }, "$defs": { "a2a.discovery.AgentSkill": { "title": "AgentSkill", "x-ess-name": "a2a.discovery.AgentSkill", "x-ess-kind": "struct", "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "examples": { "type": "array", "items": { "type": "string" } }, "inputModes": { "x-ess-field": "input_modes", "type": "array", "items": { "type": "string" } }, "outputModes": { "x-ess-field": "output_modes", "type": "array", "items": { "type": "string" } }, "securityRequirements": { "x-ess-field": "security_requirements", "type": "array", "items": { "$ref": "#/$defs/a2a.discovery.SecurityRequirement" } } }, "required": [ "id", "name", "description", "tags" ], "additionalProperties": false }, "a2a.discovery.SecurityRequirement": { "title": "SecurityRequirement", "x-ess-name": "a2a.discovery.SecurityRequirement", "x-ess-kind": "struct", "type": "object", "properties": { "schemes": { "type": "object", "additionalProperties": { "$ref": "#/$defs/a2a.discovery.StringList" }, "x-ess-map-key": "String" } }, "required": [ "schemes" ], "additionalProperties": false }, "a2a.discovery.StringList": { "title": "StringList", "x-ess-name": "a2a.discovery.StringList", "x-ess-kind": "struct", "type": "object", "properties": { "list": { "type": "array", "items": { "type": "string" } } }, "required": [ "list" ], "additionalProperties": false } } }, "types.a2a.discovery.AuthorizationCodeOAuthFlow": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.discovery.AuthorizationCodeOAuthFlow.schema.json", "$ref": "#/$defs/a2a.discovery.AuthorizationCodeOAuthFlow", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:81eb4e073e12ddf40a7545172f39cf9623b7a361a8bcabb9f70e65fbe0943366", "regenerate": "ess generate" }, "$defs": { "a2a.discovery.AuthorizationCodeOAuthFlow": { "title": "AuthorizationCodeOAuthFlow", "x-ess-name": "a2a.discovery.AuthorizationCodeOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "authorizationUrl": { "x-ess-field": "authorization_url", "type": "string" }, "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" }, "pkceRequired": { "x-ess-field": "pkce_required", "type": "boolean" } }, "required": [ "authorizationUrl", "tokenUrl", "scopes" ], "additionalProperties": false } } }, "types.a2a.discovery.ClientCredentialsOAuthFlow": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.discovery.ClientCredentialsOAuthFlow.schema.json", "$ref": "#/$defs/a2a.discovery.ClientCredentialsOAuthFlow", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:6bed461df6b66b5311c5c9611427a8dedb394fa3ca936d245f81fd66877d5fe5", "regenerate": "ess generate" }, "$defs": { "a2a.discovery.ClientCredentialsOAuthFlow": { "title": "ClientCredentialsOAuthFlow", "x-ess-name": "a2a.discovery.ClientCredentialsOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "required": [ "tokenUrl", "scopes" ], "additionalProperties": false } } }, "types.a2a.discovery.DeviceCodeOAuthFlow": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.discovery.DeviceCodeOAuthFlow.schema.json", "$ref": "#/$defs/a2a.discovery.DeviceCodeOAuthFlow", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:62d6d6fb03d1a978fa1a3c6f3809dc4788224d337d8762c2881bb379bde37e03", "regenerate": "ess generate" }, "$defs": { "a2a.discovery.DeviceCodeOAuthFlow": { "title": "DeviceCodeOAuthFlow", "x-ess-name": "a2a.discovery.DeviceCodeOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "deviceAuthorizationUrl": { "x-ess-field": "device_authorization_url", "type": "string" }, "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "required": [ "deviceAuthorizationUrl", "tokenUrl", "scopes" ], "additionalProperties": false } } }, "types.a2a.discovery.HTTPAuthSecurityScheme": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.discovery.HTTPAuthSecurityScheme.schema.json", "$ref": "#/$defs/a2a.discovery.HTTPAuthSecurityScheme", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:276e1c6320429d52b7975093e3d6bc75c80e507736bbd85eaaa1e5a8ba9d80a5", "regenerate": "ess generate" }, "$defs": { "a2a.discovery.HTTPAuthSecurityScheme": { "title": "HTTPAuthSecurityScheme", "x-ess-name": "a2a.discovery.HTTPAuthSecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "description": { "type": "string" }, "scheme": { "type": "string" }, "bearerFormat": { "x-ess-field": "bearer_format", "type": "string" } }, "required": [ "scheme" ], "additionalProperties": false } } }, "types.a2a.discovery.ImplicitOAuthFlow": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.discovery.ImplicitOAuthFlow.schema.json", "$ref": "#/$defs/a2a.discovery.ImplicitOAuthFlow", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:bc3a9592292c90eee3173c97ec7c7489015eac21e1a1a3a739b1ccb209f29d7e", "regenerate": "ess generate" }, "$defs": { "a2a.discovery.ImplicitOAuthFlow": { "title": "ImplicitOAuthFlow", "description": "Deprecated in A2A v1.0.1.", "x-ess-name": "a2a.discovery.ImplicitOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "authorizationUrl": { "x-ess-field": "authorization_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "additionalProperties": false } } }, "types.a2a.discovery.MutualTlsSecurityScheme": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.discovery.MutualTlsSecurityScheme.schema.json", "$ref": "#/$defs/a2a.discovery.MutualTlsSecurityScheme", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:1baa7297acd4ef55b5d4628575cb4f21e5c11c131277d4d3153d0d95b44a2459", "regenerate": "ess generate" }, "$defs": { "a2a.discovery.MutualTlsSecurityScheme": { "title": "MutualTlsSecurityScheme", "x-ess-name": "a2a.discovery.MutualTlsSecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "description": { "type": "string" } }, "additionalProperties": false } } }, "types.a2a.discovery.OAuth2SecurityScheme": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.discovery.OAuth2SecurityScheme.schema.json", "$ref": "#/$defs/a2a.discovery.OAuth2SecurityScheme", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:c33a1fcd8b7ae64392898077df49f038fadf7c4001dc24e03f1f2677e4b3aa04", "regenerate": "ess generate" }, "$defs": { "a2a.discovery.AuthorizationCodeOAuthFlow": { "title": "AuthorizationCodeOAuthFlow", "x-ess-name": "a2a.discovery.AuthorizationCodeOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "authorizationUrl": { "x-ess-field": "authorization_url", "type": "string" }, "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" }, "pkceRequired": { "x-ess-field": "pkce_required", "type": "boolean" } }, "required": [ "authorizationUrl", "tokenUrl", "scopes" ], "additionalProperties": false }, "a2a.discovery.ClientCredentialsOAuthFlow": { "title": "ClientCredentialsOAuthFlow", "x-ess-name": "a2a.discovery.ClientCredentialsOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "required": [ "tokenUrl", "scopes" ], "additionalProperties": false }, "a2a.discovery.DeviceCodeOAuthFlow": { "title": "DeviceCodeOAuthFlow", "x-ess-name": "a2a.discovery.DeviceCodeOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "deviceAuthorizationUrl": { "x-ess-field": "device_authorization_url", "type": "string" }, "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "required": [ "deviceAuthorizationUrl", "tokenUrl", "scopes" ], "additionalProperties": false }, "a2a.discovery.ImplicitOAuthFlow": { "title": "ImplicitOAuthFlow", "description": "Deprecated in A2A v1.0.1.", "x-ess-name": "a2a.discovery.ImplicitOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "authorizationUrl": { "x-ess-field": "authorization_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "additionalProperties": false }, "a2a.discovery.OAuth2SecurityScheme": { "title": "OAuth2SecurityScheme", "x-ess-name": "a2a.discovery.OAuth2SecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "description": { "type": "string" }, "flows": { "$ref": "#/$defs/a2a.discovery.OAuthFlows" }, "oauth2MetadataUrl": { "x-ess-field": "oauth2_metadata_url", "type": "string" } }, "required": [ "flows" ], "additionalProperties": false }, "a2a.discovery.OAuthFlows": { "title": "OAuthFlows", "x-ess-name": "a2a.discovery.OAuthFlows", "x-ess-kind": "struct", "type": "object", "properties": { "authorizationCode": { "$ref": "#/$defs/a2a.discovery.AuthorizationCodeOAuthFlow", "x-ess-field": "authorization_code" }, "clientCredentials": { "$ref": "#/$defs/a2a.discovery.ClientCredentialsOAuthFlow", "x-ess-field": "client_credentials" }, "implicit": { "$ref": "#/$defs/a2a.discovery.ImplicitOAuthFlow" }, "password": { "$ref": "#/$defs/a2a.discovery.PasswordOAuthFlow" }, "deviceCode": { "$ref": "#/$defs/a2a.discovery.DeviceCodeOAuthFlow", "x-ess-field": "device_code" } }, "additionalProperties": false }, "a2a.discovery.PasswordOAuthFlow": { "title": "PasswordOAuthFlow", "description": "Deprecated in A2A v1.0.1.", "x-ess-name": "a2a.discovery.PasswordOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "additionalProperties": false } } }, "types.a2a.discovery.OAuthFlows": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.discovery.OAuthFlows.schema.json", "$ref": "#/$defs/a2a.discovery.OAuthFlows", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:272c05a460a60fb6860602830c139e2afb69d035b0e5f2929964e71e26d6cc62", "regenerate": "ess generate" }, "$defs": { "a2a.discovery.AuthorizationCodeOAuthFlow": { "title": "AuthorizationCodeOAuthFlow", "x-ess-name": "a2a.discovery.AuthorizationCodeOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "authorizationUrl": { "x-ess-field": "authorization_url", "type": "string" }, "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" }, "pkceRequired": { "x-ess-field": "pkce_required", "type": "boolean" } }, "required": [ "authorizationUrl", "tokenUrl", "scopes" ], "additionalProperties": false }, "a2a.discovery.ClientCredentialsOAuthFlow": { "title": "ClientCredentialsOAuthFlow", "x-ess-name": "a2a.discovery.ClientCredentialsOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "required": [ "tokenUrl", "scopes" ], "additionalProperties": false }, "a2a.discovery.DeviceCodeOAuthFlow": { "title": "DeviceCodeOAuthFlow", "x-ess-name": "a2a.discovery.DeviceCodeOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "deviceAuthorizationUrl": { "x-ess-field": "device_authorization_url", "type": "string" }, "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "required": [ "deviceAuthorizationUrl", "tokenUrl", "scopes" ], "additionalProperties": false }, "a2a.discovery.ImplicitOAuthFlow": { "title": "ImplicitOAuthFlow", "description": "Deprecated in A2A v1.0.1.", "x-ess-name": "a2a.discovery.ImplicitOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "authorizationUrl": { "x-ess-field": "authorization_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "additionalProperties": false }, "a2a.discovery.OAuthFlows": { "title": "OAuthFlows", "x-ess-name": "a2a.discovery.OAuthFlows", "x-ess-kind": "struct", "type": "object", "properties": { "authorizationCode": { "$ref": "#/$defs/a2a.discovery.AuthorizationCodeOAuthFlow", "x-ess-field": "authorization_code" }, "clientCredentials": { "$ref": "#/$defs/a2a.discovery.ClientCredentialsOAuthFlow", "x-ess-field": "client_credentials" }, "implicit": { "$ref": "#/$defs/a2a.discovery.ImplicitOAuthFlow" }, "password": { "$ref": "#/$defs/a2a.discovery.PasswordOAuthFlow" }, "deviceCode": { "$ref": "#/$defs/a2a.discovery.DeviceCodeOAuthFlow", "x-ess-field": "device_code" } }, "additionalProperties": false }, "a2a.discovery.PasswordOAuthFlow": { "title": "PasswordOAuthFlow", "description": "Deprecated in A2A v1.0.1.", "x-ess-name": "a2a.discovery.PasswordOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "additionalProperties": false } } }, "types.a2a.discovery.OpenIdConnectSecurityScheme": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.discovery.OpenIdConnectSecurityScheme.schema.json", "$ref": "#/$defs/a2a.discovery.OpenIdConnectSecurityScheme", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:75deede11da3b328e796d0f4b182579cf1ee4a7979abd044480e1e6799003b7b", "regenerate": "ess generate" }, "$defs": { "a2a.discovery.OpenIdConnectSecurityScheme": { "title": "OpenIdConnectSecurityScheme", "x-ess-name": "a2a.discovery.OpenIdConnectSecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "description": { "type": "string" }, "openIdConnectUrl": { "x-ess-field": "open_id_connect_url", "type": "string" } }, "required": [ "openIdConnectUrl" ], "additionalProperties": false } } }, "types.a2a.discovery.PasswordOAuthFlow": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.discovery.PasswordOAuthFlow.schema.json", "$ref": "#/$defs/a2a.discovery.PasswordOAuthFlow", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:c1a75c81796269cdfe3e355d6c4eb2212d7a781b3605210394620193a64250cb", "regenerate": "ess generate" }, "$defs": { "a2a.discovery.PasswordOAuthFlow": { "title": "PasswordOAuthFlow", "description": "Deprecated in A2A v1.0.1.", "x-ess-name": "a2a.discovery.PasswordOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "additionalProperties": false } } }, "types.a2a.discovery.SecurityRequirement": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.discovery.SecurityRequirement.schema.json", "$ref": "#/$defs/a2a.discovery.SecurityRequirement", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:1bfc738aabe7d59eb35e5b0946340c379c8e1a692a00e6ec9bb8c4dcc77dfb02", "regenerate": "ess generate" }, "$defs": { "a2a.discovery.SecurityRequirement": { "title": "SecurityRequirement", "x-ess-name": "a2a.discovery.SecurityRequirement", "x-ess-kind": "struct", "type": "object", "properties": { "schemes": { "type": "object", "additionalProperties": { "$ref": "#/$defs/a2a.discovery.StringList" }, "x-ess-map-key": "String" } }, "required": [ "schemes" ], "additionalProperties": false }, "a2a.discovery.StringList": { "title": "StringList", "x-ess-name": "a2a.discovery.StringList", "x-ess-kind": "struct", "type": "object", "properties": { "list": { "type": "array", "items": { "type": "string" } } }, "required": [ "list" ], "additionalProperties": false } } }, "types.a2a.discovery.SecurityScheme": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.discovery.SecurityScheme.schema.json", "$ref": "#/$defs/a2a.discovery.SecurityScheme", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:f96537908d4323cd21e2b95798dc1b587d82c1292ef8357b29d71bb1e7bf1078", "regenerate": "ess generate" }, "$defs": { "a2a.discovery.APIKeySecurityScheme": { "title": "APIKeySecurityScheme", "x-ess-name": "a2a.discovery.APIKeySecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "description": { "type": "string" }, "location": { "type": "string" }, "name": { "type": "string" } }, "required": [ "location", "name" ], "additionalProperties": false }, "a2a.discovery.AuthorizationCodeOAuthFlow": { "title": "AuthorizationCodeOAuthFlow", "x-ess-name": "a2a.discovery.AuthorizationCodeOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "authorizationUrl": { "x-ess-field": "authorization_url", "type": "string" }, "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" }, "pkceRequired": { "x-ess-field": "pkce_required", "type": "boolean" } }, "required": [ "authorizationUrl", "tokenUrl", "scopes" ], "additionalProperties": false }, "a2a.discovery.ClientCredentialsOAuthFlow": { "title": "ClientCredentialsOAuthFlow", "x-ess-name": "a2a.discovery.ClientCredentialsOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "required": [ "tokenUrl", "scopes" ], "additionalProperties": false }, "a2a.discovery.DeviceCodeOAuthFlow": { "title": "DeviceCodeOAuthFlow", "x-ess-name": "a2a.discovery.DeviceCodeOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "deviceAuthorizationUrl": { "x-ess-field": "device_authorization_url", "type": "string" }, "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "required": [ "deviceAuthorizationUrl", "tokenUrl", "scopes" ], "additionalProperties": false }, "a2a.discovery.HTTPAuthSecurityScheme": { "title": "HTTPAuthSecurityScheme", "x-ess-name": "a2a.discovery.HTTPAuthSecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "description": { "type": "string" }, "scheme": { "type": "string" }, "bearerFormat": { "x-ess-field": "bearer_format", "type": "string" } }, "required": [ "scheme" ], "additionalProperties": false }, "a2a.discovery.ImplicitOAuthFlow": { "title": "ImplicitOAuthFlow", "description": "Deprecated in A2A v1.0.1.", "x-ess-name": "a2a.discovery.ImplicitOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "authorizationUrl": { "x-ess-field": "authorization_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "additionalProperties": false }, "a2a.discovery.MutualTlsSecurityScheme": { "title": "MutualTlsSecurityScheme", "x-ess-name": "a2a.discovery.MutualTlsSecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "description": { "type": "string" } }, "additionalProperties": false }, "a2a.discovery.OAuth2SecurityScheme": { "title": "OAuth2SecurityScheme", "x-ess-name": "a2a.discovery.OAuth2SecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "description": { "type": "string" }, "flows": { "$ref": "#/$defs/a2a.discovery.OAuthFlows" }, "oauth2MetadataUrl": { "x-ess-field": "oauth2_metadata_url", "type": "string" } }, "required": [ "flows" ], "additionalProperties": false }, "a2a.discovery.OAuthFlows": { "title": "OAuthFlows", "x-ess-name": "a2a.discovery.OAuthFlows", "x-ess-kind": "struct", "type": "object", "properties": { "authorizationCode": { "$ref": "#/$defs/a2a.discovery.AuthorizationCodeOAuthFlow", "x-ess-field": "authorization_code" }, "clientCredentials": { "$ref": "#/$defs/a2a.discovery.ClientCredentialsOAuthFlow", "x-ess-field": "client_credentials" }, "implicit": { "$ref": "#/$defs/a2a.discovery.ImplicitOAuthFlow" }, "password": { "$ref": "#/$defs/a2a.discovery.PasswordOAuthFlow" }, "deviceCode": { "$ref": "#/$defs/a2a.discovery.DeviceCodeOAuthFlow", "x-ess-field": "device_code" } }, "additionalProperties": false }, "a2a.discovery.OpenIdConnectSecurityScheme": { "title": "OpenIdConnectSecurityScheme", "x-ess-name": "a2a.discovery.OpenIdConnectSecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "description": { "type": "string" }, "openIdConnectUrl": { "x-ess-field": "open_id_connect_url", "type": "string" } }, "required": [ "openIdConnectUrl" ], "additionalProperties": false }, "a2a.discovery.PasswordOAuthFlow": { "title": "PasswordOAuthFlow", "description": "Deprecated in A2A v1.0.1.", "x-ess-name": "a2a.discovery.PasswordOAuthFlow", "x-ess-kind": "struct", "type": "object", "properties": { "tokenUrl": { "x-ess-field": "token_url", "type": "string" }, "refreshUrl": { "x-ess-field": "refresh_url", "type": "string" }, "scopes": { "type": "object", "additionalProperties": { "type": "string" }, "x-ess-map-key": "String" } }, "additionalProperties": false }, "a2a.discovery.SecurityScheme": { "title": "SecurityScheme", "x-ess-name": "a2a.discovery.SecurityScheme", "x-ess-kind": "struct", "type": "object", "properties": { "apiKeySecurityScheme": { "$ref": "#/$defs/a2a.discovery.APIKeySecurityScheme", "x-ess-field": "api_key_security_scheme" }, "httpAuthSecurityScheme": { "$ref": "#/$defs/a2a.discovery.HTTPAuthSecurityScheme", "x-ess-field": "http_auth_security_scheme" }, "oauth2SecurityScheme": { "$ref": "#/$defs/a2a.discovery.OAuth2SecurityScheme", "x-ess-field": "oauth2_security_scheme" }, "openIdConnectSecurityScheme": { "$ref": "#/$defs/a2a.discovery.OpenIdConnectSecurityScheme", "x-ess-field": "open_id_connect_security_scheme" }, "mtlsSecurityScheme": { "$ref": "#/$defs/a2a.discovery.MutualTlsSecurityScheme", "x-ess-field": "mtls_security_scheme" } }, "additionalProperties": false } } }, "types.a2a.discovery.StringList": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.discovery.StringList.schema.json", "$ref": "#/$defs/a2a.discovery.StringList", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:a679c1aa3e21e3f80021c9b7fb58c5477bd8e66065ca259445e07966a53a5d4a", "regenerate": "ess generate" }, "$defs": { "a2a.discovery.StringList": { "title": "StringList", "x-ess-name": "a2a.discovery.StringList", "x-ess-kind": "struct", "type": "object", "properties": { "list": { "type": "array", "items": { "type": "string" } } }, "required": [ "list" ], "additionalProperties": false } } }, "types.a2a.tasks.Artifact": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.tasks.Artifact.schema.json", "$ref": "#/$defs/a2a.tasks.Artifact", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:beef30766fd0524890b94edf104238c38b42c21d654235d84b4f738db54e529e", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.Artifact": { "title": "Artifact", "description": "An output the agent produced for a task (A2A v1.0.1 section 4.1.7).", "x-ess-name": "a2a.tasks.Artifact", "x-ess-kind": "struct", "type": "object", "properties": { "artifactId": { "x-ess-field": "artifact_id", "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } } }, "required": [ "artifactId", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false } } }, "types.a2a.tasks.AuthenticationInfo": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.tasks.AuthenticationInfo.schema.json", "$ref": "#/$defs/a2a.tasks.AuthenticationInfo", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:a6a42a2ca30d4a550b3262bd19982e568d6c6a4275348166b451e3c9f0de287f", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.AuthenticationInfo": { "title": "AuthenticationInfo", "x-ess-name": "a2a.tasks.AuthenticationInfo", "x-ess-kind": "struct", "type": "object", "properties": { "scheme": { "type": "string" }, "credentials": { "type": "string" } }, "required": [ "scheme" ], "additionalProperties": false } } }, "types.a2a.tasks.ContextId": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.tasks.ContextId.schema.json", "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:843b38418f71ab8f68c9383fe023026833541a1ebfc1f2d929e25c7d616fa5df", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" } } }, "types.a2a.tasks.Message": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.tasks.Message.schema.json", "$ref": "#/$defs/a2a.tasks.Message", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:869603560f972beb8f3eae5d1ddbed17e74a014003e6755ebc6f0496769c9f67", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Message": { "title": "Message", "description": "One turn of communication between client and agent (A2A v1.0.1 section 4.1.4).", "x-ess-name": "a2a.tasks.Message", "x-ess-kind": "struct", "type": "object", "properties": { "messageId": { "x-ess-field": "message_id", "type": "string" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "role": { "$ref": "#/$defs/a2a.tasks.Role" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } }, "referenceTaskIds": { "x-ess-field": "reference_task_ids", "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.TaskId" } } }, "required": [ "messageId", "role", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.Role": { "title": "Role", "x-ess-name": "a2a.tasks.Role", "x-ess-kind": "enum", "type": "string", "enum": [ "ROLE_USER", "ROLE_AGENT" ] }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "types.a2a.tasks.Part": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.tasks.Part.schema.json", "$ref": "#/$defs/a2a.tasks.Part", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:d21100abe7db4350ea95289d72b43c6bfc02aedf4745b497132f8319f3b4fad6", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false } } }, "types.a2a.tasks.PushNotificationConfig.State": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.tasks.PushNotificationConfig.State.schema.json", "$ref": "#/$defs/a2a.tasks.PushNotificationConfig.State", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:6a73eb5c1b2653fe305e0db6a9cf63fe24742b027871e189dffae9714a883487", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.PushNotificationConfig.State": { "title": "State", "x-ess-name": "a2a.tasks.PushNotificationConfig.State", "x-ess-kind": "enum", "type": "string", "enum": [ "Active" ] } } }, "types.a2a.tasks.PushNotificationConfigId": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.tasks.PushNotificationConfigId.schema.json", "$ref": "#/$defs/a2a.tasks.PushNotificationConfigId", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:6bf4f4153c15aac6bc30e8e6b38d1085dd8b62e510c5d92a15eb637ca36510c1", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.PushNotificationConfigId": { "title": "PushNotificationConfigId", "x-ess-name": "a2a.tasks.PushNotificationConfigId", "x-ess-kind": "newtype", "type": "string" } } }, "types.a2a.tasks.PushNotificationConfigRow": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.tasks.PushNotificationConfigRow.schema.json", "$ref": "#/$defs/a2a.tasks.PushNotificationConfigRow", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:18a15c79f221f450aac5eb4013f168b88f0e34a12a1743e4750fe94cb127c882", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.PushNotificationConfigRow": { "title": "PushNotificationConfigRow", "x-ess-name": "a2a.tasks.PushNotificationConfigRow", "x-ess-kind": "newtype", "type": "string" } } }, "types.a2a.tasks.Role": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.tasks.Role.schema.json", "$ref": "#/$defs/a2a.tasks.Role", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:7799f3712f2bf73077d8b7a117c0c74d1a3e1b2778d7e1e2da802913934134f9", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.Role": { "title": "Role", "x-ess-name": "a2a.tasks.Role", "x-ess-kind": "enum", "type": "string", "enum": [ "ROLE_USER", "ROLE_AGENT" ] } } }, "types.a2a.tasks.SendMessageConfiguration": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.tasks.SendMessageConfiguration.schema.json", "$ref": "#/$defs/a2a.tasks.SendMessageConfiguration", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:7c98bfc9ff05b85ca949f19df79e7192a23a6f69468be6e606ce95dcfe89c361", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.AuthenticationInfo": { "title": "AuthenticationInfo", "x-ess-name": "a2a.tasks.AuthenticationInfo", "x-ess-kind": "struct", "type": "object", "properties": { "scheme": { "type": "string" }, "credentials": { "type": "string" } }, "required": [ "scheme" ], "additionalProperties": false }, "a2a.tasks.PushNotificationConfigId": { "title": "PushNotificationConfigId", "x-ess-name": "a2a.tasks.PushNotificationConfigId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.SendMessageConfiguration": { "title": "SendMessageConfiguration", "x-ess-name": "a2a.tasks.SendMessageConfiguration", "x-ess-kind": "struct", "type": "object", "properties": { "acceptedOutputModes": { "x-ess-field": "accepted_output_modes", "type": "array", "items": { "type": "string" } }, "taskPushNotificationConfig": { "$ref": "#/$defs/a2a.tasks.TaskPushNotificationConfig", "x-ess-field": "task_push_notification_config" }, "historyLength": { "x-ess-field": "history_length", "type": "integer" }, "returnImmediately": { "x-ess-field": "return_immediately", "type": "boolean" } }, "additionalProperties": false }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskPushNotificationConfig": { "title": "TaskPushNotificationConfig", "description": "The wire form of a push-notification configuration (proto TaskPushNotificationConfig).", "x-ess-name": "a2a.tasks.TaskPushNotificationConfig", "x-ess-kind": "struct", "type": "object", "properties": { "tenant": { "type": "string" }, "id": { "$ref": "#/$defs/a2a.tasks.PushNotificationConfigId" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "url": { "type": "string" }, "token": { "type": "string" }, "authentication": { "$ref": "#/$defs/a2a.tasks.AuthenticationInfo" } }, "required": [ "url" ], "additionalProperties": false } } }, "types.a2a.tasks.Task.State": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.tasks.Task.State.schema.json", "$ref": "#/$defs/a2a.tasks.Task.State", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:7a29911656ec061b892b16162c765d2b415f57c74738f915ced18e1afa08baaf", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.Task.State": { "title": "State", "x-ess-name": "a2a.tasks.Task.State", "x-ess-kind": "enum", "type": "string", "enum": [ "AuthRequired", "Canceled", "Completed", "Failed", "InputRequired", "Rejected", "Submitted", "Working" ] } } }, "types.a2a.tasks.TaskArtifactUpdateEvent": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.tasks.TaskArtifactUpdateEvent.schema.json", "$ref": "#/$defs/a2a.tasks.TaskArtifactUpdateEvent", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:0988d0573b8c2b4832358f7dc117ac04dd1bc76ae2d13d355bba987dd18ab2b0", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.Artifact": { "title": "Artifact", "description": "An output the agent produced for a task (A2A v1.0.1 section 4.1.7).", "x-ess-name": "a2a.tasks.Artifact", "x-ess-kind": "struct", "type": "object", "properties": { "artifactId": { "x-ess-field": "artifact_id", "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } } }, "required": [ "artifactId", "parts" ], "additionalProperties": false }, "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.TaskArtifactUpdateEvent": { "title": "TaskArtifactUpdateEvent", "description": "\"A task delta where an artifact has been generated\" (a2a.proto TaskArtifactUpdateEvent; A2A v1.0.1 section 4.2.2).", "x-ess-name": "a2a.tasks.TaskArtifactUpdateEvent", "x-ess-kind": "struct", "type": "object", "properties": { "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "artifact": { "$ref": "#/$defs/a2a.tasks.Artifact" }, "append": { "type": "boolean" }, "lastChunk": { "x-ess-field": "last_chunk", "type": "boolean" }, "metadata": {} }, "required": [ "taskId", "contextId", "artifact" ], "additionalProperties": false }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "types.a2a.tasks.TaskId": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.tasks.TaskId.schema.json", "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:633bd00b2988c20711e7a5d1c7de95ff57a7d37fe6061a7ec2ab565bfa82507e", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" } } }, "types.a2a.tasks.TaskPushNotificationConfig": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.tasks.TaskPushNotificationConfig.schema.json", "$ref": "#/$defs/a2a.tasks.TaskPushNotificationConfig", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:1a2572d02a4c71438903c836ac3fc771a3cc3977db73ee9ea32011bb57c0a285", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.AuthenticationInfo": { "title": "AuthenticationInfo", "x-ess-name": "a2a.tasks.AuthenticationInfo", "x-ess-kind": "struct", "type": "object", "properties": { "scheme": { "type": "string" }, "credentials": { "type": "string" } }, "required": [ "scheme" ], "additionalProperties": false }, "a2a.tasks.PushNotificationConfigId": { "title": "PushNotificationConfigId", "x-ess-name": "a2a.tasks.PushNotificationConfigId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskPushNotificationConfig": { "title": "TaskPushNotificationConfig", "description": "The wire form of a push-notification configuration (proto TaskPushNotificationConfig).", "x-ess-name": "a2a.tasks.TaskPushNotificationConfig", "x-ess-kind": "struct", "type": "object", "properties": { "tenant": { "type": "string" }, "id": { "$ref": "#/$defs/a2a.tasks.PushNotificationConfigId" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "url": { "type": "string" }, "token": { "type": "string" }, "authentication": { "$ref": "#/$defs/a2a.tasks.AuthenticationInfo" } }, "required": [ "url" ], "additionalProperties": false } } }, "types.a2a.tasks.TaskSnapshot": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.tasks.TaskSnapshot.schema.json", "$ref": "#/$defs/a2a.tasks.TaskSnapshot", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:fa92c7437ff189efd0c42f2cb54e2acc5f33b4a569403c2992a8deedb4708e9a", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.Artifact": { "title": "Artifact", "description": "An output the agent produced for a task (A2A v1.0.1 section 4.1.7).", "x-ess-name": "a2a.tasks.Artifact", "x-ess-kind": "struct", "type": "object", "properties": { "artifactId": { "x-ess-field": "artifact_id", "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } } }, "required": [ "artifactId", "parts" ], "additionalProperties": false }, "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Message": { "title": "Message", "description": "One turn of communication between client and agent (A2A v1.0.1 section 4.1.4).", "x-ess-name": "a2a.tasks.Message", "x-ess-kind": "struct", "type": "object", "properties": { "messageId": { "x-ess-field": "message_id", "type": "string" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "role": { "$ref": "#/$defs/a2a.tasks.Role" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } }, "referenceTaskIds": { "x-ess-field": "reference_task_ids", "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.TaskId" } } }, "required": [ "messageId", "role", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.Role": { "title": "Role", "x-ess-name": "a2a.tasks.Role", "x-ess-kind": "enum", "type": "string", "enum": [ "ROLE_USER", "ROLE_AGENT" ] }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskSnapshot": { "title": "TaskSnapshot", "description": "The wire form of a task, proto message Task (A2A v1.0.1 section 4.1.1).", "x-ess-name": "a2a.tasks.TaskSnapshot", "x-ess-kind": "struct", "type": "object", "properties": { "id": { "$ref": "#/$defs/a2a.tasks.TaskId" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "status": { "$ref": "#/$defs/a2a.tasks.TaskStatus" }, "artifacts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Artifact" } }, "history": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Message" } }, "metadata": {} }, "required": [ "id", "status" ], "additionalProperties": false }, "a2a.tasks.TaskState": { "title": "TaskState", "x-ess-name": "a2a.tasks.TaskState", "x-ess-kind": "enum", "type": "string", "enum": [ "TASK_STATE_SUBMITTED", "TASK_STATE_WORKING", "TASK_STATE_COMPLETED", "TASK_STATE_FAILED", "TASK_STATE_CANCELED", "TASK_STATE_INPUT_REQUIRED", "TASK_STATE_REJECTED", "TASK_STATE_AUTH_REQUIRED" ] }, "a2a.tasks.TaskStatus": { "title": "TaskStatus", "x-ess-name": "a2a.tasks.TaskStatus", "x-ess-kind": "struct", "type": "object", "properties": { "state": { "$ref": "#/$defs/a2a.tasks.TaskState" }, "message": { "$ref": "#/$defs/a2a.tasks.Message" }, "timestamp": { "type": "string", "format": "date-time" } }, "required": [ "state" ], "additionalProperties": false } } }, "types.a2a.tasks.TaskState": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.tasks.TaskState.schema.json", "$ref": "#/$defs/a2a.tasks.TaskState", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:43253a1c27c7ef179bf956803eb05632d129669ab4ad49a72bca08925a3e8338", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.TaskState": { "title": "TaskState", "x-ess-name": "a2a.tasks.TaskState", "x-ess-kind": "enum", "type": "string", "enum": [ "TASK_STATE_SUBMITTED", "TASK_STATE_WORKING", "TASK_STATE_COMPLETED", "TASK_STATE_FAILED", "TASK_STATE_CANCELED", "TASK_STATE_INPUT_REQUIRED", "TASK_STATE_REJECTED", "TASK_STATE_AUTH_REQUIRED" ] } } }, "types.a2a.tasks.TaskStatus": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.tasks.TaskStatus.schema.json", "$ref": "#/$defs/a2a.tasks.TaskStatus", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:6bcf88caf7385526e39de0d03bfa4b89fdcba53f7a0bc5b98a78276de8e99f50", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Message": { "title": "Message", "description": "One turn of communication between client and agent (A2A v1.0.1 section 4.1.4).", "x-ess-name": "a2a.tasks.Message", "x-ess-kind": "struct", "type": "object", "properties": { "messageId": { "x-ess-field": "message_id", "type": "string" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "role": { "$ref": "#/$defs/a2a.tasks.Role" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } }, "referenceTaskIds": { "x-ess-field": "reference_task_ids", "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.TaskId" } } }, "required": [ "messageId", "role", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.Role": { "title": "Role", "x-ess-name": "a2a.tasks.Role", "x-ess-kind": "enum", "type": "string", "enum": [ "ROLE_USER", "ROLE_AGENT" ] }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskState": { "title": "TaskState", "x-ess-name": "a2a.tasks.TaskState", "x-ess-kind": "enum", "type": "string", "enum": [ "TASK_STATE_SUBMITTED", "TASK_STATE_WORKING", "TASK_STATE_COMPLETED", "TASK_STATE_FAILED", "TASK_STATE_CANCELED", "TASK_STATE_INPUT_REQUIRED", "TASK_STATE_REJECTED", "TASK_STATE_AUTH_REQUIRED" ] }, "a2a.tasks.TaskStatus": { "title": "TaskStatus", "x-ess-name": "a2a.tasks.TaskStatus", "x-ess-kind": "struct", "type": "object", "properties": { "state": { "$ref": "#/$defs/a2a.tasks.TaskState" }, "message": { "$ref": "#/$defs/a2a.tasks.Message" }, "timestamp": { "type": "string", "format": "date-time" } }, "required": [ "state" ], "additionalProperties": false } } }, "types.a2a.tasks.TaskStatusUpdateEvent": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "schema/types/a2a.tasks.TaskStatusUpdateEvent.schema.json", "$ref": "#/$defs/a2a.tasks.TaskStatusUpdateEvent", "x-ess-provenance": { "system": "a2a", "specification_version": "v1", "source_digest": "911794dff39b27311ddc6db22aa294d7c70c823fd2310684ad996b6eab4c5cdf", "contract_digest": "slice-sha256/2:0ea2bd30089004dd60d42b953ea52600275526a1c2606c6e7304f071a00608e6", "regenerate": "ess generate" }, "$defs": { "a2a.tasks.ContextId": { "title": "ContextId", "description": "Identifier grouping related tasks and messages (A2A v1.0.1 section 3.4.1).", "x-ess-name": "a2a.tasks.ContextId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.Message": { "title": "Message", "description": "One turn of communication between client and agent (A2A v1.0.1 section 4.1.4).", "x-ess-name": "a2a.tasks.Message", "x-ess-kind": "struct", "type": "object", "properties": { "messageId": { "x-ess-field": "message_id", "type": "string" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "role": { "$ref": "#/$defs/a2a.tasks.Role" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.Part" } }, "metadata": {}, "extensions": { "type": "array", "items": { "type": "string" } }, "referenceTaskIds": { "x-ess-field": "reference_task_ids", "type": "array", "items": { "$ref": "#/$defs/a2a.tasks.TaskId" } } }, "required": [ "messageId", "role", "parts" ], "additionalProperties": false }, "a2a.tasks.Part": { "title": "Part", "description": "One piece of content in a message or artifact (A2A v1.0.1 section 4.1.6).", "x-ess-name": "a2a.tasks.Part", "x-ess-kind": "struct", "type": "object", "properties": { "text": { "type": "string" }, "raw": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64" }, "url": { "type": "string" }, "data": {}, "metadata": {}, "filename": { "type": "string" }, "mediaType": { "x-ess-field": "media_type", "type": "string" } }, "additionalProperties": false }, "a2a.tasks.Role": { "title": "Role", "x-ess-name": "a2a.tasks.Role", "x-ess-kind": "enum", "type": "string", "enum": [ "ROLE_USER", "ROLE_AGENT" ] }, "a2a.tasks.TaskId": { "title": "TaskId", "description": "Server-generated, opaque task identifier (A2A v1.0.1 section 3.4.2).", "x-ess-name": "a2a.tasks.TaskId", "x-ess-kind": "newtype", "type": "string" }, "a2a.tasks.TaskState": { "title": "TaskState", "x-ess-name": "a2a.tasks.TaskState", "x-ess-kind": "enum", "type": "string", "enum": [ "TASK_STATE_SUBMITTED", "TASK_STATE_WORKING", "TASK_STATE_COMPLETED", "TASK_STATE_FAILED", "TASK_STATE_CANCELED", "TASK_STATE_INPUT_REQUIRED", "TASK_STATE_REJECTED", "TASK_STATE_AUTH_REQUIRED" ] }, "a2a.tasks.TaskStatus": { "title": "TaskStatus", "x-ess-name": "a2a.tasks.TaskStatus", "x-ess-kind": "struct", "type": "object", "properties": { "state": { "$ref": "#/$defs/a2a.tasks.TaskState" }, "message": { "$ref": "#/$defs/a2a.tasks.Message" }, "timestamp": { "type": "string", "format": "date-time" } }, "required": [ "state" ], "additionalProperties": false }, "a2a.tasks.TaskStatusUpdateEvent": { "title": "TaskStatusUpdateEvent", "description": "\"An event sent by the agent to notify the client of a change in a task's status\" (a2a.proto TaskStatusUpdateEvent; A2A v1.0.1 section 4.2.1).", "x-ess-name": "a2a.tasks.TaskStatusUpdateEvent", "x-ess-kind": "struct", "type": "object", "properties": { "taskId": { "$ref": "#/$defs/a2a.tasks.TaskId", "x-ess-field": "task_id" }, "contextId": { "$ref": "#/$defs/a2a.tasks.ContextId", "x-ess-field": "context_id" }, "status": { "$ref": "#/$defs/a2a.tasks.TaskStatus" }, "metadata": {} }, "required": [ "taskId", "contextId", "status" ], "additionalProperties": false } } } } }