@mindlogic-ai/logician-ui 3.1.0 → 3.2.0-alpha.1

package/dist/components/Workflow/canvas/issueSeverity.mjs

@@ -0,0 +1,47 @@
+"use client";
+import 'react/jsx-runtime';
+import '@chakra-ui/react';
+import { toastStyles } from '../../Toast/Toast.styles.mjs';
+import '../../Icon/index.mjs';
+import '../../Toast/Toaster.mjs';
+import 'react';
+
+const SEVERITY_PRECEDENCE = {
+    error: 2,
+    warning: 1,
+};
+/**
+ * The single issue a one-slot surface should represent: highest severity
+ * wins, first-listed breaks ties. Shared by every "tint by worst issue"
+ * consumer (field borders, the header title editor) so precedence can't
+ * drift between surfaces.
+ */
+const pickPrimaryIssue = (issues) => {
+    if (issues.length === 0)
+        return null;
+    let primary = issues[0];
+    for (let i = 1; i < issues.length; i += 1) {
+        if (SEVERITY_PRECEDENCE[issues[i].severity] >
+            SEVERITY_PRECEDENCE[primary.severity]) {
+            primary = issues[i];
+        }
+    }
+    return primary;
+};
+/**
+ * Semantic color token for an issue severity — shared across issue list UIs.
+ * `tone` selects the shade: the default `'main'` for text/icons, or `'dark'`
+ * where `.main` is too light to read (e.g. the small list-bullet markers in
+ * drawer issue callouts, which need extra contrast against the tinted bg).
+ */
+const severityColorToken = (severity, tone = 'main') => (severity === 'error' ? `danger.${tone}` : `warning.${tone}`);
+/**
+ * Tinted callout styling (bg / border / text) for an issue severity. Reuses the
+ * `Toast` component's golden-ratio combo — the documented WCAG AA pairing — so
+ * the boxed inspector callouts stay in lockstep with it instead of restating
+ * the tokens. `IssueSeverity` is a subset of the toast statuses.
+ */
+const severityCalloutStyle = (severity) => toastStyles[severity];
+
+export { pickPrimaryIssue, severityCalloutStyle, severityColorToken };
+//# sourceMappingURL=issueSeverity.mjs.map

package/dist/components/Workflow/canvas/issueSeverity.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"issueSeverity.mjs","sources":["../../../../src/components/Workflow/canvas/issueSeverity.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;AAIA,MAAM,mBAAmB,GAAkC;AACzD,IAAA,KAAK,EAAE,CAAC;AACR,IAAA,OAAO,EAAE,CAAC;CACX;AAED;;;;;AAKG;AACI,MAAM,gBAAgB,GAAG,CAAC,MAAe,KAAkB;AAChE,IAAA,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,IAAI;AACpC,IAAA,IAAI,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC;AACvB,IAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;QACzC,IACE,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACvC,YAAA,mBAAmB,CAAC,OAAO,CAAC,QAAQ,CAAC,EACrC;AACA,YAAA,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC;QACrB;IACF;AACA,IAAA,OAAO,OAAO;AAChB;AAEA;;;;;AAKG;AACI,MAAM,kBAAkB,GAAG,CAChC,QAAuB,EACvB,IAAA,GAAwB,MAAM,MAClB,QAAQ,KAAK,OAAO,GAAG,CAAA,OAAA,EAAU,IAAI,CAAA,CAAE,GAAG,CAAA,QAAA,EAAW,IAAI,CAAA,CAAE;AAEzE;;;;;AAKG;AACI,MAAM,oBAAoB,GAAG,CAAC,QAAuB,KAC1D,WAAW,CAAC,QAAQ;;;;"}

package/dist/components/Workflow/canvas/useFieldFocusRequest.d.ts

@@ -0,0 +1,14 @@
+import { type RefObject } from 'react';
+/**
+ * Wires a field surface into the `fieldFocusRequest` channel: when the canvas
+ * validation banner asks to jump to `(nodeId, fieldKey)`, the matching
+ * container scrolls into view and its first focusable element is focused,
+ * then the request is consumed so a re-render doesn't refocus repeatedly.
+ *
+ * Shared by `FieldWrapper` (body fields) and `NodeTitleEditable` (the header
+ * rename editor) so the jump protocol can't drift between them. The selector
+ * includes the editable's `[data-part="preview"]` — focusing it activates
+ * edit mode (activationMode "focus"); mid-edit its `input` matches first.
+ */
+export declare function useFieldFocusRequest(nodeId: string, fieldKey: string, containerRef: RefObject<HTMLDivElement | null>): void;
+//# sourceMappingURL=useFieldFocusRequest.d.ts.map

