niceeval 0.15.1-canary.76 → 0.16.1

package/dist/o11y/judge-usage-receipt.cjs

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeJudgeUsageResponse = normalizeJudgeUsageResponse;
+const effect_1 = require("effect");
+const core_ts_1 = require("../record/codec/core.cjs");
+const digest_ts_1 = require("../record/definition/digest.cjs");
+const common_ts_1 = require("../record/family/common.cjs");
+const codec_ts_1 = require("../record/family/source-receipt/codec.cjs");
+const pricing_ts_1 = require("../record/family/adapter-usage/pricing.cjs");
+const schema_ts_1 = require("../record/family/judge-usage/schema.cjs");
+const ProviderSchema = schema_ts_1.JudgeUsageModelSchema.check(effect_1.Schema.makeFilter((value) => new TextEncoder().encode(value).byteLength <= 256));
+const JsonResponseSchema = effect_1.Schema.fromJsonString(effect_1.Schema.Unknown);
+function unavailable(reason, responseDigest) {
+    return Object.freeze({
+        provider: null, model: null, inputTokens: null, inputTotalTokens: null, outputTokens: null,
+        cacheReadTokens: null, cacheWriteTokens: null, cost: null,
+        receipt: Object.freeze({ state: "unavailable", reason, responseDigest, fields: Object.freeze([]) }),
+    });
+}
+/** Retains only protocol facts, independently of status and QA/body interpretation. */
+function normalizeJudgeUsageResponse(transportProvider, body) {
+    const bytes = new TextEncoder().encode(body);
+    if (body.length === 0)
+        return unavailable("response-unavailable", null);
+    const responseDigest = `sha256:${new digest_ts_1.RecordSha256().update(bytes).digestHex()}`;
+    const decoded = effect_1.Schema.decodeUnknownResult(JsonResponseSchema)(body);
+    if (effect_1.Result.isFailure(decoded))
+        return unavailable("invalid-json", responseDigest);
+    const root = decoded.success;
+    if (!effect_1.Predicate.isObject(root) || Array.isArray(root))
+        return unavailable("invalid-usage", responseDigest);
+    const fields = [];
+    let invalidUsage = root.usage !== undefined && (!effect_1.Predicate.isObject(root.usage) || Array.isArray(root.usage));
+    let modelTooLarge = false;
+    function read(path) {
+        let value = root;
+        for (const key of path.split(".")) {
+            if (!effect_1.Predicate.isObject(value) || Array.isArray(value) || !Object.hasOwn(value, key))
+                return undefined;
+            value = value[key];
+        }
+        return value;
+    }
+    function scalar(path, schema) {
+        const raw = read(path);
+        if (raw === undefined)
+            return null;
+        const value = effect_1.Schema.decodeUnknownResult(schema, core_ts_1.RecordExactParseOptions)(raw);
+        if (effect_1.Result.isFailure(value)) {
+            if (path === "model" && typeof raw === "string" && new TextEncoder().encode(raw).byteLength > schema_ts_1.JudgeUsageLimits.maximumModelBytes)
+                modelTooLarge = true;
+            else
+                invalidUsage = true;
+            return null;
+        }
+        // Schemas above accept only string/number encodings, so arbitrary JSON never enters a receipt.
+        if (typeof raw === "string" || typeof raw === "number")
+            fields.push({ path, value: raw === 0 ? 0 : raw });
+        return value.success;
+    }
+    const model = scalar("model", schema_ts_1.JudgeUsageModelSchema);
+    const provider = transportProvider === "openrouter" ? scalar("provider", ProviderSchema) : null;
+    const inputPath = transportProvider === "typesafe" ? "usage.input_tokens" : "usage.prompt_tokens";
+    const outputPath = transportProvider === "typesafe" ? "usage.output_tokens" : "usage.completion_tokens";
+    let inputTotalTokens = scalar(inputPath, common_ts_1.NonNegativeSafeIntegerSchema);
+    let outputTokens = scalar(outputPath, common_ts_1.NonNegativeSafeIntegerSchema);
+    const totalTokens = scalar("usage.total_tokens", common_ts_1.NonNegativeSafeIntegerSchema);
+    let cacheReadTokens = transportProvider === "typesafe" ? null
+        : scalar("usage.prompt_tokens_details.cached_tokens", common_ts_1.NonNegativeSafeIntegerSchema);
+    let cacheWriteTokens = transportProvider === "openrouter"
+        ? scalar("usage.prompt_tokens_details.cache_write_tokens", common_ts_1.NonNegativeSafeIntegerSchema) : null;
+    let inputTokens = null;
+    if (transportProvider !== "typesafe") {
+        const details = read("usage.prompt_tokens_details.cached_tokens");
+        const write = read("usage.prompt_tokens_details.cache_write_tokens");
+        const usage = root.usage;
+        const malformedDetails = effect_1.Predicate.isObject(usage) && usage.prompt_tokens_details !== undefined &&
+            (!effect_1.Predicate.isObject(usage.prompt_tokens_details) || Array.isArray(usage.prompt_tokens_details));
+        if (malformedDetails)
+            invalidUsage = true;
+        const invalidCache = malformedDetails || details !== undefined && cacheReadTokens === null ||
+            transportProvider === "openrouter" && write !== undefined && cacheWriteTokens === null;
+        const invalidZeroWrite = write !== undefined &&
+            (!effect_1.Schema.is(common_ts_1.NonNegativeSafeIntegerSchema)(write) || write !== 0);
+        const knownSum = (cacheReadTokens ?? 0) + (cacheWriteTokens ?? 0);
+        if (!Number.isSafeInteger(knownSum) || inputTotalTokens !== null &&
+            (knownSum > inputTotalTokens || inputTotalTokens === 0 && (invalidCache || invalidZeroWrite))) {
+            invalidUsage = true;
+            inputTotalTokens = cacheReadTokens = cacheWriteTokens = null;
+        }
+        else if (inputTotalTokens === 0 && !invalidCache) {
+            // Non-negative sub-buckets of an explicitly zero total are independently zero.
+            inputTokens = cacheReadTokens = cacheWriteTokens = 0;
+        }
+        else if (inputTotalTokens !== null && cacheReadTokens !== null && cacheWriteTokens !== null) {
+            inputTokens = inputTotalTokens - cacheReadTokens - cacheWriteTokens;
+        }
+    }
+    const invalidTotal = read("usage.total_tokens") !== undefined && totalTokens === null;
+    if (invalidTotal || totalTokens !== null &&
+        (inputTotalTokens !== null && inputTotalTokens > totalTokens || outputTokens !== null && outputTokens > totalTokens) ||
+        inputTotalTokens !== null && outputTokens !== null &&
+            (!Number.isSafeInteger(inputTotalTokens + outputTokens) || totalTokens !== null && totalTokens !== inputTotalTokens + outputTokens)) {
+        invalidUsage = true;
+        inputTokens = inputTotalTokens = outputTokens = cacheReadTokens = cacheWriteTokens = null;
+    }
+    let cost = null;
+    if (transportProvider === "openrouter") {
+        const raw = read("usage.cost");
+        if (raw !== undefined) {
+            const amount = typeof raw === "number" && effect_1.Schema.is(common_ts_1.FiniteNonNegativeNumberSchema)(raw)
+                ? (0, pricing_ts_1.canonicalDecimalFromNumber)(raw) : raw;
+            const parsed = effect_1.Schema.decodeUnknownResult(codec_ts_1.CanonicalDecimalSchema)(amount);
+            if (effect_1.Result.isFailure(parsed))
+                invalidUsage = true;
+            else {
+                const currency = effect_1.Schema.decodeUnknownSync(codec_ts_1.CurrencyCodeSchema)("USD");
+                cost = Object.freeze({ amount: parsed.success, currency, source: Object.freeze({ kind: "reported", id: "openrouter.usage.cost" }) });
+                if (typeof raw === "string" || typeof raw === "number")
+                    fields.push({ path: "usage.cost", value: raw === 0 ? 0 : raw });
+            }
+        }
+    }
+    fields.sort((left, right) => left.path < right.path ? -1 : left.path > right.path ? 1 : 0);
+    const usageReported = fields.some((field) => field.path.startsWith("usage."));
+    const reason = invalidUsage ? "invalid-usage" : modelTooLarge ? "response-model-too-large" : usageReported ? null : "usage-not-reported";
+    return Object.freeze({
+        provider, model, inputTokens, inputTotalTokens, outputTokens, cacheReadTokens, cacheWriteTokens, cost,
+        receipt: Object.freeze({
+            state: fields.length > 0 ? "available" : "unavailable", reason, responseDigest,
+            fields: Object.freeze(fields.map((field) => Object.freeze(field))),
+        }),
+    });
+}
+//# sourceMappingURL=judge-usage-receipt.cjs.map

