@flowdrop/flowdrop 2.13.0 → 2.15.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 (308) hide show
  1. package/CHANGELOG.md +82 -0
  2. package/dist/commands/executor.js +58 -8
  3. package/dist/commands/parser.js +3 -3
  4. package/dist/commands/types.d.ts +8 -2
  5. package/dist/commands/uiActionTarget.d.ts +24 -0
  6. package/dist/commands/uiActionTarget.js +31 -0
  7. package/dist/commands/validate.d.ts +15 -0
  8. package/dist/commands/validate.js +115 -0
  9. package/dist/components/App.svelte +44 -2
  10. package/dist/components/App.svelte.d.ts +3 -1
  11. package/dist/components/Button.svelte +7 -7
  12. package/dist/components/Button.svelte.d.ts +10 -0
  13. package/dist/components/CanvasBanner.svelte +19 -6
  14. package/dist/components/CanvasBanner.svelte.d.ts +15 -3
  15. package/dist/components/CanvasContextMenu.svelte +9 -9
  16. package/dist/components/CanvasContextMenu.svelte.d.ts +10 -0
  17. package/dist/components/CanvasToolbar.svelte +8 -7
  18. package/dist/components/CanvasToolbar.svelte.d.ts +10 -0
  19. package/dist/components/CanvasZoomControls.svelte +10 -9
  20. package/dist/components/CanvasZoomControls.svelte.d.ts +13 -0
  21. package/dist/components/ConfigForm.svelte +51 -18
  22. package/dist/components/ConfigForm.svelte.d.ts +20 -1
  23. package/dist/components/ConfigPanel.svelte +9 -5
  24. package/dist/components/ConfigPanel.svelte.d.ts +10 -0
  25. package/dist/components/EditorStatusBar.svelte +6 -5
  26. package/dist/components/EditorStatusBar.svelte.d.ts +7 -0
  27. package/dist/components/ExternalLinkRow.svelte +16 -1
  28. package/dist/components/ExternalLinkRow.svelte.d.ts +5 -0
  29. package/dist/components/FlowDropEdge.svelte +15 -12
  30. package/dist/components/FlowDropEdge.svelte.d.ts +16 -0
  31. package/dist/components/InterfaceTag.svelte +13 -15
  32. package/dist/components/InterfaceTag.svelte.d.ts +19 -0
  33. package/dist/components/LoadingSpinner.svelte +8 -2
  34. package/dist/components/LoadingSpinner.svelte.d.ts +9 -0
  35. package/dist/components/Logo.svelte +11 -0
  36. package/dist/components/Logo.svelte.d.ts +9 -0
  37. package/dist/components/LogoWordmark.svelte +8 -3
  38. package/dist/components/LogoWordmark.svelte.d.ts +9 -0
  39. package/dist/components/LoopbackLanes.svelte +12 -6
  40. package/dist/components/LoopbackLanes.svelte.d.ts +13 -0
  41. package/dist/components/MarkdownDisplay.svelte +10 -3
  42. package/dist/components/MarkdownDisplay.svelte.d.ts +11 -0
  43. package/dist/components/Navbar.svelte +13 -5
  44. package/dist/components/Navbar.svelte.d.ts +14 -0
  45. package/dist/components/NodeInspector.svelte +7 -8
  46. package/dist/components/NodeInspector.svelte.d.ts +10 -0
  47. package/dist/components/NodeSidebar.svelte +9 -3
  48. package/dist/components/NodeSidebar.svelte.d.ts +10 -0
  49. package/dist/components/NodeStatusOverlay.svelte +30 -19
  50. package/dist/components/NodeStatusOverlay.svelte.d.ts +19 -0
  51. package/dist/components/NodeSwapPicker.svelte +1 -1
  52. package/dist/components/RunBar.svelte +10 -13
  53. package/dist/components/RunBar.svelte.d.ts +15 -0
  54. package/dist/components/RunsMenu.svelte +14 -13
  55. package/dist/components/RunsMenu.svelte.d.ts +15 -0
  56. package/dist/components/SchemaForm.svelte +10 -13
  57. package/dist/components/SchemaForm.svelte.d.ts +51 -0
  58. package/dist/components/SettingsPanel.svelte +5 -5
  59. package/dist/components/StatusIcon.svelte +14 -3
  60. package/dist/components/StatusIcon.svelte.d.ts +15 -0
  61. package/dist/components/StatusLabel.svelte +10 -2
  62. package/dist/components/StatusLabel.svelte.d.ts +11 -0
  63. package/dist/components/ThemeToggle.svelte +8 -5
  64. package/dist/components/ThemeToggle.svelte.d.ts +10 -0
  65. package/dist/components/UniversalNode.svelte +13 -5
  66. package/dist/components/UniversalNode.svelte.d.ts +15 -0
  67. package/dist/components/WorkflowInterfaceEntryCard.svelte +1 -1
  68. package/dist/components/WorkflowInterfaceEntryComposer.svelte +1 -2
  69. package/dist/components/ZoomTier.svelte +13 -10
  70. package/dist/components/ZoomTier.svelte.d.ts +14 -0
  71. package/dist/components/console/CommandConsole.svelte +9 -3
  72. package/dist/components/console/CommandConsole.svelte.d.ts +10 -0
  73. package/dist/components/console/ConsoleAutocomplete.svelte +4 -4
  74. package/dist/components/console/ConsoleAutocomplete.svelte.d.ts +5 -0
  75. package/dist/components/console/ConsoleInput.svelte +6 -4
  76. package/dist/components/console/ConsoleInput.svelte.d.ts +7 -0
  77. package/dist/components/console/ConsoleOutput.svelte +5 -3
  78. package/dist/components/console/ConsoleOutput.svelte.d.ts +6 -0
  79. package/dist/components/console/ConsoleStrip.svelte +9 -5
  80. package/dist/components/console/ConsoleStrip.svelte.d.ts +10 -0
  81. package/dist/components/form/FieldFactory.svelte +6 -2
  82. package/dist/components/form/FieldFactory.svelte.d.ts +46 -0
  83. package/dist/components/form/FormArray.svelte +9 -16
  84. package/dist/components/form/FormArray.svelte.d.ts +10 -0
  85. package/dist/components/form/FormArrayRows.svelte +8 -8
  86. package/dist/components/form/FormArrayRows.svelte.d.ts +11 -0
  87. package/dist/components/form/FormAutocomplete.svelte +6 -3
  88. package/dist/components/form/FormAutocomplete.svelte.d.ts +23 -0
  89. package/dist/components/form/FormCheckboxGroup.svelte +5 -5
  90. package/dist/components/form/FormCheckboxGroup.svelte.d.ts +6 -0
  91. package/dist/components/form/FormCodeEditor.svelte +8 -13
  92. package/dist/components/form/FormCodeEditor.svelte.d.ts +9 -0
  93. package/dist/components/form/FormField.svelte +7 -8
  94. package/dist/components/form/FormField.svelte.d.ts +10 -0
  95. package/dist/components/form/FormFieldLight.svelte +6 -5
  96. package/dist/components/form/FormFieldLight.svelte.d.ts +8 -0
  97. package/dist/components/form/FormFieldWrapper.svelte +8 -8
  98. package/dist/components/form/FormFieldWrapper.svelte.d.ts +9 -0
  99. package/dist/components/form/FormFieldset.svelte +6 -12
  100. package/dist/components/form/FormFieldset.svelte.d.ts +7 -0
  101. package/dist/components/form/FormMarkdownEditor.svelte +8 -15
  102. package/dist/components/form/FormMarkdownEditor.svelte.d.ts +9 -0
  103. package/dist/components/form/FormNumberField.svelte +5 -7
  104. package/dist/components/form/FormNumberField.svelte.d.ts +6 -0
  105. package/dist/components/form/FormPorts.svelte +133 -27
  106. package/dist/components/form/FormPorts.svelte.d.ts +19 -0
  107. package/dist/components/form/FormRangeField.svelte +5 -9
  108. package/dist/components/form/FormRangeField.svelte.d.ts +6 -0
  109. package/dist/components/form/FormSelect.svelte +5 -7
  110. package/dist/components/form/FormSelect.svelte.d.ts +6 -0
  111. package/dist/components/form/FormTemplateEditor.svelte +8 -16
  112. package/dist/components/form/FormTemplateEditor.svelte.d.ts +9 -0
  113. package/dist/components/form/FormTextField.svelte +5 -7
  114. package/dist/components/form/FormTextField.svelte.d.ts +6 -0
  115. package/dist/components/form/FormTextarea.svelte +5 -7
  116. package/dist/components/form/FormTextarea.svelte.d.ts +6 -0
  117. package/dist/components/form/FormToggle.svelte +6 -8
  118. package/dist/components/form/FormToggle.svelte.d.ts +7 -0
  119. package/dist/components/form/FormUISchemaRenderer.svelte +5 -9
  120. package/dist/components/form/FormUISchemaRenderer.svelte.d.ts +7 -0
  121. package/dist/components/interrupt/ChoicePrompt.svelte +6 -6
  122. package/dist/components/interrupt/ChoicePrompt.svelte.d.ts +7 -0
  123. package/dist/components/interrupt/ConfirmationPrompt.svelte +6 -5
  124. package/dist/components/interrupt/ConfirmationPrompt.svelte.d.ts +7 -0
  125. package/dist/components/interrupt/FormPrompt.svelte +6 -6
  126. package/dist/components/interrupt/FormPrompt.svelte.d.ts +7 -0
  127. package/dist/components/interrupt/InterruptBubble.svelte +10 -9
  128. package/dist/components/interrupt/InterruptBubble.svelte.d.ts +11 -0
  129. package/dist/components/interrupt/ReviewPrompt.svelte +5 -6
  130. package/dist/components/interrupt/ReviewPrompt.svelte.d.ts +7 -0
  131. package/dist/components/interrupt/TextInputPrompt.svelte +6 -6
  132. package/dist/components/interrupt/TextInputPrompt.svelte.d.ts +7 -0
  133. package/dist/components/nodes/AtomNode.svelte +31 -6
  134. package/dist/components/nodes/AtomNode.svelte.d.ts +15 -0
  135. package/dist/components/nodes/CaptionNode.svelte +50 -7
  136. package/dist/components/nodes/CaptionNode.svelte.d.ts +13 -0
  137. package/dist/components/nodes/GatewayNode.svelte +18 -11
  138. package/dist/components/nodes/GatewayNode.svelte.d.ts +21 -0
  139. package/dist/components/nodes/IdeaNode.svelte +47 -6
  140. package/dist/components/nodes/IdeaNode.svelte.d.ts +17 -0
  141. package/dist/components/nodes/NodeCard.svelte +26 -18
  142. package/dist/components/nodes/NodeCard.svelte.d.ts +20 -0
  143. package/dist/components/nodes/NodeConfigButton.svelte +15 -2
  144. package/dist/components/nodes/NodeConfigButton.svelte.d.ts +11 -0
  145. package/dist/components/nodes/NodeProblemMark.svelte +15 -10
  146. package/dist/components/nodes/NodeProblemMark.svelte.d.ts +16 -0
  147. package/dist/components/nodes/NodeTip.svelte +10 -7
  148. package/dist/components/nodes/NodeTip.svelte.d.ts +13 -0
  149. package/dist/components/nodes/NotesNode.svelte +30 -0
  150. package/dist/components/nodes/NotesNode.svelte.d.ts +14 -0
  151. package/dist/components/nodes/SimpleNode.svelte +35 -8
  152. package/dist/components/nodes/SimpleNode.svelte.d.ts +17 -0
  153. package/dist/components/nodes/SquareNode.svelte +38 -8
  154. package/dist/components/nodes/SquareNode.svelte.d.ts +17 -0
  155. package/dist/components/nodes/TerminalNode.svelte +24 -10
  156. package/dist/components/nodes/TerminalNode.svelte.d.ts +17 -0
  157. package/dist/components/nodes/ToolNode.svelte +14 -5
  158. package/dist/components/nodes/ToolNode.svelte.d.ts +15 -0
  159. package/dist/components/nodes/WorkflowNode.svelte +18 -15
  160. package/dist/components/nodes/WorkflowNode.svelte.d.ts +21 -0
  161. package/dist/components/playground/ChatBubble.svelte +4 -3
  162. package/dist/components/playground/ChatBubble.svelte.d.ts +5 -0
  163. package/dist/components/playground/ChatInput.svelte +11 -6
  164. package/dist/components/playground/ChatInput.svelte.d.ts +14 -0
  165. package/dist/components/playground/ChatPanel.svelte +15 -7
  166. package/dist/components/playground/ChatPanel.svelte.d.ts +17 -0
  167. package/dist/components/playground/ControlPanel.svelte +26 -9
  168. package/dist/components/playground/ControlPanel.svelte.d.ts +29 -0
  169. package/dist/components/playground/DockedPlayground.svelte +7 -10
  170. package/dist/components/playground/DockedPlayground.svelte.d.ts +10 -0
  171. package/dist/components/playground/ExecutionConsole.svelte +10 -5
  172. package/dist/components/playground/ExecutionConsole.svelte.d.ts +12 -0
  173. package/dist/components/playground/ExecutionList.svelte +13 -0
  174. package/dist/components/playground/ExecutionList.svelte.d.ts +11 -0
  175. package/dist/components/playground/ExecutionLogs.svelte +6 -9
  176. package/dist/components/playground/ExecutionLogs.svelte.d.ts +7 -0
  177. package/dist/components/playground/HeaderMenu.svelte +6 -8
  178. package/dist/components/playground/HeaderMenu.svelte.d.ts +9 -0
  179. package/dist/components/playground/HierarchyTrail.svelte +6 -6
  180. package/dist/components/playground/HierarchyTrail.svelte.d.ts +8 -0
  181. package/dist/components/playground/InputCollector.svelte +6 -5
  182. package/dist/components/playground/InputCollector.svelte.d.ts +7 -0
  183. package/dist/components/playground/InputFields.svelte +8 -12
  184. package/dist/components/playground/InputFields.svelte.d.ts +9 -0
  185. package/dist/components/playground/InterfaceInputForm.svelte +6 -13
  186. package/dist/components/playground/InterfaceInputForm.svelte.d.ts +9 -0
  187. package/dist/components/playground/InterfaceJsonInput.svelte +6 -5
  188. package/dist/components/playground/InterfaceJsonInput.svelte.d.ts +8 -0
  189. package/dist/components/playground/LogRow.svelte +4 -5
  190. package/dist/components/playground/LogRow.svelte.d.ts +6 -0
  191. package/dist/components/playground/MessageBubble.svelte +13 -7
  192. package/dist/components/playground/MessageBubble.svelte.d.ts +15 -0
  193. package/dist/components/playground/MessageCard.svelte +5 -2
  194. package/dist/components/playground/MessageCard.svelte.d.ts +6 -0
  195. package/dist/components/playground/MessageMarkdown.svelte +8 -9
  196. package/dist/components/playground/MessageMarkdown.svelte.d.ts +11 -0
  197. package/dist/components/playground/MessageNotice.svelte +7 -0
  198. package/dist/components/playground/MessageNotice.svelte.d.ts +5 -0
  199. package/dist/components/playground/MessageStream.svelte +8 -6
  200. package/dist/components/playground/MessageStream.svelte.d.ts +11 -0
  201. package/dist/components/playground/MessageTagChip.svelte +7 -7
  202. package/dist/components/playground/MessageTagChip.svelte.d.ts +10 -0
  203. package/dist/components/playground/MessageTagStrip.svelte +6 -3
  204. package/dist/components/playground/MessageTagStrip.svelte.d.ts +8 -0
  205. package/dist/components/playground/OriginBadge.svelte +7 -4
  206. package/dist/components/playground/OriginBadge.svelte.d.ts +8 -0
  207. package/dist/components/playground/PipelineKanbanView.svelte +14 -0
  208. package/dist/components/playground/PipelineKanbanView.svelte.d.ts +12 -0
  209. package/dist/components/playground/PipelinePanel.svelte +14 -0
  210. package/dist/components/playground/PipelinePanel.svelte.d.ts +12 -0
  211. package/dist/components/playground/PipelineTableView.svelte +14 -0
  212. package/dist/components/playground/PipelineTableView.svelte.d.ts +12 -0
  213. package/dist/components/playground/Playground.svelte +17 -11
  214. package/dist/components/playground/Playground.svelte.d.ts +20 -0
  215. package/dist/components/playground/PlaygroundApp.svelte +24 -10
  216. package/dist/components/playground/PlaygroundApp.svelte.d.ts +26 -0
  217. package/dist/components/playground/PlaygroundHeader.svelte +8 -12
  218. package/dist/components/playground/PlaygroundHeader.svelte.d.ts +11 -0
  219. package/dist/components/playground/PlaygroundModal.svelte +6 -8
  220. package/dist/components/playground/PlaygroundModal.svelte.d.ts +7 -0
  221. package/dist/components/playground/PlaygroundStudio.svelte +9 -0
  222. package/dist/components/playground/PlaygroundStudio.svelte.d.ts +7 -0
  223. package/dist/components/playground/PlaygroundSurface.svelte +19 -14
  224. package/dist/components/playground/PlaygroundSurface.svelte.d.ts +20 -0
  225. package/dist/components/playground/SessionManager.svelte +6 -5
  226. package/dist/components/playground/SessionManager.svelte.d.ts +7 -0
  227. package/dist/components/playground/StepsSummary.svelte +8 -9
  228. package/dist/components/playground/StepsSummary.svelte.d.ts +10 -0
  229. package/dist/components/primitives/Button.svelte +15 -7
  230. package/dist/components/primitives/Button.svelte.d.ts +18 -1
  231. package/dist/components/primitives/Card.svelte +8 -6
  232. package/dist/components/primitives/Card.svelte.d.ts +11 -0
  233. package/dist/components/primitives/Checkbox.svelte +8 -5
  234. package/dist/components/primitives/Checkbox.svelte.d.ts +11 -0
  235. package/dist/components/primitives/Chip.svelte +8 -4
  236. package/dist/components/primitives/Chip.svelte.d.ts +11 -0
  237. package/dist/components/primitives/Combobox.svelte +27 -18
  238. package/dist/components/primitives/Combobox.svelte.d.ts +33 -0
  239. package/dist/components/primitives/Composer.svelte +15 -16
  240. package/dist/components/primitives/Composer.svelte.d.ts +20 -0
  241. package/dist/components/primitives/EmptyState.svelte +9 -3
  242. package/dist/components/primitives/EmptyState.svelte.d.ts +11 -0
  243. package/dist/components/primitives/Field.svelte +12 -9
  244. package/dist/components/primitives/Field.svelte.d.ts +16 -0
  245. package/dist/components/primitives/IconButton.svelte +10 -5
  246. package/dist/components/primitives/IconButton.svelte.d.ts +13 -0
  247. package/dist/components/primitives/Menu.svelte +15 -14
  248. package/dist/components/primitives/Menu.svelte.d.ts +20 -0
  249. package/dist/components/primitives/Notice.svelte +11 -8
  250. package/dist/components/primitives/Notice.svelte.d.ts +14 -0
  251. package/dist/components/primitives/PanelHeader.svelte +10 -7
  252. package/dist/components/primitives/PanelHeader.svelte.d.ts +13 -0
  253. package/dist/components/primitives/Segmented.svelte +11 -4
  254. package/dist/components/primitives/Segmented.svelte.d.ts +14 -0
  255. package/dist/components/primitives/Select.svelte +13 -16
  256. package/dist/components/primitives/Select.svelte.d.ts +18 -0
  257. package/dist/components/primitives/StatusPill.svelte +11 -8
  258. package/dist/components/primitives/StatusPill.svelte.d.ts +15 -0
  259. package/dist/components/primitives/Switch.svelte +9 -6
  260. package/dist/components/primitives/Switch.svelte.d.ts +12 -0
  261. package/dist/components/primitives/Tabs.svelte +16 -15
  262. package/dist/components/primitives/Tabs.svelte.d.ts +22 -0
  263. package/dist/components/primitives/Toolbar.svelte +14 -13
  264. package/dist/components/primitives/Toolbar.svelte.d.ts +18 -0
  265. package/dist/components/primitives/ToolbarSeparator.svelte +5 -4
  266. package/dist/components/primitives/ToolbarSeparator.svelte.d.ts +7 -0
  267. package/dist/core/index.d.ts +2 -2
  268. package/dist/core/index.js +1 -1
  269. package/dist/editor/index.d.ts +3 -3
  270. package/dist/index.d.ts +3 -2
  271. package/dist/layout/index.d.ts +1 -1
  272. package/dist/layout/index.js +1 -1
  273. package/dist/layout/toWorkflow.d.ts +8 -7
  274. package/dist/layout/toWorkflow.js +20 -40
  275. package/dist/messages/defaults.d.ts +24 -0
  276. package/dist/messages/defaults.js +15 -0
  277. package/dist/skins/graphite.d.ts +1 -1
  278. package/dist/skins/graphite.js +1 -1
  279. package/dist/stores/settingsStore.svelte.js +3 -0
  280. package/dist/stores/workflowStore.svelte.d.ts +10 -0
  281. package/dist/stores/workflowStore.svelte.js +65 -20
  282. package/dist/styles/base.css +2 -126
  283. package/dist/styles/tokenAliases.js +1 -0
  284. package/dist/styles/tokens.css +9 -5
  285. package/dist/svelte-app.d.ts +63 -2
  286. package/dist/svelte-app.js +144 -1
  287. package/dist/themes/classic.d.ts +9 -0
  288. package/dist/themes/classic.js +16 -0
  289. package/dist/themes/index.d.ts +7 -2
  290. package/dist/themes/index.js +20 -10
  291. package/dist/types/events.d.ts +18 -1
  292. package/dist/types/index.d.ts +10 -0
  293. package/dist/types/settings.d.ts +6 -2
  294. package/dist/types/theme.d.ts +6 -2
  295. package/dist/utils/externalEdit.svelte.d.ts +48 -0
  296. package/dist/utils/externalEdit.svelte.js +62 -0
  297. package/dist/utils/inspectorContext.d.ts +5 -0
  298. package/dist/utils/playgroundChat.d.ts +10 -0
  299. package/dist/utils/playgroundChat.js +25 -0
  300. package/dist/utils/portExposure.d.ts +24 -1
  301. package/dist/utils/portExposure.js +46 -13
  302. package/dist/utils/portUtils.d.ts +5 -1
  303. package/dist/utils/portUtils.js +15 -4
  304. package/package.json +2 -1
  305. package/dist/components/IconButton.svelte +0 -80
  306. package/dist/components/IconButton.svelte.d.ts +0 -30
  307. package/dist/themes/default.d.ts +0 -2
  308. package/dist/themes/default.js +0 -9
