@artinet/sdk 0.2.0

package/dist/server/a2a-server.js

@@ -0,0 +1,384 @@
+import util from "util";
+import { getCurrentTimestamp, validateTaskSendParams, INVALID_PARAMS, TASK_NOT_FOUND, INVALID_REQUEST, errorHandler, CANCEL_UPDATE, FINAL_STATES, WORKING_UPDATE, logDebug, } from "../utils/index.js";
+import { sendSSEEvent, setupSseStream, processTaskStream, } from "../transport/index.js";
+import { defaultCreateJSONRPCServer } from "./lib/json-middleware.js";
+import { createExpressServer } from "./lib/express-server.js";
+import { updateState, loadState } from "./lib/state.js";
+import { InMemoryTaskStore } from "./lib/storage/memory.js";
+/**
+ * Implements an A2A protocol compliant server using Express.
+ * Handles task creation, streaming, cancellation and more.
+ * Uses Jayson for JSON-RPC handling.
+ */
+export class A2AServer {
+    /**
+     * Returns the base path for the server
+     */
+    getBasePath() {
+        return this.basePath;
+    }
+    /**
+     * Returns the CORS options for the server
+     */
+    getCorsOptions() {
+        return this.corsOptions;
+    }
+    /**
+     * Returns the agent card for the server
+     */
+    getCard() {
+        return this.card;
+    }
+    /**
+     * Returns the task store
+     */
+    getTaskStore() {
+        return this.taskStore;
+    }
+    /**
+     * Returns the task handler
+     */
+    getTaskHandler() {
+        return this.taskHandler;
+    }
+    /**
+     * Returns the set of active cancellations
+     */
+    getActiveCancellations() {
+        return this.activeCancellations;
+    }
+    /**
+     * Returns the map of active streams
+     */
+    getActiveStreams() {
+        return this.activeStreams;
+    }
+    /**
+     * Returns the port number
+     */
+    getPort() {
+        return this.port;
+    }
+    /**
+     * Returns the JSON-RPC server
+     */
+    getRpcServer() {
+        return this.rpcServer;
+    }
+    /**
+     * Returns the server instance
+     */
+    getServerInstance() {
+        return this.serverInstance;
+    }
+    /**
+     * Returns a task context for the specified task and messages
+     */
+    getTaskContext(task, userMessage, history) {
+        return this.createTaskContext(task, userMessage, history);
+    }
+    /**
+     * Returns the default agent card
+     */
+    defaultAgentCard() {
+        return A2AServer.defaultAgentCard();
+    }
+    /**
+     * Creates a new A2AServer.
+     * @param handler The task handler function that will process tasks
+     * @param options Options for configuring the server
+     */
+    constructor(params) {
+        // Track active cancellations
+        this.activeCancellations = new Set();
+        this.activeStreams = new Map();
+        // Store the handler
+        this.taskHandler = params.handler;
+        // Set up store
+        this.taskStore = params.taskStore ?? new InMemoryTaskStore();
+        // Configure CORS
+        this.corsOptions = params.corsOptions ?? {
+            origin: "*",
+            methods: ["GET", "POST"],
+            allowedHeaders: ["Content-Type"],
+        };
+        // Set port
+        this.port = params.port ?? 41241;
+        let basePath = params.basePath ?? "/";
+        if (basePath !== "/") {
+            basePath = `/${basePath.replace(/^\/|\/$/g, "")}/`;
+        }
+        this.basePath = basePath;
+        // Set up default agent card if not provided
+        this.card = params.card ?? A2AServer.defaultAgentCard();
+        // Initialize the Jayson server
+        this.rpcServer = params.createJSONRPCServer
+            ? params.createJSONRPCServer({
+                taskStore: this.taskStore,
+                card: this.card,
+                taskHandler: this.taskHandler,
+                activeCancellations: this.activeCancellations,
+                createTaskContext: this.createTaskContext.bind(this),
+                closeStreamsForTask: this.closeStreamsForTask.bind(this),
+            })
+            : defaultCreateJSONRPCServer({
+                taskStore: this.taskStore,
+                card: this.card,
+                taskHandler: this.taskHandler,
+                activeCancellations: this.activeCancellations,
+                createTaskContext: this.createTaskContext.bind(this),
+                closeStreamsForTask: this.closeStreamsForTask.bind(this),
+            });
+        logDebug("A2AServer", "Server initialized", {
+            basePath: this.basePath,
+            port: this.port,
+            corsEnabled: !!this.corsOptions,
+        });
+    }
+    /**
+     * Starts the Express server listening on the specified port.
+     * @returns The running Express application instance.
+     */
+    start() {
+        if (this.serverInstance) {
+            throw new Error("Server already started");
+        }
+        const { app, server } = createExpressServer({
+            card: this.card,
+            corsOptions: this.corsOptions,
+            basePath: this.basePath,
+            port: this.port,
+            rpcServer: this.rpcServer,
+            errorHandler: errorHandler,
+            onTaskSendSubscribe: this.handleTaskSendSubscribe.bind(this),
+            onTaskResubscribe: this.handleTaskResubscribe.bind(this),
+        });
+        this.serverInstance = server;
+        return app;
+    }
+    /**
+     * Stops the server and closes all connections.
+     * @returns A promise that resolves when the server is stopped.
+     */
+    async stop() {
+        if (!this.serverInstance) {
+            return;
+        }
+        // Close all active streams first
+        this.activeStreams.forEach((streams, taskId) => {
+            if (streams.length > 0) {
+                logDebug("A2AServer", "Closing streams for task during stop", {
+                    taskId,
+                });
+                this.closeStreamsForTask(taskId);
+            }
+        });
+        this.activeStreams.clear();
+        const closeServer = util
+            .promisify(this.serverInstance.close)
+            .bind(this.serverInstance);
+        try {
+            await closeServer();
+            logDebug("A2AServer", "Server stopped successfully.");
+            this.serverInstance = undefined;
+        }
+        catch (err) {
+            logDebug("A2AServer", "Error stopping server:", err);
+            this.serverInstance = undefined;
+            throw err;
+        }
+    }
+    /**
+     * Handles task cancellation
+     * @param data Task and history data
+     * @param res Response object
+     */
+    async onCancel(data, res) {
+        const currentData = await updateState(this.taskStore, data, CANCEL_UPDATE);
+        // Send the canceled status
+        sendSSEEvent(res, {
+            id: currentData.task.id,
+            status: currentData.task.status,
+            final: true,
+        });
+        this.closeStreamsForTask(currentData.task.id);
+    }
+    /**
+     * Handles cleanup when a task stream ends
+     * @param taskId The task ID
+     * @param res Response object
+     */
+    async onEnd(taskId, res) {
+        this.activeCancellations.delete(taskId);
+        this.removeStreamForTask(taskId, res);
+    }
+    /**
+     * Handles the tasks/sendSubscribe method.
+     * @param req The SendTaskRequest object
+     * @param res The Express Response object
+     */
+    async handleTaskSendSubscribe(req, res) {
+        validateTaskSendParams(req.params);
+        const { id: taskId, message, sessionId, metadata } = req.params;
+        // Set up SSE stream with initial status
+        setupSseStream(res, taskId, {
+            id: taskId,
+            status: {
+                state: "submitted",
+                timestamp: getCurrentTimestamp(),
+                message: null,
+            },
+        }, this.addStreamForTask.bind(this));
+        // Load or create task
+        let currentData = await loadState(this.taskStore, taskId, message, sessionId, metadata);
+        // Create task context
+        const context = this.createTaskContext(currentData.task, message, currentData.history);
+        currentData = await updateState(this.taskStore, currentData, WORKING_UPDATE);
+        // Send the working status
+        sendSSEEvent(res, {
+            id: taskId,
+            status: currentData.task.status,
+            final: false,
+        });
+        // Process the task using the shared method
+        await processTaskStream(this.taskStore, this.taskHandler, res, taskId, context, currentData, this.onCancel.bind(this), this.onEnd.bind(this));
+    }
+    /**
+     * Handles the tasks/resubscribe method.
+     * @param req The TaskResubscriptionRequest object
+     * @param res The Express Response object
+     */
+    async handleTaskResubscribe(req, res) {
+        const { id: taskId } = req.params;
+        if (!taskId) {
+            console.error("Task ID is required", req);
+            throw INVALID_PARAMS();
+        }
+        // Try to load the task
+        const data = await this.taskStore.load(taskId);
+        if (!data) {
+            throw TASK_NOT_FOUND();
+        }
+        // Set up SSE stream with current task status
+        setupSseStream(res, taskId, {
+            id: taskId,
+            status: data.task.status,
+            final: false,
+        }, this.addStreamForTask.bind(this));
+        // Check if task is in final state
+        if (FINAL_STATES.includes(data.task.status.state)) {
+            // If the task is already complete, send all artifacts and close
+            if (data.task.artifacts && data.task.artifacts.length > 0) {
+                for (const artifact of data.task.artifacts) {
+                    sendSSEEvent(res, {
+                        id: taskId,
+                        artifact,
+                        final: true,
+                    });
+                }
+            }
+            // Remove from tracking and close
+            this.removeStreamForTask(taskId, res);
+            res.write("event: close\ndata: {}\n\n");
+            res.end();
+            return;
+        }
+        // For non-final states, create context and continue processing
+        // We need to use the last user message as the current message
+        const lastUserMessage = data.history
+            .filter((msg) => msg.role === "user")
+            .pop();
+        if (!lastUserMessage) {
+            throw INVALID_REQUEST();
+        }
+        const context = this.createTaskContext(data.task, lastUserMessage, data.history);
+        // Continue processing the task using the shared method
+        await processTaskStream(this.taskStore, this.taskHandler, res, taskId, context, data, this.onCancel.bind(this), this.onEnd.bind(this));
+    }
+    /**
+     * Adds a response stream to the tracking map for a task.
+     * @param taskId The task ID
+     * @param res The response stream
+     */
+    addStreamForTask(taskId, res) {
+        if (!this.activeStreams.has(taskId)) {
+            this.activeStreams.set(taskId, []);
+        }
+        logDebug("A2AServer", "Adding stream for task", {
+            taskId,
+            activeStreams: this.activeStreams,
+        });
+        this.activeStreams.get(taskId)?.push(res);
+    }
+    /**
+     * Removes a response stream from the tracking map for a task.
+     * @param taskId The task ID
+     * @param res The response stream
+     */
+    removeStreamForTask(taskId, res) {
+        const streams = this.activeStreams.get(taskId);
+        if (streams) {
+            const index = streams.indexOf(res);
+            if (index !== -1) {
+                streams.splice(index, 1);
+                if (streams.length === 0) {
+                    logDebug("A2AServer", "Removing stream for task", {
+                        taskId,
+                        activeStreams: this.activeStreams,
+                    });
+                    this.activeStreams.delete(taskId);
+                }
+            }
+        }
+    }
+    /**
+     * Initializes the default agent card
+     */
+    static defaultAgentCard() {
+        return {
+            name: "A2A Server",
+            description: "A general-purpose A2A protocol server",
+            version: "0.1.0",
+            url: "http://localhost",
+            capabilities: {
+                streaming: true,
+                pushNotifications: false,
+                stateTransitionHistory: true,
+            },
+            skills: [],
+        };
+    }
+    /**
+     * Creates a TaskContext object for a task handler.
+     * @param task The task
+     * @param userMessage The user message
+     * @param history The message history
+     * @returns A TaskContext object
+     */
+    createTaskContext(task, userMessage, history) {
+        return {
+            task,
+            userMessage,
+            history,
+            isCancelled: () => this.activeCancellations.has(task.id),
+        };
+    }
+    /**
+     * Closes any active streams for a task.
+     * @param taskId The task ID
+     */
+    closeStreamsForTask(taskId) {
+        const streams = this.activeStreams.get(taskId);
+        if (streams) {
+            // Send close event to all streams
+            for (const stream of streams) {
+                if (stream.writable) {
+                    stream.write("event: close\ndata: {}\n\n");
+                    stream.end();
+                }
+            }
+            this.activeStreams.delete(taskId);
+        }
+    }
+}
+//# sourceMappingURL=a2a-server.js.map

