@datalayer/core 1.0.1 → 1.0.2

package/lib/hooks/useProjects.js

@@ -0,0 +1,166 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * Hook for fetching and managing projects.
+ *
+ * Projects are backed by the Spacer service as spaces with type_s="project".
+ * Projects persist forever — only agents can terminate.
+ *
+ * Free tier limits: max 3 projects per user.
+ *
+ * @module hooks/useProjects
+ */
+import { useMemo, useCallback } from 'react';
+import { useCache } from './useCache';
+/** The space type value used to identify project spaces in Solr */
+export const PROJECT_SPACE_VARIANT = 'project';
+/**
+ * Hook to fetch user's projects (spaces with type "project").
+ *
+ * Uses the spacer service's spaces endpoint filtered by type.
+ */
+export function useProjects() {
+    const { useUserSpaces } = useCache();
+    const { data: allSpaces, ...rest } = useUserSpaces();
+    // Filter to only project-type spaces
+    const projects = useMemo(() => {
+        if (!allSpaces)
+            return [];
+        return allSpaces
+            .filter((space) => space.variant === PROJECT_SPACE_VARIANT ||
+            space.type_s === PROJECT_SPACE_VARIANT)
+            .map((space) => ({
+            uid: space.uid,
+            id: space.id ?? space.uid,
+            handle: space.handle ?? space.handle_s,
+            name: space.name ?? space.name_t,
+            description: space.description ?? space.description_t ?? '',
+            createdAt: space.created_at ? new Date(space.created_at) : new Date(),
+            isPublic: space.public ?? space.public_b ?? false,
+            attachedAgentPodName: space.attached_agent_pod_name_s || undefined,
+            attachedAgentSpecId: space.attached_agent_spec_id_s || undefined,
+        }));
+    }, [allSpaces]);
+    return { data: projects, ...rest };
+}
+/**
+ * Hook to fetch a single project by UID.
+ */
+export function useProject(uid) {
+    const { useSpace } = useCache();
+    // useSpace requires a string – pass empty string when uid is undefined
+    // (the query is disabled when spaceId is falsy inside useCache)
+    const { data: space, ...rest } = useSpace(uid ?? '');
+    const project = useMemo(() => {
+        if (!space)
+            return undefined;
+        const s = space;
+        return {
+            uid: s.uid,
+            id: s.id ?? s.uid,
+            handle: s.handle ?? s.handle_s,
+            name: s.name ?? s.name_t,
+            description: s.description ?? s.description_t ?? '',
+            createdAt: s.created_at ? new Date(s.created_at) : new Date(),
+            isPublic: s.public ?? s.public_b ?? false,
+            attachedAgentPodName: s.attached_agent_pod_name_s || undefined,
+            attachedAgentSpecId: s.attached_agent_spec_id_s || undefined,
+        };
+    }, [space]);
+    return { data: project, ...rest };
+}
+/**
+ * Hook to create a new project.
+ * Creates a space with type "project" via the spacer service.
+ */
+export function useCreateProject() {
+    const { useCreateSpace } = useCache();
+    const createSpaceMutation = useCreateSpace();
+    const createProject = useCallback(async (request) => {
+        const spaceHandle = request.name
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/^-|-$/g, '');
+        return createSpaceMutation.mutateAsync({
+            space: {
+                name: request.name,
+                description: request.description || '',
+                handle: spaceHandle || `project-${Date.now()}`,
+                variant: PROJECT_SPACE_VARIANT,
+                public: false,
+            },
+        });
+    }, [createSpaceMutation]);
+    return {
+        ...createSpaceMutation,
+        createProject,
+    };
+}
+/**
+ * Hook to update a project (e.g. persist the attached agent pod name).
+ * Uses the spacer PUT endpoint via useUpdateSpace.
+ */
+export function useUpdateProject() {
+    const { useUpdateSpace } = useCache();
+    const updateSpaceMutation = useUpdateSpace();
+    /** Assign an agent runtime to the project */
+    const assignAgent = useCallback(async (project, agentPodName, agentSpecId) => {
+        return updateSpaceMutation.mutateAsync({
+            id: project.id,
+            name: project.name,
+            description: project.description,
+            attached_agent_pod_name_s: agentPodName,
+            attached_agent_spec_id_s: agentSpecId || '',
+        });
+    }, [updateSpaceMutation]);
+    /** Rename a project */
+    const renameProject = useCallback(async (project, newName) => {
+        return updateSpaceMutation.mutateAsync({
+            id: project.id,
+            name: newName,
+            description: project.description,
+        });
+    }, [updateSpaceMutation]);
+    /** Remove the agent assignment from the project */
+    const unassignAgent = useCallback(async (project) => {
+        return updateSpaceMutation.mutateAsync({
+            id: project.id,
+            name: project.name,
+            description: project.description,
+            attached_agent_pod_name_s: '',
+            attached_agent_spec_id_s: '',
+        });
+    }, [updateSpaceMutation]);
+    return {
+        ...updateSpaceMutation,
+        assignAgent,
+        unassignAgent,
+        renameProject,
+    };
+}
+/**
+ * Hook to refresh the projects list.
+ */
+export function useRefreshProjects() {
+    const { useRefreshUserSpaces } = useCache();
+    return useRefreshUserSpaces();
+}
+/**
+ * Hook to delete a project (space) and all its contents.
+ */
+export function useDeleteProject() {
+    const { useDeleteSpace } = useCache();
+    return useDeleteSpace();
+}
+/**
+ * Hook to fetch the default notebook and document UIDs for a project.
+ *
+ * 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) {
+    const { useSpaceDefaultItems } = useCache();
+    return useSpaceDefaultItems(projectUid);
+}

package/lib/index.d.ts

@@ -5,7 +5,6 @@ export * from './collaboration';
 export * from './services';
 export * from './navigation';
 export * from './hooks';
-export * from './theme';
 export { requestDatalayerAPI, RunResponseError, NetworkError, } from './api/DatalayerApi';
 export type { IRequestDatalayerAPIOptions } from './api/DatalayerApi';
 export { API_BASE_PATHS } from './api/constants';

package/lib/index.js

@@ -11,8 +11,6 @@ export * from './services';
 // Export navigation before hooks to avoid conflicts
 export * from './navigation';
 export * from './hooks';
-// Export Theme.
-export * from './theme';
 // Export APIs.
 export { requestDatalayerAPI, RunResponseError, NetworkError, } from './api/DatalayerApi';
 export { API_BASE_PATHS } from './api/constants';

package/lib/models/Page.d.ts

@@ -31,6 +31,8 @@ export type IPage = {
     creatorId?: string;
     kernelSnapshot?: IRuntimeSnapshot;
     kernelSnapshotId?: string;
+    createdAt?: string;
+    updatedAt?: string;
 };
 export declare const asPage: (s: any) => IPage;
 export default IPage;

package/lib/views/iam-tokens/Tokens.js

@@ -48,6 +48,6 @@ const TokensTable = () => {
 };
 export const Tokens = () => {
     const navigate = useNavigate();
-    return (_jsxs(PageLayout, { containerWidth: "full", padding: "normal", style: { overflow: 'visible', minHeight: 'calc(100vh - 45px)' }, children: [_jsx(PageLayout.Header, { children: _jsxs(PageHeader, { children: [_jsx(PageHeader.TitleArea, { variant: "large", children: _jsx(PageHeader.Title, { children: "Tokens" }) }), _jsx(PageHeader.Actions, { children: _jsx(Button, { size: "small", variant: "primary", onClick: e => navigate('/new/token', e), children: "New token" }) })] }) }), _jsx(PageLayout.Content, { children: _jsx(Box, { children: _jsx(TokensTable, {}) }) })] }));
+    return (_jsxs(PageLayout, { containerWidth: "full", padding: "normal", style: { overflow: 'visible', minHeight: 'calc(100vh - 45px)' }, children: [_jsx(PageLayout.Header, { children: _jsxs(PageHeader, { children: [_jsx(PageHeader.TitleArea, { variant: "large", children: _jsx(PageHeader.Title, { children: "Tokens" }) }), _jsx(PageHeader.Actions, { children: _jsx(Button, { size: "small", variant: "primary", onClick: e => navigate('/tokens/new', e), children: "New token" }) })] }) }), _jsx(PageLayout.Content, { children: _jsx(Box, { children: _jsx(TokensTable, {}) }) })] }));
 };
 export default Tokens;

package/lib/views/secrets/Secrets.js

@@ -43,6 +43,6 @@ const SecretsTable = () => {
 };
 export const Secrets = () => {
     const navigate = useNavigate();
-    return (_jsxs(PageLayout, { containerWidth: "full", padding: "normal", style: { overflow: 'visible', minHeight: 'calc(100vh - 45px)' }, children: [_jsx(PageLayout.Header, { children: _jsxs(PageHeader, { children: [_jsx(PageHeader.TitleArea, { variant: "large", children: _jsx(PageHeader.Title, { children: "Secrets" }) }), _jsx(PageHeader.Actions, { children: _jsx(Button, { size: "small", variant: "primary", onClick: e => navigate('/new/secret', e), children: "New secret" }) })] }) }), _jsx(PageLayout.Content, { children: _jsx(Box, { children: _jsx(SecretsTable, {}) }) })] }));
+    return (_jsxs(PageLayout, { containerWidth: "full", padding: "normal", style: { overflow: 'visible', minHeight: 'calc(100vh - 45px)' }, children: [_jsx(PageLayout.Header, { children: _jsxs(PageHeader, { children: [_jsx(PageHeader.TitleArea, { variant: "large", children: _jsx(PageHeader.Title, { children: "Secrets" }) }), _jsx(PageHeader.Actions, { children: _jsx(Button, { size: "small", variant: "primary", onClick: e => navigate('/secrets/new', e), children: "New secret" }) })] }) }), _jsx(PageLayout.Content, { children: _jsx(Box, { children: _jsx(SecretsTable, {}) }) })] }));
 };
 export default Secrets;

package/package.json

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

package/lib/api/spacer/agentSpaces.d.ts

@@ -1,193 +0,0 @@
-/**
- * MCP Server tool configuration
- */
-export interface MCPServerTool {
-    name: string;
-    description: string;
-    enabled: boolean;
-}
-/**
- * MCP Server configuration
- */
-export interface MCPServer {
-    id: string;
-    name: string;
-    url?: string;
-    enabled: boolean;
-    tools: MCPServerTool[];
-    command?: string;
-    args: string[];
-    isAvailable: boolean;
-    transport: 'stdio' | 'http';
-}
-/**
- * Agent skill configuration
- */
-export interface AgentSkill {
-    id: string;
-    name: string;
-    description: string;
-    version: string;
-    tags: string[];
-    enabled: boolean;
-}
-/**
- * Agent specification model
- */
-export interface AgentSpec {
-    id: string;
-    name: string;
-    description: string;
-    tags: string[];
-    enabled: boolean;
-    mcpServers: MCPServer[];
-    skills: AgentSkill[];
-    environmentName: string;
-    icon?: string;
-    color?: string;
-    /** Chat suggestions to show users what this agent can do */
-    suggestions?: string[];
-}
-/**
- * Agent space status
- */
-export type AgentSpaceStatus = 'starting' | 'running' | 'paused' | 'terminated' | 'archived';
-/**
- * Agent space data
- */
-export interface AgentSpaceData {
-    id: string;
-    name: string;
-    description: string;
-    status: AgentSpaceStatus;
-    isPublic: boolean;
-    tags: string[];
-    messageCount: number;
-    createdAt?: string;
-    updatedAt?: string;
-    thumbnail?: string;
-    lastMessage?: string;
-    author?: string;
-    avatarUrl?: string;
-    stars?: number;
-    podName?: string;
-    runtimeUrl?: string;
-    creatorUid?: string;
-    creatorHandle?: string;
-    agentSpec?: AgentSpec;
-}
-/**
- * Request to create an agent space
- */
-export interface CreateAgentSpaceRequest {
-    /** Name of the agent space */
-    name: string;
-    /** Parent space ID */
-    spaceId: string;
-    /** Description */
-    description?: string;
-    /** Tags for categorization */
-    tags?: string[];
-    /** Initial status */
-    status?: AgentSpaceStatus;
-    /** Whether publicly visible */
-    isPublic?: boolean;
-    /** Agent specification */
-    agentSpec?: AgentSpec;
-    /** Thumbnail URL */
-    thumbnail?: string;
-}
-/**
- * Request to update an agent space
- */
-export interface UpdateAgentSpaceRequest {
-    name?: string;
-    description?: string;
-    tags?: string[];
-    status?: AgentSpaceStatus;
-    isPublic?: boolean;
-    agentSpec?: AgentSpec;
-    podName?: string;
-    runtimeUrl?: string;
-    messageCount?: number;
-    lastMessage?: string;
-    thumbnail?: string;
-}
-/**
- * Response for single agent space operations
- */
-export interface AgentSpaceResponse {
-    success: boolean;
-    message: string;
-    agentSpace?: AgentSpaceData;
-}
-/**
- * Response for listing agent spaces
- */
-export interface AgentSpacesResponse {
-    success: boolean;
-    message: string;
-    agentSpaces?: AgentSpaceData[];
-}
-/**
- * Create a new agent space.
- * @param token - Authentication token
- * @param data - Agent space creation configuration
- * @param baseUrl - Base URL for the API (defaults to production)
- * @returns Promise resolving to the created agent space response
- */
-export declare const createAgentSpace: (token: string, data: CreateAgentSpaceRequest, baseUrl?: string) => Promise<AgentSpaceResponse>;
-/**
- * List agent spaces for the current user.
- * @param token - Authentication token
- * @param baseUrl - Base URL for the API (defaults to production)
- * @returns Promise resolving to the list of agent spaces
- */
-export declare const listAgentSpaces: (token: string, baseUrl?: string) => Promise<AgentSpacesResponse>;
-/**
- * List all public agent spaces (Library).
- * @param baseUrl - Base URL for the API (defaults to production)
- * @returns Promise resolving to the list of public agent spaces
- */
-export declare const listPublicAgentSpaces: (baseUrl?: string) => Promise<AgentSpacesResponse>;
-/**
- * Get an agent space by UID.
- * @param token - Authentication token
- * @param uid - The agent space UID
- * @param baseUrl - Base URL for the API (defaults to production)
- * @returns Promise resolving to the agent space
- */
-export declare const getAgentSpace: (token: string, uid: string, baseUrl?: string) => Promise<AgentSpaceResponse>;
-/**
- * Update an agent space.
- * @param token - Authentication token
- * @param uid - The agent space UID
- * @param data - Update data
- * @param baseUrl - Base URL for the API (defaults to production)
- * @returns Promise resolving to the updated agent space
- */
-export declare const updateAgentSpace: (token: string, uid: string, data: UpdateAgentSpaceRequest, baseUrl?: string) => Promise<AgentSpaceResponse>;
-/**
- * Delete an agent space.
- * @param token - Authentication token
- * @param uid - The agent space UID
- * @param baseUrl - Base URL for the API (defaults to production)
- * @returns Promise resolving when deleted
- */
-export declare const deleteAgentSpace: (token: string, uid: string, baseUrl?: string) => Promise<void>;
-/**
- * Make an agent space public (add to Library).
- * @param token - Authentication token
- * @param uid - The agent space UID
- * @param baseUrl - Base URL for the API (defaults to production)
- * @returns Promise resolving to the updated agent space
- */
-export declare const makeAgentSpacePublic: (token: string, uid: string, baseUrl?: string) => Promise<AgentSpaceResponse>;
-/**
- * Make an agent space private (remove from Library).
- * @param token - Authentication token
- * @param uid - The agent space UID
- * @param baseUrl - Base URL for the API (defaults to production)
- * @returns Promise resolving to the updated agent space
- */
-export declare const makeAgentSpacePrivate: (token: string, uid: string, baseUrl?: string) => Promise<AgentSpaceResponse>;