@@ -1,15 +1,12 @@
1
1
  <!--
2
- ControlPanel Component
2
+ @component
3
+ The part of the Playground where the user talks to the flow.
4
+ The user sees it at the bottom of the Playground (on top for a form-first workflow). It holds the session switcher, the text box with Run and Stop, and the toolbar buttons (Pipeline, Refresh, Logs). It reuses `ChatInput` for typing.
3
5
 
4
- Where the user talks to the flow: session switcher, orchestration controls
5
- (Run/Stop via ChatInput), and toolbar buttons (Pipeline toggle, Refresh,
6
- Logs). Owns the session chip popover; delegates input behaviour to the
7
- shared ChatInput primitive.
6
+ A workflow with inputs but no chat shows the inputs form (`InterfaceInputForm`) with its own Run button and no text box. With a chat as well, the inputs fold into one row above the text box that opens the same form.
8
7
 
9
- A workflow whose interface has inputs but no chat is form-first: the inputs
10
- card (InterfaceInputForm) is the panel, with its own Run, and there is no
11
- composer. With a chat as well, the inputs fold into one row above the
12
- composer that opens the same card.
8
+ **Use it for** sending messages, starting runs and managing sessions in the Playground.
9
+ **Not for** showing what the flow says back; use `ExecutionConsole` instead.
13
10
  -->
