@datalayer/agent-runtimes 1.0.25 → 1.0.28

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

@@ -3,7 +3,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import { useEffect, useMemo, useState } from 'react';
+import { useCallback, useEffect, useMemo, useRef, 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';
@@ -12,8 +12,12 @@ 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 { getGroupedRuntimeDescs, } from '../runtimes/RuntimeUtils';
+import { isRuntimeRemote, } from '../../runtimes';
+import { useIAMStore } from '../../state/substates';
+import { getGroupedCodeSandboxDescs, } from './CodeSandboxUtils';
+import { listCodeSandboxGivenNames, nextCodeSandboxGivenName, } from './CodeSandboxNames';
+import { creditsLimitFor, NewCodeSandboxControls, useNewCodeSandboxAllowance, } from './NewCodeSandboxControls';
+import { CodeSandboxVariables, useCodeSandboxVariablesTransfer, } from './CodeSandboxVariables';
 /**
  * Maximal runtime display name length after which it is trimmed.
  */
@@ -22,8 +26,23 @@ 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, postActions, preActions, preference, runtimeDesc, sessionContext, setRuntimeDesc, translator, variant, } = props;
-    const [groupedRuntimeDescs, setGroupedRuntimeDescs] = useState(getGroupedRuntimeDescs(multiServiceManager, preference?.id, translator, filterRuntime, variant));
+    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);
@@ -38,7 +57,7 @@ export function CodeSandboxPicker(props) {
             if (disposed) {
                 return;
             }
-            setGroupedRuntimeDescs(getGroupedRuntimeDescs(multiServiceManager, preference?.id, translator, filterRuntime, variant));
+            setGroupedRuntimeDescs(getGroupedCodeSandboxDescs(multiServiceManager, preference?.id, translator, filterRuntime, variant));
         };
         const refreshRuntimeModels = multiServiceManager.remote?.runtimesManager.refreshRuntimeModels?.();
         if (refreshRuntimeModels) {
@@ -80,6 +99,15 @@ export function CodeSandboxPicker(props) {
             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;
@@ -96,8 +124,24 @@ export function CodeSandboxPicker(props) {
                         }
                     });
                 });
-                if (!matched && !remoteModelsReady) {
-                    return;
+                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',
+                        });
+                    }
                 }
             }
         }
@@ -109,55 +153,195 @@ export function CodeSandboxPicker(props) {
         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);
+    /*
+     * The name a new sandbox is given.
+     *
+     * Offered from what was picked — the environment or the specification —
+     * numbered against the sandboxes that already carry that name, and written
+     * into the description so whoever creates the sandbox creates it named:
+     * `given_name` for a runtime of the platform, the name held beside a kernel
+     * of a server. Re-offered whenever another thing is picked, and left alone
+     * while the user edits it.
+     */
+    const [givenName, setGivenName] = useState('');
+    const givenNameFor = useRef(undefined);
+    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;
+    // Offer a name for what was just picked, and leave it alone afterwards: the
+    // key is the thing picked, so re-picking the same one keeps what was typed.
+    const pickedKey = isNewSandbox
+        ? `${runtimeDesc?.location}:${runtimeDesc?.name}`
+        : undefined;
+    useEffect(() => {
+        if (!pickedKey || givenNameFor.current === pickedKey) {
+            return;
+        }
+        givenNameFor.current = pickedKey;
+        const taken = [
+            ...(multiServiceManager.remote?.runtimesManager
+                .get()
+                .map(runtime => runtime.given_name)
+                .filter(Boolean) ?? []),
+            ...listCodeSandboxGivenNames(),
+        ];
+        setGivenName(nextCodeSandboxGivenName(runtimeDesc?.displayName ?? '', taken));
+    }, [multiServiceManager, pickedKey, runtimeDesc?.displayName]);
+    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,
+                    // The name the sandbox is given, carried with the choice.
+                    //
+                    // Everything else about the pick travelled in this object and the
+                    // name did not, so whoever created the sandbox had nothing to name
+                    // it with and fell back to the kernelspec: the launcher honoured
+                    // what was typed, the picker silently dropped it.
+                    displayName: runtimeDesc.displayName,
+                    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 (_jsx(_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 })] })) }));
+    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", sx: { alignItems: 'baseline' }, children: [_jsx(Box, { children: k.displayName }), k.kernelId && (_jsx(Text, { sx: {
+                                                                        ml: 2,
+                                                                        fontSize: 0,
+                                                                        color: 'fg.muted',
+                                                                        fontFamily: 'mono'
+                                                                    }, title: k.kernelId, children: k.kernelId.slice(0, 8) })), 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, givenName: givenName, onGivenNameChange: value => {
+                    setGivenName(value);
+                    if (runtimeDesc) {
+                        // The description is what the caller creates the sandbox from:
+                        // the name travels with it, rather than beside it.
+                        setRuntimeDesc({ ...runtimeDesc, displayName: value });
+                    }
+                }, 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 }))] }));
 }
