@decaf-ts/integrations 0.8.0 → 0.10.0

package/lib/esm/graph/shared/nodes/triggers.js

@@ -1,241 +0,0 @@
-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);
-};
-/**
- * @module integrations/graph/nodes/triggers
- * @summary Production trigger node kind declarations (DECAF-32 §22.2.1).
- * @description Canonical `@node`-decorated classes for the six ALFRED-5 trigger
- * kinds. Triggers are metadata-only entrypoints: they define how a workflow
- * starts and produce a trigger payload on their `@output` ports. They have no
- * `@input` ports (nothing feeds a trigger) and no built-in executors — the
- * engine's execution model starts from workflow inputs (§5.8) and treats
- * trigger nodes as metadata-only entrypoints.
- */
-import { Model, model, required } from "@decaf-ts/decorator-validation";
-import { uielement } from "@decaf-ts/ui-decorators";
-import { node, output } from "@decaf-ts/ui-decorators/graph";
-/**
- * Manual trigger — user clicks Run; input form generated from `inputSchema`.
- */
-let ManualTriggerNode = class ManualTriggerNode extends Model {
-};
-__decorate([
-    required(),
-    uielement("textarea", { label: "Trigger payload", placeholder: "Manual trigger payload" }),
-    output({ handle: "payload" }),
-    __metadata("design:type", Object)
-], ManualTriggerNode.prototype, "payload", void 0);
-ManualTriggerNode = __decorate([
-    node("core.trigger.manual", {
-        kind: "core.trigger.manual",
-        category: "Trigger",
-        color: "#3b82f6",
-        icon: "ti-hand-click",
-        width: 96,
-        height: 96,
-        labels: ["trigger", "manual", "entrypoint"],
-        metadata: {
-            title: "Manual trigger",
-            description: "Starts the workflow when the user clicks Run. The input form is generated from the trigger's input schema.",
-            trigger: {
-                type: "manual",
-                inputSchema: {},
-            },
-        },
-    }),
-    model()
-], ManualTriggerNode);
-export { ManualTriggerNode };
-/**
- * Webhook trigger — HTTP request received; path/method/auth/responseMode config.
- */
-let WebhookTriggerNode = class WebhookTriggerNode extends Model {
-};
-__decorate([
-    required(),
-    uielement("textarea", { label: "Request payload", placeholder: "Webhook request body" }),
-    output({ handle: "payload" }),
-    __metadata("design:type", Object)
-], WebhookTriggerNode.prototype, "payload", void 0);
-WebhookTriggerNode = __decorate([
-    node("core.trigger.webhook", {
-        kind: "core.trigger.webhook",
-        category: "Trigger",
-        color: "#0ea5e9",
-        icon: "ti-webhook",
-        width: 96,
-        height: 96,
-        labels: ["trigger", "webhook", "http"],
-        metadata: {
-            title: "Webhook trigger",
-            description: "Starts the workflow when an HTTP request is received on the configured path and method.",
-            trigger: {
-                type: "webhook",
-                path: "/webhook",
-                method: "POST",
-                auth: "none",
-                responseMode: "onReceived",
-            },
-        },
-    }),
-    model()
-], WebhookTriggerNode);
-export { WebhookTriggerNode };
-/**
- * Schedule trigger — cron-like schedule; timezone + payload config.
- */
-let ScheduleTriggerNode = class ScheduleTriggerNode extends Model {
-};
-__decorate([
-    required(),
-    uielement("textarea", { label: "Scheduled payload", placeholder: "Payload for the scheduled run" }),
-    output({ handle: "payload" }),
-    __metadata("design:type", Object)
-], ScheduleTriggerNode.prototype, "payload", void 0);
-ScheduleTriggerNode = __decorate([
-    node("core.trigger.schedule", {
-        kind: "core.trigger.schedule",
-        category: "Trigger",
-        color: "#6366f1",
-        icon: "ti-calendar-time",
-        width: 96,
-        height: 96,
-        labels: ["trigger", "schedule", "cron"],
-        metadata: {
-            title: "Schedule trigger",
-            description: "Starts the workflow on a cron-like schedule with timezone support.",
-            trigger: {
-                type: "schedule",
-                schedule: "0 * * * *",
-                timezone: "UTC",
-            },
-        },
-    }),
-    model()
-], ScheduleTriggerNode);
-export { ScheduleTriggerNode };
-/**
- * Event trigger — internal event bus topic subscriber.
- */
-let EventTriggerNode = class EventTriggerNode extends Model {
-};
-__decorate([
-    required(),
-    uielement("textarea", { label: "Event payload", placeholder: "Event bus payload" }),
-    output({ handle: "payload" }),
-    __metadata("design:type", Object)
-], EventTriggerNode.prototype, "payload", void 0);
-EventTriggerNode = __decorate([
-    node("core.trigger.event", {
-        kind: "core.trigger.event",
-        category: "Trigger",
-        color: "#8b5cf6",
-        icon: "ti-broadcast",
-        width: 96,
-        height: 96,
-        labels: ["trigger", "event", "bus"],
-        metadata: {
-            title: "Event trigger",
-            description: "Starts the workflow when an event is published on the configured internal event bus topic.",
-            trigger: {
-                type: "event",
-                topic: "default",
-            },
-        },
-    }),
-    model()
-], EventTriggerNode);
-export { EventTriggerNode };
-/**
- * Form trigger — generated public/internal form; field definitions.
- */
-let FormTriggerNode = class FormTriggerNode extends Model {
-};
-__decorate([
-    required(),
-    uielement("textarea", { label: "Form submission", placeholder: "Form submission payload" }),
-    output({ handle: "payload" }),
-    __metadata("design:type", Object)
-], FormTriggerNode.prototype, "payload", void 0);
-FormTriggerNode = __decorate([
-    node("core.trigger.form", {
-        kind: "core.trigger.form",
-        category: "Trigger",
-        color: "#ec4899",
-        icon: "ti-forms",
-        width: 96,
-        height: 96,
-        labels: ["trigger", "form", "public"],
-        metadata: {
-            title: "Form trigger",
-            description: "Starts the workflow when a generated form is submitted. Field definitions drive the form schema.",
-            trigger: {
-                type: "form",
-                fields: [],
-            },
-        },
-    }),
-    model()
-], FormTriggerNode);
-export { FormTriggerNode };
-/**
- * Chat trigger — chat message entrypoint; message/sessionId/userId schema.
- */
-let ChatTriggerNode = class ChatTriggerNode extends Model {
-};
-__decorate([
-    required(),
-    uielement("input", { label: "Message", placeholder: "Incoming chat message" }),
-    output({ handle: "message" }),
-    __metadata("design:type", String)
-], ChatTriggerNode.prototype, "message", void 0);
-__decorate([
-    required(),
-    uielement("input", { label: "Session ID", placeholder: "Chat session identifier" }),
-    output({ handle: "sessionId" }),
-    __metadata("design:type", String)
-], ChatTriggerNode.prototype, "sessionId", void 0);
-__decorate([
-    required(),
-    uielement("input", { label: "User ID", placeholder: "Chat user identifier" }),
-    output({ handle: "userId" }),
-    __metadata("design:type", String)
-], ChatTriggerNode.prototype, "userId", void 0);
-ChatTriggerNode = __decorate([
-    node("core.trigger.chat", {
-        kind: "core.trigger.chat",
-        category: "Trigger",
-        color: "#14b8a6",
-        icon: "ti-message-circle",
-        width: 96,
-        height: 96,
-        labels: ["trigger", "chat", "entrypoint"],
-        metadata: {
-            title: "Chat trigger",
-            description: "Starts the workflow when a chat message is received. Emits message, sessionId, and userId.",
-            trigger: {
-                type: "chat",
-            },
-        },
-    }),
-    model()
-], ChatTriggerNode);
-export { ChatTriggerNode };
-/**
- * All built-in trigger node constructors.
- */
-export const GRAPH_TRIGGER_NODES = [
-    ManualTriggerNode,
-    WebhookTriggerNode,
-    ScheduleTriggerNode,
-    EventTriggerNode,
-    FormTriggerNode,
-    ChatTriggerNode,
-];
-//# sourceMappingURL=triggers.js.map

