@sentropic/llm-mesh 0.28.0 → 0.28.1

package/dist/decision/errors.d.ts

@@ -0,0 +1,43 @@
+declare const messages: {
+    readonly REQUEST_INVALID: "Invalid decision request.";
+    readonly PROVIDER_UNKNOWN: "Unknown decision provider.";
+    readonly EVALUATOR_UNKNOWN: "Unknown evaluator.";
+    readonly CAPABILITY_UNSUPPORTED: "Requested decision capability is unsupported.";
+    readonly PROVIDER_UNAVAILABLE: "Decision provider is unavailable.";
+    readonly REVISION_MISMATCH: "Evaluator revision does not match.";
+    readonly CREDENTIAL_MISSING: "Decision credential is missing.";
+    readonly AUTHENTICATION_FAILED: "Authentication failed.";
+    readonly AUTHORIZATION_DENIED: "Decision authorization denied.";
+    readonly PRICING_UNAVAILABLE: "Decision pricing is unavailable.";
+    readonly BUDGET_BOUND_UNAVAILABLE: "A finite decision liability bound is unavailable.";
+    readonly BUDGET_EXHAUSTED: "Decision budget is exhausted.";
+    readonly BUDGET_UNAVAILABLE: "Decision budget authority is unavailable.";
+    readonly SETTLEMENT_UNAVAILABLE: "Decision settlement is unavailable.";
+    readonly RATE_LIMITED: "Decision provider rate limit reached.";
+    readonly PROVIDER_OVERLOADED: "Decision provider is overloaded.";
+    readonly PROVIDER_REJECTED: "Decision provider rejected the request.";
+    readonly TIMEOUT: "Decision deadline exceeded.";
+    readonly CANCELLED: "Decision invocation cancelled.";
+    readonly TRANSPORT_FAILED: "Decision transport failed.";
+    readonly VERDICT_INVALID: "Invalid decision verdict.";
+    readonly SERVED_IDENTITY_MISMATCH: "Served evaluator identity does not match.";
+    readonly USAGE_INVALID: "Invalid decision usage.";
+    readonly RESPONSE_TOO_LARGE: "Decision response exceeds its size limit.";
+    readonly RECEIPT_UNAVAILABLE: "Decision receipt persistence is unavailable.";
+    readonly MESH_UNAVAILABLE: "Decision mesh is unavailable.";
+};
+export type DecisionErrorCode = keyof typeof messages;
+export interface DecisionError {
+    code: DecisionErrorCode;
+    message: string;
+    phase: 'preflight' | 'admission' | 'dispatch' | 'parse' | 'settlement';
+    retryable: boolean;
+    retryAfterMs?: number;
+}
+export declare const isDecisionErrorCode: (value: unknown) => value is "REQUEST_INVALID" | "CAPABILITY_UNSUPPORTED" | "PROVIDER_UNKNOWN" | "EVALUATOR_UNKNOWN" | "PROVIDER_UNAVAILABLE" | "REVISION_MISMATCH" | "CREDENTIAL_MISSING" | "AUTHENTICATION_FAILED" | "AUTHORIZATION_DENIED" | "PRICING_UNAVAILABLE" | "BUDGET_BOUND_UNAVAILABLE" | "BUDGET_EXHAUSTED" | "BUDGET_UNAVAILABLE" | "SETTLEMENT_UNAVAILABLE" | "RATE_LIMITED" | "PROVIDER_OVERLOADED" | "PROVIDER_REJECTED" | "TIMEOUT" | "CANCELLED" | "TRANSPORT_FAILED" | "VERDICT_INVALID" | "SERVED_IDENTITY_MISMATCH" | "USAGE_INVALID" | "RESPONSE_TOO_LARGE" | "RECEIPT_UNAVAILABLE" | "MESH_UNAVAILABLE";
+/** Static wording only. Retry hints never authorize replay or evaluator substitution. */
+export declare function createDecisionError(code: DecisionErrorCode, phase: DecisionError['phase'], options?: {
+    retryAfterMs?: number;
+}): DecisionError;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/decision/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/decision/errors.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BJ,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,QAAQ,CAAC;AACtD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,YAAY,CAAC;IACvE,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,mBAAmB,UAAW,OAAO,+kBACC,CAAC;AAKpD,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,EACxF,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,aAAa,CAYxD"}

package/dist/decision/errors.js

