@rulvar/core 1.233.0 → 1.234.0

package/dist/index.d.ts

@@ -10633,7 +10633,9 @@ interface OrchestrateSynthesis {
   dedupeClaims?: boolean;
   /**
   * UsageLimits of ONE incremental note invocation; default
-  * { maxTurns: 2 }. Ignored in 'single' mode.
+  * { maxTurns: 2 }. In mode 'single' the declaration is a typed
+  * ConfigError (RV3102): no note invocation exists for the limits to
+  * bound, and until the gate it was silently ignored.
   */
   noteLimits?: UsageLimits;
   /**

package/dist/index.js

@@ -22399,6 +22399,11 @@ function validateOrchestrateOptions(opts) {
 			if (floor && opts.finishValidation === void 0) throw new ConfigError("orchestrate synthesis.fallbackToValidDraft requires finishValidation: without a declared finish contract there is nothing to judge the draft valid by");
 		}
 		if (symmetry.context !== void 0 && symmetry.context !== "digests" && symmetry.context !== "full") throw new ConfigError("orchestrate synthesis.context must be 'digests' or 'full'; got " + JSON.stringify(symmetry.context));
+		if (synthesis.mode === "incremental") {
+			if (symmetry.exposeChildResultTools === true) throw new ConfigError("orchestrate synthesis.exposeChildResultTools is meaningless in mode 'incremental': the deterministic reconciliation dispatches no synthesis to hold the tools");
+			if (symmetry.context === "full") throw new ConfigError("orchestrate synthesis.context 'full' is meaningless in mode 'incremental': the deterministic reconciliation composes no prompt to embed the outputs in");
+			if (synthesis.limits !== void 0) throw new ConfigError("orchestrate synthesis.limits is meaningless in mode 'incremental': no single synthesis invocation exists for the limits to bound; declare noteLimits for the note invocations instead");
+		}
 		const index = synthesis.evidenceIndex;
 		if (index !== void 0) {
 			if (index !== true && (typeof index !== "object" || index === null)) throw new ConfigError(`orchestrate synthesis.evidenceIndex must be true or an object with pattern and flags; got ${JSON.stringify(index)}`);
@@ -22418,7 +22423,10 @@ function validateOrchestrateOptions(opts) {
 				if (probe.test("")) throw new ConfigError("orchestrate synthesis.evidenceIndex.pattern must not be able to match the empty string (an empty match would index fabricated evidence); got " + JSON.stringify(pattern));
 			}
 		}
-		if (synthesis.noteLimits !== void 0) validateUsageLimits(synthesis.noteLimits, "orchestrate synthesis.noteLimits");
+		if (synthesis.noteLimits !== void 0) {
+			validateUsageLimits(synthesis.noteLimits, "orchestrate synthesis.noteLimits");
+			if (synthesis.mode !== "incremental") throw new ConfigError("orchestrate synthesis.noteLimits is meaningless in mode 'single': only 'incremental' dispatches note invocations for the limits to bound");
+		}
 		if (synthesis.effort !== void 0 && ![
 			"low",
 			"medium",
@@ -22430,6 +22438,8 @@ function validateOrchestrateOptions(opts) {
 		if (synthesis.instructions !== void 0 && typeof synthesis.instructions !== "string") throw new ConfigError(`orchestrate synthesis.instructions must be a string; got ${typeof synthesis.instructions}`);
 		const facts = synthesis;
 		if (facts.policyFacts !== void 0 && typeof facts.policyFacts !== "boolean") throw new ConfigError(`orchestrate synthesis.policyFacts must be a boolean; got ${typeof facts.policyFacts}`);
+		if (facts.policyFacts === true && synthesis.mode === "incremental") throw new ConfigError("orchestrate synthesis.policyFacts is meaningless in mode 'incremental': the deterministic reconciliation dispatches no synthesis for the facts to ride");
+		if ((facts.runFacts === true || typeof facts.runFacts === "object" && facts.runFacts !== null) && synthesis.mode === "incremental") throw new ConfigError("orchestrate synthesis.runFacts is meaningless in mode 'incremental': the deterministic reconciliation dispatches no synthesis for the facts to ride");
 		if (facts.runFacts !== void 0 && typeof facts.runFacts !== "boolean") {
 			if (typeof facts.runFacts !== "object" || facts.runFacts === null || Array.isArray(facts.runFacts)) throw new ConfigError(`orchestrate synthesis.runFacts must be a boolean or { workflowSoFar?: boolean }; got ${typeof facts.runFacts}`);
 			const runFactsSpec = facts.runFacts;

package/package.json

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