@datalayer/agent-runtimes 1.3.73 → 1.3.74

package/lib/examples/main.js

@@ -27,6 +27,7 @@ import { useSimpleAuthStore } from '@datalayer/core/lib/views/otel';
 import { teardownExampleAgents } from './utils/teardownAgents';
 import { OAuthCallback } from '../identity';
 import { EXAMPLES, getExampleEntries, } from './example-selector';
+import { EXAMPLE_GROUP_ORDER, getExampleGroup } from './exampleGroups';
 import { RUNTIME_TARGETS, runtimeTargetCapabilities, runtimeTargetStore, targetHasAgent, useRuntimeTargetStore, } from './utils/runtimeTargetStore';
 import { resolveExampleAgentRuntimesUrl } from './utils/useExampleAgentRuntimesUrl';
 import { isLocalUrl } from './utils/localUrl';
@@ -46,18 +47,6 @@ const DEFAULT_RUNTIMES_URL = 'https://r1.datalayer.run';
 const DEFAULT_LOCAL_JUPYTER_SERVER_URL = 'http://localhost:8888/api/jupyter-server';
 const DEFAULT_LOCAL_JUPYTER_SERVER_TOKEN = '60c1661cc408f978c309d04157af55c9588ff9557c9380e4fb50785750703da6';
 const DEFAULT_CLOUD_RUNTIME_ENVIRONMENT = 'ai-agents-env';
-const EXAMPLE_GROUP_ORDER = [
-    'Apps',
-    'A2UI',
-    'A2A',
-    'AG-UI',
-    'Chat',
-    'Document',
-    'Notebook',
-    'Capabilities',
-    'Cell',
-    'CopilotKit',
-];
 /**
  * The examples that open without an account.
  *
@@ -88,42 +77,13 @@ const ANONYMOUS_EXAMPLES = new Set([
     'DecksAgent',
     // The floating assistant: the character, its balloon and its motions need
     // no runtime; a conversation does, and says so when there is none.
-    'ChatAssistantExample',
+    'AssistantExample',
     // Every character in every state, from static data: no agent at all.
-    'ChatAssistantGalleryExample',
+    'AssistantGalleryExample',
     // Voice: heard in the page, the agent on the local server, the speech
     // service named in the address.
     'VoiceChatExample',
 ]);
-const getExampleGroup = (id) => {
-    if (id === 'AgentspecsExample' ||
-        id.startsWith('Loop') ||
-        id === 'DecksAgent') {
-        return 'Apps';
-    }
-    if (id.startsWith('A2Ui'))
-        return 'A2UI';
-    // Agents reached over the A2A protocol: their own category, after A2UI.
-    if (id.startsWith('AgentA2A'))
-        return 'A2A';
-    if (id.startsWith('AgUi'))
-        return 'AG-UI';
-    if (id.startsWith('CopilotKit'))
-        return 'CopilotKit';
-    // Each remaining Agent* example demonstrates one capability of the
-    // runtime: checkpoints, hooks, memory, guardrails…
-    if (id.startsWith('Agent'))
-        return 'Capabilities';
-    if (id.startsWith('Chat') || id === 'VoiceChatExample')
-        return 'Chat';
-    // The document examples: the ones on the Lexical editor, and the page
-    // with a document on it.
-    if (id.startsWith('Lexical') || id.startsWith('Document'))
-        return 'Document';
-    if (id.startsWith('Notebook'))
-        return 'Notebook';
-    return 'Cell';
-};
 const wait = (ms) => new Promise(resolve => {
     window.setTimeout(resolve, ms);
 });

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

@@ -46,7 +46,12 @@ export declare function GalleryNotebook({ onOpen, }: {
     onOpen?: () => void;
 }): JSX.Element;
 /**
- * The balloon's displays (T-23), one character: a peek of the history, the
+ * The sample notebook as the balloon's large visual: expanded, the notebook
+ * that runs and is edited on the browser sandbox (`TeamNotebook`).
+ */
+export declare function galleryNotebookVisual(): import("../../chat/assistant/BalloonVisual").BalloonVisual;
+/**
+ * The balloon's displays (T-23), one character: the history, every message listed, the
  * current balloon with a tool line, and with a notebook given — the same
  * read-only jupyter-react notebook as in the stage, loaded when drawn.
  */

package/lib/examples/utils/AssistantGalleryGrid.js

