@datalayer/core 1.0.25 → 1.1.43

package/lib/api/runtimes/checkpoints.js

@@ -1,118 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-/**
- * Runtime checkpoints API functions for the Datalayer platform.
- *
- * Provides functions for managing CRIU full-pod checkpoints.
- * These are distinct from code sandbox snapshots (Jupyter sandbox snapshots).
- *
- * @module api/runtimes/checkpoints
- */
-import { requestDatalayerAPI } from '../DatalayerApi.js';
-import { API_BASE_PATHS, DEFAULT_SERVICE_URLS } from '../constants.js';
-import { validateToken, validateRequiredString } from '../utils/validation.js';
-// ─── API Functions ─────────────────────────────────────────────────────────
-/**
- * List runtime checkpoints for a specific runtime.
- * @param token - Authentication token
- * @param baseUrl - Base URL for the runtimes API
- * @param runtimeUid - Runtime UID to list checkpoints for
- * @returns Promise resolving to list of checkpoints
- */
-export const listCheckpoints = async (token, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES, runtimeUid) => {
-    validateToken(token);
-    if (!runtimeUid) {
-        throw new Error('runtimeUid is required to list checkpoints');
-    }
-    return requestDatalayerAPI({
-        url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/runtime-checkpoints/${encodeURIComponent(runtimeUid)}`,
-        method: 'GET',
-        token,
-    });
-};
-/**
- * Get a single runtime checkpoint by ID.
- * @param token - Authentication token
- * @param runtimeUid - The runtime UID
- * @param checkpointId - The checkpoint ID (ULID)
- * @param baseUrl - Base URL for the runtimes API
- * @returns Promise resolving to checkpoint details
- */
-export const getCheckpoint = async (token, runtimeUid, checkpointId, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
-    validateToken(token);
-    validateRequiredString(runtimeUid, 'Runtime UID');
-    validateRequiredString(checkpointId, 'Checkpoint ID');
-    return requestDatalayerAPI({
-        url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/runtime-checkpoints/${encodeURIComponent(runtimeUid)}/${checkpointId}`,
-        method: 'GET',
-        token,
-    });
-};
-/**
- * Create a checkpoint record (after a CRIU checkpoint has been taken).
- * @param token - Authentication token
- * @param data - Checkpoint creation payload (runtime_uid, agentspec, etc.)
- * @param baseUrl - Base URL for the runtimes API
- * @returns Promise resolving to the created checkpoint
- */
-export const createCheckpoint = async (token, data, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
-    validateToken(token);
-    return requestDatalayerAPI({
-        url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/runtime-checkpoints`,
-        method: 'POST',
-        token,
-        body: data,
-    });
-};
-/**
- * Poll a checkpoint until it reaches one of the target statuses.
- *
- * Useful for waiting until an async pause (status "paused")
- * completes before proceeding.  Checkpoint status stays "paused"
- * during resume — only the agent runtime status transitions.
- *
- * @param token - Authentication token
- * @param runtimeUid - The runtime UID that owns the checkpoint
- * @param checkpointId - The checkpoint ID (ULID) to poll
- * @param targetStatuses - Set of statuses that signal completion (e.g. ["paused", "failed"])
- * @param baseUrl - Base URL for the runtimes API
- * @param intervalMs - Polling interval in milliseconds (default: 2000)
- * @param timeoutMs - Maximum wait time in milliseconds (default: 600000 = 10 min)
- * @returns Promise resolving to the checkpoint data once a target status is reached
- * @throws {Error} If polling times out or the request fails
- */
-export const waitForCheckpointStatus = async (token, runtimeUid, checkpointId, targetStatuses, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES, intervalMs = 2000, timeoutMs = 600_000) => {
-    validateToken(token);
-    validateRequiredString(runtimeUid, 'Runtime UID');
-    validateRequiredString(checkpointId, 'Checkpoint ID');
-    const deadline = Date.now() + timeoutMs;
-    while (Date.now() < deadline) {
-        const resp = await getCheckpoint(token, runtimeUid, checkpointId, baseUrl);
-        if (targetStatuses.includes(resp.checkpoint.status)) {
-            return resp.checkpoint;
-        }
-        // Wait before next poll
-        await new Promise(resolve => setTimeout(resolve, intervalMs));
-    }
-    throw new Error(`Checkpoint ${checkpointId} did not reach status [${targetStatuses.join(', ')}] within ${timeoutMs / 1000}s`);
-};
-/**
- * Delete a runtime checkpoint.
- * @param token - Authentication token
- * @param runtimeUid - The runtime UID that owns the checkpoint
- * @param checkpointId - The checkpoint ID (ULID) to delete
- * @param baseUrl - Base URL for the runtimes API
- * @returns Promise resolving when deletion is complete
- */
-export const deleteCheckpoint = async (token, runtimeUid, checkpointId, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
-    validateToken(token);
-    validateRequiredString(runtimeUid, 'Runtime UID');
-    validateRequiredString(checkpointId, 'Checkpoint ID');
-    return requestDatalayerAPI({
-        url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/runtime-checkpoints/${encodeURIComponent(runtimeUid)}/${checkpointId}`,
-        method: 'DELETE',
-        token,
-    });
-};

