pi-subagents 0.69.0 → 0.70.0

package/src/runs/background/chain-root-attachment.d.ts

@@ -0,0 +1,49 @@
+import type { AcceptanceLedger, ArtifactPaths, CostSummary, EffectsProjection, ExecutionProjection, Usage } from "../../shared/types.ts";
+export interface ImportedAsyncRoot {
+    runId: string;
+    asyncDir: string;
+    resultPath: string;
+    index: number;
+}
+export interface ImportedAsyncRootResult {
+    agent: string;
+    importedPublication?: {
+        sessionId?: string;
+        toolCallId?: string;
+    };
+    /** Human-readable display name for the child session, when derived at launch. */
+    sessionName?: string;
+    output: string;
+    success: boolean;
+    exitCode: number;
+    error?: string;
+    sessionFile?: string;
+    intercomTarget?: string;
+    model?: string;
+    requestedModel?: string;
+    contextOverflow?: boolean;
+    totalCost?: CostSummary;
+    usage?: Usage;
+    structuredOutput?: unknown;
+    structuredOutputPath?: string;
+    structuredOutputSchemaPath?: string;
+    acceptance?: AcceptanceLedger;
+    artifactPaths?: ArtifactPaths;
+    savedOutputPath?: string;
+    outputSaveError?: string;
+    transcriptPath?: string;
+    transcriptError?: string;
+    timedOut?: boolean;
+    stopped?: boolean;
+    execution?: ExecutionProjection;
+    effects?: EffectsProjection;
+}
+export declare function waitForImportedAsyncRoot(root: ImportedAsyncRoot, options?: {
+    pollIntervalMs?: number;
+    terminalResultGraceMs?: number;
+    now?: () => number;
+    shouldAbort?: () => boolean;
+    timeoutMessage?: string;
+}): Promise<ImportedAsyncRootResult>;
+export declare function resolveAsyncRootResultPath(resultsDir: string, runId: string): string;
+//# sourceMappingURL=chain-root-attachment.d.ts.map

package/src/runs/background/chain-root-attachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-root-attachment.d.ts","sourceRoot":"","sources":["../../../../src/runs/background/chain-root-attachment.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAe,WAAW,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAGtJ,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AA0LD,wBAAsB,wBAAwB,CAC7C,IAAI,EAAE,iBAAiB,EACvB,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO,GACjJ,OAAO,CAAC,uBAAuB,CAAC,CAuBlC;AAED,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpF"}

package/src/runs/background/chain-root-attachment.js

