@rulvar/core 1.208.0 → 1.209.0

package/dist/index.d.ts

@@ -13131,6 +13131,24 @@ interface PreflightSpawnReport {
   * turn grows with the prompt, so this is a floor, never a cap.
   */
   turnFloorUsd?: number;
+  /**
+  * The loop's input floor over its projected turns, UNCACHED
+  * (RV2007): the declared prompt floor (`estInputTokens`) re-billed
+  * at the full input rate on every projected provider turn. A floor
+  * over the static prefix: real prompts grow. Present when the shape
+  * prices and projects more than one turn.
+  */
+  uncachedLoopInputFloorUsd?: number;
+  /**
+  * The same loop under the RV2006 cache policy: one cache write of
+  * the prompt floor plus a cache read on every later turn, priced by
+  * the row's cache rates. Present beside the uncached figure when
+  * the row carries cache rates. The parity worker shape (36k-token
+  * prompt floor, a long cycle) prices the difference at roughly
+  * three to four times, the gap between four seats fitting a $6
+  * envelope and three seats dying against it.
+  */
+  cachedLoopInputFloorUsd?: number;
   /** Executed-call ceiling across any tool mix; null = unlimited. */
   executedToolCallCeiling: number | null;
   /**

package/dist/index.js

@@ -24474,6 +24474,29 @@ function preflightEstimate(input) {
 		const toolCeilings = toolCeilingsOf(limits);
 		const executedToolCallCeiling = overallExecutedCeiling(limits, toolCeilings);
 		const projectedProviderTurns = projectedProviderTurnsOf(limits, executedToolCallCeiling);
+		let uncachedLoopInputFloorUsd;
+		let cachedLoopInputFloorUsd;
+		if (pricing !== void 0 && (spec.estInputTokens ?? 0) > 0 && Number.isFinite(projectedProviderTurns) && projectedProviderTurns > 1) {
+			const loopInputTokens = spec.estInputTokens ?? 0;
+			uncachedLoopInputFloorUsd = projectedProviderTurns * priceUsdOf(pricing, {
+				inputTokens: loopInputTokens,
+				outputTokens: 0,
+				cacheReadTokens: 0,
+				cacheWriteTokens: 0
+			});
+			if (pricing.cacheReadUsdPerMTok !== void 0 && pricing.cacheWriteUsdPerMTok !== void 0) cachedLoopInputFloorUsd = priceUsdOf(pricing, {
+				inputTokens: projectedProviderTurns * loopInputTokens,
+				outputTokens: 0,
+				cacheReadTokens: (projectedProviderTurns - 1) * loopInputTokens,
+				cacheWriteTokens: loopInputTokens
+			});
+		}
+		if (caps?.promptCaching === "explicit" && engine.defaults?.cache?.mode === "off" && uncachedLoopInputFloorUsd !== void 0 && cachedLoopInputFloorUsd !== void 0 && projectedProviderTurns >= 4) say({
+			severity: "warning",
+			code: "uncached-long-loop",
+			message: `spawn '${label}' projects ${String(projectedProviderTurns)} provider turns on the explicit-caching '${servedBy ?? ""}' with the cache policy OFF: the loop's input floor re-bills every turn (${uncachedLoopInputFloorUsd.toFixed(4)} USD uncached against ${cachedLoopInputFloorUsd.toFixed(4)} USD under the default policy); drop defaults.cache { mode: 'off' } or scope the opt-out to the profiles that need it`,
+			spawn: label
+		});
 		for (const row of toolCeilings) {
 			if (row.tool === ANY_TOOL) continue;
 			const cost = limits.toolUnits?.costs?.[row.tool];
@@ -24610,6 +24633,8 @@ function preflightEstimate(input) {
 			reserveSource,
 			...outputBound === void 0 ? {} : { maxOutputTokensPerTurn: outputBound },
 			...turnFloorUsd === void 0 ? {} : { turnFloorUsd },
+			...uncachedLoopInputFloorUsd === void 0 ? {} : { uncachedLoopInputFloorUsd },
+			...cachedLoopInputFloorUsd === void 0 ? {} : { cachedLoopInputFloorUsd },
 			executedToolCallCeiling,
 			projectedProviderTurns,
 			toolCeilings

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rulvar/core",
-  "version": "1.208.0",
+  "version": "1.209.0",
   "description": "Rulvar core: L0 contracts, journal kernel, ctx primitives, agent runtime, model router, tool system, dynamic orchestrator, InMemory and JSONL stores, event stream.",
   "type": "module",
   "license": "Apache-2.0",