@harperfast/harper 5.0.30 → 5.1.0-beta.2

package/dist/resources/models/agentLoop.js.map

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

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

@@ -0,0 +1,65 @@
+/**
+ * One row in `hdb_model_calls`. Field names are snake_case to match the table
+ * schema. Numeric token counts are optional because not every backend reports
+ * every metric.
+ */
+export interface ModelCallRecord {
+    tenant?: string;
+    app?: string;
+    model?: string;
+    backend: string;
+    method: 'embed' | 'generate' | 'generateStream';
+    adapter?: string;
+    conversation_id?: string;
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    embedding_tokens?: number;
+    gpu_ms?: number;
+    latency_ms: number;
+    success: boolean;
+    /** Sanitized code (e.g. 'backend_error', 'aborted', 'capability_unsupported'). Never a raw upstream message. */
+    error_code?: string;
+}
+/**
+ * Lazy-getter for `hdb_model_calls`. Matches the convention used by
+ * `getRawAnalyticsTable()` / `getAnalyticsTable()` in
+ * `resources/analytics/write.ts:656-700` and the system-table declarations in
+ * `server/DurableSubscriptionsSession.ts:14-50`.
+ */
+export declare function getModelCallsTable(): any;
+export interface ModelCallAnalyticsWriterOpts {
+    /** Default 10s. Buffer is flushed at this cadence regardless of size. */
+    flushIntervalMs?: number;
+    /** Default 1000. Reaching this size triggers an out-of-cadence flush. */
+    maxBufferSize?: number;
+    /** Default 1h. How often `cleanup()` runs to remove expired rows. */
+    cleanupIntervalMs?: number;
+    /** Default 90d. Rows older than this are removed by `cleanup()`. */
+    retentionMs?: number;
+    /** Override the table accessor. Tests inject a mock to avoid touching real LMDB. */
+    getTable?: () => any;
+}
+/**
+ * In-memory buffered writer for per-call model analytics. Rows are batched and
+ * flushed periodically (or when the buffer is full) to keep the analytics path
+ * off the hot model-call path. Shape mirrors the pattern in
+ * `resources/analytics/write.ts` but writes per-call rows rather than
+ * aggregating counters.
+ *
+ * The intervals are `.unref()`ed so they never hold the process open during
+ * shutdown; rows buffered at shutdown are dropped (best-effort, same posture
+ * as the existing analytics writer).
+ */
+export declare class ModelCallAnalyticsWriter {
+    #private;
+    constructor(opts?: ModelCallAnalyticsWriterOpts);
+    write(record: ModelCallRecord): void;
+    flush(): Promise<void>;
+    cleanup(): Promise<void>;
+    /** Stop the periodic timers. After stop, `write()` is a no-op and `flush()` still works. */
+    stop(): void;
+    /** Test-only: inspect current buffer size without flushing. */
+    get bufferSize(): number;
+}
+/** Process-wide singleton writer. Constructed on first access. */
+export declare function getModelCallAnalyticsWriter(): ModelCallAnalyticsWriter;

package/dist/resources/models/analyticsTable.js

