@artinet/sdk 0.2.0

package/dist/client/a2a-client.d.ts

@@ -0,0 +1,99 @@
+import type { AgentCard, TaskSendParams, TaskQueryParams, // Used by get, resubscribe
+TaskIdParams, // Used by cancel, getTaskPushNotificationConfig
+TaskPushNotificationConfig, Task, TaskArtifactUpdateEvent, TaskStatusUpdateEvent } from "../types/extended-schema.js";
+import type { Client } from "./interfaces/client.js";
+/**
+ * A2AClient is the main client class for interacting with Agent2Agent (A2A) protocol-compliant services.
+ * It provides methods for sending tasks, retrieving statuses, canceling operations, and handling streaming responses.
+ */
+export declare class A2AClient implements Client {
+    private baseUrl;
+    private cachedAgentCard;
+    private customHeaders;
+    /**
+     * Creates a new A2AClient instance.
+     * @param baseUrl The base URL for the A2A server.
+     * @param headers Optional custom headers to include in all requests.
+     */
+    constructor(baseUrl: URL | string, headers?: Record<string, string>);
+    /**
+     * Retrieves the AgentCard from the A2A server.
+     * Caches the result after the first successful fetch.
+     * @returns A promise resolving to the AgentCard.
+     */
+    agentCard(): Promise<AgentCard>;
+    /**
+     * Refreshes the cached AgentCard by fetching it again from the server.
+     * @returns A promise resolving to the updated AgentCard.
+     */
+    refreshAgentCard(): Promise<AgentCard>;
+    /**
+     * Sends a task request to the agent (non-streaming).
+     * @param params The parameters for the tasks/send method.
+     * @returns A promise resolving to the Task object or null.
+     */
+    sendTask(params: TaskSendParams): Promise<Task | null>;
+    /**
+     * Sends a task and returns a subscription to status and artifact updates.
+     * @param params Task parameters for the request
+     * @returns An AsyncIterable that yields TaskStatusUpdateEvent or TaskArtifactUpdateEvent payloads.
+     */
+    sendTaskSubscribe(params: TaskSendParams): AsyncIterable<TaskStatusUpdateEvent | TaskArtifactUpdateEvent>;
+    /**
+     * Retrieves the current state of a task.
+     * @param params The parameters for the tasks/get method.
+     * @returns A promise resolving to the Task object or null.
+     */
+    getTask(params: TaskQueryParams): Promise<Task | null>;
+    /**
+     * Cancels a currently running task.
+     * @param params The parameters for the tasks/cancel method.
+     * @returns A promise resolving to the updated Task object (usually canceled state) or null.
+     */
+    cancelTask(params: TaskIdParams): Promise<Task | null>;
+    /**
+     * Sets or updates the push notification config for a task.
+     * @param params The parameters for the tasks/pushNotification/set method (which is TaskPushNotificationConfig).
+     * @returns A promise resolving to the confirmed TaskPushNotificationConfig or null.
+     */
+    setTaskPushNotification(params: TaskPushNotificationConfig): Promise<TaskPushNotificationConfig | null>;
+    /**
+     * Retrieves the currently configured push notification config for a task.
+     * @param params The parameters for the tasks/pushNotification/get method.
+     * @returns A promise resolving to the TaskPushNotificationConfig or null.
+     */
+    getTaskPushNotification(params: TaskIdParams): Promise<TaskPushNotificationConfig | null>;
+    /**
+     * Resubscribes to an existing task's update stream.
+     * @param params Parameters identifying the task to resubscribe to
+     * @returns An AsyncIterable that yields TaskStatusUpdateEvent or TaskArtifactUpdateEvent payloads.
+     */
+    resubscribeTask(params: TaskQueryParams): AsyncIterable<TaskStatusUpdateEvent | TaskArtifactUpdateEvent>;
+    /**
+     * Checks if the server supports a specific capability based on the agent card.
+     * @param capability The capability to check (e.g., 'streaming', 'pushNotifications').
+     * @returns A promise resolving to true if the capability is supported.
+     */
+    supports(capability: "streaming" | "pushNotifications" | "stateTransitionHistory"): Promise<boolean>;
+    /**
+     * Sets custom headers to be included in all requests.
+     * @param headers A record of header name/value pairs.
+     */
+    setHeaders(headers: Record<string, string>): void;
+    /**
+     * Adds a single custom header to be included in all requests.
+     * @param name The header name.
+     * @param value The header value.
+     */
+    addHeader(name: string, value: string): void;
+    /**
+     * Removes a custom header.
+     * @param name The header name to remove.
+     */
+    removeHeader(name: string): void;
+    /**
+     * Clears all custom headers.
+     */
+    clearHeaders(): void;
+}
+//# sourceMappingURL=a2a-client.d.ts.map