package/dist/server/a2a-server.js.map

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

package/dist/server/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./a2a-server.js";
+export * from "./interfaces/params.js";
+export * from "./interfaces/context.js";
+export * from "./interfaces/store.js";
+export * from "./lib/json-middleware.js";
+export * from "./lib/express-server.js";
+export * from "./lib/storage/file.js";
+export * from "./lib/storage/memory.js";
+//# sourceMappingURL=index.d.ts.map

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,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,9 @@
+export * from "./a2a-server.js";
+export * from "./interfaces/params.js";
+export * from "./interfaces/context.js";
+export * from "./interfaces/store.js";
+export * from "./lib/json-middleware.js";
+export * from "./lib/express-server.js";
+export * from "./lib/storage/file.js";
+export * from "./lib/storage/memory.js";
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}

package/dist/server/interfaces/context.d.ts

@@ -0,0 +1,41 @@
+import type { Task, Message, TaskYieldUpdate } from "../../types/extended-schema.js";
+/**
+ * Context object provided to the TaskHandler.
+ * Contains the information needed for the handler to process the task.
+ */
+export interface TaskContext {
+    /**
+     * The current state of the task when the handler is invoked or resumed.
+     * This is a snapshot - the latest state may need to be reloaded during async operations.
+     */
+    task: Task;
+    /**
+     * The specific user message that triggered this handler invocation or resumption.
+     */
+    userMessage: Message;
+    /**
+     * Function to check if cancellation has been requested for this task.
+     * Handlers should check this periodically during long-running operations.
+     * @returns True if cancellation has been requested, false otherwise.
+     */
+    isCancelled(): boolean;
+    /**
+     * The message history associated with the task up to the point the handler is invoked.
+     */
+    history: Message[];
+}
+/**
+ * Defines the signature for a task handler function.
+ *
+ * Handlers are implemented as async generators. They receive context about the
+ * task and the triggering message. They perform work and yield status
+ * or artifact updates (TaskYieldUpdate). The server consumes these yields,
+ * updates the task state in the store, and streams events if applicable.
+ *
+ * @param context The TaskContext object containing task details and state.
+ * @yields Updates to the task's status or artifacts.
+ * @returns Optionally returns the final complete Task object (needed for non-streaming 'tasks/send').
+ *   If void is returned, the server uses the last known state after processing all yields.
+ */
+export type TaskHandler = (context: TaskContext) => AsyncGenerator<TaskYieldUpdate, Task | void, unknown>;
+//# sourceMappingURL=context.d.ts.map

