@jacques-ai/server 0.0.7-alpha.1

package/dist/connection/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Connection Layer
+ *
+ * Centralized module for Claude Code/Cursor session connection logic:
+ * - Process detection and PID handling
+ * - Terminal identity and activation
+ * - Session discovery and lifecycle
+ * - Focus detection and tracking
+ *
+ * @module connection
+ */
+export { DEFAULT_CONTEXT_WINDOW_SIZE, AUTOCOMPACT_BUG_THRESHOLD, DEFAULT_AUTOCOMPACT_THRESHOLD, ACTIVE_SESSION_THRESHOLD_MS, RECENTLY_ENDED_TTL_MS, IDLE_TIMEOUT_MS, PROCESS_VERIFY_INTERVAL_MS, CLEANUP_INTERVAL_MS, CATALOG_CACHE_MAX_AGE_MS, FOCUS_WATCHER_POLL_MS, FOCUS_WATCHER_IDLE_POLL_MS, TerminalKeyPrefix, TERMINAL_APP_NAMES, type TerminalAppName, } from './constants.js';
+export { parseTerminalKey, buildTerminalKey, extractPid, extractItermUuid, matchTerminalKeys, describeTerminalKey, type ParsedTerminalKey, type TerminalIdentity, } from './terminal-key.js';
+export { escapeAppleScript, runAppleScript, isAppleScriptAvailable, } from './applescript.js';
+export { detectGitInfo, type GitInfo, } from './git-info.js';
+export { findActiveSessionFiles, findMostRecentSessionFile, findRecentSessionFiles, type SessionFileInfo, } from './session-discovery.js';
+export { getClaudeProcesses, isProcessRunning, isProcessBypass, getPlatformInfo, type DetectedProcess, } from './process-detection.js';
+export { createWorktree, listWorktrees, listWorktreesWithStatus, removeWorktree, type CreateWorktreeOptions, type CreateWorktreeResult, type WorktreeEntry, type WorktreeWithStatus, type WorktreeStatus, type RemoveWorktreeOptions, type RemoveWorktreeResult, } from './worktree.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/connection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connection/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAEL,2BAA2B,EAC3B,yBAAyB,EACzB,6BAA6B,EAG7B,2BAA2B,EAC3B,qBAAqB,EACrB,eAAe,EACf,0BAA0B,EAC1B,mBAAmB,EACnB,wBAAwB,EAGxB,qBAAqB,EACrB,0BAA0B,EAG1B,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,aAAa,EACb,KAAK,OAAO,GACb,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,EACtB,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,cAAc,EACd,aAAa,EACb,uBAAuB,EACvB,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,eAAe,CAAC"}

package/dist/connection/index.js

@@ -0,0 +1,36 @@
+/**
+ * Connection Layer
+ *
+ * Centralized module for Claude Code/Cursor session connection logic:
+ * - Process detection and PID handling
+ * - Terminal identity and activation
+ * - Session discovery and lifecycle
+ * - Focus detection and tracking
+ *
+ * @module connection
+ */
+// Constants and configuration
+export { 
+// Context window limits
+DEFAULT_CONTEXT_WINDOW_SIZE, AUTOCOMPACT_BUG_THRESHOLD, DEFAULT_AUTOCOMPACT_THRESHOLD, 
+// Session timing thresholds
+ACTIVE_SESSION_THRESHOLD_MS, RECENTLY_ENDED_TTL_MS, IDLE_TIMEOUT_MS, PROCESS_VERIFY_INTERVAL_MS, CLEANUP_INTERVAL_MS, CATALOG_CACHE_MAX_AGE_MS, 
+// Focus detection
+FOCUS_WATCHER_POLL_MS, FOCUS_WATCHER_IDLE_POLL_MS, 
+// Terminal key prefixes
+TerminalKeyPrefix, TERMINAL_APP_NAMES, } from './constants.js';
+// Terminal key utilities
+export { parseTerminalKey, buildTerminalKey, extractPid, extractItermUuid, matchTerminalKeys, describeTerminalKey, } from './terminal-key.js';
+// AppleScript utilities
+export { escapeAppleScript, runAppleScript, isAppleScriptAvailable, } from './applescript.js';
+// Git detection
+export { detectGitInfo, } from './git-info.js';
+// Session discovery
+export { findActiveSessionFiles, findMostRecentSessionFile, findRecentSessionFiles, } from './session-discovery.js';
+// Process detection
+export { getClaudeProcesses, isProcessRunning, isProcessBypass, getPlatformInfo, } from './process-detection.js';
+// Worktree management
+export { createWorktree, listWorktrees, listWorktreesWithStatus, removeWorktree, } from './worktree.js';
+// Focus tracking remains in server/src/focus-watcher.ts (refactored to use shared utilities)
+// Terminal activation remains in server/src/terminal-activator.ts (uses shared applescript)
+//# sourceMappingURL=index.js.map

