@jsayubi/ccgram 1.1.1 → 1.2.1

package/dist/src/utils/ghostty-session-manager.js

@@ -0,0 +1,370 @@
+"use strict";
+/**
+ * Ghostty Session Manager — controls Ghostty terminal sessions via AppleScript.
+ *
+ * Ghostty 1.3.0+ supports native AppleScript for controlling terminal windows,
+ * tabs, and splits. This backend is used when TERM_PROGRAM=ghostty and no
+ * tmux session is available.
+ *
+ * Session identity: CWD-based. Stores Map<sessionName, cwd> as handles.
+ * Text injection: input text "..." to terminal (paste-style, handles ANSI).
+ * Key sequences: arrow keys via ANSI (send key "down" is broken in 1.3.0).
+ * Modifier keys (C-c, C-u): use "send key KEY modifiers MOD to term" (no "with").
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ghosttySessionManager = exports.GhosttySessionManager = void 0;
+const os_1 = __importDefault(require("os"));
+const fs_1 = __importDefault(require("fs"));
+const child_process_1 = require("child_process");
+// Key name → macOS key code (sent via System Events after focus, bypasses bracketed paste)
+// send key "down" is unsupported in Ghostty AppleScript; input text ANSI is wrapped in
+// bracketed paste which Claude Code's TUI doesn't recognise as navigation.
+const KEY_CODES = {
+    'Down': 125,
+    'Up': 126,
+    'Space': 49,
+};
+// Keys sent via "send key NAME to term" (no modifiers)
+const SEND_KEYS = {
+    'Enter': 'enter',
+    'C-m': 'enter',
+};
+// Keys using "send key KEY modifiers MOD to term" (no "with" — plain param per Ghostty sdef)
+const MODIFIER_KEYS = {
+    'C-c': { key: 'c', modifiers: 'control' },
+    'C-u': { key: 'u', modifiers: 'control' },
+};
+class GhosttySessionManager {
+    /** Map from session name to registered CWD. */
+    handles = new Map();
+    /**
+     * Whether Ghostty is available and running on this machine.
+     * Re-checked each call (fast) so the bot handles Ghostty launching after startup.
+     */
+    isAvailable() {
+        if (process.platform !== 'darwin')
+            return false;
+        try {
+            const result = (0, child_process_1.execSync)('osascript -e "application \\"Ghostty\\" is running"', {
+                encoding: 'utf8',
+                stdio: 'pipe',
+                timeout: 2000,
+            }).trim();
+            return result === 'true';
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Whether a handle is registered for this session name. */
+    has(name) {
+        return this.handles.has(name);
+    }
+    /** Register (or update) a session handle with its CWD. */
+    register(name, cwd) {
+        this.handles.set(name, cwd);
+    }
+    /** Remove a session handle. */
+    unregister(name) {
+        this.handles.delete(name);
+    }
+    /**
+     * Execute an AppleScript via osascript stdin pipe.
+     * Using stdin pipe avoids all shell-quoting issues and supports multi-line scripts.
+     */
+    runScript(script) {
+        return new Promise((resolve, reject) => {
+            const child = (0, child_process_1.exec)('osascript -', { timeout: 5000 }, (err, stdout) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve(stdout.trim());
+            });
+            child.stdin.write(script);
+            child.stdin.end();
+        });
+    }
+    /**
+     * Build an AppleScript string literal expression for the given value.
+     * Handles embedded double-quotes via & quote & concatenation.
+     */
+    buildAppleScriptString(str) {
+        const parts = str.split('"');
+        return parts.map(p => `"${p}"`).join(' & quote & ');
+    }
+    /**
+     * Build an AppleScript expression that produces the given text when evaluated.
+     * Uses (character id N) for control characters/non-printable bytes,
+     * and quote for embedded double-quotes.
+     */
+    buildAppleScriptText(text) {
+        const parts = [];
+        let current = '';
+        for (let i = 0; i < text.length; i++) {
+            const code = text.charCodeAt(i);
+            if (code >= 32 && code < 127 && code !== 34) {
+                // Printable ASCII except " — include in string literal
+                current += text[i];
+            }
+            else if (code === 34) { // "
+                if (current) {
+                    parts.push(`"${current}"`);
+                    current = '';
+                }
+                parts.push('quote');
+            }
+            else {
+                // Control character or non-ASCII — use character id
+                if (current) {
+                    parts.push(`"${current}"`);
+                    current = '';
+                }
+                parts.push(`(character id ${code})`);
+            }
+        }
+        if (current)
+            parts.push(`"${current}"`);
+        if (parts.length === 0)
+            return '""';
+        return parts.join(' & ');
+    }
+    /**
+     * Build the AppleScript fragment that finds the terminal for a registered CWD.
+     * Iterates all windows and tabs to find the terminal whose working directory matches.
+     */
+    findTermScript(cwd) {
+        const cwdExpr = this.buildAppleScriptString(cwd);
+        return `set targetCwd to ${cwdExpr}
+set foundTerm to missing value
+tell application "Ghostty"
+  repeat with w in windows
+    repeat with t in tabs of w
+      repeat with term in terminals of t
+        if working directory of term is targetCwd then
+          set foundTerm to term
+          exit repeat
+        end if
+      end repeat
+      if foundTerm is not missing value then exit repeat
+    end repeat
+    if foundTerm is not missing value then exit repeat
+  end repeat
+  if foundTerm is missing value then error "No Ghostty terminal found for cwd: " & targetCwd
+end tell`;
+    }
+    /**
+     * Write raw text to a Ghostty terminal (paste-style).
+     * Handles printable ASCII, control characters (e.g. \r for Enter),
+     * and ANSI escape sequences (e.g. \x1B[B for Down arrow).
+     */
+    async write(name, text) {
+        const cwd = this.handles.get(name);
+        if (!cwd)
+            return false;
+        try {
+            const textExpr = this.buildAppleScriptText(text);
+            const script = `${this.findTermScript(cwd)}
+tell application "Ghostty"
+  input text ${textExpr} to foundTerm
+end tell`;
+            await this.runScript(script);
+            return true;
+        }
+        catch (err) {
+            process.stderr.write(`[ghostty-session-manager] write failed for ${name}: ${err.message}\n`);
+            return false;
+        }
+    }
+    /**
+     * Write text then immediately press Return — all in one AppleScript execution.
+     * Avoids a second CWD lookup between write and Enter, which can miss the terminal.
+     */
+    async writeLine(name, text) {
+        const cwd = this.handles.get(name);
+        if (!cwd)
+            return false;
+        try {
+            const textExpr = this.buildAppleScriptText(text);
+            const script = `${this.findTermScript(cwd)}
+tell application "Ghostty"
+  focus foundTerm
+  input text ${textExpr} to foundTerm
+  delay 0.1
+  send key "enter" to foundTerm
+end tell`;
+            await this.runScript(script);
+            return true;
+        }
+        catch (err) {
+            process.stderr.write(`[ghostty-session-manager] writeLine failed for ${name}: ${err.message}\n`);
+            return false;
+        }
+    }
+    /**
+     * Send a named key to a session.
+     * C-c and C-u use "send key ... with modifiers" (required by Ghostty AppleScript).
+     * Down, Up, Enter, Space use ANSI sequences via input text
+     * (send key "down" is broken in Ghostty 1.3.0).
+     */
+    async sendKey(name, key) {
+        const cwd = this.handles.get(name);
+        if (!cwd)
+            return false;
+        const modKey = MODIFIER_KEYS[key];
+        if (modKey) {
+            try {
+                const script = `${this.findTermScript(cwd)}
+tell application "Ghostty"
+  focus foundTerm
+  send key "${modKey.key}" modifiers "${modKey.modifiers}" to foundTerm
+end tell`;
+                await this.runScript(script);
+                return true;
+            }
+            catch (err) {
+                process.stderr.write(`[ghostty-session-manager] sendKey(${key}) failed for ${name}: ${err.message}\n`);
+                return false;
+            }
+        }
+        const sendKeyName = SEND_KEYS[key];
+        if (sendKeyName) {
+            try {
+                const script = `${this.findTermScript(cwd)}
+tell application "Ghostty"
+  focus foundTerm
+  send key "${sendKeyName}" to foundTerm
+end tell`;
+                await this.runScript(script);
+                return true;
+            }
+            catch (err) {
+                process.stderr.write(`[ghostty-session-manager] sendKey(${key}) failed for ${name}: ${err.message}\n`);
+                return false;
+            }
+        }
+        const keyCode = KEY_CODES[key];
+        if (keyCode !== undefined) {
+            try {
+                const script = `${this.findTermScript(cwd)}
+tell application "Ghostty"
+  focus foundTerm
+end tell
+tell application "System Events"
+  tell process "Ghostty"
+    key code ${keyCode}
+  end tell
+end tell`;
+                await this.runScript(script);
+                return true;
+            }
+            catch (err) {
+                process.stderr.write(`[ghostty-session-manager] sendKey(${key}) failed for ${name}: ${err.message}\n`);
+                return false;
+            }
+        }
+        // Unknown key — pass through as text
+        return this.write(name, key);
+    }
+    /** Send Ctrl+C interrupt to the terminal. */
+    async interrupt(name) {
+        return this.sendKey(name, 'C-c');
+    }
+    /**
+     * Capture terminal scrollback by triggering write_scrollback_file.
+     * Finds the new file in the OS temp directory and reads its content.
+     * Returns null if unavailable or no file produced within 1s.
+     */
+    async capture(name) {
+        const cwd = this.handles.get(name);
+        if (!cwd)
+            return null;
+        const tmpDir = os_1.default.tmpdir();
+        // 1. Note existing Ghostty temp files and their mtimes
+        const existingFiles = new Map();
+        try {
+            const files = fs_1.default.readdirSync(tmpDir);
+            for (const f of files) {
+                const fl = f.toLowerCase();
+                if (fl.startsWith('ghostty') || fl.startsWith('com.mitchellh.ghostty')) {
+                    try {
+                        const mtime = fs_1.default.statSync(`${tmpDir}/${f}`).mtimeMs;
+                        existingFiles.set(f, mtime);
+                    }
+                    catch { }
+                }
+            }
+        }
+        catch { }
+        // 2. Trigger write_scrollback_file
+        try {
+            const script = `${this.findTermScript(cwd)}
+tell application "Ghostty"
+  perform action "write_scrollback_file" on foundTerm
+end tell`;
+            await this.runScript(script);
+        }
+        catch (err) {
+            process.stderr.write(`[ghostty-session-manager] capture trigger failed for ${name}: ${err.message}\n`);
+            return null;
+        }
+        // 3. Wait up to 1s for a new (or updated) file to appear
+        const deadline = Date.now() + 1000;
+        while (Date.now() < deadline) {
+            try {
+                const files = fs_1.default.readdirSync(tmpDir);
+                for (const f of files) {
+                    const fl = f.toLowerCase();
+                    if (fl.startsWith('ghostty') || fl.startsWith('com.mitchellh.ghostty')) {
+                        const filePath = `${tmpDir}/${f}`;
+                        try {
+                            const mtime = fs_1.default.statSync(filePath).mtimeMs;
+                            const prevMtime = existingFiles.get(f);
+                            if (prevMtime === undefined || mtime > prevMtime) {
+                                return fs_1.default.readFileSync(filePath, 'utf8');
+                            }
+                        }
+                        catch { }
+                    }
+                }
+            }
+            catch { }
+            await new Promise(r => setTimeout(r, 100));
+        }
+        return null;
+    }
+    /**
+     * Open a new tab in the front Ghostty window and run a command.
+     * Uses AppleScript's quoted form of for safe shell quoting of the cwd.
+     */
+    async openNewTab(cwd, command) {
+        try {
+            // Build AppleScript expression for cwd (used with quoted form of)
+            const cwdExpr = this.buildAppleScriptString(cwd);
+            // Build AppleScript expression for the command (plain text)
+            const cmdExpr = this.buildAppleScriptText(command);
+            const script = `tell application "Ghostty"
+  if (count of windows) is 0 then error "No Ghostty windows open"
+  set w to front window
+  perform action "new_tab" on w
+  delay 0.5
+  set term to focused terminal of selected tab of w
+  focus term
+  input text "cd " & quoted form of ${cwdExpr} & " && " & ${cmdExpr} to term
+  delay 0.1
+  send key "enter" to term
+end tell`;
+            await this.runScript(script);
+            return true;
+        }
+        catch (err) {
+            process.stderr.write(`[ghostty-session-manager] openNewTab failed: ${err.message}\n`);
+            return false;
+        }
+    }
+}
+exports.GhosttySessionManager = GhosttySessionManager;
+exports.ghosttySessionManager = new GhosttySessionManager();
+//# sourceMappingURL=ghostty-session-manager.js.map

