@artinet/sdk 0.2.0

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

@@ -0,0 +1,13 @@
+import express from "express";
+import http from "http";
+import { CreateExpressServerParams } from "../interfaces/params.js";
+/**
+ * Creates an Express server for the A2A protocol.
+ * Handles task creation, streaming, cancellation and more.
+ * Uses Jayson for JSON-RPC handling.
+ */
+export declare function createExpressServer(params: CreateExpressServerParams): {
+    app: express.Express;
+    server: http.Server;
+};
+//# sourceMappingURL=express-server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"express-server.d.ts","sourceRoot":"","sources":["../../../src/server/lib/express-server.ts"],"names":[],"mappings":"AACA,OAAO,OAA4C,MAAM,SAAS,CAAC;AAEnE,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEpE;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,yBAAyB,GAAG;IACtE,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC;IACrB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;CACrB,CA4DA"}

package/dist/server/lib/express-server.js

@@ -0,0 +1,51 @@
+import cors from "cors";
+import express from "express";
+import { logInfo } from "../../utils/logging/log.js";
+/**
+ * Creates an Express server for the A2A protocol.
+ * Handles task creation, streaming, cancellation and more.
+ * Uses Jayson for JSON-RPC handling.
+ */
+export function createExpressServer(params) {
+    const { card, corsOptions, basePath, port, rpcServer, errorHandler, onTaskSendSubscribe, onTaskResubscribe, } = params;
+    const app = express();
+    app.use(cors(corsOptions));
+    app.use(express.json());
+    app.get("/.well-known/agent.json", (_, res) => {
+        res.json(card);
+    });
+    app.get("/agent-card", (_, res) => {
+        res.json(card);
+    });
+    //SSE Paths
+    app.post(basePath, async (req, res, next) => {
+        try {
+            const body = req.body;
+            if (body && body.method) {
+                if (body.method === "tasks/sendSubscribe") {
+                    return await onTaskSendSubscribe(body, res);
+                }
+                else if (body.method === "tasks/resubscribe") {
+                    return await onTaskResubscribe(body, res);
+                }
+            }
+            next();
+        }
+        catch (error) {
+            next(error);
+        }
+    });
+    //RPC server
+    app.post(basePath, rpcServer.middleware());
+    // Fallback error handler
+    app.use(errorHandler);
+    // Start listening
+    const server = app.listen(port, () => {
+        logInfo("A2AServer", `A2A Server started and listening`, {
+            port,
+            path: basePath,
+        });
+    });
+    return { app, server };
+}
+//# sourceMappingURL=express-server.js.map

package/dist/server/lib/express-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express-server.js","sourceRoot":"","sources":["../../../src/server/lib/express-server.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,OAA4C,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAIrD;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAiC;IAInE,MAAM,EACJ,IAAI,EACJ,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,SAAS,EACT,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,GAClB,GAAG,MAAM,CAAC;IACX,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IAEtB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAE3B,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAExB,GAAG,CAAC,GAAG,CAAC,yBAAyB,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;QAC5C,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;QAChC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,WAAW;IACX,GAAG,CAAC,IAAI,CACN,QAAQ,EACR,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE;QACxD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;YACtB,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBACxB,IAAI,IAAI,CAAC,MAAM,KAAK,qBAAqB,EAAE,CAAC;oBAC1C,OAAO,MAAM,mBAAmB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC9C,CAAC;qBAAM,IAAI,IAAI,CAAC,MAAM,KAAK,mBAAmB,EAAE,CAAC;oBAC/C,OAAO,MAAM,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;YACD,IAAI,EAAE,CAAC;QACT,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,CAAC;QACd,CAAC;IACH,CAAC,CACF,CAAC;IAEF,YAAY;IACZ,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC;IAE3C,yBAAyB;IACzB,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAEtB,kBAAkB;IAClB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QACnC,OAAO,CAAC,WAAW,EAAE,kCAAkC,EAAE;YACvD,IAAI;YACJ,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;AACzB,CAAC"}

