@decaf-ts/integrations 0.8.0 → 0.9.0

package/lib/cjs/graph/shared/GraphExecutionStateMapper.cjs

@@ -1,97 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapExecutionStatus = mapExecutionStatus;
-exports.deriveNodeVisualState = deriveNodeVisualState;
-exports.visualStateOfEvent = visualStateOfEvent;
-const constants_js_1 = require("./constants.cjs");
-/**
- * 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.
- */
-function mapExecutionStatus(status) {
-    switch (status) {
-        case constants_js_1.GraphExecutionStatus.RUNNING:
-            return constants_js_1.GraphVisualState.RUNNING;
-        case constants_js_1.GraphExecutionStatus.SUCCEEDED:
-        case constants_js_1.GraphExecutionStatus.CACHED:
-            return constants_js_1.GraphVisualState.SUCCEEDED;
-        case constants_js_1.GraphExecutionStatus.FAILED:
-            return constants_js_1.GraphVisualState.FAILED;
-        case constants_js_1.GraphExecutionStatus.SKIPPED:
-            return constants_js_1.GraphVisualState.SKIPPED;
-        case constants_js_1.GraphExecutionStatus.PENDING:
-        case constants_js_1.GraphExecutionStatus.PLANNING:
-        case constants_js_1.GraphExecutionStatus.CANCELLED:
-        default:
-            return constants_js_1.GraphVisualState.IDLE;
-    }
-}
-/**
- * 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.
- */
-function deriveNodeVisualState(options) {
-    if (options.running)
-        return constants_js_1.GraphVisualState.RUNNING;
-    if (options.failed)
-        return constants_js_1.GraphVisualState.FAILED;
-    if (options.executed && options.succeeded !== false) {
-        return options.succeeded
-            ? constants_js_1.GraphVisualState.SUCCEEDED
-            : constants_js_1.GraphVisualState.FAILED;
-    }
-    const upstream = options.upstreamCount ?? 0;
-    const completed = options.completedUpstreams ?? 0;
-    if (upstream > 0 && completed < upstream)
-        return constants_js_1.GraphVisualState.BLOCKED;
-    if (options.runFailed)
-        return constants_js_1.GraphVisualState.SKIPPED;
-    return constants_js_1.GraphVisualState.IDLE;
-}
-/**
- * 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.
- */
-function visualStateOfEvent(event) {
-    if (event.status)
-        return mapExecutionStatus(event.status);
-    const payloadState = event.payload
-        ?.state;
-    if (payloadState)
-        return payloadState;
-    switch (event.type) {
-        case constants_js_1.GraphExecutionEventType.NODE_STARTED:
-        case constants_js_1.GraphExecutionEventType.EDGE_STATE_CHANGED:
-        case constants_js_1.GraphExecutionEventType.NODE_STATE_CHANGED:
-            return constants_js_1.GraphVisualState.RUNNING;
-        case constants_js_1.GraphExecutionEventType.NODE_COMPLETED:
-            return constants_js_1.GraphVisualState.SUCCEEDED;
-        case constants_js_1.GraphExecutionEventType.NODE_FAILED:
-            return constants_js_1.GraphVisualState.FAILED;
-        case constants_js_1.GraphExecutionEventType.NODE_SKIPPED:
-            return constants_js_1.GraphVisualState.SKIPPED;
-        default:
-            return constants_js_1.GraphVisualState.IDLE;
-    }
-}
-//# sourceMappingURL=GraphExecutionStateMapper.js.map
-//# sourceMappingURL=GraphExecutionStateMapper.cjs.map

