@datalayer/core 1.0.24 → 1.1.41

package/lib/services/DatalayerServiceManager.js

@@ -1,69 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { ServerConnection, ServiceManager } from '@jupyterlab/services';
-import { coreStore } from '../state/substates/CoreState.js';
-import { DEFAULT_DATALAYER_CONFIG } from '../config/Configuration.js';
-import { createRuntime } from '../stateful/runtimes/actions.js';
-/**
- * Creates a ServiceManager configured for Datalayer.
- *
- * This function requests a new kernel from Datalayer's platform and
- * returns a configured ServiceManager that connects to the allocated
- * Jupyter server instance.
- *
- * @param environmentName - The name of the Datalayer environment to use
- * @param credits - The credit limit for this kernel session
- * @returns A configured ServiceManager instance
- * @throws Error if the kernel request fails or configuration is missing
- *
- * @example
- * ```typescript
- * const serviceManager = await createDatalayerServiceManager('ai-agents-env', 100);
- * await serviceManager.ready;
- * // Use the service manager with notebooks
- * ```
- */
-export const createDatalayerServiceManager = async (environmentName, credits) => {
-    const { configuration } = coreStore.getState();
-    const token = configuration?.token || '';
-    // Use provided values or fall back to config or defaults
-    const actualEnvironmentName = environmentName ||
-        configuration?.cpuEnvironment ||
-        DEFAULT_DATALAYER_CONFIG.cpuEnvironment;
-    const actualCredits = credits ?? configuration?.credits ?? DEFAULT_DATALAYER_CONFIG.credits;
-    if (!token) {
-        throw new Error('Datalayer API token is required to create a service manager');
-    }
-    try {
-        // Use the existing createRuntime function which handles auth properly
-        const runtime = await createRuntime({
-            environmentName: actualEnvironmentName,
-            type: 'notebook',
-            givenName: `Jupyter React Kernel - ${new Date().toISOString()}`,
-            creditsLimit: actualCredits,
-            capabilities: [],
-        });
-        const serverSettings = ServerConnection.makeSettings({
-            baseUrl: runtime.ingress,
-            wsUrl: runtime.ingress.replace(/^http/, 'ws'),
-            token: runtime.token,
-            appendToken: true,
-        });
-        const serviceManager = new ServiceManager({ serverSettings });
-        console.log('Created Datalayer service manager:', {
-            environmentName: actualEnvironmentName,
-            credits: actualCredits,
-            reservationId: runtime.reservation_id,
-            podName: runtime.pod_name,
-            ingress: runtime.ingress,
-        });
-        return serviceManager;
-    }
-    catch (error) {
-        console.error('Error creating Datalayer service manager:', error);
-        throw error;
-    }
-};
-export default createDatalayerServiceManager;

package/lib/services/index.d.ts

@@ -1,4 +0,0 @@
-export { createDatalayerServiceManager } from './DatalayerServiceManager';
-export { reconnectToRuntime } from './reconnectToRuntime';
-export type { RuntimeInfo } from './reconnectToRuntime';
-export { default as DatalayerServiceManager } from './DatalayerServiceManager';

package/lib/services/index.js

@@ -1,7 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-export { createDatalayerServiceManager } from './DatalayerServiceManager.js';
-export { reconnectToRuntime } from './reconnectToRuntime.js';
-export { default as DatalayerServiceManager } from './DatalayerServiceManager.js';

package/lib/services/reconnectToRuntime.d.ts

