@flowdrop/flowdrop 1.15.0 → 2.0.0-beta.2

package/README.md

@@ -50,7 +50,7 @@ No vendor lock-in. No data leaving your walls. No surprise bills.
 npm install @flowdrop/flowdrop
 ```
 
-> **Note:** FlowDrop supports **one editor instance per page** (module-level singleton stores). See [Architecture Notes](#architecture-notes) for details.
+> **Note:** FlowDrop supports **multiple editor instances per page** — each mount gets its own isolated state container. See [Architecture Notes](#architecture-notes) for details.
 
 You get a production-ready workflow UI. You keep full control of everything else.
 
@@ -58,11 +58,11 @@ You get a production-ready workflow UI. You keep full control of everything else
 
 ```svelte
 <script lang="ts">
-  import { WorkflowEditor } from '@flowdrop/flowdrop';
+  import { App } from '@flowdrop/flowdrop';
   import '@flowdrop/flowdrop/styles/base.css';
 </script>
 
-<WorkflowEditor />
+<App />
 ```
 
 **5 lines. One fully-functional workflow editor.**
@@ -80,7 +80,7 @@ You get a production-ready workflow UI. You keep full control of everything else
 
 ## Architecture Notes
 
-- **Single instance per page.** FlowDrop uses module-level singleton stores for state management. Only one FlowDrop editor instance can exist on a page at a time.
+- **Multiple instances per page.** Each mount gets its own `FlowDropInstance` state container (workflow, undo/redo history, playground sessions, registries, API context, drafts), so editors on the same page are fully isolated. In 2.0 there are no module-level store APIs — resolve state with `getInstance()` inside the component tree or the mount handle's `.instance` outside it. The first mount without an `instanceId` becomes the page-default instance; pass `instanceId` to additional mounts to scope their draft/panel storage keys. Theme and settings remain page-global by design.
 - **Svelte 5 required.** FlowDrop uses Svelte 5 runes (`$state`, `$derived`, `$effect`) throughout. Svelte 4 is not supported.
 - **Modern browsers only.** The library targets ES2020+ and does not include polyfills for older browsers.
 
@@ -112,12 +112,12 @@ FlowDrop includes a theme system with built-in light/dark support:
 
 ```svelte
 <script lang="ts">
-  import { WorkflowEditor } from '@flowdrop/flowdrop';
+  import { App } from '@flowdrop/flowdrop';
   import '@flowdrop/flowdrop/styles';
 </script>
 
 <!-- Built-in themes: 'default' or 'minimal' -->
-<WorkflowEditor theme="minimal" />
+<App theme="minimal" />
 ```
 
 Themes bundle a visual skin (CSS token palette) with behavioral UI defaults. You can also pass a custom theme object with your own skin tokens for full control over the light and dark palettes.
@@ -136,7 +136,7 @@ const app = await mountFlowDropApp(container, {
 Every user-facing string flows through a typed `Messages` tree. Pass a callback to override any subset:
 
 ```svelte
