@datalayer/agent-runtimes 1.5.88 → 1.5.89

package/lib/specs/agents/agents.js

@@ -5,7 +5,7 @@
 import { ALPHAVANTAGE_MCP_SERVER_0_0_1, CHART_MCP_SERVER_0_0_1, EARTHDATA_MCP_SERVER_0_0_1, EURUS_MCP_SERVER_0_0_1, FILESYSTEM_MCP_SERVER_0_0_1, GITHUB_MCP_SERVER_0_0_1, GOOGLE_WORKSPACE_MCP_SERVER_0_0_1, HUGGINGFACE_MCP_SERVER_0_0_1, KAGGLE_MCP_SERVER_0_0_1, ODOO_MCP_SERVER_0_0_1, SALESFORCE_MCP_SERVER_0_0_1, SLACK_MCP_SERVER_0_0_1, TAVILY_MCP_SERVER_0_0_1, } from '../mcpServers.js';
 import { ACCOUNTING_SKILL_SPEC_0_0_1, CRAWL_SKILL_SPEC_0_0_1, EVENTS_SKILL_SPEC_0_0_1, GITHUB_SKILL_SPEC_0_0_1, JOKES_SKILL_SPEC_0_0_1, PDF_SKILL_SPEC_0_0_1, TEXT_SUMMARIZER_SKILL_SPEC_0_0_1, } from '../skills.js';
 import { DECIDE_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_CREATE_PLAN_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_CURRENT_TIME_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_DISPLAY_RECIPE_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_GENERATE_HAIKU_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_GENERATE_TASK_STEPS_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_GET_WEATHER_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_RENDER_A2UI_SURFACE_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_UPDATE_PLAN_STEP_BACKEND_TOOL_SPEC_0_0_1, RUNTIME_ECHO_BACKEND_TOOL_SPEC_0_0_1, RUNTIME_SEND_MAIL_BACKEND_TOOL_SPEC_0_0_1, RUNTIME_SENSITIVE_ECHO_BACKEND_TOOL_SPEC_0_0_1, } from '../backendTools.js';
-import { DECKS_FRONTEND_TOOL_SPEC_0_0_1, JUPYTER_NOTEBOOK_EDIT_FRONTEND_TOOL_SPEC_0_0_1, JUPYTER_NOTEBOOK_PROPOSE_FRONTEND_TOOL_SPEC_0_0_1, JUPYTER_NOTEBOOK_READ_FRONTEND_TOOL_SPEC_0_0_1, JUPYTER_NOTEBOOK_FRONTEND_TOOL_SPEC_0_0_1, LEXICAL_DOCUMENT_FRONTEND_TOOL_SPEC_0_0_1, } from '../frontendTools.js';
+import { CELLS_FRONTEND_TOOL_SPEC_0_0_1, DECKS_FRONTEND_TOOL_SPEC_0_0_1, JUPYTER_NOTEBOOK_EDIT_FRONTEND_TOOL_SPEC_0_0_1, JUPYTER_NOTEBOOK_PROPOSE_FRONTEND_TOOL_SPEC_0_0_1, JUPYTER_NOTEBOOK_READ_FRONTEND_TOOL_SPEC_0_0_1, JUPYTER_NOTEBOOK_FRONTEND_TOOL_SPEC_0_0_1, LEXICAL_DOCUMENT_FRONTEND_TOOL_SPEC_0_0_1, } from '../frontendTools.js';
 // ============================================================================
 // MCP Server Lookup
 // ============================================================================
