@delali/narsil 0.2.4-next.43 → 0.2.4-next.45

package/dist/{chunk-YGQMKTKG.mjs → chunk-XNCJFU2E.mjs}

@@ -3,7 +3,7 @@ import { createScalarQuantizer } from './chunk-OBXS7OZM.mjs';
 import { MAX_M, createVectorStore, createHNSWIndex, createOrdinalFilter, addToOrdinalFilter, removeFromOrdinalFilter, ordinalFilterValues, magnitude, createBoundedMaxHeap, toScore, euclideanDistance, dotProduct, cosineSimilarityWithMagnitudes, ordinalFilterHas, ABSENT_DOCUMENT_RANK } from './chunk-WDL632CN.mjs';
 import { compareCodePoints, compareComparableKeys, toComparableSortValue, readSortField, compareSortValues, compareComparableValues, SORT_VALUE_MAX_CODE_POINTS } from './chunk-BFIH7OV5.mjs';
 import { generateId, createRequestId } from './chunk-WTONLDU3.mjs';
-import { NarsilError, ErrorCodes, createNarsilError } from './chunk-TLRUUMVE.mjs';
+import { NarsilError, ErrorCodes, createNarsilError } from './chunk-P4ELXVJQ.mjs';
 import { encode, decode } from '@msgpack/msgpack';
 
 // src/schema/validator/shared.ts