-<FlowDrop messages={() => ({ form: { schema: { save: 'Apply' } } })} />
+<App messages={() => ({ form: { schema: { save: 'Apply' } } })} />
 ```
 
 Wire the callback to your i18n library (paraglide-js, sveltekit-i18n, etc.) — locale changes propagate automatically. See the [i18n & Custom Messages guide](https://docs.flowdrop.io/guides/i18n) for the full shape and a paraglide-js worked example.
@@ -145,20 +145,20 @@ Wire the callback to your i18n library (paraglide-js, sveltekit-i18n, etc.) —
 
 FlowDrop provides tree-shakeable sub-module exports so you can import only what you need:
 
-| Export Path                        | Contents                                           |
-| ---------------------------------- | -------------------------------------------------- |
-| `@flowdrop/flowdrop`               | Full library (components, stores, services, types) |
-| `@flowdrop/flowdrop/core`          | Types and utilities only (no heavy dependencies)   |
-| `@flowdrop/flowdrop/editor`        | WorkflowEditor, stores, services                   |
-| `@flowdrop/flowdrop/form`          | SchemaForm, form fields, registry                  |
-| `@flowdrop/flowdrop/form/code`     | Code editor field (CodeMirror)                     |
-| `@flowdrop/flowdrop/form/markdown` | Markdown editor field                              |
-| `@flowdrop/flowdrop/display`       | MarkdownDisplay component                          |
-| `@flowdrop/flowdrop/playground`    | Playground components and services                 |
-| `@flowdrop/flowdrop/settings`      | SettingsPanel, stores, services                    |
-| `@flowdrop/flowdrop/styles`        | Base CSS stylesheet                                |
-| `@flowdrop/flowdrop/schema`        | Workflow JSON schema                               |
-| `@flowdrop/flowdrop/openapi`       | OpenAPI spec (YAML) for the FlowDrop backend API   |
+| Export Path                        | Contents                                                                                                               |
+| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `@flowdrop/flowdrop`               | Slim front door: `App`, mount functions, `createFlowDropInstance`, `getInstance`, auth providers, core bootstrap types |
+| `@flowdrop/flowdrop/core`          | Types and utilities only (no heavy dependencies)                                                                       |
+| `@flowdrop/flowdrop/editor`        | WorkflowEditor, stores, services                                                                                       |
+| `@flowdrop/flowdrop/form`          | SchemaForm, form fields, registry                                                                                      |
+| `@flowdrop/flowdrop/form/code`     | Code editor field (CodeMirror)                                                                                         |
+| `@flowdrop/flowdrop/form/markdown` | Markdown editor field                                                                                                  |
+| `@flowdrop/flowdrop/display`       | MarkdownDisplay component                                                                                              |
+| `@flowdrop/flowdrop/playground`    | Playground components and services                                                                                     |
+| `@flowdrop/flowdrop/settings`      | SettingsPanel, stores, services                                                                                        |
+| `@flowdrop/flowdrop/styles`        | Base CSS stylesheet                                                                                                    |
+| `@flowdrop/flowdrop/schema`        | Workflow JSON schema                                                                                                   |
+| `@flowdrop/flowdrop/openapi`       | OpenAPI spec (YAML) for the FlowDrop backend API                                                                       |
 
 ### OpenAPI spec
 
@@ -170,12 +170,12 @@ The full OpenAPI spec for the FlowDrop backend API ships with the package, versi
 
 ```svelte
 <script>
-  import { WorkflowEditor, NodeSidebar } from '@flowdrop/flowdrop';
+  import { WorkflowEditor, NodeSidebar } from '@flowdrop/flowdrop/editor';
 </script>
 
 <div class="flex h-screen">
   <NodeSidebar {nodes} />
