@datalayer/core 0.0.27 → 1.0.2

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/api/spacer/index.d.ts

@@ -2,11 +2,10 @@
  * Spacer API exports.
  *
  * Provides organized access to spacer functionality including
- * spaces, notebooks, cells, lexical documents, and agent spaces.
+ * spaces, notebooks, cells, lexical documents, and agent runtimes.
  *
  * @module api/spacer
  */
-export * as agentSpaces from './agentSpaces';
 export * as documents from './documents';
 export * as healthz from './healthz';
 export * as items from './items';

package/lib/api/spacer/index.js

@@ -6,11 +6,10 @@
  * Spacer API exports.
  *
  * Provides organized access to spacer functionality including
- * spaces, notebooks, cells, lexical documents, and agent spaces.
+ * spaces, notebooks, cells, lexical documents, and agent runtimes.
  *
  * @module api/spacer
  */
-export * as agentSpaces from './agentSpaces';
 export * as documents from './documents';
 export * as healthz from './healthz';
 export * as items from './items';

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/avatars/BoringAvatar.d.ts

@@ -5,6 +5,8 @@ type IBoringAvatarProps = {
     size?: number;
     square?: boolean;
     style?: object;
+    /** Custom color palette passed to boring-avatars. When omitted the default Datalayer palette is used. */
+    colors?: string[];
 };
-export declare const BoringAvatar: ({ displayName, variant, size, square, style, }: IBoringAvatarProps) => import("react/jsx-runtime").JSX.Element;
+export declare const BoringAvatar: ({ displayName, variant, size, square, style, colors, }: IBoringAvatarProps) => import("react/jsx-runtime").JSX.Element;
 export default BoringAvatar;

package/lib/components/avatars/BoringAvatar.js

@@ -7,23 +7,24 @@ import BoringAvatars from 'boring-avatars';
 // export const getRandomBoringAvatarVariant = () => VARIANTS[Math.floor(Math.random() * VARIANTS.length)] as VariantType;
 const getRandomBoringAvatarVariant = () => 'bauhaus';
 const RANDOM_BORING_AVATOR_VARIANT = getRandomBoringAvatarVariant();
