@datalayer/core 1.0.2 → 1.0.11

package/lib/hooks/useCache.js

@@ -272,13 +272,6 @@ export const queryKeys = {
         bySpace: (spaceId) => [...queryKeys.items.all(), 'space', spaceId],
         search: (opts) => [...queryKeys.items.all(), 'search', opts],
     },
-    // Agent Runtimes (runtimes with ai-agents environment)
-    agentRuntimes: {
-        all: () => ['agentRuntimes'],
-        lists: () => [...queryKeys.agentRuntimes.all(), 'list'],
-        details: () => [...queryKeys.agentRuntimes.all(), 'detail'],
-        detail: (podName) => [...queryKeys.agentRuntimes.details(), podName],
-    },
     // Layout
     layout: {
         byAccount: (accountHandle, spaceHandle) => spaceHandle
@@ -1362,198 +1355,6 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
             },
         });
     };
-    /**
-     * List agent runtimes (runtimes with ai-agents-env environment)
-     */
-    /**
-     * Get all agent runtimes for the current user.
-     *
-     * Note on phase/status mapping:
-     * The backend (operator) RuntimePod model does not include a 'phase' field.
-     * The operator only keeps active/assigned runtimes in its cache (OperatorCache.USER_RUNTIMES),
-     * so any runtime returned by this endpoint is inherently running or starting.
-     * Therefore, if rt.phase is undefined (which it will be), we default to 'running'.
-     * A 'paused' state would require explicit backend support to track paused runtimes.
-     */
-    const useAgentRuntimes = () => {
-        return useQuery({
-            queryKey: queryKeys.agentRuntimes.lists(),
-            queryFn: async () => {
-                const resp = await requestDatalayer({
-                    url: `${configuration.runtimesRunUrl}/api/runtimes/v1/runtimes`,
-                    method: 'GET',
-                });
-                if (resp.success && resp.runtimes) {
-                    // Filter to only include ai-agents-env runtimes
-                    const agentRuntimes = resp.runtimes
-                        .filter((rt) => rt.environment_name === 'ai-agents-env')
-                        .map((rt) => ({
-                        ...rt,
-                        // Phase/status mapping: see hook JSDoc for details.
-                        // Backend returns only active runtimes, so default to 'running'.
-                        status: rt.phase === 'Pending'
-                            ? 'starting'
-                            : rt.phase === 'Terminated'
-                                ? 'terminated'
-                                : rt.phase === 'Paused'
-                                    ? 'paused'
-                                    : rt.phase === 'Archived'
-                                        ? 'archived'
-                                        : 'running',
-                        name: rt.given_name || rt.pod_name,
-                        id: rt.pod_name,
-                        // Map ingress URL to url for UI consistency
-                        url: rt.ingress,
-                        messageCount: 0, // Default for UI compatibility
-                        agent_spec_id: rt.agent_spec_id || undefined,
-                    }));
-                    // Set detail cache for each runtime
-                    agentRuntimes.forEach((runtime) => {
-                        queryClient.setQueryData(queryKeys.agentRuntimes.detail(runtime.pod_name), runtime);
-                    });
-                    return agentRuntimes;
-                }
-                return [];
-            },
-            ...DEFAULT_QUERY_OPTIONS,
-            refetchInterval: 10000, // Refetch every 10 seconds for status updates
-            enabled: !!user,
-        });
-    };
-    /**
-     * Get a single agent runtime by pod name.
-     *
-     * Note on phase/status mapping:
-     * Same as useAgentRuntimes - the backend RuntimePod model has no 'phase' field,
-     * and only active runtimes exist in the operator cache. Default to 'running'.
-     */
-    const useAgentRuntime = (podName) => {
-        return useQuery({
-            queryKey: queryKeys.agentRuntimes.detail(podName ?? ''),
-            queryFn: async () => {
-                const resp = await requestDatalayer({
-                    url: `${configuration.runtimesRunUrl}/api/runtimes/v1/runtimes/${podName}`,
-                    method: 'GET',
-                });
-                if (resp.runtime) {
-                    const rt = resp.runtime;
-                    return {
-                        ...rt,
-                        // Phase/status mapping: see useAgentRuntimes JSDoc for details.
-                        status: rt.phase === 'Pending'
-                            ? 'starting'
-                            : rt.phase === 'Terminated'
-                                ? 'terminated'
-                                : rt.phase === 'Paused'
-                                    ? 'paused'
-                                    : rt.phase === 'Archived'
-                                        ? 'archived'
-                                        : 'running',
-                        name: rt.given_name || rt.pod_name,
-                        id: rt.pod_name,
-                        // Map ingress URL to url for UI consistency
-                        url: rt.ingress,
-                        messageCount: 0,
-                        agent_spec_id: rt.agent_spec_id || undefined,
-                    };
-                }
-                throw new Error('Failed to fetch agent runtime');
-            },
-            ...DEFAULT_QUERY_OPTIONS,
-            // Poll every 5 seconds while the runtime exists. Stop polling on error
-            // (e.g. 404 — runtime deleted, 500 — broken state) to avoid hammering the server.
-            refetchInterval: query => {
-                if (query.state.error)
-                    return false;
-                return 5000;
-            },
-            // Don't retry failed detail requests. The refetchInterval handles
-            // periodic re-checks, so retrying only generates duplicate failing requests.
-            retry: false,
-            enabled: !!podName,
-        });
-    };
-    const useCreateAgentRuntime = () => {
-        return useMutation({
-            mutationFn: async (data) => {
-                return requestDatalayer({
-                    url: `${configuration.runtimesRunUrl}/api/runtimes/v1/runtimes`,
-                    method: 'POST',
-                    body: {
-                        environment_name: data.environmentName || 'ai-agents-env',
-                        given_name: data.givenName || 'Agent',
-                        credits_limit: data.creditsLimit || 10,
-                        type: data.type || 'notebook',
-                        editor_variant: data.editorVariant || 'none',
-                        enable_codemode: data.enableCodemode ?? false,
-                        agent_spec_id: data.agentSpecId || undefined,
-                    },
-                });
-            },
-            onSuccess: resp => {
-                if (resp.success && resp.runtime) {
-                    const rt = resp.runtime;
-                    // Phase/status mapping: see useAgentRuntimes JSDoc for details.
-                    queryClient.setQueryData(queryKeys.agentRuntimes.detail(rt.pod_name), {
-                        ...rt,
-                        status: rt.phase === 'Pending'
-                            ? 'starting'
-                            : 'running',
-                        name: rt.given_name || rt.pod_name,
-                        id: rt.pod_name,
-                        // Map ingress URL to url for UI consistency
-                        url: rt.ingress,
-                        messageCount: 0,
-                        agent_spec_id: rt.agent_spec_id || undefined,
-                    });
-                    // Invalidate list
-                    queryClient.invalidateQueries({
-                        queryKey: queryKeys.agentRuntimes.all(),
-                    });
-                }
-            },
-        });
-    };
-    /**
-     * Delete agent runtime
-     */
-    const useDeleteAgentRuntime = () => {
-        return useMutation({
-            mutationFn: async (podName) => {
-                return requestDatalayer({
-                    url: `${configuration.runtimesRunUrl}/api/runtimes/v1/runtimes/${podName}`,
-                    method: 'DELETE',
-                });
-            },
-            onSuccess: (_data, podName) => {
-                // Cancel any in-flight queries for the deleted runtime so they
-                // don't re-fetch a resource that no longer exists.
-                queryClient.cancelQueries({
-                    queryKey: queryKeys.agentRuntimes.detail(podName),
-                });
-                // Remove the detail cache entry immediately — prevents React
-                // Query from triggering a stale re-fetch while the component
-                // unmounts.
-                queryClient.removeQueries({
-                    queryKey: queryKeys.agentRuntimes.detail(podName),
-                });
-                // Invalidate the list so the sidebar refreshes.
-                queryClient.invalidateQueries({
-                    queryKey: queryKeys.agentRuntimes.lists(),
-                });
-            },
-        });
-    };
-    /**
-     * Refresh agent runtimes list
-     */
-    const useRefreshAgentRuntimes = () => {
-        return () => {
-            queryClient.invalidateQueries({
-                queryKey: queryKeys.agentRuntimes.all(),
-            });
-        };
-    };
     // ============================================================================
     // Notebook Hooks
     // ============================================================================
