@decaf-ts/integrations 0.3.8 → 0.3.9

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

@@ -0,0 +1,101 @@
+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.
+ */
+import { Model, model, required } from "@decaf-ts/decorator-validation";
+import { uielement } from "@decaf-ts/ui-decorators";
+import { connection, input, node, output } from "@decaf-ts/ui-decorators/graph";
+// Ensure category styles are registered (idempotent).
+import "./category-styles.js";
+/**
+ * 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 Model {
+};
+__decorate([
+    required(),
+    uielement("textarea", {
+        label: "Prompt",
+        placeholder: "Enter task prompt. Supports placeholders like {{ $input.brief }} or {{ $node[\"Research\"].output.summary }}",
+    }),
+    input({ handle: "prompt" }),
+    __metadata("design:type", String)
+], AgentNode.prototype, "prompt", void 0);
+__decorate([
+    required(),
+    uielement("textarea", { label: "Response", placeholder: "Agent response" }),
+    output({ handle: "response" }),
+    __metadata("design:type", String)
+], AgentNode.prototype, "response", void 0);
+__decorate([
+    required(),
+    uielement("textarea", { label: "Actions", placeholder: "Actions taken by the agent" }),
+    output({ handle: "actions" }),
+    __metadata("design:type", Array)
+], AgentNode.prototype, "actions", void 0);
+__decorate([
+    connection({ category: "model", handle: "model" }),
+    __metadata("design:type", Object)
+], AgentNode.prototype, "model", void 0);
+__decorate([
+    connection({ category: "memory", handle: "memory" }),
+    __metadata("design:type", Object)
+], AgentNode.prototype, "memory", void 0);
+__decorate([
+    connection({ category: "workspace", handle: "workspace" }),
+    __metadata("design:type", Object)
+], AgentNode.prototype, "workspace", void 0);
+AgentNode = __decorate([
+    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",
+        },
+    }),
+    model()
+], AgentNode);
+export { AgentNode };
+/**
+ * All built-in agent node constructors.
+ */
+export const GRAPH_AGENT_NODES = [AgentNode];
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWdlbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9zcmMvZ3JhcGgvc2hhcmVkL25vZGVzL2FnZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7OztBQUFBOzs7Ozs7Ozs7Ozs7O0dBYUc7QUFDSCxPQUFPLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxRQUFRLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUN4RSxPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFDcEQsT0FBTyxFQUFFLFVBQVUsRUFBRSxLQUFLLEVBQUUsSUFBSSxFQUFFLE1BQU0sRUFBRSxNQUFNLCtCQUErQixDQUFDO0FBRWhGLHNEQUFzRDtBQUN0RCw4QkFBMkI7QUFFM0I7Ozs7Ozs7Ozs7Ozs7OztHQWVHO0FBZ0JJLElBQU0sU0FBUyxHQUFmLE1BQU0sU0FBVSxTQUFRLEtBQUs7Q0FpQ25DLENBQUE7QUF4QkM7SUFOQyxRQUFRLEVBQUU7SUFDVixTQUFTLENBQUMsVUFBVSxFQUFFO1FBQ3JCLEtBQUssRUFBRSxRQUFRO1FBQ2YsV0FBVyxFQUFFLDhHQUE4RztLQUM1SCxDQUFDO0lBQ0QsS0FBSyxDQUFDLEVBQUUsTUFBTSxFQUFFLFFBQVEsRUFBRSxDQUFDOzt5Q0FDWjtBQU9oQjtJQUhDLFFBQVEsRUFBRTtJQUNWLFNBQVMsQ0FBQyxVQUFVLEVBQUUsRUFBRSxLQUFLLEVBQUUsVUFBVSxFQUFFLFdBQVcsRUFBRSxnQkFBZ0IsRUFBRSxDQUFDO0lBQzNFLE1BQU0sQ0FBQyxFQUFFLE1BQU0sRUFBRSxVQUFVLEVBQUUsQ0FBQzs7MkNBQ2I7QUFLbEI7SUFIQyxRQUFRLEVBQUU7SUFDVixTQUFTLENBQUMsVUFBVSxFQUFFLEVBQUUsS0FBSyxFQUFFLFNBQVMsRUFBRSxXQUFXLEVBQUUsNEJBQTRCLEVBQUUsQ0FBQztJQUN0RixNQUFNLENBQUMsRUFBRSxNQUFNLEVBQUUsU0FBUyxFQUFFLENBQUM7OzBDQUNWO0FBS3BCO0lBREMsVUFBVSxDQUFDLEVBQUUsUUFBUSxFQUFFLE9BQU8sRUFBRSxNQUFNLEVBQUUsT0FBTyxFQUFFLENBQUM7O3dDQUNuQztBQUdoQjtJQURDLFVBQVUsQ0FBQyxFQUFFLFFBQVEsRUFBRSxRQUFRLEVBQUUsTUFBTSxFQUFFLFFBQVEsRUFBRSxDQUFDOzt5Q0FDcEM7QUFHakI7SUFEQyxVQUFVLENBQUMsRUFBRSxRQUFRLEVBQUUsV0FBVyxFQUFFLE1BQU0sRUFBRSxXQUFXLEVBQUUsQ0FBQzs7NENBQ3ZDO0FBaENULFNBQVM7SUFmckIsSUFBSSxDQUFDLFlBQVksRUFBRTtRQUNsQixJQUFJLEVBQUUsWUFBWTtRQUNsQixRQUFRLEVBQUUsT0FBTztRQUNqQixvRUFBb0U7UUFDcEUsS0FBSyxFQUFFLEdBQUc7UUFDVixNQUFNLEVBQUUsR0FBRztRQUNYLE1BQU0sRUFBRSxDQUFDLE9BQU8sRUFBRSxJQUFJLEVBQUUsY0FBYyxDQUFDO1FBQ3ZDLFFBQVEsRUFBRTtZQUNSLEtBQUssRUFBRSxPQUFPO1lBQ2QsV0FBVyxFQUNULCtFQUErRTtZQUNqRixLQUFLLEVBQUUsV0FBVztTQUNuQjtLQUNGLENBQUM7SUFDRCxLQUFLLEVBQUU7R0FDSyxTQUFTLENBaUNyQjs7QUFFRDs7R0FFRztBQUNILE1BQU0sQ0FBQyxNQUFNLGlCQUFpQixHQUFHLENBQUMsU0FBUyxDQUFVLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEBtb2R1bGUgaW50ZWdyYXRpb25zL2dyYXBoL25vZGVzL2FnZW50XG4gKiBAc3VtbWFyeSBQcm9kdWN0aW9uIEFnZW50IG5vZGUgZGVjbGFyYXRpb24uXG4gKiBAZGVzY3JpcHRpb24gVGhlIEFnZW50IG5vZGUgaXMgdGhlIHByaW1hcnkgQUkgYWdlbnQgZW50cnlwb2ludC4gSXQgaXMgYVxuICogcmVjdGFuZ3VsYXIgbm9kZSB3aXRoIGBAY29ubmVjdGlvbigpYCBwb3J0cyBmb3IgaXRzIHN0cnVjdHVyYWwgZGVwZW5kZW5jaWVzOlxuICogYG1vZGVsYCAodGhlIExMTSksIGBtZW1vcnlgICh0aGUgbWVtb3J5IHN0b3JlKSwgYW5kIGB3b3Jrc3BhY2VgICh0aGVcbiAqIHdvcmtzcGFjZS9jb250ZXh0KS4gQ29ubmVjdGlvbnMgYXJlIHJlbmRlcmVkIG9uIHRoZSBib3R0b20gc2lkZSBvZiB0aGUgbm9kZVxuICogKERFQ0FGLTMyIMKnMjEuMykuIEVhY2ggY29ubmVjdGlvbiBjYXRlZ29yeSBoYXMgYSBkaXN0aW5jdCBjb2xvciBkZWZpbmVkIGluXG4gKiB0aGUgY2F0ZWdvcnkgc3R5bGUgcmVnaXN0cnkuXG4gKlxuICogVGhlIHNpbmdsZSBgcHJvbXB0YCBpbnB1dCBhY2NlcHRzIHBsYWNlaG9sZGVyIGV4cHJlc3Npb25zICjCpzIyLjQpIHN1Y2ggYXNcbiAqIGB7eyAkaW5wdXQuYnJpZWYgfX1gIG9yIGB7eyAkbm9kZVtcIlJlc2VhcmNoXCJdLm91dHB1dC5zdW1tYXJ5IH19YCB0aGF0IGFyZVxuICogcmVzb2x2ZWQgYXQgZXhlY3V0aW9uIHRpbWUgYnkgdGhlIHBsYWNlaG9sZGVyIGNvbXBpbGVyLlxuICovXG5pbXBvcnQgeyBNb2RlbCwgbW9kZWwsIHJlcXVpcmVkIH0gZnJvbSBcIkBkZWNhZi10cy9kZWNvcmF0b3ItdmFsaWRhdGlvblwiO1xuaW1wb3J0IHsgdWllbGVtZW50IH0gZnJvbSBcIkBkZWNhZi10cy91aS1kZWNvcmF0b3JzXCI7XG5pbXBvcnQgeyBjb25uZWN0aW9uLCBpbnB1dCwgbm9kZSwgb3V0cHV0IH0gZnJvbSBcIkBkZWNhZi10cy91aS1kZWNvcmF0b3JzL2dyYXBoXCI7XG5cbi8vIEVuc3VyZSBjYXRlZ29yeSBzdHlsZXMgYXJlIHJlZ2lzdGVyZWQgKGlkZW1wb3RlbnQpLlxuaW1wb3J0IFwiLi9jYXRlZ29yeS1zdHlsZXNcIjtcblxuLyoqXG4gKiBBZ2VudCBub2RlIOKAlCBhbiBBSSBhZ2VudCB0aGF0IG9yY2hlc3RyYXRlcyBhIG1vZGVsLCBtZW1vcnksIGFuZCB3b3Jrc3BhY2UuXG4gKlxuICogVGhlIGFnZW50IGhhczpcbiAqIC0gYEBpbnB1dGAgcG9ydCBvbiB0aGUgKipsZWZ0Kio6IGBwcm9tcHRgICh0aGUgdGFzayBwcm9tcHQ7IHN1cHBvcnRzXG4gKiAgIHBsYWNlaG9sZGVyIGV4cHJlc3Npb25zIGxpa2UgYHt7ICRpbnB1dC5zb21ldGhpbmcgfX1gIHBlciDCpzIyLjQpLlxuICogLSBgQG91dHB1dGAgcG9ydHMgb24gdGhlICoqcmlnaHQqKjogYHJlc3BvbnNlYCAodGhlIGFnZW50J3Mgb3V0cHV0KSwgYGFjdGlvbnNgXG4gKiAgIChhbnkgYWN0aW9ucyB0aGUgYWdlbnQgZGVjaWRlZCB0byB0YWtlKS5cbiAqIC0gYEBjb25uZWN0aW9uYCBwb3J0cyBvbiB0aGUgKipib3R0b20qKjogYG1vZGVsYCAoTExNKSwgYG1lbW9yeWAgKG1lbW9yeVxuICogICBzdG9yZSksIGB3b3Jrc3BhY2VgICh3b3Jrc3BhY2UvY29udGV4dCkuIEVhY2ggY29ubmVjdGlvbiBoYXMgYSBkaXN0aW5jdFxuICogICBjYXRlZ29yeSBjb2xvci5cbiAqXG4gKiBUaGUgbm9kZSBpcyByZWN0YW5ndWxhciAobm90IHJvdW5kZWQpIHRvIHZpc3VhbGx5IGRpc3Rpbmd1aXNoIGl0IGZyb21cbiAqIHJlZ3VsYXIgcHJvY2Vzc2luZyBub2Rlcy4gVGhlIGBjb2xvcmAgYW5kIGBpY29uYCBhcmUgb21pdHRlZCBmcm9tIGBAbm9kZSgpYFxuICogc28gdGhleSBhcmUgcmVzb2x2ZWQgZnJvbSB0aGUgYFwiQWdlbnRcImAgY2F0ZWdvcnkgc3R5bGUuXG4gKi9cbkBub2RlKFwiY29yZS5hZ2VudFwiLCB7XG4gIGtpbmQ6IFwiY29yZS5hZ2VudFwiLFxuICBjYXRlZ29yeTogXCJBZ2VudFwiLFxuICAvLyBjb2xvciBhbmQgaWNvbiBvbWl0dGVkIOKAlCByZXNvbHZlZCBmcm9tIHRoZSBcIkFnZW50XCIgY2F0ZWdvcnkgc3R5bGVcbiAgd2lkdGg6IDEyMCxcbiAgaGVpZ2h0OiAxNDAsXG4gIGxhYmVsczogW1wiYWdlbnRcIiwgXCJhaVwiLCBcIm9yY2hlc3RyYXRvclwiXSxcbiAgbWV0YWRhdGE6IHtcbiAgICB0aXRsZTogXCJBZ2VudFwiLFxuICAgIGRlc2NyaXB0aW9uOlxuICAgICAgXCJBSSBhZ2VudCB0aGF0IG9yY2hlc3RyYXRlcyBhIG1vZGVsLCBtZW1vcnksIGFuZCB3b3Jrc3BhY2UgdG8gY29tcGxldGUgYSB0YXNrLlwiLFxuICAgIHNoYXBlOiBcInJlY3RhbmdsZVwiLFxuICB9LFxufSlcbkBtb2RlbCgpXG5leHBvcnQgY2xhc3MgQWdlbnROb2RlIGV4dGVuZHMgTW9kZWwge1xuICAvLyAtLS0gSW5wdXRzIChsZWZ0IHNpZGUpIC0tLVxuXG4gIEByZXF1aXJlZCgpXG4gIEB1aWVsZW1lbnQoXCJ0ZXh0YXJlYVwiLCB7XG4gICAgbGFiZWw6IFwiUHJvbXB0XCIsXG4gICAgcGxhY2Vob2xkZXI6IFwiRW50ZXIgdGFzayBwcm9tcHQuIFN1cHBvcnRzIHBsYWNlaG9sZGVycyBsaWtlIHt7ICRpbnB1dC5icmllZiB9fSBvciB7eyAkbm9kZVtcXFwiUmVzZWFyY2hcXFwiXS5vdXRwdXQuc3VtbWFyeSB9fVwiLFxuICB9KVxuICBAaW5wdXQoeyBoYW5kbGU6IFwicHJvbXB0XCIgfSlcbiAgcHJvbXB0ITogc3RyaW5nO1xuXG4gIC8vIC0tLSBPdXRwdXRzIChyaWdodCBzaWRlKSAtLS1cblxuICBAcmVxdWlyZWQoKVxuICBAdWllbGVtZW50KFwidGV4dGFyZWFcIiwgeyBsYWJlbDogXCJSZXNwb25zZVwiLCBwbGFjZWhvbGRlcjogXCJBZ2VudCByZXNwb25zZVwiIH0pXG4gIEBvdXRwdXQoeyBoYW5kbGU6IFwicmVzcG9uc2VcIiB9KVxuICByZXNwb25zZSE6IHN0cmluZztcblxuICBAcmVxdWlyZWQoKVxuICBAdWllbGVtZW50KFwidGV4dGFyZWFcIiwgeyBsYWJlbDogXCJBY3Rpb25zXCIsIHBsYWNlaG9sZGVyOiBcIkFjdGlvbnMgdGFrZW4gYnkgdGhlIGFnZW50XCIgfSlcbiAgQG91dHB1dCh7IGhhbmRsZTogXCJhY3Rpb25zXCIgfSlcbiAgYWN0aW9ucyE6IHVua25vd25bXTtcblxuICAvLyAtLS0gQ29ubmVjdGlvbnMgKGJvdHRvbSBzaWRlKSAtLS1cblxuICBAY29ubmVjdGlvbih7IGNhdGVnb3J5OiBcIm1vZGVsXCIsIGhhbmRsZTogXCJtb2RlbFwiIH0pXG4gIG1vZGVsITogdW5rbm93bjtcblxuICBAY29ubmVjdGlvbih7IGNhdGVnb3J5OiBcIm1lbW9yeVwiLCBoYW5kbGU6IFwibWVtb3J5XCIgfSlcbiAgbWVtb3J5ITogdW5rbm93bjtcblxuICBAY29ubmVjdGlvbih7IGNhdGVnb3J5OiBcIndvcmtzcGFjZVwiLCBoYW5kbGU6IFwid29ya3NwYWNlXCIgfSlcbiAgd29ya3NwYWNlITogdW5rbm93bjtcbn1cblxuLyoqXG4gKiBBbGwgYnVpbHQtaW4gYWdlbnQgbm9kZSBjb25zdHJ1Y3RvcnMuXG4gKi9cbmV4cG9ydCBjb25zdCBHUkFQSF9BR0VOVF9OT0RFUyA9IFtBZ2VudE5vZGVdIGFzIGNvbnN0O1xuIl19

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