package/dist/o11y/judge-usage-receipt.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"judge-usage-receipt.js","sourceRoot":"","sources":["judge-usage-receipt.ts"],"names":[],"mappings":"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","sourcesContent":["import { Predicate, Result, Schema } from \"effect\";\nimport { RecordExactParseOptions } from \"../record/codec/core.ts\";\nimport { RecordSha256 } from \"../record/definition/digest.ts\";\nimport { FiniteNonNegativeNumberSchema, NonNegativeSafeIntegerSchema } from \"../record/family/common.ts\";\nimport { CanonicalDecimalSchema, CurrencyCodeSchema } from \"../record/family/source-receipt/codec.ts\";\nimport { canonicalDecimalFromNumber } from \"../record/family/adapter-usage/pricing.ts\";\nimport { JudgeUsageLimits, JudgeUsageModelSchema, type JudgeUsageCall } from \"../record/family/judge-usage/schema.ts\";\ntype NormalizedResponse = Pick<JudgeUsageCall, \"provider\" | \"model\" | \"inputTokens\" | \"inputTotalTokens\" | \"outputTokens\" | \"cacheReadTokens\" | \"cacheWriteTokens\" | \"cost\" | \"receipt\">;\ntype Field = JudgeUsageCall[\"receipt\"][\"fields\"][number];\nconst ProviderSchema = JudgeUsageModelSchema.check(Schema.makeFilter((value) => new TextEncoder().encode(value).byteLength <= 256));\nconst JsonResponseSchema = Schema.fromJsonString(Schema.Unknown);\nfunction unavailable(reason: JudgeUsageCall[\"receipt\"][\"reason\"], responseDigest: string | null): NormalizedResponse {\n    return Object.freeze({\n        provider: null, model: null, inputTokens: null, inputTotalTokens: null, outputTokens: null,\n        cacheReadTokens: null, cacheWriteTokens: null, cost: null,\n        receipt: Object.freeze({ state: \"unavailable\", reason, responseDigest, fields: Object.freeze([]) }),\n    });\n}\n/** Retains only protocol facts, independently of status and QA/body interpretation. */\nexport function normalizeJudgeUsageResponse(transportProvider: JudgeUsageCall[\"transportProvider\"], body: string): NormalizedResponse {\n    const bytes = new TextEncoder().encode(body);\n    if (body.length === 0)\n        return unavailable(\"response-unavailable\", null);\n    const responseDigest = `sha256:${new RecordSha256().update(bytes).digestHex()}`;\n    const decoded = Schema.decodeUnknownResult(JsonResponseSchema)(body);\n    if (Result.isFailure(decoded))\n        return unavailable(\"invalid-json\", responseDigest);\n    const root = decoded.success;\n    if (!Predicate.isObject(root) || Array.isArray(root))\n        return unavailable(\"invalid-usage\", responseDigest);\n    const fields: Field[] = [];\n    let invalidUsage = root.usage !== undefined && (!Predicate.isObject(root.usage) || Array.isArray(root.usage));\n    let modelTooLarge = false;\n    function read(path: Field[\"path\"]): unknown {\n        let value: unknown = root;\n        for (const key of path.split(\".\")) {\n            if (!Predicate.isObject(value) || Array.isArray(value) || !Object.hasOwn(value, key))\n                return undefined;\n            value = value[key];\n        }\n        return value;\n    }\n    function scalar<A>(path: Field[\"path\"], schema: Schema.Codec<A, string | number>): A | null {\n        const raw = read(path);\n        if (raw === undefined)\n            return null;\n        const value = Schema.decodeUnknownResult(schema, RecordExactParseOptions)(raw);\n        if (Result.isFailure(value)) {\n            if (path === \"model\" && typeof raw === \"string\" && new TextEncoder().encode(raw).byteLength > JudgeUsageLimits.maximumModelBytes)\n                modelTooLarge = true;\n            else\n                invalidUsage = true;\n            return null;\n        }\n        // Schemas above accept only string/number encodings, so arbitrary JSON never enters a receipt.\n        if (typeof raw === \"string\" || typeof raw === \"number\")\n            fields.push({ path, value: raw === 0 ? 0 : raw });\n        return value.success;\n    }\n    const model = scalar(\"model\", JudgeUsageModelSchema);\n    const provider = transportProvider === \"openrouter\" ? scalar(\"provider\", ProviderSchema) : null;\n    const inputPath = transportProvider === \"typesafe\" ? \"usage.input_tokens\" : \"usage.prompt_tokens\";\n    const outputPath = transportProvider === \"typesafe\" ? \"usage.output_tokens\" : \"usage.completion_tokens\";\n    let inputTotalTokens = scalar(inputPath, NonNegativeSafeIntegerSchema);\n    let outputTokens = scalar(outputPath, NonNegativeSafeIntegerSchema);\n    const totalTokens = scalar(\"usage.total_tokens\", NonNegativeSafeIntegerSchema);\n    let cacheReadTokens = transportProvider === \"typesafe\" ? null\n        : scalar(\"usage.prompt_tokens_details.cached_tokens\", NonNegativeSafeIntegerSchema);\n    let cacheWriteTokens = transportProvider === \"openrouter\"\n        ? scalar(\"usage.prompt_tokens_details.cache_write_tokens\", NonNegativeSafeIntegerSchema) : null;\n    let inputTokens: number | null = null;\n    if (transportProvider !== \"typesafe\") {\n        const details = read(\"usage.prompt_tokens_details.cached_tokens\");\n        const write = read(\"usage.prompt_tokens_details.cache_write_tokens\");\n        const usage = root.usage;\n        const malformedDetails = Predicate.isObject(usage) && usage.prompt_tokens_details !== undefined &&\n            (!Predicate.isObject(usage.prompt_tokens_details) || Array.isArray(usage.prompt_tokens_details));\n        if (malformedDetails)\n            invalidUsage = true;\n        const invalidCache = malformedDetails || details !== undefined && cacheReadTokens === null ||\n            transportProvider === \"openrouter\" && write !== undefined && cacheWriteTokens === null;\n        const invalidZeroWrite = write !== undefined &&\n            (!Schema.is(NonNegativeSafeIntegerSchema)(write) || write !== 0);\n        const knownSum = (cacheReadTokens ?? 0) + (cacheWriteTokens ?? 0);\n        if (!Number.isSafeInteger(knownSum) || inputTotalTokens !== null &&\n            (knownSum > inputTotalTokens || inputTotalTokens === 0 && (invalidCache || invalidZeroWrite))) {\n            invalidUsage = true;\n            inputTotalTokens = cacheReadTokens = cacheWriteTokens = null;\n        }\n        else if (inputTotalTokens === 0 && !invalidCache) {\n            // Non-negative sub-buckets of an explicitly zero total are independently zero.\n            inputTokens = cacheReadTokens = cacheWriteTokens = 0;\n        }\n        else if (inputTotalTokens !== null && cacheReadTokens !== null && cacheWriteTokens !== null) {\n            inputTokens = inputTotalTokens - cacheReadTokens - cacheWriteTokens;\n        }\n    }\n    const invalidTotal = read(\"usage.total_tokens\") !== undefined && totalTokens === null;\n    if (invalidTotal || totalTokens !== null &&\n        (inputTotalTokens !== null && inputTotalTokens > totalTokens || outputTokens !== null && outputTokens > totalTokens) ||\n        inputTotalTokens !== null && outputTokens !== null &&\n            (!Number.isSafeInteger(inputTotalTokens + outputTokens) || totalTokens !== null && totalTokens !== inputTotalTokens + outputTokens)) {\n        invalidUsage = true;\n        inputTokens = inputTotalTokens = outputTokens = cacheReadTokens = cacheWriteTokens = null;\n    }\n    let cost: JudgeUsageCall[\"cost\"] = null;\n    if (transportProvider === \"openrouter\") {\n        const raw = read(\"usage.cost\");\n        if (raw !== undefined) {\n            const amount = typeof raw === \"number\" && Schema.is(FiniteNonNegativeNumberSchema)(raw)\n                ? canonicalDecimalFromNumber(raw) : raw;\n            const parsed = Schema.decodeUnknownResult(CanonicalDecimalSchema)(amount);\n            if (Result.isFailure(parsed))\n                invalidUsage = true;\n            else {\n                const currency = Schema.decodeUnknownSync(CurrencyCodeSchema)(\"USD\");\n                cost = Object.freeze({ amount: parsed.success, currency, source: Object.freeze({ kind: \"reported\", id: \"openrouter.usage.cost\" }) });\n                if (typeof raw === \"string\" || typeof raw === \"number\")\n                    fields.push({ path: \"usage.cost\", value: raw === 0 ? 0 : raw });\n            }\n        }\n    }\n    fields.sort((left, right) => left.path < right.path ? -1 : left.path > right.path ? 1 : 0);\n    const usageReported = fields.some((field) => field.path.startsWith(\"usage.\"));\n    const reason = invalidUsage ? \"invalid-usage\" : modelTooLarge ? \"response-model-too-large\" : usageReported ? null : \"usage-not-reported\";\n    return Object.freeze({\n        provider, model, inputTokens, inputTotalTokens, outputTokens, cacheReadTokens, cacheWriteTokens, cost,\n        receipt: Object.freeze({\n            state: fields.length > 0 ? \"available\" : \"unavailable\", reason, responseDigest,\n            fields: Object.freeze(fields.map((field) => Object.freeze(field))),\n        }),\n    });\n}\n"]}

