@datalayer/agent-runtimes 1.0.17 → 1.0.19

package/lib/specs/agents/agents.js

@@ -1521,6 +1521,438 @@ export const EXAMPLE_PARAMETERS_AGENTSPEC_0_0_1 = {
     },
     subagents: undefined,
 };
+export const EXAMPLE_SANDBOX_COLAB_AGENTSPEC_0_0_1 = {
+    id: 'example-sandbox-colab',
+    version: '0.0.1',
+    name: 'Example Sandbox Colab Agent',
+    description: `Demonstration agent configured to run codemode code execution with the 'colab' sandbox variant.`,
+    tags: ['sandbox', 'codemode', 'colab'],
+    enabled: true,
+    model: 'bedrock:us.anthropic.claude-opus-4-8',
+    mcpServers: [MCP_SERVER_MAP['tavily:0.0.1']],
+    skills: [
+        SKILL_MAP['events:0.0.1']
+            ? toAgentSkillSpec(SKILL_MAP['events:0.0.1'])
+            : undefined,
+    ].filter(Boolean),
+    tools: [TOOL_MAP['runtime-echo:0.0.1']],
+    frontendTools: [
+        FRONTEND_TOOL_MAP['jupyter-notebook:0.0.1'],
+        FRONTEND_TOOL_MAP['lexical-document:0.0.1'],
+    ],
+    environmentName: 'ai-agents-env',
+    icon: 'package',
+    emoji: 'E',
+    color: '#1F6FEB',
+    suggestions: [
+        "Use execute_code to print('sandbox variant: colab')",
+        'Use execute_code to compute sum(i*i for i in range(20))',
+        'Use execute_code to load pandas and build a small DataFrame',
+    ],
+    welcomeMessage: "You're connected to the colab sandbox variant demo. Ask me to run Python code and I will use execute_code in codemode.",
+    welcomeNotebook: undefined,
+    welcomeDocument: undefined,
+    sandboxVariant: 'colab',
+    systemPrompt: `You are a sandbox-variant demonstration assistant. Prefer executing Python code via execute_code for computations, data checks, and quick experiments, then summarize results clearly.`,
+    systemPromptCodemodeAddons: `Always use execute_code when the user requests calculations, scripts, DataFrame operations, package checks, or shell-style diagnostics.`,
+    goal: undefined,
+    protocol: undefined,
+    uiExtension: undefined,
+    trigger: undefined,
+    modelConfig: undefined,
+    mcpServerTools: undefined,
+    guardrails: undefined,
+    evals: undefined,
+    codemode: { enabled: true, token_reduction: '~80%', speedup: '~1.5x' },
+    output: undefined,
+    advanced: undefined,
+    authorizationPolicy: undefined,
+    notifications: undefined,
+    memory: 'ephemeral',
+    preHooks: undefined,
+    postHooks: undefined,
+    toolHooks: undefined,
+    parameters: undefined,
+    subagents: undefined,
+};
+export const EXAMPLE_SANDBOX_DATALAYER_AGENTSPEC_0_0_1 = {
+    id: 'example-sandbox-datalayer',
+    version: '0.0.1',
+    name: 'Example Sandbox Datalayer Agent',
+    description: `Demonstration agent configured to run codemode code execution with the 'datalayer' sandbox variant.`,
+    tags: ['sandbox', 'codemode', 'datalayer'],
+    enabled: true,
+    model: 'bedrock:us.anthropic.claude-opus-4-8',
+    mcpServers: [MCP_SERVER_MAP['tavily:0.0.1']],
+    skills: [
+        SKILL_MAP['events:0.0.1']
+            ? toAgentSkillSpec(SKILL_MAP['events:0.0.1'])
+            : undefined,
+    ].filter(Boolean),
+    tools: [TOOL_MAP['runtime-echo:0.0.1']],
+    frontendTools: [
+        FRONTEND_TOOL_MAP['jupyter-notebook:0.0.1'],
+        FRONTEND_TOOL_MAP['lexical-document:0.0.1'],
+    ],
+    environmentName: 'ai-agents-env',
+    icon: 'package',
+    emoji: 'D',
+    color: '#1F6FEB',
+    suggestions: [
+        "Use execute_code to print('sandbox variant: datalayer')",
+        'Use execute_code to compute sum(i*i for i in range(20))',
+        'Use execute_code to load pandas and build a small DataFrame',
+    ],
+    welcomeMessage: "You're connected to the datalayer sandbox variant demo. Ask me to run Python code and I will use execute_code in codemode.",
+    welcomeNotebook: undefined,
+    welcomeDocument: undefined,
+    sandboxVariant: 'datalayer',
+    systemPrompt: `You are a sandbox-variant demonstration assistant. Prefer executing Python code via execute_code for computations, data checks, and quick experiments, then summarize results clearly.`,
+    systemPromptCodemodeAddons: `Always use execute_code when the user requests calculations, scripts, DataFrame operations, package checks, or shell-style diagnostics.`,
+    goal: undefined,
+    protocol: undefined,
+    uiExtension: undefined,
+    trigger: undefined,
+    modelConfig: undefined,
+    mcpServerTools: undefined,
+    guardrails: undefined,
+    evals: undefined,
+    codemode: { enabled: true, token_reduction: '~80%', speedup: '~1.5x' },
+    output: undefined,
+    advanced: undefined,
+    authorizationPolicy: undefined,
+    notifications: undefined,
+    memory: 'ephemeral',
+    preHooks: undefined,
+    postHooks: undefined,
+    toolHooks: undefined,
+    parameters: undefined,
+    subagents: undefined,
+};
+export const EXAMPLE_SANDBOX_DOCKER_AGENTSPEC_0_0_1 = {
+    id: 'example-sandbox-docker',
+    version: '0.0.1',
+    name: 'Example Sandbox Docker Agent',
+    description: `Demonstration agent configured to run codemode code execution with the 'docker' sandbox variant.`,
+    tags: ['sandbox', 'codemode', 'docker'],
+    enabled: true,
+    model: 'bedrock:us.anthropic.claude-opus-4-8',
+    mcpServers: [MCP_SERVER_MAP['tavily:0.0.1']],
+    skills: [
+        SKILL_MAP['events:0.0.1']
+            ? toAgentSkillSpec(SKILL_MAP['events:0.0.1'])
+            : undefined,
+    ].filter(Boolean),
+    tools: [TOOL_MAP['runtime-echo:0.0.1']],
+    frontendTools: [
+        FRONTEND_TOOL_MAP['jupyter-notebook:0.0.1'],
+        FRONTEND_TOOL_MAP['lexical-document:0.0.1'],
+    ],
+    environmentName: 'ai-agents-env',
+    icon: 'package',
+    emoji: 'C',
+    color: '#1F6FEB',
+    suggestions: [
+        "Use execute_code to print('sandbox variant: docker')",
+        'Use execute_code to compute sum(i*i for i in range(20))',
+        'Use execute_code to load pandas and build a small DataFrame',
+    ],
+    welcomeMessage: "You're connected to the docker sandbox variant demo. Ask me to run Python code and I will use execute_code in codemode.",
+    welcomeNotebook: undefined,
+    welcomeDocument: undefined,
+    sandboxVariant: 'docker',
+    systemPrompt: `You are a sandbox-variant demonstration assistant. Prefer executing Python code via execute_code for computations, data checks, and quick experiments, then summarize results clearly.`,
+    systemPromptCodemodeAddons: `Always use execute_code when the user requests calculations, scripts, DataFrame operations, package checks, or shell-style diagnostics.`,
+    goal: undefined,
+    protocol: undefined,
+    uiExtension: undefined,
+    trigger: undefined,
+    modelConfig: undefined,
+    mcpServerTools: undefined,
+    guardrails: undefined,
+    evals: undefined,
+    codemode: { enabled: true, token_reduction: '~80%', speedup: '~1.5x' },
+    output: undefined,
+    advanced: undefined,
+    authorizationPolicy: undefined,
+    notifications: undefined,
+    memory: 'ephemeral',
+    preHooks: undefined,
+    postHooks: undefined,
+    toolHooks: undefined,
+    parameters: undefined,
+    subagents: undefined,
+};
+export const EXAMPLE_SANDBOX_EVAL_AGENTSPEC_0_0_1 = {
+    id: 'example-sandbox-eval',
+    version: '0.0.1',
+    name: 'Example Sandbox Eval Agent',
+    description: `Demonstration agent configured to run codemode code execution with the 'eval' sandbox variant.`,
+    tags: ['sandbox', 'codemode', 'eval'],
+    enabled: true,
+    model: 'bedrock:us.anthropic.claude-opus-4-8',
+    mcpServers: [MCP_SERVER_MAP['tavily:0.0.1']],
+    skills: [
+        SKILL_MAP['events:0.0.1']
+            ? toAgentSkillSpec(SKILL_MAP['events:0.0.1'])
+            : undefined,
+    ].filter(Boolean),
+    tools: [TOOL_MAP['runtime-echo:0.0.1']],
+    frontendTools: [
+        FRONTEND_TOOL_MAP['jupyter-notebook:0.0.1'],
+        FRONTEND_TOOL_MAP['lexical-document:0.0.1'],
+    ],
+    environmentName: 'ai-agents-env',
+    icon: 'package',
+    emoji: 'A',
+    color: '#1F6FEB',
+    suggestions: [
+        "Use execute_code to print('sandbox variant: eval')",
+        'Use execute_code to compute sum(i*i for i in range(20))',
+        'Use execute_code to load pandas and build a small DataFrame',
+    ],
+    welcomeMessage: "You're connected to the eval sandbox variant demo. Ask me to run Python code and I will use execute_code in codemode.",
+    welcomeNotebook: undefined,
+    welcomeDocument: undefined,
+    sandboxVariant: 'eval',
+    systemPrompt: `You are a sandbox-variant demonstration assistant. Prefer executing Python code via execute_code for computations, data checks, and quick experiments, then summarize results clearly.`,
+    systemPromptCodemodeAddons: `Always use execute_code when the user requests calculations, scripts, DataFrame operations, package checks, or shell-style diagnostics.`,
+    goal: undefined,
+    protocol: undefined,
+    uiExtension: undefined,
+    trigger: undefined,
+    modelConfig: undefined,
+    mcpServerTools: undefined,
+    guardrails: undefined,
+    evals: undefined,
+    codemode: { enabled: true, token_reduction: '~80%', speedup: '~1.5x' },
+    output: undefined,
+    advanced: undefined,
+    authorizationPolicy: undefined,
+    notifications: undefined,
+    memory: 'ephemeral',
+    preHooks: undefined,
+    postHooks: undefined,
+    toolHooks: undefined,
+    parameters: undefined,
+    subagents: undefined,
+};
+export const EXAMPLE_SANDBOX_JUPYTER_AGENTSPEC_0_0_1 = {
+    id: 'example-sandbox-jupyter',
+    version: '0.0.1',
+    name: 'Example Sandbox Jupyter Agent',
+    description: `Demonstration agent configured to run codemode code execution with the 'jupyter' sandbox variant.`,
+    tags: ['sandbox', 'codemode', 'jupyter'],
+    enabled: true,
+    model: 'bedrock:us.anthropic.claude-opus-4-8',
+    mcpServers: [MCP_SERVER_MAP['tavily:0.0.1']],
+    skills: [
+        SKILL_MAP['events:0.0.1']
+            ? toAgentSkillSpec(SKILL_MAP['events:0.0.1'])
+            : undefined,
+    ].filter(Boolean),
+    tools: [TOOL_MAP['runtime-echo:0.0.1']],
+    frontendTools: [
+        FRONTEND_TOOL_MAP['jupyter-notebook:0.0.1'],
+        FRONTEND_TOOL_MAP['lexical-document:0.0.1'],
+    ],
+    environmentName: 'ai-agents-env',
+    icon: 'package',
+    emoji: 'B',
+    color: '#1F6FEB',
+    suggestions: [
+        "Use execute_code to print('sandbox variant: jupyter')",
+        'Use execute_code to compute sum(i*i for i in range(20))',
+        'Use execute_code to load pandas and build a small DataFrame',
+    ],
+    welcomeMessage: "You're connected to the jupyter sandbox variant demo. Ask me to run Python code and I will use execute_code in codemode.",
+    welcomeNotebook: undefined,
+    welcomeDocument: undefined,
+    sandboxVariant: 'jupyter',
+    systemPrompt: `You are a sandbox-variant demonstration assistant. Prefer executing Python code via execute_code for computations, data checks, and quick experiments, then summarize results clearly.`,
+    systemPromptCodemodeAddons: `Always use execute_code when the user requests calculations, scripts, DataFrame operations, package checks, or shell-style diagnostics.`,
+    goal: undefined,
+    protocol: undefined,
+    uiExtension: undefined,
+    trigger: undefined,
+    modelConfig: undefined,
+    mcpServerTools: undefined,
+    guardrails: undefined,
+    evals: undefined,
+    codemode: { enabled: true, token_reduction: '~80%', speedup: '~1.5x' },
+    output: undefined,
+    advanced: undefined,
+    authorizationPolicy: undefined,
+    notifications: undefined,
+    memory: 'ephemeral',
+    preHooks: undefined,
+    postHooks: undefined,
+    toolHooks: undefined,
+    parameters: undefined,
+    subagents: undefined,
+};
+export const EXAMPLE_SANDBOX_KAGGLE_AGENTSPEC_0_0_1 = {
+    id: 'example-sandbox-kaggle',
+    version: '0.0.1',
+    name: 'Example Sandbox Kaggle Agent',
+    description: `Demonstration agent configured to run codemode code execution with the 'kaggle' sandbox variant.`,
+    tags: ['sandbox', 'codemode', 'kaggle'],
+    enabled: true,
+    model: 'bedrock:us.anthropic.claude-opus-4-8',
+    mcpServers: [MCP_SERVER_MAP['tavily:0.0.1']],
+    skills: [
+        SKILL_MAP['events:0.0.1']
+            ? toAgentSkillSpec(SKILL_MAP['events:0.0.1'])
+            : undefined,
+    ].filter(Boolean),
+    tools: [TOOL_MAP['runtime-echo:0.0.1']],
+    frontendTools: [
+        FRONTEND_TOOL_MAP['jupyter-notebook:0.0.1'],
+        FRONTEND_TOOL_MAP['lexical-document:0.0.1'],
+    ],
+    environmentName: 'ai-agents-env',
+    icon: 'package',
+    emoji: 'H',
+    color: '#1F6FEB',
+    suggestions: [
+        "Use execute_code to print('sandbox variant: kaggle')",
+        'Use execute_code to compute sum(i*i for i in range(20))',
+        'Use execute_code to load pandas and build a small DataFrame',
+    ],
+    welcomeMessage: "You're connected to the kaggle sandbox variant demo. Ask me to run Python code and I will use execute_code in codemode.",
+    welcomeNotebook: undefined,
+    welcomeDocument: undefined,
+    sandboxVariant: 'kaggle',
+    systemPrompt: `You are a sandbox-variant demonstration assistant. Prefer executing Python code via execute_code for computations, data checks, and quick experiments, then summarize results clearly.`,
+    systemPromptCodemodeAddons: `Always use execute_code when the user requests calculations, scripts, DataFrame operations, package checks, or shell-style diagnostics.`,
+    goal: undefined,
+    protocol: undefined,
+    uiExtension: undefined,
+    trigger: undefined,
+    modelConfig: undefined,
+    mcpServerTools: undefined,
+    guardrails: undefined,
+    evals: undefined,
+    codemode: { enabled: true, token_reduction: '~80%', speedup: '~1.5x' },
+    output: undefined,
+    advanced: undefined,
+    authorizationPolicy: undefined,
+    notifications: undefined,
+    memory: 'ephemeral',
+    preHooks: undefined,
+    postHooks: undefined,
+    toolHooks: undefined,
+    parameters: undefined,
+    subagents: undefined,
+};
+export const EXAMPLE_SANDBOX_MODAL_AGENTSPEC_0_0_1 = {
+    id: 'example-sandbox-modal',
+    version: '0.0.1',
+    name: 'Example Sandbox Modal Agent',
+    description: `Demonstration agent configured to run codemode code execution with the 'modal' sandbox variant.`,
+    tags: ['sandbox', 'codemode', 'modal'],
+    enabled: true,
+    model: 'bedrock:us.anthropic.claude-opus-4-8',
+    mcpServers: [MCP_SERVER_MAP['tavily:0.0.1']],
+    skills: [
+        SKILL_MAP['events:0.0.1']
+            ? toAgentSkillSpec(SKILL_MAP['events:0.0.1'])
+            : undefined,
+    ].filter(Boolean),
+    tools: [TOOL_MAP['runtime-echo:0.0.1']],
+    frontendTools: [
+        FRONTEND_TOOL_MAP['jupyter-notebook:0.0.1'],
+        FRONTEND_TOOL_MAP['lexical-document:0.0.1'],
+    ],
+    environmentName: 'ai-agents-env',
+    icon: 'package',
+    emoji: 'G',
+    color: '#1F6FEB',
+    suggestions: [
+        "Use execute_code to print('sandbox variant: modal')",
+        'Use execute_code to compute sum(i*i for i in range(20))',
+        'Use execute_code to load pandas and build a small DataFrame',
+    ],
+    welcomeMessage: "You're connected to the modal sandbox variant demo. Ask me to run Python code and I will use execute_code in codemode.",
+    welcomeNotebook: undefined,
+    welcomeDocument: undefined,
+    sandboxVariant: 'modal',
+    systemPrompt: `You are a sandbox-variant demonstration assistant. Prefer executing Python code via execute_code for computations, data checks, and quick experiments, then summarize results clearly.`,
+    systemPromptCodemodeAddons: `Always use execute_code when the user requests calculations, scripts, DataFrame operations, package checks, or shell-style diagnostics.`,
+    goal: undefined,
+    protocol: undefined,
+    uiExtension: undefined,
+    trigger: undefined,
+    modelConfig: undefined,
+    mcpServerTools: undefined,
+    guardrails: undefined,
+    evals: undefined,
+    codemode: { enabled: true, token_reduction: '~80%', speedup: '~1.5x' },
+    output: undefined,
+    advanced: undefined,
+    authorizationPolicy: undefined,
+    notifications: undefined,
+    memory: 'ephemeral',
+    preHooks: undefined,
+    postHooks: undefined,
+    toolHooks: undefined,
+    parameters: undefined,
+    subagents: undefined,
+};
+export const EXAMPLE_SANDBOX_MONTY_AGENTSPEC_0_0_1 = {
+    id: 'example-sandbox-monty',
+    version: '0.0.1',
+    name: 'Example Sandbox Monty Agent',
+    description: `Demonstration agent configured to run codemode code execution with the 'monty' sandbox variant.`,
+    tags: ['sandbox', 'codemode', 'monty'],
+    enabled: true,
+    model: 'bedrock:us.anthropic.claude-opus-4-8',
+    mcpServers: [MCP_SERVER_MAP['tavily:0.0.1']],
+    skills: [
+        SKILL_MAP['events:0.0.1']
+            ? toAgentSkillSpec(SKILL_MAP['events:0.0.1'])
+            : undefined,
+    ].filter(Boolean),
+    tools: [TOOL_MAP['runtime-echo:0.0.1']],
+    frontendTools: [
+        FRONTEND_TOOL_MAP['jupyter-notebook:0.0.1'],
+        FRONTEND_TOOL_MAP['lexical-document:0.0.1'],
+    ],
+    environmentName: 'ai-agents-env',
+    icon: 'package',
+    emoji: 'F',
+    color: '#1F6FEB',
+    suggestions: [
+        "Use execute_code to print('sandbox variant: monty')",
+        'Use execute_code to compute sum(i*i for i in range(20))',
+        'Use execute_code to load pandas and build a small DataFrame',
+    ],
+    welcomeMessage: "You're connected to the monty sandbox variant demo. Ask me to run Python code and I will use execute_code in codemode.",
+    welcomeNotebook: undefined,
+    welcomeDocument: undefined,
+    sandboxVariant: 'monty',
+    systemPrompt: `You are a sandbox-variant demonstration assistant. Prefer executing Python code via execute_code for computations, data checks, and quick experiments, then summarize results clearly.`,
+    systemPromptCodemodeAddons: `Always use execute_code when the user requests calculations, scripts, DataFrame operations, package checks, or shell-style diagnostics.`,
+    goal: undefined,
+    protocol: undefined,
+    uiExtension: undefined,
+    trigger: undefined,
+    modelConfig: undefined,
+    mcpServerTools: undefined,
+    guardrails: undefined,
+    evals: undefined,
+    codemode: { enabled: true, token_reduction: '~80%', speedup: '~1.5x' },
+    output: undefined,
+    advanced: undefined,
+    authorizationPolicy: undefined,
+    notifications: undefined,
+    memory: 'ephemeral',
+    preHooks: undefined,
+    postHooks: undefined,
+    toolHooks: undefined,
+    parameters: undefined,
+    subagents: undefined,
+};
 export const EXAMPLE_SHARED_STATE_AGENTSPEC_0_0_1 = {
     id: 'example-shared-state',
     version: '0.0.1',
@@ -6301,6 +6733,14 @@ export const AGENTSPECS = {
     'example-otel': EXAMPLE_OTEL_AGENTSPEC_0_0_1,
     'example-output': EXAMPLE_OUTPUT_AGENTSPEC_0_0_1,
     'example-parameters': EXAMPLE_PARAMETERS_AGENTSPEC_0_0_1,
+    'example-sandbox-colab': EXAMPLE_SANDBOX_COLAB_AGENTSPEC_0_0_1,
+    'example-sandbox-datalayer': EXAMPLE_SANDBOX_DATALAYER_AGENTSPEC_0_0_1,
+    'example-sandbox-docker': EXAMPLE_SANDBOX_DOCKER_AGENTSPEC_0_0_1,
+    'example-sandbox-eval': EXAMPLE_SANDBOX_EVAL_AGENTSPEC_0_0_1,
+    'example-sandbox-jupyter': EXAMPLE_SANDBOX_JUPYTER_AGENTSPEC_0_0_1,
+    'example-sandbox-kaggle': EXAMPLE_SANDBOX_KAGGLE_AGENTSPEC_0_0_1,
+    'example-sandbox-modal': EXAMPLE_SANDBOX_MODAL_AGENTSPEC_0_0_1,
+    'example-sandbox-monty': EXAMPLE_SANDBOX_MONTY_AGENTSPEC_0_0_1,
     'example-shared-state': EXAMPLE_SHARED_STATE_AGENTSPEC_0_0_1,
     'example-simple': EXAMPLE_SIMPLE_AGENTSPEC_0_0_1,
     'example-skills': EXAMPLE_SKILLS_AGENTSPEC_0_0_1,

package/lib/types/agentspecs.d.ts

@@ -63,7 +63,7 @@ export interface Agentspec {
     welcomeNotebook?: string;
     /** Path to Lexical document to show on agent creation */
     welcomeDocument?: string;
-    /** Sandbox variant to use for this agent ('eval', 'jupyter') */
+    /** Sandbox variant to use for this agent (e.g. 'eval', 'jupyter', 'kaggle'). */
     sandboxVariant?: string;
     /** User-facing objective for the agent */
     goal?: string;

package/lib/types/chat.d.ts

@@ -4,6 +4,7 @@
  * @module types/chat
  */
 import type { ComponentType, ReactNode } from 'react';
+import type { ICollaborationProvider } from '@datalayer/jupyter-react';
 import type { ChatMessage, MessageHandler } from './messages';
 import type { Protocol, ProtocolConfig } from './protocol';
 import type { McpServerSelection } from './inference';
@@ -12,6 +13,8 @@ import type { AgentRuntimeConfig } from './config';
 import type { SandboxWsStatus } from './sandbox';
 import type { FrontendToolDefinition } from './tools';
 import type { PoweredByTagProps } from '../chat/display/PoweredByTag';
+import type { EphemeralRuntimeOverride } from '../chat/notebook/EphemeralNotebook';
+import type { EphemeralDocumentCollaboration } from '../chat/document/EphemeralDocument';
 /**
  * Context passed to tool-call pre-hooks.
  * Fires when a tool call starts executing (backend or frontend).
@@ -366,6 +369,34 @@ export interface ChatCommonProps {
      * Defaults to the toolbar from `@datalayer/jupyter-react` when omitted.
      */
     ephemeralNotebookToolbar?: EphemeralNotebookToolbarComponent;
+    /**
+     * Optional real-time collaboration provider for the ephemeral notebook.
+     * When supplied, the notebook joins a shared collaborative room so its state
+     * transits over RTC (e.g. between an Agent Node and the SaaS UI) instead of
+     * the tunnel. The caller owns the provider lifecycle.
+     */
+    ephemeralNotebookCollaborationProvider?: ICollaborationProvider;
+    /**
+     * Explicit collaboration room / document id for the ephemeral notebook. When
+     * set it becomes the notebook id directly so multiple peers (e.g. an Agent
+     * Node and the SaaS UI) share the same collaborative room and tool scope.
+     */
+    ephemeralNotebookCollaborationDocumentId?: string;
+    /**
+     * Optional real-time collaboration configuration for the ephemeral document
+     * (Lexical). When supplied the document joins a shared Loro room over
+     * WebSocket so its rich-text state transits over RTC (e.g. between an Agent
+     * Node and the SaaS UI). Its `roomId` also becomes the document id so all
+     * peers share the same collaborative room and lexical tool scope.
+     */
+    ephemeralDocumentCollaboration?: EphemeralDocumentCollaboration;
+    /**
+     * Explicit runtime endpoint for the ephemeral notebook kernel. When set, the
+     * notebook binds its kernel to this endpoint directly instead of resolving a
+     * pod from the user's runtimes list — used to reach an Agent Node's Jupyter
+     * server through the runtimes tunnel HTTP/WebSocket proxy.
+     */
+    ephemeralRuntimeOverride?: EphemeralRuntimeOverride;
     /** Pre-hook: fires when a tool call starts executing */
     onToolCallStart?: (context: ToolCallStartContext) => void;
     /** Post-hook: fires when a tool result is received */
@@ -419,6 +450,18 @@ export interface ChatCommonProps {
      * so the indicator reflects the surface's runtime.
      */
     kernel?: import('@jupyterlab/services/lib/kernel/kernel').IKernelConnection | null;
+    /**
+     * Optional environment name displayed in the chat header's kernel
+     * indicator details (e.g. the agent's local sandbox name). Defaults to
+     * the indicator's own "browser-runtime" placeholder when omitted.
+     */
+    kernelEnvironmentName?: string;
+    /** Optional CPU info displayed in the chat header's kernel indicator. */
+    kernelCpu?: string;
+    /** Optional memory info displayed in the chat header's kernel indicator. */
+    kernelMemory?: string;
+    /** Optional GPU info displayed in the chat header's kernel indicator. */
+    kernelGpu?: string;
     /**
      * Disable ChatBase's internal JupyterReactTheme wrapper.
      * Use this when the host page already provides a JupyterReactTheme boundary.
@@ -746,6 +789,34 @@ export interface ChatBaseProps {
      * Defaults to the toolbar from `@datalayer/jupyter-react` when omitted.
      */
     ephemeralNotebookToolbar?: EphemeralNotebookToolbarComponent;
+    /**
+     * Optional real-time collaboration provider for the ephemeral notebook.
+     * When supplied, the notebook joins a shared collaborative room so its state
+     * transits over RTC (e.g. between an Agent Node and the SaaS UI) instead of
+     * the tunnel. The caller owns the provider lifecycle.
+     */
+    ephemeralNotebookCollaborationProvider?: ICollaborationProvider;
+    /**
+     * Explicit collaboration room / document id for the ephemeral notebook. When
+     * set it becomes the notebook id directly so multiple peers (e.g. an Agent
+     * Node and the SaaS UI) share the same collaborative room and tool scope.
+     */
+    ephemeralNotebookCollaborationDocumentId?: string;
+    /**
+     * Optional real-time collaboration configuration for the ephemeral document
+     * (Lexical). When supplied the document joins a shared Loro room over
+     * WebSocket so its rich-text state transits over RTC (e.g. between an Agent
+     * Node and the SaaS UI). Its `roomId` also becomes the document id so all
+     * peers share the same collaborative room and lexical tool scope.
+     */
+    ephemeralDocumentCollaboration?: EphemeralDocumentCollaboration;
+    /**
+     * Explicit runtime endpoint for the ephemeral notebook kernel. When set, the
+     * notebook binds its kernel to this endpoint directly instead of resolving a
+     * pod from the user's runtimes list — used to reach an Agent Node's Jupyter
+     * server through the runtimes tunnel HTTP/WebSocket proxy.
+     */
+    ephemeralRuntimeOverride?: EphemeralRuntimeOverride;
     /**
      * Callback when the agent requests authorization for an external service.
      * This is called when a tool needs OAuth access to a service like GitHub.

package/lib/types/config.d.ts

@@ -33,7 +33,7 @@ export interface AgentConfig {
     inferenceProvider?: string;
     /** Enable codemode if supported by the selected spec/runtime. */
     enableCodemode?: boolean;
-    /** Optional sandbox variant (e.g. eval, jupyter). */
+    /** Optional sandbox variant (e.g. eval, jupyter, kaggle). */
     sandboxVariant?: string;
     /** Optional Jupyter sandbox URL for jupyter-backed sandbox mode. */
     jupyterSandbox?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datalayer/agent-runtimes",
-  "version": "1.0.17",
+  "version": "1.0.19",
   "type": "module",
   "workspaces": [
     ".",
@@ -102,8 +102,8 @@
     "start:acp:vite": "VITE_ACP_WS_URL=ws://localhost:8765/api/v1/acp/ws vite",
     "start:agent": "run-p server:start start:agent:vite",
     "start:agent:vite": "vite --open /html/agent.html",
-    "start:agent-node": "run-p server:start:agent-node start:agent-node:vite",
-    "start:agent-node:vite": "vite --open /html/agent-node.html",
+    "start:agent-node": "run-p server:start:agent-node jupyter:start start:agent-node:vite",
+    "start:agent-node:vite": "VITE_JUPYTER_SANDBOX_URL=${VITE_JUPYTER_SANDBOX_URL:-http://localhost:8888/api/jupyter-server?token=60c1661cc408f978c309d04157af55c9588ff9557c9380e4fb50785750703da6} vite --open /html/agent-node.html",
     "start:agent-notebook": "run-p server:start jupyter:start start:agent-notebook:vite",
     "start:agent-notebook:vite": "vite --open /html/agent-notebook.html",
     "start:agent-document": "run-p server:start jupyter:start start:agent-document:vite",
@@ -141,6 +141,7 @@
     "@datalayer/core": "^1.1.48",
     "@datalayer/icons-react": "^1.0.7",
     "@datalayer/jupyter-lexical": "^1.0.16",
+    "@datalayer/lexical-loro": "^1.0.0",
     "@datalayer/jupyter-react": "^2.0.7",
     "@datalayer/primer-addons": "^1.0.15",
     "@datalayer/primer-rjsf": "^1.0.3",