@@ -1,32 +0,0 @@
-import { ServiceManager } from '@jupyterlab/services';
-export interface RuntimeInfo {
-    runtimeId: string;
-    podName: string;
-    ingress: string;
-    token: string;
-    environmentName?: string;
-}
-/**
- * Reconnects to an existing Datalayer runtime
- *
- * This function creates a ServiceManager that connects to an already
- * allocated Jupyter server instance using stored runtime information.
- *
- * @param runtimeInfo - The stored runtime information
- * @returns A configured ServiceManager instance
- * @throws Error if the reconnection fails
- *
- * @example
- * ```typescript
- * const runtimeInfo = {
- *   runtimeId: 'abc123',
- *   podName: 'jupyter-pod-xyz',
- *   ingress: 'https://jupyter.example.com',
- *   token: 'secret-token'
- * };
- * const serviceManager = await reconnectToRuntime(runtimeInfo);
- * await serviceManager.ready;
- * ```
- */
-export declare const reconnectToRuntime: (runtimeInfo: RuntimeInfo) => Promise<ServiceManager.IManager>;
-export default reconnectToRuntime;

package/lib/services/reconnectToRuntime.js

@@ -1,59 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { ServerConnection, ServiceManager } from '@jupyterlab/services';
-/**
- * Reconnects to an existing Datalayer runtime
- *
- * This function creates a ServiceManager that connects to an already
- * allocated Jupyter server instance using stored runtime information.
- *
- * @param runtimeInfo - The stored runtime information
- * @returns A configured ServiceManager instance
- * @throws Error if the reconnection fails
- *
- * @example
- * ```typescript
- * const runtimeInfo = {
- *   runtimeId: 'abc123',
- *   podName: 'jupyter-pod-xyz',
- *   ingress: 'https://jupyter.example.com',
- *   token: 'secret-token'
- * };
- * const serviceManager = await reconnectToRuntime(runtimeInfo);
- * await serviceManager.ready;
- * ```
- */
-export const reconnectToRuntime = async (runtimeInfo) => {
-    try {
-        const serverSettings = ServerConnection.makeSettings({
-            baseUrl: runtimeInfo.ingress,
-            wsUrl: runtimeInfo.ingress.replace(/^http/, 'ws'),
-            token: runtimeInfo.token,
-            appendToken: true,
-        });
-        const serviceManager = new ServiceManager({ serverSettings });
-        // Store runtime info on the serviceManager instance for access
-        serviceManager.__datalayerRuntime = {
-            environmentName: runtimeInfo.environmentName || 'unknown',
-            credits: 0,
-            reservationId: runtimeInfo.runtimeId,
-            podName: runtimeInfo.podName,
-            ingress: runtimeInfo.ingress,
-            token: runtimeInfo.token,
-            createdAt: new Date().toISOString(),
-        };
-        console.log('Reconnected to existing runtime:', {
-            runtimeId: runtimeInfo.runtimeId,
-            podName: runtimeInfo.podName,
-            ingress: runtimeInfo.ingress,
-        });
-        return serviceManager;
-    }
-    catch (error) {
-        console.error('Error reconnecting to runtime:', error);
-        throw error;
-    }
-};
-export default reconnectToRuntime;

package/lib/state/substates/CellState.d.ts

@@ -1,12 +0,0 @@
-import { ICell } from '../../models';
-export type ICellState = {
-    cell?: ICell;
-};
-export type CellState = ICellState & {
-    create: (cell: ICell) => void;
-    update: (cell: Partial<ICell>) => void;
-};
-export declare const cellStore: import("zustand").StoreApi<CellState>;
-export declare function useCellStore(): CellState;
-export declare function useCellStore<T>(selector: (state: CellState) => T): T;
-export default useCellStore;

package/lib/state/substates/CellState.js

@@ -1,22 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { createStore } from 'zustand/vanilla';
-import { useStore } from 'zustand';
-export const cellStore = createStore((set, get) => ({
-    cell: undefined,
-    create: (cell) => set((state) => ({ cell })),
-    update: (cell) => set((state) => ({
-        cell: cell
-            ? {
-                ...state.cell,
-                ...cell,
-            }
-            : undefined,
-    })),
-}));
-export function useCellStore(selector) {
-    return useStore(cellStore, selector);
-}
-export default useCellStore;

package/lib/state/substates/DocumentState.d.ts

