@decaf-ts/integrations 0.3.9 → 0.3.11

package/lib/types/nest/graph/GraphExecutorRegistryFactory.d.mts

@@ -1,17 +1,52 @@
 /**
  * @module integrations/nest/graph/GraphExecutorRegistryFactory
  * @summary Factory that builds a populated {@link GraphNodeExecutorRegistry}.
- * @description Creates a registry pre-loaded with the demo executors (`math.add`, `math.multiply`) used by the graph execution backend's sample workflows. Additional executors can be registered on the returned registry before it is handed to the {@link GraphExecutionEngine}.
+ * @description Creates a registry pre-loaded with the demo executors used by
+ * the graph execution backend's sample workflows. The executors cover the
+ * publishing-workflow node tags, the flow-control kinds, the agent kind, and
+ * the loop kinds. Additional executors can be registered on the returned
+ * registry before it is handed to the {@link GraphExecutionEngine}.
  */
-import { GraphNodeExecutorRegistry } from "../../graph/index.d.mts";
-import type { GraphNodeExecutor } from "../../graph/index.d.mts";
+import { GraphNodeExecutorRegistry, GraphExecutionEngine, type GraphNodeExecutor, IsolatedVmCodeSandboxEvaluator } from "../../graph/index.d.mts";
 /**
  * Builds a {@link GraphNodeExecutorRegistry} populated with the demo executors.
  *
+ * Executors are registered by **node kind** (the same key the engine uses to
+ * resolve executors at runtime). The for-angular demo nodes use the kind as
+ * their tag, so the same key works for both dispatch-by-kind and
+ * dispatch-by-tag.
+ *
  * Registered kinds:
- * - `math.add` — sums `a` and `b` into `sum`.
- * - `math.multiply` — multiplies `x` by 2 into `product`.
+ * - `math.add`, `math.multiply` — arithmetic demo executors.
+ * - `graph-intake-workflow`, `graph-planning-pipeline`, `graph-draft-node`,
+ *   `graph-review-node`, `graph-publish-workflow` — publishing workflow demo.
+ * - `core.flow.*` — flow-control kinds (map, delay, return, merge, if, switch,
+ *   parallel, errorBoundary, humanApproval). The `core.flow.code` kind is
+ *   registered in `onEngineCreated` via the real {@link CodeGraphNodeExecutor}
+ *   because it needs the engine's `codeSandboxEvaluator`.
+ * - `core.agent` — agent node.
+ * - `core.loop.foreach`, `core.loop.while`, `core.loop.until` — loop executors
+ *   (registered after the engine is created via `onEngineCreated`).
  *
+ * @param extra - Additional executors to merge into the registry.
  * @returns A populated registry ready for use with {@link GraphExecutionEngine}.
  */
 export declare function createGraphExecutorRegistry(extra?: Record<string, GraphNodeExecutor>): GraphNodeExecutorRegistry;
+/**
+ * Builds a {@link GraphExecutionEngineConfig} populated with all demo executors
+ * including loop executors that need a back-reference to the engine and the
+ * Code node executor that needs the engine's `codeSandboxEvaluator`.
+ *
+ * The config wires an {@link IsolatedVmCodeSandboxEvaluator} (backed by
+ * `isolated-vm`) so the Code Node runs in a truly isolated V8 sandbox.
+ *
+ * @returns A config object ready for `new GraphExecutionEngine(config)`.
+ */
+export declare function createDemoEngineConfig(): {
+    registry: GraphNodeExecutorRegistry;
+    defaultOptions: {
+        failFast: boolean;
+    };
+    codeSandboxEvaluator: IsolatedVmCodeSandboxEvaluator;
+    onEngineCreated: (engine: GraphExecutionEngine) => void;
+};

package/lib/types/nest/graph/main.d.cts

@@ -0,0 +1 @@
+export {};

package/lib/types/nest/graph/main.d.mts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decaf-ts/integrations",
-  "version": "0.3.9",
+  "version": "0.3.11",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.mts",
@@ -258,11 +258,11 @@
     "reset": "rm -rf * && git checkout . && git pull && npm run do-install",
     "build": "build-scripts --dev",
     "build:prod": "build-scripts --prod",
-    "test": "npm run build && NODE_OPTIONS=\"--experimental-vm-modules\" jest --runInBand --coverage --detectOpenHandles",
-    "test:unit": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --testPathPatterns=\"/tests/unit\" --passWithNoTests --detectOpenHandles",
-    "test:integration": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --testPathPatterns=\"/tests/(integration)\" --passWithNoTests --detectOpenHandles",
-    "test:e2e": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --testPathPatterns=\"/tests/(e2e)\" --passWithNoTests --detectOpenHandles",
-    "test:all": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --runInBand --testPathPatterns=\"/tests\" --passWithNoTests",
+    "test": "npm run build && NODE_OPTIONS=\"--experimental-vm-modules\" jest --watchman=false --runInBand --coverage --detectOpenHandles",
+    "test:unit": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --watchman=false --testPathPatterns=\"/tests/unit\" --passWithNoTests --detectOpenHandles",
+    "test:integration": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --watchman=false --testPathPatterns=\"/tests/(integration)\" --passWithNoTests --detectOpenHandles",
+    "test:e2e": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --watchman=false --testPathPatterns=\"/tests/(e2e)\" --passWithNoTests --detectOpenHandles",
+    "test:all": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --watchman=false --runInBand --testPathPatterns=\"/tests\" --passWithNoTests",
     "test:circular": "dpdm -T --no-warning --no-tree ./src/index.ts",
     "coverage": "rimraf ./workdocs/reports/data/*.json && npm run test:all -- --coverage --config=./workdocs/reports/jest.coverage.config.cjs",
     "lint": "eslint .",
@@ -293,9 +293,13 @@
     "@decaf-ts/logging": "latest",
     "@decaf-ts/transactional-decorators": "latest",
     "@decaf-ts/ui-decorators": "latest",
+    "acorn": "^8.17.0",
+    "acorn-walk": "^8.3.5",
     "axios": "^1.7.9",
+    "isolated-vm": "^6.1.2",
     "node-fetch": "^3.3.2",
     "tslib": "^2.8.1",
+    "typescript": "^5.9.3",
     "uuid": "^11.1.1"
   },
   "devDependencies": {