@@ -0,0 +1,184 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { resultFilePath, resultPayloadPathForSessionRun } from "./result-files.js";
+import { readStatus } from "../../shared/utils.js";
+const TERMINAL_STATES = new Set(["complete", "failed", "partial", "paused", "stopped"]);
+const TERMINAL_STEP_STATUSES = new Set(["complete", "completed", "failed", "partial", "paused", "stopped"]);
+function readResultFile(resultPath) {
+    try {
+        return JSON.parse(fs.readFileSync(resultPath, "utf-8"));
+    }
+    catch (error) {
+        if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
+            return undefined;
+        }
+        throw error;
+    }
+}
+function readImportedResultFile(root, status) {
+    const direct = readResultFile(root.resultPath);
+    if (direct || !status?.sessionId)
+        return direct;
+    const indexedPath = resultPayloadPathForSessionRun(path.dirname(root.resultPath), status.sessionId, root.runId);
+    return indexedPath ? readResultFile(indexedPath) : undefined;
+}
+function selectedStatusStep(status, index) {
+    return status?.steps?.[index];
+}
+function isTerminalStatus(status, index) {
+    if (!status)
+        return false;
+    // A workflow-owned single runner publishes its result after completing its
+    // step. Keep that window open while root process proof is absent or pending;
+    // explicit terminal/unavailable proof retains the existing step fallback.
+    if (status.mode === "single" && status.parentWorkflowRunId
+        && (!status.processTerminal || status.processTerminal.state === "pending"))
+        return TERMINAL_STATES.has(status.state);
+    const step = selectedStatusStep(status, index);
+    if (step && TERMINAL_STEP_STATUSES.has(step.status))
+        return true;
+    return TERMINAL_STATES.has(status.state);
+}
+function resultState(result, child) {
+    if (!result)
+        return undefined;
+    if (child?.stopped === true)
+        return "stopped";
+    if (child?.success === true)
+        return "complete";
+    if (child?.success === false)
+        return result.state === "stopped" ? "stopped" : result.state === "paused" ? "paused" : result.state === "partial" ? "partial" : "failed";
+    if (result.state === "complete" || result.state === "failed" || result.state === "partial" || result.state === "paused" || result.state === "stopped")
+        return result.state;
+    if (result.success === true)
+        return "complete";
+    if (result.success === false)
+        return "failed";
+    return undefined;
+}
+function outputFromTerminalStatus(root, status, step) {
+    const agent = step?.agent ?? status.steps?.[root.index]?.agent ?? "subagent";
+    const timedOut = step?.timedOut === true || status.timedOut === true;
+    const stopped = step?.stopped === true || status.stopped === true || status.state === "stopped";
+    const message = step?.error ?? status.error ?? (stopped ? "Subagent stopped by user." : `Attached async root ${root.runId} ended without a result file at ${root.resultPath}.`);
+    const partialStatus = status.state === "partial" || step?.status === "partial";
+    const execution = step?.execution ?? (partialStatus
+        ? { status: "partial", success: false, exitCode: 1, error: message }
+        : undefined);
+    return {
+        agent,
+        output: message,
+        success: false,
+        exitCode: 1,
+        error: message,
+        ...(timedOut ? { timedOut: true } : {}),
+        ...(stopped ? { stopped: true } : {}),
+        ...(step?.sessionName ? { sessionName: step.sessionName } : {}),
+        ...(step?.sessionFile ?? status.sessionFile ? { sessionFile: step?.sessionFile ?? status.sessionFile } : {}),
+        ...(step?.model ? { model: step.model } : {}),
+        ...(step?.requestedModel ? { requestedModel: step.requestedModel } : {}),
+        ...(step?.contextOverflow ? { contextOverflow: true } : {}),
+        ...(step?.totalCost ? { totalCost: step.totalCost } : {}),
+        ...(step?.structuredOutput !== undefined ? { structuredOutput: step.structuredOutput } : {}),
+        ...(step?.structuredOutputPath ? { structuredOutputPath: step.structuredOutputPath } : {}),
+        ...(step?.structuredOutputSchemaPath ? { structuredOutputSchemaPath: step.structuredOutputSchemaPath } : {}),
+        ...(step?.acceptance ? { acceptance: step.acceptance } : {}),
+        ...(execution ? { execution } : {}),
+        ...(step?.effects ? { effects: step.effects } : {}),
+        ...(step?.transcriptPath ? { transcriptPath: step.transcriptPath } : {}),
+    };
+}
+function outputFromTimeout(root, status, message) {
+    const step = selectedStatusStep(status, root.index);
+    return {
+        agent: step?.agent ?? status?.steps?.[root.index]?.agent ?? "subagent",
+        output: message,
+        success: false,
+        exitCode: 1,
+        error: message,
+        timedOut: true,
+        ...(step?.sessionName ? { sessionName: step.sessionName } : {}),
+        ...(step?.sessionFile ?? status?.sessionFile ? { sessionFile: step?.sessionFile ?? status?.sessionFile } : {}),
+        ...(step?.model ? { model: step.model } : {}),
+        ...(step?.requestedModel ? { requestedModel: step.requestedModel } : {}),
+        ...(step?.contextOverflow ? { contextOverflow: true } : {}),
+        ...(step?.totalCost ? { totalCost: step.totalCost } : {}),
+        ...(step?.transcriptPath ? { transcriptPath: step.transcriptPath } : {}),
+    };
+}
+function buildImportedResult(root, status, result) {
+    const child = result.results?.[root.index];
+    const step = selectedStatusStep(status, root.index);
+    const state = resultState(result, child);
+    const agent = child?.agent ?? step?.agent ?? status?.steps?.[root.index]?.agent ?? "subagent";
+    const output = child?.output ?? result.summary ?? "";
+    const timedOut = child?.timedOut === true || step?.timedOut === true || result.timedOut === true || status?.timedOut === true;
+    const stopped = child?.stopped === true || step?.stopped === true || result.stopped === true || status?.stopped === true || state === "stopped";
+    const success = state === "complete" && !timedOut && !stopped;
+    const error = child?.error ?? (success ? undefined : stopped ? "Subagent stopped by user." : result.error ?? result.summary ?? status?.error ?? `Attached async root ${root.runId} did not complete successfully.`);
+    const execution = state ? { status: state === "complete" ? "completed" : state, success, exitCode: success ? 0 : 1, ...(error ? { error } : {}) } : undefined;
+    const usage = child?.usage;
+    return {
+        agent,
+        importedPublication: {
+            ...(typeof result.sessionId === "string" ? { sessionId: result.sessionId } : {}),
+            ...(typeof result.toolCallId === "string" ? { toolCallId: result.toolCallId } : {}),
+        },
+        output: success ? output : (output || error || ""),
+        success,
+        exitCode: success ? 0 : 1,
+        ...(error ? { error } : {}),
+        ...(timedOut ? { timedOut: true } : {}),
+        ...(stopped ? { stopped: true } : {}),
+        ...(child?.sessionName ?? step?.sessionName ? { sessionName: child?.sessionName ?? step?.sessionName } : {}),
+        ...(child?.sessionFile ?? step?.sessionFile ?? status?.sessionFile ? { sessionFile: child?.sessionFile ?? step?.sessionFile ?? status?.sessionFile } : {}),
+        ...(child?.intercomTarget ? { intercomTarget: child.intercomTarget } : {}),
+        ...(child?.model ?? step?.model ? { model: child?.model ?? step?.model } : {}),
+        ...(child?.requestedModel ?? step?.requestedModel ? { requestedModel: child?.requestedModel ?? step?.requestedModel } : {}),
+        ...(child?.contextOverflow || step?.contextOverflow ? { contextOverflow: true } : {}),
+        ...(child?.totalCost ?? step?.totalCost ? { totalCost: child?.totalCost ?? step?.totalCost } : {}),
+        ...(usage ? { usage } : {}),
+        ...(child?.structuredOutput !== undefined ? { structuredOutput: child.structuredOutput } : step?.structuredOutput !== undefined ? { structuredOutput: step.structuredOutput } : {}),
+        ...(child?.structuredOutputPath ?? step?.structuredOutputPath ? { structuredOutputPath: child?.structuredOutputPath ?? step?.structuredOutputPath } : {}),
+        ...(child?.structuredOutputSchemaPath ?? step?.structuredOutputSchemaPath ? { structuredOutputSchemaPath: child?.structuredOutputSchemaPath ?? step?.structuredOutputSchemaPath } : {}),
+        ...(child?.acceptance ?? step?.acceptance ? { acceptance: child?.acceptance ?? step?.acceptance } : {}),
+        ...(child?.artifactPaths ? { artifactPaths: child.artifactPaths } : {}),
+        ...(child?.savedOutputPath ? { savedOutputPath: child.savedOutputPath } : {}),
+        ...(child?.outputSaveError ? { outputSaveError: child.outputSaveError } : {}),
+        ...(child?.transcriptPath ?? step?.transcriptPath ? { transcriptPath: child?.transcriptPath ?? step?.transcriptPath } : {}),
+        ...(child?.transcriptError ? { transcriptError: child.transcriptError } : {}),
+        ...(execution ? { execution } : {}),
+        ...(child?.effects ?? step?.effects ? { effects: child?.effects ?? step?.effects } : {}),
+    };
+}
+export async function waitForImportedAsyncRoot(root, options = {}) {
+    const pollIntervalMs = options.pollIntervalMs ?? 500;
+    const terminalResultGraceMs = options.terminalResultGraceMs ?? 1_000;
+    const now = options.now ?? Date.now;
+    let terminalSince;
+    for (;;) {
+        const status = readStatus(root.asyncDir);
+        if (options.shouldAbort?.())
+            return outputFromTimeout(root, status, options.timeoutMessage ?? "Subagent timed out.");
+        const result = readImportedResultFile(root, status);
+        if (result)
+            return buildImportedResult(root, status, result);
+        if (isTerminalStatus(status, root.index)) {
+            terminalSince ??= now();
+            if (now() - terminalSince >= terminalResultGraceMs) {
+                return outputFromTerminalStatus(root, status, selectedStatusStep(status, root.index));
+            }
+        }
+        else {
+            terminalSince = undefined;
+        }
+        if (!status && !fs.existsSync(root.asyncDir)) {
+            throw new Error(`Attached async root '${root.runId}' directory does not exist: ${root.asyncDir}`);
+        }
+        await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+    }
+}
+export function resolveAsyncRootResultPath(resultsDir, runId) {
+    return resultFilePath(resultsDir, runId);
+}
+//# sourceMappingURL=chain-root-attachment.js.map

