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

package/dist/index.d.ts

@@ -1,12 +1,12 @@
-import { c as StopWordOverride, C as CustomTokenizer } from './schema-B7juWg8Q.js';
-export { A as AnyDocument, B as BM25Params, E as EmbeddingFieldConfig, F as FieldType, I as IndexConfig, b as InsertOptions, P as PartitionConfig, S as SchemaDefinition, a as ScoringMode, V as VectorIndexConfig, d as VectorQuantizationMode } from './schema-B7juWg8Q.js';
+import { c as StopWordOverride, C as CustomTokenizer } from './schema-BqRx9t4E.js';
+export { A as AnyDocument, B as BM25Params, E as EmbeddingFieldConfig, F as FieldType, I as IndexConfig, b as InsertOptions, P as PartitionConfig, S as SchemaDefinition, a as ScoringMode, V as VectorIndexConfig, d as VectorQuantizationMode, W as WriteOptions } from './schema-BqRx9t4E.js';
 import { L as LanguageModule } from './language-DB8KG1z5.js';
 export { T as TokenizerConfig } from './language-DB8KG1z5.js';
-export { A as ArrayFilter, B as BatchResult, C as ClientErrorCode, a as ClientErrorCodes, k as ComparisonFilter, D as DocumentProjection, E as ErrorCode, b as ErrorCodes, F as FacetConfig, l as FacetResult, m as FieldFilter, n as FilterExpression, G as GeoFilter, o as GeoPolygonFilter, p as GeoRadiusFilter, q as GroupConfig, r as GroupReducer, s as GroupResult, H as HighlightConfig, t as HighlightMatch, u as Hit, v as HybridConfig, I as IndexInfo, f as IndexStats, L as ListParams, g as ListResult, w as ListedDocument, M as MemoryStats, N as NarsilError, c as NarsilErrorCode, P as PartitionStatsResult, h as PreflightResult, x as PresenceFilter, y as ProcessMemoryReport, z as QueryCoverage, Q as QueryParams, e as QueryResult, J as ScoreComponents, K as SearchMode, S as ServerErrorCode, d as ServerErrorCodes, O as SortField, R as SortSpec, T as StringFilter, i as SuggestParams, j as SuggestResult, U as TermMatchPolicy, V as VectorMaintenanceResult, W as VectorQueryConfig, X as WorkerCopyReport } from './search-FjWhZN3f.js';
-import { N as NarsilConfig } from './config-Co-zAXqO.js';
-export { A as AnalysisConfig, D as DurabilityConfig, I as IndexContext, a as IndexLifecycleConfig, b as InsertContext, c as NarsilPlugin, P as PartitionContext, R as RemoveContext, S as SearchContext, d as StaleAnalysis, U as UpdateContext, W as WorkerConfig, e as WorkerContext } from './config-Co-zAXqO.js';
-import { a as Narsil } from './engine-CABZg25p.js';
-export { I as IndexLifecycleOperations, N as NarsilEventMap } from './engine-CABZg25p.js';
+export { A as ArrayFilter, B as BatchResult, C as ClientErrorCode, a as ClientErrorCodes, k as ComparisonFilter, D as DocumentProjection, E as ErrorCode, b as ErrorCodes, F as FacetConfig, l as FacetResult, m as FieldFilter, n as FilterExpression, G as GeoFilter, o as GeoPolygonFilter, p as GeoRadiusFilter, q as GroupConfig, r as GroupReducer, s as GroupResult, H as HighlightConfig, t as HighlightMatch, u as Hit, v as HybridConfig, I as IndexInfo, f as IndexStats, L as ListParams, g as ListResult, w as ListedDocument, M as MemoryStats, N as NarsilError, c as NarsilErrorCode, P as PartitionStatsResult, h as PreflightResult, x as PresenceFilter, y as ProcessMemoryReport, z as QueryCoverage, Q as QueryParams, e as QueryResult, J as ScoreComponents, K as SearchMode, S as ServerErrorCode, d as ServerErrorCodes, O as SortField, R as SortSpec, T as StringFilter, i as SuggestParams, j as SuggestResult, U as TermMatchPolicy, V as VectorMaintenanceResult, W as VectorQueryConfig, X as WorkerCopyReport } from './memory-Bzd5xcEW.js';
+import { N as NarsilConfig } from './config-OON7IJ_B.js';
+export { A as AnalysisConfig, D as DurabilityConfig, I as IndexContext, a as IndexLifecycleConfig, b as InsertContext, M as MainCopyQueries, c as NarsilPlugin, P as PartitionContext, R as RemoveContext, S as SearchContext, d as StaleAnalysis, U as UpdateContext, W as WorkerConfig, e as WorkerContext } from './config-OON7IJ_B.js';
+import { a as Narsil } from './engine-9PtFY50q.js';
+export { D as DocumentWriteOperations, I as IndexLifecycleOperations, N as NarsilEventMap } from './engine-9PtFY50q.js';
 export { E as EmbeddingAdapter, I as InvalidationAdapter, a as InvalidationEvent, b as PartitionStatistics, P as PersistenceAdapter } from './adapters-79OIa4xm.js';
 
 /**

package/dist/index.mjs

@@ -1,13 +1,18 @@
-export { VERSION, createNarsil } from './chunk-56PJBIJ6.mjs';
+export { VERSION, createNarsil } from './chunk-ND34I3SV.mjs';
+import './chunk-ZHUQKZBE.mjs';
 import './chunk-GCM3JFVA.mjs';
-import './chunk-OWCFK42Q.mjs';
-export { clearNormalizationCache, configureNormalizationCache, getLanguage, getNormalizationCacheSize, getStopWords, getTokenizer, hasStopWords, hasTokenizer, registerLanguage, registerStopWords, registerTokenizer, resetNormalizationCache } from './chunk-M6JGMKA5.mjs';
+import './chunk-PIWKZPP7.mjs';
+import './chunk-XE6XR2OE.mjs';
+export { getLanguage, getStopWords, getTokenizer, hasStopWords, hasTokenizer, registerLanguage, registerStopWords, registerTokenizer } from './chunk-BEIK3EOZ.mjs';
+export { clearNormalizationCache, configureNormalizationCache, getNormalizationCacheSize, resetNormalizationCache } from './chunk-CMVG2UEF.mjs';
+import './chunk-AV4IJKD2.mjs';
 import './chunk-CBLS46IE.mjs';
 import './chunk-TGP5M5R7.mjs';
-import './chunk-HGJC5L65.mjs';
-export { isSimdAvailable } from './chunk-JXHUHFJ5.mjs';
+import './chunk-PMBHH44R.mjs';
+export { isSimdAvailable } from './chunk-X6YZO4MQ.mjs';
+import './chunk-RP23PWMV.mjs';
 import './chunk-KMMJMDUA.mjs';
 import './chunk-U2BKYEC7.mjs';
 import './chunk-2GWVQWGA.mjs';
-import './chunk-RDGXYRF4.mjs';
+import './chunk-WYJXSLER.mjs';
 export { ClientErrorCodes, ErrorCodes, NarsilError, ServerErrorCodes } from './chunk-P4ELXVJQ.mjs';

package/dist/{search-FjWhZN3f.d.ts → memory-Bzd5xcEW.d.ts}

@@ -1,4 +1,4 @@
-import { A as AnyDocument, S as SchemaDefinition, a as ScoringMode } from './schema-B7juWg8Q.js';
+import { A as AnyDocument, S as SchemaDefinition, a as ScoringMode } from './schema-BqRx9t4E.js';
 
 /**
  * Every code a {@link NarsilError} carries, grouped by the part of the engine
@@ -450,83 +450,6 @@ interface SuggestResult {
     /** This turns true when the index's terms came from an older analysis than its language module produces now. */
     analysisStale?: boolean;
 }
