@artinet/sdk 0.2.0

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

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

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

@@ -0,0 +1,21 @@
+import { TaskAndHistory, TaskStore } from "../../interfaces/store.js";
+/**
+ * In-memory implementation of the TaskStore interface.
+ * Stores tasks and their history in memory. Not persisted between server restarts.
+ */
+export declare class InMemoryTaskStore implements TaskStore {
+    private store;
+    /**
+     * 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=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../src/server/lib/storage/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAGtE;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,SAAS;IACjD,OAAO,CAAC,KAAK,CAA0C;IAEvD;;;;OAIG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAa1D;;;;OAIG;IACG,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAShD"}

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

@@ -0,0 +1,40 @@
+import { logDebug } from "../../../utils/logging/log.js";
+/**
+ * In-memory implementation of the TaskStore interface.
+ * Stores tasks and their history in memory. Not persisted between server restarts.
+ */
+export class InMemoryTaskStore {
+    constructor() {
+        this.store = new Map();
+    }
+    /**
+     * 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("InMemoryTaskStore", `Loading task: ${taskId}`);
+        const entry = this.store.get(taskId);
+        // Return copies to prevent external mutation
+        return entry
+            ? {
+                task: { ...entry.task },
+                history: [...entry.history],
+            }
+            : 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.
+     */
+    async save(data) {
+        logDebug("InMemoryTaskStore", `Saving task: ${data.task.id}`);
+        // Store copies to prevent internal mutation if caller reuses objects
+        this.store.set(data.task.id, {
+            task: { ...data.task },
+            history: [...data.history],
+        });
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/server/lib/storage/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../../src/server/lib/storage/memory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAEzD;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IAA9B;QACU,UAAK,GAAgC,IAAI,GAAG,EAAE,CAAC;IAkCzD,CAAC;IAhCC;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,MAAc;QACvB,QAAQ,CAAC,mBAAmB,EAAE,iBAAiB,MAAM,EAAE,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAErC,6CAA6C;QAC7C,OAAO,KAAK;YACV,CAAC,CAAC;gBACE,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE;gBACvB,OAAO,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC;aAC5B;YACH,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,IAAoB;QAC7B,QAAQ,CAAC,mBAAmB,EAAE,gBAAgB,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAE9D,qEAAqE;QACrE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE;YAC3B,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE;YACtB,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;SAC3B,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/transport/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./rpc/rpc-client.js";
+export * from "./streaming/event-stream.js";
+export * from "./streaming/stream.js";
+export * from "./rpc/parser.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC"}

package/dist/transport/index.js

@@ -0,0 +1,5 @@
+export * from "./rpc/rpc-client.js";
+export * from "./streaming/event-stream.js";
+export * from "./streaming/stream.js";
+export * from "./rpc/parser.js";
+//# sourceMappingURL=index.js.map

package/dist/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC"}

package/dist/transport/rpc/parser.d.ts

@@ -0,0 +1,12 @@
+import { JSONRPCResponse } from "../../types/extended-schema.js";
+/**
+ * Parses a JSON-RPC response string and validates its structure.
+ * If the response contains an error, it is thrown as an A2AError.
+ * If the response contains neither a result nor an error, a validation error is thrown.
+ *
+ * @param data Response data as string
+ * @returns The parsed and validated response object
+ * @throws A2AError if the response contains an error or is invalid
+ */
+export declare function parseResponse<Res extends JSONRPCResponse>(data: string): Res;
+//# sourceMappingURL=parser.d.ts.map

package/dist/transport/rpc/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/transport/rpc/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,GAAG,SAAS,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,CAkC5E"}

package/dist/transport/rpc/parser.js

@@ -0,0 +1,37 @@
+import { SystemError, PARSE_ERROR } from "../../utils/common/errors.js";
+/**
+ * Parses a JSON-RPC response string and validates its structure.
+ * If the response contains an error, it is thrown as an A2AError.
+ * If the response contains neither a result nor an error, a validation error is thrown.
+ *
+ * @param data Response data as string
+ * @returns The parsed and validated response object
+ * @throws A2AError if the response contains an error or is invalid
+ */
+export function parseResponse(data) {
+    if (!data) {
+        throw PARSE_ERROR();
+    }
+    try {
+        const parsed = JSON.parse(data);
+        if (parsed.error) {
+            throw new SystemError(parsed.error.message, parsed.error.code, parsed.error.data);
+        }
+        if (typeof parsed !== "object" ||
+            parsed === null ||
+            parsed.jsonrpc !== "2.0") {
+            throw PARSE_ERROR();
+        }
+        if (parsed.result === undefined) {
+            throw PARSE_ERROR();
+        }
+        return parsed;
+    }
+    catch (error) {
+        if (error instanceof SystemError) {
+            throw error;
+        }
+        throw PARSE_ERROR(error);
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/transport/rpc/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../src/transport/rpc/parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAExE;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAA8B,IAAY;IACrE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,WAAW,EAAE,CAAC;IACtB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAQ,CAAC;QACvC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,IAAI,WAAW,CACnB,MAAM,CAAC,KAAK,CAAC,OAAO,EACpB,MAAM,CAAC,KAAK,CAAC,IAAI,EACjB,MAAM,CAAC,KAAK,CAAC,IAAI,CAClB,CAAC;QACJ,CAAC;QAED,IACE,OAAO,MAAM,KAAK,QAAQ;YAC1B,MAAM,KAAK,IAAI;YACf,MAAM,CAAC,OAAO,KAAK,KAAK,EACxB,CAAC;YACD,MAAM,WAAW,EAAE,CAAC;QACtB,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,WAAW,EAAE,CAAC;QACtB,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;YACjC,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/transport/rpc/rpc-client.d.ts

@@ -0,0 +1,77 @@
+import type { JSONRPCRequest, JSONRPCResponse, A2ARequest } from "../../types/extended-schema.js";
+/**
+ * Creates a JSON-RPC request body with the specified method and parameters.
+ *, ErrorCodeParseError
+ * @param method The JSON-RPC method name
+ * @param params The parameters for the method
+ * @param requestId Optional request ID (generates a UUID v4 if not provided)
+ * @returns A properly formatted JSON-RPC request object
+ */
+export declare function createJsonRpcRequest<Req extends A2ARequest>(method: Req["method"], params: Req["params"], requestId?: string | number): JSONRPCRequest;
+/**
+ * Sends a JSON-RPC request to the specified endpoint.
+ *
+ * @param baseUrl The API endpoint URL
+ * @param method The JSON-RPC method name
+ * @param params The parameters for the method
+ * @param headers Custom headers to include in the request
+ * @param acceptHeader The desired Accept header ('application/json' or 'text/event-stream')
+ * @returns A Promise resolving to the fetch Response object
+ * @throws RpcError if there's a network error
+ */
+export declare function sendJsonRpcRequest<Req extends A2ARequest>(baseUrl: URL, method: Req["method"], params: Req["params"], headers?: Record<string, string>, acceptHeader?: "application/json" | "text/event-stream"): Promise<Response>;
+/**
+ * Sends a GET request to the specified endpoint.
+ * This is used for non-JSON-RPC calls like agent card retrieval.
+ *
+ * @param url The endpoint URL
+ * @param headers Custom headers to include in the request
+ * @returns A Promise resolving to the fetch Response object
+ * @throws RpcError if there's a network error
+ */
+export declare function sendGetRequest(url: URL, headers?: Record<string, string>): Promise<Response>;
+/**
+ * Processes a standard JSON-RPC response (non-streaming).
+ * Parses the response, validates it, and returns the result payload.
+ *
+ * @param response The fetch Response object
+ * @param expectedMethod Optional method name for logging purposes
+ * @returns A promise resolving to the result payload
+ * @throws RpcError if there's an error in the response
+ */
+export declare function handleJsonRpcResponse<Res extends JSONRPCResponse>(response: Response, expectedMethod?: string): Promise<NonNullable<Res["result"]>>;
+/**
+ * Processes a JSON response from a regular GET request.
+ * Handles error checking and returns the parsed JSON.
+ *
+ * @param response The fetch Response object
+ * @param endpoint Optional endpoint description for logging purposes
+ * @returns A promise resolving to the parsed JSON
+ * @throws RpcError if there's a response error
+ */
+export declare function handleJsonResponse<T>(response: Response, endpoint?: string): Promise<T>;
+/**
+ * Sends a JSON-RPC request and processes the response in a single operation.
+ * This combines sendJsonRpcRequest and handleJsonRpcResponse into one call.
+ *
+ * @param baseUrl The API endpoint URL
+ * @param method The JSON-RPC method name
+ * @param params The parameters for the method
+ * @param headers Custom headers to include in the request
+ * @param acceptHeader The desired Accept header ('application/json' or 'text/event-stream')
+ * @returns A Promise resolving to the result payload
+ * @throws RpcError if there's a network error or error in the response
+ */
+export declare function executeJsonRpcRequest<Req extends A2ARequest, Res extends JSONRPCResponse>(baseUrl: URL, method: Req["method"], params: Req["params"], headers?: Record<string, string>, acceptHeader?: "application/json" | "text/event-stream"): Promise<NonNullable<Res["result"]>>;
+/**
+ * Sends a GET request and processes the JSON response.
+ * Helper for non-RPC REST endpoints.
+ *
+ * @param url The endpoint URL
+ * @param headers Custom headers to include in the request
+ * @param endpoint Optional endpoint description for logging
+ * @returns A Promise resolving to the parsed JSON
+ * @throws RpcError if there's a network error or error in the response
+ */
+export declare function executeGetRequest<T>(url: URL, headers?: Record<string, string>, endpoint?: string): Promise<T>;
+//# sourceMappingURL=rpc-client.d.ts.map

package/dist/transport/rpc/rpc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-client.d.ts","sourceRoot":"","sources":["../../../src/transport/rpc/rpc-client.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,UAAU,EACX,MAAM,gCAAgC,CAAC;AAIxC;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,SAAS,UAAU,EACzD,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,EACrB,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,EACrB,SAAS,GAAE,MAAM,GAAG,MAAiB,GACpC,cAAc,CAOhB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,SAAS,UAAU,EAC7D,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,EACrB,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,EACrB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACpC,YAAY,GAAE,kBAAkB,GAAG,mBAAwC,GAC1E,OAAO,CAAC,QAAQ,CAAC,CAsBnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,GAAG,EACR,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACnC,OAAO,CAAC,QAAQ,CAAC,CAiBnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,SAAS,eAAe,EACrE,QAAQ,EAAE,QAAQ,EAClB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CA+CrC;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,QAAQ,EAAE,QAAQ,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CA2BZ;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,SAAS,UAAU,EACtB,GAAG,SAAS,eAAe,EAE3B,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,EACrB,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,EACrB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACpC,YAAY,GAAE,kBAAkB,GAAG,mBAAwC,GAC1E,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAUrC;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,GAAG,EAAE,GAAG,EACR,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACpC,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CAGZ"}

package/dist/transport/rpc/rpc-client.js

@@ -0,0 +1,182 @@
+/**
+ * HTTP JSON-RPC client utilities.
+ * Handles the common pattern of sending JSON-RPC requests and processing responses.
+ */
+import { v4 as uuidv4 } from "uuid";
+import { SystemError, INTERNAL_ERROR, PARSE_ERROR, } from "../../utils/common/errors.js";
+import { parseResponse } from "./parser.js";
+import { logError, logWarn } from "../../utils/logging/log.js";
+/**
+ * Creates a JSON-RPC request body with the specified method and parameters.
+ *, ErrorCodeParseError
+ * @param method The JSON-RPC method name
+ * @param params The parameters for the method
+ * @param requestId Optional request ID (generates a UUID v4 if not provided)
+ * @returns A properly formatted JSON-RPC request object
+ */
+export function createJsonRpcRequest(method, params, requestId = uuidv4()) {
+    return {
+        jsonrpc: "2.0",
+        id: requestId,
+        method,
+        params,
+    };
+}
+/**
+ * Sends a JSON-RPC request to the specified endpoint.
+ *
+ * @param baseUrl The API endpoint URL
+ * @param method The JSON-RPC method name
+ * @param params The parameters for the method
+ * @param headers Custom headers to include in the request
+ * @param acceptHeader The desired Accept header ('application/json' or 'text/event-stream')
+ * @returns A Promise resolving to the fetch Response object
+ * @throws RpcError if there's a network error
+ */
+export async function sendJsonRpcRequest(baseUrl, method, params, headers = {}, acceptHeader = "application/json") {
+    const requestBody = createJsonRpcRequest(method, params);
+    try {
+        return await fetch(baseUrl, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Accept: acceptHeader,
+                ...headers,
+            },
+            body: JSON.stringify(requestBody),
+        });
+    }
+    catch (networkError) {
+        logError("SendJsonRpcRequest", "Network error during RPC call:", networkError);
+        // Wrap network errors into a standard error format
+        throw INTERNAL_ERROR(networkError);
+    }
+}
+/**
+ * Sends a GET request to the specified endpoint.
+ * This is used for non-JSON-RPC calls like agent card retrieval.
+ *
+ * @param url The endpoint URL
+ * @param headers Custom headers to include in the request
+ * @returns A Promise resolving to the fetch Response object
+ * @throws RpcError if there's a network error
+ */
+export async function sendGetRequest(url, headers = {}) {
+    try {
+        return await fetch(url, {
+            method: "GET",
+            headers: {
+                Accept: "application/json",
+                ...headers,
+            },
+        });
+    }
+    catch (networkError) {
+        logError("SendGetRequest", "Network error during GET request:", networkError);
+        throw INTERNAL_ERROR(networkError);
+    }
+}
+/**
+ * Processes a standard JSON-RPC response (non-streaming).
+ * Parses the response, validates it, and returns the result payload.
+ *
+ * @param response The fetch Response object
+ * @param expectedMethod Optional method name for logging purposes
+ * @returns A promise resolving to the result payload
+ * @throws RpcError if there's an error in the response
+ */
+export async function handleJsonRpcResponse(response, expectedMethod) {
+    let responseBody = null;
+    try {
+        responseBody = await response.text();
+        if (!response.ok) {
+            try {
+                // Try to parse error as JSON-RPC
+                parseResponse(responseBody);
+                // If we get here, it means there was no error in the response
+                // But the HTTP status was not OK, so we throw a generic error
+            }
+            catch (parseError) {
+                logWarn("handleJsonRpcResponse", "Error parsing JSON-RPC response:", parseError);
+            }
+            // Throw a generic HTTP error if we couldn't extract an RPC error
+            throw new Error(`HTTP error ${response.status}: ${response.statusText}${responseBody ? ` - ${responseBody}` : ""}`);
+        }
+        // Parse and validate the response
+        // If it has an error, parseResponse will throw
+        // If it doesn't have a result, parseResponse will also throw
+        const jsonResponse = parseResponse(responseBody);
+        // At this point, we know we have a valid result
+        // NonNullable is used in the return type to ensure TypeScript knows this
+        return jsonResponse.result;
+    }
+    catch (error) {
+        logError("handleJsonRpcResponse", `Error processing response [${expectedMethod}]:`, error);
+        // Re-throw RpcError instances directly, wrap others
+        if (error instanceof SystemError) {
+            throw error;
+        }
+        else {
+            throw INTERNAL_ERROR(error);
+        }
+    }
+}
+/**
+ * Processes a JSON response from a regular GET request.
+ * Handles error checking and returns the parsed JSON.
+ *
+ * @param response The fetch Response object
+ * @param endpoint Optional endpoint description for logging purposes
+ * @returns A promise resolving to the parsed JSON
+ * @throws RpcError if there's a response error
+ */
+export async function handleJsonResponse(response, endpoint) {
+    let responseBody = null;
+    try {
+        responseBody = await response.text();
+        if (!response.ok) {
+            throw new Error(`HTTP error ${response.status}: ${response.statusText}${responseBody ? ` - ${responseBody}` : ""}`);
+        }
+        return JSON.parse(responseBody);
+    }
+    catch (error) {
+        logError("handleJsonResponse", `Error processing response for ${endpoint || "unknown endpoint"}:`, error);
+        if (error instanceof SystemError) {
+            throw error;
+        }
+        else {
+            throw PARSE_ERROR(error);
+        }
+    }
+}
+/**
+ * Sends a JSON-RPC request and processes the response in a single operation.
+ * This combines sendJsonRpcRequest and handleJsonRpcResponse into one call.
+ *
+ * @param baseUrl The API endpoint URL
+ * @param method The JSON-RPC method name
+ * @param params The parameters for the method
+ * @param headers Custom headers to include in the request
+ * @param acceptHeader The desired Accept header ('application/json' or 'text/event-stream')
+ * @returns A Promise resolving to the result payload
+ * @throws RpcError if there's a network error or error in the response
+ */
+export async function executeJsonRpcRequest(baseUrl, method, params, headers = {}, acceptHeader = "application/json") {
+    const response = await sendJsonRpcRequest(baseUrl, method, params, headers, acceptHeader);
+    return handleJsonRpcResponse(response, method);
+}
+/**
+ * Sends a GET request and processes the JSON response.
+ * Helper for non-RPC REST endpoints.
+ *
+ * @param url The endpoint URL
+ * @param headers Custom headers to include in the request
+ * @param endpoint Optional endpoint description for logging
+ * @returns A Promise resolving to the parsed JSON
+ * @throws RpcError if there's a network error or error in the response
+ */
+export async function executeGetRequest(url, headers = {}, endpoint) {
+    const response = await sendGetRequest(url, headers);
+    return handleJsonResponse(response, endpoint);
+}
+//# sourceMappingURL=rpc-client.js.map

package/dist/transport/rpc/rpc-client.js.map

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

package/dist/transport/streaming/event-stream.d.ts

@@ -0,0 +1,22 @@
+import type { JSONRPCResponse, A2ARequest } from "../../types/extended-schema.js";
+/**
+ * Creates an async generator for processing task events from an SSE stream
+ *
+ * @template T The type of task event to process (TaskStatusUpdateEvent or TaskArtifactUpdateEvent)
+ * @param response The fetch Response object containing the event stream
+ * @returns An async generator yielding the specified type of task events from StreamingResponse
+ */
+export declare function handleEventStream<StreamRes extends JSONRPCResponse>(response: Response): AsyncGenerator<NonNullable<StreamRes["result"]>>;
+/**
+ * Executes a streaming JSON-RPC request and yields events as they arrive
+ *
+ * @template Req The type of request being made
+ * @template StreamRes The type of streaming response expected
+ * @param baseUrl The base URL for the API
+ * @param method The JSON-RPC method to call
+ * @param params The parameters for the method
+ * @param customHeaders Any custom headers to include in the request
+ * @returns An AsyncIterable yielding events from the stream
+ */
+export declare function executeStreamEvents<Req extends A2ARequest, StreamRes extends JSONRPCResponse>(baseUrl: URL, method: Req["method"], params: Req["params"], customHeaders: Record<string, string>): AsyncIterable<NonNullable<StreamRes["result"]>>;
+//# sourceMappingURL=event-stream.d.ts.map

package/dist/transport/streaming/event-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-stream.d.ts","sourceRoot":"","sources":["../../../src/transport/streaming/event-stream.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACX,MAAM,gCAAgC,CAAC;AAIxC;;;;;;GAMG;AACH,wBAAuB,iBAAiB,CAAC,SAAS,SAAS,eAAe,EACxE,QAAQ,EAAE,QAAQ,GACjB,cAAc,CAAC,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAqDlD;AAED;;;;;;;;;;GAUG;AACH,wBAAuB,mBAAmB,CACxC,GAAG,SAAS,UAAU,EACtB,SAAS,SAAS,eAAe,EAEjC,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,EACrB,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,EACrB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,aAAa,CAAC,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAejD"}

package/dist/transport/streaming/event-stream.js

@@ -0,0 +1,79 @@
+/**
+ * Event stream utilities for handling Server-Sent Events (SSE).
+ */
+import { parseResponse } from "../rpc/parser.js";
+import { createParser } from "eventsource-parser";
+import { sendJsonRpcRequest } from "../rpc/rpc-client.js";
+import { logError, logWarn, logDebug } from "../../utils/logging/log.js";
+/**
+ * Creates an async generator for processing task events from an SSE stream
+ *
+ * @template T The type of task event to process (TaskStatusUpdateEvent or TaskArtifactUpdateEvent)
+ * @param response The fetch Response object containing the event stream
+ * @returns An async generator yielding the specified type of task events from StreamingResponse
+ */
+export async function* handleEventStream(response) {
+    if (!response.ok || !response.body) {
+        let errorText = null;
+        try {
+            errorText = await response.text();
+        }
+        catch (_) { }
+        logError("handleEventStream", `HTTP error [${response.status}:${response.statusText}] - ${errorText}`, new Error(`HTTP error [${response.status}:${response.statusText}] - ${errorText}`));
+        throw new Error(`HTTP error [${response.status}:${response.statusText}] - ${errorText}`);
+    }
+    // Use eventsource-parser to process the SSE stream
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    const events = [];
+    const parser = createParser((event) => {
+        if (event.type === "event" && event.data) {
+            try {
+                const parsedData = parseResponse(event.data);
+                const eventResult = parsedData.result;
+                if (eventResult) {
+                    events.push(eventResult);
+                }
+                else {
+                    logWarn("handleEventStream", "Failed to parse SSE data", parsedData);
+                }
+            }
+            catch (e) {
+                logWarn("handleEventStream", "Failed to parse SSE data", e);
+            }
+        }
+    });
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            const chunk = decoder.decode(value, { stream: true });
+            parser.feed(chunk);
+            while (events.length > 0) {
+                yield events.shift();
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+/**
+ * Executes a streaming JSON-RPC request and yields events as they arrive
+ *
+ * @template Req The type of request being made
+ * @template StreamRes The type of streaming response expected
+ * @param baseUrl The base URL for the API
+ * @param method The JSON-RPC method to call
+ * @param params The parameters for the method
+ * @param customHeaders Any custom headers to include in the request
+ * @returns An AsyncIterable yielding events from the stream
+ */
+export async function* executeStreamEvents(baseUrl, method, params, customHeaders) {
+    logDebug("executeStreamEvents", `Sending streaming request to: ${baseUrl.toString()}, method: ${method}`);
+    const responsePromise = sendJsonRpcRequest(baseUrl, method, params, customHeaders, "text/event-stream");
+    const response = await responsePromise;
+    yield* handleEventStream(response);
+}
+//# sourceMappingURL=event-stream.js.map

package/dist/transport/streaming/event-stream.js.map

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

package/dist/transport/streaming/stream.d.ts

@@ -0,0 +1,42 @@
+import { Response } from "express";
+import { JSONRPCError } from "../../types/schema.js";
+import { TaskEvent } from "../../types/extended-schema.js";
+import { TaskStore, TaskAndHistory } from "../../server/interfaces/store.js";
+import { TaskContext } from "../../server/interfaces/context.js";
+import { TaskHandler } from "../../server/interfaces/context.js";
+/**
+ * Sets up a Server-Sent Events stream with appropriate headers
+ * and initializes tracking for the stream.
+ *
+ * @param res The Express Response object
+ * @param taskId The task ID to associate with this stream
+ * @param reqId The request ID for acknowledgment
+ * @param initialStatus Optional initial status to send
+ * @param addStreamMethod Function to add stream to tracking
+ * @param sendSseMethod Function to send SSE events
+ */
+export declare function setupSseStream(res: Response, taskId: string, initialStatus: TaskEvent, addStreamMethod?: (taskId: string, res: Response) => void): void;
+/**
+ * Sends a Server-Sent Event with task data.
+ * @param res The Express Response object
+ * @param reqId The request ID
+ * @param eventData The event data to send
+ */
+export declare function sendSSEEvent(res: Response, update: TaskEvent): void;
+/**
+ * Sends a Server-Sent Event with error data.
+ * @param res The Express Response object
+ * @param reqId The request ID
+ * @param error The error to send
+ */
+export declare function sendSSEError(res: Response, error: JSONRPCError<any, any>): void;
+/**
+ * Processes a task stream, handling generator yields and sending SSE events.
+ * @param req The request object
+ * @param res The response object
+ * @param taskId The task ID
+ * @param context The task context
+ * @param initialData The initial task data
+ */
+export declare function processTaskStream(taskStore: TaskStore, taskHandler: TaskHandler, res: Response, taskId: string, context: TaskContext, initialData: TaskAndHistory, onCancel: (data: TaskAndHistory, res: Response) => Promise<void>, onEnd: (taskId: string, res: Response) => Promise<void>): Promise<void>;
+//# sourceMappingURL=stream.d.ts.map

package/dist/transport/streaming/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/transport/streaming/stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAY,YAAY,EAAmB,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AASjE;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,SAAS,EACxB,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI,GACxD,IAAI,CAeN;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAYnE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,GAC5B,IAAI,CAWN;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,WAAW,EACxB,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,WAAW,EACpB,WAAW,EAAE,cAAc,EAC3B,QAAQ,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,EAChE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,GACtD,OAAO,CAAC,IAAI,CAAC,CA+Ef"}