package/src/runs/background/chain-root-attachment.js.map

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

package/src/runs/background/completion-batcher.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Smart completion batching with straggler handling.
+ *
+ * Holds successful async-completion notifications briefly so sibling jobs that
+ * finish within a short window arrive as a single grouped message. A hard
+ * max-wait cap (measured from the first item in a group) prevents holding
+ * notifications indefinitely. After a group is emitted, late-finishing
+ * siblings that arrive within the straggler window join a shorter "straggler"
+ * group with reduced debounce and max-wait timers.
+ *
+ * Failure and attention signals bypass this batcher entirely. Callers must
+ * flush() held items and emit those signals immediately so failures and
+ * needs-attention notices are never delayed.
+ */
+import type { CompletionBatchConfig } from "../../shared/types.ts";
+export type { CompletionBatchConfig };
+export interface ResolvedCompletionBatchConfig {
+    enabled: boolean;
+    debounceMs: number;
+    maxWaitMs: number;
+    stragglerDebounceMs: number;
+    stragglerMaxWaitMs: number;
+    stragglerWindowMs: number;
+}
+export declare const DEFAULT_COMPLETION_BATCH_CONFIG: ResolvedCompletionBatchConfig;
+export declare function resolveCompletionBatchConfig(globalConfig?: CompletionBatchConfig, override?: CompletionBatchConfig): ResolvedCompletionBatchConfig;
+type TimerHandle = unknown;
+interface TimerApi {
+    setTimeout(handler: () => void, delayMs: number): TimerHandle;
+    clearTimeout(handle: TimerHandle): void;
+}
+export interface CompletionBatcherOptions<T> {
+    config: ResolvedCompletionBatchConfig;
+    emit: (items: T[]) => void;
+    timers?: TimerApi;
+    now?: () => number;
+}
+export interface CompletionBatcher<T> {
+    /** Add a batchable item. Emits immediately when batching is disabled. */
+    push(item: T): void;
+    /** Emit any held items immediately as a single group. */
+    flush(): void;
+    /** Clear timers and return items that were never emitted. */
+    dispose(): T[];
+}
+/**
+ * Create a completion batcher. The batcher is single-use per registration: it
+ * holds at most one open group. `flush` forces emission; `dispose` tears down
+ * timers for reload/shutdown without emitting.
+ */
+export declare function createCompletionBatcher<T>(options: CompletionBatcherOptions<T>): CompletionBatcher<T>;
+//# sourceMappingURL=completion-batcher.d.ts.map

