@artinet/sdk 0.5.2 → 0.5.4

package/CHANGELOG.md

@@ -5,7 +5,26 @@ All notable changes to the @artinet/sdk package will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.5.2] - 2025-05-25 (Please fill in the date)
+## [0.5.4] - 2025-06-12
+
+### Added
+- New `ExecutionContext` interface for enhanced parameter management across services
+- `MCPExecutionContext` and `NLWebExecutionContext` interfaces for protocol-specific request handling
+- New schema organization under `schemas/a2a` directory for improved code structure
+
+### Changed
+- **BREAKING**: Renamed core methods to align with message-based approach:
+  - `sendTask` → `sendMessage`
+  - `sendTaskSubscribe` → `sendStreamingMessage`
+  - Updated push notification config methods to `tasks/pushNotificationConfig/set` and `tasks/pushNotificationConfig/get`
+- Refactored import paths to use new schema structure under `schemas/a2a`
+- Enhanced error handling and validation for message parameters across the codebase
+- Updated documentation to reflect new method names and functionalities
+
+### Removed
+- Deprecated submodules for `a2a-samples` and `mcp-use`
+
+## [0.5.2] - 2025-05-25
 
 ### Added
 - New `artinet.v0` namespace in `src/utils/deployment/agents.ts` providing `taskManager`, `connect`, and `agent` utilities. These are designed for agents running in sandboxed or managed environments, offering a standardized way to interact with the host system for task execution, inter-agent communication, and external API calls.

package/README.md

