@artinet/sdk 0.5.6 → 0.5.8

package/README.md

@@ -11,28 +11,15 @@ The artinet SDK is a TypeScript library designed for Agentic Communication. It's
 
 This SDK leverages a service-oriented architecture for building AI agents allowing developers to easily create agents as simple processes or seamlessly embed them within a dedicated server.
 
-### Quick Start
-
-To build your own agent/server use the [`create-quick-agent`](https://www.npmjs.com/package/@artinet/create-quick-agent) (supports v0.5.2) command:
-
-```bash
-npx @artinet/create-quick-agent@latest
-```
-
-It has [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)
-    - [Quick Start](#quick-start)
   - [Table of Contents](#table-of-contents)
   - [Features](#features)
   - [Installation](#installation)
   - [Requirements](#requirements)
-  - [Documentation](#documentation)
   - [Example](#example)
   - [Running Tests](#running-tests)
-  - [Typescript](#typescript)
   - [Usage](#usage)
     - [Client](#client)
       - [Basic Client Usage](#basic-client-usage)
@@ -44,35 +31,26 @@ It has [serveral template projects](https://github.com/the-artinet-project/creat
         - [AgentEngine](#agentengine)
       - [Event Handling/Monitoring \& Message Streaming](#event-handlingmonitoring--message-streaming)
       - [Persistent Storage](#persistent-storage)
-      - [Logging](#logging)
-      - [Server Registration \& Discovery (v0.5.2)](#server-registration--discovery-v052)
       - [Advanced Server Customization](#advanced-server-customization)
-    - [Quick-Agents (Alpha v0.5.2)](#quick-agents-alpha-v052)
+      - [Cross Protocol Support](#cross-protocol-support)
   - [Contributing](#contributing)
   - [License](#license)
   - [Acknowledgements](#acknowledgements)
 
+**Breaking Changes in v0.5.8**
+- Pino has been removed and replaced with console for better portability and is set to silent by default. 
+- The default handler for streamMessage no longer automatically emits an initial `submitted` and `working` event.
+- Agent Registration, Bundling and Deployment utils have been removed (email us: humans@artinet.io for support).
+- `@artinet/metadata-validator` has been removed due to build issues.
+- getTask now correctly takes TaskQueryParams as an argument vs TaskIdParams in accordance with the A2A spec.
+- AgentBuilder now returns a unique messageId for each status update instead of the original user provided messageId.
+- In a future release the following packages will be set as peer dependancies to reduce the size of the build:  `@modelcontextprotocol/sdk`, `@trpc/server`, `cors`, `express`
+
 ## Features
 
-- **Service-Oriented Architecture:** Modern, modular design with a dedicated layer for protocol handling and state management.
-- **Modern Express Server:** Quickly create an Express Server with the `createAgentServer()` function. It handles all of the transport-layer complexity, adds an A2A <-> JSON-RPC middleware, and manages Server-Sent Events (SSE) automatically.
-- **TypeScript First:** Written in TypeScript with a fully implemented Zod <-> A2A schema.
-- **Protocol Compliance:** Implements the complete A2A specification (v0.3.0) with support for any kind of transport layer (Express, tRPC, WebSockets, etc).
-- **Code Deployment:** Bundle, test, and deploy agent code onto the artinet via the `./deployment` module (v0.5.3). Includes bundler, agent handler, and deployment utilities.
-
-| Component/Feature    | Description                                                                 | Key Classes/Types                                                                                    |
-| :------------------- | :-------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------- |
-| **Client**           | Interact with A2A-compliant agents. Supports standard & streaming requests. | `A2AClient`                                                                                          |
-| **Server**           | Quickly spin up an Agent as a Server.                                       | `createAgentServer`, `ExpressAgentServer`, `jsonRPCMiddleware`                                       |
-| **Agent Creation**   | Design agents with the Agent Builder or take control with the Agent Engine. | `AgentEngine`, `Context`, `AgentBuilder`                                                             |
-| **Storage**          | Persist event state. In-memory and file-based options included.             | `Store`, `InMemoryTaskStore`, `FileStore`                                                            |
-| **Streaming (SSE)**  | Handle real-time updates via Server-Sent Events with middleware support.    | Built-in SSE handling, streaming generators                                                          |
-| **Event Handling**   | Monitor agent execution with our event system.                              | `EventManager`, `eventOverrides`, Event listeners (`start`, `update`, `error`, `complete`, `cancel`) |
-| **Logging**          | Configure structured logging for debugging and monitoring.                  | `logger`, `configureLogger`, `LogLevel`                                                              |
-| **Transport Layers** | Built-in support for Express/TRPC.                                          | Express middleware, tRPC router, or easily create your own.                                          |
-| **Core Types**       | Fully implement A2A schema in Zod.                                          | `AgentCard`, `Task`, `Message`, `Part`, `Artifact`, etc.                                             |
-| **Deployment**       | Bundle, test, and deploy agents onto the artinet platform (v0.5.2).         | `@artinet/sdk/deployment`, `fullDeployment`, `testDeployment`, `bundle`                              |
-| **Agent Utilities**  | Run agents in managed environments with our proxy system.                   | `artinet.v0.taskManager`, `artinet.v0.connect`, `artinet.v0.agent`                                   |
+- **Modular Design:** Everything you need to get started building collaborative agents + its flexible enough for advanced configuration.
+- **Express:** Scaffold an Express Server with the `createAgentServer()` function. It handles all of the transport-layer complexity, adds A2A <-> JSON-RPC middleware, and manages Server-Sent Events (SSE) automatically.
+- **Protocol Compliance:** Implements the complete A2A specification (v0.3.0) with support for any kind of transport layer (tRPC, WebSockets, etc).
 
 ## Installation
 
@@ -83,10 +61,10 @@ npm install @artinet/sdk
 ## Requirements
 
 - Node.js (v22.0.0 or higher recommended)
-
+<!-- 
 ## Documentation
 
-For more detailed documentation visit our documentation site [here](https://the-artinet-project.github.io/artinet-documentation/).
+For more detailed documentation visit our documentation site [here](https://the-artinet-project.github.io/artinet-documentation/). -->
 
 ## Example
 
@@ -176,7 +154,7 @@ async function runClient() {
   console.log("Stream finished.");
 }
 
-runClient().catch(console.error);
+await runClient().catch(console.error);
 ```
 
 ## Running Tests
@@ -185,16 +163,6 @@ runClient().catch(console.error);
 npm test
 ```
 
-To run tests with coverage:
-
-```bash
-npm run test:coverage
-```
-
-## Typescript
-
-The Artinet SDK is written entirely in TypeScript and includes comprehensive type definitions, providing strong typing and enhanced developer experience.
-
 ## Usage
 
 ### Client
@@ -283,11 +251,11 @@ Use `createAgentServer()` to embed your Agents in an Express App.
 
 #### Implementing an A2A Agent
 
-The SDK provides a variety of options for creating complex ([AgentEngine](#agentengine)) or simple agents ([AgentBuilder](#agentbuilder)).
+The SDK provides a variety of options for creating complex ([AgentEngines](#agentengine)) or simple agents ([AgentBuilder](#agentbuilder)).
 
 ##### AgentBuilder
 
-**Option 1: Using AgentBuilder (Recommended for Simple Workflows)**
+**Option 1: Using the AgentBuilder (Recommended for Simple Workflows)**
 
 For simple agents with one or more processing steps, use the `AgentBuilder` pattern:
 
@@ -297,7 +265,7 @@ import { createAgentServer, AgentBuilder, TaskManager } from "@artinet/sdk";
 //create a simple agent
 const simpleAgent = AgentBuilder().text(() => "hello world!");
 
-//or design a powerful workflow
+//or design a powerful multi-step agent
 const { app, agent } = createAgentServer({
   agent: AgentBuilder()
     .text(({ command, context }) => {
@@ -349,7 +317,7 @@ The `AgentBuilder` approach is particularly useful when you need:
 
 - **Step-by-step processing**: Break down complex tasks into discrete, manageable steps
 - **Data flow between steps**: Pass results from one step to the next using the `args` parameter
-- **Different content types**: Mix text, file, and data processing in a single workflow
+- **Different content types**: Mix text, file, and data processing in a single flow
 - **Reusable components**: Build modular agents that can be easily edited or extended
 
 ##### AgentEngine
@@ -405,6 +373,7 @@ const { app, agent } = createAgentServer({
       version: "1.0.0",
       capabilities: { streaming: true },
       skills: [{ id: "processor", name: "Text Processor" }],
+      ...
     },
     tasks: new TaskManager(),
   },
@@ -523,55 +492,6 @@ const { app, agent } = createAgentServer({
 });
 ```
 
-#### Logging
-
-Use the built-in `pino`-based logger. Configure with `configureLogger`.
-
-```typescript
-import { logger, configureLogger, LogLevel, logDebug } from "@artinet/sdk";
-
-// Configure logging level (optional)
-configureLogger({ level: "debug" });
-
-logger.info("Server starting...");
-//use helper functions
-logDebug("LoggerTest", { taskId: "task-123" }, "Task status updated.");
-
-// Create child loggers with bounded contexts
-const taskLogger = logger.child({ taskId: "abc" });
-taskLogger.info("Processing step X");
-```
-
-#### Server Registration & Discovery (v0.5.2)
-
-The SDK includes features to help make your agent discoverable using the new service-based architecture:
-
-- **Automatic Registration:** You can configure your agent server to automatically register your `AgentCard` with the [A2A Registry](https://artinet.io) upon startup by setting `register: true` in the server parameters (temporarily unavailable in v0.5.6).
-
-```typescript
-const { app, agent } = createAgentServer({
-  agent: {
-    engine: myAgent,
-    agentCard: {
-      // ...
-      url: "http://my-public-domain:3000/my-agent", // Publicly accessible URL
-      // ...
-    },
-  },
-});
-```
-
-- **Custom Agent Card Path:** By default, the server exposes its `AgentCard` at `/.well-known/agent-card.json` following [RFC8615](https://datatracker.ietf.org/doc/html/rfc8615). You can specify a custom path using the `agentCardPath` option.
-
-```typescript
-const { app, agent } = createAgentServer({
-  ...
-  basePath: "/apiV2",
-  agentCardPath: "/apiV2/custom-card-info", // Custom agent card path
-});
-// The AgentCard is now accessible at http://localhost:3000/apiV2/custom-card-info
-```
-
 #### Advanced Server Customization
 
 Our new architecture provides multiple ways to customize your agent server:
@@ -595,7 +515,7 @@ const { app, agent } = createAgentServer({
   },
 });
 
-// custom middleware
+// more custom middleware
 app.use("/custom", (req, res, next) => {
   ...
 });
@@ -686,121 +606,77 @@ for await (const update of stream) {
 - Proper error handling and JSON-RPC compliance
 - CORS headers if needed for web clients
 
-### Quick-Agents (Alpha v0.5.2)
-
-We are excited to introduce new capabilities for deploying agents directly onto the artinet.
-
-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** Use the `fullDeployment` utility, which allows direct deployment of your bundled agent code and `AgentCard` to the Artinet platform (requires an `ARTINET_API_KEY`).
+#### Cross Protocol Support
 
-To join the beta waitlist, please email us at humans@artinet.io and stay tuned for more updates!
+**MCP (Model Context Protocol) Integration**
 
-Key features include:
+The SDK provides a Model Context Protocol (MCP) <-> A2A compatability layer.
 
-- **Easy Agent Bundling:** Bundle your agent's code and dependencies into a single file using the `bundle` utility from the new deployment export.
+Use `createMCPAgent` to expose your agent via MCP:
 
-  ```typescript
-  import { bundle } from "@artinet/sdk/deployment";
-
-  const bundledCode = await bundle(new URL("./your-agent.ts", import.meta.url));
-  ```
-
-- **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`: 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.
-
-  Example of using the new `artinet.v0` utilities in an agent:
-
-  ```typescript
-  import { TaskContext, TaskYieldUpdate, Task } from "@artinet/sdk";
-  import { artinet } from "@artinet/sdk/agents";
-
-  export async function* myAgentLogic(context: TaskContext): AsyncGenerator<TaskYieldUpdate, Task | void, unknown> {
-    yield { state: "working" };
-
-    // Call another agent/LLM using artinet.v0.connect
-    const llmResponse = await artinet.v0.connect({
-      agentId: "SomeLLMAgentID",
-      messages: [{ role: "user", content: "Tell me a joke." }]
-    });
-
-    // Or communicate tasks with artinet.v0.agent
-    const anotherAgent = artinet.v0.agent({
-      baseUrl: "https://agents.artinet.io/agentId=456",
-    });
-    const taskResult = await anotherAgent.sendTask({
-      ...
-    });
-
-  }
-
-  // The host environment will invoke this taskManager with the agent's logic.
-  await artinet.v0.taskManager({ taskHandler: myAgentLogic });
-  ```
-
-  _Note: The `taskHandlerProxy` and `fetchResponseProxy` utilities are now deprecated in favor of `artinet.v0.taskManager` and `artinet.v0.connect` respectively._
-
-- **Test-Agents (Experimental):** Simulate and test your agents @ agents.artinet.io/test/deploy using the `testDeployment` tool.
-
-  ```typescript
-  import {
-    testDeployment,
-    ServerDeploymentRequestParams,
-    SendTaskRequest,
-  } from "@artinet/sdk/deployment";
-
-  const deploymentParams: ServerDeploymentRequestParams = {
-    code: "/* bundled code string */",
-  };
-  //create a list of tasks for your agent to complete once deployed
-  const testRequests: SendTaskRequest[] = [
-    {
-      id: "t1",
-      message: { role: "user", parts: [{ type: "text", text: "Hi!" }] },
+```typescript
+import { createMCPAgent, createAgent } from "@artinet/sdk";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+
+// Wrap your agent in an MCP Server
+const mcpAgent = createMCPAgent({
+  serverInfo: {
+    name: "My MCP Agent",
+    version: "1.0.0",
+  },
+  options: {
+    ...
+  },
+  agent: createAgent({
+    engine: myAgentEngine,
+    agentCard: {
+      name: "My Agent",
+      url: "http://localhost:3000/a2a",
+      version: "1.0.0",
+      capabilities: { streaming: true },
+      skills: [{ id: "helper", name: "Helper Agent" }],
     },
-  ];
+  }),
+  agentCardUri: "agent://card", //customize the URI for your AgentCard
+});
 
-  for await (const result of testDeployment(deploymentParams, testRequests)) {
-    console.log(result); //process the task completion requests as they come in to confirm your agents logic
-  }
-  ```
+// The MCPAgent is a fully compliant MCP Server so you can use it as you normally would.
+mcpAgent.registerTool({
+  ...
+});
 
-- **Full Deployment (Experimental):** Deploy your agent to the Artinet platform using the `fullDeployment` utility.
+await mcpAgent.connect(new StdioServerTransport());
+```
 
-  ```typescript
-  import {
-    fullDeployment,
-    ServerDeploymentRequestParams,
-  } from "@artinet/sdk/deployment";
+Use an MCP Client to interact with an mcpAgent:
 
-  const deploymentParams: ServerDeploymentRequestParams = {
-    name: "My Awesome Agent",
-    agentCard: {
-      /* your agent card */
+```typescript
+...
+// Access the AgentCard as a Resource
+const agentCard = await client.readResource({ uri: "agent://card" });
+
+// or send messages via Tool Calling
+const result = await client.callTool({
+  name: "send-message",
+  arguments: {
+    ...
+    message: {
+      ...
+      parts: [{ kind: "text", text: "Hello from MCP!" }],
     },
-    code: "/* bundled code string */",
-  };
-
-  const deploymentResult = await fullDeployment(deploymentParams); // Requires an ARTINET_API_KEY environment variable
-  console.log("Deployment Result:", deploymentResult);
-  ```
-
-- **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-card.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**
+  },
+});
+```
 
-- Test-Agents expire after 60s (need more time? let us know @humans@artinet.io)
-- Quick-Agents do not have access to a filesystem or networking (limited persistance & networking capabalities are on the project roadmap).
-- 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.
-- Available with version 0.5.6+ of the SDK with enhanced deployment capabilities.
+**MCP Tools & Resources:**
 
-Sign-up at [artinet.io](https://artinet.io/) to deploy your Quick-Agent today!
+- `send-message`: Send messages to the A2A agent
+- `get-task`: Retrieve tasks by ID
+- `cancel-task`: Cancel a running task
+- `agent://card`: Retrieve the AgentCard
+- `send-streaming-message`, `task-resubscribe` & `push-notifications` etc are currently not supported by default.
+  - Leverage the A2A Zod Schemas to implement them manually.
 
 ## Contributing
 
@@ -814,10 +690,9 @@ 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/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.
+This SDK builds upon the concepts and specifications of the [Agent2Agent (A2A) Protocol](https://github.com/google-a2a/A2A).
 
 Libraries used include:
 
 - [Express.js](https://expressjs.com/) for the server framework.
-- [Pino](https://getpino.io/) for logging.
 - [EventSource Parser](https://github.com/rexxars/eventsource-parser) for SSE streaming.

package/dist/client/a2a-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-client.d.ts","sourceRoot":"","sources":["../../src/client/a2a-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,SAAS,EAMT,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,0BAA0B,EAM1B,IAAI,EAGJ,OAAO,EAEP,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAW3B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAE5D;;;GAGG;AACH,qBAAa,SAAU,YAAW,MAAM;IACtC,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,YAAY,CAAS;IAC7B;;;;OAIG;gBAED,OAAO,EAAE,GAAG,GAAG,MAAM,EACrB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACpC,YAAY,CAAC,EAAE,MAAM;IAOvB;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC;IAyDrC;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,SAAS,CAAC;IAK5C;;;;OAIG;IACG,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;IAS5E;;;;;OAKG;IACG,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;IAIzE;;;;OAIG;IACH,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,aAAa,CAAC,WAAW,CAAC;IAO3E;;;;;OAKG;IACH,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,aAAa,CAAC,WAAW,CAAC;IAIxE;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAS5D;;;;OAIG;IACG,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAS5D;;;;OAIG;IACG,uBAAuB,CAC3B,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC;IAY7C;;;;OAIG;IACG,uBAAuB,CAC3B,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC;IAY7C;;;;OAIG;IACH,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,aAAa,CAAC,WAAW,CAAC;IAOpE;;;;OAIG;IACG,QAAQ,CACZ,UAAU,EAAE,WAAW,GAAG,mBAAmB,GAAG,wBAAwB,GACvE,OAAO,CAAC,OAAO,CAAC;IA4BnB;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAIjD;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI5C;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhC;;OAEG;IACH,YAAY,IAAI,IAAI;CAGrB"}

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./types/index.js";
+export * from "./client/index.js";
+export * from "./server/index.js";
+export * from "./services/index.js";
+export * from "./transport/index.js";
+export * from "./utils/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC"}

package/dist/server/express/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/server/express/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAGnD;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,mBAuC1B,CAAC"}

package/dist/server/express/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/express/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/server/express/middeware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middeware.d.ts","sourceRoot":"","sources":["../../../src/server/express/middeware.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,6BAAyB;AAiCvD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,mBAAmB,EAC5B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAkGf"}

package/dist/{types/server → server}/express/server.d.ts

@@ -15,12 +15,12 @@ export declare function createAgentServer(params: ServerParams & {
     agentCardPath?: string;
     register?: boolean;
 }): {
-    app: express.Express;
+    app: import("express-serve-static-core").Express;
     agent: Agent<{
         message: {
             role: "user" | "agent";
+            kind: "message";
             parts: ({
-                kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
                 file: {
                     bytes: string;
                     name?: string | undefined;
@@ -29,29 +29,29 @@ export declare function createAgentServer(params: ServerParams & {
                 } | {
                     uri: string;
                     name?: string | undefined;
-                    mimeType?: string | undefined;
                     bytes?: undefined;
+                    mimeType?: string | undefined;
                 };
+                kind: "file";
                 metadata?: Record<string, unknown> | undefined;
             } | {
-                kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
                 text: string;
+                kind: "text";
                 metadata?: Record<string, unknown> | undefined;
             } | {
-                kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
                 data: Record<string, unknown>;
+                kind: "data";
                 metadata?: Record<string, unknown> | undefined;
             })[];
             messageId: string;
-            kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
             metadata?: Record<string, unknown> | undefined;
             extensions?: string[] | undefined;
             referenceTaskIds?: string[] | undefined;
             taskId?: string | undefined;
             contextId?: string | undefined;
         };
+        metadata?: Record<string, unknown> | undefined;
         configuration?: {
-            acceptedOutputModes?: string[] | undefined;
             historyLength?: number | undefined;
             pushNotificationConfig?: {
                 url: string;
@@ -62,9 +62,9 @@ export declare function createAgentServer(params: ServerParams & {
                     credentials?: string | undefined;
                 } | undefined;
             } | undefined;
+            acceptedOutputModes?: string[] | undefined;
             blocking?: boolean | undefined;
         } | undefined;
-        metadata?: Record<string, unknown> | undefined;
     }, import("../../types/index.js").TaskAndHistory, import("../../types/index.js").UpdateEvent>;
 };
 export type ExpressAgentServer = ReturnType<typeof createAgentServer>;

package/dist/server/express/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/server/express/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,KAAK,EAAE,aAAa,IAAI,iBAAiB,EAAE,6BAAyB;AAE7E,OAAa,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAIzC,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAmCD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,GAAG;IACrB,KAAK,EAAE,KAAK,GAAG,iBAAiB,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuDF;AAED,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/{types/services → services}/a2a/factory/builder.d.ts

@@ -10,7 +10,7 @@
  * workflows with type-safe step composition and automatic execution orchestration.
  *
  * @module A2ABuilder
- * @version 1.0.0
+ * @version 0.5.7
  * @since 0.5.6
  * @author The Artinet Project
  */
@@ -278,8 +278,8 @@ export declare class EngineBuilder<TCommand extends MessageSendParams = MessageS
 export declare const AgentBuilder: () => EngineBuilder<{
     message: {
         role: "user" | "agent";
+        kind: "message";
         parts: ({
-            kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
             file: {
                 bytes: string;
                 name?: string | undefined;
@@ -288,29 +288,29 @@ export declare const AgentBuilder: () => EngineBuilder<{
             } | {
                 uri: string;
                 name?: string | undefined;
-                mimeType?: string | undefined;
                 bytes?: undefined;
+                mimeType?: string | undefined;
             };
+            kind: "file";
             metadata?: Record<string, unknown> | undefined;
         } | {
-            kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
             text: string;
+            kind: "text";
             metadata?: Record<string, unknown> | undefined;
         } | {
-            kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
         })[];
         messageId: string;
-        kind: "artifact-update" | "data" | "file" | "message" | "status-update" | "task" | "text";
         metadata?: Record<string, unknown> | undefined;
         extensions?: string[] | undefined;
         referenceTaskIds?: string[] | undefined;
         taskId?: string | undefined;
         contextId?: string | undefined;
     };
+    metadata?: Record<string, unknown> | undefined;
     configuration?: {
-        acceptedOutputModes?: string[] | undefined;
         historyLength?: number | undefined;
         pushNotificationConfig?: {
             url: string;
@@ -321,9 +321,9 @@ export declare const AgentBuilder: () => EngineBuilder<{
                 credentials?: string | undefined;
             } | undefined;
         } | undefined;
+        acceptedOutputModes?: string[] | undefined;
         blocking?: boolean | undefined;
     } | undefined;
-    metadata?: Record<string, unknown> | undefined;
 }, []>;
 /**
  * Creates an agent execution engine from a list of workflow steps.

package/dist/services/a2a/factory/builder.d.ts.map

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

package/dist/services/a2a/factory/builder.js

@@ -10,12 +10,13 @@
  * workflows with type-safe step composition and automatic execution orchestration.
  *
  * @module A2ABuilder
- * @version 1.0.0
+ * @version 0.5.7
  * @since 0.5.6
  * @author The Artinet Project
  */
 import { TaskState, } from "../../../types/index.js";
 import { createAgent } from "./service.js";
+import { v4 as uuidv4 } from "uuid";
 /**
  * Fluent builder for constructing A2A agent execution engines.
  *
@@ -285,7 +286,6 @@ export function createAgentExecutor(stepsList) {
         };
         const contextId = context.command.message.contextId;
         const taskId = context.command.message.taskId;
-        const messageId = context.command.message.messageId;
         if (!contextId || !taskId) {
             throw new Error("Context ID and task ID are required");
         }
@@ -303,7 +303,7 @@ export function createAgentExecutor(stepsList) {
         const finalMessage = {
             taskId: taskId,
             contextId: contextId,
-            messageId: messageId,
+            messageId: uuidv4(),
             kind: "message",
             role: "agent",
             parts: [],
@@ -321,7 +321,7 @@ export function createAgentExecutor(stepsList) {
                         state: TaskState.working,
                         timestamp: new Date().toISOString(),
                         message: {
-                            messageId: messageId,
+                            messageId: uuidv4(),
                             kind: "message",
                             role: "agent",
                             parts: parts,
@@ -343,7 +343,7 @@ export function createAgentExecutor(stepsList) {
                         state: TaskState.working,
                         timestamp: new Date().toISOString(),
                         message: {
-                            messageId: messageId,
+                            messageId: uuidv4(),
                             kind: "message",
                             role: "agent",
                             parts: parts,
@@ -364,7 +364,7 @@ export function createAgentExecutor(stepsList) {
                         state: TaskState.working,
                         timestamp: new Date().toISOString(),
                         message: {
-                            messageId: messageId,
+                            messageId: uuidv4(),
                             kind: "message",
                             role: "agent",
                             parts: parts,