@datalayer/core 0.0.12 → 0.0.13

package/lib/components/runtimes/RuntimePickerCell.js

@@ -8,8 +8,8 @@ import { nullTranslator } from '@jupyterlab/translation';
 import { ActionList } from '@primer/react';
 import { CloudUploadIcon } from '@datalayer/icons-react';
 import { useCoreStore, useIAMStore } from '../../state';
-import { isRuntimeRemote } from '../../sdk/stateful/runtimes';
-import { RuntimeSnippetsFacade } from '../../sdk/stateful/jupyter';
+import { isRuntimeRemote } from '../../stateful/runtimes';
+import { RuntimeSnippetsFacade } from '../../stateful/jupyter';
 import { ExternalTokenSilentLogin } from '../../components/iam';
 import { SnippetDialog } from './../snippets/SnippetDialog';
 import { RuntimeLauncherDialog } from './RuntimeLauncherDialog';

package/lib/components/runtimes/RuntimePickerNotebook.d.ts

@@ -1,6 +1,6 @@
 import { ITranslator } from '@jupyterlab/translation';
 import { CommandRegistry } from '@lumino/commands';
-import type { IMultiServiceManager, IDatalayerSessionContext } from '../../sdk/stateful/runtimes';
+import type { IMultiServiceManager, IDatalayerSessionContext } from '../../stateful/runtimes';
 import { RuntimeTransfer } from './RuntimeTransfer';
 /**
  * {@link RuntimePickerNotebook} properties

package/lib/components/runtimes/RuntimePickerNotebook.js

@@ -9,7 +9,7 @@ import { Box } from '@datalayer/primer-addons';
 import { AlertIcon } from '@primer/octicons-react';
 import { JSONExt } from '@lumino/coreutils';
 import { KernelExecutor } from '@datalayer/jupyter-react';
-import { RuntimeSnippetsFacade } from '../../sdk/stateful/jupyter';
+import { RuntimeSnippetsFacade } from '../../stateful/jupyter';
 import { ExternalTokenSilentLogin } from '../../components/iam';
 import { useCoreStore, useIAMStore } from '../../state';
 import { RuntimeReservationControl, MAXIMAL_RUNTIME_TIME_RESERVATION_MINUTES, } from './RuntimeReservationControl';

package/lib/components/runtimes/RuntimeTransfer.d.ts

@@ -1,4 +1,4 @@
-import { type IRuntimeOptions } from '../../sdk/stateful/runtimes';
+import { type IRuntimeOptions } from '../../stateful/runtimes';
 export interface RuntimeTransfer {
     /**
      * Selected Kernel.

package/lib/components/runtimes/RuntimeUtils.d.ts

@@ -1,6 +1,6 @@
 import { SessionContext } from '@jupyterlab/apputils';
 import { ITranslator } from '@jupyterlab/translation';
-import { IMultiServiceManager } from '../../sdk/stateful/runtimes';
+import { IMultiServiceManager } from '../../stateful/runtimes';
 import { IRuntimeDesc } from '../../models';
 export type IDatalayerRuntimeDesc = IRuntimeDesc & {
     gpu?: string;

package/lib/components/snapshots/RuntimeSnapshotMenu.d.ts

@@ -1,6 +1,6 @@
 import { type PropsWithChildren } from 'react';
 import { Kernel } from '@jupyterlab/services';
-import { IMultiServiceManager } from '../../sdk/stateful/runtimes';
+import { IMultiServiceManager } from '../../stateful/runtimes';
 /**
  * Runtime snapshot menu component properties
  */

package/lib/components/snapshots/RuntimeSnapshotMenu.js

@@ -5,10 +5,11 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  */
 import { useCallback, useEffect, useState, } from 'react';
 import { CameraIcon } from '@datalayer/icons-react';
-import { ActionList, ActionMenu, Box, Flash, FormControl, Select, Spinner, } from '@primer/react';
+import { ActionList, ActionMenu, Flash, FormControl, Select, Spinner, } from '@primer/react';
 import { Dialog } from '@primer/react/experimental';