-/**
- * Snapshot of V8 heap usage as reported by `process.memoryUsage()`. All values
- * are bytes. `null` in environments that do not expose `process.memoryUsage`,
- * such as browsers.
- *
- * @public
- */
-interface ProcessMemoryReport {
-    /** The process is using this much heap. */
-    heapUsed: number;
-    /** V8 has reserved this much heap. */
-    heapTotal: number;
-    /** The process holds this much outside the heap, such as buffers. */
-    external: number;
-    /** The process occupies this much physical memory in total. */
-    rss: number;
-}
-/**
- * Whether one index holds worker copies at the moment
- * {@link Narsil.getMemoryStats} reads it, and how many times it has loaded
- * them again after giving them up while idle.
- *
- * @public
- */
-interface WorkerCopyReport {
-    /** This names the index. */
-    indexName: string;
-    /** This is true while every worker holds a copy of the index. */
-    scaledOut: boolean;
-    /** The index has loaded its copies again this many times after an idle spell dropped them. */
-    reloadCount: number;
-}
-/**
- * What {@link Narsil.getMemoryStats} returns, which is what you size a host
- * from.
- *
- * @public
- */
-interface MemoryStats {
-    /**
-     * V8 heap usage for the host process at the moment the call was made. This
-     * is process-wide, not engine-wide; if multiple Narsil engines are running
-     * in the same process every engine's `getMemoryStats` returns the same
-     * `process` figures. `null` in browsers and any runtime where
-     * `process.memoryUsage` is unavailable.
-     */
-    process: ProcessMemoryReport | null;
-    /**
-     * Sum of every index's {@link IndexStats.estimatedMemoryBytes} held by this
-     * engine. Formula-based; treat as an estimate, not a measurement. Useful
-     * for cross-engine relative comparisons inside a single process where
-     * `process.heapUsed` cannot tell engines apart.
-     */
-    estimatedIndexBytes: number;
-    /** This many indexes currently occupy engine memory. */
-    openIndexCount: number;
-    /** This many indexes remain registered without occupying engine memory, including parked recovery failures. */
-    closedIndexCount: number;
-    /** This counts successful index loads since this engine started. */
-    reopenCount: number;
-    /** One entry per index, saying whether it holds worker copies now and how many times it has reloaded them. */
-    workerCopies: WorkerCopyReport[];
-    /**
-     * Per-worker V8 heap usage once the engine has started its worker pool.
-     * Empty while no worker is running.
-     */
-    workers: Array<{
-        /** This identifies the worker within the pool. */
-        workerId: number;
-        /** That worker is using this much heap. */
-        heapUsed: number;
-        /** V8 has reserved this much heap in that worker. */
-        heapTotal: number;
-        /** That worker holds this much outside its heap. */
-        external: number;
-    }>;
-}
 /**
  * The state of one vector field, and what maintenance would cost, as
  * {@link Narsil.vectorMaintenanceStatus} reports it.
@@ -541,7 +464,7 @@ interface VectorMaintenanceResult {
     fieldName: string;
     /** Tombstones make up this share of the graph's nodes, from 0 to 1. */
     tombstoneRatio: number;
