@elhu/pit 0.1.1

package/dist/state-machine.d.ts

@@ -0,0 +1,74 @@
+/**
+ * EpicStateMachine — per-epic state management for pit.
+ *
+ * Manages the SETUP → RUNNING → CLEARING → PAUSED / DONE lifecycle.
+ * All transitions are serialized through a per-epic mutex (via a promise chain)
+ * to prevent races between concurrent signal events and CLI commands.
+ *
+ * State transitions:
+ *   SETUP    → RUNNING  (initial prompt sent)
+ *   RUNNING  → CLEARING (TICKET_COMPLETE signal)
+ *   RUNNING  → PAUSED   (NEEDS_HUMAN_INPUT / permission / unrecognized idle / ticket timeout)
+ *   RUNNING  → DONE     (EPIC_COMPLETE signal)
+ *   RUNNING  → PAUSED   (manual pit pause)
+ *   CLEARING → RUNNING  (/clear + re-prompt sent)
+ *   CLEARING → PAUSED   (CLEARING pipeline failed)
+ *   PAUSED   → CLEARING (pit resume, no message)
+ *   PAUSED   → RUNNING  (pit resume --message)
+ */
+export type MachineState = "SETUP" | "RUNNING" | "CLEARING" | "PAUSED" | "DONE";
+export type TransitionReason = "TUI_READY" | "TICKET_COMPLETE" | "EPIC_COMPLETE" | "NEEDS_HUMAN_INPUT" | "PERMISSION_ASKED" | "UNRECOGNIZED_IDLE" | "CLEARED" | "MANUAL_PAUSE" | "RESUME_NO_MESSAGE" | "RESUME_WITH_MESSAGE" | "MANUAL_STOP" | "TICKET_TIMEOUT";
+export interface StateTransition {
+    from: MachineState;
+    to: MachineState;
+    reason: TransitionReason;
+    pauseReason?: string;
+    timestamp: string;
+}
+export interface EpicStateMachineOptions {
+    epic: string;
+    onTransition?: (transition: StateTransition) => void;
+    initialState?: MachineState;
+    initialPauseReason?: string | null;
+}
+/**
+ * Error thrown when a state transition is invalid for the current state.
+ */
+export declare class InvalidTransitionError extends Error {
+    readonly from: MachineState;
+    readonly to: MachineState;
+    readonly reason: TransitionReason;
+    constructor(from: MachineState, to: MachineState, reason: TransitionReason);
+}
+export declare class EpicStateMachine {
+    private _state;
+    private _pauseReason;
+    private readonly epic;
+    private readonly onTransition?;
+    private mutexTail;
+    constructor(options: EpicStateMachineOptions);
+    /** The current state of this epic. */
+    get state(): MachineState;
+    /** The reason the epic is paused, if state is PAUSED. */
+    get pauseReason(): string | null;
+    /**
+     * Attempt a state transition, serialized through the mutex.
+     *
+     * @param to        Target state
+     * @param reason    Why this transition is happening
+     * @param opts      Optional extra data (e.g. pauseReason for PAUSED transitions)
+     * @throws InvalidTransitionError if the transition is not valid from the current state
+     */
+    transition(to: MachineState, reason: TransitionReason, opts?: {
+        pauseReason?: string;
+    }): Promise<void>;
+    /**
+     * Execute a function while holding the mutex.
+     * The function receives the current state and can call transition() inside.
+     * Useful for compound operations that need to read + transition atomically.
+     */
+    withLock<T>(fn: (state: MachineState) => Promise<T>): Promise<T>;
+    private _applyTransition;
+    private _validateTransition;
+}
+//# sourceMappingURL=state-machine.d.ts.map

