@datalayer/core 0.0.27 → 1.0.1

package/lib/api/index.d.ts

@@ -2,7 +2,7 @@
  * Minimal API layer for the Datalayer platform providing base HTTP client and functional API methods.
  *
  * This module contains the low-level API functionality. For high-level object-oriented
- * Client classes, use @datalayer/core/sdk instead.
+ * Client classes, use @datalayer/core/client instead.
  *
  * @module @datalayer/core/api
  */

package/lib/api/index.js

@@ -6,7 +6,7 @@
  * Minimal API layer for the Datalayer platform providing base HTTP client and functional API methods.
  *
  * This module contains the low-level API functionality. For high-level object-oriented
- * Client classes, use @datalayer/core/sdk instead.
+ * Client classes, use @datalayer/core/client instead.
  *
  * @module @datalayer/core/api
  */

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

@@ -12,7 +12,7 @@ import { LexicalDTO } from '../../models/LexicalDTO';
  * to avoid code duplication.
  *
  * @param response - Raw API response containing space items
- * @param sdk - Client instance to pass to model constructors
+ * @param client - Client instance to pass to model constructors
  * @returns Array of Notebook and Lexical model instances
  */
-export declare function convertSpaceItemsToModels(items: GetSpaceItemsResponse['items'], sdk: DatalayerClient): (NotebookDTO | LexicalDTO)[];
+export declare function convertSpaceItemsToModels(items: GetSpaceItemsResponse['items'], client: DatalayerClient): (NotebookDTO | LexicalDTO)[];

package/lib/client/utils/spacerUtils.js

@@ -11,20 +11,20 @@ import { ItemTypes } from '../constants';
  * to avoid code duplication.
  *
  * @param response - Raw API response containing space items
- * @param sdk - Client instance to pass to model constructors
+ * @param client - Client instance to pass to model constructors
  * @returns Array of Notebook and Lexical model instances
  */