package/lib/cjs/graph/shared/GraphExecutionStateMapper.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"graph/shared/GraphExecutionStateMapper.cjs","sourceRoot":"","sources":["graph/shared/GraphExecutionStateMapper.js"],"names":[],"mappings":";;AASA,gDAiBC;AAeD,sDAiBC;AAUD,gDAqBC;AAzFD,iDAAkG;AAClG;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAAC,MAAM;IACrC,QAAQ,MAAM,EAAE,CAAC;QACb,KAAK,mCAAoB,CAAC,OAAO;YAC7B,OAAO,+BAAgB,CAAC,OAAO,CAAC;QACpC,KAAK,mCAAoB,CAAC,SAAS,CAAC;QACpC,KAAK,mCAAoB,CAAC,MAAM;YAC5B,OAAO,+BAAgB,CAAC,SAAS,CAAC;QACtC,KAAK,mCAAoB,CAAC,MAAM;YAC5B,OAAO,+BAAgB,CAAC,MAAM,CAAC;QACnC,KAAK,mCAAoB,CAAC,OAAO;YAC7B,OAAO,+BAAgB,CAAC,OAAO,CAAC;QACpC,KAAK,mCAAoB,CAAC,OAAO,CAAC;QAClC,KAAK,mCAAoB,CAAC,QAAQ,CAAC;QACnC,KAAK,mCAAoB,CAAC,SAAS,CAAC;QACpC;YACI,OAAO,+BAAgB,CAAC,IAAI,CAAC;IACrC,CAAC;AACL,CAAC;AACD;;;;;;;;;;;;;GAaG;AACH,SAAgB,qBAAqB,CAAC,OAAO;IACzC,IAAI,OAAO,CAAC,OAAO;QACf,OAAO,+BAAgB,CAAC,OAAO,CAAC;IACpC,IAAI,OAAO,CAAC,MAAM;QACd,OAAO,+BAAgB,CAAC,MAAM,CAAC;IACnC,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;QAClD,OAAO,OAAO,CAAC,SAAS;YACpB,CAAC,CAAC,+BAAgB,CAAC,SAAS;YAC5B,CAAC,CAAC,+BAAgB,CAAC,MAAM,CAAC;IAClC,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,OAAO,CAAC,kBAAkB,IAAI,CAAC,CAAC;IAClD,IAAI,QAAQ,GAAG,CAAC,IAAI,SAAS,GAAG,QAAQ;QACpC,OAAO,+BAAgB,CAAC,OAAO,CAAC;IACpC,IAAI,OAAO,CAAC,SAAS;QACjB,OAAO,+BAAgB,CAAC,OAAO,CAAC;IACpC,OAAO,+BAAgB,CAAC,IAAI,CAAC;AACjC,CAAC;AACD;;;;;;;;GAQG;AACH,SAAgB,kBAAkB,CAAC,KAAK;IACpC,IAAI,KAAK,CAAC,MAAM;QACZ,OAAO,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO;QAC9B,EAAE,KAAK,CAAC;IACZ,IAAI,YAAY;QACZ,OAAO,YAAY,CAAC;IACxB,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,sCAAuB,CAAC,YAAY,CAAC;QAC1C,KAAK,sCAAuB,CAAC,kBAAkB,CAAC;QAChD,KAAK,sCAAuB,CAAC,kBAAkB;YAC3C,OAAO,+BAAgB,CAAC,OAAO,CAAC;QACpC,KAAK,sCAAuB,CAAC,cAAc;YACvC,OAAO,+BAAgB,CAAC,SAAS,CAAC;QACtC,KAAK,sCAAuB,CAAC,WAAW;YACpC,OAAO,+BAAgB,CAAC,MAAM,CAAC;QACnC,KAAK,sCAAuB,CAAC,YAAY;YACrC,OAAO,+BAAgB,CAAC,OAAO,CAAC;QACpC;YACI,OAAO,+BAAgB,CAAC,IAAI,CAAC;IACrC,CAAC;AACL,CAAC;AACD,qDAAqD"}

package/lib/cjs/graph/shared/constants.cjs