package/lib/esm/graph/shared/nodes/triggers.js.map

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

package/lib/types/graph/engine/events/GraphExecutionEvent.d.cts

@@ -1,6 +0,0 @@
-/**
- * @module integrations/graph/events/GraphExecutionEvent
- * @summary Re-export of the GraphExecutionEvent type for the events subpath.
- * @description The GraphExecutionEvent interface is defined in the shared types module and re-exported here for convenience.
- */
-export type { GraphExecutionEvent } from "../types.d.cts";

package/lib/types/graph/engine/events/GraphExecutionEvent.d.mts

@@ -1,6 +0,0 @@
-/**
- * @module integrations/graph/events/GraphExecutionEvent
- * @summary Re-export of the GraphExecutionEvent type for the events subpath.
- * @description The GraphExecutionEvent interface is defined in the shared types module and re-exported here for convenience.
- */
-export type { GraphExecutionEvent } from "../types.d.mts";

package/lib/types/graph/engine/planning/GraphRelationResolver.d.cts

@@ -1,62 +0,0 @@
-/**
- * @module integrations/graph/planning/GraphRelationResolver
- * @summary Normalizes workflow relations into execution edges.
- * @description Resolves workflow boundary aliases, validates endpoints and ports, and produces stable edge IDs.
- */
-import type { GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
-import type { GraphExecutionPlanEdge } from "./GraphExecutionPlanEdge.d.cts";
-/**
- * Resolves raw workflow relation metadata into normalized execution edges.
- */
-export declare class GraphRelationResolver {
-    /**
-     * Resolves all relations of a workflow into execution edges.
-     *
-     * @param workflow - The workflow definition.
-     * @returns Array of normalized edges.
-     * @throws {GraphTopologyError} when an endpoint is unknown or ambiguous.
-     * @throws {GraphPortError} when a referenced port is missing or unknown.
-     */
-    resolve(workflow: GraphWorkflowDefinition): GraphExecutionPlanEdge[];
-    /**
-     * Resolves a single relation into an edge.
-     */
-    private resolveRelation;
-    /**
-     * Resolves an endpoint (source or target) to a node id or the workflow boundary.
-     */
-    private resolveEndpoint;
-    /**
-     * Validates that a port exists on the given node or boundary.
-     */
-    private validatePort;
-    /**
-     * Builds the set of boundary aliases for a workflow.
-     */
-    private boundaryAliases;
-    /**
-     * Extracts port names from a list of port definitions.
-     */
-    private portNames;
-    /**
-     * Builds a map of node id -> { input ports, output ports }.
-     */
-    private buildNodePortMap;
-    /**
-     * Attempts to resolve a node's full definition from its metadata.
-     *
-     * Accepts either a decorated Model class/instance (resolved via
-     * `graphDefinitionOf`) or a plain `GraphNodeDefinition`-shaped object
-     * (useful for serialized workflows that inline node definitions).
-     */
-    private resolveNodeDefinition;
-    /**
-     * Returns `true` when a value looks like a raw {@link GraphNodeDefinition}
-     * (a plain object with a `ports` array and a `name` string).
-     */
-    private isRawDefinition;
-    /**
-     * Creates a stable edge id from its endpoints and ports.
-     */
-    private createEdgeId;
-}

package/lib/types/graph/engine/planning/GraphRelationResolver.d.mts

@@ -1,62 +0,0 @@
-/**
- * @module integrations/graph/planning/GraphRelationResolver
- * @summary Normalizes workflow relations into execution edges.
- * @description Resolves workflow boundary aliases, validates endpoints and ports, and produces stable edge IDs.
- */
-import type { GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
-import type { GraphExecutionPlanEdge } from "./GraphExecutionPlanEdge.d.mts";
-/**
- * Resolves raw workflow relation metadata into normalized execution edges.
- */
-export declare class GraphRelationResolver {
-    /**
-     * Resolves all relations of a workflow into execution edges.
-     *
-     * @param workflow - The workflow definition.
-     * @returns Array of normalized edges.
-     * @throws {GraphTopologyError} when an endpoint is unknown or ambiguous.
-     * @throws {GraphPortError} when a referenced port is missing or unknown.
-     */
-    resolve(workflow: GraphWorkflowDefinition): GraphExecutionPlanEdge[];
-    /**
-     * Resolves a single relation into an edge.
-     */
-    private resolveRelation;
-    /**
-     * Resolves an endpoint (source or target) to a node id or the workflow boundary.
-     */
-    private resolveEndpoint;
-    /**
-     * Validates that a port exists on the given node or boundary.
-     */
-    private validatePort;
-    /**
-     * Builds the set of boundary aliases for a workflow.
-     */
-    private boundaryAliases;
-    /**
-     * Extracts port names from a list of port definitions.
-     */
-    private portNames;
-    /**
-     * Builds a map of node id -> { input ports, output ports }.
-     */
-    private buildNodePortMap;
-    /**
-     * Attempts to resolve a node's full definition from its metadata.
-     *
-     * Accepts either a decorated Model class/instance (resolved via
-     * `graphDefinitionOf`) or a plain `GraphNodeDefinition`-shaped object
-     * (useful for serialized workflows that inline node definitions).
-     */
-    private resolveNodeDefinition;
-    /**
-     * Returns `true` when a value looks like a raw {@link GraphNodeDefinition}
-     * (a plain object with a `ports` array and a `name` string).
-     */
-    private isRawDefinition;
-    /**
-     * Creates a stable edge id from its endpoints and ports.
-     */
-    private createEdgeId;
-}

package/lib/types/graph/shared/GraphExecutionStateMapper.d.cts

@@ -1,66 +0,0 @@
-/**
- * @module integrations/graph/shared/GraphExecutionStateMapper
- * @summary Maps engine state to the frontend-safe visual-state contract.
- * @description Pure, engine-agnostic helpers that derive
- * {@link GraphVisualState} values from engine execution signals. Frontend
- * bundles may import this from `@decaf-ts/integrations/graph/shared` (no
- * engine runtime dependency); a future Mastra/NestJS driver maps its own
- * runtime states onto {@link GraphVisualState} with the same rules.
- */
-import type { GraphExecutionEvent } from "./types.d.cts";
-import { GraphExecutionStatus, GraphVisualState } from "./constants.d.cts";
-/**
- * Maps an engine execution {@link GraphExecutionStatus} to the shared visual
- * state. `CACHED` collapses onto {@link GraphVisualState.SUCCEEDED} for
- * rendering; `CANCELLED`/`PENDING`/`PLANNING` yield `IDLE`.
- *
- * @param status - The engine execution status, if any.
- * @returns The visual state for the node/edge.
- */
-export declare function mapExecutionStatus(status?: GraphExecutionStatus): GraphVisualState;
-/**
- * Options describing a single node's position within a run (DECAF-48 §4.4).
- */
-export interface GraphVisualStateDerivation {
-    /** Whether the node has already executed (any terminal engine status). */
-    executed: boolean;
-    /** Whether the node is currently running. */
-    running: boolean;
-    /** Whether the node completed successfully (or from cache). */
-    succeeded?: boolean;
-    /** Whether the node failed. */
-    failed?: boolean;
-    /** Number of incoming edges that have completed value routing. */
-    completedUpstreams?: number;
-    /** Total number of incoming edges for the node. */
-    upstreamCount?: number;
-    /** Whether the node is reachable from the workflow inputs in the plan. */
-    reachable?: boolean;
-    /** Whether the whole run has failed (unexecuted nodes then fade/disable). */
-    runFailed?: boolean;
-}
-/**
- * Derives the visual state for one node from its execution signals.
- *
- * Rules (DECAF-48 §4.4 / Req-5/Req-6):
- * - currently running → {@link GraphVisualState.RUNNING}
- * - failed → {@link GraphVisualState.FAILED}
- * - executed and succeeded (or from cache) → {@link GraphVisualState.SUCCEEDED}
- * - unexecuted and reachable with incomplete upstream deps → {@link GraphVisualState.BLOCKED}
- * - unexecuted with `runFailed` → {@link GraphVisualState.SKIPPED} (faded/disabled)
- * - otherwise → {@link GraphVisualState.IDLE}
- *
- * @param options - The node execution signals.
- * @returns The derived visual state.
- */
-export declare function deriveNodeVisualState(options: GraphVisualStateDerivation): GraphVisualState;
-/**
- * Translates a {@link GraphExecutionEvent} into a node visual state when the
- * event carries enough information. Used by contract conformance checks and
- * engine-agnostic consumers that derive state from the shared event stream.
- *
- * @param event - The graph execution event.
- * @returns The corresponding {@link GraphVisualState}, or `IDLE` when the
- * event does not indicate a specific visual transition.
- */
-export declare function visualStateOfEvent(event: GraphExecutionEvent): GraphVisualState;

package/lib/types/graph/shared/GraphExecutionStateMapper.d.mts

@@ -1,66 +0,0 @@
-/**
- * @module integrations/graph/shared/GraphExecutionStateMapper
- * @summary Maps engine state to the frontend-safe visual-state contract.
- * @description Pure, engine-agnostic helpers that derive
- * {@link GraphVisualState} values from engine execution signals. Frontend
- * bundles may import this from `@decaf-ts/integrations/graph/shared` (no
- * engine runtime dependency); a future Mastra/NestJS driver maps its own
- * runtime states onto {@link GraphVisualState} with the same rules.
- */
-import type { GraphExecutionEvent } from "./types.d.mts";
-import { GraphExecutionStatus, GraphVisualState } from "./constants.d.mts";
-/**
- * Maps an engine execution {@link GraphExecutionStatus} to the shared visual
- * state. `CACHED` collapses onto {@link GraphVisualState.SUCCEEDED} for
- * rendering; `CANCELLED`/`PENDING`/`PLANNING` yield `IDLE`.
- *
- * @param status - The engine execution status, if any.
- * @returns The visual state for the node/edge.
- */
-export declare function mapExecutionStatus(status?: GraphExecutionStatus): GraphVisualState;
-/**
- * Options describing a single node's position within a run (DECAF-48 §4.4).
- */
-export interface GraphVisualStateDerivation {
-    /** Whether the node has already executed (any terminal engine status). */
-    executed: boolean;
-    /** Whether the node is currently running. */
-    running: boolean;
-    /** Whether the node completed successfully (or from cache). */
-    succeeded?: boolean;
-    /** Whether the node failed. */
-    failed?: boolean;
-    /** Number of incoming edges that have completed value routing. */
-    completedUpstreams?: number;
-    /** Total number of incoming edges for the node. */
-    upstreamCount?: number;
-    /** Whether the node is reachable from the workflow inputs in the plan. */
-    reachable?: boolean;
-    /** Whether the whole run has failed (unexecuted nodes then fade/disable). */
-    runFailed?: boolean;
-}
-/**
- * Derives the visual state for one node from its execution signals.
- *
- * Rules (DECAF-48 §4.4 / Req-5/Req-6):
- * - currently running → {@link GraphVisualState.RUNNING}
- * - failed → {@link GraphVisualState.FAILED}
- * - executed and succeeded (or from cache) → {@link GraphVisualState.SUCCEEDED}
- * - unexecuted and reachable with incomplete upstream deps → {@link GraphVisualState.BLOCKED}
- * - unexecuted with `runFailed` → {@link GraphVisualState.SKIPPED} (faded/disabled)
- * - otherwise → {@link GraphVisualState.IDLE}
- *
- * @param options - The node execution signals.
- * @returns The derived visual state.
- */
-export declare function deriveNodeVisualState(options: GraphVisualStateDerivation): GraphVisualState;
-/**
- * Translates a {@link GraphExecutionEvent} into a node visual state when the
- * event carries enough information. Used by contract conformance checks and
- * engine-agnostic consumers that derive state from the shared event stream.
- *
- * @param event - The graph execution event.
- * @returns The corresponding {@link GraphVisualState}, or `IDLE` when the
- * event does not indicate a specific visual transition.
- */
-export declare function visualStateOfEvent(event: GraphExecutionEvent): GraphVisualState;

package/lib/types/graph/shared/constants.d.cts

@@ -1,120 +0,0 @@
-/**
- * @module integrations/graph/shared/constants
- * @summary Frontend-safe graph constants and enums.
- * @description Constants and enumerations that are safe to import from a
- * frontend bundle (no engine runtime dependency). Alongside the existing
- * execution-status and event-type enums (rendered as status badges and event
- * timelines), this module carries the DECAF-48 visual-state contract: the
- * frontend-safe {@link GraphVisualState} enum, the `graph.run.log` /
- * `graph.run.state` SSE topic constants, the run-log attribute keys
- * ({@link GraphLogAttribute}), and the `NODE_STATE_CHANGED` /
- * `EDGE_STATE_CHANGED` / `GRAPH_RUN_LOG` event types. The frontend must not
- * pull in the execution engine.
- */
-/**
- * Execution status for a workflow or individual node.
- */
-export declare enum GraphExecutionStatus {
-    PENDING = "pending",
-    PLANNING = "planning",
-    RUNNING = "running",
-    SUCCEEDED = "succeeded",
-    FAILED = "failed",
-    SKIPPED = "skipped",
-    CANCELLED = "cancelled",
-    CACHED = "cached"
-}
-/**
- * Visual execution state for a node or edge on the workflow canvas.
- *
- * Frontend-safe (DECAF-48 §4.4): a superset of {@link GraphExecutionStatus}
- * normalised for rendering. `BLOCKED` is derived from the plan and execution
- * events (waiting on upstream dependencies), not emitted as an engine status.
- * `SKIPPED` is the post-failure "unexecuted/disabled" visual state.
- */
-export declare enum GraphVisualState {
-    IDLE = "idle",
-    RUNNING = "running",
-    BLOCKED = "blocked",
-    SUCCEEDED = "succeeded",
-    FAILED = "failed",
-    SKIPPED = "skipped"
-}
-/**
- * Namespace root for graph run SSE topics (DECAF-48 §4.2). A subscription
- * filters on these granular topics before `observer.next(...)`.
- */
-export declare const GRAPH_RUN_TOPIC = "graph.run";
-/**
- * SSE sub-topic streaming per-node log lines during a run.
- */
-export declare const GRAPH_RUN_LOG_TOPIC = "graph.run.log";
-/**
- * SSE sub-topic streaming node/edge execution-state updates during a run.
- */
-export declare const GRAPH_RUN_STATE_TOPIC = "graph.run.state";
-/**
- * Logger custom-attribute keys attached to every run log line via
- * DECAF-9 `logger.for({...})` (DECAF-48 §4.3). Rendered as discrete columns
- * (not buried in the message string).
- */
-export declare enum GraphLogAttribute {
-    NODE_ID = "nodeId",
-    WORKFLOW_ID = "workflowId",
-    RUN_ID = "runId",
-    USER = "user"
-}
-/**
- * Namespace topic helper for a graph execution event.
- *
- * Log-carrier events resolve to `graph.run.log`; node/edge execution-state
- * events resolve to `graph.run.state`; everything else stays under the shared
- * `graph.run` topic and is only delivered to subscribers that match it.
- *
- * @param eventType - The graph execution event type to scope to a topic.
- * @returns The SSE topic constant for the given event type.
- */
-export declare function graphRunTopicOf(eventType: GraphExecutionEventType): string;
-/**
- * Event types emitted through the graph execution observer pipeline.
- *
- * DECAF-48 extends this set with the visual-state and run-log event types the
- * engine emits on the existing Observable: {@link GraphExecutionEventType.NODE_STATE_CHANGED},
- * {@link GraphExecutionEventType.EDGE_STATE_CHANGED} and
- * {@link GraphExecutionEventType.GRAPH_RUN_LOG}.
- */
-export declare enum GraphExecutionEventType {
-    WORKFLOW_STARTED = "workflow.started",
-    WORKFLOW_PLANNED = "workflow.planned",
-    WORKFLOW_COMPLETED = "workflow.completed",
-    WORKFLOW_FAILED = "workflow.failed",
-    WORKFLOW_CANCELLED = "workflow.cancelled",
-    NODE_QUEUED = "node.queued",
-    NODE_STARTED = "node.started",
-    NODE_OUTPUT = "node.output",
-    NODE_COMPLETED = "node.completed",
-    NODE_FAILED = "node.failed",
-    NODE_SKIPPED = "node.skipped",
-    NODE_CACHE_HIT = "node.cacheHit",
-    NODE_PINNED = "node.pinned",
-    NODE_UNPINNED = "node.unpinned",
-    /** Node execution-state transition carrying a `GraphNodeStateChangedPayload` (DECAF-48 §4.4). */
-    NODE_STATE_CHANGED = "node.stateChanged",
-    EDGE_VALUE_ROUTED = "edge.valueRouted",
-    /** Edge execution-state transition carrying a `GraphEdgeStateChangedPayload` (DECAF-48 §4.4). */
-    EDGE_STATE_CHANGED = "edge.stateChanged",
-    /** Structured run log line carrying a `GraphRunLogEntry` (DECAF-48 §4.3). */
-    GRAPH_RUN_LOG = "graph.run.log",
-    LOOP_STARTED = "loop.started",
-    LOOP_ITERATION_STARTED = "loop.iteration.started",
-    LOOP_ITERATION_COMPLETED = "loop.iteration.completed",
-    LOOP_CONDITION_EVALUATED = "loop.condition.evaluated",
-    LOOP_COMPLETED = "loop.completed",
-    LOOP_LIMIT_REACHED = "loop.limitReached",
-    VALIDATION_STARTED = "validation.started",
-    VALIDATION_FAILED = "validation.failed",
-    VALIDATION_COMPLETED = "validation.completed",
-    STORE_READ = "store.read",
-    STORE_WRITE = "store.write",
-    STORE_DELETE = "store.delete"
-}