package/dist/state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../src/state-machine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEhF,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,iBAAiB,GACjB,eAAe,GACf,mBAAmB,GACnB,kBAAkB,GAClB,mBAAmB,GACnB,SAAS,GACT,cAAc,GACd,mBAAmB,GACnB,qBAAqB,GACrB,aAAa,GACb,gBAAgB,CAAC;AAErB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,YAAY,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,eAAe,KAAK,IAAI,CAAC;IACrD,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;aAE7B,IAAI,EAAE,YAAY;aAClB,EAAE,EAAE,YAAY;aAChB,MAAM,EAAE,gBAAgB;gBAFxB,IAAI,EAAE,YAAY,EAClB,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,gBAAgB;CAK3C;AAmBD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAwC;IAGtE,OAAO,CAAC,SAAS,CAAoC;gBAEzC,OAAO,EAAE,uBAAuB;IAO5C,sCAAsC;IACtC,IAAI,KAAK,IAAI,YAAY,CAExB;IAED,yDAAyD;IACzD,IAAI,WAAW,IAAI,MAAM,GAAG,IAAI,CAE/B;IAED;;;;;;;OAOG;IACG,UAAU,CACd,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,gBAAgB,EACxB,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9B,OAAO,CAAC,IAAI,CAAC;IAkBhB;;;;OAIG;IACG,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAetE,OAAO,CAAC,gBAAgB;IA0BxB,OAAO,CAAC,mBAAmB;CAW5B"}

package/dist/state-machine.js

