@hanphone/dsh-a2a 0.1.0

package/lib/types/index.js

@@ -0,0 +1,296 @@
+/**
+ * @hanphone/dsh-a2a — Cordis plugin entry.
+ *
+ * Mounts the A2A v1.0 dual-end plugin: the inbound server (AgentCard derived
+ * from the live tool registry, JSON-RPC + SSE, durable SQLite task store,
+ * session/subagent executors, the `a2a/inbound-task` policy gate + audit)
+ * and the outbound client (persisted multi-agent registry, skills mapped to
+ * model tools, sync calls with per-agent timeout). Optional services are
+ * probed rather than injected so a composition lacking one half idles just
+ * that half; only the storage domain is required.
+ *
+ * Function-plugin export shape: named `name`/`inject`/`Config`/`apply`, no
+ * default export (mixing forms makes the Loader drop the namespace).
+ * @module dsh-a2a
+ */
+import z from '@deepseek-ai/schemastery';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { mkdirSync } from 'node:fs';
+import { deriveSkills, buildCard } from "./server/card.js";
+import { openDomain, DomainTaskStore } from "./server/store.js";
+import { ExecutorSet } from "./server/executor.js";
+import { ContextSessionPool, probeService } from "./server/exec/agent-runtime.js";
+import { createSessionExecutor } from "./server/exec/session.js";
+import { createSubagentExecutor } from "./server/exec/subagent.js";
+import { A2AServer } from "./server/a2a-server.js";
+import { A2aRoutes } from "./server/routes.js";
+import { handleApiRequest } from "./api.js";
+import { OutboundAgentRegistry, DomainAgentStore } from "./outbound/registry.js";
+import { A2AService } from "./service.js";
+import { buildA2aCommand } from "./commands.js";
+export const name = 'a2a';
+/** Only the storage domain is required; the other halves are probed. */
+export const inject = ['storageDomain'];
+/** Loader-validated config schema (defaults applied by the Loader). */
+export const Config = z.object({
+    server: z.object({
+        enabled: z.boolean().default(true),
+        name: z.string().default('My DSH Agent'),
+        description: z.string().default('A DeepSeek Harness agent exposed over A2A v1.0'),
+        version: z.string().default('0.1.0'),
+        baseUrl: z.string(),
+        endpointPath: z.string().default('/a2a'),
+        authTokenEnv: z.string(),
+        skills: z.object({
+            ids: z.array(z.string()).default([]),
+            exclude: z.array(z.string()).default([]),
+        }),
+        executors: z.dict(z.union(['session', 'subagent'])).default({ chat: 'session' }),
+        subagentProvider: z.string().default('in-process'),
+    }),
+    client: z.object({
+        agents: z.array(z.object({
+            name: z.string(),
+            agentCardUrl: z.string(),
+            bearerTokenEnv: z.string(),
+            enabled: z.boolean().default(true),
+            timeoutMs: z.number().default(60000),
+        })).default([]),
+        toolPrefix: z.string().default('a2a'),
+    }),
+});
+export function apply(ctx, config) {
+    const logger = ctx.logger('a2a');
+    const serverConfig = { ...config.server };
+    const clientConfig = { ...config.client };
+    const authToken = serverConfig.authTokenEnv !== undefined ? process.env[serverConfig.authTokenEnv] : undefined;
+    const toolPrefix = clientConfig.toolPrefix;
+    const subagentProvider = serverConfig.subagentProvider;
+    const inboundCwd = inboundSessionCwd();
+    ctx.inject(['storageDomain'], (ctx) => {
+        ctx.effect(async () => {
+            const domain = await openDomain(ctx.storageDomain);
+            const store = new DomainTaskStore(domain);
+            const holder = {
+                domain,
+                store,
+                registry: undefined,
+                server: undefined,
+                routes: undefined,
+                card: undefined,
+                executors: undefined,
+                enabled: serverConfig.enabled,
+            };
+            // ── inbound server half ────────────────────────────────────────────
+            const webServer = probeService(ctx, 'webServer', 'register');
+            if (webServer === undefined) {
+                logger.warn('a2a: webServer not mounted; inbound server idle');
+            }
+            else {
+                try {
+                    const skills = deriveSkills(probeService(ctx, 'tools', 'get') ?? { get: () => undefined }, { ids: serverConfig.skills.ids, exclude: serverConfig.skills.exclude });
+                    const baseUrl = serverConfig.baseUrl ?? `http://127.0.0.1:${process.env['DSH_A2A_PORT'] ?? '3000'}`;
+                    const endpointPath = serverConfig.endpointPath ?? '/a2a';
+                    const card = buildCard({
+                        baseUrl,
+                        endpointPath,
+                        name: serverConfig.name ?? 'My DSH Agent',
+                        description: serverConfig.description ?? 'A DeepSeek Harness agent exposed over A2A v1.0',
+                        version: serverConfig.version ?? '0.1.0',
+                        skills,
+                        ...(authToken ? { authToken } : {}),
+                    });
+                    holder.card = card;
+                    // Executors: probe the agent loop; refuse tasks readably without it.
+                    const agents = probeService(ctx, 'agents', 'create');
+                    const presets = probeService(ctx, 'agentPresets', 'resolve');
+                    const sessionPool = agents
+                        ? new ContextSessionPool(agents, {
+                            cwd: inboundCwd,
+                            ...(presets ? { agentPresets: presets } : {}),
+                            resolveAgentOptions: () => resolveDefaultModel(ctx),
+                        })
+                        : undefined;
+                    const sessionExecutor = sessionPool ? createSessionExecutor(sessionPool) : refuseExecutor('no agent loop mounted');
+                    const subagents = probeService(ctx, 'subagents', 'start');
+                    const subagentExecutor = sessionPool !== undefined && subagents !== undefined
+                        ? createSubagentExecutor({ pool: sessionPool, subagents, provider: subagentProvider })
+                        : undefined;
+                    const executors = new ExecutorSet(serverConfig.executors, sessionExecutor, subagentExecutor);
+                    holder.executors = executors;
+                    const skillIds = new Set(skills.map((s) => s.id));
+                    const gate = async (input) => {
+                        if (!skillIds.has(input.skill)) {
+                            return { ok: false, reason: `unknown skill "${input.skill}"` };
+                        }
+                        const decision = {
+                            contextId: input.contextId,
+                            skill: input.skill,
+                            parts: input.parts,
+                            remotePeerId: input.remotePeerId,
+                        };
+                        const decided = await ctx.waterfall('a2a/inbound-task', decision, async (d) => d);
+                        // Built-in audit: every task decision is logged with its source.
+                        logger.info(`[a2a] inbound skill=${decided.skill} remote=${decided.remotePeerId} rejected=${decided.rejected?.reason ?? 'no'}`);
+                        if (decided.rejected !== undefined)
+                            return { ok: false, reason: decided.rejected.reason };
+                        return { ok: true };
+                    };
+                    const server = new A2AServer({
+                        card,
+                        store,
+                        executors,
+                        ...(authToken ? { authToken } : {}),
+                        gate,
+                        onTaskSettled: (taskId) => logger.info(`[a2a] task settled ${taskId}`),
+                    });
+                    holder.server = server;
+                    const routes = new A2aRoutes(webServer, server);
+                    holder.routes = routes;
+                    if (holder.enabled)
+                        routes.enable();
+                }
+                catch (err) {
+                    logger.error(`a2a: server half failed to build: ${err.message}`);
+                }
+            }
+            // ── outbound client half (after the inbound routes exist, so a
+            // loopback agent can fetch this server's own card) ──────────────────
+            const toolsService = probeService(ctx, 'tools', 'get');
+            if (toolsService === undefined) {
+                logger.warn('a2a: tools service not mounted; outbound client idle');
+            }
+            else {
+                const registry = new OutboundAgentRegistry({
+                    registrar: { register: (def) => toolsService.register(def) },
+                    store: new DomainAgentStore(domain.agents),
+                    toolPrefix,
+                    tokenOf: (env) => (env ? process.env[env] : undefined),
+                    onError: (message) => logger.warn(message),
+                });
+                holder.registry = registry;
+                registry.loadAll();
+                // Declared agents seed the registry: the persisted store stays the
+                // runtime state, so a disabled or removed agent is not reconnected.
+                if (clientConfig.agents.length > 0)
+                    await registry.seed(clientConfig.agents);
+            }
+            // ── service facade + commands ──────────────────────────────────────
+            const impl = makeFacade(holder, logger.info.bind(logger));
+            new A2AService(ctx, impl);
+            const commands = probeService(ctx, 'commands', 'register');
+            if (commands !== undefined) {
+                ctx.effect(() => commands.register(buildA2aCommand(impl)), 'a2a: command');
+            }
+            // ── GUI dashboard API (loopback-only /a2a/api) ─────────────────────
+            const dashboardWebServer = probeService(ctx, 'webServer', 'register');
+            if (dashboardWebServer !== undefined) {
+                ctx.effect(() => dashboardWebServer.register({
+                    kind: 'prefix',
+                    path: '/a2a/api',
+                    handler: (req, res) => handleApiRequest(req, res, impl),
+                }), 'a2a: dashboard api');
+            }
+            else {
+                logger.warn('a2a: webServer not mounted; GUI dashboard API idle');
+            }
+            return async () => {
+                holder.routes?.dispose();
+                await holder.executors?.disposeAll();
+                await holder.registry?.disposeAll();
+                await domain.close();
+            };
+        }, 'a2a: domain + halves');
+    });
+}
+/** Facade closure over the shared holder (commands and `ctx.a2a` consumers). */
+function makeFacade(holder, log) {
+    const serverEnabled = () => holder.routes?.active ?? false;
+    return {
+        status() {
+            return {
+                server: {
+                    enabled: serverEnabled(),
+                    cardUrl: holder.card?.supportedInterfaces?.[0]?.url,
+                    skills: holder.card?.skills?.map((s) => s.id) ?? [],
+                    executors: holder.executors ? ['session', ...(holder.executors['subagent'] !== undefined ? ['subagent'] : [])] : [],
+                },
+                tasks: holder.store.list().length,
+                agents: holder.registry?.list() ?? [],
+            };
+        },
+        async enableServer(enable) {
+            if (holder.routes === undefined)
+                return { ok: false, message: 'inbound server is not mounted (no webServer)' };
+            if (enable)
+                holder.routes.enable();
+            else
+                holder.routes.disable();
+            log(`[a2a] server ${enable ? 'enabled' : 'disabled'}`);
+            return { ok: true, message: `server ${enable ? 'enabled' : 'disabled'}` };
+        },
+        getTask(taskId) {
+            return holder.store.get(taskId);
+        },
+        listTasks() {
+            return holder.store.list();
+        },
+        async cancelTask(taskId) {
+            const record = holder.store.get(taskId);
+            if (record === undefined)
+                return { ok: false, message: `task ${taskId} not found` };
+            const aborted = holder.server?.abort?.(taskId) ?? false;
+            return { ok: true, message: aborted ? `task ${taskId} canceled` : `task ${taskId} already terminal` };
+        },
+        agents() {
+            return holder.registry?.list() ?? [];
+        },
+        async addAgent(spec) {
+            const registry = holder.registry;
+            if (registry === undefined)
+                return { ok: false, message: 'outbound client not mounted (no tools service)' };
+            const result = await registry.add({ ...spec, enabled: true, timeoutMs: 60000 });
+            return result;
+        },
+        async removeAgent(id) {
+            return holder.registry?.remove(id) ?? { ok: false, message: 'outbound client not mounted' };
+        },
+        async setAgentEnabled(id, enabled) {
+            return holder.registry?.setEnabled(id, enabled) ?? { ok: false, message: 'outbound client not mounted' };
+        },
+        async refreshAgentCard(id) {
+            return holder.registry?.refresh(id) ?? { ok: false, message: 'outbound client not mounted' };
+        },
+    };
+}
+/** A task that refuses readably on compositions without an agent loop. */
+function refuseExecutor(reason) {
+    return {
+        name: 'refuse',
+        async execute() {
+            throw new Error(`a2a: ${reason}; refusing inbound task`);
+        },
+    };
+}
+function resolveDefaultModel(ctx) {
+    const service = probeService(ctx, 'agentDefaultModel', 'currentSelection');
+    return service?.currentSelection();
+}
+/** Absolute stable cwd for inbound per-context sessions (never profile root). */
+function inboundSessionCwd() {
+    const home = join(homedir(), '.dsh');
+    const dshHome = process.env['DSH_HOME'] ?? home;
+    const dir = join(dshHome, 'a2a-sessions');
+    try {
+        mkdirSync(dir, { recursive: true });
+    }
+    catch {
+        // cwd fallback below stays valid
+    }
+    return dir;
+}
+export { A2AServer } from "./server/a2a-server.js";
+export { A2AClient, A2AError } from "./outbound/calls.js";
+export { A2AService } from "./service.js";
+//# sourceMappingURL=index.js.map

