@datalayer/agent-runtimes 1.0.28 → 1.0.29

package/lib/models/CodeSandboxVariant.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The kinds of code sandbox, as the Python `code_sandboxes` package names them.
+ *
+ * A sandbox is a place code runs, and the VARIANT names the kind of place:
+ * the Datalayer platform, a Jupyter Server, Kaggle, Modal, and so on. The
+ * values mirror `code_sandboxes.models.SandboxVariant` verbatim — one naming
+ * for the CLI, the services and the applications, so an environment tagged
+ * `kaggle` by the operator reads as `kaggle` here and nowhere becomes a
+ * synonym.
+ *
+ * @module models/CodeSandboxVariant
+ */
+/** The kinds of code sandbox, by the value the platform tags them with. */
+export declare enum CodeSandboxVariant {
+    /** In-process evaluation: tests and examples, isolates nothing. */
+    Eval = "eval",
+    /** A container on the Docker daemon of a machine. */
+    Docker = "docker",
+    /** A kernel of a Jupyter Server. */
+    JupyterServer = "jupyter-server",
+    /** A runtime of the Datalayer platform. */
+    Datalayer = "datalayer",
+    /** A Google Colab runtime. */
+    GoogleColab = "google_colab",
+    /** A Kaggle notebook session. */
+    Kaggle = "kaggle",
+    /** The Monty in-browser interpreter. */
+    Monty = "monty",
+    /** A container on Modal. */
+    Modal = "modal"
+}
+/** What each variant is called where a person reads it. */
+export declare const CODE_SANDBOX_VARIANT_TITLES: Record<CodeSandboxVariant, string>;
+/**
+ * The variant an environment belongs to, read off its `owner` tag.
+ *
+ * The operator tags an external environment with its provider through the
+ * environment's `owner` — `kaggle`, `modal` — while the platform's own carry
+ * `datalayer`. An owner nothing here recognises reads as Datalayer, which is
+ * what every environment was before providers existed.
+ */
+export declare function codeSandboxVariantOf(owner?: string | null): CodeSandboxVariant;
+/** A short label for the chip beside an environment's name. */
+export declare function codeSandboxVariantTitle(variant: CodeSandboxVariant): string;
+export default CodeSandboxVariant;

package/lib/models/CodeSandboxVariant.js