package/dist/client/a2a-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-client.d.ts","sourceRoot":"","sources":["../../src/client/a2a-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,SAAS,EAQT,cAAc,EACd,eAAe,EAAE,2BAA2B;AAC5C,YAAY,EAAE,gDAAgD;AAC9D,0BAA0B,EAQ1B,IAAI,EACJ,uBAAuB,EACvB,qBAAqB,EAGtB,MAAM,6BAA6B,CAAC;AAWrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD;;;GAGG;AACH,qBAAa,SAAU,YAAW,MAAM;IACtC,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,aAAa,CAA8B;IAEnD;;;;OAIG;gBACS,OAAO,EAAE,GAAG,GAAG,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;IAKvE;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC;IAyCrC;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,SAAS,CAAC;IAK5C;;;;OAIG;IACG,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAS5D;;;;OAIG;IACH,iBAAiB,CACf,MAAM,EAAE,cAAc,GACrB,aAAa,CAAC,qBAAqB,GAAG,uBAAuB,CAAC;IAOjE;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAS5D;;;;OAIG;IACG,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAS5D;;;;OAIG;IACG,uBAAuB,CAC3B,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC;IAO7C;;;;OAIG;IACG,uBAAuB,CAC3B,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC;IAO7C;;;;OAIG;IACH,eAAe,CACb,MAAM,EAAE,eAAe,GACtB,aAAa,CAAC,qBAAqB,GAAG,uBAAuB,CAAC;IAOjE;;;;OAIG;IACG,QAAQ,CACZ,UAAU,EAAE,WAAW,GAAG,mBAAmB,GAAG,wBAAwB,GACvE,OAAO,CAAC,OAAO,CAAC;IA4BnB;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAIjD;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI5C;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhC;;OAEG;IACH,YAAY,IAAI,IAAI;CAGrB"}

package/dist/client/a2a-client.js

