@rulvar/cli 1.119.0 → 1.121.0

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { r as runCli, t as processIo } from "./io-Ghdg-hbD.js";
+import { r as runCli, t as processIo } from "./io-CsvU0Iog.js";
 import { sanitizeTerminalText } from "@rulvar/core";
 import { inspect } from "node:util";
 //#region src/cli.ts

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { CreateEngineOptions, Engine, JournalStore, KeyDeriver, LeasableStore, ModelRef, PreflightInput, RunHandle, RunMeta, RunOutcome, Usage, Workflow, WorkflowEvent, WorkflowRegistry } from "@rulvar/core";
+import { CreateEngineOptions, Engine, JournalStore, KeyDeriver, LeasableStore, ModelRef, PreflightInput, Pricing, RunHandle, RunMeta, RunOutcome, Usage, Workflow, WorkflowEvent, WorkflowRegistry } from "@rulvar/core";
 
 //#region src/io.d.ts
 interface CliIo {
@@ -166,6 +166,13 @@ interface AssembledCli {
   /** The journal-fold price function (table wins over caps). */
   priceUsd: (servedBy: ModelRef, usage: Usage) => number | undefined;
   /**
+  * The resolved pricing row behind priceUsd (table wins over caps),
+  * surfaced for the provenance renderers (RV814): the invoice names
+  * each priced model's `ratesVerifiedAt` with its age, and the row is
+  * where the date lives.
+  */
+  pricingOf: (servedBy: ModelRef) => Pricing | undefined;
+  /**
   * The deployment's argsHash salt (engineOptions.security, RV-217),
   * surfaced so the CLI resume args gate hashes supplied --args the
   * same way the engine hashed the genesis args.

package/dist/index.js

@@ -1,4 +1,4 @@
-import { _ as loadCliConfig, a as invoiceCommand, c as runCommand, d as reportOutcome, f as strictExitCode, g as assembleEngine, h as DEFAULT_STORE_DIR, i as inspectCommand, l as runsLsCommand, m as renderEventLine, n as HELP, o as preflightCommand, p as attachProgress, r as runCli, s as resumeCommand, t as processIo, u as driveRun, v as loadWorkflowModule, y as looksLikeFile } from "./io-Ghdg-hbD.js";
+import { _ as loadCliConfig, a as invoiceCommand, c as runCommand, d as reportOutcome, f as strictExitCode, g as assembleEngine, h as DEFAULT_STORE_DIR, i as inspectCommand, l as runsLsCommand, m as renderEventLine, n as HELP, o as preflightCommand, p as attachProgress, r as runCli, s as resumeCommand, t as processIo, u as driveRun, v as loadWorkflowModule, y as looksLikeFile } from "./io-CsvU0Iog.js";
 import { ConfigError, InvalidResolutionError, JournalCompatibilityError, LeaseHeldError, Replayer, RulvarError, buildDeriverRegistry, compileSecretMasker, costReportFromJournal, journalPricingSnapshot, maskSecrets, normalizeEntry, readRunMeta, scanJournalCompatibility, validateSchemaSpec } from "@rulvar/core";
 //#region src/server.ts
 /**
@@ -990,6 +990,7 @@ async function toOtel(run, tracer, options = {}) {
 				if (runOpen !== void 0 && event.degradedReasons !== void 0) runOpen.span.setAttribute("rulvar.run.degradedReasons", JSON.stringify(event.degradedReasons));
 				if (runOpen !== void 0 && event.salvagedPartialChildren !== void 0) runOpen.span.setAttribute("rulvar.run.salvagedPartialChildren", JSON.stringify(event.salvagedPartialChildren));
 				if (runOpen !== void 0 && event.salvagedTerminalOutputChildren !== void 0) runOpen.span.setAttribute("rulvar.run.salvagedTerminalOutputChildren", JSON.stringify(event.salvagedTerminalOutputChildren));
+				if (runOpen !== void 0 && event.acceptanceChildren !== void 0) runOpen.span.setAttribute("rulvar.run.acceptanceChildren", JSON.stringify(event.acceptanceChildren));
 				endSpan(event.spanId, event.ts, event.status);
 				break;
 			}

package/dist/{io-Ghdg-hbD.js → io-CsvU0Iog.js}

@@ -105,9 +105,12 @@ function assembleEngine(options) {
 		}
 	});
 	const byId = new Map(adapters.map((adapter) => [adapter.id, adapter]));
-	const priceUsd = (servedBy, usage) => {
+	const pricingOf = (servedBy) => {
 		const { adapterId, model } = parseModelRef(servedBy);
-		const pricing = resolvePricing(servedBy, engineOptions.pricing, byId.get(adapterId)?.caps(model).pricing);
+		return resolvePricing(servedBy, engineOptions.pricing, byId.get(adapterId)?.caps(model).pricing);
+	};
+	const priceUsd = (servedBy, usage) => {
+		const pricing = pricingOf(servedBy);
 		return pricing === void 0 ? void 0 : priceUsdOf(pricing, usage);
 	};
 	const argsHashSalt = engineOptions.security?.argsHashSalt;
@@ -117,6 +120,7 @@ function assembleEngine(options) {
 		store,
 		workflows,
 		priceUsd,
+		pricingOf,
 		...argsHashSalt === void 0 ? {} : { argsHashSalt },
 		...currentPricingVersion === void 0 ? {} : { currentPricingVersion }
 	};
@@ -1109,6 +1113,24 @@ async function inspectCommand(argv, context) {
 	if (cost.abandoned.usd > 0) context.io.out(`gross: $${cost.grossUsd.toFixed(4)} (abandoned: $${cost.abandoned.usd.toFixed(4)}; see rulvar invoice)`);
 	for (const [model, usd] of Object.entries(cost.byModel)) context.io.out(`  ${model}: $${usd.toFixed(4)}`);
 	for (const item of cost.unpriced) context.io.out(`  unpriced: ${item.model} (${item.usage.inputTokens + item.usage.outputTokens} tok)`);
+	for (const entry of entries) {
+		if (entry.kind !== "decision") continue;
+		const value = entry.value;
+		if (value?.decisionType === "orchestrator_acceptance") {
+			context.io.out(`acceptance: ${value.verdict ?? "unknown"} (completion ${value.completion ?? "unknown"}; gate on the status and completion PAIR)`);
+			if ((value.salvagedPartialChildren?.length ?? 0) > 0) context.io.out(`  salvaged partial: ${(value.salvagedPartialChildren ?? []).join(", ")}`);
+			if ((value.salvagedTerminalOutputChildren?.length ?? 0) > 0) context.io.out(`  salvaged terminal output: ${(value.salvagedTerminalOutputChildren ?? []).join(", ")}`);
+			for (const child of value.children ?? []) {
+				if (child.evidence === void 0) continue;
+				const marker = child.evidence.met ? "met" : child.evidence.waivedBySalvage === true ? "below floor, waived by salvage" : "below floor";
+				context.io.out(`  evidence ${child.child}: ${String(child.evidence.recordedEntries)} of ${String(child.evidence.minEntries)} (${marker})`);
+			}
+		}
+		if (value?.decisionType === "quota_drift") {
+			const drift = entry.value;
+			context.io.out(`quota drift: ${drift.provider ?? "?"}:${drift.model ?? "?"} ${drift.dimension ?? "?"} declared ${String(drift.declaredPerMinute ?? "?")}/min vs provider ${String(drift.reportedPerMinute ?? "?")}/min (per-minute window, not cumulative)`);
+		}
+	}
 	for (const entry of entries) {
 		const status = entry.status === void 0 ? "" : ` ${entry.status}`;
 		const served = entry.servedBy === void 0 ? "" : ` servedBy=${entry.servedBy}`;
@@ -1167,6 +1189,8 @@ async function invoiceCommand(argv, context) {
 	context.io.out(`rows: ${invoice.rows.length} (reconciliation failures: ${invoice.reconciliationFailures}${invoice.usageUnknownRows === void 0 ? "" : `; usage unknown: ${invoice.usageUnknownRows}`})`);
 	context.io.out(`pricing basis: ${invoice.pricingBasis} ` + (invoice.rowUsdNonAdditive ? "(row usd is non-additive: an aggregate-priced remainder or legacy entry is in the fold; allocatedUsd sums to gross)" : "(rows are additive: every provider call priced per request; allocatedUsd agrees and sums to gross)"));
 	context.io.out(snapshot === void 0 ? "pricing rates: current table (no snapshot in the journal)" : "pricing rates: run-settle pins composed with the current table" + pinVersionsSuffix(snapshot, assembled.currentPricingVersion));
+	const verified = ratesVerifiedLine(invoice, snapshot, assembled.pricingOf, Date.now());
+	if (verified !== void 0) context.io.out(verified);
 	for (const row of invoice.rows) {
 		const usd = row.usd === void 0 ? "unpriced" : `$${row.usd.toFixed(4)}`;
 		const tokens = row.usage.inputTokens + row.usage.outputTokens;
@@ -1197,6 +1221,37 @@ function pinVersionsSuffix(snapshot, currentPricingVersion) {
 	if (currentPricingVersion !== void 0) parts.push(`current ${currentPricingVersion}`);
 	return parts.length === 0 ? "" : ` (${parts.join("; ")})`;
 }
+/**
+* ` (age Nd)` for an ISO date against the wall clock; empty when the
+* date does not parse or lies in the future (a malformed or clock-skewed
+* stamp renders as the bare date, never as a negative age).
+*/
+function ageSuffixOf(date, nowMs) {
+	const parsed = Date.parse(date);
+	if (!Number.isFinite(parsed) || parsed > nowMs) return "";
+	return ` (age ${String(Math.floor((nowMs - parsed) / 864e5))}d)`;
+}
+/**
+* `rates verified: <model> <date> (age Nd), <model> no date` over the
+* models the invoice rows name (RV814). Per model, the date is the
+* LAST settle pin's row when the journal pins one, because those are
+* the rates that priced settled history whatever today's table says; a
+* model outside the pins reads the current table's row. A pinned row
+* without a stamp is honestly `no date`, never today's table date.
+* Undefined when no applicable row names a date: journals priced under
+* pre-stamp tables keep their historical output byte for byte.
+*/
+function ratesVerifiedLine(invoice, snapshot, pricingOf, nowMs) {
+	const dated = [...new Set(invoice.rows.map((row) => row.servedBy))].sort().map((model) => {
+		const pinRow = snapshot?.rows.find((row) => row.model === model);
+		return {
+			model,
+			date: pinRow !== void 0 ? pinRow.rates.ratesVerifiedAt : pricingOf(model)?.ratesVerifiedAt
+		};
+	});
+	if (!dated.some((entry) => entry.date !== void 0)) return;
+	return `rates verified: ${dated.map(({ model, date }) => date === void 0 ? `${model} no date` : `${model} ${date}${ageSuffixOf(date, nowMs)}`).join(", ")}`;
+}
 function renderPreflight(report, io) {
 	io.out("preflight: effective limits and admission projection (zero provider dispatches)");
 	const perProvider = report.concurrency.perProvider;
@@ -1211,7 +1266,7 @@ function renderPreflight(report, io) {
 	io.out(`quota: ${report.quota.configured ? "configured" : "none"}` + (report.quota.tenant === void 0 ? "" : ` tenant=${report.quota.tenant}`) + (report.quota.rules === void 0 ? "" : ` rules=${report.quota.rules}`));
 	io.out(`run limits: ${JSON.stringify(report.runLimits)}`);
 	for (const spawn of report.spawns) {
-		io.out(`spawn '${spawn.label}' role=${spawn.role} x${spawn.count} servedBy=${spawn.servedBy ?? "UNROUTED"}${spawn.unpriced === true ? " (unpriced)" : ""} reserve=${usdOf(spawn.admissionReserveUsd)} (${spawn.reserveSource})` + (spawn.maxOutputTokensPerTurn === void 0 ? "" : ` maxOutput=${spawn.maxOutputTokensPerTurn}`) + (spawn.turnFloorUsd === void 0 ? "" : ` turnFloor=${usdOf(spawn.turnFloorUsd)}`) + ` toolCallCeiling=${spawn.executedToolCallCeiling ?? "unlimited"} projectedTurns=${spawn.projectedProviderTurns}`);
+		io.out(`spawn '${spawn.label}' role=${spawn.role} x${spawn.count} servedBy=${spawn.servedBy ?? "UNROUTED"}${spawn.unpriced === true ? " (unpriced)" : ""}` + (spawn.ratesVerifiedAt === void 0 ? "" : ` ratesVerified=${spawn.ratesVerifiedAt}${ageSuffixOf(spawn.ratesVerifiedAt, Date.now())}`) + ` reserve=${usdOf(spawn.admissionReserveUsd)} (${spawn.reserveSource})` + (spawn.maxOutputTokensPerTurn === void 0 ? "" : ` maxOutput=${spawn.maxOutputTokensPerTurn}`) + (spawn.turnFloorUsd === void 0 ? "" : ` turnFloor=${usdOf(spawn.turnFloorUsd)}`) + ` toolCallCeiling=${spawn.executedToolCallCeiling ?? "unlimited"} projectedTurns=${spawn.projectedProviderTurns}`);
 		io.out(`  limits: ${JSON.stringify(spawn.limits)}`);
 		for (const row of spawn.toolCeilings) {
 			if (row.tool === "(any)" && row.ceiling === null) continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rulvar/cli",
-  "version": "1.119.0",
+  "version": "1.121.0",
   "description": "Rulvar shell: run/resume/runs/inspect/plan/kb commands, TUI progress, createServer, createWorker, OTel exporter.",
   "type": "module",
   "license": "Apache-2.0",
@@ -22,17 +22,17 @@
     "access": "public"
   },
   "dependencies": {
-    "@rulvar/core": "1.119.0"
+    "@rulvar/core": "1.121.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.1",
     "tsdown": "^0.22.14",
     "typescript": "~6.0.3",
-    "@rulvar/store-sqlite": "1.119.0",
-    "@rulvar/testing": "1.119.0",
-    "@rulvar/planner": "1.119.0",
-    "@rulvar/plan": "1.119.0",
-    "@rulvar/evals": "1.119.0"
+    "@rulvar/testing": "1.121.0",
+    "@rulvar/store-sqlite": "1.121.0",
+    "@rulvar/planner": "1.121.0",
+    "@rulvar/plan": "1.121.0",
+    "@rulvar/evals": "1.121.0"
   },
   "bin": {
     "rulvar": "./dist/cli.js"