@astralyn/pi 0.87.6 → 1.0.0

package/dist/extensions/subagent/runner.js

@@ -1,255 +0,0 @@
-import { isRetryableAssistantError } from "@earendil-works/pi-ai/compat";
-import { emptyUsage, mergeUsage, toNestedUsage } from "./activity.js";
-import { boundSubagentDetails, resultContent } from "./budget.js";
-import { abortableSleep, createRunCancellation } from "./cancellation.js";
-import { MAX_CONCURRENCY, MAX_TASKS, TASK_RETRY_BASE_DELAY_MS, TASK_RETRY_LIMIT } from "./constants.js";
-import { resolveSubagentTask } from "./resolve.js";
-import { runSdkTask } from "./sdk-runner.js";
-import { loadSubagentConfig } from "./settings.js";
-import { createRunState, reduceRun, statusOf, statusSummary, toRunDetails, versionSum, } from "./state.js";
-export class ConcurrencyGate {
-    constructor(limit = MAX_CONCURRENCY) {
-        this.active = 0;
-        this.waiters = [];
-        this.limit = limit;
-    }
-    acquire(signal) {
-        if (signal?.aborted)
-            return Promise.reject(new Error("Subagent was aborted while queued."));
-        if (this.active < this.limit) {
-            this.active++;
-            return Promise.resolve(() => this.release());
-        }
-        return new Promise((resolve, reject) => {
-            const waiter = { resolve, reject, signal, settled: false };
-            if (signal) {
-                waiter.abortListener = () => {
-                    if (waiter.settled)
-                        return;
-                    waiter.settled = true;
-                    const index = this.waiters.indexOf(waiter);
-                    if (index >= 0)
-                        this.waiters.splice(index, 1);
-                    reject(new Error("Subagent was aborted while queued."));
-                };
-                signal.addEventListener("abort", waiter.abortListener, { once: true });
-            }
-            this.waiters.push(waiter);
-        });
-    }
-    release() {
-        this.active = Math.max(0, this.active - 1);
-        while (this.waiters.length > 0) {
-            const waiter = this.waiters.shift();
-            if (waiter.settled || waiter.signal?.aborted)
-                continue;
-            waiter.settled = true;
-            waiter.signal?.removeEventListener("abort", waiter.abortListener);
-            this.active++;
-            waiter.resolve(() => this.release());
-            return;
-        }
-    }
-}
-function aggregateUsage(runs) {
-    const usage = emptyUsage();
-    for (const run of runs)
-        mergeUsage(usage, run.usage);
-    return usage;
-}
-/** Capture report provenance before the tool-details budget can discard it. */
-function backgroundProjection(runs, tasks, details) {
-    return {
-        text: statusSummary(details),
-        workers: runs.map((run, index) => ({
-            id: run.id,
-            label: run.agent,
-            profile: run.agent,
-            description: run.description,
-            status: run.status,
-            prompt: tasks[index]?.prompt ?? run.description,
-            activity: run.currentActivity ??
-                run.activities
-                    .slice(-3)
-                    .map((item) => item.summary)
-                    .join("\n"),
-            report: { text: run.report, truncated: run.reportTruncated },
-            error: run.error,
-            model: `${run.model} · ${run.thinking}`,
-            usage: `${run.usage.totalTokens} tokens · $${run.usage.cost.toFixed(4)} · ${run.usage.toolUses} tool calls`,
-        })),
-    };
-}
-function emitDetails(runs, tasks, startedAt, onUpdate) {
-    const details = {
-        status: statusOf(runs),
-        runs: runs.map(toRunDetails),
-        startedAt,
-        usage: aggregateUsage(runs),
-    };
-    onUpdate?.(boundSubagentDetails(details), backgroundProjection(runs, tasks, details));
-    return details;
-}
-function validateTaskCount(tasks) {
-    if (tasks.length === 0)
-        throw new Error("Subagent task list must not be empty.");
-    if (tasks.length > MAX_TASKS)
-        throw new Error(`Subagent task list is limited to ${MAX_TASKS} tasks.`);
-}
-async function resolveTasks(tasks, options) {
-    validateTaskCount(tasks);
-    // One config load and one resolution pass for the whole batch: every
-    // task/profile/cwd/model is settled before any run is created or any
-    // worker starts, so a failing task cannot strand half-initialized runs.
-    const config = await loadSubagentConfig(options.agentDir, options.onConfigWarning);
-    return Promise.all(tasks.map((task, index) => resolveSubagentTask(task, options.parentCwd, options.parent, options.agentDir, config).catch((error) => {
-        const message = error instanceof Error ? error.message : String(error);
-        throw new Error(`Subagent task tasks[${index}] failed to resolve: ${message}`);
-    })));
-}
-// Reuses pi-ai's provider-error classification by wrapping the stored error
-// text in the assistant-message shape it inspects.
-function isRetryableRunError(error) {
-    if (!error)
-        return false;
-    const probe = { role: "assistant", content: [], stopReason: "error", errorMessage: error };
-    return isRetryableAssistantError(probe);
-}
-// Session-level auto-retry already covers errors that happen inside the agent
-// loop; this catches the paths that bypass it (preflight throws such as auth
-// checks). Only a run that produced nothing is retried, so partial work is
-// never discarded.
-function shouldRetryTask(run) {
-    return (run.status === "failed" && run.usage.turns === 0 && run.usage.toolUses === 0 && isRetryableRunError(run.error));
-}
-// The gate slot is held only while a worker session actually runs. Backoff
-// waits outside the slot (release, sleep, reacquire) so a retrying task
-// cannot starve queued tasks, and aborting during the wait settles the run
-// without occupying the gate.
-async function runWithGate(task, scope, options, dispatch, getState, onProgress) {
-    const baseDelayMs = options.taskRetryBaseDelayMs ?? TASK_RETRY_BASE_DELAY_MS;
-    for (let attempt = 0;; attempt++) {
-        dispatch({ type: "retry_started" });
-        let release;
-        let delayMs = 0;
-        try {
-            release = await options.gate.acquire(scope.signal);
-            if (scope.signal.aborted) {
-                dispatch({ type: "abort_while_queued", endedAt: Date.now() });
-                return;
-            }
-            dispatch({ type: "slot_acquired", startedAt: Date.now() });
-            await runSdkTask({
-                task,
-                scope,
-                dispatch,
-                modelRuntime: options.modelRuntime,
-                agentDir: options.agentDir,
-                // Trust follows the directory, not the parent session: a task that
-                // works outside the parent must never load that directory's project
-                // settings under the parent's trust conclusion.
-                projectTrusted: task.insideParent ? options.projectTrusted : false,
-                onProgress,
-            });
-            const state = getState();
-            if (attempt >= TASK_RETRY_LIMIT || scope.signal.aborted || !shouldRetryTask(state))
-                return;
-            delayMs = baseDelayMs * 2 ** attempt;
-            dispatch({
-                type: "retry_scheduled",
-                attempt: attempt + 1,
-                maxAttempts: TASK_RETRY_LIMIT,
-                deadline: Date.now() + delayMs,
-                error: state.error,
-            });
-        }
-        catch (error) {
-            if (scope.signal.aborted) {
-                dispatch({ type: "abort_while_queued", endedAt: Date.now() });
-            }
-            else {
-                dispatch({
-                    type: "settle",
-                    verdict: "failed",
-                    report: "",
-                    error: error instanceof Error ? error.message : String(error),
-                    endedAt: Date.now(),
-                });
-            }
-            return;
-        }
-        finally {
-            release?.();
-        }
-        try {
-            await abortableSleep(delayMs, scope);
-        }
-        catch {
-            dispatch({ type: "abort_while_retrying", endedAt: Date.now() });
-            return;
-        }
-    }
-}
-export async function runSubagentInvocation(options) {
-    // Register one invocation-level scope before the first await so shutdown can
-    // never snapshot the active set between preflight and worker creation.
-    const invocationScope = createRunCancellation(options.signal);
-    const unregisterInvocation = options.registerAbort?.(invocationScope.abort);
-    try {
-        // Defensive count check: the schema already enforces 1..MAX_TASKS, but
-        // strict providers can bypass minItems, so validate before any work.
-        const tasks = options.params.tasks ?? [];
-        const resolved = await resolveTasks(tasks, options);
-        const runs = resolved.map((task, index) => createRunState(task, index, options.batchId, options.parentCwd));
-        const startedAt = Date.now();
-        const scopes = runs.map(() => createRunCancellation(invocationScope.signal));
-        const unregisterChildren = invocationScope.onAbort(async () => {
-            await Promise.allSettled(scopes.map((scope) => scope.abort()));
-        });
-        let lastVersion = versionSum(runs);
-        const progress = () => {
-            const version = versionSum(runs);
-            if (version === lastVersion)
-                return;
-            lastVersion = version;
-            emitDetails(runs, resolved, startedAt, options.onUpdate);
-        };
-        const dispatch = (index, event) => {
-            runs[index] = reduceRun(runs[index], event);
-            progress();
-        };
-        let latestDetails = emitDetails(runs, resolved, startedAt, options.onUpdate);
-        // Every task runs concurrently through the shared gate; Promise.all keeps
-        // result order identical to input order. There is no single-task branch:
-        // one task is just a batch of one.
-        try {
-            if (!invocationScope.aborted)
-                options.onAccepted?.();
-            await Promise.all(resolved.map((task, index) => {
-                const dispatchToRun = (event) => dispatch(index, event);
-                return runWithGate(task, scopes[index], options, dispatchToRun, () => runs[index], progress);
-            }));
-        }
-        finally {
-            unregisterChildren();
-            for (const scope of scopes)
-                scope.dispose();
-        }
-        latestDetails = emitDetails(runs, resolved, startedAt, undefined);
-        latestDetails.endedAt = Date.now();
-        // Error classification lives in the tool_result handler (index.ts), the
-        // only channel that reaches the session transcript and export.
-        return {
-            content: resultContent(latestDetails),
-            details: boundSubagentDetails(latestDetails),
-            projection: backgroundProjection(runs, resolved, latestDetails),
-            usage: toNestedUsage(latestDetails.usage),
-        };
-    }
-    finally {
-        unregisterInvocation?.();
-        invocationScope.dispose();
-    }
-}
-export { isSubagentError } from "./state.js";
-//# sourceMappingURL=runner.js.map