-export function convertSpaceItemsToModels(items, sdk) {
+export function convertSpaceItemsToModels(items, client) {
     const modelItems = [];
     for (const item of items) {
         // Check various possible type fields
         const itemType = item.type_s;
         // Only include notebooks and lexicals
         if (itemType === ItemTypes.NOTEBOOK) {
-            modelItems.push(new NotebookDTO(item, sdk));
+            modelItems.push(new NotebookDTO(item, client));
         }
         else if (itemType === ItemTypes.LEXICAL) {
-            modelItems.push(new LexicalDTO(item, sdk));
+            modelItems.push(new LexicalDTO(item, client));
         }
         // Skip everything else (exercises, cells, etc.)
     }

package/lib/components/storage/ContentsBrowser.js

@@ -221,9 +221,9 @@ export function ContentsBrowser(props) {
                                 return child.type === 'directory' ? (_jsx(DirectoryItem, { item: child, contents: contents, current: selectedItem, documentRegistry: documentRegistry, onContextMenu: onContextMenu, onSelect: onSelect }, child.name)) : (_jsx(TreeItem, { item: child, current: selectedItem?.path === child.path, onSelect: item => {
                                         onSelect(item, refresh);
                                     }, onContextMenu: onContextMenu }, child.name));
-                            }) }), _jsx(ActionMenu, { anchorRef: contextMenuAnchor ?? undefined, open: contextMenuAnchor?.current !== null, onOpenChange: () => {
+                            }) }), contextMenuAnchor !== null && (_jsx(ActionMenu, { anchorRef: contextMenuAnchor ?? undefined, open: contextMenuAnchor?.current !== null, onOpenChange: () => {
                                 setContextMenuAnchor(null);
-                            }, children: _jsx(ActionMenu.Overlay, { children: _jsxs(ActionList, { children: [_jsx(ActionList.Item, { title: "Delete the active item.", onSelect: onSelectDelete, children: "Delete\u2026" }), localContents && (_jsx(ActionList.Item, { title: "Copy the active item to the local drive.", onSelect: onSelectCopyToLocal, children: "Copy to local drive\u2026" }))] }) }) }), openDeleteConfirmation && (_jsx(Dialog, { title: _jsx("span", { style: { color: 'var(--fgColor-default)' }, children: "Confirm deletion" }), onClose: () => {
+                            }, children: _jsx(ActionMenu.Overlay, { children: _jsxs(ActionList, { children: [_jsx(ActionList.Item, { title: "Delete the active item.", onSelect: onSelectDelete, children: "Delete\u2026" }), localContents && (_jsx(ActionList.Item, { title: "Copy the active item to the local drive.", onSelect: onSelectCopyToLocal, children: "Copy to local drive\u2026" }))] }) }) })), openDeleteConfirmation && (_jsx(Dialog, { title: _jsx("span", { style: { color: 'var(--fgColor-default)' }, children: "Confirm deletion" }), onClose: () => {
                                 setOpenDeleteConfirmation(false);
                             }, footerButtons: [
                                 {

package/lib/hooks/useCache.d.ts

@@ -451,7 +451,8 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
         space: Partial<IAnySpace>;
         organization?: IAnyOrganization;
     }, unknown>;
-    useUpdateSpace: () => import("@tanstack/react-query").UseMutationResult<any, Error, Partial<IAnySpace>, unknown>;
+    useUpdateSpace: () => import("@tanstack/react-query").UseMutationResult<any, Error, Partial<IAnySpace> & Record<string, unknown>, unknown>;
+    useDeleteSpace: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
     useUpdateOrganizationSpace: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
         organizationId: string;
         spaceId: string;
@@ -507,6 +508,7 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
         id: string;
         url: string | undefined;
         messageCount: number;
+        agent_spec_id: string | undefined;
         pod_name: string;
         environment_name: string;
         environment_title?: string;
@@ -526,6 +528,7 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
         id: string;
         url: string | undefined;
         messageCount: number;
+        agent_spec_id: string | undefined;
         pod_name: string;
         environment_name: string;
         environment_title?: string;
@@ -546,6 +549,7 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
         type?: string;
         editorVariant?: string;
         enableCodemode?: boolean;
+        agentSpecId?: string;
     }, unknown>;
     useDeleteAgentRuntime: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
     useRefreshAgentRuntimes: () => () => void;
@@ -712,6 +716,10 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
     useRefreshSpaceAssignments: (options?: UseMutationOptions<unknown, Error, string>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, string, unknown>;
     useDeleteItem: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
     useSpaceItems: (spaceId: string) => import("@tanstack/react-query").UseQueryResult<any[], Error>;
+    useSpaceDefaultItems: (spaceId: string | undefined) => import("@tanstack/react-query").UseQueryResult<{
+        defaultNotebookUid: string | null;
+        defaultDocumentUid: string | null;
+    }, Error>;
     useMakeItemPublic: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
     useMakeItemPrivate: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
     useSearchPublicItems: () => import("@tanstack/react-query").UseMutationResult<any, Error, {

package/lib/hooks/useCache.js

@@ -1321,17 +1321,20 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         });
     };
     /**
-     * Update space with optimistic update
+     * Update space with optimistic update.
+     * Any extra fields (e.g. attached_agent_pod_name_s) are forwarded to the backend.
      */
     const useUpdateSpace = () => {
         return useMutation({
             mutationFn: async (space) => {
+                const { id, name, description, ...extraFields } = space;
                 return requestDatalayer({
-                    url: `${configuration.spacerRunUrl}/api/spacer/v1/spaces/${space.id}/users/${user?.id}`,
+                    url: `${configuration.spacerRunUrl}/api/spacer/v1/spaces/${id}/users/${user?.id}`,
                     method: 'PUT',
                     body: {
-                        name: space.name,
-                        description: space.description,
+                        name,
+                        description,
+                        ...extraFields,
                     },
                 });
             },
@@ -1348,6 +1351,25 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
             },
         });
     };
+    /**
+     * Delete a space and all its contents.
+     */
+    const useDeleteSpace = () => {
+        return useMutation({
+            mutationFn: async (spaceUid) => {
+                return requestDatalayer({
+                    url: `${configuration.spacerRunUrl}/api/spacer/v1/spaces/${spaceUid}`,
+                    method: 'DELETE',
+                });
+            },
+            onSuccess: () => {
+                // Invalidate all space queries
+                queryClient.invalidateQueries({
+                    queryKey: queryKeys.spaces.all(),
+                });
+            },
+        });
+    };
     // ============================================================================
     // Agent Spaces Hooks
     // ============================================================================
@@ -1604,6 +1626,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                         // Map ingress URL to url for UI consistency
                         url: rt.ingress,
                         messageCount: 0, // Default for UI compatibility
+                        agent_spec_id: rt.agent_spec_id || undefined,
                     }));
                     // Set detail cache for each runtime
                     agentRuntimes.forEach((runtime) => {
@@ -1652,12 +1675,22 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                         // Map ingress URL to url for UI consistency
                         url: rt.ingress,
                         messageCount: 0,
+                        agent_spec_id: rt.agent_spec_id || undefined,
                     };
                 }
                 throw new Error('Failed to fetch agent runtime');
             },
             ...DEFAULT_QUERY_OPTIONS,
