@datalayer/core 0.0.26 → 1.0.1

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,10 +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,
                     },
                 });
             },
@@ -1690,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({
@@ -1710,10 +1746,21 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                     method: 'DELETE',
                 });
             },
-            onSuccess: () => {
-                // Invalidate all agent runtime queries
+            onSuccess: (_data, podName) => {
+                // Cancel any in-flight queries for the deleted runtime so they
+                // don't re-fetch a resource that no longer exists.
+                queryClient.cancelQueries({
+                    queryKey: queryKeys.agentRuntimes.detail(podName),
+                });
+                // Remove the detail cache entry immediately — prevents React
+                // Query from triggering a stale re-fetch while the component
+                // unmounts.
+                queryClient.removeQueries({
+                    queryKey: queryKeys.agentRuntimes.detail(podName),
+                });
+                // Invalidate the list so the sidebar refreshes.
                 queryClient.invalidateQueries({
-                    queryKey: queryKeys.agentRuntimes.all(),
+                    queryKey: queryKeys.agentRuntimes.lists(),
                 });
             },
         });
@@ -3601,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
      */
@@ -5194,7 +5265,9 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                 if (!resp.success) {
                     throw new Error(resp.message || 'Failed to search public items');
                 }
-                return resp.items || [];
+                return (resp.items || [])
+                    .map((item) => toItem(item))
+                    .filter(Boolean);
             },
         });
     };
@@ -5219,6 +5292,23 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
             },
         });
     };
+    /**
+     * Get Google profile from access token
+     */
+    const useGetGoogleProfile = () => {
+        return useMutation({
+            mutationFn: async (accessToken) => {
+                const response = await fetch('https://openidconnect.googleapis.com/v1/userinfo', {
+                    method: 'GET',
+                    headers: {
+                        Accept: 'application/json',
+                        Authorization: `Bearer ${accessToken}`,
+                    },
+                });
+                return response.json();
+            },
+        });
+    };
     /**
      * Get LinkedIn profile via proxy
      */
