@artinet/sdk 0.6.0-preview.2 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artinet/sdk",
-  "version": "0.6.0-preview.2",
+  "version": "0.6.0",
   "description": "A TypeScript SDK for building collaborative AI agents.",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,6 +17,16 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./sqlite": {
+      "types": "./dist/storage/sqlite.d.ts",
+      "import": "./dist/storage/sqlite.js",
+      "default": "./dist/storage/sqlite.js"
+    },
+    "./express": {
+      "types": "./dist/server/express/server.d.ts",
+      "import": "./dist/server/express/server.js",
+      "default": "./dist/server/express/server.js"
+    },
     "./trpc": {
       "types": "./dist/transport/trpc/index.d.ts",
       "import": "./dist/transport/trpc/index.js",
@@ -64,7 +74,8 @@
     "clean": "rimraf dist",
     "rebuild": "rimraf dist node_modules/ package-lock.json && npm i && npm run build:all",
     "lint": "eslint src --ext .ts",
-    "prepublishOnly": "npm run rebuild && npm run lint && npm test",
+    "package-test": "npm run build && npm pack && docker build -f ./deployment/test.dockerfile -t sdk-test . && docker run --rm sdk-test && rm artinet-sdk-*.tgz",
+    "prepublishOnly": "npm run package-test && npm run rebuild && npm run lint && npm test",
     "test": "NODE_OPTIONS=--experimental-vm-modules jest",
     "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch",
     "test:coverage": "NODE_OPTIONS=--experimental-vm-modules jest --coverage",
@@ -84,56 +95,59 @@
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/the-artinet-project/artinet-sdk"
+    "url": "https://github.com/the-artinet-project/artinet"
   },
   "bugs": {
-    "url": "https://github.com/the-artinet-project/artinet-sdk/issues"
+    "url": "https://github.com/the-artinet-project/artinet/issues"
   },
   "homepage": "https://github.com/the-artinet-project/artinet-sdk#readme",
   "dependencies": {
-    "@artinet/types": "^0.0.9-alpha.3",
+    "@artinet/types": "^0.0.9",
+    "@opentelemetry/api": "^1.9.0",
     "cors": "^2.8.5",
-    "escape-html": "^1.0.3",
-    "eventsource-parser": "^3.0.1",
-    "express": "^5.1.0",
+    "eventemitter3": "^5.0.1",
     "uuid": "^13.0.0",
     "zod": "^3.25"
   },
   "peerDependencies": {
+    "express": "^5.1.0",
     "@a2a-js/sdk": "^0.3.7",
     "@modelcontextprotocol/sdk": "^1.24.3",
     "@trpc/server": "^11.4.3",
-    "@opentelemetry/api": "^1.9.0"
-  },
-  "optionalDependencies": {
-    "pino": "^10.1.0",
-    "winston": "^3.19.0"
+    "drizzle-orm": "^0.45.1"
   },
   "peerDependenciesMeta": {
-    "@modelcontextprotocol/sdk": {
+    "express": {
       "optional": false
     },
-    "@trpc/server": {
-      "optional": true
+    "@modelcontextprotocol/sdk": {
+      "optional": false
     },
     "@a2a-js/sdk": {
-      "optional": true
-    },
-    "@opentelemetry/api": {
       "optional": false
     },
+    "@trpc/server": {
+      "optional": true
+    },
     "pino": {
       "optional": true
     },
     "winston": {
       "optional": true
+    },
+    "drizzle-orm": {
+      "optional": true
     }
   },
   "devDependencies": {
+    "better-sqlite3": "^12.5.0",
+    "drizzle-orm": "^0.45.1",
     "@a2a-js/sdk": "^0.3.7",
     "@cfworker/json-schema": "^4.1.1",
     "@eslint/js": "^9.25.1",
+    "@modelcontextprotocol/sdk": "^1.24.3",
     "@opentelemetry/api": "^1.9.0",
+    "@trpc/server": "^11.4.3",
     "@types/cors": "^2.8.17",
     "@types/escape-html": "^1.0.4",
     "@types/express": "^5.0.1",
@@ -144,13 +158,11 @@
     "globals": "^16.0.0",
     "jest": "^30.2.0",
     "msw": "^2.7.5",
-    "@modelcontextprotocol/sdk": "^1.24.3",
     "pino": "^10.1.0",
     "pino-caller": "^4.0.0",
     "pino-pretty": "^13.1.3",
     "rimraf": "^6.1.2",
     "supertest": "latest",
-    "@trpc/server": "^11.4.3",
     "ts-jest": "^29.3.2",
     "ts-node": "^10.9.1",
     "ts-patch": "^3.3.0",
@@ -158,7 +170,8 @@
     "typescript": "^5.2.2",
     "typescript-eslint": "^8.31.0",
     "typescript-transform-paths": "^3.5.5",
-    "winston": "^3.19.0"
+    "winston": "^3.19.0",
+    "nock": "^14.0.10"
   },
   "engines": {
     "node": ">=18.9.1"

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

@@ -1,127 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { A2A } from "../types/index.js";
-import type { Client } from "../types/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;
-    private fallbackPath;
-    private agentUrl;
-    private mergePath;
-    /**
-     * Creates a new A2AClient instance.
-     * @param baseUrl The base URL for the A2A server.
-     * @param headers Optional custom headers to include in all requests.
-     * @param fallbackPath Optional fallback path to use if the agent card is not found at the base URL.
-     * @example
-     * const client = new A2AClient("http://localhost:4000/a2a");
-     * const card = await client.agentCard();
-     * console.log(card);
-     * @example
-     * const client = new A2AClient("http://localhost:4000/a2a", {}, "/agent-card");
-     * const card = await client.agentCard();
-     * console.log(card);
-     */
-    constructor(baseUrl: URL | string, headers?: Record<string, string>, fallbackPath?: string, mergePath?: boolean);
-    /**
-     * Retrieves the AgentCard from the A2A server.
-     * Caches the result after the first successful fetch.
-     * @returns A promise resolving to the AgentCard.
-     */
-    agentCard(): Promise<A2A.AgentCard>;
-    /**
-     * Retrieves the AgentCard from the A2A server.
-     * @returns A promise resolving to the AgentCard.
-     */
-    getAgentCard(): Promise<A2A.AgentCard>;
-    /**
-     * Refreshes the cached AgentCard by fetching it again from the server.
-     * @returns A promise resolving to the updated AgentCard.
-     */
-    refreshAgentCard(): Promise<A2A.AgentCard>;
-    sendMessage(params: A2A.MessageSendParams): Promise<A2A.Message | A2A.Task | null>;
-    sendMessage(params: string | A2A.MessageSendParams["message"]): Promise<A2A.Message | A2A.Task | null>;
-    /**
-     * @deprecated Use sendMessage instead.
-     * Sends a task request to the agent (non-streaming).
-     * @param params The parameters for the message/send method.
-     * @returns A promise resolving to the Task object or null.
-     */
-    sendTask(params: A2A.MessageSendParams): Promise<A2A.Message | A2A.Task | null>;
-    /**
-     * Sends a Message and returns a stream of status and artifact updates.
-     * @param params Task parameters for the request
-     * @returns An AsyncIterable that yields TaskStatusUpdateEvent/TaskArtifactUpdateEvent/Task/Message payloads.
-     */
-    sendStreamingMessage(params: A2A.MessageSendParams | string): AsyncIterable<A2A.Update>;
-    /**
-     * @deprecated Use sendStreamingMessage instead.
-     * 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: A2A.MessageSendParams): AsyncIterable<A2A.Update>;
-    /**
-     * 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: A2A.TaskQueryParams): Promise<A2A.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: A2A.TaskIdParams): Promise<A2A.Task | null>;
-    /**
-     * Sets or updates the push notification config for a task.
-     * @param params The parameters for the tasks/pushNotificationConfig/set method (which is TaskPushNotificationConfig).
-     * @returns A promise resolving to the confirmed TaskPushNotificationConfig or null.
-     */
-    setTaskPushNotification(params: A2A.TaskPushNotificationConfig): Promise<A2A.TaskPushNotificationConfig | null>;
-    /**
-     * Retrieves the currently configured push notification config for a task.
-     * @param params The parameters for the tasks/pushNotificationConfig/get method.
-     * @returns A promise resolving to the TaskPushNotificationConfig or null.
-     */
-    getTaskPushNotification(params: A2A.TaskIdParams): Promise<A2A.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: A2A.TaskQueryParams): AsyncIterable<A2A.Update>;
-    /**
-     * 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;
-}

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

@@ -1,233 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { executeJsonRpcRequest, executeGetRequest, } from "../transport/rpc/rpc-client.js";
-import { executeStreamEvents } from "../transport/streaming/event-stream.js";
-import { INTERNAL_ERROR } from "../utils/common/errors.js";
-import { logger } from "../config/index.js";
-import * as describe from "../create/describe.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.
-     * @param fallbackPath Optional fallback path to use if the agent card is not found at the base URL.
-     * @example
-     * const client = new A2AClient("http://localhost:4000/a2a");
-     * const card = await client.agentCard();
-     * console.log(card);
-     * @example
-     * const client = new A2AClient("http://localhost:4000/a2a", {}, "/agent-card");
-     * const card = await client.agentCard();
-     * console.log(card);
-     */
-    constructor(baseUrl, headers = {}, fallbackPath, mergePath = false) {
-        this.cachedAgentCard = null;
-        this.customHeaders = {};
-        this.baseUrl = typeof baseUrl === "string" ? new URL(baseUrl) : baseUrl;
-        this.customHeaders = headers;
-        this.fallbackPath = fallbackPath ?? "/agent-card";
-        this.agentUrl = this.baseUrl;
-        this.mergePath = mergePath;
-    }
-    /**
-     * 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-card.json", this.baseUrl);
-        if (this.mergePath) {
-            wellKnownUrl.pathname = this.baseUrl.pathname + wellKnownUrl.pathname;
-        }
-        try {
-            try {
-                if (!URL.canParse(wellKnownUrl)) {
-                    throw new Error("Invalid well-known URL");
-                }
-                const card = await executeGetRequest(wellKnownUrl, this.customHeaders, "agent card (well-known)");
-                if (!card.name || card.name === null || card.name === undefined) {
-                    throw new Error("No agent card found");
-                }
-                this.cachedAgentCard = card;
-            }
-            catch (error) {
-                logger.error("A2AClient:agentCard: Failed to fetch agent card (well-known):", error);
-                const fallbackUrl = new URL(this.fallbackPath, this.baseUrl);
-                if (this.mergePath) {
-                    fallbackUrl.pathname = this.baseUrl.pathname + fallbackUrl.pathname;
-                }
-                const fallbackCard = await executeGetRequest(fallbackUrl, this.customHeaders, "agent card (fallback)");
-                if (!fallbackCard.name ||
-                    fallbackCard.name === null ||
-                    fallbackCard.name === undefined) {
-                    throw new Error("No fallback agent card found" + error);
-                }
-                this.cachedAgentCard = fallbackCard;
-            }
-        }
-        catch (error) {
-            logger.error("A2AClient:agentCard: Failed to fetch or parse agent card:", error);
-            throw INTERNAL_ERROR(error);
-        }
-        this.agentUrl = new URL(this.cachedAgentCard.url, this.baseUrl);
-        return this.cachedAgentCard;
-    }
-    /**
-     * Retrieves the AgentCard from the A2A server.
-     * @returns A promise resolving to the AgentCard.
-     */
-    getAgentCard() {
-        return this.agentCard();
-    }
-    /**
-     * 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 Message to an agent server.
-     * @param params The parameters for the message/send method.
-     * @returns A promise resolving to Message/Task response from the agent server or null.
-     */
-    async sendMessage(params) {
-        return await executeJsonRpcRequest(this.agentUrl, "message/send", typeof params === "string"
-            ? describe.messageSendParams(params)
-            : typeof params === "object" && "message" in params
-                ? params
-                : describe.messageSendParams({ message: params }), this.customHeaders);
-    }
-    /**
-     * @deprecated Use sendMessage instead.
-     * Sends a task request to the agent (non-streaming).
-     * @param params The parameters for the message/send method.
-     * @returns A promise resolving to the Task object or null.
-     */
-    async sendTask(params) {
-        return await this.sendMessage(params);
-    }
-    /**
-     * Sends a Message and returns a stream of status and artifact updates.
-     * @param params Task parameters for the request
-     * @returns An AsyncIterable that yields TaskStatusUpdateEvent/TaskArtifactUpdateEvent/Task/Message payloads.
-     */
-    sendStreamingMessage(params) {
-        return executeStreamEvents(this.agentUrl, "message/stream", describe.messageSendParams(params), this.customHeaders);
-    }
-    /**
-     * @deprecated Use sendStreamingMessage instead.
-     * 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 this.sendStreamingMessage(params);
-    }
-    /**
-     * 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.agentUrl, "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.agentUrl, "tasks/cancel", params, this.customHeaders);
-    }
-    /**
-     * Sets or updates the push notification config for a task.
-     * @param params The parameters for the tasks/pushNotificationConfig/set method (which is TaskPushNotificationConfig).
-     * @returns A promise resolving to the confirmed TaskPushNotificationConfig or null.
-     */
-    async setTaskPushNotification(params) {
-        return await executeJsonRpcRequest(this.agentUrl, "tasks/pushNotificationConfig/set", params, this.customHeaders);
-    }
-    /**
-     * Retrieves the currently configured push notification config for a task.
-     * @param params The parameters for the tasks/pushNotificationConfig/get method.
-     * @returns A promise resolving to the TaskPushNotificationConfig or null.
-     */
-    async getTaskPushNotification(params) {
-        return await executeJsonRpcRequest(this.agentUrl, "tasks/pushNotificationConfig/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.agentUrl, "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) {
-            logger.error(`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 = {};
-    }
-}

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

@@ -1 +0,0 @@
-export * from "./a2a-client.js";

package/dist/browser/client/index.js

@@ -1 +0,0 @@
-export * from "./a2a-client.js";

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

@@ -1,15 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { MCP } from "../../types/index.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 MCP.JSONRPCResponse | MCP.JSONRPCErrorResponse>(data: string): Res;

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

@@ -1,49 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { MCP } from "../../types/index.js";
-import { SystemError, PARSE_ERROR } from "../../utils/common/errors.js";
-import { logger } from "../../config/index.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("Invalid response data");
-    }
-    try {
-        const parsed = JSON.parse(data); //todo: leverage safe parse
-        if (parsed.error) {
-            //MCP Error defs may be a wee bit restrictive
-            const parsedError = MCP.JSONRPCErrorResponseSchema.safeParse(parsed);
-            if (!parsedError.success) {
-                throw PARSE_ERROR(parsedError.error);
-            }
-            throw new SystemError(parsedError.data.error.message, parsedError.data.error.code, parsedError.data.error.data);
-        }
-        if (typeof parsed !== "object" ||
-            parsed === null ||
-            parsed.jsonrpc !== "2.0") {
-            throw PARSE_ERROR("invalid jsonrpc");
-        }
-        if (parsed.result === undefined) {
-            throw PARSE_ERROR("result is undefined");
-        }
-        return parsed;
-    }
-    catch (error) {
-        if (error instanceof SystemError) {
-            logger.error("parseResponse: SystemError:", error);
-            throw error;
-        }
-        logger.error("parseResponse: Error parsing response:", error);
-        throw PARSE_ERROR(error);
-    }
-}

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

@@ -1,80 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import type { A2A, MCP } from "../../types/index.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 A2A.A2ARequest>(method: Req["method"], params: Req["params"], requestId?: string | number): MCP.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 A2A.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 MCP.JSONRPCResultResponse>(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 A2A.A2ARequest, Res extends MCP.JSONRPCResultResponse>(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>;