package/dist/connection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/connection/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,8BAA8B;AAC9B,OAAO;AACL,wBAAwB;AACxB,2BAA2B,EAC3B,yBAAyB,EACzB,6BAA6B;AAE7B,4BAA4B;AAC5B,2BAA2B,EAC3B,qBAAqB,EACrB,eAAe,EACf,0BAA0B,EAC1B,mBAAmB,EACnB,wBAAwB;AAExB,kBAAkB;AAClB,qBAAqB,EACrB,0BAA0B;AAE1B,wBAAwB;AACxB,iBAAiB,EACjB,kBAAkB,GAEnB,MAAM,gBAAgB,CAAC;AAExB,yBAAyB;AACzB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,GAGpB,MAAM,mBAAmB,CAAC;AAE3B,wBAAwB;AACxB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,gBAAgB;AAChB,OAAO,EACL,aAAa,GAEd,MAAM,eAAe,CAAC;AAEvB,oBAAoB;AACpB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,GAEvB,MAAM,wBAAwB,CAAC;AAEhC,oBAAoB;AACpB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,eAAe,GAEhB,MAAM,wBAAwB,CAAC;AAEhC,sBAAsB;AACtB,OAAO,EACL,cAAc,EACd,aAAa,EACb,uBAAuB,EACvB,cAAc,GAQf,MAAM,eAAe,CAAC;AAEvB,6FAA6F;AAC7F,4FAA4F"}

package/dist/connection/process-detection.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Process Detection
+ *
+ * Cross-platform detection of running Claude Code processes.
+ * Supports macOS, Linux, and Windows.
+ *
+ * @module connection/process-detection
+ */
+/**
+ * Information about a detected running Claude process
+ */
+export interface DetectedProcess {
+    pid: number;
+    tty: string;
+    cwd: string;
+    /** Terminal type detected from environment (if available) */
+    terminalType?: string;
+    /** Terminal session ID (WT_SESSION, ITERM_SESSION_ID, etc.) */
+    terminalSessionId?: string;
+    /** Whether the process was launched with --dangerously-skip-permissions */
+    isBypass?: boolean;
+}
+/**
+ * Get all running Claude Code processes.
+ *
+ * Platform-specific:
+ * - macOS/Linux: Uses pgrep, ps, lsof
+ * - Windows: Uses PowerShell (Get-Process, Get-WmiObject)
+ */
+export declare function getClaudeProcesses(): Promise<DetectedProcess[]>;
+/**
+ * Check if a process is still running.
+ *
+ * Uses `kill -0` on Unix (checks existence without sending a signal)
+ * and PowerShell on Windows.
+ *
+ * @param pid Process ID to check
+ * @returns True if the process is still running
+ */
+export declare function isProcessRunning(pid: number): Promise<boolean>;
+/**
+ * Check if a specific process was launched with --dangerously-skip-permissions.
+ * Reads the process command line to determine this.
+ *
+ * @param pid Process ID to check
+ * @returns True if the process has the bypass flag
+ */
+export declare function isProcessBypass(pid: number): Promise<boolean>;
+/**
+ * Get platform information for diagnostics
+ */
+export declare function getPlatformInfo(): {
+    platform: string;
+    isWindows: boolean;
+    isMac: boolean;
+    isLinux: boolean;
+};
+//# sourceMappingURL=process-detection.d.ts.map

package/dist/connection/process-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-detection.d.ts","sourceRoot":"","sources":["../../src/connection/process-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAMrE;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAapE;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBnE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB,CAGA"}

package/dist/connection/process-detection.js

