botmux 2.9.1 → 2.9.3

package/dist/services/bridge-turn-queue.js

@@ -0,0 +1,316 @@
+/**
+ * Adopt-bridge turn attribution state machine.
+ *
+ * Pure (no fs / IPC / timers) so the worker can wrap it with watchers and
+ * tests can drive it deterministically. The worker feeds it transcript
+ * events (already drained from JSONL) and Lark-message markers; this class
+ * decides which assistant uuids belong to which Lark turn.
+ *
+ * Attribution rule:
+ *   - mark()           — pushes a new pending turn entry (state: not started)
+ *   - ingest(events)   — for each new user/assistant event:
+ *       * user event → the earliest unstarted pending turn whose fingerprint
+ *         matches becomes 'started' (its assistantUuids will collect from
+ *         now on). A user event that does NOT match any pending fingerprint
+ *         (or arrives with no pending Lark turn at all) is treated as
+ *         **local terminal input**: a synthetic local turn is created on
+ *         the spot, started immediately, and inserted ahead of any
+ *         still-unstarted Lark turns so emit ordering reflects when the
+ *         user event actually landed in the transcript. The local turn is
+ *         emitted with `isLocal: true` so the worker can format it with a
+ *         "user typed in the terminal" marker for the Lark thread.
+ *       * assistant text event (non-sidechain) → appended to the
+ *         currently-collecting turn (Lark or local), if any.
+ *   - drainEmittable() — pops any leading turn that has been started AND has
+ *     accumulated at least one visible assistant-text uuid. Started turns with no text
+ *     yet (Claude is mid-tool-use) stay queued for the next idle.
+ *
+ * Baseline (`absorb()`) takes a batch of historical events and registers
+ * their uuids as already-seen so future ingest doesn't double-attribute.
+ */
+import { normaliseForFingerprint, isMeaningfulUserEvent, isMeaningfulQueuedCommand, extractTurnStartText } from './claude-transcript.js';
+// Re-export so existing callers (worker.ts, tests) don't need to change
+// their import path now that these helpers live in claude-transcript.ts.
+export { normaliseForFingerprint };
+function assistantHasVisibleText(content) {
+    if (typeof content === 'string')
+        return content.length > 0;
+    if (!Array.isArray(content))
+        return false;
+    return content.some((block) => block?.type === 'text' && typeof block.text === 'string' && block.text.length > 0);
+}
+/** Trim a Lark message into a stable fingerprint. Keeps a leading window
+ *  of non-whitespace-collapsed content; long enough to disambiguate, short
+ *  enough that minor formatting differences (newlines, attachment hints
+ *  appended below) don't break the match. */
+export function makeFingerprint(message, len = 30) {
+    if (typeof message !== 'string')
+        return undefined;
+    const collapsed = normaliseForFingerprint(message);
+    if (collapsed.length === 0)
+        return undefined;
+    return collapsed.substring(0, len);
+}
+export class BridgeTurnQueue {
+    seen = new Set();
+    queue = [];
+    collecting = null;
+    /** Register events as historical — their uuids are now considered seen
+     *  but no attribution happens. Used at attach time to baseline. */
+    absorb(events) {
+        for (const ev of events) {
+            if (ev.uuid)
+                this.seen.add(ev.uuid);
+        }
+    }
+    /** Push a new pending turn for the next Lark message. `contentFingerprint`
+     *  (when set) restricts which user event can start this turn — only a
+     *  user event whose content contains the fingerprint qualifies. Pass
+     *  `undefined` to start on the next user event regardless (legacy).
+     *
+     *  `markTimeMs` is captured here so the rotation fallback can bound its
+     *  fingerprint scan to events written after this point — protects short
+     *  fingerprints from matching old history in unrelated sibling jsonls. */
+    mark(turnId, contentFingerprint, markTimeMs = Date.now(), contentNormalized) {
+        this.queue.push({
+            turnId,
+            started: false,
+            assistantUuids: [],
+            contentFingerprint,
+            contentNormalized,
+            markTimeMs,
+        });
+        return turnId;
+    }
+    /** Drop all pending turns. Used when the worker discovers it can't
+     *  reliably attribute future events (e.g. baseline raced with a turn
+     *  already in flight) and wants to clear the slate. */
+    clearPending() {
+        const dropped = this.queue.splice(0);
+        if (this.collecting && dropped.includes(this.collecting))
+            this.collecting = null;
+        return dropped;
+    }
+    /** Drop a specific pending turn by turnId iff it has not yet started
+     *  collecting assistant text. Returns the dropped turn or null if not
+     *  found / already started. Used by the worker when a writeInput's
+     *  deferred recheck conclusively fails — the user has been notified
+     *  the message was lost, so keeping a fingerprint-bearing mark around
+     *  only fuels the per-tick rotation-fallback scan that already
+     *  spammed 99% CPU once (no jsonl line will ever match). */
+    dropPendingTurn(turnId) {
+        const idx = this.queue.findIndex(t => t.turnId === turnId && !t.started);
+        if (idx === -1)
+            return null;
+        const [dropped] = this.queue.splice(idx, 1);
+        return dropped;
+    }
+    /** Sweep pending (unstarted) turns whose mark is older than `maxAgeMs`.
+     *  Returns the dropped turns for logging. Belt-and-braces backstop for
+     *  any future code path that leaves an unstarted mark stranded — without
+     *  it, `maybeSwitchBridgeJsonl` would keep doing full-directory jsonl
+     *  scans every poll tick until the worker restarts. Started turns are
+     *  never expired here: once Claude actually wrote the user line, the
+     *  turn is collecting assistant text and we want to wait however long
+     *  the model takes. */
+    pruneExpired(maxAgeMs, now = Date.now()) {
+        const dropped = [];
+        this.queue = this.queue.filter(t => {
+            if (t.started)
+                return true;
+            if (t.markTimeMs === undefined)
+                return true;
+            if (now - t.markTimeMs <= maxAgeMs)
+                return true;
+            dropped.push(t);
+            return false;
+        });
+        return dropped;
+    }
+    /** Process newly-appended events. Idempotent on uuid: events with seen
+     *  uuids are skipped, so callers can safely replay.
+     *
+     *  `sourceJsonlPath` (when provided) is stamped onto a turn at the moment
+     *  it transitions from "pending" to "started" — so that emit-time text
+     *  resolution reads the same transcript file the user/assistant uuids
+     *  were originally observed in. Without this, a sessionId rotation
+     *  between ingest and emit would silently drop the reply, since the
+     *  global current jsonl path would no longer contain those uuids. */
+    ingest(events, sourceJsonlPath) {
+        for (const ev of events) {
+            const uuid = ev.uuid;
+            if (!uuid || this.seen.has(uuid))
+                continue;
+            this.seen.add(uuid);
+            const role = ev.message?.role ?? ev.type;
+            if (role === 'user') {
+                // Skip ALL non-meaningful user events: tool_result (intra-turn
+                // machinery), `<command-name>/clear</command-name>` and other
+                // slash-command wrappers (Claude rewrites them after /clear /
+                // /resume — same in-process rotation that broke bridge tracking
+                // before), isMeta / isCompactSummary markers, sidechain spawns,
+                // empty content. These are NOT real user input; treating them as
+                // turn boundaries would (a) drop `collecting` mid-stream and lose
+                // assistant text after them, and (b) let a synthetic line that
+                // accidentally contains the fingerprint substring start the
+                // wrong turn.
+                if (!isMeaningfulUserEvent(ev))
+                    continue;
+                this.handleTurnStart(uuid, ev, sourceJsonlPath);
+            }
+            else if (ev.type === 'attachment' && ev.attachment?.type === 'queued_command') {
+                // Type-ahead path: Claude writes `attachment(queued_command)` the
+                // moment it dequeues a queued submit, immediately before the
+                // assistant text for that turn starts streaming. Equivalent to
+                // role:user for turn-start purposes; share the same handler so
+                // fingerprint-match / HOL-block-drop / local-turn fallback all
+                // apply identically. Without this the bridge attribution queue
+                // would skip queued_command events and the type-ahead'd turn's
+                // assistant text would either be dropped or attributed to a
+                // sibling turn.
+                if (!isMeaningfulQueuedCommand(ev))
+                    continue;
+                this.handleTurnStart(uuid, ev, sourceJsonlPath);
+            }
+            else if (role === 'assistant') {
+                if (ev.isSidechain === true)
+                    continue;
+                if (!assistantHasVisibleText(ev.message?.content))
+                    continue;
+                if (!this.collecting) {
+                    // Headless local turn: assistant text arrived without any
+                    // collecting context. Typical trigger: daemon restart cut off
+                    // an in-flight model stream — baseline absorbed the original
+                    // user event (uuid added to `seen`) and the worker process lost
+                    // its in-memory `collecting` pointer. Without this synthesis the
+                    // continuation would be silently dropped (assistantHasVisibleText
+                    // events with no `collecting` were just skipped before).
+                    // Headless turns have no userUuid; emit-side formatting omits
+                    // the user block. Inserted at the head of the unstarted region
+                    // so a subsequent normal turn doesn't get reordered ahead of it.
+                    const headless = {
+                        turnId: `local-headless-${uuid}`,
+                        started: true,
+                        isLocal: true,
+                        userUuid: undefined,
+                        assistantUuids: [],
+                        sourceJsonlPath,
+                        markTimeMs: Date.now(),
+                    };
+                    const insertAt = this.queue.findIndex(t => !t.started);
+                    if (insertAt === -1)
+                        this.queue.push(headless);
+                    else
+                        this.queue.splice(insertAt, 0, headless);
+                    this.collecting = headless;
+                }
+                this.collecting.assistantUuids.push(uuid);
+            }
+        }
+    }
+    /** Shared turn-start handler. Called for both `role:user` and
+     *  `attachment(queued_command)` events once meaningfulness has been
+     *  established by the caller. Encapsulates:
+     *    1. HOL-block drop of the previous collecting turn when it got no
+     *       assistant text (Claude moved on).
+     *    2. Fingerprint-gated start of the earliest unstarted Lark turn,
+     *       falling through to local-turn synthesis on mismatch.
+     *    3. markTimeMs override to the transcript event's own timestamp —
+     *       critical for type-ahead, where the original markTimeMs (set when
+     *       the worker wrote to PTY) can be many seconds earlier than the
+     *       moment Claude actually dequeues and starts processing the turn.
+     *       The bridge-fallback gate's [markTimeMs, nextBoundaryMs) window
+     *       MUST anchor on the latter, otherwise a `botmux send` from the
+     *       previous turn can leak into the next turn's window and the
+     *       suppression decision flips to the wrong turn (real reply
+     *       suppressed, fallback shown — exactly what the type-ahead-disable
+     *       in commit b2d9791 was protecting against). */
+    handleTurnStart(uuid, ev, sourceJsonlPath) {
+        // Head-of-line block drop: previous turn never produced any visible
+        // assistant text and a new meaningful turn-start has arrived → Claude
+        // is single-threaded over the PTY, so the old turn will never get
+        // text. Applies to both Lark and local turns.
+        if (this.collecting && this.collecting.assistantUuids.length === 0) {
+            const idx = this.queue.indexOf(this.collecting);
+            if (idx >= 0)
+                this.queue.splice(idx, 1);
+            this.collecting = null;
+        }
+        const tsParsed = ev.timestamp ? Date.parse(ev.timestamp) : NaN;
+        const eventTimeMs = Number.isFinite(tsParsed) ? tsParsed : Date.now();
+        const next = this.queue.find(t => !t.started);
+        let consumedNext = false;
+        if (next) {
+            if (next.contentFingerprint) {
+                // Both sides normalised (whitespace-collapsed + trimmed) before
+                // the substring check so a transcript line that preserved newlines
+                // still matches a fingerprint built from the same text.
+                const userText = normaliseForFingerprint(extractTurnStartText(ev));
+                if (userText.includes(next.contentFingerprint)) {
+                    next.started = true;
+                    if (!next.sourceJsonlPath)
+                        next.sourceJsonlPath = sourceJsonlPath;
+                    next.markTimeMs = eventTimeMs;
+                    this.collecting = next;
+                    consumedNext = true;
+                }
+                // Mismatch falls through to local-turn synthesis below.
+            }
+            else {
+                // Legacy mark() with no fingerprint — start on the next turn-start.
+                next.started = true;
+                if (!next.sourceJsonlPath)
+                    next.sourceJsonlPath = sourceJsonlPath;
+                next.markTimeMs = eventTimeMs;
+                this.collecting = next;
+                consumedNext = true;
+            }
+        }
+        if (!consumedNext) {
+            // Local-terminal input (or a queued_command whose prompt didn't
+            // match any pending Lark fingerprint). Synthesise a started turn
+            // ahead of any unstarted Lark turn so chronological order matches
+            // transcript order at emit time.
+            const localTurn = {
+                turnId: `local-${uuid}`,
+                started: true,
+                isLocal: true,
+                userUuid: uuid,
+                assistantUuids: [],
+                sourceJsonlPath,
+                markTimeMs: eventTimeMs,
+            };
+            const insertAt = this.queue.findIndex(t => !t.started);
+            if (insertAt === -1)
+                this.queue.push(localTurn);
+            else
+                this.queue.splice(insertAt, 0, localTurn);
+            this.collecting = localTurn;
+        }
+    }
+    /** Pop FIFO any leading turn that's started AND has assistant text.
+     *  Returns the popped turns in order; the caller is responsible for
+     *  rebuilding the text payload from the assistant uuids. */
+    drainEmittable() {
+        const out = [];
+        while (this.queue.length > 0) {
+            const head = this.queue[0];
+            if (!head.started || head.assistantUuids.length === 0)
+                break;
+            this.queue.shift();
+            if (this.collecting === head)
+                this.collecting = null;
+            out.push(head);
+        }
+        return out;
+    }
+    /** Number of queued (not-yet-emitted) Lark turns. */
+    size() {
+        return this.queue.length;
+    }
+    /** Test helper — peek the queue without mutating. */
+    peek() {
+        return this.queue;
+    }
+}
+//# sourceMappingURL=bridge-turn-queue.js.map

