@ryubyte/dsh-a2a 0.1.0

package/lib/types/a2a-config.d.ts

@@ -0,0 +1,107 @@
+/**
+ * dsh-a2a — persisted configuration (`a2a.json`).
+ *
+ * Runtime-editable configuration lives in a per-profile `a2a.json`, so the
+ * plugin's UI changes survive restarts without touching the composition
+ * (`cordis.patch.yml` / `package.json` stay pure entry points).
+ *
+ * File resolution order:
+ *   1. `process.cwd()/a2a.json`            — profile dir when launched via `dsh --profile <x>`
+ *   2. `~/.dsh/profiles/<cwd-basename>/a2a.json` — fallback when cwd is not the profile dir
+ *   3. `$DSH_HOME/a2a.json`                — last-resort global location
+ *
+ * Shape (all fields optional):
+ * {
+ *   "mode": "both",                    // client | server | both (default both)
+ *   "timeoutMs": 8000,                 // client global default (ms)
+ *   "mapSkills": true,                 // per-skill tools vs one agent-wide tool
+ *   "agents": [{ "name", "agentCardUrl", "bearerToken?", "timeoutMs?", "mapSkills?", "enabled?" }],
+ *   "server": { "baseUrl"?, "agentName"?, "agentDescription"?, "agentVersion"?,
+ *               "endpointPath"?, "skills"?: [{ "id","name","description"?, "tags"? }] },
+ *   "dashboard": true
+ * }
+ */
+import type { A2APluginConfig } from './index.js';
+export declare const A2A_CONFIG_FILENAME = "a2a.json";
+export interface PersistedAgentConfig {
+    name: string;
+    agentCardUrl: string;
+    bearerToken?: string;
+    timeoutMs?: number;
+    mapSkills?: boolean;
+    /** False disables the connection without removing the entry (default true). */
+    enabled?: boolean;
+}
+export interface PersistedServerConfig {
+    /** Explicitly enable the inbound server (default off). */
+    enabled?: boolean;
+    baseUrl?: string;
+    agentName?: string;
+    agentDescription?: string;
+    agentVersion?: string;
+    endpointPath?: string;
+    skills?: Array<{
+        id: string;
+        name: string;
+        description: string;
+        tags?: string[];
+        examples?: string[];
+    }>;
+}
+export interface PersistedA2AConfig {
+    mode?: 'client' | 'server' | 'both';
+    timeoutMs?: number;
+    mapSkills?: boolean;
+    agents?: PersistedAgentConfig[];
+    server?: PersistedServerConfig;
+    dashboard?: boolean;
+}
+/**
+ * Parse `--profile <name>` (or `--profile=<name>`) from the process argv.
+ *
+ * dsh keeps its launcher flags in the process command line (`node …/dsh
+ * --profile a2a-test --port 3083`), so the active profile name is directly
+ * observable no matter which directory the process was started from. This is
+ * the most reliable way to locate the per-profile config — far better than
+ * guessing from cwd's basename.
+ */
+export declare function profileNameFromArgv(): string | undefined;
+/**
+ * Resolve the a2a.json path for the current process, without depending on
+ * the launch directory. The plugin must work no matter where `dsh` was
+ * started from (dsh does NOT chdir into the profile directory), so this
+ * prefers the profile named in argv (`--profile <name>`), then walks
+ * outward from cwd, then falls back to the profile dir that matches cwd's
+ * basename, then the harness home.
+ *
+ * Order:
+ *   0. `$DSH_HOME/profiles/<argv --profile>/a2a.json` — the active profile
+ *      as named on the command line (most authoritative; works from ANY cwd)
+ *   1. `cwd/a2a.json` — explicit when launched inside a profile dir
+ *   2. outward from cwd: the nearest ancestor holding `a2a.json` — covers
+ *      launching from e.g. a repo checkout whose parent chain includes the
+ *      profile, or any subdir of the profile
+ *   3. `$DSH_HOME/profiles/<cwd-basename>/a2a.json` — started from the
+ *      profile's *parent* (e.g. `~/.dsh/profiles`) or when the profile dir
+ *      is cwd but the file hasn't been created yet
+ *   4. `$DSH_HOME/a2a.json` — last-resort global location
+ *
+ * Writes always go to the *resolved* path (the one we read), so a config
+ * loaded from any step is saved back to the same place, never re-resolved
+ * to cwd.
+ */
+export declare function resolveConfigPath(): string;
+/** Read the persisted config (empty object when absent or unreadable). */
+export declare function loadConfig(): PersistedA2AConfig;
+/** Atomically write the persisted config (creates the directory when needed). */
+export declare function saveConfig(config: PersistedA2AConfig): {
+    ok: boolean;
+    path: string;
+    message?: string;
+};
+/**
+ * Merge persisted config on top of the in-composition config, so the file
+ * (UI-editable, survives restart) wins over static defaults.
+ */
+export declare function mergePersisted(base: A2APluginConfig, persisted: PersistedA2AConfig): A2APluginConfig;
+//# sourceMappingURL=a2a-config.d.ts.map

