@datalayer/agent-runtimes 1.0.21 → 1.0.26

package/README.md

@@ -261,7 +261,7 @@ and propagates those values to the Vite HTML placeholders.
 Override any URL on the command line:
 
 ```bash
-make examples:prod DATALAYER_URL=https://prod2.datalayer.run
+make examples:prod DATALAYER_DEFAULT_URL=https://prod2.datalayer.run
 ```
 
 ### Running against a local `plane local` stack
@@ -285,7 +285,7 @@ both http and ws traffic stay local) at the matching localhost port exposed by
 | `PLANE_LOCAL_MANAGER_URL`      | `http://localhost:2100`       |
 | `PLANE_LOCAL_AI_AGENTS_URL`    | `http://localhost:4400`       |
 | `PLANE_LOCAL_AI_INFERENCE_URL` | `http://localhost:4450`       |
-| `PLANE_LOCAL_MCP_SERVERS_URL`  | `http://localhost:4111`       |
+| `PLANE_LOCAL_JUPYTER_MCP_SERVER_URL` | `http://localhost:4404/mcp`   |
 | `PLANE_LOCAL_GROWTH_URL`       | `http://localhost:6660`       |
 | `PLANE_LOCAL_SUCCESS_URL`      | `http://localhost:3300`       |
 | `PLANE_LOCAL_STATUS_URL`       | `http://localhost:4785`       |

package/lib/AgentNode.js

@@ -49,7 +49,7 @@ const LOCAL_JUPYTER_SANDBOX = (() => {
         return { baseUrl: raw.replace(/\/$/, ''), token: undefined };
     }
 })();
-const DEFAULT_DATALAYER_URL = 'https://prod1.datalayer.run';
+const DEFAULT_DATALAYER_SERVICE_URL = 'https://prod1.datalayer.run';
 /**
  * localStorage key recording that the user explicitly signed out. When set, the
  * UI must not silently re-authenticate from the env-supplied DATALAYER_API_KEY
@@ -76,7 +76,7 @@ function setAutoBootstrapDisabled(disabled) {
  * `DATALAYER_*_URL` environment variables, e.g. from `plane local`) when it
  * serves the built agent pages. Reading it at runtime lets the node target the
  * configured services (IAM, runtimes, ...) instead of the build-time-baked
- * `VITE_DATALAYER_URL`, which defaults to production because `make build` runs
+ * `VITE_DATALAYER_*_URL`, which default to production because `make build` runs
  * without the local environment.
  */
 const getConfigUrlFromDocument = (...keys) => {
@@ -101,18 +101,18 @@ const getConfigUrlFromDocument = (...keys) => {
     }
     return undefined;
 };
-/** Resolve the base Datalayer URL: injected config → VITE env → production. */
-const resolveDatalayerUrl = () => getConfigUrlFromDocument('datalayerUrl', 'iamUrl') ||
-    import.meta.env?.VITE_DATALAYER_URL ||
-    DEFAULT_DATALAYER_URL;
-/** Resolve the runtimes URL: injected config → VITE env → base Datalayer URL. */
+/** Resolve the IAM URL: injected config → VITE env → production. */
+const resolveIamUrl = () => getConfigUrlFromDocument('iamUrl') ||
+    import.meta.env?.VITE_DATALAYER_IAM_URL ||
+    DEFAULT_DATALAYER_SERVICE_URL;
+/** Resolve the runtimes URL: injected config → VITE env → production. */
 const resolveRuntimesUrl = () => getConfigUrlFromDocument('runtimesUrl') ||
     import.meta.env?.VITE_DATALAYER_RUNTIMES_URL ||
-    resolveDatalayerUrl();
-/** Resolve the spacer URL: injected config → VITE env → base Datalayer URL. */
+    DEFAULT_DATALAYER_SERVICE_URL;
+/** Resolve the spacer URL: injected config → VITE env → production. */
 const resolveSpacerUrl = () => getConfigUrlFromDocument('spacerUrl') ||
     import.meta.env?.VITE_DATALAYER_SPACER_URL ||
