@datalayer/agent-runtimes 1.5.87 → 1.5.89

package/lib/examples/AgentOutputsExample.js

@@ -19,6 +19,13 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  * We subscribe to the chat store, detect the output type of the latest
  * assistant message, auto-switch the sidebar tab, and render the payload
  * inline in the sidebar.
+ *
+ * A spreadsheet (a ```csv block) is also drawn in the chat message itself, by
+ * the `AgentOutputsSheetsPlugin` renderer the chat reads from its
+ * `ChatCodeBlock` point; the message's grid and the Sheet tab's are one
+ * workbook. The Cells agent tools (`AgentOutputsSheetToolsPlugin`, the
+ * `cells` bundle the spec's `frontend_tools` names) act on the last one, so
+ * "Chart the spreadsheet" inserts a chart that appears on both grids.
  */
 /// <reference types="vite/client" />
 import { useEffect, useState, useRef, useMemo } from 'react';
@@ -26,15 +33,16 @@ import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
 import { Text, Button, Heading, Label } from '@primer/react';
 import { TableIcon, FileIcon, CodeIcon, GraphIcon, DownloadIcon, } from '@primer/octicons-react';
 import { Box } from '@datalayer/primer-addons';
+import { CellsProvider, Spreadsheet } from '@datalayer/cells';
 import { AuthRequiredView } from './components/index.js';
 import { useSimpleAuthStore } from '@datalayer/core/lib/views/otel/index.js';
 import { ThemedProvider } from './utils/themedProvider.js';
 import { uniqueAgentId } from './utils/agentId.js';
 import { LoopEmbed } from '../apps/index.js';
-import { AgentOutputsPlugin } from '../apps/plugins/agent-outputs/index.js';
+import { downloadSheet, parseSheetBlock, useFitHeight, useSheetModel, } from '../apps/plugins/agent-outputs/sheets.js';
+import { AGENT_OUTPUTS_LOOP_PLUGINS } from './utils/agentOutputsPlugins.js';
 import { useChatStore } from '../stores/chatStore.js';
 import { useExampleAgentRuntimesUrl } from './utils/useExampleAgentRuntimesUrl.js';
-const LOOP_PLUGINS_AGENTOUT = [AgentOutputsPlugin];
 const queryClient = new QueryClient();
 // ─── Constants ─────────────────────────────────────────────────────────────
 const AGENT_NAME = 'outputs-example-agent';
@@ -57,8 +65,6 @@ const expandCompactMarkdownTable = (text) => {
     return text.replace(/\|\|/g, '|\n|');
 };
 const EXT_LIKE_INFOS = new Set([
-    'csv',
-    'tsv',
     'txt',
     'md',
     'markdown',
@@ -119,6 +125,20 @@ const detectOutput = (m) => {
         }
         // File: info string is a known extension OR first line declares a filename.
         const filenameMatch = firstLine.match(/^#\s*filename:\s*([\w.-]+)/i);
+        // Spreadsheet: a CSV or TSV, by its fence (`csv`, `tsv`, `spreadsheet`,
+        // `cells`) or a `# filename:` ending in .csv or .tsv — read as the chat's
+        // renderer reads it, so both grids show the same workbook.
+        const sheet = parseSheetBlock(info, rawBody);
+        if (sheet) {
+            return {
+                tab: 'sheet',
+                payload: sheet.source,
+                filename: sheet.name,
+                extension: sheet.extension,
+                sheet,
+                messageId: m.id,
+            };
+        }
         if (filenameMatch || EXT_LIKE_INFOS.has(info)) {
             const filename = filenameMatch?.[1] ?? (info ? `output.${info}` : 'output.txt');
             return {
@@ -257,6 +277,24 @@ const ChartView = ({ source }) => {
     }
     return (_jsx(ReactECharts, { option: option, style: { height: 280, width: '100%' } }));
 };
+// ─── Spreadsheet renderer (Datalayer Cells) ───────────────────────────────
+/**
+ * A CSV or TSV the agent wrote, in a Datalayer Cells grid: the workbook the
+ * chat message shows too (read once, on this thread), editable here, and
+ * where the agent's chart goes.
+ */
+const SheetView = ({ block }) => {
+    const { model, error } = useSheetModel(block);
+    // As tall as its data and charts (up to 640 px), so a chart the agent adds shows.
+    const height = useFitHeight(model, 200, 640);
+    if (error) {
+        return (_jsxs(Text, { sx: { color: 'danger.fg', fontSize: 0 }, children: ["Could not read the spreadsheet: ", error] }));
+    }
+    if (!model) {
+        return _jsx(Text, { sx: { color: 'fg.muted', fontSize: 0 }, children: "Reading\u2026" });
+    }
+    return (_jsx(CellsProvider, { model: model, children: _jsx(Box, { height: height, border: "1px solid", borderColor: "border.muted", children: _jsx(Spreadsheet, { model: model, "aria-label": block.name }) }) }));
+};
 // ─── Inner component (rendered after auth) ─────────────────────────────────
 const AgentOutputsInner = () => {
     // The Loop creates the agent from the plugin's blueprint when it connects;
@@ -312,10 +350,11 @@ const AgentOutputsInner = () => {
         document.body.removeChild(a);
         URL.revokeObjectURL(url);
     };
-    return (_jsxs(Box, { height: "100%", display: "flex", flexDirection: "column", children: [_jsxs(Box, { display: "flex", alignItems: "center", gap: 2, px: 3, py: 2, borderBottom: "1px solid", borderColor: "border.default", flexShrink: 0, children: [_jsx(TableIcon, { size: 16 }), _jsx(Heading, { as: "h3", sx: { fontSize: 2, flex: 1 }, children: "Agent Outputs \u2014 Local Runtime" })] }), _jsxs(Box, { flex: 1, minHeight: 0, display: "flex", children: [_jsx(Box, { flex: 1, minWidth: 0, children: _jsx(LoopEmbed, { serverUrl: agentBaseUrl, target: "local", showAgentVariants: true, agentId: agentName, editors: false, showHeader: true, plugins: LOOP_PLUGINS_AGENTOUT }) }), _jsxs(Box, { width: 420, borderLeft: "1px solid", borderColor: "border.default", display: "flex", flexDirection: "column", overflow: "hidden", children: [_jsx(Box, { display: "flex", borderBottom: "1px solid", borderColor: "border.default", flexShrink: 0, children: [
+    return (_jsxs(Box, { height: "100%", display: "flex", flexDirection: "column", children: [_jsxs(Box, { display: "flex", alignItems: "center", gap: 2, px: 3, py: 2, borderBottom: "1px solid", borderColor: "border.default", flexShrink: 0, children: [_jsx(TableIcon, { size: 16 }), _jsx(Heading, { as: "h3", sx: { fontSize: 2, flex: 1 }, children: "Agent Outputs \u2014 Local Runtime" })] }), _jsxs(Box, { flex: 1, minHeight: 0, display: "flex", children: [_jsx(Box, { flex: 1, minWidth: 0, children: _jsx(LoopEmbed, { serverUrl: agentBaseUrl, target: "local", showAgentVariants: true, agentId: agentName, editors: false, showHeader: true, plugins: AGENT_OUTPUTS_LOOP_PLUGINS }) }), _jsxs(Box, { width: 420, borderLeft: "1px solid", borderColor: "border.default", display: "flex", flexDirection: "column", overflow: "hidden", children: [_jsx(Box, { display: "flex", borderBottom: "1px solid", borderColor: "border.default", flexShrink: 0, children: [
                                     { key: 'table', icon: TableIcon, label: 'Table' },
                                     { key: 'json', icon: CodeIcon, label: 'JSON' },
                                     { key: 'chart', icon: GraphIcon, label: 'Chart' },
+                                    { key: 'sheet', icon: TableIcon, label: 'Sheet' },
                                     { key: 'files', icon: FileIcon, label: 'Files' },
                                 ].map(t => {
                                     const n = countByTab(t.key);
@@ -328,14 +367,15 @@ const AgentOutputsInner = () => {
                                             borderColor: activeTab === t.key ? 'accent.fg' : 'transparent',
                                             fontWeight: activeTab === t.key ? 'bold' : 'normal',
                                         }, children: [t.label, n > 0 ? ` (${n})` : ''] }, t.key));
-                                }) }), _jsxs(Box, { p: 3, flex: 1, overflow: "auto", children: [_jsxs(Heading, { as: "h4", sx: { fontSize: 1, mb: 2 }, children: [activeTab.charAt(0).toUpperCase() + activeTab.slice(1), " outputs"] }), filtered.length === 0 ? (_jsxs(Text, { sx: { color: 'fg.muted', fontSize: 0 }, children: ["No ", activeTab, " outputs yet. Use one of the openers in the chat to produce one \u2014 the side panel will switch to the matching tab automatically."] })) : (filtered.map((d, idx) => (_jsxs(Box, { p: 2, mb: 2, border: "1px solid", borderColor: "border.default", borderRadius: 2, children: [_jsxs(Box, { display: "flex", justifyContent: "space-between", alignItems: "center", mb: 2, gap: 2, children: [_jsx(Text, { sx: { fontSize: 1, fontWeight: 'bold' }, children: d.filename ?? `${d.tab} output` }), _jsx(Label, { size: "small", variant: "secondary", children: d.tab })] }), d.tab === 'table' && _jsx(MarkdownTable, { source: d.payload }), d.tab === 'json' && (_jsx(Box, { as: "pre", bg: "canvas.default", p: 2, borderRadius: 2, fontFamily: "mono", fontSize: 0, maxHeight: 320, overflow: "auto", whiteSpace: "pre-wrap", m: 0, children: (() => {
+                                }) }), _jsxs(Box, { p: 3, flex: 1, overflow: "auto", children: [_jsxs(Heading, { as: "h4", sx: { fontSize: 1, mb: 2 }, children: [activeTab.charAt(0).toUpperCase() + activeTab.slice(1), " outputs"] }), filtered.length === 0 ? (_jsxs(Text, { sx: { color: 'fg.muted', fontSize: 0 }, children: ["No ", activeTab, " outputs yet. Use one of the openers in the chat to produce one \u2014 the side panel will switch to the matching tab automatically.", activeTab === 'sheet' &&
+                                                ' For a spreadsheet, ask for the data as CSV, for example: "Give me twelve months of sales by region as a CSV".'] })) : (filtered.map((d, idx) => (_jsxs(Box, { p: 2, mb: 2, border: "1px solid", borderColor: "border.default", borderRadius: 2, children: [_jsxs(Box, { display: "flex", justifyContent: "space-between", alignItems: "center", mb: 2, gap: 2, children: [_jsx(Text, { sx: { fontSize: 1, fontWeight: 'bold' }, children: d.filename ?? `${d.tab} output` }), _jsx(Label, { size: "small", variant: "secondary", children: d.tab })] }), d.tab === 'table' && _jsx(MarkdownTable, { source: d.payload }), d.tab === 'json' && (_jsx(Box, { as: "pre", bg: "canvas.default", p: 2, borderRadius: 2, fontFamily: "mono", fontSize: 0, maxHeight: 320, overflow: "auto", whiteSpace: "pre-wrap", m: 0, children: (() => {
                                                     try {
                                                         return JSON.stringify(JSON.parse(d.payload), null, 2);
                                                     }
                                                     catch {
                                                         return d.payload;
                                                     }
-                                                })() })), d.tab === 'chart' && _jsx(ChartView, { source: d.payload }), d.tab === 'files' && (_jsxs(_Fragment, { children: [_jsx(Box, { as: "pre", bg: "canvas.default", p: 2, borderRadius: 2, fontFamily: "mono", fontSize: 0, maxHeight: 200, overflow: "auto", whiteSpace: "pre-wrap", m: 0, mb: 2, children: d.payload }), _jsxs(Button, { size: "small", leadingVisual: DownloadIcon, onClick: () => download(d), children: ["Download ", d.filename ?? 'file'] })] }))] }, d.messageId + ':' + idx))))] })] })] })] }));
+                                                })() })), d.tab === 'chart' && _jsx(ChartView, { source: d.payload }), d.tab === 'sheet' && d.sheet && (_jsxs(_Fragment, { children: [_jsx(SheetView, { block: d.sheet }), _jsx(Box, { mt: 2, children: _jsxs(Button, { size: "small", leadingVisual: DownloadIcon, onClick: () => downloadSheet(d.sheet), children: ["Download ", d.filename ?? 'spreadsheet'] }) })] })), d.tab === 'files' && (_jsxs(_Fragment, { children: [_jsx(Box, { as: "pre", bg: "canvas.default", p: 2, borderRadius: 2, fontFamily: "mono", fontSize: 0, maxHeight: 200, overflow: "auto", whiteSpace: "pre-wrap", m: 0, mb: 2, children: d.payload }), _jsxs(Button, { size: "small", leadingVisual: DownloadIcon, onClick: () => download(d), children: ["Download ", d.filename ?? 'file'] })] }))] }, d.messageId + ':' + idx))))] })] })] })] }));
 };
 // ─── Sync token to core IAM store ──────────────────────────────────────────
 const syncTokenToIamStore = (token) => {

package/lib/examples/utils/agentOutputsPlugins.d.ts

@@ -0,0 +1,2 @@
+/** The Loop's plugins on the outputs page: the agent, the chat's grids, the grid's tools. */
+export declare const AGENT_OUTPUTS_LOOP_PLUGINS: import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, unknown>[];

package/lib/examples/utils/agentOutputsPlugins.js

@@ -0,0 +1,27 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * The Loop plugins of the outputs example (`AgentOutputsExample`): the
+ * `example-output` agent, the chat's spreadsheet renderer, and the Cells
+ * agent tools on the last spreadsheet answered. The agent runs on a server,
+ * so the page names the bundle whose tools it hands it — `cells`, the grid's
+ * tools, run on this page's reactor — through the chat extras.
+ *
+ * Apart from the page, so a test reads the list without mounting the Loop.
+ *
+ * @module examples/utils/agentOutputsPlugins
+ */
+import { AgentOutputsPlugin } from '../../apps/plugins/agent-outputs/index.js';
+import { AgentOutputsSheetsPlugin, AgentOutputsSheetToolsPlugin, } from '../../apps/plugins/agent-outputs/sheets.js';
+import { createChatExtrasPlugin } from '../../apps/plugins/chat-extras/index.js';
+const SHEET_EXTRAS = createChatExtrasPlugin();
+SHEET_EXTRAS.setExtras({ agentToolBundles: ['cells'] });
+/** The Loop's plugins on the outputs page: the agent, the chat's grids, the grid's tools. */
+export const AGENT_OUTPUTS_LOOP_PLUGINS = [
+    AgentOutputsPlugin,
+    AgentOutputsSheetsPlugin,
+    AgentOutputsSheetToolsPlugin,
+    SHEET_EXTRAS.plugin,
+];

package/lib/portable/hosts/client.d.ts

@@ -35,16 +35,26 @@ export type BoundHost = Readonly<{
  * with its key in `X-Datalayer-Host-Key`, or as a person, with the host token
  * the exchange answered. Any host speaks them.
  */
+/** Which app a host runs as: Datalayer's own, or one the person brought (`custom`). */
+export type HostProvider = 'datalayer' | 'custom';
 export declare class DatalayerHostClient {
     #private;
     readonly apiUrl: string;
     readonly fetchImplementation: typeof fetch;
     constructor(apiUrl: string, fetchImplementation?: typeof fetch);
-    /** Bind the installation its owner set up, with the code their browser carried. */
+    /**
+     * Bind the installation its owner set up, with the code their browser
+     * carried, asserting the app this host runs as: `datalayer` for
+     * Datalayer's own app, `custom` with the app's id for one the person
+     * brought. Datalayer refuses a provider that is not the one the
+     * installation was registered for (409), and a bind without one (422).
+     */
     bind(input: {
         code: string;
         externalId: string;
         name?: string;
+        provider: HostProvider;
+        customAppId?: string;
     }): Promise<BoundHost>;
     /** The installation was removed from its host: it ends at Datalayer (revocation). */
     uninstalled(hostKey: string): Promise<void>;

package/lib/portable/hosts/client.js

@@ -21,11 +21,6 @@ export class HostRefusedError extends Error {
         this.what = what;
     }
 }
-/**
- * The generic host routes of ai-agents a host calls besides the credential exchange: as the installation,
- * with its key in `X-Datalayer-Host-Key`, or as a person, with the host token
- * the exchange answered. Any host speaks them.
- */
 export class DatalayerHostClient {
     apiUrl;
     fetchImplementation;
@@ -54,13 +49,24 @@ export class DatalayerHostClient {
             throw new HostRefusedError(response.status, typeof body.detail === 'string' ? body.detail : 'refused', what);
         return schema.parse(body);
     }
-    /** Bind the installation its owner set up, with the code their browser carried. */
+    /**
+     * Bind the installation its owner set up, with the code their browser
+     * carried, asserting the app this host runs as: `datalayer` for
+     * Datalayer's own app, `custom` with the app's id for one the person
+     * brought. Datalayer refuses a provider that is not the one the
+     * installation was registered for (409), and a bind without one (422).
+     */
     async bind(input) {
+        if (input.provider === 'custom' && !input.customAppId) {
+            throw new Error("A custom app's bind names its app id (customAppId): Datalayer refuses it otherwise.");
+        }
         const bound = await this.#call('Datalayer did not bind the installation', '/apps/hosts/bind', {
             body: {
                 code: input.code,
                 external_id: input.externalId,
                 name: input.name ?? '',
+                provider: input.provider,
+                custom_app_id: input.provider === 'custom' ? (input.customAppId ?? '') : '',
             },
             method: 'POST',
         }, bindSchema);

package/lib/portable/hosts/contracts.json

@@ -36,7 +36,9 @@
     "request": {
       "code": "dlhc_…",
       "external_id": "A0123:-:T0123",
-      "name": "Acme"
+      "name": "Acme",
+      "provider": "datalayer",
+      "custom_app_id": ""
     },
     "response_keys": [
       "success",
@@ -452,7 +454,9 @@
     "bind_request": {
       "code": "dlhc_…",
       "external_id": "123456789012345678:234567890123456789",
-      "name": "Acme"
+      "name": "Acme",
+      "provider": "datalayer",
+      "custom_app_id": ""
     },
     "external_user_id": "567890123456789012",
     "thread": {
@@ -501,7 +505,9 @@
     "bind_request": {
       "code": "dlhc_…",
       "external_id": "102290129340398:106540352242922",
-      "name": "Acme"
+      "name": "Acme",
+      "provider": "custom",
+      "custom_app_id": "1234567890"
     },
     "external_user_id": "US.13491208655302741918",
     "external_user_name": "Alice",

package/lib/portable/hosts/index.d.ts

@@ -21,7 +21,7 @@ export { AgUiFrames, readRunStream, type AgUiEvent } from '../agui';
 export * from '../semantic';
 export { askQuestionOf, semanticOf, turnOf, type TurnInfo, } from '../semanticOfAgUi';
 export * from './contracts';
-export { DatalayerHostClient, HostRefusedError, type BoundHost, type HostSelf, } from './client';
+export { DatalayerHostClient, HostRefusedError, type BoundHost, type HostProvider, type HostSelf, } from './client';
 export { agUiEventsOf, assertTrustedStreamUrl, DevelopmentCredentials, HostKeyCredentials, hostSessionOf, HostStarters, HttpAgentClient, InstallationCredentials, lastAnswer, type AgentClient, type HostCredentials, type HostKeyLookup, type HostSession, type HostShape, type HostTurnRequest, type Place, type SessionBinder, type Starter, type StarterSource, type TurnProvenance, type TurnStream, } from './agentClient';
 export { hostSessionUid } from './sessionUid';
 export { DATALAYER_ONLY, MAIL_WORDS, RENDERERS, renderApproval, type RenderedAction, type RenderedField, } from './approvalRenderers';

package/lib/portable/records.d.ts

@@ -15,7 +15,7 @@ export declare const RUN_END_WORDS: Record<string, string>;
 /**
  * The mark around what the runtime tells an application of a turn a personal
  * agent asked over PAP or PACT, before the request (`asked_for_said`,
- * `ASKED_FOR_TAG` in agent_runtimes.loop.apps.pap_company).
+ * `ASKED_FOR_TAG` in agent_runtimes.apps.pap_company).
  */
 export declare const ASKED_FOR_TAG = "asked-for";
 /**

package/lib/portable/records.js

@@ -23,7 +23,7 @@ export const RUN_END_WORDS = {
 /**
  * The mark around what the runtime tells an application of a turn a personal
  * agent asked over PAP or PACT, before the request (`asked_for_said`,
- * `ASKED_FOR_TAG` in agent_runtimes.loop.apps.pap_company).
+ * `ASKED_FOR_TAG` in agent_runtimes.apps.pap_company).
  */
 export const ASKED_FOR_TAG = 'asked-for';
 /**

package/lib/portable/semantic-events.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "about": "The semantic agent events a chat host renders (Slack, Discord:  DC-005, S-004, S-205), and the AG-UI events of agent-runtimes' session API (agent_runtimes/routes/apps.py, agent_runtimes/loop/apps/sessions.py, agent_runtimes/loop/apps/external_turns.py) each reduces to. src/portable/semanticOfAgUi.ts reduces every case (src/portable/__tests__/semantic.unit.test.ts); agent_runtimes/tests/test_semantic_events_contract.py holds the cases to what the runtime emits.",
+  "about": "The semantic agent events a chat host renders (Slack, Discord:  DC-005, S-004, S-205), and the AG-UI events of agent-runtimes' session API (agent_runtimes/routes/apps.py, agent_runtimes/apps/sessions.py, agent_runtimes/apps/external_turns.py) each reduces to. src/portable/semanticOfAgUi.ts reduces every case (src/portable/__tests__/semantic.unit.test.ts); agent_runtimes/tests/test_semantic_events_contract.py holds the cases to what the runtime emits.",
   "kinds": [
     "text",
     "progress",
@@ -23,9 +23,9 @@
     "table": "a Markdown table in the answer (src/portable/semantic.ts answerParts); no AG-UI event carries one",
     "file": "none in agent-runtimes 1.5.45: reserved, rendered as a safe HTTPS link when produced",
     "citation": "an HTTPS Markdown link in the answer (answerParts); no AG-UI event carries one",
-    "ask": "AG-UI RUN_FINISHED with result.asking (agent_runtimes/loop/apps/sessions.py question_of); the run stream carries no loop.ask event",
+    "ask": "AG-UI RUN_FINISHED with result.asking (agent_runtimes/apps/sessions.py question_of); the run stream carries no loop.ask event",
     "completion": "AG-UI RUN_FINISHED without asking",
-    "stop": "the host itself, after its own Stop: a stopped session's stream ends without RUN_FINISHED or RUN_ERROR (agent_runtimes/loop/apps/sessions.py stop, _close); no AG-UI event carries it",
+    "stop": "the host itself, after its own Stop: a stopped session's stream ends without RUN_FINISHED or RUN_ERROR (agent_runtimes/apps/sessions.py stop, _close); no AG-UI event carries it",
     "error": "AG-UI RUN_ERROR message",
     "sign-in": "AG-UI TOOL_CALL_RESULT of pap_sign_in (or pact_sign_in, with or without a gateway prefix) whose result is a sign-in waiting for the person with an https page (src/portable/signIn.ts readPapSignIn), after the tool's complete row; a page that is not https gives the row only"
   },

package/lib/portable/semanticOfAgUi.d.ts

@@ -4,7 +4,7 @@
  * `readRunStream` (`agui.ts`); this says what each event means to a host.
  *
  * The runtime's `loop.turn` event says which turn a stream is and where it
- * stands (`running`, `finished`, `failed`: agent_runtimes/loop/apps/
+ * stands (`running`, `finished`, `failed`: agent_runtimes/apps/
  * external_turns.py); a stopped session's stream ends without a run end,
  * so `stop` is never read from an event: the host that pressed Stop says it.
  * A question is read from `RUN_FINISHED.result.asking` only: the run stream

package/lib/runtimes/variants.d.ts

@@ -37,7 +37,7 @@ export declare const CUSTOM_HARNESS = "custom";
  * when one does.
  *
  * A harness the catalogue offers (`agentspecs/harnesses`, SH-01) — Claude
- * Code, Codex, OpenCode, Gemini CLI — is served by the Datalayer runtime
+ * Code, Codex, OpenCode, pi — is served by the Datalayer runtime
  * through its ACP adapter (`ACPAgent`, SH-10): the runtime launches the
  * harness as its subprocess, so the runtime's locations run it and the
  * browser, which has no process to launch, does not. Three are refused:

package/lib/runtimes/variants.js

@@ -73,7 +73,7 @@ export const CUSTOM_HARNESS = 'custom';
  * when one does.
  *
  * A harness the catalogue offers (`agentspecs/harnesses`, SH-01) — Claude
- * Code, Codex, OpenCode, Gemini CLI — is served by the Datalayer runtime
+ * Code, Codex, OpenCode, pi — is served by the Datalayer runtime
  * through its ACP adapter (`ACPAgent`, SH-10): the runtime launches the
  * harness as its subprocess, so the runtime's locations run it and the
  * browser, which has no process to launch, does not. Three are refused:

package/lib/specs/agents/agents.d.ts

@@ -48,6 +48,7 @@ export declare const EXAMPLE_HARNESS_GEMINI_CLI_AGENTSPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_HARNESS_GOOSE_AGENTSPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_HARNESS_OPENCODE_AGENTSPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_HARNESS_OPENHANDS_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_HARNESS_PI_AGENTSPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_HOOKS_AGENTSPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_HUMAN_APPROVED_AUTOMATION_AGENTSPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_HUMAN_IN_THE_LOOP_AGENTSPEC_0_0_1: Agentspec;

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,
@@ -2918,6 +2920,54 @@ export const EXAMPLE_HARNESS_OPENHANDS_AGENTSPEC_0_0_1 = {
     parameters: undefined,
     subagents: undefined,
 };
+export const EXAMPLE_HARNESS_PI_AGENTSPEC_0_0_1 = {
+    id: 'example-harness-pi',
+    version: '0.0.1',
+    name: 'A pi Agent',
+    description: `pi as a Datalayer agent: launched in the runtime over the Agent Client Protocol, its files, terminals and permissions decided by the Shield under the application's Rules, every action in the record. Needs the account's ANTHROPIC_API_KEY.`,
+    tags: ['coding', 'harness', 'acp'],
+    domain: undefined,
+    enabled: false,
+    model: undefined,
+    mcpServers: [],
+    skills: [].filter(Boolean),
+    backendTools: [],
+    frontendTools: [],
+    environmentName: 'ai-agents-env',
+    icon: undefined,
+    emoji: undefined,
+    color: undefined,
+    suggestions: [],
+    welcomeMessage: undefined,
+    welcomeNotebook: undefined,
+    welcomeDocument: undefined,
+    sandboxVariant: 'jupyter-server',
+    harness: 'pi',
+    systemPrompt: undefined,
+    systemPromptCodemodeAddons: undefined,
+    goal: undefined,
+    delegable: [],
+    protocol: undefined,
+    ui: [],
+    protocols: [],
+    trigger: undefined,
+    modelConfig: undefined,
+    mcpServerTools: undefined,
+    guardrails: undefined,
+    evals: undefined,
+    codemode: undefined,
+    output: undefined,
+    advanced: undefined,
+    checkpoints: undefined,
+    authorizationPolicy: undefined,
+    notifications: undefined,
+    memory: 'ephemeral',
+    preHooks: undefined,
+    postHooks: undefined,
+    toolHooks: undefined,
+    parameters: undefined,
+    subagents: undefined,
+};
 export const EXAMPLE_HOOKS_AGENTSPEC_0_0_1 = {
     id: 'example-hooks',
     version: '0.0.1',
@@ -3949,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,
@@ -3958,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: '📦',
@@ -3977,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,
@@ -13858,6 +13928,7 @@ export const AGENTSPECS = {
     'example-harness-goose': EXAMPLE_HARNESS_GOOSE_AGENTSPEC_0_0_1,
     'example-harness-opencode': EXAMPLE_HARNESS_OPENCODE_AGENTSPEC_0_0_1,
     'example-harness-openhands': EXAMPLE_HARNESS_OPENHANDS_AGENTSPEC_0_0_1,
+    'example-harness-pi': EXAMPLE_HARNESS_PI_AGENTSPEC_0_0_1,
     'example-hooks': EXAMPLE_HOOKS_AGENTSPEC_0_0_1,
     'example-human-approved-automation': EXAMPLE_HUMAN_APPROVED_AUTOMATION_AGENTSPEC_0_0_1,
     'example-human-in-the-loop': EXAMPLE_HUMAN_IN_THE_LOOP_AGENTSPEC_0_0_1,