cortex-agents 2.2.0 → 2.3.0

package/dist/utils/shell.d.ts

@@ -0,0 +1,53 @@
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface ExecOptions {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    timeout?: number;
+    /** If true, resolve even on non-zero exit codes instead of rejecting. */
+    nothrow?: boolean;
+}
+/**
+ * Execute a command with array-based arguments (no shell invocation).
+ * Uses child_process.execFile which never spawns a shell, preventing injection.
+ *
+ * By default, rejects on non-zero exit codes. Pass `nothrow: true` to always resolve.
+ */
+export declare function exec(cmd: string, args: string[], opts?: ExecOptions): Promise<ExecResult>;
+/**
+ * Fire-and-forget spawn. Returns the ChildProcess for PID tracking.
+ * Uses child_process.spawn with shell: false (default).
+ */
+export declare function spawn(cmd: string, args: string[], opts?: ExecOptions & {
+    stdio?: "ignore" | "pipe";
+}): import("child_process").ChildProcess;
+/**
+ * Shorthand for running a git command.
+ */
+export declare function git(cwd: string, ...args: string[]): Promise<ExecResult>;
+/**
+ * Shorthand for running a gh (GitHub CLI) command.
+ */
+export declare function gh(cwd: string, ...args: string[]): Promise<ExecResult>;
+/**
+ * Check if a binary exists in PATH.
+ */
+export declare function which(bin: string): Promise<string | null>;
+/**
+ * Send a signal to a process. Returns true if signal was sent, false if
+ * the process doesn't exist or we lack permissions.
+ */
+export declare function kill(pid: number, signal?: NodeJS.Signals): boolean;
+/**
+ * Check if a process is alive (sends signal 0 — no actual signal).
+ */
+export declare function isAlive(pid: number): boolean;
+/**
+ * Escape a string for safe inclusion in a shell command.
+ * Use only when array-based argument passing is impossible (e.g., osascript).
+ */
+export declare function shellEscape(str: string): string;
+//# sourceMappingURL=shell.d.ts.map

package/dist/utils/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/utils/shell.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAClB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,UAAU,CAAC,CAqCrB;AAED;;;GAGG;AACH,wBAAgB,KAAK,CACnB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,WAAW,GAAG;IAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;CAAO,wCAYvD;AAED;;GAEG;AACH,wBAAsB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAE7E;AAED;;GAEG;AACH,wBAAsB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAE5E;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQ/D;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,OAAmB,GAAG,OAAO,CAO7E;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO5C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS/C"}

package/dist/utils/shell.js

