@mu-crew/mu 3.9.0 → 3.10.0

package/dist/index.d.ts

@@ -84,6 +84,12 @@ interface HasNextSteps {
     errorNextSteps(): NextStep[];
 }
 
+/**
+ * Resolve the canonical mu state directory:
+ *   MU_STATE_DIR > $XDG_STATE_HOME/mu (absolute only) > ~/.local/state/mu
+ */
+declare function defaultStateDir(): string;
+
 type Db = Database;
 interface OpenDbOptions {
     /**
@@ -98,11 +104,6 @@ interface OpenDbOptions {
      */
     readonly?: boolean;
 }
-/**
- * Resolve the canonical mu state directory:
- *   MU_STATE_DIR > $XDG_STATE_HOME/mu (absolute only) > ~/.local/state/mu
- */
-declare function defaultStateDir(): string;
 /**
  * Resolve the canonical DB path:
  *   MU_DB_PATH > <state-dir>/mu.db
@@ -110,7 +111,8 @@ declare function defaultStateDir(): string;
 declare function defaultDbPath(): string;
 /**
  * Open the mu database. Creates the parent directory and applies the schema
- * idempotently on every open. Safe to call from many short-lived processes
+ * idempotently when it is missing or differs from this build (an
+ * up-to-date DB opens without a write). Safe to call from many short-lived processes
  * concurrently — WAL mode handles cross-process writes.
  */
 declare function openDb(options?: OpenDbOptions): Db;
@@ -150,7 +152,8 @@ 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 11 entries in v11. */
+ *  CURRENT_SCHEMA_VERSION bump (sync_fingerprints went in without one:
+ *  additive, and an older mu ignores it). Sorted; exactly 12 entries. */
 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
@@ -194,6 +197,7 @@ type PortableTable = (typeof PORTABLE_TABLES)[number];
  *    machine_identity IS the per-machine identity.
  *    schema_version   local bookkeeping.
  *    sync_peers       local bookkeeping (per-peer watermarks).
+ *    sync_fingerprints local cache of what the last clean ingest saw.
  *    task_substates   seeded identically on every machine from
  *                     TASK_SUBSTATE_ROWS; code, not data.
  *    ops              see below — the carrier, not cargo.
@@ -210,7 +214,7 @@ 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", "task_substates", "vcs_workspaces"];
+declare const MACHINE_LOCAL_TABLES: readonly ["agents", "machine_identity", "ops", "schema_version", "sync_fingerprints", "sync_peers", "task_substates", "vcs_workspaces"];
 type MachineLocalTable = (typeof MACHINE_LOCAL_TABLES)[number];
 
 /** The multiplexers mu can drive. */
@@ -1357,8 +1361,13 @@ interface VcsBackend {
      *    missing refs, the `none` backend which has no notion of "main")
      *
      * Callers treat null as "unknown — render — — and don't warn".
+     *
+     * `mainRefCache`, when given, is shared across the rows of one
+     * decorate call so a backend that must resolve "main" per repo (git's
+     * origin/HEAD probe) does it once per repo, not once per workspace.
+     * Backends that resolve main inside the count command ignore it.
      */
-    commitsBehind(workspacePath: string, ref: string): Promise<number | null>;
+    commitsBehind(workspacePath: string, ref: string, mainRefCache?: Map<string, Promise<string | undefined>>): Promise<number | null>;
     /**
      * Rebase the workspace onto `fromRef` (or the backend's tracked
      * base when undefined: `origin/HEAD` for git, `trunk()` for jj/sl).
@@ -1565,6 +1574,9 @@ interface SpawnAgentOptions {
     /** Run the control-socket handshake for pi agents (default true).
      *  `false` skips it and reports `ctl: "skipped"`. */
     ctl?: boolean;
+    /** When `name` is taken in the workstream, take the next free one
+     *  (see `nextFreeAgentName`) instead of failing with AgentExistsError. */
+    nextFree?: boolean;
 }
 /** Outcome of the spawn-time control-socket handshake. */
 type SpawnCtl = "ok" | "missing" | "refused" | "skipped";
@@ -1717,6 +1729,13 @@ declare class AgentExistsError extends Error implements HasNextSteps {
     constructor(agentName: string);
     errorNextSteps(): NextStep[];
 }
