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

package/dist/{chunk-PM52SMBT.mjs → chunk-OOSIDHA3.mjs}

@@ -1,4 +1,5 @@
-import { MAX_MESSAGE_SIZE_BYTES, TransportError, TransportErrorCodes } from './chunk-JQUL2T6I.mjs';
+import { MAX_MESSAGE_SIZE_BYTES } from './chunk-UNEEFTEU.mjs';
+import { TransportError, TransportErrorCodes } from './chunk-GCM3JFVA.mjs';
 import { encode, decode } from '@msgpack/msgpack';
 
 // src/distribution/transport/tcp/types.ts

package/dist/chunk-ORBLD3EL.mjs

@@ -0,0 +1,6 @@
+// src/distribution/coordinator/constants.ts
+var MAX_NODE_ID_LENGTH = 255;
+var MAX_WATCHERS = 64;
+var NODE_HEARTBEAT_TTL_MS = 3e4;
+
+export { MAX_NODE_ID_LENGTH, MAX_WATCHERS, NODE_HEARTBEAT_TTL_MS };

package/dist/chunk-OWCFK42Q.mjs

@@ -0,0 +1,30 @@
+import { DEFAULT_PAGE_SIZE } from './chunk-CBLS46IE.mjs';
+
+// src/distribution/constants.ts
+var WIRE_BATCH_BUDGET = {
+  maxCount: 1e3,
+  maxBytes: 8388608,
+  overheadBytes: 256
+};
+var MAX_PARTITION_COUNT = 65536;
+var MAX_REPLICATION_FACTOR = 255;
+
+// src/engine/constants.ts
+var MIN_DOCUMENTS_FOR_SEGMENTS = 64;
+var BATCH_CHUNK_SIZE = 1e3;
+var DEFAULT_LIMIT = DEFAULT_PAGE_SIZE;
+var DEFAULT_OFFSET = 0;
+var INDEX_NAME_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/;
+var MAX_INDEX_NAME_LENGTH = 255;
+var MAX_DOC_ID_LENGTH = 512;
+var MIN_SWEEP_INTERVAL_MS = 100;
+var MAX_SWEEP_INTERVAL_MS = 6e4;
+var STATISTICS_BROADCAST_INTERVAL_MS = 5e3;
+var FOREIGN_STATS_TTL_MS = 6e4;
+var DEFAULT_SUGGEST_LIMIT = 10;
+var MAX_SUGGEST_LIMIT = 100;
+var SUGGEST_OVERSAMPLE_FACTOR = 1.5;
+var SUGGEST_OVERSAMPLE_PADDING = 10;
+var MAX_SUGGEST_SCATTER_LIMIT = Math.ceil(MAX_SUGGEST_LIMIT * SUGGEST_OVERSAMPLE_FACTOR) + SUGGEST_OVERSAMPLE_PADDING;
+
+export { BATCH_CHUNK_SIZE, DEFAULT_LIMIT, DEFAULT_OFFSET, DEFAULT_SUGGEST_LIMIT, FOREIGN_STATS_TTL_MS, INDEX_NAME_PATTERN, MAX_DOC_ID_LENGTH, MAX_INDEX_NAME_LENGTH, MAX_PARTITION_COUNT, MAX_REPLICATION_FACTOR, MAX_SUGGEST_LIMIT, MAX_SUGGEST_SCATTER_LIMIT, MAX_SWEEP_INTERVAL_MS, MIN_DOCUMENTS_FOR_SEGMENTS, MIN_SWEEP_INTERVAL_MS, STATISTICS_BROADCAST_INTERVAL_MS, SUGGEST_OVERSAMPLE_FACTOR, SUGGEST_OVERSAMPLE_PADDING, WIRE_BATCH_BUDGET };

package/dist/{chunk-WTONLDU3.mjs → chunk-RDGXYRF4.mjs}

