botmux 2.60.0 → 2.60.1

package/dist/services/cursor-transcript.js

@@ -0,0 +1,324 @@
+/**
+ * Reader for Cursor Agent's per-chat transcript JSONL.
+ *
+ * `cursor-agent` keeps each chat's authoritative store in a SQLite file
+ *   ~/.cursor/chats/<projectHash>/<chatId>/store.db
+ * (held open via fd for the whole session) and, in parallel, mirrors the
+ * conversation into an append-only JSONL transcript at
+ *   ~/.cursor/projects/<projectSlug>/agent-transcripts/<chatId>/<chatId>.jsonl
+ *
+ * The bridge reads the JSONL (not the SQLite store) because it's append-only
+ * plain text — the same integration surface the Codex/CoCo bridges use. Each
+ * line is `{ role: 'user' | 'assistant', message: { content: [...] } }` where
+ * a content block is either `{ type: 'text', text }` or `{ type: 'tool_use',
+ * name, input }`. Tool *results* are not recorded.
+ *
+ * Where Cursor sits between the two existing bridge transcript shapes:
+ *   - Claude is a STREAMING event stream — one role:user event, then a run of
+ *     role:assistant events whose text grows incrementally; a turn has no
+ *     explicit terminator, so the bridge queue tracks the in-flight turn with
+ *     a `collecting` pointer.
+ *   - Codex is DISCRETE complete events — exactly one user_message and one
+ *     assistant_final per turn, each carrying the full text, with a definite
+ *     terminator (phase=final_answer).
+ * Cursor is a hybrid: each JSONL line is a DISCRETE, complete event (verified
+ * empirically — assistant lines are never growing prefixes of one another, so
+ * there is no Claude-style snapshot replay risk), but a turn is composed of
+ * MANY assistant lines (one per step). Crucially it still has a definite
+ * terminator: every intermediate step pairs its narration with a `tool_use`
+ * block, and the agent loop only stops when the model returns a message with
+ * NO tool_use. So a `text`-only assistant line is the end-of-turn final reply:
+ *   - role=user                          → the user's prompt
+ *   - role=assistant, text & no tool_use → the model's final reply
+ * Every line carrying a tool_use block is an intermediate step and is dropped.
+ * This lets the reader distill Cursor's multi-event turn down to Codex's
+ * two-event (user, assistant_final) shape, so it can reuse the proven
+ * CodexBridgeQueue attribution as-is rather than a Claude-style streaming
+ * accumulator.
+ *
+ * Consequences of that distillation (intentional):
+ *   - Only the final wrap-up text is forwarded; the short per-step narrations
+ *     ("Let me read…", "Now I'll check…") are deliberately not relayed to Lark.
+ *   - An interrupted turn (process killed / Esc mid-tool, leaving no text-only
+ *     line) emits NOTHING rather than a half-answer — the safe failure mode.
+ *
+ * Cursor's JSONL carries no per-event timestamp, so the worker baselines this
+ * transcript by byte offset at adopt time (history is behind the offset and
+ * never re-ingested) and stamps live events with the drain wall-clock. That's
+ * why every emitted event uses `Date.now()` for `timestampMs` — enough for the
+ * shared CodexBridgeQueue's freshness gates given the offset baseline.
+ *
+ * Pure I/O. Attribution belongs in CodexBridgeQueue.
+ */
+import { existsSync, statSync, openSync, readSync, closeSync, readdirSync, readlinkSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+import { homedir, platform } from 'node:os';
+import { join } from 'node:path';
+const IS_LINUX = platform() === 'linux';
+const CHAT_ID_RE = '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}';
+/** Default `~/.cursor/projects` root. Overridable by callers (tests) so the
+ *  scan doesn't depend on a real home directory. */
+export function cursorProjectsRoot() {
+    return join(homedir(), '.cursor', 'projects');
+}
+/** Extract the chatId encoded in a Cursor store.db path of the shape
+ *  `.../.cursor/chats/<projectHash>/<chatId>/store.db` (also matches the
+ *  `-wal` / `-shm` sidecar files SQLite keeps open). The chatId is the same
+ *  UUID used to name the agent-transcript JSONL, so it's the bridge between
+ *  the open fd and the transcript file. Returns undefined for non-matching
+ *  paths. */
+export function cursorChatIdFromStoreDbPath(path) {
+    const re = new RegExp(`/\\.cursor/chats/[^/]+/(${CHAT_ID_RE})/store\\.db(?:-wal|-shm)?$`, 'i');
+    const m = re.exec(path);
+    return m ? m[1] : undefined;
+}
+/** Find the chatId of an externally-running cursor-agent process by reading
+ *  the store.db file it keeps open. cursor-agent holds an fd on its current
+ *  chat's SQLite store for the whole session lifetime, which makes this the
+ *  authoritative pid→chatId binding — far more reliable than scanning chat
+ *  dirs by mtime (which would race with sibling cursor-agent panes).
+ *
+ *  Linux: `/proc/<pid>/fd/*` fast path. macOS / BSD: `lsof -p <pid> -Fn`
+ *  fallback (same shape as codex-transcript.findCodexRolloutByPid). */
+export function findCursorChatIdByPid(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return undefined;
+    if (IS_LINUX) {
+        const fdDir = `/proc/${pid}/fd`;
+        if (existsSync(fdDir)) {
+            let entries;
+            try {
+                entries = readdirSync(fdDir);
+            }
+            catch {
+                return undefined;
+            }
+            for (const fd of entries) {
+                let target;
+                try {
+                    target = readlinkSync(join(fdDir, fd));
+                }
+                catch {
+                    continue;
+                }
+                const chatId = cursorChatIdFromStoreDbPath(target);
+                if (chatId)
+                    return chatId;
+            }
+            return undefined;
+        }
+        // /proc unreadable — fall through to lsof.
+    }
+    let out;
+    try {
+        out = execSync(`lsof -p ${pid} -Fn`, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+    }
+    catch {
+        return undefined;
+    }
+    for (const line of out.split('\n')) {
+        if (!line.startsWith('n/'))
+            continue;
+        const chatId = cursorChatIdFromStoreDbPath(line.slice(1));
+        if (chatId)
+            return chatId;
+    }
+    return undefined;
+}
+/** Locate the agent-transcript JSONL for a given chatId. The chatId is a
+ *  globally-unique UUID, so a one-shot scan of the (small) projects root for
+ *  `<slug>/agent-transcripts/<chatId>/<chatId>.jsonl` is unambiguous and
+ *  avoids having to reproduce Cursor's opaque cwd→slug hashing. */
+export function findCursorTranscriptByChatId(chatId, projectsRoot = cursorProjectsRoot()) {
+    if (!chatId || !existsSync(projectsRoot))
+        return undefined;
+    let slugs;
+    try {
+        slugs = readdirSync(projectsRoot);
+    }
+    catch {
+        return undefined;
+    }
+    for (const slug of slugs) {
+        const candidate = join(projectsRoot, slug, 'agent-transcripts', chatId, `${chatId}.jsonl`);
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return undefined;
+}
+/** Resolve the transcript path for an externally-running cursor-agent pid:
+ *  pid → open store.db → chatId → agent-transcript JSONL. Returns both the
+ *  path and the chatId so the caller can remember the chatId for a later
+ *  retry if the JSONL isn't on disk yet. */
+export function findCursorTranscriptByPid(pid, projectsRoot = cursorProjectsRoot()) {
+    const chatId = findCursorChatIdByPid(pid);
+    if (!chatId)
+        return undefined;
+    const path = findCursorTranscriptByChatId(chatId, projectsRoot);
+    return path ? { path, chatId } : undefined;
+}
+/** Concatenate the text of all `type:'text'` blocks. Cursor uses the same
+ *  `{type:'text', text}` shape for both user prompts and assistant replies;
+ *  `tool_use` (and any other) blocks are ignored — the bridge only forwards
+ *  text. Tolerates a bare-string content for defensiveness. */
+function joinTextBlocks(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');
+}
+/** True when an assistant content array contains at least one tool_use block,
+ *  i.e. this is a mid-turn step rather than the final reply. */
+function hasToolUse(content) {
+    if (!Array.isArray(content))
+        return false;
+    return content.some(b => b && typeof b === 'object' && b.type === 'tool_use');
+}
+const CURSOR_REASONING_LEAK_HEADING_RE = new RegExp([
+    '\\n{2,}\\*\\*(?:',
+    [
+        'Considering',
+        'Thinking',
+        'Planning',
+        'Inspecting',
+        'Exploring',
+        'Reviewing',
+        'Troubleshooting',
+        'Diagnosing',
+        'Evaluating',
+        'Running',
+        'Checking',
+        'Reading',
+        'Understanding',
+        'Analyzing',
+        'Debugging',
+        'Responding',
+    ].join('|'),
+    ')\\b[^*\\n]{0,80}\\*\\*\\n{2,}',
+].join(''));
+function stripCursorReasoningLeak(text) {
+    // Cursor's mirror can append the model's internal planning/debug summary to
+    // the same text-only assistant line that otherwise represents the final user
+    // reply. The leak starts with a bold English activity heading after a blank
+    // paragraph, e.g. "**Considering user response**".
+    const marker = CURSOR_REASONING_LEAK_HEADING_RE.exec(text);
+    if (!marker || marker.index <= 0)
+        return text;
+    return text.slice(0, marker.index).trimEnd();
+}
+function eventFromLine(path, lineStart, obj, timestampMs) {
+    const role = obj?.role ?? obj?.message?.role;
+    const content = obj?.message?.content;
+    if (role === 'user') {
+        const t = joinTextBlocks(content);
+        if (!t)
+            return undefined;
+        return { uuid: `${path}:${lineStart}`, timestampMs, kind: 'user', text: t };
+    }
+    if (role === 'assistant') {
+        // A turn ends with a text-only assistant line; any line carrying a
+        // tool_use block is an intermediate step and must not be forwarded.
+        if (hasToolUse(content))
+            return undefined;
+        const t = stripCursorReasoningLeak(joinTextBlocks(content));
+        if (!t)
+            return undefined;
+        return { uuid: `${path}:${lineStart}`, timestampMs, kind: 'assistant_final', text: t };
+    }
+    return undefined;
+}
+/** Increment-read the transcript from `fromOffset`. Mirrors the byte-offset
+ *  contract of codex-transcript.drainCodexRollout so the worker can reuse the
+ *  same fs.watch / poll wakeup machinery and the shared CodexBridgeQueue. */
+export function drainCursorTranscript(path, fromOffset) {
+    if (!existsSync(path))
+        return { events: [], newOffset: fromOffset, pendingTail: '' };
+    let size;
+    try {
+        size = statSync(path).size;
+    }
+    catch {
+        return { events: [], newOffset: fromOffset, pendingTail: '' };
+    }
+    let start = fromOffset;
+    // Cursor's mirror can briefly disappear / shrink while it rewrites. Do not
+    // reset to 0 here: replaying the full history pollutes attribution state and
+    // can wedge a live turn behind old events. Wait for the mirror to grow past
+    // the last consumed byte instead.
+    if (size < start)
+        return { events: [], newOffset: fromOffset, pendingTail: '' };
+    if (size === start)
+        return { events: [], newOffset: start, pendingTail: '' };
+    const len = size - start;
+    const buf = Buffer.alloc(len);
+    const fd = openSync(path, 'r');
+    try {
+        readSync(fd, buf, 0, len, start);
+    }
+    finally {
+        closeSync(fd);
+    }
+    const text = buf.toString('utf8');
+    const lastNl = text.lastIndexOf('\n');
+    const completeText = lastNl >= 0 ? text.slice(0, lastNl + 1) : '';
+    let pendingTail = lastNl >= 0 ? text.slice(lastNl + 1) : text;
+    let newOffset = start + Buffer.byteLength(completeText, 'utf8');
+    const events = [];
+    // Track byte offset within the file so synthetic uuids are stable across
+    // re-drains (the transcript is append-only).
+    let cursor = start;
+    for (const line of completeText.split('\n')) {
+        if (line.length === 0) {
+            cursor += 1; // the \n after an empty line
+            continue;
+        }
+        const lineByteLen = Buffer.byteLength(line, 'utf8') + 1; // include \n
+        const lineStart = cursor;
+        cursor += lineByteLen;
+        let obj;
+        try {
+            obj = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        // No per-event timestamp in Cursor's JSONL — stamp with the drain
+        // wall-clock. Combined with byte-offset baselining at attach, this keeps
+        // the CodexBridgeQueue freshness gates happy without a real timestamp.
+        const timestampMs = Date.now();
+        const ev = eventFromLine(path, lineStart, obj, timestampMs);
+        if (ev)
+            events.push(ev);
+    }
+    // Cursor frequently leaves the final JSON object at EOF without a trailing
+    // newline until the next turn mutates the mirror. If the tail is already a
+    // complete JSON object, consume it now; otherwise keep it pending.
+    if (pendingTail.length > 0) {
+        try {
+            const lineStart = newOffset;
+            const obj = JSON.parse(pendingTail);
+            const ev = eventFromLine(path, lineStart, obj, Date.now());
+            if (ev)
+                events.push(ev);
+            newOffset = size;
+            pendingTail = '';
+        }
+        catch {
+            // Still being written.
+        }
+    }
+    return { events, newOffset, pendingTail };
+}
+//# sourceMappingURL=cursor-transcript.js.map

package/dist/services/cursor-transcript.js.map

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

package/dist/worker.js

@@ -26,6 +26,7 @@ import { findTraexRolloutBySessionId, findTraexRolloutByPid } from './services/t
 import { cocoEventsPathForSession, drainCocoEvents, findCocoSessionByPid } from './services/coco-transcript.js';
 import { currentHermesStateOffset, drainHermesStateDb } from './services/hermes-transcript.js';
 import { currentMtrSessionOffset, drainMtrSession, findLatestMtrSessionByDirectory, findMtrSessionById } from './services/mtr-transcript.js';
+import { drainCursorTranscript, findCursorTranscriptByChatId, findCursorTranscriptByPid } from './services/cursor-transcript.js';
 import { baselineJsonlCursor } from './services/jsonl-cursor.js';
 import { dirname } from 'node:path';
 import { createServer as createHttpServer } from 'node:http';
@@ -1433,7 +1434,16 @@ function drainPathInto(path, fromOffset) {
 function codexBridgeFallbackActive() {
     // True for transcript-backed CLIs whose final output can be harvested
     // when the model forgets to call `botmux send`.
-    return lastInitConfig?.cliId === 'codex' || lastInitConfig?.cliId === 'traex' || lastInitConfig?.cliId === 'coco' || lastInitConfig?.cliId === 'hermes' || lastInitConfig?.cliId === 'mtr';
+    const id = lastInitConfig?.cliId;
+    if (id === 'codex' || id === 'traex' || id === 'coco' || id === 'hermes' || id === 'mtr')
+        return true;
+    // Cursor only harvests its transcript in adopt mode: a botmux-spawned
+    // cursor session carries the botmux skill and replies via `botmux send`,
+    // and we never resolve a transcript path for it — so leave that flow
+    // (screen capture + botmux send) untouched and scope the bridge to adopt.
+    if (id === 'cursor')
+        return lastInitConfig?.adoptMode === true;
+    return false;
 }
 // Both Codex and TRAE share the same rollout JSONL layout (response_item
 // messages), so drainCodexRollout works for both.
@@ -1446,9 +1456,14 @@ function structuredBridgeIsHermes() {
 function structuredBridgeIsMtr() {
     return lastInitConfig?.cliId === 'mtr';
 }
+function codexBridgeIsCursor() {
+    return lastInitConfig?.cliId === 'cursor';
+}
 function structuredBridgeIngestPath(path, offset) {
     if (structuredBridgeIsCodex())
         return drainCodexRollout(path, offset);
+    if (codexBridgeIsCursor())
+        return drainCursorTranscript(path, offset);
     if (structuredBridgeIsHermes()) {
         const result = drainHermesStateDb(offset);
         return { events: result.events, newOffset: result.newOffset, pendingTail: '' };
@@ -1496,6 +1511,30 @@ function codexBridgeStartTimer() {
                     emitReadyCodexTurns();
                 return;
             }
+            if (codexBridgeIsCursor()) {
+                // Late-attach: the transcript usually exists at adopt time (the
+                // session is already running), so cursorBridgeAttach in setup wins.
+                // This covers the rare race where pid→chatId resolved but the JSONL
+                // hadn't been created yet. Resolution order: chatId (cliSessionId) →
+                // path; then adopt pid → store.db fd → chatId → path.
+                if (!codexBridgeRolloutPath) {
+                    let path = codexBridgePendingSessionId
+                        ? findCursorTranscriptByChatId(codexBridgePendingSessionId)
+                        : undefined;
+                    if (!path && codexAdoptPendingPid) {
+                        path = findCursorTranscriptByPid(codexAdoptPendingPid)?.path;
+                    }
+                    if (path) {
+                        codexBridgePendingSessionId = undefined;
+                        codexAdoptPendingPid = undefined;
+                        cursorBridgeAttach(path, cursorLateAttachMode(path));
+                    }
+                }
+                codexBridgeIngest();
+                if (isPromptReady)
+                    emitReadyCodexTurns();
+                return;
+            }
             if (!codexBridgeRolloutPath) {
                 // Two discovery paths, in order: cliSessionId (known via writeInput
                 // result for non-adopt or daemon-side probe for adopt) → exact
@@ -1661,6 +1700,17 @@ function codexBridgeAttach(rolloutPath, mode) {
         codexBridgeBaselineDone = true;
         log(`Codex bridge split-live degraded to fresh (file missing): ${rolloutPath}`);
     }
+    else if (mode === 'baseline-existing-skip-tail' && existsSync(rolloutPath)) {
+        let size = 0;
+        try {
+            size = statSync(rolloutPath).size;
+        }
+        catch { /* degrade below */ }
+        codexBridgeOffset = size;
+        codexBridgePendingTail = '';
+        codexBridgeBaselineDone = true;
+        log(`Codex bridge baselined: ${rolloutPath} (offset=${codexBridgeOffset}, skipTail=true)`);
+    }
     else if (existsSync(rolloutPath)) {
         const cursor = baselineJsonlCursor(rolloutPath);
         codexBridgeOffset = cursor.newOffset;
@@ -1696,6 +1746,39 @@ function codexBridgeAttach(rolloutPath, mode) {
     // （codexBridgeIngest 在 offset 未推进时是 no-op）。
     codexBridgeStartTimer();
 }
+function cursorLateAttachMode(path) {
+    const start = codexAdoptStartMs;
+    if (start !== undefined) {
+        try {
+            const birthtimeMs = statSync(path).birthtimeMs;
+            // Cursor often creates the agent-transcript file lazily on the first
+            // post-adopt submit. In that case the first user line is live and must
+            // be ingested from byte 0 rather than swallowed as history.
+            if (Number.isFinite(birthtimeMs) && birthtimeMs >= start - 5_000)
+                return 'fresh-empty';
+        }
+        catch { /* fall back to history-safe baseline */ }
+    }
+    return 'baseline-existing';
+}
+/** Attach the Cursor adopt bridge. Cursor's JSONL has no per-event
+ *  timestamp, so existing transcripts are baselined by byte offset. Cursor
+ *  restore intentionally skips any partial tail present at attach time: it is
+ *  old in-flight output and must not be attributed to the next Lark turn. If
+ *  the transcript is created after /adopt, attach fresh so the first
+ *  post-adopt Lark/user turn can still be attributed. */
+function cursorBridgeAttach(path, mode = 'baseline-existing') {
+    if (mode === 'baseline-existing' && existsSync(path)) {
+        try {
+            const full = drainCursorTranscript(path, 0);
+            maybeEmitCodexAdoptPreamble(full.events);
+        }
+        catch (err) {
+            log(`Cursor bridge preamble drain failed: ${err.message}`);
+        }
+    }
+    codexBridgeAttach(path, mode === 'baseline-existing' ? 'baseline-existing-skip-tail' : mode);
+}
 /** Called from flushPending after writeInput first returns a cliSessionId.
  *  Tries to locate the rollout file immediately; if it's not on disk yet,
  *  remembers the sid so the 1s poller can keep retrying. */
@@ -1714,6 +1797,20 @@ function codexBridgeNotifyCliSessionId(cliSessionId) {
         }
         return;
     }
+    if (codexBridgeIsCursor()) {
+        // Cursor's cliSessionId is the chatId — the same UUID naming the
+        // agent-transcript JSONL, so it resolves the path directly.
+        const cursorPath = findCursorTranscriptByChatId(cliSessionId);
+        if (cursorPath) {
+            codexBridgePendingSessionId = undefined;
+            cursorBridgeAttach(cursorPath, cursorLateAttachMode(cursorPath));
+        }
+        else {
+            codexBridgePendingSessionId = cliSessionId;
+            codexBridgeStartTimer();
+        }
+        return;
+    }
     const path = lastInitConfig?.cliId === 'traex'
         ? findTraexRolloutBySessionId(cliSessionId)
         : findCodexRolloutBySessionId(cliSessionId);
@@ -2986,6 +3083,37 @@ function setupAdoptTranscriptBridges(cfg) {
             codexBridgeStartTimer();
         }
     }
+    else if (cfg.cliId === 'cursor') {
+        const adoptStartMs = Date.now();
+        codexAdoptStartMs = adoptStartMs;
+        // Cursor JSONL lacks per-event timestamps, but adopt still needs parity
+        // with other transcript bridges: direct terminal input should be surfaced
+        // as a local-turn card in Lark. Baseline/offset handling above keeps
+        // pre-adopt history out of the queue; worst-case mirror replay is a
+        // duplicate local-turn message rather than lost local input.
+        codexBridgeQueue.setLocalTurns(true, adoptStartMs);
+        // Resolve the transcript: cliSessionId (= Cursor chatId) when discovery
+        // captured it, else the adopt pid via its open store.db fd. Cursor lacks
+        // per-event timestamps, so cursorBridgeAttach baselines by byte offset
+        // rather than the timestamp-cutoff split-live the other CLIs use.
+        let path;
+        if (cfg.cliSessionId)
+            path = findCursorTranscriptByChatId(cfg.cliSessionId);
+        if (!path && cfg.adoptCliPid) {
+            const probed = findCursorTranscriptByPid(cfg.adoptCliPid);
+            if (probed)
+                path = probed.path;
+        }
+        if (path) {
+            cursorBridgeAttach(path);
+        }
+        else {
+            if (cfg.cliSessionId)
+                codexBridgePendingSessionId = cfg.cliSessionId;
+            codexAdoptPendingPid = cfg.adoptCliPid;
+            codexBridgeStartTimer();
+        }
+    }
 }
 function adoptIdleAdapter(cfg) {
     return cfg.bridgeJsonlPath
@@ -4120,11 +4248,24 @@ process.on('message', async (raw) => {
                     // in-flight events from a local-typed prior turn close before
                     // this Lark turn's fingerprint window opens. Mark works even
                     // pre-attach (queue is path-agnostic).
-                    try {
-                        codexBridgeIngest();
+                    if (codexBridgeIsCursor()) {
+                        // Cursor may append the current Lark/user line to its transcript
+                        // before this IPC message is handled. Mark first so that preexisting
+                        // current-line can still fingerprint-match instead of being marked
+                        // seen as an unmatched event.
+                        codexBridgeMarkPendingTurn(content);
+                        try {
+                            codexBridgeIngest();
+                        }
+                        catch { /* best effort */ }
+                    }
+                    else {
+                        try {
+                            codexBridgeIngest();
+                        }
+                        catch { /* best effort */ }
+                        codexBridgeMarkPendingTurn(content);
                     }
-                    catch { /* best effort */ }
-                    codexBridgeMarkPendingTurn(content);
                 }
                 // Adopt mode write:
                 //   - codex routes through cliAdapter.writeInput so the adapter's