package/dist/o11y/judge-usage-receipt.d.cts

@@ -0,0 +1,5 @@
+import { type JudgeUsageCall } from "../record/family/judge-usage/schema.cjs";
+type NormalizedResponse = Pick<JudgeUsageCall, "provider" | "model" | "inputTokens" | "inputTotalTokens" | "outputTokens" | "cacheReadTokens" | "cacheWriteTokens" | "cost" | "receipt">;
+/** Retains only protocol facts, independently of status and QA/body interpretation. */
+export declare function normalizeJudgeUsageResponse(transportProvider: JudgeUsageCall["transportProvider"], body: string): NormalizedResponse;
+export {};

package/dist/o11y/judge-usage-receipt.d.mts

@@ -0,0 +1,5 @@
+import { type JudgeUsageCall } from "../record/family/judge-usage/schema.mjs";
+type NormalizedResponse = Pick<JudgeUsageCall, "provider" | "model" | "inputTokens" | "inputTotalTokens" | "outputTokens" | "cacheReadTokens" | "cacheWriteTokens" | "cost" | "receipt">;
+/** Retains only protocol facts, independently of status and QA/body interpretation. */
+export declare function normalizeJudgeUsageResponse(transportProvider: JudgeUsageCall["transportProvider"], body: string): NormalizedResponse;
+export {};

