@stigmer/react 0.5.1 → 1.0.1

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 (625) hide show
  1. package/activity/group-activity.d.ts +13 -0
  2. package/activity/group-activity.d.ts.map +1 -0
  3. package/activity/group-activity.js +54 -0
  4. package/activity/group-activity.js.map +1 -0
  5. package/activity/index.d.ts +4 -0
  6. package/activity/index.d.ts.map +1 -0
  7. package/activity/index.js +3 -0
  8. package/activity/index.js.map +1 -0
  9. package/activity/types.d.ts +34 -0
  10. package/activity/types.d.ts.map +1 -0
  11. package/activity/types.js +2 -0
  12. package/activity/types.js.map +1 -0
  13. package/activity/useRecentActivity.d.ts +35 -0
  14. package/activity/useRecentActivity.d.ts.map +1 -0
  15. package/activity/useRecentActivity.js +73 -0
  16. package/activity/useRecentActivity.js.map +1 -0
  17. package/agent/AgentPicker.d.ts.map +1 -1
  18. package/agent/AgentPicker.js +4 -2
  19. package/agent/AgentPicker.js.map +1 -1
  20. package/billing/BillingSection.d.ts.map +1 -1
  21. package/billing/BillingSection.js +1 -1
  22. package/billing/BillingSection.js.map +1 -1
  23. package/composer/ComposerToolbar.d.ts +5 -1
  24. package/composer/ComposerToolbar.d.ts.map +1 -1
  25. package/composer/ComposerToolbar.js +4 -3
  26. package/composer/ComposerToolbar.js.map +1 -1
  27. package/composer/InteractionModePicker.d.ts +40 -0
  28. package/composer/InteractionModePicker.d.ts.map +1 -0
  29. package/composer/InteractionModePicker.js +76 -0
  30. package/composer/InteractionModePicker.js.map +1 -0
  31. package/composer/SessionComposer.d.ts +53 -64
  32. package/composer/SessionComposer.d.ts.map +1 -1
  33. package/composer/SessionComposer.js +20 -8
  34. package/composer/SessionComposer.js.map +1 -1
  35. package/composer/__tests__/SessionComposer-memo.test.js +10 -5
  36. package/composer/__tests__/SessionComposer-memo.test.js.map +1 -1
  37. package/composer/index.d.ts +3 -1
  38. package/composer/index.d.ts.map +1 -1
  39. package/composer/index.js +1 -0
  40. package/composer/index.js.map +1 -1
  41. package/dashboard/DashboardFailedRuns.d.ts +19 -0
  42. package/dashboard/DashboardFailedRuns.d.ts.map +1 -0
  43. package/dashboard/DashboardFailedRuns.js +35 -0
  44. package/dashboard/DashboardFailedRuns.js.map +1 -0
  45. package/dashboard/DashboardKPICards.d.ts +19 -0
  46. package/dashboard/DashboardKPICards.d.ts.map +1 -0
  47. package/dashboard/DashboardKPICards.js +80 -0
  48. package/dashboard/DashboardKPICards.js.map +1 -0
  49. package/dashboard/OperationalDashboard.d.ts +37 -0
  50. package/dashboard/OperationalDashboard.d.ts.map +1 -0
  51. package/dashboard/OperationalDashboard.js +48 -0
  52. package/dashboard/OperationalDashboard.js.map +1 -0
  53. package/dashboard/index.d.ts +8 -0
  54. package/dashboard/index.d.ts.map +1 -0
  55. package/dashboard/index.js +9 -0
  56. package/dashboard/index.js.map +1 -0
  57. package/dashboard/types.d.ts +49 -0
  58. package/dashboard/types.d.ts.map +1 -0
  59. package/dashboard/types.js +2 -0
  60. package/dashboard/types.js.map +1 -0
  61. package/dashboard/useAgentExecutionSummary.d.ts +33 -0
  62. package/dashboard/useAgentExecutionSummary.d.ts.map +1 -0
  63. package/dashboard/useAgentExecutionSummary.js +32 -0
  64. package/dashboard/useAgentExecutionSummary.js.map +1 -0
  65. package/dashboard/useDashboardFailedRuns.d.ts +18 -0
  66. package/dashboard/useDashboardFailedRuns.d.ts.map +1 -0
  67. package/dashboard/useDashboardFailedRuns.js +86 -0
  68. package/dashboard/useDashboardFailedRuns.js.map +1 -0
  69. package/dashboard/useDashboardSummary.d.ts +32 -0
  70. package/dashboard/useDashboardSummary.d.ts.map +1 -0
  71. package/dashboard/useDashboardSummary.js +67 -0
  72. package/dashboard/useDashboardSummary.js.map +1 -0
  73. package/execution/ContextGauge.d.ts +45 -0
  74. package/execution/ContextGauge.d.ts.map +1 -0
  75. package/execution/ContextGauge.js +82 -0
  76. package/execution/ContextGauge.js.map +1 -0
  77. package/execution/InteractionModeBadge.d.ts +24 -0
  78. package/execution/InteractionModeBadge.d.ts.map +1 -0
  79. package/execution/InteractionModeBadge.js +29 -0
  80. package/execution/InteractionModeBadge.js.map +1 -0
  81. package/execution/MessageThread.d.ts +33 -3
  82. package/execution/MessageThread.d.ts.map +1 -1
  83. package/execution/MessageThread.js +51 -9
  84. package/execution/MessageThread.js.map +1 -1
  85. package/execution/PlanCompletionCard.d.ts +23 -0
  86. package/execution/PlanCompletionCard.d.ts.map +1 -0
  87. package/execution/PlanCompletionCard.js +28 -0
  88. package/execution/PlanCompletionCard.js.map +1 -0
  89. package/execution/SummarizationBadge.d.ts +30 -0
  90. package/execution/SummarizationBadge.d.ts.map +1 -0
  91. package/execution/SummarizationBadge.js +61 -0
  92. package/execution/SummarizationBadge.js.map +1 -0
  93. package/execution/SummarizationCard.d.ts +27 -0
  94. package/execution/SummarizationCard.d.ts.map +1 -0
  95. package/execution/SummarizationCard.js +47 -0
  96. package/execution/SummarizationCard.js.map +1 -0
  97. package/execution/__tests__/PlanCompletionCard.test.d.ts +2 -0
  98. package/execution/__tests__/PlanCompletionCard.test.d.ts.map +1 -0
  99. package/execution/__tests__/PlanCompletionCard.test.js +53 -0
  100. package/execution/__tests__/PlanCompletionCard.test.js.map +1 -0
  101. package/execution/__tests__/buildThreadItems-plan-completion.test.d.ts +2 -0
  102. package/execution/__tests__/buildThreadItems-plan-completion.test.d.ts.map +1 -0
  103. package/execution/__tests__/buildThreadItems-plan-completion.test.js +137 -0
  104. package/execution/__tests__/buildThreadItems-plan-completion.test.js.map +1 -0
  105. package/execution/__tests__/useContextWindow.test.d.ts +2 -0
  106. package/execution/__tests__/useContextWindow.test.d.ts.map +1 -0
  107. package/execution/__tests__/useContextWindow.test.js +121 -0
  108. package/execution/__tests__/useContextWindow.test.js.map +1 -0
  109. package/execution/index.d.ts +12 -0
  110. package/execution/index.d.ts.map +1 -1
  111. package/execution/index.js +6 -0
  112. package/execution/index.js.map +1 -1
  113. package/execution/useContextWindow.d.ts +71 -0
  114. package/execution/useContextWindow.d.ts.map +1 -0
  115. package/execution/useContextWindow.js +91 -0
  116. package/execution/useContextWindow.js.map +1 -0
  117. package/execution/useCreateAgentExecution.d.ts +9 -0
  118. package/execution/useCreateAgentExecution.d.ts.map +1 -1
  119. package/execution/useCreateAgentExecution.js +15 -3
  120. package/execution/useCreateAgentExecution.js.map +1 -1
  121. package/index.d.ts +9 -4
  122. package/index.d.ts.map +1 -1
  123. package/index.js +12 -2
  124. package/index.js.map +1 -1
  125. package/internal/VirtualizedThread.d.ts +2 -1
  126. package/internal/VirtualizedThread.d.ts.map +1 -1
  127. package/internal/VirtualizedThread.js +3 -2
  128. package/internal/VirtualizedThread.js.map +1 -1
  129. package/internal/store/index.d.ts +1 -0
  130. package/internal/store/index.d.ts.map +1 -1
  131. package/internal/store/index.js +1 -0
  132. package/internal/store/index.js.map +1 -1
  133. package/internal/store/workflow-execution-event-store.d.ts +92 -0
  134. package/internal/store/workflow-execution-event-store.d.ts.map +1 -0
  135. package/internal/store/workflow-execution-event-store.js +298 -0
  136. package/internal/store/workflow-execution-event-store.js.map +1 -0
  137. package/library/ScopeToggle.d.ts +13 -9
  138. package/library/ScopeToggle.d.ts.map +1 -1
  139. package/library/ScopeToggle.js +43 -22
  140. package/library/ScopeToggle.js.map +1 -1
  141. package/library/VisibilityToggle.js +14 -5
  142. package/library/VisibilityToggle.js.map +1 -1
  143. package/library/index.d.ts +1 -0
  144. package/library/index.d.ts.map +1 -1
  145. package/library/index.js +1 -0
  146. package/library/index.js.map +1 -1
  147. package/library/useExportResource.d.ts +3 -2
  148. package/library/useExportResource.d.ts.map +1 -1
  149. package/library/useExportResource.js +11 -6
  150. package/library/useExportResource.js.map +1 -1
  151. package/mcp-server/McpServerDetailView.d.ts.map +1 -1
  152. package/mcp-server/McpServerDetailView.js +25 -13
  153. package/mcp-server/McpServerDetailView.js.map +1 -1
  154. package/mcp-server/McpServerPicker.d.ts.map +1 -1
  155. package/mcp-server/McpServerPicker.js +4 -2
  156. package/mcp-server/McpServerPicker.js.map +1 -1
  157. package/package.json +16 -5
  158. package/provider.d.ts.map +1 -1
  159. package/provider.js +164 -1
  160. package/provider.js.map +1 -1
  161. package/resource-detail/ResourceDetailShell.d.ts +1 -1
  162. package/resource-detail/ResourceDetailShell.d.ts.map +1 -1
  163. package/resource-detail/ResourceDetailShell.js +6 -6
  164. package/resource-detail/ResourceDetailShell.js.map +1 -1
  165. package/resource-detail/types.d.ts +23 -0
  166. package/resource-detail/types.d.ts.map +1 -1
  167. package/resource-detail/useDeleteResource.d.ts +1 -1
  168. package/resource-detail/useDeleteResource.d.ts.map +1 -1
  169. package/resource-detail/useDeleteResource.js +5 -0
  170. package/resource-detail/useDeleteResource.js.map +1 -1
  171. package/resource-workbench/components/ResourceWorkbench.d.ts.map +1 -1
  172. package/resource-workbench/components/ResourceWorkbench.js +2 -1
  173. package/resource-workbench/components/ResourceWorkbench.js.map +1 -1
  174. package/session/useNewSessionFlow.d.ts.map +1 -1
  175. package/session/useNewSessionFlow.js +1 -0
  176. package/session/useNewSessionFlow.js.map +1 -1
  177. package/session/useSessionConversation.d.ts +7 -0
  178. package/session/useSessionConversation.d.ts.map +1 -1
  179. package/session/useSessionConversation.js +1 -0
  180. package/session/useSessionConversation.js.map +1 -1
  181. package/session/useSessionPageFlow.d.ts.map +1 -1
  182. package/session/useSessionPageFlow.js +1 -0
  183. package/session/useSessionPageFlow.js.map +1 -1
  184. package/session/useSessionUsage.d.ts.map +1 -1
  185. package/session/useSessionUsage.js +65 -4
  186. package/session/useSessionUsage.js.map +1 -1
  187. package/settings/UsageSection.d.ts.map +1 -1
  188. package/settings/UsageSection.js +1 -4
  189. package/settings/UsageSection.js.map +1 -1
  190. package/skill/SkillPicker.d.ts.map +1 -1
  191. package/skill/SkillPicker.js +4 -2
  192. package/skill/SkillPicker.js.map +1 -1
  193. package/src/activity/group-activity.ts +65 -0
  194. package/src/activity/index.ts +13 -0
  195. package/src/activity/types.ts +35 -0
  196. package/src/activity/useRecentActivity.ts +131 -0
  197. package/src/agent/AgentPicker.tsx +6 -1
  198. package/src/billing/BillingSection.tsx +3 -2
  199. package/src/composer/ComposerToolbar.tsx +19 -1
  200. package/src/composer/InteractionModePicker.tsx +189 -0
  201. package/src/composer/SessionComposer.tsx +85 -8
  202. package/src/composer/__tests__/SessionComposer-memo.test.ts +11 -6
  203. package/src/composer/index.ts +7 -0
  204. package/src/dashboard/DashboardFailedRuns.tsx +109 -0
  205. package/src/dashboard/DashboardKPICards.tsx +128 -0
  206. package/src/dashboard/OperationalDashboard.tsx +96 -0
  207. package/src/dashboard/index.ts +37 -0
  208. package/src/dashboard/types.ts +50 -0
  209. package/src/dashboard/useAgentExecutionSummary.ts +71 -0
  210. package/src/dashboard/useDashboardFailedRuns.ts +122 -0
  211. package/src/dashboard/useDashboardSummary.ts +109 -0
  212. package/src/execution/ContextGauge.tsx +243 -0
  213. package/src/execution/InteractionModeBadge.tsx +70 -0
  214. package/src/execution/MessageThread.tsx +88 -3
  215. package/src/execution/PlanCompletionCard.tsx +105 -0
  216. package/src/execution/SummarizationBadge.tsx +188 -0
  217. package/src/execution/SummarizationCard.tsx +126 -0
  218. package/src/execution/__tests__/PlanCompletionCard.test.tsx +67 -0
  219. package/src/execution/__tests__/buildThreadItems-plan-completion.test.ts +197 -0
  220. package/src/execution/__tests__/useContextWindow.test.ts +167 -0
  221. package/src/execution/index.ts +22 -0
  222. package/src/execution/useContextWindow.ts +148 -0
  223. package/src/execution/useCreateAgentExecution.ts +26 -3
  224. package/src/index.ts +222 -0
  225. package/src/internal/VirtualizedThread.tsx +4 -1
  226. package/src/internal/store/index.ts +6 -0
  227. package/src/internal/store/workflow-execution-event-store.ts +391 -0
  228. package/src/library/ScopeToggle.tsx +88 -20
  229. package/src/library/VisibilityToggle.tsx +54 -13
  230. package/src/library/index.ts +2 -0
  231. package/src/library/useExportResource.ts +12 -9
  232. package/src/mcp-server/McpServerDetailView.tsx +80 -148
  233. package/src/mcp-server/McpServerPicker.tsx +6 -1
  234. package/src/provider.tsx +195 -8
  235. package/src/resource-detail/ResourceDetailShell.tsx +21 -4
  236. package/src/resource-detail/types.ts +25 -0
  237. package/src/resource-detail/useDeleteResource.ts +6 -1
  238. package/src/resource-workbench/components/ResourceWorkbench.tsx +4 -0
  239. package/src/session/useNewSessionFlow.ts +1 -0
  240. package/src/session/useSessionConversation.ts +8 -0
  241. package/src/session/useSessionPageFlow.ts +1 -0
  242. package/src/session/useSessionUsage.ts +72 -4
  243. package/src/settings/UsageSection.tsx +1 -9
  244. package/src/skill/SkillPicker.tsx +6 -1
  245. package/src/workflow/ApprovalFormBuilder.tsx +1017 -0
  246. package/src/workflow/BranchConditionBuilder.tsx +451 -0
  247. package/src/workflow/CanvasActionsContext.ts +12 -0
  248. package/src/workflow/CanvasContextMenu.tsx +364 -0
  249. package/src/workflow/CanvasTaskNode.tsx +372 -0
  250. package/src/workflow/CanvasTransitionEdge.tsx +122 -0
  251. package/src/workflow/CostByWorkflowChart.tsx +120 -0
  252. package/src/workflow/ExecutionSummaryWidget.tsx +194 -0
  253. package/src/workflow/ExecutionTrendChart.tsx +157 -0
  254. package/src/workflow/FailedRunsWidget.tsx +109 -0
  255. package/src/workflow/PendingApprovalsWidget.tsx +115 -0
  256. package/src/workflow/TaskConfigForm.tsx +618 -0
  257. package/src/workflow/TaskKindRegistryContext.ts +36 -0
  258. package/src/workflow/TaskPickerPopover.tsx +326 -0
  259. package/src/workflow/WorkflowArchitectDialog.tsx +505 -0
  260. package/src/workflow/WorkflowCanvasEditor.tsx +651 -0
  261. package/src/workflow/WorkflowCanvasInner.tsx +160 -0
  262. package/src/workflow/WorkflowDashboard.tsx +124 -0
  263. package/src/workflow/WorkflowDetailView.tsx +527 -0
  264. package/src/workflow/WorkflowEditorView.tsx +547 -0
  265. package/src/workflow/WorkflowExecutionApprovalCard.tsx +129 -0
  266. package/src/workflow/WorkflowExecutionArtifactPanel.tsx +112 -0
  267. package/src/workflow/WorkflowExecutionCostPanel.tsx +131 -0
  268. package/src/workflow/WorkflowExecutionHeader.tsx +194 -0
  269. package/src/workflow/WorkflowExecutionPhaseBadge.tsx +188 -0
  270. package/src/workflow/WorkflowExecutionTaskPanel.tsx +135 -0
  271. package/src/workflow/WorkflowExecutionTimeline.tsx +118 -0
  272. package/src/workflow/WorkflowExecutionTimelineEvent.tsx +488 -0
  273. package/src/workflow/WorkflowExecutionViewer.tsx +248 -0
  274. package/src/workflow/WorkflowInspectorPanel.tsx +568 -0
  275. package/src/workflow/WorkflowRefinePanel.tsx +411 -0
  276. package/src/workflow/WorkflowRepairCard.tsx +433 -0
  277. package/src/workflow/WorkflowRunDialog.tsx +220 -0
  278. package/src/workflow/WorkflowRunForm.tsx +245 -0
  279. package/src/workflow/WorkflowTaskList.tsx +177 -0
  280. package/src/workflow/WorkflowTaskPalette.tsx +248 -0
  281. package/src/workflow/WorkflowTopologyGraph.tsx +250 -0
  282. package/src/workflow/WorkflowYamlEditor.tsx +271 -0
  283. package/src/workflow/__tests__/starter-workflow-yaml.test.ts +57 -0
  284. package/src/workflow/canvas-constants.ts +87 -0
  285. package/src/workflow/canvas-icons.tsx +36 -0
  286. package/src/workflow/extract-workflow-yaml.ts +87 -0
  287. package/src/workflow/graph-commands.ts +675 -0
  288. package/src/workflow/index.ts +375 -0
  289. package/src/workflow/serialize-workflow-yaml.ts +546 -0
  290. package/src/workflow/starter-workflow-yaml.ts +29 -0
  291. package/src/workflow/types.ts +99 -0
  292. package/src/workflow/useCanvasKeyboardShortcuts.ts +134 -0
  293. package/src/workflow/useDiagnoseExecutionFlow.ts +378 -0
  294. package/src/workflow/useGraphHistory.ts +138 -0
  295. package/src/workflow/usePendingApprovals.ts +89 -0
  296. package/src/workflow/useRefineWorkflowFlow.ts +321 -0
  297. package/src/workflow/useResolveAgentExecutionSession.ts +57 -0
  298. package/src/workflow/useRunWorkflowFlow.ts +235 -0
  299. package/src/workflow/useTaskKindRegistry.ts +135 -0
  300. package/src/workflow/useWorkflow.ts +78 -0
  301. package/src/workflow/useWorkflowArchitectFlow.ts +303 -0
  302. package/src/workflow/useWorkflowCanvas.ts +882 -0
  303. package/src/workflow/useWorkflowCount.ts +66 -0
  304. package/src/workflow/useWorkflowDashboardSummary.ts +71 -0
  305. package/src/workflow/useWorkflowEditor.ts +106 -0
  306. package/src/workflow/useWorkflowExecution.ts +67 -0
  307. package/src/workflow/useWorkflowExecutionActions.ts +179 -0
  308. package/src/workflow/useWorkflowExecutionArtifacts.ts +57 -0
  309. package/src/workflow/useWorkflowExecutionEventLog.ts +111 -0
  310. package/src/workflow/useWorkflowExecutionEventStream.ts +244 -0
  311. package/src/workflow/useWorkflowExecutionList.ts +121 -0
  312. package/src/workflow/useWorkflowInstances.ts +62 -0
  313. package/src/workflow/useWorkflowList.ts +79 -0
  314. package/src/workflow/useWorkflowSave.ts +84 -0
  315. package/src/workflow/useWorkflowTopology.ts +229 -0
  316. package/src/workflow/useWorkflowValidation.ts +329 -0
  317. package/src/workflow/useWorkflowYaml.ts +49 -0
  318. package/src/workflow/workflow-graph-conversions.ts +796 -0
  319. package/src/workflow/workflow-graph-model.ts +83 -0
  320. package/src/workflow/workflow-yaml-diff.ts +132 -0
  321. package/styles.css +1 -1
  322. package/workflow/ApprovalFormBuilder.d.ts +24 -0
  323. package/workflow/ApprovalFormBuilder.d.ts.map +1 -0
  324. package/workflow/ApprovalFormBuilder.js +347 -0
  325. package/workflow/ApprovalFormBuilder.js.map +1 -0
  326. package/workflow/BranchConditionBuilder.d.ts +29 -0
  327. package/workflow/BranchConditionBuilder.d.ts.map +1 -0
  328. package/workflow/BranchConditionBuilder.js +170 -0
  329. package/workflow/BranchConditionBuilder.js.map +1 -0
  330. package/workflow/CanvasActionsContext.d.ts +8 -0
  331. package/workflow/CanvasActionsContext.d.ts.map +1 -0
  332. package/workflow/CanvasActionsContext.js +4 -0
  333. package/workflow/CanvasActionsContext.js.map +1 -0
  334. package/workflow/CanvasContextMenu.d.ts +59 -0
  335. package/workflow/CanvasContextMenu.d.ts.map +1 -0
  336. package/workflow/CanvasContextMenu.js +98 -0
  337. package/workflow/CanvasContextMenu.js.map +1 -0
  338. package/workflow/CanvasTaskNode.d.ts +21 -0
  339. package/workflow/CanvasTaskNode.d.ts.map +1 -0
  340. package/workflow/CanvasTaskNode.js +125 -0
  341. package/workflow/CanvasTaskNode.js.map +1 -0
  342. package/workflow/CanvasTransitionEdge.d.ts +24 -0
  343. package/workflow/CanvasTransitionEdge.d.ts.map +1 -0
  344. package/workflow/CanvasTransitionEdge.js +50 -0
  345. package/workflow/CanvasTransitionEdge.js.map +1 -0
  346. package/workflow/CostByWorkflowChart.d.ts +15 -0
  347. package/workflow/CostByWorkflowChart.d.ts.map +1 -0
  348. package/workflow/CostByWorkflowChart.js +45 -0
  349. package/workflow/CostByWorkflowChart.js.map +1 -0
  350. package/workflow/ExecutionSummaryWidget.d.ts +16 -0
  351. package/workflow/ExecutionSummaryWidget.d.ts.map +1 -0
  352. package/workflow/ExecutionSummaryWidget.js +93 -0
  353. package/workflow/ExecutionSummaryWidget.js.map +1 -0
  354. package/workflow/ExecutionTrendChart.d.ts +14 -0
  355. package/workflow/ExecutionTrendChart.d.ts.map +1 -0
  356. package/workflow/ExecutionTrendChart.js +67 -0
  357. package/workflow/ExecutionTrendChart.js.map +1 -0
  358. package/workflow/FailedRunsWidget.d.ts +19 -0
  359. package/workflow/FailedRunsWidget.d.ts.map +1 -0
  360. package/workflow/FailedRunsWidget.js +37 -0
  361. package/workflow/FailedRunsWidget.js.map +1 -0
  362. package/workflow/PendingApprovalsWidget.d.ts +19 -0
  363. package/workflow/PendingApprovalsWidget.d.ts.map +1 -0
  364. package/workflow/PendingApprovalsWidget.js +35 -0
  365. package/workflow/PendingApprovalsWidget.js.map +1 -0
  366. package/workflow/TaskConfigForm.d.ts +29 -0
  367. package/workflow/TaskConfigForm.d.ts.map +1 -0
  368. package/workflow/TaskConfigForm.js +230 -0
  369. package/workflow/TaskConfigForm.js.map +1 -0
  370. package/workflow/TaskKindRegistryContext.d.ts +24 -0
  371. package/workflow/TaskKindRegistryContext.d.ts.map +1 -0
  372. package/workflow/TaskKindRegistryContext.js +25 -0
  373. package/workflow/TaskKindRegistryContext.js.map +1 -0
  374. package/workflow/TaskPickerPopover.d.ts +33 -0
  375. package/workflow/TaskPickerPopover.d.ts.map +1 -0
  376. package/workflow/TaskPickerPopover.js +110 -0
  377. package/workflow/TaskPickerPopover.js.map +1 -0
  378. package/workflow/WorkflowArchitectDialog.d.ts +48 -0
  379. package/workflow/WorkflowArchitectDialog.d.ts.map +1 -0
  380. package/workflow/WorkflowArchitectDialog.js +129 -0
  381. package/workflow/WorkflowArchitectDialog.js.map +1 -0
  382. package/workflow/WorkflowCanvasEditor.d.ts +38 -0
  383. package/workflow/WorkflowCanvasEditor.d.ts.map +1 -0
  384. package/workflow/WorkflowCanvasEditor.js +287 -0
  385. package/workflow/WorkflowCanvasEditor.js.map +1 -0
  386. package/workflow/WorkflowCanvasInner.d.ts +32 -0
  387. package/workflow/WorkflowCanvasInner.d.ts.map +1 -0
  388. package/workflow/WorkflowCanvasInner.js +49 -0
  389. package/workflow/WorkflowCanvasInner.js.map +1 -0
  390. package/workflow/WorkflowDashboard.d.ts +35 -0
  391. package/workflow/WorkflowDashboard.d.ts.map +1 -0
  392. package/workflow/WorkflowDashboard.js +59 -0
  393. package/workflow/WorkflowDashboard.js.map +1 -0
  394. package/workflow/WorkflowDetailView.d.ts +63 -0
  395. package/workflow/WorkflowDetailView.d.ts.map +1 -0
  396. package/workflow/WorkflowDetailView.js +202 -0
  397. package/workflow/WorkflowDetailView.js.map +1 -0
  398. package/workflow/WorkflowEditorView.d.ts +43 -0
  399. package/workflow/WorkflowEditorView.d.ts.map +1 -0
  400. package/workflow/WorkflowEditorView.js +165 -0
  401. package/workflow/WorkflowEditorView.js.map +1 -0
  402. package/workflow/WorkflowExecutionApprovalCard.d.ts +27 -0
  403. package/workflow/WorkflowExecutionApprovalCard.d.ts.map +1 -0
  404. package/workflow/WorkflowExecutionApprovalCard.js +32 -0
  405. package/workflow/WorkflowExecutionApprovalCard.js.map +1 -0
  406. package/workflow/WorkflowExecutionArtifactPanel.d.ts +15 -0
  407. package/workflow/WorkflowExecutionArtifactPanel.d.ts.map +1 -0
  408. package/workflow/WorkflowExecutionArtifactPanel.js +53 -0
  409. package/workflow/WorkflowExecutionArtifactPanel.js.map +1 -0
  410. package/workflow/WorkflowExecutionCostPanel.d.ts +18 -0
  411. package/workflow/WorkflowExecutionCostPanel.d.ts.map +1 -0
  412. package/workflow/WorkflowExecutionCostPanel.js +44 -0
  413. package/workflow/WorkflowExecutionCostPanel.js.map +1 -0
  414. package/workflow/WorkflowExecutionHeader.d.ts +26 -0
  415. package/workflow/WorkflowExecutionHeader.d.ts.map +1 -0
  416. package/workflow/WorkflowExecutionHeader.js +68 -0
  417. package/workflow/WorkflowExecutionHeader.js.map +1 -0
  418. package/workflow/WorkflowExecutionPhaseBadge.d.ts +23 -0
  419. package/workflow/WorkflowExecutionPhaseBadge.d.ts.map +1 -0
  420. package/workflow/WorkflowExecutionPhaseBadge.js +99 -0
  421. package/workflow/WorkflowExecutionPhaseBadge.js.map +1 -0
  422. package/workflow/WorkflowExecutionTaskPanel.d.ts +24 -0
  423. package/workflow/WorkflowExecutionTaskPanel.d.ts.map +1 -0
  424. package/workflow/WorkflowExecutionTaskPanel.js +59 -0
  425. package/workflow/WorkflowExecutionTaskPanel.js.map +1 -0
  426. package/workflow/WorkflowExecutionTimeline.d.ts +27 -0
  427. package/workflow/WorkflowExecutionTimeline.d.ts.map +1 -0
  428. package/workflow/WorkflowExecutionTimeline.js +51 -0
  429. package/workflow/WorkflowExecutionTimeline.js.map +1 -0
  430. package/workflow/WorkflowExecutionTimelineEvent.d.ts +18 -0
  431. package/workflow/WorkflowExecutionTimelineEvent.d.ts.map +1 -0
  432. package/workflow/WorkflowExecutionTimelineEvent.js +210 -0
  433. package/workflow/WorkflowExecutionTimelineEvent.js.map +1 -0
  434. package/workflow/WorkflowExecutionViewer.d.ts +45 -0
  435. package/workflow/WorkflowExecutionViewer.d.ts.map +1 -0
  436. package/workflow/WorkflowExecutionViewer.js +75 -0
  437. package/workflow/WorkflowExecutionViewer.js.map +1 -0
  438. package/workflow/WorkflowInspectorPanel.d.ts +46 -0
  439. package/workflow/WorkflowInspectorPanel.d.ts.map +1 -0
  440. package/workflow/WorkflowInspectorPanel.js +152 -0
  441. package/workflow/WorkflowInspectorPanel.js.map +1 -0
  442. package/workflow/WorkflowRefinePanel.d.ts +30 -0
  443. package/workflow/WorkflowRefinePanel.d.ts.map +1 -0
  444. package/workflow/WorkflowRefinePanel.js +107 -0
  445. package/workflow/WorkflowRefinePanel.js.map +1 -0
  446. package/workflow/WorkflowRepairCard.d.ts +35 -0
  447. package/workflow/WorkflowRepairCard.d.ts.map +1 -0
  448. package/workflow/WorkflowRepairCard.js +113 -0
  449. package/workflow/WorkflowRepairCard.js.map +1 -0
  450. package/workflow/WorkflowRunDialog.d.ts +51 -0
  451. package/workflow/WorkflowRunDialog.d.ts.map +1 -0
  452. package/workflow/WorkflowRunDialog.js +75 -0
  453. package/workflow/WorkflowRunDialog.js.map +1 -0
  454. package/workflow/WorkflowRunForm.d.ts +62 -0
  455. package/workflow/WorkflowRunForm.d.ts.map +1 -0
  456. package/workflow/WorkflowRunForm.js +64 -0
  457. package/workflow/WorkflowRunForm.js.map +1 -0
  458. package/workflow/WorkflowTaskList.d.ts +25 -0
  459. package/workflow/WorkflowTaskList.d.ts.map +1 -0
  460. package/workflow/WorkflowTaskList.js +89 -0
  461. package/workflow/WorkflowTaskList.js.map +1 -0
  462. package/workflow/WorkflowTaskPalette.d.ts +22 -0
  463. package/workflow/WorkflowTaskPalette.d.ts.map +1 -0
  464. package/workflow/WorkflowTaskPalette.js +83 -0
  465. package/workflow/WorkflowTaskPalette.js.map +1 -0
  466. package/workflow/WorkflowTopologyGraph.d.ts +22 -0
  467. package/workflow/WorkflowTopologyGraph.d.ts.map +1 -0
  468. package/workflow/WorkflowTopologyGraph.js +123 -0
  469. package/workflow/WorkflowTopologyGraph.js.map +1 -0
  470. package/workflow/WorkflowYamlEditor.d.ts +43 -0
  471. package/workflow/WorkflowYamlEditor.d.ts.map +1 -0
  472. package/workflow/WorkflowYamlEditor.js +215 -0
  473. package/workflow/WorkflowYamlEditor.js.map +1 -0
  474. package/workflow/__tests__/starter-workflow-yaml.test.d.ts +2 -0
  475. package/workflow/__tests__/starter-workflow-yaml.test.d.ts.map +1 -0
  476. package/workflow/__tests__/starter-workflow-yaml.test.js +44 -0
  477. package/workflow/__tests__/starter-workflow-yaml.test.js.map +1 -0
  478. package/workflow/canvas-constants.d.ts +56 -0
  479. package/workflow/canvas-constants.d.ts.map +1 -0
  480. package/workflow/canvas-constants.js +74 -0
  481. package/workflow/canvas-constants.js.map +1 -0
  482. package/workflow/canvas-icons.d.ts +13 -0
  483. package/workflow/canvas-icons.d.ts.map +1 -0
  484. package/workflow/canvas-icons.js +21 -0
  485. package/workflow/canvas-icons.js.map +1 -0
  486. package/workflow/extract-workflow-yaml.d.ts +22 -0
  487. package/workflow/extract-workflow-yaml.d.ts.map +1 -0
  488. package/workflow/extract-workflow-yaml.js +63 -0
  489. package/workflow/extract-workflow-yaml.js.map +1 -0
  490. package/workflow/graph-commands.d.ts +209 -0
  491. package/workflow/graph-commands.d.ts.map +1 -0
  492. package/workflow/graph-commands.js +516 -0
  493. package/workflow/graph-commands.js.map +1 -0
  494. package/workflow/index.d.ts +66 -0
  495. package/workflow/index.d.ts.map +1 -0
  496. package/workflow/index.js +88 -0
  497. package/workflow/index.js.map +1 -0
  498. package/workflow/serialize-workflow-yaml.d.ts +39 -0
  499. package/workflow/serialize-workflow-yaml.d.ts.map +1 -0
  500. package/workflow/serialize-workflow-yaml.js +413 -0
  501. package/workflow/serialize-workflow-yaml.js.map +1 -0
  502. package/workflow/starter-workflow-yaml.d.ts +12 -0
  503. package/workflow/starter-workflow-yaml.d.ts.map +1 -0
  504. package/workflow/starter-workflow-yaml.js +30 -0
  505. package/workflow/starter-workflow-yaml.js.map +1 -0
  506. package/workflow/types.d.ts +80 -0
  507. package/workflow/types.d.ts.map +1 -0
  508. package/workflow/types.js +2 -0
  509. package/workflow/types.js.map +1 -0
  510. package/workflow/useCanvasKeyboardShortcuts.d.ts +34 -0
  511. package/workflow/useCanvasKeyboardShortcuts.d.ts.map +1 -0
  512. package/workflow/useCanvasKeyboardShortcuts.js +108 -0
  513. package/workflow/useCanvasKeyboardShortcuts.js.map +1 -0
  514. package/workflow/useDiagnoseExecutionFlow.d.ts +87 -0
  515. package/workflow/useDiagnoseExecutionFlow.d.ts.map +1 -0
  516. package/workflow/useDiagnoseExecutionFlow.js +257 -0
  517. package/workflow/useDiagnoseExecutionFlow.js.map +1 -0
  518. package/workflow/useGraphHistory.d.ts +28 -0
  519. package/workflow/useGraphHistory.d.ts.map +1 -0
  520. package/workflow/useGraphHistory.js +106 -0
  521. package/workflow/useGraphHistory.js.map +1 -0
  522. package/workflow/usePendingApprovals.d.ts +35 -0
  523. package/workflow/usePendingApprovals.d.ts.map +1 -0
  524. package/workflow/usePendingApprovals.js +50 -0
  525. package/workflow/usePendingApprovals.js.map +1 -0
  526. package/workflow/useRefineWorkflowFlow.d.ts +75 -0
  527. package/workflow/useRefineWorkflowFlow.d.ts.map +1 -0
  528. package/workflow/useRefineWorkflowFlow.js +216 -0
  529. package/workflow/useRefineWorkflowFlow.js.map +1 -0
  530. package/workflow/useResolveAgentExecutionSession.d.ts +33 -0
  531. package/workflow/useResolveAgentExecutionSession.d.ts.map +1 -0
  532. package/workflow/useResolveAgentExecutionSession.js +37 -0
  533. package/workflow/useResolveAgentExecutionSession.js.map +1 -0
  534. package/workflow/useRunWorkflowFlow.d.ts +82 -0
  535. package/workflow/useRunWorkflowFlow.d.ts.map +1 -0
  536. package/workflow/useRunWorkflowFlow.js +145 -0
  537. package/workflow/useRunWorkflowFlow.js.map +1 -0
  538. package/workflow/useTaskKindRegistry.d.ts +96 -0
  539. package/workflow/useTaskKindRegistry.d.ts.map +1 -0
  540. package/workflow/useTaskKindRegistry.js +75 -0
  541. package/workflow/useTaskKindRegistry.js.map +1 -0
  542. package/workflow/useWorkflow.d.ts +47 -0
  543. package/workflow/useWorkflow.d.ts.map +1 -0
  544. package/workflow/useWorkflow.js +53 -0
  545. package/workflow/useWorkflow.js.map +1 -0
  546. package/workflow/useWorkflowArchitectFlow.d.ts +96 -0
  547. package/workflow/useWorkflowArchitectFlow.d.ts.map +1 -0
  548. package/workflow/useWorkflowArchitectFlow.js +179 -0
  549. package/workflow/useWorkflowArchitectFlow.js.map +1 -0
  550. package/workflow/useWorkflowCanvas.d.ts +66 -0
  551. package/workflow/useWorkflowCanvas.d.ts.map +1 -0
  552. package/workflow/useWorkflowCanvas.js +628 -0
  553. package/workflow/useWorkflowCanvas.js.map +1 -0
  554. package/workflow/useWorkflowCount.d.ts +47 -0
  555. package/workflow/useWorkflowCount.d.ts.map +1 -0
  556. package/workflow/useWorkflowCount.js +26 -0
  557. package/workflow/useWorkflowCount.js.map +1 -0
  558. package/workflow/useWorkflowDashboardSummary.d.ts +34 -0
  559. package/workflow/useWorkflowDashboardSummary.d.ts.map +1 -0
  560. package/workflow/useWorkflowDashboardSummary.js +33 -0
  561. package/workflow/useWorkflowDashboardSummary.js.map +1 -0
  562. package/workflow/useWorkflowEditor.d.ts +45 -0
  563. package/workflow/useWorkflowEditor.d.ts.map +1 -0
  564. package/workflow/useWorkflowEditor.js +52 -0
  565. package/workflow/useWorkflowEditor.js.map +1 -0
  566. package/workflow/useWorkflowExecution.d.ts +37 -0
  567. package/workflow/useWorkflowExecution.d.ts.map +1 -0
  568. package/workflow/useWorkflowExecution.js +43 -0
  569. package/workflow/useWorkflowExecution.js.map +1 -0
  570. package/workflow/useWorkflowExecutionActions.d.ts +41 -0
  571. package/workflow/useWorkflowExecutionActions.d.ts.map +1 -0
  572. package/workflow/useWorkflowExecutionActions.js +86 -0
  573. package/workflow/useWorkflowExecutionActions.js.map +1 -0
  574. package/workflow/useWorkflowExecutionArtifacts.d.ts +26 -0
  575. package/workflow/useWorkflowExecutionArtifacts.d.ts.map +1 -0
  576. package/workflow/useWorkflowExecutionArtifacts.js +29 -0
  577. package/workflow/useWorkflowExecutionArtifacts.js.map +1 -0
  578. package/workflow/useWorkflowExecutionEventLog.d.ts +47 -0
  579. package/workflow/useWorkflowExecutionEventLog.d.ts.map +1 -0
  580. package/workflow/useWorkflowExecutionEventLog.js +59 -0
  581. package/workflow/useWorkflowExecutionEventLog.js.map +1 -0
  582. package/workflow/useWorkflowExecutionEventStream.d.ts +61 -0
  583. package/workflow/useWorkflowExecutionEventStream.d.ts.map +1 -0
  584. package/workflow/useWorkflowExecutionEventStream.js +161 -0
  585. package/workflow/useWorkflowExecutionEventStream.js.map +1 -0
  586. package/workflow/useWorkflowExecutionList.d.ts +49 -0
  587. package/workflow/useWorkflowExecutionList.d.ts.map +1 -0
  588. package/workflow/useWorkflowExecutionList.js +65 -0
  589. package/workflow/useWorkflowExecutionList.js.map +1 -0
  590. package/workflow/useWorkflowInstances.d.ts +30 -0
  591. package/workflow/useWorkflowInstances.d.ts.map +1 -0
  592. package/workflow/useWorkflowInstances.js +33 -0
  593. package/workflow/useWorkflowInstances.js.map +1 -0
  594. package/workflow/useWorkflowList.d.ts +57 -0
  595. package/workflow/useWorkflowList.d.ts.map +1 -0
  596. package/workflow/useWorkflowList.js +29 -0
  597. package/workflow/useWorkflowList.js.map +1 -0
  598. package/workflow/useWorkflowSave.d.ts +25 -0
  599. package/workflow/useWorkflowSave.d.ts.map +1 -0
  600. package/workflow/useWorkflowSave.js +61 -0
  601. package/workflow/useWorkflowSave.js.map +1 -0
  602. package/workflow/useWorkflowTopology.d.ts +40 -0
  603. package/workflow/useWorkflowTopology.d.ts.map +1 -0
  604. package/workflow/useWorkflowTopology.js +163 -0
  605. package/workflow/useWorkflowTopology.js.map +1 -0
  606. package/workflow/useWorkflowValidation.d.ts +27 -0
  607. package/workflow/useWorkflowValidation.d.ts.map +1 -0
  608. package/workflow/useWorkflowValidation.js +253 -0
  609. package/workflow/useWorkflowValidation.js.map +1 -0
  610. package/workflow/useWorkflowYaml.d.ts +26 -0
  611. package/workflow/useWorkflowYaml.d.ts.map +1 -0
  612. package/workflow/useWorkflowYaml.js +26 -0
  613. package/workflow/useWorkflowYaml.js.map +1 -0
  614. package/workflow/workflow-graph-conversions.d.ts +70 -0
  615. package/workflow/workflow-graph-conversions.d.ts.map +1 -0
  616. package/workflow/workflow-graph-conversions.js +634 -0
  617. package/workflow/workflow-graph-conversions.js.map +1 -0
  618. package/workflow/workflow-graph-model.d.ts +83 -0
  619. package/workflow/workflow-graph-model.d.ts.map +1 -0
  620. package/workflow/workflow-graph-model.js +5 -0
  621. package/workflow/workflow-graph-model.js.map +1 -0
  622. package/workflow/workflow-yaml-diff.d.ts +24 -0
  623. package/workflow/workflow-yaml-diff.d.ts.map +1 -0
  624. package/workflow/workflow-yaml-diff.js +96 -0
  625. package/workflow/workflow-yaml-diff.js.map +1 -0
