@ordewell/core 0.6.4 → 0.7.1

package/dist/{plan-utils-Br8UAoiu.d.ts → plan-utils--kQRzSE-.d.ts}

@@ -1,5 +1,6 @@
-import { aS as StructuredTurnEnd, aU as SubagentOutcome, bb as UsageRecord, k as ApprovalDecision, aQ as StructuredEvent, aG as RunnerId, w as DiscoveredModel, aV as Task, a6 as LegacyPlanState, aw as QueuedMessage, bc as UsageTotals, bi as Verdict, aW as TaskIsolation, b5 as TaskTransport, r as AwaitingReason, ax as QueuedTaskMessage, Q as IsolationHandoff, X as IsolationMergeResult, aC as ResearchStep, l as ApprovalKind, q as ApprovalSource, aD as ResearchStepOutcome, u as ConversationMessage, aA as ResearchLogEntry, ai as PlannerUsage } from './Task-xqdxugt2.js';
-import { R as RunnerModeInfo } from './ModeResolver-ByNpC0EP.js';
+import { bb as StructuredTurnEnd, bd as SubagentOutcome, bE as UsageRecord, k as ApprovalDecision, b9 as StructuredEvent, a$ as RunnerId, y as DiscoveredModel, bh as Task, ab as LegacyPlanState, aQ as QueuedMessage, bF as UsageTotals, bL as Verdict, bj as TaskIsolation, by as TaskTransport, r as AwaitingReason, aR as QueuedTaskMessage, T as IsolationHandoff, _ as IsolationMergeResult, aX as ResearchStep, l as ApprovalKind, q as ApprovalSource, aY as ResearchStepOutcome, w as ConversationMessage, aV as ResearchLogEntry, aB as PlannerUsage, bk as TaskIsolationState } from './Task-BnLxkVQF.js';
+import { R as RunnerModeInfo } from './ModeResolver-DkMYf4uS.js';
+import './order-labels.js';
 
 /**
  * One entry of a structured task's log (ADR-0018, P1): what a runner did,
@@ -11,11 +12,12 @@ import { R as RunnerModeInfo } from './ModeResolver-ByNpC0EP.js';
  * without a format version.
  */
 type TaskLogEvent = 
