@datalayer/agent-runtimes 1.0.21 → 1.0.26

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

@@ -5,9 +5,8 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  */
 import { useCallback, useEffect, useMemo, useState } from 'react';
 import { useIsMounted } from 'usehooks-ts';
-import { Button, FormControl, Select, Spinner, Text, TextInput, ToggleSwitch, Tooltip, IconButton, } from '@primer/react';
+import { Button, FormControl, Select, Spinner, Text, TextInput, ToggleSwitch, } from '@primer/react';
 import { Dialog } from '@primer/react/experimental';
-import { AlertIcon } from '@primer/octicons-react';
 import { Box } from '@datalayer/primer-addons';
 import { useJupyterReactStore } from '@datalayer/jupyter-react';
 import { USAGE_ROUTE } from '@datalayer/core/lib/routes';
@@ -18,7 +17,18 @@ import { createNotebook, sleep } from '@datalayer/core/lib/utils';
 import { Markdown } from '@datalayer/core/lib/components/display';
 import { Timer } from '@datalayer/core/lib/components/progress';
 import { FlashClosable } from '@datalayer/core/lib/components/flashes';
-import { RuntimeReservationControl, MAXIMAL_RUNTIME_TIME_RESERVATION_MINUTES, } from './RuntimeReservationControl';
+import { creditsLimitFor, NewCodeSandboxControls, useNewCodeSandboxAllowance, } from './NewCodeSandboxControls';
+/**
+ * The text a fragment of markup reads as.
+ *
+ * @param html Markup to read
+ */
+function asPlainText(html) {
+    if (!html || typeof DOMParser === 'undefined') {
+        return html;
+    }
+    return (new DOMParser().parseFromString(html, 'text/html').body.textContent ?? '');
+}
 /**
  * Initial time in milliseconds before retrying in case no kernels are available
  */
@@ -28,16 +38,16 @@ const NOT_AVAILABLE_INIT_RETRY = 10_000;
  */
 const NOT_AVAILABLE_RETRIES = 5;
 /**
- * Start Runtime Launcher Dialog.
+ * The launcher of a new code sandbox.
  */