package/dist/extensions/subagent/runner.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../src/extensions/subagent/runner.ts"],"names":[],"mappings":"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","sourcesContent":["import { isRetryableAssistantError } from \"@earendil-works/pi-ai/compat\";\nimport type { BackgroundProjection } from \"../../core/background/types.ts\";\nimport type { ModelRuntime } from \"../../core/model-runtime.ts\";\nimport { emptyUsage, mergeUsage, toNestedUsage } from \"./activity.ts\";\nimport { boundSubagentDetails, resultContent } from \"./budget.ts\";\nimport { abortableSleep, createRunCancellation, type RunCancellation } from \"./cancellation.ts\";\nimport { MAX_CONCURRENCY, MAX_TASKS, TASK_RETRY_BASE_DELAY_MS, TASK_RETRY_LIMIT } from \"./constants.ts\";\nimport { type ParentModelContext, resolveSubagentTask } from \"./resolve.ts\";\nimport type { SubagentParams, SubagentTask } from \"./schema.ts\";\nimport { runSdkTask } from \"./sdk-runner.ts\";\nimport { loadSubagentConfig } from \"./settings.ts\";\nimport {\n\tcreateRunState,\n\treduceRun,\n\ttype SubagentRunEvent,\n\ttype SubagentRunState,\n\tstatusOf,\n\tstatusSummary,\n\ttoRunDetails,\n\tversionSum,\n} from \"./state.ts\";\nimport type { ResolvedSubagentTask, SubagentDetails, SubagentExecutionResult, SubagentUsage } from \"./types.ts\";\n\ninterface Waiter {\n\tresolve: (release: () => void) => void;\n\treject: (error: Error) => void;\n\tsignal?: AbortSignal;\n\tabortListener?: () => void;\n\tsettled: boolean;\n}\n\nexport class ConcurrencyGate {\n\tprivate active = 0;\n\tprivate readonly waiters: Waiter[] = [];\n\tprivate readonly limit: number;\n\n\tconstructor(limit = MAX_CONCURRENCY) {\n\t\tthis.limit = limit;\n\t}\n\n\tacquire(signal?: AbortSignal): Promise<() => void> {\n\t\tif (signal?.aborted) return Promise.reject(new Error(\"Subagent was aborted while queued.\"));\n\t\tif (this.active < this.limit) {\n\t\t\tthis.active++;\n\t\t\treturn Promise.resolve(() => this.release());\n\t\t}\n\t\treturn new Promise<() => void>((resolve, reject) => {\n\t\t\tconst waiter: Waiter = { resolve, reject, signal, settled: false };\n\t\t\tif (signal) {\n\t\t\t\twaiter.abortListener = () => {\n\t\t\t\t\tif (waiter.settled) return;\n\t\t\t\t\twaiter.settled = true;\n\t\t\t\t\tconst index = this.waiters.indexOf(waiter);\n\t\t\t\t\tif (index >= 0) this.waiters.splice(index, 1);\n\t\t\t\t\treject(new Error(\"Subagent was aborted while queued.\"));\n\t\t\t\t};\n\t\t\t\tsignal.addEventListener(\"abort\", waiter.abortListener, { once: true });\n\t\t\t}\n\t\t\tthis.waiters.push(waiter);\n\t\t});\n\t}\n\n\tprivate release(): void {\n\t\tthis.active = Math.max(0, this.active - 1);\n\t\twhile (this.waiters.length > 0) {\n\t\t\tconst waiter = this.waiters.shift()!;\n\t\t\tif (waiter.settled || waiter.signal?.aborted) continue;\n\t\t\twaiter.settled = true;\n\t\t\twaiter.signal?.removeEventListener(\"abort\", waiter.abortListener!);\n\t\t\tthis.active++;\n\t\t\twaiter.resolve(() => this.release());\n\t\t\treturn;\n\t\t}\n\t}\n}\n\nexport interface SubagentInvocationOptions {\n\tparams: SubagentParams;\n\tparentCwd: string;\n\tparent: ParentModelContext;\n\tmodelRuntime: ModelRuntime;\n\tagentDir: string;\n\tprojectTrusted: boolean;\n\tsignal?: AbortSignal;\n\tgate: ConcurrencyGate;\n\tonUpdate?: (details: SubagentDetails, projection: BackgroundProjection) => void;\n\t/** Whole-batch preflight and initial publication finished; no worker has started. */\n\tonAccepted?: () => void;\n\tonConfigWarning?: (message: string) => void;\n\tregisterAbort?: (abort: () => Promise<void>) => () => void;\n\t/** Test hook: overrides the task-retry backoff base delay. */\n\ttaskRetryBaseDelayMs?: number;\n\t/** Tool-call id of the invoking call; prefixes per-run ids for readability. */\n\tbatchId?: string;\n}\n\nfunction aggregateUsage(runs: readonly SubagentRunState[]): SubagentUsage {\n\tconst usage = emptyUsage();\n\tfor (const run of runs) mergeUsage(usage, run.usage);\n\treturn usage;\n}\n\n/** Capture report provenance before the tool-details budget can discard it. */\nfunction backgroundProjection(\n\truns: readonly SubagentRunState[],\n\ttasks: readonly ResolvedSubagentTask[],\n\tdetails: SubagentDetails,\n): BackgroundProjection {\n\treturn {\n\t\ttext: statusSummary(details),\n\t\tworkers: runs.map((run, index) => ({\n\t\t\tid: run.id,\n\t\t\tlabel: run.agent,\n\t\t\tprofile: run.agent,\n\t\t\tdescription: run.description,\n\t\t\tstatus: run.status,\n\t\t\tprompt: tasks[index]?.prompt ?? run.description,\n\t\t\tactivity:\n\t\t\t\trun.currentActivity ??\n\t\t\t\trun.activities\n\t\t\t\t\t.slice(-3)\n\t\t\t\t\t.map((item) => item.summary)\n\t\t\t\t\t.join(\"\\n\"),\n\t\t\treport: { text: run.report, truncated: run.reportTruncated },\n\t\t\terror: run.error,\n\t\t\tmodel: `${run.model} · ${run.thinking}`,\n\t\t\tusage: `${run.usage.totalTokens} tokens · $${run.usage.cost.toFixed(4)} · ${run.usage.toolUses} tool calls`,\n\t\t})),\n\t};\n}\n\nfunction emitDetails(\n\truns: SubagentRunState[],\n\ttasks: readonly ResolvedSubagentTask[],\n\tstartedAt: number,\n\tonUpdate: SubagentInvocationOptions[\"onUpdate\"],\n): SubagentDetails {\n\tconst details: SubagentDetails = {\n\t\tstatus: statusOf(runs),\n\t\truns: runs.map(toRunDetails),\n\t\tstartedAt,\n\t\tusage: aggregateUsage(runs),\n\t};\n\tonUpdate?.(boundSubagentDetails(details), backgroundProjection(runs, tasks, details));\n\treturn details;\n}\n\nfunction validateTaskCount(tasks: readonly SubagentTask[]): void {\n\tif (tasks.length === 0) throw new Error(\"Subagent task list must not be empty.\");\n\tif (tasks.length > MAX_TASKS) throw new Error(`Subagent task list is limited to ${MAX_TASKS} tasks.`);\n}\n\nasync function resolveTasks(\n\ttasks: readonly SubagentTask[],\n\toptions: SubagentInvocationOptions,\n): Promise<ResolvedSubagentTask[]> {\n\tvalidateTaskCount(tasks);\n\t// One config load and one resolution pass for the whole batch: every\n\t// task/profile/cwd/model is settled before any run is created or any\n\t// worker starts, so a failing task cannot strand half-initialized runs.\n\tconst config = await loadSubagentConfig(options.agentDir, options.onConfigWarning);\n\treturn Promise.all(\n\t\ttasks.map((task, index) =>\n\t\t\tresolveSubagentTask(task, options.parentCwd, options.parent, options.agentDir, config).catch((error) => {\n\t\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\t\tthrow new Error(`Subagent task tasks[${index}] failed to resolve: ${message}`);\n\t\t\t}),\n\t\t),\n\t);\n}\n\n// Reuses pi-ai's provider-error classification by wrapping the stored error\n// text in the assistant-message shape it inspects.\nfunction isRetryableRunError(error: string | undefined): boolean {\n\tif (!error) return false;\n\tconst probe = { role: \"assistant\", content: [], stopReason: \"error\", errorMessage: error };\n\treturn isRetryableAssistantError(probe as unknown as Parameters<typeof isRetryableAssistantError>[0]);\n}\n\n// Session-level auto-retry already covers errors that happen inside the agent\n// loop; this catches the paths that bypass it (preflight throws such as auth\n// checks). Only a run that produced nothing is retried, so partial work is\n// never discarded.\nfunction shouldRetryTask(run: SubagentRunState): boolean {\n\treturn (\n\t\trun.status === \"failed\" && run.usage.turns === 0 && run.usage.toolUses === 0 && isRetryableRunError(run.error)\n\t);\n}\n\n// The gate slot is held only while a worker session actually runs. Backoff\n// waits outside the slot (release, sleep, reacquire) so a retrying task\n// cannot starve queued tasks, and aborting during the wait settles the run\n// without occupying the gate.\nasync function runWithGate(\n\ttask: ResolvedSubagentTask,\n\tscope: RunCancellation,\n\toptions: SubagentInvocationOptions,\n\tdispatch: (event: SubagentRunEvent) => void,\n\tgetState: () => SubagentRunState,\n\tonProgress: () => void,\n): Promise<void> {\n\tconst baseDelayMs = options.taskRetryBaseDelayMs ?? TASK_RETRY_BASE_DELAY_MS;\n\tfor (let attempt = 0; ; attempt++) {\n\t\tdispatch({ type: \"retry_started\" });\n\t\tlet release: (() => void) | undefined;\n\t\tlet delayMs = 0;\n\t\ttry {\n\t\t\trelease = await options.gate.acquire(scope.signal);\n\t\t\tif (scope.signal.aborted) {\n\t\t\t\tdispatch({ type: \"abort_while_queued\", endedAt: Date.now() });\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tdispatch({ type: \"slot_acquired\", startedAt: Date.now() });\n\t\t\tawait runSdkTask({\n\t\t\t\ttask,\n\t\t\t\tscope,\n\t\t\t\tdispatch,\n\t\t\t\tmodelRuntime: options.modelRuntime,\n\t\t\t\tagentDir: options.agentDir,\n\t\t\t\t// Trust follows the directory, not the parent session: a task that\n\t\t\t\t// works outside the parent must never load that directory's project\n\t\t\t\t// settings under the parent's trust conclusion.\n\t\t\t\tprojectTrusted: task.insideParent ? options.projectTrusted : false,\n\t\t\t\tonProgress,\n\t\t\t});\n\t\t\tconst state = getState();\n\t\t\tif (attempt >= TASK_RETRY_LIMIT || scope.signal.aborted || !shouldRetryTask(state)) return;\n\t\t\tdelayMs = baseDelayMs * 2 ** attempt;\n\t\t\tdispatch({\n\t\t\t\ttype: \"retry_scheduled\",\n\t\t\t\tattempt: attempt + 1,\n\t\t\t\tmaxAttempts: TASK_RETRY_LIMIT,\n\t\t\t\tdeadline: Date.now() + delayMs,\n\t\t\t\terror: state.error,\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tif (scope.signal.aborted) {\n\t\t\t\tdispatch({ type: \"abort_while_queued\", endedAt: Date.now() });\n\t\t\t} else {\n\t\t\t\tdispatch({\n\t\t\t\t\ttype: \"settle\",\n\t\t\t\t\tverdict: \"failed\",\n\t\t\t\t\treport: \"\",\n\t\t\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t\t\t\tendedAt: Date.now(),\n\t\t\t\t});\n\t\t\t}\n\t\t\treturn;\n\t\t} finally {\n\t\t\trelease?.();\n\t\t}\n\t\ttry {\n\t\t\tawait abortableSleep(delayMs, scope);\n\t\t} catch {\n\t\t\tdispatch({ type: \"abort_while_retrying\", endedAt: Date.now() });\n\t\t\treturn;\n\t\t}\n\t}\n}\n\nexport async function runSubagentInvocation(options: SubagentInvocationOptions): Promise<SubagentExecutionResult> {\n\t// Register one invocation-level scope before the first await so shutdown can\n\t// never snapshot the active set between preflight and worker creation.\n\tconst invocationScope = createRunCancellation(options.signal);\n\tconst unregisterInvocation = options.registerAbort?.(invocationScope.abort);\n\ttry {\n\t\t// Defensive count check: the schema already enforces 1..MAX_TASKS, but\n\t\t// strict providers can bypass minItems, so validate before any work.\n\t\tconst tasks = options.params.tasks ?? [];\n\t\tconst resolved = await resolveTasks(tasks, options);\n\t\tconst runs = resolved.map((task, index) => createRunState(task, index, options.batchId, options.parentCwd));\n\t\tconst startedAt = Date.now();\n\t\tconst scopes = runs.map(() => createRunCancellation(invocationScope.signal));\n\t\tconst unregisterChildren = invocationScope.onAbort(async () => {\n\t\t\tawait Promise.allSettled(scopes.map((scope) => scope.abort()));\n\t\t});\n\t\tlet lastVersion = versionSum(runs);\n\t\tconst progress = (): void => {\n\t\t\tconst version = versionSum(runs);\n\t\t\tif (version === lastVersion) return;\n\t\t\tlastVersion = version;\n\t\t\temitDetails(runs, resolved, startedAt, options.onUpdate);\n\t\t};\n\t\tconst dispatch = (index: number, event: SubagentRunEvent): void => {\n\t\t\truns[index] = reduceRun(runs[index]!, event);\n\t\t\tprogress();\n\t\t};\n\t\tlet latestDetails = emitDetails(runs, resolved, startedAt, options.onUpdate);\n\n\t\t// Every task runs concurrently through the shared gate; Promise.all keeps\n\t\t// result order identical to input order. There is no single-task branch:\n\t\t// one task is just a batch of one.\n\t\ttry {\n\t\t\tif (!invocationScope.aborted) options.onAccepted?.();\n\t\t\tawait Promise.all(\n\t\t\t\tresolved.map((task, index) => {\n\t\t\t\t\tconst dispatchToRun = (event: SubagentRunEvent): void => dispatch(index, event);\n\t\t\t\t\treturn runWithGate(task, scopes[index]!, options, dispatchToRun, () => runs[index]!, progress);\n\t\t\t\t}),\n\t\t\t);\n\t\t} finally {\n\t\t\tunregisterChildren();\n\t\t\tfor (const scope of scopes) scope.dispose();\n\t\t}\n\t\tlatestDetails = emitDetails(runs, resolved, startedAt, undefined);\n\t\tlatestDetails.endedAt = Date.now();\n\t\t// Error classification lives in the tool_result handler (index.ts), the\n\t\t// only channel that reaches the session transcript and export.\n\t\treturn {\n\t\t\tcontent: resultContent(latestDetails),\n\t\t\tdetails: boundSubagentDetails(latestDetails),\n\t\t\tprojection: backgroundProjection(runs, resolved, latestDetails),\n\t\t\tusage: toNestedUsage(latestDetails.usage),\n\t\t};\n\t} finally {\n\t\tunregisterInvocation?.();\n\t\tinvocationScope.dispose();\n\t}\n}\n\nexport { isSubagentError } from \"./state.ts\";\n"]}