-  <WorkflowEditor {nodes} />
+  <WorkflowEditor />
 </div>
 ```
 

package/dist/adapters/WorkflowAdapter.d.ts

@@ -50,7 +50,7 @@ export interface StandardWorkflow {
     nodes: StandardNode[];
     edges: StandardEdge[];
     metadata?: {
-        version: string;
+        schemaVersion: string;
         createdAt: string;
         updatedAt: string;
         author?: string;

package/dist/adapters/WorkflowAdapter.js

@@ -13,6 +13,7 @@
  * - External applications that want to integrate with FlowDrop
  * - Systems that need to generate or modify workflows programmatically
  */
+import { WORKFLOW_SCHEMA_VERSION } from '../schemas/index.js';
 import { v4 as uuidv4 } from 'uuid';
 import { generateNodeId } from '../utils/nodeIds.js';
 /**
@@ -35,7 +36,7 @@ export class WorkflowAdapter {
             nodes: [],
             edges: [],
             metadata: {
-                version: '1.0.0',
+                schemaVersion: '1.0.0',
                 createdAt: new Date().toISOString(),
                 updatedAt: new Date().toISOString()
             }
@@ -222,13 +223,14 @@ export class WorkflowAdapter {
             if (!validation.valid) {
                 throw new Error(`Invalid workflow: ${validation.errors.join(', ')}`);
             }
-            // Update metadata
+            // Update metadata — heal legacy 1.x `version` key into `schemaVersion`.
+            const incoming = workflow.metadata;
             workflow.metadata = {
-                version: workflow.metadata?.version || '1.0.0',
-                createdAt: workflow.metadata?.createdAt || new Date().toISOString(),
+                schemaVersion: incoming?.schemaVersion || incoming?.version || '1.0.0',
+                createdAt: incoming?.createdAt || new Date().toISOString(),
                 updatedAt: new Date().toISOString(),
-                author: workflow.metadata?.author,
-                tags: workflow.metadata?.tags
+                author: incoming?.author,
+                tags: incoming?.tags
             };
             return workflow;
         }
@@ -291,7 +293,11 @@ export class WorkflowAdapter {
                 sourceHandle: edge.sourceHandle,
                 targetHandle: edge.targetHandle
             })),
-            metadata: workflow.metadata
+            metadata: workflow.metadata ?? {
+                schemaVersion: WORKFLOW_SCHEMA_VERSION,
+                createdAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString()
+            }
         };
     }
     /**
@@ -337,7 +343,7 @@ export class WorkflowAdapter {
         cloned.id = uuidv4();
         cloned.name = newName || `${workflow.name} (Copy)`;
         cloned.metadata = {
-            version: cloned.metadata?.version || '1.0.0',
+            schemaVersion: cloned.metadata?.schemaVersion || '1.0.0',
             createdAt: new Date().toISOString(),
             updatedAt: new Date().toISOString(),
             author: cloned.metadata?.author,

package/dist/adapters/agentspec/AgentSpecAdapter.js

@@ -13,7 +13,7 @@ import { getComponentTypeDefaults, extractComponentType, AGENTSPEC_NAMESPACE } f
 import { computeAutoLayout } from './autoLayout.js';
 import { v4 as uuidv4 } from 'uuid';
 import { logger } from '../../utils/logger.js';
-import { buildHandleId, extractPortId, extractDirection } from '../../utils/handleIds.js';
+import { buildHandleId, extractPortId } from '../../utils/handleIds.js';
 // ============================================================================
 // Property ↔ Port Conversion
 // ============================================================================
@@ -138,7 +138,7 @@ export class AgentSpecAdapter {
             }
         }
         // Find start node
-        const startNodeName = this.findStartNodeName(agentSpecNodes, nodeIdToName);
+        const startNodeName = this.findStartNodeName(agentSpecNodes);
         return {
             component_type: 'flow',
             name: workflow.name,
@@ -149,7 +149,7 @@ export class AgentSpecAdapter {
             data_flow_connections: dataFlowEdges.length > 0 ? dataFlowEdges : null,
             metadata: {
                 'flowdrop:workflow_id': workflow.id,
-                'flowdrop:version': workflow.metadata?.version,
+                'flowdrop:version': workflow.metadata?.schemaVersion,
                 ...(workflow.metadata?.author ? { 'flowdrop:author': workflow.metadata.author } : {}),
                 ...(workflow.metadata?.tags ? { 'flowdrop:tags': workflow.metadata.tags } : {})
             }
@@ -196,7 +196,7 @@ export class AgentSpecAdapter {
         const edges = [];
         // Control-flow edges → trigger port connections
         for (const cfEdge of agentSpecFlow.control_flow_connections) {
-            const edge = this.convertFromControlFlowEdge(cfEdge, nameToNodeId, nodes);
+            const edge = this.convertFromControlFlowEdge(cfEdge, nameToNodeId);
             if (edge)
                 edges.push(edge);
         }
@@ -215,7 +215,7 @@ export class AgentSpecAdapter {
             nodes,
             edges,
             metadata: {
-                version: agentSpecFlow.metadata?.['flowdrop:version'] || '1.0.0',
+                schemaVersion: agentSpecFlow.metadata?.['flowdrop:version'] || '1.0.0',
                 createdAt: new Date().toISOString(),
                 updatedAt: new Date().toISOString(),
                 author: agentSpecFlow.metadata?.['flowdrop:author'],
@@ -578,7 +578,7 @@ export class AgentSpecAdapter {
     /**
      * Convert an Agent Spec ControlFlowEdge to a FlowDrop edge.
      */
-    convertFromControlFlowEdge(cfEdge, nameToNodeId, nodes) {
+    convertFromControlFlowEdge(cfEdge, nameToNodeId) {
         const sourceId = nameToNodeId.get(cfEdge.from_node);
         const targetId = nameToNodeId.get(cfEdge.to_node);
         if (!sourceId || !targetId)
@@ -615,7 +615,7 @@ export class AgentSpecAdapter {
     /**
      * Find the start node name from converted Agent Spec nodes.
      */
-    findStartNodeName(nodes, nodeIdToName) {
+    findStartNodeName(nodes) {
         // Look for an explicit start_node
         const startNode = nodes.find((n) => n.component_type === 'start_node');
         if (startNode)

package/dist/api/enhanced-client.js

@@ -5,7 +5,7 @@
  *
  * @module api/enhanced-client
  */
-import { buildEndpointUrl, getEndpointMethod, getEndpointHeaders } from '../config/endpoints.js';
+import { buildEndpointUrl, getEndpointMethod, getRequestHeaders } from '../config/endpoints.js';
 import { NoAuthProvider } from '../types/auth.js';
 import { getApiSettings } from '../stores/settingsStore.svelte.js';
 import { logger } from '../utils/logger.js';
@@ -56,15 +56,12 @@ export class EnhancedFlowDropApiClient {
     async request(endpointKey, endpointPath, params, options = {}, operation = 'API request') {
         const url = buildEndpointUrl(this.config, endpointPath, params);
         const method = options.method ?? getEndpointMethod(this.config, endpointKey);
-        const configHeaders = getEndpointHeaders(this.config, endpointKey);
         // Get user settings for timeout and retry
         const userApiSettings = getApiSettings();
-        // Get auth headers from provider
-        const authHeaders = await this.authProvider.getAuthHeaders();
-        // Merge headers: config headers < auth headers < request-specific headers
+        // Merge headers via the shared path: static endpoint headers < auth headers
+        // < request-specific headers.
         const headers = {
-            ...configHeaders,
-            ...authHeaders,
+            ...(await getRequestHeaders(this.config, endpointKey, this.authProvider)),
             ...options.headers
         };
         // Create AbortController for timeout
@@ -93,11 +90,9 @@ export class EnhancedFlowDropApiClient {
                     if (this.authProvider.onUnauthorized) {
                         const refreshed = await this.authProvider.onUnauthorized();
                         if (refreshed && attempt < maxAttempts) {
-                            // Get new auth headers and retry
-                            const newAuthHeaders = await this.authProvider.getAuthHeaders();
+                            // Rebuild headers via the shared path to pick up the fresh token.
                             fetchConfig.headers = {
-                                ...configHeaders,
-                                ...newAuthHeaders,
+                                ...(await getRequestHeaders(this.config, endpointKey, this.authProvider)),
                                 ...options.headers
                             };
                             continue; // Retry with new headers

package/dist/chat/batchFeedback.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Batch retry feedback for the AI Assistant.
+ *
+ * When a batch of DSL commands finishes with failures — some couldn't be
+ * parsed, or one failed to execute and the batch rolled back — the assistant
+ * needs concrete, specific feedback to self-correct. This module builds that
+ * message.
+ *
+ * Specificity is the point: the parse-error feedback names the offending text
+ * and the exact parser reason. The old generic "provide corrected commands"
+ * ask is what made auto-retry on parse errors loop on the same malformed shape
+ * — so it was disabled. Pinpointing the failure makes re-enabling it safe.
+ *
+ * @module chat/batchFeedback
+ */
+/** A command that could not be parsed, with the reason and its raw text. */
+export interface ParseFailure {
+    raw: string;
+    error: string;
+}
+/** Summary of how a batch finished, used to build retry feedback. */
+export interface BatchOutcome {
+    /** Number of commands that executed successfully before stopping. */
+    completedCount: number;
+    /** Error from the first command that failed to execute, if any. */
+    executionError?: string;
+    /** Whether the executed commands were rolled back (atomic execution failure). */
+    rolledBack: boolean;
+    /** Commands that could not be parsed and were skipped. */
+    parseErrors: ParseFailure[];
+}
+/**
+ * Build feedback for the assistant after a batch finished with failures.
+ *
+ * Pinpoints *what* went wrong — the specific parser error and offending text
+ * for unparseable commands, and/or the execution error — so the assistant has
+ * a concrete, different target to correct.
+ */
+export declare function buildRetryFeedback(outcome: BatchOutcome): string;

package/dist/chat/batchFeedback.js

@@ -0,0 +1,51 @@
+/**
+ * Batch retry feedback for the AI Assistant.
+ *
+ * When a batch of DSL commands finishes with failures — some couldn't be
+ * parsed, or one failed to execute and the batch rolled back — the assistant
+ * needs concrete, specific feedback to self-correct. This module builds that
+ * message.
+ *
+ * Specificity is the point: the parse-error feedback names the offending text
+ * and the exact parser reason. The old generic "provide corrected commands"
+ * ask is what made auto-retry on parse errors loop on the same malformed shape
+ * — so it was disabled. Pinpointing the failure makes re-enabling it safe.
+ *
+ * @module chat/batchFeedback
+ */
+/**
+ * Build feedback for the assistant after a batch finished with failures.
+ *
+ * Pinpoints *what* went wrong — the specific parser error and offending text
+ * for unparseable commands, and/or the execution error — so the assistant has
+ * a concrete, different target to correct.
+ */
+export function buildRetryFeedback(outcome) {
+    const { completedCount, executionError, rolledBack, parseErrors } = outcome;
+    const lines = [];
+    if (executionError) {
+        lines.push(`A command failed to execute: ${executionError}`);
+        lines.push(rolledBack && completedCount > 0
+            ? `The ${completedCount} command(s) that had succeeded were rolled back, so no changes were applied.`
+            : 'No changes were applied.');
+    }
+    else if (completedCount > 0) {
+        lines.push(`${completedCount} command(s) were applied successfully.`);
+    }
+    if (parseErrors.length > 0) {
+        lines.push(`\n${parseErrors.length} command(s) could not be parsed and were skipped:`);
+        for (const pe of parseErrors) {
+            const firstLine = pe.raw.split('\n')[0];
+            const preview = pe.raw.includes('\n') ? `${firstLine} …` : firstLine;
+            lines.push(`  • ${preview}\n    reason: ${pe.error}`);
+        }
+        lines.push('\nNote: multiline values must close with """ on its own line.');
+    }
+    if (rolledBack) {
+        lines.push('\nPlease re-send the full corrected batch to achieve the original goal.');
+    }
+    else {
+        lines.push('\nThe successful changes are reflected in the current workflow state. Re-send only corrected versions of the skipped command(s).');
+    }
+    return lines.join('\n');
+}

package/dist/commands/executor.js

@@ -888,17 +888,31 @@ function executeSwapNode(command, context) {
             edges: swapResult.updatedEdges
         });
     }
+    // Name each dropped edge so the user can see exactly what was lost
+    const droppedEdgeDetails = preview.droppedEdges.map(({ edge }) => {
+        const sourcePort = extractPortId(edge.sourceHandle ?? undefined) ?? '?';
+        const targetPort = extractPortId(edge.targetHandle ?? undefined) ?? '?';
+        return `${toShortId(edge.source)}:${sourcePort} → ${toShortId(edge.target)}:${targetPort}`;
+    });
     const resultData = {
         oldNodeId: toShortId(node.id),
         newNodeId: toShortId(preview.newNodeId),
         newType: command.newTypeId,
         keptEdges: preview.keptEdges.length,
         droppedEdges: preview.droppedEdges.length,
+        droppedEdgeDetails,
         hasDataLoss: preview.hasDataLoss,
         configCarriedOver: preview.configCarriedOver,
         configReset: preview.configReset
     };
-    const droppedMsg = preview.droppedEdges.length > 0 ? ` (${preview.droppedEdges.length} edge(s) dropped)` : '';
+    // Cap the inline list — a badly mismatched swap can drop dozens of edges,
+    // and the full list is always available in resultData.droppedEdgeDetails
+    const MAX_NAMED_DROPPED_EDGES = 5;
+    const namedDropped = droppedEdgeDetails.slice(0, MAX_NAMED_DROPPED_EDGES);
+    const unnamedCount = droppedEdgeDetails.length - namedDropped.length;
+    const droppedMsg = preview.droppedEdges.length > 0
+        ? ` (${preview.droppedEdges.length} edge(s) dropped: ${namedDropped.join(', ')}${unnamedCount > 0 ? `, … and ${unnamedCount} more` : ''})`
+        : '';
     return {
         ok: true,
         message: `Swapped ${toShortId(node.id)} → ${toShortId(preview.newNodeId)} (${command.newTypeId})${droppedMsg}`,

package/dist/commands/storeIntegration.svelte.d.ts

@@ -4,6 +4,7 @@
  * Bridges the command system to the live Svelte stores.
  * This is the only Svelte-coupled file in commands/.
  */
+import { type FlowDropInstance } from '../stores/instanceContainer.svelte.js';
 import { type CommandContext, type UIAction } from './types.js';
 import type { NodeMetadata } from '../types/index.js';
 /**
@@ -11,6 +12,8 @@ import type { NodeMetadata } from '../types/index.js';
  *
  * @param nodeTypes - Available node type definitions
  * @param onUIAction - Optional callback for UI-side actions (open config panel, select node)
+ * @param instance - The FlowDrop instance to operate on; defaults to the
+ *   page-default instance when omitted
  * @returns CommandContext connected to live stores, or null if no workflow is loaded
  */
-export declare function createStoreCommandContext(nodeTypes: NodeMetadata[], onUIAction?: (action: UIAction) => void): CommandContext | null;
+export declare function createStoreCommandContext(nodeTypes: NodeMetadata[], onUIAction?: (action: UIAction) => void, instance?: FlowDropInstance): CommandContext | null;

package/dist/commands/storeIntegration.svelte.js

@@ -4,62 +4,67 @@
  * Bridges the command system to the live Svelte stores.
  * This is the only Svelte-coupled file in commands/.
  */
-import { getWorkflowStore, workflowActions } from '../stores/workflowStore.svelte.js';
-import { historyService } from '../services/historyService.js';
+import { getDefaultInstance } from '../stores/instanceContainer.svelte.js';
 import { buildTypeMap } from './types.js';
 /**
  * Creates a CommandContext that bridges the command system to the live Svelte stores.
  *
  * @param nodeTypes - Available node type definitions
  * @param onUIAction - Optional callback for UI-side actions (open config panel, select node)
+ * @param instance - The FlowDrop instance to operate on; defaults to the
+ *   page-default instance when omitted
  * @returns CommandContext connected to live stores, or null if no workflow is loaded
  */
-export function createStoreCommandContext(nodeTypes, onUIAction) {
-    const workflow = getWorkflowStore();
+export function createStoreCommandContext(nodeTypes, onUIAction, instance) {
+    const fd = instance ?? getDefaultInstance();
+    const readWorkflow = () => fd.workflow.current;
+    const actions = fd.workflow.actions;
+    const history = fd.history;
+    const workflow = readWorkflow();
     if (!workflow) {
         return null;
     }
     const dispatch = {
-        addNode: (node) => workflowActions.addNode(node),
-        removeNode: (nodeId) => workflowActions.removeNode(nodeId),
-        updateNode: (nodeId, updates) => workflowActions.updateNode(nodeId, updates),
-        addEdge: (edge) => workflowActions.addEdge(edge),
-        removeEdge: (edgeId) => workflowActions.removeEdge(edgeId),
-        batchUpdate: (updates) => workflowActions.batchUpdate(updates),
+        addNode: (node) => actions.addNode(node),
+        removeNode: (nodeId) => actions.removeNode(nodeId),
+        updateNode: (nodeId, updates) => actions.updateNode(nodeId, updates),
+        addEdge: (edge) => actions.addEdge(edge),
+        removeEdge: (edgeId) => actions.removeEdge(edgeId),
+        batchUpdate: (updates) => actions.batchUpdate(updates),
         undo: () => {
-            const previousState = historyService.undo();
+            const previousState = history.undo();
             if (previousState) {
-                workflowActions.restoreFromHistory(previousState);
+                actions.restoreFromHistory(previousState);
                 return true;
             }
             return false;
         },
         redo: () => {
-            const nextState = historyService.redo();
+            const nextState = history.redo();
             if (nextState) {
-                workflowActions.restoreFromHistory(nextState);
+                actions.restoreFromHistory(nextState);
                 return true;
             }
             return false;
         },
         startTransaction: (description) => {
-            const currentWorkflow = getWorkflowStore();
+            const currentWorkflow = readWorkflow();
             if (currentWorkflow) {
-                historyService.startTransaction(currentWorkflow, description);
+                history.startTransaction(currentWorkflow, description);
             }
         },
-        commitTransaction: () => historyService.commitTransaction(),
+        commitTransaction: () => history.commitTransaction(),
         cancelTransaction: () => {
-            const snapshot = historyService.cancelTransaction();
+            const snapshot = history.cancelTransaction();
             if (snapshot) {
-                workflowActions.restoreFromHistory(snapshot);
+                actions.restoreFromHistory(snapshot);
             }
         },
         emitUIAction: onUIAction,
-        swapNode: (updates) => workflowActions.swapNode(updates)
+        swapNode: (updates) => actions.swapNode(updates)
     };
     return {
-        getWorkflow: () => getWorkflowStore(),
+        getWorkflow: () => readWorkflow(),
         nodeTypes,
         typeMap: buildTypeMap(nodeTypes),
         dispatch

package/dist/commands/types.d.ts

@@ -244,6 +244,8 @@ export interface SwapNodeResultData {
     newType: string;
     keptEdges: number;
     droppedEdges: number;
+    /** Human-readable descriptions of each dropped edge, e.g. "node.1:text → node.2:message" */
+    droppedEdgeDetails: string[];
     hasDataLoss: boolean;
     configCarriedOver: string[];
     configReset: string[];