@datalayer/agent-runtimes 1.3.73 → 1.3.75

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

@@ -8,7 +8,7 @@
  */
 import type { AssistantStageProps } from '../../chat/assistant/AssistantStage';
 import { type BalloonToolLine, type ToolLinePhase } from '../../chat/assistant/toolLine';
-import { type AssistantState, type BalloonApproval } from '../../chat/assistant/state';
+import { type AssistantState, type BalloonApproval, type BalloonHistoryMessage } from '../../chat/assistant/state';
 /** What the gallery poses a character in: a state, or stepped aside. */
 export type GalleryPose = AssistantState | 'aside';
 /** Every state, in the order an assistant lives them, then stepped aside. */
@@ -28,6 +28,12 @@ export declare function sampleSaying(index: number): {
     text: string;
     more: boolean;
 };
+/**
+ * The conversation so far, after `count` sample exchanges (wrapping), as the
+ * `history` balloon lists it: every message, the person's and the agent's,
+ * read by `balloonHistoryOf` as the floating assistant reads the chat.
+ */
+export declare function sampleHistory(count: number): BalloonHistoryMessage[];
 /** The tool the gallery calls (T-23): Odoo's, as Accounting calls it. */
 export declare const SAMPLE_TOOL = "list_invoices";
 /** The sample tool's line, at a phase: "Using list_invoices…", "Done: …", "… failed". */
@@ -69,6 +75,45 @@ export declare const SAMPLE_NOTEBOOK: {
         }[];
     })[];
 };
+/** The sample notebook as a peer gives one: an A2A artifact. */
+export declare const SAMPLE_NOTEBOOK_ARTIFACT: {
+    mediaType: string;
+    name: string;
+    filename: string;
+    data: {
+        nbformat: number;
+        nbformat_minor: number;
+        metadata: {
+            kernelspec: {
+                name: string;
+                display_name: string;
+                language: string;
+            };
+            language_info: {
+                name: string;
+            };
+        };
+        cells: ({
+            id: string;
+            cell_type: string;
+            metadata: {};
+            source: string;
+            execution_count?: undefined;
+            outputs?: undefined;
+        } | {
+            id: string;
+            cell_type: string;
+            metadata: {};
+            execution_count: number;
+            source: string;
+            outputs: {
+                output_type: string;
+                name: string;
+                text: string;
+            }[];
+        })[];
+    };
+};
 /** What the gallery says with the notebook it was given. */
 export declare const SAMPLE_NOTEBOOK_SAYING = "Here is the notebook Accounting gave: the open invoices.";
 /** The approval the gallery waits on (T-23): answered in the balloon. */
