@provos/ironcurtain 0.5.1 → 0.6.0

package/dist/mux/mux-command.js

@@ -0,0 +1,93 @@
+/**
+ * CLI entry point for `ironcurtain mux`.
+ *
+ * Parses command-line options, loads config, acquires the listener lock,
+ * creates the MuxApp, and runs until quit.
+ */
+import chalk from 'chalk';
+import { mkdirSync } from 'node:fs';
+import { getListenerLockPath, getPtyRegistryDir } from '../config/paths.js';
+import { acquireLock, releaseLock } from '../escalation/listener-lock.js';
+import { loadUserConfig } from '../config/user-config.js';
+import { parseModelId, resolveApiKeyForProvider } from '../config/model-provider.js';
+import { loadConfig } from '../config/index.js';
+import { createMuxApp } from './mux-app.js';
+export async function main(args) {
+    // Check for optional mux dependencies
+    try {
+        await import('node-pty');
+    }
+    catch {
+        process.stderr.write(chalk.red('Error: ironcurtain mux requires the node-pty package.\n') + 'Install it with: npm install node-pty\n');
+        process.exit(1);
+    }
+    try {
+        await import('terminal-kit');
+    }
+    catch {
+        process.stderr.write(chalk.red('Error: ironcurtain mux requires the terminal-kit package.\n') +
+            'Install it with: npm install terminal-kit\n');
+        process.exit(1);
+    }
+    // Parse args
+    let agent = 'claude-code';
+    if (args) {
+        for (let i = 0; i < args.length; i++) {
+            if ((args[i] === '--agent' || args[i] === '-a') && args[i + 1]) {
+                agent = args[i + 1];
+                i++;
+            }
+        }
+    }
+    // Acquire single-instance lock
+    const lockPath = getListenerLockPath();
+    if (!acquireLock(lockPath)) {
+        process.stderr.write(chalk.red('Another escalation listener or mux is already running.\n') +
+            'Only one instance can run at a time to prevent escalation conflicts.\n');
+        process.exit(1);
+    }
+    // Ensure registry directory exists
+    const registryDir = getPtyRegistryDir();
+    mkdirSync(registryDir, { recursive: true, mode: 0o700 });
+    // Pre-flight warnings (shown before fullscreen takes over)
+    let hasWarnings = false;
+    try {
+        const userConfig = loadUserConfig({ readOnly: true });
+        if (userConfig.autoApprove.enabled) {
+            const { provider } = parseModelId(userConfig.autoApprove.modelId);
+            const apiKey = resolveApiKeyForProvider(provider, userConfig);
+            if (!apiKey) {
+                process.stderr.write(chalk.yellow(`Warning: auto-approve is enabled but no API key found for provider "${provider}".\n` +
+                    'Auto-approve will be silently disabled. Set the API key in your environment or config.\n'));
+                hasWarnings = true;
+            }
+        }
+    }
+    catch {
+        // Config load failure is not fatal here -- the child sessions will report it.
+    }
+    if (hasWarnings) {
+        process.stderr.write(chalk.dim('\nStarting in 3 seconds...\n'));
+        await new Promise((r) => setTimeout(r, 3000));
+    }
+    // Load config once for workspace validation
+    let protectedPaths = [];
+    try {
+        protectedPaths = loadConfig().protectedPaths;
+    }
+    catch {
+        // Config load failure is not fatal; child sessions will report it.
+    }
+    try {
+        const app = createMuxApp({
+            agent,
+            autoSpawn: false,
+            protectedPaths,
+        });
+        await app.start();
+    }
+    finally {
+        releaseLock(lockPath);
+    }
+}
+//# sourceMappingURL=mux-command.js.map

package/dist/mux/mux-command.js.map

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

package/dist/mux/mux-escalation-manager.d.ts