package/dist/src/utils/ghostty-session-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ghostty-session-manager.js","sourceRoot":"","sources":["../../../src/utils/ghostty-session-manager.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;;AAEH,4CAAoB;AACpB,4CAAoB;AACpB,iDAA+C;AAE/C,2FAA2F;AAC3F,uFAAuF;AACvF,2EAA2E;AAC3E,MAAM,SAAS,GAA2B;IACxC,MAAM,EAAG,GAAG;IACZ,IAAI,EAAK,GAAG;IACZ,OAAO,EAAE,EAAE;CACZ,CAAC;AAEF,uDAAuD;AACvD,MAAM,SAAS,GAA2B;IACxC,OAAO,EAAE,OAAO;IAChB,KAAK,EAAI,OAAO;CACjB,CAAC;AAEF,6FAA6F;AAC7F,MAAM,aAAa,GAAuD;IACxE,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE;IACzC,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE;CAC1C,CAAC;AAEF,MAAa,qBAAqB;IAChC,+CAA+C;IACvC,OAAO,GAAwB,IAAI,GAAG,EAAE,CAAC;IAEjD;;;OAGG;IACH,WAAW;QACT,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAA,wBAAQ,EAAC,qDAAqD,EAAE;gBAC7E,QAAQ,EAAE,MAAM;gBAChB,KAAK,EAAE,MAAM;gBACb,OAAO,EAAE,IAAI;aACd,CAAC,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,MAAM,KAAK,MAAM,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,4DAA4D;IAC5D,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,0DAA0D;IAC1D,QAAQ,CAAC,IAAY,EAAE,GAAW;QAChC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,+BAA+B;IAC/B,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACK,SAAS,CAAC,MAAc;QAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,KAAK,GAAG,IAAA,oBAAI,EAAC,aAAa,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;gBACnE,IAAI,GAAG;oBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;oBAChB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9B,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,KAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC3B,KAAK,CAAC,KAAM,CAAC,GAAG,EAAE,CAAC;QACrB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACK,sBAAsB,CAAC,GAAW;QACxC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACtD,CAAC;IAED;;;;OAIG;IACK,oBAAoB,CAAC,IAAY;QACvC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,OAAO,GAAG,EAAE,CAAC;QAEjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAChC,IAAI,IAAI,IAAI,EAAE,IAAI,IAAI,GAAG,GAAG,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;gBAC5C,uDAAuD;gBACvD,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;YACrB,CAAC;iBAAM,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI;gBAC5B,IAAI,OAAO,EAAE,CAAC;oBAAC,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;gBAAC,CAAC;gBAC1D,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,oDAAoD;gBACpD,IAAI,OAAO,EAAE,CAAC;oBAAC,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;gBAAC,CAAC;gBAC1D,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,GAAG,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QAED,IAAI,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC;QACxC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACpC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACK,cAAc,CAAC,GAAW;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;QACjD,OAAO,oBAAoB,OAAO;;;;;;;;;;;;;;;;SAgB7B,CAAC;IACR,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,IAAY;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG;YAAE,OAAO,KAAK,CAAC;QAEvB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC;;eAEjC,QAAQ;SACd,CAAC;YACJ,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8CAA8C,IAAI,KAAM,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;YACxG,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,IAAY,EAAE,IAAY;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG;YAAE,OAAO,KAAK,CAAC;QAEvB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC;;;eAGjC,QAAQ;;;SAGd,CAAC;YACJ,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kDAAkD,IAAI,KAAM,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;YAC5G,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,GAAW;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG;YAAE,OAAO,KAAK,CAAC;QAEvB,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC;;;cAGpC,MAAM,CAAC,GAAG,gBAAgB,MAAM,CAAC,SAAS;SAC/C,CAAC;gBACF,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;gBAC7B,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,GAAG,gBAAgB,IAAI,KAAM,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;gBAClH,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,MAAM,WAAW,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC;;;cAGpC,WAAW;SAChB,CAAC;gBACF,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;gBAC7B,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,GAAG,gBAAgB,IAAI,KAAM,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;gBAClH,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC;;;;;;eAMnC,OAAO;;SAEb,CAAC;gBACF,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;gBAC7B,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,GAAG,gBAAgB,IAAI,KAAM,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;gBAClH,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,qCAAqC;QACrC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,6CAA6C;IAC7C,KAAK,CAAC,SAAS,CAAC,IAAY;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,IAAY;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QAEtB,MAAM,MAAM,GAAG,YAAE,CAAC,MAAM,EAAE,CAAC;QAE3B,uDAAuD;QACvD,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,YAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACrC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;gBAC3B,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,uBAAuB,CAAC,EAAE,CAAC;oBACvE,IAAI,CAAC;wBACH,MAAM,KAAK,GAAG,YAAE,CAAC,QAAQ,CAAC,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;wBACpD,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;oBAC9B,CAAC;oBAAC,MAAM,CAAC,CAAA,CAAC;gBACZ,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QAEV,mCAAmC;QACnC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC;;;SAGvC,CAAC;YACJ,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wDAAwD,IAAI,KAAM,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;YAClH,OAAO,IAAI,CAAC;QACd,CAAC;QAED,yDAAyD;QACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QACnC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,YAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;gBACrC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;oBACtB,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;oBAC3B,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,uBAAuB,CAAC,EAAE,CAAC;wBACvE,MAAM,QAAQ,GAAG,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC;wBAClC,IAAI,CAAC;4BACH,MAAM,KAAK,GAAG,YAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;4BAC5C,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;4BACvC,IAAI,SAAS,KAAK,SAAS,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;gCACjD,OAAO,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;4BAC3C,CAAC;wBACH,CAAC;wBAAC,MAAM,CAAC,CAAA,CAAC;oBACZ,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;YACV,MAAM,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,GAAW,EAAE,OAAe;QAC3C,IAAI,CAAC;YACH,kEAAkE;YAClE,MAAM,OAAO,GAAG,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;YACjD,4DAA4D;YAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;YACnD,MAAM,MAAM,GAAG;;;;;;;sCAOiB,OAAO,eAAe,OAAO;;;SAG1D,CAAC;YACJ,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gDAAiD,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;YACjG,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF;AArUD,sDAqUC;AAEY,QAAA,qBAAqB,GAAG,IAAI,qBAAqB,EAAE,CAAC"}

