From f2f71c50de02e16adcf07151facb8b3b942b971e Mon Sep 17 00:00:00 2001 From: sokoliva Date: Wed, 25 Mar 2026 13:15:51 +0000 Subject: [PATCH 1/5] fix: Remove unconditional SQLAlchemy dependency from SDK core --- src/a2a/compat/v0_3/conversions.py | 81 +--------------- src/a2a/compat/v0_3/model_conversions.py | 92 +++++++++++++++++++ ...database_push_notification_config_store.py | 2 +- src/a2a/server/tasks/database_task_store.py | 2 +- tests/compat/v0_3/test_conversions.py | 2 + ...database_push_notification_config_store.py | 2 +- .../server/tasks/test_database_task_store.py | 2 +- 7 files changed, 99 insertions(+), 84 deletions(-) create mode 100644 src/a2a/compat/v0_3/model_conversions.py diff --git a/src/a2a/compat/v0_3/conversions.py b/src/a2a/compat/v0_3/conversions.py index 3f5420198..5945380e9 100644 --- a/src/a2a/compat/v0_3/conversions.py +++ b/src/a2a/compat/v0_3/conversions.py @@ -1,16 +1,11 @@ import base64 -from typing import TYPE_CHECKING, Any - - -if TYPE_CHECKING: - from cryptography.fernet import Fernet +from typing import Any from google.protobuf.json_format import MessageToDict, ParseDict from a2a.compat.v0_3 import types as types_v03 from a2a.compat.v0_3.versions import is_legacy_version -from a2a.server.models import PushNotificationConfigModel, TaskModel from a2a.types import a2a_pb2 as pb2_v10 from a2a.utils import constants, errors @@ -1378,77 +1373,3 @@ def to_compat_get_extended_agent_card_request( ) -> types_v03.GetAuthenticatedExtendedCardRequest: """Convert get extended agent card request to v0.3 compat type.""" return types_v03.GetAuthenticatedExtendedCardRequest(id=request_id) - - -def core_to_compat_task_model(task: pb2_v10.Task, owner: str) -> TaskModel: - """Converts a 1.0 core Task to a TaskModel using v0.3 JSON structure.""" - compat_task = to_compat_task(task) - data = compat_task.model_dump(mode='json') - - return TaskModel( - id=task.id, - context_id=task.context_id, - owner=owner, - status=data.get('status'), - history=data.get('history'), - artifacts=data.get('artifacts'), - task_metadata=data.get('metadata'), - protocol_version='0.3', - ) - - -def compat_task_model_to_core(task_model: TaskModel) -> pb2_v10.Task: - """Converts a TaskModel with v0.3 structure to a 1.0 core Task.""" - compat_task = types_v03.Task( - id=task_model.id, - context_id=task_model.context_id, - status=types_v03.TaskStatus.model_validate(task_model.status), - artifacts=( - [types_v03.Artifact.model_validate(a) for a in task_model.artifacts] - if task_model.artifacts - else [] - ), - history=( - [types_v03.Message.model_validate(h) for h in task_model.history] - if task_model.history - else [] - ), - metadata=task_model.task_metadata, - ) - return to_core_task(compat_task) - - -def core_to_compat_push_notification_config_model( - task_id: str, - config: pb2_v10.TaskPushNotificationConfig, - owner: str, - fernet: 'Fernet | None' = None, -) -> PushNotificationConfigModel: - """Converts a 1.0 core TaskPushNotificationConfig to a PushNotificationConfigModel using v0.3 JSON structure.""" - compat_config = to_compat_push_notification_config(config) - - json_payload = compat_config.model_dump_json().encode('utf-8') - data_to_store = fernet.encrypt(json_payload) if fernet else json_payload - - return PushNotificationConfigModel( - task_id=task_id, - config_id=config.id, - owner=owner, - config_data=data_to_store, - protocol_version='0.3', - ) - - -def compat_push_notification_config_model_to_core( - model_instance: str, task_id: str -) -> pb2_v10.TaskPushNotificationConfig: - """Converts a PushNotificationConfigModel with v0.3 structure back to a 1.0 core TaskPushNotificationConfig.""" - inner_config = types_v03.PushNotificationConfig.model_validate_json( - model_instance - ) - return to_core_task_push_notification_config( - types_v03.TaskPushNotificationConfig( - task_id=task_id, - push_notification_config=inner_config, - ) - ) diff --git a/src/a2a/compat/v0_3/model_conversions.py b/src/a2a/compat/v0_3/model_conversions.py new file mode 100644 index 000000000..9b3cc44f8 --- /dev/null +++ b/src/a2a/compat/v0_3/model_conversions.py @@ -0,0 +1,92 @@ +"""Database model conversions for v0.3 compatibility.""" + +from typing import TYPE_CHECKING + + +if TYPE_CHECKING: + from cryptography.fernet import Fernet + + +from a2a.compat.v0_3 import types as types_v03 +from a2a.compat.v0_3.conversions import ( + to_compat_push_notification_config, + to_compat_task, + to_core_task, + to_core_task_push_notification_config, +) +from a2a.server.models import PushNotificationConfigModel, TaskModel +from a2a.types import a2a_pb2 as pb2_v10 + + +def core_to_compat_task_model(task: pb2_v10.Task, owner: str) -> TaskModel: + """Converts a 1.0 core Task to a TaskModel using v0.3 JSON structure.""" + compat_task = to_compat_task(task) + data = compat_task.model_dump(mode='json') + + return TaskModel( + id=task.id, + context_id=task.context_id, + owner=owner, + status=data.get('status'), + history=data.get('history'), + artifacts=data.get('artifacts'), + task_metadata=data.get('metadata'), + protocol_version='0.3', + ) + + +def compat_task_model_to_core(task_model: TaskModel) -> pb2_v10.Task: + """Converts a TaskModel with v0.3 structure to a 1.0 core Task.""" + compat_task = types_v03.Task( + id=task_model.id, + context_id=task_model.context_id, + status=types_v03.TaskStatus.model_validate(task_model.status), + artifacts=( + [types_v03.Artifact.model_validate(a) for a in task_model.artifacts] + if task_model.artifacts + else [] + ), + history=( + [types_v03.Message.model_validate(h) for h in task_model.history] + if task_model.history + else [] + ), + metadata=task_model.task_metadata, + ) + return to_core_task(compat_task) + + +def core_to_compat_push_notification_config_model( + task_id: str, + config: pb2_v10.TaskPushNotificationConfig, + owner: str, + fernet: 'Fernet | None' = None, +) -> PushNotificationConfigModel: + """Converts a 1.0 core TaskPushNotificationConfig to a PushNotificationConfigModel using v0.3 JSON structure.""" + compat_config = to_compat_push_notification_config(config) + + json_payload = compat_config.model_dump_json().encode('utf-8') + data_to_store = fernet.encrypt(json_payload) if fernet else json_payload + + return PushNotificationConfigModel( + task_id=task_id, + config_id=config.id, + owner=owner, + config_data=data_to_store, + protocol_version='0.3', + ) + + +def compat_push_notification_config_model_to_core( + model_instance: str, task_id: str +) -> pb2_v10.TaskPushNotificationConfig: + """Converts a PushNotificationConfigModel with v0.3 structure back to a 1.0 core TaskPushNotificationConfig.""" + inner_config = types_v03.PushNotificationConfig.model_validate_json( + model_instance + ) + return to_core_task_push_notification_config( + types_v03.TaskPushNotificationConfig( + task_id=task_id, + push_notification_config=inner_config, + ) + ) diff --git a/src/a2a/server/tasks/database_push_notification_config_store.py b/src/a2a/server/tasks/database_push_notification_config_store.py index 406805445..31cd676c8 100644 --- a/src/a2a/server/tasks/database_push_notification_config_store.py +++ b/src/a2a/server/tasks/database_push_notification_config_store.py @@ -26,7 +26,7 @@ from collections.abc import Callable -from a2a.compat.v0_3.conversions import ( +from a2a.compat.v0_3.model_conversions import ( compat_push_notification_config_model_to_core, ) from a2a.server.context import ServerCallContext diff --git a/src/a2a/server/tasks/database_task_store.py b/src/a2a/server/tasks/database_task_store.py index ac1cf947b..2c95da2ca 100644 --- a/src/a2a/server/tasks/database_task_store.py +++ b/src/a2a/server/tasks/database_task_store.py @@ -23,7 +23,7 @@ ) from e from google.protobuf.json_format import MessageToDict, ParseDict -from a2a.compat.v0_3.conversions import ( +from a2a.compat.v0_3.model_conversions import ( compat_task_model_to_core, ) from a2a.server.context import ServerCallContext diff --git a/tests/compat/v0_3/test_conversions.py b/tests/compat/v0_3/test_conversions.py index 3b66f748c..78a6d563b 100644 --- a/tests/compat/v0_3/test_conversions.py +++ b/tests/compat/v0_3/test_conversions.py @@ -73,6 +73,8 @@ to_core_task_push_notification_config, to_core_task_status, to_core_task_status_update_event, +) +from a2a.compat.v0_3.model_conversions import ( core_to_compat_task_model, compat_task_model_to_core, core_to_compat_push_notification_config_model, diff --git a/tests/server/tasks/test_database_push_notification_config_store.py b/tests/server/tasks/test_database_push_notification_config_store.py index f9f8ad7b1..b13a5cf55 100644 --- a/tests/server/tasks/test_database_push_notification_config_store.py +++ b/tests/server/tasks/test_database_push_notification_config_store.py @@ -44,7 +44,7 @@ TaskState, TaskStatus, ) -from a2a.compat.v0_3.conversions import ( +from a2a.compat.v0_3.model_conversions import ( core_to_compat_push_notification_config_model, ) diff --git a/tests/server/tasks/test_database_task_store.py b/tests/server/tasks/test_database_task_store.py index 445a45a37..ff2ab1938 100644 --- a/tests/server/tasks/test_database_task_store.py +++ b/tests/server/tasks/test_database_task_store.py @@ -24,7 +24,7 @@ from a2a.server.models import Base, TaskModel # Important: To get Base.metadata from a2a.server.tasks.database_task_store import DatabaseTaskStore -from a2a.compat.v0_3.conversions import core_to_compat_task_model +from a2a.compat.v0_3.model_conversions import core_to_compat_task_model from a2a.types.a2a_pb2 import ( Artifact, ListTasksRequest, From c0a5f684246ce22fc169cc97db4473c883a50fe3 Mon Sep 17 00:00:00 2001 From: sokoliva Date: Wed, 25 Mar 2026 15:52:24 +0000 Subject: [PATCH 2/5] update zero_downtime.md --- docs/migrations/v1_0/database/zero_downtime.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/migrations/v1_0/database/zero_downtime.md b/docs/migrations/v1_0/database/zero_downtime.md index 3278c3265..026ec88c1 100644 --- a/docs/migrations/v1_0/database/zero_downtime.md +++ b/docs/migrations/v1_0/database/zero_downtime.md @@ -62,7 +62,7 @@ Enable the v0.3 conversion utilities in your application entry point (e.g., `mai ```python from a2a.server.tasks import DatabaseTaskStore, DatabasePushNotificationConfigStore -from a2a.compat.v0_3.conversions import ( +from a2a.compat.v0_3.model_conversions import ( core_to_compat_task_model, core_to_compat_push_notification_config_model, ) @@ -126,7 +126,7 @@ This allows v1.0 instances to read *all* existing data regardless of when it was ## 🧩 Resources - **[a2a-db CLI](../../../../src/a2a/migrations/README.md)**: The primary tool for executing schema migrations. -- **[Compatibility Conversions](../../../../src/a2a/compat/v0_3/conversions.py)**: Source for classes like `core_to_compat_task_model` used in Step 2. +- **[Compatibility Conversions](../../../../src/a2a/compat/v0_3/model_conversions.py)**: Source for model conversion functions `core_to_compat_task_model` and `core_to_compat_push_notification_config_model` used in Step 2. - **[Task Store Implementation](../../../../src/a2a/server/tasks/database_task_store.py)**: The `DatabaseTaskStore` which handles the version-aware read/write logic. - **[Push Notification Store Implementation](../../../../src/a2a/server/tasks/database_push_notification_config_store.py)**: The `DatabasePushNotificationConfigStore` which handles the version-aware read/write logic. From 2b0c016182b6bb85e86c5e0ba4ce3d5a4521206f Mon Sep 17 00:00:00 2001 From: sokoliva Date: Wed, 25 Mar 2026 15:52:48 +0000 Subject: [PATCH 3/5] Merge branch 'sqlalchemy-dependency' of https://github.com/sokoliva/a2a-python into sqlalchemy-dependency --- =24.0 | 5 + a2a-python.code-workspace | 7 + src/a2a/types/a2a.json | 2265 +++++++++++++++++++++++++++++++++++++ 3 files changed, 2277 insertions(+) create mode 100644 =24.0 create mode 100644 a2a-python.code-workspace create mode 100644 src/a2a/types/a2a.json diff --git a/=24.0 b/=24.0 new file mode 100644 index 000000000..b57e12fb5 --- /dev/null +++ b/=24.0 @@ -0,0 +1,5 @@ +Collecting packaging + Using cached packaging-26.0-py3-none-any.whl.metadata (3.3 kB) +Using cached packaging-26.0-py3-none-any.whl (74 kB) +Installing collected packages: packaging +Successfully installed packaging-26.0 diff --git a/a2a-python.code-workspace b/a2a-python.code-workspace new file mode 100644 index 000000000..443f5a5b2 --- /dev/null +++ b/a2a-python.code-workspace @@ -0,0 +1,7 @@ +{ + "folders": [ + { + "path": "." + } + ] +} \ No newline at end of file diff --git a/src/a2a/types/a2a.json b/src/a2a/types/a2a.json new file mode 100644 index 000000000..d71800313 --- /dev/null +++ b/src/a2a/types/a2a.json @@ -0,0 +1,2265 @@ +{ + "swagger": "2.0", + "info": { + "title": "a2a.proto", + "version": "version not set" + }, + "tags": [ + { + "name": "A2AService" + } + ], + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "paths": { + "/extendedAgentCard": { + "get": { + "summary": "Gets the extended agent card for the authenticated agent.", + "operationId": "A2AService_GetExtendedAgentCard", + "responses": { + "200": { + "description": "A successful response.", + "schema": { + "$ref": "#/definitions/v1AgentCard" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/rpcStatus" + } + } + }, + "parameters": [ + { + "name": "tenant", + "description": "Optional. Tenant ID, provided as a path parameter.", + "in": "query", + "required": false, + "type": "string" + } + ], + "tags": [ + "A2AService" + ] + } + }, + "/message:send": { + "post": { + "summary": "Sends a message to an agent.", + "operationId": "A2AService_SendMessage", + "responses": { + "200": { + "description": "A successful response.", + "schema": { + "$ref": "#/definitions/v1SendMessageResponse" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/rpcStatus" + } + } + }, + "parameters": [ + { + "name": "body", + "description": "Represents a request for the `SendMessage` method.", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/v1SendMessageRequest" + } + } + ], + "tags": [ + "A2AService" + ] + } + }, + "/message:stream": { + "post": { + "summary": "Sends a streaming message to an agent, allowing for real-time interaction and status updates.\nStreaming version of `SendMessage`", + "operationId": "A2AService_SendStreamingMessage", + "responses": { + "200": { + "description": "A successful response.(streaming responses)", + "schema": { + "type": "object", + "properties": { + "result": { + "$ref": "#/definitions/v1StreamResponse" + }, + "error": { + "$ref": "#/definitions/rpcStatus" + } + }, + "title": "Stream result of v1StreamResponse" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/rpcStatus" + } + } + }, + "parameters": [ + { + "name": "body", + "description": "Represents a request for the `SendMessage` method.", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/v1SendMessageRequest" + } + } + ], + "tags": [ + "A2AService" + ] + } + }, + "/tasks": { + "get": { + "summary": "Lists tasks that match the specified filter.", + "operationId": "A2AService_ListTasks", + "responses": { + "200": { + "description": "A successful response.", + "schema": { + "$ref": "#/definitions/v1ListTasksResponse" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/rpcStatus" + } + } + }, + "parameters": [ + { + "name": "tenant", + "description": "Tenant ID, provided as a path parameter.", + "in": "query", + "required": false, + "type": "string" + }, + { + "name": "contextId", + "description": "Filter tasks by context ID to get tasks from a specific conversation or session.", + "in": "query", + "required": false, + "type": "string" + }, + { + "name": "status", + "description": "Filter tasks by their current status state.\n\n - TASK_STATE_UNSPECIFIED: The task is in an unknown or indeterminate state.\n - TASK_STATE_SUBMITTED: Indicates that a task has been successfully submitted and acknowledged.\n - TASK_STATE_WORKING: Indicates that a task is actively being processed by the agent.\n - TASK_STATE_COMPLETED: Indicates that a task has finished successfully. This is a terminal state.\n - TASK_STATE_FAILED: Indicates that a task has finished with an error. This is a terminal state.\n - TASK_STATE_CANCELED: Indicates that a task was canceled before completion. This is a terminal state.\n - TASK_STATE_INPUT_REQUIRED: Indicates that the agent requires additional user input to proceed. This is an interrupted state.\n - TASK_STATE_REJECTED: Indicates that the agent has decided to not perform the task.\nThis may be done during initial task creation or later once an agent\nhas determined it can't or won't proceed. This is a terminal state.\n - TASK_STATE_AUTH_REQUIRED: Indicates that authentication is required to proceed. This is an interrupted state.", + "in": "query", + "required": false, + "type": "string", + "enum": [ + "TASK_STATE_UNSPECIFIED", + "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" + ], + "default": "TASK_STATE_UNSPECIFIED" + }, + { + "name": "pageSize", + "description": "The maximum number of tasks to return. The service may return fewer than this value.\nIf unspecified, at most 50 tasks will be returned.\nThe minimum value is 1.\nThe maximum value is 100.", + "in": "query", + "required": false, + "type": "integer", + "format": "int32" + }, + { + "name": "pageToken", + "description": "A page token, received from a previous `ListTasks` call.\n`ListTasksResponse.next_page_token`.\nProvide this to retrieve the subsequent page.", + "in": "query", + "required": false, + "type": "string" + }, + { + "name": "historyLength", + "description": "The maximum number of messages to include in each task's history.", + "in": "query", + "required": false, + "type": "integer", + "format": "int32" + }, + { + "name": "statusTimestampAfter", + "description": "Filter tasks which have a status updated after the provided timestamp in ISO 8601 format (e.g., \"2023-10-27T10:00:00Z\").\nOnly tasks with a status timestamp time greater than or equal to this value will be returned.", + "in": "query", + "required": false, + "type": "string", + "format": "date-time" + }, + { + "name": "includeArtifacts", + "description": "Whether to include artifacts in the returned tasks.\nDefaults to false to reduce payload size.", + "in": "query", + "required": false, + "type": "boolean" + } + ], + "tags": [ + "A2AService" + ] + } + }, + "/tasks/{id}": { + "get": { + "summary": "Gets the latest state of a task.", + "operationId": "A2AService_GetTask", + "responses": { + "200": { + "description": "A successful response.", + "schema": { + "$ref": "#/definitions/v1Task" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/rpcStatus" + } + } + }, + "parameters": [ + { + "name": "id", + "description": "The resource ID of the task to retrieve.", + "in": "path", + "required": true, + "type": "string", + "pattern": "[^/]+" + }, + { + "name": "tenant", + "description": "Optional. Tenant ID, provided as a path parameter.", + "in": "query", + "required": false, + "type": "string" + }, + { + "name": "historyLength", + "description": "The maximum number of most recent messages from the task's history to retrieve. An\nunset value means the client does not impose any limit. A value of zero is\na request to not include any messages. The server MUST NOT return more\nmessages than the provided value, but MAY apply a lower limit.", + "in": "query", + "required": false, + "type": "integer", + "format": "int32" + } + ], + "tags": [ + "A2AService" + ] + } + }, + "/tasks/{id}:cancel": { + "post": { + "summary": "Cancels a task in progress.", + "operationId": "A2AService_CancelTask", + "responses": { + "200": { + "description": "A successful response.", + "schema": { + "$ref": "#/definitions/v1Task" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/rpcStatus" + } + } + }, + "parameters": [ + { + "name": "id", + "description": "The resource ID of the task to cancel.", + "in": "path", + "required": true, + "type": "string", + "pattern": "[^/]+" + }, + { + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/A2AServiceCancelTaskBody" + } + } + ], + "tags": [ + "A2AService" + ] + } + }, + "/tasks/{id}:subscribe": { + "get": { + "summary": "Subscribes to task updates for tasks not in a terminal state.\nReturns `UnsupportedOperationError` if the task is already in a terminal state (completed, failed, canceled, rejected).", + "operationId": "A2AService_SubscribeToTask", + "responses": { + "200": { + "description": "A successful response.(streaming responses)", + "schema": { + "type": "object", + "properties": { + "result": { + "$ref": "#/definitions/v1StreamResponse" + }, + "error": { + "$ref": "#/definitions/rpcStatus" + } + }, + "title": "Stream result of v1StreamResponse" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/rpcStatus" + } + } + }, + "parameters": [ + { + "name": "id", + "description": "The resource ID of the task to subscribe to.", + "in": "path", + "required": true, + "type": "string", + "pattern": "[^/]+" + }, + { + "name": "tenant", + "description": "Optional. Tenant ID, provided as a path parameter.", + "in": "query", + "required": false, + "type": "string" + } + ], + "tags": [ + "A2AService" + ] + } + }, + "/tasks/{taskId}/pushNotificationConfigs": { + "get": { + "summary": "Get a list of push notifications configured for a task.", + "operationId": "A2AService_ListTaskPushNotificationConfigs", + "responses": { + "200": { + "description": "A successful response.", + "schema": { + "$ref": "#/definitions/v1ListTaskPushNotificationConfigsResponse" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/rpcStatus" + } + } + }, + "parameters": [ + { + "name": "taskId", + "description": "The parent task resource ID.", + "in": "path", + "required": true, + "type": "string", + "pattern": "[^/]+" + }, + { + "name": "tenant", + "description": "Optional. Tenant ID, provided as a path parameter.", + "in": "query", + "required": false, + "type": "string" + }, + { + "name": "pageSize", + "description": "The maximum number of configurations to return.", + "in": "query", + "required": false, + "type": "integer", + "format": "int32" + }, + { + "name": "pageToken", + "description": "A page token received from a previous `ListTaskPushNotificationConfigsRequest` call.", + "in": "query", + "required": false, + "type": "string" + } + ], + "tags": [ + "A2AService" + ] + }, + "post": { + "summary": "Creates a push notification config for a task.", + "operationId": "A2AService_CreateTaskPushNotificationConfig", + "responses": { + "200": { + "description": "A successful response.", + "schema": { + "$ref": "#/definitions/v1TaskPushNotificationConfig" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/rpcStatus" + } + } + }, + "parameters": [ + { + "name": "taskId", + "description": "The parent task resource ID.", + "in": "path", + "required": true, + "type": "string", + "pattern": "[^/]+" + }, + { + "name": "config", + "description": "The configuration to create.", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/v1PushNotificationConfig" + } + }, + { + "name": "tenant", + "description": "Optional. Tenant ID, provided as a path parameter.", + "in": "query", + "required": false, + "type": "string" + } + ], + "tags": [ + "A2AService" + ] + } + }, + "/tasks/{taskId}/pushNotificationConfigs/{id}": { + "get": { + "summary": "Gets a push notification config for a task.", + "operationId": "A2AService_GetTaskPushNotificationConfig", + "responses": { + "200": { + "description": "A successful response.", + "schema": { + "$ref": "#/definitions/v1TaskPushNotificationConfig" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/rpcStatus" + } + } + }, + "parameters": [ + { + "name": "taskId", + "description": "The parent task resource ID.", + "in": "path", + "required": true, + "type": "string", + "pattern": "[^/]+" + }, + { + "name": "id", + "description": "The resource ID of the configuration to retrieve.", + "in": "path", + "required": true, + "type": "string", + "pattern": "[^/]+" + }, + { + "name": "tenant", + "description": "Optional. Tenant ID, provided as a path parameter.", + "in": "query", + "required": false, + "type": "string" + } + ], + "tags": [ + "A2AService" + ] + }, + "delete": { + "summary": "Deletes a push notification config for a task.", + "operationId": "A2AService_DeleteTaskPushNotificationConfig", + "responses": { + "200": { + "description": "A successful response.", + "schema": { + "type": "object", + "properties": {} + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/rpcStatus" + } + } + }, + "parameters": [ + { + "name": "taskId", + "description": "The parent task resource ID.", + "in": "path", + "required": true, + "type": "string", + "pattern": "[^/]+" + }, + { + "name": "id", + "description": "The resource ID of the configuration to delete.", + "in": "path", + "required": true, + "type": "string", + "pattern": "[^/]+" + }, + { + "name": "tenant", + "description": "Optional. Tenant ID, provided as a path parameter.", + "in": "query", + "required": false, + "type": "string" + } + ], + "tags": [ + "A2AService" + ] + } + }, + "/{tenant}/extendedAgentCard": { + "get": { + "summary": "Gets the extended agent card for the authenticated agent.", + "operationId": "A2AService_GetExtendedAgentCard2", + "responses": { + "200": { + "description": "A successful response.", + "schema": { + "$ref": "#/definitions/v1AgentCard" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/rpcStatus" + } + } + }, + "parameters": [ + { + "name": "tenant", + "description": "Optional. Tenant ID, provided as a path parameter.", + "in": "path", + "required": true, + "type": "string" + } + ], + "tags": [ + "A2AService" + ] + } + }, + "/{tenant}/message:send": { + "post": { + "summary": "Sends a message to an agent.", + "operationId": "A2AService_SendMessage2", + "responses": { + "200": { + "description": "A successful response.", + "schema": { + "$ref": "#/definitions/v1SendMessageResponse" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/rpcStatus" + } + } + }, + "parameters": [ + { + "name": "tenant", + "description": "Optional. Tenant ID, provided as a path parameter.", + "in": "path", + "required": true, + "type": "string" + }, + { + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/A2AServiceSendMessageBody" + } + } + ], + "tags": [ + "A2AService" + ] + } + }, + "/{tenant}/message:stream": { + "post": { + "summary": "Sends a streaming message to an agent, allowing for real-time interaction and status updates.\nStreaming version of `SendMessage`", + "operationId": "A2AService_SendStreamingMessage2", + "responses": { + "200": { + "description": "A successful response.(streaming responses)", + "schema": { + "type": "object", + "properties": { + "result": { + "$ref": "#/definitions/v1StreamResponse" + }, + "error": { + "$ref": "#/definitions/rpcStatus" + } + }, + "title": "Stream result of v1StreamResponse" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/rpcStatus" + } + } + }, + "parameters": [ + { + "name": "tenant", + "description": "Optional. Tenant ID, provided as a path parameter.", + "in": "path", + "required": true, + "type": "string" + }, + { + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/A2AServiceSendStreamingMessageBody" + } + } + ], + "tags": [ + "A2AService" + ] + } + }, + "/{tenant}/tasks": { + "get": { + "summary": "Lists tasks that match the specified filter.", + "operationId": "A2AService_ListTasks2", + "responses": { + "200": { + "description": "A successful response.", + "schema": { + "$ref": "#/definitions/v1ListTasksResponse" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/rpcStatus" + } + } + }, + "parameters": [ + { + "name": "tenant", + "description": "Tenant ID, provided as a path parameter.", + "in": "path", + "required": true, + "type": "string" + }, + { + "name": "contextId", + "description": "Filter tasks by context ID to get tasks from a specific conversation or session.", + "in": "query", + "required": false, + "type": "string" + }, + { + "name": "status", + "description": "Filter tasks by their current status state.\n\n - TASK_STATE_UNSPECIFIED: The task is in an unknown or indeterminate state.\n - TASK_STATE_SUBMITTED: Indicates that a task has been successfully submitted and acknowledged.\n - TASK_STATE_WORKING: Indicates that a task is actively being processed by the agent.\n - TASK_STATE_COMPLETED: Indicates that a task has finished successfully. This is a terminal state.\n - TASK_STATE_FAILED: Indicates that a task has finished with an error. This is a terminal state.\n - TASK_STATE_CANCELED: Indicates that a task was canceled before completion. This is a terminal state.\n - TASK_STATE_INPUT_REQUIRED: Indicates that the agent requires additional user input to proceed. This is an interrupted state.\n - TASK_STATE_REJECTED: Indicates that the agent has decided to not perform the task.\nThis may be done during initial task creation or later once an agent\nhas determined it can't or won't proceed. This is a terminal state.\n - TASK_STATE_AUTH_REQUIRED: Indicates that authentication is required to proceed. This is an interrupted state.", + "in": "query", + "required": false, + "type": "string", + "enum": [ + "TASK_STATE_UNSPECIFIED", + "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" + ], + "default": "TASK_STATE_UNSPECIFIED" + }, + { + "name": "pageSize", + "description": "The maximum number of tasks to return. The service may return fewer than this value.\nIf unspecified, at most 50 tasks will be returned.\nThe minimum value is 1.\nThe maximum value is 100.", + "in": "query", + "required": false, + "type": "integer", + "format": "int32" + }, + { + "name": "pageToken", + "description": "A page token, received from a previous `ListTasks` call.\n`ListTasksResponse.next_page_token`.\nProvide this to retrieve the subsequent page.", + "in": "query", + "required": false, + "type": "string" + }, + { + "name": "historyLength", + "description": "The maximum number of messages to include in each task's history.", + "in": "query", + "required": false, + "type": "integer", + "format": "int32" + }, + { + "name": "statusTimestampAfter", + "description": "Filter tasks which have a status updated after the provided timestamp in ISO 8601 format (e.g., \"2023-10-27T10:00:00Z\").\nOnly tasks with a status timestamp time greater than or equal to this value will be returned.", + "in": "query", + "required": false, + "type": "string", + "format": "date-time" + }, + { + "name": "includeArtifacts", + "description": "Whether to include artifacts in the returned tasks.\nDefaults to false to reduce payload size.", + "in": "query", + "required": false, + "type": "boolean" + } + ], + "tags": [ + "A2AService" + ] + } + }, + "/{tenant}/tasks/{id}": { + "get": { + "summary": "Gets the latest state of a task.", + "operationId": "A2AService_GetTask2", + "responses": { + "200": { + "description": "A successful response.", + "schema": { + "$ref": "#/definitions/v1Task" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/rpcStatus" + } + } + }, + "parameters": [ + { + "name": "tenant", + "description": "Optional. Tenant ID, provided as a path parameter.", + "in": "path", + "required": true, + "type": "string" + }, + { + "name": "id", + "description": "The resource ID of the task to retrieve.", + "in": "path", + "required": true, + "type": "string", + "pattern": "[^/]+" + }, + { + "name": "historyLength", + "description": "The maximum number of most recent messages from the task's history to retrieve. An\nunset value means the client does not impose any limit. A value of zero is\na request to not include any messages. The server MUST NOT return more\nmessages than the provided value, but MAY apply a lower limit.", + "in": "query", + "required": false, + "type": "integer", + "format": "int32" + } + ], + "tags": [ + "A2AService" + ] + } + }, + "/{tenant}/tasks/{id}:cancel": { + "post": { + "summary": "Cancels a task in progress.", + "operationId": "A2AService_CancelTask2", + "responses": { + "200": { + "description": "A successful response.", + "schema": { + "$ref": "#/definitions/v1Task" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/rpcStatus" + } + } + }, + "parameters": [ + { + "name": "tenant", + "description": "Optional. Tenant ID, provided as a path parameter.", + "in": "path", + "required": true, + "type": "string" + }, + { + "name": "id", + "description": "The resource ID of the task to cancel.", + "in": "path", + "required": true, + "type": "string", + "pattern": "[^/]+" + }, + { + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/A2AServiceCancelTaskBody" + } + } + ], + "tags": [ + "A2AService" + ] + } + }, + "/{tenant}/tasks/{id}:subscribe": { + "get": { + "summary": "Subscribes to task updates for tasks not in a terminal state.\nReturns `UnsupportedOperationError` if the task is already in a terminal state (completed, failed, canceled, rejected).", + "operationId": "A2AService_SubscribeToTask2", + "responses": { + "200": { + "description": "A successful response.(streaming responses)", + "schema": { + "type": "object", + "properties": { + "result": { + "$ref": "#/definitions/v1StreamResponse" + }, + "error": { + "$ref": "#/definitions/rpcStatus" + } + }, + "title": "Stream result of v1StreamResponse" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/rpcStatus" + } + } + }, + "parameters": [ + { + "name": "tenant", + "description": "Optional. Tenant ID, provided as a path parameter.", + "in": "path", + "required": true, + "type": "string" + }, + { + "name": "id", + "description": "The resource ID of the task to subscribe to.", + "in": "path", + "required": true, + "type": "string", + "pattern": "[^/]+" + } + ], + "tags": [ + "A2AService" + ] + } + }, + "/{tenant}/tasks/{taskId}/pushNotificationConfigs": { + "get": { + "summary": "Get a list of push notifications configured for a task.", + "operationId": "A2AService_ListTaskPushNotificationConfigs2", + "responses": { + "200": { + "description": "A successful response.", + "schema": { + "$ref": "#/definitions/v1ListTaskPushNotificationConfigsResponse" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/rpcStatus" + } + } + }, + "parameters": [ + { + "name": "tenant", + "description": "Optional. Tenant ID, provided as a path parameter.", + "in": "path", + "required": true, + "type": "string" + }, + { + "name": "taskId", + "description": "The parent task resource ID.", + "in": "path", + "required": true, + "type": "string", + "pattern": "[^/]+" + }, + { + "name": "pageSize", + "description": "The maximum number of configurations to return.", + "in": "query", + "required": false, + "type": "integer", + "format": "int32" + }, + { + "name": "pageToken", + "description": "A page token received from a previous `ListTaskPushNotificationConfigsRequest` call.", + "in": "query", + "required": false, + "type": "string" + } + ], + "tags": [ + "A2AService" + ] + }, + "post": { + "summary": "Creates a push notification config for a task.", + "operationId": "A2AService_CreateTaskPushNotificationConfig2", + "responses": { + "200": { + "description": "A successful response.", + "schema": { + "$ref": "#/definitions/v1TaskPushNotificationConfig" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/rpcStatus" + } + } + }, + "parameters": [ + { + "name": "tenant", + "description": "Optional. Tenant ID, provided as a path parameter.", + "in": "path", + "required": true, + "type": "string" + }, + { + "name": "taskId", + "description": "The parent task resource ID.", + "in": "path", + "required": true, + "type": "string", + "pattern": "[^/]+" + }, + { + "name": "config", + "description": "The configuration to create.", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/v1PushNotificationConfig" + } + } + ], + "tags": [ + "A2AService" + ] + } + }, + "/{tenant}/tasks/{taskId}/pushNotificationConfigs/{id}": { + "get": { + "summary": "Gets a push notification config for a task.", + "operationId": "A2AService_GetTaskPushNotificationConfig2", + "responses": { + "200": { + "description": "A successful response.", + "schema": { + "$ref": "#/definitions/v1TaskPushNotificationConfig" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/rpcStatus" + } + } + }, + "parameters": [ + { + "name": "tenant", + "description": "Optional. Tenant ID, provided as a path parameter.", + "in": "path", + "required": true, + "type": "string" + }, + { + "name": "taskId", + "description": "The parent task resource ID.", + "in": "path", + "required": true, + "type": "string", + "pattern": "[^/]+" + }, + { + "name": "id", + "description": "The resource ID of the configuration to retrieve.", + "in": "path", + "required": true, + "type": "string", + "pattern": "[^/]+" + } + ], + "tags": [ + "A2AService" + ] + }, + "delete": { + "summary": "Deletes a push notification config for a task.", + "operationId": "A2AService_DeleteTaskPushNotificationConfig2", + "responses": { + "200": { + "description": "A successful response.", + "schema": { + "type": "object", + "properties": {} + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/rpcStatus" + } + } + }, + "parameters": [ + { + "name": "tenant", + "description": "Optional. Tenant ID, provided as a path parameter.", + "in": "path", + "required": true, + "type": "string" + }, + { + "name": "taskId", + "description": "The parent task resource ID.", + "in": "path", + "required": true, + "type": "string", + "pattern": "[^/]+" + }, + { + "name": "id", + "description": "The resource ID of the configuration to delete.", + "in": "path", + "required": true, + "type": "string", + "pattern": "[^/]+" + } + ], + "tags": [ + "A2AService" + ] + } + } + }, + "definitions": { + "A2AServiceCancelTaskBody": { + "type": "object", + "properties": { + "metadata": { + "type": "object", + "description": "A flexible key-value map for passing additional context or parameters." + } + }, + "description": "Represents a request for the `CancelTask` method." + }, + "A2AServiceSendMessageBody": { + "type": "object", + "properties": { + "message": { + "$ref": "#/definitions/v1Message", + "description": "The message to send to the agent." + }, + "configuration": { + "$ref": "#/definitions/v1SendMessageConfiguration", + "description": "Configuration for the send request." + }, + "metadata": { + "type": "object", + "description": "A flexible key-value map for passing additional context or parameters." + } + }, + "description": "Represents a request for the `SendMessage` method.", + "required": [ + "message" + ] + }, + "A2AServiceSendStreamingMessageBody": { + "type": "object", + "properties": { + "message": { + "$ref": "#/definitions/v1Message", + "description": "The message to send to the agent." + }, + "configuration": { + "$ref": "#/definitions/v1SendMessageConfiguration", + "description": "Configuration for the send request." + }, + "metadata": { + "type": "object", + "description": "A flexible key-value map for passing additional context or parameters." + } + }, + "description": "Represents a request for the `SendMessage` method.", + "required": [ + "message" + ] + }, + "protobufAny": { + "type": "object", + "properties": { + "@type": { + "type": "string" + } + }, + "additionalProperties": {} + }, + "protobufNullValue": { + "type": "string", + "enum": [ + "NULL_VALUE" + ], + "default": "NULL_VALUE", + "description": "`NullValue` is a singleton enumeration to represent the null value for the\n`Value` type union.\n\nThe JSON representation for `NullValue` is JSON `null`.\n\n - NULL_VALUE: Null value." + }, + "rpcStatus": { + "type": "object", + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + }, + "details": { + "type": "array", + "items": { + "type": "object", + "$ref": "#/definitions/protobufAny" + } + } + } + }, + "v1APIKeySecurityScheme": { + "type": "object", + "properties": { + "description": { + "type": "string", + "description": "An optional description for the security scheme." + }, + "location": { + "type": "string", + "description": "The location of the API key. Valid values are \"query\", \"header\", or \"cookie\"." + }, + "name": { + "type": "string", + "description": "The name of the header, query, or cookie parameter to be used." + } + }, + "description": "Defines a security scheme using an API key.", + "required": [ + "location", + "name" + ] + }, + "v1AgentCapabilities": { + "type": "object", + "properties": { + "streaming": { + "type": "boolean", + "description": "Indicates if the agent supports streaming responses." + }, + "pushNotifications": { + "type": "boolean", + "description": "Indicates if the agent supports sending push notifications for asynchronous task updates." + }, + "extensions": { + "type": "array", + "items": { + "type": "object", + "$ref": "#/definitions/v1AgentExtension" + }, + "description": "A list of protocol extensions supported by the agent." + }, + "extendedAgentCard": { + "type": "boolean", + "description": "Indicates if the agent supports providing an extended agent card when authenticated." + } + }, + "description": "Defines optional capabilities supported by an agent." + }, + "v1AgentCard": { + "type": "object", + "properties": { + "name": { + "type": "string", + "title": "A human readable name for the agent.\nExample: \"Recipe Agent\"" + }, + "description": { + "type": "string", + "title": "A human-readable description of the agent, assisting users and other agents\nin understanding its purpose.\nExample: \"Agent that helps users with recipes and cooking.\"" + }, + "supportedInterfaces": { + "type": "array", + "items": { + "type": "object", + "$ref": "#/definitions/v1AgentInterface" + }, + "description": "Ordered list of supported interfaces. The first entry is preferred." + }, + "provider": { + "$ref": "#/definitions/v1AgentProvider", + "description": "The service provider of the agent." + }, + "version": { + "type": "string", + "title": "The version of the agent.\nExample: \"1.0.0\"" + }, + "documentationUrl": { + "type": "string", + "description": "A URL providing additional documentation about the agent." + }, + "capabilities": { + "$ref": "#/definitions/v1AgentCapabilities", + "description": "A2A Capability set supported by the agent." + }, + "securitySchemes": { + "type": "object", + "additionalProperties": { + "$ref": "#/definitions/v1SecurityScheme" + }, + "description": "The security scheme details used for authenticating with this agent." + }, + "securityRequirements": { + "type": "array", + "items": { + "type": "object", + "$ref": "#/definitions/v1SecurityRequirement" + }, + "description": "Security requirements for contacting the agent." + }, + "defaultInputModes": { + "type": "array", + "items": { + "type": "string" + }, + "description": "protolint:enable REPEATED_FIELD_NAMES_PLURALIZED\nThe set of interaction modes that the agent supports across all skills.\nThis can be overridden per skill. Defined as media types." + }, + "defaultOutputModes": { + "type": "array", + "items": { + "type": "string" + }, + "description": "The media types supported as outputs from this agent." + }, + "skills": { + "type": "array", + "items": { + "type": "object", + "$ref": "#/definitions/v1AgentSkill" + }, + "description": "Skills represent the abilities of an agent.\nIt is largely a descriptive concept but represents a more focused set of behaviors that the\nagent is likely to succeed at." + }, + "signatures": { + "type": "array", + "items": { + "type": "object", + "$ref": "#/definitions/v1AgentCardSignature" + }, + "description": "JSON Web Signatures computed for this `AgentCard`." + }, + "iconUrl": { + "type": "string", + "description": "Optional. A URL to an icon for the agent." + } + }, + "title": "A self-describing manifest for an agent. It provides essential\nmetadata including the agent's identity, capabilities, skills, supported\ncommunication methods, and security requirements.\nNext ID: 20", + "required": [ + "name", + "description", + "supportedInterfaces", + "version", + "capabilities", + "defaultInputModes", + "defaultOutputModes", + "skills" + ] + }, + "v1AgentCardSignature": { + "type": "object", + "properties": { + "protected": { + "type": "string", + "description": "\nRequired. The protected JWS header for the signature. This is always a\nbase64url-encoded JSON object." + }, + "signature": { + "type": "string", + "description": "Required. The computed signature, base64url-encoded." + }, + "header": { + "type": "object", + "description": "The unprotected JWS header values." + } + }, + "description": "AgentCardSignature represents a JWS signature of an AgentCard.\nThis follows the JSON format of an RFC 7515 JSON Web Signature (JWS).", + "required": [ + "protected", + "signature" + ] + }, + "v1AgentExtension": { + "type": "object", + "properties": { + "uri": { + "type": "string", + "description": "The unique URI identifying the extension." + }, + "description": { + "type": "string", + "description": "A human-readable description of how this agent uses the extension." + }, + "required": { + "type": "boolean", + "description": "If true, the client must understand and comply with the extension's requirements." + }, + "params": { + "type": "object", + "description": "Optional. Extension-specific configuration parameters." + } + }, + "description": "A declaration of a protocol extension supported by an Agent." + }, + "v1AgentInterface": { + "type": "object", + "properties": { + "url": { + "type": "string", + "title": "The URL where this interface is available. Must be a valid absolute HTTPS URL in production.\nExample: \"https://api.example.com/a2a/v1\", \"https://grpc.example.com/a2a\"" + }, + "protocolBinding": { + "type": "string", + "description": "The protocol binding supported at this URL. This is an open form string, to be\neasily extended for other protocol bindings. The core ones officially\nsupported are `JSONRPC`, `GRPC` and `HTTP+JSON`." + }, + "tenant": { + "type": "string", + "description": "Tenant ID to be used in the request when calling the agent." + }, + "protocolVersion": { + "type": "string", + "title": "The version of the A2A protocol this interface exposes.\nUse the latest supported minor version per major version.\nExamples: \"0.3\", \"1.0\"" + } + }, + "description": "Declares a combination of a target URL, transport and protocol version for interacting with the agent.\nThis allows agents to expose the same functionality over multiple protocol binding mechanisms.", + "required": [ + "url", + "protocolBinding", + "protocolVersion" + ] + }, + "v1AgentProvider": { + "type": "object", + "properties": { + "url": { + "type": "string", + "title": "A URL for the agent provider's website or relevant documentation.\nExample: \"https://ai.google.dev\"" + }, + "organization": { + "type": "string", + "title": "The name of the agent provider's organization.\nExample: \"Google\"" + } + }, + "description": "Represents the service provider of an agent.", + "required": [ + "url", + "organization" + ] + }, + "v1AgentSkill": { + "type": "object", + "properties": { + "id": { + "type": "string", + "description": "A unique identifier for the agent's skill." + }, + "name": { + "type": "string", + "description": "A human-readable name for the skill." + }, + "description": { + "type": "string", + "description": "A detailed description of the skill." + }, + "tags": { + "type": "array", + "items": { + "type": "string" + }, + "description": "A set of keywords describing the skill's capabilities." + }, + "examples": { + "type": "array", + "items": { + "type": "string" + }, + "description": "Example prompts or scenarios that this skill can handle." + }, + "inputModes": { + "type": "array", + "items": { + "type": "string" + }, + "description": "The set of supported input media types for this skill, overriding the agent's defaults." + }, + "outputModes": { + "type": "array", + "items": { + "type": "string" + }, + "description": "The set of supported output media types for this skill, overriding the agent's defaults." + }, + "securityRequirements": { + "type": "array", + "items": { + "type": "object", + "$ref": "#/definitions/v1SecurityRequirement" + }, + "description": "Security schemes necessary for this skill." + } + }, + "description": "Represents a distinct capability or function that an agent can perform.", + "required": [ + "id", + "name", + "description", + "tags" + ] + }, + "v1Artifact": { + "type": "object", + "properties": { + "artifactId": { + "type": "string", + "description": "Unique identifier (e.g. UUID) for the artifact. It must be unique within a task." + }, + "name": { + "type": "string", + "description": "A human readable name for the artifact." + }, + "description": { + "type": "string", + "description": "Optional. A human readable description of the artifact." + }, + "parts": { + "type": "array", + "items": { + "type": "object", + "$ref": "#/definitions/v1Part" + }, + "description": "The content of the artifact. Must contain at least one part." + }, + "metadata": { + "type": "object", + "description": "Optional. Metadata included with the artifact." + }, + "extensions": { + "type": "array", + "items": { + "type": "string" + }, + "description": "The URIs of extensions that are present or contributed to this Artifact." + } + }, + "description": "Artifacts represent task outputs.", + "required": [ + "artifactId", + "parts" + ] + }, + "v1AuthenticationInfo": { + "type": "object", + "properties": { + "scheme": { + "type": "string", + "description": "HTTP Authentication Scheme from the [IANA registry](https://www.iana.org/assignments/http-authschemes/).\nExamples: `Bearer`, `Basic`, `Digest`.\nScheme names are case-insensitive per [RFC 9110 Section 11.1](https://www.rfc-editor.org/rfc/rfc9110#section-11.1)." + }, + "credentials": { + "type": "string", + "description": "Push Notification credentials. Format depends on the scheme (e.g., token for Bearer)." + } + }, + "description": "Defines authentication details, used for push notifications.", + "required": [ + "scheme" + ] + }, + "v1AuthorizationCodeOAuthFlow": { + "type": "object", + "properties": { + "authorizationUrl": { + "type": "string", + "description": "The authorization URL to be used for this flow." + }, + "tokenUrl": { + "type": "string", + "description": "The token URL to be used for this flow." + }, + "refreshUrl": { + "type": "string", + "description": "The URL to be used for obtaining refresh tokens." + }, + "scopes": { + "type": "object", + "additionalProperties": { + "type": "string" + }, + "description": "The available scopes for the OAuth2 security scheme." + }, + "pkceRequired": { + "type": "boolean", + "description": "Indicates if PKCE (RFC 7636) is required for this flow.\nPKCE should always be used for public clients and is recommended for all clients." + } + }, + "description": "Defines configuration details for the OAuth 2.0 Authorization Code flow.", + "required": [ + "authorizationUrl", + "tokenUrl", + "scopes" + ] + }, + "v1ClientCredentialsOAuthFlow": { + "type": "object", + "properties": { + "tokenUrl": { + "type": "string", + "description": "The token URL to be used for this flow." + }, + "refreshUrl": { + "type": "string", + "description": "The URL to be used for obtaining refresh tokens." + }, + "scopes": { + "type": "object", + "additionalProperties": { + "type": "string" + }, + "description": "The available scopes for the OAuth2 security scheme." + } + }, + "description": "Defines configuration details for the OAuth 2.0 Client Credentials flow.", + "required": [ + "tokenUrl", + "scopes" + ] + }, + "v1DeviceCodeOAuthFlow": { + "type": "object", + "properties": { + "deviceAuthorizationUrl": { + "type": "string", + "description": "The device authorization endpoint URL." + }, + "tokenUrl": { + "type": "string", + "description": "The token URL to be used for this flow." + }, + "refreshUrl": { + "type": "string", + "description": "The URL to be used for obtaining refresh tokens." + }, + "scopes": { + "type": "object", + "additionalProperties": { + "type": "string" + }, + "description": "The available scopes for the OAuth2 security scheme." + } + }, + "description": "Defines configuration details for the OAuth 2.0 Device Code flow (RFC 8628).\nThis flow is designed for input-constrained devices such as IoT devices,\nand CLI tools where the user authenticates on a separate device.", + "required": [ + "deviceAuthorizationUrl", + "tokenUrl", + "scopes" + ] + }, + "v1HTTPAuthSecurityScheme": { + "type": "object", + "properties": { + "description": { + "type": "string", + "description": "An optional description for the security scheme." + }, + "scheme": { + "type": "string", + "description": "The name of the HTTP Authentication scheme to be used in the Authorization header,\nas defined in RFC7235 (e.g., \"Bearer\").\nThis value should be registered in the IANA Authentication Scheme registry." + }, + "bearerFormat": { + "type": "string", + "description": "A hint to the client to identify how the bearer token is formatted (e.g., \"JWT\").\nPrimarily for documentation purposes." + } + }, + "description": "Defines a security scheme using HTTP authentication.", + "required": [ + "scheme" + ] + }, + "v1ImplicitOAuthFlow": { + "type": "object", + "properties": { + "authorizationUrl": { + "type": "string", + "title": "The authorization URL to be used for this flow. This MUST be in the\nform of a URL. The OAuth2 standard requires the use of TLS" + }, + "refreshUrl": { + "type": "string", + "description": "The URL to be used for obtaining refresh tokens. This MUST be in the\nform of a URL. The OAuth2 standard requires the use of TLS." + }, + "scopes": { + "type": "object", + "additionalProperties": { + "type": "string" + }, + "description": "The available scopes for the OAuth2 security scheme. A map between the\nscope name and a short description for it. The map MAY be empty." + } + }, + "description": "Deprecated: Use Authorization Code + PKCE instead." + }, + "v1ListTaskPushNotificationConfigsResponse": { + "type": "object", + "properties": { + "configs": { + "type": "array", + "items": { + "type": "object", + "$ref": "#/definitions/v1TaskPushNotificationConfig" + }, + "description": "The list of push notification configurations." + }, + "nextPageToken": { + "type": "string", + "description": "A token to retrieve the next page of results, or empty if there are no more results in the list." + } + }, + "description": "Represents a successful response for the `ListTaskPushNotificationConfigs`\nmethod." + }, + "v1ListTasksResponse": { + "type": "object", + "properties": { + "tasks": { + "type": "array", + "items": { + "type": "object", + "$ref": "#/definitions/v1Task" + }, + "description": "Array of tasks matching the specified criteria." + }, + "nextPageToken": { + "type": "string", + "description": "A token to retrieve the next page of results, or empty if there are no more results in the list." + }, + "pageSize": { + "type": "integer", + "format": "int32", + "description": "The page size used for this response." + }, + "totalSize": { + "type": "integer", + "format": "int32", + "description": "Total number of tasks available (before pagination)." + } + }, + "description": "Result object for `ListTasks` method containing an array of tasks and pagination information.", + "required": [ + "tasks", + "nextPageToken", + "pageSize", + "totalSize" + ] + }, + "v1Message": { + "type": "object", + "properties": { + "messageId": { + "type": "string", + "description": "The unique identifier (e.g. UUID) of the message. This is created by the message creator." + }, + "contextId": { + "type": "string", + "description": "Optional. The context id of the message. If set, the message will be associated with the given context." + }, + "taskId": { + "type": "string", + "description": "Optional. The task id of the message. If set, the message will be associated with the given task." + }, + "role": { + "$ref": "#/definitions/v1Role", + "description": "Identifies the sender of the message." + }, + "parts": { + "type": "array", + "items": { + "type": "object", + "$ref": "#/definitions/v1Part" + }, + "description": "Parts is the container of the message content." + }, + "metadata": { + "type": "object", + "description": "Optional. Any metadata to provide along with the message." + }, + "extensions": { + "type": "array", + "items": { + "type": "string" + }, + "description": "The URIs of extensions that are present or contributed to this Message." + }, + "referenceTaskIds": { + "type": "array", + "items": { + "type": "string" + }, + "description": "A list of task IDs that this message references for additional context." + } + }, + "description": "`Message` is one unit of communication between client and server. It can be\nassociated with a context and/or a task. For server messages, `context_id` must\nbe provided, and `task_id` only if a task was created. For client messages, both\nfields are optional, with the caveat that if both are provided, they have to\nmatch (the `context_id` has to be the one that is set on the task). If only\n`task_id` is provided, the server will infer `context_id` from it.", + "required": [ + "messageId", + "role", + "parts" + ] + }, + "v1MutualTlsSecurityScheme": { + "type": "object", + "properties": { + "description": { + "type": "string", + "description": "An optional description for the security scheme." + } + }, + "description": "Defines a security scheme using mTLS authentication." + }, + "v1OAuth2SecurityScheme": { + "type": "object", + "properties": { + "description": { + "type": "string", + "description": "An optional description for the security scheme." + }, + "flows": { + "$ref": "#/definitions/v1OAuthFlows", + "description": "An object containing configuration information for the supported OAuth 2.0 flows." + }, + "oauth2MetadataUrl": { + "type": "string", + "description": "URL to the OAuth2 authorization server metadata [RFC 8414](https://datatracker.ietf.org/doc/html/rfc8414).\nTLS is required." + } + }, + "description": "Defines a security scheme using OAuth 2.0.", + "required": [ + "flows" + ] + }, + "v1OAuthFlows": { + "type": "object", + "properties": { + "authorizationCode": { + "$ref": "#/definitions/v1AuthorizationCodeOAuthFlow", + "description": "Configuration for the OAuth Authorization Code flow." + }, + "clientCredentials": { + "$ref": "#/definitions/v1ClientCredentialsOAuthFlow", + "description": "Configuration for the OAuth Client Credentials flow." + }, + "implicit": { + "$ref": "#/definitions/v1ImplicitOAuthFlow", + "description": "Deprecated: Use Authorization Code + PKCE instead." + }, + "password": { + "$ref": "#/definitions/v1PasswordOAuthFlow", + "description": "Deprecated: Use Authorization Code + PKCE or Device Code." + }, + "deviceCode": { + "$ref": "#/definitions/v1DeviceCodeOAuthFlow", + "description": "Configuration for the OAuth Device Code flow." + } + }, + "description": "Defines the configuration for the supported OAuth 2.0 flows." + }, + "v1OpenIdConnectSecurityScheme": { + "type": "object", + "properties": { + "description": { + "type": "string", + "description": "An optional description for the security scheme." + }, + "openIdConnectUrl": { + "type": "string", + "description": "The [OpenID Connect Discovery URL](https://openid.net/specs/openid-connect-discovery-1_0.html) for the OIDC provider's metadata." + } + }, + "description": "Defines a security scheme using OpenID Connect.", + "required": [ + "openIdConnectUrl" + ] + }, + "v1Part": { + "type": "object", + "properties": { + "text": { + "type": "string", + "description": "The string content of the `text` part." + }, + "raw": { + "type": "string", + "format": "byte", + "description": "The `raw` byte content of a file. In JSON serialization, this is encoded as a base64 string." + }, + "url": { + "type": "string", + "description": "A `url` pointing to the file's content." + }, + "data": { + "description": "Arbitrary structured `data` as a JSON value (object, array, string, number, boolean, or null)." + }, + "metadata": { + "type": "object", + "description": "Optional. metadata associated with this part." + }, + "filename": { + "type": "string", + "description": "An optional `filename` for the file (e.g., \"document.pdf\")." + }, + "mediaType": { + "type": "string", + "description": "The `media_type` (MIME type) of the part content (e.g., \"text/plain\", \"application/json\", \"image/png\").\nThis field is available for all part types." + } + }, + "description": "`Part` represents a container for a section of communication content.\nParts can be purely textual, some sort of file (image, video, etc) or\na structured data blob (i.e. JSON)." + }, + "v1PasswordOAuthFlow": { + "type": "object", + "properties": { + "tokenUrl": { + "type": "string", + "description": "The token URL to be used for this flow. This MUST be in the form of a URL.\nThe OAuth2 standard requires the use of TLS." + }, + "refreshUrl": { + "type": "string", + "description": "The URL to be used for obtaining refresh tokens. This MUST be in the\nform of a URL. The OAuth2 standard requires the use of TLS." + }, + "scopes": { + "type": "object", + "additionalProperties": { + "type": "string" + }, + "description": "The available scopes for the OAuth2 security scheme. A map between the\nscope name and a short description for it. The map MAY be empty." + } + }, + "description": "Deprecated: Use Authorization Code + PKCE or Device Code." + }, + "v1PushNotificationConfig": { + "type": "object", + "properties": { + "id": { + "type": "string", + "description": "A unique identifier (e.g. UUID) for this push notification configuration." + }, + "url": { + "type": "string", + "description": "The URL where the notification should be sent." + }, + "token": { + "type": "string", + "description": "A token unique for this task or session." + }, + "authentication": { + "$ref": "#/definitions/v1AuthenticationInfo", + "description": "Authentication information required to send the notification." + } + }, + "description": "Configuration for setting up push notifications for task updates.", + "required": [ + "url" + ] + }, + "v1Role": { + "type": "string", + "enum": [ + "ROLE_UNSPECIFIED", + "ROLE_USER", + "ROLE_AGENT" + ], + "default": "ROLE_UNSPECIFIED", + "description": "Defines the sender of a message in A2A protocol communication.\n\n - ROLE_UNSPECIFIED: The role is unspecified.\n - ROLE_USER: The message is from the client to the server.\n - ROLE_AGENT: The message is from the server to the client." + }, + "v1SecurityRequirement": { + "type": "object", + "properties": { + "schemes": { + "type": "object", + "additionalProperties": { + "$ref": "#/definitions/v1StringList" + }, + "description": "A map of security schemes to the required scopes." + } + }, + "description": "Defines the security requirements for an agent." + }, + "v1SecurityScheme": { + "type": "object", + "properties": { + "apiKeySecurityScheme": { + "$ref": "#/definitions/v1APIKeySecurityScheme", + "description": "API key-based authentication." + }, + "httpAuthSecurityScheme": { + "$ref": "#/definitions/v1HTTPAuthSecurityScheme", + "description": "HTTP authentication (Basic, Bearer, etc.)." + }, + "oauth2SecurityScheme": { + "$ref": "#/definitions/v1OAuth2SecurityScheme", + "description": "OAuth 2.0 authentication." + }, + "openIdConnectSecurityScheme": { + "$ref": "#/definitions/v1OpenIdConnectSecurityScheme", + "description": "OpenID Connect authentication." + }, + "mtlsSecurityScheme": { + "$ref": "#/definitions/v1MutualTlsSecurityScheme", + "description": "Mutual TLS authentication." + } + }, + "title": "Defines a security scheme that can be used to secure an agent's endpoints.\nThis is a discriminated union type based on the OpenAPI 3.2 Security Scheme Object.\nSee: https://spec.openapis.org/oas/v3.2.0.html#security-scheme-object" + }, + "v1SendMessageConfiguration": { + "type": "object", + "properties": { + "acceptedOutputModes": { + "type": "array", + "items": { + "type": "string" + }, + "description": "A list of media types the client is prepared to accept for response parts.\nAgents SHOULD use this to tailor their output." + }, + "pushNotificationConfig": { + "$ref": "#/definitions/v1PushNotificationConfig", + "description": "Configuration for the agent to send push notifications for task updates." + }, + "historyLength": { + "type": "integer", + "format": "int32", + "description": "The maximum number of most recent messages from the task's history to retrieve in\nthe response. An unset value means the client does not impose any limit. A\nvalue of zero is a request to not include any messages. The server MUST NOT\nreturn more messages than the provided value, but MAY apply a lower limit." + }, + "blocking": { + "type": "boolean", + "description": "If `true`, the operation MUST wait until the task reaches a terminal state\n(`COMPLETED`, `FAILED`, `CANCELED`, `REJECTED`) or an interrupted state\n(`INPUT_REQUIRED`, `AUTH_REQUIRED`) before returning. Default is `false`." + } + }, + "description": "Configuration of a send message request." + }, + "v1SendMessageRequest": { + "type": "object", + "properties": { + "tenant": { + "type": "string", + "description": "Optional. Tenant ID, provided as a path parameter." + }, + "message": { + "$ref": "#/definitions/v1Message", + "description": "The message to send to the agent." + }, + "configuration": { + "$ref": "#/definitions/v1SendMessageConfiguration", + "description": "Configuration for the send request." + }, + "metadata": { + "type": "object", + "description": "A flexible key-value map for passing additional context or parameters." + } + }, + "description": "Represents a request for the `SendMessage` method.", + "required": [ + "message" + ] + }, + "v1SendMessageResponse": { + "type": "object", + "properties": { + "task": { + "$ref": "#/definitions/v1Task", + "description": "The task created or updated by the message." + }, + "message": { + "$ref": "#/definitions/v1Message", + "description": "A message from the agent." + } + }, + "description": "Represents the response for the `SendMessage` method." + }, + "v1StreamResponse": { + "type": "object", + "properties": { + "task": { + "$ref": "#/definitions/v1Task", + "description": "A Task object containing the current state of the task." + }, + "message": { + "$ref": "#/definitions/v1Message", + "description": "A Message object containing a message from the agent." + }, + "statusUpdate": { + "$ref": "#/definitions/v1TaskStatusUpdateEvent", + "description": "An event indicating a task status update." + }, + "artifactUpdate": { + "$ref": "#/definitions/v1TaskArtifactUpdateEvent", + "description": "An event indicating a task artifact update." + } + }, + "description": "A wrapper object used in streaming operations to encapsulate different types of response data." + }, + "v1StringList": { + "type": "object", + "properties": { + "list": { + "type": "array", + "items": { + "type": "string" + }, + "description": "The individual string values." + } + }, + "description": "protolint:disable REPEATED_FIELD_NAMES_PLURALIZED\nA list of strings." + }, + "v1Task": { + "type": "object", + "properties": { + "id": { + "type": "string", + "description": "Unique identifier (e.g. UUID) for the task, generated by the server for a\nnew task." + }, + "contextId": { + "type": "string", + "description": "Unique identifier (e.g. UUID) for the contextual collection of interactions\n(tasks and messages). Created by the A2A server." + }, + "status": { + "$ref": "#/definitions/v1TaskStatus", + "description": "The current status of a `Task`, including `state` and a `message`." + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "$ref": "#/definitions/v1Artifact" + }, + "description": "A set of output artifacts for a `Task`." + }, + "history": { + "type": "array", + "items": { + "type": "object", + "$ref": "#/definitions/v1Message" + }, + "description": "protolint:disable REPEATED_FIELD_NAMES_PLURALIZED\nThe history of interactions from a `Task`." + }, + "metadata": { + "type": "object", + "description": "protolint:enable REPEATED_FIELD_NAMES_PLURALIZED\nA key/value object to store custom metadata about a task." + } + }, + "description": "`Task` is the core unit of action for A2A. It has a current status\nand when results are created for the task they are stored in the\nartifact. If there are multiple turns for a task, these are stored in\nhistory.", + "required": [ + "id", + "contextId", + "status" + ] + }, + "v1TaskArtifactUpdateEvent": { + "type": "object", + "properties": { + "taskId": { + "type": "string", + "description": "The ID of the task for this artifact." + }, + "contextId": { + "type": "string", + "description": "The ID of the context that this task belongs to." + }, + "artifact": { + "$ref": "#/definitions/v1Artifact", + "description": "The artifact that was generated or updated." + }, + "append": { + "type": "boolean", + "description": "If true, the content of this artifact should be appended to a previously\nsent artifact with the same ID." + }, + "lastChunk": { + "type": "boolean", + "description": "If true, this is the final chunk of the artifact." + }, + "metadata": { + "type": "object", + "description": "Optional. Metadata associated with the artifact update." + } + }, + "description": "A task delta where an artifact has been generated.", + "required": [ + "taskId", + "contextId", + "artifact" + ] + }, + "v1TaskPushNotificationConfig": { + "type": "object", + "properties": { + "tenant": { + "type": "string", + "description": "Optional. Tenant ID." + }, + "taskId": { + "type": "string", + "description": "The ID of the task this configuration is associated with." + }, + "pushNotificationConfig": { + "$ref": "#/definitions/v1PushNotificationConfig", + "description": "The push notification configuration details." + } + }, + "description": "A container associating a push notification configuration with a specific task.", + "required": [ + "taskId", + "pushNotificationConfig" + ] + }, + "v1TaskState": { + "type": "string", + "enum": [ + "TASK_STATE_UNSPECIFIED", + "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" + ], + "default": "TASK_STATE_UNSPECIFIED", + "description": "Defines the possible lifecycle states of a `Task`.\n\n - TASK_STATE_UNSPECIFIED: The task is in an unknown or indeterminate state.\n - TASK_STATE_SUBMITTED: Indicates that a task has been successfully submitted and acknowledged.\n - TASK_STATE_WORKING: Indicates that a task is actively being processed by the agent.\n - TASK_STATE_COMPLETED: Indicates that a task has finished successfully. This is a terminal state.\n - TASK_STATE_FAILED: Indicates that a task has finished with an error. This is a terminal state.\n - TASK_STATE_CANCELED: Indicates that a task was canceled before completion. This is a terminal state.\n - TASK_STATE_INPUT_REQUIRED: Indicates that the agent requires additional user input to proceed. This is an interrupted state.\n - TASK_STATE_REJECTED: Indicates that the agent has decided to not perform the task.\nThis may be done during initial task creation or later once an agent\nhas determined it can't or won't proceed. This is a terminal state.\n - TASK_STATE_AUTH_REQUIRED: Indicates that authentication is required to proceed. This is an interrupted state." + }, + "v1TaskStatus": { + "type": "object", + "properties": { + "state": { + "$ref": "#/definitions/v1TaskState", + "description": "The current state of this task." + }, + "message": { + "$ref": "#/definitions/v1Message", + "description": "A message associated with the status." + }, + "timestamp": { + "type": "string", + "format": "date-time", + "title": "ISO 8601 Timestamp when the status was recorded.\nExample: \"2023-10-27T10:00:00Z\"" + } + }, + "title": "A container for the status of a task", + "required": [ + "state" + ] + }, + "v1TaskStatusUpdateEvent": { + "type": "object", + "properties": { + "taskId": { + "type": "string", + "description": "The ID of the task that has changed." + }, + "contextId": { + "type": "string", + "description": "The ID of the context that the task belongs to." + }, + "status": { + "$ref": "#/definitions/v1TaskStatus", + "description": "The new status of the task." + }, + "metadata": { + "type": "object", + "description": "Optional. Metadata associated with the task update." + } + }, + "description": "An event sent by the agent to notify the client of a change in a task's status.", + "required": [ + "taskId", + "contextId", + "status" + ] + } + } +} From 280a653d48663a2e4cc2b19f2a9d7c9ac88e7f65 Mon Sep 17 00:00:00 2001 From: sokoliva Date: Wed, 25 Mar 2026 15:55:55 +0000 Subject: [PATCH 4/5] remove added files --- =24.0 | 5 ----- a2a-python.code-workspace | 7 ------- 2 files changed, 12 deletions(-) delete mode 100644 =24.0 delete mode 100644 a2a-python.code-workspace diff --git a/=24.0 b/=24.0 deleted file mode 100644 index b57e12fb5..000000000 --- a/=24.0 +++ /dev/null @@ -1,5 +0,0 @@ -Collecting packaging - Using cached packaging-26.0-py3-none-any.whl.metadata (3.3 kB) -Using cached packaging-26.0-py3-none-any.whl (74 kB) -Installing collected packages: packaging -Successfully installed packaging-26.0 diff --git a/a2a-python.code-workspace b/a2a-python.code-workspace deleted file mode 100644 index 443f5a5b2..000000000 --- a/a2a-python.code-workspace +++ /dev/null @@ -1,7 +0,0 @@ -{ - "folders": [ - { - "path": "." - } - ] -} \ No newline at end of file From d65a7548a9bd65ded41230978fdc391e01912339 Mon Sep 17 00:00:00 2001 From: sokoliva Date: Wed, 25 Mar 2026 15:57:15 +0000 Subject: [PATCH 5/5] remove a2a.json --- src/a2a/types/a2a.json | 2265 ---------------------------------------- 1 file changed, 2265 deletions(-) delete mode 100644 src/a2a/types/a2a.json diff --git a/src/a2a/types/a2a.json b/src/a2a/types/a2a.json deleted file mode 100644 index d71800313..000000000 --- a/src/a2a/types/a2a.json +++ /dev/null @@ -1,2265 +0,0 @@ -{ - "swagger": "2.0", - "info": { - "title": "a2a.proto", - "version": "version not set" - }, - "tags": [ - { - "name": "A2AService" - } - ], - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "paths": { - "/extendedAgentCard": { - "get": { - "summary": "Gets the extended agent card for the authenticated agent.", - "operationId": "A2AService_GetExtendedAgentCard", - "responses": { - "200": { - "description": "A successful response.", - "schema": { - "$ref": "#/definitions/v1AgentCard" - } - }, - "default": { - "description": "An unexpected error response.", - "schema": { - "$ref": "#/definitions/rpcStatus" - } - } - }, - "parameters": [ - { - "name": "tenant", - "description": "Optional. Tenant ID, provided as a path parameter.", - "in": "query", - "required": false, - "type": "string" - } - ], - "tags": [ - "A2AService" - ] - } - }, - "/message:send": { - "post": { - "summary": "Sends a message to an agent.", - "operationId": "A2AService_SendMessage", - "responses": { - "200": { - "description": "A successful response.", - "schema": { - "$ref": "#/definitions/v1SendMessageResponse" - } - }, - "default": { - "description": "An unexpected error response.", - "schema": { - "$ref": "#/definitions/rpcStatus" - } - } - }, - "parameters": [ - { - "name": "body", - "description": "Represents a request for the `SendMessage` method.", - "in": "body", - "required": true, - "schema": { - "$ref": "#/definitions/v1SendMessageRequest" - } - } - ], - "tags": [ - "A2AService" - ] - } - }, - "/message:stream": { - "post": { - "summary": "Sends a streaming message to an agent, allowing for real-time interaction and status updates.\nStreaming version of `SendMessage`", - "operationId": "A2AService_SendStreamingMessage", - "responses": { - "200": { - "description": "A successful response.(streaming responses)", - "schema": { - "type": "object", - "properties": { - "result": { - "$ref": "#/definitions/v1StreamResponse" - }, - "error": { - "$ref": "#/definitions/rpcStatus" - } - }, - "title": "Stream result of v1StreamResponse" - } - }, - "default": { - "description": "An unexpected error response.", - "schema": { - "$ref": "#/definitions/rpcStatus" - } - } - }, - "parameters": [ - { - "name": "body", - "description": "Represents a request for the `SendMessage` method.", - "in": "body", - "required": true, - "schema": { - "$ref": "#/definitions/v1SendMessageRequest" - } - } - ], - "tags": [ - "A2AService" - ] - } - }, - "/tasks": { - "get": { - "summary": "Lists tasks that match the specified filter.", - "operationId": "A2AService_ListTasks", - "responses": { - "200": { - "description": "A successful response.", - "schema": { - "$ref": "#/definitions/v1ListTasksResponse" - } - }, - "default": { - "description": "An unexpected error response.", - "schema": { - "$ref": "#/definitions/rpcStatus" - } - } - }, - "parameters": [ - { - "name": "tenant", - "description": "Tenant ID, provided as a path parameter.", - "in": "query", - "required": false, - "type": "string" - }, - { - "name": "contextId", - "description": "Filter tasks by context ID to get tasks from a specific conversation or session.", - "in": "query", - "required": false, - "type": "string" - }, - { - "name": "status", - "description": "Filter tasks by their current status state.\n\n - TASK_STATE_UNSPECIFIED: The task is in an unknown or indeterminate state.\n - TASK_STATE_SUBMITTED: Indicates that a task has been successfully submitted and acknowledged.\n - TASK_STATE_WORKING: Indicates that a task is actively being processed by the agent.\n - TASK_STATE_COMPLETED: Indicates that a task has finished successfully. This is a terminal state.\n - TASK_STATE_FAILED: Indicates that a task has finished with an error. This is a terminal state.\n - TASK_STATE_CANCELED: Indicates that a task was canceled before completion. This is a terminal state.\n - TASK_STATE_INPUT_REQUIRED: Indicates that the agent requires additional user input to proceed. This is an interrupted state.\n - TASK_STATE_REJECTED: Indicates that the agent has decided to not perform the task.\nThis may be done during initial task creation or later once an agent\nhas determined it can't or won't proceed. This is a terminal state.\n - TASK_STATE_AUTH_REQUIRED: Indicates that authentication is required to proceed. This is an interrupted state.", - "in": "query", - "required": false, - "type": "string", - "enum": [ - "TASK_STATE_UNSPECIFIED", - "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" - ], - "default": "TASK_STATE_UNSPECIFIED" - }, - { - "name": "pageSize", - "description": "The maximum number of tasks to return. The service may return fewer than this value.\nIf unspecified, at most 50 tasks will be returned.\nThe minimum value is 1.\nThe maximum value is 100.", - "in": "query", - "required": false, - "type": "integer", - "format": "int32" - }, - { - "name": "pageToken", - "description": "A page token, received from a previous `ListTasks` call.\n`ListTasksResponse.next_page_token`.\nProvide this to retrieve the subsequent page.", - "in": "query", - "required": false, - "type": "string" - }, - { - "name": "historyLength", - "description": "The maximum number of messages to include in each task's history.", - "in": "query", - "required": false, - "type": "integer", - "format": "int32" - }, - { - "name": "statusTimestampAfter", - "description": "Filter tasks which have a status updated after the provided timestamp in ISO 8601 format (e.g., \"2023-10-27T10:00:00Z\").\nOnly tasks with a status timestamp time greater than or equal to this value will be returned.", - "in": "query", - "required": false, - "type": "string", - "format": "date-time" - }, - { - "name": "includeArtifacts", - "description": "Whether to include artifacts in the returned tasks.\nDefaults to false to reduce payload size.", - "in": "query", - "required": false, - "type": "boolean" - } - ], - "tags": [ - "A2AService" - ] - } - }, - "/tasks/{id}": { - "get": { - "summary": "Gets the latest state of a task.", - "operationId": "A2AService_GetTask", - "responses": { - "200": { - "description": "A successful response.", - "schema": { - "$ref": "#/definitions/v1Task" - } - }, - "default": { - "description": "An unexpected error response.", - "schema": { - "$ref": "#/definitions/rpcStatus" - } - } - }, - "parameters": [ - { - "name": "id", - "description": "The resource ID of the task to retrieve.", - "in": "path", - "required": true, - "type": "string", - "pattern": "[^/]+" - }, - { - "name": "tenant", - "description": "Optional. Tenant ID, provided as a path parameter.", - "in": "query", - "required": false, - "type": "string" - }, - { - "name": "historyLength", - "description": "The maximum number of most recent messages from the task's history to retrieve. An\nunset value means the client does not impose any limit. A value of zero is\na request to not include any messages. The server MUST NOT return more\nmessages than the provided value, but MAY apply a lower limit.", - "in": "query", - "required": false, - "type": "integer", - "format": "int32" - } - ], - "tags": [ - "A2AService" - ] - } - }, - "/tasks/{id}:cancel": { - "post": { - "summary": "Cancels a task in progress.", - "operationId": "A2AService_CancelTask", - "responses": { - "200": { - "description": "A successful response.", - "schema": { - "$ref": "#/definitions/v1Task" - } - }, - "default": { - "description": "An unexpected error response.", - "schema": { - "$ref": "#/definitions/rpcStatus" - } - } - }, - "parameters": [ - { - "name": "id", - "description": "The resource ID of the task to cancel.", - "in": "path", - "required": true, - "type": "string", - "pattern": "[^/]+" - }, - { - "name": "body", - "in": "body", - "required": true, - "schema": { - "$ref": "#/definitions/A2AServiceCancelTaskBody" - } - } - ], - "tags": [ - "A2AService" - ] - } - }, - "/tasks/{id}:subscribe": { - "get": { - "summary": "Subscribes to task updates for tasks not in a terminal state.\nReturns `UnsupportedOperationError` if the task is already in a terminal state (completed, failed, canceled, rejected).", - "operationId": "A2AService_SubscribeToTask", - "responses": { - "200": { - "description": "A successful response.(streaming responses)", - "schema": { - "type": "object", - "properties": { - "result": { - "$ref": "#/definitions/v1StreamResponse" - }, - "error": { - "$ref": "#/definitions/rpcStatus" - } - }, - "title": "Stream result of v1StreamResponse" - } - }, - "default": { - "description": "An unexpected error response.", - "schema": { - "$ref": "#/definitions/rpcStatus" - } - } - }, - "parameters": [ - { - "name": "id", - "description": "The resource ID of the task to subscribe to.", - "in": "path", - "required": true, - "type": "string", - "pattern": "[^/]+" - }, - { - "name": "tenant", - "description": "Optional. Tenant ID, provided as a path parameter.", - "in": "query", - "required": false, - "type": "string" - } - ], - "tags": [ - "A2AService" - ] - } - }, - "/tasks/{taskId}/pushNotificationConfigs": { - "get": { - "summary": "Get a list of push notifications configured for a task.", - "operationId": "A2AService_ListTaskPushNotificationConfigs", - "responses": { - "200": { - "description": "A successful response.", - "schema": { - "$ref": "#/definitions/v1ListTaskPushNotificationConfigsResponse" - } - }, - "default": { - "description": "An unexpected error response.", - "schema": { - "$ref": "#/definitions/rpcStatus" - } - } - }, - "parameters": [ - { - "name": "taskId", - "description": "The parent task resource ID.", - "in": "path", - "required": true, - "type": "string", - "pattern": "[^/]+" - }, - { - "name": "tenant", - "description": "Optional. Tenant ID, provided as a path parameter.", - "in": "query", - "required": false, - "type": "string" - }, - { - "name": "pageSize", - "description": "The maximum number of configurations to return.", - "in": "query", - "required": false, - "type": "integer", - "format": "int32" - }, - { - "name": "pageToken", - "description": "A page token received from a previous `ListTaskPushNotificationConfigsRequest` call.", - "in": "query", - "required": false, - "type": "string" - } - ], - "tags": [ - "A2AService" - ] - }, - "post": { - "summary": "Creates a push notification config for a task.", - "operationId": "A2AService_CreateTaskPushNotificationConfig", - "responses": { - "200": { - "description": "A successful response.", - "schema": { - "$ref": "#/definitions/v1TaskPushNotificationConfig" - } - }, - "default": { - "description": "An unexpected error response.", - "schema": { - "$ref": "#/definitions/rpcStatus" - } - } - }, - "parameters": [ - { - "name": "taskId", - "description": "The parent task resource ID.", - "in": "path", - "required": true, - "type": "string", - "pattern": "[^/]+" - }, - { - "name": "config", - "description": "The configuration to create.", - "in": "body", - "required": true, - "schema": { - "$ref": "#/definitions/v1PushNotificationConfig" - } - }, - { - "name": "tenant", - "description": "Optional. Tenant ID, provided as a path parameter.", - "in": "query", - "required": false, - "type": "string" - } - ], - "tags": [ - "A2AService" - ] - } - }, - "/tasks/{taskId}/pushNotificationConfigs/{id}": { - "get": { - "summary": "Gets a push notification config for a task.", - "operationId": "A2AService_GetTaskPushNotificationConfig", - "responses": { - "200": { - "description": "A successful response.", - "schema": { - "$ref": "#/definitions/v1TaskPushNotificationConfig" - } - }, - "default": { - "description": "An unexpected error response.", - "schema": { - "$ref": "#/definitions/rpcStatus" - } - } - }, - "parameters": [ - { - "name": "taskId", - "description": "The parent task resource ID.", - "in": "path", - "required": true, - "type": "string", - "pattern": "[^/]+" - }, - { - "name": "id", - "description": "The resource ID of the configuration to retrieve.", - "in": "path", - "required": true, - "type": "string", - "pattern": "[^/]+" - }, - { - "name": "tenant", - "description": "Optional. Tenant ID, provided as a path parameter.", - "in": "query", - "required": false, - "type": "string" - } - ], - "tags": [ - "A2AService" - ] - }, - "delete": { - "summary": "Deletes a push notification config for a task.", - "operationId": "A2AService_DeleteTaskPushNotificationConfig", - "responses": { - "200": { - "description": "A successful response.", - "schema": { - "type": "object", - "properties": {} - } - }, - "default": { - "description": "An unexpected error response.", - "schema": { - "$ref": "#/definitions/rpcStatus" - } - } - }, - "parameters": [ - { - "name": "taskId", - "description": "The parent task resource ID.", - "in": "path", - "required": true, - "type": "string", - "pattern": "[^/]+" - }, - { - "name": "id", - "description": "The resource ID of the configuration to delete.", - "in": "path", - "required": true, - "type": "string", - "pattern": "[^/]+" - }, - { - "name": "tenant", - "description": "Optional. Tenant ID, provided as a path parameter.", - "in": "query", - "required": false, - "type": "string" - } - ], - "tags": [ - "A2AService" - ] - } - }, - "/{tenant}/extendedAgentCard": { - "get": { - "summary": "Gets the extended agent card for the authenticated agent.", - "operationId": "A2AService_GetExtendedAgentCard2", - "responses": { - "200": { - "description": "A successful response.", - "schema": { - "$ref": "#/definitions/v1AgentCard" - } - }, - "default": { - "description": "An unexpected error response.", - "schema": { - "$ref": "#/definitions/rpcStatus" - } - } - }, - "parameters": [ - { - "name": "tenant", - "description": "Optional. Tenant ID, provided as a path parameter.", - "in": "path", - "required": true, - "type": "string" - } - ], - "tags": [ - "A2AService" - ] - } - }, - "/{tenant}/message:send": { - "post": { - "summary": "Sends a message to an agent.", - "operationId": "A2AService_SendMessage2", - "responses": { - "200": { - "description": "A successful response.", - "schema": { - "$ref": "#/definitions/v1SendMessageResponse" - } - }, - "default": { - "description": "An unexpected error response.", - "schema": { - "$ref": "#/definitions/rpcStatus" - } - } - }, - "parameters": [ - { - "name": "tenant", - "description": "Optional. Tenant ID, provided as a path parameter.", - "in": "path", - "required": true, - "type": "string" - }, - { - "name": "body", - "in": "body", - "required": true, - "schema": { - "$ref": "#/definitions/A2AServiceSendMessageBody" - } - } - ], - "tags": [ - "A2AService" - ] - } - }, - "/{tenant}/message:stream": { - "post": { - "summary": "Sends a streaming message to an agent, allowing for real-time interaction and status updates.\nStreaming version of `SendMessage`", - "operationId": "A2AService_SendStreamingMessage2", - "responses": { - "200": { - "description": "A successful response.(streaming responses)", - "schema": { - "type": "object", - "properties": { - "result": { - "$ref": "#/definitions/v1StreamResponse" - }, - "error": { - "$ref": "#/definitions/rpcStatus" - } - }, - "title": "Stream result of v1StreamResponse" - } - }, - "default": { - "description": "An unexpected error response.", - "schema": { - "$ref": "#/definitions/rpcStatus" - } - } - }, - "parameters": [ - { - "name": "tenant", - "description": "Optional. Tenant ID, provided as a path parameter.", - "in": "path", - "required": true, - "type": "string" - }, - { - "name": "body", - "in": "body", - "required": true, - "schema": { - "$ref": "#/definitions/A2AServiceSendStreamingMessageBody" - } - } - ], - "tags": [ - "A2AService" - ] - } - }, - "/{tenant}/tasks": { - "get": { - "summary": "Lists tasks that match the specified filter.", - "operationId": "A2AService_ListTasks2", - "responses": { - "200": { - "description": "A successful response.", - "schema": { - "$ref": "#/definitions/v1ListTasksResponse" - } - }, - "default": { - "description": "An unexpected error response.", - "schema": { - "$ref": "#/definitions/rpcStatus" - } - } - }, - "parameters": [ - { - "name": "tenant", - "description": "Tenant ID, provided as a path parameter.", - "in": "path", - "required": true, - "type": "string" - }, - { - "name": "contextId", - "description": "Filter tasks by context ID to get tasks from a specific conversation or session.", - "in": "query", - "required": false, - "type": "string" - }, - { - "name": "status", - "description": "Filter tasks by their current status state.\n\n - TASK_STATE_UNSPECIFIED: The task is in an unknown or indeterminate state.\n - TASK_STATE_SUBMITTED: Indicates that a task has been successfully submitted and acknowledged.\n - TASK_STATE_WORKING: Indicates that a task is actively being processed by the agent.\n - TASK_STATE_COMPLETED: Indicates that a task has finished successfully. This is a terminal state.\n - TASK_STATE_FAILED: Indicates that a task has finished with an error. This is a terminal state.\n - TASK_STATE_CANCELED: Indicates that a task was canceled before completion. This is a terminal state.\n - TASK_STATE_INPUT_REQUIRED: Indicates that the agent requires additional user input to proceed. This is an interrupted state.\n - TASK_STATE_REJECTED: Indicates that the agent has decided to not perform the task.\nThis may be done during initial task creation or later once an agent\nhas determined it can't or won't proceed. This is a terminal state.\n - TASK_STATE_AUTH_REQUIRED: Indicates that authentication is required to proceed. This is an interrupted state.", - "in": "query", - "required": false, - "type": "string", - "enum": [ - "TASK_STATE_UNSPECIFIED", - "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" - ], - "default": "TASK_STATE_UNSPECIFIED" - }, - { - "name": "pageSize", - "description": "The maximum number of tasks to return. The service may return fewer than this value.\nIf unspecified, at most 50 tasks will be returned.\nThe minimum value is 1.\nThe maximum value is 100.", - "in": "query", - "required": false, - "type": "integer", - "format": "int32" - }, - { - "name": "pageToken", - "description": "A page token, received from a previous `ListTasks` call.\n`ListTasksResponse.next_page_token`.\nProvide this to retrieve the subsequent page.", - "in": "query", - "required": false, - "type": "string" - }, - { - "name": "historyLength", - "description": "The maximum number of messages to include in each task's history.", - "in": "query", - "required": false, - "type": "integer", - "format": "int32" - }, - { - "name": "statusTimestampAfter", - "description": "Filter tasks which have a status updated after the provided timestamp in ISO 8601 format (e.g., \"2023-10-27T10:00:00Z\").\nOnly tasks with a status timestamp time greater than or equal to this value will be returned.", - "in": "query", - "required": false, - "type": "string", - "format": "date-time" - }, - { - "name": "includeArtifacts", - "description": "Whether to include artifacts in the returned tasks.\nDefaults to false to reduce payload size.", - "in": "query", - "required": false, - "type": "boolean" - } - ], - "tags": [ - "A2AService" - ] - } - }, - "/{tenant}/tasks/{id}": { - "get": { - "summary": "Gets the latest state of a task.", - "operationId": "A2AService_GetTask2", - "responses": { - "200": { - "description": "A successful response.", - "schema": { - "$ref": "#/definitions/v1Task" - } - }, - "default": { - "description": "An unexpected error response.", - "schema": { - "$ref": "#/definitions/rpcStatus" - } - } - }, - "parameters": [ - { - "name": "tenant", - "description": "Optional. Tenant ID, provided as a path parameter.", - "in": "path", - "required": true, - "type": "string" - }, - { - "name": "id", - "description": "The resource ID of the task to retrieve.", - "in": "path", - "required": true, - "type": "string", - "pattern": "[^/]+" - }, - { - "name": "historyLength", - "description": "The maximum number of most recent messages from the task's history to retrieve. An\nunset value means the client does not impose any limit. A value of zero is\na request to not include any messages. The server MUST NOT return more\nmessages than the provided value, but MAY apply a lower limit.", - "in": "query", - "required": false, - "type": "integer", - "format": "int32" - } - ], - "tags": [ - "A2AService" - ] - } - }, - "/{tenant}/tasks/{id}:cancel": { - "post": { - "summary": "Cancels a task in progress.", - "operationId": "A2AService_CancelTask2", - "responses": { - "200": { - "description": "A successful response.", - "schema": { - "$ref": "#/definitions/v1Task" - } - }, - "default": { - "description": "An unexpected error response.", - "schema": { - "$ref": "#/definitions/rpcStatus" - } - } - }, - "parameters": [ - { - "name": "tenant", - "description": "Optional. Tenant ID, provided as a path parameter.", - "in": "path", - "required": true, - "type": "string" - }, - { - "name": "id", - "description": "The resource ID of the task to cancel.", - "in": "path", - "required": true, - "type": "string", - "pattern": "[^/]+" - }, - { - "name": "body", - "in": "body", - "required": true, - "schema": { - "$ref": "#/definitions/A2AServiceCancelTaskBody" - } - } - ], - "tags": [ - "A2AService" - ] - } - }, - "/{tenant}/tasks/{id}:subscribe": { - "get": { - "summary": "Subscribes to task updates for tasks not in a terminal state.\nReturns `UnsupportedOperationError` if the task is already in a terminal state (completed, failed, canceled, rejected).", - "operationId": "A2AService_SubscribeToTask2", - "responses": { - "200": { - "description": "A successful response.(streaming responses)", - "schema": { - "type": "object", - "properties": { - "result": { - "$ref": "#/definitions/v1StreamResponse" - }, - "error": { - "$ref": "#/definitions/rpcStatus" - } - }, - "title": "Stream result of v1StreamResponse" - } - }, - "default": { - "description": "An unexpected error response.", - "schema": { - "$ref": "#/definitions/rpcStatus" - } - } - }, - "parameters": [ - { - "name": "tenant", - "description": "Optional. Tenant ID, provided as a path parameter.", - "in": "path", - "required": true, - "type": "string" - }, - { - "name": "id", - "description": "The resource ID of the task to subscribe to.", - "in": "path", - "required": true, - "type": "string", - "pattern": "[^/]+" - } - ], - "tags": [ - "A2AService" - ] - } - }, - "/{tenant}/tasks/{taskId}/pushNotificationConfigs": { - "get": { - "summary": "Get a list of push notifications configured for a task.", - "operationId": "A2AService_ListTaskPushNotificationConfigs2", - "responses": { - "200": { - "description": "A successful response.", - "schema": { - "$ref": "#/definitions/v1ListTaskPushNotificationConfigsResponse" - } - }, - "default": { - "description": "An unexpected error response.", - "schema": { - "$ref": "#/definitions/rpcStatus" - } - } - }, - "parameters": [ - { - "name": "tenant", - "description": "Optional. Tenant ID, provided as a path parameter.", - "in": "path", - "required": true, - "type": "string" - }, - { - "name": "taskId", - "description": "The parent task resource ID.", - "in": "path", - "required": true, - "type": "string", - "pattern": "[^/]+" - }, - { - "name": "pageSize", - "description": "The maximum number of configurations to return.", - "in": "query", - "required": false, - "type": "integer", - "format": "int32" - }, - { - "name": "pageToken", - "description": "A page token received from a previous `ListTaskPushNotificationConfigsRequest` call.", - "in": "query", - "required": false, - "type": "string" - } - ], - "tags": [ - "A2AService" - ] - }, - "post": { - "summary": "Creates a push notification config for a task.", - "operationId": "A2AService_CreateTaskPushNotificationConfig2", - "responses": { - "200": { - "description": "A successful response.", - "schema": { - "$ref": "#/definitions/v1TaskPushNotificationConfig" - } - }, - "default": { - "description": "An unexpected error response.", - "schema": { - "$ref": "#/definitions/rpcStatus" - } - } - }, - "parameters": [ - { - "name": "tenant", - "description": "Optional. Tenant ID, provided as a path parameter.", - "in": "path", - "required": true, - "type": "string" - }, - { - "name": "taskId", - "description": "The parent task resource ID.", - "in": "path", - "required": true, - "type": "string", - "pattern": "[^/]+" - }, - { - "name": "config", - "description": "The configuration to create.", - "in": "body", - "required": true, - "schema": { - "$ref": "#/definitions/v1PushNotificationConfig" - } - } - ], - "tags": [ - "A2AService" - ] - } - }, - "/{tenant}/tasks/{taskId}/pushNotificationConfigs/{id}": { - "get": { - "summary": "Gets a push notification config for a task.", - "operationId": "A2AService_GetTaskPushNotificationConfig2", - "responses": { - "200": { - "description": "A successful response.", - "schema": { - "$ref": "#/definitions/v1TaskPushNotificationConfig" - } - }, - "default": { - "description": "An unexpected error response.", - "schema": { - "$ref": "#/definitions/rpcStatus" - } - } - }, - "parameters": [ - { - "name": "tenant", - "description": "Optional. Tenant ID, provided as a path parameter.", - "in": "path", - "required": true, - "type": "string" - }, - { - "name": "taskId", - "description": "The parent task resource ID.", - "in": "path", - "required": true, - "type": "string", - "pattern": "[^/]+" - }, - { - "name": "id", - "description": "The resource ID of the configuration to retrieve.", - "in": "path", - "required": true, - "type": "string", - "pattern": "[^/]+" - } - ], - "tags": [ - "A2AService" - ] - }, - "delete": { - "summary": "Deletes a push notification config for a task.", - "operationId": "A2AService_DeleteTaskPushNotificationConfig2", - "responses": { - "200": { - "description": "A successful response.", - "schema": { - "type": "object", - "properties": {} - } - }, - "default": { - "description": "An unexpected error response.", - "schema": { - "$ref": "#/definitions/rpcStatus" - } - } - }, - "parameters": [ - { - "name": "tenant", - "description": "Optional. Tenant ID, provided as a path parameter.", - "in": "path", - "required": true, - "type": "string" - }, - { - "name": "taskId", - "description": "The parent task resource ID.", - "in": "path", - "required": true, - "type": "string", - "pattern": "[^/]+" - }, - { - "name": "id", - "description": "The resource ID of the configuration to delete.", - "in": "path", - "required": true, - "type": "string", - "pattern": "[^/]+" - } - ], - "tags": [ - "A2AService" - ] - } - } - }, - "definitions": { - "A2AServiceCancelTaskBody": { - "type": "object", - "properties": { - "metadata": { - "type": "object", - "description": "A flexible key-value map for passing additional context or parameters." - } - }, - "description": "Represents a request for the `CancelTask` method." - }, - "A2AServiceSendMessageBody": { - "type": "object", - "properties": { - "message": { - "$ref": "#/definitions/v1Message", - "description": "The message to send to the agent." - }, - "configuration": { - "$ref": "#/definitions/v1SendMessageConfiguration", - "description": "Configuration for the send request." - }, - "metadata": { - "type": "object", - "description": "A flexible key-value map for passing additional context or parameters." - } - }, - "description": "Represents a request for the `SendMessage` method.", - "required": [ - "message" - ] - }, - "A2AServiceSendStreamingMessageBody": { - "type": "object", - "properties": { - "message": { - "$ref": "#/definitions/v1Message", - "description": "The message to send to the agent." - }, - "configuration": { - "$ref": "#/definitions/v1SendMessageConfiguration", - "description": "Configuration for the send request." - }, - "metadata": { - "type": "object", - "description": "A flexible key-value map for passing additional context or parameters." - } - }, - "description": "Represents a request for the `SendMessage` method.", - "required": [ - "message" - ] - }, - "protobufAny": { - "type": "object", - "properties": { - "@type": { - "type": "string" - } - }, - "additionalProperties": {} - }, - "protobufNullValue": { - "type": "string", - "enum": [ - "NULL_VALUE" - ], - "default": "NULL_VALUE", - "description": "`NullValue` is a singleton enumeration to represent the null value for the\n`Value` type union.\n\nThe JSON representation for `NullValue` is JSON `null`.\n\n - NULL_VALUE: Null value." - }, - "rpcStatus": { - "type": "object", - "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { - "type": "string" - }, - "details": { - "type": "array", - "items": { - "type": "object", - "$ref": "#/definitions/protobufAny" - } - } - } - }, - "v1APIKeySecurityScheme": { - "type": "object", - "properties": { - "description": { - "type": "string", - "description": "An optional description for the security scheme." - }, - "location": { - "type": "string", - "description": "The location of the API key. Valid values are \"query\", \"header\", or \"cookie\"." - }, - "name": { - "type": "string", - "description": "The name of the header, query, or cookie parameter to be used." - } - }, - "description": "Defines a security scheme using an API key.", - "required": [ - "location", - "name" - ] - }, - "v1AgentCapabilities": { - "type": "object", - "properties": { - "streaming": { - "type": "boolean", - "description": "Indicates if the agent supports streaming responses." - }, - "pushNotifications": { - "type": "boolean", - "description": "Indicates if the agent supports sending push notifications for asynchronous task updates." - }, - "extensions": { - "type": "array", - "items": { - "type": "object", - "$ref": "#/definitions/v1AgentExtension" - }, - "description": "A list of protocol extensions supported by the agent." - }, - "extendedAgentCard": { - "type": "boolean", - "description": "Indicates if the agent supports providing an extended agent card when authenticated." - } - }, - "description": "Defines optional capabilities supported by an agent." - }, - "v1AgentCard": { - "type": "object", - "properties": { - "name": { - "type": "string", - "title": "A human readable name for the agent.\nExample: \"Recipe Agent\"" - }, - "description": { - "type": "string", - "title": "A human-readable description of the agent, assisting users and other agents\nin understanding its purpose.\nExample: \"Agent that helps users with recipes and cooking.\"" - }, - "supportedInterfaces": { - "type": "array", - "items": { - "type": "object", - "$ref": "#/definitions/v1AgentInterface" - }, - "description": "Ordered list of supported interfaces. The first entry is preferred." - }, - "provider": { - "$ref": "#/definitions/v1AgentProvider", - "description": "The service provider of the agent." - }, - "version": { - "type": "string", - "title": "The version of the agent.\nExample: \"1.0.0\"" - }, - "documentationUrl": { - "type": "string", - "description": "A URL providing additional documentation about the agent." - }, - "capabilities": { - "$ref": "#/definitions/v1AgentCapabilities", - "description": "A2A Capability set supported by the agent." - }, - "securitySchemes": { - "type": "object", - "additionalProperties": { - "$ref": "#/definitions/v1SecurityScheme" - }, - "description": "The security scheme details used for authenticating with this agent." - }, - "securityRequirements": { - "type": "array", - "items": { - "type": "object", - "$ref": "#/definitions/v1SecurityRequirement" - }, - "description": "Security requirements for contacting the agent." - }, - "defaultInputModes": { - "type": "array", - "items": { - "type": "string" - }, - "description": "protolint:enable REPEATED_FIELD_NAMES_PLURALIZED\nThe set of interaction modes that the agent supports across all skills.\nThis can be overridden per skill. Defined as media types." - }, - "defaultOutputModes": { - "type": "array", - "items": { - "type": "string" - }, - "description": "The media types supported as outputs from this agent." - }, - "skills": { - "type": "array", - "items": { - "type": "object", - "$ref": "#/definitions/v1AgentSkill" - }, - "description": "Skills represent the abilities of an agent.\nIt is largely a descriptive concept but represents a more focused set of behaviors that the\nagent is likely to succeed at." - }, - "signatures": { - "type": "array", - "items": { - "type": "object", - "$ref": "#/definitions/v1AgentCardSignature" - }, - "description": "JSON Web Signatures computed for this `AgentCard`." - }, - "iconUrl": { - "type": "string", - "description": "Optional. A URL to an icon for the agent." - } - }, - "title": "A self-describing manifest for an agent. It provides essential\nmetadata including the agent's identity, capabilities, skills, supported\ncommunication methods, and security requirements.\nNext ID: 20", - "required": [ - "name", - "description", - "supportedInterfaces", - "version", - "capabilities", - "defaultInputModes", - "defaultOutputModes", - "skills" - ] - }, - "v1AgentCardSignature": { - "type": "object", - "properties": { - "protected": { - "type": "string", - "description": "\nRequired. The protected JWS header for the signature. This is always a\nbase64url-encoded JSON object." - }, - "signature": { - "type": "string", - "description": "Required. The computed signature, base64url-encoded." - }, - "header": { - "type": "object", - "description": "The unprotected JWS header values." - } - }, - "description": "AgentCardSignature represents a JWS signature of an AgentCard.\nThis follows the JSON format of an RFC 7515 JSON Web Signature (JWS).", - "required": [ - "protected", - "signature" - ] - }, - "v1AgentExtension": { - "type": "object", - "properties": { - "uri": { - "type": "string", - "description": "The unique URI identifying the extension." - }, - "description": { - "type": "string", - "description": "A human-readable description of how this agent uses the extension." - }, - "required": { - "type": "boolean", - "description": "If true, the client must understand and comply with the extension's requirements." - }, - "params": { - "type": "object", - "description": "Optional. Extension-specific configuration parameters." - } - }, - "description": "A declaration of a protocol extension supported by an Agent." - }, - "v1AgentInterface": { - "type": "object", - "properties": { - "url": { - "type": "string", - "title": "The URL where this interface is available. Must be a valid absolute HTTPS URL in production.\nExample: \"https://api.example.com/a2a/v1\", \"https://grpc.example.com/a2a\"" - }, - "protocolBinding": { - "type": "string", - "description": "The protocol binding supported at this URL. This is an open form string, to be\neasily extended for other protocol bindings. The core ones officially\nsupported are `JSONRPC`, `GRPC` and `HTTP+JSON`." - }, - "tenant": { - "type": "string", - "description": "Tenant ID to be used in the request when calling the agent." - }, - "protocolVersion": { - "type": "string", - "title": "The version of the A2A protocol this interface exposes.\nUse the latest supported minor version per major version.\nExamples: \"0.3\", \"1.0\"" - } - }, - "description": "Declares a combination of a target URL, transport and protocol version for interacting with the agent.\nThis allows agents to expose the same functionality over multiple protocol binding mechanisms.", - "required": [ - "url", - "protocolBinding", - "protocolVersion" - ] - }, - "v1AgentProvider": { - "type": "object", - "properties": { - "url": { - "type": "string", - "title": "A URL for the agent provider's website or relevant documentation.\nExample: \"https://ai.google.dev\"" - }, - "organization": { - "type": "string", - "title": "The name of the agent provider's organization.\nExample: \"Google\"" - } - }, - "description": "Represents the service provider of an agent.", - "required": [ - "url", - "organization" - ] - }, - "v1AgentSkill": { - "type": "object", - "properties": { - "id": { - "type": "string", - "description": "A unique identifier for the agent's skill." - }, - "name": { - "type": "string", - "description": "A human-readable name for the skill." - }, - "description": { - "type": "string", - "description": "A detailed description of the skill." - }, - "tags": { - "type": "array", - "items": { - "type": "string" - }, - "description": "A set of keywords describing the skill's capabilities." - }, - "examples": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Example prompts or scenarios that this skill can handle." - }, - "inputModes": { - "type": "array", - "items": { - "type": "string" - }, - "description": "The set of supported input media types for this skill, overriding the agent's defaults." - }, - "outputModes": { - "type": "array", - "items": { - "type": "string" - }, - "description": "The set of supported output media types for this skill, overriding the agent's defaults." - }, - "securityRequirements": { - "type": "array", - "items": { - "type": "object", - "$ref": "#/definitions/v1SecurityRequirement" - }, - "description": "Security schemes necessary for this skill." - } - }, - "description": "Represents a distinct capability or function that an agent can perform.", - "required": [ - "id", - "name", - "description", - "tags" - ] - }, - "v1Artifact": { - "type": "object", - "properties": { - "artifactId": { - "type": "string", - "description": "Unique identifier (e.g. UUID) for the artifact. It must be unique within a task." - }, - "name": { - "type": "string", - "description": "A human readable name for the artifact." - }, - "description": { - "type": "string", - "description": "Optional. A human readable description of the artifact." - }, - "parts": { - "type": "array", - "items": { - "type": "object", - "$ref": "#/definitions/v1Part" - }, - "description": "The content of the artifact. Must contain at least one part." - }, - "metadata": { - "type": "object", - "description": "Optional. Metadata included with the artifact." - }, - "extensions": { - "type": "array", - "items": { - "type": "string" - }, - "description": "The URIs of extensions that are present or contributed to this Artifact." - } - }, - "description": "Artifacts represent task outputs.", - "required": [ - "artifactId", - "parts" - ] - }, - "v1AuthenticationInfo": { - "type": "object", - "properties": { - "scheme": { - "type": "string", - "description": "HTTP Authentication Scheme from the [IANA registry](https://www.iana.org/assignments/http-authschemes/).\nExamples: `Bearer`, `Basic`, `Digest`.\nScheme names are case-insensitive per [RFC 9110 Section 11.1](https://www.rfc-editor.org/rfc/rfc9110#section-11.1)." - }, - "credentials": { - "type": "string", - "description": "Push Notification credentials. Format depends on the scheme (e.g., token for Bearer)." - } - }, - "description": "Defines authentication details, used for push notifications.", - "required": [ - "scheme" - ] - }, - "v1AuthorizationCodeOAuthFlow": { - "type": "object", - "properties": { - "authorizationUrl": { - "type": "string", - "description": "The authorization URL to be used for this flow." - }, - "tokenUrl": { - "type": "string", - "description": "The token URL to be used for this flow." - }, - "refreshUrl": { - "type": "string", - "description": "The URL to be used for obtaining refresh tokens." - }, - "scopes": { - "type": "object", - "additionalProperties": { - "type": "string" - }, - "description": "The available scopes for the OAuth2 security scheme." - }, - "pkceRequired": { - "type": "boolean", - "description": "Indicates if PKCE (RFC 7636) is required for this flow.\nPKCE should always be used for public clients and is recommended for all clients." - } - }, - "description": "Defines configuration details for the OAuth 2.0 Authorization Code flow.", - "required": [ - "authorizationUrl", - "tokenUrl", - "scopes" - ] - }, - "v1ClientCredentialsOAuthFlow": { - "type": "object", - "properties": { - "tokenUrl": { - "type": "string", - "description": "The token URL to be used for this flow." - }, - "refreshUrl": { - "type": "string", - "description": "The URL to be used for obtaining refresh tokens." - }, - "scopes": { - "type": "object", - "additionalProperties": { - "type": "string" - }, - "description": "The available scopes for the OAuth2 security scheme." - } - }, - "description": "Defines configuration details for the OAuth 2.0 Client Credentials flow.", - "required": [ - "tokenUrl", - "scopes" - ] - }, - "v1DeviceCodeOAuthFlow": { - "type": "object", - "properties": { - "deviceAuthorizationUrl": { - "type": "string", - "description": "The device authorization endpoint URL." - }, - "tokenUrl": { - "type": "string", - "description": "The token URL to be used for this flow." - }, - "refreshUrl": { - "type": "string", - "description": "The URL to be used for obtaining refresh tokens." - }, - "scopes": { - "type": "object", - "additionalProperties": { - "type": "string" - }, - "description": "The available scopes for the OAuth2 security scheme." - } - }, - "description": "Defines configuration details for the OAuth 2.0 Device Code flow (RFC 8628).\nThis flow is designed for input-constrained devices such as IoT devices,\nand CLI tools where the user authenticates on a separate device.", - "required": [ - "deviceAuthorizationUrl", - "tokenUrl", - "scopes" - ] - }, - "v1HTTPAuthSecurityScheme": { - "type": "object", - "properties": { - "description": { - "type": "string", - "description": "An optional description for the security scheme." - }, - "scheme": { - "type": "string", - "description": "The name of the HTTP Authentication scheme to be used in the Authorization header,\nas defined in RFC7235 (e.g., \"Bearer\").\nThis value should be registered in the IANA Authentication Scheme registry." - }, - "bearerFormat": { - "type": "string", - "description": "A hint to the client to identify how the bearer token is formatted (e.g., \"JWT\").\nPrimarily for documentation purposes." - } - }, - "description": "Defines a security scheme using HTTP authentication.", - "required": [ - "scheme" - ] - }, - "v1ImplicitOAuthFlow": { - "type": "object", - "properties": { - "authorizationUrl": { - "type": "string", - "title": "The authorization URL to be used for this flow. This MUST be in the\nform of a URL. The OAuth2 standard requires the use of TLS" - }, - "refreshUrl": { - "type": "string", - "description": "The URL to be used for obtaining refresh tokens. This MUST be in the\nform of a URL. The OAuth2 standard requires the use of TLS." - }, - "scopes": { - "type": "object", - "additionalProperties": { - "type": "string" - }, - "description": "The available scopes for the OAuth2 security scheme. A map between the\nscope name and a short description for it. The map MAY be empty." - } - }, - "description": "Deprecated: Use Authorization Code + PKCE instead." - }, - "v1ListTaskPushNotificationConfigsResponse": { - "type": "object", - "properties": { - "configs": { - "type": "array", - "items": { - "type": "object", - "$ref": "#/definitions/v1TaskPushNotificationConfig" - }, - "description": "The list of push notification configurations." - }, - "nextPageToken": { - "type": "string", - "description": "A token to retrieve the next page of results, or empty if there are no more results in the list." - } - }, - "description": "Represents a successful response for the `ListTaskPushNotificationConfigs`\nmethod." - }, - "v1ListTasksResponse": { - "type": "object", - "properties": { - "tasks": { - "type": "array", - "items": { - "type": "object", - "$ref": "#/definitions/v1Task" - }, - "description": "Array of tasks matching the specified criteria." - }, - "nextPageToken": { - "type": "string", - "description": "A token to retrieve the next page of results, or empty if there are no more results in the list." - }, - "pageSize": { - "type": "integer", - "format": "int32", - "description": "The page size used for this response." - }, - "totalSize": { - "type": "integer", - "format": "int32", - "description": "Total number of tasks available (before pagination)." - } - }, - "description": "Result object for `ListTasks` method containing an array of tasks and pagination information.", - "required": [ - "tasks", - "nextPageToken", - "pageSize", - "totalSize" - ] - }, - "v1Message": { - "type": "object", - "properties": { - "messageId": { - "type": "string", - "description": "The unique identifier (e.g. UUID) of the message. This is created by the message creator." - }, - "contextId": { - "type": "string", - "description": "Optional. The context id of the message. If set, the message will be associated with the given context." - }, - "taskId": { - "type": "string", - "description": "Optional. The task id of the message. If set, the message will be associated with the given task." - }, - "role": { - "$ref": "#/definitions/v1Role", - "description": "Identifies the sender of the message." - }, - "parts": { - "type": "array", - "items": { - "type": "object", - "$ref": "#/definitions/v1Part" - }, - "description": "Parts is the container of the message content." - }, - "metadata": { - "type": "object", - "description": "Optional. Any metadata to provide along with the message." - }, - "extensions": { - "type": "array", - "items": { - "type": "string" - }, - "description": "The URIs of extensions that are present or contributed to this Message." - }, - "referenceTaskIds": { - "type": "array", - "items": { - "type": "string" - }, - "description": "A list of task IDs that this message references for additional context." - } - }, - "description": "`Message` is one unit of communication between client and server. It can be\nassociated with a context and/or a task. For server messages, `context_id` must\nbe provided, and `task_id` only if a task was created. For client messages, both\nfields are optional, with the caveat that if both are provided, they have to\nmatch (the `context_id` has to be the one that is set on the task). If only\n`task_id` is provided, the server will infer `context_id` from it.", - "required": [ - "messageId", - "role", - "parts" - ] - }, - "v1MutualTlsSecurityScheme": { - "type": "object", - "properties": { - "description": { - "type": "string", - "description": "An optional description for the security scheme." - } - }, - "description": "Defines a security scheme using mTLS authentication." - }, - "v1OAuth2SecurityScheme": { - "type": "object", - "properties": { - "description": { - "type": "string", - "description": "An optional description for the security scheme." - }, - "flows": { - "$ref": "#/definitions/v1OAuthFlows", - "description": "An object containing configuration information for the supported OAuth 2.0 flows." - }, - "oauth2MetadataUrl": { - "type": "string", - "description": "URL to the OAuth2 authorization server metadata [RFC 8414](https://datatracker.ietf.org/doc/html/rfc8414).\nTLS is required." - } - }, - "description": "Defines a security scheme using OAuth 2.0.", - "required": [ - "flows" - ] - }, - "v1OAuthFlows": { - "type": "object", - "properties": { - "authorizationCode": { - "$ref": "#/definitions/v1AuthorizationCodeOAuthFlow", - "description": "Configuration for the OAuth Authorization Code flow." - }, - "clientCredentials": { - "$ref": "#/definitions/v1ClientCredentialsOAuthFlow", - "description": "Configuration for the OAuth Client Credentials flow." - }, - "implicit": { - "$ref": "#/definitions/v1ImplicitOAuthFlow", - "description": "Deprecated: Use Authorization Code + PKCE instead." - }, - "password": { - "$ref": "#/definitions/v1PasswordOAuthFlow", - "description": "Deprecated: Use Authorization Code + PKCE or Device Code." - }, - "deviceCode": { - "$ref": "#/definitions/v1DeviceCodeOAuthFlow", - "description": "Configuration for the OAuth Device Code flow." - } - }, - "description": "Defines the configuration for the supported OAuth 2.0 flows." - }, - "v1OpenIdConnectSecurityScheme": { - "type": "object", - "properties": { - "description": { - "type": "string", - "description": "An optional description for the security scheme." - }, - "openIdConnectUrl": { - "type": "string", - "description": "The [OpenID Connect Discovery URL](https://openid.net/specs/openid-connect-discovery-1_0.html) for the OIDC provider's metadata." - } - }, - "description": "Defines a security scheme using OpenID Connect.", - "required": [ - "openIdConnectUrl" - ] - }, - "v1Part": { - "type": "object", - "properties": { - "text": { - "type": "string", - "description": "The string content of the `text` part." - }, - "raw": { - "type": "string", - "format": "byte", - "description": "The `raw` byte content of a file. In JSON serialization, this is encoded as a base64 string." - }, - "url": { - "type": "string", - "description": "A `url` pointing to the file's content." - }, - "data": { - "description": "Arbitrary structured `data` as a JSON value (object, array, string, number, boolean, or null)." - }, - "metadata": { - "type": "object", - "description": "Optional. metadata associated with this part." - }, - "filename": { - "type": "string", - "description": "An optional `filename` for the file (e.g., \"document.pdf\")." - }, - "mediaType": { - "type": "string", - "description": "The `media_type` (MIME type) of the part content (e.g., \"text/plain\", \"application/json\", \"image/png\").\nThis field is available for all part types." - } - }, - "description": "`Part` represents a container for a section of communication content.\nParts can be purely textual, some sort of file (image, video, etc) or\na structured data blob (i.e. JSON)." - }, - "v1PasswordOAuthFlow": { - "type": "object", - "properties": { - "tokenUrl": { - "type": "string", - "description": "The token URL to be used for this flow. This MUST be in the form of a URL.\nThe OAuth2 standard requires the use of TLS." - }, - "refreshUrl": { - "type": "string", - "description": "The URL to be used for obtaining refresh tokens. This MUST be in the\nform of a URL. The OAuth2 standard requires the use of TLS." - }, - "scopes": { - "type": "object", - "additionalProperties": { - "type": "string" - }, - "description": "The available scopes for the OAuth2 security scheme. A map between the\nscope name and a short description for it. The map MAY be empty." - } - }, - "description": "Deprecated: Use Authorization Code + PKCE or Device Code." - }, - "v1PushNotificationConfig": { - "type": "object", - "properties": { - "id": { - "type": "string", - "description": "A unique identifier (e.g. UUID) for this push notification configuration." - }, - "url": { - "type": "string", - "description": "The URL where the notification should be sent." - }, - "token": { - "type": "string", - "description": "A token unique for this task or session." - }, - "authentication": { - "$ref": "#/definitions/v1AuthenticationInfo", - "description": "Authentication information required to send the notification." - } - }, - "description": "Configuration for setting up push notifications for task updates.", - "required": [ - "url" - ] - }, - "v1Role": { - "type": "string", - "enum": [ - "ROLE_UNSPECIFIED", - "ROLE_USER", - "ROLE_AGENT" - ], - "default": "ROLE_UNSPECIFIED", - "description": "Defines the sender of a message in A2A protocol communication.\n\n - ROLE_UNSPECIFIED: The role is unspecified.\n - ROLE_USER: The message is from the client to the server.\n - ROLE_AGENT: The message is from the server to the client." - }, - "v1SecurityRequirement": { - "type": "object", - "properties": { - "schemes": { - "type": "object", - "additionalProperties": { - "$ref": "#/definitions/v1StringList" - }, - "description": "A map of security schemes to the required scopes." - } - }, - "description": "Defines the security requirements for an agent." - }, - "v1SecurityScheme": { - "type": "object", - "properties": { - "apiKeySecurityScheme": { - "$ref": "#/definitions/v1APIKeySecurityScheme", - "description": "API key-based authentication." - }, - "httpAuthSecurityScheme": { - "$ref": "#/definitions/v1HTTPAuthSecurityScheme", - "description": "HTTP authentication (Basic, Bearer, etc.)." - }, - "oauth2SecurityScheme": { - "$ref": "#/definitions/v1OAuth2SecurityScheme", - "description": "OAuth 2.0 authentication." - }, - "openIdConnectSecurityScheme": { - "$ref": "#/definitions/v1OpenIdConnectSecurityScheme", - "description": "OpenID Connect authentication." - }, - "mtlsSecurityScheme": { - "$ref": "#/definitions/v1MutualTlsSecurityScheme", - "description": "Mutual TLS authentication." - } - }, - "title": "Defines a security scheme that can be used to secure an agent's endpoints.\nThis is a discriminated union type based on the OpenAPI 3.2 Security Scheme Object.\nSee: https://spec.openapis.org/oas/v3.2.0.html#security-scheme-object" - }, - "v1SendMessageConfiguration": { - "type": "object", - "properties": { - "acceptedOutputModes": { - "type": "array", - "items": { - "type": "string" - }, - "description": "A list of media types the client is prepared to accept for response parts.\nAgents SHOULD use this to tailor their output." - }, - "pushNotificationConfig": { - "$ref": "#/definitions/v1PushNotificationConfig", - "description": "Configuration for the agent to send push notifications for task updates." - }, - "historyLength": { - "type": "integer", - "format": "int32", - "description": "The maximum number of most recent messages from the task's history to retrieve in\nthe response. An unset value means the client does not impose any limit. A\nvalue of zero is a request to not include any messages. The server MUST NOT\nreturn more messages than the provided value, but MAY apply a lower limit." - }, - "blocking": { - "type": "boolean", - "description": "If `true`, the operation MUST wait until the task reaches a terminal state\n(`COMPLETED`, `FAILED`, `CANCELED`, `REJECTED`) or an interrupted state\n(`INPUT_REQUIRED`, `AUTH_REQUIRED`) before returning. Default is `false`." - } - }, - "description": "Configuration of a send message request." - }, - "v1SendMessageRequest": { - "type": "object", - "properties": { - "tenant": { - "type": "string", - "description": "Optional. Tenant ID, provided as a path parameter." - }, - "message": { - "$ref": "#/definitions/v1Message", - "description": "The message to send to the agent." - }, - "configuration": { - "$ref": "#/definitions/v1SendMessageConfiguration", - "description": "Configuration for the send request." - }, - "metadata": { - "type": "object", - "description": "A flexible key-value map for passing additional context or parameters." - } - }, - "description": "Represents a request for the `SendMessage` method.", - "required": [ - "message" - ] - }, - "v1SendMessageResponse": { - "type": "object", - "properties": { - "task": { - "$ref": "#/definitions/v1Task", - "description": "The task created or updated by the message." - }, - "message": { - "$ref": "#/definitions/v1Message", - "description": "A message from the agent." - } - }, - "description": "Represents the response for the `SendMessage` method." - }, - "v1StreamResponse": { - "type": "object", - "properties": { - "task": { - "$ref": "#/definitions/v1Task", - "description": "A Task object containing the current state of the task." - }, - "message": { - "$ref": "#/definitions/v1Message", - "description": "A Message object containing a message from the agent." - }, - "statusUpdate": { - "$ref": "#/definitions/v1TaskStatusUpdateEvent", - "description": "An event indicating a task status update." - }, - "artifactUpdate": { - "$ref": "#/definitions/v1TaskArtifactUpdateEvent", - "description": "An event indicating a task artifact update." - } - }, - "description": "A wrapper object used in streaming operations to encapsulate different types of response data." - }, - "v1StringList": { - "type": "object", - "properties": { - "list": { - "type": "array", - "items": { - "type": "string" - }, - "description": "The individual string values." - } - }, - "description": "protolint:disable REPEATED_FIELD_NAMES_PLURALIZED\nA list of strings." - }, - "v1Task": { - "type": "object", - "properties": { - "id": { - "type": "string", - "description": "Unique identifier (e.g. UUID) for the task, generated by the server for a\nnew task." - }, - "contextId": { - "type": "string", - "description": "Unique identifier (e.g. UUID) for the contextual collection of interactions\n(tasks and messages). Created by the A2A server." - }, - "status": { - "$ref": "#/definitions/v1TaskStatus", - "description": "The current status of a `Task`, including `state` and a `message`." - }, - "artifacts": { - "type": "array", - "items": { - "type": "object", - "$ref": "#/definitions/v1Artifact" - }, - "description": "A set of output artifacts for a `Task`." - }, - "history": { - "type": "array", - "items": { - "type": "object", - "$ref": "#/definitions/v1Message" - }, - "description": "protolint:disable REPEATED_FIELD_NAMES_PLURALIZED\nThe history of interactions from a `Task`." - }, - "metadata": { - "type": "object", - "description": "protolint:enable REPEATED_FIELD_NAMES_PLURALIZED\nA key/value object to store custom metadata about a task." - } - }, - "description": "`Task` is the core unit of action for A2A. It has a current status\nand when results are created for the task they are stored in the\nartifact. If there are multiple turns for a task, these are stored in\nhistory.", - "required": [ - "id", - "contextId", - "status" - ] - }, - "v1TaskArtifactUpdateEvent": { - "type": "object", - "properties": { - "taskId": { - "type": "string", - "description": "The ID of the task for this artifact." - }, - "contextId": { - "type": "string", - "description": "The ID of the context that this task belongs to." - }, - "artifact": { - "$ref": "#/definitions/v1Artifact", - "description": "The artifact that was generated or updated." - }, - "append": { - "type": "boolean", - "description": "If true, the content of this artifact should be appended to a previously\nsent artifact with the same ID." - }, - "lastChunk": { - "type": "boolean", - "description": "If true, this is the final chunk of the artifact." - }, - "metadata": { - "type": "object", - "description": "Optional. Metadata associated with the artifact update." - } - }, - "description": "A task delta where an artifact has been generated.", - "required": [ - "taskId", - "contextId", - "artifact" - ] - }, - "v1TaskPushNotificationConfig": { - "type": "object", - "properties": { - "tenant": { - "type": "string", - "description": "Optional. Tenant ID." - }, - "taskId": { - "type": "string", - "description": "The ID of the task this configuration is associated with." - }, - "pushNotificationConfig": { - "$ref": "#/definitions/v1PushNotificationConfig", - "description": "The push notification configuration details." - } - }, - "description": "A container associating a push notification configuration with a specific task.", - "required": [ - "taskId", - "pushNotificationConfig" - ] - }, - "v1TaskState": { - "type": "string", - "enum": [ - "TASK_STATE_UNSPECIFIED", - "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" - ], - "default": "TASK_STATE_UNSPECIFIED", - "description": "Defines the possible lifecycle states of a `Task`.\n\n - TASK_STATE_UNSPECIFIED: The task is in an unknown or indeterminate state.\n - TASK_STATE_SUBMITTED: Indicates that a task has been successfully submitted and acknowledged.\n - TASK_STATE_WORKING: Indicates that a task is actively being processed by the agent.\n - TASK_STATE_COMPLETED: Indicates that a task has finished successfully. This is a terminal state.\n - TASK_STATE_FAILED: Indicates that a task has finished with an error. This is a terminal state.\n - TASK_STATE_CANCELED: Indicates that a task was canceled before completion. This is a terminal state.\n - TASK_STATE_INPUT_REQUIRED: Indicates that the agent requires additional user input to proceed. This is an interrupted state.\n - TASK_STATE_REJECTED: Indicates that the agent has decided to not perform the task.\nThis may be done during initial task creation or later once an agent\nhas determined it can't or won't proceed. This is a terminal state.\n - TASK_STATE_AUTH_REQUIRED: Indicates that authentication is required to proceed. This is an interrupted state." - }, - "v1TaskStatus": { - "type": "object", - "properties": { - "state": { - "$ref": "#/definitions/v1TaskState", - "description": "The current state of this task." - }, - "message": { - "$ref": "#/definitions/v1Message", - "description": "A message associated with the status." - }, - "timestamp": { - "type": "string", - "format": "date-time", - "title": "ISO 8601 Timestamp when the status was recorded.\nExample: \"2023-10-27T10:00:00Z\"" - } - }, - "title": "A container for the status of a task", - "required": [ - "state" - ] - }, - "v1TaskStatusUpdateEvent": { - "type": "object", - "properties": { - "taskId": { - "type": "string", - "description": "The ID of the task that has changed." - }, - "contextId": { - "type": "string", - "description": "The ID of the context that the task belongs to." - }, - "status": { - "$ref": "#/definitions/v1TaskStatus", - "description": "The new status of the task." - }, - "metadata": { - "type": "object", - "description": "Optional. Metadata associated with the task update." - } - }, - "description": "An event sent by the agent to notify the client of a change in a task's status.", - "required": [ - "taskId", - "contextId", - "status" - ] - } - } -}