@provos/ironcurtain 0.5.1 → 0.7.0

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,54 @@
+/**
+ * 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;
+    /**
+     * Processes a paste event (text delivered via bracketed paste).
+     * Returns a MuxAction describing what the orchestrator should do.
+     */
+    handlePaste(text: string): MuxAction;
+}
+export interface MuxInputHandlerOptions {
+    initialMode?: InputMode;
+}
+export declare function createMuxInputHandler(options?: MuxInputHandlerOptions): MuxInputHandler;