package/dist/extensions/subagent/schema.d.ts

@@ -1,28 +0,0 @@
-import { type Static, Type } from "typebox";
-export declare const TaskSchema: Type.TObject<{
-    agent: Type.TOptional<Type.TUnion<[Type.TUnsafe<"explorer" | "general">, Type.TNull]>>;
-    prompt: Type.TString;
-    description: Type.TOptional<Type.TUnion<[Type.TString, Type.TNull]>>;
-    cwd: Type.TOptional<Type.TUnion<[Type.TString, Type.TNull]>>;
-}>;
-export declare const SubagentParamsSchema: Type.TObject<{
-    background: Type.TOptional<Type.TUnion<[Type.TBoolean, Type.TNull]>>;
-    tasks: Type.TArray<Type.TObject<{
-        agent: Type.TOptional<Type.TUnion<[Type.TUnsafe<"explorer" | "general">, Type.TNull]>>;
-        prompt: Type.TString;
-        description: Type.TOptional<Type.TUnion<[Type.TString, Type.TNull]>>;
-        cwd: Type.TOptional<Type.TUnion<[Type.TString, Type.TNull]>>;
-    }>>;
-}>;
-export type SubagentParams = Static<typeof SubagentParamsSchema>;
-export type SubagentTask = Static<typeof TaskSchema>;
-/**
- * Unambiguous argument normalizations applied before schema validation:
- * a single task written at the root ({agent, prompt, ...} with no tasks)
- * wraps into tasks[0] with background left at the root, and root-level null
- * fields the schema does not declare are dropped as strict-mode leftovers.
- * Non-null unknown fields are kept on purpose: validation names them instead
- * of silently discarding what may be briefing content.
- */
-export declare function normalizeSubagentArguments(raw: unknown): SubagentParams;
-//# sourceMappingURL=schema.d.ts.map