package/dist/services/bridge-turn-queue.js.map

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

package/dist/services/chat-first-seen-store.d.ts

@@ -0,0 +1,27 @@
+export declare function init(appId: string): void;
+/** True iff init() has been called with an appId. Callers that may run before
+ *  daemon startup (e.g. the dashboard IPC server invoked from tests) can use
+ *  this to skip persistence rather than crash the request. */
+export declare function isInitialised(): boolean;
+/**
+ * Per-chat result of a markSeen call. `preexisting=false` means we stamped
+ * this chat for the first time in *this* call — callers that need provenance
+ * (e.g. the defaultOncall auto-bind judge) must treat freshly-stamped chats
+ * as "unknown age" rather than "new", because a missed backfill manifests
+ * exactly the same way as a real first observation.
+ */
+export interface SeenEntry {
+    firstSeenAt: number;
+    preexisting: boolean;
+}
+/**
+ * Record `Date.now()` for each chatId not yet known, return per-chat
+ * (firstSeenAt, preexisting) for the requested ids. Batches the write so a
+ * fresh 44-chat listChats only hits disk once. Empty map is returned when
+ * the store hasn't been init()'d (test harnesses that spin the IPC server up
+ * without a daemon backing it).
+ */
+export declare function markSeenBulkDetailed(chatIds: readonly string[]): Map<string, SeenEntry>;
+/** Back-compat shim — same semantics as before, returns only the timestamps. */
+export declare function markSeenBulk(chatIds: readonly string[]): Map<string, number>;
+//# sourceMappingURL=chat-first-seen-store.d.ts.map

