@datalayer/agent-runtimes 1.0.9 → 1.0.17

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 (462) hide show
  1. package/README.md +82 -1
  2. package/lib/{AgentLexical.d.ts → AgentDocument.d.ts} +5 -5
  3. package/lib/{AgentLexical.js → AgentDocument.js} +156 -26
  4. package/lib/AgentNode.js +32 -31
  5. package/lib/AgentNotebook.js +172 -17
  6. package/lib/AppExamples2.css +47 -0
  7. package/lib/AppExamples2.d.ts +3 -0
  8. package/lib/AppExamples2.js +21 -0
  9. package/lib/{agent-lexical-main.js → agent-document-main.js} +2 -2
  10. package/lib/agents/AgentRuntimeChat.d.ts +73 -0
  11. package/lib/agents/AgentRuntimeChat.js +198 -0
  12. package/lib/api/index.d.ts +12 -0
  13. package/lib/api/index.js +46 -0
  14. package/lib/api/runtimes/checkpoints.d.ts +122 -0
  15. package/lib/api/runtimes/checkpoints.js +118 -0
  16. package/lib/api/runtimes/environments.d.ts +9 -0
  17. package/lib/api/runtimes/environments.js +29 -0
  18. package/lib/api/runtimes/healthz.d.ts +15 -0
  19. package/lib/api/runtimes/healthz.js +44 -0
  20. package/lib/api/runtimes/index.d.ts +12 -0
  21. package/lib/api/runtimes/index.js +16 -0
  22. package/lib/api/runtimes/runtimes.d.ts +138 -0
  23. package/lib/api/runtimes/runtimes.js +230 -0
  24. package/lib/api/runtimes/snapshots.d.ts +38 -0
  25. package/lib/api/runtimes/snapshots.js +82 -0
  26. package/lib/api/scheduler/index.d.ts +6 -0
  27. package/lib/api/scheduler/index.js +10 -0
  28. package/lib/api/scheduler/schedules.d.ts +85 -0
  29. package/lib/api/scheduler/schedules.js +78 -0
  30. package/lib/api/spacer/documents.d.ts +12 -0
  31. package/lib/api/spacer/documents.js +43 -0
  32. package/lib/api/spacer/healthz.d.ts +15 -0
  33. package/lib/api/spacer/healthz.js +44 -0
  34. package/lib/api/spacer/index.d.ts +15 -0
  35. package/lib/api/spacer/index.js +19 -0
  36. package/lib/api/spacer/items.d.ts +25 -0
  37. package/lib/api/spacer/items.js +55 -0
  38. package/lib/api/spacer/lexicals.d.ts +34 -0
  39. package/lib/api/spacer/lexicals.js +89 -0
  40. package/lib/api/spacer/notebooks.d.ts +34 -0
  41. package/lib/api/spacer/notebooks.js +89 -0
  42. package/lib/api/spacer/spaces.d.ts +84 -0
  43. package/lib/api/spacer/spaces.js +170 -0
  44. package/lib/api/spacer/users.d.ts +9 -0
  45. package/lib/api/spacer/users.js +29 -0
  46. package/lib/chat/Chat.d.ts +1 -1
  47. package/lib/chat/Chat.js +54 -54
  48. package/lib/chat/ChatFloating.d.ts +2 -2
  49. package/lib/chat/ChatFloating.js +136 -25
  50. package/lib/chat/ChatSidebar.js +20 -22
  51. package/lib/chat/base/ChatBase.js +468 -40
  52. package/lib/chat/display/EmptyState.js +21 -21
  53. package/lib/chat/document/EphemeralDocument.d.ts +23 -0
  54. package/lib/chat/document/EphemeralDocument.js +270 -0
  55. package/lib/chat/header/ChatHeaderBase.d.ts +12 -2
  56. package/lib/chat/header/ChatHeaderBase.js +78 -23
  57. package/lib/chat/index.d.ts +1 -0
  58. package/lib/chat/index.js +2 -0
  59. package/lib/chat/notebook/EphemeralNotebook.d.ts +24 -0
  60. package/lib/chat/notebook/EphemeralNotebook.js +252 -0
  61. package/lib/chat/prompt/InputFooter.js +4 -1
  62. package/lib/client/AgentRuntimesClient.d.ts +127 -0
  63. package/lib/client/AgentRuntimesClient.js +36 -0
  64. package/lib/client/AgentsMixin.d.ts +4 -4
  65. package/lib/client/AgentsMixin.js +35 -35
  66. package/lib/client/SdkAgentRuntimesClient.d.ts +1 -1
  67. package/lib/client/SdkAgentRuntimesClient.js +1 -1
  68. package/lib/client/mixins/RuntimesMixin.d.ts +93 -0
  69. package/lib/client/mixins/RuntimesMixin.js +229 -0
  70. package/lib/client/mixins/SpacerMixin.d.ts +210 -0
  71. package/lib/client/mixins/SpacerMixin.js +615 -0
  72. package/lib/client/utils/spacerUtils.d.ts +18 -0
  73. package/lib/client/utils/spacerUtils.js +32 -0
  74. package/lib/collaboration/DatalayerCollaboration.d.ts +13 -0
  75. package/lib/collaboration/DatalayerCollaboration.js +28 -0
  76. package/lib/collaboration/DatalayerCollaborationProvider.d.ts +58 -0
  77. package/lib/collaboration/DatalayerCollaborationProvider.js +148 -0
  78. package/lib/collaboration/index.d.ts +2 -0
  79. package/lib/collaboration/index.js +6 -0
  80. package/lib/components/AgentSummary.d.ts +19 -0
  81. package/lib/components/AgentSummary.js +89 -0
  82. package/lib/components/ToolApprovalCard.js +13 -3
  83. package/lib/components/a2ui/A2uiSurfaceComposed.d.ts +13 -0
  84. package/lib/components/a2ui/A2uiSurfaceComposed.js +110 -0
  85. package/lib/components/a2ui/index.d.ts +2 -0
  86. package/lib/components/a2ui/index.js +6 -0
  87. package/lib/components/a2ui/styles.d.ts +14 -0
  88. package/lib/components/a2ui/styles.js +142 -0
  89. package/lib/components/context/SpaceSelect.d.ts +2 -0
  90. package/lib/components/context/SpaceSelect.js +42 -0
  91. package/lib/components/flashes/FlashDisclaimer.d.ts +2 -0
  92. package/lib/components/flashes/FlashDisclaimer.js +17 -0
  93. package/lib/components/icons/ArtifactIcon.d.ts +10 -0
  94. package/lib/components/icons/ArtifactIcon.js +58 -0
  95. package/lib/components/icons/index.d.ts +1 -0
  96. package/lib/components/icons/index.js +5 -0
  97. package/lib/components/index.d.ts +5 -0
  98. package/lib/components/index.js +5 -0
  99. package/lib/components/nbgrader/NbGradesDetails.d.ts +5 -0
  100. package/lib/components/nbgrader/NbGradesDetails.js +19 -0
  101. package/lib/components/nbgrader/index.d.ts +1 -0
  102. package/lib/components/nbgrader/index.js +5 -0
  103. package/lib/components/progress/CreditsIndicator.d.ts +33 -0
  104. package/lib/components/progress/CreditsIndicator.js +23 -0
  105. package/lib/components/progress/index.d.ts +2 -0
  106. package/lib/components/progress/index.js +6 -0
  107. package/lib/components/runtimes/RuntimeCellVariables.d.ts +39 -0
  108. package/lib/components/runtimes/RuntimeCellVariables.js +172 -0
  109. package/lib/components/runtimes/RuntimeCellVariablesDialog.d.ts +37 -0
  110. package/lib/components/runtimes/RuntimeCellVariablesDialog.js +101 -0
  111. package/lib/components/runtimes/RuntimeLauncherDialog.d.ts +57 -0
  112. package/lib/components/runtimes/RuntimeLauncherDialog.js +275 -0
  113. package/lib/components/runtimes/RuntimePickerBase.d.ts +69 -0
  114. package/lib/components/runtimes/RuntimePickerBase.js +122 -0
  115. package/lib/components/runtimes/RuntimePickerCell.d.ts +34 -0
  116. package/lib/components/runtimes/RuntimePickerCell.js +104 -0
  117. package/lib/components/runtimes/RuntimePickerNotebook.d.ts +42 -0
  118. package/lib/components/runtimes/RuntimePickerNotebook.js +232 -0
  119. package/lib/components/runtimes/RuntimeReservationControl.d.ts +47 -0
  120. package/lib/components/runtimes/RuntimeReservationControl.js +42 -0
  121. package/lib/components/runtimes/RuntimeSimplePicker.d.ts +38 -0
  122. package/lib/components/runtimes/RuntimeSimplePicker.js +155 -0
  123. package/lib/components/runtimes/RuntimeTransfer.d.ts +16 -0
  124. package/lib/components/runtimes/RuntimeTransfer.js +5 -0
  125. package/lib/components/runtimes/RuntimeUtils.d.ts +17 -0
  126. package/lib/components/runtimes/RuntimeUtils.js +178 -0
  127. package/lib/components/runtimes/RuntimeVariables.d.ts +38 -0
  128. package/lib/components/runtimes/RuntimeVariables.js +75 -0
  129. package/lib/components/runtimes/index.d.ts +11 -0
  130. package/lib/components/runtimes/index.js +15 -0
  131. package/lib/components/scheduler/ScheduleMenu.d.ts +54 -0
  132. package/lib/components/scheduler/ScheduleMenu.js +154 -0
  133. package/lib/components/scheduler/index.d.ts +1 -0
  134. package/lib/components/scheduler/index.js +5 -0
  135. package/lib/components/snapshots/SandboxSnapshotMenu.d.ts +33 -0
  136. package/lib/components/snapshots/SandboxSnapshotMenu.js +169 -0
  137. package/lib/components/snapshots/index.d.ts +1 -0
  138. package/lib/components/snapshots/index.js +5 -0
  139. package/lib/components/snippets/SnippetDialog.d.ts +42 -0
  140. package/lib/components/snippets/SnippetDialog.js +42 -0
  141. package/lib/components/students/StudentItemStatus.d.ts +7 -0
  142. package/lib/components/students/StudentItemStatus.js +68 -0
  143. package/lib/components/students/index.d.ts +1 -0
  144. package/lib/components/students/index.js +5 -0
  145. package/lib/components/tokens/SpaceVariantToken.d.ts +5 -0
  146. package/lib/components/tokens/SpaceVariantToken.js +23 -0
  147. package/lib/components/tokens/index.d.ts +1 -0
  148. package/lib/components/tokens/index.js +5 -0
  149. package/lib/components/toolbars/AssignmentEditorToolbar.d.ts +4 -0
  150. package/lib/components/toolbars/AssignmentEditorToolbar.js +18 -0
  151. package/lib/components/toolbars/DocumentEditorToolbar.d.ts +2 -0
  152. package/lib/components/toolbars/DocumentEditorToolbar.js +12 -0
  153. package/lib/components/toolbars/NotebookEditorToolbar.d.ts +29 -0
  154. package/lib/components/toolbars/NotebookEditorToolbar.js +30 -0
  155. package/lib/config/AgentConfiguration.d.ts +2 -2
  156. package/lib/config/index.d.ts +1 -1
  157. package/lib/context/ContextInspector.d.ts +1 -14
  158. package/lib/context/ContextInspector.js +3 -73
  159. package/lib/context/CostUsageChart.d.ts +4 -3
  160. package/lib/context/CostUsageChart.js +236 -35
  161. package/lib/context/MessageHistory.d.ts +30 -0
  162. package/lib/context/MessageHistory.js +129 -0
  163. package/lib/context/TokenUsageChart.d.ts +4 -3
  164. package/lib/context/TokenUsageChart.js +180 -30
  165. package/lib/context/TurnGraphChart.d.ts +1 -1
  166. package/lib/context/TurnGraphChart.js +6 -6
  167. package/lib/examples/A2UiAgentExample.d.ts +22 -0
  168. package/lib/examples/A2UiAgentExample.js +442 -0
  169. package/lib/examples/A2UiComponentsGalleryExample.d.ts +3 -0
  170. package/lib/examples/A2UiComponentsGalleryExample.js +863 -0
  171. package/lib/examples/A2UiContactCardExample.js +9 -5
  172. package/lib/examples/A2UiRestaurantExample.js +23 -8
  173. package/lib/examples/A2UiViewerExample.js +75 -3
  174. package/lib/examples/AgUiAgenticExample.d.ts +1 -12
  175. package/lib/examples/AgUiAgenticExample.js +52 -8
  176. package/lib/examples/AgUiBackendToolRenderingExample.d.ts +1 -16
  177. package/lib/examples/AgUiBackendToolRenderingExample.js +32 -17
  178. package/lib/examples/AgUiHaikuGenUiExample.d.ts +1 -17
  179. package/lib/examples/AgUiHaikuGenUiExample.js +49 -33
  180. package/lib/examples/AgUiHumanInTheLoopExample.d.ts +1 -12
  181. package/lib/examples/AgUiHumanInTheLoopExample.js +21 -6
  182. package/lib/examples/AgUiSharedStateExample.d.ts +1 -14
  183. package/lib/examples/AgUiSharedStateExample.js +21 -6
  184. package/lib/examples/AgUiToolsBasedGenUiExample.d.ts +1 -14
  185. package/lib/examples/AgUiToolsBasedGenUiExample.js +21 -6
  186. package/lib/examples/AgentCheckpointsExample.d.ts +1 -1
  187. package/lib/examples/AgentCheckpointsExample.js +21 -22
  188. package/lib/examples/AgentCodemodeExample.js +3 -3
  189. package/lib/examples/AgentEvalsExample.js +8 -8
  190. package/lib/examples/AgentGuardrailsExample.js +22 -17
  191. package/lib/examples/AgentHooksExample.js +16 -57
  192. package/lib/examples/AgentInferenceProviderExample.js +8 -8
  193. package/lib/examples/AgentLoopExample.d.ts +10 -0
  194. package/lib/examples/AgentLoopExample.js +304 -0
  195. package/lib/examples/AgentMCPExample.js +9 -9
  196. package/lib/examples/AgentMemoryExample.js +6 -6
  197. package/lib/examples/AgentMonitoringExample.js +116 -46
  198. package/lib/examples/AgentNotificationsExample.js +6 -6
  199. package/lib/examples/AgentOtelExample.d.ts +3 -3
  200. package/lib/examples/AgentOtelExample.js +20 -15
  201. package/lib/examples/AgentOutputsExample.js +8 -8
  202. package/lib/examples/AgentParametersExample.js +24 -36
  203. package/lib/examples/AgentSandboxExample.js +7 -7
  204. package/lib/examples/AgentSkillsExample.js +9 -9
  205. package/lib/examples/AgentSubagentsExample.js +6 -6
  206. package/lib/examples/AgentToolApprovalsExample.js +37 -11
  207. package/lib/examples/AgentTriggersExample.js +12 -12
  208. package/lib/examples/AgentspecsExample.js +63 -41
  209. package/lib/examples/ChatCustomExample.js +23 -77
  210. package/lib/examples/ChatExample.js +15 -46
  211. package/lib/examples/LexicalAgentExample.js +43 -91
  212. package/lib/examples/LexicalAgentSidebarExample.js +45 -73
  213. package/lib/examples/NotebookAgentExample.js +52 -81
  214. package/lib/examples/NotebookAgentSidebarExample.js +43 -71
  215. package/lib/examples/NotebookCollaborationExample.js +11 -9
  216. package/lib/examples/NotebookExample.js +5 -2
  217. package/lib/examples/components/AuthRequiredView.js +1 -1
  218. package/lib/examples/components/ExampleErrorBoundary.d.ts +46 -0
  219. package/lib/examples/components/ExampleErrorBoundary.js +67 -0
  220. package/lib/examples/components/haiku/haiku-card.css +11 -0
  221. package/lib/examples/components/weather/weather-card.css +11 -0
  222. package/lib/examples/example-selector.js +3 -1
  223. package/lib/examples/hooks/useExampleAgentRuntime.d.ts +35 -0
  224. package/lib/examples/hooks/useExampleAgentRuntime.js +82 -0
  225. package/lib/examples/hooks/useSpecRenderToolResult.d.ts +30 -0
  226. package/lib/examples/hooks/useSpecRenderToolResult.js +61 -0
  227. package/lib/examples/index.d.ts +3 -1
  228. package/lib/examples/index.js +3 -1
  229. package/lib/examples/main.js +340 -93
  230. package/lib/examples/utils/a2ui.d.ts +2 -0
  231. package/lib/examples/utils/a2ui.js +97 -2
  232. package/lib/examples/utils/agentSummaryStore.d.ts +21 -0
  233. package/lib/examples/utils/agentSummaryStore.js +23 -0
  234. package/lib/examples/utils/notebooks/Empty.ipynb.json +30 -30
  235. package/lib/examples/utils/runtimeTargetStore.d.ts +9 -0
  236. package/lib/examples/utils/runtimeTargetStore.js +27 -0
  237. package/lib/examples/utils/teardownAgents.d.ts +13 -0
  238. package/lib/examples/utils/teardownAgents.js +78 -0
  239. package/lib/examples/utils/useExampleAgentRuntimesUrl.d.ts +2 -0
  240. package/lib/examples/utils/useExampleAgentRuntimesUrl.js +26 -7
  241. package/lib/examples2/CellExample.d.ts +6 -0
  242. package/lib/examples2/CellExample.js +20 -0
  243. package/lib/examples2/DatalayerNotebookExample.d.ts +16 -0
  244. package/lib/examples2/DatalayerNotebookExample.js +109 -0
  245. package/lib/examples2/NativeNavigationExample.d.ts +8 -0
  246. package/lib/examples2/NativeNavigationExample.js +97 -0
  247. package/lib/examples2/NotebookExample.d.ts +6 -0
  248. package/lib/examples2/NotebookExample.js +19 -0
  249. package/lib/examples2/NotebookMutationsKernel.d.ts +2 -0
  250. package/lib/examples2/NotebookMutationsKernel.js +105 -0
  251. package/lib/examples2/NotebookMutationsServiceManager.d.ts +2 -0
  252. package/lib/examples2/NotebookMutationsServiceManager.js +109 -0
  253. package/lib/examples2/ReactRouterExample.d.ts +6 -0
  254. package/lib/examples2/ReactRouterExample.js +175 -0
  255. package/lib/examples2/example-selector.d.ts +22 -0
  256. package/lib/examples2/example-selector.js +45 -0
  257. package/lib/examples2/index.d.ts +2 -0
  258. package/lib/examples2/index.js +6 -0
  259. package/lib/examples2/lexical-theme.css +436 -0
  260. package/lib/examples2/main.d.ts +2 -0
  261. package/lib/examples2/main.js +330 -0
  262. package/lib/examples2/notebooks/IPyWidgetsExample.ipynb.json +101 -0
  263. package/lib/examples2/notebooks/IPyWidgetsExampleWithState.ipynb.json +112 -0
  264. package/lib/examples2/notebooks/Lite.ipynb.json +128 -0
  265. package/lib/examples2/notebooks/Matplotlib.ipynb.json +137 -0
  266. package/lib/examples2/notebooks/NotebookExample1.ipynb.json +126 -0
  267. package/lib/examples2/notebooks/NotebookExample2.ipynb.json +48 -0
  268. package/lib/examples2/notebooks/NotebookOutputs.ipynb.json +49 -0
  269. package/lib/examples2/notebooks/NotebookToCExample.ipynb.json +102 -0
  270. package/lib/examples2/notebooks/OutputIPyWidgetsExample.d.ts +145 -0
  271. package/lib/examples2/notebooks/OutputIPyWidgetsExample.js +153 -0
  272. package/lib/examples2/notebooks/PyGWalker.ipynb.json +55 -0
  273. package/lib/hooks/index.d.ts +9 -1
  274. package/lib/hooks/index.js +13 -1
  275. package/lib/hooks/useAIAgentsWebSocket.d.ts +1 -1
  276. package/lib/hooks/useAIAgentsWebSocket.js +39 -3
  277. package/lib/hooks/useAgentRuntimes.d.ts +15 -3
  278. package/lib/hooks/useAgentRuntimes.js +188 -29
  279. package/lib/hooks/useAgentsCatalog.d.ts +3 -3
  280. package/lib/hooks/useAgentsCatalog.js +4 -4
  281. package/lib/hooks/useAgentsService.js +5 -5
  282. package/lib/hooks/useCellOutputshot.d.ts +4 -0
  283. package/lib/hooks/useCellOutputshot.js +25 -0
  284. package/lib/hooks/useCheckpoints.d.ts +8 -8
  285. package/lib/hooks/useCheckpoints.js +38 -28
  286. package/lib/hooks/useConfig.d.ts +1 -1
  287. package/lib/hooks/useMonitoring.d.ts +7 -5
  288. package/lib/hooks/useMonitoring.js +16 -10
  289. package/lib/hooks/useNotifications.d.ts +11 -11
  290. package/lib/hooks/useNotifications.js +1 -1
  291. package/lib/hooks/useProgressStore.d.ts +25 -0
  292. package/lib/hooks/useProgressStore.js +58 -0
  293. package/lib/hooks/useProgressTask.d.ts +9 -0
  294. package/lib/hooks/useProgressTask.js +41 -0
  295. package/lib/hooks/useProjects.d.ts +628 -0
  296. package/lib/hooks/useProjects.js +190 -0
  297. package/lib/hooks/useRuntimes.d.ts +5 -0
  298. package/lib/hooks/useRuntimes.js +34 -0
  299. package/lib/hooks/useToolApprovals.d.ts +14 -6
  300. package/lib/hooks/useToolApprovals.js +20 -1
  301. package/lib/index.d.ts +2 -1
  302. package/lib/index.js +1 -0
  303. package/lib/jupyter/exec/Python.d.ts +5 -0
  304. package/lib/jupyter/exec/Python.js +100 -0
  305. package/lib/jupyter/exec/Snippets.d.ts +105 -0
  306. package/lib/jupyter/exec/Snippets.js +101 -0
  307. package/lib/jupyter/exec/index.d.ts +2 -0
  308. package/lib/jupyter/exec/index.js +6 -0
  309. package/lib/jupyter/index.d.ts +2 -0
  310. package/lib/jupyter/index.js +6 -0
  311. package/lib/jupyter/kernelsHandler.d.ts +8 -0
  312. package/lib/jupyter/kernelsHandler.js +39 -0
  313. package/lib/mocks/models/CourseMock.d.ts +6 -0
  314. package/lib/mocks/models/CourseMock.js +29 -0
  315. package/lib/mocks/models/SpaceMock.d.ts +6 -0
  316. package/lib/mocks/models/SpaceMock.js +25 -0
  317. package/lib/models/Assignment.d.ts +7 -0
  318. package/lib/models/Assignment.js +5 -0
  319. package/lib/models/Cell.d.ts +8 -0
  320. package/lib/models/Cell.js +5 -0
  321. package/lib/models/CodeBlock.d.ts +10 -0
  322. package/lib/models/CodeBlock.js +5 -0
  323. package/lib/models/CodeSandboxSnapshot.d.ts +92 -0
  324. package/lib/models/CodeSandboxSnapshot.js +13 -0
  325. package/lib/models/CodeSandboxSnapshotDTO.d.ts +173 -0
  326. package/lib/models/CodeSandboxSnapshotDTO.js +139 -0
  327. package/lib/models/CodefeedBlocks.d.ts +7 -0
  328. package/lib/models/CodefeedBlocks.js +5 -0
  329. package/lib/models/Content.d.ts +5 -0
  330. package/lib/models/Content.js +5 -0
  331. package/lib/models/Course.d.ts +17 -0
  332. package/lib/models/Course.js +5 -0
  333. package/lib/models/Dataset.d.ts +16 -0
  334. package/lib/models/Dataset.js +5 -0
  335. package/lib/models/Document.d.ts +8 -0
  336. package/lib/models/Document.js +5 -0
  337. package/lib/models/Environment.d.ts +86 -0
  338. package/lib/models/Environment.js +5 -0
  339. package/lib/models/EnvironmentDTO.d.ts +125 -0
  340. package/lib/models/EnvironmentDTO.js +88 -0
  341. package/lib/models/Exercise.d.ts +16 -0
  342. package/lib/models/Exercise.js +5 -0
  343. package/lib/models/Item.d.ts +20 -0
  344. package/lib/models/Item.js +5 -0
  345. package/lib/models/ItemDTO.d.ts +74 -0
  346. package/lib/models/ItemDTO.js +186 -0
  347. package/lib/models/ItemType.d.ts +2 -0
  348. package/lib/models/ItemType.js +5 -0
  349. package/lib/models/Lesson.d.ts +5 -0
  350. package/lib/models/Lesson.js +5 -0
  351. package/lib/models/LexicalDTO.d.ts +155 -0
  352. package/lib/models/LexicalDTO.js +157 -0
  353. package/lib/models/Library.d.ts +10 -0
  354. package/lib/models/Library.js +5 -0
  355. package/lib/models/Notebook.d.ts +11 -0
  356. package/lib/models/Notebook.js +5 -0
  357. package/lib/models/NotebookDTO.d.ts +96 -0
  358. package/lib/models/NotebookDTO.js +153 -0
  359. package/lib/models/Page.d.ts +41 -0
  360. package/lib/models/Page.js +25 -0
  361. package/lib/models/PageTag.d.ts +19 -0
  362. package/lib/models/PageTag.js +94 -0
  363. package/lib/models/ProjectDTO.d.ts +89 -0
  364. package/lib/models/ProjectDTO.js +131 -0
  365. package/lib/models/Runtime.d.ts +160 -0
  366. package/lib/models/Runtime.js +18 -0
  367. package/lib/models/RuntimeDTO.d.ts +172 -0
  368. package/lib/models/RuntimeDTO.js +204 -0
  369. package/lib/models/Space.d.ts +35 -0
  370. package/lib/models/Space.js +66 -0
  371. package/lib/models/SpaceDTO.d.ts +334 -0
  372. package/lib/models/SpaceDTO.js +244 -0
  373. package/lib/models/SpaceItem.d.ts +10 -0
  374. package/lib/models/SpaceItem.js +5 -0
  375. package/lib/models/SpaceMember.d.ts +6 -0
  376. package/lib/models/SpaceMember.js +5 -0
  377. package/lib/models/StudentItem.d.ts +21 -0
  378. package/lib/models/StudentItem.js +5 -0
  379. package/lib/models/index.d.ts +32 -0
  380. package/lib/models/index.js +39 -0
  381. package/lib/protocols/AGUIAdapter.js +1 -1
  382. package/lib/runtimes/actions.d.ts +102 -0
  383. package/lib/runtimes/actions.js +249 -0
  384. package/lib/runtimes/apis.d.ts +273 -0
  385. package/lib/runtimes/apis.js +5 -0
  386. package/lib/runtimes/index.d.ts +5 -0
  387. package/lib/runtimes/index.js +9 -0
  388. package/lib/runtimes/settings.d.ts +15 -0
  389. package/lib/runtimes/settings.js +31 -0
  390. package/lib/runtimes/snapshots.d.ts +25 -0
  391. package/lib/runtimes/snapshots.js +150 -0
  392. package/lib/runtimes/utils.d.ts +7 -0
  393. package/lib/runtimes/utils.js +14 -0
  394. package/lib/services/DatalayerServiceManager.d.ts +23 -0
  395. package/lib/services/DatalayerServiceManager.js +90 -0
  396. package/lib/services/reconnectToRuntime.d.ts +32 -0
  397. package/lib/services/reconnectToRuntime.js +59 -0
  398. package/lib/services/sandboxServiceManagers.d.ts +31 -0
  399. package/lib/services/sandboxServiceManagers.js +57 -0
  400. package/lib/specs/agents/agents.d.ts +95 -50
  401. package/lib/specs/agents/agents.js +4037 -1669
  402. package/lib/specs/agents/index.d.ts +5 -5
  403. package/lib/specs/agents/index.js +9 -9
  404. package/lib/specs/index.d.ts +1 -0
  405. package/lib/specs/index.js +1 -0
  406. package/lib/specs/loops.d.ts +34 -0
  407. package/lib/specs/loops.js +188 -0
  408. package/lib/specs/mcpServers.d.ts +1 -0
  409. package/lib/specs/mcpServers.js +17 -0
  410. package/lib/specs/models.d.ts +4 -0
  411. package/lib/specs/models.js +30 -0
  412. package/lib/specs/skills.d.ts +1 -0
  413. package/lib/specs/skills.js +18 -0
  414. package/lib/specs/tools.d.ts +15 -0
  415. package/lib/specs/tools.js +285 -0
  416. package/lib/state/index.d.ts +4 -0
  417. package/lib/state/index.js +10 -0
  418. package/lib/state/substates/CellState.d.ts +12 -0
  419. package/lib/state/substates/CellState.js +22 -0
  420. package/lib/state/substates/DocumentState.d.ts +10 -0
  421. package/lib/state/substates/DocumentState.js +14 -0
  422. package/lib/state/substates/GradeState.d.ts +10 -0
  423. package/lib/state/substates/GradeState.js +14 -0
  424. package/lib/state/substates/JupyterLabState.d.ts +16 -0
  425. package/lib/state/substates/JupyterLabState.js +17 -0
  426. package/lib/state/substates/NbformatState.d.ts +13 -0
  427. package/lib/state/substates/NbformatState.js +16 -0
  428. package/lib/state/substates/RuntimesState.d.ts +87 -0
  429. package/lib/state/substates/RuntimesState.js +192 -0
  430. package/lib/state/substates/SpaceState.d.ts +11 -0
  431. package/lib/state/substates/SpaceState.js +16 -0
  432. package/lib/state/substates/index.d.ts +8 -0
  433. package/lib/state/substates/index.js +14 -0
  434. package/lib/stores/agentRuntimeStore.d.ts +25 -2
  435. package/lib/stores/agentRuntimeStore.js +114 -19
  436. package/lib/stories/Button.stories.d.ts +1 -1
  437. package/lib/stories/Header.stories.d.ts +3 -3
  438. package/lib/test-setup.js +10 -0
  439. package/lib/types/agents-lifecycle.d.ts +5 -5
  440. package/lib/types/agents.d.ts +6 -6
  441. package/lib/types/agentspecs.d.ts +8 -4
  442. package/lib/types/chat.d.ts +135 -3
  443. package/lib/types/config.d.ts +19 -1
  444. package/lib/types/index.d.ts +1 -0
  445. package/lib/types/index.js +1 -0
  446. package/lib/types/loops.d.ts +64 -0
  447. package/lib/types/loops.js +5 -0
  448. package/lib/types/teams.d.ts +2 -2
  449. package/lib/types/tools.d.ts +16 -0
  450. package/lib/utils/Cells.d.ts +2 -0
  451. package/lib/utils/Cells.js +28 -0
  452. package/package.json +24 -18
  453. package/scripts/codegen/generate_agents.py +96 -61
  454. package/scripts/codegen/generate_loops.py +443 -0
  455. package/scripts/codegen/generate_teams.py +4 -4
  456. package/lib/examples/A2UiComponentGalleryExample.d.ts +0 -3
  457. package/lib/examples/A2UiComponentGalleryExample.js +0 -361
  458. package/scripts/codegen/__pycache__/generate_agents.cpython-313.pyc +0 -0
  459. package/scripts/codegen/__pycache__/generate_benchmarks.cpython-313.pyc +0 -0
  460. package/scripts/codegen/__pycache__/generate_evals.cpython-313.pyc +0 -0
  461. package/scripts/codegen/__pycache__/generate_events.cpython-313.pyc +0 -0
  462. /package/lib/{agent-lexical-main.d.ts → agent-document-main.d.ts} +0 -0
