@vaudience/aigentflow-flow-validator 0.18.0 → 0.19.0

package/PARITY.md

@@ -4,8 +4,21 @@ This document maps every rule in this JavaScript validator back to the AIgentFlo
 Go reference implementation, records the intentional divergences, and defines the
 discipline for keeping the two in sync.
 
-**Tracks AIgentFlow flow schema: `v2.819.0`** (`SPEC_VERSION` in [`src/spec/aigentflow-spec.json`](./src/spec/aigentflow-spec.json)), which removes the AigentChat executor (package 0.18.0, below). Earlier additions: the `examples:` block (package 0.17.0), `server_owned_query_key` (package 0.15.1) from the AIgentFlow release after v2.790.0, `credential_endpoint_unpaired` (package 0.15.2) from AIgentFlow v2.793.0 and the release after it, and `display_name_too_long` (package 0.15.3) from AIgentFlow v2.802.0.
-
+**Tracks AIgentFlow flow schema: `v2.820.0`** (`SPEC_VERSION` in [`src/spec/aigentflow-spec.json`](./src/spec/aigentflow-spec.json)), which adds `orchestrator.region` / `orchestrator.enforce_region` (package 0.19.0, below). Earlier: the AigentChat executor was removed (package 0.18.0). Earlier additions: the `examples:` block (package 0.17.0), `server_owned_query_key` (package 0.15.1) from the AIgentFlow release after v2.790.0, `credential_endpoint_unpaired` (package 0.15.2) from AIgentFlow v2.793.0 and the release after it, and `display_name_too_long` (package 0.15.3) from AIgentFlow v2.802.0.
+
+> package 0.19.0 — **`orchestrator.region` and `orchestrator.enforce_region`**, in step
+> with the reference (AIgentFlow v2.820.0; `specVersion` 2.820.0). Both are new keys of
+> the `orchestrator:` block (a `string` and a `bool`), added to the known-key table.
+> One rule ported: `enforce_region: true` with an absent, null, empty or
+> whitespace-only `region` is an **error**, `orchestrator_enforce_region_needs_region`
+> (field `orchestrator.enforce_region`), because the provider would refuse every turn.
+> The reference raises it from its parser's orchestrator validation as a plain
+> flow-validation error with no machine-readable code; this package's code and field
+> are its own naming, the same as for `orchestrator_mode_invalid`. Only a YAML boolean
+> `true` arms the rule. The runtime effect (the region reaching the provider request) is
+> engine behaviour and out of scope. New conformance fixtures:
+> `valid-orchestrator-region.yaml`, `invalid-orchestrator-enforce-region-no-region.yaml`.
+>
 > package 0.18.0 — **the AigentChat executor is removed**, in step with the reference
 > (AIgentFlow v2.819.0; `specVersion` 2.819.0). The reference no longer registers the
 > `nexus://` protocol or its `aigentchat://` alias, so the spec drops: `nexus` from

package/README.md

@@ -116,7 +116,7 @@ Low-level: parse YAML into `{ flow?, parseErrors, parseWarnings }` without valid
 
 ### `SPEC_VERSION: string`
 
-The AIgentFlow flow-schema version this build tracks (e.g. `"2.819.0"`).
+The AIgentFlow flow-schema version this build tracks (e.g. `"2.820.0"`).
 
 ### Options
 

package/dist/cli.js

@@ -436,7 +436,7 @@ function validateBasicStructure(flow, issues) {
 // src/spec/aigentflow-spec.json
 var aigentflow_spec_default = {
   $comment: "Vendored enum surface mirrored from the AIgentFlow Go reference implementation. Regenerate / review on every flow-YAML schema change. See PARITY.md. Values here are public protocol/type names only.",
-  specVersion: "2.819.0",
+  specVersion: "2.820.0",
   inputSchemaVersion: 1,
   executorSchemes: [
     "a2a",
@@ -1726,6 +1726,7 @@ var aigentflow_spec_default = {
         deny_tools: "list<scalar>",
         discoverable_tools: "list<scalar>",
         enable_signals: "scalar",
+        enforce_region: "scalar",
         engram_scope: "scalar",
         exons: "scalar",
         human_question_timeout: "scalar",
@@ -1734,6 +1735,7 @@ var aigentflow_spec_default = {
         max_tool_turns: "scalar",
         max_turns: "scalar",
         mode: "scalar",
+        region: "scalar",
         require_approval_for: "list<scalar>",
         timeout_seconds: "scalar",
         tool_discovery: "scalar",
@@ -3157,6 +3159,17 @@ function validateOrchestratorCampaign(flow, issues, opts) {
         code: "orchestrator_owner_needs_yield"
       });
     }
+    if (orch.enforce_region === true) {
+      const region = issues.stringOf(orch, "region", "orchestrator");
+      if (region === null || region.trim() === "") {
+        issues.error({
+          field: "orchestrator.enforce_region",
+          message: "orchestrator: enforce_region requires region (name the region the model must run in, e.g. region: eu)",
+          code: "orchestrator_enforce_region_needs_region",
+          suggestion: "Add `region: eu` (or the region the model must run in), or drop enforce_region"
+        });
+      }
+    }
     if (Array.isArray(orch.triggers)) {
       orch.triggers.forEach((rawTrigger, i) => {
         if (!isRecord(rawTrigger)) return;

package/dist/index.cjs

@@ -432,7 +432,7 @@ function validateBasicStructure(flow, issues) {
 
 // src/spec/aigentflow-spec.json
 var aigentflow_spec_default = {
-  specVersion: "2.819.0",
+  specVersion: "2.820.0",
   inputSchemaVersion: 1,
   executorSchemes: [
     "a2a",
@@ -1644,6 +1644,7 @@ var aigentflow_spec_default = {
         deny_tools: "list<scalar>",
         discoverable_tools: "list<scalar>",
         enable_signals: "scalar",
+        enforce_region: "scalar",
         engram_scope: "scalar",
         exons: "scalar",
         human_question_timeout: "scalar",
@@ -1652,6 +1653,7 @@ var aigentflow_spec_default = {
         max_tool_turns: "scalar",
         max_turns: "scalar",
         mode: "scalar",
+        region: "scalar",
         require_approval_for: "list<scalar>",
         timeout_seconds: "scalar",
         tool_discovery: "scalar",
@@ -3064,6 +3066,17 @@ function validateOrchestratorCampaign(flow, issues, opts) {
         code: "orchestrator_owner_needs_yield"
       });
     }
+    if (orch.enforce_region === true) {
+      const region = issues.stringOf(orch, "region", "orchestrator");
+      if (region === null || region.trim() === "") {
+        issues.error({
+          field: "orchestrator.enforce_region",
+          message: "orchestrator: enforce_region requires region (name the region the model must run in, e.g. region: eu)",
+          code: "orchestrator_enforce_region_needs_region",
+          suggestion: "Add `region: eu` (or the region the model must run in), or drop enforce_region"
+        });
+      }
+    }
     if (Array.isArray(orch.triggers)) {
       orch.triggers.forEach((rawTrigger, i) => {
         if (!isRecord(rawTrigger)) return;