@@ -1,10 +0,0 @@
-export interface IDocumentState {
-    documentSaveRequest?: Date;
-}
-export type DocumentState = IDocumentState & {
-    save: (documentSaveRequest: Date) => void;
-};
-export declare const documentStore: import("zustand").StoreApi<DocumentState>;
-export declare function useDocumentStore(): DocumentState;
-export declare function useDocumentStore<T>(selector: (state: DocumentState) => T): T;
-export default useDocumentStore;

package/lib/state/substates/DocumentState.js

@@ -1,14 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { createStore } from 'zustand/vanilla';
-import { useStore } from 'zustand';
-export const documentStore = createStore((set, get) => ({
-    documentSaveRequest: undefined,
-    save: (documentSaveRequest) => set((state) => ({ documentSaveRequest })),
-}));
-export function useDocumentStore(selector) {
-    return useStore(documentStore, selector);
-}
-export default useDocumentStore;

package/lib/state/substates/GradeState.d.ts

@@ -1,10 +0,0 @@
-export type IGradeState = {
-    gradeRequest?: Date;
-};
-export type GradeState = IGradeState & {
-    grade: (gradeRequest: Date) => void;
-};
-export declare const gradeStore: import("zustand").StoreApi<GradeState>;
-export declare function useGradeStore(): GradeState;
-export declare function useGradeStore<T>(selector: (state: GradeState) => T): T;
-export default useGradeStore;

package/lib/state/substates/GradeState.js

@@ -1,14 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { createStore } from 'zustand/vanilla';
-import { useStore } from 'zustand';
-export const gradeStore = createStore((set, get) => ({
-    gradeRequest: undefined,
-    grade: (gradeRequest) => set((state) => ({ gradeRequest })),
-}));
-export function useGradeStore(selector) {
-    return useStore(gradeStore, selector);
-}
-export default useGradeStore;

package/lib/state/substates/JupyterLabState.d.ts

@@ -1,16 +0,0 @@
-import { JupyterLabAppAdapter } from '@datalayer/jupyter-react';
-import { JupyterFrontEndPlugin } from '@jupyterlab/application';
-export type Plugin = JupyterFrontEndPlugin<any, any, any> & {
-    service: any;
-};
-export type IJupyterLabState = {
-    jupyterLabAdapter?: JupyterLabAppAdapter;
-};
-export type JupyterLabState = IJupyterLabState & {
-    setJupyterLabAdapter: (jupyterLabAdapter?: JupyterLabAppAdapter) => void;
-    plugin: (id: string) => Plugin | undefined;
-};
-export declare const jupyterLabStore: import("zustand").StoreApi<JupyterLabState>;
-export declare function useJupyterLabStore(): JupyterLabState;
-export declare function useJupyterLabStore<T>(selector: (state: JupyterLabState) => T): T;
-export default useJupyterLabStore;

package/lib/state/substates/JupyterLabState.js

@@ -1,17 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { createStore } from 'zustand/vanilla';
-import { useStore } from 'zustand';
-export const jupyterLabStore = createStore((set, get) => ({
-    jupyterLabAdapter: undefined,
-    setJupyterLabAdapter: (jupyterLabAdapter) => set((state) => ({ jupyterLabAdapter })),
-    plugin: (id) => {
-        return get().jupyterLabAdapter?.plugin(id);
-    },
-}));
-export function useJupyterLabStore(selector) {
-    return useStore(jupyterLabStore, selector);
-}
-export default useJupyterLabStore;

package/lib/state/substates/NbformatState.d.ts

@@ -1,13 +0,0 @@
-export type SaveRequest = {
-    counter: number;
-};
-export type INbformatState = {
-    saveRequest: SaveRequest;
-};
-export type NbformatState = INbformatState & {
-    save: (saveRequest: SaveRequest) => void;
-};
-export declare const nbformatStore: import("zustand").StoreApi<NbformatState>;
-export declare function useNbformatStore(): NbformatState;
-export declare function useNbformatStore<T>(selector: (state: NbformatState) => T): T;
-export default useNbformatStore;

