botmux 2.51.1 → 2.53.0

package/dist/adapters/backend/zellij-backend.d.ts

@@ -0,0 +1,132 @@
+import type { SessionBackend, SpawnOpts } from './types.js';
+/**
+ * ZellijBackend — session backend using zellij for process persistence.
+ *
+ * Architecture: pty-under-zellij (the "B route"), the zellij analogue of the
+ * legacy TmuxBackend (pty-under-tmux):
+ *   - A node-pty process runs `zellij --session … --layout-string …` (fresh)
+ *     or `zellij attach …` (reattach). The node-pty is the only zellij client.
+ *   - All output flows through the pty (onData/onExit work unchanged) — we get
+ *     the raw rendered byte stream for free, sidestepping zellij `subscribe`'s
+ *     "whole-viewport-snapshot" model that doesn't fit botmux's xterm pipeline.
+ *   - Input goes through pty.write(). We start zellij in **locked mode with
+ *     keybindings cleared** (generated config), so every byte we write —
+ *     including Ctrl-C, arrows, bracketed-paste markers — passes straight to
+ *     the focused CLI pane with zero keybinding interception (the moral
+ *     equivalent of tmux's single prefix key, but with nothing reserved).
+ *   - resize() is pty.resize(): the attached client's size drives the pane, so
+ *     the headless-default 25-column problem never bites (the pty is the size).
+ *   - kill() only detaches (kills the pty client); the zellij server keeps the
+ *     CLI running, so a daemon restart re-attaches with `zellij attach`.
+ *   - destroySession() runs `zellij delete-session -f` (kill + purge the
+ *     resurrectable corpse) on explicit /close.
+ *
+ * Naming: zellij sessions are named `bmx-<sessionId.slice(0,8)>`, same as tmux.
+ */
+export declare class ZellijBackend implements SessionBackend {
+    private process;
+    private readonly sessionName;
+    private readonly ownsSession;
+    private reattaching;
+    private configPath;
+    private tmpConfigDir;
+    /** Set by kill()/destroySession() so the pty-client exit they cause (an
+     *  intentional detach/teardown — the zellij session survives) is NOT
+     *  reported as a CLI exit. A real CLI exit leaves this false. */
+    private intentionalExit;
+    /** Cached CLI pid. The CLI subprocess starts asynchronously after spawn(),
+     *  so the first getChildPid() may be null; once resolved it's stable for the
+     *  session lifetime (single CLI pane → pane exit ends the session). */
+    private resolvedCliPid;
+    /** Explicit pane target for adopt mode (e.g. "terminal_2"). When null,
+     *  zellij `action` commands address the focused pane — correct for managed
+     *  mode where the single CLI pane is always focused. */
+    private readonly paneId;
+    claudeJsonlPath?: string;
+    cliPid?: number;
+    cliCwd?: string;
+    constructor(sessionName: string, opts?: {
+        ownsSession?: boolean;
+        isReattach?: boolean;
+        paneId?: string;
+    });
+    static isAvailable(): boolean;
+    static sessionName(sessionId: string): string;
+    /** Names of LIVE (non-exited) zellij sessions. A killed-but-serialised
+     *  session lingers in `list-sessions` as "(EXITED - attach to resurrect)";
+     *  we must not treat those as reattachable, so filter them out. */
+    static liveSessions(): string[];
+    static hasSession(name: string): boolean;
+    /** Kill + purge a session (so no resurrectable corpse accumulates). */
+    static killSession(name: string): void;
+    static listBotmuxSessions(): string[];
+    spawn(bin: string, args: string[], opts: SpawnOpts): void;
+    /** Write the per-session config (locked mode + cleared keybinds so pty.write
+     *  passes through untouched, no startup tips / pane frames) and, for a fresh
+     *  spawn, the single-pane layout file. Both live in one temp dir cleaned on
+     *  kill(). On reattach the layout file is unused but harmless. */
+    private writeRuntimeFiles;
+    get isReattach(): boolean;
+    write(data: string): void;
+    /** Literal text, no Enter. */
+    sendText(text: string): void;
+    /** Special keys by tmux-style name (Enter, Escape, C-c, M-Enter, …). */
+    sendSpecialKeys(...keys: string[]): void;
+    /** Bracketed paste: wrap with \e[200~ … \e[201~ so TUIs (CoCo/Ink/Codex)
+     *  detect the paste boundary and don't treat embedded \n as Enter. Mirrors
+     *  `tmux paste-buffer -p`. */
+    pasteText(text: string): void;
+    resize(cols: number, rows: number): void;
+    /** Must be called AFTER spawn(). */
+    onData(cb: (data: string) => void): void;
+    /** Must be called AFTER spawn(). */
+    onExit(cb: (code: number | null, signal: string | null) => void): void;
+    /** CLI pid. May be null immediately after spawn() (the CLI subprocess starts
+     *  asynchronously); the worker retries. Cached once resolved. */
+    getChildPid(): number | null;
+    /** Detach only — kills the pty client, leaves the zellij session running. */
+    kill(): void;
+    /** Kill the zellij session permanently (explicit /close). */
+    destroySession(): void;
+    private cleanupConfig;
+}
+/**
+ * Locked mode + cleared keybinds => the client pty forwards every byte to the
+ * focused pane with no zellij interception. No startup tips / pane frames so
+ * the captured stream is just the CLI (we don't need to hide chrome, but a
+ * clean single pane keeps screenshots faithful and the renderer simple).
+ */
+export declare const ZELLIJ_CONFIG_KDL = "// botmux-generated \u2014 do not edit\nshow_startup_tips false\npane_frames false\ndefault_mode \"locked\"\nkeybinds clear-defaults=true {\n}\n";
+/** Escape a string for a KDL double-quoted value. */
+export declare function kdlString(s: string): string;
+/**
+ * Build the `--layout-string` KDL: a single full-screen pane that execs the CLI
+ * through the user's shell (same wrapper TmuxBackend uses, so PATH / NVM / pnpm
+ * / mise shims load from rcfiles). Command + args go in via execvp semantics —
+ * no shell-quoting needed (KDL strings carry spaces/quotes), only KDL escaping.
+ *
+ *   pane command="<shell>" close_on_exit=true {
+ *       args "<flag>"… "-c" "<script>" "_" "<cwd>" "KEY=VAL"… "<bin>" "<arg>"…
+ *   }
+ */
+export declare function buildLayoutString(bin: string, args: string[], opts: SpawnOpts): string;
+/**
+ * Map a tmux-style key name to the raw bytes a terminal emits for it. Covers
+ * the names botmux's adapters / worker actually send (Enter, Escape, C-<x>,
+ * M-<x>, arrows, Tab, BSpace, …). Unknown names fall back to the literal string
+ * so a missing mapping degrades to "typed as-is" rather than dropping input.
+ */
+export declare function tmuxKeyToBytes(key: string): string;
+/**
+ * Find the zellij `--server …/<sessionName>` process pid. The session name is
+ * the trailing path component of the server's socket argument, so we match the
+ * cmdline ending in `/<sessionName>`.
+ */
+export declare function findServerPid(sessionName: string): number | null;
+/**
+ * Best-effort CLI pid for the managed pane. With the SHELL_WRAPPER_SCRIPT's
+ * `exec /usr/bin/env "$@"`, the CLI replaces the shell and becomes a direct
+ * child of the zellij server, so the server's lone non-zellij child is the CLI.
+ */
+export declare function findPaneCliPid(sessionName: string, _binBasename: string): number | null;
+//# sourceMappingURL=zellij-backend.d.ts.map