@@ -7,8 +7,9 @@ import { AssistantStage } from '../../chat/assistant/AssistantStage';
 import { AssistantCharactersPlugin, assistantCharactersOf, } from '../../loop/plugins/assistant-characters';
 import { OWL_CHARACTER, OwlCharacterPlugin } from './owlCharacterPlugin';
 import { NotebookPreview } from '../../components/teams/NotebookPreview';
+import { notebookBalloonVisual } from '../../components/teams/TeamNotebook';
 import { readTestSpriteCharacter } from './testSpriteCharacter';
-import { GALLERY_POSES, GALLERY_POSE_LABELS, SAMPLE_NOTEBOOK, SAMPLE_NOTEBOOK_SAYING, sampleSaying, sampleToolLine, stateOfPose, } from './assistantGallery';
+import { GALLERY_POSES, GALLERY_POSE_LABELS, SAMPLE_NOTEBOOK, SAMPLE_NOTEBOOK_ARTIFACT, SAMPLE_NOTEBOOK_SAYING, sampleHistory, sampleSaying, sampleToolLine, stateOfPose, } from './assistantGallery';
 /** The plugins the gallery enables: Datalayer's characters and the owl's. */
 const reactor = buildReactorFromPlugins([
     AssistantCharactersPlugin,
@@ -127,6 +128,13 @@ export const GALLERY_NOTEBOOK_HEIGHT = 160;
 export function GalleryNotebook({ onOpen, }) {
     return (_jsx(NotebookPreview, { notebook: SAMPLE_NOTEBOOK, title: "Accounting\u2019s notebook", maxHeight: GALLERY_NOTEBOOK_HEIGHT, onOpen: onOpen }));
 }
+/**
+ * The sample notebook as the balloon's large visual: expanded, the notebook
+ * that runs and is edited on the browser sandbox (`TeamNotebook`).
+ */
+export function galleryNotebookVisual() {
+    return notebookBalloonVisual(SAMPLE_NOTEBOOK_ARTIFACT, 'Accounting’s notebook', 420);
+}
 /** One balloon display, pictured: a character with what its balloon says. */
 function BalloonCell({ character, label, display, balloon, height, }) {
     const stageRef = useRef(null);
@@ -147,18 +155,23 @@ function BalloonCell({ character, label, display, balloon, height, }) {
                 }, children: label }), _jsx(AssistantStage, { character: character.character, state: balloon.tool ? 'working' : 'speaking', size: 48, place: { position: 'absolute', left: '12px', bottom: '8px' }, stageRef: stageRef, onDragStart: () => undefined, open: false, onToggle: () => undefined, onDismiss: () => undefined, balloon: balloon, balloonDisplay: display, insist: true })] }));
 }
 /**
- * The balloon's displays (T-23), one character: a peek of the history, the
+ * The balloon's displays (T-23), one character: the history, every message listed, the
  * current balloon with a tool line, and with a notebook given — the same
  * read-only jupyter-react notebook as in the stage, loaded when drawn.
  */
 export function GalleryBalloons({ character, }) {
-    return (_jsxs(Box, { "data-gallery-balloons": "", sx: { display: 'flex', gap: 3, flexWrap: 'wrap', mt: 3 }, children: [_jsx(BalloonCell, { character: character, label: "History", display: "history", height: 180, balloon: { ...sampleSaying(0), onDismiss: () => undefined } }), _jsx(BalloonCell, { character: character, label: "Current \u00B7 tool", display: "current", height: 180, balloon: {
+    return (_jsxs(Box, { "data-gallery-balloons": "", sx: { display: 'flex', gap: 3, flexWrap: 'wrap', mt: 3 }, children: [_jsx(BalloonCell, { character: character, label: "History", display: "history", height: 340, balloon: {
+                    ...sampleSaying(1),
+                    history: sampleHistory(2),
+                    onDismiss: () => undefined,
+                } }), _jsx(BalloonCell, { character: character, label: "Current \u00B7 tool", display: "current", height: 180, balloon: {
                     text: 'Using list_invoices…',
                     tool: sampleToolLine('running'),
                     busy: true,
                 } }), _jsx(BalloonCell, { character: character, label: "Current \u00B7 notebook", display: "current", height: GALLERY_NOTEBOOK_HEIGHT + 210, balloon: {
                     text: SAMPLE_NOTEBOOK_SAYING,
                     attachment: _jsx(GalleryNotebook, {}),
+                    visual: galleryNotebookVisual(),
                 } })] }));
 }
 export default AssistantGalleryGrid;

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/package.json

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