@artinet/sdk 0.5.17 → 0.6.0-preview.1

package/dist/utils/storage/file.js

@@ -2,21 +2,26 @@
  * Copyright 2025 The Artinet Project
  * SPDX-License-Identifier: Apache-2.0
  */
-import { logError, logDebug } from "../logging/log.js";
+import { A2A } from "../../types/index.js";
 import fs from "fs/promises";
 import path from "path";
+import { logger } from "../../config/index.js";
+import { Tasks } from "../../services/a2a/managers.js";
+import { formatJson, safeParseSchema } from "../index.js";
 /**
  * File-based implementation of the TaskStore interface.
  * Stores tasks and their history as JSON files on disk.
  */
-export class FileStore {
+export class Files extends Tasks {
     baseDir;
     /**
      * Creates a new FileStore.
      * @param baseDir The base directory to store task files in.
      */
     constructor(baseDir) {
+        super(new Map());
         this.baseDir = baseDir;
+        logger.info(`FileStore[init]: baseDir`, { baseDir });
     }
     /**
      * Constructs the file path for a task.
@@ -26,14 +31,6 @@ export class FileStore {
     getTaskFilePath(taskId) {
         return path.join(this.baseDir, `${taskId}.task.json`);
     }
-    /**
-     * Constructs the file path for a task's history.
-     * @param taskId The task ID
-     * @returns The full file path for the history JSON file
-     */
-    getHistoryFilePath(taskId) {
-        return path.join(this.baseDir, `${taskId}.history.json`);
-    }
     /**
      * Ensures the base directory exists.
      * @returns A promise that resolves when the directory exists.
@@ -43,7 +40,7 @@ export class FileStore {
             await fs.mkdir(this.baseDir, { recursive: true });
         }
         catch (error) {
-            logError("FileStore", `Failed to create directory: ${this.baseDir}`, error);
+            logger.warn(`FileStore[ensureBaseDir]: ${this.baseDir}`, error);
             throw error;
         }
     }
@@ -53,15 +50,15 @@ export class FileStore {
      * @param data The data to write
      * @returns A promise that resolves when the write is complete
      */
-    async writeJsonFile(filePath, data) {
+    async writeJsonFile(filePath, task) {
         try {
             await this.ensureBaseDir();
-            await fs.writeFile(filePath, JSON.stringify(data, null, 2), {
+            await fs.writeFile(filePath, formatJson(task), {
                 encoding: "utf8",
             });
         }
         catch (error) {
-            logError("FileStore", `Failed to write file: ${filePath}`, error);
+            logger.warn(`FileStore[writeJsonFile]: ${filePath}`, error);
             throw error;
         }
     }
@@ -73,88 +70,62 @@ export class FileStore {
     async readJsonFile(filePath) {
         try {
             const content = await fs.readFile(filePath, { encoding: "utf8" });
-            return JSON.parse(content);
+            return await safeParseSchema(content, A2A.TaskSchema);
         }
         catch (error) {
             if (error.code === "ENOENT") {
-                // File not found - return null rather than throwing
+                logger.warn(`FileStore[readJsonFile]: ${filePath} not found`);
                 return null;
             }
-            logError("FileStore", `Failed to read file: ${filePath}`, error);
             throw error;
         }
     }
-    /**
-     * Type guard to validate the structure of history file content.
-     * @param content The content to check
-     * @returns True if the content is a valid history file content
-     */
-    isHistoryFileContent(content) {
-        return (content !== undefined &&
-            typeof content === "object" &&
-            content !== null &&
-            "messageHistory" in content &&
-            Array.isArray(content.messageHistory));
-    }
     /**
      * Loads a task and its history by task ID.
      * @param taskId The ID of the task to load.
      * @returns A promise resolving to the task and history, or null if not found.
      */
-    async getState(taskId) {
-        logDebug("FileStore", `Loading task: ${taskId}`);
-        const taskFilePath = this.getTaskFilePath(taskId);
-        const historyFilePath = this.getHistoryFilePath(taskId);
-        // Read task file first - if it doesn't exist, the task doesn't exist.
-        const task = await this.readJsonFile(taskFilePath).catch(() => undefined);
-        if (!task) {
-            return undefined; // Task not found
-        }
-        // Task exists, now try to read history. It might not exist yet.
-        let history = [];
-        try {
-            const historyContent = await this.readJsonFile(historyFilePath).catch(() => undefined);
-            // Validate the structure
-            if (this.isHistoryFileContent(historyContent)) {
-                history = historyContent.messageHistory;
-            }
-            else if (historyContent !== null) {
-                // Log a warning if the history file exists but is malformed
-                logError("FileStore", `Malformed history file found for task ${taskId}`, new Error("Invalid history file format"), { path: historyFilePath });
-                // Proceed with empty history
-            }
-            // If historyContent is null (file not found), history remains []
-        }
-        catch (error) {
-            // Log error reading history but proceed with empty history
-            logError("FileStore", `Error reading history file for task ${taskId}`, error, { path: historyFilePath });
-            // Proceed with empty history
-        }
-        return { task, history };
+    async get(taskId) {
+        const task = (await super.get(taskId)) ??
+            (await this.readJsonFile(this.getTaskFilePath(taskId)).catch(() => undefined));
+        return task ?? undefined;
     }
     /**
      * Saves a task and its history.
      * @param data The task and history to save.
      * @returns A promise that resolves when the save is complete.
      */
-    async setState(taskId, data) {
-        logDebug("FileStore", `Saving task: ${data.task.id}`);
-        if (taskId !== data.task.id) {
+    async set(taskId, task) {
+        logger.debug(`FileStore[set]: ${taskId}`);
+        if (!task) {
+            return;
+        }
+        if (task && taskId !== task.id) {
+            logger.warn("FileStore", `Task ID mismatch: ${taskId} !== ${task.id}`);
             throw new Error("Task ID mismatch");
         }
         const taskFilePath = this.getTaskFilePath(taskId);
-        const historyFilePath = this.getHistoryFilePath(taskId);
-        // For simplicity and atomicity, we'll write each file individually
-        // First, write the task file
-        await this.writeJsonFile(taskFilePath, data.task);
-        // Then, write the history file
-        // We'll wrap it in an object to allow for future extensibility
-        await this.writeJsonFile(historyFilePath, {
-            messageHistory: data.history,
-        });
+        await this.writeJsonFile(taskFilePath, task);
+        await super.set(taskId, task);
+    }
+    async delete(taskId) {
+        logger.debug(`FileStore[delete]: ${taskId}`);
+        const taskFilePath = this.getTaskFilePath(taskId);
+        await fs.unlink(taskFilePath);
+        await super.delete(taskId);
+    }
+    async has(taskId) {
+        if (await super.has(taskId)) {
+            return true;
+        }
+        const taskFilePath = this.getTaskFilePath(taskId);
+        return fs
+            .access(taskFilePath)
+            .then(() => true)
+            .catch(() => false);
     }
-    async getStates() {
+    async list() {
         const taskIds = await fs.readdir(this.baseDir);
-        return taskIds.map((taskId) => taskId.replace(".task.json", ""));
+        return Promise.all(taskIds.map((taskId) => this.get(taskId).catch(() => undefined))).then((tasks) => tasks.filter((task) => task !== undefined));
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artinet/sdk",
-  "version": "0.5.17",
+  "version": "0.6.0-preview.1",
   "description": "A TypeScript SDK for building collaborative AI agents.",
   "type": "module",
   "main": "./dist/index.js",
@@ -8,14 +8,45 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "browser": {
+        "types": "./dist/browser.d.ts",
+        "import": "./dist/browser/browser.js",
+        "default": "./dist/browser/browser.js"
+      },
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./trpc": {
+      "types": "./dist/transport/trpc/index.d.ts",
+      "import": "./dist/transport/trpc/index.js",
+      "default": "./dist/transport/trpc/index.js"
+    },
     "./types": {
       "types": "./dist/types/index.d.ts",
       "import": "./dist/types/index.js",
       "default": "./dist/types/index.js"
+    },
+    "./pino": {
+      "node": {
+        "types": "./dist/extensions/pino.d.ts",
+        "import": "./dist/extensions/pino.js",
+        "default": "./dist/extensions/pino.js"
+      }
+    },
+    "./winston": {
+      "node": {
+        "types": "./dist/extensions/winston.d.ts",
+        "import": "./dist/extensions/winston.js",
+        "default": "./dist/extensions/winston.js"
+      }
+    },
+    "./otel": {
+      "node": {
+        "types": "./dist/extensions/opentelemetry.d.ts",
+        "import": "./dist/extensions/opentelemetry.js",
+        "default": "./dist/extensions/opentelemetry.js"
+      }
     }
   },
   "rootDir": ".",
@@ -28,15 +59,16 @@
   "scripts": {
     "prepare": "ts-patch install -s",
     "build": "tsc --project tsconfig.json",
+    "build:browser": "tsc --project tsconfig.browser.json",
+    "build:all": "npm run build && npm run build:browser",
     "clean": "rimraf dist",
-    "rebuild": "rimraf dist node_modules/ package-lock.json && npm i && npm run build",
+    "rebuild": "rimraf dist node_modules/ package-lock.json && npm i && npm run build:all",
     "lint": "eslint src --ext .ts",
-    "prepublishOnly": "npm run clean && npm run build && npm run lint && npm test",
+    "prepublishOnly": "npm run rebuild && npm run lint && npm test",
     "test": "NODE_OPTIONS=--experimental-vm-modules jest",
     "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch",
     "test:coverage": "NODE_OPTIONS=--experimental-vm-modules jest --coverage",
-    "dev:quickstart": "tsx watch quickstart/quick-server.ts",
-    "dev-pack": "rimraf dist node_modules/ && npm i && npm run build && npm pack"
+    "dev:quickstart": "tsx watch quickstart/quick-server.ts"
   },
   "keywords": [
     "agent2agent",
@@ -44,13 +76,9 @@
     "artinet",
     "ai",
     "agent",
-    "sdk",
     "artificial intelligence",
-    "ai agent",
-    "multi-agent",
-    "multi-agent system",
-    "orchestration",
-    "swarms"
+    "mcp",
+    "modelcontextprotocol"
   ],
   "author": "artinet",
   "license": "Apache-2.0",
@@ -63,28 +91,62 @@
   },
   "homepage": "https://github.com/the-artinet-project/artinet-sdk#readme",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "1.20.1",
-    "@trpc/server": "^11.4.3",
+    "@artinet/types": "^0.0.9-alpha.3",
     "cors": "^2.8.5",
     "escape-html": "^1.0.3",
     "eventsource-parser": "^3.0.1",
     "express": "^5.1.0",
-    "uuid": "^11.1.0",
-    "zod": "^3.23.8",
-    "@types/cors": "^2.8.17",
-    "@types/escape-html": "^1.0.4",
-    "@types/express": "^5.0.1"
+    "uuid": "^13.0.0",
+    "zod": "^3.25"
+  },
+  "peerDependencies": {
+    "@a2a-js/sdk": "^0.3.7",
+    "@modelcontextprotocol/sdk": "^1.24.3",
+    "@trpc/server": "^11.4.3",
+    "@opentelemetry/api": "^1.9.0"
+  },
+  "optionalDependencies": {
+    "pino": "^10.1.0",
+    "winston": "^3.19.0"
+  },
+  "peerDependenciesMeta": {
+    "@modelcontextprotocol/sdk": {
+      "optional": false
+    },
+    "@trpc/server": {
+      "optional": true
+    },
+    "@a2a-js/sdk": {
+      "optional": true
+    },
+    "@opentelemetry/api": {
+      "optional": false
+    },
+    "pino": {
+      "optional": true
+    },
+    "winston": {
+      "optional": true
+    }
   },
   "devDependencies": {
-    "@types/node": "^20.17.50",
+    "@cfworker/json-schema": "^4.1.1",
     "@eslint/js": "^9.25.1",
-    "@types/jest": "^29.5.14",
+    "@opentelemetry/api": "^1.9.0",
+    "@types/cors": "^2.8.17",
+    "@types/escape-html": "^1.0.4",
+    "@types/express": "^5.0.1",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.0.3",
     "@types/supertest": "latest",
     "eslint": "^9.25.1",
     "globals": "^16.0.0",
-    "jest": "^29.7.0",
+    "jest": "^30.2.0",
     "msw": "^2.7.5",
-    "rimraf": "^5.0.5",
+    "pino": "^10.1.0",
+    "pino-caller": "^4.0.0",
+    "pino-pretty": "^13.1.3",
+    "rimraf": "^6.1.2",
     "supertest": "latest",
     "ts-jest": "^29.3.2",
     "ts-node": "^10.9.1",
@@ -92,7 +154,8 @@
     "tsx": "^4.20.4",
     "typescript": "^5.2.2",
     "typescript-eslint": "^8.31.0",
-    "typescript-transform-paths": "^3.5.5"
+    "typescript-transform-paths": "^3.5.5",
+    "winston": "^3.19.0"
   },
   "engines": {
     "node": ">=18.9.1"

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

@@ -1,58 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * @fileoverview A2A Event Manager Factory
- *
- * This module provides factory functions for creating A2A-specific event managers
- * that handle the complete lifecycle of agent-to-agent communication tasks.
- * It integrates with the core event management system while providing A2A-specific
- * behavior for state management, task tracking, and error handling.
- *
- * @module A2AEventFactory
- * @version 0.5.7
- * @since 0.5.6
- * @author The Artinet Project
- */
-import { EventManager } from "../../core/managers/event.js";
-import { Command, State, Update, A2AServiceInterface, EventManagerOptions } from "../../../types/index.js";
-/**
- * Creates an A2A-specific event manager with integrated task and state management.
- *
- * This factory function creates an event manager tailored for A2A operations,
- * providing comprehensive lifecycle management for agent-to-agent communication
- * tasks. It handles state persistence, task tracking, error scenarios, and
- * cancellation while integrating with the broader A2A service framework.
- *
- * @template TCommand - The command type, must extend Command
- * @template TState - The state type, must extend State
- * @template TUpdate - The update type, must extend Update
- *
- * @param service - The A2A service instance for state and connection management
- * @param id - Optional context ID (generates UUID if not provided)
- * @param eventOverrides - Optional event handling overrides
- * @returns Configured EventManager instance for A2A operations
- *
- * @example
- * ```typescript
- * const eventManager = createEventManager(
- *   a2aService,
- *   'context-123',
- *   {
- *     onStart: async (context) => {
- *       console.log('A2A task starting');
- *       return await initializeA2AState(context);
- *     },
- *     onComplete: async (finalState) => {
- *       console.log('A2A task completed');
- *       await notifyCompletion(finalState);
- *     }
- *   }
- * );
- * ```
- *
- * @public
- * @since 0.5.6
- */
-export declare function createEventManager<TCommand extends Command = Command, TState extends State = State, TUpdate extends Update = Update>(service: A2AServiceInterface<TCommand, TState, TUpdate>, id?: string, eventOverrides?: EventManagerOptions<TCommand, TState, TUpdate>): EventManager<TCommand, TState, TUpdate>;

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

@@ -1,177 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * @fileoverview A2A Event Manager Factory
- *
- * This module provides factory functions for creating A2A-specific event managers
- * that handle the complete lifecycle of agent-to-agent communication tasks.
- * It integrates with the core event management system while providing A2A-specific
- * behavior for state management, task tracking, and error handling.
- *
- * @module A2AEventFactory
- * @version 0.5.7
- * @since 0.5.6
- * @author The Artinet Project
- */
-import { EventManager } from "../../core/managers/event.js";
-import { TaskState, } from "../../../types/index.js";
-import { INTERNAL_ERROR, INVALID_PARAMS, CANCEL_UPDATE, FAILED_UPDATE, logError, } from "../../../utils/index.js";
-import { loadState, processUpdate } from "../state/index.js";
-import { v4 as uuidv4 } from "uuid";
-/**
- * Creates an A2A-specific event manager with integrated task and state management.
- *
- * This factory function creates an event manager tailored for A2A operations,
- * providing comprehensive lifecycle management for agent-to-agent communication
- * tasks. It handles state persistence, task tracking, error scenarios, and
- * cancellation while integrating with the broader A2A service framework.
- *
- * @template TCommand - The command type, must extend Command
- * @template TState - The state type, must extend State
- * @template TUpdate - The update type, must extend Update
- *
- * @param service - The A2A service instance for state and connection management
- * @param id - Optional context ID (generates UUID if not provided)
- * @param eventOverrides - Optional event handling overrides
- * @returns Configured EventManager instance for A2A operations
- *
- * @example
- * ```typescript
- * const eventManager = createEventManager(
- *   a2aService,
- *   'context-123',
- *   {
- *     onStart: async (context) => {
- *       console.log('A2A task starting');
- *       return await initializeA2AState(context);
- *     },
- *     onComplete: async (finalState) => {
- *       console.log('A2A task completed');
- *       await notifyCompletion(finalState);
- *     }
- *   }
- * );
- * ```
- *
- * @public
- * @since 0.5.6
- */
-export function createEventManager(service, id, eventOverrides) {
-    const contextId = id ?? uuidv4();
-    /**
-     * Task store implementation that bridges between event management and A2A service state management.
-     *
-     * This store provides the interface needed by the legacy update processing logic
-     * while integrating with the A2A service's state management capabilities.
-     */
-    const taskStore = {
-        save: async (data) => {
-            if (!data.task?.id) {
-                throw INTERNAL_ERROR({
-                    data: {
-                        message: "Task ID is required",
-                    },
-                });
-            }
-            service.setState(data.task.id, data);
-        },
-        load: async (taskId) => {
-            return (await service.getState(taskId).catch(() => null)) ?? null;
-        },
-    };
-    // Configure A2A-specific event handling options
-    const options = {
-        onStart: async (context) => {
-            const request = context.command;
-            if (!request || (!request.message && !("message" in request))) {
-                throw INVALID_PARAMS("No request detected");
-            }
-            let currentContextId = contextId;
-            if (request.message.contextId) {
-                currentContextId = request.message.contextId;
-            }
-            service.addConnection(currentContextId);
-            const currentState = await loadState(taskStore, request.message, request.metadata, request.message.taskId, currentContextId);
-            return currentState;
-        },
-        onCancel: async (current, update) => {
-            const localContextId = update.contextId ?? contextId;
-            const localTaskId = update.taskId ?? update.id;
-            service.addCancellation(localContextId);
-            const cancellation = CANCEL_UPDATE(localTaskId, localContextId);
-            const cancelUpdate = {
-                ...update,
-                ...cancellation,
-                status: {
-                    ...update.status,
-                    ...cancellation.status,
-                    state: TaskState.canceled,
-                },
-                final: true,
-            };
-            await processUpdate(taskStore, {
-                context: {
-                    contextId: localContextId,
-                    task: current.task,
-                    userMessage: current.task?.status?.message ?? {},
-                    isCancelled: () => service.isCancelled(localContextId),
-                    history: [], //deprecating history
-                },
-                current: current,
-                update: cancelUpdate,
-            });
-        },
-        onUpdate: async (current, update) => {
-            if (service.isCancelled(contextId)) {
-                return current;
-            }
-            try {
-                const currentState = (await processUpdate(taskStore, {
-                    context: {
-                        contextId: contextId,
-                        task: current.task,
-                        userMessage: current.task?.status?.message ?? {},
-                        isCancelled: () => service.isCancelled(contextId),
-                        history: [], //deprecating history
-                    },
-                    current: current,
-                    update: update,
-                }));
-                return currentState;
-            }
-            catch (error) {
-                logError(`onUpdate[${contextId}]:`, "error detected", error, update);
-                throw error;
-            }
-        },
-        onError: async (current, error) => {
-            logError(`onError[${contextId}]`, "error detected", error, current);
-            if (!current ||
-                (!current.task?.contextId && !current?.contextId)) {
-                return;
-            }
-            const failedUpdate = FAILED_UPDATE(current.task?.id, current.task?.contextId ?? contextId, "failed-update", error instanceof Error ? error.message : String(error));
-            await processUpdate(taskStore, {
-                context: {
-                    contextId: current.task?.contextId ?? contextId,
-                    task: current.task,
-                    userMessage: current.task?.status?.message ?? {},
-                    isCancelled: () => service.isCancelled(contextId),
-                    history: [], //deprecating history
-                },
-                current: current,
-                update: failedUpdate,
-            });
-        },
-        onComplete: async () => {
-            service.removeCancellation(contextId);
-            service.removeConnection(contextId);
-        },
-    };
-    return new EventManager(contextId, {
-        ...options,
-        ...eventOverrides, // Override options take precedence over defaults
-    });
-}

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

@@ -1,6 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { MethodOptions } from "../../../types/index.js";
-export declare function createMethods(methods?: Partial<MethodOptions>): MethodOptions;

package/dist/services/a2a/managers/cancellation.d.ts

@@ -1,11 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { CancellationManagerInterface } from "../../../types/index.js";
-export declare class CancellationManager implements CancellationManagerInterface {
-    private cancellations;
-    addCancellation(id: string): void;
-    removeCancellation(id: string): void;
-    isCancelled(id: string): boolean;
-}

package/dist/services/a2a/managers/cancellation.js

@@ -1,16 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-export class CancellationManager {
-    cancellations = new Set();
-    addCancellation(id) {
-        this.cancellations.add(id);
-    }
-    removeCancellation(id) {
-        this.cancellations.delete(id);
-    }
-    isCancelled(id) {
-        return this.cancellations.has(id);
-    }
-}

package/dist/services/a2a/managers/connection.d.ts

@@ -1,11 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { ConnectionManagerInterface } from "../../../types/index.js";
-export declare class ConnectionManager implements ConnectionManagerInterface {
-    private connections;
-    addConnection(id: string): void;
-    removeConnection(id: string): void;
-    isConnected(id: string): boolean;
-}

package/dist/services/a2a/managers/connection.js

@@ -1,16 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-export class ConnectionManager {
-    connections = new Set();
-    addConnection(id) {
-        this.connections.add(id);
-    }
-    removeConnection(id) {
-        this.connections.delete(id);
-    }
-    isConnected(id) {
-        return this.connections.has(id);
-    }
-}