package/lib/api/runtimes/environments.d.ts

@@ -1,9 +0,0 @@
-import { ListEnvironmentsResponse } from '../../models/EnvironmentDTO';
-/**
- * List all available computing environments.
- * @param token - Authentication token
- * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
- * @returns Promise resolving to list of available environments
- * @throws {Error} If authentication token is missing or invalid
- */
-export declare const listEnvironments: (token: string, baseUrl?: string) => Promise<ListEnvironmentsResponse>;

package/lib/api/runtimes/environments.js

@@ -1,29 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-/**
- * Computing environments API functions for the Datalayer platform.
- *
- * Provides functions for managing computing environment configurations.
- *
- * @module api/runtimes/environments
- */
-import { requestDatalayerAPI } from '../DatalayerApi.js';
-import { API_BASE_PATHS, DEFAULT_SERVICE_URLS } from '../constants.js';
-import { validateToken } from '../utils/validation.js';
-/**
- * List all available computing environments.
- * @param token - Authentication token
- * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
- * @returns Promise resolving to list of available environments
- * @throws {Error} If authentication token is missing or invalid
- */
-export const listEnvironments = async (token, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
-    validateToken(token);
-    return requestDatalayerAPI({
-        url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/environments`,
-        method: 'GET',
-        token,
-    });
-};

package/lib/api/runtimes/healthz.d.ts

@@ -1,15 +0,0 @@
-import type { HealthzPingResponse } from '../../models/Common';
-/**
- * Health check ping endpoint for Runtimes service
- * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
- * @returns Health check response
- * @throws {Error} If the health check fails
- *
- * @remarks
- * This endpoint provides a basic health check for the Runtimes service.
- * It returns the current status of the service.
- *
- * Expected status codes:
- * - 200: Service is healthy
- */
-export declare const ping: (baseUrl?: string) => Promise<HealthzPingResponse>;

package/lib/api/runtimes/healthz.js

@@ -1,44 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-/**
- * Health check API functions for the Datalayer Runtimes service.
- *
- * Provides functions for checking the health status of the Runtimes service.
- *
- * @module api/runtimes/healthz
- */
-import { requestDatalayerAPI } from '../DatalayerApi.js';
-import { API_BASE_PATHS, DEFAULT_SERVICE_URLS } from '../constants.js';
-/**
- * Health check ping endpoint for Runtimes service
- * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
- * @returns Health check response
- * @throws {Error} If the health check fails
- *
- * @remarks
- * This endpoint provides a basic health check for the Runtimes service.
- * It returns the current status of the service.
- *
- * Expected status codes:
- * - 200: Service is healthy
- */
-export const ping = async (baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
-    try {
-        const response = await requestDatalayerAPI({
-            url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/ping`,
-            method: 'GET',
-        });
-        return response;
-    }
-    catch (error) {
-        // Check if it's a response error with status code information
-        if (error.response) {
-            const status = error.response.status;
-            throw new Error(`Health check failed: Service unhealthy (status ${status}) - ${error.message}`);
-        }
-        // Re-throw other errors (network errors, etc.)
-        throw new Error(`Health check failed: ${error.message}`);
-    }
-};

