@rulvar/core 1.205.0 → 1.206.0

package/dist/index.d.ts

@@ -6758,6 +6758,23 @@ interface BudgetReserve {
   reserveUsd: number;
   /** The child sub-account ceiling; absent when the parent is uncapped. */
   childCeilingUsd?: number;
+  /**
+  * The reserve derivation (RV2004): where reserveUsd came from, so a
+  * journal reader never reverse-engineers the arithmetic. 'estCost'
+  * is the declared estimate (spawn opts or the agentType profile),
+  * 'default' the engine flat reserve.
+  */
+  source?: "estCost" | "default";
+  /**
+  * Set when the derived reserve was clamped DOWN to the child's
+  * ceiling: 'explicit-budget' by a declared budgetUsd,
+  * 'fraction-ceiling' by the childBudgetFraction allowance an ORIGIN
+  * WITH a materialized allowance account enforces (ctx.workflow).
+  * The spawn-tool path never carries 'fraction-ceiling': its
+  * dispatch enforces no fraction account, and journaling that clamp
+  * is exactly the parity rerun's 0.50-versus-0.70 lie (RV2004).
+  */
+  clampedBy?: "explicit-budget" | "fraction-ceiling";
 }
 /** The lineage block every non-reject verdict carries (DEF-3). */
 interface AdmitLineage {
@@ -13096,6 +13113,18 @@ interface PreflightReport {
     * fourth workers. Present whenever the wave has rows.
     */
     requiredMinimumCeilingUsd?: number;
+    /**
+    * The live-root-exposure term of the wave projection (RV2004): the
+    * orchestrator's own worst-case turn floor, the money coordination
+    * has ALWAYS already spent (and holds in flight) by the time any
+    * spawn tool runs. The parity rerun's fourth seat fit the plain
+    * wave (5.95 under 6.00) and was refused live by exactly this
+    * term; the embedded spawn gate and requiredMinimumCeilingUsd now
+    * carry it, so a seat that cannot admit live cannot admit in
+    * preflight either. Present on orchestrate waves whose
+    * coordination turn prices.
+    */
+    liveRootExposureTermUsd?: number;
     wave: PreflightAdmissionRow[];
     admitted: number;
     denied: number;

package/dist/index.js

@@ -16047,15 +16047,27 @@ var AdmissionController = class {
 			},
 			statsBefore
 		};
+		const spawnToolOrigin = spec.origin === "spawn_agent" || spec.origin === "parallel_agents";
 		let childCeilingUsd;
 		const parentRemainder = this.budget.remainderOf(spec.parentAccountScope);
-		if (parentRemainder !== void 0) {
+		if (spawnToolOrigin) {
+			if (spec.budgetUsd !== void 0) childCeilingUsd = spec.budgetUsd;
+		} else if (parentRemainder !== void 0) {
 			const fractionCap = this.childBudgetFraction * parentRemainder;
 			childCeilingUsd = spec.budgetUsd === void 0 ? fractionCap : Math.min(spec.budgetUsd, fractionCap);
 		} else if (spec.budgetUsd !== void 0) childCeilingUsd = spec.budgetUsd;
 		let reserveUsd = spec.estCostUsd ?? this.flatReserveUsd;
-		if (childCeilingUsd !== void 0) reserveUsd = Math.min(reserveUsd, childCeilingUsd);
-		const reserve = { reserveUsd };
+		const source = spec.estCostUsd === void 0 ? "default" : "estCost";
+		let clampedBy;
+		if (childCeilingUsd !== void 0 && reserveUsd > childCeilingUsd) {
+			clampedBy = spec.budgetUsd !== void 0 && childCeilingUsd === spec.budgetUsd ? "explicit-budget" : "fraction-ceiling";
+			reserveUsd = childCeilingUsd;
+		}
+		const reserve = {
+			reserveUsd,
+			source
+		};
+		if (clampedBy !== void 0) reserve.clampedBy = clampedBy;
 		if (childCeilingUsd !== void 0) reserve.childCeilingUsd = childCeilingUsd;
 		if (this.budget.spawnHeadroom <= 0) return {
 			verdict: {
@@ -24726,6 +24738,7 @@ function preflightEstimate(input) {
 	}
 	const maxSpawns = input.orchestrator?.maxSpawns;
 	const orchestrateWave = input.orchestrator !== void 0;
+	const liveRootExposureTermUsd = orchestrateWave ? units.find((unit) => unit.label === "orchestrator")?.turnFloorUsd ?? 0 : 0;
 	for (const [reportIndex, report] of spawnReports.entries()) {
 		const gate = waveGateInputs[reportIndex] ?? {};
 		for (let i = 0; i < report.count; i += 1) {
@@ -24736,7 +24749,7 @@ function preflightEstimate(input) {
 			else if (maxSpawns !== void 0 && children >= maxSpawns) deniedBy = "orchestrator-max-spawns";
 			else {
 				if (orchestrateWave && ceilingUsd !== void 0) {
-					const remainder = ceilingUsd - heldAgainstRoot();
+					const remainder = ceilingUsd - heldAgainstRoot() - liveRootExposureTermUsd;
 					const projection = dispatchProjectionReserveUsd(gate, flatReserveUsd);
 					if (remainder <= 0 || remainder <= projection) deniedBy = "budget";
 				}
@@ -24758,7 +24771,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;
+	const requiredMinimumCeilingUsd = wave.length === 0 ? void 0 : wave.reduce((sum, row) => sum + row.reserveUsd, 0) + reservedForFinalizationUsd + synthesisHoldUsd + liveRootExposureTermUsd;
 	if (wave.length > 0 && denied > 0) {
 		const deniedLabels = wave.filter((row) => !row.admitted).map((row) => row.label);
 		if (admitted === 0) say({
@@ -25016,6 +25029,7 @@ function preflightEstimate(input) {
 			reservedForFinalizationUsd,
 			synthesisReserveUsd: synthesisHoldUsd,
 			...requiredMinimumCeilingUsd === void 0 ? {} : { requiredMinimumCeilingUsd },
+			...liveRootExposureTermUsd > 0 ? { liveRootExposureTermUsd } : {},
 			wave,
 			admitted,
 			denied

package/package.json

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