@@ -0,0 +1,47 @@
+import { has } from './validation.js';
+const messages = {
+    REQUEST_INVALID: 'Invalid decision request.',
+    PROVIDER_UNKNOWN: 'Unknown decision provider.',
+    EVALUATOR_UNKNOWN: 'Unknown evaluator.',
+    CAPABILITY_UNSUPPORTED: 'Requested decision capability is unsupported.',
+    PROVIDER_UNAVAILABLE: 'Decision provider is unavailable.',
+    REVISION_MISMATCH: 'Evaluator revision does not match.',
+    CREDENTIAL_MISSING: 'Decision credential is missing.',
+    AUTHENTICATION_FAILED: 'Authentication failed.',
+    AUTHORIZATION_DENIED: 'Decision authorization denied.',
+    PRICING_UNAVAILABLE: 'Decision pricing is unavailable.',
+    BUDGET_BOUND_UNAVAILABLE: 'A finite decision liability bound is unavailable.',
+    BUDGET_EXHAUSTED: 'Decision budget is exhausted.',
+    BUDGET_UNAVAILABLE: 'Decision budget authority is unavailable.',
+    SETTLEMENT_UNAVAILABLE: 'Decision settlement is unavailable.',
+    RATE_LIMITED: 'Decision provider rate limit reached.',
+    PROVIDER_OVERLOADED: 'Decision provider is overloaded.',
+    PROVIDER_REJECTED: 'Decision provider rejected the request.',
+    TIMEOUT: 'Decision deadline exceeded.',
+    CANCELLED: 'Decision invocation cancelled.',
+    TRANSPORT_FAILED: 'Decision transport failed.',
+    VERDICT_INVALID: 'Invalid decision verdict.',
+    SERVED_IDENTITY_MISMATCH: 'Served evaluator identity does not match.',
+    USAGE_INVALID: 'Invalid decision usage.',
+    RESPONSE_TOO_LARGE: 'Decision response exceeds its size limit.',
+    RECEIPT_UNAVAILABLE: 'Decision receipt persistence is unavailable.',
+    MESH_UNAVAILABLE: 'Decision mesh is unavailable.',
+};
+export const isDecisionErrorCode = (value) => typeof value === 'string' && has(messages, value);
+// Advisory delay ceiling matches the maximum decision request deadline.
+const maxRetryAfterMs = 60_000;
+/** Static wording only. Retry hints never authorize replay or evaluator substitution. */
+export function createDecisionError(code, phase, options = {}) {
+    const safeCode = isDecisionErrorCode(code) ? code : 'REQUEST_INVALID';
+    const safePhase = ['preflight', 'admission', 'dispatch', 'parse', 'settlement'].includes(phase) ? phase : 'preflight';
+    const financialUnavailable = ['BUDGET_UNAVAILABLE', 'SETTLEMENT_UNAVAILABLE', 'RECEIPT_UNAVAILABLE'].includes(safeCode);
+    const retryable = phase === safePhase && safePhase !== 'settlement' && (financialUnavailable
+        ? safePhase === 'preflight' || safePhase === 'admission'
+        : ['PROVIDER_UNAVAILABLE', 'RATE_LIMITED', 'PROVIDER_OVERLOADED', 'TIMEOUT', 'TRANSPORT_FAILED', 'MESH_UNAVAILABLE'].includes(safeCode));
+    const hint = options.retryAfterMs;
+    return { code: safeCode, message: messages[safeCode],
+        phase: safePhase, retryable,
+        ...(retryable && typeof hint === 'number' && Number.isSafeInteger(hint) && hint >= 0
+            && hint <= maxRetryAfterMs ? { retryAfterMs: hint } : {}) };
+}
+//# sourceMappingURL=errors.js.map

package/dist/decision/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/decision/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAEtC,MAAM,QAAQ,GAAG;IACf,eAAe,EAAE,2BAA2B;IAC5C,gBAAgB,EAAE,4BAA4B;IAC9C,iBAAiB,EAAE,oBAAoB;IACvC,sBAAsB,EAAE,+CAA+C;IACvE,oBAAoB,EAAE,mCAAmC;IACzD,iBAAiB,EAAE,oCAAoC;IACvD,kBAAkB,EAAE,iCAAiC;IACrD,qBAAqB,EAAE,wBAAwB;IAC/C,oBAAoB,EAAE,gCAAgC;IACtD,mBAAmB,EAAE,kCAAkC;IACvD,wBAAwB,EAAE,mDAAmD;IAC7E,gBAAgB,EAAE,+BAA+B;IACjD,kBAAkB,EAAE,2CAA2C;IAC/D,sBAAsB,EAAE,qCAAqC;IAC7D,YAAY,EAAE,uCAAuC;IACrD,mBAAmB,EAAE,kCAAkC;IACvD,iBAAiB,EAAE,yCAAyC;IAC5D,OAAO,EAAE,6BAA6B;IACtC,SAAS,EAAE,gCAAgC;IAC3C,gBAAgB,EAAE,4BAA4B;IAC9C,eAAe,EAAE,2BAA2B;IAC5C,wBAAwB,EAAE,2CAA2C;IACrE,aAAa,EAAE,yBAAyB;IACxC,kBAAkB,EAAE,2CAA2C;IAC/D,mBAAmB,EAAE,8CAA8C;IACnE,gBAAgB,EAAE,+BAA+B;CACzC,CAAC;AAWX,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAc,EAA8B,EAAE,CAChF,OAAO,KAAK,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAEpD,wEAAwE;AACxE,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B,yFAAyF;AACzF,MAAM,UAAU,mBAAmB,CAAC,IAAuB,EAAE,KAA6B,EACxF,UAAqC,EAAE;IACvC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC;IACtE,MAAM,SAAS,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC;IACtH,MAAM,oBAAoB,GAAG,CAAC,oBAAoB,EAAE,wBAAwB,EAAE,qBAAqB,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACxH,MAAM,SAAS,GAAG,KAAK,KAAK,SAAS,IAAI,SAAS,KAAK,YAAY,IAAI,CAAC,oBAAoB;QAC1F,CAAC,CAAC,SAAS,KAAK,WAAW,IAAI,SAAS,KAAK,WAAW;QACxD,CAAC,CAAC,CAAC,sBAAsB,EAAE,cAAc,EAAE,qBAAqB,EAAE,SAAS,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3I,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC;IAClC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC;QAClD,KAAK,EAAE,SAAS,EAAE,SAAS;QAC3B,GAAG,CAAC,SAAS,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;eAC/E,IAAI,IAAI,eAAe,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAClE,CAAC"}

