@flowdrop/flowdrop 2.10.1 → 2.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (571) hide show
  1. package/CHANGELOG.md +385 -0
  2. package/dist/adapters/agentspec/autoLayout.d.ts +18 -36
  3. package/dist/adapters/agentspec/autoLayout.js +75 -93
  4. package/dist/chat/activity.d.ts +49 -0
  5. package/dist/chat/activity.js +65 -0
  6. package/dist/chat/commandClassifier.js +2 -1
  7. package/dist/commands/executor.js +186 -27
  8. package/dist/commands/index.d.ts +2 -1
  9. package/dist/commands/index.js +2 -0
  10. package/dist/commands/parser.js +43 -3
  11. package/dist/commands/session.d.ts +60 -0
  12. package/dist/commands/session.js +332 -0
  13. package/dist/commands/storeIntegration.svelte.js +18 -1
  14. package/dist/commands/types.d.ts +77 -4
  15. package/dist/components/App.svelte +1030 -207
  16. package/dist/components/App.svelte.d.ts +26 -2
  17. package/dist/components/BindablePortListbox.svelte +68 -369
  18. package/dist/components/Button.svelte +17 -14
  19. package/dist/components/Button.svelte.d.ts +2 -2
  20. package/dist/components/CanvasContextMenu.svelte +31 -10
  21. package/dist/components/CanvasController.svelte +146 -3
  22. package/dist/components/CanvasController.svelte.d.ts +25 -33
  23. package/dist/components/CanvasIconButton.svelte +6 -6
  24. package/dist/components/CanvasToolbar.svelte +103 -0
  25. package/dist/components/CanvasToolbar.svelte.d.ts +23 -0
  26. package/dist/components/CanvasZoomControls.svelte +122 -0
  27. package/dist/components/CanvasZoomControls.svelte.d.ts +15 -0
  28. package/dist/components/ConfigForm.svelte +163 -125
  29. package/dist/components/ConfigModal.svelte +13 -56
  30. package/dist/components/ConfigModal.svelte.d.ts +1 -1
  31. package/dist/components/ConfigPanel.svelte +98 -228
  32. package/dist/components/ConfigPanel.svelte.d.ts +2 -2
  33. package/dist/components/ConnectPortPicker.svelte +153 -0
  34. package/dist/components/ConnectPortPicker.svelte.d.ts +22 -0
  35. package/dist/components/ConnectionLine.svelte +1 -1
  36. package/dist/components/DoctorMenu.svelte +422 -0
  37. package/dist/components/DoctorMenu.svelte.d.ts +7 -0
  38. package/dist/components/ExternalLinkRow.svelte +82 -0
  39. package/dist/components/ExternalLinkRow.svelte.d.ts +14 -0
  40. package/dist/components/FlowDropEdge.svelte +52 -2
  41. package/dist/components/FlowDropEdge.svelte.d.ts +5 -1
  42. package/dist/components/InterfaceNameInput.svelte +103 -0
  43. package/dist/components/InterfaceNameInput.svelte.d.ts +13 -0
  44. package/dist/components/InterfaceTag.svelte +215 -0
  45. package/dist/components/InterfaceTag.svelte.d.ts +20 -0
  46. package/dist/components/InterfaceTagAnchor.svelte +103 -0
  47. package/dist/components/InterfaceTagAnchor.svelte.d.ts +12 -0
  48. package/dist/components/InterfaceTagLayer.svelte +314 -0
  49. package/dist/components/InterfaceTagLayer.svelte.d.ts +28 -0
  50. package/dist/components/LogsSidebar.svelte +58 -55
  51. package/dist/components/LoopbackLanes.svelte +54 -0
  52. package/dist/components/LoopbackLanes.svelte.d.ts +8 -0
  53. package/dist/components/MarkdownDisplay.svelte +1 -1
  54. package/dist/components/Navbar.svelte +539 -169
  55. package/dist/components/Navbar.svelte.d.ts +20 -1
  56. package/dist/components/NodeInspector.svelte +153 -0
  57. package/dist/components/NodeInspector.svelte.d.ts +19 -0
  58. package/dist/components/NodeLastRun.svelte +212 -0
  59. package/dist/components/NodeLastRun.svelte.d.ts +13 -0
  60. package/dist/components/NodeSidebar.svelte +279 -23
  61. package/dist/components/NodeSidebar.svelte.d.ts +11 -0
  62. package/dist/components/NodeStatusOverlay.svelte +144 -353
  63. package/dist/components/NodeStatusOverlay.svelte.d.ts +4 -1
  64. package/dist/components/PipelineStatus.svelte +5 -18
  65. package/dist/components/PortMappingRow.svelte +28 -44
  66. package/dist/components/PortPickerListbox.svelte +475 -0
  67. package/dist/components/PortPickerListbox.svelte.d.ts +73 -0
  68. package/dist/components/ReadOnlyDetails.svelte +52 -89
  69. package/dist/components/RunBar.svelte +222 -0
  70. package/dist/components/RunBar.svelte.d.ts +20 -0
  71. package/dist/components/RunsMenu.svelte +649 -0
  72. package/dist/components/RunsMenu.svelte.d.ts +14 -0
  73. package/dist/components/SchemaForm.svelte +1 -1
  74. package/dist/components/SettingsModal.svelte +28 -60
  75. package/dist/components/SettingsPanel.svelte +516 -242
  76. package/dist/components/StraightGuides.svelte +46 -0
  77. package/dist/components/StraightGuides.svelte.d.ts +7 -0
  78. package/dist/components/ThemeToggle.svelte +14 -4
  79. package/dist/components/UniversalNode.svelte +152 -51
  80. package/dist/components/WebMCPBridgeMenu.svelte +336 -0
  81. package/dist/components/WebMCPBridgeMenu.svelte.d.ts +3 -0
  82. package/dist/components/WorkflowEditor.svelte +821 -142
  83. package/dist/components/WorkflowEditor.svelte.d.ts +43 -1
  84. package/dist/components/WorkflowInterfaceEditor.svelte +106 -100
  85. package/dist/components/WorkflowInterfaceEditor.svelte.d.ts +12 -1
  86. package/dist/components/WorkflowInterfaceEntryCard.svelte +496 -494
  87. package/dist/components/WorkflowInterfaceEntryCard.svelte.d.ts +14 -1
  88. package/dist/components/WorkflowInterfaceEntryComposer.svelte +23 -67
  89. package/dist/components/WorkflowPlaygroundSettings.svelte +514 -0
  90. package/dist/components/WorkflowPlaygroundSettings.svelte.d.ts +20 -0
  91. package/dist/components/WorkflowSettingsPanel.svelte +311 -0
  92. package/dist/components/WorkflowSettingsPanel.svelte.d.ts +20 -0
  93. package/dist/components/ZoomTier.svelte +56 -0
  94. package/dist/components/ZoomTier.svelte.d.ts +4 -0
  95. package/dist/components/chat/AIChatPanel.svelte +464 -313
  96. package/dist/components/chat/ActivityList.svelte +130 -0
  97. package/dist/components/chat/ActivityList.svelte.d.ts +11 -0
  98. package/dist/components/chat/ActivityRow.svelte +179 -0
  99. package/dist/components/chat/ActivityRow.svelte.d.ts +16 -0
  100. package/dist/components/chat/CommandPreview.svelte +42 -64
  101. package/dist/components/console/CommandConsole.svelte +106 -41
  102. package/dist/components/console/CommandConsole.svelte.d.ts +2 -0
  103. package/dist/components/console/ConsoleAutocomplete.svelte +14 -13
  104. package/dist/components/console/ConsoleInput.svelte +60 -27
  105. package/dist/components/console/ConsoleOutput.svelte +86 -24
  106. package/dist/components/console/ConsoleStrip.svelte +80 -0
  107. package/dist/components/console/ConsoleStrip.svelte.d.ts +13 -0
  108. package/dist/components/form/FieldFactory.svelte +30 -4
  109. package/dist/components/form/FormArray.svelte +306 -339
  110. package/dist/components/form/FormArray.svelte.d.ts +10 -0
  111. package/dist/components/form/FormArrayRows.svelte +443 -0
  112. package/dist/components/form/FormArrayRows.svelte.d.ts +18 -0
  113. package/dist/components/form/FormAutocomplete.svelte +2 -2
  114. package/dist/components/form/FormCheckboxGroup.svelte +10 -85
  115. package/dist/components/form/FormCodeEditor.svelte +3 -3
  116. package/dist/components/form/FormFieldWrapper.svelte +98 -18
  117. package/dist/components/form/FormFieldWrapper.svelte.d.ts +10 -0
  118. package/dist/components/form/FormFieldset.svelte +44 -28
  119. package/dist/components/form/FormMarkdownEditor.svelte +6 -6
  120. package/dist/components/form/FormPorts.svelte +437 -141
  121. package/dist/components/form/FormSelect.svelte +1 -1
  122. package/dist/components/form/FormTemplateEditor.svelte +22 -26
  123. package/dist/components/form/FormToggle.svelte +15 -106
  124. package/dist/components/form/FormToggle.svelte.d.ts +3 -2
  125. package/dist/components/form/FormUISchemaRenderer.svelte +38 -3
  126. package/dist/components/form/humanizeKey.d.ts +7 -0
  127. package/dist/components/form/humanizeKey.js +21 -0
  128. package/dist/components/form/index.d.ts +2 -2
  129. package/dist/components/form/index.js +2 -2
  130. package/dist/components/form/types.d.ts +6 -0
  131. package/dist/components/icons/MenuOpenIcon.svelte +8 -1
  132. package/dist/components/interrupt/ChoicePrompt.svelte +51 -152
  133. package/dist/components/interrupt/ChoicePrompt.svelte.d.ts +0 -2
  134. package/dist/components/interrupt/ConfirmationPrompt.svelte +18 -201
  135. package/dist/components/interrupt/ConfirmationPrompt.svelte.d.ts +0 -4
  136. package/dist/components/interrupt/FormPrompt.svelte +22 -147
  137. package/dist/components/interrupt/FormPrompt.svelte.d.ts +0 -4
  138. package/dist/components/interrupt/InterruptBubble.svelte +198 -355
  139. package/dist/components/interrupt/InterruptBubble.svelte.d.ts +0 -2
  140. package/dist/components/interrupt/ReviewPrompt.svelte +0 -10
  141. package/dist/components/interrupt/TextInputPrompt.svelte +23 -120
  142. package/dist/components/interrupt/TextInputPrompt.svelte.d.ts +0 -2
  143. package/dist/components/layouts/MainLayout.svelte +110 -75
  144. package/dist/components/layouts/MainLayout.svelte.d.ts +17 -0
  145. package/dist/components/nodes/CaptionNode.svelte +7 -0
  146. package/dist/components/nodes/GatewayNode.svelte +66 -431
  147. package/dist/components/nodes/IdeaNode.svelte +6 -5
  148. package/dist/components/nodes/NodeCard.svelte +1051 -0
  149. package/dist/components/nodes/NodeCard.svelte.d.ts +30 -0
  150. package/dist/components/nodes/NodeConfigButton.svelte +28 -9
  151. package/dist/components/nodes/NodeProblemMark.svelte +113 -0
  152. package/dist/components/nodes/NodeProblemMark.svelte.d.ts +8 -0
  153. package/dist/components/nodes/NodeTip.svelte +104 -0
  154. package/dist/components/nodes/NodeTip.svelte.d.ts +15 -0
  155. package/dist/components/nodes/NotesNode.svelte +183 -150
  156. package/dist/components/nodes/SimpleNode.svelte +176 -44
  157. package/dist/components/nodes/SquareNode.svelte +127 -34
  158. package/dist/components/nodes/TerminalNode.svelte +232 -88
  159. package/dist/components/nodes/ToolNode.svelte +49 -381
  160. package/dist/components/nodes/WorkflowNode.svelte +40 -399
  161. package/dist/components/playground/ChatBubble.svelte +248 -62
  162. package/dist/components/playground/ChatInput.svelte +134 -297
  163. package/dist/components/playground/ChatInput.svelte.d.ts +17 -0
  164. package/dist/components/playground/ControlPanel.svelte +318 -188
  165. package/dist/components/playground/ControlPanel.svelte.d.ts +13 -0
  166. package/dist/components/playground/DockedPlayground.svelte +75 -0
  167. package/dist/components/playground/DockedPlayground.svelte.d.ts +24 -0
  168. package/dist/components/playground/ExecutionConsole.svelte +54 -36
  169. package/dist/components/playground/ExecutionConsole.svelte.d.ts +12 -0
  170. package/dist/components/playground/ExecutionLogs.svelte +4 -0
  171. package/dist/components/playground/HeaderMenu.svelte +170 -0
  172. package/dist/components/playground/HeaderMenu.svelte.d.ts +22 -0
  173. package/dist/components/playground/InputCollector.svelte +8 -32
  174. package/dist/components/playground/InputFields.svelte +246 -0
  175. package/dist/components/playground/InputFields.svelte.d.ts +16 -0
  176. package/dist/components/playground/InterfaceInputForm.svelte +285 -30
  177. package/dist/components/playground/InterfaceInputForm.svelte.d.ts +20 -0
  178. package/dist/components/playground/InterfaceJsonInput.svelte +92 -0
  179. package/dist/components/playground/InterfaceJsonInput.svelte.d.ts +10 -0
  180. package/dist/components/playground/LogRow.svelte +12 -12
  181. package/dist/components/playground/MessageMarkdown.svelte +11 -11
  182. package/dist/components/playground/MessageStream.svelte +154 -182
  183. package/dist/components/playground/Playground.svelte +17 -1087
  184. package/dist/components/playground/PlaygroundApp.svelte +12 -2
  185. package/dist/components/playground/PlaygroundApp.svelte.d.ts +2 -1
  186. package/dist/components/playground/PlaygroundHeader.svelte +309 -0
  187. package/dist/components/playground/PlaygroundHeader.svelte.d.ts +22 -0
  188. package/dist/components/playground/PlaygroundModal.svelte +7 -1
  189. package/dist/components/playground/PlaygroundStudio.svelte +31 -33
  190. package/dist/components/playground/PlaygroundSurface.svelte +648 -0
  191. package/dist/components/playground/PlaygroundSurface.svelte.d.ts +79 -0
  192. package/dist/components/playground/StepsSummary.svelte +312 -0
  193. package/dist/components/playground/StepsSummary.svelte.d.ts +11 -0
  194. package/dist/components/playground/messageDisplay.d.ts +9 -0
  195. package/dist/components/playground/messageDisplay.js +24 -2
  196. package/dist/components/playground/stepSummary.d.ts +71 -0
  197. package/dist/components/playground/stepSummary.js +152 -0
  198. package/dist/components/ports/PortTypeBadge.svelte +13 -1
  199. package/dist/components/primitives/Button.svelte +226 -0
  200. package/dist/components/primitives/Button.svelte.d.ts +31 -0
  201. package/dist/components/primitives/Card.svelte +110 -0
  202. package/dist/components/primitives/Card.svelte.d.ts +20 -0
  203. package/dist/components/primitives/Checkbox.svelte +126 -0
  204. package/dist/components/primitives/Checkbox.svelte.d.ts +15 -0
  205. package/dist/components/primitives/Chip.svelte +143 -0
  206. package/dist/components/primitives/Chip.svelte.d.ts +22 -0
  207. package/dist/components/primitives/Combobox.svelte +444 -0
  208. package/dist/components/primitives/Combobox.svelte.d.ts +22 -0
  209. package/dist/components/primitives/Composer.svelte +293 -0
  210. package/dist/components/primitives/Composer.svelte.d.ts +47 -0
  211. package/dist/components/primitives/EmptyState.svelte +113 -0
  212. package/dist/components/primitives/EmptyState.svelte.d.ts +18 -0
  213. package/dist/components/primitives/Field.svelte +178 -0
  214. package/dist/components/primitives/Field.svelte.d.ts +30 -0
  215. package/dist/components/primitives/IconButton.svelte +156 -0
  216. package/dist/components/primitives/IconButton.svelte.d.ts +27 -0
  217. package/dist/components/primitives/Menu.svelte +435 -0
  218. package/dist/components/primitives/Menu.svelte.d.ts +61 -0
  219. package/dist/components/primitives/Notice.svelte +161 -0
  220. package/dist/components/primitives/Notice.svelte.d.ts +22 -0
  221. package/dist/components/primitives/PanelHeader.svelte +134 -0
  222. package/dist/components/primitives/PanelHeader.svelte.d.ts +23 -0
  223. package/dist/components/primitives/Segmented.svelte +198 -0
  224. package/dist/components/primitives/Segmented.svelte.d.ts +32 -0
  225. package/dist/components/primitives/Select.svelte +130 -0
  226. package/dist/components/primitives/Select.svelte.d.ts +26 -0
  227. package/dist/components/primitives/StatusPill.svelte +218 -0
  228. package/dist/components/primitives/StatusPill.svelte.d.ts +24 -0
  229. package/dist/components/primitives/Switch.svelte +113 -0
  230. package/dist/components/primitives/Switch.svelte.d.ts +14 -0
  231. package/dist/components/primitives/Tabs.svelte +209 -0
  232. package/dist/components/primitives/Tabs.svelte.d.ts +32 -0
  233. package/dist/components/primitives/Toolbar.svelte +94 -0
  234. package/dist/components/primitives/Toolbar.svelte.d.ts +14 -0
  235. package/dist/components/primitives/ToolbarSeparator.svelte +40 -0
  236. package/dist/components/primitives/ToolbarSeparator.svelte.d.ts +7 -0
  237. package/dist/components/surfaces/SurfaceOverlay.svelte +10 -40
  238. package/dist/components/surfaces/TabbedSurface.svelte +49 -39
  239. package/dist/components/surfaces/TabbedSurface.svelte.d.ts +8 -0
  240. package/dist/components/toast/DismissibleToast.svelte +94 -32
  241. package/dist/components/toast/DismissibleToast.svelte.d.ts +17 -7
  242. package/dist/config/endpoints.d.ts +43 -1
  243. package/dist/config/endpoints.js +21 -3
  244. package/dist/core/index.d.ts +9 -6
  245. package/dist/core/index.js +1 -1
  246. package/dist/editor/connectCandidates.d.ts +56 -0
  247. package/dist/editor/connectCandidates.js +131 -0
  248. package/dist/editor/contextMenu.d.ts +31 -2
  249. package/dist/editor/contextMenu.js +96 -9
  250. package/dist/editor/index.d.ts +3 -1
  251. package/dist/editor/index.js +1 -0
  252. package/dist/editor/interfaceMenu.d.ts +35 -0
  253. package/dist/editor/interfaceMenu.js +47 -0
  254. package/dist/editor/portMenu.d.ts +23 -0
  255. package/dist/editor/portMenu.js +34 -0
  256. package/dist/editor/tidy.d.ts +30 -0
  257. package/dist/editor/tidy.js +66 -0
  258. package/dist/helpers/workflowEditorHelper.d.ts +15 -0
  259. package/dist/helpers/workflowEditorHelper.js +39 -3
  260. package/dist/layout/fromWorkflow.d.ts +42 -0
  261. package/dist/layout/fromWorkflow.js +135 -0
  262. package/dist/layout/geometry.d.ts +102 -0
  263. package/dist/layout/geometry.js +317 -0
  264. package/dist/layout/index.d.ts +21 -0
  265. package/dist/layout/index.js +14 -0
  266. package/dist/layout/inspect.d.ts +18 -0
  267. package/dist/layout/inspect.js +81 -0
  268. package/dist/layout/lanePath.d.ts +23 -0
  269. package/dist/layout/lanePath.js +47 -0
  270. package/dist/layout/measure.d.ts +141 -0
  271. package/dist/layout/measure.js +477 -0
  272. package/dist/layout/primitives.d.ts +124 -0
  273. package/dist/layout/primitives.js +461 -0
  274. package/dist/layout/sweep.d.ts +59 -0
  275. package/dist/layout/sweep.js +257 -0
  276. package/dist/layout/toWorkflow.d.ts +43 -0
  277. package/dist/layout/toWorkflow.js +131 -0
  278. package/dist/layout/types.d.ts +93 -0
  279. package/dist/layout/types.js +35 -0
  280. package/dist/messages/defaults.d.ts +694 -26
  281. package/dist/messages/defaults.js +626 -27
  282. package/dist/messages/types.d.ts +21 -1
  283. package/dist/openapi/v1/openapi.yaml +222 -5
  284. package/dist/playground/index.d.ts +31 -2
  285. package/dist/playground/index.js +31 -1
  286. package/dist/playground/mount.d.ts +34 -12
  287. package/dist/playground/mount.js +80 -35
  288. package/dist/playground/runAction.d.ts +29 -0
  289. package/dist/playground/runAction.js +38 -0
  290. package/dist/schemas/index.js +1 -1
  291. package/dist/schemas/v1/workflow.schema.json +140 -2
  292. package/dist/services/doctorService.d.ts +52 -0
  293. package/dist/services/doctorService.js +113 -0
  294. package/dist/services/globalSave.js +17 -24
  295. package/dist/services/nodeExecutionService.d.ts +12 -1
  296. package/dist/services/nodeExecutionService.js +58 -58
  297. package/dist/services/playgroundService.d.ts +23 -3
  298. package/dist/services/playgroundService.js +53 -5
  299. package/dist/services/runsService.d.ts +42 -0
  300. package/dist/services/runsService.js +87 -0
  301. package/dist/services/toastQueue.d.ts +33 -0
  302. package/dist/services/toastQueue.js +38 -0
  303. package/dist/services/toastService.d.ts +30 -9
  304. package/dist/services/toastService.js +81 -46
  305. package/dist/settings/index.d.ts +1 -0
  306. package/dist/skins/default.d.ts +1 -1
  307. package/dist/skins/drafter.d.ts +1 -1
  308. package/dist/skins/graphite.d.ts +26 -0
  309. package/dist/skins/graphite.js +473 -0
  310. package/dist/skins/index.d.ts +6 -5
  311. package/dist/skins/index.js +7 -5
  312. package/dist/skins/slate.d.ts +1 -1
  313. package/dist/skins/slate.js +4 -4
  314. package/dist/stores/attachedRunStore.svelte.d.ts +35 -0
  315. package/dist/stores/attachedRunStore.svelte.js +47 -0
  316. package/dist/stores/connectDragStore.svelte.d.ts +39 -0
  317. package/dist/stores/connectDragStore.svelte.js +42 -0
  318. package/dist/stores/doctorStore.svelte.d.ts +79 -0
  319. package/dist/stores/doctorStore.svelte.js +244 -0
  320. package/dist/stores/editedNodesStore.svelte.d.ts +42 -0
  321. package/dist/stores/editedNodesStore.svelte.js +84 -0
  322. package/dist/stores/editorModeStore.svelte.d.ts +34 -0
  323. package/dist/stores/editorModeStore.svelte.js +55 -0
  324. package/dist/stores/instanceContainer.svelte.d.ts +68 -0
  325. package/dist/stores/instanceContainer.svelte.js +49 -2
  326. package/dist/stores/loopbackLanesStore.svelte.d.ts +18 -0
  327. package/dist/stores/loopbackLanesStore.svelte.js +25 -0
  328. package/dist/stores/nodeHighlightStore.svelte.d.ts +34 -0
  329. package/dist/stores/nodeHighlightStore.svelte.js +56 -0
  330. package/dist/stores/playgroundStore.svelte.d.ts +74 -2
  331. package/dist/stores/playgroundStore.svelte.js +182 -6
  332. package/dist/stores/runController.svelte.d.ts +382 -0
  333. package/dist/stores/runController.svelte.js +1217 -0
  334. package/dist/stores/settingsStore.svelte.d.ts +80 -18
  335. package/dist/stores/settingsStore.svelte.js +180 -62
  336. package/dist/stores/workflowStore.svelte.d.ts +18 -1
  337. package/dist/stores/workflowStore.svelte.js +29 -1
  338. package/dist/styles/base.css +300 -28
  339. package/dist/styles/fonts/Inter-LICENSE.txt +93 -0
  340. package/dist/styles/fonts/inter-latin-wght-normal.woff2 +0 -0
  341. package/dist/styles/fonts/inter.css +19 -0
  342. package/dist/styles/toast.css +100 -20
  343. package/dist/styles/tokenAliases.d.ts +13 -0
  344. package/dist/styles/tokenAliases.js +206 -0
  345. package/dist/styles/tokens.css +586 -14
  346. package/dist/svelte-app.d.ts +38 -5
  347. package/dist/svelte-app.js +14 -3
  348. package/dist/themes/graphite.d.ts +2 -0
  349. package/dist/themes/graphite.js +15 -0
  350. package/dist/themes/index.d.ts +2 -1
  351. package/dist/themes/index.js +22 -3
  352. package/dist/themes/minimal.js +10 -0
  353. package/dist/themes/scopedSkinCss.d.ts +47 -0
  354. package/dist/themes/scopedSkinCss.js +220 -0
  355. package/dist/types/chat.d.ts +6 -0
  356. package/dist/types/doctor.d.ts +82 -0
  357. package/dist/types/doctor.js +11 -0
  358. package/dist/types/events.d.ts +35 -0
  359. package/dist/types/events.js +4 -1
  360. package/dist/types/index.d.ts +103 -6
  361. package/dist/types/index.js +15 -3
  362. package/dist/types/navbar.d.ts +36 -0
  363. package/dist/types/playground.d.ts +66 -0
  364. package/dist/types/settings.d.ts +120 -7
  365. package/dist/types/settings.js +35 -3
  366. package/dist/types/skin.d.ts +23 -10
  367. package/dist/types/theme.d.ts +40 -2
  368. package/dist/utils/appearance.d.ts +19 -0
  369. package/dist/utils/appearance.js +13 -0
  370. package/dist/utils/canvasFit.d.ts +41 -0
  371. package/dist/utils/canvasFit.js +44 -0
  372. package/dist/utils/chipTitles.d.ts +9 -0
  373. package/dist/utils/chipTitles.js +19 -0
  374. package/dist/utils/connections.js +8 -0
  375. package/dist/utils/consoleHighlight.d.ts +28 -0
  376. package/dist/utils/consoleHighlight.js +269 -0
  377. package/dist/utils/deprecation.d.ts +17 -0
  378. package/dist/utils/deprecation.js +29 -0
  379. package/dist/utils/doctorOperations.d.ts +40 -0
  380. package/dist/utils/doctorOperations.js +237 -0
  381. package/dist/utils/duration.d.ts +13 -0
  382. package/dist/utils/duration.js +40 -0
  383. package/dist/utils/inspectorContext.d.ts +19 -0
  384. package/dist/utils/inspectorContext.js +12 -0
  385. package/dist/utils/inspectorSections.d.ts +20 -0
  386. package/dist/utils/inspectorSections.js +44 -0
  387. package/dist/utils/inspectorSurface.d.ts +46 -0
  388. package/dist/utils/inspectorSurface.js +51 -0
  389. package/dist/utils/interfaceTags.d.ts +102 -0
  390. package/dist/utils/interfaceTags.js +211 -0
  391. package/dist/utils/itemRef.d.ts +86 -0
  392. package/dist/utils/itemRef.js +106 -0
  393. package/dist/utils/lastRun.d.ts +35 -0
  394. package/dist/utils/lastRun.js +73 -0
  395. package/dist/utils/messageNodeLink.d.ts +17 -0
  396. package/dist/utils/messageNodeLink.js +16 -0
  397. package/dist/utils/minimapVisibility.d.ts +28 -0
  398. package/dist/utils/minimapVisibility.js +34 -0
  399. package/dist/utils/nodeAriaLabel.d.ts +12 -0
  400. package/dist/utils/nodeAriaLabel.js +17 -0
  401. package/dist/utils/nodeFingerprint.d.ts +27 -0
  402. package/dist/utils/nodeFingerprint.js +66 -0
  403. package/dist/utils/nodeFormSchema.d.ts +10 -0
  404. package/dist/utils/nodeFormSchema.js +2 -2
  405. package/dist/utils/nodeGeometry.d.ts +168 -0
  406. package/dist/utils/nodeGeometry.js +204 -0
  407. package/dist/utils/nodeProblem.d.ts +19 -0
  408. package/dist/utils/nodeProblem.js +9 -0
  409. package/dist/utils/nodeStatus.d.ts +38 -3
  410. package/dist/utils/nodeStatus.js +67 -39
  411. package/dist/utils/nodeSwap.js +9 -1
  412. package/dist/utils/nodeWrapper.d.ts +1 -0
  413. package/dist/utils/playgroundChat.d.ts +121 -0
  414. package/dist/utils/playgroundChat.js +275 -0
  415. package/dist/utils/playgroundHistory.d.ts +48 -0
  416. package/dist/utils/playgroundHistory.js +38 -0
  417. package/dist/utils/playgroundInputRuns.d.ts +26 -0
  418. package/dist/utils/playgroundInputRuns.js +50 -0
  419. package/dist/utils/portExposure.d.ts +49 -0
  420. package/dist/utils/portExposure.js +122 -0
  421. package/dist/utils/portUtils.d.ts +16 -0
  422. package/dist/utils/portUtils.js +37 -0
  423. package/dist/utils/portal.d.ts +3 -14
  424. package/dist/utils/portal.js +22 -0
  425. package/dist/utils/reservedPorts.d.ts +59 -0
  426. package/dist/utils/reservedPorts.js +60 -0
  427. package/dist/utils/runEdges.d.ts +24 -0
  428. package/dist/utils/runEdges.js +35 -0
  429. package/dist/utils/runsList.d.ts +69 -0
  430. package/dist/utils/runsList.js +134 -0
  431. package/dist/utils/selectOptions.d.ts +62 -0
  432. package/dist/utils/selectOptions.js +137 -0
  433. package/dist/utils/sessionRuns.d.ts +62 -0
  434. package/dist/utils/sessionRuns.js +123 -0
  435. package/dist/utils/sheetWidths.d.ts +29 -0
  436. package/dist/utils/sheetWidths.js +41 -0
  437. package/dist/utils/sidebarWidths.d.ts +34 -0
  438. package/dist/utils/sidebarWidths.js +47 -0
  439. package/dist/utils/straightWires.d.ts +73 -0
  440. package/dist/utils/straightWires.js +99 -0
  441. package/dist/utils/themeScope.svelte.d.ts +10 -0
  442. package/dist/utils/themeScope.svelte.js +80 -0
  443. package/dist/utils/wiredHandles.d.ts +10 -0
  444. package/dist/utils/wiredHandles.js +14 -0
  445. package/dist/utils/workflowDraft.d.ts +9 -0
  446. package/dist/utils/workflowDraft.js +39 -0
  447. package/dist/utils/workflowInterface.d.ts +128 -27
  448. package/dist/utils/workflowInterface.js +244 -33
  449. package/dist/utils/zoomTier.d.ts +43 -0
  450. package/dist/utils/zoomTier.js +107 -0
  451. package/dist/utils/zoomTierRows.d.ts +41 -0
  452. package/dist/utils/zoomTierRows.js +103 -0
  453. package/dist/webmcp/WebMCPConfirm.svelte +68 -18
  454. package/dist/webmcp/bridge.d.ts +5 -0
  455. package/dist/webmcp/bridge.js +8 -0
  456. package/dist/webmcp/bridgeController.svelte.d.ts +84 -0
  457. package/dist/webmcp/bridgeController.svelte.js +224 -0
  458. package/dist/webmcp/descriptors.d.ts +1 -1
  459. package/dist/webmcp/descriptors.js +66 -5
  460. package/dist/webmcp/fakeWidget.d.ts +34 -0
  461. package/dist/webmcp/fakeWidget.js +75 -0
  462. package/dist/webmcp/gate.d.ts +6 -0
  463. package/dist/webmcp/gate.js +8 -0
  464. package/dist/webmcp/index.d.ts +2 -0
  465. package/dist/webmcp/index.js +1 -0
  466. package/dist/webmcp/runtime.js +6 -2
  467. package/dist/webmcp/types.d.ts +2 -0
  468. package/dist/webmcp/validate.js +5 -1
  469. package/package.json +14 -7
  470. package/dist/components/Button.stories.svelte +0 -65
  471. package/dist/components/Button.stories.svelte.d.ts +0 -19
  472. package/dist/components/CanvasBanner.stories.svelte +0 -30
  473. package/dist/components/CanvasBanner.stories.svelte.d.ts +0 -27
  474. package/dist/components/CanvasContextMenu.stories.svelte +0 -63
  475. package/dist/components/CanvasContextMenu.stories.svelte.d.ts +0 -19
  476. package/dist/components/ConfigPanel.stories.svelte +0 -47
  477. package/dist/components/ConfigPanel.stories.svelte.d.ts +0 -27
  478. package/dist/components/EditorStatusBar.stories.svelte +0 -44
  479. package/dist/components/EditorStatusBar.stories.svelte.d.ts +0 -27
  480. package/dist/components/FlowDropEdge.stories.svelte +0 -197
  481. package/dist/components/FlowDropEdge.stories.svelte.d.ts +0 -26
  482. package/dist/components/LoadingSpinner.stories.svelte +0 -30
  483. package/dist/components/LoadingSpinner.stories.svelte.d.ts +0 -27
  484. package/dist/components/Logo.stories.svelte +0 -22
  485. package/dist/components/Logo.stories.svelte.d.ts +0 -27
  486. package/dist/components/MarkdownDisplay.stories.svelte +0 -38
  487. package/dist/components/MarkdownDisplay.stories.svelte.d.ts +0 -27
  488. package/dist/components/Navbar.stories.svelte +0 -58
  489. package/dist/components/Navbar.stories.svelte.d.ts +0 -27
  490. package/dist/components/NodeStatusOverlay.stories.svelte +0 -85
  491. package/dist/components/NodeStatusOverlay.stories.svelte.d.ts +0 -27
  492. package/dist/components/SchemaForm.stories.svelte +0 -122
  493. package/dist/components/SchemaForm.stories.svelte.d.ts +0 -27
  494. package/dist/components/Select.svelte +0 -53
  495. package/dist/components/Select.svelte.d.ts +0 -15
  496. package/dist/components/StatusIcon.stories.svelte +0 -60
  497. package/dist/components/StatusIcon.stories.svelte.d.ts +0 -27
  498. package/dist/components/StatusLabel.stories.svelte +0 -17
  499. package/dist/components/StatusLabel.stories.svelte.d.ts +0 -27
  500. package/dist/components/ThemeToggle.stories.svelte +0 -25
  501. package/dist/components/ThemeToggle.stories.svelte.d.ts +0 -27
  502. package/dist/components/console/CommandConsole.stories.svelte +0 -111
  503. package/dist/components/console/CommandConsole.stories.svelte.d.ts +0 -27
  504. package/dist/components/form/FormCheckboxGroup.stories.svelte +0 -28
  505. package/dist/components/form/FormCheckboxGroup.stories.svelte.d.ts +0 -27
  506. package/dist/components/form/FormFieldWrapper.stories.svelte +0 -53
  507. package/dist/components/form/FormFieldWrapper.stories.svelte.d.ts +0 -27
  508. package/dist/components/form/FormNumberField.stories.svelte +0 -36
  509. package/dist/components/form/FormNumberField.stories.svelte.d.ts +0 -27
  510. package/dist/components/form/FormRangeField.stories.svelte +0 -31
  511. package/dist/components/form/FormRangeField.stories.svelte.d.ts +0 -27
  512. package/dist/components/form/FormSelect.stories.svelte +0 -50
  513. package/dist/components/form/FormSelect.stories.svelte.d.ts +0 -27
  514. package/dist/components/form/FormTextField.stories.svelte +0 -30
  515. package/dist/components/form/FormTextField.stories.svelte.d.ts +0 -27
  516. package/dist/components/form/FormTextarea.stories.svelte +0 -34
  517. package/dist/components/form/FormTextarea.stories.svelte.d.ts +0 -27
  518. package/dist/components/form/FormToggle.stories.svelte +0 -30
  519. package/dist/components/form/FormToggle.stories.svelte.d.ts +0 -27
  520. package/dist/components/icons/CommandLineIcon.svelte +0 -15
  521. package/dist/components/icons/CommandLineIcon.svelte.d.ts +0 -26
  522. package/dist/components/interrupt/ChoicePrompt.stories.svelte +0 -68
  523. package/dist/components/interrupt/ChoicePrompt.stories.svelte.d.ts +0 -27
  524. package/dist/components/interrupt/ConfirmationPrompt.stories.svelte +0 -71
  525. package/dist/components/interrupt/ConfirmationPrompt.stories.svelte.d.ts +0 -27
  526. package/dist/components/interrupt/ReviewPrompt.stories.svelte +0 -77
  527. package/dist/components/interrupt/ReviewPrompt.stories.svelte.d.ts +0 -27
  528. package/dist/components/interrupt/TextInputPrompt.stories.svelte +0 -51
  529. package/dist/components/interrupt/TextInputPrompt.stories.svelte.d.ts +0 -27
  530. package/dist/components/nodes/CaptionNode.stories.svelte +0 -65
  531. package/dist/components/nodes/CaptionNode.stories.svelte.d.ts +0 -18
  532. package/dist/components/nodes/GatewayNode.stories.svelte +0 -108
  533. package/dist/components/nodes/GatewayNode.stories.svelte.d.ts +0 -26
  534. package/dist/components/nodes/IdeaNode.stories.svelte +0 -52
  535. package/dist/components/nodes/IdeaNode.stories.svelte.d.ts +0 -26
  536. package/dist/components/nodes/NotesNode.stories.svelte +0 -76
  537. package/dist/components/nodes/NotesNode.stories.svelte.d.ts +0 -26
  538. package/dist/components/nodes/SimpleNode.stories.svelte +0 -223
  539. package/dist/components/nodes/SimpleNode.stories.svelte.d.ts +0 -26
  540. package/dist/components/nodes/SquareNode.stories.svelte +0 -127
  541. package/dist/components/nodes/SquareNode.stories.svelte.d.ts +0 -26
  542. package/dist/components/nodes/TerminalNode.stories.svelte +0 -25
  543. package/dist/components/nodes/TerminalNode.stories.svelte.d.ts +0 -26
  544. package/dist/components/nodes/ToolNode.stories.svelte +0 -189
  545. package/dist/components/nodes/ToolNode.stories.svelte.d.ts +0 -26
  546. package/dist/components/nodes/WorkflowNode.stories.svelte +0 -188
  547. package/dist/components/nodes/WorkflowNode.stories.svelte.d.ts +0 -26
  548. package/dist/components/playground/MessageBubble.stories.svelte +0 -151
  549. package/dist/components/playground/MessageBubble.stories.svelte.d.ts +0 -27
  550. package/dist/components/toast/WarningIcon.svelte +0 -28
  551. package/dist/components/toast/WarningIcon.svelte.d.ts +0 -26
  552. package/dist/mocks/app-environment.d.ts +0 -8
  553. package/dist/mocks/app-environment.js +0 -16
  554. package/dist/mocks/app-forms.d.ts +0 -6
  555. package/dist/mocks/app-forms.js +0 -29
  556. package/dist/mocks/app-navigation.d.ts +0 -5
  557. package/dist/mocks/app-navigation.js +0 -36
  558. package/dist/mocks/app-stores.d.ts +0 -14
  559. package/dist/mocks/app-stores.js +0 -26
  560. package/dist/stories/CanvasDecorator.svelte +0 -49
  561. package/dist/stories/CanvasDecorator.svelte.d.ts +0 -8
  562. package/dist/stories/EdgeDecorator.svelte +0 -125
  563. package/dist/stories/EdgeDecorator.svelte.d.ts +0 -17
  564. package/dist/stories/NodeDecorator.svelte +0 -75
  565. package/dist/stories/NodeDecorator.svelte.d.ts +0 -8
  566. package/dist/stories/WebMCPFakeAgent.svelte +0 -229
  567. package/dist/stories/WebMCPFakeAgent.svelte.d.ts +0 -10
  568. package/dist/stories/utils.d.ts +0 -93
  569. package/dist/stories/utils.js +0 -156
  570. package/dist/webmcp/WebMCP.stories.svelte +0 -101
  571. package/dist/webmcp/WebMCP.stories.svelte.d.ts +0 -18
