@datalayer/agent-runtimes 1.0.25 → 1.0.26

package/lib/components/{runtimes/RuntimeReservationControl.js → code-sandboxes/CodeSandboxReservationControl.js}

@@ -12,11 +12,11 @@ import { Slider } from '@datalayer/primer-addons';
  *
  * TODO this should be configurable
  */
-export const MAXIMAL_RUNTIME_TIME_RESERVATION_MINUTES = 24 * 60;
+export const MAXIMAL_CODE_SANDBOX_TIME_RESERVATION_MINUTES = 24 * 60;
 /**
  * Runtime reservation control
  */
-export function RuntimeReservationControl(props) {
+export function CodeSandboxReservationControl(props) {
     const { addCredits, burningRate, disabled, error, label, max: maxProps, onTimeChange, time, } = props;
     // The caller computes its maximum from the credits and the burning rate of
     // an environment, either of which may not be known yet — and a slider given
@@ -24,8 +24,8 @@ export function RuntimeReservationControl(props) {
     // hold in any case.
     const requestedMax = Number.isFinite(maxProps)
         ? maxProps
-        : MAXIMAL_RUNTIME_TIME_RESERVATION_MINUTES;
-    const max = Math.max(1, Math.min(requestedMax, MAXIMAL_RUNTIME_TIME_RESERVATION_MINUTES));
+        : MAXIMAL_CODE_SANDBOX_TIME_RESERVATION_MINUTES;
+    const max = Math.max(1, Math.min(requestedMax, MAXIMAL_CODE_SANDBOX_TIME_RESERVATION_MINUTES));
     const displayedTime = Number.isFinite(time)
         ? Math.min(max, Math.max(1, time))
         : 1;
@@ -45,5 +45,5 @@ export function RuntimeReservationControl(props) {
                     gridTemplateColumns: 'max-content 1fr max-content max-content',
                     gridGap: 'var(--stack-gap-condensed)',
                     width: '100%',
-                }, children: [_jsx(Slider, { step: 1, min: 1, max: max, value: displayedTime, onChange: handleTimeChange, disabled: disabled, label: "", displayValue: false }), _jsx(TextInput, { type: "number", step: "1", min: "1", max: max, disabled: disabled, value: displayedTime.toFixed(2), onChange: handleTimeChange }), (max === 0 || max > Number.EPSILON) && (_jsxs(_Fragment, { children: [_jsxs(Text, { children: ["out of ", maxProps, " available minutes"] }), addCredits && (_jsx(IconButton, { icon: PlusIcon, "aria-label": "Add credits", onClick: () => addCredits() }))] }))] }), _jsxs(FormControl.Caption, { children: ["Maximum execution time that can be consumed by the runtime. It must be less than ", (MAXIMAL_RUNTIME_TIME_RESERVATION_MINUTES / 60).toFixed(0), ' ', "hours.", burningRate && (_jsxs(_Fragment, { children: [_jsx("br", {}), `With the current value, the runtime execution will consume at most ${(time * burningRate * 60).toFixed(2)} credits.`] }))] }), error && (_jsx(FormControl.Validation, { variant: "error", children: error }))] })) : (_jsx(_Fragment, {}));
+                }, children: [_jsx(Slider, { step: 1, min: 1, max: max, value: displayedTime, onChange: handleTimeChange, disabled: disabled, label: "", displayValue: false }), _jsx(TextInput, { type: "number", step: "1", min: "1", max: max, disabled: disabled, value: displayedTime.toFixed(2), onChange: handleTimeChange }), (max === 0 || max > Number.EPSILON) && (_jsxs(_Fragment, { children: [_jsxs(Text, { children: ["out of ", maxProps, " available minutes"] }), addCredits && (_jsx(IconButton, { icon: PlusIcon, "aria-label": "Add credits", onClick: () => addCredits() }))] }))] }), _jsxs(FormControl.Caption, { children: ["Maximum execution time that can be consumed by the runtime. It must be less than ", (MAXIMAL_CODE_SANDBOX_TIME_RESERVATION_MINUTES / 60).toFixed(0), ' ', "hours.", burningRate && (_jsxs(_Fragment, { children: [_jsx("br", {}), `With the current value, the runtime execution will consume at most ${(time * burningRate * 60).toFixed(2)} credits.`] }))] }), error && (_jsx(FormControl.Validation, { variant: "error", children: error }))] })) : (_jsx(_Fragment, {}));
 }