package/dist/decision/execution.d.ts

@@ -0,0 +1,31 @@
+import type { DecisionError } from './errors.js';
+import type { DecisionReceipt, DecisionResult } from './receipt.js';
+import type { DecisionVerdict } from './verdict.js';
+import type { DecisionReceiptSink } from './budget.js';
+export interface DecisionClock {
+    wall(): number;
+    monotonic(): number;
+}
+export interface DecisionExecution {
+    receipt: DecisionReceipt;
+    clock: DecisionClock;
+    start: number;
+    deadline: number;
+    signal?: AbortSignal;
+    idError: boolean;
+    phase: DecisionError['phase'];
+    expired: boolean;
+}
+export declare const defaultDecisionClock: DecisionClock;
+export declare function beginDecisionExecution(candidate: unknown, options: {
+    clock?: DecisionClock;
+    generateId?: () => string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}): DecisionExecution;
+export declare function decisionInterruption(execution: DecisionExecution, phase: DecisionError['phase']): DecisionError | null;
+export declare function closeDecisionReceipt(execution: DecisionExecution, error?: DecisionError): void;
+/** Copies before crossing host boundaries: no live provider envelope or caller content. */
+export declare function copyDecisionReceipt(receipt: DecisionReceipt): DecisionReceipt;
+export declare function persistDecisionResult(execution: DecisionExecution, sink: DecisionReceiptSink, error?: DecisionError, verdict?: DecisionVerdict): Promise<DecisionResult>;
+//# sourceMappingURL=execution.d.ts.map

package/dist/decision/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/decision/execution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAKpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,WAAW,aAAa;IAAG,IAAI,IAAI,MAAM,CAAC;IAAC,SAAS,IAAI,MAAM,CAAA;CAAE;AACtE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IACxH,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;CACjD;AACD,eAAO,MAAM,oBAAoB,EAAE,aAA8E,CAAC;AAElH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,aAAa,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;IACrH,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CAoB/D;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,iBAAiB,EAAE,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,aAAa,GAAG,IAAI,CAItH;AACD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,iBAAiB,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,CAO9F;AAED,2FAA2F;AAC3F,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe,CAAyD;AACvI,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,iBAAiB,EAAE,IAAI,EAAE,mBAAmB,EACjG,KAAK,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAyB3E"}

package/dist/decision/execution.js