package/src/runs/background/completion-batcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-batcher.d.ts","sourceRoot":"","sources":["../../../../src/runs/background/completion-batcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,YAAY,EAAE,qBAAqB,EAAE,CAAC;AAEtC,MAAM,WAAW,6BAA6B;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,+BAA+B,EAAE,6BAO7C,CAAC;AAOF,wBAAgB,4BAA4B,CAC3C,YAAY,CAAC,EAAE,qBAAqB,EACpC,QAAQ,CAAC,EAAE,qBAAqB,GAC9B,6BAA6B,CAc/B;AAED,KAAK,WAAW,GAAG,OAAO,CAAC;AAE3B,UAAU,QAAQ;IACjB,UAAU,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAAC;IAC9D,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CACxC;AAaD,MAAM,WAAW,wBAAwB,CAAC,CAAC;IAC1C,MAAM,EAAE,6BAA6B,CAAC;IACtC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IACnC,yEAAyE;IACzE,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACpB,yDAAyD;IACzD,KAAK,IAAI,IAAI,CAAC;IACd,6DAA6D;IAC7D,OAAO,IAAI,CAAC,EAAE,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,OAAO,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAmErG"}

package/src/runs/background/completion-batcher.js

@@ -0,0 +1,120 @@
+/**
+ * Smart completion batching with straggler handling.
+ *
+ * Holds successful async-completion notifications briefly so sibling jobs that
+ * finish within a short window arrive as a single grouped message. A hard
+ * max-wait cap (measured from the first item in a group) prevents holding
+ * notifications indefinitely. After a group is emitted, late-finishing
+ * siblings that arrive within the straggler window join a shorter "straggler"
+ * group with reduced debounce and max-wait timers.
+ *
+ * Failure and attention signals bypass this batcher entirely. Callers must
+ * flush() held items and emit those signals immediately so failures and
+ * needs-attention notices are never delayed.
+ */
+export const DEFAULT_COMPLETION_BATCH_CONFIG = {
+    enabled: true,
+    debounceMs: 150,
+    maxWaitMs: 1000,
+    stragglerDebounceMs: 75,
+    stragglerMaxWaitMs: 400,
+    stragglerWindowMs: 2000,
+};
+function parsePositiveInt(value) {
+    if (typeof value !== "number" || !Number.isFinite(value) || !Number.isInteger(value) || value < 1)
+        return undefined;
+    return value;
+}
+export function resolveCompletionBatchConfig(globalConfig, override) {
+    const enabled = typeof override?.enabled === "boolean"
+        ? override.enabled
+        : typeof globalConfig?.enabled === "boolean"
+            ? globalConfig.enabled
+            : DEFAULT_COMPLETION_BATCH_CONFIG.enabled;
+    return {
+        enabled,
+        debounceMs: parsePositiveInt(override?.debounceMs) ?? parsePositiveInt(globalConfig?.debounceMs) ?? DEFAULT_COMPLETION_BATCH_CONFIG.debounceMs,
+        maxWaitMs: parsePositiveInt(override?.maxWaitMs) ?? parsePositiveInt(globalConfig?.maxWaitMs) ?? DEFAULT_COMPLETION_BATCH_CONFIG.maxWaitMs,
+        stragglerDebounceMs: parsePositiveInt(override?.stragglerDebounceMs) ?? parsePositiveInt(globalConfig?.stragglerDebounceMs) ?? DEFAULT_COMPLETION_BATCH_CONFIG.stragglerDebounceMs,
+        stragglerMaxWaitMs: parsePositiveInt(override?.stragglerMaxWaitMs) ?? parsePositiveInt(globalConfig?.stragglerMaxWaitMs) ?? DEFAULT_COMPLETION_BATCH_CONFIG.stragglerMaxWaitMs,
+        stragglerWindowMs: parsePositiveInt(override?.stragglerWindowMs) ?? parsePositiveInt(globalConfig?.stragglerWindowMs) ?? DEFAULT_COMPLETION_BATCH_CONFIG.stragglerWindowMs,
+    };
+}
+const defaultTimers = {
+    setTimeout: (handler, delayMs) => setTimeout(handler, delayMs),
+    clearTimeout: (handle) => clearTimeout(handle),
+};
+function unrefHandle(handle) {
+    if (handle && typeof handle === "object" && "unref" in handle && typeof handle.unref === "function") {
+        handle.unref();
+    }
+}
+/**
+ * Create a completion batcher. The batcher is single-use per registration: it
+ * holds at most one open group. `flush` forces emission; `dispose` tears down
+ * timers for reload/shutdown without emitting.
+ */
+export function createCompletionBatcher(options) {
+    const timers = options.timers ?? defaultTimers;
+    const now = options.now ?? Date.now;
+    const config = options.config;
+    if (!config.enabled) {
+        return {
+            push(item) {
+                options.emit([item]);
+            },
+            flush() { },
+            dispose() { return []; },
+        };
+    }
+    let pending = [];
+    let debounceTimer = null;
+    let maxWaitTimer = null;
+    let straggler = false;
+    let lastEmitAt = null;
+    const clearTimers = () => {
+        if (debounceTimer) {
+            timers.clearTimeout(debounceTimer);
+            debounceTimer = null;
+        }
+        if (maxWaitTimer) {
+            timers.clearTimeout(maxWaitTimer);
+            maxWaitTimer = null;
+        }
+    };
+    const emitGroup = () => {
+        clearTimers();
+        if (pending.length === 0)
+            return;
+        const items = pending;
+        pending = [];
+        lastEmitAt = now();
+        options.emit(items);
+    };
+    return {
+        push(item) {
+            if (pending.length === 0) {
+                straggler = lastEmitAt !== null && (now() - lastEmitAt) < config.stragglerWindowMs;
+            }
+            pending.push(item);
+            if (debounceTimer)
+                timers.clearTimeout(debounceTimer);
+            const debounceDelay = straggler ? config.stragglerDebounceMs : config.debounceMs;
+            debounceTimer = timers.setTimeout(emitGroup, debounceDelay);
+            unrefHandle(debounceTimer);
+            if (!maxWaitTimer) {
+                const maxWaitDelay = straggler ? config.stragglerMaxWaitMs : config.maxWaitMs;
+                maxWaitTimer = timers.setTimeout(emitGroup, maxWaitDelay);
+                unrefHandle(maxWaitTimer);
+            }
+        },
+        flush: emitGroup,
+        dispose() {
+            clearTimers();
+            const abandoned = pending;
+            pending = [];
+            return abandoned;
+        }
+    };
+}
+//# sourceMappingURL=completion-batcher.js.map

