@openrig/cli 0.4.8 → 0.5.1

package/node_modules/@openrig/daemon/dist/adapters/tmux.d.ts

@@ -0,0 +1,218 @@
+export type ExecFn = (cmd: string) => Promise<string>;
+/**
+ * Injectable file/buffer operations for the large-payload `sendText` path.
+ * Split out so tests can observe temp-file writes and unique-name generation
+ * without touching the real filesystem; production wires node fs + os.tmpdir.
+ */
+export interface TmuxFileOps {
+    writeFile(path: string, content: string): Promise<void>;
+    unlink(path: string): Promise<void>;
+    /** Unique temp-file path per call - parallel `rig up` stands up many seats. */
+    tmpName(): string;
+    /** Unique tmux buffer name per call - a fixed name would collide under concurrency. */
+    bufferName(): string;
+}
+export type TmuxResult = {
+    ok: true;
+} | {
+    ok: false;
+    code: string;
+    message: string;
+};
+export interface TmuxSession {
+    name: string;
+    windows: number;
+    created: string;
+    attached: boolean;
+}
+export interface TmuxWindow {
+    index: number;
+    name: string;
+    panes: number;
+    active: boolean;
+}
+export interface TmuxPane {
+    id: string;
+    index: number;
+    cwd: string;
+    width: number;
+    height: number;
+    active: boolean;
+}
+/**
+ * Cursor coordinates plus pane geometry, used by the live-terminal seed
+ * (OPR.0.4.0.38). Coordinates are zero-based; geometry is the visible pane
+ * size. Lifted from the FR-4 seed work so a new subscriber can paint the
+ * current screen with the cursor in the right place and no row drift.
+ */
+export interface TmuxCursorPosition {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * An attached tmux client — the human's terminal/CMUX tile. `name` is the
+ * client identifier accepted by `switch-client -c` (the client tty by default);
+ * `session` is the session the client is CURRENTLY viewing (may be the wrong or
+ * a dead view, which is exactly the recovery case OPR.0.4.3.26 retargets).
+ */
+export interface TmuxClient {
+    name: string;
+    session: string;
+}
+export declare class TmuxAdapter {
+    private exec;
+    private fileOps;
+    constructor(exec: ExecFn, fileOps?: TmuxFileOps);
+    listSessions(): Promise<TmuxSession[]>;
+    listWindows(sessionName: string): Promise<TmuxWindow[]>;
+    listPanes(target: string): Promise<TmuxPane[]>;
+    hasSession(name: string): Promise<boolean>;
+    createSession(name: string, cwd?: string, env?: Record<string, string>): Promise<TmuxResult>;
+    sendText(target: string, text: string): Promise<TmuxResult>;
+    /**
+     * Large-payload delivery path (the point of this transport change): a
+     * >100KB startup pack must NOT be embedded in a tmux/shell argv. The text is
+     * written to a unique temp file via Node fs (never shell-embedded), loaded
+     * into a unique tmux buffer, and pasted with `-d -r`:
+     *   `-r`  preserve raw LF. tmux's default paste-buffer replaces every LF with
+     *         CR, and CR (= `C-m` = Enter) is SUBMIT in the Claude/Codex TUIs - a
+     *         default paste of a multi-line pack would submit on every newline.
+     *   `-d`  drop the buffer after a successful paste.
+     * The single trailing submit stays the caller's separate `sendKeys(["C-m"])`,
+     * exactly as the inline `send-keys -l` path relies on (behavior-preserving).
+     * Cleanup unlinks the temp file in `finally`; if the buffer was loaded but the
+     * paste failed (e.g. missing target), an explicit `delete-buffer` runs so no
+     * buffer leaks. Unique temp + buffer names per call keep parallel `rig up`
+     * seats from colliding.
+     */
+    private sendTextViaBuffer;
+    sendKeys(target: string, keys: string[]): Promise<TmuxResult>;
+    setWindowOption(target: string, option: string, value: string): Promise<TmuxResult>;
+    resizeWindow(target: string, cols: number, rows: number): Promise<TmuxResult>;
+    killSession(name: string): Promise<TmuxResult>;
+    /** Seat-handover cutover (plan 411c43de): respawn a pane IN PLACE (reuse the retiree's EXACT pane) so
+     *  the successor boots below the predecessor's history — same window, same pane, predecessor scrollback
+     *  PRESERVED above the boot. The command is shell-quoted as ONE unit (tmux runs it via the shell).
+     *
+     *  ⚠ NO `-k`: empirically (tmux 3.6a) `respawn-pane -k` force-kills+respawns atomically and CLEARS the
+     *  pane's scrollback — defeating the money-proof. So the cutover terminates the retiree FIRST (graceful
+     *  exit + `setRemainOnExit(true)` so the pane survives dead), waits for `isPaneDead`, then calls this
+     *  WITHOUT -k on the already-dead pane — which preserves the history. respawn-pane refuses a still-live
+     *  pane ("still active"), which is the correct guard: never respawn over a live retiree.
+     *
+     *  Optional `cwd`/`env` inject the successor's start-directory + OpenRig identity env onto the reused
+     *  pane via respawn-pane's `-c`/`-e` flags (tmux ≥3.0), the SAME mechanism createSession uses. Any flags
+     *  precede the command, which always stays LAST. `command` is OPTIONAL: omitting it re-runs the pane's
+     *  creation command (the default login shell) — the fresh shell the cutover successor's launchHarness drives. */
+    respawnPane(paneTarget: string, command?: string, opts?: {
+        cwd?: string;
+        env?: Record<string, string>;
+    }): Promise<TmuxResult>;
+    /** Seat-handover cutover: set the pane-scoped `remain-on-exit` so the pane SURVIVES (goes dead, not
+     *  destroyed) when the retiree process exits — holding its scrollback for the successor's respawn.
+     *  Set to `on` BEFORE the retiree is signalled to exit (else the pane is destroyed on exit and there
+     *  is nothing to respawn into). */
+    setRemainOnExit(paneTarget: string, on: boolean): Promise<TmuxResult>;
+    /** Seat-handover cutover: is the pane's process dead (the retiree exited; the pane held by
+     *  remain-on-exit)? A known-missing pane also proves physical cutover; unknown probe errors stay false. */
+    isPaneDead(paneId: string): Promise<boolean>;
+    /** Seat-handover cutover: signal the pane's foreground process (the retiree) — `TERM` for the graceful
+     *  exit-in-place, `KILL` for the bounded-timeout force fallback. Resolves the pane pid then `kill`s it;
+     *  an unresolvable pid is a structured, non-throwing failure. */
+    signalPaneProcess(paneId: string, signal: "TERM" | "KILL"): Promise<TmuxResult>;
+    /** Get the PID of the foreground process in a pane. Returns null if unavailable. */
+    getPanePid(paneId: string): Promise<number | null>;
+    /** Get the current foreground command in a pane. Returns null if unavailable. */
+    getPaneCommand(paneId: string): Promise<string | null>;
+    /** OPR.0.4.3.28 Part C — presence-only check for a session-env variable.
+     *  Returns whether the var is SET, NEVER its value (the producer-link
+     *  diagnostic must never surface a token value). `tmux show-environment`
+     *  prints `VAR=value` when set and `-VAR` when explicitly unset. */
+    hasSessionEnv(sessionName: string, varName: string): Promise<boolean>;
+    /** Start pipe-pane to capture terminal output to a file. */
+    startPipePane(sessionName: string, outputPath: string): Promise<TmuxResult>;
+    /** Stop pipe-pane on a session. */
+    stopPipePane(sessionName: string): Promise<TmuxResult>;
+    /** Capture pane content (last N lines). Returns null if unavailable. */
+    capturePaneContent(paneId: string, lines?: number): Promise<string | null>;
+    /**
+     * Capture the currently VISIBLE pane screen (no scrollback). Returns null if
+     * unavailable. The live-terminal seed (OPR.0.4.0.38) must use the visible
+     * screen, NOT `-S -<lines>` scrollback: scrollback reintroduces the row drift
+     * the absolute-paint seed exists to eliminate.
+     */
+    capturePaneScreen(paneId: string): Promise<string | null>;
+    /**
+     * Get the current cursor coordinates and pane geometry. Coordinates are
+     * zero-based. Returns null if unavailable or if tmux yields non-finite /
+     * out-of-range values (x<0, y<0, width<1, height<1) so a bad read never
+     * produces a garbage seed.
+     */
+    getPaneCursorPosition(paneId: string): Promise<TmuxCursorPosition | null>;
+    /**
+     * Set a SESSION-scoped option via `set-option -t <session>` (OPR.0.4.6.02
+     * N1 JSDoc fix, arch): this is the GENERIC session-scope writer — it takes
+     * ANY session option, not only `@`-prefixed user options (it is how the
+     * launcher sets built-in session options like `mouse` and `status`). For
+     * SERVER-scope options use `setServerOption` (`set-option -s`); the two
+     * scopes are never crossed (guard b2).
+     */
+    setSessionOption(sessionName: string, key: string, value: string): Promise<TmuxResult>;
+    /**
+     * OPR.0.4.6.02 S1 (guard b2): set a SERVER-scoped option via
+     * `set-option -s <option> <value>` — the daemon configuring its OWN tmux
+     * server (NOT a live-flip of anyone's session). NEVER targets a session
+     * (`-t`): server scope and session scope are distinct and never crossed.
+     * Used for `set-clipboard` / `copy-command`.
+     */
+    setServerOption(option: string, value: string): Promise<TmuxResult>;
+    /**
+     * OPR.0.4.6.02 S1: read a SERVER-scoped option value via
+     * `show-options -sv <option>` (the `-s` server-scope reader — mirrors
+     * `setServerOption`). Returns null if unset or on error. For tests/proof.
+     */
+    showServerOption(option: string): Promise<string | null>;
+    /** Get a session-scoped user option value. Returns null if not set or error. */
+    getSessionOption(sessionName: string, key: string): Promise<string | null>;
+    /**
+    /**
+     * Slice 15 — read the timestamp (Unix epoch seconds) of the last
+     * activity on the pane's window. The daemon's SeatActivityService
+     * compares this against the configured silence window: if the
+     * timestamp is within the window the seat is `terminal-active`,
+     * otherwise it's silent past the threshold.
+     *
+     * Why not `pane_silence_flag`: tmux 3.6a was observed to return a
+     * blank value for `#{pane_silence_flag}` during slice 15 dogfood
+     * (sticky-alert behavior + version-dependent emit semantics), so
+     * we cannot rely on it as the primary signal. `#{window_activity}`
+     * is reliably populated (the runtime updates it whenever the
+     * window receives output) and is the timestamp the tmux status-line
+     * activity indicators use themselves.
+     *
+     * Returns:
+     *   - a Unix-epoch-seconds integer when the runtime exposed the value
+     *   - `null` when the target is missing OR the value is unparseable
+     *     (consumers treat null as "no signal", distinct from "idle").
+     */
+    readPaneLastActivity(paneId: string): Promise<number | null>;
+    /**
+     * OPR.0.4.3.26 — list the tmux clients (human terminals / CMUX tiles) attached
+     * to the server. VIEW-ONLY probe: it never mutates routing, bindings, or
+     * sessions. Mirrors the read/parse/error-swallow shape of `listSessions`:
+     * a "no server running" / socket-absent server yields `[]` (no attachable
+     * client) so the caller emits an honest "attach first" error rather than
+     * crashing. Unexpected failures (permission, etc.) rethrow.
+     */
+    listClients(): Promise<TmuxClient[]>;
+    /**
+     * OPR.0.4.3.26 — retarget an already-attached client's VIEW to `target`
+     * (`<session>` or `<session>:<window>`). This is the whole point of the
+     * seat-recovery slice: it changes only what a client SEES; it never creates,
+     * kills, or rebinds a session and never touches OpenRig routing/identity.
+     */
+    switchClient(client: string, target: string): Promise<TmuxResult>;
+}
+//# sourceMappingURL=tmux.d.ts.map

package/node_modules/@openrig/daemon/dist/adapters/tmux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux.d.ts","sourceRoot":"","sources":["../../src/adapters/tmux.ts"],"names":[],"mappings":"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"}