@hanphone/dsh-a2a 0.1.0

package/lib/types/server/exec/agent-runtime.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Shared agent machinery for the inbound executors: one DSH agent session per
+ * A2A context (create, or resume a persisted one), serialized turns, and
+ * optional agent-preset composition so a spawned session actually carries
+ * tools. Adapted from the createDshAgentExecutor pattern pioneered by
+ * dsh-a2a (MIT).
+ * @module dsh-a2a/server/exec/agent-runtime
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** The slice of a live DSH `Agent` this runtime drives (structural mirror). */
+export interface LiveAgent {
+    readonly session: {
+        deriveMessages(): readonly AgentMessage[];
+    };
+    send(message: AgentUserMessage, target: 'next-turn', wakeup: boolean): void;
+    whenIdle(): Promise<void>;
+    cancel(cause: string): void;
+}
+/** One derived history message. */
+export interface AgentMessage {
+    readonly role: 'user' | 'assistant';
+    readonly content: readonly {
+        readonly type: string;
+        readonly text?: string;
+    }[];
+}
+/** One user message handed to the agent. */
+export interface AgentUserMessage {
+    readonly id: string;
+    readonly role: 'user';
+    readonly content: readonly {
+        readonly type: 'text';
+        readonly text: string;
+    }[];
+    readonly source: {
+        readonly kind: 'plugin';
+        readonly plugin: string;
+    };
+}
+/** Owned agent plus its capability disposer (structural mirror of AgentHandle). */
+export interface AgentHandle {
+    readonly agent: LiveAgent;
+    dispose(): Promise<void>;
+}
+/** Structural slice of `ctx.agents` this runtime calls. */
+export interface AgentRegistryLike {
+    create(options: {
+        readonly sessionId: string;
+        readonly meta?: {
+            readonly cwd?: string;
+            readonly agentPreset?: string;
+        };
+        readonly agentOptions?: {
+            readonly provider?: string;
+            readonly model?: string;
+            readonly maxTokens?: number;
+        };
+        readonly setup?: (agentCtx: unknown) => void | Promise<void>;
+    }): Promise<AgentHandle>;
+    resume(options: {
+        readonly resumeSessionId: string;
+        readonly agentOptions?: {
+            readonly provider?: string;
+            readonly model?: string;
+            readonly maxTokens?: number;
+        };
+        readonly setup?: (agentCtx: unknown) => void | Promise<void>;
+    }): Promise<AgentHandle>;
+}
+/** Structural slice of `ctx.agentPresets` (preset roster). */
+export interface AgentPresetsLike {
+    resolve(id?: string): Promise<{
+        readonly id: string;
+    }>;
+    mount(agentCtx: unknown, id: string): Promise<unknown>;
+}
+/** Runtime options shared by the executors. */
+export interface AgentRuntimeOptions {
+    /** Absolute cwd frozen into each spawned session's durable header. */
+    readonly cwd: string;
+    /** Optional per-task model resolution (reads the deployment default). */
+    readonly resolveAgentOptions?: () => {
+        readonly provider?: string;
+        readonly model?: string;
+        readonly maxTokens?: number;
+    } | undefined;
+    /** Preset roster; when present every spawned session joins the default preset. */
+    readonly agentPresets?: AgentPresetsLike;
+    /** Once-per-context hook after the first prompt lands (cosmetic naming). */
+    readonly onSessionOpened?: (info: {
+        readonly sessionId: string;
+        readonly contextId: string;
+        readonly firstPrompt: string;
+    }) => void | Promise<void>;
+}
+/**
+ * Per-context session pool: one live DSH agent per A2A contextId, created or
+ * resumed through the registry, turns serialized per context, every session
+ * disposeable on teardown.
+ */
+export declare class ContextSessionPool {
+    private readonly agents;
+    private readonly opts;
+    private readonly handles;
+    private readonly tails;
+    constructor(agents: AgentRegistryLike, opts: AgentRuntimeOptions);
+    /** Session id derived from the A2A context id (stable across restarts). */
+    static sessionIdFor(contextId: string): string;
+    /** Get or open the live agent for a context; errors propagate. */
+    agentFor(contextId: string): Promise<{
+        readonly agent: LiveAgent;
+        readonly sessionId: string;
+        readonly justOpened: boolean;
+    }>;
+    /** Run one turn on a context's session, serialized behind its tail. */
+    runTurn(contextId: string, prompt: string, signal: AbortSignal): Promise<string>;
+    /** Dispose every live per-context session (called on plugin unload). */
+    disposeAll(): Promise<void>;
+}
+/**
+ * Probe for a readable service method via the reflection layer WITHOUT taking
+ * an inject dependency (optional services). Returns undefined when the service
+ * is absent or the method missing.
+ */
+export declare function probeService(ctx: Context, name: string, method: string): unknown;
+//# sourceMappingURL=agent-runtime.d.ts.map

