@volter/supercode-interchange 0.1.14 → 0.1.15

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.15",
   "type": "module",
   "description": "Read-only harness metadata, transcript codecs and session projections for Supercode",
   "license": "MIT OR Apache-2.0",