a2a-test-framework 0.4.0

data/endpoints/grpc/cancel_task.json

@@ -0,0 +1,10 @@
+{
+  "protocol": "gRPC",
+  "service": "A2AService",
+  "method": "CancelTask",
+  "description": "Cancels a task in progress.",
+  "request_type": "CancelTaskRequest",
+  "response_type": "Task",
+  "client_streaming": false,
+  "server_streaming": false
+}

data/endpoints/grpc/create_task_push_notification_config.json

@@ -0,0 +1,10 @@
+{
+  "protocol": "gRPC",
+  "service": "A2AService",
+  "method": "CreateTaskPushNotificationConfig",
+  "description": "api-linter: core::0133::method-signature=disabled     api-linter: core::0133::request-message-name=disabled     aip.dev/not-precedent: method_signature preserved for backwards compatibility --) Creates a push notification config for a task.",
+  "request_type": "TaskPushNotificationConfig",
+  "response_type": "TaskPushNotificationConfig",
+  "client_streaming": false,
+  "server_streaming": false
+}

data/endpoints/grpc/delete_task_push_notification_config.json

@@ -0,0 +1,10 @@
+{
+  "protocol": "gRPC",
+  "service": "A2AService",
+  "method": "DeleteTaskPushNotificationConfig",
+  "description": "Deletes a push notification config for a task.",
+  "request_type": "DeleteTaskPushNotificationConfigRequest",
+  "response_type": "google.protobuf.Empty",
+  "client_streaming": false,
+  "server_streaming": false
+}

data/endpoints/grpc/get_extended_agent_card.json

@@ -0,0 +1,10 @@
+{
+  "protocol": "gRPC",
+  "service": "A2AService",
+  "method": "GetExtendedAgentCard",
+  "description": "Gets the extended agent card for the authenticated agent.",
+  "request_type": "GetExtendedAgentCardRequest",
+  "response_type": "AgentCard",
+  "client_streaming": false,
+  "server_streaming": false
+}

data/endpoints/grpc/get_task.json

@@ -0,0 +1,10 @@
+{
+  "protocol": "gRPC",
+  "service": "A2AService",
+  "method": "GetTask",
+  "description": "Gets the latest state of a task.",
+  "request_type": "GetTaskRequest",
+  "response_type": "Task",
+  "client_streaming": false,
+  "server_streaming": false
+}

data/endpoints/grpc/get_task_push_notification_config.json

@@ -0,0 +1,10 @@
+{
+  "protocol": "gRPC",
+  "service": "A2AService",
+  "method": "GetTaskPushNotificationConfig",
+  "description": "Gets a push notification config for a task.",
+  "request_type": "GetTaskPushNotificationConfigRequest",
+  "response_type": "TaskPushNotificationConfig",
+  "client_streaming": false,
+  "server_streaming": false
+}

data/endpoints/grpc/list_task_push_notification_configs.json

@@ -0,0 +1,10 @@
+{
+  "protocol": "gRPC",
+  "service": "A2AService",
+  "method": "ListTaskPushNotificationConfigs",
+  "description": "Get a list of push notifications configured for a task.",
+  "request_type": "ListTaskPushNotificationConfigsRequest",
+  "response_type": "ListTaskPushNotificationConfigsResponse",
+  "client_streaming": false,
+  "server_streaming": false
+}

data/endpoints/grpc/list_tasks.json

@@ -0,0 +1,10 @@
+{
+  "protocol": "gRPC",
+  "service": "A2AService",
+  "method": "ListTasks",
+  "description": "Lists tasks that match the specified filter.",
+  "request_type": "ListTasksRequest",
+  "response_type": "ListTasksResponse",
+  "client_streaming": false,
+  "server_streaming": false
+}

data/endpoints/grpc/send_message.json

@@ -0,0 +1,10 @@
+{
+  "protocol": "gRPC",
+  "service": "A2AService",
+  "method": "SendMessage",
+  "description": "Sends a message to an agent.",
+  "request_type": "SendMessageRequest",
+  "response_type": "SendMessageResponse",
+  "client_streaming": false,
+  "server_streaming": false
+}

data/endpoints/grpc/send_streaming_message.json