package/dist/o11y/judge-usage-receipt.d.ts

@@ -0,0 +1,5 @@
+import { type JudgeUsageCall } from "../record/family/judge-usage/schema.js";
+type NormalizedResponse = Pick<JudgeUsageCall, "provider" | "model" | "inputTokens" | "inputTotalTokens" | "outputTokens" | "cacheReadTokens" | "cacheWriteTokens" | "cost" | "receipt">;
+/** Retains only protocol facts, independently of status and QA/body interpretation. */
+export declare function normalizeJudgeUsageResponse(transportProvider: JudgeUsageCall["transportProvider"], body: string): NormalizedResponse;
+export {};

package/dist/o11y/judge-usage-receipt.js

@@ -0,0 +1,6 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./judge-usage-receipt.cjs");
+const __niceevalExport0 = __niceevalCanonical["normalizeJudgeUsageResponse"];
+export { __niceevalExport0 as normalizeJudgeUsageResponse };
+//# sourceMappingURL=judge-usage-receipt.js.map

package/dist/o11y/judge-usage-receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"judge-usage-receipt.js","sources":[],"names":[],"mappings":""}

package/dist/o11y/judge-usage.cjs

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JudgeUsageCollector = void 0;
+const effect_1 = require("effect");
+const codec_ts_1 = require("../assertions/record/codec.cjs");
+const canonical_ts_1 = require("../record/definition/canonical.cjs");
+const protocol_ts_1 = require("../record/attachment/protocol.cjs");
+const judge_usage_receipt_ts_1 = require("./judge-usage-receipt.cjs");
+const judge_call_price_ts_1 = require("./judge-call-price.cjs");
+const placeholderEntryId = effect_1.Schema.decodeUnknownSync(codec_ts_1.AssertionEntryIdSchema)("ae_00000000000000000000");
+const emptyReceipt = Object.freeze({
+    state: "unavailable", reason: "response-unavailable", responseDigest: null, fields: Object.freeze([]),
+});
+const completeCollection = Object.freeze({ state: "complete", limitations: Object.freeze([]) });
+/** One Attempt owns admission, receipt cuts and all transport cleanup promises. */
+class JudgeUsageCollector {
+    signal;
+    onCleanupIncomplete;
+    rows = [];
+    entries = new Map();
+    cleanups = new Set();
+    closed = false;
+    cleanupIncomplete = false;
+    pricing;
+    onAbort = () => this.close();
+    constructor(pricing, signal, onCleanupIncomplete) {
+        this.signal = signal;
+        this.onCleanupIncomplete = onCleanupIncomplete;
+        this.pricing = pricing === undefined ? undefined : freeze(structuredClone(pricing));
+        signal?.addEventListener("abort", this.onAbort, { once: true });
+        if (signal?.aborted)
+            this.close();
+    }
+    forEntry(entryIndex) {
+        const previous = this.entries.get(entryIndex);
+        if (!Number.isSafeInteger(entryIndex) || entryIndex < 0 || (previous !== undefined && previous.rows.length > 0)) {
+            throw new Error("Judge usage requires one capability per Assertion entry");
+        }
+        if (previous !== undefined)
+            previous.closed = true;
+        const entry = { closed: this.closed, rows: [] };
+        this.entries.set(entryIndex, entry);
+        return Object.freeze({
+            begin: (input) => {
+                if (this.closed || entry.closed || this.signal?.aborted || this.rows.length >= 4000)
+                    return undefined;
+                const call = Object.freeze({
+                    ...input, entryIndex, entryId: placeholderEntryId,
+                    callId: `judge:${entryIndex}:${input.logicalOrdinal}:${input.transmissionOrdinal}`,
+                    provider: null, model: null, status: "unknown", httpStatus: null,
+                    inputTokens: null, inputTotalTokens: null, outputTokens: null, cacheReadTokens: null, cacheWriteTokens: null,
+                    cost: null, receipt: emptyReceipt,
+                });
+                if (this.rows.some((row) => row.call.callId === call.callId))
+                    throw new Error("Duplicate Judge physical call identity");
+                const row = { call, open: true };
+                if (!this.canReserve(row))
+                    return undefined;
+                this.rows.push(row);
+                entry.rows.push(row);
+                const terminal = (status, reason) => {
+                    if (!row.open)
+                        return;
+                    row.open = false;
+                    row.call = Object.freeze({ ...row.call, status, receipt: Object.freeze({ ...emptyReceipt, reason }) });
+                };
+                return Object.freeze({
+                    headers: (status) => {
+                        if (row.open && Number.isInteger(status) && status >= 100 && status <= 599)
+                            row.call = Object.freeze({ ...row.call, httpStatus: status });
+                    },
+                    body: (body) => {
+                        if (!row.open)
+                            return;
+                        // No await may separate the receipt cut and its immutable contribution.
+                        const receipt = (0, judge_usage_receipt_ts_1.normalizeJudgeUsageResponse)(input.transportProvider, body);
+                        row.open = false;
+                        row.call = freeze({ ...row.call, ...receipt, status: row.call.httpStatus !== null && row.call.httpStatus >= 200 && row.call.httpStatus < 300 ? "succeeded" : "failed" });
+                    },
+                    fail: (reason) => terminal("failed", reason),
+                    cancel: () => terminal("cancelled", "cancelled"),
+                    trackCleanup: (work, deadlineAt) => this.trackCleanup(work, deadlineAt),
+                });
+            },
+            close: () => {
+                entry.closed = true;
+                for (const row of entry.rows)
+                    this.cancelRow(row);
+            },
+        });
+    }
+    cancelRow(row) {
+        if (!row.open)
+            return;
+        row.open = false;
+        row.call = Object.freeze({ ...row.call, status: "cancelled", receipt: Object.freeze({ ...emptyReceipt, reason: "cancelled" }) });
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.signal?.removeEventListener("abort", this.onAbort);
+        for (const entry of this.entries.values())
+            entry.closed = true;
+        for (const row of this.rows)
+            this.cancelRow(row);
+    }
+    async closeAndDrain() {
+        this.close();
+        while (this.cleanups.size > 0)
+            await Promise.all([...this.cleanups]);
+    }
+    snapshot() {
+        if (!this.closed)
+            throw new Error("Judge usage must close before publication");
+        const calls = Object.freeze(this.rows.map((row) => row.call));
+        return freeze({
+            collection: completeCollection,
+            calls,
+            priceReceipts: (0, judge_call_price_ts_1.createJudgeCallPriceReceipts)(calls, this.pricing),
+        });
+    }
+    trackCleanup(work, deadlineAt) {
+        let timer;
+        const settled = work.then(() => true, () => false);
+        const expired = new Promise((resolve) => { timer = setTimeout(() => resolve(false), Math.max(0, Math.min(1000, deadlineAt - Date.now()))); });
+        const bounded = Promise.race([settled, expired]).then((ok) => {
+            if (timer !== undefined)
+                clearTimeout(timer);
+            if (!ok && !this.cleanupIncomplete) {
+                this.cleanupIncomplete = true;
+                this.onCleanupIncomplete?.();
+            }
+        });
+        this.cleanups.add(bounded);
+        void bounded.then(() => this.cleanups.delete(bounded));
+    }
+    canReserve(next) {
+        const rows = [...this.rows, next];
+        const terminalCalls = rows.filter((row) => !row.open).map((row) => row.call);
+        // Receipt padding bounds canonical bytes; scalar rows additionally bound nodes,
+        // keys and depth. Price padding includes both legal 8 KiB model selectors.
+        const calls = rows.map((row) => row.open ? {
+            ...row.call, entryId: "a".repeat(256), provider: '"'.repeat(256), model: '"'.repeat(8192),
+            cost: { amount: "1".repeat(512), currency: "A".repeat(256), source: { kind: "reported", id: '"'.repeat(256) } },
+            receipt: { state: "available", reason: "invalid-usage", responseDigest: "0".repeat(71),
+                fields: Array.from({ length: 24 }, (_, index) => ({ path: String(index).padEnd(128, "p"), value: null })),
+                reservedCanonicalBytes: "x".repeat(32 * 1024) },
+        } : row.call);
+        const priceReceipts = [...(0, judge_call_price_ts_1.createJudgeCallPriceReceipts)(terminalCalls, this.pricing)];
+        if (this.pricing !== undefined)
+            for (const row of rows)
+                if (row.open)
+                    priceReceipts.push({
+                        callId: row.call.callId, requestModel: row.call.requestModel,
+                        reservedCanonicalBytes: "x".repeat(64 * 1024),
+                        reservedNodes: Array.from({ length: 256 }, () => ({ value: null })),
+                    });
+        return effect_1.Result.isSuccess((0, canonical_ts_1.canonicalizeRecordValue)({ collection: completeCollection, calls, priceReceipts }, protocol_ts_1.RecordAttachmentEncodingLimits));
+    }
+}
+exports.JudgeUsageCollector = JudgeUsageCollector;
+function freeze(value) {
+    if (value !== null && typeof value === "object") {
+        for (const child of Object.values(value))
+            freeze(child);
+        Object.freeze(value);
+    }
+    return value;
+}
+//# sourceMappingURL=judge-usage.cjs.map

