@decaf-ts/integrations 0.10.5 → 0.11.0

package/lib/esm/graph/engine/events/GraphExecutionEventFactory.js

@@ -1,32 +0,0 @@
-/**
- * Factory that enriches partial events with a unique id, an incrementing
- * sequence number, and a timestamp.
- */
-export class GraphExecutionEventFactory {
-    constructor() {
-        this.sequence = 0;
-    }
-    /**
-     * Creates a fully-populated event from the given base fields.
-     *
-     * @param base - All event fields except `id`, `sequence`, and `timestamp`.
-     * @returns A complete {@link GraphExecutionEvent}.
-     */
-    create(base) {
-        return {
-            ...base,
-            id: this.createEventId(),
-            sequence: ++this.sequence,
-            timestamp: new Date(),
-        };
-    }
-    /**
-     * Generates a unique event id using `crypto.randomUUID` when available,
-     * falling back to a timestamp + random string.
-     */
-    createEventId() {
-        return (globalThis.crypto?.randomUUID?.() ??
-            `${Date.now()}-${Math.random().toString(36).slice(2)}`);
-    }
-}
-//# sourceMappingURL=GraphExecutionEventFactory.js.map

package/lib/esm/graph/engine/events/GraphExecutionEventFactory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"GraphExecutionEventFactory.js","sourceRoot":"","sources":["../../../../../src/graph/engine/events/GraphExecutionEventFactory.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,MAAM,OAAO,0BAA0B;IAAvC;QACU,aAAQ,GAAG,CAAC,CAAC;IA6BvB,CAAC;IA3BC;;;;;OAKG;IACH,MAAM,CACJ,IAAgE;QAEhE,OAAO;YACL,GAAG,IAAI;YACP,EAAE,EAAE,IAAI,CAAC,aAAa,EAAE;YACxB,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ;YACzB,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,aAAa;QACnB,OAAO,CACL,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE;YACjC,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CACvD,CAAC;IACJ,CAAC;CACF"}

package/lib/esm/graph/engine/events/GraphExecutionObserver.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=GraphExecutionObserver.js.map

package/lib/esm/graph/engine/events/GraphExecutionObserver.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"GraphExecutionObserver.js","sourceRoot":"","sources":["../../../../../src/graph/engine/events/GraphExecutionObserver.ts"],"names":[],"mappings":""}

package/lib/esm/graph/engine/events/index.js

@@ -1,9 +0,0 @@
-/**
- * @module integrations/graph/events
- * @summary Graph execution event pipeline.
- * @description Re-exports the observer interface, event emitter, and event factory.
- */
-export * from "./GraphExecutionObserver.js";
-export * from "./GraphExecutionEventEmitter.js";
-export * from "./GraphExecutionEventFactory.js";
-//# sourceMappingURL=index.js.map

package/lib/esm/graph/engine/events/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/graph/engine/events/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,4CAAyC;AACzC,gDAA6C;AAC7C,gDAA6C"}

package/lib/esm/graph/engine/execution/BreakGraphNodeExecutor.js

@@ -1,19 +0,0 @@
-import { GraphBreakSignal } from "./../errors/GraphBreakSignal.js";
-/**
- * Executor for `core.flow.break` nodes.
- *
- * Reads the optional `value` input port and throws a {@link GraphBreakSignal}
- * carrying it. The enclosing loop executor (`core.loop.foreach`,
- * `core.loop.while`, `core.loop.until`) catches the signal, stops iterating,
- * and returns the results collected so far (plus the carried value as the
- * final partial result).
- */
-export class BreakGraphNodeExecutor {
-    async execute(request, 
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    _context) {
-        const value = request.inputs["value"];
-        throw new GraphBreakSignal(value);
-    }
-}
-//# sourceMappingURL=BreakGraphNodeExecutor.js.map

package/lib/esm/graph/engine/execution/BreakGraphNodeExecutor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"BreakGraphNodeExecutor.js","sourceRoot":"","sources":["../../../../../src/graph/engine/execution/BreakGraphNodeExecutor.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,gBAAgB,EAAE,wCAAmC;AAE9D;;;;;;;;GAQG;AACH,MAAM,OAAO,sBAAsB;IACjC,KAAK,CAAC,OAAO,CACX,OAAkC;IAClC,6DAA6D;IAC7D,QAA+B;QAE/B,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,IAAI,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;CACF"}

package/lib/esm/graph/engine/execution/CodeGraphNodeExecutor.js