package/lib/api/runtimes/index.d.ts

@@ -1,12 +0,0 @@
-/**
- * Runtimes API exports.
- *
- * Provides organized access to runtime management functionality.
- *
- * @module api/runtimes
- */
-export * as environments from './environments';
-export * as healthz from './healthz';
-export * as runtimes from './runtimes';
-export * as snapshots from './snapshots';
-export * as checkpoints from './checkpoints';

package/lib/api/runtimes/index.js

@@ -1,16 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-/**
- * Runtimes API exports.
- *
- * Provides organized access to runtime management functionality.
- *
- * @module api/runtimes
- */
-export * as environments from './environments.js';
-export * as healthz from './healthz.js';
-export * as runtimes from './runtimes.js';
-export * as snapshots from './snapshots.js';
-export * as checkpoints from './checkpoints.js';

package/lib/api/runtimes/runtimes.d.ts

@@ -1,138 +0,0 @@
-import { RuntimeData, CreateRuntimeRequest, CreateRuntimeResponse, ListRuntimesResponse } from '../../models/RuntimeDTO';
-/**
- * Create a new runtime instance.
- * @param token - Authentication token
- * @param data - Runtime creation configuration
- * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
- * @returns Promise resolving to the created runtime details
- * @throws {Error} If authentication token is missing or invalid
- * @throws {Error} With status 404 if the environment is not found
- * @throws {Error} With status 503 if no runtime is available
- */
-export declare const createRuntime: (token: string, data: CreateRuntimeRequest, baseUrl?: string) => Promise<CreateRuntimeResponse>;
-/**
- * List all runtime instances.
- * @param token - Authentication token
- * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
- * @returns Promise resolving to list of runtime instances
- * @throws {Error} If authentication token is missing or invalid
- */
-export declare const listRuntimes: (token: string, baseUrl?: string) => Promise<ListRuntimesResponse>;
-/**
- * Get details for a specific runtime instance.
- * @param token - Authentication token
- * @param podName - The unique pod name of the runtime
- * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
- * @returns Promise resolving to runtime details
- * @throws {Error} If authentication token is missing or invalid
- * @throws {Error} If pod name is missing or invalid
- * @throws {Error} With status 404 if the runtime is not found
- */
-export declare const getRuntime: (token: string, podName: string, baseUrl?: string) => Promise<RuntimeData>;
-/**
- * Delete a runtime instance.
- * @param token - Authentication token
- * @param podName - The unique pod name of the runtime to delete
- * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
- * @returns Promise resolving when deletion is complete
- * @throws {Error} If authentication token is missing or invalid
- * @throws {Error} If pod name is missing or invalid
- * @throws {Error} With status 404 if the runtime is not found
- */
-export declare const deleteRuntime: (token: string, podName: string, baseUrl?: string) => Promise<void>;
-/**
- * Update a runtime instance.
- * @param token - Authentication token
- * @param podName - The unique pod name of the runtime
- * @param from - The source to update from
- * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
- * @returns Promise resolving to updated runtime details
- * @throws {Error} If authentication token is missing or invalid
- * @throws {Error} If pod name is missing or invalid
- * @throws {Error} With status 404 if the runtime is not found
- */
-export declare const updateRuntime: (token: string, podName: string, from: string, baseUrl?: string) => Promise<RuntimeData>;
-/**
- * Response from the pause/resume runtime endpoints.
- * The server returns 202 Accepted and provides a checkpoint UID
- * that can be polled for status updates.
- */
-export interface PauseResumeResponse {
-    success: boolean;
-    message: string;
-    checkpoint_id: string | null;
-}
-/**
- * Optional body for the pause endpoint.
- * Metadata is stored in the checkpoint Solr record created by the backend.
- */
-export interface PauseRuntimeBody {
-    /** Checkpoint mode: 'criu' (full) or 'light' (history-only) */
-    checkpoint_mode?: 'criu' | 'light';
-    /** Human-readable checkpoint name */
-    name?: string;
-    /** Checkpoint description */
-    description?: string;
-    /** Agentspec identifier */
-    agent_spec_id?: string;
-    /** Full agentspec payload to persist with the checkpoint */
-    agentspec?: Record<string, any>;
-    /** Additional metadata */
-    metadata?: Record<string, any>;
-    /** Lightweight checkpoint message history */
-    messages?: string[];
-}
-/**
- * Pause a runtime by creating a checkpoint (async, light mode by default).
- *
- * Returns immediately with a 202 Accepted response.  The actual checkpoint
- * process runs in the background.  Use the returned `checkpoint_id` to
- * poll for status via the runtime-checkpoints API.
- *
- * @param token - Authentication token
- * @param podName - The unique pod name of the runtime to pause
- * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
- * @param body - Optional metadata to store in the checkpoint record
- * @returns Promise resolving with the checkpoint ID for status tracking
- * @throws {Error} If authentication token is missing or invalid
- * @throws {Error} If pod name is missing or invalid
- */
-export declare const pauseRuntime: (token: string, podName: string, baseUrl?: string, body?: PauseRuntimeBody) => Promise<PauseResumeResponse>;
-/**
- * Optional body for the resume endpoint.
- * Contains information needed by the operator to restore from a checkpoint.
- */
-export interface ResumeRuntimeBody {
-    /** Checkpoint mode to resume from: 'criu' or 'light' */
-    checkpoint_mode?: 'criu' | 'light';
-    /** Explicit checkpoint identifier */
-    checkpoint_id?: string;
-    /** Agentspec identifier (required by the operator for restore) */
-    agent_spec_id?: string;
-    /** Specific checkpoint timestamp to restore from */
-    checkpoint_timestamp?: string;
-    /** Environment name override */
-    environment_name?: string;
-    /** Container image override */
-    container_image?: string;
-    /** Target node name */
-    node_name?: string;
-    /** Additional metadata */
-    metadata?: Record<string, any>;
-}
-/**
- * Resume a paused runtime by restoring from a checkpoint (async).
- *
- * Returns immediately with a 202 Accepted response.  The actual restore
- * process runs in the background.  Use the returned `checkpoint_id` to
- * poll for status.
- *
- * @param token - Authentication token
- * @param podName - The unique pod name of the runtime to resume
- * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
- * @param body - Optional body with agent_spec_id and restore options
- * @returns Promise resolving with the checkpoint ID for status tracking
- * @throws {Error} If authentication token is missing or invalid
- * @throws {Error} If pod name is missing or invalid
- */
-export declare const resumeRuntime: (token: string, podName: string, baseUrl?: string, body?: ResumeRuntimeBody) => Promise<PauseResumeResponse>;