package/dist/components/Workflow/canvas/useFieldFocusRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFieldFocusRequest.d.ts","sourceRoot":"","sources":["../../../../src/components/Workflow/canvas/useFieldFocusRequest.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,OAAO,CAAC;AAIlD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,GAC7C,IAAI,CAgCN"}

package/dist/components/Workflow/canvas/useFieldFocusRequest.js

@@ -0,0 +1,48 @@
+"use client";
+'use strict';
+
+var React = require('react');
+var WorkflowContext = require('../WorkflowContext/WorkflowContext.js');
+
+/**
+ * Wires a field surface into the `fieldFocusRequest` channel: when the canvas
+ * validation banner asks to jump to `(nodeId, fieldKey)`, the matching
+ * container scrolls into view and its first focusable element is focused,
+ * then the request is consumed so a re-render doesn't refocus repeatedly.
+ *
+ * Shared by `FieldWrapper` (body fields) and `NodeTitleEditable` (the header
+ * rename editor) so the jump protocol can't drift between them. The selector
+ * includes the editable's `[data-part="preview"]` — focusing it activates
+ * edit mode (activationMode "focus"); mid-edit its `input` matches first.
+ */
+function useFieldFocusRequest(nodeId, fieldKey, containerRef) {
+    const { fieldFocusRequest, consumeFieldFocusRequest } = WorkflowContext.useWorkflow();
+    React.useEffect(() => {
+        if (fieldFocusRequest?.nodeId !== nodeId ||
+            fieldFocusRequest.fieldKey !== fieldKey) {
+            return;
+        }
+        // Defer one frame so a freshly-mounted drawer has painted before we
+        // try to scroll/focus inside it.
+        const handle = requestAnimationFrame(() => {
+            const root = containerRef.current;
+            if (root) {
+                root.scrollIntoView({ block: 'center', behavior: 'smooth' });
+                root
+                    .querySelector('input, textarea, [contenteditable="true"], select, button, [data-part="preview"]')
+                    ?.focus();
+            }
+            consumeFieldFocusRequest();
+        });
+        return () => cancelAnimationFrame(handle);
+    }, [
+        fieldFocusRequest,
+        nodeId,
+        fieldKey,
+        containerRef,
+        consumeFieldFocusRequest,
+    ]);
+}
+
+exports.useFieldFocusRequest = useFieldFocusRequest;
+//# sourceMappingURL=useFieldFocusRequest.js.map

package/dist/components/Workflow/canvas/useFieldFocusRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFieldFocusRequest.js","sources":["../../../../src/components/Workflow/canvas/useFieldFocusRequest.ts"],"sourcesContent":[null],"names":["useWorkflow","useEffect"],"mappings":";;;;;;AAMA;;;;;;;;;;AAUG;SACa,oBAAoB,CAClC,MAAc,EACd,QAAgB,EAChB,YAA8C,EAAA;IAE9C,MAAM,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,GAAGA,2BAAW,EAAE;IAErEC,eAAS,CAAC,MAAK;AACb,QAAA,IACE,iBAAiB,EAAE,MAAM,KAAK,MAAM;AACpC,YAAA,iBAAiB,CAAC,QAAQ,KAAK,QAAQ,EACvC;YACA;QACF;;;AAGA,QAAA,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAK;AACxC,YAAA,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO;YACjC,IAAI,IAAI,EAAE;AACR,gBAAA,IAAI,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;gBAC5D;qBACG,aAAa,CACZ,kFAAkF;sBAElF,KAAK,EAAE;YACb;AACA,YAAA,wBAAwB,EAAE;AAC5B,QAAA,CAAC,CAAC;AACF,QAAA,OAAO,MAAM,oBAAoB,CAAC,MAAM,CAAC;AAC3C,IAAA,CAAC,EAAE;QACD,iBAAiB;QACjB,MAAM;QACN,QAAQ;QACR,YAAY;QACZ,wBAAwB;AACzB,KAAA,CAAC;AACJ;;;;"}

package/dist/components/Workflow/canvas/useFieldFocusRequest.mjs

