@decaf-ts/integrations 0.10.8 → 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/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,111 +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.
-     * @param engine - The owning execution engine, exposed to node classes
-     *   whose `execute` needs engine-level services (nested workflow
-     *   execution, code sandbox evaluation).
-     */
-    constructor(runId, parentRunId, workflowId, document, node, manifest, path, emitFn, metadata = {}, engine) {
-        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;
-        this.engine = engine;
-        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;AAS1D;;;;;;;;GAQG;AACH,MAAM,OAAO,qBAAsB,SAAQ,OAAO;IAGhD;;;;;;;;;;;;;OAaG;IACH,YACW,KAAiB,EACjB,WAAmC,EACnC,UAAkB,EAClB,QAA+B,EAC/B,IAAuB,EACvB,QAAmC,EACnC,IAAc,EACN,MAA8D,EACtE,WAAoC,EAAE,EACtC,MAA6B;QAEtC,KAAK,EAAE,CAAC;QAXC,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;QACtC,WAAM,GAAN,MAAM,CAAuB;QAGtC,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"}