@vaudience/aigentflow-flow-validator 0.20.0 → 0.21.0

package/dist/index.d.cts

@@ -256,6 +256,7 @@ interface Flow {
     input_schema?: InputSchema;
     classification?: Record<string, unknown>;
     is_template?: boolean;
+    strict_templates?: boolean;
     template?: Record<string, unknown> | null;
     [key: string]: unknown;
 }

package/dist/index.d.ts

@@ -256,6 +256,7 @@ interface Flow {
     input_schema?: InputSchema;
     classification?: Record<string, unknown>;
     is_template?: boolean;
+    strict_templates?: boolean;
     template?: Record<string, unknown> | null;
     [key: string]: unknown;
 }

package/dist/index.js

@@ -302,6 +302,17 @@ function isValidGoDuration(input) {
 var RESERVED_STEP_ID_CHAR = ".";
 var RESERVED_STEP_ID_ORCHESTRATOR = "orchestrator";
 var DISPLAY_NAME_MAX_LEN = 80;
+var YAML11_BOOL_WORDS = new Set(
+  ["y", "yes", "on", "n", "no", "off"].flatMap((w) => [
+    w,
+    w.toUpperCase(),
+    w[0].toUpperCase() + w.slice(1)
+  ])
+);
+function isBoolLike(v) {
+  if (v === null || typeof v === "boolean") return true;
+  return typeof v === "string" && YAML11_BOOL_WORDS.has(v);
+}
 function validateBasicStructure(flow, issues) {
   if (!issues.nonEmptyStringOf(flow, "aigentflow_version", "")) {
     issues.error({
@@ -331,6 +342,14 @@ function validateBasicStructure(flow, issues) {
       });
     }
   }
+  if (flow.strict_templates !== void 0 && !isBoolLike(flow.strict_templates)) {
+    issues.error({
+      field: "strict_templates",
+      message: "strict_templates must be a boolean (true or false)",
+      code: "invalid_type",
+      suggestion: "Write 'strict_templates: true' or remove the key"
+    });
+  }
   const start = issues.stringOf(flow, "start", "");
   if (start === null || start === "") {
     issues.error({
@@ -430,7 +449,7 @@ function validateBasicStructure(flow, issues) {
 
 // src/spec/aigentflow-spec.json
 var aigentflow_spec_default = {
-  specVersion: "2.821.0",
+  specVersion: "2.827.0",
   inputSchemaVersion: 1,
   executorSchemes: [
     "a2a",
@@ -454,6 +473,7 @@ var aigentflow_spec_default = {
     "geocoding",
     "geovisualize",
     "getmd",
+    "here",
     "homeassistant",
     "hosting",
     "http",
@@ -1255,6 +1275,11 @@ var aigentflow_spec_default = {
       }
     }
   },
+  templateDefaultPiped: {
+    code: "template_default_piped",
+    messageFormat: "`default` takes the value FIRST, and a pipe passes the piped value LAST: `%s` is `default <fallback> <value>`, so the fallback is always the result",
+    suggestion: 'write the value first and the fallback second, as a call: `{{ default .x "fallback" }}`'
+  },
   complianceResidency: {
     code: "compliance_residency_unenforced",
     euResidencyCodes: ["EU", "DE", "FR", "IE", "NL", "IT", "ES"],
@@ -1553,6 +1578,7 @@ var aigentflow_spec_default = {
         rate_limit: "FlowRateLimitConfig",
         start: "scalar",
         steps: "map<StepDefinition>",
+        strict_templates: "scalar",
         tags: "list<scalar>",
         template: "FlowTemplateMetadata",
         tool_discovery: "scalar",
@@ -1914,6 +1940,11 @@ var EXAMPLES = {
     name: p.name,
     re: new RegExp(p.expr, p.flags)
   }))};
+var TEMPLATE_DEFAULT_PIPED = {
+  code: aigentflow_spec_default.templateDefaultPiped.code,
+  messageFormat: aigentflow_spec_default.templateDefaultPiped.messageFormat,
+  suggestion: aigentflow_spec_default.templateDefaultPiped.suggestion
+};
 
 // src/validators/executors.ts
 var SCHEME_SEPARATOR = "://";
@@ -3877,6 +3908,117 @@ function splitPipeline(body) {
   return stages;
 }
 
+// src/template/gotmpl-default.ts
+var FUNCTION_NAME = "default";
+var PIPE = "|";
+var OPEN_PAREN = "(";
+var CLOSE_PAREN = ")";
+var MAX_NESTING_DEPTH = 100;
+var PIPELINE_KEYWORDS = /^(?:else\s+if|else\s+with|if|range|with|template|block)(?![\w$.])/;
+var NO_PIPELINE = /^(?:define|else|end|break|continue)(?![\w$.])/;
+var DECLARATION = /^\$\w*(?:\s*,\s*\$\w*)*\s*:?=/;
+function pipedDefaultPipelines(src) {
+  const { actions, fatal } = lexActions(src);
+  if (fatal) return [];
+  const found = /* @__PURE__ */ new Set();
+  try {
+    for (const action of actions) {
+      if (action.isComment || action.body === "") continue;
+      scanAction(action.body, found);
+    }
+  } catch (err) {
+    if (!(err instanceof RangeError)) throw err;
+    return [];
+  }
+  return [...found].sort();
+}
+function scanAction(body, found) {
+  let rest = body;
+  const kw = PIPELINE_KEYWORDS.exec(rest);
+  if (!kw && NO_PIPELINE.test(rest)) return;
+  if (kw) {
+    rest = rest.slice(kw[0].length).trimStart();
+    const keyword = kw[0].replace(/\s+/g, " ");
+    if (keyword === "template" || keyword === "block") {
+      const q2 = rest[0];
+      if (q2 === '"' || q2 === "`") {
+        const end = scanString(rest, 0, q2);
+        if (end === -1) return;
+        rest = rest.slice(end + 1).trimStart();
+      }
+    }
+  }
+  if (rest === "") return;
+  parsePipeline(rest, 0, false, found, 0);
+}
+function parsePipeline(src, start, nested, found, depth) {
+  if (depth > MAX_NESTING_DEPTH) return { text: src.slice(start), end: src.length };
+  let i = start;
+  const n = src.length;
+  let decl = "";
+  const decMatch = DECLARATION.exec(src.slice(i));
+  if (decMatch) {
+    decl = decMatch[0].replace(/\s+/g, " ") + " ";
+    i += decMatch[0].length;
+  }
+  const commands = [];
+  let current = [];
+  let firstWords = [];
+  let pipedDefault = false;
+  const pushCommand = () => {
+    if (current.length > 0) {
+      commands.push(current);
+      firstWords.push(current[0]);
+    }
+    current = [];
+  };
+  while (i < n) {
+    const c = src[i];
+    if (c === " " || c === "	" || c === "\n" || c === "\r") {
+      i += 1;
+      continue;
+    }
+    if (c === '"' || c === "`" || c === "'") {
+      const end = scanString(src, i, c);
+      const stop = end === -1 ? n - 1 : end;
+      current.push(src.slice(i, stop + 1));
+      i = stop + 1;
+      continue;
+    }
+    if (c === OPEN_PAREN) {
+      const inner = parsePipeline(src, i + 1, true, found, depth + 1);
+      current.push(`(${inner.text})`);
+      i = inner.end;
+      continue;
+    }
+    if (c === CLOSE_PAREN) {
+      if (nested) {
+        i += 1;
+        break;
+      }
+      i += 1;
+      continue;
+    }
+    if (c === PIPE) {
+      pushCommand();
+      i += 1;
+      continue;
+    }
+    let j = i;
+    while (j < n && !/[\s|()"`']/.test(src[j])) j += 1;
+    if (j === i) j = i + 1;
+    current.push(src.slice(i, j));
+    i = j;
+  }
+  pushCommand();
+  firstWords.forEach((word, idx) => {
+    if (idx > 0 && word === FUNCTION_NAME) pipedDefault = true;
+  });
+  const text = decl + commands.map((cmd) => cmd.join(" ")).join(` ${PIPE} `);
+  if (pipedDefault) found.add(text);
+  return { text, end: i };
+}
+
 // src/validators/processingOperations.ts
 var PROCESSING_OP_GUARD_KEY = PROCESSING_OPERATIONS.guardKey;
 var PROCESSING_PHASES = ["pre_processing", "post_processing"];
@@ -4023,6 +4165,17 @@ function checkTemplateString(value, field, stepID, issues, stats, opts, demote =
       });
     }
   }
+  if (errors.length > 0) return;
+  for (const pipe of pipedDefaultPipelines(value)) {
+    report({
+      field,
+      message: TEMPLATE_DEFAULT_PIPED.messageFormat.replace("%s", () => pipe),
+      code: TEMPLATE_DEFAULT_PIPED.code,
+      stepId: stepID,
+      context: `Template: ${value}`,
+      suggestion: TEMPLATE_DEFAULT_PIPED.suggestion
+    });
+  }
 }
 function walkStrings2(basePath, value, stepID, issues, stats, opts, check, demote = false) {
   if (isString(value)) {