-// Backward-compatible aliases (deprecated: use CodeSandboxPicker).
-export const RuntimePickerBase = CodeSandboxPicker;
 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 { type ICodeSandboxPickerProps } from '../code-sandboxes/CodeSandboxPicker';
+import { type ICodeSandboxPickerProps } from './CodeSandboxPicker';
 /**
- * {@link RuntimePickerCell} properties
+ * {@link CodeSandboxPickerCell} properties
  */
-export type IRuntimePickerCellProps = Pick<ICodeSandboxPickerProps, '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<ICodeSandboxPickerProps, '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 { CodeSandboxPicker, } from '../code-sandboxes/CodeSandboxPicker';
-import { CodeSandboxLauncher } from '../code-sandboxes/CodeSandboxLauncher';
-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();
@@ -99,6 +99,6 @@ export function RuntimePickerCell(props) {
     const datalayerMeta = model.getMetadata('datalayer') ?? {};
     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(CodeSandboxLauncher, { 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;

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,10 +1,16 @@
 import { type IRuntimeOptions } from '../../runtimes';
-export interface RuntimeTransfer {
+export interface CodeSandboxTransfer {
     /**
      * Selected Kernel.
+     *
+     * `displayName` is the name the user gave the sandbox in the picker, carried
+     * with the choice so whoever creates it can create it named — the kernels
+     * API of a server has no field for one, and a runtime of the platform takes
+     * it as its `given_name`.
      */
     runtime: Partial<Omit<IRuntimeOptions, 'kernelType'> & {
         id: string;
+        displayName: string;
     }> | null;
     /**
      * List of selected variables

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}

@@ -2,15 +2,15 @@
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import { PathExt } from '@jupyterlab/coreutils';
 import { nullTranslator } from '@jupyterlab/translation';
-const ASSIGN_NEW_RUNTIME_LABEL = 'Assign a new Runtime';
-const ASSIGN_EXISTING_REMOTE_RUNTIME_LABEL = 'Assign an existing Remote Runtime';
-const ASSIGN_EXISTING_RUNTIME_LABEL = 'Assign an existing Runtime';
+const ASSIGN_NEW_RUNTIME_LABEL = 'Assign a new Code Sandbox';
+import { ensureCodeSandboxGivenName } from './CodeSandboxNames';
+const ASSIGN_EXISTING_REMOTE_RUNTIME_LABEL = 'Assign an existing Remote Code Sandbox';
+const ASSIGN_EXISTING_RUNTIME_LABEL = 'Assign an existing Code Sandbox';
 /**
  * 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
@@ -29,7 +29,7 @@ export function getGroupedRuntimeDescs(multiServiceManager, kernelId, translator
             kernelId: session.kernel.id,
             name: spec?.name ?? session.kernel.name,
             language: spec?.language ?? '',
-            displayName: session.name || PathExt.basename(session.path),
+            displayName: ensureCodeSandboxGivenName(session.kernel.id, spec?.display_name ?? session.kernel.name),
             location: 'local',
         };
     })
@@ -43,7 +43,7 @@ export function getGroupedRuntimeDescs(multiServiceManager, kernelId, translator
             kernelId: session.kernel.id,
             name: spec?.name ?? session.kernel.name,
             language: spec?.language ?? '',
-            displayName: session.name || PathExt.basename(session.path),
+            displayName: ensureCodeSandboxGivenName(session.kernel.id, spec?.display_name ?? session.kernel.name),
             location: 'browser',
         };
     }))
@@ -58,7 +58,7 @@ export function getGroupedRuntimeDescs(multiServiceManager, kernelId, translator
             kernelId: k.id,
             name: spec?.name ?? k.name,
             language: spec?.language ?? '',
-            displayName: spec?.display_name ?? k.name,
+            displayName: ensureCodeSandboxGivenName(k.id, spec?.display_name ?? k.name),
             location: 'local',
         };
     })
@@ -72,7 +72,12 @@ export function getGroupedRuntimeDescs(multiServiceManager, kernelId, translator
             kernelId: runtime.id,
             name: environment.name,
             language: environment.language,
-            displayName: environment.title || runtime.given_name || environment.name,
+            displayName: 
+            // The name it was GIVEN first: the title of the environment is
+            // what it runs, and every sandbox of that environment answers
+            // it — the launcher asks for a name precisely so two of them
+            // can be told apart here.
+            runtime.given_name || environment.title || environment.name,
             location: 'remote',
             podName: runtime.pod_name,
             gpu: environment.resources?.['nvidia.com/gpu'],
@@ -86,7 +91,7 @@ export function getGroupedRuntimeDescs(multiServiceManager, kernelId, translator
             kernelId: k.id,
             name: spec?.name ?? k.name,
             language: spec?.language ?? '',
-            displayName: spec?.display_name ?? k.name,
+            displayName: ensureCodeSandboxGivenName(k.id, spec?.display_name ?? k.name),
             location: 'browser',
         };
     }))