@sentropic/llm-mesh 0.28.0 → 0.29.0

package/dist/decision/adapter-result.js

@@ -0,0 +1,160 @@
+import { createDecisionError, isDecisionErrorCode } from './errors.js';
+import { parseDecisionUsage, unreportedDecisionUsage } from './receipt.js';
+import { encodeJevRequest } from './jev-codec.js';
+import { decodeJevVerdict } from './jev-verdict.js';
+import { sanitizeJevId } from './jev-response.js';
+import { hasOnlyKeys, isRecord, isText, snapshotBoundedJson } from './validation.js';
+import { parseJevProviderRaw } from './raw.js';
+import { deriveDecision } from './verdict.js';
+import { STRUCTURED_SCORE_MEANING } from './structured.js';
+import { encodeOpenAiDecisionsRequest } from './openai-request.js';
+import { openAiDecisionsContext } from './openai-verdict.js';
+import { isValidDecisionVerdict } from './client.js';
+/** Closed structured envelope at the host boundary (V-K1/V-K2). Undeclared
+ * carriers, substituted score meaning/scale/direction and provider raw data
+ * are rejected; the surviving verdict is rebuilt field by field from
+ * validated values bound to the descriptor and request criterion. */
+const STRUCTURED_HOST_VERDICT_KEYS = ['criterionKind', 'resolvedCriterionKind', 'score', 'decision', 'label',
+    'rationale', 'confidence', 'distribution'];
+function parseStructuredHostVerdict(candidate, request, descriptor) {
+    if (!isRecord(candidate) || request.criterion.kind === 'registered')
+        return null;
+    if (!hasOnlyKeys(candidate, [...STRUCTURED_HOST_VERDICT_KEYS]))
+        return null;
+    if (candidate.criterionKind !== request.criterion.kind || candidate.resolvedCriterionKind !== request.criterion.kind)
+        return null;
+    if (candidate.distribution !== null || candidate.rationale !== null || candidate.confidence !== null)
+        return null;
+    if (Object.hasOwn(candidate, 'providerRaw'))
+        return null;
+    const expectedMeaning = descriptor.scoreSemantics?.meaning
+        ?? ((descriptor.protocol ?? 'structured-llm') === 'structured-llm' ? STRUCTURED_SCORE_MEANING : null);
+    if (expectedMeaning === null)
+        return null;
+    if (request.criterion.kind === 'choice') {
+        if (!isRecord(candidate.label) || !hasOnlyKeys(candidate.label, ['value', 'origin'])
+            || candidate.label.origin !== 'provider' || !isText(candidate.label.value) || candidate.score !== null)
+            return null;
+        const labelValue = candidate.label.value;
+        if (!request.criterion.options.some((option) => option.id === labelValue))
+            return null;
+        const derived = deriveDecision({ rule: request.decision, score: null, label: labelValue,
+            providerDecision: null, declaredLabels: request.criterion.options.map((option) => option.id) });
+        if (!derived.ok || JSON.stringify(derived.decision) !== JSON.stringify(candidate.decision))
+            return null;
+        return { verdict: { criterionKind: 'choice', resolvedCriterionKind: 'choice', score: null,
+                decision: derived.decision, label: { value: labelValue, origin: 'provider' },
+                rationale: null, confidence: null, distribution: null } };
+    }
+    if (request.criterion.kind !== 'binary' && request.criterion.kind !== 'graded')
+        return null;
+    if (candidate.label !== null || !isRecord(candidate.score))
+        return null;
+    const score = candidate.score;
+    if (!hasOnlyKeys(score, ['value', 'meaning', 'scale']) || score.meaning !== expectedMeaning)
+        return null;
+    if (!isRecord(score.scale) || !hasOnlyKeys(score.scale, ['kind', 'min', 'max', 'direction']))
+        return null;
+    const scale = score.scale;
+    const max = request.criterion.kind === 'graded' ? request.criterion.levels.length - 1 : 1;
+    const direction = request.criterion.kind === 'graded' ? request.criterion.direction : 'unordered';
+    if (scale.kind !== 'bounded' || scale.min !== 0 || scale.max !== max || scale.direction !== direction)
+        return null;
+    if (typeof score.value !== 'number' || !Number.isFinite(score.value) || score.value < 0 || score.value > max)
+        return null;
+    const rebuiltScore = { value: score.value, meaning: expectedMeaning,
+        scale: { kind: 'bounded', min: 0, max, direction } };
+    const derived = deriveDecision({ rule: request.decision, score: rebuiltScore, label: null, providerDecision: null });
+    if (!derived.ok || JSON.stringify(derived.decision) !== JSON.stringify(candidate.decision))
+        return null;
+    return { verdict: { criterionKind: request.criterion.kind, resolvedCriterionKind: request.criterion.kind,
+            score: rebuiltScore, decision: derived.decision, label: null,
+            rationale: null, confidence: null, distribution: null } };
+}
+/** Rebuild the JEV verdict from native evidence, never return a live plugin envelope. */
+export function parseDecisionAdapterResult(candidate, request, descriptor, secret) {
+    const snapshot = snapshotBoundedJson(candidate);
+    const value = snapshot.ok && isRecord(snapshot.value) ? snapshot.value : {};
+    const usage = parseDecisionUsage(value.usage) ?? unreportedDecisionUsage('unknown');
+    const safeId = (id) => typeof id === 'string' && id.includes(secret) ? undefined : sanitizeJevId(id);
+    const servedModelId = safeId(value.servedModelId) ?? null;
+    const providerRequestId = safeId(value.providerRequestId);
+    const matched = servedModelId !== null && descriptor.acceptedServedModelIds.includes(servedModelId);
+    const evidence = { usage, servedModelId, servedEvaluator: matched ? { ...descriptor.evaluator } : null,
+        ...(providerRequestId ? { providerRequestId } : {}),
+        ...(typeof value.providerLatencyMs === 'number' && Number.isFinite(value.providerLatencyMs) && value.providerLatencyMs >= 0
+            ? { providerLatencyMs: value.providerLatencyMs } : {}) };
+    const failed = (code, phase = 'parse') => ({ ok: false, error: createDecisionError(code, phase), ...evidence });
+    if (value.ok === false) {
+        const error = isRecord(value.error) ? value.error : {};
+        return failed(isDecisionErrorCode(error.code) ? error.code : 'VERDICT_INVALID', error.phase === 'parse' ? 'parse' : 'dispatch');
+    }
+    if (value.ok !== true)
+        return failed('VERDICT_INVALID');
+    if (!matched)
+        return failed('SERVED_IDENTITY_MISMATCH');
+    if (usage.tokens.input.source !== 'provider' || usage.tokens.output.source !== 'provider'
+        || usage.evaluatorCalls !== 1 || usage.explanations !== 0)
+        return failed('USAGE_INVALID');
+    if (descriptor.protocol === 'openai-decisions') {
+        const encoded = encodeOpenAiDecisionsRequest(request, descriptor);
+        if (!encoded.ok || !isValidDecisionVerdict(value.verdict, encoded.request, openAiDecisionsContext(encoded.request, encoded.criterion, descriptor)) || value.verdict.providerRaw !== undefined)
+            return failed('VERDICT_INVALID');
+        const verdict = value.verdict;
+        return { ok: true, verdict: { criterionKind: verdict.criterionKind, resolvedCriterionKind: verdict.resolvedCriterionKind,
+                score: structuredClone(verdict.score), decision: structuredClone(verdict.decision), label: structuredClone(verdict.label),
+                rationale: null, confidence: structuredClone(verdict.confidence), distribution: structuredClone(verdict.distribution) }, ...evidence };
+    }
+    if ((descriptor.protocol ?? 'jev-native') !== 'jev-native') {
+        const closed = parseStructuredHostVerdict(value.verdict, request, descriptor);
+        if (!closed)
+            return failed('VERDICT_INVALID');
+        return { ok: true, verdict: closed.verdict, ...evidence };
+    }
+    const encoded = encodeJevRequest(request, descriptor);
+    const verdict = value.verdict;
+    if (!encoded.ok || !isRecord(verdict))
+        return failed('VERDICT_INVALID');
+    let native;
+    if (encoded.criterion.kind === 'binary') {
+        native = isRecord(verdict.score) ? { noul: verdict.score.value } : null;
+    }
+    else {
+        if (!Array.isArray(verdict.distribution))
+            return failed('VERDICT_INVALID');
+        const probabilities = Object.create(null);
+        for (const item of verdict.distribution) {
+            if (!isRecord(item) || typeof item.nativeOutcome !== 'string')
+                return failed('VERDICT_INVALID');
+            probabilities[item.nativeOutcome] = item.probability;
+        }
+        const confidence = isRecord(verdict.confidence) ? verdict.confidence.value : null;
+        native = encoded.criterion.kind === 'choice'
+            ? { choice: isRecord(verdict.label) ? verdict.label.value : null, probabilities, confidence }
+            : { score: isRecord(verdict.score) ? verdict.score.value : null, probabilities, confidence,
+                legend: Object.fromEntries(encoded.criterion.levels.map((level, index) => [String(index), level.description])) };
+    }
+    const decoded = decodeJevVerdict(native, request, descriptor);
+    // Compare detached data structurally, so property insertion order has no authority.
+    const { providerRaw, ...typed } = verdict;
+    if (!decoded.ok || !sameJson(typed, decoded.verdict))
+        return failed('VERDICT_INVALID');
+    if (Object.hasOwn(verdict, 'providerRaw')) {
+        const raw = parseJevProviderRaw(providerRaw, native, request);
+        if (!raw)
+            return failed('VERDICT_INVALID');
+        decoded.verdict.providerRaw = raw;
+    }
+    return { ok: true, verdict: decoded.verdict, ...evidence };
+}
+function sameJson(left, right) {
+    if (left === right)
+        return true;
+    if (Array.isArray(left) && Array.isArray(right))
+        return left.length === right.length && left.every((v, i) => sameJson(v, right[i]));
+    if (!isRecord(left) || !isRecord(right))
+        return false;
+    const keys = Object.keys(left);
+    return keys.length === Object.keys(right).length && keys.every((key) => Object.hasOwn(right, key) && sameJson(left[key], right[key]));
+}
+//# sourceMappingURL=adapter-result.js.map