@@ -2497,6 +2298,25 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
             },
         });
     };
+    /**
+     * Delete token by ID
+     */
+    const useDeleteToken = () => {
+        return useMutation({
+            mutationFn: async (tokenId) => {
+                return requestDatalayer({
+                    url: `${configuration.iamRunUrl}/api/iam/v1/tokens/${tokenId}`,
+                    method: 'DELETE',
+                });
+            },
+            onSuccess: (_, tokenId) => {
+                queryClient.removeQueries({
+                    queryKey: queryKeys.tokens.detail(tokenId),
+                });
+                queryClient.invalidateQueries({ queryKey: queryKeys.tokens.all() });
+            },
+        });
+    };
     /**
      * Get contact by handle
      */
@@ -4685,6 +4505,20 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
             },
         });
     };
+    /**
+     * Create URL for password change (sends clickable link via email)
+     */
+    const useCreateUrlForPasswordChange = () => {
+        return useMutation({
+            mutationFn: async ({ handle, password, passwordConfirm, }) => {
+                return requestDatalayer({
+                    url: `${configuration.iamRunUrl}/api/iam/v1/password`,
+                    method: 'PUT',
+                    body: { handle, password, passwordConfirm },
+                });
+            },
+        });
+    };
     /**
      * Confirm password change with token
      */