package/dist/extensions/subagent/schema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/extensions/subagent/schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,MAAM,EAAgB,IAAI,EAAE,MAAM,SAAS,CAAC;AAW1D,eAAO,MAAM,UAAU;;;;;EAqBtB,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;EAahC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACjE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;AAKrD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAevE"}

package/dist/extensions/subagent/schema.js

@@ -1,58 +0,0 @@
-import { StringEnum } from "@earendil-works/pi-ai";
-import { Type } from "typebox";
-import { MAX_CONCURRENCY, MAX_TASKS, SUBAGENT_AGENT_NAMES } from "./constants.js";
-// Strict constrained-sampling providers treat every property as required
-// and reject bare unions at the top level, so the schema is a flat
-// `type: "object"` whose optional fields are also nullable: callers omit
-// a field when the grammar allows it and send null when it does not.
-function nullable(schema, description) {
-    return Type.Optional(Type.Union([schema, Type.Null()], { description }));
-}
-export const TaskSchema = Type.Object({
-    agent: nullable(StringEnum(SUBAGENT_AGENT_NAMES, { description: "Which built-in profile runs this task" }), "Built-in profile; null or omit for explorer (the default)"),
-    prompt: Type.String({
-        minLength: 1,
-        maxLength: 50_000,
-        description: "Complete self-contained briefing; the worker cannot see the parent conversation",
-    }),
-    description: nullable(Type.String({ minLength: 1, maxLength: 80 }), "Short task label (3-5 words) shown in the /bg list, live rows, and report headings; null or omit to derive it from the prompt"),
-    cwd: nullable(Type.String({ minLength: 1, maxLength: 4_096 }), "Worker directory; relative paths resolve against the parent directory. A directory outside the parent runs without that project's settings. Null or omit to inherit."),
-}, { additionalProperties: false });
-export const SubagentParamsSchema = Type.Object({
-    background: nullable(Type.Boolean(), "true runs all tasks as one managed background group and returns a group reference immediately; false, null or omit blocks until every worker finishes and returns their reports"),
-    tasks: Type.Array(TaskSchema, {
-        minItems: 1,
-        maxItems: MAX_TASKS,
-        description: `Independent tasks run concurrently: at most ${MAX_CONCURRENCY} active at once, excess tasks queue, and results preserve input order`,
-    }),
-}, { additionalProperties: false });
-const ROOT_FIELDS = new Set(["background", "tasks"]);
-const TASK_FIELDS = ["agent", "prompt", "description", "cwd"];
-/**
- * Unambiguous argument normalizations applied before schema validation:
- * a single task written at the root ({agent, prompt, ...} with no tasks)
- * wraps into tasks[0] with background left at the root, and root-level null
- * fields the schema does not declare are dropped as strict-mode leftovers.
- * Non-null unknown fields are kept on purpose: validation names them instead
- * of silently discarding what may be briefing content.
- */
-export function normalizeSubagentArguments(raw) {
-    if (raw === null || typeof raw !== "object" || Array.isArray(raw))
-        return raw;
-    const args = { ...raw };
-    for (const key of Object.keys(args)) {
-        if (args[key] === null && !ROOT_FIELDS.has(key))
-            delete args[key];
-    }
-    if (args.tasks === undefined && typeof args.prompt === "string") {
-        const task = {};
-        for (const key of TASK_FIELDS) {
-            if (args[key] !== undefined)
-                task[key] = args[key];
-            delete args[key];
-        }
-        args.tasks = [task];
-    }
-    return args;
-}
-//# sourceMappingURL=schema.js.map