@@ -1,98 +0,0 @@
-import { GraphExecutionError } from "./../errors/GraphExecutionError.js";
-import { GraphInputError } from "./../errors/GraphInputError.js";
-/**
- * Reads the Code node metadata from the canonical node instance (DECAF-50):
- * configuration lives in the instance `parameters` with `metadata` as the
- * legacy fallback (the §4.18 transition compiler mirrors legacy
- * `graph.metadata` bags into instance metadata).
- */
-function readCodeMetadata(context) {
-    const parameters = context.node.parameters;
-    const metadata = context.node.metadata;
-    const source = { ...(metadata ?? {}), ...parameters };
-    return source;
-}
-/**
- * Executor for `core.flow.code` nodes.
- *
- * The Code Node runs user-authored JS/TS in a restricted sandbox. The engine
- * does not implement the sandbox directly (§22.4); instead it delegates to the
- * pluggable {@link CodeSandboxEvaluator} registered on the engine config. When
- * 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 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.
- */
-export class CodeGraphNodeExecutor {
-    /**
-     * @param engine - The graph execution engine (or any object exposing the
-     *   optional `codeSandboxEvaluator`). This mirrors the pattern used by
-     * {@link SwitchGraphNodeExecutor} for code conditions.
-     */
-    constructor(engine) {
-        this.engine = engine;
-    }
-    async execute(request, context) {
-        const meta = readCodeMetadata(context);
-        const input = request.inputs;
-        const code = input["code"] ?? meta.defaultCode;
-        if (!code || typeof code !== "string" || code.trim().length === 0) {
-            throw new GraphInputError("Code node has no code to execute (input.code is empty)", { input });
-        }
-        const evaluator = this.engine?.codeSandboxEvaluator;
-        if (!evaluator) {
-            throw new GraphExecutionError("Code node execution requires a CodeSandboxEvaluator to be registered in GraphExecutionEngineConfig.codeSandboxEvaluator", "GRAPH_CODE_SANDBOX_NOT_CONFIGURED", { code });
-        }
-        const sandboxContext = this.buildSandboxContext(input, context);
-        await context.log("Executing code node", {
-            language: "javascript",
-            length: code.length,
-            timeoutMs: meta.timeoutMs,
-        });
-        const result = await evaluator.evaluate(sandboxContext);
-        await context.log("Code node executed", { hasResult: result !== undefined });
-        return { result };
-    }
-    /**
-     * Builds the {@link CodeSandboxContext} from the executor input and the
-     * graph execution context.
-     *
-     * 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
-     * populate these when the Code node runs inside a loop body or a workflow
-     * with variables.
-     */
-    buildSandboxContext(input, context) {
-        const md = context.metadata;
-        const meta = readCodeMetadata(context);
-        const code = input["code"] ?? meta.defaultCode ?? "";
-        return {
-            code,
-            language: "javascript",
-            input: input,
-            vars: md?.vars ?? undefined,
-            item: md?.item,
-            index: md?.index,
-            nodes: md?.nodes ??
-                undefined,
-            logger: context.logger,
-        };
-    }
-}
-//# sourceMappingURL=CodeGraphNodeExecutor.js.map

package/lib/esm/graph/engine/execution/CodeGraphNodeExecutor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"CodeGraphNodeExecutor.js","sourceRoot":"","sources":["../../../../../src/graph/engine/execution/CodeGraphNodeExecutor.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,mBAAmB,EAAE,2CAAsC;AACpE,OAAO,EAAE,eAAe,EAAE,uCAAkC;AAW5D;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,OAA8B;IACtD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,UAAqC,CAAC;IACtE,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,QAA+C,CAAC;IAC9E,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,UAAU,EAAE,CAAC;IACtD,OAAO,MAA0B,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,qBAAqB;IAChC;;;;OAIG;IACH,YACmB,MAAwD;QAAxD,WAAM,GAAN,MAAM,CAAkD;IACxE,CAAC;IAEJ,KAAK,CAAC,OAAO,CACX,OAAkC,EAClC,OAA8B;QAE9B,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,MAAM,IAAI,GAAI,KAAK,CAAC,MAAM,CAAwB,IAAI,IAAI,CAAC,WAAW,CAAC;QAEvE,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,eAAe,CACvB,wDAAwD,EACxD,EAAE,KAAK,EAAE,CACV,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,oBAAoB,CAAC;QACpD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,mBAAmB,CAC3B,yHAAyH,EACzH,mCAAmC,EACnC,EAAE,IAAI,EAAE,CACT,CAAC;QACJ,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAEhE,MAAM,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE;YACvC,QAAQ,EAAE,YAAY;YACtB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAExD,MAAM,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,SAAS,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC,CAAC;QAE7E,OAAO,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC;IAED;;;;;;;;;;;OAWG;IACK,mBAAmB,CACzB,KAA2B,EAC3B,OAA8B;QAE9B,MAAM,EAAE,GAAG,OAAO,CAAC,QAA+C,CAAC;QACnE,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,IAAI,GAAI,KAAK,CAAC,MAAM,CAAwB,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;QAE7E,OAAO;YACL,IAAI;YACJ,QAAQ,EAAE,YAAY;YACtB,KAAK,EAAE,KAAgC;YACvC,IAAI,EAAG,EAAE,EAAE,IAA4C,IAAI,SAAS;YACpE,IAAI,EAAE,EAAE,EAAE,IAAI;YACd,KAAK,EAAE,EAAE,EAAE,KAA2B;YACtC,KAAK,EACF,EAAE,EAAE,KAA6D;gBAClE,SAAS;YACX,MAAM,EAAE,OAAO,CAAC,MAA8C;SAC/D,CAAC;IACJ,CAAC;CACF"}

