@datalayer/agent-runtimes 1.0.28 → 1.3.10

package/lib/client/AgentRuntimesClient.d.ts

@@ -6,6 +6,7 @@
  */
 import { DatalayerCoreClient, type DatalayerClientConfig } from '@datalayer/core/lib/client';
 import type { HealthCheck } from '@datalayer/core/lib/models/HealthCheck';
+import { type CreateRuntimeOptions } from './mixins/RuntimesMixin';
 import type { RuntimeDTO } from '../models/RuntimeDTO';
 import type { EnvironmentDTO } from '../models/EnvironmentDTO';
 import type { CodeSandboxSnapshotDTO } from '../models/CodeSandboxSnapshotDTO';
@@ -48,17 +49,17 @@ declare const AgentRuntimesClientWithMixins: {
     };
 } & {
     new (...args: any[]): {
-        _extractRuntimePodName(runtimePodNameOrInstance: string | RuntimeDTO): string;
+        _extractRuntimeName(runtimeNameOrInstance: string | RuntimeDTO): string;
         _extractSnapshotId(snapshotIdOrInstance: string | CodeSandboxSnapshotDTO): string;
         listEnvironments(): Promise<EnvironmentDTO[]>;
-        createRuntime(environmentName: string, type: "notebook" | "terminal" | "job", givenName: string, minutesLimit: number, fromSnapshotId?: string): Promise<RuntimeDTO>;
+        createRuntime(environmentNameOrOptions: string | CreateRuntimeOptions, type?: "notebook" | "terminal" | "job", givenName?: string, minutesLimit?: number, fromSnapshotId?: string): Promise<RuntimeDTO>;
         listRuntimes(): Promise<RuntimeDTO[]>;
-        getRuntime(podName: string): Promise<RuntimeDTO>;
-        deleteRuntime(podName: string): Promise<void>;
+        getRuntime(runtimeName: string): Promise<RuntimeDTO>;
+        deleteRuntime(runtimeName: string): Promise<void>;
         listRuntimeMemories(options?: ListRuntimeMemoriesOptions): Promise<RuntimeMemory[]>;
         getRuntimeMemory(memoryId: string): Promise<RuntimeMemory>;
         terminateAllRuntimes(): Promise<PromiseSettledResult<void>[]>;
-        createSnapshot(podName: string, name: string, description: string, stop?: boolean): Promise<CodeSandboxSnapshotDTO>;
+        createSnapshot(runtimeName: string, name: string, description: string, stop?: boolean): Promise<CodeSandboxSnapshotDTO>;
         listSnapshots(): Promise<CodeSandboxSnapshotDTO[]>;
         getSnapshot(id: string): Promise<CodeSandboxSnapshotDTO>;
         deleteSnapshot(id: string): Promise<void>;
@@ -87,14 +88,14 @@ export declare class AgentRuntimesClient extends AgentRuntimesClientWithMixins {
 export interface AgentRuntimesClient extends DatalayerCoreClient {
     listEnvironments(): Promise<EnvironmentDTO[]>;
     ensureRuntime(environmentName?: string, creditsLimit?: number, waitForReady?: boolean, maxWaitTime?: number, reuseExisting?: boolean, snapshotId?: string): Promise<RuntimeDTO>;
-    createRuntime(environmentName: string, type: 'notebook' | 'terminal' | 'job', givenName: string, minutesLimit: number, fromSnapshotId?: string): Promise<RuntimeDTO>;
+    createRuntime(environmentNameOrOptions: string | CreateRuntimeOptions, type?: 'notebook' | 'terminal' | 'job', givenName?: string, minutesLimit?: number, fromSnapshotId?: string): Promise<RuntimeDTO>;
     listRuntimes(): Promise<RuntimeDTO[]>;
     listRuntimeMemories(options?: ListRuntimeMemoriesOptions): Promise<RuntimeMemory[]>;
     getRuntimeMemory(memoryId: string): Promise<RuntimeMemory>;
-    getRuntime(podName: string): Promise<RuntimeDTO>;
-    deleteRuntime(podName: string): Promise<void>;
+    getRuntime(runtimeName: string): Promise<RuntimeDTO>;
+    deleteRuntime(runtimeName: string): Promise<void>;
     terminateAllRuntimes(): Promise<PromiseSettledResult<void>[]>;
-    createSnapshot(podName: string, name: string, description: string, stop?: boolean): Promise<CodeSandboxSnapshotDTO>;
+    createSnapshot(runtimeName: string, name: string, description: string, stop?: boolean): Promise<CodeSandboxSnapshotDTO>;
     listSnapshots(): Promise<CodeSandboxSnapshotDTO[]>;
     getSnapshot(id: string): Promise<CodeSandboxSnapshotDTO>;
     deleteSnapshot(id: string): Promise<void>;

package/lib/client/AgentRuntimesClient.js

@@ -9,7 +9,7 @@
  * @module client/AgentRuntimesClient
  */
 import { DatalayerCoreClient, } from '@datalayer/core/lib/client';
-import { RuntimesMixin } from './mixins/RuntimesMixin';
+import { RuntimesMixin, } from './mixins/RuntimesMixin';
 import { SpacerMixin } from './mixins/SpacerMixin';
 // Apply the runtime + content mixins on top of the core client.
 const AgentRuntimesClientWithMixins = SpacerMixin(RuntimesMixin(DatalayerCoreClient));

package/lib/client/AgentRuntimesClientContext.d.ts

@@ -11,6 +11,7 @@
  *
  * @module client/AgentRuntimesClientContext
  */
+import type { JSX } from 'react';
 import type { ReactNode } from 'react';
 import type { IAgentRuntimesClient } from './IAgentRuntimesClient';
 /** Props for {@link AgentRuntimesClientProvider}. */

package/lib/client/AgentsMixin.d.ts

@@ -23,35 +23,35 @@ export declare function AgentsMixin<TBase extends Constructor>(Base: TBase): {
         getRunningAgents(): Promise<RunningAgent[]>;
         /**
          * Get the status of a specific agent.
-         * @param podName - Pod name hosting the agent
+         * @param runtimeName - Pod name hosting the agent
          * @param agentId - Optional agent ID within the pod
          * @returns Detailed agent status
          */
-        getAgentStatus(podName: string, agentId?: string): Promise<RunningAgent>;
+        getAgentStatus(runtimeName: string, agentId?: string): Promise<RunningAgent>;
         /**
          * Pause a running agent (light checkpoint by default, CRIU optional).
-         * @param podName - Pod name hosting the agent
+         * @param runtimeName - Pod name hosting the agent
          */
-        pauseAgent(podName: string): Promise<void>;
+        pauseAgent(runtimeName: string): Promise<void>;
         /**
          * Resume a paused/checkpointed agent.
-         * @param podName - Pod name hosting the agent
+         * @param runtimeName - Pod name hosting the agent
          */
-        resumeAgent(podName: string): Promise<void>;
+        resumeAgent(runtimeName: string): Promise<void>;
         /**
          * Get conversation checkpoints for an agent.
-         * @param podName - Pod name
+         * @param runtimeName - Pod name
          * @param agentId - Optional agent ID
          * @returns Array of checkpoints
          */
-        getAgentCheckpoints(podName: string, agentId?: string): Promise<ConversationCheckpoint[]>;
+        getAgentCheckpoints(runtimeName: string, agentId?: string): Promise<ConversationCheckpoint[]>;
         /**
          * Get usage summary for an agent.
-         * @param podName - Pod name
+         * @param runtimeName - Pod name
          * @param agentId - Optional agent ID
          * @returns Usage summary including tokens, cost, iterations
          */
-        getAgentUsage(podName: string, agentId?: string): Promise<AgentUsageSummary>;
+        getAgentUsage(runtimeName: string, agentId?: string): Promise<AgentUsageSummary>;
         /**
          * List notifications, optionally filtered.
          * @param filters - Optional filters (level, read status)
@@ -169,12 +169,12 @@ export declare function AgentsMixin<TBase extends Constructor>(Base: TBase): {
         /**
          * Assign an agent runtime to a project.
          * @param projectUid - Project UID.
-         * @param agentPodName - Agent runtime pod name.
+         * @param agentRuntimeName - Agent runtime pod name.
          * @param agentSpecId - Agent spec ID.
          * @param agentGivenName - Human-readable runtime name.
          * @returns Updated project.
          */
-        assignAgentToProject(projectUid: string, agentPodName: string, agentSpecId?: string, agentGivenName?: string): Promise<any>;
+        assignAgentToProject(projectUid: string, agentRuntimeName: string, agentSpecId?: string, agentGivenName?: string): Promise<any>;
         /**
          * Remove the agent assignment from a project.
          * @param projectUid - Project UID.

package/lib/client/AgentsMixin.js

@@ -10,6 +10,7 @@ import * as evals from '../api/evals';
 import * as context from '../api/context';
 import * as agentspecs from '../specs/agents';
 import { requestDatalayerAPI } from '@datalayer/core/lib/api/DatalayerApi';
+import { runtimesUrl as runtimesApiUrl } from '../runtimes/lifecycle';
 /** Agents mixin providing durable agent management. */
 export function AgentsMixin(Base) {
     return class extends Base {
@@ -27,54 +28,54 @@ export function AgentsMixin(Base) {
         }
         /**
          * Get the status of a specific agent.
-         * @param podName - Pod name hosting the agent
+         * @param runtimeName - Pod name hosting the agent
          * @param agentId - Optional agent ID within the pod
          * @returns Detailed agent status
          */
-        async getAgentStatus(podName, agentId) {
+        async getAgentStatus(runtimeName, agentId) {
             const token = this.getToken();
             const baseUrl = this.getIamUrl();
-            return agents.getAgentStatus(token, podName, agentId, baseUrl);
+            return agents.getAgentStatus(token, runtimeName, agentId, baseUrl);
         }
         /**
          * Pause a running agent (light checkpoint by default, CRIU optional).
-         * @param podName - Pod name hosting the agent
+         * @param runtimeName - Pod name hosting the agent
          */
-        async pauseAgent(podName) {
+        async pauseAgent(runtimeName) {
             const token = this.getToken();
             const baseUrl = this.getIamUrl();
-            return agents.pauseAgent(token, podName, baseUrl);
+            return agents.pauseAgent(token, runtimeName, baseUrl);
         }
         /**
          * Resume a paused/checkpointed agent.
-         * @param podName - Pod name hosting the agent
+         * @param runtimeName - Pod name hosting the agent
          */
-        async resumeAgent(podName) {
+        async resumeAgent(runtimeName) {
             const token = this.getToken();
             const baseUrl = this.getIamUrl();
-            return agents.resumeAgent(token, podName, baseUrl);
+            return agents.resumeAgent(token, runtimeName, baseUrl);
         }
         /**
          * Get conversation checkpoints for an agent.
-         * @param podName - Pod name
+         * @param runtimeName - Pod name
          * @param agentId - Optional agent ID
          * @returns Array of checkpoints
          */
-        async getAgentCheckpoints(podName, agentId) {
+        async getAgentCheckpoints(runtimeName, agentId) {
             const token = this.getToken();
             const baseUrl = this.getIamUrl();
-            return agents.getAgentCheckpoints(token, podName, agentId, baseUrl);
+            return agents.getAgentCheckpoints(token, runtimeName, agentId, baseUrl);
         }
         /**
          * Get usage summary for an agent.
-         * @param podName - Pod name
+         * @param runtimeName - Pod name
          * @param agentId - Optional agent ID
          * @returns Usage summary including tokens, cost, iterations
          */
-        async getAgentUsage(podName, agentId) {
+        async getAgentUsage(runtimeName, agentId) {
             const token = this.getToken();
             const baseUrl = this.getIamUrl();
-            return agents.getAgentUsage(token, podName, agentId, baseUrl);
+            return agents.getAgentUsage(token, runtimeName, agentId, baseUrl);
         }
         // ========================================================================
         // Tool Approvals
@@ -254,7 +255,7 @@ export function AgentsMixin(Base) {
             return context.getCostUsage(token, agentId, baseUrl);
         }
         // ========================================================================
-        // Agent Specs
+        // Agentspecs
         // ========================================================================
         /**
          * Get an agent specification by ID.
@@ -286,18 +287,18 @@ export function AgentsMixin(Base) {
         /**
          * Assign an agent runtime to a project.
          * @param projectUid - Project UID.
-         * @param agentPodName - Agent runtime pod name.
+         * @param agentRuntimeName - Agent runtime pod name.
          * @param agentSpecId - Agent spec ID.
          * @param agentGivenName - Human-readable runtime name.
          * @returns Updated project.
          */
-        async assignAgentToProject(projectUid, agentPodName, agentSpecId, agentGivenName) {
+        async assignAgentToProject(projectUid, agentRuntimeName, agentSpecId, agentGivenName) {
             // Backend requires name and description on every update
             const project = await this.getProject(projectUid);
             return this.updateProject(projectUid, {
                 name: project.name,
                 description: project.description,
-                attached_agent_pod_name_s: agentPodName,
+                attached_agent_runtime_name_s: agentRuntimeName,
                 attached_agent_spec_id_s: agentSpecId || '',
                 attached_agent_given_name_s: agentGivenName || '',
             });
@@ -313,7 +314,7 @@ export function AgentsMixin(Base) {
             return this.updateProject(projectUid, {
                 name: project.name,
                 description: project.description,
-                attached_agent_pod_name_s: '',
+                attached_agent_runtime_name_s: '',
                 attached_agent_spec_id_s: '',
                 attached_agent_given_name_s: '',
             });
@@ -329,13 +330,11 @@ export function AgentsMixin(Base) {
         async createAgentRuntime(data) {
             const token = this.getToken();
             const runtimesUrl = this.getRuntimesUrl();
-            const normalizedVolumeUids = Array.isArray(data.volumeUids)
-                ? data.volumeUids.map(uid => String(uid || '').trim()).filter(Boolean)
-                : data.volumeUid
-                    ? [String(data.volumeUid).trim()]
-                    : [];
+            const contentAttachmentUids = (data.contentAttachmentUids ?? [])
+                .map(uid => String(uid || '').trim())
+                .filter(Boolean);
             return requestDatalayerAPI({
-                url: `${runtimesUrl}/api/runtimes/v1/runtimes`,
+                url: runtimesApiUrl(runtimesUrl),
                 method: 'POST',
                 token,
                 body: {
@@ -355,9 +354,10 @@ export function AgentsMixin(Base) {
                     billing_entity_handle: data.billingEntityHandle || undefined,
                     billing_source_organization_uid: data.billingSourceOrganizationUid || undefined,
                     billing_source_organization_handle: data.billingSourceOrganizationHandle || undefined,
-                    mount_home_folder: data.mountHomeFolder ?? false,
-                    volume_uids: normalizedVolumeUids.length > 0 ? normalizedVolumeUids : undefined,
-                    volume_uid: normalizedVolumeUids[0] || data.volumeUid || undefined,
+                    runtime_name: data.runtimeName || undefined,
+                    content_attachment_uids: contentAttachmentUids.length
+                        ? contentAttachmentUids
+                        : undefined,
                 },
             });
         }
@@ -370,9 +370,9 @@ export function AgentsMixin(Base) {
         async createAgentRuntimeForProject(projectUid, data) {
             const response = await this.createAgentRuntime(data);
             if (response.success && response.runtime) {
-                const podName = response.runtime.pod_name;
+                const runtimeName = response.runtime.runtime_name;
                 const givenName = response.runtime.given_name || data.givenName || data.agentSpecId;
-                await this.assignAgentToProject(projectUid, podName, data.agentSpecId, givenName);
+                await this.assignAgentToProject(projectUid, runtimeName, data.agentSpecId, givenName);
             }
             return response;
         }

package/lib/client/IAgentRuntimesClient.d.ts

@@ -42,42 +42,42 @@ export interface IAgentRuntimesClient {
     /**
      * Retrieves the detailed status of a specific running agent.
      *
-     * @param podName - Pod name hosting the agent.
+     * @param runtimeName - Pod name hosting the agent.
      * @param agentId - Optional agent ID within the pod (for multi-agent pods).
      *
      * @returns The agent's current status record.
      */
-    getAgentStatus(podName: string, agentId?: string): Promise<RunningAgent>;
+    getAgentStatus(runtimeName: string, agentId?: string): Promise<RunningAgent>;
     /**
      * Pauses a running agent (light checkpoint by default).
      *
-     * @param podName - Pod name hosting the agent.
+     * @param runtimeName - Pod name hosting the agent.
      */
-    pauseAgent(podName: string): Promise<void>;
+    pauseAgent(runtimeName: string): Promise<void>;
     /**
      * Resumes a previously paused / checkpointed agent.
      *
-     * @param podName - Pod name hosting the agent.
+     * @param runtimeName - Pod name hosting the agent.
      */
-    resumeAgent(podName: string): Promise<void>;
+    resumeAgent(runtimeName: string): Promise<void>;
     /**
      * Lists conversation checkpoints for an agent.
      *
-     * @param podName - Pod name hosting the agent.
+     * @param runtimeName - Pod name hosting the agent.
      * @param agentId - Optional agent ID within the pod.
      *
      * @returns Array of conversation checkpoints.
      */
-    getAgentCheckpoints(podName: string, agentId?: string): Promise<ConversationCheckpoint[]>;
+    getAgentCheckpoints(runtimeName: string, agentId?: string): Promise<ConversationCheckpoint[]>;
     /**
      * Retrieves the token and cost usage summary for an agent.
      *
-     * @param podName - Pod name hosting the agent.
+     * @param runtimeName - Pod name hosting the agent.
      * @param agentId - Optional agent ID within the pod.
      *
      * @returns Aggregated usage totals.
      */
-    getAgentUsage(podName: string, agentId?: string): Promise<AgentUsageSummary>;
+    getAgentUsage(runtimeName: string, agentId?: string): Promise<AgentUsageSummary>;
     /**
      * Lists agent notifications, optionally filtered by level or read status.
      *

package/lib/client/SdkAgentRuntimesClient.d.ts

@@ -23,15 +23,15 @@ export interface AgentsSdkLike {
     /** Lists every running agent across runtimes the caller can see. */
     getRunningAgents(): Promise<RunningAgent[]>;
     /** Retrieves the detailed status of a specific running agent. */
-    getAgentStatus(podName: string, agentId?: string): Promise<RunningAgent>;
+    getAgentStatus(runtimeName: string, agentId?: string): Promise<RunningAgent>;
     /** Pauses a running agent. */
-    pauseAgent(podName: string): Promise<void>;
+    pauseAgent(runtimeName: string): Promise<void>;
     /** Resumes a previously paused agent. */
-    resumeAgent(podName: string): Promise<void>;
+    resumeAgent(runtimeName: string): Promise<void>;
     /** Lists conversation checkpoints for an agent. */
-    getAgentCheckpoints(podName: string, agentId?: string): Promise<ConversationCheckpoint[]>;
+    getAgentCheckpoints(runtimeName: string, agentId?: string): Promise<ConversationCheckpoint[]>;
     /** Retrieves the token and cost usage summary for an agent. */
-    getAgentUsage(podName: string, agentId?: string): Promise<AgentUsageSummary>;
+    getAgentUsage(runtimeName: string, agentId?: string): Promise<AgentUsageSummary>;
     /** Lists agent notifications with optional filters. */
     getNotifications(filters?: NotificationFilters): Promise<AgentNotification[]>;
     /** Marks a single notification as read. */
@@ -104,15 +104,15 @@ export declare class SdkAgentRuntimesClient implements IAgentRuntimesClient {
     /** @inheritdoc */
     listRunningAgents(): Promise<RunningAgent[]>;
     /** @inheritdoc */
-    getAgentStatus(podName: string, agentId?: string): Promise<RunningAgent>;
+    getAgentStatus(runtimeName: string, agentId?: string): Promise<RunningAgent>;
     /** @inheritdoc */
-    pauseAgent(podName: string): Promise<void>;
+    pauseAgent(runtimeName: string): Promise<void>;
     /** @inheritdoc */
-    resumeAgent(podName: string): Promise<void>;
+    resumeAgent(runtimeName: string): Promise<void>;
     /** @inheritdoc */
-    getAgentCheckpoints(podName: string, agentId?: string): Promise<ConversationCheckpoint[]>;
+    getAgentCheckpoints(runtimeName: string, agentId?: string): Promise<ConversationCheckpoint[]>;
     /** @inheritdoc */
-    getAgentUsage(podName: string, agentId?: string): Promise<AgentUsageSummary>;
+    getAgentUsage(runtimeName: string, agentId?: string): Promise<AgentUsageSummary>;
     /** @inheritdoc */
     listNotifications(filters?: NotificationFilters): Promise<AgentNotification[]>;
     /** @inheritdoc */

package/lib/client/SdkAgentRuntimesClient.js

@@ -48,24 +48,24 @@ export class SdkAgentRuntimesClient {
         return this.requireSdk().getRunningAgents();
     }
     /** @inheritdoc */
-    async getAgentStatus(podName, agentId) {
-        return this.requireSdk().getAgentStatus(podName, agentId);
+    async getAgentStatus(runtimeName, agentId) {
+        return this.requireSdk().getAgentStatus(runtimeName, agentId);
     }
     /** @inheritdoc */
-    async pauseAgent(podName) {
-        return this.requireSdk().pauseAgent(podName);
+    async pauseAgent(runtimeName) {
+        return this.requireSdk().pauseAgent(runtimeName);
     }
     /** @inheritdoc */
-    async resumeAgent(podName) {
-        return this.requireSdk().resumeAgent(podName);
+    async resumeAgent(runtimeName) {
+        return this.requireSdk().resumeAgent(runtimeName);
     }
     /** @inheritdoc */
-    async getAgentCheckpoints(podName, agentId) {
-        return this.requireSdk().getAgentCheckpoints(podName, agentId);
+    async getAgentCheckpoints(runtimeName, agentId) {
+        return this.requireSdk().getAgentCheckpoints(runtimeName, agentId);
     }
     /** @inheritdoc */
-    async getAgentUsage(podName, agentId) {
-        return this.requireSdk().getAgentUsage(podName, agentId);
+    async getAgentUsage(runtimeName, agentId) {
+        return this.requireSdk().getAgentUsage(runtimeName, agentId);
     }
     /** @inheritdoc */
     async listNotifications(filters) {

package/lib/client/mixins/RuntimesMixin.d.ts

@@ -4,6 +4,27 @@ import { EnvironmentDTO } from '../../models/EnvironmentDTO';
 import { RuntimeDTO } from '../../models/RuntimeDTO';
 import { CodeSandboxSnapshotDTO } from '../../models/CodeSandboxSnapshotDTO';
 import { HealthCheck } from '@datalayer/core/lib/models/HealthCheck';
+/** What creating a runtime is asked for, when it is asked with an object. */
+export interface CreateRuntimeOptions {
+    /**
+     * A platform environment by its name, or an environment somebody built,
+     * named `<account-handle>/<name>` or by its uid (PLAN_ENV.md, D-2).
+     */
+    environmentName: string;
+    /**
+     * Which version of a user environment to launch: its number, or a version
+     * uid. Absent means the version its owner promoted (E1-19).
+     */
+    environmentVersion?: number | string;
+    /** Type of runtime */
+    type?: 'notebook' | 'terminal' | 'job';
+    /** User-friendly name for the runtime */
+    givenName?: string;
+    /** How long to reserve, in minutes */
+    minutesLimit?: number;
+    /** Snapshot to restore into the runtime */
+    fromSnapshotId?: string;
+}
 /** Options for ensuring a runtime is available. */
 export interface EnsureRuntimeOptions {
     /** Name of the environment to use */
@@ -22,7 +43,7 @@ export interface EnsureRuntimeOptions {
 /** Runtimes mixin providing computational environment and runtime management. */
 export declare function RuntimesMixin<TBase extends Constructor>(Base: TBase): {
     new (...args: any[]): {
-        _extractRuntimePodName(runtimePodNameOrInstance: string | RuntimeDTO): string;
+        _extractRuntimeName(runtimeNameOrInstance: string | RuntimeDTO): string;
         _extractSnapshotId(snapshotIdOrInstance: string | CodeSandboxSnapshotDTO): string;
         /**
          * List all available computational environments.
@@ -31,13 +52,19 @@ export declare function RuntimesMixin<TBase extends Constructor>(Base: TBase): {
         listEnvironments(): Promise<EnvironmentDTO[]>;
         /**
          * Create a new computational runtime.
-         * @param environmentName - Name of the environment to use
+         *
+         * Asked either with an options object — which is the only way to pin a
+         * version of a user environment (E1-19) — or with the positional arguments
+         * every caller used before there were versions.
+         *
+         * @param environmentNameOrOptions - The environment's name, or the options
          * @param type - Type of runtime
          * @param givenName - User-friendly name for the runtime
-         * @param creditsLimit - Credits limit
+         * @param minutesLimit - How long to reserve, in minutes
+         * @param fromSnapshotId - Snapshot to restore
          * @returns Created runtime
          */
-        createRuntime(environmentName: string, type: "notebook" | "terminal" | "job", givenName: string, minutesLimit: number, fromSnapshotId?: string): Promise<RuntimeDTO>;
+        createRuntime(environmentNameOrOptions: string | CreateRuntimeOptions, type?: "notebook" | "terminal" | "job", givenName?: string, minutesLimit?: number, fromSnapshotId?: string): Promise<RuntimeDTO>;
         /**
          * List all runtimes.
          * @returns Array of runtimes
@@ -45,15 +72,15 @@ export declare function RuntimesMixin<TBase extends Constructor>(Base: TBase): {
         listRuntimes(): Promise<RuntimeDTO[]>;
         /**
          * Get details for a specific runtime by pod name.
-         * @param podName - Runtime pod name
+         * @param runtimeName - Runtime pod name
          * @returns Runtime details
          */
-        getRuntime(podName: string): Promise<RuntimeDTO>;
+        getRuntime(runtimeName: string): Promise<RuntimeDTO>;
         /**
          * Delete a runtime permanently.
-         * @param podName - Runtime pod name
+         * @param runtimeName - Runtime pod name
          */
-        deleteRuntime(podName: string): Promise<void>;
+        deleteRuntime(runtimeName: string): Promise<void>;
         /**
          * List persisted memories for the authenticated caller.
          *
@@ -73,13 +100,13 @@ export declare function RuntimesMixin<TBase extends Constructor>(Base: TBase): {
         terminateAllRuntimes(): Promise<PromiseSettledResult<void>[]>;
         /**
          * Create a snapshot of a runtime.
-         * @param podName - Pod name of the runtime to snapshot
+         * @param runtimeName - Pod name of the runtime to snapshot
          * @param name - Name for the snapshot
          * @param description - Description of the snapshot
          * @param stop - Whether to stop the runtime after creating snapshot (defaults to false)
          * @returns Created snapshot
          */
-        createSnapshot(podName: string, name: string, description: string, stop?: boolean): Promise<CodeSandboxSnapshotDTO>;
+        createSnapshot(runtimeName: string, name: string, description: string, stop?: boolean): Promise<CodeSandboxSnapshotDTO>;
         /**
          * List all code sandbox snapshots.
          * @returns Array of snapshots