package/dist/src/utils/transcript-reader.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Transcript Reader — reads Claude Code session JSONL transcripts to surface
+ * developer-useful status info (model, context %, last assistant message, etc.)
+ *
+ * Path: ~/.claude/projects/<encoded-cwd>/<sessionId>.jsonl
+ * Encoding: cwd with `/` replaced by `-` (so `/Users/foo/bar` → `-Users-foo-bar`)
+ */
+/** Status fields parsed from a session transcript. */
+export interface TranscriptStatus {
+    model?: string;
+    version?: string;
+    gitBranch?: string;
+    slug?: string;
+    cwd?: string;
+    sessionId?: string;
+    /** Total prompt+output tokens from the most recent assistant turn. */
+    contextTokens?: number;
+    /** Inferred from model name; null if unknown. */
+    contextLimit?: number | null;
+    /** 0-100, omitted when contextLimit is null. */
+    contextPct?: number;
+    /** Plain-text snippet of the last assistant message, truncated. */
+    lastAssistantMessage?: string;
+    /** ISO timestamp of the last assistant message. */
+    lastAssistantTimestamp?: string;
+}
+/** Encode a cwd into Claude Code's project directory name. */
+export declare function encodeCwd(cwd: string): string;
+/** Build the full path to a session's JSONL transcript. */
+export declare function getTranscriptPath(cwd: string, sessionId: string): string;
+/**
+ * Find the most recently modified transcript for a cwd when sessionId is unknown.
+ * Returns null if no transcripts exist for that cwd.
+ */
+export declare function findLatestTranscript(cwd: string): {
+    sessionId: string;
+    path: string;
+    mtimeMs: number;
+} | null;
+/**
+ * Inferred context window size for known model name patterns.
+ * Returns null when we don't know the limit (caller should omit % display).
+ *
+ * Note: the [1m] suffix that enables 1M context is an API parameter — the model
+ * field in transcripts does NOT include it. So we conservatively assume 200K
+ * for Opus 4.6 unless we find a way to detect 1m mode.
+ */
+export declare function inferContextLimit(model: string | undefined): number | null;
+/**
+ * Read the latest status info from a session's transcript.
+ * Returns null when the transcript file doesn't exist or is unreadable.
+ *
+ * `maxAssistantChars` truncates the last-message snippet to keep Telegram
+ * messages under their 4096-char limit.
+ */
+export declare function readTranscriptStatus(cwd: string, sessionId: string | undefined, maxAssistantChars?: number): TranscriptStatus | null;
+//# sourceMappingURL=transcript-reader.d.ts.map