package/lib/types/server/exec/agent-runtime.d.ts.map

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

package/lib/types/server/exec/agent-runtime.js

@@ -0,0 +1,138 @@
+/**
+ * Shared agent machinery for the inbound executors: one DSH agent session per
+ * A2A context (create, or resume a persisted one), serialized turns, and
+ * optional agent-preset composition so a spawned session actually carries
+ * tools. Adapted from the createDshAgentExecutor pattern pioneered by
+ * dsh-a2a (MIT).
+ * @module dsh-a2a/server/exec/agent-runtime
+ */
+/**
+ * Per-context session pool: one live DSH agent per A2A contextId, created or
+ * resumed through the registry, turns serialized per context, every session
+ * disposeable on teardown.
+ */
+export class ContextSessionPool {
+    agents;
+    opts;
+    handles = new Map();
+    tails = new Map();
+    constructor(agents, opts) {
+        this.agents = agents;
+        this.opts = opts;
+    }
+    /** Session id derived from the A2A context id (stable across restarts). */
+    static sessionIdFor(contextId) {
+        return `a2a-${contextId}`;
+    }
+    /** Get or open the live agent for a context; errors propagate. */
+    async agentFor(contextId) {
+        const sessionId = ContextSessionPool.sessionIdFor(contextId);
+        const existing = this.handles.get(contextId);
+        if (existing !== undefined)
+            return { agent: existing.agent, sessionId, justOpened: false };
+        const agentOptions = this.opts.resolveAgentOptions?.();
+        const withModel = agentOptions ? { agentOptions } : {};
+        const presets = this.opts.agentPresets;
+        let presetId;
+        let setup;
+        if (presets !== undefined) {
+            presetId = (await presets.resolve()).id;
+            setup = async (agentCtx) => {
+                await presets.mount(agentCtx, presetId);
+            };
+        }
+        const meta = presetId
+            ? { cwd: this.opts.cwd, agentPreset: presetId }
+            : { cwd: this.opts.cwd };
+        const createOptions = {
+            sessionId,
+            meta,
+            ...withModel,
+            ...(setup ? { setup } : {}),
+        };
+        let handle;
+        try {
+            handle = await this.agents.create(createOptions);
+        }
+        catch (err) {
+            if (/already (has|owns)|persisted/i.test(err.message)) {
+                handle = await this.agents.resume({ resumeSessionId: sessionId, ...withModel, ...(setup ? { setup } : {}) });
+            }
+            else {
+                throw err;
+            }
+        }
+        this.handles.set(contextId, handle);
+        return { agent: handle.agent, sessionId, justOpened: true };
+    }
+    /** Run one turn on a context's session, serialized behind its tail. */
+    async runTurn(contextId, prompt, signal) {
+        const { agent, sessionId, justOpened } = await this.agentFor(contextId);
+        const onAbort = () => agent.cancel('a2a-canceled');
+        if (signal.aborted)
+            onAbort();
+        else
+            signal.addEventListener('abort', onAbort, { once: true });
+        const userMessage = {
+            id: crypto.randomUUID(),
+            role: 'user',
+            content: [{ type: 'text', text: prompt }],
+            source: { kind: 'plugin', plugin: 'a2a' },
+        };
+        agent.send(userMessage, 'next-turn', true);
+        if (justOpened) {
+            try {
+                await this.opts.onSessionOpened?.({ sessionId, contextId, firstPrompt: prompt });
+            }
+            catch {
+                // Cosmetic naming must never fail the task.
+            }
+        }
+        await agent.whenIdle();
+        return lastAssistantText(agent);
+    }
+    /** Dispose every live per-context session (called on plugin unload). */
+    async disposeAll() {
+        const live = [...this.handles.values()];
+        const pending = [...this.tails.values()];
+        this.handles.clear();
+        this.tails.clear();
+        await Promise.allSettled(pending);
+        await Promise.allSettled(live.map((h) => h.dispose()));
+    }
+}
+/** Read the last assistant message's text off the derived history. */
+function lastAssistantText(agent) {
+    const history = agent.session.deriveMessages();
+    for (let i = history.length - 1; i >= 0; i--) {
+        const message = history[i];
+        if (message === undefined)
+            continue;
+        if (message.role === 'assistant') {
+            return message.content
+                .map((b) => ('text' in b && typeof b.text === 'string' ? (b.text ?? '') : ''))
+                .filter(Boolean)
+                .join('\n')
+                .trim();
+        }
+    }
+    return '';
+}
+/**
+ * Probe for a readable service method via the reflection layer WITHOUT taking
+ * an inject dependency (optional services). Returns undefined when the service
+ * is absent or the method missing.
+ */
+export function probeService(ctx, name, method) {
+    try {
+        const reflect = ctx.reflect;
+        const svc = reflect?.get(name, true);
+        if (svc !== undefined && svc !== null && typeof svc[method] === 'function')
+            return svc;
+    }
+    catch {
+        // reflection unavailable or resolution threw — treat as absent
+    }
+    return undefined;
+}
+//# sourceMappingURL=agent-runtime.js.map