@@ -0,0 +1,10 @@
+{
+  "protocol": "gRPC",
+  "service": "A2AService",
+  "method": "SendStreamingMessage",
+  "description": "Sends a streaming message to an agent, allowing for real-time interaction and status updates. Streaming version of `SendMessage`",
+  "request_type": "SendMessageRequest",
+  "response_type": "StreamResponse",
+  "client_streaming": false,
+  "server_streaming": true
+}

data/endpoints/grpc/subscribe_to_task.json

@@ -0,0 +1,10 @@
+{
+  "protocol": "gRPC",
+  "service": "A2AService",
+  "method": "SubscribeToTask",
+  "description": "Subscribes to task updates for tasks not in a terminal state. Returns `UnsupportedOperationError` if the task is already in a terminal state (completed, failed, canceled, rejected).",
+  "request_type": "SubscribeToTaskRequest",
+  "response_type": "StreamResponse",
+  "client_streaming": false,
+  "server_streaming": true
+}

data/endpoints/rest/cancel_task.json

@@ -0,0 +1,85 @@
+{
+  "protocol": "REST (HTTP+JSON)",
+  "http_method": "POST",
+  "path": "/tasks/{id}:cancel",
+  "tenant_path": "/{tenant}/tasks/{id}:cancel",
+  "description": "Cancels a task in progress.",
+  "streaming": false,
+  "request": {
+    "type": "CancelTaskRequest",
+    "schema": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "additionalProperties": false,
+      "description": "Represents a request for the `CancelTask` method.",
+      "properties": {
+        "id": {
+          "default": "",
+          "description": "The resource ID of the task to cancel.",
+          "type": "string"
+        },
+        "metadata": {
+          "$ref": "google.protobuf.Struct.jsonschema.json",
+          "description": "A flexible key-value map for passing additional context or parameters."
+        },
+        "tenant": {
+          "default": "",
+          "description": "Optional. Tenant ID, provided as a path parameter.",
+          "type": "string"
+        }
+      },
+      "title": "Cancel Task Request",
+      "type": "object"
+    }
+  },
+  "response": {
+    "type": "Task",
+    "schema": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "additionalProperties": false,
+      "description": "`Task` is the core unit of action for A2A. It has a current status\n and when results are created for the task they are stored in the\n artifact. If there are multiple turns for a task, these are stored in\n history.",
+      "patternProperties": {
+        "^(context_id)$": {
+          "default": "",
+          "description": "Unique identifier (e.g. UUID) for the contextual collection of interactions\n (tasks and messages).",
+          "type": "string"
+        }
+      },
+      "properties": {
+        "artifacts": {
+          "description": "A set of output artifacts for a `Task`.",
+          "items": {
+            "$ref": "lf.a2a.v1.Artifact.jsonschema.json"
+          },
+          "type": "array"
+        },
+        "contextId": {
+          "default": "",
+          "description": "Unique identifier (e.g. UUID) for the contextual collection of interactions\n (tasks and messages).",
+          "type": "string"
+        },
+        "history": {
+          "description": "The history of interactions from a `Task`.",
+          "items": {
+            "$ref": "lf.a2a.v1.Message.jsonschema.json"
+          },
+          "type": "array"
+        },
+        "id": {
+          "default": "",
+          "description": "Unique identifier (e.g. UUID) for the task, generated by the server for a\n new task.",
+          "type": "string"
+        },
+        "metadata": {
+          "$ref": "google.protobuf.Struct.jsonschema.json",
+          "description": "A key/value object to store custom metadata about a task."
+        },
+        "status": {
+          "$ref": "lf.a2a.v1.TaskStatus.jsonschema.json",
+          "description": "The current status of a `Task`, including `state` and a `message`."
+        }
+      },
+      "title": "Task",
+      "type": "object"
+    }
+  }
+}

data/endpoints/rest/create_task_push_notification_config.json