package/dist/src/utils/transcript-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-reader.d.ts","sourceRoot":"","sources":["../../../src/utils/transcript-reader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,sDAAsD;AACtD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,8DAA8D;AAC9D,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGxE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAgB7G;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAO1E;AA6DD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,iBAAiB,GAAE,MAAY,GAC9B,gBAAgB,GAAG,IAAI,CAsFzB"}

package/dist/src/utils/transcript-reader.js

@@ -0,0 +1,229 @@
+"use strict";
+/**
+ * Transcript Reader — reads Claude Code session JSONL transcripts to surface
+ * developer-useful status info (model, context %, last assistant message, etc.)
+ *
+ * Path: ~/.claude/projects/<encoded-cwd>/<sessionId>.jsonl
+ * Encoding: cwd with `/` replaced by `-` (so `/Users/foo/bar` → `-Users-foo-bar`)
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeCwd = encodeCwd;
+exports.getTranscriptPath = getTranscriptPath;
+exports.findLatestTranscript = findLatestTranscript;
+exports.inferContextLimit = inferContextLimit;
+exports.readTranscriptStatus = readTranscriptStatus;
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+/** Encode a cwd into Claude Code's project directory name. */
+function encodeCwd(cwd) {
+    return cwd.replace(/\//g, '-');
+}
+/** Build the full path to a session's JSONL transcript. */
+function getTranscriptPath(cwd, sessionId) {
+    const encoded = encodeCwd(cwd);
+    return path_1.default.join(os_1.default.homedir(), '.claude', 'projects', encoded, `${sessionId}.jsonl`);
+}
+/**
+ * Find the most recently modified transcript for a cwd when sessionId is unknown.
+ * Returns null if no transcripts exist for that cwd.
+ */
+function findLatestTranscript(cwd) {
+    const dir = path_1.default.join(os_1.default.homedir(), '.claude', 'projects', encodeCwd(cwd));
+    if (!fs_1.default.existsSync(dir))
+        return null;
+    let latest = null;
+    for (const entry of fs_1.default.readdirSync(dir)) {
+        if (!entry.endsWith('.jsonl'))
+            continue;
+        const full = path_1.default.join(dir, entry);
+        try {
+            const mtimeMs = fs_1.default.statSync(full).mtimeMs;
+            if (!latest || mtimeMs > latest.mtimeMs) {
+                latest = { sessionId: entry.replace(/\.jsonl$/, ''), path: full, mtimeMs };
+            }
+        }
+        catch { }
+    }
+    return latest;
+}
+/**
+ * Inferred context window size for known model name patterns.
+ * Returns null when we don't know the limit (caller should omit % display).
+ *
+ * Note: the [1m] suffix that enables 1M context is an API parameter — the model
+ * field in transcripts does NOT include it. So we conservatively assume 200K
+ * for Opus 4.6 unless we find a way to detect 1m mode.
+ */
+function inferContextLimit(model) {
+    if (!model)
+        return null;
+    const m = model.toLowerCase();
+    if (m.includes('opus-4-6') || m.includes('sonnet-4-6') || m.includes('haiku-4-5'))
+        return 200000;
+    if (m.includes('opus-4-5') || m.includes('sonnet-4-5') || m.includes('haiku-4-1'))
+        return 200000;
+    if (m.includes('opus') || m.includes('sonnet') || m.includes('haiku'))
+        return 200000;
+    return null;
+}
+/**
+ * Sum the tokens that count toward the context window from a `usage` object.
+ * Cache reads count — they are still in-context. Output tokens count too,
+ * because they become part of the next turn's prompt.
+ */
+function sumContextTokens(usage) {
+    const input = usage.input_tokens || 0;
+    const cacheRead = usage.cache_read_input_tokens || 0;
+    const cacheCreate = usage.cache_creation_input_tokens || 0;
+    const output = usage.output_tokens || 0;
+    return input + cacheRead + cacheCreate + output;
+}
+/**
+ * Read the tail of a JSONL file efficiently, returning up to `maxLines`
+ * trailing lines as parsed JSON objects. Lines that fail to parse are skipped.
+ */
+function readTailLines(filePath, maxLines) {
+    const stat = fs_1.default.statSync(filePath);
+    // Read up to ~256KB from the end — enough for ~hundreds of small entries.
+    const readBytes = Math.min(stat.size, 262144);
+    const fd = fs_1.default.openSync(filePath, 'r');
+    try {
+        const buf = Buffer.alloc(readBytes);
+        fs_1.default.readSync(fd, buf, 0, readBytes, stat.size - readBytes);
+        const text = buf.toString('utf8');
+        // Drop any partial first line if we didn't read from byte 0.
+        const lines = text.split('\n');
+        if (stat.size > readBytes)
+            lines.shift();
+        const tail = lines.slice(-maxLines).filter(l => l.trim().length > 0);
+        const out = [];
+        for (const line of tail) {
+            try {
+                out.push(JSON.parse(line));
+            }
+            catch { }
+        }
+        return out;
+    }
+    finally {
+        fs_1.default.closeSync(fd);
+    }
+}
+/**
+ * Extract plain text from a Claude API `content` array, ignoring tool_use blocks.
+ */
+function extractAssistantText(message) {
+    const content = message.content;
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content))
+        return '';
+    const parts = [];
+    for (const block of content) {
+        if (block && typeof block === 'object' && block.type === 'text') {
+            const text = block.text;
+            if (typeof text === 'string')
+                parts.push(text);
+        }
+    }
+    return parts.join('\n').trim();
+}
+/**
+ * Read the latest status info from a session's transcript.
+ * Returns null when the transcript file doesn't exist or is unreadable.
+ *
+ * `maxAssistantChars` truncates the last-message snippet to keep Telegram
+ * messages under their 4096-char limit.
+ */
+function readTranscriptStatus(cwd, sessionId, maxAssistantChars = 600) {
+    let filePath;
+    let resolvedSessionId;
+    if (sessionId) {
+        filePath = getTranscriptPath(cwd, sessionId);
+        resolvedSessionId = sessionId;
+        if (!fs_1.default.existsSync(filePath)) {
+            // Fall through to the latest-transcript fallback when the named session
+            // is gone (e.g. user resumed and the bot has stale state).
+            const latest = findLatestTranscript(cwd);
+            if (!latest)
+                return null;
+            filePath = latest.path;
+            resolvedSessionId = latest.sessionId;
+        }
+    }
+    else {
+        const latest = findLatestTranscript(cwd);
+        if (!latest)
+            return null;
+        filePath = latest.path;
+        resolvedSessionId = latest.sessionId;
+    }
+    let entries;
+    try {
+        entries = readTailLines(filePath, 100);
+    }
+    catch {
+        return null;
+    }
+    if (entries.length === 0)
+        return null;
+    const status = { sessionId: resolvedSessionId };
+    // Walk backward to find the most recent assistant entry — that's where model
+    // / usage / metadata live. Static metadata (cwd, version, gitBranch, slug)
+    // is on every entry, so the last one is fine.
+    const last = entries[entries.length - 1];
+    if (typeof last.cwd === 'string')
+        status.cwd = last.cwd;
+    if (typeof last.version === 'string')
+        status.version = last.version;
+    if (typeof last.gitBranch === 'string')
+        status.gitBranch = last.gitBranch;
+    if (typeof last.slug === 'string')
+        status.slug = last.slug;
+    for (let i = entries.length - 1; i >= 0; i--) {
+        const entry = entries[i];
+        if (entry.type !== 'assistant')
+            continue;
+        const message = entry.message || {};
+        if (!status.model && typeof message.model === 'string') {
+            status.model = message.model;
+        }
+        if (status.contextTokens === undefined) {
+            const usage = message.usage;
+            if (usage) {
+                status.contextTokens = sumContextTokens(usage);
+                // 1h ephemeral cache is only available in extended-context (1M) mode,
+                // so its presence is a reliable signal that the limit is 1M.
+                const cacheCreation = usage.cache_creation;
+                const has1hCache = cacheCreation && cacheCreation.ephemeral_1h_input_tokens > 0;
+                status.contextLimit = has1hCache ? 1000000 : inferContextLimit(status.model);
+                if (status.contextLimit && status.contextLimit > 0) {
+                    // Don't cap — if tokens exceed the assumed limit, the user is on a
+                    // larger-context mode we couldn't detect; showing >100% is more honest
+                    // than silently flooring the value.
+                    status.contextPct = Math.round((status.contextTokens / status.contextLimit) * 100);
+                }
+            }
+        }
+        if (status.lastAssistantMessage === undefined) {
+            const text = extractAssistantText(message);
+            if (text.length > 0) {
+                status.lastAssistantMessage = text.length > maxAssistantChars
+                    ? text.slice(0, maxAssistantChars).trimEnd() + '…'
+                    : text;
+                if (typeof entry.timestamp === 'string') {
+                    status.lastAssistantTimestamp = entry.timestamp;
+                }
+            }
+        }
+        if (status.model && status.contextTokens !== undefined && status.lastAssistantMessage !== undefined) {
+            break;
+        }
+    }
+    return status;
+}
+//# sourceMappingURL=transcript-reader.js.map