@@ -0,0 +1,46 @@
+"use client";
+import { useEffect } from 'react';
+import { useWorkflow } from '../WorkflowContext/WorkflowContext.mjs';
+
+/**
+ * Wires a field surface into the `fieldFocusRequest` channel: when the canvas
+ * validation banner asks to jump to `(nodeId, fieldKey)`, the matching
+ * container scrolls into view and its first focusable element is focused,
+ * then the request is consumed so a re-render doesn't refocus repeatedly.
+ *
+ * Shared by `FieldWrapper` (body fields) and `NodeTitleEditable` (the header
+ * rename editor) so the jump protocol can't drift between them. The selector
+ * includes the editable's `[data-part="preview"]` — focusing it activates
+ * edit mode (activationMode "focus"); mid-edit its `input` matches first.
+ */
+function useFieldFocusRequest(nodeId, fieldKey, containerRef) {
+    const { fieldFocusRequest, consumeFieldFocusRequest } = useWorkflow();
+    useEffect(() => {
+        if (fieldFocusRequest?.nodeId !== nodeId ||
+            fieldFocusRequest.fieldKey !== fieldKey) {
+            return;
+        }
+        // Defer one frame so a freshly-mounted drawer has painted before we
+        // try to scroll/focus inside it.
+        const handle = requestAnimationFrame(() => {
+            const root = containerRef.current;
+            if (root) {
+                root.scrollIntoView({ block: 'center', behavior: 'smooth' });
+                root
+                    .querySelector('input, textarea, [contenteditable="true"], select, button, [data-part="preview"]')
+                    ?.focus();
+            }
+            consumeFieldFocusRequest();
+        });
+        return () => cancelAnimationFrame(handle);
+    }, [
+        fieldFocusRequest,
+        nodeId,
+        fieldKey,
+        containerRef,
+        consumeFieldFocusRequest,
+    ]);
+}
+
+export { useFieldFocusRequest };
+//# sourceMappingURL=useFieldFocusRequest.mjs.map

package/dist/components/Workflow/canvas/useFieldFocusRequest.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFieldFocusRequest.mjs","sources":["../../../../src/components/Workflow/canvas/useFieldFocusRequest.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAMA;;;;;;;;;;AAUG;SACa,oBAAoB,CAClC,MAAc,EACd,QAAgB,EAChB,YAA8C,EAAA;IAE9C,MAAM,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,GAAG,WAAW,EAAE;IAErE,SAAS,CAAC,MAAK;AACb,QAAA,IACE,iBAAiB,EAAE,MAAM,KAAK,MAAM;AACpC,YAAA,iBAAiB,CAAC,QAAQ,KAAK,QAAQ,EACvC;YACA;QACF;;;AAGA,QAAA,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAK;AACxC,YAAA,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO;YACjC,IAAI,IAAI,EAAE;AACR,gBAAA,IAAI,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;gBAC5D;qBACG,aAAa,CACZ,kFAAkF;sBAElF,KAAK,EAAE;YACb;AACA,YAAA,wBAAwB,EAAE;AAC5B,QAAA,CAAC,CAAC;AACF,QAAA,OAAO,MAAM,oBAAoB,CAAC,MAAM,CAAC;AAC3C,IAAA,CAAC,EAAE;QACD,iBAAiB;QACjB,MAAM;QACN,QAAQ;QACR,YAAY;QACZ,wBAAwB;AACzB,KAAA,CAAC;AACJ;;;;"}

package/dist/components/Workflow/canvas/workflowLabelProps.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared label styling for inputs inside the workflow editor's drawer.
+ * Mirrors the outer ChatbotForm's `FieldLabel` heading tokens so the
+ * editor's inspector reads as the same form surface; the Workflow
+ * canvas can't import from the studio `app/` route, so this lives at
+ * the canvas layer instead.
+ */
+export declare const workflowLabelProps: {
+    readonly fontWeight: "semibold";
+    readonly color: "slate.1300";
+};
+//# sourceMappingURL=workflowLabelProps.d.ts.map

package/dist/components/Workflow/canvas/workflowLabelProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowLabelProps.d.ts","sourceRoot":"","sources":["../../../../src/components/Workflow/canvas/workflowLabelProps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB;;;CAGrB,CAAC"}

package/dist/components/Workflow/canvas/workflowLabelProps.js

@@ -0,0 +1,17 @@
+"use client";
+'use strict';
+
+/**
+ * Shared label styling for inputs inside the workflow editor's drawer.
+ * Mirrors the outer ChatbotForm's `FieldLabel` heading tokens so the
+ * editor's inspector reads as the same form surface; the Workflow
+ * canvas can't import from the studio `app/` route, so this lives at
+ * the canvas layer instead.
+ */
+const workflowLabelProps = {
+    fontWeight: 'semibold',
+    color: 'slate.1300',
+};
+
+exports.workflowLabelProps = workflowLabelProps;
+//# sourceMappingURL=workflowLabelProps.js.map

