@a2anet/a2a-utils 0.1.0 → 0.4.0

package/dist/client/a2a-agents.js

@@ -0,0 +1,243 @@
+// SPDX-FileCopyrightText: 2025-present A2A Net <hello@a2anet.com>
+//
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Agent management for A2A applications.
+ */
+import * as fs from "node:fs";
+import { DefaultAgentCardResolver } from "@a2a-js/sdk/client";
+/**
+ * Manages A2A agent cards keyed by user-defined agent IDs.
+ *
+ * Agents are configured via a dict mapping agent_id to config, or a JSON file path.
+ */
+export class A2AAgents {
+    config;
+    agents = {};
+    initErrors = {};
+    initialized = false;
+    initPromise = null;
+    timeout;
+    /**
+     * Initialize the agent manager.
+     *
+     * @param agents - Agent config as:
+     *   - object: {"agent-id": {"url": "https://...", "custom_headers": {"X-API-Key": "..."}}}
+     *   - string: path to agents.json file with the same structure
+     *   - null: empty, add agents later
+     * @param opts.timeout - HTTP timeout in seconds for fetching agent cards (default: 15s).
+     */
+    constructor(agents = null, opts) {
+        this.timeout = opts?.timeout ?? 15.0;
+        this.config = this.loadConfig(agents);
+    }
+    /** Load and validate agent config. */
+    loadConfig(agents) {
+        if (agents === null) {
+            return {};
+        }
+        if (typeof agents === "string") {
+            const text = fs.readFileSync(agents, "utf-8");
+            return JSON.parse(text);
+        }
+        return { ...agents };
+    }
+    /** Lazily fetch all agent cards on first use (double-check locking). */
+    async ensureInitialized() {
+        if (this.initialized)
+            return;
+        // Single-flight pattern
+        if (this.initPromise === null) {
+            this.initPromise = this.doInitialize();
+        }
+        await this.initPromise;
+    }
+    async doInitialize() {
+        if (this.initialized)
+            return;
+        if (Object.keys(this.config).length === 0) {
+            console.warn("No agents configured");
+            this.initialized = true;
+            return;
+        }
+        const entries = Object.entries(this.config);
+        const results = await Promise.allSettled(entries.map(([agentId, cfg]) => this.fetchAgent(agentId, cfg)));
+        this.initErrors = {};
+        for (let i = 0; i < results.length; i++) {
+            const result = results[i];
+            if (result.status === "rejected") {
+                const aid = entries[i][0];
+                const url = this.config[aid]?.url ?? "unknown";
+                const reason = result.reason;
+                const errorMsg = `${reason?.constructor?.name ?? "Error"}: ${reason}`;
+                this.initErrors[aid] = errorMsg;
+                console.error(`Error loading agent '${aid}' from ${url}: ${errorMsg}`);
+            }
+        }
+        if (Object.keys(this.agents).length > 0) {
+            console.info(`Successfully initialized ${Object.keys(this.agents).length} agent(s)`);
+        }
+        else {
+            console.warn("No agents were successfully initialized");
+        }
+        this.initialized = true;
+    }
+    /** Fetch a single agent card and register it. */
+    async fetchAgent(agentId, config) {
+        const url = config.url;
+        const customHeaders = config.custom_headers ?? {};
+        const [baseUrl, cardPath] = this.parseAgentCardUrl(url);
+        const resolver = new DefaultAgentCardResolver({
+            fetchImpl: this.createFetchImpl(customHeaders),
+        });
+        const agentCard = await resolver.resolve(baseUrl, cardPath);
+        this.agents[agentId] = {
+            agentCard,
+            customHeaders,
+        };
+    }
+    /** Create a fetch implementation that applies the configured timeout and custom headers. */
+    createFetchImpl(customHeaders) {
+        const wrappedFetch = (input, init) => {
+            const timeoutSignal = AbortSignal.timeout(this.timeout * 1000);
+            const signal = init?.signal != null
+                ? AbortSignal.any([init.signal, timeoutSignal])
+                : timeoutSignal;
+            const mergedInit = {
+                ...init,
+                signal,
+                headers: {
+                    ...init?.headers,
+                    ...customHeaders,
+                },
+            };
+            return fetch(input, mergedInit);
+        };
+        wrappedFetch.preconnect = fetch.preconnect;
+        return wrappedFetch;
+    }
+    /** Parse agent card URL into base_url and card_path. */
+    parseAgentCardUrl(url) {
+        const parsed = new URL(url);
+        const baseUrl = `${parsed.protocol}//${parsed.host}`;
+        const cardPath = parsed.pathname;
+        return [baseUrl, cardPath];
+    }
+    /**
+     * Register a new agent at runtime.
+     *
+     * @param agentId - User-defined agent identifier.
+     * @param url - Agent card URL.
+     * @param customHeaders - Optional custom HTTP headers.
+     *
+     * @throws Error if agentId is already registered.
+     */
+    async addAgent(agentId, url, customHeaders) {
+        await this.ensureInitialized();
+        if (agentId in this.agents) {
+            throw new Error(`Agent '${agentId}' is already registered`);
+        }
+        const config = {
+            url,
+            custom_headers: customHeaders ?? {},
+        };
+        await this.fetchAgent(agentId, config);
+    }
+    /**
+     * Retrieve agent by ID.
+     *
+     * @param agentId - User-defined agent identifier.
+     *
+     * @returns AgentURLAndCustomHeaders, or null if not found.
+     */
+    async getAgent(agentId) {
+        await this.ensureInitialized();
+        return this.agents[agentId] ?? null;
+    }
+    /**
+     * Get errors from the most recent initialization attempt.
+     *
+     * @returns Object mapping agent_id to error message for agents that failed to load.
+     */
+    get initializationErrors() {
+        return { ...this.initErrors };
+    }
+    /**
+     * Get all registered agents.
+     *
+     * @returns Object mapping agent_id to AgentURLAndCustomHeaders.
+     */
+    async getAgents() {
+        await this.ensureInitialized();
+        return { ...this.agents };
+    }
+    /**
+     * Format a single agent card into a summary object.
+     *
+     * @param card - The agent card to format.
+     * @param detail - Detail level — "name", "basic", "skills", or "full".
+     *
+     * @returns Summary object for the agent.
+     */
+    formatAgentForLlm(card, detail) {
+        if (detail === "name") {
+            return { name: card.name };
+        }
+        if (detail === "basic") {
+            return { name: card.name, description: card.description };
+        }
+        if (detail === "skills") {
+            const skillNames = card.skills ? card.skills.map((s) => s.name) : [];
+            return {
+                name: card.name,
+                description: card.description,
+                skills: skillNames,
+            };
+        }
+        // "full"
+        const skills = [];
+        if (card.skills) {
+            for (const s of card.skills) {
+                skills.push({ name: s.name, description: s.description ?? "" });
+            }
+        }
+        return {
+            name: card.name,
+            description: card.description,
+            skills,
+        };
+    }
+    /**
+     * Generate summary for a single agent.
+     *
+     * @param agentId - User-defined agent identifier.
+     * @param detail - Detail level — "name", "basic", "skills", or "full".
+     *
+     * @returns Summary object for the agent, or null if not found.
+     */
+    async getAgentForLlm(agentId, detail = "basic") {
+        await this.ensureInitialized();
+        const agent = this.agents[agentId];
+        if (!agent) {
+            return null;
+        }
+        return this.formatAgentForLlm(agent.agentCard, detail);
+    }
+    /**
+     * Generate summary of all agents.
+     *
+     * @param detail - Detail level — "name", "basic", "skills", or "full".
+     *
+     * @returns Object mapping agent_id to summary object, sorted by agent_id.
+     */
+    async getAgentsForLlm(detail = "basic") {
+        await this.ensureInitialized();
+        const result = {};
+        const sortedKeys = Object.keys(this.agents).sort();
+        for (const agentId of sortedKeys) {
+            result[agentId] = this.formatAgentForLlm(this.agents[agentId].agentCard, detail);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=a2a-agents.js.map

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

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

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

@@ -0,0 +1,94 @@
+/**
+ * A2ASession — main interface for interacting with A2A agents.
+ */
+import type { Message, Task } from "@a2a-js/sdk";
+import { type TaskStore } from "@a2a-js/sdk/server";
+import type { FileStore } from "../files/file-store.js";
+import type { A2AAgents } from "./a2a-agents.js";
+/** Main interface for sending messages to A2A agents. */
+export declare class A2ASession {
+    readonly agents: A2AAgents;
+    readonly taskStore: TaskStore;
+    readonly fileStore: FileStore | null;
+    private readonly sendMessageTimeout;
+    private readonly getTaskTimeout;
+    private readonly getTaskPollInterval;
+    constructor(agents: A2AAgents, opts?: {
+        taskStore?: TaskStore;
+        fileStore?: FileStore | null;
+        sendMessageTimeout?: number;
+        getTaskTimeout?: number;
+        getTaskPollInterval?: number;
+    });
+    /**
+     * Send a message to an A2A agent.
+     *
+     * @param agentId - Registered agent identifier.
+     * @param message - The message content to send.
+     * @param opts.contextId - Optional context ID to continue a conversation.
+     *     Auto-generated when null.
+     * @param opts.taskId - Optional task ID to attach to the message.
+     * @param opts.timeout - HTTP timeout in seconds. Defaults to sendMessageTimeout
+     *     from constructor.
+     *
+     * @returns Task for task responses, Message for message-only responses.
+     *
+     * @throws Error if agent is not found.
+     */
+    sendMessage(agentId: string, message: string, opts?: {
+        contextId?: string | null;
+        taskId?: string | null;
+        timeout?: number | null;
+    }): Promise<Task | Message>;
+    /**
+     * Get the current state of a task, monitoring until terminal/actionable state.
+     *
+     * If the remote agent supports streaming, uses SSE resubscription for real-time
+     * updates. Otherwise, polls at regular intervals.
+     *
+     * On monitoring timeout, returns the current task state (which may still be
+     * non-terminal, e.g. "working"). The only errors from getTask are failed
+     * HTTP requests (agent down, network error).
+     *
+     * @param agentId - Registered agent identifier.
+     * @param taskId - Task ID from a previous sendMessage call.
+     * @param opts.timeout - Total monitoring timeout in seconds. Defaults to
+     *     getTaskTimeout from constructor.
+     * @param opts.pollInterval - Interval between polls in seconds (used when streaming
+     *     is not supported). Defaults to getTaskPollInterval from constructor.
+     *
+     * @returns Task with the current task state. If monitoring times out, the
+     *     returned task may still be in a non-terminal state.
+     *
+     * @throws Error if agent is not found.
+     */
+    getTask(agentId: string, taskId: string, opts?: {
+        timeout?: number | null;
+        pollInterval?: number | null;
+    }): Promise<Task>;
+    /**
+     * Save file artifacts to the file store if configured.
+     *
+     * Idempotent: skips artifacts whose files have already been saved.
+     */
+    private saveFiles;
+    /** Monitor a task via SSE resubscription, falling back to a final fetch. */
+    private getTaskStreaming;
+    /** Monitor a task by polling at regular intervals. */
+    private getTaskPolling;
+    /** Fetch a task via A2AClient.getTask(). */
+    private fetchTask;
+    /** Narrow the SDK client to the methods this package relies on. */
+    private getSessionClient;
+    /** Create an A2AClient with optional custom headers. */
+    private createClient;
+    /**
+     * Resolve agent card and headers.
+     *
+     * @returns Tuple of [AgentCard, headers_dict].
+     *
+     * @throws Error if agent cannot be resolved.
+     */
+    private resolveAgent;
+}
+//# sourceMappingURL=a2a-session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-session.d.ts","sourceRoot":"","sources":["../../src/client/a2a-session.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,EAGR,OAAO,EAEP,IAAI,EAGP,MAAM,aAAa,CAAC;AAErB,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAuBjD,yDAAyD;AACzD,qBAAa,UAAU;IACnB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IACrC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;gBAGzC,MAAM,EAAE,SAAS,EACjB,IAAI,CAAC,EAAE;QACH,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;QAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAChC;IAUL;;;;;;;;;;;;;;OAcG;IACG,WAAW,CACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,GACF,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC;IAwF1B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,OAAO,CACT,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;QACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC,GACF,OAAO,CAAC,IAAI,CAAC;IAkChB;;;;OAIG;YACW,SAAS;IAgBvB,4EAA4E;YAC9D,gBAAgB;IAwC9B,sDAAsD;YACxC,cAAc;IAwB5B,4CAA4C;YAC9B,SAAS;IAevB,mEAAmE;IACnE,OAAO,CAAC,gBAAgB;IAIxB,wDAAwD;IACxD,OAAO,CAAC,YAAY;IAmBpB;;;;;;OAMG;YACW,YAAY;CAS7B"}

package/dist/client/a2a-session.js

@@ -0,0 +1,264 @@
+// SPDX-FileCopyrightText: 2025-present A2A Net <hello@a2anet.com>
+//
+// SPDX-License-Identifier: Apache-2.0
+import { A2AClient } from "@a2a-js/sdk/client";
+import { InMemoryTaskStore } from "@a2a-js/sdk/server";
+import { v4 as uuidv4 } from "uuid";
+import { TERMINAL_OR_ACTIONABLE_STATES } from "../types.js";
+function sleep(seconds) {
+    return new Promise((resolve) => setTimeout(resolve, seconds * 1000));
+}
+/** Main interface for sending messages to A2A agents. */
+export class A2ASession {
+    agents;
+    taskStore;
+    fileStore;
+    sendMessageTimeout;
+    getTaskTimeout;
+    getTaskPollInterval;
+    constructor(agents, opts) {
+        this.agents = agents;
+        this.taskStore = opts?.taskStore ?? new InMemoryTaskStore();
+        this.fileStore = opts?.fileStore ?? null;
+        this.sendMessageTimeout = opts?.sendMessageTimeout ?? 60.0;
+        this.getTaskTimeout = opts?.getTaskTimeout ?? 60.0;
+        this.getTaskPollInterval = opts?.getTaskPollInterval ?? 5.0;
+    }
+    /**
+     * Send a message to an A2A agent.
+     *
+     * @param agentId - Registered agent identifier.
+     * @param message - The message content to send.
+     * @param opts.contextId - Optional context ID to continue a conversation.
+     *     Auto-generated when null.
+     * @param opts.taskId - Optional task ID to attach to the message.
+     * @param opts.timeout - HTTP timeout in seconds. Defaults to sendMessageTimeout
+     *     from constructor.
+     *
+     * @returns Task for task responses, Message for message-only responses.
+     *
+     * @throws Error if agent is not found.
+     */
+    async sendMessage(agentId, message, opts) {
+        const [agentCard, headers] = await this.resolveAgent(agentId);
+        const contextId = opts?.contextId ?? uuidv4();
+        // Build A2A message
+        const a2aMessage = {
+            kind: "message",
+            messageId: uuidv4(),
+            parts: [{ kind: "text", text: message }],
+            role: "user",
+            contextId,
+        };
+        if (opts?.taskId != null) {
+            a2aMessage.taskId = opts.taskId;
+        }
+        const effectiveTimeout = opts?.timeout !== undefined && opts?.timeout !== null
+            ? opts.timeout
+            : this.sendMessageTimeout;
+        const start = performance.now();
+        const client = this.createClient(agentCard, headers);
+        const response = await this.getSessionClient(client).sendMessage({
+            message: a2aMessage,
+            configuration: { blocking: false },
+        }, { signal: AbortSignal.timeout(effectiveTimeout * 1000) });
+        if ("error" in response) {
+            throw new Error(`JSON-RPC error: ${response.error.message} (code: ${response.error.code})`);
+        }
+        const result = response.result;
+        // Handle Message result
+        if (result.kind === "message") {
+            return result;
+        }
+        // Handle Task result
+        if (result.kind !== "task") {
+            throw new Error("Expected Task or Message response, got unexpected kind");
+        }
+        let task = result;
+        await this.taskStore.save(task);
+        // If task is already in a terminal/actionable state, save files and return
+        if (TERMINAL_OR_ACTIONABLE_STATES.has(task.status.state)) {
+            await this.saveFiles(task);
+            return task;
+        }
+        // Task is in a non-terminal state (e.g. working) — monitor with remaining time
+        const elapsed = (performance.now() - start) / 1000;
+        const remaining = Math.max(0, effectiveTimeout - elapsed);
+        if (remaining > 0) {
+            const supportsStreaming = agentCard.capabilities !== undefined &&
+                agentCard.capabilities !== null &&
+                agentCard.capabilities.streaming === true;
+            if (supportsStreaming) {
+                task = await this.getTaskStreaming(agentCard, headers, task.id, remaining);
+            }
+            else {
+                task = await this.getTaskPolling(agentCard, headers, task.id, remaining, this.getTaskPollInterval);
+            }
+            await this.taskStore.save(task);
+        }
+        await this.saveFiles(task);
+        return task;
+    }
+    /**
+     * Get the current state of a task, monitoring until terminal/actionable state.
+     *
+     * If the remote agent supports streaming, uses SSE resubscription for real-time
+     * updates. Otherwise, polls at regular intervals.
+     *
+     * On monitoring timeout, returns the current task state (which may still be
+     * non-terminal, e.g. "working"). The only errors from getTask are failed
+     * HTTP requests (agent down, network error).
+     *
+     * @param agentId - Registered agent identifier.
+     * @param taskId - Task ID from a previous sendMessage call.
+     * @param opts.timeout - Total monitoring timeout in seconds. Defaults to
+     *     getTaskTimeout from constructor.
+     * @param opts.pollInterval - Interval between polls in seconds (used when streaming
+     *     is not supported). Defaults to getTaskPollInterval from constructor.
+     *
+     * @returns Task with the current task state. If monitoring times out, the
+     *     returned task may still be in a non-terminal state.
+     *
+     * @throws Error if agent is not found.
+     */
+    async getTask(agentId, taskId, opts) {
+        const [agentCard, headers] = await this.resolveAgent(agentId);
+        const effectiveTimeout = opts?.timeout !== undefined && opts?.timeout !== null
+            ? opts.timeout
+            : this.getTaskTimeout;
+        const effectivePollInterval = opts?.pollInterval !== undefined && opts?.pollInterval !== null
+            ? opts.pollInterval
+            : this.getTaskPollInterval;
+        const supportsStreaming = agentCard.capabilities !== undefined &&
+            agentCard.capabilities !== null &&
+            agentCard.capabilities.streaming === true;
+        let task;
+        if (supportsStreaming) {
+            task = await this.getTaskStreaming(agentCard, headers, taskId, effectiveTimeout);
+        }
+        else {
+            task = await this.getTaskPolling(agentCard, headers, taskId, effectiveTimeout, effectivePollInterval);
+        }
+        await this.taskStore.save(task);
+        await this.saveFiles(task);
+        return task;
+    }
+    /**
+     * Save file artifacts to the file store if configured.
+     *
+     * Idempotent: skips artifacts whose files have already been saved.
+     */
+    async saveFiles(task) {
+        if (this.fileStore === null || !task.artifacts) {
+            return;
+        }
+        for (const artifact of task.artifacts) {
+            const hasFiles = artifact.parts.some((p) => p.kind === "file");
+            if (hasFiles) {
+                const existing = await this.fileStore.get(task.id, artifact.artifactId);
+                if (existing.length === 0) {
+                    await this.fileStore.save(task.id, artifact);
+                }
+            }
+        }
+    }
+    /** Monitor a task via SSE resubscription, falling back to a final fetch. */
+    async getTaskStreaming(agentCard, headers, taskId, timeout) {
+        const client = this.createClient(agentCard, headers);
+        const params = { id: taskId };
+        try {
+            const stream = this.getSessionClient(client).resubscribeTask(params, {
+                signal: AbortSignal.timeout(timeout * 1000),
+            });
+            for await (const event of stream) {
+                if (event.kind === "status-update") {
+                    const statusEvent = event;
+                    if (TERMINAL_OR_ACTIONABLE_STATES.has(statusEvent.status.state)) {
+                        break;
+                    }
+                }
+                else if (event.kind === "task") {
+                    const taskEvent = event;
+                    if (TERMINAL_OR_ACTIONABLE_STATES.has(taskEvent.status.state)) {
+                        break;
+                    }
+                }
+            }
+        }
+        catch (e) {
+            if (e instanceof DOMException && e.name === "AbortError") {
+                console.info(`Task ${taskId} still in working state after ${timeout}s`);
+            }
+            else {
+                throw e;
+            }
+        }
+        // Final fetch to get the complete Task with all artifacts
+        return this.fetchTask(client, taskId, timeout);
+    }
+    /** Monitor a task by polling at regular intervals. */
+    async getTaskPolling(agentCard, headers, taskId, timeout, pollInterval) {
+        const client = this.createClient(agentCard, headers);
+        const start = performance.now();
+        while (true) {
+            const task = await this.fetchTask(client, taskId, timeout);
+            if (TERMINAL_OR_ACTIONABLE_STATES.has(task.status.state)) {
+                return task;
+            }
+            const elapsed = (performance.now() - start) / 1000;
+            if (elapsed >= timeout) {
+                console.info(`Task ${taskId} still in working state after ${timeout}s`);
+                return task;
+            }
+            await sleep(pollInterval);
+        }
+    }
+    /** Fetch a task via A2AClient.getTask(). */
+    async fetchTask(client, taskId, timeout) {
+        const response = await this.getSessionClient(client).getTask({ id: taskId }, timeout !== undefined ? { signal: AbortSignal.timeout(timeout * 1000) } : undefined);
+        if ("error" in response) {
+            throw new Error(`JSON-RPC error: ${response.error.message} (code: ${response.error.code})`);
+        }
+        return response.result;
+    }
+    /** Narrow the SDK client to the methods this package relies on. */
+    getSessionClient(client) {
+        return client;
+    }
+    /** Create an A2AClient with optional custom headers. */
+    createClient(agentCard, headers) {
+        if (Object.keys(headers).length > 0) {
+            const customHeaders = headers;
+            const wrappedFetch = (input, init) => {
+                const mergedInit = {
+                    ...init,
+                    headers: {
+                        ...init?.headers,
+                        ...customHeaders,
+                    },
+                };
+                return fetch(input, mergedInit);
+            };
+            wrappedFetch.preconnect = fetch.preconnect;
+            return new A2AClient(agentCard, { fetchImpl: wrappedFetch });
+        }
+        return new A2AClient(agentCard);
+    }
+    /**
+     * Resolve agent card and headers.
+     *
+     * @returns Tuple of [AgentCard, headers_dict].
+     *
+     * @throws Error if agent cannot be resolved.
+     */
+    async resolveAgent(agentId) {
+        const agent = await this.agents.getAgent(agentId);
+        if (agent === null) {
+            const agents = await this.agents.getAgents();
+            const available = Object.keys(agents).sort().join(", ");
+            throw new Error(`Agent '${agentId}' not found. Available agents: ${available}`);
+        }
+        return [agent.agentCard, agent.customHeaders];
+    }
+}
+//# sourceMappingURL=a2a-session.js.map

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

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