@@ -0,0 +1,82 @@
1
+ import type { Workflow } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/api_pb";
2
+ import type { WorkflowInstance } from "@stigmer/protos/ai/stigmer/agentic/workflowinstance/v1/api_pb";
3
+ import type { EnvVarDeclaration } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/spec_pb";
4
+ /** Field-level validation errors keyed by field name. */
5
+ export type RunWorkflowFieldErrors = Record<string, string>;
6
+ /** Options for {@link useRunWorkflowFlow}. */
7
+ export interface UseRunWorkflowFlowOptions {
8
+ /** Organization slug that owns the workflow. */
9
+ readonly org: string;
10
+ /** Workflow resource (must include metadata and spec). */
11
+ readonly workflow: Workflow;
12
+ /** Available workflow instances (for instance selector). */
13
+ readonly instances: readonly WorkflowInstance[];
14
+ /**
15
+ * Called after the execution is created successfully.
16
+ * Receives the execution ID for navigation.
17
+ */
18
+ readonly onSuccess: (executionId: string) => void;
19
+ /**
20
+ * Called when submission fails. Receives a human-readable message.
21
+ * Errors are also available via {@link UseRunWorkflowFlowReturn.error}.
22
+ */
23
+ readonly onError?: (message: string) => void;
24
+ }
25
+ /** Return value of {@link useRunWorkflowFlow}. */
26
+ export interface UseRunWorkflowFlowReturn {
27
+ /** Current trigger message value. */
28
+ readonly triggerMessage: string;
29
+ /** Update the trigger message. */
30
+ readonly setTriggerMessage: (value: string) => void;
31
+ /** Current runtime environment variable overrides (keyed by var name). */
32
+ readonly runtimeEnv: Record<string, string>;
33
+ /** Update a single env var value. */
34
+ readonly setEnvVar: (key: string, value: string) => void;
35
+ /** Selected instance ID, or `null` for server-resolved default. */
36
+ readonly selectedInstanceId: string | null;
37
+ /** Update the selected instance. */
38
+ readonly setSelectedInstanceId: (id: string | null) => void;
39
+ /** Declared environment variables from the workflow spec. */
40
+ readonly envDeclarations: Record<string, EnvVarDeclaration>;
41
+ /** Field-level validation errors (empty when valid). */
42
+ readonly fieldErrors: RunWorkflowFieldErrors;
43
+ /** `true` while the create execution RPC is in flight. */
44
+ readonly isSubmitting: boolean;
45
+ /** Error from the last failed submission, or `null`. */
46
+ readonly error: string | null;
47
+ /** Validate form fields. Returns `true` if valid. */
48
+ readonly validate: () => boolean;
49
+ /** Validate, then create the workflow execution. */
50
+ readonly submit: () => Promise<void>;
51
+ /** Reset all form state to initial values. */
52
+ readonly reset: () => void;
53
+ }
54
+ /**
55
+ * Behavior hook that orchestrates the "run a workflow" flow.
56
+ *
57
+ * Manages form state (trigger message, runtime env overrides, instance
58
+ * selection), validates required fields, and calls
59
+ * `WorkflowExecutionClient.create()` on submission. On success, the
60
+ * consumer-provided `onSuccess` callback receives the execution ID for
61
+ * navigation or further action.
62
+ *
63
+ * This hook is framework-agnostic — it works identically in Next.js,
64
+ * Vite, Tauri, or any React environment. Navigation and toast feedback
65
+ * are the consumer's responsibility.
66
+ *
67
+ * @example
68
+ * ```tsx
69
+ * const flow = useRunWorkflowFlow({
70
+ * org: "acme",
71
+ * workflow,
72
+ * instances,
73
+ * onSuccess: (id) => router.push(`/workflows/executions/${id}`),
74
+ * onError: (msg) => toast.error(msg),
75
+ * });
76
+ *
77
+ * <input value={flow.triggerMessage} onChange={e => flow.setTriggerMessage(e.target.value)} />
78
+ * <button onClick={flow.submit} disabled={flow.isSubmitting}>Run</button>
79
+ * ```
80
+ */
81
+ export declare function useRunWorkflowFlow(options: UseRunWorkflowFlowOptions): UseRunWorkflowFlowReturn;
82
+ //# sourceMappingURL=useRunWorkflowFlow.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useRunWorkflowFlow.d.ts","sourceRoot":"","sources":["../../src/workflow/useRunWorkflowFlow.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uDAAuD,CAAC;AACtF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+DAA+D,CAAC;AAEtG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2DAA2D,CAAC;AAKnG,yDAAyD;AACzD,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5D,8CAA8C;AAC9C,MAAM,WAAW,yBAAyB;IACxC,gDAAgD;IAChD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAChD;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC,qCAAqC;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,kCAAkC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpD,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,qCAAqC;IACrC,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEzD,mEAAmE;IACnE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,oCAAoC;IACpC,QAAQ,CAAC,qBAAqB,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAE5D,6DAA6D;IAC7D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAE5D,wDAAwD;IACxD,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;IAE7C,0DAA0D;IAC1D,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC;IACjC,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,wBAAwB,CAuI1B"}
@@ -0,0 +1,145 @@
1
+ "use client";
2
+ import { useCallback, useMemo, useRef, useState } from "react";
3
+ import { getUserMessage } from "@stigmer/sdk";
4
+ import { useStigmer } from "../hooks";
5
+ /**
6
+ * Behavior hook that orchestrates the "run a workflow" flow.
7
+ *
8
+ * Manages form state (trigger message, runtime env overrides, instance
9
+ * selection), validates required fields, and calls
10
+ * `WorkflowExecutionClient.create()` on submission. On success, the
11
+ * consumer-provided `onSuccess` callback receives the execution ID for
12
+ * navigation or further action.
13
+ *
14
+ * This hook is framework-agnostic — it works identically in Next.js,
15
+ * Vite, Tauri, or any React environment. Navigation and toast feedback
16
+ * are the consumer's responsibility.
17
+ *
18
+ * @example
19
+ * ```tsx
20
+ * const flow = useRunWorkflowFlow({
21
+ * org: "acme",
22
+ * workflow,
23
+ * instances,
24
+ * onSuccess: (id) => router.push(`/workflows/executions/${id}`),
25
+ * onError: (msg) => toast.error(msg),
26
+ * });
27
+ *
28
+ * <input value={flow.triggerMessage} onChange={e => flow.setTriggerMessage(e.target.value)} />
29
+ * <button onClick={flow.submit} disabled={flow.isSubmitting}>Run</button>
30
+ * ```
31
+ */
32
+ export function useRunWorkflowFlow(options) {
33
+ const { org, workflow, instances, onSuccess, onError } = options;
34
+ const stigmer = useStigmer();
35
+ const [triggerMessage, setTriggerMessage] = useState("");
36
+ const [runtimeEnv, setRuntimeEnv] = useState({});
37
+ const [selectedInstanceId, setSelectedInstanceId] = useState(null);
38
+ const [isSubmitting, setIsSubmitting] = useState(false);
39
+ const [error, setError] = useState(null);
40
+ const [fieldErrors, setFieldErrors] = useState({});
41
+ const stigmerRef = useRef(stigmer);
42
+ stigmerRef.current = stigmer;
43
+ const onSuccessRef = useRef(onSuccess);
44
+ onSuccessRef.current = onSuccess;
45
+ const onErrorRef = useRef(onError);
46
+ onErrorRef.current = onError;
47
+ const envDeclarations = useMemo(() => (workflow.spec?.env ? { ...workflow.spec.env } : {}), [workflow.spec?.env]);
48
+ const setEnvVar = useCallback((key, value) => {
49
+ setRuntimeEnv((prev) => ({ ...prev, [key]: value }));
50
+ setFieldErrors((prev) => {
51
+ if (!prev[key])
52
+ return prev;
53
+ const next = { ...prev };
54
+ delete next[key];
55
+ return next;
56
+ });
57
+ }, []);
58
+ const validate = useCallback(() => {
59
+ const errors = {};
60
+ for (const [key, decl] of Object.entries(envDeclarations)) {
61
+ if (!decl.optional && !runtimeEnv[key]?.trim()) {
62
+ errors[key] = `${key} is required`;
63
+ }
64
+ }
65
+ setFieldErrors(errors);
66
+ return Object.keys(errors).length === 0;
67
+ }, [envDeclarations, runtimeEnv]);
68
+ const submit = useCallback(async () => {
69
+ if (isSubmitting)
70
+ return;
71
+ if (!validate())
72
+ return;
73
+ setIsSubmitting(true);
74
+ setError(null);
75
+ try {
76
+ const workflowName = workflow.metadata?.name || workflow.metadata?.slug || "Workflow";
77
+ const envInput = {};
78
+ for (const [key, value] of Object.entries(runtimeEnv)) {
79
+ if (value.trim()) {
80
+ const isSecret = envDeclarations[key]?.isSecret ?? false;
81
+ envInput[key] = { value, isSecret };
82
+ }
83
+ }
84
+ const execution = await stigmerRef.current.workflowExecution.create({
85
+ name: `${workflowName} execution`,
86
+ org,
87
+ workflowId: selectedInstanceId
88
+ ? undefined
89
+ : workflow.metadata?.id,
90
+ workflowInstanceId: selectedInstanceId ?? undefined,
91
+ triggerMessage: triggerMessage || undefined,
92
+ triggerMetadata: {
93
+ source: "ui",
94
+ timestamp: new Date().toISOString(),
95
+ },
96
+ runtimeEnv: Object.keys(envInput).length > 0 ? envInput : undefined,
97
+ });
98
+ const executionId = execution.metadata?.id;
99
+ if (!executionId) {
100
+ throw new Error("Execution was created but no ID was returned. Please check the executions list.");
101
+ }
102
+ onSuccessRef.current(executionId);
103
+ }
104
+ catch (err) {
105
+ const message = getUserMessage(err, "Failed to start workflow execution");
106
+ setError(message);
107
+ onErrorRef.current?.(message);
108
+ }
109
+ finally {
110
+ setIsSubmitting(false);
111
+ }
112
+ }, [
113
+ isSubmitting,
114
+ validate,
115
+ workflow.metadata,
116
+ org,
117
+ selectedInstanceId,
118
+ triggerMessage,
119
+ runtimeEnv,
120
+ envDeclarations,
121
+ ]);
122
+ const reset = useCallback(() => {
123
+ setTriggerMessage("");
124
+ setRuntimeEnv({});
125
+ setSelectedInstanceId(null);
126
+ setError(null);
127
+ setFieldErrors({});
128
+ }, []);
129
+ return {
130
+ triggerMessage,
131
+ setTriggerMessage,
132
+ runtimeEnv,
133
+ setEnvVar,
134
+ selectedInstanceId,
135
+ setSelectedInstanceId,
136
+ envDeclarations,
137
+ fieldErrors,
138
+ isSubmitting,
139
+ error,
140
+ validate,
141
+ submit,
142
+ reset,
143
+ };
144
+ }
145
+ //# sourceMappingURL=useRunWorkflowFlow.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useRunWorkflowFlow.js","sourceRoot":"","sources":["../../src/workflow/useRunWorkflowFlow.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,96 @@
1
+ import type { TaskKindDescriptor, TaskKindCategory } from "./types";
2
+ /** Return value of {@link useTaskKindRegistry}. */
3
+ export interface UseTaskKindRegistryReturn {
4
+ /** All registered task kind descriptors, one per WorkflowTaskKind. */
5
+ readonly descriptors: readonly TaskKindDescriptor[];
6
+ /**
7
+ * Look up a single descriptor by its kind identifier.
8
+ *
9
+ * @example
10
+ * ```ts
11
+ * const llm = getByKind("llm_call");
12
+ * // llm?.displayName === "LLM Call"
13
+ * ```
14
+ */
15
+ readonly getByKind: (kind: string) => TaskKindDescriptor | undefined;
16
+ /**
17
+ * Retrieve the JSON Schema for a task kind's configuration.
18
+ *
19
+ * Returns the parsed JSON Schema object suitable for Monaco editor
20
+ * validation or React JSON Schema Form (RJSF) rendering.
21
+ *
22
+ * @example
23
+ * ```ts
24
+ * const schema = getJsonSchema("llm_call");
25
+ * // Pass to Monaco: monaco.languages.json.jsonDefaults.setDiagnosticsOptions(...)
26
+ * ```
27
+ */
28
+ readonly getJsonSchema: (kind: string) => Record<string, unknown> | undefined;
29
+ /**
30
+ * Descriptors grouped by their functional category.
31
+ *
32
+ * Useful for rendering a categorized task palette where tasks are
33
+ * organized into sections like "AI", "Control Flow", "Data", etc.
34
+ *
35
+ * @example
36
+ * ```tsx
37
+ * for (const [category, tasks] of categories) {
38
+ * // Render category header + task cards
39
+ * }
40
+ * ```
41
+ */
42
+ readonly categories: ReadonlyMap<TaskKindCategory, readonly TaskKindDescriptor[]>;
43
+ /** `true` while the task kind registry is being fetched from the API. */
44
+ readonly isLoading: boolean;
45
+ /** Non-null if the API fetch failed. Descriptors will be empty in this case. */
46
+ readonly error: Error | null;
47
+ /** Retry fetching the registry. No-op while a fetch is in flight. */
48
+ readonly refetch: () => void;
49
+ }
50
+ /**
51
+ * Data hook that exposes the task kind registry with lookup and grouping helpers.
52
+ *
53
+ * Pure data layer — no rendering, no side effects. Platform builders
54
+ * who want full control over rendering import this hook and build
55
+ * their own UI (task palettes, form generators, validation).
56
+ *
57
+ * The registry data is fetched from the task kind registry API by
58
+ * {@link StigmerProvider} and cached in context. During loading,
59
+ * `isLoading` is `true` and `descriptors` is empty.
60
+ *
61
+ * @example
62
+ * ```tsx
63
+ * function TaskPalette() {
64
+ * const { categories, isLoading, error } = useTaskKindRegistry();
65
+ *
66
+ * if (isLoading) return <Skeleton />;
67
+ * if (error) return <ErrorMessage error={error} />;
68
+ *
69
+ * return (
70
+ * <div>
71
+ * {Array.from(categories).map(([category, tasks]) => (
72
+ * <CategorySection key={category} label={category}>
73
+ * {tasks.map(task => (
74
+ * <TaskCard key={task.kind} descriptor={task} />
75
+ * ))}
76
+ * </CategorySection>
77
+ * ))}
78
+ * </div>
79
+ * );
80
+ * }
81
+ * ```
82
+ *
83
+ * @example
84
+ * ```tsx
85
+ * // YAML editor integration
86
+ * function WorkflowEditor({ taskKind }: { taskKind: string }) {
87
+ * const { getJsonSchema } = useTaskKindRegistry();
88
+ * const schema = getJsonSchema(taskKind);
89
+ * // Pass schema to Monaco for autocomplete + validation
90
+ * }
91
+ * ```
92
+ *
93
+ * @since T04 (Task Schema Registry)
94
+ */
95
+ export declare function useTaskKindRegistry(): UseTaskKindRegistryReturn;
96
+ //# sourceMappingURL=useTaskKindRegistry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useTaskKindRegistry.d.ts","sourceRoot":"","sources":["../../src/workflow/useTaskKindRegistry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGpE,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAEpD;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,kBAAkB,GAAG,SAAS,CAAC;IAErE;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAE9E;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,gBAAgB,EAAE,SAAS,kBAAkB,EAAE,CAAC,CAAC;IAElF,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAE7B,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,mBAAmB,IAAI,yBAAyB,CA4B/D"}
@@ -0,0 +1,75 @@
1
+ "use client";
2
+ import { useMemo } from "react";
3
+ import { useTaskKindRegistryContext } from "./TaskKindRegistryContext";
4
+ /**
5
+ * Data hook that exposes the task kind registry with lookup and grouping helpers.
6
+ *
7
+ * Pure data layer — no rendering, no side effects. Platform builders
8
+ * who want full control over rendering import this hook and build
9
+ * their own UI (task palettes, form generators, validation).
10
+ *
11
+ * The registry data is fetched from the task kind registry API by
12
+ * {@link StigmerProvider} and cached in context. During loading,
13
+ * `isLoading` is `true` and `descriptors` is empty.
14
+ *
15
+ * @example
16
+ * ```tsx
17
+ * function TaskPalette() {
18
+ * const { categories, isLoading, error } = useTaskKindRegistry();
19
+ *
20
+ * if (isLoading) return <Skeleton />;
21
+ * if (error) return <ErrorMessage error={error} />;
22
+ *
23
+ * return (
24
+ * <div>
25
+ * {Array.from(categories).map(([category, tasks]) => (
26
+ * <CategorySection key={category} label={category}>
27
+ * {tasks.map(task => (
28
+ * <TaskCard key={task.kind} descriptor={task} />
29
+ * ))}
30
+ * </CategorySection>
31
+ * ))}
32
+ * </div>
33
+ * );
34
+ * }
35
+ * ```
36
+ *
37
+ * @example
38
+ * ```tsx
39
+ * // YAML editor integration
40
+ * function WorkflowEditor({ taskKind }: { taskKind: string }) {
41
+ * const { getJsonSchema } = useTaskKindRegistry();
42
+ * const schema = getJsonSchema(taskKind);
43
+ * // Pass schema to Monaco for autocomplete + validation
44
+ * }
45
+ * ```
46
+ *
47
+ * @since T04 (Task Schema Registry)
48
+ */
49
+ export function useTaskKindRegistry() {
50
+ const { descriptors, isLoading, error, refetch } = useTaskKindRegistryContext();
51
+ return useMemo(() => {
52
+ const byKind = new Map();
53
+ const byCategory = new Map();
54
+ for (const descriptor of descriptors) {
55
+ byKind.set(descriptor.kind, descriptor);
56
+ const group = byCategory.get(descriptor.category);
57
+ if (group) {
58
+ group.push(descriptor);
59
+ }
60
+ else {
61
+ byCategory.set(descriptor.category, [descriptor]);
62
+ }
63
+ }
64
+ return {
65
+ descriptors,
66
+ getByKind: (kind) => byKind.get(kind),
67
+ getJsonSchema: (kind) => byKind.get(kind)?.configJsonSchema,
68
+ categories: byCategory,
69
+ isLoading,
70
+ error,
71
+ refetch,
72
+ };
73
+ }, [descriptors, isLoading, error, refetch]);
74
+ }
75
+ //# sourceMappingURL=useTaskKindRegistry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useTaskKindRegistry.js","sourceRoot":"","sources":["../../src/workflow/useTaskKindRegistry.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAyDvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,0BAA0B,EAAE,CAAC;IAEhF,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,MAAM,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAC;QACrD,MAAM,UAAU,GAAG,IAAI,GAAG,EAA0C,CAAC;QAErE,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAExC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAClD,IAAI,KAAK,EAAE,CAAC;gBACV,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QAED,OAAO;YACL,WAAW;YACX,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;YAC7C,aAAa,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,gBAAgB;YACnE,UAAU,EAAE,UAA0E;YACtF,SAAS;YACT,KAAK;YACL,OAAO;SACR,CAAC;IACJ,CAAC,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;AAC/C,CAAC"}
@@ -0,0 +1,47 @@
1
+ import type { Workflow } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/api_pb";
2
+ /** Return value of {@link useWorkflow}. */
3
+ export interface UseWorkflowReturn {
4
+ /** The resolved Workflow, or `null` while loading, on error, or when not found. */
5
+ readonly workflow: Workflow | null;
6
+ /** `true` while the initial fetch or a refetch is in flight. */
7
+ readonly isLoading: boolean;
8
+ /** `true` while a background refetch is in flight and stale data is shown. */
9
+ readonly isRefetching: boolean;
10
+ /** Error from the last failed request, or `null` when healthy. */
11
+ readonly error: Error | null;
12
+ /** Discard cached data and re-fetch the workflow from the server. */
13
+ readonly refetch: () => void;
14
+ }
15
+ /**
16
+ * Data hook that fetches a single Workflow blueprint by organization and slug.
17
+ *
18
+ * Wraps `stigmer.workflow.getByReference()` with loading, error, and
19
+ * not-found state management. When the `org` or `slug` parameters
20
+ * change, the previous in-flight request is discarded and a fresh
21
+ * fetch begins.
22
+ *
23
+ * Pass `null` for either `org` or `slug` to skip fetching (stable
24
+ * no-op). This is useful when the slug is not yet available — for
25
+ * example, while a parent component is still resolving route params.
26
+ *
27
+ * **Not-found handling:** If the API returns a 404 (NOT_FOUND), the
28
+ * hook sets `workflow` to `null` without raising an error. Consumers
29
+ * distinguish "not found" from "loading" by checking all three fields:
30
+ * `workflow === null && !isLoading && !error` means the resource does
31
+ * not exist.
32
+ *
33
+ * @example
34
+ * ```tsx
35
+ * function WorkflowDetail({ org, slug }: { org: string; slug: string }) {
36
+ * const { workflow, isLoading, error } = useWorkflow(org, slug);
37
+ *
38
+ * if (isLoading) return <Skeleton />;
39
+ * if (error) return <ErrorMessage error={error} />;
40
+ * if (!workflow) return <NotFound />;
41
+ *
42
+ * return <h1>{workflow.metadata?.name}</h1>;
43
+ * }
44
+ * ```
45
+ */
46
+ export declare function useWorkflow(org: string | null, slug: string | null): UseWorkflowReturn;
47
+ //# sourceMappingURL=useWorkflow.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useWorkflow.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflow.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uDAAuD,CAAC;AAKtF,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACnC,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,iBAAiB,CAsBnB"}
@@ -0,0 +1,53 @@
1
+ "use client";
2
+ import { isNotFound } from "@stigmer/sdk";
3
+ import { useStigmer } from "../hooks";
4
+ import { useFetch } from "../internal/useFetch";
5
+ /**
6
+ * Data hook that fetches a single Workflow blueprint by organization and slug.
7
+ *
8
+ * Wraps `stigmer.workflow.getByReference()` with loading, error, and
9
+ * not-found state management. When the `org` or `slug` parameters
10
+ * change, the previous in-flight request is discarded and a fresh
11
+ * fetch begins.
12
+ *
13
+ * Pass `null` for either `org` or `slug` to skip fetching (stable
14
+ * no-op). This is useful when the slug is not yet available — for
15
+ * example, while a parent component is still resolving route params.
16
+ *
17
+ * **Not-found handling:** If the API returns a 404 (NOT_FOUND), the
18
+ * hook sets `workflow` to `null` without raising an error. Consumers
19
+ * distinguish "not found" from "loading" by checking all three fields:
20
+ * `workflow === null && !isLoading && !error` means the resource does
21
+ * not exist.
22
+ *
23
+ * @example
24
+ * ```tsx
25
+ * function WorkflowDetail({ org, slug }: { org: string; slug: string }) {
26
+ * const { workflow, isLoading, error } = useWorkflow(org, slug);
27
+ *
28
+ * if (isLoading) return <Skeleton />;
29
+ * if (error) return <ErrorMessage error={error} />;
30
+ * if (!workflow) return <NotFound />;
31
+ *
32
+ * return <h1>{workflow.metadata?.name}</h1>;
33
+ * }
34
+ * ```
35
+ */
36
+ export function useWorkflow(org, slug) {
37
+ const stigmer = useStigmer();
38
+ const fetchFn = org && slug
39
+ ? async () => {
40
+ try {
41
+ return await stigmer.workflow.getByReference({ org, slug });
42
+ }
43
+ catch (err) {
44
+ if (isNotFound(err))
45
+ return null;
46
+ throw err;
47
+ }
48
+ }
49
+ : null;
50
+ const { data: workflow, isLoading, isRefetching, error, refetch } = useFetch(fetchFn, [org, slug, stigmer], null);
51
+ return { workflow, isLoading, isRefetching, error, refetch };
52
+ }
53
+ //# sourceMappingURL=useWorkflow.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useWorkflow.js","sourceRoot":"","sources":["../../src/workflow/useWorkflow.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAgBhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,WAAW,CACzB,GAAkB,EAClB,IAAmB;IAEnB,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,OAAO,GACX,GAAG,IAAI,IAAI;QACT,CAAC,CAAC,KAAK,IAAI,EAAE;YACT,IAAI,CAAC;gBACH,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,UAAU,CAAC,GAAG,CAAC;oBAAE,OAAO,IAAI,CAAC;gBACjC,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QACH,CAAC,CAAC,IAAI,CAAC;IAEX,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CAC1E,OAAO,EACP,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,EACpB,IAAI,CACL,CAAC;IAEF,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC/D,CAAC"}
@@ -0,0 +1,96 @@
1
+ import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
2
+ /**
3
+ * Lifecycle phases for the Workflow Architect generate flow.
4
+ *
5
+ * - `idle` — waiting for user to submit a prompt
6
+ * - `starting` — creating session + execution
7
+ * - `streaming` — agent is working (tool calls, validation, generation)
8
+ * - `complete` — agent finished and YAML was extracted successfully
9
+ * - `extraction-failed` — agent finished but no YAML block was found
10
+ * - `applying` — creating the workflow from extracted YAML
11
+ * - `error` — a failure occurred (RPC, stream, or apply)
12
+ */
13
+ export type ArchitectPhase = "idle" | "starting" | "streaming" | "complete" | "extraction-failed" | "applying" | "error";
14
+ /** Options for {@link useWorkflowArchitectFlow}. */
15
+ export interface UseWorkflowArchitectFlowOptions {
16
+ /** Organization slug — used for session, execution, and workflow creation. */
17
+ readonly org: string;
18
+ /**
19
+ * Called after the workflow is created successfully.
20
+ * Receives the org slug and workflow slug for navigation.
21
+ */
22
+ readonly onSuccess: (org: string, slug: string) => void;
23
+ /**
24
+ * Called when any step fails. Receives a human-readable message.
25
+ * Errors are also available via {@link UseWorkflowArchitectFlowReturn.error}.
26
+ */
27
+ readonly onError?: (message: string) => void;
28
+ }
29
+ /** Return value of {@link useWorkflowArchitectFlow}. */
30
+ export interface UseWorkflowArchitectFlowReturn {
31
+ /** Current prompt value. */
32
+ readonly prompt: string;
33
+ /** Update the prompt. */
34
+ readonly setPrompt: (value: string) => void;
35
+ /** Current lifecycle phase. */
36
+ readonly phase: ArchitectPhase;
37
+ /**
38
+ * Latest execution snapshot from the agent stream.
39
+ *
40
+ * Non-null during `streaming`, `complete`, and `extraction-failed`
41
+ * phases. Pass to `MessageThread` for rendering agent messages.
42
+ */
43
+ readonly execution: AgentExecution | null;
44
+ /** `true` while the agent execution is actively streaming. */
45
+ readonly isStreaming: boolean;
46
+ /** Extracted YAML when phase is `complete`, otherwise `null`. */
47
+ readonly extractedYaml: string | null;
48
+ /** Agent's explanation prose when phase is `complete`, otherwise `null`. */
49
+ readonly explanation: string | null;
50
+ /** Human-readable error message, or `null` when healthy. */
51
+ readonly error: string | null;
52
+ /**
53
+ * Validate the prompt and launch the Workflow Architect agent.
54
+ *
55
+ * Creates a session with the `workflow-architect` system agent,
56
+ * starts an execution with the user's prompt, and begins streaming.
57
+ * The stream phase transitions automatically when the agent finishes.
58
+ */
59
+ readonly generate: () => Promise<void>;
60
+ /**
61
+ * Create a workflow from the extracted YAML via `workflow.apply()`.
62
+ *
63
+ * Only callable when phase is `complete`. Calls `onSuccess` with
64
+ * the org and slug on completion.
65
+ */
66
+ readonly createWorkflow: () => Promise<void>;
67
+ /** Reset all state to initial values. Does not delete the session. */
68
+ readonly reset: () => void;
69
+ }
70
+ /**
71
+ * Behavior hook that orchestrates the agent-powered "generate a workflow"
72
+ * flow using the built-in Workflow Architect system agent.
73
+ *
74
+ * Composes existing infrastructure:
75
+ * - {@link useCreateSession} to create a session with the agent
76
+ * - {@link useCreateAgentExecution} to start the generation execution
77
+ * - {@link useExecutionStream} + `ConversationStore` for real-time streaming
78
+ * - {@link extractWorkflowYaml} to parse YAML from agent messages
79
+ * - `workflow.apply()` to persist the generated workflow
80
+ *
81
+ * The hook is framework-agnostic (DD-004) and returns referentially
82
+ * stable values (DD-010).
83
+ *
84
+ * @example
85
+ * ```tsx
86
+ * const flow = useWorkflowArchitectFlow({
87
+ * org: "acme",
88
+ * onSuccess: (org, slug) => router.push(`/library/workflows/${org}/${slug}`),
89
+ * onError: (msg) => toast.error(msg),
90
+ * });
91
+ *
92
+ * <WorkflowArchitectDialog {...flow} />
93
+ * ```
94
+ */
95
+ export declare function useWorkflowArchitectFlow(options: UseWorkflowArchitectFlowOptions): UseWorkflowArchitectFlowReturn;
96
+ //# sourceMappingURL=useWorkflowArchitectFlow.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useWorkflowArchitectFlow.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowArchitectFlow.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAelG;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,UAAU,GACV,WAAW,GACX,UAAU,GACV,mBAAmB,GACnB,UAAU,GACV,OAAO,CAAC;AAEZ,oDAAoD;AACpD,MAAM,WAAW,+BAA+B;IAC9C,8EAA8E;IAC9E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxD;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED,wDAAwD;AACxD,MAAM,WAAW,8BAA8B;IAC7C,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yBAAyB;IACzB,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAE5C,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAE/B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;IAC1C,8DAA8D;IAC9D,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAE9B,iEAAiE;IACjE,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAKD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,+BAA+B,GACvC,8BAA8B,CAyKhC"}