package/dist/extensions/subagent/schema.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/extensions/subagent/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAA6B,IAAI,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAElF,yEAAyE;AACzE,mEAAmE;AACnE,yEAAyE;AACzE,qEAAqE;AACrE,SAAS,QAAQ,CAAoB,MAAS,EAAE,WAAmB;IAClE,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CACpC;IACC,KAAK,EAAE,QAAQ,CACd,UAAU,CAAC,oBAAoB,EAAE,EAAE,WAAW,EAAE,uCAAuC,EAAE,CAAC,EAC1F,2DAA2D,CAC3D;IACD,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;QACnB,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,MAAM;QACjB,WAAW,EAAE,iFAAiF;KAC9F,CAAC;IACF,WAAW,EAAE,QAAQ,CACpB,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,EAC5C,+HAA+H,CAC/H;IACD,GAAG,EAAE,QAAQ,CACZ,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAC/C,sKAAsK,CACtK;CACD,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAC/B,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAC9C;IACC,UAAU,EAAE,QAAQ,CACnB,IAAI,CAAC,OAAO,EAAE,EACd,iLAAiL,CACjL;IACD,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE;QAC7B,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,+CAA+C,eAAe,uEAAuE;KAClJ,CAAC;CACF,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAC/B,CAAC;AAKF,MAAM,WAAW,GAAwB,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;AAC1E,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,CAAU,CAAC;AAEvE;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CAAC,GAAY;IACtD,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAqB,CAAC;IAChG,MAAM,IAAI,GAA4B,EAAE,GAAI,GAA+B,EAAE,CAAC;IAC9E,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACjE,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,SAAS;gBAAE,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,IAAsB,CAAC;AAC/B,CAAC","sourcesContent":["import { StringEnum } from \"@earendil-works/pi-ai\";\nimport { type Static, type TSchema, Type } from \"typebox\";\nimport { MAX_CONCURRENCY, MAX_TASKS, SUBAGENT_AGENT_NAMES } from \"./constants.ts\";\n\n// Strict constrained-sampling providers treat every property as required\n// and reject bare unions at the top level, so the schema is a flat\n// `type: \"object\"` whose optional fields are also nullable: callers omit\n// a field when the grammar allows it and send null when it does not.\nfunction nullable<T extends TSchema>(schema: T, description: string) {\n\treturn Type.Optional(Type.Union([schema, Type.Null()], { description }));\n}\n\nexport const TaskSchema = Type.Object(\n\t{\n\t\tagent: nullable(\n\t\t\tStringEnum(SUBAGENT_AGENT_NAMES, { description: \"Which built-in profile runs this task\" }),\n\t\t\t\"Built-in profile; null or omit for explorer (the default)\",\n\t\t),\n\t\tprompt: Type.String({\n\t\t\tminLength: 1,\n\t\t\tmaxLength: 50_000,\n\t\t\tdescription: \"Complete self-contained briefing; the worker cannot see the parent conversation\",\n\t\t}),\n\t\tdescription: nullable(\n\t\t\tType.String({ minLength: 1, maxLength: 80 }),\n\t\t\t\"Short task label (3-5 words) shown in the /bg list, live rows, and report headings; null or omit to derive it from the prompt\",\n\t\t),\n\t\tcwd: nullable(\n\t\t\tType.String({ minLength: 1, maxLength: 4_096 }),\n\t\t\t\"Worker directory; relative paths resolve against the parent directory. A directory outside the parent runs without that project's settings. Null or omit to inherit.\",\n\t\t),\n\t},\n\t{ additionalProperties: false },\n);\n\nexport const SubagentParamsSchema = Type.Object(\n\t{\n\t\tbackground: nullable(\n\t\t\tType.Boolean(),\n\t\t\t\"true runs all tasks as one managed background group and returns a group reference immediately; false, null or omit blocks until every worker finishes and returns their reports\",\n\t\t),\n\t\ttasks: Type.Array(TaskSchema, {\n\t\t\tminItems: 1,\n\t\t\tmaxItems: MAX_TASKS,\n\t\t\tdescription: `Independent tasks run concurrently: at most ${MAX_CONCURRENCY} active at once, excess tasks queue, and results preserve input order`,\n\t\t}),\n\t},\n\t{ additionalProperties: false },\n);\n\nexport type SubagentParams = Static<typeof SubagentParamsSchema>;\nexport type SubagentTask = Static<typeof TaskSchema>;\n\nconst ROOT_FIELDS: ReadonlySet<string> = new Set([\"background\", \"tasks\"]);\nconst TASK_FIELDS = [\"agent\", \"prompt\", \"description\", \"cwd\"] as const;\n\n/**\n * Unambiguous argument normalizations applied before schema validation:\n * a single task written at the root ({agent, prompt, ...} with no tasks)\n * wraps into tasks[0] with background left at the root, and root-level null\n * fields the schema does not declare are dropped as strict-mode leftovers.\n * Non-null unknown fields are kept on purpose: validation names them instead\n * of silently discarding what may be briefing content.\n */\nexport function normalizeSubagentArguments(raw: unknown): SubagentParams {\n\tif (raw === null || typeof raw !== \"object\" || Array.isArray(raw)) return raw as SubagentParams;\n\tconst args: Record<string, unknown> = { ...(raw as Record<string, unknown>) };\n\tfor (const key of Object.keys(args)) {\n\t\tif (args[key] === null && !ROOT_FIELDS.has(key)) delete args[key];\n\t}\n\tif (args.tasks === undefined && typeof args.prompt === \"string\") {\n\t\tconst task: Record<string, unknown> = {};\n\t\tfor (const key of TASK_FIELDS) {\n\t\t\tif (args[key] !== undefined) task[key] = args[key];\n\t\t\tdelete args[key];\n\t\t}\n\t\targs.tasks = [task];\n\t}\n\treturn args as SubagentParams;\n}\n"]}

