@artinet/sdk 0.6.0-preview.2 → 0.6.0-preview.3

package/README.md

@@ -67,22 +67,13 @@ npm install @a2a-js/sdk @modelcontextprotocol/sdk @trpc/server
 **Server:**
 
 ```typescript
-import { createAgentServer, AgentBuilder } from "@artinet/sdk";
-
-const { app } = createAgentServer({
-  agent: AgentBuilder()
-    .text(async ({ content }) => {
-      return `You said: ${content}`;
-    })
-    .createAgent({
-      agentCard: "QuickStart Agent",
-    }),
-  basePath: "/a2a",
-});
-
-app.listen(3000, () => {
-  console.log("A2A Server running at http://localhost:3000/a2a");
-});
+import { cr8 } from "@artinet/sdk";
+
+const { app } = cr8("QuickStart Agent")
+  .text(async ({ content }) => {
+    return `You said: ${content}`;
+  }) //start an a2a server on port 3000
+  .server.start(3000);
 ```
 
 **Client:**

package/dist/create/status-builder.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import { A2A } from "../types/index.js";
 /**
  * @deprecated Use {@link update.status} instead

package/dist/extensions/otel.d.ts

@@ -1,4 +1,7 @@
 /**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ *
  * @fileoverview OpenTelemetry integration for Artinet SDK.
  *
  * Lightweight utilities for integrating user-configured OpenTelemetry

package/dist/extensions/otel.js

@@ -1,4 +1,7 @@
 /**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ *
  * @fileoverview OpenTelemetry integration for Artinet SDK.
  *
  * Lightweight utilities for integrating user-configured OpenTelemetry

package/dist/extensions/pino.d.ts

@@ -1,4 +1,7 @@
 /**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ *
  * @fileoverview Pino logger adapter for Artinet SDK.
  *
  * Lightweight wrapper that adapts a user-configured Pino instance

package/dist/extensions/pino.js

@@ -1,4 +1,7 @@
 /**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ *
  * @fileoverview Pino logger adapter for Artinet SDK.
  *
  * Lightweight wrapper that adapts a user-configured Pino instance

package/dist/extensions/winston.d.ts

@@ -1,4 +1,7 @@
 /**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ *
  * @fileoverview Winston logger adapter for Artinet SDK.
  *
  * Lightweight wrapper that adapts a user-configured Winston instance

package/dist/extensions/winston.js

@@ -1,4 +1,7 @@
 /**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ *
  * @fileoverview Winston logger adapter for Artinet SDK.
  *
  * Lightweight wrapper that adapts a user-configured Winston instance

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

@@ -21,6 +21,20 @@ export interface ServerParams {
     register?: boolean;
 }
 export declare function rpcParser(req: express.Request, res: express.Response, next: express.NextFunction): void;
+/**
+ * @note Best used with the `cr8` builder.
+ * @param {ServerParams} params - The server parameters
+ * @returns {ExpressAgentServer} - The express agent server
+ * @example
+ * ```typescript
+ * const { app, agent, start } = createAgentServer({
+ *   agent: cr8("MyAgent")
+ *     .text("Hello, world!")
+ *     .agent,
+ *   basePath: "/a2a",
+ * });
+ * ```
+ */
 export declare function createAgentServer({ app, basePath, agentCardPath, agent, corsOptions, extendedAgentCard, register, port, }: ServerParams): {
     app: express.Express;
     agent: Agent;

package/dist/server/express/server.js

@@ -48,6 +48,20 @@ const registerAgent = async (agentCard) => {
     logger.debug("registerAgent: not implemented", { agentCard });
     return Promise.resolve(agentCard);
 };
+/**
+ * @note Best used with the `cr8` builder.
+ * @param {ServerParams} params - The server parameters
+ * @returns {ExpressAgentServer} - The express agent server
+ * @example
+ * ```typescript
+ * const { app, agent, start } = createAgentServer({
+ *   agent: cr8("MyAgent")
+ *     .text("Hello, world!")
+ *     .agent,
+ *   basePath: "/a2a",
+ * });
+ * ```
+ */
 export function createAgentServer({ app = express(), basePath = "/", agentCardPath = "/.well-known/agent-card.json", agent, corsOptions, extendedAgentCard, register = false, port, }) {
     const agentInstance = ensureAgent(agent);
     app.use(cors(corsOptions));

package/dist/services/a2a/handlers/update.js

@@ -18,7 +18,7 @@ const updateHistory = (task, updateMessage) => {
 export const handleMessageUpdate = async ({ task, update, }) => {
     const validated = await validateSchema(A2A.MessageSchema, update);
     if (validated.taskId && task.id !== validated.taskId) {
-        throw new Error(`updateMessage: Invalid task id: ${validated.taskId} ${formatJson({
+        throw new Error(`updateMessage: Invalid task id: incoming: ${validated.taskId} expected: ${task.id} ${formatJson({
             cause: {
                 validated,
                 actual: task.id,
@@ -32,7 +32,7 @@ export const handleMessageUpdate = async ({ task, update, }) => {
 export const handleTaskUpdate = async ({ context, task, update, }) => {
     const validated = await validateSchema(A2A.TaskSchema, update);
     if (task.id !== validated.id) {
-        throw new Error(`updateTask: Invalid task id: ${validated.id}`, {
+        throw new Error(`updateTask: Invalid task id: incoming: ${validated.id} expected: ${task.id}`, {
             cause: validated,
         });
     }
@@ -45,7 +45,7 @@ export const handleTaskUpdate = async ({ context, task, update, }) => {
 export const handleStatusUpdate = async ({ task, update, }) => {
     const validated = await validateSchema(A2A.TaskStatusUpdateEventSchema, update);
     if (validated.taskId && task.id !== validated.taskId) {
-        throw new Error(`updateTaskStatusUpdate: Invalid task id: ${validated.taskId}`, { cause: validated });
+        throw new Error(`updateTaskStatusUpdate: Invalid task id: incoming: ${validated.taskId} expected: ${task.id}`, { cause: validated });
     }
     task.status = validated.status;
     task.status.timestamp = getCurrentTimestamp();
@@ -57,13 +57,11 @@ export const handleStatusUpdate = async ({ task, update, }) => {
 export const handleArtifactUpdate = async ({ task, update }) => {
     const validated = await validateSchema(A2A.TaskArtifactUpdateEventSchema, update);
     if (validated.taskId && task.id !== validated.taskId) {
-        throw new Error(`updateTaskArtifactUpdate: Invalid task id: ${validated.taskId}`, {
+        throw new Error(`updateTaskArtifactUpdate: Invalid task id: incoming: ${validated.taskId} expected: ${task.id}`, {
             cause: validated,
         });
     }
-    else {
-        validated.taskId = task.id;
-    }
+    validated.taskId = task.id;
     task.artifacts = upsertArtifact(task.artifacts ?? [], validated);
     return task;
 };

package/dist/services/a2a/service.js

@@ -31,8 +31,8 @@ const createMessageParams = (task) => {
 /**
  * @note Comprehensive Extension system coming in a future release
  */
-const getExtensions = async (extensions) => {
-    logger.warn("getExtensions: not implemented", { extensions });
+const getExtensions = async (_extensions) => {
+    // logger.warn("getExtensions: not implemented", { extensions });
     return [];
 };
 /**

package/dist/transport/trpc/a2a/routes/message/route.js

@@ -3,7 +3,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { router, A2AProcedure } from "../../trpc.js";
-import { INVALID_PARAMS, zAsyncIterable } from "../../../../../utils/index.js";
+import { INVALID_PARAMS } from "../../../../../utils/common/errors.js";
+import { zAsyncIterable } from "../../../../../utils/common/zAsyncIterable.js";
 import { A2A } from "../../../../../types/index.js";
 const sendMessageRoute = A2AProcedure.input(A2A.MessageSendParamsSchema)
     .output(A2A.SendMessageSuccessResultSchema)

package/dist/transport/trpc/a2a/routes/tasks/route.js

@@ -5,7 +5,8 @@
 import { z } from "zod/v4";
 import { router, A2AProcedure } from "../../trpc.js";
 import { A2A } from "../../../../../types/index.js";
-import { INVALID_REQUEST, PUSH_NOTIFICATION_NOT_SUPPORTED, zAsyncIterable, } from "../../../../../utils/index.js";
+import { INVALID_REQUEST, PUSH_NOTIFICATION_NOT_SUPPORTED, } from "../../../../../utils/common/errors.js";
+import { zAsyncIterable } from "../../../../../utils/common/zAsyncIterable.js";
 const pushNotificationConfigRouter = router({
     set: A2AProcedure.input(A2A.TaskPushNotificationConfigSchema)
         .output(A2A.TaskPushNotificationConfigSchema)

package/dist/utils/index.d.ts

@@ -6,6 +6,5 @@ export * from "./common/constants.js";
 export * from "./common/errors.js";
 export * from "./common/schema-validation.js";
 export * from "./common/utils.js";
-export * from "./common/zAsyncIterable.js";
 export * from "./common/parse.js";
 export * from "./storage/file.js";

package/dist/utils/index.js

@@ -6,6 +6,5 @@ export * from "./common/constants.js";
 export * from "./common/errors.js";
 export * from "./common/schema-validation.js";
 export * from "./common/utils.js";
-export * from "./common/zAsyncIterable.js";
 export * from "./common/parse.js";
 export * from "./storage/file.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artinet/sdk",
-  "version": "0.6.0-preview.2",
+  "version": "0.6.0-preview.3",
   "description": "A TypeScript SDK for building collaborative AI agents.",
   "type": "module",
   "main": "./dist/index.js",
@@ -91,7 +91,7 @@
   },
   "homepage": "https://github.com/the-artinet-project/artinet-sdk#readme",
   "dependencies": {
-    "@artinet/types": "^0.0.9-alpha.3",
+    "@artinet/types": "^0.0.9-alpha.4",
     "cors": "^2.8.5",
     "escape-html": "^1.0.3",
     "eventsource-parser": "^3.0.1",