@@ -1,99 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GraphExecutionEventType = exports.GraphLogAttribute = exports.GRAPH_RUN_STATE_TOPIC = exports.GRAPH_RUN_LOG_TOPIC = exports.GRAPH_RUN_TOPIC = exports.GraphVisualState = exports.GraphExecutionStatus = void 0;
-exports.graphRunTopicOf = graphRunTopicOf;
-(function (GraphExecutionStatus) {
-    GraphExecutionStatus["PENDING"] = "pending";
-    GraphExecutionStatus["PLANNING"] = "planning";
-    GraphExecutionStatus["RUNNING"] = "running";
-    GraphExecutionStatus["SUCCEEDED"] = "succeeded";
-    GraphExecutionStatus["FAILED"] = "failed";
-    GraphExecutionStatus["SKIPPED"] = "skipped";
-    GraphExecutionStatus["CANCELLED"] = "cancelled";
-    GraphExecutionStatus["CACHED"] = "cached";
-})(exports.GraphExecutionStatus || (exports.GraphExecutionStatus = {}));
-(function (GraphVisualState) {
-    GraphVisualState["IDLE"] = "idle";
-    GraphVisualState["RUNNING"] = "running";
-    GraphVisualState["BLOCKED"] = "blocked";
-    GraphVisualState["SUCCEEDED"] = "succeeded";
-    GraphVisualState["FAILED"] = "failed";
-    GraphVisualState["SKIPPED"] = "skipped";
-})(exports.GraphVisualState || (exports.GraphVisualState = {}));
-/**
- * Namespace root for graph run SSE topics (DECAF-48 §4.2). A subscription
- * filters on these granular topics before `observer.next(...)`.
- */
-exports.GRAPH_RUN_TOPIC = "graph.run";
-/**
- * SSE sub-topic streaming per-node log lines during a run.
- */
-exports.GRAPH_RUN_LOG_TOPIC = `${exports.GRAPH_RUN_TOPIC}.log`;
-/**
- * SSE sub-topic streaming node/edge execution-state updates during a run.
- */
-exports.GRAPH_RUN_STATE_TOPIC = `${exports.GRAPH_RUN_TOPIC}.state`;
-(function (GraphLogAttribute) {
-    GraphLogAttribute["NODE_ID"] = "nodeId";
-    GraphLogAttribute["WORKFLOW_ID"] = "workflowId";
-    GraphLogAttribute["RUN_ID"] = "runId";
-    GraphLogAttribute["USER"] = "user";
-})(exports.GraphLogAttribute || (exports.GraphLogAttribute = {}));
-/**
- * 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.
- */
-function graphRunTopicOf(eventType) {
-    switch (eventType) {
-        case exports.GraphExecutionEventType.GRAPH_RUN_LOG:
-            return exports.GRAPH_RUN_LOG_TOPIC;
-        case exports.GraphExecutionEventType.NODE_STATE_CHANGED:
-        case exports.GraphExecutionEventType.EDGE_STATE_CHANGED:
-            return exports.GRAPH_RUN_STATE_TOPIC;
-        default:
-            return exports.GRAPH_RUN_TOPIC;
-    }
-}
-(function (GraphExecutionEventType) {
-    GraphExecutionEventType["WORKFLOW_STARTED"] = "workflow.started";
-    GraphExecutionEventType["WORKFLOW_PLANNED"] = "workflow.planned";
-    GraphExecutionEventType["WORKFLOW_COMPLETED"] = "workflow.completed";
-    GraphExecutionEventType["WORKFLOW_FAILED"] = "workflow.failed";
-    GraphExecutionEventType["WORKFLOW_CANCELLED"] = "workflow.cancelled";
-    GraphExecutionEventType["NODE_QUEUED"] = "node.queued";
-    GraphExecutionEventType["NODE_STARTED"] = "node.started";
-    GraphExecutionEventType["NODE_OUTPUT"] = "node.output";
-    GraphExecutionEventType["NODE_COMPLETED"] = "node.completed";
-    GraphExecutionEventType["NODE_FAILED"] = "node.failed";
-    GraphExecutionEventType["NODE_SKIPPED"] = "node.skipped";
-    GraphExecutionEventType["NODE_CACHE_HIT"] = "node.cacheHit";
-    GraphExecutionEventType["NODE_PINNED"] = "node.pinned";
-    GraphExecutionEventType["NODE_UNPINNED"] = "node.unpinned";
-    /** Node execution-state transition carrying a `GraphNodeStateChangedPayload` (DECAF-48 §4.4). */
-    GraphExecutionEventType["NODE_STATE_CHANGED"] = "node.stateChanged";
-    GraphExecutionEventType["EDGE_VALUE_ROUTED"] = "edge.valueRouted";
-    /** Edge execution-state transition carrying a `GraphEdgeStateChangedPayload` (DECAF-48 §4.4). */
-    GraphExecutionEventType["EDGE_STATE_CHANGED"] = "edge.stateChanged";
-    /** Structured run log line carrying a `GraphRunLogEntry` (DECAF-48 §4.3). */
-    GraphExecutionEventType["GRAPH_RUN_LOG"] = "graph.run.log";
-    GraphExecutionEventType["LOOP_STARTED"] = "loop.started";
-    GraphExecutionEventType["LOOP_ITERATION_STARTED"] = "loop.iteration.started";
-    GraphExecutionEventType["LOOP_ITERATION_COMPLETED"] = "loop.iteration.completed";
-    GraphExecutionEventType["LOOP_CONDITION_EVALUATED"] = "loop.condition.evaluated";
-    GraphExecutionEventType["LOOP_COMPLETED"] = "loop.completed";
-    GraphExecutionEventType["LOOP_LIMIT_REACHED"] = "loop.limitReached";
-    GraphExecutionEventType["VALIDATION_STARTED"] = "validation.started";
-    GraphExecutionEventType["VALIDATION_FAILED"] = "validation.failed";
-    GraphExecutionEventType["VALIDATION_COMPLETED"] = "validation.completed";
-    GraphExecutionEventType["STORE_READ"] = "store.read";
-    GraphExecutionEventType["STORE_WRITE"] = "store.write";
-    GraphExecutionEventType["STORE_DELETE"] = "store.delete";
-})(exports.GraphExecutionEventType || (exports.GraphExecutionEventType = {}));
-//# sourceMappingURL=constants.js.map
-//# sourceMappingURL=constants.cjs.map