package/dist/components/Workflow/canvas/workflowLabelProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowLabelProps.js","sources":["../../../../src/components/Workflow/canvas/workflowLabelProps.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAAA;;;;;;AAMG;AACI,MAAM,kBAAkB,GAAG;AAChC,IAAA,UAAU,EAAE,UAAU;AACtB,IAAA,KAAK,EAAE,YAAY;;;;;"}

package/dist/components/Workflow/canvas/workflowLabelProps.mjs

@@ -0,0 +1,15 @@
+"use client";
+/**
+ * Shared label styling for inputs inside the workflow editor's drawer.
+ * Mirrors the outer ChatbotForm's `FieldLabel` heading tokens so the
+ * editor's inspector reads as the same form surface; the Workflow
+ * canvas can't import from the studio `app/` route, so this lives at
+ * the canvas layer instead.
+ */
+const workflowLabelProps = {
+    fontWeight: 'semibold',
+    color: 'slate.1300',
+};
+
+export { workflowLabelProps };
+//# sourceMappingURL=workflowLabelProps.mjs.map

package/dist/components/Workflow/canvas/workflowLabelProps.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowLabelProps.mjs","sources":["../../../../src/components/Workflow/canvas/workflowLabelProps.ts"],"sourcesContent":[null],"names":[],"mappings":";AAAA;;;;;;AAMG;AACI,MAAM,kBAAkB,GAAG;AAChC,IAAA,UAAU,EAAE,UAAU;AACtB,IAAA,KAAK,EAAE,YAAY;;;;;"}

package/dist/components/Workflow/connectionRules.d.ts

@@ -0,0 +1,59 @@
+import type { Connection } from '@xyflow/react';
+import type { Graph, GraphEdge, NodeTypeDef } from './Workflow.types';
+/** Resolves a node-type definition by kind. */
+type GetNodeType = (kind: string) => NodeTypeDef | undefined;
+/** A prospective connection; mirrors React Flow's `Connection` (handles nullable). */
+type ProposedConnection = Pick<Connection, 'source' | 'target' | 'sourceHandle' | 'targetHandle'>;
+/**
+ * Validates a proposed connection against node-type handle declarations and the
+ * optional `canConnect` rules of both endpoints. Shared by the canvas
+ * `isValidConnection`, manual `onConnect`, edge reconnect, and palette
+ * auto-connect so every path enforces the same constraints:
+ *  - no self-connections,
+ *  - the source must expose an output handle (Start/Agent/etc., never End),
+ *  - the target must expose an input handle (End/Agent/etc., never Start),
+ *  - a named `sourceHandle`/`targetHandle` must be a declared handle id,
+ *  - connections run exit→entry only: the `sourceHandle` must be an output of
+ *    the source and the `targetHandle` an input of the target — never the
+ *    reverse (no exit→exit / entry→entry wiring),
+ *  - any node-type `canConnect` hook on either endpoint must return `true`.
+ */
+export declare function isValidConnection(connection: ProposedConnection, graph: Graph, getNodeType: GetNodeType): boolean;
+/**
+ * The existing outbound edge from a node's given handle, if any. Each exit
+ * point holds at most one edge: a single-output node is "taken" once it has any
+ * outbound edge; named handles (classify categories, if/else branches,
+ * guardrail pass/fail) are tracked individually by their `sourceHandle` id.
+ *
+ * Used by the canvas to decide whether a fresh drag from an exit should create
+ * a new edge or MOVE the one already there.
+ */
+export declare function existingEdgeFromHandle(graph: Graph, getNodeType: GetNodeType, source: string, sourceHandle: string | undefined): GraphEdge | undefined;
+/**
+ * The sole inbound edge to a node's given input handle, or `undefined` when the
+ * handle has zero or more than one. Unlike exits (one edge each), entries allow
+ * fan-in: several sources can converge on one input. So "grab the existing edge
+ * and re-route it" is only unambiguous when exactly one edge points at the
+ * handle — with two or more there's no single edge to grab, and the drag should
+ * fall back to adding another fan-in edge.
+ *
+ * Used by the canvas to decide whether a drag that *starts* from an occupied
+ * entry should move that edge's source endpoint instead of creating a new edge.
+ */
+export declare function soleEdgeToHandle(graph: Graph, getNodeType: GetNodeType, target: string, targetHandle: string | undefined): GraphEdge | undefined;
+/**
+ * Detects a single output-handle id rename between two configs of the same
+ * node, so the edge on that handle can move with it instead of being orphaned.
+ * Handle ids that derive from mutable config (Classify's `cat_<name>`) change
+ * when the author edits a name; diffing the declared outputs yields the rename.
+ *
+ * Returns the pair only for an unambiguous 1:1 rename — a pure add or remove
+ * (which the per-field drawer does one at a time) yields `undefined`, leaving
+ * edges to their normal add/prune behaviour.
+ */
+export declare function renamedOutputHandle(handles: NodeTypeDef['handles'], oldConfig: unknown, newConfig: unknown): {
+    from: string;
+    to: string;
+} | undefined;
+export {};
+//# sourceMappingURL=connectionRules.d.ts.map

