pi-subagents 0.69.0 → 0.70.0

package/src/runs/shared/usage-reconciliation.d.ts

@@ -0,0 +1,9 @@
+import type { Usage } from "../../shared/types.ts";
+type UsageMessage = {
+    role?: unknown;
+    timestamp?: unknown;
+    usage?: object;
+};
+export declare function reconcileAttemptUsage(live: Usage, messages: readonly UsageMessage[], baseline: number): Usage;
+export {};
+//# sourceMappingURL=usage-reconciliation.d.ts.map

package/src/runs/shared/usage-reconciliation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-reconciliation.d.ts","sourceRoot":"","sources":["../../../../src/runs/shared/usage-reconciliation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD,KAAK,YAAY,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAyC5E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,YAAY,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,CA6B7G"}

package/src/runs/shared/usage-reconciliation.js

@@ -0,0 +1,72 @@
+const usageFields = ["input", "output", "cacheRead", "cacheWrite", "cost"];
+const aliases = {
+    input: ["input", "inputTokens"],
+    output: ["output", "outputTokens"],
+    cacheRead: ["cacheRead", "cacheReadTokens"],
+    cacheWrite: ["cacheWrite", "cacheWriteTokens"],
+};
+function validNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : undefined;
+}
+function fieldValue(usage, field) {
+    if (!usage)
+        return undefined;
+    const values = usage;
+    if (field === "cost") {
+        const direct = validNumber(values.cost);
+        if (direct !== undefined)
+            return direct;
+        const cost = values.cost;
+        return cost && typeof cost === "object" && !Array.isArray(cost)
+            ? validNumber(cost.total)
+            : undefined;
+    }
+    for (const name of aliases[field]) {
+        const value = validNumber(values[name]);
+        if (value !== undefined)
+            return value;
+    }
+    return undefined;
+}
+function validTimestamp(message) {
+    const value = message.timestamp;
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (typeof value === "string" && value.length > 0)
+        return value;
+    return undefined;
+}
+export function reconcileAttemptUsage(live, messages, baseline) {
+    if (!Number.isInteger(baseline) || baseline < 0 || messages.length < baseline)
+        return { ...live };
+    const persisted = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0, turns: 0 };
+    const complete = { input: true, output: true, cacheRead: true, cacheWrite: true, cost: true };
+    let previous;
+    for (let index = baseline; index < messages.length; index++) {
+        const message = messages[index];
+        if (message.role === "assistant") {
+            const timestamp = validTimestamp(message);
+            const duplicate = previous?.role === "assistant" && timestamp !== undefined && validTimestamp(previous) === timestamp;
+            if (!duplicate) {
+                persisted.turns++;
+                for (const field of usageFields) {
+                    const value = fieldValue(message.usage, field);
+                    if (value === undefined)
+                        complete[field] = false;
+                    else
+                        persisted[field] += value;
+                }
+            }
+        }
+        previous = message;
+    }
+    if (persisted.turns === 0)
+        return { ...live };
+    const reconciled = { ...live, turns: persisted.turns };
+    for (const field of usageFields) {
+        if (complete[field] && Number.isFinite(persisted[field]))
+            reconciled[field] = persisted[field];
+    }
+    return reconciled;
+}
+//# sourceMappingURL=usage-reconciliation.js.map

package/src/runs/shared/usage-reconciliation.js.map

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

package/src/runs/shared/workflow-async-child-guidance.d.ts

@@ -0,0 +1,4 @@
+import type { AsyncStatus, SubagentState } from "../../shared/types.ts";
+/** Projection-only guidance, not a control route or proof of current child liveness. */
+export declare function workflowAsyncChildSteeringGuidance(status: AsyncStatus, state?: SubagentState): string[];
+//# sourceMappingURL=workflow-async-child-guidance.d.ts.map

package/src/runs/shared/workflow-async-child-guidance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-async-child-guidance.d.ts","sourceRoot":"","sources":["../../../../src/runs/shared/workflow-async-child-guidance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAExE,wFAAwF;AACxF,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,MAAM,EAAE,CAcvG"}

package/src/runs/shared/workflow-async-child-guidance.js

