@datalayer/agent-runtimes 1.5.87 → 1.5.89

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/harnesses.d.ts

@@ -15,6 +15,7 @@ export declare const GEMINI_CLI_HARNESS_0_0_1: HarnessSpec;
 export declare const GOOSE_HARNESS_0_0_1: HarnessSpec;
 export declare const OPENCODE_HARNESS_0_0_1: HarnessSpec;
 export declare const OPENHANDS_HARNESS_0_0_1: HarnessSpec;
+export declare const PI_HARNESS_0_0_1: HarnessSpec;
 export declare const HARNESS_CATALOGUE: Record<string, HarnessSpec>;
 /** A harness by id. */
 export declare function getHarness(harnessId: string): HarnessSpec | undefined;

package/lib/specs/harnesses.js

@@ -175,7 +175,7 @@ export const FAST_AGENT_HARNESS_0_0_1 = {
     name: 'fast-agent',
     description: "llmindset's agent framework served over ACP; each agent it defines is a session mode, with any model provider it is configured with.",
     enabled: false,
-    unavailable_because: 'the catalogue offers four harnesses today — Claude Code, Codex, OpenCode and Gemini CLI (28 October 2026); fast-agent is a framework served over ACP, not a coding agent, its adapter is a Python tool the runtime image does not carry, and it has not been drilled on Datalayer.',
+    unavailable_because: 'the catalogue offers four harnesses today — Claude Code, Codex, OpenCode and pi (28 October 2026); fast-agent is a framework served over ACP, not a coding agent, its adapter is a Python tool the runtime image does not carry, and it has not been drilled on Datalayer.',
     tags: ['harness', 'framework'],
     docs: 'https://github.com/evalstate/fast-agent/blob/main/docs/docs/acp/index.md',
     acp: {
@@ -230,8 +230,8 @@ export const GEMINI_CLI_HARNESS_0_0_1 = {
     version: '0.0.1',
     name: 'Gemini CLI',
     description: "Google's coding agent, which speaks ACP itself when started with --experimental-acp.",
-    enabled: true,
-    unavailable_because: '',
+    enabled: false,
+    unavailable_because: "the catalogue offers four harnesses today — Claude Code, Codex, OpenCode and pi (28 October 2026); Gemini CLI's API host (generativelanguage.googleapis.com) is outside a Datalayer runtime's egress boundary and is not routed through ai-inference, so it stays unfunded and unoffered there (the user's decision, 28 October 2026).",
     tags: ['harness'],
     docs: 'https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/cli-reference.md',
     acp: {
@@ -288,7 +288,7 @@ export const GOOSE_HARNESS_0_0_1 = {
     name: 'goose',
     description: "Block's open agent (now the Agentic AI Foundation's), which speaks ACP itself with goose acp; any model provider it is configured with.",
     enabled: false,
-    unavailable_because: 'the catalogue offers four harnesses today — Claude Code, Codex, OpenCode and Gemini CLI (28 October 2026); goose is a binary of its own release, not an npm adapter, the runtime image does not carry it, and it has not been drilled on Datalayer.',
+    unavailable_because: 'the catalogue offers four harnesses today — Claude Code, Codex, OpenCode and pi (28 October 2026); goose is a binary of its own release, not an npm adapter, the runtime image does not carry it, and it has not been drilled on Datalayer.',
     tags: ['harness'],
     docs: 'https://block.github.io/goose/docs/gdk/acp/',
     acp: {
@@ -400,7 +400,7 @@ export const OPENHANDS_HARNESS_0_0_1 = {
     name: 'OpenHands',
     description: 'The OpenHands CLI, which speaks ACP itself with openhands acp; any model provider it is configured with.',
     enabled: false,
-    unavailable_because: "the catalogue offers four harnesses today — Claude Code, Codex, OpenCode and Gemini CLI (28 October 2026); OpenHands' adapter is a Python tool the runtime image does not carry, and it has not been drilled on Datalayer.",
+    unavailable_because: "the catalogue offers four harnesses today — Claude Code, Codex, OpenCode and pi (28 October 2026); OpenHands' adapter is a Python tool the runtime image does not carry, and it has not been drilled on Datalayer.",
     tags: ['harness'],
     docs: 'https://docs.openhands.dev/openhands/usage/run-openhands/acp',
     acp: {
@@ -456,6 +456,62 @@ export const OPENHANDS_HARNESS_0_0_1 = {
         note: "Open source under MIT, no vendor terms of its own; the model provider's terms apply to the key. Launched as openhands acp (OpenHands-CLI README; docs.openhands.dev's ACP page); resumes with --resume; reads skills from .agents/skills (.openhands/skills is legacy).",
     },
 };
+export const PI_HARNESS_0_0_1 = {
+    id: 'pi',
+    version: '0.0.1',
+    name: 'pi',
+    description: "Earendil's pi coding agent, driven over ACP through the pi-acp adapter, which spawns the published pi executable; any model provider pi is configured with.",
+    enabled: true,
+    unavailable_because: '',
+    tags: ['harness'],
+    docs: 'https://github.com/svkozak/pi-acp',
+    acp: {
+        command: 'npx',
+        args: ['-y', 'pi-acp@0.0.34'],
+        protocolVersion: 1,
+        loadSession: true,
+        mcp: 'lend',
+        modes: [],
+        env: {},
+        nativeSession: 'none',
+    },
+    requires: {
+        secrets: ['ANTHROPIC_API_KEY'],
+        binaries: ['node', 'git'],
+    },
+    terms: {
+        servedToThirdParties: 'permitted',
+        licence: 'MIT (adapter); MIT (the agent, @earendil-works/pi-coding-agent 1.4.0)',
+    },
+    skills: {
+        format: 'skill-md',
+        dir: '.pi/skills',
+    },
+    honours: {
+        model: true,
+        subagents: false,
+    },
+    capabilities: {
+        resume: 'load',
+        forkHistory: 'replay',
+        interrupt: true,
+        steering: false,
+        images: false,
+        compaction: 'own',
+        modes: [],
+        autoRun: [],
+    },
+    instructionsFile: 'AGENTS.md',
+    registered: {
+        adapter: 'pi-acp',
+        version: '0.0.34',
+        licenceSource: 'https://www.npmjs.com/package/pi-acp',
+        termsSource: 'https://github.com/earendil-works/pi/blob/main/LICENSE',
+        credential: "The provider's key pi is configured with; ANTHROPIC_API_KEY declared, the person's own",
+        binaries: 'Node 22 (pi-coding-agent engines.node >=22.19.0; pi-acp >=20), the pi executable 1.4.0 on the PATH (@earendil-works/pi-coding-agent), git',
+        note: "Read 2026-10-28. pi speaks no ACP itself; pi-acp 0.0.34 (MIT, an individual's, github.com/svkozak/pi-acp) speaks ACP JSON-RPC over stdio and spawns the published `pi` executable with `pi --mode rpc`, so pi 1.4.0 runs as published — chosen over @automatalabs/pi-acp 0.9.4 (Apache-2.0, in-process, which embeds pi 0.87.1 through its SDK on a fork's package). Open source under MIT on both sides, no vendor terms of their own; the model provider's terms apply to the key. Session persistence through pi's own session files (session/load).",
+    },
+};
 export const HARNESS_CATALOGUE = {
     'claude-code': CLAUDE_CODE_HARNESS_0_0_1,
     codex: CODEX_HARNESS_0_0_1,
@@ -465,6 +521,7 @@ export const HARNESS_CATALOGUE = {
     goose: GOOSE_HARNESS_0_0_1,
     opencode: OPENCODE_HARNESS_0_0_1,
     openhands: OPENHANDS_HARNESS_0_0_1,
+    pi: PI_HARNESS_0_0_1,
 };
 /** A harness by id. */
 export function getHarness(harnessId) {
@@ -844,20 +901,6 @@ export const LISTED_HARNESSES = [
         servedToThirdParties: 'permitted',
         note: 'Bridges ACP to an OpenClaw Gateway, whose providers keep their own terms.',
     },
-    {
-        id: 'pi',
-        name: 'pi (through pi-acp)',
-        docs: 'https://github.com/svkozak/pi-acp',
-        adapter: 'pi-acp',
-        version: '0.0.34',
-        command: 'npx -y pi-acp',
-        licence: 'MIT',
-        licenceSource: 'https://github.com/svkozak/pi-acp/blob/main/LICENSE',
-        termsSource: 'https://github.com/svkozak/pi-acp/blob/main/LICENSE',
-        credential: "pi's configured provider's API key (a subscription login carries its provider's terms)",
-        servedToThirdParties: 'permitted',
-        note: 'Spawns pi --mode rpc from @earendil-works/pi-coding-agent (MIT).',
-    },
     {
         id: 'poolside',
         name: 'Poolside (pool)',

package/lib/specs/index.d.ts

@@ -26,7 +26,7 @@ export * from './frames';
 export * from './cogs';
 export * from './harnesses';
 export * from './sessionFiles';
-export * from './standards';
+export * from './policies';
 export * from './guards';
 export * from './gates';
 export * from './tracks';

package/lib/specs/index.js

@@ -30,7 +30,7 @@ export * from './frames.js';
 export * from './cogs.js';
 export * from './harnesses.js';
 export * from './sessionFiles.js';
-export * from './standards.js';
+export * from './policies.js';
 export * from './guards.js';
 export * from './gates.js';
 export * from './tracks.js';

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.87",
+    "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_apps.py

@@ -94,7 +94,7 @@ def python_of(specs_dir: Path, identity: str) -> str:
     Its own ``app.py`` when it was built in Python; otherwise the file `loop
     apps eject` writes from its spec, so every example can be read in Python.
     """
-    from agent_runtimes.loop.apps.scaffold import eject_text  # noqa: PLC0415
+    from agent_runtimes.apps.scaffold import eject_text  # noqa: PLC0415
 
     code = specs_dir / identity / "app.py"
     if code.is_file():

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,",

package/scripts/validate_pap_examples.py

@@ -15,7 +15,7 @@ import json
 import sys
 from pathlib import Path
 
-from agent_runtimes.loop.apps.build import build
+from agent_runtimes.apps.build import build
 
 ROOT = Path(__file__).parents[1]
 EXAMPLES = ROOT / "examples" / "personal-agent-protocol"