package/lib/types/a2a-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-config.d.ts","sourceRoot":"","sources":["../../src/a2a-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAE9C,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CACzG;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAChC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAaxD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAqC1C;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,IAAI,kBAAkB,CAW/C;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,MAAM,EAAE,kBAAkB,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAatG;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,kBAAkB,GAAG,eAAe,CAkBpG"}

package/lib/types/card.d.ts

@@ -0,0 +1,40 @@
+/**
+ * A2A (Agent2Agent) Protocol v1.0 — AgentCard discovery and validation.
+ *
+ * Reproduces the protocol's discovery contract: fetch the manifest at
+ * `/.well-known/agent-card.json` (or a configured URL). Per the spec, when a
+ * path is configured without a well-known segment the client SHOULD probe the
+ * well-known location first, then fall back to the configured path.
+ */
+import type { AgentCard, AgentInterface } from './protocol.js';
+export interface AgentCardOptions {
+    /** How long a single fetch may take (ms). Default 15000. */
+    timeoutMs?: number;
+    /** Optional bearer token sent as `Authorization: Bearer <token>`. */
+    bearerToken?: string;
+    /** Optional custom fetch implementation (for tests). */
+    fetchImpl?: typeof fetch;
+}
+export declare function isAgentCard(value: unknown): value is AgentCard;
+/**
+ * Fetch and validate an agent's AgentCard.
+ *
+ * Discovery order (per spec §AgentCard discovery):
+ *   1. Probe `GET {origin}/.well-known/agent-card.json` first.
+ *   2. Fall back to the exact configured URL.
+ * A configured URL that already ends in `agent-card.json` is used directly.
+ */
+export declare function fetchAgentCard(baseUrl: string, options?: AgentCardOptions): Promise<AgentCard>;
+/**
+ * Pick the best interface to talk to an agent from its AgentCard.
+ *
+ * Preference order: a JSONRPC interface first, then gRPC, then any other
+ * binding; the card's own ordering ("first entry is preferred") is respected
+ * within each binding class. Returns the interface and a normalized base URL
+ * to post JSON-RPC requests to.
+ */
+export declare function pickInterface(card: AgentCard, preferred?: string): {
+    iface: AgentInterface;
+    url: string;
+};
+//# sourceMappingURL=card.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../src/card.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/D,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAc9D;AAQD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,SAAS,CAAC,CA0DpB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,EACf,SAAS,CAAC,EAAE,MAAM,GACjB;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAiBxC"}

package/lib/types/client/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * dsh-a2a — browser half.
+ *
+ * Contributes the "A2A 连接" settings section: a dashboard showing who is
+ * connected TO this DSH (inbound peers) and who this DSH is connected TO
+ * (outbound agents), with reconnect / close controls per connection.
+ *
+ * The data and the controls live behind the host's `/a2a/api` routes
+ * (served by the node half on the same webserver); the browser half is a
+ * thin read/write client with no protocol knowledge.
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import { type ReactElement } from 'react';
+/** Services this plugin needs from the client runtime. */
+export declare const inject: string[];
+export declare function apply(ctx: ClientContext): void;
+type SectionProps = PropsRuntime<'settings.section'>;
+/** The A2A connection dashboard settings section. */
+export declare function DashboardSection(_props: SectionProps): ReactElement;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAE5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAsC,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAE9E,0DAA0D;AAC1D,eAAO,MAAM,MAAM,UAAY,CAAC;AAEhC,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAmB9C;AA6DD,KAAK,YAAY,GAAG,YAAY,CAAC,kBAAkB,CAAC,CAAC;AAErD,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAqTnE"}