@@ -5275,68 +5365,87 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
     const usePostLinkedinShareWithUpload = () => {
         return useMutation({
             mutationFn: async ({ linkedinUserUrn, postText, uploadObject, accessToken, }) => {
-                // Step 1: Register upload
-                const registerUploadRequest = {
-                    registerUploadRequest: {
-                        recipes: ['urn:li:digitalmediaRecipe:feedshare-image'],
-                        owner: linkedinUserUrn,
-                        serviceRelationships: [
-                            {
-                                relationshipType: 'OWNER',
-                                identifier: 'urn:li:userGeneratedContent',
-                            },
-                        ],
-                    },
-                };
-                const registerResp = await requestDatalayer({
-                    url: `${configuration.iamRunUrl}/api/iam/v1/proxy/request`,
-                    method: 'POST',
-                    body: {
-                        request_method: 'POST',
-                        request_url: 'https://api.linkedin.com/v2/assets?action=registerUpload',
-                        request_token: accessToken,
-                        request_body: registerUploadRequest,
-                    },
-                });
-                const asset = registerResp.response.value.asset;
-                const uploadUrl = registerResp.response.value.uploadMechanism['com.linkedin.digitalmedia.uploading.MediaUploadHttpRequest'].uploadUrl;
-                // Step 2: Upload image
-                await requestDatalayer({
-                    url: `${configuration.iamRunUrl}/api/iam/v1/proxy/request`,
-                    method: 'POST',
-                    body: {
-                        request_method: 'PUT',
-                        request_url: uploadUrl,
-                        request_token: accessToken,
-                        request_body: {
-                            uploadURL: uploadUrl,
-                            content: uploadObject,
-                            userURN: linkedinUserUrn,
-                        },
-                    },
-                });
-                // Step 3: Create share with media
-                const shareRequest = {
-                    author: linkedinUserUrn,
-                    lifecycleState: 'PUBLISHED',
-                    specificContent: {
-                        'com.linkedin.ugc.ShareContent': {
-                            shareCommentary: { text: postText },
-                            shareMediaCategory: 'IMAGE',
-                            media: [
+                let shareRequest;
+                if (uploadObject) {
+                    // Step 1: Register upload
+                    const registerUploadRequest = {
+                        registerUploadRequest: {
+                            recipes: ['urn:li:digitalmediaRecipe:feedshare-image'],
+                            owner: linkedinUserUrn,
+                            serviceRelationships: [
                                 {
-                                    status: 'READY',
-                                    description: { text: 'Datalayer Notebook' },
-                                    media: asset,
-                                    title: { text: 'Datalayer Notebook' },
+                                    relationshipType: 'OWNER',
+                                    identifier: 'urn:li:userGeneratedContent',
                                 },
                             ],
                         },
-                    },
-                    visibility: {
-                        'com.linkedin.ugc.MemberNetworkVisibility': 'PUBLIC',
-                    },
-                };
+                    };
+                    const registerResp = await requestDatalayer({
+                        url: `${configuration.iamRunUrl}/api/iam/v1/proxy/request`,
+                        method: 'POST',
+                        body: {
+                            request_method: 'POST',
+                            request_url: 'https://api.linkedin.com/v2/assets?action=registerUpload',
+                            request_token: accessToken,
+                            request_body: registerUploadRequest,
+                        },
+                    });
+                    const asset = registerResp.response.value.asset;
+                    const uploadUrl = registerResp.response.value.uploadMechanism['com.linkedin.digitalmedia.uploading.MediaUploadHttpRequest'].uploadUrl;
+                    // Step 2: Upload image
+                    await requestDatalayer({
+                        url: `${configuration.iamRunUrl}/api/iam/v1/proxy/request`,
+                        method: 'POST',
+                        body: {
+                            request_method: 'PUT',
+                            request_url: uploadUrl,
+                            request_token: accessToken,
+                            request_body: {
+                                uploadURL: uploadUrl,
+                                content: uploadObject,
+                                userURN: linkedinUserUrn,
+                            },
+                        },
+                    });
+                    // Step 3: Create share with media
+                    shareRequest = {
+                        author: linkedinUserUrn,
+                        lifecycleState: 'PUBLISHED',
+                        specificContent: {
+                            'com.linkedin.ugc.ShareContent': {
+                                shareCommentary: { text: postText },
+                                shareMediaCategory: 'IMAGE',
+                                media: [
+                                    {
+                                        status: 'READY',
+                                        description: { text: 'Datalayer Notebook' },
+                                        media: asset,
+                                        title: { text: 'Datalayer Notebook' },
+                                    },
+                                ],
+                            },
+                        },
+                        visibility: {
+                            'com.linkedin.ugc.MemberNetworkVisibility': 'PUBLIC',
+                        },
+                    };
+                }
+                else {
+                    // Text-only share (no image upload)
+                    shareRequest = {
+                        author: linkedinUserUrn,
+                        lifecycleState: 'PUBLISHED',
+                        specificContent: {
+                            'com.linkedin.ugc.ShareContent': {
+                                shareCommentary: { text: postText },
+                                shareMediaCategory: 'NONE',
+                            },
+                        },
+                        visibility: {
+                            'com.linkedin.ugc.MemberNetworkVisibility': 'PUBLIC',
+                        },
+                    };
+                }
                 return requestDatalayer({
                     url: `${configuration.iamRunUrl}/api/iam/v1/proxy/request`,
                     method: 'POST',
@@ -6353,6 +6462,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         useOAuth2AuthorizationURL,
         useOAuth2AuthorizationLinkURL,
         useGetGitHubProfile,
+        useGetGoogleProfile,
         useGetLinkedinProfile,
         usePostLinkedinShare,
         usePostLinkedinShareWithUpload,
@@ -6416,6 +6526,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         useUserSpaces,
         useCreateSpace,
         useUpdateSpace,
+        useDeleteSpace,
         useUpdateOrganizationSpace,
         useAddMemberToOrganizationSpace,
         useRemoveMemberFromOrganizationSpace,
@@ -6525,6 +6636,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         // Items (Generic)
         useDeleteItem,
         useSpaceItems,
+        useSpaceDefaultItems,
         useMakeItemPublic,
         useMakeItemPrivate,
         useSearchPublicItems,

package/lib/hooks/useCellOutputshot.js

@@ -4,13 +4,13 @@
  */
 import { useState } from 'react';
 import { useCellStore } from '../state';
-import { takeHTMLNodeScreenshot } from '../utils/Screenshot';
+import { takeHTMLNodeScreencapture } from '../utils/Screencapture';
 const useCellOutputshot = () => {
     const [outputshot, setOutputshot] = useState('');
     const [error, setError] = useState();
     const { update } = useCellStore();
     const takeOutputshot = (node) => {
-        takeHTMLNodeScreenshot(node)
+        takeHTMLNodeScreencapture(node)
             .then(outputshotData => {
             setOutputshot(outputshotData);
             update({

package/lib/hooks/useScreencapture.d.ts

@@ -0,0 +1,18 @@
+import { ReactNode } from 'react';
+export type ScreencaptureContextType = {
+    closeScreencapture: () => void;
+    displayScreencapture: (nextScreencapture: any) => void;
+};
+export declare const ScreencaptureContext: import("react").Context<ScreencaptureContextType>;
+export declare function useScreencapture(): ScreencaptureContextType;
+/**
+ * The type for the Screencapture context provider.
+ */
+export declare const ScreencaptureContextProvider: import("react").Provider<ScreencaptureContextType>;
+export type IScreencaptureProviderProps = {
+    children?: ReactNode;
+    zIndex?: number;
+    disableDarken?: boolean;
+    screenshotSurface?: (qfds: any) => JSX.Element;
+};
+export declare function ScreencaptureProvider({ children, zIndex, disableDarken, screenshotSurface, }: IScreencaptureProviderProps): import("react/jsx-runtime").JSX.Element;

package/lib/hooks/useScreencapture.js

@@ -0,0 +1,53 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+import { createContext, useState, useContext } from 'react';
+import { LayoutScreencapture } from './layouts';
+export const ScreencaptureContext = createContext({
+    closeScreencapture: () => { },
+    displayScreencapture: (nextScreencapture) => { },
+});
+export function useScreencapture() {
+    const context = useContext(ScreencaptureContext);
+    if (!context)
+        throw new Error('useContext must be inside a provider with a value.');
+    return context;
+}
+/**
+ * The type for the Screencapture context provider.
+ */
+export const ScreencaptureContextProvider = ScreencaptureContext.Provider;
+export function ScreencaptureProvider({ children = null, zIndex = 9999, disableDarken = false, screenshotSurface = undefined, }) {
+    const defaultScreencaptureSurface = {
+        position: 'fixed',
+        top: 0,
+        left: 0,
+        width: '100%',
+        height: '100%',
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+        backgroundColor: disableDarken ? 'initial' : 'rgba(0, 0, 0, 0.5)',
+        zIndex,
+    };
+    const [screenshot, setScreencapture] = useState({
+        open: false,
+        render: (closeScreencapture) => _jsx(_Fragment, {}),
+    });
+    const displayScreencapture = (nextScreencapture) => {
+        setScreencapture({
+            open: true,
+            render: nextScreencapture,
+        });
+    };
+    const closeScreencapture = () => {
+        setScreencapture({
+            open: false,
+            render: (closeScreencapture) => _jsx(_Fragment, {}),
+        });
+    };
+    return (_jsxs(ScreencaptureContextProvider, { value: { closeScreencapture, displayScreencapture }, children: [_jsx(LayoutScreencapture, {}), children, screenshot.open &&
+                (screenshotSurface ? (screenshotSurface(screenshot.render(closeScreencapture))) : (_jsx("div", { style: defaultScreencaptureSurface, children: screenshot.render(closeScreencapture) })))] }));
+}

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

@@ -24,6 +24,17 @@ export type ILinkedInUser = {
     picture: string;
     getUrn(): string;
 };
+export type IGoogleUser = {
+    iamProvider: IIAMProviderName;
+    sub: string;
+    email_verified: boolean;
+    name: string;
+    given_name: string;
+    family_name: string;
+    email: string;
+    picture: string;
+    locale: string;
+};
 export type IXUser = {
     iamProvider: IIAMProviderName;
     sub: string;

package/lib/models/IAMProvidersSpecs.d.ts

@@ -1,5 +1,5 @@
 import { IUser } from './User';
-export type IIAMProviderName = 'bluesky' | 'discord' | 'github' | 'linkedin' | 'okta' | 'x';
+export type IIAMProviderName = 'bluesky' | 'discord' | 'github' | 'google' | 'linkedin' | 'okta' | 'x';
 export type IIAMProviderSpec = {
     name: IIAMProviderName;
     oauth2CallbackServerRoute: string;
@@ -16,6 +16,7 @@ export declare class IAMProvidersSpecs {
     static getProvider(providerIAMProvidersType: any): IIAMProviderSpec;
     static readonly Bluesky: IIAMProviderSpec;
     static readonly GitHub: IIAMProviderSpec;
+    static readonly Google: IIAMProviderSpec;
     static readonly LinkedIn: IIAMProviderSpec;
     static readonly Okta: IIAMProviderSpec;
 }