dsh-reference-anything 0.4.0 → 0.4.2

package/README.md

@@ -70,18 +70,18 @@ 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-28 · v0.4.2 — Important update** — Fixed a fatal plugin compatibility error with the current DSH interface. During plugin loading, DSH now requires every strict `agentSearch` registration codec to provide a `create()` validator factory; v0.4.1 supplied only validation rules, so DSH rejected the plugin before search could run. This release adds the required factory and fixes command icon sizing plus bilingual command labels in the native picker.
+
+- **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 +110,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.2` on DSH `>=0.1.2-rc.1`:
 
 ```powershell
 dsh plugin --profile web add dsh-reference-anything@alpha

package/lib/client.js

@@ -14989,7 +14989,7 @@ var agentLookup = {
   wire: "agentId",
   source: "lookup",
   lookup: "agent",
-  codec: { mode: "strict", typeSymbol: "@deepseek-ai/dsh-session/types#SessionId", schema: external_exports.string().min(1) }
+  codec: { mode: "strict", typeSymbol: "@deepseek-ai/dsh-session/types#SessionId", schema: external_exports.string().min(1), create: () => external_exports.string().min(1) }
 };
 var searchInputSchema = external_exports.object({
   query: external_exports.string(),
@@ -15198,7 +15198,7 @@ var REFERENCE_ANYTHING_INVOCATIONS = [
   descriptor("openListReindex", [{ name: "input", wire: "input", source: "json", codec: strict("OpenListMountInput", openListMountInputSchema) }], strict("OpenListReindex", external_exports.object({ supported: external_exports.boolean(), reason: external_exports.string().optional() }).readonly()), true)
 ];
 function strict(type, schema) {
-  return { mode: "strict", typeSymbol: `dsh-reference-anything#${type}`, schema };
+  return { mode: "strict", typeSymbol: `dsh-reference-anything#${type}`, schema, create: () => schema };
 }
 function descriptor(method, parameters, result, cancelled = false) {
   return {
@@ -16883,7 +16883,13 @@ var PICKER_ICON_MARKER = {
   font: "\uE114",
   refresh: "\uE115",
   agent: "\uE116",
-  drive: "\uE117"
+  drive: "\uE117",
+  goal: "\uE125",
+  plan: "\uE126",
+  feedback: "\uE127",
+  compact: "\uE128",
+  permission: "\uE129",
+  export: "\uE12A"
 };
 var SESSION_ICON_MARKER = PICKER_ICON_MARKER.session;
 var SKILL_ICON_MARKER = PICKER_ICON_MARKER.skill;
@@ -16937,6 +16943,25 @@ var PICKER_ICON_NODES = {
     { tag: "path", attrs: { d: "M3 12a9 9 0 0 0 9 9 9.75 9.75 0 0 0 6.74-2.74L21 16" } },
     { tag: "path", attrs: { d: "M16 16h5v5" } }
   ],
+  goal: [
+    { tag: "path", attrs: { d: "M14.5001 8C14.5 9.28552 14.1188 10.5422 13.4045 11.611C12.6903 12.6799 11.6752 13.5129 10.4875 14.0049C9.29982 14.4968 7.99295 14.6255 6.73212 14.3747C5.4713 14.124 4.31314 13.505 3.4041 12.596C2.49514 11.687 1.87614 10.5288 1.62537 9.26798C1.37459 8.00716 1.50331 6.70028 1.99525 5.51261C2.48719 4.32494 3.32025 3.30981 4.3891 2.59557C5.45795 1.88134 6.71458 1.50008 8.0001 1.5" } },
+    { tag: "path", attrs: { d: "M11.5 8C11.5001 8.69227 11.2948 9.36901 10.9102 9.94463C10.5257 10.5202 9.97901 10.9689 9.33944 11.2338C8.69986 11.4987 7.99609 11.5681 7.31712 11.433C6.63816 11.2979 6.01449 10.9645 5.52501 10.475C5.03548 9.98552 4.70209 9.36185 4.56702 8.68289C4.43195 8.00392 4.50127 7.30015 4.76619 6.66057C5.03112 6.021 5.47976 5.47436 6.05538 5.08978C6.631 4.70519 7.30774 4.49995 8.00001 4.5" } },
+    { tag: "path", attrs: { d: "M8.00024 7.99976L11.2 4.80005" } }
+  ],
+  feedback: [{ tag: "path", attrs: { d: "M4.74024 9.11029L1.82882 7.79865L12.9665 2.60943L12.3914 13.1388L6.12677 9.83657M8.44336 11.0825L6.2832 13.2843V9.86772L12.972 2.78748" } }],
+  plan: [
+    { tag: "path", attrs: { d: "M4.9375 5.90295H11.0625" } },
+    { tag: "path", attrs: { d: "M4.9375 9.02991H8.27841" } },
+    { tag: "path", attrs: { d: "M12.5 1.32617C13.3039 1.32617 14 1.95171 14 2.77637V7.61328L13 8.68164V2.77637C13 2.55186 12.8007 2.32617 12.5 2.32617H3.5C3.1993 2.32617 3 2.55186 3 2.77637V13.2246C3.00044 13.4489 3.19963 13.6738 3.5 13.6738H8.32812L7.39258 14.6738H3.5C2.69637 14.6738 2.00042 14.0489 2 13.2246V2.77637C2 1.95171 2.69613 1.32617 3.5 1.32617H12.5Z" } },
+    { tag: "path", attrs: { d: "M8.97212 14.3693C9.17511 14.5723 9.37811 14.7753 9.5811 14.9783C9.67012 14.8953 9.75914 14.8123 9.84815 14.7293C11.4505 13.2352 13.0528 11.7411 14.6551 10.247C14.7441 10.164 14.8331 10.081 14.9221 9.99803C14.5989 9.6748 14.2756 9.35157 13.9524 9.02834C13.8694 9.11736 13.7864 9.20637 13.7034 9.29539C12.2093 10.8977 10.7152 12.5 9.22113 14.1023C9.13813 14.1913 9.05513 14.2803 8.97212 14.3693Z" } }
+  ],
+  permission: [
+    { tag: "path", attrs: { d: "M6.59624 2.14853C7.50155 1.80917 8.49914 1.80919 9.40444 2.14859L13.9245 3.84317V7.11961C13.9245 11.6089 10.5565 13.5975 8.00035 14.5779C5.44423 13.5975 2.07544 11.6089 2.07544 7.11961V3.84317L6.59624 2.14853Z" } },
+    { tag: "path", attrs: { d: "M8 4.39209V9.89209" } },
+    { tag: "path", attrs: { d: "M8 10.8081V11.8081" } }
+  ],
+  compact: [{ tag: "circle", attrs: { cx: "8", cy: "8", r: "6.5" } }, { tag: "path", attrs: { d: "M8 1.5A6.5 6.5 0 0 1 14.5 8" } }],
+  export: [{ tag: "path", attrs: { d: "M8 1.95317V10.0469M4.25 6.29688L8 10.0469L11.75 6.29688M1.5 10.0469V13.158C1.5 13.3937 1.60536 13.6198 1.79289 13.7865C1.98043 13.9532 2.23478 14.0469 2.5 14.0469H13.5C13.7652 14.0469 14.0198 13.9532 14.2071 13.7865C14.3946 13.6198 14.5 13.3937 14.5 13.158V10.0469" } }],
   // FolderClosed
   folder: [
     { tag: "path", attrs: { d: "M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z" } },
@@ -17667,6 +17692,48 @@ function decodeDriveReference(value) {
 function formatDriveMention(reference) {
   return `@[${escapeLabel(reference.label)}](${driveReferenceUri(reference.id)})`;
 }
+var COMMAND_ICON_KIND = {
+  goal: "goal",
+  plan: "plan",
+  feedback: "feedback",
+  compact: "compact",
+  permission: "permission",
+  export: "export"
+};
+var COMMAND_DESCRIPTION_EN = {
+  goal: "Set or view the goal for a long-running task",
+  plan: "Enter or leave plan mode",
+  feedback: "Record feedback about this session",
+  compact: "Compact older conversation history",
+  permission: "Switch the permission preset (sandbox mode + approval policy)",
+  export: "Download this Session log as a ZIP archive"
+};
+var COMMAND_DESCRIPTION_ZH = {
+  goal: "\u8BBE\u7F6E\u6216\u67E5\u770B\u957F\u671F\u4EFB\u52A1\u76EE\u6807",
+  plan: "\u8FDB\u5165\u6216\u9000\u51FA\u8BA1\u5212\u6A21\u5F0F",
+  feedback: "\u53D1\u9001\u5173\u4E8E\u5F53\u524D\u4F1A\u8BDD\u7684\u53CD\u9988",
+  compact: "\u538B\u7F29\u4EE5\u4E0A\u5BF9\u8BDD\u5185\u5BB9",
+  permission: "\u5207\u6362\u6743\u9650\u9884\u8BBE\uFF08\u6C99\u7BB1\u6A21\u5F0F\u4E0E\u5BA1\u6279\u7B56\u7565\uFF09",
+  export: "\u5C06\u5F53\u524D\u4F1A\u8BDD\u5185\u5BB9\u5BFC\u51FA\u4E3A ZIP"
+};
+var COMMAND_LABEL_EN = {
+  goal: "Goal",
+  plan: "Plan",
+  feedback: "Feedback",
+  compact: "Compact",
+  permission: "Permission",
+  export: "Export",
+  model: "Model"
+};
+var COMMAND_LABEL_ZH = {
+  goal: "\u76EE\u6807",
+  plan: "\u8BA1\u5212",
+  feedback: "\u53CD\u9988",
+  compact: "\u538B\u7F29",
+  permission: "\u6743\u9650",
+  export: "\u4E0B\u8F7D\u65E5\u5FD7",
+  model: "\u6A21\u578B"
+};
 function createCommandSource(load, t = fallback, options = { ...DEFAULT_SOURCE_OPTIONS, order: 0 }) {
   const source = {
     trigger: "@",
@@ -17676,13 +17743,19 @@ function createCommandSource(load, t = fallback, options = { ...DEFAULT_SOURCE_O
       const scoped = scopedQuery(query, "commands");
       if (scoped === void 0) return [];
       const needle = scoped.toLocaleLowerCase();
-      return (await load(session.sessionId, signal)).filter((row) => row.name.toLocaleLowerCase().includes(needle)).map((row) => ({
-        name: row.name,
-        description: row.description,
-        hint: row.input?.hint,
-        icon: COMMAND_ICON_MARKER,
-        value: encodeCandidate({ kind: "command", name: row.name })
-      }));
+      return (await load(session.sessionId, signal)).filter((row) => row.name.toLocaleLowerCase().includes(needle)).map((row) => {
+        return {
+          name: (() => {
+            const key = row.name.toLocaleLowerCase();
+            const zh2 = navigator.language.toLowerCase().startsWith("zh");
+            return zh2 ? `${COMMAND_LABEL_ZH[key] ?? row.name} ${row.name}` : COMMAND_LABEL_EN[key] ?? row.name;
+          })(),
+          description: (navigator.language.toLowerCase().startsWith("zh") ? COMMAND_DESCRIPTION_ZH[row.name.toLocaleLowerCase()] : COMMAND_DESCRIPTION_EN[row.name.toLocaleLowerCase()]) ?? row.description,
+          hint: row.input?.hint,
+          icon: PICKER_ICON_MARKER[COMMAND_ICON_KIND[row.name.toLocaleLowerCase()] ?? "command"],
+          value: encodeCandidate({ kind: "command", name: row.name })
+        };
+      });
     },
     onPick({ candidate }) {
       const value = decodeCandidate(candidate.value);
@@ -29617,16 +29690,17 @@ 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}
 [data-composer-card] [role="listbox"] [role="option"][data-dsh-ref-menu-action]{color:var(--dsw-alias-label-tertiary,#737780)!important}
 [data-composer-card] [role="listbox"] [role="option"][data-dsh-ref-menu-action]>span:last-child:not(:first-child){display:none!important}
 [data-composer-card] [role="listbox"] .dsh_ref_projected_icon,[data-composer-card] [role="listbox"] .dsh_ref_picker_icon{display:inline-flex!important;align-items:center!important;justify-content:center!important;flex:none;width:16px!important;height:16px!important;line-height:1!important;color:var(--dsw-alias-label-secondary,#5f636b)}
+[data-composer-card] [role="listbox"] .dsh_ref_command_icon{width:18px!important;height:18px!important}
+[data-composer-card] [role="listbox"] .dsh_ref_command_icon>svg{width:18px!important;height:18px!important}
 [data-composer-card] [role="listbox"] .dsh_ref_dual_icon{width:36px!important;gap:4px}
 [data-composer-card] [role="listbox"] :is(.dsh_ref_projected_icon,.dsh_ref_picker_icon)>svg{display:block;width:16px;height:16px;overflow:visible}
+[data-composer-card] [role="listbox"] .dsh_ref_command_icon,[data-composer-card] [role="listbox"] .dsh_ref_command_icon>svg{width:18px!important;height:18px!important}
 [data-composer-card] [data-decoration="chip"][data-dsh-ref-chip-icon]>:first-child>svg{visibility:hidden!important}
 [data-composer-card] [data-decoration="chip"][data-dsh-ref-chip-icon]>:first-child:after{content:"";position:absolute;top:50%;left:50%;display:block;width:16px;height:16px;transform:translate(-50%,-50%);background:currentColor;-webkit-mask:var(--dsh-ref-chip-icon-mask) center/contain no-repeat;mask:var(--dsh-ref-chip-icon-mask) center/contain no-repeat;pointer-events:none}
 [data-composer-card] [data-composer-chip][data-dsh-ref-chip-icon]>:first-child>svg{background:currentColor;-webkit-mask:var(--dsh-ref-chip-icon-mask) center/contain no-repeat;mask:var(--dsh-ref-chip-icon-mask) center/contain no-repeat}
@@ -29971,6 +30045,7 @@ function adoptReferenceIconProjection() {
     node2.replaceChildren(createPickerIcon(kind), ...secondary === void 0 ? [] : [createPickerIcon(secondary)]);
     node2.classList.remove("dsh_ref_projected_icon");
     node2.classList.add("dsh_ref_picker_icon");
+    node2.classList.toggle("dsh_ref_command_icon", ["goal", "plan", "feedback", "compact", "permission", "export"].includes(kind));
     node2.classList.toggle("dsh_ref_dual_icon", secondary !== void 0);
     node2.dataset.dshRefMenuIcon = kind;
   };
@@ -29996,7 +30071,10 @@ function adoptReferenceIconProjection() {
     const source = heading2?.getAttribute("data-source");
     const name2 = option.children.item(1)?.textContent?.trim() ?? "";
     const description = option.children.item(2)?.textContent?.trim() ?? "";
-    if (source === "Commands") return paintPicker(icon, "command");
+    if (source === "Commands") {
+      const commandIcons = { goal: "goal", plan: "plan", feedback: "feedback", compact: "compact", permission: "permission", export: "export" };
+      return paintPicker(icon, commandIcons[name2.toLocaleLowerCase()] ?? "command");
+    }
     if (source === "Skills") return paintPicker(icon, "skill");
     if (source === "Files and folders") return paintPicker(icon, workspacePathIconKind(name2, name2.endsWith("/") ? "directory" : "file"));
     if (source === "DSH sessions") return paintPicker(icon, "session");

package/lib/contract.js

@@ -25,7 +25,7 @@ export const driveCandidateSchema = z.object({
  * lookup back to DSH's native Remotes and removed its last other caller.
  */
 const agentLookup = { name: 'agent', wire: 'agentId', source: 'lookup', lookup: 'agent',
-    codec: { mode: 'strict', typeSymbol: '@deepseek-ai/dsh-session/types#SessionId', schema: z.string().min(1) } };
+    codec: { mode: 'strict', typeSymbol: '@deepseek-ai/dsh-session/types#SessionId', schema: z.string().min(1), create: () => z.string().min(1) } };
 export const searchInputSchema = z.object({
     query: z.string(), provider: providerSchema.optional(), limit: z.number().int().min(1).max(100),
 }).readonly();
@@ -159,7 +159,7 @@ export const REFERENCE_ANYTHING_INVOCATIONS = [
     descriptor('openListReindex', [{ name: 'input', wire: 'input', source: 'json', codec: strict('OpenListMountInput', openListMountInputSchema) }], strict('OpenListReindex', z.object({ supported: z.boolean(), reason: z.string().optional() }).readonly()), true),
 ];
 function strict(type, schema) {
-    return { mode: 'strict', typeSymbol: `dsh-reference-anything#${type}`, schema };
+    return { mode: 'strict', typeSymbol: `dsh-reference-anything#${type}`, schema, create: () => schema };
 }
 function descriptor(method, parameters, result, cancelled = false) {
     return {

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.2",
   "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": {