@mu-crew/mu 1.6.0 → 3.0.0

package/dist/index.d.ts

@@ -1,5 +1,36 @@
 import { Database } from 'better-sqlite3';
 
+type RuntimeState = "busy" | "needs_input" | "needs_permission" | "unknown";
+type StateSource = "murmur" | "herdr" | "none";
+interface StateReading {
+    state: RuntimeState;
+    source: StateSource;
+    since: number | null;
+    alive: boolean;
+    reason?: string;
+}
+interface StateAgentRef {
+    name: string;
+    workstreamName: string;
+    paneId: string;
+}
+declare const UNKNOWN_REASON: {
+    readonly murmurMissing: "murmur not installed";
+    readonly extensionMissing: "murmur pi extension not linked";
+    readonly noRow: "murmur has no row";
+    readonly stale: "remote snapshot stale";
+    readonly herdrNone: "herdr reports no state";
+    readonly paneGone: "pane gone";
+};
+declare function agentKey(a: {
+    name: string;
+    workstreamName: string;
+}): string;
+declare function murmurAvailable(): boolean;
+declare function readAgentStates(agents: readonly StateAgentRef[], opts?: {
+    now?: number;
+}): Promise<Map<string, StateReading>>;
+
 /**
  * One actionable next step. The `intent` is human-prose ("Drop notes
  * as you work"); the `command` is a literal shell command the user (or
@@ -67,14 +98,14 @@ declare class SchemaTooOldError extends Error implements HasNextSteps {
     constructor(detectedVersion: number, requiredVersion: number);
     errorNextSteps(): NextStep[];
 }
-/** The schema version a fresh DB starts at. v10 drops the REJECTED
- *  and DEFERRED task statuses (three-state lifecycle: OPEN,
- *  IN_PROGRESS, CLOSED). See CHANGELOG.md. */
-declare const CURRENT_SCHEMA_VERSION = 10;
+/** The schema version a fresh DB starts at. v11 adds tasks.substate
+ *  and the task_substates lookup table on top of v10's three-state
+ *  lifecycle (OPEN, IN_PROGRESS, CLOSED). See CHANGELOG.md. */
+declare const CURRENT_SCHEMA_VERSION = 11;
 /** Tables a healthy DB must contain. Single source of truth so
  *  `mu doctor` and any other consumer don't drift. Adding a new table
  *  = one new entry here AND a CREATE TABLE in CURRENT_SCHEMA, plus a
- *  CURRENT_SCHEMA_VERSION bump. Sorted; exactly 10 entries in v10. */
+ *  CURRENT_SCHEMA_VERSION bump. Sorted; exactly 11 entries in v11. */
 declare const EXPECTED_TABLES: readonly string[];
 /** Op entities that cross machines. Everything else is machine-local.
  *  Readonly tuple (not `string[]`) so `SyncedEntity` is a real union
@@ -118,6 +149,8 @@ type PortableTable = (typeof PORTABLE_TABLES)[number];
  *    machine_identity IS the per-machine identity.
  *    schema_version   local bookkeeping.
  *    sync_peers       local bookkeeping (per-peer watermarks).
+ *    task_substates   seeded identically on every machine from
+ *                     TASK_SUBSTATE_ROWS; code, not data.
  *    ops              see below — the carrier, not cargo.
  *
  *  `ops` is listed here deliberately rather than omitted. It is not
@@ -132,73 +165,13 @@ type PortableTable = (typeof PORTABLE_TABLES)[number];
  *  is an FK into `agents`, and `agents` is machine-local. Therefore
  *  OWNERSHIP DOES NOT SYNC. The deleted db-sync.ts reached the same
  *  conclusion via an `includeOwners` flag; here it is structural. */
-declare const MACHINE_LOCAL_TABLES: readonly ["agents", "machine_identity", "ops", "schema_version", "sync_peers", "vcs_workspaces"];
+declare const MACHINE_LOCAL_TABLES: readonly ["agents", "machine_identity", "ops", "schema_version", "sync_peers", "task_substates", "vcs_workspaces"];
 type MachineLocalTable = (typeof MACHINE_LOCAL_TABLES)[number];
 
-/**
- * The full agent lifecycle status. Most values are scrollback-derived
- * (`DetectedStatus`); the rest are set by the lifecycle layer.
- */
-type AgentStatus = "spawning" | "busy" | "needs_input" | "needs_permission" | "free" | "unreachable" | "terminated";
-/** Status that can be inferred from pane scrollback. */
-type DetectedStatus = "busy" | "needs_input" | "needs_permission";
-/**
- * Run the detector against pane scrollback and return the inferred
- * status. Permission overrides busy.
- */
-declare function detectPiStatus(scrollback: string): DetectedStatus;
-/**
- * Public for tests — extract the tail window the detector actually
- * inspects. Take last TAIL_WINDOW_LINES, strip trailing blanks, take
- * last TAIL_LINES.
- */
-declare function extractTail(scrollback: string): string;
-
-/**
- * Agent status → glyph, used by CLI and TUI status surfaces.
- */
-declare const AGENT_STATUS_GLYPH: Record<AgentStatus, string>;
-/**
- * Single rendering helper for agent status glyphs. Keep callers off
- * AGENT_STATUS_GLYPH indexing so the fallback policy stays in one place.
- */
-declare function agentStatusGlyph(status: AgentStatus): string;
-/**
- * Non-agent state glyphs, keyed by what they MEAN rather than what
- * they look like. A call site asks for `GLYPH.stale`, never for a
- * clock — so re-pointing the clock is a one-line edit here.
- *
- * `ok` / `fail` / `warn` deliberately reuse the same codepoints as the
- * agent statuses they rhyme with (`free`, `terminated`): a check-circle
- * means "fine" whether the row is an agent, a workspace or a doctor
- * check.
- */
-declare const GLYPH: {
-    /** Healthy, clean, passing, closed-successfully. */
-    readonly ok: "";
-    /** Failed check. */
-    readonly fail: "";
-    /** Needs attention but not broken (idle-but-assigned, stale warning). */
-    readonly warn: "";
-    /** Workspace has uncommitted edits. */
-    readonly dirty: "";
-    /** Workspace is ≥ WORKSPACE_STALE_THRESHOLD commits behind main. */
-    readonly stale: "";
-    /** Task is blocked by an incoming edge. */
-    readonly blocked: "";
-    /** Track whose roots merged (diamond dependency). */
-    readonly merge: "";
-    /** Agent owns more than one task (pane-title multi-count slot). */
-    readonly multi: "";
-    /** Filter toggle: enabled / disabled. */
-    readonly on: "";
-    readonly off: "";
-    /** Status outside the known enum. */
-    readonly unknown: "";
-};
-
 /** The multiplexers mu can drive. */
 type MuxBackendName = "herdr" | "tmux";