@@ -0,0 +1,118 @@
+import { execFile, spawn as cpSpawn } from "child_process";
+/**
+ * Execute a command with array-based arguments (no shell invocation).
+ * Uses child_process.execFile which never spawns a shell, preventing injection.
+ *
+ * By default, rejects on non-zero exit codes. Pass `nothrow: true` to always resolve.
+ */
+export function exec(cmd, args, opts = {}) {
+    return new Promise((resolve, reject) => {
+        execFile(cmd, args, {
+            cwd: opts.cwd,
+            env: opts.env ?? process.env,
+            timeout: opts.timeout ?? 30_000,
+            maxBuffer: 10 * 1024 * 1024,
+        }, (error, stdout, stderr) => {
+            const result = {
+                stdout: String(stdout ?? ""),
+                stderr: String(stderr ?? ""),
+                exitCode: error ? error.code ?? 1 : 0,
+            };
+            if (error) {
+                if (error.code === "ENOENT") {
+                    reject(new Error(`Command not found: ${cmd}`));
+                    return;
+                }
+                if (!opts.nothrow) {
+                    const err = new Error(result.stderr || error.message);
+                    err.exitCode = result.exitCode;
+                    err.stdout = result.stdout;
+                    err.stderr = result.stderr;
+                    reject(err);
+                    return;
+                }
+            }
+            resolve(result);
+        });
+    });
+}
+/**
+ * Fire-and-forget spawn. Returns the ChildProcess for PID tracking.
+ * Uses child_process.spawn with shell: false (default).
+ */
+export function spawn(cmd, args, opts = {}) {
+    const stdio = opts.stdio ?? "ignore";
+    const child = cpSpawn(cmd, args, {
+        cwd: opts.cwd,
+        env: opts.env ?? process.env,
+        stdio: stdio === "pipe" ? ["ignore", "pipe", "pipe"] : "ignore",
+        detached: false,
+    });
+    // Prevent unhandled error crashes on spawn failure
+    child.on("error", () => { });
+    return child;
+}
+/**
+ * Shorthand for running a git command.
+ */
+export async function git(cwd, ...args) {
+    return exec("git", ["-C", cwd, ...args]);
+}
+/**
+ * Shorthand for running a gh (GitHub CLI) command.
+ */
+export async function gh(cwd, ...args) {
+    return exec("gh", args, { cwd });
+}
+/**
+ * Check if a binary exists in PATH.
+ */
+export async function which(bin) {
+    try {
+        const result = await exec(process.platform === "win32" ? "where" : "which", [bin]);
+        const p = result.stdout.trim().split("\n")[0];
+        return p || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Send a signal to a process. Returns true if signal was sent, false if
+ * the process doesn't exist or we lack permissions.
+ */
+export function kill(pid, signal = "SIGTERM") {
+    try {
+        process.kill(pid, signal);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a process is alive (sends signal 0 — no actual signal).
+ */
+export function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Escape a string for safe inclusion in a shell command.
+ * Use only when array-based argument passing is impossible (e.g., osascript).
+ */
+export function shellEscape(str) {
+    // Replace backslashes first, then other dangerous characters
+    return str
+        .replace(/\\/g, "\\\\")
+        .replace(/"/g, '\\"')
+        .replace(/'/g, "'\\''")
+        .replace(/`/g, "\\`")
+        .replace(/\$/g, "\\$")
+        .replace(/!/g, "\\!");
+}

package/dist/utils/terminal.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Terminal Driver System — Strategy pattern for cross-platform terminal tab management.
+ *
+ * Each supported terminal emulator implements the TerminalDriver interface for:
+ *   - detect()  — check if this is the active terminal
+ *   - openTab() — open a new tab and return identifiers
+ *   - closeTab() — close a tab by its identifiers (idempotent, never throws)
+ *
+ * Session data is persisted to `.cortex/.terminal-session` inside each worktree
+ * so tabs can be closed when the worktree is removed.
+ */
+/** Persisted session data for an opened terminal tab. */
+export interface TerminalSession {
+    /** Driver name (e.g., "iterm2", "kitty", "tmux", "pty") */
+    terminal: string;
+    platform: NodeJS.Platform;
+    sessionId?: string;
+    windowId?: string;
+    tabId?: string;
+    paneId?: string;
+    dbusPath?: string;
+    pid?: number;
+    ptyId?: string;
+    mode: "terminal" | "pty" | "background";
+    branch: string;
+    agent: string;
+    worktreePath: string;
+    startedAt: string;
+}
+/** Options passed to a driver's openTab() method. */
+export interface TabOpenOptions {
+    worktreePath: string;
+    opencodeBin: string;
+    agent: string;
+    prompt: string;
+    branchName: string;
+}
+/** Common interface for all terminal drivers. */
+export interface TerminalDriver {
+    readonly name: string;
+    detect(): boolean;
+    openTab(opts: TabOpenOptions): Promise<Partial<TerminalSession>>;
+    closeTab(session: TerminalSession): Promise<boolean>;
+}
+/** Persist terminal session data to the worktree's .cortex directory. */
+export declare function writeSession(worktreePath: string, session: TerminalSession): void;
+/** Read terminal session data from the worktree's .cortex directory. */
+export declare function readSession(worktreePath: string): TerminalSession | null;
+/**
+ * Detect the active terminal emulator and return the matching driver.
+ * Falls back to FallbackDriver if no specific terminal is detected.
+ */
+export declare function detectDriver(): TerminalDriver;
+/**
+ * Get a driver by name (used when closing a tab from a persisted session).
+ * Returns null if the driver name is unknown.
+ */
+export declare function getDriverByName(name: string): TerminalDriver | null;
+/**
+ * Close a terminal session using the appropriate driver.
+ * Handles all modes (terminal, pty, background) with PID fallback.
+ *
+ * This is the main entry point for worktree_remove cleanup.
+ */
+export declare function closeSession(session: TerminalSession): Promise<boolean>;
+//# sourceMappingURL=terminal.d.ts.map

package/dist/utils/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/utils/terminal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAG1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,IAAI,EAAE,UAAU,GAAG,KAAK,GAAG,YAAY,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,IAAI,OAAO,CAAC;IAClB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtD;AAMD,yEAAyE;AACzE,wBAAgB,YAAY,CAC1B,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,eAAe,GACvB,IAAI,CASN;AAED,wEAAwE;AACxE,wBAAgB,WAAW,CACzB,YAAY,EAAE,MAAM,GACnB,eAAe,GAAG,IAAI,CAQxB;AA6kBD;;;GAGG;AACH,wBAAgB,YAAY,IAAI,cAAc,CAM7C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAEnE;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAY7E"}