package/dist/server/interfaces/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/server/interfaces/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,OAAO,EACP,eAAe,EAChB,MAAM,gCAAgC,CAAC;AAExC;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,IAAI,EAAE,IAAI,CAAC;IAEX;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;;;OAIG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;OAEG;IACH,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,WAAW,GAAG,CACxB,OAAO,EAAE,WAAW,KACjB,cAAc,CAAC,eAAe,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC"}

package/dist/server/interfaces/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/server/interfaces/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/server/interfaces/context.ts"],"names":[],"mappings":""}

package/dist/server/interfaces/params.d.ts

@@ -0,0 +1,72 @@
+import { CorsOptions } from "cors";
+import { AgentCard, Message, SendTaskStreamingRequest, Task, TaskResubscriptionRequest } from "../../types/extended-schema.js";
+import { TaskStore } from "./store.js";
+import { TaskHandler, TaskContext } from "./context.js";
+import jayson from "jayson";
+import { ErrorHandler } from "../../utils/common/errors.js";
+import { Response } from "express";
+export type JSONRPCServerType = jayson.Server;
+export declare const JSONRPCServer: jayson.ServerConstructor;
+type JSONRPCError = jayson.JSONRPCError;
+export type JSONRPCCallback = (error: JSONRPCError | null, result?: any) => void;
+/**
+ * Type for the ActiveCancellations set
+ * This can be used by consumers to implement their own server solutions
+ */
+export type ActiveCancellations = Set<string>;
+/**
+ * Type for the CloseStreamsForTask function
+ * This can be used by consumers to implement their own server solutions
+ */
+export type CloseStreamsForTask = (taskId: string) => void;
+/**
+ * Type for the CreateTaskContext function
+ * This can be used by consumers to implement their own server solutions
+ */
+export type CreateTaskContext = (task: Task, message: Message, history: Message[]) => TaskContext;
+/**
+ * Type for the createJSONRPCServer function
+ * This can be used by consumers to implement their own server solutions
+ */
+export type CreateJSONRPCServer = (params: CreateJSONRPCServerParams) => JSONRPCServerType;
+/**
+ * Interface for createJSONRPCServer parameters
+ * This can be used by consumers to implement their own server solutions
+ */
+export interface CreateJSONRPCServerParams {
+    taskStore: TaskStore;
+    card: AgentCard;
+    taskHandler: TaskHandler;
+    activeCancellations: ActiveCancellations;
+    createTaskContext: CreateTaskContext;
+    closeStreamsForTask: CloseStreamsForTask;
+}
+/**
+ * Parameters for creating an A2AServer instance.
+ */
+export type A2AServerParams = {
+    handler: TaskHandler;
+    corsOptions?: CorsOptions;
+    port?: number;
+    basePath?: string;
+    taskStore?: TaskStore;
+    card?: AgentCard;
+    createJSONRPCServer?: JSONRPCServerFactory;
+};
+/**
+ * Parameters for creating an Express server.
+ */
+export type CreateExpressServerParams = Omit<A2AServerParams, "createJSONRPCServer" | "taskStore" | "handler"> & Required<Pick<A2AServerParams, "card" | "basePath" | "port" | "corsOptions">> & {
+    rpcServer: JSONRPCServerType;
+    errorHandler: ErrorHandler;
+    onTaskSendSubscribe: (req: SendTaskStreamingRequest, res: Response) => Promise<void>;
+    onTaskResubscribe: (req: TaskResubscriptionRequest, res: Response) => Promise<void>;
+};
+/**
+ * Function type for creating a JSON-RPC server
+ * @param params Parameters required to initialize the server
+ * @returns A configured JSON-RPC server instance
+ */
+export type JSONRPCServerFactory = (params: CreateJSONRPCServerParams) => JSONRPCServerType;
+export {};
+//# sourceMappingURL=params.d.ts.map