package/lib/types/client.d.ts

@@ -0,0 +1,52 @@
+/**
+ * A2A (Agent2Agent) Protocol v1.0 — outbound client.
+ *
+ * A thin client that discovers an agent via its AgentCard and speaks the
+ * JSONRPC binding: SendMessage (sync/async), SendStreamingMessage,
+ * GetTask, CancelTask, ListTasks.
+ */
+import type { AgentCard, Message, SendMessageConfiguration, SendMessageResponse, StreamResponse, Task } from './protocol.js';
+import { TaskState } from './protocol.js';
+import { type JsonRpcClientOptions, type JsonRpcCallOptions } from './jsonrpc.js';
+export interface A2AClientOptions extends JsonRpcClientOptions {
+    /** Prefer a specific protocol binding. Default 'JSONRPC'. */
+    preferredBinding?: string;
+}
+export interface WaitForTaskOptions {
+    /** Poll interval in ms. Default 500. */
+    intervalMs?: number;
+    signal?: AbortSignal;
+}
+/** A2A client bound to one remote agent. */
+export declare class A2AClient {
+    readonly card: AgentCard;
+    private readonly rpc;
+    readonly endpointUrl: string;
+    readonly tenant?: string;
+    static connect(agentCardUrlOrBase: string, options?: A2AClientOptions): Promise<A2AClient>;
+    constructor(card: AgentCard, options?: A2AClientOptions);
+    /** Send a message; returns a Task or Message per the server's choice. */
+    sendMessage(message: Message, configuration?: SendMessageConfiguration, options?: JsonRpcCallOptions): Promise<SendMessageResponse>;
+    /** Send a message over a stream, yielding all StreamResponse events. */
+    streamMessage(message: Message, configuration?: SendMessageConfiguration, options?: JsonRpcCallOptions): AsyncGenerator<StreamResponse>;
+    getTask(id: string, historyLength?: number, options?: JsonRpcCallOptions): Promise<Task>;
+    listTasks(params?: {
+        contextId?: string;
+        status?: TaskState;
+        pageSize?: number;
+        pageToken?: string;
+        includeArtifacts?: boolean;
+    }, options?: JsonRpcCallOptions): Promise<{
+        tasks: Task[];
+        nextPageToken: string;
+        pageSize: number;
+        totalSize: number;
+    }>;
+    cancelTask(id: string, options?: JsonRpcCallOptions): Promise<Task>;
+    /**
+     * Send a message and wait (polling) until the created task reaches a
+     * terminal state. Errors if the task fails or is rejected.
+     */
+    sendAndWait(message: Message, configuration?: SendMessageConfiguration, options?: JsonRpcCallOptions & WaitForTaskOptions): Promise<Task>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC7H,OAAO,EAAE,SAAS,EAAc,MAAM,eAAe,CAAC;AACtD,OAAO,EAAiB,KAAK,oBAAoB,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGjG,MAAM,WAAW,gBAAiB,SAAQ,oBAAoB;IAC5D,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,4CAA4C;AAC5C,qBAAa,SAAS;IACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;WAEZ,OAAO,CAClB,kBAAkB,EAAE,MAAM,EAC1B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,SAAS,CAAC;gBAKT,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,gBAAqB;IAQ3D,yEAAyE;IACnE,WAAW,CACf,OAAO,EAAE,OAAO,EAChB,aAAa,CAAC,EAAE,wBAAwB,EACxC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,mBAAmB,CAAC;IAQ/B,wEAAwE;IACxE,aAAa,CACX,OAAO,EAAE,OAAO,EAChB,aAAa,GAAE,wBAA6B,EAC5C,OAAO,GAAE,kBAAuB,GAC/B,cAAc,CAAC,cAAc,CAAC;IAQ3B,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5F,SAAS,CAAC,MAAM,GAAE;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,SAAS,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;KACvB,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC;QACjD,KAAK,EAAE,IAAI,EAAE,CAAC;QACd,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAII,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7E;;;OAGG;IACG,WAAW,CACf,OAAO,EAAE,OAAO,EAChB,aAAa,GAAE,wBAA6B,EAC5C,OAAO,GAAE,kBAAkB,GAAG,kBAAuB,GACpD,OAAO,CAAC,IAAI,CAAC;CA4BjB"}

package/lib/types/dashboard.d.ts

@@ -0,0 +1,144 @@
+/**
+ * dsh-a2a — connection dashboard.
+ *
+ * Tracks both directions of A2A connectivity so the operator (and the
+ * settings dashboard) can see:
+ *
+ *  - **inbound**  — which remote peers are talking to THIS DSH's A2A server
+ *                   (peer label, source address, last activity, live tasks).
+ *  - **outbound** — which remote agents THIS DSH is connected to via the
+ *                   client mode (agent name, AgentCard URL, skill count,
+ *                   connection state) with reconnect/close controls.
+ *
+ * The registry is process-local and purely observational: entries never
+ * affect protocol behavior by themselves. Control operations
+ * (`reconnectPeer`, `closePeer`, `reconnectAgent`, `closeAgent`) are wired
+ * by the plugin entry to the real connection owners.
+ */
+import type { A2AClient } from './client.js';
+export interface InboundPeer {
+    /** Stable per-process id (random). */
+    id: string;
+    /** Short display label derived from the request. */
+    label: string;
+    /** Source socket address, when visible ("127.0.0.1:54321"). */
+    source?: string;
+    /** First-seen ISO timestamp. */
+    firstSeen: string;
+    /** Last-activity ISO timestamp. */
+    lastSeen: string;
+    /** Number of tasks this peer has created/continued. */
+    taskCount: number;
+    /** Ids of tasks still running for this peer. */
+    activeTaskIds: string[];
+    /** True while at least one streaming (SSE) connection is open. */
+    streaming: boolean;
+}
+export interface OutboundAgent {
+    /** Stable per-process id. */
+    id: string;
+    /** Namespace used for tool names ("research" → a2a__research__<skill>). */
+    name: string;
+    /** AgentCard URL the client was connected to. */
+    agentCardUrl: string;
+    /** Remote agent display name (from the AgentCard). */
+    agentName?: string;
+    /** Number of skills mapped to tools. */
+    skillCount: number;
+    /** Number of tools registered for this agent. */
+    toolCount: number;
+    /** Connection state. */
+    state: 'connected' | 'disconnected' | 'reconnecting';
+    /** False when this agent is configured but disabled in a2a.json (no live connection). */
+    enabled?: boolean;
+    /** Last-activity ISO timestamp. */
+    lastSeen: string;
+    /** Per-process connection id assigned by the outbound registry. */
+    connectionId?: string;
+    /** True when this connection came from the profile config (vs runtime-added). */
+    configured?: boolean;
+    /** Skills advertised by the remote AgentCard (for the detail view). */
+    skills?: Array<{
+        id: string;
+        name: string;
+        description?: string;
+        tags?: string[];
+    }>;
+}
+export interface DashboardSnapshot {
+    inbound: InboundPeer[];
+    outbound: OutboundAgent[];
+    /** Epoch ms of the snapshot. */
+    at: number;
+}
+export interface ControlResult {
+    ok: boolean;
+    message: string;
+}
+/** How the plugin entry wires control operations to connection owners. */
+export interface DashboardControlHooks {
+    /** Reconnect an outbound agent by its connection id. */
+    reconnectAgent?: (connectionId: string) => Promise<ControlResult>;
+    /** Disable (disconnect + persist enabled:false) an outbound agent without removing it. */
+    disableAgent?: (connectionId: string) => Promise<ControlResult>;
+    /** Enable a disabled outbound agent (persist enabled:true and reconnect). */
+    enableAgent?: (connectionId: string) => Promise<ControlResult>;
+    /** Close an outbound agent by its connection id. */
+    closeAgent?: (connectionId: string) => Promise<ControlResult>;
+    /** Close (sever) an inbound peer by its id. */
+    closePeer?: (peerId: string) => Promise<ControlResult>;
+    /** Reconnect is not meaningful for an inbound peer — rejects unless overridden. */
+    reconnectPeer?: (peerId: string) => Promise<ControlResult>;
+    /** Runtime-add an outbound agent (visual config). Returns the new connection id. */
+    addAgent?: (name: string, agentCardUrl: string) => Promise<ControlResult>;
+    /** Discover an Agent Card without connecting (for the import preview). */
+    discoverAgent?: (agentCardUrl: string) => Promise<ControlResult>;
+    /** Enable/disable the inbound A2A server (serve routes) at runtime. */
+    setServerEnabled?: (enabled: boolean) => Promise<ControlResult>;
+    /** Read current inbound server status (for the serve panel). */
+    serverStatus?: () => ControlResult;
+    /** Runtime-remove an outbound agent by its connection id. */
+    removeAgent?: (connectionId: string) => Promise<ControlResult>;
+}
+/** Registry of live A2A connections, both directions. */
+export declare class DashboardRegistry {
+    private peers;
+    private agents;
+    private hooks;
+    private seq;
+    setHooks(hooks: DashboardControlHooks): void;
+    /** Record one inbound request (or stream open). Returns the peer id. */
+    touchInbound(req: {
+        headers?: Record<string, string>;
+        source?: string;
+    }, taskIds?: string[]): string;
+    /** Mark a task finished for a peer (drops it from the active list). */
+    finishTask(peerId: string, taskId: string): void;
+    /** Mark a peer's streaming flag. */
+    setStreaming(peerId: string, streaming: boolean): void;
+    /** Remove an inbound peer (the "关闭" action severs tracking). */
+    removePeer(id: string): void;
+    /** Register or refresh an outbound agent connection. */
+    upsertAgent(agent: Omit<OutboundAgent, 'id' | 'lastSeen'>): string;
+    /** Remove an outbound agent by id or connectionId. */
+    removeAgent(connectionId: string): boolean;
+    /** Update one agent's state. */
+    setAgentState(connectionId: string, state: OutboundAgent['state']): void;
+    /** Touch one agent's last activity. */
+    touchAgent(connectionId: string): void;
+    snapshot(): DashboardSnapshot;
+    control(action: string, target: string, payload?: Record<string, unknown>): Promise<ControlResult>;
+    private closePeerLocal;
+}
+/** A client owned by the plugin entry, tracked for the dashboard. */
+export interface TrackedClient {
+    client: A2AClient;
+    connectionId: string;
+    name: string;
+    agentCardUrl: string;
+}
+/** Get the process-wide dashboard registry (creating it on first use). */
+export declare function getSharedRegistry(): DashboardRegistry;
+/** Test hook: reset the shared registry (and any hooks). */
+export declare function resetSharedRegistry(): void;
+//# sourceMappingURL=dashboard.d.ts.map

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

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

package/lib/types/errors.d.ts

@@ -0,0 +1,24 @@
+/**
+ * A2A (Agent2Agent) Protocol v1.0 — errors.
+ */
+/** An error produced by a remote A2A agent (JSON-RPC error object). */
+export interface A2ARemoteErrorInfo {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+/** Error class for A2A protocol failures, mirroring JSON-RPC error semantics. */
+export declare class A2AError extends Error {
+    readonly code: number;
+    readonly data?: unknown;
+    /** True when this error came from a remote agent over the wire. */
+    readonly remote: boolean;
+    constructor(code: number, message: string, data?: unknown, remote?: boolean);
+    toJsonRpc(): {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+    static fromJsonRpc(err: A2ARemoteErrorInfo): A2AError;
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,iFAAiF;AACjF,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;gBAEb,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,UAAQ;IAQzE,SAAS,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE;IAS9D,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,kBAAkB,GAAG,QAAQ;CAGtD"}

package/lib/types/index.d.ts

@@ -0,0 +1,89 @@
+/**
+ * dsh-a2a — Cordis plugin entry point for DeepSeek Harness.
+ *
+ * Mounts the A2A plugin inside a DSH composition. The plugin is
+ * configuration-driven and opportunistically consumes DSH services:
+ *
+ *   mode: 'client'  — fetch a remote AgentCard, register each skill as a
+ *                     model tool on `ctx.tools` (name `a2a__<name>__<skill>`).
+ *   mode: 'server'  — expose this DSH as an A2A agent: AgentCard +
+ *                     JSON-RPC endpoint on `ctx.webServer` (when mounted).
+ *
+ * Both modes feed a connection dashboard (see `dashboard.ts`) exposed at
+ * `/a2a/api` (state snapshot + reconnect/close controls), so the settings
+ * panel can show "who is connected to us" (inbound) and "who we are
+ * connected to" (outbound).
+ *
+ * Service access follows the native DSH pattern: services are declared via
+ * module augmentation and read as context properties inside `ctx.effect(...)`,
+ * so Cordis waits for availability and disposes registrations with the fiber.
+ * The plugin stays mounted in compositions that lack a service (it logs and
+ * idles); it never hard-depends on one.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import { type ServerOptions } from './server.js';
+export interface A2APluginConfig {
+    mode?: 'client' | 'server' | 'both';
+    name?: string;
+    agentCardUrl?: string;
+    bearerToken?: string;
+    timeoutMs?: number;
+    mapSkills?: boolean;
+    /** Explicitly enable the inbound A2A server (default off). */
+    serverEnabled?: boolean;
+    baseUrl?: string;
+    agentName?: string;
+    agentDescription?: string;
+    agentVersion?: string;
+    skills?: ServerOptions['skills'];
+    endpointPath?: string;
+    execute?: ServerOptions['execute'];
+    /** Serve the dashboard API on the webserver (default true). */
+    dashboard?: boolean;
+}
+export { A2AClient } from './client.js';
+export * from './protocol.js';
+export * from './errors.js';
+export { fetchAgentCard } from './card.js';
+export { A2AServer, TaskStore, defaultExecutor, defaultSkills } from './server.js';
+export { registerAgentTools } from './outbound.js';
+export { DashboardRegistry, getSharedRegistry } from './dashboard.js';
+export type { DashboardSnapshot, InboundPeer, OutboundAgent, ControlResult, } from './dashboard.js';
+/**
+ * Service shapes consumed from the DSH composition. Declared structurally so
+ * this package builds against `@deepseek-ai/cordis` alone (peer dependency);
+ * the runtime shapes are owned by `@deepseek-ai/dsh-host-webserver` and
+ * `@deepseek-ai/dsh-tools` respectively.
+ */
+export interface WebServerService {
+    /** The OS-assigned (or configured) listen port. */
+    readonly port: number;
+    /** The configured bind host literal ('127.0.0.1' | '0.0.0.0'). */
+    readonly host: string;
+    register(route: {
+        kind: 'exact' | 'prefix';
+        path: string;
+        handler: (req: IncomingMessage, res: ServerResponse) => void | Promise<void>;
+    }): () => void;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        /** Provided by @deepseek-ai/dsh-host-webserver. */
+        webServer: WebServerService;
+        /** Provided by @deepseek-ai/dsh-tools. */
+        tools: {
+            register(def: unknown): () => void;
+        };
+    }
+}
+export declare const name = "a2a";
+/**
+ * Services this plugin may read as context properties. Declared so property
+ * reads inside `apply` never trip Cordis's "without inject" guard. The
+ * mode-specific wiring runs inside `ctx.inject(...)` for the single service it
+ * needs, so a composition lacking the other one simply idles that half.
+ */
+export declare const inject: readonly ["webServer", "tools"];
+export declare function apply(ctx: Context, config?: A2APluginConfig): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGjE,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAW5D,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAEpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAEnC,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACtE,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE;QACd,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC9E,GAAG,MAAM,IAAI,CAAC;CAChB;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,mDAAmD;QACnD,SAAS,EAAE,gBAAgB,CAAC;QAC5B,0CAA0C;QAC1C,KAAK,EAAE;YAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,IAAI,CAAA;SAAE,CAAC;KAC/C;CACF;AAQD,eAAO,MAAM,IAAI,QAAQ,CAAC;AAE1B;;;;;GAKG;AACH,eAAO,MAAM,MAAM,iCAAkC,CAAC;AAEtD,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,eAAoB,QA8e/D"}

package/lib/types/jsonrpc.d.ts

@@ -0,0 +1,40 @@
+/**
+ * A2A (Agent2Agent) Protocol v1.0 — JSON-RPC 2.0 transport client.
+ *
+ * Implements the JSONRPC protocol binding of A2A v1.0: a thin JSON-RPC 2.0
+ * client for unary calls plus an SSE reader for `SendStreamingMessage`.
+ */
+import type { StreamResponse } from './protocol.js';
+export interface JsonRpcClientOptions {
+    /** Timeout (ms) for a single unary call. Default 60000. */
+    timeoutMs?: number;
+    /** Optional bearer token. */
+    bearerToken?: string;
+    /** Custom fetch (tests). */
+    fetchImpl?: typeof fetch;
+}
+export interface JsonRpcCallOptions {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}
+export declare class JsonRpcClient {
+    readonly url: string;
+    private readonly timeoutMs;
+    private readonly bearerToken?;
+    private readonly fetchImpl;
+    private seq;
+    constructor(url: string, options?: JsonRpcClientOptions);
+    private headers;
+    /** Perform a unary JSON-RPC call. */
+    call<T>(method: string, params: unknown, options?: JsonRpcCallOptions): Promise<T>;
+    /**
+     * Open a streaming JSON-RPC call (`SendStreamingMessage`) over SSE and
+     * yield the `StreamResponse` events as they arrive. The connection is
+     * closed when the returned async iterator is broken or the request is
+     * cancelled. Events are decoded from SSE `data:` lines (JSON-RPC result
+     * frames); per A2A v1.0 the JSON structure uses member names to
+     * discriminate `task` / `message` / `statusUpdate` / `artifactUpdate`.
+     */
+    stream<T = StreamResponse>(method: string, params: unknown, options?: JsonRpcCallOptions): AsyncGenerator<T>;
+}
+//# 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,KAAK,EAAmD,cAAc,EAAE,MAAM,eAAe,CAAC;AAGrG,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,aAAa;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,GAAG,CAAK;gBAEJ,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB;IAO3D,OAAO,CAAC,OAAO;IAUf,qCAAqC;IAC/B,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,CAAC,CAAC;IA6C5F;;;;;;;OAOG;IACI,MAAM,CAAC,CAAC,GAAG,cAAc,EAC9B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,OAAO,GAAE,kBAAuB,GAC/B,cAAc,CAAC,CAAC,CAAC;CA8ErB"}

package/lib/types/outbound.d.ts

@@ -0,0 +1,45 @@
+/**
+ * dsh-a2a — outbound half: bridge remote A2A agent skills into DSH's tool
+ * registry (`ctx.tools`).
+ *
+ * Each skill on a remote AgentCard becomes a model-facing tool named
+ * `a2a__<agentName>__<skillId>` (normalized to the DSH function-name
+ * contract: `[A-Za-z0-9_-]`, ≤64 chars; on collision a deterministic hash is
+ * appended, mirroring dsh-mcp-client's naming rule).
+ */
+import type { AgentCard } from './protocol.js';
+export interface ToolLike {
+    register?(definition: unknown): (() => void) | void;
+}
+export interface OutboundOptions {
+    /** Namespace prefix for tool names (lowercase, unique across instances). */
+    name: string;
+    agentCardUrl: string;
+    bearerToken?: string;
+    /** Per-call timeout in ms. Default 60000. */
+    timeoutMs?: number;
+    /** Register one generic tool per skill (default true). */
+    mapSkills?: boolean;
+    /**
+     * Optional connection-lifecycle observation: called once the AgentCard is
+     * fetched and the connection is usable. `connectionId` is the stable id the
+     * dashboard tracks this connection under.
+     */
+    onReady?: (info: {
+        connectionId: string;
+        card: AgentCard;
+    }) => void;
+    /** Called when the connection (and its tools) are torn down. */
+    onDispose?: (connectionId: string) => void;
+}
+export interface RegisteredTool {
+    name: string;
+    /** Stable id of the client connection this tool belongs to. */
+    connectionId?: string;
+    dispose: () => void;
+}
+/**
+ * Register all skills of a remote agent on `ctx.tools` and return disposers.
+ */
+export declare function registerAgentTools(tools: ToolLike, options: OutboundOptions): Promise<RegisteredTool[]>;
+//# sourceMappingURL=outbound.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"outbound.d.ts","sourceRoot":"","sources":["../../src/outbound.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAA6B,MAAM,eAAe,CAAC;AAK1E,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,CAAC,UAAU,EAAE,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,CAAA;KAAE,KAAK,IAAI,CAAC;IACpE,gEAAgE;IAChE,SAAS,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AAmCD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,EAAE,CAAC,CAsC3B"}