-    resolveDatalayerUrl();
+    DEFAULT_DATALAYER_SERVICE_URL;
 const MODE_CARDS = [
     {
         mode: 'private',
@@ -236,7 +236,7 @@ function AgentNodeProfileView({ token, onTokenExpired, avatarFallbackBackground,
 export function AgentNode() {
     const { token, setAuth, clearAuth } = useSimpleAuthStore();
     const tokenForCore = token ?? undefined;
-    const signInLoginUrl = `${resolveDatalayerUrl()}/api/iam/v1/login`;
+    const signInLoginUrl = `${resolveIamUrl()}/api/iam/v1/login`;
     const queryClient = useQueryClient();
     const iamUser = useIAMStore(state => state.user);
     const { colorMode, theme: themeVariant } = useAgentNodeThemeStore();
@@ -287,7 +287,7 @@ export function AgentNode() {
         }
         const spacerUrl = resolveSpacerUrl();
         return new DatalayerCollaborationProvider({
-            datalayerUrl: spacerUrl,
+            spacerUrl,
             token,
         });
     }, [ephemeralCollaborationDocumentId, token]);
@@ -702,26 +702,26 @@ export function AgentNode() {
     }, [token, pushCredentials]);
     useEffect(() => {
         import('@datalayer/core/lib/state').then(({ iamStore, coreStore }) => {
-            const datalayerUrl = resolveDatalayerUrl();
+            const iamUrl = resolveIamUrl();
             const runtimesUrl = resolveRuntimesUrl();
             const aiInferenceUrl = getConfigUrlFromDocument('aiInferenceUrl') ||
                 import.meta.env?.VITE_DATALAYER_AI_INFERENCE_URL ||
-                datalayerUrl;
+                DEFAULT_DATALAYER_SERVICE_URL;
             // Seed all per-service URLs to match the main UI login behavior.
             const coreApi = coreStore.getState();
             const prevCfg = coreApi.configuration ?? {};
             const urls = {
-                iamUrl: datalayerUrl,
+                iamUrl: iamUrl,
                 runtimesUrl,
-                spacerUrl: datalayerUrl,
-                libraryUrl: datalayerUrl,
-                aiAgentsUrl: datalayerUrl,
+                spacerUrl: iamUrl,
+                libraryUrl: iamUrl,
+                aiAgentsUrl: iamUrl,
                 aiInferenceUrl: aiInferenceUrl,
-                mcpServersUrl: datalayerUrl,
-                otelUrl: datalayerUrl,
-                growthUrl: datalayerUrl,
-                successUrl: datalayerUrl,
-                supportUrl: datalayerUrl,
+                jupyterMcpServerUrl: 'https://mcp.datalayer.run/mcp',
+                otelUrl: iamUrl,
+                growthUrl: iamUrl,
+                successUrl: iamUrl,
+                supportUrl: iamUrl,
             };
             if (typeof coreApi.setConfiguration === 'function') {
                 coreApi.setConfiguration({ ...prevCfg, ...urls });
@@ -732,7 +732,7 @@ export function AgentNode() {
                 }));
             }
             const api = iamStore.getState();
-            iamStore.setState({ token: tokenForCore, iamUrl: datalayerUrl });
+            iamStore.setState({ token: tokenForCore, iamUrl });
             if (tokenForCore && typeof api.refreshUserByToken === 'function') {
                 void Promise.resolve(api.refreshUserByToken(tokenForCore)).then(() => {
                     queryClient.invalidateQueries({ queryKey: ['organizations'] });
@@ -841,9 +841,9 @@ export function AgentNode() {
     // API keys are exchanged for a session token before login so billing and
     // plans endpoints (/api/iam/v1/plans/*) resolve the correct paid plan.
     const handleApiKeySignIn = async (apiKey) => {
-        const datalayerUrl = resolveDatalayerUrl();
+        const iamUrl = resolveIamUrl();
         try {
-            const resp = await fetch(`${datalayerUrl}/api/iam/v1/login`, {
+            const resp = await fetch(`${iamUrl}/api/iam/v1/login`, {
                 method: 'POST',
                 headers: { 'Content-Type': 'application/json' },
                 body: JSON.stringify({ token: apiKey }),

package/lib/chat/Chat.d.ts

@@ -107,5 +107,5 @@ export interface ChatProps extends ChatCommonProps {
  * />
  * ```
  */
-export declare function Chat({ protocol: transport, extensions: _extensions, baseUrl, endpoint: endpointProp, configEndpoint: configEndpointProp, enableConfigQuery: enableConfigQueryProp, wsUrl, agentId, authToken: authTokenProp, placeholder, title, subtitle, brandIcon, autoConnect, streaming: _streaming, onMessageSent: _onMessageSent, onMessageReceived: _onMessageReceived, onDisconnect, onLogout: _onLogout, onCollapsePanel: _onCollapsePanel, className, height, showHeader, showNewChatButton, showClearButton, showModelSelector, showToolsMenu, showInput, disableInputPrompt, overlay, launching, launchingMessage, showSkillsMenu, codemodeEnabled, onToggleCodemode, showTokenUsage, initialModel, availableModels, mcpServers, initialSkills, clearOnMount: _clearOnMount, suggestions, submitOnSuggestionClick, description, headerContent, headerActions, autoFocus, identityProviders, onIdentityConnect, onIdentityDisconnect, runtimeId, historyEndpoint, pendingPrompt, errorBanner, showInformation, chatViewMode, onChatViewModeChange, frontendTools, enableEphemeralNotebook, initialEphemeralNotebookOpen, onEphemeralNotebookOpenChange, enableEphemeralDocument, initialEphemeralSurfaceMode, onEphemeralSurfaceModeChange, collapsed, onExpandFromCollapsed, ephemeralNotebookToolbar, ephemeralNotebookCollaborationProvider, ephemeralNotebookCollaborationDocumentId, ephemeralDocumentCollaboration, ephemeralRuntimeOverride, onToolCallStart, onToolCallComplete, renderToolResult, hideMessagesAfterToolUI, contextSnapshot, mcpStatusData, codemodeStatusData, sandboxStatusData, kernel, kernelIndicatorPlacement, kernelEnvironmentName, kernelCpu, kernelMemory, kernelGpu, themeVariant, colorMode, showToolApprovalBanner, pendingApprovals, onApproveApproval, onRejectApproval, disableInternalJupyterTheme, }: ChatProps): import("react/jsx-runtime").JSX.Element;
+export declare function Chat({ protocol: transport, extensions: _extensions, baseUrl, endpoint: endpointProp, configEndpoint: configEndpointProp, enableConfigQuery: enableConfigQueryProp, wsUrl, agentId, authToken: authTokenProp, placeholder, title, subtitle, brandIcon, autoConnect, streaming: _streaming, onMessageSent: _onMessageSent, onMessageReceived: _onMessageReceived, onDisconnect, onLogout: _onLogout, onCollapsePanel: _onCollapsePanel, className, height, showHeader, showNewChatButton, showClearButton, showModelSelector, showToolsMenu, showInput, disableInputPrompt, overlay, launching, launchingMessage, showSkillsMenu, codemodeEnabled, onToggleCodemode, showTokenUsage, initialModel, availableModels, mcpServers, initialSkills, clearOnMount: _clearOnMount, suggestions, submitOnSuggestionClick, description, headerContent, headerActions, autoFocus, identityProviders, onIdentityConnect, onIdentityDisconnect, runtimeId, historyEndpoint, pendingPrompt, errorBanner, showInformation, chatViewMode, onChatViewModeChange, frontendTools, enableEphemeralNotebook, initialEphemeralNotebookOpen, onEphemeralNotebookOpenChange, enableEphemeralDocument, initialEphemeralSurfaceMode, onEphemeralSurfaceModeChange, collapsed, onExpandFromCollapsed, ephemeralNotebookToolbar, ephemeralNotebookToolbarExtraItems, ephemeralDocumentToolbarExtraItems, ephemeralNotebookCollaborationProvider, ephemeralNotebookCollaborationDocumentId, ephemeralDocumentCollaboration, ephemeralRuntimeOverride, onToolCallStart, onToolCallComplete, renderToolResult, hideMessagesAfterToolUI, contextSnapshot, mcpStatusData, codemodeStatusData, sandboxStatusData, kernel, kernelIndicatorPlacement, kernelEnvironmentName, kernelCpu, kernelMemory, kernelGpu, themeVariant, colorMode, showToolApprovalBanner, pendingApprovals, onApproveApproval, onRejectApproval, disableInternalJupyterTheme, }: ChatProps): import("react/jsx-runtime").JSX.Element;
 export default Chat;

package/lib/chat/Chat.js

@@ -136,7 +136,7 @@ function getProtocolType(protocol) {
  * />
  * ```
  */
-export function Chat({ protocol: transport, extensions: _extensions, baseUrl = 'http://localhost:8765', endpoint: endpointProp, configEndpoint: configEndpointProp, enableConfigQuery: enableConfigQueryProp, wsUrl, agentId, authToken: authTokenProp, placeholder = 'Type your message...', title, subtitle, brandIcon, autoConnect = true, streaming: _streaming = true, onMessageSent: _onMessageSent, onMessageReceived: _onMessageReceived, onDisconnect, onLogout: _onLogout, onCollapsePanel: _onCollapsePanel, className, height = '600px', showHeader = true, showNewChatButton = true, showClearButton = true, showModelSelector = true, showToolsMenu = true, showInput = true, disableInputPrompt = false, overlay, launching = false, launchingMessage, showSkillsMenu = true, codemodeEnabled = false, onToggleCodemode, showTokenUsage = true, initialModel, availableModels, mcpServers, initialSkills, clearOnMount: _clearOnMount = true, suggestions, submitOnSuggestionClick = true, description, headerContent, headerActions, autoFocus = false, identityProviders, onIdentityConnect, onIdentityDisconnect, runtimeId, historyEndpoint, pendingPrompt, errorBanner, showInformation = true, chatViewMode, onChatViewModeChange, frontendTools, enableEphemeralNotebook, initialEphemeralNotebookOpen, onEphemeralNotebookOpenChange, enableEphemeralDocument, initialEphemeralSurfaceMode, onEphemeralSurfaceModeChange, collapsed = false, onExpandFromCollapsed, ephemeralNotebookToolbar, ephemeralNotebookCollaborationProvider, ephemeralNotebookCollaborationDocumentId, ephemeralDocumentCollaboration, ephemeralRuntimeOverride, onToolCallStart, onToolCallComplete, renderToolResult, hideMessagesAfterToolUI = false, contextSnapshot, mcpStatusData, codemodeStatusData, sandboxStatusData, kernel, kernelIndicatorPlacement, kernelEnvironmentName, kernelCpu, kernelMemory, kernelGpu, themeVariant, colorMode, showToolApprovalBanner, pendingApprovals, onApproveApproval, onRejectApproval, disableInternalJupyterTheme = false, }) {
+export function Chat({ protocol: transport, extensions: _extensions, baseUrl = 'http://localhost:8765', endpoint: endpointProp, configEndpoint: configEndpointProp, enableConfigQuery: enableConfigQueryProp, wsUrl, agentId, authToken: authTokenProp, placeholder = 'Type your message...', title, subtitle, brandIcon, autoConnect = true, streaming: _streaming = true, onMessageSent: _onMessageSent, onMessageReceived: _onMessageReceived, onDisconnect, onLogout: _onLogout, onCollapsePanel: _onCollapsePanel, className, height = '600px', showHeader = true, showNewChatButton = true, showClearButton = true, showModelSelector = true, showToolsMenu = true, showInput = true, disableInputPrompt = false, overlay, launching = false, launchingMessage, showSkillsMenu = true, codemodeEnabled = false, onToggleCodemode, showTokenUsage = true, initialModel, availableModels, mcpServers, initialSkills, clearOnMount: _clearOnMount = true, suggestions, submitOnSuggestionClick = true, description, headerContent, headerActions, autoFocus = false, identityProviders, onIdentityConnect, onIdentityDisconnect, runtimeId, historyEndpoint, pendingPrompt, errorBanner, showInformation = true, chatViewMode, onChatViewModeChange, frontendTools, enableEphemeralNotebook, initialEphemeralNotebookOpen, onEphemeralNotebookOpenChange, enableEphemeralDocument, initialEphemeralSurfaceMode, onEphemeralSurfaceModeChange, collapsed = false, onExpandFromCollapsed, ephemeralNotebookToolbar, ephemeralNotebookToolbarExtraItems, ephemeralDocumentToolbarExtraItems, ephemeralNotebookCollaborationProvider, ephemeralNotebookCollaborationDocumentId, ephemeralDocumentCollaboration, ephemeralRuntimeOverride, onToolCallStart, onToolCallComplete, renderToolResult, hideMessagesAfterToolUI = false, contextSnapshot, mcpStatusData, codemodeStatusData, sandboxStatusData, kernel, kernelIndicatorPlacement, kernelEnvironmentName, kernelCpu, kernelMemory, kernelGpu, themeVariant, colorMode, showToolApprovalBanner, pendingApprovals, onApproveApproval, onRejectApproval, disableInternalJupyterTheme = false, }) {
     const resolvedAgentId = typeof agentId === 'string' && agentId.trim().length > 0
         ? agentId.trim()
         : 'default';
@@ -364,6 +364,6 @@ export function Chat({ protocol: transport, extensions: _extensions, baseUrl = '
                                                 ? 'attention.fg'
                                                 : 'danger.fg',
                                             flex: 1,
-                                        }, children: errorBanner.message })] })), _jsx(ChatBase, { title: title, subtitle: subtitle, brandIcon: brandIcon, showHeader: showHeader, protocol: protocolConfig, placeholder: placeholder, description: description, suggestions: suggestions, submitOnSuggestionClick: submitOnSuggestionClick, autoFocus: autoFocus, runtimeId: runtimeId, historyEndpoint: historyEndpoint, pendingPrompt: pendingPrompt, showInformation: showInformation, onInformationClick: handleInformationClick, headerContent: headerContent, headerActions: headerActions, showModelSelector: showModelSelector, showToolsMenu: showToolsMenu, showInput: showInput, disableInputPrompt: disableInputPrompt, overlay: overlay, launching: launching, launchingMessage: launchingMessage, autoConnect: autoConnect, showSkillsMenu: showSkillsMenu, showTokenUsage: showTokenUsage, codemodeEnabled: codemodeEnabled, onToggleCodemode: onToggleCodemode, initialModel: initialModel, availableModels: availableModels, mcpServers: mcpServers, initialSkills: initialSkills, connectedIdentities: identitiesForChat, onNewChat: handleNewChat, onMessagesChange: handleMessagesChange, headerButtons: headerButtons, avatarConfig: avatarConfig, backgroundColor: "canvas.default", focusTrigger: focusTrigger, chatViewMode: chatViewMode, onChatViewModeChange: onChatViewModeChange, frontendTools: frontendTools, enableEphemeralNotebook: enableEphemeralNotebook, initialEphemeralNotebookOpen: initialEphemeralNotebookOpen, onEphemeralNotebookOpenChange: onEphemeralNotebookOpenChange, enableEphemeralDocument: enableEphemeralDocument, initialEphemeralSurfaceMode: initialEphemeralSurfaceMode, onEphemeralSurfaceModeChange: onEphemeralSurfaceModeChange, collapsed: collapsed, onExpandFromCollapsed: onExpandFromCollapsed, ephemeralNotebookToolbar: ephemeralNotebookToolbar, ephemeralNotebookCollaborationProvider: ephemeralNotebookCollaborationProvider, ephemeralNotebookCollaborationDocumentId: ephemeralNotebookCollaborationDocumentId, ephemeralDocumentCollaboration: ephemeralDocumentCollaboration, ephemeralRuntimeOverride: ephemeralRuntimeOverride, onToolCallStart: onToolCallStart, onToolCallComplete: onToolCallComplete, renderToolResult: renderToolResult, hideMessagesAfterToolUI: hideMessagesAfterToolUI, contextSnapshot: contextSnapshot, mcpStatusData: mcpStatusData, sandboxStatusData: sandboxStatusData, kernel: kernel, kernelIndicatorPlacement: kernelIndicatorPlacement, kernelEnvironmentName: kernelEnvironmentName, kernelCpu: kernelCpu, kernelMemory: kernelMemory, kernelGpu: kernelGpu, themeVariant: themeVariant, colorMode: colorMode, showToolApprovalBanner: showToolApprovalBanner, pendingApprovals: pendingApprovals, onApproveApproval: onApproveApproval, onRejectApproval: onRejectApproval, disableInternalJupyterTheme: disableInternalJupyterTheme })] })] }) }) }));
+                                        }, children: errorBanner.message })] })), _jsx(ChatBase, { title: title, subtitle: subtitle, brandIcon: brandIcon, showHeader: showHeader, protocol: protocolConfig, placeholder: placeholder, description: description, suggestions: suggestions, submitOnSuggestionClick: submitOnSuggestionClick, autoFocus: autoFocus, runtimeId: runtimeId, historyEndpoint: historyEndpoint, pendingPrompt: pendingPrompt, showInformation: showInformation, onInformationClick: handleInformationClick, headerContent: headerContent, headerActions: headerActions, showModelSelector: showModelSelector, showToolsMenu: showToolsMenu, showInput: showInput, disableInputPrompt: disableInputPrompt, overlay: overlay, launching: launching, launchingMessage: launchingMessage, autoConnect: autoConnect, showSkillsMenu: showSkillsMenu, showTokenUsage: showTokenUsage, codemodeEnabled: codemodeEnabled, onToggleCodemode: onToggleCodemode, initialModel: initialModel, availableModels: availableModels, mcpServers: mcpServers, initialSkills: initialSkills, connectedIdentities: identitiesForChat, onNewChat: handleNewChat, onMessagesChange: handleMessagesChange, headerButtons: headerButtons, avatarConfig: avatarConfig, backgroundColor: "canvas.default", focusTrigger: focusTrigger, chatViewMode: chatViewMode, onChatViewModeChange: onChatViewModeChange, frontendTools: frontendTools, enableEphemeralNotebook: enableEphemeralNotebook, initialEphemeralNotebookOpen: initialEphemeralNotebookOpen, onEphemeralNotebookOpenChange: onEphemeralNotebookOpenChange, enableEphemeralDocument: enableEphemeralDocument, initialEphemeralSurfaceMode: initialEphemeralSurfaceMode, onEphemeralSurfaceModeChange: onEphemeralSurfaceModeChange, collapsed: collapsed, onExpandFromCollapsed: onExpandFromCollapsed, ephemeralNotebookToolbar: ephemeralNotebookToolbar, ephemeralNotebookToolbarExtraItems: ephemeralNotebookToolbarExtraItems, ephemeralDocumentToolbarExtraItems: ephemeralDocumentToolbarExtraItems, ephemeralNotebookCollaborationProvider: ephemeralNotebookCollaborationProvider, ephemeralNotebookCollaborationDocumentId: ephemeralNotebookCollaborationDocumentId, ephemeralDocumentCollaboration: ephemeralDocumentCollaboration, ephemeralRuntimeOverride: ephemeralRuntimeOverride, onToolCallStart: onToolCallStart, onToolCallComplete: onToolCallComplete, renderToolResult: renderToolResult, hideMessagesAfterToolUI: hideMessagesAfterToolUI, contextSnapshot: contextSnapshot, mcpStatusData: mcpStatusData, sandboxStatusData: sandboxStatusData, kernel: kernel, kernelIndicatorPlacement: kernelIndicatorPlacement, kernelEnvironmentName: kernelEnvironmentName, kernelCpu: kernelCpu, kernelMemory: kernelMemory, kernelGpu: kernelGpu, themeVariant: themeVariant, colorMode: colorMode, showToolApprovalBanner: showToolApprovalBanner, pendingApprovals: pendingApprovals, onApproveApproval: onApproveApproval, onRejectApproval: onRejectApproval, disableInternalJupyterTheme: disableInternalJupyterTheme })] })] }) }) }));
 }
 export default Chat;