package/dist/server/lib/json-middleware.d.ts

@@ -0,0 +1,19 @@
+import { CreateJSONRPCServerParams, JSONRPCServerType } from "../interfaces/params.js";
+/**
+ * Default implementation of createJSONRPCServer
+ * This implementation is used by the Artinet API server
+ * It provides a basic JSON-RPC server with methods for task creation, retrieval, and cancellation
+ * Creates and initializes a Jayson server with A2A methods
+ * @param params Object containing all required parameters for server initialization
+ * @returns A configured Jayson server instance
+ */
+/**
+ * Default implementation of createJSONRPCServer
+ * This implementation is used by the Artinet API server
+ * It provides a basic JSON-RPC server with methods for task creation, retrieval, and cancellation
+ * Creates and initializes a Jayson server with A2A methods
+ * @param params Object containing all required parameters for server initialization
+ * @returns A configured Jayson server instance
+ */
+export declare function defaultCreateJSONRPCServer(params: CreateJSONRPCServerParams): JSONRPCServerType;
+//# sourceMappingURL=json-middleware.d.ts.map

package/dist/server/lib/json-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-middleware.d.ts","sourceRoot":"","sources":["../../../src/server/lib/json-middleware.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,yBAAyB,EAEzB,iBAAiB,EAElB,MAAM,yBAAyB,CAAC;AAWjC;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,yBAAyB,GAChC,iBAAiB,CAkNnB"}

package/dist/server/lib/json-middleware.js

