@jacques-ai/server 0.0.7-alpha.1

package/dist/focus-watcher.js

@@ -0,0 +1,169 @@
+/**
+ * Terminal Focus Watcher
+ *
+ * Monitors which terminal window is focused on macOS and sends
+ * focus hints to the Jacques server to update the active session.
+ *
+ * Supports:
+ * - iTerm2 (via ITERM_SESSION_ID)
+ * - Terminal.app (via TTY)
+ * - Other terminals (via window ID / PID)
+ */
+import { createLogger } from './logging/logger-factory.js';
+import { FOCUS_WATCHER_POLL_MS, TERMINAL_APP_NAMES } from './connection/constants.js';
+import { runAppleScript } from './connection/applescript.js';
+/**
+ * Get the currently focused application name
+ */
+async function getFrontmostApp() {
+    try {
+        return await runAppleScript('tell application "System Events" to get name of first application process whose frontmost is true');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get iTerm2 session ID for the active tab
+ */
+async function getITermSessionId() {
+    try {
+        const result = await runAppleScript('tell application "iTerm2" to tell current session of current tab of current window to return unique ID');
+        return result || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get Terminal.app TTY for the active tab
+ */
+async function getTerminalTTY() {
+    try {
+        const result = await runAppleScript(`
+      tell application "Terminal"
+        return tty of selected tab of front window
+      end tell
+    `);
+        return result || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get iTerm2 TTY for the active session
+ */
+async function getITermTTY() {
+    try {
+        const result = await runAppleScript('tell application "iTerm2" to tell current session of current tab of current window to return tty');
+        return result || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get focus info for the currently active terminal
+ */
+export async function getTerminalFocusInfo() {
+    const app = await getFrontmostApp();
+    if (!app)
+        return null;
+    // Check if it's a terminal application
+    const isTerminal = TERMINAL_APP_NAMES.some(t => app.toLowerCase().includes(t.toLowerCase()));
+    if (!isTerminal) {
+        return null; // Not a terminal, ignore
+    }
+    const focusInfo = { app };
+    if (app.includes('iTerm')) {
+        focusInfo.iterm_session_id = await getITermSessionId() || undefined;
+        // Also get TTY for iTerm — discovered sessions may only have TTY-based keys
+        focusInfo.tty = await getITermTTY() || undefined;
+    }
+    else if (app === 'Terminal') {
+        focusInfo.tty = await getTerminalTTY() || undefined;
+    }
+    return focusInfo;
+}
+/**
+ * Build terminal key candidates from focus info, ordered by specificity.
+ * Returns multiple keys to try (e.g., ITERM key first, then TTY fallback)
+ * because discovered sessions may use TTY keys even when running in iTerm.
+ */
+export function buildTerminalKeysFromFocus(focus) {
+    const keys = [];
+    if (focus.iterm_session_id) {
+        keys.push(`ITERM:${focus.iterm_session_id}`);
+    }
+    if (focus.tty) {
+        keys.push(`TTY:${focus.tty}`);
+    }
+    if (focus.terminal_pid) {
+        keys.push(`PID:${focus.terminal_pid}`);
+    }
+    return keys;
+}
+/**
+ * Build a single terminal key from focus info (primary key for change detection)
+ */
+export function buildTerminalKeyFromFocus(focus) {
+    const keys = buildTerminalKeysFromFocus(focus);
+    return keys[0] || null;
+}
+/**
+ * Start watching for terminal focus changes
+ */
+export function startFocusWatcher(callbacks, pollIntervalMs = FOCUS_WATCHER_POLL_MS, options = {}) {
+    // Support both old silent flag and new logger injection (messages already include [FocusWatcher] prefix)
+    const logger = options.logger ?? createLogger({ silent: options.silent });
+    const log = logger.log.bind(logger);
+    const error = logger.error.bind(logger);
+    let lastTerminalKey = null;
+    let isRunning = true;
+    // Poll slower when no terminal is focused (non-terminal app in foreground)
+    const idleMultiplier = 3;
+    const poll = async () => {
+        if (!isRunning)
+            return;
+        let nextDelay = pollIntervalMs;
+        try {
+            const focusInfo = await getTerminalFocusInfo();
+            const terminalKey = focusInfo ? buildTerminalKeyFromFocus(focusInfo) : null;
+            const allKeys = focusInfo ? buildTerminalKeysFromFocus(focusInfo) : [];
+            // Poll slower when no terminal is focused
+            if (!focusInfo) {
+                nextDelay = pollIntervalMs * idleMultiplier;
+            }
+            // Notify on terminal key change, or re-notify same key if no session
+            // is currently focused (sessions may have registered since last poll)
+            if (terminalKey !== lastTerminalKey || (terminalKey && callbacks.shouldRetry?.())) {
+                if (terminalKey !== lastTerminalKey) {
+                    log(`[FocusWatcher] Focus changed: ${lastTerminalKey} -> ${terminalKey}`);
+                    if (focusInfo) {
+                        log(`[FocusWatcher] App: ${focusInfo.app}, iTerm ID: ${focusInfo.iterm_session_id || 'none'}, TTY: ${focusInfo.tty || 'none'}`);
+                    }
+                }
+                lastTerminalKey = terminalKey;
+                callbacks.onFocusChange(terminalKey, allKeys);
+            }
+        }
+        catch (err) {
+            error(`[FocusWatcher] Poll error: ${err}`);
+            nextDelay = pollIntervalMs * idleMultiplier;
+        }
+        if (isRunning) {
+            setTimeout(poll, nextDelay);
+        }
+    };
+    // Start polling
+    log('[FocusWatcher] Starting focus polling...');
+    poll();
+    return {
+        stop: () => {
+            isRunning = false;
+            log('[FocusWatcher] Stopped');
+        }
+    };
+}
+//# sourceMappingURL=focus-watcher.js.map

package/dist/focus-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-watcher.js","sourceRoot":"","sources":["../src/focus-watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAU7D;;GAEG;AACH,KAAK,UAAU,eAAe;IAC5B,IAAI,CAAC;QACH,OAAO,MAAM,cAAc,CACzB,mGAAmG,CACpG,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,iBAAiB;IAC9B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,cAAc,CACjC,wGAAwG,CACzG,CAAC;QACF,OAAO,MAAM,IAAI,IAAI,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,cAAc;IAC3B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC;;;;KAInC,CAAC,CAAC;QACH,OAAO,MAAM,IAAI,IAAI,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,WAAW;IACxB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,cAAc,CACjC,kGAAkG,CACnG,CAAC;QACF,OAAO,MAAM,IAAI,IAAI,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,MAAM,GAAG,GAAG,MAAM,eAAe,EAAE,CAAC;IAEpC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAEtB,uCAAuC;IACvC,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAE7F,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC,CAAC,yBAAyB;IACxC,CAAC;IAED,MAAM,SAAS,GAAc,EAAE,GAAG,EAAE,CAAC;IAErC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,SAAS,CAAC,gBAAgB,GAAG,MAAM,iBAAiB,EAAE,IAAI,SAAS,CAAC;QACpE,4EAA4E;QAC5E,SAAS,CAAC,GAAG,GAAG,MAAM,WAAW,EAAE,IAAI,SAAS,CAAC;IACnD,CAAC;SAAM,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;QAC9B,SAAS,CAAC,GAAG,GAAG,MAAM,cAAc,EAAE,IAAI,SAAS,CAAC;IACtD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAgB;IACzD,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QACd,IAAI,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAgB;IACxD,MAAM,IAAI,GAAG,0BAA0B,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACzB,CAAC;AAeD;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAgC,EAChC,iBAAyB,qBAAqB,EAC9C,UAA+B,EAAE;IAEjC,yGAAyG;IACzG,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,YAAY,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1E,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAExC,IAAI,eAAe,GAAkB,IAAI,CAAC;IAC1C,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,2EAA2E;IAC3E,MAAM,cAAc,GAAG,CAAC,CAAC;IAEzB,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;QACtB,IAAI,CAAC,SAAS;YAAE,OAAO;QAEvB,IAAI,SAAS,GAAG,cAAc,CAAC;QAE/B,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,oBAAoB,EAAE,CAAC;YAC/C,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,yBAAyB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC5E,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,0BAA0B,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAEvE,0CAA0C;YAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,SAAS,GAAG,cAAc,GAAG,cAAc,CAAC;YAC9C,CAAC;YAED,qEAAqE;YACrE,sEAAsE;YACtE,IAAI,WAAW,KAAK,eAAe,IAAI,CAAC,WAAW,IAAI,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC,EAAG,CAAC;gBACnF,IAAI,WAAW,KAAK,eAAe,EAAE,CAAC;oBACpC,GAAG,CAAC,iCAAiC,eAAe,OAAO,WAAW,EAAE,CAAC,CAAC;oBAC1E,IAAI,SAAS,EAAE,CAAC;wBACd,GAAG,CAAC,uBAAuB,SAAS,CAAC,GAAG,eAAe,SAAS,CAAC,gBAAgB,IAAI,MAAM,UAAU,SAAS,CAAC,GAAG,IAAI,MAAM,EAAE,CAAC,CAAC;oBAClI,CAAC;gBACH,CAAC;gBACD,eAAe,GAAG,WAAW,CAAC;gBAC9B,SAAS,CAAC,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,8BAA8B,GAAG,EAAE,CAAC,CAAC;YAC3C,SAAS,GAAG,cAAc,GAAG,cAAc,CAAC;QAC9C,CAAC;QAED,IAAI,SAAS,EAAE,CAAC;YACd,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC;IAEF,gBAAgB;IAChB,GAAG,CAAC,0CAA0C,CAAC,CAAC;IAChD,IAAI,EAAE,CAAC;IAEP,OAAO;QACL,IAAI,EAAE,GAAG,EAAE;YACT,SAAS,GAAG,KAAK,CAAC;YAClB,GAAG,CAAC,wBAAwB,CAAC,CAAC;QAChC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/handlers/event-handler.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Event Handler
+ *
+ * Routes and handles hook events from the Unix socket.
+ * Coordinates between the session registry, broadcast service,
+ * and handoff watcher.
+ */
+import type { HookEvent } from '../types.js';
+import type { SessionRegistry } from '../session-registry.js';
+import type { BroadcastService } from '../services/broadcast-service.js';
+import type { NotificationService } from '../services/notification-service.js';
+import type { HandoffWatcher } from '../watchers/handoff-watcher.js';
+import type { BranchDivergenceService } from '../services/branch-divergence-service.js';
+import type { Logger } from '../logging/logger-factory.js';
+/**
+ * Configuration for EventHandler
+ */
+export interface EventHandlerConfig {
+    /** Session registry for managing sessions */
+    registry: SessionRegistry;
+    /** Broadcast service for sending updates */
+    broadcastService: BroadcastService;
+    /** Handoff watcher for file watching */
+    handoffWatcher: HandoffWatcher;
+    /** Notification service for desktop + in-app notifications */
+    notificationService?: NotificationService;
+    /** Branch divergence service for reactive git status updates */
+    branchDivergenceService?: BranchDivergenceService;
+    /** Optional logger */
+    logger?: Logger;
+}
+/**
+ * EventHandler - routes and processes hook events
+ *
+ * This class extracts the event handling logic from the main
+ * orchestrator (start-server.ts), making it easier to test
+ * and maintain.
+ */
+export declare class EventHandler {
+    private registry;
+    private broadcastService;
+    private handoffWatcher;
+    private notificationService?;
+    private branchDivergenceService?;
+    private logger;
+    private modeCheckTimestamps;
+    constructor(config: EventHandlerConfig);
+    /**
+     * Handle an incoming hook event
+     *
+     * Routes the event to the appropriate handler based on event type.
+     *
+     * @param event The hook event to handle
+     */
+    handleEvent(event: HookEvent): void;
+    /**
+     * Handle session start event
+     */
+    private handleSessionStart;
+    /**
+     * Handle activity event
+     */
+    private handleActivity;
+    /**
+     * Handle context update event
+     */
+    private handleContextUpdate;
+    /**
+     * Resolve a continue session title by reading the handoff file.
+     * Updates session title and broadcasts when resolved.
+     */
+    private resolveContinueTitle;
+    /**
+     * Handle pre-tool-use event (PreToolUse hook)
+     * Starts a debounced awaiting timer — if PostToolUse doesn't arrive
+     * within 1 second, the session status changes to 'awaiting'.
+     */
+    private handlePreToolUse;
+    /**
+     * Handle idle event
+     */
+    private handleIdle;
+    /**
+     * For bypass sessions, hook permission_mode is unreliable (always reports acceptEdits).
+     * Detect mode from JSONL transcript instead and broadcast if changed.
+     */
+    private detectModeIfBypass;
+    /**
+     * Handle session end event
+     */
+    private handleSessionEnd;
+}
+//# sourceMappingURL=event-handler.d.ts.map

package/dist/handlers/event-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-handler.d.ts","sourceRoot":"","sources":["../../src/handlers/event-handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,SAAS,EAOV,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AAExF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAK3D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,QAAQ,EAAE,eAAe,CAAC;IAC1B,4CAA4C;IAC5C,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,wCAAwC;IACxC,cAAc,EAAE,cAAc,CAAC;IAC/B,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,gEAAgE;IAChE,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAClD,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,mBAAmB,CAAC,CAAsB;IAClD,OAAO,CAAC,uBAAuB,CAAC,CAA0B;IAC1D,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,mBAAmB,CAA6B;gBAE5C,MAAM,EAAE,kBAAkB;IAStC;;;;;;OAMG;IACH,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IA+BnC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuB1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA4B3B;;;OAGG;YACW,oBAAoB;IAalC;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,UAAU;IASlB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CASzB"}

package/dist/handlers/event-handler.js

@@ -0,0 +1,196 @@
+/**
+ * Event Handler
+ *
+ * Routes and handles hook events from the Unix socket.
+ * Coordinates between the session registry, broadcast service,
+ * and handoff watcher.
+ */
+import { createLogger } from '../logging/logger-factory.js';
+import { isContinueSession } from '@jacques-ai/core/session';
+import { extractContinueTitleFromHandoff } from '@jacques-ai/core/cache';
+/**
+ * EventHandler - routes and processes hook events
+ *
+ * This class extracts the event handling logic from the main
+ * orchestrator (start-server.ts), making it easier to test
+ * and maintain.
+ */
+export class EventHandler {
+    registry;
+    broadcastService;
+    handoffWatcher;
+    notificationService;
+    branchDivergenceService;
+    logger;
+    modeCheckTimestamps = new Map();
+    constructor(config) {
+        this.registry = config.registry;
+        this.broadcastService = config.broadcastService;
+        this.handoffWatcher = config.handoffWatcher;
+        this.notificationService = config.notificationService;
+        this.branchDivergenceService = config.branchDivergenceService;
+        this.logger = config.logger ?? createLogger({ silent: true });
+    }
+    /**
+     * Handle an incoming hook event
+     *
+     * Routes the event to the appropriate handler based on event type.
+     *
+     * @param event The hook event to handle
+     */
+    handleEvent(event) {
+        switch (event.event) {
+            case 'session_start':
+                this.handleSessionStart(event);
+                break;
+            case 'pre_tool_use':
+                this.handlePreToolUse(event);
+                break;
+            case 'activity':
+                this.handleActivity(event);
+                break;
+            case 'context_update':
+                this.handleContextUpdate(event);
+                break;
+            case 'idle':
+                this.handleIdle(event);
+                break;
+            case 'session_end':
+                this.handleSessionEnd(event);
+                break;
+            default:
+                this.logger.error(`[EventHandler] Unknown event type: ${event.event}`);
+        }
+    }
+    /**
+     * Handle session start event
+     */
+    handleSessionStart(event) {
+        const session = this.registry.registerSession(event);
+        this.broadcastService.broadcastSessionWithFocus(session);
+        // Start watching for handoff file
+        const projectDir = session.workspace?.project_dir || session.cwd;
+        if (projectDir) {
+            this.handoffWatcher.startWatching(session.session_id, projectDir);
+        }
+        this.branchDivergenceService?.scheduleCheck();
+        // Detect mode asynchronously and broadcast if found
+        this.registry.updateSessionMode(session.session_id).then((updatedSession) => {
+            if (updatedSession && updatedSession.mode) {
+                // Mode detected, broadcast the update
+                this.broadcastService.broadcastSessionWithFocus(updatedSession);
+            }
+        }).catch((err) => {
+            this.logger.warn(`[EventHandler] Failed to detect session mode: ${err}`);
+        });
+    }
+    /**
+     * Handle activity event
+     */
+    handleActivity(event) {
+        const session = this.registry.updateActivity(event);
+        if (session) {
+            // Activity doesn't change focus — only broadcast the session update
+            this.broadcastService.broadcastSessionUpdate(session);
+            this.branchDivergenceService?.scheduleCheck();
+            this.detectModeIfBypass(session);
+        }
+    }
+    /**
+     * Handle context update event
+     */
+    handleContextUpdate(event) {
+        const session = this.registry.updateContext(event);
+        if (session) {
+            // Context updates don't change focus — only broadcast the session update
+            this.broadcastService.broadcastSessionUpdate(session);
+            this.branchDivergenceService?.scheduleCheck();
+            this.notificationService?.onContextUpdate(session);
+            // Plan detection (debounced internally to 30s per session)
+            if (session.transcript_path) {
+                this.notificationService?.checkForNewPlans(session.session_id, session.transcript_path);
+            }
+            // Error scanning (incremental via byte offset)
+            if (session.transcript_path) {
+                this.notificationService?.scanForErrors(session.session_id, session.transcript_path);
+            }
+            // Note: Mode detection is NOT done here. permission_mode from hooks
+            // (PreToolUse, Activity, Idle, SessionStart) is the authoritative source.
+            // JSONL-based detection is only used at session registration time.
+            // Resolve jacques-continue skill titles from handoff data (async, fire-and-forget)
+            if (session.session_title && isContinueSession(session.session_title)) {
+                this.resolveContinueTitle(session);
+            }
+        }
+    }
+    /**
+     * Resolve a continue session title by reading the handoff file.
+     * Updates session title and broadcasts when resolved.
+     */
+    async resolveContinueTitle(session) {
+        try {
+            const startedAt = new Date(session.registered_at).toISOString();
+            const resolved = await extractContinueTitleFromHandoff(session.cwd, startedAt);
+            if (resolved) {
+                session.session_title = resolved;
+                this.broadcastService.broadcastSessionUpdate(session);
+            }
+        }
+        catch {
+            // Silent — formatSessionTitle handles the fallback display
+        }
+    }
+    /**
+     * Handle pre-tool-use event (PreToolUse hook)
+     * Starts a debounced awaiting timer — if PostToolUse doesn't arrive
+     * within 1 second, the session status changes to 'awaiting'.
+     */
+    handlePreToolUse(event) {
+        this.registry.setSessionAwaiting(event.session_id, event.tool_name, event.permission_mode, (session) => {
+            this.broadcastService.broadcastSessionUpdate(session);
+        }, event.terminal_pid);
+    }
+    /**
+     * Handle idle event
+     */
+    handleIdle(event) {
+        const session = this.registry.setSessionIdle(event.session_id, event.permission_mode, event.terminal_pid);
+        if (session) {
+            // Idle doesn't change focus, so just broadcast the session update
+            this.broadcastService.broadcastSessionUpdate(session);
+            this.detectModeIfBypass(session);
+        }
+    }
+    /**
+     * For bypass sessions, hook permission_mode is unreliable (always reports acceptEdits).
+     * Detect mode from JSONL transcript instead and broadcast if changed.
+     */
+    detectModeIfBypass(session) {
+        if (!session.is_bypass)
+            return;
+        // 30s debounce per session — JSONL re-read is expensive
+        const lastCheck = this.modeCheckTimestamps.get(session.session_id) ?? 0;
+        if (Date.now() - lastCheck < 30_000)
+            return;
+        this.modeCheckTimestamps.set(session.session_id, Date.now());
+        const modeBefore = session.mode;
+        this.registry.updateSessionMode(session.session_id).then((updated) => {
+            if (updated && updated.mode !== modeBefore) {
+                this.broadcastService.broadcastSessionUpdate(updated);
+            }
+        }).catch(() => { });
+    }
+    /**
+     * Handle session end event
+     */
+    handleSessionEnd(event) {
+        this.modeCheckTimestamps.delete(event.session_id);
+        // unregisterSession triggers onSessionRemoved callback which handles:
+        // - WebSocket broadcast (session_removed + focus_changed)
+        // - Notification cleanup
+        // - Handoff watcher stop
+        // - Catalog extraction
+        this.registry.unregisterSession(event.session_id);
+    }
+}
+//# sourceMappingURL=event-handler.js.map

package/dist/handlers/event-handler.js.map

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

package/dist/handlers/event-handler.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Event Handler Tests
+ */
+export {};
+//# sourceMappingURL=event-handler.test.d.ts.map

package/dist/handlers/event-handler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-handler.test.d.ts","sourceRoot":"","sources":["../../src/handlers/event-handler.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}