package/dist/services/chat-first-seen-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-first-seen-store.d.ts","sourceRoot":"","sources":["../../src/services/chat-first-seen-store.ts"],"names":[],"mappings":"AAwBA,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAIxC;AAOD;;8DAE8D;AAC9D,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAiCD;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IAAG,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE;AAExE;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAqBvF;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAK5E"}

package/dist/services/chat-first-seen-store.js

@@ -0,0 +1,114 @@
+/**
+ * Per-bot "first seen" timestamps for chats — the dashboard sorts Groups & Bots
+ * by these timestamps so newly-added chats surface at the top. Lark's chat
+ * APIs do not return chat create_time, so we approximate creation order with
+ * the moment our daemon first observed each chat in `im.v1.chat.list`.
+ *
+ * On a fresh install all existing chats get the same backfill timestamp on
+ * first enumeration, so their relative order is undefined (the dashboard
+ * tie-breaks by name). From that point on, every newly-added chat gets its
+ * own real timestamp and rises above the bunch.
+ *
+ * File layout mirrors session-store: one file per bot at
+ * `${config.session.dataDir}/chat-first-seen-${appId}.json`, written
+ * atomically via tmp + rename.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync, renameSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { config } from '../config.js';
+import { logger } from '../utils/logger.js';
+let firstSeen = new Map();
+let loaded = false;
+let currentAppId;
+export function init(appId) {
+    currentAppId = appId;
+    loaded = false;
+    firstSeen = new Map();
+}
+function getFilePath() {
+    if (!currentAppId)
+        throw new Error('chat-first-seen-store not initialised (call init(appId) first)');
+    return join(config.session.dataDir, `chat-first-seen-${currentAppId}.json`);
+}
+/** True iff init() has been called with an appId. Callers that may run before
+ *  daemon startup (e.g. the dashboard IPC server invoked from tests) can use
+ *  this to skip persistence rather than crash the request. */
+export function isInitialised() {
+    return !!currentAppId;
+}
+function ensureDir() {
+    const dir = dirname(getFilePath());
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+}
+function load() {
+    if (loaded)
+        return;
+    ensureDir();
+    const fp = getFilePath();
+    if (existsSync(fp)) {
+        try {
+            const data = JSON.parse(readFileSync(fp, 'utf-8'));
+            firstSeen = new Map(Object.entries(data));
+        }
+        catch (err) {
+            logger.error(`[chat-first-seen] failed to load ${fp}: ${err}`);
+            firstSeen = new Map();
+        }
+    }
+    loaded = true;
+}
+function save() {
+    ensureDir();
+    const fp = getFilePath();
+    const tmpFp = fp + '.tmp';
+    const obj = {};
+    for (const [k, v] of firstSeen)
+        obj[k] = v;
+    writeFileSync(tmpFp, JSON.stringify(obj, null, 2), 'utf-8');
+    renameSync(tmpFp, fp);
+}
+/**
+ * Record `Date.now()` for each chatId not yet known, return per-chat
+ * (firstSeenAt, preexisting) for the requested ids. Batches the write so a
+ * fresh 44-chat listChats only hits disk once. Empty map is returned when
+ * the store hasn't been init()'d (test harnesses that spin the IPC server up
+ * without a daemon backing it).
+ */
+export function markSeenBulkDetailed(chatIds) {
+    if (!currentAppId)
+        return new Map();
+    load();
+    const now = Date.now();
+    let dirty = false;
+    const out = new Map();
+    for (const id of chatIds) {
+        const prior = firstSeen.get(id);
+        if (prior !== undefined) {
+            out.set(id, { firstSeenAt: prior, preexisting: true });
+        }
+        else {
+            firstSeen.set(id, now);
+            dirty = true;
+            out.set(id, { firstSeenAt: now, preexisting: false });
+        }
+    }
+    if (dirty) {
+        try {
+            save();
+        }
+        catch (err) {
+            logger.error(`[chat-first-seen] save failed: ${err}`);
+        }
+    }
+    return out;
+}
+/** Back-compat shim — same semantics as before, returns only the timestamps. */
+export function markSeenBulk(chatIds) {
+    const detailed = markSeenBulkDetailed(chatIds);
+    const out = new Map();
+    for (const [id, e] of detailed)
+        out.set(id, e.firstSeenAt);
+    return out;
+}
+//# sourceMappingURL=chat-first-seen-store.js.map

package/dist/services/chat-first-seen-store.js.map

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