package/lib/cjs/graph/shared/constants.cjs.map

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

package/lib/cjs/graph/shared/index.cjs

@@ -1,46 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.graphVisualStyleOf = exports.GRAPH_VISUAL_STATE_STYLES = exports.Metadata = void 0;
-/**
- * @module integrations/graph/shared
- * @summary Frontend-safe graph declarations.
- * @description Subpath export for frontend bundles. Re-exports the node kind
- * declarations, shared types, and shared constants — no engine runtime
- * dependency. Also re-exports `Metadata` from `@decaf-ts/ui-decorators` so
- * consumers get the `Metadata.nodes()` / `Metadata.workflows()` accessors
- * (attached via the graph overrides side-effect import).
- *
- * Importing anything from this module triggers the `ui-decorators/graph`
- * overrides side-effect, which attaches `nodes()` / `workflows()` to the
- * `Metadata` class.
- */
-require("@decaf-ts/ui-decorators/graph");
-var decoration_1 = require("@decaf-ts/decoration");
-Object.defineProperty(exports, "Metadata", { enumerable: true, get: function () { return decoration_1.Metadata; } });
-__exportStar(require("./constants.cjs"), exports);
-__exportStar(require("./types.cjs"), exports);
-__exportStar(require("./GraphExecutionStateMapper.cjs"), exports);
-__exportStar(require("./nodes/index.cjs"), exports);
-// Re-export the ui-decorators graph metadata the frontend needs so `for-angular`
-// imports only `@decaf-ts/integrations/graph/shared` (DECAF-35 §4.6 ESLint
-// boundary / DECAF-48 §4.1): visual-state overlay styles and node I/O
-// inspection metadata.
-var graph_1 = require("@decaf-ts/ui-decorators/graph");
-Object.defineProperty(exports, "GRAPH_VISUAL_STATE_STYLES", { enumerable: true, get: function () { return graph_1.GRAPH_VISUAL_STATE_STYLES; } });
-Object.defineProperty(exports, "graphVisualStyleOf", { enumerable: true, get: function () { return graph_1.graphVisualStyleOf; } });
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.cjs.map