-    /** The field's HNSW graph holds this many vectors. */
+    /** The field holds this many HNSW graphs: 0 before the first build and 1 once a graph exists. */
     graphCount: number;
     /** This many vectors wait outside the graph, which a search scans one by one. */
     bufferSize: number;
@@ -1064,4 +987,90 @@ interface ListParams {
     document?: DocumentProjection;
 }
 
+/**
+ * Snapshot of V8 heap usage as reported by `process.memoryUsage()`, with the
+ * limit the heap may grow to. All values are bytes. `null` in environments
+ * that do not expose `process.memoryUsage`, such as browsers.
+ *
+ * @public
+ */
+interface ProcessMemoryReport {
+    /** The process is using this much heap. */
+    heapUsed: number;
+    /** V8 has reserved this much heap. */
+    heapTotal: number;
+    /**
+     * The heap may grow to this many bytes before the runtime ends the process
+     * for running out of memory. Node sets it from `--max-old-space-size`, from
+     * `--max-old-space-size-percentage`, or from the memory the host or the
+     * container reports. `null` where the runtime cannot report it.
+     */
+    heapLimit: number | null;
+    /** The process holds this much outside the heap, such as buffers. */
+    external: number;
+    /** The process occupies this much physical memory in total. */
+    rss: number;
+}
+/**
+ * Whether one index holds worker copies at the moment
+ * {@link Narsil.getMemoryStats} reads it, and how many times it has loaded
+ * them again after giving them up while idle.
+ *
+ * @public
+ */
+interface WorkerCopyReport {
+    /** This names the index. */
+    indexName: string;
+    /** This is true while every worker holds a copy of the index. */
+    scaledOut: boolean;
+    /** The index has loaded its copies again this many times after an idle spell dropped them. */
+    reloadCount: number;
+}
+/**
+ * What {@link Narsil.getMemoryStats} returns, which is what you size a host
+ * from.
+ *
+ * @public
+ */
+interface MemoryStats {
+    /**
+     * V8 heap usage for the host process at the moment of the call. It covers
+     * the whole process, so every Narsil engine in one process returns the same
+     * `process` figures from `getMemoryStats`. `null` in browsers and in any
+     * runtime that does not expose `process.memoryUsage`.
+     */
+    process: ProcessMemoryReport | null;
+    /**
+     * The sum of every index's {@link IndexStats.estimatedMemoryBytes} held by
+     * this engine. A formula produces it, so read it as an estimate. It compares
+     * engines inside one process, where `process.heapUsed` cannot tell them
+     * apart.
+     */
+    estimatedIndexBytes: number;
+    /** This many indexes currently occupy engine memory. */
+    openIndexCount: number;
+    /** This many indexes remain registered without occupying engine memory, including parked recovery failures. */
+    closedIndexCount: number;
+    /** This counts successful index loads since this engine started. */
+    reopenCount: number;
+    /** One entry per index, saying whether it holds worker copies now and how many times it has reloaded them. */
+    workerCopies: WorkerCopyReport[];
+    /**
+     * Per-worker V8 heap usage once the engine has started its worker pool.
+     * Empty while no worker is running.
+     */
+    workers: Array<{
+        /** This identifies the worker within the pool. */
+        workerId: number;
+        /** That worker is using this much heap. */
+        heapUsed: number;
+        /** V8 has reserved this much heap in that worker. */
+        heapTotal: number;
+        /** That worker's heap may grow to this many bytes, or `null` where its runtime cannot report it. */
+        heapLimit: number | null;
+        /** That worker holds this much outside its heap. */
+        external: number;
+    }>;
+}
+
 export { type ArrayFilter as A, type BatchResult as B, type ClientErrorCode as C, type DocumentProjection as D, type ErrorCode as E, type FacetConfig as F, type GeoFilter as G, type HighlightConfig as H, type IndexInfo as I, type ScoreComponents as J, type SearchMode as K, type ListParams as L, type MemoryStats as M, NarsilError as N, type SortField as O, type PartitionStatsResult as P, type QueryParams as Q, type SortSpec as R, type ServerErrorCode as S, type StringFilter as T, type TermMatchPolicy as U, type VectorMaintenanceResult as V, type VectorQueryConfig as W, type WorkerCopyReport as X, ClientErrorCodes as a, ErrorCodes as b, type NarsilErrorCode as c, ServerErrorCodes as d, type QueryResult as e, type IndexStats as f, type ListResult as g, type PreflightResult as h, type SuggestParams as i, type SuggestResult as j, type ComparisonFilter as k, type FacetResult as l, type FieldFilter as m, type FilterExpression as n, type GeoPolygonFilter as o, type GeoRadiusFilter as p, type GroupConfig as q, type GroupReducer as r, type GroupResult as s, type HighlightMatch as t, type Hit as u, type HybridConfig as v, type ListedDocument as w, type PresenceFilter as x, type ProcessMemoryReport as y, type QueryCoverage as z };