package/dist/o11y/judge-usage.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"judge-usage.js","sourceRoot":"","sources":["judge-usage.ts"],"names":[],"mappings":"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","sourcesContent":["import { Result, Schema } from \"effect\";\nimport { AssertionEntryIdSchema } from \"../assertions/record/codec.ts\";\nimport { canonicalizeRecordValue } from \"../record/definition/canonical.ts\";\nimport { RecordAttachmentEncodingLimits } from \"../record/attachment/protocol.ts\";\nimport type { JudgeUsageAttachment, JudgeUsageCall } from \"../record/family/judge-usage/schema.ts\";\nimport type { PriceOverride } from \"../runner/types.ts\";\nimport { normalizeJudgeUsageResponse } from \"./judge-usage-receipt.ts\";\nimport { createJudgeCallPriceReceipts } from \"./judge-call-price.ts\";\ntype TransmissionInput = Pick<JudgeUsageCall, \"logicalOrdinal\" | \"transmissionOrdinal\" | \"operation\" | \"requestModel\" | \"transportProvider\">;\nexport interface JudgeUsageTransmission {\n    headers(status: number): void;\n    body(body: string): void;\n    fail(reason: \"response-unavailable\" | \"response-too-large\"): void;\n    cancel(): void;\n    trackCleanup(work: Promise<unknown>, deadlineAt: number): void;\n}\nexport interface JudgeUsageEntry {\n    begin(input: TransmissionInput): JudgeUsageTransmission | undefined;\n    close(): void;\n}\ninterface PendingCall {\n    call: JudgeUsageCall;\n    open: boolean;\n}\nconst placeholderEntryId = Schema.decodeUnknownSync(AssertionEntryIdSchema)(\"ae_00000000000000000000\");\nconst emptyReceipt: JudgeUsageCall[\"receipt\"] = Object.freeze({\n    state: \"unavailable\", reason: \"response-unavailable\", responseDigest: null, fields: Object.freeze([]),\n});\nconst completeCollection = Object.freeze({ state: \"complete\" as const, limitations: Object.freeze([] as const) });\n/** One Attempt owns admission, receipt cuts and all transport cleanup promises. */\nexport class JudgeUsageCollector {\n    private readonly rows: PendingCall[] = [];\n    private readonly entries = new Map<number, {\n        closed: boolean;\n        rows: PendingCall[];\n    }>();\n    private readonly cleanups = new Set<Promise<void>>();\n    private closed = false;\n    private cleanupIncomplete = false;\n    private readonly pricing: Readonly<Record<string, PriceOverride>> | undefined;\n    private readonly onAbort = () => this.close();\n    constructor(pricing: Readonly<Record<string, PriceOverride>> | undefined, private readonly signal?: AbortSignal, private readonly onCleanupIncomplete?: () => void) {\n        this.pricing = pricing === undefined ? undefined : freeze(structuredClone(pricing));\n        signal?.addEventListener(\"abort\", this.onAbort, { once: true });\n        if (signal?.aborted)\n            this.close();\n    }\n    forEntry(entryIndex: number): JudgeUsageEntry {\n        const previous = this.entries.get(entryIndex);\n        if (!Number.isSafeInteger(entryIndex) || entryIndex < 0 || (previous !== undefined && previous.rows.length > 0)) {\n            throw new Error(\"Judge usage requires one capability per Assertion entry\");\n        }\n        if (previous !== undefined)\n            previous.closed = true;\n        const entry = { closed: this.closed, rows: [] as PendingCall[] };\n        this.entries.set(entryIndex, entry);\n        return Object.freeze({\n            begin: (input: TransmissionInput) => {\n                if (this.closed || entry.closed || this.signal?.aborted || this.rows.length >= 4000)\n                    return undefined;\n                const call: JudgeUsageCall = Object.freeze({\n                    ...input, entryIndex, entryId: placeholderEntryId,\n                    callId: `judge:${entryIndex}:${input.logicalOrdinal}:${input.transmissionOrdinal}`,\n                    provider: null, model: null, status: \"unknown\", httpStatus: null,\n                    inputTokens: null, inputTotalTokens: null, outputTokens: null, cacheReadTokens: null, cacheWriteTokens: null,\n                    cost: null, receipt: emptyReceipt,\n                });\n                if (this.rows.some((row) => row.call.callId === call.callId))\n                    throw new Error(\"Duplicate Judge physical call identity\");\n                const row: PendingCall = { call, open: true };\n                if (!this.canReserve(row))\n                    return undefined;\n                this.rows.push(row);\n                entry.rows.push(row);\n                const terminal = (status: JudgeUsageCall[\"status\"], reason: JudgeUsageCall[\"receipt\"][\"reason\"]): void => {\n                    if (!row.open)\n                        return;\n                    row.open = false;\n                    row.call = Object.freeze({ ...row.call, status, receipt: Object.freeze({ ...emptyReceipt, reason }) });\n                };\n                return Object.freeze({\n                    headers: (status: number) => {\n                        if (row.open && Number.isInteger(status) && status >= 100 && status <= 599)\n                            row.call = Object.freeze({ ...row.call, httpStatus: status });\n                    },\n                    body: (body: string) => {\n                        if (!row.open)\n                            return;\n                        // No await may separate the receipt cut and its immutable contribution.\n                        const receipt = normalizeJudgeUsageResponse(input.transportProvider, body);\n                        row.open = false;\n                        row.call = freeze({ ...row.call, ...receipt, status: row.call.httpStatus !== null && row.call.httpStatus >= 200 && row.call.httpStatus < 300 ? \"succeeded\" : \"failed\" });\n                    },\n                    fail: (reason: \"response-unavailable\" | \"response-too-large\") => terminal(\"failed\", reason),\n                    cancel: () => terminal(\"cancelled\", \"cancelled\"),\n                    trackCleanup: (work: Promise<unknown>, deadlineAt: number) => this.trackCleanup(work, deadlineAt),\n                });\n            },\n            close: () => {\n                entry.closed = true;\n                for (const row of entry.rows)\n                    this.cancelRow(row);\n            },\n        });\n    }\n    private cancelRow(row: PendingCall): void {\n        if (!row.open)\n            return;\n        row.open = false;\n        row.call = Object.freeze({ ...row.call, status: \"cancelled\", receipt: Object.freeze({ ...emptyReceipt, reason: \"cancelled\" }) });\n    }\n    close(): void {\n        if (this.closed)\n            return;\n        this.closed = true;\n        this.signal?.removeEventListener(\"abort\", this.onAbort);\n        for (const entry of this.entries.values())\n            entry.closed = true;\n        for (const row of this.rows)\n            this.cancelRow(row);\n    }\n    async closeAndDrain(): Promise<void> {\n        this.close();\n        while (this.cleanups.size > 0)\n            await Promise.all([...this.cleanups]);\n    }\n    snapshot(): JudgeUsageAttachment {\n        if (!this.closed)\n            throw new Error(\"Judge usage must close before publication\");\n        const calls = Object.freeze(this.rows.map((row) => row.call));\n        return freeze({\n            collection: completeCollection,\n            calls,\n            priceReceipts: createJudgeCallPriceReceipts(calls, this.pricing),\n        });\n    }\n    private trackCleanup(work: Promise<unknown>, deadlineAt: number): void {\n        let timer: ReturnType<typeof setTimeout> | undefined;\n        const settled = work.then(() => true, () => false);\n        const expired = new Promise<false>((resolve) => { timer = setTimeout(() => resolve(false), Math.max(0, Math.min(1000, deadlineAt - Date.now()))); });\n        const bounded = Promise.race([settled, expired]).then((ok) => {\n            if (timer !== undefined)\n                clearTimeout(timer);\n            if (!ok && !this.cleanupIncomplete) {\n                this.cleanupIncomplete = true;\n                this.onCleanupIncomplete?.();\n            }\n        });\n        this.cleanups.add(bounded);\n        void bounded.then(() => this.cleanups.delete(bounded));\n    }\n    private canReserve(next: PendingCall): boolean {\n        const rows = [...this.rows, next];\n        const terminalCalls = rows.filter((row) => !row.open).map((row) => row.call);\n        // Receipt padding bounds canonical bytes; scalar rows additionally bound nodes,\n        // keys and depth. Price padding includes both legal 8 KiB model selectors.\n        const calls = rows.map((row) => row.open ? {\n            ...row.call, entryId: \"a\".repeat(256), provider: '\"'.repeat(256), model: '\"'.repeat(8192),\n            cost: { amount: \"1\".repeat(512), currency: \"A\".repeat(256), source: { kind: \"reported\", id: '\"'.repeat(256) } },\n            receipt: { state: \"available\", reason: \"invalid-usage\", responseDigest: \"0\".repeat(71),\n                fields: Array.from({ length: 24 }, (_, index) => ({ path: String(index).padEnd(128, \"p\"), value: null })),\n                reservedCanonicalBytes: \"x\".repeat(32 * 1024) },\n        } : row.call);\n        const priceReceipts: unknown[] = [...createJudgeCallPriceReceipts(terminalCalls, this.pricing)];\n        if (this.pricing !== undefined)\n            for (const row of rows)\n                if (row.open)\n                    priceReceipts.push({\n                        callId: row.call.callId, requestModel: row.call.requestModel,\n                        reservedCanonicalBytes: \"x\".repeat(64 * 1024),\n                        reservedNodes: Array.from({ length: 256 }, () => ({ value: null })),\n                    });\n        return Result.isSuccess(canonicalizeRecordValue({ collection: completeCollection, calls, priceReceipts }, RecordAttachmentEncodingLimits));\n    }\n}\nfunction freeze<T>(value: T): T {\n    if (value !== null && typeof value === \"object\") {\n        for (const child of Object.values(value))\n            freeze(child);\n        Object.freeze(value);\n    }\n    return value;\n}\n"]}

