agentfootprint 9.94.2 → 9.95.0

package/dist/esm/answer-validation/evidence.js

@@ -0,0 +1,117 @@
+/** Bounded reads over the existing store. No new store, scope, or ref grammar. */
+import { isArtifactRef } from '../artifacts/naming.js';
+import { canonicalPayloadBytes, decodeCanonicalPayload, payloadShapeOf, } from '../artifacts/payload.js';
+import { ArtifactIntegrityError, } from '../artifacts/types.js';
+/** @internal Run-local read session. Closing invalidates even retained readers. */
+export function createAnswerEvidenceResolver(store, scope, limits, signal) {
+    const boundScope = Object.freeze({ ...scope });
+    const cache = new Map();
+    const resolved = new Set();
+    let reads = 0;
+    let pendingReads = 0;
+    let reservedBytes = 0;
+    let closed = false;
+    let failure;
+    const unavailable = (reason) => {
+        failure ??= reason;
+        return { ok: false, reason };
+    };
+    const isClosed = () => closed || signal.aborted;
+    const load = async (ref, kind) => {
+        if (!store)
+            return unavailable('no-store');
+        try {
+            const described = await store.head(boundScope, ref);
+            if (isClosed())
+                return unavailable('closed');
+            if (described === null)
+                return unavailable('missing-or-expired');
+            // Memory stores may return their own metadata object: snapshot before the
+            // next await, and never hand that live value to an author callback.
+            const head = structuredClone(described);
+            if (head.ref !== ref || !Number.isSafeInteger(head.bytes) || head.bytes < 0)
+                return unavailable('invalid-record');
+            if (head.kind !== kind)
+                return unavailable('kind-mismatch');
+            if (head.bytes > limits.maxBytes - reservedBytes)
+                return unavailable('max-bytes');
+            reservedBytes += head.bytes; // Reserve before await: parallel reads share this budget.
+            const record = await store.get(boundScope, ref);
+            if (isClosed())
+                return unavailable('closed');
+            if (record === null)
+                return unavailable('missing-or-expired');
+            const meta = structuredClone(record.meta);
+            if (meta.ref !== ref ||
+                meta.kind !== kind ||
+                meta.bytes !== head.bytes ||
+                meta.digest !== head.digest ||
+                meta.createdAt !== head.createdAt ||
+                meta.expiresAt !== head.expiresAt ||
+                meta.mediaType !== head.mediaType)
+                return unavailable('invalid-record');
+            // get is the store's verifying read, including its own expiry clock.
+            // A nonconforming adapter may allocate too much inside get; the port has
+            // no bounded-read verb. Never deliver an understated parcel as accepted.
+            const bytes = canonicalPayloadBytes(record.data);
+            if (bytes.byteLength !== meta.bytes)
+                return unavailable('invalid-record');
+            if (bytes.byteLength > limits.maxBytes)
+                return unavailable('max-bytes');
+            const data = decodeCanonicalPayload(payloadShapeOf(record.data), bytes.slice());
+            if (isClosed())
+                return unavailable('closed');
+            resolved.add(ref);
+            return { ok: true, record: { meta, data } };
+        }
+        catch (error) {
+            if (isClosed())
+                return unavailable('closed');
+            return unavailable(error instanceof ArtifactIntegrityError ? 'digest-mismatch' : 'store-error');
+        }
+    };
+    const resolver = Object.freeze({
+        async resolve(ref, options) {
+            if (isClosed())
+                return unavailable('closed');
+            if (!isArtifactRef(ref) || options === null || typeof options !== 'object')
+                return unavailable('invalid-input');
+            const descriptor = Object.getOwnPropertyDescriptor(options, 'kind');
+            if (!descriptor ||
+                !('value' in descriptor) ||
+                typeof descriptor.value !== 'string' ||
+                descriptor.value.trim() === '' ||
+                descriptor.value.length > 256)
+                return unavailable('invalid-input');
+            const kind = descriptor.value;
+            const key = JSON.stringify([ref, kind]);
+            let pending = cache.get(key);
+            if (!pending) {
+                if (reads >= limits.maxReads)
+                    return unavailable('max-reads');
+                reads++;
+                pendingReads++;
+                pending = load(ref, kind).finally(() => {
+                    pendingReads--;
+                });
+                cache.set(key, pending);
+            }
+            const result = await pending;
+            if (isClosed())
+                return unavailable('closed');
+            // One callback cannot mutate a cached parcel subsequently used by another
+            // check. Metadata and data are detached on every successful delivery.
+            return result.ok ? { ok: true, record: structuredClone(result.record) } : { ...result };
+        },
+    });
+    return {
+        resolver,
+        resolvedRefs: () => [...resolved],
+        failureReason: () => failure ?? (pendingReads > 0 ? 'closed' : undefined),
+        close() {
+            closed = true;
+            cache.clear();
+        },
+    };
+}
+//# sourceMappingURL=evidence.js.map