-export const BoringAvatar = ({ displayName = '', variant, size = 40, square = false, style, }) => {
+const DEFAULT_COLORS = [
+    '#000000',
+    '#146A7C',
+    '#16A085',
+    '#1ABC9C',
+    '#2ECC71',
+    '#59595C',
+    '#92A1C6',
+    '#C20D90',
+    '#C271B4',
+    '#F0AB3D',
+];
+export const BoringAvatar = ({ displayName = '', variant, size = 40, square = false, style, colors, }) => {
     const resolvedVariant = variant ?? RANDOM_BORING_AVATOR_VARIANT;
     const safeName = String(displayName ?? '');
+    const resolvedColors = colors ?? DEFAULT_COLORS;
     try {
-        return (_jsx("span", { style: { ...(style || {}) }, children: _jsx(BoringAvatars, { size: size, name: safeName, variant: resolvedVariant, square: square, colors: [
-                    '#000000',
-                    '#146A7C',
-                    '#16A085',
-                    '#1ABC9C',
-                    '#2ECC71',
-                    '#59595C',
-                    '#92A1C6',
-                    '#C20D90',
-                    '#C271B4',
-                    '#F0AB3D',
-                    //      '#FFFFFF',
-                ] }) }));
+        return (_jsx("span", { style: { ...(style || {}) }, children: _jsx(BoringAvatars, { size: size, name: safeName, variant: resolvedVariant, square: square, colors: resolvedColors }) }));
     }
     catch (error) {
         console.error('BoringAvatar error:', error);

package/lib/components/avatars/BoringAvatar.stories.d.ts

@@ -1,12 +1,13 @@
 import type { StoryObj } from '@storybook/react-vite';
 declare const meta: {
     title: string;
-    component: ({ displayName, variant, size, square, style, }: {
+    component: ({ displayName, variant, size, square, style, colors, }: {
         displayName?: string;
         variant?: "marble" | "beam" | "pixel" | "sunset" | "ring" | "bauhaus" | undefined;
         size?: number;
         square?: boolean;
         style?: object;
+        colors?: string[];
     }) => import("react/jsx-runtime").JSX.Element;
     tags: string[];
     parameters: {

package/lib/components/storage/ContentsBrowser.d.ts

@@ -1,3 +1,4 @@
+import { type ReactNode } from 'react';
 import { DocumentRegistry } from '@jupyterlab/docregistry';
 import { Contents } from '@jupyterlab/services';
 /**
@@ -24,6 +25,11 @@ export interface IContentsBrowserProps {
      * Document registry.
      */
     documentRegistry?: DocumentRegistry;
+    /**
+     * Optional title for the browser heading.
+     * Defaults to "Contents Browser".
+     */
+    title?: ReactNode;
 }
 /**
  * Storage browser component.

package/lib/components/storage/ContentsBrowser.js

@@ -3,7 +3,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import { useCallback, useEffect, useState } from 'react';
+import { useCallback, useEffect, useState, } from 'react';
 import { PathExt } from '@jupyterlab/coreutils';
 import { PromiseDelegate } from '@lumino/coreutils';
 import { ActionList, ActionMenu, Heading, IconButton, Spinner, TreeView, } from '@primer/react';
@@ -26,7 +26,11 @@ export const CHUNK_SIZE = 1024 * 1024;
  * Storage browser component.
  */
 export function ContentsBrowser(props) {
-    const { contents, localContents, documentRegistry } = props;
+    const { contents, localContents, documentRegistry, title = (_jsx(Heading, { as: "h4", sx: {
+            fontSize: 'var(--text-title-size-small)',
+            lineHeight: 'var(--text-title-lineHeight-medium)',
+            fontWeight: 'var(--text-title-weight-medium)',
+        }, children: "Contents Browser" })), } = props;
     const isMounted = useIsMounted();
     const { trackAsyncTask } = useToast();
     const [children, setChildren] = useState(null);
@@ -205,12 +209,7 @@ export function ContentsBrowser(props) {
     const onSelect = useCallback((item, refresh) => {
         setSelectedItem(item.path === selectedItem?.path ? null : { ...item, refresh });
     }, [selectedItem]);
-    return (_jsxs(Box, { sx: { display: 'grid', gridTemplateAreas: `"header" "content"` }, children: [_jsxs(Box, { sx: { gridArea: 'header', display: 'flex', alignItems: 'center' }, children: [_jsx(Heading, { as: "h4", sx: {
-                            fontSize: 'var(--text-title-size-small)',
-                            lineHeight: 'var(--text-title-lineHeight-medium)',
-                            fontWeight: 'var(--text-title-weight-medium)',
-                            flex: '1 1 auto',
-                        }, children: "Contents Browser" }), _jsxs(Box, { children: [_jsx(IconButton, { variant: "invisible", "aria-label": 'Refresh contents browser.', title: 'Refresh contents browser.', icon: CounterClockWiseIcon, onClick: refresh }), _jsx(UploadIconButton, { label: 'Upload a file', multiple: true, upload: upload })] })] }), isLoading ? (_jsx(Box, { sx: {
+    return (_jsxs(Box, { sx: { display: 'grid', gridTemplateAreas: `"header" "content"` }, children: [_jsxs(Box, { sx: { gridArea: 'header', display: 'flex', alignItems: 'center' }, children: [_jsx(Box, { sx: { flex: '1 1 auto' }, children: title }), _jsxs(Box, { children: [_jsx(IconButton, { variant: "invisible", "aria-label": 'Refresh contents browser.', title: 'Refresh contents browser.', icon: CounterClockWiseIcon, onClick: refresh }), _jsx(UploadIconButton, { label: 'Upload a file', multiple: true, upload: upload })] })] }), isLoading ? (_jsx(Box, { sx: {
                     gridArea: 'content',
                     display: 'flex',
                     alignItems: 'center',
@@ -221,9 +220,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/index.d.ts

@@ -23,5 +23,7 @@ export * from './useScreencapture';
 export * from './useToast';
 export * from './useUpload';
 export * from './useUser';
+export * from './useProjects';
+export * from './useProjectStore';
 export * from './useVisibilityObserver';
 export * from './useWindowSize';

package/lib/hooks/index.js

@@ -28,5 +28,7 @@ export * from './useScreencapture';
 export * from './useToast';
 export * from './useUpload';
 export * from './useUser';
+export * from './useProjects';
+export * from './useProjectStore';
 export * from './useVisibilityObserver';
 export * from './useWindowSize';

package/lib/hooks/useCache.d.ts

@@ -36,7 +36,6 @@
  */
 import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
 import { IAnyOrganization, IAnySpace, IAssignment, ICell, IContact, ICourse, IDataset, IDatasource, IDocument, IEnvironment, IExercise, IIAMToken, ILesson, INotebook, IOrganization, IPage, ISchool, ISecret, ITeam, IUser, IUserOnboarding, IUserSettings } from '../models';
-import type { AgentSpaceData, CreateAgentSpaceRequest, UpdateAgentSpaceRequest } from '../api/spacer/agentSpaces';
 export type CacheProps = {
     loginRoute?: string;
 };
@@ -213,13 +212,6 @@ export declare const queryKeys: {
         readonly bySpace: (spaceId: string) => readonly ["items", "space", string];
         readonly search: (opts: ISearchOpts) => readonly ["items", "search", ISearchOpts];
     };
-    readonly agentSpaces: {
-        readonly all: () => readonly ["agentSpaces"];
-        readonly lists: () => readonly ["agentSpaces", "list"];
-        readonly details: () => readonly ["agentSpaces", "detail"];
-        readonly detail: (id: string) => readonly ["agentSpaces", "detail", string];
-        readonly public: () => readonly ["agentSpaces", "public"];
-    };
     readonly agentRuntimes: {
         readonly all: () => readonly ["agentRuntimes"];
         readonly lists: () => readonly ["agentRuntimes", "list"];
@@ -451,7 +443,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;
@@ -487,26 +480,13 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
         spaceHandle?: string;
     }, unknown>;
     useExportSpace: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
-    useAgentSpace: (uid: string | undefined) => import("@tanstack/react-query").UseQueryResult<AgentSpaceData, Error>;
-    useAgentSpaces: () => import("@tanstack/react-query").UseQueryResult<AgentSpaceData[], Error>;
-    usePublicAgentSpaces: () => import("@tanstack/react-query").UseQueryResult<AgentSpaceData[], Error>;
-    useCreateAgentSpace: () => import("@tanstack/react-query").UseMutationResult<any, Error, CreateAgentSpaceRequest, unknown>;
-    useUpdateAgentSpace: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
-        uid: string;
-        data: UpdateAgentSpaceRequest;
-    }, unknown>;
-    useDeleteAgentSpace: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
-    useMakeAgentSpacePublic: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
-    useMakeAgentSpacePrivate: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
-    useRefreshAgentSpace: () => (uid: string) => void;
-    useRefreshAgentSpaces: () => () => void;
-    useRefreshPublicAgentSpaces: () => () => void;
     useAgentRuntime: (podName: string | undefined) => import("@tanstack/react-query").UseQueryResult<{
         status: "running" | "paused" | "starting" | "terminated" | "archived";
         name: string;
         id: string;
         url: string | undefined;
         messageCount: number;
+        agent_spec_id: string | undefined;
         pod_name: string;
         environment_name: string;
         environment_title?: string;
@@ -518,7 +498,7 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
         burning_rate?: number;
         ingress?: string;
         token?: string;
-        agentSpec?: AgentSpaceData["agentSpec"];
+        agentSpec?: any;
     }, Error>;
     useAgentRuntimes: () => import("@tanstack/react-query").UseQueryResult<{
         status: "running" | "paused" | "starting" | "terminated" | "archived";
@@ -526,6 +506,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;
@@ -537,7 +518,7 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
         burning_rate?: number;
         ingress?: string;
         token?: string;
-        agentSpec?: AgentSpaceData["agentSpec"];
+        agentSpec?: any;
     }[], Error>;
     useCreateAgentRuntime: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
         environmentName?: string;
@@ -546,6 +527,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 +694,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, {
@@ -1028,13 +1014,6 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
             readonly bySpace: (spaceId: string) => readonly ["items", "space", string];
             readonly search: (opts: ISearchOpts) => readonly ["items", "search", ISearchOpts];
         };
-        readonly agentSpaces: {
-            readonly all: () => readonly ["agentSpaces"];
-            readonly lists: () => readonly ["agentSpaces", "list"];
-            readonly details: () => readonly ["agentSpaces", "detail"];
-            readonly detail: (id: string) => readonly ["agentSpaces", "detail", string];
-            readonly public: () => readonly ["agentSpaces", "public"];
-        };
         readonly agentRuntimes: {
             readonly all: () => readonly ["agentRuntimes"];
             readonly lists: () => readonly ["agentRuntimes", "list"];