botmux 2.11.1 → 2.12.0

package/dist/services/claude-transcript.d.ts

@@ -0,0 +1,168 @@
+/** Subset of Claude Code's JSONL event shape we care about. */
+export interface TranscriptEvent {
+    type?: string;
+    uuid?: string;
+    sessionId?: string;
+    timestamp?: string;
+    message?: {
+        role?: string;
+        content?: unknown;
+    };
+}
+export interface DrainResult {
+    events: TranscriptEvent[];
+    /** Byte offset to pass back on the next drain. */
+    newOffset: number;
+    /** Trailing partial line (no newline yet) — kept so the next drain can
+     *  prepend it. Internal helper for chained drains; callers usually only
+     *  need to remember `newOffset`. */
+    pendingTail: string;
+}
+/**
+ * Read everything from `path` starting at `fromOffset` and return parsed
+ * JSONL events plus the new file offset.
+ *
+ * - Returns `{ events: [], newOffset: 0, pendingTail: '' }` if the file
+ *   doesn't exist (caller treats this as "nothing yet").
+ * - Detects truncation (size < fromOffset): resets to 0 and re-drains so a
+ *   rotated/cleared transcript doesn't silently swallow new lines.
+ * - Skips malformed JSON lines (logs nothing — robustness over noise).
+ * - The trailing partial line (no `\n` yet) is *not* parsed and *not*
+ *   counted toward `newOffset`, so the next drain re-reads it.
+ */
+export declare function drainTranscript(path: string, fromOffset: number): DrainResult;
+/**
+ * Filter to assistant text events. Returns only events where:
+ *   - type === 'assistant' OR message.role === 'assistant'
+ *   - content has at least one text block
+ *   - uuid is present
+ *
+ * Sub-agent / sidechain events (isSidechain === true) are excluded so that
+ * spawn-internal Task agent chatter doesn't leak to Lark.
+ */
+export declare function pickAssistantTextEvents(events: TranscriptEvent[]): TranscriptEvent[];
+/**
+ * Extract the visible text from one assistant event. Walks all `type:'text'`
+ * blocks in `message.content` (or the bare string) and joins them with
+ * blank lines. Returns '' if no text blocks.
+ */
+export declare function extractAssistantText(event: TranscriptEvent): string;
+/** Convenience: filter+extract a list of events into a single concatenated string. */
+export declare function joinAssistantText(events: TranscriptEvent[]): string;
+/** True when a `type:'user'` (or `message.role:'user'`) event represents a
+ *  *real* prompt the human typed — not Claude Code's internal machinery
+ *  (tool_result, slash-command wrappers, isMeta/isCompactSummary markers,
+ *  sidechain spawn events). The bridge attribution queue and the adopt
+ *  preamble extractor share this predicate to ensure they're seeing the
+ *  same notion of "user input". */
+export declare function isMeaningfulUserEvent(ev: TranscriptEvent | null | undefined): boolean;
+export interface AdoptPreamble {
+    /** The most recent meaningful user prompt's text (post-stringify, no
+     *  whitespace collapse — preserves the prompt's actual formatting). */
+    userText: string;
+    /** All assistant visible-text emitted between that user prompt and the
+     *  end of the events list, joined with blank lines. tool_use blocks are
+     *  excluded; sidechain assistant events are excluded. */
+    assistantText: string;
+}
+/** Walk the events forward and return the last *completed* user/assistant
+ *  exchange. "Completed" here means: a meaningful user prompt followed by
+ *  at least one assistant event with visible text. tool_use / tool_result
+ *  events do NOT reset the turn — they're intra-turn machinery, so a
+ *  prompt → tool_use → tool_result → assistant text sequence still counts
+ *  as a single turn. Returns null when there's no meaningful user yet, or
+ *  the last user wasn't followed by any visible assistant text (Claude is
+ *  mid-tool-use when /adopt fired).
+ *
+ *  Used by adopt-bridge to surface "the previous round" to the Lark thread
+ *  so the user has context for continuing the conversation. */
+export declare function extractLastAssistantTurn(events: TranscriptEvent[]): AdoptPreamble | null;
+/**
+ * True when a user-role event carries ONLY tool_result blocks — Claude
+ * Code's representation of "tool returned this output" between an
+ * assistant tool_use and the assistant's continuation. Both the bridge
+ * attribution queue and the on-disk fingerprint search must skip these:
+ *
+ *   - the queue would treat tool output as fresh local input and disable
+ *     collection mid-turn,
+ *   - the fingerprint search would false-positive on log content that
+ *     happens to contain the Lark fingerprint substring (e.g. a short
+ *     "hello" message hijacked by an unrelated jsonl whose tool_result
+ *     dumped a log line containing "hello"). Re-exported by
+ *     bridge-turn-queue.ts so both consumers share the same predicate
+ *     and never drift apart.
+ */
+export declare function isPureToolResultUserEvent(content: unknown): boolean;
+/**
+ * Stringify a transcript user event's content to a flat string. Handles
+ * both legacy bare-string content and the array-of-blocks form.
+ *
+ * Lives here (not in bridge-turn-queue.ts) so the in-process attribution
+ * state machine and the on-disk fingerprint search use *exactly* the
+ * same text — otherwise multi-line / array-content Lark messages stop
+ * matching one path or the other and bridges silently break.
+ */
+export declare function stringifyUserContent(content: unknown): string;
+/**
+ * Collapse whitespace + trim. Same normalisation applied on both sides
+ * of the fingerprint compare (the Lark message that produces the
+ * fingerprint, and the transcript user content we search through),
+ * so newlines / tabs / double-spaces don't break the match.
+ */
+export declare function normaliseForFingerprint(s: string): string;
+/**
+ * Find the most recently-modified `.jsonl` file in a Claude Code project
+ * directory. Helper kept for diagnostics and tests. The adopt-bridge
+ * watcher does NOT use mtime to follow session switches — see
+ * `findJsonlContainingFingerprint` for the safer fingerprint-based variant
+ * that ignores unrelated panes writing in the same project directory.
+ *
+ * Returns null when the directory doesn't exist or has no jsonl files.
+ */
+export declare function findLatestJsonl(dir: string): string | null;
+/**
+ * Search every `.jsonl` file in `dir` for one whose contents include the
+ * given fingerprint. Used by the bridge watcher to detect a session
+ * switch (`/clear` / `/resume`) caused by the user's pane: when a Lark
+ * message is pending and its content fingerprint shows up in a NEW jsonl
+ * file, that file is the user's current session and we should switch.
+ *
+ * Pinning the switch decision to fingerprint match (rather than mtime)
+ * avoids hijacking by sibling Claude Code panes in the same project
+ * directory — they'll write busy jsonls but won't ever contain our Lark
+ * fingerprint.
+ *
+ * Optional `excludePath` skips the file we're already watching so the
+ * caller's "did it change?" comparison is cheap.
+ *
+ * Reads only the trailing 1 MB of each candidate (fingerprints land near
+ * the end of the jsonl when Claude has just written them) — long-lived
+ * sessions can grow to tens of MB so a full read would be wasteful.
+ * Callers should still gate on "an unstarted pending turn exists" rather
+ * than calling this on every poll tick.
+ */
+export interface JsonlFingerprintSearchOptions {
+    /** Skip the file the caller is already watching/checking. */
+    excludePath?: string;
+    /** Ignore older files when the caller is looking for a just-written submit. */
+    minMtimeMs?: number;
+    /** Drop events whose `timestamp` field is older than this (millis since
+     *  epoch). Defends against short fingerprints ("hello", "test") matching
+     *  old user lines in unrelated sibling jsonls — file mtime alone isn't
+     *  enough since a sibling Claude pane could be actively writing. */
+    minEventTimestampMs?: number;
+    /** Also match Claude Code type-ahead enqueue events, whose content is not role:user. */
+    includeQueueOperations?: boolean;
+}
+/** Scan a single jsonl file's tail for a Lark message fingerprint. Same
+ *  parsing rules as `findJsonlContainingFingerprint` (decode role:user content,
+ *  optionally also queue-operation/enqueue, normalise whitespace, then
+ *  substring-match the fingerprint). Used by the claude-code adapter when
+ *  the pid resolver has just switched to a rotated jsonl that may already
+ *  contain the just-submitted user event. */
+export declare function jsonlContainsFingerprint(path: string, fingerprint: string, opts?: {
+    includeQueueOperations?: boolean;
+    minEventTimestampMs?: number;
+}): boolean;
+export declare function findJsonlContainingFingerprint(dir: string, fingerprint: string, excludePathOrOptions?: string | JsonlFingerprintSearchOptions): string | null;
+//# sourceMappingURL=claude-transcript.d.ts.map

package/dist/services/claude-transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-transcript.d.ts","sourceRoot":"","sources":["../../src/services/claude-transcript.ts"],"names":[],"mappings":"AAgBA,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB;;wCAEoC;IACpC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB,WAAW,CA8Db;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE,CAapF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAYnE;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAKnE;AAeD;;;;;mCAKmC;AACnC,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAcrF;AAED,MAAM,WAAW,aAAa;IAC5B;2EACuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB;;6DAEyD;IACzD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;+DAU+D;AAC/D,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,aAAa,GAAG,IAAI,CAyBxF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAGnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAS7D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAyB1D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,6BAA6B;IAC5C,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;wEAGoE;IACpE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,wFAAwF;IACxF,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;;;;6CAK6C;AAC7C,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE;IAAE,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAE,GACxE,OAAO,CA6DT;AAED,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,oBAAoB,CAAC,EAAE,MAAM,GAAG,6BAA6B,GAC5D,MAAM,GAAG,IAAI,CA2Ff"}