niceeval 0.15.1-canary.76 → 0.16.1

package/dist/record/family/judge-usage/schema.d.mts

@@ -0,0 +1,351 @@
+import { Schema } from "effect";
+import { type RecordAttachmentIssue } from "../../attachment/index.mjs";
+export declare const JudgeUsageLimits: Readonly<{
+    maximumCalls: 4000;
+    maximumModelBytes: 8192;
+    maximumReceiptBytes: 32768;
+    maximumReceiptFields: 24;
+}>;
+/** @internal Used to validate observations before retaining their response fields. */
+export declare const JudgeUsageModelSchema: Schema.String;
+/** Only these protocol facts may enter durable receipts; business text is excluded. */
+export declare const JudgeUsageReceiptPaths: readonly ["model", "provider", "usage.completion_tokens", "usage.cost", "usage.input_tokens", "usage.output_tokens", "usage.prompt_tokens", "usage.prompt_tokens_details.cache_write_tokens", "usage.prompt_tokens_details.cached_tokens", "usage.total_tokens"];
+declare const CallShapeSchema: Schema.Struct<{
+    readonly callId: Schema.String;
+    readonly entryIndex: Schema.Number;
+    readonly entryId: Schema.Codec<import("../../../index.mjs").AssertionEntryId, string, never, never>;
+    readonly logicalOrdinal: Schema.Number;
+    readonly transmissionOrdinal: Schema.Number;
+    readonly operation: Schema.Literals<readonly ["score", "classify", "extract", "batchClassify"]>;
+    readonly requestModel: Schema.String;
+    readonly transportProvider: Schema.Literals<readonly ["openai", "vercel", "openrouter", "typesafe"]>;
+    readonly provider: Schema.NullOr<Schema.String>;
+    readonly model: Schema.NullOr<Schema.String>;
+    readonly status: Schema.Literals<readonly ["succeeded", "failed", "cancelled", "unknown"]>;
+    readonly httpStatus: Schema.NullOr<Schema.Number>;
+    readonly inputTokens: Schema.NullOr<Schema.Number>;
+    readonly inputTotalTokens: Schema.NullOr<Schema.Number>;
+    readonly outputTokens: Schema.NullOr<Schema.Number>;
+    readonly cacheReadTokens: Schema.NullOr<Schema.Number>;
+    readonly cacheWriteTokens: Schema.NullOr<Schema.Number>;
+    readonly cost: Schema.NullOr<Schema.Struct<{
+        readonly amount: Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>;
+        readonly currency: Schema.Codec<import("../source-receipt/model.mjs").CurrencyCode, string, never, never>;
+        readonly source: Schema.Struct<{
+            readonly kind: Schema.Literal<"reported">;
+            readonly id: Schema.String;
+        }>;
+    }>>;
+    readonly receipt: Schema.Struct<{
+        readonly state: Schema.Literals<readonly ["available", "unavailable"]>;
+        readonly reason: Schema.NullOr<Schema.Literals<readonly ["response-unavailable", "cancelled", "response-too-large", "invalid-json", "usage-not-reported", "invalid-usage", "response-model-too-large"]>>;
+        readonly responseDigest: Schema.NullOr<Schema.String>;
+        readonly fields: Schema.$Array<Schema.Struct<{
+            readonly path: Schema.Literals<readonly ["model", "provider", "usage.completion_tokens", "usage.cost", "usage.input_tokens", "usage.output_tokens", "usage.prompt_tokens", "usage.prompt_tokens_details.cache_write_tokens", "usage.prompt_tokens_details.cached_tokens", "usage.total_tokens"]>;
+            readonly value: Schema.Union<readonly [Schema.String, Schema.Number, Schema.Null]>;
+        }>>;
+    }>;
+}>;
+export type JudgeUsageCall = Schema.Schema.Type<typeof CallShapeSchema>;
+export declare const JudgeUsageCallSchema: Schema.Struct<{
+    readonly callId: Schema.String;
+    readonly entryIndex: Schema.Number;
+    readonly entryId: Schema.Codec<import("../../../index.mjs").AssertionEntryId, string, never, never>;
+    readonly logicalOrdinal: Schema.Number;
+    readonly transmissionOrdinal: Schema.Number;
+    readonly operation: Schema.Literals<readonly ["score", "classify", "extract", "batchClassify"]>;
+    readonly requestModel: Schema.String;
+    readonly transportProvider: Schema.Literals<readonly ["openai", "vercel", "openrouter", "typesafe"]>;
+    readonly provider: Schema.NullOr<Schema.String>;
+    readonly model: Schema.NullOr<Schema.String>;
+    readonly status: Schema.Literals<readonly ["succeeded", "failed", "cancelled", "unknown"]>;
+    readonly httpStatus: Schema.NullOr<Schema.Number>;
+    readonly inputTokens: Schema.NullOr<Schema.Number>;
+    readonly inputTotalTokens: Schema.NullOr<Schema.Number>;
+    readonly outputTokens: Schema.NullOr<Schema.Number>;
+    readonly cacheReadTokens: Schema.NullOr<Schema.Number>;
+    readonly cacheWriteTokens: Schema.NullOr<Schema.Number>;
+    readonly cost: Schema.NullOr<Schema.Struct<{
+        readonly amount: Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>;
+        readonly currency: Schema.Codec<import("../source-receipt/model.mjs").CurrencyCode, string, never, never>;
+        readonly source: Schema.Struct<{
+            readonly kind: Schema.Literal<"reported">;
+            readonly id: Schema.String;
+        }>;
+    }>>;
+    readonly receipt: Schema.Struct<{
+        readonly state: Schema.Literals<readonly ["available", "unavailable"]>;
+        readonly reason: Schema.NullOr<Schema.Literals<readonly ["response-unavailable", "cancelled", "response-too-large", "invalid-json", "usage-not-reported", "invalid-usage", "response-model-too-large"]>>;
+        readonly responseDigest: Schema.NullOr<Schema.String>;
+        readonly fields: Schema.$Array<Schema.Struct<{
+            readonly path: Schema.Literals<readonly ["model", "provider", "usage.completion_tokens", "usage.cost", "usage.input_tokens", "usage.output_tokens", "usage.prompt_tokens", "usage.prompt_tokens_details.cache_write_tokens", "usage.prompt_tokens_details.cached_tokens", "usage.total_tokens"]>;
+            readonly value: Schema.Union<readonly [Schema.String, Schema.Number, Schema.Null]>;
+        }>>;
+    }>;
+}>;
+declare const PriceReceiptShapeSchema: Schema.Struct<{
+    readonly kind: Schema.Literal<"judge-call-price-estimate">;
+    readonly callId: Schema.String;
+    readonly state: Schema.Literals<readonly ["complete", "partial"]>;
+    readonly amount: Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>;
+    readonly currency: Schema.Literal<"USD">;
+    readonly source: Schema.Struct<{
+        readonly kind: Schema.Literal<"estimated">;
+        readonly id: Schema.String;
+    }>;
+    readonly pricing: Schema.Struct<{
+        readonly basis: Schema.Literal<"catalog-reference">;
+        readonly currency: Schema.Literal<"USD">;
+        readonly source: Schema.Struct<{
+            readonly kind: Schema.Literal<"configured-profile">;
+            readonly id: Schema.String;
+            readonly asOf: Schema.NullOr<Schema.Number>;
+            readonly profileDigest: Schema.String;
+        }>;
+        readonly requestModel: Schema.String;
+        readonly selector: Schema.String;
+        readonly match: Schema.Literals<readonly ["exact", "provider-wildcard"]>;
+        readonly ratesPerMTok: Schema.Struct<{
+            readonly input: Schema.NullOr<Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>>;
+            readonly output: Schema.NullOr<Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>>;
+            readonly cacheRead: Schema.NullOr<Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>>;
+            readonly cacheWrite: Schema.NullOr<Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>>;
+        }>;
+    }>;
+    readonly charges: Schema.NonEmptyArray<Schema.Struct<{
+        readonly bucket: Schema.Literals<readonly ["input", "output", "cache-read", "cache-write"]>;
+        readonly tokens: Schema.Number;
+        readonly ratePerMTok: Schema.NullOr<Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>>;
+        readonly amount: Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>;
+    }>>;
+    readonly missing: Schema.$Array<Schema.Struct<{
+        readonly bucket: Schema.Literals<readonly ["input", "output", "cache-read", "cache-write"]>;
+        readonly reason: Schema.Literals<readonly ["tokens-unknown", "rate-unknown"]>;
+    }>>;
+}>;
+export type JudgePriceReceipt = Schema.Schema.Type<typeof PriceReceiptShapeSchema>;
+export declare const JudgePriceReceiptSchema: Schema.Struct<{
+    readonly kind: Schema.Literal<"judge-call-price-estimate">;
+    readonly callId: Schema.String;
+    readonly state: Schema.Literals<readonly ["complete", "partial"]>;
+    readonly amount: Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>;
+    readonly currency: Schema.Literal<"USD">;
+    readonly source: Schema.Struct<{
+        readonly kind: Schema.Literal<"estimated">;
+        readonly id: Schema.String;
+    }>;
+    readonly pricing: Schema.Struct<{
+        readonly basis: Schema.Literal<"catalog-reference">;
+        readonly currency: Schema.Literal<"USD">;
+        readonly source: Schema.Struct<{
+            readonly kind: Schema.Literal<"configured-profile">;
+            readonly id: Schema.String;
+            readonly asOf: Schema.NullOr<Schema.Number>;
+            readonly profileDigest: Schema.String;
+        }>;
+        readonly requestModel: Schema.String;
+        readonly selector: Schema.String;
+        readonly match: Schema.Literals<readonly ["exact", "provider-wildcard"]>;
+        readonly ratesPerMTok: Schema.Struct<{
+            readonly input: Schema.NullOr<Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>>;
+            readonly output: Schema.NullOr<Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>>;
+            readonly cacheRead: Schema.NullOr<Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>>;
+            readonly cacheWrite: Schema.NullOr<Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>>;
+        }>;
+    }>;
+    readonly charges: Schema.NonEmptyArray<Schema.Struct<{
+        readonly bucket: Schema.Literals<readonly ["input", "output", "cache-read", "cache-write"]>;
+        readonly tokens: Schema.Number;
+        readonly ratePerMTok: Schema.NullOr<Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>>;
+        readonly amount: Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>;
+    }>>;
+    readonly missing: Schema.$Array<Schema.Struct<{
+        readonly bucket: Schema.Literals<readonly ["input", "output", "cache-read", "cache-write"]>;
+        readonly reason: Schema.Literals<readonly ["tokens-unknown", "rate-unknown"]>;
+    }>>;
+}>;
+declare const AttachmentSchema: Schema.Struct<{
+    readonly collection: Schema.Union<readonly [Schema.Struct<{
+        readonly state: Schema.Literal<"complete">;
+        readonly limitations: Schema.Tuple<readonly []>;
+    }>, Schema.Struct<{
+        readonly state: Schema.Literal<"partial">;
+        readonly limitations: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
+            readonly code: Schema.Literals<readonly ["capture-failed", "capture-interrupted"]>;
+            readonly stage: Schema.String;
+        }>, Schema.Struct<{
+            readonly code: Schema.Literals<readonly ["collection-cap-reached", "unsupported-input"]>;
+            readonly omittedAtLeast: Schema.Number;
+        }>]>>;
+    }>]>;
+    readonly calls: Schema.$Array<Schema.Struct<{
+        readonly callId: Schema.String;
+        readonly entryIndex: Schema.Number;
+        readonly entryId: Schema.Codec<import("../../../index.mjs").AssertionEntryId, string, never, never>;
+        readonly logicalOrdinal: Schema.Number;
+        readonly transmissionOrdinal: Schema.Number;
+        readonly operation: Schema.Literals<readonly ["score", "classify", "extract", "batchClassify"]>;
+        readonly requestModel: Schema.String;
+        readonly transportProvider: Schema.Literals<readonly ["openai", "vercel", "openrouter", "typesafe"]>;
+        readonly provider: Schema.NullOr<Schema.String>;
+        readonly model: Schema.NullOr<Schema.String>;
+        readonly status: Schema.Literals<readonly ["succeeded", "failed", "cancelled", "unknown"]>;
+        readonly httpStatus: Schema.NullOr<Schema.Number>;
+        readonly inputTokens: Schema.NullOr<Schema.Number>;
+        readonly inputTotalTokens: Schema.NullOr<Schema.Number>;
+        readonly outputTokens: Schema.NullOr<Schema.Number>;
+        readonly cacheReadTokens: Schema.NullOr<Schema.Number>;
+        readonly cacheWriteTokens: Schema.NullOr<Schema.Number>;
+        readonly cost: Schema.NullOr<Schema.Struct<{
+            readonly amount: Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>;
+            readonly currency: Schema.Codec<import("../source-receipt/model.mjs").CurrencyCode, string, never, never>;
+            readonly source: Schema.Struct<{
+                readonly kind: Schema.Literal<"reported">;
+                readonly id: Schema.String;
+            }>;
+        }>>;
+        readonly receipt: Schema.Struct<{
+            readonly state: Schema.Literals<readonly ["available", "unavailable"]>;
+            readonly reason: Schema.NullOr<Schema.Literals<readonly ["response-unavailable", "cancelled", "response-too-large", "invalid-json", "usage-not-reported", "invalid-usage", "response-model-too-large"]>>;
+            readonly responseDigest: Schema.NullOr<Schema.String>;
+            readonly fields: Schema.$Array<Schema.Struct<{
+                readonly path: Schema.Literals<readonly ["model", "provider", "usage.completion_tokens", "usage.cost", "usage.input_tokens", "usage.output_tokens", "usage.prompt_tokens", "usage.prompt_tokens_details.cache_write_tokens", "usage.prompt_tokens_details.cached_tokens", "usage.total_tokens"]>;
+                readonly value: Schema.Union<readonly [Schema.String, Schema.Number, Schema.Null]>;
+            }>>;
+        }>;
+    }>>;
+    readonly priceReceipts: Schema.$Array<Schema.Struct<{
+        readonly kind: Schema.Literal<"judge-call-price-estimate">;
+        readonly callId: Schema.String;
+        readonly state: Schema.Literals<readonly ["complete", "partial"]>;
+        readonly amount: Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>;
+        readonly currency: Schema.Literal<"USD">;
+        readonly source: Schema.Struct<{
+            readonly kind: Schema.Literal<"estimated">;
+            readonly id: Schema.String;
+        }>;
+        readonly pricing: Schema.Struct<{
+            readonly basis: Schema.Literal<"catalog-reference">;
+            readonly currency: Schema.Literal<"USD">;
+            readonly source: Schema.Struct<{
+                readonly kind: Schema.Literal<"configured-profile">;
+                readonly id: Schema.String;
+                readonly asOf: Schema.NullOr<Schema.Number>;
+                readonly profileDigest: Schema.String;
+            }>;
+            readonly requestModel: Schema.String;
+            readonly selector: Schema.String;
+            readonly match: Schema.Literals<readonly ["exact", "provider-wildcard"]>;
+            readonly ratesPerMTok: Schema.Struct<{
+                readonly input: Schema.NullOr<Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>>;
+                readonly output: Schema.NullOr<Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>>;
+                readonly cacheRead: Schema.NullOr<Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>>;
+                readonly cacheWrite: Schema.NullOr<Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>>;
+            }>;
+        }>;
+        readonly charges: Schema.NonEmptyArray<Schema.Struct<{
+            readonly bucket: Schema.Literals<readonly ["input", "output", "cache-read", "cache-write"]>;
+            readonly tokens: Schema.Number;
+            readonly ratePerMTok: Schema.NullOr<Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>>;
+            readonly amount: Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>;
+        }>>;
+        readonly missing: Schema.$Array<Schema.Struct<{
+            readonly bucket: Schema.Literals<readonly ["input", "output", "cache-read", "cache-write"]>;
+            readonly reason: Schema.Literals<readonly ["tokens-unknown", "rate-unknown"]>;
+        }>>;
+    }>>;
+}>;
+export type JudgeUsageAttachment = Schema.Schema.Type<typeof AttachmentSchema>;
+export declare const JudgeUsageAttachmentSchema: Schema.Struct<{
+    readonly collection: Schema.Union<readonly [Schema.Struct<{
+        readonly state: Schema.Literal<"complete">;
+        readonly limitations: Schema.Tuple<readonly []>;
+    }>, Schema.Struct<{
+        readonly state: Schema.Literal<"partial">;
+        readonly limitations: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
+            readonly code: Schema.Literals<readonly ["capture-failed", "capture-interrupted"]>;
+            readonly stage: Schema.String;
+        }>, Schema.Struct<{
+            readonly code: Schema.Literals<readonly ["collection-cap-reached", "unsupported-input"]>;
+            readonly omittedAtLeast: Schema.Number;
+        }>]>>;
+    }>]>;
+    readonly calls: Schema.$Array<Schema.Struct<{
+        readonly callId: Schema.String;
+        readonly entryIndex: Schema.Number;
+        readonly entryId: Schema.Codec<import("../../../index.mjs").AssertionEntryId, string, never, never>;
+        readonly logicalOrdinal: Schema.Number;
+        readonly transmissionOrdinal: Schema.Number;
+        readonly operation: Schema.Literals<readonly ["score", "classify", "extract", "batchClassify"]>;
+        readonly requestModel: Schema.String;
+        readonly transportProvider: Schema.Literals<readonly ["openai", "vercel", "openrouter", "typesafe"]>;
+        readonly provider: Schema.NullOr<Schema.String>;
+        readonly model: Schema.NullOr<Schema.String>;
+        readonly status: Schema.Literals<readonly ["succeeded", "failed", "cancelled", "unknown"]>;
+        readonly httpStatus: Schema.NullOr<Schema.Number>;
+        readonly inputTokens: Schema.NullOr<Schema.Number>;
+        readonly inputTotalTokens: Schema.NullOr<Schema.Number>;
+        readonly outputTokens: Schema.NullOr<Schema.Number>;
+        readonly cacheReadTokens: Schema.NullOr<Schema.Number>;
+        readonly cacheWriteTokens: Schema.NullOr<Schema.Number>;
+        readonly cost: Schema.NullOr<Schema.Struct<{
+            readonly amount: Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>;
+            readonly currency: Schema.Codec<import("../source-receipt/model.mjs").CurrencyCode, string, never, never>;
+            readonly source: Schema.Struct<{
+                readonly kind: Schema.Literal<"reported">;
+                readonly id: Schema.String;
+            }>;
+        }>>;
+        readonly receipt: Schema.Struct<{
+            readonly state: Schema.Literals<readonly ["available", "unavailable"]>;
+            readonly reason: Schema.NullOr<Schema.Literals<readonly ["response-unavailable", "cancelled", "response-too-large", "invalid-json", "usage-not-reported", "invalid-usage", "response-model-too-large"]>>;
+            readonly responseDigest: Schema.NullOr<Schema.String>;
+            readonly fields: Schema.$Array<Schema.Struct<{
+                readonly path: Schema.Literals<readonly ["model", "provider", "usage.completion_tokens", "usage.cost", "usage.input_tokens", "usage.output_tokens", "usage.prompt_tokens", "usage.prompt_tokens_details.cache_write_tokens", "usage.prompt_tokens_details.cached_tokens", "usage.total_tokens"]>;
+                readonly value: Schema.Union<readonly [Schema.String, Schema.Number, Schema.Null]>;
+            }>>;
+        }>;
+    }>>;
+    readonly priceReceipts: Schema.$Array<Schema.Struct<{
+        readonly kind: Schema.Literal<"judge-call-price-estimate">;
+        readonly callId: Schema.String;
+        readonly state: Schema.Literals<readonly ["complete", "partial"]>;
+        readonly amount: Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>;
+        readonly currency: Schema.Literal<"USD">;
+        readonly source: Schema.Struct<{
+            readonly kind: Schema.Literal<"estimated">;
+            readonly id: Schema.String;
+        }>;
+        readonly pricing: Schema.Struct<{
+            readonly basis: Schema.Literal<"catalog-reference">;
+            readonly currency: Schema.Literal<"USD">;
+            readonly source: Schema.Struct<{
+                readonly kind: Schema.Literal<"configured-profile">;
+                readonly id: Schema.String;
+                readonly asOf: Schema.NullOr<Schema.Number>;
+                readonly profileDigest: Schema.String;
+            }>;
+            readonly requestModel: Schema.String;
+            readonly selector: Schema.String;
+            readonly match: Schema.Literals<readonly ["exact", "provider-wildcard"]>;
+            readonly ratesPerMTok: Schema.Struct<{
+                readonly input: Schema.NullOr<Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>>;
+                readonly output: Schema.NullOr<Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>>;
+                readonly cacheRead: Schema.NullOr<Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>>;
+                readonly cacheWrite: Schema.NullOr<Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>>;
+            }>;
+        }>;
+        readonly charges: Schema.NonEmptyArray<Schema.Struct<{
+            readonly bucket: Schema.Literals<readonly ["input", "output", "cache-read", "cache-write"]>;
+            readonly tokens: Schema.Number;
+            readonly ratePerMTok: Schema.NullOr<Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>>;
+            readonly amount: Schema.Codec<import("../source-receipt/model.mjs").CanonicalDecimal, string, never, never>;
+        }>>;
+        readonly missing: Schema.$Array<Schema.Struct<{
+            readonly bucket: Schema.Literals<readonly ["input", "output", "cache-read", "cache-write"]>;
+            readonly reason: Schema.Literals<readonly ["tokens-unknown", "rate-unknown"]>;
+        }>>;
+    }>>;
+}>;
+export declare function validateJudgeUsageAttachment(value: JudgeUsageAttachment): readonly RecordAttachmentIssue[];
+export {};