@jacques-ai/server 0.0.7-alpha.1

package/dist/config/config.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Centralized Server Configuration
+ *
+ * All configuration values used by the Jacques server.
+ * Values are sourced from environment variables with sensible defaults.
+ */
+/**
+ * Server configuration object
+ */
+export declare const ServerConfig: {
+    /** IPC socket path for hook communication (Unix socket or Windows Named Pipe) */
+    readonly unixSocketPath: string;
+    /** WebSocket port for dashboard connections */
+    readonly wsPort: number;
+    /** HTTP API port for REST endpoints */
+    readonly httpPort: number;
+    /** Path to Claude Code settings.json */
+    readonly claudeSettingsPath: string;
+    /** Name of the handoff file watched in project directories */
+    readonly handoffFilename: ".jacques-handoff.md";
+    /** Auto-compact threshold percentage */
+    readonly autoCompactThreshold: number;
+    /** Stale session cleanup interval in minutes */
+    readonly staleSessionCleanupMinutes: 60;
+    /** Focus watcher polling interval in milliseconds */
+    readonly focusWatcherPollMs: 2000;
+    /** Cleanup interval in minutes */
+    readonly cleanupIntervalMinutes: 5;
+};
+/**
+ * Type for the server configuration
+ */
+export type ServerConfigType = typeof ServerConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB,iFAAiF;;IAIjF,+CAA+C;;IAG/C,uCAAuC;;IAGvC,wCAAwC;;IAGxC,8DAA8D;;IAG9D,wCAAwC;;IAGxC,gDAAgD;;IAGhD,qDAAqD;;IAGrD,kCAAkC;;CAE1B,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,YAAY,CAAC"}

package/dist/config/config.js

@@ -0,0 +1,32 @@
+/**
+ * Centralized Server Configuration
+ *
+ * All configuration values used by the Jacques server.
+ * Values are sourced from environment variables with sensible defaults.
+ */
+import { getClaudeSettingsPath } from '@jacques-ai/core/session';
+/**
+ * Server configuration object
+ */
+export const ServerConfig = {
+    /** IPC socket path for hook communication (Unix socket or Windows Named Pipe) */
+    unixSocketPath: process.env.JACQUES_SOCKET_PATH ||
+        (process.platform === 'win32' ? '\\\\.\\pipe\\jacques' : '/tmp/jacques.sock'),
+    /** WebSocket port for dashboard connections */
+    wsPort: parseInt(process.env.JACQUES_WS_PORT || '4242', 10),
+    /** HTTP API port for REST endpoints */
+    httpPort: parseInt(process.env.JACQUES_HTTP_PORT || '4243', 10),
+    /** Path to Claude Code settings.json */
+    claudeSettingsPath: getClaudeSettingsPath(),
+    /** Name of the handoff file watched in project directories */
+    handoffFilename: '.jacques-handoff.md',
+    /** Auto-compact threshold percentage */
+    autoCompactThreshold: parseInt(process.env.CLAUDE_AUTOCOMPACT_PCT_OVERRIDE || '95', 10),
+    /** Stale session cleanup interval in minutes */
+    staleSessionCleanupMinutes: 60,
+    /** Focus watcher polling interval in milliseconds */
+    focusWatcherPollMs: 2000,
+    /** Cleanup interval in minutes */
+    cleanupIntervalMinutes: 5,
+};
+//# sourceMappingURL=config.js.map

package/dist/config/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,iFAAiF;IACjF,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;QAC7C,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,mBAAmB,CAAC;IAE/E,+CAA+C;IAC/C,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,MAAM,EAAE,EAAE,CAAC;IAE3D,uCAAuC;IACvC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,MAAM,EAAE,EAAE,CAAC;IAE/D,wCAAwC;IACxC,kBAAkB,EAAE,qBAAqB,EAAE;IAE3C,8DAA8D;IAC9D,eAAe,EAAE,qBAAqB;IAEtC,wCAAwC;IACxC,oBAAoB,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,+BAA+B,IAAI,IAAI,EAAE,EAAE,CAAC;IAEvF,gDAAgD;IAChD,0BAA0B,EAAE,EAAE;IAE9B,qDAAqD;IACrD,kBAAkB,EAAE,IAAI;IAExB,kCAAkC;IAClC,sBAAsB,EAAE,CAAC;CACjB,CAAC"}