+import { Box } from '@datalayer/primer-addons';
 import { useToast } from '../../hooks';
-import { createRuntimeSnapshot, getRuntimeSnapshots, loadBrowserRuntimeSnapshot, loadRuntimeSnapshot, } from '../../sdk/stateful/runtimes';
+import { createRuntimeSnapshot, getRuntimeSnapshots, loadBrowserRuntimeSnapshot, loadRuntimeSnapshot, } from '../../stateful/runtimes';
 import { useRuntimesStore } from '../../state';
 import { createRuntimeSnapshotName } from '../../utils';
 /**
@@ -17,10 +18,10 @@ import { createRuntimeSnapshotName } from '../../utils';
 export function RuntimeSnapshotMenu(props) {
     const { children, connection, podName, multiServiceManager, disabled } = props;
     const { addRuntimeSnapshot, runtimesRunUrl, runtimeSnapshots, setRuntimeSnapshots, } = useRuntimesStore();
-    const { trackAsyncTask } = useToast();
+    const { enqueueToast, trackAsyncTask } = useToast();
     const [openLoadDialog, setOpenLoadDialog] = useState(false);
-    const [loadingKernelSnapshot, setLoadingKernelSnapshot] = useState(false);
-    const [takingKernelSnapshot, setTakingSnapshot] = useState(false);
+    const [loadingRuntimeSnapshot, setLoadingRuntimeSnapshot] = useState(false);
+    const [takingRuntimeSnapshot, setTakingRuntimeSnapshot] = useState(false);
     const [selection, setSelection] = useState(runtimeSnapshots[0]?.id ?? '');
     const [error, setError] = useState();
     useEffect(() => {
@@ -35,31 +36,37 @@ export function RuntimeSnapshotMenu(props) {
             console.error(`Failed to fetch remote kernel snapshots; ${reason}`);
         });
     }, [runtimesRunUrl]);
-    const onLoadKernelSnapshot = useCallback(() => {
+    const onLoadRuntimeSnapshot = useCallback(() => {
         setError(undefined);
         setOpenLoadDialog(true);
     }, []);
-    const onKerenelSnapshotChanged = useCallback(event => {
+    const onRuntimeSnapshotChanged = useCallback(event => {
         setSelection(event.target.value);
     }, []);
-    const onLoadKernelSnapshotSubmit = useCallback(async ({ id, connection, podName, }) => {
+    const onLoadRuntimeSnapshotSubmit = useCallback(async ({ id, connection, podName, }) => {
         if (podName) {
             await loadRuntimeSnapshot({ id: podName, from: id });
+            enqueueToast(`Runtime snapshot ${podName} is loaded.`, {
+                variant: 'success',
+            });
         }
         else if (connection) {
             await loadBrowserRuntimeSnapshot({ connection, id });
+            enqueueToast(`Runtime snapshot ${id} is loaded.`, {
+                variant: 'success',
+            });
         }
     }, []);
-    const onTakeKernelSnapshot = useCallback(async () => {
+    const onTakeRuntimeSnapshot = useCallback(async () => {
         try {
-            setTakingSnapshot(true);
+            setTakingRuntimeSnapshot(true);
             let snapshot;
             let task;
             let ref = '';
             let snapshotName = '';
             if (podName && multiServiceManager?.remote) {
                 snapshotName = createRuntimeSnapshotName('cloud');
-                task = multiServiceManager.remote.runtimesManager.snapshot({
+                task = multiServiceManager.remote.runtimesManager.snapshotRuntime({
                     podName,
                     name: snapshotName,
                     description: snapshotName,
@@ -97,7 +104,7 @@ export function RuntimeSnapshotMenu(props) {
                         message: (reason, data) => {
                             const msg = reason === 'Empty snapshot'
                                 ? `Runtime ${ref} will not be snapshotted as it does not contain any serializable state.`
-                                : `Failed to pause runtime ${ref} - ${reason}`;
+                                : `Failed to snapshot runtime ${ref} - ${reason}`;
                             return msg;
                         },
                     },
@@ -113,10 +120,10 @@ export function RuntimeSnapshotMenu(props) {
             }
         }
         finally {
-            setTakingSnapshot(false);
+            setTakingRuntimeSnapshot(false);
         }
     }, [connection, podName, multiServiceManager]);
-    return (_jsxs(_Fragment, { children: [_jsxs(ActionMenu, { children: [_jsx(ActionMenu.Button, { leadingVisual: CameraIcon, variant: "invisible", size: "small", disabled: loadingKernelSnapshot || takingKernelSnapshot || disabled, children: children }), _jsx(ActionMenu.Overlay, { children: _jsxs(ActionList, { children: [_jsx(ActionList.Item, { onSelect: onLoadKernelSnapshot, disabled: loadingKernelSnapshot || runtimeSnapshots.length === 0, children: "Load a runtime snapshot\u2026" }), _jsx(ActionList.Item, { onSelect: onTakeKernelSnapshot, disabled: takingKernelSnapshot, children: "Take a runtime snapshot" })] }) })] }), openLoadDialog && (_jsx(Dialog, { title: _jsx("span", { style: { color: 'var(--fgColor-default)' }, children: "Choose a runtime snapshot to load" }), onClose: () => {
+    return (_jsxs(_Fragment, { children: [_jsxs(ActionMenu, { children: [_jsx(ActionMenu.Button, { leadingVisual: CameraIcon, variant: "invisible", size: "small", disabled: loadingRuntimeSnapshot || takingRuntimeSnapshot || disabled, children: children }), _jsx(ActionMenu.Overlay, { children: _jsxs(ActionList, { children: [_jsx(ActionList.Item, { onSelect: onLoadRuntimeSnapshot, disabled: loadingRuntimeSnapshot || runtimeSnapshots.length === 0, children: "Load a runtime snapshot\u2026" }), _jsx(ActionList.Item, { onSelect: onTakeRuntimeSnapshot, disabled: takingRuntimeSnapshot, children: "Take a runtime snapshot" })] }) })] }), openLoadDialog && (_jsx(Dialog, { title: _jsx("span", { style: { color: 'var(--fgColor-default)' }, children: "Choose a runtime snapshot to load" }), onClose: () => {
                     setOpenLoadDialog(false);
                 }, footerButtons: [
                     {
@@ -131,17 +138,17 @@ export function RuntimeSnapshotMenu(props) {
                     },
                     {
                         buttonType: 'primary',
-                        content: loadingKernelSnapshot ? (_jsx(Spinner, { size: "small" })) : ('Load'),
-                        disabled: loadingKernelSnapshot,
+                        content: loadingRuntimeSnapshot ? (_jsx(Spinner, { size: "small" })) : ('Load'),
+                        disabled: loadingRuntimeSnapshot,
                         onClick: async (event) => {
                             if (!event.defaultPrevented) {
                                 event.preventDefault();
-                                setLoadingKernelSnapshot(true);
+                                setLoadingRuntimeSnapshot(true);
                                 try {
                                     setError(undefined);
                                     const snapshot = runtimeSnapshots.find(s => s.id === selection);
                                     if (snapshot && (connection || podName)) {
-                                        await onLoadKernelSnapshotSubmit({
+                                        await onLoadRuntimeSnapshotSubmit({
                                             connection,
                                             id: snapshot.id,
                                             podName,
@@ -152,14 +159,14 @@ export function RuntimeSnapshotMenu(props) {
                                     }
                                 }
                                 finally {
-                                    setLoadingKernelSnapshot(false);
+                                    setLoadingRuntimeSnapshot(false);
                                     setOpenLoadDialog(false);
                                 }
                             }
                         },
                         autoFocus: true,
                     },
-                ], children: _jsxs(Box, { as: "form", children: [_jsxs(FormControl, { children: [_jsx(FormControl.Label, { children: "Snapshot" }), _jsx(Select, { name: "snapshot", value: selection, onChange: onKerenelSnapshotChanged, block: true, children: runtimeSnapshots.map(s => (_jsx(Select.Option, { value: s.id, children: s.name ? `${s.name} (${s.id})` : s.id }, s.id))) })] }), error && _jsx(Flash, { variant: "danger", children: error })] }) }))] }));
+                ], children: _jsxs(Box, { as: "form", children: [_jsxs(FormControl, { children: [_jsx(FormControl.Label, { children: "Snapshot" }), _jsx(Select, { name: "snapshot", value: selection, onChange: onRuntimeSnapshotChanged, block: true, children: runtimeSnapshots.map(s => (_jsx(Select.Option, { value: s.id, children: s.name ? `${s.name} (${s.id})` : s.id }, s.id))) })] }), error && _jsx(Flash, { variant: "danger", children: error })] }) }))] }));
 }
 RuntimeSnapshotMenu.defaultProps = {
     disabled: false,

package/lib/config/Configuration.d.ts

@@ -63,6 +63,14 @@ export type IDatalayerCoreConfig = {
      * AI Agents API URL.
      */
     aiagentsRunUrl: string;
