@datalayer/core 1.0.14 → 1.0.15

package/lib/client/mixins/SpacerMixin.js

@@ -15,8 +15,10 @@ import * as items from '../../api/spacer/items.js';
 import { NotebookDTO } from '../../models/NotebookDTO.js';
 import { LexicalDTO } from '../../models/LexicalDTO.js';
 import { SpaceDTO } from '../../models/SpaceDTO.js';
+import { ProjectDTO } from '../../models/ProjectDTO.js';
 import { HealthCheck } from '../../models/HealthCheck.js';
 import { convertSpaceItemsToModels } from '../utils/spacerUtils.js';
+import { generateHandle } from '../utils/slugify.js';
 /** Spacer mixin providing workspace and content management. */
 export function SpacerMixin(Base) {
     return class extends Base {
@@ -336,5 +338,257 @@ export function SpacerMixin(Base) {
             }
             return response.sessionId;
         }
+        // ========================================================================
+        // Additional Space Operations
+        // ========================================================================
+        /**
+         * Get a space by UID.
+         * @param uid - Space UID
+         * @returns Space instance
+         */
+        async getSpace(uid) {
+            const token = this.getToken();
+            const spacerRunUrl = this.getSpacerRunUrl();
+            const response = await spaces.getSpace(token, uid, spacerRunUrl);
+            if (!response.space) {
+                throw new Error(`Space with UID '${uid}' not found`);
+            }
+            return new SpaceDTO(response.space, this);
+        }
+        /**
+         * Update a space (owner updating their own space).
+         * @param uid - Space UID
+         * @param data - Update data (supports arbitrary Solr fields)
+         * @returns Updated Space instance
+         */
+        async updateSpace(uid, data) {
+            const token = this.getToken();
+            const spacerRunUrl = this.getSpacerRunUrl();
+            const response = await spaces.updateSpace(token, uid, data, spacerRunUrl);
+            if (!response.space) {
+                throw new Error(`Failed to update space '${uid}'`);
+            }
+            return new SpaceDTO(response.space, this);
+        }
+        /**
+         * Update a user-specific space (e.g., org admin context).
+         * @param uid - Space UID
+         * @param userId - User ID
+         * @param data - Update data (supports arbitrary Solr fields)
+         * @returns Updated Space instance
+         */
+        async updateUserSpace(uid, userId, data) {
+            const token = this.getToken();
+            const spacerRunUrl = this.getSpacerRunUrl();
+            const response = await spaces.updateUserSpace(token, uid, userId, data, spacerRunUrl);
+            if (!response.space) {
+                throw new Error(`Failed to update space '${uid}' for user '${userId}'`);
+            }
+            return new SpaceDTO(response.space, this);
+        }
+        /**
+         * Delete a space and all its contents.
+         * @param uid - Space UID
+         */
+        async deleteSpace(uid) {
+            const token = this.getToken();
+            const spacerRunUrl = this.getSpacerRunUrl();
+            await spaces.deleteSpace(token, uid, spacerRunUrl);
+        }
+        /**
+         * Make a space public.
+         * @param uid - Space UID
+         * @returns Updated Space instance
+         */
+        async makeSpacePublic(uid) {
+            const token = this.getToken();
+            const spacerRunUrl = this.getSpacerRunUrl();
+            const response = await spaces.makeSpacePublic(token, uid, spacerRunUrl);
+            if (!response.space) {
+                throw new Error(`Failed to make space '${uid}' public`);
+            }
+            return new SpaceDTO(response.space, this);
+        }
+        /**
+         * Make a space private.
+         * @param uid - Space UID
+         * @returns Updated Space instance
+         */
+        async makeSpacePrivate(uid) {
+            const token = this.getToken();
+            const spacerRunUrl = this.getSpacerRunUrl();
+            const response = await spaces.makeSpacePrivate(token, uid, spacerRunUrl);
+            if (!response.space) {
+                throw new Error(`Failed to make space '${uid}' private`);
+            }
+            return new SpaceDTO(response.space, this);
+        }
+        /**
+         * Export a space and its contents.
+         * @param uid - Space UID
+         * @returns Export data
+         */
+        async exportSpace(uid) {
+            const token = this.getToken();
+            const spacerRunUrl = this.getSpacerRunUrl();
+            return spaces.exportSpace(token, uid, spacerRunUrl);
+        }
+        /**
+         * Clone a notebook.
+         * @param id - Notebook ID to clone
+         * @returns Cloned Notebook instance
+         */
+        async cloneNotebook(id) {
+            const token = this.getToken();
+            const spacerRunUrl = this.getSpacerRunUrl();
+            const response = await notebooks.cloneNotebook(token, id, spacerRunUrl);
+            if (!response.notebook) {
+                throw new Error(`Failed to clone notebook '${id}'`);
+            }
+            return new NotebookDTO(response.notebook, this);
+        }
+        /**
+         * Clone a lexical document.
+         * @param id - Document ID to clone
+         * @returns Cloned Lexical instance
+         */
+        async cloneLexical(id) {
+            const token = this.getToken();
+            const spacerRunUrl = this.getSpacerRunUrl();
+            const response = await lexicals.cloneLexical(token, id, spacerRunUrl);
+            if (!response.document) {
+                throw new Error(`Failed to clone lexical document '${id}'`);
+            }
+            return new LexicalDTO(response.document, this);
+        }
+        // ========================================================================
+        // Projects
+        // ========================================================================
+        /**
+         * Get all projects for the authenticated user.
+         * Projects are spaces with variant='project'.
+         * @returns Array of Project instances
+         */
+        async getProjects() {
+            // Use getMySpaces and filter by variant, because the
+            // /spaces/types/project endpoint returns empty results.
+            const allSpaces = await this.getMySpaces();
+            return allSpaces
+                .filter(s => s.variant === 'project')
+                .map(s => new ProjectDTO(s.rawData()));
+        }
+        /**
+         * Get a project by UID.
+         * @param uid - Project UID
+         * @returns Project instance
+         */
+        async getProject(uid) {
+            const token = this.getToken();
+            const spacerRunUrl = this.getSpacerRunUrl();
+            const response = await spaces.getSpace(token, uid, spacerRunUrl);
+            if (!response.space) {
+                throw new Error(`Project with UID '${uid}' not found`);
+            }
+            return new ProjectDTO(response.space);
+        }
+        /**
+         * Create a new project.
+         * @param name - Project name
+         * @param description - Project description
+         * @returns Created Project instance
+         */
+        async createProject(name, description) {
+            const token = this.getToken();
+            const spacerRunUrl = this.getSpacerRunUrl();
+            const spaceHandle = generateHandle(name);
+            const data = {
+                name,
+                description: description || '',
+                variant: 'project',
+                spaceHandle,
+                organizationId: '',
+                seedSpaceId: '',
+                public: false,
+            };
+            const response = await spaces.createSpace(token, data, spacerRunUrl);
+            if (!response.space) {
+                throw new Error('Failed to create project: no project returned');
+            }
+            return new ProjectDTO(response.space);
+        }
+        /**
+         * Update a project.
+         * @param uid - Project UID
+         * @param data - Update data (supports arbitrary Solr fields)
+         * @returns Updated Project instance
+         */
+        async updateProject(uid, data) {
+            const token = this.getToken();
+            const spacerRunUrl = this.getSpacerRunUrl();
+            // Resolve userId from: IAM mixin cache > AuthenticationManager cache > whoami()
+            let resolvedUserId;
+            const iamUser = this.currentUserCache;
+            if (iamUser) {
+                resolvedUserId = iamUser.uid ?? iamUser.id;
+            }
+            if (!resolvedUserId) {
+                const authUser = this.auth?.getCurrentUser?.();
+                if (authUser) {
+                    resolvedUserId = authUser.uid ?? authUser.id;
+                }
+            }
+            if (!resolvedUserId) {
+                try {
+                    const user = await this.whoami();
+                    resolvedUserId = user?.uid ?? user?.id;
+                }
+                catch (_e) {
+                    // whoami() not available — no user context
+                }
+            }
+            if (!resolvedUserId) {
+                throw new Error('Cannot update project: no authenticated user');
+            }
+            const response = await spaces.updateUserSpace(token, uid, resolvedUserId, data, spacerRunUrl);
+            if (response.space) {
+                return new ProjectDTO(response.space);
+            }
+            // Backend returns space: null on success for user-scoped updates.
+            // Re-fetch the project to return fresh data.
+            const freshResponse = await spaces.getSpace(token, uid, spacerRunUrl);
+            if (!freshResponse.space) {
+                throw new Error(`Failed to update project '${uid}'`);
+            }
+            return new ProjectDTO(freshResponse.space);
+        }
+        /**
+         * Rename a project.
+         * @param uid - Project UID
+         * @param newName - New project name
+         * @param description - Project description to preserve.
+         * @param userId - Authenticated user ID for user-scoped update.
+         * @returns Updated Project instance
+         */
+        async renameProject(uid, newName, description) {
+            const data = { name: newName };
+            if (description !== undefined) {
+                data.description = description;
+            }
+            return this.updateProject(uid, data);
+        }
+        /**
+         * Get default items (notebook UID and document UID) for a project.
+         * @param uid - Project UID
+         * @returns Default notebook and document UIDs
+         */
+        async getProjectDefaultItems(uid) {
+            const token = this.getToken();
+            const spacerRunUrl = this.getSpacerRunUrl();
+            const response = await spaces.getSpaceDefaultItems(token, uid, spacerRunUrl);
+            return {
+                defaultNotebookUid: response.default_notebook_uid,
+                defaultDocumentUid: response.default_document_uid,
+            };
+        }
     };
 }

