@decaf-ts/integrations 0.3.11 → 0.4.0

package/lib/esm/nest/graph/GraphExecutorRegistryFactory.js

@@ -3,56 +3,20 @@
  * @summary Factory that builds a populated {@link GraphNodeExecutorRegistry}.
  * @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}.
+ * flow-control kinds (including Code, Log, and Switch with code conditions),
+ * 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, ConditionExpressionEvaluator, ForeachGraphNodeExecutor, WhileGraphNodeExecutor, UntilGraphNodeExecutor, CodeGraphNodeExecutor, IsolatedVmCodeSandboxEvaluator, } from "./../../graph/index.js";
+import { GraphNodeExecutorRegistry, ForeachGraphNodeExecutor, WhileGraphNodeExecutor, UntilGraphNodeExecutor, CodeGraphNodeExecutor, LogGraphNodeExecutor, SwitchGraphNodeExecutor, IsolatedVmCodeSandboxEvaluator, } from "./../../graph/index.js";
 const executorMap = {
     "math.add": (input) => ({ sum: Number(input.a) + Number(input.b) }),
     "math.multiply": (input) => ({ product: Number(input.x) * 2 }),
-    "graph-intake-workflow": (input) => ({
-        brief: `[Normalized brief] ${String(input["request"] ?? "")}`,
-    }),
-    "graph-planning-pipeline": (input) => ({
-        plan: `[Plan] Steps derived from: ${String(input["brief"] ?? "")}`,
-    }),
-    "graph-draft-node": (input) => ({
-        draft: `[Draft] ${String(input["plan"] ?? "")}`,
-    }),
-    "graph-review-node": (input) => ({
-        approved: `[Approved] ${String(input["draft"] ?? "")}`,
-    }),
-    "graph-publish-workflow": (input) => ({
-        artifact: `[Published] ${String(input["approved"] ?? "")}`,
-    }),
     "core.flow.map": (input) => ({ result: { mapped: input["value"] ?? input } }),
     "core.flow.delay": (input) => ({ valueOut: input["value"] ?? input }),
     "core.flow.return": (input) => ({ result: input["value"] ?? input }),
     "core.flow.merge": (input) => ({ merged: input["values"] ?? input }),
     "core.flow.if": (input) => ({ then: input["value"] ?? input }),
-    "core.flow.switch": (input, context) => {
-        const meta = context.node.graph?.metadata?.["switch"];
-        const inputValue = input["value"] ?? input;
-        if (!meta || !meta.cases || meta.cases.length === 0) {
-            return { [meta?.defaultPort ?? "default"]: inputValue };
-        }
-        const evaluator = new ConditionExpressionEvaluator();
-        for (const c of meta.cases) {
-            const cond = c.condition;
-            if ("op" in cond) {
-                try {
-                    if (evaluator.evaluate(cond, inputValue)) {
-                        return { [c.outputPort]: inputValue };
-                    }
-                }
-                catch {
-                    // skip unparseable conditions in demo
-                }
-            }
-        }
-        return { [meta.defaultPort ?? "default"]: inputValue };
-    },
     "core.flow.parallel": (input) => ({ branches: [input["value"] ?? input] }),
     "core.flow.errorBoundary": (input) => ({ result: input["value"] ?? input }),
     "core.flow.humanApproval": (input) => ({ approved: input["value"] ?? input }),
@@ -71,12 +35,11 @@ const executorMap = {
  *
  * Registered kinds:
  * - `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.flow.*` — flow-control kinds (map, delay, return, merge, if,
+ *   parallel, errorBoundary, humanApproval). The `core.flow.code`,
+ *   `core.flow.log`, and `core.flow.switch` kinds are registered in
+ *   `onEngineCreated` via their real executors because Code and Switch
+ *   need 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`).
@@ -118,6 +81,8 @@ export function createDemoEngineConfig() {
             registry.register("core.loop.while", new WhileGraphNodeExecutor(engine));
             registry.register("core.loop.until", new UntilGraphNodeExecutor(engine));
             registry.register("core.flow.code", new CodeGraphNodeExecutor(engine));
+            registry.register("core.flow.log", new LogGraphNodeExecutor());
+            registry.register("core.flow.switch", new SwitchGraphNodeExecutor(engine));
         },
     };
 }

package/lib/esm/nest/graph/GraphExecutorRegistryFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"GraphExecutorRegistryFactory.js","sourceRoot":"","sources":["../../../../src/nest/graph/GraphExecutorRegistryFactory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"GraphExecutorRegistryFactory.js","sourceRoot":"","sources":["../../../../src/nest/graph/GraphExecutorRegistryFactory.ts"],"names":[],"mappings":"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"}

package/lib/esm/nest/graph/GraphResultService.js

@@ -0,0 +1,45 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { ModelService, service } from "@decaf-ts/core";
+import { GraphExecutionResultModel } from "./GraphExecutionResultModel.js";
+let GraphResultService = class GraphResultService extends ModelService {
+    constructor() {
+        super(GraphExecutionResultModel);
+    }
+    async saveResult(result, ...args) {
+        const { ctxArgs } = (await this.logCtx(args, "saveResult", true)).for(this.saveResult);
+        const model = new GraphExecutionResultModel({
+            runId: result.runId,
+            workflowId: result.workflowId,
+            status: result.status,
+            inputs: result.inputs,
+            outputs: result.outputs,
+            nodeResults: result.nodeResults,
+            startedAt: result.startedAt,
+            finishedAt: result.finishedAt,
+        });
+        return this.create(model, ...ctxArgs);
+    }
+    async findByRunId(runId, ...args) {
+        const { ctxArgs } = (await this.logCtx(args, "findByRunId", true)).for(this.findByRunId);
+        try {
+            return (await this.read(runId, ...ctxArgs));
+        }
+        catch {
+            return null;
+        }
+    }
+};
+GraphResultService = __decorate([
+    service(GraphExecutionResultModel),
+    __metadata("design:paramtypes", [])
+], GraphResultService);
+export { GraphResultService };
+//# sourceMappingURL=GraphResultService.js.map

package/lib/esm/nest/graph/GraphResultService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphResultService.js","sourceRoot":"","sources":["../../../../src/nest/graph/GraphResultService.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,YAAY,EAAE,OAAO,EAAyC,MAAM,gBAAgB,CAAC;AAC9F,OAAO,EAAE,yBAAyB,EAAE,uCAAoC;AAIjE,IAAM,kBAAkB,GAAxB,MAAM,kBAAmB,SAAQ,YAAuC;IAC7E;QACE,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,UAAU,CACd,MAA4B,EAC5B,GAAG,IAAiC;QAEpC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvF,MAAM,KAAK,GAAG,IAAI,yBAAyB,CAAC;YAC1C,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,WAAW,EAAE,MAAM,CAAC,WAAsC;YAC1D,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,WAAW,CACf,KAAa,EACb,GAAG,IAAiC;QAEpC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACzF,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC,CAA8B,CAAC;QAC3E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF,CAAA;AAlCY,kBAAkB;IAD9B,OAAO,CAAC,yBAAyB,CAAC;;GACtB,kBAAkB,CAkC9B"}

package/lib/esm/nest/graph/GraphWorkflowModel.js

@@ -0,0 +1,35 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Model, model } from "@decaf-ts/decorator-validation";
+import { column, pk, table } from "@decaf-ts/core";
+let GraphWorkflowModel = class GraphWorkflowModel extends Model {
+    constructor(arg) {
+        super(arg);
+    }
+};
+__decorate([
+    pk({ type: String, generated: false }),
+    __metadata("design:type", String)
+], GraphWorkflowModel.prototype, "workflowId", void 0);
+__decorate([
+    column(),
+    __metadata("design:type", Object)
+], GraphWorkflowModel.prototype, "snapshot", void 0);
+__decorate([
+    column(),
+    __metadata("design:type", Date)
+], GraphWorkflowModel.prototype, "updatedAt", void 0);
+GraphWorkflowModel = __decorate([
+    table("graph_workflow_snapshot"),
+    model(),
+    __metadata("design:paramtypes", [Object])
+], GraphWorkflowModel);
+export { GraphWorkflowModel };
+//# sourceMappingURL=GraphWorkflowModel.js.map

package/lib/esm/nest/graph/GraphWorkflowModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphWorkflowModel.js","sourceRoot":"","sources":["../../../../src/nest/graph/GraphWorkflowModel.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAiB,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAI5C,IAAM,kBAAkB,GAAxB,MAAM,kBAAmB,SAAQ,KAAK;IAU3C,YAAY,GAAkC;QAC5C,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;CACF,CAAA;AAXC;IADC,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;;sDACnB;AAGpB;IADC,MAAM,EAAE;;oDAC0B;AAGnC;IADC,MAAM,EAAE;8BACG,IAAI;qDAAC;AARN,kBAAkB;IAF9B,KAAK,CAAC,yBAAyB,CAAC;IAChC,KAAK,EAAE;;GACK,kBAAkB,CAa9B"}

package/lib/esm/nest/graph/GraphWorkflowService.js

@@ -0,0 +1,53 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { ModelService, service } from "@decaf-ts/core";
+import { GraphWorkflowModel } from "./GraphWorkflowModel.js";
+let GraphWorkflowService = class GraphWorkflowService extends ModelService {
+    constructor() {
+        super(GraphWorkflowModel);
+    }
+    async saveSnapshot(workflowId, snapshot, ...args) {
+        const { ctxArgs } = (await this.logCtx(args, "saveSnapshot", true)).for(this.saveSnapshot);
+        const now = new Date();
+        let existing;
+        try {
+            existing = (await this.read(workflowId, ...ctxArgs));
+        }
+        catch {
+            existing = null;
+        }
+        if (existing) {
+            existing.snapshot = snapshot;
+            existing.updatedAt = now;
+            return this.update(existing, ...ctxArgs);
+        }
+        const model = new GraphWorkflowModel({
+            workflowId,
+            snapshot,
+            updatedAt: now,
+        });
+        return this.create(model, ...ctxArgs);
+    }
+    async loadSnapshot(workflowId, ...args) {
+        const { ctxArgs } = (await this.logCtx(args, "loadSnapshot", true)).for(this.loadSnapshot);
+        try {
+            return (await this.read(workflowId, ...ctxArgs));
+        }
+        catch {
+            return null;
+        }
+    }
+};
+GraphWorkflowService = __decorate([
+    service(GraphWorkflowModel),
+    __metadata("design:paramtypes", [])
+], GraphWorkflowService);
+export { GraphWorkflowService };
+//# sourceMappingURL=GraphWorkflowService.js.map

package/lib/esm/nest/graph/GraphWorkflowService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphWorkflowService.js","sourceRoot":"","sources":["../../../../src/nest/graph/GraphWorkflowService.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,YAAY,EAAE,OAAO,EAAyC,MAAM,gBAAgB,CAAC;AAC9F,OAAO,EAAE,kBAAkB,EAAE,gCAA6B;AAGnD,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,YAAgC;IACxE;QACE,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,UAAkB,EAClB,QAAiC,EACjC,GAAG,IAAiC;QAEpC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3F,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QAEvB,IAAI,QAAmC,CAAC;QACxC,IAAI,CAAC;YACH,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,OAAO,CAAC,CAA8B,CAAC;QACpF,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;QAED,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;YAC7B,QAAQ,CAAC,SAAS,GAAG,GAAG,CAAC;YACzB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,OAAO,CAAC,CAAC;QAC3C,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,kBAAkB,CAAC;YACnC,UAAU;YACV,QAAQ;YACR,SAAS,EAAE,GAAG;SACf,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,UAAkB,EAClB,GAAG,IAAiC;QAEpC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3F,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,OAAO,CAAC,CAA8B,CAAC;QAChF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF,CAAA;AA7CY,oBAAoB;IADhC,OAAO,CAAC,kBAAkB,CAAC;;GACf,oBAAoB,CA6ChC"}

package/lib/esm/nest/graph/index.js

@@ -1,10 +1,7 @@
-/**
- * @module integrations/nest/graph
- * @summary NestJS graph execution backend module.
- * @description Server-side hosting for the Decaf graph execution engine. Exposes REST endpoints for triggering execution and retrieving persisted results, plus an SSE endpoint for streaming execution events. Designed to be consumed by for-angular via for-http's `ServerEventConnector`.
- */
 export * from "./GraphExecutionResultModel.js";
-export * from "./GraphExecutionResultRepository.js";
+export * from "./GraphResultService.js";
+export * from "./GraphWorkflowModel.js";
+export * from "./GraphWorkflowService.js";
 export * from "./GraphExecutorRegistryFactory.js";
 export * from "./GraphExecutionController.js";
 export * from "./GraphExecutionModule.js";

package/lib/esm/nest/graph/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/nest/graph/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+CAA4C;AAC5C,oDAAiD;AACjD,kDAA+C;AAC/C,8CAA2C;AAC3C,0CAAuC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/nest/graph/index.ts"],"names":[],"mappings":"AAAA,+CAA4C;AAC5C,wCAAqC;AACrC,wCAAqC;AACrC,0CAAuC;AACvC,kDAA+C;AAC/C,8CAA2C;AAC3C,0CAAuC"}

package/lib/esm/nest/graph/main.js

@@ -13,7 +13,7 @@ import { GraphExecutionModule } from "./GraphExecutionModule.js";
 async function bootstrap() {
     const port = Number(process.env["GRAPH_BACKEND_PORT"] ?? process.argv[2] ?? 3000);
     const app = await NestFactory.create(GraphExecutionModule.forRoot());
-    app.enableCors();
+    app.enableCors({ origin: true, credentials: true });
     await app.listen(port);
     console.log(`[graph-backend] NestJS graph execution server listening on http://localhost:${port}`);
     console.log(`[graph-backend]   POST   /graph/execute`);

package/lib/esm/nest/graph/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../../src/nest/graph/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,kCAA+B;AAE9D,KAAK,UAAU,SAAS;IACtB,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;IAElF,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,CAAC,CAAC;IACrE,GAAG,CAAC,UAAU,EAAE,CAAC;IACjB,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAGvB,OAAO,CAAC,GAAG,CAAC,+EAA+E,IAAI,EAAE,CAAC,CAAC;IAEnG,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;IAEvD,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAE5D,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAExB,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;IACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../../src/nest/graph/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,kCAA+B;AAE9D,KAAK,UAAU,SAAS;IACtB,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;IAElF,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,CAAC,CAAC;IACrE,GAAG,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAGvB,OAAO,CAAC,GAAG,CAAC,+EAA+E,IAAI,EAAE,CAAC,CAAC;IAEnG,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;IAEvD,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAE5D,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAExB,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;IACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/lib/types/graph/engine/execution/CodeGraphNodeExecutor.d.cts

@@ -4,9 +4,10 @@
  * @description Executes user-authored JS/TS in a restricted sandbox via the
  * pluggable {@link CodeSandboxEvaluator}. The sandbox enforces the Code Node
  * restrictions: no imports, no requires, pure functions only (no system API
- * access). The executor reads the code, language, and timeout from the node's
- * graph metadata, resolves the sandbox context from the node's input values
- * and execution context, invokes the evaluator, and returns the result on the
+ * access). The executor reads the code from the node's `code` input port
+ * (spliced from {@link CodeInputSchema}), the timeout from the node's graph
+ * metadata, resolves the sandbox context from the node's input values and
+ * execution context, invokes the evaluator, and returns the result on the
  * `result` output port.
  */
 import type { GraphNodeExecutor } from "./GraphNodeExecutor.d.cts";
@@ -22,17 +23,17 @@ import type { GraphExecutionValues } from "../types.d.cts";
  * no evaluator is registered, the executor throws
  * `GRAPH_CODE_SANDBOX_NOT_CONFIGURED`.
  *
+ * The code is read from the `code` input port (spliced from
+ * {@link CodeInputSchema}). The language is hardcoded to `"javascript"` for
+ * now (the `language` field on `CodeInputSchema` has no `@input` so it is not
+ * a port and not wired). The timeout is read from `graph.metadata.timeoutMs`.
+ *
  * The sandbox context exposes:
- * - `$input` — the value on the node's `input` port (or the full input object
- *   as a fallback when no `input` port is present).
- * - `$vars` — workflow variables (sourced from `context.metadata.vars` when
- *   the engine populates it).
- * - `$item` / `$index` — current loop item and index (sourced from
- *   `context.metadata` when the node executes inside a foreach body).
- * - `$node` — outputs of upstream nodes (sourced from
- *   `context.metadata.nodes` when available).
- * - `$output` — the current draft output (sourced from
- *   `context.metadata.output`).
+ * - `$input` — the full input values object (all resolved port values).
+ * - `$vars` — workflow variables (sourced from `context.metadata.vars`).
+ * - `$item` / `$index` — current loop item and index.
+ * - `$node` — outputs of upstream nodes.
+ * - `$output` — the current draft output.
  *
  * The evaluator's return value is forwarded verbatim on the `result` output
  * port.