@@ -5,22 +5,31 @@
 
 <!-- [![Coverage Status](https://coveralls.io/repos/github/the-artinet-project/artinet-sdk/badge.svg?branch=main)](https://coveralls.io/github/the-artinet-project/artinet-sdk?branch=main) -->
 
-# Artinet SDK
+# artinet SDK
 
-Artinet SDK is a [Agent2Agent (A2A) Protocol](https://github.com/google/A2A) compliant server and client written in TypeScript for [node.js](https://nodejs.org/) that aims to simplify the creation of interoperable AI agents. Learn more at [the artinet project](https://artinet.io/).
+The artinet SDK is a Full Stack Agent builder written in TypeScript for [node.js](https://nodejs.org/) that aims to simplify the creation of interoperable AI agents. Learn more at [the artinet project](https://artinet.io/).
 
-This SDK significantly enhances the foundational A2A concepts and samples provided by Google, offering a production-ready solution with a focus on developer experience, reliability, and comprehensive features.
+This SDK significantly supports multiple agentic communication protocols, offering a production-ready solution with a focus on developer experience, reliability, and comprehensive features.
+
+### Quick Start
+
+To build your own agent/server use the [`create-quick-agent`](https://www.npmjs.com/package/@artinet/create-quick-agent) command:
+
+```bash
+npx @artinet/create-quick-agent@latest
+```
+
+Its got [serveral template projects](https://github.com/the-artinet-project/create-quick-agent) that you can use to get started building agents today.
 
 ## Table of Contents
-- [Artinet SDK](#artinet-sdk)
+- [artinet SDK](#artinet-sdk)
+    - [Quick Start](#quick-start)
   - [Table of Contents](#table-of-contents)
   - [Features](#features)
   - [Installation](#installation)
   - [Requirements](#requirements)
+  - [Documentation](#documentation)
   - [Example](#example)
-  - [Class Documentation](#class-documentation)
-    - [Core Classes](#core-classes)
-    - [Key Types \& Interfaces](#key-types--interfaces)
   - [Running Tests](#running-tests)
   - [Typescript](#typescript)
   - [Usage](#usage)
@@ -41,27 +50,21 @@ This SDK significantly enhances the foundational A2A concepts and samples provid
 
 ## Features
 
-- **Plug-and-Play Server:** Built on Express.js, the `A2AServer` handles JSON-RPC complexity, routing, protocol compliance, and Server-Sent Events (SSE) streaming mechanics automatically. Just provide your core agent logic (`TaskHandler`) and configuration via `A2AServerParams`.
-- **Enhanced Client:** `A2AClient` features refined error handling (`RpcError`), flexible header management for authentication, and clear separation of concerns.
+- **Plug-and-Play Server:** Built on Express.js, the `ExpressServer` handles Transport-layer complexity, routing, protocol compliance, and Server-Sent Events (SSE) streaming mechanics automatically. Just provide your core agent logic (`AgentEngine`) and configuration via `ExpressServerOptions`.
 - **TypeScript First:** Fully written in TypeScript with comprehensive type definitions for a robust developer experience.
-- **Flexible Storage:** Offers built-in `InMemoryTaskStore` (development/testing) and `FileStore` (persistent), with the `TaskStore` interface allowing custom storage solutions.
-- **Protocol Compliance:** Implements the complete A2A specification using the official JSON schema, ensuring interoperability.
-- **Robust Streaming:** Reliable SSE support for `tasks/sendSubscribe` & `tasks/resubscribe` using `eventsource-parser`.
-- **Configurable Logging:** Integrated structured logging via `pino`. Configurable levels using `configureLogger` and `LogLevel`.
-- **Advanced Customization:** Allows providing a custom `JSONRPCServerFactory` for fine-grained control over the JSON-RPC server, enabling integration with existing Express apps or adding custom methods.
-- **Comprehensive Testing:** Includes a suite of tests to ensure reliability and maintainability.
-- **Code Deployment (Experimental)** | Bundle, test, and deploy agent code onto the artinet. Includes bundler, task wrapper, and deployment utilities.           | `bundle`, `test/fullDeployment`, `ServerDeploymentRequestParams`, `ServerDeploymentResponse`, `artinet.v0.taskManager`, `artinet.v0.connect`, `artinet.v0.agent` |
+- **Protocol Compliance:** Implements the complete A2A specification with growing support for recieving commands via MCP & ACP.
+- **Code Deployment (Experimental)** | Bundle, test, and deploy agent code onto the artinet. Includes bundler, task wrapper, and deployment utilities.
 
 | Component/Feature   | Description                                                                 | Key Classes/Types                                                                            |
 | :------------------ | :-------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------- |
 | **Client**          | Interact with A2A-compliant agents. Supports standard & streaming requests. | `A2AClient`, `RpcError`                                                                      |
-| **Server**          | Host A2A-compliant agents. Handles protocol details, routing, SSE.          | `A2AServer`, `A2AServerParams`                                                               |
-| **Task Handling**   | Define agent logic using async generators.                                  | `TaskHandler`, `TaskContext`, `TaskYieldUpdate`                                              |
-| **Storage**         | Persist task state. In-memory and file-based options included.              | `TaskStore`, `InMemoryTaskStore`, `FileStore`                                                |
-| **Streaming (SSE)** | Handle real-time updates via SSE for `tasks/sendSubscribe`/`resubscribe`.   | `TaskStatusUpdateEvent`, `TaskArtifactUpdateEvent`                                           |
+| **Server**          | Host agents that can communicate using a variety of protocols. Handles protocol details, routing, SSE.          | `ExpressServer`, `ExpressServerOptions`                                                               |
+| **Reqeust Handling**   | Define agent logic using async generators.                                  | `AgentEngine`, `ExecutionContext`, `UpdateEvent`                                              |
+| **Storage**         | Persist event state. In-memory and file-based options included.              | `Store`, `InMemoryTaskStore`, `FileStore`                                                |
+| **Streaming (SSE)** | Handle real-time updates via SSE.   |                                           |
 | **Logging**         | Configure structured logging for debugging and monitoring.                  | `logger`, `configureLogger`, `LogLevel`                                                      |
-| **Advanced Server** | Customize the underlying JSON-RPC server or integrate into existing apps.   | `JSONRPCServerFactory`, `CreateJSONRPCServerParams`, `createJSONRPCMethod`, A2A Method Types |
-| **Core Types**      | Based on the official A2A JSON Schema.                                      | `AgentCard`, `Task`, `Message`, `Part`, `Artifact`, etc.                                     |
+| **Advanced Server** | Customize the underlying JSON-RPC server or integrate into existing apps.   | `CreateJSONRPCServerParams`, `createJSONRPCMethod` |
+| **Core Types**      | Based on the official JSON Schemas.                                      | `Tool`,`AgentCard`, `Task`, `Message`, `Part`, `Artifact`, etc.                                     |
 | **Agent Utilities (for Sandboxed Environments)** | Standardized utilities for agents in managed environments to interact with the host system for task lifecycle, inter-agent communication, and external API calls. | `artinet.v0.taskManager`, `artinet.v0.connect`, `artinet.v0.agent`, `TaskProxy`, `ConnectAPICallback`, `ClientProxy`, `ClientFactory` |
 
 ## Installation
@@ -74,6 +77,10 @@ npm install @artinet/sdk
 
 - Node.js (v22.0.0 or higher recommended, check `package.json` engines for exact requirement)
 
+## Documentation
+
+For more detailed documentation visit our documentation site [here](https://the-artinet-project.github.io/artinet-documentation/).
+
 ## Example
  
 A basic A2A server and client interaction. For more detailed examples, see the `examples/` directory.
@@ -82,16 +89,16 @@ A basic A2A server and client interaction. For more detailed examples, see the `
 
 ```typescript
 import {
-  A2AServer,
-  TaskContext,
-  TaskHandler,
+  ExpressServer,
+  ExecutionContext,
+  AgentEngine,
   InMemoryTaskStore,
 } from "@artinet/sdk";
 
 // Minimal agent logic: receive text, yield working state, yield completed state with echo
-const quickAgentLogic: TaskHandler = async function* (context: TaskContext) {
-  const userInput =
-    context.userMessage.parts[0].type === "text"
+const quickAgentLogic: AgentEngine = async function* (context: ExecutionContext) {
+  const params = context.getRequestParams() as MessageSendParams; //for A2A requests
+  const userInput = params.message.parts[0].kind === "text"
       ? context.userMessage.parts[0].text
       : "";
   yield { state: "working" };
@@ -100,13 +107,13 @@ const quickAgentLogic: TaskHandler = async function* (context: TaskContext) {
     state: "completed",
     message: {
       role: "agent",
-      parts: [{ type: "text", text: `You said: ${userInput}` }],
+      parts: [{ kind: "text", text: `You said: ${userInput}` }],
     },
   };
 };
 
 const server = new A2AServer({
-  taskHandler: quickAgentLogic,
+  handler: quickAgentLogic,
   taskStore: new InMemoryTaskStore(),
   port: 4000,
   basePath: "/a2a",
@@ -132,11 +139,13 @@ async function runClient() {
   const client = new A2AClient("http://localhost:4000/a2a");
 
    const message = {
-    role: "user" as const,
-    parts: [{ type: "text" as const, text: "Hello Quick Start!" }],
+    messageId: "test-message-id",
+    kind: "message",
+    role: "user",
+    parts: [{ kind: "text", text: "Hello Quick Start!" }],
   };
 
-  const stream = client.sendTaskSubscribe({ id: "quick-task-1", message });
+  const stream = client.sendStreamingMessage({ message });
 
   for await (const update of stream) {
     // process the update
@@ -148,37 +157,6 @@ async function runClient() {
 runClient().catch(console.error);
 ```
 
-## Class Documentation
-
-The Artinet SDK provides several core classes and interfaces for building A2A clients and servers.
-
-### Core Classes
-
-| Class               | Description                                                         |
-| :------------------ | :------------------------------------------------------------------ |
-| `A2AClient`         | Client for interacting with A2A servers.                            |
-| `A2AServer`         | Express-based server implementation for hosting A2A agents.         |
-| `RpcError`          | Represents client-side errors encountered during A2A communication. |
-| `InMemoryTaskStore` | Simple in-memory task persistence (ideal for development/testing).  |
-| `FileStore`         | File-based task persistence (stores task data in the filesystem).   |
-
-### Key Types & Interfaces
-
-| Type/Interface                                            | Description                                                                                                                        |
-| :-------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------- |
-| `TaskHandler`                                             | Async generator function defining the core agent logic (`async function*(context: TaskContext): AsyncGenerator<TaskYieldUpdate>`). |
-| `TaskContext`                                             | Provides task details (`task`, `userMessage`, `history`, `isCancelled()`) to the `TaskHandler`.                                    |
-| `TaskStore`                                               | Interface defining the contract for task persistence implementations (like `InMemoryTaskStore`, `FileStore`).                      |
-| `TaskYieldUpdate`                                         | Union type for updates yielded by a `TaskHandler` (representing status changes or generated artifacts).                            |
-| `A2AServerParams`                                         | Configuration object passed to the `A2AServer` constructor (port, store, card, basePath, handler, etc.).                           |
-| `AgentCard`                                               | Describes the agent's capabilities, metadata, skills, and endpoint URL.                                                            |
-| `Message`, `Part`, `Artifact`, `Task`, `TaskStatus`, etc. | Core types mirroring the structures defined in the A2A JSON Schema specification. Used for requests, responses, and task state.    |
-| `TaskStatusUpdateEvent`, `TaskArtifactUpdateEvent`        | Specific types for Server-Sent Events (SSE) received during streaming operations (`tasks/sendSubscribe`, `tasks/resubscribe`).     |
-| `LogLevel`                                                | Enum defining logging levels (`error`, `warn`, `info`, `debug`, `trace`) used with the built-in logger.                            |
-| `JSONRPCServerFactory`                                    | Function signature for providing a custom JSON-RPC server creation logic to `A2AServer` for advanced customization.                |
-| `CreateJSONRPCServerParams`                               | Object containing dependencies provided _to_ a `JSONRPCServerFactory` function.                                                    |
-| `SendTaskMethod`, `GetTaskMethod`, ...                    | Type signatures for specific A2A method handlers, used when implementing custom server logic with `createJSONRPCMethod`.           |
-
 ## Running Tests
 
 ```bash
@@ -203,7 +181,7 @@ Interact with A2A-compliant agents using the `A2AClient`. See `examples/` for mo
 
 #### Basic Client Usage
 
-Send a task using `tasks/send`.
+Send a message using `message/send`.
 
 ```typescript
 import { A2AClient, Message } from "@artinet/sdk";
@@ -211,18 +189,20 @@ import { A2AClient, Message } from "@artinet/sdk";
 async function runBasicTask() {
   const client = new A2AClient("https://your-a2a-server.com/a2a");
   const message: Message = {
+    messageId: "test-message",
+    kind: "message",
     role: "user",
-    parts: [{ type: "text", text: "What is the capital of France?" }],
+    parts: [{ kind: "text", text: "What is the capital of France?" }],
   };
 
-  const task = await client.sendTask({ id: "basic-task-1", message });
+  const task = await client.sendMessage({ message });
   console.log("Task Completed:", task);
 }
 ```
 
 #### Streaming Updates
 
-Receive real-time updates via SSE using `tasks/sendSubscribe` (recommended).
+Receive real-time updates via SSE using `message/stream` (recommended).
 
 ```typescript
 import {
@@ -239,7 +219,7 @@ async function runStreamingTask() {
     parts: [{ type: "text", text: "Tell me a short story." }],
   };
 
-  const stream = client.sendTaskSubscribe({ id: "streaming-task-1", message });
+  const stream = client.sendStreamingMessage({ id: "streaming-task-1", message });
 
   for await (const update of stream) {
     if ((update as TaskStatusUpdateEvent).status) {
@@ -282,13 +262,13 @@ Define agent behavior with an async generator `TaskHandler`.
 ```typescript
 import {
   A2AServer,
-  TaskContext,
-  TaskHandler,
+  ExecutionContext,
+  AgentEngine,
   InMemoryTaskStore,
 } from "@artinet/sdk";
 
 
-const myAgent: TaskHandler = async function* (context: TaskContext) {
+const myAgent: AgentEngine = async function* (context: ExecutionContext) {
 
   yield {
     state: "working",
@@ -409,9 +389,9 @@ The SDK includes features to help make your agent discoverable:
 
 Provide a custom `createJSONRPCServer` function (implementing `JSONRPCServerFactory`) for fine-grained control over the underlying RPC server.
 
-This factory function receives objects of type `CreateJSONRPCServerParams` & `RequestParams` containing the necessary SDK dependencies (`taskHandler`, `taskStore`, `agentCard`, `activeCancellations`, `createTaskContext`, `closeStreamsForTask`) and the specific method paramaters (i.e. `SendTaskRequest["params"]`). You can use these dependencies to configure the standard A2A methods and add your own custom JSON-RPC methods.
+This factory function receives objects of type `CreateJSONRPCServerParams` & `RequestParams` containing the necessary SDK dependencies (`taskHandler`, `taskStore`, `agentCard`, `activeCancellations`, `createTaskContext`, `closeStreamsForTask`) and the specific method parameters (i.e. `SendMessageRequest["params"]`). You can use these dependencies to configure the standard A2A methods and add your own custom JSON-RPC methods.
 
-The SDK exports default handlers for the standard A2A methods (e.g., `defaultSendTaskMethod`), create your own using dedicated A2A method types(`SendTaskMethod`) and use `createJSONRPCMethod` to easily wrap these methods with dependency injection and error handling.
+The SDK exports default handlers for the standard A2A methods (e.g., `defaultSendMessageMethod`), create your own using dedicated A2A method types(`SendMessageMethod`) and use `createJSONRPCMethod` to easily wrap these methods with dependency injection and error handling.
 
 See `src/server/lib/middleware/factory.ts` and `src/server/lib/middleware/a2a-methods.ts` for implementation details.
 
@@ -419,13 +399,13 @@ See `src/server/lib/middleware/factory.ts` and `src/server/lib/middleware/a2a-me
 
 ```typescript
 
-const myCustomSendMethod: SendTaskMethod = (
+const myCustomSendMethod: SendMessageMethod = (
   deps,
   requestParams,
   callback
 ) => {
   const { taskStore, taskHandler, createTaskContext } = deps;
-  const taskId = extractTaskId(requestParams.id);
+  const { id: taskId } = requestParams;
   const { message, sessionId, metadata } = requestParams;
   ...
   callback(null, ...);
@@ -434,21 +414,21 @@ const myCustomSendMethod: SendTaskMethod = (
 const myCustomRPCServer: JSONRPCServerFactory = (
   params: CreateJSONRPCServerParams
 ): JSONRPCServerType => {
-  //Use a custom task/send method
-  const taskSendMethod = createJSONRPCMethod(params, myCustomSendMethod, "tasks/send");
+  //Use a custom message/send method
+  const messageSendMethod = createJSONRPCMethod(params, myCustomSendMethod, "message/send");
   const taskGetMethod = createJSONRPCMethod(params, defaultGetTaskMethod, "tasks/get");
   const taskCancelMethod = createJSONRPCMethod(params, defaultCancelTaskMethod, "tasks/cancel");
 
   // Note: Push notifications are not fully implemented yet
-  const taskPushNotificationSetMethod = createJSONRPCMethod(params, defaultSetTaskPushNotificationMethod, "tasks/pushNotification/set");
-  const taskPushNotificationGetMethod = createJSONRPCMethod(params, defaultGetTaskPushNotificationMethod, "tasks/pushNotification/get");
+  const taskPushNotificationSetMethod = createJSONRPCMethod(params, defaultSetTaskPushNotificationMethod, "tasks/pushNotificationConfig/set");
+  const taskPushNotificationGetMethod = createJSONRPCMethod(params, defaultGetTaskPushNotificationMethod, "tasks/pushNotificationConfig/get");
 
   const rpcServer = new JSONRPCServer({
-    "tasks/send": taskSendMethod,
+    "message/send": messageSendMethod,
     "tasks/get": taskGetMethod,
     "tasks/cancel": taskCancelMethod,
-    "tasks/pushNotification/set": taskPushNotificationSetMethod,
-    "tasks/pushNotification/get": taskPushNotificationGetMethod,
+    "tasks/pushNotificationConfig/set": taskPushNotificationSetMethod,
+    "tasks/pushNotificationConfig/get": taskPushNotificationGetMethod,
   });
 
   return rpcServer;
@@ -465,7 +445,7 @@ const server = new A2AServer({
 
 Pass your factory function via the `createJSONRPCServer` option during `A2AServer` initialization.
 
-**Important:** The default `A2AServer` setup automatically adds Express middleware to handle Server-Sent Events (SSE) for `tasks/sendSubscribe` and `tasks/resubscribe`, as well as the `/agent/card` (and `/.well-known/agent.json`) GET endpoints. If you are **not** using `A2AServer` and integrating the Jayson server middleware into your own Express application, you **must** implement these SSE and card endpoints yourself to maintain full A2A compliance, especially for streaming functionality. See `src/server/lib/express-server.ts` for how the default server handles these routes.
+**Important:** The default `A2AServer` setup automatically adds Express middleware to handle Server-Sent Events (SSE) for `message/stream` and `tasks/resubscribe`, as well as the `/agent/card` (and `/.well-known/agent.json`) GET endpoints. If you are **not** using `A2AServer` and integrating the Jayson server middleware into your own Express application, you **must** implement these SSE and card endpoints yourself to maintain full A2A compliance, especially for streaming functionality. See `src/server/lib/express-server.ts` for how the default server handles these routes.
 
 ### Quick-Agents (Alpha)
 
@@ -473,7 +453,7 @@ We are excited to introduce new capabilities for deploying agents directly onto
 
 We've added a `testDeployment` utility which is available for all users letting you bundle and test your agent logic in a temporary sandboxed environment. 
 
-**QUICK-AGENTS ARE HERE!** Use the new `fullDeployment` utility, which allows direct deployment of your bundled agent code and `AgentCard` to the Artinet platform (requires an `ARTINET_API_KEY`).
+**QUICK-AGENTS** Use the `fullDeployment` utility, which allows direct deployment of your bundled agent code and `AgentCard` to the Artinet platform (requires an `ARTINET_API_KEY`).
 
 To join the beta waitlist, please email us at humans@artinet.io and stay tuned for more updates!
 
@@ -487,7 +467,7 @@ Key features include:
     ```
 
 -   **Sandboxed Enviroments:** Streamline agent logic for quick and easy deployments. The new `artinet.v0` namespace (accessible via `@artinet/sdk/agents`) provides `taskManager`, `connect`, and `agent`.
-    -   `artinet.v0.taskManager`: Replaces the deprecated `taskHandlerProxy`. Manages the agent's task lifecycle by iterating over the agent's `TaskHandler` and communicating updates to the host environment.
+    -   `artinet.v0.taskManager`: Manages the agent's lifecycle by iterating over the agent's `TaskHandler` and communicating updates to the host environment.
     -   `artinet.v0.connect`: Replaces the deprecated `fetchResponseProxy`. Allows agents to make proxied calls to other agents or LLMs via the host environment.
     -   `artinet.v0.agent`: A factory function to obtain a `ClientProxy` for type-safe communication with other agents, managed by the host environment.
 
@@ -551,7 +531,7 @@ Key features include:
     console.log("Deployment Result:", deploymentResult);
     ```
 
--   **Dedicated Endpoints:** Once deployed your agent will be available On-Demand at its dedicated enpoint. (e.g. "https://agents.stage.artinet.io/agentId=0xabf698845743538727a81352bfcfdb724e5c2bbe3113a26362482248f9f3e5fa/.well-known/agent.json")
+-   **Dedicated Endpoints:** Once deployed your agent will be available On-Demand at its dedicated enpoint. (e.g. "https://agents.artinet.io/agentId=0xabf698845743538727a81352bfcfdb724e5c2bbe3113a26362482248f9f3e5fa/.well-known/agent.json")
 -   **New Types:** To support these features, new types for server deployment requests and responses (such as `ServerDeploymentRequestParams`, `ServerDeploymentResponse`) have been added to `src/types/extended-schema.ts`. New types for sandboxed agent interactions (`TaskProxy`, `ConnectAPICallback`, `ClientProxy`, etc.) are in `src/types/proxy.ts`.
 
   **QUICK-AGENT FAQs**
@@ -560,7 +540,7 @@ Key features include:
 -   Quick-Agents v0 does not support streaming, push notifications or state transition history (these capabilities are on the project roadmap).
 -   Larger deployments can take significant time to deploy which may cause `fullDeployment` to timeout. In such cases wait to see if the listing has been added to your account before trying to deploy again.
 -   Quick-Agent logic is public, therefore the artinet project is not liable for any sensitive material held within a deployment.
--   v0.0.5c of the artinet platform will enable search by registrationId/agentId.
+-   Only availble with version 0.5.3 of the SDK.
   
 Sign-up at [artinet.io](https://artinet.io/) to deploy your Quick-Agent today!
 
@@ -576,7 +556,7 @@ This project is licensed under the Apache License 2.0 - see the `LICENSE` file f
 
 ## Acknowledgements
 
-This SDK builds upon the concepts and specifications of the [Agent2Agent (A2A) Protocol](https://github.com/google/A2A) initiated by Google. It utilizes the official [A2A JSON Schema](https://github.com/google/A2A/tree/main/specification/json) for protocol compliance.
+This SDK builds upon the concepts and specifications of the [Agent2Agent (A2A) Protocol](https://github.com/google-a2a/A2A) initiated by Google. It utilizes the official [A2A JSON Schema](https://github.com/google-a2a/A2A/blob/main/specification/json/a2a.json) for protocol compliance.
 
 Libraries used include:
 

package/dist/client/a2a-client.js

@@ -69,19 +69,37 @@ export class A2AClient {
     }
     /**
      * Sends a task request to the agent (non-streaming).
-     * @param params The parameters for the tasks/send method.
+     * @param params The parameters for the message/send method.
+     * @returns A promise resolving to the Task object or null.
+     */
+    async sendMessage(params) {
+        return await executeJsonRpcRequest(this.baseUrl, "message/send", params, this.customHeaders);
+    }
+    /**
+     * @deprecated Use sendMessage instead.
+     * Sends a task request to the agent (non-streaming).
+     * @param params The parameters for the message/send method.
      * @returns A promise resolving to the Task object or null.
      */
     async sendTask(params) {
-        return await executeJsonRpcRequest(this.baseUrl, "tasks/send", params, this.customHeaders);
+        return await this.sendMessage(params);
+    }
+    /**
+     * Sends a task and returns a subscription to status and artifact updates.
+     * @param params Task parameters for the request
+     * @returns An AsyncIterable that yields TaskStatusUpdateEvent or TaskArtifactUpdateEvent payloads.
+     */
+    sendStreamingMessage(params) {
+        return executeStreamEvents(this.baseUrl, "message/stream", params, this.customHeaders);
     }
     /**
+     * @deprecated Use sendStreamingMessage instead.
      * Sends a task and returns a subscription to status and artifact updates.
      * @param params Task parameters for the request
      * @returns An AsyncIterable that yields TaskStatusUpdateEvent or TaskArtifactUpdateEvent payloads.
      */
     sendTaskSubscribe(params) {
-        return executeStreamEvents(this.baseUrl, "tasks/sendSubscribe", params, this.customHeaders);
+        return this.sendStreamingMessage(params);
     }
     /**
      * Retrieves the current state of a task.
@@ -101,19 +119,19 @@ export class A2AClient {
     }
     /**
      * Sets or updates the push notification config for a task.
-     * @param params The parameters for the tasks/pushNotification/set method (which is TaskPushNotificationConfig).
+     * @param params The parameters for the tasks/pushNotificationConfig/set method (which is TaskPushNotificationConfig).
      * @returns A promise resolving to the confirmed TaskPushNotificationConfig or null.
      */
     async setTaskPushNotification(params) {
-        return await executeJsonRpcRequest(this.baseUrl, "tasks/pushNotification/set", params, this.customHeaders);
+        return await executeJsonRpcRequest(this.baseUrl, "tasks/pushNotificationConfig/set", params, this.customHeaders);
     }
     /**
      * Retrieves the currently configured push notification config for a task.
-     * @param params The parameters for the tasks/pushNotification/get method.
+     * @param params The parameters for the tasks/pushNotificationConfig/get method.
      * @returns A promise resolving to the TaskPushNotificationConfig or null.
      */
     async getTaskPushNotification(params) {
-        return await executeJsonRpcRequest(this.baseUrl, "tasks/pushNotification/get", params, this.customHeaders);
+        return await executeJsonRpcRequest(this.baseUrl, "tasks/pushNotificationConfig/get", params, this.customHeaders);
     }
     /**
      * Resubscribes to an existing task's update stream.

package/dist/client/a2a-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"a2a-client.js","sourceRoot":"","sources":["../../src/client/a2a-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"a2a-client.js","sourceRoot":"","sources":["../../src/client/a2a-client.ts"],"names":[],"mappings":"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"}