dsh-plugin-subagent-director 0.1.0

package/lib/delegation-tool.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Delegation tool subagent_role (design section 7).
+ *
+ * A model-facing tool that lets the calling agent delegate to a subagent while
+ * selecting an LLM route and/or a named role template. It resolves the four-layer
+ * fallback chain via the pure resolveRoute (design section 6), validates the
+ * resolution against live runtime facts, and assembles a SubagentStartRequest
+ * on ctx.subagents.start(...) exactly like dsh-workflow-worker-thread's
+ * startChild and dsh-tool-subagent's one-shot path.
+ *
+ * Two provider namespaces coexist and MUST NOT be confused (design section 14, R2):
+ *   - config.subagentProvider is the subagent TRANSPORT provider name handed
+ *     to ctx.subagents.start(name, ...) (e.g. spawn).
+ *   - the resolved agentOptions.provider is an LLM route served by an adapter
+ *     (e.g. deepseek-official).
+ *
+ * Execution contract (schema/execute mirror dsh-tool-subagent):
+ *   - foreground is the core path: await run.result, throw a stop-reason
+ *     error for a non-completed child, dispose idempotently, return
+ *     { kind: foreground, runId, output }.
+ *   - one-shot background mirrors the official Task registration on
+ *     ctx.jobs.start({ kind: subagent, ... }) returning { kind: background, jobId }.
+ *   - continuable runs the child through ctx.subagents.startContinuable() and
+ *     returns { kind: continuable, subagentId } (the durable child id), which the
+ *     parent later follows up on with send_message (M3a / FR-5.3).
+ *
+ * reasoningEffort: the DSH AgentOptions and SubagentStartRequest shapes do
+ * not carry reasoning effort (dsh-agent runtime-types.d.ts, dsh-subagent
+ * types.d.ts), so it is surfaced and logged only, never injected (route-resolver
+ * already returns it separately for auditability).
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Agent, AgentOptions } from '@deepseek-ai/dsh-agent';
+import { type JsonValue, type ParameterSchemaSpec, type ValueSchemaSpec } from '@deepseek-ai/dsh-tools';
+import type { ContentBlock } from '@deepseek-ai/dsh-llm';
+import type { SubagentProvider } from '@deepseek-ai/dsh-subagent';
+import type { DirectorConfig } from './config.js';
+import { type RouteToolFilter, type SubagentDirectorSettings } from './route-resolver.js';
+/** Stable log namespace prefix for delegation/tool diagnostics (design section 10). */
+export declare const DELEGATION_TOOL_PREFIX = "subagent-director";
+/**
+ * Delegate a task to a role-bound subagent with an optional LLM route override.
+ * Resolves role/model/provider through the configure -> role -> default ->
+ * inherit chain; role persona and tool filtering are applied when the chosen
+ * subagent transport supports them.
+ */
+export interface DelegationToolArgs {
+    /** A short (3-5 word) description of the delegated task, for display. */
+    description: string;
+    /** The complete, self-contained task for the subagent. */
+    prompt: string;
+    /** Role template id (optional). Falls back to the configured default role. */
+    role?: string;
+    /** LLM provider route override (optional). Wins over any role binding. */
+    provider?: string;
+    /** Model id override (optional). Wins over any role binding. */
+    model?: string;
+    /** Reasoning-effort override (optional; advisory — logged, not injected). */
+    reasoningEffort?: string;
+    /**
+     * Whether to run in the background. Defaults to false in one-shot mode; in
+     * continuable mode it defaults to true and returns the durable child id for
+     * later send_message follow-up.
+     */
+    run_in_background?: boolean;
+}
+/**
+ * Build the model-facing tool parameter schema given a config. Exposed as a
+ * pure function so unit tests can assert the model-visible shape without a live
+ * context: description/prompt are required; role/provider/model/reasoningEffort
+ * are optional; run_in_background appears only when enableRunInBackground is not
+ * false. In continuable mode its description notes the default of true and the
+ * durable-child-id return shape (mirrors dsh-tool-subagent's wording).
+ */
+export declare function createDelegationParameters(config: Pick<DirectorConfig, 'enableRunInBackground' | 'backgroundMode'>): ParameterSchemaSpec;
+/** The model-facing output schema: exactly one of background, continuable, or foreground. */
+export declare function createDelegationOutputSchema(): ValueSchemaSpec;
+/** The resolved execution route for one delegation call. */
+export type DelegationRoute = 'foreground' | 'one-shot' | 'continuable';
+/** The mode decision for one delegation: whether to run in the background, and which route to use. */
+export interface DelegationModeDecision {
+    runInBackground: boolean;
+    route: DelegationRoute;
+}
+/**
+ * Pure mode decision (extracted for unit testing) mirroring dsh-tool-subagent's
+ * resolveDelegationRun: a forced background while the flag is disabled is
+ * rejected; otherwise background defaults to the configured mode's policy —
+ * false for one-shot, true for continuable.
+ */
+export declare function resolveDelegationMode(request: Pick<DelegationToolArgs, 'run_in_background'>, options: {
+    backgroundEnabled: boolean;
+    continuable: boolean;
+}): DelegationModeDecision;
+/** The union of delegation result shapes produced by execute. */
+export type DelegationResult = {
+    kind: 'background';
+    jobId: string;
+} | {
+    kind: 'continuable';
+    subagentId: string;
+} | {
+    kind: 'foreground';
+    runId: string;
+    output: JsonValue[];
+};
+/**
+ * Pure renderer for a delegation result (extracted for unit testing). Mirrors
+ * dsh-tool-subagent's output.render: a continuable child renders as
+ * "started subagent <id>"; a one-shot task keeps its tool-name-qualified text;
+ * a foreground result emits its joined text blocks.
+ */
+export declare function renderDelegationResult(value: DelegationResult | {
+    kind: 'foreground';
+    output: object[];
+}, toolName: string): string;
+/**
+ * Pure capability gate (extracted from execute for unit testing, behavioral
+ * no-op): a resolved delegation feature demands a transport-provider capability,
+ * and its absence is a hard error (FR-8.1 / design 7.3). persona, toolFilter,
+ * and a numeric maxDepth each require the matching capability flag.
+ */
+export declare function assertDelegationCapabilities(options: {
+    providerName: string;
+    persona?: string;
+    toolFilter?: RouteToolFilter;
+    capabilities: {
+        persona: boolean;
+        toolFilter: boolean;
+        depthLimit: boolean;
+    };
+    maxDepth?: number | 'provider-managed';
+}): void;
+/** The route-derived fields that flow into a SubagentStartRequest body. */
+export interface SubagentRequestParts {
+    description: string;
+    prompt: ContentBlock[];
+    parent: Agent;
+    agentOptions?: Pick<AgentOptions, 'provider' | 'model'>;
+    persona?: string;
+    toolFilter?: RouteToolFilter;
+    maxDepth?: number;
+}
+/**
+ * Pure request-body assembly (extracted from execute for unit testing,
+ * behavioral no-op): persona and toolFilter propagate into the request only
+ * when the role resolved them, so a bare delegation stays zero-intrusion.
+ */
+export declare function buildSubagentRequest<Parts extends SubagentRequestParts>(parts: Parts): {
+    label: string;
+    prompt: ContentBlock[];
+    parent: Agent;
+    agentOptions?: Pick<AgentOptions, "model" | "provider"> | undefined;
+    persona?: string | undefined;
+    toolFilter?: RouteToolFilter | undefined;
+    maxDepth?: number | undefined;
+};
+/**
+ * Create the subagent_role ToolDefinition for one mounted subagent transport
+ * provider. getSettings returns the current settings snapshot so execute reads
+ * live role/default layers.
+ */
+export declare function createDelegationTool(options: {
+    ctx: Context;
+    config: DirectorConfig;
+    provider: SubagentProvider;
+    getSettings: () => SubagentDirectorSettings;
+}): import("@deepseek-ai/dsh-tools").ToolDefinition;
+//# sourceMappingURL=delegation-tool.d.ts.map

