@threadbase-sh/streamer 1.67.0 → 1.67.2

package/dist/api/handlers/conversations.handlers.d.ts

@@ -60,6 +60,35 @@ export declare class ConversationHandlers {
     handleGetPopularProjects(url: URL, res: ServerResponse): void;
     handleGetProjectSummaries(url: URL, res: ServerResponse): void;
     findJsonlPath(uuid: string): string | null;
+    /**
+     * Resolve a conversation id to a JSONL path, in order of authority.
+     *
+     * `findJsonlPath` alone answers 64.0% of this machine's 961 conversations and
+     * 0 of 343 Codex ones — it reconstructs `<projectsDir>/<dir>/<uuid>.jsonl`,
+     * which is Claude Code's layout, and a Codex rollout is
+     * `rollout-<ts>-<uuid>.jsonl` under a date path, so that walk cannot match one
+     * by construction. The ladder below answers 99.7%, leaving only the three
+     * whose file is genuinely gone.
+     */
+    locateJsonlPath(uuid: string, lookupId: string): Promise<string | null>;
+    /**
+     * Does `filePath` actually hold the conversation `requestedId` names?
+     *
+     * The filename settles it for both providers: Claude writes `<uuid>.jsonl`
+     * (or `agent-<agentId>.jsonl`), Codex writes `rollout-<ts>-<uuid>.jsonl`.
+     * Only when the name says nothing do we open the file — and there the naive
+     * rule is wrong, because **a Claude subagent transcript carries the PARENT's
+     * `sessionId`**. Matching on `sessionId` alone therefore verifies exactly the
+     * file this check exists to reject, so a sidechain is refused outright unless
+     * it was asked for by its own `agent-<agentId>` name, which the filename
+     * branch above already covers.
+     */
+    isJsonlPathFor(filePath: string, requestedId: string): Promise<boolean>;
+    /** First parseable JSONL line, for identity checks. Null on an empty or unreadable file. */
+    readFirstJsonlEntry(filePath: string): Promise<{
+        sessionId?: string;
+        isSidechain?: boolean;
+    } | null>;
     readCwdFromJsonl(filePath: string): Promise<string | null>;
     findConversationByUuid(uuid: string): Promise<Conversation | null>;
     handleGetConversation(id: string, url: URL, res: ServerResponse, ifNoneMatch?: string): Promise<void>;

package/dist/api/handlers/conversations.handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversations.handlers.d.ts","sourceRoot":"","sources":["../../../src/api/handlers/conversations.handlers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"conversations.handlers.d.ts","sourceRoot":"","sources":["../../../src/api/handlers/conversations.handlers.ts"],"names":[],"mappings":"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"}

package/dist/cli.cjs