package/dist/o11y/judge-usage.d.cts

@@ -0,0 +1,35 @@
+import type { JudgeUsageAttachment, JudgeUsageCall } from "../record/family/judge-usage/schema.cjs";
+import type { PriceOverride } from "../runner/types.cjs";
+type TransmissionInput = Pick<JudgeUsageCall, "logicalOrdinal" | "transmissionOrdinal" | "operation" | "requestModel" | "transportProvider">;
+export interface JudgeUsageTransmission {
+    headers(status: number): void;
+    body(body: string): void;
+    fail(reason: "response-unavailable" | "response-too-large"): void;
+    cancel(): void;
+    trackCleanup(work: Promise<unknown>, deadlineAt: number): void;
+}
+export interface JudgeUsageEntry {
+    begin(input: TransmissionInput): JudgeUsageTransmission | undefined;
+    close(): void;
+}
+/** One Attempt owns admission, receipt cuts and all transport cleanup promises. */
+export declare class JudgeUsageCollector {
+    private readonly signal?;
+    private readonly onCleanupIncomplete?;
+    private readonly rows;
+    private readonly entries;
+    private readonly cleanups;
+    private closed;
+    private cleanupIncomplete;
+    private readonly pricing;
+    private readonly onAbort;
+    constructor(pricing: Readonly<Record<string, PriceOverride>> | undefined, signal?: AbortSignal | undefined, onCleanupIncomplete?: (() => void) | undefined);
+    forEntry(entryIndex: number): JudgeUsageEntry;
+    private cancelRow;
+    close(): void;
+    closeAndDrain(): Promise<void>;
+    snapshot(): JudgeUsageAttachment;
+    private trackCleanup;
+    private canReserve;
+}
+export {};

