@datalayer/core 1.0.19 → 1.0.21

package/lib/hooks/useDatalayer.js

@@ -11,6 +11,23 @@ import { requestDatalayerAPI } from '../api/DatalayerApi.js';
 export function useDatalayer(props = {}) {
     const { loginRoute = '/login', notifyOnError = true } = props;
     const location = useLocation();
+    const resolveLoginRoute = (candidateRoute) => {
+        if (candidateRoute !== '/login') {
+            return candidateRoute;
+        }
+        const pathname = location.pathname || '';
+        const kernelsPrefix = '/jupyter/kernels';
+        const iamPrefix = '/jupyter/iam';
+        if (pathname.includes(kernelsPrefix)) {
+            const [base] = pathname.split(kernelsPrefix);
+            return `${base}${kernelsPrefix}/login`;
+        }
+        if (pathname.includes(iamPrefix)) {
+            const [base] = pathname.split(iamPrefix);
+            return `${base}${iamPrefix}/login`;
+        }
+        return candidateRoute;
+    };
     /*
     // TODO Fix the conditional hook call.
     const coreStore = useCoreStore();
@@ -35,15 +52,19 @@ export function useDatalayer(props = {}) {
             .catch(error => {
             if (error.name === 'RunResponseError') {
                 const responseError = error;
+                const isForbidden = responseError.response.status === 403;
                 if (responseError.response.status === 401) {
                     console.log('Datalayer sent a 401 return code.');
-                    if (location.pathname !== loginRoute_) {
+                    const resolvedLoginRoute = resolveLoginRoute(loginRoute_);
+                    const alreadyOnLoginRoute = location.pathname === resolvedLoginRoute ||
+                        location.pathname.endsWith('/login');
+                    if (!alreadyOnLoginRoute) {
                         iamStore.logout();
-                        navigate(loginRoute_);
+                        navigate(resolvedLoginRoute);
                     }
                 }
                 else {
-                    if (notifyOnError_) {
+                    if (notifyOnError_ && !isForbidden) {
                         if (responseError.warnings) {
                             responseError.warnings.forEach(warning => enqueueToast(`${warning}`, { variant: 'warning' }));
                         }
@@ -64,9 +85,16 @@ export function useDatalayer(props = {}) {
                     }
                 }
                 const response = {
+                    success: false,
                     sucess: false,
                     message: responseError.message,
                     errors: responseError.errors,
+                    warnings: responseError.warnings,
+                    detail: responseError.detail,
+                    status: responseError.response.status,
+                    code: responseError.response.status === 403
+                        ? 'FORBIDDEN'
+                        : `HTTP_${responseError.response.status}`,
                 };
                 return response;
             }

package/lib/hooks/useIAM.js

@@ -4,7 +4,7 @@
  */
 import { useEffect, useState } from 'react';
 import { useCache } from './useCache.js';
-import { coreStore, useIAMStore, useLayoutStore, useOrganizationStore, useSpaceStore, } from '../state/index.js';
+import { useIAMStore, useLayoutStore, useOrganizationStore, useSpaceStore, } from '../state/index.js';
 import { asUser, ANONYMOUS_USER, ANONYMOUS_USER_TOKEN, } from '../models/index.js';
 import { requestDatalayerAPI, } from '../api/DatalayerApi.js';
 export const useIAM = (props = { user: undefined, token: undefined }) => {
@@ -72,13 +72,6 @@ export const useIAM = (props = { user: undefined, token: undefined }) => {
                 const user = asUser(whoamiData.profile);
                 setIAMState({ user, token });
                 iamStore.setLogin(user, token);
-                // TODO centralize user settings management.
-                const aiagentsRunUrl = user.settings?.aiAgentsUrl;
-                if (aiagentsRunUrl) {
-                    coreStore.getState().setConfiguration({
-                        aiagentsRunUrl,
-                    });
-                }
             }
         }
     }, [token, whoamiData, iamStore]);

package/lib/hooks/useProjects.d.ts

