@flowdrop/flowdrop 2.11.0 → 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 (455) hide show
  1. package/CHANGELOG.md +223 -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 +966 -226
  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 +159 -121
  29. package/dist/components/ConfigModal.svelte +11 -54
  30. package/dist/components/ConfigPanel.svelte +98 -228
  31. package/dist/components/ConfigPanel.svelte.d.ts +2 -2
  32. package/dist/components/ConnectPortPicker.svelte +153 -0
  33. package/dist/components/ConnectPortPicker.svelte.d.ts +22 -0
  34. package/dist/components/DoctorMenu.svelte +422 -0
  35. package/dist/components/DoctorMenu.svelte.d.ts +7 -0
  36. package/dist/components/ExternalLinkRow.svelte +82 -0
  37. package/dist/components/ExternalLinkRow.svelte.d.ts +14 -0
  38. package/dist/components/FlowDropEdge.svelte +52 -2
  39. package/dist/components/FlowDropEdge.svelte.d.ts +5 -1
  40. package/dist/components/InterfaceNameInput.svelte +103 -0
  41. package/dist/components/InterfaceNameInput.svelte.d.ts +13 -0
  42. package/dist/components/InterfaceTag.svelte +215 -0
  43. package/dist/components/InterfaceTag.svelte.d.ts +20 -0
  44. package/dist/components/InterfaceTagAnchor.svelte +103 -0
  45. package/dist/components/InterfaceTagAnchor.svelte.d.ts +12 -0
  46. package/dist/components/InterfaceTagLayer.svelte +314 -0
  47. package/dist/components/InterfaceTagLayer.svelte.d.ts +28 -0
  48. package/dist/components/LogsSidebar.svelte +43 -43
  49. package/dist/components/LoopbackLanes.svelte +54 -0
  50. package/dist/components/LoopbackLanes.svelte.d.ts +8 -0
  51. package/dist/components/Navbar.svelte +539 -169
  52. package/dist/components/Navbar.svelte.d.ts +20 -1
  53. package/dist/components/NodeInspector.svelte +153 -0
  54. package/dist/components/NodeInspector.svelte.d.ts +19 -0
  55. package/dist/components/NodeLastRun.svelte +212 -0
  56. package/dist/components/NodeLastRun.svelte.d.ts +13 -0
  57. package/dist/components/NodeSidebar.svelte +279 -23
  58. package/dist/components/NodeSidebar.svelte.d.ts +11 -0
  59. package/dist/components/NodeStatusOverlay.svelte +144 -353
  60. package/dist/components/NodeStatusOverlay.svelte.d.ts +4 -1
  61. package/dist/components/PortMappingRow.svelte +28 -44
  62. package/dist/components/PortPickerListbox.svelte +475 -0
  63. package/dist/components/PortPickerListbox.svelte.d.ts +73 -0
  64. package/dist/components/ReadOnlyDetails.svelte +52 -89
  65. package/dist/components/RunBar.svelte +222 -0
  66. package/dist/components/RunBar.svelte.d.ts +20 -0
  67. package/dist/components/RunsMenu.svelte +649 -0
  68. package/dist/components/RunsMenu.svelte.d.ts +14 -0
  69. package/dist/components/SettingsModal.svelte +27 -59
  70. package/dist/components/SettingsPanel.svelte +515 -241
  71. package/dist/components/StraightGuides.svelte +46 -0
  72. package/dist/components/StraightGuides.svelte.d.ts +7 -0
  73. package/dist/components/ThemeToggle.svelte +14 -4
  74. package/dist/components/UniversalNode.svelte +152 -51
  75. package/dist/components/WebMCPBridgeMenu.svelte +336 -0
  76. package/dist/components/WebMCPBridgeMenu.svelte.d.ts +3 -0
  77. package/dist/components/WorkflowEditor.svelte +789 -136
  78. package/dist/components/WorkflowEditor.svelte.d.ts +43 -1
  79. package/dist/components/WorkflowInterfaceEditor.svelte +63 -92
  80. package/dist/components/WorkflowInterfaceEntryCard.svelte +478 -549
  81. package/dist/components/WorkflowInterfaceEntryComposer.svelte +23 -67
  82. package/dist/components/WorkflowPlaygroundSettings.svelte +48 -85
  83. package/dist/components/WorkflowSettingsPanel.svelte +311 -0
  84. package/dist/components/WorkflowSettingsPanel.svelte.d.ts +20 -0
  85. package/dist/components/ZoomTier.svelte +56 -0
  86. package/dist/components/ZoomTier.svelte.d.ts +4 -0
  87. package/dist/components/chat/AIChatPanel.svelte +463 -312
  88. package/dist/components/chat/ActivityList.svelte +130 -0
  89. package/dist/components/chat/ActivityList.svelte.d.ts +11 -0
  90. package/dist/components/chat/ActivityRow.svelte +179 -0
  91. package/dist/components/chat/ActivityRow.svelte.d.ts +16 -0
  92. package/dist/components/chat/CommandPreview.svelte +42 -64
  93. package/dist/components/console/CommandConsole.svelte +106 -41
  94. package/dist/components/console/CommandConsole.svelte.d.ts +2 -0
  95. package/dist/components/console/ConsoleAutocomplete.svelte +14 -13
  96. package/dist/components/console/ConsoleInput.svelte +60 -27
  97. package/dist/components/console/ConsoleOutput.svelte +86 -24
  98. package/dist/components/console/ConsoleStrip.svelte +80 -0
  99. package/dist/components/console/ConsoleStrip.svelte.d.ts +13 -0
  100. package/dist/components/form/FieldFactory.svelte +30 -4
  101. package/dist/components/form/FormArray.svelte +306 -339
  102. package/dist/components/form/FormArray.svelte.d.ts +10 -0
  103. package/dist/components/form/FormArrayRows.svelte +443 -0
  104. package/dist/components/form/FormArrayRows.svelte.d.ts +18 -0
  105. package/dist/components/form/FormAutocomplete.svelte +2 -2
  106. package/dist/components/form/FormCheckboxGroup.svelte +10 -85
  107. package/dist/components/form/FormCodeEditor.svelte +3 -3
  108. package/dist/components/form/FormFieldWrapper.svelte +98 -18
  109. package/dist/components/form/FormFieldWrapper.svelte.d.ts +10 -0
  110. package/dist/components/form/FormFieldset.svelte +44 -28
  111. package/dist/components/form/FormMarkdownEditor.svelte +6 -6
  112. package/dist/components/form/FormPorts.svelte +437 -141
  113. package/dist/components/form/FormSelect.svelte +1 -1
  114. package/dist/components/form/FormTemplateEditor.svelte +22 -26
  115. package/dist/components/form/FormToggle.svelte +15 -106
  116. package/dist/components/form/FormToggle.svelte.d.ts +3 -2
  117. package/dist/components/form/FormUISchemaRenderer.svelte +38 -3
  118. package/dist/components/form/humanizeKey.d.ts +7 -0
  119. package/dist/components/form/humanizeKey.js +21 -0
  120. package/dist/components/form/types.d.ts +6 -0
  121. package/dist/components/icons/MenuOpenIcon.svelte +8 -1
  122. package/dist/components/interrupt/ChoicePrompt.svelte +51 -152
  123. package/dist/components/interrupt/ChoicePrompt.svelte.d.ts +0 -2
  124. package/dist/components/interrupt/ConfirmationPrompt.svelte +18 -201
  125. package/dist/components/interrupt/ConfirmationPrompt.svelte.d.ts +0 -4
  126. package/dist/components/interrupt/FormPrompt.svelte +22 -147
  127. package/dist/components/interrupt/FormPrompt.svelte.d.ts +0 -4
  128. package/dist/components/interrupt/InterruptBubble.svelte +198 -355
  129. package/dist/components/interrupt/InterruptBubble.svelte.d.ts +0 -2
  130. package/dist/components/interrupt/ReviewPrompt.svelte +0 -10
  131. package/dist/components/interrupt/TextInputPrompt.svelte +23 -120
  132. package/dist/components/interrupt/TextInputPrompt.svelte.d.ts +0 -2
  133. package/dist/components/layouts/MainLayout.svelte +110 -75
  134. package/dist/components/layouts/MainLayout.svelte.d.ts +17 -0
  135. package/dist/components/nodes/CaptionNode.svelte +7 -0
  136. package/dist/components/nodes/GatewayNode.svelte +66 -431
  137. package/dist/components/nodes/IdeaNode.svelte +6 -5
  138. package/dist/components/nodes/NodeCard.svelte +1051 -0
  139. package/dist/components/nodes/NodeCard.svelte.d.ts +30 -0
  140. package/dist/components/nodes/NodeConfigButton.svelte +28 -9
  141. package/dist/components/nodes/NodeProblemMark.svelte +113 -0
  142. package/dist/components/nodes/NodeProblemMark.svelte.d.ts +8 -0
  143. package/dist/components/nodes/NodeTip.svelte +104 -0
  144. package/dist/components/nodes/NodeTip.svelte.d.ts +15 -0
  145. package/dist/components/nodes/NotesNode.svelte +183 -150
  146. package/dist/components/nodes/SimpleNode.svelte +176 -44
  147. package/dist/components/nodes/SquareNode.svelte +127 -34
  148. package/dist/components/nodes/TerminalNode.svelte +232 -88
  149. package/dist/components/nodes/ToolNode.svelte +49 -381
  150. package/dist/components/nodes/WorkflowNode.svelte +40 -399
  151. package/dist/components/playground/ChatBubble.svelte +248 -62
  152. package/dist/components/playground/ChatInput.svelte +134 -297
  153. package/dist/components/playground/ChatInput.svelte.d.ts +17 -0
  154. package/dist/components/playground/ControlPanel.svelte +290 -190
  155. package/dist/components/playground/ControlPanel.svelte.d.ts +10 -2
  156. package/dist/components/playground/DockedPlayground.svelte +75 -0
  157. package/dist/components/playground/DockedPlayground.svelte.d.ts +24 -0
  158. package/dist/components/playground/ExecutionConsole.svelte +54 -36
  159. package/dist/components/playground/ExecutionConsole.svelte.d.ts +12 -0
  160. package/dist/components/playground/ExecutionLogs.svelte +4 -0
  161. package/dist/components/playground/HeaderMenu.svelte +170 -0
  162. package/dist/components/playground/HeaderMenu.svelte.d.ts +22 -0
  163. package/dist/components/playground/InputCollector.svelte +8 -32
  164. package/dist/components/playground/InputFields.svelte +246 -0
  165. package/dist/components/playground/InputFields.svelte.d.ts +16 -0
  166. package/dist/components/playground/InterfaceInputForm.svelte +285 -30
  167. package/dist/components/playground/InterfaceInputForm.svelte.d.ts +20 -0
  168. package/dist/components/playground/InterfaceJsonInput.svelte +92 -0
  169. package/dist/components/playground/InterfaceJsonInput.svelte.d.ts +10 -0
  170. package/dist/components/playground/LogRow.svelte +12 -12
  171. package/dist/components/playground/MessageMarkdown.svelte +11 -11
  172. package/dist/components/playground/MessageStream.svelte +154 -182
  173. package/dist/components/playground/Playground.svelte +17 -1139
  174. package/dist/components/playground/PlaygroundApp.svelte +12 -2
  175. package/dist/components/playground/PlaygroundApp.svelte.d.ts +2 -1
  176. package/dist/components/playground/PlaygroundHeader.svelte +309 -0
  177. package/dist/components/playground/PlaygroundHeader.svelte.d.ts +22 -0
  178. package/dist/components/playground/PlaygroundModal.svelte +6 -0
  179. package/dist/components/playground/PlaygroundStudio.svelte +30 -32
  180. package/dist/components/playground/PlaygroundSurface.svelte +648 -0
  181. package/dist/components/playground/PlaygroundSurface.svelte.d.ts +79 -0
  182. package/dist/components/playground/StepsSummary.svelte +312 -0
  183. package/dist/components/playground/StepsSummary.svelte.d.ts +11 -0
  184. package/dist/components/playground/messageDisplay.d.ts +9 -0
  185. package/dist/components/playground/messageDisplay.js +24 -2
  186. package/dist/components/playground/stepSummary.d.ts +71 -0
  187. package/dist/components/playground/stepSummary.js +152 -0
  188. package/dist/components/ports/PortTypeBadge.svelte +13 -1
  189. package/dist/components/primitives/Button.svelte +226 -0
  190. package/dist/components/primitives/Button.svelte.d.ts +31 -0
  191. package/dist/components/primitives/Card.svelte +110 -0
  192. package/dist/components/primitives/Card.svelte.d.ts +20 -0
  193. package/dist/components/primitives/Checkbox.svelte +126 -0
  194. package/dist/components/primitives/Checkbox.svelte.d.ts +15 -0
  195. package/dist/components/primitives/Chip.svelte +143 -0
  196. package/dist/components/primitives/Chip.svelte.d.ts +22 -0
  197. package/dist/components/primitives/Combobox.svelte +444 -0
  198. package/dist/components/primitives/Combobox.svelte.d.ts +22 -0
  199. package/dist/components/primitives/Composer.svelte +293 -0
  200. package/dist/components/primitives/Composer.svelte.d.ts +47 -0
  201. package/dist/components/primitives/EmptyState.svelte +113 -0
  202. package/dist/components/primitives/EmptyState.svelte.d.ts +18 -0
  203. package/dist/components/primitives/Field.svelte +178 -0
  204. package/dist/components/primitives/Field.svelte.d.ts +30 -0
  205. package/dist/components/primitives/IconButton.svelte +156 -0
  206. package/dist/components/primitives/IconButton.svelte.d.ts +27 -0
  207. package/dist/components/primitives/Menu.svelte +435 -0
  208. package/dist/components/primitives/Menu.svelte.d.ts +61 -0
  209. package/dist/components/primitives/Notice.svelte +161 -0
  210. package/dist/components/primitives/Notice.svelte.d.ts +22 -0
  211. package/dist/components/primitives/PanelHeader.svelte +134 -0
  212. package/dist/components/primitives/PanelHeader.svelte.d.ts +23 -0
  213. package/dist/components/primitives/Segmented.svelte +198 -0
  214. package/dist/components/primitives/Segmented.svelte.d.ts +32 -0
  215. package/dist/components/primitives/Select.svelte +130 -0
  216. package/dist/components/primitives/Select.svelte.d.ts +26 -0
  217. package/dist/components/primitives/StatusPill.svelte +218 -0
  218. package/dist/components/primitives/StatusPill.svelte.d.ts +24 -0
  219. package/dist/components/primitives/Switch.svelte +113 -0
  220. package/dist/components/primitives/Switch.svelte.d.ts +14 -0
  221. package/dist/components/primitives/Tabs.svelte +209 -0
  222. package/dist/components/primitives/Tabs.svelte.d.ts +32 -0
  223. package/dist/components/primitives/Toolbar.svelte +94 -0
  224. package/dist/components/primitives/Toolbar.svelte.d.ts +14 -0
  225. package/dist/components/primitives/ToolbarSeparator.svelte +40 -0
  226. package/dist/components/primitives/ToolbarSeparator.svelte.d.ts +7 -0
  227. package/dist/components/surfaces/SurfaceOverlay.svelte +10 -40
  228. package/dist/components/surfaces/TabbedSurface.svelte +49 -39
  229. package/dist/components/surfaces/TabbedSurface.svelte.d.ts +8 -0
  230. package/dist/components/toast/DismissibleToast.svelte +94 -32
  231. package/dist/components/toast/DismissibleToast.svelte.d.ts +17 -7
  232. package/dist/config/endpoints.d.ts +43 -1
  233. package/dist/config/endpoints.js +21 -3
  234. package/dist/core/index.d.ts +8 -5
  235. package/dist/core/index.js +1 -1
  236. package/dist/editor/connectCandidates.d.ts +56 -0
  237. package/dist/editor/connectCandidates.js +131 -0
  238. package/dist/editor/contextMenu.d.ts +31 -2
  239. package/dist/editor/contextMenu.js +96 -9
  240. package/dist/editor/index.d.ts +3 -1
  241. package/dist/editor/index.js +1 -0
  242. package/dist/editor/interfaceMenu.d.ts +35 -0
  243. package/dist/editor/interfaceMenu.js +47 -0
  244. package/dist/editor/portMenu.d.ts +23 -0
  245. package/dist/editor/portMenu.js +34 -0
  246. package/dist/editor/tidy.d.ts +30 -0
  247. package/dist/editor/tidy.js +66 -0
  248. package/dist/helpers/workflowEditorHelper.d.ts +3 -0
  249. package/dist/helpers/workflowEditorHelper.js +8 -3
  250. package/dist/layout/fromWorkflow.d.ts +42 -0
  251. package/dist/layout/fromWorkflow.js +135 -0
  252. package/dist/layout/geometry.d.ts +102 -0
  253. package/dist/layout/geometry.js +317 -0
  254. package/dist/layout/index.d.ts +21 -0
  255. package/dist/layout/index.js +14 -0
  256. package/dist/layout/inspect.d.ts +18 -0
  257. package/dist/layout/inspect.js +81 -0
  258. package/dist/layout/lanePath.d.ts +23 -0
  259. package/dist/layout/lanePath.js +47 -0
  260. package/dist/layout/measure.d.ts +141 -0
  261. package/dist/layout/measure.js +477 -0
  262. package/dist/layout/primitives.d.ts +124 -0
  263. package/dist/layout/primitives.js +461 -0
  264. package/dist/layout/sweep.d.ts +59 -0
  265. package/dist/layout/sweep.js +257 -0
  266. package/dist/layout/toWorkflow.d.ts +43 -0
  267. package/dist/layout/toWorkflow.js +131 -0
  268. package/dist/layout/types.d.ts +93 -0
  269. package/dist/layout/types.js +35 -0
  270. package/dist/messages/defaults.d.ts +641 -26
  271. package/dist/messages/defaults.js +578 -25
  272. package/dist/messages/types.d.ts +21 -1
  273. package/dist/openapi/v1/openapi.yaml +109 -0
  274. package/dist/playground/index.d.ts +28 -1
  275. package/dist/playground/index.js +29 -0
  276. package/dist/playground/mount.d.ts +28 -2
  277. package/dist/playground/mount.js +41 -15
  278. package/dist/playground/runAction.d.ts +29 -0
  279. package/dist/playground/runAction.js +38 -0
  280. package/dist/services/doctorService.d.ts +52 -0
  281. package/dist/services/doctorService.js +113 -0
  282. package/dist/services/globalSave.js +12 -29
  283. package/dist/services/nodeExecutionService.d.ts +12 -1
  284. package/dist/services/nodeExecutionService.js +58 -58
  285. package/dist/services/playgroundService.d.ts +17 -2
  286. package/dist/services/playgroundService.js +48 -5
  287. package/dist/services/runsService.d.ts +42 -0
  288. package/dist/services/runsService.js +87 -0
  289. package/dist/services/toastQueue.d.ts +33 -0
  290. package/dist/services/toastQueue.js +38 -0
  291. package/dist/services/toastService.d.ts +30 -9
  292. package/dist/services/toastService.js +81 -46
  293. package/dist/settings/index.d.ts +1 -0
  294. package/dist/skins/graphite.d.ts +26 -0
  295. package/dist/skins/graphite.js +473 -0
  296. package/dist/skins/index.d.ts +2 -1
  297. package/dist/skins/index.js +4 -2
  298. package/dist/skins/slate.js +4 -4
  299. package/dist/stores/attachedRunStore.svelte.d.ts +35 -0
  300. package/dist/stores/attachedRunStore.svelte.js +47 -0
  301. package/dist/stores/connectDragStore.svelte.d.ts +39 -0
  302. package/dist/stores/connectDragStore.svelte.js +42 -0
  303. package/dist/stores/doctorStore.svelte.d.ts +79 -0
  304. package/dist/stores/doctorStore.svelte.js +244 -0
  305. package/dist/stores/editedNodesStore.svelte.d.ts +42 -0
  306. package/dist/stores/editedNodesStore.svelte.js +84 -0
  307. package/dist/stores/editorModeStore.svelte.d.ts +34 -0
  308. package/dist/stores/editorModeStore.svelte.js +55 -0
  309. package/dist/stores/instanceContainer.svelte.d.ts +53 -0
  310. package/dist/stores/instanceContainer.svelte.js +38 -1
  311. package/dist/stores/loopbackLanesStore.svelte.d.ts +18 -0
  312. package/dist/stores/loopbackLanesStore.svelte.js +25 -0
  313. package/dist/stores/nodeHighlightStore.svelte.d.ts +34 -0
  314. package/dist/stores/nodeHighlightStore.svelte.js +56 -0
  315. package/dist/stores/playgroundStore.svelte.d.ts +66 -2
  316. package/dist/stores/playgroundStore.svelte.js +164 -2
  317. package/dist/stores/runController.svelte.d.ts +382 -0
  318. package/dist/stores/runController.svelte.js +1217 -0
  319. package/dist/stores/settingsStore.svelte.d.ts +80 -18
  320. package/dist/stores/settingsStore.svelte.js +180 -62
  321. package/dist/stores/workflowStore.svelte.d.ts +14 -0
  322. package/dist/stores/workflowStore.svelte.js +22 -1
  323. package/dist/styles/base.css +286 -25
  324. package/dist/styles/fonts/Inter-LICENSE.txt +93 -0
  325. package/dist/styles/fonts/inter-latin-wght-normal.woff2 +0 -0
  326. package/dist/styles/fonts/inter.css +19 -0
  327. package/dist/styles/toast.css +100 -20
  328. package/dist/styles/tokenAliases.js +118 -1
  329. package/dist/styles/tokens.css +586 -14
  330. package/dist/svelte-app.d.ts +38 -5
  331. package/dist/svelte-app.js +14 -3
  332. package/dist/themes/graphite.d.ts +2 -0
  333. package/dist/themes/graphite.js +15 -0
  334. package/dist/themes/index.d.ts +2 -1
  335. package/dist/themes/index.js +22 -3
  336. package/dist/themes/minimal.js +10 -0
  337. package/dist/themes/scopedSkinCss.d.ts +22 -5
  338. package/dist/themes/scopedSkinCss.js +136 -11
  339. package/dist/types/chat.d.ts +6 -0
  340. package/dist/types/doctor.d.ts +82 -0
  341. package/dist/types/doctor.js +11 -0
  342. package/dist/types/events.d.ts +35 -0
  343. package/dist/types/events.js +4 -1
  344. package/dist/types/index.d.ts +17 -2
  345. package/dist/types/navbar.d.ts +36 -0
  346. package/dist/types/playground.d.ts +66 -0
  347. package/dist/types/settings.d.ts +120 -7
  348. package/dist/types/settings.js +35 -3
  349. package/dist/types/skin.d.ts +21 -8
  350. package/dist/types/theme.d.ts +40 -2
  351. package/dist/utils/appearance.d.ts +19 -0
  352. package/dist/utils/appearance.js +13 -0
  353. package/dist/utils/canvasFit.d.ts +41 -0
  354. package/dist/utils/canvasFit.js +44 -0
  355. package/dist/utils/chipTitles.d.ts +9 -0
  356. package/dist/utils/chipTitles.js +19 -0
  357. package/dist/utils/connections.js +8 -0
  358. package/dist/utils/consoleHighlight.d.ts +28 -0
  359. package/dist/utils/consoleHighlight.js +269 -0
  360. package/dist/utils/deprecation.d.ts +17 -0
  361. package/dist/utils/deprecation.js +29 -0
  362. package/dist/utils/doctorOperations.d.ts +40 -0
  363. package/dist/utils/doctorOperations.js +237 -0
  364. package/dist/utils/duration.d.ts +13 -0
  365. package/dist/utils/duration.js +40 -0
  366. package/dist/utils/inspectorContext.d.ts +19 -0
  367. package/dist/utils/inspectorContext.js +12 -0
  368. package/dist/utils/inspectorSections.d.ts +20 -0
  369. package/dist/utils/inspectorSections.js +44 -0
  370. package/dist/utils/inspectorSurface.d.ts +46 -0
  371. package/dist/utils/inspectorSurface.js +51 -0
  372. package/dist/utils/interfaceTags.d.ts +102 -0
  373. package/dist/utils/interfaceTags.js +211 -0
  374. package/dist/utils/itemRef.d.ts +86 -0
  375. package/dist/utils/itemRef.js +106 -0
  376. package/dist/utils/lastRun.d.ts +35 -0
  377. package/dist/utils/lastRun.js +73 -0
  378. package/dist/utils/messageNodeLink.d.ts +17 -0
  379. package/dist/utils/messageNodeLink.js +16 -0
  380. package/dist/utils/minimapVisibility.d.ts +28 -0
  381. package/dist/utils/minimapVisibility.js +34 -0
  382. package/dist/utils/nodeAriaLabel.d.ts +12 -0
  383. package/dist/utils/nodeAriaLabel.js +17 -0
  384. package/dist/utils/nodeFingerprint.d.ts +27 -0
  385. package/dist/utils/nodeFingerprint.js +66 -0
  386. package/dist/utils/nodeFormSchema.d.ts +10 -0
  387. package/dist/utils/nodeFormSchema.js +2 -2
  388. package/dist/utils/nodeGeometry.d.ts +168 -0
  389. package/dist/utils/nodeGeometry.js +204 -0
  390. package/dist/utils/nodeProblem.d.ts +19 -0
  391. package/dist/utils/nodeProblem.js +9 -0
  392. package/dist/utils/nodeStatus.d.ts +38 -3
  393. package/dist/utils/nodeStatus.js +67 -39
  394. package/dist/utils/nodeSwap.js +9 -1
  395. package/dist/utils/nodeWrapper.d.ts +1 -0
  396. package/dist/utils/playgroundHistory.d.ts +48 -0
  397. package/dist/utils/playgroundHistory.js +38 -0
  398. package/dist/utils/playgroundInputRuns.d.ts +26 -0
  399. package/dist/utils/playgroundInputRuns.js +50 -0
  400. package/dist/utils/portExposure.d.ts +49 -0
  401. package/dist/utils/portExposure.js +122 -0
  402. package/dist/utils/portUtils.d.ts +16 -0
  403. package/dist/utils/portUtils.js +37 -0
  404. package/dist/utils/portal.d.ts +0 -19
  405. package/dist/utils/portal.js +8 -1
  406. package/dist/utils/reservedPorts.d.ts +59 -0
  407. package/dist/utils/reservedPorts.js +60 -0
  408. package/dist/utils/runEdges.d.ts +24 -0
  409. package/dist/utils/runEdges.js +35 -0
  410. package/dist/utils/runsList.d.ts +69 -0
  411. package/dist/utils/runsList.js +134 -0
  412. package/dist/utils/selectOptions.d.ts +62 -0
  413. package/dist/utils/selectOptions.js +137 -0
  414. package/dist/utils/sessionRuns.d.ts +62 -0
  415. package/dist/utils/sessionRuns.js +123 -0
  416. package/dist/utils/sheetWidths.d.ts +29 -0
  417. package/dist/utils/sheetWidths.js +41 -0
  418. package/dist/utils/sidebarWidths.d.ts +34 -0
  419. package/dist/utils/sidebarWidths.js +47 -0
  420. package/dist/utils/straightWires.d.ts +73 -0
  421. package/dist/utils/straightWires.js +99 -0
  422. package/dist/utils/themeScope.svelte.d.ts +10 -0
  423. package/dist/utils/themeScope.svelte.js +80 -0
  424. package/dist/utils/wiredHandles.d.ts +10 -0
  425. package/dist/utils/wiredHandles.js +14 -0
  426. package/dist/utils/workflowDraft.d.ts +9 -0
  427. package/dist/utils/workflowDraft.js +39 -0
  428. package/dist/utils/workflowInterface.d.ts +40 -7
  429. package/dist/utils/workflowInterface.js +66 -16
  430. package/dist/utils/zoomTier.d.ts +43 -0
  431. package/dist/utils/zoomTier.js +107 -0
  432. package/dist/utils/zoomTierRows.d.ts +41 -0
  433. package/dist/utils/zoomTierRows.js +103 -0
  434. package/dist/webmcp/WebMCPConfirm.svelte +1 -1
  435. package/dist/webmcp/bridge.d.ts +5 -0
  436. package/dist/webmcp/bridge.js +8 -0
  437. package/dist/webmcp/bridgeController.svelte.d.ts +84 -0
  438. package/dist/webmcp/bridgeController.svelte.js +224 -0
  439. package/dist/webmcp/descriptors.d.ts +1 -1
  440. package/dist/webmcp/descriptors.js +66 -5
  441. package/dist/webmcp/fakeWidget.d.ts +34 -0
  442. package/dist/webmcp/fakeWidget.js +75 -0
  443. package/dist/webmcp/gate.js +4 -0
  444. package/dist/webmcp/index.d.ts +2 -0
  445. package/dist/webmcp/index.js +1 -0
  446. package/dist/webmcp/runtime.js +4 -1
  447. package/dist/webmcp/types.d.ts +2 -0
  448. package/dist/webmcp/validate.js +5 -1
  449. package/package.json +8 -2
  450. package/dist/components/Select.svelte +0 -53
  451. package/dist/components/Select.svelte.d.ts +0 -15
  452. package/dist/components/icons/CommandLineIcon.svelte +0 -15
  453. package/dist/components/icons/CommandLineIcon.svelte.d.ts +0 -26
  454. package/dist/components/toast/WarningIcon.svelte +0 -28
  455. package/dist/components/toast/WarningIcon.svelte.d.ts +0 -26
