@ai-matrx/coding-sessions 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @ai-matrx/coding-sessions
 
+## 0.3.0
+
+- With an owner of the apps' index (`titleHints`), this package reads none of the apps' own files:
+  Codex thread names and title search come from the owner (`appTitles`); the standalone host still
+  reads `session_index.jsonl` itself.
+- `titleStatus()` / `retryTitles()` (engine + bridge): a failing owner shows "app titles unavailable —
+  Retry" beside Your other chats, never a silent fallback. `TitleHints.problem()` / `retry()`.
+- `displayTitle()` (`./sessions`): the list's trim — leading list markers and quotes dropped, cut to
+  `DISPLAY_MAX` (100); the stored title stays exact and is the hover text. Vectors in the one file.
+- A held chat whose own file is gone reads its history from the holder's copy
+  (`homes.claudeVault`, default `~/.claude/claude-app-vault/<id>/transcript.jsonl`).
+- `engine.setHomes()`: a host that learns the homes later (Matrx 2: Codex homes from its core).
+- `TitleHint.source` / `DiscoveredSession.titleSource` may be `"unknown"` (an owner that did not say).
+- **Consumer action:** none for hosts without an owner; Matrx 2 passes `titleHints` with `problem`/`retry`.
+
 ## 0.2.0
 
 - **`./sessions` (new, pure):** the one title rule for a coding chat — `resolveSessionTitle` (override >

package/dist/engine/index.cjs

@@ -1663,6 +1663,7 @@ function codexHome(dir) {
 function defaultProviderHomes(home = import_node_os3.default.homedir()) {
   return {
     claudeProjects: import_node_path5.default.join(home, ".claude", "projects"),
+    claudeVault: import_node_path5.default.join(home, ".claude", "claude-app-vault"),
     codex: [codexHome(import_node_path5.default.join(home, ".codex"))]
   };
 }
@@ -1834,6 +1835,12 @@ async function describeCodex(candidate, names) {
     activeElsewhere: null
   };
 }
+async function codexNames(homes, appTitles) {
+  if (!appTitles) return readCodexIndex(homes.codex.map((h) => h.index));
+  const out = /* @__PURE__ */ new Map();
+  for (const [key, title] of appTitles) if (key.startsWith("codex:")) out.set(key.slice(6), title);
+  return out;
+}
 async function readTail(file, size) {
   const start = Math.max(0, size - TAIL_BYTES);
   return parseJsonl(completeLines(await readSlice(file, start, Math.min(size, TAIL_BYTES)), start > 0));
@@ -1874,7 +1881,7 @@ async function discoverLocalSessions(options = {}) {
   const [claude, codex, names] = await Promise.all([
     claudeCandidates(homes.claudeProjects),
     codexCandidates(homes.codex),
-    readCodexIndex(homes.codex.map((h) => h.index))
+    codexNames(homes, options.appTitles)
   ]);
   const candidates = [...claude, ...codex].sort((a, b) => b.mtimeMs - a.mtimeMs);
   const processes = await listProcesses();
@@ -1896,7 +1903,12 @@ async function findSessionFile(provider, providerSessionId, homes = defaultProvi
   if (!/^[0-9a-f-]{36}$/i.test(providerSessionId)) return null;
   const candidates = provider === "claude" ? await claudeCandidates(homes.claudeProjects) : await codexCandidates(homes.codex);
   const hits = candidates.filter((c) => c.id === providerSessionId).sort((a, b) => b.mtimeMs - a.mtimeMs);
-  return hits[0]?.file ?? null;
+  if (hits[0]) return hits[0].file;
+  if (provider === "claude" && homes.claudeVault) {
+    const copy = import_node_path5.default.join(homes.claudeVault, providerSessionId, "transcript.jsonl");
+    if ((await import_promises4.default.stat(copy).catch(() => null))?.isFile()) return copy;
+  }
+  return null;
 }
 var HISTORY_BUDGET = 24 * 1024 * 1024;
 var MAX_HISTORY_BUDGET = 256 * 1024 * 1024;
@@ -1950,8 +1962,8 @@ async function listSessionFiles(homes = defaultProviderHomes()) {
   ]);
   return [...claude, ...codex].sort((a, b) => b.mtimeMs - a.mtimeMs);
 }
-async function describeSessionFile(candidate, codexNames) {
-  return (candidate.provider === "claude" ? describeClaude(candidate) : describeCodex(candidate, codexNames)).catch(
+async function describeSessionFile(candidate, codexNames2) {
+  return (candidate.provider === "claude" ? describeClaude(candidate) : describeCodex(candidate, codexNames2)).catch(
     () => null
   );
 }
@@ -2146,12 +2158,12 @@ async function searchLocalChats(query, options = {}) {
   const raw = JSON.stringify(needle).slice(1, -1);
   const limit = Math.max(1, Math.min(options.limit ?? 30, 100));
   const deadline = Date.now() + (options.budgetMs ?? 3500);
-  const names = await readCodexIndex(homes.codex.map((h) => h.index));
+  const names = await codexNames(homes, options.appTitles);
   const hits = [];
   let i = cursor;
   for (; i < files.length && hits.length < limit && Date.now() < deadline; i += 1) {
     const candidate = files[i];
-    const named = candidate.provider === "codex" ? names.get(candidate.id) : void 0;
+    const named = options.appTitles?.get(`${candidate.provider}:${candidate.id}`) ?? (candidate.provider === "codex" ? names.get(candidate.id) : void 0);
     const nameHit = named !== void 0 && named.toLowerCase().includes(needle);
     const scanned = nameHit ? null : await scanFile(candidate.provider, candidate.file, needle, raw, deadline);
     if (scanned === TIMED_OUT) {
@@ -2187,19 +2199,35 @@ function titleHintKey(provider, sessionId) {
 }
 function createTitleHintsStore() {
   let hints = null;
+  let problem = null;
   const listeners = /* @__PURE__ */ new Set();
+  const tell = () => {
+    for (const l of listeners) l();
+  };
   return {
     current: () => hints,
+    problem: () => problem,
     subscribe(listener) {
       listeners.add(listener);
       return () => listeners.delete(listener);
     },
     set(next) {
       hints = next;
-      for (const l of listeners) l();
+      problem = null;
+      tell();
+    },
+    setProblem(next) {
+      if (next === problem) return;
+      problem = next;
+      tell();
     }
   };
 }
+function appTitlesOf(hints) {
+  const out = /* @__PURE__ */ new Map();
+  for (const [key, hint] of hints) out.set(key, hint.title);
+  return out;
+}
 
 // src/engine/title-hints.ts
 function overlayHint(chat, hints, expected) {
@@ -2510,7 +2538,7 @@ function describeAuthStatus(provider, probe) {
 async function createCodingSessionsEngine(options = {}) {
   const dataDir = options.dataDir ?? import_node_path9.default.join(import_node_os5.default.homedir(), ".matrx", "coding-sessions");
   const stateDir = import_node_path9.default.join(dataDir, "paperclip-state");
-  const homes = options.homes ?? defaultProviderHomes();
+  let homes = options.homes ?? defaultProviderHomes();
   const index = new RunIndex(dataDir);
   await index.load();
   const preferences = new PreferenceStore(dataDir);
@@ -2592,6 +2620,11 @@ async function createCodingSessionsEngine(options = {}) {
   }
   const titleHints = options.titleHints;
   const hintsNow = () => titleHints?.current() ?? null;
+  const appTitles = () => {
+    if (!titleHints) return void 0;
+    const hints = hintsNow();
+    return hints ? appTitlesOf(hints) : /* @__PURE__ */ new Map();
+  };
   const unsubscribeHints = titleHints?.subscribe(() => emit({ type: "titles" })) ?? null;
   const withHintTitle = (session) => {
     const hint = session.providerSessionId ? hintsNow()?.get(titleHintKey(session.provider, session.providerSessionId)) : void 0;
@@ -3066,7 +3099,7 @@ async function createCodingSessionsEngine(options = {}) {
       );
     },
     async discoverSessions(opts) {
-      const read = await discoverLocalSessions({ limit: opts?.limit, homes, excludePids: ourPids() });
+      const read = await discoverLocalSessions({ limit: opts?.limit, homes, excludePids: ourPids(), appTitles: appTitles() });
       const hints = hintsNow();
       const found = read.map((chat) => overlayHint(chat, hints, titleHints !== void 0));
       if (backups) {
@@ -3104,6 +3137,17 @@ async function createCodingSessionsEngine(options = {}) {
         }))
       );
     },
+    async titleStatus() {
+      if (!titleHints) return { owner: false, pending: false, problem: null };
+      const problem = titleHints.problem?.() ?? null;
+      return { owner: true, pending: hintsNow() === null && problem === null, problem };
+    },
+    async retryTitles() {
+      titleHints?.retry?.();
+    },
+    setHomes(next) {
+      homes = next;
+    },
     async listSessions() {
       return index.sessions().map(withHintTitle);
     },
@@ -3280,7 +3324,7 @@ async function createCodingSessionsEngine(options = {}) {
       return all;
     },
     async searchChats(query, opts) {
-      const result = await searchLocalChats(String(query ?? ""), { homes, cursor: opts?.cursor, limit: opts?.limit });
+      const result = await searchLocalChats(String(query ?? ""), { homes, cursor: opts?.cursor, limit: opts?.limit, appTitles: appTitles() });
       const hints = hintsNow();
       return { ...result, hits: result.hits.map((hit) => ({ ...hit, title: hints?.get(titleHintKey(hit.provider, hit.providerSessionId))?.title ?? hit.title })) };
     },