@datalayer/core 1.0.23 → 1.0.25

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),
@@ -2144,11 +2166,12 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
             queryKey: queryKeys.tokens.all(),
             queryFn: async () => {
                 const resp = await requestDatalayer({
-                    url: `${configuration.iamRunUrl}/api/iam/v1/tokens`,
+                    url: `${configuration.iamRunUrl}/api/iam/v1/api-keys`,
                     method: 'GET',
                 });
-                if (resp.success && resp.tokens) {
-                    const tokens = resp.tokens
+                const tokenItems = asArray(resp?.apiKeys ?? resp?.api_keys ?? resp?.tokens);
+                if (resp.success && tokenItems.length > 0) {
+                    const tokens = tokenItems
                         .map((t) => {
                         const token = toToken(t);
                         if (token) {
@@ -2172,7 +2195,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         return useMutation({
             mutationFn: async (token) => {
                 const resp = await requestDatalayer({
-                    url: `${configuration.iamRunUrl}/api/iam/v1/tokens`,
+                    url: `${configuration.iamRunUrl}/api/iam/v1/api-keys`,
                     method: 'POST',
                     body: {
                         ...token,
@@ -2180,8 +2203,9 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                     },
                 });
                 // Transform the token in the response
-                if (resp.success && resp.token) {
-                    resp.token = toToken(resp.token);
+                const tokenPayload = resp?.apiKey ?? resp?.api_key ?? resp?.token;
+                if (resp.success && tokenPayload) {
+                    resp.token = toToken(tokenPayload);
                 }
                 return resp;
             },
@@ -2385,7 +2409,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 +2462,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),
@@ -2485,11 +2517,12 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
             queryKey: queryKeys.tokens.detail(tokenId),
             queryFn: async () => {
                 const resp = await requestDatalayer({
-                    url: `${configuration.iamRunUrl}/api/iam/v1/tokens/${tokenId}`,
+                    url: `${configuration.iamRunUrl}/api/iam/v1/api-keys/${tokenId}`,
                     method: 'GET',
                 });
-                if (resp.success && resp.token) {
-                    return toToken(resp.token);
+                const tokenPayload = resp?.apiKey ?? resp?.api_key ?? resp?.token;
+                if (resp.success && tokenPayload) {
+                    return toToken(tokenPayload);
                 }
                 return null;
             },
@@ -2504,14 +2537,15 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         return useMutation({
             mutationFn: async (token) => {
                 return requestDatalayer({
-                    url: `${configuration.iamRunUrl}/api/iam/v1/tokens/${token.id}`,
+                    url: `${configuration.iamRunUrl}/api/iam/v1/api-keys/${token.id}`,
                     method: 'PUT',
                     body: { ...token },
                 });
             },
             onSuccess: resp => {
-                if (resp.success && resp.token) {
-                    const tok = toToken(resp.token);
+                const tokenPayload = resp?.apiKey ?? resp?.api_key ?? resp?.token;
+                if (resp.success && tokenPayload) {
+                    const tok = toToken(tokenPayload);
                     if (tok) {
                         queryClient.setQueryData(queryKeys.tokens.detail(tok.id), tok);
                     }
@@ -2527,7 +2561,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         return useMutation({
             mutationFn: async (tokenId) => {
                 return requestDatalayer({
-                    url: `${configuration.iamRunUrl}/api/iam/v1/tokens/${tokenId}`,
+                    url: `${configuration.iamRunUrl}/api/iam/v1/api-keys/${tokenId}`,
                     method: 'DELETE',
                 });
             },
@@ -6805,6 +6839,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 +7288,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/hooks/useProjectStore.d.ts

@@ -16,7 +16,7 @@ export type ProjectRuntimeEntry = {
     agentName?: string;
     /** Agent runtime status (running, starting, terminated, etc.). */
     agentStatus?: string;
-    /** The agent spec ID used to create the runtime. */
+    /** The agentspec ID used to create the runtime. */
     agentSpecId?: string;
 };
 export type ProjectStoreState = {

package/lib/hooks/useProjects.d.ts

@@ -20,7 +20,7 @@ export type ProjectData = {
     isPublic: boolean;
     /** Attached agent (runtime) pod name, if any */
     attachedAgentPodName?: string;
-    /** Attached agent spec ID (e.g. 'data-acquisition'), if any */
+    /** Attached agentspec ID (e.g. 'data-acquisition'), if any */
     attachedAgentSpecId?: string;
 };
 /**
@@ -31,7 +31,7 @@ export type CreateProjectRequest = {
     name: string;
     /** Project description */
     description?: string;
-    /** Agent spec to attach (creates agent on project creation) */
+    /** Agentspec to attach (creates agent on project creation) */
     agentSpecId?: string;
 };
 /**

package/lib/models/IAMToken.d.ts

@@ -1,5 +1,5 @@
 export declare const asToken: (s: any) => IIAMToken;
-export type IIAMTokenVariant = 'user_token';
+export type IIAMTokenVariant = 'secret' | 'publishable' | 'restricted' | 'temporary';
 export type IIAMToken = {
     id: string;
     variant: IIAMTokenVariant;

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/models/ProjectDTO.d.ts

@@ -66,7 +66,7 @@ export declare class ProjectDTO {
     get createdAt(): Date;
     /** Attached agent runtime pod name, if any. */
     get attachedAgentPodName(): string | undefined;
-    /** Attached agent spec ID (e.g., 'data-acquisition'), if any. */
+    /** Attached agentspec ID (e.g., 'data-acquisition'), if any. */
     get attachedAgentSpecId(): string | undefined;
     /** Human-readable name of the attached agent runtime, if any. */
     get attachedAgentGivenName(): string | undefined;

package/lib/models/ProjectDTO.js

@@ -69,7 +69,7 @@ export class ProjectDTO {
         this._checkDeleted();
         return this._data.attached_agent_pod_name_s || undefined;
     }
-    /** Attached agent spec ID (e.g., 'data-acquisition'), if any. */
+    /** Attached agentspec ID (e.g., 'data-acquisition'), if any. */
     get attachedAgentSpecId() {
         this._checkDeleted();
         return this._data.attached_agent_spec_id_s || undefined;

package/lib/state/substates/CoreState.js

@@ -4,7 +4,7 @@
  */
 import { createStore } from 'zustand/vanilla';
 import { useStore } from 'zustand';
-import { configLogger } from '../../utils/logger.js';
+import { configLogger } from '../../utils/Logger.js';
 let loadConfigurationFromServer = true;
 let initialConfiguration = {
     runUrl: 'https://prod1.datalayer.run',
@@ -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/Date.d.ts

@@ -6,6 +6,13 @@ export declare const timeSince: (date: Date) => string;
  * Examples: "just now", "15m ago", "3h ago", "2d ago", "4w ago", "1y ago".
  */
 export declare const formatRelativeTime: (value?: Date | string | number, now?: Date) => string | undefined;
+/**
+ * Build a detailed datetime string suitable for tooltips.
+ *
+ * Example:
+ * "2026-06-08T16:15:32.531Z • Jun 8, 2026, 6:15:32 PM CEST (Europe/Paris)"
+ */
+export declare const formatDateTimeDetails: (value?: Date | string | number) => string | undefined;
 /**
  * Format a duration in milliseconds into a human-readable string.
  *

package/lib/utils/Date.js

@@ -76,24 +76,57 @@ export const formatRelativeTime = (value, now = new Date()) => {
     if (Number.isNaN(ts)) {
         return typeof value === 'string' ? value : undefined;
     }
-    const diffMs = Math.max(0, now.getTime() - ts);
-    const seconds = Math.floor(diffMs / 1000);
-    if (seconds < 60)
-        return 'just now';
-    const minutes = Math.floor(seconds / 60);
+    const diffMs = ts - now.getTime();
+    const inFuture = diffMs > 0;
+    const absSeconds = Math.floor(Math.abs(diffMs) / 1000);
+    if (absSeconds < 30)
+        return inFuture ? 'in a few seconds' : 'just now';
+    const withDirection = (value, unit) => {
+        return inFuture ? `in ${value}${unit}` : `${value}${unit} ago`;
+    };
+    if (absSeconds < 60)
+        return withDirection(absSeconds, 's');
+    const minutes = Math.floor(absSeconds / 60);
     if (minutes < 60)
-        return `${minutes}m ago`;
+        return withDirection(minutes, 'm');
     const hours = Math.floor(minutes / 60);
     if (hours < 24)
-        return `${hours}h ago`;
+        return withDirection(hours, 'h');
     const days = Math.floor(hours / 24);
     if (days < 7)
-        return `${days}d ago`;
+        return withDirection(days, 'd');
     const weeks = Math.floor(days / 7);
     if (weeks < 52)
-        return `${weeks}w ago`;
+        return withDirection(weeks, 'w');
     const years = Math.floor(days / 365);
-    return `${years}y ago`;
+    return withDirection(years, 'y');
+};
+/**
+ * Build a detailed datetime string suitable for tooltips.
+ *
+ * Example:
+ * "2026-06-08T16:15:32.531Z • Jun 8, 2026, 6:15:32 PM CEST (Europe/Paris)"
+ */
+export const formatDateTimeDetails = (value) => {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    const date = value instanceof Date
+        ? value
+        : typeof value === 'number'
+            ? new Date(value)
+            : new Date(value);
+    const ts = date.getTime();
+    if (Number.isNaN(ts)) {
+        return typeof value === 'string' ? value : undefined;
+    }
+    const iso = date.toISOString();
+    const zone = Intl.DateTimeFormat().resolvedOptions().timeZone || 'local';
+    const local = new Intl.DateTimeFormat(undefined, {
+        dateStyle: 'medium',
+        timeStyle: 'long',
+    }).format(date);
+    return `${iso} • ${local} (${zone})`;
 };
 /**
  * Format a duration in milliseconds into a human-readable string.

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/lib/utils/index.d.ts

@@ -15,6 +15,7 @@ export * from './Ids';
 export * from './Jwt';
 export * from './Jupyter';
 export * from './Lazy';
+export * from './Logger';
 export * from './Msc';
 export * from './Name';
 export * from './Notebook';

package/lib/utils/index.js

@@ -19,6 +19,7 @@ export * from './Ids.js';
 export * from './Jwt.js';
 export * from './Jupyter.js';
 export * from './Lazy.js';
+export * from './Logger.js';
 export * from './Msc.js';
 export * from './Name.js';
 export * from './Notebook.js';

package/lib/views/api-keys/APIKeyEdit.d.ts

@@ -0,0 +1,8 @@
+export type APIKeyEditProps = {
+    /** Route to navigate after delete. Defaults to '/settings/iam/api-keys'. */
+    apiKeysListRoute?: string;
+    /** Whether to render the local edit title header. Defaults to true. */
+    showTitle?: boolean;
+};
+export declare const APIKeyEdit: ({ apiKeysListRoute, showTitle, }?: APIKeyEditProps) => import("react/jsx-runtime").JSX.Element;
+export default APIKeyEdit;