@@ -0,0 +1,48 @@
+/**
+ * MuxEscalationManager -- manages escalation watchers for all PTY sessions.
+ *
+ * Wraps the existing EscalationWatcher and ListenerState modules for the
+ * mux context. Creates watchers directly when sessions are spawned, and
+ * optionally polls the PTY registry for externally-spawned sessions.
+ */
+import type { PtySessionRegistration } from '../docker/pty-types.js';
+import { type ListenerState } from '../escalation/listener-state.js';
+export interface MuxEscalationManager {
+    /** Current state (sessions, pending escalations, history). */
+    readonly state: ListenerState;
+    /** Number of pending escalations across all sessions. */
+    readonly pendingCount: number;
+    /**
+     * Registers a session for escalation watching.
+     */
+    addSession(registration: PtySessionRegistration): void;
+    /**
+     * Removes a session's watcher.
+     */
+    removeSession(sessionId: string): void;
+    /** Resolves a pending escalation by display number. */
+    resolve(displayNumber: number, decision: 'approved' | 'denied'): string;
+    /** Resolves all pending escalations. */
+    resolveAll(decision: 'approved' | 'denied'): string;
+    /** Starts polling for externally-spawned sessions. */
+    startRegistryPolling(): void;
+    /** Stops all watchers and polling. */
+    stop(): void;
+    /** Register callback for state changes (triggers redraws). */
+    onChange(callback: () => void): void;
+    /**
+     * Registers a callback fired when registry polling discovers a new
+     * external session. Used to back-fill bridge registrations that
+     * timed out during initial discovery.
+     */
+    onSessionDiscovered(callback: (reg: PtySessionRegistration) => void): void;
+    /**
+     * Marks a session ID as managed so registry polling treats it as
+     * owned by the mux (won't re-add after removal).
+     */
+    claimSession(sessionId: string): void;
+}
+/**
+ * Creates a new MuxEscalationManager.
+ */
+export declare function createMuxEscalationManager(): MuxEscalationManager;

package/dist/mux/mux-escalation-manager.js