package/dist/esm/answer-validation/evidence.js.map

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

package/dist/esm/answer-validation/index.d.ts

@@ -0,0 +1,3 @@
+/** Explicit, bounded validation of schema-accepted JSON answers. */
+export { AnswerValidationError, type AnswerCheck, type AnswerEvidenceRefusal, type AnswerEvidenceResolution, type AnswerEvidenceResolver, type AnswerValidationContext, type AnswerValidationLimits, type AnswerValidationOptions, type AnswerValidationReport, type AnswerValidationResult, type ResolvedAnswerValidation, } from './types.js';
+export { resolveAnswerValidation, executeAnswerValidation } from './validate.js';

package/dist/esm/answer-validation/index.js

@@ -0,0 +1,4 @@
+/** Explicit, bounded validation of schema-accepted JSON answers. */
+export { AnswerValidationError, } from './types.js';
+export { resolveAnswerValidation, executeAnswerValidation } from './validate.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/answer-validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/answer-validation/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,OAAO,EACL,qBAAqB,GAWtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC"}

package/dist/esm/answer-validation/types.d.ts

@@ -0,0 +1,94 @@
+/** Explicit, author-supplied validation of a schema-accepted JSON answer. */
+import type { ArtifactRecord, ArtifactRef } from '../artifacts/types.js';
+import type { Disposition } from '../integrity/disposition/types.js';
+/** One named obligation. Only checked-pass/checked-fail count as checks run. */
+export interface AnswerCheck {
+    readonly id: string;
+    readonly disposition: Disposition;
+    /** Short diagnostic data, never interpreted as an instruction. */
+    readonly reason?: string;
+    readonly path?: string;
+    /** Must have resolved through this validation's artifact capability. */
+    readonly evidenceRefs?: readonly ArtifactRef[];
+}
+/** Why a requested artifact could not be delivered to the validator. */
+export type AnswerEvidenceRefusal = 'closed' | 'invalid-input' | 'no-store' | 'missing-or-expired' | 'kind-mismatch' | 'digest-mismatch' | 'max-reads' | 'max-bytes' | 'invalid-record' | 'store-error';
+/** A resolved parcel, or an explicit absence; absence never carries payloads. */
+export type AnswerEvidenceResolution = {
+    readonly ok: true;
+    readonly record: ArtifactRecord;
+} | {
+    readonly ok: false;
+    readonly reason: AnswerEvidenceRefusal;
+};
+/** Read-only, bounded, and pre-bound to the run's artifact scope. */
+export interface AnswerEvidenceResolver {
+    /** Exact kind match, as with tool wants. No listing or automatic parent walk. */
+    resolve(ref: ArtifactRef, options: {
+        readonly kind: string;
+    }): Promise<AnswerEvidenceResolution>;
+}
+/** Capabilities for this invocation only; retained readers close on completion. */
+export interface AnswerValidationContext {
+    readonly signal: AbortSignal;
+    readonly artifacts: AnswerEvidenceResolver;
+}
+/** Bounds are per validation, positive safe integers, with no unbounded mode. */
+export interface AnswerValidationLimits {
+    /** Distinct ref+kind lookup attempts; duplicates share a cached read. Default 16. */
+    readonly maxReads?: number;
+    /** Total accepted/reserved artifact payload bytes. Default 4 MiB. */
+    readonly maxBytes?: number;
+    /** Maximum returned checks. Default 100. */
+    readonly maxChecks?: number;
+    /** UTF-8 bytes of input and canonical candidate, each bounded. Default 1 MiB. */
+    readonly maxCandidateBytes?: number;
+    /** Async deadline; cannot preempt synchronous author code. Default 5000 ms. */
+    readonly timeoutMs?: number;
+}
+/** The validator reports comparisons; the framework derives their outcome. */
+export interface AnswerValidationResult {
+    readonly checks: readonly AnswerCheck[];
+}
+/** Opt-in contract. The callback cannot replace the accepted answer. */
+export interface AnswerValidationOptions<T = unknown> {
+    readonly id: string;
+    readonly version: string;
+    /** Enforce withholds non-passing results; observe records them. Default enforce. */
+    readonly mode?: 'enforce' | 'observe';
+    readonly limits?: AnswerValidationLimits;
+    validate(candidate: Readonly<T>, context: AnswerValidationContext): AnswerValidationResult | Promise<AnswerValidationResult>;
+}
+/** Validated, detached configuration used by the runner. */
+export interface ResolvedAnswerValidation {
+    readonly id: string;
+    readonly version: string;
+    readonly mode: 'enforce' | 'observe';
+    readonly limits: Required<AnswerValidationLimits>;
+    validate(candidate: unknown, context: AnswerValidationContext): AnswerValidationResult | Promise<AnswerValidationResult>;
+}
+/** Cloneable decision record. It contains no candidate or artifact payload. */
+export interface AnswerValidationReport {
+    readonly validatorId: string;
+    readonly validatorVersion: string;
+    readonly mode: 'enforce' | 'observe';
+    readonly status: 'passed' | 'failed' | 'unverified';
+    readonly checked: number;
+    readonly failed: number;
+    readonly unreachable: number;
+    readonly notApplicable: number;
+    readonly checks: readonly AnswerCheck[];
+    readonly reason?: string;
+    /** SHA-256 of the exact canonical JSON content considered for delivery. */
+    readonly candidateDigest?: string;
+    /** Successfully resolved refs, distinct, not a count of semantic comparisons. */
+    readonly resolvedRefs: readonly ArtifactRef[];
+    /** The schema parser accepted and its output is a lossless canonical JSON value. */
+    readonly schemaAccepted: boolean;
+}
+/** An enforcing host refused delivery; diagnostic metadata only, never content. */
+export declare class AnswerValidationError extends Error {
+    readonly code: "ERR_ANSWER_VALIDATION";
+    readonly report: AnswerValidationReport;
+    constructor(report: AnswerValidationReport);
+}