@@ -0,0 +1,65 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * The kinds of code sandbox, as the Python `code_sandboxes` package names them.
+ *
+ * A sandbox is a place code runs, and the VARIANT names the kind of place:
+ * the Datalayer platform, a Jupyter Server, Kaggle, Modal, and so on. The
+ * values mirror `code_sandboxes.models.SandboxVariant` verbatim — one naming
+ * for the CLI, the services and the applications, so an environment tagged
+ * `kaggle` by the operator reads as `kaggle` here and nowhere becomes a
+ * synonym.
+ *
+ * @module models/CodeSandboxVariant
+ */
+/** The kinds of code sandbox, by the value the platform tags them with. */
+export var CodeSandboxVariant;
+(function (CodeSandboxVariant) {
+    /** In-process evaluation: tests and examples, isolates nothing. */
+    CodeSandboxVariant["Eval"] = "eval";
+    /** A container on the Docker daemon of a machine. */
+    CodeSandboxVariant["Docker"] = "docker";
+    /** A kernel of a Jupyter Server. */
+    CodeSandboxVariant["JupyterServer"] = "jupyter-server";
+    /** A runtime of the Datalayer platform. */
+    CodeSandboxVariant["Datalayer"] = "datalayer";
+    /** A Google Colab runtime. */
+    CodeSandboxVariant["GoogleColab"] = "google_colab";
+    /** A Kaggle notebook session. */
+    CodeSandboxVariant["Kaggle"] = "kaggle";
+    /** The Monty in-browser interpreter. */
+    CodeSandboxVariant["Monty"] = "monty";
+    /** A container on Modal. */
+    CodeSandboxVariant["Modal"] = "modal";
+})(CodeSandboxVariant || (CodeSandboxVariant = {}));
+/** What each variant is called where a person reads it. */
+export const CODE_SANDBOX_VARIANT_TITLES = {
+    [CodeSandboxVariant.Eval]: 'Eval',
+    [CodeSandboxVariant.Docker]: 'Docker',
+    [CodeSandboxVariant.JupyterServer]: 'Jupyter Server',
+    [CodeSandboxVariant.Datalayer]: 'Datalayer',
+    [CodeSandboxVariant.GoogleColab]: 'Google Colab',
+    [CodeSandboxVariant.Kaggle]: 'Kaggle',
+    [CodeSandboxVariant.Monty]: 'Monty',
+    [CodeSandboxVariant.Modal]: 'Modal'
+};
+/**
+ * The variant an environment belongs to, read off its `owner` tag.
+ *
+ * The operator tags an external environment with its provider through the
+ * environment's `owner` — `kaggle`, `modal` — while the platform's own carry
+ * `datalayer`. An owner nothing here recognises reads as Datalayer, which is
+ * what every environment was before providers existed.
+ */
+export function codeSandboxVariantOf(owner) {
+    const normalized = (owner ?? '').replace('_', '-').toLowerCase();
+    const match = Object.values(CodeSandboxVariant).find(value => value.replace('_', '-') === normalized);
+    return match ?? CodeSandboxVariant.Datalayer;
+}
+/** A short label for the chip beside an environment's name. */
+export function codeSandboxVariantTitle(variant) {
+    return CODE_SANDBOX_VARIANT_TITLES[variant] ?? variant;
+}
+export default CodeSandboxVariant;

package/lib/models/index.d.ts

@@ -22,6 +22,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

@@ -27,6 +27,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/runtimes/actions.js

