dsh-reference-anything 0.4.0 → 0.4.1

package/README.md

@@ -70,18 +70,16 @@ Type `@`, search across enabled sources, and insert the selected reference into
 
 **The External conversations group** — and only that group — uses OpenCLI to reach AI chat sessions you are already logged into. By default it stores conversation titles locally and the agent fetches remote content on demand; an optional offline-mirror mode stores the latest complete bodies locally instead. **Local agent conversations need none of that**: those transcripts are already files on your own disk, so that group reads them directly, with no browser, no OpenCLI, and nothing mirrored.
 
-> [!IMPORTANT]
-> v0.4.0 targets DSH `>=0.1.2-rc.1` and uses the RC1 Skills Remote, Session snapshot API, native `@` trigger menu, official file/session Remotes, and native Composer reference rendering. It is incompatible with DSH versions older than `0.1.2-rc.1`.
-> The `0.3.x` line remains on the current stable DSH SDK (`0.1.0-rc.8 ~ 0.1.1-rc.2`). Due to breaking changes, starting with version `v0.4.0`, development releases will target DSH `v0.1.2-rc.1` or newer, use the npm `alpha` tag, and no longer support older DSH releases.
-
 > [!NOTE]
 > DSH is currently in Beta, so its underlying capabilities and interfaces may change as it evolves. This plugin will adapt alongside those changes. Because of some current DSH limitations, parts of the implementation may not yet be ideal; we will continue to follow DSH updates and improve the plugin over time. See the relevant sections below for specific limitations and usage notes.
 
 ## 📰 News
 
+- **2026-09-25 · v0.4.1** — We're back!!🎉🎉 Improved local-agent session titles by reading Codex's own `session_index.jsonl` and added Pi/Codex title support. Restored the native DSH handling for `@` menu group headings to avoid translucent overlap and unnecessary custom blur rendering; bounded index reads to 16 MiB for predictable resource use.
+
 - **2026-09-03 · v0.4.0** — **Compatibility: DSH `>=0.1.2-rc.1`.** Migrated Skills discovery to the DSH RC1 Skills Remote, restored historical reference grants through the RC1 Session snapshot API, and verified the plugin against DSH `0.1.2-rc.1`.
 
-- **2026-08-28 · v0.3.3** — Improved dark-theme backgrounds for the reference menu and settings panels, added project screenshot metadata, and refreshed the documentation. This is the final release line targeting the current stable DeepSeek Harness SDK; the next development release, `v0.4.0`, will migrate to DeepSeek Harness `v0.1.2-rc.1` under the npm `alpha` tag and will not support older DSH releases.
+- **2026-08-28 · v0.3.3** — Improved dark-theme backgrounds for the reference menu and settings panels, added project screenshot metadata, and refreshed the documentation. This was the final release line targeting the current stable DeepSeek Harness SDK; `v0.4.0` migrated to DeepSeek Harness `v0.1.2-rc.1` under the npm `alpha` tag and does not support older DSH releases.
 - **2026-08-25 · v0.3.2** — Added local-agent conversation references, with detected session counts and custom-folder support. Web AI sync can be age-limited; cloud drives now support folder browsing and quick download-folder access. Settings include update notes, and local-agent tool details stay concise unless expanded.
 - **2026-08-20 · v0.3.0** — Completed the native DSH `@` integration: five independently configurable sources, official file/session Remotes, native Composer references with source logos, in-place expand/collapse and sync actions, and a one-click switch between Reference Anything and the official DSH `@` list. The legacy `dsh-file:` protocol and custom Composer interaction layer were removed.
 
@@ -110,7 +108,7 @@ Install the stable `0.3.x` line for the current stable DSH SDK:
 dsh plugin --profile web add dsh-reference-anything@latest
 ```
 
-Install `v0.4.0` on DSH `>=0.1.2-rc.1`:
+Install `v0.4.1` on DSH `>=0.1.2-rc.1`:
 
 ```powershell
 dsh plugin --profile web add dsh-reference-anything@alpha

package/lib/client.js

