@harperfast/harper-pro 5.0.25 → 5.1.0-beta.1

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

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

package/dist/core/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/core/resources/models/analyticsTable.js.map

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

package/dist/core/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/core/resources/models/backendHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backendHelpers.js","sourceRoot":"","sources":["../../../../core/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/core/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/core/resources/models/backendRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backendRegistry.js","sourceRoot":"","sources":["../../../../core/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/core/resources/models/bootstrap.js

@@ -0,0 +1,112 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bootstrapModels = bootstrapModels;
+/**
+ * YAML→registry boot bridge (#629 / #630 of #510).
+ *
+ * Reads the top-level `models` block from the root config and dispatches each
+ * `models.embedding.<name>` / `models.generative.<name>` entry to the matching
+ * per-backend register function. Backends self-contain in `components/<name>/`
+ * (matches the pattern in `components/mcp/index.ts` from PR #649).
+ *
+ * Boot site: `components/componentLoader.ts` calls this after `getConfigObj()`
+ * returns the root config and before per-component iteration, so that
+ * `scope.models.embed(...)` works from `handleApplication(scope)`.
+ *
+ * Env-var expansion: each entry's string leaves are run through
+ * `expandEnvVarsDeep` before dispatch — `apiKey: ${OPENAI_API_KEY}` in YAML
+ * becomes the resolved process.env value at the backend. Matches the
+ * convention from `@harperfast/oauth`'s config loader.
+ *
+ * Errors per entry are logged and skipped, not thrown — one misconfigured
+ * backend should not block Harper boot.
+ */
+const harper_logger_ts_1 = __importDefault(require("../../utility/logging/harper_logger.js"));
+const expandEnvVar_ts_1 = require("../../utility/expandEnvVar.js");
+const index_ts_1 = require("../../components/ollama/index.js");
+const index_ts_2 = require("../../components/openai/index.js");
+const index_ts_3 = require("../../components/anthropic/index.js");
+const index_ts_4 = require("../../components/bedrock/index.js");
+/**
+ * Field names treated as credentials. When present in config as a literal
+ * value (not a `${VAR}` placeholder), bootstrap warns the operator at boot
+ * — `harperdb-config.yaml` on disk in plaintext is a real anti-pattern.
+ * Extend this list as future backends add credential fields.
+ */
+const CREDENTIAL_FIELDS = new Set(['apiKey']);
+const FACTORIES = {
+    ollama: (args) => (0, index_ts_1.registerOllamaBackend)({ ...args, config: args.config }),
+    openai: (args) => (0, index_ts_2.registerOpenAIBackend)({ ...args, config: args.config }),
+    anthropic: (args) => (0, index_ts_3.registerAnthropicBackend)({ ...args, config: args.config }),
+    bedrock: (args) => (0, index_ts_4.registerBedrockBackend)({ ...args, config: args.config }),
+};
+/**
+ * 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()`).
+ */
+function bootstrapModels(rootConfig) {
+    const block = rootConfig?.models;
+    if (!block)
+        return;
+    registerKind('embedding', block.embedding);
+    registerKind('generative', block.generative);
+}
+function warnOnLiteralCredentials(kind, logicalName, entry) {
+    for (const field of CREDENTIAL_FIELDS) {
+        const value = entry[field];
+        if (typeof value !== 'string' || value.length === 0)
+            continue;
+        if ((0, expandEnvVar_ts_1.isUnresolvedEnvVarPlaceholder)(value))
+            continue; // operator is using ${VAR} indirection
+        harper_logger_ts_1.default.warn(`models.${kind}.${logicalName}: '${field}' is a literal value in harperdb-config.yaml; ` +
+            `prefer \${ENV_VAR} indirection for credentials to keep them off disk`);
+    }
+}
+function registerKind(kind, entries) {
+    if (!entries)
+        return;
+    for (const [logicalName, entry] of Object.entries(entries)) {
+        if (!entry || typeof entry !== 'object') {
+            // Schema validation (configValidator.ts) catches this before bootstrap
+            // runs, so reaching here means config was loaded by an unusual path
+            // (test, programmatic). Log at error so it's visible.
+            harper_logger_ts_1.default.error(`models.${kind}.${logicalName} is not an object; skipping`);
+            continue;
+        }
+        const factory = entry.backend ? FACTORIES[entry.backend] : undefined;
+        if (!factory) {
+            // Loud because the operator opted into `models:` specifically to enable
+            // a backend — silently registering nothing is a footgun. Schema-level
+            // typo guards (`.unknown(false)` on modelEntrySchema) catch field-name
+            // typos before this point; reaching here means `backend:` itself names
+            // a type Harper doesn't ship a factory for in this version. List the
+            // known backends so operators can spot value-name typos
+            // (`backend: 'openi'` instead of `'openai'`).
+            const known = Object.keys(FACTORIES).sort().join(', ');
+            harper_logger_ts_1.default.error(`models.${kind}.${logicalName}: unknown backend '${entry.backend ?? '(missing)'}'; skipping. Known backends: ${known}.`);
+            continue;
+        }
+        // Warn before expansion: literal credentials in `harperdb-config.yaml`
+        // land on disk, in backups, and (depending on deployment) in replicated
+        // config tables. The `${VAR}` indirection pattern from
+        // `@harperfast/oauth` is documented but not enforced.
+        warnOnLiteralCredentials(kind, logicalName, entry);
+        try {
+            // Resolve `${VAR}` placeholders on every string leaf before handing the
+            // entry to the backend factory. Backends receive concrete values and
+            // don't need to know about env-var syntax. Unresolved placeholders
+            // (env var unset) pass through unchanged — backend's required-field
+            // validation catches them with a meaningful error.
+            const resolved = (0, expandEnvVar_ts_1.expandEnvVarsDeep)(entry);
+            factory({ logicalName, kind, config: resolved });
+        }
+        catch (err) {
+            harper_logger_ts_1.default.error(`models.${kind}.${logicalName}: registration failed (${err?.message ?? err})`);
+        }
+    }
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/core/resources/models/bootstrap.js.map

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

package/dist/core/resources/models/embedHook.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * `@embed` directive write-time hook. `createDefaultEmbedder` builds the embedder
+ * a table registers for an `@embed` attribute; `buildEmbedBefore` produces the
+ * pre-commit callback that runs registered embedders and writes their vectors onto
+ * the record before it commits.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__setEmbedFnForTest = __setEmbedFnForTest;
+exports.createDefaultEmbedder = createDefaultEmbedder;
+exports.buildEmbedBefore = buildEmbedBefore;
+// Lazily resolved to avoid a require cycle on the unit-test load path; only needed on failure.
+function getLogger() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        return require('#src/utility/logging/logger').logger ?? {};
+    }
+    catch {
+        return {};
+    }
+}
+// Lazy-imported so this module can be unit-tested without loading the transaction
+// stack `Models.ts` pulls in. Overridable via `__setEmbedFnForTest`.
+let _embedFn;
+function resolveEmbedFn() {
+    if (_embedFn)
+        return _embedFn;
+    const { Models } = require('#src/resources/models/Models'); // eslint-disable-line @typescript-eslint/no-var-requires
+    const models = new Models();
+    _embedFn = (input, opts) => models.embed(input, opts);
+    return _embedFn;
+}
+/** Test seam: override the embed function. Pass `undefined` to reset to `Models.embed`. */
+function __setEmbedFnForTest(fn) {
+    _embedFn = fn;
+}
+function createDefaultEmbedder(embedConfig) {
+    const { source, model } = embedConfig;
+    return async (record) => {
+        const sourceValue = record?.[source];
+        if (sourceValue == null)
+            return null;
+        const vectors = await resolveEmbedFn()(String(sourceValue), {
+            model,
+            inputType: 'document',
+        });
+        const v = vectors?.[0];
+        if (v == null)
+            return undefined;
+        // Store as a plain array — typed arrays don't round-trip through the record encoder.
+        return v instanceof Float32Array ? Array.from(v) : Array.from(v);
+    };
+}
+/**
+ * Build the pre-commit callback that runs embedders for every `@embed` attribute whose
+ * source field is present in this write. Returns `undefined` when there's nothing to do
+ * (no `@embed` attributes, a replication-receiver write, or no source field in the payload),
+ * so the call site can skip it.
+ *
+ * Source-field semantics: embed only when the source field is in the payload. A PATCH that
+ * omits it leaves the existing vector untouched; an explicit `source: null` clears the vector.
+ */
+function buildEmbedBefore(record, context, options, embedAttributes, userEmbedders) {
+    if (!embedAttributes || embedAttributes.length === 0)
+        return undefined;
+    // Skip when the write already carries the vector: cluster-replication receiver
+    // (isNotification), REST x-replicate-from:none, or audit-log replay. Note that
+    // proactive source-subscribe pushes also set isNotification and so skip embedding.
+    if (options?.isNotification === true || context?.replicateFrom === false || context?.alreadyLogged === true) {
+        return undefined;
+    }
+    if (!record || typeof record !== 'object')
+        return undefined;
+    let anySourcePresent = false;
+    for (const attr of embedAttributes) {
+        const sourceKey = attr.embed?.source;
+        if (sourceKey && sourceKey in record) {
+            anySourcePresent = true;
+            break;
+        }
+    }
+    if (!anySourcePresent)
+        return undefined;
+    return async () => {
+        // Parallel: each embedder mutates a distinct attribute, so there's no ordering hazard.
+        await Promise.all(embedAttributes.map(async (attr) => {
+            const sourceKey = attr.embed?.source;
+            if (!sourceKey)
+                return;
+            if (!(sourceKey in record))
+                return;
+            const sourceValue = record[sourceKey];
+            if (sourceValue == null) {
+                record[attr.name] = null;
+                return;
+            }
+            // CRDT op payloads (`{__op__, value}`) aren't a meaningful embed source; skip.
+            if (sourceValue && typeof sourceValue === 'object' && sourceValue.__op__)
+                return;
+            const embedder = userEmbedders[attr.name];
+            if (!embedder)
+                return;
+            let vector;
+            try {
+                vector = await embedder(record);
+            }
+            catch (err) {
+                // Backend errors can carry URLs / key tails; log raw, rethrow sanitized.
+                getLogger().error?.(`Embedder for attribute "${attr.name}" failed:`, err);
+                throw new Error(`Failed to compute embedding for attribute "${attr.name}"`);
+            }
+            record[attr.name] = normalizeVector(vector);
+        }));
+    };
+}
+// Custom embedders may return any typed array; flatten to a plain array so it round-trips
+// through the record encoder. NaN is left for HNSW to reject at index time.
+function normalizeVector(vector) {
+    if (vector == null)
+        return null;
+    if (Array.isArray(vector))
+        return vector;
+    if (ArrayBuffer.isView(vector))
+        return Array.from(vector);
+    return vector;
+}
+//# sourceMappingURL=embedHook.js.map