+/** `spawn --next-free` found no free valid name near the asked one. */
+declare class AgentNameExhaustedError extends Error implements HasNextSteps {
+    readonly agentName: string;
+    readonly name = "AgentNameExhaustedError";
+    constructor(agentName: string, reason: string);
+    errorNextSteps(): NextStep[];
+}
 declare class AgentNotFoundError extends Error implements HasNextSteps {
     readonly agentName: string;
     /** Optional workstream context. When set, the message is enriched
@@ -2179,8 +2198,11 @@ declare function listAgents(db: Db, opts?: {
 declare function composeAgentTitle(db: Db, agent: AgentRow): string;
 /** Push a fresh pane title for `agentName`. Best-effort — a missing
  *  agent, a placeholder pane id, or a tmux failure are all swallowed
- *  silently (titles are decorative; never block the calling verb). */
-declare function refreshAgentTitle(db: Db, agentName: string, workstream: string): Promise<void>;
+ *  silently (titles are decorative; never block the calling verb).
+ *  `currentTitle` is the pane's live title when the caller already read
+ *  it (reconcile); the write is skipped when it equals the new title,
+ *  since each retitle is a mux server write plus a status redraw. */
+declare function refreshAgentTitle(db: Db, agentName: string, workstream: string, currentTitle?: string): Promise<void>;
 /**
  * Delete an agent row. Returns true if a row was matched. Idempotent;
  * deleting an agent that doesn't exist returns false without throwing.
@@ -4279,8 +4301,9 @@ interface CheapDriftReport {
 /**
  * Every live row must have at least one op naming its natural key.
  *
- * ~1ms on a 200-task DB: four indexed NOT EXISTS scans, no rebuild, no
- * temp file. Cheap enough to run on every `mu doctor`.
+ * Four indexed NOT EXISTS scans, no rebuild, no temp file: ~10 ms on a
+ * 2.3k-task, 10.7k-note, 67k-op DB. Cheap enough to run on every `mu
+ * doctor` and the TUI slow tick.
  *
  * WHAT IT CATCHES: a row that exists with no history — an uncaptured
  * INSERT, or a mutation path that bypassed the triggers entirely.
@@ -4338,11 +4361,15 @@ declare class DriftDetectedError extends Error implements HasNextSteps {
 
 /** Sub-directory of the state dir holding lock directories. */
 declare function locksDir(): string;
-interface FileLockOptions {
+interface FileLockOptions<T = unknown> {
     acquireTimeoutMs?: number;
     staleLockMs?: number;
     /** Env var consulted for the acquire timeout, if any. */
     timeoutEnvVar?: string;
+    /** Run instead of `fn` when the lock cannot be taken (contended past
+     *  the deadline, or the lock dir cannot be created). Absent, `fn` runs
+     *  unlocked. */
+    onUnavailable?: () => T;
 }
 /**
  * Run `fn` while holding the lock directory at `lockPath`.
@@ -4351,7 +4378,7 @@ interface FileLockOptions {
  * Records pid + acquisition time in `meta.json` for stale-lock
  * diagnostics.
  */
-declare function withFileLock<T>(lockPath: string, label: string, fn: () => Promise<T>, opts?: FileLockOptions): Promise<T>;
+declare function withFileLock<T>(lockPath: string, label: string, fn: () => Promise<T>, opts?: FileLockOptions<T>): Promise<T>;
 /** Read a held lock's metadata, or null. Exposed for tests. */
 declare function readFileLockMeta(lockPath: string): Promise<{
     pid: number;
@@ -4827,6 +4854,39 @@ interface RebuildOptions {
  */
 declare function rebuildInto(source: Db, opts: RebuildOptions): RebuildReport;
 
+/** Serialisable running state: eight hash words (hex), bytes hashed so
+ *  far, and the partial trailing block not yet compressed (base64). */
+interface Sha256State {
+    h: string;
+    n: number;
+    tail: string;
+}
+
+/** Whole-file verification sidecar. */
+interface SegmentManifest {
+    v: number;
+    machine: string;
+    count: number;
+    lastHlc: string | null;
+    sha256: string;
+    updatedAt: string;
+    /** Bytes of the segment `sha256` covers. Written by the owner so its
+     *  next flush can trust this manifest instead of rescanning; absent in
+     *  manifests from older builds. */
+    size?: number;
+    /** The segment's mtime when this manifest was written (owner-local). */
+    mtimeMs?: number;
+    /** Running hash state after `size` bytes, so an append rehashes only
+     *  what it added. */
+    shaState?: Sha256State;
+    /** sha256 over the fields above (`manifestSeal`). The owner trusts
+     *  count/size/shaState only when it matches, so a torn or hand-edited
+     *  manifest falls back to the full scan instead of being persisted. */
+    seal?: string;
+}
+/** Read a segment's manifest, or null when absent/unparsable. */
+declare function readManifest(segment: string): SegmentManifest | null;
+
 /** Current segment line format. Bumped only on a breaking shape change;
  *  a reader that sees a version it does not know REFUSES the line rather
  *  than guessing at its meaning. */
@@ -4845,15 +4905,6 @@ interface SegmentLine {
     payload: unknown;
     crc: string;
 }
-/** Whole-file verification sidecar. */
-interface SegmentManifest {
-    v: number;
-    machine: string;
-    count: number;
-    lastHlc: string | null;
-    sha256: string;
-    updatedAt: string;
-}
 /** Why a segment line was rejected. Reported, never silently swallowed. */
 type SegmentDefectKind = "torn-write" | "manifest-mismatch" | "crc-mismatch" | "non-monotonic-hlc" | "unknown-version" | "malformed-shape" | "entity-not-synced" | "duplicate-op";
 interface SegmentDefect {
@@ -4882,7 +4933,10 @@ interface FlushResult {
     appended: number;
     /** Total lines in the segment afterwards. */
     total: number;
-    /** Ops skipped because their entity is machine-local. */
+    /** Ops skipped because their entity is machine-local. A full scan
+     *  (`verify`, or an untrusted manifest) counts every unflushed one; the
+     *  fast path counts only those up to the last op it appended, so a
+     *  no-op ambient flush reports 0 (see `pendingLines`). */
     skippedLocal: number;
     /**
      * Non-null when THIS MACHINE'S OWN segment was found defective past
@@ -4898,34 +4952,22 @@ interface FlushResult {
      * to be (`mu sync`, `ambientFlush`).
      */
     selfRepaired: SegmentDefect | null;
+    /**
+     * True when ops were pending but another process held the segment
+     * lock past the wait, so this call wrote nothing. The ops stay
+     * unflushed in `ops` (the segment's last hlc is the watermark), and
+     * the next flush appends them. Never set on a successful flush.
+     */
+    lockBusy?: boolean;
 }
-/**
- * Append this machine's not-yet-flushed ops to its own segment.
- *
- * FILTERING IS LOAD-BEARING. Only ops whose entity is in
- * `SYNCED_ENTITIES` are written. Machine-local ops (agent.*, workspace.*)
- * are captured and DO appear in `mu log`, but they must never reach a
- * segment: they carry pane ids and absolute paths that are meaningless,
- * and frequently wrong, on another machine. "Not synced" is not "not
- * logged".
- *
- * Also filters `machine_id = <me>`: a segment holds ONE machine's ops.
- * Ops ingested from a peer live in our `ops` table too, and re-flushing
- * them into our own segment would duplicate a peer's history under our
- * name — and would grow without bound as two machines echoed each other.
- *
- * The high-water mark is the last hlc already in the file (read from the
- * manifest when present, else derived by scanning), so flush is
- * incremental and idempotent: calling it twice appends nothing the second
- * time.
- */
-declare function flushSegment(db: Db, dir?: string | null): Promise<FlushResult>;
+declare function flushSegment(db: Db, dir?: string | null, opts?: {
+    verify?: boolean;
+    lockWaitMs?: number;
+}): Promise<FlushResult>;
 /** Number of GOOD lines in a segment (stopping at the first defect, as
  *  ingest does). The denominator of "how far behind am I" — exported for
  *  `mu sync`'s peer table. */
 declare function segmentLineCount(path: string): number;
-/** Read a segment's manifest, or null when absent/unparsable. */
-declare function readManifest(segment: string): SegmentManifest | null;
 /**
  * Verify a segment against its manifest (layer 4).
  *
@@ -4984,7 +5026,14 @@ declare function discoverPeers(dir: string, selfMachineId: string): PeerSegment[
  * nothing here).
  */
 declare function getWatermark(db: Db, watermarkKey: string): number;
-declare function setWatermark(db: Db, watermarkKey: string, value: number): void;
+/**
+ * Store a watermark and stamp `last_seen_at` with the ISO time. The
+ * segment fingerprint goes to `sync_fingerprints` when the caller just
+ * read the file cleanly to its end (`segmentCaughtUp`). Every other
+ * write deletes it, so a reset or partial ingest never vouches for the
+ * file.
+ */
+declare function setWatermark(db: Db, watermarkKey: string, value: number, fingerprint?: string | null): void;
 /** Reset a peer's watermark so the next ingest re-reads from zero. The
  *  universal repair, safe because ingest is idempotent. */
 declare function resetWatermark(db: Db, watermarkKey: string): void;
@@ -5042,7 +5091,9 @@ interface IngestResult {
  * which is what makes "laptop edits after seeing the devserver's op" order
  * correctly rather than losing to it.
  */
-declare function ingestSegment(db: Db, peer: PeerSegment): IngestResult;
+declare function ingestSegment(db: Db, peer: PeerSegment, opts?: {
+    verify?: boolean;
+}): IngestResult;
 /**
  * Apply ONE incoming op and record it in the local `ops` table.
  *
@@ -5197,8 +5248,12 @@ declare function ambientIngest(db: Db, opts?: AmbientOptions): Promise<AmbientRe
  * laptop followed by `mu sync` on the devserver would show nothing —
  * exactly the no-hands claim, broken.
  *
- * Runs under the cross-process file lock inside `flushSegment`, so two
- * concurrent mu processes cannot interleave partial lines.
+ * Appends under the cross-process file lock inside `flushSegment`, so
+ * two concurrent mu processes cannot interleave partial lines. A flush
+ * with nothing to append skips the lock, so read-only verbs never queue.
+ * A flush that cannot take the lock within AMBIENT_FLUSH_LOCK_WAIT_MS
+ * writes nothing (`lockBusy`) and the verb carries on silently: its ops
+ * stay pending in `ops` and the next invocation's flush appends them.
  */
 declare function ambientFlush(db: Db, opts?: AmbientOptions): Promise<FlushResult | null>;
 /**
@@ -5635,4 +5690,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, AgentNotFoundError, AgentNotInWorkstreamError, 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, AgentExistsError, AgentExtensionOutdatedError, AgentFreshNeedsCtlError, AgentNameExhaustedError, AgentNotFoundError, AgentNotInWorkstreamError, 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 };