package/dist/extensions/subagent/sdk-runner.d.ts

@@ -1,33 +0,0 @@
-import type { AgentSessionEvent } from "../../core/agent-session.ts";
-import type { ModelRuntime } from "../../core/model-runtime.ts";
-import type { RunCancellation } from "./cancellation.ts";
-import type { SubagentRunEvent } from "./state.ts";
-import type { ResolvedSubagentTask } from "./types.ts";
-export interface SdkRunnerOptions {
-    task: ResolvedSubagentTask;
-    /** Cancellation scope covering this attempt (queued through session end). */
-    scope: RunCancellation;
-    /** Reducer input; the adapter never touches run state directly. */
-    dispatch: (event: SubagentRunEvent) => void;
-    modelRuntime: ModelRuntime;
-    agentDir: string;
-    projectTrusted: boolean;
-    onProgress?: () => void;
-}
-export interface MappedSessionEvent {
-    runEvent: SubagentRunEvent;
-    /** Whether the progress emission should be immediate (true) or throttled (false). */
-    immediate: boolean;
-}
-/**
- * Pure mapping from AgentSessionEvent to SubagentRunEvent. Returns undefined
- * for events the subagent adapter does not handle. Exported for unit testing.
- */
-export declare function mapSessionEvent(event: AgentSessionEvent, seenAssistantMessages: Set<unknown>, now?: number): MappedSessionEvent | undefined;
-/**
- * Runs one worker attempt as a pure adapter: it owns the worker session's
- * lifecycle and translates AgentSessionEvents into SubagentRunEvents; every
- * state transition happens in the reducer on the other side of dispatch.
- */
-export declare function runSdkTask(options: SdkRunnerOptions): Promise<void>;
-//# sourceMappingURL=sdk-runner.d.ts.map

package/dist/extensions/subagent/sdk-runner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sdk-runner.d.ts","sourceRoot":"","sources":["../../../src/extensions/subagent/sdk-runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAMhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,6EAA6E;IAC7E,KAAK,EAAE,eAAe,CAAC;IACvB,mEAAmE;IACnE,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC5C,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AA+DD,MAAM,WAAW,kBAAkB;IAClC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,qFAAqF;IACrF,SAAS,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,KAAK,EAAE,iBAAiB,EACxB,qBAAqB,EAAE,GAAG,CAAC,OAAO,CAAC,EACnC,GAAG,SAAa,GACd,kBAAkB,GAAG,SAAS,CA4EhC;AA0CD;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwJzE"}