@ordewell/core 0.5.6 → 0.6.1

package/dist/{IFileSystem-C0l-4MGT.d.ts → IFileSystem-DuEiG_kA.d.ts}

@@ -1,4 +1,4 @@
-import { I as IApproval } from './Task-Dyxp67s2.js';
+import { I as IApproval } from './Task-ib_U0YP7.js';
 
 interface ToolOutcome {
     success: boolean;

package/dist/{IFileSystem-BkPX7mLD.d.mts → IFileSystem-d_SV7jAH.d.mts}

@@ -1,4 +1,4 @@
-import { I as IApproval } from './Task-Dyxp67s2.mjs';
+import { I as IApproval } from './Task-ib_U0YP7.mjs';
 
 interface ToolOutcome {
     success: boolean;

package/dist/{ModeResolver-CjpG5Wli.d.ts → ModeResolver-DIReYAOq.d.mts}

@@ -1,4 +1,4 @@
-import { aG as RunnerId } from './Task-Dyxp67s2.js';
+import { aG as RunnerId } from './Task-ib_U0YP7.mjs';
 
 interface RunnerModeInfo {
     id: string;
@@ -38,7 +38,11 @@ declare function resolveDefaultMode(modes: RunnerModeInfo[] | undefined, autonom
  * either toggle.
  */
 declare function filteredBuildModes(modes: RunnerModeInfo[], autonomousDefault: boolean): RunnerModeInfo[];
+/** The user-facing name of the `autonomousMode` boolean's two states. */
+declare function autonomyLevelLabel(autonomous: boolean): 'Full auto' | 'Auto';
+/** `full`/`auto` name the levels; `on`/`off` are the toggle's old words for them. Null for anything else. */
+declare function parseAutonomyLevel(arg: string | undefined): boolean | null;
 declare function buildModeGuide(runnerModes: Record<RunnerId, RunnerModeInfo[]>, autonomousDefault?: boolean): string;
 declare function resolveTaskMode(emittedMode: string | undefined, runnerId: RunnerId, runnerModes: Record<RunnerId, RunnerModeInfo[]> | undefined, autonomousDefault?: boolean): string;
 
-export { type ManifestLookup as M, type RunnerModeInfo as R, resolveTaskMode as a, buildModeGuide as b, runnerModesFrom as c, filteredBuildModes as f, resolveDefaultMode as r };
+export { type ManifestLookup as M, type RunnerModeInfo as R, autonomyLevelLabel as a, buildModeGuide as b, resolveTaskMode as c, runnerModesFrom as d, filteredBuildModes as f, parseAutonomyLevel as p, resolveDefaultMode as r };

package/dist/{ModeResolver--16lh7dS.d.mts → ModeResolver-DXxV4n_V.d.ts}

@@ -1,4 +1,4 @@
-import { aG as RunnerId } from './Task-Dyxp67s2.mjs';
+import { aG as RunnerId } from './Task-ib_U0YP7.js';
 
 interface RunnerModeInfo {
     id: string;
@@ -38,7 +38,11 @@ declare function resolveDefaultMode(modes: RunnerModeInfo[] | undefined, autonom
  * either toggle.
  */
 declare function filteredBuildModes(modes: RunnerModeInfo[], autonomousDefault: boolean): RunnerModeInfo[];
+/** The user-facing name of the `autonomousMode` boolean's two states. */
+declare function autonomyLevelLabel(autonomous: boolean): 'Full auto' | 'Auto';
+/** `full`/`auto` name the levels; `on`/`off` are the toggle's old words for them. Null for anything else. */
+declare function parseAutonomyLevel(arg: string | undefined): boolean | null;
 declare function buildModeGuide(runnerModes: Record<RunnerId, RunnerModeInfo[]>, autonomousDefault?: boolean): string;
 declare function resolveTaskMode(emittedMode: string | undefined, runnerId: RunnerId, runnerModes: Record<RunnerId, RunnerModeInfo[]> | undefined, autonomousDefault?: boolean): string;
 
-export { type ManifestLookup as M, type RunnerModeInfo as R, resolveTaskMode as a, buildModeGuide as b, runnerModesFrom as c, filteredBuildModes as f, resolveDefaultMode as r };
+export { type ManifestLookup as M, type RunnerModeInfo as R, autonomyLevelLabel as a, buildModeGuide as b, resolveTaskMode as c, runnerModesFrom as d, filteredBuildModes as f, parseAutonomyLevel as p, resolveDefaultMode as r };

package/dist/{Task-Dyxp67s2.d.mts → Task-ib_U0YP7.d.mts}

@@ -7,13 +7,14 @@ import { EventEmitter } from 'events';
  * "run without isolation", while the others fall back to the shared
  * workspace root with a one-line notice.
  */
-type IsolationInactiveReason = 'disabled' | 'git-missing' | 'not-git' | 'no-commits' | 'dirty' | 'nested-repos';
+type IsolationInactiveReason = 'disabled' | 'git-missing' | 'not-git' | 'no-commits' | 'dirty';
 /**
  * `repos` names, relative to the workspace, the repositories behind the answer:
  * when active, the ones that will isolate, with `shared` the paths every task
- * will share live; otherwise the nested ones `nested-repos` refuses, the dirty
- * ones of a `dirty` group, or the commitless ones of a `no-commits` group. A
- * group of one names none.
+ * will share live — loose entries of the workspace root, or, for a lone
+ * repository, the repositories nested inside it; otherwise the dirty ones of a
+ * `dirty` group, or the commitless ones of a `no-commits` group. A group of one
+ * names none.
  */
 type IsolationAvailability = {
     active: true;
@@ -27,7 +28,8 @@ type IsolationAvailability = {
 /**
  * Where a run's tasks work, as the planner is told it: the repos of the group
  * and the paths shared live between tasks. A lone repository is `['.']` with
- * nothing shared.
+ * nothing shared, unless it holds nested repositories, which are shared live
+ * and named in `shared`.
  */
 interface RepoGroupLayout {
     repos: string[];
@@ -49,13 +51,20 @@ interface IsolationTaskRepo {
     /** Absolute path of this repo's worktree: the task workspace joined with the repo's path. */
     worktree: string;
     /**
-     * Paths bootstrapped from the real repo (symlinks, junctions, copies).
-     * Recorded so the commit step can leave them out — a symlink is not matched
-     * by a `node_modules/` ignore rule and would otherwise be committed.
+     * Paths linked from the real workspace and kept out of the task's commit:
+     * the artifacts bootstrapped from the real repo, and a lone repository's
+     * nested repositories (`run.shared`). Recorded because a symlink is not
+     * matched by an ignore rule such as `node_modules/` and would otherwise be
+     * committed.
      */
     linked: string[];
     /** Whether the task brought commits to this repo; unknown until it first integrates. */
     changed?: boolean;
+    /**
+     * The integration tip right after the task landed here: what the user's
+     * HEAD must contain for the task's work to count as merged (ADR-0020).
+     */
+    landedTip?: string;
 }
 interface IsolationTaskRecord {
     taskId: string;
@@ -99,6 +108,12 @@ interface IsolationTaskRecord {
      * names it in a group of one, prefixed with its repo's path in a group.
      */
     repairedFiles?: string[];
+    /**
+     * Set once the task's landed work is in the checked-out HEAD of every repo
+     * it changed — merged into the user's branch, by Merge all or by hand. What
+     * a merge gate waits for (ADR-0020).
+     */
+    inHead?: true;
 }
 /**
  * A task's landing in flight: each changed repo's integration tip from before
@@ -142,7 +157,9 @@ interface IsolationRun {
     /**
      * Workspace paths outside every isolated repo, linked live into each task
      * workspace: loose entries of the workspace root, the entries beside a deeper
-     * repo, and `sharedRepos`. Empty for a group of one.
+     * repo, and `sharedRepos`. For a lone repository, the repositories nested
+     * inside it, which cannot be isolated with it and so are linked live instead.
+     * Empty when a group of one holds no nested repositories.
      */
     shared: string[];
     /** Repos of the group that could not be isolated — no commits, or git refused a worktree — and are among `shared`. */
@@ -296,6 +313,12 @@ interface IsolationPruneResult {
         title: string;
     }>;
 }
+/**
+ * The tracked changes of a workspace's repos at one moment, against each
+ * repo's HEAD: repo path → file path → the content it held then. What an ops
+ * task's tree check compares against (ADR-0020).
+ */
+type TreeSnapshot = Record<string, Record<string, string>>;
 interface IWorktreeIsolation {
     /**
      * A repo group with at least one repo to isolate, a clean tracked tree in
@@ -379,6 +402,24 @@ interface IWorktreeIsolation {
     pruneOrphans(run: IsolationRun): Promise<IsolationPruneResult>;
     /** Unified diff of each repo's integration branch against its base ref. */
     reviewDiff(run: IsolationRun): Promise<string>;
+    /**
+     * Mark the landed tasks whose work the checked-out HEAD now contains in
+     * every repo they changed (`git merge-base --is-ancestor`), and return their
+     * ids. Only adds marks: a task found merged stays merged.
+     */
+    findInHead(run: IsolationRun): Promise<string[]>;
+    /**
+     * The tracked changes of each committed repo of the workspace's group,
+     * except those in `exclude`; null when there is no repo to snapshot.
+     * Untracked and ignored files never count.
+     */
+    snapshotTree(workspaceRoot: string, exclude: readonly string[]): Promise<TreeSnapshot | null>;
+    /**
+     * Tracked files whose content differs from what `snapshot` recorded: new
+     * changes, and further changes to files already changed then. Paths are
+     * from the workspace root. A repo git cannot read now is left out.
+     */
+    changedSince(workspaceRoot: string, snapshot: TreeSnapshot): Promise<string[]>;
     /**
      * "Merge all": merge each repo's integration branch into whatever the user
      * has checked out there. The one irreversible step, so it only ever happens
@@ -386,7 +427,9 @@ interface IWorktreeIsolation {
      * merge of the user's in progress, no conflict against their HEAD, no
      * uncommitted edit to a file the merge changes — and unless all pass,
      * nothing is merged anywhere. Only a merge Ordewell itself just started is
-     * ever aborted; nothing of the user's is reset.
+     * ever aborted; nothing of the user's is reset. Waits for a landing in
+     * flight and holds the next back, so a merge during a run takes the
+     * integration branches between two landings, never part of one.
      */
     mergeIntoCheckedOut(run: IsolationRun): Promise<IsolationMergeResult>;
     /**
@@ -817,6 +860,12 @@ interface ApprovalRequest {
      * second file from an already-approved directory does not prompt again.
      */
     scope: string;
+    /**
+     * Every scope one answer settles, when a command needs more than one — its
+     * own and each outside directory it touches — so it prompts once rather than
+     * once per scope. `scope` is the first. Absent means `scope` alone.
+     */
+    scopes?: string[];
     /** One-line context for the prompt. */
     detail?: string;
     /** The task whose runner asked; absent for the planner's own requests. */
@@ -841,6 +890,7 @@ type ApprovalDecision = {
 type ApprovalAnswer = boolean | ApprovalDecision;
 declare function toApprovalDecision(answer: ApprovalAnswer): ApprovalDecision;
 declare function isGranted(decision: ApprovalDecision): boolean;
+declare function approvalScopes(request: ApprovalRequest): string[];
 declare function isRunnerApproval(request: ApprovalRequest): boolean;
 interface IApproval {
     request(req: ApprovalRequest): Promise<boolean>;
@@ -937,6 +987,8 @@ type AgentEvent =
  *
  * `input` and `suggestions` are the raw request; `suggestions` are the
  * agent's own session-scoped grants, what "Allow for this task" answers with.
+ * `decided` marks a request the task's mode already answered — the adapter
+ * replied as the manifest says that mode does — so it is shown, never asked.
  */
  | {
     type: 'permission_request';
@@ -946,6 +998,7 @@ type AgentEvent =
     input?: Record<string, unknown>;
     suggestions?: unknown[];
     toolUseId?: string;
+    decided?: ApprovalDecision;
 }
 /** The agent withdrew an open request — an interrupt cancels the call it was for. It takes no answer now. */
  | {
@@ -1005,8 +1058,10 @@ interface PlannerStartOptions extends AgentStartCommon {
 interface TaskRunnerFlags {
     /** The runner's own permission-mode value for the task's mode. */
     permissionMode: string;
-    /** Thinking/effort arguments, already split into argv entries. */
-    effortArgs: string[];
+    /** The task's raw effort id, present only alongside a model. Each adapter maps it to its own protocol. */
+    effort?: string;
+    /** The manifest's further settings for the task's mode, by setting name — see `PluginFeatures.modeSettings`. */
+    modeSettings: Record<string, string>;
 }
 /** A plan task driven over the runner's programmatic protocol (ADR-0018, C1). */
 interface TaskStartOptions extends AgentStartCommon {
@@ -1059,6 +1114,13 @@ interface TaskModeAgentAdapter extends AgentAdapter {
      * within `timeoutMs`, and the caller must fall back to killing it.
      */
     interrupt(timeoutMs: number): Promise<boolean>;
+    /**
+     * Registers the listener for what the agent does after a turn has ended and
+     * before the next message — a turn it opens itself when background work
+     * finishes, most often. Without one that output is dropped, which is right
+     * for a planner and wrong for a task, whose marker may be said there.
+     */
+    onOutOfTurn?(listener: (event: AgentEvent) => void): void;
     /** Registers a listener for the process ending, for any reason. Fires at most once. */
     onProcessExit(listener: (code: number) => void): void;
     /**
@@ -1158,6 +1220,16 @@ interface PluginFeatures {
     thinkingValueAdaptive?: string;
     /** Maps mode IDs to the CLI --permission-mode value. Used by {{feature:permissionModeVal}}. */
     permissionModeValues?: Record<string, string>;
+    /**
+     * Further per-mode settings for runners whose permission story has more than
+     * one axis (Codex: sandbox, approval policy, approvals reviewer). Keyed by
+     * setting name, then by mode id; a mode a map does not name leaves that
+     * setting to the runner's own default. Codex declares `approvalPolicy`
+     * (`-a` / `approval_policy`) and `approvalsReviewer` (`approvals_reviewer`);
+     * the terminal template reads them too, through `{{feature:approvalPolicyVal}}`
+     * and the `*Config` tokens.
+     */
+    modeSettings?: Record<string, Record<string, string>>;
 }
 type PluginParser = 'claude-help' | 'opencode-models' | 'opencode-models-verbose' | 'anthropic-models' | 'line-by-line' | 'json' | 'json-table';
 interface DiscoveryCommand {
@@ -1761,10 +1833,11 @@ type TaskStatus = 'pending' | 'approved' | 'in_progress' | 'completed' | 'failed
 type TaskMode = string;
 /**
  * Why an `awaiting_user` task waits (ADR-0018, W1): a structured turn that
- * ended without the done marker, a checkpoint question, or work that did not
- * land. Saved, so no surface has to guess it from whether an attempt is live.
+ * ended without the done marker, a checkpoint question, work that did not
+ * land, or an ops task that changed tracked files (ADR-0020). Saved, so no
+ * surface has to guess it from whether an attempt is live.
  */
-type AwaitingReason = 'input' | 'checkpoint' | 'conflict';
+type AwaitingReason = 'input' | 'checkpoint' | 'conflict' | 'files-changed';
 declare function isAwaitingReason(value: unknown): value is AwaitingReason;
 interface TaskModelAssignment {
     modelId: string;
@@ -1815,6 +1888,19 @@ interface Task {
     transport?: TaskTransport;
     /** Set only while `status` is `awaiting_user`, and not always then — a usage-limit pause has none. */
     awaitingReason?: AwaitingReason;
+    /**
+     * An ops task (ADR-0020): it changes no repository files, runs at the
+     * workspace root rather than in a worktree, and waits for the change tasks
+     * it depends on to be merged into the user's branch. Top-level AI tasks
+     * only; absent means a change task.
+     */
+    ops?: boolean;
+    /**
+     * The dependencies, by title, whose work was not merged into the user's
+     * branch when the user force-started this task past its merge gate
+     * (ADR-0020). Cleared when the task is retried.
+     */
+    forcedPastGate?: string[];
 }
 interface DiscoveredMode {
     id: string;
@@ -2083,4 +2169,4 @@ interface ValidationContext {
 type ValidationCheck = (ctx: ValidationContext) => ValidationResult;
 declare function warningsText(w: PlanModificationWarnings): string | null;
 
-export { type IsolationRun as $, AbstractRunner as A, type BlockingPrompt as B, CMD_EXE_MAX_COMMAND_LINE as C, DENY_ALL as D, EmbeddedNewlineError as E, type FetchAllProviderModelsOptions as F, HeadlessSession as G, HeadlessRunner as H, type IApproval as I, type IConfig as J, type IPluginStore as K, type ITerminalRunner as L, type ITerminalSession as M, type IWorktreeIsolation as N, type IntegrationDisposal as O, type IsolationAvailability as P, type IsolationHandoff as Q, type IsolationHandoffRepo as R, type IsolationInactiveReason as S, type IsolationLandedTask as T, type IsolationLanding as U, type IsolationMergeBlock as V, type IsolationMergeBlockReason as W, type IsolationMergeResult as X, type IsolationOutcome as Y, type IsolationPruneResult as Z, type IsolationRepo as _, AbstractTerminalSession as a, type TaskOutputSummary as a$, type IsolationTaskRecord as a0, type IsolationTaskRepo as a1, type IsolationTaskStatus as a2, type IsolationView as a3, type LaunchDeps as a4, type LaunchPlan as a5, type LegacyPlanState as a6, LineBuffer as a7, type Message as a8, ModelCatalog as a9, type ResearchLogEntry as aA, type ResearchProgress as aB, type ResearchStep as aC, type ResearchStepOutcome as aD, type ResearchToolType as aE, type ResolveContext as aF, type RunnerId as aG, type RunnerInvocation as aH, type RunnerPluginManifest as aI, RunnerRegistry as aJ, type RunnerSpawnOptions as aK, type RunnerTransport as aL, type StreamEvent as aM, type StreamStepEvent as aN, type StreamThinkingEvent as aO, type StructuredEvent as aP, type StructuredSessionCapability as aQ, type StructuredTurnEnd as aR, type SubagentLogEntry as aS, type SubagentOutcome as aT, type Task as aU, type TaskIsolation as aV, type TaskIsolationState as aW, type TaskMode as aX, type TaskModeAgentAdapter as aY, TaskModeUnsupportedError as aZ, type TaskModelAssignment as a_, type ModelShortcut as aa, ORCHESTRATOR_SHORTCUTS as ab, type OrchestratorOption as ac, type PlanIsolation as ad, type PlanModificationWarnings as ae, type PlanState as af, type PlanStatus as ag, type PlannerStartOptions as ah, type PlannerUsage as ai, type PluginCloneFn as aj, type PluginEntry as ak, type PluginFeatures as al, type PluginMode as am, type PluginModelDiscovery as an, type PluginRunnerDef as ao, type PreparedLaunch as ap, type PreparedTask as aq, type ProviderCredentialSource as ar, type ProviderModelLists as as, type ProviderModelsResult as at, type PtySize as au, type PtyWrapOptions as av, type QueuedMessage as aw, type QueuedTaskMessage as ax, type RepairEvidence as ay, type RepoGroupLayout as az, type ActiveTaskSession as b, type TaskRunnerFlags as b0, type TaskSnapshot as b1, type TaskStartOptions as b2, type TaskStatus as b3, type TaskTransport as b4, type TaskType as b5, type TaskWithParent as b6, type ThinkingBlock as b7, type UsageLine as b8, type UsageRecord as b9, isRunnerApproval as bA, isRunnerTransport as bB, isStructuredSession as bC, keepExecutionState as bD, knownModelId as bE, migrateLegacyPlan as bF, migratePlanState as bG, migrateTask as bH, partedPromptUsage as bI, planDirectLaunch as bJ, planShellLaunch as bK, plannerContextFill as bL, posixShellQuote as bM, removeTaskFromPlan as bN, renumberTasks as bO, resolveModelShortcut as bP, resolveProvider as bQ, stripAnsi as bR, toApprovalDecision as bS, toOrchestratorOptions as bT, updateTaskInPlan as bU, usageLine as bV, validateModifiedPlan as bW, warningsText as bX, windowsCommandLine as bY, wrapWithPty as bZ, type UsageTotals as ba, type UserPromptEntry as bb, type UserStep as bc, type ValidationCheck as bd, type ValidationContext as be, type ValidationResult as bf, type Verdict as bg, type VerificationCheck as bh, WINDOWS_MAX_COMMAND_LINE as bi, addPlannerUsage as bj, addTaskToPlan as bk, addUsage as bl, buildShellInvocation as bm, collectProviderCredentials as bn, createEmptyPlan as bo, createTask as bp, emptyWarnings as bq, enabledRunners as br, fetchAllProviderModels as bs, flattenTasks as bt, flattenTasksWithParents as bu, isAwaitingReason as bv, isExecutableResolved as bw, isGranted as bx, isMeasured as by, isReservedRunnerName as bz, type AgentAdapter as c, type AgentAdapterFactory as d, type AgentEvent as e, type AgentProcessDeps as f, type AgentStartOptions as g, type AiProvider as h, type AllProviderModels as i, type ApprovalAnswer as j, type ApprovalDecision as k, type ApprovalKind as l, type ApprovalMode as m, ApprovalPolicy as n, type ApprovalPolicyOptions as o, type ApprovalRequest as p, type ApprovalSource as q, type AwaitingReason as r, type CatalogModel as s, CommandLineTooLongError as t, type ConversationMessage as u, type DiscoveredMode as v, type DiscoveredModel as w, type DiscoveryCommand as x, ExecutableNotFoundError as y, type HeadlessRunnerDeps as z };
+export { type IsolationRun as $, AbstractRunner as A, type BlockingPrompt as B, CMD_EXE_MAX_COMMAND_LINE as C, DENY_ALL as D, EmbeddedNewlineError as E, type FetchAllProviderModelsOptions as F, HeadlessSession as G, HeadlessRunner as H, type IApproval as I, type IConfig as J, type IPluginStore as K, type ITerminalRunner as L, type ITerminalSession as M, type IWorktreeIsolation as N, type IntegrationDisposal as O, type IsolationAvailability as P, type IsolationHandoff as Q, type IsolationHandoffRepo as R, type IsolationInactiveReason as S, type IsolationLandedTask as T, type IsolationLanding as U, type IsolationMergeBlock as V, type IsolationMergeBlockReason as W, type IsolationMergeResult as X, type IsolationOutcome as Y, type IsolationPruneResult as Z, type IsolationRepo as _, AbstractTerminalSession as a, type TaskOutputSummary as a$, type IsolationTaskRecord as a0, type IsolationTaskRepo as a1, type IsolationTaskStatus as a2, type IsolationView as a3, type LaunchDeps as a4, type LaunchPlan as a5, type LegacyPlanState as a6, LineBuffer as a7, type Message as a8, ModelCatalog as a9, type ResearchLogEntry as aA, type ResearchProgress as aB, type ResearchStep as aC, type ResearchStepOutcome as aD, type ResearchToolType as aE, type ResolveContext as aF, type RunnerId as aG, type RunnerInvocation as aH, type RunnerPluginManifest as aI, RunnerRegistry as aJ, type RunnerSpawnOptions as aK, type RunnerTransport as aL, type StreamEvent as aM, type StreamStepEvent as aN, type StreamThinkingEvent as aO, type StructuredEvent as aP, type StructuredSessionCapability as aQ, type StructuredTurnEnd as aR, type SubagentLogEntry as aS, type SubagentOutcome as aT, type Task as aU, type TaskIsolation as aV, type TaskIsolationState as aW, type TaskMode as aX, type TaskModeAgentAdapter as aY, TaskModeUnsupportedError as aZ, type TaskModelAssignment as a_, type ModelShortcut as aa, ORCHESTRATOR_SHORTCUTS as ab, type OrchestratorOption as ac, type PlanIsolation as ad, type PlanModificationWarnings as ae, type PlanState as af, type PlanStatus as ag, type PlannerStartOptions as ah, type PlannerUsage as ai, type PluginCloneFn as aj, type PluginEntry as ak, type PluginFeatures as al, type PluginMode as am, type PluginModelDiscovery as an, type PluginRunnerDef as ao, type PreparedLaunch as ap, type PreparedTask as aq, type ProviderCredentialSource as ar, type ProviderModelLists as as, type ProviderModelsResult as at, type PtySize as au, type PtyWrapOptions as av, type QueuedMessage as aw, type QueuedTaskMessage as ax, type RepairEvidence as ay, type RepoGroupLayout as az, type ActiveTaskSession as b, wrapWithPty as b$, type TaskRunnerFlags as b0, type TaskSnapshot as b1, type TaskStartOptions as b2, type TaskStatus as b3, type TaskTransport as b4, type TaskType as b5, type TaskWithParent as b6, type ThinkingBlock as b7, type TreeSnapshot as b8, type UsageLine as b9, isMeasured as bA, isReservedRunnerName as bB, isRunnerApproval as bC, isRunnerTransport as bD, isStructuredSession as bE, keepExecutionState as bF, knownModelId as bG, migrateLegacyPlan as bH, migratePlanState as bI, migrateTask as bJ, partedPromptUsage as bK, planDirectLaunch as bL, planShellLaunch as bM, plannerContextFill as bN, posixShellQuote as bO, removeTaskFromPlan as bP, renumberTasks as bQ, resolveModelShortcut as bR, resolveProvider as bS, stripAnsi as bT, toApprovalDecision as bU, toOrchestratorOptions as bV, updateTaskInPlan as bW, usageLine as bX, validateModifiedPlan as bY, warningsText as bZ, windowsCommandLine as b_, type UsageRecord as ba, type UsageTotals as bb, type UserPromptEntry as bc, type UserStep as bd, type ValidationCheck as be, type ValidationContext as bf, type ValidationResult as bg, type Verdict as bh, type VerificationCheck as bi, WINDOWS_MAX_COMMAND_LINE as bj, addPlannerUsage as bk, addTaskToPlan as bl, addUsage as bm, approvalScopes as bn, buildShellInvocation as bo, collectProviderCredentials as bp, createEmptyPlan as bq, createTask as br, emptyWarnings as bs, enabledRunners as bt, fetchAllProviderModels as bu, flattenTasks as bv, flattenTasksWithParents as bw, isAwaitingReason as bx, isExecutableResolved as by, isGranted as bz, type AgentAdapter as c, type AgentAdapterFactory as d, type AgentEvent as e, type AgentProcessDeps as f, type AgentStartOptions as g, type AiProvider as h, type AllProviderModels as i, type ApprovalAnswer as j, type ApprovalDecision as k, type ApprovalKind as l, type ApprovalMode as m, ApprovalPolicy as n, type ApprovalPolicyOptions as o, type ApprovalRequest as p, type ApprovalSource as q, type AwaitingReason as r, type CatalogModel as s, CommandLineTooLongError as t, type ConversationMessage as u, type DiscoveredMode as v, type DiscoveredModel as w, type DiscoveryCommand as x, ExecutableNotFoundError as y, type HeadlessRunnerDeps as z };

package/dist/{Task-Dyxp67s2.d.ts → Task-ib_U0YP7.d.ts}

@@ -7,13 +7,14 @@ import { EventEmitter } from 'events';
  * "run without isolation", while the others fall back to the shared
  * workspace root with a one-line notice.
  */
-type IsolationInactiveReason = 'disabled' | 'git-missing' | 'not-git' | 'no-commits' | 'dirty' | 'nested-repos';
+type IsolationInactiveReason = 'disabled' | 'git-missing' | 'not-git' | 'no-commits' | 'dirty';
 /**
  * `repos` names, relative to the workspace, the repositories behind the answer:
  * when active, the ones that will isolate, with `shared` the paths every task
- * will share live; otherwise the nested ones `nested-repos` refuses, the dirty
- * ones of a `dirty` group, or the commitless ones of a `no-commits` group. A
- * group of one names none.
+ * will share live — loose entries of the workspace root, or, for a lone
+ * repository, the repositories nested inside it; otherwise the dirty ones of a
+ * `dirty` group, or the commitless ones of a `no-commits` group. A group of one
+ * names none.
  */
 type IsolationAvailability = {
     active: true;
@@ -27,7 +28,8 @@ type IsolationAvailability = {
 /**
  * Where a run's tasks work, as the planner is told it: the repos of the group
  * and the paths shared live between tasks. A lone repository is `['.']` with
- * nothing shared.
+ * nothing shared, unless it holds nested repositories, which are shared live
+ * and named in `shared`.
  */
 interface RepoGroupLayout {
     repos: string[];
@@ -49,13 +51,20 @@ interface IsolationTaskRepo {
     /** Absolute path of this repo's worktree: the task workspace joined with the repo's path. */
     worktree: string;
     /**
-     * Paths bootstrapped from the real repo (symlinks, junctions, copies).
-     * Recorded so the commit step can leave them out — a symlink is not matched
-     * by a `node_modules/` ignore rule and would otherwise be committed.
+     * Paths linked from the real workspace and kept out of the task's commit:
+     * the artifacts bootstrapped from the real repo, and a lone repository's
+     * nested repositories (`run.shared`). Recorded because a symlink is not
+     * matched by an ignore rule such as `node_modules/` and would otherwise be
+     * committed.
      */
     linked: string[];
     /** Whether the task brought commits to this repo; unknown until it first integrates. */
     changed?: boolean;
+    /**
+     * The integration tip right after the task landed here: what the user's
+     * HEAD must contain for the task's work to count as merged (ADR-0020).
+     */
+    landedTip?: string;
 }
 interface IsolationTaskRecord {
     taskId: string;
@@ -99,6 +108,12 @@ interface IsolationTaskRecord {
      * names it in a group of one, prefixed with its repo's path in a group.
      */
     repairedFiles?: string[];
+    /**
+     * Set once the task's landed work is in the checked-out HEAD of every repo
+     * it changed — merged into the user's branch, by Merge all or by hand. What
+     * a merge gate waits for (ADR-0020).
+     */
+    inHead?: true;
 }
 /**
  * A task's landing in flight: each changed repo's integration tip from before
@@ -142,7 +157,9 @@ interface IsolationRun {
     /**
      * Workspace paths outside every isolated repo, linked live into each task
      * workspace: loose entries of the workspace root, the entries beside a deeper
-     * repo, and `sharedRepos`. Empty for a group of one.
+     * repo, and `sharedRepos`. For a lone repository, the repositories nested
+     * inside it, which cannot be isolated with it and so are linked live instead.
+     * Empty when a group of one holds no nested repositories.
      */
     shared: string[];
     /** Repos of the group that could not be isolated — no commits, or git refused a worktree — and are among `shared`. */
@@ -296,6 +313,12 @@ interface IsolationPruneResult {
         title: string;
     }>;
 }
+/**
+ * The tracked changes of a workspace's repos at one moment, against each
+ * repo's HEAD: repo path → file path → the content it held then. What an ops
+ * task's tree check compares against (ADR-0020).
+ */
+type TreeSnapshot = Record<string, Record<string, string>>;
 interface IWorktreeIsolation {
     /**
      * A repo group with at least one repo to isolate, a clean tracked tree in
@@ -379,6 +402,24 @@ interface IWorktreeIsolation {
     pruneOrphans(run: IsolationRun): Promise<IsolationPruneResult>;
     /** Unified diff of each repo's integration branch against its base ref. */
     reviewDiff(run: IsolationRun): Promise<string>;
+    /**
+     * Mark the landed tasks whose work the checked-out HEAD now contains in
+     * every repo they changed (`git merge-base --is-ancestor`), and return their
+     * ids. Only adds marks: a task found merged stays merged.
+     */
+    findInHead(run: IsolationRun): Promise<string[]>;
+    /**
+     * The tracked changes of each committed repo of the workspace's group,
+     * except those in `exclude`; null when there is no repo to snapshot.
+     * Untracked and ignored files never count.
+     */
+    snapshotTree(workspaceRoot: string, exclude: readonly string[]): Promise<TreeSnapshot | null>;
+    /**
+     * Tracked files whose content differs from what `snapshot` recorded: new
+     * changes, and further changes to files already changed then. Paths are
+     * from the workspace root. A repo git cannot read now is left out.
+     */
+    changedSince(workspaceRoot: string, snapshot: TreeSnapshot): Promise<string[]>;
     /**
      * "Merge all": merge each repo's integration branch into whatever the user
      * has checked out there. The one irreversible step, so it only ever happens
@@ -386,7 +427,9 @@ interface IWorktreeIsolation {
      * merge of the user's in progress, no conflict against their HEAD, no
      * uncommitted edit to a file the merge changes — and unless all pass,
      * nothing is merged anywhere. Only a merge Ordewell itself just started is
-     * ever aborted; nothing of the user's is reset.
+     * ever aborted; nothing of the user's is reset. Waits for a landing in
+     * flight and holds the next back, so a merge during a run takes the
+     * integration branches between two landings, never part of one.
      */
     mergeIntoCheckedOut(run: IsolationRun): Promise<IsolationMergeResult>;
     /**
@@ -817,6 +860,12 @@ interface ApprovalRequest {
      * second file from an already-approved directory does not prompt again.
      */
     scope: string;
+    /**
+     * Every scope one answer settles, when a command needs more than one — its
+     * own and each outside directory it touches — so it prompts once rather than
+     * once per scope. `scope` is the first. Absent means `scope` alone.
+     */
+    scopes?: string[];
     /** One-line context for the prompt. */
     detail?: string;
     /** The task whose runner asked; absent for the planner's own requests. */
@@ -841,6 +890,7 @@ type ApprovalDecision = {
 type ApprovalAnswer = boolean | ApprovalDecision;
 declare function toApprovalDecision(answer: ApprovalAnswer): ApprovalDecision;
 declare function isGranted(decision: ApprovalDecision): boolean;
+declare function approvalScopes(request: ApprovalRequest): string[];
 declare function isRunnerApproval(request: ApprovalRequest): boolean;
 interface IApproval {
     request(req: ApprovalRequest): Promise<boolean>;
@@ -937,6 +987,8 @@ type AgentEvent =
  *
  * `input` and `suggestions` are the raw request; `suggestions` are the
  * agent's own session-scoped grants, what "Allow for this task" answers with.
+ * `decided` marks a request the task's mode already answered — the adapter
+ * replied as the manifest says that mode does — so it is shown, never asked.
  */
  | {
     type: 'permission_request';
@@ -946,6 +998,7 @@ type AgentEvent =
     input?: Record<string, unknown>;
     suggestions?: unknown[];
     toolUseId?: string;
+    decided?: ApprovalDecision;
 }
 /** The agent withdrew an open request — an interrupt cancels the call it was for. It takes no answer now. */
  | {
@@ -1005,8 +1058,10 @@ interface PlannerStartOptions extends AgentStartCommon {
 interface TaskRunnerFlags {
     /** The runner's own permission-mode value for the task's mode. */
     permissionMode: string;
-    /** Thinking/effort arguments, already split into argv entries. */
-    effortArgs: string[];
+    /** The task's raw effort id, present only alongside a model. Each adapter maps it to its own protocol. */
+    effort?: string;
+    /** The manifest's further settings for the task's mode, by setting name — see `PluginFeatures.modeSettings`. */
+    modeSettings: Record<string, string>;
 }
 /** A plan task driven over the runner's programmatic protocol (ADR-0018, C1). */
 interface TaskStartOptions extends AgentStartCommon {
@@ -1059,6 +1114,13 @@ interface TaskModeAgentAdapter extends AgentAdapter {
      * within `timeoutMs`, and the caller must fall back to killing it.
      */
     interrupt(timeoutMs: number): Promise<boolean>;
+    /**
+     * Registers the listener for what the agent does after a turn has ended and
+     * before the next message — a turn it opens itself when background work
+     * finishes, most often. Without one that output is dropped, which is right
+     * for a planner and wrong for a task, whose marker may be said there.
+     */
+    onOutOfTurn?(listener: (event: AgentEvent) => void): void;
     /** Registers a listener for the process ending, for any reason. Fires at most once. */
     onProcessExit(listener: (code: number) => void): void;
     /**
@@ -1158,6 +1220,16 @@ interface PluginFeatures {
     thinkingValueAdaptive?: string;
     /** Maps mode IDs to the CLI --permission-mode value. Used by {{feature:permissionModeVal}}. */
     permissionModeValues?: Record<string, string>;
+    /**
+     * Further per-mode settings for runners whose permission story has more than
+     * one axis (Codex: sandbox, approval policy, approvals reviewer). Keyed by
+     * setting name, then by mode id; a mode a map does not name leaves that
+     * setting to the runner's own default. Codex declares `approvalPolicy`
+     * (`-a` / `approval_policy`) and `approvalsReviewer` (`approvals_reviewer`);
+     * the terminal template reads them too, through `{{feature:approvalPolicyVal}}`
+     * and the `*Config` tokens.
+     */
+    modeSettings?: Record<string, Record<string, string>>;
 }
 type PluginParser = 'claude-help' | 'opencode-models' | 'opencode-models-verbose' | 'anthropic-models' | 'line-by-line' | 'json' | 'json-table';
 interface DiscoveryCommand {
@@ -1761,10 +1833,11 @@ type TaskStatus = 'pending' | 'approved' | 'in_progress' | 'completed' | 'failed
 type TaskMode = string;
 /**
  * Why an `awaiting_user` task waits (ADR-0018, W1): a structured turn that
- * ended without the done marker, a checkpoint question, or work that did not
- * land. Saved, so no surface has to guess it from whether an attempt is live.
+ * ended without the done marker, a checkpoint question, work that did not
+ * land, or an ops task that changed tracked files (ADR-0020). Saved, so no
+ * surface has to guess it from whether an attempt is live.
  */
-type AwaitingReason = 'input' | 'checkpoint' | 'conflict';
+type AwaitingReason = 'input' | 'checkpoint' | 'conflict' | 'files-changed';
 declare function isAwaitingReason(value: unknown): value is AwaitingReason;
 interface TaskModelAssignment {
     modelId: string;
@@ -1815,6 +1888,19 @@ interface Task {
     transport?: TaskTransport;
     /** Set only while `status` is `awaiting_user`, and not always then — a usage-limit pause has none. */
     awaitingReason?: AwaitingReason;
+    /**
+     * An ops task (ADR-0020): it changes no repository files, runs at the
+     * workspace root rather than in a worktree, and waits for the change tasks
+     * it depends on to be merged into the user's branch. Top-level AI tasks
+     * only; absent means a change task.
+     */
+    ops?: boolean;
+    /**
+     * The dependencies, by title, whose work was not merged into the user's
+     * branch when the user force-started this task past its merge gate
+     * (ADR-0020). Cleared when the task is retried.
+     */
+    forcedPastGate?: string[];
 }
 interface DiscoveredMode {
     id: string;
@@ -2083,4 +2169,4 @@ interface ValidationContext {
 type ValidationCheck = (ctx: ValidationContext) => ValidationResult;
 declare function warningsText(w: PlanModificationWarnings): string | null;
 
-export { type IsolationRun as $, AbstractRunner as A, type BlockingPrompt as B, CMD_EXE_MAX_COMMAND_LINE as C, DENY_ALL as D, EmbeddedNewlineError as E, type FetchAllProviderModelsOptions as F, HeadlessSession as G, HeadlessRunner as H, type IApproval as I, type IConfig as J, type IPluginStore as K, type ITerminalRunner as L, type ITerminalSession as M, type IWorktreeIsolation as N, type IntegrationDisposal as O, type IsolationAvailability as P, type IsolationHandoff as Q, type IsolationHandoffRepo as R, type IsolationInactiveReason as S, type IsolationLandedTask as T, type IsolationLanding as U, type IsolationMergeBlock as V, type IsolationMergeBlockReason as W, type IsolationMergeResult as X, type IsolationOutcome as Y, type IsolationPruneResult as Z, type IsolationRepo as _, AbstractTerminalSession as a, type TaskOutputSummary as a$, type IsolationTaskRecord as a0, type IsolationTaskRepo as a1, type IsolationTaskStatus as a2, type IsolationView as a3, type LaunchDeps as a4, type LaunchPlan as a5, type LegacyPlanState as a6, LineBuffer as a7, type Message as a8, ModelCatalog as a9, type ResearchLogEntry as aA, type ResearchProgress as aB, type ResearchStep as aC, type ResearchStepOutcome as aD, type ResearchToolType as aE, type ResolveContext as aF, type RunnerId as aG, type RunnerInvocation as aH, type RunnerPluginManifest as aI, RunnerRegistry as aJ, type RunnerSpawnOptions as aK, type RunnerTransport as aL, type StreamEvent as aM, type StreamStepEvent as aN, type StreamThinkingEvent as aO, type StructuredEvent as aP, type StructuredSessionCapability as aQ, type StructuredTurnEnd as aR, type SubagentLogEntry as aS, type SubagentOutcome as aT, type Task as aU, type TaskIsolation as aV, type TaskIsolationState as aW, type TaskMode as aX, type TaskModeAgentAdapter as aY, TaskModeUnsupportedError as aZ, type TaskModelAssignment as a_, type ModelShortcut as aa, ORCHESTRATOR_SHORTCUTS as ab, type OrchestratorOption as ac, type PlanIsolation as ad, type PlanModificationWarnings as ae, type PlanState as af, type PlanStatus as ag, type PlannerStartOptions as ah, type PlannerUsage as ai, type PluginCloneFn as aj, type PluginEntry as ak, type PluginFeatures as al, type PluginMode as am, type PluginModelDiscovery as an, type PluginRunnerDef as ao, type PreparedLaunch as ap, type PreparedTask as aq, type ProviderCredentialSource as ar, type ProviderModelLists as as, type ProviderModelsResult as at, type PtySize as au, type PtyWrapOptions as av, type QueuedMessage as aw, type QueuedTaskMessage as ax, type RepairEvidence as ay, type RepoGroupLayout as az, type ActiveTaskSession as b, type TaskRunnerFlags as b0, type TaskSnapshot as b1, type TaskStartOptions as b2, type TaskStatus as b3, type TaskTransport as b4, type TaskType as b5, type TaskWithParent as b6, type ThinkingBlock as b7, type UsageLine as b8, type UsageRecord as b9, isRunnerApproval as bA, isRunnerTransport as bB, isStructuredSession as bC, keepExecutionState as bD, knownModelId as bE, migrateLegacyPlan as bF, migratePlanState as bG, migrateTask as bH, partedPromptUsage as bI, planDirectLaunch as bJ, planShellLaunch as bK, plannerContextFill as bL, posixShellQuote as bM, removeTaskFromPlan as bN, renumberTasks as bO, resolveModelShortcut as bP, resolveProvider as bQ, stripAnsi as bR, toApprovalDecision as bS, toOrchestratorOptions as bT, updateTaskInPlan as bU, usageLine as bV, validateModifiedPlan as bW, warningsText as bX, windowsCommandLine as bY, wrapWithPty as bZ, type UsageTotals as ba, type UserPromptEntry as bb, type UserStep as bc, type ValidationCheck as bd, type ValidationContext as be, type ValidationResult as bf, type Verdict as bg, type VerificationCheck as bh, WINDOWS_MAX_COMMAND_LINE as bi, addPlannerUsage as bj, addTaskToPlan as bk, addUsage as bl, buildShellInvocation as bm, collectProviderCredentials as bn, createEmptyPlan as bo, createTask as bp, emptyWarnings as bq, enabledRunners as br, fetchAllProviderModels as bs, flattenTasks as bt, flattenTasksWithParents as bu, isAwaitingReason as bv, isExecutableResolved as bw, isGranted as bx, isMeasured as by, isReservedRunnerName as bz, type AgentAdapter as c, type AgentAdapterFactory as d, type AgentEvent as e, type AgentProcessDeps as f, type AgentStartOptions as g, type AiProvider as h, type AllProviderModels as i, type ApprovalAnswer as j, type ApprovalDecision as k, type ApprovalKind as l, type ApprovalMode as m, ApprovalPolicy as n, type ApprovalPolicyOptions as o, type ApprovalRequest as p, type ApprovalSource as q, type AwaitingReason as r, type CatalogModel as s, CommandLineTooLongError as t, type ConversationMessage as u, type DiscoveredMode as v, type DiscoveredModel as w, type DiscoveryCommand as x, ExecutableNotFoundError as y, type HeadlessRunnerDeps as z };
+export { type IsolationRun as $, AbstractRunner as A, type BlockingPrompt as B, CMD_EXE_MAX_COMMAND_LINE as C, DENY_ALL as D, EmbeddedNewlineError as E, type FetchAllProviderModelsOptions as F, HeadlessSession as G, HeadlessRunner as H, type IApproval as I, type IConfig as J, type IPluginStore as K, type ITerminalRunner as L, type ITerminalSession as M, type IWorktreeIsolation as N, type IntegrationDisposal as O, type IsolationAvailability as P, type IsolationHandoff as Q, type IsolationHandoffRepo as R, type IsolationInactiveReason as S, type IsolationLandedTask as T, type IsolationLanding as U, type IsolationMergeBlock as V, type IsolationMergeBlockReason as W, type IsolationMergeResult as X, type IsolationOutcome as Y, type IsolationPruneResult as Z, type IsolationRepo as _, AbstractTerminalSession as a, type TaskOutputSummary as a$, type IsolationTaskRecord as a0, type IsolationTaskRepo as a1, type IsolationTaskStatus as a2, type IsolationView as a3, type LaunchDeps as a4, type LaunchPlan as a5, type LegacyPlanState as a6, LineBuffer as a7, type Message as a8, ModelCatalog as a9, type ResearchLogEntry as aA, type ResearchProgress as aB, type ResearchStep as aC, type ResearchStepOutcome as aD, type ResearchToolType as aE, type ResolveContext as aF, type RunnerId as aG, type RunnerInvocation as aH, type RunnerPluginManifest as aI, RunnerRegistry as aJ, type RunnerSpawnOptions as aK, type RunnerTransport as aL, type StreamEvent as aM, type StreamStepEvent as aN, type StreamThinkingEvent as aO, type StructuredEvent as aP, type StructuredSessionCapability as aQ, type StructuredTurnEnd as aR, type SubagentLogEntry as aS, type SubagentOutcome as aT, type Task as aU, type TaskIsolation as aV, type TaskIsolationState as aW, type TaskMode as aX, type TaskModeAgentAdapter as aY, TaskModeUnsupportedError as aZ, type TaskModelAssignment as a_, type ModelShortcut as aa, ORCHESTRATOR_SHORTCUTS as ab, type OrchestratorOption as ac, type PlanIsolation as ad, type PlanModificationWarnings as ae, type PlanState as af, type PlanStatus as ag, type PlannerStartOptions as ah, type PlannerUsage as ai, type PluginCloneFn as aj, type PluginEntry as ak, type PluginFeatures as al, type PluginMode as am, type PluginModelDiscovery as an, type PluginRunnerDef as ao, type PreparedLaunch as ap, type PreparedTask as aq, type ProviderCredentialSource as ar, type ProviderModelLists as as, type ProviderModelsResult as at, type PtySize as au, type PtyWrapOptions as av, type QueuedMessage as aw, type QueuedTaskMessage as ax, type RepairEvidence as ay, type RepoGroupLayout as az, type ActiveTaskSession as b, wrapWithPty as b$, type TaskRunnerFlags as b0, type TaskSnapshot as b1, type TaskStartOptions as b2, type TaskStatus as b3, type TaskTransport as b4, type TaskType as b5, type TaskWithParent as b6, type ThinkingBlock as b7, type TreeSnapshot as b8, type UsageLine as b9, isMeasured as bA, isReservedRunnerName as bB, isRunnerApproval as bC, isRunnerTransport as bD, isStructuredSession as bE, keepExecutionState as bF, knownModelId as bG, migrateLegacyPlan as bH, migratePlanState as bI, migrateTask as bJ, partedPromptUsage as bK, planDirectLaunch as bL, planShellLaunch as bM, plannerContextFill as bN, posixShellQuote as bO, removeTaskFromPlan as bP, renumberTasks as bQ, resolveModelShortcut as bR, resolveProvider as bS, stripAnsi as bT, toApprovalDecision as bU, toOrchestratorOptions as bV, updateTaskInPlan as bW, usageLine as bX, validateModifiedPlan as bY, warningsText as bZ, windowsCommandLine as b_, type UsageRecord as ba, type UsageTotals as bb, type UserPromptEntry as bc, type UserStep as bd, type ValidationCheck as be, type ValidationContext as bf, type ValidationResult as bg, type Verdict as bh, type VerificationCheck as bi, WINDOWS_MAX_COMMAND_LINE as bj, addPlannerUsage as bk, addTaskToPlan as bl, addUsage as bm, approvalScopes as bn, buildShellInvocation as bo, collectProviderCredentials as bp, createEmptyPlan as bq, createTask as br, emptyWarnings as bs, enabledRunners as bt, fetchAllProviderModels as bu, flattenTasks as bv, flattenTasksWithParents as bw, isAwaitingReason as bx, isExecutableResolved as by, isGranted as bz, type AgentAdapter as c, type AgentAdapterFactory as d, type AgentEvent as e, type AgentProcessDeps as f, type AgentStartOptions as g, type AiProvider as h, type AllProviderModels as i, type ApprovalAnswer as j, type ApprovalDecision as k, type ApprovalKind as l, type ApprovalMode as m, ApprovalPolicy as n, type ApprovalPolicyOptions as o, type ApprovalRequest as p, type ApprovalSource as q, type AwaitingReason as r, type CatalogModel as s, CommandLineTooLongError as t, type ConversationMessage as u, type DiscoveredMode as v, type DiscoveredModel as w, type DiscoveryCommand as x, ExecutableNotFoundError as y, type HeadlessRunnerDeps as z };