package/lib/types/server/exec/agent-runtime.js.map

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

package/lib/types/server/exec/session.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The `session` executor: one inbound task is one turn on the context's DSH
+ * agent session; reply text becomes the task's output part. Works on any
+ * composition with an agent loop (the `chat` skill and the default path).
+ * @module dsh-a2a/server/exec/session
+ */
+import type { A2aExecutor } from '../executor.ts';
+import { ContextSessionPool } from './agent-runtime.ts';
+/** Build the session executor over a context session pool. */
+export declare function createSessionExecutor(pool: ContextSessionPool): A2aExecutor;
+//# sourceMappingURL=session.d.ts.map

package/lib/types/server/exec/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../src/server/exec/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAuC,MAAM,gBAAgB,CAAA;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAEvD,8DAA8D;AAC9D,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,kBAAkB,GAAG,WAAW,CAa3E"}

package/lib/types/server/exec/session.js

@@ -0,0 +1,22 @@
+/**
+ * The `session` executor: one inbound task is one turn on the context's DSH
+ * agent session; reply text becomes the task's output part. Works on any
+ * composition with an agent loop (the `chat` skill and the default path).
+ * @module dsh-a2a/server/exec/session
+ */
+/** Build the session executor over a context session pool. */
+export function createSessionExecutor(pool) {
+    return {
+        name: 'session',
+        async execute(input) {
+            if (!input.prompt) {
+                return { parts: [{ text: 'No prompt provided.' }] };
+            }
+            const reply = await pool.runTurn(input.contextId, input.prompt, input.signal);
+            const text = (input.signal.aborted && !reply ? '(canceled)' : reply) || '(no reply)';
+            return { parts: [{ text }] };
+        },
+        disposeAll: () => pool.disposeAll(),
+    };
+}
+//# sourceMappingURL=session.js.map

package/lib/types/server/exec/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../../src/server/exec/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,8DAA8D;AAC9D,MAAM,UAAU,qBAAqB,CAAC,IAAwB;IAC5D,OAAO;QACL,IAAI,EAAE,SAAS;QACf,KAAK,CAAC,OAAO,CAAC,KAAuB;YACnC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBAClB,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC,EAAE,CAAA;YACrD,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;YAC7E,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,YAAY,CAAA;YACpF,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;QAC9B,CAAC;QACD,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE;KACpC,CAAA;AACH,CAAC"}

