@decaf-ts/integrations 0.10.8 → 0.11.0

package/lib/cjs/graph/engine/execution/GraphExecutionContext.cjs

@@ -1,116 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GraphExecutionContext = void 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.
- */
-const core_1 = require("@decaf-ts/core");
-const graph_1 = require("@decaf-ts/ui-decorators/graph");
-const GraphRunLogger_js_1 = require("./../../log/GraphRunLogger.cjs");
-/**
- * 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).
- */
-class GraphExecutionContext extends core_1.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_js_1.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: graph_1.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: graph_1.GraphExecutionEventType.NODE_OUTPUT,
-            payload: {
-                message,
-                payload,
-            },
-        });
-    }
-}
-exports.GraphExecutionContext = GraphExecutionContext;
-//# sourceMappingURL=GraphExecutionContext.js.map
-//# sourceMappingURL=GraphExecutionContext.cjs.map

package/lib/cjs/graph/engine/execution/GraphExecutionContext.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"graph/engine/execution/GraphExecutionContext.cjs","sourceRoot":"","sources":["graph/engine/execution/GraphExecutionContext.js"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;GAYG;AACH,yCAAyC;AACzC,yDAAwE;AACxE,qEAA+D;AAC/D;;;;;;;;GAQG;AACH,MAAa,qBAAsB,SAAQ,cAAO;IAC9C;;;;;;;;;;;;;OAaG;IACH,YAAY,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAG,EAAE,EAAE,MAAM;QACrG,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,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,kCAAc,CAAC;YAChC,KAAK;YACL,UAAU;YACV,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,IAAI;YACJ,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACrB,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;SACJ,CAAC,CAAC;IACP,CAAC;IACD;;;;;OAKG;IACH,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IACD;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,KAAK;QACZ,MAAM,IAAI,CAAC,MAAM,CAAC;YACd,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;SAChC,CAAC,CAAC;IACP,CAAC;IACD;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAO;QAClB,MAAM,IAAI,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,+BAAuB,CAAC,WAAW;YACzC,OAAO;SACV,CAAC,CAAC;IACP,CAAC;IACD;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO;QACtB,MAAM,IAAI,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,+BAAuB,CAAC,WAAW;YACzC,OAAO,EAAE;gBACL,OAAO;gBACP,OAAO;aACV;SACJ,CAAC,CAAC;IACP,CAAC;CACJ;AApFD,sDAoFC;AACD,iDAAiD"}