@datalayer/core 1.0.3 → 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,206 +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,
-        });
-    };
-    /**
-     * Create a new agent runtime.
-     *
-     * Note on phase/status mapping:
-     * Newly created runtimes are immediately active (the operator assigns a pod from the pool).
-     * The response won't have a 'phase' field, so we default to 'running'.
-     * See useAgentRuntimes JSDoc for full explanation.
-     */
-    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
     // ============================================================================
@@ -4712,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
      */
@@ -6264,6 +6071,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         useJoinWithInvite,
         useConfirmJoinWithToken,
         useCreateTokenForPasswordChange,
+        useCreateUrlForPasswordChange,
         useConfirmPasswordWithToken,
         useOAuth2AuthorizationURL,
         useOAuth2AuthorizationLinkURL,
@@ -6344,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,

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/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, };

package/lib/otel/client/OtelClient.js

@@ -0,0 +1,232 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * OtelClient – Typed HTTP client for the Datalayer OTEL service.
+ *
+ * Reads the OTEL service URL from the Datalayer core configuration by default,
+ * so callers don't need to pass `baseUrl` unless they want to override it.
+ *
+ * @example
+ * ```ts
+ * import { createOtelClient } from '@datalayer/core/otel';
+ *
+ * const client = createOtelClient({ token: myJwt });
+ * const { data: spans } = await client.fetchTraces({ limit: 50 });
+ * ```
+ */
+import { coreStore } from '../../state/substates/CoreState';
+// ── Fetch helper ────────────────────────────────────────────────────────────
+async function otelFetch(url, token, options) {
+    const headers = {
+        Accept: 'application/json',
+        'Cache-Control': 'no-store, no-cache, must-revalidate',
+    };
+    if (token) {
+        headers['Authorization'] = `Bearer ${token}`;
+    }
+    if (options?.body) {
+        headers['Content-Type'] = 'application/json';
+    }
+    const resp = await fetch(url, {
+        method: options?.method ?? 'GET',
+        headers,
+        body: options?.body != null ? JSON.stringify(options.body) : undefined,
+    });
+    if (!resp.ok) {
+        const text = await resp.text().catch(() => '');
+        throw new Error(`OTEL API error ${resp.status}: ${text}`);
+    }
+    return resp.json();
+}
+function parseMetricValue(raw) {
+    const candidates = [raw.value, raw.value_double, raw.value_int];
+    for (const candidate of candidates) {
+        if (typeof candidate === 'number' && Number.isFinite(candidate)) {
+            return candidate;
+        }
+        if (typeof candidate === 'string') {
+            const parsed = Number(candidate);
+            if (Number.isFinite(parsed)) {
+                return parsed;
+            }
+        }
+    }
+    return 0;
+}
+function parseMetricTimestamp(raw) {
+    const candidate = raw.timestamp ??
+        raw.Timestamp ??
+        raw.timestamp_unix_nano ??
+        raw.start_time_unix_nano;
+    if (typeof candidate === 'string' && candidate.trim().length > 0) {
+        return candidate;
+    }
+    const numeric = Number(candidate);
+    if (!Number.isFinite(numeric)) {
+        return '';
+    }
+    if (numeric > 1e15) {
+        return new Date(numeric / 1e6).toISOString();
+    }
+    if (numeric > 1e12) {
+        return new Date(numeric / 1e3).toISOString();
+    }
+    return new Date(numeric).toISOString();
+}
+function normalizeMetric(raw) {
+    return {
+        metric_name: String(raw.metric_name ?? raw.MetricName ?? raw.name ?? raw.Name ?? ''),
+        service_name: String(raw.service_name ?? raw.ServiceName ?? ''),
+        value: parseMetricValue(raw),
+        unit: raw.metric_unit != null
+            ? String(raw.metric_unit)
+            : raw.MetricUnit != null
+                ? String(raw.MetricUnit)
+                : raw.unit != null
+                    ? String(raw.unit)
+                    : raw.Unit != null
+                        ? String(raw.Unit)
+                        : undefined,
+        timestamp: parseMetricTimestamp(raw),
+        metric_type: raw.metric_type != null
+            ? String(raw.metric_type)
+            : raw.MetricType != null
+                ? String(raw.MetricType)
+                : undefined,
+        attributes: typeof raw.attributes === 'object' && raw.attributes !== null
+            ? raw.attributes
+            : undefined,
+    };
+}
+// ── OtelClient class ─────────────────────────────────────────────────────────
+/**
+ * Typed HTTP client for all OTEL service endpoints.
+ *
+ * Construct via `createOtelClient()` or `new OtelClient(options)`.
+ */
+export class OtelClient {
+    baseUrl;
+    token;
+    constructor(options = {}) {
+        this.baseUrl =
+            options.baseUrl ?? coreStore.getState().configuration.otelRunUrl;
+        this.token = options.token;
+    }
+    // ── Traces ────────────────────────────────────────────────────────────────
+    /** List recent spans / traces. */
+    async fetchTraces(options = {}) {
+        const params = new URLSearchParams({ limit: String(options.limit ?? 50) });
+        if (options.serviceName)
+            params.set('service_name', options.serviceName);
+        const resp = await otelFetch(`${this.baseUrl}/api/otel/v1/traces/?${params}`, this.token);
+        const rows = (Array.isArray(resp) ? resp : resp.data) ?? [];
+        return { data: rows, count: rows.length };
+    }
+    /** Fetch all spans for a single trace by `traceId`. */
+    async fetchTrace(traceId) {
+        const resp = await otelFetch(`${this.baseUrl}/api/otel/v1/traces/${traceId}`, this.token);
+        const rows = (Array.isArray(resp) ? resp : resp.data) ?? [];
+        return { data: rows };
+    }
+    // ── Logs ──────────────────────────────────────────────────────────────────
+    /** List recent log records. */
+    async fetchLogs(options = {}) {
+        const params = new URLSearchParams({ limit: String(options.limit ?? 100) });
+        if (options.serviceName)
+            params.set('service_name', options.serviceName);
+        if (options.severity)
+            params.set('severity', options.severity);
+        if (options.traceId)
+            params.set('trace_id', options.traceId);
+        const resp = await otelFetch(`${this.baseUrl}/api/otel/v1/logs/?${params}`, this.token);
+        const rows = (Array.isArray(resp) ? resp : resp.data) ?? [];
+        return { data: rows, count: rows.length };
+    }
+    // ── Metrics ───────────────────────────────────────────────────────────────
+    /** List recent metric data points. */
+    async fetchMetrics(options = {}) {
+        const params = new URLSearchParams({ limit: String(options.limit ?? 50) });
+        if (options.serviceName)
+            params.set('service_name', options.serviceName);
+        if (options.metricName)
+            params.set('metric_name', options.metricName);
+        const resp = await otelFetch(`${this.baseUrl}/api/otel/v1/metrics/?${params}`, this.token);
+        const rows = (Array.isArray(resp) ? resp : resp.data) ?? [];
+        const normalized = Array.isArray(rows)
+            ? rows.map(row => normalizeMetric(row))
+            : [];
+        return { data: normalized, count: normalized.length };
+    }
+    /** Sum all values for one metric name, with optional service filter. */
+    async fetchMetricTotal(metricName, options = {}) {
+        const { serviceName, limit = 500, fallbackWithoutService = true } = options;
+        const filtered = await this.fetchMetrics({
+            metricName,
+            serviceName,
+            limit,
+        });
+        const filteredTotal = filtered.data.reduce((sum, row) => sum + Number(row.value || 0), 0);
+        if (filteredTotal > 0 || !serviceName || !fallbackWithoutService) {
+            return filteredTotal;
+        }
+        const unfiltered = await this.fetchMetrics({ metricName, limit });
+        return unfiltered.data.reduce((sum, row) => sum + Number(row.value || 0), 0);
+    }
+    // ── Services ──────────────────────────────────────────────────────────────
+    /** List known service names observed in traces. */
+    async fetchServices() {
+        const resp = await otelFetch(`${this.baseUrl}/api/otel/v1/traces/services/list`, this.token);
+        if (Array.isArray(resp))
+            return resp;
+        const byServices = resp.services;
+        if (Array.isArray(byServices))
+            return byServices;
+        const byData = resp.data;
+        if (Array.isArray(byData)) {
+            return byData.map((r) => String(r.service_name ?? r.name ?? ''));
+        }
+        return [];
+    }
+    // ── Stats ─────────────────────────────────────────────────────────────────
+    /** Fetch storage / ingestion statistics. */
+    async fetchStats() {
+        return otelFetch(`${this.baseUrl}/api/otel/v1/stats/`, this.token);
+    }
+    // ── SQL query ─────────────────────────────────────────────────────────────
+    /**
+     * Execute an ad-hoc DataFusion SQL query against the OTEL service.
+     *
+     * Available tables: `spans`, `logs`, `metrics`.
+     */
+    async executeQuery(sql) {
+        return otelFetch(`${this.baseUrl}/api/otel/v1/query/`, this.token, { method: 'POST', body: { sql } });
+    }
+    // ── System ────────────────────────────────────────────────────────────────
+    /**
+     * Fetch system statistics (platform_admin only).
+     *
+     * Returns process memory/CPU, disk usage, and per-table row counts.
+     */
+    async fetchSystem() {
+        const resp = await otelFetch(`${this.baseUrl}/api/otel/v1/system/`, this.token);
+        return (resp.data ?? resp);
+    }
+}
+// ── Factory ──────────────────────────────────────────────────────────────────
+/**
+ * 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 function createOtelClient(options = {}) {
+    return new OtelClient(options);
+}

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

@@ -0,0 +1,2 @@
+export { OtelClient, createOtelClient } from './OtelClient';
+export type { OtelClientOptions, FetchTracesOptions, FetchLogsOptions, FetchMetricsOptions, FetchMetricTotalOptions, OtelSystemData, OtelSystemProcess, OtelSystemDisk, OtelSystemTable, } from './OtelClient';

package/lib/otel/client/index.js

@@ -0,0 +1,5 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+export { OtelClient, createOtelClient } from './OtelClient';