@@ -0,0 +1,166 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelCallAnalyticsWriter = void 0;
+exports.getModelCallsTable = getModelCallsTable;
+exports.getModelCallAnalyticsWriter = getModelCallAnalyticsWriter;
+const databases_ts_1 = require("../databases.js");
+const commonUtility_ts_1 = require("../../utility/lmdb/commonUtility.js");
+const harper_logger_ts_1 = __importDefault(require("../../utility/logging/harper_logger.js"));
+const log = harper_logger_ts_1.default.forComponent('models').conditional;
+const DEFAULT_FLUSH_INTERVAL_MS = 10_000; // 10s
+const DEFAULT_MAX_BUFFER_SIZE = 1000;
+const DEFAULT_CLEANUP_INTERVAL_MS = 60 * 60 * 1000; // 1h
+// 90-day default tuned for billing windows. Operator-tunable config key will land
+// in Phase 2 alongside the YAML→registry bootstrapper (Harper's `getConfigValue`
+// only reads keys registered in `CONFIG_PARAM_MAP`, so we defer config plumbing
+// until the first real backend ships and the key has a documented owner).
+const DEFAULT_RETENTION_MS = 90 * 24 * 60 * 60 * 1000;
+let _table;
+/**
+ * Lazy-getter for `hdb_model_calls`. Matches the convention used by
+ * `getRawAnalyticsTable()` / `getAnalyticsTable()` in
+ * `resources/analytics/write.ts:656-700` and the system-table declarations in
+ * `server/DurableSubscriptionsSession.ts:14-50`.
+ */
+function getModelCallsTable() {
+    if (_table)
+        return _table;
+    _table = (0, databases_ts_1.table)({
+        table: 'hdb_model_calls',
+        database: 'system',
+        audit: true,
+        trackDeletes: false,
+        attributes: [
+            { name: 'id', isPrimaryKey: true },
+            { name: 'tenant', type: 'string', indexed: true },
+            { name: 'app', type: 'string', indexed: true },
+            { name: 'model', type: 'string', indexed: true },
+            { name: 'backend', type: 'string', indexed: true },
+            { name: 'method', type: 'string', indexed: true },
+            { name: 'adapter', type: 'string', indexed: true },
+            { name: 'conversation_id', type: 'string', indexed: true },
+            { name: 'prompt_tokens', type: 'number' },
+            { name: 'completion_tokens', type: 'number' },
+            { name: 'embedding_tokens', type: 'number' },
+            { name: 'gpu_ms', type: 'number' },
+            { name: 'latency_ms', type: 'number', indexed: true },
+            { name: 'success', type: 'boolean', indexed: true },
+            { name: 'error_code', type: 'string' },
+        ],
+    });
+    return _table;
+}
+/**
+ * In-memory buffered writer for per-call model analytics. Rows are batched and
+ * flushed periodically (or when the buffer is full) to keep the analytics path
+ * off the hot model-call path. Shape mirrors the pattern in
+ * `resources/analytics/write.ts` but writes per-call rows rather than
+ * aggregating counters.
+ *
+ * The intervals are `.unref()`ed so they never hold the process open during
+ * shutdown; rows buffered at shutdown are dropped (best-effort, same posture
+ * as the existing analytics writer).
+ */
+class ModelCallAnalyticsWriter {
+    #buffer = [];
+    #flushTimer;
+    #cleanupTimer;
+    #maxBufferSize;
+    #retentionMs;
+    #getTable;
+    #stopped = false;
+    constructor(opts = {}) {
+        const flushIntervalMs = opts.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS;
+        const cleanupIntervalMs = opts.cleanupIntervalMs ?? DEFAULT_CLEANUP_INTERVAL_MS;
+        this.#maxBufferSize = opts.maxBufferSize ?? DEFAULT_MAX_BUFFER_SIZE;
+        this.#retentionMs = opts.retentionMs ?? DEFAULT_RETENTION_MS;
+        this.#getTable = opts.getTable ?? getModelCallsTable;
+        this.#flushTimer = setInterval(() => {
+            this.flush().catch((err) => log.warn?.(`Model-call analytics flush failed: ${err?.message ?? err}`));
+        }, flushIntervalMs);
+        this.#flushTimer.unref?.();
+        this.#cleanupTimer = setInterval(() => {
+            this.cleanup().catch((err) => log.warn?.(`Model-call analytics cleanup failed: ${err?.message ?? err}`));
+        }, cleanupIntervalMs);
+        this.#cleanupTimer.unref?.();
+    }
+    write(record) {
+        if (this.#stopped)
+            return;
+        // id last so a record that accidentally carries an `id` field can't override
+        // the monotonic primary key.
+        this.#buffer.push({ ...record, id: (0, commonUtility_ts_1.getNextMonotonicTime)() });
+        if (this.#buffer.length >= this.#maxBufferSize) {
+            // Out-of-cadence flush; swallow errors so a failing flush doesn't escape into the caller.
+            this.flush().catch((err) => log.warn?.(`Model-call analytics flush failed: ${err?.message ?? err}`));
+        }
+    }
+    async flush() {
+        if (this.#buffer.length === 0)
+            return;
+        // Read-only nodes (followers, recovery mode) shouldn't accumulate doomed writes —
+        // drop the buffer and skip. Matches `resources/analytics/write.ts:643-650`.
+        if ((0, databases_ts_1.isReadOnlyMode)()) {
+            this.#buffer = [];
+            return;
+        }
+        const batch = this.#buffer;
+        this.#buffer = [];
+        const tbl = this.#getTable();
+        const puts = [];
+        for (const record of batch) {
+            try {
+                const result = tbl.primaryStore.put(record.id, record);
+                if (result && typeof result.then === 'function') {
+                    puts.push({ id: record.id, promise: result });
+                }
+            }
+            catch (err) {
+                log.warn?.(`Model-call analytics put failed for id=${record.id}: ${err?.message ?? err}`);
+            }
+        }
+        if (puts.length > 0) {
+            const results = await Promise.allSettled(puts.map((p) => p.promise));
+            for (let i = 0; i < results.length; i++) {
+                const r = results[i];
+                if (r.status === 'rejected') {
+                    const reason = r.reason;
+                    log.warn?.(`Model-call analytics async put failed for id=${puts[i].id}: ${reason?.message ?? r.reason}`);
+                }
+            }
+        }
+    }
+    async cleanup() {
+        if ((0, databases_ts_1.isReadOnlyMode)())
+            return;
+        const end = Date.now() - this.#retentionMs;
+        const tbl = this.#getTable();
+        for (const key of tbl.primaryStore.getKeys({ start: false, end })) {
+            tbl.primaryStore.remove(key);
+        }
+    }
+    /** Stop the periodic timers. After stop, `write()` is a no-op and `flush()` still works. */
+    stop() {
+        this.#stopped = true;
+        if (this.#flushTimer)
+            clearInterval(this.#flushTimer);
+        if (this.#cleanupTimer)
+            clearInterval(this.#cleanupTimer);
+    }
+    /** Test-only: inspect current buffer size without flushing. */
+    get bufferSize() {
+        return this.#buffer.length;
+    }
+}
+exports.ModelCallAnalyticsWriter = ModelCallAnalyticsWriter;
+let _writer;
+/** Process-wide singleton writer. Constructed on first access. */
+function getModelCallAnalyticsWriter() {
+    if (!_writer)
+        _writer = new ModelCallAnalyticsWriter();
+    return _writer;
+}
+//# sourceMappingURL=analyticsTable.js.map

package/dist/resources/models/analyticsTable.js.map

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

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

@@ -0,0 +1,57 @@
+import type { TokenUsage } from './types.ts';
+/** Constructor signature for backend-specific error classes. */
+export type BackendErrorCtor = new (message: string) => Error;
+/**
+ * Combine a caller-supplied AbortSignal with a per-call timeout via
+ * `AbortSignal.any`. Returns the caller signal directly when no timeout is
+ * configured; the timeout signal alone when no caller signal exists; a
+ * composed signal when both apply.
+ */
+export declare function composeSignal(caller?: AbortSignal, timeoutMs?: number): AbortSignal | undefined;
+/**
+ * Write a token count to `usage` only when the value is a finite, non-negative
+ * integer. Drops `NaN`, `Infinity`, negatives, and non-integers silently —
+ * upstream-supplied bad counts would otherwise poison aggregates over
+ * `hdb_model_calls` (`SUM(prompt_tokens)` returns `NaN` for the whole window
+ * if any row carries `NaN`).
+ */
+export declare function assignFiniteTokenCount(usage: TokenUsage, key: 'promptTokens' | 'completionTokens' | 'embeddingTokens', value: unknown): void;
+/**
+ * Read a JSON response body and throw the backend's error class on parse
+ * failure rather than leaking the raw `SyntaxError` (whose message can
+ * include upstream-derived bytes). Matches the sanitization posture from
+ * `analyticsTable.ts:35` ("Sanitized code (...). Never a raw upstream
+ * message.").
+ */
+export declare function parseJsonResponse<T>(res: Response, endpoint: string, Err: BackendErrorCtor): Promise<T>;
+/**
+ * Assert that a model name was specified — either via `opts.model` (per-call
+ * override) or the backend's configured default.
+ */
+export declare function requireModel(model: string | undefined, op: string, Err: BackendErrorCtor): asserts model is string;
+/**
+ * Validate a configured credential field (typically `apiKey`):
+ * - must be present and non-empty
+ * - must NOT be a literal `${VAR_NAME}` placeholder that survived because the
+ *   env var was unset at boot (the `bootstrap.ts` expansion runs through
+ *   `expandEnvVarsDeep`, but unresolved placeholders pass through unchanged)
+ *
+ * Returns the validated value or throws. The `backendLabel` prefixes the
+ * error message so operators see which backend's config failed.
+ */
+export declare function requireCredential(value: string | undefined, backendLabel: string, fieldName: string, Err: BackendErrorCtor): string;
+/**
+ * Normalize a config-supplied host/origin into a fully-qualified base URL.
+ *
+ * - Falls back to `defaults.host` when value is empty
+ * - Prepends `http://` or `https://` (per `defaults.secure`) when no scheme present
+ * - Strips trailing slashes so callers can `${origin}${path}` cleanly
+ *
+ * Backend-specific behavior collapses to choosing the right `defaults`:
+ * Ollama → `{ host: 'localhost:11434', secure: false }`; OpenAI →
+ * `{ host: 'api.openai.com/v1', secure: true }`; etc.
+ */
+export declare function normalizeOrigin(value: string | undefined, defaults: {
+    host: string;
+    secure: boolean;
+}): string;

package/dist/resources/models/backendHelpers.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.composeSignal = composeSignal;
+exports.assignFiniteTokenCount = assignFiniteTokenCount;
+exports.parseJsonResponse = parseJsonResponse;
+exports.requireModel = requireModel;
+exports.requireCredential = requireCredential;
+exports.normalizeOrigin = normalizeOrigin;
+/**
+ * Shared helpers for `ModelBackend` implementations.
+ *
+ * Phase 6 of #510 extracted these from the ollama and openai backends after
+ * landing the openai PR — Kris flagged the similarity, and with anthropic +
+ * bedrock adding a third and fourth use the duplication crossed the
+ * "extract" threshold.
+ *
+ * Each helper is provider-agnostic; backend-specific error classes are passed
+ * in via a constructor type so the thrown errors carry the backend's name
+ * for `instanceof` matching in tests.
+ */
+const expandEnvVar_ts_1 = require("../../utility/expandEnvVar.js");
+/**
+ * Combine a caller-supplied AbortSignal with a per-call timeout via
+ * `AbortSignal.any`. Returns the caller signal directly when no timeout is
+ * configured; the timeout signal alone when no caller signal exists; a
+ * composed signal when both apply.
+ */
+function composeSignal(caller, timeoutMs) {
+    if (!timeoutMs)
+        return caller;
+    const timeout = AbortSignal.timeout(timeoutMs);
+    if (!caller)
+        return timeout;
+    return AbortSignal.any([caller, timeout]);
+}
+/**
+ * Write a token count to `usage` only when the value is a finite, non-negative
+ * integer. Drops `NaN`, `Infinity`, negatives, and non-integers silently —
+ * upstream-supplied bad counts would otherwise poison aggregates over
+ * `hdb_model_calls` (`SUM(prompt_tokens)` returns `NaN` for the whole window
+ * if any row carries `NaN`).
+ */
+function assignFiniteTokenCount(usage, key, value) {
+    if (typeof value !== 'number')
+        return;
+    if (!Number.isFinite(value) || value < 0 || !Number.isInteger(value))
+        return;
+    usage[key] = value;
+}
+/**
+ * Read a JSON response body and throw the backend's error class on parse
+ * failure rather than leaking the raw `SyntaxError` (whose message can
+ * include upstream-derived bytes). Matches the sanitization posture from
+ * `analyticsTable.ts:35` ("Sanitized code (...). Never a raw upstream
+ * message.").
+ */
+async function parseJsonResponse(res, endpoint, Err) {
+    try {
+        return (await res.json());
+    }
+    catch {
+        throw new Err(`${endpoint} returned a non-JSON response body`);
+    }
+}
+/**
+ * Assert that a model name was specified — either via `opts.model` (per-call
+ * override) or the backend's configured default.
+ */
+function requireModel(model, op, Err) {
+    if (!model) {
+        throw new Err(`No model specified for ${op}; set 'model' in config or pass opts.model`);
+    }
+}
+/**
+ * Validate a configured credential field (typically `apiKey`):
+ * - must be present and non-empty
+ * - must NOT be a literal `${VAR_NAME}` placeholder that survived because the
+ *   env var was unset at boot (the `bootstrap.ts` expansion runs through
+ *   `expandEnvVarsDeep`, but unresolved placeholders pass through unchanged)
+ *
+ * Returns the validated value or throws. The `backendLabel` prefixes the
+ * error message so operators see which backend's config failed.
+ */
+function requireCredential(value, backendLabel, fieldName, Err) {
+    if (!value || value.length === 0) {
+        throw new Err(`${backendLabel} backend requires ${fieldName}`);
+    }
+    if ((0, expandEnvVar_ts_1.isUnresolvedEnvVarPlaceholder)(value)) {
+        throw new Err(`${backendLabel} ${fieldName} is the literal placeholder ${value}; set the matching env var before starting Harper`);
+    }
+    return value;
+}
+/**
+ * Normalize a config-supplied host/origin into a fully-qualified base URL.
+ *
+ * - Falls back to `defaults.host` when value is empty
+ * - Prepends `http://` or `https://` (per `defaults.secure`) when no scheme present
+ * - Strips trailing slashes so callers can `${origin}${path}` cleanly
+ *
+ * Backend-specific behavior collapses to choosing the right `defaults`:
+ * Ollama → `{ host: 'localhost:11434', secure: false }`; OpenAI →
+ * `{ host: 'api.openai.com/v1', secure: true }`; etc.
+ */
+function normalizeOrigin(value, defaults) {
+    const v = value?.trim() || defaults.host;
+    const withScheme = /^https?:\/\//i.test(v) ? v : (defaults.secure ? 'https://' : 'http://') + v;
+    return withScheme.replace(/\/+$/, '');
+}
+//# sourceMappingURL=backendHelpers.js.map

package/dist/resources/models/backendHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backendHelpers.js","sourceRoot":"","sources":["../../../resources/models/backendHelpers.ts"],"names":[],"mappings":";;AAwBA,sCAKC;AASD,wDAQC;AASD,8CAMC;AAMD,oCAIC;AAYD,8CAeC;AAaD,0CAIC;AAnHD;;;;;;;;;;;GAWG;AACH,mEAA8E;AAM9E;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,MAAoB,EAAE,SAAkB;IACrE,IAAI,CAAC,SAAS;QAAE,OAAO,MAAM,CAAC;IAC9B,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC;IAC5B,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,sBAAsB,CACrC,KAAiB,EACjB,GAA4D,EAC5D,KAAc;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO;IACtC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO;IAC7E,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AACpB,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,iBAAiB,CAAI,GAAa,EAAE,QAAgB,EAAE,GAAqB;IAChG,IAAI,CAAC;QACJ,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACR,MAAM,IAAI,GAAG,CAAC,GAAG,QAAQ,oCAAoC,CAAC,CAAC;IAChE,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY,CAAC,KAAyB,EAAE,EAAU,EAAE,GAAqB;IACxF,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,CAAC,0BAA0B,EAAE,4CAA4C,CAAC,CAAC;IACzF,CAAC;AACF,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,iBAAiB,CAChC,KAAyB,EACzB,YAAoB,EACpB,SAAiB,EACjB,GAAqB;IAErB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,CAAC,GAAG,YAAY,qBAAqB,SAAS,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,IAAA,+CAA6B,EAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,CACZ,GAAG,YAAY,IAAI,SAAS,+BAA+B,KAAK,mDAAmD,CACnH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,eAAe,CAAC,KAAyB,EAAE,QAA2C;IACrG,MAAM,CAAC,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC;IACzC,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAChG,OAAO,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC"}

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

@@ -0,0 +1,36 @@
+import { ServerError } from '../../utility/errors/hdbError.ts';
+import type { ModelBackend } from './types.ts';
+/**
+ * Process-wide model backend registry.
+ *
+ * Stores logical-name → backend-instance mappings for embedding and
+ * generative kinds. Boot wiring populates the registry via
+ * `setEmbedding(...)` / `setGenerative(...)`; the `Models` facade reads it
+ * via `resolveEmbedding(...)` / `resolveGenerative(...)`.
+ *
+ * Module-scope state is intentional — one registry per Harper process,
+ * mirroring `contextStorage` at `resources/transaction.ts:6`. Translating
+ * a YAML `models:` config block into registry entries (the bootstrapper
+ * step) lands in Phase 2 alongside the first real backend.
+ */
+type ModelKind = 'embedding' | 'generative';
+/** Map `logicalName` to a backend for embedding calls. Re-set replaces. */
+export declare function setEmbedding(logicalName: string, backend: ModelBackend): void;
+/** Map `logicalName` to a backend for generative calls. Re-set replaces. */
+export declare function setGenerative(logicalName: string, backend: ModelBackend): void;
+/**
+ * Resolve the embedding backend mapped to `logicalName` (default: `'default'`).
+ * Throws `ModelBackendNotFoundError` if no backend is mapped.
+ */
+export declare function resolveEmbedding(logicalName?: string): ModelBackend;
+/**
+ * Resolve the generative backend mapped to `logicalName` (default: `'default'`).
+ * Throws `ModelBackendNotFoundError` if no backend is mapped.
+ */
+export declare function resolveGenerative(logicalName?: string): ModelBackend;
+/** Remove all registrations. Test-only hygiene. */
+export declare function clearRegistry(): void;
+export declare class ModelBackendNotFoundError extends ServerError {
+    constructor(kind: ModelKind, logicalName: string);
+}
+export {};

package/dist/resources/models/backendRegistry.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelBackendNotFoundError = void 0;
+exports.setEmbedding = setEmbedding;
+exports.setGenerative = setGenerative;
+exports.resolveEmbedding = resolveEmbedding;
+exports.resolveGenerative = resolveGenerative;
+exports.clearRegistry = clearRegistry;
+const hdbError_ts_1 = require("../../utility/errors/hdbError.js");
+const embedding = new Map();
+const generative = new Map();
+/** Map `logicalName` to a backend for embedding calls. Re-set replaces. */
+function setEmbedding(logicalName, backend) {
+    embedding.set(logicalName, backend);
+}
+/** Map `logicalName` to a backend for generative calls. Re-set replaces. */
+function setGenerative(logicalName, backend) {
+    generative.set(logicalName, backend);
+}
+/**
+ * Resolve the embedding backend mapped to `logicalName` (default: `'default'`).
+ * Throws `ModelBackendNotFoundError` if no backend is mapped.
+ */
+function resolveEmbedding(logicalName = 'default') {
+    const backend = embedding.get(logicalName);
+    if (!backend)
+        throw new ModelBackendNotFoundError('embedding', logicalName);
+    return backend;
+}
+/**
+ * Resolve the generative backend mapped to `logicalName` (default: `'default'`).
+ * Throws `ModelBackendNotFoundError` if no backend is mapped.
+ */
+function resolveGenerative(logicalName = 'default') {
+    const backend = generative.get(logicalName);
+    if (!backend)
+        throw new ModelBackendNotFoundError('generative', logicalName);
+    return backend;
+}
+/** Remove all registrations. Test-only hygiene. */
+function clearRegistry() {
+    embedding.clear();
+    generative.clear();
+}
+class ModelBackendNotFoundError extends hdbError_ts_1.ServerError {
+    // Message identifies the kind + logical name only; never enumerates other
+    // registered names to avoid leaking the registry shape in error responses.
+    constructor(kind, logicalName) {
+        super(`No backend registered for '${kind}.${logicalName}'`);
+        this.name = 'ModelBackendNotFoundError';
+    }
+}
+exports.ModelBackendNotFoundError = ModelBackendNotFoundError;
+//# sourceMappingURL=backendRegistry.js.map

package/dist/resources/models/backendRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backendRegistry.js","sourceRoot":"","sources":["../../../resources/models/backendRegistry.ts"],"names":[],"mappings":";;;AAuBA,oCAEC;AAGD,sCAEC;AAMD,4CAIC;AAMD,8CAIC;AAGD,sCAGC;AAxDD,kEAA+D;AAmB/D,MAAM,SAAS,GAA8B,IAAI,GAAG,EAAE,CAAC;AACvD,MAAM,UAAU,GAA8B,IAAI,GAAG,EAAE,CAAC;AAExD,2EAA2E;AAC3E,SAAgB,YAAY,CAAC,WAAmB,EAAE,OAAqB;IACtE,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,4EAA4E;AAC5E,SAAgB,aAAa,CAAC,WAAmB,EAAE,OAAqB;IACvE,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,cAAsB,SAAS;IAC/D,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,yBAAyB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAC5E,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,cAAsB,SAAS;IAChE,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,yBAAyB,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IAC7E,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,mDAAmD;AACnD,SAAgB,aAAa;IAC5B,SAAS,CAAC,KAAK,EAAE,CAAC;IAClB,UAAU,CAAC,KAAK,EAAE,CAAC;AACpB,CAAC;AAED,MAAa,yBAA0B,SAAQ,yBAAW;IACzD,0EAA0E;IAC1E,2EAA2E;IAC3E,YAAY,IAAe,EAAE,WAAmB;QAC/C,KAAK,CAAC,8BAA8B,IAAI,IAAI,WAAW,GAAG,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IACzC,CAAC;CACD;AAPD,8DAOC"}

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

@@ -0,0 +1,24 @@
+interface ModelEntry {
+    backend?: string;
+    host?: string;
+    model?: string;
+    requestTimeoutMs?: number;
+    apiKey?: string;
+    baseUrl?: string;
+    organization?: string;
+    region?: string;
+}
+interface ModelsConfig {
+    embedding?: Record<string, ModelEntry>;
+    generative?: Record<string, ModelEntry>;
+}
+interface RootConfig {
+    models?: ModelsConfig;
+}
+/**
+ * Populate the model registry from `rootConfig.models`. No-op if the block
+ * is absent or empty. Idempotent within a process: each entry overwrites any
+ * prior registration under the same logical name (registry uses `.set()`).
+ */
+export declare function bootstrapModels(rootConfig: RootConfig | undefined | null): void;
+export {};