package/CHANGELOG.md CHANGED
@@ -5,6 +5,391 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [2.12.0] - 2026-10-14
9
+
10
+ ### Added
11
+
12
+ - **Test mode.** An **Edit | Test** switch in a toolbar at the canvas's top-left. Test docks the Playground in
13
+ the left slot (below 1200 px a drawer over the canvas), targets the editor's current workflow including its
14
+ unsaved edits, and creates the test session on the first send. The session and a running run survive
15
+ switching back to Edit. With nothing selected there is no right column; clicking a node opens its inspector
16
+ as a 360 px sheet over the canvas, on a **Last run** tab (status, duration, timestamps, tokens, input,
17
+ output, error). `N` opens the node library as a popover, `T` toggles the mode.
18
+ - The mode is held per instance: `fd.editorMode` (`EditorModeStore`: `current`, `isTest`,
19
+ `set('edit' | 'test')`, `toggle()`, `onChange(listener)`; type `EditorMode` from `core`). Start in Test with
20
+ the `editorMode` prop of `App` or the `editorMode` mount option, follow changes with `onEditorModeChange`.
21
+ Test only takes effect for a saved workflow on an editable canvas (`mode: 'edit'`, no `pipelineId`);
22
+ `features.testMode: false` removes the switch. `WorkflowEditor` takes `editorMode`, `onEditorModeChange`,
23
+ `showRunBar` and `onOpenTest`.
24
+ - The docked Playground's header is a **history chip** (Conversations the Playground created, plus **New
25
+ conversation**, and the Runs of the open one; picking a run calls `fd.playground.pinExecution`) and a **⋯
26
+ menu** (**Expand steps by default**, **JSON view**, **Playground settings**, **Refresh**, **Reset stuck
27
+ session**).
28
+ - **Save & send**: Send (and Run) read "Save & send" while the workflow has unsaved edits; the editor saves
29
+ first and nothing is sent when the save fails. `fd.runs.needsSave` and `fd.runs.saveFirst()`.
30
+ - A **"Saved: new version" divider** marks where the workflow changed between runs. Needs
31
+ `GET /sessions/{id}/runs` (FlowDrop for Drupal 2.7.0; in the OpenAPI spec, optional endpoint
32
+ `sessions.runs`, `PlaygroundService.getSessionRuns()`): a server without it answers 404 and the editor shows
33
+ no dividers and no error. `fd.playground.sessionRuns`, `fd.runs.loadSessionRuns()`; `isRunStale()` and
34
+ `versionDividersFromRuns()` from `playground`. Sessions carry `thirdPartySettings`; the Playground's own are
35
+ marked `flowdrop_playground.created` (`PLAYGROUND_SESSION_MARK`, `isPlaygroundSession()`,
36
+ `playgroundSessionsOf()`), and the history lists only those.
37
+ - A **Runs list** in the toolbar (`features.runsList`, default on; Test mode only) lists the workflow's past
38
+ runs from `endpoints.pipelines.list`; opening one shows its node statuses on the canvas. Optional
39
+ endpoints `pipelines.rerun` and `pipelines.cancel` add Re-run and Cancel; `features.adminLinks`
40
+ (`{ runs?, run? }` URL templates) adds "Open in admin" links.
41
+ - **Message-to-node links**: a reply's "via <node>" label selects the node, opens its Last run tab and brings
42
+ it into view, and hovering lights the node on the canvas (`fd.highlight`). `NodeJobExecution` gains `input`
43
+ and `output`; `canvasFocusNode(id)` on `WorkflowEditor`.
44
+ - A **form-first Playground**: a workflow with inputs and no chat opens on an **Inputs** card (one field per
45
+ input, JSON fields for array and object inputs with example chips, **Run** also on ⌘↵ / Ctrl+↵, **Fill from
46
+ last run**); chat plus inputs folds the inputs into one row above the composer.
47
+ - **Run state per instance.** `fd.runs` (`RunController`, from `playground`; types from `core`) holds the
48
+ session and run executors that used to live inside the Playground component, shared by the Playground, Test
49
+ mode and the Console. `fd.runs.activeRun` (`ActiveRun`), `stopRun()`, `dismissRun()`, `isLive`,
50
+ `requestNodeStatuses()`, `loadNodeStatuses(pipelineId?, workflow?)`, and `wrapHostHooks(hooks)`, which routes
51
+ a host's `onRun` / `onRunStatus` through the controller (the hooks answer as before; a host run is followed
52
+ only when `onRunStatus` is supplied). `fd.runs.stopHostPolling()` ends a host run's status poll; `app.destroy()`
53
+ and `fd.runs.dispose()` call it. `fd.playground.onSessionStatusChange(listener)` is a synchronous listener
54
+ (unlike `subscribeToSessionStatus`, which batches). `stripExecutionInfo(nodes)` from `core`.
55
+ - **Run status on the canvas.** Run status of the nodes lives in `fd.playground.nodeStatuses`
56
+ (`nodeStatusFor(id)`, `setNodeStatuses`, `clearNodeStatuses`), so an edit no longer wipes the badges and two
57
+ editors on one page never share statuses. Nodes show a labelled pill (Running, Completed, Waiting for you,
58
+ Failed, Skipped, with ×N for repeats), centred on the node's top edge at screen size; in Test mode the node
59
+ border takes the status colour and a node whose configuration changed since the shown run gets an `edited`
60
+ mark. Edges between a completed node and a reached node draw as hot (class `flowdrop-edge--hot`; never
61
+ written into saved edges). A run pill in the toolbar shows the live run (running, waiting, failed, done,
62
+ stopped) with **Stop**, **Open** (needs `onOpenTest`) and **Ask the Assistant**, and fades when the run
63
+ ends; changes are announced politely.
64
+ - **Console `session` commands**: `session send "…"` (triple-quoted for several lines), `session run
65
+ [key=value …]`, `session stop`, `session new`, `session status`. Console only: not part of the editing
66
+ commands, the Assistant or WebMCP. A batch containing a `session` line is refused before anything runs.
67
+ - **Run context for the Assistant.** A run can be attached to the AI Assistant (a run chip, **+ Attach a
68
+ run**, **Ask the Assistant** on a failed node or run); the tool-calling chat request then carries
69
+ `attachedRunId` (`ChatRequest.attachedRunId`; a server without run tools ignores it). `fd.attachedRun`
70
+ (`attach(id, hint?)`, `detach()`, per instance). Needs fddo 2.7.0 (`site_get_run`, `site_get_node_run`).
71
+ - **Problems indicator.** With the optional endpoints `workflows.diagnose` and `workflows.remedy` set, the
72
+ navbar lists the draft's problems, nodes carry a badge, and a remedy applies as one undoable edit. A backend
73
+ without them shows nothing.
74
+ - **Graphite theme** (`theme: 'graphite'`, light and dark), the new default (see Changed): near-black primary
75
+ action, one blue accent for selection, focus and running, separate green / amber / red for run status, 4 px
76
+ radius, 1 px rules; every text pair passes WCAG AA. Its font is Inter, shipped as the opt-in stylesheet
77
+ `@flowdrop/flowdrop/styles/fonts/inter.css` (variable, Latin, 47 KB, OFL); without it the editor uses the
78
+ system font. Graphite carries a redesigned node card (header, category tile, port rows on a fixed grid, exec
79
+ pin), calmer notes (20 px height snap), top-centre toasts, a terminal-style Console and flat form rows; the
80
+ card structure, notes and toasts apply to every theme.
81
+ - **`colorScheme` mount option** (`ColorSchemeOption`, `HostColorSchemeValue`; `mountFlowDropApp` and
82
+ `mountPlaygroundApp`): `colorScheme: { host: { value: 'light' | 'dark' | 'auto', label, subscribe? } }` adds a
83
+ fourth choice, `'host'` (`ThemePreference` gains it), shown verbatim as `label` in the navbar's Appearance menu
84
+ and Settings. With it `'host'` is the default; a stored preference the user never chose moves to it, an
85
+ explicit Light or Dark is kept. `host.subscribe` re-resolves on live changes and is released by
86
+ `app.destroy()`. Without the option nothing changes.
87
+ - **`branding`** option on `mountFlowDropApp`, `mountPlaygroundApp` and `App`:
88
+ `{ logo?: string | Component; name?: string; logoAlt?: string; href?: string }` (type `NavbarBranding`). `logo`
89
+ replaces the wordmark (image URL or component, max 24 px high), `name` replaces "FlowDrop" in the page title
90
+ and the logo's label, `logoAlt` overrides the alt text, `href` links the logo. The default wordmark is
91
+ labelled with the `navigation.appName` message, which also drives the page title.
92
+ - `FlowDropThemeConfig.display` (`nodeIcon`, `sidebarList`, `sidebarSearch`, `sidebarHeader`, `navbarActions`;
93
+ type `FlowDropDisplayConfig`): typed layout switches, used by the `minimal` theme. A skin can name a `font`
94
+ (a CSS font-family; the host loads the face).
95
+ - New `@public` design tokens: run-status roles `--fd-status-{running,completed,waiting,failed,skipped}` and
96
+ `-soft`, control heights `--fd-control-sm` / `-md` / `-lg` (24 / 28 / 32 px) and `--fd-panel-header` (40 px).
97
+ - **Zoom tiers.** The canvas draws a node at up to four levels of detail by zoom (full, outline, glyph, map),
98
+ published as `data-fd-zoom` on `.flowdrop-root`. The `editor.zoomTiers` setting (`ZoomTierConfig`,
99
+ `ZoomTierName` from `settings`) gives the zoom each tier starts at; default
100
+ `{ full: 0.75, outline: 0.45, glyph: 0.25, map: 0 }`, `{ full: 0 }` turns tiers off, an invalid value falls
101
+ back to the default with one console warning. Settings > Editor > Zoom levels edits it.
102
+ - **Node layout.** Commands `layout node inspect <nodeId>` and `layout node beautify <nodeId>
103
+ [column|ports|align|clear|all] [--dry-run]`, both with `--gap-x` / `--gap-y`, and the WebMCP tools
104
+ `inspect_node_layout` and `beautify_node` (`gapX` / `gapY`). Settings `editor.layoutGapX` / `layoutGapY`
105
+ (defaults 120 / 40 px) set the spacing the layout keeps. Loopbacks (`loop_back` edges) are drawn as return lanes
106
+ (out of the source, under the loop body, back along a lane) instead of a curve through the cards, and layout
107
+ keeps those lanes free. A card's interface tags count as part of the card.
108
+ - **Tidy up.** A broom in the canvas controls and **Tidy up** (⇧⌥T) in the pane menu run the graph layout; **Tidy
109
+ node** (⇧S) in the node menu tidies one node. One undo step each. The toast says what changed, how many
110
+ overlaps are left and anything that got worse; a layout that would not improve is left alone. Graphs over
111
+ 120 nodes are refused (`TOO_LARGE`; tidy single nodes instead). See Changed for `layout beautify`.
112
+ - **Ports.** **Hide unconnected ports** / **Show hidden ports** in the node menu (data ports only), **Connect
113
+ to…** in a port's menu (a searchable picker of compatible ports on other nodes), and ports ready to receive
114
+ light up while a wire is dragged. Nothing is ever blocked by type: compatible ports are highlighted, the rest
115
+ dulled. A wire being dragged aligns magnetically with a port on the target.
116
+ - **Interface tags on the canvas**: a published port shows a tag beside it (rename, remove, or expose a port
117
+ from its menu), and a trigger shows a read-only `event:<node-id>` tag beside its event input, with a hover
118
+ explanation. A trigger's event input cannot be wired, hidden or published. `EVENT_PORT_ID`,
119
+ `RESERVED_INPUT_EVENT_PREFIX`, `isTriggerNode`, `isTriggerEventInput`, `isEventInputConnection`,
120
+ `reservedInputs`, `isReservedInputName` and `ReservedInput` are exported from `editor`.
121
+ - New settings: `editor.showNodeDescriptions` (default off; a 60 px band under every node's header when on),
122
+ `ui.sidebarWidths` (`{ nodes: 280, assistant: 380 }`, the resizable left column per tab) and
123
+ `ui.sheetWidths` (`{ workflow: 420 }`, the resizable workflow-settings sheet).
124
+ - WebMCP: `getBridgeController()` and `createBridgeController()` (`WebMCPBridgeController`, `BridgeStatus`,
125
+ `BridgeTool`, `BridgeSnapshot`) from `webmcp`, a typed controller over the desktop bridge widget; the editor
126
+ shows a bridge button as the last segment of the zoom controls.
127
+ - A flat row list for small array fields (inline-edit cells, a default mark for `x-item-ref` arrays).
128
+ - Messages: `connectTo.*` (including `optionCurrent`, `optionTaken`), `form.array.movedTo` and the other
129
+ `form.array` row messages, `layout.zoomLevelsTitle`, `layout.zoomLevelsHelp`, `nodes.configure`,
130
+ `nodes.configureTool`, `nodes.configureIdea`, `notice.dismiss`, plus new groups for the features above:
131
+ `tidy`, `runBar`, `runsList`, `doctor`, `nodeInspector`, `playground.header`, `playground.steps`,
132
+ `playground.inputForm`, `statusPill`, `select`, `webmcp.bridge`, `workflowInterface` (tags) and `chat.tools.verbs`.
133
+
134
+ ### Changed
135
+
136
+ - **Graphite is the default theme.** `DEFAULT_UI_SETTINGS.theme` is `'graphite'` (was `'default'`). An editor
137
+ with no `theme` prop and no saved choice starts in Graphite; a browser that saved its settings keeps its
138
+ theme. To keep the old look, pass `theme: 'default'`.
139
+ - **`<html data-theme>`.** The resolved colour scheme now lives on each editor's scope element, so two editors
140
+ on one page can differ. `<html data-theme>` is still mirrored for compatibility (see Deprecated).
141
+ - **`getStatusColor` / `getStatusBackgroundColor` / `getStatusTextColor`** return `var(--fd-status-*)` instead
142
+ of hex. They are valid in CSS only: host code that parses the hex value breaks.
143
+ - **`layout beautify`** (Console, WebMCP `beautify_layout`) now runs the same sweep as Tidy up instead of a
144
+ spacing-only pass: it puts every card in its column, clears overlaps and tight spacing, reorders ports and
145
+ straightens wires, keeps cards on the 20 px grid, and says so when nothing improved. `layout auto` aligns
146
+ tops along chains and places y on the grid. `--gap-x` / `--gap-y` are validated against the 20 px layout grid:
147
+ `INVALID_ARGUMENT` "a gap must be a non-negative multiple of the 20 px layout grid".
148
+ - **Settings.** A custom settings service's `getPreferences` may return partial settings. Grid size is 10 or
149
+ 20; any other stored value migrates to 20. `ui.consoleHeight` defaults to 220 (was 300).
150
+ - **Token scales collapsed** (values move, names stay). Type is 11 / 12 / 13 / 15 / 20 / 24 px (`--fd-text-sm`
151
+ 14 → 13, `--fd-text-base` 16 → 15, `--fd-text-lg` 18 → 20); spacing sits on a 4 px grid (`--fd-space-2xs` 6 →
152
+ 4, `--fd-space-sm` 10 → 8, `--fd-space-lg` 14 → 12); `--fd-radius-md` 6 → 4 px. Sites that override these
153
+ tokens are unaffected.
154
+ - **Lighter frame.** The navbar is 48 px (`--fd-navbar-height`, was 60). The status bar under the canvas is
155
+ gone: the node count sits in the zoom control, with the cycle warning. The minimap is 120×72 and hides when
156
+ the canvas is under 800 px wide (`showMinimap` still wins). The Console is a strip along the canvas's bottom
157
+ edge (opens at 220 px, height saved). One panel header and one composer are shared by the Playground, the
158
+ Assistant, the inspector, settings, overlays and the Console.
159
+ - **The AI Assistant** is a tab beside Nodes in the left slot, in Edit mode only; it keeps its conversation
160
+ across tab switches and Test mode. `consolePlacement` places the Command Console alone and the console
161
+ toggle opens only the Console; `consolePlacement: 'sidebar'` stays valid and `features.assistant: false`
162
+ still hides the Assistant. A host that set `disableSidebar` keeps the Assistant as a tab of the console group
163
+ (until 3.0). `bottomPanelTab: 'chat'` in stored settings is accepted and ignored.
164
+ - **Playground steps fold into one row per turn** ("8 steps · 82 ms · 1 waiting"), opening a compact table; a
165
+ failed step's error stays visible; the turn's run notices fold in. **Expand steps by default**
166
+ (`playground.expandSteps`, off) keeps them open. The status badge's hover details panel is gone: those facts
167
+ are in the inspector's Last run tab, and `status.overlay.tooltip` takes only `{ status }`.
168
+ - A workflow's settings open as a resizable sheet over the canvas. Toasts appear top-centre under the navbar
169
+ (at most three, one success at a time); a toast with an action stays until closed and every toast is
170
+ closable (the label comes from `notice.dismiss`).
171
+ - The Playground's "Nothing will reply here" notice sits in the empty conversation with a **Playground
172
+ settings** button. A refused Run (missing input, or the server's 400) is shown under the Run button, not in
173
+ the banner (`fd.playground.launchError`). A turn started by Run without a typed message reads "Started a run"
174
+ instead of an empty bubble. A form input of array or object type is sent as parsed JSON; invalid JSON stops
175
+ the run with "Not valid JSON for its type" (`InterfaceInputsResult`'s failure branch gains `invalid`).
176
+ - A saved or exported workflow no longer contains a node's `executionInfo`. The standalone Playground sends a
177
+ `predefinedMessage` starting with `/` as typed instead of reading it as a slash command.
178
+ `nodeExecutionService.fetchMultipleNodeExecutionInfo` rejects on a failed read (`getMultipleNodeExecutionInfo`
179
+ still never rejects).
180
+ - `ConfigPanel`'s `onClose` is optional; `NodeSidebar` takes a `popover` prop.
181
+ - `flowdrop:refresh-status` dispatched on one editor's mount container refreshes only that editor; dispatched
182
+ on `document` it still reaches all.
183
+ - Internal class names changed with the shared panel header, composer and steps rows (override CSS that targets
184
+ them): `.flowdrop-status-bar*`, `.flowdrop-text--error`, `.flowdrop-console-toggle`,
185
+ `.execution-console__header|__icon|__title`, `.message-stream__log-group*`, `.playground__vertical-resizer*`,
186
+ `.form-prompt__form-wrapper`, `.chat-input__textarea|__send-btn|__stop-btn|__run-btn|__command-feedback-dismiss`,
187
+ `.ai-chat-panel__input-area|__input|__send`, the `__header|__title|__close` families of `.config-panel`,
188
+ `.config-panel-modal`, `.config-modal`, `.flowdrop-settings-modal`, `.surface-overlay` and `.command-console`,
189
+ and `.node-status-overlay__icon`. The `.node-status-overlay--{status}` modifiers are now
190
+ `--{running,completed,waiting,failed,skipped}`, with the raw status in `data-execution-status`. New:
191
+ `.steps-summary*`, `.fd-zoom-status__count`, `.node-status-overlay__pill|__outline|--compact`.
192
+
193
+ ### Deprecated
194
+
195
+ - The `<html data-theme>` mirror: read the scheme from the editor's scope element instead. Removed in 3.0.
196
+ - `FormToggle.hideLabel`, `WorkflowEditor`'s `consoleOpen` / `onToggleConsole` / `consoleToggleLabel` (the
197
+ console is driven by the instance's UI state, `ui.consoleOpen`), `ControlPanel.notice` and
198
+ `NodeStatusOverlay`'s `size`, `position` and `showDetails` (and `NodeStatusConfig.showDetails`): accepted, no
199
+ effect. Removed in 3.0.
200
+ - `ui.sidebarWidth`: use `ui.sidebarWidths.nodes`; still read as its fallback.
201
+ - Messages `chat.tools.reading` / `read` / `applied` (unused), `playground.logGroup`,
202
+ `playground.executionConsole.header`, `readyTitle` and `readyText`; and the function form of
203
+ `chat.tools.awaitingApproval` / `rejected` (now strings; both are accepted).
204
+ - `ExecutionLogs` in the `playground` barrel (not rendered by any surface).
205
+ - The `--fd-*-display` skin tokens (`node-icon-display`, `node-circle-display`,
206
+ `sidebar-{search,header,card,flat}-display`, `navbar-{split,dropdown}-display`): use
207
+ `FlowDropThemeConfig.display`, which wins over them. They keep working and go in 3.0.
208
+ - The standalone Playground, in favour of the editor's **Test mode**: `Playground`, `PlaygroundStudio`,
209
+ `PlaygroundApp`, `PlaygroundModal` and the `mountPlayground`, `mountPlaygroundStudio`, `mountPlaygroundApp`
210
+ and `unmountPlayground` entries. They keep working and warn once per page on the console when mounted. They
211
+ are removed in 3.0. To migrate, embed the editor (`WorkflowEditor` / `mountFlowDropApp`) and use its Test mode.
212
+ - `data.executionInfo` on a node: read run status from `fd.playground.nodeStatusFor(id)`. Hosts that still
213
+ write it keep working (the overlay falls back to it), but it is no longer saved, exported or kept across
214
+ edits. `NodeOperationsHelper.applyExecutionInfo` is deprecated with it. Both go in 3.0.
215
+
216
+ ### Removed
217
+
218
+ - The status bar under the canvas, the floating Console button, the Playground's "Ready to run" empty state and
219
+ the resize splitter between its conversation and form, and the status badge's hover details panel.
220
+ - Messages `status.overlay.statusLabel`, `executionsLabel`, `lastRunLabel`, `durationLabel`, `errorLabel` and
221
+ `historyLabel` (with the details panel). Overrides of them no longer type-check.
222
+
223
+ ### Fixed
224
+
225
+ - An inline `theme.skin` on a named theme no longer drops that theme's dark palette (`resolveTheme`).
226
+ - A form field without a title shows a readable label instead of its raw schema key.
227
+ - Canvas nodes are named on the focusable wrapper (the inner `aria-label` was invalid ARIA), and the node
228
+ configure gear is visible on selected and focused nodes and on touch, not on hover only. Its label is
229
+ localisable (`nodes.configure`, `nodes.configureTool`, `nodes.configureIdea`).
230
+
231
+ ## [2.11.0] - 2026-10-07
232
+
233
+ ### Added
234
+
235
+ - Playground settings: a workflow's chat binding now lives in its own
236
+ `playground` key instead of `turn` on interface entries. The binding says
237
+ which interface input the chat message goes to, which input receives recent
238
+ messages (and how many), which inputs receive the session and message IDs,
239
+ which node output ports print as replies, and whether sub-workflows print
240
+ their own replies. New types `WorkflowPlayground`, `PlaygroundChatBinding`,
241
+ `PlaygroundReplyPort` and `PlaygroundChatSource` (from `core`), and from
242
+ `playground`: `resolvePlaygroundChat` (the binding in effect and where it
243
+ came from, `ResolvedPlaygroundChat`), `playgroundChatIssues` (what is wrong
244
+ with a binding, `PlaygroundChatIssue`, `PlaygroundChatInputKey`) and
245
+ `PlaygroundStore.chatBinding`. A server from FlowDrop
246
+ 2.7.0 on sends `playground: {chat, resolved, source}` with every workflow and
247
+ saves `playground.chat` with it. `chat: null` means the workflow has no chat
248
+ until somebody sets it up.
249
+ - The workflow settings surface gains a **Playground** tab beside Settings and
250
+ Interface. It is shown only when the workflow carries Playground settings, so
251
+ older backends never see it. It has Message goes to, History goes to (with a
252
+ message count), Session and message IDs, Print as replies, and the
253
+ sub-workflow switch. It also has a _Not set up_ state, a warning when a
254
+ message input is bound but no reply is, and inline errors for an input that
255
+ is no longer on the interface or a reply on a node or port that is gone. A
256
+ workflow that still chats through interface `turn` marks gets a **Move them
257
+ here** button: it writes the binding they declare and removes the marks in
258
+ one undoable step. Until then the fields show what the marks set up, and the
259
+ first edit moves them too, so a single change never switches the chat off
260
+ and clearing every field really means no chat. A turn value this library
261
+ does not know (from a newer server) stays on the interface. An invalid
262
+ message count is refused with a reason instead of falling back to 10.
263
+ Problems are worded through the message catalogue
264
+ (`playgroundSettings.issues`); an issue's `message` stays English for logs
265
+ and agents. Renaming an interface input renames it in the binding, and
266
+ removing one unbinds it, in the same undo step. Emptying an input's id puts
267
+ the old one back, since an input needs an id. A node swap moves replies to
268
+ the new node's mapped output. A reply on an output that is not exposed on
269
+ the canvas is listed like any other. When settings are stored but the
270
+ interface still carries `turn` marks, the tab says they are ignored and
271
+ offers **Remove them**; any edit in the tab removes them too, so clearing
272
+ the binding (there, or by removing its last input on the interface) never
273
+ falls back to them.
274
+ Edits mark the workflow dirty and are saved with it.
275
+ - The Playground shows one line, _No chat yet…_, when the workflow's settings
276
+ bind no chat. The form or the Run button still work. It shows _Nothing will
277
+ reply here…_ when a message input is bound but no reply is. A stored binding
278
+ that no longer binds anything (its inputs were removed) gets the _No chat
279
+ yet…_ line too.
280
+
281
+ ### Changed
282
+
283
+ - The Playground picks its input mode from the workflow's Playground settings,
284
+ then from deprecated interface `turn` marks. `legacy` (guess from the nodes)
285
+ is now used only for a workflow without a `playground` key, that is a server
286
+ before FlowDrop 2.7.0 whose interface declares no `turn`. With the key
287
+ present, a workflow that binds no message input gets a form or Run, never
288
+ `legacy`. `resolvePlaygroundInputMode` and `interfaceFormEntries` take the
289
+ settings as an optional second argument. Existing calls behave as before.
290
+ While the chat comes from `turn` marks, an input marked with a `turn` value
291
+ this library does not know (a newer server's) stays out of the form, as it
292
+ did before.
293
+ - Save and export send `playground: {chat}` when the workflow has a
294
+ `playground` key, and send nothing for it otherwise.
295
+ - `fd.workflow.batchUpdate` accepts `playground`, keyed on presence like
296
+ `interface`.
297
+ - When the host passes a workflow without `interface` or `playground`, the
298
+ Playground loads it and takes only the missing keys. A key the host passed
299
+ is its live copy (the editor's, unsaved edits and all) and is never replaced
300
+ by the saved one. Once a server has sent a workflow without `playground`
301
+ (before FlowDrop 2.7.0), the Playground stops asking it for one for the rest
302
+ of the page.
303
+ - The API spec's turn request no longer says a workflow with no chat binding
304
+ still takes `content`: from FlowDrop 2.7.0 it is form-only, and nothing is
305
+ guessed from its nodes.
306
+ - The mock backend checks `playground.chat` on save against the interface and
307
+ nodes in the same save, with `playgroundChatIssues`, and stores the saved
308
+ interface.
309
+ - **Host pages:** a skin's tokens no longer land on the host page's `:root`.
310
+ Each editor scopes them to its own root (`data-fd-scope`), so two editors
311
+ with different skins stop overwriting each other and the page around the
312
+ editor gets no `--fd-*` variables. Aliases that follow a token the skin sets
313
+ (`--fd-panel-bg` and the like) are redeclared in the scope, and overlays
314
+ moved to `<body>` (config panel, surface overlay, WebMCP approval dialog)
315
+ carry the scope along. Light/dark stays the page-wide `data-theme` on
316
+ `<html>`. A host that styled its own page with a skin's `--fd-*` variables
317
+ must set them itself.
318
+ - **Host pages:** `@flowdrop/flowdrop/styles` no longer resets the host page.
319
+ `* { box-sizing: border-box }` and `p { margin: 0 }` now apply only inside
320
+ FlowDrop's own roots (`.flowdrop-root`, the new `.flowdrop-scope` marker on
321
+ each standalone component, `.flowdrop-portal`, `.svelte-flow`), at the same
322
+ zero specificity as before. Host elements that relied on the leak need
323
+ their own rule.
324
+ - Unmounting a Playground no longer calls `interruptService.stopPolling()`.
325
+ That poller is page-wide and the library never starts it, so one
326
+ playground closing stopped polling a host had started for the whole page.
327
+ A host that starts it stops it.
328
+
329
+ ### Deprecated
330
+
331
+ - `WorkflowInterfaceEntry.turn`, `WorkflowInterfaceTurn`,
332
+ `WORKFLOW_INTERFACE_INPUT_TURNS` and `WORKFLOW_INTERFACE_OUTPUT_TURNS`. They
333
+ will be removed in 3.0. A stored `turn` is still read, for a workflow without
334
+ Playground settings, and still round-trips. For a workflow that carries
335
+ Playground settings, the interface editor no longer offers the **Chat
336
+ turn** selector: an entry that carries a `turn` shows it as a struck-through
337
+ chip with a note and an **Open Playground settings** link. A workflow
338
+ without a `playground` key (a server before FlowDrop 2.7.0) keeps the
339
+ selector and the history limit field, since `turn` is the only way to set
340
+ its chat up. `interface-turn-duplicate` and `interface-turn-direction` are
341
+ worded as deprecation warnings that point at the Playground settings, and
342
+ are no longer reported once settings are stored (the server ignores `turn`
343
+ then).
344
+
345
+ ### Fixed
346
+
347
+ - `@iconify/svelte` is a required peer dependency. It was marked optional, so
348
+ npm and pnpm did not install it, yet almost every entry point imports it:
349
+ a fresh install failed on the first import with "Failed to resolve import
350
+ '@iconify/svelte'". Install it beside the library if your app does not
351
+ have it.
352
+ - Every relative import in the package carries its file extension. Three in
353
+ the skins (reached from `core`) and two in node components had none, which
354
+ Node ESM and webpack refuse in a `"type": "module"` package. A new
355
+ `prepack` check (`scripts/check-extensions.mjs`) keeps it that way. The
356
+ workflow schema JSON is imported `with { type: 'json' }`.
357
+ - The `svelte` peer range says what the code needs: `^5.29.0` (the library
358
+ uses attachments, and `@xyflow/svelte` already asks for 5.25). An older
359
+ Svelte failed to compile the shipped components. `engines.node` is
360
+ `>=20`, as `marked` and `dompurify` already require.
361
+ - Storybook stories and their mock modules are no longer in the tarball.
362
+ - Pipeline status no longer leaks after it unmounts. Its 5-second poll kept
363
+ calling the API for the life of the page if the component went away while
364
+ the pipeline was running. The logs sidebar left the host page's body
365
+ unscrollable when it unmounted while open, and now restores the body's own
366
+ `overflow` rather than clearing it. The editor's node execution-info load,
367
+ scheduled with `requestIdleCallback`, was never cancelled (it was cleared
368
+ with `clearTimeout`), so a quick pipeline switch still ran the stale load;
369
+ it is now cancelled, and an unmounted editor drops a scheduled or
370
+ in-flight load.
371
+ - A settings change (even the theme) no longer wipes the run status from the
372
+ canvas. The editor rebuilt its nodes from the workflow store on every
373
+ settings change, and the store carries no execution info, so the status
374
+ badges vanished until the next poll. The editor now keeps the last loaded
375
+ execution info and re-applies it on every rebuild; it drops it when the
376
+ pipeline or workflow changes.
377
+ - Playgrounds on one page no longer stop each other. Live polling is now
378
+ per FlowDrop instance (`fd.playgroundService`; the page-default instance
379
+ keeps using the exported `playgroundService`, so existing calls still
380
+ reach it). A second `mountPlayground` / `mountPlaygroundStudio` /
381
+ `mountPlaygroundApp` without an `instanceId` gets its own isolated
382
+ instance instead of sharing the default, and destroying it no longer
383
+ resets or stops the first one. The first mount still owns the default
384
+ instance, as before.
385
+ - The WebMCP approval dialog keeps the editor's skin. It mounts on `<body>`,
386
+ outside the editor, so it showed the default colours for a skinned editor;
387
+ it now carries the editor's skin scope (`FlowDropInstance.skinScope`, set by
388
+ the editor while it is mounted). Step numbers from 10 on no longer hang
389
+ outside the list: each number has its own column, sized to the widest. The
390
+ dialog also sets its own margins, fonts and list style, so a host page's
391
+ `h2`, `p`, `ol`, `li` and `label` rules no longer reshape it.
392
+
8
393
  ## [2.10.1] - 2026-10-07
9
394
 
10
395
  ### Fixed
@@ -8,6 +8,11 @@
8
8
  * 2. Assign layers based on longest path from StartNode
9
9
  * 3. Position nodes with configurable spacing
10
10
  * 4. Fan out branches vertically from BranchingNode
11
+ * 5. Align tops along chains: a node's top sits at its first predecessor's top
12
+ * (pushed down only to clear its column neighbours), and every y is on the
13
+ * grid. Node cards keep their handle centres a multiple of 20 from the top,
14
+ * so row-1-to-row-1 wiring, trigger wire and data wire alike, comes out
15
+ * straight.
11
16
  */
12
17
  import type { AgentSpecFlow } from '../../types/agentspec.js';
13
18
  /** Measured dimensions for a node */
@@ -15,6 +20,15 @@ export interface NodeDimensions {
15
20
  width: number;
16
21
  height: number;
17
22
  }
23
+ /**
24
+ * Room a node needs beside it for its workflow-interface tags, in px: `left`
25
+ * for tags of its inputs, `right` for tags of its outputs (see
26
+ * `utils/interfaceTags.ts#interfaceTagReserve`). Keyed like the dimensions.
27
+ */
28
+ export type TagReserve = Map<string, {
29
+ left: number;
30
+ right: number;
31
+ }>;
18
32
  /** Layout configuration */
19
33
  export interface AutoLayoutConfig {
20
34
  /** Minimum horizontal gap between the right edge of one layer and the left edge of the next (px) */
@@ -29,6 +43,8 @@ export interface AutoLayoutConfig {
29
43
  defaultNodeWidth: number;
30
44
  /** Fallback node height when measured dimensions are unavailable */
31
45
  defaultNodeHeight: number;
46
+ /** Every y lands on a multiple of this (px); the node cards' handle offsets are multiples of 20 */
47
+ grid: number;
32
48
  }
33
49
  /**
34
50
  * Compute node positions for an Agent Spec flow using layered layout.
@@ -37,44 +53,10 @@ export interface AutoLayoutConfig {
37
53
  * @param flow - The Agent Spec flow to layout
38
54
  * @param config - Optional layout configuration
39
55
  * @param nodeDimensions - Optional map of node name to measured {width, height}
56
+ * @param tagReserve - Optional room each node needs beside it for interface tags
40
57
  * @returns Map of node name to {x, y} position
41
58
  */
42
- export declare function computeAutoLayout(flow: AgentSpecFlow, config?: Partial<AutoLayoutConfig>, nodeDimensions?: Map<string, NodeDimensions>): Map<string, {
43
- x: number;
44
- y: number;
45
- }>;
46
- /** Input position for beautify: existing node placement */
47
- export interface NodePosition {
48
- x: number;
49
- y: number;
50
- }
51
- /** Beautify configuration */
52
- export interface BeautifyLayoutConfig {
53
- /** Minimum horizontal gap between the right edge of one column and the left edge of the next (px) */
54
- horizontalGap: number;
55
- /** Minimum vertical gap between the bottom edge of one node and the top edge of the next in the same column (px) */
56
- verticalGap: number;
57
- /** Fallback node width when measured dimensions are unavailable */
58
- defaultNodeWidth: number;
59
- /** Fallback node height when measured dimensions are unavailable */
60
- defaultNodeHeight: number;
61
- }
62
- /**
63
- * Beautify existing node positions: preserve relative column/row ordering
64
- * but apply uniform spacing based on actual node dimensions.
65
- *
66
- * Algorithm:
67
- * 1. Cluster nodes into columns by X proximity (gap threshold = median width)
68
- * 2. Sort columns left-to-right by their median X
69
- * 3. Within each column, sort nodes top-to-bottom by their original Y
70
- * 4. Re-position with uniform horizontal and vertical gaps
71
- *
72
- * @param positions - Current node positions (keyed by node id)
73
- * @param config - Optional spacing configuration
74
- * @param nodeDimensions - Optional map of node id to measured {width, height}
75
- * @returns Map of node id to new {x, y} position
76
- */
77
- export declare function computeBeautifyLayout(positions: Map<string, NodePosition>, config?: Partial<BeautifyLayoutConfig>, nodeDimensions?: Map<string, NodeDimensions>): Map<string, {
59
+ export declare function computeAutoLayout(flow: AgentSpecFlow, config?: Partial<AutoLayoutConfig>, nodeDimensions?: Map<string, NodeDimensions>, tagReserve?: TagReserve): Map<string, {
78
60
  x: number;
79
61
  y: number;
80
62
  }>;