-/** A turn began by delivering `message`; `messageId` names it when it had been queued. */
+/** A turn began by delivering `message`; `messageId` names it when it had been queued, `forced` when it was force sent. */
 {
     type: 'turn_start';
     message: string;
     messageId?: string;
+    forced?: boolean;
 } | {
     type: 'turn_end';
     reason: StructuredTurnEnd;
@@ -65,13 +67,37 @@ type TaskLogEvent =
 } | {
     type: 'usage';
     record: UsageRecord;
-} | {
+}
+/**
+ * Waiting in Ordewell's queue — again, for a message the runner was handed
+ * and let go of (ADR-0023, D4). `forced` moves it ahead of the rest (F2).
+ */
+ | {
     type: 'message_queued';
     messageId: string;
     text: string;
+    forced?: boolean;
 } | {
     type: 'message_removed';
     messageId: string;
+} | {
+    type: 'message_undelivered';
+    messageId: string;
+    text: string;
+}
+/** The runner accepted a queued message into its running turn; it can no longer be taken back. */
+ | {
+    type: 'message_handed_over';
+    messageId: string;
+}
+/**
+ * The model read a message inside its running turn (ADR-0023, Q2), logged
+ * where it read it. A message that opened a turn is that turn's `turn_start`.
+ */
+ | {
+    type: 'message_delivered';
+    messageId: string;
+    text: string;
 }
 /** The agent's own words for a failed turn. */
  | {
@@ -263,6 +289,8 @@ type SerializedTaskStatus = {
     transport?: Pick<TaskTransport, 'kind' | 'fallback'>;
     /** What an `awaiting_user` task waits on, when it was saved (ADR-0018, W1). */
     awaitingReason?: AwaitingReason;
+    /** The whole question of the checkpoint the task waits at; absent when it waits at none. */
+    checkpoint?: string;
     /** Messages waiting for a structured task's turn to end, oldest first; absent when there are none. */
     queued?: QueuedTaskMessage[];
     /** Set when the task can be continued in its saved runner session (ADR-0018, K1); the id itself stays in the daemon. */
@@ -578,7 +606,7 @@ type SessionNotice = {
 };
 type SessionBroadcaster = (msg: SessionMessage) => void;
 declare function serializeTask(t: Task): SerializedTask;
-declare function serializeTaskStatus(t: Task, idleSince?: string | null, isolation?: TaskIsolation | null, queued?: readonly QueuedTaskMessage[], awaitingApproval?: number, mergeGate?: readonly string[]): SerializedTaskStatus;
+declare function serializeTaskStatus(t: Task, idleSince?: string | null, isolation?: TaskIsolation | null, queued?: readonly QueuedTaskMessage[], awaitingApproval?: number, mergeGate?: readonly string[], checkpoint?: string): SerializedTaskStatus;
 declare function serializePlan(plan: LegacyPlanState): SerializedPlan;
 declare function executionSummary(tasks: readonly Task[]): {
     total: number;
@@ -647,6 +675,11 @@ interface ToolHeadline {
     keyArg: string;
 }
 type ToolStatus = 'pending' | 'ok' | 'error' | 'denied' | 'interrupted';
+/** What a file edit changed, counted from its diff. */
+interface DiffStat {
+    added: number;
+    removed: number;
+}
 interface ToolBlock {
     type: 'tool';
     id: string;
@@ -662,6 +695,8 @@ interface ToolBlock {
     output: string;
     /** Every line of `output`, counted as {@link outputPreview} counts them. */
     outputLineCount: number;
+    /** Present when the call edited a file and `output` is its diff: a surface draws it as one. */
+    diff?: DiffStat;
     turnId?: string;
     /**
      * The subagent this call starts. The call becomes that subagent's block once
@@ -787,7 +822,7 @@ declare function fromTranscript(conversationHistory: readonly ConversationMessag
  * one at a time.
  */
 interface TaskLogView extends BlockList {
-    /** Messages waiting for the running turn to end, oldest first. */
+    /** Messages not yet delivered, oldest first; `handedOver` marks the ones the runner already has. */
     readonly queued: readonly QueuedTaskMessage[];
     /** A turn is running. */
     readonly working: boolean;
@@ -831,6 +866,24 @@ interface OutputPreview {
 declare function outputLines(output: string): string[];
 /** The head of a tool's output for a collapsed row, and how many lines it leaves out. */
 declare function outputPreview(output: string, maxLines: number): OutputPreview;
+/**
+ * The lines a diff adds and removes, or null when `output` is not one: every
+ * line a hunk header, context, an addition or a removal, and at least one of
+ * the last two.
+ */
+declare function diffStat(output: string): DiffStat | null;
+/** `gap` stands between two hunks, for the lines a diff leaves out. */
+type DiffRowKind = 'added' | 'removed' | 'context' | 'gap';
+interface DiffRow {
+    kind: DiffRowKind;
+    /** The line in the file: the old file's for a removal, the new file's otherwise. */
+    line?: number;
+    text: string;
+}
+/** A diff as the rows a surface draws, numbered as an editor would number them. */
+declare function diffRows(output: string): DiffRow[];
+/** "Added 2 lines, removed 1 line": the summary every surface puts on an edit's row. */
+declare function diffSummary({ added, removed }: DiffStat): string;
 
 /**
  * Prompts the user sent while a planner turn was in flight, waiting to be the
@@ -900,4 +953,195 @@ declare function hasHiddenDetail(blocks: readonly DisplayBlock[]): boolean;
 /** The conversation line for a task starting, worded the same on every surface. */
 declare function taskStartedNotice(title: string, runner?: string): string;
 
-export { followTurn as $, type ApplyTaskOpsResult as A, type TurnGate as B, CHECKPOINT_TRUNCATE_LENGTH as C, type DisplayBlock as D, EMPTY_CONVERSATION as E, aheadOfDraft as F, type GatedConversation as G, applyTaskOps as H, canMergeTasks as I, canSetDependencies as J, canSplitTask as K, type LocalEntry as L, type MergeGateView as M, NO_TURN as N, type OutputPreview as O, type PlanBlock as P, capConflictFiles as Q, classifyOutcome as R, type SerializedPlan as S, type TakenPrompt as T, type UsageBlock as U, coalesceTaskLog as V, dependencyCandidates as W, dependentsOf as X, digestTaskLog as Y, drainNext as Z, executionSummary as _, type ApprovalBlock as a, fromTranscript as a0, hasHiddenDetail as a1, holdPrompt as a2, outputLines as a3, outputPreview as a4, parseTaskOpsJson as a5, reduceConversation as a6, reduceTaskLog as a7, replayTaskLog as a8, runnerToolSubject as a9, serializePlan as aa, serializeTask as ab, serializeTaskStatus as ac, stopTurn as ad, summarizeToolCall as ae, taskStartedNotice as af, textHasTaskOps as ag, toTaskLogEvent as ah, toolHeadline as ai, trimToolOutput as aj, truncateCheckpointSummary as ak, unsendAll as al, unsendLatest as am, type ApprovalStatus as b, type ConversationInput as c, type ConversationView as d, EMPTY_HOLD as e, EMPTY_TASK_LOG as f, type MessageBlock as g, type MessageRole as h, type PlanMarkerStatus as i, type PromptHold as j, type SerializedTask as k, type SerializedTaskStatus as l, type SessionBroadcaster as m, type SessionMessage as n, type SessionNotice as o, type SubagentBlock as p, type SubagentChild as q, type SubagentStatus as r, type TaskLogEvent as s, type TaskLogView as t, type TaskOp as u, type TaskRef as v, type ThinkingDisplayBlock as w, type ToolBlock as x, type ToolHeadline as y, type ToolStatus as z };
+/**
+ * What a row's status means to a reader, before any surface picks a word,
+ * icon or colour for it. `quiet` is a running task whose runner has printed
+ * nothing for a while — the status is still `in_progress`, so only the row,
+ * never the store, tells the two apart.
+ */
+type TaskStatusKind = 'todo' | 'running' | 'quiet' | 'awaiting' | 'blocked' | 'failed' | 'done';
+/** A task with a runner live behind it. `in_progress` is the store's own status. */
+declare const isTaskRunning: (task: {
+    status: string;
+}) => boolean;
+/** Statuses of a task that has not started: what can still be started by hand, or flipped between change and ops (ADR-0020). */
+declare const NOT_STARTED: ReadonlySet<string>;
+declare function taskStatusKind(task: {
+    status: string;
+    idleSince?: string | null;
+}): TaskStatusKind;
+/** What an awaiting_user task waits on (ADR-0018, W1); null when no reason was saved. */
+declare function awaitingLabel(task: {
+    status: string;
+    awaitingReason?: AwaitingReason;
+}): string | null;
+/** Runner requests a task waits on (ADR-0018, A1); null when none do. */
+declare function approvalLabel(count: number | undefined): string | null;
+
+/** What a user can do to one task from its row. */
+type TaskRowAction = 'cancel' | 'skip' | 'force-start' | 'complete' | 'uncomplete';
+/** A subtask runs with its parent, so its row offers a different set than a top-level task's. */
+type TaskRowPlacement = 'task' | 'subtask';
+interface ActionSubject {
+    status: string;
+    type: 'ai' | 'user';
+}
+/** The actions a task's row offers while a plan runs, in the order they are laid out. */
+declare function taskRowActions(task: ActionSubject, placement?: TaskRowPlacement): TaskRowAction[];
+/**
+ * One toggle in both directions: a done task is taken back, anything else is
+ * marked done. A second control for the reverse is one nobody remembers.
+ */
+declare function markAction(task: {
+    status: string;
+}): 'complete' | 'uncomplete';
+/**
+ * The mark an action asks the session for, or null when it is not a mark.
+ * Skip has no request of its own: a skipped task is marked complete, so the
+ * run moves on past it.
+ */
+declare function markRequestFor(action: string): 'complete' | 'uncomplete' | null;
+/** Change versus ops can still be flipped (ADR-0020): an AI task that has not started. */
+declare function opsEditable(task: ActionSubject): boolean;
+
+/**
+ * A task as both surfaces hold it, with the live state each tracks beside it
+ * (silence, approvals, isolation, the merge gate). Structural, because the TUI
+ * projects tasks into its own shape.
+ */
+interface TaskRowSubject {
+    id: string;
+    order: number;
+    type: 'ai' | 'user';
+    status: string;
+    dependencies: readonly string[];
+    taskMode?: string;
+    ops?: boolean;
+    idleSince?: string | null;
+    awaitingReason?: AwaitingReason;
+    awaitingApproval?: number;
+    isolation?: TaskRowIsolation | null;
+    mergeGate?: readonly string[];
+    forcedPastGate?: readonly string[];
+}
+interface TaskRowIsolation {
+    state: TaskIsolationState;
+    repos?: string[];
+    conflictRepo?: string;
+    conflictFiles?: string[];
+    repair?: {
+        attempt: number;
+        limit: number;
+    };
+    repairedFiles?: string[];
+}
+interface TaskRowContext {
+    /** Set for a subtask: it is labelled by its dotted order. */
+    parent?: {
+        order: number;
+    } | null;
+    /** Which action set the row offers; a row with a parent is a subtask's unless told otherwise. */
+    placement?: TaskRowPlacement;
+    /** Order of each task a dependency or gate may name; one missing from it is shown by id. */
+    orderOf?: ReadonlyMap<string, number>;
+    /** The modes the task's runner declares; autonomy is a tag on one of them (ADR-0001). */
+    modes?: readonly {
+        id: string;
+        autonomous?: boolean;
+    }[];
+}
+/** Whether the row stands for an AI task, a manual one, or an ops task (ADR-0020). */
+type TaskRowKind = 'ai' | 'user' | 'ops';
+interface TaskRowView {
+    /** "2", or "2.1" for a subtask. */
+    orderLabel: string;
+    kind: TaskRowKind;
+    status: TaskStatusKind;
+    /** A runner is live behind it — `quiet` included. */
+    running: boolean;
+    /** What an awaiting task waits on, in sentence case; null when nothing was saved. */
+    awaiting: string | null;
+    /** Runner requests waiting on the user, in sentence case; null when none do. */
+    approvals: string | null;
+    /** The task's mode is tagged autonomous: it runs without permission prompts. */
+    autonomous: boolean;
+    /** The repos its isolated work changed, by path; empty for a group of one. */
+    repos: string[];
+    /** Integration stopped on a conflict: the one isolation state that needs the user. */
+    conflict: {
+        repo: string | null;
+        files: string | null;
+    } | null;
+    /** A conflict repair in flight (ADR-0015) — progress, not a blocker. */
+    repairing: {
+        files: string | null;
+        attempt: {
+            attempt: number;
+            limit: number;
+        } | null;
+    } | null;
+    /** The files a conflict repair was started for; `landed` once the task is integrated. */
+    repaired: {
+        files: string;
+        landed: boolean;
+    } | null;
+    /** The dependencies, by reference, whose work is not merged into the user's branch yet. */
+    mergeGate: string[] | null;
+    /** An ops task changed tracked files in the user's checkout and nothing was committed. */
+    opsChangedFiles: boolean;
+    /** The dependencies, by title, a force start went past the merge gate of. */
+    forcedPastGate: readonly string[] | null;
+    /** The task's dependencies, by reference. */
+    dependencies: string[];
+    /** What the row offers while a plan runs. */
+    actions: TaskRowAction[];
+    /** The one mark its toggle sets. */
+    mark: 'complete' | 'uncomplete';
+    opsEditable: boolean;
+}
+/** The repos a task changed, for a row that names them; none for a group of one. */
+declare const namedRepos: (repos: readonly string[] | undefined) => string[];
+/**
+ * Everything a plan row says about one task, decided once: each surface picks
+ * its own words, glyphs and casing for these facts, and derives none of them.
+ */
+declare function taskRowView(task: TaskRowSubject, context?: TaskRowContext): TaskRowView;
+
+interface Named {
+    id: string;
+    order: number;
+    title: string;
+    subtasks?: readonly Named[];
+}
+/** Each id as "#N title", subtasks included; one the plan no longer holds stays a bare id. */
+declare function titledRefs(ids: readonly string[], tasks: readonly Named[]): string[];
+/**
+ * What removing a task does to the tasks that depend on it, or null when none
+ * do. Named rather than counted: the removal rewrites their dependency lists,
+ * and a bare "Remove task?" would hide that.
+ */
+declare function dependentsNotice(dependents: readonly {
+    order: number;
+    title: string;
+}[]): string | null;
+/**
+ * What a start past a merge gate is asked with (ADR-0020): the work the task
+ * would act without, named. `subject` is how the asking surface refers to the
+ * task — "It" under a title that already names it.
+ */
+declare function pastGateConfirmation(unmerged: readonly string[], subject?: string): string;
+interface NewTaskFields {
+    title: string;
+    description: string;
+    prompt: string;
+    type: 'ai';
+}
+/**
+ * What a hand-added task starts as: an AI task whose description is its title
+ * and whose prompt, unless one was typed, is too. Null for a title with nothing
+ * in it, rather than a nameless task. Assignments are left for the session to
+ * derive from the runner's catalog.
+ */
+declare function newTaskFields(title: string, prompt?: string): NewTaskFields | null;
+
+export { aheadOfDraft as $, type ApplyTaskOpsResult as A, type TaskRef as B, CHECKPOINT_TRUNCATE_LENGTH as C, type DiffRow as D, EMPTY_CONVERSATION as E, type TaskRowAction as F, type GatedConversation as G, type TaskRowContext as H, type TaskRowIsolation as I, type TaskRowKind as J, type TaskRowPlacement as K, type LocalEntry as L, type MergeGateView as M, NOT_STARTED as N, type OutputPreview as O, type PlanBlock as P, type TaskRowSubject as Q, type TaskRowView as R, type SerializedPlan as S, type TakenPrompt as T, type TaskStatusKind as U, type ThinkingDisplayBlock as V, type ToolBlock as W, type ToolHeadline as X, type ToolStatus as Y, type TurnGate as Z, type UsageBlock as _, type ApprovalBlock as a, applyTaskOps as a0, approvalLabel as a1, awaitingLabel as a2, canMergeTasks as a3, canSetDependencies as a4, canSplitTask as a5, capConflictFiles as a6, classifyOutcome as a7, coalesceTaskLog as a8, dependencyCandidates as a9, serializePlan as aA, serializeTask as aB, serializeTaskStatus as aC, stopTurn as aD, summarizeToolCall as aE, taskRowActions as aF, taskRowView as aG, taskStartedNotice as aH, taskStatusKind as aI, textHasTaskOps as aJ, titledRefs as aK, toTaskLogEvent as aL, toolHeadline as aM, trimToolOutput as aN, truncateCheckpointSummary as aO, unsendAll as aP, unsendLatest as aQ, dependentsNotice as aa, dependentsOf as ab, diffRows as ac, diffStat as ad, diffSummary as ae, digestTaskLog as af, drainNext as ag, executionSummary as ah, followTurn as ai, fromTranscript as aj, hasHiddenDetail as ak, holdPrompt as al, isTaskRunning as am, markAction as an, markRequestFor as ao, namedRepos as ap, newTaskFields as aq, opsEditable as ar, outputLines as as, outputPreview as at, parseTaskOpsJson as au, pastGateConfirmation as av, reduceConversation as aw, reduceTaskLog as ax, replayTaskLog as ay, runnerToolSubject as az, type ApprovalStatus as b, type ConversationInput as c, type ConversationView as d, type DiffRowKind as e, type DiffStat as f, type DisplayBlock as g, EMPTY_HOLD as h, EMPTY_TASK_LOG as i, type MessageBlock as j, type MessageRole as k, NO_TURN as l, type NewTaskFields as m, type PlanMarkerStatus as n, type PromptHold as o, type SerializedTask as p, type SerializedTaskStatus as q, type SessionBroadcaster as r, type SessionMessage as s, type SessionNotice as t, type SubagentBlock as u, type SubagentChild as v, type SubagentStatus as w, type TaskLogEvent as x, type TaskLogView as y, type TaskOp as z };

package/dist/{plan-utils-DMgajMvd.d.mts → plan-utils-CKgNtDwQ.d.mts}

@@ -1,5 +1,6 @@
-import { aS as StructuredTurnEnd, aU as SubagentOutcome, bb as UsageRecord, k as ApprovalDecision, aQ as StructuredEvent, aG as RunnerId, w as DiscoveredModel, aV as Task, a6 as LegacyPlanState, aw as QueuedMessage, bc as UsageTotals, bi as Verdict, aW as TaskIsolation, b5 as TaskTransport, r as AwaitingReason, ax as QueuedTaskMessage, Q as IsolationHandoff, X as IsolationMergeResult, aC as ResearchStep, l as ApprovalKind, q as ApprovalSource, aD as ResearchStepOutcome, u as ConversationMessage, aA as ResearchLogEntry, ai as PlannerUsage } from './Task-xqdxugt2.mjs';
-import { R as RunnerModeInfo } from './ModeResolver-rqaY_4Ex.mjs';
+import { bb as StructuredTurnEnd, bd as SubagentOutcome, bE as UsageRecord, k as ApprovalDecision, b9 as StructuredEvent, a$ as RunnerId, y as DiscoveredModel, bh as Task, ab as LegacyPlanState, aQ as QueuedMessage, bF as UsageTotals, bL as Verdict, bj as TaskIsolation, by as TaskTransport, r as AwaitingReason, aR as QueuedTaskMessage, T as IsolationHandoff, _ as IsolationMergeResult, aX as ResearchStep, l as ApprovalKind, q as ApprovalSource, aY as ResearchStepOutcome, w as ConversationMessage, aV as ResearchLogEntry, aB as PlannerUsage, bk as TaskIsolationState } from './Task-BnLxkVQF.mjs';
+import { R as RunnerModeInfo } from './ModeResolver-DZzJSdIU.mjs';
+import './order-labels.mjs';
 
 /**
  * One entry of a structured task's log (ADR-0018, P1): what a runner did,
@@ -11,11 +12,12 @@ import { R as RunnerModeInfo } from './ModeResolver-rqaY_4Ex.mjs';
  * without a format version.
  */
 type TaskLogEvent = 
-/** A turn began by delivering `message`; `messageId` names it when it had been queued. */
+/** A turn began by delivering `message`; `messageId` names it when it had been queued, `forced` when it was force sent. */
 {
     type: 'turn_start';
     message: string;
     messageId?: string;
+    forced?: boolean;
 } | {
     type: 'turn_end';
     reason: StructuredTurnEnd;
@@ -65,13 +67,37 @@ type TaskLogEvent =
 } | {
     type: 'usage';
     record: UsageRecord;
-} | {
+}
+/**
+ * Waiting in Ordewell's queue — again, for a message the runner was handed
+ * and let go of (ADR-0023, D4). `forced` moves it ahead of the rest (F2).
+ */
+ | {
     type: 'message_queued';
     messageId: string;
     text: string;
+    forced?: boolean;
 } | {
     type: 'message_removed';
     messageId: string;
+} | {
+    type: 'message_undelivered';
+    messageId: string;
+    text: string;
+}
+/** The runner accepted a queued message into its running turn; it can no longer be taken back. */
+ | {
+    type: 'message_handed_over';
+    messageId: string;
+}
+/**
+ * The model read a message inside its running turn (ADR-0023, Q2), logged
+ * where it read it. A message that opened a turn is that turn's `turn_start`.
+ */
+ | {
+    type: 'message_delivered';
+    messageId: string;
+    text: string;
 }
 /** The agent's own words for a failed turn. */
  | {
@@ -263,6 +289,8 @@ type SerializedTaskStatus = {
     transport?: Pick<TaskTransport, 'kind' | 'fallback'>;
     /** What an `awaiting_user` task waits on, when it was saved (ADR-0018, W1). */
     awaitingReason?: AwaitingReason;
+    /** The whole question of the checkpoint the task waits at; absent when it waits at none. */
+    checkpoint?: string;
     /** Messages waiting for a structured task's turn to end, oldest first; absent when there are none. */
     queued?: QueuedTaskMessage[];
     /** Set when the task can be continued in its saved runner session (ADR-0018, K1); the id itself stays in the daemon. */
@@ -578,7 +606,7 @@ type SessionNotice = {
 };
 type SessionBroadcaster = (msg: SessionMessage) => void;
 declare function serializeTask(t: Task): SerializedTask;
-declare function serializeTaskStatus(t: Task, idleSince?: string | null, isolation?: TaskIsolation | null, queued?: readonly QueuedTaskMessage[], awaitingApproval?: number, mergeGate?: readonly string[]): SerializedTaskStatus;
+declare function serializeTaskStatus(t: Task, idleSince?: string | null, isolation?: TaskIsolation | null, queued?: readonly QueuedTaskMessage[], awaitingApproval?: number, mergeGate?: readonly string[], checkpoint?: string): SerializedTaskStatus;
 declare function serializePlan(plan: LegacyPlanState): SerializedPlan;
 declare function executionSummary(tasks: readonly Task[]): {
     total: number;
@@ -647,6 +675,11 @@ interface ToolHeadline {
     keyArg: string;
 }
 type ToolStatus = 'pending' | 'ok' | 'error' | 'denied' | 'interrupted';
+/** What a file edit changed, counted from its diff. */
+interface DiffStat {
+    added: number;
+    removed: number;
+}
 interface ToolBlock {
     type: 'tool';
     id: string;
@@ -662,6 +695,8 @@ interface ToolBlock {
     output: string;
     /** Every line of `output`, counted as {@link outputPreview} counts them. */
     outputLineCount: number;
+    /** Present when the call edited a file and `output` is its diff: a surface draws it as one. */
+    diff?: DiffStat;
     turnId?: string;
     /**
      * The subagent this call starts. The call becomes that subagent's block once
@@ -787,7 +822,7 @@ declare function fromTranscript(conversationHistory: readonly ConversationMessag
  * one at a time.
  */
 interface TaskLogView extends BlockList {
-    /** Messages waiting for the running turn to end, oldest first. */
+    /** Messages not yet delivered, oldest first; `handedOver` marks the ones the runner already has. */
     readonly queued: readonly QueuedTaskMessage[];
     /** A turn is running. */
     readonly working: boolean;
@@ -831,6 +866,24 @@ interface OutputPreview {
 declare function outputLines(output: string): string[];
 /** The head of a tool's output for a collapsed row, and how many lines it leaves out. */
 declare function outputPreview(output: string, maxLines: number): OutputPreview;
+/**
+ * The lines a diff adds and removes, or null when `output` is not one: every
+ * line a hunk header, context, an addition or a removal, and at least one of
+ * the last two.
+ */
+declare function diffStat(output: string): DiffStat | null;
+/** `gap` stands between two hunks, for the lines a diff leaves out. */
+type DiffRowKind = 'added' | 'removed' | 'context' | 'gap';
+interface DiffRow {
+    kind: DiffRowKind;
+    /** The line in the file: the old file's for a removal, the new file's otherwise. */
+    line?: number;
+    text: string;
+}
+/** A diff as the rows a surface draws, numbered as an editor would number them. */
+declare function diffRows(output: string): DiffRow[];
+/** "Added 2 lines, removed 1 line": the summary every surface puts on an edit's row. */
+declare function diffSummary({ added, removed }: DiffStat): string;
 
 /**
  * Prompts the user sent while a planner turn was in flight, waiting to be the
@@ -900,4 +953,195 @@ declare function hasHiddenDetail(blocks: readonly DisplayBlock[]): boolean;
 /** The conversation line for a task starting, worded the same on every surface. */
 declare function taskStartedNotice(title: string, runner?: string): string;
 
-export { followTurn as $, type ApplyTaskOpsResult as A, type TurnGate as B, CHECKPOINT_TRUNCATE_LENGTH as C, type DisplayBlock as D, EMPTY_CONVERSATION as E, aheadOfDraft as F, type GatedConversation as G, applyTaskOps as H, canMergeTasks as I, canSetDependencies as J, canSplitTask as K, type LocalEntry as L, type MergeGateView as M, NO_TURN as N, type OutputPreview as O, type PlanBlock as P, capConflictFiles as Q, classifyOutcome as R, type SerializedPlan as S, type TakenPrompt as T, type UsageBlock as U, coalesceTaskLog as V, dependencyCandidates as W, dependentsOf as X, digestTaskLog as Y, drainNext as Z, executionSummary as _, type ApprovalBlock as a, fromTranscript as a0, hasHiddenDetail as a1, holdPrompt as a2, outputLines as a3, outputPreview as a4, parseTaskOpsJson as a5, reduceConversation as a6, reduceTaskLog as a7, replayTaskLog as a8, runnerToolSubject as a9, serializePlan as aa, serializeTask as ab, serializeTaskStatus as ac, stopTurn as ad, summarizeToolCall as ae, taskStartedNotice as af, textHasTaskOps as ag, toTaskLogEvent as ah, toolHeadline as ai, trimToolOutput as aj, truncateCheckpointSummary as ak, unsendAll as al, unsendLatest as am, type ApprovalStatus as b, type ConversationInput as c, type ConversationView as d, EMPTY_HOLD as e, EMPTY_TASK_LOG as f, type MessageBlock as g, type MessageRole as h, type PlanMarkerStatus as i, type PromptHold as j, type SerializedTask as k, type SerializedTaskStatus as l, type SessionBroadcaster as m, type SessionMessage as n, type SessionNotice as o, type SubagentBlock as p, type SubagentChild as q, type SubagentStatus as r, type TaskLogEvent as s, type TaskLogView as t, type TaskOp as u, type TaskRef as v, type ThinkingDisplayBlock as w, type ToolBlock as x, type ToolHeadline as y, type ToolStatus as z };
+/**
+ * What a row's status means to a reader, before any surface picks a word,
+ * icon or colour for it. `quiet` is a running task whose runner has printed
+ * nothing for a while — the status is still `in_progress`, so only the row,
+ * never the store, tells the two apart.
+ */
+type TaskStatusKind = 'todo' | 'running' | 'quiet' | 'awaiting' | 'blocked' | 'failed' | 'done';
+/** A task with a runner live behind it. `in_progress` is the store's own status. */
+declare const isTaskRunning: (task: {
+    status: string;
+}) => boolean;
+/** Statuses of a task that has not started: what can still be started by hand, or flipped between change and ops (ADR-0020). */
+declare const NOT_STARTED: ReadonlySet<string>;
+declare function taskStatusKind(task: {
+    status: string;
+    idleSince?: string | null;
+}): TaskStatusKind;
+/** What an awaiting_user task waits on (ADR-0018, W1); null when no reason was saved. */
+declare function awaitingLabel(task: {
+    status: string;
+    awaitingReason?: AwaitingReason;
+}): string | null;
+/** Runner requests a task waits on (ADR-0018, A1); null when none do. */
+declare function approvalLabel(count: number | undefined): string | null;
+
+/** What a user can do to one task from its row. */
+type TaskRowAction = 'cancel' | 'skip' | 'force-start' | 'complete' | 'uncomplete';
+/** A subtask runs with its parent, so its row offers a different set than a top-level task's. */
+type TaskRowPlacement = 'task' | 'subtask';
+interface ActionSubject {
+    status: string;
+    type: 'ai' | 'user';
+}
+/** The actions a task's row offers while a plan runs, in the order they are laid out. */
+declare function taskRowActions(task: ActionSubject, placement?: TaskRowPlacement): TaskRowAction[];
+/**
+ * One toggle in both directions: a done task is taken back, anything else is
+ * marked done. A second control for the reverse is one nobody remembers.
+ */
+declare function markAction(task: {
+    status: string;
+}): 'complete' | 'uncomplete';
+/**
+ * The mark an action asks the session for, or null when it is not a mark.
+ * Skip has no request of its own: a skipped task is marked complete, so the
+ * run moves on past it.
+ */
+declare function markRequestFor(action: string): 'complete' | 'uncomplete' | null;
+/** Change versus ops can still be flipped (ADR-0020): an AI task that has not started. */
+declare function opsEditable(task: ActionSubject): boolean;
+
+/**
+ * A task as both surfaces hold it, with the live state each tracks beside it
+ * (silence, approvals, isolation, the merge gate). Structural, because the TUI
+ * projects tasks into its own shape.
+ */
+interface TaskRowSubject {
+    id: string;
+    order: number;
+    type: 'ai' | 'user';
+    status: string;
+    dependencies: readonly string[];
+    taskMode?: string;
+    ops?: boolean;
+    idleSince?: string | null;
+    awaitingReason?: AwaitingReason;
+    awaitingApproval?: number;
+    isolation?: TaskRowIsolation | null;
+    mergeGate?: readonly string[];
+    forcedPastGate?: readonly string[];
+}
+interface TaskRowIsolation {
+    state: TaskIsolationState;
+    repos?: string[];
+    conflictRepo?: string;
+    conflictFiles?: string[];
+    repair?: {
+        attempt: number;
+        limit: number;
+    };
+    repairedFiles?: string[];
+}
+interface TaskRowContext {
+    /** Set for a subtask: it is labelled by its dotted order. */
+    parent?: {
+        order: number;
+    } | null;
+    /** Which action set the row offers; a row with a parent is a subtask's unless told otherwise. */
+    placement?: TaskRowPlacement;
+    /** Order of each task a dependency or gate may name; one missing from it is shown by id. */
+    orderOf?: ReadonlyMap<string, number>;
+    /** The modes the task's runner declares; autonomy is a tag on one of them (ADR-0001). */
+    modes?: readonly {
+        id: string;
+        autonomous?: boolean;
+    }[];
+}
+/** Whether the row stands for an AI task, a manual one, or an ops task (ADR-0020). */
+type TaskRowKind = 'ai' | 'user' | 'ops';
+interface TaskRowView {
+    /** "2", or "2.1" for a subtask. */
+    orderLabel: string;
+    kind: TaskRowKind;
+    status: TaskStatusKind;
+    /** A runner is live behind it — `quiet` included. */
+    running: boolean;
+    /** What an awaiting task waits on, in sentence case; null when nothing was saved. */
+    awaiting: string | null;
+    /** Runner requests waiting on the user, in sentence case; null when none do. */
+    approvals: string | null;
+    /** The task's mode is tagged autonomous: it runs without permission prompts. */
+    autonomous: boolean;
+    /** The repos its isolated work changed, by path; empty for a group of one. */
+    repos: string[];
+    /** Integration stopped on a conflict: the one isolation state that needs the user. */
+    conflict: {
+        repo: string | null;
+        files: string | null;
+    } | null;
+    /** A conflict repair in flight (ADR-0015) — progress, not a blocker. */
+    repairing: {
+        files: string | null;
+        attempt: {
+            attempt: number;
+            limit: number;
+        } | null;
+    } | null;
+    /** The files a conflict repair was started for; `landed` once the task is integrated. */
+    repaired: {
+        files: string;
+        landed: boolean;
+    } | null;
+    /** The dependencies, by reference, whose work is not merged into the user's branch yet. */
+    mergeGate: string[] | null;
+    /** An ops task changed tracked files in the user's checkout and nothing was committed. */
+    opsChangedFiles: boolean;
+    /** The dependencies, by title, a force start went past the merge gate of. */
+    forcedPastGate: readonly string[] | null;
+    /** The task's dependencies, by reference. */
+    dependencies: string[];
+    /** What the row offers while a plan runs. */
+    actions: TaskRowAction[];
+    /** The one mark its toggle sets. */
+    mark: 'complete' | 'uncomplete';
+    opsEditable: boolean;
+}
+/** The repos a task changed, for a row that names them; none for a group of one. */
+declare const namedRepos: (repos: readonly string[] | undefined) => string[];
+/**
+ * Everything a plan row says about one task, decided once: each surface picks
+ * its own words, glyphs and casing for these facts, and derives none of them.
+ */
+declare function taskRowView(task: TaskRowSubject, context?: TaskRowContext): TaskRowView;
+
+interface Named {
+    id: string;
+    order: number;
+    title: string;
+    subtasks?: readonly Named[];
+}
+/** Each id as "#N title", subtasks included; one the plan no longer holds stays a bare id. */
+declare function titledRefs(ids: readonly string[], tasks: readonly Named[]): string[];
+/**
+ * What removing a task does to the tasks that depend on it, or null when none
+ * do. Named rather than counted: the removal rewrites their dependency lists,
+ * and a bare "Remove task?" would hide that.
+ */
+declare function dependentsNotice(dependents: readonly {
+    order: number;
+    title: string;
+}[]): string | null;
+/**
+ * What a start past a merge gate is asked with (ADR-0020): the work the task
+ * would act without, named. `subject` is how the asking surface refers to the
+ * task — "It" under a title that already names it.
+ */
+declare function pastGateConfirmation(unmerged: readonly string[], subject?: string): string;
+interface NewTaskFields {
+    title: string;
+    description: string;
+    prompt: string;
+    type: 'ai';
+}
+/**
+ * What a hand-added task starts as: an AI task whose description is its title
+ * and whose prompt, unless one was typed, is too. Null for a title with nothing
+ * in it, rather than a nameless task. Assignments are left for the session to
+ * derive from the runner's catalog.
+ */
+declare function newTaskFields(title: string, prompt?: string): NewTaskFields | null;
+
+export { aheadOfDraft as $, type ApplyTaskOpsResult as A, type TaskRef as B, CHECKPOINT_TRUNCATE_LENGTH as C, type DiffRow as D, EMPTY_CONVERSATION as E, type TaskRowAction as F, type GatedConversation as G, type TaskRowContext as H, type TaskRowIsolation as I, type TaskRowKind as J, type TaskRowPlacement as K, type LocalEntry as L, type MergeGateView as M, NOT_STARTED as N, type OutputPreview as O, type PlanBlock as P, type TaskRowSubject as Q, type TaskRowView as R, type SerializedPlan as S, type TakenPrompt as T, type TaskStatusKind as U, type ThinkingDisplayBlock as V, type ToolBlock as W, type ToolHeadline as X, type ToolStatus as Y, type TurnGate as Z, type UsageBlock as _, type ApprovalBlock as a, applyTaskOps as a0, approvalLabel as a1, awaitingLabel as a2, canMergeTasks as a3, canSetDependencies as a4, canSplitTask as a5, capConflictFiles as a6, classifyOutcome as a7, coalesceTaskLog as a8, dependencyCandidates as a9, serializePlan as aA, serializeTask as aB, serializeTaskStatus as aC, stopTurn as aD, summarizeToolCall as aE, taskRowActions as aF, taskRowView as aG, taskStartedNotice as aH, taskStatusKind as aI, textHasTaskOps as aJ, titledRefs as aK, toTaskLogEvent as aL, toolHeadline as aM, trimToolOutput as aN, truncateCheckpointSummary as aO, unsendAll as aP, unsendLatest as aQ, dependentsNotice as aa, dependentsOf as ab, diffRows as ac, diffStat as ad, diffSummary as ae, digestTaskLog as af, drainNext as ag, executionSummary as ah, followTurn as ai, fromTranscript as aj, hasHiddenDetail as ak, holdPrompt as al, isTaskRunning as am, markAction as an, markRequestFor as ao, namedRepos as ap, newTaskFields as aq, opsEditable as ar, outputLines as as, outputPreview as at, parseTaskOpsJson as au, pastGateConfirmation as av, reduceConversation as aw, reduceTaskLog as ax, replayTaskLog as ay, runnerToolSubject as az, type ApprovalStatus as b, type ConversationInput as c, type ConversationView as d, type DiffRowKind as e, type DiffStat as f, type DisplayBlock as g, EMPTY_HOLD as h, EMPTY_TASK_LOG as i, type MessageBlock as j, type MessageRole as k, NO_TURN as l, type NewTaskFields as m, type PlanMarkerStatus as n, type PromptHold as o, type SerializedTask as p, type SerializedTaskStatus as q, type SessionBroadcaster as r, type SessionMessage as s, type SessionNotice as t, type SubagentBlock as u, type SubagentChild as v, type SubagentStatus as w, type TaskLogEvent as x, type TaskLogView as y, type TaskOp as z };