@@ -385,6 +385,10 @@ export declare function useCreateProject(): {
     mutate: import("@tanstack/react-query").UseMutateFunction<any, Error, {
         space: Partial<import("..").IAnySpace>;
         organization?: import("..").IAnyOrganization;
+        team?: {
+            id?: string;
+            handle?: string;
+        };
     }, unknown>;
     reset: () => void;
     context: unknown;
@@ -395,6 +399,10 @@ export declare function useCreateProject(): {
     mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<any, Error, {
         space: Partial<import("..").IAnySpace>;
         organization?: import("..").IAnyOrganization;
+        team?: {
+            id?: string;
+            handle?: string;
+        };
     }, unknown>;
 } | {
     createProject: (request: CreateProjectRequest) => Promise<any>;
@@ -402,6 +410,10 @@ export declare function useCreateProject(): {
     variables: {
         space: Partial<import("..").IAnySpace>;
         organization?: import("..").IAnyOrganization;
+        team?: {
+            id?: string;
+            handle?: string;
+        };
     };
     error: null;
     isError: false;
@@ -412,6 +424,10 @@ export declare function useCreateProject(): {
     mutate: import("@tanstack/react-query").UseMutateFunction<any, Error, {
         space: Partial<import("..").IAnySpace>;
         organization?: import("..").IAnyOrganization;
+        team?: {
+            id?: string;
+            handle?: string;
+        };
     }, unknown>;
     reset: () => void;
     context: unknown;
@@ -422,6 +438,10 @@ export declare function useCreateProject(): {
     mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<any, Error, {
         space: Partial<import("..").IAnySpace>;
         organization?: import("..").IAnyOrganization;
+        team?: {
+            id?: string;
+            handle?: string;
+        };
     }, unknown>;
 } | {
     createProject: (request: CreateProjectRequest) => Promise<any>;
@@ -430,6 +450,10 @@ export declare function useCreateProject(): {
     variables: {
         space: Partial<import("..").IAnySpace>;
         organization?: import("..").IAnyOrganization;
+        team?: {
+            id?: string;
+            handle?: string;
+        };
     };
     isError: true;
     isIdle: false;
@@ -439,6 +463,10 @@ export declare function useCreateProject(): {
     mutate: import("@tanstack/react-query").UseMutateFunction<any, Error, {
         space: Partial<import("..").IAnySpace>;
         organization?: import("..").IAnyOrganization;
+        team?: {
+            id?: string;
+            handle?: string;
+        };
     }, unknown>;
     reset: () => void;
     context: unknown;
@@ -449,6 +477,10 @@ export declare function useCreateProject(): {
     mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<any, Error, {
         space: Partial<import("..").IAnySpace>;
         organization?: import("..").IAnyOrganization;
+        team?: {
+            id?: string;
+            handle?: string;
+        };
     }, unknown>;
 } | {
     createProject: (request: CreateProjectRequest) => Promise<any>;
@@ -457,6 +489,10 @@ export declare function useCreateProject(): {
     variables: {
         space: Partial<import("..").IAnySpace>;
         organization?: import("..").IAnyOrganization;
+        team?: {
+            id?: string;
+            handle?: string;
+        };
     };
     isError: false;
     isIdle: false;
@@ -466,6 +502,10 @@ export declare function useCreateProject(): {
     mutate: import("@tanstack/react-query").UseMutateFunction<any, Error, {
         space: Partial<import("..").IAnySpace>;
         organization?: import("..").IAnyOrganization;
+        team?: {
+            id?: string;
+            handle?: string;
+        };
     }, unknown>;
     reset: () => void;
     context: unknown;
@@ -476,6 +516,10 @@ export declare function useCreateProject(): {
     mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<any, Error, {
         space: Partial<import("..").IAnySpace>;
         organization?: import("..").IAnyOrganization;
+        team?: {
+            id?: string;
+            handle?: string;
+        };
     }, unknown>;
 };
 /**

package/lib/hooks/useProjects.js

@@ -16,6 +16,31 @@ import { useMemo, useCallback } from 'react';
 import { useCache } from './useCache.js';
 /** The space type value used to identify project spaces in Solr */
 export const PROJECT_SPACE_VARIANT = 'project';
+const normalizeProjectItems = (items) => {
+    if (Array.isArray(items)) {
+        return items;
+    }
+    if (items && typeof items === 'object') {
+        return [items];
+    }
+    return [];
+};
+const isProjectSpace = (space) => {
+    const variant = space?.variant ?? space?.variant_s;
+    if (variant !== PROJECT_SPACE_VARIANT) {
+        return false;
+    }
+    const items = normalizeProjectItems(space?.items);
+    if (items.length === 0) {
+        return true;
+    }
+    const hasNotebook = items.some(item => (item?.type_s ?? item?.type) === 'notebook');
+    const hasDocument = items.some(item => {
+        const type = item?.type_s ?? item?.type;
+        return type === 'document' || type === 'lexical';
+    });
+    return hasNotebook && hasDocument;
+};
 /**
  * Hook to fetch user's projects (spaces with type "project").
  *
@@ -29,8 +54,7 @@ export function useProjects() {
         if (!allSpaces)
             return [];
         return allSpaces
-            .filter((space) => space.variant === PROJECT_SPACE_VARIANT ||
-            space.type_s === PROJECT_SPACE_VARIANT)
+            .filter((space) => isProjectSpace(space))
             .map((space) => ({
             uid: space.uid,
             id: space.id ?? space.uid,

package/lib/index.d.ts

@@ -11,7 +11,7 @@ export { API_BASE_PATHS } from './api/constants';
 export * as runtimesApi from './api/runtimes';
 export * as iamApi from './api/iam';
 export * as spacerApi from './api/spacer';
-export { DatalayerClient, type DatalayerClientConfig, type ClientHandlers, User, Runtime, Environment, Snapshot, Space, Project, 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 ProjectJSON, type ProjectDefaultItems, type UpdateSpaceRequest, type GetSpaceResponse, type UpdateSpaceResponse, type DeleteSpaceResponse, type GetSpaceDefaultItemsResponse, type GetSpacesByTypeResponse, 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 { DatalayerClient, type DatalayerClientConfig, type ClientHandlers, User, Runtime, Environment, Snapshot, Space, Project, 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 CodeSandboxSnapshotData, type CreditsInfo, type CreditReservation, type CreateRuntimeRequest, type CreateRuntimeResponse, type ListRuntimesResponse, type ListEnvironmentsResponse, type CreateCodeSandboxSnapshotRequest, type CreateCodeSandboxSnapshotResponse, type GetCodeSandboxSnapshotResponse, type ListCodeSandboxSnapshotsResponse, 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 ProjectJSON, type ProjectDefaultItems, type UpdateSpaceRequest, type GetSpaceResponse, type UpdateSpaceResponse, type DeleteSpaceResponse, type GetSpaceDefaultItemsResponse, type GetSpacesByTypeResponse, type NotebookJSON, type LexicalJSON, type CodeSandboxSnapshotJSON, 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 ICodeSandboxSnapshot, 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, getSandboxSnapshots, loadSandboxSnapshot, } from './stateful/runtimes/actions';
 export * from './otel';
 export * from './views';

package/lib/index.js

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

package/lib/mocks/components/FlashMock.js

@@ -4,10 +4,16 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * Distributed under the terms of the Modified BSD License.
  */
 import { AlertIcon } from '@primer/octicons-react';
-import { Flash, Link } from '@primer/react';
+import { Box, Button, Flash } from '@primer/react';
 import { useNavigate } from '../../hooks/index.js';
 export const FlashMock = () => {
     const navigate = useNavigate();
-    return (_jsxs(Flash, { variant: "warning", style: { marginBottom: 10 }, children: [_jsx(AlertIcon, {}), " This is a mock content.", ' ', _jsx(Link, { href: "#", onClick: e => navigate('/contact', e), children: "Contact us" }), ' ', "if you'd like to know more about this feature."] }));
+    return (_jsx(Flash, { variant: "warning", style: { marginBottom: 10 }, children: _jsxs(Box, { sx: {
+                display: 'flex',
+                alignItems: 'center',
+                justifyContent: 'space-between',
+                gap: 3,
+                width: '100%',
+            }, children: [_jsxs(Box, { sx: { display: 'flex', alignItems: 'center', gap: 2 }, children: [_jsx(AlertIcon, {}), _jsx("span", { children: "This is placeholder content. Contact us to learn more about this feature." })] }), _jsx(Button, { size: "small", onClick: () => navigate('/contact'), children: "Contact Us" })] }) }));
 };
 export default FlashMock;

package/lib/models/{RuntimeSnapshot.d.ts → CodeSandboxSnapshot.d.ts}

@@ -1,7 +1,7 @@
 /**
- * Runtime snapshot from API.
+ * Code Sandbox snapshot from API.
  */
-export interface IAPIRuntimeSnapshot {
+export interface IAPICodeSandboxSnapshot {
     /**
      * Snapshot UID
      */
@@ -44,9 +44,9 @@ export interface IAPIRuntimeSnapshot {
     status: string;
 }
 /**
- * Runtime snapshot model.
+ * Code Sandbox snapshot model.
  */
-export interface IRuntimeSnapshot {
+export interface ICodeSandboxSnapshot {
     /**
      * Snapshot UID
      */
@@ -89,4 +89,4 @@ export interface IRuntimeSnapshot {
      */
     status: string;
 }
-export declare function asRuntimeSnapshot(s: IAPIRuntimeSnapshot): IRuntimeSnapshot;
+export declare function asCodeSandboxSnapshot(s: IAPICodeSandboxSnapshot): ICodeSandboxSnapshot;

package/lib/models/{RuntimeSnapshot.js → CodeSandboxSnapshot.js}

@@ -2,7 +2,7 @@
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-export function asRuntimeSnapshot(s) {
+export function asCodeSandboxSnapshot(s) {
     const { uid, updated_at, format_version, ...others } = s;
     return {
         ...others,

package/lib/models/{RuntimeSnapshotDTO.d.ts → CodeSandboxSnapshotDTO.d.ts}

@@ -1,15 +1,15 @@
 /**
  * Snapshot domain model for the Datalayer Client.
  *
- * @module models/RuntimeSnapshotDTO
+ * @module models/CodeSandboxSnapshotDTO
  */
 import type { DatalayerClient } from '../index';
 import { RuntimeDTO } from './RuntimeDTO';
 /**
  * Represents a runthime snapshot of a runtime's state and files.
- * @interface RuntimeSnapshotData
+ * @interface CodeSandboxSnapshotData
  */
-export interface RuntimeSnapshotData {
+export interface CodeSandboxSnapshotData {
     /** Unique identifier for the snapshot */
     uid: string;
     /** Name of the snapshot */
@@ -42,7 +42,7 @@ export interface RuntimeSnapshotData {
  * This is the contract that Client consumers can rely on.
  * The raw API may change, but this interface remains stable.
  */
-export interface RuntimeSnapshotJSON {
+export interface CodeSandboxSnapshotJSON {
     /** Unique identifier for the snapshot */
     uid: string;
     /** Name of the snapshot */
@@ -55,10 +55,10 @@ export interface RuntimeSnapshotJSON {
     updatedAt: string;
 }
 /**
- * Request payload for creating a runtime snapshot
- * @interface CreateRuntimeSnapshotRequest
+ * Request payload for creating a code sandbox snapshot
+ * @interface CreateCodeSandboxSnapshotRequest
  */
-export interface CreateRuntimeSnapshotRequest {
+export interface CreateCodeSandboxSnapshotRequest {
     /** Pod name of the runtime to snapshot */
     pod_name: string;
     /** Name for the snapshot */
@@ -69,44 +69,44 @@ export interface CreateRuntimeSnapshotRequest {
     stop: boolean;
 }
 /**
- * Response for getting a specific runtime snapshot
- * @interface GetRuntimeSnapshotResponse
+ * Response for getting a specific code snapshot snapshot
+ * @interface GetCodeSandboxSnapshotResponse
  */
-export interface GetRuntimeSnapshotResponse {
+export interface GetCodeSandboxSnapshotResponse {
     /** Indicates if the request was successful */
     success: boolean;
     /** Response message */
     message: string;
     /** The snapshot details */
-    snapshot: RuntimeSnapshotData;
+    snapshot: CodeSandboxSnapshotData;
 }
 /**
- * Response for creating a runtime snapshot
- * @interface CreateRuntimeSnapshotResponse
+ * Response for creating a code sandbox snapshot
+ * @interface CreateCodeSandboxSnapshotResponse
  */
-export interface CreateRuntimeSnapshotResponse {
+export interface CreateCodeSandboxSnapshotResponse {
     /** Indicates if the request was successful */
     success: boolean;
     /** Response message */
     message: string;
     /** The created snapshot details */
-    snapshot: RuntimeSnapshotData;
+    snapshot: CodeSandboxSnapshotData;
 }
 /**
- * Response from listing runtime snapshots
- * @interface RuntimeSnapshotsListResponse
+ * Response from listing code sandbox snapshots
+ * @interface ListCodeSandboxSnapshotsResponse
  */
-export interface ListRuntimeSnapshotsResponse {
+export interface ListCodeSandboxSnapshotsResponse {
     /** Whether the request was successful */
     success: boolean;
     /** Response message from the server */
     message: string;
-    /** Array of runtime snapshots */
-    snapshots: RuntimeSnapshotData[];
+    /** Array of code sandbox snapshots */
+    snapshots: CodeSandboxSnapshotData[];
 }
 /**
  * Snapshot domain model that wraps API responses with convenient methods.
- * Provides runtime snapshot management with data refresh and lifecycle operations.
+ * Provides code sandbox snapshot management with data refresh and lifecycle operations.
  *
  * @example
  * ```typescript
@@ -114,17 +114,17 @@ export interface ListRuntimeSnapshotsResponse {
  * const runtime = await snapshot.restore();
  * ```
  */
-export declare class RuntimeSnapshotDTO {
-    protected _data: RuntimeSnapshotData;
+export declare class CodeSandboxSnapshotDTO {
+    protected _data: CodeSandboxSnapshotData;
     private _client;
     private _deleted;
     /**
-     * Create a Runtime Snapshot instance.
+     * Create a Code Sandbox Snapshot instance.
      *
      * @param data - Snapshot data from API
      * @param client - Client instance
      */
-    constructor(data: RuntimeSnapshotData, client: DatalayerClient);
+    constructor(data: CodeSandboxSnapshotData, client: DatalayerClient);
     /**
      * Check if this snapshot has been deleted and throw error if so.
      * @throws Error if deleted
@@ -146,28 +146,28 @@ export declare class RuntimeSnapshotDTO {
      */
     delete(): Promise<void>;
     /**
-     * Create a runtime from this snapshot (restore functionality).
+     * Create a code sandbox from this snapshot (restore functionality).
      *
      * @param minutesLimit - Time limit in minutes for the restored runtime
      * @returns Created Runtime instance
      */
     restore(minutesLimit: number): Promise<RuntimeDTO>;
     /**
-     * Get snapshot data in camelCase format.
+     * Get code snapshot snapshot data in camelCase format.
      * Returns only the core fields that consumers need.
      * This provides a stable interface regardless of API changes.
      * Note: Returns current cached state - call getStatus() first if you need fresh data.
      *
-     * @returns Core snapshot data with camelCase properties
+     * @returns Core code snapshot snapshot data with camelCase properties
      */
-    toJSON(): RuntimeSnapshotJSON;
+    toJSON(): CodeSandboxSnapshotJSON;
     /**
      * Get the raw snapshot data exactly as received from the API.
      * This preserves the original snake_case naming from the API response.
      *
      * @returns Raw snapshot data from API
      */
-    rawData(): RuntimeSnapshotData;
+    rawData(): CodeSandboxSnapshotData;
     /** String representation of the snapshot. */
     toString(): string;
 }

package/lib/models/{RuntimeSnapshotDTO.js → CodeSandboxSnapshotDTO.js}

@@ -6,7 +6,7 @@ import { snapshots } from '../api/runtimes/index.js';
 import { validateJSON } from '../api/utils/validation.js';
 /**
  * Snapshot domain model that wraps API responses with convenient methods.
- * Provides runtime snapshot management with data refresh and lifecycle operations.
+ * Provides code sandbox snapshot management with data refresh and lifecycle operations.
  *
  * @example
  * ```typescript
@@ -14,12 +14,12 @@ import { validateJSON } from '../api/utils/validation.js';
  * const runtime = await snapshot.restore();
  * ```
  */
-export class RuntimeSnapshotDTO {
+export class CodeSandboxSnapshotDTO {
     _data;
     _client;
     _deleted = false;
     /**
-     * Create a Runtime Snapshot instance.
+     * Create a Code Sandbox Snapshot instance.
      *
      * @param data - Snapshot data from API
      * @param client - Client instance
@@ -83,7 +83,7 @@ export class RuntimeSnapshotDTO {
         this._deleted = true;
     }
     /**
-     * Create a runtime from this snapshot (restore functionality).
+     * Create a code sandbox from this snapshot (restore functionality).
      *
      * @param minutesLimit - Time limit in minutes for the restored runtime
      * @returns Created Runtime instance
@@ -102,12 +102,12 @@ export class RuntimeSnapshotDTO {
     // Utility Methods
     // ========================================================================
     /**
-     * Get snapshot data in camelCase format.
+     * Get code snapshot snapshot data in camelCase format.
      * Returns only the core fields that consumers need.
      * This provides a stable interface regardless of API changes.
      * Note: Returns current cached state - call getStatus() first if you need fresh data.
      *
-     * @returns Core snapshot data with camelCase properties
+     * @returns Core code snapshot snapshot data with camelCase properties
      */
     toJSON() {
         this._checkDeleted();

package/lib/models/Environment.d.ts

@@ -41,6 +41,10 @@ export interface IDatalayerEnvironment {
      * Description
      */
     description: string;
+    /**
+     * Icon key (e.g. ai-agent -> AiAgentIcon)
+     */
+    icon?: string;
     /**
      * Execution language
      */

package/lib/models/IAM.d.ts

@@ -115,3 +115,69 @@ export interface MembershipsResponse {
     /** Memberships information */
     memberships: any[];
 }
+/**
+ * A principal (self / member organization / member team) the authenticated
+ * user can share artifacts with.
+ */
+export interface ShareablePrincipal {
+    kind: 'user' | 'organization' | 'team';
+    uid: string;
+    handle: string;
+    name?: string | null;
+    description?: string | null;
+    email?: string | null;
+    avatar_url?: string | null;
+    /** Parent organization UID — set when kind === 'team'. */
+    organization_uid?: string | null;
+    /** Parent organization handle — set when kind === 'team'. */
+    organization_handle?: string | null;
+}
+/**
+ * Response from the /principals/shareable endpoint.
+ */
+export interface ShareablePrincipalsResponse {
+    success: boolean;
+    message?: string;
+    principals: ShareablePrincipal[];
+}
+export interface PrincipalSearchUser {
+    uid: string;
+    handle_s: string;
+    first_name_t?: string;
+    last_name_t?: string;
+    display_name_t?: string;
+    display_name?: string;
+    origin_s?: string;
+    origin?: string;
+    avatar_url_s?: string;
+    avatarUrl?: string;
+    [key: string]: any;
+}
+export interface PrincipalSearchTeam {
+    uid: string;
+    handle_s: string;
+    name_t?: string;
+    description_t?: string;
+    organization_uid?: string;
+    organization_handle_s?: string;
+    [key: string]: any;
+}
+export interface PrincipalSearchOrganization {
+    uid: string;
+    handle_s: string;
+    name_t?: string;
+    description_t?: string;
+    [key: string]: any;
+}
+export interface PrincipalSearchResponseData {
+    users: PrincipalSearchUser[];
+    teams: PrincipalSearchTeam[];
+    organizations: PrincipalSearchOrganization[];
+    principalTypes: string[];
+    total: number;
+}
+export interface PrincipalSearchResponse {
+    success: boolean;
+    message: string;
+    data: PrincipalSearchResponseData;
+}

package/lib/models/Organization.d.ts

@@ -14,6 +14,7 @@ export type IBaseOrganization = {
     handle: string;
     type: string;
     name: string;
+    displayName?: string;
     description: string;
     public: boolean;
     creationDate: Date;

package/lib/models/Organization.js

@@ -23,6 +23,7 @@ export function asOrganization(org) {
         handle: org.handle_s,
         type: 'organization',
         name: org.name_t,
+        displayName: org.display_name_t || org.name_t,
         description: org.description_t,
         public: org.public_b,
         members,

package/lib/models/Page.d.ts

@@ -1,7 +1,7 @@
 import { INotebookContent } from '@jupyterlab/nbformat';
 import { IUser } from './User';
 import { PageTagName } from './PageTag';
-import { IRuntimeSnapshot } from './RuntimeSnapshot';
+import { ICodeSandboxSnapshot } from './CodeSandboxSnapshot';
 export type PageTheme = 'default';
 export type PageVariant = 'document' | 'cell' | 'notebook';
 /**
@@ -29,7 +29,7 @@ export type IPage = {
     screenCapture?: string;
     creator?: IUser;
     creatorId?: string;
-    kernelSnapshot?: IRuntimeSnapshot;
+    kernelSnapshot?: ICodeSandboxSnapshot;
     kernelSnapshotId?: string;
     createdAt?: string;
     updatedAt?: string;