@decaf-ts/ui-decorators 0.20.9 → 0.21.1

package/lib/esm/graph/constants.js

@@ -1,335 +0,0 @@
-export var GraphKeys;
-(function (GraphKeys) {
-    GraphKeys["GRAPH"] = "graph";
-    GraphKeys["NODE"] = "graph.node";
-    GraphKeys["EDGE"] = "graph.edge";
-    GraphKeys["PORT"] = "graph.port";
-})(GraphKeys || (GraphKeys = {}));
-export var PortDirection;
-(function (PortDirection) {
-    PortDirection["INPUT"] = "input";
-    PortDirection["OUTPUT"] = "output";
-    PortDirection["CONNECTION"] = "connection";
-})(PortDirection || (PortDirection = {}));
-/**
- * The default visual-state → overlay mapping contract (DECAF-48 §4.4):
- * running=faded green, blocked=yellow, errored=red; succeeded keeps the
- * node's own accent; unexecuted-after-failure fades/disabled. This is the
- * shared, framework-neutral source of truth that supersedes the DECAF-32
- * §21.9 running colour for the live run-feedback overlay (§4.5).
- */
-export const GRAPH_VISUAL_STATE_STYLES = {
-    idle: { opacity: 1 },
-    running: { glow: "#22c55e", opacity: 0.85 },
-    blocked: { glow: "#eab308", opacity: 0.85 },
-    succeeded: { opacity: 1 },
-    failed: { glow: "#ef4444", opacity: 1 },
-    skipped: { opacity: 0.35 },
-};
-/**
- * Resolves the visual style overlay for a node/edge execution state, falling
- * back to a neutral default when the state is unknown or unregistered.
- *
- * @param state - The visual state string (as defined by the shared
- * `GraphVisualState` values, e.g. `"running"`, `"blocked"`).
- * @returns The style overlay for the given state.
- */
-export function graphVisualStyleOf(state) {
-    return GRAPH_VISUAL_STATE_STYLES[state] ?? GRAPH_VISUAL_STATE_STYLES.idle;
-}
-/**
- * Registry mapping category names to their default style (color + icon).
- * Consumers register categories via {@link registerGraphCategoryStyle}.
- *
- * The engine and renderer resolve the "effective" color/icon for a node by
- * checking the node's explicit `color` / `icon` first, then falling back to
- * the category's style, then a default.
- */
-const GRAPH_CATEGORY_STYLE_REGISTRY = {};
-/**
- * Default fallback style when no category is registered and no explicit
- * color/icon is set on the node.
- */
-export const GRAPH_DEFAULT_CATEGORY_STYLE = {
-    color: "#64748b",
-    icon: "ti-pointer",
-};
-/**
- * Fallback node size in pixels when a manifest declares no `width`/`height`
- * (D1, DECAF-50 §4.5). The manifest display remains the authority; this value
- * only fills an absent manifest dimension, never overriding a declared one.
- */
-export const GRAPH_DEFAULT_NODE_SIZE = 96;
-/**
- * Default node corner radius in pixels (D1, DECAF-50 §4.5) applied only when the
- * manifest declares no `cornerRadius`. Folded into the manifest display fields by
- * the D1 revision; no template CSS pins the radius.
- */
-export const GRAPH_DEFAULT_NODE_CORNER_RADIUS = 18;
-/**
- * Evaluates a node definition's manifest-declared, value-driven display rules
- * (D1, DECAF-50 §4.5) against per-parameter item counts. Content growth is
- * driven by the manifest, never by hardcoded per-node formulas: each matching
- * `parameterCount` rule adds `perItem * count` to its dimension. Falls back to the
- * manifest `width`/`height` when no rule applies.
- *
- * @param definition - The manifest definition carrying `width`/`height`/`sizeRules`.
- * @param parameterCounts - Item counts keyed by parameter id (e.g. `cases`).
- * @returns The resolved `{ width, height }` in pixels.
- */
-export function graphNodeSizeOf(definition, parameterCounts = {}) {
-    let width = definition.width ?? GRAPH_DEFAULT_NODE_SIZE;
-    let height = definition.height ?? GRAPH_DEFAULT_NODE_SIZE;
-    for (const rule of definition.sizeRules ?? []) {
-        if (rule.type !== "parameterCount")
-            continue;
-        const count = parameterCounts[rule.parameter] ?? 0;
-        if (count <= 0)
-            continue;
-        if (rule.dimension === "width")
-            width += count * rule.perItem;
-        else
-            height += count * rule.perItem;
-    }
-    return { width, height };
-}
-/**
- * Registers a category style (color + optional icon) in the global registry.
- * Call this at module init time (e.g. in the engine's node declarations) to
- * define the visual style for a category of nodes or connections.
- */
-export function registerGraphCategoryStyle(category, style) {
-    GRAPH_CATEGORY_STYLE_REGISTRY[category] = style;
-}
-/**
- * Returns the style registered for `category`, or the default fallback style.
- */
-export function graphCategoryStyleOf(category) {
-    if (category && GRAPH_CATEGORY_STYLE_REGISTRY[category]) {
-        return GRAPH_CATEGORY_STYLE_REGISTRY[category];
-    }
-    return GRAPH_DEFAULT_CATEGORY_STYLE;
-}
-/**
- * Resolves the effective color for a node (D7/G3-22, DECAF-50 §4.5).
- *
- * The **category base colour is authoritative**: every node of a registered
- * category renders that one base colour, so same-category nodes never diverge.
- * An explicit per-node `color` is an override applied at this single precedence
- * point — it only wins when the category has no registered base style.
- *
- * @param explicitColor - The node's explicit per-node colour override, when any.
- * @param category - The node's display category.
- * @param override - A user-applied per-node colour override; wins over everything.
- * @returns The resolved colour.
- */
-export function resolveEffectiveColor(explicitColor, category, override) {
-    if (override)
-        return override;
-    const base = category ? GRAPH_CATEGORY_STYLE_REGISTRY[category] : undefined;
-    if (base?.color)
-        return base.color;
-    if (explicitColor)
-        return explicitColor;
-    return GRAPH_DEFAULT_CATEGORY_STYLE.color;
-}
-/**
- * Resolves the effective icon for a node (D7/G3-22, DECAF-50 §4.5). The
- * **category base icon is authoritative**; an explicit per-node `icon` is an
- * override applied at this single precedence point.
- *
- * @param explicitIcon - The node's explicit per-node icon override, when any.
- * @param category - The node's display category.
- * @param override - A user-applied per-node icon override; wins over everything.
- * @returns The resolved icon name.
- */
-export function resolveEffectiveIcon(explicitIcon, category, override) {
-    if (override)
-        return override;
-    const base = category ? GRAPH_CATEGORY_STYLE_REGISTRY[category] : undefined;
-    if (base?.icon)
-        return base.icon;
-    if (explicitIcon)
-        return explicitIcon;
-    return GRAPH_DEFAULT_CATEGORY_STYLE.icon;
-}
-/**
- * Disabled-node execution semantics (DECAF-50 §4.9).
- *
- * - `skip` — the node does not execute and produces no outputs.
- * - `passThroughFirstInput` — the first incoming edge value is forwarded on
- *   the node's first declared output port.
- * - `emitDefaults` — every declared output port is emitted with its default
- *   (absent a declared default, `undefined`).
- */
-export const GRAPH_DISABLED_NODE_BEHAVIORS = [
-    "skip",
-    "passThroughFirstInput",
-    "emitDefaults",
-];
-/** The disabled-node behavior applied when a node declares none. */
-export const GRAPH_DEFAULT_DISABLED_NODE_BEHAVIOR = "skip";
-/** Type guard for {@link GraphDisabledNodeBehavior}. */
-export function isGraphDisabledNodeBehavior(value) {
-    return GRAPH_DISABLED_NODE_BEHAVIORS.includes(value);
-}
-/**
- * Execution status for a workflow or individual node.
- */
-export var GraphExecutionStatus;
-(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";
-})(GraphExecutionStatus || (GraphExecutionStatus = {}));
-/**
- * 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 var GraphVisualState;
-(function (GraphVisualState) {
-    GraphVisualState["IDLE"] = "idle";
-    GraphVisualState["RUNNING"] = "running";
-    GraphVisualState["BLOCKED"] = "blocked";
-    GraphVisualState["SUCCEEDED"] = "succeeded";
-    GraphVisualState["FAILED"] = "failed";
-    GraphVisualState["SKIPPED"] = "skipped";
-})(GraphVisualState || (GraphVisualState = {}));
-/**
- * Namespace root for graph run SSE topics (DECAF-48 §4.2). A subscription
- * filters on these granular topics before `observer.next(...)`.
- */
-export const GRAPH_RUN_TOPIC = "graph.run";
-/**
- * SSE sub-topic streaming per-node log lines during a run.
- */
-export const GRAPH_RUN_LOG_TOPIC = `${GRAPH_RUN_TOPIC}.log`;
-/**
- * SSE sub-topic streaming node/edge execution-state updates during a run.
- */
-export const GRAPH_RUN_STATE_TOPIC = `${GRAPH_RUN_TOPIC}.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 var GraphLogAttribute;
-(function (GraphLogAttribute) {
-    GraphLogAttribute["NODE_ID"] = "nodeId";
-    GraphLogAttribute["WORKFLOW_ID"] = "workflowId";
-    GraphLogAttribute["RUN_ID"] = "runId";
-    GraphLogAttribute["USER"] = "user";
-})(GraphLogAttribute || (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.
- */
-export function graphRunTopicOf(eventType) {
-    switch (eventType) {
-        case GraphExecutionEventType.GRAPH_RUN_LOG:
-            return GRAPH_RUN_LOG_TOPIC;
-        case GraphExecutionEventType.NODE_STATE_CHANGED:
-        case GraphExecutionEventType.EDGE_STATE_CHANGED:
-            return GRAPH_RUN_STATE_TOPIC;
-        default:
-            return GRAPH_RUN_TOPIC;
-    }
-}
-/**
- * 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 var GraphExecutionEventType;
-(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";
-})(GraphExecutionEventType || (GraphExecutionEventType = {}));
-/** Default run limits: request size, per-caller concurrency, event retention/payload size, execution timeout, and post-terminal event replay window. */
-export const DEFAULT_GRAPH_RUN_LIMITS = {
-    maxRequestBytes: 4_000_000,
-    maxConcurrentRuns: 32,
-    maxEventsPerRun: 10_000,
-    maxEventPayloadBytes: 256_000,
-    executionTimeoutMs: 600_000,
-    eventReplayWindowMs: 300_000,
-};
-/**
- * Terminal graph event types closing a run's SSE stream
- * (DECAF-50 §4.15). The run SSE endpoint never emits anything after these.
- */
-export const GRAPH_RUN_TERMINAL_EVENT_TYPES = [
-    GraphExecutionEventType.WORKFLOW_COMPLETED,
-    GraphExecutionEventType.WORKFLOW_FAILED,
-    GraphExecutionEventType.WORKFLOW_CANCELLED,
-];
-/** Whether the event type is a run-stream terminal type (see {@link GRAPH_RUN_TERMINAL_EVENT_TYPES}). */
-export function isGraphRunTerminalEventType(type) {
-    return GRAPH_RUN_TERMINAL_EVENT_TYPES.includes(type);
-}
-/** Whether the run status is terminal (`succeeded`, `failed`, or `cancelled`). */
-export function isGraphRunTerminalStatus(status) {
-    return status === "succeeded" || status === "failed" || status === "cancelled";
-}
-/** Type guard for {@link GraphRunStatus}. */
-export function isGraphRunStatus(value) {
-    return (typeof value === "string" &&
-        [
-            "queued",
-            "validating",
-            "running",
-            "succeeded",
-            "failed",
-            "cancelled",
-        ].includes(value));
-}
-//# sourceMappingURL=constants.js.map

package/lib/esm/graph/constants.js.map

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

package/lib/esm/graph/decorators.js

@@ -1,141 +0,0 @@
-import { apply, Decoration, Metadata, metadata, propMetadata, } from "@decaf-ts/decoration";
-import { uimodel } from "./../model/decorators.js";
-import { GraphKeys, PortDirection } from "./constants.js";
-import { graphPortsOf } from "./reader.js";
-import { registerNode, registerWorkflow } from "./registry.js";
-export function node(tag, graph, props) {
-    function node(tag, graph, props) {
-        const meta = {
-            kind: graph?.kind || tag,
-            ...graph,
-        };
-        return function innerNode(target) {
-            const result = apply(uimodel(tag, props), metadata(GraphKeys.NODE, meta))(target);
-            registerNode(target);
-            return result;
-        };
-    }
-    return Decoration.for(GraphKeys.NODE)
-        .define({
-        decorator: node,
-        args: [tag, graph, props],
-    })
-        .apply();
-}
-export function graph(tag, graph, props) {
-    function graphDecorator(tag, graph, props) {
-        return function innerGraph(target) {
-            const ports = graphPortsOf(target);
-            const meta = {
-                ...(graph || {}),
-                kind: graph?.kind || tag,
-                inputs: graph?.inputs ||
-                    ports.filter((port) => port.direction === PortDirection.INPUT),
-                outputs: graph?.outputs ||
-                    ports.filter((port) => port.direction === PortDirection.OUTPUT),
-                connections: graph?.connections ||
-                    ports.filter((port) => port.direction === PortDirection.CONNECTION),
-            };
-            const result = apply(uimodel(tag, props), metadata(GraphKeys.GRAPH, meta))(target);
-            registerWorkflow(target);
-            return result;
-        };
-    }
-    return Decoration.for(GraphKeys.GRAPH)
-        .define({
-        decorator: graphDecorator,
-        args: [tag, graph, props],
-    })
-        .apply();
-}
-export function port(direction, graph) {
-    function port(direction, graph) {
-        return function innerPort(target, propertyKey) {
-            const meta = {
-                direction,
-                ...graph,
-            };
-            return apply(propMetadata(Metadata.key(GraphKeys.PORT, propertyKey), meta))(target, propertyKey);
-        };
-    }
-    return Decoration.for(GraphKeys.PORT)
-        .define({
-        decorator: port,
-        args: [direction, graph],
-    })
-        .apply();
-}
-export function input(graph) {
-    return port(PortDirection.INPUT, { ...graph, schema: true });
-}
-export function output(graph) {
-    return port(PortDirection.OUTPUT, { ...graph, schema: true });
-}
-/**
- * Declares a "connection" port on a node — a third port kind alongside
- * `@input()` and `@output()`. Connection ports are rendered on the **bottom**
- * side of the node (inputs are on the left, outputs on the right).
- *
- * Connections are typed by `category` (e.g. `"model"`, `"memory"`,
- * `"workspace"`). The category determines the port's color via the
- * {@link registerGraphCategoryStyle} registry.
- *
- * Unlike `@input` / `@output`, connection ports do NOT carry workflow data
- * values — they represent structural dependencies (e.g. an Agent node
- * connecting to a Model resource, a Memory store, or a Workspace). Nodes may
- * have zero or more `@connection()` ports.
- *
- * Usage:
- * ```ts
- * @node("ai.agent", { kind: "ai.agent", category: "Agent" })
- * @model()
- * export class AgentNode extends Model {
- *   @connection({ category: "model", handle: "model" })
- *   model!: unknown;
- *
- *   @connection({ category: "memory", handle: "memory" })
- *   memory!: unknown;
- * }
- * ```
- */
-export function connection(graph) {
-    return port(PortDirection.CONNECTION, graph);
-}
-/**
- * Class decorator that marks a graph node as pinnable.
- *
- * The metadata is stored in the node's `graph.metadata.pinnable` field so the
- * Angular renderer and the core pinning policy can read it.
- *
- * Usage:
- * ```ts
- * @node("ai.expensiveCompletion", { kind: "ai.expensiveCompletion" })
- * @pinnable({ strategy: "manual", includeDependencies: true })
- * export class ExpensiveCompletionNode extends Model { ... }
- * ```
- */
-export function pinnable(options = {}) {
-    function pinnable(target) {
-        const existingMeta = Metadata.get(target, GraphKeys.NODE);
-        const meta = existingMeta ?? {};
-        meta.metadata = {
-            ...(meta.metadata ?? {}),
-            pinnable: {
-                enabled: options.enabled ?? true,
-                ttlMs: options.ttlMs,
-                strategy: options.strategy ?? "manual",
-                includeDependencies: options.includeDependencies ?? true,
-                metadata: options.metadata,
-            },
-        };
-        Metadata.set(target, GraphKeys.NODE, meta);
-        return target;
-    }
-    return Decoration.for("graph.pinnable")
-        .define({
-        decorator: pinnable,
-        args: [options],
-    })
-        .apply();
-}
-//# sourceMappingURL=decorators.js.map

package/lib/esm/graph/decorators.js.map

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