package/lib/types/index.js.map

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

package/lib/types/jsonrpc.d.ts

@@ -0,0 +1,20 @@
+/**
+ * JSON-RPC 2.0 helpers and SSE framing for the A2A binding. Transport-agnostic:
+ * the A2AServer consumes these, and the HTTP route layer only maps requests to
+ * `handle` / `handleStream` and bytes back.
+ * @module dsh-a2a/jsonrpc
+ */
+import { type JsonRpcError, type JsonRpcRequest, type JsonRpcSuccess } from './protocol.ts';
+/** Parse a request body into a JSON-RPC request, or undefined on malformed input. */
+export declare function parseRpc(body: string): JsonRpcRequest | undefined;
+/** Build a JSON-RPC error response object. */
+export declare function rpcError(id: string | number | null | undefined, code: number, message: string, data?: unknown): JsonRpcError;
+/** Build a JSON-RPC success response object. */
+export declare function rpcSuccess(id: string | number | null | undefined, result: unknown): JsonRpcSuccess;
+/** Invalid-method error for the SSE path (no request id on the wire). */
+export declare function methodNotFound(method: string): JsonRpcError;
+/** One data frame of an SSE stream. */
+export declare function sseData(payload: unknown): string;
+/** One named event frame of an SSE stream (e.g. `event: error`). */
+export declare function sseEvent(name: string, payload: unknown): string;
+//# sourceMappingURL=jsonrpc.d.ts.map