@@ -42,7 +43,7 @@ export declare class CodeGraphNodeExecutor implements GraphNodeExecutor {
     /**
      * @param engine - The graph execution engine (or any object exposing the
      *   optional `codeSandboxEvaluator`). This mirrors the pattern used by
-     *   {@link SwitchGraphNodeExecutor} for code conditions.
+     * {@link SwitchGraphNodeExecutor} for code conditions.
      */
     constructor(engine?: {
         codeSandboxEvaluator?: CodeSandboxEvaluator;
@@ -52,9 +53,8 @@ export declare class CodeGraphNodeExecutor implements GraphNodeExecutor {
      * Builds the {@link CodeSandboxContext} from the executor input and the
      * graph execution context.
      *
-     * The `$input` value is resolved from the node's `input` port. When the node
-     * has no explicit `input` port, the full input values object is used as
-     * `$input` so the code can still access every resolved port value.
+     * The `$input` value is the full input values object so the code can access
+     * every resolved port value (including `code` itself via `$input.code`).
      *
      * The `$vars`, `$item`, `$index`, `$node`, and `$output` values are sourced
      * from `context.metadata` — the engine (or a wrapping loop executor) may

package/lib/types/graph/engine/execution/CodeGraphNodeExecutor.d.mts

@@ -4,9 +4,10 @@
  * @description Executes user-authored JS/TS in a restricted sandbox via the
  * pluggable {@link CodeSandboxEvaluator}. The sandbox enforces the Code Node
  * restrictions: no imports, no requires, pure functions only (no system API
- * access). The executor reads the code, language, and timeout from the node's
- * graph metadata, resolves the sandbox context from the node's input values
- * and execution context, invokes the evaluator, and returns the result on the
+ * access). The executor reads the code from the node's `code` input port
+ * (spliced from {@link CodeInputSchema}), the timeout from the node's graph
+ * metadata, resolves the sandbox context from the node's input values and
+ * execution context, invokes the evaluator, and returns the result on the
  * `result` output port.
  */
 import type { GraphNodeExecutor } from "./GraphNodeExecutor.d.mts";
@@ -22,17 +23,17 @@ import type { GraphExecutionValues } from "../types.d.mts";
  * no evaluator is registered, the executor throws
  * `GRAPH_CODE_SANDBOX_NOT_CONFIGURED`.
  *
+ * The code is read from the `code` input port (spliced from
+ * {@link CodeInputSchema}). The language is hardcoded to `"javascript"` for
+ * now (the `language` field on `CodeInputSchema` has no `@input` so it is not
+ * a port and not wired). The timeout is read from `graph.metadata.timeoutMs`.
+ *
  * The sandbox context exposes:
- * - `$input` — the value on the node's `input` port (or the full input object
- *   as a fallback when no `input` port is present).
- * - `$vars` — workflow variables (sourced from `context.metadata.vars` when
- *   the engine populates it).
- * - `$item` / `$index` — current loop item and index (sourced from
- *   `context.metadata` when the node executes inside a foreach body).
- * - `$node` — outputs of upstream nodes (sourced from
- *   `context.metadata.nodes` when available).
- * - `$output` — the current draft output (sourced from
- *   `context.metadata.output`).
+ * - `$input` — the full input values object (all resolved port values).
+ * - `$vars` — workflow variables (sourced from `context.metadata.vars`).
+ * - `$item` / `$index` — current loop item and index.
+ * - `$node` — outputs of upstream nodes.
+ * - `$output` — the current draft output.
  *
  * The evaluator's return value is forwarded verbatim on the `result` output
  * port.
@@ -42,7 +43,7 @@ export declare class CodeGraphNodeExecutor implements GraphNodeExecutor {
     /**
      * @param engine - The graph execution engine (or any object exposing the
      *   optional `codeSandboxEvaluator`). This mirrors the pattern used by
-     *   {@link SwitchGraphNodeExecutor} for code conditions.
+     * {@link SwitchGraphNodeExecutor} for code conditions.
      */
     constructor(engine?: {
         codeSandboxEvaluator?: CodeSandboxEvaluator;
@@ -52,9 +53,8 @@ export declare class CodeGraphNodeExecutor implements GraphNodeExecutor {
      * Builds the {@link CodeSandboxContext} from the executor input and the
      * graph execution context.
      *
-     * The `$input` value is resolved from the node's `input` port. When the node
-     * has no explicit `input` port, the full input values object is used as
-     * `$input` so the code can still access every resolved port value.
+     * The `$input` value is the full input values object so the code can access
+     * every resolved port value (including `code` itself via `$input.code`).
      *
      * The `$vars`, `$item`, `$index`, `$node`, and `$output` values are sourced
      * from `context.metadata` — the engine (or a wrapping loop executor) may

package/lib/types/graph/engine/execution/CodeSandboxEvaluator.d.cts

@@ -32,6 +32,29 @@ export interface CodeSandboxContext {
     index?: number;
     /** Outputs of upstream nodes, accessible as `$node["Name"].output`. */
     nodes?: Record<string, Record<string, unknown>>;
+    /**
+     * Optional logger that receives `console.log/warn/debug/error` calls from
+     * inside the sandbox. When provided, a `console` object is injected into
+     * the isolate whose methods forward to this logger.
+     */
+    logger?: SandboxLogger;
+}
+/**
+ * Minimal logger interface the sandbox can call without importing the full
+ * Decaf logging package (keeps the interface frontend-safe). Mirrors the
+ * methods on `@decaf-ts/logging`'s `Logger`.
+ */
+export interface SandboxLogger {
+    benchmark(msg: string, meta?: unknown): void;
+    fatal(msg: string, meta?: unknown): void;
+    critical(msg: string, meta?: unknown): void;
+    silly(msg: string, meta?: unknown): void;
+    verbose(msg: string, meta?: unknown): void;
+    info(msg: string, meta?: unknown): void;
+    debug(msg: string, meta?: unknown): void;
+    error(msg: string, meta?: unknown): void;
+    warn(msg: string, meta?: unknown): void;
+    trace(msg: string, meta?: unknown): void;
 }
 /**
  * Pluggable evaluator for code-based conditions and Code Node transforms.

package/lib/types/graph/engine/execution/CodeSandboxEvaluator.d.mts

@@ -32,6 +32,29 @@ export interface CodeSandboxContext {
     index?: number;
     /** Outputs of upstream nodes, accessible as `$node["Name"].output`. */
     nodes?: Record<string, Record<string, unknown>>;
+    /**
+     * Optional logger that receives `console.log/warn/debug/error` calls from
+     * inside the sandbox. When provided, a `console` object is injected into
+     * the isolate whose methods forward to this logger.
+     */
+    logger?: SandboxLogger;
+}
+/**
+ * Minimal logger interface the sandbox can call without importing the full
+ * Decaf logging package (keeps the interface frontend-safe). Mirrors the
+ * methods on `@decaf-ts/logging`'s `Logger`.
+ */
+export interface SandboxLogger {
+    benchmark(msg: string, meta?: unknown): void;
+    fatal(msg: string, meta?: unknown): void;
+    critical(msg: string, meta?: unknown): void;
+    silly(msg: string, meta?: unknown): void;
+    verbose(msg: string, meta?: unknown): void;
+    info(msg: string, meta?: unknown): void;
+    debug(msg: string, meta?: unknown): void;
+    error(msg: string, meta?: unknown): void;
+    warn(msg: string, meta?: unknown): void;
+    trace(msg: string, meta?: unknown): void;
 }
 /**
  * Pluggable evaluator for code-based conditions and Code Node transforms.

package/lib/types/graph/engine/execution/GraphExecutionEngine.d.cts

@@ -93,6 +93,12 @@ export declare class GraphExecutionEngine implements Observable<[GraphExecutionO
     private executeNode;
     /**
      * Resolves a node's input values from incoming edges.
+     *
+     * When multiple edges target the same port, their values are spread into the
+     * top-level inputs keyed by each edge's `sourcePort`. This allows multiple
+     * workflow input badges to connect to a single port (e.g. the Code node's
+     * `data` port) and have all values accessible directly as
+     * `$input.{sourcePort}` (e.g. `$input.count`, `$input.text`).
      */
     private resolveNodeInputs;
     /**

package/lib/types/graph/engine/execution/GraphExecutionEngine.d.mts

@@ -93,6 +93,12 @@ export declare class GraphExecutionEngine implements Observable<[GraphExecutionO
     private executeNode;
     /**
      * Resolves a node's input values from incoming edges.
+     *
+     * When multiple edges target the same port, their values are spread into the
+     * top-level inputs keyed by each edge's `sourcePort`. This allows multiple
+     * workflow input badges to connect to a single port (e.g. the Code node's
+     * `data` port) and have all values accessible directly as
+     * `$input.{sourcePort}` (e.g. `$input.count`, `$input.text`).
      */
     private resolveNodeInputs;
     /**

package/lib/types/graph/engine/execution/IsolatedVmCodeSandboxEvaluator.d.cts

@@ -42,4 +42,22 @@ export declare class IsolatedVmCodeSandboxEvaluator implements CodeSandboxEvalua
      */
     constructor(defaultTimeoutMs?: number, defaultMemoryMb?: number);
     evaluate(ctx: CodeSandboxContext): Promise<unknown>;
+    /**
+     * Injects a `console` object into the isolate whose methods forward to the
+     * Context logger (bound to `runId`).
+     *
+     * Every standard `console.*` method is supported:
+     * `log`, `info`, `warn`, `error`, `debug`, `trace`, `dir`, `dirxml`,
+     * `table`, `group`, `groupCollapsed`, `groupEnd`, `time`, `timeEnd`,
+     * `timeLog`, `assert`, `count`, `countReset`, `clear`.
+     *
+     * Arguments are serialised inside the isolate (via `JSON.stringify` with a
+     * safe fallback) before being passed across the isolate boundary, because
+     * `isolated-vm` cannot copy arbitrary host objects.
+     *
+     * @param jail - The isolate's global object.
+     * @param logger - The Context logger that receives the forwarded calls.
+     * @param context - The isolate context (for running the init script).
+     */
+    private injectConsole;
 }

package/lib/types/graph/engine/execution/IsolatedVmCodeSandboxEvaluator.d.mts

@@ -42,4 +42,22 @@ export declare class IsolatedVmCodeSandboxEvaluator implements CodeSandboxEvalua
      */
     constructor(defaultTimeoutMs?: number, defaultMemoryMb?: number);
     evaluate(ctx: CodeSandboxContext): Promise<unknown>;
+    /**
+     * Injects a `console` object into the isolate whose methods forward to the
+     * Context logger (bound to `runId`).
+     *
+     * Every standard `console.*` method is supported:
+     * `log`, `info`, `warn`, `error`, `debug`, `trace`, `dir`, `dirxml`,
+     * `table`, `group`, `groupCollapsed`, `groupEnd`, `time`, `timeEnd`,
+     * `timeLog`, `assert`, `count`, `countReset`, `clear`.
+     *
+     * Arguments are serialised inside the isolate (via `JSON.stringify` with a
+     * safe fallback) before being passed across the isolate boundary, because
+     * `isolated-vm` cannot copy arbitrary host objects.
+     *
+     * @param jail - The isolate's global object.
+     * @param logger - The Context logger that receives the forwarded calls.
+     * @param context - The isolate context (for running the init script).
+     */
+    private injectConsole;
 }

package/lib/types/graph/engine/execution/LogGraphNodeExecutor.d.cts

@@ -0,0 +1,19 @@
+/**
+ * @module integrations/graph/execution/LogGraphNodeExecutor
+ * @summary Executor for the Log flow-control node.
+ * @description Logs the input value via the execution context's logger and
+ * forwards it unchanged on the `logged` output port. Useful for debugging,
+ * audit trails, and discard/side-effect branches in a workflow.
+ */
+import type { GraphNodeExecutor } from "./GraphNodeExecutor.d.cts";
+import type { GraphExecutionContext } from "./GraphExecutionContext.d.cts";
+import type { GraphExecutionValues } from "../types.d.cts";
+/**
+ * Executor for `core.flow.log` nodes.
+ *
+ * Reads the `value` input port, logs it through `context.log()`, and returns
+ * it unchanged on the `logged` output port.
+ */
+export declare class LogGraphNodeExecutor implements GraphNodeExecutor {
+    execute(input: GraphExecutionValues, context: GraphExecutionContext): Promise<GraphExecutionValues>;
+}

package/lib/types/graph/engine/execution/LogGraphNodeExecutor.d.mts

@@ -0,0 +1,19 @@
+/**
+ * @module integrations/graph/execution/LogGraphNodeExecutor
+ * @summary Executor for the Log flow-control node.
+ * @description Logs the input value via the execution context's logger and
+ * forwards it unchanged on the `logged` output port. Useful for debugging,
+ * audit trails, and discard/side-effect branches in a workflow.
+ */
+import type { GraphNodeExecutor } from "./GraphNodeExecutor.d.mts";
+import type { GraphExecutionContext } from "./GraphExecutionContext.d.mts";
+import type { GraphExecutionValues } from "../types.d.mts";
+/**
+ * Executor for `core.flow.log` nodes.
+ *
+ * Reads the `value` input port, logs it through `context.log()`, and returns
+ * it unchanged on the `logged` output port.
+ */
+export declare class LogGraphNodeExecutor implements GraphNodeExecutor {
+    execute(input: GraphExecutionValues, context: GraphExecutionContext): Promise<GraphExecutionValues>;
+}

package/lib/types/graph/engine/execution/SwitchGraphNodeExecutor.d.cts

@@ -15,8 +15,9 @@ import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.cts";
  * Executor for `core.flow.switch` nodes.
  *
  * Evaluates each case's condition in order and routes the input to the
- * first matching case's output port. When no case matches, routes to the
- * `default` output port.
+ * first matching case's output port. When no case matches:
+ * - If `hasDefault` is `true`, routes to the `default` output port.
+ * - If `hasDefault` is `false` (the default), throws `GRAPH_SWITCH_NO_MATCH`.
  *
  * Condition evaluation:
  * - `ConditionExpression` — evaluated via {@link ConditionExpressionEvaluator}.

package/lib/types/graph/engine/execution/SwitchGraphNodeExecutor.d.mts

@@ -15,8 +15,9 @@ import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.mts";
  * Executor for `core.flow.switch` nodes.
  *
  * Evaluates each case's condition in order and routes the input to the
- * first matching case's output port. When no case matches, routes to the
- * `default` output port.
+ * first matching case's output port. When no case matches:
+ * - If `hasDefault` is `true`, routes to the `default` output port.
+ * - If `hasDefault` is `false` (the default), throws `GRAPH_SWITCH_NO_MATCH`.
  *
  * Condition evaluation:
  * - `ConditionExpression` — evaluated via {@link ConditionExpressionEvaluator}.