@datalayer/agent-runtimes 1.0.21 → 1.0.26

package/lib/context/TokenUsageChart.d.ts

@@ -3,7 +3,7 @@ export interface TokenUsageChartProps {
     agentId?: string;
     runtimeId?: string;
     apiKey?: string;
-    datalayerUrl?: string;
+    otelUrl?: string;
     wsUrl?: string;
     liveSystemPromptTokens?: number;
     liveToolsDescriptionTokens?: number;
@@ -14,5 +14,5 @@ export interface TokenUsageChartProps {
     height?: number;
     days?: number;
 }
-export declare function TokenUsageChart({ serviceName, agentId, runtimeId, apiKey, datalayerUrl, wsUrl, liveSystemPromptTokens, liveToolsDescriptionTokens, liveUserMessageTokens, liveAgentMessageTokens, liveToolsUsageTokens, liveTimestampMs, height, }: TokenUsageChartProps): import("react/jsx-runtime").JSX.Element;
+export declare function TokenUsageChart({ serviceName, agentId, runtimeId, apiKey, otelUrl, wsUrl, liveSystemPromptTokens, liveToolsDescriptionTokens, liveUserMessageTokens, liveAgentMessageTokens, liveToolsUsageTokens, liveTimestampMs, height, }: TokenUsageChartProps): import("react/jsx-runtime").JSX.Element;
 export default TokenUsageChart;

package/lib/context/TokenUsageChart.js

@@ -280,7 +280,7 @@ function extractAgentId(row) {
         return aid;
     return undefined;
 }
-export function TokenUsageChart({ serviceName, agentId, runtimeId, apiKey, datalayerUrl, wsUrl, liveSystemPromptTokens, liveToolsDescriptionTokens, liveUserMessageTokens, liveAgentMessageTokens, liveToolsUsageTokens, liveTimestampMs, height = 160, }) {
+export function TokenUsageChart({ serviceName, agentId, runtimeId, apiKey, otelUrl, wsUrl, liveSystemPromptTokens, liveToolsDescriptionTokens, liveUserMessageTokens, liveAgentMessageTokens, liveToolsUsageTokens, liveTimestampMs, height = 160, }) {
     const cacheServiceKey = String(serviceName || runtimeId || '').trim() || undefined;
     const monitoringCache = useAgentRuntimeStore(s => s.monitoringCache);
     const mergeTokenTurns = useAgentRuntimeStore(s => s.mergeTokenTurns);
@@ -311,7 +311,7 @@ export function TokenUsageChart({ serviceName, agentId, runtimeId, apiKey, datal
     // Bootstrap chart with historical OTEL metrics so charts are populated even
     // before the first websocket update arrives.
     useEffect(() => {
-        if (!cacheServiceKey || !apiKey || !datalayerUrl) {
+        if (!cacheServiceKey || !apiKey || !otelUrl) {
             return;
         }
         let cancelled = false;
@@ -321,7 +321,7 @@ export function TokenUsageChart({ serviceName, agentId, runtimeId, apiKey, datal
                 const results = await Promise.all(metricNames.map(metric => fetchOtelMetricRows({
                     metric,
                     serviceName,
-                    datalayerUrl,
+                    otelUrl,
                     apiKey,
                     limit: 1000,
                 })));
@@ -375,7 +375,7 @@ export function TokenUsageChart({ serviceName, agentId, runtimeId, apiKey, datal
         agentId,
         apiKey,
         cacheServiceKey,
-        datalayerUrl,
+        otelUrl,
         mergeTokenTurns,
         runtimeId,
         serviceName,
@@ -439,7 +439,7 @@ export function TokenUsageChart({ serviceName, agentId, runtimeId, apiKey, datal
         if (!cacheServiceKey || !apiKey)
             return;
         const rawBaseUrl = wsUrl ||
-            datalayerUrl ||
+            otelUrl ||
             (typeof window !== 'undefined' ? window.location.origin : '');
         if (!rawBaseUrl)
             return;
@@ -496,7 +496,7 @@ export function TokenUsageChart({ serviceName, agentId, runtimeId, apiKey, datal
         apiKey,
         cacheServiceKey,
         mergeTokenTurns,
-        datalayerUrl,
+        otelUrl,
         runtimeId,
         serviceName,
         wsUrl,

package/lib/context/TurnGraphChart.d.ts

@@ -24,7 +24,7 @@ export interface TurnGraphChartProps {
     /** Filter spans to this agent ID (matches ``agent.id`` span attribute). */
     agentId?: string;
     /** Base URL for the Datalayer OTEL service. */
-    datalayerUrl?: string;
+    otelUrl?: string;
     /** JWT / API key for OTEL auth. */
     apiKey?: string;
     /**

package/lib/context/TurnGraphChart.js

@@ -386,7 +386,7 @@ function buildOption(run) {
         ],
     };
 }
-export const TurnGraphChart = ({ serviceName, agentId, datalayerUrl, apiKey, autoRefreshMs = 10_000, height = 320, style, }) => {
+export const TurnGraphChart = ({ serviceName, agentId, otelUrl, apiKey, autoRefreshMs = 10_000, height = 320, style, }) => {
     const [runs, setRuns] = useState([]);
     const [selectedIdx, setSelectedIdx] = useState(0);
     const [loading, setLoading] = useState(false);
@@ -440,12 +440,12 @@ export const TurnGraphChart = ({ serviceName, agentId, datalayerUrl, apiKey, aut
         };
     }, []);
     const fetchData = useCallback(async () => {
-        if (!datalayerUrl || !apiKey)
+        if (!otelUrl || !apiKey)
             return;
         setLoading(true);
         setError(null);
         try {
-            const client = createOtelClient({ baseUrl: datalayerUrl, token: apiKey });
+            const client = createOtelClient({ baseUrl: otelUrl, token: apiKey });
             const result = await client.fetchTraces({ serviceName, limit: 200 });
             if (mountedRef.current)
                 upsertRunsFromSpans(result.data, 'replace');
@@ -459,9 +459,9 @@ export const TurnGraphChart = ({ serviceName, agentId, datalayerUrl, apiKey, aut
             if (mountedRef.current)
                 setLoading(false);
         }
-    }, [datalayerUrl, apiKey, serviceName, upsertRunsFromSpans]);
+    }, [otelUrl, apiKey, serviceName, upsertRunsFromSpans]);
     const { connected: wsConnected, error: wsError } = useOtelWebSocket({
-        baseUrl: datalayerUrl,
+        baseUrl: otelUrl,
         token: apiKey,
         callbacks: {
             onTraces: spans => {
@@ -480,7 +480,7 @@ export const TurnGraphChart = ({ serviceName, agentId, datalayerUrl, apiKey, aut
     const selectedRun = runs[selectedIdx];
     const option = useMemo(() => (selectedRun ? buildOption(selectedRun) : null), [selectedRun]);
     // Not configured — caller didn't pass auth.
-    if (!datalayerUrl || !apiKey)
+    if (!otelUrl || !apiKey)
         return null;
     if (loading && runs.length === 0) {
         return (_jsx(Box, { sx: { color: 'fg.muted', fontSize: 1, py: 2 }, children: "Loading OTEL traces\u2026" }));

package/lib/examples/AgentEvalsExample.js

@@ -113,7 +113,7 @@ const AgentEvalsInner = ({ onLogout, executionTarget }) => {
         ? `local:${agentId}`
         : runtime?.podName || '(launching…)';
     const controlPlaneBaseUrl = import.meta.env.VITE_RUN_URL ||
-        configuration?.datalayerUrl ||
+        configuration?.aiAgentsUrl ||
         (cloudAgentBaseUrl ? new URL(cloudAgentBaseUrl).origin : '');
     const isAgentReady = executionTarget === 'local' ? localStatus === 'ready' : isReady;
     const agentStatus = executionTarget === 'local' ? localStatus : runtimeStatus;

package/lib/examples/AgentGuardrailsExample.js

@@ -41,7 +41,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 AI_AGENTS_URL_ENV = import.meta.env.VITE_DATALAYER_AI_AGENTS_URL;
 const OTEL_SERVICE_NAME = 'agent-runtimes';
 const COST_RUN_METRIC = 'agent_runtimes.capability.cost.run.usd';
 const COST_CUMULATIVE_METRIC = 'agent_runtimes.capability.cost.cumulative.usd';
@@ -224,9 +224,9 @@ const AgentGuardrailsInner = ({ onLogout, }) => {
     const otelBaseUrl = configuration?.otelInUrl ||
         OTEL_IN_BASE_URL_ENV ||
         configuration?.otelUrl ||
-        configuration?.datalayerUrl ||
+        configuration?.aiAgentsUrl ||
         OTEL_BASE_URL_ENV ||
-        DATALAYER_URL_ENV ||
+        AI_AGENTS_URL_ENV ||
         agentBaseUrl;
     const podName = agentId;
     const chatAuthToken = token === null ? undefined : token;

package/lib/examples/AgentInferenceProviderExample.js

@@ -57,7 +57,7 @@ const AgentInferenceProviderExampleInner = () => {
             return 'local inference';
         }
         const env = import.meta.env ?? {};
-        return (env.VITE_DATALAYER_AI_INFERENCE_URL || env.VITE_DATALAYER_URL || baseUrl);
+        return env.VITE_DATALAYER_AI_INFERENCE_URL || baseUrl;
     }, [provider, baseUrl]);
     const authFetch = useCallback((url, init = {}) => {
         return fetch(url, {

package/lib/examples/AgentMonitoringExample.js

@@ -41,7 +41,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 AgentMonitoringInner = ({ onLogout, }) => {
     const { token } = useSimpleAuthStore();
     const agentName = useRef(uniqueAgentId(AGENT_NAME)).current;
@@ -62,9 +62,9 @@ const AgentMonitoringInner = ({ onLogout, }) => {
     const otelBaseUrl = 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 podName = agentId;
     // The OTEL service_name resource attribute is 'agent-runtimes' (the
@@ -324,11 +324,11 @@ const AgentMonitoringInner = ({ onLogout, }) => {
                                     p: 3,
                                     borderBottom: '1px solid',
                                     borderColor: 'border.default',
-                                }, children: [_jsx(Heading, { as: "h4", sx: { fontSize: 1, mb: 2 }, children: "Token Usage" }), _jsx(TokenUsageChart, { serviceName: otelServiceName, agentId: agentId, apiKey: token ?? undefined, datalayerUrl: otelBaseUrl, liveSystemPromptTokens: liveContextSnapshot?.systemPromptTokens, liveUserMessageTokens: liveContextSnapshot?.userMessageTokens, liveAgentMessageTokens: liveContextSnapshot?.assistantMessageTokens, liveToolsUsageTokens: liveContextSnapshot?.toolTokens, liveTimestampMs: monitorLastSnapshotAt, height: 180 })] }), _jsxs(Box, { sx: {
+                                }, children: [_jsx(Heading, { as: "h4", sx: { fontSize: 1, mb: 2 }, children: "Token Usage" }), _jsx(TokenUsageChart, { serviceName: otelServiceName, agentId: agentId, apiKey: token ?? undefined, otelUrl: otelBaseUrl, liveSystemPromptTokens: liveContextSnapshot?.systemPromptTokens, liveUserMessageTokens: liveContextSnapshot?.userMessageTokens, liveAgentMessageTokens: liveContextSnapshot?.assistantMessageTokens, liveToolsUsageTokens: liveContextSnapshot?.toolTokens, liveTimestampMs: monitorLastSnapshotAt, height: 180 })] }), _jsxs(Box, { sx: {
                                     p: 3,
                                     borderBottom: '1px solid',
                                     borderColor: 'border.default',
-                                }, children: [_jsx(Heading, { as: "h4", sx: { fontSize: 1, mb: 2 }, children: "Cost" }), _jsx(CostUsageChart, { serviceName: otelServiceName, agentId: agentId, apiKey: token ?? undefined, datalayerUrl: otelBaseUrl, liveCumulativeUsd: liveCost?.cumulativeCostUsd, liveTimestampMs: monitorLastSnapshotAt, height: 180 })] }), _jsxs(Box, { sx: {
+                                }, children: [_jsx(Heading, { as: "h4", sx: { fontSize: 1, mb: 2 }, children: "Cost" }), _jsx(CostUsageChart, { serviceName: otelServiceName, agentId: agentId, apiKey: token ?? undefined, otelUrl: otelBaseUrl, liveCumulativeUsd: liveCost?.cumulativeCostUsd, liveTimestampMs: monitorLastSnapshotAt, height: 180 })] }), _jsxs(Box, { sx: {
                                     p: 3,
                                     borderBottom: '1px solid',
                                     borderColor: 'border.default',
@@ -405,7 +405,7 @@ const AgentMonitoringInner = ({ onLogout, }) => {
                                     p: 3,
                                     borderBottom: '1px solid',
                                     borderColor: 'border.default',
-                                }, children: [_jsx(Heading, { as: "h4", sx: { fontSize: 1, mb: 2 }, children: "Turn Execution Graph (OTEL traces)" }), _jsx(TurnGraphChart, { serviceName: otelServiceName, agentId: agentId, datalayerUrl: otelBaseUrl, apiKey: token ?? undefined, autoRefreshMs: 10_000, height: 280 })] })] })] })] }));
+                                }, children: [_jsx(Heading, { as: "h4", sx: { fontSize: 1, mb: 2 }, children: "Turn Execution Graph (OTEL traces)" }), _jsx(TurnGraphChart, { serviceName: otelServiceName, agentId: agentId, otelUrl: otelBaseUrl, apiKey: token ?? undefined, autoRefreshMs: 10_000, height: 280 })] })] })] })] }));
 };
 const syncTokenToIamStore = (token) => {
     import('../state/substates').then(({ iamStore }) => {

package/lib/examples/AgentOtelExample.d.ts

@@ -8,8 +8,8 @@
  * 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`:

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(),
                                     });