@ls-stack/agent-eval 0.30.0 → 0.32.0

package/dist/index.d.mts

@@ -754,6 +754,7 @@ type ResolvedLlmCallsConfig$1 = {
   derivedAttributes: ResolvedCallDerivedAttribute$1[];
   metrics: ResolvedLlmCallMetric$1[];
   pricing: ResolvedLlmCallPricing$1[];
+  costCurrencies: ResolvedLlmCallCostCurrency$1[];
 };
 /** Resolved API-calls config sent to the UI with all defaults applied. */
 type ResolvedApiCallsConfig$1 = {
@@ -801,6 +802,13 @@ type ResolvedLlmCallPricing$1 = {
   cacheCreationInputUsdPerMillion?: number;
   cacheCreationInput1hUsdPerMillion?: number;
   reasoningUsdPerMillion?: number;
+};
+/** Fully-resolved extra currency used by the LLM calls tab. */
+type ResolvedLlmCallCostCurrency$1 = {
+  code: string;
+  label?: string;
+  usdToCurrencyRate: number;
+  numberFormat?: NumberDisplayOptions$2;
 }; //#endregion
 //#region ../shared/src/schemas/cache.d.ts
 /** Summary of a single persisted cache entry, used by list/delete endpoints. */
@@ -3168,8 +3176,8 @@ declare const traceSpanSchema: z$1.ZodObject<{
   status: z$1.ZodEnum<{
     error: "error";
     running: "running";
-    cancelled: "cancelled";
     ok: "ok";
+    cancelled: "cancelled";
   }>;
   attributes: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodUnknown>>;
   error: z$1.ZodOptional<z$1.ZodObject<{
@@ -3212,9 +3220,9 @@ type EvalFreshnessStatus = z$1.infer<typeof evalFreshnessStatusSchema>;
 declare const evalStatAggregateSchema: z$1.ZodEnum<{
   last: "last";
   sum: "sum";
+  avg: "avg";
   min: "min";
   max: "max";
-  avg: "avg";
 }>;
 /** Reducer used to collapse a column's per-case values into a single stat. */
 type EvalStatAggregate = z$1.infer<typeof evalStatAggregateSchema>;
@@ -3240,9 +3248,9 @@ declare const evalStatItemSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
   aggregate: z$1.ZodEnum<{
     last: "last";
     sum: "sum";
+    avg: "avg";
     min: "min";
     max: "max";
-    avg: "avg";
   }>;
   format: z$1.ZodOptional<z$1.ZodEnum<{
     number: "number";
@@ -3282,9 +3290,9 @@ declare const evalStatsConfigSchema: z$1.ZodArray<z$1.ZodDiscriminatedUnion<[z$1
   aggregate: z$1.ZodEnum<{
     last: "last";
     sum: "sum";
+    avg: "avg";
     min: "min";
     max: "max";
-    avg: "avg";
   }>;
   format: z$1.ZodOptional<z$1.ZodEnum<{
     number: "number";
@@ -3383,9 +3391,9 @@ declare const evalSummarySchema: z$1.ZodObject<{
     aggregate: z$1.ZodEnum<{
       last: "last";
       sum: "sum";
+      avg: "avg";
       min: "min";
       max: "max";
-      avg: "avg";
     }>;
     format: z$1.ZodOptional<z$1.ZodEnum<{
       number: "number";
@@ -3416,8 +3424,8 @@ declare const evalSummarySchema: z$1.ZodObject<{
     metrics: z$1.ZodArray<z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
       source: z$1.ZodLiteral<"builtin">;
       metric: z$1.ZodEnum<{
-        durationMs: "durationMs";
         passRate: "passRate";
+        durationMs: "durationMs";
       }>;
       label: z$1.ZodOptional<z$1.ZodString>;
       color: z$1.ZodOptional<z$1.ZodEnum<{
@@ -3437,9 +3445,9 @@ declare const evalSummarySchema: z$1.ZodObject<{
       key: z$1.ZodString;
       aggregate: z$1.ZodEnum<{
         sum: "sum";
+        avg: "avg";
         min: "min";
         max: "max";
-        avg: "avg";
         latest: "latest";
         passThresholdRate: "passThresholdRate";
       }>;
@@ -3470,8 +3478,8 @@ declare const evalSummarySchema: z$1.ZodObject<{
     tooltipExtras: z$1.ZodOptional<z$1.ZodArray<z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
       source: z$1.ZodLiteral<"builtin">;
       metric: z$1.ZodEnum<{
-        durationMs: "durationMs";
         passRate: "passRate";
+        durationMs: "durationMs";
       }>;
       label: z$1.ZodOptional<z$1.ZodString>;
     }, z$1.core.$strip>, z$1.ZodObject<{
@@ -3479,9 +3487,9 @@ declare const evalSummarySchema: z$1.ZodObject<{
       key: z$1.ZodString;
       aggregate: z$1.ZodEnum<{
         sum: "sum";
+        avg: "avg";
         min: "min";
         max: "max";
-        avg: "avg";
         latest: "latest";
         passThresholdRate: "passThresholdRate";
       }>;
@@ -3577,11 +3585,11 @@ declare const caseRowSchema: z$1.ZodObject<{
   evalId: z$1.ZodString;
   status: z$1.ZodEnum<{
     error: "error";
-    pending: "pending";
     running: "running";
     cancelled: "cancelled";
     pass: "pass";
     fail: "fail";
+    pending: "pending";
   }>;
   durationMs: z$1.ZodNullable<z$1.ZodNumber>;
   costUsd: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodNumber>>;
@@ -3673,8 +3681,8 @@ declare const scoreTraceSchema: z$1.ZodObject<{
     status: z$1.ZodEnum<{
       error: "error";
       running: "running";
-      cancelled: "cancelled";
       ok: "ok";
+      cancelled: "cancelled";
     }>;
     attributes: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodUnknown>>;
     error: z$1.ZodOptional<z$1.ZodObject<{
@@ -3741,11 +3749,11 @@ declare const caseDetailSchema: z$1.ZodObject<{
   evalId: z$1.ZodString;
   status: z$1.ZodEnum<{
     error: "error";
-    pending: "pending";
     running: "running";
     cancelled: "cancelled";
     pass: "pass";
     fail: "fail";
+    pending: "pending";
   }>;
   input: z$1.ZodUnknown;
   trace: z$1.ZodArray<z$1.ZodObject<{
@@ -3759,8 +3767,8 @@ declare const caseDetailSchema: z$1.ZodObject<{
     status: z$1.ZodEnum<{
       error: "error";
       running: "running";
-      cancelled: "cancelled";
       ok: "ok";
+      cancelled: "cancelled";
     }>;
     attributes: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodUnknown>>;
     error: z$1.ZodOptional<z$1.ZodObject<{
@@ -3828,8 +3836,8 @@ declare const caseDetailSchema: z$1.ZodObject<{
       status: z$1.ZodEnum<{
         error: "error";
         running: "running";
-        cancelled: "cancelled";
         ok: "ok";
+        cancelled: "cancelled";
       }>;
       attributes: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodUnknown>>;
       error: z$1.ZodOptional<z$1.ZodObject<{
@@ -3941,10 +3949,10 @@ declare const caseDetailSchema: z$1.ZodObject<{
     namespace: z$1.ZodString;
     key: z$1.ZodString;
     status: z$1.ZodEnum<{
-      bypass: "bypass";
-      refresh: "refresh";
       hit: "hit";
       miss: "miss";
+      refresh: "refresh";
+      bypass: "bypass";
     }>;
     read: z$1.ZodOptional<z$1.ZodBoolean>;
     stored: z$1.ZodOptional<z$1.ZodBoolean>;
@@ -4005,8 +4013,8 @@ type EvalChartType = z$1.infer<typeof evalChartTypeSchema>;
  * than from a per-case column.
  */
 declare const evalChartBuiltinMetricSchema: z$1.ZodEnum<{
-  durationMs: "durationMs";
   passRate: "passRate";
+  durationMs: "durationMs";
 }>;
 /**
  * Run-level metric sourced from the aggregated `RunSummary` for a run, rather
@@ -4016,9 +4024,9 @@ type EvalChartBuiltinMetric = z$1.infer<typeof evalChartBuiltinMetricSchema>;
 /** Reducer applied to a numeric column across all cases of a single run. */
 declare const evalChartAggregateSchema: z$1.ZodEnum<{
   sum: "sum";
+  avg: "avg";
   min: "min";
   max: "max";
-  avg: "avg";
   latest: "latest";
   passThresholdRate: "passThresholdRate";
 }>;
@@ -4053,8 +4061,8 @@ type EvalChartAxis = z$1.infer<typeof evalChartAxisSchema>;
 declare const evalChartMetricSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
   source: z$1.ZodLiteral<"builtin">;
   metric: z$1.ZodEnum<{
-    durationMs: "durationMs";
     passRate: "passRate";
+    durationMs: "durationMs";
   }>;
   label: z$1.ZodOptional<z$1.ZodString>;
   color: z$1.ZodOptional<z$1.ZodEnum<{
@@ -4074,9 +4082,9 @@ declare const evalChartMetricSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
   key: z$1.ZodString;
   aggregate: z$1.ZodEnum<{
     sum: "sum";
+    avg: "avg";
     min: "min";
     max: "max";
-    avg: "avg";
     latest: "latest";
     passThresholdRate: "passThresholdRate";
   }>;
@@ -4100,8 +4108,8 @@ type EvalChartMetric = z$1.infer<typeof evalChartMetricSchema>;
 declare const evalChartTooltipExtraSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
   source: z$1.ZodLiteral<"builtin">;
   metric: z$1.ZodEnum<{
-    durationMs: "durationMs";
     passRate: "passRate";
+    durationMs: "durationMs";
   }>;
   label: z$1.ZodOptional<z$1.ZodString>;
 }, z$1.core.$strip>, z$1.ZodObject<{
@@ -4109,9 +4117,9 @@ declare const evalChartTooltipExtraSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObj
   key: z$1.ZodString;
   aggregate: z$1.ZodEnum<{
     sum: "sum";
+    avg: "avg";
     min: "min";
     max: "max";
-    avg: "avg";
     latest: "latest";
     passThresholdRate: "passThresholdRate";
   }>;
@@ -4136,8 +4144,8 @@ declare const evalChartConfigSchema: z$1.ZodObject<{
   metrics: z$1.ZodArray<z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
     source: z$1.ZodLiteral<"builtin">;
     metric: z$1.ZodEnum<{
-      durationMs: "durationMs";
       passRate: "passRate";
+      durationMs: "durationMs";
     }>;
     label: z$1.ZodOptional<z$1.ZodString>;
     color: z$1.ZodOptional<z$1.ZodEnum<{
@@ -4157,9 +4165,9 @@ declare const evalChartConfigSchema: z$1.ZodObject<{
     key: z$1.ZodString;
     aggregate: z$1.ZodEnum<{
       sum: "sum";
+      avg: "avg";
       min: "min";
       max: "max";
-      avg: "avg";
       latest: "latest";
       passThresholdRate: "passThresholdRate";
     }>;
@@ -4190,8 +4198,8 @@ declare const evalChartConfigSchema: z$1.ZodObject<{
   tooltipExtras: z$1.ZodOptional<z$1.ZodArray<z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
     source: z$1.ZodLiteral<"builtin">;
     metric: z$1.ZodEnum<{
-      durationMs: "durationMs";
       passRate: "passRate";
+      durationMs: "durationMs";
     }>;
     label: z$1.ZodOptional<z$1.ZodString>;
   }, z$1.core.$strip>, z$1.ZodObject<{
@@ -4199,9 +4207,9 @@ declare const evalChartConfigSchema: z$1.ZodObject<{
     key: z$1.ZodString;
     aggregate: z$1.ZodEnum<{
       sum: "sum";
+      avg: "avg";
       min: "min";
       max: "max";
-      avg: "avg";
       latest: "latest";
       passThresholdRate: "passThresholdRate";
     }>;
@@ -4226,8 +4234,8 @@ declare const evalChartsConfigSchema: z$1.ZodArray<z$1.ZodObject<{
   metrics: z$1.ZodArray<z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
     source: z$1.ZodLiteral<"builtin">;
     metric: z$1.ZodEnum<{
-      durationMs: "durationMs";
       passRate: "passRate";
+      durationMs: "durationMs";
     }>;
     label: z$1.ZodOptional<z$1.ZodString>;
     color: z$1.ZodOptional<z$1.ZodEnum<{
@@ -4247,9 +4255,9 @@ declare const evalChartsConfigSchema: z$1.ZodArray<z$1.ZodObject<{
     key: z$1.ZodString;
     aggregate: z$1.ZodEnum<{
       sum: "sum";
+      avg: "avg";
       min: "min";
       max: "max";
-      avg: "avg";
       latest: "latest";
       passThresholdRate: "passThresholdRate";
     }>;
@@ -4280,8 +4288,8 @@ declare const evalChartsConfigSchema: z$1.ZodArray<z$1.ZodObject<{
   tooltipExtras: z$1.ZodOptional<z$1.ZodArray<z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
     source: z$1.ZodLiteral<"builtin">;
     metric: z$1.ZodEnum<{
-      durationMs: "durationMs";
       passRate: "passRate";
+      durationMs: "durationMs";
     }>;
     label: z$1.ZodOptional<z$1.ZodString>;
   }, z$1.core.$strip>, z$1.ZodObject<{
@@ -4289,9 +4297,9 @@ declare const evalChartsConfigSchema: z$1.ZodArray<z$1.ZodObject<{
     key: z$1.ZodString;
     aggregate: z$1.ZodEnum<{
       sum: "sum";
+      avg: "avg";
       min: "min";
       max: "max";
-      avg: "avg";
       latest: "latest";
       passThresholdRate: "passThresholdRate";
     }>;
@@ -4307,10 +4315,10 @@ declare const runManifestSchema: z$1.ZodObject<{
   shortId: z$1.ZodString;
   status: z$1.ZodEnum<{
     error: "error";
-    pending: "pending";
     running: "running";
-    completed: "completed";
     cancelled: "cancelled";
+    pending: "pending";
+    completed: "completed";
   }>;
   startedAt: z$1.ZodString;
   endedAt: z$1.ZodNullable<z$1.ZodString>;
@@ -4333,9 +4341,9 @@ declare const runManifestSchema: z$1.ZodObject<{
     median: "median";
   }>>>;
   cacheMode: z$1.ZodOptional<z$1.ZodEnum<{
-    use: "use";
-    bypass: "bypass";
     refresh: "refresh";
+    bypass: "bypass";
+    use: "use";
   }>>;
 }, z$1.core.$strip>;
 /** Persisted lifecycle metadata for a single eval run. */
@@ -4345,10 +4353,10 @@ declare const runSummarySchema: z$1.ZodObject<{
   runId: z$1.ZodString;
   status: z$1.ZodEnum<{
     error: "error";
-    pending: "pending";
     running: "running";
-    completed: "completed";
     cancelled: "cancelled";
+    pending: "pending";
+    completed: "completed";
   }>;
   totalCases: z$1.ZodNumber;
   passedCases: z$1.ZodNumber;
@@ -4458,8 +4466,8 @@ declare const trialSelectionModeSchema: z$1.ZodEnum<{
 type TrialSelectionMode = z$1.infer<typeof trialSelectionModeSchema>;
 /** Built-in eval-level output/column keys. */
 declare const defaultConfigKeySchema: z$1.ZodEnum<{
-  apiCalls: "apiCalls";
   costUsd: "costUsd";
+  apiCalls: "apiCalls";
   llmTurns: "llmTurns";
   inputTokens: "inputTokens";
   outputTokens: "outputTokens";
@@ -4472,8 +4480,8 @@ declare const defaultConfigKeySchema: z$1.ZodEnum<{
 /** Built-in eval-level output/column key. */
 /** Removal config for built-in eval-level outputs and UI metadata. */
 declare const removeDefaultConfigSchema: z$1.ZodUnion<readonly [z$1.ZodLiteral<true>, z$1.ZodArray<z$1.ZodEnum<{
-  apiCalls: "apiCalls";
   costUsd: "costUsd";
+  apiCalls: "apiCalls";
   llmTurns: "llmTurns";
   inputTokens: "inputTokens";
   outputTokens: "outputTokens";
@@ -4725,6 +4733,18 @@ declare const llmCallPricingSchema: z$1.ZodObject<{
 type LlmCallPricing = z$1.infer<typeof llmCallPricingSchema>;
 /** Model-keyed pricing registry authored in `agent-evals.config.ts`. */
 type LlmCallPricingRegistry = Record<string, LlmCallPricing>;
+/**
+ * Schema for extra currencies displayed in the LLM calls breakdown table.
+ * Costs are still derived in USD, then multiplied by `usdToCurrencyRate`.
+ */
+declare const llmCallCostCurrencySchema: z$1.ZodObject<{
+  code: z$1.ZodString;
+  label: z$1.ZodOptional<z$1.ZodString>;
+  usdToCurrencyRate: z$1.ZodNumber;
+  numberFormat: z$1.ZodOptional<z$1.ZodType<NumberDisplayOptions, unknown, z$1.core.$ZodTypeInternals<NumberDisplayOptions, unknown>>>;
+}, z$1.core.$strip>;
+/** Extra LLM-call cost currency authored in `agent-evals.config.ts`. */
+type LlmCallCostCurrency = z$1.infer<typeof llmCallCostCurrencySchema>;
 /** Schema for the global LLM calls config block in `agent-evals.config.ts`. */
 declare const llmCallsConfigSchema: z$1.ZodObject<{
   kinds: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
@@ -4763,6 +4783,12 @@ declare const llmCallsConfigSchema: z$1.ZodObject<{
       reasoningUsdPerMillion: z$1.ZodOptional<z$1.ZodNumber>;
     }, z$1.core.$strip>>>;
   }, z$1.core.$strip>>>;
+  costCurrencies: z$1.ZodOptional<z$1.ZodArray<z$1.ZodObject<{
+    code: z$1.ZodString;
+    label: z$1.ZodOptional<z$1.ZodString>;
+    usdToCurrencyRate: z$1.ZodNumber;
+    numberFormat: z$1.ZodOptional<z$1.ZodType<NumberDisplayOptions, unknown, z$1.core.$ZodTypeInternals<NumberDisplayOptions, unknown>>>;
+  }, z$1.core.$strip>>>;
   metrics: z$1.ZodOptional<z$1.ZodArray<z$1.ZodObject<{
     label: z$1.ZodString;
     tooltip: z$1.ZodOptional<z$1.ZodString>;
@@ -4848,6 +4874,7 @@ type ResolvedLlmCallsConfig = {
   derivedAttributes: ResolvedCallDerivedAttribute[];
   metrics: ResolvedLlmCallMetric[];
   pricing: ResolvedLlmCallPricing[];
+  costCurrencies: ResolvedLlmCallCostCurrency[];
 };
 /** Resolved API-calls config sent to the UI with all defaults applied. */
 type ResolvedApiCallsConfig = {
@@ -4896,6 +4923,13 @@ type ResolvedLlmCallPricing = {
   cacheCreationInput1hUsdPerMillion?: number;
   reasoningUsdPerMillion?: number;
 };
+/** Fully-resolved extra currency used by the LLM calls tab. */
+type ResolvedLlmCallCostCurrency = {
+  code: string;
+  label?: string;
+  usdToCurrencyRate: number;
+  numberFormat?: NumberDisplayOptions;
+};
 /** Default LLM-calls config the UI uses before the workspace fetch resolves. */
 declare const DEFAULT_LLM_CALLS_CONFIG: ResolvedLlmCallsConfig;
 /** Default API-calls config the UI uses before the workspace fetch resolves. */
@@ -4911,6 +4945,8 @@ declare const DEFAULT_API_CALLS_CONFIG: ResolvedApiCallsConfig;
  * - Missing `metrics[].placements` defaults to `['body']`.
  * - Missing `pricing` defaults to an empty registry; built-in costs are only
  *   derived from configured model-keyed pricing and token counts.
+ * - Missing `costCurrencies` defaults to an empty list; extra currencies only
+ *   affect the expanded LLM calls breakdown table.
  */
 declare function resolveLlmCallsConfig(input: LlmCallsConfigInput | undefined): ResolvedLlmCallsConfig;
 /**
@@ -5009,6 +5045,9 @@ type AgentEvalsConfig = {
    *       outputUsdPerMillion: 0.6,
    *     },
    *   },
+   *   costCurrencies: [
+   *     { code: 'BRL', usdToCurrencyRate: 5.7, numberFormat: { prefix: 'R$ ' } },
+   *   ],
    * }
    * ```
    */
@@ -5137,9 +5176,9 @@ declare const agentEvalsConfigSchema: z$1.ZodObject<{
     aggregate: z$1.ZodEnum<{
       last: "last";
       sum: "sum";
+      avg: "avg";
       min: "min";
       max: "max";
-      avg: "avg";
     }>;
     format: z$1.ZodOptional<z$1.ZodEnum<{
       number: "number";
@@ -5195,6 +5234,12 @@ declare const agentEvalsConfigSchema: z$1.ZodObject<{
         reasoningUsdPerMillion: z$1.ZodOptional<z$1.ZodNumber>;
       }, z$1.core.$strip>>>;
     }, z$1.core.$strip>>>;
+    costCurrencies: z$1.ZodOptional<z$1.ZodArray<z$1.ZodObject<{
+      code: z$1.ZodString;
+      label: z$1.ZodOptional<z$1.ZodString>;
+      usdToCurrencyRate: z$1.ZodNumber;
+      numberFormat: z$1.ZodOptional<z$1.ZodType<NumberDisplayOptions, unknown, z$1.core.$ZodTypeInternals<NumberDisplayOptions, unknown>>>;
+    }, z$1.core.$strip>>>;
     metrics: z$1.ZodOptional<z$1.ZodArray<z$1.ZodObject<{
       label: z$1.ZodString;
       tooltip: z$1.ZodOptional<z$1.ZodString>;
@@ -5214,8 +5259,8 @@ declare const agentEvalsConfigSchema: z$1.ZodObject<{
     }, z$1.core.$strip>>>;
   }, z$1.core.$strip>>;
   removeDefaultConfig: z$1.ZodOptional<z$1.ZodUnion<readonly [z$1.ZodLiteral<true>, z$1.ZodArray<z$1.ZodEnum<{
-    apiCalls: "apiCalls";
     costUsd: "costUsd";
+    apiCalls: "apiCalls";
     llmTurns: "llmTurns";
     inputTokens: "inputTokens";
     outputTokens: "outputTokens";
@@ -5326,6 +5371,84 @@ type LlmCallEntry = {
   warnings: EvalTraceSpanWarning[];
   error: EvalTraceSpanError | null;
 };
+/**
+ * Cost-simulation scenarios available in the LLM calls breakdown table.
+ *
+ * - `actual` — Real billed cost recorded on the span.
+ * - `noCache` — Bill every input token at the base input rate, ignoring all
+ *   cache reads and cache writes. Worst case for any prompt that could be
+ *   cached.
+ * - `withBaseCaching` — Steady-state cost on a fully warmed cache: cache
+ *   writes are treated as already paid (free), cache reads keep the cache-read
+ *   discount, and base input keeps the base rate. When the call has no
+ *   caching at all, every input token is billed at the cache-read rate, as if
+ *   the prompt had been warmed by an earlier run. Cache-read pricing is the
+ *   same on the base (5-minute) and extended (1-hour) tiers, so this scenario
+ *   covers the warmed case for both TTLs.
+ * - `withBaseCachingWrite` — First-call cost paying the 5-minute cache write
+ *   premium. When the call already uses caching, every cache write token is
+ *   billed at the 5-minute rate (any extended-cache split is folded into the
+ *   5-minute rate). When the call has no caching at all, every input token is
+ *   billed at the 5-minute cache write rate, as if this were the first call
+ *   warming up the base cache.
+ * - `withExtendedCachingWrite` — First-call cost paying the extended (e.g.
+ *   1-hour) cache write premium. When the call already uses caching, every
+ *   cache write token is billed at the extended rate. When the call has no
+ *   caching at all, every input token is billed at the extended cache write
+ *   rate, as if this were the first call warming up the extended cache.
+ */
+type LlmCostScenario = 'actual' | 'noCache' | 'withBaseCaching' | 'withBaseCachingWrite' | 'withExtendedCachingWrite';
+/** Per-row cost values returned by {@link simulateLlmCallCost}. */
+type LlmCallCostBreakdown = {
+  inputCostUsd: number | null;
+  outputCostUsd: number | null;
+  cachedInputCostUsd: number | null;
+  cacheCreationInputCostUsd: number | null;
+  reasoningCostUsd: number | null;
+  totalCostUsd: number | null;
+};
+/**
+ * Recompute the LLM-call cost breakdown for a hypothetical billing scenario,
+ * using the call's recorded token counts and the resolved pricing registry.
+ *
+ * The `actual` scenario returns the costs already stored on `entry`. Other
+ * scenarios re-derive each cost component from `pricing` so users can compare
+ * what the same usage would have cost under different cache strategies. When
+ * pricing is missing for the model/provider, simulated cost components fall
+ * back to `null` exactly like the original extractor.
+ */
+declare function simulateLlmCallCost({
+  entry,
+  pricing,
+  scenario
+}: {
+  entry: LlmCallEntry;
+  pricing: ResolvedLlmCallPricing[];
+  scenario: LlmCostScenario;
+}): LlmCallCostBreakdown;
+/** Per-row simulated token counts shown in the LLM call breakdown table. */
+type LlmCallSimulatedTokens = {
+  /** Tokens shown on the `Input` row — base input only (cached + creation are subtracted). */baseInputTokens: number | null; /** Tokens shown on the `Cache read` row. */
+  cachedInputTokens: number | null; /** Tokens shown on the `Cache write` row. */
+  cacheCreationInputTokens: number | null;
+};
+/**
+ * Project the call's recorded token allocation onto a hypothetical billing
+ * scenario. Cacheable tokens shift between rows so the breakdown reflects the
+ * simulated billing model: `noCache` folds reads/writes into base input,
+ * `withBaseCaching` (warmed) treats every cacheable token as a cache read, and
+ * the first-call write scenarios treat every cacheable token as a cache write.
+ *
+ * The returned counts are what the UI renders on each row and what
+ * {@link simulateLlmCallCost} prices, so display and totals never drift.
+ */
+declare function simulateTokenAllocation({
+  entry,
+  scenario
+}: {
+  entry: LlmCallEntry;
+  scenario: LlmCostScenario;
+}): LlmCallSimulatedTokens;
 /**
  * Filter `spans` down to LLM calls and project each one to the structured
  * shape consumed by the LLM calls tab.
@@ -5404,9 +5527,9 @@ declare function extractApiCalls(spans: EvalTraceSpan[], config: ResolvedApiCall
  * - `refresh`: never read, always write (forces re-execution and overwrites).
  */
 declare const cacheModeSchema: z$1.ZodEnum<{
-  use: "use";
-  bypass: "bypass";
   refresh: "refresh";
+  bypass: "bypass";
+  use: "use";
 }>;
 /** Mode controlling how cached spans behave during a run. */
 type CacheMode = z$1.infer<typeof cacheModeSchema>;
@@ -5427,10 +5550,10 @@ declare const cacheOperationTypeSchema: z$1.ZodEnum<{
 type CacheOperationType = z$1.infer<typeof cacheOperationTypeSchema>;
 /** Status of a cache lookup recorded on a span or case scope. */
 declare const cacheStatusSchema: z$1.ZodEnum<{
-  bypass: "bypass";
-  refresh: "refresh";
   hit: "hit";
   miss: "miss";
+  refresh: "refresh";
+  bypass: "bypass";
 }>;
 /** Status of a cache lookup recorded on a span or case scope. */
 type CacheStatus = z$1.infer<typeof cacheStatusSchema>;
@@ -5447,10 +5570,10 @@ declare const traceCacheRefSchema: z$1.ZodObject<{
   namespace: z$1.ZodString;
   key: z$1.ZodString;
   status: z$1.ZodEnum<{
-    bypass: "bypass";
-    refresh: "refresh";
     hit: "hit";
     miss: "miss";
+    refresh: "refresh";
+    bypass: "bypass";
   }>;
   read: z$1.ZodOptional<z$1.ZodBoolean>;
   stored: z$1.ZodOptional<z$1.ZodBoolean>;
@@ -5528,8 +5651,8 @@ declare const cacheRecordingSchema: z$1.ZodObject<{
   finalStatus: z$1.ZodOptional<z$1.ZodEnum<{
     error: "error";
     running: "running";
-    cancelled: "cancelled";
     ok: "ok";
+    cancelled: "cancelled";
   }>>;
   finalError: z$1.ZodOptional<z$1.ZodObject<{
     name: z$1.ZodOptional<z$1.ZodString>;
@@ -5601,8 +5724,8 @@ declare const cacheEntrySchema: z$1.ZodObject<{
     finalStatus: z$1.ZodOptional<z$1.ZodEnum<{
       error: "error";
       running: "running";
-      cancelled: "cancelled";
       ok: "ok";
+      cancelled: "cancelled";
     }>>;
     finalError: z$1.ZodOptional<z$1.ZodObject<{
       name: z$1.ZodOptional<z$1.ZodString>;
@@ -5690,8 +5813,8 @@ declare const cacheEntryWithDebugKeySchema: z$1.ZodObject<{
     finalStatus: z$1.ZodOptional<z$1.ZodEnum<{
       error: "error";
       running: "running";
-      cancelled: "cancelled";
       ok: "ok";
+      cancelled: "cancelled";
     }>>;
     finalError: z$1.ZodOptional<z$1.ZodObject<{
       name: z$1.ZodOptional<z$1.ZodString>;
@@ -5779,8 +5902,8 @@ declare const cacheFileSchema: z$1.ZodObject<{
       finalStatus: z$1.ZodOptional<z$1.ZodEnum<{
         error: "error";
         running: "running";
-        cancelled: "cancelled";
         ok: "ok";
+        cancelled: "cancelled";
       }>>;
       finalError: z$1.ZodOptional<z$1.ZodObject<{
         name: z$1.ZodOptional<z$1.ZodString>;
@@ -5966,9 +6089,9 @@ declare const createRunRequestSchema: z$1.ZodObject<{
   trials: z$1.ZodNumber;
   cache: z$1.ZodOptional<z$1.ZodObject<{
     mode: z$1.ZodDefault<z$1.ZodEnum<{
-      use: "use";
-      bypass: "bypass";
       refresh: "refresh";
+      bypass: "bypass";
+      use: "use";
     }>>;
   }, z$1.core.$strip>>;
   manualInputs: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodUnknown>>;
@@ -6238,4 +6361,4 @@ type ManualInputDescriptor = z$1.infer<typeof manualInputDescriptorSchema>; //#e
  */
 declare function runCli(argv: string[]): Promise<void>;
 //#endregion
-export { type AgentEvalsConfig, type ApiCallEntry, type ApiCallMetric, type ApiCallMetricFormat, type ApiCallMetricPlacement, type ApiCallMetricValue, type ApiCallsConfigInput, type AssertionFailure, type CacheActivityEntry, type CacheAdapter, type CacheDebugKeyEntry, type CacheDebugKeyFile, type CacheDebugKeyWrite, type CacheEntry, type CacheEntryWithDebugKey, type CacheFile, type CacheHitEntry, type CacheKeyHashInput, type CacheKeyHashOptions, type CacheListItem, type CacheMode, type CacheOperationType, type CacheRecording, type CacheRecordingFrame, type CacheRecordingOp, type CacheScopeContext, type CacheSerializationOptions, type CacheStatus, type CallDerivedAttribute, type CallDerivedAttributeContext, type CallDerivedAttributesConfig, type CallDerivedAttributesFn, type CaptureEvalSpanErrorLevel, type CaptureEvalSpanErrorOptions, type CaseDetail, type CaseRow, type CellValue, type ColumnDef, type ColumnFormat, type ColumnKind, type ConfigReloadState, type ConfigReloadStatus, type CreateRunRequest, DEFAULT_API_CALLS_CONFIG, DEFAULT_LLM_CALLS_CONFIG, type DefaultConfigKey, type DerivedStatus, type DiscoveryIssue, EvalAssertionError, type EvalCacheConfig, type EvalCase, type EvalCaseScope, type EvalChartAggregate, type EvalChartAxis, type EvalChartBuiltinMetric, type EvalChartColor, type EvalChartConfig, type EvalChartMetric, type EvalChartTooltipExtra, type EvalChartType, type EvalChartsConfig, type EvalColumnOverride, type EvalColumns, type EvalDefinition, type EvalDeriveConfig, type EvalDeriveContext, type EvalDeriveFn, type EvalDeriveMap, type EvalDeriveValueFn, type EvalDisplayStatus, type EvalExecuteContext, type EvalExpectation, type EvalFreshnessStatus, type EvalManualInputConfig, type EvalManualScoreDef, type EvalOutputs, type EvalOutputsSchema, type EvalRunner, type EvalRuntimeScope, type EvalScoreContext, type EvalScoreDef, type EvalScoreFn, type EvalSetOutput, type EvalStartTime, type EvalStatAggregate, type EvalStatItem, type EvalStatsConfig, type EvalSummary, type EvalTimeUnit, type EvalTraceSpan, type EvalTraceSpanError, type EvalTraceSpanWarning, type EvalTraceTree, type FileRef, type JsonCell, type LlmCallEntry, type LlmCallMetric, type LlmCallMetricFormat, type LlmCallMetricPlacement, type LlmCallMetricValue, type LlmCallPricing, type LlmCallPricingRate, type LlmCallPricingRegistry, type LlmCallsConfigInput, type ManualInputDescriptor, type ManualInputFieldDescriptor, type ManualInputFieldKind, type ManualInputFieldOverride, type ManualInputFieldsConfig, type ManualInputFileValue, type ManualInputSelectOption, type MaterializeManualInputFilesResult, type NumberDisplayOptions, type ReadManualInputFileResult, type RemoveDefaultConfig, type RepoFileRef, type ResolvedApiCallMetric, type ResolvedApiCallsConfig, type ResolvedCallDerivedAttribute, type ResolvedLlmCallMetric, type ResolvedLlmCallPricing, type ResolvedLlmCallsConfig, type RunArtifactRef, type RunInEvalScopeOptions, type RunLogEntry, type RunLogLevel, type RunLogLocation, type RunLogPhase, type RunLogsConfigInput, type RunManifest, type RunSummary, type ScalarCell, type ScopedCaseSummary, type ScoreTrace, type SerializedCacheSpan, type SerializedCacheValue, type SpanCacheOptions, type SseEnvelope, type SseEventType, type TraceActiveSpan, type TraceAttributeDisplay, type TraceAttributeDisplayFormat, type TraceAttributeDisplayInput, type TraceAttributeDisplayPlacement, type TraceAttributeTransform, type TraceAttributeTransformContext, type TraceCacheInfo, type TraceCacheRef, type TraceDisplayConfig, type TraceDisplayInputConfig, type TraceSpanInfo, type TrialSelectionMode, type UpdateManualScoreRequest, advanceEvalTime, agentEvalsConfigSchema, apiCallMetricFormatSchema, apiCallMetricPlacementSchema, apiCallMetricSchema, apiCallsConfigSchema, appendToEvalOutput, applyDerivedCallAttributes, assertionFailureSchema, buildCaseKey, buildEvalKey, buildTraceTree, cacheDebugKeyEntrySchema, cacheDebugKeyFileSchema, cacheEntrySchema, cacheEntryWithDebugKeySchema, cacheFileSchema, cacheListItemSchema, cacheModeSchema, cacheOperationTypeSchema, cacheRecordingOpSchema, cacheRecordingSchema, cacheStatusSchema, captureEvalSpanError, caseDetailSchema, caseRowSchema, cellValueSchema, cleanupStagedManualInputFiles, columnDefSchema, columnFormatSchema, columnKindSchema, configReloadStateSchema, configReloadStatusSchema, createRunRequestSchema, createRunner, defaultConfigKeySchema, defineEval, deriveScopedSummaryFromCases, deriveStatusFromCaseRows, deriveStatusFromChildStatuses, deserializeCacheRecording, deserializeCacheValue, discoveryIssueSchema, evalAssert, evalChartAggregateSchema, evalChartAxisSchema, evalChartBuiltinMetricSchema, evalChartColorSchema, evalChartConfigSchema, evalChartMetricSchema, evalChartTooltipExtraSchema, evalChartTypeSchema, evalChartsConfigSchema, evalColumnOverrideSchema, evalColumnsSchema, evalDeriveConfigSchema, evalExpect, evalFreshnessStatusSchema, evalLog, evalSpan, evalStatAggregateSchema, evalStatItemSchema, evalStatsConfigSchema, evalSummarySchema, evalTracer, extractApiCalls, extractCacheEntries, extractCacheHits, extractLlmCalls, fileRefSchema, getCaseRowCaseKey, getCaseRowEvalKey, getCurrentScope, getEvalCaseInput, getEvalDisplayStatus, getEvalRegistry, getEvalStartTime, getEvalTitle, getNestedAttribute, hashCacheKey, hashCacheKeySync, incrementEvalOutput, isInEvalScope, isManualInputFileValue, jsonCellSchema, llmCallMetricFormatSchema, llmCallMetricPlacementSchema, llmCallMetricSchema, llmCallPricingRateSchema, llmCallPricingSchema, llmCallsConfigSchema, manualInputBooleanFieldSchema, manualInputDescriptorSchema, manualInputFieldDescriptorSchema, manualInputFileValueSchema, manualInputJsonFieldSchema, manualInputMultilineFieldSchema, manualInputNumberFieldSchema, manualInputSelectFieldSchema, manualInputSelectOptionSchema, manualInputTextFieldSchema, materializeManualInputFiles, mergeEvalOutput, nextEvalId, numberDisplayOptionsSchema, readManualInputFile, removeDefaultConfigSchema, repoFile, repoFileRefSchema, resolveApiCallsConfig, resolveLlmCallsConfig, runArtifactRefSchema, runCli, runInEvalRuntimeScope, runInEvalScope, runInExistingEvalScope, runLogEntrySchema, runLogLevelSchema, runLogLocationSchema, runLogPhaseSchema, runLogsConfigSchema, runManifestSchema, runSummarySchema, scoreTraceSchema, serializeCacheRecording, serializeCacheValue, serializedCacheSpanSchema, setEvalOutput, setScopeCacheContext, spanCacheOptionsSchema, sseEnvelopeSchema, stageManualInputFile, stageManualInputFileFromPath, startEvalBackgroundJob, traceAttributeDisplayFormatSchema, traceAttributeDisplayInputSchema, traceAttributeDisplayPlacementSchema, traceAttributeDisplaySchema, traceCacheRefSchema, traceDisplayConfigSchema, traceDisplayInputConfigSchema, traceSpanErrorSchema, traceSpanKindSchema, traceSpanSchema, traceSpanWarningSchema, trialSelectionModeSchema, updateManualScoreRequestSchema, z };
+export { type AgentEvalsConfig, type ApiCallEntry, type ApiCallMetric, type ApiCallMetricFormat, type ApiCallMetricPlacement, type ApiCallMetricValue, type ApiCallsConfigInput, type AssertionFailure, type CacheActivityEntry, type CacheAdapter, type CacheDebugKeyEntry, type CacheDebugKeyFile, type CacheDebugKeyWrite, type CacheEntry, type CacheEntryWithDebugKey, type CacheFile, type CacheHitEntry, type CacheKeyHashInput, type CacheKeyHashOptions, type CacheListItem, type CacheMode, type CacheOperationType, type CacheRecording, type CacheRecordingFrame, type CacheRecordingOp, type CacheScopeContext, type CacheSerializationOptions, type CacheStatus, type CallDerivedAttribute, type CallDerivedAttributeContext, type CallDerivedAttributesConfig, type CallDerivedAttributesFn, type CaptureEvalSpanErrorLevel, type CaptureEvalSpanErrorOptions, type CaseDetail, type CaseRow, type CellValue, type ColumnDef, type ColumnFormat, type ColumnKind, type ConfigReloadState, type ConfigReloadStatus, type CreateRunRequest, DEFAULT_API_CALLS_CONFIG, DEFAULT_LLM_CALLS_CONFIG, type DefaultConfigKey, type DerivedStatus, type DiscoveryIssue, EvalAssertionError, type EvalCacheConfig, type EvalCase, type EvalCaseScope, type EvalChartAggregate, type EvalChartAxis, type EvalChartBuiltinMetric, type EvalChartColor, type EvalChartConfig, type EvalChartMetric, type EvalChartTooltipExtra, type EvalChartType, type EvalChartsConfig, type EvalColumnOverride, type EvalColumns, type EvalDefinition, type EvalDeriveConfig, type EvalDeriveContext, type EvalDeriveFn, type EvalDeriveMap, type EvalDeriveValueFn, type EvalDisplayStatus, type EvalExecuteContext, type EvalExpectation, type EvalFreshnessStatus, type EvalManualInputConfig, type EvalManualScoreDef, type EvalOutputs, type EvalOutputsSchema, type EvalRunner, type EvalRuntimeScope, type EvalScoreContext, type EvalScoreDef, type EvalScoreFn, type EvalSetOutput, type EvalStartTime, type EvalStatAggregate, type EvalStatItem, type EvalStatsConfig, type EvalSummary, type EvalTimeUnit, type EvalTraceSpan, type EvalTraceSpanError, type EvalTraceSpanWarning, type EvalTraceTree, type FileRef, type JsonCell, type LlmCallCostBreakdown, type LlmCallCostCurrency, type LlmCallEntry, type LlmCallMetric, type LlmCallMetricFormat, type LlmCallMetricPlacement, type LlmCallMetricValue, type LlmCallPricing, type LlmCallPricingRate, type LlmCallPricingRegistry, type LlmCallSimulatedTokens, type LlmCallsConfigInput, type LlmCostScenario, type ManualInputDescriptor, type ManualInputFieldDescriptor, type ManualInputFieldKind, type ManualInputFieldOverride, type ManualInputFieldsConfig, type ManualInputFileValue, type ManualInputSelectOption, type MaterializeManualInputFilesResult, type NumberDisplayOptions, type ReadManualInputFileResult, type RemoveDefaultConfig, type RepoFileRef, type ResolvedApiCallMetric, type ResolvedApiCallsConfig, type ResolvedCallDerivedAttribute, type ResolvedLlmCallCostCurrency, type ResolvedLlmCallMetric, type ResolvedLlmCallPricing, type ResolvedLlmCallsConfig, type RunArtifactRef, type RunInEvalScopeOptions, type RunLogEntry, type RunLogLevel, type RunLogLocation, type RunLogPhase, type RunLogsConfigInput, type RunManifest, type RunSummary, type ScalarCell, type ScopedCaseSummary, type ScoreTrace, type SerializedCacheSpan, type SerializedCacheValue, type SpanCacheOptions, type SseEnvelope, type SseEventType, type TraceActiveSpan, type TraceAttributeDisplay, type TraceAttributeDisplayFormat, type TraceAttributeDisplayInput, type TraceAttributeDisplayPlacement, type TraceAttributeTransform, type TraceAttributeTransformContext, type TraceCacheInfo, type TraceCacheRef, type TraceDisplayConfig, type TraceDisplayInputConfig, type TraceSpanInfo, type TrialSelectionMode, type UpdateManualScoreRequest, advanceEvalTime, agentEvalsConfigSchema, apiCallMetricFormatSchema, apiCallMetricPlacementSchema, apiCallMetricSchema, apiCallsConfigSchema, appendToEvalOutput, applyDerivedCallAttributes, assertionFailureSchema, buildCaseKey, buildEvalKey, buildTraceTree, cacheDebugKeyEntrySchema, cacheDebugKeyFileSchema, cacheEntrySchema, cacheEntryWithDebugKeySchema, cacheFileSchema, cacheListItemSchema, cacheModeSchema, cacheOperationTypeSchema, cacheRecordingOpSchema, cacheRecordingSchema, cacheStatusSchema, captureEvalSpanError, caseDetailSchema, caseRowSchema, cellValueSchema, cleanupStagedManualInputFiles, columnDefSchema, columnFormatSchema, columnKindSchema, configReloadStateSchema, configReloadStatusSchema, createRunRequestSchema, createRunner, defaultConfigKeySchema, defineEval, deriveScopedSummaryFromCases, deriveStatusFromCaseRows, deriveStatusFromChildStatuses, deserializeCacheRecording, deserializeCacheValue, discoveryIssueSchema, evalAssert, evalChartAggregateSchema, evalChartAxisSchema, evalChartBuiltinMetricSchema, evalChartColorSchema, evalChartConfigSchema, evalChartMetricSchema, evalChartTooltipExtraSchema, evalChartTypeSchema, evalChartsConfigSchema, evalColumnOverrideSchema, evalColumnsSchema, evalDeriveConfigSchema, evalExpect, evalFreshnessStatusSchema, evalLog, evalSpan, evalStatAggregateSchema, evalStatItemSchema, evalStatsConfigSchema, evalSummarySchema, evalTracer, extractApiCalls, extractCacheEntries, extractCacheHits, extractLlmCalls, fileRefSchema, getCaseRowCaseKey, getCaseRowEvalKey, getCurrentScope, getEvalCaseInput, getEvalDisplayStatus, getEvalRegistry, getEvalStartTime, getEvalTitle, getNestedAttribute, hashCacheKey, hashCacheKeySync, incrementEvalOutput, isInEvalScope, isManualInputFileValue, jsonCellSchema, llmCallCostCurrencySchema, llmCallMetricFormatSchema, llmCallMetricPlacementSchema, llmCallMetricSchema, llmCallPricingRateSchema, llmCallPricingSchema, llmCallsConfigSchema, manualInputBooleanFieldSchema, manualInputDescriptorSchema, manualInputFieldDescriptorSchema, manualInputFileValueSchema, manualInputJsonFieldSchema, manualInputMultilineFieldSchema, manualInputNumberFieldSchema, manualInputSelectFieldSchema, manualInputSelectOptionSchema, manualInputTextFieldSchema, materializeManualInputFiles, mergeEvalOutput, nextEvalId, numberDisplayOptionsSchema, readManualInputFile, removeDefaultConfigSchema, repoFile, repoFileRefSchema, resolveApiCallsConfig, resolveLlmCallsConfig, runArtifactRefSchema, runCli, runInEvalRuntimeScope, runInEvalScope, runInExistingEvalScope, runLogEntrySchema, runLogLevelSchema, runLogLocationSchema, runLogPhaseSchema, runLogsConfigSchema, runManifestSchema, runSummarySchema, scoreTraceSchema, serializeCacheRecording, serializeCacheValue, serializedCacheSpanSchema, setEvalOutput, setScopeCacheContext, simulateLlmCallCost, simulateTokenAllocation, spanCacheOptionsSchema, sseEnvelopeSchema, stageManualInputFile, stageManualInputFileFromPath, startEvalBackgroundJob, traceAttributeDisplayFormatSchema, traceAttributeDisplayInputSchema, traceAttributeDisplayPlacementSchema, traceAttributeDisplaySchema, traceCacheRefSchema, traceDisplayConfigSchema, traceDisplayInputConfigSchema, traceSpanErrorSchema, traceSpanKindSchema, traceSpanSchema, traceSpanWarningSchema, trialSelectionModeSchema, updateManualScoreRequestSchema, z };