package/lib/cjs/graph/shared/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"graph/shared/index.cjs","sourceRoot":"","sources":["graph/shared/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;GAYG;AACH,yCAAuC;AACvC,mDAAgD;AAAvC,sGAAA,QAAQ,OAAA;AACjB,iDAA+B;AAC/B,6CAA2B;AAC3B,iEAA+C;AAC/C,mDAAiC;AACjC,iFAAiF;AACjF,2EAA2E;AAC3E,sEAAsE;AACtE,uBAAuB;AACvB,uDAA+F;AAAtF,kHAAA,yBAAyB,OAAA;AAAE,2GAAA,kBAAkB,OAAA;AACtD,iCAAiC"}

package/lib/cjs/graph/shared/nodes/agent.cjs

@@ -1,110 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GRAPH_AGENT_NODES = exports.AgentNode = void 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/agent
- * @summary Production Agent node declaration.
- * @description The Agent node is the primary AI agent entrypoint. It is a
- * rectangular node with `@connection()` ports for its structural dependencies:
- * `model` (the LLM), `memory` (the memory store), and `workspace` (the
- * workspace/context). Connections are rendered on the bottom side of the node
- * (DECAF-32 §21.3). Each connection category has a distinct color defined in
- * the category style registry.
- *
- * The single `prompt` input accepts placeholder expressions (§22.4) such as
- * `{{ $input.brief }}` or `{{ $node["Research"].output.summary }}` that are
- * resolved at execution time by the placeholder compiler.
- */
-const decorator_validation_1 = require("@decaf-ts/decorator-validation");
-const ui_decorators_1 = require("@decaf-ts/ui-decorators");
-const graph_1 = require("@decaf-ts/ui-decorators/graph");
-// Ensure category styles are registered (idempotent).
-require("./category-styles.cjs");
-/**
- * Agent node — an AI agent that orchestrates a model, memory, and workspace.
- *
- * The agent has:
- * - `@input` port on the **left**: `prompt` (the task prompt; supports
- *   placeholder expressions like `{{ $input.something }}` per §22.4).
- * - `@output` ports on the **right**: `response` (the agent's output), `actions`
- *   (any actions the agent decided to take).
- * - `@connection` ports on the **bottom**: `model` (LLM), `memory` (memory
- *   store), `workspace` (workspace/context). Each connection has a distinct
- *   category color.
- *
- * The node is rectangular (not rounded) to visually distinguish it from
- * regular processing nodes. The `color` and `icon` are omitted from `@node()`
- * so they are resolved from the `"Agent"` category style.
- */
-let AgentNode = class AgentNode extends decorator_validation_1.Model {
-};
-exports.AgentNode = AgentNode;
-__decorate([
-    (0, decorator_validation_1.required)(),
-    (0, ui_decorators_1.uielement)("textarea", {
-        label: "Prompt",
-        placeholder: "Enter task prompt. Supports placeholders like {{ $input.brief }} or {{ $node[\"Research\"].output.summary }}",
-    }),
-    (0, graph_1.input)({ handle: "prompt" }),
-    __metadata("design:type", String)
-], AgentNode.prototype, "prompt", void 0);
-__decorate([
-    (0, decorator_validation_1.required)(),
-    (0, ui_decorators_1.uielement)("textarea", { label: "Response", placeholder: "Agent response" }),
-    (0, graph_1.output)({ handle: "response" }),
-    __metadata("design:type", String)
-], AgentNode.prototype, "response", void 0);
-__decorate([
-    (0, decorator_validation_1.required)(),
-    (0, ui_decorators_1.uielement)("textarea", { label: "Actions", placeholder: "Actions taken by the agent" }),
-    (0, graph_1.output)({ handle: "actions" }),
-    __metadata("design:type", Array)
-], AgentNode.prototype, "actions", void 0);
-__decorate([
-    (0, graph_1.connection)({ category: "model", handle: "model" }),
-    __metadata("design:type", Object)
-], AgentNode.prototype, "model", void 0);
-__decorate([
-    (0, graph_1.connection)({ category: "memory", handle: "memory" }),
-    __metadata("design:type", Object)
-], AgentNode.prototype, "memory", void 0);
-__decorate([
-    (0, graph_1.connection)({ category: "workspace", handle: "workspace" }),
-    __metadata("design:type", Object)
-], AgentNode.prototype, "workspace", void 0);
-exports.AgentNode = AgentNode = __decorate([
-    (0, graph_1.node)("core.agent", {
-        kind: "core.agent",
-        category: "Agent",
-        // color and icon omitted — resolved from the "Agent" category style
-        width: 120,
-        height: 140,
-        labels: ["agent", "ai", "orchestrator"],
-        metadata: {
-            title: "Agent",
-            description: "AI agent that orchestrates a model, memory, and workspace to complete a task.",
-            shape: "rectangle",
-        },
-    }),
-    (0, decorator_validation_1.model)()
-], AgentNode);
-/**
- * All built-in agent node constructors.
- */
-exports.GRAPH_AGENT_NODES = [AgentNode];
-//# sourceMappingURL=agent.js.map
-//# sourceMappingURL=agent.cjs.map

