@datalayer/core 1.0.22 → 1.0.24

package/README.md

@@ -12,7 +12,7 @@
   <a href="https://pypi.org/project/datalayer-core/"><img src="https://img.shields.io/pypi/v/datalayer-core.svg" alt="PyPI version"></img></a>
   <a href="https://pypi.org/project/datalayer-core/"><img src="https://img.shields.io/pypi/pyversions/datalayer-core.svg" alt="Python versions"></img></a>
   <a href="https://github.com/datalayer/core/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-BSD%203--Clause-blue.svg" alt="License"></img></a>
-  <a href="https://docs.datalayer.app/"><img src="https://img.shields.io/badge/docs-datalayer.app-blue" alt="Documentation"></img></a>
+  <a href="https://datalayer.ai/docs/"><img src="https://img.shields.io/badge/docs-datalayer.app-blue" alt="Documentation"></img></a>
   <a href="https://github.com/datalayer/core/actions/workflows/py-tests.yml"><img src="https://github.com/datalayer/core/actions/workflows/py-tests.yml/badge.svg" alt="Units Tests"></img></a><a href="https://github.com/datalayer/core/actions/workflows/ts-tests.yml"><img src="https://github.com/datalayer/core/actions/workflows/ts-tests.yml/badge.svg" alt="Units Tests"></img></a>
 </p>
 
@@ -217,10 +217,10 @@ Key platform features accessible through this Client and CLI:
 
 ## Documentation
 
