@emiliosp/pi-maestro 0.16.0 → 0.18.0

package/node_modules/pi-subagents/src/runs/background/notify.js

@@ -1,897 +0,0 @@
-/**
- * Completion notification delivery.
- *
- * Async result files call this notifier directly and are deleted only after
- * `sendMessage()` accepts the notification. The event bus remains an
- * observation channel, not a delivery acknowledgement.
- */
-import { statSync } from "node:fs";
-import { debuglog } from "node:util";
-import { buildCompletionKey, markSeenWithTtl } from "./completion-dedupe.js";
-import { createCompletionBatcher, resolveCompletionBatchConfig, } from "./completion-batcher.js";
-import { SUBAGENT_ASYNC_COMPLETE_EVENT, SUBAGENT_FOREGROUND_COMPLETE_EVENT } from "../../shared/types.js";
-import { safeTerminalText } from "../../shared/display-text.js";
-import { resolveSubagentResultStatus } from "../../intercom/result-intercom.js";
-import { isUnexplainedProcessSignal } from "../shared/process-signal.js";
-import { capSummaryOutputs } from "../shared/single-output.js";
-const CHILD_OUTPUT_PREVIEW_MAX_BYTES = 2_000;
-const ERROR_LINE_MAX_BYTES = 300;
-const CHILD_OUTPUT_PREVIEW_COUNT = 8;
-const PREVIEW_TRUNCATION_MARKER = "...[preview truncated]";
-const COMPLETION_SEND_TTL_MS = 10 * 60 * 1000;
-const COMPLETION_SEND_REGISTRY_CAP = 4_096;
-function truncateUtf8Head(value, maxBytes) {
-    const bytes = Buffer.from(value, "utf8");
-    if (bytes.length <= maxBytes)
-        return { text: value, truncated: false };
-    const markerBytes = Buffer.byteLength(PREVIEW_TRUNCATION_MARKER, "utf8");
-    const contentBytes = Math.max(0, maxBytes - markerBytes);
-    let end = contentBytes;
-    while (end > 0 && (bytes[end] & 0xc0) === 0x80)
-        end -= 1;
-    return {
-        text: `${bytes.subarray(0, end).toString("utf8")}${PREVIEW_TRUNCATION_MARKER}`,
-        truncated: true,
-    };
-}
-function boundedSafeText(value, maxBytes = 1_024) {
-    return truncateUtf8Head(safeTerminalText(value).replace(/\n/g, "\\n"), maxBytes).text;
-}
-function outputPathFromReference(value) {
-    if (typeof value === "string" && value.trim())
-        return value.trim();
-    if (value && typeof value === "object" && typeof value.path === "string" && value.path.trim())
-        return value.path.trim();
-    return undefined;
-}
-function childSavedOutputPath(child) {
-    return outputPathFromReference(child.outputReference);
-}
-function nonemptyPath(value) {
-    return typeof value === "string" && value.trim() ? value.trim() : undefined;
-}
-function retainedChildPath(value, producerConfirmed = false) {
-    const path = nonemptyPath(value);
-    if (!path)
-        return { status: "unavailable" };
-    if (producerConfirmed)
-        return { status: "verified", path };
-    try {
-        return statSync(path).isFile() ? { status: "verified", path } : { status: "unavailable" };
-    }
-    catch (error) {
-        const code = typeof error === "object" && error !== null && "code" in error && typeof error.code === "string" ? error.code : undefined;
-        if (code === "ENOENT" || code === "ENOTDIR")
-            return { status: "unavailable" };
-        return { status: "error", error: { path, ...(code ? { code } : {}), message: error instanceof Error ? error.message : String(error) } };
-    }
-}
-function formatRetainedPathError(label, error) {
-    return `  ${label} verification failed: stat ${error.code ? boundedSafeText(error.code, 32) : "unknown"}; path=${boundedSafeText(error.path, 384)}; ${boundedSafeText(error.message, 512)}`;
-}
-function childStatus(child, workflowState) {
-    const knownStatus = child.status === "complete"
-        ? "completed"
-        : child.status === "running" || child.status === "completed" || child.status === "failed" || child.status === "paused" || child.status === "stopped" || child.status === "detached"
-            ? child.status
-            : undefined;
-    if (knownStatus)
-        return knownStatus;
-    return resolveSubagentResultStatus({
-        success: child.success,
-        state: child.state ?? (child.success === undefined ? workflowState : undefined),
-        interrupted: child.interrupted,
-        detached: child.detached,
-        processSignal: child.processSignal,
-        timedOut: child.timedOut,
-        stopped: child.stopped,
-        turnBudgetExceeded: child.turnBudgetExceeded,
-        exitCode: typeof child.exitCode === "number" ? child.exitCode : undefined,
-    });
-}
-function structuredOutputText(value) {
-    if (value === undefined)
-        return undefined;
-    try {
-        const serialized = JSON.stringify(value, null, 2);
-        return typeof serialized === "string" ? serialized : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-function isDegenerateOutput(text) {
-    return !text.trim() || text.trim() === "</think>";
-}
-function firstErrorLine(error) {
-    if (typeof error !== "string")
-        return undefined;
-    const line = error.split("\n").find((part) => part.trim())?.trim();
-    return line ? boundedSafeText(line, ERROR_LINE_MAX_BYTES) : undefined;
-}
-function childInlinePreview(child) {
-    const output = typeof child.output === "string" ? child.output : "";
-    const outputReference = childSavedOutputPath(child);
-    const referenceOnly = Boolean(outputReference && output.trim().startsWith("Output saved to:"));
-    const raw = child.outputState === "absent" || referenceOnly
-        ? structuredOutputText(child.structuredOutput)
-        : isDegenerateOutput(output) ? structuredOutputText(child.structuredOutput) ?? output : output;
-    if (!raw?.trim()) {
-        return { unavailableReason: referenceOnly ? "saved output is file-only" : "no safe inline output" };
-    }
-    const safe = safeTerminalText(raw);
-    if (!safe.trim())
-        return { unavailableReason: "no safe inline output" };
-    const bounded = truncateUtf8Head(safe, CHILD_OUTPUT_PREVIEW_MAX_BYTES);
-    return { preview: bounded.text, ...(bounded.truncated ? { truncated: true } : {}) };
-}
-function formatChildOutputBlock(children) {
-    if (!children?.length)
-        return undefined;
-    const lines = ["Child outputs:"];
-    for (let index = 0; index < children.length; index++) {
-        const child = children[index];
-        const key = child.workflowKey ? boundedSafeText(child.workflowKey) : "unavailable";
-        const runId = child.runId ? boundedSafeText(child.runId) : "unavailable";
-        const status = boundedSafeText(child.status) || "unavailable";
-        lines.push(`- key=${key} run=${runId} status=${status}`);
-        if (child.revival)
-            lines.push(`  ${boundedSafeText(child.revival)}`);
-        lines.push(`  Saved output: ${child.savedOutputPath ? boundedSafeText(child.savedOutputPath) : "unavailable"}`);
-        if (child.outputArtifactPath)
-            lines.push(`  Output artifact (retention-managed): ${boundedSafeText(child.outputArtifactPath)}`);
-        if (child.structuredOutputPath)
-            lines.push(`  Structured output (retention-managed): ${boundedSafeText(child.structuredOutputPath)}`);
-        if (child.outputArtifactError)
-            lines.push(formatRetainedPathError("Output artifact", child.outputArtifactError));
-        if (child.structuredOutputError)
-            lines.push(formatRetainedPathError("Structured output", child.structuredOutputError));
-        if (child.error)
-            lines.push(`  Error: ${child.error}`);
-        if (child.previewTruncated && !child.savedOutputPath && !child.outputArtifactPath)
-            lines.push("  Full output unavailable");
-        if (index >= CHILD_OUTPUT_PREVIEW_COUNT) {
-            lines.push("  Preview: unavailable (notice preview budget exceeded)");
-            continue;
-        }
-        if (!child.preview) {
-            lines.push(`  Preview: unavailable (${child.previewUnavailableReason ?? "no safe inline output"})`);
-            continue;
-        }
-        lines.push("  Preview:");
-        for (const line of child.preview.split("\n"))
-            lines.push(`    | ${line}`);
-    }
-    if (children.length > CHILD_OUTPUT_PREVIEW_COUNT) {
-        lines.push(`- ${children.length - CHILD_OUTPUT_PREVIEW_COUNT} additional child preview(s) omitted by notice budget; child run metadata is retained below.`);
-    }
-    return lines.join("\n");
-}
-function formatResultPreview(details) {
-    const summary = details.resultPreview.trim() ? details.resultPreview : "(no output)";
-    const childOutputs = formatChildOutputBlock(details.childOutputs);
-    return childOutputs ? `${summary}\n\n${childOutputs}` : summary;
-}
-function formatSessionLine(details) {
-    if (!details.sessionValue)
-        return undefined;
-    return details.sessionLabel ? `${details.sessionLabel}: ${details.sessionValue}` : details.sessionValue;
-}
-function formatChildRun(child) {
-    const label = child.workflowKey ?? child.agent;
-    const status = child.status ? ` (${child.status})` : "";
-    return `${label ? `${label}=` : ""}${child.runId}${status}`;
-}
-function formatCorrelationLines(details) {
-    return [
-        details.asyncDir ? `Retention-managed async directory: ${boundedSafeText(details.asyncDir)}` : undefined,
-        details.workflowRunId ? `Workflow run: ${details.workflowRunId}` : undefined,
-        details.childRuns?.length ? `Child runs: ${details.childRuns.map(formatChildRun).join(", ")}` : undefined,
-        details.reconciledFromDetachedChild ? `Reconciled detached child: ${details.reconciledFromDetachedChild}` : undefined,
-    ].filter((line) => line !== undefined);
-}
-const WATCHDOG_BLOCKERS_HEADING = "Watchdog blockers:";
-function formatWatchdogBlockerLines(details) {
-    if (!details.watchdogBlockers?.length)
-        return [];
-    return [WATCHDOG_BLOCKERS_HEADING, ...details.watchdogBlockers.map((blocker) => `- ${blocker.agent}: ${blocker.summary} (${blocker.stalemate ? "stalemate" : blocker.addressed ? "addressed" : "unaddressed"})`)];
-}
-// A stalemate blocker parses back as unaddressed; acceptance treats both as unresolved.
-function parseWatchdogBlockerLines(lines) {
-    const blockers = [];
-    for (const line of lines) {
-        const match = line.match(/^- (.+?): (.+) \((addressed|unaddressed|stalemate)\)$/);
-        if (!match)
-            break;
-        blockers.push({ agent: match[1], summary: match[2], addressed: match[3] === "addressed", stalemate: match[3] === "stalemate" });
-    }
-    return blockers;
-}
-export function formatSingleCompletion(details) {
-    const sessionLine = formatSessionLine(details);
-    const correlationLines = formatCorrelationLines(details);
-    const watchdogLines = formatWatchdogBlockerLines(details);
-    const taskKind = details.source === "foreground" ? "Detached foreground task" : "Background task";
-    const scheduleLine = details.scheduleOrigin
-        ? `Scheduled run from **${details.scheduleOrigin.name ?? details.scheduleOrigin.id}** (schedule ${details.scheduleOrigin.id}).`
-        : undefined;
-    return [
-        `${taskKind} ${details.status}: **${details.agent}**${details.taskInfo ?? ""}`,
-        details.workflowReceiptPath ? `Workflow receipt: ${details.workflowReceiptPath}` : undefined,
-        "",
-        scheduleLine,
-        scheduleLine ? "" : undefined,
-        formatResultPreview(details),
-        ...(watchdogLines.length ? ["", ...watchdogLines] : []),
-        details.handoffPath ? "" : undefined,
-        details.handoffPath ? `Parallel handoff: ${details.handoffPath}` : undefined,
-        correlationLines.length && !details.handoffPath ? "" : undefined,
-        ...correlationLines,
-        sessionLine ? "" : undefined,
-        sessionLine,
-    ]
-        .filter((line) => line !== undefined)
-        .join("\n");
-}
-export function scheduledCompletionTriggersTurn(origin, outcome) {
-    return !(origin?.quiet === true && outcome === "completed");
-}
-/**
- * Child settlement is useful context, but an ordinary successful child does not
- * establish the workflow's dependency barrier while its workflow is running.
- * Keep actionable outcomes waking the parent, and preserve a terminal child as
- * the barrier for hosts that do not emit a separate workflow completion wake.
- */
-export function incrementalChildCompletionTriggersTurn(child, origin) {
-    if (child.workflowRunning && child.outcome === "completed")
-        return false;
-    return scheduledCompletionTriggersTurn(origin, child.outcome);
-}
-export function formatIncrementalChildCompletion(child) {
-    const statusText = child.outcome === "completed" ? "completed"
-        : child.outcome === "failed" ? "failed"
-            : child.outcome === "paused" ? "paused (needs attention)"
-                : "stopped";
-    const workflowStatus = child.workflowRunning ? "workflow still running" : "workflow finished";
-    return [
-        `Workflow child ${statusText}: **${child.childKey}**`,
-        `Workflow run: ${child.workflowRunId}`,
-        ...(child.childRunId ? [`Child run: ${child.childRunId}`] : []),
-        ...(child.outputReference ? [`Output: ${child.outputReference}`] : []),
-        ...(child.error ? [`Error: ${child.error}`] : []),
-        `Status: ${workflowStatus}`,
-    ].join("\n");
-}
-export function parseSubagentNotifyContent(content) {
-    const lines = content.split("\n");
-    const match = (lines[0] ?? "").match(/^(Background task|Detached foreground task) (completed|failed|paused|stopped): \*\*(.+?)\*\*(?:\s+(\([^)]*\)))?$/);
-    if (!match)
-        return undefined;
-    // Only the header slot before the blank separator can carry a receipt.
-    // Identical lines anywhere in model output remain preview text.
-    const receiptHeader = lines[1]?.startsWith("Workflow receipt: ") && lines[2] === "";
-    const workflowReceiptPath = receiptHeader ? lines[1].slice("Workflow receipt: ".length) : undefined;
-    let body = lines.slice(receiptHeader ? 3 : 2);
-    // Restore the schedule origin so a re-rendered notice keeps its attribution and
-    // does not fold the line into the result preview.
-    const scheduleMatch = (body[0] ?? "").match(/^Scheduled run from \*\*(.+?)\*\* \(schedule (.+?)\)\.$/);
-    let parsedScheduleOrigin;
-    if (scheduleMatch) {
-        const label = scheduleMatch[1];
-        const id = scheduleMatch[2];
-        parsedScheduleOrigin = { id, ...(label === id ? {} : { name: label }) };
-        body = body.slice(body[1]?.trim() === "" ? 2 : 1);
-    }
-    let sessionIndex = -1;
-    for (let i = body.length - 1; i >= 1; i--) {
-        if (body[i - 1]?.trim() === "" && /^(Session|Session file|Session share error):\s+/.test(body[i])) {
-            sessionIndex = i;
-            break;
-        }
-    }
-    const sessionLine = sessionIndex >= 0 ? body[sessionIndex] : undefined;
-    const handoffIndex = body.findIndex((line) => line.startsWith("Parallel handoff: "));
-    const workflowRunIndex = body.findIndex((line) => line.startsWith("Workflow run: "));
-    const childRunsIndex = body.findIndex((line) => line.startsWith("Child runs: "));
-    const reconciledIndex = body.findIndex((line) => line.startsWith("Reconciled detached child: "));
-    const watchdogIndex = body.findIndex((line) => line === WATCHDOG_BLOCKERS_HEADING);
-    const watchdogBlockers = watchdogIndex >= 0 ? parseWatchdogBlockerLines(body.slice(watchdogIndex + 1)) : [];
-    const metadataIndexes = [sessionIndex, handoffIndex, workflowRunIndex, childRunsIndex, reconciledIndex, watchdogIndex].filter((index) => index >= 0);
-    const firstMetadataIndex = metadataIndexes.length ? Math.min(...metadataIndexes) : body.length;
-    const resultEnd = firstMetadataIndex > 0 && body[firstMetadataIndex - 1]?.trim() === "" ? firstMetadataIndex - 1 : firstMetadataIndex;
-    const resultPreview = body.slice(0, resultEnd).join("\n").trim() || "(no output)";
-    const handoffPath = handoffIndex >= 0 ? body[handoffIndex].slice("Parallel handoff: ".length).trim() : undefined;
-    const workflowRunId = workflowRunIndex >= 0 ? body[workflowRunIndex].slice("Workflow run: ".length).trim() : undefined;
-    const childRuns = childRunsIndex >= 0
-        ? body[childRunsIndex].slice("Child runs: ".length).split(", ").map((part) => {
-            const trimmed = part.trim();
-            const statusMatch = trimmed.match(/^(.*?)(?: \(([^)]*)\))?$/);
-            const raw = statusMatch?.[1] ?? trimmed;
-            const separator = raw.indexOf("=");
-            return separator >= 0
-                ? { workflowKey: raw.slice(0, separator), runId: raw.slice(separator + 1), ...(statusMatch?.[2] ? { status: statusMatch[2] } : {}) }
-                : { runId: raw, ...(statusMatch?.[2] ? { status: statusMatch[2] } : {}) };
-        }).filter((child) => child.runId)
-        : undefined;
-    const reconciledFromDetachedChild = reconciledIndex >= 0 ? body[reconciledIndex].slice("Reconciled detached child: ".length).trim() : undefined;
-    let sessionLabel;
-    let sessionValue;
-    if (sessionLine) {
-        const separator = sessionLine.indexOf(":");
-        sessionLabel = sessionLine.slice(0, separator).toLowerCase();
-        sessionValue = sessionLine.slice(separator + 1).trim();
-    }
-    return {
-        agent: match[3],
-        status: match[2],
-        ...(match[1] === "Detached foreground task" ? { source: "foreground" } : {}),
-        ...(match[4] ? { taskInfo: match[4] } : {}),
-        ...(parsedScheduleOrigin ? { scheduleOrigin: parsedScheduleOrigin } : {}),
-        ...(workflowReceiptPath ? { workflowReceiptPath } : {}),
-        resultPreview,
-        ...(handoffPath ? { handoffPath } : {}),
-        ...(workflowRunId ? { workflowRunId } : {}),
-        ...(childRuns?.length ? { childRuns } : {}),
-        ...(reconciledFromDetachedChild ? { reconciledFromDetachedChild } : {}),
-        ...(watchdogBlockers.length ? { watchdogBlockers } : {}),
-        ...(sessionLabel && sessionValue ? { sessionLabel, sessionValue } : {}),
-    };
-}
-export function formatGroupedCompletion(details) {
-    const header = `Background tasks completed (${details.length}): ${details.map((d) => `**${d.agent}**${d.taskInfo ?? ""}`).join(", ")}`;
-    const blocks = [header, ""];
-    for (let index = 0; index < details.length; index++) {
-        const detail = details[index];
-        if (!detail)
-            continue;
-        const sessionLine = formatSessionLine(detail);
-        blocks.push(`${index + 1}. ${detail.agent}${detail.taskInfo ?? ""}${detail.scheduleOrigin ? ` — scheduled run from ${detail.scheduleOrigin.name ?? detail.scheduleOrigin.id} (schedule ${detail.scheduleOrigin.id})` : ""}`);
-        if (detail.workflowReceiptPath)
-            blocks.push(`Workflow receipt: ${detail.workflowReceiptPath}`);
-        blocks.push(formatResultPreview(detail));
-        blocks.push(...formatWatchdogBlockerLines(detail));
-        if (detail.handoffPath)
-            blocks.push(`Parallel handoff: ${detail.handoffPath}`);
-        blocks.push(...formatCorrelationLines(detail));
-        if (sessionLine)
-            blocks.push(sessionLine);
-        blocks.push("");
-    }
-    return blocks.join("\n").trimEnd();
-}
-const notificationDebug = debuglog("pi-subagents-notify");
-// Slice before sanitizing: diagnostic work and each identity are bounded even for
-// malformed result metadata. Never include task/output, paths, or error bodies.
-function traceIdentity(result) {
-    const identity = (value) => typeof value === "string"
-        ? value.slice(0, 128).replace(/[^a-zA-Z0-9_.:-]/g, "_") : undefined;
-    return { id: identity(result.id), runId: identity(result.runId), source: result.source === "foreground" ? "foreground" : "async" };
-}
-function traceNotification(reason, result) {
-    if (!notificationDebug.enabled)
-        return;
-    try {
-        notificationDebug("%s", JSON.stringify({ reason, ...(result ? traceIdentity(result) : {}) }));
-    }
-    catch {
-        // Diagnostics must never change delivery acknowledgement.
-    }
-}
-/** A fresh registry is injectable so tests and separately scoped runtimes stay isolated. */
-export function createCompletionSendRegistry(ttlMs = COMPLETION_SEND_TTL_MS, cap = COMPLETION_SEND_REGISTRY_CAP) {
-    const entries = new Map();
-    const prune = (now) => {
-        for (const [key, entry] of entries) {
-            if (entry.deliveredAt !== undefined && now - entry.deliveredAt > ttlMs)
-                entries.delete(key);
-        }
-        if (entries.size <= cap)
-            return;
-        for (const [key, entry] of entries) {
-            if (entries.size <= cap)
-                break;
-            if (entry.deliveredAt !== undefined)
-                entries.delete(key);
-        }
-    };
-    return {
-        claim(key, now) {
-            prune(now);
-            const existing = entries.get(key);
-            if (existing)
-                return { owned: false, outcome: existing.outcome };
-            let resolve;
-            const entry = {
-                outcome: new Promise((settle) => { resolve = settle; }),
-                resolve: (accepted) => resolve(accepted),
-            };
-            entries.set(key, entry);
-            return {
-                owned: true,
-                outcome: entry.outcome,
-                settle(accepted) {
-                    if (entries.get(key) !== entry)
-                        return;
-                    if (accepted) {
-                        entry.deliveredAt = now;
-                        prune(now);
-                    }
-                    else {
-                        entries.delete(key);
-                    }
-                    entry.resolve(accepted);
-                },
-            };
-        },
-    };
-}
-const completionSendRegistrySymbol = Symbol.for("pi-subagents.completion-send-registry.v1");
-const processGlobal = globalThis;
-const processCompletionSendRegistry = processGlobal[completionSendRegistrySymbol]
-    ?? (processGlobal[completionSendRegistrySymbol] = createCompletionSendRegistry());
-const queuedWakesSymbol = Symbol.for("pi-subagents.queued-completion-wakes.v2");
-const wakeGlobal = globalThis;
-const queuedWakes = wakeGlobal[queuedWakesSymbol] ?? (wakeGlobal[queuedWakesSymbol] = new WeakMap());
-function notifyRunDetails({ resultPreview: _preview, childOutputs, ...run }) {
-    return {
-        ...run,
-        ...(childOutputs ? { childOutputs: childOutputs.map(({ preview: _childPreview, previewTruncated: _truncated, previewUnavailableReason: _reason, ...child }) => child) } : {}),
-    };
-}
-const COMPLETION_ACTION = "Read the saved results above and resume the already-authorized parent task, or report completion. If approval is required, explicitly ask the user. Do not silently yield, rerun completed work, or infer new authorization.";
-const HELD_COMPLETION_ACTION = "The user stopped the parent turn. Report these results at the user's next prompt and do not resume the stopped task unless asked.";
-function sendCompletion(pi, items, unstartedWakes, unansweredCompletions, updateSettleSubscription) {
-    if (items.length === 0)
-        return true;
-    const details = items.map((item) => item.details);
-    const triggerTurn = items.some((item) => item.triggerTurn);
-    const formatted = details.length === 1 ? formatSingleCompletion(details[0]) : formatGroupedCompletion(details);
-    const held = pi.isHeld();
-    const content = triggerTurn ? `${formatted}\n\nParent action: ${held ? HELD_COMPLETION_ACTION : COMPLETION_ACTION}` : formatted;
-    const display = details.some((detail) => detail.source === "foreground" || detail.status !== "completed" || detail.scheduleOrigin !== undefined);
-    // A held notice starts no wake, so the silent-wake reminder must not later tell the model to resume the stopped task.
-    const tracked = triggerTurn && !held;
-    // Pi can queue an accepted wake behind the current turn or past agent_settled.
-    // Recorded before sending in case Pi starts the message synchronously.
-    if (tracked) {
-        unstartedWakes.push(content);
-        unansweredCompletions.set(content, { reminded: false });
-        updateSettleSubscription();
-    }
-    try {
-        const appended = pi.sendMessage({
-            customType: "subagent-notify",
-            content,
-            display,
-            // Pi does not send details to the model. Hosts match runs by id; the text previews stay in content only.
-            details: { runs: details.map(notifyRunDetails) },
-        }, { triggerTurn });
-        // An idle parent's appended notice gets no message_start; its wake prompt holds liveness instead.
-        if (appended && tracked)
-            unstartedWakes.splice(unstartedWakes.lastIndexOf(content), 1);
-        return true;
-    }
-    catch {
-        if (tracked) {
-            unstartedWakes.splice(unstartedWakes.lastIndexOf(content), 1);
-            unansweredCompletions.delete(content);
-            updateSettleSubscription();
-        }
-        return false;
-    }
-}
-function completionBatchKey(result) {
-    const sessionId = typeof result.sessionId === "string" ? result.sessionId.trim() : "";
-    if (sessionId)
-        return `session:${sessionId}`;
-    const cwd = typeof result.cwd === "string" ? result.cwd.trim() : "";
-    return cwd ? `cwd:${cwd}` : "unknown";
-}
-export function buildCompletionDetails(result) {
-    const agent = result.agent ?? "unknown";
-    const summary = typeof result.summary === "string" ? result.summary : "";
-    const stopped = result.stopped === true
-        || result.state === "stopped"
-        || (result.success !== true && result.exitCode !== 0 && isUnexplainedProcessSignal(result))
-        || result.results?.some((child) => child.stopped === true
-            || child.status === "stopped"
-            || (child.success !== true && child.exitCode !== 0 && isUnexplainedProcessSignal(child))) === true;
-    const paused = !stopped && !result.success && (result.exitCode === 0
-        || result.state === "paused"
-        || result.interrupted === true
-        || summary.startsWith("Paused after interrupt."));
-    const status = stopped ? "stopped" : paused ? "paused" : result.success ? "completed" : "failed";
-    const runningChildren = (result.mode === "workflow" || agent === "workflow")
-        ? result.results?.filter((child) => childStatus(child) === "running").length ?? 0 : 0;
-    const taskInfo = runningChildren > 0
-        ? ` (${status === "completed" ? "dispatch complete; " : ""}${runningChildren} ${runningChildren === 1 ? "child" : "children"} running or uncollected)`
-        : result.taskIndex !== undefined && result.totalTasks !== undefined
-            ? ` (${result.taskIndex + 1}/${result.totalTasks})`
-            : undefined;
-    const parallelHandoff = result.parallelHandoff && typeof result.parallelHandoff === "object"
-        ? result.parallelHandoff
-        : undefined;
-    const handoffPath = typeof parallelHandoff?.path === "string" ? parallelHandoff.path : undefined;
-    const receipt = result.workflowReceipt;
-    const receiptPath = receipt && typeof receipt === "object" && !Array.isArray(receipt)
-        ? receipt.path : undefined;
-    const workflowReceiptPath = typeof receiptPath === "string" && receiptPath ? receiptPath : undefined;
-    const rawRunId = typeof result.runId === "string" ? result.runId : typeof result.id === "string" ? result.id : undefined;
-    const workflowRunId = (result.mode === "workflow" || agent === "workflow") && rawRunId ? rawRunId : undefined;
-    const directChild = !workflowRunId && result.results?.length === 1 ? result.results[0] : undefined;
-    const directStructuredPreview = directChild
-        ? childInlinePreview(directChild).preview
-        : undefined;
-    const directSummary = summary.trim();
-    const directAgent = typeof directChild?.agent === "string" ? directChild.agent : agent;
-    const directSummaryBody = directAgent && summary.trimStart().startsWith(`${directAgent}:\n`)
-        ? summary.trimStart().slice(directAgent.length + 2)
-        : directSummary;
-    const directDegenerateSummary = directChild
-        && isDegenerateOutput(typeof directChild.output === "string" ? directChild.output : "")
-        && isDegenerateOutput(directSummaryBody)
-        && structuredOutputText(directChild.structuredOutput) !== undefined;
-    const directNoOutputSummary = directChild && (!directSummary
-        || directSummary === "(no output)"
-        || (directAgent && directSummary === `${directAgent}:\n(no output)`));
-    const outputPreview = directStructuredPreview && (directNoOutputSummary || directDegenerateSummary)
-        ? `Structured output:\n${directStructuredPreview}`
-        : capSummaryOutputs(summary, result.results);
-    // A failed child that produced output reports that output as its summary, so its error needs its own line.
-    const errorSources = status === "completed" ? [] : [
-        { agent: undefined, error: result.error },
-        ...(workflowRunId ? [] : result.results ?? []).filter((child) => child.success !== true).map((child) => ({ agent: child.agent, error: child.error })),
-    ];
-    const errorLines = [...new Set(errorSources.flatMap(({ agent: errorAgent, error }) => {
-            const line = firstErrorLine(error);
-            return line && !outputPreview.includes(line) ? [`Error${errorAgent && (result.results?.length ?? 0) > 1 ? ` (${errorAgent})` : ""}: ${line}`] : [];
-        }))];
-    const resultPreview = errorLines.length ? `${errorLines.join("\n")}\n\n${outputPreview}` : outputPreview;
-    const childRuns = result.results?.flatMap((child) => {
-        const runId = typeof child.runId === "string" && child.runId.trim() ? child.runId.trim() : undefined;
-        const workflowKey = typeof child.workflowKey === "string" && child.workflowKey.trim() ? child.workflowKey.trim() : undefined;
-        if (!runId && (!workflowRunId || !workflowKey))
-            return [];
-        return [{
-                runId: runId ?? "unavailable",
-                ...(workflowKey ? { workflowKey } : {}),
-                ...(typeof child.agent === "string" ? { agent: child.agent } : {}),
-                status: childStatus(child, workflowRunId ? result.state : undefined),
-            }];
-    }) ?? [];
-    const childOutputs = workflowRunId && result.results?.length
-        ? result.results.map((child) => {
-            const inline = childInlinePreview(child);
-            const workflowKey = typeof child.workflowKey === "string" && child.workflowKey.trim() ? child.workflowKey.trim() : undefined;
-            const runId = typeof child.runId === "string" && child.runId.trim() ? child.runId.trim() : undefined;
-            const savedOutputPath = childSavedOutputPath(child);
-            const outputArtifact = child.artifactOutputSaveFailed === true ? { status: "unavailable" } : retainedChildPath(child.artifactPaths?.outputPath);
-            const structuredOutput = child.stopped === true || child.timedOut === true
-                ? { status: "unavailable" }
-                : retainedChildPath(child.structuredOutputPath, child.structuredOutput !== undefined);
-            const status = childStatus(child, result.state);
-            const error = status === "completed" || status === "running" ? undefined : firstErrorLine(child.error);
-            return {
-                ...(workflowKey ? { workflowKey } : {}),
-                ...(runId ? { runId } : {}),
-                ...(typeof child.agent === "string" ? { agent: child.agent } : {}),
-                status,
-                ...(typeof child.revival === "string" && child.revival ? { revival: child.revival } : {}),
-                ...(savedOutputPath ? { savedOutputPath } : {}),
-                ...(outputArtifact.status === "verified" ? { outputArtifactPath: outputArtifact.path } : {}),
-                ...(structuredOutput.status === "verified" ? { structuredOutputPath: structuredOutput.path } : {}),
-                ...(outputArtifact.status === "error" ? { outputArtifactError: outputArtifact.error } : {}),
-                ...(structuredOutput.status === "error" ? { structuredOutputError: structuredOutput.error } : {}),
-                ...(error ? { error } : {}),
-                ...(inline.preview ? { preview: inline.preview } : { preview: "" }),
-                ...(inline.truncated ? { previewTruncated: true } : {}),
-                ...(inline.unavailableReason ? { previewUnavailableReason: inline.unavailableReason } : {}),
-            };
-        })
-        : undefined;
-    const reconciledFromDetachedChild = typeof result.reconciledFromDetachedChild === "string" ? result.reconciledFromDetachedChild : undefined;
-    const asyncDir = nonemptyPath(result.asyncDir);
-    const watchdogBlockers = [];
-    const watchdogConcerns = [];
-    const collectWatchdogFindings = (owner, progress) => {
-        for (const warning of progress?.warnings ?? []) {
-            if (warning.importance !== "high")
-                continue;
-            if (warning.severity === "blocker")
-                watchdogBlockers.push({ agent: owner, summary: warning.summary, addressed: warning.addressed, stalemate: warning.stalemate });
-            else
-                watchdogConcerns.push(`${owner}: ${warning.summary}\nEvidence: ${warning.evidence}\nRecommended action: ${warning.recommendedAction}`);
-        }
-    };
-    collectWatchdogFindings(agent, result.watchdog);
-    for (const child of result.results ?? [])
-        collectWatchdogFindings(typeof child.agent === "string" ? child.agent : agent, child.watchdog);
-    const session = result.shareUrl
-        ? { label: "Session", value: result.shareUrl }
-        : result.shareError
-            ? { label: "Session share error", value: result.shareError }
-            : result.sessionFile
-                ? { label: "Session file", value: result.sessionFile }
-                : undefined;
-    const rawOrigin = result.scheduleOrigin;
-    const scheduleOrigin = rawOrigin && typeof rawOrigin.id === "string"
-        ? { id: rawOrigin.id, ...(typeof rawOrigin.name === "string" ? { name: rawOrigin.name } : {}) }
-        : undefined;
-    return {
-        agent,
-        status,
-        ...(scheduleOrigin ? { scheduleOrigin } : {}),
-        ...(workflowReceiptPath ? { workflowReceiptPath } : {}),
-        ...(asyncDir ? { asyncDir } : {}),
-        ...(result.source ? { source: result.source } : {}),
-        ...(taskInfo ? { taskInfo } : {}),
-        resultPreview: watchdogConcerns.length ? `${resultPreview}\n\nHigh-importance watchdog concerns:\n${watchdogConcerns.map((warning) => `- ${warning}`).join("\n")}` : resultPreview,
-        ...(typeof result.durationMs === "number" ? { durationMs: result.durationMs } : {}),
-        ...(handoffPath ? { handoffPath } : {}),
-        ...(rawRunId ? { runId: rawRunId } : {}),
-        ...(workflowRunId ? { workflowRunId } : {}),
-        ...(childRuns.length ? { childRuns } : {}),
-        ...(childOutputs?.length ? { childOutputs } : {}),
-        ...(reconciledFromDetachedChild ? { reconciledFromDetachedChild } : {}),
-        ...(watchdogBlockers.length ? { watchdogBlockers } : {}),
-        ...(session ? { sessionLabel: session.label, sessionValue: session.value } : {}),
-    };
-}
-export default function registerSubagentNotify(pi, state, options = {}) {
-    const seen = new Map();
-    const pending = new Map();
-    const ttlMs = COMPLETION_SEND_TTL_MS;
-    const now = options.now ?? Date.now;
-    const sendRegistry = options.sendRegistry ?? processCompletionSendRegistry;
-    const batchConfig = resolveCompletionBatchConfig(options.batchConfig);
-    const batchers = new Map();
-    let unstartedWakes = [];
-    let unansweredCompletions = new Map();
-    let bound = false;
-    let disposed = false;
-    let unsubscribeSettle;
-    const ownsResult = options.ownership?.owns
-        ?? ((sessionId, completionOwnerId) => sessionId === state.currentSessionId
-            && typeof completionOwnerId === "string"
-            && completionOwnerId === state.completionOwnerId);
-    const settle = (items, accepted, reason) => {
-        for (const item of items) {
-            if (reason)
-                traceNotification(reason, item.trace);
-            pending.delete(item.key);
-            if (accepted)
-                markSeenWithTtl(seen, item.key, now(), ttlMs);
-            item.resolve(accepted);
-        }
-    };
-    const emit = (items) => {
-        const accepted = [];
-        const rejected = [];
-        for (const item of items) {
-            const owned = item.details.source === "foreground"
-                ? item.sessionId === state.currentSessionId
-                : ownsResult(item.sessionId, item.completionOwnerId);
-            if (!owned)
-                traceNotification(item.details.source === "foreground" ? "emit_foreground_session_mismatch" : "emit_not_owned", item.trace);
-            (owned ? accepted : rejected).push(item);
-        }
-        settle(rejected, false);
-        const claimed = [];
-        for (const item of accepted) {
-            const claim = sendRegistry.claim(item.key, now());
-            if (claim.owned) {
-                claimed.push({ item, claim });
-                continue;
-            }
-            traceNotification("send_joined", item.trace);
-            void claim.outcome.then((outcome) => settle([item], outcome, outcome ? undefined : "send_failed"));
-        }
-        const claimedItems = claimed.map(({ item }) => item);
-        const sent = sendCompletion(pi, claimedItems, unstartedWakes, unansweredCompletions, updateSettleSubscription);
-        for (const { claim } of claimed)
-            claim.settle?.(sent);
-        settle(claimedItems, sent, sent ? "send_accepted" : "send_failed");
-    };
-    const getBatcher = (result) => {
-        const key = completionBatchKey(result);
-        let batcher = batchers.get(key);
-        if (!batcher) {
-            batcher = createCompletionBatcher({
-                config: batchConfig,
-                emit,
-                ...(options.timers ? { timers: options.timers } : {}),
-                now,
-            });
-            batchers.set(key, batcher);
-        }
-        return batcher;
-    };
-    const deliver = (result) => {
-        if (disposed || typeof result.sessionId !== "string") {
-            traceNotification(disposed ? "disposed" : "missing_session", result);
-            return Promise.resolve(false);
-        }
-        if (result.source === "foreground") {
-            if (result.sessionId !== state.currentSessionId) {
-                traceNotification("foreground_session_mismatch", result);
-                return Promise.resolve(false);
-            }
-        }
-        else if (!ownsResult(result.sessionId, result.completionOwnerId)) {
-            traceNotification("not_owned", result);
-            return Promise.resolve(false);
-        }
-        if (result.intercomDelivered === true) {
-            traceNotification("intercom_delivered", result);
-            return Promise.resolve(true);
-        }
-        const key = buildCompletionKey(result, "notify");
-        const seenAt = seen.get(key);
-        if (seenAt !== undefined && now() - seenAt <= ttlMs) {
-            traceNotification("deduped_ttl", result);
-            return Promise.resolve(true);
-        }
-        if (seenAt !== undefined)
-            seen.delete(key);
-        const inFlight = pending.get(key);
-        if (inFlight) {
-            traceNotification("deduped_pending", result);
-            return inFlight;
-        }
-        const details = buildCompletionDetails(result);
-        let resolve;
-        const completion = new Promise((settleCompletion) => { resolve = settleCompletion; });
-        pending.set(key, completion);
-        const item = {
-            key,
-            details,
-            sessionId: result.sessionId,
-            completionOwnerId: result.completionOwnerId,
-            triggerTurn: result.triggerTurn !== false && scheduledCompletionTriggersTurn(result.scheduleOrigin, details.status),
-            resolve,
-        };
-        if (notificationDebug.enabled)
-            item.trace = traceIdentity(result);
-        if (details.source === "foreground") {
-            emit([item]);
-            return completion;
-        }
-        const batcher = getBatcher(result);
-        if (details.status !== "completed") {
-            batcher.flush();
-            emit([item]);
-            return completion;
-        }
-        if (batchConfig.enabled)
-            traceNotification("batch_deferred", item.trace);
-        batcher.push(item);
-        return completion;
-    };
-    const handleBeforeSettle = (event) => {
-        if (disposed || event.outcome !== "completed" || event.continue || event.context.pendingMessages.length)
-            return;
-        const messages = event.context.contextMessages;
-        const ignored = [];
-        for (const [content, notice] of unansweredCompletions) {
-            const index = messages.findLastIndex(message => message.role === "custom"
-                && message.customType === "subagent-notify" && message.content === content);
-            if (index === -1) {
-                // Removed by compaction or branch switch; never revive a stale notice.
-                unansweredCompletions.delete(content);
-                continue;
-            }
-            const acted = messages.slice(index + 1).some(message => message.role === "assistant"
-                && message.content.some(part => part.type === "toolCall"
-                    || (part.type === "text" && part.text.trim())));
-            if (acted) {
-                unansweredCompletions.delete(content);
-                continue;
-            }
-            ignored.push([content, notice]);
-        }
-        updateSettleSubscription();
-        if (!ignored.length)
-            return;
-        const fresh = ignored.filter(([, notice]) => !notice.reminded);
-        if (fresh.length) {
-            for (const [, notice] of fresh)
-                notice.reminded = true;
-            return {
-                entries: [...event.entries, {
-                        type: "custom_message", customType: "subagent-completion-unanswered", display: true,
-                        content: "Completion wake ended silently. See the subagent completion notices above. " + COMPLETION_ACTION,
-                    }],
-                continue: true,
-            };
-        }
-        for (const [content] of ignored)
-            unansweredCompletions.delete(content);
-        updateSettleSubscription();
-        return {
-            entries: [...event.entries, {
-                    type: "custom_message", customType: "subagent-completion-unhandled", display: true,
-                    content: "UNHANDLED: no response to the subagent completion notices above. Reminder budget exhausted; results remain saved. No work was rerun or approval inferred.",
-                }],
-        };
-    };
-    const updateSettleSubscription = () => {
-        if (!disposed && unansweredCompletions.size && !unsubscribeSettle)
-            unsubscribeSettle = pi.on?.("agent_before_settle", handleBeforeSettle);
-        if (disposed || !unansweredCompletions.size) {
-            unsubscribeSettle?.();
-            unsubscribeSettle = undefined;
-        }
-    };
-    const unsubscribeAsync = pi.events.on(SUBAGENT_ASYNC_COMPLETE_EVENT, (data) => {
-        if (data.awaitedByWorkflow === true)
-            return;
-        void deliver(data);
-    });
-    const unsubscribeForeground = pi.events.on(SUBAGENT_FOREGROUND_COMPLETE_EVENT, (data) => {
-        void deliver(data);
-    });
-    return {
-        deliver,
-        hasPendingDelivery: () => pending.size > 0 || unstartedWakes.length > 0,
-        messageStarted(message) {
-            if (message.role !== "custom" || message.customType !== "subagent-notify")
-                return;
-            const index = unstartedWakes.indexOf(message.content);
-            if (index !== -1)
-                unstartedWakes.splice(index, 1);
-        },
-        bindSession(sessionManager) {
-            if (disposed)
-                return;
-            const sessionId = sessionManager.getSessionId(); // UUID, not state.currentSessionId's possible file path.
-            const retained = queuedWakes.get(sessionManager);
-            const wakes = retained?.sessionId === sessionId ? retained.wakes : [];
-            const unanswered = retained?.sessionId === sessionId && retained.unansweredCompletions instanceof Map
-                ? retained.unansweredCompletions
-                : new Map(wakes.map(content => [content, { reminded: false }]));
-            // Before the first bind, local wakes belong to this session; after it, to the previous one.
-            if (!bound) {
-                wakes.push(...unstartedWakes);
-                for (const [content, notice] of unansweredCompletions)
-                    unanswered.set(content, notice);
-            }
-            bound = true;
-            unstartedWakes = wakes;
-            unansweredCompletions = unanswered;
-            queuedWakes.set(sessionManager, { sessionId, wakes, unansweredCompletions });
-            updateSettleSubscription();
-        },
-        sessionShutdown(reason) {
-            if (reason !== "reload") {
-                unstartedWakes.length = 0;
-                unansweredCompletions.clear();
-            }
-            unsubscribeSettle?.();
-            unsubscribeSettle = undefined;
-        },
-        flush() {
-            for (const batcher of batchers.values())
-                batcher.flush();
-        },
-        dispose() {
-            if (disposed)
-                return;
-            disposed = true;
-            updateSettleSubscription();
-            for (const batcher of batchers.values())
-                settle(batcher.dispose(), false, "dispose_pending");
-            batchers.clear();
-            // Retained state belongs to the session manager; disposal must not erase it on reload.
-            unansweredCompletions = new Map();
-            for (const unsubscribe of [unsubscribeAsync, unsubscribeForeground]) {
-                try {
-                    unsubscribe?.();
-                }
-                catch {
-                    // The runtime is already shutting down; pending records stay on disk.
-                }
-            }
-        },
-    };
-}
-//# sourceMappingURL=notify.js.map