package/lib/state/substates/NbformatState.js

@@ -1,16 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { createStore } from 'zustand/vanilla';
-import { useStore } from 'zustand';
-export const nbformatStore = createStore((set, get) => ({
-    saveRequest: {
-        counter: -1,
-    },
-    save: (saveRequest) => set((state) => ({ saveRequest })),
-}));
-export function useNbformatStore(selector) {
-    return useStore(nbformatStore, selector);
-}
-export default useNbformatStore;

package/lib/state/substates/RuntimesState.d.ts

@@ -1,79 +0,0 @@
-import type { IMultiServiceManager } from '../../stateful/runtimes';
-import type { IRuntimesConfiguration } from '../../config';
-import type { IRuntimePod, ICodeSandboxSnapshot, IRuntimeModel } from '../../models';
-/**
- * Datalayer Runtimes state.
- */
-export type RuntimesState = {
-    /**
-     * Runtimes configuration
-     */
-    configuration: IRuntimesConfiguration;
-    setConfiguration: (config: IRuntimesConfiguration) => void;
-    /**
-     * Runtimes RUN URL.
-     */
-    runtimesRunUrl: string;
-    tab: number;
-    getIntTab: () => number;
-    setTab: (tab: number) => void;
-    /**
-     * Runtime pods.
-     */
-    runtimePods: IRuntimePod[];
-    /**
-     * Refresh the runtime pods.
-     */
-    refreshRuntimePods: () => Promise<void>;
-    /**
-     * Cached runtime models.
-     */
-    runtimeModels: readonly IRuntimeModel[];
-    /**
-     * Add a runtime model.
-     */
-    addRuntimeModel: (model: IRuntimeModel) => void;
-    /**
-     * Remove a runtime model by ID.
-     */
-    removeRuntimeModel: (id: string) => void;
-    /**
-     * Set the runtimes models list.
-     */
-    setRuntimeModels: (models: readonly IRuntimeModel[]) => void;
-    /**
-     * Jupyter service manager.
-     */
-    multiServiceManager?: IMultiServiceManager;
-    setMultiServiceManager: (multiServiceManager: IMultiServiceManager) => void;
-    showDisclaimer: boolean;
-    setShowDisclaimer: (showDisclaimer: boolean) => void;
-    /**
-     * Code Sandbox snapshots.
-     */
-    runtimeSnapshots: readonly ICodeSandboxSnapshot[];
-    /**
-     * Add a code sandbox snapshot.
-     */
-    addSandboxSnapshot: (snapshot: ICodeSandboxSnapshot) => void;
-    /**
-     * Remove a Code Sandbox Snapshot.
-     */
-    removeSandboxSnapshot: (id: string) => void;
-    /**
-     * Set Code Sandbox Snapshots.
-     */
-    setSandboxSnapshots: (snapshots: ICodeSandboxSnapshot[]) => void;
-    /**
-     * Package version.
-     */
-    version: string;
-    setVersion: (version: string) => void;
-};
-/**
- * Kernel store
- */
-export declare const runtimesStore: import("zustand").StoreApi<RuntimesState>;
-export declare function useRuntimesStore(): RuntimesState;
-export declare function useRuntimesStore<T>(selector: (state: RuntimesState) => T): T;
-export default useRuntimesStore;

package/lib/state/substates/RuntimesState.js