-- **Command Line Interface (CLI)**: [https://docs.datalayer.app/cli/](https://docs.datalayer.app/cli/)
+- **Command Line Interface (CLI)**: [https://datalayer.ai/docs/cli/](https://datalayer.ai/docs/cli/)
 - **Core Python Client**: [core.datalayer.tech/python/](https://core.datalayer.tech/python/)
-- **Platform Documentation**: [docs.datalayer.app](https://docs.datalayer.app/)
-- **API Reference**: [API documentation](https://docs.datalayer.app/api/)
+- **Platform Documentation**: [docs.datalayer.app](https://datalayer.ai/docs/)
+- **API Reference**: [API documentation](https://datalayer.ai/docs/api/)
 
 ## Development
 
@@ -317,7 +317,7 @@ This project is licensed under the [BSD 3-Clause License](https://github.com/dat
 
 ## Support
 
-- **Documentation**: [Datalayer Platform Documentation](https://docs.datalayer.app/)
+- **Documentation**: [Datalayer Platform Documentation](https://datalayer.ai/docs/)
 - **Issues**: [GitHub Issues](https://github.com/datalayer/core/issues)
 - **Community**: [Datalayer Platform](https://datalayer.app/)
 

package/lib/components/billing/BillableAccountSelect.js

@@ -12,7 +12,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * only need to provide a value/onChange pair and optionally observe the full
  * resolved account via `onSelectedAccountChange`.
  */
-import { useCallback, useEffect, useMemo, Fragment } from 'react';
+import { useCallback, useEffect, useMemo, useRef, Fragment } from 'react';
 import { ActionList, ActionMenu, Button, Flash, FormControl, Label, Spinner, Text, } from '@primer/react';
 import { OrganizationIcon, PeopleIcon, PersonIcon, } from '@primer/octicons-react';
 import { Box } from '@datalayer/primer-addons';
@@ -196,6 +196,9 @@ export function BillableAccountSelect({ value, onChange, onSelectedAccountChange
             : undefined;
         if (fromCookie)
             return fromCookie;
+        const personalEligible = eligibleBillable.find(a => a.accountType === 'user' && a.accountUid === personalAccountUid);
+        if (personalEligible)
+            return personalEligible;
         const byPrincipal = selectedPrincipalUid
             ? eligibleBillable.find(account => {
                 if (account.accountUid !== selectedPrincipalUid)
@@ -209,9 +212,6 @@ export function BillableAccountSelect({ value, onChange, onSelectedAccountChange
             : undefined;
         if (byPrincipal)
             return byPrincipal;
-        const personalEligible = eligibleBillable.find(a => a.accountType === 'user' && a.accountUid === personalAccountUid);
-        if (personalEligible)
-            return personalEligible;
         const firstOrg = eligibleBillable.find(a => a.accountType === 'organization');
         if (preferOrganizationDefault && firstOrg)
             return firstOrg;
@@ -228,10 +228,45 @@ export function BillableAccountSelect({ value, onChange, onSelectedAccountChange
         writeBillableAccountCookie(accountUid);
         onChange(accountUid);
     }, [onChange]);
+    // Apply persisted selection (cookie) once accounts are resolved. Runs once
+    // per mount so users can still change selection afterwards; falls back to
+    // personal user account when the stored uid is unknown/ineligible.
+    const initialSelectionAppliedRef = useRef(false);
+    useEffect(() => {
+        if (isLoading)
+            return;
+        if (initialSelectionAppliedRef.current)
+            return;
+        if (eligibleBillable.length === 0 && accounts.length === 0)
+            return;
+        initialSelectionAppliedRef.current = true;
+        const storedAccount = storedBillableAccountUid
+            ? eligibleBillable.find(a => a.accountUid === storedBillableAccountUid)
+            : undefined;
+        const personalAccount = eligibleBillable.find(a => a.accountType === 'user' && a.accountUid === personalAccountUid);
+        const target = storedAccount || personalAccount || preferredEligible;
+        if (!target)
+            return;
+        if (target.accountUid !== value) {
+            writeBillableAccountCookie(target.accountUid);
+            onChange(target.accountUid);
+        }
+    }, [
+        isLoading,
+        accounts,
+        eligibleBillable,
+        storedBillableAccountUid,
+        personalAccountUid,
+        preferredEligible,
+        value,
+        onChange,
+    ]);
     // Auto-select a sensible default when current value is empty/ineligible.
     useEffect(() => {
         if (isLoading)
             return;
+        if (!initialSelectionAppliedRef.current)
+            return;
         if (!preferredEligible) {
             if (value)
                 onChange('');
@@ -239,6 +274,7 @@ export function BillableAccountSelect({ value, onChange, onSelectedAccountChange
         }
         const current = accounts.find(a => a.accountUid === value);
         if (!current || !current.isEligible) {
+            writeBillableAccountCookie(preferredEligible.accountUid);
             onChange(preferredEligible.accountUid);
         }
     }, [isLoading, preferredEligible, accounts, value, onChange]);

package/lib/components/display/JupyterDialog.d.ts

@@ -33,6 +33,11 @@ export interface IDialogWrapperOptions<T> {
      * The top level text for the dialog.
      */
     title: string;
+    /**
+     * Optional async hook called before an accept button closes the dialog.
+     * Return false to keep the dialog open.
+     */
+    onWillAccept: (result: Dialog.IResult<T>) => Promise<boolean | void> | boolean | void;
 }
 /**
  * A primer dialog mimicking the JupyterLab dialog interface
@@ -45,6 +50,8 @@ export declare class JupyterDialog<T> extends ReactWidget {
     protected buttons: Dialog.IButton[];
     protected host: HTMLElement;
     protected dialogTitle?: string;
+    protected onWillAccept?: (result: Dialog.IResult<T>) => Promise<boolean | void> | boolean | void;
+    private _pendingButtonIndex;
     private _closing;
     private _result;
     /**
@@ -60,7 +67,7 @@ export declare class JupyterDialog<T> extends ReactWidget {
      * @returns a promise that resolves with the result of the dialog.
      */
     launch(): Promise<Dialog.IResult<T>>;
-    protected handleButton: (idx: number) => void;
+    protected handleButton: (idx: number) => Promise<void>;
     protected setButton: (button: Dialog.IButton) => void;
     protected setChecked: (c: boolean) => void;
     protected setValue: (v: T | Error) => void;

package/lib/components/display/JupyterDialog.js

@@ -9,7 +9,7 @@ import { ReactWidget } from '@jupyterlab/ui-components';
 import { PromiseDelegate } from '@lumino/coreutils';
 import { Widget } from '@lumino/widgets';
 import { FocusKeys } from '@primer/behaviors';
-import { Checkbox, FormControl, useFocusZone } from '@primer/react';
+import { Checkbox, FormControl, Spinner, useFocusZone } from '@primer/react';
 import { Dialog as PrimerDialog, } from '@primer/react/experimental';
 import { JupyterReactTheme } from '@datalayer/jupyter-react';
 function DialogFooter(props) {
@@ -33,6 +33,8 @@ export class JupyterDialog extends ReactWidget {
     buttons;
     host;
     dialogTitle;
+    onWillAccept;
+    _pendingButtonIndex = null;
     _closing = new PromiseDelegate();
     _result = {
         button: null,
@@ -52,6 +54,7 @@ export class JupyterDialog extends ReactWidget {
             Dialog.okButton(),
         ];
         this.dialogTitle = options.title;
+        this.onWillAccept = options.onWillAccept;
     }
     _renderBody = (props) => (_jsx(PrimerDialog.Body, { children: createElement(this.body, {
             ...props,
@@ -61,7 +64,11 @@ export class JupyterDialog extends ReactWidget {
     render() {
         // 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(JupyterReactTheme, { children: _jsx(PrimerDialog, { title: _jsx("span", { style: { color: 'var(--fgColor-default)' }, children: this.dialogTitle }), onClose: this.close, renderBody: this._renderBody, renderFooter: this._renderFooter, footerButtons: this.buttons.map((but, idx) => {
+        return (_jsx(JupyterReactTheme, { children: _jsx(PrimerDialog, { title: _jsx("span", { style: { color: 'var(--fgColor-default)' }, children: this.dialogTitle }), onClose: () => {
+                    if (this._pendingButtonIndex === null) {
+                        this.close();
+                    }
+                }, renderBody: this._renderBody, renderFooter: this._renderFooter, footerButtons: this.buttons.map((but, idx) => {
                     const footerButton = {
                         buttonType: but.displayType === 'default'
                             ? but.accept
@@ -71,8 +78,9 @@ export class JupyterDialog extends ReactWidget {
                         onClick: () => {
                             this.handleButton(idx);
                         },
-                        content: but.label,
+                        content: this._pendingButtonIndex === idx ? (_jsx(Spinner, { size: "small" })) : (but.label),
                         'aria-label': but.ariaLabel,
+                        disabled: this._pendingButtonIndex !== null,
                         autoFocus: but.accept,
                     };
                     return footerButton;
@@ -88,8 +96,30 @@ export class JupyterDialog extends ReactWidget {
         await this._closing.promise;
         return this._result;
     }
-    handleButton = (idx) => {
-        this.setButton(this.buttons[idx]);
+    handleButton = async (idx) => {
+        if (this._pendingButtonIndex !== null) {
+            return;
+        }
+        const button = this.buttons[idx];
+        this.setButton(button);
+        if (button.accept && this.onWillAccept) {
+            this._pendingButtonIndex = idx;
+            this.update();
+            try {
+                const shouldClose = await this.onWillAccept(this._result);
+                if (shouldClose === false) {
+                    this._pendingButtonIndex = null;
+                    this.update();
+                    return;
+                }
+            }
+            catch (error) {
+                this._pendingButtonIndex = null;
+                this.update();
+                throw error;
+            }
+        }
+        this._pendingButtonIndex = null;
         this.close();
     };
     setButton = (button) => {
@@ -107,6 +137,9 @@ export class JupyterDialog extends ReactWidget {
         }
     };
     close = () => {
+        if (this._pendingButtonIndex !== null) {
+            return;
+        }
         Widget.detach(this);
         this._closing.resolve();
     };

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

@@ -46,6 +46,10 @@ export interface IRuntimeLauncherDialogProps {
      * Upgrade subscription URL
      */
     upgradeSubscription?: string;
+    /**
+     * Optional submit button label override.
+     */
+    submitLabel?: string;
 }
 /**
  * Start Runtime Launcher Dialog.

package/lib/components/runtimes/RuntimeLauncherDialog.js

@@ -31,8 +31,9 @@ const NOT_AVAILABLE_RETRIES = 5;
  * Start Runtime Launcher Dialog.
  */
 export function RuntimeLauncherDialog(props) {
-    const { dialogTitle, kernelSnapshot, manager, onSubmit, markdownParser, sanitizer, upgradeSubscription, startRuntime = true, } = 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();
@@ -49,7 +50,7 @@ export function RuntimeLauncherDialog(props) {
     const jupyterReactStore = useJupyterReactStore();
     const jupyterLabAdapter = jupyterReactStore.jupyterLabAdapter;
     const [selection, setSelection] = useState((kernelSnapshot?.environment || environments[0]?.name) ?? '');
-    const [timeLimit, setTimeLimit] = useState(Math.min(credits?.available ?? 0, 10));
+    const [timeLimit, setTimeLimit] = useState(10);
     const [runtimeName, setRuntimeName] = useState(environments[0]?.runtime?.givenNameTemplate || environments[0]?.title || '');
     // Whether the runtim name has been changed by the user or not
     const [hasCustomRuntimeName, setHasCustomRuntimeName] = useState(false);
@@ -60,16 +61,36 @@ export function RuntimeLauncherDialog(props) {
     const [flashLevel, setFlashLevel] = useState('danger');
     const isMounted = useIsMounted();
     useEffect(() => {
-        if (startRuntime) {
+        if (shouldStartRuntime) {
             refreshCredits();
         }
-    }, [startRuntime]);
+    }, [shouldStartRuntime]);
     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 max = Math.floor((credits?.available ?? 0) * creditsToMinutes);
-    const outOfCredits = startRuntime && (!credits?.available || max < Number.EPSILON);
+    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);
     const handleSelectionChange = useCallback((e) => {
         const selection = e.target.value;
         setSelection(selection);
@@ -81,7 +102,7 @@ export function RuntimeLauncherDialog(props) {
     const handleSubmitRuntime = useCallback(async () => {
         if (selection) {
             setError(undefined);
-            setWaitingForRuntime(true);
+            setWaitingForRuntime(shouldStartRuntime);
             const spec = environments.find(s => s.name === selection);
             const desc = {
                 name: selection,
@@ -99,7 +120,7 @@ export function RuntimeLauncherDialog(props) {
                 desc.params['capabilities'] = ['user_storage'];
             }
             let success = true;
-            if (startRuntime && startRuntime !== 'defer') {
+            if (shouldStartRuntime) {
                 success = false;
                 let availableTrial = 1;
                 let retryDelay = NOT_AVAILABLE_INIT_RETRY;
@@ -178,6 +199,9 @@ export function RuntimeLauncherDialog(props) {
                 success = await startNewKernel();
             }
             if (success && isMounted()) {
+                if (!shouldStartRuntime) {
+                    setWaitingForRuntime(false);
+                }
                 onSubmit(desc);
             }
         }
@@ -191,6 +215,7 @@ export function RuntimeLauncherDialog(props) {
         openExample,
         jupyterLabAdapter,
         timeLimit,
+        shouldStartRuntime,
         isMounted,
     ]);
     const handleUserStorageChange = useCallback((e) => {
@@ -228,8 +253,8 @@ export function RuntimeLauncherDialog(props) {
             {
                 buttonType: 'primary',
                 onClick: handleSubmitRuntime,
-                content: waitingForRuntime ? (_jsx(Spinner, { size: "small" })) : (startRuntime ?? true) ? ('Launch') : ('Assign from the Environment'),
-                disabled: waitingForRuntime || outOfCredits || timeLimit < Number.EPSILON,
+                content: waitingForRuntime ? (_jsx(Spinner, { size: "small" })) : ((submitLabel ?? ((startRuntime ?? true) ? 'Launch' : 'Assign'))),
+                disabled: waitingForRuntime || !selection || outOfCredits,
                 autoFocus: true,
             },
         ], children: _jsxs(Box, { as: "form", onKeyDown: event => {
@@ -244,7 +269,7 @@ export function RuntimeLauncherDialog(props) {
                         ? () => {
                             navigate(USAGE_ROUTE);
                         }
-                        : undefined, disabled: outOfCredits, label: 'Time reservation', max: max, 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, 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 &&
                     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/runtimes/RuntimePickerBase.js

@@ -85,24 +85,26 @@ export function RuntimePickerBase(props) {
                         //                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(runtimeDesc => {
-                                        const annotation = runtimeDesc.podName
-                                            ? ` - ${runtimeDesc.podName.split('-', 2).reverse()[0]}`
-                                            : runtimeDesc.kernelId
-                                                ? ` - ${runtimeDesc.kernelId}`
+                                }, 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 = (runtimeDesc.displayName ?? '') + annotation;
-                                        const displayName = (runtimeDesc.displayName?.length ?? 0) >
+                                        const fullDisplayName = (candidateRuntimeDesc.displayName ?? '') + annotation;
+                                        const displayName = (candidateRuntimeDesc.displayName?.length ?? 0) >
                                             RUNTIME_DISPLAY_NAME_MAX_LENGTH
-                                            ? runtimeDesc.displayName.slice(0, RUNTIME_DISPLAY_NAME_MAX_LENGTH) + '…'
-                                            : (runtimeDesc.displayName ?? '');
-                                        return (_jsxs(ActionList.Item, { title: fullDisplayName, selected: (runtimeDesc.location === runtimeDesc?.location ||
-                                                (isRuntimeRemote(runtimeDesc.location) &&
+                                            ? 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'))) &&
-                                                (runtimeDesc.kernelId ?? runtimeDesc.name) ===
+                                                (candidateRuntimeDesc.kernelId ??
+                                                    candidateRuntimeDesc.name) ===
                                                     (runtimeDesc?.kernelId ?? runtimeDesc?.name), onSelect: () => {
-                                                setRuntimeDesc(runtimeDesc);
-                                            }, children: [_jsx(ActionList.LeadingVisual, { children: runtimeDesc.location === 'local' ? (_jsx(LaptopSimpleIcon, {})) : runtimeDesc.location === 'browser' ? (_jsx(BrowserIcon, {})) : (_jsx(CloudUploadIcon, {})) }), displayName + annotation.slice(0, 10)] }, runtimeDesc.name));
+                                                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.
@@ -110,9 +112,9 @@ export function RuntimePickerBase(props) {
         _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 (_jsxs(Box, { title: k.name, children: [_jsxs(FormControl, { children: [_jsx(Radio, { value: k.kernelId, onChange: () => {
                                                         setRuntimeDesc(k);
-                                                    }, checked: (k.location === k?.location ||
+                                                    }, checked: (k.location === runtimeDesc?.location ||
                                                         (isRuntimeRemote(k.location) &&
-                                                            isRuntimeRemote(k?.location ?? 'local'))) &&
+                                                            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.kernelId));
                             })] }, group))) })), !!postActions && _jsx(_Fragment, { children: postActions })] })) }));

package/lib/components/runtimes/RuntimePickerCell.js

@@ -99,6 +99,6 @@ export function RuntimePickerCell(props) {
     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
                         ? '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: 'Connect to the Runtime provider.', children: _jsx(ExternalTokenSilentLogin, { message: "Connect to the Runtime provider" }) })), 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: false, 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: 'Connect to the Runtime provider.', children: _jsx(ExternalTokenSilentLogin, { message: "Connect to the Runtime provider" }) })), 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 }))] }));
 }
 export default RuntimePickerCell;

package/lib/components/runtimes/RuntimePickerNotebook.js

@@ -21,9 +21,9 @@ import { RuntimePickerBase } from './RuntimePickerBase.js';
 export function RuntimePickerNotebook(props) {
     const { multiServiceManager, sessionContext, setValue, translator } = props;
     const { configuration } = useCoreStore();
-    const { credits, refreshCredits, token } = useIAMStore();
+    const { credits, refreshCredits, token, user } = useIAMStore();
     const [selectedRuntimeDesc, setSelectedRuntimeDesc] = useState();
-    const [timeLimit, setTimeLimit] = useState(Math.min(credits?.available ?? 0, 10));
+    const [timeLimit, setTimeLimit] = useState(10);
     const [userStorage, setUserStorage] = useState(false);
     const [canTransferFrom, setTransferFrom] = useState(false);
     const [canTransferTo, setTransferTo] = useState(false);
@@ -112,31 +112,96 @@ export function RuntimePickerNotebook(props) {
         setUserStorage(!userStorage);
     }, [userStorage]);
     useEffect(() => {
-        const creditsLimit = selectedRuntimeDesc?.location === 'remote' &&
-            selectedRuntimeDesc.burningRate
-            ? Math.min(timeLimit, MAXIMAL_RUNTIME_TIME_RESERVATION_MINUTES) *
-                selectedRuntimeDesc.burningRate *
+        const resolvedBurningRate = selectedRuntimeDesc?.burningRate ??
+            multiServiceManager.remote?.environments
+                .get()
+                .find(env => env.name === selectedRuntimeDesc?.name)?.burning_rate;
+        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 maxMinutes = selectedRuntimeDesc?.location === 'remote' && resolvedBurningRate
+            ? Math.floor((credits?.available ?? 0) / resolvedBurningRate / 60.0)
+            : undefined;
+        const effectiveTimeLimit = selectedRuntimeDesc?.location === 'remote'
+            ? Math.max(1, Math.min(timeLimit, maxMinutes && maxMinutes > 0 ? maxMinutes : 10))
+            : timeLimit;
+        const creditsLimit = selectedRuntimeDesc?.location === 'remote' && resolvedBurningRate
+            ? Math.min(effectiveTimeLimit, MAXIMAL_RUNTIME_TIME_RESERVATION_MINUTES) *
+                resolvedBurningRate *
                 60
             : undefined;
-        setValue(creditsLimit !== 0
-            ? {
-                runtime: selectedRuntimeDesc
-                    ? {
-                        environmentName: ['browser', 'remote'].includes(selectedRuntimeDesc.location)
-                            ? `${selectedRuntimeDesc.location}-${selectedRuntimeDesc.name}`
-                            : selectedRuntimeDesc.name,
-                        id: selectedRuntimeDesc.kernelId,
-                        creditsLimit,
-                        capabilities: userStorage ? ['user_storage'] : undefined,
-                    }
-                    : null,
-                selectedVariables: toTransfer,
+        const requiresRuntimeStart = !!selectedRuntimeDesc && !selectedRuntimeDesc.kernelId;
+        if (requiresRuntimeStart && selectedRuntimeDesc.location === 'remote') {
+            if (!resolvedBurningRate || !Number.isFinite(resolvedBurningRate)) {
+                setValue({ runtime: null, selectedVariables: toTransfer });
+                return;
+            }
+            if (hasKnownCredits &&
+                hasKnownRunAllowance &&
+                !hasRemainingRuns &&
+                (!creditsLimit || creditsLimit <= 0)) {
+                setValue({ runtime: null, selectedVariables: toTransfer });
+                return;
             }
-            : new Error('Credits limit must be strictly positive.'));
-    }, [selectedRuntimeDesc, userStorage, toTransfer, timeLimit]);
+        }
+        setValue({
+            runtime: selectedRuntimeDesc
+                ? {
+                    environmentName: ['browser', 'remote'].includes(selectedRuntimeDesc.location)
+                        ? `${selectedRuntimeDesc.location}-${selectedRuntimeDesc.name}`
+                        : selectedRuntimeDesc.name,
+                    id: selectedRuntimeDesc.kernelId,
+                    creditsLimit,
+                    capabilities: userStorage ? ['user_storage'] : undefined,
+                }
+                : null,
+            selectedVariables: toTransfer,
+        });
+    }, [
+        selectedRuntimeDesc,
+        userStorage,
+        toTransfer,
+        timeLimit,
+        multiServiceManager.remote,
+        credits?.available,
+        user,
+    ]);
     const { kernelPreference: { canStart }, } = sessionContext;
-    const max = Math.floor((credits?.available ?? 0) / (selectedRuntimeDesc?.burningRate ?? -1) / 60.0);
-    const outOfCredits = !credits?.available || max < Number.EPSILON;
+    const resolvedBurningRate = selectedRuntimeDesc?.burningRate ??
+        multiServiceManager.remote?.environments
+            .get()
+            .find(env => env.name === selectedRuntimeDesc?.name)?.burning_rate;
+    const maxFromCredits = resolvedBurningRate
+        ? Math.floor((credits?.available ?? 0) / resolvedBurningRate / 60.0)
+        : -1;
+    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 effectiveMaxMinutes = selectedRuntimeDesc?.location === 'remote'
+        ? hasKnownCredits && hasKnownRunAllowance && !hasRemainingRuns
+            ? Math.max(1, maxFromCredits)
+            : Math.max(10, maxFromCredits > 0 ? maxFromCredits : 0)
+        : Math.max(1, maxFromCredits);
+    const outOfCredits = hasKnownCredits &&
+        hasKnownRunAllowance &&
+        !hasRemainingRuns &&
+        maxFromCredits < Number.EPSILON;
     return (_jsxs(Box, { as: "form", className: "dla-Runtimes-picker", children: [_jsx(Box, { sx: { padding: 'var(--stack-padding-condensed) 0' }, children: _jsx(RuntimePickerBase, { display: "radio", disabled: canStart === false, preference: {
                         id: sessionContext.session?.id,
                         kernelDisplayName: sessionContext.kernelPreference.shouldStart
@@ -156,7 +221,7 @@ export function RuntimePickerNotebook(props) {
                   </Button>
                   */
                     _jsx(_Fragment, {})) : (_jsx(ActionList.Item, { onSelect: props.logIn, title: 'Connect to Runtime provider.', children: _jsx(ExternalTokenSilentLogin, { message: "Connect to the Runtime provider" }) })) }) }), !selectedRuntimeDesc?.kernelId &&
-                selectedRuntimeDesc?.location === 'remote' && (_jsxs(_Fragment, { children: [_jsx(RuntimeReservationControl, { disabled: outOfCredits || selectedRuntimeDesc?.location !== 'remote', label: 'Time reservation', max: max < 0 ? 1 : max, time: timeLimit, onTimeChange: setTimeLimit, error: outOfCredits && max >= 0
+                selectedRuntimeDesc?.location === 'remote' && (_jsxs(_Fragment, { children: [_jsx(RuntimeReservationControl, { disabled: outOfCredits || selectedRuntimeDesc?.location !== 'remote', label: 'Time reservation', max: effectiveMaxMinutes, time: timeLimit, onTimeChange: setTimeLimit, error: outOfCredits && maxFromCredits >= 0
                             ? 'You must add credits to your account.'
                             : timeLimit === 0
                                 ? 'You must set a time limit.'

package/lib/components/runtimes/RuntimeReservationControl.js

@@ -18,7 +18,18 @@ export const MAXIMAL_RUNTIME_TIME_RESERVATION_MINUTES = 24 * 60;
  */
 export function RuntimeReservationControl(props) {
     const { addCredits, burningRate, disabled, error, label, max: maxProps, onTimeChange, time, } = props;
-    const max = Math.min(maxProps, MAXIMAL_RUNTIME_TIME_RESERVATION_MINUTES);
+    const max = Math.max(1, Math.min(maxProps, MAXIMAL_RUNTIME_TIME_RESERVATION_MINUTES));
+    const displayedTime = Number.isFinite(time)
+        ? Math.min(max, Math.max(1, time))
+        : 1;
+    const handleTimeChange = (valueOrEvent) => {
+        const rawValue = typeof valueOrEvent === 'number'
+            ? valueOrEvent
+            : parseFloat(valueOrEvent?.target?.value);
+        if (Number.isFinite(rawValue)) {
+            onTimeChange(Math.min(max, Math.max(1, rawValue)));
+        }
+    };
     // Temporary workaround to not show disabled components.
     const hidden = disabled;
     return !hidden ? (_jsxs(FormControl, { disabled: disabled, sx: { paddingBottom: 'var(--stack-padding-condensed)' }, children: [_jsx(FormControl.Label, { children: label }), _jsxs(Box, { style: {
@@ -27,7 +38,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: time, onChange: onTimeChange, disabled: disabled, label: "", displayValue: false }), _jsx(TextInput, { type: "number", step: "1", min: "1", max: max, disabled: disabled, value: Math.min(max, time).toFixed(2), onChange: event => {
-                            onTimeChange(parseFloat(event.target.value));
-                        } }), (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_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, {}));
 }

package/lib/hooks/useCache.d.ts

@@ -233,6 +233,14 @@ export declare const queryKeys: {
     readonly growth: {
         readonly kpi: () => readonly ["growth", "kpi"];
     };
+    readonly ray: {
+        readonly all: () => readonly ["ray"];
+        readonly clusters: () => readonly ["ray", "clusters"];
+        readonly cluster: (namespace: string, clusterName: string) => readonly ["ray", "cluster", string, string];
+        readonly jobs: (namespace: string, clusterName?: string) => readonly ["ray", "jobs", string, string];
+        readonly job: (namespace: string, jobName: string) => readonly ["ray", "job", string, string];
+        readonly logs: (namespace: string, jobName: string) => readonly ["ray", "job", string, string, "logs"];
+    };
     readonly oauth2: {
         readonly authorizationUrl: (queryArgs: Record<string, string>) => readonly ["oauth2", "authz", "url", Record<string, string>];
         readonly authorizationLinkUrl: (queryArgs: Record<string, string>) => readonly ["oauth2", "authz", "url", "link", Record<string, string>];
@@ -899,6 +907,20 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
     useUserSurveys: (userId: string, options?: Omit<UseQueryOptions<unknown>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<unknown, Error>;
     useGrowthKPI: (options?: Omit<UseQueryOptions<unknown>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<unknown, Error>;
     useGrowthContactsKPI: (options?: Omit<UseQueryOptions<unknown>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<unknown, Error>;
+    useRayClusters: () => import("@tanstack/react-query").UseQueryResult<{
+        clusters: any[];
+        namespaces: string[];
+    }, Error>;
+    useRayCluster: (namespace?: string, clusterName?: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
+    useCreateRayCluster: () => import("@tanstack/react-query").UseMutationResult<any, Error, Record<string, unknown>, unknown>;
+    useDeleteRayCluster: (namespace?: string) => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
+    useRayJobs: (namespace?: string, clusterName?: string) => import("@tanstack/react-query").UseQueryResult<any[], Error>;
+    useSubmitRayJob: (clusterName: string) => import("@tanstack/react-query").UseMutationResult<any, Error, Record<string, unknown>, unknown>;
+    useDeleteRayJob: (namespace?: string) => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
+    useRayJobLogs: (jobName: string, namespace?: string, tailLines?: number, enabled?: boolean) => import("@tanstack/react-query").UseQueryResult<{
+        logs: string;
+        status: string;
+    }, Error>;
     queryKeys: {
         readonly auth: {
             readonly me: () => readonly ["auth", "me"];
@@ -1084,6 +1106,14 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
         readonly growth: {
             readonly kpi: () => readonly ["growth", "kpi"];
         };
+        readonly ray: {
+            readonly all: () => readonly ["ray"];
+            readonly clusters: () => readonly ["ray", "clusters"];
+            readonly cluster: (namespace: string, clusterName: string) => readonly ["ray", "cluster", string, string];
+            readonly jobs: (namespace: string, clusterName?: string) => readonly ["ray", "jobs", string, string];
+            readonly job: (namespace: string, jobName: string) => readonly ["ray", "job", string, string];
+            readonly logs: (namespace: string, jobName: string) => readonly ["ray", "job", string, string, "logs"];
+        };
         readonly oauth2: {
             readonly authorizationUrl: (queryArgs: Record<string, string>) => readonly ["oauth2", "authz", "url", Record<string, string>];
             readonly authorizationLinkUrl: (queryArgs: Record<string, string>) => readonly ["oauth2", "authz", "url", "link", Record<string, string>];

package/lib/hooks/useCache.js

@@ -305,6 +305,20 @@ export const queryKeys = {
     growth: {
         kpi: () => ['growth', 'kpi'],
     },
+    // Ray (Runtimes)
+    ray: {
+        all: () => ['ray'],
+        clusters: () => [...queryKeys.ray.all(), 'clusters'],
+        cluster: (namespace, clusterName) => [...queryKeys.ray.all(), 'cluster', namespace, clusterName],
+        jobs: (namespace, clusterName) => [
+            ...queryKeys.ray.all(),
+            'jobs',
+            namespace,
+            clusterName || 'all',
+        ],
+        job: (namespace, jobName) => [...queryKeys.ray.all(), 'job', namespace, jobName],
+        logs: (namespace, jobName) => [...queryKeys.ray.job(namespace, jobName), 'logs'],
+    },
     // OAuth2
     oauth2: {
         authorizationUrl: (queryArgs) => ['oauth2', 'authz', 'url', queryArgs],
@@ -2011,7 +2025,11 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         const principalUid = options?.principalUid;
         const principalKind = options?.principalKind;
         return useQuery({
-            queryKey: [...queryKeys.datasources.all(), principalUid || 'self', principalKind || ''],
+            queryKey: [
+                ...queryKeys.datasources.all(),
+                principalUid || 'self',
+                principalKind || '',
+            ],
             queryFn: async () => {
                 const resp = await requestDatalayer({
                     url: withAccountUidQuery(`${configuration.iamRunUrl}/api/iam/v1/datasources`, principalUid, principalKind),
@@ -2072,7 +2090,11 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         const principalUid = options?.principalUid;
         const principalKind = options?.principalKind;
         return useQuery({
-            queryKey: [...queryKeys.secrets.all(), principalUid || 'self', principalKind || ''],
+            queryKey: [
+                ...queryKeys.secrets.all(),
+                principalUid || 'self',
+                principalKind || '',
+            ],
             queryFn: async () => {
                 const resp = await requestDatalayer({
                     url: withAccountUidQuery(`${configuration.iamRunUrl}/api/iam/v1/secrets`, principalUid, principalKind),
@@ -2385,7 +2407,11 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         const principalUid = options?.principalUid;
         const principalKind = options?.principalKind;
         return useQuery({
-            queryKey: [...queryKeys.datasources.detail(datasourceId), principalUid || 'self', principalKind || ''],
+            queryKey: [
+                ...queryKeys.datasources.detail(datasourceId),
+                principalUid || 'self',
+                principalKind || '',
+            ],
             queryFn: async () => {
                 const resp = await requestDatalayer({
                     url: withAccountUidQuery(`${configuration.iamRunUrl}/api/iam/v1/datasources/${datasourceId}`, principalUid, principalKind),
@@ -2434,7 +2460,11 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         const principalUid = options?.principalUid;
         const principalKind = options?.principalKind;
         return useQuery({
-            queryKey: [...queryKeys.secrets.detail(secretId), principalUid || 'self', principalKind || ''],
+            queryKey: [
+                ...queryKeys.secrets.detail(secretId),
+                principalUid || 'self',
+                principalKind || '',
+            ],
             queryFn: async () => {
                 const resp = await requestDatalayer({
                     url: withAccountUidQuery(`${configuration.iamRunUrl}/api/iam/v1/secrets/${secretId}`, principalUid, principalKind),
@@ -6805,6 +6835,167 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     // ============================================================================
+    // Ray (Runtimes) Hooks
+    // ============================================================================
+    const useRayClusters = () => {
+        return useQuery({
+            queryKey: queryKeys.ray.clusters(),
+            queryFn: async () => {
+                const resp = await requestDatalayer({
+                    url: `${configuration.runtimesRunUrl}/api/runtimes/v1/ray/clusters`,
+                    method: 'GET',
+                });
+                if (!resp.success) {
+                    throw new Error(resp.message || 'Failed to fetch Ray clusters');
+                }
+                return {
+                    clusters: asArray(resp.clusters),
+                    namespaces: asArray(resp.namespaces)
+                        .map(value => String(value))
+                        .filter(Boolean),
+                };
+            },
+            ...DEFAULT_QUERY_OPTIONS,
+            refetchOnMount: true,
+            enabled: Boolean(configuration.runtimesRunUrl),
+        });
+    };
+    const useRayCluster = (namespace = 'default', clusterName = '') => {
+        return useQuery({
+            queryKey: queryKeys.ray.cluster(namespace, clusterName),
+            queryFn: async () => {
+                const resp = await requestDatalayer({
+                    url: `${configuration.runtimesRunUrl}/api/runtimes/v1/ray/clusters/${encodeURIComponent(clusterName)}?namespace=${encodeURIComponent(namespace)}`,
+                    method: 'GET',
+                });
+                if (!resp.success) {
+                    throw new Error(resp.message || 'Failed to fetch Ray cluster');
+                }
+                return resp.cluster || null;
+            },
+            ...DEFAULT_QUERY_OPTIONS,
+            enabled: Boolean(configuration.runtimesRunUrl) &&
+                Boolean(namespace) &&
+                Boolean(clusterName),
+        });
+    };
+    const useCreateRayCluster = () => {
+        return useMutation({
+            mutationFn: async (payload) => {
+                const resp = await requestDatalayer({
+                    url: `${configuration.runtimesRunUrl}/api/runtimes/v1/ray/clusters`,
+                    method: 'POST',
+                    body: payload,
+                });
+                if (resp?.success === false) {
+                    throw new Error(resp?.message || resp?.reason || 'Failed to create Ray cluster');
+                }
+                return resp;
+            },
+            onSuccess: () => {
+                queryClient.invalidateQueries({ queryKey: queryKeys.ray.all() });
+            },
+        });
+    };
+    const useDeleteRayCluster = (namespace = 'default') => {
+        return useMutation({
+            mutationFn: async (clusterName) => {
+                return requestDatalayer({
+                    url: `${configuration.runtimesRunUrl}/api/runtimes/v1/ray/clusters/${encodeURIComponent(clusterName)}?namespace=${encodeURIComponent(namespace)}`,
+                    method: 'DELETE',
+                });
+            },
+            onSuccess: () => {
+                queryClient.invalidateQueries({ queryKey: queryKeys.ray.all() });
+            },
+        });
+    };
+    const useRayJobs = (namespace = 'default', clusterName) => {
+        return useQuery({
+            queryKey: queryKeys.ray.jobs(namespace, clusterName),
+            queryFn: async () => {
+                const params = new URLSearchParams();
+                params.set('namespace', namespace);
+                if (clusterName) {
+                    params.set('cluster_name', clusterName);
+                }
+                const resp = await requestDatalayer({
+                    url: `${configuration.runtimesRunUrl}/api/runtimes/v1/ray/jobs?${params.toString()}`,
+                    method: 'GET',
+                });
+                if (!resp.success) {
+                    throw new Error(resp.message || 'Failed to fetch Ray jobs');
+                }
+                return asArray(resp.jobs);
+            },
+            ...DEFAULT_QUERY_OPTIONS,
+            enabled: Boolean(configuration.runtimesRunUrl),
+        });
+    };
+    const useSubmitRayJob = (clusterName) => {
+        return useMutation({
+            mutationFn: async (payload) => {
+                return requestDatalayer({
+                    url: `${configuration.runtimesRunUrl}/api/runtimes/v1/ray/clusters/${encodeURIComponent(clusterName)}/jobs`,
+                    method: 'POST',
+                    body: payload,
+                });
+            },
+            onSuccess: () => {
+                queryClient.invalidateQueries({ queryKey: queryKeys.ray.all() });
+            },
+        });
+    };
+    const useDeleteRayJob = (namespace = 'default') => {
+        return useMutation({
+            mutationFn: async (jobName) => {
+                return requestDatalayer({
+                    url: `${configuration.runtimesRunUrl}/api/runtimes/v1/ray/jobs/${encodeURIComponent(jobName)}?namespace=${encodeURIComponent(namespace)}`,
+                    method: 'DELETE',
+                });
+            },
+            onSuccess: () => {
+                queryClient.invalidateQueries({ queryKey: queryKeys.ray.all() });
+            },
+        });
+    };
+    const useRayJobLogs = (jobName, namespace = 'default', tailLines = 200, enabled = true) => {
+        return useQuery({
+            queryKey: queryKeys.ray.logs(namespace, jobName),
+            queryFn: async () => {
+                const params = new URLSearchParams();
+                params.set('namespace', namespace);
+                params.set('tail_lines', String(tailLines));
+                const resp = await requestDatalayer({
+                    url: `${configuration.runtimesRunUrl}/api/runtimes/v1/ray/jobs/${encodeURIComponent(jobName)}/logs?${params.toString()}`,
+                    method: 'GET',
+                    // Logs naturally 404 once a job is deleted; never surface a toast.
+                    notifyOnError: false,
+                });
+                if (!resp.success) {
+                    throw new Error(resp.message || 'Failed to fetch Ray job logs');
+                }
+                return {
+                    logs: String(resp.logs || ''),
+                    status: String(resp.status || ''),
+                };
+            },
+            ...DEFAULT_QUERY_OPTIONS,
+            enabled: Boolean(configuration.runtimesRunUrl) && Boolean(jobName) && enabled,
+            refetchOnMount: 'always',
+            refetchInterval: query => {
+                const status = String(query.state.data?.status || '').toLowerCase();
+                const terminal = [
+                    'succeeded',
+                    'failed',
+                    'stopped',
+                    'completed',
+                ].includes(status);
+                return terminal ? false : 3000;
+            },
+        });
+    };
+    // ============================================================================
     // Return all methods grouped by category
     // ============================================================================
     return {
@@ -7093,6 +7284,15 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         useUserSurveys,
         useGrowthKPI,
         useGrowthContactsKPI,
+        // Ray (Runtimes)
+        useRayClusters,
+        useRayCluster,
+        useCreateRayCluster,
+        useDeleteRayCluster,
+        useRayJobs,
+        useSubmitRayJob,
+        useDeleteRayJob,
+        useRayJobLogs,
         // Query keys for manual operations
         queryKeys,
         // Upload

package/lib/models/Page.d.ts

@@ -29,6 +29,9 @@ export type IPage = {
     screenCapture?: string;
     creator?: IUser;
     creatorId?: string;
+    selectedPrincipalUid?: string;
+    selectedPrincipalKind?: 'user' | 'organization' | 'team';
+    selectedOrganizationUid?: string;
     kernelSnapshot?: ICodeSandboxSnapshot;
     kernelSnapshotId?: string;
     createdAt?: string;

package/lib/state/substates/CoreState.js

@@ -40,7 +40,7 @@ let initialConfiguration = {
         logoUrl: 'https://assets.datalayer.tech/datalayer-25.svg',
         logoSquareUrl: 'https://assets.datalayer.tech/datalayer-square.png',
         copyright: '© 2025 Datalayer, Inc',
-        docsUrl: 'https://docs.datalayer.ai',
+        docsUrl: 'https://datalayer.ai/docs',
         supportUrl: 'https://datalayer.ai/support',
         termsUrl: 'https://datalayer.ai/terms',
         pricingUrl: 'https://datalayer.ai/pricing',

package/lib/stateful/runtimes/actions.js

@@ -8,7 +8,7 @@
 import { URLExt } from '@jupyterlab/coreutils';
 import { PromiseDelegate } from '@lumino/coreutils';
 import { Upload } from 'tus-js-client';
-import { requestDatalayerAPI, } from '../../api/index.js';
+import { requestDatalayerAPI } from '../../api/index.js';
 import { asCodeSandboxSnapshot } from '../../models/index.js';
 import { iamStore, runtimesStore } from '../../state/index.js';
 /**
@@ -30,6 +30,12 @@ export async function getEnvironments() {
  */
 export async function createRuntime(options) {
     const { externalToken, token } = iamStore.getState();
+    if (typeof options.creditsLimit !== 'number' ||
+        !Number.isFinite(options.creditsLimit) ||
+        options.creditsLimit <= 0) {
+        throw new Error(`Invalid runtime creditsLimit for environment ${options.environmentName}. ` +
+            'A positive number is required.');
+    }
     const body = {
         environment_name: options.environmentName,
         type: options.type ?? 'notebook',

package/lib/utils/Name.d.ts

@@ -5,3 +5,4 @@ export declare const namesAsInitials: (firstName: string, lastName: string) => s
  * Convert first and last names to a friendly name.
  */
 export declare const toFriendlyName: (firstName?: string, lastName?: string) => string;
+export declare const createRandomTimestampName: () => string;

package/lib/utils/Name.js

@@ -2,6 +2,11 @@
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
+import { adjectives, animals, uniqueNamesGenerator, } from 'unique-names-generator';
+const RANDOM_TIMESTAMP_NAME_CONFIGURATION = {
+    dictionaries: [adjectives, animals],
+    separator: '-',
+};
 export const asDisplayName = (givenName, familyName) => {
     return givenName
         ? familyName
@@ -34,3 +39,6 @@ export const toFriendlyName = (firstName, lastName) => {
     }
     return '';
 };
+export const createRandomTimestampName = () => {
+    return `${uniqueNamesGenerator(RANDOM_TIMESTAMP_NAME_CONFIGURATION)}-${Date.now()}`;
+};

package/lib/utils/Snapshot.js

@@ -6,7 +6,7 @@ import { adjectives, animals, uniqueNamesGenerator, } from 'unique-names-generat
 /**
  * Kernel snapshot description configuration.
  */
-const KERNEL_SNAPSHOT_DESCRIPTION_CONFIGURATION = {
+const CODE_SANDBOX_SNAPSHOT_DESCRIPTION_CONFIGURATION = {
     dictionaries: [adjectives, animals],
     separator: '-',
 };
@@ -17,5 +17,5 @@ const KERNEL_SNAPSHOT_DESCRIPTION_CONFIGURATION = {
  * @returns The kernel snapshot name
  */
 export function createSandboxSnapshotName(suffix) {
-    return `${uniqueNamesGenerator(KERNEL_SNAPSHOT_DESCRIPTION_CONFIGURATION)}-${suffix}`;
+    return `${uniqueNamesGenerator(CODE_SANDBOX_SNAPSHOT_DESCRIPTION_CONFIGURATION)}-${suffix}`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datalayer/core",
-  "version": "1.0.22",
+  "version": "1.0.24",
   "type": "module",
   "workspaces": [
     ".",