@dsh-cc/subagent-task 0.5.0

package/lib/background-start.d.ts

@@ -0,0 +1,207 @@
+/**
+ * The Task tool's background/collect start mechanics: env kill-switch parsing,
+ * the §3.6 capacity guard, capability probes, request preparation (pin
+ * preallocation), and the two dispatch paths — `startBackground` (durable
+ * continuable child, returns immediately) and `collectForeground` (inline
+ * first-epoch collection through the epoch collector, promotable via Ctrl+B).
+ *
+ * Pure mechanics shared by the tool definition in `./tool.ts`; no behavior
+ * here beyond what `tool.ts` already performed — this module is a structural
+ * split of that file.
+ *
+ * @module @dsh-cc/subagent-task/background-start
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import type { AgentDefinition, ToolRestriction } from '@dsh-cc/claude-code-agents';
+import type { DetailedRoute, ModelRoutes } from '@dsh-cc/model-aliases';
+import { SpawnPinCapture } from './resume-capture.ts';
+/** Fresh-child provider: no parent conversation (CC Task default). */
+export declare const PROVIDER_SPAWN = "spawn";
+/**
+ * Per-parent admission limit for continuable children (UX plan §3.6): no
+ * upstream resident-children cap exists, so the Task tool refuses a new
+ * continuable start when the parent already has this many live children —
+ * counted directly as `listChildren` entries with `activity: 'running'`.
+ * A safety valve, not a scheduling policy.
+ */
+export declare const MAX_LIVE_CONTINUABLE_CHILDREN = 25;
+/**
+ * The env kill switch (UX plan §3.4): a non-empty value other than
+ * case-insensitive `0`/`false` disables backgrounding-by-default.
+ */
+export declare const CLAUDE_CODE_DISABLE_BACKGROUND_TASKS = "CLAUDE_CODE_DISABLE_BACKGROUND_TASKS";
+/** A structural subset of the subagents seam the tool dispatches through. */
+export interface ContinuableStart {
+    childId: string;
+    messageId: string;
+}
+export interface SubagentsLike {
+    start(name: string, request: {
+        label?: string;
+        prompt: readonly {
+            type: 'text';
+            text: string;
+        }[];
+        parent: Agent;
+        signal: AbortSignal;
+        agentOptions?: Record<string, string>;
+        toolFilter?: ToolRestriction;
+        maxDepth?: number;
+        persona?: string;
+    }): Promise<{
+        result: Promise<{
+            stopReason: string;
+            output?: readonly {
+                type: string;
+                text?: string;
+            }[];
+        }>;
+    }>;
+    /**
+     * Duck-typed continuable-creation entry (harness `ctx.subagents.startContinuable`):
+     * establishes a durable child that accepts follow-up turns by its `childId`.
+     * A seam without it cannot serve background dispatch.
+     */
+    startContinuable?(spec: {
+        provider: string;
+        label: string;
+        /** Caller-reserved durable id (becomes the child's session id). */
+        childId?: string;
+        request: {
+            prompt: readonly {
+                type: 'text';
+                text: string;
+            }[];
+            parent: Agent;
+            agentOptions?: Record<string, string>;
+            toolFilter?: ToolRestriction;
+            maxDepth?: number;
+            persona?: string;
+        };
+        signal: AbortSignal;
+    }): Promise<ContinuableStart>;
+    getProvider(name: string): unknown;
+    list(): string[];
+    /**
+     * Duck-typed interrupt (harness `ctx.subagents.interrupt`): cancels a live
+     * child's current turn; admission is synchronous and an absent/settled
+     * target is an accepted no-op. Used by the epoch collector's abort path.
+     * Absent → abort degrades to a prompt resolve without interrupting.
+     */
+    interrupt?(childId: string, authority: {
+        kind: 'ancestor';
+        agent: Agent;
+    }): void;
+    /**
+     * Duck-typed `listChildren` (harness `ctx.subagents.listChildren`): the
+     * durable children of one parent session with a store-snapshot `activity`.
+     * Used by the §3.6 capacity guard. Absent → the guard degrades open.
+     */
+    listChildren?(parentSessionId: string, signal?: AbortSignal): Promise<{
+        kind: string;
+        activity?: string;
+    }[]>;
+}
+/**
+ * The background request shape: everything `startContinuable` forwards except
+ * the provider/label envelope and the signal, which live at the spec level.
+ */
+export type BackgroundRequest = {
+    label: string;
+    prompt: readonly {
+        type: 'text';
+        text: string;
+    }[];
+    parent: Agent;
+    signal: AbortSignal;
+    maxDepth?: number;
+    persona?: string;
+    agentOptions?: Record<string, string>;
+    toolFilter?: ToolRestriction;
+    /**
+     * Caller-reserved durable child id — preallocated by the capture flow so
+     * the pin can be written before the child exists (plan §4.5 step 1).
+     */
+    childId?: string;
+    /** Capture-only metadata (never forwarded to the seam): definition. */
+    captureDefinition?: AgentDefinition;
+    /** Capture-only metadata: the atomic model-selector resolution. */
+    captureSelector?: DetailedRoute;
+};
+/**
+ * Parse `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` (UX plan §3.4): a non-empty
+ * value other than a case-insensitive `0`/`false` disables the kill switch's
+ * targets (backgrounding-by-default pins and, from Slice 3, promotion).
+ * Explicit `run_in_background` arguments stay honored both ways — declared
+ * as a partial-parity deviation because upstream's exact precedence is
+ * unverified.
+ * @param env - the environment to read; defaults to `process.env`.
+ */
+export declare function backgroundTasksDisabled(env?: Record<string, string | undefined>): boolean;
+/**
+ * Precedence for the background decision: explicit `run_in_background` always wins
+ * (true and false alike), otherwise the definition's `background: true` pin applies,
+ * otherwise foreground. A `true`-string pin cannot reach this check — the agents
+ * parser rejects a non-boolean `background` at load time. With the
+ * `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` kill switch armed, the pin path is
+ * disabled (omissions collect in foreground); explicit arguments still win.
+ */
+export declare function wantsBackground(args: {
+    run_in_background?: boolean;
+}, definition: {
+    background?: boolean;
+} | undefined, disabled: boolean): boolean;
+/**
+ * Thread the preallocated childId and the capture metadata into a background
+ * request. Without capture (no `resumePins` config) the request is returned
+ * unchanged — zero behavior difference.
+ */
+export declare function preparedBackground(request: BackgroundRequest, capture: SpawnPinCapture | undefined, definition?: AgentDefinition, routes?: ModelRoutes): BackgroundRequest;
+/**
+ * The §3.6 capacity guard (both `startBackground` and the collect path):
+ * refuse a new continuable child when the parent already has
+ * {@link MAX_LIVE_CONTINUABLE_CHILDREN} live children — counted directly as
+ * `listChildren` entries with `activity: 'running'`. Degrades open when the
+ * seam lacks `listChildren` or the listing fails: a safety valve must never
+ * block starts on its own infrastructure trouble.
+ */
+export declare function assertLiveCapacity(seam: SubagentsLike, parent: Agent, signal: AbortSignal): Promise<void>;
+/** Capability checks shared by `startBackground` and the collect path. */
+export declare function assertContinuableCapable(seam: SubagentsLike): void;
+/**
+ * Dispatch a FOREGROUND non-fork call by collecting the child's first epoch
+ * inline through the epoch collector (`docs/plans/2026-09-10-epoch-collector-dsh-cc.md`).
+ * Performs the same pin preallocation, pre-start pin write, and
+ * tombstone-on-throw as `startBackground` — a foreground-launched child is
+ * pinnable/resumable exactly like a background one. The child's settlement
+ * notice is suppressed (pop-once) because the epoch is consumed here.
+ */
+export declare function collectForeground(ctx: Context, seam: SubagentsLike, request: BackgroundRequest, capture: SpawnPinCapture | undefined, exec: {
+    agent?: Agent;
+    signal: AbortSignal;
+    token?: unknown;
+}): Promise<{
+    text: string;
+    status: 'completed';
+} | {
+    text: string;
+    status: 'async_launched';
+    agentId: string;
+    backgroundedByUser: true;
+}>;
+/**
+ * Dispatch a background call as a durable continuable child on the `spawn`
+ * provider. The definition folding (persona, sanitized toolFilter,
+ * alias-resolved agentOptions, maxDepth) happened before this call — cold
+ * resume never re-captures the parent's policy, so the creation input must
+ * already be final. Resolves once the child accepted its initial prompt.
+ * Capability gaps (seam without `startContinuable`, provider without
+ * `prepareContinuable`) surface as actionable tool errors naming the cause.
+ */
+export declare function startBackground(seam: SubagentsLike, request: BackgroundRequest, capture?: SpawnPinCapture): Promise<{
+    text: string;
+    status: 'async_launched';
+    agentId: string;
+}>;
+//# sourceMappingURL=background-start.d.ts.map