package/dist/decision/adapter-result.js.map

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

package/dist/decision/adapter.d.ts

@@ -0,0 +1,58 @@
+import type { DecisionError } from './errors.js';
+import type { EvaluatorRef } from './request.js';
+import type { DecisionUsage } from './receipt.js';
+import type { DecisionVerdict } from './verdict.js';
+import type { DecisionRequest } from './request.js';
+import type { ProviderAdapter, ProviderRuntimeContext } from '../registry.js';
+import type { GenerateRequest, GenerateResponse, StreamRequest, StreamResult } from '../generation.js';
+import type { AuthInput } from '../auth.js';
+import type { JevTransport } from '../transport/jev.js';
+import type { DecisionEvaluatorDescriptor } from './descriptor.js';
+/** Adapter evidence stays available when verdict validation fails after dispatch. */
+interface DecisionAdapterEvidence {
+    usage: DecisionUsage;
+    servedEvaluator: EvaluatorRef | null;
+    servedModelId: string | null;
+    providerRequestId?: string;
+    providerLatencyMs?: number;
+}
+/** Implementations must validate verdict/usage independently and sanitize upstream IDs. */
+export type DecisionAdapterResult = DecisionAdapterEvidence & ({
+    ok: true;
+    verdict: DecisionVerdict;
+} | {
+    ok: false;
+    error: DecisionError;
+});
+export interface JevAdapterOptions {
+    transport: JevTransport;
+    descriptor?: DecisionEvaluatorDescriptor;
+}
+export declare class JevAdapter implements ProviderAdapter {
+    private readonly options;
+    readonly provider: import("../catalog.js").ProviderDescriptor;
+    readonly descriptor: DecisionEvaluatorDescriptor;
+    constructor(options: JevAdapterOptions);
+    listModels(): never[];
+    listEvaluators(): {
+        providerId: "openai" | "gemini" | "anthropic" | "mistral" | "cohere" | "gcp" | "local" | "muse" | "typesafe";
+        evaluatorId: string;
+        revision: string;
+    }[];
+    validateAuth(source?: AuthInput): {
+        ok: boolean;
+    };
+    generate(_request: GenerateRequest): Promise<GenerateResponse>;
+    stream(_request: StreamRequest): Promise<StreamResult>;
+    normalizeError(_error: unknown): {
+        providerId: "typesafe";
+        message: string;
+        retryable: boolean;
+    };
+    decision(request: DecisionRequest, context?: ProviderRuntimeContext & {
+        signal?: AbortSignal;
+    }): Promise<DecisionAdapterResult>;
+}
+export declare const createJevAdapter: (options: JevAdapterOptions) => JevAdapter;
+export {};
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/decision/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACvG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AAE5E,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AASnE,qFAAqF;AACrF,UAAU,uBAAuB;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,eAAe,EAAE,YAAY,GAAG,IAAI,CAAC;IACrC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,2FAA2F;AAC3F,MAAM,MAAM,qBAAqB,GAAG,uBAAuB,GAAG,CAC1D;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GACtC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,CACtC,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAAG,SAAS,EAAE,YAAY,CAAC;IAAC,UAAU,CAAC,EAAE,2BAA2B,CAAA;CAAE;AACxG,qBAAa,UAAW,YAAW,eAAe;IAGpC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,QAAQ,CAAC,QAAQ,6CAAkC;IACnD,QAAQ,CAAC,UAAU,EAAE,2BAA2B,CAAC;gBACpB,OAAO,EAAE,iBAAiB;IAKvD,UAAU;IACV,cAAc;;;;;IACd,YAAY,CAAC,MAAM,CAAC,EAAE,SAAS;;;IAMzB,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAC9D,MAAM,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAC5D,cAAc,CAAC,MAAM,EAAE,OAAO;;;;;IACxB,QAAQ,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;CA6BtI;AACD,eAAO,MAAM,gBAAgB,YAAa,iBAAiB,KAAG,UAAqC,CAAC"}