@@ -0,0 +1,180 @@
+import { getCurrentTimestamp } from "../../utils/common/utils.js";
+import { logError, logWarn } from "../../utils/logging/log.js";
+import { loadState, updateState } from "../lib/state.js";
+import { INTERNAL_ERROR, INVALID_PARAMS, METHOD_NOT_FOUND, PUSH_NOTIFICATION_NOT_SUPPORTED, TASK_NOT_CANCELABLE, TASK_NOT_FOUND, FAILED_UPDATE, } from "../../utils/common/errors.js";
+import { JSONRPCServer, } from "../interfaces/params.js";
+function toJaysonError(error) {
+    return {
+        code: error.code,
+        message: error.message,
+        data: error.data,
+    };
+}
+/**
+ * Default implementation of createJSONRPCServer
+ * This implementation is used by the Artinet API server
+ * It provides a basic JSON-RPC server with methods for task creation, retrieval, and cancellation
+ * Creates and initializes a Jayson server with A2A methods
+ * @param params Object containing all required parameters for server initialization
+ * @returns A configured Jayson server instance
+ */
+/**
+ * Default implementation of createJSONRPCServer
+ * This implementation is used by the Artinet API server
+ * It provides a basic JSON-RPC server with methods for task creation, retrieval, and cancellation
+ * Creates and initializes a Jayson server with A2A methods
+ * @param params Object containing all required parameters for server initialization
+ * @returns A configured Jayson server instance
+ */
+export function defaultCreateJSONRPCServer(params) {
+    const { taskStore, card, taskHandler, activeCancellations, createTaskContext, closeStreamsForTask, } = params;
+    return new JSONRPCServer({
+        "tasks/send": async (params, callback) => {
+            try {
+                // Validate params
+                if (!params || !params.id || !params.message) {
+                    return callback(toJaysonError(INVALID_PARAMS()));
+                }
+                const { id: taskId, message, sessionId, metadata } = params;
+                // Load or create task
+                let currentData = await loadState(taskStore, taskId, message, sessionId, metadata);
+                // Create task context
+                const context = createTaskContext(currentData.task, message, currentData.history);
+                const generator = taskHandler(context);
+                try {
+                    for await (const update of generator) {
+                        currentData = await updateState(taskStore, currentData, update);
+                    }
+                    return callback(null, currentData.task);
+                }
+                catch (error) {
+                    const failedUpdate = FAILED_UPDATE(`Task processing failed: ${error instanceof Error ? error.message : String(error)}`);
+                    currentData = await updateState(taskStore, currentData, failedUpdate);
+                    return callback(toJaysonError(INTERNAL_ERROR(error)));
+                }
+            }
+            catch (error) {
+                logError("tasks/send", "Error in tasks/send", error);
+                return callback(toJaysonError(INTERNAL_ERROR(error)));
+            }
+        },
+        "tasks/get": async (params, callback) => {
+            try {
+                const { id: taskId } = params;
+                if (!taskId) {
+                    return callback(toJaysonError(INVALID_PARAMS()));
+                }
+                // Load the task
+                const data = await taskStore.load(taskId);
+                if (!data) {
+                    return callback(toJaysonError(TASK_NOT_FOUND()));
+                }
+                return callback(null, data.task);
+            }
+            catch (error) {
+                logError("tasks/get", "Error in tasks/get", error);
+                return callback(toJaysonError(INTERNAL_ERROR(error)));
+            }
+        },
+        "tasks/cancel": async (params, callback) => {
+            try {
+                const { id: taskId } = params;
+                if (!taskId) {
+                    return callback(toJaysonError(INVALID_PARAMS()));
+                }
+                // Load the task
+                const data = await taskStore.load(taskId);
+                if (!data) {
+                    return callback(toJaysonError(TASK_NOT_FOUND()));
+                }
+                // Check if task is already in a final state
+                const finalStates = ["completed", "failed", "canceled"];
+                if (finalStates.includes(data.task.status.state)) {
+                    return callback(toJaysonError(TASK_NOT_CANCELABLE()));
+                }
+                // Mark as cancelled
+                activeCancellations.add(taskId);
+                // Create updated task with canceled status
+                const canceledTask = {
+                    ...data.task,
+                    status: {
+                        state: "canceled",
+                        timestamp: getCurrentTimestamp(),
+                        message: {
+                            role: "agent",
+                            parts: [{ type: "text", text: "Task was canceled." }],
+                        },
+                    },
+                };
+                const updatedData = {
+                    task: canceledTask,
+                    history: data.history,
+                };
+                await taskStore.save(updatedData);
+                closeStreamsForTask(taskId);
+                return callback(null, canceledTask);
+            }
+            catch (error) {
+                logError("tasks/cancel", "Error in tasks/cancel", error);
+                callback(toJaysonError(INTERNAL_ERROR(error)));
+            }
+        },
+        "tasks/pushNotification/set": async (params, callback) => {
+            try {
+                logWarn("tasks/pushNotification/set", "Push notifications are not fully implemented.");
+                if (!card.capabilities?.pushNotifications) {
+                    return callback(toJaysonError(METHOD_NOT_FOUND()));
+                }
+                const config = params;
+                // Basic validation
+                if (!config.id) {
+                    return callback(toJaysonError(INVALID_PARAMS()));
+                }
+                if (!config.pushNotificationConfig?.url) {
+                    return callback(toJaysonError(INVALID_PARAMS()));
+                }
+                // Verify the task exists
+                const data = await taskStore.load(config.id);
+                if (!data) {
+                    return callback(toJaysonError(TASK_NOT_FOUND()));
+                }
+                // In a real implementation, we'd store this config
+                // For now, we'll just return it
+                return callback(null, config);
+            }
+            catch (error) {
+                logError("tasks/pushNotification/set", "Error in tasks/pushNotification/set", error);
+                return callback(toJaysonError(INTERNAL_ERROR(error)));
+            }
+        },
+        "tasks/pushNotification/get": async (params, callback) => {
+            try {
+                logWarn("tasks/pushNotification/get", "Push notifications are not fully implemented.");
+                if (!card.capabilities?.pushNotifications) {
+                    return callback(toJaysonError(PUSH_NOTIFICATION_NOT_SUPPORTED()));
+                }
+                const { id: taskId } = params;
+                if (!taskId) {
+                    return callback(toJaysonError(INVALID_PARAMS()));
+                }
+                // Verify the task exists
+                const data = await taskStore.load(taskId);
+                if (!data) {
+                    return callback(toJaysonError(TASK_NOT_FOUND()));
+                }
+                // In a real implementation, we'd retrieve a stored config
+                // For now, return null (no push notification config)
+                return callback(null, null);
+            }
+            catch (error) {
+                logError("tasks/pushNotification/get", "Error in tasks/pushNotification/get", error);
+                return callback(toJaysonError(INTERNAL_ERROR(error)));
+            }
+        },
+    }, {
+        //server options
+        reviver: undefined,
+        replacer: undefined,
+    });
+}
+//# sourceMappingURL=json-middleware.js.map