14
11
 
15
12
  <script lang="ts">
@@ -29,12 +26,18 @@
29
26
 
30
27
  interface Props {
31
28
  // Session management
29
+ /** Called when the user asks for a new session. */
32
30
  onCreateSession: () => void;
31
+ /** Called with the session id when the user picks a session. */
33
32
  onSelectSession: (id: string) => void;
33
+ /** Called with the session id when the user deletes a session. */
34
34
  onDeleteSession: (id: string) => void;
35
+ /** Called with the session id after a switch, so a host can update its URL. */
35
36
  onSessionNavigate?: (id: string) => void;
36
37
  // Orchestration
38
+ /** Called with the text when the user sends a message. */
37
39
  onSendMessage: (content: string) => void;
40
+ /** Called when the user presses Stop during a run. */
38
41
  onStopExecution: () => void;
39
42
  /** Start a run without posting a chat message. See ChatInput. */
40
43
  onRunWorkflow?: () => void;
@@ -49,17 +52,27 @@
49
52
  */
50
53
  enableCommands?: boolean;
51
54
  // Slash-command feedback (transient; never a session message)
55
+ /** The result of the last slash command, shown briefly. Default: none. */
52
56
  commandFeedback?: CommandOutcome | null;
57
+ /** Called when the user closes the slash-command result. */
53
58
  onDismissCommandFeedback?: () => void;
54
59
  // Header actions
60
+ /** Called when the user presses the Pipeline button. */
55
61
  onTogglePanel?: () => void;
62
+ /** Whether the pipeline panel is open, so the button looks pressed. Default: false. */
56
63
  isPipelinePanelOpen?: boolean;
64
+ /** Called when the user presses Refresh. */
57
65
  onRefresh: () => void;
66
+ /** Show the Refresh button as busy. Default: false. */
58
67
  isRefreshing?: boolean;
59
68
  // Input config
69
+ /** Show the text box. Default: true. */
60
70
  showChatInput?: boolean;
71
+ /** Show the Run button. Default: true. */
61
72
  showRunButton?: boolean;
73
+ /** Text to put in the text box before the user types. Default: none. */
62
74
  predefinedMessage?: string;
75
+ /** Text shown in the empty text box. Default: the built-in message. */
63
76
  placeholder?: string;
64
77
  /**
65
78
  * Interface inputs to collect in a form above the composer (inputs
@@ -78,8 +91,11 @@
78
91
  /** Called with the complete form values on every change. */
79
92
  onFormChange?: (values: Record<string, unknown>) => void;
80
93
  // Session UI config
94
+ /** Show the session header row. Default: true. */
81
95
  showSessionHeader?: boolean;
96
+ /** Show the New session button in the header. Default: true. */
82
97
  showNewSessionButton?: boolean;
98
+ /** Show the session list in the session menu. Default: true. */
83
99
  showSessionList?: boolean;
84
100
  /** The first send creates the session: see ChatInput's `sessionOptional`. */
85
101
  sessionOptional?: boolean;
@@ -87,6 +103,7 @@
87
103
  beforeSend?: () => Promise<boolean>;
88
104
  /** Unsaved edits: the button reads "Save & send". See ChatInput. */
89
105
  saveFirst?: boolean;
106
+ /** Inline CSS applied to the panel root. Default: none. */
90
107
  style?: string;
91
108
  }
