@jacques-ai/server 0.0.7-alpha.1

package/dist/session-registry.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Session Registry
+ *
+ * Manages active AI sessions from multiple sources (Claude Code, Cursor, etc.)
+ * with focus detection. Focus is determined by terminal focus watcher.
+ *
+ * Delegates to:
+ * - SessionFactory: Session object creation from hooks, discovery, and context updates
+ * - ProcessMonitor: Process verification, bypass detection, PID management
+ * - CleanupService: Recently-ended tracking and stale session cleanup
+ */
+import type { Session, SessionStartEvent, ActivityEvent, ContextUpdateEvent } from './types.js';
+import type { Logger } from './logging/logger-factory.js';
+import type { DetectedSession } from './process-scanner.js';
+export interface SessionRegistryOptions {
+    /** Suppress console output */
+    silent?: boolean;
+    /** Callback when a session is removed (for triggering catalog extraction) */
+    onSessionRemoved?: (session: Session) => void;
+    /** Optional logger for dependency injection */
+    logger?: Logger;
+}
+/**
+ * SessionRegistry - tracks all active AI sessions from all sources
+ *
+ * Key behaviors:
+ * - Sessions are indexed by session_id
+ * - Sessions track their source (claude_code, cursor, etc.)
+ * - Focus is determined by terminal focus watcher (macOS AppleScript)
+ * - New session registration auto-focuses
+ * - Sessions can be manually focused via setFocusedSession
+ */
+export declare class SessionRegistry {
+    private sessions;
+    private focusedSessionId;
+    private logger;
+    private onSessionRemovedCallback?;
+    private awaitingTimers;
+    private processMonitor;
+    private cleanupService;
+    constructor(options?: SessionRegistryOptions);
+    private get log();
+    private get warn();
+    /**
+     * Detect session mode (planning/execution) from JSONL transcript.
+     *
+     * For plan mode detection, scans raw JSONL text for EnterPlanMode/ExitPlanMode
+     * tool names. This is more reliable than parsed entries because the parser only
+     * captures the first tool_use block per assistant message — ExitPlanMode can be
+     * bundled with other tools (Edit, Write) and get silently dropped.
+     */
+    private detectSessionMode;
+    /**
+     * Register a session discovered at startup from process scanning
+     * Creates a session with DISCOVERED: terminal key prefix
+     * @param discovered Detected session from process scanner
+     * @returns The created session, or existing session if already registered
+     */
+    registerDiscoveredSession(discovered: DetectedSession): Session;
+    /**
+     * Register a new session or update an existing auto-registered one
+     * @param event SessionStart event data
+     * @returns The created/updated session
+     */
+    registerSession(event: SessionStartEvent): Session;
+    /**
+     * Update session with activity event
+     * @param event Activity event data
+     * @returns Updated session or null if session not found
+     */
+    updateActivity(event: ActivityEvent): Session | null;
+    /**
+     * Update session with context data from statusLine or preCompact
+     * @param event Context update event data
+     * @returns Updated session (auto-creates if not found)
+     */
+    updateContext(event: ContextUpdateEvent): Session | null;
+    /**
+     * Update session mode by detecting from JSONL transcript.
+     */
+    updateSessionMode(sessionId: string): Promise<Session | null>;
+    /**
+     * Mark session as idle
+     */
+    setSessionIdle(sessionId: string, permissionMode?: string, terminalPid?: number): Session | null;
+    /**
+     * Start debounced awaiting status for a session.
+     */
+    setSessionAwaiting(sessionId: string, toolName: string, permissionMode: string | undefined, onTimeout: (session: Session) => void, terminalPid?: number): void;
+    /**
+     * Cancel a pending awaiting timer for a session
+     */
+    private cancelAwaitingTimer;
+    /**
+     * Update session mode from permission_mode hook field.
+     */
+    private updateModeFromPermission;
+    /**
+     * Mark a CWD as expecting a bypass session.
+     * Delegates to ProcessMonitor.
+     */
+    markPendingBypass(cwd: string): void;
+    /**
+     * Unregister a session
+     */
+    unregisterSession(sessionId: string): void;
+    /**
+     * Get a session by ID
+     */
+    getSession(sessionId: string): Session | undefined;
+    /**
+     * Get all sessions sorted by last activity (most recent first)
+     */
+    getAllSessions(): Session[];
+    /**
+     * Get the focused session ID
+     */
+    getFocusedSessionId(): string | null;
+    /**
+     * Get the focused session
+     */
+    getFocusedSession(): Session | null;
+    /**
+     * Manually set the focused session
+     */
+    setFocusedSession(sessionId: string): boolean;
+    /**
+     * Get the number of active sessions
+     */
+    getSessionCount(): number;
+    /**
+     * Check if a session exists
+     */
+    hasSession(sessionId: string): boolean;
+    /**
+     * Find a session by terminal key
+     */
+    findSessionByTerminalKey(terminalKey: string): Session | null;
+    /**
+     * Clear all sessions (for testing or reset)
+     */
+    clear(): void;
+    /**
+     * Start periodic cleanup of stale sessions.
+     * Delegates to CleanupService.
+     */
+    startCleanup(maxIdleMinutes?: number): void;
+    /**
+     * Stop periodic cleanup of stale sessions.
+     */
+    stopCleanup(): void;
+    /**
+     * Verify sessions are still valid.
+     * Delegates to ProcessMonitor.
+     */
+    verifyProcesses(): Promise<void>;
+    /**
+     * Detect bypass sessions by checking process command lines.
+     * Delegates to ProcessMonitor.
+     */
+    detectBypassSessions(): Promise<string[]>;
+    /**
+     * Start periodic process verification.
+     * Delegates to ProcessMonitor.
+     */
+    startProcessVerification(intervalMs?: number): void;
+}
+//# sourceMappingURL=session-registry.d.ts.map

package/dist/session-registry.d.ts.map

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