@@ -0,0 +1,18 @@
+/** Projection-only guidance, not a control route or proof of current child liveness. */
+export function workflowAsyncChildSteeringGuidance(status, state) {
+    if (status.mode !== "workflow" || (status.state !== "running" && status.state !== "queued")
+        || !state?.currentSessionId || status.sessionId !== state.currentSessionId
+        || !state.workflowControllers?.has(status.runId))
+        return [];
+    const ids = new Set((status.steps ?? []).flatMap((step) => step.async === true && step.status === "running"
+        && step.runner?.type !== "external-cli" && step.runner?.type !== "external-job"
+        && typeof step.runId === "string" && /^[A-Za-z0-9_-]+$/.test(step.runId) && step.runId !== status.runId
+        ? [step.runId] : []));
+    if (ids.size === 0)
+        return [];
+    return [
+        "Async children recorded as running; direct steering rechecks controls. Choose an exact child ID (queued does not mean consumed):",
+        ...[...ids].map((id) => `  subagent({ action: "steer", id: "${id}", mode: "follow_up", message: "..." })`),
+    ];
+}
+//# sourceMappingURL=workflow-async-child-guidance.js.map

package/src/runs/shared/workflow-async-child-guidance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-async-child-guidance.js","sourceRoot":"","sources":["../../../../src/runs/shared/workflow-async-child-guidance.ts"],"names":[],"mappings":"AAEA,wFAAwF;AACxF,MAAM,UAAU,kCAAkC,CAAC,MAAmB,EAAE,KAAqB;IAC5F,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC;WACvF,CAAC,KAAK,EAAE,gBAAgB,IAAI,MAAM,CAAC,SAAS,KAAK,KAAK,CAAC,gBAAgB;WACvE,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CACzD,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;WAC7C,IAAI,CAAC,MAAM,EAAE,IAAI,KAAK,cAAc,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,KAAK,cAAc;WAC5E,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK;QACtG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxB,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9B,OAAO;QACN,kIAAkI;QAClI,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,sCAAsC,EAAE,yCAAyC,CAAC;KAC1G,CAAC;AACH,CAAC"}

package/src/runs/shared/workflow-graph.d.ts

@@ -0,0 +1,32 @@
+import { type ChainStep } from "../../shared/settings.ts";
+import type { SingleResult, SubagentRunMode, WorkflowGraphNode, WorkflowGraphSnapshot, WorkflowNodeStatus } from "../../shared/types.ts";
+export interface WorkflowGraphBuildInput {
+    runId: string;
+    mode?: SubagentRunMode;
+    steps: ChainStep[];
+    results?: Array<Pick<SingleResult, "exitCode" | "detached" | "interrupted" | "error" | "acceptance">>;
+    currentFlatIndex?: number;
+    currentStepIndex?: number;
+    stepStatuses?: Array<{
+        status?: string;
+        error?: string;
+    }>;
+    dynamicChildren?: Record<number, Array<{
+        agent: string;
+        label?: string;
+        flatIndex: number;
+        itemKey: string;
+        outputName?: string;
+        structured?: boolean;
+        error?: string;
+    }>>;
+    dynamicGroupStatuses?: Record<number, {
+        status: WorkflowNodeStatus;
+        error?: string;
+        acceptance?: SingleResult["acceptance"];
+    }>;
+}
+/** Return displayable workflow stages while hiding structural parallel groups and host monitors. */
+export declare function workflowGraphStageNodes(graph: WorkflowGraphSnapshot | undefined): WorkflowGraphNode[];
+export declare function buildWorkflowGraphSnapshot(input: WorkflowGraphBuildInput): WorkflowGraphSnapshot;
+//# sourceMappingURL=workflow-graph.d.ts.map

package/src/runs/shared/workflow-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-graph.d.ts","sourceRoot":"","sources":["../../../../src/runs/shared/workflow-graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyC,KAAK,SAAS,EAAuB,MAAM,0BAA0B,CAAC;AACtH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEzI,MAAM,WAAW,uBAAuB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,UAAU,GAAG,aAAa,GAAG,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC;IACtG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC1K,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,kBAAkB,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,YAAY,CAAC,YAAY,CAAC,CAAA;KAAE,CAAC,CAAC;CAC/H;AAED,oGAAoG;AACpG,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,qBAAqB,GAAG,SAAS,GAAG,iBAAiB,EAAE,CAarG;AA8DD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,uBAAuB,GAAG,qBAAqB,CAqIhG"}

