@rulvar/core 1.214.0 → 1.216.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;
@@ -19826,6 +19831,14 @@ const DEFAULT_CITATION_PATTERN = "[\\w./-]+\\.\\w+:\\d+";
 /** The default preserved share, the improvement plan's RV-202 gate. */
 const DEFAULT_EVIDENCE_MIN_SHARE = .95;
 const MAX_LISTED_CITATIONS = 20;
+/**
+* The evidence-grade verdict names its offending sentences (RV2105):
+* bounded so a document written entirely in the graded register cannot
+* balloon the journaled verdict or the repair prompt, truncated per
+* sentence for the same reason.
+*/
+const MAX_NAMED_OFFENDING_SENTENCES = 5;
+const MAX_OFFENDING_SENTENCE_CHARS = 240;
 function listCitations(values) {
 	return values.length <= MAX_LISTED_CITATIONS ? values.join(", ") : `${values.slice(0, MAX_LISTED_CITATIONS).join(", ")} and ${String(values.length - MAX_LISTED_CITATIONS)} more`;
 }
@@ -20043,15 +20056,27 @@ function evidenceGradeValidator(options) {
 		name: options?.name ?? "evidence-grade",
 		validate: (input) => {
 			const unsupported = [];
+			const offenders = [];
 			for (const sentence of sentencesOf(input.text)) {
 				const haystack = sentence.toLowerCase();
 				const found = lowered.filter((phrase) => haystack.includes(phrase));
 				if (found.length === 0 || new RegExp(artifactPattern, "").test(sentence)) continue;
+				offenders.push(sentence);
 				for (const phrase of found) if (!unsupported.includes(phrase)) unsupported.push(phrase);
 			}
-			return unsupported.length === 0 ? ok : {
+			if (unsupported.length === 0) return ok;
+			const named = offenders.slice(0, MAX_NAMED_OFFENDING_SENTENCES).map((sentence) => {
+				const flat = sentence.replace(/\s+/gu, " ").trim();
+				return `offending sentence: "${flat.length <= MAX_OFFENDING_SENTENCE_CHARS ? flat : `${flat.slice(0, MAX_OFFENDING_SENTENCE_CHARS)}...`}"`;
+			});
+			const overflow = offenders.length - named.length;
+			return {
 				ok: false,
-				reasons: [`evidence-grade claims cite no run or repro artifact in their own sentence: ${listCitations(unsupported)}; each such claim must name a run id or a file:line citation beside it`]
+				reasons: [
+					`evidence-grade claims cite no run or repro artifact in their own sentence: ${listCitations(unsupported)}; each such claim must name a run id or a file:line citation beside it`,
+					...named,
+					...overflow > 0 ? [`and ${String(overflow)} more offending sentences`] : []
+				]
 			};
 		}
 	};
@@ -24924,6 +24949,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.214.0",
+  "version": "1.216.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",