package/dist/components/Workflow/connectionRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectionRules.d.ts","sourceRoot":"","sources":["../../../src/components/Workflow/connectionRules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEtE,+CAA+C;AAC/C,KAAK,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAC;AAE7D,sFAAsF;AACtF,KAAK,kBAAkB,GAAG,IAAI,CAC5B,UAAU,EACV,QAAQ,GAAG,QAAQ,GAAG,cAAc,GAAG,cAAc,CACtD,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,kBAAkB,EAC9B,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,WAAW,GACvB,OAAO,CA6DT;AAiBD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,SAAS,GAAG,SAAS,CAWvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,SAAS,GAAG,SAAS,CAYvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,EAC/B,SAAS,EAAE,OAAO,EAClB,SAAS,EAAE,OAAO,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAS1C"}

package/dist/components/Workflow/connectionRules.js

@@ -0,0 +1,150 @@
+"use client";
+'use strict';
+
+/**
+ * Validates a proposed connection against node-type handle declarations and the
+ * optional `canConnect` rules of both endpoints. Shared by the canvas
+ * `isValidConnection`, manual `onConnect`, edge reconnect, and palette
+ * auto-connect so every path enforces the same constraints:
+ *  - no self-connections,
+ *  - the source must expose an output handle (Start/Agent/etc., never End),
+ *  - the target must expose an input handle (End/Agent/etc., never Start),
+ *  - a named `sourceHandle`/`targetHandle` must be a declared handle id,
+ *  - connections run exit→entry only: the `sourceHandle` must be an output of
+ *    the source and the `targetHandle` an input of the target — never the
+ *    reverse (no exit→exit / entry→entry wiring),
+ *  - any node-type `canConnect` hook on either endpoint must return `true`.
+ */
+function isValidConnection(connection, graph, getNodeType) {
+    if (!connection.source || !connection.target)
+        return false;
+    if (connection.source === connection.target)
+        return false;
+    const source = graph.nodes.find((n) => n.id === connection.source);
+    const target = graph.nodes.find((n) => n.id === connection.target);
+    if (!source || !target)
+        return false;
+    const sourceDef = getNodeType(source.kind);
+    const targetDef = getNodeType(target.kind);
+    if (!sourceDef || !targetDef)
+        return false;
+    const sourceHandles = sourceDef.handles(source.config);
+    const targetHandles = targetDef.handles(target.config);
+    const sourceOutputs = sourceHandles.outputs;
+    const targetInputs = targetHandles.inputs;
+    // Source must be able to emit and target must be able to receive.
+    if (sourceOutputs.length === 0)
+        return false;
+    if (targetInputs.length === 0)
+        return false;
+    // A requested named handle must actually exist on the node.
+    if (connection.sourceHandle &&
+        !sourceOutputs.some((h) => h.id === connection.sourceHandle)) {
+        return false;
+    }
+    if (connection.targetHandle &&
+        !targetInputs.some((h) => h.id === connection.targetHandle)) {
+        return false;
+    }
+    // Exit→entry only. React Flow's strict connection mode already blocks
+    // output↔output (exit→exit) and input↔input drags, but enforce it here too so
+    // every path — manual connect, reconnect, programmatic edges — agrees: reject
+    // a `sourceHandle` that is actually an input of the source, or a `targetHandle`
+    // that is actually an output of the target.
+    if (connection.sourceHandle &&
+        sourceHandles.inputs.some((h) => h.id === connection.sourceHandle)) {
+        return false;
+    }
+    if (connection.targetHandle &&
+        targetHandles.outputs.some((h) => h.id === connection.targetHandle)) {
+        return false;
+    }
+    const ctx = {
+        source,
+        sourceHandle: connection.sourceHandle ?? undefined,
+        target,
+        targetHandle: connection.targetHandle ?? undefined,
+        graph,
+    };
+    for (const def of [sourceDef, targetDef]) {
+        if (def.canConnect && def.canConnect(ctx) !== true)
+            return false;
+    }
+    return true;
+}
+/**
+ * Resolves a possibly-omitted handle id to the port it actually attaches to.
+ * Edges loaded from the backend / fixtures may omit the handle id for a node's
+ * default port, while the canvas renders every port with a concrete id (see
+ * `NodeShell`). React Flow attaches a handle-less edge to the node's first port
+ * of that type, so `undefined` and that first id denote the same port — collapse
+ * them before comparing or the lookup misses the edge (and we'd duplicate it).
+ */
+function resolveHandle(handle, ports) {
+    return handle ?? ports[0]?.id;
+}
+/**
+ * The existing outbound edge from a node's given handle, if any. Each exit
+ * point holds at most one edge: a single-output node is "taken" once it has any
+ * outbound edge; named handles (classify categories, if/else branches,
+ * guardrail pass/fail) are tracked individually by their `sourceHandle` id.
+ *
+ * Used by the canvas to decide whether a fresh drag from an exit should create
+ * a new edge or MOVE the one already there.
+ */
+function existingEdgeFromHandle(graph, getNodeType, source, sourceHandle) {
+    const node = graph.nodes.find((n) => n.id === source);
+    const outputs = node
+        ? (getNodeType(node.kind)?.handles(node.config).outputs ?? [])
+        : [];
+    const want = resolveHandle(sourceHandle, outputs);
+    return graph.edges.find((e) => e.source === source &&
+        resolveHandle(e.sourceHandle ?? undefined, outputs) === want);
+}
+/**
+ * The sole inbound edge to a node's given input handle, or `undefined` when the
+ * handle has zero or more than one. Unlike exits (one edge each), entries allow
+ * fan-in: several sources can converge on one input. So "grab the existing edge
+ * and re-route it" is only unambiguous when exactly one edge points at the
+ * handle — with two or more there's no single edge to grab, and the drag should
+ * fall back to adding another fan-in edge.
+ *
+ * Used by the canvas to decide whether a drag that *starts* from an occupied
+ * entry should move that edge's source endpoint instead of creating a new edge.
+ */
+function soleEdgeToHandle(graph, getNodeType, target, targetHandle) {
+    const node = graph.nodes.find((n) => n.id === target);
+    const inputs = node
+        ? (getNodeType(node.kind)?.handles(node.config).inputs ?? [])
+        : [];
+    const want = resolveHandle(targetHandle, inputs);
+    const inbound = graph.edges.filter((e) => e.target === target &&
+        resolveHandle(e.targetHandle ?? undefined, inputs) === want);
+    return inbound.length === 1 ? inbound[0] : undefined;
+}
+/**
+ * Detects a single output-handle id rename between two configs of the same
+ * node, so the edge on that handle can move with it instead of being orphaned.
+ * Handle ids that derive from mutable config (Classify's `cat_<name>`) change
+ * when the author edits a name; diffing the declared outputs yields the rename.
+ *
+ * Returns the pair only for an unambiguous 1:1 rename — a pure add or remove
+ * (which the per-field drawer does one at a time) yields `undefined`, leaving
+ * edges to their normal add/prune behaviour.
+ */
+function renamedOutputHandle(handles, oldConfig, newConfig) {
+    const oldIds = handles(oldConfig).outputs.map((h) => h.id);
+    const newIds = handles(newConfig).outputs.map((h) => h.id);
+    const removed = oldIds.filter((id) => !newIds.includes(id));
+    const added = newIds.filter((id) => !oldIds.includes(id));
+    if (removed.length === 1 && added.length === 1) {
+        return { from: removed[0], to: added[0] };
+    }
+    return undefined;
+}
+
+exports.existingEdgeFromHandle = existingEdgeFromHandle;
+exports.isValidConnection = isValidConnection;
+exports.renamedOutputHandle = renamedOutputHandle;
+exports.soleEdgeToHandle = soleEdgeToHandle;
+//# sourceMappingURL=connectionRules.js.map

