@hanphone/dsh-a2a 0.1.0

package/lib/types/server/routes.js

@@ -0,0 +1,131 @@
+/**
+ * HTTP binding for the inbound server: registers the AgentCard route and the
+ * JSON-RPC / SSE endpoint on a structural webServer (normally
+ * `@deepseek-ai/dsh-host-webserver`), with runtime enable/disable.
+ * @module dsh-a2a/server/routes
+ */
+const CARD_PATH = '/.well-known/agent-card.json';
+/** Runtime-registered HTTP routes for one A2A server. */
+export class A2aRoutes {
+    webServer;
+    server;
+    disposers = [];
+    registered = false;
+    constructor(webServer, server) {
+        this.webServer = webServer;
+        this.server = server;
+    }
+    get active() {
+        return this.registered;
+    }
+    /** Register the AgentCard + endpoint routes (idempotent). */
+    enable() {
+        if (this.registered)
+            return;
+        this.disposers.push(this.webServer.register({
+            kind: 'exact',
+            path: CARD_PATH,
+            handler: (_req, res) => {
+                res.writeHead(200, { 'content-type': 'application/json' });
+                res.end(JSON.stringify(this.server.card));
+            },
+        }));
+        this.disposers.push(this.webServer.register({
+            kind: 'prefix',
+            path: endpointPathOf(this.server),
+            handler: (req, res) => this.onRequest(req, res),
+        }));
+        this.registered = true;
+    }
+    /** Unregister the routes (idempotent). */
+    disable() {
+        for (const disposer of this.disposers.splice(0))
+            disposer();
+        this.registered = false;
+    }
+    dispose() {
+        this.disable();
+    }
+    async onRequest(req, res) {
+        const path = (req.url ?? '').split('?')[0] ?? '';
+        const streaming = (req.method === 'POST' && (req.headers.accept ?? '').includes('text/event-stream'));
+        if (req.method === 'POST' && path === endpointPathOf(this.server)) {
+            const body = await readBody(req);
+            if (streaming) {
+                // Authorize BEFORE writing 200 so a 401 can still carry a plain status.
+                if (!this.server.authorized(toServerReq(req))) {
+                    res.writeHead(401, { 'content-type': 'text/plain', 'WWW-Authenticate': 'Bearer' });
+                    res.end('Unauthorized');
+                    return;
+                }
+                res.writeHead(200, {
+                    'content-type': 'text/event-stream',
+                    'cache-control': 'no-cache',
+                    connection: 'keep-alive',
+                    'x-accel-buffering': 'no',
+                });
+                const outcome = await this.server.handleStream(toServerReq(req), body, (frame) => res.write(frame));
+                if (outcome.status !== 200) {
+                    res.writeHead(outcome.status, { 'content-type': 'text/plain', ...(outcome.headers ?? {}) });
+                    res.end('Unauthorized');
+                    return;
+                }
+                res.end();
+                return;
+            }
+            const out = await this.server.handle(toServerReq(req), body);
+            res.writeHead(out.status, { 'content-type': out.contentType, ...(out.headers ?? {}) });
+            res.end(out.body);
+            return;
+        }
+        // GET AgentCard at the well-known path; anything else is the server's call.
+        const out = await this.server.handle(toServerReq(req), path === CARD_PATH ? '' : '');
+        res.writeHead(out.status, { 'content-type': out.contentType, ...(out.headers ?? {}) });
+        res.end(out.body);
+    }
+}
+function endpointPathOf(server) {
+    const url = server.card.supportedInterfaces?.[0]?.url;
+    if (!url)
+        return '/a2a';
+    try {
+        return new URL(url).pathname;
+    }
+    catch {
+        return '/a2a';
+    }
+}
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', (chunk) => chunks.push(chunk));
+        req.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
+        req.once('error', reject);
+    });
+}
+function toServerReq(req) {
+    const headers = {};
+    for (const [key, value] of Object.entries(req.headers)) {
+        if (typeof value === 'string')
+            headers[key] = value;
+        else if (Array.isArray(value))
+            headers[key] = value.join(', ');
+    }
+    const method = req.method;
+    const url = req.url;
+    const socket = req.socket;
+    return {
+        ...(method !== undefined ? { method } : {}),
+        ...(url !== undefined ? { url } : {}),
+        headers,
+        ...(socket
+            ? {
+                socket: {
+                    ...(socket.remoteAddress !== undefined ? { remoteAddress: socket.remoteAddress } : {}),
+                    ...(socket.remotePort !== undefined ? { remotePort: socket.remotePort } : {}),
+                },
+            }
+            : {}),
+    };
+}
+//# sourceMappingURL=routes.js.map