+    /**
+     * AI Inference API URL.
+     */
+    aiinferenceRunUrl: string;
+    /**
+     * MCP Servers API URL.
+     */
+    mcpserversRunUrl: string;
     /**
      * Growth API URL.
      */

package/lib/hooks/useDatalayer.js

@@ -36,7 +36,7 @@ export function useDatalayer(props = {}) {
             if (error.name === 'RunResponseError') {
                 const responseError = error;
                 if (responseError.response.status === 401) {
-                    console.log('Datalayer RUN sent a 401 return code.');
+                    console.log('Datalayer sent a 401 return code.');
                     if (location.pathname !== loginRoute_) {
                         iamStore.logout();
                         navigate(loginRoute_);

package/lib/hooks/useRuntimes.js

@@ -2,7 +2,7 @@
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import { requestJupyterKernelsExtension } from '../sdk/stateful/jupyter/kernelsHandler';
+import { requestJupyterKernelsExtension } from '../stateful/jupyter/kernelsHandler';
 export const useRuntimes = () => {
     // Folder Mounting ----------------------------------------------------------
     const mountLocalFolder = (kernelId) => {

package/lib/hooks/useToast.js

@@ -41,7 +41,7 @@ function createContent(message, closeHandler, actions) {
                     })] }))] }));
 }
 export const useToast = () => {
-    // This CANNOT use React hooks as it is used outside React context.
+    // This CANNOT use Jupyter React hooks as it may be used outside Jupyter React context.
     const insideJupyterLab = isInsideJupyterLab();
     const enqueueToast = (message, options = { variant: 'info' }) => {
         const { actions, autoClose } = options;

package/lib/index.d.ts

@@ -11,5 +11,5 @@ export * from './api/types';
 export * as runtimesApi from './api/runtimes';
 export * as iamApi from './api/iam';
 export * as spacerApi from './api/spacer';
-export { DatalayerSDK, type DatalayerSDKConfig } from './sdk/client';
-export { getEnvironments, createRuntime, getRuntimes, deleteRuntime, snapshotRuntime, getRuntimeSnapshots, loadRuntimeSnapshot, } from './sdk/stateful/runtimes/actions';
+export { DatalayerClient, type DatalayerClientConfig, type SDKHandlers, User, Runtime, Environment, Snapshot, Space, Notebook, Lexical, Credits, Item, type RuntimeJSON, type EnvironmentJSON, type UserJSON, } from './client';
+export { getEnvironments, createRuntime, getRuntimes, deleteRuntime, snapshotRuntime, getRuntimeSnapshots, loadRuntimeSnapshot, } from './stateful/runtimes/actions';

package/lib/index.js

@@ -16,6 +16,8 @@ export * from './api/types';
 export * as runtimesApi from './api/runtimes';
 export * as iamApi from './api/iam';
 export * as spacerApi from './api/spacer';
-export { DatalayerSDK } from './sdk/client';
+export { DatalayerClient, 
+// Export SDK models
+User, Runtime, Environment, Snapshot, Space, Notebook, Lexical, Credits, Item, } from './client';
 // Export commonly used SDK functions directly for convenience
-export { getEnvironments, createRuntime, getRuntimes, deleteRuntime, snapshotRuntime, getRuntimeSnapshots, loadRuntimeSnapshot, } from './sdk/stateful/runtimes/actions';
+export { getEnvironments, createRuntime, getRuntimes, deleteRuntime, snapshotRuntime, getRuntimeSnapshots, loadRuntimeSnapshot, } from './stateful/runtimes/actions';

package/lib/sdk/index.d.ts

@@ -1,6 +1,5 @@
 /**
- * @module sdk
- * @description Main SDK entry point for the Datalayer platform.
+ * Main SDK entry point for the Datalayer platform.
  *
  * This module provides the unified DatalayerSDK class with a flat, intuitive API
  * for all Datalayer platform services. The SDK uses TypeScript mixins to provide
@@ -21,6 +20,8 @@
  * const runtime = await sdk.createRuntime(config);
  * const notebook = await sdk.createNotebook(data);
  * ```
+ *
+ * @module sdk
  */
-export { DatalayerSDK, type DatalayerSDKConfig } from './client';
-export * from './stateful';
+export { DatalayerClient, type DatalayerClientConfig } from '../client';
+export * from '../stateful';

package/lib/sdk/index.js

@@ -3,8 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * @module sdk
- * @description Main SDK entry point for the Datalayer platform.
+ * Main SDK entry point for the Datalayer platform.
  *
  * This module provides the unified DatalayerSDK class with a flat, intuitive API
  * for all Datalayer platform services. The SDK uses TypeScript mixins to provide
@@ -25,8 +24,10 @@
  * const runtime = await sdk.createRuntime(config);
  * const notebook = await sdk.createNotebook(data);
  * ```
+ *
+ * @module sdk
  */
-// Export the main SDK class with flat API
-export { DatalayerSDK } from './client';
+// Export the main Client class with flat API
+export { DatalayerClient } from '../client';
 // Export stateful modules for advanced use cases
-export * from './stateful';
+export * from '../stateful';

package/lib/services/DatalayerServiceManager.js

@@ -5,7 +5,7 @@
 import { ServerConnection, ServiceManager } from '@jupyterlab/services';
 import { coreStore } from '../state/substates/CoreState';
 import { DEFAULT_DATALAYER_CONFIG } from '../config/Configuration';
-import { createRuntime } from '../sdk/stateful/runtimes/actions';
+import { createRuntime } from '../stateful/runtimes/actions';
 /**
  * Creates a ServiceManager configured for Datalayer.
  *

package/lib/state/substates/CoreState.js

@@ -21,6 +21,8 @@ let initialConfiguration = {
     libraryRunUrl: 'https://prod1.datalayer.run',
     spacerRunUrl: 'https://prod1.datalayer.run',
     aiagentsRunUrl: 'https://prod1.datalayer.run',
+    aiinferenceRunUrl: 'https://prod1.datalayer.run',
+    mcpserversRunUrl: 'https://prod1.datalayer.run',
     growthRunUrl: 'https://prod1.datalayer.run',
     inboundsRunUrl: 'https://prod1.datalayer.run',
     successRunUrl: 'https://prod1.datalayer.run',

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

@@ -1,4 +1,4 @@
-import type { IMultiServiceManager } from '../../sdk/stateful/runtimes';
+import type { IMultiServiceManager } from '../../stateful/runtimes';
 import type { IRuntimesConfiguration } from '../../config';
 import type { IRuntimePod, IRuntimeSnapshot, IRuntimeModel } from '../../models';
 /**

package/lib/state/substates/RuntimesState.js

@@ -6,7 +6,7 @@ import { useStore } from 'zustand';
 import { createStore } from 'zustand/vanilla';
 import { JSONExt } from '@lumino/coreutils';
 import { Poll } from '@lumino/polling';
-import { getRuntimes } from '../../sdk/stateful/runtimes';
+import { getRuntimes } from '../../stateful/runtimes';
 import { coreStore } from './CoreState';
 import { iamStore } from './IAMState';
 /**

package/lib/{sdk/stateful → stateful}/index.d.ts

@@ -1,3 +1,3 @@
 export * from './jupyter';
 export * from './runtimes';
-export * from '../../api/DatalayerApi';
+export * from '../api/DatalayerApi';

package/lib/{sdk/stateful → stateful}/index.js

@@ -4,4 +4,4 @@
  */
 export * from './jupyter';
 export * from './runtimes';
-export * from '../../api/DatalayerApi';
+export * from '../api/DatalayerApi';

package/lib/{sdk/stateful → stateful}/jupyter/exec/Snippets.d.ts

@@ -5,11 +5,6 @@ export interface IRuntimeSnippets {
     /**
      * Code snippet to change the current working directory.
      *
-     * The code snippet has no returned value.
-     *
-     * The path is relative to the home directory and use
-     * the separator `/`.
-     *
      * @param path New current directory
      * @returns The code snippet
      */
@@ -17,21 +12,12 @@ export interface IRuntimeSnippets {
     /**
      * Code snippet to list the transferable kernel variables.
      *
-     * The code snippet must return a serialized-JSON
-     * dictionary (<variable name>, <variable type>)
-     *
      * @returns The code snippet
      */
     listVariables(): string;
     /**
      * Code snippet to load kernel variables.
      *
-     * The code snippet must return a serialized-JSON list
-     * with successfully loaded variables.
-     *
-     * The format used to store the variable value is up to the kernel.
-     * It should JSON-serializable and will be passed from {@link saveVariables}.
-     *
      * @param variables Serialized-JSON dictionary (<variable name>, <variable value blob>)
      * @returns The code snippet
      */
@@ -39,13 +25,6 @@ export interface IRuntimeSnippets {
     /**
      * Code snippet to save kernel variables.
      *
-     * The code snippet must return a serialized-JSON dictionary
-     * (<variable name>, <variable value blob>).
-     *
-     * The format used to store the variable value is up to the kernel.
-     * It should JSON-serializable and will be passed to {@link loadVariables}
-     * without modification.
-     *
      * @param variables Variable names.
      * @returns The code snippet
      */
@@ -78,10 +57,7 @@ export declare class RuntimeSnippetsFacade {
     static supports(language: string): boolean;
     private _language;
     /**
-     * Create a kernel snippet generator for a given kernel
-     * language.
-     *
-     * It will raise if the language is not available.
+     * Create a kernel snippet generator for a given kernel language.
      *
      * @param language Kernel language
      */
@@ -102,21 +78,12 @@ export declare class RuntimeSnippetsFacade {
     /**
      * Code snippet to list the transferable kernel variables.
      *
-     * The code snippet must return a serialized-JSON
-     * dictionary (<variable name>, <variable type>)
-     *
      * @returns The code snippet
      */
     listVariables(): string;
     /**
      * Code snippet to load kernel variables.
      *
-     * The code snippet must return a serialized-JSON list
-     * with successfully loaded variables.
-     *
-     * The format used to store the variable value is up to the kernel.
-     * It should JSON-serializable and will be passed from {@link saveVariables}.
-     *
      * @param variables Serialized-JSON dictionary (<variable name>, <variable value blob>)
      * @returns The code snippet
      */
@@ -124,13 +91,6 @@ export declare class RuntimeSnippetsFacade {
     /**
      * Code snippet to save kernel variables.
      *
-     * The code snippet must return a serialized-JSON dictionary
-     * (<variable name>, <variable value blob>).
-     *
-     * The format used to store the variable value is up to the kernel.
-     * It should JSON-serializable and will be passed to {@link loadVariables}
-     * without modification.
-     *
      * @param variables Variable names.
      * @returns The code snippet
      */

package/lib/{sdk/stateful → stateful}/jupyter/exec/Snippets.js

@@ -27,10 +27,7 @@ export class RuntimeSnippetsFacade {
     }
     _language;
     /**
-     * Create a kernel snippet generator for a given kernel
-     * language.
-     *
-     * It will raise if the language is not available.
+     * Create a kernel snippet generator for a given kernel language.
      *
      * @param language Kernel language
      */
@@ -62,9 +59,6 @@ export class RuntimeSnippetsFacade {
     /**
      * Code snippet to list the transferable kernel variables.
      *
-     * The code snippet must return a serialized-JSON
-     * dictionary (<variable name>, <variable type>)
-     *
      * @returns The code snippet
      */
     listVariables() {
@@ -73,12 +67,6 @@ export class RuntimeSnippetsFacade {
     /**
      * Code snippet to load kernel variables.
      *
-     * The code snippet must return a serialized-JSON list
-     * with successfully loaded variables.
-     *
-     * The format used to store the variable value is up to the kernel.
-     * It should JSON-serializable and will be passed from {@link saveVariables}.
-     *
      * @param variables Serialized-JSON dictionary (<variable name>, <variable value blob>)
      * @returns The code snippet
      */
@@ -90,13 +78,6 @@ export class RuntimeSnippetsFacade {
     /**
      * Code snippet to save kernel variables.
      *
-     * The code snippet must return a serialized-JSON dictionary
-     * (<variable name>, <variable value blob>).
-     *
-     * The format used to store the variable value is up to the kernel.
-     * It should JSON-serializable and will be passed to {@link loadVariables}
-     * without modification.
-     *
      * @param variables Variable names.
      * @returns The code snippet
      */

package/lib/{sdk/stateful → stateful}/runtimes/actions.d.ts

@@ -1,5 +1,5 @@
 import { IRuntimeOptions } from '..';
-import type { IRuntimeSnapshot, IDatalayerEnvironment, IRuntimePod } from '../../../models';
+import type { IRuntimeSnapshot, IDatalayerEnvironment, IRuntimePod } from '../../models';
 /**
  * Get available Environments.
  */
@@ -42,7 +42,7 @@ export declare function snapshotRuntime(options: {
      */
     description?: string;
     /**
-     * Whether to stop the kernel after the snapshot completion or not.
+     * Whether to stop the runtime after the snapshot completion or not.
      */
     stop?: boolean;
 }): Promise<IRuntimeSnapshot>;
@@ -51,7 +51,7 @@ export declare function snapshotRuntime(options: {
  */
 export declare function getRuntimeSnapshots(): Promise<IRuntimeSnapshot[]>;
 /**
- * Load a Runtime Snapshot within a kernel.
+ * Load a Runtime Snapshot within a Runtime.
  */
 export declare function loadRuntimeSnapshot(options: {
     /**

package/lib/{sdk/stateful → stateful}/runtimes/actions.js

@@ -9,9 +9,9 @@ import { URLExt } from '@jupyterlab/coreutils';
 import { PromiseDelegate } from '@lumino/coreutils';
 import { Upload } from 'tus-js-client';
 import { requestDatalayerAPI, } from '..';
-import { asRuntimeSnapshot } from '../../../models';
-import { iamStore, runtimesStore } from '../../../state';
-import { sleep } from '../../../utils';
+import { asRuntimeSnapshot } from '../../models';
+import { iamStore, runtimesStore } from '../../state';
+import { sleep } from '../../utils';
 /**
  * Get available Environments.
  */
@@ -111,7 +111,7 @@ export async function snapshotRuntime(options) {
         token: iamStore.getState().token,
     });
     if (!data.success || !data.snapshot) {
-        throw new Error(`Failed to pause the kernel snapshot ${options.id} - ${data}`);
+        throw new Error(`Failed to take the runtime snapshot ${options.id} - ${data}`);
     }
     return asRuntimeSnapshot(data.snapshot);
 }
@@ -124,13 +124,13 @@ export async function getRuntimeSnapshots() {
         token: iamStore.getState().token,
     });
     if (!data.success) {
-        console.error('Failed to fetch kernel snapshots.', data);
+        console.error('Failed to fetch runtime snapshots.', data);
         return [];
     }
     return (data.snapshots ?? []).map(asRuntimeSnapshot);
 }
 /**
- * Load a Runtime Snapshot within a kernel.
+ * Load a Runtime Snapshot within a Runtime.
  */
 export async function loadRuntimeSnapshot(options) {
     const data = await requestDatalayerAPI({
@@ -142,7 +142,7 @@ export async function loadRuntimeSnapshot(options) {
         token: iamStore.getState().token,
     });
     if (!data.success) {
-        throw new Error(`Failed to load the kernel snapshot; ${data.message}`);
+        throw new Error(`Failed to load the runtime snapshot; ${data.message}`);
     }
 }
 /**
@@ -181,7 +181,7 @@ export async function deleteRuntimeSnapshot(id) {
         method: 'DELETE',
         token: iamStore.getState().token,
     });
-    // Poll Runtime Snapshot state up-to its deletion
+    // Poll Runtime Snapshot state up-to its deletion.
     try {
         let sleepTimeout = 1000;
         while (true) {

package/lib/{sdk/stateful → stateful}/runtimes/apis.d.ts

@@ -5,7 +5,7 @@ import { ISessionContext } from '@jupyterlab/apputils';
 import { ServiceManager, Kernel, ServerConnection } from '@jupyterlab/services';
 import { IDisposable } from '@lumino/disposable';
 import { ISignal } from '@lumino/signaling';
-import type { IRuntimeSnapshot, IRuntimeCapabilities, IRuntimeModel, IDatalayerEnvironment, IRuntimeType, IRuntimeLocation } from '../../../models';
+import type { IRuntimeSnapshot, IRuntimeCapabilities, IRuntimeModel, IDatalayerEnvironment, IRuntimeType, IRuntimeLocation } from '../../models';
 /**
  * Abstract interface for the Datalayer session context.
  * It extends the JupyterLab session context
@@ -160,16 +160,16 @@ export interface IRemoteRuntimesManager extends IDisposable {
      */
     refreshKernels(): Promise<void>;
     /**
-     * Snapshot a remote kernel
+     * Snapshot a runtime
      *
-     * The remote kernel may be given by its `id` or `podName`.
+     * The runtime may be given by its `id` or `podName`.
      * A custom description for the snapshot can be provided.
      *
      * @returns The snapshot description
      */
-    snapshot(options: {
+    snapshotRuntime(options: {
         /**
-         * The kernel id to snapshot
+         * The runtime id to snapshot
          */
         id?: string;
         /**
@@ -190,11 +190,11 @@ export interface IRemoteRuntimesManager extends IDisposable {
         stop?: boolean;
     }): Promise<IRuntimeSnapshot | undefined>;
     /**
-     * Load a snapshot within a remote kernel
+     * Load a snapshot within a runtim
      *
-     * The remote kernel may be given by its `id` or `podName`.
+     * The runtime may be given by its `id` or `podName`.
      */
-    loadSnapshot(options: {
+    loadRuntimeSnapshot(options: {
         /**
          * The kernel id
          */

package/lib/stateful/runtimes/apis.js

@@ -0,0 +1,5 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+export {};