package/lib/components/{runtimes/RuntimeTransfer.d.ts → code-sandboxes/CodeSandboxTransfer.d.ts}

@@ -1,5 +1,5 @@
 import { type IRuntimeOptions } from '../../runtimes';
-export interface RuntimeTransfer {
+export interface CodeSandboxTransfer {
     /**
      * Selected Kernel.
      */

package/lib/components/{runtimes/RuntimeUtils.d.ts → code-sandboxes/CodeSandboxUtils.d.ts}

@@ -2,14 +2,14 @@ import { SessionContext } from '@jupyterlab/apputils';
 import { ITranslator } from '@jupyterlab/translation';
 import { IMultiServiceManager } from '../../runtimes';
 import { IRuntimeDesc } from '../../models';
-export type IDatalayerRuntimeDesc = IRuntimeDesc & {
+export type IDatalayerCodeSandboxDesc = IRuntimeDesc & {
     gpu?: string;
 };
 /**
  * Create the grouped runtime descriptions.
  */
-export declare function getGroupedRuntimeDescs(multiServiceManager: IMultiServiceManager, kernelId?: string, translator?: ITranslator, filterKernels?: (desc: IDatalayerRuntimeDesc) => boolean, variant?: 'document' | 'cell'): {
-    [g: string]: IDatalayerRuntimeDesc[];
+export declare function getGroupedCodeSandboxDescs(multiServiceManager: IMultiServiceManager, kernelId?: string, translator?: ITranslator, filterKernels?: (desc: IDatalayerCodeSandboxDesc) => boolean, variant?: 'document' | 'cell'): {
+    [g: string]: IDatalayerCodeSandboxDesc[];
 } | undefined;
 /**
  * Get the default kernel name given a selector.

package/lib/components/{runtimes/RuntimeUtils.js → code-sandboxes/CodeSandboxUtils.js}

@@ -10,7 +10,7 @@ const ASSIGN_EXISTING_RUNTIME_LABEL = 'Assign an existing Runtime';
 /**
  * Create the grouped runtime descriptions.
  */
-export function getGroupedRuntimeDescs(multiServiceManager, kernelId, translator, filterKernels = () => true, variant) {
+export function getGroupedCodeSandboxDescs(multiServiceManager, kernelId, translator, filterKernels = () => true, variant) {
     translator = translator ?? nullTranslator;
     const trans = translator.load('jupyterlab');
     // The specifications land asynchronously, and a runtime that already runs

package/lib/components/code-sandboxes/CodeSandboxVariables.d.ts

@@ -0,0 +1,71 @@
+import { ReactElement } from 'react';
+import { ISessionContext } from '@jupyterlab/apputils';
+import { ITranslator } from '@jupyterlab/translation';
+import type { IRuntimeDesc } from '../../models';
+/** What {@link useCodeSandboxVariablesTransfer} answers. */
+export interface ICodeSandboxVariablesTransfer {
+    /**
+     * Whether carrying variables over is possible at all.
+     *
+     * Both ends must speak a language the snippets know how to serialize: the
+     * sandbox the variables come from, and the one they would go to.
+     */
+    available: boolean;
+    /** The variables of the current sandbox, by name and type. */
+    variables?: {
+        [name: string]: string;
+    };
+    /** Those the user chose to carry over. */
+    selected: string[];
+    setSelected: (names: string[]) => void;
+    /** Whether the user asked for the transfer at all. */
+    transfer: boolean;
+    setTransfer: (value: boolean) => void;
+}
+/**
+ * The variables of the current sandbox, and which of them to carry over.
+ *
+ * Listing them runs code in the sandbox — the snippet that names them — so it
+ * is deferred until the user asks for the transfer, and done once.
+ *
+ * @param sessionContext The session the variables are read from
+ * @param target The sandbox they would be carried to
+ * @param enabled Whether the transfer is offered at all
+ */
+export declare function useCodeSandboxVariablesTransfer(sessionContext: ISessionContext | undefined, target: IRuntimeDesc | undefined, enabled?: boolean): ICodeSandboxVariablesTransfer;
+/**
+ * {@link CodeSandboxVariables} properties
+ */
+export interface ICodeSandboxVariablesProps {
+    /**
+     * Component class name
+     */
+    className?: string;
+    /**
+     * Available kernel variables
+     *
+     * Mapping (variable name, variable type)
+     */
+    kernelVariables?: {
+        [name: string]: string;
+    };
+    /**
+     * Kernel variables to be transferred.
+     */
+    selectedVariables: string[];
+    setSelectVariable: (l: string[]) => void;
+    /**
+     * Whether to transfer the variable from the current
+     * to the selected kernel or not.
+     */
+    transferVariables: boolean;
+    setTransferVariable: (v: boolean) => void;
+    /**
+     * Application translator
+     */
+    translator?: ITranslator;
+}
+/**
+ * Runtime variables selector component.
+ */
+export declare function CodeSandboxVariables(props: ICodeSandboxVariablesProps): ReactElement;

package/lib/components/{runtimes/RuntimeVariables.js → code-sandboxes/CodeSandboxVariables.js}

@@ -3,16 +3,91 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import { useMemo } from 'react';
+import { useCallback, useMemo, useState } from 'react';
 import { IconButton, ToggleSwitch, FormControl } from '@primer/react';
 import { Box } from '@datalayer/primer-addons';
 import { Blankslate, DataTable, Table } from '@primer/react/experimental';
 import { nullTranslator } from '@jupyterlab/translation';
 import { checkIcon } from '@jupyterlab/ui-components';
+import { JSONExt } from '@lumino/coreutils';
+import { KernelExecutor } from '@datalayer/jupyter-react';
+import { RuntimeSnippetsFacade } from '../../jupyter';
+/**
+ * The variables of the current sandbox, and which of them to carry over.
+ *
+ * Listing them runs code in the sandbox — the snippet that names them — so it
+ * is deferred until the user asks for the transfer, and done once.
+ *
+ * @param sessionContext The session the variables are read from
+ * @param target The sandbox they would be carried to
+ * @param enabled Whether the transfer is offered at all
+ */
+export function useCodeSandboxVariablesTransfer(sessionContext, target, enabled = true) {
+    const [variables, setVariables] = useState();
+    const [selected, setSelectedState] = useState([]);
+    const [transfer, setTransferState] = useState(false);
+    const [listed, setListed] = useState(false);
+    const sourceLanguage = sessionContext?.session?.kernel?.name && sessionContext.specsManager.specs
+        ? sessionContext.specsManager.specs.kernelspecs[sessionContext.session.kernel.name]?.language
+        : undefined;
+    const available = enabled &&
+        RuntimeSnippetsFacade.supports(sourceLanguage ?? '') &&
+        RuntimeSnippetsFacade.supports(target?.language ?? '');
+    const list = useCallback(async () => {
+        if (listed) {
+            return;
+        }
+        setListed(true);
+        const connection = sessionContext?.session?.kernel;
+        const spec = connection &&
+            sessionContext?.specsManager.specs?.kernelspecs[connection.model.name];
+        if (!connection || !spec) {
+            setVariables({});
+            return;
+        }
+        const snippets = new RuntimeSnippetsFacade(spec.language);
+        const outputs = await new KernelExecutor({ connection }).execute(snippets.listVariables());
+        const content = outputs.get(0).data['text/plain'];
+        if (!content) {
+            setVariables({});
+            return;
+        }
+        // The payload comes quoted, as the representation of a string.
+        const listedVariables = JSON.parse(content.slice(1, content.length - 1));
+        setVariables(listedVariables);
+        // Everything is carried over unless the user says otherwise.
+        setSelectedState(Object.keys(listedVariables ?? {}));
+    }, [listed, sessionContext]);
+    const setSelected = useCallback((names) => {
+        setSelectedState(current => JSONExt.deepEqual(current, names) ? current : names);
+    }, [setSelectedState]);
+    const setTransfer = useCallback((value) => {
+        setTransferState(current => {
+            if (current === value) {
+                return current;
+            }
+            if (value) {
+                list().catch(reason => {
+                    console.error('Failed to list the variables of the sandbox', reason);
+                    setListed(false);
+                });
+            }
+            return value;
+        });
+    }, [list]);
+    return {
+        available,
+        variables,
+        selected: available && transfer ? selected : [],
+        setSelected,
+        transfer,
+        setTransfer,
+    };
+}
 /**
  * Runtime variables selector component.
  */
-export function RuntimeVariables(props) {
+export function CodeSandboxVariables(props) {
     const { className, translator, selectedVariables, setSelectVariable, transferVariables, setTransferVariable, kernelVariables, } = props;
     const trans = useMemo(() => (translator ?? nullTranslator).load('jupyterlab'), [translator]);
     const nRows = Object.keys(kernelVariables ?? {}).length;

package/lib/components/code-sandboxes/NewCodeSandboxControls.js

@@ -18,7 +18,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { FormControl, ToggleSwitch, Tooltip, IconButton } from '@primer/react';
 import { AlertIcon } from '@primer/octicons-react';
 import { useCoreStore, useIAMStore } from '../../state/substates';
-import { RuntimeReservationControl, MAXIMAL_RUNTIME_TIME_RESERVATION_MINUTES, } from '../runtimes/RuntimeReservationControl';
+import { CodeSandboxReservationControl, MAXIMAL_CODE_SANDBOX_TIME_RESERVATION_MINUTES, } from './CodeSandboxReservationControl';
 /**
  * The credits arithmetic both the launcher and the picker ask.
  *
@@ -58,7 +58,7 @@ export function useNewCodeSandboxAllowance(burningRate) {
 }
 /** The credits a time reservation stands for. */
 export function creditsLimitFor(timeLimitMinutes, burningRate) {
-    return (Math.min(timeLimitMinutes, MAXIMAL_RUNTIME_TIME_RESERVATION_MINUTES) *
+    return (Math.min(timeLimitMinutes, MAXIMAL_CODE_SANDBOX_TIME_RESERVATION_MINUTES) *
         burningRate *
         60);
 }
@@ -69,7 +69,7 @@ export function creditsLimitFor(timeLimitMinutes, burningRate) {
 export function NewCodeSandboxControls(props) {
     const { addCredits, burningRate, withReservation = true, disabled, error, max, onTimeChange, onUserStorageToggle, storageDisabled, timeLimit, userStorage, } = props;
     const { configuration } = useCoreStore();
-    return (_jsxs(_Fragment, { children: [withReservation && (_jsx(RuntimeReservationControl, { addCredits: addCredits, disabled: disabled, label: 'Time reservation', max: max, time: timeLimit, burningRate: burningRate, onTimeChange: onTimeChange, error: error })), !configuration.whiteLabel && (_jsxs(FormControl, { disabled: storageDisabled, layout: "horizontal", children: [_jsxs(FormControl.Label, { id: "new-sandbox-user-storage-label", children: ["User storage", _jsx(Tooltip, { text: "The runtime will be slower to start.", direction: "e", style: { marginLeft: 3 }, children: _jsx(IconButton, { icon: AlertIcon, "aria-label": "", variant: "invisible" }) })] }), _jsx(ToggleSwitch, { disabled: storageDisabled, checked: userStorage, size: "small", onClick: event => {
+    return (_jsxs(_Fragment, { children: [withReservation && (_jsx(CodeSandboxReservationControl, { addCredits: addCredits, disabled: disabled, label: 'Time reservation', max: max, time: timeLimit, burningRate: burningRate, onTimeChange: onTimeChange, error: error })), !configuration.whiteLabel && (_jsxs(FormControl, { disabled: storageDisabled, layout: "horizontal", children: [_jsxs(FormControl.Label, { id: "new-sandbox-user-storage-label", children: ["User storage", _jsx(Tooltip, { text: "The runtime will be slower to start.", direction: "e", style: { marginLeft: 3 }, children: _jsx(IconButton, { icon: AlertIcon, "aria-label": "", variant: "invisible" }) })] }), _jsx(ToggleSwitch, { disabled: storageDisabled, checked: userStorage, size: "small", onClick: event => {
                             event.preventDefault();
                             onUserStorageToggle();
                         }, "aria-labelledby": "new-sandbox-user-storage-label" })] }))] }));

package/lib/components/code-sandboxes/index.d.ts

@@ -1,3 +1,21 @@
-export * from './CodeSandboxPicker';
+/**
+ * The code sandboxes: what runs the code of a notebook, a document or a cell.
+ *
+ * One launcher and one picker, and everything they are made of. The launcher
+ * asks for a NEW sandbox and starts it; the picker lists what already runs
+ * next to the environments a new one could be started in. The pickers of a
+ * notebook, of a cell and of a toolbar are compositions of those two — none
+ * of them carries a second copy of either.
+ *
+ * @module components/code-sandboxes
+ */
+export * from './CodeSandboxCellVariables';
+export * from './CodeSandboxCellVariablesDialog';
 export * from './CodeSandboxLauncher';
+export * from './CodeSandboxPicker';
+export * from './CodeSandboxPickerCell';
+export * from './CodeSandboxReservationControl';
+export * from './CodeSandboxTransfer';
+export * from './CodeSandboxUtils';
+export * from './CodeSandboxVariables';
 export * from './NewCodeSandboxControls';

package/lib/components/code-sandboxes/index.js

@@ -2,6 +2,24 @@
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-export * from './CodeSandboxPicker';
+/**
+ * The code sandboxes: what runs the code of a notebook, a document or a cell.
+ *
+ * One launcher and one picker, and everything they are made of. The launcher
+ * asks for a NEW sandbox and starts it; the picker lists what already runs
+ * next to the environments a new one could be started in. The pickers of a
+ * notebook, of a cell and of a toolbar are compositions of those two — none
+ * of them carries a second copy of either.
+ *
+ * @module components/code-sandboxes
+ */
+export * from './CodeSandboxCellVariables';
+export * from './CodeSandboxCellVariablesDialog';
 export * from './CodeSandboxLauncher';
+export * from './CodeSandboxPicker';
+export * from './CodeSandboxPickerCell';
+export * from './CodeSandboxReservationControl';
+export * from './CodeSandboxTransfer';
+export * from './CodeSandboxUtils';
+export * from './CodeSandboxVariables';
 export * from './NewCodeSandboxControls';

package/lib/components/index.d.ts

@@ -1,8 +1,6 @@
-export * from './ToolApprovalCard';
-export * from './NotificationEventCard';
-export * from './OutputCard';
-export * from './AgentSummary';
 export * from './a2ui';
-export * from './runtimes';
-export * from './snapshots';
+export * from './agents';
+export * from './cards';
+export * from './code-sandboxes';
 export * from './scheduler';
+export * from './snapshots';

package/lib/components/index.js

@@ -2,11 +2,9 @@
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-export * from './ToolApprovalCard';
-export * from './NotificationEventCard';
-export * from './OutputCard';
-export * from './AgentSummary';
 export * from './a2ui';
-export * from './runtimes';
-export * from './snapshots';
+export * from './agents';
+export * from './cards';
+export * from './code-sandboxes';
 export * from './scheduler';
+export * from './snapshots';

package/lib/components/progress/CreditsIndicator.js

@@ -5,8 +5,8 @@ import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
  */
 import { useState, useEffect } from 'react';
 import { Box } from '@datalayer/primer-addons';
-import { useNavigate } from '@datalayer/core/lib/hooks/useNavigate';
 import { ConsumptionBar } from '@datalayer/core/lib/components/progress/ConsumptionBar';
+import { useNavigate } from '@datalayer/core/lib/hooks/useNavigate';
 /**
  * Credits indicator component.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datalayer/agent-runtimes",
-  "version": "1.0.25",
+  "version": "1.0.26",
   "type": "module",
   "workspaces": [
     ".",
@@ -138,7 +138,7 @@
     "@agentclientprotocol/sdk": "^0.8.0",
     "@ai-sdk/react": "4.0.23",
     "@anthropic-ai/sdk": "^0.52.0",
-    "@datalayer/core": "^1.1.48",
+    "@datalayer/core": "^1.1.57",
     "@datalayer/icons-react": "^1.0.7",
     "@datalayer/jupyter-lexical": "^1.0.16",
     "@datalayer/lexical-loro": "^1.0.0",

package/lib/components/runtimes/RuntimeLauncherDialog.d.ts

@@ -1,7 +0,0 @@
-/**
- * Moved: the launcher lives with the code sandboxes now.
- *
- * @deprecated Import from `components/code-sandboxes/CodeSandboxLauncher`.
- * @module components/runtimes/RuntimeLauncherDialog
- */
-export { CodeSandboxLauncher, RuntimeLauncherDialog, type ICodeSandboxLauncherProps, type IRuntimeLauncherDialogProps, } from '../code-sandboxes/CodeSandboxLauncher';

package/lib/components/runtimes/RuntimeLauncherDialog.js

@@ -1,11 +0,0 @@
-/*
- * Copyright (c) 2025-2026 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-/**
- * Moved: the launcher lives with the code sandboxes now.
- *
- * @deprecated Import from `components/code-sandboxes/CodeSandboxLauncher`.
- * @module components/runtimes/RuntimeLauncherDialog
- */
-export { CodeSandboxLauncher, RuntimeLauncherDialog, } from '../code-sandboxes/CodeSandboxLauncher';

package/lib/components/runtimes/RuntimePickerBase.d.ts

@@ -1,8 +0,0 @@
-/**
- * Moved: the picker lives with the code sandboxes now.
- *
- * @deprecated Import from `components/code-sandboxes/CodeSandboxPicker`.
- * @module components/runtimes/RuntimePickerBase
- */
-export { CodeSandboxPicker, RuntimePickerBase, type ICodeSandboxPickerProps, type IRuntimePickerBaseProps, } from '../code-sandboxes/CodeSandboxPicker';
-export { default } from '../code-sandboxes/CodeSandboxPicker';

package/lib/components/runtimes/RuntimePickerBase.js

@@ -1,12 +0,0 @@
-/*
- * Copyright (c) 2025-2026 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-/**
- * Moved: the picker lives with the code sandboxes now.
- *
- * @deprecated Import from `components/code-sandboxes/CodeSandboxPicker`.
- * @module components/runtimes/RuntimePickerBase
- */
-export { CodeSandboxPicker, RuntimePickerBase, } from '../code-sandboxes/CodeSandboxPicker';
-export { default } from '../code-sandboxes/CodeSandboxPicker';

package/lib/components/runtimes/RuntimePickerNotebook.d.ts

@@ -1,42 +0,0 @@
-import { ITranslator } from '@jupyterlab/translation';
-import { CommandRegistry } from '@lumino/commands';
-import type { IMultiServiceManager, IDatalayerSessionContext } from '../../runtimes';
-import { RuntimeTransfer } from './RuntimeTransfer';
-/**
- * {@link RuntimePickerNotebook} properties
- */
-export interface IRuntimePickerNotebookProps {
-    /**
-     * Callback to allow the user to login
-     */
-    logIn?: () => void;
-    /**
-     * Document session context
-     */
-    sessionContext: IDatalayerSessionContext;
-    /**
-     * Multi service manager
-     */
-    multiServiceManager: IMultiServiceManager;
-    /**
-     * Set the selected kernel
-     */
-    setValue: (v: RuntimeTransfer | Error) => void;
-    /**
-     * Close the dialog
-     */
-    close: () => void;
-    /**
-     * Command registry
-     */
-    commands: CommandRegistry;
-    /**
-     * Application translator
-     */
-    translator?: ITranslator;
-}
-/**
- * Runtime Picker components for a Notebook.
- */
-export declare function RuntimePickerNotebook(props: IRuntimePickerNotebookProps): JSX.Element;
-export default RuntimePickerNotebook;