package/src/runs/shared/workflow-graph.js

@@ -0,0 +1,222 @@
+import { isDynamicParallelStep, isParallelStep } from "../../shared/settings.js";
+/** Return displayable workflow stages while hiding structural parallel groups and host monitors. */
+export function workflowGraphStageNodes(graph) {
+    const nodes = graph?.nodes;
+    if (!nodes?.length)
+        return [];
+    const stages = [];
+    const visit = (node) => {
+        if (node.kind === "parallel-group" || node.kind === "dynamic-parallel-group") {
+            for (const child of node.children ?? [])
+                visit(child);
+            return;
+        }
+        if (node.kind !== "host-step")
+            stages.push(node);
+    };
+    for (const node of nodes)
+        visit(node);
+    return stages;
+}
+function normalizeStatus(status) {
+    switch (status) {
+        case "complete":
+        case "completed":
+            return "completed";
+        case "running":
+            return "running";
+        case "failed":
+            return "failed";
+        case "paused":
+            return "paused";
+        case "detached":
+            return "detached";
+        case "rejected":
+            return "rejected";
+        case "pending":
+            return "pending";
+        default:
+            return undefined;
+    }
+}
+function resultStatus(result) {
+    if (!result)
+        return undefined;
+    if (result.detached)
+        return "detached";
+    if (result.interrupted)
+        return "paused";
+    return result.exitCode === 0 ? "completed" : "failed";
+}
+function nodeStatus(input, flatIndex) {
+    return normalizeStatus(input.stepStatuses?.[flatIndex]?.status)
+        ?? resultStatus(input.results?.[flatIndex])
+        ?? (input.currentFlatIndex === flatIndex ? "running" : "pending");
+}
+function pushPhase(phases, phase, nodeId) {
+    if (!phase)
+        return;
+    let group = phases.find((candidate) => candidate.title === phase);
+    if (!group) {
+        group = { title: phase, nodeIds: [] };
+        phases.push(group);
+    }
+    group.nodeIds.push(nodeId);
+}
+function seqLabel(step, stepIndex) {
+    return step.label?.trim() || step.agent || `Step ${stepIndex + 1}`;
+}
+function summarizeParallelStatuses(statuses) {
+    if (statuses.some((status) => status === "running"))
+        return "running";
+    if (statuses.some((status) => status === "rejected"))
+        return "rejected";
+    if (statuses.some((status) => status === "failed"))
+        return "failed";
+    if (statuses.some((status) => status === "paused"))
+        return "paused";
+    if (statuses.some((status) => status === "detached"))
+        return "detached";
+    if (statuses.length > 0 && statuses.every((status) => status === "completed"))
+        return "completed";
+    if (statuses.some((status) => status === "completed"))
+        return "running";
+    return "pending";
+}
+export function buildWorkflowGraphSnapshot(input) {
+    const nodes = [];
+    const phases = [];
+    let flatIndex = 0;
+    let currentNodeId;
+    for (let stepIndex = 0; stepIndex < input.steps.length; stepIndex++) {
+        const step = input.steps[stepIndex];
+        if (isParallelStep(step)) {
+            const groupId = `step-${stepIndex}`;
+            const children = [];
+            const childStatuses = [];
+            for (let taskIndex = 0; taskIndex < step.parallel.length; taskIndex++) {
+                const task = step.parallel[taskIndex];
+                const status = nodeStatus(input, flatIndex);
+                childStatuses.push(status);
+                const childId = `step-${stepIndex}-agent-${taskIndex}`;
+                const child = {
+                    id: childId,
+                    kind: "agent",
+                    agent: task.agent,
+                    phase: task.phase,
+                    label: task.label?.trim() || task.agent || `Agent ${taskIndex + 1}`,
+                    status,
+                    flatIndex,
+                    stepIndex,
+                    outputName: task.as,
+                    structured: Boolean(task.outputSchema),
+                    acceptanceStatus: input.results?.[flatIndex]?.acceptance?.status,
+                    error: input.stepStatuses?.[flatIndex]?.error ?? input.results?.[flatIndex]?.error,
+                };
+                children.push(child);
+                pushPhase(phases, task.phase, childId);
+                if (status === "running" || input.currentFlatIndex === flatIndex)
+                    currentNodeId = childId;
+                flatIndex++;
+            }
+            const groupStatus = summarizeParallelStatuses(childStatuses);
+            if (input.currentStepIndex === stepIndex && !currentNodeId)
+                currentNodeId = groupId;
+            nodes.push({
+                id: groupId,
+                kind: "parallel-group",
+                label: step.parallel.length === 1 ? "Parallel task" : `Parallel group (${step.parallel.length})`,
+                status: groupStatus,
+                stepIndex,
+                children,
+            });
+            continue;
+        }
+        if (isDynamicParallelStep(step)) {
+            const groupId = `step-${stepIndex}`;
+            const materialized = input.dynamicChildren?.[stepIndex] ?? [];
+            const groupOverride = input.dynamicGroupStatuses?.[stepIndex];
+            const children = [];
+            const childStatuses = [];
+            for (let taskIndex = 0; taskIndex < materialized.length; taskIndex++) {
+                const task = materialized[taskIndex];
+                const status = nodeStatus(input, task.flatIndex);
+                childStatuses.push(status);
+                const childId = `step-${stepIndex}-item-${task.itemKey.replace(/[^a-zA-Z0-9_-]/g, "-")}`;
+                const child = {
+                    id: childId,
+                    kind: "agent",
+                    agent: task.agent,
+                    phase: step.parallel.phase ?? step.phase,
+                    label: task.label?.trim() || step.parallel.label?.trim() || `${task.agent} ${task.itemKey}`,
+                    status,
+                    flatIndex: task.flatIndex,
+                    stepIndex,
+                    itemKey: task.itemKey,
+                    outputName: task.outputName,
+                    structured: task.structured,
+                    acceptanceStatus: input.results?.[task.flatIndex]?.acceptance?.status,
+                    error: input.stepStatuses?.[task.flatIndex]?.error ?? input.results?.[task.flatIndex]?.error ?? task.error,
+                };
+                children.push(child);
+                pushPhase(phases, child.phase, childId);
+                if (status === "running" || input.currentFlatIndex === task.flatIndex)
+                    currentNodeId = childId;
+            }
+            const groupStatus = groupOverride?.status ?? (children.length > 0 ? summarizeParallelStatuses(childStatuses) : (input.currentStepIndex === stepIndex ? "running" : "pending"));
+            if (input.currentStepIndex === stepIndex && !currentNodeId)
+                currentNodeId = groupId;
+            nodes.push({
+                id: groupId,
+                kind: "dynamic-parallel-group",
+                label: step.label?.trim() || step.parallel.label?.trim() || `Dynamic fanout (${step.collect.as})`,
+                status: groupStatus,
+                stepIndex,
+                outputName: step.collect.as,
+                structured: Boolean(step.collect.outputSchema),
+                acceptanceStatus: groupOverride?.acceptance?.status,
+                error: groupOverride?.error,
+                dynamic: {
+                    sourceOutput: step.expand.from.output,
+                    sourcePath: step.expand.from.path,
+                    itemName: step.expand.item ?? "item",
+                    maxItems: step.expand.maxItems,
+                    collectAs: step.collect.as,
+                },
+                children,
+            });
+            if (materialized.length > 0)
+                flatIndex = Math.max(flatIndex, ...materialized.map((child) => child.flatIndex + 1));
+            continue;
+        }
+        const seq = step;
+        const status = nodeStatus(input, flatIndex);
+        const id = `step-${stepIndex}`;
+        nodes.push({
+            id,
+            kind: "step",
+            agent: seq.agent,
+            phase: seq.phase,
+            label: seqLabel(seq, stepIndex),
+            status,
+            flatIndex,
+            stepIndex,
+            outputName: seq.as,
+            structured: Boolean(seq.outputSchema),
+            acceptanceStatus: input.results?.[flatIndex]?.acceptance?.status,
+            error: input.stepStatuses?.[flatIndex]?.error ?? input.results?.[flatIndex]?.error,
+        });
+        pushPhase(phases, seq.phase, id);
+        if (status === "running" || input.currentFlatIndex === flatIndex || input.currentStepIndex === stepIndex)
+            currentNodeId = id;
+        flatIndex++;
+    }
+    return {
+        runId: input.runId,
+        mode: input.mode ?? "chain",
+        phases,
+        nodes,
+        currentNodeId,
+    };
+}
+//# sourceMappingURL=workflow-graph.js.map