@@ -0,0 +1,30 @@
+/**
+ * @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.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+export class GraphNode extends 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.
+     */
+    static applyMetadata(_meta) {
+        return null;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmFzZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3NyYy9ncmFwaC9zaGFyZWQvbm9kZXMvYmFzZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7R0FRRztBQUNILE9BQU8sRUFBRSxLQUFLLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUd2RCxNQUFNLE9BQU8sU0FBVSxTQUFRLEtBQUs7SUFDbEM7Ozs7Ozs7Ozs7Ozs7T0FhRztJQUNILE1BQU0sQ0FBQyxhQUFhLENBQUMsS0FBYztRQUNqQyxPQUFPLElBQUksQ0FBQztJQUNkLENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQG1vZHVsZSBpbnRlZ3JhdGlvbnMvZ3JhcGgvbm9kZXMvYmFzZVxuICogQHN1bW1hcnkgQmFzZSBjbGFzcyBmb3IgZ3JhcGggbm9kZSBkZWNsYXJhdGlvbnMuXG4gKiBAZGVzY3JpcHRpb24gYEdyYXBoTm9kZWAgZXh0ZW5kcyB7QGxpbmsgTW9kZWx9IHdpdGggYW4gb3ZlcnJpZGFibGVcbiAqIGBhcHBseU1ldGFkYXRhYCBzdGF0aWMgbWV0aG9kLiBDb25jcmV0ZSBub2RlIGtpbmRzIHRoYXQgc3VwcG9ydCBkeW5hbWljXG4gKiBtZXRhZGF0YSBjaGFuZ2VzIChlLmcuIGBTd2l0Y2hGbG93Tm9kZWAgYWRkaW5nIGNhc2Ugb3V0cHV0IHBvcnRzKSBvdmVycmlkZVxuICogdGhpcyBtZXRob2QgdG8gY29tcHV0ZSB0aGVpciBvd24gcG9ydHMsIHNpemUsIGFuZCBkYXRhIHBhdGNoZXMg4oCUIHRoZSBub2RlXG4gKiBpcyBleGNsdXNpdmVseSByZXNwb25zaWJsZSBmb3IgaXRzZWxmIGluIGV2ZXJ5IHdheS5cbiAqL1xuaW1wb3J0IHsgTW9kZWwgfSBmcm9tIFwiQGRlY2FmLXRzL2RlY29yYXRvci12YWxpZGF0aW9uXCI7XG5pbXBvcnQgdHlwZSB7IE5vZGVNZXRhZGF0YUNoYW5nZSB9IGZyb20gXCIuLi90eXBlc1wiO1xuXG5leHBvcnQgY2xhc3MgR3JhcGhOb2RlIGV4dGVuZHMgTW9kZWwge1xuICAvKipcbiAgICogQXBwbGllcyBhIG1ldGFkYXRhIHBhdGNoIHRvIHRoaXMgbm9kZSBjbGFzcywgcmV0dXJuaW5nIHRoZSByZXN1bHRpbmdcbiAgICogcG9ydHMsIHNpemUsIGFuZCBkYXRhIHBhdGNoZXMuXG4gICAqXG4gICAqIFRoZSBkZWZhdWx0IGltcGxlbWVudGF0aW9uIHJldHVybnMgYG51bGxgIChubyBjaGFuZ2VzKS4gQ29uY3JldGUgbm9kZVxuICAgKiBraW5kcyB0aGF0IHN1cHBvcnQgZHluYW1pYyBtZXRhZGF0YSBvdmVycmlkZSB0aGlzIHRvIGNvbXB1dGUgdGhlaXIgb3duXG4gICAqIHBvcnRzIGFuZCBzaXplIGZyb20gdGhlIG1ldGFkYXRhIOKAlCB0aGUgY2FsbGVyIChyZW5kZXJlcikgc2ltcGx5IHJlbGF5c1xuICAgKiB0aGUgcmVzdWx0IHRvIHRoZSBkaWFncmFtIG1vZGVsLlxuICAgKlxuICAgKiBAcGFyYW0gX21ldGEgLSBUaGUgbWV0YWRhdGEgcGF0Y2ggKG5vZGUta2luZC1zcGVjaWZpYywgZS5nLlxuICAgKiAgIGBTd2l0Y2hOb2RlTWV0YWRhdGFgKS5cbiAgICogQHJldHVybnMgVGhlIGNvbXB1dGVkIGNoYW5nZSwgb3IgYG51bGxgIHdoZW4gdGhlIG5vZGUga2luZCBkb2VzIG5vdFxuICAgKiAgIHN1cHBvcnQgZHluYW1pYyBtZXRhZGF0YS5cbiAgICovXG4gIHN0YXRpYyBhcHBseU1ldGFkYXRhKF9tZXRhOiB1bmtub3duKTogTm9kZU1ldGFkYXRhQ2hhbmdlIHwgbnVsbCB7XG4gICAgcmV0dXJuIG51bGw7XG4gIH1cbn1cbiJdfQ==

package/lib/esm/graph/shared/nodes/category-styles.js

@@ -0,0 +1,34 @@
+/**
+ * @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.
+ */
+import { registerGraphCategoryStyle, } from "@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.
+ */
+export function registerBuiltinCategoryStyles() {
+    // Node categories
+    registerGraphCategoryStyle("Trigger", { color: "#3b82f6", icon: "ti-bolt" });
+    registerGraphCategoryStyle("Flow Control", { color: "#f59e0b", icon: "ti-arrows-split-2" });
+    registerGraphCategoryStyle("Utility", { color: "#0d9488", icon: "ti-tool" });
+    registerGraphCategoryStyle("Loop", { color: "#eab308", icon: "ti-repeat" });
+    registerGraphCategoryStyle("Workflow", { color: "#f97316", icon: "ti-sitemap" });
+    registerGraphCategoryStyle("Pipeline", { color: "#0ea5e9", icon: "ti-git-merge" });
+    registerGraphCategoryStyle("Node", { color: "#8b5cf6", icon: "ti-point-filled" });
+    registerGraphCategoryStyle("Agent", { color: "#7c3aed", icon: "ti-robot" });
+    // Connection categories (for @connection() ports)
+    registerGraphCategoryStyle("model", { color: "#3b82f6", icon: "ti-cpu" });
+    registerGraphCategoryStyle("memory", { color: "#10b981", icon: "ti-database" });
+    registerGraphCategoryStyle("workspace", { color: "#f59e0b", icon: "ti-folder" });
+}
+// Register at module load so the styles are available immediately.
+registerBuiltinCategoryStyles();
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2F0ZWdvcnktc3R5bGVzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vc3JjL2dyYXBoL3NoYXJlZC9ub2Rlcy9jYXRlZ29yeS1zdHlsZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7R0FPRztBQUNILE9BQU8sRUFDTCwwQkFBMEIsR0FDM0IsTUFBTSwrQkFBK0IsQ0FBQztBQUV2Qzs7Ozs7O0dBTUc7QUFDSCxNQUFNLFVBQVUsNkJBQTZCO0lBQzNDLGtCQUFrQjtJQUNsQiwwQkFBMEIsQ0FBQyxTQUFTLEVBQUUsRUFBRSxLQUFLLEVBQUUsU0FBUyxFQUFFLElBQUksRUFBRSxTQUFTLEVBQUUsQ0FBQyxDQUFDO0lBQzdFLDBCQUEwQixDQUFDLGNBQWMsRUFBRSxFQUFFLEtBQUssRUFBRSxTQUFTLEVBQUUsSUFBSSxFQUFFLG1CQUFtQixFQUFFLENBQUMsQ0FBQztJQUM1RiwwQkFBMEIsQ0FBQyxTQUFTLEVBQUUsRUFBRSxLQUFLLEVBQUUsU0FBUyxFQUFFLElBQUksRUFBRSxTQUFTLEVBQUUsQ0FBQyxDQUFDO0lBQzdFLDBCQUEwQixDQUFDLE1BQU0sRUFBRSxFQUFFLEtBQUssRUFBRSxTQUFTLEVBQUUsSUFBSSxFQUFFLFdBQVcsRUFBRSxDQUFDLENBQUM7SUFDNUUsMEJBQTBCLENBQUMsVUFBVSxFQUFFLEVBQUUsS0FBSyxFQUFFLFNBQVMsRUFBRSxJQUFJLEVBQUUsWUFBWSxFQUFFLENBQUMsQ0FBQztJQUNqRiwwQkFBMEIsQ0FBQyxVQUFVLEVBQUUsRUFBRSxLQUFLLEVBQUUsU0FBUyxFQUFFLElBQUksRUFBRSxjQUFjLEVBQUUsQ0FBQyxDQUFDO0lBQ25GLDBCQUEwQixDQUFDLE1BQU0sRUFBRSxFQUFFLEtBQUssRUFBRSxTQUFTLEVBQUUsSUFBSSxFQUFFLGlCQUFpQixFQUFFLENBQUMsQ0FBQztJQUNsRiwwQkFBMEIsQ0FBQyxPQUFPLEVBQUUsRUFBRSxLQUFLLEVBQUUsU0FBUyxFQUFFLElBQUksRUFBRSxVQUFVLEVBQUUsQ0FBQyxDQUFDO0lBRTVFLGtEQUFrRDtJQUNsRCwwQkFBMEIsQ0FBQyxPQUFPLEVBQUUsRUFBRSxLQUFLLEVBQUUsU0FBUyxFQUFFLElBQUksRUFBRSxRQUFRLEVBQUUsQ0FBQyxDQUFDO0lBQzFFLDBCQUEwQixDQUFDLFFBQVEsRUFBRSxFQUFFLEtBQUssRUFBRSxTQUFTLEVBQUUsSUFBSSxFQUFFLGFBQWEsRUFBRSxDQUFDLENBQUM7SUFDaEYsMEJBQTBCLENBQUMsV0FBVyxFQUFFLEVBQUUsS0FBSyxFQUFFLFNBQVMsRUFBRSxJQUFJLEVBQUUsV0FBVyxFQUFFLENBQUMsQ0FBQztBQUNuRixDQUFDO0FBRUQsbUVBQW1FO0FBQ25FLDZCQUE2QixFQUFFLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEBtb2R1bGUgaW50ZWdyYXRpb25zL2dyYXBoL25vZGVzL2NhdGVnb3J5LXN0eWxlc1xuICogQHN1bW1hcnkgQnVpbHQtaW4gbm9kZS9jb25uZWN0aW9uIGNhdGVnb3J5IHN0eWxlIHJlZ2lzdHJhdGlvbnMuXG4gKiBAZGVzY3JpcHRpb24gUmVnaXN0ZXJzIGRlZmF1bHQgY29sb3JzIGFuZCBpY29ucyBmb3IgdGhlIGJ1aWx0LWluIG5vZGUgYW5kXG4gKiBjb25uZWN0aW9uIGNhdGVnb3JpZXMgKERFQ0FGLTMyIMKnMjEuMikuIFRoZSBgY29sb3JgIC8gYGljb25gIG9uIGEgbm9kZSdzXG4gKiBgQG5vZGUoKWAgbWV0YWRhdGEgYXJlIG9wdGlvbmFsIG92ZXJyaWRlcyDigJQgd2hlbiBvbWl0dGVkLCB0aGUgZWZmZWN0aXZlXG4gKiBzdHlsZSBpcyByZXNvbHZlZCBmcm9tIHRoZSBjYXRlZ29yeSByZWdpc3RyeS5cbiAqL1xuaW1wb3J0IHtcbiAgcmVnaXN0ZXJHcmFwaENhdGVnb3J5U3R5bGUsXG59IGZyb20gXCJAZGVjYWYtdHMvdWktZGVjb3JhdG9ycy9ncmFwaFwiO1xuXG4vKipcbiAqIFJlZ2lzdGVycyBhbGwgYnVpbHQtaW4gY2F0ZWdvcnkgc3R5bGVzLiBDYWxsZWQgb25jZSBhdCBtb2R1bGUgaW5pdC5cbiAqXG4gKiBDYXRlZ29yaWVzIGRlZmluZSB0aGUgZGVmYXVsdCB2aXN1YWwgc3R5bGUgZm9yIG5vZGVzIGFuZCBjb25uZWN0aW9uIHBvcnRzLlxuICogQSBub2RlJ3MgZXhwbGljaXQgYGNvbG9yYCAvIGBpY29uYCAob24gYEBub2RlKClgKSBvdmVycmlkZXMgdGhlIGNhdGVnb3J5XG4gKiBzdHlsZTsgd2hlbiBvbWl0dGVkLCB0aGUgY2F0ZWdvcnkgc3R5bGUgaXMgdXNlZC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHJlZ2lzdGVyQnVpbHRpbkNhdGVnb3J5U3R5bGVzKCk6IHZvaWQge1xuICAvLyBOb2RlIGNhdGVnb3JpZXNcbiAgcmVnaXN0ZXJHcmFwaENhdGVnb3J5U3R5bGUoXCJUcmlnZ2VyXCIsIHsgY29sb3I6IFwiIzNiODJmNlwiLCBpY29uOiBcInRpLWJvbHRcIiB9KTtcbiAgcmVnaXN0ZXJHcmFwaENhdGVnb3J5U3R5bGUoXCJGbG93IENvbnRyb2xcIiwgeyBjb2xvcjogXCIjZjU5ZTBiXCIsIGljb246IFwidGktYXJyb3dzLXNwbGl0LTJcIiB9KTtcbiAgcmVnaXN0ZXJHcmFwaENhdGVnb3J5U3R5bGUoXCJVdGlsaXR5XCIsIHsgY29sb3I6IFwiIzBkOTQ4OFwiLCBpY29uOiBcInRpLXRvb2xcIiB9KTtcbiAgcmVnaXN0ZXJHcmFwaENhdGVnb3J5U3R5bGUoXCJMb29wXCIsIHsgY29sb3I6IFwiI2VhYjMwOFwiLCBpY29uOiBcInRpLXJlcGVhdFwiIH0pO1xuICByZWdpc3RlckdyYXBoQ2F0ZWdvcnlTdHlsZShcIldvcmtmbG93XCIsIHsgY29sb3I6IFwiI2Y5NzMxNlwiLCBpY29uOiBcInRpLXNpdGVtYXBcIiB9KTtcbiAgcmVnaXN0ZXJHcmFwaENhdGVnb3J5U3R5bGUoXCJQaXBlbGluZVwiLCB7IGNvbG9yOiBcIiMwZWE1ZTlcIiwgaWNvbjogXCJ0aS1naXQtbWVyZ2VcIiB9KTtcbiAgcmVnaXN0ZXJHcmFwaENhdGVnb3J5U3R5bGUoXCJOb2RlXCIsIHsgY29sb3I6IFwiIzhiNWNmNlwiLCBpY29uOiBcInRpLXBvaW50LWZpbGxlZFwiIH0pO1xuICByZWdpc3RlckdyYXBoQ2F0ZWdvcnlTdHlsZShcIkFnZW50XCIsIHsgY29sb3I6IFwiIzdjM2FlZFwiLCBpY29uOiBcInRpLXJvYm90XCIgfSk7XG5cbiAgLy8gQ29ubmVjdGlvbiBjYXRlZ29yaWVzIChmb3IgQGNvbm5lY3Rpb24oKSBwb3J0cylcbiAgcmVnaXN0ZXJHcmFwaENhdGVnb3J5U3R5bGUoXCJtb2RlbFwiLCB7IGNvbG9yOiBcIiMzYjgyZjZcIiwgaWNvbjogXCJ0aS1jcHVcIiB9KTtcbiAgcmVnaXN0ZXJHcmFwaENhdGVnb3J5U3R5bGUoXCJtZW1vcnlcIiwgeyBjb2xvcjogXCIjMTBiOTgxXCIsIGljb246IFwidGktZGF0YWJhc2VcIiB9KTtcbiAgcmVnaXN0ZXJHcmFwaENhdGVnb3J5U3R5bGUoXCJ3b3Jrc3BhY2VcIiwgeyBjb2xvcjogXCIjZjU5ZTBiXCIsIGljb246IFwidGktZm9sZGVyXCIgfSk7XG59XG5cbi8vIFJlZ2lzdGVyIGF0IG1vZHVsZSBsb2FkIHNvIHRoZSBzdHlsZXMgYXJlIGF2YWlsYWJsZSBpbW1lZGlhdGVseS5cbnJlZ2lzdGVyQnVpbHRpbkNhdGVnb3J5U3R5bGVzKCk7XG4iXX0=