package/dist/server/interfaces/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../../src/server/interfaces/params.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EACL,SAAS,EACT,OAAO,EACP,wBAAwB,EACxB,IAAI,EACJ,yBAAyB,EAC1B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC;AAC9C,eAAO,MAAM,aAAa,0BAAgB,CAAC;AAC3C,KAAK,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;AAGxC,MAAM,MAAM,eAAe,GAAG,CAC5B,KAAK,EAAE,YAAY,GAAG,IAAI,EAC1B,MAAM,CAAC,EAAE,GAAG,KACT,IAAI,CAAC;AAEV;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;AAE9C;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;AAE3D;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAAE,KACf,WAAW,CAAC;AAEjB;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,MAAM,EAAE,yBAAyB,KAC9B,iBAAiB,CAAC;AAEvB;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,SAAS,CAAC;IACrB,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;IACzB,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,mBAAmB,EAAE,mBAAmB,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,mBAAmB,CAAC,EAAE,oBAAoB,CAAC;CAC5C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,eAAe,EACf,qBAAqB,GAAG,WAAW,GAAG,SAAS,CAChD,GACC,QAAQ,CACN,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,aAAa,CAAC,CACpE,GAAG;IACF,SAAS,EAAE,iBAAiB,CAAC;IAC7B,YAAY,EAAE,YAAY,CAAC;IAC3B,mBAAmB,EAAE,CACnB,GAAG,EAAE,wBAAwB,EAC7B,GAAG,EAAE,QAAQ,KACV,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,iBAAiB,EAAE,CACjB,GAAG,EAAE,yBAAyB,EAC9B,GAAG,EAAE,QAAQ,KACV,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB,CAAC;AAEJ;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,MAAM,EAAE,yBAAyB,KAC9B,iBAAiB,CAAC"}