@@ -0,0 +1,239 @@
+/**
+ * Process Detection
+ *
+ * Cross-platform detection of running Claude Code processes.
+ * Supports macOS, Linux, and Windows.
+ *
+ * @module connection/process-detection
+ */
+import { exec as execCb } from 'child_process';
+import { promisify } from 'util';
+import { platform } from 'process';
+const execAsync = promisify(execCb);
+const isWindows = platform === 'win32';
+const isLinux = platform === 'linux';
+/**
+ * Get all running Claude Code processes.
+ *
+ * Platform-specific:
+ * - macOS/Linux: Uses pgrep, ps, lsof
+ * - Windows: Uses PowerShell (Get-Process, Get-WmiObject)
+ */
+export async function getClaudeProcesses() {
+    if (isWindows) {
+        return getClaudeProcessesWindows();
+    }
+    else {
+        return getClaudeProcessesUnix();
+    }
+}
+/**
+ * Check if a process is still running.
+ *
+ * Uses `kill -0` on Unix (checks existence without sending a signal)
+ * and PowerShell on Windows.
+ *
+ * @param pid Process ID to check
+ * @returns True if the process is still running
+ */
+export async function isProcessRunning(pid) {
+    if (pid <= 0)
+        return false;
+    try {
+        if (isWindows) {
+            await execAsync(`powershell.exe -NoProfile -Command "Get-Process -Id ${pid} -ErrorAction Stop"`, { timeout: 3000 });
+        }
+        else {
+            await execAsync(`kill -0 ${pid} 2>/dev/null`);
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a specific process was launched with --dangerously-skip-permissions.
+ * Reads the process command line to determine this.
+ *
+ * @param pid Process ID to check
+ * @returns True if the process has the bypass flag
+ */
+export async function isProcessBypass(pid) {
+    if (pid <= 0)
+        return false;
+    try {
+        if (isWindows) {
+            const { stdout } = await execAsync(`powershell.exe -NoProfile -Command "(Get-WmiObject Win32_Process -Filter 'ProcessId=${pid}').CommandLine"`, { timeout: 3000 });
+            return stdout.includes('--dangerously-skip-permissions');
+        }
+        else {
+            const { stdout } = await execAsync(`ps -o args= -p ${pid}`, { timeout: 3000 });
+            return stdout.includes('--dangerously-skip-permissions');
+        }
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get platform information for diagnostics
+ */
+export function getPlatformInfo() {
+    const isMac = platform === 'darwin';
+    return { platform, isWindows, isMac, isLinux };
+}
+// ============================================================
+// Unix Process Detection
+// ============================================================
+async function getClaudeProcessesUnix() {
+    try {
+        const { stdout: pgrepOut } = await execAsync('pgrep -x claude');
+        const pids = pgrepOut
+            .trim()
+            .split('\n')
+            .filter((p) => p)
+            .map((p) => parseInt(p, 10));
+        if (pids.length === 0) {
+            return [];
+        }
+        const processes = [];
+        for (const pid of pids) {
+            try {
+                // Get TTY and full command line in one ps call
+                const { stdout: psOut } = await execAsync(`ps -o tty=,args= -p ${pid}`);
+                const psLine = psOut.trim();
+                // First token is TTY, rest is the command
+                const firstSpace = psLine.indexOf(' ');
+                const rawTty = firstSpace > 0 ? psLine.slice(0, firstSpace).trim() : psLine;
+                const tty = (!rawTty || rawTty === '??' || rawTty === '?') ? '?' : rawTty;
+                const cmdLine = firstSpace > 0 ? psLine.slice(firstSpace).trim() : '';
+                const isBypass = cmdLine.includes('--dangerously-skip-permissions');
+                const { stdout: lsofOut } = await execAsync(`lsof -p ${pid} 2>/dev/null | grep cwd | awk '{print $NF}'`);
+                const cwd = lsofOut.trim();
+                if (cwd) {
+                    const terminalInfo = await getTerminalInfoUnix(pid);
+                    processes.push({
+                        pid,
+                        tty,
+                        cwd,
+                        terminalType: terminalInfo.type,
+                        terminalSessionId: terminalInfo.sessionId,
+                        isBypass,
+                    });
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return processes;
+    }
+    catch {
+        // pgrep returns exit code 1 if no processes found
+        return [];
+    }
+}
+/**
+ * Try to get terminal info from process environment on Unix
+ */
+async function getTerminalInfoUnix(pid) {
+    try {
+        if (isLinux) {
+            const { stdout } = await execAsync(`cat /proc/${pid}/environ 2>/dev/null | tr '\\0' '\\n' | grep -E '^(ITERM_SESSION_ID|TERM_SESSION_ID|KITTY_WINDOW_ID|WEZTERM_PANE|WT_SESSION)='`);
+            return parseTerminalEnvOutput(stdout);
+        }
+        // On macOS, we can't easily read another process's environment
+        return {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Parse terminal environment variable output
+ */
+function parseTerminalEnvOutput(output) {
+    const lines = output.trim().split('\n');
+    for (const line of lines) {
+        const [key, value] = line.split('=');
+        if (!value)
+            continue;
+        switch (key) {
+            case 'ITERM_SESSION_ID':
+                return { type: 'iTerm2', sessionId: value };
+            case 'TERM_SESSION_ID':
+                return { type: 'Terminal.app', sessionId: value };
+            case 'KITTY_WINDOW_ID':
+                return { type: 'Kitty', sessionId: value };
+            case 'WEZTERM_PANE':
+                return { type: 'WezTerm', sessionId: value };
+            case 'WT_SESSION':
+                return { type: 'Windows Terminal', sessionId: value };
+        }
+    }
+    return {};
+}
+// ============================================================
+// Windows Process Detection
+// ============================================================
+async function getClaudeProcessesWindows() {
+    try {
+        const psScript = `
+      $ErrorActionPreference = 'SilentlyContinue'
+      Get-Process -Name claude,claude-code 2>$null | ForEach-Object {
+        $proc = $_
+        try {
+          $wmi = Get-WmiObject Win32_Process -Filter "ProcessId=$($proc.Id)" 2>$null
+          if ($wmi) {
+            $cwd = $null
+            $cmdLine = $wmi.CommandLine
+            if ($cmdLine) {
+              $cmdClean = $cmdLine -replace '^\\"[^\\"]*\\"\\s*|^\\S+\\s*', ''
+              $cmdClean = $cmdClean.Trim().Trim('"')
+              if ($cmdClean -and (Test-Path $cmdClean -PathType Container -ErrorAction SilentlyContinue)) {
+                $cwd = $cmdClean
+              }
+            }
+            if (-not $cwd -and $wmi.ExecutablePath) {
+              $cwd = Split-Path -Parent $wmi.ExecutablePath
+            }
+            $wtSession = [System.Environment]::GetEnvironmentVariable('WT_SESSION', 'Process')
+            @{
+              PID = $proc.Id
+              CWD = $cwd
+              WT_SESSION = $wtSession
+              CommandLine = $cmdLine
+            } | ConvertTo-Json -Compress
+          }
+        } catch {}
+      }
+    `.replace(/\n/g, ' ');
+        const { stdout } = await execAsync(`powershell.exe -NoProfile -Command "${psScript}"`, { timeout: 10000 });
+        const processes = [];
+        const lines = stdout.trim().split('\n').filter((l) => l.trim());
+        for (const line of lines) {
+            try {
+                const data = JSON.parse(line);
+                if (data.CWD) {
+                    processes.push({
+                        pid: data.PID,
+                        tty: `PID:${data.PID}`,
+                        cwd: data.CWD,
+                        terminalType: data.WT_SESSION ? 'Windows Terminal' : 'PowerShell/cmd',
+                        terminalSessionId: data.WT_SESSION || undefined,
+                        isBypass: data.CommandLine?.includes('--dangerously-skip-permissions') || false,
+                    });
+                }
+            }
+            catch {
+                // Skip malformed JSON
+            }
+        }
+        return processes;
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=process-detection.js.map

package/dist/connection/process-detection.js.map

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

package/dist/connection/process-detection.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for process-detection module
+ */
+export {};
+//# sourceMappingURL=process-detection.test.d.ts.map

package/dist/connection/process-detection.test.d.ts.map

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

package/dist/connection/process-detection.test.js

@@ -0,0 +1,43 @@
+/**
+ * Tests for process-detection module
+ */
+import { isProcessRunning, getPlatformInfo } from './process-detection.js';
+describe('isProcessRunning', () => {
+    it('returns true for current process', async () => {
+        const result = await isProcessRunning(process.pid);
+        expect(result).toBe(true);
+    });
+    it('returns false for non-existent PID', async () => {
+        // Use a very high PID that's unlikely to exist
+        const result = await isProcessRunning(999999);
+        expect(result).toBe(false);
+    });
+    it('returns false for PID 0', async () => {
+        const result = await isProcessRunning(0);
+        expect(result).toBe(false);
+    });
+    it('returns false for negative PID', async () => {
+        const result = await isProcessRunning(-1);
+        expect(result).toBe(false);
+    });
+});
+describe('getPlatformInfo', () => {
+    it('returns platform info object', () => {
+        const info = getPlatformInfo();
+        expect(info).toHaveProperty('platform');
+        expect(info).toHaveProperty('isWindows');
+        expect(info).toHaveProperty('isMac');
+        expect(info).toHaveProperty('isLinux');
+        expect(typeof info.platform).toBe('string');
+        expect(typeof info.isWindows).toBe('boolean');
+        expect(typeof info.isMac).toBe('boolean');
+        expect(typeof info.isLinux).toBe('boolean');
+    });
+    it('has consistent platform flags', () => {
+        const info = getPlatformInfo();
+        // At most one platform should be true
+        const trueCount = [info.isWindows, info.isMac, info.isLinux].filter(Boolean).length;
+        expect(trueCount).toBeLessThanOrEqual(1);
+    });
+});
+//# sourceMappingURL=process-detection.test.js.map

package/dist/connection/process-detection.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-detection.test.js","sourceRoot":"","sources":["../../src/connection/process-detection.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE3E,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,+CAA+C;QAC/C,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,KAAK,IAAI,EAAE;QACvC,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC9C,MAAM,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;QAC/B,sCAAsC;QACtC,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QACpF,MAAM,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/connection/session-discovery.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Session Discovery
+ *
+ * Finds and resolves metadata for JSONL session files in Claude's project directories.
+ * Uses a catalog-first strategy: reads pre-extracted metadata from Jacques session index
+ * when available, falls back to JSONL parsing for uncataloged sessions.
+ *
+ * @module connection/session-discovery
+ */
+import { type SessionEntry } from '@jacques-ai/core/cache';
+import type { ContextMetrics, SessionMode } from '../types.js';
+/**
+ * JSONL file info with parsed metadata
+ */
+export interface SessionFileInfo {
+    filePath: string;
+    sessionId: string;
+    modifiedAt: Date;
+    gitBranch: string | null;
+    gitWorktree: string | null;
+    gitRepoRoot: string | null;
+    title: string | null;
+    contextMetrics: ContextMetrics | null;
+    mode: SessionMode;
+}
+/**
+ * Find all active session files for a given CWD.
+ * Uses catalog-first strategy: reads from Jacques session index when available,
+ * falls back to JSONL parsing for uncataloged sessions.
+ *
+ * @param cwd Working directory to find sessions for
+ * @param catalogMap Pre-loaded session catalog (sessionId -> SessionEntry)
+ * @returns Sessions modified within ACTIVE_SESSION_THRESHOLD_MS, sorted by recency
+ */
+export declare function findActiveSessionFiles(cwd: string, catalogMap: Map<string, SessionEntry>): Promise<SessionFileInfo[]>;
+/**
+ * Find the most recent session file for a CWD (fallback for inactive detection).
+ * Uses catalog-first strategy when available.
+ *
+ * @param cwd Working directory to find sessions for
+ * @param catalogMap Pre-loaded session catalog (sessionId -> SessionEntry)
+ */
+export declare function findMostRecentSessionFile(cwd: string, catalogMap: Map<string, SessionEntry>): Promise<SessionFileInfo | null>;
+/**
+ * Find the N most recently modified session files for a CWD, regardless of activity threshold.
+ * Used when there are more running processes than active session files to discover idle sessions.
+ *
+ * @param cwd Working directory to find sessions for
+ * @param catalogMap Pre-loaded session catalog (sessionId -> SessionEntry)
+ * @param count Maximum number of files to return
+ * @param excludeIds Session IDs to skip (already registered)
+ * @returns Up to `count` most recent session files, sorted by recency
+ */
+export declare function findRecentSessionFiles(cwd: string, catalogMap: Map<string, SessionEntry>, count: number, excludeIds: Set<string>): Promise<SessionFileInfo[]>;
+//# sourceMappingURL=session-discovery.d.ts.map

package/dist/connection/session-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-discovery.d.ts","sourceRoot":"","sources":["../../src/connection/session-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAO/D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,IAAI,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,IAAI,EAAE,WAAW,CAAC;CACnB;AA4ED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GACpC,OAAO,CAAC,eAAe,EAAE,CAAC,CA0C5B;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GACpC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAwCjC;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EACrC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GACtB,OAAO,CAAC,eAAe,EAAE,CAAC,CA+C5B"}