@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
@@ -0,0 +1,382 @@
1
+ /**
2
+ * Run Controller
3
+ *
4
+ * The session and run executors of one FlowDrop instance: load, create,
5
+ * select, delete and reset sessions, take a turn, launch a run, signal a
6
+ * pipeline, stop, poll, refresh. They used to live inside `Playground.svelte`;
7
+ * moving them here lets any surface of the instance drive the same code path
8
+ * (the Playground, the editor's Command Console, and later a canvas Test mode)
9
+ * instead of each growing a second, subtly different copy.
10
+ *
11
+ * Constructor injection only: the controller is handed the instance's
12
+ * `PlaygroundStore`, `PlaygroundService`, `ApiContext` and `WorkflowStore`.
13
+ * It never reads Svelte context (`getContext` throws outside component
14
+ * initialisation); whoever configures it supplies a messages getter instead.
15
+ *
16
+ * @module stores/runController
17
+ */
18
+ import type { Workflow } from '../types/index.js';
19
+ import type { PlaygroundMessageRequest, PlaygroundMessagesApiResponse, PlaygroundSessionStatus, SessionRunsResult } from '../types/playground.js';
20
+ import type { PlaygroundStore } from './playgroundStore.svelte.js';
21
+ import type { WorkflowStore } from './workflowStore.svelte.js';
22
+ import type { ApiContext } from './apiContext.js';
23
+ import type { PlaygroundService } from '../services/playgroundService.js';
24
+ import { type LaunchResult } from '../services/workflowLaunchService.js';
25
+ import type { CommandHandlers } from '../playground/commands/dispatch.js';
26
+ import { type CommandOutcome } from '../playground/commands/index.js';
27
+ import type { Messages } from '../messages/types.js';
28
+ import type { HostHooks } from '../webmcp/types.js';
29
+ /**
30
+ * Where a run stands, as the Edit-mode run bar words it. `waiting` is a run
31
+ * paused for a person (an approval or input); `stopped` is a run someone
32
+ * cancelled.
33
+ */
34
+ export type ActiveRunStatus = 'running' | 'waiting' | 'failed' | 'done' | 'stopped';
35
+ /** Statuses a run does not leave. */
36
+ export declare const TERMINAL_RUN_STATUSES: readonly ActiveRunStatus[];
37
+ /**
38
+ * The run the instance is showing: the last one started through `fd.runs`
39
+ * (Console `session run` / `session send`, the Playground) or reported through
40
+ * the host's `onRun` (the Assistant, WebMCP). There is at most one.
41
+ */
42
+ export interface ActiveRun {
43
+ /** `session`: a turn or launch in the test session. `host`: started through `host.onRun`. */
44
+ origin: 'session' | 'host';
45
+ /** The pipeline to read node status from; `null` until a session run's pipeline is known. */
46
+ runId: string | null;
47
+ status: ActiveRunStatus;
48
+ startedAt: number;
49
+ /** When the run reached a terminal status (ms epoch), `null` while it is live. */
50
+ endedAt: number | null;
51
+ }
52
+ /** What a {@link RunController} is built from: the instance's own pieces. */
53
+ export interface RunControllerDeps {
54
+ playground: PlaygroundStore;
55
+ service: PlaygroundService;
56
+ api: ApiContext;
57
+ workflow: WorkflowStore;
58
+ }
59
+ /**
60
+ * Options a surface passes through {@link RunController.configure}. All of
61
+ * them are optional: a surface with no Playground mounted (the editor
62
+ * Console) configures nothing and the controller follows the editor's
63
+ * workflow.
64
+ */
65
+ export interface RunControllerOptions {
66
+ /** The workflow whose sessions this controller drives. */
67
+ workflowId?: string;
68
+ /**
69
+ * The caller's live copy of the workflow, when it has one. Used only by
70
+ * {@link RunController.ensureWorkflowInterface}: a key the caller passed is
71
+ * never replaced by the saved one.
72
+ */
73
+ workflow?: Workflow;
74
+ /** Messages per page when loading a session. Default 50. */
75
+ messagePageSize?: number;
76
+ /** Polling interval in milliseconds. Default 1500. */
77
+ pollingInterval?: number;
78
+ /** Overrides when polling stops for a session status. */
79
+ shouldStopPolling?: (status: PlaygroundSessionStatus) => boolean;
80
+ /** Called with a new session's id instead of switching to it in place. */
81
+ onSessionNavigate?: (sessionId: string) => void;
82
+ /** Host-configured opening message for Run. */
83
+ predefinedMessage?: string;
84
+ /**
85
+ * Save the workflow through the editor's own save path. Resolves `true` when
86
+ * it was written, `false` when nothing was saved (a host cancelled it) and
87
+ * throws when the request failed. Given by the editor's Playground only:
88
+ * with it, {@link RunController.needsSave} says whether a send must save
89
+ * first and {@link RunController.saveFirst} does it.
90
+ */
91
+ saveWorkflow?: () => Promise<boolean>;
92
+ /**
93
+ * List only the sessions the Playground created (the third-party mark the
94
+ * server stamps on them): the editor's Playground shows its own sessions, not
95
+ * every session of the workflow. A server that does not expose the mark
96
+ * lists them all. A session created here is named by the server.
97
+ */
98
+ playgroundSessionsOnly?: boolean;
99
+ /**
100
+ * Message getter, read at call time so a locale switch is picked up. Default
101
+ * `() => defaultMessages`. Never resolved from Svelte context here.
102
+ */
103
+ messages?: () => Messages;
104
+ }
105
+ /**
106
+ * Per-instance run controller, `fd.runs`.
107
+ *
108
+ * This is the controller Test mode builds on: every way of starting, stopping
109
+ * and following a run in an instance goes through it.
110
+ */
111
+ export declare class RunController {
112
+ #private;
113
+ /**
114
+ * Milliseconds between status reads of a host run (`onRunStatus`). A public
115
+ * field, like a timeout in a client: tests and slow backends set it.
116
+ */
117
+ hostPollInterval: number;
118
+ constructor(deps: RunControllerDeps);
119
+ /**
120
+ * Replace the options. Called at init and again whenever the caller's
121
+ * props change; it replaces, it does not merge, so a key left out falls
122
+ * back to its default.
123
+ */
124
+ configure(options: RunControllerOptions): void;
125
+ /**
126
+ * A signal accepted but not yet observed as effective.
127
+ *
128
+ * Backends refuse a second signal on the same pipeline, so we hold this to
129
+ * disable rather than fire a request guaranteed to be rejected. Cleared when
130
+ * the session status changes — see {@link clearPendingSignal}.
131
+ */
132
+ get pendingSignal(): {
133
+ pipelineId: string;
134
+ signal: string;
135
+ } | null;
136
+ /** Whether a status refresh is in flight. */
137
+ get isRefreshing(): boolean;
138
+ /** The instance's playground store, for surfaces that read what a run produced. */
139
+ get playground(): PlaygroundStore;
140
+ /** The instance's workflow store: the editor's workflow and its dirty state. */
141
+ get editor(): WorkflowStore;
142
+ /** Whether the instance has a backend to talk to. */
143
+ get isConfigured(): boolean;
144
+ /** Whether the backend can launch a run without a chat message. */
145
+ get canLaunch(): boolean;
146
+ /** A launch result as feedback text, in the configured messages. */
147
+ describeLaunch(result: LaunchResult): CommandOutcome;
148
+ /**
149
+ * The workflow id in effect: the configured one, else the editor's current
150
+ * workflow (the Console has no Playground mounted), else `null` — an
151
+ * unsaved new workflow.
152
+ */
153
+ get workflowId(): string | null;
154
+ /**
155
+ * Make the playground store reflect the editor's workflow, for a surface
156
+ * with no Playground mounted. A no-op when a surface configured a workflow
157
+ * id (the Playground sets its own workflow) or the editor has none.
158
+ *
159
+ * The same workflow is re-adopted when the editor holds a newer copy, so a
160
+ * binding edited since the last turn is the one the next turn uses. When the
161
+ * store holds a different workflow, its sessions belong to that one and are
162
+ * dropped, so a turn from the Console never lands in another workflow's
163
+ * session.
164
+ */
165
+ adoptEditorWorkflow(): void;
166
+ /**
167
+ * Make sure the playground knows the workflow's interface and chat binding.
168
+ *
169
+ * The mode (chat box, form, Run) is read from the workflow's Playground
170
+ * settings, else from its interface's deprecated turn ports. A workflow
171
+ * passed in with both an `interface` and a `playground` key is used as is;
172
+ * when either is missing, the workflow is loaded through the workflows API
173
+ * (`workflows.get`) and only the missing keys are taken from there: a key
174
+ * the caller passed is its live copy (the editor's, unsaved edits and all)
175
+ * and never gives way to the saved one. Any failure
176
+ * leaves the playground in `legacy` mode, which is the behaviour it had
177
+ * before turn ports.
178
+ */
179
+ ensureWorkflowInterface(): Promise<void>;
180
+ loadSessions(): Promise<void>;
181
+ loadSession(sessionId: string): Promise<void>;
182
+ /**
183
+ * Load the page of messages immediately older than the oldest one currently
184
+ * shown. Triggered by scroll-up in MessageStream, which serializes calls and
185
+ * owns the in-flight/anchoring state. Bypasses applyServerResponse so a
186
+ * historical fetch never disturbs the live polling cursor or pipeline view.
187
+ */
188
+ loadOlderMessages(): Promise<void>;
189
+ /**
190
+ * Whether older messages remain after a backward-pagination response. Prefer
191
+ * the server's explicit `hasOlder` flag; fall back to inferring from page
192
+ * fullness for backends that haven't adopted the field yet.
193
+ */
194
+ deriveHasOlder(response: PlaygroundMessagesApiResponse): boolean;
195
+ createSession(): Promise<void>;
196
+ /**
197
+ * Whether a send must save the workflow first: the surface can save and the
198
+ * editor's workflow has unsaved edits (its Playground settings count, they
199
+ * are part of the workflow).
200
+ */
201
+ get needsSave(): boolean;
202
+ /**
203
+ * Save the workflow if it has unsaved edits, so the run that follows is on
204
+ * what the person sees. Resolves `true` when there is nothing to save or the
205
+ * save was written. A failed or cancelled save resolves `false` and shows why
206
+ * in the Playground: the caller sends nothing.
207
+ */
208
+ saveFirst(): Promise<boolean>;
209
+ /**
210
+ * Load the current session's runs from the runs endpoint into
211
+ * `playground.sessionRuns`, optionally rebuilding the conversation's version
212
+ * dividers from them. Resolves `null` (and changes nothing) on a server
213
+ * without the endpoint, which is asked only once per page, and when the
214
+ * request fails: version information is an extra, never an error.
215
+ */
216
+ loadSessionRuns(sessionId?: string, options?: {
217
+ rebuildDividers?: boolean;
218
+ }): Promise<SessionRunsResult | null>;
219
+ /**
220
+ * The workflow was just saved. When a conversation is open, put a "Saved,
221
+ * new version" divider below its last message, so the feed reads in the
222
+ * order things happened. No divider without a conversation, on a server
223
+ * without the runs endpoint, or when the save did not change the version
224
+ * the last run ran on (a node dragged to another place, say).
225
+ */
226
+ noteWorkflowSaved(): Promise<void>;
227
+ selectSession(sessionId: string): Promise<void>;
228
+ deleteSession(sessionId: string): Promise<void>;
229
+ /**
230
+ * Reset a stuck session to idle.
231
+ *
232
+ * Mirrors stopExecution: tear down polling and force the local status
233
+ * back to idle even on failure, since the point of reset is to escape a state
234
+ * the client and server disagree about.
235
+ */
236
+ resetSession(): Promise<void>;
237
+ /**
238
+ * Launch a run with named inputs and no chat message.
239
+ *
240
+ * Creates a session first when there is none, so the run has a conversation
241
+ * to report into — the launch endpoint accepts a session id precisely so its
242
+ * messages land somewhere the user is looking.
243
+ */
244
+ launchWorkflow(inputs: Record<string, string>): Promise<LaunchResult>;
245
+ /**
246
+ * Start a run from a button or auto-run, without posting a chat message.
247
+ *
248
+ * Falls back to sending `predefinedMessage` only where the backend has no
249
+ * launch verb — there a message is genuinely the only way to start a run, so
250
+ * the fabricated turn is the lesser evil. Everywhere else this is what stops
251
+ * "Run workflow" appearing in the conversation as though a user typed it.
252
+ *
253
+ * @returns Feedback for a refused launch, for the caller to show; `null`
254
+ * when nothing needs reporting.
255
+ */
256
+ startRun(): Promise<CommandOutcome | null>;
257
+ /**
258
+ * Send a chat message as a turn. Slash commands are not handled here; the
259
+ * Playground intercepts them before calling this.
260
+ */
261
+ sendMessage(content: string): Promise<boolean>;
262
+ /**
263
+ * Send an operator signal to a specific pipeline.
264
+ *
265
+ * Records the signal as pending on acceptance so a second one is refused
266
+ * client-side rather than by the backend.
267
+ */
268
+ sendSignal(signal: 'pause' | 'resume' | 'cancel', pipelineId: string, reason?: string): Promise<import("../services/pipelineSignalService.js").SignalResult>;
269
+ /**
270
+ * Clear a pending signal once the session status moves.
271
+ *
272
+ * The status transition is the observable consequence of the signal landing
273
+ * — or of the run ending by itself, which equally means the signal is moot.
274
+ */
275
+ clearPendingSignal(): void;
276
+ /**
277
+ * Take one turn: post the request to the session's turn door and tail the
278
+ * session. The interface form's values ride along as `inputs` (none in
279
+ * legacy mode). A refusal (a 400 naming the fix, a 409, …) is shown with the
280
+ * server's own message and leaves the session idle.
281
+ *
282
+ * @param options.launch The turn is a Run click: a refusal is shown under
283
+ * the Run button (`launchError`) rather than in the banner.
284
+ * @returns Whether the turn was accepted
285
+ */
286
+ takeTurn(request: PlaygroundMessageRequest, options?: {
287
+ launch?: boolean;
288
+ }): Promise<boolean>;
289
+ stopExecution(): Promise<void>;
290
+ startPolling(sessionId: string, seedSequence?: boolean, overrideShouldStopPolling?: (status: PlaygroundSessionStatus) => boolean): void;
291
+ /** Stop this instance's poller. */
292
+ stopPolling(): void;
293
+ /**
294
+ * Load one run's per-node status into `fd.playground` (`nodeStatuses`).
295
+ *
296
+ * The node status overlay draws from that store, so the result survives
297
+ * edits to the graph. Without arguments it follows the session's active run
298
+ * and the editor's workflow. A newer call, or {@link clearNodeStatuses},
299
+ * discards the result of one still in flight. Without a run or a saved
300
+ * workflow it clears instead. A read that fails keeps the last good result
301
+ * of the same run.
302
+ */
303
+ loadNodeStatuses(pipelineId?: string | null, workflow?: Workflow | null): Promise<void>;
304
+ /**
305
+ * Ask for the shown run's node statuses to be (re)loaded, for a caller that
306
+ * asks on every poll tick: one load runs at a time, and any number of asks
307
+ * made while it runs coalesce into one more load afterwards. The request
308
+ * rate therefore follows the network, not the poll interval, and the last
309
+ * state is always the one loaded.
310
+ */
311
+ requestNodeStatuses(): void;
312
+ /** Drop the node statuses and any load still in flight. */
313
+ clearNodeStatuses(): void;
314
+ /**
315
+ * Whether a run is going or waiting for someone: the shown run
316
+ * ({@link activeRun}, session or host) is running or waiting, or the
317
+ * current session is running or awaiting input (a Playground turn that no
318
+ * bar tracks). The one fact "a run needs watching" is read from here: the
319
+ * dot on the Test switch, and the badges that follow a run in Edit mode.
320
+ * For a tracked session run it agrees with the run bar by construction,
321
+ * since the bar's status is derived from the session's.
322
+ */
323
+ get isLive(): boolean;
324
+ /** Fetch what is new for the current session and tail it when it is running. */
325
+ refresh(): Promise<void>;
326
+ /**
327
+ * Catch up immediately rather than waiting for the next poll interval, using
328
+ * the service's sequence cursor so only new messages are fetched. Shared by
329
+ * the interrupt-resolved handler (which also restarts polling, as
330
+ * `restartPolling`) and the tab-visible catch-up (which only fetches).
331
+ */
332
+ catchUp(options?: {
333
+ restartPolling?: boolean;
334
+ }): Promise<void>;
335
+ /** Whether this instance's service is polling a session. */
336
+ get isPolling(): boolean;
337
+ /**
338
+ * The run the instance is showing, or `null`. Reactive. A session run's
339
+ * status follows the session; a host run's follows `onRunStatus`.
340
+ */
341
+ get activeRun(): ActiveRun | null;
342
+ /**
343
+ * Stop the run being shown: the session's stop for a session run, a cancel
344
+ * signal on the pipeline for a host run (the next status read reports it).
345
+ */
346
+ stopRun(): Promise<void>;
347
+ /**
348
+ * Forget the shown run and its node statuses. The run bar calls it when it
349
+ * fades; the statuses go with it so the Edit canvas is back to normal.
350
+ */
351
+ dismissRun(): void;
352
+ /**
353
+ * The host's `onRun` / `onRunStatus` routed through this controller: runs
354
+ * they start become the shown run, and the status they report moves it.
355
+ * Hands back hooks that behave exactly as the given ones (same arguments,
356
+ * same envelopes, same rejections); use them wherever the originals went.
357
+ * A run is followed only when the host also supplies `onRunStatus`: without
358
+ * it there is no way to know the run ended.
359
+ */
360
+ wrapHostHooks(hooks: HostHooks): HostHooks;
361
+ /**
362
+ * Show a run from the Runs list: it becomes the shown run (node badges, run
363
+ * pill), whatever started it. A run that has not finished is followed until
364
+ * it does, through the pipelines status endpoint (or the host's
365
+ * `onRunStatus` when it gave one).
366
+ */
367
+ openRun(runId: string, status?: string): void;
368
+ /**
369
+ * The run opened from the Runs list and still shown, or `null` (nothing
370
+ * opened, or a live run has taken its place). Reactive.
371
+ */
372
+ get openedRunId(): string | null;
373
+ /** Stop the timers and subscriptions this controller started. */
374
+ dispose(): void;
375
+ /**
376
+ * Stop reading the status of a host run and forget it. Also drops a read
377
+ * already in flight. The controller stays usable: a later host run polls again.
378
+ */
379
+ stopHostPolling(): void;
380
+ /** The adapter for `playground/commands/dispatch.ts`. */
381
+ commandHandlers(): CommandHandlers;
382
+ }