@@ -0,0 +1,106 @@
1
+ /**
2
+ * Item references: a scalar config field that names an item of an array field
3
+ * in the same config, declared with the `x-item-ref` schema hint:
4
+ *
5
+ * ```json
6
+ * "default_branch": { "type": "string", "x-item-ref": { "array": "branches", "key": "name" } }
7
+ * ```
8
+ *
9
+ * The form does not render such a field on its own. The referenced array shows
10
+ * the reference as a "default" mark on the matching row instead, and keeps the
11
+ * reference in step with the items (rename follows, delete clears). Nothing here
12
+ * is specific to one node type; the storage stays the plain scalar field.
13
+ *
14
+ * Matching is case-insensitive and trimmed, like the runtime's branch matching,
15
+ * so a stored `default` still marks a branch named `Default`.
16
+ */
17
+ import { buildHandleId } from './handleIds.js';
18
+ /** Read the hint off a field schema; undefined when absent or malformed. */
19
+ export function parseItemRef(schema) {
20
+ if (!schema || typeof schema !== 'object')
21
+ return undefined;
22
+ const hint = schema['x-item-ref'];
23
+ if (!hint || typeof hint !== 'object')
24
+ return undefined;
25
+ const { array, key } = hint;
26
+ if (typeof array !== 'string' || !array || typeof key !== 'string' || !key)
27
+ return undefined;
28
+ return { array, key };
29
+ }
30
+ /** The scalar field (if any) that references `arrayKey` through `x-item-ref`. */
31
+ export function findItemRefField(properties, arrayKey) {
32
+ for (const [field, schema] of Object.entries(properties ?? {})) {
33
+ const hint = parseItemRef(schema);
34
+ if (hint && hint.array === arrayKey)
35
+ return { field, hint };
36
+ }
37
+ return undefined;
38
+ }
39
+ const normalize = (value) => (typeof value === 'string' ? value.trim() : '');
40
+ function itemName(item, key) {
41
+ if (!item || typeof item !== 'object')
42
+ return '';
43
+ return normalize(item[key]);
44
+ }
45
+ /** Index of the first item the reference names (case-insensitive), or -1. */
46
+ export function matchItemIndex(items, key, ref) {
47
+ const target = normalize(ref).toLowerCase();
48
+ if (!target)
49
+ return -1;
50
+ return items.findIndex((item) => itemName(item, key).toLowerCase() === target);
51
+ }
52
+ /** Classify a reference against its items. */
53
+ export function itemRefStatus(items, key, ref, wired = false) {
54
+ if (wired)
55
+ return 'wired';
56
+ if (!normalize(ref))
57
+ return 'empty';
58
+ return matchItemIndex(items, key, ref) >= 0 ? 'marked' : 'dangling';
59
+ }
60
+ /**
61
+ * The reference after the item at `index` was renamed.
62
+ *
63
+ * The marked row's new name becomes the reference. Emptying that name clears the
64
+ * reference (nothing matches an empty name) but remembers the row in `pending`,
65
+ * so typing a new name over it keeps the mark. Renaming any other row leaves the
66
+ * reference alone, whatever the new name is.
67
+ */
68
+ export function refAfterRename(items, key, ref, index, newName, pending = null) {
69
+ const current = typeof ref === 'string' ? ref : '';
70
+ const marked = matchItemIndex(items, key, ref) === index || (pending === index && !current);
71
+ if (!marked)
72
+ return { ref: current, pending };
73
+ return normalize(newName) ? { ref: newName, pending: null } : { ref: '', pending: index };
74
+ }
75
+ /**
76
+ * The reference after the item at `index` was deleted: cleared when that item
77
+ * was the marked one, otherwise unchanged.
78
+ */
79
+ export function refAfterDelete(items, key, ref, index) {
80
+ const current = typeof ref === 'string' ? ref : '';
81
+ return matchItemIndex(items, key, ref) === index ? '' : current;
82
+ }
83
+ /** Whether some edge feeds the node's input port named `field`. */
84
+ export function isFieldWired(nodeId, edges, field) {
85
+ if (!nodeId || !edges?.length)
86
+ return false;
87
+ const handle = buildHandleId(nodeId, 'input', field);
88
+ return edges.some((edge) => edge.targetHandle === handle);
89
+ }
90
+ /**
91
+ * The reference for the array at `arrayKey`, when a sibling field points at it,
92
+ * ready to hand to the array field; undefined otherwise.
93
+ */
94
+ export function buildItemRef(properties, arrayKey, values, isWired, onFieldChange) {
95
+ const found = findItemRefField(properties, arrayKey);
96
+ if (!found)
97
+ return undefined;
98
+ const raw = values[found.field];
99
+ return {
100
+ field: found.field,
101
+ key: found.hint.key,
102
+ value: typeof raw === 'string' ? raw : '',
103
+ wired: isWired(found.field),
104
+ onChange: (value) => onFieldChange(found.field, value)
105
+ };
106
+ }
@@ -0,0 +1,35 @@
1
+ /**
2
+ * The inspector's Last run tab, as data: what a node did in the run being
3
+ * shown, drawn from the node's execution info (`fd.playground.nodeStatusFor`).
4
+ *
5
+ * A node that ran several times in the run (a loop) shows its last execution
6
+ * and says how many there were. Fields the backend does not send are left out,
7
+ * so the view shows only facts it has.
8
+ */
9
+ import type { NodeExecutionInfo, NodeExecutionStatus } from '../types/index.js';
10
+ export interface LastRunView {
11
+ status: NodeExecutionStatus;
12
+ /** How many times the node executed in this run. */
13
+ executions: number;
14
+ durationLabel: string | null;
15
+ /** ISO timestamps of the last execution. */
16
+ started: string | null;
17
+ completed: string | null;
18
+ tokens: number | null;
19
+ input: string | null;
20
+ output: string | null;
21
+ error: string | null;
22
+ }
23
+ /** A node that has not run in the shown run (or is only waiting to). */
24
+ export declare function hasRun(info: NodeExecutionInfo | undefined): info is NodeExecutionInfo;
25
+ /** Text for a payload value: strings as they are, anything else as indented JSON. */
26
+ export declare function stringifyPayload(value: unknown): string | null;
27
+ /**
28
+ * Token count, if the node's output reports one. Looks for the shapes model
29
+ * nodes use: `tokens`, `total_tokens`, `usage.total_tokens`, or
30
+ * `usage.{input,output}_tokens` (also `prompt`/`completion`). Returns null
31
+ * when there is none: the API has no dedicated field for it.
32
+ */
33
+ export declare function extractTokens(output: unknown): number | null;
34
+ /** The Last run view of one node, or null when it has not run. */
35
+ export declare function describeLastRun(info: NodeExecutionInfo | undefined): LastRunView | null;
@@ -0,0 +1,73 @@
1
+ /**
2
+ * The inspector's Last run tab, as data: what a node did in the run being
3
+ * shown, drawn from the node's execution info (`fd.playground.nodeStatusFor`).
4
+ *
5
+ * A node that ran several times in the run (a loop) shows its last execution
6
+ * and says how many there were. Fields the backend does not send are left out,
7
+ * so the view shows only facts it has.
8
+ */
9
+ import { formatStepDuration } from './duration.js';
10
+ /** A node that has not run in the shown run (or is only waiting to). */
11
+ export function hasRun(info) {
12
+ return !!info && info.status !== 'idle' && info.status !== 'pending';
13
+ }
14
+ /** Text for a payload value: strings as they are, anything else as indented JSON. */
15
+ export function stringifyPayload(value) {
16
+ if (value === undefined || value === null || value === '')
17
+ return null;
18
+ if (typeof value === 'string')
19
+ return value;
20
+ try {
21
+ return JSON.stringify(value, null, 2);
22
+ }
23
+ catch {
24
+ return String(value);
25
+ }
26
+ }
27
+ /**
28
+ * Token count, if the node's output reports one. Looks for the shapes model
29
+ * nodes use: `tokens`, `total_tokens`, `usage.total_tokens`, or
30
+ * `usage.{input,output}_tokens` (also `prompt`/`completion`). Returns null
31
+ * when there is none: the API has no dedicated field for it.
32
+ */
33
+ export function extractTokens(output) {
34
+ const num = (v) => typeof v === 'number' && Number.isFinite(v) && v >= 0 ? v : null;
35
+ const walk = (value, depth) => {
36
+ if (!value || typeof value !== 'object' || depth > 2)
37
+ return null;
38
+ const o = value;
39
+ const direct = num(o.total_tokens) ?? num(o.totalTokens) ?? num(o.tokens);
40
+ if (direct !== null)
41
+ return direct;
42
+ const parts = [
43
+ num(o.input_tokens) ?? num(o.prompt_tokens),
44
+ num(o.output_tokens) ?? num(o.completion_tokens)
45
+ ].filter((n) => n !== null);
46
+ if (parts.length > 0)
47
+ return parts.reduce((a, b) => a + b, 0);
48
+ return walk(o.usage, depth + 1) ?? walk(o.metadata, depth + 1);
49
+ };
50
+ return walk(output, 0);
51
+ }
52
+ /** The Last run view of one node, or null when it has not run. */
53
+ export function describeLastRun(info) {
54
+ if (!hasRun(info))
55
+ return null;
56
+ const job = info.jobs?.[info.jobs.length - 1];
57
+ const ms = job?.executionTime ?? info.lastExecutionDuration;
58
+ const us = job?.executionTimeUs ??
59
+ info.lastExecutionDurationUs ??
60
+ (ms !== undefined ? ms * 1000 : undefined);
61
+ const output = job?.output ?? info.output;
62
+ return {
63
+ status: info.status,
64
+ executions: Math.max(info.executionCount, info.jobs?.length ?? 0, 1),
65
+ durationLabel: formatStepDuration(us === undefined ? undefined : us / 1000),
66
+ started: job?.started ?? null,
67
+ completed: job?.completed ?? info.lastExecuted ?? null,
68
+ tokens: extractTokens(output),
69
+ input: stringifyPayload(job?.input),
70
+ output: stringifyPayload(output),
71
+ error: job?.error ?? info.lastError ?? null
72
+ };
73
+ }
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Which node, if any, a Playground message can link to.
3
+ *
4
+ * The server names the node a message came from in `message.nodeId`. The link
5
+ * is only real when that node is on the canvas now, so a node deleted since the
6
+ * run leaves a plain label, never a link that goes nowhere. A message from a
7
+ * sub-workflow (`parentPipelineId` set) names a node of the *child* workflow,
8
+ * which this canvas does not show, so it never links either.
9
+ */
10
+ export interface LinkableMessage {
11
+ nodeId?: string | null;
12
+ parentPipelineId?: string | null;
13
+ }
14
+ /** The node id to link to, or `null` when the message should render plain. */
15
+ export declare function resolveMessageNodeLink(message: LinkableMessage, nodes: readonly {
16
+ id: string;
17
+ }[] | undefined | null): string | null;
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Which node, if any, a Playground message can link to.
3
+ *
4
+ * The server names the node a message came from in `message.nodeId`. The link
5
+ * is only real when that node is on the canvas now, so a node deleted since the
6
+ * run leaves a plain label, never a link that goes nowhere. A message from a
7
+ * sub-workflow (`parentPipelineId` set) names a node of the *child* workflow,
8
+ * which this canvas does not show, so it never links either.
9
+ */
10
+ /** The node id to link to, or `null` when the message should render plain. */
11
+ export function resolveMessageNodeLink(message, nodes) {
12
+ const id = message.nodeId;
13
+ if (!id || message.parentPipelineId)
14
+ return null;
15
+ return nodes?.some((node) => node.id === id) ? id : null;
16
+ }
@@ -0,0 +1,28 @@
1
+ /**
2
+ * Minimap sizing and visibility rules for the editor canvas.
3
+ *
4
+ * The minimap is a 120×72 panel in the canvas's bottom-right corner. On a canvas
5
+ * narrower than {@link MINIMAP_MIN_CANVAS_WIDTH} it would cover too much of the
6
+ * graph, so it is hidden there, whatever the user's "show minimap" setting says.
7
+ * The setting can still switch it off on a wide canvas.
8
+ */
9
+ /** Minimap outer width in px (border included). */
10
+ export declare const MINIMAP_WIDTH = 120;
11
+ /** Minimap outer height in px (border included). */
12
+ export declare const MINIMAP_HEIGHT = 72;
13
+ /**
14
+ * Width of the minimap's border on each side (see base.css). xyflow's `width` /
15
+ * `height` props size the inner SVG, so the border is taken off to land on the
16
+ * outer 120×72.
17
+ */
18
+ export declare const MINIMAP_BORDER = 1;
19
+ /** Canvases narrower than this (px) do not show the minimap. */
20
+ export declare const MINIMAP_MIN_CANVAS_WIDTH = 800;
21
+ /**
22
+ * Whether to render the minimap.
23
+ *
24
+ * @param enabled - The user's `showMinimap` editor setting.
25
+ * @param canvasWidth - Measured width of the canvas element in px; `undefined`
26
+ * before the first measurement, when the setting alone decides.
27
+ */
28
+ export declare function shouldShowMinimap(enabled: boolean, canvasWidth: number | undefined): boolean;
@@ -0,0 +1,34 @@
1
+ /**
2
+ * Minimap sizing and visibility rules for the editor canvas.
3
+ *
4
+ * The minimap is a 120×72 panel in the canvas's bottom-right corner. On a canvas
5
+ * narrower than {@link MINIMAP_MIN_CANVAS_WIDTH} it would cover too much of the
6
+ * graph, so it is hidden there, whatever the user's "show minimap" setting says.
7
+ * The setting can still switch it off on a wide canvas.
8
+ */
9
+ /** Minimap outer width in px (border included). */
10
+ export const MINIMAP_WIDTH = 120;
11
+ /** Minimap outer height in px (border included). */
12
+ export const MINIMAP_HEIGHT = 72;
13
+ /**
14
+ * Width of the minimap's border on each side (see base.css). xyflow's `width` /
15
+ * `height` props size the inner SVG, so the border is taken off to land on the
16
+ * outer 120×72.
17
+ */
18
+ export const MINIMAP_BORDER = 1;
19
+ /** Canvases narrower than this (px) do not show the minimap. */
20
+ export const MINIMAP_MIN_CANVAS_WIDTH = 800;
21
+ /**
22
+ * Whether to render the minimap.
23
+ *
24
+ * @param enabled - The user's `showMinimap` editor setting.
25
+ * @param canvasWidth - Measured width of the canvas element in px; `undefined`
26
+ * before the first measurement, when the setting alone decides.
27
+ */
28
+ export function shouldShowMinimap(enabled, canvasWidth) {
29
+ if (!enabled)
30
+ return false;
31
+ if (canvasWidth === undefined)
32
+ return true;
33
+ return canvasWidth >= MINIMAP_MIN_CANVAS_WIDTH;
34
+ }
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Accessible name for a canvas node. It goes on xyflow's focusable node
3
+ * wrapper (`Node.ariaLabel`), the only element that is focusable and carries a
4
+ * role; the visual node components inside stay unnamed.
5
+ */
6
+ import type { Messages } from '../messages/types.js';
7
+ /**
8
+ * @param graph - The `nodes.graph` branch of the active messages
9
+ * @param componentName - Resolved node component name (e.g. `gatewayNode`)
10
+ * @param title - The node's display title
11
+ */
12
+ export declare function nodeAriaLabel(graph: Messages['nodes']['graph'], componentName: string, title: string): string;
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Accessible name for a canvas node. It goes on xyflow's focusable node
3
+ * wrapper (`Node.ariaLabel`), the only element that is focusable and carries a
4
+ * role; the visual node components inside stay unnamed.
5
+ */
6
+ /**
7
+ * @param graph - The `nodes.graph` branch of the active messages
8
+ * @param componentName - Resolved node component name (e.g. `gatewayNode`)
9
+ * @param title - The node's display title
10
+ */
11
+ export function nodeAriaLabel(graph, componentName, title) {
12
+ if (componentName === 'gatewayNode')
13
+ return graph.gatewayNode({ title });
14
+ if (componentName === 'ideaNode')
15
+ return graph.ideaNode({ title });
16
+ return graph.workflowNode({ name: title });
17
+ }
@@ -0,0 +1,27 @@
1
+ /**
2
+ * Node fingerprints: "did this node change since a run started?"
3
+ *
4
+ * A fingerprint is a string per node that changes when something that can
5
+ * change a run's result changes, and stays the same for edits that cannot:
6
+ *
7
+ * Counted:
8
+ * - the node's type and the node type it was made from (`metadata.node_type_id`),
9
+ * - its configuration (`data.config`), including dynamic ports and branches,
10
+ * - its extension data, except the `ui` namespace,
11
+ * - which ports feed it: the incoming edges (source node and both handles).
12
+ *
13
+ * Ignored (the server's WorkflowStamp ignores them as well):
14
+ * - position and size, selection, and other canvas state,
15
+ * - the display label (`data.label`) and the per-instance display overrides
16
+ * `config.instanceTitle`, `config.instanceDescription` and `config.instanceBadge`,
17
+ * - `extensions.ui` (visual settings),
18
+ * - run bookkeeping on the node data (`executionInfo`, `isProcessing`, `error`).
19
+ *
20
+ * Comparing two fingerprints of one node is all this is for; they are not a
21
+ * stable format and are never stored or sent.
22
+ *
23
+ * @module utils/nodeFingerprint
24
+ */
25
+ import type { Workflow } from '../types/index.js';
26
+ /** One fingerprint per node of the workflow, keyed by node id. */
27
+ export declare function fingerprintNodes(workflow: Pick<Workflow, 'nodes' | 'edges'> | null | undefined): Record<string, string>;
@@ -0,0 +1,66 @@
1
+ /**
2
+ * Node fingerprints: "did this node change since a run started?"
3
+ *
4
+ * A fingerprint is a string per node that changes when something that can
5
+ * change a run's result changes, and stays the same for edits that cannot:
6
+ *
7
+ * Counted:
8
+ * - the node's type and the node type it was made from (`metadata.node_type_id`),
9
+ * - its configuration (`data.config`), including dynamic ports and branches,
10
+ * - its extension data, except the `ui` namespace,
11
+ * - which ports feed it: the incoming edges (source node and both handles).
12
+ *
13
+ * Ignored (the server's WorkflowStamp ignores them as well):
14
+ * - position and size, selection, and other canvas state,
15
+ * - the display label (`data.label`) and the per-instance display overrides
16
+ * `config.instanceTitle`, `config.instanceDescription` and `config.instanceBadge`,
17
+ * - `extensions.ui` (visual settings),
18
+ * - run bookkeeping on the node data (`executionInfo`, `isProcessing`, `error`).
19
+ *
20
+ * Comparing two fingerprints of one node is all this is for; they are not a
21
+ * stable format and are never stored or sent.
22
+ *
23
+ * @module utils/nodeFingerprint
24
+ */
25
+ /** Per-instance display overrides inside `config` that do not change a run. */
26
+ const DISPLAY_CONFIG_KEYS = new Set(['instanceTitle', 'instanceDescription', 'instanceBadge']);
27
+ /** JSON with object keys sorted, so key order never makes two equal values differ. */
28
+ function stableStringify(value) {
29
+ return JSON.stringify(value, (_key, v) => {
30
+ if (v && typeof v === 'object' && !Array.isArray(v)) {
31
+ const sorted = {};
32
+ for (const k of Object.keys(v).sort())
33
+ sorted[k] = v[k];
34
+ return sorted;
35
+ }
36
+ return v;
37
+ });
38
+ }
39
+ /** One fingerprint per node of the workflow, keyed by node id. */
40
+ export function fingerprintNodes(workflow) {
41
+ const prints = {};
42
+ if (!workflow)
43
+ return prints;
44
+ const incoming = new Map();
45
+ for (const edge of workflow.edges ?? []) {
46
+ const list = incoming.get(edge.target) ?? [];
47
+ list.push(`${edge.source}|${edge.sourceHandle ?? ''}|${edge.targetHandle ?? ''}`);
48
+ incoming.set(edge.target, list);
49
+ }
50
+ for (const node of workflow.nodes ?? []) {
51
+ const config = {};
52
+ for (const [key, value] of Object.entries(node.data?.config ?? {})) {
53
+ if (!DISPLAY_CONFIG_KEYS.has(key))
54
+ config[key] = value;
55
+ }
56
+ const { ui: _ui, ...extensions } = node.data?.extensions ?? {};
57
+ prints[node.id] = stableStringify({
58
+ type: node.type,
59
+ metadata: node.data?.metadata?.node_type_id ?? null,
60
+ config,
61
+ extensions,
62
+ incoming: (incoming.get(node.id) ?? []).sort()
63
+ });
64
+ }
65
+ return prints;
66
+ }
@@ -23,6 +23,16 @@ import type { UISchemaElement } from '../types/uischema.js';
23
23
  * ordered port list with optional exposure overrides).