+/** Runtime states a mux backend can report directly for one pane. */
+type MuxPaneStatus = "busy" | "needs_input" | "needs_permission";
 interface MuxSession {
     name: string;
 }
@@ -458,22 +431,11 @@ interface MuxBackend {
     sendToPane(paneId: string, text: string, opts?: SendOptions): Promise<void>;
     capturePane(paneId: string, opts?: CaptureOptions): Promise<string>;
     /**
-     * The pane's lifecycle status AS THE MUX ITSELF CLASSIFIES IT, or
-     * undefined when the pane is gone / unclassified.
-     *
-     * OPTIONAL by design, and the one place the two backends genuinely
-     * differ in kind rather than in syntax. tmux knows nothing about what
-     * runs inside a pane, so it omits this and mu falls back to scraping
-     * scrollback with the per-CLI detector in `src/detect.ts`. herdr
-     * watches the terminal continuously across every agent kind it
-     * recognises, so it implements this and the detector is BYPASSED
-     * entirely — guessing from a 100-line tail would be strictly worse
-     * information than the substrate's own answer.
-     *
-     * Absent method ⇒ "ask the detector". Present-but-undefined result ⇒
-     * "this pane has no status", NOT "free": no detector may mint `free`.
+     * The pane's runtime state as the mux itself reports it, or undefined
+     * when the pane is gone or unclassified. tmux omits this capability;
+     * herdr reports it directly.
      */
-    paneStatus?(paneId: string): Promise<DetectedStatus | undefined>;
+    paneStatus?(paneId: string): Promise<MuxPaneStatus | undefined>;
     enableMuPaneBordersForSession(session: string): Promise<number>;
     enableMuPaneBordersForPane(paneId: string): Promise<void>;
     /** Copy-pasteable shell line that lands the user on `target`. */
@@ -570,9 +532,8 @@ declare class HerdrSyntaxError extends Error {
  *
  * A REFUSAL, not a fallback. herdr's `pane run <command>` would happily
  * start the binary, but herdr would then never classify that pane, and
- * on this backend herdr's classification IS mu's status source
- * (`paneStatus()` bypasses src/detect.ts entirely). A pane mu can start
- * but never observe is the same family of failure as a pane mu records
+ * on this backend herdr's report is mu's runtime state source. A pane
+ * mu can start but never observe is the same family of failure as a pane mu records
  * with nothing running in it: it looks fine and lies forever.
  *
  * Not a `MuxError`: the substrate is healthy and answered precisely.
@@ -955,9 +916,8 @@ declare function hasWorkMarker(scrollback: string): boolean;
  *
  * Because the blocker is a model call, no fixed sleep can be correct —
  * `sleep 2` is a coin flip, not a fix. The signal already existed: pi's
- * spinner is a Braille glyph and `detectPiStatus` calls Braille busy,
- * so this reuses the detector rather than adding a second readiness
- * mechanism, matching `awaitSpawnReadiness` in src/agents/spawn.ts.
+ * spinner is a Braille glyph, so the private input-timing helper can wait
+ * for it to clear before sending.
  *
  * `needs_permission` counts as ready: a pane sitting on a confirm
  * dialog is waiting for a keystroke, and refusing to send would break
@@ -1054,6 +1014,7 @@ type mux_MuxError = MuxError;
 declare const mux_MuxError: typeof MuxError;
 type mux_MuxHealth = MuxHealth;
 type mux_MuxPane = MuxPane;
+type mux_MuxPaneStatus = MuxPaneStatus;
 type mux_MuxSession = MuxSession;
 type mux_MuxWindow = MuxWindow;
 type mux_NewSessionOptions = NewSessionOptions;
@@ -1079,7 +1040,7 @@ declare const mux_setHerdrExecutor: typeof setHerdrExecutor;
 declare const mux_setMuxForTests: typeof setMuxForTests;
 declare const mux_tmuxBackend: typeof tmuxBackend;
 declare namespace mux {
-  export { type mux_AttachTarget as AttachTarget, type mux_CaptureOptions as CaptureOptions, mux_HerdrCommandOverrideError as HerdrCommandOverrideError, mux_HerdrError as HerdrError, mux_HerdrNotImplementedError as HerdrNotImplementedError, mux_HerdrSyntaxError as HerdrSyntaxError, mux_HerdrUnsupportedCliError as HerdrUnsupportedCliError, mux_HerdrWorkspaceGroupCloseError as HerdrWorkspaceGroupCloseError, type mux_MuxBackend as MuxBackend, type mux_MuxBackendName as MuxBackendName, type mux_MuxCommand as MuxCommand, type mux_MuxDiagnostics as MuxDiagnostics, mux_MuxError as MuxError, type mux_MuxHealth as MuxHealth, type mux_MuxPane as MuxPane, type mux_MuxSession as MuxSession, type mux_MuxWindow as MuxWindow, type mux_NewSessionOptions as NewSessionOptions, type mux_NewSessionWithPaneOptions as NewSessionWithPaneOptions, type mux_NewWindowOptions as NewWindowOptions, mux_NoMultiplexerError as NoMultiplexerError, mux_PaneNotFoundError as PaneNotFoundError, type mux_SendOptions as SendOptions, type mux_SendWarning as SendWarning, type mux_SplitWindowOptions as SplitWindowOptions, type mux_StartAgentInPaneOptions as StartAgentInPaneOptions, mux_activeMux as activeMux, mux_detectMux as detectMux, mux_herdrBackend as herdrBackend, mux_isHerdrStatusUsable as isHerdrStatusUsable, mux_muxByName as muxByName, mux_parseAgentNameFromTitle as parseAgentNameFromTitle, mux_resetHerdrExecutor as resetHerdrExecutor, mux_resetMux as resetMux, mux_setHerdrExecutor as setHerdrExecutor, mux_setMuxForTests as setMuxForTests, mux_tmuxBackend as tmuxBackend };
+  export { type mux_AttachTarget as AttachTarget, type mux_CaptureOptions as CaptureOptions, mux_HerdrCommandOverrideError as HerdrCommandOverrideError, mux_HerdrError as HerdrError, mux_HerdrNotImplementedError as HerdrNotImplementedError, mux_HerdrSyntaxError as HerdrSyntaxError, mux_HerdrUnsupportedCliError as HerdrUnsupportedCliError, mux_HerdrWorkspaceGroupCloseError as HerdrWorkspaceGroupCloseError, type mux_MuxBackend as MuxBackend, type mux_MuxBackendName as MuxBackendName, type mux_MuxCommand as MuxCommand, type mux_MuxDiagnostics as MuxDiagnostics, mux_MuxError as MuxError, type mux_MuxHealth as MuxHealth, type mux_MuxPane as MuxPane, type mux_MuxPaneStatus as MuxPaneStatus, type mux_MuxSession as MuxSession, type mux_MuxWindow as MuxWindow, type mux_NewSessionOptions as NewSessionOptions, type mux_NewSessionWithPaneOptions as NewSessionWithPaneOptions, type mux_NewWindowOptions as NewWindowOptions, mux_NoMultiplexerError as NoMultiplexerError, mux_PaneNotFoundError as PaneNotFoundError, type mux_SendOptions as SendOptions, type mux_SendWarning as SendWarning, type mux_SplitWindowOptions as SplitWindowOptions, type mux_StartAgentInPaneOptions as StartAgentInPaneOptions, mux_activeMux as activeMux, mux_detectMux as detectMux, mux_herdrBackend as herdrBackend, mux_isHerdrStatusUsable as isHerdrStatusUsable, mux_muxByName as muxByName, mux_parseAgentNameFromTitle as parseAgentNameFromTitle, mux_resetHerdrExecutor as resetHerdrExecutor, mux_resetMux as resetMux, mux_setHerdrExecutor as setHerdrExecutor, mux_setMuxForTests as setMuxForTests, mux_tmuxBackend as tmuxBackend };
 }
 
 /**
@@ -1130,9 +1091,6 @@ interface ReconcileReport {
      *  this is the count of rows that WOULD have been pruned; in `full`
      *  mode it's the count actually deleted. */
     prunedGhosts: number;
-    /** Number of agents whose status was changed by scrollback detection.
-     *  Always 0 in `report-only` mode (status detection is skipped). */
-    statusChanges: number;
     /** Panes in the workstream's tmux session that look like agents but
      *  aren't in the registry. NOT auto-adopted. */
     orphans: MuxPane[];
@@ -1823,7 +1781,6 @@ interface AgentRow {
     workstreamName: string;
     cli: string;
     paneId: string;
-    status: AgentStatus;
     role: string;
     /** Window name; null when the agent has its own window named after itself. */
     tab: string | null;
@@ -1831,27 +1788,19 @@ interface AgentRow {
     createdAt: string;
     /** ISO 8601 timestamp. */
     updatedAt: string;
-    /**
-     * Derived 'idle but assigned' flag (idle_assigned_agent_detection).
-     * Set ONLY by `listLiveAgents` (and the helper `computeAgentIdle`);
-     * never stored in the DB. Predicate:
-     *   status === 'needs_input'
-     *   AND owns ≥1 IN_PROGRESS task in this workstream
-     *   AND (now - updated_at) >= MU_IDLE_THRESHOLD_MS (default 300_000ms)
-     *
-     * Surfaces the third lifecycle state (alive but assigned, no recent
-     * progress) to `mu state` renders + `mu state --json`. Omitted (i.e.
-     * absent — NOT `false`) when the predicate doesn't fire, so JSON
-     * consumers can do a simple `if (agent.idle)` check and the field
-     * stays out of the way for callers that don't care.
-     */
+}
+interface LiveAgent extends AgentRow {
+    state: RuntimeState;
+    source: StateSource;
+    /** ISO 8601 time when the source entered this state. */
+    since: string | null;
+    reason?: string;
     idle?: boolean;
 }
 interface InsertAgentInput {
     name: string;
     workstream: string;
     paneId: string;
-    status: AgentStatus;
     /** Defaults to "pi" via schema DEFAULT. */
     cli?: string;
     /** Defaults to "full-access" via schema DEFAULT. */
@@ -1875,19 +1824,6 @@ declare function getAgent(db: Db, name: string, workstream: string): AgentRow |
 declare function listAgents(db: Db, opts?: {
     workstream?: string;
 }): AgentRow[];
-/**
- * Update an agent's status. Returns true if a row was matched.
- * Also bumps updated_at. Workstream is required (v5: agents.name is
- * per-workstream unique).
- */
-declare function updateAgentStatus(db: Db, name: string, status: AgentStatus, workstream: string): boolean;
-/** Back-compat alias for the agent status glyph map, which now lives
- *  with every other state glyph in src/glyphs.ts. New code should
- *  import AGENT_STATUS_GLYPH (or the agentStatusGlyph helper) from
- *  there; this name is kept because it is part of the SDK surface via
- *  src/index.ts. */
-declare const STATUS_EMOJI: Record<AgentStatus, string>;
-
 /** Build the pane title for `agent` based on current DB state.
  *  Pure (no tmux side effect; no DB write). Read-only on the DB. */
 declare function composeAgentTitle(db: Db, agent: AgentRow): string;
@@ -2013,7 +1949,7 @@ interface ListLiveAgentsOptions {
 }
 interface LiveAgentsView {
     /** All registered agents in the workstream, post-reconcile. */
-    agents: AgentRow[];
+    agents: LiveAgent[];
     /** Panes in the tmux session that look like agents but aren't registered. */
     orphans: MuxPane[];
     /** Diagnostic numbers from the reconcile pass; useful for `mu doctor`. */
@@ -2171,8 +2107,8 @@ interface CaptureDb {
 }
 
 type TaskStatus = "OPEN" | "IN_PROGRESS" | "CLOSED";
-/** Every legal task status, in canonical order (matches the schema
- *  CHECK clause). Exported so CLI surfaces (`--status` validators,
+/** Every legal task status, in canonical order (matches the seeded
+ *  task_substates rows). Exported so CLI surfaces (`--status` validators,
  *  --help text, error messages) name them all in one place; missing
  *  one used to silently lie about the supported set. */
 declare const TASK_STATUSES: readonly TaskStatus[];
@@ -2182,15 +2118,50 @@ declare function isTaskStatus(s: string): s is TaskStatus;
  *  --help text and error messages so adding a new status doesn't
  *  leave stale lists rotting in the CLI surface. */
 declare const TASK_STATUS_LIST: string;
+/** Legal substates per status. `substate` qualifies `status` and never
+ *  touches edge semantics: only `status === "CLOSED"` satisfies a
+ *  `blocks` edge. */
+declare const TASK_SUBSTATES: {
+    readonly OPEN: readonly ["todo", "parked"];
+    readonly IN_PROGRESS: readonly ["active"];
+    readonly CLOSED: readonly ["done", "wontfix", "duplicate", "superseded"];
+};
+type TaskSubstate = (typeof TASK_SUBSTATES)[TaskStatus][number];
+/** The substate a status takes when none is given. Never null: an
+ *  absent value must not carry meaning. */
+declare const DEFAULT_SUBSTATE: {
+    readonly [S in TaskStatus]: (typeof TASK_SUBSTATES)[S][number];
+};
+interface TaskPair {
+    status: TaskStatus;
+    substate: TaskSubstate;
+}
+/** Rows for seeding task_substates: [status, substate, isDefault]. */
+declare const TASK_SUBSTATE_ROWS: ReadonlyArray<readonly [TaskStatus, TaskSubstate, 0 | 1]>;
+declare function isValidPair(status: string, substate: string): boolean;
+/** REJECTED -> {CLOSED, wontfix}; DEFERRED -> {OPEN, parked}; else null. */
+declare function mapLegacyStatus(value: string): TaskPair | null;
+/** Map a stored/remote pair onto a legal one. Legacy status -> mapped pair
+ *  (ignores substate arg). Unknown status -> null. Known status with
+ *  unknown/missing/mismatched substate -> {status, DEFAULT_SUBSTATE[status]}. */
+declare function resolvePair(status: string, substate: unknown): TaskPair | null;
+/** "OPEN" for default pairs, "OPEN/parked" otherwise. Shared by CLI + TUI. */
+declare function formatPair(pair: TaskPair): string;
 
 interface SetStatusResult {
     /** Status before the call. */
     previousStatus: TaskStatus;
     /** Status after the call (== requested status). */
     status: TaskStatus;
-    /** True iff the row actually changed. False on idempotent no-op. */
+    /** Substate before the call. */
+    previousSubstate: TaskSubstate;
+    /** Substate after the call (== requested substate, or the status default). */
+    substate: TaskSubstate;
+    /** True iff status OR substate changed. False on idempotent no-op. */
     changed: boolean;
 }
+/** The substates a task can be closed as (`mu task close --as`). */
+type CloseSubstate = Extract<TaskSubstate, "done" | "wontfix" | "duplicate" | "superseded">;
 /**
  * Optional evidence string carried on lifecycle verbs (close / open /
  * claim / release). Lands in the auto-emitted `kind='event'` payload
@@ -2202,14 +2173,19 @@ interface SetStatusResult {
 interface EvidenceOption {
     evidence?: string;
 }
+interface SetStatusOptions extends EvidenceOption {
+    workstream: string;
+    /** Substate to land on; defaults to DEFAULT_SUBSTATE[status]. A pair
+     *  outside TASK_SUBSTATES throws InvalidSubstateError before any write. */
+    substate?: TaskSubstate;
+}
 /**
- * Flip a task's status to any of OPEN / IN_PROGRESS / CLOSED.
- * Idempotent: setting a task to its current status is a no-op (returns
+ * Flip a task's status to any of OPEN / IN_PROGRESS / CLOSED, writing
+ * status and substate in ONE UPDATE (one op, one HLC — spec D7).
+ * Idempotent: setting a task to its current pair is a no-op (returns
  * `changed: false`) rather than throwing. Owner is unchanged.
  */
-declare function setTaskStatus(db: Db, localId: string, status: TaskStatus, opts: EvidenceOption & {
-    workstream: string;
-}): SetStatusResult;
+declare function setTaskStatus(db: Db, localId: string, status: TaskStatus, opts: SetStatusOptions): SetStatusResult;
 /** Result of `closeTask` when called with `ifReady: true` and the
  *  task is NOT yet ready to close (still has at least one OPEN /
  *  IN_PROGRESS blocker). Distinguished from a regular `SetStatusResult`
@@ -2230,6 +2206,9 @@ interface CloseSkippedResult {
     previousStatus: TaskStatus;
     /** Status after the call (== previousStatus, since we no-op). */
     status: TaskStatus;
+    /** Substate before (and after) the call. */
+    previousSubstate: TaskSubstate;
+    substate: TaskSubstate;
     /** Always false on a skip (no row mutated). */
     changed: false;
     /** Local ids of every blocker still in OPEN or IN_PROGRESS, sorted
@@ -2254,6 +2233,19 @@ interface CloseTaskOptions extends EvidenceOption {
      *  as a bare `addNote` without `--author`). Surfaced in mufeedback
      *  task_close_evidence_does_not_append_the. */
     author?: string;
+    /** Closing substate; default "done". Any CLOSED/* satisfies edges. */
+    as?: CloseSubstate;
+    /** Required (non-empty) unless `as` is "done"; stored as a
+     *  `<AS>: <why>` note in the same op group. */
+    why?: string;
+}
+/** Result of a close that ran (not skipped). */
+interface CloseTaskResult extends SetStatusResult {
+    /** Direct same-workstream dependents that entered the `ready` view
+     *  because of this close, sorted. Computed only when `as` is not
+     *  "done" (spec D3: a non-done close must show what it released);
+     *  always [] for a done close. */
+    unblocked: string[];
 }
 /** Convenience: setTaskStatus(db, id, "CLOSED"). Accepts evidence.
  *  Skipped
@@ -2265,12 +2257,30 @@ interface CloseTaskOptions extends EvidenceOption {
  *  `mu task close --if-ready` so an orchestrator can fire-and-forget
  *  the umbrella close after every blocker resolves without first
  *  re-querying the graph. */
-declare function closeTask(db: Db, localId: string, opts: CloseTaskOptions): SetStatusResult | CloseSkippedResult;
+declare function closeTask(db: Db, localId: string, opts: CloseTaskOptions): CloseTaskResult | CloseSkippedResult;
 /** Convenience: setTaskStatus(db, id, "OPEN"). Owner intentionally NOT
  *  cleared — use `releaseTask` for that. Accepts evidence. */
 declare function openTask(db: Db, localId: string, opts: EvidenceOption & {
     workstream: string;
 }): SetStatusResult;
+interface ParkTaskOptions extends EvidenceOption {
+    workstream: string;
+    /** Required, non-empty; stored as a `PARKED: <why>` note. */
+    why: string;
+    author?: string;
+}
+/**
+ * OPEN/todo → OPEN/parked: keep the task out of `ready` / `next` and
+ * make `claim` refuse it without `--force`. Its dependents stay blocked
+ * (parked is still OPEN). Idempotent on OPEN/parked (no second note).
+ * Refuses IN_PROGRESS (release first) and CLOSED (open first) — one
+ * verb, one transition.
+ */
+declare function parkTask(db: Db, localId: string, opts: ParkTaskOptions): SetStatusResult;
+/** OPEN/parked → OPEN/todo. A no-op (`changed: false`) on any other pair. */
+declare function unparkTask(db: Db, localId: string, opts: EvidenceOption & {
+    workstream: string;
+}): SetStatusResult;
 
 interface ReleaseResult {
     /** The previous owner (null if the task was already unowned). */
@@ -2372,6 +2382,12 @@ interface ClaimTaskOptions extends EvidenceOption {
      * title (e.g. "deploy-bot" rather than "pi-mu").
      */
     actor?: string;
+    /**
+     * Claim an OPEN/parked task anyway. Without it, a parked task throws
+     * TaskParkedError before any write: parking means "keep out of the
+     * scheduler", so overriding it must be explicit.
+     */
+    force?: boolean;
 }
 interface ClaimResult {
     /** The agent now owning the task, or null when the claim was anonymous (--self). */
@@ -2440,6 +2456,8 @@ interface TaskRow {
     workstreamName: string;
     title: string;
     status: TaskStatus;
+    /** Qualifies status (e.g. OPEN/parked, CLOSED/wontfix). Never null. */
+    substate: TaskSubstate;
     impact: number;
     effortDays: number;
     /** Foreign-name reference to the owning agent (NULL when unowned). */
@@ -2466,6 +2484,7 @@ interface TaskEdges {
 interface TaskEdgeWithStatus {
     name: string;
     status: TaskStatus;
+    substate: TaskSubstate;
 }
 interface TaskEdgesWithStatus {
     /** Tasks that must close before this one can start (blockers),
@@ -2931,6 +2950,56 @@ declare class CrossWorkstreamEdgeError extends Error implements HasNextSteps {
     constructor(blocker: string, blockerWorkstream: string, dependent: string, dependentWorkstream: string);
     errorNextSteps(): NextStep[];
 }
+/**
+ * Thrown by `closeTask` (non-`done` `--as`) and `parkTask` when no
+ * non-empty `--why` was given. The reason is stored as a note, so a
+ * classification with no rationale is refused before any write.
+ */
+declare class SubstateReasonRequiredError extends Error implements HasNextSteps {
+    readonly verb: "close" | "park";
+    readonly substate: TaskSubstate;
+    readonly taskId: string;
+    readonly name = "SubstateReasonRequiredError";
+    constructor(verb: "close" | "park", substate: TaskSubstate, taskId: string);
+    errorNextSteps(): NextStep[];
+}
+/**
+ * Thrown by `parkTask` on an IN_PROGRESS or CLOSED task. Park is one
+ * transition (OPEN/todo → OPEN/parked); the owner releases, or the task
+ * is reopened, first.
+ */
+declare class TaskParkStateError extends Error implements HasNextSteps {
+    readonly taskId: string;
+    readonly status: "IN_PROGRESS" | "CLOSED";
+    readonly workstream: string;
+    readonly name = "TaskParkStateError";
+    constructor(taskId: string, status: "IN_PROGRESS" | "CLOSED", workstream: string);
+    errorNextSteps(): NextStep[];
+}
+/**
+ * Thrown by `claimTask` on an OPEN/parked task without `force`. Parked
+ * means "keep out of the scheduler"; claiming it anyway is explicit.
+ */
+declare class TaskParkedError extends Error implements HasNextSteps {
+    readonly taskId: string;
+    readonly workstream: string;
+    readonly name = "TaskParkedError";
+    constructor(taskId: string, workstream: string);
+    errorNextSteps(): NextStep[];
+}
+/**
+ * Thrown when a verb is asked for a (status, substate) pair that the
+ * task_substates table does not allow, e.g. `close --as parked`.
+ * Caught here rather than by the deferred FK, which would fail only at
+ * commit with an opaque constraint message.
+ */
+declare class InvalidSubstateError extends Error implements HasNextSteps {
+    readonly status: TaskStatus;
+    readonly substate: string;
+    readonly name = "InvalidSubstateError";
+    constructor(status: TaskStatus, substate: string);
+    errorNextSteps(): NextStep[];
+}
 
 declare function isValidTaskId(id: string): boolean;
 /**
@@ -3035,6 +3104,8 @@ declare function getTask(db: Db, localId: string, workstream: string): TaskRow |
 interface ListTasksOptions {
     /** Filter to one or more lifecycle statuses. Omitted = all statuses. */
     status?: TaskStatus | readonly TaskStatus[];
+    /** Filter to one or more substates (ANDed with `status`). */
+    substate?: TaskSubstate | readonly TaskSubstate[];
 }
 declare function listTasks(db: Db, workstream?: string, opts?: ListTasksOptions): TaskRow[];
 /** Options for listReady. The optional `statuses` filter composes
@@ -3045,6 +3116,8 @@ declare function listTasks(db: Db, workstream?: string, opts?: ListTasksOptions)
  *  shipped on `mu task list` (task_list_multi_status_union). */
 interface ListReadyOptions {
     status?: TaskStatus | readonly TaskStatus[];
+    /** Substate filter; the `ready` view already excludes OPEN/parked. */
+    substate?: TaskSubstate | readonly TaskSubstate[];
 }
 declare function listReady(db: Db, workstream: string, opts?: ListReadyOptions): TaskRow[];
 declare function listBlocked(db: Db, workstream: string): TaskRow[];
@@ -3177,6 +3250,12 @@ interface TaskWaitOptions {
      *  needs_input might BE the success path. See
      *  task_wait_stall_action_flag. */
     onStall?: "warn" | "exit";
+    /** Read an owner's current runtime state for attention detection.
+     *  Without this hook, SDK waits never infer a stall from stored data. */
+    readOwnerState?: (owner: {
+        name: string;
+        workstreamName: string;
+    }) => Promise<StateReading | null>;
     /** Optional async hook run BEFORE every snapshot (initial + each
      *  poll iteration). The CLI uses this to reconcile the workstream
      *  each tick (reaper flips IN_PROGRESS → OPEN for dead-pane
@@ -3199,6 +3278,8 @@ interface TaskWaitTaskState {
     name: string;
     /** Current status (at the moment we exit). */
     status: TaskStatus;
+    /** Current substate. A CLOSED ref that is not `done` has no deliverable. */
+    substate: TaskSubstate;
     /** Owner at exit time (NULL when unowned, after release, or after
      *  the reaper flipped IN_PROGRESS → OPEN due to a dead pane). */
     owner: string | null;
@@ -3252,6 +3333,9 @@ interface RenderTreeOptions {
 interface LoadFullDagOptions {
     /** Optional visible-status filter. Omitted = every task status. */
     statuses?: ReadonlySet<TaskStatus>;
+    /** Optional row predicate, applied after `statuses` (e.g. the TUI's
+     *  substate toggles). Omitted = keep every row. */
+    include?: (task: TaskRow) => boolean;
 }
 declare function loadFullDag(db: Db, workstream: string, opts?: LoadFullDagOptions): FullDag;
 /**
@@ -3390,6 +3474,9 @@ interface Track {
     taskIds: ReadonlySet<string>;
     /** Number of READY tasks (per the SQL view) within this track's subgraph. */
     readyCount: number;
+    /** True when every non-CLOSED task in the track is OPEN/parked: the
+     *  track holds work, but none of it is schedulable. */
+    parked: boolean;
 }
 /**
  * Identify independent task subtrees suitable for parallel assignment
@@ -3410,6 +3497,9 @@ interface WorkstreamSnapshot {
     inProgress: TaskRow[];
     blocked: TaskRow[];
     recentClosed: TaskRow[];
+    /** OPEN/parked tasks in the workstream. The ready card names them
+     *  when nothing is ready, since parked work is otherwise invisible there. */
+    parkedCount: number;
     /** Populated only when callers explicitly pass `withAllTasks: true`.
      *  The TUI dashboard fast tick leaves this empty and the all-tasks
      *  popup reads its exhaustive list directly from SQLite while open. */
@@ -3489,8 +3579,8 @@ declare function loadWorkstreamSnapshot(db: Db, workstream: string, opts?: LoadW
  */
 type RoiBucket = "high" | "mid" | "low" | "infinite";
 declare function roiBucket(impact: number, effortDays: number): RoiBucket;
-/** Histogram of agents by status. Pure derivation (no colour render). */
-declare function agentStatusHistogram(agents: readonly AgentRow[]): ReadonlyMap<AgentStatus, number>;
+/** Histogram of agents by runtime state. Pure derivation (no colour render). */
+declare function agentStateHistogram(agents: readonly LiveAgent[]): ReadonlyMap<RuntimeState, number>;
 interface OwnedTasksSummary {
     /** Display token: "—" (none), task id (one), or GLYPH.multi + count (many). */
     bit: string;
@@ -3535,7 +3625,7 @@ interface DoctorSummary {
  * snapshot-derived checks (ghosts / orphans / workspace-orphans) are
  * skipped in that case.
  */
-declare function loadDoctorSummary(db: Db, snapshot: WorkstreamSnapshot | null): DoctorSummary;
+declare function loadDoctorSummary(db: Db, snapshot: WorkstreamSnapshot | null, agentStateSource?: "murmur" | "herdr"): DoctorSummary;
 /** Count of warn + fail rows. Pure; exported for unit tests. */
 declare function countProblems(checks: readonly DoctorCheck[]): number;
 /**
@@ -3821,6 +3911,44 @@ declare function checkFleetHazards(db: Db, opts?: {
     syncDir?: string | undefined;
 }): FleetHazard[];
 
+declare const AGENT_STATE_GLYPH: Record<RuntimeState, string>;
+declare function agentStateGlyph(state: RuntimeState): string;
+/**
+ * Non-agent state glyphs, keyed by what they MEAN rather than what
+ * they look like. A call site asks for `GLYPH.stale`, never for a
+ * clock — so re-pointing the clock is a one-line edit here.
+ *
+ * `ok` / `fail` / `warn` deliberately reuse the same codepoints as the
+ * agent statuses they rhyme with (`free`, `terminated`): a check-circle
+ * means "fine" whether the row is an agent, a workspace or a doctor
+ * check.
+ */
+declare const GLYPH: {
+    /** Healthy, clean, passing, closed-successfully. */
+    readonly ok: "";
+    /** Failed check. */
+    readonly fail: "";
+    /** Needs attention but not broken (idle-but-assigned, stale warning). */
+    readonly warn: "";
+    /** Workspace has uncommitted edits. */
+    readonly dirty: "";
+    /** Workspace is ≥ WORKSPACE_STALE_THRESHOLD commits behind main. */
+    readonly stale: "";
+    /** Task is blocked by an incoming edge. */
+    readonly blocked: "";
+    /** Task is parked (OPEN/parked): open, but set aside on purpose. */
+    readonly parked: "";
+    /** Track whose roots merged (diamond dependency). */
+    readonly merge: "";
+    /** Agent owns more than one task (pane-title multi-count slot). */
+    readonly multi: "";
+    /** Filter toggle: enabled / disabled. */
+    readonly on: "";
+    readonly off: "";
+    /** Status outside the known enum. */
+    readonly unknown: "";
+};
+
 /** A parsed HLC. Never construct by hand — use `parseHlc` or `formatHlc`. */
 interface Hlc {
     /** Wall-clock hint, milliseconds since the epoch. */
@@ -3911,7 +4039,7 @@ declare function receiveHlc(db: Db, remoteHlc: string, now?: number): string;
 /** Every intent mu writes: the local ones (`emitEvent`, for changes no
  *  trigger can see) plus the capture-trigger ones (set via
  *  `withOpContext` around a portable-table mutation). */
-type CaptureIntent = "task.add" | "task.update" | "task.note" | "task.delete" | "task.close" | "task.open" | "task.reject" | "task.defer" | "task.claim" | "task.release" | "task.reap" | "task.block" | "task.unblock" | "task.reparent" | "workstream.init" | "workstream.teardown" | "workstream.destroy";
+type CaptureIntent = "task.add" | "task.update" | "task.note" | "task.delete" | "task.close" | "task.open" | "task.park" | "task.unpark" | "task.reject" | "task.defer" | "task.claim" | "task.release" | "task.reap" | "task.block" | "task.unblock" | "task.reparent" | "workstream.init" | "workstream.teardown" | "workstream.destroy";
 type KnownIntent = CaptureIntent | LocalIntent;
 /** A log row, reduced to what rendering needs. Structural so both
  *  `LogRow` (the SDK shape) and raw op rows satisfy it. */
@@ -4850,4 +4978,4 @@ declare function summarizeWorkstream(db: Db, opts: WorkstreamOptions): Promise<W
  */
 declare function teardownWorkstream(db: Db, opts: TeardownWorkstreamOptions): Promise<TeardownResult>;
 
-export { AGENT_STATUS_GLYPH, type AddNoteOptions, type AddTaskOptions, type AdoptAgentOptions, type AdoptAgentResult, AgentDiedOnSpawnError, AgentExistsError, AgentNotFoundError, AgentNotInWorkstreamError, type AgentRow, AgentSpawnCliNotFoundError, AgentSpawnStartupError, type AgentStatus, 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 CommandResolutionResult, type CommandResolver, CrossWorkstreamEdgeError, CycleError, DRIFT_REPORT_CAP, type Db, type DeleteTaskResult, type DetectedStatus, 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, type GroupSummary, type HazardSeverity, type Hlc, HlcOverflowError, HlcParseError, HomeDirAsProjectRootError, type IdFromTitleResult, type IngestFromDbResult, type IngestResult, type InsertAgentInput, type InverseOp, KNOWN_INTENTS, KNOWN_VERBS, type KickAgentOptions, type KickAgentResult, type KickProcessExecutor, type KickSignal, type KnownIntent, type ListLiveAgentsOptions, type ListLogsOptions, type ListNotesOptions, type ListReadyOptions, type ListTasksOptions, type LiveAgentsView, type LoadFullDagOptions, type LoadWorkstreamSnapshotOptions, type LocalIntent, type LogKind, type LogRow, MACHINE_LOCAL_ENTITIES, MACHINE_LOCAL_TABLES, MachineIdentityMissingError, type MachineLocalEntity, type MachineLocalLoss, type MachineLocalTable, type MuxBackend, type MuxBackendName, MuxError, type MuxPane, 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, type PeerSegment, type PeerStatus, type PortableTable, 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, SEGMENT_FORMAT_VERSION, STATUS_EMOJI, SYNCED_ENTITIES, SchemaTooOldError, type SegmentDefect, type SegmentDefectKind, type SegmentLine, type SegmentManifest, type SendOptions, type SendWarning, type SetStatusResult, type SlugifyResult, type SpawnAgentOptions, type SplitWindowOptions, type StrandedWorkspaceOrphan, type SyncPassResult, SyncPeerNotFoundError, SyncPeerRefAmbiguousError, SyncSourceNotFoundError, type SyncedEntity, TASK_STATUSES, TASK_STATUS_LIST, TaskAlreadyOwnedError, type TaskEdgeWithStatus, type TaskEdges, type TaskEdgesWithStatus, TaskExistsError, TaskNotFoundError, TaskNotInWorkstreamError, type TaskNoteRow, type TaskRow, type TaskStatus, type TaskWaitOptions, type TaskWaitRef, type TaskWaitResult, type TaskWaitTaskState, type TeardownResult, TmuxError, type TmuxExecResult, type TmuxExecutor, type TmuxPane, type TmuxSession, type TmuxWindow, type Track, UndoGroupNotFoundError, type UndoOptions, type UndoPlan, type UndoResult, UndoSupersededError, type UpdateTaskOptions, type UpdateTaskResult, type VcsBackend, type VcsBackendName, WORKSPACE_STALE_THRESHOLD, WorkspaceExistsError, type WorkspaceFailure, WorkspaceNotFoundError, type WorkspaceOrphan, WorkspacePathNotEmptyError, WorkspacePreservedError, type WorkspaceRow, type WorkspaceStaleness, WorkstreamExistsError, WorkstreamNameInvalidError, type WorkstreamOptions, type WorkstreamSnapshot, type WorkstreamSnapshotSlowFields, type WorkstreamSummary, activeMux, addBlockEdge, addNote, addTask, adoptAgent, agentStatusGlyph, agentStatusHistogram, 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, currentAgentName, currentOpContext, currentPaneTitle, decorateWithDirty, decorateWithStaleness, defaultDbPath, defaultSendDelayMs, defaultSendReadinessMs, defaultSpawnLivenessMs, defaultStateDir, deleteAgent, deleteTask, detectBackend, detectMux, detectPiStatus, discoverPeers, driftRemediation, emitEvent, ensureWorkstream, envVarNameForCli, extractTail, findCaseCollisions, flushSegment, foregroundPgid, formatDriftRecord, formatHlc, freeWorkspace, getAgent, getAgentByPane, getParallelTracks, getPrerequisites, getTask, getTaskEdges, getTaskEdgesWithStatus, getWaitPollCount, getWatermark, getWorkspaceForAgent, getWorkspaceStaleness, gitBackend, hasWorkMarker, idFromTitle, idFromTitleVerbose, ingestFromDb, ingestSegment, insertAgent, installCapture, isKickSignal, isPathInside, isTaskStatus, isValidAgentName, isValidPaneId, isValidTaskId, isValidWorkstreamName, isWorkspaceStale, jjBackend, kickAgent, killPane, killSession, latestSeq, 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, mergeSnapshotFastSlow, mostRecentGroup, mux, muxByName, newSession, newSessionWithPane, newWindow, nextHlc, noneBackend, opSubject, openDb, openTask, paneExists, paneTTY, parseAgentNameFromTitle, parseHlc, parseOpKey, parsePsTtyOutput, peerStatuses, planUndo, priorFieldValue, probeFilesystem, readAgent, 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, resolvePeerRef, roiBucket, segmentLineCount, segmentPath, selectLayout, sendToAgent, sendToPane, 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, updateAgentStatus, updateTask, verifyAgainstManifest, waitForTasks, withCaptureSuppressed, withFileLock, withOpContext, workspacePath, workspacesRoot, yankCommandForCheck };
+export { AGENT_STATE_GLYPH, type AddNoteOptions, type AddTaskOptions, type AdoptAgentOptions, type AdoptAgentResult, AgentDiedOnSpawnError, AgentExistsError, AgentNotFoundError, AgentNotInWorkstreamError, type AgentRow, 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, 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, type GroupSummary, 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, type ListLiveAgentsOptions, type ListLogsOptions, type ListNotesOptions, type ListReadyOptions, type ListTasksOptions, type LiveAgent, type LiveAgentsView, type LoadFullDagOptions, type LoadWorkstreamSnapshotOptions, type LocalIntent, type LogKind, type LogRow, MACHINE_LOCAL_ENTITIES, MACHINE_LOCAL_TABLES, 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, type ParkTaskOptions, type PeerSegment, type PeerStatus, type PortableTable, 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, SchemaTooOldError, type SegmentDefect, type SegmentDefectKind, type SegmentLine, type SegmentManifest, type SendOptions, type SendWarning, type SetStatusOptions, type SetStatusResult, type SlugifyResult, type SpawnAgentOptions, type SplitWindowOptions, 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, type TaskEdgeWithStatus, type TaskEdges, type TaskEdgesWithStatus, TaskExistsError, TaskNotFoundError, TaskNotInWorkstreamError, type TaskNoteRow, type TaskPair, TaskParkStateError, TaskParkedError, type TaskRow, type TaskStatus, type TaskSubstate, type TaskWaitOptions, type TaskWaitRef, type TaskWaitResult, type TaskWaitTaskState, type TeardownResult, TmuxError, type TmuxExecResult, type TmuxExecutor, type TmuxPane, type TmuxSession, type TmuxWindow, type Track, UNKNOWN_REASON, UndoGroupNotFoundError, type UndoOptions, type UndoPlan, type UndoResult, UndoSupersededError, type UpdateTaskOptions, type UpdateTaskResult, type VcsBackend, type VcsBackendName, WORKSPACE_STALE_THRESHOLD, WorkspaceExistsError, type WorkspaceFailure, WorkspaceNotFoundError, type WorkspaceOrphan, WorkspacePathNotEmptyError, WorkspacePreservedError, type WorkspaceRow, type WorkspaceStaleness, WorkstreamExistsError, WorkstreamNameInvalidError, type WorkstreamOptions, type WorkstreamSnapshot, type WorkstreamSnapshotSlowFields, type WorkstreamSummary, 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, currentAgentName, currentOpContext, currentPaneTitle, decorateWithDirty, decorateWithStaleness, defaultDbPath, defaultSendDelayMs, defaultSendReadinessMs, defaultSpawnLivenessMs, defaultStateDir, deleteAgent, deleteTask, detectBackend, detectMux, discoverPeers, driftRemediation, emitEvent, ensureWorkstream, envVarNameForCli, 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, installCapture, isKickSignal, isPathInside, isTaskStatus, isValidAgentName, isValidPair, isValidPaneId, isValidTaskId, isValidWorkstreamName, isWorkspaceStale, jjBackend, kickAgent, killPane, killSession, latestSeq, 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, 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 };