-            refetchInterval: 5000, // Refetch every 5 seconds for status
+            // Poll every 5 seconds while the runtime exists. Stop polling on error
+            // (e.g. 404 — runtime deleted, 500 — broken state) to avoid hammering the server.
+            refetchInterval: query => {
+                if (query.state.error)
+                    return false;
+                return 5000;
+            },
+            // Don't retry failed detail requests. The refetchInterval handles
+            // periodic re-checks, so retrying only generates duplicate failing requests.
+            retry: false,
             enabled: !!podName,
         });
     };
@@ -1669,11 +1702,12 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                     method: 'POST',
                     body: {
                         environment_name: data.environmentName || 'ai-agents-env',
-                        given_name: data.givenName || 'Agent Space',
+                        given_name: data.givenName || 'Agent',
                         credits_limit: data.creditsLimit || 10,
                         type: data.type || 'notebook',
                         editor_variant: data.editorVariant || 'none',
                         enable_codemode: data.enableCodemode ?? false,
+                        agent_spec_id: data.agentSpecId || undefined,
                     },
                 });
             },
@@ -1691,6 +1725,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                         // Map ingress URL to url for UI consistency
                         url: rt.ingress,
                         messageCount: 0,
+                        agent_spec_id: rt.agent_spec_id || undefined,
                     });
                     // Invalidate list
                     queryClient.invalidateQueries({
@@ -3613,6 +3648,30 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
             ...DEFAULT_QUERY_OPTIONS,
         });
     };
+    /**
+     * Get default items (notebook UID & document UID) for a space / project.
+     * Calls GET /api/spacer/v1/spaces/{spaceId}/default-items
+     */
+    const useSpaceDefaultItems = (spaceId) => {
+        return useQuery({
+            queryKey: ['spaces', spaceId, 'default-items'],
+            queryFn: async () => {
+                const resp = await requestDatalayer({
+                    url: `${configuration.spacerRunUrl}/api/spacer/v1/spaces/${spaceId}/default-items`,
+                    method: 'GET',
+                });
+                if (resp.success) {
+                    return {
+                        defaultNotebookUid: resp.default_notebook_uid,
+                        defaultDocumentUid: resp.default_document_uid,
+                    };
+                }
+                throw new Error(resp.message || 'Failed to fetch default items');
+            },
+            enabled: !!spaceId,
+            ...DEFAULT_QUERY_OPTIONS,
+        });
+    };
     /**
      * Make item public
      */
@@ -6467,6 +6526,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         useUserSpaces,
         useCreateSpace,
         useUpdateSpace,
+        useDeleteSpace,
         useUpdateOrganizationSpace,
         useAddMemberToOrganizationSpace,
         useRemoveMemberFromOrganizationSpace,
@@ -6576,6 +6636,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         // Items (Generic)
         useDeleteItem,
         useSpaceItems,
+        useSpaceDefaultItems,
         useMakeItemPublic,
         useMakeItemPrivate,
         useSearchPublicItems,

package/lib/models/CreditsDTO.d.ts