package/src/runs/shared/workflow-graph.js.map

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

package/src/runs/shared/worktree-cleanup-plan.d.ts

@@ -0,0 +1,78 @@
+export declare const WORKTREE_CLEANUP_PLAN_VERSION: 1;
+export declare const WORKTREE_CLEANUP_PLAN_TTL_MS: number;
+export type WorktreeCleanupPlanState = "safe" | "ineligible" | "stale" | "dirty" | "active" | "unknown";
+export type WorktreeCleanupPlanDecision = "remove" | "keep" | "unknown";
+export type WorktreeCleanupPlanSource = "git" | "metadata" | "both";
+export type ForegroundRunOwnership = "active" | "terminal" | "unknown";
+export interface WorktreeCleanupPlanPreconditions {
+    path: string;
+    branch: string;
+    worktreeHead?: string;
+    branchTip?: string;
+    baseCommit?: string;
+    statusDigest?: string;
+    recordedBaseDir?: string;
+    targetRef?: string;
+}
+export interface WorktreeCleanupPlanEntry {
+    path: string;
+    branch: string;
+    decision: WorktreeCleanupPlanDecision;
+    state: WorktreeCleanupPlanState;
+    reasons: string[];
+    source: WorktreeCleanupPlanSource;
+    willDeleteBranch?: boolean;
+    runId?: string;
+    handoffPath?: string;
+    taskIndex?: number;
+    baseCommit?: string;
+    patchPath?: string;
+    targetRef?: string;
+    preconditions: WorktreeCleanupPlanPreconditions;
+}
+export interface WorktreeCleanupPlan {
+    version: typeof WORKTREE_CLEANUP_PLAN_VERSION;
+    planId: string;
+    repoRoot: string;
+    createdAt: number;
+    expiresAt: number;
+    baseDirs: string[];
+    metadataPaths: string[];
+    entries: WorktreeCleanupPlanEntry[];
+    pruneCandidates: string[];
+    warnings?: string[];
+    contentHash: string;
+}
+export interface BuildWorktreeCleanupPlanInput {
+    repo: string;
+    handoffPath?: string;
+    /** Internal test and migration seam for explicitly supplied handoff records. */
+    handoffPaths?: string[];
+    worktreeBaseDir?: string;
+    now?: number;
+    planId?: string;
+    /** Current-process proof for foreground owners; unknown must remain non-removable. */
+    foregroundRunOwnership?: (runId: string) => ForegroundRunOwnership;
+}
+export interface CreatedWorktreeCleanupPlan {
+    plan: WorktreeCleanupPlan;
+    planPath: string;
+}
+interface GitWorktreeRecord {
+    path: string;
+    head: string;
+    branch?: string;
+    prunable?: string;
+}
+declare function realpathExisting(candidate: string, nativeRealpath?: (filePath: string) => string, fallbackRealpath?: (filePath: string) => string): string;
+/** Internal test seam; this is not part of the public subagent tool API. */
+export declare const __testables: {
+    realpathExisting: typeof realpathExisting;
+};
+export declare function parseGitWorktreeList(raw: string): GitWorktreeRecord[];
+export declare function buildWorktreeCleanupPlan(input: BuildWorktreeCleanupPlanInput): WorktreeCleanupPlan;
+export declare function worktreeCleanupPlanPath(repoRoot: string, planId: string): string;
+export declare function createWorktreeCleanupPlan(input: BuildWorktreeCleanupPlanInput): CreatedWorktreeCleanupPlan;
+export declare function formatWorktreeCleanupPlan(created: CreatedWorktreeCleanupPlan): string;
+export {};
+//# sourceMappingURL=worktree-cleanup-plan.d.ts.map

package/src/runs/shared/worktree-cleanup-plan.d.ts.map

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