@datalayer/agent-runtimes 1.3.58 → 1.3.60

package/lib/examples/utils/assistantGallery.js

@@ -0,0 +1,102 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+import { ASSISTANT_WORDS, latestSaying, } from '../../chat/assistant/state';
+/** Every state, in the order an assistant lives them, then stepped aside. */
+export const GALLERY_POSES = [
+    'idle',
+    'greeting',
+    'thinking',
+    'working',
+    'waiting',
+    'speaking',
+    'paused',
+    'aside',
+    'goodbye',
+];
+/** How the gallery names each pose. */
+export const GALLERY_POSE_LABELS = {
+    idle: 'Idle',
+    greeting: 'Greeting',
+    thinking: 'Thinking',
+    working: 'Working',
+    waiting: 'Waiting',
+    speaking: 'Speaking',
+    paused: 'Paused',
+    aside: 'Stepped aside',
+    goodbye: 'Goodbye',
+};
+/** The state the stage acts for a pose: aside, it is idle under what covers it. */
+export function stateOfPose(pose) {
+    return pose === 'aside' ? 'idle' : pose;
+}
+/**
+ * What the agent said, as a conversation would hold it: each entry is read
+ * by `latestSaying`, as the floating assistant reads the chat — Markdown made
+ * plain, a long answer cut with *Open the conversation*.
+ */
+export const SAMPLE_CONVERSATIONS = [
+    [
+        { id: 'u1', role: 'user', content: 'Who wrote about late deliveries?' },
+        {
+            id: 'a1',
+            role: 'assistant',
+            content: 'Three customers wrote about **late deliveries** this week: Ada, Grace and Alan.',
+        },
+    ],
+    [
+        { id: 'u2', role: 'user', content: 'Is the notebook up to date?' },
+        { id: 't2', role: 'assistant', toolName: 'readCell', content: '' },
+        {
+            id: 'a2',
+            role: 'assistant',
+            content: 'Yes — the last cell ran at 9:40 and its [chart](#chart) shows the new week.',
+        },
+    ],
+    [
+        { id: 'u3', role: 'user', content: 'Summarise the quarter.' },
+        {
+            id: 'a3',
+            role: 'assistant',
+            content: 'Revenue grew 12% on the quarter, carried by the renewals in March. Churn held at 2.1%, the same as the last two quarters, and the new plan took 140 accounts in its first six weeks. Support tickets fell by a fifth after the onboarding change, and the slowest region, the north, closed half its gap with the others. The full table, with each region and month, is in the notebook.',
+        },
+    ],
+];
+/** The saying of sample `index` (wrapping), as the balloon shows it. */
+export function sampleSaying(index) {
+    const conversation = SAMPLE_CONVERSATIONS[((index % SAMPLE_CONVERSATIONS.length) + SAMPLE_CONVERSATIONS.length) %
+        SAMPLE_CONVERSATIONS.length];
+    const saying = latestSaying(conversation);
+    if (!saying) {
+        throw new Error(`The sample conversation ${index} says nothing.`);
+    }
+    return { text: saying.text, more: saying.more };
+}
+/** The approval the gallery waits on (T-23): answered in the balloon. */
+export function sampleApproval(onApprove, onDeny) {
+    return {
+        id: 'gallery-approval',
+        asks: 'send_reply',
+        why: 'Send a reply to a customer: ask me first',
+        others: 1,
+        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, }) {
+    if (pose === 'waiting') {
+        return { text: ASSISTANT_WORDS.approval, approval };
+    }
+    if (pose === 'paused') {
+        return { text: ASSISTANT_WORDS.paused };
+    }
+    if (pose === 'goodbye' || pose === 'aside') {
+        return undefined;
+    }
+    return saying;
+}

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

@@ -0,0 +1,9 @@
+import type { AssistantCharacterData } from '../../chat/assistant/formats/types';
+/** The character's `agent.js`, as clippy.js registers one. */
+export declare const TEST_SPRITE_AGENT_JS = "\nclippy.ready('Pixel', {\n  overlayCount: 1,\n  framesize: [48, 48],\n  animations: {\n    Idle1_1: { frames: [{ duration: 1200, images: [[0, 0]] }] },\n    Thinking: { frames: [{ duration: 1200, images: [[48, 0]] }] },\n    Processing: { frames: [\n      { duration: 240, images: [[96, 0]] },\n      { duration: 240, images: [[144, 0]] },\n    ] },\n    GetAttention: { frames: [{ duration: 900, images: [[192, 0]] }] },\n    Sleep: { frames: [{ duration: 1600, images: [[240, 0]] }] },\n    Greeting: { frames: [{ duration: 900, images: [[288, 0]] }] },\n    Explain: { frames: [\n      { duration: 200, images: [[336, 0]] },\n      { duration: 200, images: [[384, 0]] },\n    ] },\n    GoodBye: { frames: [{ duration: 900, images: [[432, 0]] }] },\n  },\n});\n";
+/** Its sprite sheet, `map.png` (480×48), base64. */
+export declare const TEST_SPRITE_MAP_PNG_BASE64 = "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";
+/** The sprite sheet's bytes. */
+export declare function testSpriteMapPng(): Uint8Array;
+/** The test sprite, read as a person's clippy.js files are. */
+export declare function readTestSpriteCharacter(): Promise<AssistantCharacterData>;