package/dist/components/Workflow/connectionRules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectionRules.js","sources":["../../../src/components/Workflow/connectionRules.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/components/Workflow/connectionRules.mjs

@@ -0,0 +1,145 @@
+"use client";
+/**
+ * Validates a proposed connection against node-type handle declarations and the
+ * optional `canConnect` rules of both endpoints. Shared by the canvas
+ * `isValidConnection`, manual `onConnect`, edge reconnect, and palette
+ * auto-connect so every path enforces the same constraints:
+ *  - no self-connections,
+ *  - the source must expose an output handle (Start/Agent/etc., never End),
+ *  - the target must expose an input handle (End/Agent/etc., never Start),
+ *  - a named `sourceHandle`/`targetHandle` must be a declared handle id,
+ *  - connections run exit→entry only: the `sourceHandle` must be an output of
+ *    the source and the `targetHandle` an input of the target — never the
+ *    reverse (no exit→exit / entry→entry wiring),
+ *  - any node-type `canConnect` hook on either endpoint must return `true`.
+ */
+function isValidConnection(connection, graph, getNodeType) {
+    if (!connection.source || !connection.target)
+        return false;
+    if (connection.source === connection.target)
+        return false;
+    const source = graph.nodes.find((n) => n.id === connection.source);
+    const target = graph.nodes.find((n) => n.id === connection.target);
+    if (!source || !target)
+        return false;
+    const sourceDef = getNodeType(source.kind);
+    const targetDef = getNodeType(target.kind);
+    if (!sourceDef || !targetDef)
+        return false;
+    const sourceHandles = sourceDef.handles(source.config);
+    const targetHandles = targetDef.handles(target.config);
+    const sourceOutputs = sourceHandles.outputs;
+    const targetInputs = targetHandles.inputs;
+    // Source must be able to emit and target must be able to receive.
+    if (sourceOutputs.length === 0)
+        return false;
+    if (targetInputs.length === 0)
+        return false;
+    // A requested named handle must actually exist on the node.
+    if (connection.sourceHandle &&
+        !sourceOutputs.some((h) => h.id === connection.sourceHandle)) {
+        return false;
+    }
+    if (connection.targetHandle &&
+        !targetInputs.some((h) => h.id === connection.targetHandle)) {
+        return false;
+    }
+    // Exit→entry only. React Flow's strict connection mode already blocks
+    // output↔output (exit→exit) and input↔input drags, but enforce it here too so
+    // every path — manual connect, reconnect, programmatic edges — agrees: reject
+    // a `sourceHandle` that is actually an input of the source, or a `targetHandle`
+    // that is actually an output of the target.
+    if (connection.sourceHandle &&
+        sourceHandles.inputs.some((h) => h.id === connection.sourceHandle)) {
+        return false;
+    }
+    if (connection.targetHandle &&
+        targetHandles.outputs.some((h) => h.id === connection.targetHandle)) {
+        return false;
+    }
+    const ctx = {
+        source,
+        sourceHandle: connection.sourceHandle ?? undefined,
+        target,
+        targetHandle: connection.targetHandle ?? undefined,
+        graph,
+    };
+    for (const def of [sourceDef, targetDef]) {
+        if (def.canConnect && def.canConnect(ctx) !== true)
+            return false;
+    }
+    return true;
+}
+/**
+ * Resolves a possibly-omitted handle id to the port it actually attaches to.
+ * Edges loaded from the backend / fixtures may omit the handle id for a node's
+ * default port, while the canvas renders every port with a concrete id (see
+ * `NodeShell`). React Flow attaches a handle-less edge to the node's first port
+ * of that type, so `undefined` and that first id denote the same port — collapse
+ * them before comparing or the lookup misses the edge (and we'd duplicate it).
+ */
+function resolveHandle(handle, ports) {
+    return handle ?? ports[0]?.id;
+}
+/**
+ * The existing outbound edge from a node's given handle, if any. Each exit
+ * point holds at most one edge: a single-output node is "taken" once it has any
+ * outbound edge; named handles (classify categories, if/else branches,
+ * guardrail pass/fail) are tracked individually by their `sourceHandle` id.
+ *
+ * Used by the canvas to decide whether a fresh drag from an exit should create
+ * a new edge or MOVE the one already there.
+ */
+function existingEdgeFromHandle(graph, getNodeType, source, sourceHandle) {
+    const node = graph.nodes.find((n) => n.id === source);
+    const outputs = node
+        ? (getNodeType(node.kind)?.handles(node.config).outputs ?? [])
+        : [];
+    const want = resolveHandle(sourceHandle, outputs);
+    return graph.edges.find((e) => e.source === source &&
+        resolveHandle(e.sourceHandle ?? undefined, outputs) === want);
+}
+/**
+ * The sole inbound edge to a node's given input handle, or `undefined` when the
+ * handle has zero or more than one. Unlike exits (one edge each), entries allow
+ * fan-in: several sources can converge on one input. So "grab the existing edge
+ * and re-route it" is only unambiguous when exactly one edge points at the
+ * handle — with two or more there's no single edge to grab, and the drag should
+ * fall back to adding another fan-in edge.
+ *
+ * Used by the canvas to decide whether a drag that *starts* from an occupied
+ * entry should move that edge's source endpoint instead of creating a new edge.
+ */
+function soleEdgeToHandle(graph, getNodeType, target, targetHandle) {
+    const node = graph.nodes.find((n) => n.id === target);
+    const inputs = node
+        ? (getNodeType(node.kind)?.handles(node.config).inputs ?? [])
+        : [];
+    const want = resolveHandle(targetHandle, inputs);
+    const inbound = graph.edges.filter((e) => e.target === target &&
+        resolveHandle(e.targetHandle ?? undefined, inputs) === want);
+    return inbound.length === 1 ? inbound[0] : undefined;
+}
+/**
+ * Detects a single output-handle id rename between two configs of the same
+ * node, so the edge on that handle can move with it instead of being orphaned.
+ * Handle ids that derive from mutable config (Classify's `cat_<name>`) change
+ * when the author edits a name; diffing the declared outputs yields the rename.
+ *
+ * Returns the pair only for an unambiguous 1:1 rename — a pure add or remove
+ * (which the per-field drawer does one at a time) yields `undefined`, leaving
+ * edges to their normal add/prune behaviour.
+ */
+function renamedOutputHandle(handles, oldConfig, newConfig) {
+    const oldIds = handles(oldConfig).outputs.map((h) => h.id);
+    const newIds = handles(newConfig).outputs.map((h) => h.id);
+    const removed = oldIds.filter((id) => !newIds.includes(id));
+    const added = newIds.filter((id) => !oldIds.includes(id));
+    if (removed.length === 1 && added.length === 1) {
+        return { from: removed[0], to: added[0] };
+    }
+    return undefined;
+}
+
+export { existingEdgeFromHandle, isValidConnection, renamedOutputHandle, soleEdgeToHandle };
+//# sourceMappingURL=connectionRules.mjs.map

