cyberlegion 0.0.1 → 0.2.0

package/dist/index.d.mts

@@ -1,3 +1,6 @@
+import { Exec, Exec as Exec$1, MuxAdapter, MuxPlacement, MuxProbe, probeMultiplexer } from "cyber-mux";
+import { assertDistinctFromPrimary, gitWorktreeAdapter, resolvePrimaryRoot } from "cyber-mux/worktree";
+
 //#region src/store/store.d.ts
 interface Message {
   id: string;
@@ -16,14 +19,18 @@ type AgentStatus = 'spawning' | 'active' | 'idle' | 'stale' | 'exited' | 'paused
 interface AgentRecord {
   id: string;
   handle: string;
-  harness: Harness;
+  /** Absent for a standing record (a human/owner principal — no claude/cursor/codex harness). */
+  harness?: Harness;
   cwd: string;
   worktree?: {
     root: string;
     branch?: string;
   } | null;
-  tmux?: {
-    pane: string;
+  /** Where this session lives, tagged with its multiplexer so `prune` runs the right liveness check.
+   * `null` for a session in no pane and for a standing record. `window`/`session` are tmux-only. */
+  pane?: {
+    mux: 'tmux' | 'herdr';
+    id: string;
     window?: string;
     session?: string;
   } | null;
@@ -33,12 +40,21 @@ interface AgentRecord {
   lastSeen: string;
   brief?: string;
   spawnedBy?: string;
+  /** Absent ⇒ session (backward compat, no migration). 'standing' = a session-independent,
+   * prune-exempt owner inbox minted by `unit register --standing`. */
+  kind?: 'session' | 'standing';
+  /** Only meaningful on a `kind: 'standing'` record — the id of the unit currently standing in for
+   * it (`unit claim`), a per-record singleton pointer that moves as the principal moves between
+   * units (last claim wins). Resolved live, never trusted: a presence unit that has exited reads as
+   * no presence bound, same as if none were ever claimed — nothing self-heals a stale pointer, it
+   * stays inert until re-claimed. Independent of the hub's `mainPane` (the human's read-pane). */
+  presence?: string;
 }
 interface InboxSnapshot {
   unread: Message[];
   read: Message[];
 }
-/** The seam all mailbox + registry + brief/result access goes through. */
+/** The seam all mailbox + registry + brief access goes through. */
 interface Store {
   /** This store's root (for path-relative concerns the Store itself doesn't cover, e.g. spawning
    * a worktree under a project-local root distinct from this hub). */
@@ -67,22 +83,19 @@ interface Store {
   removePaneIndex(pane: string): void;
   writeBrief(agentId: string, text: string): void;
   readBrief(agentId: string): string | undefined;
-  /** Path this dispatch's result file would live at (computed only — no IO; existence not implied). */
-  resultPath(id: string): string;
-  /** Write a dispatch's result as JSON text. */
-  writeResult(id: string, value: unknown): void;
-  /** Read a dispatch's result JSON text, or undefined if not yet written. */
-  readResult(id: string): string | undefined;
+  /** Set (or move) the hub's single main pane — the standing owner's live presence — or clear it
+   * (`null`, a no-op when already unbound). A hub-level singleton, independent of any agent record. */
+  setMainPane(pane: string | null): void;
+  /** The hub's currently bound main pane, or undefined when none is bound. */
+  getMainPane(): string | undefined;
 }
 //#endregion
 //#region src/identity.d.ts
-/** Runs a command synchronously; returns trimmed stdout, or null on any failure. */
-type Exec = (cmd: string, args: string[]) => string | null;
-declare const realExec: Exec;
+declare const realExec: Exec$1;
 interface IdContext {
   store: Store;
   env?: NodeJS.ProcessEnv;
-  exec?: Exec;
+  exec?: Exec$1;
   now?: () => number;
 }
 declare function loadAgent(store: Store, id: string): AgentRecord | undefined;
@@ -90,10 +103,11 @@ declare function listAgents(store: Store): AgentRecord[];
 /** Detect the harness: explicit wins, then env probes, then the tmux pane command. */
 declare function detectHarness(explicit: string | undefined, ctx: IdContext): Harness | undefined;
 /**
- * Recover the calling agent's own id. In tmux the pane index is authoritative — a pane with no
- * pane entry is simply unregistered and must NOT adopt `$CYBERLEGION_AGENT_ID` (that env fallback
- * applies only when there is no `$TMUX_PANE`). There is no shared bare "self" file — self-id is
- * always pane-keyed or explicit via the env var.
+ * Recover the calling agent's own id, mux-agnostically. Inside any multiplexer pane (tmux or herdr)
+ * the pane index is authoritative — a pane with no pane entry is simply unregistered and must NOT
+ * adopt `$CYBERLEGION_AGENT_ID` (that env fallback applies ONLY when the session is in no
+ * multiplexer pane at all). There is no shared bare "self" file — self-id is always pane-keyed or
+ * explicit via the env var.
  */
 declare function resolveSelfId(ctx: IdContext): string | undefined;
 interface RegisterInput {
@@ -102,7 +116,8 @@ interface RegisterInput {
 }
 /** Register (or idempotently refresh) this session's identity. */
 declare function register(ctx: IdContext, input: RegisterInput): AgentRecord;
-/** Resolve a recipient argument (id or handle) to an agent id. */
+/** Resolve a recipient argument (id or handle) to an agent id. A handle resolves to live units
+ * only — mail addressed to an exited unit lands in an inbox nobody reads. */
 declare function resolveRecipient(store: Store, to: string): string;
 /**
  * Resolve a unit reference by id, handle, or its worktree branch (the unit↔CR join key: an
@@ -113,7 +128,9 @@ declare function resolveAgent(store: Store, ref: string): AgentRecord;
 declare function bumpLastSeen(ctx: IdContext, id: string): void;
 /** Refresh this session's own last-seen if it is registered — best-effort, never throws. */
 declare function touch(ctx: IdContext): void;
-/** Mark agents whose pane is gone or whose last-seen is stale as exited. */
+/** Mark agents whose pane is gone or whose last-seen is stale as exited. Reconcile-culls against the
+ * current mux's live set first, then falls through to the per-record paneExists + staleness check
+ * (covers the other mux and sessions outside any multiplexer pane). */
 declare function prune(ctx: IdContext): AgentRecord[];
 //#endregion
 //#region src/agentdef/resolve.d.ts
@@ -164,118 +181,6 @@ interface RealizedLaunch {
  * `--model` when known, `--append-system-prompt` carrying the def's instructions body) since the
  * exact per-harness flag surface is realized later by the launching caller, not by cyberlegion. */
 declare function realizeLaunch(def: AgentDef, opts?: RealizeLaunchOptions): RealizedLaunch;
-interface RealizeSubagentOptions {
-  /** File the spawned subagent reads its brief from. */
-  briefFile: string;
-  /** File the spawned subagent writes its result JSON to. */
-  resultFile: string;
-}
-/** Build the instruction string a parent model uses to spawn its OWN harness Task subagent for
- * `def` — cyberlegion never invokes the Task tool itself. Names `subagent_type: <def.name>` for a
- * harness that recognizes it, but always inlines the model + full instructions too so the same
- * instruction string is correct even when the harness has no such named subagent type. */
-declare function realizeSubagentInstruction(def: AgentDef, opts: RealizeSubagentOptions): string;
-//#endregion
-//#region src/console/session.d.ts
-/** Generic multiplexer seam — no legion-specific concepts, so this composes with any host. */
-/** Where a new pane/window/session should be placed relative to the caller's current one. */
-type SessionPlacement = 'pane:right' | 'pane:down' | 'tab' | 'window';
-interface SessionOpenOptions {
-  /** Working directory the new pane/window/session should start in. */
-  cwd: string;
-  /** Command line to launch inside the new pane once it is open. */
-  launch: string;
-  /** Placement relative to the caller; defaults to 'pane:right'. */
-  at?: SessionPlacement;
-}
-/** Opaque handle to an open pane/window/session; backend-specific id lives in `id`. */
-interface SessionTarget {
-  id: string;
-}
-interface SessionReadOptions {
-  /** How many trailing lines of output to capture; omit for the backend's default. */
-  lines?: number;
-}
-interface SessionAdapter {
-  /** Backend name, e.g. "tmux" or "herdr". */
-  readonly name: string;
-  /** Create a new pane/window running `opts.launch` in `opts.cwd`; returns its target handle. */
-  open(exec: Exec, opts: SessionOpenOptions): SessionTarget;
-  /** Type text into the target session (submitted, not queued). */
-  send(exec: Exec, target: SessionTarget, text: string): void;
-  /** Capture the target session's current output. */
-  read(exec: Exec, target: SessionTarget, opts?: SessionReadOptions): string;
-  /** Move input focus to the target session; best-effort (may no-op if the backend can't). */
-  focus(exec: Exec, target: SessionTarget): void;
-  /** Close the target session. */
-  teardown(exec: Exec, target: SessionTarget): void;
-}
-//#endregion
-//#region src/console/index.d.ts
-/**
- * Backend selection via the two-mode mux probe (`$CYBERLEGION_MUX` fast-path/override, else
- * ancestry discovery from `$$` falling back to the `$TMUX`/`$HERDR_ENV` hint when the walk is
- * inconclusive) — tmux/herdr map to their existing adapters; anything else is a clear error.
- */
-declare function selectSessionAdapter(env: NodeJS.ProcessEnv, exec?: Exec): SessionAdapter;
-//#endregion
-//#region src/console/mux-probe.d.ts
-type Mux = 'tmux' | 'herdr' | 'screen' | 'none';
-interface MuxProbe {
-  mux: Mux;
-  pane?: string;
-  /** 'env' — trusted the $CYBERLEGION_MUX fast-path/override. 'ancestry' — walked the process tree. */
-  via: 'env' | 'ancestry';
-}
-/**
- * Two-mode multiplexer detection.
- *
- * Fast-path: `$CYBERLEGION_MUX` (tmux | herdr | screen | none) is trusted outright — this also
- * serves as an OVERRIDE (`=none` forces no-mux even inside a real multiplexer). `$CYBERLEGION_MUX_PANE`
- * carries the pane id alongside it.
- *
- * Discovery (else): walk the process ancestry from `$$` via `ps -o ppid=,comm= -p <pid>`, since the
- * tool's own shell may not be the human's pane. `$TMUX`/`$HERDR_ENV` are NOT trusted alone — they
- * are used only as a fast-positive hint the ancestry walk falls back to when the walk itself is
- * inconclusive (e.g. `ps` unavailable), never as a substitute for it.
- */
-declare function probeMultiplexer(exec: Exec, env: NodeJS.ProcessEnv, opts?: {
-  discover?: boolean;
-}): MuxProbe;
-//#endregion
-//#region src/console/worktree.d.ts
-/** Generic multiplexer/worktree seam — no legion-specific concepts. */
-interface WorktreeAddOptions {
-  /** The primary checkout's root — the repo `git worktree add` runs against. */
-  primaryRoot: string;
-  /** Where the new worktree should be checked out. */
-  path: string;
-  /** Branch to create the worktree on. */
-  branch: string;
-}
-interface Worktree {
-  root: string;
-  branch: string;
-}
-interface WorktreeRemoveOptions {
-  primaryRoot: string;
-}
-interface WorktreeAdapter {
-  add(exec: Exec, opts: WorktreeAddOptions): Worktree;
-  remove(exec: Exec, path: string, opts: WorktreeRemoveOptions): void;
-}
-/** The only worktree backend at MVP — plain `git worktree`. */
-declare const gitWorktreeAdapter: WorktreeAdapter;
-/**
- * Resolve the primary checkout's root regardless of whether the caller's cwd is the primary
- * checkout or a linked worktree — `--git-common-dir` always points at the main repo's `.git`.
- */
-declare function resolvePrimaryRoot(exec: Exec): string;
-/**
- * Refuse the primary checkout: a spawned unit's resolved worktree root must never be the primary
- * checkout itself. A unit is never run in the primary checkout.
- */
-declare function assertDistinctFromPrimary(worktreeRoot: string, primaryRoot: string): void;
 //#endregion
 //#region src/decommission.d.ts
 interface DecommissionInput {
@@ -297,78 +202,6 @@ interface DecommissionResult {
  */
 declare function decommission(ctx: IdContext, input: DecommissionInput): DecommissionResult;
 //#endregion
-//#region src/dispatch/prep.d.ts
-interface DispatchContext {
-  store: Store;
-}
-interface PrepInput {
-  /** Resolve an agent def (`.agents/agents/<name>.md`) to build the instruction from. */
-  agent?: string;
-  /** Read an exact agent def file instead of resolving by name (plugin-scoped escape hatch). */
-  agentFile?: string;
-  /** Role label folded into the generic instruction when no agent def is given. */
-  role?: string;
-  /** Brief body text. */
-  briefText?: string;
-  /** Read the brief from a file, or `-` for stdin. */
-  briefFile?: string;
-  /** JSON schema file the eventual result must satisfy — carried through by callers that validate. */
-  verdictSchema?: string;
-  /** Thread id correlating a channel-path reply; defaults to the minted dispatch id. */
-  thread?: string;
-}
-interface DispatchEnvelope {
-  id: string;
-  thread: string;
-  briefFile: string;
-  resultFile: string;
-  instruction: string;
-}
-/**
- * Allocate a dispatch: mint an id (thread defaults to it), write the brief into the Store, compute
- * the result-slot path, and build the instruction from a resolved agent def (or a generic one).
- * Spawns nothing — the envelope is handed to whatever spawns next (a Task tool, `channel()`, a
- * human).
- */
-declare function prep(ctx: DispatchContext, input: PrepInput, readStdin?: () => string): DispatchEnvelope;
-//#endregion
-//#region src/dispatch/channel.d.ts
-interface ChannelInput extends PrepInput {
-  /** Block for the mail-thread reply and return a validated `DispatchResult`; without it, the peer
-   * is spawned and the envelope is returned so the caller can `mail await` later. */
-  wait?: boolean;
-  /** Placement relative to the caller; defaults to 'pane:right'. */
-  at?: SessionPlacement;
-  timeoutMs?: number;
-  maxWaitS?: number;
-}
-interface DispatchResult {
-  id: string;
-  verdict?: unknown;
-  body: string;
-  ts: number;
-}
-/** Thrown by a `--wait` channel call when its internal poll-cycle cap is hit with no reply yet — a
- * clean, re-armable sentinel (mirrors `mail await`'s "waiting" outcome), never a failure. */
-declare class DispatchWaitingError extends Error {
-  readonly thread: string;
-  constructor(thread: string);
-}
-/**
- * `prep()` + spawn a peer session realized from the same agent def + (optionally) `awaitReply` on
- * the thread. Requires `--agent`/`--agent-file` (a channel peer needs a real launch to realize).
- */
-declare function channel(ctx: IdContext, input: ChannelInput, readStdin?: () => string): Promise<DispatchResult | DispatchEnvelope>;
-//#endregion
-//#region src/dispatch/collect.d.ts
-interface CollectContext {
-  store: Store;
-  now?: () => number;
-}
-/** Read + validate a dispatch's result file. Throws (fail-loud) when the file is not yet written,
- * or when it fails the optional verdict schema. */
-declare function collect(ctx: CollectContext, id: string, verdictSchema?: string): DispatchResult;
-//#endregion
 //#region src/runtime/inject-inbox.d.ts
 type HookEvent = 'SessionStart' | 'PostToolUse';
 interface InjectPayload {
@@ -394,7 +227,7 @@ interface InstallResult {
   status: InstallStatus;
 }
 /** Register the surfacing hook into one harness's config, idempotently. */
-declare function install(harness: Harness, projectDir?: string): InstallResult[];
+declare function install(harness: Harness, projectDir?: string, pin?: string): InstallResult[];
 //#endregion
 //#region src/message.d.ts
 interface MsgContext {
@@ -432,6 +265,21 @@ declare function ack(ctx: MsgContext, meId: string, msgId: string): Message;
 /** Permanently remove a message (unread or already-acked) from the caller's inbox. */
 declare function deleteMessage(ctx: MsgContext, meId: string, msgId: string): void;
 //#endregion
+//#region src/mux-select.d.ts
+/**
+ * Backend selection via cyber-mux's two-mode mux probe, normalized through the transitional
+ * `$CYBERLEGION_MUX*` → `$CYBER_MUX*` env seam (`mux-env.ts`) — tmux/herdr map to their existing
+ * cyber-mux adapters.
+ *
+ * cyber-mux detects MORE backends than `unit/registry`'s `AgentRecord.pane` can carry a locator
+ * under (`'tmux' | 'herdr'` only). A DETECTED wezterm/zellij is refused HERE, before anything opens,
+ * naming the backend it found (mux.feature: "a detected backend a unit record cannot carry is
+ * refused before opening anything") — driving it would open a real pane no record could name,
+ * stranding a live session `prune` can never reap and no caller can nudge. Anything else (`none`,
+ * `screen`) falls through to the plain "no backend" refusal, unchanged from before the migration.
+ */
+declare function selectSessionAdapter(env: NodeJS.ProcessEnv, exec?: Exec): MuxAdapter;
+//#endregion
 //#region src/output.d.ts
 type Format = 'toon' | 'json';
 /** One TOON-encoded object: `key: value` lines, blank/undefined fields dropped. */
@@ -459,13 +307,13 @@ declare function fail(msg: string): never;
 /** Walk up from `cwd` to the nearest git repo root; fall back to `cwd`. */
 declare function projectRoot(cwd?: string): string;
 /** Runs a command synchronously in `cwd`; returns trimmed stdout, or null on any failure. */
-type Exec$1 = (cmd: string, args: string[]) => string | null;
+type Exec$2 = (cmd: string, args: string[]) => string | null;
 interface RootOptions {
   root?: string;
   space?: string;
   cwd?: string;
   env?: NodeJS.ProcessEnv;
-  exec?: Exec$1;
+  exec?: Exec$2;
 }
 /**
  * Resolve the cyberlegion hub root. Precedence: explicit --root/--space, then `$CYBERLEGION_ROOT`,
@@ -475,9 +323,10 @@ interface RootOptions {
  */
 declare function resolveRoot(opts?: RootOptions): string;
 /**
- * Resolve the primary checkout's project-local cyberlegion dir — where spawned unit worktrees
- * live (never the global hub), keyed off `git worktree`'s common-dir so it resolves the same from
- * the primary checkout or from any of its linked worktrees.
+ * Resolve the primary checkout's project-local cyberlegion dir — the tracked marker for a
+ * legion-enabled project (never the global hub, and never where spawned unit worktrees themselves
+ * are checked out — see `resolveUnitWorktreePath`), keyed off `git worktree`'s common-dir so it
+ * resolves the same from the primary checkout or from any of its linked worktrees.
  */
 declare function resolveProjectLocalRoot(opts?: RootOptions): string;
 /**
@@ -495,8 +344,7 @@ declare const paths: {
   inboxReadDir: (root: string, id: string) => string;
   dataDir: (root: string, id: string) => string;
   briefFile: (root: string, id: string) => string;
-  resultFile: (root: string, id: string) => string;
-  worktreeDir: (root: string, id: string) => string;
+  mainPaneFile: (root: string) => string;
 };
 //#endregion
 //#region src/session.d.ts
@@ -512,10 +360,15 @@ interface SpawnInput {
   command?: string;
   /** Branch to create the unit's worktree on; defaults to `cyberlegion/unit-<id>`. */
   branch?: string;
-  /** Where to check out the unit's worktree; defaults under `<primary>/.agents/cyberlegion/worktrees/<id>`. */
+  /** Where to check out the unit's worktree; defaults to a sibling of the primary checkout
+   * (`<parent>/<repo>.worktrees/legion-<id6>`, `id6` the same 6-char slice `handle` defaults to)
+   * — never nested inside the primary's own tree. */
   worktreePath?: string;
-  /** Placement relative to the caller; defaults to 'pane:right'. */
-  at?: SessionPlacement;
+  /** Spawn into this existing directory instead — creates no worktree. Mutually exclusive with
+   * `branch`/`worktreePath` (those create a worktree; this reuses one). */
+  cwd?: string;
+  /** Placement relative to the caller; defaults to 'tab'. */
+  at?: MuxPlacement;
 }
 interface SpawnResult {
   agent: AgentRecord;
@@ -528,9 +381,10 @@ interface SpawnResult {
  * its cwd set to that worktree, pre-register the peer, and drop its brief as a file the peer's own
  * SessionStart hook reads — never typed into its prompt.
  *
- * Spawned unit worktrees live project-local (`<primary>/.agents/cyberlegion/worktrees/<id>`), even
- * though the registry/mailbox itself lives in the global hub — the hub addresses units across
- * project and worktree boundaries, but a unit's checkout is necessarily project-local.
+ * Spawned unit worktrees live sibling to the primary checkout (`<parent>/<repo>.worktrees/legion-<id6>`),
+ * never nested inside it, even though the registry/mailbox itself lives in the global hub — the hub
+ * addresses units across project and worktree boundaries, but a unit's checkout is necessarily
+ * scoped to this one project's git remote.
  */
 declare function spawn(ctx: IdContext, input: SpawnInput): SpawnResult;
 //#endregion
@@ -556,9 +410,8 @@ declare class FileStore implements Store {
   removePaneIndex(pane: string): void;
   writeBrief(agentId: string, text: string): void;
   readBrief(agentId: string): string | undefined;
-  resultPath(id: string): string;
-  writeResult(id: string, value: unknown): void;
-  readResult(id: string): string | undefined;
+  setMainPane(pane: string | null): void;
+  getMainPane(): string | undefined;
 }
 //#endregion
 //#region src/wake/await.d.ts
@@ -595,46 +448,6 @@ type AwaitOutcome = {
  */
 declare function awaitReply(ctx: MsgContext, input: AwaitInput): Promise<AwaitOutcome>;
 //#endregion
-//#region src/wake/wake-path.d.ts
-/**
- * The wake-matrix path a gateway would drive a turn through. Pure decision helper — no I/O, no
- * polling, no session backend calls; the gateway (`legion-gateway-legate`, CR-5) composes this with
- * the actual `mail await` / `session nudge` primitives.
- *
- * - **A** — a single unbounded `mail await` (not returned here; superseded by A-loop everywhere the
- *   gateway drives this decision, since a raw A risks a harness tool-timeout SIGKILL).
- * - **A-loop** — the portable default: a bounded `mail await` cycle, re-armed by the caller.
- * - **A-prime** — Claude Code with an observable background task: run `await` via
- *   `run_in_background` and poll its result instead of blocking the turn.
- * - **B** — a live foreign session behind a verified multiplexer: ring the doorbell
- *   (`session nudge`) instead of polling. Never selected without a mux.
- * - **C** — own-the-PTY (dropped from the shipped matrix; kept as a type for completeness).
- * - **D** — `/loop`-style external re-invocation (dropped from the shipped matrix).
- * - **E** — hook surfacing at a turn boundary (selected by the caller directly, not by this
- *   function — it has no wait/poll shape to decide between).
- */
-type WakePath = 'A' | 'A-loop' | 'A-prime' | 'B' | 'C' | 'D' | 'E';
-interface WakePathInput {
-  /** The calling harness, e.g. 'claude' | 'cursor' | 'codex'. */
-  harness: string;
-  mux: MuxProbe;
-  /** The harness can observe a backgrounded task's result without blocking the turn. */
-  observable?: boolean;
-  /** The target is a live, foreign interactive session that can be rung rather than polled. */
-  dedicatedListener?: boolean;
-}
-interface WakePathResult {
-  path: WakePath;
-  why: string;
-}
-/**
- * Select a wake path from the shipped matrix. Rule order: a `mux.mux === 'none'` caller can never
- * get **B** — it always falls through to the bounded poll. Claude Code + an observable background
- * task prefers **A-prime**. A live foreign session behind a verified mux prefers **B**. Otherwise
- * the portable default is **A-loop**.
- */
-declare function selectWakePath(input: WakePathInput): WakePathResult;
-//#endregion
 //#region src/wake/watch.d.ts
 interface WatchInput {
   meId: string;
@@ -653,4 +466,4 @@ interface WatchOptions {
  */
 declare function watchMail(ctx: MsgContext, input: WatchInput, onMessage: (msg: InboxItem) => void, opts?: WatchOptions): Promise<void>;
 //#endregion
-export { type AgentDef, type AgentRecord, type AwaitInput, type AwaitOutcome, type ChannelInput, type DecommissionInput, type DecommissionResult, type DispatchEnvelope, type DispatchResult, DispatchWaitingError, type Exec, FileStore, type Format, type Harness, type HookEvent, type IdContext, type InboxItem, type InboxQuery, type InboxSnapshot, type Message, type MuxProbe, type PrepInput, type RegisterInput, type RootOptions, type SendInput, type SpawnInput, type SpawnResult, type Store, type WakePathInput, type WakePathResult, ack, assertDistinctFromPrimary, awaitReply, bumpLastSeen, channel, collect, decommission, deleteMessage, detectHarness, emit, ensureMarker, fail, gitWorktreeAdapter, inbox, injectInbox, install, listAgentDefs, listAgents, loadAgent, nextStep, paths, peek, prep, probeMultiplexer, projectRoot, prune, realExec, realizeLaunch, realizeSubagentInstruction, register, resolveAgent, resolveAgentDef, resolveBody, resolvePrimaryRoot, resolveProjectLocalRoot, resolveRecipient, resolveRoot, resolveSelfId, selectSessionAdapter, selectWakePath, send, spawn, toonList, toonObject, touch, watchMail };
+export { type AgentDef, type AgentRecord, type AwaitInput, type AwaitOutcome, type DecommissionInput, type DecommissionResult, type Exec, FileStore, type Format, type Harness, type HookEvent, type IdContext, type InboxItem, type InboxQuery, type InboxSnapshot, type Message, type MuxProbe, type RegisterInput, type RootOptions, type SendInput, type SpawnInput, type SpawnResult, type Store, ack, assertDistinctFromPrimary, awaitReply, bumpLastSeen, decommission, deleteMessage, detectHarness, emit, ensureMarker, fail, gitWorktreeAdapter, inbox, injectInbox, install, listAgentDefs, listAgents, loadAgent, nextStep, paths, peek, probeMultiplexer, projectRoot, prune, realExec, realizeLaunch, register, resolveAgent, resolveAgentDef, resolveBody, resolvePrimaryRoot, resolveProjectLocalRoot, resolveRecipient, resolveRoot, resolveSelfId, selectSessionAdapter, send, spawn, toonList, toonObject, touch, watchMail };

package/dist/index.mjs

@@ -1,28 +1,4 @@
-import { A as resolveProjectLocalRoot, B as loadAgent, C as resolveAgentDef, D as ensureMarker, E as spawn, F as selectSessionAdapter, G as resolveRecipient, H as realExec, I as probeMultiplexer, K as resolveSelfId, L as bumpLastSeen, M as assertDistinctFromPrimary, N as gitWorktreeAdapter, O as paths, P as resolvePrimaryRoot, R as detectHarness, S as listAgentDefs, T as realizeSubagentInstruction, U as register, V as prune, W as resolveAgent, _ as inbox, a as fail, b as send, c as toonObject, d as DispatchWaitingError, f as channel, g as deleteMessage, h as ack, i as emit, j as resolveRoot, k as projectRoot, l as install, m as awaitReply, n as FileStore, o as nextStep, p as prep, q as touch, r as injectInbox, s as toonList, t as watchMail, u as collect, v as peek, w as realizeLaunch, x as decommission, y as resolveBody, z as listAgents } from "./watch-DA8I44dv.mjs";
-//#region src/wake/wake-path.ts
-/**
-* Select a wake path from the shipped matrix. Rule order: a `mux.mux === 'none'` caller can never
-* get **B** — it always falls through to the bounded poll. Claude Code + an observable background
-* task prefers **A-prime**. A live foreign session behind a verified mux prefers **B**. Otherwise
-* the portable default is **A-loop**.
-*/
-function selectWakePath(input) {
-	if (input.mux.mux === "none") return {
-		path: "A-loop",
-		why: "no multiplexer detected — bounded poll only, B is never available"
-	};
-	if (input.harness === "claude" && input.observable) return {
-		path: "A-prime",
-		why: "Claude Code + an observable background task — await via run_in_background"
-	};
-	if (input.dedicatedListener) return {
-		path: "B",
-		why: `a live foreign session behind a verified ${input.mux.mux} mux — ring the doorbell`
-	};
-	return {
-		path: "A-loop",
-		why: "portable default — bounded mail await cycle"
-	};
-}
-//#endregion
-export { DispatchWaitingError, FileStore, ack, assertDistinctFromPrimary, awaitReply, bumpLastSeen, channel, collect, decommission, deleteMessage, detectHarness, emit, ensureMarker, fail, gitWorktreeAdapter, inbox, injectInbox, install, listAgentDefs, listAgents, loadAgent, nextStep, paths, peek, prep, probeMultiplexer, projectRoot, prune, realExec, realizeLaunch, realizeSubagentInstruction, register, resolveAgent, resolveAgentDef, resolveBody, resolvePrimaryRoot, resolveProjectLocalRoot, resolveRecipient, resolveRoot, resolveSelfId, selectSessionAdapter, selectWakePath, send, spawn, toonList, toonObject, touch, watchMail };
+import { A as loadAgent, B as resolveSelfId, C as spawn, F as register, G as projectRoot, H as touch, K as resolveProjectLocalRoot, L as resolveAgent, M as prune, N as realExec, O as detectHarness, T as bumpLastSeen, U as ensureMarker, W as paths, _ as install, a as emit, b as resolveAgentDef, c as toonList, d as deleteMessage, f as inbox, g as send, h as resolveBody, i as injectInbox, k as listAgents, l as toonObject, n as awaitReply, o as fail, p as peek, q as resolveRoot, r as FileStore, s as nextStep, t as watchMail, u as ack, v as decommission, w as selectSessionAdapter, x as realizeLaunch, y as listAgentDefs, z as resolveRecipient } from "./watch-nkm6F1_f.mjs";
+import { probeMultiplexer } from "cyber-mux";
+import { assertDistinctFromPrimary, gitWorktreeAdapter, resolvePrimaryRoot } from "cyber-mux/worktree";
+export { FileStore, ack, assertDistinctFromPrimary, awaitReply, bumpLastSeen, decommission, deleteMessage, detectHarness, emit, ensureMarker, fail, gitWorktreeAdapter, inbox, injectInbox, install, listAgentDefs, listAgents, loadAgent, nextStep, paths, peek, probeMultiplexer, projectRoot, prune, realExec, realizeLaunch, register, resolveAgent, resolveAgentDef, resolveBody, resolvePrimaryRoot, resolveProjectLocalRoot, resolveRecipient, resolveRoot, resolveSelfId, selectSessionAdapter, send, spawn, toonList, toonObject, touch, watchMail };