@jacques-ai/server 0.0.7-alpha.1

package/dist/start-server.js

@@ -0,0 +1,408 @@
+/**
+ * Embeddable Server Module
+ *
+ * Provides a programmatic interface to start the Jacques server.
+ * Can be imported and used by the dashboard or run standalone.
+ */
+import { SessionRegistry } from './session-registry.js';
+import { UnixSocketServer } from './unix-socket.js';
+import { JacquesWebSocketServer } from './websocket.js';
+import { startFocusWatcher } from './focus-watcher.js';
+import { createHttpApi } from './http-api.js';
+import { startLogInterception, stopLogInterception, addLogListener } from './logger.js';
+import { ServerConfig } from './config/config.js';
+import { createLogger } from './logging/logger-factory.js';
+import { BroadcastService } from './services/broadcast-service.js';
+import { NotificationService } from './services/notification-service.js';
+import { HandoffWatcher } from './watchers/handoff-watcher.js';
+import { EventHandler } from './handlers/event-handler.js';
+import { WindowHandler } from './handlers/window-handler.js';
+import { WorktreeHandler } from './handlers/worktree-handler.js';
+import { SessionHandler } from './handlers/session-handler.js';
+import { SettingsHandler } from './handlers/settings-handler.js';
+import { scanForActiveSessions } from './process-scanner.js';
+import { extractSessionCatalog, getSessionIndex } from '@jacques-ai/core';
+import { TileStateManager } from './window-manager/tile-state.js';
+import { ChatService } from './services/chat-service.js';
+import { ClaudeOperationLogger } from '@jacques-ai/core';
+import { PROCESS_VERIFY_INTERVAL_MS, BRANCH_DIVERGENCE_INTERVAL_MS } from './connection/constants.js';
+import { BranchDivergenceService } from './services/branch-divergence-service.js';
+/**
+ * Start the Jacques server programmatically
+ */
+export async function startEmbeddedServer(options = {}) {
+    const { silent = false, unixSocketPath = ServerConfig.unixSocketPath, wsPort = ServerConfig.wsPort, httpPort = ServerConfig.httpPort, } = options;
+    // Create logger for orchestrator
+    const logger = createLogger({ silent, prefix: 'Server' });
+    // Initialize core components
+    const tileStateManager = new TileStateManager();
+    const registry = new SessionRegistry({
+        silent,
+        // Trigger catalog extraction when a session is removed (Ctrl+C, crash, etc.)
+        onSessionRemoved: (session) => {
+            // Clean tile state when a session ends
+            tileStateManager.removeSession(session.session_id);
+            // Broadcast removal to all GUI clients (covers all removal paths:
+            // session_end hook, process monitor dead PID, cleanup service, etc.)
+            broadcastService.broadcastSessionRemovedWithFocus(session.session_id);
+            notificationService.onSessionRemoved(session.session_id);
+            // Stop watching for handoff file
+            handoffWatcher.stopWatching(session.session_id);
+            if (session.transcript_path && session.cwd) {
+                logger.log(`Triggering catalog extraction for removed session: ${session.session_id}`);
+                extractSessionCatalog(session.transcript_path, session.cwd)
+                    .then((result) => {
+                    if (result.error) {
+                        logger.warn(`Catalog extraction failed: ${result.error}`);
+                    }
+                    else if (!result.skipped) {
+                        logger.log(`Catalog extracted for session ${session.session_id}`);
+                    }
+                })
+                    .catch((err) => {
+                    logger.warn(`Catalog extraction error: ${err}`);
+                });
+            }
+        },
+    });
+    let focusWatcher = null;
+    let httpServer = null;
+    // Create branch divergence service
+    const branchDivergenceService = new BranchDivergenceService({
+        getAllSessions: () => registry.getAllSessions(),
+        broadcastSessionUpdate: (session) => broadcastService.broadcastSessionWithFocus(session),
+        logger,
+    });
+    // Create WebSocket server
+    const wsServer = new JacquesWebSocketServer({
+        port: wsPort,
+        onClientMessage: handleClientMessage,
+        silent,
+    });
+    // Track scanning state (true until initial session discovery completes)
+    let isScanning = true;
+    // Set state provider for WebSocket server
+    wsServer.setStateProvider({
+        getAllSessions: () => registry.getAllSessions(),
+        getFocusedSessionId: () => registry.getFocusedSessionId(),
+        getFocusedSession: () => registry.getFocusedSession(),
+        isScanning: () => isScanning,
+    });
+    // Create broadcast service
+    const broadcastService = new BroadcastService({
+        wsServer,
+        registry,
+        logger,
+    });
+    // Create handoff watcher
+    const handoffWatcher = new HandoffWatcher({
+        handoffFilename: ServerConfig.handoffFilename,
+        broadcast: (msg) => {
+            wsServer.broadcast(msg);
+            // Also notify the notification service about handoff_ready
+            if (msg.type === 'handoff_ready') {
+                notificationService.onHandoffReady(msg.session_id, msg.path);
+            }
+        },
+        logger,
+    });
+    // Create notification service (with click-to-focus callback)
+    const notificationService = new NotificationService({
+        broadcast: (msg) => wsServer.broadcast(msg),
+        focusTerminal: (sessionId) => {
+            const session = registry.getSession(sessionId);
+            if (session?.terminal_key) {
+                import('./terminal-activator.js').then(({ activateTerminal }) => {
+                    activateTerminal(session.terminal_key).catch(() => { });
+                }).catch(() => { });
+            }
+        },
+        getSession: (sessionId) => registry.getSession(sessionId),
+        logger,
+    });
+    // Create chat service
+    const chatService = new ChatService({
+        logger,
+        onCatalogChange: (projectPath) => {
+            const msg = {
+                type: 'catalog_updated',
+                projectPath,
+                action: 'refresh',
+            };
+            wsServer.broadcast(msg);
+        },
+    });
+    // Create event handler
+    const eventHandler = new EventHandler({
+        registry,
+        broadcastService,
+        handoffWatcher,
+        notificationService,
+        branchDivergenceService,
+        logger,
+    });
+    // Create domain handlers
+    const windowHandler = new WindowHandler({ registry, tileStateManager, logger });
+    const worktreeHandler = new WorktreeHandler({ registry, tileStateManager, logger });
+    const sessionHandler = new SessionHandler({ registry, logger });
+    const settingsHandler = new SettingsHandler({ registry, wsServer, notificationService, logger });
+    // Create Unix socket server
+    const unixServer = new UnixSocketServer({
+        socketPath: unixSocketPath,
+        onEvent: (event) => eventHandler.handleEvent(event),
+        onError: (err) => {
+            logger.error(`Unix socket error: ${err.message}`);
+        },
+        silent,
+    });
+    // Wire up Claude operations to broadcast via WebSocket
+    ClaudeOperationLogger.onOperation = (op) => {
+        logger.log(`Claude operation: ${op.operation} (${op.inputTokens} in, ${op.outputTokens} out, ${op.durationMs}ms)`);
+        wsServer.broadcastClaudeOperation(op);
+        // Also check for large operation notifications
+        notificationService.onClaudeOperation({
+            id: op.id,
+            operation: op.operation,
+            phase: op.phase,
+            totalTokens: op.totalTokens,
+            userPromptPreview: op.userPromptPreview,
+        });
+    };
+    /**
+     * Handle client messages — thin router that delegates to domain handlers
+     */
+    function handleClientMessage(ws, message) {
+        switch (message.type) {
+            case 'select_session':
+                if (registry.setFocusedSession(message.session_id)) {
+                    broadcastService.forceBroadcastFocusChange();
+                }
+                break;
+            case 'trigger_action':
+                logger.log(`Action requested: ${message.action} for session ${message.session_id}`);
+                break;
+            // Settings
+            case 'toggle_autocompact':
+                settingsHandler.handleToggleAutoCompact(ws);
+                break;
+            case 'get_handoff_context':
+                settingsHandler.handleGetHandoffContext(ws, message);
+                break;
+            case 'update_notification_settings':
+                settingsHandler.handleUpdateNotificationSettings(ws, message);
+                break;
+            // Session
+            case 'focus_terminal':
+                sessionHandler.handleFocusTerminal(ws, message);
+                break;
+            case 'launch_session':
+                sessionHandler.handleLaunchSession(ws, message);
+                break;
+            // Window management
+            case 'tile_windows':
+                windowHandler.handleTileWindows(ws, message);
+                break;
+            case 'maximize_window':
+                windowHandler.handleMaximizeWindow(ws, message);
+                break;
+            case 'position_browser_layout':
+                windowHandler.handlePositionBrowserLayout(ws, message);
+                break;
+            case 'smart_tile_add':
+                windowHandler.handleSmartTileAdd(ws, message);
+                break;
+            // Worktree
+            case 'create_worktree':
+                worktreeHandler.handleCreateWorktree(ws, message);
+                break;
+            case 'list_worktrees':
+                worktreeHandler.handleListWorktrees(ws, message);
+                break;
+            case 'remove_worktree':
+                worktreeHandler.handleRemoveWorktree(ws, message);
+                break;
+            // Chat
+            case 'chat_send': {
+                const chatMsg = message;
+                chatService.send(ws, chatMsg.projectPath, chatMsg.message);
+                break;
+            }
+            case 'chat_abort': {
+                const abortMsg = message;
+                chatService.abort(abortMsg.projectPath);
+                break;
+            }
+            default:
+                logger.error(`Unknown client message type: ${message.type}`);
+        }
+    }
+    // Start log interception for broadcasting to GUI.
+    // In silent/embedded mode, suppress console output to prevent
+    // core module console.error calls from flickering the TUI.
+    startLogInterception({ silent });
+    // Add log listener to broadcast to WebSocket clients
+    const removeLogListener = addLogListener((logMessage) => {
+        wsServer.broadcast(logMessage);
+    });
+    // Start the server
+    if (!silent) {
+        logger.log('');
+        logger.log('Starting Jacques server...');
+    }
+    try {
+        // Start Unix socket server
+        await unixServer.start();
+        // Start WebSocket server
+        await wsServer.start();
+        // Start HTTP API server with API log callback
+        httpServer = await createHttpApi({
+            port: httpPort,
+            silent,
+            onApiLog: (log) => {
+                wsServer.broadcastApiLog(log);
+            },
+            notificationService,
+        });
+        // Pre-warm session index cache so first GUI load is fast
+        getSessionIndex().catch(() => { });
+        // Start stale session cleanup
+        registry.startCleanup(ServerConfig.staleSessionCleanupMinutes);
+        // Start process verification to detect dead sessions
+        registry.startProcessVerification(PROCESS_VERIFY_INTERVAL_MS);
+        // Start terminal focus watcher
+        focusWatcher = startFocusWatcher({
+            onFocusChange: (terminalKey, allKeys) => {
+                if (terminalKey) {
+                    // Try all candidate keys (e.g., ITERM first, then TTY fallback)
+                    let session = null;
+                    let matchedKey = terminalKey;
+                    for (const key of allKeys || [terminalKey]) {
+                        session = registry.findSessionByTerminalKey(key);
+                        if (session) {
+                            matchedKey = key;
+                            break;
+                        }
+                    }
+                    if (session && session.session_id !== registry.getFocusedSessionId()) {
+                        logger.log(`Terminal focus detected: ${matchedKey} -> ${session.session_id}`);
+                        registry.setFocusedSession(session.session_id);
+                        broadcastService.forceBroadcastFocusChange();
+                    }
+                }
+            },
+            shouldRetry: () => registry.getFocusedSessionId() === null && registry.getSessionCount() > 0,
+        }, ServerConfig.focusWatcherPollMs, { silent });
+        if (!silent) {
+            logger.log('Jacques server started successfully');
+            logger.log(`Unix socket: ${unixSocketPath}`);
+            logger.log(`WebSocket:   ws://localhost:${wsPort}`);
+            logger.log(`HTTP API:    http://localhost:${httpPort}`);
+            logger.log('');
+        }
+        // Discover existing sessions in background (non-blocking so CLI renders immediately)
+        discoverExistingSessions(registry, broadcastService, branchDivergenceService, logger)
+            .finally(() => {
+            isScanning = false;
+            wsServer.broadcast({
+                type: 'server_status',
+                status: 'connected',
+                session_count: registry.getSessionCount(),
+                scanning: false,
+            });
+        });
+    }
+    catch (err) {
+        const nodeErr = err;
+        if (nodeErr.code === 'EADDRINUSE') {
+            logger.error(`Port already in use. Another Jacques server may be running.`);
+            logger.error(`Run: npm run stop:server`);
+        }
+        else {
+            logger.error(`Failed to start: ${err}`);
+        }
+        throw err;
+    }
+    // Return the server interface
+    return {
+        stop: async () => {
+            if (!silent) {
+                logger.log('Shutting down...');
+            }
+            try {
+                // Stop watchers and intervals synchronously (fast operations)
+                if (focusWatcher) {
+                    focusWatcher.stop();
+                    focusWatcher = null;
+                }
+                registry.stopCleanup();
+                branchDivergenceService.stop();
+                handoffWatcher.stopAll();
+                chatService.killAll();
+                // Remove log listener
+                removeLogListener();
+                // Stop all servers in parallel (async operations)
+                const shutdownPromises = [];
+                if (httpServer) {
+                    shutdownPromises.push(httpServer.stop().catch((err) => {
+                        logger.error(`HTTP API stop error: ${err}`);
+                    }));
+                }
+                shutdownPromises.push(unixServer.stop().catch((err) => {
+                    logger.error(`UnixSocket stop error: ${err}`);
+                }), wsServer.stop().catch((err) => {
+                    logger.error(`WebSocket stop error: ${err}`);
+                }));
+                // Wait for all servers to stop
+                await Promise.all(shutdownPromises);
+                // Stop log interception last
+                stopLogInterception();
+                if (!silent) {
+                    logger.log('Shutdown complete');
+                }
+            }
+            catch (err) {
+                logger.error(`Error during shutdown: ${err}`);
+                throw err;
+            }
+        },
+        getRegistry: () => registry,
+        getWebSocketServer: () => wsServer,
+    };
+}
+/**
+ * Discover existing Claude sessions in background.
+ * Runs scan, registers sessions, detects bypass mode, and starts branch divergence.
+ */
+async function discoverExistingSessions(registry, broadcastService, branchDivergenceService, logger) {
+    try {
+        logger.log('Scanning for running Claude Code sessions...');
+        const discovered = await scanForActiveSessions();
+        for (const session of discovered) {
+            const registered = registry.registerDiscoveredSession(session);
+            broadcastService.broadcastSessionWithFocus(registered);
+        }
+        if (discovered.length > 0) {
+            logger.log(`Found ${discovered.length} active session(s)`);
+            // Check if any discovered sessions are running with --dangerously-skip-permissions
+            const bypassIds = await registry.detectBypassSessions();
+            if (bypassIds.length > 0) {
+                logger.log(`Detected ${bypassIds.length} bypass session(s): ${bypassIds.join(', ')}`);
+                for (const id of bypassIds) {
+                    const updated = await registry.updateSessionMode(id);
+                    if (updated) {
+                        broadcastService.broadcastSessionWithFocus(updated);
+                    }
+                }
+            }
+        }
+        else {
+            logger.log('No active sessions found');
+        }
+    }
+    catch (err) {
+        logger.warn(`Session scan failed: ${err}`);
+    }
+    // Start branch divergence monitoring (after session discovery so data is available)
+    branchDivergenceService.start(BRANCH_DIVERGENCE_INTERVAL_MS);
+}
+//# sourceMappingURL=start-server.js.map