package/lib/types/jsonrpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonrpc.d.ts","sourceRoot":"","sources":["../../src/jsonrpc.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,eAAe,CAAA;AAEtB,qFAAqF;AACrF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAWjE;AAED,8CAA8C;AAC9C,wBAAgB,QAAQ,CACtB,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACtC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,OAAO,GACb,YAAY,CAMd;AAED,gDAAgD;AAChD,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,cAAc,CAElG;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAE3D;AAED,uCAAuC;AACvC,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAE/D"}

package/lib/types/jsonrpc.js

@@ -0,0 +1,48 @@
+/**
+ * JSON-RPC 2.0 helpers and SSE framing for the A2A binding. Transport-agnostic:
+ * the A2AServer consumes these, and the HTTP route layer only maps requests to
+ * `handle` / `handleStream` and bytes back.
+ * @module dsh-a2a/jsonrpc
+ */
+import { A2A_ERROR_CODES, } from "./protocol.js";
+/** Parse a request body into a JSON-RPC request, or undefined on malformed input. */
+export function parseRpc(body) {
+    let value;
+    try {
+        value = JSON.parse(body);
+    }
+    catch {
+        return undefined;
+    }
+    if (typeof value !== 'object' || value === null)
+        return undefined;
+    const rpc = value;
+    if (rpc.jsonrpc !== '2.0' || typeof rpc.method !== 'string')
+        return undefined;
+    return rpc;
+}
+/** Build a JSON-RPC error response object. */
+export function rpcError(id, code, message, data) {
+    return {
+        jsonrpc: '2.0',
+        id: id ?? null,
+        error: { code, message, ...(data === undefined ? {} : { data }) },
+    };
+}
+/** Build a JSON-RPC success response object. */
+export function rpcSuccess(id, result) {
+    return { jsonrpc: '2.0', id: id ?? null, result };
+}
+/** Invalid-method error for the SSE path (no request id on the wire). */
+export function methodNotFound(method) {
+    return rpcError(null, A2A_ERROR_CODES.METHOD_NOT_FOUND, `Unknown method ${method}`);
+}
+/** One data frame of an SSE stream. */
+export function sseData(payload) {
+    return `data: ${JSON.stringify(payload)}\n\n`;
+}
+/** One named event frame of an SSE stream (e.g. `event: error`). */
+export function sseEvent(name, payload) {
+    return `event: ${name}\ndata: ${JSON.stringify(payload)}\n\n`;
+}
+//# sourceMappingURL=jsonrpc.js.map

