@artinet/sdk 0.5.15 → 0.5.16

package/README.md

@@ -71,7 +71,9 @@ It has [serveral template projects](https://github.com/the-artinet-project/creat
 - The examples folder will be removed in favor of [`create-agent`](https://github.com/the-artinet-project/create-agent).
 - In `Task` the `contextId` field is now required (inline with the A2A spec).
 - In `AgentSkill` the `tag` field is now required (inline with the A2A spec).
-- Optional fields in Agent2Agent schema fields are now nullable for better interoperability.
+- Optional fields in Agent2Agent Zod schemas are now nullable for better interoperability.
+- The `EngineBuilder` constructor is now protected and open for extension.
+- `AgentBuilder` will now throw an error if it recieves an invalid `FilePart`.
 
 ## Installation
 

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

@@ -140,11 +140,11 @@ type OutArgsOf<O> = O extends StepOutputWithForwardArgs<any, infer A> ? A : [];
 export declare class EngineBuilder<TCommand extends MessageSendParams = MessageSendParams, TInboundArgs extends readonly unknown[] = []> implements StepBuilder<TCommand, TInboundArgs> {
     private steps;
     /**
-     * Private constructor to enforce factory method usage.
+     * Protected constructor to enforce factory method usage.
      *
      * @param steps - Initial steps array
      */
-    private constructor();
+    protected constructor(steps?: Array<StepWithKind<TCommand, any, any, any, any, any>>);
     /**
      * Creates a new EngineBuilder instance.
      *

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

@@ -18,6 +18,7 @@ import { TaskState, } from "../../../types/index.js";
 import { createAgent } from "./service.js";
 import { v4 as uuidv4 } from "uuid";
 import { getContent } from "../helpers/content.js";
+import { SUBMITTED_UPDATE, WORKING_UPDATE } from "../../../utils/index.js";
 /**
  * Fluent builder for constructing A2A agent execution engines.
  *
@@ -50,7 +51,7 @@ export class EngineBuilder {
     //@typescript-eslint/no-explicit-any
     steps = [];
     /**
-     * Private constructor to enforce factory method usage.
+     * Protected constructor to enforce factory method usage.
      *
      * @param steps - Initial steps array
      */
@@ -231,23 +232,27 @@ const partToMessagePart = (kind, part) => {
         }
         case "file": {
             const filePart = part;
-            return filePart.uri
-                ? {
+            if (filePart.uri) {
+                return {
                     kind: "file",
                     file: {
                         uri: filePart.uri,
                         name: filePart.name,
                         mimeType: filePart.mimeType,
                     },
-                }
-                : {
-                    kind: "file",
-                    file: {
-                        bytes: filePart.bytes ?? "",
-                        name: filePart.name,
-                        mimeType: filePart.mimeType,
-                    },
                 };
+            }
+            if (!filePart.bytes) {
+                throw new Error("File bytes are required when uri is not provided");
+            }
+            return {
+                kind: "file",
+                file: {
+                    bytes: filePart.bytes,
+                    name: filePart.name,
+                    mimeType: filePart.mimeType,
+                },
+            };
         }
         case "data": {
             return { kind: "data", data: part };
@@ -287,21 +292,12 @@ export function createAgentExecutor(stepsList) {
             content: content,
             args: [],
         };
-        const contextId = context.contextId ?? context.command.message.contextId;
-        const taskId = context.State().task.id ?? context.command.message.taskId;
+        const contextId = context.contextId;
+        const taskId = context.State().task.id;
         if (!contextId || !taskId) {
             throw new Error("Context ID and task ID are required");
         }
-        const taskStarted = {
-            taskId: taskId,
-            contextId: contextId,
-            kind: "status-update",
-            status: {
-                state: TaskState.submitted,
-                timestamp: new Date().toISOString(),
-            },
-            final: false,
-        };
+        const taskStarted = SUBMITTED_UPDATE(taskId, contextId);
         yield taskStarted;
         const finalMessage = {
             taskId: taskId,
@@ -316,65 +312,35 @@ export function createAgentExecutor(stepsList) {
             let parts = [];
             if (Array.isArray(ret)) {
                 parts = ret.map((part) => partToMessagePart(step.kind, part));
-                const taskStatusUpdate = {
-                    taskId: taskId,
-                    contextId: contextId,
-                    kind: "status-update",
-                    status: {
-                        state: TaskState.working,
-                        timestamp: new Date().toISOString(),
-                        message: {
-                            messageId: uuidv4(),
-                            kind: "message",
-                            role: "agent",
-                            parts: parts,
-                        },
-                    },
-                    final: false,
-                };
+                const taskStatusUpdate = WORKING_UPDATE(taskId, contextId, {
+                    messageId: uuidv4(),
+                    kind: "message",
+                    role: "agent",
+                    parts: parts,
+                });
                 yield taskStatusUpdate;
             }
-            else if (typeof ret === "object") {
+            else if (ret !== null && typeof ret === "object") {
                 parts = Array.isArray(ret.parts)
                     ? ret.parts.map((part) => partToMessagePart(step.kind, part))
                     : [partToMessagePart(step.kind, ret.parts)];
-                const taskStatusUpdate = {
-                    taskId: taskId,
-                    contextId: contextId,
-                    kind: "status-update",
-                    status: {
-                        state: TaskState.working,
-                        timestamp: new Date().toISOString(),
-                        message: {
-                            messageId: uuidv4(),
-                            kind: "message",
-                            role: "agent",
-                            parts: parts,
-                        },
-                    },
-                    final: false,
-                };
+                const taskStatusUpdate = WORKING_UPDATE(taskId, contextId, {
+                    messageId: uuidv4(),
+                    kind: "message",
+                    role: "agent",
+                    parts: parts,
+                });
                 yield taskStatusUpdate;
                 stepArgs.args = ret.args;
             }
             else {
                 parts = [partToMessagePart(step.kind, ret)];
-                const taskStatusUpdate = {
-                    taskId: taskId,
-                    contextId: contextId,
-                    kind: "status-update",
-                    status: {
-                        state: TaskState.working,
-                        timestamp: new Date().toISOString(),
-                        message: {
-                            messageId: uuidv4(),
-                            kind: "message",
-                            role: "agent",
-                            parts: parts,
-                        },
-                    },
-                    final: false,
-                };
+                const taskStatusUpdate = WORKING_UPDATE(taskId, contextId, {
+                    messageId: uuidv4(),
+                    kind: "message",
+                    role: "agent",
+                    parts: parts,
+                });
                 yield taskStatusUpdate;
             }
             finalMessage.parts.push(...parts);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artinet/sdk",
-  "version": "0.5.15",
+  "version": "0.5.16",
   "description": "A TypeScript SDK for building collaborative AI agents.",
   "type": "module",
   "main": "./dist/index.js",