@@ -0,0 +1,79 @@
+import { createDecisionError } from './errors.js';
+import { resolveDecisionCorrelationId, unreportedDecisionUsage } from './receipt.js';
+import { parseDecisionRequest } from './request.js';
+import { isCorrelationId } from './validation.js';
+import { freezeDecisionData } from './descriptor-validation.js';
+export const defaultDecisionClock = { wall: () => Date.now(), monotonic: () => performance.now() };
+export function beginDecisionExecution(candidate, options) {
+    const clock = options.clock ?? defaultDecisionClock;
+    const start = clock.monotonic();
+    const parsed = parseDecisionRequest(candidate);
+    const generate = options.generateId ?? (() => globalThis.crypto.randomUUID());
+    let callId = null;
+    let correlationId = null;
+    try {
+        callId = generate();
+        correlationId = resolveDecisionCorrelationId(parsed.ok ? parsed.request.correlationId : undefined, generate);
+    }
+    catch { /* Failed metadata generation is a typed refusal, with safe mandatory IDs. */ }
+    const idError = !isCorrelationId(callId) || correlationId === null;
+    const receipt = { schemaVersion: 1,
+        callId: isCorrelationId(callId) ? callId : globalThis.crypto.randomUUID(),
+        correlationId: correlationId ?? globalThis.crypto.randomUUID(), evaluator: parsed.ok ? parsed.request.evaluator : null,
+        servedEvaluator: null, servedModelId: null, startedAt: new Date(clock.wall()).toISOString(),
+        finishedAt: new Date(clock.wall()).toISOString(), latencyMs: 0, dispatch: 'not-started', attempts: 0,
+        usage: unreportedDecisionUsage('not-dispatched'), cost: { status: 'not-incurred', amountMicroUsd: '0', source: 'no-dispatch' },
+        retention: { status: 'not-evaluated', basis: 'none', evidenceRefs: [], retentionDays: null },
+        budget: { state: 'not-admitted', overrun: false }, outcome: 'error' };
+    const timeout = Math.min(parsed.ok ? parsed.request.policy?.timeoutMs ?? 10000 : 10000, options.timeoutMs ?? 60000);
+    return { receipt, clock, start, deadline: start + timeout, signal: options.signal, idError, phase: 'preflight', expired: false };
+}
+export function decisionInterruption(execution, phase) {
+    return (execution.expired || execution.clock.monotonic() >= execution.deadline)
+        ? createDecisionError('TIMEOUT', phase)
+        : execution.signal?.aborted ? createDecisionError('CANCELLED', phase) : null;
+}
+export function closeDecisionReceipt(execution, error) {
+    const receipt = execution.receipt;
+    receipt.finishedAt = new Date(execution.clock.wall()).toISOString();
+    receipt.latencyMs = Math.max(0, execution.clock.monotonic() - execution.start);
+    receipt.outcome = error ? 'error' : 'verdict';
+    if (error)
+        receipt.errorCode = error.code;
+    else
+        delete receipt.errorCode;
+}
+/** Copies before crossing host boundaries: no live provider envelope or caller content. */
+export function copyDecisionReceipt(receipt) { return freezeDecisionData(structuredClone(receipt)); }
+export async function persistDecisionResult(execution, sink, error, verdict) {
+    execution.phase = 'settlement';
+    if (error)
+        closeDecisionReceipt(execution, error);
+    try {
+        await sink.persist(copyDecisionReceipt(execution.receipt));
+    }
+    catch {
+        error = createDecisionError('RECEIPT_UNAVAILABLE', 'settlement');
+        if (execution.receipt.attempts)
+            execution.receipt.budget.state = 'pending-reconciliation';
+        closeDecisionReceipt(execution, error);
+    }
+    // Persistence can complete after the caller's deadline; accounting is never replayed.
+    const interrupted = !error ? decisionInterruption(execution, execution.receipt.attempts ? 'settlement' : 'preflight') : null;
+    if (interrupted) {
+        error = interrupted;
+        if (execution.receipt.budget.state !== 'not-admitted' && execution.receipt.budget.state !== 'released') {
+            execution.receipt.budget.state = 'pending-reconciliation';
+            error.retryable = false;
+            delete error.retryAfterMs;
+        }
+    }
+    if (error) {
+        closeDecisionReceipt(execution, error);
+        return { kind: 'error', ok: false, error, receipt: copyDecisionReceipt(execution.receipt) };
+    }
+    if (!verdict)
+        throw new Error('Decision result requires validated evidence.');
+    return { kind: 'verdict', ok: true, verdict, receipt: copyDecisionReceipt(execution.receipt) };
+}
+//# sourceMappingURL=execution.js.map

package/dist/decision/execution.js.map

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

package/dist/decision/host-options.d.ts

@@ -0,0 +1,26 @@
+import type { AuthResolver } from '../auth.js';
+import type { DecisionSelectionOptions } from './service.js';
+import type { DecisionBudgetPort, DecisionReceiptSink } from './budget.js';
+import type { DecisionClock } from './execution.js';
+import type { EvaluatorRef } from './request.js';
+export interface DecisionPriceLookupKey {
+    providerId: string;
+    modelId: string;
+    /** Backend protocol, price authority and protocol-specific revision carried
+     * from the authoritative descriptor, so one revision cannot silently serve
+     * two authorities or protocols. */
+    protocol: string;
+    authority: string;
+    priceRevision: string;
+}
+export interface DecisionServiceOptions extends DecisionSelectionOptions {
+    resolveAuth: AuthResolver;
+    resolvePrice(key: DecisionPriceLookupKey): unknown | Promise<unknown>;
+    /** Closed over verified caller identity; request JSON never selects financial ownership. */
+    authorize(evaluator: EvaluatorRef): boolean | Promise<boolean>;
+    budget: DecisionBudgetPort;
+    receipts: DecisionReceiptSink;
+    clock?: DecisionClock;
+    generateId?: () => string;
+}
+//# sourceMappingURL=host-options.d.ts.map

