@datalayer/core 1.0.25 → 1.1.41

package/README.md

@@ -2,7 +2,7 @@
 
 [![Become a Sponsor](https://img.shields.io/static/v1?label=Become%20a%20Sponsor&message=%E2%9D%A4&logo=GitHub&style=flat&color=1ABC9C)](https://github.com/sponsors/datalayer)
 
-# ☰ 🌀 Datalayer Core
+# ☰ Datalayer Core
 
 <p align="center">
   <strong>Python and Typescript libraries for Datalayer</strong>
@@ -93,12 +93,16 @@ if client.authenticate():
 
 ### 2. Execute Code in a Runtime
 
-Use context managers to create runtimes and ensure proper resource cleanup:
+> **Note:** Runtime creation and code execution have moved to the
+> [`agent-runtimes`](https://github.com/datalayer/agent-runtimes) package. Use its
+> `RuntimeClient` (and the `@datalayer` decorator) for runtime workloads. The
+> `datalayer-core` `DatalayerClient` now focuses on account/platform operations
+> (authentication, secrets, API keys, usage, profile).
 
 ```python
-from datalayer_core import DatalayerClient
+from agent_runtimes.client import RuntimeClient
 
-client = DatalayerClient()
+client = RuntimeClient()
 
 # Execute code in a managed runtime
 with client.create_runtime() as runtime:
@@ -157,7 +161,7 @@ Use comma-separated agentspec ids to create one experiment per agentspec variant
 
 ```bash
 # Creates one experiment per agentspec in the list
-datalayer evals experiments create my-exp \
+agent-runtimes evals experiments create my-exp \
   --evalset-id <evalset_id> \
   --agent-spec-ids example-evals,example-evals-nocodemode,example-custom
 ```
@@ -165,7 +169,7 @@ datalayer evals experiments create my-exp \
 Generate a comparison report:
 
 ```bash
-datalayer evals report <evalset_id> --run-limit 50 --export
+agent-runtimes evals report <evalset_id> --run-limit 50 --export
 ```
 
 How to interpret grouped comparisons in the report:
@@ -180,11 +184,9 @@ How to interpret grouped comparisons in the report:
 
 For comprehensive Python usage examples, see the [`examples/`](https://github.com/datalayer/core/tree/main/examples) directory which includes:
 
-- **FastAPI + scikit-learn**: Web application with ML models
-- **Streamlit + scikit-learn**: Interactive data science apps
-- **PyTorch GPU workloads**: High-performance computing examples
-- **Decorator patterns**: Remote function execution with `@datalayer`
-- **And more**: Complete examples with documentation and setup instructions
+- **OpenTelemetry observability**: Traces and metrics instrumentation with a visualization UI
+
+The framework and client examples (**FastAPI + scikit-learn**, **Streamlit + scikit-learn**, **PyTorch GPU workloads**, **`@datalayer` decorator patterns**, and **Next.js**) have moved to the [Agent Runtimes examples](https://github.com/datalayer/agent-runtimes/tree/main/examples).
 
 ### TypeScript/React Examples
 
@@ -212,21 +214,7 @@ Available at http://localhost:3000/:
 
 ### Next.js Application Example
 
-A complete Next.js application demonstrating platform integration:
-
-```bash
-cd examples/nextjj
-npm install
-npm run dev
-```
-
-Features:
-
-- Token authentication with Datalayer IAM
-- Browse and create notebooks from your workspace
-- Select compute environments for execution
-- Interactive notebook viewer with real-time outputs
-- Clean, responsive UI with GitHub Primer components
+The Next.js application example has moved to the [Agent Runtimes examples](https://github.com/datalayer/agent-runtimes/tree/main/examples/nextjs).
 
 ## Platform Integration
 

package/lib/api/index.d.ts

@@ -10,13 +10,4 @@ export { requestDatalayerAPI, RunResponseError, NetworkError, } from './Datalaye
 export type { IRequestDatalayerAPIOptions } from './DatalayerApi';
 export * as iam from './iam';
 export * as otel from './otel';
-export * as runtimes from './runtimes';
-export * as scheduler from './scheduler';
-export * as spacer from './spacer';
-/**
- * @deprecated Please import directly from '@datalayer/core/stateful' instead.
- * This module provides backward compatibility for the moved apiv1 modules.
- */
-export * from '../stateful/jupyter';
-export * from '../stateful/runtimes';
 export * from '../api/DatalayerApi';

package/lib/api/index.js

@@ -15,13 +15,4 @@ export { requestDatalayerAPI, RunResponseError, NetworkError, } from './Datalaye
 // Domain-organized API exports
 export * as iam from './iam/index.js';
 export * as otel from './otel/index.js';
-export * as runtimes from './runtimes/index.js';
-export * as scheduler from './scheduler/index.js';
-export * as spacer from './spacer/index.js';
-/**
- * @deprecated Please import directly from '@datalayer/core/stateful' instead.
- * This module provides backward compatibility for the moved apiv1 modules.
- */
-export * from '../stateful/jupyter/index.js';
-export * from '../stateful/runtimes/index.js';
 export * from '../api/DatalayerApi.js';

package/lib/cli-login.js

@@ -0,0 +1,167 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+import { useCallback, useEffect, useState } from 'react';
+import { createRoot } from 'react-dom/client';
+import { Box, Button, Spinner, Text } from '@primer/react';
+import { ShieldLockIcon } from '@primer/octicons-react';
+import { DatalayerThemeProvider, themeConfigs, createThemeStore, } from '@datalayer/primer-addons';
+import { SvgLinesLogo, SvgUsecasesHero } from '@datalayer/design';
+import { AppearanceControlsWithStore } from '@datalayer/primer-addons/lib/components/appearance';
+import { ConfettiSuccess } from './components/confetti/index.js';
+import { formatFriendlyHandle } from './utils/Handles.js';
+import { SignInSimple } from './views/iam/SignInSimple.js';
+const DATALAYER_IAM_USER_KEY = '@datalayer/iam:user';
+const DATALAYER_IAM_TOKEN_KEY = '@datalayer/iam:token';
+const useCliThemeStore = createThemeStore('datalayer-core-cli-theme-v2', {
+    colorMode: 'dark',
+    theme: 'matrix',
+});
+const readStoredAuth = () => {
+    const token = window.localStorage.getItem(DATALAYER_IAM_TOKEN_KEY) || '';
+    const rawUser = window.localStorage.getItem(DATALAYER_IAM_USER_KEY) || '';
+    if (!token || !rawUser) {
+        return null;
+    }
+    try {
+        const user = JSON.parse(rawUser);
+        const userHandle = String(user?.handle || user?.handle_s || '').trim();
+        if (!userHandle) {
+            return null;
+        }
+        return { token, userHandle };
+    }
+    catch {
+        return null;
+    }
+};
+function SignInCLIApp() {
+    const [state, setState] = useState('checking');
+    const [message, setMessage] = useState('');
+    const [closeHelp, setCloseHelp] = useState('');
+    const { colorMode, theme: themeVariant } = useCliThemeStore();
+    const cfg = themeConfigs[themeVariant];
+    const handleCloseWindow = useCallback(() => {
+        setCloseHelp('');
+        // Browsers allow window.close() only for windows/tabs opened by script.
+        window.close();
+        setTimeout(() => {
+            if (!document.hidden) {
+                try {
+                    // Some browsers require a same-tab self-target before closing.
+                    window.open('', '_self');
+                    window.close();
+                }
+                catch {
+                    // Ignore and show manual-close help below.
+                }
+            }
+            if (!document.hidden) {
+                setCloseHelp('Authentication is complete. Your browser blocked auto-close for this tab, so you can safely close it manually.');
+            }
+        }, 150);
+    }, []);
+    const finalizeCliAuthentication = useCallback(async () => {
+        const auth = readStoredAuth();
+        if (!auth) {
+            setState('signin');
+            return;
+        }
+        const response = await fetch('/', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                user_handle: auth.userHandle,
+                token: auth.token,
+            }),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(text || 'Failed to finalize CLI authentication.');
+        }
+        setMessage(`Successfully logged in as ${formatFriendlyHandle(auth.userHandle)}.`);
+        setState('success');
+    }, []);
+    useEffect(() => {
+        finalizeCliAuthentication().catch((error) => {
+            setMessage(error instanceof Error ? error.message : 'Authentication failed.');
+            setState('signin');
+        });
+    }, [finalizeCliAuthentication]);
+    const renderLayout = (content) => (_jsx(DatalayerThemeProvider, { colorMode: colorMode, theme: cfg.primerTheme, themeStyles: cfg.themeStyles, children: _jsxs(Box, { sx: {
+                minHeight: '100vh',
+                bg: 'canvas.default',
+                color: 'fg.default',
+                position: 'relative',
+            }, children: [_jsx(Box, { sx: {
+                        position: 'fixed',
+                        top: 0,
+                        right: 0,
+                        zIndex: 20,
+                        p: 3,
+                        display: 'flex',
+                        justifyContent: 'flex-end',
+                    }, children: _jsx(AppearanceControlsWithStore, { useStore: useCliThemeStore }) }), content] }) }));
+    if (state === 'checking') {
+        return renderLayout(_jsx(Box, { sx: {
+                display: 'flex',
+                alignItems: 'center',
+                justifyContent: 'center',
+                minHeight: '100vh',
+            }, children: _jsx(Spinner, {}) }));
+    }
+    if (state === 'success') {
+        return renderLayout(_jsxs(Box, { sx: {
+                minHeight: '100vh',
+                display: 'flex',
+                alignItems: 'center',
+                justifyContent: 'center',
+                px: 3,
+                position: 'relative',
+                overflow: 'hidden',
+            }, children: [_jsx(Box, { sx: {
+                        position: 'absolute',
+                        inset: 0,
+                        opacity: 0.45,
+                        pointerEvents: 'none',
+                    }, children: _jsx(SvgUsecasesHero, {}) }), _jsx(Box, { sx: {
+                        position: 'absolute',
+                        inset: 0,
+                        pointerEvents: 'none',
+                        zIndex: 2,
+                    }, children: _jsx(ConfettiSuccess, {}) }), _jsxs(Box, { sx: {
+                        position: 'relative',
+                        zIndex: 3,
+                        textAlign: 'center',
+                        maxWidth: 560,
+                        p: 4,
+                        borderRadius: 2,
+                        border: '1px solid',
+                        borderColor: 'border.default',
+                        bg: 'canvas.default',
+                    }, children: [_jsx(Box, { sx: { display: 'flex', justifyContent: 'center', mb: 3 }, children: _jsx(Box, { sx: { width: 210 }, children: _jsx(SvgLinesLogo, { height: 32 }) }) }), _jsx(Text, { as: "h2", sx: { display: 'block', fontSize: 3, fontWeight: 600, mb: 2 }, children: message || 'Successfully logged in.' }), _jsx(Text, { as: "p", sx: { color: 'fg.muted', mb: 3 }, children: "You can close this window." }), closeHelp && (_jsx(Text, { as: "p", sx: { color: 'fg.accent', mb: 3 }, children: closeHelp })), _jsx(Box, { sx: { display: 'flex', justifyContent: 'center' }, children: _jsx(Button, { onClick: handleCloseWindow, children: "Close this window" }) })] })] }));
+    }
+    return renderLayout(_jsx(SignInSimple, { name: "Datalayer CLI", description: "Sign in to continue in your CLI session.", icon: _jsx(ShieldLockIcon, { size: 24 }), github: true, google: true, linkedin: true, signUp: true, apiKey: false, socialSignInNavigationTarget: null, onSignIn: async (token, handle) => {
+            window.localStorage.setItem(DATALAYER_IAM_TOKEN_KEY, token);
+            window.localStorage.setItem(DATALAYER_IAM_USER_KEY, JSON.stringify({
+                handle,
+                displayName: handle,
+                uid: '',
+                firstName: '',
+                lastName: '',
+                email: '',
+            }));
+            try {
+                await finalizeCliAuthentication();
+            }
+            catch (error) {
+                setMessage(error instanceof Error ? error.message : 'Authentication failed.');
+            }
+        } }));
+}
+const rootElement = document.getElementById('root');
+if (rootElement) {
+    createRoot(rootElement).render(_jsx(SignInCLIApp, {}));
+}

package/lib/client/base.d.ts

@@ -1,4 +1,3 @@
-import { EnvironmentDTO } from '../models/EnvironmentDTO';
 import { AuthenticationManager } from './auth';
 import type { TokenStorage } from './auth/types';
 /** Handlers for Client method lifecycle events. */
@@ -35,8 +34,6 @@ export declare class DatalayerClientBase {
     readonly spacerRunUrl: string;
     /** Authentication token */
     token?: string;
-    /** Environments */
-    readonly environments: EnvironmentDTO[];
     /** Method lifecycle handlers */
     readonly handlers?: ClientHandlers;
     /** Authentication manager */

package/lib/client/base.js

@@ -18,8 +18,6 @@ export class DatalayerClientBase {
     spacerRunUrl;
     /** Authentication token */
     token;
-    /** Environments */
-    environments = [];
     /** Method lifecycle handlers */
     handlers;
     /** Authentication manager */

package/lib/client/index.d.ts

@@ -17,41 +17,31 @@
 import { DatalayerClientBase, type DatalayerClientConfig, type ClientHandlers } from './base';
 import type { UserDTO } from './../models/UserDTO';
 import type { CreditsDTO } from '../models/CreditsDTO';
-import type { EnvironmentDTO } from '../models/EnvironmentDTO';
-import type { RuntimeDTO } from '../models/RuntimeDTO';
-import type { CodeSandboxSnapshotDTO } from '../models/CodeSandboxSnapshotDTO';
-import type { SpaceDTO } from '../models/SpaceDTO';
-import type { NotebookDTO } from '../models/NotebookDTO';
-import type { LexicalDTO } from '../models/LexicalDTO';
 import type { HealthCheck } from '../models/HealthCheck';
 import type { SecretDTO } from '../models/Secret';
 import type { CreateSecretRequest, UpdateSecretRequest } from '../models/Secret';
-import type { ProjectDTO } from '../models/ProjectDTO';
-import type { ProjectDefaultItems } from '../models/ProjectDTO';
-import type { UpdateSpaceRequest } from '../models/SpaceDTO';
 import type { DatasourceDTO } from '../models/Datasource';
 import type { CreateDatasourceRequest, UpdateDatasourceRequest } from '../models/Datasource';
-declare const DatalayerClientWithMixins: typeof DatalayerClientBase;
+declare const DatalayerCoreClientWithMixins: typeof DatalayerClientBase;
 /**
- * Main Datalayer Client providing unified access to all platform services.
- * Uses TypeScript mixins to provide a flat, discoverable API.
+ * Core Datalayer Client providing access to identity, plans and account
+ * services (IAM). Runtime and workspace/content features are provided by
+ * `AgentRuntimesClient` in `@datalayer/agent-runtimes`, which extends this
+ * class.
  *
  * @example
  * ```typescript
- * const client = new DatalayerClient({
+ * const client = new DatalayerCoreClient({
  *   token: 'your-token'
  * });
  *
  * const user = await client.whoami();
- * const runtime = await client.createRuntime({
- *   environment_name: 'ai-agents-env',
- *   credits_limit: 100
- * });
+ * const credits = await client.getCredits();
  * ```
  */
-export declare class DatalayerClient extends DatalayerClientWithMixins {
+export declare class DatalayerCoreClient extends DatalayerCoreClientWithMixins {
     /**
-     * Create a DatalayerClient instance.
+     * Create a DatalayerCoreClient instance.
      *
      * @param config - Client configuration options
      */
@@ -61,23 +51,8 @@ export type { DatalayerClientConfig, ClientHandlers };
 export { DatalayerClientBase };
 export { UserDTO as User } from './../models/UserDTO';
 export type { UserJSON, UserData } from './../models/UserDTO';
-export { RuntimeDTO as Runtime } from '../models/RuntimeDTO';
-export type { RuntimeJSON, RuntimeData, CreateRuntimeRequest, CreateRuntimeResponse, ListRuntimesResponse, } from '../models/RuntimeDTO';
-export { EnvironmentDTO as Environment } from '../models/EnvironmentDTO';
-export type { EnvironmentJSON, EnvironmentData, ListEnvironmentsResponse, } from '../models/EnvironmentDTO';
-export { CodeSandboxSnapshotDTO as Snapshot } from '../models/CodeSandboxSnapshotDTO';
-export type { CodeSandboxSnapshotJSON, CodeSandboxSnapshotData, CreateCodeSandboxSnapshotRequest, CreateCodeSandboxSnapshotResponse, GetCodeSandboxSnapshotResponse, ListCodeSandboxSnapshotsResponse, } from '../models/CodeSandboxSnapshotDTO';
-export { SpaceDTO as Space } from '../models/SpaceDTO';
-export type { SpaceJSON, SpaceData, SpaceItem, CreateSpaceRequest, CreateSpaceResponse, SpacesForUserResponse, CollaborationSessionResponse, DeleteSpaceItemResponse, GetSpaceItemResponse, GetSpaceItemsResponse, CreateNotebookRequest, CreateNotebookResponse, GetNotebookResponse, UpdateNotebookRequest, UpdateNotebookResponse, UpdateSpaceRequest, GetSpaceResponse, UpdateSpaceResponse, DeleteSpaceResponse, GetSpaceDefaultItemsResponse, GetSpacesByTypeResponse, } from '../models/SpaceDTO';
-export { ProjectDTO as Project } from '../models/ProjectDTO';
-export type { ProjectJSON, ProjectDefaultItems } from '../models/ProjectDTO';
-export { NotebookDTO as Notebook } from '../models/NotebookDTO';
-export type { NotebookJSON, NotebookData } from '../models/NotebookDTO';
-export { LexicalDTO } from '../models/LexicalDTO';
-export type { LexicalJSON, LexicalData, CreateLexicalRequest, CreateLexicalResponse, GetLexicalResponse, UpdateLexicalRequest, UpdateLexicalResponse, } from '../models/LexicalDTO';
 export { CreditsDTO as Credits } from '../models/CreditsDTO';
 export type { CreditsInfo, CreditReservation, CreditsResponse, } from '../models/CreditsDTO';
-export { ItemDTO as Item } from '../models/ItemDTO';
 export { HealthCheck } from '../models/HealthCheck';
 export type { HealthCheckJSON } from '../models/HealthCheck';
 export { SecretDTO as Secret } from './../models/Secret';
@@ -88,62 +63,40 @@ export type { LoginRequest, LoginResponse, UserMeResponse, MembershipsResponse,
 export type { HealthzPingResponse } from '../models/Common';
 export { AuthenticationManager } from './auth/AuthenticationManager';
 export type { IUser, IBaseUser } from '../models/User';
-export type { ICell } from '../models/Cell';
 export type { IDatasource, IDatasourceVariant } from '../models/Datasource';
 export type { ICredits, ICreditsReservation } from '../models/Credits';
-export type { ISpaceItem } from '../models/SpaceItem';
 export type { ISurvey } from '../models/Survey';
-export type { ISpace, IBaseSpace, IAnySpace, ISpaceVariant, } from '../models/Space';
 export type { IBaseTeam, IAnyTeam } from '../models/Team';
 export type { IOrganization, IAnyOrganization, IBaseOrganization, } from '../models/Organization';
-export type { IRuntimeModel, IRuntimePod, IRuntimeType, IRuntimeLocation, IRuntimeCapabilities, } from '../models/Runtime';
-export type { ICodeSandboxSnapshot } from '../models/CodeSandboxSnapshot';
-export type { IDatalayerEnvironment, IResources, ISnippet, } from '../models/Environment';
 export type { IRole } from '../models/Role';
-export type { IAssignment } from '../models/Assignment';
 export type { IContact } from '../models/Contact';
-export type { ICourse } from '../models/Course';
 export type { IOrganizationMember } from '../models/OrganizationMember';
-export type { IPage, PageTheme, PageVariant } from '../models/Page';
-export type { PageTagName } from '../models/PageTag';
 export type { ISecret, ISecretVariant } from '../models/Secret';
 export type { IIAMToken, IIAMTokenVariant } from '../models/IAMToken';
-export type { IDocument, IBaseDocument } from '../models/Document';
-export type { IEnvironment } from '../models/Environment';
-export type { IExercise, ICode, IHelp } from '../models/Exercise';
 export type { IInvite } from '../models/Invite';
-export type { ILesson } from '../models/Lesson';
-export type { INotebook, IBaseNotebook } from '../models/Notebook';
 export type { ISchool } from '../models/School';
 export type { ITeam } from '../models/Team';
 export type { TeamMember } from '../models/TeamMember';
 export type { IUserOnboarding, IClient, IOnboardingPosition, IOnboardingTours, ITour, ITourStatus, } from '../models/UserOnboarding';
 export type { IUserSettings } from '../models/UserSettings';
-export type { IDataset } from '../models/Dataset';
 export type { IUsage } from '../models/Usage';
-export type { IItem } from '../models/Item';
-export type { IItemType } from '../models/ItemType';
 export type { Member } from '../models/Member';
 export type { Profile } from '../models/Profile';
-export type { SpaceMember } from '../models/SpaceMember';
 export type { IContactEvent } from '../models/ContactEvent';
 export type { IContactIAMProvider } from '../models/ContactIAMProvider';
-export type { IStudentItem } from '../models/StudentItem';
 export type { Instructor } from '../models/Instructor';
 export type { IStudent } from '../models/Student';
 export type { IDean } from '../models/Dean';
 export type { IUserEvent } from '../models/UserEvent';
 export type { IIAMProviderLinked } from '../models/IAMProviderLinked';
-export type { IContent } from '../models/Content';
 export type { AuthResult, TokenValidationResult, AuthOptions, TokenStorage, } from './auth/types';
-export type { IRuntimeOptions, IMultiServiceManager, IRemoteServicesManager, IEnvironmentsManager, IRemoteRuntimesManager, } from '../stateful/runtimes/apis';
 export type { IDatalayerCoreConfig, IRuntimesConfiguration, } from '../config/Configuration';
 export type { IIAMProviderName } from '../models/IAMProvidersSpecs';
 export type { NavigationLinkProps } from '../navigation/components';
 export { ItemTypes } from './constants';
 export type { ItemType } from './constants';
 export * from './auth';
-export interface DatalayerClient {
+export interface DatalayerCoreClient {
     getToken(): string | undefined;
     setToken(token: string): Promise<void>;
     whoami(): Promise<UserDTO>;
@@ -163,46 +116,5 @@ export interface DatalayerClient {
     getDatasource(datasourceId: string): Promise<DatasourceDTO>;
     updateDatasource(datasourceId: string, updates: UpdateDatasourceRequest): Promise<DatasourceDTO>;
     deleteDatasource(datasourceId: string): Promise<void>;
-    listEnvironments(): Promise<EnvironmentDTO[]>;
-    ensureRuntime(environmentName?: string, creditsLimit?: number, waitForReady?: boolean, maxWaitTime?: number, reuseExisting?: boolean, snapshotId?: string): Promise<RuntimeDTO>;
-    createRuntime(environmentName: string, type: 'notebook' | 'terminal' | 'job', givenName: string, minutesLimit: number, fromSnapshotId?: string): Promise<RuntimeDTO>;
-    listRuntimes(): Promise<RuntimeDTO[]>;
-    getRuntime(podName: string): Promise<RuntimeDTO>;
-    deleteRuntime(podName: string): Promise<void>;
-    terminateAllRuntimes(): Promise<PromiseSettledResult<void>[]>;
-    createSnapshot(podName: string, name: string, description: string, stop?: boolean): Promise<CodeSandboxSnapshotDTO>;
-    listSnapshots(): Promise<CodeSandboxSnapshotDTO[]>;
-    getSnapshot(id: string): Promise<CodeSandboxSnapshotDTO>;
-    deleteSnapshot(id: string): Promise<void>;
-    checkRuntimesHealth(): Promise<HealthCheck>;
-    getMySpaces(): Promise<SpaceDTO[]>;
-    createSpace(name: string, description: string, variant: string, spaceHandle: string, organizationId: string, seedSpaceId: string, isPublic: boolean): Promise<SpaceDTO>;
-    createNotebook(spaceId: string, name: string, description: string, file?: File | Blob): Promise<NotebookDTO>;
-    getNotebook(id: string): Promise<NotebookDTO>;
-    updateNotebook(id: string, name?: string, description?: string): Promise<NotebookDTO>;
-    createLexical(spaceId: string, name: string, description: string, file?: File | Blob): Promise<LexicalDTO>;
-    getLexical(id: string): Promise<LexicalDTO>;
-    updateLexical(id: string, name?: string, description?: string): Promise<LexicalDTO>;
-    getSpaceItems(spaceId: string): Promise<(NotebookDTO | LexicalDTO)[]>;
-    getSpaceItem(itemId: string): Promise<NotebookDTO | LexicalDTO>;
-    deleteSpaceItem(itemId: string): Promise<void>;
-    getCollaborationSessionId(documentId: string): Promise<string>;
-    getContent(itemId: string): Promise<any>;
-    checkSpacerHealth(): Promise<HealthCheck>;
-    getSpace(uid: string): Promise<SpaceDTO>;
-    updateSpace(uid: string, data: UpdateSpaceRequest): Promise<SpaceDTO>;
-    updateUserSpace(uid: string, userId: string, data: UpdateSpaceRequest): Promise<SpaceDTO>;
-    deleteSpace(uid: string): Promise<void>;
-    makeSpacePublic(uid: string): Promise<SpaceDTO>;
-    makeSpacePrivate(uid: string): Promise<SpaceDTO>;
-    exportSpace(uid: string): Promise<any>;
-    cloneNotebook(id: string): Promise<NotebookDTO>;
-    cloneLexical(id: string): Promise<LexicalDTO>;
-    getProjects(): Promise<ProjectDTO[]>;
-    getProject(uid: string): Promise<ProjectDTO>;
-    createProject(name: string, description?: string): Promise<ProjectDTO>;
-    updateProject(uid: string, data: UpdateSpaceRequest): Promise<ProjectDTO>;
-    renameProject(uid: string, newName: string, description?: string): Promise<ProjectDTO>;
-    getProjectDefaultItems(uid: string): Promise<ProjectDefaultItems>;
     calculateCreditsFromMinutes(minutes: number, burningRate: number): number;
 }

package/lib/client/index.js

@@ -20,8 +20,6 @@
  */
 import { DatalayerClientBase, } from './base.js';
 import { IAMMixin } from './mixins/IAMMixin.js';
-import { RuntimesMixin } from './mixins/RuntimesMixin.js';
-import { SpacerMixin } from './mixins/SpacerMixin.js';
 /**
  * Helper function to compose mixins in a more readable way.
  * Applies mixins in the order provided.
@@ -32,28 +30,29 @@ import { SpacerMixin } from './mixins/SpacerMixin.js';
 function composeMixins(...mixins) {
     return mixins.reduce((base, mixin) => mixin(base), DatalayerClientBase);
 }
-// Apply mixins to the base class using the helper
-const DatalayerClientWithMixins = composeMixins(IAMMixin, RuntimesMixin, SpacerMixin);
+// Apply the IAM mixin to the base class. Runtime and content (Spacer) features
+// live in @datalayer/agent-runtimes, which composes AgentRuntimesClient on top
+// of this core client.
+const DatalayerCoreClientWithMixins = composeMixins(IAMMixin);
 /**
- * Main Datalayer Client providing unified access to all platform services.
- * Uses TypeScript mixins to provide a flat, discoverable API.
+ * Core Datalayer Client providing access to identity, plans and account
+ * services (IAM). Runtime and workspace/content features are provided by
+ * `AgentRuntimesClient` in `@datalayer/agent-runtimes`, which extends this
+ * class.
  *
  * @example
  * ```typescript
- * const client = new DatalayerClient({
+ * const client = new DatalayerCoreClient({
  *   token: 'your-token'
  * });
  *
  * const user = await client.whoami();
- * const runtime = await client.createRuntime({
- *   environment_name: 'ai-agents-env',
- *   credits_limit: 100
- * });
+ * const credits = await client.getCredits();
  * ```
  */
-export class DatalayerClient extends DatalayerClientWithMixins {
+export class DatalayerCoreClient extends DatalayerCoreClientWithMixins {
     /**
-     * Create a DatalayerClient instance.
+     * Create a DatalayerCoreClient instance.
      *
      * @param config - Client configuration options
      */
@@ -66,15 +65,7 @@ export class DatalayerClient extends DatalayerClientWithMixins {
 export { DatalayerClientBase };
 // Export models for use by consumers
 export { UserDTO as User } from './../models/UserDTO.js';
-export { RuntimeDTO as Runtime } from '../models/RuntimeDTO.js';
-export { EnvironmentDTO as Environment } from '../models/EnvironmentDTO.js';
-export { CodeSandboxSnapshotDTO as Snapshot } from '../models/CodeSandboxSnapshotDTO.js';
-export { SpaceDTO as Space } from '../models/SpaceDTO.js';
-export { ProjectDTO as Project } from '../models/ProjectDTO.js';
-export { NotebookDTO as Notebook } from '../models/NotebookDTO.js';
-export { LexicalDTO } from '../models/LexicalDTO.js';
 export { CreditsDTO as Credits } from '../models/CreditsDTO.js';
-export { ItemDTO as Item } from '../models/ItemDTO.js';
 export { HealthCheck } from '../models/HealthCheck.js';
 export { SecretDTO as Secret } from './../models/Secret.js';
 export { DatasourceDTO as Datasource } from './../models/Datasource.js';

package/lib/components/avatars/UserAvatar.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Returns `true` when the given URL points to a real user avatar (i.e. not a
+ * Gravatar default placeholder).
+ */
+export declare function hasRealAvatar(url?: string): boolean;
+export type UserAvatarProps = {
+    avatarUrl?: string;
+    /** Avatar edge length in pixels. Defaults to 100. */
+    size?: number;
+    /** Render with rounded square corners instead of a circle. Defaults to true. */
+    square?: boolean;
+    /** Fallback icon size. Defaults to ~48% of `size`. */
+    iconSize?: number;
+};
+export declare const UserAvatar: ({ avatarUrl, size, square, iconSize, }: UserAvatarProps) => JSX.Element;
+export default UserAvatar;

package/lib/components/avatars/UserAvatar.js

@@ -0,0 +1,47 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * UserAvatar – Single source of truth for rendering a user's avatar.
+ *
+ * When a real (non-Gravatar) avatar URL is available it renders a
+ * {@link DLAvatar}. Otherwise it falls back to a themed, colormoded
+ * {@link AlienIcon} placeholder so every consumer (profile, sidebar,
+ * principal overlay, …) shares the same default look.
+ */
+import { AlienIcon } from '@datalayer/icons-react';
+import { Box, useColorPalette } from '@datalayer/primer-addons';
+import { DLAvatar } from './DLAvatar.js';
+/**
+ * Returns `true` when the given URL points to a real user avatar (i.e. not a
+ * Gravatar default placeholder).
+ */
+export function hasRealAvatar(url) {
+    if (!url) {
+        return false;
+    }
+    if (url.startsWith('https://www.gravatar.com/avatar')) {
+        return false;
+    }
+    return true;
+}
+export const UserAvatar = ({ avatarUrl, size = 100, square = true, iconSize, }) => {
+    const palette = useColorPalette();
+    if (hasRealAvatar(avatarUrl)) {
+        return _jsx(DLAvatar, { square: square, src: avatarUrl, size: size });
+    }
+    const resolvedIconSize = iconSize ?? Math.round(size * 0.48);
+    return (_jsx(Box, { sx: {
+            width: size,
+            height: size,
+            borderRadius: square ? 2 : '50%',
+            bg: 'accent.subtle',
+            display: 'flex',
+            alignItems: 'center',
+            justifyContent: 'center',
+            '--datalayer-icon-fg': palette.primary,
+        }, children: _jsx(AlienIcon, { size: resolvedIconSize, themed: true, colormoded: true }) }));
+};
+export default UserAvatar;

package/lib/components/avatars/index.d.ts

@@ -1,3 +1,4 @@
 export * from './BoringAvatar';
 export * from './DLAvatar';
+export * from './UserAvatar';
 export * from './UserProfileAvatar';

package/lib/components/avatars/index.js

@@ -4,4 +4,5 @@
  */
 export * from './BoringAvatar.js';
 export * from './DLAvatar.js';
+export * from './UserAvatar.js';
 export * from './UserProfileAvatar.js';

package/lib/components/billing/BillableAccountSelect.js

@@ -1,4 +1,8 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
 /*
  * Copyright (c) 2023-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.