@delali/narsil 0.2.4-next.47 → 0.2.4-next.49

package/dist/{engine-Cjr1uBLa.d.ts → engine-CABZg25p.d.ts}

@@ -1,5 +1,5 @@
 import { E as EmbeddingAdapter } from './adapters-79OIa4xm.js';
-import { I as IndexInfo, f as IndexStats, P as PartitionStatsResult, B as BatchResult, L as ListParams, g as ListResult, Q as QueryParams, e as QueryResult, h as PreflightResult, i as SuggestParams, j as SuggestResult, M as MemoryStats, V as VectorMaintenanceResult } from './search-DDHjfXhJ.js';
+import { I as IndexInfo, f as IndexStats, P as PartitionStatsResult, B as BatchResult, L as ListParams, g as ListResult, Q as QueryParams, e as QueryResult, h as PreflightResult, i as SuggestParams, j as SuggestResult, M as MemoryStats, V as VectorMaintenanceResult } from './search-FjWhZN3f.js';
 import { I as IndexConfig, A as AnyDocument, b as InsertOptions, P as PartitionConfig } from './schema-B7juWg8Q.js';
 
 /**
@@ -16,8 +16,12 @@ type NarsilEventMap = {
     /**
      * A worker thread died. The pool drops it and fails its outstanding requests
      * with `WORKER_CRASHED`, while the remaining workers keep answering because
-     * each holds a full worker copy of every promoted index. Once no worker is
-     * left, queries fall back to the main thread, which holds every document.
+     * each holds a full worker copy of every promoted index. After a delay the
+     * engine spawns a replacement, loads every copy onto it, and puts it back
+     * into rotation. Once no worker is left, queries fall back to the main
+     * thread, which holds every document, and the next request after the delay
+     * starts a new pool. The delay starts at one second and doubles up to a
+     * minute while replacements keep failing.
      */
     workerCrash: {
         /** This worker died. */
@@ -27,16 +31,16 @@ type NarsilEventMap = {
         /** This ended the worker. */
         error: Error;
     };
-    /** The engine moved its indexes onto worker threads. */
+    /** An index gained worker copies, whether it reached the copy threshold or loaded its copies again after an idle spell. */
     workerPromote: {
-        /** The pool started with this many workers. */
+        /** The pool holds this many workers. */
         workerCount: number;
-        /** The engine promoted for this reason, such as the threshold the index passed. */
+        /** The index gained its copies for this reason, such as the copy threshold it reached. */
         reason: string;
     };
-    /** The engine tried to move onto worker threads and could not. Indexes keep answering on the main thread. */
+    /** An index could not gain worker copies. It keeps answering on the main thread. */
     workerPromoteFailure: {
-        /** The engine tried to promote for this reason. */
+        /** The engine tried to load the copies for this reason. */
         reason: string;
         /** This stopped it. */
         error: Error;