@datalayer/agent-runtimes 1.0.29 → 1.3.11

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 (779) hide show
  1. package/lib/AgentDocument.js +5 -22
  2. package/lib/AgentNode.d.ts +1 -1
  3. package/lib/AgentNode.js +193 -23
  4. package/lib/AgentNotebook.js +1 -1
  5. package/lib/App.d.ts +1 -1
  6. package/lib/AppExamples2.d.ts +1 -1
  7. package/lib/agent-node/AgentNodeGallery.d.ts +14 -1
  8. package/lib/agent-node/AgentNodeGallery.js +19 -15
  9. package/lib/agent-node/themeStore.js +7 -6
  10. package/lib/agents/AgentDetails.d.ts +8 -2
  11. package/lib/agents/AgentDetails.js +41 -11
  12. package/lib/agents/AgentRuntimeChat.d.ts +3 -3
  13. package/lib/agents/AgentRuntimeChat.js +15 -15
  14. package/lib/api/agents.d.ts +10 -10
  15. package/lib/api/agents.js +15 -15
  16. package/lib/api/checkpoints.d.ts +40 -0
  17. package/lib/api/checkpoints.js +75 -0
  18. package/lib/api/index.d.ts +1 -0
  19. package/lib/api/index.js +2 -1
  20. package/lib/api/notifications.d.ts +21 -6
  21. package/lib/api/notifications.js +32 -14
  22. package/lib/api/runtimes/environments.d.ts +406 -4
  23. package/lib/api/runtimes/environments.js +641 -9
  24. package/lib/api/runtimes/runtimes.d.ts +19 -19
  25. package/lib/api/runtimes/runtimes.js +47 -46
  26. package/lib/api/spacer/notebooks.js +1 -1
  27. package/lib/chat/Chat.d.ts +16 -4
  28. package/lib/chat/Chat.js +18 -5
  29. package/lib/chat/ChatFloating.d.ts +20 -2
  30. package/lib/chat/ChatFloating.js +196 -118
  31. package/lib/chat/ChatInline.d.ts +15 -0
  32. package/lib/chat/ChatInline.js +0 -18
  33. package/lib/chat/ChatPopupStandalone.d.ts +1 -1
  34. package/lib/chat/ChatSidebar.d.ts +14 -2
  35. package/lib/chat/ChatSidebar.js +1 -1
  36. package/lib/chat/ChatStandalone.d.ts +1 -1
  37. package/lib/chat/EphemeralSurfaceControl.d.ts +30 -0
  38. package/lib/chat/EphemeralSurfaceControl.js +55 -0
  39. package/lib/chat/base/ChatAvailability.d.ts +34 -0
  40. package/lib/chat/base/ChatAvailability.js +18 -0
  41. package/lib/chat/base/ChatBase.d.ts +2 -1
  42. package/lib/chat/base/ChatBase.js +657 -28
  43. package/lib/chat/display/ButtonGlow.d.ts +9 -0
  44. package/lib/chat/display/ButtonGlow.js +60 -0
  45. package/lib/chat/display/EmptyState.d.ts +15 -1
  46. package/lib/chat/display/EmptyState.js +81 -12
  47. package/lib/chat/display/FloatingBrandButton.d.ts +1 -1
  48. package/lib/chat/display/PoweredByTag.d.ts +1 -1
  49. package/lib/chat/display/groupSuggestions.d.ts +21 -0
  50. package/lib/chat/display/groupSuggestions.js +18 -0
  51. package/lib/chat/document/EphemeralDocument.d.ts +70 -6
  52. package/lib/chat/document/EphemeralDocument.js +154 -52
  53. package/lib/chat/header/ChatHeader.d.ts +1 -1
  54. package/lib/chat/header/ChatHeaderBase.d.ts +10 -1
  55. package/lib/chat/header/ChatHeaderBase.js +21 -102
  56. package/lib/chat/header/ChatViewModeToggle.d.ts +29 -0
  57. package/lib/chat/header/ChatViewModeToggle.js +55 -0
  58. package/lib/chat/index.d.ts +5 -1
  59. package/lib/chat/index.js +9 -1
  60. package/lib/chat/indicators/McpStatusIndicator.d.ts +1 -1
  61. package/lib/chat/indicators/SandboxStatusIndicator.d.ts +1 -1
  62. package/lib/chat/indicators/SandboxStatusIndicator.js +1 -1
  63. package/lib/chat/indicators/SkillsStatusIndicator.d.ts +1 -1
  64. package/lib/chat/messages/ChatMessageList.d.ts +22 -1
  65. package/lib/chat/messages/ChatMessageList.js +370 -166
  66. package/lib/chat/messages/ChatMessages.d.ts +1 -1
  67. package/lib/chat/messages/NotebookToolSurfaces.d.ts +68 -0
  68. package/lib/chat/messages/NotebookToolSurfaces.js +302 -0
  69. package/lib/chat/messages/TurnFooter.d.ts +42 -0
  70. package/lib/chat/messages/TurnFooter.js +75 -0
  71. package/lib/chat/messages/assistantMarkdown.d.ts +22 -0
  72. package/lib/chat/messages/assistantMarkdown.js +56 -0
  73. package/lib/chat/notebook/EphemeralNotebook.d.ts +67 -6
  74. package/lib/chat/notebook/EphemeralNotebook.js +194 -61
  75. package/lib/chat/parts/DynamicToolPart.d.ts +1 -1
  76. package/lib/chat/parts/MessagePart.d.ts +1 -1
  77. package/lib/chat/parts/ReasoningPart.d.ts +8 -1
  78. package/lib/chat/parts/TextPart.d.ts +1 -1
  79. package/lib/chat/parts/ToolPart.d.ts +8 -1
  80. package/lib/chat/prompt/FloatingCard.d.ts +26 -0
  81. package/lib/chat/prompt/FloatingCard.js +80 -0
  82. package/lib/chat/prompt/InputPrompt.d.ts +206 -53
  83. package/lib/chat/prompt/InputPrompt.js +161 -80
  84. package/lib/chat/prompt/InputPromptBase.d.ts +112 -0
  85. package/lib/chat/prompt/InputPromptBase.js +225 -0
  86. package/lib/chat/prompt/InputPromptLexical.d.ts +18 -1
  87. package/lib/chat/prompt/InputPromptLexical.js +227 -30
  88. package/lib/chat/prompt/InputPromptText.d.ts +10 -2
  89. package/lib/chat/prompt/InputPromptText.js +35 -3
  90. package/lib/chat/prompt/footer/BelowPromptFooter.d.ts +25 -0
  91. package/lib/chat/prompt/footer/BelowPromptFooter.js +12 -0
  92. package/lib/chat/prompt/footer/InPromptFooter.d.ts +35 -0
  93. package/lib/chat/prompt/footer/InPromptFooter.js +16 -0
  94. package/lib/chat/prompt/footer/index.d.ts +7 -0
  95. package/lib/chat/prompt/footer/index.js +11 -0
  96. package/lib/chat/prompt/header/BelowPromptHeader.d.ts +23 -0
  97. package/lib/chat/prompt/header/BelowPromptHeader.js +12 -0
  98. package/lib/chat/prompt/header/InPromptHeader.d.ts +31 -0
  99. package/lib/chat/prompt/header/InPromptHeader.js +14 -0
  100. package/lib/chat/prompt/header/index.d.ts +7 -0
  101. package/lib/chat/prompt/header/index.js +11 -0
  102. package/lib/chat/prompt/index.d.ts +8 -4
  103. package/lib/chat/prompt/index.js +15 -3
  104. package/lib/chat/prompt/menus/AgentsMenu.d.ts +14 -0
  105. package/lib/chat/prompt/menus/AgentsMenu.js +42 -0
  106. package/lib/chat/prompt/menus/InlineAgentsMenu.d.ts +22 -0
  107. package/lib/chat/prompt/menus/InlineAgentsMenu.js +24 -0
  108. package/lib/chat/prompt/menus/ModelSelector.d.ts +7 -0
  109. package/lib/chat/prompt/menus/ModelSelector.js +27 -0
  110. package/lib/chat/prompt/menus/SkillsMenu.d.ts +10 -0
  111. package/lib/chat/prompt/menus/SkillsMenu.js +75 -0
  112. package/lib/chat/prompt/menus/SuggestionsMenu.d.ts +13 -0
  113. package/lib/chat/prompt/menus/SuggestionsMenu.js +31 -0
  114. package/lib/chat/prompt/menus/ToolsMenu.d.ts +13 -0
  115. package/lib/chat/prompt/menus/ToolsMenu.js +103 -0
  116. package/lib/chat/prompt/menus/index.d.ts +15 -0
  117. package/lib/chat/prompt/menus/index.js +19 -0
  118. package/lib/chat/prompt/plugins/AgentMentionPlugin.d.ts +54 -0
  119. package/lib/chat/prompt/plugins/AgentMentionPlugin.js +370 -0
  120. package/lib/chat/prompt/plugins/CommandPlugin.d.ts +52 -0
  121. package/lib/chat/prompt/plugins/CommandPlugin.js +359 -0
  122. package/lib/chat/prompt/plugins/MentionChip.d.ts +15 -0
  123. package/lib/chat/prompt/plugins/MentionChip.js +24 -0
  124. package/lib/chat/prompt/plugins/MentionNode.d.ts +66 -0
  125. package/lib/chat/prompt/plugins/MentionNode.js +77 -0
  126. package/lib/chat/prompt/promptHistory.d.ts +52 -0
  127. package/lib/chat/prompt/promptHistory.js +123 -0
  128. package/lib/chat/prompt/stack.d.ts +81 -0
  129. package/lib/chat/prompt/stack.js +41 -0
  130. package/lib/chat/prompt/useTypingPlaceholder.d.ts +52 -0
  131. package/lib/chat/prompt/useTypingPlaceholder.js +180 -0
  132. package/lib/chat/tools/A2AAgentDialog.d.ts +60 -0
  133. package/lib/chat/tools/A2AAgentDialog.js +265 -0
  134. package/lib/chat/tools/ToolApprovalBanner.d.ts +1 -1
  135. package/lib/chat/tools/ToolApprovalDialog.d.ts +1 -1
  136. package/lib/chat/tools/ToolCallDisplay.d.ts +8 -1
  137. package/lib/chat/tools/index.d.ts +1 -0
  138. package/lib/chat/tools/index.js +1 -0
  139. package/lib/chat/usage/ContextPie.d.ts +17 -0
  140. package/lib/chat/usage/{TokenUsageBar.js → ContextPie.js} +20 -14
  141. package/lib/chat/useViewportDrag.d.ts +11 -0
  142. package/lib/chat/useViewportDrag.js +61 -0
  143. package/lib/chat/viewModes.d.ts +51 -0
  144. package/lib/chat/viewModes.js +57 -0
  145. package/lib/client/AgentRuntimesClient.d.ts +10 -9
  146. package/lib/client/AgentRuntimesClient.js +1 -1
  147. package/lib/client/AgentRuntimesClientContext.d.ts +1 -0
  148. package/lib/client/AgentsMixin.d.ts +12 -12
  149. package/lib/client/AgentsMixin.js +31 -31
  150. package/lib/client/IAgentRuntimesClient.d.ts +10 -10
  151. package/lib/client/SdkAgentRuntimesClient.d.ts +10 -10
  152. package/lib/client/SdkAgentRuntimesClient.js +10 -10
  153. package/lib/client/mixins/RuntimesMixin.d.ts +37 -10
  154. package/lib/client/mixins/RuntimesMixin.js +54 -21
  155. package/lib/components/a2ui/A2uiSurfaceComposed.d.ts +1 -1
  156. package/lib/components/agents/AgentSummary.d.ts +13 -0
  157. package/lib/components/agents/AgentSummary.js +21 -4
  158. package/lib/components/cards/NotificationEventCard.d.ts +1 -1
  159. package/lib/components/cards/OutputCard.d.ts +1 -1
  160. package/lib/components/cards/ToolApprovalCard.d.ts +2 -2
  161. package/lib/components/cards/ToolApprovalCard.js +1 -0
  162. package/lib/components/code-sandboxes/CodeSandboxCellVariables.d.ts +1 -0
  163. package/lib/components/code-sandboxes/CodeSandboxCellVariables.js +0 -4
  164. package/lib/components/code-sandboxes/CodeSandboxCellVariablesDialog.d.ts +1 -0
  165. package/lib/components/code-sandboxes/CodeSandboxCellVariablesDialog.js +0 -4
  166. package/lib/components/code-sandboxes/CodeSandboxEnvironmentSelect.d.ts +35 -0
  167. package/lib/components/code-sandboxes/CodeSandboxEnvironmentSelect.js +27 -29
  168. package/lib/components/code-sandboxes/CodeSandboxLauncher.d.ts +9 -0
  169. package/lib/components/code-sandboxes/CodeSandboxLauncher.js +95 -23
  170. package/lib/components/code-sandboxes/CodeSandboxNames.js +7 -6
  171. package/lib/components/code-sandboxes/CodeSandboxPicker.js +89 -42
  172. package/lib/components/code-sandboxes/CodeSandboxPickerCell.d.ts +1 -0
  173. package/lib/components/code-sandboxes/CodeSandboxPickerCell.js +0 -4
  174. package/lib/components/code-sandboxes/CodeSandboxReservationControl.d.ts +1 -0
  175. package/lib/components/code-sandboxes/CodeSandboxReservationControl.js +5 -7
  176. package/lib/components/code-sandboxes/CodeSandboxTransfer.d.ts +5 -0
  177. package/lib/components/code-sandboxes/CodeSandboxUtils.d.ts +13 -1
  178. package/lib/components/code-sandboxes/CodeSandboxUtils.js +10 -4
  179. package/lib/components/code-sandboxes/NewCodeSandboxControls.d.ts +21 -15
  180. package/lib/components/code-sandboxes/NewCodeSandboxControls.js +28 -51
  181. package/lib/components/code-sandboxes/codeSandboxAllowance.d.ts +33 -0
  182. package/lib/components/code-sandboxes/codeSandboxAllowance.js +37 -0
  183. package/lib/components/code-sandboxes/codeSandboxEnvironments.d.ts +97 -0
  184. package/lib/components/code-sandboxes/codeSandboxEnvironments.js +184 -0
  185. package/lib/components/code-sandboxes/codeSandboxProviders.js +14 -5
  186. package/lib/components/code-sandboxes/index.d.ts +1 -0
  187. package/lib/components/code-sandboxes/index.js +1 -0
  188. package/lib/components/context/SpaceSelect.d.ts +1 -1
  189. package/lib/components/flashes/FlashDisclaimer.d.ts +1 -1
  190. package/lib/components/icons/ArtifactIcon.d.ts +1 -0
  191. package/lib/components/icons/ArtifactIcon.js +2 -1
  192. package/lib/components/nbgrader/NbGradesDetails.d.ts +1 -1
  193. package/lib/components/progress/CreditsIndicator.d.ts +1 -0
  194. package/lib/components/progress/CreditsIndicator.js +0 -4
  195. package/lib/components/scheduler/ScheduleMenu.d.ts +1 -1
  196. package/lib/components/snapshots/SandboxSnapshotMenu.d.ts +3 -2
  197. package/lib/components/snapshots/SandboxSnapshotMenu.js +11 -15
  198. package/lib/components/snippets/SnippetDialog.d.ts +1 -0
  199. package/lib/components/snippets/SnippetDialog.js +0 -4
  200. package/lib/components/specs/SpecPayloadPreview.d.ts +34 -0
  201. package/lib/components/specs/SpecPayloadPreview.js +102 -0
  202. package/lib/components/tokens/SpaceVariantToken.d.ts +1 -1
  203. package/lib/context/ContextDistribution.d.ts +1 -1
  204. package/lib/context/ContextInspector.d.ts +2 -1
  205. package/lib/context/ContextPanel.d.ts +1 -1
  206. package/lib/context/ContextUsage.d.ts +1 -1
  207. package/lib/context/CostTracker.d.ts +1 -1
  208. package/lib/context/CostUsageChart.d.ts +1 -1
  209. package/lib/context/CostUsageChart.js +4 -4
  210. package/lib/context/MessageHistory.d.ts +3 -2
  211. package/lib/context/TokenUsageChart.d.ts +1 -1
  212. package/lib/context/TokenUsageChart.js +4 -4
  213. package/lib/examples/A2UiAgentExample.js +15 -6
  214. package/lib/examples/A2UiComponentsGalleryExample.d.ts +10 -0
  215. package/lib/examples/A2UiComponentsGalleryExample.js +24 -855
  216. package/lib/examples/A2UiContactCardExample.d.ts +10 -0
  217. package/lib/examples/A2UiContactCardExample.js +23 -170
  218. package/lib/examples/A2UiJupyterOutputExample.d.ts +3 -0
  219. package/lib/examples/A2UiJupyterOutputExample.js +792 -0
  220. package/lib/examples/A2UiRestaurantExample.d.ts +10 -0
  221. package/lib/examples/A2UiRestaurantExample.js +24 -179
  222. package/lib/examples/A2UiViewerExample.d.ts +10 -0
  223. package/lib/examples/A2UiViewerExample.js +24 -378
  224. package/lib/examples/AgUiAgenticExample.js +2 -4
  225. package/lib/examples/AgUiBackendToolRenderingExample.js +3 -5
  226. package/lib/examples/AgUiHaikuGenUiExample.js +2 -4
  227. package/lib/examples/AgUiHumanInTheLoopExample.js +2 -4
  228. package/lib/examples/AgUiSharedStateExample.js +2 -4
  229. package/lib/examples/AgUiToolsBasedGenUiExample.js +2 -4
  230. package/lib/examples/AgentA2AExample.d.ts +17 -0
  231. package/lib/examples/AgentA2AExample.js +56 -0
  232. package/lib/examples/AgentCheckpointsExample.d.ts +9 -10
  233. package/lib/examples/AgentCheckpointsExample.js +72 -54
  234. package/lib/examples/AgentCodeSandboxExample.d.ts +7 -7
  235. package/lib/examples/AgentCodeSandboxExample.js +93 -303
  236. package/lib/examples/AgentCodeSandboxesExample.d.ts +10 -0
  237. package/lib/examples/AgentCodeSandboxesExample.js +56 -162
  238. package/lib/examples/AgentCodemodeExample.d.ts +7 -2
  239. package/lib/examples/AgentCodemodeExample.js +60 -125
  240. package/lib/examples/AgentCompactionExample.js +19 -135
  241. package/lib/examples/AgentEvalsExample.js +34 -66
  242. package/lib/examples/AgentGuardrailsExample.js +64 -112
  243. package/lib/examples/AgentHooksExample.d.ts +11 -0
  244. package/lib/examples/AgentHooksExample.js +30 -67
  245. package/lib/examples/AgentInferenceProviderExample.js +8 -32
  246. package/lib/examples/AgentLoopExample.d.ts +4 -2
  247. package/lib/examples/AgentLoopExample.js +45 -93
  248. package/lib/examples/AgentMCPExample.js +30 -79
  249. package/lib/examples/AgentMemoryExample.js +21 -64
  250. package/lib/examples/AgentMonitoringExample.js +33 -94
  251. package/lib/examples/AgentNotificationsExample.js +56 -95
  252. package/lib/examples/AgentOtelExample.js +35 -88
  253. package/lib/examples/AgentOutputsExample.d.ts +2 -1
  254. package/lib/examples/AgentOutputsExample.js +16 -137
  255. package/lib/examples/AgentParametersExample.js +7 -17
  256. package/lib/examples/AgentSkillsExample.js +40 -154
  257. package/lib/examples/AgentSubagentsExample.d.ts +7 -6
  258. package/lib/examples/AgentSubagentsExample.js +80 -191
  259. package/lib/examples/AgentToolApprovalsExample.js +35 -91
  260. package/lib/examples/AgentTriggersExample.js +43 -59
  261. package/lib/examples/AgentspecsExample.js +4 -4
  262. package/lib/examples/CellExample.d.ts +1 -1
  263. package/lib/examples/ChatExample.d.ts +12 -5
  264. package/lib/examples/ChatExample.js +38 -13
  265. package/lib/examples/CopilotKitLexicalExample.d.ts +1 -0
  266. package/lib/examples/CopilotKitLexicalExample.js +4 -41
  267. package/lib/examples/CopilotKitNotebookExample.d.ts +10 -0
  268. package/lib/examples/CopilotKitNotebookExample.js +2 -14
  269. package/lib/examples/DecksAgent.d.ts +21 -0
  270. package/lib/examples/DecksAgent.js +23 -0
  271. package/lib/examples/DocumentPageAgent.d.ts +19 -0
  272. package/lib/examples/DocumentPageAgent.js +15 -0
  273. package/lib/examples/Lexical2Example.d.ts +2 -2
  274. package/lib/examples/Lexical2Example.js +17 -38
  275. package/lib/examples/LexicalAgentExample.d.ts +2 -1
  276. package/lib/examples/LexicalAgentExample.js +29 -102
  277. package/lib/examples/LexicalAgentSidebarExample.d.ts +16 -5
  278. package/lib/examples/LexicalAgentSidebarExample.js +99 -131
  279. package/lib/examples/LoopShellExample.d.ts +38 -0
  280. package/lib/examples/LoopShellExample.js +68 -0
  281. package/lib/examples/LoopWorkspaceEmbed.d.ts +50 -0
  282. package/lib/examples/LoopWorkspaceEmbed.js +73 -0
  283. package/lib/examples/LoopWorkspaceExample.d.ts +150 -0
  284. package/lib/examples/LoopWorkspaceExample.js +151 -0
  285. package/lib/examples/NotebookAgentExample.d.ts +13 -0
  286. package/lib/examples/NotebookAgentExample.js +36 -86
  287. package/lib/examples/NotebookAgentSidebarExample.d.ts +10 -4
  288. package/lib/examples/NotebookAgentSidebarExample.js +39 -83
  289. package/lib/examples/NotebookCollaborationExample.d.ts +1 -1
  290. package/lib/examples/NotebookCollaborationExample.js +108 -20
  291. package/lib/examples/NotebookExample.d.ts +1 -1
  292. package/lib/examples/NotebookExample.js +20 -10
  293. package/lib/examples/NotebookPageAgent.d.ts +23 -0
  294. package/lib/examples/NotebookPageAgent.js +17 -0
  295. package/lib/examples/components/ExampleWrapper.d.ts +5 -0
  296. package/lib/examples/components/ExampleWrapper.js +36 -28
  297. package/lib/examples/components/LexicalEditor.d.ts +1 -1
  298. package/lib/examples/components/LexicalEditor.js +4 -24
  299. package/lib/examples/components/haiku/HaikuDisplay.d.ts +1 -1
  300. package/lib/examples/components/haiku/InlineHaikuCard.d.ts +1 -1
  301. package/lib/examples/components/weather/InlineWeatherCard.d.ts +1 -1
  302. package/lib/examples/example-selector.js +26 -6
  303. package/lib/examples/hooks/useCreateAgentOnce.d.ts +41 -0
  304. package/lib/examples/hooks/useCreateAgentOnce.js +51 -0
  305. package/lib/examples/hooks/useExampleAgentProtocol.d.ts +35 -0
  306. package/lib/examples/hooks/useExampleAgentProtocol.js +63 -0
  307. package/lib/examples/hooks/useExampleAgentRuntime.d.ts +16 -16
  308. package/lib/examples/hooks/useExampleAgentRuntime.js +26 -25
  309. package/lib/examples/hooks/useExampleAgentRuntimes.js +45 -61
  310. package/lib/examples/hooks/useExampleJupyterAgent.d.ts +91 -0
  311. package/lib/examples/hooks/useExampleJupyterAgent.js +151 -0
  312. package/lib/examples/index.d.ts +4 -0
  313. package/lib/examples/index.js +6 -0
  314. package/lib/examples/lexical/editorConfig.d.ts +2 -75
  315. package/lib/examples/lexical/editorConfig.js +26 -48
  316. package/lib/examples/lexical/lexical-theme.css +65 -47
  317. package/lib/examples/main.js +450 -322
  318. package/lib/examples/scenes/A2UiComponentsGalleryScene.d.ts +3 -0
  319. package/lib/examples/scenes/A2UiComponentsGalleryScene.js +872 -0
  320. package/lib/examples/scenes/A2UiContactCardScene.d.ts +3 -0
  321. package/lib/examples/scenes/A2UiContactCardScene.js +188 -0
  322. package/lib/examples/scenes/A2UiRestaurantScene.d.ts +3 -0
  323. package/lib/examples/scenes/A2UiRestaurantScene.js +196 -0
  324. package/lib/examples/scenes/A2UiViewerScene.d.ts +3 -0
  325. package/lib/examples/scenes/A2UiViewerScene.js +395 -0
  326. package/lib/examples/utils/agentSummaryStore.d.ts +7 -1
  327. package/lib/examples/utils/agents/earthquake-detector.ipynb.json +1 -1
  328. package/lib/examples/utils/agents/earthquake-detector.lexical.json +1 -1
  329. package/lib/examples/utils/agents/sales-forecaster.ipynb.json +1 -1
  330. package/lib/examples/utils/agents/sales-forecaster.lexical.json +1 -1
  331. package/lib/examples/utils/agents/social-post-generator.ipynb.json +1 -1
  332. package/lib/examples/utils/agents/social-post-generator.lexical.json +1 -1
  333. package/lib/examples/utils/exampleSurfaces.d.ts +31 -0
  334. package/lib/examples/utils/exampleSurfaces.js +38 -0
  335. package/lib/examples/utils/jupyterSandboxUrl.d.ts +27 -0
  336. package/lib/examples/utils/jupyterSandboxUrl.js +55 -0
  337. package/lib/examples/utils/localUrl.d.ts +2 -0
  338. package/lib/examples/utils/localUrl.js +49 -0
  339. package/lib/examples/utils/notebookToolbarItems.d.ts +46 -0
  340. package/lib/examples/utils/notebookToolbarItems.js +129 -0
  341. package/lib/examples/utils/runtimeTargetStore.d.ts +40 -1
  342. package/lib/examples/utils/runtimeTargetStore.js +82 -1
  343. package/lib/examples/utils/themedProvider.d.ts +7 -0
  344. package/lib/examples/utils/themedProvider.js +57 -4
  345. package/lib/examples/utils/useExampleAgentRuntimesUrl.js +30 -5
  346. package/lib/examples/utils/waitForAgent.d.ts +23 -0
  347. package/lib/examples/utils/waitForAgent.js +24 -0
  348. package/lib/examples2/CellExample.d.ts +1 -1
  349. package/lib/examples2/DatalayerNotebookExample.d.ts +1 -1
  350. package/lib/examples2/NotebookExample.d.ts +1 -1
  351. package/lib/examples2/NotebookMutationsKernel.d.ts +1 -1
  352. package/lib/examples2/NotebookMutationsServiceManager.d.ts +1 -1
  353. package/lib/examples2/main.js +24 -4
  354. package/lib/extensions/A2UIExtension.d.ts +1 -1
  355. package/lib/hooks/index.d.ts +8 -5
  356. package/lib/hooks/index.js +20 -5
  357. package/lib/hooks/useAgentRuntimes.d.ts +49 -22
  358. package/lib/hooks/useAgentRuntimes.js +214 -90
  359. package/lib/hooks/useAgentsCatalog.js +32 -4
  360. package/lib/hooks/useBrowserAgent.d.ts +26 -0
  361. package/lib/hooks/useBrowserAgent.js +75 -0
  362. package/lib/hooks/useBrowserInference.d.ts +27 -0
  363. package/lib/hooks/useBrowserInference.js +67 -0
  364. package/lib/hooks/useCheckpoints.d.ts +8 -17
  365. package/lib/hooks/useCheckpoints.js +25 -59
  366. package/lib/hooks/useConfig.d.ts +1 -1
  367. package/lib/hooks/useConfig.js +5 -1
  368. package/lib/hooks/useContextSnapshot.d.ts +18 -7
  369. package/lib/hooks/useContextSnapshot.js +14 -10
  370. package/lib/hooks/useNotifications.d.ts +11 -11
  371. package/lib/hooks/useNotifications.js +1 -1
  372. package/lib/hooks/useProjects.d.ts +7 -19
  373. package/lib/hooks/useProjects.js +5 -5
  374. package/lib/hooks/useSkills.d.ts +0 -1
  375. package/lib/hooks/useSkills.js +6 -2
  376. package/lib/hooks/useToolApprovals.d.ts +8 -8
  377. package/lib/hooks/useToolApprovals.js +3 -3
  378. package/lib/identity/AgentIdentity.d.ts +9 -2
  379. package/lib/index.d.ts +1 -0
  380. package/lib/index.js +4 -0
  381. package/lib/jupyter/index.d.ts +2 -1
  382. package/lib/jupyter/index.js +2 -1
  383. package/lib/jupyter/serverExecution.d.ts +78 -0
  384. package/lib/jupyter/serverExecution.js +258 -0
  385. package/lib/jupyter/useResumeServerExecutions.d.ts +11 -0
  386. package/lib/jupyter/useResumeServerExecutions.js +64 -0
  387. package/lib/lexical/ChatInlinePlugin.d.ts +33 -0
  388. package/lib/lexical/ChatInlinePlugin.js +0 -36
  389. package/lib/loop/core/focusRequests.d.ts +10 -0
  390. package/lib/loop/core/focusRequests.js +46 -0
  391. package/lib/loop/core/index.d.ts +903 -0
  392. package/lib/loop/core/index.js +264 -0
  393. package/lib/loop/core/promptStore.d.ts +44 -0
  394. package/lib/loop/core/promptStore.js +63 -0
  395. package/lib/loop/core/surfaceRequests.d.ts +33 -0
  396. package/lib/loop/core/surfaceRequests.js +29 -0
  397. package/lib/loop/core/toolbar.d.ts +28 -0
  398. package/lib/loop/core/toolbar.js +59 -0
  399. package/lib/loop/embed/LoopEmbed.d.ts +57 -0
  400. package/lib/loop/embed/LoopEmbed.js +124 -0
  401. package/lib/loop/extensions.d.ts +10 -0
  402. package/lib/loop/extensions.js +49 -0
  403. package/lib/loop/index.d.ts +68 -0
  404. package/lib/loop/index.js +87 -0
  405. package/lib/loop/plugins/a2a-sidebar/A2ASidebar.d.ts +48 -0
  406. package/lib/loop/plugins/a2a-sidebar/A2ASidebar.js +190 -0
  407. package/lib/loop/plugins/a2a-sidebar/index.d.ts +5 -0
  408. package/lib/loop/plugins/a2a-sidebar/index.js +39 -0
  409. package/lib/loop/plugins/a2ui/A2uiView.d.ts +12 -0
  410. package/lib/loop/plugins/a2ui/A2uiView.js +97 -0
  411. package/lib/loop/plugins/a2ui/index.d.ts +3 -0
  412. package/lib/loop/plugins/a2ui/index.js +50 -0
  413. package/lib/loop/plugins/a2ui-scene/index.d.ts +36 -0
  414. package/lib/loop/plugins/a2ui-scene/index.js +28 -0
  415. package/lib/loop/plugins/agent-a2a/index.d.ts +3 -0
  416. package/lib/loop/plugins/agent-a2a/index.js +26 -0
  417. package/lib/loop/plugins/agent-a2ui/index.d.ts +3 -0
  418. package/lib/loop/plugins/agent-a2ui/index.js +42 -0
  419. package/lib/loop/plugins/agent-a2ui-jupyter-output/index.d.ts +3 -0
  420. package/lib/loop/plugins/agent-a2ui-jupyter-output/index.js +53 -0
  421. package/lib/loop/plugins/agent-capacity/index.d.ts +39 -0
  422. package/lib/loop/plugins/agent-capacity/index.js +52 -0
  423. package/lib/loop/plugins/agent-checkpoints/index.d.ts +3 -0
  424. package/lib/loop/plugins/agent-checkpoints/index.js +26 -0
  425. package/lib/loop/plugins/agent-code-sandbox/index.d.ts +3 -0
  426. package/lib/loop/plugins/agent-code-sandbox/index.js +24 -0
  427. package/lib/loop/plugins/agent-code-sandboxes/index.d.ts +13 -0
  428. package/lib/loop/plugins/agent-code-sandboxes/index.js +85 -0
  429. package/lib/loop/plugins/agent-codemode/index.d.ts +5 -0
  430. package/lib/loop/plugins/agent-codemode/index.js +41 -0
  431. package/lib/loop/plugins/agent-compaction/index.d.ts +10 -0
  432. package/lib/loop/plugins/agent-compaction/index.js +34 -0
  433. package/lib/loop/plugins/agent-evals/index.d.ts +3 -0
  434. package/lib/loop/plugins/agent-evals/index.js +25 -0
  435. package/lib/loop/plugins/agent-guardrails/index.d.ts +3 -0
  436. package/lib/loop/plugins/agent-guardrails/index.js +25 -0
  437. package/lib/loop/plugins/agent-hooks/index.d.ts +3 -0
  438. package/lib/loop/plugins/agent-hooks/index.js +28 -0
  439. package/lib/loop/plugins/agent-inference/index.d.ts +7 -0
  440. package/lib/loop/plugins/agent-inference/index.js +29 -0
  441. package/lib/loop/plugins/agent-mcp/index.d.ts +3 -0
  442. package/lib/loop/plugins/agent-mcp/index.js +25 -0
  443. package/lib/loop/plugins/agent-memory/index.d.ts +3 -0
  444. package/lib/loop/plugins/agent-memory/index.js +25 -0
  445. package/lib/loop/plugins/agent-monitoring/index.d.ts +3 -0
  446. package/lib/loop/plugins/agent-monitoring/index.js +25 -0
  447. package/lib/loop/plugins/agent-notifications/index.d.ts +3 -0
  448. package/lib/loop/plugins/agent-notifications/index.js +25 -0
  449. package/lib/loop/plugins/agent-otel/index.d.ts +3 -0
  450. package/lib/loop/plugins/agent-otel/index.js +25 -0
  451. package/lib/loop/plugins/agent-outputs/index.d.ts +3 -0
  452. package/lib/loop/plugins/agent-outputs/index.js +25 -0
  453. package/lib/loop/plugins/agent-parameters/index.d.ts +3 -0
  454. package/lib/loop/plugins/agent-parameters/index.js +25 -0
  455. package/lib/loop/plugins/agent-skills/index.d.ts +3 -0
  456. package/lib/loop/plugins/agent-skills/index.js +25 -0
  457. package/lib/loop/plugins/agent-subagents/index.d.ts +3 -0
  458. package/lib/loop/plugins/agent-subagents/index.js +25 -0
  459. package/lib/loop/plugins/agent-tool-approvals/index.d.ts +11 -0
  460. package/lib/loop/plugins/agent-tool-approvals/index.js +38 -0
  461. package/lib/loop/plugins/agent-triggers/index.d.ts +3 -0
  462. package/lib/loop/plugins/agent-triggers/index.js +26 -0
  463. package/lib/loop/plugins/agents/AgentSummaryPanel.d.ts +20 -0
  464. package/lib/loop/plugins/agents/AgentSummaryPanel.js +50 -0
  465. package/lib/loop/plugins/agents/AnonymousKeyBadge.d.ts +35 -0
  466. package/lib/loop/plugins/agents/AnonymousKeyBadge.js +53 -0
  467. package/lib/loop/plugins/agents/DatalayerAgentBridge.d.ts +24 -0
  468. package/lib/loop/plugins/agents/DatalayerAgentBridge.js +102 -0
  469. package/lib/loop/plugins/agents/DatalayerAgentMount.d.ts +18 -0
  470. package/lib/loop/plugins/agents/DatalayerAgentMount.js +12 -0
  471. package/lib/loop/plugins/agents/SandboxSelector.d.ts +18 -0
  472. package/lib/loop/plugins/agents/SandboxSelector.js +99 -0
  473. package/lib/loop/plugins/agents/SandboxStatusBridge.d.ts +19 -0
  474. package/lib/loop/plugins/agents/SandboxStatusBridge.js +23 -0
  475. package/lib/loop/plugins/agents/SandboxView.d.ts +11 -0
  476. package/lib/loop/plugins/agents/SandboxView.js +43 -0
  477. package/lib/loop/plugins/agents/TeamMemberPicker.d.ts +17 -0
  478. package/lib/loop/plugins/agents/TeamMemberPicker.js +60 -0
  479. package/lib/loop/plugins/agents/agentIcons.d.ts +23 -0
  480. package/lib/loop/plugins/agents/agentIcons.js +88 -0
  481. package/lib/loop/plugins/agents/browserService.d.ts +50 -0
  482. package/lib/loop/plugins/agents/browserService.js +233 -0
  483. package/lib/loop/plugins/agents/index.d.ts +13 -0
  484. package/lib/loop/plugins/agents/index.js +17 -0
  485. package/lib/loop/plugins/agents/plugin.d.ts +91 -0
  486. package/lib/loop/plugins/agents/plugin.js +201 -0
  487. package/lib/loop/plugins/agents/service.d.ts +99 -0
  488. package/lib/loop/plugins/agents/service.js +167 -0
  489. package/lib/loop/plugins/agents/specSubagents.d.ts +18 -0
  490. package/lib/loop/plugins/agents/specSubagents.js +33 -0
  491. package/lib/loop/plugins/agents/switchable.d.ts +107 -0
  492. package/lib/loop/plugins/agents/switchable.js +405 -0
  493. package/lib/loop/plugins/agents/team.d.ts +87 -0
  494. package/lib/loop/plugins/agents/team.js +143 -0
  495. package/lib/loop/plugins/agents/useSandboxService.d.ts +11 -0
  496. package/lib/loop/plugins/agents/useSandboxService.js +36 -0
  497. package/lib/loop/plugins/agents/useTeamSelection.d.ts +10 -0
  498. package/lib/loop/plugins/agents/useTeamSelection.js +27 -0
  499. package/lib/loop/plugins/agentspecs/AgentspecPicker.d.ts +15 -0
  500. package/lib/loop/plugins/agentspecs/AgentspecPicker.js +90 -0
  501. package/lib/loop/plugins/agentspecs/index.d.ts +6 -0
  502. package/lib/loop/plugins/agentspecs/index.js +63 -0
  503. package/lib/loop/plugins/chat/ChatView.d.ts +20 -0
  504. package/lib/loop/plugins/chat/ChatView.js +1679 -0
  505. package/lib/loop/plugins/chat/chatViewTools.d.ts +41 -0
  506. package/lib/loop/plugins/chat/chatViewTools.js +92 -0
  507. package/lib/loop/plugins/chat/index.d.ts +111 -0
  508. package/lib/loop/plugins/chat/index.js +143 -0
  509. package/lib/loop/plugins/chat/turnState.d.ts +41 -0
  510. package/lib/loop/plugins/chat/turnState.js +90 -0
  511. package/lib/loop/plugins/chat-extras/index.d.ts +14 -0
  512. package/lib/loop/plugins/chat-extras/index.js +51 -0
  513. package/lib/loop/plugins/chat-header/HeaderView.d.ts +13 -0
  514. package/lib/loop/plugins/chat-header/HeaderView.js +6 -0
  515. package/lib/loop/plugins/chat-header/index.d.ts +3 -0
  516. package/lib/loop/plugins/chat-header/index.js +21 -0
  517. package/lib/loop/plugins/chat-view/index.d.ts +10 -0
  518. package/lib/loop/plugins/chat-view/index.js +29 -0
  519. package/lib/loop/plugins/checkpoints-sidebar/CheckpointsSidebar.d.ts +27 -0
  520. package/lib/loop/plugins/checkpoints-sidebar/CheckpointsSidebar.js +174 -0
  521. package/lib/loop/plugins/checkpoints-sidebar/index.d.ts +5 -0
  522. package/lib/loop/plugins/checkpoints-sidebar/index.js +39 -0
  523. package/lib/loop/plugins/commands/index.d.ts +20 -0
  524. package/lib/loop/plugins/commands/index.js +148 -0
  525. package/lib/loop/plugins/decks/DeckSurface.d.ts +10 -0
  526. package/lib/loop/plugins/decks/DeckSurface.js +6 -0
  527. package/lib/loop/plugins/decks/DecksMenu.d.ts +11 -0
  528. package/lib/loop/plugins/decks/DecksMenu.js +42 -0
  529. package/lib/loop/plugins/decks/index.d.ts +19 -0
  530. package/lib/loop/plugins/decks/index.js +133 -0
  531. package/lib/loop/plugins/decks/surface.d.ts +7 -0
  532. package/lib/loop/plugins/decks/surface.js +11 -0
  533. package/lib/loop/plugins/document/DocumentView.d.ts +12 -0
  534. package/lib/loop/plugins/document/DocumentView.js +68 -0
  535. package/lib/loop/plugins/document/index.d.ts +3 -0
  536. package/lib/loop/plugins/document/index.js +86 -0
  537. package/lib/loop/plugins/document/openingDocument.d.ts +28 -0
  538. package/lib/loop/plugins/document/openingDocument.js +122 -0
  539. package/lib/loop/plugins/document-toolbar/SandboxStatusItem.d.ts +16 -0
  540. package/lib/loop/plugins/document-toolbar/SandboxStatusItem.js +31 -0
  541. package/lib/loop/plugins/document-toolbar/index.d.ts +4 -0
  542. package/lib/loop/plugins/document-toolbar/index.js +35 -0
  543. package/lib/loop/plugins/document-toolbar/names.d.ts +6 -0
  544. package/lib/loop/plugins/document-toolbar/names.js +10 -0
  545. package/lib/loop/plugins/document-toolbar/plugin.d.ts +2 -0
  546. package/lib/loop/plugins/document-toolbar/plugin.js +38 -0
  547. package/lib/loop/plugins/document-view/index.d.ts +10 -0
  548. package/lib/loop/plugins/document-view/index.js +28 -0
  549. package/lib/loop/plugins/graph/GraphToggle.d.ts +17 -0
  550. package/lib/loop/plugins/graph/GraphToggle.js +22 -0
  551. package/lib/loop/plugins/graph/GraphView.d.ts +16 -0
  552. package/lib/loop/plugins/graph/GraphView.js +6 -0
  553. package/lib/loop/plugins/graph/index.d.ts +5 -0
  554. package/lib/loop/plugins/graph/index.js +80 -0
  555. package/lib/loop/plugins/graph/viewType.d.ts +10 -0
  556. package/lib/loop/plugins/graph/viewType.js +14 -0
  557. package/lib/loop/plugins/input-prompt/ComposerView.d.ts +15 -0
  558. package/lib/loop/plugins/input-prompt/ComposerView.js +25 -0
  559. package/lib/loop/plugins/input-prompt/index.d.ts +25 -0
  560. package/lib/loop/plugins/input-prompt/index.js +26 -0
  561. package/lib/loop/plugins/models/index.d.ts +3 -0
  562. package/lib/loop/plugins/models/index.js +49 -0
  563. package/lib/loop/plugins/notebook/NotebookView.d.ts +9 -0
  564. package/lib/loop/plugins/notebook/NotebookView.js +189 -0
  565. package/lib/loop/plugins/notebook/index.d.ts +3 -0
  566. package/lib/loop/plugins/notebook/index.js +91 -0
  567. package/lib/loop/plugins/notebook/openingNotebook.d.ts +72 -0
  568. package/lib/loop/plugins/notebook/openingNotebook.js +90 -0
  569. package/lib/loop/plugins/notebook-toolbar/index.d.ts +4 -0
  570. package/lib/loop/plugins/notebook-toolbar/index.js +45 -0
  571. package/lib/loop/plugins/notebook-toolbar/items.d.ts +10 -0
  572. package/lib/loop/plugins/notebook-toolbar/items.js +45 -0
  573. package/lib/loop/plugins/notebook-toolbar/names.d.ts +9 -0
  574. package/lib/loop/plugins/notebook-toolbar/names.js +13 -0
  575. package/lib/loop/plugins/notebook-toolbar/plugin.d.ts +2 -0
  576. package/lib/loop/plugins/notebook-toolbar/plugin.js +24 -0
  577. package/lib/loop/plugins/notebook-view/index.d.ts +10 -0
  578. package/lib/loop/plugins/notebook-view/index.js +30 -0
  579. package/lib/loop/plugins/page-layout/TurnPanel.d.ts +25 -0
  580. package/lib/loop/plugins/page-layout/TurnPanel.js +126 -0
  581. package/lib/loop/plugins/page-layout/index.d.ts +71 -0
  582. package/lib/loop/plugins/page-layout/index.js +160 -0
  583. package/lib/loop/plugins/plugins-panel/index.d.ts +14 -0
  584. package/lib/loop/plugins/plugins-panel/index.js +74 -0
  585. package/lib/loop/plugins/prompt/NewChatAction.d.ts +19 -0
  586. package/lib/loop/plugins/prompt/NewChatAction.js +10 -0
  587. package/lib/loop/plugins/prompt/index.d.ts +11 -0
  588. package/lib/loop/plugins/prompt/index.js +73 -0
  589. package/lib/loop/plugins/shell/editorChoice.d.ts +31 -0
  590. package/lib/loop/plugins/shell/editorChoice.js +58 -0
  591. package/lib/loop/plugins/shell/index.d.ts +47 -0
  592. package/lib/loop/plugins/shell/index.js +142 -0
  593. package/lib/loop/plugins/shell/useEditorPreviews.d.ts +32 -0
  594. package/lib/loop/plugins/shell/useEditorPreviews.js +217 -0
  595. package/lib/loop/plugins/subagent-activity/SubagentPulse.d.ts +16 -0
  596. package/lib/loop/plugins/subagent-activity/SubagentPulse.js +45 -0
  597. package/lib/loop/plugins/subagent-activity/index.d.ts +12 -0
  598. package/lib/loop/plugins/subagent-activity/index.js +42 -0
  599. package/lib/loop/plugins/view-switch/index.d.ts +46 -0
  600. package/lib/loop/plugins/view-switch/index.js +68 -0
  601. package/lib/loop/plugins/window-frame/WindowFrame.d.ts +48 -0
  602. package/lib/loop/plugins/window-frame/WindowFrame.js +63 -0
  603. package/lib/loop/plugins/window-frame/index.d.ts +6 -0
  604. package/lib/loop/plugins/window-frame/index.js +79 -0
  605. package/lib/loop/plugins/window-frame/slots.d.ts +26 -0
  606. package/lib/loop/plugins/window-frame/slots.js +30 -0
  607. package/lib/loop/presets.d.ts +181 -0
  608. package/lib/loop/presets.js +141 -0
  609. package/lib/loop/shell/LoopWorkspace.d.ts +109 -0
  610. package/lib/loop/shell/LoopWorkspace.js +231 -0
  611. package/lib/loop/shell/PluginToggles.d.ts +21 -0
  612. package/lib/loop/shell/PluginToggles.js +41 -0
  613. package/lib/loop/shell/ViewSwitcher.d.ts +24 -0
  614. package/lib/loop/shell/ViewSwitcher.js +43 -0
  615. package/lib/loop/shell/WorkspaceFullScreenAction.d.ts +25 -0
  616. package/lib/loop/shell/WorkspaceFullScreenAction.js +24 -0
  617. package/lib/loop/shell/index.d.ts +10 -0
  618. package/lib/loop/shell/index.js +14 -0
  619. package/lib/loop/shell/useWorkspaceFullScreen.d.ts +93 -0
  620. package/lib/loop/shell/useWorkspaceFullScreen.js +167 -0
  621. package/lib/loop-example-main.d.ts +1 -0
  622. package/lib/loop-example-main.js +42 -0
  623. package/lib/loop-main.d.ts +1 -0
  624. package/lib/loop-main.js +138 -0
  625. package/lib/mcp/McpServerManager.d.ts +1 -1
  626. package/lib/models/CodeSandboxSnapshotDTO.d.ts +1 -1
  627. package/lib/models/CodeSandboxVariant.d.ts +13 -5
  628. package/lib/models/CodeSandboxVariant.js +17 -5
  629. package/lib/models/Content.d.ts +26 -0
  630. package/lib/models/Deck.d.ts +14 -0
  631. package/lib/models/Environment.d.ts +678 -5
  632. package/lib/models/Environment.js +12 -1
  633. package/lib/models/EnvironmentDTO.d.ts +24 -6
  634. package/lib/models/EnvironmentDTO.js +13 -2
  635. package/lib/models/Exercise.d.ts +0 -2
  636. package/lib/models/ItemType.d.ts +1 -1
  637. package/lib/models/Library.d.ts +0 -2
  638. package/lib/models/Notebook.d.ts +0 -2
  639. package/lib/models/ProjectDTO.d.ts +2 -2
  640. package/lib/models/ProjectDTO.js +4 -4
  641. package/lib/models/Runtime.d.ts +17 -11
  642. package/lib/models/RuntimeDTO.d.ts +16 -7
  643. package/lib/models/RuntimeDTO.js +9 -9
  644. package/lib/models/Space.d.ts +10 -0
  645. package/lib/models/Space.js +1 -1
  646. package/lib/models/SpaceDTO.d.ts +1 -1
  647. package/lib/models/SpaceItem.d.ts +2 -2
  648. package/lib/models/environments.generated.d.ts +141 -0
  649. package/lib/models/environments.generated.js +13 -0
  650. package/lib/models/index.d.ts +1 -1
  651. package/lib/models/index.js +1 -1
  652. package/lib/protocols/A2AAdapter.d.ts +39 -6
  653. package/lib/protocols/A2AAdapter.js +180 -11
  654. package/lib/protocols/ACPAdapter.js +40 -37
  655. package/lib/protocols/AGUIAdapter.d.ts +14 -0
  656. package/lib/protocols/AGUIAdapter.js +34 -9
  657. package/lib/protocols/BrowserAgentAdapter.d.ts +125 -0
  658. package/lib/protocols/BrowserAgentAdapter.js +317 -0
  659. package/lib/protocols/VercelAIAdapter.d.ts +10 -0
  660. package/lib/protocols/VercelAIAdapter.js +27 -7
  661. package/lib/protocols/index.d.ts +1 -0
  662. package/lib/protocols/index.js +1 -0
  663. package/lib/runtimes/actions.d.ts +8 -3
  664. package/lib/runtimes/actions.js +46 -14
  665. package/lib/runtimes/apis.d.ts +13 -4
  666. package/lib/runtimes/browser/agent.d.ts +54 -0
  667. package/lib/runtimes/browser/agent.js +63 -0
  668. package/lib/runtimes/browser/anonymousToken.d.ts +121 -0
  669. package/lib/runtimes/browser/anonymousToken.js +300 -0
  670. package/lib/runtimes/browser/frontendTools.d.ts +61 -0
  671. package/lib/runtimes/browser/frontendTools.js +152 -0
  672. package/lib/runtimes/browser/index.d.ts +11 -0
  673. package/lib/runtimes/browser/index.js +20 -0
  674. package/lib/runtimes/browser/model.d.ts +52 -0
  675. package/lib/runtimes/browser/model.js +110 -0
  676. package/lib/runtimes/browser/protocol.d.ts +54 -0
  677. package/lib/runtimes/browser/protocol.js +35 -0
  678. package/lib/runtimes/browser/subagents.d.ts +131 -0
  679. package/lib/runtimes/browser/subagents.js +241 -0
  680. package/lib/runtimes/index.d.ts +3 -0
  681. package/lib/runtimes/index.js +3 -0
  682. package/lib/runtimes/lifecycle.d.ts +76 -0
  683. package/lib/runtimes/lifecycle.js +99 -0
  684. package/lib/runtimes/variants.d.ts +172 -0
  685. package/lib/runtimes/variants.js +187 -0
  686. package/lib/services/reconnectToRuntime.d.ts +2 -2
  687. package/lib/services/reconnectToRuntime.js +3 -3
  688. package/lib/services/sandboxServiceManagers.d.ts +2 -2
  689. package/lib/services/sandboxServiceManagers.js +11 -11
  690. package/lib/specs/agents/agents.d.ts +129 -112
  691. package/lib/specs/agents/agents.js +8200 -5044
  692. package/lib/specs/evals.js +9 -0
  693. package/lib/specs/frontendTools.d.ts +4 -0
  694. package/lib/specs/frontendTools.js +77 -3
  695. package/lib/specs/mcpServers.d.ts +1 -0
  696. package/lib/specs/mcpServers.js +38 -15
  697. package/lib/specs/models.d.ts +18 -0
  698. package/lib/specs/models.js +154 -0
  699. package/lib/specs/outputs.d.ts +2 -0
  700. package/lib/specs/outputs.js +31 -0
  701. package/lib/specs/personas.js +1 -1
  702. package/lib/specs/skills.js +7 -7
  703. package/lib/specs/teams/teams.d.ts +2 -0
  704. package/lib/specs/teams/teams.js +628 -111
  705. package/lib/state/index.d.ts +1 -1
  706. package/lib/state/index.js +1 -1
  707. package/lib/state/substates/RuntimesState.d.ts +5 -5
  708. package/lib/state/substates/RuntimesState.js +14 -14
  709. package/lib/state/substates/index.d.ts +1 -1
  710. package/lib/state/substates/index.js +1 -1
  711. package/lib/stores/agentRuntimeStore.d.ts +43 -1
  712. package/lib/stores/agentRuntimeStore.js +100 -11
  713. package/lib/stores/index.d.ts +1 -1
  714. package/lib/stores/index.js +1 -1
  715. package/lib/stories/Button.d.ts +1 -1
  716. package/lib/stories/Button.stories.d.ts +1 -1
  717. package/lib/stories/Header.d.ts +1 -1
  718. package/lib/stories/Header.stories.d.ts +1 -1
  719. package/lib/test-setup.js +66 -0
  720. package/lib/tools/adapters/agent-runtimes/lexicalHooks.d.ts +15 -0
  721. package/lib/tools/adapters/agent-runtimes/lexicalHooks.js +43 -2
  722. package/lib/tools/adapters/agent-runtimes/notebookHooks.d.ts +9 -0
  723. package/lib/tools/adapters/agent-runtimes/notebookHooks.js +12 -0
  724. package/lib/tools/adapters/commands/frontendCommandTools.d.ts +11 -0
  725. package/lib/tools/adapters/commands/frontendCommandTools.js +60 -0
  726. package/lib/tools/adapters/commands/index.d.ts +1 -0
  727. package/lib/tools/adapters/commands/index.js +5 -0
  728. package/lib/tools/adapters/copilotkit/lexicalHooks.js +7 -3
  729. package/lib/tools/index.d.ts +1 -0
  730. package/lib/tools/index.js +1 -0
  731. package/lib/types/a2a.d.ts +15 -1
  732. package/lib/types/agents-lifecycle.d.ts +11 -6
  733. package/lib/types/agents.d.ts +31 -6
  734. package/lib/types/agentspecs.d.ts +120 -4
  735. package/lib/types/chat.d.ts +251 -3
  736. package/lib/types/checkpoints.d.ts +20 -0
  737. package/lib/types/config.d.ts +13 -1
  738. package/lib/types/connection.d.ts +1 -1
  739. package/lib/types/evals.d.ts +2 -0
  740. package/lib/types/messages.d.ts +60 -0
  741. package/lib/types/models.d.ts +26 -0
  742. package/lib/types/notifications.d.ts +15 -6
  743. package/lib/types/outputs.d.ts +2 -0
  744. package/lib/types/protocol.d.ts +7 -2
  745. package/lib/types/stream.d.ts +48 -3
  746. package/lib/types/stream.js +5 -0
  747. package/lib/types/teams.d.ts +102 -4
  748. package/lib/types/tool-approvals.d.ts +1 -1
  749. package/lib/types/tools.d.ts +8 -2
  750. package/lib/utils/utils.js +7 -1
  751. package/package.json +376 -361
  752. package/scripts/codegen/compose.py +208 -0
  753. package/scripts/codegen/generate_agents.py +202 -31
  754. package/scripts/codegen/generate_evals.py +2 -0
  755. package/scripts/codegen/generate_frontend_tools.py +35 -6
  756. package/scripts/codegen/generate_mcp_servers.py +2 -2
  757. package/scripts/codegen/generate_models.py +40 -15
  758. package/scripts/codegen/generate_outputs.py +2 -0
  759. package/scripts/codegen/generate_sandbox_agents.py +76 -62
  760. package/scripts/codegen/generate_skills.py +2 -2
  761. package/scripts/codegen/generate_teams.py +178 -4
  762. package/scripts/codegen/generate_tools.py +6 -4
  763. package/scripts/gen_workers.py +278 -110
  764. package/scripts/generate-environments-types.py +404 -0
  765. package/lib/chat/prompt/InputFooter.d.ts +0 -58
  766. package/lib/chat/prompt/InputFooter.js +0 -194
  767. package/lib/chat/prompt/InputPromptFooter.d.ts +0 -27
  768. package/lib/chat/prompt/InputPromptFooter.js +0 -15
  769. package/lib/chat/prompt/InputPromptHeader.d.ts +0 -15
  770. package/lib/chat/prompt/InputPromptHeader.js +0 -15
  771. package/lib/chat/usage/TokenUsageBar.d.ts +0 -8
  772. package/lib/hooks/useRuntimes.d.ts +0 -5
  773. package/lib/hooks/useRuntimes.js +0 -34
  774. package/lib/jupyter/kernelsHandler.d.ts +0 -8
  775. package/lib/jupyter/kernelsHandler.js +0 -39
  776. package/lib/models/Dataset.d.ts +0 -16
  777. package/lib/utils/Cells.d.ts +0 -2
  778. package/lib/utils/Cells.js +0 -28
  779. /package/lib/models/{Dataset.js → Deck.js} +0 -0
