@datalayer/agent-runtimes 1.0.20 → 1.0.25

package/lib/examples/AgentOtelExample.js

@@ -13,8 +13,8 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  * list and launched on demand.
  *
  * The OTEL backend is configured via `configuration.otelUrl` when available
- * (falling back to `configuration.datalayerUrl`, then `VITE_OTEL_BASE_URL`, then
- * `VITE_DATALAYER_URL`, then the resolved runtime base URL).
+ * (falling back to `configuration.otelUrl`, then `VITE_OTEL_BASE_URL`, then
+ * `VITE_DATALAYER_OTEL_URL`, then the resolved runtime base URL).
  * Agent routes resolve from the shared local/cloud runtime target hook.
  *
  * For Python-side observability, wire in `agent_runtimes/otel.py`:
@@ -37,7 +37,7 @@ const OTEL_BASE_URL_ENV = import.meta.env.VITE_OTEL_BASE_URL ?? '';
 // Consume-side OTEL override (DATALAYER_OTEL_IN_URL). When set, telemetry is
 // read from here instead of VITE_OTEL_BASE_URL (e.g. prod during local dev).
 const OTEL_IN_BASE_URL_ENV = import.meta.env.VITE_OTEL_IN_BASE_URL ?? '';
-const DATALAYER_URL_ENV = import.meta.env.VITE_DATALAYER_URL ?? '';
+const OTEL_URL_ENV = import.meta.env.VITE_DATALAYER_OTEL_URL ?? '';
 const DEFAULT_AGENT_PROTOCOL = 'vercel-ai';
 const DEFAULT_AGENT_LIBRARY = 'pydantic-ai';
 /** Spec id this example always launches. */
