cyberlegion 1.9.0 → 2.0.0

package/dist/index.d.mts

@@ -1,7 +1,6 @@
-import { Exec, Exec as Exec$1, MuxAdapter, MuxPlacement, MuxProbe, NudgeOptions, probeMultiplexer } from "cyber-mux";
+import { Exec, Exec as Exec$2, MuxAdapter, MuxPlacement, MuxProbe, NudgeOptions, probeMultiplexer } from "cyber-mux";
 import { assertDistinctFromPrimary, gitWorktreeAdapter, resolvePrimaryRoot } from "cyber-mux/worktree";
 import { ReleaseResult } from "cyber-agentkit/worktrees";
-//#region src/store/store.d.ts
 interface Message {
   id: string;
   from: string;
@@ -40,11 +39,25 @@ interface AgentRecord {
       holder: string;
     };
   } | null;
+  /** A checkout the unit works in but does not own: a `--cwd` spawn into an existing checkout, or a
+   * session registered in a worktree another unit's record owns. `owner` is that unit's id, when one
+   * owned the root at the time of recording. Close never removes, prunes, or releases it — it is read
+   * only, so a sweep can judge the unit by the work there. Absent on records from before it existed. */
+  sharedWorktree?: {
+    root: string;
+    branch?: string;
+    primaryRoot?: string;
+    owner?: 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. */
+   * `null` for a session in no pane and for a standing record. `window`/`session` are tmux-only.
+   * `terminal` is herdr-only: the pane's herdr terminal id, which survives a `herdr pane move` that
+   * gives the pane a new id (#272), so prune and touch follow a moved pane by it. Absent on records
+   * written before it existed, which are judged by `id` alone. */
   pane?: {
     mux: 'tmux' | 'herdr';
     id: string;
+    terminal?: string;
     window?: string;
     session?: string;
   } | null;
@@ -218,13 +231,11 @@ interface Store extends MailboxStore {
   /** `withLock` held across an async `fn` until its promise settles (`store/lock.ts`). */
   withLockAsync<T>(name: string, fn: () => Promise<T>): Promise<T>;
 }
-//#endregion
-//#region src/identity.d.ts
-export declare const realExec: Exec$1;
+export declare const realExec: Exec$2;
 interface IdContext {
   store: Store;
   env?: NodeJS.ProcessEnv;
-  exec?: Exec$1;
+  exec?: Exec$2;
   now?: () => number;
   /** The argv that re-invokes this very CLI — node, its loader flags, and the entry script
    * (`selfInvocation`). `unit spawn` puts a `cyberlegion` shim over it on the new session's PATH,
@@ -259,15 +270,25 @@ export declare function resolveRecipient(store: Store, to: string): string;
  */
 export declare function resolveAgent(store: Store, ref: string): AgentRecord;
 export declare function bumpLastSeen(ctx: IdContext, id: string): void;
-/** Refresh this session's own last-seen if it is registered — best-effort, never throws. */
+/**
+ * Refresh this session's own last-seen if it is registered — best-effort, never throws. In a herdr
+ * pane whose calling pane herdr reported, it also heals the record's pane to the id and terminal
+ * herdr gave, so a unit whose pane moved fixes its own record on its next turn (#272).
+ */
 export declare function touch(ctx: IdContext): void;
-/** Mark agents whose session is gone as exited. Reconcile-culls against the current mux's live set
- * first, then judges each remaining record (covers the other mux and sessions outside any
- * multiplexer pane): a pane-bound record by its pane alone — a live or unprobeable pane keeps it
- * whatever its last-seen — and a pane-less record by the staleness timer, its only signal. */
-export declare function prune(ctx: IdContext): AgentRecord[];
-//#endregion
-//#region src/agentdef/resolve.d.ts
+/** A record `prune` changed: `exited` when it was marked and kept, `deleted` when it was removed. */
+type PrunedRecord = AgentRecord & {
+  pruned: 'exited' | 'deleted';
+};
+/**
+ * Mark agents whose session is gone as exited, then delete every exited unit with nothing left to
+ * work from. Reconcile-culls against the current mux's live set first, then judges each remaining
+ * record (covers the other mux and sessions outside any multiplexer pane): a pane-bound record by its
+ * pane alone — a live or unprobeable pane keeps it whatever its last-seen — and a pane-less record by
+ * the staleness timer, its only signal. An exited unit whose worktree is still on disk is kept, since
+ * `unit close` owns removing that worktree; every other exited unit is deleted with `deleteExited`.
+ */
+export declare function prune(ctx: IdContext): PrunedRecord[];
 interface AgentDef {
   name: string;
   description?: string;
@@ -298,8 +319,6 @@ export declare function listAgentDefs(input?: {
   cwd?: string;
   searchRoots?: string[];
 }): AgentDef[];
-//#endregion
-//#region src/agentdef/realize.d.ts
 interface RealizeLaunchOptions {
   /** Overrides def.model when present. */
   model?: string;
@@ -330,8 +349,6 @@ interface RealizedLaunch {
  * def's own tags, which win over the harness default. The def's effort and instructions each go
  * through the harness's own control (see `cursorModel`, `modelAndEffortArgs`, `instructionArgs`). */
 export declare function realizeLaunch(def: AgentDef, opts?: RealizeLaunchOptions): RealizedLaunch;
-//#endregion
-//#region src/decommission.d.ts
 interface DecommissionInput {
   id: string;
   /** Discard uncommitted changes in the worktree. Refused for a unit on the primary checkout, which close never alters. */
@@ -383,8 +400,6 @@ interface DecommissionResult {
  * is not reported as retained: it is no pool path a next unit could be spawned into.
  */
 export declare function decommission(ctx: IdContext, input: DecommissionInput): Promise<DecommissionResult>;
-//#endregion
-//#region src/runtime/inject-inbox.d.ts
 type HookEvent = 'SessionStart';
 interface InjectPayload {
   hookSpecificOutput: {
@@ -402,8 +417,6 @@ interface InjectPayload {
  * firing in the child (`unit/lifecycle`, superseding ADR-0027).
  */
 export declare function injectInbox(ctx: IdContext, event: string): InjectPayload | null;
-//#endregion
-//#region src/install.d.ts
 type RetiredEvent = 'PostToolUse';
 type InstallStatus = 'registered' | 'already present' | 'provided by plugin' | 'removed project hook';
 interface InstallResult {
@@ -418,8 +431,6 @@ interface InstallResult {
  * plugin ships it (removing an earlier project copy), otherwise register the PATH-first project hook.
  */
 export declare function install(harness: Harness, projectDir?: string, pin?: string): InstallResult[];
-//#endregion
-//#region src/message.d.ts
 interface MsgContext {
   store: Store;
   now?: () => number;
@@ -454,8 +465,6 @@ export declare function peek(ctx: MsgContext, meId: string, msgId: string): Mess
 export declare function ack(ctx: MsgContext, meId: string, msgId: string): Message;
 /** Permanently remove a message (unread or already-acked) from the caller's inbox. */
 export 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
@@ -469,8 +478,6 @@ export declare function deleteMessage(ctx: MsgContext, meId: string, msgId: stri
  * `screen`) falls through to the plain "no backend" refusal, unchanged from before the migration.
  */
 export 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. */
 export declare function toonObject(fields: Record<string, unknown>): string;
@@ -492,18 +499,16 @@ export declare function emit(format: Format, payload: EmitPayload): void;
 export declare function nextStep(msg: string): void;
 /** A structured, fail-loud error: stderr + exit 1. Never prompts, never partially writes. */
 export declare function fail(msg: string): never;
-//#endregion
-//#region src/paths.d.ts
 /** Walk up from `cwd` to the nearest git repo root; fall back to `cwd`. */
 export declare function projectRoot(cwd?: string): string;
 /** Runs a command synchronously in `cwd`; returns trimmed stdout, or null on any failure. */
-type Exec$2 = (cmd: string, args: string[]) => string | null;
+type Exec$1 = (cmd: string, args: string[]) => string | null;
 interface RootOptions {
   root?: string;
   space?: string;
   cwd?: string;
   env?: NodeJS.ProcessEnv;
-  exec?: Exec$2;
+  exec?: Exec$1;
 }
 /**
  * Resolve the cyberlegion hub root. Precedence: explicit --root/--space, then `$CYBERLEGION_ROOT`,
@@ -545,8 +550,6 @@ export declare const paths: {
   messageFile: (root: string, toId: string, msgId: string) => string;
   messageReadFile: (root: string, toId: string, msgId: string) => string;
 };
-//#endregion
-//#region src/project.d.ts
 interface ProjectContext {
   store: Store;
   exec?: Exec;
@@ -568,8 +571,6 @@ export declare function listProjects(store: Store): ProjectRecord[];
  * and an ambiguous name names its candidates rather than picking one.
  */
 export declare function resolveProject(ctx: ProjectContext, ref: string): ProjectRecord;
-//#endregion
-//#region src/service.d.ts
 interface ServiceContext extends IdContext {
   /** Whether a unit's session is still there. Defaults to asking its multiplexer (`sessionLive`). */
   isLive?: (unit: AgentRecord) => boolean;
@@ -707,8 +708,6 @@ type StartResult<T> = {
 export declare function startService<T extends {
   unit: string;
 }>(ctx: ServiceContext, projectRef: string, name: string, input: StartInput<T>): Promise<StartResult<T>>;
-//#endregion
-//#region src/console/trust.d.ts
 interface TrustOptions {
   /** Time between screen reads. */
   pollMs?: number;
@@ -748,8 +747,6 @@ type TrustOutcome =
   state: 'stuck';
   message: string;
 };
-//#endregion
-//#region src/session.d.ts
 interface SpawnInput {
   harness?: string;
   task?: string;
@@ -856,8 +853,6 @@ interface FirstTurn {
   trust: TrustOutcome['state'];
   trustBlocked?: string;
 }
-//#endregion
-//#region src/store/file-store.d.ts
 /** The on-disk `Store` implementation — current per-writer sharded `.json` layout (ADR-0020):
  * one file per message/agent, collision-free filenames, ack = atomic rename into `read/`. */
 export declare class FileStore implements Store {
@@ -891,8 +886,6 @@ export declare class FileStore implements Store {
   withLock<T>(name: string, fn: () => T): T;
   withLockAsync<T>(name: string, fn: () => Promise<T>): Promise<T>;
 }
-//#endregion
-//#region src/wake/await.d.ts
 interface AwaitInput {
   meId: string;
   thread: string;
@@ -925,8 +918,6 @@ type AwaitOutcome = {
  *   elapsed across re-arms with no match. The caller should exit non-zero.
  */
 export declare function awaitReply(ctx: MsgContext, input: AwaitInput): Promise<AwaitOutcome>;
-//#endregion
-//#region src/wake/watch.d.ts
 interface WatchInput {
   meId: string;
   thread?: string;
@@ -943,5 +934,4 @@ interface WatchOptions {
  * `watch` prints stays unread and still surfaces later in `mail inbox`/`mail await`.
  */
 export declare function watchMail(ctx: MsgContext, input: WatchInput, onMessage: (msg: InboxItem) => void, opts?: WatchOptions): Promise<void>;
-//#endregion
 export { type AcquireInput, type AcquireResult, type AgentDef, type AgentRecord, type AwaitInput, type AwaitOutcome, type DecommissionInput, type DecommissionResult, type Exec, type Format, type Harness, type HookEvent, type IdContext, type InboxItem, type InboxQuery, type InboxSnapshot, type Message, type MuxProbe, type OwnershipErrorCode, type ProjectContext, type ProjectRecord, type RegisterInput, type RootOptions, type SendInput, type ServiceContext, type ServiceHealth, type ServiceLease, type ServiceView, type SpawnInput, type SpawnResult, type StartInput, type StartResult, type Store, assertDistinctFromPrimary, gitWorktreeAdapter, probeMultiplexer, resolvePrimaryRoot };