package/dist/decision/host-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-options.d.ts","sourceRoot":"","sources":["../../src/decision/host-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IACpC;;uCAEmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;CAC5D;AAED,MAAM,WAAW,sBAAuB,SAAQ,wBAAwB;IACtE,WAAW,EAAE,YAAY,CAAC;IAC1B,YAAY,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,4FAA4F;IAC5F,SAAS,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;CAC3B"}

package/dist/decision/host-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=host-options.js.map

package/dist/decision/host-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-options.js","sourceRoot":"","sources":["../../src/decision/host-options.ts"],"names":[],"mappings":""}

package/dist/decision/host.d.ts

@@ -0,0 +1,14 @@
+/** Host custody and financial authority. Never import this surface into a consumer. */
+export { createDecisionService } from './service.js';
+export { createJevAdapter } from './adapter.js';
+export { createStructuredDecisionAdapter, STRUCTURED_CONTRACT_REVISION, STRUCTURED_SCORE_MEANING } from './structured.js';
+export { jevDescriptor } from './descriptor.js';
+export type { JevAdapterOptions } from './adapter.js';
+export type { StructuredDecisionTransport, StructuredProviderEnvelope, StructuredDecisionPayload, StructuredDecisionAdapterOptions, DecisionBackend } from './structured.js';
+export type { DecisionServiceOptions, DecisionPriceLookupKey } from './host-options.js';
+export type { DecisionHostPolicy } from './policy.js';
+export type { DecisionEvaluatorDescriptor, ResolvedDecisionCriterion } from './descriptor.js';
+export type { DecisionBudgetPort, DecisionReceiptSink, DecisionAdmission, DecisionAdmissionResult, DecisionDispatchResult, DecisionSettlement } from './budget.js';
+export type { DecisionPrice, DecisionQuote } from './pricing.js';
+export type { DecisionClock } from './execution.js';
+//# sourceMappingURL=host.d.ts.map

package/dist/decision/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/decision/host.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,+BAA+B,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC1H,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,gCAAgC,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC7K,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACxF,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,YAAY,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC9F,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,uBAAuB,EAC/F,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAClE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/decision/host.js

@@ -0,0 +1,6 @@
+/** Host custody and financial authority. Never import this surface into a consumer. */
+export { createDecisionService } from './service.js';
+export { createJevAdapter } from './adapter.js';
+export { createStructuredDecisionAdapter, STRUCTURED_CONTRACT_REVISION, STRUCTURED_SCORE_MEANING } from './structured.js';
+export { jevDescriptor } from './descriptor.js';
+//# sourceMappingURL=host.js.map

package/dist/decision/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/decision/host.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,+BAA+B,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC1H,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/decision/index.d.ts

@@ -0,0 +1,12 @@
+/** Consumer contracts and portable remote mesh client. */
+export type { EvaluatorRef, DecisionRequest, DecisionInputs, DecisionCriterion, DecisionRule, Json, MicroUsd } from './request.js';
+export type { DecisionVerdict, DecisionScore, ScoreScale } from './verdict.js';
+export type { DecisionAdapterResult } from './adapter.js';
+export type { DecisionError, DecisionErrorCode } from './errors.js';
+export type { DecisionClient, DecisionResult, DecisionReceipt, DecisionUsage, DecisionCost, RetentionReceipt, TokenCounter, TotalTokenCounter, DecisionConnectionFailure, RemoteDecisionClient } from './receipt.js';
+export { createRemoteDecisionClient } from './client.js';
+export { validateDecisionResult } from './validate-result.js';
+export type { RemoteDecisionClientOptions } from './client.js';
+export type { ResolvedDecisionCriterion } from './descriptor.js';
+export type { DecisionValidationContext, DecisionValidationProfile, DecisionValidationSemantics, DecisionValidationScoreSemantics, DecisionValidationConfidenceSemantics, DecisionRegisteredResolution, DirectDecisionCriterion, DecisionValidationContextResolver } from './validation-context.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/decision/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decision/index.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACnI,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/E,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACpE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAC1G,YAAY,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzG,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC/D,YAAY,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AACjE,YAAY,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,2BAA2B,EAC7F,gCAAgC,EAAE,qCAAqC,EAAE,4BAA4B,EACrG,uBAAuB,EAAE,iCAAiC,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/decision/index.js

@@ -0,0 +1,3 @@
+export { createRemoteDecisionClient } from './client.js';
+export { validateDecisionResult } from './validate-result.js';
+//# sourceMappingURL=index.js.map

package/dist/decision/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decision/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/decision/jev-codec.d.ts

