@rulvar/core 1.213.0 → 1.215.0

package/dist/index.js

@@ -12623,6 +12623,7 @@ async function runAgent(options) {
 				kind: "budget",
 				retryable: false
 			};
+			errorMessage = thrown instanceof Error ? thrown.message : String(thrown);
 			break;
 		}
 		turns += 1;
@@ -12834,12 +12835,13 @@ async function runAgent(options) {
 				});
 				try {
 					options.budget?.beforeTurn();
-				} catch {
+				} catch (thrown) {
 					status = "error";
 					agentError = {
 						kind: "budget",
 						retryable: false
 					};
+					errorMessage = thrown instanceof Error ? thrown.message : String(thrown);
 					endPhase(summarizePhase, "error");
 					break;
 				}
@@ -13006,11 +13008,12 @@ async function runAgent(options) {
 		let proceed = true;
 		try {
 			options.budget?.beforeTurn();
-		} catch {
+		} catch (thrown) {
 			events?.emit({
 				type: "log",
 				level: "warn",
-				msg: "the finalization reserve turn was skipped: the budget blocks further turns"
+				msg: "the finalization reserve turn was skipped: the budget blocks further turns",
+				data: { reason: thrown instanceof Error ? thrown.message : String(thrown) }
 			});
 			proceed = false;
 		}
@@ -13114,12 +13117,13 @@ async function runAgent(options) {
 		let proceed = true;
 		try {
 			options.budget?.beforeTurn();
-		} catch {
+		} catch (thrown) {
 			status = "error";
 			agentError = {
 				kind: "budget",
 				retryable: false
 			};
+			errorMessage = thrown instanceof Error ? thrown.message : String(thrown);
 			proceed = false;
 		}
 		if (proceed) {
@@ -13266,12 +13270,13 @@ async function runAgent(options) {
 		while (status === "ok") {
 			try {
 				options.budget?.beforeTurn();
-			} catch {
+			} catch (thrown) {
 				status = "error";
 				agentError = {
 					kind: "budget",
 					retryable: false
 				};
+				errorMessage = thrown instanceof Error ? thrown.message : String(thrown);
 				break;
 			}
 			turns += 1;
@@ -23931,13 +23936,40 @@ function makeOrchestratorWorkflow(goal, opts) {
 				const stragglers = [...byOrdinal.values()].filter((record) => record.settled === void 0);
 				for (const record of stragglers) record.abort();
 				await Promise.all(stragglers.map((record) => record.result));
-				try {
+				const synthesisTerminalOf = (declined) => {
+					if (!(declined instanceof BudgetExhaustedError)) return;
+					const entryRef = declined.data?.entryRef;
+					if (typeof entryRef !== "number") return;
+					return internals.replayer.snapshot().find((entry) => entry.seq === entryRef);
+				};
+				let synthesisTransportRetried = false;
+				for (;;) try {
 					const synthesized = await runSynthesis(void 0);
 					return {
 						...foldEnvelope(),
 						result: synthesized
 					};
 				} catch (declined) {
+					const terminal = synthesisTerminalOf(declined);
+					if (!synthesisTransportRetried && terminal !== void 0 && terminal.error !== void 0 && terminal.error.data?.kind === "transport" && terminal.error.retryable === true) {
+						synthesisTransportRetried = true;
+						const retryKey = deriverV2.deriveKey({ kind: "orchestrator-synthesis-redemption-retry" });
+						if (!internals.replayer.snapshot().some((entry) => entry.kind === "decision" && entry.key === retryKey)) await internals.replayer.appendSinglePhase({
+							scope: callingState.scope,
+							key: retryKey,
+							kind: "decision",
+							status: "ok",
+							spanId: internals.spans.mint(callingState.spanId),
+							site: "orchestrator-budget",
+							value: {
+								decisionType: "orchestrator_synthesis_redemption_retry",
+								reason: terminal.error.message.slice(0, 300),
+								terminalRef: terminal.seq,
+								remainingUsd: internals.budget.remainingUsd() ?? null
+							}
+						});
+						continue;
+					}
 					const declineKey = deriverV2.deriveKey({ kind: "orchestrator-synthesis-redemption-declined" });
 					if (!internals.replayer.snapshot().some((entry) => entry.kind === "decision" && entry.key === declineKey)) await internals.replayer.appendSinglePhase({
 						scope: callingState.scope,
@@ -23948,9 +23980,11 @@ function makeOrchestratorWorkflow(goal, opts) {
 						site: "orchestrator-budget",
 						value: {
 							decisionType: "orchestrator_synthesis_redemption_declined",
-							reason: declined instanceof Error ? declined.message.slice(0, 300) : String(declined).slice(0, 300),
+							reason: (terminal?.error?.message ?? (declined instanceof Error ? declined.message : String(declined))).slice(0, 300),
+							...terminal === void 0 ? {} : { terminalRef: terminal.seq },
 							remainingUsd: internals.budget.remainingUsd() ?? null,
-							stragglersDrained: stragglers.length
+							stragglersDrained: stragglers.length,
+							transportRetries: synthesisTransportRetried ? 1 : 0
 						}
 					});
 					return foldEnvelope();
@@ -24895,6 +24929,26 @@ function preflightEstimate(input) {
 						});
 					}
 				}
+				{
+					const pricing = pricingOf(servedBy);
+					const declared = input.orchestrator?.budget?.synthesisReserveUsd;
+					if (pricing !== void 0 && outputBound !== void 0 && declared !== void 0 && declared > 0) {
+						const compositionUsd = priceUsdOf(pricing, {
+							inputTokens: synthesis.estInputTokens ?? 0,
+							outputTokens: outputBound,
+							cacheReadTokens: 0,
+							cacheWriteTokens: 0
+						});
+						const repairTurns = finishRepairReserve > 0 ? 1 : 0;
+						const requiredUsd = compositionUsd * (1 + repairTurns);
+						if (declared < requiredUsd) say({
+							severity: "warning",
+							code: "synthesis-reserve-below-cap-composition",
+							message: `a synthesis turn writing to its ${String(outputBound)} token output allowance over the declared ${String(synthesis.estInputTokens ?? 0)} input floor prices about ${compositionUsd.toFixed(4)} USD at the rates of '${servedBy}'` + (repairTurns > 0 ? `, and the declared repair reserve prices one more such turn (about ${requiredUsd.toFixed(4)} USD total)` : "") + `; the committed synthesis reserve holds only ${declared.toFixed(4)} USD, so a composition cut at the allowance can fail its validators with no money left for the granted repair; hold the reserve at the cap arithmetic or lower maxOutputTokensPerTurn`,
+							spawn: "synthesis"
+						});
+					}
+				}
 				const projected = projectedProviderTurnsOf(merged, overallExecutedCeiling(merged, toolCeilingsOf(merged))) + finishRepairReserve;
 				if (orchestratorEcho !== void 0) orchestratorEcho.synthesis = {
 					projectedProviderTurns: projected,

package/package.json

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