@volter/supercode-interchange 0.1.14 → 0.1.16

package/discovery.mjs

@@ -3,7 +3,9 @@ import { readLatestCandidates, readFileTopics } from './previews.mjs';
 import { nativeTrim } from './text.mjs';
 
 /** Preview refusal preserves the native metadata row. The owner can retain
- * the exact failed source in diagnostics; it never invents message content. */
+ * the exact failed source in diagnostics; it never invents message content.
+ * A query that shows no message (`include_latest_candidates: false`, with no
+ * topics asked) opens no file: its row is the index's own. */
 export async function enrichDescriptor(query, descriptor, { codexTopics, metrics, previewFailure } = {}) {
   const row = { ...descriptor };
   const take = async (read) => {
@@ -17,7 +19,7 @@ export async function enrichDescriptor(query, descriptor, { codexTopics, metrics
     if (topics.length) row.preview_candidates = topics;
     else delete row.preview_candidates;
   }
-  const latest = await take(() => readLatestCandidates(row.locator, metrics));
+  const latest = query.include_latest_candidates === false ? [] : await take(() => readLatestCandidates(row.locator, metrics));
   if (latest.length) row.latest_message_candidates = latest;
   else delete row.latest_message_candidates;
   return row;
@@ -25,6 +27,8 @@ export async function enrichDescriptor(query, descriptor, { codexTopics, metrics
 
 /** Bounded enrichment belongs to returned/current-window rows. Metadata
  * maintenance never invokes this function, including unchanged warm queries. */
+export const readsPreviews = (query) => query.include_latest_candidates !== false || Boolean(query.include_topic_candidates);
+
 export async function enrichIndexPage(query, rows, options) {
   const result = [];
   for (const row of rows) result.push(await enrichDescriptor(query, row, options));

package/index.d.ts

@@ -29,7 +29,7 @@ export interface DiscoveryQuery {
   workspace?: string | null; workspace_subtree?: boolean; workspace_family?: string | null;
   updated_after_ms?: number | null; updated_before_ms?: number | null;
   query?: string | null; search_previews?: boolean; cursor?: string | null; limit?: number | null;
-  include_topic_candidates?: boolean; include_child_sessions?: boolean;
+  include_topic_candidates?: boolean; include_latest_candidates?: boolean; include_child_sessions?: boolean;
   root_session_id?: string | null; profile?: string | null;
 }
 export interface DiscoveryReceipt {
@@ -110,6 +110,7 @@ export interface DiscoveryEnrichmentOptions extends MetadataProjectionOptions {
   lateClaudeName?: (name: string) => Promise<string | null>;
 }
 export function enrichDescriptor(query: DiscoveryQuery, descriptor: SessionDescriptor, options?: DiscoveryEnrichmentOptions): Promise<SessionDescriptor>;
+export function readsPreviews(query: DiscoveryQuery): boolean;
 export function enrichIndexPage(query: DiscoveryQuery, descriptors: SessionDescriptor[], options?: DiscoveryEnrichmentOptions): Promise<SessionDescriptor[]>;
 export function discoverFromIndex(query: DiscoveryQuery, descriptors: Iterable<SessionDescriptor>, options?: DiscoveryEnrichmentOptions): Promise<DiscoveryPage>;
 export function nativeTrim(value: string): string;

package/index.mjs

@@ -14,7 +14,7 @@ export { readForeignStore } from './foreign-store.mjs';
 export { readHermesStore } from './hermes-store.mjs';
 export { readOrchestratorStore } from './orchestrator-store.mjs';
 export { codexNamesPath, readCodexNames, readCodexHistory, readClaudeTitles } from './native-ledgers.mjs';
-export { enrichDescriptor, enrichIndexPage, discoverFromIndex } from './discovery.mjs';
+export { enrichDescriptor, enrichIndexPage, readsPreviews, discoverFromIndex } from './discovery.mjs';
 export { nativeInteger } from './native-json.mjs';
 export { nativeTrim } from './text.mjs';
 export { RetainedMetadataProjection, filedUnderOwnKey } from './retained-projection.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/supercode-interchange",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "type": "module",
   "description": "Read-only harness metadata, transcript codecs and session projections for Supercode",
   "license": "MIT OR Apache-2.0",

package/session-codex-display.mjs

@@ -15,6 +15,9 @@ export function fromCodexDisplayStr(text, messageLimit) {
   if (!Number.isSafeInteger(messageLimit) || messageLimit < 0) throw new RangeError('invalid Codex display message limit');
   const session = createSession('codex'), { meta, messages } = session, precedingUsers = [], canonicalTexts = new Set();
   const retain = Math.min(Number.MAX_SAFE_INTEGER, Math.max(messageLimit, 1) + 64);
+  // The item ids and event texts the kept messages may hold: a record that names neither replaces nothing and looks
+  // through no message, so a read with no bound on its messages (a display anchor's) is linear in what it reads.
+  const displayItems = new Set(), eventTexts = new Set();
   let paginated = false, recordCount = 0, total = 0;
   for (const line of nonEmptyLines(text)) {
     recordCount++;
@@ -24,12 +27,13 @@ export function fromCodexDisplayStr(text, messageLimit) {
     else if (kind === 'event_msg' && paginated && type === 'item_completed') {
       const item = field(payload, 'item'), id = stringField(item, 'id');
       if (id != null) {
-        const position = messages.findIndex((message) => message.metadata.codex_display_item === id), projected = [];
+        const held = displayItems.has(id), position = held ? messages.findIndex((message) => message.metadata.codex_display_item === id) : -1, projected = [];
         pushCodexDisplayItem(item, projected);
         for (const message of projected) message.metadata.codex_display_item = id;
+        if (projected.length) displayItems.add(id);
         stampCodexMessages(projected, 0, timestamp);
         let removed = 0;
-        for (let index = messages.length - 1; index >= 0; index--) if (messages[index].metadata.codex_display_item === id) { messages.splice(index, 1); removed++; }
+        if (held) for (let index = messages.length - 1; index >= 0; index--) if (messages[index].metadata.codex_display_item === id) { messages.splice(index, 1); removed++; }
         total = Math.max(0, total - removed) + projected.length;
         const at = Math.min(position === -1 ? messages.length : position, messages.length);
         for (let index = 0; index < projected.length; index++) messages.splice(at + index, 0, projected[index]);
@@ -47,7 +51,7 @@ export function fromCodexDisplayStr(text, messageLimit) {
       const isAssistant = type === 'message' && stringField(payload, 'role') === 'assistant';
       const assistantText = isAssistant ? extractTextContent(payload, 'content') : null;
       if (assistantText != null && nativeTrim(assistantText) !== '') {
-        const duplicate = messages.findLastIndex((message) => Object.hasOwn(message.metadata, 'codex_event_message') && message.content === assistantText);
+        const duplicate = eventTexts.has(assistantText) ? messages.findLastIndex((message) => Object.hasOwn(message.metadata, 'codex_event_message') && message.content === assistantText) : -1;
         if (duplicate !== -1) { messages.splice(duplicate, 1); total = Math.max(0, total - 1); }
         canonicalTexts.add(nativeTrim(assistantText));
       }
@@ -62,7 +66,7 @@ export function fromCodexDisplayStr(text, messageLimit) {
       const text = extractTextContent(payload, 'message');
       if (nativeTrim(text) !== '' && !canonicalTexts.has(nativeTrim(text))) {
         const before = messages.length; pushCodexAssistant(messages, text); total++;
-        messages.at(-1).metadata.codex_event_message = 'true';
+        messages.at(-1).metadata.codex_event_message = 'true'; eventTexts.add(messages.at(-1).content);
         const phase = stringField(payload, 'phase'); if (phase != null) messages.at(-1).metadata.phase = phase;
         stampCodexMessages(messages, before, timestamp);
       }