@@ -0,0 +1,30 @@
+import type { DecisionRequest } from './request.js';
+import type { DecisionEvaluatorDescriptor, ResolvedDecisionCriterion } from './descriptor.js';
+import type { DecisionErrorCode } from './errors.js';
+export interface JevRequestBody {
+    model: string;
+    state: DecisionRequest['inputs'];
+    questions: {
+        verdict: {
+            type: 'noul' | 'score' | 'choice';
+            instructions: string;
+            criteria?: {
+                true: string;
+                false: string;
+            } | readonly string[] | Record<string, string>;
+        };
+    };
+}
+export type JevEncoding = {
+    ok: true;
+    body: JevRequestBody;
+    bodyJson: string;
+    request: DecisionRequest;
+    criterion: ResolvedDecisionCriterion;
+} | {
+    ok: false;
+    code: DecisionErrorCode;
+};
+/** One question, no instruction/content concatenation, coercion or omitted significant fields. */
+export declare function encodeJevRequest(candidate: unknown, descriptor: DecisionEvaluatorDescriptor): JevEncoding;
+//# sourceMappingURL=jev-codec.d.ts.map

package/dist/decision/jev-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jev-codec.d.ts","sourceRoot":"","sources":["../../src/decision/jev-codec.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAG9F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IACjC,SAAS,EAAE;QAAE,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;YAAC,YAAY,EAAE,MAAM,CAAC;YAC9E,QAAQ,CAAC,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAA;aAAE,GAAG,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC;CAC/F;AACD,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,eAAe,CAAC;IAAC,SAAS,EAAE,yBAAyB,CAAA;CAAE,GAC1I;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAE3C,kGAAkG;AAClG,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,2BAA2B,GAAG,WAAW,CAoCzG"}

package/dist/decision/jev-codec.js

@@ -0,0 +1,51 @@
+import { parseDecisionRequest } from './request.js';
+import { isDecisionCriterion } from './criterion.js';
+import { snapshotBoundedJson } from './validation.js';
+/** One question, no instruction/content concatenation, coercion or omitted significant fields. */
+export function encodeJevRequest(candidate, descriptor) {
+    const parsed = parseDecisionRequest(candidate);
+    if (!parsed.ok)
+        return parsed;
+    const request = parsed.request;
+    if (request.evaluator.providerId !== descriptor.evaluator.providerId
+        || request.evaluator.evaluatorId !== descriptor.evaluator.evaluatorId)
+        return { ok: false, code: 'EVALUATOR_UNKNOWN' };
+    if (request.evaluator.revision !== descriptor.evaluator.revision)
+        return { ok: false, code: 'REVISION_MISMATCH' };
+    let criterion;
+    if (request.criterion.kind === 'registered') {
+        const ref = request.criterion;
+        const found = descriptor.registeredCriteria.find((entry) => entry.criteriaId === ref.criteriaId && entry.revision === ref.revision);
+        const snapshot = snapshotBoundedJson(found?.criterion);
+        if (!snapshot.ok || !isDecisionCriterion(snapshot.value) || snapshot.value.kind === 'registered') {
+            return { ok: false, code: 'CAPABILITY_UNSUPPORTED' };
+        }
+        criterion = snapshot.value;
+    }
+    else
+        criterion = request.criterion;
+    if ((criterion.kind === 'graded' && (criterion.levels.length < 2 || criterion.levels.length > 10))
+        || (criterion.kind === 'choice' && criterion.options.length > 255))
+        return { ok: false, code: 'CAPABILITY_UNSUPPORTED' };
+    const question = { type: criterion.kind === 'binary' ? 'noul'
+            : criterion.kind === 'graded' ? 'score' : 'choice', instructions: criterion.instructions };
+    if (criterion.kind === 'binary' && criterion.criteria)
+        question.criteria = { ...criterion.criteria };
+    if (criterion.kind === 'graded')
+        question.criteria = criterion.levels.map((level) => level.description);
+    if (criterion.kind === 'choice')
+        question.criteria = Object.fromEntries(criterion.options.map((option) => [option.id, option.description]));
+    const body = { model: descriptor.wireModel, state: request.inputs, questions: { verdict: question } };
+    // JSON.stringify reorders integer-like map keys; serialize choice entries in caller order.
+    const questionJson = criterion.kind !== 'choice' ? JSON.stringify(question)
+        : JSON.stringify({ type: question.type, instructions: question.instructions }).slice(0, -1)
+            + ',"criteria":{' + criterion.options.map((option) => JSON.stringify(option.id) + ':' + JSON.stringify(option.description)).join(',') + '}}';
+    const stateJson = JSON.stringify(body.state);
+    const bodyJson = '{"model":' + JSON.stringify(body.model) + ',"state":' + stateJson + ',"questions":{"verdict":' + questionJson + '}}';
+    const bytes = (value) => new TextEncoder().encode(value).byteLength;
+    if (bytes(bodyJson) > descriptor.maxRequestBytes || bytes(stateJson) + bytes(questionJson) > descriptor.maxStateQuestionBytes) {
+        return { ok: false, code: 'REQUEST_INVALID' };
+    }
+    return { ok: true, body, bodyJson, request, criterion };
+}
+//# sourceMappingURL=jev-codec.js.map

package/dist/decision/jev-codec.js.map

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

package/dist/decision/jev-response.d.ts

