@datalayer/agent-runtimes 1.0.28 → 1.3.10

package/lib/models/Exercise.d.ts

@@ -1,4 +1,3 @@
-import { IDataset } from './Dataset';
 import { IItem } from './Item';
 export type ICode = string;
 export type IHelp = string;
@@ -9,7 +8,6 @@ export type IExercise = IItem & {
     codeSolution: ICode;
     codeQuestion: ICode;
     codeTest: ICode;
-    datasets: Array<IDataset>;
     lastUpdateDate?: Date;
     lastPublicationDate?: Date;
 };

package/lib/models/Library.d.ts

@@ -1,10 +1,8 @@
 import { IExercise } from './Exercise';
-import { IDataset } from './Dataset';
 export type LibraryType = 'public' | 'private';
 export type Library = {
     id: string;
     type: LibraryType;
     exercises: Array<IExercise>;
-    datasets: Array<IDataset>;
 };
 export default Library;

package/lib/models/Notebook.d.ts

@@ -1,9 +1,7 @@
 import { INotebookContent } from '@jupyterlab/nbformat';
 import { IItem } from './Item';
-import { IDataset } from './Dataset';
 export type IBaseNotebook = IItem & {
     nbformat?: INotebookContent;
-    datasets: Array<IDataset>;
 };
 export type INotebook = IBaseNotebook & {
     type: 'notebook';

package/lib/models/ProjectDTO.d.ts

@@ -20,7 +20,7 @@ export interface ProjectJSON {
     variant: string;
     isPublic: boolean;
     createdAt: string;
-    attachedAgentPodName: string | null;
+    attachedAgentRuntimeName: string | null;
     attachedAgentSpecId: string | null;
     attachedAgentGivenName: string | null;
     hasAgent: boolean;
@@ -65,7 +65,7 @@ export declare class ProjectDTO {
     /** Creation date (stable across calls). */
     get createdAt(): Date;
     /** Attached agent runtime pod name, if any. */
-    get attachedAgentPodName(): string | undefined;
+    get attachedAgentRuntimeName(): string | undefined;
     /** Attached agentspec ID (e.g., 'data-acquisition'), if any. */
     get attachedAgentSpecId(): string | undefined;
     /** Human-readable name of the attached agent runtime, if any. */

package/lib/models/ProjectDTO.js

@@ -65,9 +65,9 @@ export class ProjectDTO {
         return this._createdAt;
     }
     /** Attached agent runtime pod name, if any. */
-    get attachedAgentPodName() {
+    get attachedAgentRuntimeName() {
         this._checkDeleted();
-        return this._data.attached_agent_pod_name_s || undefined;
+        return this._data.attached_agent_runtime_name_s || undefined;
     }
     /** Attached agentspec ID (e.g., 'data-acquisition'), if any. */
     get attachedAgentSpecId() {
@@ -82,7 +82,7 @@ export class ProjectDTO {
     /** Whether an agent is currently attached to this project. */
     get hasAgent() {
         this._checkDeleted();
-        return !!this._data.attached_agent_pod_name_s;
+        return !!this._data.attached_agent_runtime_name_s;
     }
     /** Mark this project as deleted. */
     markDeleted() {
@@ -107,7 +107,7 @@ export class ProjectDTO {
             variant: this.variant,
             isPublic: this.isPublic,
             createdAt: this.createdAt.toISOString(),
-            attachedAgentPodName: this.attachedAgentPodName ?? null,
+            attachedAgentRuntimeName: this.attachedAgentRuntimeName ?? null,
             attachedAgentSpecId: this.attachedAgentSpecId ?? null,
             attachedAgentGivenName: this.attachedAgentGivenName ?? null,
             hasAgent: this.hasAgent,

package/lib/models/Runtime.d.ts

@@ -19,17 +19,17 @@ export type IRuntimeLocation = 'browser' | 'local' | string;
 /**
  * A live runtime.
  *
- * Composition of the control-plane runtime pod ({@link IRuntimePod}) and the
+ * Composition of the control-plane runtime pod ({@link IRuntimeRecord}) and the
  * JupyterLab kernel model ({@link Kernel.IModel}, e.g. `id`, `name`,
  * `execution_state`). This is the canonical shape used across the app once a
- * pod has an attached kernel: `IRuntimePod` supplies the pod/control-plane
+ * pod has an attached kernel: `IRuntimeRecord` supplies the pod/control-plane
  * fields (snake_case) and `Kernel.IModel` supplies the live kernel fields.
  *
  * Note on identity: `Kernel.IModel.id` is the *kernel* id (only present once a
- * kernel is attached), while {@link IRuntimePod.uid} is the stable *pod* id.
+ * kernel is attached), while {@link IRuntimeRecord.uid} is the stable *pod* id.
  * Prefer `uid` for pod identity and `id` for kernel identity.
  */
-export interface IRuntimeModel extends IRuntimePod, Kernel.IModel {
+export interface IRuntimeModel extends IRuntimeRecord, Kernel.IModel {
 }
 export interface IRuntimeEnvironment {
     name: string;
@@ -51,7 +51,7 @@ export interface IRuntimeEnvironment {
  * location-agnostic UI descriptor used by pickers/launchers - do not merge the
  * two (see `IRuntimeDesc`).
  */
-export interface IRuntimePod {
+export interface IRuntimeRecord {
     /**
      * Stable runtime pod identifier (ULID) assigned by the control-plane.
      *
@@ -64,7 +64,7 @@ export interface IRuntimePod {
     /**
      * Runtime name
      */
-    pod_name: string;
+    runtime_name: string;
     /**
      * Runtime ingress URL
      */
@@ -104,12 +104,12 @@ export interface IRuntimePod {
  * A lightweight, camelCase, location-agnostic descriptor used by the runtime
  * pickers/launchers to describe a *desired or selected* runtime across all
  * locations (browser / local / remote). It is intentionally kept separate from
- * {@link IRuntimePod}:
+ * {@link IRuntimeRecord}:
  *  - naming: camelCase (UI) vs snake_case (backend transport);
  *  - scope: spans all {@link IRuntimeLocation}s vs remote pod only;
  *  - lifecycle: a selection/description (may not exist yet) vs a concrete
  *    running pod.
- * Map between the two at the boundary (e.g. `podName` <-> `pod_name`,
+ * Map between the two at the boundary (e.g. `runtimeName` <-> `runtime_name`,
  * `burningRate` <-> `burning_rate`) rather than merging them.
  */
 export interface IRuntimeDesc {
@@ -146,9 +146,9 @@ export interface IRuntimeDesc {
      */
     burningRate?: number;
     /**
-     * Runtime Pod name (if applicable).
+     * The runtime's name, which is its uid (if applicable).
      */
-    podName?: string;
+    runtimeName?: string;
 }
 /**
  * Runtime type.
@@ -159,4 +159,4 @@ export type IRuntimeType = 'notebook' | 'cell';
 /**
  * Runtime optional capabilities.
  */
-export type IRuntimeCapabilities = 'user_storage';
+export type IRuntimeCapabilities = 'home-folder';

package/lib/models/RuntimeDTO.d.ts

@@ -1,14 +1,14 @@
 import type { AgentRuntimesClient as DatalayerClient } from '../client/AgentRuntimesClient';
 import { CodeSandboxSnapshotDTO } from './CodeSandboxSnapshotDTO';
-import type { IRuntimePod } from './Runtime';
+import type { IRuntimeRecord } from './Runtime';
 /**
  * Represents a running instance of a computing environment.
  *
- * Alias of the canonical {@link IRuntimePod} (see `Runtime.ts`) so the raw
+ * Alias of the canonical {@link IRuntimeRecord} (see `Runtime.ts`) so the raw
  * snake_case pod payload is defined in a single place. Kept as a named export
  * for the Datalayer Client's public API surface.
  */
-export type RuntimeData = IRuntimePod;
+export type RuntimeData = IRuntimeRecord;
 /**
  * Stable public interface for Runtime data.
  * This is the contract that Client consumers can rely on.
@@ -17,8 +17,8 @@ export type RuntimeData = IRuntimePod;
 export interface RuntimeJSON {
     /** ulid for the runtime */
     uid: string;
-    /** Kubernetes pod name for the runtime instance */
-    podName: string;
+    /** The runtime's name, which is its uid; the Pod is called by it. */
+    runtimeName: string;
     /** User-friendly name for the runtime */
     givenName: string;
     /** Name of the environment this runtime is based on */
@@ -45,7 +45,16 @@ export interface RuntimeJSON {
 export interface CreateRuntimeRequest {
     /** Runtime environment to use */
     environment: {
+        /**
+         * A platform environment by its name, or a user environment as
+         * `<account-handle>/<name>` or by its uid (PLAN_ENV.md, D-2).
+         */
         name: string;
+        /**
+         * Which version of a user environment: its number, or a version uid.
+         * Absent means the promoted version (E1-19).
+         */
+        version?: number | string;
     };
     /** Type of runtime (e.g., 'notebook', 'terminal', 'job') */
     type?: 'notebook' | 'terminal' | 'job';
@@ -109,8 +118,8 @@ export declare class RuntimeDTO {
      * @throws Error if deleted
      */
     private _checkDeleted;
-    /** Kubernetes pod name for the runtime instance. */
-    get podName(): string;
+    /** The runtime's name, which is its uid; the Pod is called by it. */
+    get runtimeName(): string;
     /** Unique identifier for the runtime. */
     get uid(): string;
     /** Name of the environment this runtime is based on. */

package/lib/models/RuntimeDTO.js

@@ -43,16 +43,16 @@ export class RuntimeDTO {
      */
     _checkDeleted() {
         if (this._deleted) {
-            throw new Error(`Runtime ${this._data.pod_name} has been deleted and no longer exists`);
+            throw new Error(`Runtime ${this._data.runtime_name} has been deleted and no longer exists`);
         }
     }
     // ========================================================================
     // Static Properties (set at creation, never change)
     // ========================================================================
-    /** Kubernetes pod name for the runtime instance. */
-    get podName() {
+    /** The runtime's name, which is its uid; the Pod is called by it. */
+    get runtimeName() {
         this._checkDeleted();
-        return this._data.pod_name;
+        return this._data.runtime_name;
     }
     /** Unique identifier for the runtime. */
     get uid() {
@@ -112,7 +112,7 @@ export class RuntimeDTO {
      * After deletion, subsequent calls to dynamic methods will throw errors.
      */
     async delete() {
-        await this._client.deleteRuntime(this.podName);
+        await this._client.deleteRuntime(this.runtimeName);
         this._deleted = true;
     }
     /**
@@ -123,7 +123,7 @@ export class RuntimeDTO {
      */
     async update(from) {
         this._checkDeleted();
-        const updated = await updateRuntime(this._client.getToken(), this.podName, from, this._client.getRuntimesUrl());
+        const updated = await updateRuntime(this._client.getToken(), this.runtimeName, from, this._client.getRuntimesUrl());
         return new RuntimeDTO(updated, this._client);
     }
     /**
@@ -136,7 +136,7 @@ export class RuntimeDTO {
      */
     async createSnapshot(name, description, stop) {
         this._checkDeleted();
-        return await this._client.createSnapshot(this.podName, name, description, stop);
+        return await this._client.createSnapshot(this.runtimeName, name, description, stop);
     }
     // ========================================================================
     // Utility Methods
@@ -165,7 +165,7 @@ export class RuntimeDTO {
         const obj = {
             // Core identifiers
             uid: this.uid,
-            podName: this.podName,
+            runtimeName: this.runtimeName,
             givenName: this.givenName,
             // Environment info
             environmentName: this.environmentName,
@@ -199,6 +199,6 @@ export class RuntimeDTO {
     /** String representation of the runtime. */
     toString() {
         this._checkDeleted();
-        return `Runtime(${this.podName}, ${this.environmentName})`;
+        return `Runtime(${this.runtimeName}, ${this.environmentName})`;
     }
 }

package/lib/models/Space.d.ts

@@ -19,6 +19,16 @@ export type IBaseSpace = {
     variant: ISpaceVariant;
     name: string;
     description: string;
+    /**
+     * The words its owner filed it under.
+     *
+     * Present on every space the API answers with — the mapper reads `tags_ss`
+     * — and searched for by the library, which is what makes them worth
+     * setting. They were missing from this type rather than from the data, so
+     * the publish dialog could not be handed a course's own tags without a
+     * cast, and would have offered to replace them with nothing.
+     */
+    tags?: string[];
     creationDate: Date;
     public: boolean;
     owner: IUser;

package/lib/models/Space.js

@@ -59,7 +59,7 @@ export const asSpace = (raw_space) => {
             : undefined,
         sharedOwnerUserUids,
         // Preserve raw Solr fields so consumers can access dynamic fields
-        // (e.g. attached_agent_pod_name_s for project-agent assignment)
+        // (e.g. attached_agent_runtime_name_s for project-agent assignment)
         ...raw_space,
     };
     return space;

package/lib/models/SpaceDTO.d.ts

@@ -18,7 +18,7 @@ export interface SpaceData {
     items?: any[];
     public_b?: boolean;
     creation_ts_dt?: string;
-    attached_agent_pod_name_s?: string;
+    attached_agent_runtime_name_s?: string;
     attached_agent_spec_id_s?: string;
     attached_agent_given_name_s?: string;
     shared_owner_user_uids_ss?: string[];

package/lib/models/SpaceItem.d.ts

@@ -1,10 +1,9 @@
 import { INotebook } from './Notebook';
 import { IDocument } from './Document';
 import { ICell } from './Cell';
-import { IDataset } from './Dataset';
 import { IEnvironment } from './Environment';
 import { ILesson } from './Lesson';
 import { IExercise } from './Exercise';
 import { IAssignment } from './Assignment';
-export type ISpaceItem = IDataset | INotebook | ICell | IEnvironment | ILesson | IExercise | IAssignment | IDocument;
+export type ISpaceItem = INotebook | ICell | IEnvironment | ILesson | IExercise | IAssignment | IDocument;
 export default ISpaceItem;

package/lib/models/environments.generated.d.ts

@@ -0,0 +1,113 @@
+/** The `$id` of the JSON Schema these types are generated from. */
+export declare const ENVIRONMENT_SCHEMA_ID = "https://datalayer.io/schemas/environments/v1alpha1/environment.json";
+/** The sha256 of the schema text these types are generated from. */
+export declare const ENVIRONMENT_SCHEMA_SHA256 = "76eb8c80d1e27f7c6519946a6f7022b53a717ff2645d993b34aaa54dea658201";
+/** The `apiVersion` an Environment document carries. */
+export declare const ENVIRONMENT_API_VERSION = "environments.datalayer.io/v1alpha1";
+/** The `kind` an Environment document carries. */
+export declare const ENVIRONMENT_KIND = "Environment";
+export interface Accelerator {
+    /** Minimum: 1. Default: `1`. */
+    count?: number;
+    cuda?: string | null;
+    type: string;
+}
+export interface Base {
+    channel: string;
+    ref: string;
+}
+export interface BuildSecret {
+    /** Pattern: `^dlsec_[0-9A-Za-z]+$`. */
+    id: string;
+    /** Default: `"env"`. */
+    mountAs?: 'env' | 'file';
+    /** Pattern: `^[A-Za-z0-9_.-]+$`. */
+    name: string;
+}
+export interface BuildSpec {
+    /** Default: `"packages"`. */
+    source?: 'packages' | 'dependencyFile' | 'dockerfile' | 'image';
+}
+export interface Commands {
+    postInstall?: string[];
+}
+export interface Compatibility {
+    regions?: string[];
+    variants?: VariantSet;
+}
+export interface EnvironmentSpec {
+    base: Base;
+    build?: BuildSpec;
+    buildSecrets?: BuildSecret[];
+    commands?: Commands;
+    compatibility?: Compatibility;
+    /** Default: `"sandbox-contract/v1"`. */
+    contract?: string;
+    env?: Record<string, string>;
+    files?: FileEntry[];
+    language: Language;
+    packages?: Packages;
+    platform?: Platform;
+    resources?: Resources;
+}
+export interface FileEntry {
+    contentRef: string;
+    path: string;
+    /** Pattern: `^[0-9a-f]{64}$`. */
+    sha256?: string | null;
+    /** Minimum: 0. */
+    sizeBytes?: number | null;
+}
+export interface Language {
+    name?: 'python';
+    /** Pattern: `^3\.\d+$`. */
+    version: string;
+}
+export interface Metadata {
+    labels?: Record<string, string>;
+    name: string;
+    title?: string | null;
+}
+export interface Packages {
+    python?: PythonPackages;
+    system?: SystemPackages;
+}
+export interface Platform {
+    architecture?: 'linux/amd64';
+}
+export interface PythonPackages {
+    constraints?: string[];
+    dependencies?: string[];
+    indexes?: string[];
+    /** Default: `"uv"`. */
+    manager?: 'uv' | 'pip' | 'conda';
+}
+export interface ResourceHints {
+    /** Greater than 0. */
+    cpu?: number | null;
+    /** Greater than 0. */
+    diskGi?: number | null;
+    /** Greater than 0. */
+    memoryGi?: number | null;
+}
+export interface Resources {
+    /** Default: `"none"`. */
+    accelerator?: 'none' | Accelerator;
+    hints?: ResourceHints;
+    /** Default: `"small"`. */
+    sizeClass?: string;
+}
+export interface SystemPackages {
+    apt?: string[];
+}
+export interface VariantSet {
+    optional?: string[];
+    required?: string[];
+}
+/** A Datalayer Environment, environments.datalayer.io/v1alpha1. */
+export interface Environment {
+    apiVersion?: 'environments.datalayer.io/v1alpha1';
+    kind?: 'Environment';
+    metadata: Metadata;
+    spec: EnvironmentSpec;
+}

package/lib/models/environments.generated.js

@@ -0,0 +1,13 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/* Generated from the Environment JSON Schema of code-sandboxes (schemas/environment-v1alpha1.json) by scripts/generate-environments-types.py. Do not edit. */
+/** The `$id` of the JSON Schema these types are generated from. */
+export const ENVIRONMENT_SCHEMA_ID = 'https://datalayer.io/schemas/environments/v1alpha1/environment.json';
+/** The sha256 of the schema text these types are generated from. */
+export const ENVIRONMENT_SCHEMA_SHA256 = '76eb8c80d1e27f7c6519946a6f7022b53a717ff2645d993b34aaa54dea658201';
+/** The `apiVersion` an Environment document carries. */
+export const ENVIRONMENT_API_VERSION = 'environments.datalayer.io/v1alpha1';
+/** The `kind` an Environment document carries. */
+export const ENVIRONMENT_KIND = 'Environment';

package/lib/models/index.d.ts

@@ -6,7 +6,6 @@ export * from './CodeSandboxSnapshot';
 export * from './CodeSandboxSnapshotDTO';
 export * from './Content';
 export * from './Course';
-export * from './Dataset';
 export * from './Document';
 export * from './Environment';
 export * from './EnvironmentDTO';
@@ -22,6 +21,7 @@ export * from './NotebookDTO';
 export * from './Page';
 export * from './PageTag';
 export * from './ProjectDTO';
+export * from './CodeSandboxVariant';
 export * from './Runtime';
 export * from './RuntimeDTO';
 export * from './Space';

package/lib/models/index.js

@@ -11,7 +11,6 @@ export * from './CodeSandboxSnapshot';
 export * from './CodeSandboxSnapshotDTO';
 export * from './Content';
 export * from './Course';
-export * from './Dataset';
 export * from './Document';
 export * from './Environment';
 export * from './EnvironmentDTO';
@@ -27,6 +26,7 @@ export * from './NotebookDTO';
 export * from './Page';
 export * from './PageTag';
 export * from './ProjectDTO';
+export * from './CodeSandboxVariant';
 export * from './Runtime';
 export * from './RuntimeDTO';
 export * from './Space';

package/lib/protocols/A2AAdapter.d.ts

@@ -1,8 +1,3 @@
-/**
- * A2A (Agent-to-Agent) protocol adapter using SSE transport.
- *
- * @module protocols/A2AAdapter
- */
 import type { ChatMessage } from '../types/messages';
 import type { ProtocolAdapterConfig, AgentCard } from '../types';
 import type { ToolDefinition, ToolExecutionResult } from '../types/tools';
@@ -11,7 +6,7 @@ import { BaseProtocolAdapter } from './BaseProtocolAdapter';
  * A2A specific configuration
  */
 export interface A2AAdapterConfig extends ProtocolAdapterConfig {
-    /** Agent URL for .well-known/agent.json discovery */
+    /** Agent URL for .well-known/agent-card.json discovery */
     agentUrl?: string;
     /** Enable A2UI extension */
     enableA2UI?: boolean;
@@ -25,8 +20,29 @@ export declare class A2AAdapter extends BaseProtocolAdapter {
     readonly protocolTransport: "sse";
     private a2aConfig;
     private abortController;
+    /**
+     * Every in-flight request's abort controller, not just the newest.
+     *
+     * `abortController` is a single field that each request overwrites, and each
+     * request's `finally` used to clear it unconditionally — so a request that
+     * finished just after a newer one started would null the newer one's handle,
+     * and a subsequent stop had nothing left to abort. The stream carried on and
+     * the transcript went on typing itself after the reader had asked it not to.
+     */
+    private inFlight;
     private agentCard;
     private currentTaskId;
+    /**
+     * Whether the connected agent's card advertised the Datalayer
+     * orchestration extension (ORCHESTRATOR.md, O3-03). Set once, from
+     * `connect()`'s card fetch: neither side infers support from a
+     * successful message (the extension's own negotiation rule), so this is
+     * the one place that decides it, and every request either activates the
+     * extension by this or sends nothing extension-related at all — a worker
+     * that never advertised it sees a plain A2A client, unchanged from
+     * before this existed.
+     */
+    private orchestrationExtensionSupported;
     constructor(config: A2AAdapterConfig);
     /**
      * Connect and discover agent card
@@ -44,6 +60,14 @@ export declare class A2AAdapter extends BaseProtocolAdapter {
      * Get agent card
      */
     getAgentCard(): Promise<AgentCard | null>;
+    /**
+     * Whether the connected agent advertised the Datalayer orchestration
+     * extension. `false` until `connect()` has fetched a card, and `false`
+     * for any card that does not list it — including one that could not be
+     * fetched at all, so a worker with no card behaves exactly as it did
+     * before this existed.
+     */
+    get supportsOrchestrationExtension(): boolean;
     /**
      * Send a message through A2A protocol
      */
@@ -63,6 +87,15 @@ export declare class A2AAdapter extends BaseProtocolAdapter {
             accessToken: string;
         }>;
     }): Promise<void>;
+    /**
+     * Abort every in-flight stream without tearing the adapter down.
+     *
+     * This adapter had no such method, so pressing Stop reached only
+     * `terminateTask` — a request to the backend to cancel — and never closed
+     * the client's own stream. Whatever was already on the wire kept arriving
+     * and kept being rendered. `ChatBase` looks for this by name.
+     */
+    stopGeneration(): void;
     /**
      * Send tool result back
      */