@codedeck/codedeck 2026.3.1-4.63

package/dist/daemon/hook-server.js

@@ -0,0 +1,160 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.activeHookPort = exports.DEFAULT_HOOK_PORT = void 0;
+exports.startHookServer = startHookServer;
+/**
+ * Local HTTP server for agent hook callbacks.
+ *
+ * POST /notify  { event: "idle"|"notification"|"tool_start"|"tool_end", session, ... }
+ *
+ * Port selection:
+ *   1. Load persisted port from ~/.codedeck/hook-port (remembered across restarts)
+ *   2. Try to bind; if EADDRINUSE, increment and retry (up to 20 attempts)
+ *   3. Save the successfully bound port back to the file
+ *
+ * After startHookServer() resolves, `activeHookPort` holds the actual port.
+ * All hook scripts and plugins read this value at write time.
+ */
+const http_1 = __importDefault(require("http"));
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const logger_js_1 = __importDefault(require("../util/logger.js"));
+const timeline_emitter_js_1 = require("./timeline-emitter.js");
+exports.DEFAULT_HOOK_PORT = 51913;
+const PORT_FILE = path_1.default.join(os_1.default.homedir(), '.codedeck', 'hook-port');
+/** The port the hook server is currently listening on. Set after startHookServer() resolves. */
+exports.activeHookPort = exports.DEFAULT_HOOK_PORT;
+async function loadSavedPort() {
+    try {
+        const raw = await fs_1.promises.readFile(PORT_FILE, 'utf-8');
+        const p = parseInt(raw.trim(), 10);
+        return Number.isFinite(p) && p > 1024 && p < 65536 ? p : exports.DEFAULT_HOOK_PORT;
+    }
+    catch {
+        return exports.DEFAULT_HOOK_PORT;
+    }
+}
+async function savePort(port) {
+    await fs_1.promises.mkdir(path_1.default.dirname(PORT_FILE), { recursive: true });
+    await fs_1.promises.writeFile(PORT_FILE, String(port));
+}
+function tryBind(server, port) {
+    return new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(port, '127.0.0.1', () => {
+            server.removeListener('error', reject);
+            resolve();
+        });
+    });
+}
+function extractToolSummary(tool, input) {
+    if (!input)
+        return '';
+    switch (tool) {
+        case 'Bash': {
+            const cmd = String(input['command'] ?? '');
+            return cmd.split('\n').find((l) => l.trim()) ?? cmd;
+        }
+        case 'Read':
+        case 'Write':
+        case 'Edit':
+            return String(input['file_path'] ?? '');
+        case 'Glob':
+            return String(input['pattern'] ?? '');
+        case 'Grep':
+            return `${input['pattern'] ?? ''}${input['path'] ? ` in ${input['path']}` : ''}`;
+        case 'Agent':
+            return String(input['description'] ?? '');
+        default:
+            return '';
+    }
+}
+async function startHookServer(onHook) {
+    const preferredPort = await loadSavedPort();
+    const server = http_1.default.createServer((req, res) => {
+        if (req.method !== 'POST' || req.url !== '/notify') {
+            res.writeHead(404);
+            res.end();
+            return;
+        }
+        let body = '';
+        req.on('data', (chunk) => { body += chunk.toString(); });
+        req.on('end', () => {
+            try {
+                const msg = JSON.parse(body);
+                const event = msg['event'];
+                const session = msg['session'];
+                if (!event || !session) {
+                    res.writeHead(400);
+                    res.end('missing event or session');
+                    return;
+                }
+                if (event === 'idle') {
+                    const agentType = msg['agentType'] ?? 'unknown';
+                    logger_js_1.default.info({ session, agentType }, 'Hook: session idle');
+                    onHook({ event: 'idle', session, agentType });
+                    timeline_emitter_js_1.timelineEmitter.emit(session, 'session.state', { state: 'idle' }, { source: 'hook' });
+                }
+                else if (event === 'notification') {
+                    const title = msg['title'] ?? '';
+                    const message = msg['message'] ?? '';
+                    logger_js_1.default.info({ session, title }, 'Hook: CC notification');
+                    onHook({ event: 'notification', session, title, message });
+                }
+                else if (event === 'tool_start') {
+                    const tool = msg['tool'] ?? 'unknown';
+                    const toolInput = msg['tool_input'];
+                    const input = extractToolSummary(tool, toolInput);
+                    logger_js_1.default.debug({ session, tool }, 'Hook: tool start');
+                    onHook({ event: 'tool_start', session, tool });
+                    timeline_emitter_js_1.timelineEmitter.emit(session, 'session.state', { state: 'running' }, { source: 'hook' });
+                    timeline_emitter_js_1.timelineEmitter.emit(session, 'tool.call', { tool, ...(input ? { input } : {}) }, { source: 'hook' });
+                }
+                else if (event === 'tool_end') {
+                    logger_js_1.default.debug({ session }, 'Hook: tool end');
+                    onHook({ event: 'tool_end', session });
+                    timeline_emitter_js_1.timelineEmitter.emit(session, 'tool.result', {}, { source: 'hook' });
+                }
+                else if (event === 'mode_change') {
+                    const mode = msg['mode'] ?? '';
+                    const active = msg['active'] !== false;
+                    logger_js_1.default.debug({ session, mode, active }, 'Hook: mode change');
+                    timeline_emitter_js_1.timelineEmitter.emit(session, 'mode.state', { mode, active }, { source: 'hook' });
+                }
+                res.writeHead(200);
+                res.end('ok');
+            }
+            catch {
+                res.writeHead(400);
+                res.end('bad request');
+            }
+        });
+    });
+    // Try preferred port first, then increment on conflict
+    for (let attempt = 0; attempt < 20; attempt++) {
+        const port = preferredPort + attempt;
+        try {
+            await tryBind(server, port);
+            exports.activeHookPort = port;
+            await savePort(port);
+            if (port !== preferredPort) {
+                logger_js_1.default.info({ port, preferredPort }, 'Hook server: port conflict, using new port (saved)');
+            }
+            else {
+                logger_js_1.default.info({ port }, 'Hook server listening');
+            }
+            return { server, port };
+        }
+        catch (err) {
+            if (err.code !== 'EADDRINUSE')
+                throw err;
+            logger_js_1.default.debug({ port }, 'Hook server: port in use, trying next');
+        }
+    }
+    throw new Error(`Hook server: could not bind to any port in range ${preferredPort}–${preferredPort + 19}`);
+}
+//# sourceMappingURL=hook-server.js.map