@@ -6237,6 +6071,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         useJoinWithInvite,
         useConfirmJoinWithToken,
         useCreateTokenForPasswordChange,
+        useCreateUrlForPasswordChange,
         useConfirmPasswordWithToken,
         useOAuth2AuthorizationURL,
         useOAuth2AuthorizationLinkURL,
@@ -6317,12 +6152,6 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         useRefreshUserSpace,
         useRefreshLayout,
         useExportSpace,
-        // Agent Runtimes (runtimes with ai-agents environment)
-        useAgentRuntime,
-        useAgentRuntimes,
-        useCreateAgentRuntime,
-        useDeleteAgentRuntime,
-        useRefreshAgentRuntimes,
         // Courses
         useCourse,
         useUpdateCourse,
@@ -6434,6 +6263,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         useTokens,
         useCreateToken,
         useUpdateToken,
+        useDeleteToken,
         // Invites
         useInvite,
         useInvitesByUser,

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. 'datalayer-ai/data-acquisition'), if any */
+    /** Attached agent spec ID (e.g. 'data-acquisition'), if any */
     attachedAgentSpecId?: string;
 };
 /**

package/lib/index.d.ts

@@ -13,3 +13,5 @@ export * as iamApi from './api/iam';
 export * as spacerApi from './api/spacer';
 export { DatalayerClient, type DatalayerClientConfig, type ClientHandlers, User, Runtime, Environment, Snapshot, Space, Notebook, LexicalDTO, Secret, Credits, Item, type RuntimeJSON, type EnvironmentJSON, type UserJSON, type RuntimeData, type EnvironmentData, type UserData, type SpaceData, type SpaceItem, type NotebookData, type LexicalData, type RuntimeSnapshotData, type CreditsInfo, type CreditReservation, type CreateRuntimeRequest, type CreateRuntimeResponse, type ListRuntimesResponse, type ListEnvironmentsResponse, type CreateRuntimeSnapshotRequest, type CreateRuntimeSnapshotResponse, type GetRuntimeSnapshotResponse, type ListRuntimeSnapshotsResponse, type CreateSpaceRequest, type CreateSpaceResponse, type SpacesForUserResponse, type CollaborationSessionResponse, type DeleteSpaceItemResponse, type GetSpaceItemResponse, type GetSpaceItemsResponse, type CreateNotebookRequest, type CreateNotebookResponse, type GetNotebookResponse, type UpdateNotebookRequest, type UpdateNotebookResponse, type CreateLexicalRequest, type CreateLexicalResponse, type GetLexicalResponse, type UpdateLexicalRequest, type UpdateLexicalResponse, type CreditsResponse, type CreateDatasourceResponse, type GetDatasourceResponse, type ListDatasourcesResponse, type UpdateDatasourceResponse, type CreateSecretRequest, type CreateSecretResponse, type GetSecretResponse, type ListSecretsResponse, type UpdateSecretRequest, type UpdateSecretResponse, type SpaceJSON, type NotebookJSON, type LexicalJSON, type RuntimeSnapshotJSON, HealthCheck, type HealthCheckJSON, type LoginRequest, type LoginResponse, type UserMeResponse, type MembershipsResponse, type WhoAmIResponse, type HealthzPingResponse, AuthenticationManager, type IUser, type IBaseUser, type ICell, type IDatasource, type IDatasourceVariant, type ICredits, type ICreditsReservation, type ISpaceItem, type ISurvey, type ISpace, type IBaseSpace, type IAnySpace, type ISpaceVariant, type IBaseTeam, type IAnyTeam, type IOrganization, type IAnyOrganization, type IBaseOrganization, type IRuntimeModel, type IRuntimePod, type IRuntimeType, type IRuntimeLocation, type IRuntimeCapabilities, type IRuntimeSnapshot, type IDatalayerEnvironment, type IResources, type ISnippet, type IRole, type IAssignment, type IContact, type ICourse, type IOrganizationMember, type IPage, type PageTagName, type PageTheme, type PageVariant, type ISecret, type ISecretVariant, type SecretData, type SecretJSON, type DatasourceData, type DatasourceJSON, type DatasourceType, type CreateDatasourceRequest, type UpdateDatasourceRequest, Datasource, type IIAMToken, type IIAMTokenVariant, type IDocument, type IBaseDocument, type IEnvironment, type IExercise, type ICode, type IHelp, type IInvite, type ILesson, type INotebook, type IBaseNotebook, type ISchool, type ITeam, type TeamMember, type IUserOnboarding, type IClient, type IOnboardingPosition, type IOnboardingTours, type ITour, type ITourStatus, type IUserSettings, type IDataset, type IUsage, type IItem, type IItemType, type Member, type Profile, type SpaceMember, type IContactEvent, type IContactIAMProvider, type IStudentItem, type Instructor, type IStudent, type IDean, type IUserEvent, type IIAMProviderLinked, type IContent, type AuthResult, type TokenValidationResult, type AuthOptions, type TokenStorage, type IRuntimeOptions, type IMultiServiceManager, type IRemoteServicesManager, type IEnvironmentsManager, type IRemoteRuntimesManager, type NavigationLinkProps, type IDatalayerCoreConfig, type IRuntimesConfiguration, type IIAMProviderName, } from './client';
 export { getEnvironments, createRuntime, getRuntimes, deleteRuntime, snapshotRuntime, getRuntimeSnapshots, loadRuntimeSnapshot, } from './stateful/runtimes/actions';
+export * from './otel';
+export * from './views';

package/lib/index.js

@@ -26,3 +26,7 @@ User, Runtime, Environment, Snapshot, Space, Notebook, LexicalDTO, Secret, Credi
 AuthenticationManager, Datasource, } from './client';
 // Export commonly used functions directly for convenience
 export { getEnvironments, createRuntime, getRuntimes, deleteRuntime, snapshotRuntime, getRuntimeSnapshots, loadRuntimeSnapshot, } from './stateful/runtimes/actions';
+// OTEL observability components, hooks, and types
+export * from './otel';
+// Reusable views (sign-in pages, etc.)
+export * from './views';

package/lib/models/ItemDTO.js

@@ -59,7 +59,7 @@ export class ItemDTO {
         if (this._data.space_id) {
             return this._data.space_id;
         }
-        // Extract from s3_path_s if available: "datalayer.app/SPACE_ID/..."
+        // Extract from s3_path_s if available: "datalayer.ai/SPACE_ID/..."
         const s3Path = this._data.s3_path_s;
         if (s3Path && typeof s3Path === 'string') {
             const match = s3Path.match(/^datalayer\.app\/([^/]+)\//);

package/lib/models/RolesPlatform.js

@@ -43,8 +43,8 @@ export class PlatformRoles {
     static IAMToken = {
         id: 'platform_iam_token',
         handle: 'platform_iam_token',
-        displayName: 'Platform IAM Token',
-        description: 'A Platform IAM Token.',
+        displayName: 'Platform API Key',
+        description: 'A Platform API Key.',
         permissions: PLATFORM_IAM_TOKEN_PERMSSIONS,
         icon: UserIcon,
     };

package/lib/models/User.d.ts

@@ -18,6 +18,7 @@ export declare class User implements IUser {
     lastName: string;
     initials: string;
     displayName: string;
+    friendlyName?: string;
     joinDate?: Date;
     roles: string[];
     credits?: number;
@@ -48,6 +49,7 @@ export type IBaseUser = {
     lastName: string;
     initials: string;
     displayName: string;
+    friendlyName?: string;
     joinDate?: Date;
     roles: string[];
     setRoles: (roles: string[]) => void;

package/lib/models/User.js

@@ -2,7 +2,7 @@
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import { asDisplayName, namesAsInitials } from '../utils';
+import { asDisplayName, namesAsInitials, toFriendlyName } from '../utils';
 import { asIAMProviderLinked } from './IAMProviderLinked';
 import { BOOTSTRAP_USER_ONBOARDING } from './UserOnboarding';
 import { UserSettings } from './UserSettings';
@@ -34,6 +34,7 @@ export class User {
     lastName;
     initials;
     displayName;
+    friendlyName;
     joinDate;
     roles;
     credits;
@@ -57,6 +58,8 @@ export class User {
         this.initials = namesAsInitials(u.first_name_t, u.last_name_t);
         const displayName = asDisplayName(u.first_name_t, u.last_name_t);
         this.displayName = displayName === '' ? u.handle_s : displayName;
+        this.friendlyName =
+            toFriendlyName(u.first_name_t, u.last_name_t) || u.handle_s;
         this.avatarUrl = u.avatar_url_s;
         this.origin = u.origin_s;
         this.joinDate = u.join_ts_dt ? new Date(u.join_ts_dt) : undefined;

package/lib/otel/client/OtelClient.d.ts

@@ -0,0 +1,93 @@
+import type { OtelSpan, OtelLog, OtelMetric, OtelQueryResult } from '../types';
+import type { OtelSystemData, OtelSystemProcess, OtelSystemDisk, OtelSystemTable } from '../hooks';
+export interface OtelClientOptions {
+    /**
+     * Base URL of the OTEL service.
+     * Defaults to `configuration.otelRunUrl` from the Datalayer core config
+     * (i.e. `https://prod1.datalayer.run`).
+     */
+    baseUrl?: string;
+    /** JWT bearer token or API key for authentication. */
+    token?: string;
+}
+export interface FetchTracesOptions {
+    serviceName?: string;
+    limit?: number;
+}
+export interface FetchLogsOptions {
+    serviceName?: string;
+    severity?: string;
+    traceId?: string;
+    limit?: number;
+}
+export interface FetchMetricsOptions {
+    serviceName?: string;
+    metricName?: string;
+    limit?: number;
+}
+export interface FetchMetricTotalOptions {
+    serviceName?: string;
+    limit?: number;
+    fallbackWithoutService?: boolean;
+}
+/**
+ * Typed HTTP client for all OTEL service endpoints.
+ *
+ * Construct via `createOtelClient()` or `new OtelClient(options)`.
+ */
+export declare class OtelClient {
+    private readonly baseUrl;
+    private readonly token?;
+    constructor(options?: OtelClientOptions);
+    /** List recent spans / traces. */
+    fetchTraces(options?: FetchTracesOptions): Promise<{
+        data: OtelSpan[];
+        count: number;
+    }>;
+    /** Fetch all spans for a single trace by `traceId`. */
+    fetchTrace(traceId: string): Promise<{
+        data: OtelSpan[];
+    }>;
+    /** List recent log records. */
+    fetchLogs(options?: FetchLogsOptions): Promise<{
+        data: OtelLog[];
+        count: number;
+    }>;
+    /** List recent metric data points. */
+    fetchMetrics(options?: FetchMetricsOptions): Promise<{
+        data: OtelMetric[];
+        count: number;
+    }>;
+    /** Sum all values for one metric name, with optional service filter. */
+    fetchMetricTotal(metricName: string, options?: FetchMetricTotalOptions): Promise<number>;
+    /** List known service names observed in traces. */
+    fetchServices(): Promise<string[]>;
+    /** Fetch storage / ingestion statistics. */
+    fetchStats(): Promise<Record<string, unknown>>;
+    /**
+     * Execute an ad-hoc DataFusion SQL query against the OTEL service.
+     *
+     * Available tables: `spans`, `logs`, `metrics`.
+     */
+    executeQuery(sql: string): Promise<OtelQueryResult>;
+    /**
+     * Fetch system statistics (platform_admin only).
+     *
+     * Returns process memory/CPU, disk usage, and per-table row counts.
+     */
+    fetchSystem(): Promise<OtelSystemData>;
+}
+/**
+ * Create a new `OtelClient`.
+ *
+ * The `baseUrl` defaults to `configuration.otelRunUrl` from the Datalayer core
+ * configuration store, so only pass it when you want to override the default.
+ *
+ * @example
+ * ```ts
+ * const client = createOtelClient({ token: jwt });
+ * const services = await client.fetchServices();
+ * ```
+ */
+export declare function createOtelClient(options?: OtelClientOptions): OtelClient;
+export type { OtelSystemData, OtelSystemProcess, OtelSystemDisk, OtelSystemTable, };