package/dist/server/lib/json-middleware.js.map

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

package/dist/server/lib/state.d.ts

@@ -0,0 +1,28 @@
+import { Task, TaskStatus, Artifact, Message, TaskYieldUpdate } from "../../types/extended-schema.js";
+import { TaskAndHistory } from "../interfaces/store.js";
+import { TaskStore } from "../interfaces/store.js";
+export declare function updateTaskStatus(task: Task, update: TaskYieldUpdate): TaskStatus;
+export declare function checkBounds(index: number, length: number): boolean;
+export declare function updateByIndex(artifacts: Artifact[], index: number, update: Artifact): {
+    artifacts: Artifact[];
+    replaced: boolean;
+};
+export declare function updateByName(artifacts: Artifact[], update: Artifact): {
+    artifacts: Artifact[];
+    replaced: boolean;
+};
+export declare function processArtifactUpdate(artifacts: Artifact[], update: Artifact): {
+    artifacts: Artifact[];
+    replaced: boolean;
+};
+export declare function updateState(taskStore: TaskStore, current: TaskAndHistory, update: TaskYieldUpdate): Promise<TaskAndHistory>;
+/**
+ * Loads or creates a task and its history.
+ * @param taskId The task ID
+ * @param message The message to process
+ * @param sessionId Optional session ID
+ * @param metadata Optional metadata
+ * @returns The task and history
+ */
+export declare function loadState(taskStore: TaskStore, taskId: string, message: Message, sessionId?: string, metadata?: Record<string, unknown> | null): Promise<TaskAndHistory>;
+//# sourceMappingURL=state.d.ts.map

package/dist/server/lib/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/server/lib/state.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,OAAO,EACP,eAAe,EAChB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,eAAe,GACtB,UAAU,CAEZ;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAElE;AAED,wBAAgB,aAAa,CAC3B,SAAS,EAAE,QAAQ,EAAE,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,QAAQ,GACf;IAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CA6B9C;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,QAAQ,EAAE,EACrB,MAAM,EAAE,QAAQ,GACf;IAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAO9C;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,QAAQ,EAAE,EACrB,MAAM,EAAE,QAAQ,GACf;IAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAqB9C;AAED,wBAAsB,WAAW,CAC/B,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,cAAc,CAAC,CAyBzB;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAC7B,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACxC,OAAO,CAAC,cAAc,CAAC,CAiBzB"}

package/dist/server/lib/state.js