package/dist/server/interfaces/params.js

@@ -0,0 +1,3 @@
+import jayson from "jayson";
+export const JSONRPCServer = jayson.Server;
+//# sourceMappingURL=params.js.map

package/dist/server/interfaces/params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../../../src/server/interfaces/params.ts"],"names":[],"mappings":"AAUA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAK5B,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC"}

package/dist/server/interfaces/server.d.ts

@@ -0,0 +1,34 @@
+import express, { Response } from "express";
+import http from "http";
+import { CorsOptions } from "cors";
+import { AgentCard, Message, Task, SendTaskStreamingRequest, TaskResubscriptionRequest } from "../../types/index.js";
+import { TaskStore } from "./store.js";
+import { TaskHandler } from "./context.js";
+import { JSONRPCServerType } from "./params.js";
+import { TaskAndHistory } from "./store.js";
+import { TaskContext } from "./context.js";
+export interface Server {
+    start(): express.Express;
+    stop(): Promise<void>;
+    getBasePath(): string;
+    getCorsOptions(): CorsOptions;
+    getCard(): AgentCard;
+    getTaskStore(): TaskStore;
+    getTaskHandler(): TaskHandler;
+    getActiveCancellations(): Set<string>;
+    getActiveStreams(): Map<string, Response[]>;
+    getPort(): number;
+    getRpcServer(): JSONRPCServerType;
+    getServerInstance(): http.Server | undefined;
+    getTaskContext(task: Task, userMessage: Message, history: Message[]): TaskContext;
+    onCancel(data: TaskAndHistory, res: Response): Promise<void>;
+    onEnd(taskId: string, res: Response): Promise<void>;
+    addStreamForTask(taskId: string, res: Response): void;
+    removeStreamForTask(taskId: string, res: Response): void;
+    closeStreamsForTask(taskId: string): void;
+    handleTaskSendSubscribe(req: SendTaskStreamingRequest, res: Response): Promise<void>;
+    handleTaskResubscribe(req: TaskResubscriptionRequest, res: Response): Promise<void>;
+    defaultAgentCard(): AgentCard;
+    createTaskContext(task: Task, userMessage: Message, history: Message[]): TaskContext;
+}
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/server/interfaces/server.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,EACL,SAAS,EACT,OAAO,EACP,IAAI,EACJ,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,WAAW,MAAM;IACrB,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IACzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,WAAW,IAAI,MAAM,CAAC;IACtB,cAAc,IAAI,WAAW,CAAC;IAC9B,OAAO,IAAI,SAAS,CAAC;IACrB,YAAY,IAAI,SAAS,CAAC;IAC1B,cAAc,IAAI,WAAW,CAAC;IAC9B,sBAAsB,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IACtC,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC5C,OAAO,IAAI,MAAM,CAAC;IAClB,YAAY,IAAI,iBAAiB,CAAC;IAClC,iBAAiB,IAAI,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IAC7C,cAAc,CACZ,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,OAAO,EACpB,OAAO,EAAE,OAAO,EAAE,GACjB,WAAW,CAAC;IACf,QAAQ,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtD,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;IACzD,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,uBAAuB,CACrB,GAAG,EAAE,wBAAwB,EAC7B,GAAG,EAAE,QAAQ,GACZ,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,qBAAqB,CACnB,GAAG,EAAE,yBAAyB,EAC9B,GAAG,EAAE,QAAQ,GACZ,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,gBAAgB,IAAI,SAAS,CAAC;IAC9B,iBAAiB,CACf,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,OAAO,EACpB,OAAO,EAAE,OAAO,EAAE,GACjB,WAAW,CAAC;CAChB"}