package/dist/decision/adapter.js

@@ -0,0 +1,70 @@
+import { getSecretAuthMaterial } from '../auth.js';
+import { getProviderProfile } from '../catalog.js';
+import { jevDescriptor } from './descriptor.js';
+import { parseDecisionEvaluatorDescriptor } from './descriptor-validation.js';
+import { encodeJevRequest } from './jev-codec.js';
+import { decodeJevResponse } from './jev-response.js';
+import { createDecisionError, isDecisionErrorCode } from './errors.js';
+import { unreportedDecisionUsage } from './receipt.js';
+import { isRecord, snapshotBoundedJson } from './validation.js';
+import { makeJevProviderRaw } from './raw.js';
+export class JevAdapter {
+    options;
+    provider = getProviderProfile('typesafe');
+    descriptor;
+    constructor(options) {
+        this.options = options;
+        const descriptor = parseDecisionEvaluatorDescriptor(options.descriptor ?? jevDescriptor);
+        if (!descriptor)
+            throw new Error('Invalid JEV descriptor.');
+        this.descriptor = descriptor;
+    }
+    listModels() { return []; }
+    listEvaluators() { return [{ ...this.descriptor.evaluator }]; }
+    validateAuth(source) {
+        const auth = getSecretAuthMaterial(source);
+        return { ok: auth?.type === 'environment-token' && auth.envVar === 'JEV_API_KEY'
+                && typeof auth.token === 'string' && auth.token.trim().length > 0 && auth.token === auth.token.trim()
+                && !/[\r\n]/.test(auth.token) };
+    }
+    async generate(_request) { throw new Error('JEV does not support chat.'); }
+    async stream(_request) { throw new Error('JEV does not support chat.'); }
+    normalizeError(_error) { return { providerId: 'typesafe', message: 'JEV operation failed.', retryable: false }; }
+    async decision(request, context) {
+        const empty = { usage: unreportedDecisionUsage('not-dispatched'), servedEvaluator: null, servedModelId: null };
+        const encoded = encodeJevRequest(request, this.descriptor);
+        if (!encoded.ok)
+            return { ok: false, error: createDecisionError(encoded.code, 'preflight'), ...empty };
+        if (this.descriptor.qualification.servedIdentity !== 'qualified') {
+            return { ok: false, error: createDecisionError('PROVIDER_UNAVAILABLE', 'preflight'), ...empty };
+        }
+        const auth = getSecretAuthMaterial(context?.auth);
+        if (!this.validateAuth(context?.auth).ok || auth?.type !== 'environment-token' || !auth.token) {
+            return { ok: false, error: createDecisionError('CREDENTIAL_MISSING', 'preflight'), ...empty };
+        }
+        let result;
+        try {
+            result = await this.options.transport.send(encoded.bodyJson, auth.token, { signal: context?.signal, timeoutMs: encoded.request.policy?.timeoutMs });
+        }
+        catch {
+            return { ok: false, error: createDecisionError('TRANSPORT_FAILED', 'dispatch'),
+                ...empty, usage: unreportedDecisionUsage('unknown') };
+        }
+        if (!result.ok)
+            return { ok: false, error: createDecisionError(isDecisionErrorCode(result.error.code) ? result.error.code : 'TRANSPORT_FAILED', result.error.phase === 'parse' ? 'parse' : 'dispatch'), ...empty, usage: unreportedDecisionUsage('unknown') };
+        const snapshot = snapshotBoundedJson(result.body);
+        const body = snapshot.ok ? snapshot.value : null;
+        if (isRecord(body) && typeof body.model === 'string' && body.model.includes(auth.token))
+            body.model = null;
+        const requestId = result.providerRequestId?.includes(auth.token) ? undefined : result.providerRequestId;
+        const decoded = decodeJevResponse(body, encoded.request, this.descriptor, requestId);
+        if (decoded.ok && isRecord(body) && isRecord(body.answers)) {
+            const raw = makeJevProviderRaw(body.answers.verdict, encoded.request);
+            if (raw)
+                decoded.verdict.providerRaw = raw;
+        }
+        return decoded;
+    }
+}
+export const createJevAdapter = (options) => new JevAdapter(options);
+//# sourceMappingURL=adapter.js.map

