@gmickel/gno 2.10.1 → 2.12.0

package/src/sdk/client.ts

@@ -78,6 +78,7 @@ import {
   refreshContextFile,
 } from "../app/compiled-context-files";
 import {
+  decorateResultUris,
   decorateUriForIndex,
   DEFAULT_INDEX_NAME,
   getIndexDbPath,
@@ -140,6 +141,7 @@ import {
   type MemoryErrorCode,
   MemoryService,
 } from "../core/memory";
+import { readMetadataSummary } from "../core/metadata-discovery";
 import { resolveNoteCreatePlan } from "../core/note-creation";
 import { resolveNotePreset } from "../core/note-presets";
 import {
@@ -187,6 +189,7 @@ import {
   withContentTypeRules,
 } from "../ingestion";
 import { updateFrontmatterTags } from "../ingestion/frontmatter";
+import { withCollectionRootErrors } from "../ingestion/source-availability/root";
 import {
   withInferenceScope,
   finishInferenceCleanup,
@@ -208,7 +211,10 @@ import { runAutomationProfile } from "../sessions/automation";
 import { assertSessionBinding } from "../sessions/binding";
 import { SessionsService } from "../sessions/service";
 import { SESSIONS_VALIDATION_CODES, SessionsError } from "../sessions/types";
-import { SqliteAdapter } from "../store/sqlite/adapter";
+import {
+  SqliteAdapter,
+  staleCollectionsMessage,
+} from "../store/sqlite/adapter";
 import { openScopedIndexStore } from "../store/sqlite/scoped-index";
 import { createVectorIndexPort } from "../store/vector";
 import {
@@ -460,6 +466,14 @@ class GnoClientImpl implements GnoClient {
     if (!this.isOpen()) {
       throw sdkError("RUNTIME", "GNO client is closed");
     }
+    // Another client may have indexed a collection this config omits since
+    // this one opened; never read it.
+    const stale = this.store.staleIndexedCollections(
+      this.config.collections.map(({ name }) => name)
+    );
+    if (stale.length > 0) {
+      throw sdkError("RUNTIME", staleCollectionsMessage(stale));
+    }
   }
 
   private getCollections(collection?: string) {
@@ -701,10 +715,9 @@ class GnoClientImpl implements GnoClient {
   private decorateSearchResults(results: SearchResults): SearchResults {
     return {
       ...results,
-      results: results.results.map((result) => ({
-        ...result,
-        uri: decorateUriForIndex(result.uri, this.indexName),
-      })),
+      results: results.results.map((result) =>
+        decorateResultUris(result, this.indexName)
+      ),
     };
   }
 
@@ -1415,6 +1428,14 @@ class GnoClientImpl implements GnoClient {
       const decorated = {
         ...result,
         uri: decorateUriForIndex(result.uri, scoped.indexName),
+        ...(result.supersededBy
+          ? {
+              supersededBy: decorateUriForIndex(
+                result.supersededBy,
+                scoped.indexName
+              ),
+            }
+          : {}),
       };
       const traceMetadata = getRetrievalTraceMetadata(result);
       if (traceMetadata) {
@@ -1458,6 +1479,14 @@ class GnoClientImpl implements GnoClient {
         documents: result.documents.map((doc) => ({
           ...doc,
           uri: decorateUriForIndex(doc.uri, scoped.indexName),
+          ...(doc.supersededBy
+            ? {
+                supersededBy: decorateUriForIndex(
+                  doc.supersededBy,
+                  scoped.indexName
+                ),
+              }
+            : {}),
         })),
       };
     } finally {
@@ -1477,6 +1506,17 @@ class GnoClientImpl implements GnoClient {
     };
   }
 
+  async listMetadata(options: { collection?: string; values?: number } = {}) {
+    this.assertOpen();
+    try {
+      return await readMetadataSummary(this.store, options);
+    } catch (cause) {
+      if (cause instanceof RangeError)
+        throw sdkError("VALIDATION", cause.message);
+      throw cause;
+    }
+  }
+
   async changes(
     options: ListKnowledgeChangesInput = {}
   ): Promise<KnowledgeChangesResult> {
@@ -1513,7 +1553,7 @@ class GnoClientImpl implements GnoClient {
       })
     );
     return {
-      ...status,
+      ...(await withCollectionRootErrors(status, this.config.collections)),
       contentTypeBoost: buildContentTypeBoostStatus(
         this.config.contentTypes ?? []
       ),

package/src/sdk/documents.ts

@@ -30,6 +30,7 @@ import {
   evidenceFromExactDocument,
   RetrievalTraceSession,
 } from "../core/retrieval-trace-session";
+import { supersedingUri } from "../pipeline/result-context";
 import { sdkError } from "./errors";
 
 const URI_PREFIX_PATTERN = /^gno:\/\/[^/]+\//;
@@ -177,6 +178,8 @@ export async function getDocumentByRef(
   options: GnoGetOptions = {}
 ): Promise<GetResponse> {
   const response = await getDocumentByRefUntraced(store, config, ref, options);
+  const successor = await supersedingUri(store, response.uri);
+  if (successor) response.supersededBy = successor;
   if (!options.traceId) return response;
   const resumed = await RetrievalTraceSession.resume({
     store,
@@ -325,7 +328,9 @@ export async function multiGetDocuments(
     );
     const coll = config.collections.find((c) => c.name === doc.collection);
     const sourceRelPath = doc.recordSourcePath ?? doc.relPath;
+    const successor = await supersedingUri(store, doc.uri);
     documents.push({
+      ...(successor ? { supersededBy: successor } : {}),
       docid: doc.docid,
       uri: doc.uri,
       title: doc.title ?? undefined,

package/src/sdk/types.ts

@@ -90,6 +90,7 @@ import type {
   SectionTargetV1,
 } from "../core/sections";
 import type { SyncResult } from "../ingestion";
+import type { CollectionRootError } from "../ingestion/source-availability/root";
 import type { DownloadPolicy } from "../llm/policy";
 import type {
   AskOptions,
@@ -193,7 +194,11 @@ export type GnoVectorSearchOptions = Omit<
 export type GnoContextInput = Omit<ContextCapsuleBuildInput, "indexName"> &
   GnoProjectHintOptions;
 export type GnoContextResult = ContextCapsuleV1;
-export type GnoIndexStatus = IndexStatus & {
+export type GnoIndexStatus = Omit<IndexStatus, "collections"> & {
+  /** `rootError` is set while a collection's folder is missing or unreadable. */
+  collections: Array<
+    IndexStatus["collections"][number] & { rootError?: CollectionRootError }
+  >;
   contentTypeBoost: ContentTypeBoostStatus;
 };
 export type GnoContextVerificationResult = ContextCapsuleVerification;
@@ -394,6 +399,11 @@ export interface GnoClient {
   list(
     options?: GnoListOptions
   ): Promise<import("../cli/commands/ls").LsResponse>;
+  /** Typed metadata keys with types, document counts and common values. */
+  listMetadata(options?: {
+    collection?: string;
+    values?: number;
+  }): Promise<import("../core/metadata-discovery").MetadataSummary>;
   changes(options?: ListKnowledgeChangesInput): Promise<KnowledgeChangesResult>;
   diff(ref: string, changeId?: string): Promise<KnowledgeDiffResult>;
   impact(

package/src/serve/public/components/ThoroughnessSelector.tsx

@@ -29,7 +29,7 @@ interface Option {
 }
 
 const options: Option[] = [
-  { id: "fast", label: "Fast", timing: "BM25", icon: Rabbit },
+  { id: "fast", label: "Fast", timing: "<1s", icon: Rabbit },
   { id: "balanced", label: "Balanced", timing: "~2s", icon: Gauge },
   { id: "thorough", label: "Thorough", timing: "~5s", icon: Sparkles },
 ];