package/lib/background-start.d.ts.map

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

package/lib/background-start.js

@@ -0,0 +1,354 @@
+/**
+ * The Task tool's background/collect start mechanics: env kill-switch parsing,
+ * the §3.6 capacity guard, capability probes, request preparation (pin
+ * preallocation), and the two dispatch paths — `startBackground` (durable
+ * continuable child, returns immediately) and `collectForeground` (inline
+ * first-epoch collection through the epoch collector, promotable via Ctrl+B).
+ *
+ * Pure mechanics shared by the tool definition in `./tool.ts`; no behavior
+ * here beyond what `tool.ts` already performed — this module is a structural
+ * split of that file.
+ *
+ * @module @dsh-cc/subagent-task/background-start
+ */
+import { randomUUID } from 'node:crypto';
+import { cwdOf } from '@dsh-cc/memory';
+import { collectFirstEpoch } from "./epoch-collector.js";
+import { SpawnPinCapture } from "./resume-capture.js";
+/** Fresh-child provider: no parent conversation (CC Task default). */
+export const PROVIDER_SPAWN = 'spawn';
+/**
+ * Per-parent admission limit for continuable children (UX plan §3.6): no
+ * upstream resident-children cap exists, so the Task tool refuses a new
+ * continuable start when the parent already has this many live children —
+ * counted directly as `listChildren` entries with `activity: 'running'`.
+ * A safety valve, not a scheduling policy.
+ */
+export const MAX_LIVE_CONTINUABLE_CHILDREN = 25;
+/**
+ * The env kill switch (UX plan §3.4): a non-empty value other than
+ * case-insensitive `0`/`false` disables backgrounding-by-default.
+ */
+export const CLAUDE_CODE_DISABLE_BACKGROUND_TASKS = 'CLAUDE_CODE_DISABLE_BACKGROUND_TASKS';
+/**
+ * Parse `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` (UX plan §3.4): a non-empty
+ * value other than a case-insensitive `0`/`false` disables the kill switch's
+ * targets (backgrounding-by-default pins and, from Slice 3, promotion).
+ * Explicit `run_in_background` arguments stay honored both ways — declared
+ * as a partial-parity deviation because upstream's exact precedence is
+ * unverified.
+ * @param env - the environment to read; defaults to `process.env`.
+ */
+export function backgroundTasksDisabled(env = process.env) {
+    const raw = env[CLAUDE_CODE_DISABLE_BACKGROUND_TASKS];
+    if (raw === undefined || raw === '')
+        return false;
+    const lower = raw.toLowerCase();
+    return lower !== '0' && lower !== 'false';
+}
+/**
+ * Precedence for the background decision: explicit `run_in_background` always wins
+ * (true and false alike), otherwise the definition's `background: true` pin applies,
+ * otherwise foreground. A `true`-string pin cannot reach this check — the agents
+ * parser rejects a non-boolean `background` at load time. With the
+ * `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` kill switch armed, the pin path is
+ * disabled (omissions collect in foreground); explicit arguments still win.
+ */
+export function wantsBackground(args, definition, disabled) {
+    if (args.run_in_background === true)
+        return true;
+    if (args.run_in_background === false)
+        return false;
+    if (disabled)
+        return false;
+    return definition?.background === true;
+}
+/**
+ * Thread the preallocated childId and the capture metadata into a background
+ * request. Without capture (no `resumePins` config) the request is returned
+ * unchanged — zero behavior difference.
+ */
+export function preparedBackground(request, capture, definition, routes) {
+    if (capture === undefined)
+        return request;
+    return {
+        ...request,
+        childId: capture.preallocateChildId(),
+        ...(definition !== undefined ? { captureDefinition: definition } : {}),
+        captureSelector: routes !== undefined
+            ? routes.resolveDetailed(definition?.model)
+            : SpawnPinCapture.inheritSelector(definition?.model),
+    };
+}
+/**
+ * The §3.6 capacity guard (both `startBackground` and the collect path):
+ * refuse a new continuable child when the parent already has
+ * {@link MAX_LIVE_CONTINUABLE_CHILDREN} live children — counted directly as
+ * `listChildren` entries with `activity: 'running'`. Degrades open when the
+ * seam lacks `listChildren` or the listing fails: a safety valve must never
+ * block starts on its own infrastructure trouble.
+ */
+export async function assertLiveCapacity(seam, parent, signal) {
+    if (typeof seam.listChildren !== 'function')
+        return;
+    let children;
+    try {
+        children = await seam.listChildren(parent.id, signal);
+    }
+    catch {
+        return;
+    }
+    const live = children.filter(child => child.kind === 'child' && child.activity === 'running').length;
+    if (live >= MAX_LIVE_CONTINUABLE_CHILDREN) {
+        throw new Error(`parent has ${MAX_LIVE_CONTINUABLE_CHILDREN} live subagents; /agents stop <id> to `
+            + 'release one, or let children settle');
+    }
+}
+/** Capability checks shared by `startBackground` and the collect path. */
+export function assertContinuableCapable(seam) {
+    if (typeof seam.startContinuable !== 'function') {
+        throw new Error('background subagents are unavailable: the subagents seam does not expose '
+            + 'startContinuable. Background subagents require a subagent service with the '
+            + 'continuable-creation capability (prepareContinuable on the provider) and a '
+            + 'session-persistence backend; run this Task in the foreground instead.');
+    }
+    const provider = seam.getProvider(PROVIDER_SPAWN);
+    if (provider !== undefined && provider !== null && provider.prepareContinuable === undefined) {
+        throw new Error(`background subagents are unavailable: provider "${PROVIDER_SPAWN}" does not support `
+            + 'continuable children (UNSUPPORTED_CAPABILITY: no prepareContinuable). Background '
+            + 'subagents require a provider that implements the continuable-creation capability '
+            + 'and a session-persistence backend; run this Task in the foreground instead.');
+    }
+}
+/**
+ * Per-reason failure copy for the collect path (UX plan §4 Slice 3 item 2):
+ * mirrors `settle`'s contract — `completed` becomes the tool result, every
+ * other stop reason throws with a reason-specific, actionable message.
+ */
+function stopReasonMessage(childId, stopReason) {
+    switch (stopReason) {
+        case 'error':
+            return `subagent ${childId} run failed: the child hit a model or transport failure (stopReason "error").`;
+        case 'max-tokens':
+            return `subagent ${childId} stopped with reason "max-tokens": the child hit its token ceiling before finishing.`;
+        case 'refusal':
+            return `subagent ${childId} stopped with reason "refusal": the child declined the task.`;
+        case 'aborted':
+            return `subagent ${childId} was interrupted (stopReason "aborted"); it may still be resumed — /agents for status.`;
+        default:
+            return `subagent ${childId} stopped with reason "${stopReason}".`;
+    }
+}
+/**
+ * The user-promotion result (Ctrl+B, UX plan §3.4): the foreground wait is
+ * released to background — the model sees the SAME contract as an explicit
+ * `run_in_background: true` launch, with `backgroundedByUser: true` marking
+ * the promotion. The child's report/finish notice arrives later as a wake
+ * (its suppression mark was removed by `promote()` — exactly-once delivery).
+ */
+function promotedResult(childId, captureWarning) {
+    return {
+        text: `Background subagent started (agentId: ${childId}). The user moved the foreground wait `
+            + 'to the background while it ran (status async_launched, backgroundedByUser: true); treat '
+            + 'this exactly like a background launch — the result arrives as a later waking message, '
+            + 'so do not compose on an inline result. '
+            + 'Control it by that id: `list_agents` for status, `send_message` to continue the same '
+            + 'conversation, `interrupt_agent` to stop its current turn.'
+            + (captureWarning !== undefined
+                ? `\nresume pin capture failed: ${captureWarning}; this child will resume with legacy semantics`
+                : ''),
+        status: 'async_launched',
+        agentId: childId,
+        backgroundedByUser: true,
+    };
+}
+/**
+ * Project the collect path's epoch outcome onto the tool output shape
+ * (`settle`'s contract): `completed` → the closing message's text blocks;
+ * any other stop reason — including the abort path's prompt-synthetic
+ * `aborted` — throws with per-reason copy.
+ */
+function outcomeToResult(childId, outcome, captureWarning) {
+    // A promoted outcome never reaches here (the collect caller returns the
+    // async_launched result first); defensively it is an unexpected terminal.
+    if (outcome.kind !== 'epoch' || outcome.stopReason !== 'completed') {
+        throw new Error(stopReasonMessage(childId, outcome.kind === 'epoch' ? outcome.stopReason : outcome.kind));
+    }
+    const text = (outcome.output ?? [])
+        .filter(block => block.type === 'text')
+        .map(block => block.text ?? '')
+        .join('');
+    return {
+        text: text
+            + (captureWarning !== undefined
+                ? `\nresume pin capture failed: ${captureWarning}; this child will resume with legacy semantics`
+                : ''),
+        status: 'completed',
+    };
+}
+/**
+ * Dispatch a FOREGROUND non-fork call by collecting the child's first epoch
+ * inline through the epoch collector (`docs/plans/2026-09-10-epoch-collector-dsh-cc.md`).
+ * Performs the same pin preallocation, pre-start pin write, and
+ * tombstone-on-throw as `startBackground` — a foreground-launched child is
+ * pinnable/resumable exactly like a background one. The child's settlement
+ * notice is suppressed (pop-once) because the epoch is consumed here.
+ */
+export async function collectForeground(ctx, seam, request, capture, exec) {
+    const agent = exec.agent;
+    if (agent === undefined) {
+        throw new Error('subagent_fork requires a calling agent (exec.agent was undefined)');
+    }
+    await assertLiveCapacity(seam, agent, exec.signal);
+    assertContinuableCapable(seam);
+    const { label, prompt, parent, signal, childId, captureDefinition, captureSelector, ...rest } = request;
+    // The watch map keys on the durable child id, so the collect path ALWAYS
+    // preallocates one — via the capture flow when pins are armed, otherwise a
+    // fresh id (the child's session id, exactly as the harness would mint it).
+    const durableChildId = childId ?? randomUUID();
+    // §4.5 step 2 (parity with startBackground): the pin is written BEFORE the
+    // creation call; capture trouble becomes an explicit captureWarning line.
+    let captureWarning;
+    if (capture !== undefined && childId !== undefined && captureSelector !== undefined) {
+        captureWarning = await capture.write({
+            parentSessionId: parent.id,
+            label,
+            childId,
+            definition: captureDefinition,
+            selector: captureSelector,
+            parentRoute: parent.options,
+            toolFilter: 'toolFilter' in rest ? rest.toolFilter : undefined,
+            cwd: cwdOf(parent),
+        });
+    }
+    let startFailed = false;
+    try {
+        const outcome = await collectFirstEpoch({
+            bus: ctx,
+            childId: durableChildId,
+            agent,
+            signal,
+            subagents: seam,
+            // The promotion-registry key (§6): parent session + this call's
+            // registry token, so the TUI busy-branch Ctrl+B can find (and promote
+            // or abort) every armed foreground collect of this session.
+            parentSessionId: agent.id,
+            toolCallToken: exec.token !== undefined ? String(exec.token) : randomUUID(),
+            start: async () => {
+                try {
+                    await seam.startContinuable({
+                        provider: PROVIDER_SPAWN,
+                        label,
+                        childId: durableChildId,
+                        request: {
+                            prompt,
+                            parent,
+                            ...('persona' in rest ? { persona: rest.persona } : {}),
+                            ...('toolFilter' in rest ? { toolFilter: rest.toolFilter } : {}),
+                            ...('agentOptions' in rest ? { agentOptions: rest.agentOptions } : {}),
+                            ...('maxDepth' in rest ? { maxDepth: rest.maxDepth } : {}),
+                        },
+                        signal,
+                    });
+                }
+                catch (error) {
+                    startFailed = true;
+                    throw error;
+                }
+            },
+        });
+        if (outcome.kind === 'promoted')
+            return promotedResult(durableChildId, captureWarning);
+        return outcomeToResult(durableChildId, outcome, captureWarning);
+    }
+    catch (error) {
+        // §4.5 step 4 (parity with startBackground): a start that rolled back the
+        // creation must not leave the pin behind — tombstone, then rethrow. A
+        // non-`completed` epoch terminal or an abort keeps the child (it is
+        // resumable), so no tombstone on those.
+        if (startFailed && capture !== undefined && childId !== undefined)
+            await capture.tombstone(childId);
+        const message = error.message ?? String(error);
+        if (startFailed
+            && (message.includes('UNSUPPORTED_CAPABILITY') || message.includes('does not support continuable'))) {
+            throw new Error(`background subagents are unavailable: ${message}. Background subagents require a `
+                + 'provider that implements the continuable-creation capability (prepareContinuable) '
+                + 'and a session-persistence backend; run this Task in the foreground instead.');
+        }
+        throw error;
+    }
+}
+/**
+ * Dispatch a background call as a durable continuable child on the `spawn`
+ * provider. The definition folding (persona, sanitized toolFilter,
+ * alias-resolved agentOptions, maxDepth) happened before this call — cold
+ * resume never re-captures the parent's policy, so the creation input must
+ * already be final. Resolves once the child accepted its initial prompt.
+ * Capability gaps (seam without `startContinuable`, provider without
+ * `prepareContinuable`) surface as actionable tool errors naming the cause.
+ */
+export async function startBackground(seam, request, capture) {
+    assertContinuableCapable(seam);
+    const { label, prompt, parent, signal, childId, captureDefinition, captureSelector, ...rest } = request;
+    // §3.6 capacity guard: refuse before any pin write or creation call.
+    await assertLiveCapacity(seam, parent, signal);
+    // §4.5 step 2: the pin is written BEFORE the creation call (crash
+    // consistency). A failed capture keeps the spawn alive but must never be
+    // silent: the returned reason becomes an explicit captureWarning line in
+    // the tool result ("this child will resume with legacy semantics").
+    let captureWarning;
+    if (capture !== undefined && childId !== undefined && captureSelector !== undefined) {
+        captureWarning = await capture.write({
+            parentSessionId: parent.id,
+            label,
+            childId,
+            definition: captureDefinition,
+            selector: captureSelector,
+            parentRoute: parent.options,
+            toolFilter: 'toolFilter' in rest ? rest.toolFilter : undefined,
+            cwd: cwdOf(parent),
+        });
+    }
+    let started;
+    try {
+        started = await seam.startContinuable({
+            provider: PROVIDER_SPAWN,
+            label,
+            ...(childId !== undefined ? { childId } : {}),
+            request: {
+                prompt,
+                parent,
+                ...('persona' in rest ? { persona: rest.persona } : {}),
+                ...('toolFilter' in rest ? { toolFilter: rest.toolFilter } : {}),
+                ...('agentOptions' in rest ? { agentOptions: rest.agentOptions } : {}),
+                ...('maxDepth' in rest ? { maxDepth: rest.maxDepth } : {}),
+            },
+            signal,
+        });
+    }
+    catch (error) {
+        // §4.5 step 4: the creation rolled back fully (no child id), so the pin
+        // must not survive it — tombstone, then rethrow the error unchanged.
+        if (capture !== undefined && childId !== undefined)
+            await capture.tombstone(childId);
+        const message = error.message ?? String(error);
+        if (message.includes('UNSUPPORTED_CAPABILITY') || message.includes('does not support continuable')) {
+            throw new Error(`background subagents are unavailable: ${message}. Background subagents require a `
+                + 'provider that implements the continuable-creation capability (prepareContinuable) '
+                + 'and a session-persistence backend; run this Task in the foreground instead.');
+        }
+        throw error;
+    }
+    return {
+        text: `Background subagent started (agentId: ${started.childId}). It is running in the `
+            + 'background; its report or finish notice will arrive as a waking message. Control it '
+            + 'by that id: `list_agents` for status, `send_message` to continue the same '
+            + 'conversation, `interrupt_agent` to stop its current turn.'
+            + (captureWarning !== undefined
+                ? `\nresume pin capture failed: ${captureWarning}; this child will resume with legacy semantics`
+                : ''),
+        status: 'async_launched',
+        agentId: started.childId,
+    };
+}
+//# sourceMappingURL=background-start.js.map

package/lib/background-start.js.map

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