@@ -0,0 +1,7 @@
+import type { DecisionAdapterResult } from './adapter.js';
+import type { DecisionEvaluatorDescriptor } from './descriptor.js';
+import type { DecisionRequest } from './request.js';
+export declare const sanitizeJevId: (value: unknown) => string | null;
+/** Validate identity, counters and verdict separately; refusal never discards valid counters. */
+export declare function decodeJevResponse(candidate: unknown, request: DecisionRequest, descriptor: DecisionEvaluatorDescriptor, requestId?: unknown): DecisionAdapterResult;
+//# sourceMappingURL=jev-response.d.ts.map

package/dist/decision/jev-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jev-response.d.ts","sourceRoot":"","sources":["../../src/decision/jev-response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAMpD,eAAO,MAAM,aAAa,UAAW,OAAO,KAAG,MAAM,GAAG,IACc,CAAC;AAGvE,iGAAiG;AACjG,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,2BAA2B,EACrH,SAAS,CAAC,EAAE,OAAO,GAAG,qBAAqB,CA6B5C"}

package/dist/decision/jev-response.js

@@ -0,0 +1,42 @@
+import { createDecisionError } from './errors.js';
+import { parseDecisionUsage, unreportedDecisionUsage } from './receipt.js';
+import { decodeJevVerdict } from './jev-verdict.js';
+import { has, hasOnlyKeys, isRecord, snapshotBoundedJson } from './validation.js';
+export const sanitizeJevId = (value) => typeof value === 'string'
+    && /^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$/.test(value) ? value : null;
+const count = (value) => typeof value === 'number' && Number.isSafeInteger(value) && value >= 0;
+/** Validate identity, counters and verdict separately; refusal never discards valid counters. */
+export function decodeJevResponse(candidate, request, descriptor, requestId) {
+    const snapshot = snapshotBoundedJson(candidate);
+    const body = snapshot.ok && isRecord(snapshot.value) ? snapshot.value : null;
+    const servedModelId = sanitizeJevId(body?.model);
+    const providerRequestId = sanitizeJevId(requestId);
+    const answered = body && isRecord(body.answers) && Object.keys(body.answers).length === 1
+        && has(body.answers, 'verdict') && isRecord(body.answers.verdict);
+    const nativeUsage = body && isRecord(body.usage) ? body.usage : {};
+    const input = count(nativeUsage.input_tokens) ? nativeUsage.input_tokens : null;
+    const output = count(nativeUsage.output_tokens) ? nativeUsage.output_tokens : null;
+    const total = input !== null && output !== null && count(input + output) ? input + output : null;
+    const token = (value) => value === null ? { value: null, source: 'not-reported' }
+        : { value, source: 'provider' };
+    const usage = parseDecisionUsage({ tokens: { input: token(input), output: token(output),
+            total: total === null ? token(null) : { value: total, source: 'derived-sum' } },
+        evaluatorCalls: answered ? 1 : null, explanations: answered ? 0 : null }) ?? unreportedDecisionUsage('unknown');
+    const identityMatches = servedModelId !== null && descriptor.qualification.servedIdentity === 'qualified'
+        && descriptor.acceptedServedModelIds.includes(servedModelId);
+    const evidence = { usage, servedModelId, servedEvaluator: identityMatches ? { ...descriptor.evaluator } : null,
+        ...(providerRequestId === null ? {} : { providerRequestId }) };
+    if (!body)
+        return { ok: false, error: createDecisionError('VERDICT_INVALID', 'parse'), ...evidence };
+    if (!identityMatches)
+        return { ok: false, error: createDecisionError('SERVED_IDENTITY_MISMATCH', 'parse'), ...evidence };
+    if (input === null || output === null || total === null || !hasOnlyKeys(nativeUsage, ['input_tokens', 'output_tokens'])) {
+        return { ok: false, error: createDecisionError('USAGE_INVALID', 'parse'), ...evidence };
+    }
+    if (!answered)
+        return { ok: false, error: createDecisionError('VERDICT_INVALID', 'parse'), ...evidence };
+    const verdict = decodeJevVerdict(body.answers.verdict, request, descriptor);
+    return verdict.ok ? { ok: true, verdict: verdict.verdict, ...evidence }
+        : { ok: false, error: createDecisionError(verdict.code, 'parse'), ...evidence };
+}
+//# sourceMappingURL=jev-response.js.map

package/dist/decision/jev-response.js.map

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

package/dist/decision/jev-verdict.d.ts

@@ -0,0 +1,14 @@
+import type { DecisionEvaluatorDescriptor } from './descriptor.js';
+import type { DecisionRequest } from './request.js';
+import type { DecisionErrorCode } from './errors.js';
+import type { DecisionVerdict } from './verdict.js';
+export type JevVerdictResult = {
+    ok: true;
+    verdict: DecisionVerdict;
+} | {
+    ok: false;
+    code: DecisionErrorCode;
+};
+/** Build a fresh typed envelope only from validated request and native-value snapshots. */
+export declare function decodeJevVerdict(candidate: unknown, request: DecisionRequest, descriptor: DecisionEvaluatorDescriptor): JevVerdictResult;
+//# sourceMappingURL=jev-verdict.d.ts.map