@@ -36,6 +36,7 @@ var KNOWN_ACTION_TYPES = [
   "attachSegments",
   "compactSegments",
   "swapSegments",
+  "freezeLiveTail",
   "memoryReport",
   "bootstrap",
   "shutdown"

package/dist/chunk-UNEEFTEU.mjs

@@ -0,0 +1,7 @@
+// src/distribution/transport/constants.ts
+var MAX_MESSAGE_SIZE_BYTES = 67108864;
+var GRPC_ENVELOPE_OVERHEAD_BYTES = 1024;
+var GRPC_KEEPALIVE_TIME_MS = 3e4;
+var GRPC_KEEPALIVE_TIMEOUT_MS = 1e4;
+
+export { GRPC_ENVELOPE_OVERHEAD_BYTES, GRPC_KEEPALIVE_TIMEOUT_MS, GRPC_KEEPALIVE_TIME_MS, MAX_MESSAGE_SIZE_BYTES };

package/dist/chunk-YEO6G2NG.mjs

@@ -0,0 +1,6 @@
+// src/invalidation/constants.ts
+var DEFAULT_CHANNEL_NAME = "narsil-invalidation";
+var DEFAULT_POLL_INTERVAL_MS = 1e3;
+var MARKER_MAX_AGE_MS = 6e4;
+
+export { DEFAULT_CHANNEL_NAME, DEFAULT_POLL_INTERVAL_MS, MARKER_MAX_AGE_MS };

package/dist/{client-C5BkUqB8.d.ts → client-DX7xPcNA.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-DDHjfXhJ.js';
 import { P as PartitionConfig, A as AnyDocument, b as InsertOptions } from './schema-B7juWg8Q.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-FjWhZN3f.js';
 import { e as TaskRecord, b as ImportResult, H as HttpIndexConfig, c as TaskListQuery, T as TaskListPage } from './tasks-Bn4R1NPN.js';
 
 /**

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-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 ClientErrorCode, a as ClientErrorCodes, E as ErrorCode, b as ErrorCodes, N as NarsilError, c as NarsilErrorCode, S as ServerErrorCode, d as ServerErrorCodes } from './search-FjWhZN3f.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-Dtk99qUs.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-C5BkUqB8.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-DX7xPcNA.js';
 import './schema-B7juWg8Q.js';
 import './adapters-79OIa4xm.js';
-import './config-B-ZI-ft5.js';
-import './config-BZRExglL.js';
+import './config-B41W23Us.js';
+import './config-Co-zAXqO.js';
 import './types-DsSSjY4d.js';
 import './types-D5OwhtsQ.js';

package/dist/client.mjs

@@ -166,220 +166,10 @@ function encodeJson(value) {
   return JSON.stringify(value, toPlainNumbers);
 }
 
-// src/client/http.ts
-var DEFAULT_TIMEOUT_MS = 3e4;
+// src/client/constants.ts
+var DEFAULT_REQUEST_TIMEOUT_MS = 3e4;
 var NO_TIMEOUT = 0;
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function unrefTimer(timer) {
-  const unrefable = timer;
-  unrefable.unref?.();
-}
-function startDeadline(timeoutMs, caller) {
-  const controller = new AbortController();
-  let expired = false;
-  const abortWithCaller = () => controller.abort();
-  if (caller?.aborted) controller.abort();
-  else caller?.addEventListener("abort", abortWithCaller);
-  let timer;
-  if (timeoutMs > 0 && !controller.signal.aborted) {
-    timer = setTimeout(() => {
-      expired = true;
-      controller.abort();
-    }, timeoutMs);
-    unrefTimer(timer);
-  }
-  return {
-    signal: controller.signal,
-    expired: () => expired,
-    release: () => {
-      if (timer !== void 0) clearTimeout(timer);
-      caller?.removeEventListener("abort", abortWithCaller);
-    }
-  };
-}
-var ResponseTooLargeError = class extends Error {
-  constructor(limitBytes) {
-    super(`The answer passed the ${limitBytes} byte ceiling this client reads`);
-    this.limitBytes = limitBytes;
-  }
-};
-async function readStreamCapped(stream, limitBytes) {
-  const reader = stream.getReader();
-  const chunks = [];
-  let total = 0;
-  try {
-    for (; ; ) {
-      const { done, value } = await reader.read();
-      if (done) break;
-      total += value.byteLength;
-      if (total > limitBytes) throw new ResponseTooLargeError(limitBytes);
-      chunks.push(value);
-    }
-  } finally {
-    reader.releaseLock();
-    if (total > limitBytes) await stream.cancel().catch(() => void 0);
-  }
-  const body = new Uint8Array(total);
-  let offset = 0;
-  for (const chunk of chunks) {
-    body.set(chunk, offset);
-    offset += chunk.byteLength;
-  }
-  return body;
-}
-async function readAnswer(response, limitBytes, wantsBytes) {
-  const stream = response.body;
-  if (limitBytes > 0 && stream !== null && stream !== void 0) {
-    const body = await readStreamCapped(stream, limitBytes);
-    return wantsBytes ? { text: "", bytes: body } : { text: new TextDecoder().decode(body), bytes: null };
-  }
-  if (wantsBytes) {
-    const bytes = new Uint8Array(await response.arrayBuffer());
-    if (limitBytes > 0 && bytes.byteLength > limitBytes) throw new ResponseTooLargeError(limitBytes);
-    return { text: "", bytes };
-  }
-  const text = await response.text();
-  if (limitBytes > 0 && text.length > limitBytes) throw new ResponseTooLargeError(limitBytes);
-  return { text, bytes: null };
-}
-function invalidResponse(message, details) {
-  return new NarsilError(ClientErrorCodes.CLIENT_INVALID_RESPONSE, message, details);
-}
-function errorFromBody(status, payload, url) {
-  const envelope = isRecord(payload) && isRecord(payload.error) ? payload.error : void 0;
-  if (envelope === void 0 || typeof envelope.code !== "string" || typeof envelope.message !== "string") {
-    return invalidResponse(`The server answered HTTP ${status} without a Narsil error envelope`, { url, status });
-  }
-  const details = isRecord(envelope.details) ? envelope.details : {};
-  return new NarsilError(envelope.code, envelope.message, { ...details, status });
-}
-function isAbsoluteUrl(value) {
-  try {
-    new URL(value);
-    return true;
-  } catch {
-    return false;
-  }
-}
-function normaliseBase(url) {
-  const trimmed = url.trim();
-  if (trimmed.length === 0) {
-    throw new NarsilError(ErrorCodes.CONFIG_INVALID, 'The client needs a server address, and "url" is empty');
-  }
-  if (!trimmed.startsWith("/") && !isAbsoluteUrl(trimmed)) {
-    throw new NarsilError(
-      ErrorCodes.CONFIG_INVALID,
-      `The client cannot read "${trimmed}" as a server address; pass an absolute URL or a path starting with "/"`,
-      { url: trimmed }
-    );
-  }
-  return trimmed.endsWith("/") ? trimmed.slice(0, -1) : trimmed;
-}
-function withQuery(path, query) {
-  if (query === void 0) return path;
-  const params = new URLSearchParams();
-  for (const [key, value] of Object.entries(query)) {
-    if (value !== void 0) params.set(key, value);
-  }
-  const encoded = params.toString();
-  return encoded.length === 0 ? path : `${path}?${encoded}`;
-}
-function createTransport(options) {
-  const base = normaliseBase(options.url);
-  const send = options.fetch ?? ((input, init) => fetch(input, init));
-  const baseHeaders = { ...options.headers };
-  if (options.apiKey !== void 0 && options.apiKey.length > 0) {
-    baseHeaders.authorization = `Bearer ${options.apiKey}`;
-  }
-  function resolveTimeout(spec) {
-    const perCall = spec.options?.timeoutMs;
-    if (perCall !== void 0) return perCall;
-    if (options.timeoutMs !== void 0) return options.timeoutMs;
-    return spec.defaultTimeoutMs ?? DEFAULT_TIMEOUT_MS;
-  }
-  function resolveResponseCeiling(spec) {
-    const perCall = spec.options?.maxResponseBytes;
-    if (perCall !== void 0) return perCall;
-    return options.maxResponseBytes ?? 0;
-  }
-  async function exchange(spec) {
-    const url = `${base}${withQuery(spec.path, spec.query)}`;
-    const headers = { ...baseHeaders, ...spec.options?.headers };
-    if (spec.contentType !== void 0) headers["content-type"] = spec.contentType;
-    const timeoutMs = resolveTimeout(spec);
-    const deadline = startDeadline(timeoutMs, spec.options?.signal);
-    try {
-      const init = { method: spec.method, headers, signal: deadline.signal };
-      if (spec.body !== void 0) init.body = spec.body;
-      const response = await send(url, init);
-      const wantsBytes = spec.binaryAnswer === true && response.ok;
-      const answer = await readAnswer(response, resolveResponseCeiling(spec), wantsBytes);
-      return { status: response.status, ...answer };
-    } catch (err) {
-      if (err instanceof ResponseTooLargeError) {
-        throw invalidResponse(`The server at ${url} answered more than this client reads: ${err.message}`, {
-          url,
-          maxResponseBytes: err.limitBytes
-        });
-      }
-      if (deadline.expired()) {
-        throw new NarsilError(
-          ClientErrorCodes.CLIENT_REQUEST_TIMEOUT,
-          `The server at ${url} did not answer within ${timeoutMs} ms`,
-          { url, timeoutMs }
-        );
-      }
-      if (spec.options?.signal?.aborted === true) {
-        throw new NarsilError(ClientErrorCodes.CLIENT_REQUEST_ABORTED, `The caller cancelled the request to ${url}`, {
-          url
-        });
-      }
-      throw new NarsilError(
-        ClientErrorCodes.CLIENT_CONNECTION_FAILED,
-        `The client could not reach ${url}: ${describeError(err)}`,
-        { url }
-      );
-    } finally {
-      deadline.release();
-    }
-  }
-  function parse(status, text, path) {
-    if (text.length === 0) return void 0;
-    try {
-      return JSON.parse(text);
-    } catch {
-      throw invalidResponse(`The server answered HTTP ${status} with a body that is not JSON`, { url: path, status });
-    }
-  }
-  async function json(spec) {
-    const { status, text } = await exchange(spec);
-    const payload = parse(status, text, spec.path);
-    if (status >= 200 && status < 300) return payload;
-    throw errorFromBody(status, payload, spec.path);
-  }
-  return {
-    json,
-    async jsonOrNull(spec, absentCode) {
-      try {
-        return await json(spec);
-      } catch (err) {
-        if (err instanceof NarsilError && err.code === absentCode) return null;
-        throw err;
-      }
-    },
-    async binary(spec) {
-      const { status, text, bytes } = await exchange(spec);
-      if (bytes !== null) return bytes;
-      throw errorFromBody(status, parse(status, text, spec.path), spec.path);
-    },
-    async probe(spec) {
-      const { status } = await exchange(spec);
-      return status;
-    }
-  };
-}
+var DEFAULT_TASK_POLL_INTERVAL_MS = 250;
 
 // src/client/paths.ts
 function indexPath(indexName) {
@@ -393,7 +183,7 @@ function taskPath(taskId) {
 }
 
 // src/client/response-shape.ts
-function isRecord2(value) {
+function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function malformed(path, expected) {
@@ -402,27 +192,27 @@ function malformed(path, expected) {
   });
 }
 function readArray(payload, key, path) {
-  if (!isRecord2(payload) || !Array.isArray(payload[key])) throw malformed(path, `"${key}" array`);
+  if (!isRecord(payload) || !Array.isArray(payload[key])) throw malformed(path, `"${key}" array`);
   return payload[key];
 }
 function readNumber(payload, key, path) {
-  if (!isRecord2(payload) || typeof payload[key] !== "number") throw malformed(path, `"${key}" number`);
+  if (!isRecord(payload) || typeof payload[key] !== "number") throw malformed(path, `"${key}" number`);
   return payload[key];
 }
 function readBoolean(payload, key, path) {
-  if (!isRecord2(payload) || typeof payload[key] !== "boolean") throw malformed(path, `"${key}" flag`);
+  if (!isRecord(payload) || typeof payload[key] !== "boolean") throw malformed(path, `"${key}" flag`);
   return payload[key];
 }
 function readString(payload, key, path) {
-  if (!isRecord2(payload) || typeof payload[key] !== "string") throw malformed(path, `"${key}" string`);
+  if (!isRecord(payload) || typeof payload[key] !== "string") throw malformed(path, `"${key}" string`);
   return payload[key];
 }
 function readObject(payload, key, path) {
-  if (!isRecord2(payload) || !isRecord2(payload[key])) throw malformed(path, `"${key}" object`);
+  if (!isRecord(payload) || !isRecord(payload[key])) throw malformed(path, `"${key}" object`);
   return payload[key];
 }
 function readBody(payload, path) {
-  if (!isRecord2(payload)) throw malformed(path, "JSON object");
+  if (!isRecord(payload)) throw malformed(path, "JSON object");
   return payload;
 }
 
@@ -642,6 +432,219 @@ function createDocumentOperations(transport) {
   };
 }
 
+// src/client/http.ts
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function unrefTimer(timer) {
+  const unrefable = timer;
+  unrefable.unref?.();
+}
+function startDeadline(timeoutMs, caller) {
+  const controller = new AbortController();
+  let expired = false;
+  const abortWithCaller = () => controller.abort();
+  if (caller?.aborted) controller.abort();
+  else caller?.addEventListener("abort", abortWithCaller);
+  let timer;
+  if (timeoutMs > 0 && !controller.signal.aborted) {
+    timer = setTimeout(() => {
+      expired = true;
+      controller.abort();
+    }, timeoutMs);
+    unrefTimer(timer);
+  }
+  return {
+    signal: controller.signal,
+    expired: () => expired,
+    release: () => {
+      if (timer !== void 0) clearTimeout(timer);
+      caller?.removeEventListener("abort", abortWithCaller);
+    }
+  };
+}
+var ResponseTooLargeError = class extends Error {
+  constructor(limitBytes) {
+    super(`The answer passed the ${limitBytes} byte ceiling this client reads`);
+    this.limitBytes = limitBytes;
+  }
+};
+async function readStreamCapped(stream, limitBytes) {
+  const reader = stream.getReader();
+  const chunks = [];
+  let total = 0;
+  try {
+    for (; ; ) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      total += value.byteLength;
+      if (total > limitBytes) throw new ResponseTooLargeError(limitBytes);
+      chunks.push(value);
+    }
+  } finally {
+    reader.releaseLock();
+    if (total > limitBytes) await stream.cancel().catch(() => void 0);
+  }
+  const body = new Uint8Array(total);
+  let offset = 0;
+  for (const chunk of chunks) {
+    body.set(chunk, offset);
+    offset += chunk.byteLength;
+  }
+  return body;
+}
+async function readAnswer(response, limitBytes, wantsBytes) {
+  const stream = response.body;
+  if (limitBytes > 0 && stream !== null && stream !== void 0) {
+    const body = await readStreamCapped(stream, limitBytes);
+    return wantsBytes ? { text: "", bytes: body } : { text: new TextDecoder().decode(body), bytes: null };
+  }
+  if (wantsBytes) {
+    const bytes = new Uint8Array(await response.arrayBuffer());
+    if (limitBytes > 0 && bytes.byteLength > limitBytes) throw new ResponseTooLargeError(limitBytes);
+    return { text: "", bytes };
+  }
+  const text = await response.text();
+  if (limitBytes > 0 && text.length > limitBytes) throw new ResponseTooLargeError(limitBytes);
+  return { text, bytes: null };
+}
+function invalidResponse(message, details) {
+  return new NarsilError(ClientErrorCodes.CLIENT_INVALID_RESPONSE, message, details);
+}
+function errorFromBody(status, payload, url) {
+  const envelope = isRecord2(payload) && isRecord2(payload.error) ? payload.error : void 0;
+  if (envelope === void 0 || typeof envelope.code !== "string" || typeof envelope.message !== "string") {
+    return invalidResponse(`The server answered HTTP ${status} without a Narsil error envelope`, { url, status });
+  }
+  const details = isRecord2(envelope.details) ? envelope.details : {};
+  return new NarsilError(envelope.code, envelope.message, { ...details, status });
+}
+function isAbsoluteUrl(value) {
+  try {
+    new URL(value);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function normaliseBase(url) {
+  const trimmed = url.trim();
+  if (trimmed.length === 0) {
+    throw new NarsilError(ErrorCodes.CONFIG_INVALID, 'The client needs a server address, and "url" is empty');
+  }
+  if (!trimmed.startsWith("/") && !isAbsoluteUrl(trimmed)) {
+    throw new NarsilError(
+      ErrorCodes.CONFIG_INVALID,
+      `The client cannot read "${trimmed}" as a server address; pass an absolute URL or a path starting with "/"`,
+      { url: trimmed }
+    );
+  }
+  return trimmed.endsWith("/") ? trimmed.slice(0, -1) : trimmed;
+}
+function withQuery(path, query) {
+  if (query === void 0) return path;
+  const params = new URLSearchParams();
+  for (const [key, value] of Object.entries(query)) {
+    if (value !== void 0) params.set(key, value);
+  }
+  const encoded = params.toString();
+  return encoded.length === 0 ? path : `${path}?${encoded}`;
+}
+function createTransport(options) {
+  const base = normaliseBase(options.url);
+  const send = options.fetch ?? ((input, init) => fetch(input, init));
+  const baseHeaders = { ...options.headers };
+  if (options.apiKey !== void 0 && options.apiKey.length > 0) {
+    baseHeaders.authorization = `Bearer ${options.apiKey}`;
+  }
+  function resolveTimeout(spec) {
+    const perCall = spec.options?.timeoutMs;
+    if (perCall !== void 0) return perCall;
+    if (options.timeoutMs !== void 0) return options.timeoutMs;
+    return spec.defaultTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+  }
+  function resolveResponseCeiling(spec) {
+    const perCall = spec.options?.maxResponseBytes;
+    if (perCall !== void 0) return perCall;
+    return options.maxResponseBytes ?? 0;
+  }
+  async function exchange(spec) {
+    const url = `${base}${withQuery(spec.path, spec.query)}`;
+    const headers = { ...baseHeaders, ...spec.options?.headers };
+    if (spec.contentType !== void 0) headers["content-type"] = spec.contentType;
+    const timeoutMs = resolveTimeout(spec);
+    const deadline = startDeadline(timeoutMs, spec.options?.signal);
+    try {
+      const init = { method: spec.method, headers, signal: deadline.signal };
+      if (spec.body !== void 0) init.body = spec.body;
+      const response = await send(url, init);
+      const wantsBytes = spec.binaryAnswer === true && response.ok;
+      const answer = await readAnswer(response, resolveResponseCeiling(spec), wantsBytes);
+      return { status: response.status, ...answer };
+    } catch (err) {
+      if (err instanceof ResponseTooLargeError) {
+        throw invalidResponse(`The server at ${url} answered more than this client reads: ${err.message}`, {
+          url,
+          maxResponseBytes: err.limitBytes
+        });
+      }
+      if (deadline.expired()) {
+        throw new NarsilError(
+          ClientErrorCodes.CLIENT_REQUEST_TIMEOUT,
+          `The server at ${url} did not answer within ${timeoutMs} ms`,
+          { url, timeoutMs }
+        );
+      }
+      if (spec.options?.signal?.aborted === true) {
+        throw new NarsilError(ClientErrorCodes.CLIENT_REQUEST_ABORTED, `The caller cancelled the request to ${url}`, {
+          url
+        });
+      }
+      throw new NarsilError(
+        ClientErrorCodes.CLIENT_CONNECTION_FAILED,
+        `The client could not reach ${url}: ${describeError(err)}`,
+        { url }
+      );
+    } finally {
+      deadline.release();
+    }
+  }
+  function parse(status, text, path) {
+    if (text.length === 0) return void 0;
+    try {
+      return JSON.parse(text);
+    } catch {
+      throw invalidResponse(`The server answered HTTP ${status} with a body that is not JSON`, { url: path, status });
+    }
+  }
+  async function json(spec) {
+    const { status, text } = await exchange(spec);
+    const payload = parse(status, text, spec.path);
+    if (status >= 200 && status < 300) return payload;
+    throw errorFromBody(status, payload, spec.path);
+  }
+  return {
+    json,
+    async jsonOrNull(spec, absentCode) {
+      try {
+        return await json(spec);
+      } catch (err) {
+        if (err instanceof NarsilError && err.code === absentCode) return null;
+        throw err;
+      }
+    },
+    async binary(spec) {
+      const { status, text, bytes } = await exchange(spec);
+      if (bytes !== null) return bytes;
+      throw errorFromBody(status, parse(status, text, spec.path), spec.path);
+    },
+    async probe(spec) {
+      const { status } = await exchange(spec);
+      return status;
+    }
+  };
+}
+
 // src/client/indexes.ts
 function createIndexOperations(transport) {
   return {
@@ -746,7 +749,6 @@ function createServerOperations(transport) {
 }
 
 // src/client/tasks.ts
-var DEFAULT_POLL_INTERVAL_MS = 250;
 function isTerminal(record) {
   return record.status === "succeeded" || record.status === "failed" || record.status === "cancelled";
 }
@@ -794,7 +796,7 @@ function createTaskOperations(transport) {
       return readBody(await transport.json({ method: "POST", path, options }), path);
     },
     async waitForTask(taskId, options) {
-      const interval = options?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+      const interval = options?.pollIntervalMs ?? DEFAULT_TASK_POLL_INTERVAL_MS;
       const waitTimeoutMs = options?.waitTimeoutMs ?? 0;
       const startedAt = Date.now();
       let reported = null;

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

@@ -1,4 +1,4 @@
-import { N as NarsilConfig } from './config-BZRExglL.js';
+import { N as NarsilConfig } from './config-Co-zAXqO.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-BZRExglL.d.ts → config-Co-zAXqO.d.ts}

@@ -1,5 +1,5 @@
 import { P as PersistenceAdapter, I as InvalidationAdapter, E as EmbeddingAdapter } from './adapters-79OIa4xm.js';
-import { Q as QueryParams, e as QueryResult } from './search-DDHjfXhJ.js';
+import { Q as QueryParams, e as QueryResult } from './search-FjWhZN3f.js';
 import { I as IndexConfig, A as AnyDocument } from './schema-B7juWg8Q.js';
 
 /**
@@ -148,7 +148,7 @@ interface NarsilConfig {
     plugins?: NarsilPlugin[];
     /** This supplies the id for a document inserted without one. The engine generates a UUID v7 by default. */
     idGenerator?: () => string;
-    /** These settings control when the engine moves its indexes onto worker threads, and how many it uses. */
+    /** These settings control when an index gains worker copies, how many threads they share, and when an idle index gives them up. */
     workers?: WorkerConfig;
     /** Every index uses this adapter unless its own config names another. */
     embedding?: EmbeddingAdapter;
@@ -249,23 +249,39 @@ interface DurabilityConfig {
     compactionThreshold?: number;
 }
 /**
- * When the engine moves its indexes onto worker threads, and how many it uses.
+ * How the engine holds worker copies of its indexes, and how many threads
+ * they may use.
  *
- * An engine starts on the main thread, where a small index answers fastest.
- * Once an index passes a threshold the engine promotes it to a worker pool, so
- * that indexing and searching run off the calling thread.
+ * A small index answers fastest on the main thread. Once an index holds as
+ * many documents as the copy threshold, the engine loads a copy of it onto
+ * every worker thread, and each query then runs whole on the copy with the
+ * fewest queries in flight. The same switch governs the vector search pool.
  *
  * @public
  */
 interface WorkerConfig {
-    /** Setting this allows promotion to worker threads. The engine promotes nothing while it is false. */
+    /**
+     * Whether the engine may hold worker copies and a vector search pool. It is
+     * on everywhere but a browser page. Set it to false to hold the process to
+     * one thread, which leaves both pools absent.
+     */
     enabled?: boolean;
-    /** The pool runs this many workers. The engine derives a count from the host's cores by default. */
+    /**
+     * The keyword copies and the vector search pool share this many threads
+     * between them, half each. The engine takes the host's cores minus one by
+     * default, between 2 and 8.
+     */
     count?: number;
-    /** This many documents in one index trigger promotion. */
+    /** An index gains worker copies once it holds this many documents, 1,000 by default. */
     promotionThreshold?: number;
-    /** This many documents across every index trigger promotion. */
-    totalPromotionThreshold?: number;
+    /**
+     * The engine drops an index's copies after this many milliseconds without a
+     * read or a write, five minutes by default, and loads them again on the
+     * next request while the main copy answers it. It may not exceed
+     * `lifecycle.idleTimeoutMs`, and where it is unset the copies take the
+     * smaller of five minutes and that interval.
+     */
+    idleTimeoutMs?: number;
     /** Each worker imports this module on start-up, which is how a worker reaches a custom tokeniser or language. */
     bootstrapModule?: string;
 }