package/lib/types/server/exec/subagent.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The `subagent` executor: one inbound task is delegated to a named one-shot
+ * subagent under the context's parent session. The child runs with the
+ * composition's own tools and the delegation boundary; its output becomes the
+ * task's artifact. The subagent seam must be mounted, else the skill binding
+ * fails loudly at resolution time.
+ * @module dsh-a2a/server/exec/subagent
+ */
+import type { A2aExecutor } from '../executor.ts';
+import { ContextSessionPool } from './agent-runtime.ts';
+/** Structural slice of `ctx.subagents` this executor calls. */
+export interface SubagentsLike {
+    start(name: string, request: {
+        readonly label?: string;
+        readonly prompt: readonly {
+            readonly type: 'text';
+            readonly text: string;
+        }[];
+        readonly parent: unknown;
+        readonly signal: AbortSignal;
+    }): Promise<{
+        readonly result: Promise<{
+            readonly output: readonly {
+                readonly type: string;
+                readonly text?: string;
+            }[];
+        }>;
+        dispose(): Promise<void>;
+    }>;
+}
+export interface SubagentExecutorOptions {
+    readonly pool: ContextSessionPool;
+    readonly subagents: SubagentsLike;
+    /** Provider name (e.g. 'in-process'); configurable per deployment. */
+    readonly provider: string;
+}
+/** Build a subagent executor delegating inbound tasks to one-shot children. */
+export declare function createSubagentExecutor(opts: SubagentExecutorOptions): A2aExecutor;
+//# sourceMappingURL=subagent.d.ts.map

package/lib/types/server/exec/subagent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../../../../src/server/exec/subagent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAuC,MAAM,gBAAgB,CAAA;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAEvD,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,KAAK,CACH,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QACP,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,MAAM,EAAE,SAAS;YAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;QAC5E,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;QACxB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;KAC7B,GACA,OAAO,CAAC;QAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;YAAE,QAAQ,CAAC,MAAM,EAAE,SAAS;gBAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;aAAE,EAAE,CAAA;SAAE,CAAC,CAAC;QAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC,CAAA;CACtJ;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;IACjC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;IACjC,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,uBAAuB,GAAG,WAAW,CAiCjF"}

package/lib/types/server/exec/subagent.js

@@ -0,0 +1,44 @@
+/**
+ * The `subagent` executor: one inbound task is delegated to a named one-shot
+ * subagent under the context's parent session. The child runs with the
+ * composition's own tools and the delegation boundary; its output becomes the
+ * task's artifact. The subagent seam must be mounted, else the skill binding
+ * fails loudly at resolution time.
+ * @module dsh-a2a/server/exec/subagent
+ */
+/** Build a subagent executor delegating inbound tasks to one-shot children. */
+export function createSubagentExecutor(opts) {
+    const { pool, subagents, provider } = opts;
+    return {
+        name: 'subagent',
+        async execute(input, execCtx) {
+            if (!input.prompt) {
+                return { parts: [{ text: 'No prompt provided.' }] };
+            }
+            const { agent } = await pool.agentFor(input.contextId);
+            const run = await subagents.start(provider, {
+                label: `a2a:${input.skill}`,
+                prompt: [{ type: 'text', text: input.prompt }],
+                parent: agent,
+                signal: input.signal,
+            });
+            const result = await run.result;
+            const text = result.output
+                .filter((b) => typeof b.text === 'string')
+                .map((b) => b.text)
+                .filter(Boolean)
+                .join('\n')
+                .trim();
+            execCtx.onEvent({
+                type: 'artifact',
+                artifactId: 'result',
+                parts: [{ text: text || '(subagent returned no output)' }],
+                name: input.skill,
+                lastChunk: true,
+            });
+            return { parts: [{ text: text || '(subagent returned no output)' }] };
+        },
+        disposeAll: () => pool.disposeAll(),
+    };
+}
+//# sourceMappingURL=subagent.js.map