24
24
  */
25
25
  export declare const PORTS_CONFIG_KEY = "ports";
26
+ /**
27
+ * Whether the node has anything for the ports widget to show: a static
28
+ * metadata port, or a config field through which the author adds dynamic ones.
29
+ *
30
+ * Deliberately reads only `metadata` and the schema — never `data.config`.
31
+ * `ConfigForm` drops its in-flight `edits` buffer whenever the effective schema
32
+ * changes identity, so a decision that moved with config values would discard a
33
+ * user's half-typed edit the moment it flipped.
34
+ */
35
+ export declare function hasConfigurablePorts(node: WorkflowNode, schema: ConfigSchema | undefined): boolean;
26
36
  /**
27
37
  * Append the reserved `ports` property to a node's effective config schema.
28
38
  *
@@ -14,7 +14,7 @@ const DYNAMIC_PORT_KEYS = ['dynamicInputs', 'dynamicOutputs'];
14
14
  * changes identity, so a decision that moved with config values would discard a
15
15
  * user's half-typed edit the moment it flipped.
16
16
  */
17
- function hasConfigurablePorts(node, schema) {
17
+ export function hasConfigurablePorts(node, schema) {
18
18
  const meta = node.data.metadata;
19
19
  if ((meta?.inputs?.length ?? 0) > 0 || (meta?.outputs?.length ?? 0) > 0)
20
20
  return true;
@@ -51,7 +51,7 @@ export function withPortsField(base, node) {
51
51
  // The signal FormField/FormFieldLight match to render <FormPorts>.
52
52
  format: 'ports',
53
53
  title: 'Ports',
54
- description: 'Order the node’s ports and choose which ones are exposed.'
54
+ description: 'Hidden ports are off the canvas and cannot be wired. Drag to reorder.'
55
55
  }
56
56
  }
57
57
  };