@@ -0,0 +1,863 @@
1
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ /*
3
+ * Copyright (c) 2025-2026 Datalayer, Inc.
4
+ * Distributed under the terms of the Modified BSD License.
5
+ */
6
+ import { useCallback, useEffect, useMemo, useRef, useState, } from 'react';
7
+ import { Box } from '@datalayer/primer-addons';
8
+ import { Button, SegmentedControl, Text } from '@primer/react';
9
+ import { A2UI_RENDER_SCOPE_SX, A2uiSurfaceComposed } from '../components/a2ui';
10
+ import { basicCatalog } from '@a2ui/react/v0_9';
11
+ import { ThemedProvider } from './utils/themedProvider';
12
+ import { A2uiMarkdownProvider } from './utils/a2uiMarkdownProvider';
13
+ import { createSceneMessages, useA2uiProcessor } from './utils/a2ui';
14
+ import { useExampleAgentRuntimesUrl } from './utils/useExampleAgentRuntimesUrl';
15
+ const extractA2uiMessages = (parts) => {
16
+ const messages = [];
17
+ parts.forEach(part => {
18
+ const node = part.root ?? part;
19
+ if (node.kind !== 'data' || !node.data) {
20
+ return;
21
+ }
22
+ const payload = node.data;
23
+ if (payload.version !== 'v0.9') {
24
+ return;
25
+ }
26
+ const createSurface = payload.createSurface;
27
+ if (createSurface && createSurface.catalogId !== basicCatalog.id) {
28
+ createSurface.catalogId = basicCatalog.id;
29
+ }
30
+ messages.push(payload);
31
+ });
32
+ return messages;
33
+ };
34
+ const SCENES = [
35
+ {
36
+ id: 'typography',
37
+ label: 'Typography',
38
+ description: 'Text, Icon, Row, and Button components bound to data-model values.',
39
+ messages: createSceneMessages({
40
+ surfaceId: 'gallery-typography',
41
+ components: [
42
+ { id: 'root', component: 'Card', child: 'main' },
43
+ {
44
+ id: 'main',
45
+ component: 'Column',
46
+ children: ['title', 'subtitle', 'meta-row', 'cta-label', 'cta'],
47
+ },
48
+ {
49
+ id: 'title',
50
+ component: 'Text',
51
+ variant: 'h2',
52
+ text: { path: '/title' },
53
+ },
54
+ { id: 'subtitle', component: 'Text', text: { path: '/subtitle' } },
55
+ {
56
+ id: 'meta-row',
57
+ component: 'Row',
58
+ align: 'center',
59
+ children: ['meta-icon', 'meta-text'],
60
+ },
61
+ { id: 'meta-icon', component: 'Icon', name: 'star' },
62
+ {
63
+ id: 'meta-text',
64
+ component: 'Text',
65
+ variant: 'caption',
66
+ text: { path: '/meta' },
67
+ },
68
+ { id: 'cta-label', component: 'Text', text: 'Trigger Action' },
69
+ {
70
+ id: 'cta',
71
+ component: 'Button',
72
+ child: 'cta-label',
73
+ variant: 'primary',
74
+ action: {
75
+ event: {
76
+ name: 'gallery_typography_cta',
77
+ context: { section: 'typography', title: { path: '/title' } },
78
+ },
79
+ },
80
+ },
81
+ ],
82
+ value: {
83
+ title: 'A2UI Gallery',
84
+ subtitle: 'Protocol-native renderer with typed schemas and dynamic bindings.',
85
+ meta: 'createSurface · updateComponents · updateDataModel',
86
+ },
87
+ }),
88
+ },
89
+ {
90
+ id: 'contact-card',
91
+ label: 'Contact',
92
+ description: 'Card layout with icons and data-bound profile information.',
93
+ messages: createSceneMessages({
94
+ surfaceId: 'gallery-contact-card',
95
+ components: [
96
+ { id: 'root', component: 'Card', child: 'main-column' },
97
+ {
98
+ id: 'main-column',
99
+ component: 'Column',
100
+ align: 'center',
101
+ children: [
102
+ 'avatar-image',
103
+ 'name',
104
+ 'title',
105
+ 'divider',
106
+ 'contact-info',
107
+ ],
108
+ },
109
+ {
110
+ id: 'avatar-image',
111
+ component: 'Image',
112
+ url: { path: '/avatar' },
113
+ fit: 'cover',
114
+ variant: 'avatar',
115
+ },
116
+ {
117
+ id: 'name',
118
+ component: 'Text',
119
+ variant: 'h2',
120
+ text: { path: '/name' },
121
+ },
122
+ { id: 'title', component: 'Text', text: { path: '/title' } },
123
+ { id: 'divider', component: 'Divider' },
124
+ {
125
+ id: 'contact-info',
126
+ component: 'Column',
127
+ children: ['phone-row', 'email-row', 'location-row'],
128
+ },
129
+ {
130
+ id: 'phone-row',
131
+ component: 'Row',
132
+ align: 'center',
133
+ children: ['phone-icon', 'phone-text'],
134
+ },
135
+ { id: 'phone-icon', component: 'Icon', name: 'phone' },
136
+ { id: 'phone-text', component: 'Text', text: { path: '/phone' } },
137
+ {
138
+ id: 'email-row',
139
+ component: 'Row',
140
+ align: 'center',
141
+ children: ['email-icon', 'email-text'],
142
+ },
143
+ { id: 'email-icon', component: 'Icon', name: 'mail' },
144
+ { id: 'email-text', component: 'Text', text: { path: '/email' } },
145
+ {
146
+ id: 'location-row',
147
+ component: 'Row',
148
+ align: 'center',
149
+ children: ['location-icon', 'location-text'],
150
+ },
151
+ { id: 'location-icon', component: 'Icon', name: 'locationOn' },
152
+ { id: 'location-text', component: 'Text', text: { path: '/location' } },
153
+ ],
154
+ value: {
155
+ avatar: 'https://images.unsplash.com/photo-1507003211169-0a1dd7228f2d?w=100&h=100&fit=crop',
156
+ name: 'David Park',
157
+ title: 'Engineering Manager',
158
+ phone: '+1 (555) 234-5678',
159
+ email: 'david.park@company.com',
160
+ location: 'San Francisco, CA',
161
+ },
162
+ }),
163
+ },
164
+ {
165
+ id: 'controls',
166
+ label: 'Controls',
167
+ description: 'Interactive inputs: TextField, ChoicePicker, CheckBox, Slider, DateTimeInput.',
168
+ messages: createSceneMessages({
169
+ surfaceId: 'gallery-controls',
170
+ components: [
171
+ { id: 'root', component: 'Card', child: 'controls-column' },
172
+ {
173
+ id: 'controls-column',
174
+ component: 'Column',
175
+ children: [
176
+ 'title',
177
+ 'name-field',
178
+ 'plan-picker',
179
+ 'alerts-checkbox',
180
+ 'volume-slider',
181
+ 'when-field',
182
+ 'submit-label',
183
+ 'submit',
184
+ ],
185
+ },
186
+ {
187
+ id: 'title',
188
+ component: 'Text',
189
+ variant: 'h3',
190
+ text: 'Interactive Inputs',
191
+ },
192
+ {
193
+ id: 'name-field',
194
+ component: 'TextField',
195
+ label: 'Name',
196
+ value: { path: '/name' },
197
+ },
198
+ {
199
+ id: 'plan-picker',
200
+ component: 'ChoicePicker',
201
+ label: 'Plan',
202
+ value: { path: '/plan' },
203
+ options: [
204
+ { label: 'Starter', value: 'starter' },
205
+ { label: 'Pro', value: 'pro' },
206
+ { label: 'Enterprise', value: 'enterprise' },
207
+ ],
208
+ },
209
+ {
210
+ id: 'alerts-checkbox',
211
+ component: 'CheckBox',
212
+ label: 'Enable alerts',
213
+ value: { path: '/alerts' },
214
+ },
215
+ {
216
+ id: 'volume-slider',
217
+ component: 'Slider',
218
+ label: 'Volume',
219
+ value: { path: '/volume' },
220
+ min: 0,
221
+ max: 100,
222
+ },
223
+ {
224
+ id: 'when-field',
225
+ component: 'DateTimeInput',
226
+ label: 'Reminder time',
227
+ value: { path: '/when' },
228
+ },
229
+ { id: 'submit-label', component: 'Text', text: 'Submit' },
230
+ {
231
+ id: 'submit',
232
+ component: 'Button',
233
+ variant: 'primary',
234
+ child: 'submit-label',
235
+ action: {
236
+ event: {
237
+ name: 'submit_controls',
238
+ context: {
239
+ name: { path: '/name' },
240
+ plan: { path: '/plan' },
241
+ alerts: { path: '/alerts' },
242
+ volume: { path: '/volume' },
243
+ when: { path: '/when' },
244
+ },
245
+ },
246
+ },
247
+ },
248
+ ],
249
+ value: {
250
+ name: 'Morgan',
251
+ plan: 'pro',
252
+ alerts: true,
253
+ volume: 64,
254
+ when: '2026-05-01T18:30:00Z',
255
+ },
256
+ }),
257
+ },
258
+ {
259
+ id: 'tabs-modal',
260
+ label: 'Tabs + Modal',
261
+ description: 'Tabs with nested content and a modal trigger using event actions.',
262
+ messages: createSceneMessages({
263
+ surfaceId: 'gallery-tabs-modal',
264
+ components: [
265
+ { id: 'root', component: 'Column', children: ['tabs', 'modal'] },
266
+ {
267
+ id: 'tabs',
268
+ component: 'Tabs',
269
+ tabs: [
270
+ { title: 'Overview', child: 'tab-overview' },
271
+ { title: 'Details', child: 'tab-details' },
272
+ ],
273
+ },
274
+ {
275
+ id: 'tab-overview',
276
+ component: 'Card',
277
+ child: 'tab-overview-text',
278
+ },
279
+ {
280
+ id: 'tab-overview-text',
281
+ component: 'Text',
282
+ text: 'Overview tab uses static component composition.',
283
+ },
284
+ {
285
+ id: 'tab-details',
286
+ component: 'Card',
287
+ child: 'tab-details-text',
288
+ },
289
+ {
290
+ id: 'tab-details-text',
291
+ component: 'Text',
292
+ text: 'Details tab includes modal interaction below.',
293
+ },
294
+ { id: 'modal-trigger-label', component: 'Text', text: 'Open Modal' },
295
+ {
296
+ id: 'modal-content-text',
297
+ component: 'Text',
298
+ text: 'This content is rendered inside a modal.',
299
+ },
300
+ {
301
+ id: 'modal-content',
302
+ component: 'Card',
303
+ child: 'modal-content-text',
304
+ },
305
+ {
306
+ id: 'modal-trigger',
307
+ component: 'Button',
308
+ child: 'modal-trigger-label',
309
+ action: { event: { name: 'open_modal' } },
310
+ },
311
+ {
312
+ id: 'modal',
313
+ component: 'Modal',
314
+ trigger: 'modal-trigger',
315
+ content: 'modal-content',
316
+ },
317
+ ],
318
+ }),
319
+ },
320
+ {
321
+ id: 'restaurant-card',
322
+ label: 'Restaurant',
323
+ description: 'Restaurant card layout with image, rating, ETA, and action.',
324
+ messages: createSceneMessages({
325
+ surfaceId: 'gallery-restaurant-card',
326
+ components: [
327
+ { id: 'root', component: 'Card', child: 'main' },
328
+ {
329
+ id: 'main',
330
+ component: 'Column',
331
+ children: [
332
+ 'hero',
333
+ 'title-row',
334
+ 'meta',
335
+ 'stats-row',
336
+ 'cta-label',
337
+ 'cta',
338
+ ],
339
+ },
340
+ {
341
+ id: 'hero',
342
+ component: 'Image',
343
+ url: { path: '/image' },
344
+ fit: 'cover',
345
+ variant: 'largeFeature',
346
+ },
347
+ {
348
+ id: 'title-row',
349
+ component: 'Row',
350
+ justify: 'spaceBetween',
351
+ children: ['title', 'price'],
352
+ },
353
+ {
354
+ id: 'title',
355
+ component: 'Text',
356
+ variant: 'h3',
357
+ text: { path: '/title' },
358
+ },
359
+ { id: 'price', component: 'Text', text: { path: '/price' } },
360
+ {
361
+ id: 'meta',
362
+ component: 'Text',
363
+ variant: 'caption',
364
+ text: { path: '/meta' },
365
+ },
366
+ {
367
+ id: 'stats-row',
368
+ component: 'Row',
369
+ justify: 'spaceBetween',
370
+ children: ['rating', 'eta', 'distance'],
371
+ },
372
+ {
373
+ id: 'rating',
374
+ component: 'Text',
375
+ variant: 'caption',
376
+ text: { path: '/rating' },
377
+ },
378
+ {
379
+ id: 'eta',
380
+ component: 'Text',
381
+ variant: 'caption',
382
+ text: { path: '/eta' },
383
+ },
384
+ {
385
+ id: 'distance',
386
+ component: 'Text',
387
+ variant: 'caption',
388
+ text: { path: '/distance' },
389
+ },
390
+ { id: 'cta-label', component: 'Text', text: 'Reserve Table' },
391
+ {
392
+ id: 'cta',
393
+ component: 'Button',
394
+ variant: 'primary',
395
+ child: 'cta-label',
396
+ action: {
397
+ event: {
398
+ name: 'reserve_restaurant',
399
+ context: {
400
+ restaurantId: { path: '/id' },
401
+ restaurantName: { path: '/title' },
402
+ },
403
+ },
404
+ },
405
+ },
406
+ ],
407
+ value: {
408
+ id: 'rest_italian_001',
409
+ image: 'https://images.unsplash.com/photo-1517248135467-4c7edcad34c4?w=640&h=360&fit=crop',
410
+ title: 'The Italian Kitchen',
411
+ price: '$$$',
412
+ meta: 'Italian • Pasta • Wine Bar',
413
+ rating: '⭐ 4.8 (2,847 reviews)',
414
+ eta: '25-35 min',
415
+ distance: '0.8 mi',
416
+ },
417
+ }),
418
+ },
419
+ {
420
+ id: 'list',
421
+ label: 'Data List',
422
+ description: 'List component rendering a data-bound template with per-item actions.',
423
+ messages: createSceneMessages({
424
+ surfaceId: 'gallery-list',
425
+ components: [
426
+ { id: 'root', component: 'Column', children: ['heading', 'items'] },
427
+ {
428
+ id: 'heading',
429
+ component: 'Text',
430
+ variant: 'h2',
431
+ text: { path: '/title' },
432
+ },
433
+ {
434
+ id: 'items',
435
+ component: 'List',
436
+ direction: 'vertical',
437
+ children: { componentId: 'item-template', path: '/items' },
438
+ },
439
+ { id: 'item-template', component: 'Card', child: 'item-row' },
440
+ {
441
+ id: 'item-row',
442
+ component: 'Row',
443
+ align: 'center',
444
+ children: ['item-image', 'item-details', 'item-cta'],
445
+ },
446
+ {
447
+ id: 'item-image',
448
+ component: 'Image',
449
+ url: { path: 'image' },
450
+ fit: 'cover',
451
+ variant: 'smallFeature',
452
+ weight: 1,
453
+ },
454
+ {
455
+ id: 'item-details',
456
+ component: 'Column',
457
+ weight: 3,
458
+ children: ['item-name', 'item-meta'],
459
+ },
460
+ {
461
+ id: 'item-name',
462
+ component: 'Text',
463
+ variant: 'h3',
464
+ text: { path: 'name' },
465
+ },
466
+ {
467
+ id: 'item-meta',
468
+ component: 'Text',
469
+ variant: 'caption',
470
+ text: { path: 'meta' },
471
+ },
472
+ {
473
+ id: 'item-cta',
474
+ component: 'Button',
475
+ variant: 'primary',
476
+ child: 'item-cta-label',
477
+ action: {
478
+ event: {
479
+ name: 'select_item',
480
+ context: { id: { path: 'id' }, name: { path: 'name' } },
481
+ },
482
+ },
483
+ },
484
+ { id: 'item-cta-label', component: 'Text', text: 'Select' },
485
+ ],
486
+ value: {
487
+ title: 'Featured Restaurants',
488
+ items: [
489
+ {
490
+ id: 'rest_001',
491
+ name: "Xi'an Famous Foods",
492
+ meta: '★★★★☆ · Hand-pulled noodles',
493
+ image: 'https://images.unsplash.com/photo-1569718212165-3a8278d5f624?w=200&h=200&fit=crop',
494
+ },
495
+ {
496
+ id: 'rest_002',
497
+ name: 'Han Dynasty',
498
+ meta: '★★★★☆ · Authentic Szechuan',
499
+ image: 'https://images.unsplash.com/photo-1525755662778-989d0524087e?w=200&h=200&fit=crop',
500
+ },
501
+ {
502
+ id: 'rest_003',
503
+ name: 'RedFarm',
504
+ meta: '★★★★☆ · Farm-to-table Chinese',
505
+ image: 'https://images.unsplash.com/photo-1563245372-f21724e3856d?w=200&h=200&fit=crop',
506
+ },
507
+ ],
508
+ },
509
+ }),
510
+ },
511
+ {
512
+ id: 'media',
513
+ label: 'Media',
514
+ description: 'Video and AudioPlayer components from the basic catalog.',
515
+ messages: createSceneMessages({
516
+ surfaceId: 'gallery-media',
517
+ components: [
518
+ { id: 'root', component: 'Card', child: 'media-column' },
519
+ {
520
+ id: 'media-column',
521
+ component: 'Column',
522
+ children: ['media-title', 'video', 'audio-title', 'audio'],
523
+ },
524
+ {
525
+ id: 'media-title',
526
+ component: 'Text',
527
+ variant: 'h3',
528
+ text: 'Media Components',
529
+ },
530
+ { id: 'video', component: 'Video', url: { path: '/videoUrl' } },
531
+ {
532
+ id: 'audio-title',
533
+ component: 'Text',
534
+ variant: 'caption',
535
+ text: { path: '/audioLabel' },
536
+ },
537
+ {
538
+ id: 'audio',
539
+ component: 'AudioPlayer',
540
+ url: { path: '/audioUrl' },
541
+ description: { path: '/audioLabel' },
542
+ },
543
+ ],
544
+ value: {
545
+ videoUrl: 'https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4',
546
+ audioLabel: 'Sample audio track',
547
+ audioUrl: 'https://commondatastorage.googleapis.com/codeskulptor-demos/DDR_assets/Kangaroo_MusiQue_-_The_Neverwritten_Role_Playing_Game.mp3',
548
+ },
549
+ }),
550
+ },
551
+ {
552
+ id: 'validation',
553
+ label: 'Form Validation',
554
+ description: 'Live client-side validation via local function evaluation (email, regex, and/or/required) with two-way data binding.',
555
+ messages: createSceneMessages({
556
+ surfaceId: 'gallery-validation',
557
+ components: [
558
+ { id: 'root', component: 'Card', child: 'main-column' },
559
+ {
560
+ id: 'main-column',
561
+ component: 'Column',
562
+ align: 'stretch',
563
+ children: [
564
+ 'welcome-text',
565
+ 'email-field',
566
+ 'phone-field',
567
+ 'zip-field',
568
+ 'terms-checkbox',
569
+ 'submit-btn',
570
+ ],
571
+ },
572
+ {
573
+ id: 'welcome-text',
574
+ component: 'Text',
575
+ variant: 'h3',
576
+ text: {
577
+ call: 'formatString',
578
+ args: {
579
+ value: "Hello! Today is ${formatDate(value: ${/now}, format: 'EEEE, MMMM d')}.",
580
+ },
581
+ returnType: 'string',
582
+ },
583
+ },
584
+ {
585
+ id: 'email-field',
586
+ component: 'TextField',
587
+ label: 'Email Address',
588
+ value: { path: '/formData/email' },
589
+ checks: [
590
+ {
591
+ condition: {
592
+ call: 'email',
593
+ args: { value: { path: '/formData/email' } },
594
+ },
595
+ message: 'Invalid email format',
596
+ },
597
+ ],
598
+ },
599
+ {
600
+ id: 'phone-field',
601
+ component: 'TextField',
602
+ label: 'Phone Number',
603
+ value: { path: '/formData/phone' },
604
+ checks: [
605
+ {
606
+ condition: {
607
+ call: 'regex',
608
+ args: {
609
+ value: { path: '/formData/phone' },
610
+ pattern: '^\\+?[0-9]{10,15}$',
611
+ },
612
+ },
613
+ message: 'Invalid phone format',
614
+ },
615
+ ],
616
+ },
617
+ {
618
+ id: 'zip-field',
619
+ component: 'TextField',
620
+ label: 'Zip Code',
621
+ value: { path: '/formData/zip' },
622
+ checks: [
623
+ {
624
+ condition: {
625
+ call: 'regex',
626
+ args: {
627
+ value: { path: '/formData/zip' },
628
+ pattern: '^[0-9]{5}$',
629
+ },
630
+ },
631
+ message: 'Must be exactly 5 digits',
632
+ },
633
+ ],
634
+ },
635
+ {
636
+ id: 'terms-checkbox',
637
+ component: 'CheckBox',
638
+ label: 'I agree to the terms and conditions',
639
+ value: { path: '/formData/agree' },
640
+ },
641
+ {
642
+ id: 'submit-btn-text',
643
+ component: 'Text',
644
+ text: 'Submit Registration',
645
+ },
646
+ {
647
+ id: 'submit-btn',
648
+ component: 'Button',
649
+ variant: 'primary',
650
+ child: 'submit-btn-text',
651
+ checks: [
652
+ {
653
+ condition: {
654
+ call: 'and',
655
+ args: {
656
+ values: [
657
+ { path: '/formData/agree' },
658
+ {
659
+ call: 'or',
660
+ args: {
661
+ values: [
662
+ {
663
+ call: 'required',
664
+ args: { value: { path: '/formData/email' } },
665
+ },
666
+ {
667
+ call: 'required',
668
+ args: { value: { path: '/formData/phone' } },
669
+ },
670
+ ],
671
+ },
672
+ },
673
+ {
674
+ call: 'required',
675
+ args: { value: { path: '/formData/zip' } },
676
+ },
677
+ ],
678
+ },
679
+ },
680
+ message: 'You must agree to terms AND provide either Email or Phone, plus a Zip code.',
681
+ },
682
+ ],
683
+ action: {
684
+ event: {
685
+ name: 'gallery_register',
686
+ context: { data: { path: '/formData' } },
687
+ },
688
+ },
689
+ },
690
+ ],
691
+ value: {
692
+ now: '2025-12-15T12:00:00Z',
693
+ formData: {
694
+ email: '',
695
+ phone: '',
696
+ zip: '',
697
+ agree: false,
698
+ },
699
+ },
700
+ }),
701
+ },
702
+ ];
703
+ function GalleryContent({ onAction, }) {
704
+ const baseUrl = useExampleAgentRuntimesUrl();
705
+ const supportEndpoint = `${baseUrl}/api/v1/a2ui/support-assistant/`;
706
+ const supportHealthEndpoint = `${baseUrl}/api/v1/a2ui/support-assistant/health`;
707
+ const [selectedScene, setSelectedScene] = useState(SCENES[0].id);
708
+ const [backendLoading, setBackendLoading] = useState(false);
709
+ const [backendSummary, setBackendSummary] = useState('');
710
+ const [backendError, setBackendError] = useState(null);
711
+ const [backendHealth, setBackendHealth] = useState('unknown');
712
+ const [backendMode, setBackendMode] = useState(false);
713
+ const backendModeRef = useRef(false);
714
+ const sendSupportPayloadRef = useRef(null);
715
+ const handleAction = useCallback((action) => {
716
+ onAction(action);
717
+ if (!backendModeRef.current || !sendSupportPayloadRef.current) {
718
+ return;
719
+ }
720
+ void sendSupportPayloadRef.current({
721
+ action: action.name,
722
+ context: action.context,
723
+ });
724
+ }, [onAction]);
725
+ const { surfaces, processMessages, resetSurfaces, themeStyle } = useA2uiProcessor(handleAction);
726
+ const sendSupportPayload = useCallback(async (payload) => {
727
+ setBackendLoading(true);
728
+ setBackendError(null);
729
+ try {
730
+ const response = await fetch(supportEndpoint, {
731
+ method: 'POST',
732
+ headers: { 'Content-Type': 'application/json' },
733
+ body: JSON.stringify(payload),
734
+ });
735
+ if (!response.ok) {
736
+ const data = (await response.json());
737
+ throw new Error(data.detail || 'Support endpoint request failed');
738
+ }
739
+ const parts = (await response.json());
740
+ const messages = extractA2uiMessages(parts);
741
+ if (messages.length === 0) {
742
+ throw new Error('Python backend did not return A2UI messages');
743
+ }
744
+ resetSurfaces();
745
+ processMessages(messages);
746
+ setBackendMode(true);
747
+ const serverText = parts
748
+ .map(part => {
749
+ const node = part.root ?? part;
750
+ return node.kind === 'text' ? node.text : undefined;
751
+ })
752
+ .filter(Boolean)
753
+ .join(' ');
754
+ setBackendSummary(serverText ||
755
+ 'Python backend surface loaded from /api/v1/a2ui/support-assistant/.');
756
+ }
757
+ catch (err) {
758
+ setBackendError(err instanceof Error ? err.message : 'Unknown backend error');
759
+ }
760
+ finally {
761
+ setBackendLoading(false);
762
+ }
763
+ }, [processMessages, resetSurfaces, supportEndpoint]);
764
+ useEffect(() => {
765
+ backendModeRef.current = backendMode;
766
+ }, [backendMode]);
767
+ useEffect(() => {
768
+ sendSupportPayloadRef.current = sendSupportPayload;
769
+ }, [sendSupportPayload]);
770
+ useEffect(() => {
771
+ let cancelled = false;
772
+ const probe = async () => {
773
+ try {
774
+ const response = await fetch(supportHealthEndpoint);
775
+ if (!response.ok) {
776
+ throw new Error('Health check failed');
777
+ }
778
+ const data = (await response.json());
779
+ if (!cancelled) {
780
+ setBackendHealth(data.status === 'healthy' ? 'healthy' : 'unhealthy');
781
+ }
782
+ }
783
+ catch {
784
+ if (!cancelled) {
785
+ setBackendHealth('unhealthy');
786
+ }
787
+ }
788
+ };
789
+ void probe();
790
+ return () => {
791
+ cancelled = true;
792
+ };
793
+ }, [supportHealthEndpoint]);
794
+ const currentScene = useMemo(() => SCENES.find(scene => scene.id === selectedScene) ?? SCENES[0], [selectedScene]);
795
+ const showScene = useCallback((scene) => {
796
+ resetSurfaces();
797
+ processMessages(scene.messages);
798
+ setBackendMode(false);
799
+ setBackendSummary('');
800
+ setBackendError(null);
801
+ }, [processMessages, resetSurfaces]);
802
+ const showAllScenes = useCallback(() => {
803
+ resetSurfaces();
804
+ SCENES.forEach(scene => {
805
+ processMessages(scene.messages);
806
+ });
807
+ setBackendMode(false);
808
+ setBackendSummary('');
809
+ setBackendError(null);
810
+ }, [processMessages, resetSurfaces]);
811
+ useEffect(() => {
812
+ showScene(currentScene);
813
+ }, [currentScene, showScene]);
814
+ return (_jsxs(Box, { sx: { display: 'flex', flexDirection: 'column', gap: 3, p: 3 }, children: [_jsxs(Box, { sx: {
815
+ width: '100%',
816
+ border: '1px solid',
817
+ borderColor: 'border.default',
818
+ borderRadius: 2,
819
+ p: 3,
820
+ backgroundColor: 'canvas.subtle',
821
+ display: 'flex',
822
+ flexDirection: 'column',
823
+ gap: 3,
824
+ }, children: [_jsx(Text, { sx: { fontSize: 2, fontWeight: 'bold' }, children: "Scenes" }), _jsx(SegmentedControl, { "aria-label": "A2UI gallery scene picker", fullWidth: true, children: SCENES.map(scene => (_jsx(SegmentedControl.Button, { selected: scene.id === selectedScene, onClick: () => setSelectedScene(scene.id), children: scene.label }, scene.id))) }), _jsx(Text, { sx: { color: 'fg.muted', fontSize: 1 }, children: currentScene.description }), _jsxs(Box, { sx: { display: 'flex', gap: 2, flexWrap: 'wrap' }, children: [_jsx(Button, { size: "small", variant: "primary", onClick: () => showScene(currentScene), children: "Reload" }), _jsx(Button, { size: "small", variant: "default", onClick: showAllScenes, children: "Show All" }), _jsx(Button, { size: "small", variant: "invisible", onClick: resetSurfaces, children: "Clear" }), _jsx(Button, { size: "small", variant: "default", onClick: () => void sendSupportPayload({
825
+ query: 'Production deploy is failing with auth errors. Help me triage.',
826
+ }), disabled: backendLoading, children: backendLoading
827
+ ? 'Loading Python Backend…'
828
+ : 'Load Python Backend Agent' })] }), _jsxs(Text, { sx: { color: 'fg.muted', fontSize: 1 }, children: ["Python endpoint status: ", backendHealth] }), backendSummary && (_jsx(Text, { sx: { color: 'fg.muted', fontSize: 1 }, children: backendSummary })), backendError && (_jsx(Text, { sx: { color: 'danger.fg', fontSize: 1 }, children: backendError }))] }), _jsx(Box, { style: themeStyle, sx: {
829
+ ...A2UI_RENDER_SCOPE_SX,
830
+ width: '100%',
831
+ minWidth: 0,
832
+ display: 'flex',
833
+ flexDirection: 'column',
834
+ gap: 4,
835
+ }, children: surfaces.map(surface => (_jsx(Box, { sx: { width: '100%' }, children: _jsx(A2uiSurfaceComposed, { surface: surface }) }, surface.id))) })] }));
836
+ }
837
+ const A2UiComponentsGalleryExample = () => {
838
+ const [lastAction, setLastAction] = useState(null);
839
+ const handleAction = useCallback((action) => {
840
+ console.warn('A2UI Gallery Action:', action);
841
+ setLastAction(action);
842
+ }, []);
843
+ return (_jsx(ThemedProvider, { children: _jsx(A2uiMarkdownProvider, { children: _jsxs(Box, { sx: { minHeight: '100vh', display: 'flex', flexDirection: 'column' }, children: [_jsxs(Box, { sx: {
844
+ px: 3,
845
+ py: 3,
846
+ borderBottom: '1px solid',
847
+ borderColor: 'border.default',
848
+ backgroundColor: 'canvas.subtle',
849
+ }, children: [_jsx(Text, { as: "h1", sx: { fontSize: 3, fontWeight: 'bold' }, children: "\uD83C\uDFA8 A2UI Components Gallery" }), _jsx(Text, { sx: { color: 'fg.muted' }, children: "Showcases the A2UI basic catalog rendered live via MessageProcessor and A2uiSurface." })] }), _jsx(GalleryContent, { onAction: handleAction }), _jsx(Box, { sx: {
850
+ borderTop: '1px solid',
851
+ borderColor: 'border.default',
852
+ p: 3,
853
+ fontFamily: 'mono',
854
+ fontSize: 0,
855
+ backgroundColor: 'canvas.subtle',
856
+ whiteSpace: 'pre-wrap',
857
+ maxHeight: 220,
858
+ overflow: 'auto',
859
+ }, children: lastAction
860
+ ? JSON.stringify(lastAction, null, 2)
861
+ : 'No action triggered yet.' })] }) }) }));
862
+ };
863
+ export default A2UiComponentsGalleryExample;