package/dist/server/interfaces/server.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.js.map

package/dist/server/interfaces/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/server/interfaces/server.ts"],"names":[],"mappings":""}

package/dist/server/interfaces/store.d.ts

@@ -0,0 +1,30 @@
+import type { Task, Message } from "../../types/extended-schema.js";
+/**
+ * Represents a task and its associated message history.
+ */
+export interface TaskAndHistory {
+    /** The task object */
+    task: Task;
+    /** The complete message history associated with the task */
+    history: Message[];
+}
+/**
+ * Interface for task storage providers.
+ * Abstracts the storage mechanism for tasks and their message history.
+ */
+export interface TaskStore {
+    /**
+     * Saves a task and its associated message history.
+     * Overwrites existing data if the task ID exists.
+     * @param data An object containing the task and its history.
+     * @returns A promise resolving when the save operation is complete.
+     */
+    save(data: TaskAndHistory): Promise<void>;
+    /**
+     * Loads a task and its history by task ID.
+     * @param taskId The ID of the task to load.
+     * @returns A promise resolving to an object containing the Task and its history, or null if not found.
+     */
+    load(taskId: string): Promise<TaskAndHistory | null>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/server/interfaces/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/server/interfaces/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,sBAAsB;IACtB,IAAI,EAAE,IAAI,CAAC;IAEX,4DAA4D;IAC5D,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;;;OAIG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CACtD"}

package/dist/server/interfaces/store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=store.js.map

package/dist/server/interfaces/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/server/interfaces/store.ts"],"names":[],"mappings":""}