package/dist/decision/adapter.js.map

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

package/dist/decision/admission.d.ts

@@ -0,0 +1,23 @@
+import type { AuthResolution } from '../auth.js';
+import type { DecisionError } from './errors.js';
+import type { DecisionServiceOptions } from './host-options.js';
+import type { DecisionSelection } from './service.js';
+import type { DecisionExecution } from './execution.js';
+import type { DecisionQuote } from './pricing.js';
+export type AdmittedDecision = {
+    ok: true;
+    holdId: string;
+    quote: DecisionQuote;
+    auth: AuthResolution;
+} | {
+    ok: false;
+    error: DecisionError;
+};
+export declare function decisionAuthority(options: DecisionServiceOptions, selection: Extract<DecisionSelection, {
+    ok: true;
+}>): Promise<boolean>;
+export declare function releaseUnsentDecision(execution: DecisionExecution, options: DecisionServiceOptions, holdId: string, error: DecisionError): Promise<AdmittedDecision>;
+export declare function admitDecision(execution: DecisionExecution, selection: Extract<DecisionSelection, {
+    ok: true;
+}>, options: DecisionServiceOptions): Promise<AdmittedDecision>;
+//# sourceMappingURL=admission.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"admission.d.ts","sourceRoot":"","sources":["../../src/decision/admission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAIlD,MAAM,MAAM,gBAAgB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GACnG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC;AACxC,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,sBAAsB,EAAE,SAAS,EAAE,OAAO,CAAC,iBAAiB,EAAE;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAG9I;AACD,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,sBAAsB,EACvG,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAQjE;AAED,wBAAsB,aAAa,CAAC,SAAS,EAAE,iBAAiB,EAAE,SAAS,EAAE,OAAO,CAAC,iBAAiB,EAAE;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,CAAC,EACnH,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoE5D"}

