@q1k-oss/behaviour-tree-workflows 0.0.5 → 0.0.7

package/dist/index.cjs

@@ -758,6 +758,7 @@ var CompositeNode = class extends BaseNode {
 };
 
 // src/blackboard.ts
+var import_safe_stable_stringify = __toESM(require("safe-stable-stringify"), 1);
 var ScopedBlackboard = class _ScopedBlackboard {
   data = {};
   parent = null;
@@ -879,7 +880,7 @@ var ScopedBlackboard = class _ScopedBlackboard {
     const prefix = "  ".repeat(indent);
     console.log(`${prefix}Scope: ${this.scopeName}`);
     for (const [key, value] of Object.entries(this.data)) {
-      console.log(`${prefix}  ${key}: ${JSON.stringify(value)}`);
+      console.log(`${prefix}  ${key}: ${(0, import_safe_stable_stringify.default)(value)}`);
     }
     for (const [_name, childScope] of this.childScopes) {
       childScope.debug(indent + 1);
@@ -1128,10 +1129,10 @@ var Conditional = class extends CompositeNode {
   async executeTick(context) {
     checkSignal(context.signal);
     if (!this.condition) {
-      throw new Error("Conditional requires at least a condition child");
+      throw new ConfigurationError("Conditional requires at least a condition child");
     }
     if (!this.thenBranch) {
-      throw new Error(
+      throw new ConfigurationError(
         "Conditional requires at least condition and then branch"
       );
     }
@@ -1160,7 +1161,7 @@ var Conditional = class extends CompositeNode {
           this._status = "RUNNING" /* RUNNING */;
           return "RUNNING" /* RUNNING */;
         default:
-          throw new Error(
+          throw new ConfigurationError(
             `Unexpected status from condition: ${conditionStatus}`
           );
       }
@@ -1168,7 +1169,7 @@ var Conditional = class extends CompositeNode {
       this.log("Condition already evaluated - continuing branch execution");
     }
     if (!this.selectedBranch) {
-      throw new Error("No branch selected for execution");
+      throw new ConfigurationError("No branch selected for execution");
     }
     const branchStatus = await this.selectedBranch.tick(context);
     this._status = branchStatus;
@@ -1193,6 +1194,161 @@ var Conditional = class extends CompositeNode {
 };
 
 // src/composites/for-each.ts
+var import_dlv2 = __toESM(require("dlv"), 1);
+var import_safe_stable_stringify3 = __toESM(require("safe-stable-stringify"), 1);
+
+// src/utilities/variable-resolver.ts
+var import_dlv = __toESM(require("dlv"), 1);
+var import_safe_stable_stringify2 = __toESM(require("safe-stable-stringify"), 1);
+function parsePath(path2) {
+  const segments = [];
+  let current = "";
+  for (let i = 0; i < path2.length; i++) {
+    const ch = path2[i];
+    if (ch === "." || ch === "[") {
+      if (current) segments.push(current);
+      current = "";
+    } else if (ch === "]") {
+      if (current) segments.push(current);
+      current = "";
+    } else {
+      current += ch;
+    }
+  }
+  if (current) segments.push(current);
+  return segments;
+}
+var VARIABLE_PATTERN = /\$\{(input|bb|env|param)\.([a-zA-Z0-9_.\[\]]+)\}|\$\{([a-zA-Z0-9_.\[\]]+)\}/g;
+var HAS_VARIABLE_PATTERN = /\$\{(input|bb|env|param)\.([a-zA-Z0-9_.\[\]]+)\}|\$\{([a-zA-Z0-9_.\[\]]+)\}/;
+var FULL_MATCH_PATTERN = /^\$\{(input|bb|env|param)\.([a-zA-Z0-9_.\[\]]+)\}$|^\$\{([a-zA-Z0-9_.\[\]]+)\}$/;
+var safeProcessEnv = () => {
+  try {
+    return typeof process !== "undefined" && process?.env ? process.env : {};
+  } catch {
+    return {};
+  }
+};
+function resolveString(str, ctx, opts = {}) {
+  const { preserveUndefined = true, envSource = safeProcessEnv() } = opts;
+  const fullMatch = str.match(FULL_MATCH_PATTERN);
+  if (fullMatch) {
+    const namespace = fullMatch[1];
+    const namespacedKey = fullMatch[2];
+    const simpleKey = fullMatch[3];
+    const key = namespacedKey || simpleKey;
+    const ns = namespace || "bb";
+    if (key) {
+      const value = resolveVariable(ns, key, ctx, envSource);
+      if (value !== void 0) {
+        return value;
+      }
+      return preserveUndefined ? str : void 0;
+    }
+  }
+  return str.replace(VARIABLE_PATTERN, (match, namespace, namespacedKey, simpleKey) => {
+    const key = namespacedKey || simpleKey;
+    const ns = namespace || "bb";
+    const value = resolveVariable(ns, key, ctx, envSource);
+    if (value === void 0) {
+      return preserveUndefined ? match : "";
+    }
+    if (value === null) {
+      return "null";
+    }
+    if (typeof value === "object") {
+      return (0, import_safe_stable_stringify2.default)(value) ?? String(value);
+    }
+    return String(value);
+  });
+}
+function resolveValue(value, ctx, opts = {}) {
+  if (typeof value === "string") {
+    return resolveString(value, ctx, opts);
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => resolveValue(item, ctx, opts));
+  }
+  if (value !== null && typeof value === "object") {
+    const resolved = {};
+    for (const [key, val] of Object.entries(value)) {
+      resolved[key] = resolveValue(val, ctx, opts);
+    }
+    return resolved;
+  }
+  return value;
+}
+function resolveVariable(namespace, key, ctx, envSource) {
+  switch (namespace) {
+    case "input":
+      return getNestedValue(ctx.input, key);
+    case "bb":
+      return getNestedBlackboardValue(ctx.blackboard, key);
+    case "env":
+      return envSource[key];
+    case "param":
+      if (ctx.testData) {
+        const parts = parsePath(key);
+        const firstPart = parts[0];
+        if (firstPart) {
+          const value = ctx.testData.get(firstPart);
+          if (parts.length === 1) return value;
+          if (value === void 0 || value === null || typeof value !== "object") return void 0;
+          return (0, import_dlv.default)(value, parts.slice(1));
+        }
+      }
+      return void 0;
+    default:
+      return getNestedBlackboardValue(ctx.blackboard, key);
+  }
+}
+function getNestedValue(obj, path2) {
+  if (obj === void 0 || obj === null || typeof obj !== "object") {
+    return void 0;
+  }
+  return (0, import_dlv.default)(obj, parsePath(path2));
+}
+function getNestedBlackboardValue(blackboard, path2) {
+  const parts = parsePath(path2);
+  const firstPart = parts[0];
+  if (!firstPart) {
+    return void 0;
+  }
+  const value = blackboard.get(firstPart);
+  if (parts.length === 1) {
+    return value;
+  }
+  if (value === void 0 || value === null || typeof value !== "object") {
+    return void 0;
+  }
+  return (0, import_dlv.default)(value, parts.slice(1));
+}
+function hasVariables(str) {
+  return HAS_VARIABLE_PATTERN.test(str);
+}
+function extractVariables(str) {
+  const variables = [];
+  const pattern = /\$\{(input|bb|env|param)\.([a-zA-Z0-9_.\[\]]+)\}|\$\{([a-zA-Z0-9_.\[\]]+)\}/g;
+  let match;
+  while ((match = pattern.exec(str)) !== null) {
+    const namespace = match[1] || "bb";
+    const key = match[2] || match[3];
+    if (key) {
+      variables.push({ namespace, key });
+    }
+  }
+  return variables;
+}
+
+// src/composites/for-each.ts
+function resolveFromBlackboard(blackboard, path2) {
+  const parts = parsePath(path2);
+  const firstPart = parts[0];
+  if (!firstPart) return void 0;
+  const value = blackboard.get(firstPart);
+  if (parts.length === 1) return value;
+  if (value === void 0 || value === null || typeof value !== "object") return void 0;
+  return (0, import_dlv2.default)(value, parts.slice(1));
+}
 var ForEach = class extends CompositeNode {
   collectionKey;
   itemKey;
@@ -1216,14 +1372,14 @@ var ForEach = class extends CompositeNode {
         "ForEach requires at least one child (body)"
       );
     }
-    const collection = context.blackboard.get(this.collectionKey);
+    const collection = this.collectionKey.includes(".") || this.collectionKey.includes("[") ? resolveFromBlackboard(context.blackboard, this.collectionKey) : context.blackboard.get(this.collectionKey);
     if (!collection) {
       this.log(`Collection '${this.collectionKey}' not found in blackboard`);
       this._status = "FAILURE" /* FAILURE */;
       return "FAILURE" /* FAILURE */;
     }
     if (!Array.isArray(collection)) {
-      throw new Error(`Collection '${this.collectionKey}' is not an array`);
+      throw new ConfigurationError(`Collection '${this.collectionKey}' is not an array`);
     }
     if (collection.length === 0) {
       this.log("Collection is empty - returning SUCCESS");
@@ -1241,7 +1397,7 @@ var ForEach = class extends CompositeNode {
         context.blackboard.set(this.indexKey, this.currentIndex);
       }
       this.log(
-        `Processing item ${this.currentIndex}: ${JSON.stringify(item)}`
+        `Processing item ${this.currentIndex}: ${(0, import_safe_stable_stringify3.default)(item)}`
       );
       const bodyStatus = await body.tick(context);
       switch (bodyStatus) {
@@ -1261,7 +1417,7 @@ var ForEach = class extends CompositeNode {
           return "RUNNING" /* RUNNING */;
         // Will resume from this index next tick
         default:
-          throw new Error(`Unexpected status from body: ${bodyStatus}`);
+          throw new ConfigurationError(`Unexpected status from body: ${bodyStatus}`);
       }
     }
     this.log("All items processed successfully");
@@ -1291,7 +1447,7 @@ var Sequence = class extends CompositeNode {
       checkSignal(context.signal);
       const child = this._children[this.currentChildIndex];
       if (!child) {
-        throw new Error(
+        throw new ConfigurationError(
           `Child at index ${this.currentChildIndex} is undefined`
         );
       }
@@ -1312,7 +1468,7 @@ var Sequence = class extends CompositeNode {
           this._status = "RUNNING" /* RUNNING */;
           return "RUNNING" /* RUNNING */;
         default:
-          throw new Error(`Unexpected status from child: ${childStatus}`);
+          throw new ConfigurationError(`Unexpected status from child: ${childStatus}`);
       }
     }
     this.log("All children succeeded");
@@ -1365,7 +1521,7 @@ var MemorySequence = class extends Sequence {
           this._status = "RUNNING" /* RUNNING */;
           return "RUNNING" /* RUNNING */;
         default:
-          throw new Error(`Unexpected status from child: ${childStatus}`);
+          throw new ConfigurationError(`Unexpected status from child: ${childStatus}`);
       }
     }
     this.log("All children succeeded");
@@ -1496,7 +1652,7 @@ var ReactiveSequence = class extends Sequence {
           this._status = "RUNNING" /* RUNNING */;
           return "RUNNING" /* RUNNING */;
         default:
-          throw new Error(`Unexpected status from child: ${childStatus}`);
+          throw new ConfigurationError(`Unexpected status from child: ${childStatus}`);
       }
     }
     this.log("All children succeeded");
@@ -1575,7 +1731,7 @@ var Selector = class extends CompositeNode {
       checkSignal(context.signal);
       const child = this._children[this.currentChildIndex];
       if (!child) {
-        throw new Error(
+        throw new ConfigurationError(
           `Child at index ${this.currentChildIndex} is undefined`
         );
       }
@@ -1596,7 +1752,7 @@ var Selector = class extends CompositeNode {
           this._status = "RUNNING" /* RUNNING */;
           return "RUNNING" /* RUNNING */;
         default:
-          throw new Error(`Unexpected status from child: ${childStatus}`);
+          throw new ConfigurationError(`Unexpected status from child: ${childStatus}`);
       }
     }
     this.log("All children failed");
@@ -1618,154 +1774,6 @@ var Fallback = class extends Selector {
   }
 };
 
-// src/utilities/variable-resolver.ts
-var VARIABLE_PATTERN = /\$\{(input|bb|env|param)\.([a-zA-Z0-9_.]+)\}|\$\{([a-zA-Z0-9_.]+)\}/g;
-var HAS_VARIABLE_PATTERN = /\$\{(input|bb|env|param)\.([a-zA-Z0-9_.]+)\}|\$\{([a-zA-Z0-9_.]+)\}/;
-var FULL_MATCH_PATTERN = /^\$\{(input|bb|env|param)\.([a-zA-Z0-9_.]+)\}$|^\$\{([a-zA-Z0-9_.]+)\}$/;
-var safeProcessEnv = () => {
-  try {
-    return typeof process !== "undefined" && process?.env ? process.env : {};
-  } catch {
-    return {};
-  }
-};
-function resolveString(str, ctx, opts = {}) {
-  const { preserveUndefined = true, envSource = safeProcessEnv() } = opts;
-  const fullMatch = str.match(FULL_MATCH_PATTERN);
-  if (fullMatch) {
-    const namespace = fullMatch[1];
-    const namespacedKey = fullMatch[2];
-    const simpleKey = fullMatch[3];
-    const key = namespacedKey || simpleKey;
-    const ns = namespace || "bb";
-    if (key) {
-      const value = resolveVariable(ns, key, ctx, envSource);
-      if (value !== void 0) {
-        return value;
-      }
-      return preserveUndefined ? str : void 0;
-    }
-  }
-  return str.replace(VARIABLE_PATTERN, (match, namespace, namespacedKey, simpleKey) => {
-    const key = namespacedKey || simpleKey;
-    const ns = namespace || "bb";
-    const value = resolveVariable(ns, key, ctx, envSource);
-    if (value === void 0) {
-      return preserveUndefined ? match : "";
-    }
-    if (value === null) {
-      return "null";
-    }
-    if (typeof value === "object") {
-      try {
-        return JSON.stringify(value);
-      } catch {
-        return String(value);
-      }
-    }
-    return String(value);
-  });
-}
-function resolveValue(value, ctx, opts = {}) {
-  if (typeof value === "string") {
-    return resolveString(value, ctx, opts);
-  }
-  if (Array.isArray(value)) {
-    return value.map((item) => resolveValue(item, ctx, opts));
-  }
-  if (value !== null && typeof value === "object") {
-    const resolved = {};
-    for (const [key, val] of Object.entries(value)) {
-      resolved[key] = resolveValue(val, ctx, opts);
-    }
-    return resolved;
-  }
-  return value;
-}
-function resolveVariable(namespace, key, ctx, envSource) {
-  switch (namespace) {
-    case "input":
-      return getNestedValue(ctx.input, key);
-    case "bb":
-      return getNestedBlackboardValue(ctx.blackboard, key);
-    case "env":
-      return envSource[key];
-    case "param":
-      if (ctx.testData) {
-        const parts = key.split(".");
-        const firstPart = parts[0];
-        if (firstPart) {
-          let value = ctx.testData.get(firstPart);
-          for (let i = 1; i < parts.length && value !== void 0; i++) {
-            const part = parts[i];
-            if (part && typeof value === "object" && value !== null) {
-              value = value[part];
-            } else {
-              return void 0;
-            }
-          }
-          return value;
-        }
-      }
-      return void 0;
-    default:
-      return getNestedBlackboardValue(ctx.blackboard, key);
-  }
-}
-function getNestedValue(obj, path2) {
-  if (obj === void 0 || obj === null) {
-    return void 0;
-  }
-  if (typeof obj !== "object") {
-    return void 0;
-  }
-  const parts = path2.split(".");
-  let value = obj;
-  for (const part of parts) {
-    if (value === void 0 || value === null) {
-      return void 0;
-    }
-    if (typeof value !== "object") {
-      return void 0;
-    }
-    value = value[part];
-  }
-  return value;
-}
-function getNestedBlackboardValue(blackboard, path2) {
-  const parts = path2.split(".");
-  const firstPart = parts[0];
-  if (!firstPart) {
-    return void 0;
-  }
-  let value = blackboard.get(firstPart);
-  for (let i = 1; i < parts.length && value !== void 0; i++) {
-    const part = parts[i];
-    if (part && typeof value === "object" && value !== null) {
-      value = value[part];
-    } else {
-      return void 0;
-    }
-  }
-  return value;
-}
-function hasVariables(str) {
-  return HAS_VARIABLE_PATTERN.test(str);
-}
-function extractVariables(str) {
-  const variables = [];
-  const pattern = /\$\{(input|bb|env|param)\.([a-zA-Z0-9_.]+)\}|\$\{([a-zA-Z0-9_.]+)\}/g;
-  let match;
-  while ((match = pattern.exec(str)) !== null) {
-    const namespace = match[1] || "bb";
-    const key = match[2] || match[3];
-    if (key) {
-      variables.push({ namespace, key });
-    }
-  }
-  return variables;
-}
-
 // src/composites/sub-tree.ts
 var SubTree = class extends ActionNode {
   treeId;
@@ -1783,7 +1791,7 @@ var SubTree = class extends ActionNode {
     checkSignal(context.signal);
     if (!this.clonedTree) {
       if (!context.treeRegistry.hasTree(this.treeId)) {
-        throw new Error(
+        throw new ConfigurationError(
           `SubTree tree '${this.treeId}' not found in registry. Available trees: ${context.treeRegistry.getAllTreeIds().join(", ") || "none"}`
         );
       }
@@ -1940,7 +1948,7 @@ var While = class extends CompositeNode {
           this._status = "RUNNING" /* RUNNING */;
           return "RUNNING" /* RUNNING */;
         default:
-          throw new Error(`Unexpected status from body: ${bodyStatus}`);
+          throw new ConfigurationError(`Unexpected status from body: ${bodyStatus}`);
       }
     }
     this.log(`Max iterations (${this.maxIterations}) reached`);
@@ -3535,6 +3543,7 @@ var RunningNode = class extends ActionNode {
 };
 
 // src/utilities/log-message.ts
+var import_safe_stable_stringify4 = __toESM(require("safe-stable-stringify"), 1);
 var LogMessage = class extends ActionNode {
   message;
   level;
@@ -3597,11 +3606,7 @@ var LogMessage = class extends ActionNode {
       return "null";
     }
     if (typeof resolved === "object") {
-      try {
-        return JSON.stringify(resolved);
-      } catch {
-        return String(resolved);
-      }
+      return (0, import_safe_stable_stringify4.default)(resolved) ?? String(resolved);
     }
     return String(resolved);
   }
@@ -3664,6 +3669,7 @@ var RegexExtract = class extends ActionNode {
 };
 
 // src/utilities/set-variable.ts
+var import_safe_stable_stringify5 = __toESM(require("safe-stable-stringify"), 1);
 var SetVariable = class extends ActionNode {
   key;
   value;
@@ -3682,7 +3688,7 @@ var SetVariable = class extends ActionNode {
       const resolvedKey = typeof this.key === "string" ? resolveValue(this.key, varCtx) : String(this.key);
       const resolvedValue = typeof this.value === "string" ? resolveValue(this.value, varCtx) : this.value;
       context.blackboard.set(resolvedKey, resolvedValue);
-      this.log(`Set ${resolvedKey} = ${JSON.stringify(resolvedValue)}`);
+      this.log(`Set ${resolvedKey} = ${(0, import_safe_stable_stringify5.default)(resolvedValue)}`);
       return "SUCCESS" /* SUCCESS */;
     } catch (error) {
       this._lastError = error instanceof Error ? error.message : String(error);
@@ -3693,6 +3699,7 @@ var SetVariable = class extends ActionNode {
 };
 
 // src/utilities/math-op.ts
+var import_safe_stable_stringify6 = __toESM(require("safe-stable-stringify"), 1);
 function tokenize(expr) {
   const tokens = [];
   let i = 0;
@@ -3802,12 +3809,12 @@ function evaluate(tokens) {
       pos++;
       return val;
     }
-    throw new Error(`Unexpected token: ${JSON.stringify(tok)}`);
+    throw new Error(`Unexpected token: ${(0, import_safe_stable_stringify6.default)(tok)}`);
   }
   const result = parseExpr();
   const remaining = current();
   if (remaining) {
-    throw new Error(`Unexpected token after expression: ${JSON.stringify(remaining)}`);
+    throw new Error(`Unexpected token after expression: ${(0, import_safe_stable_stringify6.default)(remaining)}`);
   }
   return result;
 }
@@ -3960,7 +3967,7 @@ var ArrayFilter = class extends ActionNode {
       };
       const inputResolved = typeof this.input === "string" ? resolveValue(this.input, varCtx) : this.input;
       if (!Array.isArray(inputResolved)) {
-        throw new Error(
+        throw new ConfigurationError(
           `Input is not an array: got ${inputResolved === null ? "null" : typeof inputResolved}`
         );
       }
@@ -3979,6 +3986,7 @@ var ArrayFilter = class extends ActionNode {
       this.log(`Filtered ${inputResolved.length} \u2192 ${result.length} items`);
       return "SUCCESS" /* SUCCESS */;
     } catch (error) {
+      if (error instanceof ConfigurationError) throw error;
       this._lastError = error instanceof Error ? error.message : String(error);
       this.log(`ArrayFilter failed: ${this._lastError}`);
       return "FAILURE" /* FAILURE */;
@@ -3987,6 +3995,7 @@ var ArrayFilter = class extends ActionNode {
 };
 
 // src/utilities/aggregate.ts
+var import_safe_stable_stringify7 = __toESM(require("safe-stable-stringify"), 1);
 function getFieldValue2(item, path2) {
   if (item === null || item === void 0) return void 0;
   const parts = path2.split(".");
@@ -4054,14 +4063,14 @@ var Aggregate = class extends ActionNode {
       };
       const inputResolved = typeof this.input === "string" ? resolveValue(this.input, varCtx) : this.input;
       if (!Array.isArray(inputResolved)) {
-        throw new Error(
+        throw new ConfigurationError(
           `Input is not an array: got ${inputResolved === null ? "null" : typeof inputResolved}`
         );
       }
       if (!this.groupBy) {
         const result = computeAggregations(inputResolved, this.operations);
         context.blackboard.set(this.outputKey, result);
-        this.log(`Aggregated ${inputResolved.length} items \u2192 ${JSON.stringify(result)}`);
+        this.log(`Aggregated ${inputResolved.length} items \u2192 ${(0, import_safe_stable_stringify7.default)(result)}`);
       } else {
         const groups = {};
         for (const item of inputResolved) {
@@ -4081,6 +4090,7 @@ var Aggregate = class extends ActionNode {
       }
       return "SUCCESS" /* SUCCESS */;
     } catch (error) {
+      if (error instanceof ConfigurationError) throw error;
       this._lastError = error instanceof Error ? error.message : String(error);
       this.log(`Aggregate failed: ${this._lastError}`);
       return "FAILURE" /* FAILURE */;
@@ -4089,6 +4099,7 @@ var Aggregate = class extends ActionNode {
 };
 
 // src/utilities/threshold-check.ts
+var import_safe_stable_stringify8 = __toESM(require("safe-stable-stringify"), 1);
 function evaluateThreshold(val, threshold, resolvedValue, resolvedRange) {
   switch (threshold.operator) {
     case "lte":
@@ -4133,7 +4144,7 @@ var ThresholdCheck = class extends ActionNode {
       const resolved = typeof this.valueRef === "string" ? resolveValue(this.valueRef, varCtx) : this.valueRef;
       const numValue = typeof resolved === "number" ? resolved : parseFloat(String(resolved));
       if (isNaN(numValue)) {
-        throw new Error(`Value is not numeric: ${JSON.stringify(resolved)}`);
+        throw new Error(`Value is not numeric: ${(0, import_safe_stable_stringify8.default)(resolved)}`);
       }
       let matchedLabel = "normal";
       for (const threshold of this.thresholds) {
@@ -5785,6 +5796,7 @@ function registerStandardNodes(registry) {
 }
 
 // src/data-store/memory-store.ts
+var import_safe_stable_stringify9 = __toESM(require("safe-stable-stringify"), 1);
 var MemoryDataStore = class {
   storage = /* @__PURE__ */ new Map();
   cleanupInterval = null;
@@ -5798,7 +5810,7 @@ var MemoryDataStore = class {
     }
   }
   async put(key, data, options) {
-    const serialized = JSON.stringify(data);
+    const serialized = (0, import_safe_stable_stringify9.default)(data) ?? "{}";
     const sizeBytes = Buffer.byteLength(serialized, "utf8");
     const entry = {
       data,

package/dist/index.js

@@ -610,6 +610,7 @@ var CompositeNode = class extends BaseNode {
 };
 
 // src/blackboard.ts
+import stringify from "safe-stable-stringify";
 var ScopedBlackboard = class _ScopedBlackboard {
   data = {};
   parent = null;
@@ -731,7 +732,7 @@ var ScopedBlackboard = class _ScopedBlackboard {
     const prefix = "  ".repeat(indent);
     console.log(`${prefix}Scope: ${this.scopeName}`);
     for (const [key, value] of Object.entries(this.data)) {
-      console.log(`${prefix}  ${key}: ${JSON.stringify(value)}`);
+      console.log(`${prefix}  ${key}: ${stringify(value)}`);
     }
     for (const [_name, childScope] of this.childScopes) {
       childScope.debug(indent + 1);
@@ -980,10 +981,10 @@ var Conditional = class extends CompositeNode {
   async executeTick(context) {
     checkSignal(context.signal);
     if (!this.condition) {
-      throw new Error("Conditional requires at least a condition child");
+      throw new ConfigurationError("Conditional requires at least a condition child");
     }
     if (!this.thenBranch) {
-      throw new Error(
+      throw new ConfigurationError(
         "Conditional requires at least condition and then branch"
       );
     }
@@ -1012,7 +1013,7 @@ var Conditional = class extends CompositeNode {
           this._status = "RUNNING" /* RUNNING */;
           return "RUNNING" /* RUNNING */;
         default:
-          throw new Error(
+          throw new ConfigurationError(
             `Unexpected status from condition: ${conditionStatus}`
           );
       }
@@ -1020,7 +1021,7 @@ var Conditional = class extends CompositeNode {
       this.log("Condition already evaluated - continuing branch execution");
     }
     if (!this.selectedBranch) {
-      throw new Error("No branch selected for execution");
+      throw new ConfigurationError("No branch selected for execution");
     }
     const branchStatus = await this.selectedBranch.tick(context);
     this._status = branchStatus;
@@ -1045,6 +1046,161 @@ var Conditional = class extends CompositeNode {
 };
 
 // src/composites/for-each.ts
+import dlv2 from "dlv";
+import stringify3 from "safe-stable-stringify";
+
+// src/utilities/variable-resolver.ts
+import dlv from "dlv";
+import stringify2 from "safe-stable-stringify";
+function parsePath(path2) {
+  const segments = [];
+  let current = "";
+  for (let i = 0; i < path2.length; i++) {
+    const ch = path2[i];
+    if (ch === "." || ch === "[") {
+      if (current) segments.push(current);
+      current = "";
+    } else if (ch === "]") {
+      if (current) segments.push(current);
+      current = "";
+    } else {
+      current += ch;
+    }
+  }
+  if (current) segments.push(current);
+  return segments;
+}
+var VARIABLE_PATTERN = /\$\{(input|bb|env|param)\.([a-zA-Z0-9_.\[\]]+)\}|\$\{([a-zA-Z0-9_.\[\]]+)\}/g;
+var HAS_VARIABLE_PATTERN = /\$\{(input|bb|env|param)\.([a-zA-Z0-9_.\[\]]+)\}|\$\{([a-zA-Z0-9_.\[\]]+)\}/;
+var FULL_MATCH_PATTERN = /^\$\{(input|bb|env|param)\.([a-zA-Z0-9_.\[\]]+)\}$|^\$\{([a-zA-Z0-9_.\[\]]+)\}$/;
+var safeProcessEnv = () => {
+  try {
+    return typeof process !== "undefined" && process?.env ? process.env : {};
+  } catch {
+    return {};
+  }
+};
+function resolveString(str, ctx, opts = {}) {
+  const { preserveUndefined = true, envSource = safeProcessEnv() } = opts;
+  const fullMatch = str.match(FULL_MATCH_PATTERN);
+  if (fullMatch) {
+    const namespace = fullMatch[1];
+    const namespacedKey = fullMatch[2];
+    const simpleKey = fullMatch[3];
+    const key = namespacedKey || simpleKey;
+    const ns = namespace || "bb";
+    if (key) {
+      const value = resolveVariable(ns, key, ctx, envSource);
+      if (value !== void 0) {
+        return value;
+      }
+      return preserveUndefined ? str : void 0;
+    }
+  }
+  return str.replace(VARIABLE_PATTERN, (match, namespace, namespacedKey, simpleKey) => {
+    const key = namespacedKey || simpleKey;
+    const ns = namespace || "bb";
+    const value = resolveVariable(ns, key, ctx, envSource);
+    if (value === void 0) {
+      return preserveUndefined ? match : "";
+    }
+    if (value === null) {
+      return "null";
+    }
+    if (typeof value === "object") {
+      return stringify2(value) ?? String(value);
+    }
+    return String(value);
+  });
+}
+function resolveValue(value, ctx, opts = {}) {
+  if (typeof value === "string") {
+    return resolveString(value, ctx, opts);
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => resolveValue(item, ctx, opts));
+  }
+  if (value !== null && typeof value === "object") {
+    const resolved = {};
+    for (const [key, val] of Object.entries(value)) {
+      resolved[key] = resolveValue(val, ctx, opts);
+    }
+    return resolved;
+  }
+  return value;
+}
+function resolveVariable(namespace, key, ctx, envSource) {
+  switch (namespace) {
+    case "input":
+      return getNestedValue(ctx.input, key);
+    case "bb":
+      return getNestedBlackboardValue(ctx.blackboard, key);
+    case "env":
+      return envSource[key];
+    case "param":
+      if (ctx.testData) {
+        const parts = parsePath(key);
+        const firstPart = parts[0];
+        if (firstPart) {
+          const value = ctx.testData.get(firstPart);
+          if (parts.length === 1) return value;
+          if (value === void 0 || value === null || typeof value !== "object") return void 0;
+          return dlv(value, parts.slice(1));
+        }
+      }
+      return void 0;
+    default:
+      return getNestedBlackboardValue(ctx.blackboard, key);
+  }
+}
+function getNestedValue(obj, path2) {
+  if (obj === void 0 || obj === null || typeof obj !== "object") {
+    return void 0;
+  }
+  return dlv(obj, parsePath(path2));
+}
+function getNestedBlackboardValue(blackboard, path2) {
+  const parts = parsePath(path2);
+  const firstPart = parts[0];
+  if (!firstPart) {
+    return void 0;
+  }
+  const value = blackboard.get(firstPart);
+  if (parts.length === 1) {
+    return value;
+  }
+  if (value === void 0 || value === null || typeof value !== "object") {
+    return void 0;
+  }
+  return dlv(value, parts.slice(1));
+}
+function hasVariables(str) {
+  return HAS_VARIABLE_PATTERN.test(str);
+}
+function extractVariables(str) {
+  const variables = [];
+  const pattern = /\$\{(input|bb|env|param)\.([a-zA-Z0-9_.\[\]]+)\}|\$\{([a-zA-Z0-9_.\[\]]+)\}/g;
+  let match;
+  while ((match = pattern.exec(str)) !== null) {
+    const namespace = match[1] || "bb";
+    const key = match[2] || match[3];
+    if (key) {
+      variables.push({ namespace, key });
+    }
+  }
+  return variables;
+}
+
+// src/composites/for-each.ts
+function resolveFromBlackboard(blackboard, path2) {
+  const parts = parsePath(path2);
+  const firstPart = parts[0];
+  if (!firstPart) return void 0;
+  const value = blackboard.get(firstPart);
+  if (parts.length === 1) return value;
+  if (value === void 0 || value === null || typeof value !== "object") return void 0;
+  return dlv2(value, parts.slice(1));
+}
 var ForEach = class extends CompositeNode {
   collectionKey;
   itemKey;
@@ -1068,14 +1224,14 @@ var ForEach = class extends CompositeNode {
         "ForEach requires at least one child (body)"
       );
     }
-    const collection = context.blackboard.get(this.collectionKey);
+    const collection = this.collectionKey.includes(".") || this.collectionKey.includes("[") ? resolveFromBlackboard(context.blackboard, this.collectionKey) : context.blackboard.get(this.collectionKey);
     if (!collection) {
       this.log(`Collection '${this.collectionKey}' not found in blackboard`);
       this._status = "FAILURE" /* FAILURE */;
       return "FAILURE" /* FAILURE */;
     }
     if (!Array.isArray(collection)) {
-      throw new Error(`Collection '${this.collectionKey}' is not an array`);
+      throw new ConfigurationError(`Collection '${this.collectionKey}' is not an array`);
     }
     if (collection.length === 0) {
       this.log("Collection is empty - returning SUCCESS");
@@ -1093,7 +1249,7 @@ var ForEach = class extends CompositeNode {
         context.blackboard.set(this.indexKey, this.currentIndex);
       }
       this.log(
-        `Processing item ${this.currentIndex}: ${JSON.stringify(item)}`
+        `Processing item ${this.currentIndex}: ${stringify3(item)}`
       );
       const bodyStatus = await body.tick(context);
       switch (bodyStatus) {
@@ -1113,7 +1269,7 @@ var ForEach = class extends CompositeNode {
           return "RUNNING" /* RUNNING */;
         // Will resume from this index next tick
         default:
-          throw new Error(`Unexpected status from body: ${bodyStatus}`);
+          throw new ConfigurationError(`Unexpected status from body: ${bodyStatus}`);
       }
     }
     this.log("All items processed successfully");
@@ -1143,7 +1299,7 @@ var Sequence = class extends CompositeNode {
       checkSignal(context.signal);
       const child = this._children[this.currentChildIndex];
       if (!child) {
-        throw new Error(
+        throw new ConfigurationError(
           `Child at index ${this.currentChildIndex} is undefined`
         );
       }
@@ -1164,7 +1320,7 @@ var Sequence = class extends CompositeNode {
           this._status = "RUNNING" /* RUNNING */;
           return "RUNNING" /* RUNNING */;
         default:
-          throw new Error(`Unexpected status from child: ${childStatus}`);
+          throw new ConfigurationError(`Unexpected status from child: ${childStatus}`);
       }
     }
     this.log("All children succeeded");
@@ -1217,7 +1373,7 @@ var MemorySequence = class extends Sequence {
           this._status = "RUNNING" /* RUNNING */;
           return "RUNNING" /* RUNNING */;
         default:
-          throw new Error(`Unexpected status from child: ${childStatus}`);
+          throw new ConfigurationError(`Unexpected status from child: ${childStatus}`);
       }
     }
     this.log("All children succeeded");
@@ -1348,7 +1504,7 @@ var ReactiveSequence = class extends Sequence {
           this._status = "RUNNING" /* RUNNING */;
           return "RUNNING" /* RUNNING */;
         default:
-          throw new Error(`Unexpected status from child: ${childStatus}`);
+          throw new ConfigurationError(`Unexpected status from child: ${childStatus}`);
       }
     }
     this.log("All children succeeded");
@@ -1427,7 +1583,7 @@ var Selector = class extends CompositeNode {
       checkSignal(context.signal);
       const child = this._children[this.currentChildIndex];
       if (!child) {
-        throw new Error(
+        throw new ConfigurationError(
           `Child at index ${this.currentChildIndex} is undefined`
         );
       }
@@ -1448,7 +1604,7 @@ var Selector = class extends CompositeNode {
           this._status = "RUNNING" /* RUNNING */;
           return "RUNNING" /* RUNNING */;
         default:
-          throw new Error(`Unexpected status from child: ${childStatus}`);
+          throw new ConfigurationError(`Unexpected status from child: ${childStatus}`);
       }
     }
     this.log("All children failed");
@@ -1470,154 +1626,6 @@ var Fallback = class extends Selector {
   }
 };
 
-// src/utilities/variable-resolver.ts
-var VARIABLE_PATTERN = /\$\{(input|bb|env|param)\.([a-zA-Z0-9_.]+)\}|\$\{([a-zA-Z0-9_.]+)\}/g;
-var HAS_VARIABLE_PATTERN = /\$\{(input|bb|env|param)\.([a-zA-Z0-9_.]+)\}|\$\{([a-zA-Z0-9_.]+)\}/;
-var FULL_MATCH_PATTERN = /^\$\{(input|bb|env|param)\.([a-zA-Z0-9_.]+)\}$|^\$\{([a-zA-Z0-9_.]+)\}$/;
-var safeProcessEnv = () => {
-  try {
-    return typeof process !== "undefined" && process?.env ? process.env : {};
-  } catch {
-    return {};
-  }
-};
-function resolveString(str, ctx, opts = {}) {
-  const { preserveUndefined = true, envSource = safeProcessEnv() } = opts;
-  const fullMatch = str.match(FULL_MATCH_PATTERN);
-  if (fullMatch) {
-    const namespace = fullMatch[1];
-    const namespacedKey = fullMatch[2];
-    const simpleKey = fullMatch[3];
-    const key = namespacedKey || simpleKey;
-    const ns = namespace || "bb";
-    if (key) {
-      const value = resolveVariable(ns, key, ctx, envSource);
-      if (value !== void 0) {
-        return value;
-      }
-      return preserveUndefined ? str : void 0;
-    }
-  }
-  return str.replace(VARIABLE_PATTERN, (match, namespace, namespacedKey, simpleKey) => {
-    const key = namespacedKey || simpleKey;
-    const ns = namespace || "bb";
-    const value = resolveVariable(ns, key, ctx, envSource);
-    if (value === void 0) {
-      return preserveUndefined ? match : "";
-    }
-    if (value === null) {
-      return "null";
-    }
-    if (typeof value === "object") {
-      try {
-        return JSON.stringify(value);
-      } catch {
-        return String(value);
-      }
-    }
-    return String(value);
-  });
-}
-function resolveValue(value, ctx, opts = {}) {
-  if (typeof value === "string") {
-    return resolveString(value, ctx, opts);
-  }
-  if (Array.isArray(value)) {
-    return value.map((item) => resolveValue(item, ctx, opts));
-  }
-  if (value !== null && typeof value === "object") {
-    const resolved = {};
-    for (const [key, val] of Object.entries(value)) {
-      resolved[key] = resolveValue(val, ctx, opts);
-    }
-    return resolved;
-  }
-  return value;
-}
-function resolveVariable(namespace, key, ctx, envSource) {
-  switch (namespace) {
-    case "input":
-      return getNestedValue(ctx.input, key);
-    case "bb":
-      return getNestedBlackboardValue(ctx.blackboard, key);
-    case "env":
-      return envSource[key];
-    case "param":
-      if (ctx.testData) {
-        const parts = key.split(".");
-        const firstPart = parts[0];
-        if (firstPart) {
-          let value = ctx.testData.get(firstPart);
-          for (let i = 1; i < parts.length && value !== void 0; i++) {
-            const part = parts[i];
-            if (part && typeof value === "object" && value !== null) {
-              value = value[part];
-            } else {
-              return void 0;
-            }
-          }
-          return value;
-        }
-      }
-      return void 0;
-    default:
-      return getNestedBlackboardValue(ctx.blackboard, key);
-  }
-}
-function getNestedValue(obj, path2) {
-  if (obj === void 0 || obj === null) {
-    return void 0;
-  }
-  if (typeof obj !== "object") {
-    return void 0;
-  }
-  const parts = path2.split(".");
-  let value = obj;
-  for (const part of parts) {
-    if (value === void 0 || value === null) {
-      return void 0;
-    }
-    if (typeof value !== "object") {
-      return void 0;
-    }
-    value = value[part];
-  }
-  return value;
-}
-function getNestedBlackboardValue(blackboard, path2) {
-  const parts = path2.split(".");
-  const firstPart = parts[0];
-  if (!firstPart) {
-    return void 0;
-  }
-  let value = blackboard.get(firstPart);
-  for (let i = 1; i < parts.length && value !== void 0; i++) {
-    const part = parts[i];
-    if (part && typeof value === "object" && value !== null) {
-      value = value[part];
-    } else {
-      return void 0;
-    }
-  }
-  return value;
-}
-function hasVariables(str) {
-  return HAS_VARIABLE_PATTERN.test(str);
-}
-function extractVariables(str) {
-  const variables = [];
-  const pattern = /\$\{(input|bb|env|param)\.([a-zA-Z0-9_.]+)\}|\$\{([a-zA-Z0-9_.]+)\}/g;
-  let match;
-  while ((match = pattern.exec(str)) !== null) {
-    const namespace = match[1] || "bb";
-    const key = match[2] || match[3];
-    if (key) {
-      variables.push({ namespace, key });
-    }
-  }
-  return variables;
-}
-
 // src/composites/sub-tree.ts
 var SubTree = class extends ActionNode {
   treeId;
@@ -1635,7 +1643,7 @@ var SubTree = class extends ActionNode {
     checkSignal(context.signal);
     if (!this.clonedTree) {
       if (!context.treeRegistry.hasTree(this.treeId)) {
-        throw new Error(
+        throw new ConfigurationError(
           `SubTree tree '${this.treeId}' not found in registry. Available trees: ${context.treeRegistry.getAllTreeIds().join(", ") || "none"}`
         );
       }
@@ -1792,7 +1800,7 @@ var While = class extends CompositeNode {
           this._status = "RUNNING" /* RUNNING */;
           return "RUNNING" /* RUNNING */;
         default:
-          throw new Error(`Unexpected status from body: ${bodyStatus}`);
+          throw new ConfigurationError(`Unexpected status from body: ${bodyStatus}`);
       }
     }
     this.log(`Max iterations (${this.maxIterations}) reached`);
@@ -3387,6 +3395,7 @@ var RunningNode = class extends ActionNode {
 };
 
 // src/utilities/log-message.ts
+import stringify4 from "safe-stable-stringify";
 var LogMessage = class extends ActionNode {
   message;
   level;
@@ -3449,11 +3458,7 @@ var LogMessage = class extends ActionNode {
       return "null";
     }
     if (typeof resolved === "object") {
-      try {
-        return JSON.stringify(resolved);
-      } catch {
-        return String(resolved);
-      }
+      return stringify4(resolved) ?? String(resolved);
     }
     return String(resolved);
   }
@@ -3516,6 +3521,7 @@ var RegexExtract = class extends ActionNode {
 };
 
 // src/utilities/set-variable.ts
+import stringify5 from "safe-stable-stringify";
 var SetVariable = class extends ActionNode {
   key;
   value;
@@ -3534,7 +3540,7 @@ var SetVariable = class extends ActionNode {
       const resolvedKey = typeof this.key === "string" ? resolveValue(this.key, varCtx) : String(this.key);
       const resolvedValue = typeof this.value === "string" ? resolveValue(this.value, varCtx) : this.value;
       context.blackboard.set(resolvedKey, resolvedValue);
-      this.log(`Set ${resolvedKey} = ${JSON.stringify(resolvedValue)}`);
+      this.log(`Set ${resolvedKey} = ${stringify5(resolvedValue)}`);
       return "SUCCESS" /* SUCCESS */;
     } catch (error) {
       this._lastError = error instanceof Error ? error.message : String(error);
@@ -3545,6 +3551,7 @@ var SetVariable = class extends ActionNode {
 };
 
 // src/utilities/math-op.ts
+import stringify6 from "safe-stable-stringify";
 function tokenize(expr) {
   const tokens = [];
   let i = 0;
@@ -3654,12 +3661,12 @@ function evaluate(tokens) {
       pos++;
       return val;
     }
-    throw new Error(`Unexpected token: ${JSON.stringify(tok)}`);
+    throw new Error(`Unexpected token: ${stringify6(tok)}`);
   }
   const result = parseExpr();
   const remaining = current();
   if (remaining) {
-    throw new Error(`Unexpected token after expression: ${JSON.stringify(remaining)}`);
+    throw new Error(`Unexpected token after expression: ${stringify6(remaining)}`);
   }
   return result;
 }
@@ -3812,7 +3819,7 @@ var ArrayFilter = class extends ActionNode {
       };
       const inputResolved = typeof this.input === "string" ? resolveValue(this.input, varCtx) : this.input;
       if (!Array.isArray(inputResolved)) {
-        throw new Error(
+        throw new ConfigurationError(
           `Input is not an array: got ${inputResolved === null ? "null" : typeof inputResolved}`
         );
       }
@@ -3831,6 +3838,7 @@ var ArrayFilter = class extends ActionNode {
       this.log(`Filtered ${inputResolved.length} \u2192 ${result.length} items`);
       return "SUCCESS" /* SUCCESS */;
     } catch (error) {
+      if (error instanceof ConfigurationError) throw error;
       this._lastError = error instanceof Error ? error.message : String(error);
       this.log(`ArrayFilter failed: ${this._lastError}`);
       return "FAILURE" /* FAILURE */;
@@ -3839,6 +3847,7 @@ var ArrayFilter = class extends ActionNode {
 };
 
 // src/utilities/aggregate.ts
+import stringify7 from "safe-stable-stringify";
 function getFieldValue2(item, path2) {
   if (item === null || item === void 0) return void 0;
   const parts = path2.split(".");
@@ -3906,14 +3915,14 @@ var Aggregate = class extends ActionNode {
       };
       const inputResolved = typeof this.input === "string" ? resolveValue(this.input, varCtx) : this.input;
       if (!Array.isArray(inputResolved)) {
-        throw new Error(
+        throw new ConfigurationError(
           `Input is not an array: got ${inputResolved === null ? "null" : typeof inputResolved}`
         );
       }
       if (!this.groupBy) {
         const result = computeAggregations(inputResolved, this.operations);
         context.blackboard.set(this.outputKey, result);
-        this.log(`Aggregated ${inputResolved.length} items \u2192 ${JSON.stringify(result)}`);
+        this.log(`Aggregated ${inputResolved.length} items \u2192 ${stringify7(result)}`);
       } else {
         const groups = {};
         for (const item of inputResolved) {
@@ -3933,6 +3942,7 @@ var Aggregate = class extends ActionNode {
       }
       return "SUCCESS" /* SUCCESS */;
     } catch (error) {
+      if (error instanceof ConfigurationError) throw error;
       this._lastError = error instanceof Error ? error.message : String(error);
       this.log(`Aggregate failed: ${this._lastError}`);
       return "FAILURE" /* FAILURE */;
@@ -3941,6 +3951,7 @@ var Aggregate = class extends ActionNode {
 };
 
 // src/utilities/threshold-check.ts
+import stringify8 from "safe-stable-stringify";
 function evaluateThreshold(val, threshold, resolvedValue, resolvedRange) {
   switch (threshold.operator) {
     case "lte":
@@ -3985,7 +3996,7 @@ var ThresholdCheck = class extends ActionNode {
       const resolved = typeof this.valueRef === "string" ? resolveValue(this.valueRef, varCtx) : this.valueRef;
       const numValue = typeof resolved === "number" ? resolved : parseFloat(String(resolved));
       if (isNaN(numValue)) {
-        throw new Error(`Value is not numeric: ${JSON.stringify(resolved)}`);
+        throw new Error(`Value is not numeric: ${stringify8(resolved)}`);
       }
       let matchedLabel = "normal";
       for (const threshold of this.thresholds) {
@@ -5637,6 +5648,7 @@ function registerStandardNodes(registry) {
 }
 
 // src/data-store/memory-store.ts
+import stringify9 from "safe-stable-stringify";
 var MemoryDataStore = class {
   storage = /* @__PURE__ */ new Map();
   cleanupInterval = null;
@@ -5650,7 +5662,7 @@ var MemoryDataStore = class {
     }
   }
   async put(key, data, options) {
-    const serialized = JSON.stringify(data);
+    const serialized = stringify9(data) ?? "{}";
     const sizeBytes = Buffer.byteLength(serialized, "utf8");
     const entry = {
       data,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@q1k-oss/behaviour-tree-workflows",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "Behavior tree library for TypeScript — 30+ production-ready nodes, YAML workflows, Temporal integration, and built-in observability",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -67,7 +67,9 @@
     "@activepieces/pieces-framework": "^0.23.0",
     "@temporalio/activity": "^1.10.0",
     "@temporalio/workflow": "^1.10.0",
+    "dlv": "^1.1.3",
     "js-yaml": "^4.1.1",
+    "safe-stable-stringify": "^2.5.0",
     "zod": "^4.2.1"
   },
   "peerDependencies": {
@@ -100,6 +102,7 @@
     "@temporalio/client": "^1.10.0",
     "@temporalio/testing": "^1.10.0",
     "@temporalio/worker": "^1.10.0",
+    "@types/dlv": "^1.1.5",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^24.2.1",
     "@vitest/coverage-v8": "^3.2.4",