package/dist/persistence/durability/checkpoint-worker.d.ts

@@ -1,4 +1,4 @@
-import { P as PartitionConfig, a as ScoringMode, V as VectorIndexConfig } from '../../schema-B7juWg8Q.js';
+import { P as PartitionConfig, a as ScoringMode, V as VectorIndexConfig } from '../../schema-BqRx9t4E.js';
 import '../../adapters-79OIa4xm.js';
 
 interface IndexMetadata {

package/dist/persistence/durability/checkpoint-worker.mjs

@@ -1,15 +1,20 @@
-import { createDurableDirectory, writeSegmentedCheckpoint } from '../../chunk-56PJBIJ6.mjs';
+import { createDurableDirectory, writeSegmentedCheckpoint } from '../../chunk-ND34I3SV.mjs';
+import '../../chunk-ZHUQKZBE.mjs';
 import '../../chunk-GCM3JFVA.mjs';
-import '../../chunk-OWCFK42Q.mjs';
-import '../../chunk-M6JGMKA5.mjs';
+import '../../chunk-PIWKZPP7.mjs';
+import '../../chunk-XE6XR2OE.mjs';
+import '../../chunk-BEIK3EOZ.mjs';
+import '../../chunk-CMVG2UEF.mjs';
+import '../../chunk-AV4IJKD2.mjs';
 import '../../chunk-CBLS46IE.mjs';
 import '../../chunk-TGP5M5R7.mjs';
-import '../../chunk-HGJC5L65.mjs';
-import '../../chunk-JXHUHFJ5.mjs';
+import '../../chunk-PMBHH44R.mjs';
+import '../../chunk-X6YZO4MQ.mjs';
+import '../../chunk-RP23PWMV.mjs';
 import '../../chunk-KMMJMDUA.mjs';
 import '../../chunk-U2BKYEC7.mjs';
 import '../../chunk-2GWVQWGA.mjs';
-import '../../chunk-RDGXYRF4.mjs';
+import '../../chunk-WYJXSLER.mjs';
 import '../../chunk-P4ELXVJQ.mjs';
 
 // src/persistence/durability/rebuild.ts

package/dist/react.d.ts

@@ -1,10 +1,10 @@
-import { N as NarsilError, L as ListParams, g as ListResult, I as IndexInfo, f as IndexStats, Q as QueryParams, h as PreflightResult, e as QueryResult, i as SuggestParams, j as SuggestResult } from './search-FjWhZN3f.js';
-export { C as ClientErrorCode, a as ClientErrorCodes, E as ErrorCode, b as ErrorCodes, c as NarsilErrorCode, S as ServerErrorCode, d as ServerErrorCodes } from './search-FjWhZN3f.js';
+import { N as NarsilError, L as ListParams, g as ListResult, I as IndexInfo, f as IndexStats, Q as QueryParams, h as PreflightResult, e as QueryResult, i as SuggestParams, j as SuggestResult } from './memory-Bzd5xcEW.js';
+export { C as ClientErrorCode, a as ClientErrorCodes, E as ErrorCode, b as ErrorCodes, c as NarsilErrorCode, S as ServerErrorCode, d as ServerErrorCodes } from './memory-Bzd5xcEW.js';
 import { e as TaskRecord, d as TaskProgress, b as ImportResult, c as TaskListQuery, T as TaskListPage } from './tasks-Bn4R1NPN.js';
 export { I as ImportError, f as TaskStatus, g as TaskType } from './tasks-Bn4R1NPN.js';
 import { ReactNode, ReactElement } from 'react';
-import { N as NarsilClient, I as ImportSource } from './client-DX7xPcNA.js';
-import { A as AnyDocument } from './schema-B7juWg8Q.js';
+import { N as NarsilClient, I as ImportSource } from './client-CBOVHdjp.js';
+import { A as AnyDocument } from './schema-BqRx9t4E.js';
 import './adapters-79OIa4xm.js';
 
 /**

package/dist/{schema-B7juWg8Q.d.ts → schema-BqRx9t4E.d.ts}

@@ -217,11 +217,30 @@ interface PartitionConfig {
  */
 type ScoringMode = 'local' | 'dfs' | 'broadcast';
 /**
- * Per-write options for {@link Narsil.insert} and {@link Narsil.insertBatch}.
+ * Per-write options every write accepts.
+ *
+ * A write returns once the main copy holds it, and it reaches the worker
+ * copies afterwards, so a query that a copy answers may come back without a
+ * write that returned before it.
+ *
+ * @public
+ */
+interface WriteOptions {
+    /**
+     * Setting this makes the write return only once every worker copy holding
+     * the index has applied it, so the next query sees it whichever copy
+     * answers. Leave it off for a load, and call
+     * {@link DocumentWriteOperations.waitForWrites} once at the end.
+     */
+    wait?: boolean;
+}
+/**
+ * Per-write options for {@link DocumentWriteOperations.insert} and
+ * {@link DocumentWriteOperations.insertBatch}.
  *
  * @public
  */
-interface InsertOptions {
+interface InsertOptions extends WriteOptions {
     /**
      * Setting this stores the document object you passed instead of a copy,
      * which saves a clone on a large load. Changing that object afterwards
@@ -231,4 +250,4 @@ interface InsertOptions {
     skipClone?: boolean;
 }
 
-export type { AnyDocument as A, BM25Params as B, CustomTokenizer as C, EmbeddingFieldConfig as E, FieldType as F, IndexConfig as I, PartitionConfig as P, SchemaDefinition as S, VectorIndexConfig as V, ScoringMode as a, InsertOptions as b, StopWordOverride as c, VectorQuantizationMode as d };
+export type { AnyDocument as A, BM25Params as B, CustomTokenizer as C, EmbeddingFieldConfig as E, FieldType as F, IndexConfig as I, PartitionConfig as P, SchemaDefinition as S, VectorIndexConfig as V, WriteOptions as W, ScoringMode as a, InsertOptions as b, StopWordOverride as c, VectorQuantizationMode as d };

package/dist/server.d.ts

@@ -1,22 +1,60 @@
-import { b as ServerOptions, N as NarsilServer } from './options-Dtk99qUs.js';
-export { A as ASYNC_IMPORT_CAPABILITY, C as CorsOptions, E as ErrorEnvelope, I as INDEX_LIFECYCLE_CAPABILITY, O as OnRequestHook, R as REBUILD_ANALYSIS_CAPABILITY, c as RequestContext, d as RequestDenial, S as SERVER_CAPABILITIES, e as ServerLimits, T as TASK_CANCEL_CAPABILITY, a as TASK_FILTER_CAPABILITY } from './options-Dtk99qUs.js';
-import { a as Narsil } from './engine-CABZg25p.js';
-import { h as TaskStore, e as TaskRecord, d as TaskProgress, b as ImportResult } from './tasks-Bn4R1NPN.js';
+import { b as ServerOptions, N as NarsilServer } from './capabilities-JrVQOwi4.js';
+export { A as ASYNC_IMPORT_CAPABILITY, C as CorsOptions, E as ErrorEnvelope, I as INDEX_LIFECYCLE_CAPABILITY, O as OnRequestHook, R as REBUILD_ANALYSIS_CAPABILITY, c as RequestContext, d as RequestDenial, S as SERVER_CAPABILITIES, e as ServerLimits, T as TASK_CANCEL_CAPABILITY, a as TASK_FILTER_CAPABILITY } from './capabilities-JrVQOwi4.js';
+import { a as Narsil } from './engine-9PtFY50q.js';
+import { d as TaskProgress, b as ImportResult, h as TaskStore, e as TaskRecord } from './tasks-Bn4R1NPN.js';
 export { C as CapabilitiesResponse, a as CreateIndexEmbedding, i as CreateIndexRequest, H as HttpIndexConfig, I as ImportError, T as TaskListPage, c as TaskListQuery, f as TaskStatus, g as TaskType } from './tasks-Bn4R1NPN.js';
-export { d as ServerErrorCodes } from './search-FjWhZN3f.js';
+export { d as ServerErrorCodes } from './memory-Bzd5xcEW.js';
 import './adapters-79OIa4xm.js';
-import './config-B41W23Us.js';
-import './config-Co-zAXqO.js';
-import './schema-B7juWg8Q.js';
-import './types-DsSSjY4d.js';
+import './config-Czh2YNDi.js';
+import './config-OON7IJ_B.js';
+import './schema-BqRx9t4E.js';
+import './types-DXPxaXPO.js';
 import './types-D5OwhtsQ.js';
 
+/**
+ * What a running task reports back while it works, and how it learns that a
+ * cancel arrived.
+ *
+ * @public
+ */
+interface TaskContext {
+    /** Aborts once a cancel arrives, so long-running work can stop between units. */
+    readonly signal: AbortSignal;
+    /**
+     * Records how far the work has gone, which `GET /tasks/{id}` then reports.
+     *
+     * @param progress - The counters as they stand now.
+     */
+    reportProgress(progress: TaskProgress): void;
+    /**
+     * Records what the work produced, which the finished task then carries.
+     *
+     * @param result - What the work produced.
+     */
+    reportResult(result: ImportResult): void;
+}
+/**
+ * The work one task runs.
+ *
+ * Resolving marks the task succeeded. Rejecting marks it failed, unless a
+ * cancel had already arrived, which marks it cancelled instead. Work that
+ * cannot stop early ignores the signal and still finishes.
+ *
+ * @public
+ */
+type TaskOperation = (ctx: TaskContext) => Promise<void>;
+
 /**
  * Wraps a Narsil engine in an HTTP server. The caller builds and owns the engine
  * (durability, embedding, workers) and hands the live instance in; the server
  * shares it across requests and never constructs or shuts it down. Start with
  * `.listen()` and stop with `.close()`; the engine is shut down separately.
  *
+ * On Node.js the server receives requests on the engine's worker threads, which
+ * hold the worker copies. A query on an index that holds copies answers on the
+ * thread that received it, and every write goes to the main thread. Read
+ * {@link NarsilServer.requestThreadCount} for how many threads took requests.
+ *
  * @param engine - The live engine every request runs against.
  * @param options - Address, CORS, request limits, the authentication hook, and
  * the task store. Omit it to bind to loopback with the default limits.
@@ -83,37 +121,4 @@ declare class InMemoryTaskStore implements TaskStore {
     private prune;
 }
 
-/**
- * What a running task reports back while it works, and how it learns that a
- * cancel arrived.
- *
- * @public
- */
-interface TaskContext {
-    /** Aborts once a cancel arrives, so long-running work can stop between units. */
-    readonly signal: AbortSignal;
-    /**
-     * Records how far the work has gone, which `GET /tasks/{id}` then reports.
-     *
-     * @param progress - The counters as they stand now.
-     */
-    reportProgress(progress: TaskProgress): void;
-    /**
-     * Records what the work produced, which the finished task then carries.
-     *
-     * @param result - What the work produced.
-     */
-    reportResult(result: ImportResult): void;
-}
-/**
- * The work one task runs.
- *
- * Resolving marks the task succeeded. Rejecting marks it failed, unless a
- * cancel had already arrived, which marks it cancelled instead. Work that
- * cannot stop early ignores the signal and still finishes.
- *
- * @public
- */
-type TaskOperation = (ctx: TaskContext) => Promise<void>;
-
 export { ImportResult, InMemoryTaskStore, NarsilServer, ServerOptions, type TaskContext, type TaskOperation, TaskProgress, TaskRecord, TaskStore, createServer, httpStatusForNarsilError };