package/lib/types/server/exec/subagent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.js","sourceRoot":"","sources":["../../../../src/server/exec/subagent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAyBH,+EAA+E;AAC/E,MAAM,UAAU,sBAAsB,CAAC,IAA6B;IAClE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAA;IAC1C,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,KAAK,CAAC,OAAO,CAAC,KAAuB,EAAE,OAAO;YAC5C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBAClB,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC,EAAE,CAAA;YACrD,CAAC;YACD,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;YACtD,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,QAAQ,EAAE;gBAC1C,KAAK,EAAE,OAAO,KAAK,CAAC,KAAK,EAAE;gBAC3B,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC9C,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAA;YACF,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAA;YAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM;iBACvB,MAAM,CAAC,CAAC,CAAC,EAAyD,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;iBAChG,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;iBAClB,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,IAAI,CAAC;iBACV,IAAI,EAAE,CAAA;YACT,OAAO,CAAC,OAAO,CAAC;gBACd,IAAI,EAAE,UAAU;gBAChB,UAAU,EAAE,QAAQ;gBACpB,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,+BAA+B,EAAE,CAAC;gBAC1D,IAAI,EAAE,KAAK,CAAC,KAAK;gBACjB,SAAS,EAAE,IAAI;aAChB,CAAC,CAAA;YACF,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,+BAA+B,EAAE,CAAC,EAAE,CAAA;QACvE,CAAC;QACD,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE;KACpC,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,63 @@
+/**
+ * Executor abstraction for inbound tasks: an executor turns one task into
+ * output parts while reporting status and artifact updates. The registry is
+ * INTERNAL (built by the plugin from config) — public registration was cut:
+ * there is no external caller yet, so the seam stays an interface with two
+ * built-in implementations (session, subagent).
+ * @module dsh-a2a/server/executor
+ */
+import type { Part, TaskState } from '../protocol.ts';
+/** One update from a running executor. */
+export type A2aExecutorEvent = {
+    readonly type: 'status';
+    readonly state: TaskState;
+    readonly message?: string;
+} | {
+    readonly type: 'artifact';
+    readonly artifactId: string;
+    readonly parts: readonly Part[];
+    readonly name?: string;
+    readonly lastChunk?: boolean;
+};
+/** Input a task executor receives. */
+export interface A2aExecutorInput {
+    readonly taskId: string;
+    readonly contextId: string;
+    readonly skill: string;
+    readonly prompt: string;
+    readonly signal: AbortSignal;
+}
+/** Output contract of one executor run. */
+export interface A2aExecutorOutput {
+    readonly parts: readonly Part[];
+}
+/** One inbound task executor. */
+export interface A2aExecutor {
+    /** Stable kind name ('session' | 'subagent'). */
+    readonly name: string;
+    /**
+     * Run one task. The executor reports progress through `opts.onEvent` and
+     * must honor `opts.signal` (cancel = abort remaining work).
+     */
+    execute(input: A2aExecutorInput, opts: {
+        readonly onEvent: (ev: A2aExecutorEvent) => void;
+    }): Promise<A2aExecutorOutput>;
+    /** Dispose resources owned by the executor (sessions, children). */
+    disposeAll?(): Promise<void>;
+}
+/** Executor kind names configurable per skill. */
+export type ExecutorKind = 'session' | 'subagent';
+/**
+ * Skill → executor resolution. The subagent executor is absent on
+ * compositions without the subagent seam; resolving a skill bound to a
+ * missing kind fails loudly with a readable message.
+ */
+export declare class ExecutorSet {
+    private readonly bySkill;
+    private readonly session;
+    private readonly subagent;
+    constructor(bySkill: Readonly<Record<string, ExecutorKind>>, session: A2aExecutor, subagent: A2aExecutor | undefined);
+    resolve(skill: string): A2aExecutor;
+    disposeAll(): Promise<void>;
+}
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/server/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAErD,0CAA0C;AAC1C,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACjF;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAErJ,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAC7B;AAED,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAA;CAChC;AAED,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,gBAAgB,KAAK,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACxH,oEAAoE;IACpE,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED,kDAAkD;AAClD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,CAAA;AAEjD;;;;GAIG;AACH,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAFR,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,EAC/C,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,WAAW,GAAG,SAAS;IAGpD,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW;IAU7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAIlC"}