package/lib/types/jsonrpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonrpc.js","sourceRoot":"","sources":["../../src/jsonrpc.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,GAIhB,MAAM,eAAe,CAAA;AAEtB,qFAAqF;AACrF,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,IAAI,KAAc,CAAA;IAClB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAA;IACjE,MAAM,GAAG,GAAG,KAAgC,CAAA;IAC5C,IAAI,GAAG,CAAC,OAAO,KAAK,KAAK,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IAC7E,OAAO,GAAqB,CAAA;AAC9B,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,QAAQ,CACtB,EAAsC,EACtC,IAAY,EACZ,OAAe,EACf,IAAc;IAEd,OAAO;QACL,OAAO,EAAE,KAAK;QACd,EAAE,EAAE,EAAE,IAAI,IAAI;QACd,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;KAClE,CAAA;AACH,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,UAAU,CAAC,EAAsC,EAAE,MAAe;IAChF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,MAAM,EAAE,CAAA;AACnD,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,gBAAgB,EAAE,kBAAkB,MAAM,EAAE,CAAC,CAAA;AACrF,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,OAAO,CAAC,OAAgB;IACtC,OAAO,SAAS,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAA;AAC/C,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,OAAgB;IACrD,OAAO,UAAU,IAAI,WAAW,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAA;AAC/D,CAAC"}