package/dist/components/Workflow/connectionRules.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectionRules.mjs","sources":["../../../src/components/Workflow/connectionRules.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/components/Workflow/createNode.d.ts

@@ -0,0 +1,27 @@
+import type { GraphNode } from './Workflow.types';
+/**
+ * Unique id for edges and other internal graph elements that aren't referenced
+ * by name in user content. Node IDs use `nextNodeId` for memorable
+ * `{kind}_{N}` ids instead.
+ */
+export declare function genId(prefix: string): string;
+/**
+ * Next sequential id for a node of the given kind, given the current node
+ * list. Returns ids like `agent_1`, `classify_2`, `guardrail_1`, etc., so
+ * authors can type them verbatim into `{{...}}` references.
+ *
+ * Start is a singleton — always `start`. Existing seeded graphs use hand-named
+ * ids like `agent_main` / `guard_out`; those don't match the `kind_<digits>`
+ * pattern and are ignored when computing the next number, so a fresh `agent`
+ * dropped next to `agent_main` becomes `agent_1`, not `agent_2`.
+ */
+export declare function nextNodeId(kind: string, nodes: ReadonlyArray<GraphNode>): string;
+/**
+ * A copy of `node` with a fresh sequential id, a deep-cloned config, and a
+ * slight offset. Pass the current node list so the duplicate's id continues
+ * the per-kind counter. If two duplicates race within the same React batch
+ * the second collides and the reducer's existing `addNode` dedupe drops it
+ * — one missing duplicate, no corrupt state.
+ */
+export declare function cloneNode(node: GraphNode, nodes: ReadonlyArray<GraphNode>): GraphNode;
+//# sourceMappingURL=createNode.d.ts.map

package/dist/components/Workflow/createNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createNode.d.ts","sourceRoot":"","sources":["../../../src/components/Workflow/createNode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAO5C;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,GAC9B,MAAM,CAYR;AAKD;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,GAC9B,SAAS,CAUX"}