package/dist/connection/applescript.d.ts

@@ -0,0 +1,46 @@
+/**
+ * AppleScript Utilities
+ *
+ * Centralized utilities for executing AppleScript on macOS.
+ * Used for terminal activation, focus detection, and window management.
+ *
+ * @module connection/applescript
+ */
+/**
+ * Escape single quotes in AppleScript for shell execution.
+ *
+ * When passing AppleScript to `osascript -e`, single quotes in the script
+ * must be escaped. This function replaces ' with '\'' which:
+ * 1. Ends the single-quoted string
+ * 2. Adds an escaped single quote
+ * 3. Starts a new single-quoted string
+ *
+ * @param script The AppleScript code to escape
+ * @returns Escaped script safe for shell execution
+ *
+ * @example
+ * escapeAppleScript("tell app 'Finder'") // "tell app '\\''Finder'\\''"
+ */
+export declare function escapeAppleScript(script: string): string;
+/**
+ * Execute an AppleScript or JXA script and return the result.
+ *
+ * For AppleScript: wraps the script in proper shell escaping and executes via `osascript`.
+ * For JavaScript (JXA): uses `execFile` to avoid shell injection with complex scripts.
+ * Returns the trimmed stdout from the script execution.
+ *
+ * @param script The script code to execute
+ * @param language The scripting language: 'AppleScript' (default) or 'JavaScript' (JXA)
+ * @returns Promise resolving to the trimmed output string
+ * @throws Error if script execution fails
+ */
+export declare function runAppleScript(script: string, language?: 'AppleScript' | 'JavaScript'): Promise<string>;
+/**
+ * Check if AppleScript is available on this platform.
+ *
+ * AppleScript is only available on macOS (darwin).
+ *
+ * @returns True if running on macOS
+ */
+export declare function isAppleScriptAvailable(): boolean;
+//# sourceMappingURL=applescript.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"applescript.d.ts","sourceRoot":"","sources":["../../src/connection/applescript.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,aAAa,GAAG,YAA4B,GACrD,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD"}

package/dist/connection/applescript.js