@@ -29617,8 +29617,6 @@ var css = `
      caret, selection, wrapping, and message geometry. */
 [data-composer-card] [role="listbox"]:has([role="presentation"][data-source]){box-sizing:border-box!important;width:100%!important;min-width:0!important;max-width:100%!important}
 [data-trigger-menu]:has(> [role="listbox"] [role="presentation"][data-source]){border-radius:22px}
-[data-composer-card] [role="listbox"] [role="presentation"][data-source]{position:sticky;top:0;z-index:2;box-sizing:border-box;padding-top:6px!important;background:var(--dsw-specific-menu,var(--dsw-alias-background-primary,var(--dsw-alias-bg-layer-1,#fff)))}
-[data-composer-card] [role="listbox"] [role="presentation"][data-source]:not(:first-child){margin-top:8px}
 [data-composer-card] [role="listbox"] [role="option"]{scroll-margin-block-start:30px;scroll-margin-block-end:4px}
 [data-composer-card] [role="listbox"]>[data-dsh-ref-menu-settling]{overflow-anchor:none!important}
 [data-composer-card] [role="listbox"]>[data-dsh-ref-menu-settling] [role="option"][aria-selected="false"]:hover{background:transparent!important}

package/lib/sources/local-agent/adapters/pi.js

@@ -82,9 +82,11 @@ export const piAdapter = {
                 createdAt ??= parseTimestamp(record['timestamp']);
                 continue;
             }
-            // A rename writes another `session_info`, so the newest one wins.
-            if (record['type'] === 'session_info')
-                named = stringField(record, 'name') ?? named;
+            // A rename writes another `session_info`, so the newest one wins. Some
+            // Pi-compatible writers call the same field `title`.
+            if (record['type'] === 'session_info') {
+                named = stringField(record, 'name') ?? stringField(record, 'title') ?? named;
+            }
         }
         for (const line of headLines) {
             const record = parseRecord(line);

package/lib/sources/local-agent/index.js

@@ -643,7 +643,9 @@ function foldsToNothing(adapter, lines, options) {
     return adapter.flush(state, options).length === 0;
 }
 function labelFor(descriptor, bookmark) {
-    const title = bookmark?.title.trim() ?? '';
+    // Some file-backed agents expose a title index beside the transcript. It is
+    // fresher than a persisted first-prompt bookmark and must win when present.
+    const title = descriptor.title?.trim() || bookmark?.title.trim() || '';
     return title === '' ? basename(descriptor.relPath) : title;
 }
 /** The schema's own defaults, as a plain object. */

package/lib/sources/local-agent/scan.d.ts

@@ -40,6 +40,15 @@ export interface TranscriptDescriptor {
     readonly relPath: string;
     readonly mtimeMs: number;
     readonly size: number;
+    /**
+     * A title supplied by an index beside a file-backed transcript.
+     *
+     * Codex keeps its user-facing session title in `~/.codex/session_index.jsonl`,
+     * while the rollout itself only contains the opening prompt. This value is
+     * kept on the descriptor so a fresh index title can override an older
+     * first-prompt bookmark without changing the transcript adapter contract.
+     */
+    readonly title?: string;
     /**
      * The session row, for a database-backed format only.
      *

package/lib/sources/local-agent/scan.js

@@ -17,8 +17,8 @@
  * @module dsh-reference-anything/local-agent/scan
  */
 import { createReadStream } from 'node:fs';
-import { open, readdir, stat } from 'node:fs/promises';
-import { join, relative } from 'node:path';
+import { open, readdir, readFile, stat } from 'node:fs/promises';
+import { basename, join, relative, resolve } from 'node:path';
 import { ReferenceAnythingError } from "../../errors.js";
 import { withDatabase } from "./sqlite.js";
 import { isQueryAdapter } from "./types.js";
@@ -26,6 +26,7 @@ import { isQueryAdapter } from "./types.js";
 export const SESSION_SEPARATOR = '#';
 /** Directory depth walked below each root. */
 const MAX_DEPTH = 6;
+const MAX_CODEX_TITLE_INDEX_BYTES = 16 * 1024 * 1024;
 /** Probe windows, in bytes, tried in order until enough lines are recovered. */
 const PROBE_STEPS = [32 * 1024, 256 * 1024, 2 * 1024 * 1024];
 /** Chunk size for walking a large transcript backwards from its end. */
@@ -48,12 +49,15 @@ export async function listTranscripts(roots, adapters, maxTranscripts, signal) {
         const adapter = adapters.get(root.kind);
         if (adapter === undefined)
             continue;
-        await walk(root, root.path, 0, adapter, found, signal, maxTranscripts);
+        const titles = root.kind === 'codex' && !isQueryAdapter(adapter)
+            ? await readCodexTitleIndex(root.path)
+            : undefined;
+        await walk(root, root.path, 0, adapter, found, signal, maxTranscripts, titles);
     }
     found.sort((left, right) => right.mtimeMs - left.mtimeMs);
     return found.slice(0, maxTranscripts);
 }
-async function walk(root, dir, depth, adapter, found, signal, maxSessions = 200) {
+async function walk(root, dir, depth, adapter, found, signal, maxSessions = 200, titles) {
     signal?.throwIfAborted();
     if (depth > MAX_DEPTH)
         return;
@@ -63,7 +67,7 @@ async function walk(root, dir, depth, adapter, found, signal, maxSessions = 200)
     for (const entry of entries) {
         const path = join(dir, entry.name);
         if (entry.isDirectory()) {
-            await walk(root, path, depth + 1, adapter, found, signal, maxSessions);
+            await walk(root, path, depth + 1, adapter, found, signal, maxSessions, titles);
             continue;
         }
         if (!entry.isFile())
@@ -78,9 +82,71 @@ async function walk(root, dir, depth, adapter, found, signal, maxSessions = 200)
             found.push(...await expandSessions(root.kind, path, relPath, stats.mtimeMs, stats.size, adapter, maxSessions));
             continue;
         }
-        found.push({ kind: root.kind, path, relPath, mtimeMs: stats.mtimeMs, size: stats.size });
+        found.push({
+            kind: root.kind,
+            path,
+            relPath,
+            mtimeMs: stats.mtimeMs,
+            size: stats.size,
+            ...titles === undefined ? {} : titleForCodexPath(path, titles),
+        });
     }
 }
+/** Read the Codex title index once per configured sessions root. */
+async function readCodexTitleIndex(sessionsRoot) {
+    const indexPath = resolve(sessionsRoot, '..', 'session_index.jsonl');
+    const indexStats = await stat(indexPath).catch(() => undefined);
+    // Keep discovery bounded; an unexpectedly large index must not turn a
+    // keystroke-triggered scan into an unbounded allocation.
+    if (indexStats === undefined || indexStats.size > MAX_CODEX_TITLE_INDEX_BYTES)
+        return undefined;
+    const raw = await readFile(indexPath, 'utf8').catch(() => undefined);
+    if (raw === undefined)
+        return undefined;
+    const byPath = new Map();
+    const bySessionId = new Map();
+    for (const line of raw.split(/\r?\n/u)) {
+        if (line.trim() === '')
+            continue;
+        let record;
+        try {
+            record = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (typeof record !== 'object' || record === null)
+            continue;
+        const row = record;
+        const title = typeof row['thread_name'] === 'string' ? row['thread_name'].trim() : '';
+        if (title === '')
+            continue;
+        const id = typeof row['id'] === 'string' ? row['id'].trim() : '';
+        if (id !== '')
+            bySessionId.set(id, title);
+        const rolloutPath = typeof row['rollout_path'] === 'string' ? row['rollout_path'].trim() : '';
+        if (rolloutPath !== '')
+            byPath.set(normalizeIndexedPath(rolloutPath), title);
+    }
+    return { byPath, bySessionId };
+}
+function titleForCodexPath(path, index) {
+    const direct = index.byPath.get(normalizeIndexedPath(path));
+    if (direct !== undefined)
+        return { title: direct };
+    const match = basename(path).match(/-([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})(?:_[^.]*)?\.jsonl$/iu);
+    const sessionId = match?.[1];
+    const title = sessionId === undefined ? undefined : index.bySessionId.get(sessionId);
+    return title === undefined ? {} : { title };
+}
+/** Normalize Windows paths from the index and from the active filesystem. */
+function normalizeIndexedPath(path) {
+    return path
+        .replace(/^\\\\\?\\/u, '')
+        .replace(/[\\/]+/gu, '\\')
+        .replace(/\\$/u, '')
+        .toLocaleLowerCase();
+}
 /**
  * Turn one database into a descriptor per conversation inside it.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-reference-anything",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Reference commands, skills, workspace files, DSH sessions, local agent transcripts, cloud-drive files, and mirrored web-chat conversations from one DeepSeek Harness @ menu",
   "license": "MIT",
   "publishConfig": {