package/lib/types/server/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../src/server/routes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,MAAM,SAAS,GAAG,8BAA8B,CAAA;AAEhD,yDAAyD;AACzD,MAAM,OAAO,SAAS;IAKD;IACA;IALX,SAAS,GAAsB,EAAE,CAAA;IACjC,UAAU,GAAG,KAAK,CAAA;IAE1B,YACmB,SAAwB,EACxB,MAAiB;QADjB,cAAS,GAAT,SAAS,CAAe;QACxB,WAAM,GAAN,MAAM,CAAW;IACjC,CAAC;IAEJ,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,UAAU,CAAA;IACxB,CAAC;IAED,6DAA6D;IAC7D,MAAM;QACJ,IAAI,IAAI,CAAC,UAAU;YAAE,OAAM;QAC3B,IAAI,CAAC,SAAS,CAAC,IAAI,CACjB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;YACtB,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;gBACrB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAA;gBAC1D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;YAC3C,CAAC;SACF,CAAC,CACH,CAAA;QACD,IAAI,CAAC,SAAS,CAAC,IAAI,CACjB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;YACtB,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;YACjC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;SAChD,CAAC,CACH,CAAA;QACD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAA;IACxB,CAAC;IAED,0CAA0C;IAC1C,OAAO;QACL,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;YAAE,QAAQ,EAAE,CAAA;QAC3D,IAAI,CAAC,UAAU,GAAG,KAAK,CAAA;IACzB,CAAC;IAED,OAAO;QACL,IAAI,CAAC,OAAO,EAAE,CAAA;IAChB,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,GAAoB,EAAE,GAAmB;QAC/D,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QAChD,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAA;QAErG,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,IAAI,IAAI,KAAK,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAA;YAChC,IAAI,SAAS,EAAE,CAAC;gBACd,wEAAwE;gBACxE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;oBAC9C,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,kBAAkB,EAAE,QAAQ,EAAE,CAAC,CAAA;oBAClF,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;oBACvB,OAAM;gBACR,CAAC;gBACD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;oBACjB,cAAc,EAAE,mBAAmB;oBACnC,eAAe,EAAE,UAAU;oBAC3B,UAAU,EAAE,YAAY;oBACxB,mBAAmB,EAAE,IAAI;iBAC1B,CAAC,CAAA;gBACF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;gBACnG,IAAI,OAAO,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBAC3B,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC,CAAA;oBAC3F,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;oBACvB,OAAM;gBACR,CAAC;gBACD,GAAG,CAAC,GAAG,EAAE,CAAA;gBACT,OAAM;YACR,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAA;YAC5D,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC,CAAA;YACtF,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YACjB,OAAM;QACR,CAAC;QAED,4EAA4E;QAC5E,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;QACpF,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC,CAAA;QACtF,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACnB,CAAC;CACF;AAED,SAAS,cAAc,CAAC,MAAiB;IACvC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAA;IACrD,IAAI,CAAC,GAAG;QAAE,OAAO,MAAM,CAAA;IACvB,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAA;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAA;IACf,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,GAAoB;IACpC,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC7C,MAAM,MAAM,GAAa,EAAE,CAAA;QAC3B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;QACrD,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QACpE,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAC3B,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,GAAoB;IAMvC,MAAM,OAAO,GAA2B,EAAE,CAAA;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACvD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;aAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAChE,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAA;IACzB,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAA;IACnB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAA;IACzB,OAAO;QACL,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,OAAO;QACP,GAAG,CAAC,MAAM;YACR,CAAC,CAAC;gBACA,MAAM,EAAE;oBACN,GAAG,CAAC,MAAM,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACtF,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC9E;aACF;YACD,CAAC,CAAC,EAAE,CAAC;KACR,CAAA;AACH,CAAC"}