@@ -0,0 +1,153 @@
+/**
+ * EpicStateMachine — per-epic state management for pit.
+ *
+ * Manages the SETUP → RUNNING → CLEARING → PAUSED / DONE lifecycle.
+ * All transitions are serialized through a per-epic mutex (via a promise chain)
+ * to prevent races between concurrent signal events and CLI commands.
+ *
+ * State transitions:
+ *   SETUP    → RUNNING  (initial prompt sent)
+ *   RUNNING  → CLEARING (TICKET_COMPLETE signal)
+ *   RUNNING  → PAUSED   (NEEDS_HUMAN_INPUT / permission / unrecognized idle / ticket timeout)
+ *   RUNNING  → DONE     (EPIC_COMPLETE signal)
+ *   RUNNING  → PAUSED   (manual pit pause)
+ *   CLEARING → RUNNING  (/clear + re-prompt sent)
+ *   CLEARING → PAUSED   (CLEARING pipeline failed)
+ *   PAUSED   → CLEARING (pit resume, no message)
+ *   PAUSED   → RUNNING  (pit resume --message)
+ */
+/**
+ * Error thrown when a state transition is invalid for the current state.
+ */
+export class InvalidTransitionError extends Error {
+    from;
+    to;
+    reason;
+    constructor(from, to, reason) {
+        super(`Invalid transition from ${from} to ${to} (reason: ${reason})`);
+        this.from = from;
+        this.to = to;
+        this.reason = reason;
+        this.name = "InvalidTransitionError";
+    }
+}
+/**
+ * Per-epic state machine.
+ *
+ * State is stored in memory. Signal files are the persistent store; this
+ * class manages the in-memory representation and serializes transitions.
+ *
+ * Usage:
+ *   const sm = new EpicStateMachine({ epic: "auth" });
+ *   await sm.transition("RUNNING", "TUI_READY");
+ *   // later:
+ *   await sm.transition("CLEARING", "TICKET_COMPLETE");
+ */
+/** Silently swallow a rejected promise — used to keep mutex tail alive. */
+function _swallow(_err) {
+    // intentionally empty
+}
+export class EpicStateMachine {
+    _state;
+    _pauseReason;
+    epic;
+    onTransition;
+    // Mutex: a promise chain that serializes transitions
+    mutexTail = Promise.resolve();
+    constructor(options) {
+        this.epic = options.epic;
+        this.onTransition = options.onTransition;
+        this._state = options.initialState ?? "SETUP";
+        this._pauseReason = options.initialPauseReason ?? null;
+    }
+    /** The current state of this epic. */
+    get state() {
+        return this._state;
+    }
+    /** The reason the epic is paused, if state is PAUSED. */
+    get pauseReason() {
+        return this._pauseReason;
+    }
+    /**
+     * Attempt a state transition, serialized through the mutex.
+     *
+     * @param to        Target state
+     * @param reason    Why this transition is happening
+     * @param opts      Optional extra data (e.g. pauseReason for PAUSED transitions)
+     * @throws InvalidTransitionError if the transition is not valid from the current state
+     */
+    async transition(to, reason, opts) {
+        // Enqueue onto mutex tail, catching to avoid unhandled rejection on the outer tail
+        const work = () => new Promise((resolve, reject) => {
+            try {
+                this._applyTransition(to, reason, opts);
+                resolve();
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+        // Chain: wait for previous work, then do ours
+        const next = this.mutexTail.then(work, work); // run even if previous failed
+        this.mutexTail = next.catch(_swallow); // swallow on tail to keep chain alive
+        return next; // caller gets the real error
+    }
+    /**
+     * Execute a function while holding the mutex.
+     * The function receives the current state and can call transition() inside.
+     * Useful for compound operations that need to read + transition atomically.
+     */
+    async withLock(fn) {
+        let result;
+        const work = async () => {
+            result = await fn(this._state);
+        };
+        const next = this.mutexTail.then(work);
+        this.mutexTail = next.catch(_swallow);
+        await next;
+        return result;
+    }
+    // ---------------------------------------------------------------------------
+    // Private
+    // ---------------------------------------------------------------------------
+    _applyTransition(to, reason, opts) {
+        const from = this._state;
+        this._validateTransition(from, to, reason);
+        this._state = to;
+        if (to === "PAUSED") {
+            this._pauseReason = opts?.pauseReason ?? null;
+        }
+        else {
+            this._pauseReason = null;
+        }
+        const transition = {
+            from,
+            to,
+            reason,
+            pauseReason: to === "PAUSED" ? (opts?.pauseReason ?? undefined) : undefined,
+            timestamp: new Date().toISOString(),
+        };
+        this.onTransition?.(transition);
+    }
+    _validateTransition(from, to, reason) {
+        // Build a set of allowed (from, to) pairs
+        const valid = VALID_TRANSITIONS.some((t) => t.from === from && t.to === to);
+        if (!valid) {
+            throw new InvalidTransitionError(from, to, reason);
+        }
+    }
+}
+const VALID_TRANSITIONS = [
+    { from: "SETUP", to: "RUNNING" }, // TUI ready → send initial prompt
+    { from: "RUNNING", to: "CLEARING" }, // TICKET_COMPLETE
+    { from: "RUNNING", to: "PAUSED" }, // NEEDS_HUMAN_INPUT / permission / manual pause / unrecognized idle
+    { from: "RUNNING", to: "DONE" }, // EPIC_COMPLETE
+    { from: "CLEARING", to: "RUNNING" }, // /clear + re-prompt sent
+    { from: "CLEARING", to: "PAUSED" }, // CLEARING pipeline failed
+    { from: "PAUSED", to: "CLEARING" }, // pit resume (no message)
+    { from: "PAUSED", to: "RUNNING" }, // pit resume --message
+    { from: "SETUP", to: "DONE" }, // MANUAL_STOP from setup
+    { from: "PAUSED", to: "DONE" }, // MANUAL_STOP from paused
+    { from: "CLEARING", to: "DONE" }, // MANUAL_STOP from clearing
+];
+//# sourceMappingURL=state-machine.js.map

package/dist/state-machine.js.map

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

package/dist/tmux.d.ts

@@ -0,0 +1,101 @@
+/**
+ * tmux helpers for pit.
+ *
+ * All tmux operations shell out to the `tmux` CLI via execTmux().
+ * TmuxError captures the exit code, stderr, and original args for debugging.
+ */
+export declare class TmuxError extends Error {
+    readonly exitCode: number | null;
+    readonly stderr: string;
+    readonly args: string[];
+    constructor(message: string, exitCode: number | null, stderr: string, args: string[]);
+}
+/**
+ * Internal helper: run tmux with the given args.
+ * Throws TmuxError on non-zero exit or if tmux is not installed.
+ */
+export declare function execTmux(...args: string[]): Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+/**
+ * Returns true if the named tmux session exists, false otherwise.
+ * Never throws for "session not found" — that is a valid false result.
+ */
+export declare function sessionExists(name: string): Promise<boolean>;
+/**
+ * Creates a new detached tmux session with the given name.
+ * Throws if the session already exists or tmux is unavailable.
+ */
+export declare function createSession(name: string): Promise<void>;
+/**
+ * Kills the named tmux session.
+ * Throws if the session does not exist or cannot be killed.
+ */
+export declare function killSession(name: string): Promise<void>;
+/**
+ * Creates a new window in the given session with the given name and working directory.
+ * Optionally sets per-window environment variables via the `-e` flag on `new-window`
+ * (NOT session-scoped `set-environment`) so each window gets its own env.
+ * Throws if the session does not exist.
+ */
+export declare function createWindow(session: string, name: string, cwd: string, env?: Record<string, string>): Promise<void>;
+/**
+ * Returns true if a window with the given name exists in the given session.
+ * Returns false if the session or window does not exist — never throws for
+ * missing session/window.
+ */
+export declare function windowExists(session: string, name: string): Promise<boolean>;
+/**
+ * Returns the list of window names in the given session.
+ * Returns an empty array if the session does not exist — never throws.
+ */
+export declare function getWindowList(session: string): Promise<string[]>;
+/**
+ * Returns the name of the first window (index 0) in the given session.
+ * Returns null if the session does not exist or has no windows.
+ * Never throws.
+ */
+export declare function getFirstWindowName(session: string): Promise<string | null>;
+/**
+ * Kills the named window in the given session.
+ * Throws if the window does not exist.
+ */
+export declare function killWindow(session: string, name: string): Promise<void>;
+/**
+ * Sends keys to a window in the given session.
+ * Fire-and-forget: there is no confirmation of delivery.
+ * The `--` separator prevents tmux from interpreting the keys string as flags.
+ * When autoSubmit is true, `Enter` is sent after typing to submit the input.
+ */
+export declare function sendKeys(session: string, window: string, keys: string, autoSubmit?: boolean): Promise<void>;
+/**
+ * Send a prompt to the agent by sending the text and Enter in separate calls.
+ * This is more reliable than sending them together, especially for OpenCode.
+ */
+export declare function sendPrompt(session: string, window: string, prompt: string): Promise<void>;
+/**
+ * Send a clear command to OpenCode by sending the command and Enter in separate calls.
+ * This prevents the "/" from triggering the agent selector instead of being a command.
+ */
+export declare function sendClearCommand(session: string, window: string, clearCommand: string): Promise<void>;
+/**
+ * Captures the pane output of a window in the given session.
+ * Defaults to the last 50 lines with ANSI escape codes stripped.
+ */
+export declare function capturePane(session: string, window: string, options?: {
+    lines?: number;
+    stripAnsi?: boolean;
+}): Promise<string>;
+/**
+ * Sends a BEL character (ASCII 7) to a window in the given session.
+ * Used to notify the human that attention is needed.
+ */
+export declare function sendBell(session: string, window: string): Promise<void>;
+/**
+ * Sets a tmux user option (prefixed with `@`) on the given session.
+ * User options are used for status bar content and other metadata.
+ * Example: setUserOption(session, "pit-status", "[auth: running 5/12]")
+ */
+export declare function setUserOption(session: string, key: string, value: string): Promise<void>;
+//# sourceMappingURL=tmux.d.ts.map

package/dist/tmux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux.d.ts","sourceRoot":"","sources":["../src/tmux.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,qBAAa,SAAU,SAAQ,KAAK;aAGhB,QAAQ,EAAE,MAAM,GAAG,IAAI;aACvB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,MAAM,EAAE;gBAH9B,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAAE;CAKjC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBvF;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWlE;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/D;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7D;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAelF;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAatE;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGhF;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7E;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,UAAU,UAAO,GAChB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO/F;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAOf;AAOD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAChD,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7E;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9F"}

package/dist/tmux.js

@@ -0,0 +1,208 @@
+/**
+ * tmux helpers for pit.
+ *
+ * All tmux operations shell out to the `tmux` CLI via execTmux().
+ * TmuxError captures the exit code, stderr, and original args for debugging.
+ */
+import { execFile } from "node:child_process";
+export class TmuxError extends Error {
+    exitCode;
+    stderr;
+    args;
+    constructor(message, exitCode, stderr, args) {
+        super(message);
+        this.exitCode = exitCode;
+        this.stderr = stderr;
+        this.args = args;
+        this.name = "TmuxError";
+    }
+}
+/**
+ * Internal helper: run tmux with the given args.
+ * Throws TmuxError on non-zero exit or if tmux is not installed.
+ */
+export function execTmux(...args) {
+    return new Promise((resolve, reject) => {
+        execFile("tmux", args, (error, stdout, stderr) => {
+            if (error) {
+                if (error.code === "ENOENT") {
+                    reject(new TmuxError("tmux is not installed or not in PATH", null, "", args));
+                    return;
+                }
+                reject(new TmuxError(`tmux exited with code ${error.code ?? "unknown"}: ${stderr.trim()}`, typeof error.code === "number" ? error.code : null, stderr, args));
+                return;
+            }
+            resolve({ stdout, stderr });
+        });
+    });
+}
+/**
+ * Returns true if the named tmux session exists, false otherwise.
+ * Never throws for "session not found" — that is a valid false result.
+ */
+export async function sessionExists(name) {
+    try {
+        await execTmux("has-session", "-t", name);
+        return true;
+    }
+    catch (err) {
+        if (err instanceof TmuxError && err.exitCode !== null) {
+            // Non-zero exit means session not found — not an error condition
+            return false;
+        }
+        throw err;
+    }
+}
+/**
+ * Creates a new detached tmux session with the given name.
+ * Throws if the session already exists or tmux is unavailable.
+ */
+export async function createSession(name) {
+    await execTmux("new-session", "-d", "-s", name);
+}
+/**
+ * Kills the named tmux session.
+ * Throws if the session does not exist or cannot be killed.
+ */
+export async function killSession(name) {
+    await execTmux("kill-session", "-t", name);
+}
+/**
+ * Creates a new window in the given session with the given name and working directory.
+ * Optionally sets per-window environment variables via the `-e` flag on `new-window`
+ * (NOT session-scoped `set-environment`) so each window gets its own env.
+ * Throws if the session does not exist.
+ */
+export async function createWindow(session, name, cwd, env) {
+    const args = ["new-window", "-t", session, "-n", name, "-c", cwd];
+    if (env) {
+        for (const [key, value] of Object.entries(env)) {
+            args.push("-e", `${key}=${value}`);
+        }
+    }
+    await execTmux(...args);
+}
+/**
+ * Returns true if a window with the given name exists in the given session.
+ * Returns false if the session or window does not exist — never throws for
+ * missing session/window.
+ */
+export async function windowExists(session, name) {
+    try {
+        const { stdout } = await execTmux("list-windows", "-t", session, "-F", "#{window_name}");
+        return stdout
+            .split("\n")
+            .map((l) => l.trim())
+            .filter(Boolean)
+            .includes(name);
+    }
+    catch (err) {
+        if (err instanceof TmuxError && err.exitCode !== null) {
+            // Non-zero exit — session not found or other non-fatal error
+            return false;
+        }
+        throw err;
+    }
+}
+/**
+ * Returns the list of window names in the given session.
+ * Returns an empty array if the session does not exist — never throws.
+ */
+export async function getWindowList(session) {
+    try {
+        const { stdout } = await execTmux("list-windows", "-t", session, "-F", "#{window_name}");
+        return stdout
+            .split("\n")
+            .map((l) => l.trim())
+            .filter(Boolean);
+    }
+    catch (err) {
+        if (err instanceof TmuxError && err.exitCode !== null) {
+            return [];
+        }
+        throw err;
+    }
+}
+/**
+ * Returns the name of the first window (index 0) in the given session.
+ * Returns null if the session does not exist or has no windows.
+ * Never throws.
+ */
+export async function getFirstWindowName(session) {
+    const windows = await getWindowList(session);
+    return windows.length > 0 ? windows[0] : null;
+}
+/**
+ * Kills the named window in the given session.
+ * Throws if the window does not exist.
+ */
+export async function killWindow(session, name) {
+    await execTmux("kill-window", "-t", `${session}:${name}`);
+}
+/**
+ * Sends keys to a window in the given session.
+ * Fire-and-forget: there is no confirmation of delivery.
+ * The `--` separator prevents tmux from interpreting the keys string as flags.
+ * When autoSubmit is true, `Enter` is sent after typing to submit the input.
+ */
+export async function sendKeys(session, window, keys, autoSubmit = true) {
+    const args = ["send-keys", "-t", `${session}:${window}`, "--", keys];
+    if (autoSubmit) {
+        args.push("Enter");
+    }
+    await execTmux(...args);
+}
+/**
+ * Send a prompt to the agent by sending the text and Enter in separate calls.
+ * This is more reliable than sending them together, especially for OpenCode.
+ */
+export async function sendPrompt(session, window, prompt) {
+    // Send the prompt text without Enter
+    await sendKeys(session, window, prompt, false);
+    // Wait a small moment for the text to appear
+    await new Promise((resolve) => setTimeout(resolve, 100));
+    // Send Enter separately
+    await sendKeys(session, window, "Enter", false);
+}
+/**
+ * Send a clear command to OpenCode by sending the command and Enter in separate calls.
+ * This prevents the "/" from triggering the agent selector instead of being a command.
+ */
+export async function sendClearCommand(session, window, clearCommand) {
+    // Send the clear command text without Enter
+    await sendKeys(session, window, clearCommand, false);
+    // Wait for the command to be processed (longer delay than sendPrompt)
+    await new Promise((resolve) => setTimeout(resolve, 500));
+    // Send Enter separately
+    await sendKeys(session, window, "Enter", false);
+}
+/** ANSI escape code stripping regex: covers CSI, OSC, character set, and SI sequences. */
+const ANSI_REGEX = 
+// eslint-disable-next-line no-control-regex
+/\x1b\[[0-9;]*[a-zA-Z]|\x1b\].*?(?:\x07|\x1b\\)|\x1b[()][0-9A-Z]|\x1b[>=<]|\x0f/g;
+/**
+ * Captures the pane output of a window in the given session.
+ * Defaults to the last 50 lines with ANSI escape codes stripped.
+ */
+export async function capturePane(session, window, options) {
+    const lines = options?.lines ?? 50;
+    const stripAnsi = options?.stripAnsi ?? true;
+    const { stdout } = await execTmux("capture-pane", "-t", `${session}:${window}`, "-p", "-S", `-${lines}`);
+    return stripAnsi ? stdout.replace(ANSI_REGEX, "") : stdout;
+}
+/**
+ * Sends a BEL character (ASCII 7) to a window in the given session.
+ * Used to notify the human that attention is needed.
+ */
+export async function sendBell(session, window) {
+    await execTmux("send-keys", "-t", `${session}:${window}`, String.fromCharCode(7));
+}
+/**
+ * Sets a tmux user option (prefixed with `@`) on the given session.
+ * User options are used for status bar content and other metadata.
+ * Example: setUserOption(session, "pit-status", "[auth: running 5/12]")
+ */
+export async function setUserOption(session, key, value) {
+    await execTmux("set-option", "-t", session, `@${key}`, value);
+}
+//# sourceMappingURL=tmux.js.map

package/dist/tmux.js.map

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

package/dist/worktree.d.ts

@@ -0,0 +1,33 @@
+export interface WorktreeResult {
+    path: string;
+    created: boolean;
+    branch: string;
+}
+/**
+ * Creates a git worktree for `epic` under `worktreeDir`.
+ *
+ * Idempotent: if the worktree already exists (directory + .git file), returns
+ * `{ created: false }` without running any git commands.
+ *
+ * Branch-exists fallback: if `git worktree add -b <branch>` fails because the
+ * branch already exists, retries with `git worktree add <path> <branch>`
+ * (checkout existing branch, no -b).
+ */
+export declare function createWorktree(worktreeDir: string, epic: string, baseBranch: string): Promise<WorktreeResult>;
+/**
+ * Returns true if `<worktreeDir>/<epic>` exists as a directory AND contains a
+ * `.git` file (worktrees have a .git file, not a .git directory).
+ */
+export declare function worktreeExists(worktreeDir: string, epic: string): Promise<boolean>;
+/**
+ * Removes the worktree at `<worktreeDir>/<epic>` via `git worktree remove --force`.
+ * Throws on failure.
+ */
+export declare function removeWorktree(worktreeDir: string, epic: string): Promise<void>;
+/**
+ * Returns true if the worktree at the given absolute path has uncommitted
+ * changes (staged, unstaged, or untracked files).
+ * Returns false if the path does not exist or is not a git worktree.
+ */
+export declare function isWorktreeDirty(worktreePath: string): Promise<boolean>;
+//# sourceMappingURL=worktree.d.ts.map

package/dist/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../src/worktree.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,CAAC,CAgDzB;AAMD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAaxF;AAMD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrF;AAMD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ5E"}