package/lib/examples/utils/testSpriteCharacter.js

@@ -0,0 +1,60 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * A small character of our own in the clippy.js shape (LOOP T-26), for the
+ * floating assistant's gallery: an `agent.js` and a `map.png` sprite sheet
+ * of ten 48×48 cells, read through the same reader a person's files go
+ * through (`readClippyCharacter`). It is a test sprite drawn for Datalayer —
+ * no file of Microsoft's is in the repository (§6.9).
+ *
+ * Its animations carry the names the Office characters use, so the reader's
+ * `stateAnimations` gives every state of the assistant one of its own:
+ * `Idle1_1` idles, `Thinking`, `Processing`, `GetAttention`, `Sleep`,
+ * `Greeting`, `Explain` and `GoodBye`.
+ *
+ * @module examples/utils/testSpriteCharacter
+ */
+import { readClippyCharacter } from '../../chat/assistant/formats/clippy';
+/** The character's `agent.js`, as clippy.js registers one. */
+export const TEST_SPRITE_AGENT_JS = `
+clippy.ready('Pixel', {
+  overlayCount: 1,
+  framesize: [48, 48],
+  animations: {
+    Idle1_1: { frames: [{ duration: 1200, images: [[0, 0]] }] },
+    Thinking: { frames: [{ duration: 1200, images: [[48, 0]] }] },
+    Processing: { frames: [
+      { duration: 240, images: [[96, 0]] },
+      { duration: 240, images: [[144, 0]] },
+    ] },
+    GetAttention: { frames: [{ duration: 900, images: [[192, 0]] }] },
+    Sleep: { frames: [{ duration: 1600, images: [[240, 0]] }] },
+    Greeting: { frames: [{ duration: 900, images: [[288, 0]] }] },
+    Explain: { frames: [
+      { duration: 200, images: [[336, 0]] },
+      { duration: 200, images: [[384, 0]] },
+    ] },
+    GoodBye: { frames: [{ duration: 900, images: [[432, 0]] }] },
+  },
+});
+`;
+/** Its sprite sheet, `map.png` (480×48), base64. */
+export const TEST_SPRITE_MAP_PNG_BASE64 = 'iVBORw0KGgoAAAANSUhEUgAAAeAAAAAwCAYAAADJnakOAAAF/klEQVR42u2dMW8rRRDHx5YfHd1LwfUgCwkKGgrQowuiCS3KB6CgokhhJATtFakooKChygeIKEgkiryWhvLEB/Ar/DoKJChCQdbcOzvnW9/u7M7e7ydZiqORPTf3v5n7r+/smQBAFNar5b37u6qbGRUBgDZzSgAAAKDPghJEcz8fisiliDwRkW+ruvmZqgAAAAM4Pt+JyGci8qeI3IkIAxgAABjAGgO4qps/1qvlayLyOuWAqbFeLb8Xkbcf+sz7Vd08oSoADODoVHXz08Of74rIb1QEJngMfPEwiL8WkV+pCAADWJtPReQHyjDJATT5K5/Xq+U7InImIh+gCAAGsDZvisg3lGGSw2fStyGtV8uFiPwoIp9XdfNP6Nd/evrsPtRrvbx9zm1iwAAukC+rurmnDDTQCfKViPxS1c3vueqm+5roCDRBbPFdwG1VN6dUIm4DZRBnqf2/5b/rH5z7/aSqm79C6aY6PwuX69U1OgJbA9i6gyF/3fxLa6A4+DRaD6mbPh3F3if0H/Q/S134HAYB+cfPv6QGioNPN4Bjaqerocf2xdPTZ/dj9hP9B/0fNYCtOxjyT5d/Tg0UB2/LwWhq55CG2jXz3Wb6T5z8j90nOej/qGQtOhjyT5d/Tg0UB2/PweQ6gH22l/4TN3+fi+hy0r/3VdCxD4Lq/GznbCj065N/uvytY7n+Gg4m9NXEKYZvez+0l5uPHb70H738+z4eyFH/s1wPgpAOhvzT5Z+qgVrfBhz88Nq333PItg2N7+6Dse6X/hM3/77hl6v+uQ8YkhOrgULZKyjufTY3d9v/nXz80aPb6Rvf5564WC5f+lxwbvqfD9mYFI3Ovd/Y9XryT5v/oQa6vrqWzc3d9uH+FyI+pHO0XH/tbdDQjqM9TPc9Hxs/djvoP3r5H1p6zlH/QRywdQdD/unY1xCdKwkRT/3LXTVxWjg5eeN/PWxebDXRrq1v/DGNnv6TT/5jbxXTYhGi8BpLQFGEc3H5yoF4MH/PeC3hW6x/uyHuG7J9DXRIPPVP72C6FzGVQMhtMd8/M8z/5e3zWdt55q7/+dg30lgCSunIQsdrOEjL9bcG9Ycp6yfn/DU+AhnL0QO4u6TjHq6o3c/lfOM1l032iWRf/j7xqR1kX/1zyL9LVxOh42PW36L+rVOdn23d02bzYvtwrqrreHzjNdyv9f6Za/6WVlzmUz6Iuwdi6HgY1kB3huuBBjokHqZBVxOHrgfwjQeICbchldKIOheWhI6P2UB9lqF846Hsk7juEO07EfONt+qqYPez4OIGsHMkm5u7nQbe52CGxms5sH3N/FD+OTgw6/nvNMT33vJroAPitepvUf8ir15UuLN9lxej47V1FCs+xvAtqX+i/+P1P3oJ2voSUGn5h47XOpjdI0Y8+oFcoX/Gy7/425A0l4CiOzDr+RtzkCVgXj+eZ+0pXS76oX+WqP9FyB0RK15LSOQP1B/QD/o34YABAHKl/Zkd7h1yZE4JAKDk4bvvOQADGAAg8vBlCEOusAQNJppnGyvLiSyBAvoBHDBA4hMJ3BegH4jugK07GPJPSwln+n1LoDgZP9w3Gq2vroffJ355sXcf+NTefTdxintJLeuHFSwcMGTWQNsNTe3gSdhAIb8TOU58IMcViEVs4Vs/cMkfptx4ctDYMS54TJ6cvE27/2iuQMyHiN+ygyH/9A5SextS5/7YQWplCTTr5hhZQ6Ff37p+WMGKC1dBg/qBFfObcHL5Xd3u55BWnEGuebZ/3cbt45A66uomdeO3qh/wY7DInPg1vkYsxtkP+ac/++z+PJilBmq5/pq5aziYmD8zF2vw0n9s6V/rIr7FMcWx7GDIP13+ToxdJ2OhgU7NwedMV0cWdEP/saV/rRUIL9FZdjDknz7/mE4mRb44eH33axn6D/ofNYBjNM4cGin56zuBkhqphfq3c9ZyMGiJ/oP+Iwxgqw6G/Bm8OHi7Dgz90H9K0z8HCQCN35QDAyhF/xwsiChJ87SePxqi9oD+x+qf+4ABJgpDE9B/WvguaAAAAAAAAJgG/wIobXrKXzNJZgAAAABJRU5ErkJggg==';
+/** The sprite sheet's bytes. */
+export function testSpriteMapPng() {
+    const binary = atob(TEST_SPRITE_MAP_PNG_BASE64);
+    const bytes = new Uint8Array(binary.length);
+    for (let index = 0; index < binary.length; index += 1) {
+        bytes[index] = binary.charCodeAt(index);
+    }
+    return bytes;
+}
+/** The test sprite, read as a person's clippy.js files are. */
+export function readTestSpriteCharacter() {
+    return readClippyCharacter({
+        agentJs: TEST_SPRITE_AGENT_JS,
+        mapPng: new Blob([testSpriteMapPng()], { type: 'image/png' }),
+    });
+}