package/lib/types/server/store.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Durable task storage for the inbound half: one `a2a` domain over the routed
+ * storage backend (the deployment picks the medium, normally SQLite). Records
+ * are serialized JSON so the domain tables stay plain kv rows; the domain
+ * SCHEMA_VERSION guards format evolution. A memory store keeps unit tests and
+ * minimal embeddings free of a backend.
+ * @module dsh-a2a/server/store
+ */
+import { type Domain, type DomainFacility, type KvTable } from '@deepseek-ai/dsh-storage-domain';
+import { TaskState, type Part } from '../protocol.ts';
+/** One durable inbound/outbound task record. */
+export interface TaskRecord {
+    readonly taskId: string;
+    readonly contextId: string;
+    readonly skill: string;
+    readonly state: TaskState;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly sessionId: string | null;
+    readonly remotePeerId: string | null;
+    readonly parts: readonly Part[];
+    readonly artifacts: readonly {
+        readonly artifactId: string;
+        readonly name?: string;
+        readonly parts: readonly Part[];
+    }[];
+    readonly executor: 'session' | 'subagent';
+    readonly summary: string | null;
+    readonly error?: {
+        readonly code: string;
+        readonly message: string;
+    };
+}
+/** One durable context→session binding (inbound conversation ↔ DSH session). */
+export interface ContextBinding {
+    readonly sessionId: string;
+}
+/** One durable outbound agent record (client registry persistence). */
+export interface OutboundAgentRecord {
+    readonly id: string;
+    readonly name: string;
+    readonly agentCardUrl: string;
+    readonly bearerTokenEnv?: string;
+    readonly enabled: boolean;
+    readonly timeoutMs: number;
+    readonly lastCardAt: string | null;
+}
+/** The `a2a` storage domain: JSON-encoded records, one table per record kind. */
+export declare const a2aDomainSpec: {
+    name: string;
+    version: number;
+    tables: {
+        tasks: import("@deepseek-ai/dsh-storage-domain").DomainTableSpec<string, string>;
+        contexts: import("@deepseek-ai/dsh-storage-domain").DomainTableSpec<string, string>;
+        agents: import("@deepseek-ai/dsh-storage-domain").DomainTableSpec<string, string>;
+    };
+};
+export type A2aDomainSpec = typeof a2aDomainSpec;
+/**
+ * Serialize/deserialize helpers for the domain tables. Plain JSON round-trip
+ * with shape assertions; `decodeRecord` returns undefined on any mismatch.
+ */
+export declare function encodeRecord(value: unknown): string;
+export declare function decodeRecord<T>(raw: string): T | undefined;
+/**
+ * Open the `a2a` domain on the mounted storage-domain facility and expose
+ * its tables. The caller owns the returned handle and closes it on teardown.
+ */
+export declare function openDomain(domain: DomainFacility): Promise<A2aDomain>;
+/** A2a domain facade: typed JSON tables over the routed backend. */
+export declare class A2aDomain {
+    readonly handle: Domain<A2aDomainSpec>;
+    constructor(handle: Domain<A2aDomainSpec>);
+    get tasks(): KvTable<string, string>;
+    get contexts(): KvTable<string, string>;
+    get agents(): KvTable<string, string>;
+    close(): Promise<void>;
+}
+/** Task-store contract shared by the domain-backed and memory stores. */
+export interface TaskStore {
+    create(input: {
+        contextId: string;
+        skill: string;
+        parts: readonly Part[];
+        remotePeerId: string | null;
+    }): TaskRecord;
+    get(taskId: string): TaskRecord | undefined;
+    list(): TaskRecord[];
+    setState(taskId: string, state: TaskState, message?: {
+        code: string;
+        text: string;
+    }): TaskRecord;
+    appendArtifact(taskId: string, artifact: {
+        artifactId: string;
+        name?: string;
+        parts: readonly Part[];
+        lastChunk?: boolean;
+    }): TaskRecord;
+    setContextSession(contextId: string, sessionId: string): Promise<void>;
+    getContextSession(contextId: string): Promise<string | undefined>;
+    close(): Promise<void>;
+}
+/** In-memory TaskStore (unit tests, minimal embeddings). */
+export declare class MemoryTaskStore implements TaskStore {
+    private tasks;
+    private contexts;
+    create(input: {
+        contextId: string;
+        skill: string;
+        parts: readonly Part[];
+        remotePeerId: string | null;
+    }): TaskRecord;
+    get(taskId: string): TaskRecord | undefined;
+    list(): TaskRecord[];
+    setState(taskId: string, state: TaskState, message?: {
+        code: string;
+        text: string;
+    }): TaskRecord;
+    appendArtifact(taskId: string, artifact: {
+        artifactId: string;
+        name?: string;
+        parts: readonly Part[];
+        lastChunk?: boolean;
+    }): TaskRecord;
+    setContextSession(contextId: string, sessionId: string): Promise<void>;
+    getContextSession(contextId: string): Promise<string | undefined>;
+    close(): Promise<void>;
+}
+/** Domain-backed TaskStore (persistent; the composition path). */
+export declare class DomainTaskStore implements TaskStore {
+    private readonly domain;
+    private readonly records;
+    private readonly bindings;
+    constructor(domain: A2aDomain);
+    create(input: {
+        contextId: string;
+        skill: string;
+        parts: readonly Part[];
+        remotePeerId: string | null;
+    }): TaskRecord;
+    get(taskId: string): TaskRecord | undefined;
+    list(): TaskRecord[];
+    setState(taskId: string, state: TaskState, message?: {
+        code: string;
+        text: string;
+    }): TaskRecord;
+    appendArtifact(taskId: string, artifact: {
+        artifactId: string;
+        name?: string;
+        parts: readonly Part[];
+        lastChunk?: boolean;
+    }): TaskRecord;
+    setContextSession(contextId: string, sessionId: string): Promise<void>;
+    getContextSession(contextId: string): Promise<string | undefined>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=store.d.ts.map

package/lib/types/server/store.d.ts.map

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

package/lib/types/server/store.js

@@ -0,0 +1,239 @@
+/**
+ * Durable task storage for the inbound half: one `a2a` domain over the routed
+ * storage backend (the deployment picks the medium, normally SQLite). Records
+ * are serialized JSON so the domain tables stay plain kv rows; the domain
+ * SCHEMA_VERSION guards format evolution. A memory store keeps unit tests and
+ * minimal embeddings free of a backend.
+ * @module dsh-a2a/server/store
+ */
+import { z } from 'zod';
+import { defineDomain, domainTable, } from '@deepseek-ai/dsh-storage-domain';
+import { TaskState } from "../protocol.js";
+/** JSON-encoded record schema shared by every `a2a` table. */
+const json = z.string();
+/** The `a2a` storage domain: JSON-encoded records, one table per record kind. */
+export const a2aDomainSpec = defineDomain({
+    name: 'a2a',
+    version: 1,
+    tables: {
+        tasks: domainTable(json),
+        contexts: domainTable(json),
+        agents: domainTable(json),
+    },
+});
+/**
+ * Serialize/deserialize helpers for the domain tables. Plain JSON round-trip
+ * with shape assertions; `decodeRecord` returns undefined on any mismatch.
+ */
+export function encodeRecord(value) {
+    return JSON.stringify(value);
+}
+export function decodeRecord(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Open the `a2a` domain on the mounted storage-domain facility and expose
+ * its tables. The caller owns the returned handle and closes it on teardown.
+ */
+export async function openDomain(domain) {
+    const handle = await domain.open(a2aDomainSpec);
+    return new A2aDomain(handle);
+}
+/** A2a domain facade: typed JSON tables over the routed backend. */
+export class A2aDomain {
+    handle;
+    constructor(handle) {
+        this.handle = handle;
+    }
+    get tasks() {
+        return this.handle.table('tasks');
+    }
+    get contexts() {
+        return this.handle.table('contexts');
+    }
+    get agents() {
+        return this.handle.table('agents');
+    }
+    async close() {
+        await this.handle.close();
+    }
+}
+function now() {
+    return new Date().toISOString();
+}
+function recordKey(taskId) {
+    return `task:${taskId}`;
+}
+function contextKey(contextId) {
+    return `ctx:${contextId}`;
+}
+/** In-memory TaskStore (unit tests, minimal embeddings). */
+export class MemoryTaskStore {
+    tasks = new Map();
+    contexts = new Map();
+    create(input) {
+        const record = {
+            taskId: `a2a-${crypto.randomUUID()}`,
+            contextId: input.contextId,
+            skill: input.skill,
+            state: TaskState.SUBMITTED,
+            createdAt: now(),
+            updatedAt: now(),
+            sessionId: null,
+            remotePeerId: input.remotePeerId,
+            parts: input.parts,
+            artifacts: [],
+            executor: 'session',
+            summary: null,
+        };
+        this.tasks.set(record.taskId, record);
+        return record;
+    }
+    get(taskId) {
+        return this.tasks.get(taskId);
+    }
+    list() {
+        return [...this.tasks.values()];
+    }
+    setState(taskId, state, message) {
+        const current = this.tasks.get(taskId);
+        if (current === undefined)
+            throw new Error(`task ${taskId} not found`);
+        const next = {
+            ...current,
+            state,
+            updatedAt: now(),
+            ...(message ? { error: { code: message.code, message: message.text } } : current.error ? { error: current.error } : {}),
+        };
+        this.tasks.set(taskId, next);
+        return next;
+    }
+    appendArtifact(taskId, artifact) {
+        const current = this.tasks.get(taskId);
+        if (current === undefined)
+            throw new Error(`task ${taskId} not found`);
+        const next = {
+            ...current,
+            updatedAt: now(),
+            artifacts: appendArtifactRecord(current.artifacts, artifact),
+        };
+        this.tasks.set(taskId, next);
+        return next;
+    }
+    async setContextSession(contextId, sessionId) {
+        this.contexts.set(contextId, sessionId);
+    }
+    async getContextSession(contextId) {
+        return this.contexts.get(contextId);
+    }
+    async close() { }
+}
+function appendArtifactRecord(artifacts, artifact) {
+    const existing = artifacts.find((a) => a.artifactId === artifact.artifactId);
+    if (existing) {
+        return artifacts.map((a) => (a.artifactId === artifact.artifactId ? { ...a, parts: [...a.parts, ...artifact.parts] } : a));
+    }
+    return [...artifacts, { artifactId: artifact.artifactId, ...(artifact.name !== undefined ? { name: artifact.name } : {}), parts: artifact.parts }];
+}
+/** Domain-backed TaskStore (persistent; the composition path). */
+export class DomainTaskStore {
+    domain;
+    // The real `KvTable.put` queues on the domain's write chain: durability
+    // first, then the in-memory table updates. TaskStore's synchronous readers
+    // must see their own writes immediately, so this store keeps the live view
+    // in memory, seeds it from the domain's opened tables (already loaded from
+    // the medium), updates it before each queued write, and never reads the
+    // table back for its own writes.
+    records = new Map();
+    bindings = new Map();
+    constructor(domain) {
+        this.domain = domain;
+        for (const [key, raw] of domain.tasks.entries()) {
+            if (!key.startsWith('task:'))
+                continue;
+            const record = decodeRecord(raw);
+            if (record !== undefined)
+                this.records.set(record.taskId, record);
+        }
+        for (const [key, raw] of domain.contexts.entries()) {
+            if (!key.startsWith('ctx:'))
+                continue;
+            const binding = decodeRecord(raw);
+            if (binding !== undefined)
+                this.bindings.set(key.slice('ctx:'.length), binding.sessionId);
+        }
+    }
+    create(input) {
+        const record = {
+            taskId: `a2a-${crypto.randomUUID()}`,
+            contextId: input.contextId,
+            skill: input.skill,
+            state: TaskState.SUBMITTED,
+            createdAt: now(),
+            updatedAt: now(),
+            sessionId: null,
+            remotePeerId: input.remotePeerId,
+            parts: input.parts,
+            artifacts: [],
+            executor: 'session',
+            summary: null,
+        };
+        this.records.set(record.taskId, record);
+        // Persist eagerly; a failed write must fail the task, not silently lose it.
+        void this.domain.tasks.put(recordKey(record.taskId), encodeRecord(record)).catch((err) => {
+            throw new Error(`a2a: task persistence failed: ${String(err)}`);
+        });
+        return record;
+    }
+    get(taskId) {
+        return this.records.get(taskId);
+    }
+    list() {
+        return [...this.records.values()];
+    }
+    setState(taskId, state, message) {
+        const current = this.records.get(taskId);
+        if (current === undefined)
+            throw new Error(`task ${taskId} not found`);
+        const next = withState(current, state, message, now());
+        this.records.set(taskId, next);
+        void this.domain.tasks.put(recordKey(taskId), encodeRecord(next)).catch((err) => {
+            throw new Error(`a2a: task persistence failed: ${String(err)}`);
+        });
+        return next;
+    }
+    appendArtifact(taskId, artifact) {
+        const current = this.records.get(taskId);
+        if (current === undefined)
+            throw new Error(`task ${taskId} not found`);
+        const next = { ...current, updatedAt: now(), artifacts: appendArtifactRecord(current.artifacts, artifact) };
+        this.records.set(taskId, next);
+        void this.domain.tasks.put(recordKey(taskId), encodeRecord(next)).catch((err) => {
+            throw new Error(`a2a: task persistence failed: ${String(err)}`);
+        });
+        return next;
+    }
+    async setContextSession(contextId, sessionId) {
+        const binding = { sessionId };
+        this.bindings.set(contextId, sessionId);
+        await this.domain.contexts.put(contextKey(contextId), encodeRecord(binding));
+    }
+    async getContextSession(contextId) {
+        return this.bindings.get(contextId);
+    }
+    async close() { }
+}
+function withState(current, state, message, timestamp) {
+    return {
+        ...current,
+        state,
+        updatedAt: timestamp,
+        ...(message ? { error: { code: message.code, message: message.text } } : {}),
+    };
+}
+//# sourceMappingURL=store.js.map

package/lib/types/server/store.js.map

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

package/lib/types/service.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The `ctx.a2a` service facade: the thin read/control surface commands and
+ * other plugins use. Registered as a Cordis Service so the key disappears
+ * with the plugin fiber.
+ * @module dsh-a2a/service
+ */
+import { Service, type Context } from '@deepseek-ai/cordis';
+/** A result with a user-facing message. */
+export interface OpResult {
+    readonly ok: boolean;
+    readonly message: string;
+}
+/** The implementation the facade delegates to (owned by the plugin assembly). */
+export interface A2AServiceImpl {
+    status(): unknown;
+    enableServer(enable: boolean): Promise<OpResult>;
+    getTask(taskId: string): unknown;
+    listTasks(): unknown;
+    cancelTask(taskId: string): Promise<OpResult>;
+    agents(): unknown;
+    addAgent(spec: {
+        readonly name: string;
+        readonly agentCardUrl: string;
+        readonly bearerTokenEnv?: string;
+    }): Promise<OpResult>;
+    removeAgent(id: string): Promise<OpResult>;
+    setAgentEnabled(id: string, enabled: boolean): Promise<OpResult>;
+    refreshAgentCard(id: string): Promise<OpResult>;
+}
+/** The service other plugins read as `ctx.a2a`. */
+export declare class A2AService extends Service {
+    private readonly impl;
+    constructor(ctx: Context, impl: A2AServiceImpl);
+    status(): unknown;
+    enableServer(enable: boolean): Promise<OpResult>;
+    getTask(taskId: string): unknown;
+    listTasks(): unknown;
+    cancelTask(taskId: string): Promise<OpResult>;
+    agents(): unknown;
+    addAgent(spec: {
+        readonly name: string;
+        readonly agentCardUrl: string;
+        readonly bearerTokenEnv?: string;
+    }): Promise<OpResult>;
+    removeAgent(id: string): Promise<OpResult>;
+    setAgentEnabled(id: string, enabled: boolean): Promise<OpResult>;
+    refreshAgentCard(id: string): Promise<OpResult>;
+}
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAE3D,2CAA2C;AAC3C,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,MAAM,IAAI,OAAO,CAAA;IACjB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAChD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;IAChC,SAAS,IAAI,OAAO,CAAA;IACpB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC7C,MAAM,IAAI,OAAO,CAAA;IACjB,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC7H,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1C,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAChE,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CAChD;AAED,mDAAmD;AACnD,qBAAa,UAAW,SAAQ,OAAO;IAGnC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBADrB,GAAG,EAAE,OAAO,EACK,IAAI,EAAE,cAAc;IAKvC,MAAM,IAAI,OAAO;IAIX,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAItD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIhC,SAAS,IAAI,OAAO;IAId,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAInD,MAAM,IAAI,OAAO;IAIX,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI7H,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI1C,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIhE,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;CAGtD"}

package/lib/types/service.js

@@ -0,0 +1,46 @@
+/**
+ * The `ctx.a2a` service facade: the thin read/control surface commands and
+ * other plugins use. Registered as a Cordis Service so the key disappears
+ * with the plugin fiber.
+ * @module dsh-a2a/service
+ */
+import { Service } from '@deepseek-ai/cordis';
+/** The service other plugins read as `ctx.a2a`. */
+export class A2AService extends Service {
+    impl;
+    constructor(ctx, impl) {
+        super(ctx, 'a2a');
+        this.impl = impl;
+    }
+    status() {
+        return this.impl.status();
+    }
+    async enableServer(enable) {
+        return this.impl.enableServer(enable);
+    }
+    getTask(taskId) {
+        return this.impl.getTask(taskId);
+    }
+    listTasks() {
+        return this.impl.listTasks();
+    }
+    async cancelTask(taskId) {
+        return this.impl.cancelTask(taskId);
+    }
+    agents() {
+        return this.impl.agents();
+    }
+    async addAgent(spec) {
+        return this.impl.addAgent(spec);
+    }
+    async removeAgent(id) {
+        return this.impl.removeAgent(id);
+    }
+    async setAgentEnabled(id, enabled) {
+        return this.impl.setAgentEnabled(id, enabled);
+    }
+    async refreshAgentCard(id) {
+        return this.impl.refreshAgentCard(id);
+    }
+}
+//# sourceMappingURL=service.js.map

package/lib/types/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAgB,MAAM,qBAAqB,CAAA;AAsB3D,mDAAmD;AACnD,MAAM,OAAO,UAAW,SAAQ,OAAO;IAGlB;IAFnB,YACE,GAAY,EACK,IAAoB;QAErC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAFA,SAAI,GAAJ,IAAI,CAAgB;IAGvC,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAA;IAC3B,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAAe;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;IACvC,CAAC;IAED,OAAO,CAAC,MAAc;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAClC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAA;IAC9B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;IACrC,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAA;IAC3B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAgG;QAC7G,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IACjC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,EAAU;QAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;IAClC,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,EAAU,EAAE,OAAgB;QAChD,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IAC/C,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,EAAU;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAA;IACvC,CAAC;CACF"}