package/lib/esm/graph/engine/execution/CodeSandboxEvaluator.js

@@ -1,18 +0,0 @@
-/**
- * @module integrations/graph/execution/CodeSandboxEvaluator
- * @summary Pluggable contract for evaluating code-based conditions (DECAF-32 §22.4).
- * @description The engine does NOT implement the VM sandbox directly (§22.4).
- * Downstream projects (e.g. ALFRED) register a `CodeSandboxEvaluator` via the
- * `GraphExecutionEngineConfig.codeSandboxEvaluator` field. When absent, code
- * conditions throw a `GRAPH_CODE_SANDBOX_NOT_CONFIGURED` error.
- *
- * The sandbox must follow the same restrictions as the Code Node (§22.4):
- * - No system API access (`require`, `process`, `fs`, `child_process`, etc.)
- * - Placeholder syntax for workflow data references (`{{ $input.foo }}`,
- *   `{{ $node["Name"].output }}`, `{{ $vars.bar }}`, etc.)
- * - Static code validation (e.g. `acorn`-based) before execution
- * - The code must return a boolean value (for conditions) or any value
- *   (for Code Node transforms)
- */
-export {};
-//# sourceMappingURL=CodeSandboxEvaluator.js.map

package/lib/esm/graph/engine/execution/CodeSandboxEvaluator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"CodeSandboxEvaluator.js","sourceRoot":"","sources":["../../../../../src/graph/engine/execution/CodeSandboxEvaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/lib/esm/graph/engine/execution/GraphExecutionContext.js

@@ -1,107 +0,0 @@
-/**
- * @module integrations/graph/execution/GraphExecutionContext
- * @summary Decaf Context for graph node execution (DECAF-50 §4.9).
- * @description Extends Decaf's {@link Context} so node executors receive the
- * same contextual plumbing as task handlers. The context carries the
- * canonical workflow document, the executing node's canonical instance, and
- * its effective resolved manifest — never a raw node definition. Executors
- * use the context to emit progress, log messages, and report state through
- * the engine's observer pipeline. Each context also exposes a run-scoped
- * `ctx.logger` (DECAF-48 §4.3) bound to the executing node's `runId` /
- * `workflowId` / `nodeId` / `user`, so every log line streams over
- * `graph.run.log` with the DECAF-9 custom attributes.
- */
-import { Context } from "@decaf-ts/core";
-import { GraphExecutionEventType } from "@decaf-ts/ui-decorators/graph";
-import { GraphRunLogger } from "./../../log/GraphRunLogger.js";
-/**
- * Context passed to every graph node executor.
- *
- * The engine creates a `GraphExecutionContext` per node execution and passes
- * it to the executor alongside the node's inputs/parameters. The executor
- * uses `context.progress(...)` and `context.log(...)` to report intermediate
- * state, and `context.logger` to emit structured run log lines (DECAF-48
- * §4.3).
- */
-export class GraphExecutionContext extends Context {
-    /**
-     * @param runId - Unique identifier for the current execution run.
-     * @param parentRunId - Run id of the parent execution (for nested loop bodies).
-     * @param workflowId - The canonical workflow document id.
-     * @param document - The canonical workflow document being executed.
-     * @param node - The canonical node instance being executed.
-     * @param manifest - The effective (dynamics-expanded) manifest for the node.
-     * @param path - Dotted path from the workflow root to this node.
-     * @param emitFn - Callback invoked when an event is emitted from this context.
-     * @param metadata - Free-form metadata attached to this context.
-     */
-    constructor(runId, parentRunId, workflowId, document, node, manifest, path, emitFn, metadata = {}) {
-        super();
-        this.runId = runId;
-        this.parentRunId = parentRunId;
-        this.workflowId = workflowId;
-        this.document = document;
-        this.node = node;
-        this.manifest = manifest;
-        this.path = path;
-        this.emitFn = emitFn;
-        this.metadata = metadata;
-        const user = typeof metadata?.["user"] === "string" ? metadata["user"] : null;
-        this.runLogger = new GraphRunLogger({
-            runId,
-            workflowId,
-            nodeId: node.id,
-            user,
-            forward: async (event) => {
-                await this.emit(event);
-            },
-        });
-    }
-    /**
-     * The decaf-ts {@link Logger} bound to this node's run context. Every log
-     * line carries the DECAF-48 attributes (`nodeId` / `workflowId` / `runId` /
-     * `user`) and is forwarded onto the existing graph execution Observable as
-     * a `GRAPH_RUN_LOG` event (streamed over the `graph.run.log` SSE channel).
-     */
-    get logger() {
-        return this.runLogger;
-    }
-    /**
-     * Emits a partial graph execution event. The engine fills in runId,
-     * parentRunId, workflowId, nodeId, and path automatically.
-     */
-    async emit(event) {
-        await this.emitFn({
-            ...event,
-            runId: this.runId,
-            parentRunId: this.parentRunId,
-            workflowId: this.workflowId,
-            nodeId: this.node.id,
-            path: event.path ?? this.path,
-        });
-    }
-    /**
-     * Emits a `NODE_OUTPUT` event with the given payload, useful for reporting
-     * intermediate progress from within a node executor.
-     */
-    async progress(payload) {
-        await this.emit({
-            type: GraphExecutionEventType.NODE_OUTPUT,
-            payload,
-        });
-    }
-    /**
-     * Emits a `NODE_OUTPUT` event with a structured `{ message, payload }` shape
-     * so executors can log human-readable messages.
-     */
-    async log(message, payload) {
-        await this.emit({
-            type: GraphExecutionEventType.NODE_OUTPUT,
-            payload: {
-                message,
-                payload,
-            },
-        });
-    }
-}
-//# sourceMappingURL=GraphExecutionContext.js.map

package/lib/esm/graph/engine/execution/GraphExecutionContext.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"GraphExecutionContext.js","sourceRoot":"","sources":["../../../../../src/graph/engine/execution/GraphExecutionContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAOzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAExE,OAAO,EAAE,cAAc,EAAE,sCAAiC;AAQ1D;;;;;;;;GAQG;AACH,MAAM,OAAO,qBAAsB,SAAQ,OAAO;IAGhD;;;;;;;;;;OAUG;IACH,YACW,KAAiB,EACjB,WAAmC,EACnC,UAAkB,EAClB,QAA+B,EAC/B,IAAuB,EACvB,QAAmC,EACnC,IAAc,EACN,MAA8D,EACtE,WAAoC,EAAE;QAE/C,KAAK,EAAE,CAAC;QAVC,UAAK,GAAL,KAAK,CAAY;QACjB,gBAAW,GAAX,WAAW,CAAwB;QACnC,eAAU,GAAV,UAAU,CAAQ;QAClB,aAAQ,GAAR,QAAQ,CAAuB;QAC/B,SAAI,GAAJ,IAAI,CAAmB;QACvB,aAAQ,GAAR,QAAQ,CAA2B;QACnC,SAAI,GAAJ,IAAI,CAAU;QACN,WAAM,GAAN,MAAM,CAAwD;QACtE,aAAQ,GAAR,QAAQ,CAA8B;QAG/C,MAAM,IAAI,GAAG,OAAO,QAAQ,EAAE,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9E,IAAI,CAAC,SAAS,GAAG,IAAI,cAAc,CAAC;YAClC,KAAK;YACL,UAAU;YACV,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,IAAI;YACJ,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACvB,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,SAAU,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,KAAmC;QAC5C,MAAM,IAAI,CAAC,MAAM,CAAC;YAChB,GAAG,KAAK;YACR,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI;SAC9B,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAgB;QAC7B,MAAM,IAAI,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,uBAAuB,CAAC,WAAW;YACzC,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,OAAe,EAAE,OAAiB;QAC1C,MAAM,IAAI,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,uBAAuB,CAAC,WAAW;YACzC,OAAO,EAAE;gBACP,OAAO;gBACP,OAAO;aACR;SACF,CAAC,CAAC;IACL,CAAC;CACF"}