@illuma-ai/agents 1.3.2 → 1.4.0-alpha.1

package/dist/esm/providers/a2a/A2ACapabilityProvider.mjs

@@ -0,0 +1,281 @@
+import { tool } from '@langchain/core/tools';
+import { CapabilityKind } from '../types.mjs';
+import { formatCapabilityName, parseCapabilityName as parseCapabilityName$1 } from '../capabilityNaming.mjs';
+export { CAPABILITY_NAME_SEPARATOR } from '../capabilityNaming.mjs';
+import { A2AClient, generateRpcId, extractTaskText } from './client.mjs';
+import { getA2AEnvDefaults, consoleLogger } from './config.mjs';
+
+/**
+ * A2ACapabilityProvider — client-side adapter for consuming A2A-served
+ * remote agents as capabilities.
+ *
+ * Same pattern as `MCPCapabilityProvider`: take a unified spec map,
+ * speak the protocol (A2A JSON-RPC over HTTP), expose each skill as a
+ * `Capability` / `StructuredTool`.
+ *
+ * Design:
+ *   - One `A2AClient` per remote spec, cached after first use.
+ *   - `fetchManifest()`:
+ *       for each remote, GET /.well-known/agent.json → emit one
+ *       Capability per advertised skill (or one per remote when
+ *       `flattenAsSingleTool` is set).
+ *   - `createRunnables()`:
+ *       each Capability becomes a StructuredTool whose invoke sends a
+ *       JSON-RPC `tasks/send` to the remote and returns the final
+ *       artifact's text.
+ *
+ * What the host supplies:
+ *   - `remotes`: unified spec map (normalized from whatever source).
+ *   - `getAuthHeaders?`: per-remote header resolver. Called at connect
+ *     time. OAuth / token refresh stays in the host.
+ */
+class A2ACapabilityProvider {
+    providerId;
+    config;
+    logger;
+    connections = new Map();
+    constructor(config) {
+        if (!config.remotes || Object.keys(config.remotes).length === 0) {
+            throw new Error('A2ACapabilityProvider: at least one remote is required');
+        }
+        const env = getA2AEnvDefaults();
+        this.config = {
+            remotes: config.remotes,
+            getAuthHeaders: config.getAuthHeaders,
+            clientInfo: config.clientInfo ?? {
+                name: env.clientName,
+                version: env.clientVersion,
+            },
+            timeoutMs: config.timeoutMs ?? env.timeoutMs,
+        };
+        this.logger = config.logger ?? consoleLogger;
+        const names = Object.keys(config.remotes).sort().join(',');
+        this.providerId = `a2a:${names}`;
+    }
+    async fetchManifest(filter) {
+        if (filter?.kind && filter.kind !== CapabilityKind.A2A)
+            return [];
+        const capabilities = [];
+        for (const remoteName of Object.keys(this.config.remotes)) {
+            try {
+                const conn = await this.ensureConnection(remoteName);
+                const caps = this.cardToCapabilities(remoteName, conn.card, conn.spec);
+                for (const cap of caps) {
+                    if (this.capabilityMatchesFilter(cap, filter))
+                        capabilities.push(cap);
+                }
+            }
+            catch (err) {
+                // One remote failing must not block others — log and continue.
+                this.logger.warn(`[a2a] failed to fetch manifest for remote "${remoteName}":`, err instanceof Error ? err.message : err);
+            }
+        }
+        this.logger.debug(`[a2a] manifest assembled — ${capabilities.length} capabilities across ${this.connections.size}/${Object.keys(this.config.remotes).length} connected remotes`);
+        return capabilities;
+    }
+    async createRunnables(capabilities, _credentials) {
+        const runnables = [];
+        for (const cap of capabilities) {
+            if (cap.kind !== CapabilityKind.A2A)
+                continue;
+            const parsed = parseCapabilityName(cap.name);
+            if (!parsed) {
+                this.logger.warn(`[a2a] skipping capability "${cap.name}" — unparseable`);
+                continue;
+            }
+            runnables.push(this.buildProxyTool(parsed.remoteName, parsed.skillId, cap));
+        }
+        return runnables;
+    }
+    /** Disconnect any cached clients. A2A is stateless over HTTP so this
+     *  is effectively a cache clear — no sockets to close. */
+    async close() {
+        this.connections.clear();
+    }
+    // --- internals ---------------------------------------------------------
+    async ensureConnection(remoteName) {
+        const existing = this.connections.get(remoteName);
+        if (existing)
+            return existing;
+        const spec = this.config.remotes[remoteName];
+        if (!spec) {
+            throw new Error(`[a2a] remote "${remoteName}" not in config`);
+        }
+        const authHeaders = await this.resolveAuthHeaders(remoteName);
+        const headers = {
+            ...(spec.headers ?? {}),
+            ...(authHeaders ?? {}),
+            'user-agent': `${this.config.clientInfo.name}/${this.config.clientInfo.version}`,
+        };
+        const client = new A2AClient({
+            baseUrl: spec.url,
+            headers,
+            timeoutMs: this.config.timeoutMs,
+            cardPath: spec.cardPath,
+            rpcPath: spec.rpcPath,
+        });
+        this.logger.debug(`[a2a] fetching card from "${remoteName}" at ${spec.url}`);
+        const card = await client.fetchAgentCard();
+        this.logger.debug(`[a2a] connected to "${remoteName}" — ${card.skills.length ?? 0} skills discovered`);
+        const conn = { remoteName, spec, client, card };
+        this.connections.set(remoteName, conn);
+        return conn;
+    }
+    async resolveAuthHeaders(remoteName) {
+        if (!this.config.getAuthHeaders)
+            return undefined;
+        try {
+            return await this.config.getAuthHeaders(remoteName);
+        }
+        catch (err) {
+            this.logger.warn(`[a2a] getAuthHeaders("${remoteName}") threw:`, err instanceof Error ? err.message : err);
+            return undefined;
+        }
+    }
+    cardToCapabilities(remoteName, card, spec) {
+        if (spec.flattenAsSingleTool) {
+            // One capability per remote, named after the remote. Useful when
+            // the card has no skills listed or you want coarse routing.
+            return [
+                {
+                    kind: CapabilityKind.A2A,
+                    name: formatCapabilityName(remoteName),
+                    description: card.description ?? card.name,
+                    schema: MESSAGE_INPUT_SCHEMA,
+                    authConfig: [],
+                    metadata: {
+                        category: 'a2a',
+                        tags: [remoteName, ...(card.skills.map((s) => s.id) ?? [])],
+                    },
+                },
+            ];
+        }
+        if (!card.skills || card.skills.length === 0) {
+            // No skills advertised — expose a single message endpoint so the
+            // agent can still invoke the remote with free-form text.
+            return [
+                {
+                    kind: CapabilityKind.A2A,
+                    name: formatCapabilityName(remoteName),
+                    description: card.description ?? `Delegate to remote agent "${card.name}".`,
+                    schema: MESSAGE_INPUT_SCHEMA,
+                    authConfig: [],
+                    metadata: { category: 'a2a', tags: [remoteName] },
+                },
+            ];
+        }
+        return card.skills.map((skill) => skillToCapability(remoteName, skill));
+    }
+    capabilityMatchesFilter(cap, filter) {
+        if (!filter)
+            return true;
+        if (filter.kind && cap.kind !== filter.kind)
+            return false;
+        if (filter.names && !filter.names.includes(cap.name))
+            return false;
+        if (filter.tags?.length) {
+            const capTags = new Set(cap.metadata.tags ?? []);
+            if (!filter.tags.some((t) => capTags.has(t)))
+                return false;
+        }
+        return true;
+    }
+    buildProxyTool(remoteName, skillId, cap) {
+        const logger = this.logger;
+        const ensureConnection = this.ensureConnection.bind(this);
+        return tool(async (input) => {
+            // DEBUG: log tool invocation (remove after POC stabilizes)
+            logger.debug(`[a2a] invoking ${remoteName}${skillId ? `:${skillId}` : ''}`);
+            const message = coerceInputToA2AMessage(input, skillId);
+            const conn = await ensureConnection(remoteName);
+            const task = await conn.client.sendTask({
+                id: generateRpcId(),
+                message,
+            });
+            try {
+                return extractTaskText(task);
+            }
+            catch (err) {
+                throw new Error(`A2A ${remoteName}${skillId ? `:${skillId}` : ''} failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }, {
+            name: cap.name,
+            description: cap.description,
+            schema: cap.schema ?? MESSAGE_INPUT_SCHEMA,
+            responseFormat: 'content',
+        });
+    }
+}
+/**
+ * Parse a capability name produced by this provider, returning A2A-specific
+ * field names (`remoteName` / `skillId`). Thin adapter over the shared
+ * `parseCapabilityName` — kept local so callers see the A2A vocabulary.
+ */
+function parseCapabilityName(name) {
+    const parsed = parseCapabilityName$1(name);
+    if (!parsed)
+        return null;
+    return {
+        remoteName: parsed.sourceName,
+        skillId: parsed.itemName,
+    };
+}
+/** Derive a Capability from a skill entry on the agent card. */
+function skillToCapability(remoteName, skill) {
+    return {
+        kind: CapabilityKind.A2A,
+        name: formatCapabilityName(remoteName, skill.id),
+        description: skill.description || skill.name || skill.id,
+        schema: MESSAGE_INPUT_SCHEMA,
+        authConfig: [],
+        metadata: {
+            category: 'a2a',
+            tags: [remoteName, ...(skill.tags ?? [])],
+        },
+    };
+}
+/**
+ * Default input schema for A2A capabilities. Every invocation is a text
+ * message — we don't try to infer a per-skill input shape because the
+ * A2A spec's skill entries don't include a parameter schema.
+ */
+const MESSAGE_INPUT_SCHEMA = {
+    type: 'object',
+    properties: {
+        message: {
+            type: 'string',
+            description: 'Instruction or question to send to the remote agent as a user message.',
+        },
+    },
+    required: ['message'],
+};
+/**
+ * Coerce arbitrary LLM-supplied input into a valid A2A message. If the
+ * input is a string, wraps it directly. If it's `{ message: "..." }`,
+ * uses `message`. Otherwise JSON-stringifies so the agent receives
+ * something it can try to interpret.
+ *
+ * When a skill id is known, it's prepended to the message text so the
+ * remote agent can route — some A2A implementations use this, others
+ * ignore it, it's best-effort.
+ */
+function coerceInputToA2AMessage(input, skillId) {
+    let text;
+    if (typeof input === 'string') {
+        text = input;
+    }
+    else if (input && typeof input === 'object' && 'message' in input) {
+        const val = input.message;
+        text = typeof val === 'string' ? val : JSON.stringify(val);
+    }
+    else {
+        text = JSON.stringify(input);
+    }
+    if (skillId) {
+        text = `[skill: ${skillId}]\n${text}`;
+    }
+    return { role: 'user', parts: [{ type: 'text', text }] };
+}
+
+export { A2ACapabilityProvider, MESSAGE_INPUT_SCHEMA, coerceInputToA2AMessage, formatCapabilityName, parseCapabilityName, skillToCapability };
+//# sourceMappingURL=A2ACapabilityProvider.mjs.map

package/dist/esm/providers/a2a/A2ACapabilityProvider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"A2ACapabilityProvider.mjs","sources":["../../../../src/providers/a2a/A2ACapabilityProvider.ts"],"sourcesContent":["/**\n * A2ACapabilityProvider — client-side adapter for consuming A2A-served\n * remote agents as capabilities.\n *\n * Same pattern as `MCPCapabilityProvider`: take a unified spec map,\n * speak the protocol (A2A JSON-RPC over HTTP), expose each skill as a\n * `Capability` / `StructuredTool`.\n *\n * Design:\n *   - One `A2AClient` per remote spec, cached after first use.\n *   - `fetchManifest()`:\n *       for each remote, GET /.well-known/agent.json → emit one\n *       Capability per advertised skill (or one per remote when\n *       `flattenAsSingleTool` is set).\n *   - `createRunnables()`:\n *       each Capability becomes a StructuredTool whose invoke sends a\n *       JSON-RPC `tasks/send` to the remote and returns the final\n *       artifact's text.\n *\n * What the host supplies:\n *   - `remotes`: unified spec map (normalized from whatever source).\n *   - `getAuthHeaders?`: per-remote header resolver. Called at connect\n *     time. OAuth / token refresh stays in the host.\n */\n\nimport { tool, type StructuredToolInterface } from '@langchain/core/tools';\n\nimport {\n  CapabilityKind,\n  type Capability,\n  type CapabilityFilter,\n  type CapabilityProvider,\n  type CredentialMap,\n} from '@/providers/types';\nimport {\n  CAPABILITY_NAME_SEPARATOR,\n  formatCapabilityName,\n  parseCapabilityName as parseSharedName,\n} from '@/providers/capabilityNaming';\nimport { A2AClient, extractTaskText, generateRpcId } from './client';\nimport { consoleLogger, getA2AEnvDefaults } from './config';\nimport type {\n  A2AAgentCard,\n  A2ALogger,\n  A2AProviderConfig,\n  A2ARemoteSpec,\n  A2ASkill,\n} from './types';\n\n/**\n * Per-remote cached state. The agent card is fetched lazily and reused.\n */\ninterface RemoteConnection {\n  remoteName: string;\n  spec: A2ARemoteSpec;\n  client: A2AClient;\n  card: A2AAgentCard;\n}\n\nexport class A2ACapabilityProvider implements CapabilityProvider {\n  readonly providerId: string;\n  private readonly config: Required<\n    Pick<A2AProviderConfig, 'clientInfo' | 'timeoutMs'>\n  > &\n    Pick<A2AProviderConfig, 'remotes' | 'getAuthHeaders'>;\n  private readonly logger: A2ALogger;\n  private readonly connections = new Map<string, RemoteConnection>();\n\n  constructor(config: A2AProviderConfig) {\n    if (!config.remotes || Object.keys(config.remotes).length === 0) {\n      throw new Error('A2ACapabilityProvider: at least one remote is required');\n    }\n    const env = getA2AEnvDefaults();\n    this.config = {\n      remotes: config.remotes,\n      getAuthHeaders: config.getAuthHeaders,\n      clientInfo: config.clientInfo ?? {\n        name: env.clientName,\n        version: env.clientVersion,\n      },\n      timeoutMs: config.timeoutMs ?? env.timeoutMs,\n    };\n    this.logger = config.logger ?? consoleLogger;\n    const names = Object.keys(config.remotes).sort().join(',');\n    this.providerId = `a2a:${names}`;\n  }\n\n  async fetchManifest(filter?: CapabilityFilter): Promise<Capability[]> {\n    if (filter?.kind && filter.kind !== CapabilityKind.A2A) return [];\n\n    const capabilities: Capability[] = [];\n    for (const remoteName of Object.keys(this.config.remotes)) {\n      try {\n        const conn = await this.ensureConnection(remoteName);\n        const caps = this.cardToCapabilities(remoteName, conn.card, conn.spec);\n        for (const cap of caps) {\n          if (this.capabilityMatchesFilter(cap, filter)) capabilities.push(cap);\n        }\n      } catch (err) {\n        // One remote failing must not block others — log and continue.\n        this.logger.warn(\n          `[a2a] failed to fetch manifest for remote \"${remoteName}\":`,\n          err instanceof Error ? err.message : err\n        );\n      }\n    }\n\n    this.logger.debug(\n      `[a2a] manifest assembled — ${capabilities.length} capabilities across ${this.connections.size}/${Object.keys(this.config.remotes).length} connected remotes`\n    );\n\n    return capabilities;\n  }\n\n  async createRunnables(\n    capabilities: Capability[],\n    _credentials: CredentialMap\n  ): Promise<StructuredToolInterface[]> {\n    const runnables: StructuredToolInterface[] = [];\n    for (const cap of capabilities) {\n      if (cap.kind !== CapabilityKind.A2A) continue;\n      const parsed = parseCapabilityName(cap.name);\n      if (!parsed) {\n        this.logger.warn(\n          `[a2a] skipping capability \"${cap.name}\" — unparseable`\n        );\n        continue;\n      }\n      runnables.push(\n        this.buildProxyTool(parsed.remoteName, parsed.skillId, cap)\n      );\n    }\n    return runnables;\n  }\n\n  /** Disconnect any cached clients. A2A is stateless over HTTP so this\n   *  is effectively a cache clear — no sockets to close. */\n  async close(): Promise<void> {\n    this.connections.clear();\n  }\n\n  // --- internals ---------------------------------------------------------\n\n  private async ensureConnection(\n    remoteName: string\n  ): Promise<RemoteConnection> {\n    const existing = this.connections.get(remoteName);\n    if (existing) return existing;\n\n    const spec = this.config.remotes[remoteName];\n    if (!spec) {\n      throw new Error(`[a2a] remote \"${remoteName}\" not in config`);\n    }\n\n    const authHeaders = await this.resolveAuthHeaders(remoteName);\n    const headers = {\n      ...(spec.headers ?? {}),\n      ...(authHeaders ?? {}),\n      'user-agent': `${this.config.clientInfo.name}/${this.config.clientInfo.version}`,\n    };\n\n    const client = new A2AClient({\n      baseUrl: spec.url,\n      headers,\n      timeoutMs: this.config.timeoutMs,\n      cardPath: spec.cardPath,\n      rpcPath: spec.rpcPath,\n    });\n\n    this.logger.debug(\n      `[a2a] fetching card from \"${remoteName}\" at ${spec.url}`\n    );\n    const card = await client.fetchAgentCard();\n    this.logger.debug(\n      `[a2a] connected to \"${remoteName}\" — ${card.skills.length ?? 0} skills discovered`\n    );\n\n    const conn: RemoteConnection = { remoteName, spec, client, card };\n    this.connections.set(remoteName, conn);\n    return conn;\n  }\n\n  private async resolveAuthHeaders(\n    remoteName: string\n  ): Promise<Record<string, string> | undefined> {\n    if (!this.config.getAuthHeaders) return undefined;\n    try {\n      return await this.config.getAuthHeaders(remoteName);\n    } catch (err) {\n      this.logger.warn(\n        `[a2a] getAuthHeaders(\"${remoteName}\") threw:`,\n        err instanceof Error ? err.message : err\n      );\n      return undefined;\n    }\n  }\n\n  private cardToCapabilities(\n    remoteName: string,\n    card: A2AAgentCard,\n    spec: A2ARemoteSpec\n  ): Capability[] {\n    if (spec.flattenAsSingleTool) {\n      // One capability per remote, named after the remote. Useful when\n      // the card has no skills listed or you want coarse routing.\n      return [\n        {\n          kind: CapabilityKind.A2A,\n          name: formatCapabilityName(remoteName),\n          description: card.description ?? card.name,\n          schema: MESSAGE_INPUT_SCHEMA,\n          authConfig: [],\n          metadata: {\n            category: 'a2a',\n            tags: [remoteName, ...(card.skills.map((s) => s.id) ?? [])],\n          },\n        },\n      ];\n    }\n\n    if (!card.skills || card.skills.length === 0) {\n      // No skills advertised — expose a single message endpoint so the\n      // agent can still invoke the remote with free-form text.\n      return [\n        {\n          kind: CapabilityKind.A2A,\n          name: formatCapabilityName(remoteName),\n          description:\n            card.description ?? `Delegate to remote agent \"${card.name}\".`,\n          schema: MESSAGE_INPUT_SCHEMA,\n          authConfig: [],\n          metadata: { category: 'a2a', tags: [remoteName] },\n        },\n      ];\n    }\n\n    return card.skills.map(\n      (skill): Capability => skillToCapability(remoteName, skill)\n    );\n  }\n\n  private capabilityMatchesFilter(\n    cap: Capability,\n    filter?: CapabilityFilter\n  ): boolean {\n    if (!filter) return true;\n    if (filter.kind && cap.kind !== filter.kind) return false;\n    if (filter.names && !filter.names.includes(cap.name)) return false;\n    if (filter.tags?.length) {\n      const capTags = new Set(cap.metadata.tags ?? []);\n      if (!filter.tags.some((t) => capTags.has(t))) return false;\n    }\n    return true;\n  }\n\n  private buildProxyTool(\n    remoteName: string,\n    skillId: string | undefined,\n    cap: Capability\n  ): StructuredToolInterface {\n    const logger = this.logger;\n    const ensureConnection = this.ensureConnection.bind(this);\n\n    return tool(\n      async (input: unknown): Promise<string> => {\n        // DEBUG: log tool invocation (remove after POC stabilizes)\n        logger.debug(\n          `[a2a] invoking ${remoteName}${skillId ? `:${skillId}` : ''}`\n        );\n\n        const message = coerceInputToA2AMessage(input, skillId);\n        const conn = await ensureConnection(remoteName);\n        const task = await conn.client.sendTask({\n          id: generateRpcId(),\n          message,\n        });\n\n        try {\n          return extractTaskText(task);\n        } catch (err) {\n          throw new Error(\n            `A2A ${remoteName}${skillId ? `:${skillId}` : ''} failed: ${err instanceof Error ? err.message : String(err)}`\n          );\n        }\n      },\n      {\n        name: cap.name,\n        description: cap.description,\n        schema: (cap.schema as object) ?? MESSAGE_INPUT_SCHEMA,\n        responseFormat: 'content',\n      }\n    );\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Helpers exported for testing\n// ---------------------------------------------------------------------------\n\n// CAPABILITY_NAME_SEPARATOR + formatCapabilityName live in the shared\n// `@/providers/capabilityNaming` module so every provider uses the same\n// encoding. Re-exported here for backward-compatible imports from the\n// A2A barrel.\nexport { CAPABILITY_NAME_SEPARATOR, formatCapabilityName };\n\n/**\n * Parse a capability name produced by this provider, returning A2A-specific\n * field names (`remoteName` / `skillId`). Thin adapter over the shared\n * `parseCapabilityName` — kept local so callers see the A2A vocabulary.\n */\nexport function parseCapabilityName(\n  name: string\n): { remoteName: string; skillId?: string } | null {\n  const parsed = parseSharedName(name);\n  if (!parsed) return null;\n  return {\n    remoteName: parsed.sourceName,\n    skillId: parsed.itemName,\n  };\n}\n\n/** Derive a Capability from a skill entry on the agent card. */\nexport function skillToCapability(\n  remoteName: string,\n  skill: A2ASkill\n): Capability {\n  return {\n    kind: CapabilityKind.A2A,\n    name: formatCapabilityName(remoteName, skill.id),\n    description: skill.description || skill.name || skill.id,\n    schema: MESSAGE_INPUT_SCHEMA,\n    authConfig: [],\n    metadata: {\n      category: 'a2a',\n      tags: [remoteName, ...(skill.tags ?? [])],\n    },\n  };\n}\n\n/**\n * Default input schema for A2A capabilities. Every invocation is a text\n * message — we don't try to infer a per-skill input shape because the\n * A2A spec's skill entries don't include a parameter schema.\n */\nexport const MESSAGE_INPUT_SCHEMA = {\n  type: 'object',\n  properties: {\n    message: {\n      type: 'string',\n      description:\n        'Instruction or question to send to the remote agent as a user message.',\n    },\n  },\n  required: ['message'],\n} as const;\n\n/**\n * Coerce arbitrary LLM-supplied input into a valid A2A message. If the\n * input is a string, wraps it directly. If it's `{ message: \"...\" }`,\n * uses `message`. Otherwise JSON-stringifies so the agent receives\n * something it can try to interpret.\n *\n * When a skill id is known, it's prepended to the message text so the\n * remote agent can route — some A2A implementations use this, others\n * ignore it, it's best-effort.\n */\nexport function coerceInputToA2AMessage(\n  input: unknown,\n  skillId?: string\n): { role: 'user'; parts: Array<{ type: 'text'; text: string }> } {\n  let text: string;\n  if (typeof input === 'string') {\n    text = input;\n  } else if (input && typeof input === 'object' && 'message' in input) {\n    const val = (input as { message: unknown }).message;\n    text = typeof val === 'string' ? val : JSON.stringify(val);\n  } else {\n    text = JSON.stringify(input);\n  }\n  if (skillId) {\n    text = `[skill: ${skillId}]\\n${text}`;\n  }\n  return { role: 'user', parts: [{ type: 'text', text }] };\n}\n"],"names":["parseSharedName"],"mappings":"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"}

package/dist/esm/providers/a2a/client.mjs

@@ -0,0 +1,88 @@
+import { createHttpClient, assertOk } from '../../utils/httpClient.mjs';
+
+/**
+ * A2A HTTP client — thin wrappers for the two operations the provider
+ * needs: fetching the agent card and sending JSON-RPC task requests.
+ *
+ * Uses axios (already in deps) via the shared httpClient utility so
+ * proxy config + headers work consistently with the tools-server provider.
+ */
+const DEFAULT_CARD_PATH = '/.well-known/agent.json';
+const DEFAULT_RPC_PATH = '/';
+const JSON_RPC_VERSION = '2.0';
+/**
+ * Lightweight single-remote A2A client. One instance per remote; the
+ * provider builds one per spec entry and caches them.
+ */
+class A2AClient {
+    http;
+    cardPath;
+    rpcPath;
+    constructor(opts) {
+        this.http = createHttpClient({
+            baseURL: opts.baseUrl,
+            headers: opts.headers,
+            timeoutMs: opts.timeoutMs,
+        });
+        this.cardPath = opts.cardPath ?? DEFAULT_CARD_PATH;
+        this.rpcPath = opts.rpcPath ?? DEFAULT_RPC_PATH;
+    }
+    /** GET /.well-known/agent.json (or the configured override). */
+    async fetchAgentCard() {
+        const res = await this.http.get(this.cardPath);
+        assertOk(res.status, this.cardPath, res.data);
+        return res.data;
+    }
+    /**
+     * POST a JSON-RPC `tasks/send` request and return the resulting Task.
+     * The caller supplies the params (id, sessionId, message); this helper
+     * wraps it in the JSON-RPC envelope, dispatches, and unwraps.
+     */
+    async sendTask(params) {
+        const result = await this.rpc('tasks/send', params);
+        return result;
+    }
+    /** Low-level JSON-RPC dispatcher — exposed for tests / advanced callers. */
+    async rpc(method, params) {
+        const body = {
+            jsonrpc: JSON_RPC_VERSION,
+            id: generateRpcId(),
+            method,
+            params,
+        };
+        const res = await this.http.post(this.rpcPath, body);
+        assertOk(res.status, this.rpcPath, res.data);
+        const data = res.data;
+        if (data && 'error' in data && data.error) {
+            throw new Error(`A2A ${method} error: ${data.error.message} (code ${data.error.code})`);
+        }
+        if (data && 'result' in data)
+            return data.result;
+        throw new Error(`A2A ${method}: malformed response (no result)`);
+    }
+}
+/**
+ * Generate a short opaque id for JSON-RPC requests. Not cryptographic —
+ * just unique enough to pair request/response in logs.
+ */
+function generateRpcId() {
+    return `a2a-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+}
+/**
+ * Extract the plain-text output from a completed Task's artifacts. If
+ * the task isn't `completed`, throws. If there are no text parts, returns
+ * an empty string rather than null so callers always get a string.
+ */
+function extractTaskText(task) {
+    if (task.status.state === 'failed') {
+        throw new Error(`A2A task ${task.id} failed: ${task.error?.message ?? 'unknown error'}`);
+    }
+    if (task.status.state !== 'completed') {
+        throw new Error(`A2A task ${task.id} not completed (state=${task.status.state})`);
+    }
+    const parts = task.artifacts?.flatMap((a) => a.parts) ?? [];
+    return parts.map((p) => p.text ?? '').join('\n\n');
+}
+
+export { A2AClient, extractTaskText, generateRpcId };
+//# sourceMappingURL=client.mjs.map

package/dist/esm/providers/a2a/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.mjs","sources":["../../../../src/providers/a2a/client.ts"],"sourcesContent":["/**\n * A2A HTTP client — thin wrappers for the two operations the provider\n * needs: fetching the agent card and sending JSON-RPC task requests.\n *\n * Uses axios (already in deps) via the shared httpClient utility so\n * proxy config + headers work consistently with the tools-server provider.\n */\n\nimport { createHttpClient, assertOk } from '@/utils/httpClient';\nimport type {\n  A2AAgentCard,\n  A2ATask,\n  A2ATaskParams,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from './types';\n\nconst DEFAULT_CARD_PATH = '/.well-known/agent.json';\nconst DEFAULT_RPC_PATH = '/';\nconst JSON_RPC_VERSION = '2.0';\n\n/** Options for constructing a single-remote A2A client. */\nexport interface A2AClientOptions {\n  baseUrl: string;\n  headers?: Record<string, string>;\n  timeoutMs?: number;\n  cardPath?: string;\n  rpcPath?: string;\n}\n\n/**\n * Lightweight single-remote A2A client. One instance per remote; the\n * provider builds one per spec entry and caches them.\n */\nexport class A2AClient {\n  private readonly http: ReturnType<typeof createHttpClient>;\n  private readonly cardPath: string;\n  private readonly rpcPath: string;\n\n  constructor(opts: A2AClientOptions) {\n    this.http = createHttpClient({\n      baseURL: opts.baseUrl,\n      headers: opts.headers,\n      timeoutMs: opts.timeoutMs,\n    });\n    this.cardPath = opts.cardPath ?? DEFAULT_CARD_PATH;\n    this.rpcPath = opts.rpcPath ?? DEFAULT_RPC_PATH;\n  }\n\n  /** GET /.well-known/agent.json (or the configured override). */\n  async fetchAgentCard(): Promise<A2AAgentCard> {\n    const res = await this.http.get<A2AAgentCard>(this.cardPath);\n    assertOk(res.status, this.cardPath, res.data);\n    return res.data;\n  }\n\n  /**\n   * POST a JSON-RPC `tasks/send` request and return the resulting Task.\n   * The caller supplies the params (id, sessionId, message); this helper\n   * wraps it in the JSON-RPC envelope, dispatches, and unwraps.\n   */\n  async sendTask(params: A2ATaskParams): Promise<A2ATask> {\n    const result = await this.rpc<A2ATaskParams, A2ATask>('tasks/send', params);\n    return result;\n  }\n\n  /** Low-level JSON-RPC dispatcher — exposed for tests / advanced callers. */\n  async rpc<P, R>(method: string, params: P): Promise<R> {\n    const body: JsonRpcRequest<P> = {\n      jsonrpc: JSON_RPC_VERSION,\n      id: generateRpcId(),\n      method,\n      params,\n    };\n    const res = await this.http.post<JsonRpcResponse<R>>(this.rpcPath, body);\n    assertOk(res.status, this.rpcPath, res.data);\n\n    const data = res.data;\n    if (data && 'error' in data && data.error) {\n      throw new Error(\n        `A2A ${method} error: ${data.error.message} (code ${data.error.code})`\n      );\n    }\n    if (data && 'result' in data) return data.result;\n    throw new Error(`A2A ${method}: malformed response (no result)`);\n  }\n}\n\n/**\n * Generate a short opaque id for JSON-RPC requests. Not cryptographic —\n * just unique enough to pair request/response in logs.\n */\nexport function generateRpcId(): string {\n  return `a2a-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\n/**\n * Extract the plain-text output from a completed Task's artifacts. If\n * the task isn't `completed`, throws. If there are no text parts, returns\n * an empty string rather than null so callers always get a string.\n */\nexport function extractTaskText(task: A2ATask): string {\n  if (task.status.state === 'failed') {\n    throw new Error(\n      `A2A task ${task.id} failed: ${task.error?.message ?? 'unknown error'}`\n    );\n  }\n  if (task.status.state !== 'completed') {\n    throw new Error(\n      `A2A task ${task.id} not completed (state=${task.status.state})`\n    );\n  }\n  const parts = task.artifacts?.flatMap((a) => a.parts) ?? [];\n  return parts.map((p) => p.text ?? '').join('\\n\\n');\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/providers/a2a/config.mjs

@@ -0,0 +1,35 @@
+/**
+ * Environment-driven defaults + default logger for the A2A provider.
+ *
+ * Mirrors the MCP provider's config.ts so the two providers have the same
+ * override story for hosts.
+ */
+/**
+ * Read env values with fallbacks. Evaluated lazily so tests that mutate
+ * process.env get the current value.
+ */
+function getA2AEnvDefaults() {
+    return {
+        /**
+         * Identity sent to A2A-served remotes in user-agent / request headers.
+         * Precedence: constructor config → env var → library default.
+         */
+        clientName: process.env.A2A_CLIENT_NAME ?? 'illuma-agents',
+        clientVersion: process.env.A2A_CLIENT_VERSION ?? '1.0.0',
+        timeoutMs: Number(process.env.A2A_REQUEST_TIMEOUT_MS ?? 30_000),
+    };
+}
+/** Console-routed default logger. */
+const consoleLogger = {
+    // eslint-disable-next-line no-console
+    debug: (...args) => console.debug('[a2a]', ...args),
+    // eslint-disable-next-line no-console
+    info: (...args) => console.info('[a2a]', ...args),
+    // eslint-disable-next-line no-console
+    warn: (...args) => console.warn('[a2a]', ...args),
+    // eslint-disable-next-line no-console
+    error: (...args) => console.error('[a2a]', ...args),
+};
+
+export { consoleLogger, getA2AEnvDefaults };
+//# sourceMappingURL=config.mjs.map

package/dist/esm/providers/a2a/config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.mjs","sources":["../../../../src/providers/a2a/config.ts"],"sourcesContent":["/**\n * Environment-driven defaults + default logger for the A2A provider.\n *\n * Mirrors the MCP provider's config.ts so the two providers have the same\n * override story for hosts.\n */\n\nimport type { A2ALogger } from './types';\n\n/**\n * Read env values with fallbacks. Evaluated lazily so tests that mutate\n * process.env get the current value.\n */\nexport function getA2AEnvDefaults(): {\n  clientName: string;\n  clientVersion: string;\n  timeoutMs: number;\n} {\n  return {\n    /**\n     * Identity sent to A2A-served remotes in user-agent / request headers.\n     * Precedence: constructor config → env var → library default.\n     */\n    clientName: process.env.A2A_CLIENT_NAME ?? 'illuma-agents',\n    clientVersion: process.env.A2A_CLIENT_VERSION ?? '1.0.0',\n    timeoutMs: Number(process.env.A2A_REQUEST_TIMEOUT_MS ?? 30_000),\n  };\n}\n\n/** Console-routed default logger. */\nexport const consoleLogger: A2ALogger = {\n  // eslint-disable-next-line no-console\n  debug: (...args) => console.debug('[a2a]', ...args),\n  // eslint-disable-next-line no-console\n  info: (...args) => console.info('[a2a]', ...args),\n  // eslint-disable-next-line no-console\n  warn: (...args) => console.warn('[a2a]', ...args),\n  // eslint-disable-next-line no-console\n  error: (...args) => console.error('[a2a]', ...args),\n};\n"],"names":[],"mappings":"AAAA;;;;;AAKG;AAIH;;;AAGG;SACa,iBAAiB,GAAA;IAK/B,OAAO;AACL;;;AAGG;AACH,QAAA,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,eAAe;AAC1D,QAAA,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO;QACxD,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,MAAM,CAAC;KAChE;AACH;AAEA;AACO,MAAM,aAAa,GAAc;;AAEtC,IAAA,KAAK,EAAE,CAAC,GAAG,IAAI,KAAK,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;;AAEnD,IAAA,IAAI,EAAE,CAAC,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;;AAEjD,IAAA,IAAI,EAAE,CAAC,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;;AAEjD,IAAA,KAAK,EAAE,CAAC,GAAG,IAAI,KAAK,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;;;;;"}

package/dist/esm/providers/capabilityNaming.mjs

@@ -0,0 +1,39 @@
+/**
+ * Shared capability-name encoding used by source-specific providers
+ * (MCP, A2A, and future providers that expose multi-level namespaces).
+ *
+ * A capability name encodes `<sourceName>__<itemName>` where:
+ *   - `sourceName` is the provider-level identifier (MCP server name,
+ *     A2A remote name, etc.)
+ *   - `itemName` is the per-source sub-unit (MCP tool name, A2A skill id)
+ *
+ * Centralizing the separator + parsing here keeps both providers in lockstep
+ * and prevents collisions when re-exported from the provider barrel.
+ */
+/** Separator between source and item in an encoded capability name. */
+const CAPABILITY_NAME_SEPARATOR = '__';
+/** Compose a capability name. If `itemName` is omitted, returns just `sourceName`. */
+function formatCapabilityName(sourceName, itemName) {
+    return itemName
+        ? `${sourceName}${CAPABILITY_NAME_SEPARATOR}${itemName}`
+        : sourceName;
+}
+/**
+ * Parse a capability name into its components. Returns `null` when `name`
+ * is empty. When the name has no separator, `itemName` is undefined
+ * (the caller can treat that as a whole-source invocation).
+ */
+function parseCapabilityName(name) {
+    if (!name)
+        return null;
+    const sepIdx = name.indexOf(CAPABILITY_NAME_SEPARATOR);
+    if (sepIdx < 0)
+        return { sourceName: name };
+    return {
+        sourceName: name.slice(0, sepIdx),
+        itemName: name.slice(sepIdx + CAPABILITY_NAME_SEPARATOR.length),
+    };
+}
+
+export { CAPABILITY_NAME_SEPARATOR, formatCapabilityName, parseCapabilityName };
+//# sourceMappingURL=capabilityNaming.mjs.map

package/dist/esm/providers/capabilityNaming.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilityNaming.mjs","sources":["../../../src/providers/capabilityNaming.ts"],"sourcesContent":["/**\n * Shared capability-name encoding used by source-specific providers\n * (MCP, A2A, and future providers that expose multi-level namespaces).\n *\n * A capability name encodes `<sourceName>__<itemName>` where:\n *   - `sourceName` is the provider-level identifier (MCP server name,\n *     A2A remote name, etc.)\n *   - `itemName` is the per-source sub-unit (MCP tool name, A2A skill id)\n *\n * Centralizing the separator + parsing here keeps both providers in lockstep\n * and prevents collisions when re-exported from the provider barrel.\n */\n\n/** Separator between source and item in an encoded capability name. */\nexport const CAPABILITY_NAME_SEPARATOR = '__';\n\n/** Compose a capability name. If `itemName` is omitted, returns just `sourceName`. */\nexport function formatCapabilityName(\n  sourceName: string,\n  itemName?: string\n): string {\n  return itemName\n    ? `${sourceName}${CAPABILITY_NAME_SEPARATOR}${itemName}`\n    : sourceName;\n}\n\n/**\n * Parse a capability name into its components. Returns `null` when `name`\n * is empty. When the name has no separator, `itemName` is undefined\n * (the caller can treat that as a whole-source invocation).\n */\nexport function parseCapabilityName(\n  name: string\n): { sourceName: string; itemName?: string } | null {\n  if (!name) return null;\n  const sepIdx = name.indexOf(CAPABILITY_NAME_SEPARATOR);\n  if (sepIdx < 0) return { sourceName: name };\n  return {\n    sourceName: name.slice(0, sepIdx),\n    itemName: name.slice(sepIdx + CAPABILITY_NAME_SEPARATOR.length),\n  };\n}\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;AAWG;AAEH;AACO,MAAM,yBAAyB,GAAG;AAEzC;AACM,SAAU,oBAAoB,CAClC,UAAkB,EAClB,QAAiB,EAAA;AAEjB,IAAA,OAAO;AACL,UAAE,CAAA,EAAG,UAAU,GAAG,yBAAyB,CAAA,EAAG,QAAQ,CAAA;UACpD,UAAU;AAChB;AAEA;;;;AAIG;AACG,SAAU,mBAAmB,CACjC,IAAY,EAAA;AAEZ,IAAA,IAAI,CAAC,IAAI;AAAE,QAAA,OAAO,IAAI;IACtB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,yBAAyB,CAAC;IACtD,IAAI,MAAM,GAAG,CAAC;AAAE,QAAA,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE;IAC3C,OAAO;QACL,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC;QACjC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,yBAAyB,CAAC,MAAM,CAAC;KAChE;AACH;;;;"}