package/lib/api/runtimes/runtimes.js

@@ -1,230 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-/**
- * Runtime instances API functions for the Datalayer platform.
- *
- * Provides functions for managing runtime instances (active compute containers).
- *
- * @module api/runtimes/runtimes
- */
-import { requestDatalayerAPI } from '../DatalayerApi.js';
-import { API_BASE_PATHS, DEFAULT_SERVICE_URLS } from '../constants.js';
-import { validateToken, validateRequiredString } from '../utils/validation.js';
-/**
- * Create a new runtime instance.
- * @param token - Authentication token
- * @param data - Runtime creation configuration
- * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
- * @returns Promise resolving to the created runtime details
- * @throws {Error} If authentication token is missing or invalid
- * @throws {Error} With status 404 if the environment is not found
- * @throws {Error} With status 503 if no runtime is available
- */
-export const createRuntime = async (token, data, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
-    validateToken(token);
-    try {
-        return await requestDatalayerAPI({
-            url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/runtimes`,
-            method: 'POST',
-            body: data,
-            token,
-        });
-    }
-    catch (error) {
-        // Handle specific error cases
-        if (error.response) {
-            const status = error.response.status;
-            const responseData = error.response.data || {};
-            if (status === 404) {
-                // Environment not found
-                throw new Error(`Environment '${data.environment_name}' not found. ${responseData.message || 'Please check the environment name and try again.'}`);
-            }
-            else if (status === 503) {
-                // No runtime available
-                throw new Error(`No runtime available. ${responseData.message || 'The service is temporarily unavailable or at capacity. Please try again later.'}`);
-            }
-        }
-        // Re-throw the original error for other cases
-        throw error;
-    }
-};
-/**
- * List all runtime instances.
- * @param token - Authentication token
- * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
- * @returns Promise resolving to list of runtime instances
- * @throws {Error} If authentication token is missing or invalid
- */
-export const listRuntimes = async (token, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
-    validateToken(token);
-    const response = await requestDatalayerAPI({
-        url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/runtimes`,
-        method: 'GET',
-        token,
-    });
-    // The API returns { success: true, message: string, runtimes: Runtime[] }
-    // The response already has the correct structure, just return it
-    return response;
-};
-/**
- * Get details for a specific runtime instance.
- * @param token - Authentication token
- * @param podName - The unique pod name of the runtime
- * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
- * @returns Promise resolving to runtime details
- * @throws {Error} If authentication token is missing or invalid
- * @throws {Error} If pod name is missing or invalid
- * @throws {Error} With status 404 if the runtime is not found
- */
-export const getRuntime = async (token, podName, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
-    validateToken(token);
-    validateRequiredString(podName, 'Pod name');
-    try {
-        const response = await requestDatalayerAPI({
-            url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/runtimes/${podName}`,
-            method: 'GET',
-            token,
-        });
-        // The API returns { success: true, message: string, runtime: Runtime }
-        // (Previously used 'kernel' field, now uses 'runtime')
-        // Try 'runtime' field first (current API)
-        if (response.runtime) {
-            return {
-                ...response.runtime,
-                pod_name: response.runtime.pod_name || podName,
-            };
-        }
-        // Fallback to 'kernel' field (old API)
-        if (response.kernel) {
-            return {
-                ...response.kernel,
-                pod_name: response.kernel.pod_name || podName,
-            };
-        }
-        // Fallback if response structure is different
-        return response;
-    }
-    catch (error) {
-        // Handle specific error cases
-        if (error.response && error.response.status === 404) {
-            // Runtime not found
-            throw new Error(`Runtime with pod name '${podName}' not found. Please check the pod name and try again.`);
-        }
-        // Re-throw the original error for other cases
-        throw error;
-    }
-};
-/**
- * Delete a runtime instance.
- * @param token - Authentication token
- * @param podName - The unique pod name of the runtime to delete
- * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
- * @returns Promise resolving when deletion is complete
- * @throws {Error} If authentication token is missing or invalid
- * @throws {Error} If pod name is missing or invalid
- * @throws {Error} With status 404 if the runtime is not found
- */
-export const deleteRuntime = async (token, podName, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
-    validateToken(token);
-    validateRequiredString(podName, 'Pod name');
-    try {
-        return await requestDatalayerAPI({
-            url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/runtimes/${podName}`,
-            method: 'DELETE',
-            token,
-        });
-    }
-    catch (error) {
-        // Handle specific error cases
-        if (error.response && error.response.status === 404) {
-            // Runtime not found
-            throw new Error(`Runtime with pod name '${podName}' not found. Cannot delete a non-existent runtime.`);
-        }
-        // Re-throw the original error for other cases
-        throw error;
-    }
-};
-/**
- * Update a runtime instance.
- * @param token - Authentication token
- * @param podName - The unique pod name of the runtime
- * @param from - The source to update from
- * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
- * @returns Promise resolving to updated runtime details
- * @throws {Error} If authentication token is missing or invalid
- * @throws {Error} If pod name is missing or invalid
- * @throws {Error} With status 404 if the runtime is not found
- */
-export const updateRuntime = async (token, podName, from, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
-    validateToken(token);
-    validateRequiredString(podName, 'Pod name');
-    try {
-        return await requestDatalayerAPI({
-            url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/runtimes/${podName}`,
-            method: 'PUT',
-            token,
-            body: { from },
-        });
-    }
-    catch (error) {
-        // Handle specific error cases
-        if (error.response && error.response.status === 404) {
-            // Runtime not found
-            throw new Error(`Runtime with pod name '${podName}' not found. Cannot update a non-existent runtime.`);
-        }
-        // Re-throw the original error for other cases
-        throw error;
-    }
-};
-/**
- * Pause a runtime by creating a checkpoint (async, light mode by default).
- *
- * Returns immediately with a 202 Accepted response.  The actual checkpoint
- * process runs in the background.  Use the returned `checkpoint_id` to
- * poll for status via the runtime-checkpoints API.
- *
- * @param token - Authentication token
- * @param podName - The unique pod name of the runtime to pause
- * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
- * @param body - Optional metadata to store in the checkpoint record
- * @returns Promise resolving with the checkpoint ID for status tracking
- * @throws {Error} If authentication token is missing or invalid
- * @throws {Error} If pod name is missing or invalid
- */
-export const pauseRuntime = async (token, podName, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES, body) => {
-    validateToken(token);
-    validateRequiredString(podName, 'Pod name');
-    return await requestDatalayerAPI({
-        url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/runtimes/${encodeURIComponent(podName)}/pause`,
-        method: 'POST',
-        token,
-        ...(body ? { body } : {}),
-    });
-};
-/**
- * Resume a paused runtime by restoring from a checkpoint (async).
- *
- * Returns immediately with a 202 Accepted response.  The actual restore
- * process runs in the background.  Use the returned `checkpoint_id` to
- * poll for status.
- *
- * @param token - Authentication token
- * @param podName - The unique pod name of the runtime to resume
- * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
- * @param body - Optional body with agent_spec_id and restore options
- * @returns Promise resolving with the checkpoint ID for status tracking
- * @throws {Error} If authentication token is missing or invalid
- * @throws {Error} If pod name is missing or invalid
- */
-export const resumeRuntime = async (token, podName, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES, body) => {
-    validateToken(token);
-    validateRequiredString(podName, 'Pod name');
-    return await requestDatalayerAPI({
-        url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/runtimes/${encodeURIComponent(podName)}/resume`,
-        method: 'POST',
-        token,
-        ...(body ? { body } : {}),
-    });
-};

package/lib/api/runtimes/snapshots.d.ts

@@ -1,38 +0,0 @@
-import { CreateCodeSandboxSnapshotRequest, ListCodeSandboxSnapshotsResponse, GetCodeSandboxSnapshotResponse, CreateCodeSandboxSnapshotResponse } from '../../models/CodeSandboxSnapshotDTO';
-/**
- * Create a snapshot of a runtime instance.
- * @param token - Authentication token
- * @param data - Snapshot creation configuration
- * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
- * @returns Promise resolving to the created snapshot response
- * @throws {Error} If authentication token is missing or invalid
- */
-export declare const createSnapshot: (token: string, data: CreateCodeSandboxSnapshotRequest, baseUrl?: string) => Promise<CreateCodeSandboxSnapshotResponse>;
-/**
- * List all code sandbox snapshots.
- * @param token - Authentication token
- * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
- * @returns Promise resolving to list of snapshots
- * @throws {Error} If authentication token is missing or invalid
- */
-export declare const listSnapshots: (token: string, baseUrl?: string) => Promise<ListCodeSandboxSnapshotsResponse>;
-/**
- * Get details for a specific code sandbox snapshot.
- * @param token - Authentication token
- * @param snapshotId - The unique identifier of the snapshot
- * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
- * @returns Promise resolving to snapshot details wrapped in response
- * @throws {Error} If authentication token is missing or invalid
- * @throws {Error} If snapshot ID is missing or invalid
- */
-export declare const getSnapshot: (token: string, snapshotId: string, baseUrl?: string) => Promise<GetCodeSandboxSnapshotResponse>;
-/**
- * Delete a code sandbox snapshot.
- * @param token - Authentication token
- * @param snapshotId - The unique identifier of the snapshot to delete
- * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
- * @returns Promise resolving when deletion is complete
- * @throws {Error} If authentication token is missing or invalid
- * @throws {Error} If snapshot ID is missing or invalid
- */
-export declare const deleteSnapshot: (token: string, snapshotId: string, baseUrl?: string) => Promise<void>;