package/dist/adapters/backend/zellij-backend.d.ts.map

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

package/dist/adapters/backend/zellij-backend.js

@@ -0,0 +1,375 @@
+import * as pty from 'node-pty';
+import { execFileSync, spawnSync } from 'node:child_process';
+import { mkdtempSync, writeFileSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { zellijEnv, probeZellijFunctional } from '../../setup/ensure-zellij.js';
+import { resolveUserShell, buildBotmuxEnvAssignments, SHELL_WRAPPER_SCRIPT } from './tmux-backend.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * ZellijBackend — session backend using zellij for process persistence.
+ *
+ * Architecture: pty-under-zellij (the "B route"), the zellij analogue of the
+ * legacy TmuxBackend (pty-under-tmux):
+ *   - A node-pty process runs `zellij --session … --layout-string …` (fresh)
+ *     or `zellij attach …` (reattach). The node-pty is the only zellij client.
+ *   - All output flows through the pty (onData/onExit work unchanged) — we get
+ *     the raw rendered byte stream for free, sidestepping zellij `subscribe`'s
+ *     "whole-viewport-snapshot" model that doesn't fit botmux's xterm pipeline.
+ *   - Input goes through pty.write(). We start zellij in **locked mode with
+ *     keybindings cleared** (generated config), so every byte we write —
+ *     including Ctrl-C, arrows, bracketed-paste markers — passes straight to
+ *     the focused CLI pane with zero keybinding interception (the moral
+ *     equivalent of tmux's single prefix key, but with nothing reserved).
+ *   - resize() is pty.resize(): the attached client's size drives the pane, so
+ *     the headless-default 25-column problem never bites (the pty is the size).
+ *   - kill() only detaches (kills the pty client); the zellij server keeps the
+ *     CLI running, so a daemon restart re-attaches with `zellij attach`.
+ *   - destroySession() runs `zellij delete-session -f` (kill + purge the
+ *     resurrectable corpse) on explicit /close.
+ *
+ * Naming: zellij sessions are named `bmx-<sessionId.slice(0,8)>`, same as tmux.
+ */
+export class ZellijBackend {
+    process = null;
+    sessionName;
+    ownsSession;
+    reattaching = false;
+    configPath = null;
+    tmpConfigDir = null;
+    /** Set by kill()/destroySession() so the pty-client exit they cause (an
+     *  intentional detach/teardown — the zellij session survives) is NOT
+     *  reported as a CLI exit. A real CLI exit leaves this false. */
+    intentionalExit = false;
+    /** Cached CLI pid. The CLI subprocess starts asynchronously after spawn(),
+     *  so the first getChildPid() may be null; once resolved it's stable for the
+     *  session lifetime (single CLI pane → pane exit ends the session). */
+    resolvedCliPid = null;
+    /** Explicit pane target for adopt mode (e.g. "terminal_2"). When null,
+     *  zellij `action` commands address the focused pane — correct for managed
+     *  mode where the single CLI pane is always focused. */
+    paneId;
+    // PtyHandle fields the worker sets (parallel to TmuxBackend / PtyBackend) so
+    // the claude-code adapter can verify submits and follow the session id.
+    claudeJsonlPath;
+    cliPid;
+    cliCwd;
+    constructor(sessionName, opts) {
+        this.sessionName = sessionName;
+        this.ownsSession = opts?.ownsSession ?? true;
+        this.reattaching = opts?.isReattach ?? false;
+        this.paneId = opts?.paneId ?? null;
+    }
+    // ─── Static helpers (mirror TmuxBackend) ──────────────────────────────────
+    static isAvailable() {
+        return probeZellijFunctional().ok;
+    }
+    static sessionName(sessionId) {
+        return `bmx-${sessionId.slice(0, 8)}`;
+    }
+    /** Names of LIVE (non-exited) zellij sessions. A killed-but-serialised
+     *  session lingers in `list-sessions` as "(EXITED - attach to resurrect)";
+     *  we must not treat those as reattachable, so filter them out. */
+    static liveSessions() {
+        try {
+            const out = execFileSync('zellij', ['list-sessions', '--no-formatting'], {
+                encoding: 'utf-8',
+                stdio: ['ignore', 'pipe', 'ignore'],
+                timeout: 3000,
+                env: zellijEnv(),
+            });
+            return out
+                .split('\n')
+                .map(l => l.trim())
+                .filter(l => l.length > 0 && !/EXITED/i.test(l))
+                .map(l => l.split(/\s+/)[0])
+                .filter(Boolean);
+        }
+        catch {
+            return [];
+        }
+    }
+    static hasSession(name) {
+        return ZellijBackend.liveSessions().includes(name);
+    }
+    /** Kill + purge a session (so no resurrectable corpse accumulates). */
+    static killSession(name) {
+        try {
+            spawnSync('zellij', ['delete-session', name, '-f'], { stdio: 'ignore', timeout: 4000, env: zellijEnv() });
+        }
+        catch { /* doesn't exist */ }
+    }
+    static listBotmuxSessions() {
+        return ZellijBackend.liveSessions().filter(s => s.startsWith('bmx-'));
+    }
+    // ─── SessionBackend implementation ────────────────────────────────────────
+    spawn(bin, args, opts) {
+        // Reattach if the session is already live (daemon restarted, CLI survived).
+        this.reattaching = this.reattaching || ZellijBackend.hasSession(this.sessionName);
+        logger.debug(`[zellij:${this.sessionName}] spawn ${this.reattaching ? 'reattach' : 'new'} ` +
+            `bin=${bin} args=${JSON.stringify(args)} cwd=${opts.cwd} ${opts.cols}x${opts.rows}`);
+        const { configPath, layoutPath } = this.writeRuntimeFiles(bin, args, opts);
+        this.configPath = configPath;
+        const childEnv = zellijEnv(opts.env);
+        // Fresh: `--new-session-with-layout <file>` FORCES a new named session with
+        // our layout (plain `--session … --layout-string` instead ATTACHES to the
+        // name and errors "no active session"). Reattach: `attach <name>` rejoins
+        // the surviving session (daemon restarted, CLI still running inside).
+        const zellijArgs = this.reattaching
+            ? ['--config', configPath, 'attach', this.sessionName]
+            : ['--config', configPath, '--session', this.sessionName,
+                '--new-session-with-layout', layoutPath];
+        this.process = pty.spawn('zellij', zellijArgs, {
+            name: 'xterm-256color',
+            cols: opts.cols,
+            rows: opts.rows,
+            cwd: opts.cwd,
+            env: childEnv,
+        });
+    }
+    /** Write the per-session config (locked mode + cleared keybinds so pty.write
+     *  passes through untouched, no startup tips / pane frames) and, for a fresh
+     *  spawn, the single-pane layout file. Both live in one temp dir cleaned on
+     *  kill(). On reattach the layout file is unused but harmless. */
+    writeRuntimeFiles(bin, args, opts) {
+        this.tmpConfigDir = mkdtempSync(join(tmpdir(), 'bmx-zellij-'));
+        const configPath = join(this.tmpConfigDir, 'config.kdl');
+        const layoutPath = join(this.tmpConfigDir, 'layout.kdl');
+        writeFileSync(configPath, ZELLIJ_CONFIG_KDL);
+        if (!this.reattaching)
+            writeFileSync(layoutPath, buildLayoutString(bin, args, opts));
+        return { configPath, layoutPath };
+    }
+    get isReattach() {
+        return this.reattaching;
+    }
+    // ── Input ──
+    // In locked mode with cleared keybinds, raw bytes written to the client pty
+    // are forwarded verbatim to the focused pane — so every input path collapses
+    // to pty.write(), exactly like TmuxBackend.write().
+    write(data) {
+        this.process?.write(data);
+    }
+    /** Literal text, no Enter. */
+    sendText(text) {
+        this.process?.write(text);
+    }
+    /** Special keys by tmux-style name (Enter, Escape, C-c, M-Enter, …). */
+    sendSpecialKeys(...keys) {
+        for (const key of keys) {
+            this.process?.write(tmuxKeyToBytes(key));
+        }
+    }
+    /** Bracketed paste: wrap with \e[200~ … \e[201~ so TUIs (CoCo/Ink/Codex)
+     *  detect the paste boundary and don't treat embedded \n as Enter. Mirrors
+     *  `tmux paste-buffer -p`. */
+    pasteText(text) {
+        this.process?.write(`\x1b[200~${text}\x1b[201~`);
+    }
+    resize(cols, rows) {
+        this.process?.resize(cols, rows);
+    }
+    /** Must be called AFTER spawn(). */
+    onData(cb) {
+        this.process?.onData(cb);
+    }
+    /** Must be called AFTER spawn(). */
+    onExit(cb) {
+        this.process?.onExit(({ exitCode, signal }) => {
+            // Suppress the pty-client exit caused by our own kill()/destroySession()
+            // (intentional detach/teardown — the zellij session survives, so a
+            // claude_exit here would falsely tear the worker down on restart). A real
+            // CLI exit (pane closes → single-pane session ends) leaves intentionalExit
+            // false and is forwarded. Mirrors TmuxPipeBackend's intentional-detach
+            // semantics (pty-under TmuxBackend lacked this — the gap Codex flagged).
+            if (this.intentionalExit)
+                return;
+            cb(exitCode, signal !== undefined ? String(signal) : null);
+        });
+    }
+    /** CLI pid. May be null immediately after spawn() (the CLI subprocess starts
+     *  asynchronously); the worker retries. Cached once resolved. */
+    getChildPid() {
+        if (this.resolvedCliPid !== null)
+            return this.resolvedCliPid;
+        this.resolvedCliPid = findPaneCliPid(this.sessionName, '');
+        return this.resolvedCliPid;
+    }
+    /** Detach only — kills the pty client, leaves the zellij session running. */
+    kill() {
+        this.intentionalExit = true;
+        if (this.process) {
+            try {
+                this.process.kill();
+            }
+            catch { /* already dead */ }
+            this.process = null;
+        }
+        this.cleanupConfig();
+    }
+    /** Kill the zellij session permanently (explicit /close). */
+    destroySession() {
+        this.kill();
+        if (this.ownsSession) {
+            ZellijBackend.killSession(this.sessionName);
+        }
+    }
+    cleanupConfig() {
+        if (this.tmpConfigDir) {
+            try {
+                rmSync(this.tmpConfigDir, { recursive: true, force: true });
+            }
+            catch { /* benign */ }
+            this.tmpConfigDir = null;
+            this.configPath = null;
+        }
+    }
+}
+// ─── Pure helpers (unit-testable) ───────────────────────────────────────────
+/**
+ * Locked mode + cleared keybinds => the client pty forwards every byte to the
+ * focused pane with no zellij interception. No startup tips / pane frames so
+ * the captured stream is just the CLI (we don't need to hide chrome, but a
+ * clean single pane keeps screenshots faithful and the renderer simple).
+ */
+export const ZELLIJ_CONFIG_KDL = `// botmux-generated — do not edit
+show_startup_tips false
+pane_frames false
+default_mode "locked"
+keybinds clear-defaults=true {
+}
+`;
+/** Escape a string for a KDL double-quoted value. */
+export function kdlString(s) {
+    return `"${s.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+}
+/**
+ * Build the `--layout-string` KDL: a single full-screen pane that execs the CLI
+ * through the user's shell (same wrapper TmuxBackend uses, so PATH / NVM / pnpm
+ * / mise shims load from rcfiles). Command + args go in via execvp semantics —
+ * no shell-quoting needed (KDL strings carry spaces/quotes), only KDL escaping.
+ *
+ *   pane command="<shell>" close_on_exit=true {
+ *       args "<flag>"… "-c" "<script>" "_" "<cwd>" "KEY=VAL"… "<bin>" "<arg>"…
+ *   }
+ */
+export function buildLayoutString(bin, args, opts) {
+    const shellSpec = resolveUserShell();
+    const envAssignments = buildBotmuxEnvAssignments(opts.env);
+    const paneArgs = [
+        ...shellSpec.flags, '-c', SHELL_WRAPPER_SCRIPT, '_',
+        opts.cwd,
+        ...envAssignments,
+        bin, ...args,
+    ];
+    const argsKdl = paneArgs.map(kdlString).join(' ');
+    return [
+        'layout {',
+        `    pane command=${kdlString(shellSpec.shell)} close_on_exit=true {`,
+        `        args ${argsKdl}`,
+        '    }',
+        '}',
+    ].join('\n');
+}
+/**
+ * Map a tmux-style key name to the raw bytes a terminal emits for it. Covers
+ * the names botmux's adapters / worker actually send (Enter, Escape, C-<x>,
+ * M-<x>, arrows, Tab, BSpace, …). Unknown names fall back to the literal string
+ * so a missing mapping degrades to "typed as-is" rather than dropping input.
+ */
+export function tmuxKeyToBytes(key) {
+    const named = {
+        Enter: '\r',
+        Tab: '\t',
+        Escape: '\x1b',
+        Esc: '\x1b',
+        Space: ' ',
+        BSpace: '\x7f',
+        Backspace: '\x7f',
+        Up: '\x1b[A',
+        Down: '\x1b[B',
+        Right: '\x1b[C',
+        Left: '\x1b[D',
+        Home: '\x1b[H',
+        End: '\x1b[F',
+        PageUp: '\x1b[5~',
+        PageDown: '\x1b[6~',
+        'M-Enter': '\x1b\r',
+    };
+    if (key in named)
+        return named[key];
+    // C-<x>: control byte. C-a..C-z → 0x01..0x1a; C-c → ETX (0x03), etc.
+    const ctrl = key.match(/^C-([A-Za-z])$/);
+    if (ctrl) {
+        const c = ctrl[1].toLowerCase().charCodeAt(0) - 96; // 'a' -> 1
+        return String.fromCharCode(c);
+    }
+    // M-<x>: ESC prefix (Alt).
+    const meta = key.match(/^M-(.)$/);
+    if (meta)
+        return `\x1b${meta[1]}`;
+    // Unknown: best-effort literal.
+    return key;
+}
+/**
+ * Find the zellij `--server …/<sessionName>` process pid. The session name is
+ * the trailing path component of the server's socket argument, so we match the
+ * cmdline ending in `/<sessionName>`.
+ */
+export function findServerPid(sessionName) {
+    try {
+        const out = execFileSync('ps', ['-eo', 'pid=,args='], {
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            timeout: 3000,
+            env: zellijEnv(),
+        });
+        for (const line of out.split('\n')) {
+            const m = line.trim().match(/^(\d+)\s+(.*)$/);
+            if (!m)
+                continue;
+            const argv = m[2];
+            if (/zellij\b.*--server\b/.test(argv) && new RegExp(`/${escapeRe(sessionName)}$`).test(argv.trim())) {
+                return Number(m[1]);
+            }
+        }
+    }
+    catch { /* ps unavailable */ }
+    return null;
+}
+/**
+ * Best-effort CLI pid for the managed pane. With the SHELL_WRAPPER_SCRIPT's
+ * `exec /usr/bin/env "$@"`, the CLI replaces the shell and becomes a direct
+ * child of the zellij server, so the server's lone non-zellij child is the CLI.
+ */
+export function findPaneCliPid(sessionName, _binBasename) {
+    const server = findServerPid(sessionName);
+    if (!server)
+        return null;
+    try {
+        const out = execFileSync('ps', ['-eo', 'pid=,ppid=,comm='], {
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            timeout: 3000,
+            env: zellijEnv(),
+        });
+        const children = [];
+        for (const line of out.split('\n')) {
+            const m = line.trim().match(/^(\d+)\s+(\d+)\s+(.*)$/);
+            if (!m)
+                continue;
+            const [pid, ppid, comm] = [Number(m[1]), Number(m[2]), m[3]];
+            if (ppid === server && comm !== 'zellij')
+                children.push(pid);
+        }
+        // Single CLI pane → exactly one such child.
+        return children.length > 0 ? children[0] : null;
+    }
+    catch {
+        return null;
+    }
+}
+function escapeRe(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=zellij-backend.js.map

package/dist/adapters/backend/zellij-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zellij-backend.js","sourceRoot":"","sources":["../../../src/adapters/backend/zellij-backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACtG,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,aAAa;IAChB,OAAO,GAAoB,IAAI,CAAC;IACvB,WAAW,CAAS;IACpB,WAAW,CAAU;IAC9B,WAAW,GAAG,KAAK,CAAC;IACpB,UAAU,GAAkB,IAAI,CAAC;IACjC,YAAY,GAAkB,IAAI,CAAC;IAC3C;;qEAEiE;IACzD,eAAe,GAAG,KAAK,CAAC;IAChC;;2EAEuE;IAC/D,cAAc,GAAkB,IAAI,CAAC;IAC7C;;4DAEwD;IACvC,MAAM,CAAgB;IAEvC,6EAA6E;IAC7E,wEAAwE;IACxE,eAAe,CAAU;IACzB,MAAM,CAAU;IAChB,MAAM,CAAU;IAEhB,YAAY,WAAmB,EAAE,IAAuE;QACtG,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,IAAI,CAAC;QAC7C,IAAI,CAAC,WAAW,GAAG,IAAI,EAAE,UAAU,IAAI,KAAK,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,IAAI,CAAC;IACrC,CAAC;IAED,6EAA6E;IAE7E,MAAM,CAAC,WAAW;QAChB,OAAO,qBAAqB,EAAE,CAAC,EAAE,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,SAAiB;QAClC,OAAO,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACxC,CAAC;IAED;;uEAEmE;IACnE,MAAM,CAAC,YAAY;QACjB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC,eAAe,EAAE,iBAAiB,CAAC,EAAE;gBACvE,QAAQ,EAAE,OAAO;gBACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;gBACnC,OAAO,EAAE,IAAI;gBACb,GAAG,EAAE,SAAS,EAAE;aACjB,CAAC,CAAC;YACH,OAAO,GAAG;iBACP,KAAK,CAAC,IAAI,CAAC;iBACX,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;iBAClB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;iBAC/C,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,CAAC;iBAC5B,MAAM,CAAC,OAAO,CAAC,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,IAAY;QAC5B,OAAO,aAAa,CAAC,YAAY,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,uEAAuE;IACvE,MAAM,CAAC,WAAW,CAAC,IAAY;QAC7B,IAAI,CAAC;YACH,SAAS,CAAC,QAAQ,EAAE,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QAC5G,CAAC;QAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,kBAAkB;QACvB,OAAO,aAAa,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,6EAA6E;IAE7E,KAAK,CAAC,GAAW,EAAE,IAAc,EAAE,IAAe;QAChD,4EAA4E;QAC5E,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAClF,MAAM,CAAC,KAAK,CACV,WAAW,IAAI,CAAC,WAAW,WAAW,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG;YAC9E,OAAO,GAAG,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CACpF,CAAC;QAEF,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC3E,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAErC,4EAA4E;QAC5E,0EAA0E;QAC1E,0EAA0E;QAC1E,sEAAsE;QACtE,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW;YACjC,CAAC,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC;YACtD,CAAC,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW;gBACrD,2BAA2B,EAAE,UAAU,CAAC,CAAC;QAE9C,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,EAAE;YAC7C,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,GAAG,EAAE,QAAQ;SACd,CAAC,CAAC;IACL,CAAC;IAED;;;sEAGkE;IAC1D,iBAAiB,CAAC,GAAW,EAAE,IAAc,EAAE,IAAe;QACpE,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;QAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QACzD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QACzD,aAAa,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,aAAa,CAAC,UAAU,EAAE,iBAAiB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACrF,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;IACpC,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,cAAc;IACd,4EAA4E;IAC5E,6EAA6E;IAC7E,oDAAoD;IAEpD,KAAK,CAAC,IAAY;QAChB,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,8BAA8B;IAC9B,QAAQ,CAAC,IAAY;QACnB,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,wEAAwE;IACxE,eAAe,CAAC,GAAG,IAAc;QAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED;;kCAE8B;IAC9B,SAAS,CAAC,IAAY;QACpB,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,YAAY,IAAI,WAAW,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,IAAY;QAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,oCAAoC;IACpC,MAAM,CAAC,EAA0B;QAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,oCAAoC;IACpC,MAAM,CAAC,EAAwD;QAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;YAC5C,yEAAyE;YACzE,mEAAmE;YACnE,0EAA0E;YAC1E,2EAA2E;YAC3E,uEAAuE;YACvE,yEAAyE;YACzE,IAAI,IAAI,CAAC,eAAe;gBAAE,OAAO;YACjC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC;IAED;qEACiE;IACjE,WAAW;QACT,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,cAAc,CAAC;QAC7D,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,6EAA6E;IAC7E,IAAI;QACF,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC;gBAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;YACzD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED,6DAA6D;IAC7D,cAAc;QACZ,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAEO,aAAa;QACnB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC;gBAAC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YAC3F,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YACzB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;IACH,CAAC;CACF;AAED,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;CAMhC,CAAC;AAEF,qDAAqD;AACrD,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;AAC9D,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,IAAc,EAAE,IAAe;IAC5E,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;IACrC,MAAM,cAAc,GAAG,yBAAyB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG;QACf,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE,GAAG;QACnD,IAAI,CAAC,GAAG;QACR,GAAG,cAAc;QACjB,GAAG,EAAE,GAAG,IAAI;KACb,CAAC;IACF,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClD,OAAO;QACL,UAAU;QACV,oBAAoB,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,uBAAuB;QACrE,gBAAgB,OAAO,EAAE;QACzB,OAAO;QACP,GAAG;KACJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,KAAK,GAA2B;QACpC,KAAK,EAAE,IAAI;QACX,GAAG,EAAE,IAAI;QACT,MAAM,EAAE,MAAM;QACd,GAAG,EAAE,MAAM;QACX,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,MAAM;QACd,SAAS,EAAE,MAAM;QACjB,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE,QAAQ;QACb,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,QAAQ;KACpB,CAAC;IACF,IAAI,GAAG,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,GAAG,CAAE,CAAC;IAErC,qEAAqE;IACrE,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACzC,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW;QAChE,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IACD,2BAA2B;IAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAClC,IAAI,IAAI;QAAE,OAAO,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAElC,gCAAgC;IAChC,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,EAAE;YACpD,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;YACnC,OAAO,EAAE,IAAI;YACb,GAAG,EAAE,SAAS,EAAE;SACjB,CAAC,CAAC;QACH,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;YAC9C,IAAI,CAAC,CAAC;gBAAE,SAAS;YACjB,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;YACnB,IAAI,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;gBACpG,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAChC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,WAAmB,EAAE,YAAoB;IACtE,MAAM,MAAM,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,EAAE;YAC1D,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;YACnC,OAAO,EAAE,IAAI;YACb,GAAG,EAAE,SAAS,EAAE;SACjB,CAAC,CAAC;QACH,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;YACtD,IAAI,CAAC,CAAC;gBAAE,SAAS;YACjB,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;YAC9D,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,QAAQ;gBAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/D,CAAC;QACD,4CAA4C;QAC5C,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS;IACzB,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC"}

package/dist/adapters/backend/zellij-observe-backend.d.ts

@@ -0,0 +1,62 @@
+import type { ObserveBackend, SpawnOpts } from './types.js';
+export declare class ZellijObserveBackend implements ObserveBackend {
+    private readonly session;
+    private readonly paneId;
+    private readonly cliPid;
+    private cols;
+    private rows;
+    private dataCbs;
+    private exitCbs;
+    private pollTimer;
+    private livenessTimer;
+    private lastSnapshot;
+    private exited;
+    claudeJsonlPath?: string;
+    cliCwd?: string;
+    constructor(session: string, paneId: string, opts?: {
+        cliPid?: number;
+    });
+    /** bin/args are ignored — we observe an existing pane, we don't launch. */
+    spawn(_bin: string, _args: string[], opts: SpawnOpts): void;
+    private poll;
+    private checkLiveness;
+    /** Whether the adopted CLI process is still running. Unknown pid → defer to
+     *  pane liveness only. EPERM (exists, not ours) counts as alive; ESRCH = gone. */
+    private isCliPidAlive;
+    private handlePaneExit;
+    write(data: string): void;
+    /** Literal text via write-chars (preserves UTF-8). */
+    sendText(text: string): void;
+    /** Special keys by tmux-style name → raw bytes → `action write`. */
+    sendSpecialKeys(...keys: string[]): void;
+    /** Bracketed paste — wrap so TUIs detect the boundary (mirrors paste-buffer -p). */
+    pasteText(text: string): void;
+    /** Write arbitrary bytes via `action write <decimal>…` (handles control/escape).
+     *  Chunked so a large web-terminal paste can't blow the argv limit; zellij
+     *  serialises the writes in arrival order. */
+    private writeBytes;
+    /** Resize is a NO-OP in observe mode — the pane size is the user's, and
+     *  resizing it would disturb their layout. The transient snapshot reads the
+     *  real pane size via getPaneSize(). */
+    resize(_cols: number, _rows: number): void;
+    onData(cb: (data: string) => void): void;
+    onExit(cb: (code: number | null, signal: string | null) => void): void;
+    getChildPid(): number | null;
+    /** Detach observer — stop polling. Never touches the user's zellij session. */
+    kill(): void;
+    /** Adopt owns nothing — destroy == detach (don't kill the user's session). */
+    destroySession(): void;
+    private stopTimers;
+    captureCurrentScreen(): string;
+    captureViewport(): string;
+    getPaneSize(): {
+        cols: number;
+        rows: number;
+    } | null;
+    isPaneAlive(): boolean;
+    private dumpScreen;
+    private listPane;
+    /** Run a `zellij --session S action …`, returning stdout or null on failure. */
+    private action;
+}
+//# sourceMappingURL=zellij-observe-backend.d.ts.map

package/dist/adapters/backend/zellij-observe-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zellij-observe-backend.d.ts","sourceRoot":"","sources":["../../../src/adapters/backend/zellij-observe-backend.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAiC5D,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAS;IAErB,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,OAAO,CAAmE;IAClF,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,aAAa,CAA+C;IACpE,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,MAAM,CAAS;IAGvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEJ,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAUvE,2EAA2E;IAC3E,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAQ3D,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,aAAa;IAUrB;sFACkF;IAClF,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,cAAc;IAStB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIzB,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK5B,oEAAoE;IACpE,eAAe,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAIxC,oFAAoF;IACpF,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM7B;;kDAE8C;IAC9C,OAAO,CAAC,UAAU;IAUlB;;4CAEwC;IACxC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAE1C,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IACxC,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI;IAEtE,WAAW,IAAI,MAAM,GAAG,IAAI;IAE5B,+EAA+E;IAC/E,IAAI,IAAI,IAAI;IAEZ,8EAA8E;IAC9E,cAAc,IAAI,IAAI;IAEtB,OAAO,CAAC,UAAU;IAOlB,oBAAoB,IAAI,MAAM;IAI9B,eAAe,IAAI,MAAM;IAIzB,WAAW,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IASpD,WAAW,IAAI,OAAO;IAOtB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,QAAQ;IAahB,gFAAgF;IAChF,OAAO,CAAC,MAAM;CAUf"}