package/lib/cjs/graph/shared/nodes/agent.cjs.map

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

package/lib/cjs/graph/shared/nodes/base.cjs

@@ -1,36 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GraphNode = void 0;
-/**
- * @module integrations/graph/nodes/base
- * @summary Base class for graph node declarations.
- * @description `GraphNode` extends {@link Model} with an overridable
- * `applyMetadata` static method. Concrete node kinds that support dynamic
- * metadata changes (e.g. `SwitchFlowNode` adding case output ports) override
- * this method to compute their own ports, size, and data patches — the node
- * is exclusively responsible for itself in every way.
- */
-const decorator_validation_1 = require("@decaf-ts/decorator-validation");
-class GraphNode extends decorator_validation_1.Model {
-    /**
-     * Applies a metadata patch to this node class, returning the resulting
-     * ports, size, and data patches.
-     *
-     * The default implementation returns `null` (no changes). Concrete node
-     * kinds that support dynamic metadata override this to compute their own
-     * ports and size from the metadata — the caller (renderer) simply relays
-     * the result to the diagram model.
-     *
-     * @param _meta - The metadata patch (node-kind-specific, e.g.
-     *   `SwitchNodeMetadata`).
-     * @returns The computed change, or `null` when the node kind does not
-     *   support dynamic metadata.
-     */
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    static applyMetadata(_meta) {
-        return null;
-    }
-}
-exports.GraphNode = GraphNode;
-//# sourceMappingURL=base.js.map
-//# sourceMappingURL=base.cjs.map

package/lib/cjs/graph/shared/nodes/base.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"graph/shared/nodes/base.cjs","sourceRoot":"","sources":["graph/shared/nodes/base.js"],"names":[],"mappings":";;;AAAA;;;;;;;;GAQG;AACH,yEAAuD;AACvD,MAAa,SAAU,SAAQ,4BAAK;IAChC;;;;;;;;;;;;;OAaG;IACH,6DAA6D;IAC7D,MAAM,CAAC,aAAa,CAAC,KAAK;QACtB,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAnBD,8BAmBC;AACD,gCAAgC"}