@@ -0,0 +1,171 @@
+// Import RPC client helpers
+import { executeJsonRpcRequest, executeGetRequest, } from "../transport/rpc/rpc-client.js";
+import { executeStreamEvents } from "../transport/streaming/event-stream.js";
+import { logError } from "../utils/logging/log.js";
+import { INTERNAL_ERROR } from "../utils/common/errors.js";
+/**
+ * A2AClient is the main client class for interacting with Agent2Agent (A2A) protocol-compliant services.
+ * It provides methods for sending tasks, retrieving statuses, canceling operations, and handling streaming responses.
+ */
+export class A2AClient {
+    /**
+     * Creates a new A2AClient instance.
+     * @param baseUrl The base URL for the A2A server.
+     * @param headers Optional custom headers to include in all requests.
+     */
+    constructor(baseUrl, headers = {}) {
+        this.cachedAgentCard = null;
+        this.customHeaders = {};
+        this.baseUrl = typeof baseUrl === "string" ? new URL(baseUrl) : baseUrl;
+        this.customHeaders = headers;
+    }
+    /**
+     * Retrieves the AgentCard from the A2A server.
+     * Caches the result after the first successful fetch.
+     * @returns A promise resolving to the AgentCard.
+     */
+    async agentCard() {
+        if (this.cachedAgentCard) {
+            return this.cachedAgentCard;
+        }
+        // Standard location for agent cards
+        const wellKnownUrl = new URL("/.well-known/agent.json", this.baseUrl);
+        try {
+            try {
+                const card = await executeGetRequest(wellKnownUrl, this.customHeaders, "agent card (well-known)");
+                this.cachedAgentCard = card;
+                return this.cachedAgentCard;
+            }
+            catch (error) {
+                const fallbackUrl = new URL("/agent-card", this.baseUrl);
+                const fallbackCard = await executeGetRequest(fallbackUrl, this.customHeaders, "agent card (fallback)");
+                this.cachedAgentCard = fallbackCard;
+                return this.cachedAgentCard;
+            }
+        }
+        catch (error) {
+            logError("A2AClient:agentCard", "Failed to fetch or parse agent card:", error);
+            throw INTERNAL_ERROR(`Could not retrieve agent card: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Refreshes the cached AgentCard by fetching it again from the server.
+     * @returns A promise resolving to the updated AgentCard.
+     */
+    async refreshAgentCard() {
+        this.cachedAgentCard = null;
+        return this.agentCard();
+    }
+    /**
+     * Sends a task request to the agent (non-streaming).
+     * @param params The parameters for the tasks/send method.
+     * @returns A promise resolving to the Task object or null.
+     */
+    async sendTask(params) {
+        return await executeJsonRpcRequest(this.baseUrl, "tasks/send", params, this.customHeaders);
+    }
+    /**
+     * Sends a task and returns a subscription to status and artifact updates.
+     * @param params Task parameters for the request
+     * @returns An AsyncIterable that yields TaskStatusUpdateEvent or TaskArtifactUpdateEvent payloads.
+     */
+    sendTaskSubscribe(params) {
+        return executeStreamEvents(this.baseUrl, "tasks/sendSubscribe", params, this.customHeaders);
+    }
+    /**
+     * Retrieves the current state of a task.
+     * @param params The parameters for the tasks/get method.
+     * @returns A promise resolving to the Task object or null.
+     */
+    async getTask(params) {
+        return await executeJsonRpcRequest(this.baseUrl, "tasks/get", params, this.customHeaders);
+    }
+    /**
+     * Cancels a currently running task.
+     * @param params The parameters for the tasks/cancel method.
+     * @returns A promise resolving to the updated Task object (usually canceled state) or null.
+     */
+    async cancelTask(params) {
+        return await executeJsonRpcRequest(this.baseUrl, "tasks/cancel", params, this.customHeaders);
+    }
+    /**
+     * Sets or updates the push notification config for a task.
+     * @param params The parameters for the tasks/pushNotification/set method (which is TaskPushNotificationConfig).
+     * @returns A promise resolving to the confirmed TaskPushNotificationConfig or null.
+     */
+    async setTaskPushNotification(params) {
+        return await executeJsonRpcRequest(this.baseUrl, "tasks/pushNotification/set", params, this.customHeaders);
+    }
+    /**
+     * Retrieves the currently configured push notification config for a task.
+     * @param params The parameters for the tasks/pushNotification/get method.
+     * @returns A promise resolving to the TaskPushNotificationConfig or null.
+     */
+    async getTaskPushNotification(params) {
+        return await executeJsonRpcRequest(this.baseUrl, "tasks/pushNotification/get", params, this.customHeaders);
+    }
+    /**
+     * Resubscribes to an existing task's update stream.
+     * @param params Parameters identifying the task to resubscribe to
+     * @returns An AsyncIterable that yields TaskStatusUpdateEvent or TaskArtifactUpdateEvent payloads.
+     */
+    resubscribeTask(params) {
+        return executeStreamEvents(this.baseUrl, "tasks/resubscribe", params, this.customHeaders);
+    }
+    /**
+     * Checks if the server supports a specific capability based on the agent card.
+     * @param capability The capability to check (e.g., 'streaming', 'pushNotifications').
+     * @returns A promise resolving to true if the capability is supported.
+     */
+    async supports(capability) {
+        try {
+            const card = await this.agentCard();
+            if (!card.capabilities) {
+                return false;
+            }
+            switch (capability) {
+                case "streaming":
+                    return !!card.capabilities.streaming;
+                case "pushNotifications":
+                    return !!card.capabilities.pushNotifications;
+                case "stateTransitionHistory":
+                    return !!card.capabilities.stateTransitionHistory;
+                default:
+                    return false;
+            }
+        }
+        catch (error) {
+            logError("A2AClient:supports", `Failed to determine support for capability '${capability}':`, error);
+            return false; // Assume not supported if card fetch fails
+        }
+    }
+    /**
+     * Sets custom headers to be included in all requests.
+     * @param headers A record of header name/value pairs.
+     */
+    setHeaders(headers) {
+        this.customHeaders = { ...headers };
+    }
+    /**
+     * Adds a single custom header to be included in all requests.
+     * @param name The header name.
+     * @param value The header value.
+     */
+    addHeader(name, value) {
+        this.customHeaders[name] = value;
+    }
+    /**
+     * Removes a custom header.
+     * @param name The header name to remove.
+     */
+    removeHeader(name) {
+        delete this.customHeaders[name];
+    }
+    /**
+     * Clears all custom headers.
+     */
+    clearHeaders() {
+        this.customHeaders = {};
+    }
+}
+//# sourceMappingURL=a2a-client.js.map

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

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

package/dist/client/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./a2a-client.js";
+export * from "./interfaces/client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,3 @@
+export * from "./a2a-client.js";
+export * from "./interfaces/client.js";
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC"}

package/dist/client/interfaces/client.d.ts

@@ -0,0 +1,19 @@
+import { TaskPushNotificationConfig, TaskArtifactUpdateEvent, TaskIdParams, Task } from "../../types/extended-schema.js";
+import type { AgentCard, TaskQueryParams, TaskSendParams, TaskStatusUpdateEvent } from "../../types/extended-schema.js";
+export interface Client {
+    agentCard(): Promise<AgentCard>;
+    refreshAgentCard(): Promise<AgentCard>;
+    sendTask(params: TaskSendParams): Promise<Task | null>;
+    sendTaskSubscribe(params: TaskSendParams): AsyncIterable<TaskStatusUpdateEvent | TaskArtifactUpdateEvent>;
+    getTask(params: TaskQueryParams): Promise<Task | null>;
+    cancelTask(params: TaskIdParams): Promise<Task | null>;
+    setTaskPushNotification(params: TaskPushNotificationConfig): Promise<TaskPushNotificationConfig | null>;
+    getTaskPushNotification(params: TaskIdParams): Promise<TaskPushNotificationConfig | null>;
+    resubscribeTask(params: TaskQueryParams): AsyncIterable<TaskStatusUpdateEvent | TaskArtifactUpdateEvent>;
+    supports(capability: "streaming" | "pushNotifications" | "stateTransitionHistory"): Promise<boolean>;
+    setHeaders(headers: Record<string, string>): void;
+    addHeader(name: string, value: string): void;
+    removeHeader(name: string): void;
+    clearHeaders(): void;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/client/interfaces/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,YAAY,EACZ,IAAI,EACL,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,cAAc,EACd,qBAAqB,EACtB,MAAM,gCAAgC,CAAC;AAExC,MAAM,WAAW,MAAM;IACrB,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,gBAAgB,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACvD,iBAAiB,CACf,MAAM,EAAE,cAAc,GACrB,aAAa,CAAC,qBAAqB,GAAG,uBAAuB,CAAC,CAAC;IAClE,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACvD,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACvD,uBAAuB,CACrB,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAAC;IAC9C,uBAAuB,CACrB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAAC;IAC9C,eAAe,CACb,MAAM,EAAE,eAAe,GACtB,aAAa,CAAC,qBAAqB,GAAG,uBAAuB,CAAC,CAAC;IAClE,QAAQ,CACN,UAAU,EAAE,WAAW,GAAG,mBAAmB,GAAG,wBAAwB,GACvE,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAClD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,IAAI,IAAI,CAAC;CACtB"}

package/dist/client/interfaces/client.js

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

package/dist/client/interfaces/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./server/index.js";
+export * from "./client/index.js";
+export * from "./transport/index.js";
+export * from "./utils/index.js";
+export * from "./types/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./server/index.js";
+export * from "./client/index.js";
+export * from "./transport/index.js";
+export * from "./utils/index.js";
+export * from "./types/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/server/a2a-server.d.ts

@@ -0,0 +1,144 @@
+import express, { Response } from "express";
+import { CorsOptions } from "cors";
+import http from "http";
+import type { AgentCard, Task, Message, SendTaskStreamingRequest, TaskResubscriptionRequest } from "../types/index.js";
+import { TaskStore, TaskAndHistory } from "./interfaces/store.js";
+import { TaskHandler, TaskContext } from "./interfaces/context.js";
+import { A2AServerParams, JSONRPCServerType } from "./interfaces/params.js";
+import { Server } from "./interfaces/server.js";
+/**
+ * Implements an A2A protocol compliant server using Express.
+ * Handles task creation, streaming, cancellation and more.
+ * Uses Jayson for JSON-RPC handling.
+ */
+export declare class A2AServer implements Server {
+    private taskHandler;
+    private taskStore;
+    private corsOptions;
+    private basePath;
+    private port;
+    private rpcServer;
+    private serverInstance;
+    private activeCancellations;
+    private activeStreams;
+    /** The agent card representing this server */
+    card: AgentCard;
+    /**
+     * Returns the base path for the server
+     */
+    getBasePath(): string;
+    /**
+     * Returns the CORS options for the server
+     */
+    getCorsOptions(): CorsOptions;
+    /**
+     * Returns the agent card for the server
+     */
+    getCard(): AgentCard;
+    /**
+     * Returns the task store
+     */
+    getTaskStore(): TaskStore;
+    /**
+     * Returns the task handler
+     */
+    getTaskHandler(): TaskHandler;
+    /**
+     * Returns the set of active cancellations
+     */
+    getActiveCancellations(): Set<string>;
+    /**
+     * Returns the map of active streams
+     */
+    getActiveStreams(): Map<string, Response[]>;
+    /**
+     * Returns the port number
+     */
+    getPort(): number;
+    /**
+     * Returns the JSON-RPC server
+     */
+    getRpcServer(): JSONRPCServerType;
+    /**
+     * Returns the server instance
+     */
+    getServerInstance(): http.Server | undefined;
+    /**
+     * Returns a task context for the specified task and messages
+     */
+    getTaskContext(task: Task, userMessage: Message, history: Message[]): TaskContext;
+    /**
+     * Returns the default agent card
+     */
+    defaultAgentCard(): AgentCard;
+    /**
+     * Creates a new A2AServer.
+     * @param handler The task handler function that will process tasks
+     * @param options Options for configuring the server
+     */
+    constructor(params: A2AServerParams);
+    /**
+     * Starts the Express server listening on the specified port.
+     * @returns The running Express application instance.
+     */
+    start(): express.Express;
+    /**
+     * Stops the server and closes all connections.
+     * @returns A promise that resolves when the server is stopped.
+     */
+    stop(): Promise<void>;
+    /**
+     * Handles task cancellation
+     * @param data Task and history data
+     * @param res Response object
+     */
+    onCancel(data: TaskAndHistory, res: Response): Promise<void>;
+    /**
+     * Handles cleanup when a task stream ends
+     * @param taskId The task ID
+     * @param res Response object
+     */
+    onEnd(taskId: string, res: Response): Promise<void>;
+    /**
+     * Handles the tasks/sendSubscribe method.
+     * @param req The SendTaskRequest object
+     * @param res The Express Response object
+     */
+    handleTaskSendSubscribe(req: SendTaskStreamingRequest, res: Response): Promise<void>;
+    /**
+     * Handles the tasks/resubscribe method.
+     * @param req The TaskResubscriptionRequest object
+     * @param res The Express Response object
+     */
+    handleTaskResubscribe(req: TaskResubscriptionRequest, res: Response): Promise<void>;
+    /**
+     * Adds a response stream to the tracking map for a task.
+     * @param taskId The task ID
+     * @param res The response stream
+     */
+    addStreamForTask(taskId: string, res: Response): void;
+    /**
+     * Removes a response stream from the tracking map for a task.
+     * @param taskId The task ID
+     * @param res The response stream
+     */
+    removeStreamForTask(taskId: string, res: Response): void;
+    /**
+     * Initializes the default agent card
+     */
+    static defaultAgentCard(): AgentCard;
+    /**
+     * 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: Task, userMessage: Message, history: Message[]): TaskContext;
+    /**
+     * Closes any active streams for a task.
+     * @param taskId The task ID
+     */
+    closeStreamsForTask(taskId: string): void;
+}
+//# sourceMappingURL=a2a-server.d.ts.map

package/dist/server/a2a-server.d.ts.map

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