package/lib/api/spacer/agentSpaces.js

@@ -1,127 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-/**
- * Agent Spaces API functions for the Datalayer platform.
- *
- * Provides functions for creating, listing, updating, and deleting agent spaces.
- *
- * @module api/spacer/agent-spaces
- */
-import { requestDatalayerAPI } from '../DatalayerApi';
-import { API_BASE_PATHS, DEFAULT_SERVICE_URLS } from '../constants';
-// =============================================================================
-// API Functions
-// =============================================================================
-/**
- * Create a new agent space.
- * @param token - Authentication token
- * @param data - Agent space creation configuration
- * @param baseUrl - Base URL for the API (defaults to production)
- * @returns Promise resolving to the created agent space response
- */
-export const createAgentSpace = async (token, data, baseUrl = DEFAULT_SERVICE_URLS.SPACER) => {
-    return requestDatalayerAPI({
-        url: `${baseUrl}${API_BASE_PATHS.SPACER}/agent-spaces`,
-        method: 'POST',
-        token,
-        body: data,
-    });
-};
-/**
- * List agent spaces for the current user.
- * @param token - Authentication token
- * @param baseUrl - Base URL for the API (defaults to production)
- * @returns Promise resolving to the list of agent spaces
- */
-export const listAgentSpaces = async (token, baseUrl = DEFAULT_SERVICE_URLS.SPACER) => {
-    return requestDatalayerAPI({
-        url: `${baseUrl}${API_BASE_PATHS.SPACER}/agent-spaces`,
-        method: 'GET',
-        token,
-    });
-};
-/**
- * List all public agent spaces (Library).
- * @param baseUrl - Base URL for the API (defaults to production)
- * @returns Promise resolving to the list of public agent spaces
- */
-export const listPublicAgentSpaces = async (baseUrl = DEFAULT_SERVICE_URLS.SPACER) => {
-    return requestDatalayerAPI({
-        url: `${baseUrl}${API_BASE_PATHS.SPACER}/agent-spaces/public`,
-        method: 'GET',
-    });
-};
-/**
- * Get an agent space by UID.
- * @param token - Authentication token
- * @param uid - The agent space UID
- * @param baseUrl - Base URL for the API (defaults to production)
- * @returns Promise resolving to the agent space
- */
-export const getAgentSpace = async (token, uid, baseUrl = DEFAULT_SERVICE_URLS.SPACER) => {
-    return requestDatalayerAPI({
-        url: `${baseUrl}${API_BASE_PATHS.SPACER}/agent-spaces/${uid}`,
-        method: 'GET',
-        token,
-    });
-};
-/**
- * Update an agent space.
- * @param token - Authentication token
- * @param uid - The agent space UID
- * @param data - Update data
- * @param baseUrl - Base URL for the API (defaults to production)
- * @returns Promise resolving to the updated agent space
- */
-export const updateAgentSpace = async (token, uid, data, baseUrl = DEFAULT_SERVICE_URLS.SPACER) => {
-    return requestDatalayerAPI({
-        url: `${baseUrl}${API_BASE_PATHS.SPACER}/agent-spaces/${uid}`,
-        method: 'PUT',
-        token,
-        body: data,
-    });
-};
-/**
- * Delete an agent space.
- * @param token - Authentication token
- * @param uid - The agent space UID
- * @param baseUrl - Base URL for the API (defaults to production)
- * @returns Promise resolving when deleted
- */
-export const deleteAgentSpace = async (token, uid, baseUrl = DEFAULT_SERVICE_URLS.SPACER) => {
-    await requestDatalayerAPI({
-        url: `${baseUrl}${API_BASE_PATHS.SPACER}/agent-spaces/${uid}`,
-        method: 'DELETE',
-        token,
-    });
-};
-/**
- * Make an agent space public (add to Library).
- * @param token - Authentication token
- * @param uid - The agent space UID
- * @param baseUrl - Base URL for the API (defaults to production)
- * @returns Promise resolving to the updated agent space
- */
-export const makeAgentSpacePublic = async (token, uid, baseUrl = DEFAULT_SERVICE_URLS.SPACER) => {
-    return requestDatalayerAPI({
-        url: `${baseUrl}${API_BASE_PATHS.SPACER}/agent-spaces/${uid}/public`,
-        method: 'POST',
-        token,
-    });
-};
-/**
- * Make an agent space private (remove from Library).
- * @param token - Authentication token
- * @param uid - The agent space UID
- * @param baseUrl - Base URL for the API (defaults to production)
- * @returns Promise resolving to the updated agent space
- */
-export const makeAgentSpacePrivate = async (token, uid, baseUrl = DEFAULT_SERVICE_URLS.SPACER) => {
-    return requestDatalayerAPI({
-        url: `${baseUrl}${API_BASE_PATHS.SPACER}/agent-spaces/${uid}/private`,
-        method: 'POST',
-        token,
-    });
-};

package/lib/theme/DatalayerTheme.d.ts

@@ -1,52 +0,0 @@
-/**
- * Datalayer Accessible Color System
- * Based on Datalayer's brand manual - WCAG AA/AAA compliant
- */
-export declare const datalayerColors: {
-    black: string;
-    gray: string;
-    white: string;
-    greenBrand: string;
-    greenAccent: string;
-    greenText: string;
-    greenTint: string;
-    greenBright: string;
-    greenHover: string;
-};
-export declare const datalayerTheme: {
-    animation: {
-        easeOutCubic: string;
-    };
-    borderWidths: (string | number)[];
-    breakpoints: string[];
-    fonts: {
-        normal: any;
-        mono: string;
-    };
-    fontSizes: string[];
-    fontWeights: {
-        light: number;
-        normal: number;
-        semibold: number;
-        bold: number;
-    };
-    lineHeights: {
-        condensedUltra: number;
-        condensed: number;
-        default: number;
-    };
-    radii: string[];
-    sizes: {
-        small: string;
-        medium: string;
-        large: string;
-        xlarge: string;
-    };
-    space: string[];
-} & {
-    colorSchemes: {
-        light: {};
-        dark: {};
-    };
-};
-export default datalayerTheme;