@harperfast/harper 5.3.0-beta.3 → 5.3.0-beta.4

package/dist/resources/indexes/hnswDerivedIndex.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HnswDerivedIndexBackend = exports.MAX_WAIT_FOR_INDEX_MILLISECONDS = exports.DEFAULT_MAX_INDEX_LAG_MILLISECONDS = exports.DERIVED_INDEX_CURSOR_KEY = void 0;
-exports.attachDerivedIndexes = attachDerivedIndexes;
 exports.derivedIndexReadiness = derivedIndexReadiness;
 const hdbError_ts_1 = require("../../utility/errors/hdbError.js");
 const logger_ts_1 = require("../../utility/logging/logger.js");
@@ -17,8 +16,6 @@ const QUEUE_CAPACITY_BYTES = 64 * 1024 * 1024;
 const APPLY_SLICE_MILLIS = 5;
 const BARRIER_IDLE_MULTIPLE = 3;
 const BARRIER_IDLE_CEILING_MILLISECONDS = 7_500;
-// Writes to an index this far behind fail with a retryable 503 (see the runtime's lag policy).
-const DEFAULT_MAX_LAG_MILLISECONDS = 30_000;
 /**
  * `DerivedIndexBackend` over a file-primary HNSW index. `deliver()` only enqueues; an applier drains
  * the queue in bounded time slices so a 4096-record chunk at ~0.35 ms per native insert does not
@@ -238,233 +235,6 @@ class HnswDerivedIndexBackend {
     }
 }
 exports.HnswDerivedIndexBackend = HnswDerivedIndexBackend;
-const runtimes = new WeakMap();
-const retryUnavailableByStore = new Set();
-function retryUnavailableKey(auditStore, backendId) {
-    return `${auditStore.rootStore.path}\0${backendId}`;
-}
-function markUnavailableRetry(registered, auditStore, backendId) {
-    registered.retryUnavailable.add(backendId);
-    retryUnavailableByStore.add(retryUnavailableKey(auditStore, backendId));
-}
-function consumeUnavailableRetry(registered, auditStore, backendId) {
-    const local = registered.retryUnavailable.delete(backendId);
-    const storeScoped = retryUnavailableByStore.delete(retryUnavailableKey(auditStore, backendId));
-    return local || storeScoped;
-}
-function runtimeFor(auditStore) {
-    let registered = runtimes.get(auditStore);
-    if (registered)
-        return registered;
-    const tables = new Map();
-    const runtime = new derivedIndexRuntime_ts_1.DerivedIndexRuntime(auditStore, (tableId, recordId) => {
-        const entry = tables.get(tableId)?.current.Table.primaryStore.getEntry(recordId);
-        return entry?.value == null ? undefined : { version: entry.version, value: entry.value };
-    }, {
-        scanRecords: (tableId) => tables
-            .get(tableId)
-            .current.Table.primaryStore.getRange({ versions: true, snapshot: false })
-            .map(({ key, value, version }) => ({ recordId: key, version, value })),
-    });
-    registered = {
-        runtime,
-        tables,
-        backends: new Map(),
-        tableBackends: new Map(),
-        droppingTables: new Set(),
-        retryUnavailable: new Set(),
-    };
-    runtimes.set(auditStore, registered);
-    return registered;
-}
-const warnedAuditIndexes = new Set();
-/**
- * Register every post-commit custom index of a table with the shared derived-index runtime of its
- * database. Returns the release for the table's registrations, or undefined when it has none. Runs
- * on every worker; the runtime elects one owner per index.
- */
-function attachDerivedIndexes(Table) {
-    const hnswAttributes = Table.attributes.filter((attribute) => attribute.indexed?.type === 'HNSW' && Table.indices[attribute.name]?.customIndex);
-    const attributes = hnswAttributes.filter((attribute) => Table.indices[attribute.name]?.customIndex?.postCommit);
-    if (Table.audit !== true && attributes.length > 0) {
-        throw new hdbError_ts_1.ClientError(`Table '${Table.databaseName}.${Table.tableName}' must enable audit logging before using a post-commit derived index`);
-    }
-    if (!Table.auditStore)
-        return;
-    const auditStore = Table.auditStore;
-    const registered = runtimeFor(auditStore);
-    if (registered.droppingTables.has(Table.tableId))
-        return;
-    for (const attribute of hnswAttributes) {
-        const indexStore = Table.indices[attribute.name];
-        const id = `hnsw:${indexStore.name}`;
-        // A transient JS-backed declaration can precede the first native registration while a
-        // schema is being installed. Only an explicit transition away from an already-registered
-        // native backend should make a later native registration eligible to rearm an exhausted
-        // rebuild budget.
-        if (attribute.indexed.nativePlane === false && !indexStore.customIndex.postCommit && registered.backends.has(id))
-            markUnavailableRetry(registered, auditStore, id);
-    }
-    if (attributes.length === 0)
-        return;
-    const installed = { Table };
-    let registeredTable = registered.tables.get(Table.tableId);
-    if (registeredTable) {
-        registeredTable.owners.add(installed);
-        registeredTable.current = installed;
-    }
-    else {
-        registeredTable = { current: installed, owners: new Set([installed]) };
-        registered.tables.set(Table.tableId, registeredTable);
-    }
-    const releases = [];
-    const backendIds = [];
-    const registeredBackends = new Map();
-    for (const attribute of attributes) {
-        const indexStore = Table.indices[attribute.name];
-        const index = indexStore.customIndex;
-        const id = `hnsw:${indexStore.name}`;
-        const warningKey = `${Table.databaseName}.${Table.tableName}.${indexStore.name}`;
-        if (!warnedAuditIndexes.has(warningKey)) {
-            warnedAuditIndexes.add(warningKey);
-            logger.warn?.(`Derived index ${indexStore.name} requires auditing; the audit API retains full record history for the configured retention window`);
-        }
-        const resolver = Table.propertyResolvers?.[attribute.name];
-        const label = `Vector for attribute "${attribute.name}"`;
-        index.attachDerivedHost({
-            readiness: () => registered.runtime.getReadiness(id),
-            coverage: (maxLagMilliseconds) => (0, derivedIndexRuntime_ts_1.readDerivedIndexCoverage)(auditStore, id, () => indexStore.getSync(exports.DERIVED_INDEX_CURSOR_KEY), maxLagMilliseconds),
-            requestRebuild: () => registered.runtime.requestRebuild(id),
-            waitForCoverage: (since, timeout, signal) => registered.runtime.waitForCoverage(id, since, timeout, signal),
-        });
-        let predecessor = registered.backends.get(id);
-        const inherited = predecessor;
-        const settlePredecessor = () => {
-            const current = predecessor;
-            if (!current)
-                return Promise.resolve();
-            const settled = current.settle();
-            settled.then(() => {
-                if (predecessor === current)
-                    predecessor = undefined;
-            }, () => { });
-            return settled;
-        };
-        const predecessorSettled = settlePredecessor();
-        predecessorSettled.catch(() => { });
-        if (registered.backends.get(id) === inherited)
-            registered.backends.delete(id);
-        const release = registered.runtime.register({
-            backend: new HnswDerivedIndexBackend(id, index),
-            projections: new Map([
-                [
-                    Table.tableId,
-                    (record) => {
-                        const vector = resolver ? resolver(record) : record[attribute.name];
-                        if (vector == null)
-                            return undefined;
-                        index.assertDerivedValue(vector, label);
-                        return vector;
-                    },
-                ],
-            ]),
-            options: { maxLagMilliseconds: attribute.indexed?.maxLagMilliseconds ?? DEFAULT_MAX_LAG_MILLISECONDS },
-        });
-        let settling;
-        const registeredBackend = {
-            tableId: Table.tableId,
-            settle: () => {
-                if (settling)
-                    return settling;
-                const attempt = Promise.allSettled([settlePredecessor(), release()]).then((results) => {
-                    if (results[1].status === 'fulfilled') {
-                        if (registered.backends.get(id) === registeredBackend)
-                            registered.backends.delete(id);
-                        const tableBackends = registered.tableBackends.get(Table.tableId);
-                        tableBackends?.delete(registeredBackend);
-                        if (tableBackends?.size === 0)
-                            registered.tableBackends.delete(Table.tableId);
-                    }
-                    const failures = results
-                        .filter((result) => result.status === 'rejected')
-                        .map((result) => result.reason);
-                    if (failures.length === 1)
-                        throw failures[0];
-                    if (failures.length)
-                        throw new AggregateError(failures, `Could not settle HNSW backend '${id}'`);
-                });
-                settling = attempt;
-                attempt.catch(() => {
-                    if (settling === attempt)
-                        settling = undefined;
-                });
-                return attempt;
-            },
-        };
-        let tableBackends = registered.tableBackends.get(Table.tableId);
-        if (!tableBackends)
-            registered.tableBackends.set(Table.tableId, (tableBackends = new Set()));
-        tableBackends.add(registeredBackend);
-        registered.backends.set(id, registeredBackend);
-        registeredBackends.set(id, registeredBackend);
-        const retryUnavailable = consumeUnavailableRetry(registered, auditStore, id);
-        if (retryUnavailable && registered.runtime.getReadiness(id).state === 'unavailable')
-            registered.runtime.requestRebuild(id);
-        backendIds.push(id);
-        releases.push(() => registeredBackend.settle());
-    }
-    return {
-        async close(dropping = false) {
-            if (dropping)
-                registered.droppingTables.add(Table.tableId);
-            const settlements = dropping
-                ? [...(registered.tableBackends.get(Table.tableId) ?? [])].map((backend) => backend.settle())
-                : releases.map((release) => release());
-            const tableRegistration = registered.tables.get(Table.tableId);
-            if (tableRegistration) {
-                tableRegistration.owners.delete(installed);
-                if (tableRegistration.owners.size === 0) {
-                    registered.tables.delete(Table.tableId);
-                }
-                else if (tableRegistration.current === installed) {
-                    tableRegistration.current = tableRegistration.owners.values().next().value;
-                }
-            }
-            if (dropping) {
-                await Promise.all(settlements);
-            }
-            else {
-                for (const result of await Promise.allSettled(settlements)) {
-                    if (result.status === 'rejected')
-                        logger.error(`Could not settle a superseded HNSW backend for table ${Table.tableId}`, result.reason);
-                }
-            }
-        },
-        restoreAfterFailedDrop() {
-            registered.droppingTables.delete(Table.tableId);
-            const currentTable = registered.tables.get(Table.tableId)?.current.Table;
-            if (currentTable && currentTable !== Table)
-                return;
-            for (const registration of registered.tables.values()) {
-                const current = registration.current.Table;
-                if (current !== Table && current.databasePath === Table.databasePath && current.tableName === Table.tableName)
-                    return;
-            }
-            for (const [id, registeredBackend] of registeredBackends) {
-                const current = registered.backends.get(id);
-                if (current && current !== registeredBackend)
-                    return;
-            }
-            return attachDerivedIndexes(Table);
-        },
-        completeDrop(dropped = true) {
-            registered.droppingTables.delete(Table.tableId);
-            if (dropped)
-                for (const id of backendIds)
-                    markUnavailableRetry(registered, auditStore, id);
-        },
-    };
-}
 /** Shared readiness of an index on any worker, registered or not. */
 function derivedIndexReadiness(auditStore, indexStoreName) {
     return (0, derivedIndexRuntime_ts_1.readDerivedIndexReadiness)(auditStore, `hnsw:${indexStoreName}`);

package/dist/resources/indexes/hnswDerivedIndex.js.map

@@ -1 +1 @@
-{"version":3,"file":"hnswDerivedIndex.js","sourceRoot":"","sources":["../../../resources/indexes/hnswDerivedIndex.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hnswDerivedIndex.js","sourceRoot":"","sources":["../../../resources/indexes/hnswDerivedIndex.ts"],"names":[],"mappings":"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"}

package/dist/resources/indexes/nativeFullTextDerivedIndexLifecycle.d.ts

@@ -8,6 +8,7 @@ export type NativeFullTextDerivedIndexLifecycleOptions = NativeFullTextIndexConf
     binding?: NativeFullTextModule | (() => Promise<NativeFullTextModule>);
 };
 export type NativeFullTextDerivedIndexBackendOptions = Omit<FullTextDerivedIndexBackendOptions, 'lifecycle'> & Omit<NativeFullTextDerivedIndexLifecycleOptions, 'indexId'>;
+export type RetireNativeFullTextDerivedIndexStorageOptions = Pick<NativeFullTextDerivedIndexLifecycleOptions, 'storePath' | 'storeName' | 'indexId' | 'binding'>;
 export declare class NativeFullTextDerivedIndexLifecycle {
     #private;
     constructor(options: NativeFullTextDerivedIndexLifecycleOptions);
@@ -21,4 +22,6 @@ export declare class NativeFullTextDerivedIndexLifecycle {
     open(): Promise<FullTextDerivedIndexEngine>;
     reset(): Promise<void>;
 }
+/** Retire one quiesced native directory after its Harper declaration or table is removed. */
+export declare function retireNativeFullTextDerivedIndexStorage(options: RetireNativeFullTextDerivedIndexStorageOptions): Promise<void>;
 export declare function createNativeFullTextDerivedIndexBackend(options: NativeFullTextDerivedIndexBackendOptions): Promise<FullTextDerivedIndexBackend>;

package/dist/resources/indexes/nativeFullTextDerivedIndexLifecycle.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NativeFullTextDerivedIndexLifecycle = void 0;
+exports.retireNativeFullTextDerivedIndexStorage = retireNativeFullTextDerivedIndexStorage;
 exports.createNativeFullTextDerivedIndexBackend = createNativeFullTextDerivedIndexBackend;
 const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const logger_ts_1 = require("../../utility/logging/logger.js");
 const fullTextDerivedIndex_ts_1 = require("./fullTextDerivedIndex.js");
@@ -30,7 +32,7 @@ class NativeFullTextDerivedIndexLifecycle {
             limits: { ...options.limits },
         };
         // Hashing bounds filenames for arbitrary store names; the index id remains in native metadata and logs.
-        this.#path = (0, node_path_1.join)((0, node_path_1.resolve)(options.storePath), `${digest(options.storeName)}.fulltext`);
+        this.#path = nativeFullTextIndexPath(options.storePath, options.storeName);
         this.#generation = digest(options.sourceGeneration);
     }
     get path() {
@@ -106,10 +108,7 @@ class NativeFullTextDerivedIndexLifecycle {
     async #getBinding() {
         if (this.#binding)
             return this.#binding;
-        const configured = this.#options.binding;
-        this.#binding = configured
-            ? await (0, fullTextNativeBinding_ts_1.validateFullTextNativeBinding)(typeof configured === 'function' ? await configured() : configured)
-            : await (0, fullTextNativeBinding_ts_1.loadFullTextNativeBinding)();
+        this.#binding = await resolveNativeFullTextBinding(this.#options.binding);
         return this.#binding;
     }
     #requireBinding() {
@@ -119,14 +118,56 @@ class NativeFullTextDerivedIndexLifecycle {
     }
 }
 exports.NativeFullTextDerivedIndexLifecycle = NativeFullTextDerivedIndexLifecycle;
+/** Retire one quiesced native directory after its Harper declaration or table is removed. */
+async function retireNativeFullTextDerivedIndexStorage(options) {
+    if (!(0, node_path_1.isAbsolute)(options.storePath))
+        throw new TypeError('Full-text storePath must be absolute');
+    if (!options.storeName)
+        throw new TypeError('Full-text storeName is required');
+    if (!options.indexId)
+        throw new TypeError('Full-text indexId is required');
+    const path = nativeFullTextIndexPath(options.storePath, options.storeName);
+    if (!(0, node_fs_1.existsSync)(path)) {
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)((0, node_path_1.dirname)(path), '.fulltext-retired'))) {
+            try {
+                const binding = await resolveNativeFullTextBinding(options.binding);
+                const reclaimed = await binding.reclaimRetiredNativeFullTextIndexes({ path });
+                if (reclaimed.failed > 0)
+                    logWarning(`Could not remove ${reclaimed.failed} retired paths for full-text index '${options.indexId}'`);
+            }
+            catch (error) {
+                logWarning(`Could not reclaim retired storage for full-text index '${options.indexId}'`, error);
+            }
+        }
+        return;
+    }
+    const binding = await resolveNativeFullTextBinding(options.binding);
+    // The wrapper owns the physical lifecycle fence: reset refuses an active/unproven writer and
+    // takes Tantivy's writer lock before renaming. Harper treats that refusal as best-effort cleanup,
+    // never as permission to remove a live directory itself.
+    const result = await binding.resetNativeFullTextIndex({ path, indexId: options.indexId });
+    void binding
+        .reclaimRetiredNativeFullTextIndexes({
+        path,
+        retiredPath: result.state === 'reset' ? result.retiredPath : undefined,
+    })
+        .then((reclaimed) => {
+        if (reclaimed.failed > 0)
+            logWarning(`Could not remove ${reclaimed.failed} retired paths for full-text index '${options.indexId}'`);
+    })
+        .catch((error) => logWarning(`Could not reclaim retired storage for full-text index '${options.indexId}'`, error));
+}
 async function createNativeFullTextDerivedIndexBackend(options) {
-    const maxCursorPayloadBytes = options.maxCursorPayloadBytes ?? fullTextDerivedIndex_ts_1.HARPER_FULLTEXT_MAX_CURSOR_PAYLOAD_BYTES;
-    if (maxCursorPayloadBytes > fullTextDerivedIndex_ts_1.HARPER_FULLTEXT_MAX_CURSOR_PAYLOAD_BYTES)
+    const configuredMaxCursorPayloadBytes = options.maxCursorPayloadBytes;
+    if (configuredMaxCursorPayloadBytes !== undefined &&
+        configuredMaxCursorPayloadBytes > fullTextDerivedIndex_ts_1.HARPER_FULLTEXT_MAX_CURSOR_PAYLOAD_BYTES)
         throw new RangeError(`Full-text maxCursorPayloadBytes must not exceed ${fullTextDerivedIndex_ts_1.HARPER_FULLTEXT_MAX_CURSOR_PAYLOAD_BYTES}`);
     const lifecycle = new NativeFullTextDerivedIndexLifecycle({ ...options, indexId: options.id });
     await lifecycle.initialize({ reclaimRetired: false });
-    if (maxCursorPayloadBytes > lifecycle.maxCommitPayloadBytes)
+    if (configuredMaxCursorPayloadBytes !== undefined &&
+        configuredMaxCursorPayloadBytes > lifecycle.maxCommitPayloadBytes)
         throw new RangeError('Full-text maxCursorPayloadBytes exceeds the native commit payload capacity');
+    const maxCursorPayloadBytes = Math.min(configuredMaxCursorPayloadBytes ?? fullTextDerivedIndex_ts_1.HARPER_FULLTEXT_MAX_CURSOR_PAYLOAD_BYTES, lifecycle.maxCommitPayloadBytes);
     const backend = new fullTextDerivedIndex_ts_1.FullTextDerivedIndexBackend({
         ...options,
         id: options.id,
@@ -136,6 +177,14 @@ async function createNativeFullTextDerivedIndexBackend(options) {
     lifecycle.startRetiredStorageReclamation();
     return backend;
 }
+function nativeFullTextIndexPath(storePath, storeName) {
+    return (0, node_path_1.join)((0, node_path_1.resolve)(storePath), `${digest(storeName)}.fulltext`);
+}
+async function resolveNativeFullTextBinding(configured) {
+    return configured
+        ? (0, fullTextNativeBinding_ts_1.validateFullTextNativeBinding)(typeof configured === 'function' ? await configured() : configured)
+        : (0, fullTextNativeBinding_ts_1.loadFullTextNativeBinding)();
+}
 function digest(value) {
     return (0, node_crypto_1.createHash)('sha256').update(value).digest('hex');
 }

package/dist/resources/indexes/nativeFullTextDerivedIndexLifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"nativeFullTextDerivedIndexLifecycle.js","sourceRoot":"","sources":["../../../resources/indexes/nativeFullTextDerivedIndexLifecycle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"nativeFullTextDerivedIndexLifecycle.js","sourceRoot":"","sources":["../../../resources/indexes/nativeFullTextDerivedIndexLifecycle.ts"],"names":[],"mappings":"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"}

package/dist/resources/models/Models.d.ts

@@ -1,6 +1,7 @@
 import { type ModelCallAnalyticsWriter } from './analyticsTable.ts';
 import { ServerError } from '../../utility/errors/hdbError.ts';
-import type { Capability, DefineBackendSpec, EmbedOpts, GenerateChunk, GenerateInput, GenerateOpts, GenerateResult, ModelBackend, ModelRouter, Models as ModelsContract, TokenUsage } from './types.ts';
+import { type DecisionStore } from './decisionStore.ts';
+import type { ModelCapabilities, Capability, ChoiceScores, DecideInput, DecideOpts, RecordedDecideOpts, RecordedDecision, Decision, DecisionRecord, DecisionSchema, DefineBackendSpec, EmbedOpts, GenerateChunk, GenerateInput, GenerateOpts, GenerateResult, ModelBackend, ModelKind, ModelRouter, Models as ModelsContract, ScoreChoicesOpts, OutcomeReport, TokenUsage } from './types.ts';
 type MetricEmitter = (value: number, metric: string, path?: string) => void;
 /**
  * Process-wide singleton. One shared instance serves all Scopes — `scope.models`,
@@ -20,7 +21,7 @@ type MetricEmitter = (value: number, metric: string, path?: string) => void;
  */
 export declare class Models implements ModelsContract {
     #private;
-    constructor(analyticsWriter?: ModelCallAnalyticsWriter, metricEmitter?: MetricEmitter);
+    constructor(analyticsWriter?: ModelCallAnalyticsWriter, metricEmitter?: MetricEmitter, decisionStore?: DecisionStore);
     /**
      * Register a custom backend under a logical id (e.g. `'local:bge-small'`),
      * then select it per call with `opts.model`. The public path for components
@@ -28,7 +29,7 @@ export declare class Models implements ModelsContract {
      * `models.defineBackend` to build the backend from a few methods. Namespaced
      * under `models` (`scope.models.registerBackend(...)`), not a generic global. See #1325.
      */
-    registerBackend(kind: 'embedding' | 'generative', id: string, backend: ModelBackend): void;
+    registerBackend(kind: ModelKind, id: string, backend: ModelBackend): void;
     /**
      * Build a `ModelBackend` from a small spec — supply only the methods your
      * backend implements and `capabilities()` is derived. Pair with
@@ -55,7 +56,29 @@ export declare class Models implements ModelsContract {
     }>;
     generate(input: GenerateInput, opts?: GenerateOpts): Promise<GenerateResult>;
     generateStream(input: GenerateInput, opts?: GenerateOpts): AsyncIterable<GenerateChunk>;
+    /**
+     * Choose from the closed set `schema` defines, with the distribution over it. A malformed schema or
+     * state rejects before routing, with no analytics row: nothing was called. With `persist: true` the
+     * record is committed before the decision is returned: a read-only node rejects before routing, and a
+     * commit failure rejects without another candidate, so a storage fault never bills a second model
+     * call. Without it nothing is stored and no `id` is returned, so any node can decide.
+     */
+    decide<T = unknown>(state: DecideInput, schema: DecisionSchema, opts: RecordedDecideOpts): Promise<RecordedDecision<T>>;
+    decide<T = unknown>(state: DecideInput, schema: DecisionSchema, opts?: DecideOpts): Promise<Decision<T>>;
+    /**
+     * Score `choices` as answers to `input` with a generative backend that implements
+     * `scoreChoices` (#2838): the decision adapter's likelihood path. Routes `generative` with
+     * `scoreChoices` required, tries candidates like `embed`, and records one `scoreChoices` row
+     * per attempt; a `ChoiceScoringUnsupportedError` is recorded as `scoring_unsupported` with the
+     * usage it consumed. Internal, like `embedWithUsage`: not part of the stable models API.
+     */
+    scoreChoices(input: GenerateInput, choices: readonly string[], opts?: ScoreChoicesOpts): Promise<ChoiceScores & {
+        usage?: TokenUsage;
+    }>;
+    getDecision<T = unknown>(id: string): Promise<DecisionRecord<T> | undefined>;
+    recordOutcome<T = unknown>(id: string, outcome: OutcomeReport): Promise<DecisionRecord<T>>;
 }
+export declare function scoringLimit(caps: ModelCapabilities | undefined): number | undefined;
 export declare class ModelCapabilityError extends ServerError {
     constructor(backendName: string, capability: Capability);
 }