@@ -1,180 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { useStore } from 'zustand';
-import { createStore } from 'zustand/vanilla';
-import { JSONExt } from '@lumino/coreutils';
-import { Poll } from '@lumino/polling';
-import { getRuntimes } from '../../stateful/runtimes/index.js';
-import { coreStore } from './CoreState.js';
-import { iamStore } from './IAMState.js';
-/**
- * Kernel store
- */
-export const runtimesStore = createStore((set, get) => {
-    return {
-        configuration: {
-            maxNotebookRuntimes: 5,
-            maxCellRuntimes: 3,
-        },
-        setConfiguration: (configuration) => {
-            set(state => JSONExt.deepEqual(state.configuration, configuration)
-                ? {}
-                : { configuration: { ...configuration } });
-        },
-        runtimesRunUrl: coreStore.getState().configuration?.runtimesRunUrl,
-        tab: 0.0,
-        getIntTab: () => Math.floor(get().tab),
-        setTab: (tab) => set(state => ({ tab })),
-        /**
-         * Remote runtime pods.
-         */
-        runtimePods: [],
-        /**
-         * Refresh the runtime pods.
-         */
-        refreshRuntimePods: async () => {
-            const servers = await getRuntimes();
-            // Update the state with the Remote Kernels.
-            if (!JSONExt.deepEqual(get().runtimePods, servers)) {
-                set({ runtimePods: [...servers] });
-            }
-        },
-        /**
-         * Cached runtime models.
-         */
-        runtimeModels: [],
-        /**
-         * Add a runtime model
-         */
-        addRuntimeModel: (model) => {
-            const kernels = get().runtimeModels;
-            // TODO
-            // We need to review the IRuntimeModel/IRuntimePod/Kernel.IModel and their id/uid handling.
-            // The id is the kernel id, which is no more always present for some reasons.
-            // So we need to also check the uid of the model.
-            const index = kernels.findIndex(m => (model.id === m.id || model.uid === m.uid) ?? -1);
-            if (index < 0) {
-                set({ runtimeModels: [...kernels, model] });
-            }
-        },
-        /**
-         * Remove a runtime model by ID.
-         */
-        removeRuntimeModel: (id) => {
-            const kernels = [...get().runtimeModels];
-            const index = kernels?.findIndex(model => id === model.id) ?? -1;
-            if (index >= 0) {
-                kernels.splice(index, 1);
-                set({ runtimeModels: kernels });
-            }
-        },
-        setRuntimeModels: (models) => {
-            if (!JSONExt.deepEqual(get().runtimeModels, models)) {
-                set({ runtimeModels: [...models] });
-            }
-        },
-        multiServiceManager: undefined,
-        setMultiServiceManager: multiServiceManager => {
-            set(state => ({ multiServiceManager }));
-        },
-        showDisclaimer: false,
-        setShowDisclaimer: showDisclaimer => {
-            set(state => ({ showDisclaimer }));
-        },
-        /**
-         * Kernel Snapshots.
-         */
-        runtimeSnapshots: [],
-        /**
-         * Add a Kernel Snapshot
-         */
-        addSandboxSnapshot: (snapshot) => {
-            const snapshots = get().runtimeSnapshots;
-            const index = snapshots.findIndex(s => s.id === snapshot.id);
-            if (index < 0) {
-                const kernelSnapshots = [...snapshots, snapshot];
-                set({ runtimeSnapshots: kernelSnapshots });
-            }
-            else if (!JSONExt.deepEqual(snapshots[index], snapshot)) {
-                const kernelSnapshots = [...snapshots];
-                kernelSnapshots.splice(index, 1, snapshot);
-                set({ runtimeSnapshots: kernelSnapshots });
-            }
-        },
-        /**
-         * Remove a Kernel Snapshot.
-         */
-        removeSandboxSnapshot: (id) => {
-            const snapshots = get().runtimeSnapshots;
-            const index = snapshots.findIndex(s => s.id === id);
-            if (index >= 0) {
-                const kernelSnapshots = [...snapshots];
-                kernelSnapshots.splice(index, 1);
-                set({ runtimeSnapshots: kernelSnapshots });
-            }
-        },
-        /**
-         * Set Kernel Snapshots.
-         */
-        setSandboxSnapshots: (snapshots) => {
-            if (!JSONExt.deepEqual(get().runtimeSnapshots, snapshots)) {
-                set({ runtimeSnapshots: [...snapshots] });
-            }
-        },
-        version: '',
-        setVersion: version => {
-            if (version && !get().version) {
-                set(state => ({ version }));
-            }
-        },
-    };
-});
-// Poll remote kernels
-const kernelsPoll = new Poll({
-    auto: true,
-    factory: () => runtimesStore.getState().refreshRuntimePods(),
-    frequency: {
-        interval: 61 * 1000,
-        backoff: true,
-        max: 300 * 1000,
-    },
-    name: '@datalayer/jupyter-kernels:KernelsManager#kernels',
-    standby: () => iamStore.getState().token || runtimesStore.getState().runtimesRunUrl
-        ? 'when-hidden'
-        : true,
-});
-// Force refresh at expiration date if next tick is after it.
-runtimesStore.subscribe((state, prevState) => {
-    if (!JSONExt.deepEqual(state.runtimePods, prevState.runtimePods)) {
-        const now = Date.now();
-        const minExpiredAt = Math.min(...state.runtimePods.map(kernel => kernel.expired_at ? parseFloat(kernel.expired_at) : Infinity)) * 1_000;
-        // Refresh 2 sec after the closest expiration time
-        // to let some times to the system to dispose the resources.
-        if (now + kernelsPoll.frequency.interval > minExpiredAt + 2_000) {
-            setTimeout(() => {
-                kernelsPoll.refresh();
-            }, minExpiredAt + 2_000 - now);
-        }
-    }
-});
-coreStore.subscribe((state, prevState) => {
-    if (state.configuration.runtimesRunUrl &&
-        state.configuration.runtimesRunUrl !==
-            prevState.configuration.runtimesRunUrl) {
-        const runtimesRunUrl = state.configuration.runtimesRunUrl;
-        console.log(`Updating runtimesRunUrl with new value ${runtimesRunUrl}`);
-        runtimesStore.setState({ runtimesRunUrl });
-        kernelsPoll
-            .refresh()
-            .then(() => kernelsPoll.tick)
-            .catch(reason => {
-            console.error('Failed to refresh kernel servers list following service URL changed.', reason);
-        });
-    }
-});
-export function useRuntimesStore(selector) {
-    return useStore(runtimesStore, selector);
-}
-export default useRuntimesStore;