package/lib/cjs/graph/shared/nodes/category-styles.cjs

@@ -1,38 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerBuiltinCategoryStyles = registerBuiltinCategoryStyles;
-/**
- * @module integrations/graph/nodes/category-styles
- * @summary Built-in node/connection category style registrations.
- * @description Registers default colors and icons for the built-in node and
- * connection categories (DECAF-32 §21.2). The `color` / `icon` on a node's
- * `@node()` metadata are optional overrides — when omitted, the effective
- * style is resolved from the category registry.
- */
-const graph_1 = require("@decaf-ts/ui-decorators/graph");
-/**
- * Registers all built-in category styles. Called once at module init.
- *
- * Categories define the default visual style for nodes and connection ports.
- * A node's explicit `color` / `icon` (on `@node()`) overrides the category
- * style; when omitted, the category style is used.
- */
-function registerBuiltinCategoryStyles() {
-    // Node categories
-    (0, graph_1.registerGraphCategoryStyle)("Trigger", { color: "#3b82f6", icon: "ti-bolt" });
-    (0, graph_1.registerGraphCategoryStyle)("Flow Control", { color: "#f59e0b", icon: "ti-arrows-split-2" });
-    (0, graph_1.registerGraphCategoryStyle)("Utility", { color: "#0d9488", icon: "ti-tool" });
-    (0, graph_1.registerGraphCategoryStyle)("Loop", { color: "#eab308", icon: "ti-repeat" });
-    (0, graph_1.registerGraphCategoryStyle)("Workflow", { color: "#f97316", icon: "ti-sitemap" });
-    (0, graph_1.registerGraphCategoryStyle)("Pipeline", { color: "#0ea5e9", icon: "ti-git-merge" });
-    (0, graph_1.registerGraphCategoryStyle)("Node", { color: "#8b5cf6", icon: "ti-point-filled" });
-    (0, graph_1.registerGraphCategoryStyle)("Agent", { color: "#7c3aed", icon: "ti-robot" });
-    // Connection categories (for @connection() ports)
-    (0, graph_1.registerGraphCategoryStyle)("model", { color: "#3b82f6", icon: "ti-cpu" });
-    (0, graph_1.registerGraphCategoryStyle)("memory", { color: "#10b981", icon: "ti-database" });
-    (0, graph_1.registerGraphCategoryStyle)("workspace", { color: "#f59e0b", icon: "ti-folder" });
-}
-// Register at module load so the styles are available immediately.
-registerBuiltinCategoryStyles();
-//# sourceMappingURL=category-styles.js.map
-//# sourceMappingURL=category-styles.cjs.map

package/lib/cjs/graph/shared/nodes/category-styles.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"graph/shared/nodes/category-styles.cjs","sourceRoot":"","sources":["graph/shared/nodes/category-styles.js"],"names":[],"mappings":";;AAgBA,sEAcC;AA9BD;;;;;;;GAOG;AACH,yDAA4E;AAC5E;;;;;;GAMG;AACH,SAAgB,6BAA6B;IACzC,kBAAkB;IAClB,IAAA,kCAA0B,EAAC,SAAS,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7E,IAAA,kCAA0B,EAAC,cAAc,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAC5F,IAAA,kCAA0B,EAAC,SAAS,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7E,IAAA,kCAA0B,EAAC,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IAC5E,IAAA,kCAA0B,EAAC,UAAU,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;IACjF,IAAA,kCAA0B,EAAC,UAAU,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;IACnF,IAAA,kCAA0B,EAAC,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAClF,IAAA,kCAA0B,EAAC,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IAC5E,kDAAkD;IAClD,IAAA,kCAA0B,EAAC,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC1E,IAAA,kCAA0B,EAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;IAChF,IAAA,kCAA0B,EAAC,WAAW,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;AACrF,CAAC;AACD,mEAAmE;AACnE,6BAA6B,EAAE,CAAC;AAChC,2CAA2C"}