@@ -0,0 +1,168 @@
1
+ /**
2
+ * Node card geometry: the straight-wire contract as one pure function.
3
+ *
4
+ * Every node position is on the 20px grid, and every handle centre is a
5
+ * multiple of 20 from the node top, so any output can line up with any input in
6
+ * a straight wire. The rules (Graphite G8, "Geometry contract"):
7
+ *
8
+ * | Part | Value |
9
+ * |-------------------|-------------------------------------------------------------|
10
+ * | Width | 280, or 320 when a row's input and output pills would collide |
11
+ * | Header | always 60 |
12
+ * | Exec pins | y = 40, at x = 0 and x = width |
13
+ * | Description band | 60, reserved on EVERY node while the setting is on |
14
+ * | Port rows | first row centre at 80 (140 with the band), pitch 40 |
15
+ * | Border | drawn inside the box, so it never adds to the height |
16
+ *
17
+ * Nothing here measures the DOM. The node component renders what this function
18
+ * says (it positions every handle from `handleY`), and the edge, alignment and
19
+ * layout code can ask the same function where a handle will be before a node
20
+ * is rendered. Comfortable density only (decision D2): a Compact density would
21
+ * move different rows by different amounts and bend straight wires.
22
+ *
23
+ * Other node types plug in through the same input: a gateway passes its
24
+ * branches as `outputs` with `execPins: 'input'` (a branch named `trigger` stays
25
+ * a row), a node with no inputs passes `inputs: []`, and `execPins: 'none'`
26
+ * keeps the completion trigger as an ordinary row (a tool, whose only port is
27
+ * its tool port).
28
+ *
29
+ * The three compact shapes (Simple, Square, Terminal) have no header, so they
30
+ * use `computeShapeGeometry`: the same rule (every handle centre a multiple of
31
+ * 20 from the node top, every box a multiple of 20) on a plain 40px pitch.
32
+ *
33
+ * @module utils/nodeGeometry
34
+ */
35
+ /** The canvas grid every offset below is a multiple of. */
36
+ export declare const NODE_GRID = 20;
37
+ /** Header height. Fixed: a long title wraps to two lines and clamps, it never grows the header. */
38
+ export declare const NODE_HEADER_HEIGHT = 60;
39
+ /** The description band, reserved on every node while descriptions are shown. */
40
+ export declare const NODE_DESCRIPTION_BAND_HEIGHT = 60;
41
+ /** Exec pins sit on the third grid line of the header, clear of the top corner and the gear. */
42
+ export declare const NODE_EXEC_PIN_Y = 40;
43
+ /** Comfortable row pitch. */
44
+ export declare const NODE_ROW_PITCH = 40;
45
+ /** Default width. */
46
+ export declare const NODE_WIDTH = 280;
47
+ /** Width when a row's input and output pills would collide: one 40px step wider. */
48
+ export declare const NODE_WIDTH_WIDE = 320;
49
+ /** A port pill never grows past this (px); the rest is an ellipsis, the full name is in the tooltip. */
50
+ export declare const NODE_PILL_MAX_WIDTH = 128;
51
+ /** The id and data type of the completion port, which is drawn as a header pin. */
52
+ export declare const EXEC_PORT_ID = "trigger";
53
+ /** What the geometry needs to know about a port. */
54
+ export interface GeometryPort {
55
+ id: string;
56
+ name?: string;
57
+ dataType: string;
58
+ required?: boolean;
59
+ }
60
+ export interface NodeGeometryInput<P extends GeometryPort = GeometryPort> {
61
+ /** Exposed input ports, in render order (the completion trigger included). */
62
+ inputs: readonly P[];
63
+ /** Exposed output ports, in render order (a gateway passes its branches here). */
64
+ outputs: readonly P[];
65
+ /** The *Show descriptions* setting. */
66
+ showDescriptions: boolean;
67
+ /**
68
+ * `'completion'` (default): the port with id and data type `trigger` becomes a
69
+ * pin in the header, in and out. `'input'`: only the input one does (a gateway,
70
+ * whose outputs are branches). `'none'`: it stays an ordinary row.
71
+ */
72
+ execPins?: 'completion' | 'input' | 'none';
73
+ /** Rows are at least this many (default 1, so an empty node keeps a body). */
74
+ minRows?: number;
75
+ /** A shape with a fixed width opts out of the pill rule. */
76
+ width?: number;
77
+ }
78
+ export type HandleDirection = 'input' | 'output';
79
+ export interface HandleGeometry<P extends GeometryPort = GeometryPort> {
80
+ portId: string;
81
+ /** The port the handle belongs to. */
82
+ port: P;
83
+ direction: HandleDirection;
84
+ /** `pin` in the header, `row` in the body. */
85
+ kind: 'pin' | 'row';
86
+ /** Centre, from the node's top-left corner. */
87
+ x: number;
88
+ y: number;
89
+ /** Row index for `row` handles. */
90
+ row?: number;
91
+ }
92
+ export interface RowGeometry<P extends GeometryPort = GeometryPort> {
93
+ index: number;
94
+ /** Row centre. */
95
+ y: number;
96
+ input: P | null;
97
+ output: P | null;
98
+ }
99
+ export interface NodeGeometry<P extends GeometryPort = GeometryPort> {
100
+ width: number;
101
+ height: number;
102
+ headerHeight: number;
103
+ /** 0, or 60 while descriptions are shown. */
104
+ descriptionBand: number;
105
+ /** Top of the port rows (header + band). */
106
+ bodyTop: number;
107
+ rowPitch: number;
108
+ rowCount: number;
109
+ rows: RowGeometry<P>[];
110
+ /** The header pins, when the completion ports exist. */
111
+ execInput: HandleGeometry<P> | null;
112
+ execOutput: HandleGeometry<P> | null;
113
+ /** Every handle, pins first. */
114
+ handles: HandleGeometry<P>[];
115
+ /** True when a row's pills would have collided at 280. */
116
+ wide: boolean;
117
+ }
118
+ /** True for the completion port: id and data type `trigger`. */
119
+ export declare function isCompletionPort(port: {
120
+ id: string;
121
+ dataType: string;
122
+ }): boolean;
123
+ /**
124
+ * The width a pill is given (px): its label plus padding, capped at 128.
125
+ * An estimate on purpose, so the same name always lays out the same wherever it
126
+ * is measured (no font, no DOM).
127
+ */
128
+ export declare function estimatePillWidth(port: GeometryPort, showRequiredMark?: boolean): number;
129
+ /**
130
+ * Compute a node card's geometry.
131
+ *
132
+ * @param input - Exposed ports, in order, and the descriptions setting
133
+ */
134
+ export declare function computeNodeGeometry<P extends GeometryPort>(input: NodeGeometryInput<P>): NodeGeometry<P>;
135
+ /** Where a port's handle centre is, from the node's top-left, or undefined for an unknown port. */
136
+ export declare function handleCenter(geometry: Pick<NodeGeometry, 'handles'>, direction: HandleDirection, portId: string): {
137
+ x: number;
138
+ y: number;
139
+ } | undefined;
140
+ /** Compact shapes: the smallest box, and the step every box grows by. */
141
+ export declare const SHAPE_MIN_SIZE = 80;
142
+ /** Pitch of a compact shape's ports. */
143
+ export declare const SHAPE_PORT_PITCH = 40;
144
+ export interface ShapeGeometryInput<P extends GeometryPort = GeometryPort> {
145
+ inputs: readonly P[];
146
+ outputs: readonly P[];
147
+ /** The box width (a multiple of 20): 280 for Simple, 80 for Square. Terminal ignores it. */
148
+ width?: number;
149
+ }
150
+ export interface ShapeGeometry<P extends GeometryPort = GeometryPort> {
151
+ width: number;
152
+ /** Always a multiple of 40, at least 80. */
153
+ height: number;
154
+ /** Handle centres, from the node's top-left (x on the box edge). */
155
+ handles: HandleGeometry<P>[];
156
+ }
157
+ /**
158
+ * The y of a compact shape's port, from the node top: a lone port sits at 40,
159
+ * several start at 20 and step by 40. Always a multiple of 20.
160
+ */
161
+ export declare function shapePortY(index: number, count: number): number;
162
+ /**
163
+ * Geometry of the compact shapes (Simple, Square, Terminal). They have no
164
+ * header and keep their silhouette, but meet the same invariant as the card:
165
+ * every handle centre is a multiple of 20 from the node top and the box is a
166
+ * multiple of 20 (of 40 in height, so the ports sit symmetrically).
167
+ */
168
+ export declare function computeShapeGeometry<P extends GeometryPort>(input: ShapeGeometryInput<P>): ShapeGeometry<P>;