@@ -0,0 +1,108 @@
+import { getCurrentTimestamp, isArtifactUpdate, isTaskStatusUpdate, } from "../../utils/common/utils.js";
+import { INVALID_REQUEST } from "../../utils/common/errors.js";
+export function updateTaskStatus(task, update) {
+    return { ...task.status, ...update, timestamp: getCurrentTimestamp() };
+}
+export function checkBounds(index, length) {
+    return index >= 0 && index < length;
+}
+export function updateByIndex(artifacts, index, update) {
+    const existingArtifact = artifacts[index];
+    if (update.append) {
+        //deep copy to avoid mutating original
+        const appendedArtifact = JSON.parse(JSON.stringify(existingArtifact));
+        appendedArtifact.parts.push(...update.parts);
+        if (update.metadata) {
+            appendedArtifact.metadata = {
+                ...(appendedArtifact.metadata || {}),
+                ...update.metadata,
+            };
+        }
+        if (update.lastChunk !== undefined) {
+            appendedArtifact.lastChunk = update.lastChunk;
+        }
+        if (update.description) {
+            appendedArtifact.description = update.description;
+        }
+        artifacts[index] = appendedArtifact;
+    }
+    else {
+        artifacts[index] = { ...update };
+    }
+    return { artifacts, replaced: true };
+}
+export function updateByName(artifacts, update) {
+    const namedIndex = artifacts.findIndex((a) => a.name === update.name);
+    if (namedIndex >= 0) {
+        artifacts[namedIndex] = { ...update };
+        return { artifacts, replaced: true };
+    }
+    return { artifacts: artifacts, replaced: false };
+}
+export function processArtifactUpdate(artifacts, update) {
+    const existingIndex = update.index ?? -1;
+    let replaced = false;
+    let newArtifacts = artifacts;
+    if (checkBounds(existingIndex, artifacts.length)) {
+        ({ artifacts: newArtifacts, replaced } = updateByIndex(artifacts, existingIndex, update));
+    }
+    else if (update.name) {
+        ({ artifacts: newArtifacts, replaced } = updateByName(artifacts, update));
+    }
+    if (!replaced) {
+        newArtifacts.push({ ...update });
+        if (newArtifacts.some((a) => a.index !== undefined)) {
+            newArtifacts.sort((a, b) => (a.index ?? 0) - (b.index ?? 0));
+        }
+        replaced = true;
+    }
+    return { artifacts: newArtifacts, replaced };
+}
+export async function updateState(taskStore, current, update) {
+    const newTask = { ...current.task };
+    const newHistory = [...current.history];
+    if (isTaskStatusUpdate(update)) {
+        newTask.status = updateTaskStatus(newTask, update);
+        if (update.message?.role === "agent") {
+            newHistory.push(update.message);
+        }
+    }
+    else if (isArtifactUpdate(update)) {
+        const artifacts = !newTask.artifacts ? [] : [...newTask.artifacts];
+        const { artifacts: newArtifacts, replaced } = processArtifactUpdate(artifacts, update);
+        if (!replaced) {
+            throw INVALID_REQUEST();
+        }
+        newTask.artifacts = newArtifacts;
+    }
+    const currentData = { task: newTask, history: newHistory };
+    await taskStore.save(currentData);
+    return currentData;
+}
+/**
+ * Loads or creates a task and its history.
+ * @param taskId The task ID
+ * @param message The message to process
+ * @param sessionId Optional session ID
+ * @param metadata Optional metadata
+ * @returns The task and history
+ */
+export async function loadState(taskStore, taskId, message, sessionId, metadata) {
+    const existingData = await taskStore.load(taskId);
+    if (existingData) {
+        return existingData;
+    }
+    const timestamp = getCurrentTimestamp();
+    const newTask = {
+        id: taskId,
+        sessionId: sessionId || null,
+        status: {
+            state: "submitted",
+            timestamp,
+        },
+        metadata: metadata || null,
+    };
+    const newHistory = [message];
+    return { task: newTask, history: newHistory };
+}
+//# sourceMappingURL=state.js.map

package/dist/server/lib/state.js.map

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

package/dist/server/lib/storage/file.d.ts