92
109
 
@@ -1,11 +1,17 @@
1
1
  import type { WorkflowInterfaceEntry } from '../../types/index.js';
2
2
  import type { CommandOutcome } from '../../playground/commands/index.js';
3
3
  interface Props {
4
+ /** Called when the user asks for a new session. */
4
5
  onCreateSession: () => void;
6
+ /** Called with the session id when the user picks a session. */
5
7
  onSelectSession: (id: string) => void;
8
+ /** Called with the session id when the user deletes a session. */
6
9
  onDeleteSession: (id: string) => void;
10
+ /** Called with the session id after a switch, so a host can update its URL. */
7
11
  onSessionNavigate?: (id: string) => void;
12
+ /** Called with the text when the user sends a message. */
8
13
  onSendMessage: (content: string) => void;
14
+ /** Called when the user presses Stop during a run. */
9
15
  onStopExecution: () => void;
10
16
  /** Start a run without posting a chat message. See ChatInput. */
11
17
  onRunWorkflow?: () => void;
@@ -19,15 +25,25 @@ interface Props {
19
25
  * ControlPanel to its own handler should not.
20
26
  */
21
27
  enableCommands?: boolean;
28
+ /** The result of the last slash command, shown briefly. Default: none. */
22
29
  commandFeedback?: CommandOutcome | null;
30
+ /** Called when the user closes the slash-command result. */
23
31
  onDismissCommandFeedback?: () => void;
32
+ /** Called when the user presses the Pipeline button. */
24
33
  onTogglePanel?: () => void;
34
+ /** Whether the pipeline panel is open, so the button looks pressed. Default: false. */
25
35
  isPipelinePanelOpen?: boolean;
36
+ /** Called when the user presses Refresh. */
26
37
  onRefresh: () => void;
38
+ /** Show the Refresh button as busy. Default: false. */
27
39
  isRefreshing?: boolean;
40
+ /** Show the text box. Default: true. */
28
41
  showChatInput?: boolean;
42
+ /** Show the Run button. Default: true. */
29
43
  showRunButton?: boolean;
44
+ /** Text to put in the text box before the user types. Default: none. */
30
45
  predefinedMessage?: string;
46
+ /** Text shown in the empty text box. Default: the built-in message. */
31
47
  placeholder?: string;
32
48
  /**
33
49
  * Interface inputs to collect in a form above the composer (inputs
@@ -45,8 +61,11 @@ interface Props {
45
61
  formValues?: Record<string, unknown>;
46
62
  /** Called with the complete form values on every change. */
47
63
  onFormChange?: (values: Record<string, unknown>) => void;
64
+ /** Show the session header row. Default: true. */
48
65
  showSessionHeader?: boolean;
66
+ /** Show the New session button in the header. Default: true. */
49
67
  showNewSessionButton?: boolean;
68
+ /** Show the session list in the session menu. Default: true. */
50
69
  showSessionList?: boolean;
51
70
  /** The first send creates the session: see ChatInput's `sessionOptional`. */
52
71
  sessionOptional?: boolean;
@@ -54,8 +73,18 @@ interface Props {
54
73
  beforeSend?: () => Promise<boolean>;
55
74
  /** Unsaved edits: the button reads "Save & send". See ChatInput. */
56
75
  saveFirst?: boolean;
76
+ /** Inline CSS applied to the panel root. Default: none. */
57
77
  style?: string;
58
78
  }
79
+ /**
80
+ * The part of the Playground where the user talks to the flow.
81
+ * The user sees it at the bottom of the Playground (on top for a form-first workflow). It holds the session switcher, the text box with Run and Stop, and the toolbar buttons (Pipeline, Refresh, Logs). It reuses `ChatInput` for typing.
82
+ *
83
+ * A workflow with inputs but no chat shows the inputs form (`InterfaceInputForm`) with its own Run button and no text box. With a chat as well, the inputs fold into one row above the text box that opens the same form.
84
+ *
85
+ * **Use it for** sending messages, starting runs and managing sessions in the Playground.
86
+ * **Not for** showing what the flow says back; use `ExecutionConsole` instead.
87
+ */
59
88
  declare const ControlPanel: import("svelte").Component<Props, {}, "">;
60
89
  type ControlPanel = ReturnType<typeof ControlPanel>;
61
90
  export default ControlPanel;
@@ -1,16 +1,13 @@
1
1
  <!--
2
- DockedPlayground
2
+ @component
3
+ The Playground of Test mode: the conversation docked beside the canvas, for the editor's workflow and the instance's
4
+ test session. It has the history header (`PlaygroundHeader`), the conversation and the composer, and no pipeline panel.
3
5
 
4
- The Playground of the editor's Test mode: the conversation surface beside
5
- the canvas, for the editor's current workflow and the instance's current test
6
- session (`fd.runs`). Compact by design: no minimum width and no pipeline
7
- panel (the canvas shows the run). Its header is two controls: the history
8
- chip (conversations and runs) and the ⋯ menu (PlaygroundHeader). Built on
9
- PlaygroundSurface, not on the standalone Playground, so it does not go when
10
- that one is removed in 3.0.
6
+ The conversation outlives this component. Switching back to Edit unmounts it, the run goes on, and Test finds the
7
+ conversation where it was left.
11
8
 
12
- The session outlives this component: switching back to Edit unmounts it, the
13
- run goes on, and Test finds the conversation where it was left.
9
+ **Use it for** the left panel of Test mode.
10
+ **Not for** the standalone Playground page, which is deprecated.
14
11
  -->
15
12
 
16
13
  <script lang="ts">
@@ -25,6 +25,16 @@ interface Props {
25
25
  */
26
26
  config?: EditorPlaygroundConfig;
27
27
  }
28
+ /**
29
+ * The Playground of Test mode: the conversation docked beside the canvas, for the editor's workflow and the instance's
30
+ * test session. It has the history header (`PlaygroundHeader`), the conversation and the composer, and no pipeline panel.
31
+ *
32
+ * The conversation outlives this component. Switching back to Edit unmounts it, the run goes on, and Test finds the
33
+ * conversation where it was left.
34
+ *
35
+ * **Use it for** the left panel of Test mode.
36
+ * **Not for** the standalone Playground page, which is deprecated.
37
+ */
28
38
  declare const DockedPlayground: import("svelte").Component<Props, {}, "">;
29
39
  type DockedPlayground = ReturnType<typeof DockedPlayground>;
30
40
  export default DockedPlayground;
@@ -1,10 +1,10 @@
1
1
  <!--
2
- ExecutionConsole Component
2
+ @component
3
+ The running workflow's own output surface.
4
+ The user sees it in the Playground above the input area. It lists the messages the flow sends during a run and shows any question the flow asks (an interrupt) right in the feed. It is not a chat box: what the user types goes through `ControlPanel`.
3
5
 
4
- The running workflow's runtime surface. Renders the message feed via
5
- MessageStream and surfaces the flow's own UI (interrupts) inline during
6
- execution. This is *not* a chat — it's the console where the flow speaks
7
- to the user during a run. User-initiated commands live in ControlPanel.
6
+ **Use it for** reading what a run says and answering its questions.
7
+ **Not for** typing messages or starting runs; use `ControlPanel` instead.
8
8
  -->
9
9
 
10
10
  <script lang="ts">
@@ -15,12 +15,17 @@
15
15
  import { m } from '../../messages/index.js';
16
16
 
17
17
  interface Props {
18
+ /** Show a time on each message. Default: true. */
18
19
  showTimestamps?: boolean;
20
+ /** Keep the feed scrolled to the newest message. Default: true. */
19
21
  autoScroll?: boolean;
22
+ /** Render message text as Markdown. Default: true. */
20
23
  enableMarkdown?: boolean;
21
24
  /** Whether log messages can appear when the user toggle is on. Defaults to true for the execution console. */
22
25
  allowLogs?: boolean;
26
+ /** Show system messages in a smaller, quieter style. Default: true. */
23
27
  compactSystemMessages?: boolean;
28
+ /** Called after the user answers a question the flow asked mid-run. */
24
29
  onInterruptResolved?: () => void;
25
30
  /** Optional callback that, when provided, shows a "New session" CTA in the welcome state */
26
31
  onCreateSession?: () => void;
@@ -1,10 +1,15 @@
1
1
  interface Props {
2
+ /** Show a time on each message. Default: true. */
2
3
  showTimestamps?: boolean;
4
+ /** Keep the feed scrolled to the newest message. Default: true. */
3
5
  autoScroll?: boolean;
6
+ /** Render message text as Markdown. Default: true. */
4
7
  enableMarkdown?: boolean;
5
8
  /** Whether log messages can appear when the user toggle is on. Defaults to true for the execution console. */
6
9
  allowLogs?: boolean;
10
+ /** Show system messages in a smaller, quieter style. Default: true. */
7
11
  compactSystemMessages?: boolean;
12
+ /** Called after the user answers a question the flow asked mid-run. */
8
13
  onInterruptResolved?: () => void;
9
14
  /** Optional callback that, when provided, shows a "New session" CTA in the welcome state */
10
15
  onCreateSession?: () => void;
@@ -23,6 +28,13 @@ interface Props {
23
28
  /** Adds a "Playground settings" action to the notice. */
24
29
  onOpenSettings?: () => void;
25
30
  }
31
+ /**
32
+ * The running workflow's own output surface.
33
+ * The user sees it in the Playground above the input area. It lists the messages the flow sends during a run and shows any question the flow asks (an interrupt) right in the feed. It is not a chat box: what the user types goes through `ControlPanel`.
34
+ *
35
+ * **Use it for** reading what a run says and answering its questions.
36
+ * **Not for** typing messages or starting runs; use `ControlPanel` instead.
37
+ */
26
38
  declare const ExecutionConsole: import("svelte").Component<Props, {}, "">;
27
39
  type ExecutionConsole = ReturnType<typeof ExecutionConsole>;
28
40
  export default ExecutionConsole;
@@ -1,11 +1,24 @@
1
+ <!--
2
+ @component
3
+ **Exported for host apps; the editor does not render it.** A plain list of the runs of one session; no surface in the editor renders it any more.
4
+ Each row shows the run id, a status mark (a pulsing dot while running, a tick or alert when done) and a "latest" badge on the newest run. Clicking or pressing Enter on a row selects it.
5
+
6
+ **Use it for** picking one run out of many in a host app's own layout. The editor uses the history menu in `PlaygroundHeader` instead.
7
+ **Not for** showing a run's steps; use `StepsSummary` or `PipelinePanel` instead.
8
+ -->
9
+
1
10
  <script lang="ts">
2
11
  import Icon from '@iconify/svelte';
3
12
  import type { PlaygroundExecution } from '../../types/playground.js';
4
13
 
5
14
  interface Props {
15
+ /** The runs to list, in the order to show them. */
6
16
  executions: PlaygroundExecution[];
17
+ /** Id of the selected run, or null for none. */
7
18
  activeExecutionId: string | null;
19
+ /** Id of the newest run, which gets the "latest" badge, or null. */
8
20
  latestExecutionId: string | null;
21
+ /** Called with the run id when the user picks a row. */
9
22
  onSelect: (executionId: string) => void;
10
23
  }
11
24
 
@@ -1,10 +1,21 @@
1
1
  import type { PlaygroundExecution } from '../../types/playground.js';
2
2
  interface Props {
3
+ /** The runs to list, in the order to show them. */
3
4
  executions: PlaygroundExecution[];
5
+ /** Id of the selected run, or null for none. */
4
6
  activeExecutionId: string | null;
7
+ /** Id of the newest run, which gets the "latest" badge, or null. */
5
8
  latestExecutionId: string | null;
9
+ /** Called with the run id when the user picks a row. */
6
10
  onSelect: (executionId: string) => void;
7
11
  }
12
+ /**
13
+ * **Exported for host apps; the editor does not render it.** A plain list of the runs of one session; no surface in the editor renders it any more.
14
+ * Each row shows the run id, a status mark (a pulsing dot while running, a tick or alert when done) and a "latest" badge on the newest run. Clicking or pressing Enter on a row selects it.
15
+ *
16
+ * **Use it for** picking one run out of many in a host app's own layout. The editor uses the history menu in `PlaygroundHeader` instead.
17
+ * **Not for** showing a run's steps; use `StepsSummary` or `PipelinePanel` instead.
18
+ */
8
19
  declare const ExecutionList: import("svelte").Component<Props, {}, "">;
9
20
  type ExecutionList = ReturnType<typeof ExecutionList>;
10
21
  export default ExecutionList;
@@ -1,13 +1,10 @@
1
1
  <!--
2
- ExecutionLogs Component
3
-
4
- Collapsible panel for displaying execution logs in the playground.
5
- Shows real-time log entries with filtering and export capabilities.
6
- Styled with BEM syntax.
7
-
8
- @deprecated Not used by the Playground surfaces any more: the conversation
9
- folds each turn's steps into one summary row (StepsSummary). Kept exported
10
- for existing consumers.
2
+ @component
3
+ **Legacy.** A collapsible log panel that no Playground surface renders any more; `StepsSummary` replaced it.
4
+ It shows log lines with a level filter and an export button. It stays exported for existing consumers and is removed in 3.0.
5
+
6
+ **Use it for** nothing new. The conversation now folds each turn's steps into one row.
7
+ **Not for** current Playground work; use `StepsSummary` (inside `MessageStream`) instead.
11
8
  -->
12
9
 
13
10
  <script lang="ts">
@@ -9,6 +9,13 @@ interface Props {
9
9
  /** Callback when expansion state changes */
10
10
  onToggle?: (expanded: boolean) => void;
11
11
  }
12
+ /**
13
+ * **Legacy.** A collapsible log panel that no Playground surface renders any more; `StepsSummary` replaced it.
14
+ * It shows log lines with a level filter and an export button. It stays exported for existing consumers and is removed in 3.0.
15
+ *
16
+ * **Use it for** nothing new. The conversation now folds each turn's steps into one row.
17
+ * **Not for** current Playground work; use `StepsSummary` (inside `MessageStream`) instead.
18
+ */
12
19
  declare const ExecutionLogs: import("svelte").Component<Props, {}, "isExpanded">;
13
20
  type ExecutionLogs = ReturnType<typeof ExecutionLogs>;
14
21
  export default ExecutionLogs;
@@ -1,14 +1,12 @@
1
1
  <!--
2
- HeaderMenu
2
+ @component
3
+ A button that opens a menu.
4
+ The user sees it twice in the docked Playground's header: as the history chip and as the ... menu. It is a thin skin over the `Menu` primitive, which handles keyboard use, screen readers and positioning.
3
5
 
4
- A button that opens a menu: the one control behind both the history chip and
5
- the ⋯ menu of the docked Playground's header. A thin skin over the `Menu`
6
- primitive, which owns keyboard handling (arrows, Home/End, typeahead, Escape,
7
- Tab), ARIA and positioning.
6
+ Menu items are any elements with `role="menuitem"`, `menuitemcheckbox` or `menuitemradio` inside `children`. `children` receives `close` so an item can close the menu after it acts.
8
7
 
9
- Items are any element with `role="menuitem"`, `menuitemcheckbox` or
10
- `menuitemradio` inside `children`, which receives `close` so an item can
11
- close the menu after it acts.
8
+ **Use it for** the history chip and the more-actions menu in `PlaygroundHeader`.
9
+ **Not for** a general dropdown; use the `Menu` primitive directly instead.
12
10
  -->
13
11
 
14
12
  <script lang="ts">
@@ -17,6 +17,15 @@ interface Props {
17
17
  /** `chip` is a labelled pill, `icon` a square icon button. @default 'chip' */
18
18
  variant?: 'chip' | 'icon';
19
19
  }
20
+ /**
21
+ * A button that opens a menu.
22
+ * The user sees it twice in the docked Playground's header: as the history chip and as the ... menu. It is a thin skin over the `Menu` primitive, which handles keyboard use, screen readers and positioning.
23
+ *
24
+ * Menu items are any elements with `role="menuitem"`, `menuitemcheckbox` or `menuitemradio` inside `children`. `children` receives `close` so an item can close the menu after it acts.
25
+ *
26
+ * **Use it for** the history chip and the more-actions menu in `PlaygroundHeader`.
27
+ * **Not for** a general dropdown; use the `Menu` primitive directly instead.
28
+ */
20
29
  declare const HeaderMenu: import("svelte").Component<Props, {}, "">;
21
30
  type HeaderMenu = ReturnType<typeof HeaderMenu>;
22
31
  export default HeaderMenu;
@@ -1,11 +1,10 @@
1
1
  <!--
2
- HierarchyTrail Component
2
+ @component
3
+ A small trail such as "Support chat › Order lookup" that shows where a message came from, for example a
4
+ sub-workflow or a loop pass. It is a display, not navigation. Screen readers read the whole path once.
3
5
 
4
- Renders a chevron-separated path of MessageHierarchyItem entries. The
5
- path is a *display*, not a list users navigate, so the SR announcement
6
- comes entirely from the wrapper's aria-label (built from the labels of
7
- the items themselves) and the visible chips are hidden from AT to avoid
8
- the path being announced twice.
6
+ **Use it for** the footer of a message or an interrupt card.
7
+ **Not for** page breadcrumbs (the `Navbar` has those).
9
8
  -->
10
9
 
11
10
  <script lang="ts">
@@ -14,6 +13,7 @@
14
13
  import { m } from '../../messages/index.js';
15
14
 
16
15
  interface Props {
16
+ /** The path, outermost first. */
17
17
  items: MessageHierarchyItem[];
18
18
  }
19
19
 
@@ -1,7 +1,15 @@
1
1
  import type { MessageHierarchyItem } from '../../types/playground.js';
2
2
  interface Props {
3
+ /** The path, outermost first. */
3
4
  items: MessageHierarchyItem[];
4
5
  }
6
+ /**
7
+ * A small trail such as "Support chat › Order lookup" that shows where a message came from, for example a
8
+ * sub-workflow or a loop pass. It is a display, not navigation. Screen readers read the whole path once.
9
+ *
10
+ * **Use it for** the footer of a message or an interrupt card.
11
+ * **Not for** page breadcrumbs (the `Navbar` has those).
12
+ */
5
13
  declare const HierarchyTrail: import("svelte").Component<Props, {}, "">;
6
14
  type HierarchyTrail = ReturnType<typeof HierarchyTrail>;
7
15
  export default HierarchyTrail;
@@ -1,9 +1,10 @@
1
1
  <!--
2
- InputCollector Component
3
-
4
- Auto-generates input forms from workflow input nodes.
5
- Supports various field types and pre-fills with defaults.
6
- Styled with BEM syntax.
2
+ @component
3
+ **Exported for host apps; the editor does not render it.** An older inputs panel built from the workflow's input nodes; nothing in the editor renders it any more.
4
+ It builds one field per input node (text, number, checkbox, select, multiline), fills in defaults once, and can be folded away.
5
+
6
+ **Use it for** nothing new. The Playground now shows the interface inputs card.
7
+ **Not for** the Playground's inputs; use `InterfaceInputForm` instead.
7
8
  -->
8
9
 
9
10
  <script lang="ts">
@@ -11,6 +11,13 @@ interface Props {
11
11
  /** Callback when values change */
12
12
  onValuesChange?: (values: Record<string, unknown>) => void;
13
13
  }
14
+ /**
15
+ * **Exported for host apps; the editor does not render it.** An older inputs panel built from the workflow's input nodes; nothing in the editor renders it any more.
16
+ * It builds one field per input node (text, number, checkbox, select, multiline), fills in defaults once, and can be folded away.
17
+ *
18
+ * **Use it for** nothing new. The Playground now shows the interface inputs card.
19
+ * **Not for** the Playground's inputs; use `InterfaceInputForm` instead.
20
+ */
14
21
  declare const InputCollector: import("svelte").Component<Props, {}, "values" | "isExpanded">;
15
22
  type InputCollector = ReturnType<typeof InputCollector>;
16
23
  export default InputCollector;
@@ -1,16 +1,12 @@
1
1
  <!--
2
- InputFields
3
-
4
- One `Field` per property of an object schema: the controls the Playground's
5
- inputs card and a form interrupt share. A string, number, boolean or enum
6
- property renders as its native control; an array or object property renders
7
- as a JSON text box with example chips (the interface definition's
8
- `examples` and `default`), since a typed list editor does not fit a panel
9
- this narrow. The text is kept as typed: whoever sends the values parses it
10
- (`collectInterfaceInputs`).
11
-
12
- Values are keyed by property name, and every change reports the complete
13
- values.
2
+ @component
3
+ The form fields for an object schema.
4
+ The user sees them in the Playground's inputs card and in a form question the flow asks mid-run. A string, number, boolean or enum property gets its native control. An array or object property gets a JSON text box with example chips, because a list editor does not fit a narrow panel. The text stays as typed; whoever sends the values parses it.
5
+
6
+ Values are keyed by property name, and every change reports all values.
7
+
8
+ **Use it for** the controls inside `InterfaceInputForm` and form interrupts.
9
+ **Not for** the whole inputs card with its Run button; use `InterfaceInputForm` instead.
14
10
  -->
15
11
 
16
12
  <script lang="ts">
@@ -11,6 +11,15 @@ interface Props {
11
11
  /** Disable every control. */
12
12
  disabled?: boolean;
13
13
  }
14
+ /**
15
+ * The form fields for an object schema.
16
+ * The user sees them in the Playground's inputs card and in a form question the flow asks mid-run. A string, number, boolean or enum property gets its native control. An array or object property gets a JSON text box with example chips, because a list editor does not fit a narrow panel. The text stays as typed; whoever sends the values parses it.
17
+ *
18
+ * Values are keyed by property name, and every change reports all values.
19
+ *
20
+ * **Use it for** the controls inside `InterfaceInputForm` and form interrupts.
21
+ * **Not for** the whole inputs card with its Run button; use `InterfaceInputForm` instead.
22
+ */
14
23
  declare const InputFields: import("svelte").Component<Props, {}, "">;
15
24
  type InputFields = ReturnType<typeof InputFields>;
16
25
  export default InputFields;
@@ -1,19 +1,12 @@
1
1
  <!--
2
- InterfaceInputForm Component
2
+ @component
3
+ The inputs card of the Playground for a workflow whose interface has inputs: one field for each input, a blue Run
4
+ (Cmd/Ctrl+Enter), which becomes Stop while a run is going, and "Fill from last run".
3
5
 
4
- The inputs card a workflow's interface inputs render as in the Playground:
5
- one field per input entry without a chat turn (the session fills turn
6
- ports, so they never appear here). Values are keyed by entry id, the name
7
- the server matches `inputs` on. The fields are InputFields'; this component
8
- frames them and adds what a form-first panel needs:
6
+ Without `onRun` (the folded Inputs row above a chat composer) the card has no Run: the composer's Send takes the turn.
9
7
 
10
- - a blue Run (⌘↵ / Ctrl+↵ from anywhere in the card), turned into Stop while
11
- a run is in flight, with a refusal named under it;
12
- - "Fill from last run", and the session's earlier runs below the card (pick
13
- one to refill, never to run).
14
-
15
- Without `onRun` (the folded Inputs row above a chat composer) the card has
16
- no Run: the composer's Send takes the turn.
8
+ **Use it for** the panel of a workflow that has inputs and no chat.
9
+ **Not for** one line of chat (use `ChatInput`).
17
10
  -->
18
11
 
19
12
  <script lang="ts">
@@ -29,6 +29,15 @@ interface Props {
29
29
  /** Extra feedback from the launch (a refused launch), named under the button. */
30
30
  notice?: string | null;
31
31
  }
32
+ /**
33
+ * The inputs card of the Playground for a workflow whose interface has inputs: one field for each input, a blue Run
34
+ * (Cmd/Ctrl+Enter), which becomes Stop while a run is going, and "Fill from last run".
35
+ *
36
+ * Without `onRun` (the folded Inputs row above a chat composer) the card has no Run: the composer's Send takes the turn.
37
+ *
38
+ * **Use it for** the panel of a workflow that has inputs and no chat.
39
+ * **Not for** one line of chat (use `ChatInput`).
40
+ */
32
41
  declare const InterfaceInputForm: import("svelte").Component<Props, {}, "">;
33
42
  type InterfaceInputForm = ReturnType<typeof InterfaceInputForm>;
34
43
  export default InterfaceInputForm;
@@ -1,10 +1,10 @@
1
1
  <!--
2
- InterfaceJsonInput
2
+ @component
3
+ The interface inputs as raw JSON.
4
+ The user sees it when they choose "JSON view" in the Playground's ... menu. It edits the same values as the typed form, keyed by entry id. Text that is not a JSON object is held back with a note, and the form keeps its last good values.
3
5
 
4
- The workflow's interface inputs as JSON: the escape hatch beside the typed
5
- form (the Playground's ⋯ menu, "JSON view"). Edits the same values the form
6
- does, keyed by entry id. Text that does not parse as a JSON object is held
7
- back with a note; the form's last good values stay until it does.
6
+ **Use it for** pasting or editing all inputs at once.
7
+ **Not for** the normal typed form; use `InputFields` instead.
8
8
  -->
9
9
 
10
10
  <script lang="ts">
@@ -16,6 +16,7 @@
16
16
  values: Record<string, unknown>;
17
17
  /** Called with the complete values when the text is a valid JSON object. */
18
18
  onChange: (values: Record<string, unknown>) => void;
19
+ /** Make the text box read-only. Default: false. */
19
20
  disabled?: boolean;
20
21
  }
21
22
 
@@ -3,8 +3,16 @@ interface Props {
3
3
  values: Record<string, unknown>;
4
4
  /** Called with the complete values when the text is a valid JSON object. */
5
5
  onChange: (values: Record<string, unknown>) => void;
6
+ /** Make the text box read-only. Default: false. */
6
7
  disabled?: boolean;
7
8
  }
9
+ /**
10
+ * The interface inputs as raw JSON.
11
+ * The user sees it when they choose "JSON view" in the Playground's ... menu. It edits the same values as the typed form, keyed by entry id. Text that is not a JSON object is held back with a note, and the form keeps its last good values.
12
+ *
13
+ * **Use it for** pasting or editing all inputs at once.
14
+ * **Not for** the normal typed form; use `InputFields` instead.
15
+ */
8
16
  declare const InterfaceJsonInput: import("svelte").Component<Props, {}, "">;
9
17
  type InterfaceJsonInput = ReturnType<typeof InterfaceJsonInput>;
10
18
  export default InterfaceJsonInput;
@@ -1,10 +1,9 @@
1
1
  <!--
2
- LogRow — dense terminal-style entry for one log message.
2
+ @component
3
+ A dense, terminal-style line for one log message. The conversation folds a turn's log rows into one steps row
4
+ (`StepsSummary`), so this stays for hosts that render a single message through `MessageBubble`.
3
5
 
4
- The conversation no longer renders these: MessageStream folds a turn's log
5
- rows into one StepsSummary row. LogRow stays for consumers that render a
6
- single message through MessageBubble. It carries no breadcrumb trail, and
7
- the origin chip (OriginBadge) is not drawn for the Playground's own rows.
6
+ **Use it for** nothing on its own. Render a message with `MessageBubble`.
8
7
  -->
9
8
 
10
9
  <script lang="ts">
@@ -3,6 +3,12 @@ interface Props {
3
3
  message: PlaygroundMessage;
4
4
  showTimestamp?: boolean;
5
5
  }
6
+ /**
7
+ * A dense, terminal-style line for one log message. The conversation folds a turn's log rows into one steps row
8
+ * (`StepsSummary`), so this stays for hosts that render a single message through `MessageBubble`.
9
+ *
10
+ * **Use it for** nothing on its own. Render a message with `MessageBubble`.
11
+ */
6
12
  declare const LogRow: import("svelte").Component<Props, {}, "">;
7
13
  type LogRow = ReturnType<typeof LogRow>;
8
14
  export default LogRow;