package/dist/o11y/judge-usage.d.mts

@@ -0,0 +1,35 @@
+import type { JudgeUsageAttachment, JudgeUsageCall } from "../record/family/judge-usage/schema.mjs";
+import type { PriceOverride } from "../runner/types.mjs";
+type TransmissionInput = Pick<JudgeUsageCall, "logicalOrdinal" | "transmissionOrdinal" | "operation" | "requestModel" | "transportProvider">;
+export interface JudgeUsageTransmission {
+    headers(status: number): void;
+    body(body: string): void;
+    fail(reason: "response-unavailable" | "response-too-large"): void;
+    cancel(): void;
+    trackCleanup(work: Promise<unknown>, deadlineAt: number): void;
+}
+export interface JudgeUsageEntry {
+    begin(input: TransmissionInput): JudgeUsageTransmission | undefined;
+    close(): void;
+}
+/** One Attempt owns admission, receipt cuts and all transport cleanup promises. */
+export declare class JudgeUsageCollector {
+    private readonly signal?;
+    private readonly onCleanupIncomplete?;
+    private readonly rows;
+    private readonly entries;
+    private readonly cleanups;
+    private closed;
+    private cleanupIncomplete;
+    private readonly pricing;
+    private readonly onAbort;
+    constructor(pricing: Readonly<Record<string, PriceOverride>> | undefined, signal?: AbortSignal | undefined, onCleanupIncomplete?: (() => void) | undefined);
+    forEntry(entryIndex: number): JudgeUsageEntry;
+    private cancelRow;
+    close(): void;
+    closeAndDrain(): Promise<void>;
+    snapshot(): JudgeUsageAttachment;
+    private trackCleanup;
+    private canReserve;
+}
+export {};