-export function RuntimeLauncherDialog(props) {
+export function CodeSandboxLauncher(props) {
     const { dialogTitle, kernelSnapshot, manager, onSubmit, markdownParser, sanitizer, upgradeSubscription, submitLabel, startRuntime = true, } = props;
     const hasExample = startRuntime === 'with-example';
     const shouldStartRuntime = startRuntime !== 'defer';
     const user = iamStore.getState().user;
     const environments = manager.environments.get();
     const { configuration } = useCoreStore();
-    const { credits, refreshCredits } = useIAMStore();
+    const { refreshCredits } = useIAMStore();
     let navigate;
     try {
         // eslint-disable-next-line react-hooks/rules-of-hooks
@@ -68,29 +78,10 @@ export function RuntimeLauncherDialog(props) {
     const spec = useMemo(() => environments.find(spec => spec.name === selection), [environments, selection]);
     const description = spec?.description ?? '';
     const burningRate = spec?.burning_rate ?? 1;
-    const creditsToMinutes = 1.0 / burningRate / 60.0;
-    const includedRuns = user?.subscription?.usage?.included_runs ??
-        user?.subscription?.included_runs;
-    const currentRuns = user?.subscription?.usage?.current_runs ??
-        user?.subscription?.current_runs ??
-        user?.subscription?.used_runs;
-    const hasKnownRunAllowance = typeof includedRuns === 'number';
-    const hasRemainingRuns = hasKnownRunAllowance &&
-        typeof currentRuns === 'number' &&
-        includedRuns > 0 &&
-        currentRuns < includedRuns;
-    const hasKnownCredits = typeof credits?.available === 'number';
-    const maxFromCredits = hasKnownCredits
-        ? Math.floor((credits.available ?? 0) * creditsToMinutes)
-        : 10;
-    const effectiveMaxMinutes = hasKnownCredits && hasKnownRunAllowance && !hasRemainingRuns
-        ? Math.max(1, maxFromCredits)
-        : Math.max(10, maxFromCredits > 0 ? maxFromCredits : 0);
-    const outOfCredits = shouldStartRuntime &&
-        hasKnownCredits &&
-        hasKnownRunAllowance &&
-        !hasRemainingRuns &&
-        ((credits.available ?? 0) <= 0 || maxFromCredits < Number.EPSILON);
+    // The arithmetic the picker asks too — one copy for both, see the module.
+    const allowance = useNewCodeSandboxAllowance(burningRate);
+    const effectiveMaxMinutes = allowance.effectiveMaxMinutes;
+    const outOfCredits = shouldStartRuntime && allowance.outOfCredits;
     const handleSelectionChange = useCallback((e) => {
         const selection = e.target.value;
         setSelection(selection);
@@ -110,8 +101,7 @@ export function RuntimeLauncherDialog(props) {
                 location: 'remote',
                 displayName: runtimeName ?? spec?.title,
             };
-            const creditsLimit = Math.min(timeLimit, MAXIMAL_RUNTIME_TIME_RESERVATION_MINUTES) /
-                creditsToMinutes;
+            const creditsLimit = creditsLimitFor(timeLimit, burningRate);
             desc.params = {};
             if (startRuntime === 'defer') {
                 desc.params['creditsLimit'] = creditsLimit;
@@ -218,10 +208,6 @@ export function RuntimeLauncherDialog(props) {
         shouldStartRuntime,
         isMounted,
     ]);
-    const handleUserStorageChange = useCallback((e) => {
-        e.preventDefault();
-        setUserStorage(!userStorage);
-    }, [userStorage]);
     const handleSwitchClick = useCallback((e) => {
         e.preventDefault();
         setOpenExample(!openExample);
@@ -239,7 +225,7 @@ export function RuntimeLauncherDialog(props) {
     }, []);
     // TODO title color is enforced for JupyterLab.
     // This may be fixed in the jupyter-react theme (Primer generates h1 for the dialog title).
-    return (_jsx(Dialog, { title: _jsx("span", { style: { color: 'var(--fgColor-default)' }, children: dialogTitle || 'Launch a new Runtime' }), onClose: () => {
+    return (_jsx(Dialog, { title: _jsx("span", { style: { color: 'var(--fgColor-default)' }, children: dialogTitle || 'Launch a new Code Sandbox' }), onClose: () => {
             onSubmit(undefined);
         }, footerButtons: [
             {
@@ -265,11 +251,20 @@ export function RuntimeLauncherDialog(props) {
                     event.preventDefault();
                     handleSubmitRuntime();
                 }
-            }, children: [_jsxs(FormControl, { disabled: !!kernelSnapshot?.environment || environments.length === 0, children: [_jsx(FormControl.Label, { children: "Environment" }), _jsx(Select, { name: "environment", disabled: !!kernelSnapshot?.environment || environments.length === 0, value: selection, onChange: handleSelectionChange, block: true, children: environments.map(spec => (_jsxs(Select.Option, { value: spec.name, children: [spec.name, spec.title && (_jsxs(_Fragment, { children: [' - ', spec.title] }))] }, spec.name))) }), _jsx(FormControl.Caption, { children: _jsx(_Fragment, { children: markdownParser ? (_jsx(Box, { sx: { img: { maxWidth: '100%' } }, children: _jsx(Markdown, { text: description, markdownParser: markdownParser, sanitizer: sanitizer }) })) : (description) }) })] }), startRuntime && (_jsx(RuntimeReservationControl, { addCredits: navigate
+            }, children: [_jsxs(FormControl, { disabled: !!kernelSnapshot?.environment || environments.length === 0, children: [_jsx(FormControl.Label, { children: "Environment" }), _jsx(Select, { name: "environment", disabled: !!kernelSnapshot?.environment || environments.length === 0, value: selection, onChange: handleSelectionChange, block: true, children: environments.map(spec => (_jsxs(Select.Option, { value: spec.name, children: [spec.name, spec.title && (_jsxs(_Fragment, { children: [' - ', spec.title] }))] }, spec.name))) }), _jsx(FormControl.Caption, { children: _jsx(_Fragment, { children: markdownParser ? (_jsx(Box, { sx: { img: { maxWidth: '100%' } }, children: _jsx(Markdown, { text: description, markdownParser: markdownParser, sanitizer: sanitizer }) })) : sanitizer ? (
+                                // The description of an environment carries markup. With no
+                                // parser to render it, the sanitizer of the application is
+                                // enough to show it as what it is rather than as its tags.
+                                _jsx(Box, { sx: { img: { maxWidth: '100%' } }, dangerouslySetInnerHTML: {
+                                        __html: sanitizer.sanitize(description),
+                                    } })) : (
+                                // Neither a parser nor a sanitizer: the text of the markup,
+                                // which is still better than the markup itself.
+                                asPlainText(description)) }) })] }), _jsx(NewCodeSandboxControls, { withReservation: !!startRuntime, burningRate: burningRate, timeLimit: timeLimit, onTimeChange: setTimeLimit, max: effectiveMaxMinutes, disabled: outOfCredits, error: outOfCredits ? 'You must add credits to your account.' : undefined, addCredits: navigate
                         ? () => {
                             navigate(USAGE_ROUTE);
                         }
-                        : undefined, disabled: outOfCredits, label: 'Time reservation', max: effectiveMaxMinutes, time: timeLimit, burningRate: burningRate, onTimeChange: setTimeLimit, error: outOfCredits ? 'You must add credits to your account.' : undefined })), !configuration.whiteLabel && (_jsxs(FormControl, { layout: "horizontal", children: [_jsxs(FormControl.Label, { id: "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, { checked: userStorage, size: "small", onClick: handleUserStorageChange, "aria-labelledby": "user-storage-label" })] })), _jsxs(FormControl, { sx: { paddingTop: '10px' }, children: [_jsx(FormControl.Label, { children: "Runtime name" }), _jsx(TextInput, { name: "name", value: runtimeName, onChange: handleKernelNameChange, block: true })] }), hasExample &&
+                        : undefined, userStorage: userStorage, onUserStorageToggle: () => setUserStorage(current => !current) }), _jsxs(FormControl, { sx: { paddingTop: '10px' }, children: [_jsx(FormControl.Label, { children: "Runtime name" }), _jsx(TextInput, { name: "name", value: runtimeName, onChange: handleKernelNameChange, block: true })] }), hasExample &&
                     jupyterLabAdapter?.jupyterLab &&
                     !configuration.whiteLabel && (_jsxs(FormControl, { sx: { paddingTop: '10px' }, children: [_jsx(FormControl.Label, { id: "open-example-label", children: "Open example notebook" }), _jsx(ToggleSwitch, { disabled: !environments.find(spec => spec.name === selection)?.example, checked: openExample, size: "small", onClick: handleSwitchClick, "aria-labelledby": "open-example-label" })] })), error && (_jsx(FlashClosable, { variant: flashLevel, actions: navigate && upgradeSubscription && flashLevel === 'warning' ? (_jsx(Button, { onClick: handleUpgrade, title: 'Upgrade your subscription.', children: "Upgrade" })) : undefined, children: error }))] }) }));
 }

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

@@ -0,0 +1,96 @@
+import { ReactElement, ReactNode } from 'react';
+import { ISessionContext } from '@jupyterlab/apputils';
+import { ITranslator } from '@jupyterlab/translation';
+import { IRuntimeDesc } from '../../models';
+import { type IMultiServiceManager } from '../../runtimes';
+import type { CodeSandboxTransfer } from './CodeSandboxTransfer';
+type IDisplayMode = 'menu' | 'radio';
+/**
+ * {@link CodeSandboxPicker} properties
+ */
+export interface ICodeSandboxPickerProps {
+    /**
+     * The display mode.
+     */
+    display: IDisplayMode;
+    /**
+     * Additional actions items to be placed at the top of the picker
+     */
+    preActions?: ReactNode;
+    /**
+     * Additional actions items to be placed at the bottom of the picker
+     */
+    postActions?: ReactNode;
+    /**
+     * Whether the picker is disabled or not.
+     */
+    disabled?: boolean;
+    /**
+     * Runtime description passing this filter function will be displayed.
+     */
+    filterRuntime?: (desc: IRuntimeDesc) => boolean;
+    /**
+     * Session preference.
+     */
+    preference?: {
+        id?: string;
+        kernelDisplayName?: string;
+        language?: string;
+        location?: string;
+    };
+    /**
+     * The sandbox shown as chosen.
+     *
+     * Given with {@link setRuntimeDesc}, the choice belongs to the host — a
+     * cell keeps it in its metadata. Omitted, the picker holds it itself and
+     * reports it through {@link onTransferChange}, which is what a dialog with
+     * no state of its own needs.
+     */
+    runtimeDesc?: IRuntimeDesc;
+    /**
+     * Set runtime description.
+     */
+    setRuntimeDesc?: (desc?: IRuntimeDesc) => void;
+    /**
+     * Document session context.
+     */
+    sessionContext?: ISessionContext;
+    /**
+     * Application service manager
+     */
+    multiServiceManager: IMultiServiceManager;
+    /**
+     * Application translator.
+     */
+    translator?: ITranslator;
+    /**
+     * Change the look depending on the menu integration.
+     */
+    variant?: 'document' | 'cell';
+    /**
+     * Whether the questions of a NEW sandbox are asked below the list.
+     *
+     * They are the launcher's own — see `NewCodeSandboxControls` — and only
+     * concern a sandbox that does not run yet.
+     */
+    withNewSandboxControls?: boolean;
+    /**
+     * Whether the variables of the current sandbox may be carried to the
+     * chosen one, when both speak a language the snippets can serialize.
+     */
+    withVariablesTransfer?: boolean;
+    /**
+     * Called with the answer a dialog would return: the sandbox to assign and
+     * the variables to carry over.
+     *
+     * The sandbox is named the way the callers start it: `remote-` and
+     * `browser-` prefix an environment to start one in, a local environment is
+     * named by its specification alone, and `id` names one that already runs.
+     */
+    onTransferChange?: (transfer: CodeSandboxTransfer) => void;
+}
+/**
+ * The picker of a code sandbox: what runs already, and what could run.
+ */
+export declare function CodeSandboxPicker(props: ICodeSandboxPickerProps): ReactElement;
+export default CodeSandboxPicker;

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

@@ -0,0 +1,296 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+import { useCallback, useEffect, useMemo, useState, } from 'react';
+import { nullTranslator } from '@jupyterlab/translation';
+//import { kernelIcon } from '@jupyterlab/ui-components';
+import { ActionList, ActionMenu, IconButton, Text, RadioGroup, Radio, FormControl, LabelGroup, Label, } from '@primer/react';
+import CloudUploadIcon from '@datalayer/icons-react/data1/CloudUploadIcon';
+import { Box } from '@datalayer/primer-addons';
+import { CpuIcon } from '@primer/octicons-react';
+import { BrowserIcon, LaptopSimpleIcon } from '@datalayer/icons-react';
+import { CreditsIndicator } from '../progress';
+import { isRuntimeRemote, } from '../../runtimes';
+import { useIAMStore } from '../../state/substates';
+import { getGroupedCodeSandboxDescs, } from './CodeSandboxUtils';
+import { creditsLimitFor, NewCodeSandboxControls, useNewCodeSandboxAllowance, } from './NewCodeSandboxControls';
+import { CodeSandboxVariables, useCodeSandboxVariablesTransfer, } from './CodeSandboxVariables';
+/**
+ * Maximal runtime display name length after which it is trimmed.
+ */
+const RUNTIME_DISPLAY_NAME_MAX_LENGTH = 25;
+/**
+ * The picker of a code sandbox: what runs already, and what could run.
+ */
+export function CodeSandboxPicker(props) {
+    const { disabled, display, filterRuntime, multiServiceManager, onTransferChange, postActions, preActions, preference, sessionContext, translator, variant, withNewSandboxControls, withVariablesTransfer, } = props;
+    /*
+     * The choice, held here when the host does not hold it.
+     *
+     * A cell keeps its sandbox in its metadata and passes both the value and
+     * the setter; a dialog has nowhere to keep it, so the picker does.
+     */
+    const isControlled = props.setRuntimeDesc !== undefined;
+    const [ownRuntimeDesc, setOwnRuntimeDesc] = useState();
+    const runtimeDesc = isControlled ? props.runtimeDesc : ownRuntimeDesc;
+    const setRuntimeDesc = useCallback((desc) => {
+        if (!isControlled) {
+            setOwnRuntimeDesc(desc ? { ...desc } : undefined);
+        }
+        props.setRuntimeDesc?.(desc);
+    }, [isControlled, props.setRuntimeDesc]);
+    const [groupedRuntimeDescs, setGroupedRuntimeDescs] = useState(getGroupedCodeSandboxDescs(multiServiceManager, preference?.id, translator, filterRuntime, variant));
+    const trans = useMemo(() => (translator ?? nullTranslator).load('jupyterlab'), [translator]);
+    const [defaultSet, setDefaultSet] = useState(false);
+    const [remoteModelsReady, setRemoteModelsReady] = useState(!multiServiceManager.remote);
+    // Trick because overflow is an unknown prop of ActionMenu.Overlay.
+    const overlayProps = {
+        maxHeight: 'large',
+        width: (variant === 'cell' ? 'small' : 'auto'),
+    };
+    useEffect(() => {
+        let disposed = false;
+        const updateGroupedRuntimeDescs = () => {
+            if (disposed) {
+                return;
+            }
+            setGroupedRuntimeDescs(getGroupedCodeSandboxDescs(multiServiceManager, preference?.id, translator, filterRuntime, variant));
+        };
+        const refreshRuntimeModels = multiServiceManager.remote?.runtimesManager.refreshRuntimeModels?.();
+        if (refreshRuntimeModels) {
+            refreshRuntimeModels
+                .catch(reason => {
+                console.error('Failed to resolve remote runtimes for the runtime picker.', reason);
+            })
+                .finally(() => {
+                if (disposed) {
+                    return;
+                }
+                updateGroupedRuntimeDescs();
+                setRemoteModelsReady(true);
+            });
+        }
+        else {
+            setRemoteModelsReady(true);
+        }
+        // Recompute immediately in case a runtime changed between the initial
+        // render and connecting the manager signals.
+        updateGroupedRuntimeDescs();
+        multiServiceManager.browser?.kernels.runningChanged.connect(updateGroupedRuntimeDescs);
+        multiServiceManager.browser?.kernelspecs.specsChanged.connect(updateGroupedRuntimeDescs);
+        multiServiceManager.browser?.sessions.runningChanged.connect(updateGroupedRuntimeDescs);
+        multiServiceManager.local.kernels.runningChanged.connect(updateGroupedRuntimeDescs);
+        multiServiceManager.local.kernelspecs.specsChanged.connect(updateGroupedRuntimeDescs);
+        multiServiceManager.local.sessions.runningChanged.connect(updateGroupedRuntimeDescs);
+        multiServiceManager.remote?.runtimesManager.changed.connect(updateGroupedRuntimeDescs);
+        multiServiceManager.remote?.environments.changed.connect(updateGroupedRuntimeDescs);
+        return () => {
+            disposed = true;
+            multiServiceManager.browser?.kernels.runningChanged.disconnect(updateGroupedRuntimeDescs);
+            multiServiceManager.browser?.kernelspecs.specsChanged.disconnect(updateGroupedRuntimeDescs);
+            multiServiceManager.browser?.sessions.runningChanged.disconnect(updateGroupedRuntimeDescs);
+            multiServiceManager.local.kernels.runningChanged.disconnect(updateGroupedRuntimeDescs);
+            multiServiceManager.local.kernelspecs.specsChanged.disconnect(updateGroupedRuntimeDescs);
+            multiServiceManager.local.sessions.runningChanged.disconnect(updateGroupedRuntimeDescs);
+            multiServiceManager.remote?.runtimesManager.changed.disconnect(updateGroupedRuntimeDescs);
+            multiServiceManager.remote?.environments.changed.disconnect(updateGroupedRuntimeDescs);
+        };
+    }, [multiServiceManager, preference?.id, translator, filterRuntime, variant]);
+    /*
+     * The sandbox the session already runs on, shown as chosen.
+     *
+     * Preferably the very row of the list, so the choice is visibly one of
+     * them. A session whose sandbox is not listed — the list may leave the
+     * current one out, and the remote ones land late — is named from the
+     * specifications instead, so the picker still opens on what is running
+     * rather than on nothing.
+     */
+    useEffect(() => {
+        if (defaultSet) {
+            return;
+        }
+        if (sessionContext && groupedRuntimeDescs) {
+            const kernelId = sessionContext.session?.kernel?.id;
+            if (kernelId) {
+                let matched = false;
+                Object.entries(groupedRuntimeDescs).forEach(([group, runtimeDescs]) => {
+                    runtimeDescs.forEach(runtimeDesc => {
+                        if (runtimeDesc.kernelId === kernelId) {
+                            matched = true;
+                            setRuntimeDesc(runtimeDesc);
+                        }
+                    });
+                });
+                if (!matched) {
+                    if (!remoteModelsReady) {
+                        return;
+                    }
+                    const kernelName = sessionContext.session?.kernel?.name;
+                    const spec = kernelName
+                        ? sessionContext.specsManager.specs?.kernelspecs[kernelName]
+                        : undefined;
+                    if (spec) {
+                        setRuntimeDesc({
+                            name: spec.name,
+                            kernelId,
+                            language: spec.language,
+                            displayName: sessionContext.kernelDisplayName,
+                            location: sessionContext.location ??
+                                'local',
+                        });
+                    }
+                }
+            }
+        }
+        setDefaultSet(true);
+    }, [
+        defaultSet,
+        groupedRuntimeDescs,
+        remoteModelsReady,
+        sessionContext,
+        setRuntimeDesc,
+    ]);
+    /*
+     * What a NEW sandbox costs, and the answer the host is given.
+     *
+     * Only asked when the host wants them: a cell picking among the sandboxes
+     * that already run has neither a reservation to make nor an answer to
+     * shape. The arithmetic is the launcher's, from its own module.
+     */
+    const { refreshCredits } = useIAMStore();
+    const [timeLimit, setTimeLimit] = useState(10);
+    const [userStorage, setUserStorage] = useState(false);
+    const asksForNewSandbox = withNewSandboxControls || !!onTransferChange;
+    useEffect(() => {
+        if (asksForNewSandbox) {
+            refreshCredits();
+        }
+    }, [asksForNewSandbox]);
+    const resolvedBurningRate = runtimeDesc?.burningRate ??
+        multiServiceManager.remote?.environments
+            .get()
+            .find(env => env.name === runtimeDesc?.name)?.burning_rate;
+    const allowance = useNewCodeSandboxAllowance(resolvedBurningRate);
+    const isNewSandbox = !!runtimeDesc && !runtimeDesc.kernelId;
+    const effectiveMaxMinutes = runtimeDesc?.location === 'remote'
+        ? allowance.effectiveMaxMinutes
+        : Math.max(1, allowance.maxFromCredits ?? -1);
+    const outOfCredits = allowance.hasKnownCredits &&
+        allowance.hasKnownRunAllowance &&
+        !allowance.hasRemainingRuns &&
+        (allowance.maxFromCredits ?? -1) < Number.EPSILON;
+    const variables = useCodeSandboxVariablesTransfer(sessionContext, runtimeDesc, withVariablesTransfer);
+    const selectedVariables = variables.selected;
+    useEffect(() => {
+        if (!onTransferChange) {
+            return;
+        }
+        const maxMinutes = runtimeDesc?.location === 'remote' ? allowance.maxFromCredits : undefined;
+        const effectiveTimeLimit = runtimeDesc?.location === 'remote'
+            ? Math.max(1, Math.min(timeLimit, maxMinutes && maxMinutes > 0 ? maxMinutes : 10))
+            : timeLimit;
+        const creditsLimit = runtimeDesc?.location === 'remote' && resolvedBurningRate
+            ? creditsLimitFor(effectiveTimeLimit, resolvedBurningRate)
+            : undefined;
+        // A new remote sandbox that the account cannot pay for is no answer at
+        // all: the dialog is left with nothing to assign rather than with a
+        // start that would be refused.
+        if (isNewSandbox && runtimeDesc?.location === 'remote') {
+            if (!resolvedBurningRate || !Number.isFinite(resolvedBurningRate)) {
+                onTransferChange({ runtime: null, selectedVariables });
+                return;
+            }
+            if (allowance.hasKnownCredits &&
+                allowance.hasKnownRunAllowance &&
+                !allowance.hasRemainingRuns &&
+                (!creditsLimit || creditsLimit <= 0)) {
+                onTransferChange({ runtime: null, selectedVariables });
+                return;
+            }
+        }
+        onTransferChange({
+            runtime: runtimeDesc
+                ? {
+                    environmentName: ['browser', 'remote'].includes(runtimeDesc.location)
+                        ? `${runtimeDesc.location}-${runtimeDesc.name}`
+                        : runtimeDesc.name,
+                    id: runtimeDesc.kernelId,
+                    creditsLimit,
+                    capabilities: userStorage ? ['user_storage'] : undefined,
+                }
+                : null,
+            selectedVariables,
+        });
+    }, [
+        allowance,
+        isNewSandbox,
+        onTransferChange,
+        resolvedBurningRate,
+        runtimeDesc,
+        selectedVariables,
+        timeLimit,
+        userStorage,
+    ]);
+    // For cell using submenu instead of group would be nice unfortunately the feature
+    // is not yet implemented in the component there has been a not-great demo story.
+    // https://github.com/primer/react/pull/3585
+    return (_jsxs(_Fragment, { children: [display === 'menu' ? (
+            /*
+             * Section for Menu display.
+             */
+            _jsxs(ActionMenu, { children: [variant === 'cell' ? (_jsx(ActionMenu.Anchor, { children: _jsx(IconButton, { disabled: disabled || groupedRuntimeDescs === null, 
+                            //                icon={() => <kernelIcon.react className="dla-Cell-runtime-icon" tag={'span'} />}
+                            icon: () => (_jsx("span", { className: "dla-Cell-runtime-icon", children: _jsx(CpuIcon, {}) })), "aria-label": trans.__('Assign a Runtime to the Cell.'), title: trans.__('Assign a Runtime to the Cell.'), size: "small", variant: "invisible" }) })) : (_jsxs(ActionMenu.Button, { variant: "default", disabled: disabled || groupedRuntimeDescs === null, children: [_jsx(Text, { fontWeight: 'bold', children: trans.__('Runtime:') }), ' ' + (runtimeDesc?.displayName ?? trans.__('No Runtime'))] })), _jsx(ActionMenu.Overlay, { ...overlayProps, width: "medium", sx: { overflowY: 'auto' }, side: variant === 'cell' ? 'outside-left' : 'outside-right', children: _jsxs(ActionList, { selectionVariant: "single", children: [variant === 'cell' && (_jsxs(ActionList.Item, { selected: runtimeDesc === undefined, onSelect: () => {
+                                        setRuntimeDesc(undefined);
+                                    }, children: [preference?.location && (_jsx(ActionList.LeadingVisual, { children: preference.location === 'local' ? (_jsx(LaptopSimpleIcon, {})) : preference.location === 'browser' ? (_jsx(BrowserIcon, {})) : (_jsx(CloudUploadIcon, {})) })), trans.__('Assign the Notebook Runtime')] }, 'null')), !!preActions && preActions, Object.entries(groupedRuntimeDescs ?? {}).map(([group, runtimeDescs]) => (_jsxs(ActionList.Group, { children: [_jsx(ActionList.GroupHeading, { children: group }), runtimeDescs.map(candidateRuntimeDesc => {
+                                            const annotation = candidateRuntimeDesc.podName
+                                                ? ` - ${candidateRuntimeDesc.podName.split('-', 2).reverse()[0]}`
+                                                : candidateRuntimeDesc.kernelId
+                                                    ? ` - ${candidateRuntimeDesc.kernelId}`
+                                                    : '';
+                                            const fullDisplayName = (candidateRuntimeDesc.displayName ?? '') + annotation;
+                                            const displayName = (candidateRuntimeDesc.displayName?.length ?? 0) >
+                                                RUNTIME_DISPLAY_NAME_MAX_LENGTH
+                                                ? candidateRuntimeDesc.displayName.slice(0, RUNTIME_DISPLAY_NAME_MAX_LENGTH) + '…'
+                                                : (candidateRuntimeDesc.displayName ?? '');
+                                            return (_jsxs(ActionList.Item, { title: fullDisplayName, selected: (candidateRuntimeDesc.location ===
+                                                    runtimeDesc?.location ||
+                                                    (isRuntimeRemote(candidateRuntimeDesc.location) &&
+                                                        isRuntimeRemote(runtimeDesc?.location ?? 'local'))) &&
+                                                    (candidateRuntimeDesc.kernelId ??
+                                                        candidateRuntimeDesc.name) ===
+                                                        (runtimeDesc?.kernelId ?? runtimeDesc?.name), onSelect: () => {
+                                                    setRuntimeDesc(candidateRuntimeDesc);
+                                                }, children: [_jsx(ActionList.LeadingVisual, { children: candidateRuntimeDesc.location === 'local' ? (_jsx(LaptopSimpleIcon, {})) : candidateRuntimeDesc.location === 'browser' ? (_jsx(BrowserIcon, {})) : (_jsx(CloudUploadIcon, {})) }), displayName + annotation.slice(0, 10)] }, candidateRuntimeDesc.name));
+                                        })] }, group))), !!postActions && (_jsxs(_Fragment, { children: [_jsx(ActionList.Divider, {}), postActions] }))] }) })] })) : (
+            /*
+             * Section for Radio display.
+             */
+            _jsxs(_Fragment, { children: [defaultSet && (_jsx(RadioGroup, { name: "kernel-options", "aria-labelledby": "kernel-options", children: Object.entries(groupedRuntimeDescs ?? {}).map(([group, runtimeDescs]) => (_jsxs(Box, { children: [_jsx(Box, { as: "h4", style: { marginTop: 0 }, children: group }), runtimeDescs.map(k => {
+                                    return (
+                                    // A kernel identifies a runtime that already runs; an
+                                    // environment to start one in has none, and is named
+                                    // by where it runs and what it runs.
+                                    _jsxs(Box, { title: k.name, children: [_jsxs(FormControl, { children: [_jsx(Radio, { value: k.kernelId, onChange: () => {
+                                                            setRuntimeDesc(k);
+                                                        }, checked: (k.location === runtimeDesc?.location ||
+                                                            (isRuntimeRemote(k.location) &&
+                                                                isRuntimeRemote(runtimeDesc?.location ?? 'local'))) &&
+                                                            (k.kernelId ?? k.name) ===
+                                                                (runtimeDesc?.kernelId ?? runtimeDesc?.name) }), _jsx(FormControl.Label, { children: _jsxs(Box, { display: "flex", children: [_jsx(Box, { children: k.displayName }), k.kernelId && k.location === 'remote' && (_jsx(Box, { ml: 3, mt: 1, children: _jsx(CreditsIndicator, { kernelId: k.kernelId, serviceManager: multiServiceManager.remote }, "credits-indicator") }))] }) }), _jsx(FormControl.Caption, { children: _jsxs(LabelGroup, { sx: { marginTop: 1 }, children: [_jsx(Label, { variant: "secondary", children: k.name }), _jsx(Label, { variant: "secondary", sx: { marginLeft: 1 }, children: k.location }), k.burningRate && (_jsxs(Label, { variant: "sponsors", sx: { marginLeft: 1 }, children: [k.burningRate, " credits/second"] })), k.gpu && (_jsx(Label, { variant: "success", sx: { marginLeft: 1 }, children: "GPU" }))] }) })] }), _jsx(ActionList.Divider, {})] }, `${k.location}:${k.kernelId ?? k.name}`));
+                                })] }, group))) })), !!postActions && _jsx(_Fragment, { children: postActions })] })), withNewSandboxControls && isNewSandbox && (
+            // The user asked for a NEW sandbox: the questions are the launcher's,
+            // asked through the launcher's own controls. A sandbox of this page
+            // or of this server reserves nothing, so only the time of a remote
+            // one is asked for.
+            _jsx(NewCodeSandboxControls, { withReservation: runtimeDesc?.location === 'remote', burningRate: resolvedBurningRate, timeLimit: timeLimit, onTimeChange: setTimeLimit, max: effectiveMaxMinutes, disabled: outOfCredits, error: runtimeDesc?.location !== 'remote'
+                    ? undefined
+                    : outOfCredits && (allowance.maxFromCredits ?? -1) >= 0
+                        ? 'You must add credits to your account.'
+                        : timeLimit === 0
+                            ? 'You must set a time limit.'
+                            : undefined, userStorage: userStorage, onUserStorageToggle: () => setUserStorage(current => !current) })), variables.available && (_jsx(CodeSandboxVariables, { selectedVariables: variables.selected, setSelectVariable: variables.setSelected, transferVariables: variables.transfer, setTransferVariable: variables.setTransfer, kernelVariables: variables.variables, translator: translator }))] }));
+}
+export default CodeSandboxPicker;

package/lib/components/{runtimes/RuntimePickerCell.d.ts → code-sandboxes/CodeSandboxPickerCell.d.ts}

@@ -1,11 +1,11 @@
 import { ISessionContext } from '@jupyterlab/apputils';
 import { CodeCellModel } from '@jupyterlab/cells';
 import type { IMarkdownParser, IRenderMime } from '@jupyterlab/rendermime';
-import { IRuntimePickerBaseProps } from './RuntimePickerBase';
+import { type ICodeSandboxPickerProps } from './CodeSandboxPicker';
 /**
- * {@link RuntimePickerCell} properties
+ * {@link CodeSandboxPickerCell} properties
  */
-export type IRuntimePickerCellProps = Pick<IRuntimePickerBaseProps, 'multiServiceManager' | 'preference' | 'translator'> & {
+export type ICodeSandboxPickerCellProps = Pick<ICodeSandboxPickerProps, 'multiServiceManager' | 'preference' | 'translator'> & {
     /**
      * Callback to allow the user to login
      */
@@ -30,5 +30,5 @@ export type IRuntimePickerCellProps = Pick<IRuntimePickerBaseProps, 'multiServic
 /**
  * Runtime picker component for a cell.
  */
-export declare function RuntimePickerCell(props: IRuntimePickerCellProps): JSX.Element;
-export default RuntimePickerCell;
+export declare function CodeSandboxPickerCell(props: ICodeSandboxPickerCellProps): JSX.Element;
+export default CodeSandboxPickerCell;

package/lib/components/{runtimes/RuntimePickerCell.js → code-sandboxes/CodeSandboxPickerCell.js}

@@ -12,13 +12,13 @@ import { isRuntimeRemote } from '../../runtimes';
 import { RuntimeSnippetsFacade } from '../../jupyter';
 import { ExternalTokenSilentLogin } from '@datalayer/core/lib/components/iam';
 import { SnippetDialog } from '../../components/snippets/SnippetDialog';
-import { RuntimeLauncherDialog } from './RuntimeLauncherDialog';
-import { RuntimePickerBase } from './RuntimePickerBase';
-import { RuntimeCellVariablesDialog } from './RuntimeCellVariablesDialog';
+import { CodeSandboxPicker, } from './CodeSandboxPicker';
+import { CodeSandboxLauncher } from './CodeSandboxLauncher';
+import { CodeSandboxCellVariablesDialog } from './CodeSandboxCellVariablesDialog';
 /**
  * Runtime picker component for a cell.
  */
-export function RuntimePickerCell(props) {
+export function CodeSandboxPickerCell(props) {
     const { logIn, markdownParser, model, preference, sanitizer, multiServiceManager, sessionContext, translator, } = props;
     const { token } = useIAMStore();
     const { configuration } = useCoreStore();
@@ -97,8 +97,8 @@ export function RuntimePickerCell(props) {
         setIsKernelDialogOpen(false);
     }, [setSelectedRuntimeDesc]);
     const datalayerMeta = model.getMetadata('datalayer') ?? {};
-    return (_jsxs(_Fragment, { children: [_jsx(RuntimePickerBase, { display: "menu", filterRuntime: filterKernel, preference: preference, multiServiceManager: multiServiceManager, runtimeDesc: datalayerMeta.kernel ? datalayerMeta.kernel : undefined, setRuntimeDesc: setSelectedRuntimeDesc, variant: 'cell', preActions: _jsxs(ActionList.Item, { disabled: !multiServiceManager.remote, onSelect: setCell, selected: hasCellRuntime, title: !multiServiceManager.remote
+    return (_jsxs(_Fragment, { children: [_jsx(CodeSandboxPicker, { display: "menu", filterRuntime: filterKernel, preference: preference, multiServiceManager: multiServiceManager, runtimeDesc: datalayerMeta.kernel ? datalayerMeta.kernel : undefined, setRuntimeDesc: setSelectedRuntimeDesc, variant: 'cell', preActions: _jsxs(ActionList.Item, { disabled: !multiServiceManager.remote, onSelect: setCell, selected: hasCellRuntime, title: !multiServiceManager.remote
                         ? 'You are not connected with Datalayer.'
-                        : 'Assign a new temporary Runtime on each Cell execution.', children: [_jsx(ActionList.LeadingVisual, { children: _jsx(CloudUploadIcon, {}) }), trans.__('Assign a Cell Runtime')] }), postActions: token || !logIn ? (_jsxs(_Fragment, { children: [RuntimeSnippetsFacade.supports(preference?.language ?? '') && (_jsx(ActionList.Item, { onSelect: openVariableDialog, disabled: !isForeign, title: trans.__('Define variables to transfer between the document kernel and the cell kernel.'), children: trans.__('Define Cell Variables Transfer') })), !configuration.whiteLabel && (_jsx(ActionList.Item, { onSelect: openSnippetDialog, disabled: snippets.length === 0, title: trans.__('Inject a code snippet at the end of the cell.'), children: trans.__('Inject Code Snippet') }))] })) : (_jsx(ActionList.Item, { onSelect: props.logIn, title: 'Runtime Provider.', children: _jsx(ExternalTokenSilentLogin, { message: "Click to sign in" }) })), translator: translator }), isVariableDialogOpen && (_jsx(RuntimeCellVariablesDialog, { model: model, onClose: closeVariableDialog, preference: preference, sessionContext: sessionContext, translator: translator })), isSnippetDialogOpen && (_jsx(SnippetDialog, { language: language, model: model, snippets: snippets, onClose: closeSnippetDialog, markdownParser: markdownParser, sanitizer: sanitizer })), isKernelDialogOpen && (_jsx(RuntimeLauncherDialog, { manager: multiServiceManager.remote, onSubmit: onStartRemote, startRuntime: 'defer', submitLabel: "Assign", markdownParser: markdownParser, sanitizer: sanitizer }))] }));
+                        : 'Assign a new temporary Runtime on each Cell execution.', children: [_jsx(ActionList.LeadingVisual, { children: _jsx(CloudUploadIcon, {}) }), trans.__('Assign a Cell Runtime')] }), postActions: token || !logIn ? (_jsxs(_Fragment, { children: [RuntimeSnippetsFacade.supports(preference?.language ?? '') && (_jsx(ActionList.Item, { onSelect: openVariableDialog, disabled: !isForeign, title: trans.__('Define variables to transfer between the document kernel and the cell kernel.'), children: trans.__('Define Cell Variables Transfer') })), !configuration.whiteLabel && (_jsx(ActionList.Item, { onSelect: openSnippetDialog, disabled: snippets.length === 0, title: trans.__('Inject a code snippet at the end of the cell.'), children: trans.__('Inject Code Snippet') }))] })) : (_jsx(ActionList.Item, { onSelect: props.logIn, title: 'Runtime Provider.', children: _jsx(ExternalTokenSilentLogin, { message: "Click to sign in" }) })), translator: translator }), isVariableDialogOpen && (_jsx(CodeSandboxCellVariablesDialog, { model: model, onClose: closeVariableDialog, preference: preference, sessionContext: sessionContext, translator: translator })), isSnippetDialogOpen && (_jsx(SnippetDialog, { language: language, model: model, snippets: snippets, onClose: closeSnippetDialog, markdownParser: markdownParser, sanitizer: sanitizer })), isKernelDialogOpen && (_jsx(CodeSandboxLauncher, { manager: multiServiceManager.remote, onSubmit: onStartRemote, startRuntime: 'defer', submitLabel: "Assign", markdownParser: markdownParser, sanitizer: sanitizer }))] }));
 }
-export default RuntimePickerCell;
+export default CodeSandboxPickerCell;

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

@@ -3,11 +3,11 @@
  *
  * TODO this should be configurable
  */
-export declare const MAXIMAL_RUNTIME_TIME_RESERVATION_MINUTES: number;
+export declare const MAXIMAL_CODE_SANDBOX_TIME_RESERVATION_MINUTES: number;
 /**
  * Time control properties
  */
-export interface IKernelReservationControlProps {
+export interface ICodeSandboxReservationControlProps {
     /**
      * Callback on add credits button
      */
@@ -44,4 +44,4 @@ export interface IKernelReservationControlProps {
 /**
  * Runtime reservation control
  */
-export declare function RuntimeReservationControl(props: IKernelReservationControlProps): JSX.Element;
+export declare function CodeSandboxReservationControl(props: ICodeSandboxReservationControlProps): JSX.Element;