@@ -0,0 +1,104 @@
+{
+  "protocol": "REST (HTTP+JSON)",
+  "http_method": "POST",
+  "path": "/tasks/{task_id}/pushNotificationConfigs",
+  "tenant_path": "/{tenant}/tasks/{task_id}/pushNotificationConfigs",
+  "description": "api-linter: core::0133::method-signature=disabled     api-linter: core::0133::request-message-name=disabled     aip.dev/not-precedent: method_signature preserved for backwards compatibility --) Creates a push notification config for a task.",
+  "streaming": false,
+  "request": {
+    "type": "TaskPushNotificationConfig",
+    "schema": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "additionalProperties": false,
+      "description": "A container associating a push notification configuration with a specific task.",
+      "patternProperties": {
+        "^(task_id)$": {
+          "default": "",
+          "description": "The ID of the task this configuration is associated with.",
+          "type": "string"
+        }
+      },
+      "properties": {
+        "authentication": {
+          "$ref": "lf.a2a.v1.AuthenticationInfo.jsonschema.json",
+          "description": "Authentication information required to send the notification."
+        },
+        "id": {
+          "default": "",
+          "description": "The push notification configuration details.\n A unique identifier (e.g. UUID) for this push notification configuration.",
+          "type": "string"
+        },
+        "taskId": {
+          "default": "",
+          "description": "The ID of the task this configuration is associated with.",
+          "type": "string"
+        },
+        "tenant": {
+          "default": "",
+          "description": "Optional. Tenant ID.",
+          "type": "string"
+        },
+        "token": {
+          "default": "",
+          "description": "A token unique for this task or session.",
+          "type": "string"
+        },
+        "url": {
+          "default": "",
+          "description": "The URL where the notification should be sent.",
+          "type": "string"
+        }
+      },
+      "title": "Task Push Notification Config",
+      "type": "object"
+    }
+  },
+  "response": {
+    "type": "TaskPushNotificationConfig",
+    "schema": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "additionalProperties": false,
+      "description": "A container associating a push notification configuration with a specific task.",
+      "patternProperties": {
+        "^(task_id)$": {
+          "default": "",
+          "description": "The ID of the task this configuration is associated with.",
+          "type": "string"
+        }
+      },
+      "properties": {
+        "authentication": {
+          "$ref": "lf.a2a.v1.AuthenticationInfo.jsonschema.json",
+          "description": "Authentication information required to send the notification."
+        },
+        "id": {
+          "default": "",
+          "description": "The push notification configuration details.\n A unique identifier (e.g. UUID) for this push notification configuration.",
+          "type": "string"
+        },
+        "taskId": {
+          "default": "",
+          "description": "The ID of the task this configuration is associated with.",
+          "type": "string"
+        },
+        "tenant": {
+          "default": "",
+          "description": "Optional. Tenant ID.",
+          "type": "string"
+        },
+        "token": {
+          "default": "",
+          "description": "A token unique for this task or session.",
+          "type": "string"
+        },
+        "url": {
+          "default": "",
+          "description": "The URL where the notification should be sent.",
+          "type": "string"
+        }
+      },
+      "title": "Task Push Notification Config",
+      "type": "object"
+    }
+  }
+}

data/endpoints/rest/delete_task_push_notification_config.json

@@ -0,0 +1,46 @@
+{
+  "protocol": "REST (HTTP+JSON)",
+  "http_method": "DELETE",
+  "path": "/tasks/{task_id}/pushNotificationConfigs/{id}",
+  "tenant_path": "/{tenant}/tasks/{task_id}/pushNotificationConfigs/{id}",
+  "description": "Deletes a push notification config for a task.",
+  "streaming": false,
+  "request": {
+    "type": "DeleteTaskPushNotificationConfigRequest",
+    "schema": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "additionalProperties": false,
+      "description": "Represents a request for the `DeleteTaskPushNotificationConfig` method.",
+      "patternProperties": {
+        "^(task_id)$": {
+          "default": "",
+          "description": "The parent task resource ID.",
+          "type": "string"
+        }
+      },
+      "properties": {
+        "id": {
+          "default": "",
+          "description": "The resource ID of the configuration to delete.",
+          "type": "string"
+        },
+        "taskId": {
+          "default": "",
+          "description": "The parent task resource ID.",
+          "type": "string"
+        },
+        "tenant": {
+          "default": "",
+          "description": "Optional. Tenant ID, provided as a path parameter.",
+          "type": "string"
+        }
+      },
+      "title": "Delete Task Push Notification Config Request",
+      "type": "object"
+    }
+  },
+  "response": {
+    "type": "google.protobuf.Empty",
+    "schema": null
+  }
+}

data/endpoints/rest/get_extended_agent_card.json