@@ -497,6 +497,9 @@ function metadataToWire(meta) {
   if (meta.vectorFields) {
     wire.vector_fields = meta.vectorFields;
   }
+  if (isNonNegativeInteger(meta.documentCount) && Number.isSafeInteger(meta.documentCount)) {
+    wire.document_count = meta.documentCount;
+  }
   if (meta.embedding) {
     wire.embedding = meta.embedding.adapter !== void 0 ? { adapter: meta.embedding.adapter, fields: meta.embedding.fields } : { fields: meta.embedding.fields };
   }
@@ -570,6 +573,9 @@ function wireToMetadata(raw) {
   if (raw.vector_fields) {
     meta.vectorFields = raw.vector_fields;
   }
+  if (isNonNegativeInteger(raw.document_count) && Number.isSafeInteger(raw.document_count)) {
+    meta.documentCount = raw.document_count;
+  }
   if (raw.embedding && typeof raw.embedding === "object" && typeof raw.embedding.fields === "object") {
     meta.embedding = typeof raw.embedding.adapter === "string" ? { adapter: raw.embedding.adapter, fields: raw.embedding.fields } : { fields: raw.embedding.fields };
   }
@@ -964,6 +970,46 @@ function documentWithOwnBuffers(document) {
   if (!sharesABiggerBuffer(document)) return document;
   return withOwnBuffers(document);
 }
+var STRING_HEADER_BYTES = 16;
+var TWO_BYTE_SAMPLE_LIMIT = 16;
+var NUMBER_BYTES = 16;
+var PRIMITIVE_SLOT_BYTES = 4;
+var ARRAY_HEADER_BYTES = 32;
+var ARRAY_SLOT_BYTES = 8;
+var OBJECT_HEADER_BYTES = 40;
+var PROPERTY_SLOT_BYTES = 8;
+var TYPED_ARRAY_HEADER_BYTES = 96;
+function stringBytes(value) {
+  const sampled = Math.min(value.length, TWO_BYTE_SAMPLE_LIMIT);
+  for (let i = 0; i < sampled; i += 1) {
+    if (value.charCodeAt(i) > 255) {
+      return STRING_HEADER_BYTES + value.length * 2;
+    }
+  }
+  return STRING_HEADER_BYTES + value.length;
+}
+function documentValueBytes(value) {
+  if (typeof value === "string") return stringBytes(value);
+  if (typeof value === "number") return NUMBER_BYTES;
+  if (value === null || value === void 0 || typeof value === "boolean") return PRIMITIVE_SLOT_BYTES;
+  if (ArrayBuffer.isView(value)) return TYPED_ARRAY_HEADER_BYTES + value.byteLength;
+  if (Array.isArray(value)) {
+    let bytes = ARRAY_HEADER_BYTES + value.length * ARRAY_SLOT_BYTES;
+    for (let i = 0; i < value.length; i += 1) {
+      bytes += documentValueBytes(value[i]);
+    }
+    return bytes;
+  }
+  if (typeof value === "object") {
+    const source = value;
+    let bytes = OBJECT_HEADER_BYTES;
+    for (const key of Object.keys(source)) {
+      bytes += PROPERTY_SLOT_BYTES + documentValueBytes(source[key]);
+    }
+    return bytes;
+  }
+  return PRIMITIVE_SLOT_BYTES;
+}
 function createDocumentStore() {
   const docs = /* @__PURE__ */ new Map();
   const forwardMap = /* @__PURE__ */ new Map();
@@ -971,6 +1017,19 @@ function createDocumentStore() {
   const lengthColumns = /* @__PURE__ */ new Map();
   let nextInternalId = 0;
   let sortedIds = null;
+  let storedContentBytes = 0;
+  function replaceStored(docId, document, fieldLengths) {
+    const existing = docs.get(docId);
+    if (existing !== void 0) {
+      storedContentBytes -= documentValueBytes(existing.fields);
+    } else {
+      sortedIds = null;
+    }
+    writeFieldLengths(assignInternalId(docId), fieldLengths);
+    const fields = documentWithOwnBuffers(document);
+    storedContentBytes += documentValueBytes(fields);
+    docs.set(docId, { fields, fieldLengths });
+  }
   function writeFieldLengths(internalId, fieldLengths) {
     for (const fieldName of Object.keys(fieldLengths)) {
       let column = lengthColumns.get(fieldName);
@@ -1007,21 +1066,21 @@ function createDocumentStore() {
   };
   return {
     store(docId, document, fieldLengths) {
-      if (!docs.has(docId)) sortedIds = null;
-      writeFieldLengths(assignInternalId(docId), fieldLengths);
-      docs.set(docId, { fields: documentWithOwnBuffers(document), fieldLengths });
+      replaceStored(docId, document, fieldLengths);
     },
     storeRef(docId, document, fieldLengths) {
-      if (!docs.has(docId)) sortedIds = null;
-      writeFieldLengths(assignInternalId(docId), fieldLengths);
-      docs.set(docId, { fields: documentWithOwnBuffers(document), fieldLengths });
+      replaceStored(docId, document, fieldLengths);
     },
     get(docId) {
       return docs.get(docId);
     },
     remove(docId) {
+      const existing = docs.get(docId);
       const removed = docs.delete(docId);
       if (removed) {
+        if (existing !== void 0) {
+          storedContentBytes -= documentValueBytes(existing.fields);
+        }
         sortedIds = null;
         const internalId = forwardMap.get(docId);
         if (internalId !== void 0) {
@@ -1058,6 +1117,7 @@ function createDocumentStore() {
       docs.clear();
       lengthColumns.clear();
       clearMappings();
+      storedContentBytes = 0;
     },
     serialize() {
       const result = {};
@@ -1070,10 +1130,12 @@ function createDocumentStore() {
       docs.clear();
       lengthColumns.clear();
       clearMappings();
+      storedContentBytes = 0;
       for (const docId of Object.keys(data)) {
         const stored = data[docId];
         writeFieldLengths(assignInternalId(docId), stored.fieldLengths);
         const fields = documentWithOwnBuffers(stored.fields);
+        storedContentBytes += documentValueBytes(fields);
         docs.set(docId, fields === stored.fields ? stored : { fields, fieldLengths: stored.fieldLengths });
       }
     },
@@ -1097,6 +1159,9 @@ function createDocumentStore() {
     internalIdCapacity() {
       return nextInternalId;
     },
+    contentBytes() {
+      return storedContentBytes;
+    },
     resolver() {
       return idResolver;
     }
@@ -4105,7 +4170,7 @@ var BYTES_PER_NUMBER_SLOT = 8;
 var BYTES_PER_BOOLEAN_SLOT = 1;
 var BYTES_PER_MIXED_SLOT = 8;
 var BYTES_PER_STRING_CODE_UNIT = 2;
-var STRING_HEADER_BYTES = 24;
+var STRING_HEADER_BYTES2 = 24;
 function grow(length, wanted) {
   let next = length === 0 ? 64 : length;
   while (next <= wanted) next *= 2;
@@ -4227,7 +4292,7 @@ function createValueStore(initialKind) {
       for (const value of mixed) {
         if (typeof value !== "string") continue;
         if (value.length < SORT_VALUE_MAX_CODE_POINTS) continue;
-        bytes += STRING_HEADER_BYTES + value.length * BYTES_PER_STRING_CODE_UNIT;
+        bytes += STRING_HEADER_BYTES2 + value.length * BYTES_PER_STRING_CODE_UNIT;
       }
       return bytes;
     }
@@ -4566,15 +4631,17 @@ function sortColumnBytes(state) {
 }
 
 // src/core/partition/memory.ts
-var AVG_DOC_OVERHEAD = 350;
-var POSTING_ENTRY_SIZE = 24;
-var PER_TERM_OVERHEAD = 180;
-var SURFACE_ENTRY_OVERHEAD = 140;
-var FIELD_ENTRY_OVERHEAD = 42;
+var DOC_ENTRY_OVERHEAD_BYTES = 260;
+var LENGTH_COLUMN_SLOT_BYTES = 6;
+var POSTING_ENTRY_BYTES = 40;
+var POSITIONS_ARRAY_OVERHEAD_BYTES = 88;
+var POSITION_BYTES = 8;
+var PER_TERM_OVERHEAD_BYTES = 180;
+var SURFACE_ENTRY_OVERHEAD_BYTES = 140;
+var FIELD_ENTRY_OVERHEAD_BYTES = 42;
 function estimatePartitionBytes(state) {
   const docCount = state.docStore.count();
   if (docCount === 0) return 0;
-  let bytes = docCount * AVG_DOC_OVERHEAD;
   const docFreqs = state.stats.docFrequencies;
   let totalPostings = 0;
   let termCount = 0;
@@ -4582,13 +4649,27 @@ function estimatePartitionBytes(state) {
     totalPostings += docFreqs[term];
     termCount++;
   }
-  bytes += totalPostings * POSTING_ENTRY_SIZE;
-  bytes += termCount * PER_TERM_OVERHEAD;
-  bytes += state.surfaceRegistry.size() * SURFACE_ENTRY_OVERHEAD;
-  bytes += docCount * state.numericIndexes.size * FIELD_ENTRY_OVERHEAD;
-  bytes += docCount * state.booleanIndexes.size * FIELD_ENTRY_OVERHEAD;
-  bytes += docCount * state.enumIndexes.size * FIELD_ENTRY_OVERHEAD;
-  bytes += docCount * state.geoIndexes.size * FIELD_ENTRY_OVERHEAD;
+  const fieldLengthTotals = state.stats.totalFieldLengths;
+  let totalTokenOccurrences = 0;
+  let textFieldCount = 0;
+  for (const field in fieldLengthTotals) {
+    totalTokenOccurrences += fieldLengthTotals[field];
+    textFieldCount++;
+  }
+  let bytes = state.docStore.contentBytes();
+  bytes += docCount * DOC_ENTRY_OVERHEAD_BYTES;
+  bytes += textFieldCount * state.docStore.internalIdCapacity() * LENGTH_COLUMN_SLOT_BYTES;
+  bytes += totalPostings * POSTING_ENTRY_BYTES;
+  if (state.trackPositions) {
+    bytes += totalPostings * POSITIONS_ARRAY_OVERHEAD_BYTES;
+    bytes += totalTokenOccurrences * POSITION_BYTES;
+  }
+  bytes += termCount * PER_TERM_OVERHEAD_BYTES;
+  bytes += state.surfaceRegistry.size() * SURFACE_ENTRY_OVERHEAD_BYTES;
+  bytes += docCount * state.numericIndexes.size * FIELD_ENTRY_OVERHEAD_BYTES;
+  bytes += docCount * state.booleanIndexes.size * FIELD_ENTRY_OVERHEAD_BYTES;
+  bytes += docCount * state.enumIndexes.size * FIELD_ENTRY_OVERHEAD_BYTES;
+  bytes += docCount * state.geoIndexes.size * FIELD_ENTRY_OVERHEAD_BYTES;
   return bytes + sortColumnBytes(state);
 }
 
@@ -6437,6 +6518,9 @@ function createFrozenDocTable(idTable, lengthColumns, documents, tombstones) {
     internalIdCapacity() {
       return capacity;
     },
+    contentBytes() {
+      return documents.byteLength;
+    },
     resolver() {
       return resolver;
     }
@@ -6464,21 +6548,32 @@ function wrapEncodedDocumentTable(data) {
   const { blob, offsets } = data;
   const count = offsets.length - 1;
   const decoded = new Array(count);
+  const encodedBytes = blob.byteLength + offsets.byteLength;
+  let decodedBytes = 0;
   return {
     count,
+    get byteLength() {
+      return encodedBytes + decodedBytes;
+    },
     docAt(ordinal) {
       let document = decoded[ordinal];
       if (document === void 0) {
         document = decode(blob.slice(offsets[ordinal], offsets[ordinal + 1]));
         decoded[ordinal] = document;
+        decodedBytes += documentValueBytes(document);
       }
       return document;
     }
   };
 }
 function wrapDocumentArray(documents) {
+  let residentBytes = 0;
+  for (const document of documents) {
+    residentBytes += documentValueBytes(document);
+  }
   return {
     count: documents.length,
+    byteLength: residentBytes,
     docAt(ordinal) {
       return documents[ordinal];
     }
@@ -9527,11 +9622,7 @@ function createWorkerPool(config) {
     indexAssignment.set(indexName, slotIndex);
   }
   function removeIndex(indexName) {
-    const slotIndex = indexAssignment.get(indexName);
-    if (slotIndex === void 0) {
-      return;
-    }
-    workers.get(slotIndex)?.indexes.delete(indexName);
+    for (const slot of workers.values()) slot.indexes.delete(indexName);
     indexAssignment.delete(indexName);
   }
   function getExecutor(indexName) {
@@ -10729,6 +10820,9 @@ function createDirectExecutor() {
   }
   function dropIndex(indexName) {
     const entry = requireIndex(indexName);
+    for (const vectorIndex of entry.vectorIndexes.values()) {
+      vectorIndex.dispose();
+    }
     for (const partition of entry.manager.getAllPartitions()) {
       partition.clear();
     }

package/dist/{chunk-O4Q5JYNK.mjs → chunk-XWICBGYT.mjs}

@@ -1,4 +1,4 @@
-import { NarsilError, ErrorCodes } from './chunk-TLRUUMVE.mjs';
+import { NarsilError, ErrorCodes } from './chunk-P4ELXVJQ.mjs';
 import { encode, decode } from '@msgpack/msgpack';
 
 var INDEX_CONFIG_PREFIX = "_narsil/index/";

package/dist/{client-B5uO5jL1.d.ts → client-C5BkUqB8.d.ts}

@@ -1,5 +1,5 @@
-import { V as VectorMaintenanceResult, M as MemoryStats, B as BatchResult, L as ListParams, g as ListResult, I as IndexInfo, f as IndexStats, P as PartitionStatsResult, Q as QueryParams, e as QueryResult, h as PreflightResult, i as SuggestParams, j as SuggestResult } from './search-BGouJxH4.js';
-import { P as PartitionConfig, A as AnyDocument, a as InsertOptions } from './schema-DXOd96kx.js';
+import { V as VectorMaintenanceResult, M as MemoryStats, B as BatchResult, L as ListParams, g as ListResult, I as IndexInfo, f as IndexStats, P as PartitionStatsResult, Q as QueryParams, e as QueryResult, h as PreflightResult, i as SuggestParams, j as SuggestResult } from './search-DDHjfXhJ.js';
+import { P as PartitionConfig, A as AnyDocument, b as InsertOptions } from './schema-B7juWg8Q.js';
 import { e as TaskRecord, b as ImportResult, H as HttpIndexConfig, c as TaskListQuery, T as TaskListPage } from './tasks-Bn4R1NPN.js';
 
 /**
@@ -521,6 +521,29 @@ interface IndexOperations {
      * this request.
      */
     clear(indexName: string, options?: RequestOptions): Promise<void>;
+    /**
+     * Loads a closed index into server memory and marks it active, so the first
+     * query pays no recovery wait. Opening an index that failed to reopen clears
+     * its parked error and retries the recovery.
+     *
+     * @param indexName - This names the index to open.
+     * @param options - This sets the signal, the deadline, and the headers for
+     * this request.
+     * @throws A `NarsilError` with `INDEX_NOT_FOUND` for an unknown name, and
+     * with the recovery error when the index cannot load.
+     */
+    open(indexName: string, options?: RequestOptions): Promise<void>;
+    /**
+     * Checkpoints an index and releases its server memory. The data stays on
+     * disk, and the next operation that names the index reopens it.
+     *
+     * @param indexName - This names the index to close.
+     * @param options - This sets the signal, the deadline, and the headers for
+     * this request.
+     * @throws A `NarsilError` with `INDEX_NOT_FOUND` for an unknown name, and
+     * with `CONFIG_INVALID` when the server runs without durability.
+     */
+    close(indexName: string, options?: RequestOptions): Promise<void>;
 }
 
 /**

package/dist/client.d.ts

@@ -1,10 +1,10 @@
-export { C as ClientErrorCode, a as ClientErrorCodes, E as ErrorCode, b as ErrorCodes, N as NarsilError, c as NarsilErrorCode, S as ServerErrorCode, d as ServerErrorCodes } from './search-BGouJxH4.js';
-export { A as ASYNC_IMPORT_CAPABILITY, E as ErrorEnvelope, R as REBUILD_ANALYSIS_CAPABILITY, S as SERVER_CAPABILITIES, T as TASK_CANCEL_CAPABILITY, a as TASK_FILTER_CAPABILITY } from './options-BakECW-r.js';
+export { C as ClientErrorCode, a as ClientErrorCodes, E as ErrorCode, b as ErrorCodes, N as NarsilError, c as NarsilErrorCode, S as ServerErrorCode, d as ServerErrorCodes } from './search-DDHjfXhJ.js';
+export { A as ASYNC_IMPORT_CAPABILITY, E as ErrorEnvelope, I as INDEX_LIFECYCLE_CAPABILITY, R as REBUILD_ANALYSIS_CAPABILITY, S as SERVER_CAPABILITIES, T as TASK_CANCEL_CAPABILITY, a as TASK_FILTER_CAPABILITY } from './options-BC68VPoE.js';
 export { C as CapabilitiesResponse, a as CreateIndexEmbedding, H as HttpIndexConfig, I as ImportError, b as ImportResult, T as TaskListPage, c as TaskListQuery, d as TaskProgress, e as TaskRecord, f as TaskStatus, g as TaskType } from './tasks-Bn4R1NPN.js';
-export { A as AdminOperations, B as BulkOperations, D as DocumentOperations, F as FetchFunction, I as ImportSource, a as IndexOperations, N as NarsilClient, b as NarsilClientOptions, P as PutResult, R as RequestOptions, S as SearchOperations, c as ServerOperations, d as ServerVersion, T as TaskOperations, W as WaitForTaskOptions, e as createNarsilClient } from './client-B5uO5jL1.js';
-import './schema-DXOd96kx.js';
+export { A as AdminOperations, B as BulkOperations, D as DocumentOperations, F as FetchFunction, I as ImportSource, a as IndexOperations, N as NarsilClient, b as NarsilClientOptions, P as PutResult, R as RequestOptions, S as SearchOperations, c as ServerOperations, d as ServerVersion, T as TaskOperations, W as WaitForTaskOptions, e as createNarsilClient } from './client-C5BkUqB8.js';
+import './schema-B7juWg8Q.js';
 import './adapters-79OIa4xm.js';
-import './config-NgUCkc6a.js';
-import './config-B09-cud9.js';
-import './types-BTE33VZS.js';
+import './config-B-ZI-ft5.js';
+import './config-BZRExglL.js';
+import './types-DsSSjY4d.js';
 import './types-D5OwhtsQ.js';

package/dist/client.mjs

@@ -10,6 +10,7 @@ var ErrorCodes = {
   INDEX_NOT_FOUND: "INDEX_NOT_FOUND",
   INDEX_ALREADY_EXISTS: "INDEX_ALREADY_EXISTS",
   INDEX_ORPHANED: "INDEX_ORPHANED",
+  INDEX_REOPEN_CAPACITY_EXHAUSTED: "INDEX_REOPEN_CAPACITY_EXHAUSTED",
   PARTITION_CORRUPTED: "PARTITION_CORRUPTED",
   PARTITION_REBALANCING_BACKPRESSURE: "PARTITION_REBALANCING_BACKPRESSURE",
   WORKER_CRASHED: "WORKER_CRASHED",
@@ -145,11 +146,13 @@ var ASYNC_IMPORT_CAPABILITY = "documents.import.async";
 var TASK_CANCEL_CAPABILITY = "tasks.cancel";
 var TASK_FILTER_CAPABILITY = "tasks.filter";
 var REBUILD_ANALYSIS_CAPABILITY = "indexes.rebuildAnalysis";
+var INDEX_LIFECYCLE_CAPABILITY = "indexes.lifecycle";
 var SERVER_CAPABILITIES = [
   ASYNC_IMPORT_CAPABILITY,
   TASK_CANCEL_CAPABILITY,
   TASK_FILTER_CAPABILITY,
-  REBUILD_ANALYSIS_CAPABILITY
+  REBUILD_ANALYSIS_CAPABILITY,
+  INDEX_LIFECYCLE_CAPABILITY
 ];
 
 // src/json-encoding.ts
@@ -669,6 +672,12 @@ function createIndexOperations(transport) {
     },
     async clear(indexName, options) {
       await transport.json({ method: "POST", path: `${indexPath(indexName)}/_clear`, options });
+    },
+    async open(indexName, options) {
+      await transport.json({ method: "POST", path: `${indexPath(indexName)}/_open`, options });
+    },
+    async close(indexName, options) {
+      await transport.json({ method: "POST", path: `${indexPath(indexName)}/_close`, options });
     }
   };
 }
@@ -839,4 +848,4 @@ function createNarsilClient(options) {
   };
 }
 
-export { ASYNC_IMPORT_CAPABILITY, ClientErrorCodes, ErrorCodes, NarsilError, REBUILD_ANALYSIS_CAPABILITY, SERVER_CAPABILITIES, ServerErrorCodes, TASK_CANCEL_CAPABILITY, TASK_FILTER_CAPABILITY, createNarsilClient };
+export { ASYNC_IMPORT_CAPABILITY, ClientErrorCodes, ErrorCodes, INDEX_LIFECYCLE_CAPABILITY, NarsilError, REBUILD_ANALYSIS_CAPABILITY, SERVER_CAPABILITIES, ServerErrorCodes, TASK_CANCEL_CAPABILITY, TASK_FILTER_CAPABILITY, createNarsilClient };

package/dist/{config-NgUCkc6a.d.ts → config-B-ZI-ft5.d.ts}

@@ -1,5 +1,5 @@
-import { N as NarsilConfig } from './config-B09-cud9.js';
-import { A as AllocationTable, N as NodeRole, a as NodeRegistration, C as ClusterCoordinator, b as NodeCapacity } from './types-BTE33VZS.js';
+import { N as NarsilConfig } from './config-BZRExglL.js';
+import { A as AllocationTable, N as NodeRole, a as NodeRegistration, C as ClusterCoordinator, b as NodeCapacity } from './types-DsSSjY4d.js';
 import { N as NodeTransport } from './types-D5OwhtsQ.js';
 
 /**

package/dist/{config-B09-cud9.d.ts → config-BZRExglL.d.ts}

@@ -1,6 +1,6 @@
 import { P as PersistenceAdapter, I as InvalidationAdapter, E as EmbeddingAdapter } from './adapters-79OIa4xm.js';
-import { Q as QueryParams, e as QueryResult } from './search-BGouJxH4.js';
-import { I as IndexConfig, A as AnyDocument } from './schema-DXOd96kx.js';
+import { Q as QueryParams, e as QueryResult } from './search-DDHjfXhJ.js';
+import { I as IndexConfig, A as AnyDocument } from './schema-B7juWg8Q.js';
 
 /**
  * Hooks that run alongside the engine's own work, which is how you add
@@ -158,6 +158,23 @@ interface NarsilConfig {
     durability?: DurabilityConfig;
     /** These settings control what the engine does when an index's stored analysis differs from its language module. */
     analysis?: AnalysisConfig;
+    /** These limits close indexes while keeping their durable files ready to reopen. */
+    lifecycle?: IndexLifecycleConfig;
+}
+/**
+ * Limits on the indexes one engine keeps open in memory.
+ *
+ * @public
+ */
+interface IndexLifecycleConfig {
+    /** An index closes after this many milliseconds without activity. */
+    idleTimeoutMs?: number;
+    /** The engine keeps at most this many indexes open at once. */
+    maxOpenIndexes?: number;
+    /** Open indexes may use at most this many estimated bytes in total. */
+    maxOpenBytes?: number;
+    /** At most this many callers may wait behind one index reopen. */
+    maxReopenWaiters?: number;
 }
 /**
  * Describes an index whose stored terms came from an older analysis than the
@@ -253,4 +270,4 @@ interface WorkerConfig {
     bootstrapModule?: string;
 }
 
-export type { AnalysisConfig as A, DurabilityConfig as D, IndexContext as I, NarsilConfig as N, PartitionContext as P, RemoveContext as R, SearchContext as S, UpdateContext as U, WorkerConfig as W, InsertContext as a, NarsilPlugin as b, StaleAnalysis as c, WorkerContext as d };
+export type { AnalysisConfig as A, DurabilityConfig as D, IndexContext as I, NarsilConfig as N, PartitionContext as P, RemoveContext as R, SearchContext as S, UpdateContext as U, WorkerConfig as W, IndexLifecycleConfig as a, InsertContext as b, NarsilPlugin as c, StaleAnalysis as d, WorkerContext as e };

package/dist/{direct-executor-7O23GEHE.mjs → direct-executor-IMXNRS7O.mjs}

@@ -1,8 +1,8 @@
-export { createDirectExecutor } from './chunk-YGQMKTKG.mjs';
+export { createDirectExecutor } from './chunk-XNCJFU2E.mjs';
 import './chunk-TGP5M5R7.mjs';
 import './chunk-OBXS7OZM.mjs';
 import './chunk-WDL632CN.mjs';
 import './chunk-U2BKYEC7.mjs';
 import './chunk-BFIH7OV5.mjs';
 import './chunk-WTONLDU3.mjs';
-import './chunk-TLRUUMVE.mjs';
+import './chunk-P4ELXVJQ.mjs';

package/dist/distribution/coordinator/etcd.d.ts

@@ -1,5 +1,5 @@
-import { C as ClusterCoordinator } from '../../types-BTE33VZS.js';
-import '../../schema-DXOd96kx.js';
+import { C as ClusterCoordinator } from '../../types-DsSSjY4d.js';
+import '../../schema-B7juWg8Q.js';
 import '../../adapters-79OIa4xm.js';
 
 /**

package/dist/distribution/coordinator/etcd.mjs

@@ -1,5 +1,5 @@
 import { compareCodePoints } from '../../chunk-BFIH7OV5.mjs';
-import { NarsilError, ErrorCodes } from '../../chunk-TLRUUMVE.mjs';
+import { NarsilError, ErrorCodes } from '../../chunk-P4ELXVJQ.mjs';
 import { decode, encode } from '@msgpack/msgpack';
 
 // src/distribution/coordinator/etcd/types.ts

package/dist/distribution/coordinator/in-memory.d.ts

@@ -1,5 +1,5 @@
-import { C as ClusterCoordinator } from '../../types-BTE33VZS.js';
-import '../../schema-DXOd96kx.js';
+import { C as ClusterCoordinator } from '../../types-DsSSjY4d.js';
+import '../../schema-B7juWg8Q.js';
 import '../../adapters-79OIa4xm.js';
 
 /**

package/dist/distribution/transport/grpc.mjs

@@ -1,6 +1,6 @@
 import { decodeTransportMessage, encodeTransportMessage } from '../../chunk-PM52SMBT.mjs';
 import { TransportError, TransportErrorCodes, MAX_MESSAGE_SIZE_BYTES } from '../../chunk-JQUL2T6I.mjs';
-import { NarsilError, ErrorCodes } from '../../chunk-TLRUUMVE.mjs';
+import { NarsilError, ErrorCodes } from '../../chunk-P4ELXVJQ.mjs';
 
 // src/distribution/transport/grpc/codec.ts
 var FIELD_ONE_LENGTH_DELIMITED_KEY = 10;

package/dist/distribution.d.ts

@@ -1,12 +1,12 @@
-import { a as CreateIndexOptions, C as ClusterNamespace, b as ClusterNodeConfig } from './config-NgUCkc6a.js';
-export { c as ClusterControllerConfig, d as ClusterNodeInfo, e as ClusterQueryConfig, N as NodeReadiness, R as ReplicationConfig } from './config-NgUCkc6a.js';
-import { N as NarsilEventMap, a as Narsil } from './engine-CjLhdDIm.js';
-import { B as BatchResult, L as ListParams, g as ListResult, i as SuggestParams, j as SuggestResult, Q as QueryParams, h as PreflightResult, f as IndexStats, P as PartitionStatsResult, M as MemoryStats, e as QueryResult } from './search-BGouJxH4.js';
-import { I as IndexConfig, A as AnyDocument, a as InsertOptions } from './schema-DXOd96kx.js';
-import { b as NodeCapacity, N as NodeRole } from './types-BTE33VZS.js';
-export { c as AllocationConstraints, d as AllocationEvent, A as AllocationTable, C as ClusterCoordinator, e as NodeEvent, a as NodeRegistration, P as PartitionAssignment, f as PartitionState, S as SchemaEvent, U as UnassignedReason } from './types-BTE33VZS.js';
+import { a as CreateIndexOptions, C as ClusterNamespace, b as ClusterNodeConfig } from './config-B-ZI-ft5.js';
+export { c as ClusterControllerConfig, d as ClusterNodeInfo, e as ClusterQueryConfig, N as NodeReadiness, R as ReplicationConfig } from './config-B-ZI-ft5.js';
+import { N as NarsilEventMap, a as Narsil } from './engine-Cjr1uBLa.js';
+import { B as BatchResult, L as ListParams, g as ListResult, i as SuggestParams, j as SuggestResult, Q as QueryParams, h as PreflightResult, f as IndexStats, P as PartitionStatsResult, M as MemoryStats, e as QueryResult } from './search-DDHjfXhJ.js';
+import { I as IndexConfig, A as AnyDocument, b as InsertOptions } from './schema-B7juWg8Q.js';
+import { b as NodeCapacity, N as NodeRole } from './types-DsSSjY4d.js';
+export { c as AllocationConstraints, d as AllocationEvent, A as AllocationTable, C as ClusterCoordinator, e as NodeEvent, a as NodeRegistration, P as PartitionAssignment, f as PartitionState, S as SchemaEvent, U as UnassignedReason } from './types-DsSSjY4d.js';
 export { L as ListenHandler, N as NodeTransport, R as RespondFn, T as TransportConfig, a as TransportMessage } from './types-D5OwhtsQ.js';
-import './config-B09-cud9.js';
+import './config-BZRExglL.js';
 import './adapters-79OIa4xm.js';
 
 /**
@@ -48,6 +48,20 @@ interface ClusterNode {
     readonly nodeId: string;
     /** The node holds these roles in the cluster. */
     readonly roles: ReadonlyArray<NodeRole>;
+    /**
+     * Loads this node's local copy of an index from durable storage.
+     *
+     * @param indexName - The index to load on this node.
+     * @returns A promise that settles when the local copy is ready for operations.
+     */
+    open(indexName: string): Promise<void>;
+    /**
+     * Checkpoints and releases this node's local copy of an index.
+     *
+     * @param indexName - The index to close on this node.
+     * @returns A promise that settles after the local copy releases its memory.
+     */
+    close(indexName: string): Promise<void>;
     /**
      * Creates an index across the cluster, publishing its schema and allocating
      * its partitions to nodes.
@@ -325,8 +339,8 @@ interface ClusterEngineOptions {
  *
  * Writes, updates, searches, suggestions, listings, counts, index creation,
  * index removal, and document reads route through the cluster. Checkpointing,
- * memory statistics, and engine events reach this node's local engine, because
- * each covers a per-node fact. Every other operation fails with
+ * memory statistics, index opens, index closes, and engine events reach this
+ * node's local engine, because each covers a per-node fact. Every other operation fails with
  * `CLUSTER_OPERATION_UNSUPPORTED`, which the HTTP server answers with status
  * 501, so a caller learns the operation is missing rather than reading a
  * wrong answer. That covers `getStats`, `getPartitionStats`, and