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

package/dist/resources/models/embedHook.js

@@ -1,14 +1,16 @@
 "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.writeHookApplies = writeHookApplies;
+exports.sourceState = sourceState;
+exports.runWriteJobs = runWriteJobs;
+exports.combineWriteHooks = combineWriteHooks;
+exports.sanitizedHookError = sanitizedHookError;
+exports.assertDerivedFieldOwnership = assertDerivedFieldOwnership;
 exports.createDefaultEmbedder = createDefaultEmbedder;
 exports.buildEmbedBefore = buildEmbedBefore;
+const hdbError_ts_1 = require("../../utility/errors/hdbError.js");
+const decision_ts_1 = require("./decision.js");
 // Lazily resolved to avoid a require cycle on the unit-test load path; only needed on failure.
 function getLogger() {
     try {
@@ -34,15 +36,208 @@ function resolveEmbedFn() {
 function __setEmbedFnForTest(fn) {
     _embedFn = fn;
 }
+/**
+ * Whether a write-time model hook runs for this write at all. Skip when the write already
+ * carries the derived attributes: a cluster-replication receiver (isNotification), REST
+ * x-replicate-from:none, or audit-log replay. Proactive source-subscribe pushes also set
+ * isNotification and so skip. One predicate for `@embed` and `@decide` so their trigger rules
+ * cannot drift.
+ */
+function writeHookApplies(record, context, options) {
+    if (options?.isNotification === true || context?.replicateFrom === false || context?.alreadyLogged === true)
+        return false;
+    return Boolean(record) && typeof record === 'object';
+}
+function sourceState(record, sourceKey) {
+    if (!sourceKey || !(sourceKey in record))
+        return 'absent';
+    const value = record[sourceKey];
+    if (value == null)
+        return 'null';
+    if (typeof value === 'object' && value.__op__)
+        return 'op';
+    return 'value';
+}
+/**
+ * Run the jobs of one write. The first failure aborts the others, and every job settles before
+ * that failure is reported: a rejected write neither waits on a sibling that honors the signal
+ * nor keeps being mutated by one that has not finished. A job that ignores the signal is
+ * awaited regardless, so the model calls behind the built-in hooks forward it.
+ */
+async function runWriteJobs(jobs, signal) {
+    const controller = new AbortController();
+    const onAbort = () => controller.abort(signal?.reason);
+    if (signal?.aborted)
+        onAbort();
+    else
+        signal?.addEventListener('abort', onAbort, { once: true });
+    let failed = false;
+    let failure;
+    try {
+        await Promise.all(jobs.map((job) => job(controller.signal).catch((err) => {
+            if (!failed) {
+                failed = true;
+                failure = err;
+            }
+            controller.abort(err);
+        })));
+    }
+    finally {
+        signal?.removeEventListener('abort', onAbort);
+    }
+    if (failed)
+        throw failure;
+}
+function combineWriteHooks(a, b) {
+    if (!a)
+        return b;
+    if (!b)
+        return a;
+    return (signal) => runWriteJobs([a, b], signal);
+}
+const SAFE_ERROR_NAME = /^[A-Za-z][A-Za-z0-9_]{0,63}$/;
+/**
+ * Backend errors can carry URLs / key tails; log raw, return a sanitized error to throw. Only
+ * safe identifiers are included (an identifier-shaped error class name, a finite upstream HTTP
+ * status) so the failure is diagnosable without hunting through server logs (#1593).
+ * `upstreamStatus` is the provider's status — NOT ServerError's statusCode, which is Harper's
+ * own response status and would misleadingly read 500 here.
+ */
+function sanitizedHookError(actor, product, attributeName, err, log = true) {
+    if (log)
+        getLogger().error?.(`${actor} for attribute "${attributeName}" failed:`, err);
+    const status = err?.upstreamStatus;
+    const errName = err?.name;
+    const detail = (typeof errName === 'string' && errName !== 'Error' && SAFE_ERROR_NAME.test(errName) ? ` [${errName}]` : '') +
+        (Number.isInteger(status) && status >= 100 && status <= 599 ? ` (backend HTTP ${status})` : '');
+    const error = new Error(`Failed to compute ${product} for attribute "${attributeName}"${detail} — see server log for details`);
+    if (errName === 'AbortError')
+        error.name = 'AbortError';
+    return error;
+}
+const INT32_MIN = -2147483648;
+const INT32_MAX = 2147483647;
+// Table validation holds a String to strings and an Int to 32 bits, so a leaf outside either would
+// load and then fail every write.
+const LEAF_KIND_BY_TYPE = {
+    String: (schema) => Array.isArray(schema?.enum) && schema.enum.every((value) => typeof value === 'string'),
+    Boolean: (schema) => schema?.type === 'boolean' && !Array.isArray(schema.enum),
+    Int: (schema) => schema?.type === 'integer' &&
+        !Array.isArray(schema.enum) &&
+        schema.minimum >= INT32_MIN &&
+        schema.maximum <= INT32_MAX,
+};
+/**
+ * Every derived field (an `@embed` target, a `@decide` target or confidence) has exactly one
+ * writer, and no directive derives from another directive's output: the hooks run concurrently
+ * within one write, so the stored pair would otherwise depend on scheduling. A source and a
+ * confidence field must be declared; a decided field and its confidence field are nullable,
+ * neither the primary key nor computed, the decided field's type matches its leaf and the leaf
+ * is a valid decision schema; and none of those fields may be named after an `Object.prototype`
+ * key, because `sourceState` tests presence with `in`. Run on the complete attribute list.
+ */
+function assertDerivedFieldOwnership(attributes) {
+    const declared = new Map();
+    for (const attribute of attributes)
+        if (attribute)
+            declared.set(attribute.name, attribute);
+    const writers = new Map();
+    const claim = (field, writer) => {
+        const prior = writers.get(field);
+        if (prior)
+            throw new hdbError_ts_1.ClientError(`${writer} and ${prior} both write "${field}"`, 400);
+        writers.set(field, writer);
+    };
+    const directives = (attribute) => {
+        const out = [];
+        if (attribute.embed)
+            out.push(['@embed', attribute.embed]);
+        if (attribute.decide)
+            out.push(['@decide', attribute.decide]);
+        return out;
+    };
+    for (const attribute of attributes) {
+        if (!attribute)
+            continue;
+        for (const [directive, config] of directives(attribute)) {
+            const writer = `${directive} on "${attribute.name}"`;
+            for (const [name, field] of [
+                ['confidence', config.confidence],
+                ['decision', config.decision],
+            ])
+                if (field !== undefined && (typeof field !== 'string' || field === ''))
+                    throw new hdbError_ts_1.ClientError(`${writer}: "${name}" must name a field`, 400);
+            for (const field of [attribute.name, config.source, config.confidence, config.decision])
+                if (field && Object.hasOwn(Object.prototype, field))
+                    throw new hdbError_ts_1.ClientError(`${writer}: "${field}" is an Object.prototype key and cannot be a derived, source, confidence or decision field`, 400);
+            if (!declared.has(config.source))
+                throw new hdbError_ts_1.ClientError(`${writer} references unknown source field "${config.source}"`, 400);
+            if (directive === '@decide') {
+                if (attribute.isPrimaryKey || attribute.computed)
+                    throw new hdbError_ts_1.ClientError(`${writer} cannot combine with @primaryKey or @computed`, 400);
+                if (attribute.nullable === false)
+                    throw new hdbError_ts_1.ClientError(`${writer} cannot be declared non-null: a null source clears the attribute`, 400);
+                try {
+                    (0, decision_ts_1.validateDecisionSchema)(config.schema);
+                }
+                catch (err) {
+                    throw new hdbError_ts_1.ClientError(`${writer}: ${err.message}`, 400);
+                }
+                if (attribute.type !== undefined) {
+                    const matches = LEAF_KIND_BY_TYPE[attribute.type];
+                    if (!matches)
+                        throw new hdbError_ts_1.ClientError(`${writer} requires a String, Boolean or Int attribute type; got "${attribute.type === 'array' ? '[...]' : attribute.type}"`, 400);
+                    if (!matches(config.schema))
+                        throw new hdbError_ts_1.ClientError(`${writer}: the decision schema does not fit a ${attribute.type} attribute`, 400);
+                }
+            }
+            claim(attribute.name, writer);
+            if (config.confidence) {
+                const confidence = declared.get(config.confidence);
+                if (!confidence)
+                    throw new hdbError_ts_1.ClientError(`${writer} references unknown confidence field "${config.confidence}"`, 400);
+                if (confidence.type !== undefined && confidence.type !== 'Float')
+                    throw new hdbError_ts_1.ClientError(`${writer} requires a Float confidence attribute; "${config.confidence}" is ${confidence.type === 'array' ? '[...]' : confidence.type}`, 400);
+                if (confidence.nullable === false)
+                    throw new hdbError_ts_1.ClientError(`${writer}: confidence attribute "${config.confidence}" cannot be declared non-null: a null source clears it`, 400);
+                if (confidence.isPrimaryKey || confidence.computed)
+                    throw new hdbError_ts_1.ClientError(`${writer}: confidence attribute "${config.confidence}" cannot be @primaryKey or @computed`, 400);
+                claim(config.confidence, writer);
+            }
+            if (config.decision) {
+                const decisionField = declared.get(config.decision);
+                if (!decisionField)
+                    throw new hdbError_ts_1.ClientError(`${writer} references unknown decision field "${config.decision}"`, 400);
+                if (decisionField.type !== undefined && decisionField.type !== 'String')
+                    throw new hdbError_ts_1.ClientError(`${writer} requires a String decision attribute; "${config.decision}" is ${decisionField.type === 'array' ? '[...]' : decisionField.type}`, 400);
+                if (decisionField.nullable === false)
+                    throw new hdbError_ts_1.ClientError(`${writer}: decision attribute "${config.decision}" cannot be declared non-null: a null source clears it`, 400);
+                if (decisionField.isPrimaryKey || decisionField.computed)
+                    throw new hdbError_ts_1.ClientError(`${writer}: decision attribute "${config.decision}" cannot be @primaryKey or @computed`, 400);
+                claim(config.decision, writer);
+            }
+        }
+    }
+    for (const attribute of attributes) {
+        if (!attribute)
+            continue;
+        for (const [directive, config] of directives(attribute)) {
+            const sourceWriter = writers.get(config.source);
+            if (sourceWriter)
+                throw new hdbError_ts_1.ClientError(`${directive} on "${attribute.name}" derives from "${config.source}", which ${sourceWriter} writes`, 400);
+        }
+    }
+}
 function createDefaultEmbedder(embedConfig) {
     const { source, model } = embedConfig;
-    return async (record) => {
+    return async (record, hook) => {
         const sourceValue = record?.[source];
         if (sourceValue == null)
             return null;
         const vectors = await resolveEmbedFn()(String(sourceValue), {
             model,
             inputType: 'document',
+            signal: hook?.signal,
         });
         const v = vectors?.[0];
         if (v == null)
@@ -63,63 +258,35 @@ function createDefaultEmbedder(embedConfig) {
 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) {
+    if (!writeHookApplies(record, context, options))
         return undefined;
-    }
-    if (!record || typeof record !== 'object')
+    let present = false;
+    for (const attr of embedAttributes)
+        if (sourceState(record, attr.embed?.source) !== 'absent')
+            present = true;
+    if (!present)
         return undefined;
-    let anySourcePresent = false;
-    for (const attr of embedAttributes) {
-        const sourceKey = attr.embed?.source;
-        if (sourceKey && sourceKey in record) {
-            anySourcePresent = true;
-            break;
+    return (signal) => runWriteJobs(embedAttributes.map((attr) => async (jobSignal) => {
+        const state = sourceState(record, attr.embed?.source);
+        if (state === 'absent' || state === 'op')
+            return;
+        if (state === 'null') {
+            record[attr.name] = null;
+            return;
         }
-    }
-    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. Include
-                // only safe identifiers (error class name, upstream HTTP status) so the failure is
-                // diagnosable without hunting through server logs (#1593). upstreamStatus is the
-                // provider's status — NOT ServerError's statusCode, which is Harper's own response
-                // status and would misleadingly read 500 here.
-                getLogger().error?.(`Embedder for attribute "${attr.name}" failed:`, err);
-                const status = err?.upstreamStatus;
-                const errName = err?.name;
-                const detail = (errName && errName !== 'Error' ? ` [${errName}]` : '') +
-                    (typeof status === 'number' ? ` (backend HTTP ${status})` : '');
-                throw new Error(`Failed to compute embedding for attribute "${attr.name}"${detail} — see server log for details`);
-            }
-            record[attr.name] = normalizeVector(vector);
-        }));
-    };
+        const embedder = userEmbedders[attr.name];
+        if (!embedder)
+            return;
+        let vector;
+        try {
+            vector = await embedder(record, { signal: jobSignal });
+        }
+        catch (err) {
+            // An aborted job failed because a sibling did; only that failure is worth a log line.
+            throw sanitizedHookError('Embedder', 'embedding', attr.name, err, !jobSignal.aborted);
+        }
+        record[attr.name] = normalizeVector(vector);
+    }), signal);
 }
 // 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.

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

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

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

@@ -0,0 +1,58 @@
+/**
+ * Built-in `decision` backend over a configured generative logical name (#2779). A call either
+ * scores every allowed value from the generative model's own likelihoods (#2838), when that name
+ * routes to a backend implementing `scoreChoices`, or asks the model for `samples`
+ * structured-output completions and reports the vote frequencies as the distribution. Configured
+ * as `models.decision.<name>: { backend: generative, scoring: auto | vote | score }`.
+ *
+ * Every sample and every scoring call flows through the `models` facade, so each one writes its
+ * own `hdb_model_calls` row and token metrics; the decide row itself reports no usage, or the
+ * tokens would be counted twice (the same reason the agent loop's outer call writes no row).
+ */
+import { ServerError } from '../../utility/errors/hdbError.ts';
+import type { ChoiceScores, GenerateInput, GenerateOpts, GenerateResult, ModelBackend, ModelKind, ScoreChoicesOpts } from './types.ts';
+export type ScoringMode = 'auto' | 'vote' | 'score';
+export interface GenerativeDecisionConfig {
+    /** Logical name of the generative model to sample or score; default `'default'`. */
+    generative?: string;
+    /** Completions per voted decision (1..25); default 5. */
+    samples?: number;
+    /** Completions or scoring calls in flight at once (1..25); default 5. */
+    concurrency?: number;
+    temperature?: number;
+    /** Budget for the whole decision, composed with the caller's signal. */
+    requestTimeoutMs?: number;
+    /**
+     * `auto` (default) scores when the generative name routes to a backend that implements
+     * `scoreChoices` and votes otherwise, also when scoring proves unsupported for a call; `score`
+     * never votes; `vote` never scores, which makes it the rollback setting.
+     */
+    scoring?: ScoringMode;
+    /**
+     * Route each sample only to a generative candidate that sends the response schema as a
+     * decoding constraint (`structuredOutput`); default `true`. `false` samples prompt-only
+     * backends, whose replies are parsed leniently and fail the decision when no in-schema
+     * answer is found.
+     */
+    requireStructuredOutput?: boolean;
+}
+export declare const DEFAULT_SAMPLES = 5;
+export declare const MAX_SAMPLES = 25;
+export type GenerateFn = (input: GenerateInput, opts: GenerateOpts) => Promise<GenerateResult>;
+export type ScoreFn = (input: GenerateInput, choices: readonly string[], opts: ScoreChoicesOpts) => Promise<ChoiceScores>;
+/** The facade calls the adapter makes; injectable for tests. */
+export interface GenerativeDecisionDeps {
+    generate?: GenerateFn;
+    score?: ScoreFn;
+    /** Whether the generative name currently routes to a backend that scores; `auto` asks before every decision. */
+    canScore?: (logicalName: string, largestLeaf: number) => boolean;
+}
+export declare class GenerativeDecisionError extends ServerError {
+    constructor(message: string);
+}
+export declare function registerGenerativeDecisionBackend(args: {
+    logicalName: string;
+    kind: ModelKind;
+    config: GenerativeDecisionConfig;
+}): void;
+export declare function createGenerativeDecisionBackend(config?: GenerativeDecisionConfig, deps?: GenerativeDecisionDeps): ModelBackend;