package/lib/delegation-tool.d.ts.map

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

package/lib/delegation-tool.js

@@ -0,0 +1,404 @@
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { settleRun } from '@deepseek-ai/dsh-subagent';
+import { resolveRoute } from './route-resolver.js';
+/** Stable log namespace prefix for delegation/tool diagnostics (design section 10). */
+export const DELEGATION_TOOL_PREFIX = 'subagent-director';
+/** The canonical error prefix used across all structured failures (FR-8.1 / design 7.3). */
+const ERROR_PREFIX = 'subagent-director:';
+/**
+ * Build the model-facing tool parameter schema given a config. Exposed as a
+ * pure function so unit tests can assert the model-visible shape without a live
+ * context: description/prompt are required; role/provider/model/reasoningEffort
+ * are optional; run_in_background appears only when enableRunInBackground is not
+ * false. In continuable mode its description notes the default of true and the
+ * durable-child-id return shape (mirrors dsh-tool-subagent's wording).
+ */
+export function createDelegationParameters(config) {
+    const continuable = (config.backgroundMode ?? 'one-shot') === 'continuable';
+    const parameters = {
+        description: {
+            type: 'string',
+            required: true,
+            description: 'A short (3-5 word) description of the delegated task, for display.',
+        },
+        prompt: {
+            type: 'string',
+            required: true,
+            description: "The complete, self-contained task for the subagent. It does not share this conversation's context, so include everything it needs.",
+        },
+        role: {
+            type: 'string',
+            description: 'Role template id (optional). Falls back to the configured default role when unset.',
+        },
+        provider: {
+            type: 'string',
+            description: 'LLM provider route override (optional). Explicit provider/model win over a role binding. Must match a route with a registered adapter.',
+        },
+        model: { type: 'string', description: 'Model id override (optional). Explicit provider/model win over a role binding.' },
+        reasoningEffort: { type: 'string', description: 'Reasoning-effort override (optional). Adapter serving the route decides support.' },
+    };
+    if (config.enableRunInBackground !== false) {
+        parameters.run_in_background = {
+            type: 'boolean',
+            description: continuable
+                ? 'Whether to run in the background and return a durable subagent id immediately. Defaults to true. Set false to wait for the result when your next action depends on it.'
+                : 'Whether to run as a background job and return its id. Defaults to false; collect with job_output or stop with job_kill.',
+        };
+    }
+    return parameters;
+}
+/** The model-facing output schema: exactly one of background, continuable, or foreground. */
+export function createDelegationOutputSchema() {
+    return {
+        oneOf: [
+            {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    kind: { type: 'string', required: true, const: 'background' },
+                    jobId: { type: 'string', required: true },
+                },
+            },
+            {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    kind: { type: 'string', required: true, const: 'continuable' },
+                    subagentId: { type: 'string', required: true },
+                },
+            },
+            {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    kind: { type: 'string', required: true, const: 'foreground' },
+                    runId: { type: 'string', required: true },
+                    output: { type: 'array', required: true, items: { type: 'json' } },
+                },
+            },
+        ],
+    };
+}
+function isEmpty(value) {
+    return value === undefined || value === null || value === '';
+}
+/** A non-completed stop reason means the child did not finish cleanly. */
+function stopReasonError(result) {
+    switch (result.stopReason) {
+        case 'completed':
+            return undefined;
+        case 'aborted':
+            return 'subagent run was cancelled';
+        case 'error':
+            return 'subagent run failed';
+        case 'max-tokens':
+            return 'subagent run hit its token limit before finishing';
+        case 'refusal':
+            return 'subagent declined the task';
+        default:
+            return `subagent run ended abnormally (${String(result.stopReason)})`;
+    }
+}
+/** Append the child's preserved partial answer to a stop-reason error. */
+function withPartialText(error, output) {
+    const text = output
+        .filter((block) => block.type === 'text')
+        .map((block) => block.text)
+        .join('');
+    return text.length === 0 ? error : `${error}\nPartial output before the run ended:\n${text}`;
+}
+/**
+ * Collect and release one foreground run without letting disposal replace an
+ * independent result failure (mirrors dsh-tool-subagent settleForegroundRun).
+ */
+async function settleForegroundRun(run) {
+    const [execution] = await Promise.allSettled([
+        run.result.then((result) => {
+            const error = stopReasonError(result);
+            if (error !== undefined)
+                throw new Error(withPartialText(error, result.output));
+            return { kind: 'foreground', runId: String(run.id), output: result.output };
+        }),
+    ]);
+    const [disposal] = await Promise.allSettled([Promise.resolve().then(() => run.dispose())]);
+    if (execution.status === 'rejected') {
+        if (disposal.status === 'rejected') {
+            throw new AggregateError([execution.reason, disposal.reason], `subagent run failed: ${String(execution.reason)}; dispose failed: ${String(disposal.reason)}`);
+        }
+        throw execution.reason;
+    }
+    if (disposal.status === 'rejected')
+        throw disposal.reason;
+    return execution.value;
+}
+/** Settle a background child without rejecting the Task producer contract. */
+async function settleBackgroundRun(start, signal) {
+    try {
+        return await settleRun(await start);
+    }
+    catch (error) {
+        return signal.aborted ? { status: 'killed' } : { status: 'failed', detail: String(error) };
+    }
+}
+/** Check whether an LLM route has a registered adapter (routable = listed). */
+function isProviderRoutable(ctx, provider) {
+    const llm = ctx.get('llm');
+    if (llm === undefined)
+        return true; // cannot validate without llm; assume routable
+    return llm.listProviders().some((entry) => entry.id === provider);
+}
+/** Format the structured FR-8.1 error with the available route list. */
+function invalidProviderError(provider, available) {
+    const list = available.length > 0 ? available.join(', ') : '(none)';
+    return new Error(`${ERROR_PREFIX} LLM provider route ${provider} is not routable (no adapter serves it). Available providers: ${list}`);
+}
+/**
+ * Pure mode decision (extracted for unit testing) mirroring dsh-tool-subagent's
+ * resolveDelegationRun: a forced background while the flag is disabled is
+ * rejected; otherwise background defaults to the configured mode's policy —
+ * false for one-shot, true for continuable.
+ */
+export function resolveDelegationMode(request, options) {
+    if (!options.backgroundEnabled) {
+        if (request.run_in_background === true) {
+            throw new Error(`${ERROR_PREFIX} run_in_background is disabled for this tool instance (enableRunInBackground: false)`);
+        }
+        return { runInBackground: false, route: 'foreground' };
+    }
+    const runInBackground = request.run_in_background ?? options.continuable;
+    return {
+        runInBackground,
+        route: runInBackground ? (options.continuable ? 'continuable' : 'one-shot') : 'foreground',
+    };
+}
+/**
+ * Pure renderer for a delegation result (extracted for unit testing). Mirrors
+ * dsh-tool-subagent's output.render: a continuable child renders as
+ * "started subagent <id>"; a one-shot task keeps its tool-name-qualified text;
+ * a foreground result emits its joined text blocks.
+ */
+export function renderDelegationResult(value, toolName) {
+    if (value.kind === 'background')
+        return `started background ${toolName} task ${value.jobId}`;
+    if (value.kind === 'continuable')
+        return `started subagent ${value.subagentId}`;
+    const blocks = value.output;
+    return blocks
+        .filter((block) => typeof block === 'object' && block !== null && block.type === 'text' && typeof block.text === 'string')
+        .map((block) => block.text)
+        .join('');
+}
+/**
+ * Pure capability gate (extracted from execute for unit testing, behavioral
+ * no-op): a resolved delegation feature demands a transport-provider capability,
+ * and its absence is a hard error (FR-8.1 / design 7.3). persona, toolFilter,
+ * and a numeric maxDepth each require the matching capability flag.
+ */
+export function assertDelegationCapabilities(options) {
+    const { providerName, persona, toolFilter, capabilities, maxDepth } = options;
+    if (persona !== undefined && !capabilities.persona) {
+        throw new Error(`${ERROR_PREFIX} role binds a persona but transport provider "${providerName}" does not support the persona capability — switch the subagent provider or drop the role persona`);
+    }
+    if (toolFilter !== undefined && !capabilities.toolFilter) {
+        throw new Error(`${ERROR_PREFIX} role binds a tool filter but transport provider "${providerName}" does not support the toolFilter capability — switch the subagent provider or drop the role filter`);
+    }
+    if (typeof maxDepth === 'number' && !capabilities.depthLimit) {
+        throw new Error(`${ERROR_PREFIX} transport provider "${providerName}" cannot enforce maxDepth (no depthLimit capability) — set maxDepth: 'provider-managed' to leave the recursion budget to the provider`);
+    }
+}
+/**
+ * Pure request-body assembly (extracted from execute for unit testing,
+ * behavioral no-op): persona and toolFilter propagate into the request only
+ * when the role resolved them, so a bare delegation stays zero-intrusion.
+ */
+export function buildSubagentRequest(parts) {
+    return {
+        label: parts.description,
+        prompt: parts.prompt,
+        parent: parts.parent,
+        ...(parts.agentOptions !== undefined ? { agentOptions: parts.agentOptions } : {}),
+        ...(parts.persona !== undefined ? { persona: parts.persona } : {}),
+        ...(parts.toolFilter !== undefined ? { toolFilter: parts.toolFilter } : {}),
+        ...(parts.maxDepth !== undefined ? { maxDepth: parts.maxDepth } : {}),
+    };
+}
+/**
+ * Create the subagent_role ToolDefinition for one mounted subagent transport
+ * provider. getSettings returns the current settings snapshot so execute reads
+ * live role/default layers.
+ */
+export function createDelegationTool(options) {
+    const { ctx, config, provider, getSettings } = options;
+    const backgroundEnabled = config.enableRunInBackground !== false;
+    const continuable = (config.backgroundMode ?? 'one-shot') === 'continuable';
+    const toolName = config.toolName ?? 'subagent_role';
+    const providerName = config.subagentProvider ?? 'spawn';
+    return defineTool({
+        name: toolName,
+        description: 'Delegate a self-contained task to a role-bound subagent with an optional LLM route (provider/model) override. ' +
+            'Resolves the model through configure -> role -> default -> inherit; role persona and tool filtering are applied when supported. ' +
+            (backgroundEnabled
+                ? continuable
+                    ? ' This tool runs in the background by default, immediately returns a durable subagent id, and keeps the child conversation available for later turns. When that run settles, the runtime sends the parent a notice containing its outcome and any final assistant message; `send_message` starts a later turn in the same child conversation. Set `run_in_background: false` only when your next action depends on receiving the result.'
+                    : ' This call waits for the result by default. Set `run_in_background: true` to return a job id; collect with `job_output` and stop with `job_kill`.'
+                : ' This call waits for the subagent and returns its result.'),
+        parameters: {
+            description: {
+                type: 'string',
+                required: true,
+                description: 'A short (3-5 word) description of the delegated task, for display.',
+            },
+            prompt: {
+                type: 'string',
+                required: true,
+                description: "The complete, self-contained task for the subagent. It does not share this conversation's context, so include everything it needs.",
+            },
+            role: {
+                type: 'string',
+                description: 'Role template id (optional). Falls back to the configured default role when unset.',
+            },
+            provider: {
+                type: 'string',
+                description: 'LLM provider route override (optional). Explicit provider/model win over a role binding. Must match a route with a registered adapter.',
+            },
+            model: { type: 'string', description: 'Model id override (optional). Explicit provider/model win over a role binding.' },
+            reasoningEffort: { type: 'string', description: 'Reasoning-effort override (optional). Adapter serving the route decides support.' },
+            ...(backgroundEnabled
+                ? {
+                    run_in_background: {
+                        type: 'boolean',
+                        description: continuable
+                            ? 'Whether to run in the background and return a durable subagent id immediately. Defaults to true. Set false to wait for the result when your next action depends on it.'
+                            : 'Whether to run as a background job and return its id. Defaults to false; collect with job_output or stop with job_kill.',
+                    },
+                }
+                : {}),
+        },
+        output: {
+            schema: {
+                oneOf: [
+                    {
+                        type: 'object',
+                        additionalProperties: false,
+                        properties: {
+                            kind: { type: 'string', required: true, const: 'background' },
+                            jobId: { type: 'string', required: true },
+                        },
+                    },
+                    {
+                        type: 'object',
+                        additionalProperties: false,
+                        properties: {
+                            kind: { type: 'string', required: true, const: 'continuable' },
+                            subagentId: { type: 'string', required: true },
+                        },
+                    },
+                    {
+                        type: 'object',
+                        additionalProperties: false,
+                        properties: {
+                            kind: { type: 'string', required: true, const: 'foreground' },
+                            runId: { type: 'string', required: true },
+                            output: { type: 'array', required: true, items: { type: 'json' } },
+                        },
+                    },
+                ],
+            },
+            render: (_args, value) => [{ type: 'text', text: renderDelegationResult(value, toolName) }],
+        },
+        isConcurrencySafe: () => true,
+        async execute(args, exec) {
+            const parent = exec.agent;
+            if (!parent)
+                throw new Error(`${ERROR_PREFIX} tool requires a calling agent (exec.agent was undefined)`);
+            const settings = getSettings();
+            const route = resolveRoute({ args, settings, parent: parent.options });
+            const warnings = [...route.warnings];
+            ctx.logger.info(`[${DELEGATION_TOOL_PREFIX}] delegate layer=${route.layer} mode=${continuable ? 'continuable' : 'one-shot'} transport=${providerName} route=${JSON.stringify(route.agentOptions ?? null)} persona=${route.persona ? 'yes' : 'no'} warnings=${JSON.stringify(warnings)}`);
+            // FR-8.1: an explicitly supplied provider must be routable — never silently swapped.
+            const explicitProvider = isEmpty(args.provider) ? undefined : args.provider;
+            if (explicitProvider !== undefined && !isProviderRoutable(ctx, explicitProvider)) {
+                const llm = ctx.get('llm');
+                const available = llm === undefined ? [] : llm.listProviders().map((entry) => entry.id);
+                throw invalidProviderError(explicitProvider, available);
+            }
+            // FR-8.2: role/default-bound provider not routable -> fallback (fallbackOnInvalid) or error.
+            let agentOptions = route.agentOptions;
+            const routeProvider = agentOptions?.provider;
+            if (routeProvider !== undefined && explicitProvider === undefined && !isProviderRoutable(ctx, routeProvider)) {
+                const fallBack = settings.fallbackOnInvalid !== false;
+                if (fallBack) {
+                    // Drop the un-routable route fields so the seam inherits the parent model (AC-8.2).
+                    agentOptions = undefined;
+                    warnings.push(`${ERROR_PREFIX} role/default provider ${routeProvider} is not routable; fell back to the parent model (fallbackOnInvalid: true)`);
+                    ctx.logger.warn(`[${DELEGATION_TOOL_PREFIX}] fell back to parent model for un-routable provider ${routeProvider}`);
+                }
+                else {
+                    const llm = ctx.get('llm');
+                    const available = llm === undefined ? [] : llm.listProviders().map((entry) => entry.id);
+                    throw invalidProviderError(routeProvider, available);
+                }
+            }
+            // persona/toolFilter require the transport provider's capabilities.
+            const maxDepth = typeof config.maxDepth === 'number' ? config.maxDepth : undefined;
+            assertDelegationCapabilities({
+                providerName,
+                persona: route.persona,
+                toolFilter: route.toolFilter,
+                capabilities: provider.capabilities,
+                maxDepth,
+            });
+            // reasoningEffort is advisory and not part of AgentOptions/SubagentStartRequest.
+            if (route.reasoningEffort !== undefined) {
+                ctx.logger.info(`[${DELEGATION_TOOL_PREFIX}] reasoningEffort=${route.reasoningEffort} is advisory and logged only (not injectable via AgentOptions)`);
+            }
+            const request = buildSubagentRequest({
+                description: args.description,
+                prompt: [{ type: 'text', text: args.prompt }],
+                parent,
+                agentOptions,
+                persona: route.persona,
+                toolFilter: route.toolFilter,
+                maxDepth,
+            });
+            const decision = resolveDelegationMode(args, { backgroundEnabled, continuable });
+            // Continuable background runs the child through startContinuable and returns
+            // the durable child id for later send_message follow-up (FR-5.3 / F11).
+            if (decision.route === 'continuable') {
+                if (provider.prepareContinuable === undefined) {
+                    throw new Error(`${ERROR_PREFIX} transport provider "${providerName}" does not support backgroundMode: continuable — switch the subagent provider or use backgroundMode: 'one-shot'`);
+                }
+                const start = await ctx.subagents.startContinuable({
+                    provider: providerName,
+                    label: args.description,
+                    request,
+                    signal: exec.signal,
+                });
+                return { kind: 'continuable', subagentId: start.childId };
+            }
+            if (decision.route === 'one-shot') {
+                const jobs = ctx.get('jobs');
+                if (jobs === undefined) {
+                    throw new Error(`${ERROR_PREFIX} background jobs unavailable: load @deepseek-ai/dsh-jobs and @deepseek-ai/dsh-tool-jobs`);
+                }
+                return {
+                    kind: 'background',
+                    jobId: jobs.start({
+                        kind: 'subagent',
+                        label: args.description,
+                        owner: parent,
+                        run: () => {
+                            const controller = new AbortController();
+                            return {
+                                cancel: (reason) => controller.abort(reason ?? 'background subagent task killed'),
+                                done: settleBackgroundRun(ctx.subagents.start(providerName, { ...request, signal: controller.signal }), controller.signal),
+                            };
+                        },
+                    }),
+                };
+            }
+            return settleForegroundRun(await ctx.subagents.start(providerName, { ...request, signal: exec.signal }));
+        },
+    });
+}
+//# sourceMappingURL=delegation-tool.js.map

package/lib/delegation-tool.js.map

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