package/lib/client/utils/slugify.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generate a URL-friendly handle from a name.
+ *
+ * @param name - The name to convert to a handle
+ * @param fallbackPrefix - Prefix for the fallback handle if name produces empty result
+ * @returns URL-friendly handle string
+ */
+export declare function generateHandle(name: string, fallbackPrefix?: string): string;

package/lib/client/utils/slugify.js

@@ -0,0 +1,18 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * Generate a URL-friendly handle from a name.
+ *
+ * @param name - The name to convert to a handle
+ * @param fallbackPrefix - Prefix for the fallback handle if name produces empty result
+ * @returns URL-friendly handle string
+ */
+export function generateHandle(name, fallbackPrefix = 'project') {
+    const handle = name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+    return handle || `${fallbackPrefix}-${Date.now()}`;
+}

package/lib/components/sparklines/dataProcessing.d.ts

@@ -1,3 +1,5 @@
+import type { Point } from './types';
+export type { Point } from './types';
 /**
  * Get minimum value from array
  */
@@ -18,8 +20,4 @@ export interface DataToPointsOptions {
     max?: number;
     min?: number;
 }
-export interface Point {
-    x: number;
-    y: number;
-}
 export declare const dataToPoints: ({ data, limit, width, height, margin, max: maxVal, min: minVal, }: DataToPointsOptions) => Point[];