@@ -99746,8 +99746,8 @@ var require_pattern = __commonJS({
     }
     exports2.endsWithSlashGlobStar = endsWithSlashGlobStar;
     function isAffectDepthOfReadingPattern(pattern) {
-      const basename12 = path2.basename(pattern);
-      return endsWithSlashGlobStar(pattern) || isStaticPattern(basename12);
+      const basename13 = path2.basename(pattern);
+      return endsWithSlashGlobStar(pattern) || isStaticPattern(basename13);
     }
     exports2.isAffectDepthOfReadingPattern = isAffectDepthOfReadingPattern;
     function expandPatternsWithBraceExpansion(patterns2) {
@@ -139150,10 +139150,10 @@ var ReaddirpStream = class extends import_node_stream.Readable {
   }
   async _formatEntry(dirent, path2) {
     let entry;
-    const basename12 = this._isDirent ? dirent.name : dirent;
+    const basename13 = this._isDirent ? dirent.name : dirent;
     try {
-      const fullPath = (0, import_node_path8.resolve)((0, import_node_path8.join)(path2, basename12));
-      entry = { path: (0, import_node_path8.relative)(this._root, fullPath), fullPath, basename: basename12 };
+      const fullPath = (0, import_node_path8.resolve)((0, import_node_path8.join)(path2, basename13));
+      entry = { path: (0, import_node_path8.relative)(this._root, fullPath), fullPath, basename: basename13 };
       entry[this._statsProp] = this._isDirent ? dirent : await this._stat(fullPath);
     } catch (err) {
       this._onError(err);
@@ -139694,9 +139694,9 @@ var NodeFsHandler = class {
   _watchWithNodeFs(path2, listener) {
     const opts = this.fsw.options;
     const directory = sp.dirname(path2);
-    const basename12 = sp.basename(path2);
+    const basename13 = sp.basename(path2);
     const parent = this.fsw._getWatchedDir(directory);
-    parent.add(basename12);
+    parent.add(basename13);
     const absolutePath = sp.resolve(path2);
     const options = {
       persistent: opts.persistent
@@ -139706,7 +139706,7 @@ var NodeFsHandler = class {
     let closer;
     if (opts.usePolling) {
       const enableBin = opts.interval !== opts.binaryInterval;
-      options.interval = enableBin && isBinaryPath(basename12) ? opts.binaryInterval : opts.interval;
+      options.interval = enableBin && isBinaryPath(basename13) ? opts.binaryInterval : opts.interval;
       closer = setFsWatchFileListener(path2, absolutePath, options, {
         listener,
         rawEmitter: this.fsw._emitRaw
@@ -139729,10 +139729,10 @@ var NodeFsHandler = class {
       return;
     }
     const dirname18 = sp.dirname(file2);
-    const basename12 = sp.basename(file2);
+    const basename13 = sp.basename(file2);
     const parent = this.fsw._getWatchedDir(dirname18);
     let prevStats = stats;
-    if (parent.has(basename12))
+    if (parent.has(basename13))
       return;
     const listener = async (path2, newStats) => {
       if (!this.fsw._throttle(THROTTLE_MODE_WATCH, file2, 5))
@@ -139757,9 +139757,9 @@ var NodeFsHandler = class {
             prevStats = newStats2;
           }
         } catch (error51) {
-          this.fsw._remove(dirname18, basename12);
+          this.fsw._remove(dirname18, basename13);
         }
-      } else if (parent.has(basename12)) {
+      } else if (parent.has(basename13)) {
         const at2 = newStats.atimeMs;
         const mt2 = newStats.mtimeMs;
         if (!at2 || at2 <= mt2 || mt2 !== prevStats.mtimeMs) {
@@ -143610,8 +143610,18 @@ var IndexQueue = class {
 };
 var BATCH_SIZE2 = 12;
 var DEFAULT_CONFIG_PATH2 = "~/.config/threadbase-scanner";
+function isTestProcess() {
+  return Boolean(process.env.VITEST) || Boolean(process.env.JEST_WORKER_ID) || process.env.NODE_ENV === "test";
+}
 function defaultDbPath() {
-  return process.env.TB_SCANNER_DB ?? (0, import_path10.join)((0, import_os8.homedir)(), ".config", "threadbase-scanner", "index.db");
+  const override = process.env.TB_SCANNER_DB;
+  if (override) return override;
+  if (isTestProcess()) {
+    throw new Error(
+      "TB_SCANNER_DB must be set under a test runner. Refusing to open the default index at ~/.config/threadbase-scanner/index.db, because test fixtures written there are indistinguishable from real conversations and corrupt every measurement of the index. Point it at a temp directory in your test setup, or pass persistent.dbPath explicitly."
+    );
+  }
+  return (0, import_path10.join)((0, import_os8.homedir)(), ".config", "threadbase-scanner", "index.db");
 }
 function capForMemory(doc, max) {
   const combined = combineSearchContent(doc);
@@ -144602,6 +144612,7 @@ CREATE TABLE IF NOT EXISTS session_names (
 );
 `;
 var cacheLog = getLogger("cache");
+var PARSE_STATE_LOOKBACK = 8;
 var ConversationCache = class _ConversationCache {
   db;
   tailSize;
@@ -145118,7 +145129,7 @@ var ConversationCache = class _ConversationCache {
     if (to2 <= from) return { messages: [], total, fromIndex: from };
     const rows = this.getMessageIndexWindow(
       _ConversationCache.conversationIdForFile(filePath),
-      from,
+      Math.max(0, from - PARSE_STATE_LOOKBACK),
       to2
     );
     if (rows.length === 0) return { messages: [], total, fromIndex: from };
@@ -145130,7 +145141,7 @@ var ConversationCache = class _ConversationCache {
         const buf = Buffer.alloc(row.byte_length);
         (0, import_fs18.readSync)(fd, buf, 0, row.byte_length, row.byte_offset);
         const msg = parseJsonlLine(buf.toString("utf-8"), state);
-        if (msg) messages.push(msg);
+        if (msg && row.message_index >= from) messages.push(msg);
       }
     } finally {
       (0, import_fs18.closeSync)(fd);
@@ -146482,6 +146493,64 @@ var ConversationHandlers = class {
     }
     return null;
   }
+  /**
+   * Resolve a conversation id to a JSONL path, in order of authority.
+   *
+   * `findJsonlPath` alone answers 64.0% of this machine's 961 conversations and
+   * 0 of 343 Codex ones — it reconstructs `<projectsDir>/<dir>/<uuid>.jsonl`,
+   * which is Claude Code's layout, and a Codex rollout is
+   * `rollout-<ts>-<uuid>.jsonl` under a date path, so that walk cannot match one
+   * by construction. The ladder below answers 99.7%, leaving only the three
+   * whose file is genuinely gone.
+   */
+  async locateJsonlPath(uuid3, lookupId) {
+    const live = this.deps.findLiveSessionFilePath(uuid3) ?? this.deps.findLiveSessionFilePath(lookupId);
+    if (live) return live;
+    const cached4 = this.cache?.getMetaById(lookupId)?.filePath;
+    if (cached4 && await this.isJsonlPathFor(cached4, lookupId)) return cached4;
+    return this.findJsonlPath(lookupId);
+  }
+  /**
+   * Does `filePath` actually hold the conversation `requestedId` names?
+   *
+   * The filename settles it for both providers: Claude writes `<uuid>.jsonl`
+   * (or `agent-<agentId>.jsonl`), Codex writes `rollout-<ts>-<uuid>.jsonl`.
+   * Only when the name says nothing do we open the file — and there the naive
+   * rule is wrong, because **a Claude subagent transcript carries the PARENT's
+   * `sessionId`**. Matching on `sessionId` alone therefore verifies exactly the
+   * file this check exists to reject, so a sidechain is refused outright unless
+   * it was asked for by its own `agent-<agentId>` name, which the filename
+   * branch above already covers.
+   */
+  async isJsonlPathFor(filePath, requestedId) {
+    if (!(0, import_fs20.existsSync)(filePath)) return false;
+    const stem = (0, import_path18.basename)(filePath).replace(/\.jsonl$/, "");
+    if (stem === requestedId || stem.includes(requestedId)) return true;
+    const first = await this.readFirstJsonlEntry(filePath);
+    if (!first || first.isSidechain === true) return false;
+    return first.sessionId === requestedId;
+  }
+  /** First parseable JSONL line, for identity checks. Null on an empty or unreadable file. */
+  async readFirstJsonlEntry(filePath) {
+    return new Promise((resolve4) => {
+      const rl = (0, import_readline4.createInterface)({ input: (0, import_fs20.createReadStream)(filePath), crlfDelay: Infinity });
+      let done = false;
+      rl.on("line", (line) => {
+        if (done) return;
+        try {
+          const entry = JSON.parse(line);
+          done = true;
+          rl.close();
+          resolve4(entry);
+        } catch {
+        }
+      });
+      rl.on("close", () => {
+        if (!done) resolve4(null);
+      });
+      rl.on("error", () => resolve4(null));
+    });
+  }
   async readCwdFromJsonl(filePath) {
     return new Promise((resolve4) => {
       const rl = (0, import_readline4.createInterface)({ input: (0, import_fs20.createReadStream)(filePath), crlfDelay: Infinity });
@@ -146507,7 +146576,7 @@ var ConversationHandlers = class {
   async findConversationByUuid(uuid3) {
     const lookupId = this.deps.resolveConversationLookupId(uuid3);
     if (!this.scannerManager.ready && !this.scanProfiles) {
-      const filePath2 = this.findJsonlPath(lookupId) ?? this.deps.findLiveSessionFilePath(uuid3) ?? this.deps.findLiveSessionFilePath(lookupId);
+      const filePath2 = await this.locateJsonlPath(uuid3, lookupId);
       if (filePath2) {
         const account = this.cache?.getMetaById(lookupId)?.account ?? void 0;
         const coldScanner = this.scannerManager.current ?? this.scannerManager.newScanner();
@@ -146559,7 +146628,7 @@ var ConversationHandlers = class {
       return fromIndex;
     }
     if (this.scanProfiles) return null;
-    const filePath = this.findJsonlPath(lookupId) ?? this.deps.findLiveSessionFilePath(uuid3) ?? this.deps.findLiveSessionFilePath(lookupId);
+    const filePath = await this.locateJsonlPath(uuid3, lookupId);
     if (!filePath) return null;
     if (this.scannerManager.ready) {
       const account = this.cache?.getMetaById(lookupId)?.account ?? void 0;