package/dist/decision/jev-verdict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jev-verdict.d.ts","sourceRoot":"","sources":["../../src/decision/jev-verdict.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,MAAM,MAAM,gBAAgB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAC/G,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,2BAA2B,GAAG,gBAAgB,CAiDxI"}

package/dist/decision/jev-verdict.js

@@ -0,0 +1,71 @@
+import { encodeJevRequest } from './jev-codec.js';
+import { deriveDecision, mapDecisionDistribution, parseDecisionConfidence, parseDecisionScore } from './verdict.js';
+import { hasOnlyKeys, isRecord, snapshotBoundedJson } from './validation.js';
+/** Build a fresh typed envelope only from validated request and native-value snapshots. */
+export function decodeJevVerdict(candidate, request, descriptor) {
+    const encoded = encodeJevRequest(request, descriptor);
+    if (!encoded.ok)
+        return encoded;
+    const snapshot = snapshotBoundedJson(candidate);
+    const invalid = { ok: false, code: 'VERDICT_INVALID' };
+    if (!snapshot.ok || !isRecord(snapshot.value))
+        return invalid;
+    const answer = snapshot.value;
+    const { criterion } = encoded;
+    let score = null;
+    let label = null;
+    let confidence = null;
+    let distribution = null;
+    let declaredLabels = [];
+    if (criterion.kind === 'binary') {
+        if (!hasOnlyKeys(answer, ['noul']))
+            return invalid;
+        score = parseDecisionScore({ value: answer.noul, meaning: 'probability-true',
+            scale: { kind: 'bounded', min: 0, max: 1, direction: 'unordered' } });
+        if (!score)
+            return invalid;
+    }
+    else if (criterion.kind === 'choice') {
+        if (!hasOnlyKeys(answer, ['choice', 'probabilities', 'confidence']))
+            return invalid;
+        declaredLabels = criterion.options.map((option) => option.id);
+        distribution = mapDecisionDistribution(answer.probabilities, declaredLabels.map((outcome) => ({ outcome, nativeOutcome: outcome })));
+        if (!distribution || typeof answer.choice !== 'string')
+            return invalid;
+        const selected = distribution.find((entry) => entry.outcome === answer.choice);
+        if (!selected || selected.probability !== Math.max(...distribution.map((entry) => entry.probability)))
+            return invalid;
+        label = { value: selected.outcome, origin: 'provider' };
+        confidence = parseDecisionConfidence({ value: answer.confidence, ...descriptor.confidence, origin: 'provider' });
+        if (!confidence || confidence.meaning !== 'provider-confidence')
+            return invalid;
+    }
+    else {
+        if (!hasOnlyKeys(answer, ['score', 'probabilities', 'legend', 'confidence']) || !isRecord(answer.legend)
+            || Object.keys(answer.legend).length !== criterion.levels.length)
+            return invalid;
+        const outcomes = criterion.levels.map((level, index) => ({ outcome: level.label, nativeOutcome: String(index) }));
+        const legend = answer.legend;
+        if (!outcomes.every((entry, index) => legend[entry.nativeOutcome] === criterion.levels[index].description))
+            return invalid;
+        distribution = mapDecisionDistribution(answer.probabilities, outcomes);
+        score = parseDecisionScore({ value: answer.score, meaning: 'rubric-grade',
+            scale: { kind: 'bounded', min: 0, max: criterion.levels.length - 1, direction: criterion.direction } });
+        confidence = parseDecisionConfidence({ value: answer.confidence, ...descriptor.confidence, origin: 'provider' });
+        if (!distribution || !score || !confidence || confidence.meaning !== 'provider-confidence')
+            return invalid;
+        const weighted = distribution.reduce((sum, entry, index) => sum + index * entry.probability, 0);
+        if (Math.abs(weighted - score.value) > descriptor.probabilityTolerance)
+            return invalid;
+    }
+    if (distribution && Math.abs(distribution.reduce((sum, entry) => sum + entry.probability, 0) - 1)
+        > descriptor.probabilityTolerance)
+        return invalid;
+    const decision = deriveDecision({ rule: encoded.request.decision, score, label: label?.value ?? null,
+        providerDecision: null, declaredLabels });
+    if (!decision.ok)
+        return decision;
+    return { ok: true, verdict: { criterionKind: encoded.request.criterion.kind, resolvedCriterionKind: criterion.kind,
+            score, label, decision: decision.decision, rationale: null, confidence, distribution } };
+}
+//# sourceMappingURL=jev-verdict.js.map

package/dist/decision/jev-verdict.js.map

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