@@ -0,0 +1,62 @@
+/**
+ * AppleScript Utilities
+ *
+ * Centralized utilities for executing AppleScript on macOS.
+ * Used for terminal activation, focus detection, and window management.
+ *
+ * @module connection/applescript
+ */
+import { exec as execCb, execFile as execFileCb } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(execCb);
+const execFileAsync = promisify(execFileCb);
+/**
+ * Escape single quotes in AppleScript for shell execution.
+ *
+ * When passing AppleScript to `osascript -e`, single quotes in the script
+ * must be escaped. This function replaces ' with '\'' which:
+ * 1. Ends the single-quoted string
+ * 2. Adds an escaped single quote
+ * 3. Starts a new single-quoted string
+ *
+ * @param script The AppleScript code to escape
+ * @returns Escaped script safe for shell execution
+ *
+ * @example
+ * escapeAppleScript("tell app 'Finder'") // "tell app '\\''Finder'\\''"
+ */
+export function escapeAppleScript(script) {
+    return script.replace(/'/g, "'\\''");
+}
+/**
+ * Execute an AppleScript or JXA script and return the result.
+ *
+ * For AppleScript: wraps the script in proper shell escaping and executes via `osascript`.
+ * For JavaScript (JXA): uses `execFile` to avoid shell injection with complex scripts.
+ * Returns the trimmed stdout from the script execution.
+ *
+ * @param script The script code to execute
+ * @param language The scripting language: 'AppleScript' (default) or 'JavaScript' (JXA)
+ * @returns Promise resolving to the trimmed output string
+ * @throws Error if script execution fails
+ */
+export async function runAppleScript(script, language = 'AppleScript') {
+    if (language === 'JavaScript') {
+        // Use execFile to avoid shell injection with complex JXA scripts
+        const { stdout } = await execFileAsync('osascript', ['-l', 'JavaScript', '-e', script]);
+        return stdout.trim();
+    }
+    const { stdout } = await execAsync(`osascript -e '${escapeAppleScript(script)}'`);
+    return stdout.trim();
+}
+/**
+ * Check if AppleScript is available on this platform.
+ *
+ * AppleScript is only available on macOS (darwin).
+ *
+ * @returns True if running on macOS
+ */
+export function isAppleScriptAvailable() {
+    return process.platform === 'darwin';
+}
+//# sourceMappingURL=applescript.js.map

package/dist/connection/applescript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applescript.js","sourceRoot":"","sources":["../../src/connection/applescript.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,QAAQ,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AACpC,MAAM,aAAa,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;AAE5C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,WAAyC,aAAa;IAEtD,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC9B,iEAAiE;QACjE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QACxF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,iBAAiB,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAClF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC;AACvC,CAAC"}

package/dist/connection/applescript.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for AppleScript utilities
+ */
+export {};
+//# sourceMappingURL=applescript.test.d.ts.map

package/dist/connection/applescript.test.d.ts.map

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

package/dist/connection/applescript.test.js

@@ -0,0 +1,64 @@
+/**
+ * Tests for AppleScript utilities
+ */
+import { escapeAppleScript, isAppleScriptAvailable } from './applescript.js';
+describe('escapeAppleScript', () => {
+    it('escapes single quotes', () => {
+        const input = "tell app 'Finder' to activate";
+        const escaped = escapeAppleScript(input);
+        expect(escaped).toBe("tell app '\\''Finder'\\'' to activate");
+    });
+    it('handles multiple single quotes', () => {
+        const input = "'one' 'two' 'three'";
+        const escaped = escapeAppleScript(input);
+        expect(escaped).toBe("'\\''one'\\'' '\\''two'\\'' '\\''three'\\''");
+    });
+    it('returns unchanged string without quotes', () => {
+        const input = 'tell application "System Events" to return name';
+        const escaped = escapeAppleScript(input);
+        expect(escaped).toBe(input);
+    });
+    it('handles empty string', () => {
+        expect(escapeAppleScript('')).toBe('');
+    });
+    it('handles string with only single quote', () => {
+        expect(escapeAppleScript("'")).toBe("'\\''");
+    });
+    it('handles multiline scripts', () => {
+        const script = `tell application "iTerm2"
+      repeat with w in windows
+        if name of w is 'Main' then
+          return "found"
+        end if
+      end repeat
+    end tell`;
+        const escaped = escapeAppleScript(script);
+        // The single quotes around 'Main' should be escaped
+        expect(escaped).toContain("'\\''Main'\\''");
+        // Original unescaped pattern should not appear
+        expect(escaped).not.toContain(" 'Main' ");
+    });
+    it('handles consecutive single quotes', () => {
+        expect(escapeAppleScript("''")).toBe("'\\'''\\''");
+    });
+    it('handles quotes at start and end', () => {
+        expect(escapeAppleScript("'test'")).toBe("'\\''test'\\''");
+    });
+});
+describe('isAppleScriptAvailable', () => {
+    it('returns boolean based on platform', () => {
+        const result = isAppleScriptAvailable();
+        expect(typeof result).toBe('boolean');
+        // On macOS it should be true, on other platforms false
+        if (process.platform === 'darwin') {
+            expect(result).toBe(true);
+        }
+        else {
+            expect(result).toBe(false);
+        }
+    });
+});
+// Note: runAppleScript is tested implicitly through integration tests
+// since it requires actual osascript execution. Unit tests would need
+// mocking which adds complexity without much value for this simple wrapper.
+//# sourceMappingURL=applescript.test.js.map

package/dist/connection/applescript.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applescript.test.js","sourceRoot":"","sources":["../../src/connection/applescript.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE7E,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,KAAK,GAAG,+BAA+B,CAAC;QAC9C,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,KAAK,GAAG,qBAAqB,CAAC;QACpC,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,KAAK,GAAG,iDAAiD,CAAC;QAChE,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,MAAM,GAAG;;;;;;aAMN,CAAC;QACV,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1C,oDAAoD;QACpD,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC5C,+CAA+C;QAC/C,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;QACxC,MAAM,CAAC,OAAO,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtC,uDAAuD;QACvD,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,sEAAsE;AACtE,sEAAsE;AACtE,4EAA4E"}

package/dist/connection/constants.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Connection Layer Constants
+ *
+ * Centralized configuration values for the Claude Code connection layer.
+ * These control timing thresholds, context window sizes, and terminal key formats.
+ */
+/** Default Claude context window size in tokens */
+export declare const DEFAULT_CONTEXT_WINDOW_SIZE = 200000;
+/**
+ * Bug threshold for autocompact.
+ * When autocompact is disabled, it still triggers at ~78% instead of the configured threshold.
+ * See: https://github.com/anthropics/claude-code/issues/XXX
+ */
+export declare const AUTOCOMPACT_BUG_THRESHOLD = 78;
+/** Default autocompact threshold percentage when enabled */
+export declare const DEFAULT_AUTOCOMPACT_THRESHOLD = 95;
+/**
+ * Active session threshold for process discovery.
+ * Sessions with JSONL files modified within this window are considered "active".
+ */
+export declare const ACTIVE_SESSION_THRESHOLD_MS: number;
+/**
+ * Recently ended session TTL.
+ * Prevents re-registration of sessions via stale context_update events
+ * (fixes duplicate sessions on /clear command).
+ */
+export declare const RECENTLY_ENDED_TTL_MS = 30000;
+/**
+ * Idle session timeout.
+ * Sessions with no activity for this duration are considered stale and removed.
+ * Catches sessions where user walked away without /exit or closing terminal.
+ */
+export declare const IDLE_TIMEOUT_MS: number;
+/** Interval between process liveness verification checks */
+export declare const PROCESS_VERIFY_INTERVAL_MS = 30000;
+/** Interval between branch divergence checks */
+export declare const BRANCH_DIVERGENCE_INTERVAL_MS = 60000;
+/** Interval between stale session cleanup runs */
+export declare const CLEANUP_INTERVAL_MS: number;
+/** Max age for session catalog cache at startup */
+export declare const CATALOG_CACHE_MAX_AGE_MS: number;
+/** Polling interval for focus watcher when terminal is focused */
+export declare const FOCUS_WATCHER_POLL_MS = 500;
+/** Polling interval for focus watcher when terminal is not focused (slower) */
+export declare const FOCUS_WATCHER_IDLE_POLL_MS = 1500;
+/**
+ * Terminal key prefix identifiers.
+ * Terminal keys follow the format: PREFIX:value
+ *
+ * Examples:
+ * - ITERM:w0t0p0:ABC123-DEF456 (iTerm2 with window/tab/pane + UUID)
+ * - ITERM:ABC123-DEF456 (iTerm2 UUID only)
+ * - TTY:/dev/ttys001 (Terminal.app or generic Unix)
+ * - PID:12345 (Fallback when no better identifier)
+ * - KITTY:42 (Kitty window ID)
+ * - WEZTERM:pane:0 (WezTerm pane ID)
+ * - DISCOVERED:TTY:ttys001:12345 (Session discovered at startup)
+ * - AUTO:session-uuid (Auto-registered from context_update)
+ */
+export declare enum TerminalKeyPrefix {
+    /** iTerm2 terminal (macOS) */
+    ITERM = "ITERM",
+    /** Kitty terminal (cross-platform) */
+    KITTY = "KITTY",
+    /** WezTerm terminal (cross-platform) */
+    WEZTERM = "WEZTERM",
+    /** TTY path-based identifier (Unix) */
+    TTY = "TTY",
+    /** Process ID-based identifier (fallback) */
+    PID = "PID",
+    /** Terminal.app (macOS) */
+    TERM = "TERM",
+    /** Windows Terminal */
+    WT = "WT",
+    /** Session discovered at server startup (wraps inner key) */
+    DISCOVERED = "DISCOVERED",
+    /** Auto-registered from context_update (temporary key) */
+    AUTO = "AUTO",
+    /** Unknown terminal type */
+    UNKNOWN = "UNKNOWN"
+}
+/**
+ * Terminal application names for focus detection.
+ * These are the process names as reported by the system.
+ */
+export declare const TERMINAL_APP_NAMES: readonly ["iTerm2", "iTerm", "Terminal", "Alacritty", "kitty", "WezTerm", "Hyper", "Windows Terminal", "wt"];
+export type TerminalAppName = (typeof TERMINAL_APP_NAMES)[number];
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/connection/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,mDAAmD;AACnD,eAAO,MAAM,2BAA2B,SAAU,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C,4DAA4D;AAC5D,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAMhD;;;GAGG;AACH,eAAO,MAAM,2BAA2B,QAAY,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,eAAe,QAAqB,CAAC;AAElD,4DAA4D;AAC5D,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD,gDAAgD;AAChD,eAAO,MAAM,6BAA6B,QAAS,CAAC;AAEpD,kDAAkD;AAClD,eAAO,MAAM,mBAAmB,QAAgB,CAAC;AAEjD,mDAAmD;AACnD,eAAO,MAAM,wBAAwB,QAAgB,CAAC;AAMtD,kEAAkE;AAClE,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,+EAA+E;AAC/E,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAM/C;;;;;;;;;;;;;GAaG;AACH,oBAAY,iBAAiB;IAC3B,8BAA8B;IAC9B,KAAK,UAAU;IAEf,sCAAsC;IACtC,KAAK,UAAU;IAEf,wCAAwC;IACxC,OAAO,YAAY;IAEnB,uCAAuC;IACvC,GAAG,QAAQ;IAEX,6CAA6C;IAC7C,GAAG,QAAQ;IAEX,2BAA2B;IAC3B,IAAI,SAAS;IAEb,uBAAuB;IACvB,EAAE,OAAO;IAET,6DAA6D;IAC7D,UAAU,eAAe;IAEzB,0DAA0D;IAC1D,IAAI,SAAS;IAEb,4BAA4B;IAC5B,OAAO,YAAY;CACpB;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,8GAUrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/connection/constants.js

@@ -0,0 +1,110 @@
+/**
+ * Connection Layer Constants
+ *
+ * Centralized configuration values for the Claude Code connection layer.
+ * These control timing thresholds, context window sizes, and terminal key formats.
+ */
+// ============================================================================
+// Context Window Limits
+// ============================================================================
+/** Default Claude context window size in tokens */
+export const DEFAULT_CONTEXT_WINDOW_SIZE = 200_000;
+/**
+ * Bug threshold for autocompact.
+ * When autocompact is disabled, it still triggers at ~78% instead of the configured threshold.
+ * See: https://github.com/anthropics/claude-code/issues/XXX
+ */
+export const AUTOCOMPACT_BUG_THRESHOLD = 78;
+/** Default autocompact threshold percentage when enabled */
+export const DEFAULT_AUTOCOMPACT_THRESHOLD = 95;
+// ============================================================================
+// Session Timing Thresholds
+// ============================================================================
+/**
+ * Active session threshold for process discovery.
+ * Sessions with JSONL files modified within this window are considered "active".
+ */
+export const ACTIVE_SESSION_THRESHOLD_MS = 60 * 1000; // 1 minute
+/**
+ * Recently ended session TTL.
+ * Prevents re-registration of sessions via stale context_update events
+ * (fixes duplicate sessions on /clear command).
+ */
+export const RECENTLY_ENDED_TTL_MS = 30_000; // 30 seconds
+/**
+ * Idle session timeout.
+ * Sessions with no activity for this duration are considered stale and removed.
+ * Catches sessions where user walked away without /exit or closing terminal.
+ */
+export const IDLE_TIMEOUT_MS = 4 * 60 * 60 * 1000; // 4 hours
+/** Interval between process liveness verification checks */
+export const PROCESS_VERIFY_INTERVAL_MS = 30_000; // 30 seconds
+/** Interval between branch divergence checks */
+export const BRANCH_DIVERGENCE_INTERVAL_MS = 60_000; // 60 seconds
+/** Interval between stale session cleanup runs */
+export const CLEANUP_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes
+/** Max age for session catalog cache at startup */
+export const CATALOG_CACHE_MAX_AGE_MS = 5 * 60 * 1000; // 5 minutes
+// ============================================================================
+// Focus Detection
+// ============================================================================
+/** Polling interval for focus watcher when terminal is focused */
+export const FOCUS_WATCHER_POLL_MS = 500;
+/** Polling interval for focus watcher when terminal is not focused (slower) */
+export const FOCUS_WATCHER_IDLE_POLL_MS = 1500;
+// ============================================================================
+// Terminal Key Prefixes
+// ============================================================================
+/**
+ * Terminal key prefix identifiers.
+ * Terminal keys follow the format: PREFIX:value
+ *
+ * Examples:
+ * - ITERM:w0t0p0:ABC123-DEF456 (iTerm2 with window/tab/pane + UUID)
+ * - ITERM:ABC123-DEF456 (iTerm2 UUID only)
+ * - TTY:/dev/ttys001 (Terminal.app or generic Unix)
+ * - PID:12345 (Fallback when no better identifier)
+ * - KITTY:42 (Kitty window ID)
+ * - WEZTERM:pane:0 (WezTerm pane ID)
+ * - DISCOVERED:TTY:ttys001:12345 (Session discovered at startup)
+ * - AUTO:session-uuid (Auto-registered from context_update)
+ */
+export var TerminalKeyPrefix;
+(function (TerminalKeyPrefix) {
+    /** iTerm2 terminal (macOS) */
+    TerminalKeyPrefix["ITERM"] = "ITERM";
+    /** Kitty terminal (cross-platform) */
+    TerminalKeyPrefix["KITTY"] = "KITTY";
+    /** WezTerm terminal (cross-platform) */
+    TerminalKeyPrefix["WEZTERM"] = "WEZTERM";
+    /** TTY path-based identifier (Unix) */
+    TerminalKeyPrefix["TTY"] = "TTY";
+    /** Process ID-based identifier (fallback) */
+    TerminalKeyPrefix["PID"] = "PID";
+    /** Terminal.app (macOS) */
+    TerminalKeyPrefix["TERM"] = "TERM";
+    /** Windows Terminal */
+    TerminalKeyPrefix["WT"] = "WT";
+    /** Session discovered at server startup (wraps inner key) */
+    TerminalKeyPrefix["DISCOVERED"] = "DISCOVERED";
+    /** Auto-registered from context_update (temporary key) */
+    TerminalKeyPrefix["AUTO"] = "AUTO";
+    /** Unknown terminal type */
+    TerminalKeyPrefix["UNKNOWN"] = "UNKNOWN";
+})(TerminalKeyPrefix || (TerminalKeyPrefix = {}));
+/**
+ * Terminal application names for focus detection.
+ * These are the process names as reported by the system.
+ */
+export const TERMINAL_APP_NAMES = [
+    'iTerm2',
+    'iTerm',
+    'Terminal',
+    'Alacritty',
+    'kitty',
+    'WezTerm',
+    'Hyper',
+    'Windows Terminal',
+    'wt',
+];
+//# sourceMappingURL=constants.js.map

package/dist/connection/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/connection/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,mDAAmD;AACnD,MAAM,CAAC,MAAM,2BAA2B,GAAG,OAAO,CAAC;AAEnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAE5C,4DAA4D;AAC5D,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,CAAC;AAEhD,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW;AAEjE;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,CAAC,aAAa;AAE1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,UAAU;AAE7D,4DAA4D;AAC5D,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC,CAAC,aAAa;AAE/D,gDAAgD;AAChD,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC,CAAC,aAAa;AAElE,kDAAkD;AAClD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;AAE9D,mDAAmD;AACnD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;AAEnE,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,kEAAkE;AAClE,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAE/C,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAN,IAAY,iBA8BX;AA9BD,WAAY,iBAAiB;IAC3B,8BAA8B;IAC9B,oCAAe,CAAA;IAEf,sCAAsC;IACtC,oCAAe,CAAA;IAEf,wCAAwC;IACxC,wCAAmB,CAAA;IAEnB,uCAAuC;IACvC,gCAAW,CAAA;IAEX,6CAA6C;IAC7C,gCAAW,CAAA;IAEX,2BAA2B;IAC3B,kCAAa,CAAA;IAEb,uBAAuB;IACvB,8BAAS,CAAA;IAET,6DAA6D;IAC7D,8CAAyB,CAAA;IAEzB,0DAA0D;IAC1D,kCAAa,CAAA;IAEb,4BAA4B;IAC5B,wCAAmB,CAAA;AACrB,CAAC,EA9BW,iBAAiB,KAAjB,iBAAiB,QA8B5B;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ;IACR,OAAO;IACP,UAAU;IACV,WAAW;IACX,OAAO;IACP,SAAS;IACT,OAAO;IACP,kBAAkB;IAClB,IAAI;CACI,CAAC"}

package/dist/connection/git-info.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Git Info Detection
+ *
+ * Detects git branch, worktree, and repo root for a given directory.
+ * Uses native git commands (same logic as hooks/git-detect.sh).
+ *
+ * @module connection/git-info
+ */
+/**
+ * Git info for a working directory
+ */
+export interface GitInfo {
+    /** Current branch name (e.g., "main", "feature/xyz") */
+    branch: string | null;
+    /** Worktree name (basename of worktree dir), only set for worktrees */
+    worktree: string | null;
+    /** Canonical git repo root path (main worktree root, shared across all worktrees) */
+    repoRoot: string | null;
+}
+/**
+ * Detect git info for a directory: branch, worktree name, and repo root.
+ *
+ * Uses `git rev-parse` to get the branch and common dir, then determines
+ * whether the directory is a worktree based on the common dir location.
+ *
+ * @param cwd Directory to check for git info
+ * @returns Git info with branch, worktree (if applicable), and repo root
+ */
+export declare function detectGitInfo(cwd: string): Promise<GitInfo>;
+//# sourceMappingURL=git-info.d.ts.map

package/dist/connection/git-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-info.d.ts","sourceRoot":"","sources":["../../src/connection/git-info.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,wDAAwD;IACxD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,qFAAqF;IACrF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAoCjE"}

package/dist/connection/git-info.js

@@ -0,0 +1,52 @@
+/**
+ * Git Info Detection
+ *
+ * Detects git branch, worktree, and repo root for a given directory.
+ * Uses native git commands (same logic as hooks/git-detect.sh).
+ *
+ * @module connection/git-info
+ */
+import { exec as execCb } from 'child_process';
+import { promisify } from 'util';
+import * as path from 'path';
+const execAsync = promisify(execCb);
+/**
+ * Detect git info for a directory: branch, worktree name, and repo root.
+ *
+ * Uses `git rev-parse` to get the branch and common dir, then determines
+ * whether the directory is a worktree based on the common dir location.
+ *
+ * @param cwd Directory to check for git info
+ * @returns Git info with branch, worktree (if applicable), and repo root
+ */
+export async function detectGitInfo(cwd) {
+    try {
+        const { stdout } = await execAsync(`git -C "${cwd}" rev-parse --abbrev-ref HEAD --git-common-dir`, { timeout: 2000 });
+        if (!stdout.trim()) {
+            return { branch: null, worktree: null, repoRoot: null };
+        }
+        const lines = stdout.trim().split('\n');
+        const branch = lines[0] || null;
+        const commonDir = lines[1];
+        if (!commonDir) {
+            return { branch, worktree: null, repoRoot: null };
+        }
+        let worktree = null;
+        let repoRoot = null;
+        if (commonDir === '.git') {
+            // Normal repo (not a worktree) - cwd is the repo root
+            repoRoot = cwd;
+        }
+        else {
+            // Worktree - commonDir is absolute path to shared .git
+            repoRoot = path.dirname(commonDir);
+            worktree = path.basename(cwd);
+        }
+        return { branch, worktree, repoRoot };
+    }
+    catch {
+        // Not a git repo or git not available
+        return { branch: null, worktree: null, repoRoot: null };
+    }
+}
+//# sourceMappingURL=git-info.js.map

package/dist/connection/git-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-info.js","sourceRoot":"","sources":["../../src/connection/git-info.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AAcpC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW;IAC7C,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAChC,WAAW,GAAG,gDAAgD,EAC9D,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YACnB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC1D,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAChC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAE3B,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACpD,CAAC;QAED,IAAI,QAAQ,GAAkB,IAAI,CAAC;QACnC,IAAI,QAAQ,GAAkB,IAAI,CAAC;QAEnC,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;YACzB,sDAAsD;YACtD,QAAQ,GAAG,GAAG,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,uDAAuD;YACvD,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACnC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;QACtC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1D,CAAC;AACH,CAAC"}

package/dist/connection/git-info.test.d.ts

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

package/dist/connection/git-info.test.d.ts.map

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

package/dist/connection/git-info.test.js

@@ -0,0 +1,35 @@
+/**
+ * Tests for git-info module
+ */
+import { detectGitInfo } from './git-info.js';
+// We test against the actual repo since we're in a git repo
+describe('detectGitInfo', () => {
+    it('detects git info for a git repository', async () => {
+        // Use the current project directory which IS a git repo
+        const cwd = process.cwd().replace(/\/server$/, ''); // Navigate to project root
+        const info = await detectGitInfo(cwd);
+        expect(info.branch).toBeTruthy();
+        expect(typeof info.branch).toBe('string');
+        expect(info.repoRoot).toBeTruthy();
+        // worktree is null for normal repos
+    });
+    it('returns nulls for non-git directory', async () => {
+        const info = await detectGitInfo('/tmp');
+        expect(info.branch).toBeNull();
+        expect(info.worktree).toBeNull();
+        expect(info.repoRoot).toBeNull();
+    });
+    it('returns nulls for non-existent directory', async () => {
+        const info = await detectGitInfo('/nonexistent/path/that/does/not/exist');
+        expect(info.branch).toBeNull();
+        expect(info.worktree).toBeNull();
+        expect(info.repoRoot).toBeNull();
+    });
+    it('returns expected GitInfo shape', async () => {
+        const info = await detectGitInfo('/tmp');
+        expect(info).toHaveProperty('branch');
+        expect(info).toHaveProperty('worktree');
+        expect(info).toHaveProperty('repoRoot');
+    });
+});
+//# sourceMappingURL=git-info.test.js.map

package/dist/connection/git-info.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-info.test.js","sourceRoot":"","sources":["../../src/connection/git-info.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,4DAA4D;AAC5D,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,wDAAwD;QACxD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,2BAA2B;QAC/E,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;QAEtC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,CAAC;QACjC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,UAAU,EAAE,CAAC;QACnC,oCAAoC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,uCAAuC,CAAC,CAAC;QAC1E,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}