@@ -100,6 +100,8 @@ const TOOL_MAP = {
  * Map frontend tool IDs to FrontendToolSpec objects.
  */
 const FRONTEND_TOOL_MAP = {
+    'cells:0.0.1': CELLS_FRONTEND_TOOL_SPEC_0_0_1,
+    cells: CELLS_FRONTEND_TOOL_SPEC_0_0_1,
     'decks:0.0.1': DECKS_FRONTEND_TOOL_SPEC_0_0_1,
     decks: DECKS_FRONTEND_TOOL_SPEC_0_0_1,
     'jupyter-notebook-edit:0.0.1': JUPYTER_NOTEBOOK_EDIT_FRONTEND_TOOL_SPEC_0_0_1,
@@ -3997,7 +3999,7 @@ export const EXAMPLE_OUTPUT_AGENTSPEC_0_0_1 = {
     id: 'example-output',
     version: '0.0.1',
     name: 'Example Output Agent',
-    description: `Demonstrates structured response rendering (table, json, chart, and file) for the AgentOutputsExample side panel, which detects the block in each answer and renders it.`,
+    description: `Demonstrates structured response rendering (table, json, chart, spreadsheet and file) for the AgentOutputsExample side panel, which detects the block in each answer and renders it; a spreadsheet is drawn with Datalayer Cells, in the chat and in the panel, and charted on the grid through the Cells frontend tools.`,
     tags: ['workflow', 'visualization', 'automation'],
     domain: undefined,
     enabled: false,
@@ -4006,7 +4008,7 @@ export const EXAMPLE_OUTPUT_AGENTSPEC_0_0_1 = {
     skills: [].filter(Boolean),
     backendTools: [],
     disableToolApprovals: true,
-    frontendTools: [],
+    frontendTools: [FRONTEND_TOOL_MAP['cells:0.0.1']],
     environmentName: 'ai-agents-env',
     icon: 'table',
     emoji: '📦',
@@ -4025,23 +4027,43 @@ export const EXAMPLE_OUTPUT_AGENTSPEC_0_0_1 = {
             summary: 'Sales chart',
         },
         {
-            text: 'Create a CSV file named sales.csv with sample sales for the last 7 days, in a ```csv fenced block whose first line is `# filename: sales.csv`.',
-            summary: 'CSV file',
+            text: 'Give me a spreadsheet of twelve months of sales by region (North, South, Online), with a Month column, as one ```csv fenced block whose first line is `# filename: sales.csv`.',
+            summary: 'Sales spreadsheet',
+        },
+        {
+            text: 'Chart the sales spreadsheet: a column chart of the three regions by month, titled Sales by region, inserted on the grid below the data.',
+            summary: 'Chart the spreadsheet',
+        },
+        {
+            text: 'Create a YAML file named config.yaml for a small web service (name, port, log level and two routes), in a ```yaml fenced block whose first line is `# filename: config.yaml`.',
+            summary: 'YAML file',
         },
     ],
-    welcomeMessage: 'Example output agent ready. Ask for a TABLE, JSON, a CHART or a FILE and I will answer with exactly one structured output block.',
+    welcomeMessage: 'Example output agent ready. Ask for a TABLE, JSON, a CHART, a SPREADSHEET or a FILE and I will answer with exactly one structured output block; once a spreadsheet is shown, ask me to chart it on its grid.',
     welcomeNotebook: undefined,
     welcomeDocument: undefined,
     sandboxVariant: 'jupyter-server',
     harness: 'pydantic-ai',
     systemPrompt: `You are the Example Output Agent.
-The user may request one of exactly four output modes: TABLE, JSON, CHART, or FILE. For each response, emit exactly one mode and nothing else: no prose before or after the block. Answer from what you know: do not run code or call tools to produce the block.
+The user may request one of exactly six output modes: TABLE, JSON, CHART, SPREADSHEET, FILE or SHEET CHART. For the first five, emit exactly one mode and nothing else: no prose before or after the block. Answer from what you know: do not run code or call tools to produce the block.
 Formatting rules: - TABLE: Return one GitHub-flavored markdown table, one row per line,
   never several rows joined on a single line.
 - JSON: Return exactly one fenced \`\`\`json code block. - CHART: Return exactly one fenced \`\`\`json code block whose first line is
   "// chart" and whose remaining body is valid ECharts option JSON.
+- SPREADSHEET: Return exactly one fenced \`\`\`csv code block whose first
+  line is "# filename: <name>.csv", then a header row, then one row per
+  line, comma-separated, numbers without thousands separators or units.
 - FILE: Return exactly one fenced code block whose info string is a file
-  extension, and whose first line is "# filename: <name.ext>".
+  extension other than csv or tsv, and whose first line is
+  "# filename: <name.ext>".
+- SHEET CHART: when asked to chart, plot or graph the spreadsheet already
+  shown (the last SPREADSHEET answer), do not write a block: work on the
+  grid with the Cells tools. Call cells_read_range with no range to find
+  the data, then cells_insert_chart over that range (headers included) with
+  the type and title asked for, at the first column two rows below the
+  data (for data in A1:D13, at A15), unless told where. Answer in one short
+  sentence naming the chart and its range. If the tools say no grid is
+  shown, ask for the spreadsheet first.
 
 If mode is ambiguous, default to JSON.`,
     systemPromptCodemodeAddons: undefined,

package/lib/specs/frontendTools.d.ts

@@ -7,6 +7,7 @@
  * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
  */
 import type { FrontendToolSpec } from '../types';
+export declare const CELLS_FRONTEND_TOOL_SPEC_0_0_1: FrontendToolSpec;
 export declare const DECKS_FRONTEND_TOOL_SPEC_0_0_1: FrontendToolSpec;
 export declare const JUPYTER_NOTEBOOK_EDIT_FRONTEND_TOOL_SPEC_0_0_1: FrontendToolSpec;
 export declare const JUPYTER_NOTEBOOK_PROPOSE_FRONTEND_TOOL_SPEC_0_0_1: FrontendToolSpec;

package/lib/specs/frontendTools.js

@@ -5,6 +5,23 @@
 // ============================================================================
 // Frontend Tool Definitions
 // ============================================================================
+export const CELLS_FRONTEND_TOOL_SPEC_0_0_1 = {
+    id: 'cells',
+    version: '0.0.1',
+    name: 'Cells',
+    description: "Read and write the spreadsheet on the person's screen, and chart it — the grid drawn by Datalayer Cells.",
+    tags: ['frontend', 'cells', 'spreadsheets'],
+    enabled: true,
+    toolset: [
+        'cells_read_range',
+        'cells_write_range',
+        'cells_insert_chart',
+        'cells_list_charts',
+        'cells_select_range',
+    ],
+    icon: '@primer/octicons-react:table',
+    emoji: '🧮',
+};
 export const DECKS_FRONTEND_TOOL_SPEC_0_0_1 = {
     id: 'decks',
     version: '0.0.1',
@@ -101,6 +118,7 @@ export const LEXICAL_DOCUMENT_FRONTEND_TOOL_SPEC_0_0_1 = {
 // Frontend Tool Catalog
 // ============================================================================
 export const FRONTEND_TOOL_CATALOG = {
+    cells: CELLS_FRONTEND_TOOL_SPEC_0_0_1,
     decks: DECKS_FRONTEND_TOOL_SPEC_0_0_1,
     'jupyter-notebook-edit': JUPYTER_NOTEBOOK_EDIT_FRONTEND_TOOL_SPEC_0_0_1,
     'jupyter-notebook-propose': JUPYTER_NOTEBOOK_PROPOSE_FRONTEND_TOOL_SPEC_0_0_1,

package/lib/specs/mcpServers.js

@@ -44,16 +44,10 @@ export const DATALAYER_MCP_SERVER_0_0_1 = {
     description: 'Read, edit and run Jupyter notebooks on Datalayer, with sandboxes and data',
     icon: '@datalayer/icons-react:datalayer',
     emoji: '🚀',
-    url: '',
-    command: 'npx',
-    args: [
-        '-y',
-        'mcp-remote',
-        'https://mcp.datalayer.run/mcp',
-        '--header',
-        'Authorization: Bearer ${DATALAYER_API_KEY}',
-    ],
-    transport: 'stdio',
+    url: 'https://mcp.datalayer.run/mcp',
+    args: [],
+    headers: { Authorization: 'Bearer ${DATALAYER_API_KEY}' },
+    transport: 'streamable-http',
     enabled: false,
     isAvailable: false,
     tools: [],
@@ -66,16 +60,10 @@ export const EARTHDATA_MCP_SERVER_0_0_1 = {
     description: 'Access NASA Earthdata search and metadata capabilities',
     icon: '@datalayer/icons-react:globe-americas',
     emoji: '🌍',
-    url: '',
-    command: 'npx',
-    args: [
-        '-y',
-        'mcp-remote',
-        'https://mcp.datalayer.run/mcp?only=earthdata',
-        '--header',
-        'Authorization: Bearer ${DATALAYER_API_KEY}',
-    ],
-    transport: 'stdio',
+    url: 'https://mcp.datalayer.run/mcp?only=earthdata',
+    args: [],
+    headers: { Authorization: 'Bearer ${DATALAYER_API_KEY}' },
+    transport: 'streamable-http',
     enabled: true,
     isAvailable: false,
     tools: [],
@@ -165,16 +153,10 @@ export const HUGGINGFACE_MCP_SERVER_0_0_1 = {
     description: 'Hugging Face models, datasets, spaces, and papers access',
     icon: '@primer/octicons-react:hubot',
     emoji: '🤗',
-    url: '',
-    command: 'npx',
-    args: [
-        '-y',
-        'mcp-remote',
-        'https://huggingface.co/mcp',
-        '--header',
-        'Authorization: Bearer ${HF_TOKEN}',
-    ],
-    transport: 'stdio',
+    url: 'https://huggingface.co/mcp',
+    args: [],
+    headers: { Authorization: 'Bearer ${HF_TOKEN}' },
+    transport: 'streamable-http',
     enabled: false,
     isAvailable: false,
     tools: [],
@@ -187,16 +169,10 @@ export const KAGGLE_MCP_SERVER_0_0_1 = {
     description: 'Kaggle datasets, models, competitions, and notebooks access',
     icon: '@datalayer/icons-react:kaggle',
     emoji: '🏆',
-    url: '',
-    command: 'npx',
-    args: [
-        '-y',
-        'mcp-remote',
-        'https://www.kaggle.com/mcp',
-        '--header',
-        'Authorization: Bearer ${KAGGLE_API_TOKEN}',
-    ],
-    transport: 'stdio',
+    url: 'https://www.kaggle.com/mcp',
+    args: [],
+    headers: { Authorization: 'Bearer ${KAGGLE_API_TOKEN}' },
+    transport: 'streamable-http',
     enabled: false,
     isAvailable: false,
     tools: [],
@@ -209,16 +185,10 @@ export const ODOO_ACCOUNTING_MCP_SERVER_0_0_1 = {
     description: "An accountant's day in Odoo — invoices, bills, journal entries, reconciliations, bank lines and tax returns — through the Datalayer MCP server",
     icon: '@datalayer/icons-react:odoo',
     emoji: '🧮',
-    url: '',
-    command: 'npx',
-    args: [
-        '-y',
-        'mcp-remote',
-        'https://mcp.datalayer.run/mcp?only=odoo-accounting',
-        '--header',
-        'Authorization: Bearer ${DATALAYER_API_KEY}',
-    ],
-    transport: 'stdio',
+    url: 'https://mcp.datalayer.run/mcp?only=odoo-accounting',
+    args: [],
+    headers: { Authorization: 'Bearer ${DATALAYER_API_KEY}' },
+    transport: 'streamable-http',
     enabled: false,
     isAvailable: false,
     tools: [],

package/lib/types/mcp.d.ts

@@ -29,13 +29,15 @@ export interface MCPServer {
     enabled: boolean;
     /** List of available tools */
     tools: MCPServerTool[];
-    /** Command to run the MCP server (e.g., 'npx', 'uvx') */
+    /** Command to run a local MCP server (e.g., 'npx', 'uvx'); a remote one names none and is reached at `url` */
     command?: string;
     /** Command arguments for the MCP server */
     args: string[];
+    /** The headers a remote server is sent with every request, `${VAR}` expanded as it starts: the bearer among them */
+    headers?: Record<string, string>;
     /** Whether the server is available (based on tool discovery) */
     isAvailable: boolean;
-    /** Transport type: 'stdio', 'http', or 'streamable-http' for a server its command runs as a local HTTP process at `url` */
+    /** Transport type: 'stdio', 'http', or 'streamable-http' — a remote server reached at `url` with its `headers` when it has no `command`, a command run as a local HTTP process at `url` when it has one */
     transport: 'stdio' | 'http' | 'streamable-http';
     /** Environment variables required by this server (e.g., API keys) */
     requiredEnvVars?: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datalayer/agent-runtimes",
-    "version": "1.5.88",
+    "version": "1.5.89",
     "type": "module",
     "workspaces": [
         ".",
@@ -154,6 +154,7 @@
         "@anthropic-ai/sdk": "^0.52.0",
         "@datalayer/agent-teams": "^1.0.0",
         "@datalayer/core": "^1.2.18",
+        "@datalayer/cells": "^1.0.0",
         "@datalayer/decks": "^1.0.4",
         "@datalayer/design": "^1.0.10",
         "@datalayer/icons-react": "^1.0.16",

package/scripts/codegen/generate_mcp_servers.py

@@ -105,6 +105,11 @@ def generate_python_code(specs: list[dict[str, Any]]) -> str:
         icon = f'"{spec.get("icon")}"' if spec.get("icon") else "None"
         emoji = f'"{spec.get("emoji")}"' if spec.get("emoji") else "None"
 
+        # A remote server names no command: it is reached at its url with its
+        # headers (`transport: streamable-http`, the Datalayer gateway's
+        # toolsets). A local one names the command that runs it.
+        command = f'"{spec["command"]}"' if spec.get("command") else "None"
+
         lines.extend(
             [
                 f"{const_name} = MCPServer(",
@@ -114,17 +119,26 @@ def generate_python_code(specs: list[dict[str, Any]]) -> str:
                 f'    description="{spec["description"]}",',
                 f"    icon={icon},",
                 f"    emoji={emoji},",
-                f'    command="{spec["command"]}",',
+                f"    command={command},",
                 f"    args={args_formatted},",
                 f'    transport="{spec.get("transport", "stdio")}",',
                 f"    enabled={spec.get('enabled', False)},",
                 "    tools=[],",
             ]
         )
-        # A server its command runs as a local HTTP process: where it is
-        # reached (W-02, `google-workspace`).
+        # Where an HTTP server is reached: a remote one is connected to there
+        # (`odoo-accounting`), a local one's command listens there (W-02,
+        # `google-workspace`).
         if spec.get("url"):
             lines.append(f'    url="{spec["url"]}",')
+        # The headers a remote server is sent with every request, their
+        # `${VAR}` expanded as it starts (the bearer among them).
+        headers = spec.get("headers") or {}
+        if headers:
+            lines.append("    headers={")
+            for key, value in headers.items():
+                lines.append(f'        "{key}": "{value}",')
+            lines.append("    },")
 
         # Add env field if present
         if env_formatted:
@@ -285,8 +299,20 @@ def generate_typescript_code(specs: list[dict[str, Any]]) -> str:
                 f"  icon: {icon},",
                 f"  emoji: {emoji},",
                 f"  url: '{spec.get('url', '')}',",
-                f"  command: '{spec['command']}',",
+                *([f"  command: '{spec['command']}',"] if spec.get("command") else []),
                 f"  args: {args_formatted},",
+                *(
+                    [
+                        "  headers: {"
+                        + ", ".join(
+                            f"'{key}': '{value}'"
+                            for key, value in (spec.get("headers") or {}).items()
+                        )
+                        + "},"
+                    ]
+                    if spec.get("headers")
+                    else []
+                ),
                 f"  transport: '{spec.get('transport', 'stdio')}',",
                 f"  enabled: {str(spec.get('enabled', False)).lower()},",
                 "  isAvailable: false,",