package/lib/components/sparklines/dataProcessing.js

@@ -2,10 +2,6 @@
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-/*
- * Copyright (c) 2025-2026 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
 /**
  * Get minimum value from array
  */

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

@@ -2,3 +2,4 @@ export { Sparklines } from './Sparklines';
 export { SparklinesLine } from './SparklinesLine';
 export type { SparklinesProps, SparklinesLineProps, Point } from './types';
 export { dataToPoints, min, max } from './dataProcessing';
+export type { DataToPointsOptions } from './dataProcessing';

package/lib/config/Configuration.d.ts

@@ -26,7 +26,7 @@ export type IDatalayerCoreConfig = {
     /**
      * CPU environment name.
      * Specifies which CPU-based environment to use for kernels.
-     * @example "python-cpu-env"
+     * @example "ai-agents-env"
      */
     cpuEnvironment: string;
     /**

package/lib/config/Configuration.js

@@ -28,7 +28,7 @@ export class DatalayerConfiguration {
 export const DEFAULT_DATALAYER_CONFIG = {
     runUrl: 'https://oss.datalayer.run',
     credits: 100,
-    cpuEnvironment: 'python-cpu-env',
+    cpuEnvironment: 'ai-agents-env',
     gpuEnvironment: 'ai-env',
 };
 /**

package/lib/hooks/useCache.js

@@ -3249,7 +3249,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
     };
     /**
      * Get default items (notebook UID & document UID) for a space / project.
-     * Calls GET /api/spacer/v1/spaces/{spaceId}/default-items
+     * Calls `GET /api/spacer/v1/spaces/:spaceId/default-items`
      */
     const useSpaceDefaultItems = (spaceId) => {
         return useQuery({

package/lib/hooks/useProjects.d.ts

@@ -571,17 +571,11 @@ export declare function useRefreshProjects(): import("@tanstack/react-query").Us
  * Hook to delete a project (space) and all its contents.
  */
 export declare function useDeleteProject(): import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
-/**
- * Default items (notebook UID and document UID) for a project.
- */
-export type ProjectDefaultItems = {
-    defaultNotebookUid: string | null;
-    defaultDocumentUid: string | null;
-};
+export type { ProjectDefaultItems } from '../models/ProjectDTO';
 /**
  * Hook to fetch the default notebook and document UIDs for a project.
  *
- * This calls the spacer `GET /spaces/{uid}/default-items` endpoint which
+ * This calls the spacer `GET /spaces/:uid/default-items` endpoint which
  * returns the UID of the first notebook and first document in the space.
  */
 export declare function useProjectDefaultItems(projectUid: string | undefined): import("@tanstack/react-query").UseQueryResult<{

package/lib/hooks/useProjects.js

@@ -157,7 +157,7 @@ export function useDeleteProject() {
 /**
  * Hook to fetch the default notebook and document UIDs for a project.
  *
- * This calls the spacer `GET /spaces/{uid}/default-items` endpoint which
+ * This calls the spacer `GET /spaces/:uid/default-items` endpoint which
  * returns the UID of the first notebook and first document in the space.
  */
 export function useProjectDefaultItems(projectUid) {

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

package/lib/index.js

@@ -21,7 +21,7 @@ export {
 // Export client and config types
 DatalayerClient, 
 // Export domain models
-User, Runtime, Environment, Snapshot, Space, Notebook, LexicalDTO, Secret, Credits, Item, HealthCheck, 
+User, Runtime, Environment, Snapshot, Space, Project, Notebook, LexicalDTO, Secret, Credits, Item, HealthCheck, 
 // Export auth
 AuthenticationManager, Datasource, } from './client/index.js';
 // Export commonly used functions directly for convenience

package/lib/models/EnvironmentDTO.d.ts

@@ -97,7 +97,7 @@ export declare class EnvironmentDTO {
     constructor(data: EnvironmentData, _client: DatalayerClient);
     /** Human-readable title for the environment (e.g., 'AI Environment', 'Python CPU Environment'). */
     get title(): string;
-    /** Unique name identifier for the environment (e.g., 'ai-env', 'python-cpu-env'). */
+    /** Unique name identifier for the environment (e.g., 'ai-env', 'ai-agents-env'). */
     get name(): string;
     /** Credits consumed per hour for this environment. */
     get burningRate(): number;

package/lib/models/EnvironmentDTO.js

@@ -34,7 +34,7 @@ export class EnvironmentDTO {
     get title() {
         return this._data.title;
     }
-    /** Unique name identifier for the environment (e.g., 'ai-env', 'python-cpu-env'). */
+    /** Unique name identifier for the environment (e.g., 'ai-env', 'ai-agents-env'). */
     get name() {
         return this._data.name;
     }

package/lib/models/ProjectDTO.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Project domain model for the Datalayer Client.
+ *
+ * Projects are spaces with variant='project' that can have attached agents.
+ * This is a standalone model (no inheritance from SpaceDTO) to avoid
+ * circular dependency issues in the module graph.
+ *
+ * @module models/ProjectDTO
+ */
+import type { SpaceData } from './SpaceDTO';
+/**
+ * Stable public interface for Project data.
+ */
+export interface ProjectJSON {
+    uid: string;
+    id: string;
+    handle: string;
+    name: string;
+    description: string;
+    variant: string;
+    isPublic: boolean;
+    createdAt: string;
+    attachedAgentPodName: string | null;
+    attachedAgentSpecId: string | null;
+    attachedAgentGivenName: string | null;
+    hasAgent: boolean;
+}
+/**
+ * Default items (notebook UID and document UID) for a project.
+ */
+export interface ProjectDefaultItems {
+    defaultNotebookUid: string | null;
+    defaultDocumentUid: string | null;
+}
+/**
+ * Project domain model wrapping raw space data with project-specific accessors.
+ *
+ * @example
+ * ```typescript
+ * const projects = await client.getProjects();
+ * const project = projects[0];
+ * console.log(project.hasAgent); // false
+ * await client.assignAgent(project.uid, 'my-agent-pod');
+ * ```
+ */
+export declare class ProjectDTO {
+    private _data;
+    private _deleted;
+    private _createdAt;
+    constructor(data: SpaceData);
+    /** Unique identifier for the project. */
+    get uid(): string;
+    /** Internal numeric/string ID from the backend. Falls back to UID when not present. SDK client methods accept `uid` directly. */
+    get id(): string;
+    /** URL-friendly handle. */
+    get handle(): string;
+    /** Project name. */
+    get name(): string;
+    /** Project description. */
+    get description(): string;
+    /** Space variant (should be 'project'). */
+    get variant(): string;
+    /** Whether the project is public. */
+    get isPublic(): boolean;
+    /** Creation date (stable across calls). */
+    get createdAt(): Date;
+    /** Attached agent runtime pod name, if any. */
+    get attachedAgentPodName(): string | undefined;
+    /** Attached agent spec ID (e.g., 'data-acquisition'), if any. */
+    get attachedAgentSpecId(): string | undefined;
+    /** Human-readable name of the attached agent runtime, if any. */
+    get attachedAgentGivenName(): string | undefined;
+    /** Whether an agent is currently attached to this project. */
+    get hasAgent(): boolean;
+    /** Mark this project as deleted. */
+    markDeleted(): void;
+    /** Whether this project has been deleted. */
+    get isDeleted(): boolean;
+    /**
+     * Get project data in camelCase format.
+     * @returns Project data with camelCase properties
+     */
+    toJSON(): ProjectJSON;
+    /** Get raw space data as received from the API. */
+    rawData(): SpaceData;
+    /** String representation of the project. */
+    toString(): string;
+    private _checkDeleted;
+}

package/lib/models/ProjectDTO.js

@@ -0,0 +1,131 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * Project domain model wrapping raw space data with project-specific accessors.
+ *
+ * @example
+ * ```typescript
+ * const projects = await client.getProjects();
+ * const project = projects[0];
+ * console.log(project.hasAgent); // false
+ * await client.assignAgent(project.uid, 'my-agent-pod');
+ * ```
+ */
+export class ProjectDTO {
+    _data;
+    _deleted = false;
+    _createdAt;
+    constructor(data) {
+        this._data = data;
+        // Cache creation date at construction to ensure stable value
+        this._createdAt = data.creation_ts_dt
+            ? new Date(data.creation_ts_dt)
+            : new Date();
+    }
+    /** Unique identifier for the project. */
+    get uid() {
+        this._checkDeleted();
+        return this._data.uid;
+    }
+    /** Internal numeric/string ID from the backend. Falls back to UID when not present. SDK client methods accept `uid` directly. */
+    get id() {
+        this._checkDeleted();
+        return this._data.id ?? this._data.uid;
+    }
+    /** URL-friendly handle. */
+    get handle() {
+        this._checkDeleted();
+        return this._data.handle_s;
+    }
+    /** Project name. */
+    get name() {
+        this._checkDeleted();
+        return this._data.name_t;
+    }
+    /** Project description. */
+    get description() {
+        this._checkDeleted();
+        return this._data.description_t ?? '';
+    }
+    /** Space variant (should be 'project'). */
+    get variant() {
+        this._checkDeleted();
+        return this._data.variant_s;
+    }
+    /** Whether the project is public. */
+    get isPublic() {
+        this._checkDeleted();
+        return this._data.public_b ?? false;
+    }
+    /** Creation date (stable across calls). */
+    get createdAt() {
+        this._checkDeleted();
+        return this._createdAt;
+    }
+    /** Attached agent runtime pod name, if any. */
+    get attachedAgentPodName() {
+        this._checkDeleted();
+        return this._data.attached_agent_pod_name_s || undefined;
+    }
+    /** Attached agent spec ID (e.g., 'data-acquisition'), if any. */
+    get attachedAgentSpecId() {
+        this._checkDeleted();
+        return this._data.attached_agent_spec_id_s || undefined;
+    }
+    /** Human-readable name of the attached agent runtime, if any. */
+    get attachedAgentGivenName() {
+        this._checkDeleted();
+        return this._data.attached_agent_given_name_s || undefined;
+    }
+    /** Whether an agent is currently attached to this project. */
+    get hasAgent() {
+        this._checkDeleted();
+        return !!this._data.attached_agent_pod_name_s;
+    }
+    /** Mark this project as deleted. */
+    markDeleted() {
+        this._deleted = true;
+    }
+    /** Whether this project has been deleted. */
+    get isDeleted() {
+        return this._deleted;
+    }
+    /**
+     * Get project data in camelCase format.
+     * @returns Project data with camelCase properties
+     */
+    toJSON() {
+        this._checkDeleted();
+        return {
+            uid: this.uid,
+            id: this.id,
+            handle: this.handle,
+            name: this.name,
+            description: this.description,
+            variant: this.variant,
+            isPublic: this.isPublic,
+            createdAt: this.createdAt.toISOString(),
+            attachedAgentPodName: this.attachedAgentPodName ?? null,
+            attachedAgentSpecId: this.attachedAgentSpecId ?? null,
+            attachedAgentGivenName: this.attachedAgentGivenName ?? null,
+            hasAgent: this.hasAgent,
+        };
+    }
+    /** Get raw space data as received from the API. */
+    rawData() {
+        this._checkDeleted();
+        return this._data;
+    }
+    /** String representation of the project. */
+    toString() {
+        this._checkDeleted();
+        return `Project(${this._data.uid}, ${this._data.name_t})`;
+    }
+    _checkDeleted() {
+        if (this._deleted) {
+            throw new Error(`Project ${this._data.uid} has been deleted and no longer exists`);
+        }
+    }
+}