@delali/narsil 0.2.4-next.54 → 0.2.4-next.59

package/dist/embeddings/openai.mjs

@@ -1,7 +1,7 @@
-import { NarsilError, ErrorCodes } from '../chunk-FRQVMFY7.mjs';
+import { NarsilError, ErrorCodes } from '../chunk-USKFU7J5.mjs';
 
 // src/embeddings/constants.ts
-var RETRYABLE_STATUS_CODES = /* @__PURE__ */ new Set([429, 500, 502, 503]);
+var RETRYABLE_STATUS_CODES = /* @__PURE__ */ new Set([429, 500, 502, 503, 504]);
 var MAX_BACKOFF_MS = 3e4;
 var BASE_BACKOFF_MS = 1e3;
 var MAX_JITTER_MS = 1e3;

package/dist/{engine-Dj4I91Jv.d.ts → engine-CIOyFozK.d.ts}

@@ -1,6 +1,6 @@
 import { E as EmbeddingAdapter } from './adapters-79OIa4xm.js';
-import { B as BatchResult, I as IndexInfo, f as IndexStats, P as PartitionStatsResult, L as ListParams, g as ListResult, Q as QueryParams, e as QueryResult, h as PreflightResult, j as SuggestParams, k as SuggestResult, M as MemoryStats, V as VectorMaintenanceResult } from './memory-xrXOZMbw.js';
-import { A as AnyDocument, a as InsertOptions, W as WriteOptions, I as IndexConfig, P as PartitionConfig } from './schema-mLpXZBEh.js';
+import { B as BatchResult, I as IndexInfo, f as IndexStats, P as PartitionStatsResult, L as ListParams, g as ListResult, Q as QueryParams, e as QueryResult, h as PreflightResult, j as SuggestParams, k as SuggestResult, M as MemoryStats, V as VectorMaintenanceResult } from './memory-yFaVn2xZ.js';
+import { A as AnyDocument, a as InsertOptions, W as WriteOptions, I as IndexConfig, P as PartitionConfig } from './schema-d5Afu03A.js';
 
 /**
  * Every event the engine emits, with the payload each one carries.
@@ -14,9 +14,11 @@ import { A as AnyDocument, a as InsertOptions, W as WriteOptions, I as IndexConf
  */
 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. After a delay the
+     * A worker thread died. The pool drops it and fails the requests that it was
+     * serving with `WORKER_CRASHED`, and the engine answers each of those queries
+     * again on the main thread, so the caller receives a result and no error.
+     * The remaining workers keep answering, because 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
@@ -431,15 +433,16 @@ interface Narsil extends IndexLifecycleOperations, DocumentWriteOperations {
     /**
      * Loads an index from snapshot bytes, replacing whatever the name held.
      *
-     * The engine reads the `.nrsl` envelope {@link Narsil.snapshot} writes, and
-     * it also reads the headerless MessagePack form earlier releases wrote.
+     * The engine reads the `.nrsl` envelope that {@link Narsil.snapshot} writes.
      *
      * @param indexName - The name the restored index takes.
-     * @param data - Bytes a {@link Narsil.snapshot} produced.
-     * @throws A `NarsilError` with `ENVELOPE_VERSION_MISMATCH` when the envelope
-     * carries a different format version, `PERSISTENCE_CRC_MISMATCH` when the
-     * payload fails its checksum, or `DOC_VALIDATION_FAILED` when the bytes hold
-     * no snapshot.
+     * @param data - Bytes that {@link Narsil.snapshot} produced.
+     * @throws A `NarsilError` with `ENVELOPE_INVALID_MAGIC` when the bytes are
+     * shorter than an envelope header or open with anything other than the
+     * `NRSL` magic bytes, `ENVELOPE_VERSION_MISMATCH` when the envelope carries a
+     * format version other than the index snapshot format,
+     * `PERSISTENCE_CRC_MISMATCH` when the payload fails its checksum, and
+     * `DOC_VALIDATION_FAILED` when the envelope holds no valid index snapshot.
      */
     restore(indexName: string, data: Uint8Array): Promise<void>;
     /**