package/lib/chat/base/ChatBase.js

@@ -58,6 +58,28 @@ const sentPendingPromptKeys = new Set();
  * ephemeral notebook/document is not yet ready. Shown in place of the surface
  * content (never as an overlay) so structure appears as early as possible.
  */
+/**
+ * Whether a frontend tool declares any parameter.
+ *
+ * The empty-args guard around execution exists for AG-UI, which emits a
+ * first tool-call with `{}` and the real arguments in a later update. A
+ * tool that declares no parameters never gets that update — `{}` IS its
+ * full argument set — so waiting on it left the call executing forever.
+ */
+function frontendToolExpectsArgs(tool) {
+    const parameters = tool?.parameters;
+    if (!parameters) {
+        return false;
+    }
+    if (Array.isArray(parameters)) {
+        return parameters.length > 0;
+    }
+    const properties = parameters.properties;
+    if (properties && typeof properties === 'object') {
+        return Object.keys(properties).length > 0;
+    }
+    return Object.keys(parameters).length > 0;
+}
 function CompanionSurfaceSkeleton({ mode }) {
     return (_jsx(Box, { "aria-label": mode === 'notebook' ? 'Preparing notebook…' : 'Preparing document…', sx: {
             flex: 1,
@@ -474,7 +496,7 @@ function ChatBaseInner({ title, subtitle, showHeader = false, showTokenUsage = t
 // Mode selection
 useStore: useStoreMode = true, protocol: protocolRaw, onSendMessage, enableStreaming = false, 
 // Extended props
-brandIcon, avatarConfig, headerButtons, showPoweredBy = false, poweredByProps, emptyState, renderToolResult, footerContent, showInformation = false, onInformationClick, headerContent, children, borderRadius, backgroundColor, border, boxShadow, compact = false, placeholder, description = 'Start a conversation with the AI agent.', onStateUpdate, onNewChat, onClear, onMessagesChange, autoFocus = false, suggestions, submitOnSuggestionClick = true, hideMessagesAfterToolUI = false, focusTrigger, frontendTools: frontendToolsProp, enableEphemeralNotebook = false, initialEphemeralNotebookOpen = true, onEphemeralNotebookOpenChange, enableEphemeralDocument = false, initialEphemeralSurfaceMode, onEphemeralSurfaceModeChange, collapsed = false, onExpandFromCollapsed, ephemeralNotebookToolbar, ephemeralNotebookCollaborationProvider, ephemeralNotebookCollaborationDocumentId, ephemeralDocumentCollaboration, ephemeralRuntimeOverride, 
+brandIcon, avatarConfig, headerButtons, showPoweredBy = false, poweredByProps, emptyState, renderToolResult, footerContent, showInformation = false, onInformationClick, headerContent, children, borderRadius, backgroundColor, border, boxShadow, compact = false, placeholder, description = 'Start a conversation with the AI agent.', onStateUpdate, onNewChat, onClear, onMessagesChange, autoFocus = false, suggestions, submitOnSuggestionClick = true, hideMessagesAfterToolUI = false, focusTrigger, frontendTools: frontendToolsProp, enableEphemeralNotebook = false, initialEphemeralNotebookOpen = true, onEphemeralNotebookOpenChange, enableEphemeralDocument = false, initialEphemeralSurfaceMode, onEphemeralSurfaceModeChange, collapsed = false, onExpandFromCollapsed, ephemeralNotebookToolbar, ephemeralNotebookToolbarExtraItems, ephemeralDocumentToolbarExtraItems, ephemeralNotebookCollaborationProvider, ephemeralNotebookCollaborationDocumentId, ephemeralDocumentCollaboration, ephemeralRuntimeOverride, 
 // Tool invocation hooks
 onToolCallStart, onToolCallComplete, 
 // Identity/Authorization props
@@ -2011,6 +2033,14 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
                         const toolCallId = event.toolCall.toolCallId || generateMessageId();
                         const toolName = event.toolCall.toolName;
                         const args = event.toolCall.args || {};
+                        /*
+                         * Whether these args are the full set, as the protocol tells it.
+                         * Vercel's tool event is terminal — `{}` is an answer there,
+                         * legal for a tool whose parameters are all optional. AG-UI
+                         * streams the args after a first empty event and says so with
+                         * `false`. Without the flag, the old heuristics decide.
+                         */
+                        const argsComplete = event.toolCall.argsComplete;
                         if (toolCallsRef.current.has(toolCallId)) {
                             const existingToolCall = toolCallsRef.current.get(toolCallId);
                             if (existingToolCall) {
@@ -2026,7 +2056,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
                                 const toolHandler = frontendTool?.handler;
                                 if (toolHandler &&
                                     existingToolCall.status === 'executing' &&
-                                    Object.keys(args).length > 0) {
+                                    (argsComplete ?? Object.keys(args).length > 0)) {
                                     pendingToolExecutionsRef.current++;
                                     executeFrontendTool(toolHandler, updatedToolCall, toolCallId);
                                 }
@@ -2051,12 +2081,17 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
                             });
                             const frontendTool = frontendToolsRef.current?.find(t => t.name === toolName);
                             const toolHandler = frontendTool?.handler;
-                            // Only execute when we have actual args. AG-UI emits an
-                            // initial tool-call with empty args on TOOL_CALL_START;
-                            // the real args arrive on TOOL_CALL_END. Skip execution
-                            // here and let the update branch (above) handle it once
-                            // the full args are available.
-                            if (toolHandler && Object.keys(args).length > 0) {
+                            // Execute when the args are complete. The protocol says so
+                            // when it can (`argsComplete`); without the flag, fall back
+                            // to the old heuristics — actual args present, or a tool
+                            // that declares no parameters, for which `{}` is the full
+                            // set and no update is ever coming. A protocol that streams
+                            // its args (AG-UI start) says `false` and the update branch
+                            // above executes once the full set has arrived.
+                            if (toolHandler &&
+                                (argsComplete ??
+                                    (Object.keys(args).length > 0 ||
+                                        !frontendToolExpectsArgs(frontendTool)))) {
                                 pendingToolExecutionsRef.current++;
                                 executeFrontendTool(toolHandler, toolCallMsg, toolCallId);
                             }
@@ -2937,7 +2972,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
                                         borderRight: '1px solid',
                                         borderColor: 'border.default',
                                     }),
-                        }, children: launching || overlay ? (_jsx(CompanionSurfaceSkeleton, { mode: notebookVisible ? 'notebook' : 'document' })) : notebookVisible ? (_jsx(EphemeralNotebook, { notebookId: ephemeralNotebookId, runtimePodName: runtimeId || activeAgentId, runtimeOverride: ephemeralRuntimeOverride, themeVariant: themeVariant, colorMode: colorMode, nbformat: persistedEphemeralNbformat ?? undefined, onNbformatChange: handleEphemeralNotebookChange, toolbarComponent: ephemeralNotebookToolbar, collaborationProvider: ephemeralNotebookCollaborationProvider })) : (_jsx(React.Suspense, { fallback: null, children: _jsx(EphemeralDocument, { documentId: ephemeralDocumentId, runtimePodName: runtimeId || activeAgentId, runtimeOverride: ephemeralRuntimeOverride, themeVariant: themeVariant, colorMode: colorMode, content: persistedEphemeralDocument ?? undefined, onContentChange: handleEphemeralDocumentChange, onToolsReady: handleDocumentToolsReady, onKernelChange: handleDocumentKernelChange, collaboration: ephemeralDocumentCollaboration }) })) }), !surfaceCollapsed && (_jsxs(Box, { sx: surfaceChatFloating
+                        }, children: launching || overlay ? (_jsx(CompanionSurfaceSkeleton, { mode: notebookVisible ? 'notebook' : 'document' })) : notebookVisible ? (_jsx(EphemeralNotebook, { notebookId: ephemeralNotebookId, runtimePodName: runtimeId || activeAgentId, runtimeOverride: ephemeralRuntimeOverride, themeVariant: themeVariant, colorMode: colorMode, nbformat: persistedEphemeralNbformat ?? undefined, onNbformatChange: handleEphemeralNotebookChange, toolbarComponent: ephemeralNotebookToolbar, toolbarExtraItems: ephemeralNotebookToolbarExtraItems, collaborationProvider: ephemeralNotebookCollaborationProvider })) : (_jsx(React.Suspense, { fallback: null, children: _jsx(EphemeralDocument, { documentId: ephemeralDocumentId, runtimePodName: runtimeId || activeAgentId, runtimeOverride: ephemeralRuntimeOverride, themeVariant: themeVariant, colorMode: colorMode, content: persistedEphemeralDocument ?? undefined, onContentChange: handleEphemeralDocumentChange, onToolsReady: handleDocumentToolsReady, onKernelChange: handleDocumentKernelChange, collaboration: ephemeralDocumentCollaboration, toolbarExtraItems: ephemeralDocumentToolbarExtraItems }) })) }), !surfaceCollapsed && (_jsxs(Box, { sx: surfaceChatFloating
                             ? {
                                 position: 'absolute',
                                 right: 16,

package/lib/chat/document/EphemeralDocument.d.ts

@@ -1,4 +1,5 @@
 import type { IKernelConnection } from '@jupyterlab/services/lib/kernel/kernel';
+import { type ToolbarItem } from '@datalayer/primer-addons';
 import type { FrontendToolDefinition } from '../../types/tools';
 import type { EphemeralRuntimeOverride } from '../notebook/EphemeralNotebook';
 import '@datalayer/jupyter-react/lib/css/PrismCss';
@@ -63,9 +64,19 @@ export interface EphemeralDocumentProps {
      * local memory.
      */
     collaboration?: EphemeralDocumentCollaboration;
+    /**
+     * Items added to the toolbar of the document.
+     *
+     * The Lexical toolbar merges them with its own and orders the whole by the
+     * `order` of each item, so a host adds what the document itself knows
+     * nothing about — the status of the sandbox it runs on, a selector to
+     * change it — the same way the notebook surface does through the
+     * `extraItems` of its toolbar.
+     */
+    toolbarExtraItems?: ToolbarItem[];
 }
 /**
  * Renders an in-memory Lexical document backed by a sandbox kernel.
  */
-export declare function EphemeralDocument({ documentId, runtimePodName, runtimeOverride, themeVariant, colorMode, content, onContentChange, onToolsReady, onKernelChange, collaboration, }: EphemeralDocumentProps): import("react/jsx-runtime").JSX.Element;
+export declare function EphemeralDocument({ documentId, runtimePodName, runtimeOverride, themeVariant, colorMode, content, onContentChange, onToolsReady, onKernelChange, collaboration, toolbarExtraItems, }: EphemeralDocumentProps): import("react/jsx-runtime").JSX.Element;
 export default EphemeralDocument;

package/lib/chat/document/EphemeralDocument.js

@@ -100,15 +100,15 @@ function CodeHighlightPlugin() {
  * the active editor from the Lexical composer context and drives the shared
  * {@link ToolbarPlugin} (block type, formatting, insert menu, …).
  */
-function DocumentToolbar({ setIsLinkEditMode, }) {
+function DocumentToolbar({ setIsLinkEditMode, extraItems, }) {
     const [editor] = useLexicalComposerContext();
     const [activeEditor, setActiveEditor] = useState(editor);
-    return (_jsx(ToolbarPlugin, { editor: editor, activeEditor: activeEditor, setActiveEditor: setActiveEditor, setIsLinkEditMode: setIsLinkEditMode }));
+    return (_jsx(ToolbarPlugin, { editor: editor, activeEditor: activeEditor, setActiveEditor: setActiveEditor, setIsLinkEditMode: setIsLinkEditMode, extraItems: extraItems }));
 }
 /**
  * Renders an in-memory Lexical document backed by a sandbox kernel.
  */
-export function EphemeralDocument({ documentId, runtimePodName, runtimeOverride, themeVariant, colorMode, content, onContentChange, onToolsReady, onKernelChange, collaboration, }) {
+export function EphemeralDocument({ documentId, runtimePodName, runtimeOverride, themeVariant, colorMode, content, onContentChange, onToolsReady, onKernelChange, collaboration, toolbarExtraItems, }) {
     // Real-time collaboration is active only when both a WebSocket endpoint and a
     // room id are supplied. In that mode the shared Loro CRDT is the single source
     // of truth: local content-seeding and undo history are disabled so the local
@@ -384,7 +384,7 @@ export function EphemeralDocument({ documentId, runtimePodName, runtimeOverride,
                         '& [role="toolbar"][aria-label="Editor toolbar"]': {
                             backgroundColor: themeBackground,
                         },
-                    }, children: _jsx(LexicalConfigProvider, { lexicalId: documentId, serviceManager: activeServiceManager, children: _jsx(LexicalComposer, { initialConfig: initialConfig, children: _jsx(CommentsProvider, { children: _jsx(ToolbarContext, { children: _jsxs("div", { className: "editor-shell", children: [_jsx(DocumentToolbar, { setIsLinkEditMode: setIsLinkEditMode }), _jsx("div", { className: "editor-container", children: _jsxs("div", { className: "editor-inner", children: [isCollaborative && collaboration ? (_jsx(LoroCollaborationPlugin, { id: collaboration.roomId, providerFactory: createWebsocketProvider, websocketUrl: collaboration.websocketUrl, shouldBootstrap: true, showCollaborators: true, username: collaborationName, cursorColor: collaborationColor, awarenessData: collaborationAwarenessData })) : null, _jsx(LexicalStatePlugin, {}), _jsx(RichTextPlugin, { contentEditable: _jsx("div", { className: "editor-scroller", children: _jsx("div", { className: "editor", ref: onAnchorRef, children: _jsx(ContentEditable, { className: "editor-input", "aria-label": "Ephemeral document editor" }) }) }), ErrorBoundary: LexicalErrorBoundary }), !isCollaborative && (_jsx(OnChangePlugin, { onChange: handleChange })), !isCollaborative && _jsx(HistoryPlugin, {}), _jsx(AutoFocusPlugin, {}), _jsx(ListPlugin, {}), _jsx(CheckListPlugin, {}), _jsx(LinkPlugin, {}), _jsx(AutoLinkPlugin, {}), _jsx(ListMaxIndentLevelPlugin, { maxDepth: 7 }), _jsx(MarkdownShortcutPlugin, { transformers: TRANSFORMERS }), !isCollaborative && (_jsx(LoadContentPlugin, { content: initialContent })), _jsx(CodeHighlightPlugin, {}), _jsx(ImagesPlugin, { captionsEnabled: false }), _jsx(ExcalidrawPlugin, {}), _jsx(TablePlugin, {}), _jsx(TableCellResizerPlugin, {}), _jsx(TableActionMenuPlugin, {}), _jsx(TableHoverActionsV2Plugin, {}), _jsx(CollapsiblePlugin, {}), _jsx(HorizontalRulePlugin, {}), _jsx(EquationsPlugin, {}), _jsx(YouTubePlugin, {}), _jsx(AutoEmbedPlugin, {}), _jsx(JupyterCellPlugin, {}), _jsx(ComponentPickerMenuPlugin, { kernel: documentKernel }), _jsx(JupyterInputOutputPlugin, { kernel: documentKernel }), floatingAnchorElem && (_jsxs(_Fragment, { children: [_jsx(DraggableBlockPlugin, { anchorElem: floatingAnchorElem }), _jsx(FloatingTextFormatToolbarPlugin, { anchorElem: floatingAnchorElem, setIsLinkEditMode: setIsLinkEditMode }), _jsx(CodeActionMenuPlugin, { anchorElem: floatingAnchorElem })] }))] }) })] }) }) }) }) }) }) }) })) : isRuntimeStarting ? (_jsxs(Box, { sx: {
+                    }, children: _jsx(LexicalConfigProvider, { lexicalId: documentId, serviceManager: activeServiceManager, children: _jsx(LexicalComposer, { initialConfig: initialConfig, children: _jsx(CommentsProvider, { children: _jsx(ToolbarContext, { children: _jsxs("div", { className: "editor-shell", children: [_jsx(DocumentToolbar, { setIsLinkEditMode: setIsLinkEditMode, extraItems: toolbarExtraItems }), _jsx("div", { className: "editor-container", children: _jsxs("div", { className: "editor-inner", children: [isCollaborative && collaboration ? (_jsx(LoroCollaborationPlugin, { id: collaboration.roomId, providerFactory: createWebsocketProvider, websocketUrl: collaboration.websocketUrl, shouldBootstrap: true, showCollaborators: true, username: collaborationName, cursorColor: collaborationColor, awarenessData: collaborationAwarenessData })) : null, _jsx(LexicalStatePlugin, {}), _jsx(RichTextPlugin, { contentEditable: _jsx("div", { className: "editor-scroller", children: _jsx("div", { className: "editor", ref: onAnchorRef, children: _jsx(ContentEditable, { className: "editor-input", "aria-label": "Ephemeral document editor" }) }) }), ErrorBoundary: LexicalErrorBoundary }), !isCollaborative && (_jsx(OnChangePlugin, { onChange: handleChange })), !isCollaborative && _jsx(HistoryPlugin, {}), _jsx(AutoFocusPlugin, {}), _jsx(ListPlugin, {}), _jsx(CheckListPlugin, {}), _jsx(LinkPlugin, {}), _jsx(AutoLinkPlugin, {}), _jsx(ListMaxIndentLevelPlugin, { maxDepth: 7 }), _jsx(MarkdownShortcutPlugin, { transformers: TRANSFORMERS }), !isCollaborative && (_jsx(LoadContentPlugin, { content: initialContent })), _jsx(CodeHighlightPlugin, {}), _jsx(ImagesPlugin, { captionsEnabled: false }), _jsx(ExcalidrawPlugin, {}), _jsx(TablePlugin, {}), _jsx(TableCellResizerPlugin, {}), _jsx(TableActionMenuPlugin, {}), _jsx(TableHoverActionsV2Plugin, {}), _jsx(CollapsiblePlugin, {}), _jsx(HorizontalRulePlugin, {}), _jsx(EquationsPlugin, {}), _jsx(YouTubePlugin, {}), _jsx(AutoEmbedPlugin, {}), _jsx(JupyterCellPlugin, {}), _jsx(ComponentPickerMenuPlugin, { kernel: documentKernel }), _jsx(JupyterInputOutputPlugin, { kernel: documentKernel }), floatingAnchorElem && (_jsxs(_Fragment, { children: [_jsx(DraggableBlockPlugin, { anchorElem: floatingAnchorElem }), _jsx(FloatingTextFormatToolbarPlugin, { anchorElem: floatingAnchorElem, setIsLinkEditMode: setIsLinkEditMode }), _jsx(CodeActionMenuPlugin, { anchorElem: floatingAnchorElem })] }))] }) })] }) }) }) }) }) }) }) })) : isRuntimeStarting ? (_jsxs(Box, { sx: {
                 height: '100%',
                 display: 'flex',
                 alignItems: 'center',

package/lib/chat/notebook/EphemeralNotebook.d.ts

@@ -1,4 +1,5 @@
 import type { INotebookContent } from '@jupyterlab/nbformat';
+import { type ToolbarItem } from '@datalayer/primer-addons';
 import type { ICollaborationProvider } from '@datalayer/jupyter-react';
 import type { EphemeralNotebookToolbarComponent } from '../../types/chat';
 /**
@@ -43,6 +44,15 @@ export interface EphemeralNotebookProps {
     onNbformatChange?: (content: INotebookContent) => void;
     /** Optional toolbar component override. */
     toolbarComponent?: EphemeralNotebookToolbarComponent;
+    /**
+     * Items added to the toolbar of the notebook.
+     *
+     * The notebook toolbar merges them with its own and orders the whole by the
+     * `order` of each item, so a host adds what the notebook itself knows
+     * nothing about — the status of the sandbox it runs on, a selector to
+     * change it — without replacing the toolbar through `toolbarComponent`.
+     */
+    toolbarExtraItems?: ToolbarItem[];
     /** Optional theme variant override from host chat context. */
     themeVariant?: string;
     /** Optional color mode override from host chat context. */
@@ -59,5 +69,5 @@ export interface EphemeralNotebookProps {
 /**
  * Renders an in-memory notebook backed by a sandbox kernel.
  */
-export declare function EphemeralNotebook({ notebookId, runtimePodName, runtimeOverride, cellSidebarMargin, nbformat, onNbformatChange, toolbarComponent, themeVariant, colorMode, collaborationProvider, }: EphemeralNotebookProps): import("react/jsx-runtime").JSX.Element;
+export declare function EphemeralNotebook({ notebookId, runtimePodName, runtimeOverride, cellSidebarMargin, nbformat, onNbformatChange, toolbarComponent, toolbarExtraItems, themeVariant, colorMode, collaborationProvider, }: EphemeralNotebookProps): import("react/jsx-runtime").JSX.Element;
 export default EphemeralNotebook;

package/lib/chat/notebook/EphemeralNotebook.js

@@ -55,7 +55,7 @@ const EPHEMERAL_NOTEBOOK_CONTENT = {
 /**
  * Renders an in-memory notebook backed by a sandbox kernel.
  */
-export function EphemeralNotebook({ notebookId, runtimePodName, runtimeOverride, cellSidebarMargin = 120, nbformat, onNbformatChange, toolbarComponent, themeVariant, colorMode, collaborationProvider, }) {
+export function EphemeralNotebook({ notebookId, runtimePodName, runtimeOverride, cellSidebarMargin = 120, nbformat, onNbformatChange, toolbarComponent, toolbarExtraItems, themeVariant, colorMode, collaborationProvider, }) {
     // The `nbformat` passed to the `Notebook` component MUST stay a stable
     // reference for the lifetime of a given `notebookId`: the underlying
     // `useNotebookModel` hook rebuilds the notebook model (and its context /
@@ -188,7 +188,18 @@ export function EphemeralNotebook({ notebookId, runtimePodName, runtimeOverride,
     const activeServiceManager = runtimeServiceManager;
     const activeKernelId = runtimeKernelId;
     const activeStartDefaultKernel = runtimeStartDefaultKernel;
-    const ToolbarComponent = toolbarComponent || NotebookToolbar;
+    // The toolbar of the notebook, with the items of the host merged in. A host
+    // replacing the toolbar altogether receives them as well, as every toolbar
+    // built on the notebook one takes `extraItems`.
+    const ToolbarComponent = useMemo(() => {
+        const Base = toolbarComponent || NotebookToolbar;
+        if (!toolbarExtraItems?.length) {
+            return Base;
+        }
+        return function EphemeralNotebookToolbar(props) {
+            return _jsx(Base, { ...props, extraItems: toolbarExtraItems });
+        };
+    }, [toolbarComponent, toolbarExtraItems]);
     const isRuntimeStarting = Boolean((String(runtimePodName || '').trim() ||
         String(runtimeOverride?.baseUrl || '').trim()) &&
         !activeServiceManager);

package/lib/collaboration/DatalayerCollaborationProvider.d.ts

@@ -15,7 +15,7 @@ export interface IDatalayerCollaborationConfig {
     /**
      * Base URL for the Datalayer server (optional, uses config from store if not provided).
      */
-    datalayerUrl?: string;
+    spacerUrl?: string;
     /**
      * Authentication token (optional, uses config from store if not provided).
      */

package/lib/collaboration/DatalayerCollaborationProvider.js

@@ -60,17 +60,17 @@ export class DatalayerCollaborationProvider {
         }
         this.setStatus(CollaborationStatus.Connecting);
         try {
-            const datalayerUrl = this._config.datalayerUrl;
+            const spacerUrl = this._config.spacerUrl;
             const token = this._config.token;
-            if (!datalayerUrl) {
-                throw new Error('Datalayer datalayerUrl is not configured - must be explicitly provided in DatalayerCollaborationProvider config');
+            if (!spacerUrl) {
+                throw new Error('The Datalayer spacerUrl is not configured - it must be explicitly provided in the DatalayerCollaborationProvider config');
             }
             if (!token) {
                 throw new Error('Datalayer token is not configured - must be explicitly provided in DatalayerCollaborationProvider config');
             }
             const { ydoc, awareness } = sharedModel;
-            const documentURL = URLExt.join(datalayerUrl, '/api/spacer/v1/documents');
-            const wsUrl = URLExt.join(datalayerUrl, '/api/spacer/v1/documents/ws').replace(/^http/, 'ws');
+            const documentURL = URLExt.join(spacerUrl, '/api/spacer/v1/documents');
+            const wsUrl = URLExt.join(spacerUrl, '/api/spacer/v1/documents/ws').replace(/^http/, 'ws');
             const sessionId = await requestDatalayerCollaborationSessionId({
                 url: URLExt.join(documentURL, documentId),
                 token,

package/lib/components/agents/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * What an agent shows of itself.
+ *
+ * @module components/agents
+ */
+export * from './AgentSummary';

package/lib/components/{students → agents}/index.js

@@ -2,4 +2,9 @@
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-export * from './StudentItemStatus';
+/**
+ * What an agent shows of itself.
+ *
+ * @module components/agents
+ */
+export * from './AgentSummary';

package/lib/components/{NotificationEventCard.js → cards/NotificationEventCard.js}

@@ -9,7 +9,7 @@ import { Box } from '@datalayer/primer-addons';
 import { ChevronDownIcon, DownloadIcon, EyeClosedIcon, EyeIcon, TrashIcon, } from '@primer/octicons-react';
 import { createMarkdownDownloadPayload, downloadTextPayload, formatDurationMs, formatRelativeTime, } from '@datalayer/core/lib/utils';
 import { Streamdown } from 'streamdown';
-import { streamdownMarkdownStyles } from '../chat/styles/streamdownStyles';
+import { streamdownMarkdownStyles } from '../../chat/styles/streamdownStyles';
 const EVENT_KIND_VARIANT = {
     'agent-start-requested': 'attention',
     'agent-assigned': 'accent',

package/lib/components/{OutputCard.js → cards/OutputCard.js}

@@ -9,7 +9,7 @@ import { Box } from '@datalayer/primer-addons';
 import { ChevronDownIcon, DownloadIcon, EyeClosedIcon, EyeIcon, TrashIcon, } from '@primer/octicons-react';
 import { createMarkdownDownloadPayload, downloadTextPayload, formatDurationMs, formatRelativeTime, } from '@datalayer/core/lib/utils';
 import { Streamdown } from 'streamdown';
-import { streamdownMarkdownStyles } from '../chat/styles/streamdownStyles';
+import { streamdownMarkdownStyles } from '../../chat/styles/streamdownStyles';
 export function OutputCard({ event, onToggleRead, onDelete, onOpenAgent, }) {
     const [isOutputExpanded, setIsOutputExpanded] = useState(false);
     const outputText = event.kind === 'agent-output' && event.payload?.outputs

package/lib/components/cards/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The cards an agent run is read through: the notifications it emitted, the
+ * outputs it produced, and the tool calls waiting for an approval.
+ *
+ * @module components/cards
+ */
+export * from './NotificationEventCard';
+export * from './OutputCard';
+export * from './ToolApprovalCard';

package/lib/components/cards/index.js

@@ -0,0 +1,13 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * The cards an agent run is read through: the notifications it emitted, the
+ * outputs it produced, and the tool calls waiting for an approval.
+ *
+ * @module components/cards
+ */
+export * from './NotificationEventCard';
+export * from './OutputCard';
+export * from './ToolApprovalCard';

package/lib/components/{runtimes/RuntimeCellVariables.d.ts → code-sandboxes/CodeSandboxCellVariables.d.ts}

@@ -1,6 +1,6 @@
 import { ITranslator } from '@jupyterlab/translation';
 /**
- * {@link RuntimeCellVariables} properties
+ * {@link CodeSandboxCellVariables} properties
  */
 interface IRuntimeCellVariablesProps {
     /**
@@ -35,5 +35,5 @@ interface IRuntimeCellVariablesProps {
 /**
  * Runtime Cell Variables Picker.
  */
-export declare function RuntimeCellVariables(props: IRuntimeCellVariablesProps): JSX.Element;
-export default RuntimeCellVariables;
+export declare function CodeSandboxCellVariables(props: IRuntimeCellVariablesProps): JSX.Element;
+export default CodeSandboxCellVariables;

package/lib/components/{runtimes/RuntimeCellVariables.js → code-sandboxes/CodeSandboxCellVariables.js}

@@ -11,7 +11,7 @@ import { Box } from '@datalayer/primer-addons';
 /**
  * Runtime Cell Variables Picker.
  */
-export function RuntimeCellVariables(props) {
+export function CodeSandboxCellVariables(props) {
     const { getInputOptions, getOutputOptions, inputs, output, setInputs, setOutput, translator, } = props;
     const trans = useMemo(() => (translator ?? nullTranslator).load('jupyterlab'), [translator]);
     const inputForOutputRef = useRef(null);
@@ -169,4 +169,4 @@ export function RuntimeCellVariables(props) {
                                         .filter(item => item.selected)
                                         .map(item => item.id), onSelectedChange: onSelectedInputsChange, "aria-labelledby": "cell-input-variables", selectionVariant: "multiple", emptyStateText: trans.__('No available variables.'), loading: inputLoading }) })] })] }), _jsxs(FormControl, { children: [_jsx(FormControl.Label, { id: "cell-output-variables", children: trans.__('Output') }), _jsxs(Autocomplete, { children: [_jsx(Autocomplete.Input, { ref: inputForOutputRef, value: output, onChange: onOutputChange }), _jsx(Autocomplete.Overlay, { children: _jsx(Autocomplete.Menu, { items: outputsState ?? [], selectedItemIds: output ? [output] : [], "aria-labelledby": "cell-output-variables", loading: getOutputOptions && !outputsState, emptyStateText: trans.__('Not among the available variables.'), onOpenChange: handleOutputMenuOpenChange }) })] })] })] }));
 }
-export default RuntimeCellVariables;
+export default CodeSandboxCellVariables;

package/lib/components/{runtimes/RuntimeCellVariablesDialog.d.ts → code-sandboxes/CodeSandboxCellVariablesDialog.d.ts}

@@ -2,9 +2,9 @@ import { ISessionContext } from '@jupyterlab/apputils';
 import { CodeCellModel } from '@jupyterlab/cells';
 import { ITranslator } from '@jupyterlab/translation';
 /**
- * {@link RuntimeCellVariablesDialog} properties
+ * {@link CodeSandboxCellVariablesDialog} properties
  */
-export interface IRuntimeCellVariablesDialogProps {
+export interface ICodeSandboxCellVariablesDialogProps {
     /**
      * Code cell model
      */
@@ -33,5 +33,5 @@ export interface IRuntimeCellVariablesDialogProps {
 /**
  * Dialog to define the runtime cell variables to transfer
  */
-export declare function RuntimeCellVariablesDialog(props: IRuntimeCellVariablesDialogProps): JSX.Element;
-export default RuntimeCellVariablesDialog;
+export declare function CodeSandboxCellVariablesDialog(props: ICodeSandboxCellVariablesDialogProps): JSX.Element;
+export default CodeSandboxCellVariablesDialog;

package/lib/components/{runtimes/RuntimeCellVariablesDialog.js → code-sandboxes/CodeSandboxCellVariablesDialog.js}

@@ -9,11 +9,11 @@ import { nullTranslator } from '@jupyterlab/translation';
 import { JSONExt } from '@lumino/coreutils';
 import { KernelExecutor } from '@datalayer/jupyter-react';
 import { RuntimeSnippetsFacade } from '../../jupyter';
-import { RuntimeCellVariables } from './RuntimeCellVariables';
+import { CodeSandboxCellVariables } from './CodeSandboxCellVariables';
 /**
  * Dialog to define the runtime cell variables to transfer
  */
-export function RuntimeCellVariablesDialog(props) {
+export function CodeSandboxCellVariablesDialog(props) {
     const { onClose, model, preference, sessionContext, translator } = props;
     const [inputs, setInputs] = useState([]);
     const [output, setOutput] = useState();
@@ -96,6 +96,6 @@ export function RuntimeCellVariablesDialog(props) {
                 onClick: setVariables,
                 autoFocus: true,
             },
-        ], children: _jsx(RuntimeCellVariables, { inputs: inputs, getInputOptions: sessionContext ? getInputCandidates : undefined, setInputs: setInputs, output: output ?? undefined, getOutputOptions: getOutputCandidates, setOutput: setOutput, translator: translator }) }));
+        ], children: _jsx(CodeSandboxCellVariables, { inputs: inputs, getInputOptions: sessionContext ? getInputCandidates : undefined, setInputs: setInputs, output: output ?? undefined, getOutputOptions: getOutputCandidates, setOutput: setOutput, translator: translator }) }));
 }
-export default RuntimeCellVariablesDialog;
+export default CodeSandboxCellVariablesDialog;

package/lib/components/{runtimes/RuntimeLauncherDialog.d.ts → code-sandboxes/CodeSandboxLauncher.d.ts}

@@ -2,9 +2,9 @@ import type { IMarkdownParser, IRenderMime } from '@jupyterlab/rendermime';
 import type { IRemoteServicesManager } from '../../runtimes';
 import type { ICodeSandboxSnapshot, IRuntimeDesc } from '../../models';
 /**
- * {@link RuntimeLauncherDialog} properties.
+ * {@link CodeSandboxLauncher} properties.
  */
-export interface IRuntimeLauncherDialogProps {
+export interface ICodeSandboxLauncherProps {
     /**
      * Dialog title
      */
@@ -52,6 +52,6 @@ export interface IRuntimeLauncherDialogProps {
     submitLabel?: string;
 }
 /**
- * Start Runtime Launcher Dialog.
+ * The launcher of a new code sandbox.
  */
-export declare function RuntimeLauncherDialog(props: IRuntimeLauncherDialogProps): JSX.Element;
+export declare function CodeSandboxLauncher(props: ICodeSandboxLauncherProps): JSX.Element;