package/dist/esm/answer-validation/types.js

@@ -0,0 +1,20 @@
+/** An enforcing host refused delivery; diagnostic metadata only, never content. */
+export class AnswerValidationError extends Error {
+    code = 'ERR_ANSWER_VALIDATION';
+    report;
+    constructor(report) {
+        super(`Answer validation '${report.validatorId}' did not pass (${report.status}).`);
+        this.name = 'AnswerValidationError';
+        this.report = Object.freeze({
+            ...report,
+            checks: Object.freeze(report.checks.map((check) => Object.freeze({
+                ...check,
+                ...(check.evidenceRefs !== undefined && {
+                    evidenceRefs: Object.freeze([...check.evidenceRefs]),
+                }),
+            }))),
+            resolvedRefs: Object.freeze([...report.resolvedRefs]),
+        });
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/esm/answer-validation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/answer-validation/types.ts"],"names":[],"mappings":"AA6GA,mFAAmF;AACnF,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACrC,IAAI,GAAG,uBAAgC,CAAC;IACxC,MAAM,CAAyB;IAExC,YAAY,MAA8B;QACxC,KAAK,CAAC,sBAAsB,MAAM,CAAC,WAAW,mBAAmB,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;QACpF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAC1B,GAAG,MAAM;YACT,MAAM,EAAE,MAAM,CAAC,MAAM,CACnB,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC1B,MAAM,CAAC,MAAM,CAAC;gBACZ,GAAG,KAAK;gBACR,GAAG,CAAC,KAAK,CAAC,YAAY,KAAK,SAAS,IAAI;oBACtC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC;iBACrD,CAAC;aACH,CAAC,CACH,CACF;YACD,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;SACtD,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/esm/answer-validation/validate.d.ts

@@ -0,0 +1,15 @@
+/** One explicit JSON-answer validation; the runner owns when to invoke it. */
+import { type OutputSchemaParser } from '../core/outputSchema.js';
+import type { ArtifactScope, ArtifactStore } from '../artifacts/types.js';
+import type { AnswerValidationOptions, AnswerValidationReport, ResolvedAnswerValidation } from './types.js';
+/** Validate and snapshot an authored contract once, before running an agent. */
+export declare function resolveAnswerValidation<T = unknown>(options: AnswerValidationOptions<T>): ResolvedAnswerValidation;
+/**
+ * Validate once. Content is present only when delivery is permitted by this
+ * contract. It is the exact JSON string whose detached value was checked;
+ * callers must not reparse through a transforming schema or rewrite afterward.
+ */
+export declare function executeAnswerValidation(raw: string, parser: OutputSchemaParser<unknown>, config: ResolvedAnswerValidation, store: ArtifactStore | undefined, scope: ArtifactScope, signal?: AbortSignal): Promise<{
+    report: AnswerValidationReport;
+    content?: string;
+}>;

package/dist/esm/answer-validation/validate.js

@@ -0,0 +1,321 @@
+/** One explicit JSON-answer validation; the runner owns when to invoke it. */
+import { applyOutputSchema } from '../core/outputSchema.js';
+import { computeArtifactDigest } from '../artifacts/payload.js';
+import { createAnswerEvidenceResolver } from './evidence.js';
+const DEFAULT_LIMITS = Object.freeze({
+    maxReads: 16,
+    maxBytes: 4 * 1024 * 1024,
+    maxChecks: 100,
+    maxCandidateBytes: 1024 * 1024,
+    timeoutMs: 5000,
+});
+const encoder = new TextEncoder();
+const dispositions = new Set(['checked-pass', 'checked-fail', 'not-applicable', 'unreachable']);
+function ownData(value, allowed) {
+    if (value === null ||
+        typeof value !== 'object' ||
+        Array.isArray(value) ||
+        ![Object.prototype, null].includes(Object.getPrototypeOf(value)))
+        throw new Error('Expected a plain data object.');
+    const result = Object.create(null);
+    for (const key of Reflect.ownKeys(value)) {
+        if (typeof key !== 'string' || (allowed && !allowed.includes(key)))
+            throw new Error('Unknown property.');
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (!descriptor?.enumerable || !('value' in descriptor))
+            throw new Error('Expected an enumerable data property.');
+        Object.defineProperty(result, key, { value: descriptor.value, enumerable: true });
+    }
+    return result;
+}
+function text(value, max) {
+    if (typeof value !== 'string' || value.trim() === '' || value.length > max)
+        throw new Error('Expected bounded non-empty text.');
+    return value;
+}
+/** Validate and snapshot an authored contract once, before running an agent. */
+export function resolveAnswerValidation(options) {
+    const source = ownData(options, ['id', 'version', 'mode', 'limits', 'validate']);
+    const id = text(source.id, 128);
+    const version = text(source.version, 128);
+    const mode = source.mode === undefined ? 'enforce' : source.mode;
+    if (mode !== 'enforce' && mode !== 'observe')
+        throw new Error('answerValidation.mode must be enforce or observe.');
+    if (typeof source.validate !== 'function')
+        throw new Error('answerValidation.validate must be a function.');
+    const validate = source.validate;
+    const supplied = source.limits === undefined ? {} : ownData(source.limits, Object.keys(DEFAULT_LIMITS));
+    const limits = { ...DEFAULT_LIMITS };
+    for (const key of Object.keys(DEFAULT_LIMITS)) {
+        if (Object.hasOwn(supplied, key)) {
+            const value = supplied[key];
+            if (typeof value !== 'number' ||
+                !Number.isSafeInteger(value) ||
+                value <= 0 ||
+                (key === 'timeoutMs' && value > 2147483647))
+                throw new Error(`answerValidation.limits.${key} must be a positive bounded integer.`);
+            limits[key] = value;
+        }
+    }
+    return Object.freeze({
+        id,
+        version,
+        mode,
+        limits: Object.freeze(limits),
+        validate: (candidate, context) => validate(candidate, context),
+    });
+}
+/** JSON copy without invoking toJSON/getters or silently dropping data. */
+function jsonCopy(value, maxBytes, freeze) {
+    let budget = maxBytes;
+    const ancestors = new Set();
+    const spend = (bytes) => {
+        budget -= bytes;
+        if (budget < 0)
+            throw new Error('JSON byte limit.');
+    };
+    const string = (item) => {
+        if (item.length > budget)
+            throw new Error('JSON byte limit.');
+        spend(encoder.encode(JSON.stringify(item)).byteLength);
+    };
+    const copy = (item, depth) => {
+        if (depth > 100)
+            throw new Error('JSON nesting limit.');
+        if (item === null) {
+            spend(4);
+            return null;
+        }
+        if (typeof item === 'string') {
+            string(item);
+            return item;
+        }
+        if (typeof item === 'boolean') {
+            spend(item ? 4 : 5);
+            return item;
+        }
+        if (typeof item === 'number') {
+            if (!Number.isFinite(item) || Object.is(item, -0))
+                throw new Error('Non-lossless JSON number.');
+            spend(JSON.stringify(item).length);
+            return item;
+        }
+        if (typeof item !== 'object')
+            throw new Error('Non-JSON value.');
+        if (ancestors.has(item))
+            throw new Error('Cyclic JSON value.');
+        ancestors.add(item);
+        spend(2);
+        let output;
+        if (Array.isArray(item)) {
+            if (Object.getPrototypeOf(item) !== Array.prototype)
+                throw new Error('Non-JSON array prototype.');
+            if (item.length > budget + 1)
+                throw new Error('JSON byte limit.');
+            const keys = Reflect.ownKeys(item);
+            if (keys.length !== item.length + 1)
+                throw new Error('Sparse or decorated array.');
+            const result = [];
+            for (let index = 0; index < item.length; index++) {
+                const descriptor = Object.getOwnPropertyDescriptor(item, String(index));
+                if (!descriptor?.enumerable || !('value' in descriptor))
+                    throw new Error('Sparse or accessor array.');
+                if (index)
+                    spend(1);
+                result.push(copy(descriptor.value, depth + 1));
+            }
+            output = result;
+        }
+        else {
+            const fields = ownData(item);
+            const result = {};
+            let index = 0;
+            for (const key of Object.keys(fields)) {
+                if (index++)
+                    spend(1);
+                string(key);
+                spend(1);
+                Object.defineProperty(result, key, {
+                    value: copy(fields[key], depth + 1),
+                    enumerable: true,
+                    writable: true,
+                    configurable: true,
+                });
+            }
+            output = result;
+        }
+        ancestors.delete(item);
+        return freeze ? Object.freeze(output) : output;
+    };
+    return copy(value, 0);
+}
+function readChecks(value, config, resolved) {
+    // Bound before copying. The copy rejects getters, class instances, cycles,
+    // decorated arrays and values JSON would otherwise silently discard.
+    const source = ownData(value, ['checks']);
+    if (!Array.isArray(source.checks) || source.checks.length > config.limits.maxChecks)
+        throw new Error('Invalid checks.');
+    const detached = jsonCopy(source.checks, config.limits.maxChecks * 4096, false);
+    const ids = new Set();
+    const refs = new Set(resolved);
+    return detached.map((raw) => {
+        const check = ownData(raw, ['id', 'disposition', 'reason', 'path', 'evidenceRefs']);
+        const id = text(check.id, 128);
+        if (ids.has(id) ||
+            typeof check.disposition !== 'string' ||
+            !dispositions.has(check.disposition))
+            throw new Error('Invalid check identity or disposition.');
+        ids.add(id);
+        const reason = check.reason === undefined ? undefined : text(check.reason, 1024);
+        const path = check.path;
+        if (path !== undefined && (typeof path !== 'string' || path.length > 256))
+            throw new Error('Invalid check path.');
+        let evidenceRefs;
+        if (check.evidenceRefs !== undefined) {
+            if (!Array.isArray(check.evidenceRefs) || check.evidenceRefs.length > config.limits.maxReads)
+                throw new Error('Invalid evidence references.');
+            evidenceRefs = check.evidenceRefs.map((ref) => {
+                if (typeof ref !== 'string' || !refs.has(ref))
+                    throw new Error('Unresolved evidence reference.');
+                return ref;
+            });
+            if (new Set(evidenceRefs).size !== evidenceRefs.length)
+                throw new Error('Duplicate evidence reference.');
+        }
+        return Object.freeze({
+            id,
+            disposition: check.disposition,
+            ...(reason !== undefined && { reason }),
+            ...(path !== undefined && { path }),
+            ...(evidenceRefs !== undefined && { evidenceRefs: Object.freeze(evidenceRefs) }),
+        });
+    });
+}
+/**
+ * Validate once. Content is present only when delivery is permitted by this
+ * contract. It is the exact JSON string whose detached value was checked;
+ * callers must not reparse through a transforming schema or rewrite afterward.
+ */
+export async function executeAnswerValidation(raw, parser, config, store, scope, signal) {
+    const controller = new AbortController();
+    const evidence = createAnswerEvidenceResolver(store, scope, config.limits, controller.signal);
+    let reason;
+    let schemaAccepted = false;
+    let canonical;
+    let candidateDigest;
+    let checks = [];
+    let active = true;
+    let stop;
+    const abort = () => {
+        reason = 'aborted';
+        controller.abort();
+        stop?.();
+    };
+    const timedOut = () => {
+        reason = 'timeout';
+        controller.abort();
+        stop?.();
+    };
+    const deadline = Date.now() + config.limits.timeoutMs;
+    const timer = setTimeout(timedOut, config.limits.timeoutMs);
+    signal?.addEventListener('abort', abort, { once: true });
+    if (signal?.aborted)
+        abort();
+    try {
+        const interrupted = new Promise((resolve) => {
+            stop = resolve;
+            if (controller.signal.aborted)
+                resolve();
+        });
+        const work = async () => {
+            if (controller.signal.aborted)
+                return;
+            let candidate;
+            try {
+                if (raw.length > config.limits.maxCandidateBytes ||
+                    encoder.encode(raw).byteLength > config.limits.maxCandidateBytes) {
+                    reason = 'candidate-limit';
+                    return;
+                }
+                candidate = applyOutputSchema(raw, parser);
+            }
+            catch {
+                reason = 'schema-rejected';
+                return;
+            }
+            try {
+                candidate = jsonCopy(candidate, config.limits.maxCandidateBytes, true);
+                canonical = JSON.stringify(candidate);
+                schemaAccepted = true;
+            }
+            catch {
+                reason = 'non-json-candidate';
+                return;
+            }
+            if (Date.now() >= deadline) {
+                timedOut();
+                return;
+            }
+            try {
+                const digest = await computeArtifactDigest(canonical);
+                if (!active || controller.signal.aborted)
+                    return;
+                candidateDigest = digest;
+                const returned = await config.validate(candidate, Object.freeze({ signal: controller.signal, artifacts: evidence.resolver }));
+                if (!active || controller.signal.aborted)
+                    return;
+                if (Date.now() >= deadline) {
+                    timedOut();
+                    return;
+                }
+                try {
+                    checks = readChecks(returned, config, evidence.resolvedRefs());
+                }
+                catch {
+                    reason = 'invalid-validator-result';
+                }
+            }
+            catch {
+                if (active && !controller.signal.aborted)
+                    reason = 'validator-error';
+            }
+        };
+        await Promise.race([work(), interrupted]);
+    }
+    finally {
+        active = false;
+        clearTimeout(timer);
+        signal?.removeEventListener('abort', abort);
+        evidence.close();
+        controller.abort();
+    }
+    const failed = checks.filter((check) => check.disposition === 'checked-fail').length;
+    const checked = failed + checks.filter((check) => check.disposition === 'checked-pass').length;
+    const unreachable = checks.filter((check) => check.disposition === 'unreachable').length;
+    const notApplicable = checks.filter((check) => check.disposition === 'not-applicable').length;
+    if (!reason && evidence.failureReason())
+        reason = `evidence-${evidence.failureReason()}`;
+    if (!reason && checked === 0)
+        reason = 'no-comparable-checks';
+    if (!reason && unreachable > 0)
+        reason = 'unreachable-checks';
+    const status = reason ? 'unverified' : failed > 0 ? 'failed' : 'passed';
+    const report = Object.freeze({
+        validatorId: config.id,
+        validatorVersion: config.version,
+        mode: config.mode,
+        status,
+        checked,
+        failed,
+        unreachable,
+        notApplicable,
+        checks: Object.freeze(checks),
+        schemaAccepted,
+        ...(reason !== undefined && { reason }),
+        ...(candidateDigest !== undefined && { candidateDigest }),
+        resolvedRefs: Object.freeze(evidence.resolvedRefs()),
+    });
+    const content = status === 'passed' || config.mode === 'observe' ? canonical ?? raw : undefined;
+    return { report, ...(content !== undefined && { content }) };
+}
+//# sourceMappingURL=validate.js.map

package/dist/esm/answer-validation/validate.js.map

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

package/dist/esm/cache/CacheGateDecider.js

@@ -58,7 +58,13 @@ export function detectSkillChurn(history, windowSize = SKILL_CHURN_WINDOW, thres
     const recent = history.slice(-windowSize);
     const uniqueSkills = new Set();
     for (const s of recent) {
-        if (s !== undefined)
+        // A skill id is a string; anything else is "no skill on this turn". The
+        // slot is `undefined` when the run had no skill yet — and it was `null`
+        // in every record written before footprintjs 9.24.0, whose scope
+        // round-tripped the array through JSON. That `null` counted here as a
+        // skill and turned caching OFF on the first turn after two real skills
+        // (a phantom churn; found by the 9.24.0 byte-identity run).
+        if (typeof s === 'string')
             uniqueSkills.add(s);
     }
     return uniqueSkills.size >= threshold;

package/dist/esm/cache/CacheGateDecider.js.map

@@ -1 +1 @@
-{"version":3,"file":"CacheGateDecider.js","sourceRoot":"","sources":["../../../src/cache/CacheGateDecider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,MAAM,EAAwC,MAAM,aAAa,CAAC;AA6B3E;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAElC;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEvC;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAwC,EACxC,aAAqB,kBAAkB,EACvC,YAAoB,qBAAqB;IAEzC,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,yBAAyB;IACvE,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,KAAK,SAAS;YAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,YAAY,CAAC,IAAI,IAAI,SAAS,CAAC;AACxC,CAAC;AAQD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,KAAiC;IAC/D,OAAO,MAAM,CACX,KAAK,EACL;QACE;YACE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,KAAK,IAAI;YACvC,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,uDAAuD;SAC/D;QACD;YACE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,SAAS,IAAI,CAAC,CAAC,aAAa,GAAG,cAAc;YAC9E,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,cAAc,cAAc,GAAG,GAAG,kBAAkB;SAC5D;QACD;YACE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,YAAY,CAAC;YAC7C,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,iBAAiB,qBAAqB,0BAA0B,kBAAkB,SAAS;SACnG;KACF,EACD,eAAe,CAChB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAGE;IAEF,MAAM,GAAG,GAAG,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,EAAE,OAAO,CAAC,CAAC;IACjC,+DAA+D;IAC/D,mDAAmD;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,kBAAkB,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,kBAAkB,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClG,KAAK,CAAC,YAAY,GAAG,OAAO,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"CacheGateDecider.js","sourceRoot":"","sources":["../../../src/cache/CacheGateDecider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,MAAM,EAAwC,MAAM,aAAa,CAAC;AA6B3E;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAElC;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEvC;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAwC,EACxC,aAAqB,kBAAkB,EACvC,YAAoB,qBAAqB;IAEzC,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,yBAAyB;IACvE,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,wEAAwE;QACxE,wEAAwE;QACxE,iEAAiE;QACjE,sEAAsE;QACtE,uEAAuE;QACvE,4DAA4D;QAC5D,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,YAAY,CAAC,IAAI,IAAI,SAAS,CAAC;AACxC,CAAC;AAQD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,KAAiC;IAC/D,OAAO,MAAM,CACX,KAAK,EACL;QACE;YACE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,KAAK,IAAI;YACvC,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,uDAAuD;SAC/D;QACD;YACE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,SAAS,IAAI,CAAC,CAAC,aAAa,GAAG,cAAc;YAC9E,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,cAAc,cAAc,GAAG,GAAG,kBAAkB;SAC5D;QACD;YACE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,YAAY,CAAC;YAC7C,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,iBAAiB,qBAAqB,0BAA0B,kBAAkB,SAAS;SACnG;KACF,EACD,eAAe,CAChB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAGE;IAEF,MAAM,GAAG,GAAG,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,EAAE,OAAO,CAAC,CAAC;IACjC,+DAA+D;IAC/D,mDAAmD;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,kBAAkB,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,kBAAkB,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClG,KAAK,CAAC,YAAY,GAAG,OAAO,CAAC;AAC/B,CAAC"}