package/lib/state/substates/SpaceState.d.ts

@@ -1,11 +0,0 @@
-import { IBaseSpace } from '../../models';
-export type ISpaceState = {
-    spaces: IBaseSpace[];
-};
-export type SpaceState = ISpaceState & {
-    updateSpaces: (spaces: IBaseSpace[]) => void;
-};
-export declare const spaceStore: import("zustand").StoreApi<SpaceState>;
-export declare function useSpaceStore(): SpaceState;
-export declare function useSpaceStore<T>(selector: (state: SpaceState) => T): T;
-export default useSpaceStore;

package/lib/state/substates/SpaceState.js

@@ -1,16 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { createStore } from 'zustand/vanilla';
-import { useStore } from 'zustand';
-export const spaceStore = createStore((set, get) => ({
-    spaces: [],
-    updateSpaces: (spaces) => set((state) => ({
-        spaces,
-    })),
-}));
-export function useSpaceStore(selector) {
-    return useStore(spaceStore, selector);
-}
-export default useSpaceStore;

package/lib/stateful/index.d.ts

@@ -1,2 +0,0 @@
-export * from './jupyter';
-export * from './runtimes';

package/lib/stateful/index.js

@@ -1,6 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-export * from './jupyter/index.js';
-export * from './runtimes/index.js';

package/lib/stateful/jupyter/exec/Python.d.ts

@@ -1,5 +0,0 @@
-export declare function listVariables(): string;
-export declare function saveVariables(variables: string[]): string;
-export declare function loadVariables(variables: string): string;
-export declare function changeCurrentWorkingDirectory(path: string): string;
-export declare function getOutputCandidates(code: string): string[];