larkin 0.4.18 → 0.4.19

package/dist/runtime/pi-inline-extensions.mjs

@@ -1,6 +1,7 @@
 import { pathToFileURL } from "node:url";
 import bashTimeoutExtension from "./pi-bash-timeout-extension.mjs";
 import { bundledPiSubagentExtensionPath } from "./pi-subagent-injection.mjs";
+import piSubagentRecordWatchdog from "./pi-subagent-record-watchdog.mjs";
 /**
  * Load the prebuilt, patched subagent bundle shipped in dist/ rather than the
  * package-manager copy. Standalone binaries additionally load the patched
@@ -30,7 +31,11 @@ const bundledSubagentsExtension = async (pi) => {
     else
         await extension.factory(pi);
 };
+// Watchdog must register session_shutdown before the bundled subagent extension
+// so the final sweep can still read AgentManager.getRecord and bridge consumed
+// terminals before manager teardown.
 export const BUILTIN_PI_EXTENSION_FACTORIES = Object.freeze([
+    piSubagentRecordWatchdog,
     bundledSubagentsExtension,
     bashTimeoutExtension,
 ]);

package/dist/runtime/pi-subagent-ledger.cjs

@@ -0,0 +1,632 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PI_SUBAGENT_TERMINAL_NOTIFICATION_GRACE_MS = exports.PI_SUBAGENT_SESSION_OWNER_ENV = exports.PI_SUBAGENT_LEDGER_VERSION = exports.PI_SUBAGENT_RECORD_DIRNAME = exports.PI_SUBAGENT_LEDGER_FILENAME = void 0;
+exports.emptyDispatchedSubagentLedger = emptyDispatchedSubagentLedger;
+exports.isTerminalDispatchedSubagentStatus = isTerminalDispatchedSubagentStatus;
+exports.taskIdsFromCompletionKey = taskIdsFromCompletionKey;
+exports.getDispatchedSubagent = getDispatchedSubagent;
+exports.noteDispatchedSubagent = noteDispatchedSubagent;
+exports.noteDispatchedSubagentTerminal = noteDispatchedSubagentTerminal;
+exports.noteDispatchedSubagentActivity = noteDispatchedSubagentActivity;
+exports.markDispatchedSubagentOrphaned = markDispatchedSubagentOrphaned;
+exports.reconcileDispatchedSubagents = reconcileDispatchedSubagents;
+exports.noteDispatchedSubagentWakeAcknowledged = noteDispatchedSubagentWakeAcknowledged;
+exports.undeliveredTerminalWakeKeys = undeliveredTerminalWakeKeys;
+exports.noteConsumedDispatchedSubagent = noteConsumedDispatchedSubagent;
+exports.isTerminalPiSubagentRecord = isTerminalPiSubagentRecord;
+exports.isConsumedTerminalPiSubagentRecord = isConsumedTerminalPiSubagentRecord;
+exports.ledgerStatusFromPiSubagentRecord = ledgerStatusFromPiSubagentRecord;
+exports.readPersistedPiSubagentTerminal = readPersistedPiSubagentTerminal;
+exports.readConsumedPiSubagentTerminal = readConsumedPiSubagentTerminal;
+exports.writePersistedPiSubagentTerminal = writePersistedPiSubagentTerminal;
+exports.writeConsumedPiSubagentTerminal = writeConsumedPiSubagentTerminal;
+exports.retirePiSubagentRecord = retirePiSubagentRecord;
+exports.retireConsumedPiSubagentRecord = retireConsumedPiSubagentRecord;
+exports.probePiSubagentRecord = probePiSubagentRecord;
+exports.probePiSubagentOutputRecord = probePiSubagentOutputRecord;
+exports.effectivePiStateDir = effectivePiStateDir;
+exports.dispatchedSubagentRecordDir = dispatchedSubagentRecordDir;
+exports.dispatchedSubagentRecordFile = dispatchedSubagentRecordFile;
+exports.writeDispatchedSubagentRecordFile = writeDispatchedSubagentRecordFile;
+exports.sweepAbsentPiSubagentRecordFiles = sweepAbsentPiSubagentRecordFiles;
+exports.ledgerFilePath = ledgerFilePath;
+exports.readDispatchedSubagentLedger = readDispatchedSubagentLedger;
+exports.writeDispatchedSubagentLedger = writeDispatchedSubagentLedger;
+exports.extractBackgroundPiSubagentDispatch = extractBackgroundPiSubagentDispatch;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_crypto_1 = __importDefault(require("node:crypto"));
+exports.PI_SUBAGENT_LEDGER_FILENAME = "pi-subagent-ledger.json";
+exports.PI_SUBAGENT_RECORD_DIRNAME = "pi-subagent-records";
+exports.PI_SUBAGENT_LEDGER_VERSION = 1;
+exports.PI_SUBAGENT_SESSION_OWNER_ENV = "LARKIN_PI_SESSION_OWNER";
+exports.PI_SUBAGENT_TERMINAL_NOTIFICATION_GRACE_MS = 30_000;
+const TERMINAL_STATUSES = new Set([
+    "completed",
+    "failed",
+    "cancelled",
+    "timed_out",
+    "orphaned",
+]);
+const MAX_LEDGER_TASKS = 2048;
+function emptyDispatchedSubagentLedger() {
+    return { version: exports.PI_SUBAGENT_LEDGER_VERSION, tasks: [] };
+}
+function isTerminalDispatchedSubagentStatus(status) {
+    return TERMINAL_STATUSES.has(status);
+}
+function taskIdsFromCompletionKey(completionKey) {
+    return completionKey.split("|").map((part) => part.trim()).filter(Boolean);
+}
+function getDispatchedSubagent(ledger, taskId) {
+    return ledger.tasks.find((task) => task.taskId === taskId) ?? null;
+}
+function noteDispatchedSubagent(ledger, input) {
+    const now = input.now ?? Date.now();
+    const existing = getDispatchedSubagent(ledger, input.taskId);
+    if (existing) {
+        if (isTerminalDispatchedSubagentStatus(existing.status))
+            return ledger;
+        return replaceTask(ledger, {
+            ...existing,
+            lastActivityAt: now,
+            ...(input.outputFile ? { outputFile: input.outputFile } : {}),
+            ...(input.recordFile ? { recordFile: input.recordFile } : {}),
+        });
+    }
+    return appendTask(ledger, {
+        taskId: input.taskId,
+        status: "dispatched",
+        dispatchedAt: now,
+        lastActivityAt: now,
+        ...(input.outputFile ? { outputFile: input.outputFile } : {}),
+        ...(input.recordFile ? { recordFile: input.recordFile } : {}),
+    });
+}
+function noteDispatchedSubagentTerminal(ledger, input) {
+    const now = input.now ?? Date.now();
+    const status = input.status ?? "completed";
+    const existing = getDispatchedSubagent(ledger, input.taskId);
+    if (existing && isTerminalDispatchedSubagentStatus(existing.status)) {
+        return replaceTask(ledger, {
+            ...existing,
+            lastActivityAt: now,
+            ...(input.outputFile && !existing.outputFile ? { outputFile: input.outputFile } : {}),
+        });
+    }
+    const next = {
+        taskId: input.taskId,
+        status,
+        dispatchedAt: existing?.dispatchedAt ?? now,
+        lastActivityAt: now,
+        wakeState: existing?.wakeState ?? "pending",
+        ...(existing?.outputFile || input.outputFile
+            ? { outputFile: input.outputFile ?? existing?.outputFile } : {}),
+        ...(existing?.recordFile ? { recordFile: existing.recordFile } : {}),
+        ...(input.reason ? { reason: input.reason } : existing?.reason ? { reason: existing.reason } : {}),
+        ...(input.wakeKey ? { wakeKey: input.wakeKey } : existing?.wakeKey ? { wakeKey: existing.wakeKey } : {}),
+    };
+    return existing ? replaceTask(ledger, next) : appendTask(ledger, next);
+}
+function noteDispatchedSubagentActivity(ledger, input) {
+    const existing = getDispatchedSubagent(ledger, input.taskId);
+    if (!existing || isTerminalDispatchedSubagentStatus(existing.status))
+        return ledger;
+    return replaceTask(ledger, {
+        ...existing,
+        lastActivityAt: input.now ?? Date.now(),
+        ...(input.outputFile ? { outputFile: input.outputFile } : {}),
+    });
+}
+function markDispatchedSubagentOrphaned(ledger, input) {
+    const existing = getDispatchedSubagent(ledger, input.taskId);
+    if (existing && isTerminalDispatchedSubagentStatus(existing.status)) {
+        return { ledger, record: null };
+    }
+    const now = input.now ?? Date.now();
+    const record = {
+        taskId: input.taskId,
+        status: "orphaned",
+        dispatchedAt: existing?.dispatchedAt ?? now,
+        lastActivityAt: existing?.lastActivityAt ?? now,
+        reason: input.reason,
+        wakeKey: input.taskId,
+        wakeState: "pending",
+        ...(input.outputFile || existing?.outputFile
+            ? { outputFile: input.outputFile ?? existing?.outputFile } : {}),
+        ...(existing?.recordFile ? { recordFile: existing.recordFile } : {}),
+    };
+    return {
+        ledger: existing ? replaceTask(ledger, record) : appendTask(ledger, record),
+        record,
+    };
+}
+function reconcileDispatchedSubagents(ledger, input = {}) {
+    const now = input.now ?? Date.now();
+    const orphaned = [];
+    const terminals = [];
+    let next = ledger;
+    for (const task of ledger.tasks) {
+        if (isTerminalDispatchedSubagentStatus(task.status))
+            continue;
+        const current = getDispatchedSubagent(next, task.taskId) ?? task;
+        const refreshed = refreshActivityFromOutput(current, now);
+        if (refreshed.lastActivityAt !== current.lastActivityAt) {
+            next = noteDispatchedSubagentActivity(next, {
+                taskId: current.taskId,
+                outputFile: refreshed.outputFile,
+                now: refreshed.lastActivityAt,
+            });
+        }
+        const probed = getDispatchedSubagent(next, current.taskId) ?? refreshed;
+        const probedPresence = input.probe?.(probed);
+        const presence = input.forceMissing
+            ? (probedPresence === "consumed" || probedPresence === "terminal" ? probedPresence : "absent")
+            : (probedPresence ?? "present");
+        if (presence === "consumed") {
+            next = noteConsumedDispatchedSubagent(next, {
+                taskId: current.taskId,
+                status: readConsumedPiSubagentTerminal(current.recordFile)?.status ?? "completed",
+                outputFile: current.outputFile,
+                now,
+            });
+            retireConsumedPiSubagentRecord(current.recordFile);
+            continue;
+        }
+        if (presence === "terminal") {
+            if (!input.forceMissing && !hasTerminalNotificationGraceElapsed(current.recordFile, now))
+                continue;
+            next = noteDispatchedSubagentTerminal(next, {
+                taskId: current.taskId,
+                status: readPersistedPiSubagentTerminal(current.recordFile)?.status ?? "completed",
+                outputFile: current.outputFile,
+                wakeKey: current.taskId,
+                now,
+            });
+            const advanced = getDispatchedSubagent(next, current.taskId);
+            if (advanced)
+                terminals.push(advanced);
+            continue;
+        }
+        if (presence !== "absent")
+            continue;
+        const marked = markDispatchedSubagentOrphaned(next, {
+            taskId: current.taskId,
+            reason: input.missingReason ?? (input.forceMissing ? "pi session gone" : "pi record missing"),
+            outputFile: current.outputFile,
+            now,
+        });
+        next = marked.ledger;
+        if (marked.record)
+            orphaned.push(marked.record);
+    }
+    return { ledger: next, orphaned, terminals };
+}
+function noteDispatchedSubagentWakeAcknowledged(ledger, input) {
+    const now = input.now ?? Date.now();
+    let next = ledger;
+    for (const taskId of taskIdsFromCompletionKey(input.completionKey)) {
+        const existing = getDispatchedSubagent(next, taskId);
+        if (!existing || !isTerminalDispatchedSubagentStatus(existing.status))
+            continue;
+        if (existing.wakeState === "acknowledged")
+            continue;
+        next = replaceTask(next, { ...existing, wakeState: "acknowledged", notifiedAt: now });
+    }
+    return next;
+}
+function undeliveredTerminalWakeKeys(ledger) {
+    const seen = new Set();
+    const keys = [];
+    for (const task of ledger.tasks) {
+        if (!needsTerminalWake(task))
+            continue;
+        const key = task.wakeKey ?? task.taskId;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        keys.push(key);
+    }
+    return keys;
+}
+function noteConsumedDispatchedSubagent(ledger, input) {
+    const now = input.now ?? Date.now();
+    const next = noteDispatchedSubagentTerminal(ledger, {
+        taskId: input.taskId,
+        status: input.status ?? "completed",
+        outputFile: input.outputFile,
+        wakeKey: input.taskId,
+        now,
+    });
+    return noteDispatchedSubagentWakeAcknowledged(next, { completionKey: input.taskId, now });
+}
+function isTerminalPiSubagentRecord(record) {
+    if (!record || typeof record !== "object")
+        return false;
+    const status = record.status;
+    return typeof status === "string" && status.length > 0
+        && status !== "running" && status !== "queued";
+}
+function isConsumedTerminalPiSubagentRecord(record) {
+    if (!isTerminalPiSubagentRecord(record))
+        return false;
+    return record.resultConsumed === true;
+}
+function ledgerStatusFromPiSubagentRecord(record) {
+    const status = typeof record === "object" && record && "status" in record
+        ? String(record.status || "").trim().toLowerCase()
+        : "";
+    if (status === "error")
+        return "failed";
+    if (status === "aborted")
+        return "timed_out";
+    if (status === "stopped")
+        return "cancelled";
+    if (status === "steered")
+        return "timed_out";
+    return "completed";
+}
+function readPersistedPiSubagentTerminal(file) {
+    return readPiSubagentTerminalFile(file, false);
+}
+function readConsumedPiSubagentTerminal(file) {
+    return readPiSubagentTerminalFile(file, true);
+}
+function writePersistedPiSubagentTerminal(file, input, options) {
+    writePiSubagentTerminalFile(file, input, options?.resultConsumed === true);
+}
+function writeConsumedPiSubagentTerminal(file, input) {
+    writePersistedPiSubagentTerminal(file, input, { resultConsumed: true });
+}
+function retirePiSubagentRecord(file) {
+    if (!file)
+        return false;
+    try {
+        const stat = node_fs_1.default.lstatSync(file);
+        if (stat.isSymbolicLink() || !stat.isFile())
+            return false;
+        node_fs_1.default.unlinkSync(file);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function retireConsumedPiSubagentRecord(file) {
+    if (!file || !readConsumedPiSubagentTerminal(file))
+        return false;
+    return retirePiSubagentRecord(file);
+}
+/** Probe the Pi task record sidecar. A leftover transcript is never presence. */
+function probePiSubagentRecord(record) {
+    if (!record.recordFile)
+        return "absent";
+    try {
+        const stat = node_fs_1.default.lstatSync(record.recordFile);
+        if (stat.isSymbolicLink() || !stat.isFile())
+            return "absent";
+        if (readConsumedPiSubagentTerminal(record.recordFile))
+            return "consumed";
+        if (readPersistedPiSubagentTerminal(record.recordFile))
+            return "terminal";
+        return "present";
+    }
+    catch {
+        return "absent";
+    }
+}
+/** @deprecated Use probePiSubagentRecord. Transcript leftovers are not presence. */
+function probePiSubagentOutputRecord(record) {
+    return probePiSubagentRecord(record);
+}
+/** Same implicit root the Pi adapter uses when `stateDir` is omitted. */
+function effectivePiStateDir(input) {
+    return input.stateDir ?? node_path_1.default.join(input.workspaceDir, ".larkin");
+}
+function dispatchedSubagentRecordDir(stateDir) {
+    return node_path_1.default.join(stateDir, exports.PI_SUBAGENT_RECORD_DIRNAME);
+}
+function dispatchedSubagentRecordFile(stateDir, taskId) {
+    return node_path_1.default.join(dispatchedSubagentRecordDir(stateDir), taskId);
+}
+function writeDispatchedSubagentRecordFile(stateDir, taskId, owner) {
+    if (!stateDir || !taskId)
+        return undefined;
+    const dir = dispatchedSubagentRecordDir(stateDir);
+    node_fs_1.default.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    const file = dispatchedSubagentRecordFile(stateDir, taskId);
+    const existing = (() => { try {
+        return node_fs_1.default.lstatSync(file);
+    }
+    catch {
+        return null;
+    } })();
+    if (existing?.isSymbolicLink())
+        throw new Error("subagent record file must not be a symlink");
+    const normalizedOwner = typeof owner === "string" && owner.trim() ? owner.trim() : undefined;
+    node_fs_1.default.writeFileSync(file, `${JSON.stringify({
+        taskId,
+        ...(normalizedOwner ? { owner: normalizedOwner } : {}),
+    })}\n`, { mode: 0o600 });
+    node_fs_1.default.chmodSync(file, 0o600);
+    return file;
+}
+function sweepAbsentPiSubagentRecordFiles(recordDir, getRecord, options) {
+    let names;
+    try {
+        names = node_fs_1.default.readdirSync(recordDir);
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+    const removed = [];
+    for (const name of names) {
+        if (!name || name.startsWith("."))
+            continue;
+        const file = node_path_1.default.join(recordDir, name);
+        try {
+            const stat = node_fs_1.default.lstatSync(file);
+            if (stat.isSymbolicLink() || !stat.isFile())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        const owner = typeof options?.owner === "string" && options.owner.trim() ? options.owner.trim() : undefined;
+        if (owner && readPiSubagentRecordOwner(file) !== owner)
+            continue;
+        const record = getRecord(name);
+        if (isTerminalPiSubagentRecord(record)) {
+            try {
+                // Unchanged terminal payloads must not be rewritten: mtime is the
+                // 30s lost-notification grace clock while Pi still holds the record.
+                writePersistedPiSubagentTerminal(file, {
+                    taskId: name,
+                    status: ledgerStatusFromPiSubagentRecord(record),
+                }, { resultConsumed: isConsumedTerminalPiSubagentRecord(record) });
+            }
+            catch {
+                // Keep the sidecar; the next sweep retries the terminal bridge.
+            }
+            continue;
+        }
+        if (record != null)
+            continue;
+        if (readPersistedPiSubagentTerminal(file))
+            continue;
+        try {
+            node_fs_1.default.unlinkSync(file);
+            removed.push(name);
+        }
+        catch {
+            // Best-effort: the next sweep retries.
+        }
+    }
+    return removed;
+}
+function ledgerFilePath(stateDir) {
+    return stateDir ? node_path_1.default.join(stateDir, exports.PI_SUBAGENT_LEDGER_FILENAME) : null;
+}
+function readDispatchedSubagentLedger(file) {
+    if (!file)
+        return emptyDispatchedSubagentLedger();
+    try {
+        const stat = node_fs_1.default.lstatSync(file);
+        if (stat.isSymbolicLink() || !stat.isFile())
+            throw new Error("subagent ledger is not a regular file");
+        const parsed = JSON.parse(node_fs_1.default.readFileSync(file, "utf8"));
+        return normalizeLedger(parsed);
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return emptyDispatchedSubagentLedger();
+        throw error;
+    }
+}
+function writeDispatchedSubagentLedger(file, ledger) {
+    if (!file)
+        return;
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(file), { recursive: true, mode: 0o700 });
+    const existing = (() => { try {
+        return node_fs_1.default.lstatSync(file);
+    }
+    catch {
+        return null;
+    } })();
+    if (existing?.isSymbolicLink())
+        throw new Error("subagent ledger must not be a symlink");
+    const temporary = node_path_1.default.join(node_path_1.default.dirname(file), `.${node_path_1.default.basename(file)}.${process.pid}.${node_crypto_1.default.randomUUID()}.tmp`);
+    node_fs_1.default.writeFileSync(temporary, `${JSON.stringify(normalizeLedger(ledger), null, 2)}\n`, { mode: 0o600 });
+    node_fs_1.default.renameSync(temporary, file);
+    node_fs_1.default.chmodSync(file, 0o600);
+}
+function extractBackgroundPiSubagentDispatch(event) {
+    if (event.isError === true)
+        return null;
+    if (String(event.toolName || "") !== "Agent")
+        return null;
+    const args = asRecord(event.args);
+    const resultText = collectResultText(event.result);
+    const details = asRecord(asRecord(event.result)?.details);
+    const backgroundByArgs = args?.run_in_background === true;
+    const backgroundByResult = /Agent (?:started|queued) in background/i.test(resultText);
+    if (!backgroundByArgs && !backgroundByResult)
+        return null;
+    const taskId = firstNonEmpty(stringValue(details?.agentId), stringValue(details?.id), matchCapture(resultText, /Agent ID:\s*(\S+)/i));
+    if (!taskId)
+        return null;
+    const outputFile = firstNonEmpty(stringValue(details?.outputFile), matchCapture(resultText, /Output file:\s*(.+)/i));
+    return outputFile ? { taskId, outputFile } : { taskId };
+}
+function readPiSubagentTerminalFile(file, requireConsumed) {
+    if (!file)
+        return null;
+    try {
+        const stat = node_fs_1.default.lstatSync(file);
+        if (stat.isSymbolicLink() || !stat.isFile())
+            return null;
+        const parsed = JSON.parse(node_fs_1.default.readFileSync(file, "utf8"));
+        if (!parsed || typeof parsed !== "object")
+            return null;
+        if (requireConsumed && parsed.resultConsumed !== true && parsed.consumed !== true)
+            return null;
+        if (typeof parsed.taskId !== "string" || parsed.taskId.length === 0)
+            return null;
+        if (parsed.status !== "completed" && parsed.status !== "failed"
+            && parsed.status !== "cancelled" && parsed.status !== "timed_out") {
+            return null;
+        }
+        return { taskId: parsed.taskId, status: parsed.status };
+    }
+    catch {
+        return null;
+    }
+}
+function writePiSubagentTerminalFile(file, input, resultConsumed) {
+    const existing = (() => { try {
+        return node_fs_1.default.lstatSync(file);
+    }
+    catch {
+        return null;
+    } })();
+    if (existing?.isSymbolicLink())
+        throw new Error("subagent record file must not be a symlink");
+    const owner = readPiSubagentRecordOwner(file);
+    const payload = `${JSON.stringify({
+        taskId: input.taskId,
+        ...(resultConsumed ? { resultConsumed: true } : {}),
+        status: input.status,
+        ...(owner ? { owner } : {}),
+    })}\n`;
+    if (existing?.isFile()) {
+        try {
+            if (node_fs_1.default.readFileSync(file, "utf8") === payload)
+                return;
+        }
+        catch {
+            // Rewrite if the existing sidecar cannot be compared.
+        }
+    }
+    node_fs_1.default.writeFileSync(file, payload, { mode: 0o600 });
+    node_fs_1.default.chmodSync(file, 0o600);
+}
+function hasTerminalNotificationGraceElapsed(file, now) {
+    if (!file)
+        return true;
+    try {
+        const mtimeMs = node_fs_1.default.statSync(file).mtimeMs;
+        return Number.isFinite(mtimeMs) && now - mtimeMs >= exports.PI_SUBAGENT_TERMINAL_NOTIFICATION_GRACE_MS;
+    }
+    catch {
+        return true;
+    }
+}
+function refreshActivityFromOutput(task, now) {
+    if (!task.outputFile)
+        return task;
+    try {
+        const mtimeMs = node_fs_1.default.statSync(task.outputFile).mtimeMs;
+        if (Number.isFinite(mtimeMs) && mtimeMs > task.lastActivityAt) {
+            return { ...task, lastActivityAt: Math.min(now, Math.floor(mtimeMs)) };
+        }
+    }
+    catch {
+        // Missing output files are handled by the probe, not activity refresh.
+    }
+    return task;
+}
+function normalizeLedger(value) {
+    const tasks = Array.isArray(value?.tasks) ? value.tasks.filter(isPersistedTask) : [];
+    return { version: exports.PI_SUBAGENT_LEDGER_VERSION, tasks: capLedgerTasks(tasks) };
+}
+function isAcknowledgedTerminalTask(task) {
+    return isTerminalDispatchedSubagentStatus(task.status) && task.wakeState === "acknowledged";
+}
+function capLedgerTasks(tasks) {
+    if (tasks.length <= MAX_LEDGER_TASKS)
+        return tasks;
+    const overflow = tasks.length - MAX_LEDGER_TASKS;
+    const evict = new Set();
+    for (let index = 0; index < tasks.length && evict.size < overflow; index += 1) {
+        if (isAcknowledgedTerminalTask(tasks[index]))
+            evict.add(index);
+    }
+    if (evict.size === 0)
+        return tasks;
+    return tasks.filter((_, index) => !evict.has(index));
+}
+function readPiSubagentRecordOwner(file) {
+    try {
+        const parsed = JSON.parse(node_fs_1.default.readFileSync(file, "utf8"));
+        return typeof parsed?.owner === "string" && parsed.owner.trim() ? parsed.owner.trim() : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function isPersistedTask(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const record = value;
+    return typeof record.taskId === "string" && record.taskId.length > 0
+        && typeof record.status === "string"
+        && ["dispatched", "completed", "failed", "cancelled", "timed_out", "orphaned"].includes(record.status)
+        && Number.isFinite(record.dispatchedAt)
+        && Number.isFinite(record.lastActivityAt)
+        && (record.recordFile === undefined || (typeof record.recordFile === "string" && record.recordFile.length > 0))
+        && (record.wakeState === undefined || record.wakeState === "pending" || record.wakeState === "acknowledged");
+}
+function needsTerminalWake(task) {
+    if (!isTerminalDispatchedSubagentStatus(task.status))
+        return false;
+    if (task.wakeState === "acknowledged")
+        return false;
+    if (task.wakeState === "pending")
+        return true;
+    return task.notifiedAt == null;
+}
+function appendTask(ledger, record) {
+    return normalizeLedger({ version: exports.PI_SUBAGENT_LEDGER_VERSION, tasks: [...ledger.tasks, record] });
+}
+function replaceTask(ledger, record) {
+    return {
+        version: exports.PI_SUBAGENT_LEDGER_VERSION,
+        tasks: ledger.tasks.map((task) => task.taskId === record.taskId ? record : task),
+    };
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function stringValue(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function firstNonEmpty(...values) {
+    return values.find((value) => Boolean(value)) ?? null;
+}
+function matchCapture(text, pattern) {
+    const match = pattern.exec(text);
+    return match?.[1] ? match[1].trim() : null;
+}
+function collectResultText(result) {
+    if (typeof result === "string")
+        return result;
+    const record = asRecord(result);
+    if (!record)
+        return "";
+    if (typeof record.content === "string")
+        return record.content;
+    if (Array.isArray(record.content)) {
+        return record.content.map((part) => {
+            if (typeof part === "string")
+                return part;
+            const item = asRecord(part);
+            return typeof item?.text === "string" ? item.text : "";
+        }).join("\n");
+    }
+    return typeof record.text === "string" ? record.text : "";
+}