@@ -0,0 +1,168 @@
+{
+  "protocol": "REST (HTTP+JSON)",
+  "http_method": "GET",
+  "path": "/extendedAgentCard",
+  "tenant_path": "/{tenant}/extendedAgentCard",
+  "description": "Gets the extended agent card for the authenticated agent.",
+  "streaming": false,
+  "request": {
+    "type": "GetExtendedAgentCardRequest",
+    "schema": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "additionalProperties": false,
+      "description": "Represents a request for the `GetExtendedAgentCard` method.",
+      "properties": {
+        "tenant": {
+          "default": "",
+          "description": "Optional. Tenant ID, provided as a path parameter.",
+          "type": "string"
+        }
+      },
+      "title": "Get Extended Agent Card Request",
+      "type": "object"
+    }
+  },
+  "response": {
+    "type": "AgentCard",
+    "schema": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "additionalProperties": false,
+      "description": "A self-describing manifest for an agent. It provides essential\n metadata including the agent's identity, capabilities, skills, supported\n communication methods, and security requirements.\n Next ID: 20",
+      "patternProperties": {
+        "^(default_input_modes)$": {
+          "description": "The set of interaction modes that the agent supports across all skills.\n This can be overridden per skill. Defined as media types.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "^(default_output_modes)$": {
+          "description": "The media types supported as outputs from this agent.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "^(documentation_url)$": {
+          "description": "A URL providing additional documentation about the agent.",
+          "type": "string"
+        },
+        "^(icon_url)$": {
+          "description": "Optional. A URL to an icon for the agent.",
+          "type": "string"
+        },
+        "^(security_requirements)$": {
+          "description": "Security requirements for contacting the agent.",
+          "items": {
+            "$ref": "lf.a2a.v1.SecurityRequirement.jsonschema.json"
+          },
+          "type": "array"
+        },
+        "^(security_schemes)$": {
+          "additionalProperties": {
+            "$ref": "lf.a2a.v1.SecurityScheme.jsonschema.json"
+          },
+          "description": "The security scheme details used for authenticating with this agent.",
+          "propertyNames": {
+            "type": "string"
+          },
+          "type": "object"
+        },
+        "^(supported_interfaces)$": {
+          "description": "Ordered list of supported interfaces. The first entry is preferred.",
+          "items": {
+            "$ref": "lf.a2a.v1.AgentInterface.jsonschema.json"
+          },
+          "type": "array"
+        }
+      },
+      "properties": {
+        "capabilities": {
+          "$ref": "lf.a2a.v1.AgentCapabilities.jsonschema.json",
+          "description": "A2A Capability set supported by the agent."
+        },
+        "defaultInputModes": {
+          "description": "The set of interaction modes that the agent supports across all skills.\n This can be overridden per skill. Defined as media types.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "defaultOutputModes": {
+          "description": "The media types supported as outputs from this agent.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "description": {
+          "default": "",
+          "description": "A human-readable description of the agent, assisting users and other agents\n in understanding its purpose.\n Example: \"Agent that helps users with recipes and cooking.\"",
+          "type": "string"
+        },
+        "documentationUrl": {
+          "description": "A URL providing additional documentation about the agent.",
+          "type": "string"
+        },
+        "iconUrl": {
+          "description": "Optional. A URL to an icon for the agent.",
+          "type": "string"
+        },
+        "name": {
+          "default": "",
+          "description": "A human readable name for the agent.\n Example: \"Recipe Agent\"",
+          "type": "string"
+        },
+        "provider": {
+          "$ref": "lf.a2a.v1.AgentProvider.jsonschema.json",
+          "description": "The service provider of the agent."
+        },
+        "securityRequirements": {
+          "description": "Security requirements for contacting the agent.",
+          "items": {
+            "$ref": "lf.a2a.v1.SecurityRequirement.jsonschema.json"
+          },
+          "type": "array"
+        },
+        "securitySchemes": {
+          "additionalProperties": {
+            "$ref": "lf.a2a.v1.SecurityScheme.jsonschema.json"
+          },
+          "description": "The security scheme details used for authenticating with this agent.",
+          "propertyNames": {
+            "type": "string"
+          },
+          "type": "object"
+        },
+        "signatures": {
+          "description": "JSON Web Signatures computed for this `AgentCard`.",
+          "items": {
+            "$ref": "lf.a2a.v1.AgentCardSignature.jsonschema.json"
+          },
+          "type": "array"
+        },
+        "skills": {
+          "description": "Skills represent the abilities of an agent.\n It is largely a descriptive concept but represents a more focused set of behaviors that the\n agent is likely to succeed at.",
+          "items": {
+            "$ref": "lf.a2a.v1.AgentSkill.jsonschema.json"
+          },
+          "type": "array"
+        },
+        "supportedInterfaces": {
+          "description": "Ordered list of supported interfaces. The first entry is preferred.",
+          "items": {
+            "$ref": "lf.a2a.v1.AgentInterface.jsonschema.json"
+          },
+          "type": "array"
+        },
+        "version": {
+          "default": "",
+          "description": "The version of the agent.\n Example: \"1.0.0\"",
+          "type": "string"
+        }
+      },
+      "title": "Agent Card",
+      "type": "object"
+    }
+  }
+}