package/dist/decision/admission.js

@@ -0,0 +1,115 @@
+import { createDecisionError } from './errors.js';
+import { resolveDecisionAuth } from './service.js';
+import { decisionInterruption } from './execution.js';
+import { quoteDecision, priceDecisionUsage } from './pricing.js';
+import { unreportedDecisionUsage } from './receipt.js';
+import { isCorrelationId } from './validation.js';
+export async function decisionAuthority(options, selection) {
+    try {
+        return await options.authorize({ ...selection.descriptor.evaluator }) === true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function releaseUnsentDecision(execution, options, holdId, error) {
+    try {
+        await options.budget.release({ holdId, callId: execution.receipt.callId });
+        execution.receipt.budget.state = 'released';
+        execution.receipt.dispatch = 'not-started';
+        execution.receipt.cost = { status: 'not-incurred', amountMicroUsd: '0', source: 'no-dispatch' };
+        return { ok: false, error };
+    }
+    catch {
+        return { ok: false, error: createDecisionError('SETTLEMENT_UNAVAILABLE', 'settlement') };
+    }
+}
+export async function admitDecision(execution, selection, options) {
+    const failed = (error) => ({ ok: false, error });
+    execution.phase = 'admission';
+    let expired = decisionInterruption(execution, 'admission');
+    if (expired)
+        return failed(expired);
+    if (!await decisionAuthority(options, selection))
+        return failed(createDecisionError('AUTHORIZATION_DENIED', 'preflight'));
+    expired = decisionInterruption(execution, 'admission');
+    if (expired)
+        return failed(expired);
+    let candidate;
+    try {
+        candidate = await options.resolvePrice({ providerId: selection.descriptor.evaluator.providerId,
+            modelId: selection.descriptor.wireModel, protocol: selection.descriptor.protocol ?? 'jev-native',
+            authority: selection.descriptor.priceProtocol.authority, priceRevision: selection.descriptor.priceProtocol.revision });
+    }
+    catch {
+        return failed(createDecisionError('PRICING_UNAVAILABLE', 'admission'));
+    }
+    expired = decisionInterruption(execution, 'admission');
+    if (expired)
+        return failed(expired);
+    const quoted = quoteDecision(selection.request, selection.descriptor, candidate, options.policy?.maxCostMicroUsd);
+    if (!quoted.ok)
+        return failed(createDecisionError(quoted.code, 'admission'));
+    execution.phase = 'preflight';
+    const resolved = await resolveDecisionAuth(selection.descriptor, options.resolveAuth);
+    if (!resolved.ok)
+        return failed(createDecisionError(resolved.code, 'preflight'));
+    const interrupted = decisionInterruption(execution, 'admission');
+    if (interrupted)
+        return failed(interrupted);
+    const { quote } = quoted;
+    execution.phase = 'admission';
+    // Expose pending liability before awaiting admission: a late durable hold may exist.
+    execution.receipt.budget = { state: 'pending-reconciliation', reservedMicroUsd: quote.reservedMicroUsd, overrun: false };
+    execution.receipt.cost = priceDecisionUsage(unreportedDecisionUsage('unknown'), quote).cost;
+    const deadlineAt = execution.clock.wall() + Math.max(0, execution.deadline - execution.clock.monotonic());
+    let holdId;
+    try {
+        const admitted = await options.budget.admit({ callId: execution.receipt.callId, correlationId: execution.receipt.correlationId,
+            evaluator: { ...selection.descriptor.evaluator }, quote, deadlineAt });
+        if (!admitted.ok) {
+            execution.receipt.budget = { state: 'not-admitted', overrun: false };
+            execution.receipt.cost = { status: 'not-incurred', amountMicroUsd: '0', source: 'no-dispatch' };
+            const code = ['BUDGET_EXHAUSTED', 'PROVIDER_UNAVAILABLE'].some((v) => v === admitted.code) ? admitted.code : 'BUDGET_UNAVAILABLE';
+            return failed(createDecisionError(code, 'admission'));
+        }
+        holdId = admitted.holdId;
+        if (!isCorrelationId(holdId))
+            throw new Error('Invalid hold acknowledgement.');
+    }
+    catch {
+        return failed(createDecisionError('BUDGET_UNAVAILABLE', 'dispatch'));
+    }
+    execution.phase = 'dispatch';
+    let stopped = decisionInterruption(execution, 'dispatch');
+    if (!stopped && !await decisionAuthority(options, selection))
+        stopped = createDecisionError('AUTHORIZATION_DENIED', 'dispatch');
+    stopped ??= decisionInterruption(execution, 'dispatch');
+    if (stopped)
+        return releaseUnsentDecision(execution, options, holdId, stopped);
+    try {
+        const marked = await options.budget.markDispatched({ holdId, callId: execution.receipt.callId,
+            evaluator: { ...selection.descriptor.evaluator }, deadlineAt });
+        if (!marked.ok) {
+            const error = createDecisionError(marked.code === 'PROVIDER_UNAVAILABLE' ? 'PROVIDER_UNAVAILABLE' : 'BUDGET_UNAVAILABLE', 'dispatch');
+            if (marked.provenUnsent === true)
+                return releaseUnsentDecision(execution, options, holdId, error);
+            // Ambiguous marker: attempts remains 0 since no provider dispatch was made; dispatch is unknown.
+            execution.receipt.dispatch = 'unknown';
+            return failed(error);
+        }
+    }
+    catch {
+        // Ambiguous marker exception: attempts remains 0 since no provider dispatch was made; dispatch is unknown.
+        execution.receipt.dispatch = 'unknown';
+        return failed(createDecisionError('BUDGET_UNAVAILABLE', 'dispatch'));
+    }
+    stopped = decisionInterruption(execution, 'dispatch');
+    if (!stopped && !await decisionAuthority(options, selection))
+        stopped = createDecisionError('AUTHORIZATION_DENIED', 'dispatch');
+    stopped ??= decisionInterruption(execution, 'dispatch');
+    if (stopped)
+        return releaseUnsentDecision(execution, options, holdId, stopped);
+    return { ok: true, holdId, quote, auth: resolved.auth };
+}
+//# sourceMappingURL=admission.js.map

package/dist/decision/admission.js.map

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

package/dist/decision/budget.d.ts

@@ -0,0 +1,60 @@
+import type { EvaluatorRef } from './request.js';
+import type { DecisionQuote } from './pricing.js';
+import type { DecisionReceipt } from './receipt.js';
+export interface DecisionAdmission {
+    callId: string;
+    correlationId: string;
+    evaluator: EvaluatorRef;
+    quote: DecisionQuote;
+    deadlineAt: number;
+}
+export type DecisionAdmissionResult = {
+    ok: true;
+    holdId: string;
+} | {
+    ok: false;
+    code: 'BUDGET_EXHAUSTED' | 'BUDGET_UNAVAILABLE' | 'PROVIDER_UNAVAILABLE';
+};
+export type DecisionDispatchResult = {
+    ok: true;
+} | {
+    ok: false;
+    code: 'BUDGET_UNAVAILABLE' | 'PROVIDER_UNAVAILABLE';
+    provenUnsent: boolean;
+};
+export interface DecisionSettlement {
+    holdId: string;
+    receipt: DecisionReceipt;
+    boundViolated: boolean;
+}
+/** Required host authority, closed over the verified owner and all existing budget buckets.
+ * No in-memory production fallback. Every method must be bounded by host I/O deadlines.
+ * Admission and final marking check the durable evaluator-revision disable predicate under
+ * the same evaluator lock, acquired before hold/budget locks. A rejected admission creates
+ * no hold; thrown admission/marking can be ambiguous and must be reconciled by callId.
+ * Settlement atomically charges the full amount, releases the hold, writes ledger/outbox
+ * and this redacted receipt, and retains boundViolated disable evidence across restart.
+ * Pending reconciliation retains liability; retries reconcile accounting, never evaluate.
+ */
+export interface DecisionBudgetPort {
+    admit(input: DecisionAdmission): Promise<DecisionAdmissionResult>;
+    markDispatched(input: {
+        holdId: string;
+        callId: string;
+        evaluator: EvaluatorRef;
+        deadlineAt: number;
+    }): Promise<DecisionDispatchResult>;
+    release(input: {
+        holdId: string;
+        callId: string;
+    }): Promise<void>;
+    settle(input: DecisionSettlement): Promise<void>;
+}
+/** Acknowledges durable metadata persistence. No verdict or request content crosses this port.
+ * For admitted calls, financial settlement owns the atomic ledger receipt projection;
+ * this sink acknowledges its durable publication (or uses the same durable authority).
+ */
+export interface DecisionReceiptSink {
+    persist(receipt: DecisionReceipt): Promise<void>;
+}
+//# sourceMappingURL=budget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/decision/budget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;CAC1G;AACD,MAAM,MAAM,uBAAuB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,kBAAkB,GAAG,oBAAoB,GAAG,sBAAsB,CAAA;CAAE,CAAC;AAC5F,MAAM,MAAM,sBAAsB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAC7C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,oBAAoB,GAAG,sBAAsB,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CAAC;AAC9F,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,eAAe,CAAC;IAAC,aAAa,EAAE,OAAO,CAAC;CAClE;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAClE,cAAc,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,YAAY,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACxI,OAAO,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAAG,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE"}

package/dist/decision/budget.js

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

package/dist/decision/budget.js.map

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

package/dist/decision/client.d.ts

@@ -0,0 +1,23 @@
+import { type DecisionRequest } from './request.js';
+import type { DecisionReceipt, RemoteDecisionClient } from './receipt.js';
+import type { DecisionVerdict } from './verdict.js';
+import { type DecisionValidationContext, type DecisionValidationContextResolver } from './validation-context.js';
+export interface RemoteDecisionClientOptions {
+    baseUrl: string;
+    fetch?: typeof globalThis.fetch;
+    headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
+    authToken?: string | (() => string | Promise<string>);
+    maxResponseBytes?: number;
+    timeoutMs?: number;
+    generateId?: () => string;
+    /** Trusted context resolver (§3.3): receives the frozen transmitted snapshot
+     * and returns the revision-specific validation facts. A nullish or
+     * unparseable result refuses client-local before any egress. Absent
+     * resolvers refuse client-local with zero header/credential resolution. */
+    validationContext: DecisionValidationContextResolver;
+}
+export declare function isValidDecisionReceipt(r: unknown, request: DecisionRequest, expectedCorrelationId: string, validation: DecisionValidationContext | null): r is DecisionReceipt;
+export declare function isValidDecisionVerdict(v: unknown, request: DecisionRequest, validation: DecisionValidationContext | null): v is DecisionVerdict;
+/** Remote decision client calling an authenticated mesh endpoint without custody of provider keys. */
+export declare function createRemoteDecisionClient(options: RemoteDecisionClientOptions): RemoteDecisionClient;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/decision/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,KAAK,EAA6B,eAAe,EAAkB,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAOrH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,OAAO,EAAkC,KAAK,yBAAyB,EACrE,KAAK,iCAAiC,EAAoC,MAAM,yBAAyB,CAAC;AAE5G,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACpG,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACtD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;IAC1B;;;+EAG2E;IAC3E,iBAAiB,EAAE,iCAAiC,CAAC;CACtD;AAgGD,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,EACxG,UAAU,EAAE,yBAAyB,GAAG,IAAI,GAAG,CAAC,IAAI,eAAe,CA+CpE;AA6MD,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EACzE,UAAU,EAAE,yBAAyB,GAAG,IAAI,GAAG,CAAC,IAAI,eAAe,CA4DpE;AA4CD,sGAAsG;AACtG,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,2BAA2B,GAAG,oBAAoB,CA2PrG"}