@@ -0,0 +1,162 @@
+/**
+ * MuxEscalationManager -- manages escalation watchers for all PTY sessions.
+ *
+ * Wraps the existing EscalationWatcher and ListenerState modules for the
+ * mux context. Creates watchers directly when sessions are spawned, and
+ * optionally polls the PTY registry for externally-spawned sessions.
+ */
+import { mkdirSync } from 'node:fs';
+import { getPtyRegistryDir } from '../config/paths.js';
+import { readActiveRegistrations } from '../escalation/session-registry.js';
+import { createEscalationWatcher } from '../escalation/escalation-watcher.js';
+import { createInitialState, addSession, removeSession, addEscalation, resolveEscalation, expireEscalation, } from '../escalation/listener-state.js';
+/** Poll interval for the session registry directory (ms). */
+const REGISTRY_POLL_INTERVAL_MS = 1000;
+/**
+ * Creates a new MuxEscalationManager.
+ */
+export function createMuxEscalationManager() {
+    let state = createInitialState();
+    const changeCallbacks = [];
+    const discoveryCallbacks = [];
+    let registryPollInterval = null;
+    // Track session IDs that we manage (spawned by mux)
+    const managedSessionIds = new Set();
+    // Tombstones: removed sessions that may still linger in the registry briefly
+    const removedSessionIds = new Set();
+    function notifyChange() {
+        for (const cb of changeCallbacks)
+            cb();
+    }
+    function createWatcherForSession(sessionId, escalationDir) {
+        return createEscalationWatcher(escalationDir, {
+            onEscalation: (request) => {
+                state = addEscalation(state, sessionId, request);
+                notifyChange();
+                // BEL to alert user
+                process.stderr.write('\x07');
+            },
+            onEscalationExpired: (escalationId) => {
+                state = expireEscalation(state, sessionId, escalationId);
+                notifyChange();
+            },
+        }, { pollIntervalMs: 300 });
+    }
+    return {
+        get state() {
+            return state;
+        },
+        get pendingCount() {
+            return state.pendingEscalations.size;
+        },
+        addSession(registration) {
+            managedSessionIds.add(registration.sessionId);
+            const watcher = createWatcherForSession(registration.sessionId, registration.escalationDir);
+            state = addSession(state, registration, watcher);
+            watcher.start();
+            notifyChange();
+        },
+        removeSession(sessionId) {
+            const session = state.sessions.get(sessionId);
+            session?.watcher.stop();
+            removedSessionIds.add(sessionId);
+            state = removeSession(state, sessionId);
+            notifyChange();
+        },
+        resolve(displayNumber, decision) {
+            const escalation = state.pendingEscalations.get(displayNumber);
+            if (!escalation) {
+                return `No pending escalation #${displayNumber}`;
+            }
+            const session = state.sessions.get(escalation.sessionId);
+            if (!session) {
+                return `Session for escalation #${displayNumber} no longer active`;
+            }
+            try {
+                const accepted = session.watcher.resolve(escalation.request.escalationId, decision);
+                state = resolveEscalation(state, displayNumber, decision);
+                notifyChange();
+                if (!accepted) {
+                    return `Escalation #${displayNumber} expired (response was too late)`;
+                }
+                const label = decision === 'approved' ? 'APPROVED' : 'DENIED';
+                return `Escalation #${displayNumber} ${label}`;
+            }
+            catch (err) {
+                return `Error: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        },
+        resolveAll(decision) {
+            if (state.pendingEscalations.size === 0) {
+                return 'No pending escalations';
+            }
+            const messages = [];
+            const nums = [...state.pendingEscalations.keys()].sort((a, b) => a - b);
+            for (const num of nums) {
+                messages.push(this.resolve(num, decision));
+            }
+            return messages.join('\n');
+        },
+        startRegistryPolling() {
+            if (registryPollInterval)
+                return;
+            const registryDir = getPtyRegistryDir();
+            mkdirSync(registryDir, { recursive: true, mode: 0o700 });
+            registryPollInterval = setInterval(() => {
+                const registrations = readActiveRegistrations(registryDir);
+                const currentIds = new Set(registrations.map((r) => r.sessionId));
+                const stateIds = new Set(state.sessions.keys());
+                let changed = false;
+                // Add externally-spawned sessions (skip managed, tombstoned)
+                for (const reg of registrations) {
+                    if (!stateIds.has(reg.sessionId) &&
+                        !managedSessionIds.has(reg.sessionId) &&
+                        !removedSessionIds.has(reg.sessionId)) {
+                        const watcher = createWatcherForSession(reg.sessionId, reg.escalationDir);
+                        state = addSession(state, reg, watcher);
+                        watcher.start();
+                        changed = true;
+                        for (const cb of discoveryCallbacks)
+                            cb(reg);
+                    }
+                }
+                // Clear tombstones once the registry entry disappears
+                for (const id of removedSessionIds) {
+                    if (!currentIds.has(id)) {
+                        removedSessionIds.delete(id);
+                    }
+                }
+                // Remove gone external sessions
+                for (const id of stateIds) {
+                    if (!currentIds.has(id) && !managedSessionIds.has(id)) {
+                        const session = state.sessions.get(id);
+                        session?.watcher.stop();
+                        state = removeSession(state, id);
+                        changed = true;
+                    }
+                }
+                if (changed)
+                    notifyChange();
+            }, REGISTRY_POLL_INTERVAL_MS);
+        },
+        stop() {
+            if (registryPollInterval) {
+                clearInterval(registryPollInterval);
+                registryPollInterval = null;
+            }
+            for (const session of state.sessions.values()) {
+                session.watcher.stop();
+            }
+        },
+        onChange(callback) {
+            changeCallbacks.push(callback);
+        },
+        onSessionDiscovered(callback) {
+            discoveryCallbacks.push(callback);
+        },
+        claimSession(sessionId) {
+            managedSessionIds.add(sessionId);
+        },
+    };
+}
+//# sourceMappingURL=mux-escalation-manager.js.map

package/dist/mux/mux-escalation-manager.js.map

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

package/dist/mux/mux-input-handler.d.ts

@@ -0,0 +1,49 @@
+/**
+ * MuxInputHandler -- key routing state machine for the terminal multiplexer.
+ *
+ * Two input modes:
+ * - PTY mode: all keystrokes go to the active PtyBridge except Ctrl-A
+ * - Command mode: keystrokes collected in a line buffer, dispatched on Enter
+ *
+ * Ctrl-A toggles between modes (following screen/tmux convention).
+ * Pressing Ctrl-A in PTY mode enters command mode; pressing it again
+ * returns to PTY mode.
+ */
+import type { InputMode, MuxAction } from './types.js';
+export type PickerPhase = 'menu' | 'browse';
+export interface PickerState {
+    phase: PickerPhase;
+    menuSelection: number;
+    inputPath: string;
+    cursorPos: number;
+    entries: string[];
+    selectedIndex: number;
+    scrollOffset: number;
+    inList: boolean;
+    error: string | null;
+}
+export interface MuxInputHandler {
+    /** Current input mode. */
+    readonly mode: InputMode;
+    /** Current command-mode input buffer (for display). */
+    readonly inputBuffer: string;
+    /** Cursor position within the input buffer. */
+    readonly cursorPos: number;
+    /** Current picker state (null when not in picker mode). */
+    readonly pickerState: PickerState | null;
+    /** Enter picker mode (called by /new command handler). */
+    enterPickerMode(): void;
+    /** Re-enter picker browse phase with a validation error. */
+    enterBrowseWithError(path: string, error: string): void;
+    /** Exit picker mode and return to PTY mode (no side effects). */
+    exitPickerMode(): void;
+    /**
+     * Processes a key event from terminal-kit.
+     * Returns a MuxAction describing what the orchestrator should do.
+     */
+    handleKey(key: string): MuxAction;
+}
+export interface MuxInputHandlerOptions {
+    initialMode?: InputMode;
+}
+export declare function createMuxInputHandler(options?: MuxInputHandlerOptions): MuxInputHandler;