@decaf-ts/integrations 0.6.2 → 0.8.0

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/GraphWorkflowModel.js

@@ -7,9 +7,9 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 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 {
+import { model } from "@decaf-ts/decorator-validation";
+import { BaseModel, column, pk, table } from "@decaf-ts/core";
+let GraphWorkflowModel = class GraphWorkflowModel extends BaseModel {
     constructor(arg) {
         super(arg);
     }
@@ -22,10 +22,6 @@ __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(),

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

@@ -1 +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"}
+{"version":3,"file":"GraphWorkflowModel.js","sourceRoot":"","sources":["../../../../src/nest/graph/GraphWorkflowModel.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAIvD,IAAM,kBAAkB,GAAxB,MAAM,kBAAmB,SAAQ,SAAS;IAO/C,YAAY,GAAiC;QAC3C,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;CACF,CAAA;AARC;IADC,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;;sDACnB;AAGpB;IADC,MAAM,EAAE;;oDAC0B;AALxB,kBAAkB;IAF9B,KAAK,CAAC,yBAAyB,CAAC;IAChC,KAAK,EAAE;;GACK,kBAAkB,CAU9B"}

package/lib/esm/sftp/aws/AwsSftpService.js

@@ -0,0 +1,82 @@
+import { Context, } from "@decaf-ts/core";
+import { InternalError } from "@decaf-ts/db-decorators";
+import { SftpSource, assertSftpConfig, } from "./../core/SftpSource.js";
+export class AwsSftpService extends SftpSource {
+    constructor() {
+        super();
+    }
+    async initialize(...args) {
+        const config = args[0];
+        if (!config || config instanceof Context)
+            throw new InternalError(`No configuration provided`);
+        assertSftpConfig(config);
+        if (!config.region)
+            throw new InternalError("AwsTransferSftpConfig.region is required");
+        if (!config.bucket)
+            throw new InternalError("AwsTransferSftpConfig.bucket is required");
+        const { S3Client } = await import("@aws-sdk/client-s3").catch(() => {
+            throw new InternalError("@aws-sdk/client-s3 not installed; run npm install @aws-sdk/client-s3");
+        });
+        const client = new S3Client({
+            region: config.region,
+        });
+        return { config, client };
+    }
+    s3Prefix() {
+        return this.config.s3Prefix ?? this.config.remotePath ?? "";
+    }
+    async list(remoteDir, 
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    ...args) {
+        const prefix = remoteDir ?? this.s3Prefix();
+        const entries = [];
+        let cursor;
+        do {
+            const page = await this.client.listObjectsV2({
+                Bucket: this.config.bucket,
+                Prefix: prefix,
+                ContinuationToken: cursor,
+            });
+            for (const obj of page.Contents ?? []) {
+                if (!obj.Key)
+                    continue;
+                const name = obj.Key.split("/").pop() ?? obj.Key;
+                entries.push({
+                    path: obj.Key,
+                    name,
+                    size: obj.Size ?? 0,
+                    modifyTime: obj.LastModified?.getTime() ?? 0,
+                    isDirectory: obj.Key.endsWith("/"),
+                });
+            }
+            cursor = page.NextContinuationToken;
+        } while (cursor);
+        return entries;
+    }
+    async fetch(remotePath, 
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    ...args) {
+        const name = remotePath.split("/").pop() ?? remotePath;
+        const response = await this.client.getObject({
+            Bucket: this.config.bucket,
+            Key: remotePath,
+        });
+        const chunks = [];
+        for await (const chunk of response.body) {
+            chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+        }
+        const content = Buffer.concat(chunks);
+        return { path: remotePath, name, content, size: content.length };
+    }
+    async delete(remotePath, 
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    ...args) {
+        await this.client.deleteObject({
+            Bucket: this.config.bucket,
+            Key: remotePath,
+        });
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async close(...args) { }
+}
+//# sourceMappingURL=AwsSftpService.js.map

package/lib/esm/sftp/aws/AwsSftpService.js.map

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

package/lib/esm/sftp/core/SftpSource.js

@@ -0,0 +1,23 @@
+import { ClientBasedService, } from "@decaf-ts/core";
+import { InternalError } from "@decaf-ts/db-decorators";
+export class SftpSource extends ClientBasedService {
+    constructor() {
+        super();
+    }
+    get provider() {
+        return this.config.provider;
+    }
+    get sourceId() {
+        return this.config.sourceId;
+    }
+}
+export function assertSftpConfig(config) {
+    if (!config.host)
+        throw new InternalError("SftpSourceConfig.host is required");
+    if (!config.username)
+        throw new InternalError("SftpSourceConfig.username is required");
+    if (!config.password && !config.privateKey) {
+        throw new InternalError("SftpSourceConfig requires either password or privateKey");
+    }
+}
+//# sourceMappingURL=SftpSource.js.map

package/lib/esm/sftp/core/SftpSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SftpSource.js","sourceRoot":"","sources":["../../../../src/sftp/core/SftpSource.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GAGnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AA+BxD,MAAM,OAAgB,UAGpB,SAAQ,kBAAoC;IAC5C;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;CAsBF;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,IAAI,CAAC,MAAM,CAAC,IAAI;QAAE,MAAM,IAAI,aAAa,CAAC,mCAAmC,CAAC,CAAC;IAC/E,IAAI,CAAC,MAAM,CAAC,QAAQ;QAAE,MAAM,IAAI,aAAa,CAAC,uCAAuC,CAAC,CAAC;IACvF,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC3C,MAAM,IAAI,aAAa,CAAC,yDAAyD,CAAC,CAAC;IACrF,CAAC;AACH,CAAC"}

package/lib/esm/sftp/core/index.js

@@ -0,0 +1,2 @@
+export * from "./SftpSource.js";
+//# sourceMappingURL=index.js.map

package/lib/esm/sftp/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/sftp/core/index.ts"],"names":[],"mappings":"AAAA,gCAA6B"}

package/lib/esm/sftp/index.js

@@ -0,0 +1,4 @@
+export * from "./ssh2/Ssh2SftpService.js";
+export * from "./aws/AwsSftpService.js";
+export * from "./core/SftpSource.js";
+//# sourceMappingURL=index.js.map

package/lib/esm/sftp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sftp/index.ts"],"names":[],"mappings":"AAAA,0CAAuC;AACvC,wCAAqC;AACrC,qCAAkC"}

package/lib/esm/sftp/ssh2/Ssh2SftpService.js

@@ -0,0 +1,135 @@
+import { Context, } from "@decaf-ts/core";
+import { InternalError } from "@decaf-ts/db-decorators";
+import { SftpSource, assertSftpConfig, } from "./../core/SftpSource.js";
+export class Ssh2SftpService extends SftpSource {
+    constructor() {
+        super();
+    }
+    async initialize(...args) {
+        const config = args[0];
+        if (!config || config instanceof Context)
+            throw new InternalError(`No configuration provided`);
+        assertSftpConfig(config);
+        const Client = await import("ssh2")
+            .then((m) => m.Client)
+            .catch(() => {
+            throw new InternalError("ssh2 package not installed; run npm install ssh2");
+        });
+        const client = new Client();
+        return new Promise((resolve, reject) => {
+            client.on("error", (err) => reject(new InternalError(`SFTP connection error: ${err.message}`)));
+            client.on("ready", () => {
+                client.sftp((err, sftp) => {
+                    if (err)
+                        return reject(new InternalError(`SFTP subsystem error: ${err.message}`));
+                    this.sftp = sftp;
+                    resolve({ config, client });
+                });
+            });
+            client.connect({
+                host: config.host,
+                port: config.port ?? 22,
+                username: config.username,
+                password: config.password,
+                privateKey: config.privateKey
+                    ? Buffer.from(config.privateKey)
+                    : undefined,
+                passphrase: config.passphrase,
+                readyTimeout: config.readyTimeout ?? 30_000,
+            });
+        });
+    }
+    async list(remoteDir, 
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    ...args) {
+        const dir = remoteDir ?? this.config.remotePath ?? ".";
+        const sftp = this.requireSftp();
+        return new Promise((resolve, reject) => {
+            sftp.readdir(dir, (err, list) => {
+                if (err)
+                    return reject(new InternalError(`SFTP readdir error: ${err.message}`));
+                resolve(list.map((entry) => ({
+                    path: `${dir}/${entry.filename}`,
+                    name: entry.filename,
+                    size: entry.attrs.size,
+                    modifyTime: entry.attrs.mtime * 1000,
+                    isDirectory: (entry.attrs.mode & 0o170000) === 0o040000,
+                })));
+            });
+        });
+    }
+    async fetch(remotePath, 
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    ...args) {
+        const sftp = this.requireSftp();
+        const name = remotePath.split("/").pop() ?? remotePath;
+        const stat = await new Promise((resolve, reject) => {
+            sftp.stat(remotePath, (err, st) => {
+                if (err)
+                    return reject(new InternalError(`SFTP stat error: ${err.message}`));
+                resolve(st);
+            });
+        });
+        const handle = await new Promise((resolve, reject) => {
+            sftp.open(remotePath, "r", (err, h) => {
+                if (err)
+                    return reject(new InternalError(`SFTP open error: ${err.message}`));
+                resolve(h);
+            });
+        });
+        const chunkSize = 32_768;
+        const chunks = [];
+        let position = 0;
+        while (position < stat.size) {
+            const buf = Buffer.alloc(Math.min(chunkSize, stat.size - position));
+            const bytesRead = await new Promise((resolve, reject) => {
+                sftp.read(handle, buf, 0, buf.length, position, (err, n) => {
+                    if (err)
+                        return reject(new InternalError(`SFTP read error: ${err.message}`));
+                    resolve(n);
+                });
+            });
+            chunks.push(Buffer.from(buf.buffer, 0, bytesRead));
+            position += bytesRead;
+            if (bytesRead === 0)
+                break;
+        }
+        await new Promise((resolve, reject) => {
+            sftp.close(handle, (err) => {
+                if (err)
+                    return reject(new InternalError(`SFTP close error: ${err.message}`));
+                resolve();
+            });
+        });
+        return {
+            path: remotePath,
+            name,
+            content: Buffer.concat(chunks),
+            size: stat.size,
+        };
+    }
+    async delete(remotePath, 
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    ...args) {
+        const sftp = this.requireSftp();
+        return new Promise((resolve, reject) => {
+            sftp.unlink(remotePath, (err) => {
+                if (err)
+                    return reject(new InternalError(`SFTP unlink error: ${err.message}`));
+                resolve();
+            });
+        });
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async close(...args) {
+        this.sftp?.end();
+        this.client?.end();
+        this.sftp = undefined;
+    }
+    requireSftp() {
+        if (!this.sftp)
+            throw new InternalError("SftpSource not initialized; call initialize() first");
+        return this.sftp;
+    }
+}
+//# sourceMappingURL=Ssh2SftpService.js.map

package/lib/esm/sftp/ssh2/Ssh2SftpService.js.map

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

package/lib/esm/user-requests/index.js

@@ -0,0 +1,10 @@
+/**
+ * @module integrations/user-requests
+ * @summary User Request Resolution Engine surface exported to integrations
+ * consumers.
+ * @description Re-exports the `@decaf-ts/ui-decorators/user-requests` barrel so
+ * integrations packages can hand user-request handling to app consumers
+ * through a flat entry point.
+ */
+export * from '@decaf-ts/ui-decorators/user-requests';
+//# sourceMappingURL=index.js.map

package/lib/esm/user-requests/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/user-requests/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,uCAAuC,CAAC"}

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

@@ -1,10 +1,11 @@
 /**
  * @module integrations/graph/execution/GraphExecutionContext
  * @summary Decaf Context for graph node execution.
- * @description Extends Decaf's {@link Context} so node executors receive the same contextual plumbing as task handlers. Executors use the context to emit progress, log messages, and report state through the engine's observer pipeline.
+ * @description Extends Decaf's {@link Context} so node executors receive the same contextual plumbing as task handlers. 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 type { GraphNodeDefinition, GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
+import type { Logger } from "@decaf-ts/logging";
 import type { GraphExecutionEvent, GraphRunId } from "../types.d.cts";
 /**
  * Context passed to every graph node executor.
@@ -12,7 +13,8 @@ import type { GraphExecutionEvent, GraphRunId } from "../types.d.cts";
  * Mirrors the `TaskEngine` / `TaskContext` pattern: the engine creates a
  * `GraphExecutionContext` per node execution and passes it to
  * `executor.execute(inputs, context)`. The executor uses `context.progress(...)`
- * and `context.log(...)` to report intermediate state.
+ * and `context.log(...)` to report intermediate state, and `context.logger`
+ * to emit structured run log lines (DECAF-48 §4.3).
  */
 export declare class GraphExecutionContext extends Context {
     readonly runId: GraphRunId;
@@ -22,6 +24,7 @@ export declare class GraphExecutionContext extends Context {
     readonly path: string[];
     private readonly emitFn;
     readonly metadata: Record<string, unknown>;
+    private readonly runLogger?;
     /**
      * @param runId - Unique identifier for the current execution run.
      * @param parentRunId - Run id of the parent execution (for nested loop bodies).
@@ -32,6 +35,13 @@ export declare class GraphExecutionContext extends Context {
      * @param metadata - Free-form metadata attached to this context.
      */
     constructor(runId: GraphRunId, parentRunId: GraphRunId | undefined, workflow: GraphWorkflowDefinition, node: GraphNodeDefinition, path: string[], emitFn: (event: Partial<GraphExecutionEvent>) => Promise<void>, metadata?: Record<string, unknown>);
+    /**
+     * 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(): Logger;
     /**
      * Emits a partial graph execution event. The engine fills in runId,
      * parentRunId, workflowId, nodeId, and path automatically.

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

@@ -1,10 +1,11 @@
 /**
  * @module integrations/graph/execution/GraphExecutionContext
  * @summary Decaf Context for graph node execution.
- * @description Extends Decaf's {@link Context} so node executors receive the same contextual plumbing as task handlers. Executors use the context to emit progress, log messages, and report state through the engine's observer pipeline.
+ * @description Extends Decaf's {@link Context} so node executors receive the same contextual plumbing as task handlers. 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 type { GraphNodeDefinition, GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
+import type { Logger } from "@decaf-ts/logging";
 import type { GraphExecutionEvent, GraphRunId } from "../types.d.mts";
 /**
  * Context passed to every graph node executor.
@@ -12,7 +13,8 @@ import type { GraphExecutionEvent, GraphRunId } from "../types.d.mts";
  * Mirrors the `TaskEngine` / `TaskContext` pattern: the engine creates a
  * `GraphExecutionContext` per node execution and passes it to
  * `executor.execute(inputs, context)`. The executor uses `context.progress(...)`
- * and `context.log(...)` to report intermediate state.
+ * and `context.log(...)` to report intermediate state, and `context.logger`
+ * to emit structured run log lines (DECAF-48 §4.3).
  */
 export declare class GraphExecutionContext extends Context {
     readonly runId: GraphRunId;
@@ -22,6 +24,7 @@ export declare class GraphExecutionContext extends Context {
     readonly path: string[];
     private readonly emitFn;
     readonly metadata: Record<string, unknown>;
+    private readonly runLogger?;
     /**
      * @param runId - Unique identifier for the current execution run.
      * @param parentRunId - Run id of the parent execution (for nested loop bodies).
@@ -32,6 +35,13 @@ export declare class GraphExecutionContext extends Context {
      * @param metadata - Free-form metadata attached to this context.
      */
     constructor(runId: GraphRunId, parentRunId: GraphRunId | undefined, workflow: GraphWorkflowDefinition, node: GraphNodeDefinition, path: string[], emitFn: (event: Partial<GraphExecutionEvent>) => Promise<void>, metadata?: Record<string, unknown>);
+    /**
+     * 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(): Logger;
     /**
      * Emits a partial graph execution event. The engine fills in runId,
      * parentRunId, workflowId, nodeId, and path automatically.

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

@@ -1,7 +1,7 @@
 /**
  * @module integrations/graph/execution/GraphExecutionEngine
  * @summary Reference graph execution engine.
- * @description Executes graph workflows declared with `@decaf-ts/ui-decorators/graph`, emits events through Decaf's Observable pipeline, supports parallel node execution within topological layers, and returns a complete execution result.
+ * @description Executes graph workflows declared with `@decaf-ts/ui-decorators/graph`, emits events through Decaf's Observable pipeline, supports parallel node execution within topological layers, and returns a complete execution result. Per DECAF-48 §4.4 it also emits `NODE_STATE_CHANGED` / `EDGE_STATE_CHANGED` visual-state events on the same pipeline, and node executors log through the run-scoped `ctx.logger` (streamed over the `graph.run.log` SSE channel).
  */
 import type { Observable } from "@decaf-ts/core";
 import type { GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
@@ -56,11 +56,33 @@ export declare class GraphExecutionEngine implements Observable<[GraphExecutionO
     readonly codeSandboxEvaluator?: CodeSandboxEvaluator;
     constructor(config: GraphExecutionEngineConfig);
     private readonly config;
+    /**
+     * Registers an observer on the engine's event pipeline.
+     *
+     * @param observer - The observer to register.
+     * @returns An unsubscribe function that removes the observer.
+     */
     observe(observer: GraphExecutionObserver): () => void;
+    /**
+     * Unregisters an observer from the engine's event pipeline.
+     *
+     * @param observer - The observer to remove.
+     */
     unObserve(observer: GraphExecutionObserver): void;
+    /**
+     * Dispatches an event to all registered observers.
+     *
+     * @param event - The event to distribute.
+     */
     updateObservers(event: GraphExecutionEvent): Promise<void>;
     /**
      * Executes a workflow with the given inputs and options.
+     *
+     * @param workflow - The workflow definition to execute.
+     * @param inputs - Workflow input values keyed by input port name.
+     * @param options - Optional execution overrides (merged over the defaults).
+     * @returns The complete execution result, including a `runId`, per-node
+     * results, and workflow outputs (or the failure payload).
      */
     execute(workflow: GraphWorkflowDefinition, inputs?: GraphExecutionValues, options?: GraphExecutionOptions): Promise<GraphExecutionResult>;
     /**
@@ -120,6 +142,17 @@ export declare class GraphExecutionEngine implements Observable<[GraphExecutionO
      * Emits an event, records it in the frame, and dispatches to observers.
      */
     private emitEvent;
+    /**
+     * Emits a `NODE_STATE_CHANGED` event (DECAF-48 §4.4) carrying the given
+     * visual state for the node. Rides the existing Observable pipeline; no
+     * second out-of-band channel.
+     */
+    private emitNodeStateChanged;
+    /**
+     * Emits an `EDGE_STATE_CHANGED` event (DECAF-48 §4.4) carrying the given
+     * visual state for a routed edge.
+     */
+    private emitEdgeStateChanged;
     /**
      * Merges default options with the given options.
      */

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

@@ -1,7 +1,7 @@
 /**
  * @module integrations/graph/execution/GraphExecutionEngine
  * @summary Reference graph execution engine.
- * @description Executes graph workflows declared with `@decaf-ts/ui-decorators/graph`, emits events through Decaf's Observable pipeline, supports parallel node execution within topological layers, and returns a complete execution result.
+ * @description Executes graph workflows declared with `@decaf-ts/ui-decorators/graph`, emits events through Decaf's Observable pipeline, supports parallel node execution within topological layers, and returns a complete execution result. Per DECAF-48 §4.4 it also emits `NODE_STATE_CHANGED` / `EDGE_STATE_CHANGED` visual-state events on the same pipeline, and node executors log through the run-scoped `ctx.logger` (streamed over the `graph.run.log` SSE channel).
  */
 import type { Observable } from "@decaf-ts/core";
 import type { GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
@@ -56,11 +56,33 @@ export declare class GraphExecutionEngine implements Observable<[GraphExecutionO
     readonly codeSandboxEvaluator?: CodeSandboxEvaluator;
     constructor(config: GraphExecutionEngineConfig);
     private readonly config;
+    /**
+     * Registers an observer on the engine's event pipeline.
+     *
+     * @param observer - The observer to register.
+     * @returns An unsubscribe function that removes the observer.
+     */
     observe(observer: GraphExecutionObserver): () => void;
+    /**
+     * Unregisters an observer from the engine's event pipeline.
+     *
+     * @param observer - The observer to remove.
+     */
     unObserve(observer: GraphExecutionObserver): void;
+    /**
+     * Dispatches an event to all registered observers.
+     *
+     * @param event - The event to distribute.
+     */
     updateObservers(event: GraphExecutionEvent): Promise<void>;
     /**
      * Executes a workflow with the given inputs and options.
+     *
+     * @param workflow - The workflow definition to execute.
+     * @param inputs - Workflow input values keyed by input port name.
+     * @param options - Optional execution overrides (merged over the defaults).
+     * @returns The complete execution result, including a `runId`, per-node
+     * results, and workflow outputs (or the failure payload).
      */
     execute(workflow: GraphWorkflowDefinition, inputs?: GraphExecutionValues, options?: GraphExecutionOptions): Promise<GraphExecutionResult>;
     /**
@@ -120,6 +142,17 @@ export declare class GraphExecutionEngine implements Observable<[GraphExecutionO
      * Emits an event, records it in the frame, and dispatches to observers.
      */
     private emitEvent;
+    /**
+     * Emits a `NODE_STATE_CHANGED` event (DECAF-48 §4.4) carrying the given
+     * visual state for the node. Rides the existing Observable pipeline; no
+     * second out-of-band channel.
+     */
+    private emitNodeStateChanged;
+    /**
+     * Emits an `EDGE_STATE_CHANGED` event (DECAF-48 §4.4) carrying the given
+     * visual state for a routed edge.
+     */
+    private emitEdgeStateChanged;
     /**
      * Merges default options with the given options.
      */

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

@@ -1,19 +1,25 @@
-/**
- * @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.
+ * Executor for `core.utility.log` / `core.flow.log` nodes.
  *
- * Reads the `value` input port, logs it through `context.log()`, and returns
- * it unchanged on the `logged` output port.
+ * Reads the `value` input port, logs it through `context.logger` at the
+ * configured level, and returns it unchanged on the `logged` output port.
  */
 export declare class LogGraphNodeExecutor implements GraphNodeExecutor {
+    /**
+     * Logs the `value` input through the run's `ctx.logger` and forwards it
+     * unchanged on the `logged` output port.
+     *
+     * The level is read from the node's UI config (`node.props.level`, see
+     * {@link logLevelOf}) and defaults to `info`. The emitted log line carries
+     * the DECAF-48 run attributes and streams over `graph.run.log` through the
+     * shared `ctx.logger` path (DECAF-48 Req-1).
+     *
+     * @param input - Resolved input values keyed by port name (expects `value`).
+     * @param context - The run-scoped execution context exposing `ctx.logger`.
+     * @returns The node's output values keyed by port name (the `logged` port).
+     */
     execute(input: GraphExecutionValues, context: GraphExecutionContext): Promise<GraphExecutionValues>;
 }

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

@@ -1,19 +1,25 @@
-/**
- * @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.
+ * Executor for `core.utility.log` / `core.flow.log` nodes.
  *
- * Reads the `value` input port, logs it through `context.log()`, and returns
- * it unchanged on the `logged` output port.
+ * Reads the `value` input port, logs it through `context.logger` at the
+ * configured level, and returns it unchanged on the `logged` output port.
  */
 export declare class LogGraphNodeExecutor implements GraphNodeExecutor {
+    /**
+     * Logs the `value` input through the run's `ctx.logger` and forwards it
+     * unchanged on the `logged` output port.
+     *
+     * The level is read from the node's UI config (`node.props.level`, see
+     * {@link logLevelOf}) and defaults to `info`. The emitted log line carries
+     * the DECAF-48 run attributes and streams over `graph.run.log` through the
+     * shared `ctx.logger` path (DECAF-48 Req-1).
+     *
+     * @param input - Resolved input values keyed by port name (expects `value`).
+     * @param context - The run-scoped execution context exposing `ctx.logger`.
+     * @returns The node's output values keyed by port name (the `logged` port).
+     */
     execute(input: GraphExecutionValues, context: GraphExecutionContext): Promise<GraphExecutionValues>;
 }

package/lib/types/graph/index.d.cts

@@ -8,4 +8,5 @@
  * Frontend bundles MUST import from `@decaf-ts/integrations/graph/shared`
  * instead to avoid pulling in the execution engine.
  */
+import "./log/LogParameters";
 export * from "./engine/index.d.cts";