@mu-crew/mu 1.6.0 → 2.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
@@ -135,70 +166,10 @@ type PortableTable = (typeof PORTABLE_TABLES)[number];
 declare const MACHINE_LOCAL_TABLES: readonly ["agents", "machine_identity", "ops", "schema_version", "sync_peers", "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 +429,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 +530,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 +914,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 +1012,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 +1038,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 +1089,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 +1779,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 +1786,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 +1822,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 +1947,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`. */
@@ -3177,6 +3111,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
@@ -3489,8 +3429,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 +3475,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 +3761,42 @@ 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: "";
+    /** 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. */
@@ -4850,4 +4826,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 CommandResolutionResult, type CommandResolver, CrossWorkstreamEdgeError, CycleError, 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, 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 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 SetStatusResult, type SlugifyResult, type SpawnAgentOptions, type SplitWindowOptions, type StateReading, type StateSource, 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, 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, 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, murmurAvailable, mux, muxByName, newSession, newSessionWithPane, newWindow, nextHlc, noneBackend, opSubject, openDb, openTask, paneExists, paneTTY, 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, 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, updateTask, verifyAgainstManifest, waitForTasks, withCaptureSuppressed, withFileLock, withOpContext, workspacePath, workspacesRoot, yankCommandForCheck };