@datalayer/core 1.0.23 → 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/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: true, 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: '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/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/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.23",
+  "version": "1.0.24",
   "type": "module",
   "workspaces": [
     ".",