@mu-crew/mu 3.12.0 → 3.13.1

package/dist/index.d.ts

@@ -1,6 +1,17 @@
 import { Database } from 'better-sqlite3';
 
 type CtlState = "busy" | "idle";
+/**
+ * pi is waiting on a blocking extension dialog (ui_prompt_start without
+ * its ui_prompt_end): a confirm, select, input, editor or custom prompt.
+ * `kind` and `title` are the innermost open dialog's; `since` is when the
+ * first one opened (ms epoch).
+ */
+type CtlBlocked = {
+    kind: string;
+    title?: string;
+    since: number;
+};
 /** Session commands the `command` op runs: `/new`, `/reload`, `/compact`. */
 declare const CTL_COMMANDS: readonly ["new", "reload", "compact"];
 type CtlCommandName = (typeof CTL_COMMANDS)[number];
@@ -22,6 +33,8 @@ interface StateReading {
     pending?: boolean;
     /** ctl only: pi's settled-run count (`mu agent wait --after-runs`). */
     runs?: number;
+    /** ctl only: the extension dialog pi is waiting on (state needs_permission). */
+    blocked?: CtlBlocked;
 }
 interface StateAgentRef {
     name: string;
@@ -30,8 +43,9 @@ interface StateAgentRef {
     /** When set and it names pi, the control socket is the state source. */
     cli?: string;
 }
-/** ctl's idle maps to needs_input, the same as murmur's idle. */
-declare function ctlRuntimeState(state: CtlState): RuntimeState;
+/** ctl's idle maps to needs_input, the same as murmur's idle; an open
+ *  extension dialog (`blocked`) maps to needs_permission. */
+declare function ctlRuntimeState(state: CtlState, blocked?: CtlBlocked): RuntimeState;
 declare const UNKNOWN_REASON: {
     readonly murmurMissing: "murmur not installed";
     readonly extensionMissing: "murmur pi extension not linked";
@@ -466,9 +480,14 @@ interface MuxBackend {
     listPanesInSession(session: string): Promise<MuxPane[]>;
     splitWindow(opts: SplitWindowOptions): Promise<string>;
     killPane(paneId: string): Promise<void>;
+    /** False only when the mux reports the pane (or server) gone; throws
+     *  when the probe itself fails, so liveness gates fail closed. */
     paneExists(paneId: string): Promise<boolean>;
     paneTTY(paneId: string): Promise<string>;
     setPaneTitle(paneId: string, title: string): Promise<void>;
+    /** Stop the pane's program from retitling it (tmux `allow-set-title off`;
+     *  pi emits OSC "π - <cwd>"). No-op where the backend has no equivalent. */
+    lockPaneTitle(paneId: string): Promise<void>;
     getPaneTitle(paneId: string): Promise<string | undefined>;
     currentAgentName(): Promise<string | undefined>;
     /** Name of the session the CALLER is running inside, or undefined
@@ -672,7 +691,7 @@ type HerdrExecutor = (args: readonly string[]) => Promise<HerdrExecResult>;
  * Required: the fast test tier may not shell out.
  */
 declare function setHerdrExecutor(executor: HerdrExecutor): HerdrExecutor;
-/** Restore the real (execa-backed) executor. */
+/** Restore the real (child_process-backed) executor. */
 declare function resetHerdrExecutor(): void;
 /**
  * True iff a `herdr status` payload describes a server mu can drive.
@@ -753,7 +772,7 @@ type TmuxExecutor = (args: readonly string[]) => Promise<TmuxExecResult>;
  * tests can restore it cleanly. Production code should never call this.
  */
 declare function setTmuxExecutor(executor: TmuxExecutor): TmuxExecutor;
-/** Restore the real (execa-backed) executor. */
+/** Restore the real (child_process-backed) executor. */
 declare function resetTmuxExecutor(): void;
 /**
  * Run an arbitrary tmux command. The single point of contact with the
@@ -837,6 +856,8 @@ declare function splitWindow(opts: SplitWindowOptions): Promise<string>;
 declare function killPane(paneId: string): Promise<void>;
 declare function paneExists(paneId: string): Promise<boolean>;
 declare function setPaneTitle(paneId: string, title: string): Promise<void>;
+/** Pane-scoped `allow-set-title off`: OSC title escapes from the app no longer overwrite the mu title. */
+declare function lockPaneTitle(paneId: string): Promise<void>;
 /**
  * Look up the window id (e.g. `@42`) that contains a given pane id
  * (e.g. `%15`). Used by spawn so we can apply window-scoped options
@@ -1203,6 +1224,14 @@ type InterruptResult = {
 declare function interruptAgent(db: Db, name: string, text: string, opts: AbortAgentOptions): Promise<InterruptResult>;
 
 type VcsBackendName = "jj" | "sl" | "git" | "none";
+/** Out-parameter for `detect()`: set `failed` when a root probe could not
+ *  answer (spawn error, signal, timeout) as opposed to cleanly saying "not
+ *  this VCS". A caller that caches the detected backend must not cache
+ *  when `failed` is set: the probe may have hidden a higher-precedence
+ *  backend. */
+interface ProbeReport {
+    failed: boolean;
+}
 interface RebaseResult {
     /** The ref the workspace was actually rebased onto (resolved
      *  symbolic-or-revset → concrete name). For git that is the
@@ -1340,8 +1369,9 @@ interface VcsBackend {
     readonly name: VcsBackendName;
     /** True iff this backend should handle `projectRoot`. Implementations
      *  check for the relevant marker dir (`.jj`, `.sl`, `.git`); `none`
-     *  always returns true and is consulted last. */
-    detect(projectRoot: string): Promise<boolean>;
+     *  always returns true and is consulted last. `report.failed` is set
+     *  when a root probe was indeterminate (see `ProbeReport`). */
+    detect(projectRoot: string, report?: ProbeReport): Promise<boolean>;
     createWorkspace(opts: CreateWorkspaceOptions$1): Promise<CreateWorkspaceResult>;
     freeWorkspace(opts: FreeWorkspaceOptions$1): Promise<FreeWorkspaceResult$1>;
     /**
@@ -1477,7 +1507,7 @@ declare const slBackend: VcsBackend;
 /** Return the backend that should handle projectRoot. Walks BACKENDS
  *  in precedence order; never returns undefined because noneBackend
  *  always claims. */
-declare function detectBackend(projectRoot: string): Promise<VcsBackend>;
+declare function detectBackend(projectRoot: string, report?: ProbeReport): Promise<VcsBackend>;
 /** Look up a backend by name. Throws on unknown name. Used by
  *  `mu agent spawn --workspace-backend ...` to honour an explicit
  *  override. */
@@ -1584,6 +1614,8 @@ type SpawnCtl = "ok" | "missing" | "refused" | "skipped";
 type SpawnedAgent = AgentRow & {
     ctl: SpawnCtl;
     ctlSocket: string;
+    /** Set when the startup scan saw a Claude trust dialog parked in the pane. */
+    trustDialog?: true;
 };
 /**
  * Spawn a new agent in its tmux pane and register it in the DB.
@@ -1901,6 +1933,20 @@ declare class AgentCtlUnreachableError extends Error implements HasNextSteps {
     constructor(agentName: string, workstream: string, socket: string, kind: "missing" | "refused");
     errorNextSteps(): NextStep[];
 }
+/**
+ * A side-effecting ctl request (send, fresh, interrupt, command) was
+ * written to a live agent's socket, then no reply arrived (timeout or
+ * close). pi may have queued the prompt, so a blind resend can duplicate it.
+ */
+declare class AgentSendIndeterminateError extends Error implements HasNextSteps {
+    readonly agentName: string;
+    readonly workstream: string;
+    readonly op: string;
+    readonly reason: string;
+    readonly name = "AgentSendIndeterminateError";
+    constructor(agentName: string, workstream: string, op: string, reason: string);
+    errorNextSteps(): NextStep[];
+}
 /**
  * A ctl verb (send, abort, ...) found the agent's control socket silent
  * AND its pane gone: the process exited (or the pane was closed behind
@@ -1984,6 +2030,21 @@ declare class AgentBusyError extends Error implements HasNextSteps {
     command?: string | undefined);
     errorNextSteps(): NextStep[];
 }
+/**
+ * `mu workspace free` refused: the owning agent is mid-turn, waiting on
+ * a permission, or unreadable with a live pane. Freeing would pull the
+ * checkout out from under it. CLI-only guard; `agent close` and spawn
+ * rollback call the SDK directly and are unaffected.
+ */
+declare class WorkspaceOwnerBusyError extends Error implements HasNextSteps {
+    readonly agentName: string;
+    readonly workstream: string;
+    readonly state: string;
+    readonly detail?: string | undefined;
+    readonly name = "WorkspaceOwnerBusyError";
+    constructor(agentName: string, workstream: string, state: string, detail?: string | undefined);
+    errorNextSteps(): NextStep[];
+}
 /**
  * A slash command other than `/new`, `/reload`, `/compact` sent to a pi
  * agent. The control socket cannot run it (pi.sendUserMessage would
@@ -1999,6 +2060,18 @@ declare class AgentSlashCommandUnsupportedError extends Error implements HasNext
     constructor(agentName: string, workstream: string, text: string, supported: readonly string[]);
     errorNextSteps(): NextStep[];
 }
+/**
+ * An empty message sent to a pi agent over the control socket.
+ * pi.sendUserMessage("") is meaningless; a bare Enter is a pane
+ * keystroke, so `--via mux` is the explicit way to press it.
+ */
+declare class AgentEmptySendError extends Error implements HasNextSteps {
+    readonly agentName: string;
+    readonly workstream: string;
+    readonly name = "AgentEmptySendError";
+    constructor(agentName: string, workstream: string);
+    errorNextSteps(): NextStep[];
+}
 
 /** The signal set kick supports. SIGINT is graceful (matches Ctrl-C
  *  semantics — what the operator probably wanted in the first place);
@@ -2231,7 +2304,9 @@ declare function refreshAgentTitle(db: Db, agentName: string, workstream: string
  * crashed (or was explicitly closed mid-task) leaves the task graph
  * in a wrong state — IN_PROGRESS forever, with no owner to release.
  */
-declare function deleteAgent(db: Db, name: string, workstream: string): boolean;
+declare function deleteAgent(db: Db, name: string, workstream: string, 
+/** When set, delete only if the row still has this pane id (checked inside the reaper transaction). */
+expectedPaneId?: string): boolean;
 declare function isValidAgentName(name: string): boolean;
 /**
  * Send text to an agent and submit it. A pi agent gets it through its
@@ -2878,222 +2953,6 @@ interface TaskNoteRow {
     createdAt: string;
 }
 
-interface TaskEdges {
-    /** Tasks that must close before this one can start (blockers). */
-    blockers: string[];
-    /** Tasks that this one blocks (dependents). */
-    dependents: string[];
-}
-/** One end of an edge with the neighbour's current status attached.
- *  Used by `mu task show` to group blockers/dependents into
- *  "still gating" vs "satisfied" buckets without making the renderer
- *  do a second round-trip to the DB per neighbour. */
-interface TaskEdgeWithStatus {
-    name: string;
-    status: TaskStatus;
-    substate: TaskSubstate;
-}
-interface TaskEdgesWithStatus {
-    /** Tasks that must close before this one can start (blockers),
-     *  carrying each blocker's current status. */
-    blockers: TaskEdgeWithStatus[];
-    /** Tasks that this one blocks (dependents), carrying each
-     *  dependent's current status. */
-    dependents: TaskEdgeWithStatus[];
-}
-/**
- * Direct (one-hop) edges for a task. For transitive prerequisites, use
- * `getPrerequisites()`; this helper is the immediate-neighbour view used
- * by `mu task show`.
- */
-declare function getTaskEdges(db: Db, taskLocalId: string, workstream: string): TaskEdges;
-/**
- * Same one-hop edge view as `getTaskEdges`, but each neighbour is
- * returned as `{ name, status }` so callers can group / colour by
- * status without an N+1 round-trip. Used by `mu task show` to split
- * "blocked by" (still-gating) from "satisfied" (already-CLOSED)
- * blockers, and the symmetric split on the dependents side
- * (task_show_blocked_by_renders_closed). OPEN and IN_PROGRESS stay in
- * the still-gating bucket; CLOSED is satisfied.
- */
-declare function getTaskEdgesWithStatus(db: Db, taskLocalId: string, workstream: string): TaskEdgesWithStatus;
-/**
- * All tasks transitively reachable from `taskId` via reverse-edge
- * traversal (i.e. the set of tasks that block this one), including the
- * task itself.
- */
-declare function getPrerequisites(db: Db, taskLocalId: string, workstream: string): Set<string>;
-interface BlockEdgeResult {
-    /** True iff a row was actually inserted (vs. already present). */
-    added: boolean;
-}
-/**
- * Add the edge `blocker → blocked` ('blocker blocks blocked').
- * Idempotent (existing edge → `added: false`). Validates:
- *
- *   - both tasks exist
- *   - same workstream (cross-workstream edges forbidden)
- *   - no cycle (the new edge wouldn't form a path blocked → ... → blocker)
- *   - blocker ≠ blocked (no self-reference)
- */
-declare function addBlockEdge(db: Db, workstream: string, blocked: string, blocker: string): BlockEdgeResult;
-interface RemoveBlockEdgeResult {
-    /** True iff a row was actually deleted (vs. no such edge). */
-    removed: boolean;
-}
-/**
- * Remove the edge `blocker → blocked`. Idempotent (no edge →
- * `removed: false`). Does NOT validate task existence — if the
- * edge is gone there's nothing to do, regardless of whether the
- * tasks are gone too.
- */
-declare function removeBlockEdge(db: Db, workstream: string, blocked: string, blocker: string): RemoveBlockEdgeResult;
-interface ReparentTaskResult {
-    /** Edges removed (i.e. all incoming `to_task = taskId` edges). */
-    removedEdges: number;
-    /** Edges added (after duplicate blockers are canonicalised). */
-    addedEdges: number;
-}
-/**
- * Atomically replace every incoming edge of `taskId` with new ones
- * `blocker[i] → taskId`. Pass an empty `blockers` array to clear all
- * incoming edges (the task becomes ready iff its status allows).
- *
- * Validates ALL new blockers up-front (existence + same workstream +
- * cycle check); if any fails, no DELETE happens — the call is fully
- * atomic via a single transaction.
- *
- * Cycle reasoning: removing the existing incoming edges to `taskId`
- * doesn't change `taskId`'s OUTGOING reachability, so
- * `wouldCreateCycle(db, blocker, taskId)` evaluated against the
- * pre-state gives the right answer for each new edge.
- */
-declare function reparentTask(db: Db, taskLocalId: string, blockers: readonly string[], scope: {
-    workstream: string;
-}): ReparentTaskResult;
-
-interface AddTaskOptions {
-    localId: string;
-    workstream: string;
-    title: string;
-    /** 1..100; enforced by schema CHECK. */
-    impact: number;
-    /** > 0; enforced by schema CHECK. */
-    effortDays: number;
-    /**
-     * Tasks that block this one. Edges inserted as `blocker -> newTask`.
-     * Each blocker must already exist AND share this task's workstream
-     * (cross-workstream edges are forbidden); cycle check guards each
-     * edge. The CLI surfaces this as `--blocked-by`; the SDK key matches.
-     */
-    blockedBy?: string[];
-    /** Start as OPEN/triage (a proposal, e.g. a review finding) instead of OPEN/todo. */
-    triage?: boolean;
-}
-/**
- * Atomically create a task and (optionally) its incoming blocked-by
- * edges.
- *
- * The task insert + every edge insert + cycle check happen inside one
- * SQLite transaction. If any blocker is missing or any edge would
- * create a cycle, the entire add rolls back.
- *
- * Cycle check for `addTask` is structurally trivial (a fresh task has
- * no outgoing edges, so `to -> ... -> from` is impossible). It's still
- * called here so the same primitive is exercised by tests.
- */
-declare function addTask(db: Db, opts: AddTaskOptions): TaskRow;
-interface AddNoteOptions {
-    /** Free-form author label. Convention: agent name, "user", or "orchestrator". */
-    author?: string;
-    /** Workstream context (operator-facing name). v5: tasks.local_id is
-     *  per-workstream unique, so this is required to disambiguate. */
-    workstream: string;
-}
-declare function addNote(db: Db, taskLocalId: string, content: string, opts: AddNoteOptions): {
-    author: string | null;
-    content: string;
-    createdAt: string;
-};
-interface DeleteTaskResult {
-    /** True iff the row existed and was deleted. False on a dry-run
-     *  (preview) AND on the idempotent missing-row case. */
-    deleted: boolean;
-    /** Number of `task_edges` rows cascaded out (informational). On a
-     *  dry-run, this is the would-be count. */
-    deletedEdges: number;
-    /** Number of `task_notes` rows cascaded out (informational). On a
-     *  dry-run, this is the would-be count. */
-    deletedNotes: number;
-    /** True iff this was a dry-run (`opts.dryRun: true`). On a
-     *  dry-run `deleted` is false and the counts are the would-be
-     *  counts; the DB is unchanged. Always false on a commit / on a
-     *  missing-row idempotent no-op. */
-    dryRun: boolean;
-    /** True iff a matching task row was found at the time of the
-     *  call. Discriminator for the CLI: a dry-run that found nothing
-     *  (`present: false`) renders differently from a dry-run that
-     *  found an existing task with zero edges and zero notes
-     *  (`present: true, deletedEdges: 0, deletedNotes: 0`). */
-    present: boolean;
-    /** The op group the delete wrote, for `mu undo <group> --yes`. Null
-     *  when nothing was deleted (dry-run or missing row). */
-    group: string | null;
-}
-interface DeleteTaskOptions {
-    /** When true, return the cascade preview (would-be edge / note
-     *  counts) without mutating. The CLI uses this to power the bare
-     *  `mu task delete <id>` two-phase pattern (mirrors
-     *  `mu workstream teardown` / `mu undo`). Surfaced
-     *  by feedback ws task
-     *  fb_task_delete_no_yes (impact=30): a dogfood report typed
-     *  `mu task delete X --yes` (mirroring workstream teardown) and got
-     *  'unknown option --yes' — the verb took no confirmation flag at
-     *  all. Two failed deletes left long-named tasks lingering. */
-    dryRun?: boolean;
-}
-/**
- * Delete a task. FK CASCADE on `task_edges` (from + to) and
- * `task_notes` cleans the joined rows automatically. Idempotent on
- * a missing task (returns `deleted: false`).
- *
- * Pre-counts the cascade victims for reporting because SQLite's
- * `changes()` only reports rows directly affected by the DELETE.
- *
- * With `opts.dryRun: true`, returns the would-be counts without
- * touching the DB (no mutation, so no op is written). The CLI bare
- * `mu task delete <id>` form uses this; `--yes` calls through with
- * `dryRun: false`.
- */
-declare function deleteTask(db: Db, localId: string, workstream: string, opts?: DeleteTaskOptions): DeleteTaskResult;
-interface UpdateTaskOptions {
-    title?: string;
-    /** 1..100; enforced by schema CHECK. */
-    impact?: number;
-    /** > 0; enforced by schema CHECK. */
-    effortDays?: number;
-}
-interface UpdateTaskResult {
-    /** True iff at least one field actually changed. */
-    updated: boolean;
-    /** The fields whose values differ post-update (in `UpdateTaskOptions`'s
-     *  camelCase shape). Empty when `updated: false`. */
-    changedFields: string[];
-}
-/**
- * Update scalar fields on a task. Each option is independently optional;
- * passing none is a typed no-op (returns `updated: false, changedFields: []`).
- * Fields whose new value equals the current value are skipped (no row change).
- *
- * NOT for status (use `closeTask` / `openTask` / `setTaskStatus`), owner
- * (use `claimTask` / `releaseTask`), local_id (rename is deferred), or
- * workstream (cross-workstream moves are deferred).
- */
-interface UpdateTaskScopeOption {
-    workstream: string;
-}
-declare function updateTask(db: Db, localId: string, opts: UpdateTaskOptions, scope: UpdateTaskScopeOption): UpdateTaskResult;
-
 declare const WORKSPACE_STALE_THRESHOLD = 10;
 declare function isWorkspaceStale(behind: number | null | undefined): boolean;
 
@@ -3370,8 +3229,13 @@ declare class TaskClaimStaleWorkspaceError extends Error implements HasNextSteps
 declare class CycleError extends Error implements HasNextSteps {
     readonly from: string;
     readonly to: string;
+    /** Existing path `to -> … -> from` (task names) that the new edge would close. */
+    readonly path: readonly string[];
+    readonly workstream?: string | undefined;
     readonly name = "CycleError";
-    constructor(from: string, to: string);
+    constructor(from: string, to: string, 
+    /** Existing path `to -> … -> from` (task names) that the new edge would close. */
+    path?: readonly string[], workstream?: string | undefined);
     errorNextSteps(): NextStep[];
 }
 /**
@@ -3504,6 +3368,222 @@ declare class InvalidSubstateError extends Error implements HasNextSteps {
     errorNextSteps(): NextStep[];
 }
 
+interface TaskEdges {
+    /** Tasks that must close before this one can start (blockers). */
+    blockers: string[];
+    /** Tasks that this one blocks (dependents). */
+    dependents: string[];
+}
+/** One end of an edge with the neighbour's current status attached.
+ *  Used by `mu task show` to group blockers/dependents into
+ *  "still gating" vs "satisfied" buckets without making the renderer
+ *  do a second round-trip to the DB per neighbour. */
+interface TaskEdgeWithStatus {
+    name: string;
+    status: TaskStatus;
+    substate: TaskSubstate;
+}
+interface TaskEdgesWithStatus {
+    /** Tasks that must close before this one can start (blockers),
+     *  carrying each blocker's current status. */
+    blockers: TaskEdgeWithStatus[];
+    /** Tasks that this one blocks (dependents), carrying each
+     *  dependent's current status. */
+    dependents: TaskEdgeWithStatus[];
+}
+/**
+ * Direct (one-hop) edges for a task. For transitive prerequisites, use
+ * `getPrerequisites()`; this helper is the immediate-neighbour view used
+ * by `mu task show`.
+ */
+declare function getTaskEdges(db: Db, taskLocalId: string, workstream: string): TaskEdges;
+/**
+ * Same one-hop edge view as `getTaskEdges`, but each neighbour is
+ * returned as `{ name, status }` so callers can group / colour by
+ * status without an N+1 round-trip. Used by `mu task show` to split
+ * "blocked by" (still-gating) from "satisfied" (already-CLOSED)
+ * blockers, and the symmetric split on the dependents side
+ * (task_show_blocked_by_renders_closed). OPEN and IN_PROGRESS stay in
+ * the still-gating bucket; CLOSED is satisfied.
+ */
+declare function getTaskEdgesWithStatus(db: Db, taskLocalId: string, workstream: string): TaskEdgesWithStatus;
+/**
+ * All tasks transitively reachable from `taskId` via reverse-edge
+ * traversal (i.e. the set of tasks that block this one), including the
+ * task itself.
+ */
+declare function getPrerequisites(db: Db, taskLocalId: string, workstream: string): Set<string>;
+interface BlockEdgeResult {
+    /** True iff a row was actually inserted (vs. already present). */
+    added: boolean;
+}
+/**
+ * Add the edge `blocker → blocked` ('blocker blocks blocked').
+ * Idempotent (existing edge → `added: false`). Validates:
+ *
+ *   - both tasks exist
+ *   - same workstream (cross-workstream edges forbidden)
+ *   - no cycle (the new edge wouldn't form a path blocked → ... → blocker)
+ *   - blocker ≠ blocked (no self-reference)
+ */
+declare function addBlockEdge(db: Db, workstream: string, blocked: string, blocker: string): BlockEdgeResult;
+interface RemoveBlockEdgeResult {
+    /** True iff a row was actually deleted (vs. no such edge). */
+    removed: boolean;
+}
+/**
+ * Remove the edge `blocker → blocked`. Idempotent (no edge →
+ * `removed: false`). Does NOT validate task existence — if the
+ * edge is gone there's nothing to do, regardless of whether the
+ * tasks are gone too.
+ */
+declare function removeBlockEdge(db: Db, workstream: string, blocked: string, blocker: string): RemoveBlockEdgeResult;
+interface ReparentTaskResult {
+    /** Edges removed (i.e. all incoming `to_task = taskId` edges). */
+    removedEdges: number;
+    /** Edges added (after duplicate blockers are canonicalised). */
+    addedEdges: number;
+}
+/**
+ * Atomically replace every incoming edge of `taskId` with new ones
+ * `blocker[i] → taskId`. Pass an empty `blockers` array to clear all
+ * incoming edges (the task becomes ready iff its status allows).
+ *
+ * Validates ALL new blockers up-front (existence + same workstream +
+ * cycle check); if any fails, no DELETE happens — the call is fully
+ * atomic via a single transaction.
+ *
+ * Cycle reasoning: removing the existing incoming edges to `taskId`
+ * doesn't change `taskId`'s OUTGOING reachability, so
+ * `wouldCreateCycle(db, blocker, taskId)` evaluated against the
+ * pre-state gives the right answer for each new edge.
+ */
+declare function reparentTask(db: Db, taskLocalId: string, blockers: readonly string[], scope: {
+    workstream: string;
+}): ReparentTaskResult;
+
+interface AddTaskOptions {
+    localId: string;
+    workstream: string;
+    title: string;
+    /** 1..100; enforced by schema CHECK. */
+    impact: number;
+    /** > 0; enforced by schema CHECK. */
+    effortDays: number;
+    /**
+     * Tasks that block this one. Edges inserted as `blocker -> newTask`.
+     * Each blocker must already exist AND share this task's workstream
+     * (cross-workstream edges are forbidden); cycle check guards each
+     * edge. The CLI surfaces this as `--blocked-by`; the SDK key matches.
+     */
+    blockedBy?: string[];
+    /** Start as OPEN/triage (a proposal, e.g. a review finding) instead of OPEN/todo. */
+    triage?: boolean;
+}
+/**
+ * Atomically create a task and (optionally) its incoming blocked-by
+ * edges.
+ *
+ * The task insert + every edge insert + cycle check happen inside one
+ * SQLite transaction. If any blocker is missing or any edge would
+ * create a cycle, the entire add rolls back.
+ *
+ * Cycle check for `addTask` is structurally trivial (a fresh task has
+ * no outgoing edges, so `to -> ... -> from` is impossible). It's still
+ * called here so the same primitive is exercised by tests.
+ */
+declare function addTask(db: Db, opts: AddTaskOptions): TaskRow;
+interface AddNoteOptions {
+    /** Free-form author label. Convention: agent name, "user", or "orchestrator". */
+    author?: string;
+    /** Workstream context (operator-facing name). v5: tasks.local_id is
+     *  per-workstream unique, so this is required to disambiguate. */
+    workstream: string;
+}
+declare function addNote(db: Db, taskLocalId: string, content: string, opts: AddNoteOptions): {
+    author: string | null;
+    content: string;
+    createdAt: string;
+};
+interface DeleteTaskResult {
+    /** True iff the row existed and was deleted. False on a dry-run
+     *  (preview) AND on the idempotent missing-row case. */
+    deleted: boolean;
+    /** Number of `task_edges` rows cascaded out (informational). On a
+     *  dry-run, this is the would-be count. */
+    deletedEdges: number;
+    /** Number of `task_notes` rows cascaded out (informational). On a
+     *  dry-run, this is the would-be count. */
+    deletedNotes: number;
+    /** True iff this was a dry-run (`opts.dryRun: true`). On a
+     *  dry-run `deleted` is false and the counts are the would-be
+     *  counts; the DB is unchanged. Always false on a commit / on a
+     *  missing-row idempotent no-op. */
+    dryRun: boolean;
+    /** True iff a matching task row was found at the time of the
+     *  call. Discriminator for the CLI: a dry-run that found nothing
+     *  (`present: false`) renders differently from a dry-run that
+     *  found an existing task with zero edges and zero notes
+     *  (`present: true, deletedEdges: 0, deletedNotes: 0`). */
+    present: boolean;
+    /** The op group the delete wrote, for `mu undo <group> --yes`. Null
+     *  when nothing was deleted (dry-run or missing row). */
+    group: string | null;
+}
+interface DeleteTaskOptions {
+    /** When true, return the cascade preview (would-be edge / note
+     *  counts) without mutating. The CLI uses this to power the bare
+     *  `mu task delete <id>` two-phase pattern (mirrors
+     *  `mu workstream teardown` / `mu undo`). Surfaced
+     *  by feedback ws task
+     *  fb_task_delete_no_yes (impact=30): a dogfood report typed
+     *  `mu task delete X --yes` (mirroring workstream teardown) and got
+     *  'unknown option --yes' — the verb took no confirmation flag at
+     *  all. Two failed deletes left long-named tasks lingering. */
+    dryRun?: boolean;
+}
+/**
+ * Delete a task. FK CASCADE on `task_edges` (from + to) and
+ * `task_notes` cleans the joined rows automatically. Idempotent on
+ * a missing task (returns `deleted: false`).
+ *
+ * Pre-counts the cascade victims for reporting because SQLite's
+ * `changes()` only reports rows directly affected by the DELETE.
+ *
+ * With `opts.dryRun: true`, returns the would-be counts without
+ * touching the DB (no mutation, so no op is written). The CLI bare
+ * `mu task delete <id>` form uses this; `--yes` calls through with
+ * `dryRun: false`.
+ */
+declare function deleteTask(db: Db, localId: string, workstream: string, opts?: DeleteTaskOptions): DeleteTaskResult;
+interface UpdateTaskOptions {
+    title?: string;
+    /** 1..100; enforced by schema CHECK. */
+    impact?: number;
+    /** > 0; enforced by schema CHECK. */
+    effortDays?: number;
+}
+interface UpdateTaskResult {
+    /** True iff at least one field actually changed. */
+    updated: boolean;
+    /** The fields whose values differ post-update (in `UpdateTaskOptions`'s
+     *  camelCase shape). Empty when `updated: false`. */
+    changedFields: string[];
+}
+/**
+ * Update scalar fields on a task. Each option is independently optional;
+ * passing none is a typed no-op (returns `updated: false, changedFields: []`).
+ * Fields whose new value equals the current value are skipped (no row change).
+ *
+ * NOT for status (use `closeTask` / `openTask` / `setTaskStatus`), owner
+ * (use `claimTask` / `releaseTask`), local_id (rename is deferred), or
+ * workstream (cross-workstream moves are deferred).
+ */
+interface UpdateTaskScopeOption {
+    workstream: string;
+}
+declare function updateTask(db: Db, localId: string, opts: UpdateTaskOptions, scope: UpdateTaskScopeOption): UpdateTaskResult;
+
 /** Thrown when a title has no ASCII letter or digit, so no id can be
  *  derived from it (any non-ASCII script, or pure punctuation). Exit 2
  *  (usage) with the verb's --help; the fix is the `<id>` positional.
@@ -4056,7 +4136,7 @@ declare function emitEvent(db: Db, workstream: string | null, intent: LocalInten
  * `string` so a typo is a compile error and the set stays auditable —
  * `mu log`'s formatter (v2-log-verb) switches on exactly these.
  */
-type LocalIntent = "agent.spawn" | "agent.close" | "agent.adopt" | "agent.kick" | "agent.send" | "agent.stall" | "workspace.create" | "workspace.free" | "workspace.refresh";
+type LocalIntent = "agent.spawn" | "agent.spawn_failed" | "agent.close" | "agent.adopt" | "agent.kick" | "agent.send" | "agent.abort" | "agent.stall" | "workspace.create" | "workspace.free" | "workspace.refresh";
 
 interface Track {
     /** Goal tasks (no outgoing edges) belonging to this track. */
@@ -5386,6 +5466,7 @@ declare const tmux_listPanes: typeof listPanes;
 declare const tmux_listPanesInSession: typeof listPanesInSession;
 declare const tmux_listSessions: typeof listSessions;
 declare const tmux_listWindows: typeof listWindows;
+declare const tmux_lockPaneTitle: typeof lockPaneTitle;
 declare const tmux_newSession: typeof newSession;
 declare const tmux_newSessionWithPane: typeof newSessionWithPane;
 declare const tmux_newWindow: typeof newWindow;
@@ -5405,7 +5486,7 @@ declare const tmux_sleep: typeof sleep;
 declare const tmux_splitWindow: typeof splitWindow;
 declare const tmux_tmuxBackend: typeof tmuxBackend;
 declare namespace tmux {
-  export { type tmux_AttachTarget as AttachTarget, type tmux_CaptureOptions as CaptureOptions, type tmux_MuxCommand as MuxCommand, tmux_MuxError as MuxError, type tmux_MuxHealth as MuxHealth, type tmux_NewSessionOptions as NewSessionOptions, type tmux_NewSessionWithPaneOptions as NewSessionWithPaneOptions, type tmux_NewWindowOptions as NewWindowOptions, tmux_PANE_ID_RE as PANE_ID_RE, tmux_PaneNotFoundError as PaneNotFoundError, type tmux_SendOptions as SendOptions, type tmux_SendWarning as SendWarning, type tmux_SplitWindowOptions as SplitWindowOptions, type tmux_TmuxBackend as TmuxBackend, tmux_TmuxError as TmuxError, type tmux_TmuxExecResult as TmuxExecResult, type tmux_TmuxExecutor as TmuxExecutor, type tmux_TmuxPane as TmuxPane, type tmux_TmuxSession as TmuxSession, type tmux_TmuxWindow as TmuxWindow, tmux_assertValidPaneId as assertValidPaneId, tmux_attachCommands as attachCommands, tmux_attachHint as attachHint, tmux_awaitPaneQuiescence as awaitPaneQuiescence, tmux_capturePane as capturePane, tmux_currentAgentName as currentAgentName, tmux_currentPaneTitle as currentPaneTitle, tmux_currentSessionName as currentSessionName, tmux_defaultSendDelayMs as defaultSendDelayMs, tmux_defaultSendReadinessMs as defaultSendReadinessMs, tmux_enableMuPaneBorders as enableMuPaneBorders, tmux_enableMuPaneBordersForPane as enableMuPaneBordersForPane, tmux_enableMuPaneBordersForSession as enableMuPaneBordersForSession, tmux_getPaneTitle as getPaneTitle, tmux_getWindowIdForPane as getWindowIdForPane, tmux_hasWorkMarker as hasWorkMarker, tmux_healthCheck as healthCheck, tmux_isValidPaneId as isValidPaneId, tmux_killPane as killPane, tmux_killSession as killSession, tmux_listPanes as listPanes, tmux_listPanesInSession as listPanesInSession, tmux_listSessions as listSessions, tmux_listWindows as listWindows, tmux_newSession as newSession, tmux_newSessionWithPane as newSessionWithPane, tmux_newWindow as newWindow, tmux_paneExists as paneExists, tmux_paneNotFoundNextSteps as paneNotFoundNextSteps, tmux_paneTTY as paneTTY, tmux_parseAgentNameFromTitle as parseAgentNameFromTitle, tmux_resetSleep as resetSleep, tmux_resetTmuxExecutor as resetTmuxExecutor, tmux_selectLayout as selectLayout, tmux_sendToPane as sendToPane, tmux_sessionExists as sessionExists, tmux_setPaneTitle as setPaneTitle, tmux_setSleepForTests as setSleepForTests, tmux_setTmuxExecutor as setTmuxExecutor, tmux_sleep as sleep, tmux_splitWindow as splitWindow, tmux$1 as tmux, tmux_tmuxBackend as tmuxBackend };
+  export { type tmux_AttachTarget as AttachTarget, type tmux_CaptureOptions as CaptureOptions, type tmux_MuxCommand as MuxCommand, tmux_MuxError as MuxError, type tmux_MuxHealth as MuxHealth, type tmux_NewSessionOptions as NewSessionOptions, type tmux_NewSessionWithPaneOptions as NewSessionWithPaneOptions, type tmux_NewWindowOptions as NewWindowOptions, tmux_PANE_ID_RE as PANE_ID_RE, tmux_PaneNotFoundError as PaneNotFoundError, type tmux_SendOptions as SendOptions, type tmux_SendWarning as SendWarning, type tmux_SplitWindowOptions as SplitWindowOptions, type tmux_TmuxBackend as TmuxBackend, tmux_TmuxError as TmuxError, type tmux_TmuxExecResult as TmuxExecResult, type tmux_TmuxExecutor as TmuxExecutor, type tmux_TmuxPane as TmuxPane, type tmux_TmuxSession as TmuxSession, type tmux_TmuxWindow as TmuxWindow, tmux_assertValidPaneId as assertValidPaneId, tmux_attachCommands as attachCommands, tmux_attachHint as attachHint, tmux_awaitPaneQuiescence as awaitPaneQuiescence, tmux_capturePane as capturePane, tmux_currentAgentName as currentAgentName, tmux_currentPaneTitle as currentPaneTitle, tmux_currentSessionName as currentSessionName, tmux_defaultSendDelayMs as defaultSendDelayMs, tmux_defaultSendReadinessMs as defaultSendReadinessMs, tmux_enableMuPaneBorders as enableMuPaneBorders, tmux_enableMuPaneBordersForPane as enableMuPaneBordersForPane, tmux_enableMuPaneBordersForSession as enableMuPaneBordersForSession, tmux_getPaneTitle as getPaneTitle, tmux_getWindowIdForPane as getWindowIdForPane, tmux_hasWorkMarker as hasWorkMarker, tmux_healthCheck as healthCheck, tmux_isValidPaneId as isValidPaneId, tmux_killPane as killPane, tmux_killSession as killSession, tmux_listPanes as listPanes, tmux_listPanesInSession as listPanesInSession, tmux_listSessions as listSessions, tmux_listWindows as listWindows, tmux_lockPaneTitle as lockPaneTitle, tmux_newSession as newSession, tmux_newSessionWithPane as newSessionWithPane, tmux_newWindow as newWindow, tmux_paneExists as paneExists, tmux_paneNotFoundNextSteps as paneNotFoundNextSteps, tmux_paneTTY as paneTTY, tmux_parseAgentNameFromTitle as parseAgentNameFromTitle, tmux_resetSleep as resetSleep, tmux_resetTmuxExecutor as resetTmuxExecutor, tmux_selectLayout as selectLayout, tmux_sendToPane as sendToPane, tmux_sessionExists as sessionExists, tmux_setPaneTitle as setPaneTitle, tmux_setSleepForTests as setSleepForTests, tmux_setTmuxExecutor as setTmuxExecutor, tmux_sleep as sleep, tmux_splitWindow as splitWindow, tmux$1 as tmux, tmux_tmuxBackend as tmuxBackend };
 }
 
 /** What undoing one op will do. */
@@ -5712,4 +5793,4 @@ declare function summarizeWorkstream(db: Db, opts: WorkstreamOptions): Promise<W
  */
 declare function teardownWorkstream(db: Db, opts: TeardownWorkstreamOptions): Promise<TeardownResult>;
 
-export { AGENT_STATE_GLYPH, type AbortAgentOptions, type AbortResult, type AddNoteOptions, type AddTaskOptions, type AdoptAgentOptions, type AdoptAgentResult, AgentAbortNeedsCtlError, AgentAbortTimeoutError, AgentBusyError, AgentCtlUnreachableError, AgentDiedOnSpawnError, AgentExistsError, AgentExtensionOutdatedError, AgentFreshNeedsCtlError, AgentNameExhaustedError, AgentNotFoundError, AgentNotInWorkstreamError, AgentPaneDeadError, type AgentRow, AgentSlashCommandUnsupportedError, AgentSpawnCliNotFoundError, AgentSpawnStartupError, type AmbientOptions, type AmbientResult, type AppendLogOptions, type ApplyResult, type BlockEdgeResult, CAPTURE_TRIGGER_DDL, CURRENT_SCHEMA_VERSION, type CaptureDb, type CaptureIntent, type CaptureOptions, type CaseCollision, type CheapDriftReport, type ClaimResult, type ClaimTaskOptions, ClaimerNotRegisteredError, type CloseAgentOptions, type CloseAgentResult, type CloseSubstate, type CloseTaskResult, type CommandResolutionResult, type CommandResolver, CrossWorkstreamEdgeError, type CtlLink, CycleError, DEFAULT_SUBSTATE, DRIFT_REPORT_CAP, type Db, type DeleteTaskResult, type DoctorCheck, type DoctorStatus, type DoctorSummary, DriftDetectedError, type DriftRecord, type DriftReport, EXPECTED_TABLES, type EvidenceOption, type FileLockOptions, type FleetHazard, type FlushResult, type FsProbe, type FullDag, GLYPH, GroupIdAmbiguousError, type GroupSummary, HazardFailError, type HazardSeverity, type Hlc, HlcOverflowError, HlcParseError, HomeDirAsProjectRootError, type IdFromTitleResult, type IngestFromDbResult, type IngestResult, type InsertAgentInput, InvalidSubstateError, type InverseOp, KNOWN_INTENTS, KNOWN_VERBS, type KickAgentOptions, type KickAgentResult, type KickProcessExecutor, type KickSignal, type KnownIntent, LinkConflictError, type LinkState, type LinkStatus, type ListLiveAgentsOptions, type ListLogsOptions, type ListNotesOptions, type ListReadyOptions, type ListTasksOptions, type LiveAgent, type LiveAgentsView, type LoadFullDagOptions, type LoadWorkstreamSnapshotOptions, type LocalIntent, type LogKind, LogKindReservedError, type LogRow, MACHINE_LOCAL_ENTITIES, MACHINE_LOCAL_TABLES, MU_SHIM_MARKER, MachineIdentityMissingError, type MachineLocalEntity, type MachineLocalLoss, type MachineLocalTable, type MuxBackend, type MuxBackendName, MuxError, type MuxPane, type MuxPaneStatus, type MuxSession, type MuxWindow, type NewSessionOptions, type NewWindowOptions, NoForegroundProcessError, NoMultiplexerError, NothingToUndoError, OP_CTX_DDL, type Op, type OpContext, OpEntityNotSyncedError, OpKeyMalformedError, type OpenDbOptions, type OwnedTasksSummary, PANE_ID_RE, PEER_SHORT_LEN, PEER_STALE_MS, PORTABLE_TABLES, PaneNotFoundError, PaneNotInSessionError, type ParkTaskOptions, type PeerSegment, type PeerStatus, type PortableTable, ReaperDetectedDuringWaitError, type RebuildOptions, type RebuildReport, RebuildTargetExistsError, RebuildTargetIsSourceError, type ReconcileMode, type ReconcileOptions, type ReconcileReport, type ReleaseResult, type ReleaseTaskOptions, type RemoveBlockEdgeResult, type RenderableOp, type RenderedOp, type ReparentTaskResult, type RoiBucket, type RuntimeState, SEGMENT_FORMAT_VERSION, SYNCED_ENTITIES, SchemaTooNewError, SchemaTooOldError, type SegmentDefect, type SegmentDefectKind, type SegmentLine, type SegmentManifest, type SendOptions, type SendResult, type SendWarning, type SetStatusOptions, type SetStatusResult, type SlugifyResult, type SpawnAgentOptions, type SplitWindowOptions, StallDetectedDuringWaitError, type StateReading, type StateSource, type StrandedWorkspaceOrphan, SubstateReasonRequiredError, type SyncPassResult, SyncPeerNotFoundError, SyncPeerRefAmbiguousError, SyncSourceNotFoundError, type SyncedEntity, TASK_STATUSES, TASK_STATUS_LIST, TASK_SUBSTATES, TASK_SUBSTATE_ROWS, TaskAlreadyOwnedError, TaskClaimStaleWorkspaceError, type TaskEdgeWithStatus, type TaskEdges, type TaskEdgesWithStatus, TaskExistsError, TaskIdInvalidError, TaskInTriageError, TaskNotFoundError, TaskNotInWorkstreamError, type TaskNoteRow, type TaskPair, TaskParkStateError, TaskParkedError, type TaskRow, type TaskStatus, type TaskSubstate, TaskTitleSlugEmptyError, type TaskWaitOptions, type TaskWaitRef, type TaskWaitResult, type TaskWaitTaskState, type TeardownResult, TmuxError, type TmuxExecResult, type TmuxExecutor, type TmuxPane, type TmuxSession, type TmuxWindow, type Track, type Transport, UNKNOWN_REASON, UndoGroupNotFoundError, type UndoOptions, type UndoPlan, type UndoResult, UndoSupersededError, type UpdateTaskOptions, type UpdateTaskResult, type VcsBackend, type VcsBackendName, WORKSPACE_STALE_THRESHOLD, WorkspaceConflictError, WorkspaceDirtyError, WorkspaceExistsError, type WorkspaceFailure, WorkspaceNotFoundError, type WorkspaceOrphan, WorkspacePathNotEmptyError, WorkspacePreservedError, type WorkspaceRow, type WorkspaceStaleness, WorkspaceVcsRequiredError, WorkstreamExistsError, WorkstreamNameInvalidError, WorkstreamNameReservedError, WorkstreamNotFoundError, type WorkstreamOptions, type WorkstreamSnapshot, type WorkstreamSnapshotSlowFields, type WorkstreamSummary, abortAgent, acceptTask, activeMux, addBlockEdge, addNote, addTask, adoptAgent, agentKey, agentStateGlyph, agentStateHistogram, ambientFlush, ambientIngest, ambientSyncPass, appendLog, applyIncomingOp, applyOp, applyOps, assertValidPaneId, awaitPaneQuiescence, backendByName, capturePane, checkCaseCollisions, checkCheapDriftInvariant, checkCommandResolvable, checkDbInsideSyncDir, checkDrift, checkFleetHazards, checkNetworkMount, claimTask, classifyFsType, closeAgent, closeTask, compareHlc, composeAgentTitle, countProblems, createWorkspace, ctlRuntimeState, currentAgentName, currentOpContext, currentPaneTitle, decorateWithDirty, decorateWithStaleness, defaultDbPath, defaultSendDelayMs, defaultSendReadinessMs, defaultSpawnLivenessMs, defaultStateDir, deleteAgent, deleteTask, detectBackend, detectMux, discoverPeers, driftRemediation, emitEvent, ensureWorkstream, envVarNameForCli, expectsCtl, findCaseCollisions, flushSegment, foregroundPgid, formatDriftRecord, formatHlc, formatPair, freeWorkspace, getAgent, getAgentByPane, getParallelTracks, getPrerequisites, getTask, getTaskEdges, getTaskEdgesWithStatus, getWaitPollCount, getWatermark, getWorkspaceForAgent, getWorkspaceStaleness, gitBackend, hasWorkMarker, idFromTitle, idFromTitleVerbose, ingestFromDb, ingestSegment, insertAgent, inspectLinks, installCapture, interruptAgent, isKickSignal, isPathInside, isTaskStatus, isValidAgentName, isValidPair, isValidPaneId, isValidTaskId, isValidWorkstreamName, isWorkspaceStale, jjBackend, kickAgent, killPane, killSession, latestSeq, linkPi, linkSkill, listAgents, listAllOrphanWorkspaces, listBlocked, listGoals, listInProgress, listLiveAgents, listLogs, listNotes, listPanes, listPanesInSession, listReady, listRecentClosed, listRecentGroups, listSessions, listTasks, listTasksByOwner, listWindows, listWorkspaceOrphans, listWorkspaces, listWorkstreams, loadDoctorChecks, loadDoctorSummary, loadFullDag, loadWorkstreamSnapshot, loadWorkstreamSnapshotFast, loadWorkstreamSnapshotSlow, localMachineId, locksDir, mapLegacyStatus, mergeSnapshotFastSlow, mostRecentGroup, murmurAvailable, mux, muxByName, newSession, newSessionWithPane, newWindow, nextHlc, noneBackend, opSubject, openDb, openTask, paneExists, paneTTY, parkTask, parseAgentNameFromTitle, parseHlc, parseOpKey, parsePsTtyOutput, peerStatuses, planUndo, priorFieldValue, probeFilesystem, readAgent, readAgentStates, readFileLockMeta, readManifest, rebuildInto, receiveHlc, reconcile, refreshAgentTitle, releaseTask, remediationParagraph, removeBlockEdge, renderForest, renderOp, renderOpLine, renderTaskTree, repairPeer, reparentTask, resetCommandResolverForTests, resetKickProcessExecutor, resetMux, resetSleep, resetTmuxExecutor, resetWaitPollCount, resetWatermark, resolveActorIdentity, resolveCliCommand, resolveCliCommandWithSource, resolveGroupId, resolvePair, resolvePeerRef, roiBucket, segmentLineCount, segmentPath, selectLayout, sendToAgent, sendToPane, sendViaTransport, sessionExists, setCommandResolverForTests, setKickProcessExecutor, setMuxForTests, setPaneTitle, setSleepForTests, setTaskStatus, setTmuxExecutor, setWaitSleepForTests, setWaitStuckWarnForTests, setWatermark, slBackend, sleep, slugifyTitle, slugifyTitleVerbose, spawnAgent, splitWindow, summarizeOwnedTasks, summarizeWorkstream, syncDir, syncEnabled, syncPass, teardownWorkstream, tmux, tmuxBackend, transportNextSteps, undoGroup, unparkTask, updateTask, verifyAgainstManifest, waitForTasks, withCaptureSuppressed, withFileLock, withOpContext, workspacePath, workspacesRoot, yankCommandForCheck };
+export { AGENT_STATE_GLYPH, type AbortAgentOptions, type AbortResult, type AddNoteOptions, type AddTaskOptions, type AdoptAgentOptions, type AdoptAgentResult, AgentAbortNeedsCtlError, AgentAbortTimeoutError, AgentBusyError, AgentCtlUnreachableError, AgentDiedOnSpawnError, AgentEmptySendError, AgentExistsError, AgentExtensionOutdatedError, AgentFreshNeedsCtlError, AgentNameExhaustedError, AgentNotFoundError, AgentNotInWorkstreamError, AgentPaneDeadError, type AgentRow, AgentSendIndeterminateError, AgentSlashCommandUnsupportedError, AgentSpawnCliNotFoundError, AgentSpawnStartupError, type AmbientOptions, type AmbientResult, type AppendLogOptions, type ApplyResult, type BlockEdgeResult, CAPTURE_TRIGGER_DDL, CURRENT_SCHEMA_VERSION, type CaptureDb, type CaptureIntent, type CaptureOptions, type CaseCollision, type CheapDriftReport, type ClaimResult, type ClaimTaskOptions, ClaimerNotRegisteredError, type CloseAgentOptions, type CloseAgentResult, type CloseSubstate, type CloseTaskResult, type CommandResolutionResult, type CommandResolver, CrossWorkstreamEdgeError, type CtlLink, CycleError, DEFAULT_SUBSTATE, DRIFT_REPORT_CAP, type Db, type DeleteTaskResult, type DoctorCheck, type DoctorStatus, type DoctorSummary, DriftDetectedError, type DriftRecord, type DriftReport, EXPECTED_TABLES, type EvidenceOption, type FileLockOptions, type FleetHazard, type FlushResult, type FsProbe, type FullDag, GLYPH, GroupIdAmbiguousError, type GroupSummary, HazardFailError, type HazardSeverity, type Hlc, HlcOverflowError, HlcParseError, HomeDirAsProjectRootError, type IdFromTitleResult, type IngestFromDbResult, type IngestResult, type InsertAgentInput, InvalidSubstateError, type InverseOp, KNOWN_INTENTS, KNOWN_VERBS, type KickAgentOptions, type KickAgentResult, type KickProcessExecutor, type KickSignal, type KnownIntent, LinkConflictError, type LinkState, type LinkStatus, type ListLiveAgentsOptions, type ListLogsOptions, type ListNotesOptions, type ListReadyOptions, type ListTasksOptions, type LiveAgent, type LiveAgentsView, type LoadFullDagOptions, type LoadWorkstreamSnapshotOptions, type LocalIntent, type LogKind, LogKindReservedError, type LogRow, MACHINE_LOCAL_ENTITIES, MACHINE_LOCAL_TABLES, MU_SHIM_MARKER, MachineIdentityMissingError, type MachineLocalEntity, type MachineLocalLoss, type MachineLocalTable, type MuxBackend, type MuxBackendName, MuxError, type MuxPane, type MuxPaneStatus, type MuxSession, type MuxWindow, type NewSessionOptions, type NewWindowOptions, NoForegroundProcessError, NoMultiplexerError, NothingToUndoError, OP_CTX_DDL, type Op, type OpContext, OpEntityNotSyncedError, OpKeyMalformedError, type OpenDbOptions, type OwnedTasksSummary, PANE_ID_RE, PEER_SHORT_LEN, PEER_STALE_MS, PORTABLE_TABLES, PaneNotFoundError, PaneNotInSessionError, type ParkTaskOptions, type PeerSegment, type PeerStatus, type PortableTable, ReaperDetectedDuringWaitError, type RebuildOptions, type RebuildReport, RebuildTargetExistsError, RebuildTargetIsSourceError, type ReconcileMode, type ReconcileOptions, type ReconcileReport, type ReleaseResult, type ReleaseTaskOptions, type RemoveBlockEdgeResult, type RenderableOp, type RenderedOp, type ReparentTaskResult, type RoiBucket, type RuntimeState, SEGMENT_FORMAT_VERSION, SYNCED_ENTITIES, SchemaTooNewError, SchemaTooOldError, type SegmentDefect, type SegmentDefectKind, type SegmentLine, type SegmentManifest, type SendOptions, type SendResult, type SendWarning, type SetStatusOptions, type SetStatusResult, type SlugifyResult, type SpawnAgentOptions, type SplitWindowOptions, StallDetectedDuringWaitError, type StateReading, type StateSource, type StrandedWorkspaceOrphan, SubstateReasonRequiredError, type SyncPassResult, SyncPeerNotFoundError, SyncPeerRefAmbiguousError, SyncSourceNotFoundError, type SyncedEntity, TASK_STATUSES, TASK_STATUS_LIST, TASK_SUBSTATES, TASK_SUBSTATE_ROWS, TaskAlreadyOwnedError, TaskClaimStaleWorkspaceError, type TaskEdgeWithStatus, type TaskEdges, type TaskEdgesWithStatus, TaskExistsError, TaskIdInvalidError, TaskInTriageError, TaskNotFoundError, TaskNotInWorkstreamError, type TaskNoteRow, type TaskPair, TaskParkStateError, TaskParkedError, type TaskRow, type TaskStatus, type TaskSubstate, TaskTitleSlugEmptyError, type TaskWaitOptions, type TaskWaitRef, type TaskWaitResult, type TaskWaitTaskState, type TeardownResult, TmuxError, type TmuxExecResult, type TmuxExecutor, type TmuxPane, type TmuxSession, type TmuxWindow, type Track, type Transport, UNKNOWN_REASON, UndoGroupNotFoundError, type UndoOptions, type UndoPlan, type UndoResult, UndoSupersededError, type UpdateTaskOptions, type UpdateTaskResult, type VcsBackend, type VcsBackendName, WORKSPACE_STALE_THRESHOLD, WorkspaceConflictError, WorkspaceDirtyError, WorkspaceExistsError, type WorkspaceFailure, WorkspaceNotFoundError, type WorkspaceOrphan, WorkspaceOwnerBusyError, WorkspacePathNotEmptyError, WorkspacePreservedError, type WorkspaceRow, type WorkspaceStaleness, WorkspaceVcsRequiredError, WorkstreamExistsError, WorkstreamNameInvalidError, WorkstreamNameReservedError, WorkstreamNotFoundError, type WorkstreamOptions, type WorkstreamSnapshot, type WorkstreamSnapshotSlowFields, type WorkstreamSummary, abortAgent, acceptTask, activeMux, addBlockEdge, addNote, addTask, adoptAgent, agentKey, agentStateGlyph, agentStateHistogram, ambientFlush, ambientIngest, ambientSyncPass, appendLog, applyIncomingOp, applyOp, applyOps, assertValidPaneId, awaitPaneQuiescence, backendByName, capturePane, checkCaseCollisions, checkCheapDriftInvariant, checkCommandResolvable, checkDbInsideSyncDir, checkDrift, checkFleetHazards, checkNetworkMount, claimTask, classifyFsType, closeAgent, closeTask, compareHlc, composeAgentTitle, countProblems, createWorkspace, ctlRuntimeState, currentAgentName, currentOpContext, currentPaneTitle, decorateWithDirty, decorateWithStaleness, defaultDbPath, defaultSendDelayMs, defaultSendReadinessMs, defaultSpawnLivenessMs, defaultStateDir, deleteAgent, deleteTask, detectBackend, detectMux, discoverPeers, driftRemediation, emitEvent, ensureWorkstream, envVarNameForCli, expectsCtl, findCaseCollisions, flushSegment, foregroundPgid, formatDriftRecord, formatHlc, formatPair, freeWorkspace, getAgent, getAgentByPane, getParallelTracks, getPrerequisites, getTask, getTaskEdges, getTaskEdgesWithStatus, getWaitPollCount, getWatermark, getWorkspaceForAgent, getWorkspaceStaleness, gitBackend, hasWorkMarker, idFromTitle, idFromTitleVerbose, ingestFromDb, ingestSegment, insertAgent, inspectLinks, installCapture, interruptAgent, isKickSignal, isPathInside, isTaskStatus, isValidAgentName, isValidPair, isValidPaneId, isValidTaskId, isValidWorkstreamName, isWorkspaceStale, jjBackend, kickAgent, killPane, killSession, latestSeq, linkPi, linkSkill, listAgents, listAllOrphanWorkspaces, listBlocked, listGoals, listInProgress, listLiveAgents, listLogs, listNotes, listPanes, listPanesInSession, listReady, listRecentClosed, listRecentGroups, listSessions, listTasks, listTasksByOwner, listWindows, listWorkspaceOrphans, listWorkspaces, listWorkstreams, loadDoctorChecks, loadDoctorSummary, loadFullDag, loadWorkstreamSnapshot, loadWorkstreamSnapshotFast, loadWorkstreamSnapshotSlow, localMachineId, locksDir, mapLegacyStatus, mergeSnapshotFastSlow, mostRecentGroup, murmurAvailable, mux, muxByName, newSession, newSessionWithPane, newWindow, nextHlc, noneBackend, opSubject, openDb, openTask, paneExists, paneTTY, parkTask, parseAgentNameFromTitle, parseHlc, parseOpKey, parsePsTtyOutput, peerStatuses, planUndo, priorFieldValue, probeFilesystem, readAgent, readAgentStates, readFileLockMeta, readManifest, rebuildInto, receiveHlc, reconcile, refreshAgentTitle, releaseTask, remediationParagraph, removeBlockEdge, renderForest, renderOp, renderOpLine, renderTaskTree, repairPeer, reparentTask, resetCommandResolverForTests, resetKickProcessExecutor, resetMux, resetSleep, resetTmuxExecutor, resetWaitPollCount, resetWatermark, resolveActorIdentity, resolveCliCommand, resolveCliCommandWithSource, resolveGroupId, resolvePair, resolvePeerRef, roiBucket, segmentLineCount, segmentPath, selectLayout, sendToAgent, sendToPane, sendViaTransport, sessionExists, setCommandResolverForTests, setKickProcessExecutor, setMuxForTests, setPaneTitle, setSleepForTests, setTaskStatus, setTmuxExecutor, setWaitSleepForTests, setWaitStuckWarnForTests, setWatermark, slBackend, sleep, slugifyTitle, slugifyTitleVerbose, spawnAgent, splitWindow, summarizeOwnedTasks, summarizeWorkstream, syncDir, syncEnabled, syncPass, teardownWorkstream, tmux, tmuxBackend, transportNextSteps, undoGroup, unparkTask, updateTask, verifyAgainstManifest, waitForTasks, withCaptureSuppressed, withFileLock, withOpContext, workspacePath, workspacesRoot, yankCommandForCheck };