package/dist/start-server.js.map

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

package/dist/terminal-activator.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Terminal Activator
+ *
+ * Activates (brings to foreground with keyboard focus) a terminal window
+ * identified by its terminal_key. Supports iTerm2, Kitty, WezTerm,
+ * Terminal.app, and PID-based fallback.
+ */
+export type ActivationMethod = 'iterm' | 'kitty' | 'wezterm' | 'terminal_app' | 'pid' | 'unsupported';
+export interface ActivationResult {
+    success: boolean;
+    method: ActivationMethod;
+    error?: string;
+}
+/**
+ * Activate a terminal window by its terminal_key.
+ *
+ * Terminal key formats:
+ * - ITERM:<w0t0p0:UUID>  (ITERM_SESSION_ID = "w0t0p0:UUID")
+ * - KITTY:<window-id>
+ * - WEZTERM:<pane-id>
+ * - TERM:<session-id>    (from statusline.sh using TERM_SESSION_ID)
+ * - TTY:<tty-path>
+ * - PID:<process-id>
+ * - AUTO:* or UNKNOWN:* (unsupported)
+ * - DISCOVERED:<type>:<value>[:extra] (from process scanner, unwrapped to inner type)
+ */
+export declare function activateTerminal(terminalKey: string): Promise<ActivationResult>;
+export { extractItermUuid } from './connection/index.js';
+//# sourceMappingURL=terminal-activator.d.ts.map

package/dist/terminal-activator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-activator.d.ts","sourceRoot":"","sources":["../src/terminal-activator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP,OAAO,GACP,SAAS,GACT,cAAc,GACd,KAAK,GACL,aAAa,CAAC;AAElB,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiCrF;AA2DD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}