package/lib/loop/apps/appspec.js

@@ -89,7 +89,7 @@ export function emptyAppspec(kind = 'chat') {
         instructions: '',
         model: '',
         skills: [],
-        tools: [],
+        backendTools: [],
         context: [],
         contents: [],
         connections: [],
@@ -147,7 +147,7 @@ const KNOWN_KEYS = [
     'instructions',
     'model',
     'skills',
-    'tools',
+    'backend_tools',
     'context',
     'contents',
     'connections',
@@ -341,7 +341,7 @@ export function parseAppspec(document) {
         instructions: text(data.instructions),
         model: text(data.model),
         skills: texts(data.skills),
-        tools: texts(data.tools),
+        backendTools: texts(data.backend_tools),
         context: texts(data.context),
         contents: texts(data.contents),
         connections: records(data.connections).map(parseConnection),
@@ -541,7 +541,7 @@ export function dumpAppspec(app) {
         .text('instructions', app.instructions)
         .text('model', app.model)
         .list('skills', app.skills)
-        .list('tools', app.tools)
+        .list('backend_tools', app.backendTools)
         .list('context', app.context)
         .list('contents', app.contents)
         .list('connections', app.connections.map(connection => new Writer()

package/lib/loop/apps/checks.js

@@ -36,7 +36,7 @@ import { getModel } from '../../specs/models';
 import { getNotificationSpec } from '../../specs/notifications';
 import { getSkillSpec } from '../../specs/skills';
 import { getTeamSpec } from '../../specs/teams';
-import { getToolSpec } from '../../specs/tools';
+import { getBackendToolSpec } from '../../specs/backendTools';
 import { getTrack } from '../../specs/tracks';
 import { pluginsOffSetupNotes } from '../plugins/canvas-blocks';
 import { isAssistantCharacterId, parseAppspec } from './appspec';
@@ -173,8 +173,8 @@ function referenceProblems(app, organizationFrames) {
         if (!getSkillSpec(idOf(ref)))
             missing('skill', ref);
     }
-    for (const ref of app.tools) {
-        if (!getToolSpec(idOf(ref)))
+    for (const ref of app.backendTools) {
+        if (!getBackendToolSpec(idOf(ref)))
             missing('tool', ref);
     }
     for (const ref of app.checks.guards) {
@@ -241,7 +241,7 @@ function referenceProblems(app, organizationFrames) {
                 continue;
             const [server, name] = splitRef(target);
             if (server === undefined) {
-                if (!getToolSpec(name)) {
+                if (!getBackendToolSpec(name)) {
                     problems.push(`The rule “${rule.action}” names the tool “${target}”, which the catalogue does not have.`);
                 }
                 continue;
@@ -339,8 +339,8 @@ function setupNotes(app) {
     }
     for (const ref of app.skills)
         note('skill', ref, getSkillSpec(idOf(ref)));
-    for (const ref of app.tools)
-        note('tool', ref, getToolSpec(idOf(ref)));
+    for (const ref of app.backendTools)
+        note('tool', ref, getBackendToolSpec(idOf(ref)));
     for (const ref of app.checks.guards)
         note('Guard', ref, own(GUARD_CATALOGUE, idOf(ref)));
     for (const ref of app.checks.gates)

package/lib/loop/apps/rules.js

@@ -34,7 +34,7 @@
  *
  * @module loop/apps/rules
  */
-import { SERVER_ACTIONS, TOOL_ACTIONS } from '../../specs/actions';
+import { SERVER_ACTIONS, BACKEND_TOOL_ACTIONS } from '../../specs/actions';
 /** The four behaviours, from the freest to the most restricted. */
 export const BEHAVIOURS = [
     'do_it',
@@ -138,7 +138,7 @@ function entryOf(server, name) {
 export function classesOf(ref, args) {
     const [server, name] = splitRef(ref);
     if (server === undefined) {
-        return [...(own(TOOL_ACTIONS, name) ?? [])];
+        return [...(own(BACKEND_TOOL_ACTIONS, name) ?? [])];
     }
     const [classes, conditions] = entryOf(server, name);
     for (const condition of conditions) {

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

@@ -9,7 +9,9 @@
  * while the conversation is out of sight, holds there the approval it waits
  * on, answered with *Approve* or *Deny* on the path every approval of it is
  * answered on (T-23, U-19), opens the conversation when clicked, and is
- * dragged about and sent away as the chat's own assistant is (T-27).
+ * dragged about and sent away as the chat's own assistant is (T-27). Given
+ * the runtime to ask (`decisions`), its balloon offers *Ask a decision*: a
+ * typed decision asked of Jev through the runtime, answered there.
  *
  * The workspace's chat is the conversation: on a page layout, its side panel
  * is opened and closed; where the conversation is always on screen, a click
@@ -33,6 +35,16 @@ export type LoopAssistantConfig = {
      * the balloon says an approval waits and the conversation answers it.
      */
     appId?: string;
+    /**
+     * The runtime decisions are asked at — its
+     * `/api/v1/configure/inference/decisions`, as the `decide` tool asks — and
+     * the token to ask with, if it needs one: the balloon offers *Ask a
+     * decision*. Without it, it does not.
+     */
+    decisions?: {
+        serverUrl: string;
+        token?: string;
+    };
 };
 /**
  * What the character acts out (T-22), from what the application is doing as
@@ -43,6 +55,6 @@ export declare function assistantStateOfTurn(turn: ChatTurnSnapshot, presence: P
     arriving?: boolean;
     leaving?: boolean;
 }): AssistantState;
-export declare function LoopAssistant({ app, person, appId, }: LoopAssistantConfig): JSX.Element | null;
+export declare function LoopAssistant({ app, person, appId, decisions, }: 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

@@ -7,6 +7,7 @@ import { Box } from '@datalayer/primer-addons';
 import { useIAMStore } from '@datalayer/core/lib/state/substates/IAMState';
 import { pageLayoutPanelOpen, togglePagePanel, } from '@datalayer/primer-addons/lib/reactor';
 import { AssistantStage } from '../../../chat/assistant/AssistantStage';
+import { decisionsAskerAt } from '../../../chat/assistant/decisions';
 import { ASSISTANT_WORDS, assistantStateOf, keepAway, keptAway, latestSaying, } from '../../../chat/assistant/state';
 import { useApproveToolRequest, useRejectToolRequest, useToolApprovalsQuery, } from '../../../hooks/useToolApprovals';
 import { approvalsOfApp, ruleOfApproval } from '../app-rules/AppRulesCard';
@@ -67,7 +68,7 @@ function focusComposer() {
     const composer = document.querySelector('[data-chat-composer] textarea, [data-chat-composer] [contenteditable="true"]');
     composer?.focus();
 }
-export function LoopAssistant({ app, person, appId, }) {
+export function LoopAssistant({ app, person, appId, decisions, }) {
     const contributed = useContributions(LoopAssistantCharacter).map(entry => entry.value);
     const chosen = assistantCharacterFor(contributed, { app, person });
     const turnEntries = useContributions(LoopChatTurn);
@@ -110,6 +111,9 @@ export function LoopAssistant({ app, person, appId, }) {
     }, [open, saying?.id]);
     const stageRef = useRef(null);
     const drag = useViewportDrag(stageRef, { whole: true });
+    const decide = useMemo(() => decisions?.serverUrl
+        ? decisionsAskerAt(decisions.serverUrl, decisions.token)
+        : undefined, [decisions?.serverUrl, decisions?.token]);
     if (away !== 'none') {
         return null;
     }
@@ -162,16 +166,21 @@ export function LoopAssistant({ app, person, appId, }) {
     };
     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, insist: insist, onDismiss: onDismiss })] }));
+                    : { right: '24px', bottom: '24px' }, stageRef: stageRef, onDragStart: drag.onHandlePointerDown, open: open, onToggle: onToggle, balloon: balloon, insist: insist, onDismiss: onDismiss, decide: decide })] }));
 }
 export const LoopAssistantPlugin = definePlugin({
     name: LOOP_ASSISTANT_PLUGIN_NAME,
-    config: { app: undefined, person: undefined, appId: undefined },
+    config: {
+        app: undefined,
+        person: undefined,
+        appId: undefined,
+        decisions: undefined,
+    },
     displayName: 'Floating assistant',
     description: 'The chat as a character on the page: the application’s own, or the one the person chose, from the characters the enabled plugins contribute.',
     octicon: 'paperclip',
     build: ({ config }) => {
-        const Configured = () => (_jsx(LoopAssistant, { app: config.app, person: config.person, appId: config.appId }));
+        const Configured = () => (_jsx(LoopAssistant, { app: config.app, person: config.person, appId: config.appId, decisions: config.decisions }));
         return {
             components: [
                 { id: 'loop-assistant', slot: LoopSlots.root, Component: Configured },

package/lib/specs/actions.d.ts

@@ -11,7 +11,7 @@ import type { ActionClass, AppBehaviour, AppEscalation, ServerActionsSpec } from
 /** The classes of action, from the one that changes nothing. */
 export declare const ACTION_CLASSES: ActionClass[];
 /** What each tool of the tools catalogue does, by id. */
-export declare const TOOL_ACTIONS: Record<string, ActionClass[]>;
+export declare const BACKEND_TOOL_ACTIONS: Record<string, ActionClass[]>;
 /**
  * What each MCP server's tools do, by server id. `checked` is the day the
  * names were read off the running server; absent when nobody looked.

package/lib/specs/actions.js

@@ -12,7 +12,7 @@ export const ACTION_CLASSES = [
     'publish',
 ];
 /** What each tool of the tools catalogue does, by id. */
-export const TOOL_ACTIONS = {
+export const BACKEND_TOOL_ACTIONS = {
     'create-plan': ['read'],
     'current-time': ['read'],
     decide: ['read'],