@@ -77,7 +122,7 @@ export declare function sampleApproval(onApprove: () => void, onDeny: () => void
  * The balloon for a pose: waiting holds the approval, paused says so, and
  * any other pose says the sample's words when asked to (`saying`).
  */
-export declare function balloonForPose(pose: GalleryPose, { saying, approval, tool, attachment, }: {
+export declare function balloonForPose(pose: GalleryPose, { saying, approval, tool, attachment, history, visual, }: {
     saying?: {
         text: string;
         more: boolean;
@@ -87,4 +132,8 @@ export declare function balloonForPose(pose: GalleryPose, { saying, approval, to
     tool?: BalloonToolLine;
     /** What goes with the words in a `current` balloon: a notebook. */
     attachment?: NonNullable<AssistantStageProps['balloon']>['attachment'];
+    /** The conversation so far, listed in a `history` balloon. */
+    history?: readonly BalloonHistoryMessage[];
+    /** The large visual the attachment is the compact form of: expandable. */
+    visual?: NonNullable<AssistantStageProps['balloon']>['visual'];
 }): AssistantStageProps['balloon'];

package/lib/examples/utils/assistantGallery.js

@@ -3,7 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 import { toolLineText, } from '../../chat/assistant/toolLine';
-import { ASSISTANT_WORDS, latestSaying, } from '../../chat/assistant/state';
+import { ASSISTANT_WORDS, balloonHistoryOf, latestSaying, } from '../../chat/assistant/state';
 /** Every state, in the order an assistant lives them, then stepped aside. */
 export const GALLERY_POSES = [
     'idle',
@@ -74,6 +74,22 @@ export function sampleSaying(index) {
     }
     return { text: saying.text, more: saying.more };
 }
+/**
+ * The conversation so far, after `count` sample exchanges (wrapping), as the
+ * `history` balloon lists it: every message, the person's and the agent's,
+ * read by `balloonHistoryOf` as the floating assistant reads the chat.
+ */
+export function sampleHistory(count) {
+    const items = [];
+    for (let turn = 0; turn < count; turn += 1) {
+        const conversation = SAMPLE_CONVERSATIONS[turn % SAMPLE_CONVERSATIONS.length];
+        for (const item of conversation) {
+            const message = item;
+            items.push({ ...message, id: `${turn}-${message.id}` });
+        }
+    }
+    return balloonHistoryOf(items);
+}
 /** The tool the gallery calls (T-23): Odoo's, as Accounting calls it. */
 export const SAMPLE_TOOL = 'list_invoices';
 /** The sample tool's line, at a phase: "Using list_invoices…", "Done: …", "… failed". */
@@ -112,6 +128,13 @@ export const SAMPLE_NOTEBOOK = {
         },
     ],
 };
+/** The sample notebook as a peer gives one: an A2A artifact. */
+export const SAMPLE_NOTEBOOK_ARTIFACT = {
+    mediaType: 'application/x-ipynb+json',
+    name: 'Open invoices',
+    filename: 'open-invoices.ipynb',
+    data: SAMPLE_NOTEBOOK,
+};
 /** What the gallery says with the notebook it was given. */
 export const SAMPLE_NOTEBOOK_SAYING = 'Here is the notebook Accounting gave: the open invoices.';
 /** The approval the gallery waits on (T-23): answered in the balloon. */
@@ -129,9 +152,12 @@ export function sampleApproval(onApprove, onDeny) {
  * The balloon for a pose: waiting holds the approval, paused says so, and
  * any other pose says the sample's words when asked to (`saying`).
  */
-export function balloonForPose(pose, { saying, approval, tool, attachment, }) {
+export function balloonForPose(pose, { saying, approval, tool, attachment, history, visual, }) {
+    const listed = history && history.length > 0 ? { history } : {};
+    // What goes with the words stays while a tool runs, in either display.
+    const given = attachment ? { attachment, ...(visual ? { visual } : {}) } : {};
     if (pose === 'waiting') {
-        return { text: ASSISTANT_WORDS.approval, approval };
+        return { text: ASSISTANT_WORDS.approval, approval, ...listed };
     }
     if (pose === 'paused') {
         return { text: ASSISTANT_WORDS.paused };
@@ -144,10 +170,9 @@ export function balloonForPose(pose, { saying, approval, tool, attachment, }) {
             text: toolLineText(tool),
             tool,
             busy: tool.phase === 'running',
+            ...listed,
+            ...given,
         };
     }
-    if (saying && attachment) {
-        return { ...saying, attachment };
-    }
-    return saying;
+    return saying ? { ...saying, ...listed, ...given } : undefined;
 }

package/lib/loop/apps/AppRenderer.js

@@ -209,7 +209,7 @@ export function appDatalayerCreatePayload(app, instance) {
         transport: 'ag-ui',
         agent_spec_id: agentIdOf(app),
         app_spec: dumpAppspec(app),
-        // Code Mode calls every tool through `execute_code`, which an
+        // Codemode calls every tool through `execute_code`, which an
         // application without a shell is refused: its tools are called
         // one by one instead, each decided by its rules.
         enable_codemode: Boolean(app.permissions?.computer?.shell),

package/lib/loop/core/index.d.ts

@@ -531,6 +531,23 @@ export type AssistantCharacterContribution = {
     character: AssistantCharacter | AssistantCharacterData;
 };
 export declare const LoopAssistantCharacter: import("@datalayer/reactor").ContributionPoint<AssistantCharacterContribution>;
+/**
+ * An entry of the floating assistant's own menu (right-click, Shift+F10, a
+ * long press): a plugin's, beside what the assistant offers itself. Its
+ * `group` is the heading it is listed under; `checked` makes it one of a
+ * choice.
+ */
+export type AssistantMenuContribution = {
+    /** Stable id, for the registry and the graph. */
+    id: string;
+    label: string;
+    description?: string;
+    onSelect: () => void;
+    checked?: boolean;
+    disabled?: boolean;
+    group?: string;
+};
+export declare const LoopAssistantMenu: import("@datalayer/reactor").ContributionPoint<AssistantMenuContribution>;
 export { LoopCanvasBlock, type CanvasBlockContribution } from './canvasBlocks';
 /**
  * The per-example chat extras a host feeds the loop's conversation live.

package/lib/loop/core/index.js

@@ -142,6 +142,7 @@ export const LoopChatHeader = defineContributionPoint('loop.chat.header');
 export const LoopAgentBlueprint = defineContributionPoint('loop.agent.blueprint');
 export const LoopChatSuggestion = defineContributionPoint('loop.chat.suggestion');
 export const LoopAssistantCharacter = defineContributionPoint('loop.assistant.character');
+export const LoopAssistantMenu = defineContributionPoint('loop.assistant.menu');
 // A block the Canvas may place (LOOP C-12), in a module of its own so that
 // the palette is read without the rest of the contracts.
 export { LoopCanvasBlock } from './canvasBlocks';

package/lib/loop/plugins/assistant/index.d.ts

@@ -68,6 +68,6 @@ export declare function assistantStateOfTurn(turn: ChatTurnSnapshot, presence: P
     arriving?: boolean;
     leaving?: boolean;
 }): AssistantState;
-export declare function LoopAssistant({ app, person, appId, decisions, balloon: display, }: LoopAssistantConfig): JSX.Element | null;
+export declare function LoopAssistant({ app, person, appId, decisions, balloon: displayGiven, }: LoopAssistantConfig): JSX.Element | null;
 export declare const LoopAssistantPlugin: import("@datalayer/reactor").ReactorPlugin<LoopAssistantConfig, unknown, unknown>;
 export default LoopAssistantPlugin;

package/lib/loop/plugins/assistant/index.js

@@ -13,7 +13,7 @@ import { ASSISTANT_WORDS, assistantStateOf, keepAway, keptAway, latestSaying, }
 import { useApproveToolRequest, useRejectToolRequest, useToolApprovalsQuery, } from '../../../hooks/useToolApprovals';
 import { approvalsOfApp, ruleOfApproval } from '../app-rules/AppRulesCard';
 import { useViewportDrag } from '../../../chat/useViewportDrag';
-import { LoopAssistantCharacter, LoopChatLayout, LoopChatTurn, LoopSlots, } from '../../core';
+import { LoopAssistantCharacter, LoopAssistantMenu, LoopChatLayout, LoopChatTurn, LoopSlots, } from '../../core';
 import { assistantCharacterFor } from '../assistant-characters';
 export const LOOP_ASSISTANT_PLUGIN_NAME = '@datalayer/loop-plugin-assistant';
 /** The character's size, in pixels, as the chat's own assistant. */
@@ -69,9 +69,14 @@ function focusComposer() {
     const composer = document.querySelector('[data-chat-composer] textarea, [data-chat-composer] [contenteditable="true"]');
     composer?.focus();
 }
-export function LoopAssistant({ app, person, appId, decisions, balloon: display = 'history', }) {
+export function LoopAssistant({ app, person, appId, decisions, balloon: displayGiven = 'history', }) {
+    // The balloon's display, as its menu chose it; the Appspec's until then.
+    const [chosenDisplay, setChosenDisplay] = useState();
+    const display = chosenDisplay ?? displayGiven;
     const contributed = useContributions(LoopAssistantCharacter).map(entry => entry.value);
     const chosen = assistantCharacterFor(contributed, { app, person });
+    // What the enabled plugins add to its menu.
+    const menuContributions = useContributions(LoopAssistantMenu).map(entry => entry.value);
     const turnEntries = useContributions(LoopChatTurn);
     const turn = useSignalValue(turnEntries[0]?.value.turn ?? NO_TURN);
     const presence = useSignalValue(turnEntries[0]?.value.presence ?? NO_PRESENCE);
@@ -199,7 +204,7 @@ export function LoopAssistant({ app, person, appId, decisions, balloon: display
     };
     return (_jsxs(_Fragment, { children: [appId && signedIn ? (_jsx(WaitingApprovals, { appId: appId, onWaiting: setApproval })) : null, _jsx(AssistantStage, { character: chosen.character, state: state, size: SIZE, place: drag.position
                     ? { left: `${drag.position.left}px`, top: `${drag.position.top}px` }
-                    : { right: '24px', bottom: '24px' }, stageRef: stageRef, onDragStart: drag.onHandlePointerDown, open: open, onToggle: onToggle, balloon: balloon, balloonDisplay: display, insist: insist, onDismiss: onDismiss, decide: decide })] }));
+                    : { right: '24px', bottom: '24px' }, stageRef: stageRef, onDragStart: drag.onHandlePointerDown, open: open, onToggle: onToggle, balloon: balloon, balloonDisplay: display, insist: insist, onDismiss: onDismiss, decide: decide, onResetPosition: drag.position ? drag.reset : undefined, onBalloonDisplayChange: setChosenDisplay, about: appId ? { name: appId, spec: appId } : undefined, contextMenu: menuContributions })] }));
 }
 export const LoopAssistantPlugin = definePlugin({
     name: LOOP_ASSISTANT_PLUGIN_NAME,

package/lib/runtimes/browser/a2aPeer.d.ts

@@ -43,7 +43,10 @@ export type ConnectA2APeerOptions = {
     url: string;
     /** A key granted to the peer's route, sent as a bearer token. */
     key?: string;
-    /** The fetch to use, for tests and hosts that wrap the network. */
+    /**
+     * The fetch to use, for tests and hosts that wrap the network — such as
+     * the Agent Inspector's `inspectA2AFetch`, which records the traffic.
+     */
     fetch?: typeof globalThis.fetch;
 };
 /**

package/lib/types/chat.d.ts

@@ -8,6 +8,7 @@ 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 { AgentInspectorSink } from '../components/inspector/agentInspector';
 import type { McpServerSelection } from './inference';
 import type { MCPServerTool } from './mcp';
 import type { AgentRuntimeConfig } from './config';
@@ -1238,6 +1239,12 @@ export interface ChatBaseProps {
      * ```
      */
     onToolCallComplete?: (context: ToolCallCompleteContext) => void;
+    /**
+     * The Agent Inspector's sink: the agent's turns (its model, its tokens)
+     * and its tool calls, from start to end, are recorded there. Without it,
+     * the sink of the nearest `AgentInspectorProvider`, if any.
+     */
+    inspector?: AgentInspectorSink | null;
     /**
      * Whether to render the top-of-chat tool approval banner (and its review
      * dialog) when `pendingApprovals` is non-empty. The banner/dialog render

package/package.json

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

package/scripts/codegen/generate_jupyter_theme_variables.mjs

@@ -0,0 +1,57 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+
+/**
+ * Writes src/components/teams/jupyterThemeVariables.ts: JupyterLab's light
+ * and dark theme variables (`--jp-*`), read from the theme extensions'
+ * variables.css, so a notebook preview can carry its own mode on its own
+ * subtree — JupyterLab writes them for the whole page.
+ *
+ *   node scripts/codegen/generate_jupyter_theme_variables.mjs
+ */
+import { readFileSync, writeFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+
+function variables(pkg) {
+  const css = readFileSync(require.resolve(`${pkg}/style/variables.css`), 'utf8')
+    .replace(/\/\*[\s\S]*?\*\//g, '');
+  const out = {};
+  for (const block of css.matchAll(/:root\s*\{([\s\S]*?)\}/g)) {
+    for (const declaration of block[1].split(';')) {
+      const match = /^\s*(--jp-[\w-]+)\s*:\s*([\s\S]+?)\s*$/.exec(declaration);
+      if (match) {
+        out[match[1]] = match[2].replace(/\s+/g, ' ');
+      }
+    }
+  }
+  return out;
+}
+
+const light = variables('@jupyterlab/theme-light-extension');
+const dark = variables('@jupyterlab/theme-dark-extension');
+const target = new URL('../../src/components/teams/jupyterThemeVariables.ts', import.meta.url);
+writeFileSync(
+  target,
+  `/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+
+/**
+ * JupyterLab's theme variables, light and dark, as its theme extensions state
+ * them. Generated by scripts/codegen/generate_jupyter_theme_variables.mjs: do
+ * not edit.
+ *
+ * @module components/teams/jupyterThemeVariables
+ */
+
+export const JUPYTER_LIGHT_VARIABLES: Readonly<Record<string, string>> = ${JSON.stringify(light, null, 2)};
+
+export const JUPYTER_DARK_VARIABLES: Readonly<Record<string, string>> = ${JSON.stringify(dark, null, 2)};
+`,
+);
+console.log(`light ${Object.keys(light).length}, dark ${Object.keys(dark).length}`);