@@ -2,4 +2,15 @@
2
2
  * Copyright (c) 2025-2026 Datalayer, Inc.
3
3
  * Distributed under the terms of the Modified BSD License.
4
4
  */
5
- export {};
5
+ /**
6
+ * The Environment specification, `environments.datalayer.io/v1alpha1`,
7
+ * generated from the JSON Schema `code-sandboxes` exports from its pydantic
8
+ * models (PLAN_ENV.md, D-14). Regenerated by `npm run generate:environments`.
9
+ */
10
+ export * as EnvironmentSchema from './environments.generated';
11
+ /** The build statuses nothing more happens to. Any other status is still to run or running. */
12
+ export const TERMINAL_ENVIRONMENT_BUILD_STATUSES = [
13
+ 'succeeded',
14
+ 'failed',
15
+ 'cancelled',
16
+ ];
@@ -13,8 +13,11 @@ export interface EnvironmentData {
13
13
  title: string;
14
14
  /** Detailed description of the environment */
15
15
  description: string;
16
- /** Docker image used for this environment */
17
- dockerImage: string;
16
+ /**
17
+ * Docker image used for this environment. A platform entry names one; a user
18
+ * environment runs an artifact the platform resolves at launch (E1-11).
19
+ */
20
+ dockerImage?: string;
18
21
  /** Example usage or description */
19
22
  example?: string;
20
23
  /** Code snippets for this environment */
@@ -30,8 +33,14 @@ export interface EnvironmentData {
30
33
  language: string;
31
34
  /** Resource ranges configuration */
32
35
  resourcesRanges?: any;
33
- /** Credits consumed per hour when running */
34
- burning_rate: number;
36
+ /**
37
+ * Credits consumed per second when running. A user environment's is the rate
38
+ * of the size class its promoted version names (D-4); absent means unknown,
39
+ * not free (E1-19).
40
+ */
41
+ burning_rate?: number;
42
+ /** The size class that prices a user environment (D-4). */
43
+ sizeClass?: string;
35
44
  /** Simple resource specification */
36
45
  resources?: any;
37
46
  /** Name identifier for the environment */
@@ -55,7 +64,7 @@ export interface EnvironmentJSON {
55
64
  title: string;
56
65
  /** Unique name identifier for the environment */
57
66
  name: string;
58
- /** Credits consumed per hour for this environment */
67
+ /** Credits consumed per second for this environment */
59
68
  burningRate: number;
60
69
  /** Description of the environment (contains HTML markup) */
61
70
  description: string;
@@ -99,8 +108,17 @@ export declare class EnvironmentDTO {
99
108
  get title(): string;
100
109
  /** Unique name identifier for the environment (e.g., 'ai-env', 'ai-agents-env'). */
101
110
  get name(): string;
102
- /** Credits consumed per hour for this environment. */
111
+ /**
112
+ * Credits consumed per second for this environment.
113
+ *
114
+ * Zero when the listing carries no rate, which for a user environment means
115
+ * its size class is unpriced rather than that it is free: `sizeClass` beside
116
+ * this tells the two apart, and the callers that reserve credits refuse the
117
+ * launch rather than reserving nothing (E1-19).
118
+ */
103
119
  get burningRate(): number;
120
+ /** The size class that prices a user environment (D-4); absent on a platform entry. */
121
+ get sizeClass(): string | undefined;
104
122
  /** Rich description of the environment (contains HTML markup). */
105
123
  get richDescription(): string;
106
124
  /** Clean description without HTML tags. */
@@ -38,9 +38,20 @@ export class EnvironmentDTO {
38
38
  get name() {
39
39
  return this._data.name;
40
40
  }
41
- /** Credits consumed per hour for this environment. */
41
+ /**
42
+ * Credits consumed per second for this environment.
43
+ *
44
+ * Zero when the listing carries no rate, which for a user environment means
45
+ * its size class is unpriced rather than that it is free: `sizeClass` beside
46
+ * this tells the two apart, and the callers that reserve credits refuse the
47
+ * launch rather than reserving nothing (E1-19).
48
+ */
42
49
  get burningRate() {
43
- return this._data.burning_rate;
50
+ return this._data.burning_rate ?? 0;
51
+ }
52
+ /** The size class that prices a user environment (D-4); absent on a platform entry. */
53
+ get sizeClass() {
54
+ return this._data.sizeClass || undefined;
44
55
  }
45
56
  /** Rich description of the environment (contains HTML markup). */
46
57
  get richDescription() {
@@ -1,4 +1,3 @@
1
- import { IDataset } from './Dataset';
2
1
  import { IItem } from './Item';
3
2
  export type ICode = string;
4
3
  export type IHelp = string;
@@ -9,7 +8,6 @@ export type IExercise = IItem & {
9
8
  codeSolution: ICode;
10
9
  codeQuestion: ICode;
11
10
  codeTest: ICode;
12
- datasets: Array<IDataset>;
13
11
  lastUpdateDate?: Date;
14
12
  lastPublicationDate?: Date;
15
13
  };
@@ -1,2 +1,2 @@
1
- export type IItemType = 'assignment' | 'authoring' | 'cell' | 'content' | 'credits' | 'dataset' | 'datasource' | 'document' | 'documentation' | 'environment' | 'exercise' | 'growth' | 'home' | 'invite' | 'lesson' | 'library' | 'mail' | 'management' | 'notebook' | 'onboarding' | 'organization' | 'page' | 'runtime' | 'runtime-snapshot' | 'settings' | 'share' | 'space' | 'storage' | 'success' | 'support' | 'tag' | 'team' | 'usage' | 'user' | 'undefined';
1
+ export type IItemType = 'assignment' | 'authoring' | 'cell' | 'content' | 'credits' | 'dataset' | 'datasource' | 'deck' | 'document' | 'documentation' | 'environment' | 'exercise' | 'growth' | 'home' | 'invite' | 'lesson' | 'library' | 'mail' | 'management' | 'notebook' | 'onboarding' | 'organization' | 'page' | 'runtime' | 'runtime-snapshot' | 'settings' | 'share' | 'space' | 'storage' | 'success' | 'support' | 'tag' | 'team' | 'usage' | 'user' | 'undefined';
2
2
  export default IItemType;
@@ -1,10 +1,8 @@
1
1
  import { IExercise } from './Exercise';
2
- import { IDataset } from './Dataset';
3
2
  export type LibraryType = 'public' | 'private';
4
3
  export type Library = {
5
4
  id: string;
6
5
  type: LibraryType;
7
6
  exercises: Array<IExercise>;
8
- datasets: Array<IDataset>;
9
7
  };
10
8
  export default Library;
@@ -1,9 +1,7 @@
1
1
  import { INotebookContent } from '@jupyterlab/nbformat';
2
2
  import { IItem } from './Item';
3
- import { IDataset } from './Dataset';
4
3
  export type IBaseNotebook = IItem & {
5
4
  nbformat?: INotebookContent;
6
- datasets: Array<IDataset>;
7
5
  };
8
6
  export type INotebook = IBaseNotebook & {
9
7
  type: 'notebook';
@@ -20,7 +20,7 @@ export interface ProjectJSON {
20
20
  variant: string;
21
21
  isPublic: boolean;
22
22
  createdAt: string;
23
- attachedAgentPodName: string | null;
23
+ attachedAgentRuntimeName: string | null;
24
24
  attachedAgentSpecId: string | null;
25
25
  attachedAgentGivenName: string | null;
26
26
  hasAgent: boolean;
@@ -65,7 +65,7 @@ export declare class ProjectDTO {
65
65
  /** Creation date (stable across calls). */
66
66
  get createdAt(): Date;
67
67
  /** Attached agent runtime pod name, if any. */
68
- get attachedAgentPodName(): string | undefined;
68
+ get attachedAgentRuntimeName(): string | undefined;
69
69
  /** Attached agentspec ID (e.g., 'data-acquisition'), if any. */
70
70
  get attachedAgentSpecId(): string | undefined;
71
71
  /** Human-readable name of the attached agent runtime, if any. */
@@ -65,9 +65,9 @@ export class ProjectDTO {
65
65
  return this._createdAt;
66
66
  }
67
67
  /** Attached agent runtime pod name, if any. */
68
- get attachedAgentPodName() {
68
+ get attachedAgentRuntimeName() {
69
69
  this._checkDeleted();
70
- return this._data.attached_agent_pod_name_s || undefined;
70
+ return this._data.attached_agent_runtime_name_s || undefined;
71
71
  }
72
72
  /** Attached agentspec ID (e.g., 'data-acquisition'), if any. */
73
73
  get attachedAgentSpecId() {
@@ -82,7 +82,7 @@ export class ProjectDTO {
82
82
  /** Whether an agent is currently attached to this project. */
83
83
  get hasAgent() {
84
84
  this._checkDeleted();
85
- return !!this._data.attached_agent_pod_name_s;
85
+ return !!this._data.attached_agent_runtime_name_s;
86
86
  }
87
87
  /** Mark this project as deleted. */
88
88
  markDeleted() {
@@ -107,7 +107,7 @@ export class ProjectDTO {
107
107
  variant: this.variant,
108
108
  isPublic: this.isPublic,
109
109
  createdAt: this.createdAt.toISOString(),
110
- attachedAgentPodName: this.attachedAgentPodName ?? null,
110
+ attachedAgentRuntimeName: this.attachedAgentRuntimeName ?? null,
111
111
  attachedAgentSpecId: this.attachedAgentSpecId ?? null,
112
112
  attachedAgentGivenName: this.attachedAgentGivenName ?? null,
113
113
  hasAgent: this.hasAgent,
@@ -19,17 +19,17 @@ export type IRuntimeLocation = 'browser' | 'local' | string;
19
19
  /**
20
20
  * A live runtime.
21
21
  *
22
- * Composition of the control-plane runtime pod ({@link IRuntimePod}) and the
22
+ * Composition of the control-plane runtime pod ({@link IRuntimeRecord}) and the
23
23
  * JupyterLab kernel model ({@link Kernel.IModel}, e.g. `id`, `name`,
24
24
  * `execution_state`). This is the canonical shape used across the app once a
25
- * pod has an attached kernel: `IRuntimePod` supplies the pod/control-plane
25
+ * pod has an attached kernel: `IRuntimeRecord` supplies the pod/control-plane
26
26
  * fields (snake_case) and `Kernel.IModel` supplies the live kernel fields.
27
27
  *
28
28
  * Note on identity: `Kernel.IModel.id` is the *kernel* id (only present once a
29
- * kernel is attached), while {@link IRuntimePod.uid} is the stable *pod* id.
29
+ * kernel is attached), while {@link IRuntimeRecord.uid} is the stable *pod* id.
30
30
  * Prefer `uid` for pod identity and `id` for kernel identity.
31
31
  */
32
- export interface IRuntimeModel extends IRuntimePod, Kernel.IModel {
32
+ export interface IRuntimeModel extends IRuntimeRecord, Kernel.IModel {
33
33
  }
34
34
  export interface IRuntimeEnvironment {
35
35
  name: string;
@@ -51,7 +51,7 @@ export interface IRuntimeEnvironment {
51
51
  * location-agnostic UI descriptor used by pickers/launchers - do not merge the
52
52
  * two (see `IRuntimeDesc`).
53
53
  */
54
- export interface IRuntimePod {
54
+ export interface IRuntimeRecord {
55
55
  /**
56
56
  * Stable runtime pod identifier (ULID) assigned by the control-plane.
57
57
  *
@@ -64,7 +64,7 @@ export interface IRuntimePod {
64
64
  /**
65
65
  * Runtime name
66
66
  */
67
- pod_name: string;
67
+ runtime_name: string;
68
68
  /**
69
69
  * Runtime ingress URL
70
70
  */
@@ -97,6 +97,12 @@ export interface IRuntimePod {
97
97
  * Runtime credits reservation expiration timestamp
98
98
  */
99
99
  expired_at?: string;
100
+ /**
101
+ * Why the runtime's pod does not run yet, in Kubernetes' own words — the
102
+ * scheduler's `Unschedulable: 0/6 nodes are available: 4 Insufficient
103
+ * cpu.`, or an image that cannot be pulled — or empty once it runs.
104
+ */
105
+ waiting?: string;
100
106
  }
101
107
  /**
102
108
  * Runtime description (UI layer).
@@ -104,12 +110,12 @@ export interface IRuntimePod {
104
110
  * A lightweight, camelCase, location-agnostic descriptor used by the runtime
105
111
  * pickers/launchers to describe a *desired or selected* runtime across all
106
112
  * locations (browser / local / remote). It is intentionally kept separate from
107
- * {@link IRuntimePod}:
113
+ * {@link IRuntimeRecord}:
108
114
  * - naming: camelCase (UI) vs snake_case (backend transport);
109
115
  * - scope: spans all {@link IRuntimeLocation}s vs remote pod only;
110
116
  * - lifecycle: a selection/description (may not exist yet) vs a concrete
111
117
  * running pod.
112
- * Map between the two at the boundary (e.g. `podName` <-> `pod_name`,
118
+ * Map between the two at the boundary (e.g. `runtimeName` <-> `runtime_name`,
113
119
  * `burningRate` <-> `burning_rate`) rather than merging them.
114
120
  */
115
121
  export interface IRuntimeDesc {
@@ -146,9 +152,9 @@ export interface IRuntimeDesc {
146
152
  */
147
153
  burningRate?: number;
148
154
  /**
149
- * Runtime Pod name (if applicable).
155
+ * The runtime's name, which is its uid (if applicable).
150
156
  */
151
- podName?: string;
157
+ runtimeName?: string;
152
158
  }
153
159
  /**
154
160
  * Runtime type.
@@ -159,4 +165,4 @@ export type IRuntimeType = 'notebook' | 'cell';
159
165
  /**
160
166
  * Runtime optional capabilities.
161
167
  */
162
- export type IRuntimeCapabilities = 'user_storage';
168
+ export type IRuntimeCapabilities = 'home-folder';
@@ -1,14 +1,14 @@
1
1
  import type { AgentRuntimesClient as DatalayerClient } from '../client/AgentRuntimesClient';
2
2
  import { CodeSandboxSnapshotDTO } from './CodeSandboxSnapshotDTO';
3
- import type { IRuntimePod } from './Runtime';
3
+ import type { IRuntimeRecord } from './Runtime';
4
4
  /**
5
5
  * Represents a running instance of a computing environment.
6
6
  *
7
- * Alias of the canonical {@link IRuntimePod} (see `Runtime.ts`) so the raw
7
+ * Alias of the canonical {@link IRuntimeRecord} (see `Runtime.ts`) so the raw
8
8
  * snake_case pod payload is defined in a single place. Kept as a named export
9
9
  * for the Datalayer Client's public API surface.
10
10
  */
11
- export type RuntimeData = IRuntimePod;
11
+ export type RuntimeData = IRuntimeRecord;
12
12
  /**
13
13
  * Stable public interface for Runtime data.
14
14
  * This is the contract that Client consumers can rely on.
@@ -17,8 +17,8 @@ export type RuntimeData = IRuntimePod;
17
17
  export interface RuntimeJSON {
18
18
  /** ulid for the runtime */
19
19
  uid: string;
20
- /** Kubernetes pod name for the runtime instance */
21
- podName: string;
20
+ /** The runtime's name, which is its uid; the Pod is called by it. */
21
+ runtimeName: string;
22
22
  /** User-friendly name for the runtime */
23
23
  givenName: string;
24
24
  /** Name of the environment this runtime is based on */
@@ -45,7 +45,16 @@ export interface RuntimeJSON {
45
45
  export interface CreateRuntimeRequest {
46
46
  /** Runtime environment to use */
47
47
  environment: {
48
+ /**
49
+ * A platform environment by its name, or a user environment as
50
+ * `<account-handle>/<name>` or by its uid (PLAN_ENV.md, D-2).
51
+ */
48
52
  name: string;
53
+ /**
54
+ * Which version of a user environment: its number, or a version uid.
55
+ * Absent means the promoted version (E1-19).
56
+ */
57
+ version?: number | string;
49
58
  };
50
59
  /** Type of runtime (e.g., 'notebook', 'terminal', 'job') */
51
60
  type?: 'notebook' | 'terminal' | 'job';
@@ -109,8 +118,8 @@ export declare class RuntimeDTO {
109
118
  * @throws Error if deleted
110
119
  */
111
120
  private _checkDeleted;
112
- /** Kubernetes pod name for the runtime instance. */
113
- get podName(): string;
121
+ /** The runtime's name, which is its uid; the Pod is called by it. */
122
+ get runtimeName(): string;
114
123
  /** Unique identifier for the runtime. */
115
124
  get uid(): string;
116
125
  /** Name of the environment this runtime is based on. */
@@ -43,16 +43,16 @@ export class RuntimeDTO {
43
43
  */
44
44
  _checkDeleted() {
45
45
  if (this._deleted) {
46
- throw new Error(`Runtime ${this._data.pod_name} has been deleted and no longer exists`);
46
+ throw new Error(`Runtime ${this._data.runtime_name} has been deleted and no longer exists`);
47
47
  }
48
48
  }
49
49
  // ========================================================================
50
50
  // Static Properties (set at creation, never change)
51
51
  // ========================================================================
52
- /** Kubernetes pod name for the runtime instance. */
53
- get podName() {
52
+ /** The runtime's name, which is its uid; the Pod is called by it. */
53
+ get runtimeName() {
54
54
  this._checkDeleted();
55
- return this._data.pod_name;
55
+ return this._data.runtime_name;
56
56
  }
57
57
  /** Unique identifier for the runtime. */
58
58
  get uid() {
@@ -112,7 +112,7 @@ export class RuntimeDTO {
112
112
  * After deletion, subsequent calls to dynamic methods will throw errors.
113
113
  */
114
114
  async delete() {
115
- await this._client.deleteRuntime(this.podName);
115
+ await this._client.deleteRuntime(this.runtimeName);
116
116
  this._deleted = true;
117
117
  }
118
118
  /**
@@ -123,7 +123,7 @@ export class RuntimeDTO {
123
123
  */
124
124
  async update(from) {
125
125
  this._checkDeleted();
126
- const updated = await updateRuntime(this._client.getToken(), this.podName, from, this._client.getRuntimesUrl());
126
+ const updated = await updateRuntime(this._client.getToken(), this.runtimeName, from, this._client.getRuntimesUrl());
127
127
  return new RuntimeDTO(updated, this._client);
128
128
  }
129
129
  /**
@@ -136,7 +136,7 @@ export class RuntimeDTO {
136
136
  */
137
137
  async createSnapshot(name, description, stop) {
138
138
  this._checkDeleted();
139
- return await this._client.createSnapshot(this.podName, name, description, stop);
139
+ return await this._client.createSnapshot(this.runtimeName, name, description, stop);
140
140
  }
141
141
  // ========================================================================
142
142
  // Utility Methods
@@ -165,7 +165,7 @@ export class RuntimeDTO {
165
165
  const obj = {
166
166
  // Core identifiers
167
167
  uid: this.uid,
168
- podName: this.podName,
168
+ runtimeName: this.runtimeName,
169
169
  givenName: this.givenName,
170
170
  // Environment info
171
171
  environmentName: this.environmentName,
@@ -199,6 +199,6 @@ export class RuntimeDTO {
199
199
  /** String representation of the runtime. */
200
200
  toString() {
201
201
  this._checkDeleted();
202
- return `Runtime(${this.podName}, ${this.environmentName})`;
202
+ return `Runtime(${this.runtimeName}, ${this.environmentName})`;
203
203
  }
204
204
  }
@@ -19,6 +19,16 @@ export type IBaseSpace = {
19
19
  variant: ISpaceVariant;
20
20
  name: string;
21
21
  description: string;
22
+ /**
23
+ * The words its owner filed it under.
24
+ *
25
+ * Present on every space the API answers with — the mapper reads `tags_ss`
26
+ * — and searched for by the library, which is what makes them worth
27
+ * setting. They were missing from this type rather than from the data, so
28
+ * the publish dialog could not be handed a course's own tags without a
29
+ * cast, and would have offered to replace them with nothing.
30
+ */
31
+ tags?: string[];
22
32
  creationDate: Date;
23
33
  public: boolean;
24
34
  owner: IUser;
@@ -59,7 +59,7 @@ export const asSpace = (raw_space) => {
59
59
  : undefined,
60
60
  sharedOwnerUserUids,
61
61
  // Preserve raw Solr fields so consumers can access dynamic fields
62
- // (e.g. attached_agent_pod_name_s for project-agent assignment)
62
+ // (e.g. attached_agent_runtime_name_s for project-agent assignment)
63
63
  ...raw_space,
64
64
  };
65
65
  return space;
@@ -18,7 +18,7 @@ export interface SpaceData {
18
18
  items?: any[];
19
19
  public_b?: boolean;
20
20
  creation_ts_dt?: string;
21
- attached_agent_pod_name_s?: string;
21
+ attached_agent_runtime_name_s?: string;
22
22
  attached_agent_spec_id_s?: string;
23
23
  attached_agent_given_name_s?: string;
24
24
  shared_owner_user_uids_ss?: string[];
@@ -1,10 +1,10 @@
1
1
  import { INotebook } from './Notebook';
2
2
  import { IDocument } from './Document';
3
+ import { IDeck } from './Deck';
3
4
  import { ICell } from './Cell';
4
- import { IDataset } from './Dataset';
5
5
  import { IEnvironment } from './Environment';
6
6
  import { ILesson } from './Lesson';
7
7
  import { IExercise } from './Exercise';
8
8
  import { IAssignment } from './Assignment';
9
- export type ISpaceItem = IDataset | INotebook | ICell | IEnvironment | ILesson | IExercise | IAssignment | IDocument;
9
+ export type ISpaceItem = INotebook | ICell | IEnvironment | ILesson | IExercise | IAssignment | IDocument | IDeck;
10
10
  export default ISpaceItem;
@@ -0,0 +1,141 @@
1
+ /** The `$id` of the JSON Schema these types are generated from. */
2
+ export declare const ENVIRONMENT_SCHEMA_ID = "https://datalayer.io/schemas/environments/v1alpha1/environment.json";
3
+ /** The sha256 of the schema text these types are generated from. */
4
+ export declare const ENVIRONMENT_SCHEMA_SHA256 = "df0f8dc57cd82b8b0a77727071cb9a084a64c099703a8b9747ebe0f0958fe8f0";
5
+ /** The `apiVersion` an Environment document carries. */
6
+ export declare const ENVIRONMENT_API_VERSION = "environments.datalayer.io/v1alpha1";
7
+ /** The `kind` an Environment document carries. */
8
+ export declare const ENVIRONMENT_KIND = "Environment";
9
+ export interface Accelerator {
10
+ /** Minimum: 1. Default: `1`. */
11
+ count?: number;
12
+ cuda?: string | null;
13
+ type: string;
14
+ }
15
+ export interface Base {
16
+ channel: string;
17
+ ref: string;
18
+ }
19
+ export interface BuildSecret {
20
+ /** Pattern: `^dlsec_[0-9A-Za-z]+$`. */
21
+ id: string;
22
+ /** Default: `"env"`. */
23
+ mountAs?: 'env' | 'file';
24
+ /** Pattern: `^[A-Za-z0-9_.-]+$`. */
25
+ name: string;
26
+ }
27
+ export interface BuildSpec {
28
+ dependencyFile?: DependencyFileSpec | null;
29
+ image?: ImageSourceSpec | null;
30
+ /** Default: `"packages"`. */
31
+ source?: 'packages' | 'dependencyFile' | 'dockerfile' | 'image';
32
+ }
33
+ export interface Commands {
34
+ postInstall?: string[];
35
+ }
36
+ export interface Compatibility {
37
+ regions?: string[];
38
+ variants?: VariantSet;
39
+ }
40
+ /** One immutable file the Environment bakes from an external source. */
41
+ export interface ContentsBuildEntry {
42
+ path: string;
43
+ /** Pattern: `^[0-9a-f]{64}$`. */
44
+ sha256: string;
45
+ /** Minimum: 0. */
46
+ sizeBytes?: number | null;
47
+ source: string;
48
+ }
49
+ /** A `requirements.txt`, a `pyproject.toml` with its `uv.lock`, or a conda `environment.yml` (E3-01, E3-02). */
50
+ export interface DependencyFileSpec {
51
+ /** Default: `""`. */
52
+ content?: string;
53
+ /** Default: `""`. */
54
+ lockContent?: string;
55
+ /** Default: `"requirements"`. */
56
+ sourceFormat?: 'requirements' | 'pyproject' | 'conda';
57
+ }
58
+ export interface EnvironmentSpec {
59
+ base: Base;
60
+ build?: BuildSpec;
61
+ buildSecrets?: BuildSecret[];
62
+ commands?: Commands;
63
+ compatibility?: Compatibility;
64
+ contentsBuild?: ContentsBuildEntry[];
65
+ /** Default: `"sandbox-contract/v1"`. */
66
+ contract?: string;
67
+ env?: Record<string, string>;
68
+ files?: FileEntry[];
69
+ language: Language;
70
+ packages?: Packages;
71
+ platform?: Platform;
72
+ resources?: Resources;
73
+ }
74
+ export interface FileEntry {
75
+ contentRef: string;
76
+ path: string;
77
+ /** Pattern: `^[0-9a-f]{64}$`. */
78
+ sha256?: string | null;
79
+ /** Minimum: 0. */
80
+ sizeBytes?: number | null;
81
+ }
82
+ /** An existing OCI image, imported as the build's base (E3-04). */
83
+ export interface ImageSourceSpec {
84
+ /** Pattern: `^dlsec_[0-9A-Za-z]+$`. */
85
+ credentialSecretId?: string | null;
86
+ /** Default: `""`. */
87
+ reference?: string;
88
+ }
89
+ export interface Language {
90
+ name?: 'python';
91
+ /** Pattern: `^3\.\d+$`. */
92
+ version: string;
93
+ }
94
+ export interface Metadata {
95
+ labels?: Record<string, string>;
96
+ name: string;
97
+ title?: string | null;
98
+ }
99
+ export interface Packages {
100
+ python?: PythonPackages;
101
+ system?: SystemPackages;
102
+ }
103
+ export interface Platform {
104
+ architecture?: 'linux/amd64';
105
+ }
106
+ export interface PythonPackages {
107
+ constraints?: string[];
108
+ dependencies?: string[];
109
+ indexes?: string[];
110
+ /** Default: `"uv"`. */
111
+ manager?: 'uv' | 'pip' | 'conda';
112
+ }
113
+ export interface ResourceHints {
114
+ /** Greater than 0. */
115
+ cpu?: number | null;
116
+ /** Greater than 0. */
117
+ diskGi?: number | null;
118
+ /** Greater than 0. */
119
+ memoryGi?: number | null;
120
+ }
121
+ export interface Resources {
122
+ /** Default: `"none"`. */
123
+ accelerator?: 'none' | Accelerator;
124
+ hints?: ResourceHints;
125
+ /** Default: `"small"`. */
126
+ sizeClass?: string;
127
+ }
128
+ export interface SystemPackages {
129
+ apt?: string[];
130
+ }
131
+ export interface VariantSet {
132
+ optional?: string[];
133
+ required?: string[];
134
+ }
135
+ /** A Datalayer Environment, environments.datalayer.io/v1alpha1. */
136
+ export interface Environment {
137
+ apiVersion?: 'environments.datalayer.io/v1alpha1';
138
+ kind?: 'Environment';
139
+ metadata: Metadata;
140
+ spec: EnvironmentSpec;
141
+ }
@@ -0,0 +1,13 @@
1
+ /*
2
+ * Copyright (c) 2025-2026 Datalayer, Inc.
3
+ * Distributed under the terms of the Modified BSD License.
4
+ */
5
+ /* Generated from the Environment JSON Schema of code-sandboxes (schemas/environment-v1alpha1.json) by scripts/generate-environments-types.py. Do not edit. */
6
+ /** The `$id` of the JSON Schema these types are generated from. */
7
+ export const ENVIRONMENT_SCHEMA_ID = 'https://datalayer.io/schemas/environments/v1alpha1/environment.json';
8
+ /** The sha256 of the schema text these types are generated from. */
9
+ export const ENVIRONMENT_SCHEMA_SHA256 = 'df0f8dc57cd82b8b0a77727071cb9a084a64c099703a8b9747ebe0f0958fe8f0';
10
+ /** The `apiVersion` an Environment document carries. */
11
+ export const ENVIRONMENT_API_VERSION = 'environments.datalayer.io/v1alpha1';
12
+ /** The `kind` an Environment document carries. */
13
+ export const ENVIRONMENT_KIND = 'Environment';
@@ -6,7 +6,7 @@ export * from './CodeSandboxSnapshot';
6
6
  export * from './CodeSandboxSnapshotDTO';
7
7
  export * from './Content';
8
8
  export * from './Course';
9
- export * from './Dataset';
9
+ export * from './Deck';
10
10
  export * from './Document';
11
11
  export * from './Environment';
12
12
  export * from './EnvironmentDTO';
@@ -11,7 +11,7 @@ export * from './CodeSandboxSnapshot';
11
11
  export * from './CodeSandboxSnapshotDTO';
12
12
  export * from './Content';
13
13
  export * from './Course';
14
- export * from './Dataset';
14
+ export * from './Deck';
15
15
  export * from './Document';
16
16
  export * from './Environment';
17
17
  export * from './EnvironmentDTO';