@@ -0,0 +1,62 @@
+import { TaskAndHistory, TaskStore } from "../../interfaces/store.js";
+/**
+ * File-based implementation of the TaskStore interface.
+ * Stores tasks and their history as JSON files on disk.
+ */
+export declare class FileStore implements TaskStore {
+    private baseDir;
+    /**
+     * Creates a new FileStore.
+     * @param baseDir The base directory to store task files in.
+     */
+    constructor(baseDir: string);
+    /**
+     * Constructs the file path for a task.
+     * @param taskId The task ID
+     * @returns The full file path for the task JSON file
+     */
+    private getTaskFilePath;
+    /**
+     * Constructs the file path for a task's history.
+     * @param taskId The task ID
+     * @returns The full file path for the history JSON file
+     */
+    private getHistoryFilePath;
+    /**
+     * Ensures the base directory exists.
+     * @returns A promise that resolves when the directory exists.
+     */
+    private ensureBaseDir;
+    /**
+     * Writes data to a JSON file.
+     * @param filePath The path to write to
+     * @param data The data to write
+     * @returns A promise that resolves when the write is complete
+     */
+    private writeJsonFile;
+    /**
+     * Reads data from a JSON file.
+     * @param filePath The path to read from
+     * @returns A promise resolving to the parsed data, or null if the file doesn't exist
+     */
+    private readJsonFile;
+    /**
+     * 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
+     */
+    private isHistoryFileContent;
+    /**
+     * 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.
+     */
+    load(taskId: string): Promise<TaskAndHistory | null>;
+    /**
+     * Saves a task and its history.
+     * @param data The task and history to save.
+     * @returns A promise that resolves when the save is complete.
+     */
+    save(data: TaskAndHistory): Promise<void>;
+}
+//# sourceMappingURL=file.d.ts.map

package/dist/server/lib/storage/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../../src/server/lib/storage/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAMtE;;;GAGG;AACH,qBAAa,SAAU,YAAW,SAAS;IACzC,OAAO,CAAC,OAAO,CAAS;IAExB;;;OAGG;gBACS,OAAO,EAAE,MAAM;IAI3B;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;;OAGG;YACW,aAAa;IAa3B;;;;;OAKG;YACW,aAAa;IAY3B;;;;OAIG;YACW,YAAY;IAc1B;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;;;OAIG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA4C1D;;;;OAIG;IACG,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBhD"}

package/dist/server/lib/storage/file.js

@@ -0,0 +1,148 @@
+import { logError, logDebug } from "../../../utils/logging/log.js";
+import fs from "fs/promises";
+import path from "path";
+/**
+ * File-based implementation of the TaskStore interface.
+ * Stores tasks and their history as JSON files on disk.
+ */
+export class FileStore {
+    /**
+     * Creates a new FileStore.
+     * @param baseDir The base directory to store task files in.
+     */
+    constructor(baseDir) {
+        this.baseDir = baseDir;
+    }
+    /**
+     * Constructs the file path for a task.
+     * @param taskId The task ID
+     * @returns The full file path for the task JSON file
+     */
+    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.
+     */
+    async ensureBaseDir() {
+        try {
+            await fs.mkdir(this.baseDir, { recursive: true });
+        }
+        catch (error) {
+            logError("FileStore", `Failed to create directory: ${this.baseDir}`, error);
+            throw error;
+        }
+    }
+    /**
+     * Writes data to a JSON file.
+     * @param filePath The path to write to
+     * @param data The data to write
+     * @returns A promise that resolves when the write is complete
+     */
+    async writeJsonFile(filePath, data) {
+        try {
+            await this.ensureBaseDir();
+            await fs.writeFile(filePath, JSON.stringify(data, null, 2), {
+                encoding: "utf8",
+            });
+        }
+        catch (error) {
+            logError("FileStore", `Failed to write file: ${filePath}`, error);
+            throw error;
+        }
+    }
+    /**
+     * Reads data from a JSON file.
+     * @param filePath The path to read from
+     * @returns A promise resolving to the parsed data, or null if the file doesn't exist
+     */
+    async readJsonFile(filePath) {
+        try {
+            const content = await fs.readFile(filePath, { encoding: "utf8" });
+            return JSON.parse(content);
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                // File not found - return null rather than throwing
+                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 (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 load(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);
+        if (!task) {
+            return null; // Task not found
+        }
+        // Task exists, now try to read history. It might not exist yet.
+        let history = [];
+        try {
+            const historyContent = await this.readJsonFile(historyFilePath);
+            // 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 };
+    }
+    /**
+     * 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 save(data) {
+        logDebug("FileStore", `Saving task: ${data.task.id}`);
+        const taskFilePath = this.getTaskFilePath(data.task.id);
+        const historyFilePath = this.getHistoryFilePath(data.task.id);
+        // 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,
+        });
+    }
+}
+//# sourceMappingURL=file.js.map