@@ -138,9 +138,9 @@ const AgentOtelExampleInner = ({ token }) => {
     const resolvedUrl = configuration?.otelInUrl ||
         OTEL_IN_BASE_URL_ENV ||
         configuration?.otelUrl ||
-        configuration?.datalayerUrl ||
+        configuration?.otelUrl ||
         OTEL_BASE_URL_ENV ||
-        DATALAYER_URL_ENV ||
+        OTEL_URL_ENV ||
         agentBaseUrl;
     const otelBaseUrl = resolvedUrl;
     // ── OTEL view state ─────────────────────────────────────────────

package/lib/examples/AgentspecsExample.js

@@ -216,7 +216,7 @@ const resolveCloudRuntimeBaseUrlFromSpec = (spec) => {
         'runtimeUrl',
         'runtimes_url',
         'runtime_url',
-        'datalayerUrl',
+        'aiAgentsUrl',
         'baseUrl',
         'endpoint',
     ];

package/lib/examples/NotebookCollaborationExample.js

@@ -32,7 +32,7 @@ const NotebookCollaborationExample = (props) => {
                 return;
             }
             // Create DatalayerServiceManager if we have credentials
-            if (configuration?.token && configuration?.datalayerUrl) {
+            if (configuration?.token && configuration?.spacerUrl) {
                 try {
                     // Now we can pass undefined to use config/defaults
                     const manager = await createDatalayerServiceManager(configuration?.cpuEnvironment, configuration?.credits);
@@ -44,7 +44,7 @@ const NotebookCollaborationExample = (props) => {
                 }
             }
             else {
-                console.warn('Datalayer credentials not configured. Please set datalayerUrl and token.');
+                console.warn('Datalayer credentials not configured. Please set spacerUrl and token.');
             }
         };
         createManager();
@@ -54,20 +54,20 @@ const NotebookCollaborationExample = (props) => {
         if (!enableCollaboration) {
             return undefined;
         }
-        const datalayerUrl = configuration?.datalayerUrl;
+        const spacerUrl = configuration?.spacerUrl;
         const token = configuration?.token;
-        if (!datalayerUrl || !token) {
-            console.warn('Datalayer collaboration enabled but datalayerUrl or token not configured. ' +
+        if (!spacerUrl || !token) {
+            console.warn('Datalayer collaboration enabled but spacerUrl or token not configured. ' +
                 'Please configure them in the Datalayer store or environment.');
             return undefined;
         }
         // Create and return the Datalayer collaboration provider
         return new DatalayerCollaborationProvider({
-            datalayerUrl,
+            spacerUrl,
             token,
         });
     }, [enableCollaboration, configuration]);
-    return (_jsx(ThemedJupyterProvider, { children: _jsxs(Box, { p: 3, children: [_jsx(Heading, { as: "h2", sx: { mb: 3 }, children: "Notebook Collaboration Example" }), _jsx(Box, { sx: { mb: 3 }, children: _jsxs(FormControl, { children: [_jsx(Checkbox, { checked: enableCollaboration, onChange: e => setEnableCollaboration(e.target.checked) }), _jsx(FormControl.Label, { children: "Enable Datalayer Collaboration" })] }) }), (!configuration?.datalayerUrl || !configuration?.token) && (_jsx(Box, { sx: { mb: 2, p: 2, bg: 'danger.subtle' }, children: "Warning: Datalayer configuration is missing. Please configure datalayerUrl and token to use DatalayerServiceManager and collaboration features." })), !serviceManager && (_jsx(Box, { sx: { mb: 2, p: 2, bg: 'attention.subtle' }, children: "Note: DatalayerServiceManager is not available. Notebook functionality will be limited." })), enableCollaboration ? (_jsxs(Box, { sx: {
+    return (_jsx(ThemedJupyterProvider, { children: _jsxs(Box, { p: 3, children: [_jsx(Heading, { as: "h2", sx: { mb: 3 }, children: "Notebook Collaboration Example" }), _jsx(Box, { sx: { mb: 3 }, children: _jsxs(FormControl, { children: [_jsx(Checkbox, { checked: enableCollaboration, onChange: e => setEnableCollaboration(e.target.checked) }), _jsx(FormControl.Label, { children: "Enable Datalayer Collaboration" })] }) }), (!configuration?.spacerUrl || !configuration?.token) && (_jsx(Box, { sx: { mb: 2, p: 2, bg: 'danger.subtle' }, children: "Warning: Datalayer configuration is missing. Please configure spacerUrl and token to use DatalayerServiceManager and collaboration features." })), !serviceManager && (_jsx(Box, { sx: { mb: 2, p: 2, bg: 'attention.subtle' }, children: "Note: DatalayerServiceManager is not available. Notebook functionality will be limited." })), enableCollaboration ? (_jsxs(Box, { sx: {
                         display: 'flex',
                         gap: 2,
                         flexDirection: 'row',
@@ -97,6 +97,6 @@ const NotebookCollaborationExample = (props) => {
                         border: '1px solid',
                         borderColor: 'border.default',
                         borderRadius: 2,
-                    }, children: serviceManager ? (_jsx(Notebook, { id: NOTEBOOK_ID, height: "calc(100vh - 200px)", nbformat: nbformat, readonly: readonly, serviceManager: serviceManager, startDefaultKernel: true, collaborationProvider: collaborationProvider })) : (_jsx(Box, { sx: { p: 4, textAlign: 'center' }, children: "Loading ServiceManager..." })) })), _jsxs(Box, { sx: { mt: 2, fontSize: 1, color: 'fg.subtle' }, children: [_jsx(Box, { as: "p", sx: { m: 0, mb: 2 }, children: "This example demonstrates how to use Datalayer services with Notebook:" }), _jsxs(Box, { as: "ul", sx: { m: 0, pl: 3, '& li': { mb: 1 } }, children: [_jsxs("li", { children: [_jsx("strong", { children: "DatalayerServiceManager:" }), " Connects to Datalayer infrastructure for kernel management"] }), _jsxs("li", { children: [_jsx("strong", { children: "DatalayerCollaborationProvider:" }), " Enables real-time collaboration"] }), _jsx("li", { children: "Both require Datalayer credentials (datalayerUrl and token)" }), _jsx("li", { children: "Pass them directly to the base Notebook component" }), _jsx("li", { children: "No wrapper components needed - just create the services and pass them as props" }), _jsx("li", { children: "This shows the explicit, composable pattern for Datalayer integration" })] })] })] }) }));
+                    }, children: serviceManager ? (_jsx(Notebook, { id: NOTEBOOK_ID, height: "calc(100vh - 200px)", nbformat: nbformat, readonly: readonly, serviceManager: serviceManager, startDefaultKernel: true, collaborationProvider: collaborationProvider })) : (_jsx(Box, { sx: { p: 4, textAlign: 'center' }, children: "Loading ServiceManager..." })) })), _jsxs(Box, { sx: { mt: 2, fontSize: 1, color: 'fg.subtle' }, children: [_jsx(Box, { as: "p", sx: { m: 0, mb: 2 }, children: "This example demonstrates how to use Datalayer services with Notebook:" }), _jsxs(Box, { as: "ul", sx: { m: 0, pl: 3, '& li': { mb: 1 } }, children: [_jsxs("li", { children: [_jsx("strong", { children: "DatalayerServiceManager:" }), " Connects to Datalayer infrastructure for kernel management"] }), _jsxs("li", { children: [_jsx("strong", { children: "DatalayerCollaborationProvider:" }), " Enables real-time collaboration"] }), _jsx("li", { children: "Both require Datalayer credentials (spacerUrl and token)" }), _jsx("li", { children: "Pass them directly to the base Notebook component" }), _jsx("li", { children: "No wrapper components needed - just create the services and pass them as props" }), _jsx("li", { children: "This shows the explicit, composable pattern for Datalayer integration" })] })] })] }) }));
 };
 export default NotebookCollaborationExample;

package/lib/examples/main.js

@@ -114,7 +114,7 @@ const withTokenQueryParam = (rawUrl, token) => {
 };
 const resolveRuntimesUrl = (configured) => {
     const envRuntimeUrl = import.meta.env.VITE_DATALAYER_RUNTIMES_URL;
-    const envBaseUrl = import.meta.env.VITE_DATALAYER_URL;
+    const envBaseUrl = import.meta.env.VITE_DATALAYER_IAM_URL;
     const candidate = configured || envRuntimeUrl || envBaseUrl;
     if (!candidate) {
         return DEFAULT_RUNTIMES_URL;
@@ -193,7 +193,7 @@ const loadConfigurations = () => {
                     datalayerConfig.token = envToken;
                 }
             }
-            if (datalayerConfig.datalayerUrl) {
+            if (datalayerConfig.iamUrl) {
                 datalayerConfig.runtimesUrl = resolveRuntimesUrl(datalayerConfig.runtimesUrl);
                 coreStore.getState().setConfiguration(datalayerConfig);
                 // Also set the token in the IAM store for API authentication
@@ -466,12 +466,12 @@ const NotebookOnlyApp = () => {
         const initializeApp = async () => {
             try {
                 const { configuration } = coreStore.getState();
-                // Always try to create collaboration provider if we have token and datalayerUrl
-                if (configuration?.token && configuration?.datalayerUrl) {
+                // Always try to create collaboration provider if we have token and spacerUrl
+                if (configuration?.token && configuration?.spacerUrl) {
                     try {
                         const { DatalayerCollaborationProvider } = await import('../collaboration/DatalayerCollaborationProvider');
                         const provider = new DatalayerCollaborationProvider({
-                            datalayerUrl: configuration.datalayerUrl,
+                            spacerUrl: configuration.spacerUrl,
                             token: configuration.token,
                         });
                         setCollaborationProvider(provider);

package/lib/examples2/DatalayerNotebookExample.js

@@ -31,7 +31,7 @@ const DatalayerNotebookExample = (props) => {
                 return;
             }
             // Create DatalayerServiceManager if we have credentials
-            if (configuration?.token && configuration?.datalayerUrl) {
+            if (configuration?.token && configuration?.spacerUrl) {
                 try {
                     // Now we can pass undefined to use config/defaults
                     const manager = await createDatalayerServiceManager(configuration?.cpuEnvironment, configuration?.credits);
@@ -43,7 +43,7 @@ const DatalayerNotebookExample = (props) => {
                 }
             }
             else {
-                console.warn('Datalayer credentials not configured. Please set datalayerUrl and token.');
+                console.warn('Datalayer credentials not configured. Please set spacerUrl and token.');
             }
         };
         createManager();
@@ -53,20 +53,20 @@ const DatalayerNotebookExample = (props) => {
         if (!enableCollaboration) {
             return undefined;
         }
-        const datalayerUrl = configuration?.datalayerUrl;
+        const spacerUrl = configuration?.spacerUrl;
         const token = configuration?.token;
-        if (!datalayerUrl || !token) {
-            console.warn('Datalayer collaboration enabled but datalayerUrl or token not configured. ' +
+        if (!spacerUrl || !token) {
+            console.warn('Datalayer collaboration enabled but spacerUrl or token not configured. ' +
                 'Please configure them in the Datalayer store or environment.');
             return undefined;
         }
         // Create and return the Datalayer collaboration provider
         return new DatalayerCollaborationProvider({
-            datalayerUrl,
+            spacerUrl,
             token,
         });
     }, [enableCollaboration, configuration]);
-    return (_jsx(JupyterReactTheme, { children: _jsxs(Box, { p: 3, children: [_jsx(Heading, { as: "h2", sx: { mb: 3 }, children: "Datalayer Notebook Collaboration Example" }), _jsx(Box, { sx: { mb: 3 }, children: _jsxs(FormControl, { children: [_jsx(Checkbox, { checked: enableCollaboration, onChange: e => setEnableCollaboration(e.target.checked) }), _jsx(FormControl.Label, { children: "Enable Datalayer Collaboration" })] }) }), (!configuration?.datalayerUrl || !configuration?.token) && (_jsx(Box, { sx: { mb: 2, p: 2, bg: 'danger.subtle' }, children: "Warning: Datalayer configuration is missing. Please configure datalayerUrl and token to use DatalayerServiceManager and collaboration features." })), !serviceManager && (_jsx(Box, { sx: { mb: 2, p: 2, bg: 'attention.subtle' }, children: "Note: DatalayerServiceManager is not available. Notebook functionality will be limited." })), enableCollaboration ? (_jsxs(Box, { sx: {
+    return (_jsx(JupyterReactTheme, { children: _jsxs(Box, { p: 3, children: [_jsx(Heading, { as: "h2", sx: { mb: 3 }, children: "Datalayer Notebook Collaboration Example" }), _jsx(Box, { sx: { mb: 3 }, children: _jsxs(FormControl, { children: [_jsx(Checkbox, { checked: enableCollaboration, onChange: e => setEnableCollaboration(e.target.checked) }), _jsx(FormControl.Label, { children: "Enable Datalayer Collaboration" })] }) }), (!configuration?.spacerUrl || !configuration?.token) && (_jsx(Box, { sx: { mb: 2, p: 2, bg: 'danger.subtle' }, children: "Warning: Datalayer configuration is missing. Please configure spacerUrl and token to use DatalayerServiceManager and collaboration features." })), !serviceManager && (_jsx(Box, { sx: { mb: 2, p: 2, bg: 'attention.subtle' }, children: "Note: DatalayerServiceManager is not available. Notebook functionality will be limited." })), enableCollaboration ? (_jsxs(Box, { sx: {
                         display: 'flex',
                         gap: 2,
                         flexDirection: 'row',
@@ -104,6 +104,6 @@ const DatalayerNotebookExample = (props) => {
                         border: '1px solid',
                         borderColor: 'border.default',
                         borderRadius: 2,
-                    }, children: serviceManager ? (_jsx(Notebook, { id: NOTEBOOK_ID, height: "calc(100vh - 200px)", nbformat: nbformat, readonly: readonly, serviceManager: serviceManager, startDefaultKernel: true, collaborationProvider: collaborationProvider })) : (_jsx(Box, { sx: { p: 4, textAlign: 'center' }, children: "Loading ServiceManager..." })) })), _jsxs(Box, { sx: { mt: 2, fontSize: 1, color: 'fg.subtle' }, children: [_jsx("p", { children: "This example demonstrates how to use Datalayer services with Notebook:" }), _jsxs("ul", { children: [_jsxs("li", { children: [_jsx("strong", { children: "DatalayerServiceManager:" }), " Connects to Datalayer infrastructure for kernel management"] }), _jsxs("li", { children: [_jsx("strong", { children: "DatalayerCollaborationProvider:" }), " Enables real-time collaboration"] }), _jsx("li", { children: "Both require Datalayer credentials (datalayerUrl and token)" }), _jsx("li", { children: "Pass them directly to the base Notebook component" }), _jsx("li", { children: "No wrapper components needed - just create the services and pass them as props" }), _jsx("li", { children: "This shows the explicit, composable pattern for Datalayer integration" })] })] })] }) }));
+                    }, children: serviceManager ? (_jsx(Notebook, { id: NOTEBOOK_ID, height: "calc(100vh - 200px)", nbformat: nbformat, readonly: readonly, serviceManager: serviceManager, startDefaultKernel: true, collaborationProvider: collaborationProvider })) : (_jsx(Box, { sx: { p: 4, textAlign: 'center' }, children: "Loading ServiceManager..." })) })), _jsxs(Box, { sx: { mt: 2, fontSize: 1, color: 'fg.subtle' }, children: [_jsx("p", { children: "This example demonstrates how to use Datalayer services with Notebook:" }), _jsxs("ul", { children: [_jsxs("li", { children: [_jsx("strong", { children: "DatalayerServiceManager:" }), " Connects to Datalayer infrastructure for kernel management"] }), _jsxs("li", { children: [_jsx("strong", { children: "DatalayerCollaborationProvider:" }), " Enables real-time collaboration"] }), _jsx("li", { children: "Both require Datalayer credentials (spacerUrl and token)" }), _jsx("li", { children: "Pass them directly to the base Notebook component" }), _jsx("li", { children: "No wrapper components needed - just create the services and pass them as props" }), _jsx("li", { children: "This shows the explicit, composable pattern for Datalayer integration" })] })] })] }) }));
 };
 export default DatalayerNotebookExample;

package/lib/examples2/main.js

@@ -19,7 +19,7 @@ const DEFAULT_LOCAL_JUPYTER_SERVER_URL = 'http://0.0.0.0:8888/api/jupyter-server
 const DEFAULT_LOCAL_JUPYTER_SERVER_TOKEN = '60c1661cc408f978c309d04157af55c9588ff9557c9380e4fb50785750703da6';
 const resolveRuntimesUrl = (configured) => {
     const envRuntimeUrl = import.meta.env.VITE_DATALAYER_RUNTIMES_URL;
-    const envBaseUrl = import.meta.env.VITE_DATALAYER_URL;
+    const envBaseUrl = import.meta.env.VITE_DATALAYER_IAM_URL;
     const candidate = configured || envRuntimeUrl || envBaseUrl;
     if (!candidate) {
         return DEFAULT_RUNTIMES_URL;
@@ -72,7 +72,7 @@ const loadConfigurations = () => {
                     datalayerConfig.token = envToken;
                 }
             }
-            if (datalayerConfig.datalayerUrl) {
+            if (datalayerConfig.iamUrl) {
                 datalayerConfig.runtimesUrl = resolveRuntimesUrl(datalayerConfig.runtimesUrl);
                 coreStore.getState().setConfiguration(datalayerConfig);
                 // Also set the token in the IAM store for API authentication
@@ -154,12 +154,12 @@ const NotebookOnlyApp = () => {
         const initializeApp = async () => {
             try {
                 const { configuration } = coreStore.getState();
-                // Always try to create collaboration provider if we have token and datalayerUrl
-                if (configuration?.token && configuration?.datalayerUrl) {
+                // Always try to create collaboration provider if we have token and spacerUrl
+                if (configuration?.token && configuration?.spacerUrl) {
                     try {
                         const { DatalayerCollaborationProvider } = await import('../collaboration/DatalayerCollaborationProvider');
                         const provider = new DatalayerCollaborationProvider({
-                            datalayerUrl: configuration.datalayerUrl,
+                            spacerUrl: configuration.spacerUrl,
                             token: configuration.token,
                         });
                         console.warn('[NotebookOnlyApp] Created collaboration provider:', provider);

package/lib/hooks/useAgentRuntimes.js

@@ -395,12 +395,12 @@ export function useAgentRuntimes(options = {}) {
             const { iamStore, coreStore } = await import('@datalayer/core/lib/state');
             const token = iamStore.getState().token || '';
             const config = coreStore.getState().configuration;
-            const datalayerUrl = config?.aiAgentsUrl || '';
+            const aiAgentsUrl = config?.aiAgentsUrl || '';
             const runtimesUrl = resolvedRuntimeCreationBaseUrl;
-            return { token, datalayerUrl, runtimesUrl };
+            return { token, aiAgentsUrl, runtimesUrl };
         }
         catch {
-            return { token: '', datalayerUrl: '', runtimesUrl: '' };
+            return { token: '', aiAgentsUrl: '', runtimesUrl: '' };
         }
     }, [resolvedRuntimeCreationBaseUrl]);
     // ─── Launch Runtime ─────────────────────────────────────────────────

package/lib/hooks/useMonitoring.d.ts

@@ -1,7 +1,7 @@
 export interface OtelQueryOptions {
     metric: string;
     serviceName?: string;
-    datalayerUrl?: string;
+    otelUrl?: string;
     apiKey?: string;
     limit?: number;
     accountUid?: string;
@@ -12,15 +12,15 @@ interface MetricValueRow {
     value_int?: unknown;
 }
 export declare function toMetricValue(row: MetricValueRow): number;
-export declare function fetchOtelMetricRows({ metric, serviceName, datalayerUrl, apiKey, limit, accountUid, }: OtelQueryOptions): Promise<MetricValueRow[]>;
+export declare function fetchOtelMetricRows({ metric, serviceName, otelUrl, apiKey, limit, accountUid, }: OtelQueryOptions): Promise<MetricValueRow[]>;
 export declare function fetchOtelMetricTotal(options: OtelQueryOptions): Promise<number>;
 export interface OtelTotalTokensOptions {
     serviceName?: string;
-    datalayerUrl?: string;
+    otelUrl?: string;
     apiKey?: string;
     limit?: number;
     accountUid?: string;
 }
-export declare function fetchOtelTotalTokens({ serviceName, datalayerUrl, apiKey, limit, accountUid, }: OtelTotalTokensOptions): Promise<number>;
-export declare function useOtelTotalTokens({ serviceName, datalayerUrl, apiKey, limit, accountUid, }: OtelTotalTokensOptions): string;
+export declare function fetchOtelTotalTokens({ serviceName, otelUrl, apiKey, limit, accountUid, }: OtelTotalTokensOptions): Promise<number>;
+export declare function useOtelTotalTokens({ serviceName, otelUrl, apiKey, limit, accountUid, }: OtelTotalTokensOptions): string;
 export {};

package/lib/hooks/useMonitoring.js

@@ -24,12 +24,12 @@ export function toMetricValue(row) {
     }
     return 0;
 }
-export async function fetchOtelMetricRows({ metric, serviceName, datalayerUrl, apiKey, limit = 500, accountUid, }) {
-    if (!datalayerUrl || !apiKey) {
+export async function fetchOtelMetricRows({ metric, serviceName, otelUrl, apiKey, limit = 500, accountUid, }) {
+    if (!otelUrl || !apiKey) {
         return [];
     }
     const client = createOtelClient({
-        baseUrl: datalayerUrl,
+        baseUrl: otelUrl,
         token: apiKey,
     });
     const filtered = await client.fetchMetrics({
@@ -52,11 +52,11 @@ export async function fetchOtelMetricTotal(options) {
     const rows = await fetchOtelMetricRows(options);
     return rows.reduce((sum, row) => sum + toMetricValue(row), 0);
 }
-export async function fetchOtelTotalTokens({ serviceName, datalayerUrl, apiKey, limit = 500, accountUid, }) {
+export async function fetchOtelTotalTokens({ serviceName, otelUrl, apiKey, limit = 500, accountUid, }) {
     const total = await fetchOtelMetricTotal({
         metric: 'agent_runtimes.prompt.turn.total_tokens',
         serviceName,
-        datalayerUrl,
+        otelUrl,
         apiKey,
         limit,
         accountUid,
@@ -67,7 +67,7 @@ export async function fetchOtelTotalTokens({ serviceName, datalayerUrl, apiKey,
     const prompt = await fetchOtelMetricTotal({
         metric: 'agent_runtimes.prompt.turn.prompt_tokens',
         serviceName,
-        datalayerUrl,
+        otelUrl,
         apiKey,
         limit,
         accountUid,
@@ -75,14 +75,14 @@ export async function fetchOtelTotalTokens({ serviceName, datalayerUrl, apiKey,
     const completion = await fetchOtelMetricTotal({
         metric: 'agent_runtimes.prompt.turn.completion_tokens',
         serviceName,
-        datalayerUrl,
+        otelUrl,
         apiKey,
         limit,
         accountUid,
     });
     return prompt + completion;
 }
-export function useOtelTotalTokens({ serviceName, datalayerUrl, apiKey, limit = 500, accountUid, }) {
+export function useOtelTotalTokens({ serviceName, otelUrl, apiKey, limit = 500, accountUid, }) {
     const [tokensLabel, setTokensLabel] = useState('-');
     useEffect(() => {
         let cancelled = false;
@@ -90,7 +90,7 @@ export function useOtelTotalTokens({ serviceName, datalayerUrl, apiKey, limit =
             try {
                 const total = await fetchOtelTotalTokens({
                     serviceName,
-                    datalayerUrl,
+                    otelUrl,
                     apiKey,
                     limit,
                     accountUid,
@@ -115,6 +115,6 @@ export function useOtelTotalTokens({ serviceName, datalayerUrl, apiKey, limit =
         return () => {
             cancelled = true;
         };
-    }, [apiKey, limit, datalayerUrl, serviceName, accountUid]);
+    }, [apiKey, limit, otelUrl, serviceName, accountUid]);
     return tokensLabel;
 }

package/lib/protocols/AGUIAdapter.js

@@ -539,6 +539,8 @@ export class AGUIAdapter extends BaseProtocolAdapter {
                         toolCallId,
                         toolName,
                         args: {},
+                        // TOOL_CALL_START: the args stream in afterwards.
+                        argsComplete: false,
                     },
                     timestamp: new Date(),
                 });
@@ -582,6 +584,8 @@ export class AGUIAdapter extends BaseProtocolAdapter {
                                 toolCallId: pending.toolCallId,
                                 toolName: pending.toolName,
                                 args: parsedArgs,
+                                // TOOL_CALL_END: this is the full argument set.
+                                argsComplete: true,
                             },
                             timestamp: new Date(),
                         });

package/lib/protocols/VercelAIAdapter.js

@@ -485,6 +485,9 @@ export class VercelAIAdapter extends BaseProtocolAdapter {
                                             toolCallId,
                                             toolName,
                                             args,
+                                            // `tool-input-available` carries the final input:
+                                            // empty args are an answer, not a promise of more.
+                                            argsComplete: true,
                                         },
                                         timestamp: new Date(),
                                     });

package/lib/types/chat.d.ts

@@ -3,6 +3,7 @@
  *
  * @module types/chat
  */
+import type { ToolbarItem } from '@datalayer/primer-addons';
 import type { ComponentType, ReactNode } from 'react';
 import type { ICollaborationProvider } from '@datalayer/jupyter-react';
 import type { ChatMessage, MessageHandler } from './messages';
@@ -369,6 +370,17 @@ export interface ChatCommonProps {
      * Defaults to the toolbar from `@datalayer/jupyter-react` when omitted.
      */
     ephemeralNotebookToolbar?: EphemeralNotebookToolbarComponent;
+    /**
+     * Items added to the toolbar of the ephemeral notebook, e.g. the status of
+     * the sandbox it runs on. Merged with the items of the toolbar and ordered
+     * by the `order` of each item.
+     */
+    ephemeralNotebookToolbarExtraItems?: ToolbarItem[];
+    /**
+     * Items added to the toolbar of the ephemeral document, the same way as
+     * {@link ChatProps.ephemeralNotebookToolbarExtraItems} for the notebook.
+     */
+    ephemeralDocumentToolbarExtraItems?: ToolbarItem[];
     /**
      * Optional real-time collaboration provider for the ephemeral notebook.
      * When supplied, the notebook joins a shared collaborative room so its state
@@ -801,6 +813,17 @@ export interface ChatBaseProps {
      * Defaults to the toolbar from `@datalayer/jupyter-react` when omitted.
      */
     ephemeralNotebookToolbar?: EphemeralNotebookToolbarComponent;
+    /**
+     * Items added to the toolbar of the ephemeral notebook, e.g. the status of
+     * the sandbox it runs on. Merged with the items of the toolbar and ordered
+     * by the `order` of each item.
+     */
+    ephemeralNotebookToolbarExtraItems?: ToolbarItem[];
+    /**
+     * Items added to the toolbar of the ephemeral document, the same way as
+     * {@link ChatProps.ephemeralNotebookToolbarExtraItems} for the notebook.
+     */
+    ephemeralDocumentToolbarExtraItems?: ToolbarItem[];
     /**
      * Optional real-time collaboration provider for the ephemeral notebook.
      * When supplied, the notebook joins a shared collaborative room so its state

package/lib/types/tools.d.ts

@@ -192,6 +192,17 @@ export interface ToolCallRequest {
     toolCallId: string;
     toolName: string;
     args: Record<string, unknown>;
+    /**
+     * Whether `args` is the complete argument set.
+     *
+     * Protocols that stream arguments (AG-UI) emit a first tool-call with
+     * `{}` and the real args later — those mark `false`, and execution waits.
+     * Protocols whose tool-call event is terminal (Vercel) mark `true`: an
+     * empty `args` there means the model chose to pass nothing, which is
+     * legal for a tool whose parameters are all optional — waiting on more
+     * would wait forever. Absent, the executor falls back to heuristics.
+     */
+    argsComplete?: boolean;
 }
 /**
  * Tool registry entry (internal)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datalayer/agent-runtimes",
-  "version": "1.0.20",
+  "version": "1.0.25",
   "type": "module",
   "workspaces": [
     ".",
@@ -73,8 +73,8 @@
     "examples:fresh": "npm run clean:cache && npm run examples",
     "examples:jupyter": "run-p jupyter:start server:start server:start:codemode examples:vite",
     "examples:nextjs": "npm run dev --workspace=nextjs-notebook-example",
-    "examples:vite": "VITE_DATALAYER_URL=${VITE_DATALAYER_URL:-https://r1.datalayer.run} VITE_DATALAYER_RUNTIMES_URL=${VITE_DATALAYER_RUNTIMES_URL:-https://r1.datalayer.run} VITE_DATALAYER_AGENT_RUNTIMES_URL=${VITE_DATALAYER_AGENT_RUNTIMES_URL:-https://r1.datalayer.run} VITE_APP_TARGET=examples vite",
-    "examples2:vite": "VITE_DATALAYER_URL=${VITE_DATALAYER_URL:-https://r1.datalayer.run} VITE_DATALAYER_RUNTIMES_URL=${VITE_DATALAYER_RUNTIMES_URL:-https://r1.datalayer.run} VITE_DATALAYER_AGENT_RUNTIMES_URL=${VITE_DATALAYER_AGENT_RUNTIMES_URL:-https://r1.datalayer.run} VITE_APP_TARGET=examples2 vite",
+    "examples:vite": "VITE_DATALAYER_RUNTIMES_URL=${VITE_DATALAYER_RUNTIMES_URL:-https://r1.datalayer.run} VITE_DATALAYER_AGENT_RUNTIMES_URL=${VITE_DATALAYER_AGENT_RUNTIMES_URL:-https://r1.datalayer.run} VITE_APP_TARGET=examples vite",
+    "examples2:vite": "VITE_DATALAYER_RUNTIMES_URL=${VITE_DATALAYER_RUNTIMES_URL:-https://r1.datalayer.run} VITE_DATALAYER_AGENT_RUNTIMES_URL=${VITE_DATALAYER_AGENT_RUNTIMES_URL:-https://r1.datalayer.run} VITE_APP_TARGET=examples2 vite",
     "format": "prettier --write \"src/**/*.{js,jsx,ts,tsx,css,json,md}\" \"examples/**/*.{js,jsx,ts,tsx,css,json,md,mjs}\"",
     "format:all": "npm run format && npm run format --workspaces --if-present",
     "format:check": "prettier --check \"src/**/*.{js,jsx,ts,tsx,css,json,md}\" \"examples/**/*.{js,jsx,ts,tsx,css,json,md,mjs}\"",

package/lib/components/toolbars/AssignmentEditorToolbar.d.ts

@@ -1,4 +0,0 @@
-export declare const AssignmentEditorToolbar: (props: {
-    notebookId: string;
-}) => import("react/jsx-runtime").JSX.Element;
-export default AssignmentEditorToolbar;

package/lib/components/toolbars/AssignmentEditorToolbar.js

@@ -1,18 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-/*
- * Copyright (c) 2025-2026 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { Button } from '@primer/react';
-import { Box } from '@datalayer/primer-addons';
-import { RepoPushIcon } from '@primer/octicons-react';
-// import { PlayIcon, StopIcon } from '@primer/octicons-react';
-// import { notebookStore } from '@datalayer/jupyter-react';
-import { useGradeStore } from '../../state/substates';
-export const AssignmentEditorToolbar = (props) => {
-    //  const { notebookId } = props;
-    //   const notebook = notebookStore.getState().selectNotebook(notebookId);
-    const { grade } = useGradeStore();
-    return (_jsx(Box, { display: "flex", children: _jsx(Box, { children: _jsx(Button, { variant: "invisible", size: "small", leadingVisual: RepoPushIcon, onClick: () => grade(new Date()), children: "Grade" }) }) }));
-};
-export default AssignmentEditorToolbar;

package/lib/components/toolbars/DocumentEditorToolbar.d.ts

@@ -1,2 +0,0 @@
-export declare const DocumentEditorToolbar: () => import("react/jsx-runtime").JSX.Element;
-export default DocumentEditorToolbar;

package/lib/components/toolbars/DocumentEditorToolbar.js

@@ -1,12 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-/*
- * Copyright (c) 2025-2026 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { Button, Box } from '@primer/react';
-import { RepoPushIcon } from '@primer/octicons-react';
-import { documentStore } from '../../state/substates';
-export const DocumentEditorToolbar = () => {
-    return (_jsx(Box, { display: "flex", children: _jsx(Box, { children: _jsx(Button, { variant: "invisible", size: "small", leadingVisual: RepoPushIcon, onClick: () => documentStore.getState().save(new Date()), children: "Save" }) }) }));
-};
-export default DocumentEditorToolbar;

package/lib/components/toolbars/NotebookEditorToolbar.d.ts

@@ -1,29 +0,0 @@
-import { Session } from '@jupyterlab/services';
-import { CommandRegistry } from '@lumino/commands';
-import type { IRuntimeDesc } from '../../models';
-/**
- * NotebookEditorToolbar component properties
- */
-export type INotebookEditorToolbar = {
-    /**
-     * Jupyter commands registry
-     */
-    commandRegistry?: CommandRegistry;
-    /**
-     * Kernel description
-     */
-    runtimeDesc?: IRuntimeDesc;
-    /**
-     * Callback to save the notebook model
-     */
-    save: () => void;
-    /**
-     * Session connection
-     */
-    sessionConnection?: Session.ISessionConnection;
-};
-/**
- * Notebook editor toolbar
- */
-export declare function NotebookEditorToolbar(props: INotebookEditorToolbar): JSX.Element;
-export default NotebookEditorToolbar;

package/lib/components/toolbars/NotebookEditorToolbar.js

@@ -1,30 +0,0 @@
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-/*
- * Copyright (c) 2025-2026 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { NotebookCommandIds } from '@datalayer/jupyter-react';
-import { Button } from '@primer/react';
-import { PlayIcon, StopIcon } from '@primer/octicons-react';
-import { useEffect, useState } from 'react';
-/**
- * Notebook editor toolbar
- */
-export function NotebookEditorToolbar(props) {
-    const { commandRegistry, runtimeDesc, sessionConnection } = props;
-    const [kernelStatus, setKernelStatus] = useState();
-    useEffect(() => {
-        const onStatusChanged = () => {
-            setKernelStatus(sessionConnection?.kernel?.status);
-        };
-        onStatusChanged();
-        sessionConnection?.statusChanged.connect(onStatusChanged);
-        sessionConnection?.connectionStatusChanged.connect(onStatusChanged);
-        return () => {
-            sessionConnection?.statusChanged.disconnect(onStatusChanged);
-            sessionConnection?.connectionStatusChanged.disconnect(onStatusChanged);
-        };
-    }, [sessionConnection]);
-    return (_jsxs(_Fragment, { children: [_jsx(Button, { variant: "invisible", size: "small", leadingVisual: PlayIcon, disabled: !runtimeDesc?.location || kernelStatus === 'busy', onClick: (e) => commandRegistry?.execute(NotebookCommandIds.runAll), children: "Run all" }), _jsx(Button, { variant: "invisible", size: "small", leadingVisual: StopIcon, disabled: !runtimeDesc?.location || kernelStatus !== 'busy', onClick: (e) => commandRegistry?.execute(NotebookCommandIds.interrupt), children: "Interrupt" })] }));
-}
-export default NotebookEditorToolbar;