@rulvar/core 1.198.0 → 1.199.0

package/dist/index.d.ts

@@ -12973,6 +12973,15 @@ interface PreflightReport {
     * synthesis reserve, matching the runtime that then commits none.
     */
     synthesisReserveUsd: number;
+    /**
+    * The smallest run ceiling that seats the WHOLE declared wave
+    * (RV1907): every row's reserve plus the finalization and synthesis
+    * carve-outs. Children admit strictly below exact fill, so a viable
+    * ceiling must sit strictly ABOVE this figure; the four-role
+    * benchmark's $6.00 sat $0.98 below it and lost its third and
+    * fourth workers. Present whenever the wave has rows.
+    */
+    requiredMinimumCeilingUsd?: number;
     wave: PreflightAdmissionRow[];
     admitted: number;
     denied: number;
@@ -12985,7 +12994,18 @@ interface PreflightReport {
     * documented overshoot bound is one turn per in-flight agent; real
     * turns grow with the prompt, so this is the floor of that bound.
     */
-    overshootOneTurnFloorUsd?: number; /** Per-provider first-wave demand at the declared estimates. */
+    overshootOneTurnFloorUsd?: number;
+    /**
+    * The smallest in-flight exposure cap under which the declared wave
+    * can breathe (RV1907): the finalization and synthesis carve-outs
+    * plus the turn floors of the maxInFlight most expensive declared
+    * dispatches, the orchestrator's own turn among them. Below it the
+    * root's next turn is refused beside a full child wave, the
+    * recovery arm's exact death; the RV1902 wait recovers the run, but
+    * only a cap at or above this floor avoids the stall entirely.
+    * Absent when no declared turn prices.
+    */
+    requiredMinimumExposureUsd?: number; /** Per-provider first-wave demand at the declared estimates. */
     perProvider: Record<string, {
       inFlight: number;
       requestsPerWave: number;

package/dist/index.js

@@ -24550,6 +24550,7 @@ function preflightEstimate(input) {
 	}
 	const admitted = wave.filter((row) => row.admitted).length;
 	const denied = wave.length - admitted;
+	const requiredMinimumCeilingUsd = wave.length === 0 ? void 0 : wave.reduce((sum, row) => sum + row.reserveUsd, 0) + reservedForFinalizationUsd + synthesisHoldUsd;
 	if (wave.length > 0 && denied > 0) {
 		const deniedLabels = wave.filter((row) => !row.admitted).map((row) => row.label);
 		if (admitted === 0) say({
@@ -24614,6 +24615,12 @@ function preflightEstimate(input) {
 		code: "in-flight-exposure-cap",
 		message: `RunOptions.maxInFlightExposureUsd ${exposureCapUsd.toFixed(4)} USD bounds spent money plus live dispatch estimates: a dispatch whose estimate does not fit is refused typed before the provider call, so the worst concurrent overshoot past the cap is the estimate error of the in-flight turns, not one whole turn per agent`
 	});
+	const requiredMinimumExposureUsd = overshootOneTurnFloorUsd === void 0 ? void 0 : reservedForFinalizationUsd + synthesisHoldUsd + overshootOneTurnFloorUsd;
+	if (exposureCapUsd !== void 0 && overshootOneTurnFloorUsd !== void 0 && requiredMinimumExposureUsd !== void 0 && requiredMinimumExposureUsd > exposureCapUsd) say({
+		severity: "warning",
+		code: "exposure-cap-tight",
+		message: `maxInFlightExposureUsd ${exposureCapUsd.toFixed(4)} USD sits below the declared wave's breathing floor ${requiredMinimumExposureUsd.toFixed(4)} USD (finalize + synthesis reserves ${(reservedForFinalizationUsd + synthesisHoldUsd).toFixed(4)} plus the ${String(pricedTurns.length)} most expensive concurrent turn floors ${overshootOneTurnFloorUsd.toFixed(4)}): a coordinating turn beside a full child wave will be refused pre-wire and park until a hold releases (RV1902); raise the cap to at least the floor to avoid the stall entirely`
+	});
 	const quotaConfigured = engine.quota !== void 0;
 	if (!quotaConfigured && maxInFlight > 1 && units.length > 0) say({
 		severity: "info",
@@ -24800,6 +24807,7 @@ function preflightEstimate(input) {
 			...ceilingUsd === void 0 ? {} : { ceilingUsd },
 			reservedForFinalizationUsd,
 			synthesisReserveUsd: synthesisHoldUsd,
+			...requiredMinimumCeilingUsd === void 0 ? {} : { requiredMinimumCeilingUsd },
 			wave,
 			admitted,
 			denied
@@ -24807,6 +24815,7 @@ function preflightEstimate(input) {
 		exposure: {
 			maxInFlight,
 			...overshootOneTurnFloorUsd === void 0 ? {} : { overshootOneTurnFloorUsd },
+			...requiredMinimumExposureUsd === void 0 ? {} : { requiredMinimumExposureUsd },
 			perProvider,
 			...runCeiling === void 0 ? {} : { runCeiling }
 		},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rulvar/core",
-  "version": "1.198.0",
+  "version": "1.199.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",