package/lib/types/outbound/calls.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Outbound A2A client: AgentCard discovery plus the JSON-RPC methods the
+ * tools layer needs. Sync-by-polling for P0 (each tool call waits for the
+ * task to settle up to a timeout); passive result injection replaces this in
+ * P1 without changing the transport.
+ * @module dsh-a2a/client/calls
+ */
+import { type AgentCard, type Message, type Task } from '../protocol.ts';
+/** Error carrying the remote JSON-RPC error code. */
+export declare class A2AError extends Error {
+    readonly code: number;
+    constructor(code: number, message: string);
+}
+export interface ClientOptions {
+    readonly bearerToken?: string;
+    /** Per-call timeout in ms. Default 60000. */
+    readonly timeoutMs?: number;
+    readonly fetchImpl?: typeof fetch;
+}
+/** A connected remote A2A agent (one AgentCard endpoint). */
+export declare class A2AClient {
+    private readonly opts;
+    readonly card: AgentCard;
+    private readonly endpoint;
+    private constructor();
+    /** Fetch and validate an AgentCard, then connect to its JSON-RPC endpoint. */
+    static connect(agentCardUrl: string, opts?: ClientOptions): Promise<A2AClient>;
+    /** Send a message and wait (or poll) until the task settles. */
+    sendMessage(message: Message): Promise<Task>;
+    getTask(taskId: string): Promise<Task>;
+    listTasks(): Promise<Task[]>;
+    cancelTask(taskId: string): Promise<Task>;
+    /** Poll a task until terminal or the overall timeout elapses. */
+    private pollTask;
+    private call;
+}
+//# sourceMappingURL=calls.d.ts.map

package/lib/types/outbound/calls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calls.d.ts","sourceRoot":"","sources":["../../../src/outbound/calls.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAIL,KAAK,SAAS,EAEd,KAAK,OAAO,EACZ,KAAK,IAAI,EACV,MAAM,gBAAgB,CAAA;AAEvB,qDAAqD;AACrD,qBAAa,QAAS,SAAQ,KAAK;IAE/B,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAKlB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAClC;AAED,6DAA6D;AAC7D,qBAAa,SAAS;IAOlB,OAAO,CAAC,QAAQ,CAAC,IAAI;IANvB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IAEjC,OAAO;IASP,8EAA8E;WACjE,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,SAAS,CAAC;IA0BxF,gEAAgE;IAC1D,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAI5B,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,iEAAiE;YACnD,QAAQ;YAaR,IAAI;CAkCnB"}

package/lib/types/outbound/calls.js