package/dist/o11y/judge-usage.d.ts

@@ -0,0 +1,35 @@
+import type { JudgeUsageAttachment, JudgeUsageCall } from "../record/family/judge-usage/schema.js";
+import type { PriceOverride } from "../runner/types.js";
+type TransmissionInput = Pick<JudgeUsageCall, "logicalOrdinal" | "transmissionOrdinal" | "operation" | "requestModel" | "transportProvider">;
+export interface JudgeUsageTransmission {
+    headers(status: number): void;
+    body(body: string): void;
+    fail(reason: "response-unavailable" | "response-too-large"): void;
+    cancel(): void;
+    trackCleanup(work: Promise<unknown>, deadlineAt: number): void;
+}
+export interface JudgeUsageEntry {
+    begin(input: TransmissionInput): JudgeUsageTransmission | undefined;
+    close(): void;
+}
+/** One Attempt owns admission, receipt cuts and all transport cleanup promises. */
+export declare class JudgeUsageCollector {
+    private readonly signal?;
+    private readonly onCleanupIncomplete?;
+    private readonly rows;
+    private readonly entries;
+    private readonly cleanups;
+    private closed;
+    private cleanupIncomplete;
+    private readonly pricing;
+    private readonly onAbort;
+    constructor(pricing: Readonly<Record<string, PriceOverride>> | undefined, signal?: AbortSignal | undefined, onCleanupIncomplete?: (() => void) | undefined);
+    forEntry(entryIndex: number): JudgeUsageEntry;
+    private cancelRow;
+    close(): void;
+    closeAndDrain(): Promise<void>;
+    snapshot(): JudgeUsageAttachment;
+    private trackCleanup;
+    private canReserve;
+}
+export {};

package/dist/o11y/judge-usage.js

@@ -0,0 +1,6 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./judge-usage.cjs");
+const __niceevalExport0 = __niceevalCanonical["JudgeUsageCollector"];
+export { __niceevalExport0 as JudgeUsageCollector };
+//# sourceMappingURL=judge-usage.js.map

package/dist/o11y/judge-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"judge-usage.js","sources":[],"names":[],"mappings":""}

package/dist/plugin/contracts.cjs

@@ -85,6 +85,8 @@ const SANDBOX_ONLY_HOST_FRAGMENT = Object.freeze({
     identity: Object.freeze({}),
     hostDeclared: false,
 });
+// @concord-code ne-surface-define-plugin
+// @concord-implements docs/feature/plugins/library.md
 function definePlugin(definition) {
     if (!isPlainRecord(definition))
         throw new TypeError("definePlugin requires an object.");