package/dist/daemon/hook-server.js.map

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

package/dist/daemon/jsonl-watcher.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Watches Claude Code JSONL transcript files for structured events.
+ *
+ * Claude Code writes every conversation turn to:
+ *   ~/.claude/projects/{projectKey}/{sessionId}.jsonl
+ *
+ * Each line is a JSON object with type "assistant", "user", "result", or "system".
+ * This watcher tails the active JSONL file and emits structured timeline events —
+ * far more reliable than parsing raw PTY terminal output.
+ *
+ * Integration:
+ *   - startWatching(sessionName, projectDir) when a claude-code session starts
+ *   - stopWatching(sessionName) when it stops
+ */
+/** Return the ~/.claude/projects/{key} directory for a given work dir. */
+export declare function claudeProjectDir(workDir: string): string;
+/**
+ * Start watching Claude Code's JSONL transcript for a session.
+ * Only new lines written after this call are emitted — no history replay.
+ *
+ * @param sessionName  tmux session name (e.g. "deck_myapp_brain")
+ * @param workDir      absolute path to the project working directory
+ */
+export declare function startWatching(sessionName: string, workDir: string): Promise<void>;
+/** Returns true if a JSONL watcher is active for this session. */
+export declare function isWatching(sessionName: string): boolean;
+/** Stop watching and release all file handles for a session. */
+export declare function stopWatching(sessionName: string): void;
+/**
+ * Start watching a specific JSONL file for a session.
+ * Polls until the file appears (CC creates it on first conversation), then tails it.
+ * Used for CC sub-sessions where the file path is known from --session-id.
+ */
+export declare function startWatchingFile(sessionName: string, filePath: string): Promise<void>;
+//# sourceMappingURL=jsonl-watcher.d.ts.map

package/dist/daemon/jsonl-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-watcher.d.ts","sourceRoot":"","sources":["../../src/daemon/jsonl-watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAgBH,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGxD;AA6UD;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCvF;AAED,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAQtD;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4C5F"}