niceeval 0.12.2-canary.31 → 0.13.0

package/dist/cli.d.cts

@@ -1,8 +1,8 @@
-import { Effect } from "effect";
+import { Cause, Effect } from "effect";
 import type { ExperimentRenamePlan, ExperimentRenameRejected, RenamedExperiment } from "./runner/rename-experiment.cjs";
 import { ExperimentRenameError } from "./runner/rename-experiment.cjs";
 import type { InvocationSummary } from "./types.cjs";
-declare const CliUsageError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+declare const CliUsageError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => Cause.YieldableError & {
     readonly _tag: "CliUsageError";
 } & Readonly<A>;
 /** A recoverable command-line usage error. Defects deliberately do not enter this channel. */
@@ -11,7 +11,7 @@ export declare class CliUsageError extends CliUsageError_base<{
     readonly exitCode: number;
 }> {
 }
-declare const CliOperationError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+declare const CliOperationError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => Cause.YieldableError & {
     readonly _tag: "CliOperationError";
 } & Readonly<A>;
 /** A recoverable failure from a concrete CLI-owned boundary (file, process, or dynamic module). */
@@ -25,7 +25,8 @@ export type CliFailure = CliUsageError | CliOperationError;
 /**
  * Bootstrap owns process signals until an Eval has reached actual dispatch.
  * The CLI claims the Invocation signal synchronously immediately before
- * `runEvals`; it never infers this from argv outside the command dispatcher.
+ * Experiment Host dispatch; it never infers this from argv outside the command
+ * dispatcher.
  */
 export interface CliInterruptionOwnership {
     readonly invocationSignal: AbortSignal;
@@ -135,5 +136,5 @@ export declare function renderExperimentRenameJson(document: ExperimentRenameJso
 export declare function experimentRenameRejectedFromError(error: ExperimentRenameError): ExperimentRenameRejected;
 /** 退出码:可迁移预览与成功执行为 0;blocked 预览 / rejected 整批零写入按失败退出。 */
 export declare function experimentRenameExitCode(document: ExperimentRenameJsonDocument): number;
-export declare const cliProgram: (interruption?: CliInterruptionOwnership) => Effect.Effect<number, CliFailure, import("./record/index.cjs").RecordFileSystem | import("effect/Scope").Scope | import("./record/index.cjs").RecordMaintenanceLock | import("./record/index.cjs").RecordWriterLock | import("./record/index.cjs").RecordEntropy>;
+export declare const cliProgram: (interruption?: CliInterruptionOwnership) => Effect.Effect<number, CliFailure, import("effect/Scope").Scope | import("./coordination/record-leases.cjs").RecordCoordination | import("./record/platform/services.cjs").RecordFileSystem | import("./record/platform/services.cjs").RecordEntropy>;
 export {};

package/dist/cli.d.mts

@@ -1,8 +1,8 @@
-import { Effect } from "effect";
+import { Cause, Effect } from "effect";
 import type { ExperimentRenamePlan, ExperimentRenameRejected, RenamedExperiment } from "./runner/rename-experiment.mjs";
 import { ExperimentRenameError } from "./runner/rename-experiment.mjs";
 import type { InvocationSummary } from "./types.mjs";
-declare const CliUsageError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+declare const CliUsageError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => Cause.YieldableError & {
     readonly _tag: "CliUsageError";
 } & Readonly<A>;
 /** A recoverable command-line usage error. Defects deliberately do not enter this channel. */
@@ -11,7 +11,7 @@ export declare class CliUsageError extends CliUsageError_base<{
     readonly exitCode: number;
 }> {
 }
-declare const CliOperationError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+declare const CliOperationError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => Cause.YieldableError & {
     readonly _tag: "CliOperationError";
 } & Readonly<A>;
 /** A recoverable failure from a concrete CLI-owned boundary (file, process, or dynamic module). */
@@ -25,7 +25,8 @@ export type CliFailure = CliUsageError | CliOperationError;
 /**
  * Bootstrap owns process signals until an Eval has reached actual dispatch.
  * The CLI claims the Invocation signal synchronously immediately before
- * `runEvals`; it never infers this from argv outside the command dispatcher.
+ * Experiment Host dispatch; it never infers this from argv outside the command
+ * dispatcher.
  */
 export interface CliInterruptionOwnership {
     readonly invocationSignal: AbortSignal;
@@ -135,5 +136,5 @@ export declare function renderExperimentRenameJson(document: ExperimentRenameJso
 export declare function experimentRenameRejectedFromError(error: ExperimentRenameError): ExperimentRenameRejected;
 /** 退出码:可迁移预览与成功执行为 0;blocked 预览 / rejected 整批零写入按失败退出。 */
 export declare function experimentRenameExitCode(document: ExperimentRenameJsonDocument): number;
-export declare const cliProgram: (interruption?: CliInterruptionOwnership) => Effect.Effect<number, CliFailure, import("./record/index.mjs").RecordFileSystem | import("effect/Scope").Scope | import("./record/index.mjs").RecordMaintenanceLock | import("./record/index.mjs").RecordWriterLock | import("./record/index.mjs").RecordEntropy>;
+export declare const cliProgram: (interruption?: CliInterruptionOwnership) => Effect.Effect<number, CliFailure, import("effect/Scope").Scope | import("./coordination/record-leases.mjs").RecordCoordination | import("./record/platform/services.mjs").RecordFileSystem | import("./record/platform/services.mjs").RecordEntropy>;
 export {};

package/dist/cli.d.ts

@@ -1,8 +1,8 @@
-import { Effect } from "effect";
+import { Cause, Effect } from "effect";
 import type { ExperimentRenamePlan, ExperimentRenameRejected, RenamedExperiment } from "./runner/rename-experiment.js";
 import { ExperimentRenameError } from "./runner/rename-experiment.js";
 import type { InvocationSummary } from "./types.js";
-declare const CliUsageError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+declare const CliUsageError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => Cause.YieldableError & {
     readonly _tag: "CliUsageError";
 } & Readonly<A>;
 /** A recoverable command-line usage error. Defects deliberately do not enter this channel. */
@@ -11,7 +11,7 @@ export declare class CliUsageError extends CliUsageError_base<{
     readonly exitCode: number;
 }> {
 }
-declare const CliOperationError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+declare const CliOperationError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => Cause.YieldableError & {
     readonly _tag: "CliOperationError";
 } & Readonly<A>;
 /** A recoverable failure from a concrete CLI-owned boundary (file, process, or dynamic module). */
@@ -25,7 +25,8 @@ export type CliFailure = CliUsageError | CliOperationError;
 /**
  * Bootstrap owns process signals until an Eval has reached actual dispatch.
  * The CLI claims the Invocation signal synchronously immediately before
- * `runEvals`; it never infers this from argv outside the command dispatcher.
+ * Experiment Host dispatch; it never infers this from argv outside the command
+ * dispatcher.
  */
 export interface CliInterruptionOwnership {
     readonly invocationSignal: AbortSignal;
@@ -135,5 +136,5 @@ export declare function renderExperimentRenameJson(document: ExperimentRenameJso
 export declare function experimentRenameRejectedFromError(error: ExperimentRenameError): ExperimentRenameRejected;
 /** 退出码:可迁移预览与成功执行为 0;blocked 预览 / rejected 整批零写入按失败退出。 */
 export declare function experimentRenameExitCode(document: ExperimentRenameJsonDocument): number;
-export declare const cliProgram: (interruption?: CliInterruptionOwnership) => Effect.Effect<number, CliFailure, import("./record/index.js").RecordFileSystem | import("effect/Scope").Scope | import("./record/index.js").RecordMaintenanceLock | import("./record/index.js").RecordWriterLock | import("./record/index.js").RecordEntropy>;
+export declare const cliProgram: (interruption?: CliInterruptionOwnership) => Effect.Effect<number, CliFailure, import("effect/Scope").Scope | import("./coordination/record-leases.js").RecordCoordination | import("./record/platform/services.js").RecordFileSystem | import("./record/platform/services.js").RecordEntropy>;
 export {};

package/dist/context/assert-first.cjs

@@ -15,6 +15,7 @@ const workspace_diff_ts_1 = require("../assertions/workspace-diff.cjs");
 const diff_ts_1 = require("../assertions/diff.cjs");
 const match_ts_1 = require("../assertions/match.cjs");
 const derive_ts_1 = require("../o11y/derive.cjs");
+const cost_ts_1 = require("../o11y/cost.cjs");
 const command_projection_ts_1 = require("../o11y/command-projection.cjs");
 const source_loc_ts_1 = require("../source-loc.cjs");
 const session_ts_1 = require("./session.cjs");
@@ -317,9 +318,14 @@ function usageLimitHandle(input) {
             snapshot: input.snapshot,
         }),
         evaluate: () => effect_1.Effect.sync(() => {
+            // 预算只认 estimatedCostUSD(价目表估算),never observed usage.costUSD:
+            // 两者独立并存,observed 存在也不改变估算口径(见 Usage.costUSD 单向字段契约)。
+            // 无 model / 无价格 / 无可计价 usage 时 estimate 不存在；缺测不能被当成零成本。
             const actual = input.metric === "tokens"
                 ? (input.usage.inputTokens ?? 0) + (input.usage.outputTokens ?? 0)
-                : input.usage.costUSD ?? 0;
+                : input.estimatedCostUSD;
+            if (actual === undefined)
+                return unavailableVoid();
             if (actual > input.maximum)
                 return mismatchedVoid();
             return hasCompleteCoverage(input.coverage, "usage")
@@ -1023,15 +1029,12 @@ function createAssertFirstEvalContext(deps) {
         telemetry: deps.telemetry,
         otel: deps.otel,
         feedback: deps.feedback,
-        fact: deps.fact,
         onSendActive: deps.onSendActive,
         timingNow: deps.timingNow,
         onTurn: deps.onTurn,
         ledgerHooks: deps.ledgerHooks,
         concurrencySlot: deps.concurrencySlot,
         experimentClassifier: deps.experimentClassifier,
-        retryRandom: deps.retryRandom,
-        retrySleep: deps.retrySleep,
         nextSourceOrder: deps.nextSourceOrder,
         sourceRegistry: deps.sourceRegistry,
     });
@@ -1043,6 +1046,9 @@ function createAssertFirstEvalContext(deps) {
         manager,
         late: { diff: Object.freeze({ state: "pending" }), scripts: {} },
     };
+    // maxCost 断言唯一认价目表估算(estimateCost);observed usage.costUSD 与之独立并存,
+    // 存在也不改变估算(见 Usage.costUSD 单向字段契约)。
+    const estimatedCostFor = (usage) => (0, cost_ts_1.estimateCost)(deps.model, usage, deps.pricing);
     const sessions = [];
     let toolTurnOrdinal = 0;
     const coverageWhileInFlight = (coverage) => Object.freeze({
@@ -1318,6 +1324,7 @@ function createAssertFirstEvalContext(deps) {
                 metric: "cost",
                 maximum: usd,
                 usage: turn.usage ?? {},
+                estimatedCostUSD: estimatedCostFor(turn.usage === undefined ? {} : turn.usage),
                 coverage,
                 snapshot: scopeSnapshot,
             });
@@ -1461,6 +1468,7 @@ function createAssertFirstEvalContext(deps) {
                 metric: "cost",
                 maximum: usd,
                 usage: session.usage,
+                estimatedCostUSD: estimatedCostFor(session.usage),
                 coverage,
                 snapshot: sessionSnapshot(scope),
             });
@@ -1648,6 +1656,7 @@ function createAssertFirstEvalContext(deps) {
             metric: "cost",
             maximum: usd,
             usage: manager.usage,
+            estimatedCostUSD: estimatedCostFor(manager.usage),
             coverage,
             snapshot: attemptSnapshot(),
         });