data/endpoints/rest/get_task.json

@@ -0,0 +1,111 @@
+{
+  "protocol": "REST (HTTP+JSON)",
+  "http_method": "GET",
+  "path": "/tasks/{id}",
+  "tenant_path": "/{tenant}/tasks/{id}",
+  "description": "Gets the latest state of a task.",
+  "streaming": false,
+  "request": {
+    "type": "GetTaskRequest",
+    "schema": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "additionalProperties": false,
+      "description": "Represents a request for the `GetTask` method.",
+      "patternProperties": {
+        "^(history_length)$": {
+          "anyOf": [
+            {
+              "maximum": 2147483647,
+              "minimum": -2147483648,
+              "type": "integer"
+            },
+            {
+              "pattern": "^-?[0-9]+$",
+              "type": "string"
+            }
+          ],
+          "description": "The maximum number of most recent messages from the task's history to retrieve. An\n unset value means the client does not impose any limit. A value of zero is\n a request to not include any messages. The server MUST NOT return more\n messages than the provided value, but MAY apply a lower limit."
+        }
+      },
+      "properties": {
+        "historyLength": {
+          "anyOf": [
+            {
+              "maximum": 2147483647,
+              "minimum": -2147483648,
+              "type": "integer"
+            },
+            {
+              "pattern": "^-?[0-9]+$",
+              "type": "string"
+            }
+          ],
+          "description": "The maximum number of most recent messages from the task's history to retrieve. An\n unset value means the client does not impose any limit. A value of zero is\n a request to not include any messages. The server MUST NOT return more\n messages than the provided value, but MAY apply a lower limit."
+        },
+        "id": {
+          "default": "",
+          "description": "The resource ID of the task to retrieve.",
+          "type": "string"
+        },
+        "tenant": {
+          "default": "",
+          "description": "Optional. Tenant ID, provided as a path parameter.",
+          "type": "string"
+        }
+      },
+      "title": "Get Task Request",
+      "type": "object"
+    }
+  },
+  "response": {
+    "type": "Task",
+    "schema": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "additionalProperties": false,
+      "description": "`Task` is the core unit of action for A2A. It has a current status\n and when results are created for the task they are stored in the\n artifact. If there are multiple turns for a task, these are stored in\n history.",
+      "patternProperties": {
+        "^(context_id)$": {
+          "default": "",
+          "description": "Unique identifier (e.g. UUID) for the contextual collection of interactions\n (tasks and messages).",
+          "type": "string"
+        }
+      },
+      "properties": {
+        "artifacts": {
+          "description": "A set of output artifacts for a `Task`.",
+          "items": {
+            "$ref": "lf.a2a.v1.Artifact.jsonschema.json"
+          },
+          "type": "array"
+        },
+        "contextId": {
+          "default": "",
+          "description": "Unique identifier (e.g. UUID) for the contextual collection of interactions\n (tasks and messages).",
+          "type": "string"
+        },
+        "history": {
+          "description": "The history of interactions from a `Task`.",
+          "items": {
+            "$ref": "lf.a2a.v1.Message.jsonschema.json"
+          },
+          "type": "array"
+        },
+        "id": {
+          "default": "",
+          "description": "Unique identifier (e.g. UUID) for the task, generated by the server for a\n new task.",
+          "type": "string"
+        },
+        "metadata": {
+          "$ref": "google.protobuf.Struct.jsonschema.json",
+          "description": "A key/value object to store custom metadata about a task."
+        },
+        "status": {
+          "$ref": "lf.a2a.v1.TaskStatus.jsonschema.json",
+          "description": "The current status of a `Task`, including `state` and a `message`."
+        }
+      },
+      "title": "Task",
+      "type": "object"
+    }
+  }
+}