@@ -42,7 +42,7 @@ export interface CreditsResponse {
  *
  * @example
  * ```typescript
- * const credits = await sdk.getCredits();
+ * const credits = await client.getCredits();
  * console.log(`Available: ${credits.available}`);
  * console.log(`Quota: ${credits.quota || 'unlimited'}`);
  *

package/lib/models/CreditsDTO.js

@@ -13,7 +13,7 @@ import { validateJSON } from '../api/utils/validation';
  *
  * @example
  * ```typescript
- * const credits = await sdk.getCredits();
+ * const credits = await client.getCredits();
  * console.log(`Available: ${credits.available}`);
  * console.log(`Quota: ${credits.quota || 'unlimited'}`);
  *

package/lib/models/Datasource.d.ts

@@ -126,7 +126,7 @@ export interface UpdateDatasourceResponse {
  *
  * @example
  * ```typescript
- * const datasource = await sdk.createDatasource({
+ * const datasource = await client.createDatasource({
  *   type: 'Amazon Athena',
  *   name: 'my-athena-datasource',
  *   description: 'Production Athena datasource',
@@ -141,14 +141,14 @@ export interface UpdateDatasourceResponse {
 export declare class DatasourceDTO {
     /** @internal */
     _data: DatasourceData;
-    private _sdk;
+    private _client;
     private _deleted;
     /**
      * Create a Datasource instance.
      * @param data - Datasource data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data: DatasourceData, sdk: DatalayerClient);
+    constructor(data: DatasourceData, client: DatalayerClient);
     private _checkDeleted;
     get uid(): string;
     get type(): DatasourceType;

package/lib/models/Datasource.js

@@ -25,7 +25,7 @@ import { validateJSON } from '../api/utils/validation';
  *
  * @example
  * ```typescript
- * const datasource = await sdk.createDatasource({
+ * const datasource = await client.createDatasource({
  *   type: 'Amazon Athena',
  *   name: 'my-athena-datasource',
  *   description: 'Production Athena datasource',
@@ -40,16 +40,16 @@ import { validateJSON } from '../api/utils/validation';
 export class DatasourceDTO {
     /** @internal */
     _data;
-    _sdk;
+    _client;
     _deleted = false;
     /**
      * Create a Datasource instance.
      * @param data - Datasource data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data, sdk) {
+    constructor(data, client) {
         this._data = data;
-        this._sdk = sdk;
+        this._client = client;
     }
     // ========================================================================
     // Helper Methods
@@ -108,7 +108,7 @@ export class DatasourceDTO {
      */
     async update(updates) {
         this._checkDeleted();
-        const updated = await this._sdk.updateDatasource(this.uid, updates);
+        const updated = await this._client.updateDatasource(this.uid, updates);
         return updated;
     }
     /**
@@ -116,7 +116,7 @@ export class DatasourceDTO {
      */
     async delete() {
         this._checkDeleted();
-        await this._sdk.deleteDatasource(this.uid);
+        await this._client.deleteDatasource(this.uid);
         this._deleted = true;
     }
     // ========================================================================

package/lib/models/EnvironmentDTO.d.ts

@@ -80,7 +80,7 @@ export interface ListEnvironmentsResponse {
  *
  * @example
  * ```typescript
- * const environments = await sdk.listEnvironments();
+ * const environments = await client.listEnvironments();
  * const aiEnv = environments.find(env => env.name === 'ai-env');
  * console.log(aiEnv.title); // "AI Environment"
  * ```
@@ -92,9 +92,9 @@ export declare class EnvironmentDTO {
      * Create an Environment instance.
      *
      * @param data - Environment data from API
-     * @param _sdk - Client instance (not currently used but kept for consistency)
+     * @param _client - Client instance (not currently used but kept for consistency)
      */
-    constructor(data: EnvironmentData, _sdk: DatalayerClient);
+    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'). */

package/lib/models/EnvironmentDTO.js

@@ -9,7 +9,7 @@ import { validateJSON } from '../api/utils/validation';
  *
  * @example
  * ```typescript
- * const environments = await sdk.listEnvironments();
+ * const environments = await client.listEnvironments();
  * const aiEnv = environments.find(env => env.name === 'ai-env');
  * console.log(aiEnv.title); // "AI Environment"
  * ```
@@ -21,9 +21,9 @@ export class EnvironmentDTO {
      * Create an Environment instance.
      *
      * @param data - Environment data from API
-     * @param _sdk - Client instance (not currently used but kept for consistency)
+     * @param _client - Client instance (not currently used but kept for consistency)
      */
-    constructor(data, _sdk) {
+    constructor(data, _client) {
         this._data = data;
         // Client instance not currently used but kept for future extensibility
     }

package/lib/models/HealthCheck.d.ts

@@ -11,9 +11,9 @@ export declare class HealthCheck {
     /**
      * Create a HealthCheck instance.
      * @param data - The health check data
-     * @param sdk - Reference to the Client instance (unused but kept for consistency)
+     * @param client - Reference to the Client instance (unused but kept for consistency)
      */
-    constructor(data: any, sdk: any);
+    constructor(data: any, client: any);
     /**
      * Check if the service is healthy.
      * @returns True if the service is healthy

package/lib/models/HealthCheck.js

@@ -17,9 +17,9 @@ export class HealthCheck {
     /**
      * Create a HealthCheck instance.
      * @param data - The health check data
-     * @param sdk - Reference to the Client instance (unused but kept for consistency)
+     * @param client - Reference to the Client instance (unused but kept for consistency)
      */
-    constructor(data, sdk) {
+    constructor(data, client) {
         // Initialize properties
         this.healthy = data.healthy || false;
         this.status = data.status || 'unknown';

package/lib/models/ItemDTO.d.ts

@@ -13,14 +13,14 @@ import type { DatalayerClient } from '../index';
  */
 export declare abstract class ItemDTO<TData> {
     protected _data: TData;
-    private _sdk;
+    private _client;
     private _deleted;
     /**
      * Create an Item instance.
      * @param data - Item data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data: TData, sdk: DatalayerClient);
+    constructor(data: TData, client: DatalayerClient);
     /** Check if this item has been deleted. */
     get isDeleted(): boolean;
     /**

package/lib/models/ItemDTO.js

@@ -12,16 +12,16 @@ import * as items from '../api/spacer/items';
  */
 export class ItemDTO {
     _data;
-    _sdk;
+    _client;
     _deleted = false;
     /**
      * Create an Item instance.
      * @param data - Item data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data, sdk) {
+    constructor(data, client) {
         this._data = data;
-        this._sdk = sdk;
+        this._client = client;
     }
     // ========================================================================
     // Deletion State Management
@@ -105,8 +105,8 @@ export class ItemDTO {
      */
     async delete() {
         this._checkDeleted();
-        const token = this._sdk.getToken();
-        const spacerRunUrl = this._sdk.getSpacerRunUrl();
+        const token = this._client.getToken();
+        const spacerRunUrl = this._client.getSpacerRunUrl();
         await items.deleteItem(token, this.uid, spacerRunUrl);
         this._deleted = true;
     }
@@ -137,8 +137,8 @@ export class ItemDTO {
         }
         // Third try: Fetch full item details from API
         try {
-            const token = this._sdk.getToken();
-            const spacerRunUrl = this._sdk.getSpacerRunUrl();
+            const token = this._client.getToken();
+            const spacerRunUrl = this._client.getSpacerRunUrl();
             const response = await items.getItem(token, this.uid, spacerRunUrl);
             // Update internal data with full item details
             if (response.success && response.item) {
@@ -173,11 +173,11 @@ export class ItemDTO {
     // ========================================================================
     /** Get Client token for API calls. */
     _getToken() {
-        return this._sdk.getToken();
+        return this._client.getToken();
     }
     /** Get spacer API URL for API calls. */
     _getSpacerRunUrl() {
-        return this._sdk.getSpacerRunUrl();
+        return this._client.getSpacerRunUrl();
     }
     /** Update internal data after API call. */
     _updateData(newData) {

package/lib/models/LexicalDTO.d.ts

@@ -109,7 +109,7 @@ export interface LexicalJSON {
  *
  * @example
  * ```typescript
- * const lexical = await sdk.createLexical(formData);
+ * const lexical = await client.createLexical(formData);
  * await lexical.update({ name: 'Updated Documentation' });
  * ```
  */
@@ -118,9 +118,9 @@ export declare class LexicalDTO extends ItemDTO<LexicalData> {
      * Create a Lexical instance.
      *
      * @param data - Lexical data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data: LexicalData, sdk: DatalayerClient);
+    constructor(data: LexicalData, client: DatalayerClient);
     /** Document type identifier. */
     get type(): string;
     /** The cached name of the document. */

package/lib/models/LexicalDTO.js

@@ -17,7 +17,7 @@ import { validateJSON } from '../api/utils/validation';
  *
  * @example
  * ```typescript
- * const lexical = await sdk.createLexical(formData);
+ * const lexical = await client.createLexical(formData);
  * await lexical.update({ name: 'Updated Documentation' });
  * ```
  */
@@ -26,10 +26,10 @@ export class LexicalDTO extends ItemDTO {
      * Create a Lexical instance.
      *
      * @param data - Lexical data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data, sdk) {
-        super(data, sdk);
+    constructor(data, client) {
+        super(data, client);
     }
     // ========================================================================
     // Abstract Method Implementations

package/lib/models/NotebookDTO.d.ts

@@ -42,7 +42,7 @@ export interface NotebookJSON {
  *
  * @example
  * ```typescript
- * const notebook = await sdk.createNotebook(formData);
+ * const notebook = await client.createNotebook(formData);
  * const kernelSpec = await notebook.getKernelSpec();
  * ```
  */
@@ -51,9 +51,9 @@ export declare class NotebookDTO extends ItemDTO<NotebookData> {
      * Create a Notebook instance.
      *
      * @param data - Notebook data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data: NotebookData, sdk: DatalayerClient);
+    constructor(data: NotebookData, client: DatalayerClient);
     /** Document type identifier. */
     get type(): string;
     /** The cached name of the notebook. */

package/lib/models/NotebookDTO.js

@@ -12,7 +12,7 @@ import { validateJSON } from '../api/utils/validation';
  *
  * @example
  * ```typescript
- * const notebook = await sdk.createNotebook(formData);
+ * const notebook = await client.createNotebook(formData);
  * const kernelSpec = await notebook.getKernelSpec();
  * ```
  */
@@ -21,10 +21,10 @@ export class NotebookDTO extends ItemDTO {
      * Create a Notebook instance.
      *
      * @param data - Notebook data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data, sdk) {
-        super(data, sdk);
+    constructor(data, client) {
+        super(data, client);
     }
     // ========================================================================
     // Abstract Method Implementations
@@ -74,8 +74,8 @@ export class NotebookDTO extends ItemDTO {
     async update(name, description) {
         // FIXME: check if both are needed, and use the existing values if only one provided
         this._checkDeleted();
-        const token = this._sdk.getToken();
-        const spacerRunUrl = this._sdk.getSpacerRunUrl();
+        const token = this._client.getToken();
+        const spacerRunUrl = this._client.getSpacerRunUrl();
         const updateData = {};
         if (name !== undefined)
             updateData.name = name;

package/lib/models/RuntimeDTO.d.ts

@@ -105,22 +105,22 @@ export interface ListRuntimesResponse {
  *
  * @example
  * ```typescript
- * const runtime = await sdk.createRuntime({ environment_name: 'python-cpu' });
+ * const runtime = await client.createRuntime({ environment_name: 'python-cpu' });
  * await runtime.waitUntilReady();
  * ```
  */
 export declare class RuntimeDTO {
     /** @internal */
     _data: RuntimeData;
-    private _sdk;
+    private _client;
     private _deleted;
     /**
      * Create a Runtime instance.
      *
      * @param data - Runtime data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data: RuntimeData, sdk: DatalayerClient);
+    constructor(data: RuntimeData, client: DatalayerClient);
     /**
      * Check if this runtime has been deleted and throw error if so.
      * @throws Error if deleted

package/lib/models/RuntimeDTO.js

@@ -15,24 +15,24 @@ import { validateJSON } from '../api/utils/validation';
  *
  * @example
  * ```typescript
- * const runtime = await sdk.createRuntime({ environment_name: 'python-cpu' });
+ * const runtime = await client.createRuntime({ environment_name: 'python-cpu' });
  * await runtime.waitUntilReady();
  * ```
  */
 export class RuntimeDTO {
     /** @internal */
     _data;
-    _sdk;
+    _client;
     _deleted = false;
     /**
      * Create a Runtime instance.
      *
      * @param data - Runtime data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data, sdk) {
+    constructor(data, client) {
         this._data = data;
-        this._sdk = sdk;
+        this._client = client;
     }
     // ========================================================================
     // Helper Methods
@@ -112,7 +112,7 @@ export class RuntimeDTO {
      * After deletion, subsequent calls to dynamic methods will throw errors.
      */
     async delete() {
-        await this._sdk.deleteRuntime(this.podName);
+        await this._client.deleteRuntime(this.podName);
         this._deleted = true;
     }
     /**
@@ -123,8 +123,8 @@ export class RuntimeDTO {
      */
     async update(from) {
         this._checkDeleted();
-        const updated = await updateRuntime(this._sdk.getToken(), this.podName, from, this._sdk.getRuntimesRunUrl());
-        return new RuntimeDTO(updated, this._sdk);
+        const updated = await updateRuntime(this._client.getToken(), this.podName, from, this._client.getRuntimesRunUrl());
+        return new RuntimeDTO(updated, this._client);
     }
     /**
      * Create a snapshot of this runtime.
@@ -136,7 +136,7 @@ export class RuntimeDTO {
      */
     async createSnapshot(name, description, stop) {
         this._checkDeleted();
-        return await this._sdk.createSnapshot(this.podName, name, description, stop);
+        return await this._client.createSnapshot(this.podName, name, description, stop);
     }
     // ========================================================================
     // Utility Methods

package/lib/models/RuntimeSnapshotDTO.d.ts

@@ -116,15 +116,15 @@ export interface ListRuntimeSnapshotsResponse {
  */
 export declare class RuntimeSnapshotDTO {
     protected _data: RuntimeSnapshotData;
-    private _sdk;
+    private _client;
     private _deleted;
     /**
      * Create a Runtime Snapshot instance.
      *
      * @param data - Snapshot data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data: RuntimeSnapshotData, sdk: DatalayerClient);
+    constructor(data: RuntimeSnapshotData, client: DatalayerClient);
     /**
      * Check if this snapshot has been deleted and throw error if so.
      * @throws Error if deleted

package/lib/models/RuntimeSnapshotDTO.js

@@ -16,17 +16,17 @@ import { validateJSON } from '../api/utils/validation';
  */
 export class RuntimeSnapshotDTO {
     _data;
-    _sdk;
+    _client;
     _deleted = false;
     /**
      * Create a Runtime Snapshot instance.
      *
      * @param data - Snapshot data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data, sdk) {
+    constructor(data, client) {
         this._data = data;
-        this._sdk = sdk;
+        this._client = client;
     }
     // ========================================================================
     // Helper Methods
@@ -77,8 +77,8 @@ export class RuntimeSnapshotDTO {
      */
     async delete() {
         this._checkDeleted();
-        const token = this._sdk.getToken();
-        const runtimesRunUrl = this._sdk.getRuntimesRunUrl();
+        const token = this._client.getToken();
+        const runtimesRunUrl = this._client.getRuntimesRunUrl();
         await snapshots.deleteSnapshot(token, this.uid, runtimesRunUrl);
         this._deleted = true;
     }
@@ -90,7 +90,7 @@ export class RuntimeSnapshotDTO {
      */
     async restore(minutesLimit) {
         this._checkDeleted();
-        return await this._sdk.createRuntime({
+        return await this._client.createRuntime({
             environmentName: this.environment,
             type: 'notebook',
             givenName: `Restored from ${this.name}`,

package/lib/models/Secret.d.ts

@@ -116,7 +116,7 @@ export interface DeleteSecretResponse {
  *
  * @example
  * ```typescript
- * const secret = await sdk.createSecret({
+ * const secret = await client.createSecret({
  *   variant: 'password',
  *   name: 'db_password',
  *   description: 'Production DB password',
@@ -131,14 +131,14 @@ export interface DeleteSecretResponse {
 export declare class SecretDTO {
     /** @internal */
     _data: SecretData;
-    private _sdk;
+    private _client;
     private _deleted;
     /**
      * Create a Secret instance.
      * @param data - Secret data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data: SecretData, sdk: DatalayerClient);
+    constructor(data: SecretData, client: DatalayerClient);
     private _checkDeleted;
     private _decodeValue;
     get uid(): string;

package/lib/models/Secret.js

@@ -21,7 +21,7 @@ import { validateJSON } from '../api/utils/validation';
  *
  * @example
  * ```typescript
- * const secret = await sdk.createSecret({
+ * const secret = await client.createSecret({
  *   variant: 'password',
  *   name: 'db_password',
  *   description: 'Production DB password',
@@ -36,16 +36,16 @@ import { validateJSON } from '../api/utils/validation';
 export class SecretDTO {
     /** @internal */
     _data;
-    _sdk;
+    _client;
     _deleted = false;
     /**
      * Create a Secret instance.
      * @param data - Secret data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data, sdk) {
+    constructor(data, client) {
         this._data = data;
-        this._sdk = sdk;
+        this._client = client;
     }
     // ========================================================================
     // Helper Methods
@@ -105,7 +105,7 @@ export class SecretDTO {
      */
     async update(updates) {
         this._checkDeleted();
-        const updated = await this._sdk.updateSecret(this.uid, updates);
+        const updated = await this._client.updateSecret(this.uid, updates);
         return updated;
     }
     /**
@@ -113,7 +113,7 @@ export class SecretDTO {
      */
     async delete() {
         this._checkDeleted();
-        await this._sdk.deleteSecret(this.uid);
+        await this._client.deleteSecret(this.uid);
         this._deleted = true;
     }
     // ========================================================================

package/lib/models/Space.js

@@ -34,6 +34,9 @@ export const asSpace = (raw_space) => {
         organization: {
             handle: raw_space.handle_s,
         },
+        // Preserve raw Solr fields so consumers can access dynamic fields
+        // (e.g. attached_agent_pod_name_s for project-agent assignment)
+        ...raw_space,
     };
     return space;
 };

package/lib/models/SpaceDTO.d.ts

@@ -48,16 +48,16 @@ export interface SpaceJSON {
  */
 export declare class SpaceDTO {
     protected _data: SpaceData;
-    private _sdk;
+    private _client;
     private _items;
     private _deleted;
     /**
      * Create a Space instance.
      *
      * @param data - Space data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data: SpaceData, sdk: DatalayerClient);
+    constructor(data: SpaceData, client: DatalayerClient);
     /**
      * Check if this space has been deleted and throw error if so.
      * @throws Error if deleted

package/lib/models/SpaceDTO.js

@@ -29,18 +29,18 @@ import { validateJSON } from '../api/utils/validation';
  */
 export class SpaceDTO {
     _data;
-    _sdk;
+    _client;
     _items = null;
     _deleted = false;
     /**
      * Create a Space instance.
      *
      * @param data - Space data from API
-     * @param sdk - Client instance
+     * @param client - Client instance
      */
-    constructor(data, sdk) {
+    constructor(data, client) {
         this._data = data;
-        this._sdk = sdk;
+        this._client = client;
     }
     // ========================================================================
     // Helper Methods
@@ -58,8 +58,8 @@ export class SpaceDTO {
      * Refresh space data from the API by fetching user's spaces.
      */
     async refresh() {
-        const token = this._sdk.getToken();
-        const spacerRunUrl = this._sdk.getSpacerRunUrl();
+        const token = this._client.getToken();
+        const spacerRunUrl = this._client.getSpacerRunUrl();
         const response = await users.getMySpaces(token, spacerRunUrl);
         const freshSpace = response.spaces.find(s => s.uid === this.uid);
         if (freshSpace) {
@@ -110,8 +110,8 @@ export class SpaceDTO {
     async _createItem(data) {
         this._checkDeleted();
         // Get necessary configuration from Client
-        const token = this._sdk.getToken();
-        const spacerRunUrl = this._sdk.getSpacerRunUrl();
+        const token = this._client.getToken();
+        const spacerRunUrl = this._client.getSpacerRunUrl();
         if (data.type === ItemTypes.NOTEBOOK) {
             const requestData = {
                 spaceId: this.uid,
@@ -125,7 +125,7 @@ export class SpaceDTO {
                 throw new Error('Failed to create notebook: No notebook returned');
             }
             else {
-                return new NotebookDTO(response.notebook, this._sdk);
+                return new NotebookDTO(response.notebook, this._client);
             }
         }
         else if (data.type === ItemTypes.LEXICAL) {
@@ -141,7 +141,7 @@ export class SpaceDTO {
                 throw new Error('Failed to create lexical document: No document returned');
             }
             else {
-                return new LexicalDTO(response.document, this._sdk);
+                return new LexicalDTO(response.document, this._client);
             }
         }
         else {
@@ -155,11 +155,11 @@ export class SpaceDTO {
      */
     async getItems() {
         this._checkDeleted();
-        const token = this._sdk.getToken();
-        const spacerRunUrl = this._sdk.getSpacerRunUrl();
+        const token = this._client.getToken();
+        const spacerRunUrl = this._client.getSpacerRunUrl();
         const response = await items.getSpaceItems(token, this.uid, spacerRunUrl);
         // Use shared utility function to convert items to model instances
-        this._items = convertSpaceItemsToModels(response.items || [], this._sdk);
+        this._items = convertSpaceItemsToModels(response.items || [], this._client);
         return this._items;
     }
     /**
@@ -215,7 +215,7 @@ export class SpaceDTO {
             variant: this.variant,
             handle: this.handle,
             items: this._data.items
-                ? convertSpaceItemsToModels(this._data.items, this._sdk).map(item => item.toJSON())
+                ? convertSpaceItemsToModels(this._data.items, this._client).map(item => item.toJSON())
                 : [],
         };
         validateJSON(obj, 'Space');

package/lib/models/UserDTO.d.ts

@@ -54,9 +54,9 @@ export declare class UserDTO {
      * Create a User instance.
      *
      * @param data - User data from API
-     * @param sdk - Client instance (currently unused but kept for compatibility)
+     * @param client - Client instance (currently unused but kept for compatibility)
      */
-    constructor(data: UserData, sdk?: DatalayerClient);
+    constructor(data: UserData, client?: DatalayerClient);
     get id(): string;
     get uid(): string;
     get email(): string;

package/lib/models/UserDTO.js

@@ -13,9 +13,9 @@ export class UserDTO {
      * Create a User instance.
      *
      * @param data - User data from API
-     * @param sdk - Client instance (currently unused but kept for compatibility)
+     * @param client - Client instance (currently unused but kept for compatibility)
      */
-    constructor(data, sdk) {
+    constructor(data, client) {
         this._data = data;
     }
     // Basic properties

package/lib/theme/DatalayerTheme.js

@@ -74,9 +74,9 @@ const datalayerThemeDefs = {
                         hoverBg: datalayerColors.greenHover,
                         hoverBorder: datalayerColors.greenHover,
                         selectedBg: datalayerColors.greenHover,
-                        disabledText: 'rgba(255, 255, 255, 0.7)',
-                        disabledBg: datalayerColors.gray,
-                        disabledBorder: datalayerColors.gray,
+                        disabledText: 'rgba(255, 255, 255, 0.8)',
+                        disabledBg: '#94C9B9',
+                        disabledBorder: '#94C9B9',
                         icon: datalayerColors.white,
                         counterBg: 'rgba(0, 0, 0, 0.2)',
                     },
@@ -165,8 +165,8 @@ const datalayerThemeDefs = {
                         hoverBorder: 'rgba(240, 246, 252, 0.1)',
                         selectedBg: datalayerColors.greenBright,
                         disabledText: 'rgba(255, 255, 255, 0.5)',
-                        disabledBg: 'rgba(22, 160, 133, 0.6)',
-                        disabledBorder: 'rgba(240, 246, 252, 0.1)',
+                        disabledBg: 'rgba(22, 160, 133, 0.35)',
+                        disabledBorder: 'rgba(22, 160, 133, 0.2)',
                         icon: datalayerColors.white,
                         counterBg: 'rgba(0, 0, 0, 0.2)',
                     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datalayer/core",
-  "version": "0.0.27",
+  "version": "1.0.1",
   "type": "module",
   "workspaces": [
     ".",