package/lib/types/server/executor.js

@@ -0,0 +1,38 @@
+/**
+ * Executor abstraction for inbound tasks: an executor turns one task into
+ * output parts while reporting status and artifact updates. The registry is
+ * INTERNAL (built by the plugin from config) — public registration was cut:
+ * there is no external caller yet, so the seam stays an interface with two
+ * built-in implementations (session, subagent).
+ * @module dsh-a2a/server/executor
+ */
+/**
+ * Skill → executor resolution. The subagent executor is absent on
+ * compositions without the subagent seam; resolving a skill bound to a
+ * missing kind fails loudly with a readable message.
+ */
+export class ExecutorSet {
+    bySkill;
+    session;
+    subagent;
+    constructor(bySkill, session, subagent) {
+        this.bySkill = bySkill;
+        this.session = session;
+        this.subagent = subagent;
+    }
+    resolve(skill) {
+        const kind = this.bySkill[skill] ?? 'session';
+        if (kind === 'session')
+            return this.session;
+        const subagent = this.subagent;
+        if (subagent === undefined) {
+            throw new Error(`a2a: skill "${skill}" is bound to the subagent executor but no subagent seam is mounted`);
+        }
+        return subagent;
+    }
+    async disposeAll() {
+        await this.session.disposeAll?.();
+        await this.subagent?.disposeAll?.();
+    }
+}
+//# sourceMappingURL=executor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../src/server/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAuCH;;;;GAIG;AACH,MAAM,OAAO,WAAW;IAEH;IACA;IACA;IAHnB,YACmB,OAA+C,EAC/C,OAAoB,EACpB,QAAiC;QAFjC,YAAO,GAAP,OAAO,CAAwC;QAC/C,YAAO,GAAP,OAAO,CAAa;QACpB,aAAQ,GAAR,QAAQ,CAAyB;IACjD,CAAC;IAEJ,OAAO,CAAC,KAAa;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,CAAA;QAC7C,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,OAAO,CAAA;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;QAC9B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,qEAAqE,CAAC,CAAA;QAC5G,CAAC;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAA;QACjC,MAAM,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,CAAA;IACrC,CAAC;CACF"}

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

@@ -0,0 +1,32 @@
+/**
+ * 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
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { A2AServer } from './a2a-server.ts';
+/** Structural slice of `ctx.webServer` this module registers on. */
+export interface WebServerLike {
+    register(route: {
+        readonly kind: 'exact' | 'prefix';
+        readonly path: string;
+        handler(req: IncomingMessage, res: ServerResponse): void | Promise<void>;
+    }): () => void;
+}
+/** Runtime-registered HTTP routes for one A2A server. */
+export declare class A2aRoutes {
+    private readonly webServer;
+    private readonly server;
+    private disposers;
+    private registered;
+    constructor(webServer: WebServerLike, server: A2AServer);
+    get active(): boolean;
+    /** Register the AgentCard + endpoint routes (idempotent). */
+    enable(): void;
+    /** Unregister the routes (idempotent). */
+    disable(): void;
+    dispose(): void;
+    private onRequest;
+}
+//# sourceMappingURL=routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/server/routes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAA;QACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,OAAO,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KACzE,GAAG,MAAM,IAAI,CAAA;CACf;AAID,yDAAyD;AACzD,qBAAa,SAAS;IAKlB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,UAAU,CAAQ;gBAGP,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,SAAS;IAGpC,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,6DAA6D;IAC7D,MAAM,IAAI,IAAI;IAsBd,0CAA0C;IAC1C,OAAO,IAAI,IAAI;IAKf,OAAO,IAAI,IAAI;YAID,SAAS;CAuCxB"}