@@ -0,0 +1,120 @@
+/**
+ * Outbound A2A client: AgentCard discovery plus the JSON-RPC methods the
+ * tools layer needs. Sync-by-polling for P0 (each tool call waits for the
+ * task to settle up to a timeout); passive result injection replaces this in
+ * P1 without changing the transport.
+ * @module dsh-a2a/client/calls
+ */
+import { A2A_ERROR_CODES, A2A_METHODS, isTerminal, } from "../protocol.js";
+/** Error carrying the remote JSON-RPC error code. */
+export class A2AError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'A2AError';
+    }
+}
+/** A connected remote A2A agent (one AgentCard endpoint). */
+export class A2AClient {
+    opts;
+    card;
+    endpoint;
+    constructor(card, endpoint, opts) {
+        this.opts = opts;
+        this.card = card;
+        this.endpoint = endpoint;
+    }
+    /** Fetch and validate an AgentCard, then connect to its JSON-RPC endpoint. */
+    static async connect(agentCardUrl, opts = {}) {
+        const timeoutMs = opts.timeoutMs ?? 60_000;
+        const fetchImpl = opts.fetchImpl ?? fetch;
+        const response = await fetchImpl(agentCardUrl, {
+            headers: {
+                accept: 'application/json',
+                ...(opts.bearerToken ? { authorization: `Bearer ${opts.bearerToken}` } : {}),
+            },
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        if (!response.ok) {
+            throw new A2AError(A2A_ERROR_CODES.AGENT_CARD_NOT_FOUND, `agent card fetch failed: HTTP ${response.status}`);
+        }
+        const card = (await response.json());
+        if (typeof card.name !== 'string' || typeof card.description !== 'string') {
+            throw new A2AError(A2A_ERROR_CODES.AGENT_CARD_SIGNATURE_INVALID, `invalid agent card at ${agentCardUrl}`);
+        }
+        const iface = card.supportedInterfaces?.find((i) => (i.protocolBinding ?? 'JSONRPC') === 'JSONRPC')
+            ?? card.supportedInterfaces?.[0];
+        const endpoint = iface?.url ?? card.url;
+        if (!endpoint) {
+            throw new A2AError(A2A_ERROR_CODES.AGENT_CARD_NOT_FOUND, `agent card at ${agentCardUrl} advertises no JSON-RPC interface`);
+        }
+        return new A2AClient(card, endpoint, opts);
+    }
+    /** Send a message and wait (or poll) until the task settles. */
+    async sendMessage(message) {
+        const task = await this.call(A2A_METHODS.sendMessage, { message });
+        if (isTerminal(task.status.state))
+            return task;
+        return this.pollTask(task.id);
+    }
+    async getTask(taskId) {
+        return this.call(A2A_METHODS.getTask, { id: taskId });
+    }
+    async listTasks() {
+        return this.call(A2A_METHODS.listTasks, {});
+    }
+    async cancelTask(taskId) {
+        return this.call(A2A_METHODS.cancelTask, { id: taskId });
+    }
+    /** Poll a task until terminal or the overall timeout elapses. */
+    async pollTask(taskId) {
+        const budget = this.opts.timeoutMs ?? 60_000;
+        const deadline = Date.now() + budget;
+        for (;;) {
+            const task = await this.getTask(taskId);
+            if (isTerminal(task.status.state))
+                return task;
+            if (Date.now() >= deadline) {
+                throw new A2AError(-32000, `task ${taskId} did not settle within ${budget}ms`);
+            }
+            await new Promise((resolve) => setTimeout(resolve, 250));
+        }
+    }
+    async call(method, params) {
+        const timeoutMs = this.opts.timeoutMs ?? 60_000;
+        const fetchImpl = this.opts.fetchImpl ?? fetch;
+        let response;
+        try {
+            response = await fetchImpl(this.endpoint, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                    accept: 'application/json',
+                    ...(this.opts.bearerToken ? { authorization: `Bearer ${this.opts.bearerToken}` } : {}),
+                },
+                body: JSON.stringify({ jsonrpc: '2.0', id: crypto.randomUUID(), method, params }),
+                signal: AbortSignal.timeout(timeoutMs),
+            });
+        }
+        catch (err) {
+            if (err instanceof Error && err.name === 'TimeoutError') {
+                throw new A2AError(-32000, `A2A call ${method} timed out after ${timeoutMs}ms`);
+            }
+            throw err;
+        }
+        if (response.status === 401) {
+            throw new A2AError(A2A_ERROR_CODES.UNAUTHORIZED, 'remote agent rejected credentials (401)');
+        }
+        if (!response.ok) {
+            throw new A2AError(A2A_ERROR_CODES.INTERNAL_ERROR, `A2A call ${method} failed: HTTP ${response.status}`);
+        }
+        const payload = (await response.json());
+        if ('error' in payload) {
+            const error = payload.error;
+            throw new A2AError(error.code, error.message);
+        }
+        return payload.result;
+    }
+}
+//# sourceMappingURL=calls.js.map

package/lib/types/outbound/calls.js.map

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