package/src/runs/background/completion-batcher.js.map

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

package/src/runs/background/completion-dedupe.d.ts

@@ -0,0 +1,14 @@
+interface CompletionDataLike {
+    id?: unknown;
+    agent?: unknown;
+    timestamp?: unknown;
+    sessionId?: unknown;
+    state?: unknown;
+    taskIndex?: unknown;
+    totalTasks?: unknown;
+    success?: unknown;
+}
+export declare function buildCompletionKey(data: CompletionDataLike, fallback: string): string;
+export declare function markSeenWithTtl(seen: Map<string, number>, key: string, now: number, ttlMs: number): boolean;
+export {};
+//# sourceMappingURL=completion-dedupe.d.ts.map

package/src/runs/background/completion-dedupe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-dedupe.d.ts","sourceRoot":"","sources":["../../../../src/runs/background/completion-dedupe.ts"],"names":[],"mappings":"AAAA,UAAU,kBAAkB;IAC3B,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAaD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAsBrF;AAQD,wBAAgB,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAK3G"}

package/src/runs/background/completion-dedupe.js

@@ -0,0 +1,49 @@
+function asNonEmptyString(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function asFiniteNumber(value) {
+    if (typeof value !== "number")
+        return undefined;
+    return Number.isFinite(value) ? value : undefined;
+}
+export function buildCompletionKey(data, fallback) {
+    const sessionId = asNonEmptyString(data.sessionId) ?? "no-session";
+    const id = asNonEmptyString(data.id);
+    const state = asNonEmptyString(data.state);
+    if (id)
+        return state
+            ? `session:${sessionId}:id:${id}:state:${state}`
+            : `session:${sessionId}:id:${id}`;
+    const agent = asNonEmptyString(data.agent) ?? "unknown";
+    const timestamp = asFiniteNumber(data.timestamp);
+    const taskIndex = asFiniteNumber(data.taskIndex);
+    const totalTasks = asFiniteNumber(data.totalTasks);
+    const success = typeof data.success === "boolean" ? (data.success ? "1" : "0") : "?";
+    return [
+        "meta",
+        sessionId,
+        agent,
+        timestamp !== undefined ? String(timestamp) : "no-ts",
+        taskIndex !== undefined ? String(taskIndex) : "-",
+        totalTasks !== undefined ? String(totalTasks) : "-",
+        success,
+        fallback,
+    ].join(":");
+}
+function pruneSeenMap(seen, now, ttlMs) {
+    for (const [key, ts] of seen.entries()) {
+        if (now - ts > ttlMs)
+            seen.delete(key);
+    }
+}
+export function markSeenWithTtl(seen, key, now, ttlMs) {
+    pruneSeenMap(seen, now, ttlMs);
+    if (seen.has(key))
+        return true;
+    seen.set(key, now);
+    return false;
+}
+//# sourceMappingURL=completion-dedupe.js.map

package/src/runs/background/completion-dedupe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-dedupe.js","sourceRoot":"","sources":["../../../../src/runs/background/completion-dedupe.ts"],"names":[],"mappings":"AAWA,SAAS,gBAAgB,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACjD,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAwB,EAAE,QAAgB;IAC5E,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,YAAY,CAAC;IACnE,MAAM,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,EAAE;QAAE,OAAO,KAAK;YACnB,CAAC,CAAC,WAAW,SAAS,OAAO,EAAE,UAAU,KAAK,EAAE;YAChD,CAAC,CAAC,WAAW,SAAS,OAAO,EAAE,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;IACxD,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACrF,OAAO;QACN,MAAM;QACN,SAAS;QACT,KAAK;QACL,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO;QACrD,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG;QACjD,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG;QACnD,OAAO;QACP,QAAQ;KACR,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACb,CAAC;AAED,SAAS,YAAY,CAAC,IAAyB,EAAE,GAAW,EAAE,KAAa;IAC1E,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QACxC,IAAI,GAAG,GAAG,EAAE,GAAG,KAAK;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;AACF,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAyB,EAAE,GAAW,EAAE,GAAW,EAAE,KAAa;IACjG,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAC/B,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACnB,OAAO,KAAK,CAAC;AACd,CAAC"}

package/src/runs/background/completion-replay.d.ts

@@ -0,0 +1,48 @@
+import type { WaitCompletion } from "../../shared/types.ts";
+export interface CompletionArchiveEntry {
+    agent?: string;
+    resultIndex?: number;
+    source: "output-artifact" | "session" | "result-tail";
+    path?: string;
+    text?: string;
+    truncated?: boolean;
+}
+export interface CompletionArchive {
+    version: 1;
+    runId: string;
+    createdAt: number;
+    entries: CompletionArchiveEntry[];
+}
+export interface CompletionReplayRecord {
+    version: 1;
+    runId: string;
+    sessionId: string;
+    completedAt: number;
+    expiresAt: number;
+    completion: WaitCompletion;
+    archivePath: string;
+}
+export declare function completionReplayPath(resultsDir: string, runId: string): string;
+export declare function completionArchivePath(resultsDir: string, runId: string): string;
+/** Create a small archive that references saved child artifacts and retains only bounded fallback output text. */
+export declare function writeCompletionArchive(resultsDir: string, runId: string, data: Record<string, unknown>, createdAt: number): string;
+/** Persist a terminal completion before its one-shot result file is removed. */
+export declare function writeCompletionReplay(input: {
+    resultsDir: string;
+    runId: string;
+    sessionId: string;
+    completion: WaitCompletion;
+    data: Record<string, unknown>;
+    now: number;
+    ttlMs: number;
+}): CompletionReplayRecord;
+/** Read a current replay record. Unknown fields are ignored and unknown versions are skipped. */
+export declare function readCompletionReplay(resultsDir: string, runId: string, options?: {
+    sessionId?: string;
+    now?: number;
+}): CompletionReplayRecord | undefined;
+export declare function readCompletionArchive(archivePath: string): CompletionArchive | undefined;
+export declare function cleanupCompletionReplayIfDue(resultsDir: string, now: number, maxAgeMs: number, intervalMs?: number): boolean;
+/** Opportunistically remove expired replay and orphan archive files without affecting delivery. */
+export declare function cleanupCompletionReplay(resultsDir: string, now: number, maxAgeMs: number): void;
+//# sourceMappingURL=completion-replay.d.ts.map

package/src/runs/background/completion-replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-replay.d.ts","sourceRoot":"","sources":["../../../../src/runs/background/completion-replay.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAW5D,MAAM,WAAW,sBAAsB;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,iBAAiB,GAAG,SAAS,GAAG,aAAa,CAAC;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,sBAAsB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB;IACtC,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,cAAc,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACpB;AAMD,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/E;AAqBD,kHAAkH;AAClH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CA8ClI;AAkED,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,cAAc,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACd,GAAG,sBAAsB,CAezB;AAED,iGAAiG;AACjG,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,sBAAsB,GAAG,SAAS,CAuB9J;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CASxF;AAED,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,SAAsB,GAAG,OAAO,CAMzI;AAED,mGAAmG;AACnG,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CA8B/F"}