@codebam/jev-guardrails 0.1.0

package/dist/client.js

@@ -0,0 +1,197 @@
+/**
+ * The Jev call layer: official SDK client, state preparation, cache, timeout,
+ * abort handling, and response validation.
+ *
+ * @module @codebam/jev-guardrails/client
+ */
+import { TypeSafeClient, TypeSafeError } from '@typesafe-ai/sdk';
+import { createHash } from 'node:crypto';
+import { ResponseCache } from './cache.js';
+import { OpenRouterDecisionsTransport } from './openrouter.js';
+import { redactState, redactString } from './redact.js';
+import { isRecord, stableStringify, truncateMiddle } from './util.js';
+/** Error raised by configuration, transport, or response-validation failures. */
+export class GuardrailsError extends Error {
+    code;
+    constructor(code, message, cause) {
+        super(message, cause === undefined ? undefined : { cause });
+        this.name = 'GuardrailsError';
+        this.code = code;
+    }
+}
+/** Build the default Jev transport, or return an injected one unchanged. */
+export function createTransport(options) {
+    if (options.client !== undefined)
+        return options.client;
+    if (options.provider === 'openrouter') {
+        const apiKey = options.apiKey ?? process.env.OPENROUTER_API_KEY ?? '';
+        if (apiKey.trim().length === 0) {
+            throw new GuardrailsError('CONFIG', 'an OpenRouter API key is required for provider "openrouter". Set OPENROUTER_API_KEY or pass apiKey explicitly.');
+        }
+        return new OpenRouterDecisionsTransport({
+            apiKey,
+            ...(options.baseURL !== undefined ? { baseURL: options.baseURL } : {}),
+            model: options.model,
+            ...(options.fetch !== undefined ? { fetch: options.fetch } : {}),
+            ...(options.retries !== undefined ? { retry: options.retries } : {}),
+            ...(options.sessionId !== undefined ? { sessionId: options.sessionId } : {}),
+            ...(options.headers !== undefined ? { headers: options.headers } : {}),
+        });
+    }
+    try {
+        return new TypeSafeClient({
+            ...(options.apiKey !== undefined && options.apiKey.trim().length > 0 ? { apiKey: options.apiKey } : {}),
+            ...(options.baseURL !== undefined && options.baseURL.trim().length > 0 ? { baseURL: options.baseURL } : {}),
+            defaultModel: options.model,
+            timeout: options.timeoutMs,
+            ...(options.fetch !== undefined ? { fetch: options.fetch } : {}),
+            ...(options.retries !== undefined ? { retry: options.retries } : {}),
+            dangerouslyAllowBrowser: false,
+        });
+    }
+    catch (error) {
+        const message = error instanceof TypeSafeError ? error.message : `could not create the TypeSafe client: ${String(error)}`;
+        throw new GuardrailsError('CONFIG', `${message} Set TYPESAFE_API_KEY or pass apiKey/client explicitly.`, error);
+    }
+}
+/** Owns exactly one transport and its local policy around calls. */
+export class JevCaller {
+    transport;
+    model;
+    cache;
+    redactor;
+    maxStateChars;
+    timeoutMs;
+    retries;
+    constructor(options) {
+        this.transport = options.transport;
+        this.model = options.model;
+        this.cache = options.cache === false ? undefined : new ResponseCache(options.cache, options.now);
+        this.redactor = options.redact;
+        this.maxStateChars = Math.max(64, options.maxStateChars);
+        this.timeoutMs = Math.max(100, options.timeoutMs);
+        this.retries = options.retries;
+    }
+    /** Remove every cached answer. */
+    clearCache() {
+        this.cache?.clear();
+    }
+    /** Number of live cache entries. */
+    get cacheSize() {
+        return this.cache?.size ?? 0;
+    }
+    /** Prepare, call, validate, and optionally cache one System One request. */
+    async ask(request, options = {}) {
+        const prepared = this.prepareRequest(request);
+        const cacheKey = this.cacheKey(prepared);
+        if (this.cache !== undefined && options.cache !== false) {
+            const cached = this.cache.get(cacheKey);
+            if (cached !== undefined)
+                return { result: cached, cached: true };
+        }
+        const timeout = AbortSignal.timeout(this.timeoutMs);
+        const linked = linkSignals(options.signal, timeout);
+        let result;
+        try {
+            const requestOptions = {
+                signal: linked.signal,
+                timeout: this.timeoutMs,
+                ...(this.retries !== undefined ? { retry: this.retries } : {}),
+            };
+            result = (await this.transport.systemOne(prepared, requestOptions));
+        }
+        catch (error) {
+            if (options.signal?.aborted === true) {
+                throw new GuardrailsError('ABORTED', 'the Jev request was cancelled by the caller', error);
+            }
+            if (timeout.aborted) {
+                throw new GuardrailsError('TRANSPORT', `the Jev request timed out after ${this.timeoutMs}ms`, error);
+            }
+            const detail = error instanceof TypeSafeError ? error.message : error instanceof Error ? error.message : String(error);
+            throw new GuardrailsError('TRANSPORT', `the Jev request failed: ${detail}`, error);
+        }
+        finally {
+            linked.dispose();
+        }
+        assertAnswers(result, prepared.questions);
+        if (this.cache !== undefined && options.cache !== false)
+            this.cache.set(cacheKey, result);
+        return { result, cached: false };
+    }
+    prepareRequest(request) {
+        const model = request.model ?? this.model;
+        const state = this.prepareState(request.state);
+        return { ...request, model, state };
+    }
+    prepareState(state) {
+        if (state === null)
+            return null;
+        if (typeof state === 'string') {
+            const redacted = this.redactor === false ? state : redactString(state, this.redactor);
+            return truncateMiddle(redacted, this.maxStateChars).text;
+        }
+        const redacted = this.redactor === false ? state : redactState(state, this.redactor);
+        const serialized = stableStringify(redacted);
+        if (serialized.length <= this.maxStateChars)
+            return redacted;
+        return truncateMiddle(serialized, this.maxStateChars).text;
+    }
+    cacheKey(request) {
+        const hash = createHash('sha256');
+        hash.update(stableStringify({
+            model: request.model,
+            state: request.state,
+            questions: request.questions,
+        }));
+        return hash.digest('hex');
+    }
+}
+function linkSignals(...signals) {
+    const controller = new AbortController();
+    const listeners = [];
+    for (const signal of signals) {
+        if (signal === undefined)
+            continue;
+        if (signal.aborted) {
+            controller.abort(signal.reason);
+            break;
+        }
+        const listener = () => controller.abort(signal.reason);
+        signal.addEventListener('abort', listener, { once: true });
+        listeners.push({ signal, listener });
+    }
+    return {
+        signal: controller.signal,
+        dispose() {
+            for (const entry of listeners)
+                entry.signal.removeEventListener('abort', entry.listener);
+        },
+    };
+}
+function assertAnswers(result, questions) {
+    if (!isRecord(result) || !isRecord(result.answers)) {
+        throw new GuardrailsError('MALFORMED', 'the Jev response did not contain an answers object');
+    }
+    for (const [name, question] of Object.entries(questions)) {
+        const answer = result.answers[name];
+        if (!isRecord(answer)) {
+            throw new GuardrailsError('MALFORMED', `the Jev response is missing the answer "${name}"`);
+        }
+        if (answer.type !== question.type) {
+            throw new GuardrailsError('MALFORMED', `the Jev answer "${name}" has type "${String(answer.type)}", expected "${question.type}"`);
+        }
+        if (question.type === 'noul' && !isProbability(answer.noul)) {
+            throw new GuardrailsError('MALFORMED', `the Jev noul answer "${name}" is not a probability`);
+        }
+        if (question.type === 'score' && (typeof answer.score !== 'number' || !Number.isFinite(answer.score))) {
+            throw new GuardrailsError('MALFORMED', `the Jev score answer "${name}" is not finite`);
+        }
+        if (question.type === 'choice' && typeof answer.choice !== 'string') {
+            throw new GuardrailsError('MALFORMED', `the Jev choice answer "${name}" is not a label`);
+        }
+    }
+}
+function isProbability(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0 && value <= 1;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/guardrails.d.ts

@@ -0,0 +1,58 @@
+import type { Questions, SystemOneRequest } from '@typesafe-ai/sdk';
+import type { AskOptions, AskResult } from './client.js';
+import { DEFAULT_PRECEDENCE } from './policies.js';
+import type { ActionDescriptor, AssessActionOptions, ClaimVerdict, GuardVerdict, GuardrailsStats, JevGuardrailsOptions, ScreenOptions, VerifyClaimOptions } from './types.js';
+/**
+ * Jev-backed guardrails with one local cache, one policy set, and one
+ * transport.
+ *
+ * The class is safe to share across requests; each call is independent and
+ * cancellation is per call.
+ */
+export declare class JevGuardrails {
+    private readonly caller;
+    private readonly model;
+    private readonly heuristics;
+    private readonly batteries;
+    private readonly policyOverrides;
+    private readonly onVerdict;
+    private readonly onError;
+    private readonly counters;
+    constructor(options?: JevGuardrailsOptions);
+    /** Low-level ask against the same transport, cache, and redactor. */
+    ask<Q extends Questions>(request: SystemOneRequest<Q>, options?: AskOptions): Promise<AskResult<Q>>;
+    /** Screen a user prompt before it reaches the model. */
+    screenInput(text: string, options?: ScreenOptions): Promise<GuardVerdict>;
+    /** Screen a model response before the user sees it. */
+    screenOutput(text: string, options?: ScreenOptions): Promise<GuardVerdict>;
+    /** Screen untrusted text a model is about to read. */
+    screenObservation(text: string, options?: ScreenOptions): Promise<GuardVerdict>;
+    /**
+     * Score one proposed tool call before execution.
+     *
+     * Local rules resolve routine and obviously dangerous calls without a model
+     * call; everything ambiguous goes to Jev.
+     */
+    assessAction(action: ActionDescriptor | string, options?: AssessActionOptions): Promise<GuardVerdict>;
+    /**
+     * Verify one claim against its evidence.
+     *
+     * A supplied quote that is not present in the evidence is `fabricated`
+     * without spending a model call; everything else goes to one Choice question.
+     */
+    verifyClaim(options: VerifyClaimOptions): Promise<ClaimVerdict>;
+    /** Drop every cached answer. */
+    clearCache(): void;
+    /** Aggregate counters since construction. */
+    get stats(): GuardrailsStats;
+    private policyFor;
+    private screenText;
+    private screenState;
+    private buildVerdict;
+    private localVerdict;
+    private failureVerdict;
+}
+/** Create a guardrails instance with the built-in batteries and policies. */
+export declare function createGuardrails(options?: JevGuardrailsOptions): JevGuardrails;
+export { DEFAULT_PRECEDENCE };
+//# sourceMappingURL=guardrails.d.ts.map

package/dist/guardrails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.d.ts","sourceRoot":"","sources":["../src/guardrails.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAGnE,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAExD,OAAO,EAAE,kBAAkB,EAA8B,MAAM,eAAe,CAAA;AAE9E,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EAEnB,YAAY,EAKZ,YAAY,EACZ,eAAe,EACf,oBAAoB,EAEpB,aAAa,EACb,kBAAkB,EACnB,MAAM,YAAY,CAAA;AAKnB;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA8C;IAC9E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+C;IACzE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuF;IAC/G,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAMxB;gBAEW,OAAO,GAAE,oBAAyB;IA4C9C,qEAAqE;IAC/D,GAAG,CAAC,CAAC,SAAS,SAAS,EAC3B,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC5B,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAIxB,wDAAwD;IAClD,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAInF,uDAAuD;IACjD,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAIpF,sDAAsD;IAChD,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAIzF;;;;;OAKG;IACG,YAAY,CAChB,MAAM,EAAE,gBAAgB,GAAG,MAAM,EACjC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,YAAY,CAAC;IAoBxB;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IA2ErE,gCAAgC;IAChC,UAAU,IAAI,IAAI;IAIlB,6CAA6C;IAC7C,IAAI,KAAK,IAAI,eAAe,CAQ3B;IAED,OAAO,CAAC,SAAS;YAMH,UAAU;YAMV,WAAW;IAgDzB,OAAO,CAAC,YAAY;IAmDpB,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,cAAc;CAqBvB;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa,CAElF;AAkED,OAAO,EAAE,kBAAkB,EAAE,CAAA"}

package/dist/guardrails.js

@@ -0,0 +1,386 @@
+/**
+ * `JevGuardrails`: the public entry point that ties batteries, policies, the
+ * Jev call layer, local heuristics, and claim verification together.
+ *
+ * @module @codebam/jev-guardrails/guardrails
+ */
+import { choice } from '@typesafe-ai/sdk';
+import { ACTION_BATTERY, INPUT_BATTERY, OBSERVATION_BATTERY, OUTPUT_BATTERY } from './batteries.js';
+import { GuardrailsError, JevCaller, createTransport } from './client.js';
+import { classifyActionLocally } from './heuristics.js';
+import { DEFAULT_PRECEDENCE, resolvePolicy, routePolicy } from './policies.js';
+import { DEFAULT_HAZARD_LABELS, describeVerdict } from './render.js';
+import { contentToText, formatProbability, topEntries } from './util.js';
+const ALL_SIDES = ['input', 'output', 'observation', 'action'];
+/**
+ * Jev-backed guardrails with one local cache, one policy set, and one
+ * transport.
+ *
+ * The class is safe to share across requests; each call is independent and
+ * cancellation is per call.
+ */
+export class JevGuardrails {
+    caller;
+    model;
+    heuristics;
+    batteries;
+    policyOverrides;
+    onVerdict;
+    onError;
+    counters = {
+        checks: 0,
+        cached: 0,
+        degraded: 0,
+        local: 0,
+        bySide: { input: 0, output: 0, observation: 0, action: 0 },
+    };
+    constructor(options = {}) {
+        this.model =
+            options.model?.trim() ||
+                (options.provider === 'openrouter' ? '~typesafe/jev-latest' : 'jev-latest');
+        this.heuristics = options.heuristics ?? true;
+        this.batteries = {
+            input: options.batteries?.input ?? INPUT_BATTERY,
+            output: options.batteries?.output ?? OUTPUT_BATTERY,
+            observation: options.batteries?.observation ?? OBSERVATION_BATTERY,
+            action: options.batteries?.action ?? ACTION_BATTERY,
+        };
+        for (const side of ALL_SIDES) {
+            resolvePolicy(side, options.policies?.[side] ?? options.policy, this.batteries[side]);
+        }
+        this.policyOverrides = {
+            ...(options.policy !== undefined ? { input: options.policy, output: options.policy, observation: options.policy, action: options.policy } : {}),
+            ...options.policies,
+        };
+        this.onVerdict = options.onVerdict;
+        this.onError = options.onError;
+        this.caller = new JevCaller({
+            transport: createTransport({
+                model: this.model,
+                ...(options.provider !== undefined ? { provider: options.provider } : {}),
+                ...(options.apiKey !== undefined ? { apiKey: options.apiKey } : {}),
+                ...(options.baseURL !== undefined ? { baseURL: options.baseURL } : {}),
+                ...(options.client !== undefined ? { client: options.client } : {}),
+                ...(options.fetch !== undefined ? { fetch: options.fetch } : {}),
+                timeoutMs: options.timeoutMs ?? 5000,
+                ...(options.retries !== undefined ? { retries: options.retries } : {}),
+                ...(options.sessionId !== undefined ? { sessionId: options.sessionId } : {}),
+                ...(options.headers !== undefined ? { headers: options.headers } : {}),
+            }),
+            model: this.model,
+            cache: options.cache === false ? false : options.cache ?? {},
+            redact: normalizeRedaction(options.redact),
+            maxStateChars: options.maxStateChars ?? 20000,
+            timeoutMs: options.timeoutMs ?? 5000,
+            ...(options.retries !== undefined ? { retries: options.retries } : {}),
+            ...(options.now !== undefined ? { now: options.now } : {}),
+        });
+    }
+    /** Low-level ask against the same transport, cache, and redactor. */
+    async ask(request, options = {}) {
+        return this.caller.ask(request, options);
+    }
+    /** Screen a user prompt before it reaches the model. */
+    async screenInput(text, options = {}) {
+        return this.screenText('input', text, options);
+    }
+    /** Screen a model response before the user sees it. */
+    async screenOutput(text, options = {}) {
+        return this.screenText('output', text, options);
+    }
+    /** Screen untrusted text a model is about to read. */
+    async screenObservation(text, options = {}) {
+        return this.screenText('observation', text, options);
+    }
+    /**
+     * Score one proposed tool call before execution.
+     *
+     * Local rules resolve routine and obviously dangerous calls without a model
+     * call; everything ambiguous goes to Jev.
+     */
+    async assessAction(action, options = {}) {
+        const descriptor = typeof action === 'string' ? { tool: 'command', arguments: action } : action;
+        this.counters.checks += 1;
+        this.counters.bySide.action += 1;
+        this.counters.cached += 0;
+        const policy = this.policyFor('action', options);
+        if ((options.heuristics ?? this.heuristics) === true) {
+            const local = classifyActionLocally(descriptor);
+            if (local !== undefined) {
+                const verdict = this.localVerdict('action', local.action, local.reason, policy);
+                this.onVerdict?.(verdict);
+                return verdict;
+            }
+        }
+        const state = buildActionState(descriptor);
+        return this.screenState('action', state, options, policy);
+    }
+    /**
+     * Verify one claim against its evidence.
+     *
+     * A supplied quote that is not present in the evidence is `fabricated`
+     * without spending a model call; everything else goes to one Choice question.
+     */
+    async verifyClaim(options) {
+        const claim = options.claim?.trim();
+        if (claim === undefined || claim.length === 0)
+            throw new Error('jev-guardrails: verifyClaim requires a non-empty claim');
+        const evidence = options.evidence;
+        const quote = options.quote;
+        if (quote !== undefined && quote.trim().length > 0 && evidence !== undefined) {
+            if (!normalizeForQuoteMatch(evidence).includes(normalizeForQuoteMatch(quote))) {
+                return {
+                    verdict: 'fabricated',
+                    needsReview: true,
+                    confidence: 1,
+                    probabilities: { fabricated: 1 },
+                    reason: 'The quoted text does not appear in the supplied evidence.',
+                    method: 'string-match',
+                    cached: false,
+                    degraded: false,
+                };
+            }
+        }
+        const questions = {
+            relationship: choice('Given the evidence, what is the relationship between the evidence and the claim?', {
+                supported: 'The evidence clearly supports the claim.',
+                contradicted: 'The evidence clearly contradicts the claim.',
+                insufficient: 'The evidence does not contain enough information to judge the claim.',
+            }),
+        };
+        const autoAccept = options.autoAcceptConfidence ?? 0.8;
+        try {
+            const { result, cached } = await this.caller.ask({
+                state: {
+                    claim,
+                    quote: quote ?? null,
+                    evidence: evidence ?? null,
+                    context: options.context ?? null,
+                },
+                questions,
+                model: options.model ?? this.model,
+            }, { signal: options.signal, cache: options.cache });
+            const answer = result.answers.relationship;
+            if (answer.type !== 'choice')
+                throw new GuardrailsError('MALFORMED', 'the verification answer was not a choice');
+            const rawChoice = String(answer.choice);
+            const verdict = rawChoice === 'supported' || rawChoice === 'contradicted' || rawChoice === 'insufficient'
+                ? rawChoice
+                : 'insufficient';
+            const confidence = answer.confidence;
+            const needsReview = verdict === 'insufficient' || confidence < autoAccept;
+            const probabilities = { ...answer.probabilities };
+            return {
+                verdict,
+                needsReview,
+                confidence,
+                probabilities,
+                reason: describeClaimVerdict(verdict, confidence, needsReview),
+                method: 'jev',
+                model: result.model,
+                usage: result.usage,
+                cached,
+                degraded: false,
+            };
+        }
+        catch (error) {
+            this.counters.degraded += 1;
+            this.onError?.(error, { side: 'output', kind: 'response' });
+            const message = error instanceof Error ? error.message : String(error);
+            throw error instanceof GuardrailsError
+                ? error
+                : new GuardrailsError('TRANSPORT', `claim verification failed: ${message}`, error);
+        }
+    }
+    /** Drop every cached answer. */
+    clearCache() {
+        this.caller.clearCache();
+    }
+    /** Aggregate counters since construction. */
+    get stats() {
+        return {
+            checks: this.counters.checks,
+            cached: this.counters.cached,
+            degraded: this.counters.degraded,
+            local: this.counters.local,
+            bySide: { ...this.counters.bySide },
+        };
+    }
+    policyFor(side, options) {
+        const battery = this.batteries[side];
+        const override = mergePolicies(this.policyOverrides[side], options.policy);
+        return resolvePolicy(side, override, battery);
+    }
+    async screenText(side, text, options) {
+        const policy = this.policyFor(side, options);
+        const state = typeof text === 'string' ? text : contentToText(text);
+        return this.screenState(side, state, options, policy);
+    }
+    async screenState(side, state, options, policy) {
+        this.counters.checks += 1;
+        this.counters.bySide[side] += 1;
+        const battery = this.batteries[side];
+        const kind = battery.kind;
+        if (typeof state === 'string' && state.trim().length === 0) {
+            this.counters.local += 1;
+            const verdict = this.localVerdict(side, 'allow', 'empty input has no hazard surface', policy);
+            this.onVerdict?.(verdict);
+            return verdict;
+        }
+        const questions = options.questions ?? battery.questions;
+        const severityKey = options.severityKey ?? battery.severityKey;
+        try {
+            const { result, cached } = await this.caller.ask({ state: state, questions, model: options.model ?? this.model }, { signal: options.signal, cache: options.cache });
+            if (cached)
+                this.counters.cached += 1;
+            const verdict = this.buildVerdict({
+                side,
+                kind,
+                battery,
+                labels: options.labels,
+                policy,
+                questions,
+                severityKey,
+                result: result,
+                cached,
+            });
+            this.onVerdict?.(verdict);
+            return verdict;
+        }
+        catch (error) {
+            this.counters.degraded += 1;
+            this.onError?.(error, { side, kind });
+            const verdict = this.failureVerdict(side, kind, policy, error);
+            this.onVerdict?.(verdict);
+            return verdict;
+        }
+    }
+    buildVerdict(input) {
+        const hazards = {};
+        for (const [name, question] of Object.entries(input.questions)) {
+            if (name === input.severityKey)
+                continue;
+            const answer = input.result.answers[name];
+            if (isNoulAnswer(answer))
+                hazards[name] = answer.noul;
+        }
+        const severityAnswer = input.severityKey === undefined ? undefined : input.result.answers[input.severityKey];
+        const severity = isScoreAnswer(severityAnswer) ? severityAnswer.score : undefined;
+        const severityConfidence = isScoreAnswer(severityAnswer) ? severityAnswer.confidence : undefined;
+        const route = routePolicy({ hazards, ...(severity !== undefined ? { severity } : {}), policy: input.policy });
+        const labels = { ...(input.battery.labels ?? {}), ...(input.labels ?? {}) };
+        const top = topEntries(hazards).find(([, probability]) => probability >= input.policy.reviewThreshold);
+        const topHazard = top === undefined
+            ? undefined
+            : { name: top[0], probability: top[1], label: labels[top[0]] ?? DEFAULT_HAZARD_LABELS[top[0]] ?? top[0] };
+        const draft = {
+            side: input.side,
+            kind: input.kind,
+            action: route.action,
+            source: 'jev',
+            hazards,
+            ...(topHazard !== undefined ? { topHazard } : {}),
+            ...(severity !== undefined ? { severity } : {}),
+            ...(severityConfidence !== undefined ? { severityConfidence } : {}),
+            reasons: route.reasons,
+            model: input.result.model,
+            ...(input.result.usage !== undefined ? { usage: input.result.usage } : {}),
+            cached: input.cached,
+            degraded: false,
+            rawAnswers: { ...input.result.answers },
+        };
+        return { ...draft, reason: describeVerdict(draft, labels) };
+    }
+    localVerdict(side, action, reason, policy) {
+        const draft = {
+            side,
+            kind: side === 'action' ? 'action' : this.batteries[side].kind,
+            action,
+            source: 'local',
+            hazards: {},
+            reasons: [reason],
+            cached: false,
+            degraded: false,
+        };
+        if (action === 'allow')
+            this.counters.local += 1;
+        void policy;
+        return { ...draft, reason: describeVerdict(draft) };
+    }
+    failureVerdict(side, kind, policy, error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const action = policy.failMode === 'open' ? 'allow' : policy.failMode === 'review' ? 'review' : 'block';
+        const draft = {
+            side,
+            kind,
+            action,
+            source: 'jev',
+            hazards: {},
+            reasons: [`Jev request failed: ${message}`],
+            cached: false,
+            degraded: true,
+            error: message,
+        };
+        return { ...draft, reason: describeVerdict(draft) };
+    }
+}
+/** Create a guardrails instance with the built-in batteries and policies. */
+export function createGuardrails(options = {}) {
+    return new JevGuardrails(options);
+}
+function normalizeRedaction(value) {
+    if (value === false)
+        return false;
+    if (value === undefined || value === true)
+        return {};
+    return value;
+}
+function mergePolicies(base, override) {
+    if (base === undefined)
+        return override;
+    if (override === undefined)
+        return base;
+    return {
+        ...base,
+        ...override,
+        ...(base.actions !== undefined || override.actions !== undefined
+            ? { actions: { ...(base.actions ?? {}), ...(override.actions ?? {}) } }
+            : {}),
+    };
+}
+function buildActionState(action) {
+    return {
+        kind: 'proposed_agent_action',
+        tool: action.tool,
+        arguments: action.arguments,
+        ...(action.workspace !== undefined ? { workspace: action.workspace } : {}),
+        ...(action.cwd !== undefined ? { cwd: action.cwd } : {}),
+        ...(action.description !== undefined ? { description: action.description } : {}),
+        ...(action.untrustedContext === true ? { untrusted_context_recently: true } : {}),
+    };
+}
+function isNoulAnswer(value) {
+    return typeof value === 'object' && value !== null && value.type === 'noul' && typeof value.noul === 'number';
+}
+function isScoreAnswer(value) {
+    return typeof value === 'object' && value !== null && value.type === 'score' && typeof value.score === 'number';
+}
+function normalizeForQuoteMatch(value) {
+    return value.replace(/\s+/g, ' ').trim().toLowerCase();
+}
+function describeClaimVerdict(verdict, confidence, needsReview) {
+    const confidenceText = `confidence ${formatProbability(confidence)}`;
+    if (verdict === 'supported') {
+        return needsReview
+            ? `The evidence appears to support the claim, but ${confidenceText} is below the acceptance threshold; review is recommended.`
+            : `The evidence supports the claim (${confidenceText}).`;
+    }
+    if (verdict === 'contradicted') {
+        return needsReview
+            ? `The evidence appears to contradict the claim, but ${confidenceText} is below the acceptance threshold; review is recommended.`
+            : `The evidence contradicts the claim (${confidenceText}).`;
+    }
+    return `The evidence is insufficient to judge the claim (${confidenceText}).`;
+}
+export { DEFAULT_PRECEDENCE };
+//# sourceMappingURL=guardrails.js.map