@emiliosp/pi-maestro 0.16.0 → 0.18.0

package/node_modules/pi-subagents/src/shared/types.d.ts

@@ -1,2748 +0,0 @@
-/**
- * Type definitions for the subagent extension
- */
-import type { Message } from "@earendil-works/pi-ai";
-import type { AgentConfig } from "../agents/agents.ts";
-import type { FSWatcher } from "node:fs";
-import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
-import type { ModelScopeRule } from "../runs/shared/model-scope.ts";
-import type { ResolvedSubagentCapabilityCeiling, SubagentCapabilityAudit } from "../runs/shared/capability-ceiling.ts";
-import type { AuthorityPolicyConfig } from "../policy/authority.ts";
-import type { ThinkingLevel } from "./model-info.ts";
-import type { SubagentFeature } from "./disabled-features.ts";
-import type { GlobalMissionIndexRecord, MissionRecord, MissionStoreConfig } from "../missions/types.ts";
-import type { ExtensionBindings } from "../runs/shared/extension-bindings.ts";
-import type { WorkflowChildPermitContext } from "./workflow-child-permit.ts";
-import type { WatchdogWarningDetails } from "../watchdog/types.ts";
-import type { RequiredChildExtensionSnapshot } from "./required-child-extensions.ts";
-export interface MaxOutputConfig {
-    bytes?: number;
-    lines?: number;
-}
-export type OutputMode = "inline" | "file-only";
-export type AcceptanceRole = "read-only" | "writer";
-export type JsonSchemaObject = Record<string, unknown>;
-export interface ChainOutputMapEntry {
-    text: string;
-    structured?: unknown;
-    agent: string;
-    stepIndex: number;
-}
-export type ChainOutputMap = Record<string, ChainOutputMapEntry>;
-export type WorkflowNodeStatus = "pending" | "running" | "completed" | "failed" | "partial" | "paused" | "stopped" | "detached" | "rejected";
-export type HostStepMonitorKind = "command" | "ci" | "gate";
-export type HostStepState = "pending" | "running" | "done" | "cancelled" | "error";
-export type HostStepVerdict = "pass" | "fail" | "inconclusive";
-export interface HostStepFreshness {
-    expectedRef: string;
-    observedRef?: string;
-    stale?: boolean;
-}
-/** Bounded, provider-agnostic status for a host-owned workflow monitor. */
-export interface HostStepNode {
-    version: 1;
-    kind: "host-step";
-    /** Explicit monitor category; never inferred from labels or commands. */
-    monitorKind: HostStepMonitorKind;
-    id: string;
-    label: string;
-    role?: string;
-    provider?: string;
-    state: HostStepState;
-    verdict?: HostStepVerdict;
-    reasonCode?: string;
-    detail?: string;
-    target?: string;
-    freshness?: HostStepFreshness;
-    reportPath?: string;
-    exitCode?: number | null;
-    updatedAt: number;
-    deadlineAt?: number;
-}
-export interface WorkflowGraphNode {
-    id: string;
-    kind: "step" | "parallel-group" | "dynamic-parallel-group" | "agent" | "host-step";
-    agent?: string;
-    phase?: string;
-    label: string;
-    status: WorkflowNodeStatus;
-    flatIndex?: number;
-    stepIndex?: number;
-    children?: WorkflowGraphNode[];
-    dynamic?: {
-        sourceOutput: string;
-        sourcePath: string;
-        itemName: string;
-        maxItems?: number;
-        collectAs?: string;
-    };
-    itemKey?: string;
-    outputName?: string;
-    structured?: boolean;
-    acceptanceStatus?: AcceptanceLedgerStatus;
-    error?: string;
-    hostStep?: HostStepNode;
-}
-export interface WorkflowGraphSnapshot {
-    runId: string;
-    mode: SubagentRunMode;
-    phases: Array<{
-        title: string;
-        nodeIds: string[];
-    }>;
-    nodes: WorkflowGraphNode[];
-    currentNodeId?: string;
-}
-export type WorkflowPreflightCoverage = "complete" | "partial";
-export type WorkflowPreflightMode = "mutation" | "review" | "scout" | "gate";
-/** Bounded, display-only lane hints supplied alongside a workflowScript launch. */
-export interface WorkflowPreflightLane {
-    key: string;
-    mode?: WorkflowPreflightMode;
-    decision?: string;
-    claims?: string[];
-    expectedOutput?: string;
-    independence?: string;
-}
-/** Versioned, display-only workflow launch plan; it never grants launch authority. */
-export interface WorkflowPreflight {
-    version: 1;
-    coverage: WorkflowPreflightCoverage;
-    lanes: WorkflowPreflightLane[];
-}
-export type WorkflowReceiptState = "complete" | "failed" | "paused" | "stopped";
-export type WorkflowScriptFailureKind = "validation" | "script" | "child" | "return-serialization" | "timeout" | "detached-child" | "runtime";
-export type WorkflowTerminalResolution = "settled-awaiting-resume" | "failed-child" | "interrupted-child";
-export interface WorkflowTerminalOutcome {
-    state: "partial";
-    reason: "budget_exhausted" | "timeout";
-}
-export interface WorkflowRecoveryAction {
-    key: string;
-    call: "runs.run";
-    resume: {
-        workflowRunId: string;
-        key: string;
-        latest: true;
-    };
-    taskRequired: true;
-}
-/**
- * Bounded, host-generated identity for a resolved pi-subagents workflow resource.
- * Permission/policy extensions can use it to distinguish resolved content from
- * raw workflow scripts. This audit projection never grants execution authority.
- */
-export interface WorkflowResourceProvenance {
-    kind: "workflow";
-    name: string;
-    version: number;
-    invocation: "named";
-    expansion: "resolved";
-    id: string;
-}
-/**
- * Bounded, launch-declared workflow lane metadata. This is display and
- * triage information only; capability ceilings, authorization, and cleanup
- * safety remain owned by their existing enforcement and handoff paths.
- */
-export type WorkflowLaneMode = "mutation" | "review" | "scout" | "gate";
-export interface WorkflowLaneMetadata {
-    version: 1;
-    key: string;
-    mode?: WorkflowLaneMode;
-    sourceRef?: string;
-    claims?: string[];
-    outputPaths?: string[];
-}
-/** Bounded foreground activity; excludes tool arguments and transcript content. */
-export interface WorkflowChildActivity {
-    currentTool?: string;
-    currentToolStartedAt?: number;
-    lastActivityAt?: number;
-    durationMs?: number;
-    toolCount?: number;
-    turnCount?: number;
-    tokens?: number;
-    inputTokens?: number;
-    outputTokens?: number;
-}
-export interface WorkflowChildSummary {
-    version: 1;
-    parentToolCallId: string;
-    workflowRunId: string;
-    inventoryComplete: boolean;
-    workflowState: "queued" | "running" | "completed" | "failed" | "paused" | "stopped";
-    children: Array<{
-        childId: string;
-        runId?: string;
-        agent?: string;
-        /** Human-readable display name for the child session, when derived at launch. */
-        sessionName?: string;
-        model?: string;
-        thinking?: string;
-        /** Present only while a synchronous foreground child is running. */
-        activity?: WorkflowChildActivity;
-        state: "pending" | "running" | "completed" | "failed" | "paused" | "stopped" | "rejected" | "detached";
-    }>;
-}
-type WorkflowReceiptEntryResumability = {
-    latestRunId: string;
-    resumability: {
-        state: "resumable";
-    };
-} | {
-    latestRunId?: string;
-    resumability: {
-        state: "not-resumable";
-        reason: string;
-    };
-};
-export type WorkflowReceiptEntry = WorkflowReceiptEntryResumability & {
-    key: string;
-    lane?: WorkflowLaneMetadata;
-    terminalOutcome?: WorkflowTerminalOutcome;
-    agent?: string;
-    requestedContext?: "fresh" | "fork";
-    resolvedContext?: "fresh" | "fork" | "mixed";
-    outputReference?: string;
-    acceptanceRecovery?: AcceptanceRecoveryMetadata;
-    externalAdapter?: ExternalCliReceiptMetadata;
-    continuation: {
-        runIds: string[];
-    };
-};
-export interface WorkflowReceipt {
-    version: 1;
-    workflowRunId: string;
-    state: WorkflowReceiptState;
-    createdAt: number;
-    entries: Record<string, WorkflowReceiptEntry>;
-    argsDigest?: string;
-    resource?: WorkflowResourceProvenance;
-    hostSteps?: HostStepNode[];
-    workflowChildren?: WorkflowChildSummary;
-    workflowResolution?: WorkflowTerminalResolution;
-    terminalOutcome?: WorkflowTerminalOutcome;
-    recovery?: WorkflowRecoveryAction[];
-}
-export interface SavedOutputReference {
-    path: string;
-    bytes: number;
-    lines: number;
-    message: string;
-}
-interface TruncationResult {
-    text: string;
-    truncated: boolean;
-    originalBytes?: number;
-    originalLines?: number;
-    artifactPath?: string;
-}
-export interface Usage {
-    input: number;
-    output: number;
-    cacheRead: number;
-    cacheWrite: number;
-    cost: number;
-    turns: number;
-}
-export interface ToolBudgetConfig {
-    soft?: number;
-    hard: number;
-    block?: string[] | "*";
-}
-export interface ResolvedToolBudget {
-    soft?: number;
-    hard: number;
-    block: string[] | "*";
-}
-export type ToolBudgetOutcome = "within-budget" | "soft-reached" | "hard-reached" | "hard-blocked";
-export interface ToolBudgetState extends ResolvedToolBudget {
-    outcome: ToolBudgetOutcome;
-    toolCount: number;
-    softReachedAt?: number;
-    hardReachedAt?: number;
-    blockedTool?: string;
-}
-/**
- * @deprecated Turn budgets are no longer accepted as launch configuration or
- * enforced. Retained only to decode historical persisted status and result data.
- */
-export type TurnBudgetOutcome = "within-budget" | "wrap-up-requested" | "termination-deferred" | "exceeded";
-/**
- * @deprecated Historical persisted turn-budget state. New runs do not produce
- * this field, but status readers retain it for backwards compatibility.
- */
-export interface TurnBudgetState {
-    maxTurns: number;
-    graceTurns: number;
-    outcome: TurnBudgetOutcome;
-    turnCount: number;
-    wrapUpRequestedAtTurn?: number;
-    terminationDeferredAtTurn?: number;
-    exceededAtTurn?: number;
-}
-export interface TokenUsage {
-    input: number;
-    output: number;
-    total: number;
-    /** Input plus cache-read tokens for the latest assistant turn. */
-    window?: number;
-    /** Largest window observed in this usage scope. */
-    windowPeak?: number;
-}
-export type ActivityState = "active_long_running" | "needs_attention";
-export type ControlEventType = "active_long_running" | "needs_attention";
-export type ControlNotificationChannel = "event" | "async" | "intercom";
-export interface ControlConfig {
-    enabled?: boolean;
-    needsAttentionAfterMs?: number;
-    activeNoticeAfterMs?: number;
-    activeNoticeAfterTurns?: number;
-    activeNoticeAfterTokens?: number;
-    failedToolAttemptsBeforeAttention?: number;
-    notifyOn?: ControlEventType[];
-    notifyChannels?: ControlNotificationChannel[];
-}
-export interface ResolvedControlConfig {
-    enabled: boolean;
-    needsAttentionAfterMs: number;
-    needsAttentionAfterMsIsExplicit?: boolean;
-    activeNoticeAfterMs: number;
-    activeNoticeAfterTurns?: number;
-    activeNoticeAfterTokens?: number;
-    failedToolAttemptsBeforeAttention: number;
-    notifyOn: ControlEventType[];
-    notifyChannels: ControlNotificationChannel[];
-}
-/**
- * Smart completion batching for async-completion notifications. Successful
- * sibling completions are held briefly so they arrive as one grouped message;
- * failure and attention signals bypass grouping and always fire immediately.
- */
-export interface CompletionBatchConfig {
-    enabled?: boolean;
-    /** Idle window after each arrival; resets on every new item. */
-    debounceMs?: number;
-    /** Hard cap measured from the first item in a group. */
-    maxWaitMs?: number;
-    /** Shorter idle window for straggler groups. */
-    stragglerDebounceMs?: number;
-    /** Shorter hard cap for straggler groups. */
-    stragglerMaxWaitMs?: number;
-    /** Arrivals within this window after an emit join a straggler group. */
-    stragglerWindowMs?: number;
-}
-export interface WaitToolConfigObject {
-    enabled?: boolean;
-    /** Default blocking window for bg_wait calls that omit timeoutMs. */
-    defaultTimeoutMs?: number;
-}
-export type WaitToolConfig = boolean | WaitToolConfigObject;
-export interface ControlEvent {
-    type: ControlEventType;
-    from?: ActivityState;
-    to: ActivityState;
-    ts: number;
-    agent: string;
-    index?: number;
-    runId: string;
-    nestedRunId?: string;
-    nestingPath?: NestedRunAddress["path"];
-    message: string;
-    reason?: "idle" | "active_long_running" | "tool_failures" | "supervisor_request" | "time_threshold" | "turn_threshold" | "token_threshold" | "tool_open_threshold";
-    turns?: number;
-    tokens?: number;
-    toolCount?: number;
-    currentTool?: string;
-    toolCallId?: string;
-    currentToolDurationMs?: number;
-    currentPath?: string;
-    elapsedMs?: number;
-    recentFailureSummary?: string;
-    workflowKey?: string;
-    phase?: string;
-    label?: string;
-    taskPreview?: string;
-}
-export type SubagentResultStatus = "running" | "completed" | "failed" | "paused" | "stopped" | "detached";
-export type SubagentOutputState = "present" | "absent" | "unknown";
-export type SubagentRunMode = "single" | "parallel" | "chain" | "workflow";
-export type SubagentResultMode = SubagentRunMode;
-export type WorktreeProvider = "auto" | "native" | "worktrunk";
-export type ManagedWorktreeProvider = Exclude<WorktreeProvider, "auto">;
-export interface WorktreeNaming {
-    requestedBranch: string;
-    branchPrefix: string;
-    label: string;
-    sanitizedPathComponent: string;
-    collision?: "branch" | "path" | "both";
-    collisionSuffix?: string;
-}
-export interface ParallelHandoffPatch {
-    path: string;
-    branch: string;
-    changed: boolean;
-    diffStat: string;
-    filesChanged: number;
-    insertions: number;
-    deletions: number;
-    error?: string;
-}
-export interface ParallelHandoffChild {
-    index: number;
-    taskIndex: number;
-    agent: string;
-    /** Stable workflow identity used to join status/receipt metadata. */
-    workflowKey?: string;
-    /** Child run id when the worktree belongs to a workflow child. */
-    runId?: string;
-    lane?: WorkflowLaneMetadata;
-    status: SubagentResultStatus;
-    summary: string;
-    outputPath?: string;
-    structuredOutput?: unknown;
-    structuredOutputPath?: string;
-    sessionPath?: string;
-    patch: ParallelHandoffPatch;
-}
-/** Launch-time identity retained while a handoff group has no terminal child rows yet. */
-export interface ParallelHandoffLaneBinding {
-    index: number;
-    taskIndex: number;
-    workflowKey?: string;
-    runId?: string;
-    lane?: WorkflowLaneMetadata;
-}
-export interface ParallelHandoffCleanupTask {
-    /** Canonical parent recorded when the worktree was created; missing proof keeps old trees. */
-    recordedBaseDir?: string;
-    index: number;
-    path: string;
-    branch: string;
-    /** Provider that allocated this worktree; omitted in old manifests. */
-    provider?: ManagedWorktreeProvider;
-    /** Branch/path naming evidence retained with the cleanup authority. */
-    naming?: WorktreeNaming;
-    worktreeRemoved: boolean;
-    branchRemoved: boolean;
-    preserved?: boolean;
-    reason?: string;
-    errors?: string[];
-}
-export type CleanupEligibility = {
-    state: "active";
-} | {
-    state: "terminal-eligible";
-} | {
-    state: "terminal-blocked";
-    reason: string;
-} | {
-    state: "superseded-eligible";
-} | {
-    state: "unknown";
-};
-export interface ParallelHandoffMergeEvidence {
-    prNumber: number;
-    reviewedHead: string;
-    mergeCommit: string;
-    treeEquivalent: boolean | "unknown";
-    postMergeChecks: "recorded" | "unknown";
-    attestedBy: string;
-    attestedAt: string;
-    manifestDigest?: string;
-}
-export interface ParallelHandoffSupersessionEvidence {
-    supersededBy: string;
-    attestedBy: string;
-    attestedAt: string;
-    manifestDigest?: string;
-}
-export interface ParallelHandoffGroup {
-    stepIndex: number;
-    baseCommit: string;
-    repoRoot: string;
-    children: ParallelHandoffChild[];
-    /** Optional launch identities for pending groups before child results settle. */
-    laneBindings?: ParallelHandoffLaneBinding[];
-    cleanup: {
-        state: "complete" | "partial";
-        tasks: ParallelHandoffCleanupTask[];
-        pruned: boolean;
-        errors?: string[];
-    };
-}
-export interface ParallelHandoffManifest {
-    version: 1;
-    runId: string;
-    mode: "single" | "parallel" | "chain";
-    source: "foreground" | "async";
-    cwd: string;
-    createdAt: number;
-    updatedAt: number;
-    groups: ParallelHandoffGroup[];
-    merge?: ParallelHandoffMergeEvidence;
-    supersession?: ParallelHandoffSupersessionEvidence;
-    cleanupEligibility?: CleanupEligibility;
-}
-export interface ParallelHandoffReference {
-    version: 1;
-    path: string;
-    groupCount: number;
-    childCount: number;
-    changedPatches: number;
-    cleanupState: "complete" | "partial";
-    cleanupEligibility?: CleanupEligibility;
-}
-export interface AgentContract {
-    version: 1;
-}
-export type ChainGateLayer = "execution" | "acceptance";
-export type ExecutionProjectionStatus = "completed" | "failed" | "partial" | "paused" | "stopped" | "detached";
-export interface ExecutionProjection {
-    status: ExecutionProjectionStatus;
-    success: boolean;
-    exitCode: number;
-    error?: string;
-    interrupted?: boolean;
-    timedOut?: boolean;
-    stopped?: boolean;
-    detached?: boolean;
-}
-export interface ReviewProjection {
-    status: "not-requested" | "review-required" | "reviewed" | "blockers";
-    findings?: AcceptanceReviewResult["findings"];
-}
-export interface FileMutationEffect {
-    status: "observed";
-    attempted: true;
-    evidence?: TrackedMutationEvidence;
-}
-export interface SettlementDiagnostic {
-    finalTextPresent: boolean;
-    mutation: {
-        attempted: boolean;
-        observed: boolean;
-    };
-    requiredOutput?: {
-        kind: "file-only" | "structured";
-        path: string;
-        missing: boolean;
-    };
-    afterCompactionSettlement?: boolean;
-}
-export interface EffectsProjection {
-    fileMutation?: FileMutationEffect;
-    settlementDiagnostic?: SettlementDiagnostic;
-}
-export interface TrackedMutationSnapshot {
-    source: "tracked-files";
-    trackedOnly: true;
-    cwd: string;
-    gitRoot?: string;
-    dirtyFiles: string[];
-    fingerprints: Record<string, TrackedMutationFingerprint>;
-    truncated?: boolean;
-    unavailable?: string;
-}
-export type TrackedMutationFingerprint = {
-    kind: "diff";
-    digest: string;
-};
-export interface TrackedMutationEvidence {
-    source: "tracked-files";
-    trackedOnly: true;
-    changedFiles: string[];
-    attemptedMutation: boolean;
-    truncated?: boolean;
-    unavailable?: string;
-}
-export interface TimeoutRecoverySummary {
-    termination: "timed-out" | "stopped";
-    changedFiles: string[];
-    truncated?: boolean;
-    /** True only when a timed-out child left tracked changes without its requested report. */
-    recoveryNeeded?: boolean;
-    reason?: "timed-out-with-dirty-worktree";
-    reportStatus?: "missing" | "written" | "not-requested" | "unknown";
-    currentTool?: string;
-    currentToolArgs?: string;
-    currentPath?: string;
-    sessionFile?: string;
-    transcriptPath?: string;
-    artifactPaths?: ArtifactPaths;
-    warning: string;
-    message: string;
-}
-/** Safe parent-facing subset of a timeout recovery summary. */
-export type TimeoutRecoveryProjection = Pick<TimeoutRecoverySummary, "termination" | "changedFiles" | "truncated" | "recoveryNeeded" | "reason" | "reportStatus">;
-export declare const SUBAGENT_LIFECYCLE_ARTIFACT_VERSION = 3;
-export type SubagentLifecycleArtifactVersion = typeof SUBAGENT_LIFECYCLE_ARTIFACT_VERSION;
-export type ProcessTerminalReason = "observer-unavailable" | "runner-candidate-missing" | "runner-instance-mismatch" | "writer-close-unverified" | "process-tree-unverified" | "canonical-session-unavailable" | "canonical-session-lease-active" | "canonical-session-release-unverified" | "proof-write-failed" | "stale-repair";
-export interface RunnerProcessInstanceExit {
-    processInstanceId: string;
-    kind: "runner";
-    closeObservedAt: number;
-    exitCode: number | null;
-    signal: string | null;
-}
-export type ProcessTreeTerminal = {
-    state: "observed";
-    mechanism: "posix-process-group";
-    processGroupId: number;
-    verifiedAt: number;
-} | {
-    state: "observed";
-    mechanism: "windows-taskkill";
-    pid: number;
-    verifiedAt: number;
-} | {
-    state: "unknown";
-    reason: "unsupported-platform" | "signal-failed" | "verification-failed";
-    diagnostic?: string;
-};
-export interface PiWriterProcessInstanceExit {
-    processInstanceId: string;
-    kind: "pi-writer";
-    attempt: number;
-    closeObservedAt: number;
-    exitCode: number | null;
-    signal: string | null;
-    processTree: ProcessTreeTerminal;
-}
-export type ProcessInstanceExit = RunnerProcessInstanceExit | PiWriterProcessInstanceExit;
-export interface CanonicalSessionTerminal {
-    canonicalSessionId: string;
-    leaseDisposition: "released" | "not-held";
-    freeAtObservation: true;
-    canonicalSessionLeaseReleased?: true;
-}
-interface ProcessTerminalBase {
-    version: 1;
-    runId: string;
-    childIndex?: number;
-    runnerProcessInstanceId: string;
-    observedAt?: number;
-    reason?: ProcessTerminalReason;
-    resumeDisposition?: "resumable" | "non-resumable" | "unavailable";
-}
-export type ProcessTerminal = (ProcessTerminalBase & {
-    state: "pending" | "not-started";
-}) | (ProcessTerminalBase & {
-    state: "observed";
-    observedAt: number;
-    instances: ProcessInstanceExit[];
-    canonicalSession?: CanonicalSessionTerminal;
-}) | (ProcessTerminalBase & {
-    state: "unknown";
-    reason: ProcessTerminalReason;
-    diagnostic?: string;
-    /** The runner's own exit, when observed even though the process tree could not be verified. */
-    instances?: RunnerProcessInstanceExit[];
-});
-export type WorkflowTerminalProof = {
-    version: 1;
-    kind: "workflow";
-    runId: string;
-    state: "observed";
-    dispatchClosed: true;
-    observedAt: number;
-    children: ProcessTerminal[];
-} | {
-    version: 1;
-    kind: "workflow";
-    runId: string;
-    state: "pending" | "unknown";
-    dispatchClosed: boolean;
-    reason: string;
-};
-/** Identifies the durable schedule that launched a run, so its completion is attributable. */
-export interface ScheduleOrigin {
-    id: string;
-    name?: string;
-    quiet?: boolean;
-}
-export type SteeringActionState = "delivered" | "scheduled" | "pending" | "partial" | "recovered" | "failed";
-export type SteeringTargetState = "scheduled" | "pending" | "routed" | "queued" | "delivered" | "late" | "failed" | "recovered";
-export interface SteeringTargetStatus {
-    index: number;
-    state: SteeringTargetState;
-    routedAt?: number;
-    deliveredAt?: number;
-    lateDeliveredAt?: number;
-    failedAt?: number;
-    recoveredAt?: number;
-    reason?: string;
-    replacementRunId?: string;
-}
-export interface SteeringRequestStatus {
-    id: string;
-    requestedAt: number;
-    source?: string;
-    messagePreview: string;
-    targets: SteeringTargetStatus[];
-}
-export interface SteeringStatus {
-    requested: number;
-    scheduled: number;
-    pending: number;
-    delivered: number;
-    failed: number;
-    recovered: number;
-    lastRequestedAt?: number;
-    lastDeliveredAt?: number;
-    recent: SteeringRequestStatus[];
-}
-export interface SteerActionTarget {
-    index: number;
-    state: SteeringTargetState;
-    deliveredAt?: number;
-    lateDeliveredAt?: number;
-    reason?: string;
-    replacementRunId?: string;
-}
-export interface SteerActionResult {
-    requestId: string;
-    state: SteeringActionState;
-    deliveryStatus: "delivered" | "queued";
-    sourceRunId: string;
-    replacementRunId?: string;
-    targets: SteerActionTarget[];
-}
-export interface SteeringNotice {
-    type: "subagent.steering.notice";
-    ts: number;
-    runId: string;
-    requestId: string;
-    state: "failed" | "partial" | "recovered";
-    message: string;
-    currentSessionId?: string;
-}
-export interface RunFanoutBudgetDescriptor {
-    version: 1;
-    rootRunId: string;
-    directory: string;
-    limit: number;
-    parentPath?: string;
-}
-export interface RunFanoutBudgetSnapshot {
-    used: number;
-    limit: number;
-    remaining: number;
-}
-export interface RunFanoutRejection extends RunFanoutBudgetSnapshot {
-    code: "RUN_FANOUT_LIMIT";
-    path: string;
-    requested: number;
-}
-export interface SteeringRecoveryDescriptor {
-    /** Captured response identity authority; absence means no declared aliases on revival. */
-    modelResponseAliases?: Record<string, string[]>;
-    version: 1;
-    launchContractDigest?: string;
-    extensionBindings?: ExtensionBindings;
-    requiredExtensions?: RequiredChildExtensionSnapshot;
-    runFanoutBudget: RunFanoutBudgetDescriptor;
-    sourceRunId: string;
-    agentContract?: AgentContract;
-    agent: string;
-    sessionFile?: string;
-    /** Git ref used to allocate managed worktrees for this run. */
-    baseRef?: string;
-    /** Launcher name the run was wrapped with; resume re-reads its argv from current user config. Absence means unwrapped. */
-    launcher?: string;
-    cwd: string;
-    model?: string;
-    modelProvider?: string;
-    modelOverrideFromParent?: boolean;
-    modelOrigin?: "explicit" | "inherited" | "configured";
-    fast?: boolean;
-    thinking?: string;
-    thinkingCeiling?: ThinkingLevel;
-    tools?: string[];
-    excludeTools?: string[];
-    allowNestedSubagents?: boolean;
-    allowedAgents?: string[];
-    extensions?: string[];
-    subagentOnlyExtensions?: string[];
-    mcpDirectTools?: string[];
-    mutationTools?: string[];
-    systemPrompt?: string;
-    systemPromptMode: "append" | "replace";
-    inheritProjectContext: boolean;
-    inheritGlobalContext: boolean;
-    inheritSkills: boolean;
-    skills?: string[];
-    skillPath?: string[];
-    agentFilePath?: string;
-    memory?: {
-        scope: "project" | "user";
-        path: string;
-    };
-    outputPath?: string;
-    outputMode: "inline" | "file-only";
-    structuredOutputSchema?: JsonSchemaObject;
-    acceptance?: AcceptanceInput;
-    controlConfig?: ResolvedControlConfig;
-    /** Resolved launch context for this async child. */
-    context?: "fresh" | "fork";
-    /** Raw per-run bridge override. Omitted descriptors continue to use global config. */
-    intercomBridge?: IntercomBridgeConfig;
-    lane?: WorkflowLaneMetadata;
-    absoluteDeadlineAt?: number;
-    initialToolBudget?: ResolvedToolBudget;
-    maxSubagentDepth: number;
-    maxOutput?: MaxOutputConfig;
-    capabilityCeiling?: ResolvedSubagentCapabilityCeiling;
-    launchResolvedExtensions?: LaunchResolvedChildExtensions;
-    share: boolean;
-    sessionDir?: string;
-    artifactsDir?: string;
-    artifactConfig?: ArtifactConfig;
-}
-export type PublicNestedStepSummary = Pick<NestedStepSummary, "agent" | "sessionName" | "status" | "model" | "thinking" | "sessionFile" | "transcriptPath" | "transcriptError" | "activityState" | "lastActivityAt" | "currentTool" | "currentToolStartedAt" | "currentPath" | "turnCount" | "toolCount" | "toolBudget" | "toolBudgetBlocked" | "startedAt" | "endedAt" | "error" | "timedOut" | "stopped"> & {
-    children?: PublicNestedRunSummary[];
-};
-export type CostSummary = {
-    inputTokens: number;
-    outputTokens: number;
-    costUsd: number;
-};
-export type PublicNestedRunSummary = Pick<NestedRunSummary, "id" | "parentRunId" | "parentStepIndex" | "parentAgent" | "depth" | "path" | "asyncDir" | "sessionId" | "sessionFile" | "intercomTarget" | "ownerIntercomTarget" | "leafIntercomTarget" | "ownerState" | "mode" | "state" | "agent" | "sessionName" | "agents" | "model" | "thinking" | "currentStep" | "chainStepCount" | "parallelGroups" | "activityState" | "lastActivityAt" | "currentTool" | "currentToolStartedAt" | "currentPath" | "turnCount" | "toolCount" | "toolBudget" | "toolBudgetBlocked" | "totalTokens" | "totalCost" | "startedAt" | "endedAt" | "lastUpdate" | "error" | "timeoutMs" | "deadlineAt" | "timedOut" | "stopped" | "turnBudget" | "turnBudgetExceeded" | "wrapUpRequested"> & {
-    steps?: PublicNestedStepSummary[];
-    children?: PublicNestedRunSummary[];
-};
-export interface SubagentResultIntercomChild {
-    agent: string;
-    /** Human-readable display name for the child session, when derived at launch. */
-    sessionName?: string;
-    /** Process/lifecycle status. It does not establish semantic task completion. */
-    status: SubagentResultStatus;
-    /** Whether the child produced substantive output before its process ended. */
-    outputState?: SubagentOutputState;
-    /** True when the output is unfinished streamed text recovered after a timeout or child error. */
-    outputPartial?: boolean;
-    summary: string;
-    index?: number;
-    artifactPath?: string;
-    sessionPath?: string;
-    intercomTarget?: string;
-    children?: PublicNestedRunSummary[];
-}
-export interface SubagentResultIntercomPayload {
-    to: string;
-    message: string;
-    requestId?: string;
-    runId: string;
-    mode: SubagentRunMode;
-    status: SubagentResultStatus;
-    summary: string;
-    source: "foreground" | "async";
-    children: SubagentResultIntercomChild[];
-    asyncId?: string;
-    asyncDir?: string;
-    chainSteps?: number;
-    agent?: string;
-    index?: number;
-    artifactPath?: string;
-    sessionPath?: string;
-    parallelHandoff?: ParallelHandoffReference;
-}
-export interface ChildWatchdogWarningSummary extends Pick<WatchdogWarningDetails, "severity" | "importance" | "category" | "summary" | "evidence" | "recommendedAction" | "displayedAt"> {
-    /** True when a later assistant turn in the child followed the warning. */
-    addressed: boolean;
-    stalemate: boolean;
-}
-export interface ChildWatchdogProgress {
-    phase: "idle" | "reviewing" | "stale" | "failed";
-    seq: number;
-    lastUpdate: number;
-    reason?: string;
-    timedOut?: boolean;
-    warnings?: ChildWatchdogWarningSummary[];
-}
-export interface AgentProgress {
-    index: number;
-    agent: string;
-    /** Human-readable display name for the child's session, when derived at launch. */
-    sessionName?: string;
-    status: "pending" | "running" | "completed" | "failed" | "detached";
-    activityState?: ActivityState;
-    task: string;
-    skills?: string[];
-    lastActivityAt?: number;
-    currentTool?: string;
-    currentToolArgs?: string;
-    currentToolStartedAt?: number;
-    currentPath?: string;
-    recentTools: Array<{
-        tool: string;
-        args: string;
-        endMs: number;
-    }>;
-    recentOutput: string[];
-    toolCount: number;
-    turnCount?: number;
-    tokens: number;
-    /** Resolved launch model/effort and split usage for public live projections. */
-    model?: string;
-    thinking?: string;
-    inputTokens?: number;
-    outputTokens?: number;
-    /** Cumulative cache-read/cache-write tokens for the current attempt, alongside inputTokens/outputTokens. */
-    cacheRead?: number;
-    cacheWrite?: number;
-    window?: number;
-    windowPeak?: number;
-    durationMs: number;
-    error?: string;
-    failedTool?: string;
-    watchdog?: ChildWatchdogProgress;
-}
-export interface ToolCallSummary {
-    text: string;
-    expandedText: string;
-}
-interface ProgressSummary {
-    index?: number;
-    agent?: string;
-    /** Human-readable display name for the child's session, when derived at launch. */
-    sessionName?: string;
-    status?: AgentProgress["status"];
-    activityState?: ActivityState;
-    skills?: string[];
-    lastActivityAt?: number;
-    currentTool?: string;
-    currentToolArgs?: string;
-    currentToolStartedAt?: number;
-    recentTools?: Array<{
-        tool: string;
-        args: string;
-        endMs: number;
-    }>;
-    recentOutput?: string[];
-    toolCount: number;
-    tokens: number;
-    model?: string;
-    thinking?: string;
-    durationMs: number;
-}
-export type AcceptanceLevel = "auto" | "none" | "attested" | "checked" | "verified";
-export type AcceptanceEvidenceKind = "changed-files" | "tests-added" | "commands-run" | "validation-output" | "residual-risks" | "no-staged-files" | "diff-summary" | "review-findings" | "manual-notes";
-export interface AcceptanceGate {
-    id: string;
-    must: string;
-    evidence?: AcceptanceEvidenceKind[];
-    severity?: "required" | "recommended";
-}
-export interface AcceptanceVerifyCommand {
-    id: string;
-    command: string;
-    timeoutMs?: number;
-    cwd?: string;
-    env?: Record<string, string>;
-    allowFailure?: boolean;
-    /** When "json", a passing command's stdout is parsed and becomes the run's structured output. */
-    output?: "json";
-    /** Optional JSON Schema the parsed stdout must satisfy; only meaningful with `output: "json"`. */
-    schema?: JsonSchemaObject;
-}
-export interface AcceptanceReviewGate {
-    agent?: string;
-    focus?: string;
-    required?: boolean;
-}
-export interface AcceptanceConfig {
-    level?: AcceptanceLevel;
-    report?: "on" | "off";
-    /** Preserve an intentional launch-time staged index, while rejecting any terminal index change. */
-    preserveStagedIndex?: true;
-    criteria?: Array<string | AcceptanceGate>;
-    evidence?: AcceptanceEvidenceKind[];
-    verify?: AcceptanceVerifyCommand[];
-    review?: AcceptanceReviewGate | false;
-    stopRules?: string[];
-    reason?: string;
-}
-/** Bare "none" and "verified" are not accepted; verified policies require object form with runtime commands. */
-export type AcceptanceInput = Exclude<AcceptanceLevel, "none" | "verified"> | false | AcceptanceConfig;
-export interface ResolvedAcceptanceGate extends AcceptanceGate {
-    id: string;
-    must: string;
-    evidence: AcceptanceEvidenceKind[];
-    severity: "required" | "recommended";
-}
-export interface ResolvedAcceptanceConfig {
-    level: Exclude<AcceptanceLevel, "auto">;
-    explicit: boolean;
-    inferredReason: string[];
-    criteria: ResolvedAcceptanceGate[];
-    evidence: AcceptanceEvidenceKind[];
-    preserveStagedIndex?: true;
-    verify: AcceptanceVerifyCommand[];
-    review?: AcceptanceReviewGate | false;
-    stopRules: string[];
-    reason?: string;
-}
-export interface AcceptanceReport {
-    criteriaSatisfied?: Array<{
-        id?: string;
-        status: "satisfied" | "not-satisfied" | "not-applicable";
-        evidence: string;
-    }>;
-    changedFiles?: string[];
-    testsAddedOrUpdated?: string[];
-    commandsRun?: Array<{
-        command: string;
-        result: "passed" | "failed" | "not-run";
-        summary: string;
-    }>;
-    validationOutput?: string[];
-    residualRisks?: string[];
-    noStagedFiles?: boolean;
-    diffSummary?: string;
-    reviewFindings?: string[];
-    manualNotes?: string;
-    notes?: string;
-}
-export type AcceptanceRuntimeCheckStatus = "passed" | "failed" | "not-applicable";
-export interface AcceptanceRuntimeCheck {
-    id: string;
-    status: AcceptanceRuntimeCheckStatus;
-    message: string;
-}
-export interface AcceptanceVerifyResult {
-    id: string;
-    command: string;
-    cwd?: string;
-    exitCode: number | null;
-    status: "passed" | "failed" | "timed-out" | "allowed-failure";
-    stdout?: string;
-    stderr?: string;
-    durationMs: number;
-    artifactPath?: string;
-    cacheKey?: string;
-    memoized?: boolean;
-    envKeys?: string[];
-    envHash?: string;
-    workspaceState?: {
-        kind: "git-tracked";
-        repoRoot: string;
-        cwdRelative: string;
-        head: string;
-        diffHash: string;
-    };
-    artifactError?: string;
-    /** Parsed stdout of a passing `output: "json"` command. */
-    structuredOutput?: unknown;
-    /** Why a passing `output: "json"` command still failed: invalid JSON, truncated stdout, or schema mismatch. */
-    structuredOutputError?: string;
-}
-export interface AcceptanceReviewResult {
-    status: "review-required" | "reviewed" | "blockers";
-    findings: Array<{
-        severity: "blocker" | "non-blocking";
-        file?: string;
-        issue: string;
-        rationale: string;
-    }>;
-}
-export type AcceptanceEvidenceStatus = "pending" | "not-required" | "claimed" | "attested" | "checked" | "verified" | "rejected";
-export type AcceptanceLedgerStatus = AcceptanceEvidenceStatus | "review-required" | "reviewed" | "accepted";
-/**
- * Durable child evidence that can be handed to a read-only review after the
- * acceptance envelope itself was rejected. This never upgrades acceptance;
- * the enclosing ledger remains rejected and the child remains unsuccessful.
- */
-export interface AcceptanceRecoveryMetadata {
-    status: "available-for-review";
-    reason: "acceptance-metadata-rejected";
-    reportPath: string;
-    reportHash: string;
-}
-export interface AcceptanceLedger {
-    status: AcceptanceLedgerStatus;
-    evidenceStatus: AcceptanceEvidenceStatus;
-    explicit: boolean;
-    effectiveAcceptance: ResolvedAcceptanceConfig;
-    inferredReason: string[];
-    criteria: ResolvedAcceptanceGate[];
-    childReport?: AcceptanceReport;
-    childReportParseError?: string;
-    recovery?: AcceptanceRecoveryMetadata;
-    runtimeChecks: AcceptanceRuntimeCheck[];
-    verifyRuns: AcceptanceVerifyResult[];
-    reviewResult?: AcceptanceReviewResult;
-    parentDecision?: {
-        status: "accepted" | "rejected";
-        at: string;
-        reason?: string;
-    };
-}
-export interface LaunchResolvedChildExtensions {
-    version: 1;
-    /** This is parent-resolved launch intent, not child-runtime acknowledgement that extensions loaded. */
-    source: "launch-resolved";
-    disableAmbientExtensions: boolean;
-    runtime: string[];
-    configured: string[];
-    /** Bounded host-supplied identities; paths are intentionally not exposed. */
-    required: string[];
-    effective: string[];
-    omitted: {
-        runtime: number;
-        configured: number;
-        required: number;
-        effective: number;
-    };
-}
-export interface RuntimeAcknowledgedChildExtensions {
-    version: 1;
-    /** Best-effort child-runtime registration acknowledgement, not extension health. */
-    source: "child-runtime";
-    ids: string[];
-    omitted: number;
-}
-export interface UsageBudgetLimitConfig {
-    soft?: number;
-    hard: number;
-}
-export interface UsageBudgetConfig {
-    tokens?: UsageBudgetLimitConfig;
-    costUsd?: UsageBudgetLimitConfig;
-}
-export interface UsageBudgetMetricState extends UsageBudgetLimitConfig {
-    used: number;
-    outcome: "within-budget" | "soft-exceeded" | "hard-exceeded";
-}
-export interface UsageBudgetState {
-    version: 1;
-    /** Enforced from usage reported by completed or streaming child runs; no reservation estimates. */
-    source: "reported";
-    tokens?: UsageBudgetMetricState;
-    costUsd?: UsageBudgetMetricState;
-    exhausted: boolean;
-    reason?: "tokens" | "costUsd";
-}
-export interface SingleResult {
-    /**
-     * Stable child identity within the foreground run. Pair with Details.runId for
-     * cross-run correlation. This is assigned in launch order, remains stable across
-     * partial progress snapshots and the final result, and is independent of the
-     * result row's array position.
-     */
-    index: number;
-    /** Workflow child key that owns this result when returned from workflow details. */
-    workflowKey?: string;
-    /** Workflow child run id that produced this result; resumed rounds share a session file but not a run id. */
-    runId?: string;
-    agent: string;
-    task: string;
-    /** Human-readable display name for the child's own session (agent + task
-     *  excerpt), when the launcher derived one. Display metadata only. */
-    sessionName?: string;
-    /** Resolved launch context for this child. */
-    context?: "fresh" | "fork";
-    exitCode: number;
-    processSignal?: string | null;
-    timeoutRecovery?: TimeoutRecoverySummary;
-    detached?: boolean;
-    detachedReason?: string;
-    interrupted?: boolean;
-    timedOut?: boolean;
-    stopped?: boolean;
-    turnBudget?: TurnBudgetState;
-    turnBudgetExceeded?: boolean;
-    wrapUpRequested?: boolean;
-    toolBudget?: ToolBudgetState;
-    toolBudgetBlocked?: boolean;
-    messages?: Message[];
-    usage: Usage;
-    model?: string;
-    /** Authoritative before/after Git evidence captured by a pane-native remote machine. */
-    nativeMachine?: {
-        provider: "herdr";
-        machineId: string;
-        initialGit?: HerdrRemoteGitStatus;
-        finalGit?: HerdrRemoteGitStatus;
-    };
-    /** Effective thinking level used by this foreground child, when known. */
-    thinking?: string;
-    requestedModel?: string;
-    controlEvents?: ControlEvent[];
-    error?: string;
-    /**
-     * True when the dispatch failed because the input exceeded the model's
-     * context window. Callers should treat this as
-     * a signal to reduce input size or re-decompose the task.
-     */
-    contextOverflow?: boolean;
-    sessionFile?: string;
-    skills?: string[];
-    skillsWarning?: string;
-    progress?: AgentProgress;
-    progressSummary?: ProgressSummary;
-    toolCalls?: ToolCallSummary[];
-    artifactPaths?: ArtifactPaths;
-    truncation?: TruncationResult;
-    finalOutput?: string;
-    /** Provenance-aware state for substantive child output, excluding synthetic lifecycle messages. */
-    outputState?: SubagentOutputState;
-    /** True when the output is unfinished streamed text recovered after a timeout or child error. */
-    outputPartial?: boolean;
-    outputMode?: OutputMode;
-    savedOutputPath?: string;
-    outputReference?: SavedOutputReference;
-    outputSaveError?: string;
-    /** Best-effort metadata persistence failure; execution and receipt publication continue. */
-    metadataSaveError?: string;
-    structuredOutput?: unknown;
-    structuredOutputFailed?: boolean;
-    structuredOutputPath?: string;
-    structuredOutputSchemaPath?: string;
-    acceptance?: AcceptanceLedger;
-    agentContract?: AgentContract;
-    launchContractDigest?: string;
-    launchResolvedExtensions?: LaunchResolvedChildExtensions;
-    runtimeAcknowledgedExtensions?: RuntimeAcknowledgedChildExtensions;
-    execution?: ExecutionProjection;
-    review?: ReviewProjection;
-    effects?: EffectsProjection;
-    transcriptPath?: string;
-    transcriptError?: string;
-    children?: NestedRunSummary[];
-    watchdog?: ChildWatchdogProgress;
-    capabilityCeiling?: ResolvedSubagentCapabilityCeiling;
-    capabilityAudit?: SubagentCapabilityAudit;
-    runner?: ExternalCliRunnerStatus | ExternalJobRunnerStatus;
-    externalProcess?: ExternalProcessStatus;
-}
-export interface SpawnBudgetGrant {
-    sessionId: string;
-    amount: number;
-    grantedAt: number;
-    previousLimit: number;
-    limit: number;
-}
-export interface SpawnBudgetSnapshot {
-    used: number;
-    configuredLimit: number | null;
-    granted: number;
-    limit: number | null;
-    remaining: number | null;
-    grantRemaining: number | null;
-    grantHistory: SpawnBudgetGrant[];
-}
-/** Slim per-child projection of a terminal result payload, safe to surface in tool_result details. */
-export interface WaitCompletionChild {
-    agent?: string;
-    /** Child run identity where the producer records one (workflow children); artifact files are keyed by it. */
-    runId?: string;
-    /** Bounded accounting projection used by /subagent-cost after async completion. */
-    usage?: Usage;
-    /** Persisted Pi child session when available. */
-    sessionFile?: string;
-    success?: boolean;
-    outputState?: SubagentOutputState;
-    /** True when the output is unfinished streamed text recovered after a timeout or child error. */
-    outputPartial?: boolean;
-    structuredOutput?: unknown;
-    structuredOutputPath?: string;
-    error?: string;
-    model?: string;
-    contextOverflow?: boolean;
-    artifactPaths?: Partial<ArtifactPaths>;
-    timeoutRecovery?: TimeoutRecoveryProjection;
-}
-/**
- * Terminal completion observed for a run a bg_wait call covered. Carries run
- * identity and the artifact trail; output text stays in the tool result content.
- */
-export interface WaitCompletion {
-    runId: string;
-    workflowReceiptPath?: string;
-    agent?: string;
-    mode?: string;
-    state?: string;
-    success?: boolean;
-    /** Versioned bounded output archive retained with the durable completion replay. */
-    archivePath?: string;
-    results?: WaitCompletionChild[];
-    workflowChildren?: WorkflowChildSummary;
-}
-export interface AgentCapabilitiesSnapshot {
-    agents: AgentCapabilityRow[];
-    restrictedCount: number;
-    capabilityCeilingSources?: string[];
-}
-export interface AgentCapabilityRow {
-    name: string;
-    description: string;
-    source: "builtin" | "package" | "user" | "project" | "runtime";
-    executable: boolean;
-    restrictionSources?: string[];
-    aliases?: string[];
-    runner: {
-        type: "pi";
-    } | {
-        type: "external-cli";
-        adapter?: string;
-        command: string;
-        machine?: string;
-        available: boolean;
-        unavailableReason?: string;
-        capabilities: ExternalCliCapabilities;
-    } | {
-        type: "external-job";
-        provider: string;
-        available?: boolean;
-        capabilities: ExternalJobRunnerStatus["capabilities"];
-    };
-    tools: {
-        ambient: boolean;
-        names: string[];
-        excludeTools?: string[];
-        mcpDirectTools: string[];
-        mutationTools?: string[];
-    };
-    model?: {
-        value?: string;
-        thinking?: string | false;
-    };
-    execution?: {
-        defaultAsync?: boolean;
-        timeoutMs?: number;
-    };
-    acceptance?: {
-        policy?: AcceptanceInput;
-        role?: AcceptanceRole;
-    };
-    output?: {
-        path?: string;
-        mode?: OutputMode;
-    };
-    extensions?: {
-        names?: string[];
-        subagentOnly?: string[];
-        skills?: string[];
-    };
-}
-export interface Details {
-    commands?: import("../runs/shared/child-commands.ts").ChildCommandSnapshot[];
-    mode: SubagentResultMode | "management";
-    workflowReceiptPath?: string;
-    runId?: string;
-    /** Host tool-call id retained when it differs from the internal run id. */
-    toolCallId?: string;
-    /** Run-level context summary. "mixed" when children resolved to different modes. */
-    context?: "fresh" | "fork" | "mixed";
-    results: SingleResult[];
-    workflowChildren?: WorkflowChildSummary;
-    workflowTerminalProof?: WorkflowTerminalProof;
-    /**
-     * Terminal completion payloads for runs this bg_wait call observed
-     * finishing. Async completions travel as result files that are consumed and
-     * deleted after text delivery, so without this field their run and artifact
-     * identity never reaches tool_result details.
-     */
-    completions?: WaitCompletion[];
-    wait?: {
-        reason: "window_elapsed";
-        timedOut: true;
-        activeRunIds: string[];
-        activeProviderItems: Array<{
-            provider: string;
-            id: string;
-        }>;
-    } | {
-        /** Non-terminal yield for a supervisor request or a user message; tracked work remains active. */
-        reason: "supervisor_request" | "user_input";
-        timedOut: false;
-        activeRunIds: string[];
-        activeProviderItems: Array<{
-            provider: string;
-            id: string;
-        }>;
-    };
-    controlEvents?: ControlEvent[];
-    steering?: SteerActionResult;
-    asyncId?: string;
-    background?: boolean;
-    asyncDir?: string;
-    timeoutMs?: number;
-    deadlineAt?: number;
-    timedOut?: boolean;
-    stopped?: boolean;
-    toolBudget?: ResolvedToolBudget;
-    usageBudget?: UsageBudgetState;
-    progress?: AgentProgress[];
-    progressSummary?: ProgressSummary;
-    artifacts?: {
-        dir: string;
-        files: ArtifactPaths[];
-    };
-    truncation?: {
-        truncated: boolean;
-        originalBytes?: number;
-        originalLines?: number;
-        artifactPath?: string;
-    };
-    chainAgents?: string[];
-    totalSteps?: number;
-    currentStepIndex?: number;
-    workflowGraph?: WorkflowGraphSnapshot;
-    /** Validated, display-only fanout plan supplied with a workflow launch. */
-    preflight?: WorkflowPreflight;
-    preflightWarnings?: string[];
-    outputs?: ChainOutputMap;
-    totalChildUsage?: Usage;
-    totalCost?: CostSummary;
-    spawnBudget?: SpawnBudgetSnapshot;
-    runFanoutBudget?: RunFanoutBudgetSnapshot;
-    runFanoutRejection?: RunFanoutRejection;
-    activeAsyncCapacity?: ActiveAsyncCapacitySnapshot;
-    agentCapabilities?: AgentCapabilitiesSnapshot;
-    capabilityCeiling?: ResolvedSubagentCapabilityCeiling;
-    capabilityAudit?: SubagentCapabilityAudit;
-    parallelHandoff?: ParallelHandoffReference;
-    lifecycleStatus?: {
-        processTerminal?: ProcessTerminal;
-    };
-    launchContractDigest?: string;
-    launchResolvedExtensions?: LaunchResolvedChildExtensions;
-    runtimeAcknowledgedExtensions?: RuntimeAcknowledgedChildExtensions;
-    /** Original launch contract whose persisted session is being revived. */
-    sourceLaunchContractDigest?: string;
-    /** Durable mission attached to this run, when mission mode was explicitly used. */
-    missionId?: string;
-    missionPath?: string;
-    /** Non-fatal automatic mission persistence failure. */
-    missionWarning?: string;
-    mission?: MissionRecord;
-    workflow?: {
-        value?: unknown;
-        failureKind?: WorkflowScriptFailureKind;
-        args?: Record<string, unknown>;
-        argsDigest?: string;
-        /** SHA-256 of the workflow script source (async workflows). */
-        scriptDigest?: string;
-        /** Structured stop cause; set only when the owning extension runtime was replaced. */
-        stopCause?: "runtime-replaced";
-        /** Runtime-replaced workflow run whose finished children this run reused. */
-        reusedFrom?: string;
-        resource?: WorkflowResourceProvenance;
-        preflightWarnings?: string[];
-        trace: Array<{
-            operation: "run" | "status" | "steer" | "host";
-            key: string;
-            state: "started" | "completed" | "failed" | "detached" | "stopped" | "reused" | "queued" | "delivered" | "missed";
-            agent?: string;
-            runId?: string;
-            phase?: string;
-            label?: string;
-            durationMs?: number;
-            /** Internal provenance for a generated runs.lanes child key. */
-            generatedLaneKey?: string;
-            warning?: string;
-            error?: string;
-            /** Came from a previous runtime-replaced run of the same script and args; this run launched nothing. */
-            reused?: boolean;
-        }>;
-        emits: unknown[];
-        console: Array<{
-            level: "log" | "info" | "warn" | "error";
-            text: string;
-        }>;
-        /** Terminal keyed child receipt. Async workflows also persist it beside status.json. */
-        receipt?: WorkflowReceipt;
-    };
-    chatProgress?: {
-        mode: "off" | "live-card";
-        repoRelation: "same" | "other";
-        repoLabel?: string;
-    };
-    missions?: {
-        records?: MissionRecord[];
-        globalEntries?: GlobalMissionIndexRecord[];
-        warnings: string[];
-    };
-    /** Project-scoped recurring schedule records and run history for management actions. */
-    schedules?: {
-        records?: unknown[];
-        runs?: unknown[];
-    };
-}
-export interface ArtifactPaths {
-    inputPath: string;
-    outputPath: string;
-    jsonlPath: string;
-    transcriptPath: string;
-    metadataPath: string;
-}
-export type ArtifactDirPreference = "project" | "session" | "temp";
-export interface ArtifactConfig {
-    enabled: boolean;
-    dir?: ArtifactDirPreference;
-    includeInput: boolean;
-    includeOutput: boolean;
-    includeJsonl: boolean;
-    includeTranscript?: boolean;
-    includeMetadata: boolean;
-    cleanupDays: number;
-}
-export interface AsyncParallelGroupStatus {
-    start: number;
-    count: number;
-    stepIndex: number;
-}
-export type NestedRunState = "queued" | "running" | "complete" | "failed" | "partial" | "paused" | "stopped" | "rejected";
-export type NestedOwnerState = "live" | "gone" | "unknown";
-export interface NestedRunAddress {
-    id: string;
-    parentRunId: string;
-    parentStepIndex?: number;
-    parentAgent?: string;
-    depth: number;
-    path: Array<{
-        runId: string;
-        stepIndex?: number;
-        agent?: string;
-    }>;
-}
-export interface NestedStepSummary {
-    agent: string;
-    /** Human-readable display name for the child session, when derived at launch. */
-    sessionName?: string;
-    status: "pending" | "running" | "complete" | "completed" | "failed" | "partial" | "paused" | "stopped" | "rejected";
-    model?: string;
-    thinking?: string;
-    sessionFile?: string;
-    transcriptPath?: string;
-    transcriptError?: string;
-    activityState?: ActivityState;
-    lastActivityAt?: number;
-    currentTool?: string;
-    currentToolStartedAt?: number;
-    currentPath?: string;
-    turnCount?: number;
-    toolCount?: number;
-    startedAt?: number;
-    endedAt?: number;
-    error?: string;
-    watchdog?: ChildWatchdogProgress;
-    timedOut?: boolean;
-    stopped?: boolean;
-    turnBudget?: TurnBudgetState;
-    turnBudgetExceeded?: boolean;
-    wrapUpRequested?: boolean;
-    toolBudget?: ToolBudgetState;
-    toolBudgetBlocked?: boolean;
-    processTerminal?: ProcessTerminal;
-    launchResolvedExtensions?: LaunchResolvedChildExtensions;
-    runtimeAcknowledgedExtensions?: RuntimeAcknowledgedChildExtensions;
-    capabilityCeiling?: ResolvedSubagentCapabilityCeiling;
-    capabilityAudit?: SubagentCapabilityAudit;
-    children?: NestedRunSummary[];
-}
-export interface NestedRunSummary extends NestedRunAddress {
-    asyncDir?: string;
-    pid?: number;
-    sessionId?: string;
-    sessionFile?: string;
-    intercomTarget?: string;
-    ownerIntercomTarget?: string;
-    leafIntercomTarget?: string;
-    ownerState?: NestedOwnerState;
-    controlInbox?: string;
-    capabilityToken?: string;
-    mode?: SubagentRunMode;
-    processTerminal?: ProcessTerminal;
-    launchResolvedExtensions?: LaunchResolvedChildExtensions;
-    runtimeAcknowledgedExtensions?: RuntimeAcknowledgedChildExtensions;
-    capabilityCeiling?: ResolvedSubagentCapabilityCeiling;
-    capabilityAudit?: SubagentCapabilityAudit;
-    state: NestedRunState;
-    agent?: string;
-    /** Human-readable display name for the child session, when derived at launch. */
-    sessionName?: string;
-    agents?: string[];
-    model?: string;
-    thinking?: string;
-    currentStep?: number;
-    chainStepCount?: number;
-    parallelGroups?: AsyncParallelGroupStatus[];
-    steps?: NestedStepSummary[];
-    children?: NestedRunSummary[];
-    activityState?: ActivityState;
-    lastActivityAt?: number;
-    currentTool?: string;
-    currentToolStartedAt?: number;
-    currentPath?: string;
-    turnCount?: number;
-    toolCount?: number;
-    totalTokens?: TokenUsage;
-    totalCost?: CostSummary;
-    startedAt?: number;
-    endedAt?: number;
-    lastUpdate?: number;
-    timeoutMs?: number;
-    deadlineAt?: number;
-    timedOut?: boolean;
-    stopped?: boolean;
-    turnBudget?: TurnBudgetState;
-    turnBudgetExceeded?: boolean;
-    wrapUpRequested?: boolean;
-    toolBudget?: ToolBudgetState;
-    toolBudgetBlocked?: boolean;
-    error?: string;
-}
-export interface NestedRouteInfo {
-    rootRunId: string;
-    eventSink: string;
-    controlInbox: string;
-    capabilityToken: string;
-}
-export interface AsyncStartedEvent {
-    lifecycleArtifactVersion?: SubagentLifecycleArtifactVersion;
-    id?: string;
-    asyncDir?: string;
-    /** Parent-resolved launch directory, used as a trusted artifact root while this session is live. */
-    cwd?: string;
-    /** Parent-resolved child session root, used only while this session owns the live run. */
-    sessionRoot?: string;
-    pid?: number;
-    sessionId?: string;
-    completionOwnerId?: string;
-    mode?: SubagentRunMode;
-    agent?: string;
-    agents?: string[];
-    /** Redacted prompt marker for the first child task; workflow roots may omit this field. */
-    task?: string;
-    /** Redacted prompt marker for the workflow-level caller task or first-child fallback. */
-    goal?: string;
-    chain?: string[];
-    chainStepCount?: number;
-    parallelGroups?: AsyncParallelGroupStatus[];
-    workflowGraph?: WorkflowGraphSnapshot;
-    preflight?: WorkflowPreflight;
-    launchContractDigest?: string;
-    launchResolvedExtensions?: LaunchResolvedChildExtensions;
-    runtimeAcknowledgedExtensions?: RuntimeAcknowledgedChildExtensions;
-    usageBudget?: UsageBudgetState;
-    timeoutMs?: number;
-    deadlineAt?: number;
-    turnBudget?: TurnBudgetState;
-    nestedRoute?: NestedRouteInfo;
-    capabilityCeiling?: ResolvedSubagentCapabilityCeiling;
-    parentWorkflowRunId?: string;
-    workflowKey?: string;
-}
-export type AgentRunnerConfig = {
-    type: "pi";
-} | {
-    type: "external-cli";
-    adapter?: "codex-exec" | "codex-exec-writer" | "claude-code" | "claude-code-writer" | "cursor-agent" | "cursor-agent-writer";
-    command: string;
-    args?: string[];
-    promptDelivery?: "stdin";
-    capabilities?: ExternalCliCapabilityNarrowing;
-} | {
-    type: "external-job";
-    provider: string;
-    options?: Record<string, unknown>;
-};
-export type ExternalCliCapabilityNarrowing = Partial<Record<"steer" | "resume" | "structuredOutput" | "toolEvents" | "supervisor" | "forkContext" | "extensionBindings", false>>;
-export interface HerdrRemoteGitStatus {
-    head?: string;
-    branch?: string;
-    dirty?: boolean;
-}
-/** A Herdr saved SSH machine resolved for one launch. `cwd` is the directory on that machine. */
-export interface HerdrMachineReference {
-    provider: "herdr";
-    id: string;
-    label?: string;
-    target: string;
-    session?: string;
-    cwd: string;
-}
-export interface ExternalCliMachineStatus extends HerdrMachineReference {
-    remoteGit?: HerdrRemoteGitStatus;
-}
-export interface ExternalCliCapabilities {
-    stop: true;
-    steer: false;
-    resume: false;
-    structuredOutput: false;
-    toolEvents: false;
-    supervisor: "unsupported";
-    forkContext: false;
-    extensionBindings: false;
-}
-export interface ExternalCliReceiptMetadata {
-    adapter: {
-        id: "external-cli" | "codex-exec" | "codex-exec-writer" | "claude-code" | "claude-code-writer" | "cursor-agent" | "cursor-agent-writer" | "grok-build";
-        version: 1;
-        executionMode: "one-shot-stdin" | "one-shot-prompt-file";
-    };
-    capabilities: ExternalCliCapabilities;
-    machine?: ExternalCliMachineStatus;
-    safety?: {
-        sandbox: "read-only";
-        approvalPolicy: "never";
-        ephemeral: true;
-    } | {
-        access: "workspace-write";
-        sandbox: "workspace-write";
-        approvalPolicy: "never";
-        ephemeral: true;
-    } | {
-        permissionMode: "plan";
-        tools: "none";
-        mcp: "empty-strict";
-        settingSources: "none";
-        sessionPersistence: false;
-    } | {
-        access: "read-only";
-        authentication: "existing-cli-required";
-        permissionMode: "plan";
-        tools: "none";
-        mcp: "empty-strict";
-        settingSources: "user";
-        userSettingsTrust: "required";
-        sessionPersistence: false;
-    } | {
-        access: "workspace-write";
-        authentication: "existing-cli-required";
-        permissionMode: "acceptEdits";
-        tools: "Read,Write,Edit,Glob,Grep";
-        mcp: "empty-strict";
-        settingSources: "user";
-        userSettingsTrust: "required";
-        sessionPersistence: false;
-    } | {
-        access: "read-only";
-        authentication: "cursor-api-key-or-existing-login";
-        mode: "ask";
-        sandbox: "enabled";
-        workspaceTrust: "existing-required";
-        sessionReuse: false;
-    } | {
-        access: "workspace-write";
-        authentication: "cursor-api-key-or-existing-login";
-        mode: "print";
-        sandbox: "enabled";
-        workspaceTrust: "existing-required";
-        sessionReuse: false;
-    };
-    outputArtifacts?: {
-        stdoutPath?: string;
-        stderrPath?: string;
-        finalOutputPath?: string;
-    };
-    handoff: {
-        mode: "fresh";
-    };
-    supervisor: {
-        mode: "unsupported";
-        reason: string;
-    };
-    nonResumableReason: string;
-}
-export interface ExternalCliRunnerStatus {
-    type: "external-cli";
-    command: string;
-    args: string[];
-    promptDelivery: "stdin" | "prompt-file";
-    adapter: ExternalCliReceiptMetadata["adapter"];
-    safety?: ExternalCliReceiptMetadata["safety"];
-    capabilities: ExternalCliCapabilities;
-    unsupportedReasons: Record<Exclude<keyof ExternalCliCapabilities, "stop">, string>;
-    nonResumableReason: string;
-    machine?: HerdrMachineReference;
-}
-export interface ExternalJobRunnerStatus {
-    type: "external-job";
-    provider: string;
-    options: Record<string, unknown>;
-    capabilities: {
-        stop: false;
-        steer: false;
-        resume: false;
-        structuredOutput: false;
-        toolEvents: false;
-    };
-}
-export interface ExternalJobStatus {
-    provider: string;
-    providerJobId?: string;
-    promptDigest: string;
-    operation?: "start" | "follow-up";
-    sourceRunId?: string;
-    sourceStepIndex?: number;
-    parentProviderJobId?: string;
-    requestId?: string;
-    requestDigest?: string;
-    options: Record<string, unknown>;
-    handleUrl?: string;
-    conversationUrl?: string;
-    resultArtifactPath?: string;
-    state: "queued" | "running" | "completed" | "failed" | "stopped" | "blocked";
-    failureCode?: string;
-    failureMessage?: string;
-    blockingJobId?: string;
-    startedAt?: number;
-    updatedAt?: number;
-}
-export interface ExternalProcessStatus {
-    pid?: number;
-    startedAt: number;
-    endedAt?: number;
-    durationMs?: number;
-    exitCode?: number | null;
-    processSignal?: string | null;
-    stdoutPath: string;
-    stderrPath: string;
-    finalOutputPath?: string;
-    stdoutBytes?: number;
-    stderrBytes?: number;
-    stdoutTruncated?: boolean;
-    stderrTruncated?: boolean;
-    machine?: ExternalCliMachineStatus;
-}
-export interface AsyncStatus {
-    /** Exact reference returned by successful current workflow receipt publication. */
-    workflowReceiptPath?: string;
-    lifecycleArtifactVersion?: SubagentLifecycleArtifactVersion;
-    runId: string;
-    /** Parent Pi process/window that owns local completion delivery. */
-    completionOwnerId?: string;
-    /** Host tool-call id retained when it differs from the internal run id. */
-    toolCallId?: string;
-    sessionId?: string;
-    mode: SubagentRunMode;
-    context?: "fresh" | "fork" | "mixed";
-    isNested?: boolean;
-    state: "queued" | "running" | "complete" | "failed" | "partial" | "paused" | "stopped" | "rejected";
-    /** Display-only dismissal marker for a reload-orphaned workflow. */
-    displayDismissedAt?: number;
-    error?: string;
-    activityState?: ActivityState;
-    lastActivityAt?: number;
-    currentTool?: string;
-    currentToolStartedAt?: number;
-    currentPath?: string;
-    turnCount?: number;
-    toolCount?: number;
-    steering?: SteeringStatus;
-    startedAt: number;
-    endedAt?: number;
-    lastUpdate?: number;
-    timeoutMs?: number;
-    deadlineAt?: number;
-    timedOut?: boolean;
-    stopped?: boolean;
-    turnBudget?: TurnBudgetState;
-    turnBudgetExceeded?: boolean;
-    wrapUpRequested?: boolean;
-    toolBudget?: ToolBudgetState;
-    toolBudgetBlocked?: boolean;
-    usageBudget?: UsageBudgetState;
-    pid?: number;
-    /** Linux PID namespace identity used to scope liveness probes. */
-    pidNamespaceScope?: string;
-    cwd?: string;
-    /** User-configured launcher that wrapped the background runner (argv only, never environment). */
-    launcher?: RunnerLauncher;
-    /** Parent-resolved child session root retained for trusted restored transcript lookup. */
-    sessionRoot?: string;
-    currentStep?: number;
-    chainStepCount?: number;
-    pendingAppends?: number;
-    parallelGroups?: AsyncParallelGroupStatus[];
-    workflowGraph?: WorkflowGraphSnapshot;
-    preflight?: WorkflowPreflight;
-    processTerminal?: ProcessTerminal;
-    runFanoutBudget?: RunFanoutBudgetSnapshot;
-    runFanoutBudgetDescriptor?: RunFanoutBudgetDescriptor;
-    launchContractDigest?: string;
-    launchResolvedExtensions?: LaunchResolvedChildExtensions;
-    runtimeAcknowledgedExtensions?: RuntimeAcknowledgedChildExtensions;
-    capabilityCeiling?: ResolvedSubagentCapabilityCeiling;
-    /** Parent admission authority before the selected workflow child's descendant restrictions. */
-    admissionCapabilityCeiling?: ResolvedSubagentCapabilityCeiling;
-    capabilityAudit?: SubagentCapabilityAudit;
-    workflow?: Details["workflow"];
-    workflowChildren?: WorkflowChildSummary;
-    parentWorkflowRunId?: string;
-    workflowKey?: string;
-    lane?: WorkflowLaneMetadata;
-    /** Set when a durable schedule launched this run, so completions can name their origin. */
-    scheduleOrigin?: ScheduleOrigin;
-    steps?: Array<{
-        /** Stable caller-facing child identity for inspect/status/stop. */
-        childId?: string;
-        agent: string;
-        /** Human-readable display name for the child session, when derived at launch. */
-        sessionName?: string;
-        runner?: ExternalCliRunnerStatus | ExternalJobRunnerStatus;
-        externalProcess?: ExternalProcessStatus;
-        externalJob?: ExternalJobStatus;
-        /** Resolved launch context for this child step. */
-        context?: "fresh" | "fork";
-        /** Short caller-facing task/goal shown in fleet surfaces when available. */
-        description?: string;
-        phase?: string;
-        label?: string;
-        workflowKey?: string;
-        lane?: WorkflowLaneMetadata;
-        /** Display-only worktree path copied at launch; handoff remains authoritative. */
-        worktreePath?: string;
-        /** Display-only branch copied at launch; handoff remains authoritative. */
-        branch?: string;
-        /** Display-only provisioning provider copied at launch; handoff remains authoritative. */
-        provider?: ManagedWorktreeProvider;
-        /** Display-only naming evidence copied at launch; handoff remains authoritative. */
-        naming?: WorktreeNaming;
-        /** Child run identity for workflow capacity reconciliation. */
-        runId?: string;
-        /** True only when this workflow child owns a detached async runner. */
-        async?: boolean;
-        parentWorkflowRunId?: string;
-        outputName?: string;
-        structured?: boolean;
-        status: "pending" | "running" | "complete" | "completed" | "failed" | "partial" | "paused" | "stopped" | "rejected";
-        /** Workflow child result reused from a previous runtime-replaced run; the child was not re-run. */
-        reused?: boolean;
-        stopRequested?: boolean;
-        stopRequestedAt?: number;
-        children?: NestedRunSummary[];
-        sessionFile?: string;
-        transcriptPath?: string;
-        transcriptError?: string;
-        activityState?: ActivityState;
-        lastActivityAt?: number;
-        currentTool?: string;
-        currentToolArgs?: string;
-        currentToolStartedAt?: number;
-        currentPath?: string;
-        recentTools?: Array<{
-            tool: string;
-            args: string;
-            endMs: number;
-        }>;
-        recentOutput?: string[];
-        turnCount?: number;
-        toolCount?: number;
-        startedAt?: number;
-        endedAt?: number;
-        durationMs?: number;
-        exitCode?: number | null;
-        timedOut?: boolean;
-        timeoutRecovery?: TimeoutRecoverySummary;
-        stopped?: boolean;
-        turnBudget?: TurnBudgetState;
-        turnBudgetExceeded?: boolean;
-        wrapUpRequested?: boolean;
-        toolBudget?: ToolBudgetState;
-        toolBudgetBlocked?: boolean;
-        tokens?: TokenUsage;
-        skills?: string[];
-        model?: string;
-        /** Model the child was launched on, recorded when its replies reported a different `model`; revival uses it. */
-        launchModel?: string;
-        thinking?: string;
-        contextLimit?: number;
-        thinkingCeiling?: ThinkingLevel;
-        requestedModel?: string;
-        /** True when the child input exceeded the model context window. */
-        contextOverflow?: boolean;
-        totalCost?: CostSummary;
-        steering?: SteeringStatus;
-        error?: string;
-        structuredOutput?: unknown;
-        structuredOutputPath?: string;
-        structuredOutputSchemaPath?: string;
-        acceptance?: AcceptanceLedger;
-        agentContract?: AgentContract;
-        launchContractDigest?: string;
-        launchResolvedExtensions?: LaunchResolvedChildExtensions;
-        runtimeAcknowledgedExtensions?: RuntimeAcknowledgedChildExtensions;
-        execution?: ExecutionProjection;
-        review?: ReviewProjection;
-        effects?: EffectsProjection;
-        watchdog?: ChildWatchdogProgress;
-        processTerminal?: ProcessTerminal;
-        capabilityCeiling?: ResolvedSubagentCapabilityCeiling;
-        capabilityAudit?: SubagentCapabilityAudit;
-    }>;
-    sessionDir?: string;
-    outputFile?: string;
-    totalTokens?: TokenUsage;
-    totalCost?: CostSummary;
-    sessionFile?: string;
-    outputs?: ChainOutputMap;
-    parallelHandoff?: ParallelHandoffReference;
-}
-export type AsyncJobStep = Omit<NonNullable<AsyncStatus["steps"]>[number], "timeoutRecovery"> & {
-    index?: number;
-    description?: string;
-    timeoutRecovery?: TimeoutRecoveryProjection;
-};
-export interface AsyncJobState {
-    asyncId: string;
-    asyncDir: string;
-    /** Host tool-call id retained when it differs from the internal run id. */
-    toolCallId?: string;
-    /** Parent-resolved launch directory retained for trusted live artifact lookup. */
-    cwd?: string;
-    /** Parent-resolved child session root retained for trusted live transcript lookup. */
-    sessionRoot?: string;
-    status: "queued" | "running" | "complete" | "failed" | "partial" | "paused" | "stopped" | "rejected";
-    /** Short caller-facing task/goal shown in fleet surfaces when available. */
-    description?: string;
-    pid?: number;
-    sessionId?: string;
-    completionOwnerId?: string;
-    activityState?: ActivityState;
-    lastActivityAt?: number;
-    currentTool?: string;
-    currentToolStartedAt?: number;
-    currentPath?: string;
-    turnCount?: number;
-    toolCount?: number;
-    steering?: SteeringStatus;
-    mode?: SubagentRunMode;
-    /** Run-level context summary derived from step contexts. */
-    context?: "fresh" | "fork" | "mixed";
-    agents?: string[];
-    currentStep?: number;
-    chainStepCount?: number;
-    parallelGroups?: AsyncParallelGroupStatus[];
-    /** Bounded host-owned CI/gate nodes loaded from the workflow status graph. */
-    hostSteps?: HostStepNode[];
-    /** Full bounded workflow plan, including not-yet-materialized stages. */
-    workflowGraph?: WorkflowGraphSnapshot;
-    steps?: AsyncJobStep[];
-    preflight?: WorkflowPreflight;
-    stepsTotal?: number;
-    runningSteps?: number;
-    completedSteps?: number;
-    hasParallelGroups?: boolean;
-    activeParallelGroup?: boolean;
-    startedAt?: number;
-    updatedAt?: number;
-    timeoutMs?: number;
-    deadlineAt?: number;
-    timedOut?: boolean;
-    stopped?: boolean;
-    turnBudget?: TurnBudgetState;
-    turnBudgetExceeded?: boolean;
-    wrapUpRequested?: boolean;
-    toolBudget?: ToolBudgetState;
-    toolBudgetBlocked?: boolean;
-    sessionDir?: string;
-    outputFile?: string;
-    totalTokens?: TokenUsage;
-    totalCost?: CostSummary;
-    usageBudget?: UsageBudgetState;
-    sessionFile?: string;
-    controlEventCursor?: number;
-    nestedRoute?: NestedRouteInfo;
-    nestedChildren?: NestedRunSummary[];
-    parentWorkflowRunId?: string;
-    workflowKey?: string;
-    workflow?: Details["workflow"];
-    workflowChildren?: WorkflowChildSummary;
-    lane?: WorkflowLaneMetadata;
-}
-export interface ForegroundResumeChild {
-    agent: string;
-    /** Human-readable display name for the child session, when derived at launch. */
-    sessionName?: string;
-    index: number;
-    context?: "fresh" | "fork";
-    sessionFile?: string;
-    model?: string;
-    thinking?: string;
-    status: SubagentResultStatus;
-    activityState?: ActivityState;
-    lastActivityAt?: number;
-    currentTool?: string;
-    currentToolStartedAt?: number;
-    currentPath?: string;
-    turnCount?: number;
-    tokens?: number;
-    window?: number;
-    windowPeak?: number;
-    toolCount?: number;
-    exitCode?: number;
-    error?: string;
-    finalOutput?: string;
-    outputState?: SubagentOutputState;
-    /** True when the output is unfinished streamed text recovered after a timeout or child error. */
-    outputPartial?: boolean;
-    outputMode?: OutputMode;
-    savedOutputPath?: string;
-    outputSaveError?: string;
-    artifactPaths?: ArtifactPaths;
-    transcriptPath?: string;
-    transcriptError?: string;
-    detachedReason?: string;
-    acceptance?: AcceptanceLedger;
-    agentContract?: AgentContract;
-    /** Private bounded launch fields needed to preserve the child contract on resume. */
-    resumeContract?: {
-        modelResponseAliases?: Record<string, string[]>;
-        outputSchema?: JsonSchemaObject | false;
-        agentContract?: AgentContract;
-        acceptance?: AcceptanceInput;
-        output?: string | boolean;
-        outputMode?: OutputMode;
-    };
-    launchContractDigest?: string;
-    /** Private retained launch authority. Never project into status or result output. */
-    extensionBindings?: ExtensionBindings;
-    requiredExtensions?: RequiredChildExtensionSnapshot;
-    launchResolvedExtensions?: LaunchResolvedChildExtensions;
-    runtimeAcknowledgedExtensions?: RuntimeAcknowledgedChildExtensions;
-    execution?: ExecutionProjection;
-    review?: ReviewProjection;
-    effects?: EffectsProjection;
-    capabilityCeiling?: ResolvedSubagentCapabilityCeiling;
-    capabilityAudit?: SubagentCapabilityAudit;
-    updatedAt?: number;
-}
-export interface ForegroundResumeRun {
-    runId: string;
-    mode: SubagentRunMode;
-    cwd: string;
-    /** Originating parent session. Detached exits can outlive the active session. */
-    sessionId?: string;
-    updatedAt: number;
-    children: ForegroundResumeChild[];
-}
-export interface ForegroundChildControl {
-    index: number;
-    agent: string;
-    /** Human-readable display name for the child's session, when derived at launch. */
-    sessionName?: string;
-    description?: string;
-    startedAt: number;
-    updatedAt: number;
-    currentActivityState?: ActivityState;
-    lastActivityAt?: number;
-    currentTool?: string;
-    currentToolStartedAt?: number;
-    currentPath?: string;
-    turnCount?: number;
-    tokens?: number;
-    inputTokens?: number;
-    outputTokens?: number;
-    window?: number;
-    windowPeak?: number;
-    model?: string;
-    thinking?: string;
-    toolCount?: number;
-    interrupt?: () => boolean;
-    detach?: () => boolean;
-    /** Steer the live in-process child session; undefined until the session exists. */
-    steer?: (input: ForegroundSteerInput) => Promise<ForegroundSteerOutcome>;
-}
-export interface ForegroundSteerInput {
-    message: string;
-    mode?: "steer" | "follow_up" | "auto";
-}
-export interface ForegroundSteerOutcome {
-    state: "delivered" | "queued" | "failed";
-    reason?: string;
-}
-export interface ForegroundRunControl {
-    runId: string;
-    /** Workflow shell that owns this live foreground child, when applicable. */
-    parentWorkflowRunId?: string;
-    /** Stable workflow lane key for this live foreground child. */
-    workflowKey?: string;
-    /** Originating parent session; required for public fleet projection. */
-    sessionId?: string;
-    mode: SubagentRunMode;
-    startedAt: number;
-    updatedAt: number;
-    /** Effective working directory used to resolve live transcript artifacts. */
-    cwd?: string;
-    currentAgent?: string;
-    /** Human-readable display name for the current child session, when derived at launch. */
-    sessionName?: string;
-    currentIndex?: number;
-    /** Short caller-facing task/goal shown in fleet surfaces when available. */
-    description?: string;
-    currentActivityState?: ActivityState;
-    lastActivityAt?: number;
-    currentTool?: string;
-    currentToolStartedAt?: number;
-    currentPath?: string;
-    turnCount?: number;
-    tokens?: number;
-    inputTokens?: number;
-    outputTokens?: number;
-    window?: number;
-    windowPeak?: number;
-    model?: string;
-    thinking?: string;
-    toolCount?: number;
-    /** Independently tracked children for foreground parallel work and fleet inspection. */
-    activeChildren?: Map<number, ForegroundChildControl>;
-    /** Live Prompt Audit redo callback. It is current-session memory only. */
-    promptAuditRedo?: (index: number, guidance: string) => Promise<{
-        text: string;
-        isError?: boolean;
-    }>;
-    /** Memory-only source run for Prompt Audit redo. */
-    sourceRunId?: string;
-    /** Memory-only replacement run started by Prompt Audit redo. */
-    supersededByRunId?: string;
-    /** Scheduling owners that may still launch another child. Removal is safe only at zero. */
-    schedulingOwners?: number;
-    nestedRoute?: NestedRouteInfo;
-    nestedChildren?: NestedRunSummary[];
-    interrupt?: () => boolean;
-    detach?: () => boolean;
-    steer?: ForegroundChildControl["steer"];
-    /** Set while a detached child runs: records it as stopped, then aborts it, when this runtime is replaced. */
-    stopForRuntimeReplacement?: () => void;
-}
-export interface WaitSubscriptionRecord {
-    version: 1;
-    token: string;
-    sessionId: string;
-    targetKind: "async" | "foreground";
-    runId: string;
-    requestedId: string;
-    createdAt: number;
-    expiresAt: number;
-}
-export interface ActiveAsyncCapacitySnapshot {
-    used: number;
-    /** Zero means the opt-in cap is disabled. */
-    limit: number;
-}
-export interface SubagentState {
-    baseCwd: string;
-    currentSessionId: string | null;
-    /** Exact SDK runtime session ID for supervisor ownership; never a session file path. */
-    supervisorOwnerSessionId?: string | null;
-    /** Session for which active status projections were restored successfully. */
-    statusProjectionSessionId?: string | null;
-    /** Reload-stable identity for this parent Pi process/window. */
-    completionOwnerId?: string;
-    /** Runtime-owned artifact resolution inputs used by Fleet transcript targeting. */
-    artifactDirPreference?: ArtifactDirPreference;
-    /** Runtime authority snapshot used by optional inspector controls. */
-    authorityPolicy?: AuthorityPolicyConfig;
-    /** Runtime mission-store snapshot used by optional inspector context. */
-    missionStoreConfig?: MissionStoreConfig;
-    parentSessionFile?: string | null;
-    /** Extension-owned roots trusted for child session transcript reads. */
-    trustedSessionRoots?: string[];
-    /** Pi sessions base that caps exact runtime-recorded session file trust. */
-    trustedSessionFileRoot?: string;
-    /** Live async session roots created by this parent executor, keyed by run id. */
-    liveAsyncSessionRoots?: Map<string, string>;
-    /** Foreground nested routes retained after their direct parent settles, keyed by root run id. */
-    retainedForegroundNestedRoutes?: Map<string, NestedRouteInfo>;
-    /** Lookup authority outlives live controls, but never crosses the owning session. */
-    retainedNestedLookupRoutes?: {
-        sessionId: string;
-        routes: Map<string, NestedRouteInfo>;
-    };
-    /** Last valid parent session model observed for this session; used when continuation contexts omit ctx.model. */
-    lastParentModel?: {
-        provider: string;
-        id: string;
-    };
-    subagentInProgress?: boolean;
-    subagentSpawns?: {
-        sessionId: string | null;
-        count: number;
-        configuredLimit?: number | null;
-        granted?: number;
-        grantHistory?: SpawnBudgetGrant[];
-    };
-    /** Current-session top-level async capacity projection. */
-    activeAsyncCapacity?: ActiveAsyncCapacitySnapshot;
-    /** Herdr project panes opened by this Pi session, keyed by project root. */
-    herdrProjectPanes?: Map<string, HerdrProjectPaneSnapshot>;
-    asyncJobs: Map<string, AsyncJobState>;
-    /** Current-session active and recent async runs for the native fleet inspector. */
-    fleetJobs?: Map<string, AsyncJobState>;
-    /** Suppress dynamic status widgets while the fleet overlay owns the viewport. */
-    fleetInspectorOpen?: boolean;
-    /** Temporarily suppress dynamic widgets while Pi compacts the session. */
-    widgetsSuspended?: boolean;
-    foregroundRuns?: Map<string, ForegroundResumeRun>;
-    foregroundControls: Map<string, ForegroundRunControl>;
-    lastForegroundControlId: string | null;
-    cleanupTimers: Map<string, ReturnType<typeof setTimeout>>;
-    lastUiContext: ExtensionContext | null;
-    poller: NodeJS.Timeout | null;
-    completionSeen: Map<string, number>;
-    /** Session-owned terminal result payloads observed by the result watcher, keyed by run id and pruned by the completion TTL. */
-    completedResults?: Map<string, {
-        sessionId: string;
-        seenAt: number;
-        completion: WaitCompletion;
-    }>;
-    watcher: FSWatcher | null;
-    watcherRestartTimer: ReturnType<typeof setTimeout> | null;
-    resultFileCoalescer: {
-        schedule(file: string, delayMs?: number): boolean;
-        clear(): void;
-    };
-    /** Current-session durable non-blocking wait registrations. */
-    waitSubscriptions?: Map<string, WaitSubscriptionRecord>;
-    /** Live in-process workflow controllers. Durable status remains on disk after settlement. */
-    workflowControllers?: Map<string, AbortController>;
-    /** Live in-process workflow child stoppers keyed by parent workflow run id. */
-    workflowChildStops?: Map<string, (childId: string, message?: string) => boolean>;
-}
-export interface HerdrProjectPaneSnapshot {
-    projectRoot: string;
-    bindingPath: string;
-    paneId: string;
-    openedAt: string;
-    lastFocusedAt?: string;
-    state: "open" | "stale";
-    agentStatus: string;
-    ownership: "verified" | "unknown" | "mismatch";
-    safeToClose: boolean;
-    refreshedAt: number;
-    summary?: string;
-    tabId?: string;
-    workspaceId?: string;
-    terminalTitle?: string;
-    staleReason?: string;
-}
-export type DisplayItem = {
-    type: "text";
-    text: string;
-} | {
-    type: "tool";
-    name: string;
-    args: Record<string, unknown>;
-};
-export interface ErrorInfo {
-    hasError: boolean;
-    exitCode?: number;
-    errorType?: string;
-    details?: string;
-}
-export interface IntercomEventBus {
-    on(channel: string, handler: (data: unknown) => void): () => void;
-    emit(channel: string, data: unknown): void;
-}
-export declare const INTERCOM_DETACH_REQUEST_EVENT = "pi-intercom:detach-request";
-export declare const INTERCOM_DETACH_RESPONSE_EVENT = "pi-intercom:detach-response";
-/** pi-intercom asks each session for a fixed intercom ID at session start; `claim(id)` answers synchronously. */
-export declare const INTERCOM_SESSION_IDENTITY_EVENT = "intercom:session-identity";
-export declare const SUBAGENT_ASYNC_STARTED_EVENT = "subagent:async-started";
-/** Launcher names are plain identifiers so they survive frontmatter rewrites without quoting. */
-export declare const RUNNER_LAUNCHER_NAME_PATTERN: RegExp;
-export declare const RUNNER_LAUNCHER_NAME_RULE = "must start with a letter or digit and use only letters, digits, '.', '_' or '-' (at most 128 characters)";
-export interface RunnerLauncher {
-    name: string;
-    argv: string[];
-}
-export declare const SUBAGENT_ASYNC_COMPLETE_EVENT = "subagent:async-complete";
-export declare const SUBAGENT_PROCESS_TERMINAL_EVENT = "subagent:process-terminal";
-export declare const SUBAGENT_FOREGROUND_COMPLETE_EVENT = "subagent:foreground-complete";
-export declare const SUBAGENT_CONTROL_EVENT = "subagent:control-event";
-export declare const SUBAGENT_CONTROL_INTERCOM_EVENT = "subagent:control-intercom";
-export declare const SUBAGENT_STEERING_NOTICE_EVENT = "subagent:steering-notice";
-export declare const SUBAGENT_CHILD_STATUS_EVENT = "subagent:child-status";
-export declare const SUBAGENT_RESULT_INTERCOM_EVENT = "subagent:result-intercom";
-export declare const SUBAGENT_RESULT_INTERCOM_DELIVERY_EVENT = "subagent:result-intercom-delivery";
-export interface SubagentChildStatusEvent {
-    type: "subagent.child-status";
-    version: 1;
-    runId: string;
-    childId: string;
-    status: "started" | "stopping" | "stopped";
-    ts: number;
-    reason?: string;
-    source?: "rpc" | "async";
-    asyncDir?: string;
-    stepIndex?: number;
-    agent?: string;
-    childRunId?: string;
-    workflowKey?: string;
-    phase?: string;
-    label?: string;
-}
-/** Live controls for one in-process foreground child session. */
-export interface ForegroundChildSessionControls {
-    steer: (text: string) => Promise<void>;
-    followUp: (text: string) => Promise<void>;
-    /** Abort the live child and report the run as stopped with `reason`. */
-    stop: (reason: string) => void;
-}
-export interface RunSyncOptions {
-    /** Exact discovery provenance for an unknown-agent error; omission uses defensive fallback discovery. */
-    unknownAgentDiagnosticContext?: import("../agents/agents.ts").UnknownAgentDiagnosticContext;
-    /** Session factory for the in-process child; defaults to the process-wide factory. */
-    childSessionFactory?: import("../runs/shared/child-session.ts").ChildSessionFactory;
-    /** Invoking parent registry inherited only by its local foreground launch. */
-    parentProviderRegistry?: import("../runs/shared/child-session.ts").ParentProviderRegistry;
-    /** The invoking session's project trust; undefined when the host has no trust concept. */
-    projectTrusted?: boolean;
-    /** The launching executor's own child runtime when it is itself an in-process child. */
-    childRuntime?: import("../runs/shared/child-runtime-config.ts").ChildRuntimeConfig;
-    /** Fires once the child session exists and can be steered. */
-    onChildSession?: (controls: ForegroundChildSessionControls) => void;
-    /** Opt-in global permission rules; missing tools remain allowed. */
-    permissions?: import("../runs/shared/permissions.ts").PermissionConfig;
-    /** Session id of the direct parent session for permission-system ask forwarding. */
-    parentSessionId?: string;
-    /** The parent session's file, recorded as a new child session's `parentSession` header. */
-    parentSessionFile?: string;
-    /** Resolved launch context for this child. */
-    context?: "fresh" | "fork";
-    cwd?: string;
-    /** Resolved pane-native saved-machine placement. */
-    machine?: HerdrMachineReference;
-    /** Explicit read override resolved by the remote ambient agent profile. */
-    remoteReads?: string[] | false;
-    /** Original cwd input retained for launch diagnostics. */
-    requestedCwd?: string;
-    signal?: AbortSignal;
-    /** Report a child ended by `signal` as stopped; set for workflow children, whose signal is the workflow's. */
-    abortedAsStopped?: boolean;
-    interruptSignal?: AbortSignal;
-    timeoutMs?: number;
-    deadlineAt?: number;
-    /** Per-call per-tool timeout (ms), resolved with the agent/config/environment ladder at execution. */
-    toolTimeoutMs?: number;
-    /** Raw global config.toolTimeoutMs, used by the per-child resolver. */
-    configToolTimeoutMs?: number;
-    usageBudget?: UsageBudgetConfig;
-    toolBudget?: ResolvedToolBudget;
-    allowZeroToolBudget?: boolean;
-    allowIntercomDetach?: boolean;
-    intercomEvents?: IntercomEventBus;
-    onUpdate?: (r: import("@earendil-works/pi-agent-core").AgentToolResult<Details>) => void;
-    /** Internal structured-delegation transport optimization: skip unchanged live snapshots. */
-    suppressUnchangedDelegationUpdates?: boolean;
-    onControlEvent?: (event: ControlEvent) => void;
-    /** Exposes a non-terminating detach callback while the child is active. */
-    onDetachReady?: (detach: (reason?: string) => boolean) => void;
-    /** Internal foreground receipt proposal; returns true only when the outer waiter accepted it. */
-    onDetachReceipt?: (result: SingleResult) => boolean;
-    /** Authoritative terminal result, emitted only after the full detached run finalizes. */
-    onDetachedExit?: (result: SingleResult) => void | Promise<void>;
-    controlConfig?: ResolvedControlConfig;
-    intercomSessionName?: string;
-    orchestratorIntercomTarget?: string;
-    maxOutput?: MaxOutputConfig;
-    artifactsDir?: string;
-    artifactConfig?: ArtifactConfig;
-    runId: string;
-    index?: number;
-    sessionDir?: string;
-    sessionFile?: string;
-    share?: boolean;
-    outputPath?: string;
-    outputClaimPath?: string;
-    outputMode?: OutputMode;
-    maxSubagentDepth?: number;
-    /** Effective parent wait-tool setting propagated to the child runtime. */
-    waitToolEnabled?: boolean;
-    /** Effective parent default wait window propagated to the child runtime. */
-    waitToolDefaultTimeoutMs?: number;
-    capabilityCeiling?: ResolvedSubagentCapabilityCeiling;
-    runFanoutBudget?: RunFanoutBudgetDescriptor;
-    nestedRoute?: NestedRouteInfo;
-    /** Override the agent's default model (format: "provider/id" or just "id") */
-    modelOverride?: string;
-    /** Opt into priority service tier for supported native OpenAI-Codex launches. */
-    fast?: boolean;
-    /** The override came from the running parent session, not configuration. */
-    modelOverrideFromParent?: boolean;
-    /** How the launch model was selected: explicit per-call, configured agent primary, or inherited parent. */
-    modelOrigin?: "explicit" | "inherited" | "configured";
-    /** Override the agent's default thinking level for this run */
-    thinkingOverride?: AgentConfig["thinking"];
-    thinkingCeiling?: ThinkingLevel;
-    requiredExtensions?: RequiredChildExtensionSnapshot;
-    extensionBindings?: ExtensionBindings;
-    /** Package-internal one-use authorization for one foreground workflow child. */
-    workflowChildPermitLaunch?: WorkflowChildPermitContext;
-    /** Registry models available for heuristic bare-model resolution */
-    availableModels?: Array<{
-        provider: string;
-        id: string;
-        fullId: string;
-        contextWindow?: number;
-    }>;
-    modelResponseAliases?: Record<string, string[]>;
-    /** Current parent-session provider to prefer for ambiguous bare model ids */
-    preferredModelProvider?: string;
-    /** Parent Pi event host used to snapshot runtime-registered MCP servers before child launch. */
-    runtimeSnapshotHost?: import("../runs/shared/mcp-direct-tool-allowlist.ts").McpRuntimeSnapshotHost;
-    /** Optional subagent model-scope enforcement. */
-    modelScope?: ModelScopeRule | ModelScopeRule[];
-    /** Skills to make available (overrides agent default if provided) */
-    skills?: string[];
-    structuredOutput?: {
-        schema: JsonSchemaObject;
-        schemaPath: string;
-        outputPath: string;
-        acceptanceReportPath?: string;
-        acceptanceReportRequired?: boolean;
-    };
-    agentContract?: AgentContract;
-    acceptance?: AcceptanceInput;
-    acceptanceContext?: {
-        mode?: SubagentRunMode;
-        async?: boolean;
-        dynamic?: boolean;
-        dynamicGroup?: boolean;
-    };
-    /** Private live callback for the exact child prompt after runtime acceptance injection. */
-    onEffectivePrompt?: (prompt: string) => void;
-    /** Internal lifecycle hook for the observer shared across retries of one logical child. */
-    onOrcaProgressTabCreated?: (tab: import("../runs/shared/orca-progress-tabs.ts").OrcaProgressTab) => void;
-}
-export type IntercomBridgeMode = "off" | "fork-only" | "always";
-export interface IntercomBridgeConfig {
-    mode?: IntercomBridgeMode;
-    instructionFile?: string;
-    /** Deliver grouped completion messages through an external acknowledged intercom listener. */
-    resultDelivery?: boolean;
-}
-interface TopLevelParallelConfig {
-    maxTasks?: number;
-    concurrency?: number;
-}
-interface ExtensionChainConfig {
-    dynamicFanout?: {
-        maxItems?: number;
-    };
-}
-export interface ProactiveSkillSubagentsConfig {
-    enabled?: boolean;
-    minReferences?: number;
-    maxRecommendations?: number;
-    preferredAgent?: string;
-}
-export type ToolDescriptionMode = "full" | "compact" | "custom";
-export type ToolActivationMode = "auto" | "dynamic" | "eager";
-export type InlineToolDisplay = "rich" | "summary";
-export interface ScheduledRunsConfig {
-    enabled?: boolean;
-    maxPending?: number;
-    /** Absolute or `~/` root for per-project durable schedules. */
-    storeRoot?: string;
-}
-export type FleetViewPlacement = "aboveEditor" | "belowEditor";
-export type AsyncWidgetLayout = "adaptive" | "rows";
-export declare const FLEET_KEYBINDING_ACTIONS: readonly ["close", "scrollUp", "scrollDown", "selectUp", "selectDown", "selectFirst", "selectLast", "pageUp", "pageDown", "refresh", "steer", "inspect", "stop", "toggleTools"];
-export type FleetKeybindingAction = typeof FLEET_KEYBINDING_ACTIONS[number];
-export type FleetKeybindingsConfig = Partial<Record<FleetKeybindingAction, string[]>>;
-export interface OrcaProgressTabsConfig {
-    /** Create one Orca observer tab per top-level subagent call. Experimental and opt-in. */
-    enabled?: boolean;
-}
-export interface MainWindowRendererConfig {
-    /** Unit of horizontal space in main chat subagent call/result rows. Omit to preserve current spacing. Set 0 for no extra padding. */
-    horizontalSpacing?: number;
-    /** Maximum collapsed rich-result rows. Expanded output is not capped. */
-    compactResultMaxLines?: number;
-}
-export interface ForkContextConfig {
-    /** Keep the complete fork by default, or summarize large text-only tool results before launch. */
-    mode?: "full" | "pruned";
-    /** Required pruning model when mode is "pruned". */
-    model?: string;
-}
-export interface ActiveAsyncCapacityConfig {
-    /** Reclaim failed runner slots after this age when process proof is unknown; false keeps strict retention. */
-    abandonedSlotReleaseAfterMs?: number | false;
-}
-export interface ExtensionConfig {
-    asyncByDefault?: boolean;
-    /** Set the context for launches that omit an explicit context. */
-    defaultSubagentContext?: "fresh" | "fork";
-    /** Configure how every resolved fork session is prepared before child spawn. */
-    forkContext?: ForkContextConfig;
-    /** Optional shortcut that detaches the active foreground single-subagent run. */
-    foregroundDetachShortcut?: string;
-    /** Show the Claude Code-style navigable fleet. Defaults to true. */
-    fleetView?: boolean;
-    /** Place the persistent FleetView above or below the editor. Defaults to belowEditor. */
-    fleetViewPlacement?: FleetViewPlacement;
-    /** Local keybindings for the full Fleet inspector. */
-    fleetKeybindings?: FleetKeybindingsConfig;
-    /** Show the under-editor async runs widget. Defaults to true, including when FleetView is enabled. */
-    asyncWidget?: boolean;
-    /** Start the under-editor async runs widget folded. Defaults to false. */
-    asyncWidgetCollapsed?: boolean;
-    /** Unfolded async runs widget layout: "adaptive" fits run details to the terminal height, "rows" shows one line per run. Defaults to "adaptive". */
-    asyncWidgetLayout?: AsyncWidgetLayout;
-    /** Report subagent run state to the terminal with OSC 7501. Defaults to true. */
-    programStatus?: boolean;
-    /** Add a short `active_subagents` system prompt section listing this session's active background runs. Defaults to false. */
-    activeRunsPrompt?: boolean;
-    /** Exact provider/model candidates mapped to operator-declared equivalent response IDs. Empty arrays add no accepted IDs. */
-    modelResponseAliases?: Record<string, string[]>;
-    /** Named argv prefixes for background runners; agents select one with `launcher: <name>`. User config only. */
-    runnerLaunchers?: Record<string, string[]>;
-    /** Tool description variant registered for the parent-facing subagent tool. Defaults to split metadata. */
-    toolDescriptionMode?: ToolDescriptionMode;
-    /** How a new parent session offers the subagent tool. Defaults to auto. */
-    toolActivation?: ToolActivationMode;
-    /** Keep a resumed session on the pi-subagents tool definitions and prompt text it already declared. Defaults to true. */
-    pinToolDeclarations?: boolean;
-    /** Opt-in feature groups removed from the subagent tool schema and rejected at every execution boundary. */
-    disabledFeatures?: SubagentFeature[];
-    /** Inline chat rendering for the subagent tool. Defaults to rich. */
-    inlineToolDisplay?: InlineToolDisplay;
-    /** Density controls for the main chat subagent call/result renderer. */
-    mainWindowRenderer?: MainWindowRendererConfig;
-    /** Experimental observer: mirror each native subagent's progress into a new Orca tab. */
-    orcaProgressTabs?: OrcaProgressTabsConfig;
-    forceTopLevelAsync?: boolean;
-    waitTool?: WaitToolConfig;
-    defaultSessionDir?: string;
-    singleRunOutputBaseDir?: string;
-    maxSubagentDepth?: number;
-    /** Optional cumulative session cap. Unset or 0 means unlimited. */
-    maxSubagentSpawnsPerSession?: number;
-    /** Cumulative logical-child cap for one top-level run tree. Defaults to 64. */
-    maxSubagentSpawnsPerRun?: number;
-    /** Optional active top-level async run cap per parent session. Unset or 0 means unlimited. */
-    maxActiveAsyncRunsPerSession?: number;
-    /** Active-capacity cleanup policy. */
-    capacity?: ActiveAsyncCapacityConfig;
-    /** Global cap on simultaneously-running subagent tasks within a single run. Defaults to 20. */
-    globalConcurrencyLimit?: number;
-    /**
-     * Global default runtime deadline in milliseconds. It replaces the built-in
-     * 30-minute backstop for single, parallel, and chain launches (foreground, plus
-     * plain single-agent async runs) when neither the call (`timeoutMs`/`maxRuntimeMs`)
-     * nor the selected agent provides a timeout. Explicit call values and agent
-     * frontmatter defaults still win. Composite async runs (chain/parallel/workflow)
-     * stay unbounded at the top level by design — their children are bounded individually.
-     * Must be a positive integer; invalid values are ignored.
-     */
-    timeoutMs?: number;
-    /**
-     * Optional hard per-tool-call timeout in milliseconds. Bounds a single
-     * subagent tool call inside the child; the run-level timeout remains
-     * authoritative. Known-fast built-in tools have a five-minute default when
-     * this is undefined. Precedence: call param > agent frontmatter > this config >
-     * PI_SUBAGENT_TOOL_TIMEOUT_MS. Must be a positive integer; invalid values
-     * are rejected with an error.
-     */
-    toolTimeoutMs?: number;
-    /**
-     * Global default for the async single-agent `checkpointBeforeDeadlineMs` launch option: the runner requests that
-     * the child checkpoint and stop this many milliseconds before its run deadline (best-effort). The call param wins; values that
-     * leave no run time before the checkpoint disarm it.
-     */
-    checkpointBeforeDeadlineMs?: number;
-    control?: ControlConfig;
-    completionBatch?: CompletionBatchConfig;
-    toolBudget?: ToolBudgetConfig;
-    /** Opt-in native tool permissions. Bash remains outside this policy. */
-    permissions?: import("../runs/shared/permissions.ts").PermissionConfig;
-    usageBudget?: UsageBudgetConfig;
-    parallel?: TopLevelParallelConfig;
-    chain?: ExtensionChainConfig;
-    worktreeSetupHook?: string;
-    worktreeSetupHookTimeoutMs?: number;
-    worktreeBaseDir?: string;
-    /** Enable managed worktrees when a launch does not provide an explicit value. */
-    worktree?: boolean;
-    /** Worktree allocator selection. Defaults to auto. */
-    worktreeProvider?: WorktreeProvider;
-    /** Namespace used by managed worktree branches. Defaults to pi-subagents/. */
-    worktreeBranchPrefix?: string;
-    /** Where to store subagent artifact files. Defaults to "session" (the pi session directory, or OS temp when unavailable). Set to "project" for cwd/.pi/subagents. */
-    artifactDir?: ArtifactDirPreference;
-    /** Artifact cleanup retention. Set cleanupDays to 0 to disable cleanup. */
-    artifactConfig?: Pick<ArtifactConfig, "cleanupDays">;
-    intercomBridge?: IntercomBridgeConfig;
-    /** Control how slow result-index scans are logged. Defaults to \"activity\".
-     *  - \"all\": log every slow scan, including scans that find nothing.
-     *  - \"activity\": log only slow scans that found or scheduled work. Silences
-     *    the periodic healthy rescan that inspects zero files while no async runs
-     *    are pending, which otherwise spams the session transcript.
-     *  - \"off\": never log slow result-index scans. */
-    resultScanLogging?: "all" | "activity" | "off";
-    proactiveSkillSubagents?: ProactiveSkillSubagentsConfig | false;
-    scheduledRuns?: ScheduledRunsConfig;
-    /** Durable mission behavior. Missions are automatic by default; set enabled:false to disable auto-create. Explicit mission actions/fields still work. */
-    missions?: MissionStoreConfig;
-    /** Small fixed authority policy for the supported operational actions. */
-    authorityPolicy?: AuthorityPolicyConfig;
-}
-export declare const DEFAULT_MAX_OUTPUT: Required<MaxOutputConfig>;
-export declare const DEFAULT_ARTIFACT_CONFIG: ArtifactConfig;
-export declare function resolveTempScopeId(options?: {
-    env?: NodeJS.ProcessEnv;
-    getuid?: (() => number) | undefined;
-    userInfo?: (() => {
-        username?: string | null;
-    }) | undefined;
-    homedir?: (() => string) | undefined;
-}): string;
-export declare const TEMP_ROOT_DIR: string;
-export declare const RESULTS_DIR: string;
-export declare const ASYNC_DIR: string;
-export declare const CHAIN_RUNS_DIR: string;
-export declare const TEMP_ARTIFACTS_DIR: string;
-export declare const DIRS: {
-    results: string;
-    async: string;
-    chain: string;
-    artifacts: string;
-};
-export declare const WIDGET_KEY = "subagent-async";
-export declare const SLASH_RESULT_TYPE = "subagent-slash-result";
-export declare const SLASH_TEXT_RESULT_TYPE = "subagent-slash-text-result";
-export declare const SLASH_SUBAGENT_REQUEST_EVENT = "subagent:slash:request";
-export declare const SLASH_SUBAGENT_STARTED_EVENT = "subagent:slash:started";
-export declare const SLASH_SUBAGENT_RESPONSE_EVENT = "subagent:slash:response";
-export declare const SLASH_SUBAGENT_UPDATE_EVENT = "subagent:slash:update";
-export declare const SLASH_SUBAGENT_CANCEL_EVENT = "subagent:slash:cancel";
-export declare const POLL_INTERVAL_MS = 250;
-export declare const WIDGET_ANIMATION_INTERVAL_MS = 1000;
-export declare const MAX_WIDGET_JOBS = 4;
-export declare const DEFAULT_SUBAGENT_MAX_DEPTH = 2;
-export declare const SUBAGENT_ACTIONS: readonly ["list", "get", "models", "children.list", "guide", "validate", "create", "update", "delete", "eject", "disable", "enable", "reset", "mission.create", "mission.list", "mission.show", "mission.update", "mission.resolve-decision", "mission.attach-run", "mission.close", "worktree.discard", "worktree.cleanup", "lane.status", "lane.recordMerge", "lane.recordSupersession", "refine", "refine.show", "refine.rollback", "inspector.open", "inspector.command", "inspector.status", "inspector.close", "project.open", "project.status", "project.close", "status", "debug.run", "grant-spawn-budget", "interrupt", "resume", "steer", "stop", "command.status", "command.yield", "command.cancel", "dismiss", "doctor", "watchdog.status", "watchdog.check", "watchdog.configure", "watchdog.recommend-model", "schedule.create", "schedule.list", "schedule.show", "schedule.history", "schedule.pause", "schedule.resume", "schedule.run", "schedule.run-due", "schedule.delete"];
-export declare const DEFAULT_FORK_PREAMBLE: string;
-export declare function resolveTopLevelParallelMaxTasks(value: unknown): number;
-export declare function resolveTopLevelParallelConcurrency(override: unknown, configValue: unknown): number;
-export declare function getAsyncConfigPath(suffix: string): string;
-export declare function wrapForkTask(task: string, preamble?: string | false): string;
-export declare function normalizeMaxSubagentDepth(value: unknown): number | undefined;
-/** Depth context of the executor's own child runtime, when it runs as an in-process child. */
-export interface SubagentDepthContext {
-    depth: number;
-    maxDepth?: number;
-}
-export declare function resolveCurrentMaxSubagentDepth(configMaxDepth?: number, runtime?: SubagentDepthContext): number;
-export declare function resolveChildMaxSubagentDepth(parentMaxDepth: number, agentMaxDepth?: number): number;
-export declare function checkSubagentDepth(configMaxDepth?: number, runtime?: SubagentDepthContext): {
-    blocked: boolean;
-    depth: number;
-    maxDepth: number;
-};
-/** Depth context handed to a child launched by an executor at `runtime` (undefined for a top-level parent). */
-export declare function resolveChildDepth(maxDepth?: number, runtime?: SubagentDepthContext): Required<SubagentDepthContext>;
-export declare function normalizeMaxSubagentSpawnsPerSession(value: unknown): number | undefined;
-export declare function resolveMaxSubagentSpawnsPerSession(configMaxSpawns?: number): number | undefined;
-export declare function normalizeMaxSubagentSpawnsPerRun(value: unknown): number | undefined;
-export declare function resolveMaxSubagentSpawnsPerRun(configMaxSpawns?: number): number;
-export declare function truncateOutput(output: string, config: Required<MaxOutputConfig>, artifactPath?: string): TruncationResult;
-export {};
-//# sourceMappingURL=types.d.ts.map