@@ -30,11 +30,23 @@ export async function getEnvironments() {
  */
 export async function createRuntime(options) {
     const { externalToken, token } = iamStore.getState();
+    /*
+     * A limit is required; ZERO is one of the answers.
+     *
+     * The environments of an external provider — Kaggle, Modal — burn no
+     * credits of the platform: their sandbox runs on the account of the user,
+     * at their provider, and the platform only records it. Their burning rate
+     * is `0`, so the limit computed for them is `0` too, and refusing that
+     * threw here — before any request was made, which is why the failure
+     * showed as a sandbox that could not be created with nothing in the
+     * network log to explain it. What is still refused is a limit that is not
+     * a number at all, or one below zero.
+     */
     if (typeof options.creditsLimit !== 'number' ||
         !Number.isFinite(options.creditsLimit) ||
-        options.creditsLimit <= 0) {
+        options.creditsLimit < 0) {
         throw new Error(`Invalid runtime creditsLimit for environment ${options.environmentName}. ` +
-            'A positive number is required.');
+            'A number of zero or more is required.');
     }
     const body = {
         environment: {

package/lib/specs/envvars.d.ts

@@ -12,7 +12,7 @@ export declare const GITHUB_TOKEN_SPEC_0_0_1: EnvvarSpec;
 export declare const GOOGLE_OAUTH_CLIENT_ID_SPEC_0_0_1: EnvvarSpec;
 export declare const GOOGLE_OAUTH_CLIENT_SECRET_SPEC_0_0_1: EnvvarSpec;
 export declare const HF_TOKEN_SPEC_0_0_1: EnvvarSpec;
-export declare const KAGGLE_TOKEN_SPEC_0_0_1: EnvvarSpec;
+export declare const KAGGLE_API_TOKEN_SPEC_0_0_1: EnvvarSpec;
 export declare const SLACK_BOT_TOKEN_SPEC_0_0_1: EnvvarSpec;
 export declare const SLACK_CHANNEL_IDS_SPEC_0_0_1: EnvvarSpec;
 export declare const SLACK_TEAM_ID_SPEC_0_0_1: EnvvarSpec;

package/lib/specs/envvars.js

@@ -62,8 +62,8 @@ export const HF_TOKEN_SPEC_0_0_1 = {
     icon: 'key',
     emoji: '🔑',
 };
-export const KAGGLE_TOKEN_SPEC_0_0_1 = {
-    id: 'KAGGLE_TOKEN',
+export const KAGGLE_API_TOKEN_SPEC_0_0_1 = {
+    id: 'KAGGLE_API_TOKEN',
     version: '0.0.1',
     name: 'Kaggle API Token',
     description: 'API token for accessing Kaggle datasets, competitions, notebooks, and models. Required for Kaggle MCP server authentication.',
@@ -120,7 +120,7 @@ export const ENVVAR_CATALOG = {
     GOOGLE_OAUTH_CLIENT_ID: GOOGLE_OAUTH_CLIENT_ID_SPEC_0_0_1,
     GOOGLE_OAUTH_CLIENT_SECRET: GOOGLE_OAUTH_CLIENT_SECRET_SPEC_0_0_1,
     HF_TOKEN: HF_TOKEN_SPEC_0_0_1,
-    KAGGLE_TOKEN: KAGGLE_TOKEN_SPEC_0_0_1,
+    KAGGLE_API_TOKEN: KAGGLE_API_TOKEN_SPEC_0_0_1,
     SLACK_BOT_TOKEN: SLACK_BOT_TOKEN_SPEC_0_0_1,
     SLACK_CHANNEL_IDS: SLACK_CHANNEL_IDS_SPEC_0_0_1,
     SLACK_TEAM_ID: SLACK_TEAM_ID_SPEC_0_0_1,

package/lib/specs/mcpServers.js

@@ -163,13 +163,13 @@ export const KAGGLE_MCP_SERVER_0_0_1 = {
         'mcp-remote',
         'https://www.kaggle.com/mcp',
         '--header',
-        'Authorization: Bearer ${KAGGLE_TOKEN}',
+        'Authorization: Bearer ${KAGGLE_API_TOKEN}',
     ],
     transport: 'stdio',
     enabled: true,
     isAvailable: false,
     tools: [],
-    requiredEnvVars: ['KAGGLE_TOKEN:0.0.1'],
+    requiredEnvVars: ['KAGGLE_API_TOKEN:0.0.1'],
 };
 export const ODOO_MCP_SERVER_0_0_1 = {
     id: 'odoo',

package/lib/state/substates/RuntimesState.js

@@ -77,7 +77,10 @@ export const runtimesStore = createStore((set, get) => {
          */
         removeRuntimeModel: (id) => {
             const kernels = [...get().runtimeModels];
-            const index = kernels?.findIndex(model => id === model.id) ?? -1;
+            // By the kernel it runs, or by the pod it is: a sandbox of an external
+            // provider has no kernel, so its pod name is the only name it answers
+            // to — matched on the kernel alone it was never removed from the list.
+            const index = kernels?.findIndex(model => (!!model.id && id === model.id) || id === model.pod_name) ?? -1;
             if (index >= 0) {
                 kernels.splice(index, 1);
                 set({ runtimeModels: kernels });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datalayer/agent-runtimes",
-  "version": "1.0.28",
+  "version": "1.0.29",
   "type": "module",
   "workspaces": [
     ".",

package/scripts/gen_workers.py

@@ -40,7 +40,7 @@ VERTICALS = {
         "emoji": "🧬", "icon": "beaker", "color": "#06B6D4",
         "mcp": ["huggingface:0.0.1", "kaggle:0.0.1"],
         "skills": ["text-summarizer:0.0.1", "pdf:0.0.1"],
-        "envvars": ["HF_TOKEN:0.0.1", "KAGGLE_TOKEN:0.0.1"],
+        "envvars": ["HF_TOKEN:0.0.1", "KAGGLE_API_TOKEN:0.0.1"],
     },
     "capital-markets": {
         "emoji": "📈", "icon": "graph", "color": "#3B82F6",