@datalayer/agent-runtimes 1.3.57 → 1.3.58

package/lib/chat/marks/SpecMark.d.ts

@@ -15,6 +15,8 @@ import { type IconPackage, type IconRef } from './iconRef';
 export type MarkIcon = React.ComponentType<{
     size?: number;
     'aria-hidden'?: boolean | 'true' | 'false';
+    /** The Datalayer icons' own colours: a brand drawn as itself. */
+    colored?: boolean;
 }>;
 type IconModule = Record<string, unknown>;
 /** Import a package of icons, once. */

package/lib/chat/marks/SpecMark.js

@@ -71,7 +71,9 @@ export function useMarkIcon(icon) {
 export function SpecMark({ icon, emoji, size = 16 }) {
     const Icon = useMarkIcon(icon);
     if (icon) {
-        return Icon ? (_jsx("span", { "data-mark": icon, style: { display: 'inline-flex', flexShrink: 0, lineHeight: 0 }, children: _jsx(Icon, { size: size, "aria-hidden": "true" }) })) : (_jsx("span", { "data-mark": icon, "aria-hidden": "true", style: { display: 'inline-block', width: size, height: size } }));
+        return Icon ? (_jsx("span", { "data-mark": icon, style: { display: 'inline-flex', flexShrink: 0, lineHeight: 0 }, children: _jsx(Icon, { size: size, "aria-hidden": "true", ...(icon.startsWith('@datalayer/icons-react:')
+                    ? { colored: true }
+                    : {}) }) })) : (_jsx("span", { "data-mark": icon, "aria-hidden": "true", style: { display: 'inline-block', width: size, height: size } }));
     }
     if (emoji) {
         return (_jsx("span", { "data-mark": "emoji", "aria-hidden": "true", style: {

package/lib/specs/actions.js

@@ -644,6 +644,7 @@ export const SERVER_ACTIONS = {
 export const APP_BEHAVIOURS = {
     'customer-interview': {},
     'data-quality': {},
+    decide: {},
     'inbox-triage': {
         'google-workspace.append_table_rows': 'leave_to_me',
         'google-workspace.batch_modify_gmail_message_labels': 'do_it',
@@ -788,6 +789,7 @@ export const APP_BEHAVIOURS = {
 export const APP_ESCALATIONS = {
     'customer-interview': {},
     'data-quality': {},
+    decide: {},
     'inbox-triage': {
         'google-workspace.batch_modify_gmail_message_labels': [
             {

package/lib/specs/apps.d.ts

@@ -10,6 +10,7 @@
 import type { AppBuilt, AppKind, AppSpec } from '../types/agentspecs';
 export declare const CUSTOMER_INTERVIEW_APP_0_0_1: AppSpec;
 export declare const DATA_QUALITY_APP_0_0_1: AppSpec;
+export declare const DECIDE_APP_0_0_1: AppSpec;
 export declare const INBOX_TRIAGE_APP_0_0_1: AppSpec;
 export declare const MODEL_CHOICE_APP_0_0_1: AppSpec;
 export declare const PIPELINE_REPORT_APP_0_0_1: AppSpec;

package/lib/specs/apps.js

@@ -269,6 +269,114 @@ export const DATA_QUALITY_APP_0_0_1 = {
     banner: '',
     setup: ["The agent 'jupyter-data-analyst:0.0.1' is not enabled."],
 };
+export const DECIDE_APP_0_0_1 = {
+    schema: 'loop.app/v1',
+    id: 'decide',
+    version: '0.0.1',
+    name: 'Decide',
+    kind: 'chat',
+    description: 'Answers a question about a text — a ticket, a message, a review — by asking Jev a typed decision: yes or no, one of named options, or a score, each with its confidence.',
+    owner: 'Datalayer <info@datalayer.io>',
+    agent: 'example-simple:0.0.1',
+    team: '',
+    instructions: 'Answer every question about a text by asking a typed decision with the decide tool: the text as it was given is the state, and the question is one of noul (does a statement hold: yes or no), choice (which of the options named) or score (which step of a scale, lowest first). Then say the answer in plain words with its probability or its confidence, for example "Urgent: yes (0.87)". When the question names no options for a choice or no scale for a score, ask for them rather than inventing them. When nothing was decided, say why in a sentence.',
+    model: '',
+    skills: [],
+    tools: ['decide:0.0.1'],
+    context: [],
+    contents: [],
+    connections: [],
+    rules: [
+        {
+            action: 'Ask a decision',
+            appliesTo: ['decide'],
+            behaviour: 'do_it',
+        },
+    ],
+    permissions: {
+        spaces: [],
+        computer: {
+            browse: false,
+            files: false,
+            shell: false,
+        },
+    },
+    interface: {
+        layout: 'chat',
+        accent: 'sun',
+        welcome: 'Give me a text and a question about it. I ask Jev a typed decision — yes or no, a choice, or a score — and tell you the answer with its confidence.',
+        starters: [
+            {
+                label: 'Is it urgent?',
+                message: "Is this ticket urgent? 'Help! My payouts have been failing for 3 days.'",
+            },
+            {
+                label: 'Which team?',
+                message: "Which team should handle this: 'I was charged twice this month'? Billing, Tech or Sales.",
+            },
+            {
+                label: 'Score a review',
+                message: "Score how positive this review is from 1 to 5: 'Setup took an hour, but support answered fast and it works.'",
+            },
+        ],
+        settings: [],
+        components: [],
+        assistant: 'wizard',
+    },
+    tests: {
+        readyAt: 0.8,
+        evalset: '',
+        cases: [
+            {
+                ask: "Is this ticket urgent? 'Help! My payouts have been failing for 3 days.'",
+                expect: 'It calls decide with a noul question and answers yes, with its probability.',
+            },
+            {
+                ask: "Which team should handle this: 'I was charged twice this month'? Billing, Tech or Sales.",
+                expect: 'It calls decide with a choice among the three and answers Billing, with its confidence.',
+            },
+            {
+                ask: 'Score this review.',
+                expect: 'It asks for the review and the scale rather than inventing them.',
+            },
+        ],
+        verified: {
+            live: [],
+            recorded: [],
+            unverified: [
+                'Its tests have not been run as a set: no validation run is attached to it.',
+            ],
+        },
+    },
+    record: {
+        keepFor: '30_days',
+        include: ['conversations', 'decisions'],
+        suggestTests: false,
+        retentionDays: 30,
+    },
+    checks: {
+        guards: [],
+        gates: [],
+        track: '',
+    },
+    deployment: {
+        hosted: {
+            visibility: 'private',
+            slug: '',
+        },
+    },
+    goal: '',
+    triggers: [],
+    memory: '',
+    notifications: [],
+    enabled: true,
+    tags: ['example', 'decisions', 'jev'],
+    icon: 'law',
+    emoji: '⚖️',
+    avatar: '',
+    banner: '',
+    setup: [],
+};
 export const INBOX_TRIAGE_APP_0_0_1 = {
     schema: 'loop.app/v1',
     id: 'inbox-triage',
@@ -2072,6 +2180,7 @@ export const WEB_RESEARCH_APP_0_0_1 = {
 export const APP_CATALOGUE = {
     'customer-interview': CUSTOMER_INTERVIEW_APP_0_0_1,
     'data-quality': DATA_QUALITY_APP_0_0_1,
+    decide: DECIDE_APP_0_0_1,
     'inbox-triage': INBOX_TRIAGE_APP_0_0_1,
     'model-choice': MODEL_CHOICE_APP_0_0_1,
     'pipeline-report': PIPELINE_REPORT_APP_0_0_1,
@@ -2266,6 +2375,74 @@ export const APP_SOURCES = {
         icon: 'filter',
         emoji: '🧹',
     },
+    decide: {
+        schema: 'loop.app/v1',
+        id: 'decide',
+        name: 'Decide',
+        kind: 'chat',
+        description: 'Answers a question about a text — a ticket, a message, a review — by asking Jev a typed decision: yes or no, one of named options, or a score, each with its confidence.',
+        owner: 'Datalayer <info@datalayer.io>',
+        agent: 'example-simple:0.0.1',
+        instructions: 'Answer every question about a text by asking a typed decision with the decide tool: the text as it was given is the state, and the question is one of noul (does a statement hold: yes or no), choice (which of the options named) or score (which step of a scale, lowest first). Then say the answer in plain words with its probability or its confidence, for example "Urgent: yes (0.87)". When the question names no options for a choice or no scale for a score, ask for them rather than inventing them. When nothing was decided, say why in a sentence.',
+        tools: ['decide:0.0.1'],
+        rules: [
+            {
+                action: 'Ask a decision',
+                applies_to: ['decide'],
+                behaviour: 'do_it',
+            },
+        ],
+        interface: {
+            accent: 'sun',
+            welcome: 'Give me a text and a question about it. I ask Jev a typed decision — yes or no, a choice, or a score — and tell you the answer with its confidence.',
+            starters: [
+                {
+                    label: 'Is it urgent?',
+                    message: "Is this ticket urgent? 'Help! My payouts have been failing for 3 days.'",
+                },
+                {
+                    label: 'Which team?',
+                    message: "Which team should handle this: 'I was charged twice this month'? Billing, Tech or Sales.",
+                },
+                {
+                    label: 'Score a review',
+                    message: "Score how positive this review is from 1 to 5: 'Setup took an hour, but support answered fast and it works.'",
+                },
+            ],
+            assistant: 'wizard',
+        },
+        tests: {
+            cases: [
+                {
+                    ask: "Is this ticket urgent? 'Help! My payouts have been failing for 3 days.'",
+                    expect: 'It calls decide with a noul question and answers yes, with its probability.',
+                },
+                {
+                    ask: "Which team should handle this: 'I was charged twice this month'? Billing, Tech or Sales.",
+                    expect: 'It calls decide with a choice among the three and answers Billing, with its confidence.',
+                },
+                {
+                    ask: 'Score this review.',
+                    expect: 'It asks for the review and the scale rather than inventing them.',
+                },
+            ],
+            verified: {
+                unverified: [
+                    'Its tests have not been run as a set: no validation run is attached to it.',
+                ],
+            },
+        },
+        record: {
+            keep_for: '30_days',
+            include: ['conversations', 'decisions'],
+        },
+        deployment: {
+            hosted: {},
+        },
+        tags: ['example', 'decisions', 'jev'],
+        icon: 'law',
+        emoji: '⚖️',
+    },
     'inbox-triage': {
         schema: 'loop.app/v1',
         id: 'inbox-triage',
@@ -3644,6 +3821,7 @@ export const APP_SOURCES = {
 export const APP_BUILT = {
     'customer-interview': 'python',
     'data-quality': 'written',
+    decide: 'written',
     'inbox-triage': 'written',
     'model-choice': 'written',
     'pipeline-report': 'written',

package/lib/stories/loop/LoopReference.stories.d.ts

@@ -17,5 +17,7 @@ export declare const BesideItsWork: Story;
 export declare const WorkerActivity: Story;
 /** An approval. */
 export declare const Approval: Story;
+/** Tool calls, each led by the mark of whoever the tool belongs to. */
+export declare const ToolMarks: Story;
 /** The floating assistant, in each of its states or stepped aside. */
 export declare const Assistant: Story;

package/lib/stories/loop/LoopReference.stories.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { ASSISTANT_PICTURES, AssistantScreen, ApprovalScreen, BesideWorkScreen, ConversationScreen, REFERENCE_THEMES, ReferenceTheme, WorkerActivityScreen, } from './ReferenceScreens';
+import { ASSISTANT_PICTURES, AssistantScreen, ApprovalScreen, BesideWorkScreen, ConversationScreen, REFERENCE_THEMES, ReferenceTheme, ToolMarksScreen, WorkerActivityScreen, } from './ReferenceScreens';
 const meta = {
     title: 'Loop/Reference screens',
     parameters: { layout: 'fullscreen' },
@@ -25,6 +25,8 @@ export const BesideItsWork = story(BesideWorkScreen);
 export const WorkerActivity = story(WorkerActivityScreen);
 /** An approval. */
 export const Approval = story(ApprovalScreen);
+/** Tool calls, each led by the mark of whoever the tool belongs to. */
+export const ToolMarks = story(ToolMarksScreen);
 /** The floating assistant, in each of its states or stepped aside. */
 export const Assistant = {
     render: ({ theme, mode, picture }) => (_jsx(ReferenceTheme, { theme: theme, mode: mode, children: _jsx(AssistantScreen, { picture: picture }) })),

package/lib/stories/loop/ReferenceScreens.d.ts

@@ -1,7 +1,7 @@
 import type { JSX, ReactNode } from 'react';
 import { type ThemeVariant } from '@datalayer/primer-addons';
-/** The four screens, by the name a picture and a story take. */
-export declare const REFERENCE_SCREENS: readonly ["conversation", "beside-work", "worker-activity", "approval"];
+/** The screens, by the name a picture and a story take. */
+export declare const REFERENCE_SCREENS: readonly ["conversation", "beside-work", "worker-activity", "approval", "tool-marks"];
 export type ReferenceScreen = (typeof REFERENCE_SCREENS)[number];
 /** The floating assistant's pictures (T-27): its states, and stepped aside. */
 export declare const ASSISTANT_PICTURES: readonly ["idle", "thinking", "working", "waiting", "paused", "speaking", "aside"];
@@ -34,6 +34,8 @@ export declare function BesideWorkScreen(): JSX.Element;
 export declare function WorkerActivityScreen(): JSX.Element;
 /** An approval: the action, the rule that asks, and the one decision. */
 export declare function ApprovalScreen(): JSX.Element;
+/** Tool calls, each led by the mark of whoever the tool belongs to. */
+export declare function ToolMarksScreen(): JSX.Element;
 export declare const REFERENCE_SCREEN_COMPONENTS: Record<ReferenceScreen, () => JSX.Element>;
 /**
  * The paper clip in one state, in the page's corner. `aside` puts a dialog

package/lib/stories/loop/ReferenceScreens.js

@@ -31,12 +31,13 @@ import { ASSISTANT_WORDS, } from '../../chat/assistant/state';
 import { buildReactorFromPlugins } from '@datalayer/reactor';
 import { AssistantCharactersPlugin, assistantCharacterNamed, } from '../../loop/plugins/assistant-characters';
 import { OwlCharacterPlugin } from '../../examples/utils/owlCharacterPlugin';
-/** The four screens, by the name a picture and a story take. */
+/** The screens, by the name a picture and a story take. */
 export const REFERENCE_SCREENS = [
     'conversation',
     'beside-work',
     'worker-activity',
     'approval',
+    'tool-marks',
 ];
 /** The floating assistant's pictures (T-27): its states, and stepped aside. */
 export const ASSISTANT_PICTURES = [
@@ -145,6 +146,24 @@ const APPROVAL = [
     said('a2', 'assistant', 'Sending is a rule you keep: I ask first.'),
     tool('a3', 'send_email', { to: 'ada@example.com', subject: 'Your order 1042' }, 'inProgress', { pending_approval: true, approval_id: 'approval-1' }),
 ];
+/*
+ * Whose tools: an MCP server's (the Odoo accounting server's, its icon the
+ * Datalayer icons' Odoo), a skill's and a frontend tool set's, each call led
+ * by its mark.
+ */
+const TOOL_MARKS = [
+    said('t1', 'user', 'What is still open on the books, and does my notebook agree?'),
+    tool('t2', 'odoo_accounting_list_open_balances', { account: '400000' }, 'complete', { partners: 7 }),
+    tool('t3', 'run_skill_script', { skill_name: 'accounting', script: 'variance' }, 'complete', { variance: 0 }),
+    tool('t4', 'readCell', { index: 3 }, 'complete', { source: 'balances' }),
+    said('t5', 'assistant', 'Seven customers owe you, and your notebook says the same total.'),
+];
+const TOOL_MARKS_SERVERS = [
+    {
+        id: 'odoo-accounting',
+        tools: [{ name: 'odoo_accounting_list_open_balances' }],
+    },
+];
 // ---------------------------------------------------------------------------
 // The conversation
 // ---------------------------------------------------------------------------
@@ -157,7 +176,7 @@ const AVATARS = {
     assistantAvatarBg: 'accent.emphasis',
 };
 /** A chat as an application shows it: its presence, its words, its composer. */
-function Conversation({ name, face, presence, items, composer = true, }) {
+function Conversation({ name, face, presence, items, composer = true, mcpServers, }) {
     const endRef = useRef(null);
     const [input, setInput] = useState('');
     return (_jsxs(Box, { sx: {
@@ -166,7 +185,7 @@ function Conversation({ name, face, presence, items, composer = true, }) {
             display: 'flex',
             flexDirection: 'column',
             height: '100%',
-        }, children: [_jsx(ChatBaseHeader, { title: name, brandIcon: _jsx(PresenceFace, { face: face, size: 20, state: presence }), headerContent: _jsx(PresenceLine, { state: presence }), padding: 3, messageCount: items.length, onNewChat: () => undefined, onClear: () => undefined }), _jsx(Box, { sx: { flex: 1, minHeight: 0, overflow: 'hidden' }, children: _jsx(ChatMessageList, { displayItems: items, isLoading: false, isStreaming: false, showLoadingIndicator: false, hideMessagesAfterToolUI: false, avatarConfig: AVATARS, padding: 3, emptyContent: null, messagesEndRef: endRef, onRespond: async () => undefined }) }), composer && (_jsx(InputPrompt, { input: input, setInput: setInput, isLoading: false, connectionConfirmed: true, placeholder: "Send a message", autoFocus: false, padding: 3, onSend: () => undefined, onStop: () => undefined, showTokenUsage: false, showModelSelector: false, showToolsMenu: false, showSkillsMenu: false, codemodeEnabled: false, hasConfigData: false, hasSkillsData: false, isA2AProtocol: false }))] }));
+        }, children: [_jsx(ChatBaseHeader, { title: name, brandIcon: _jsx(PresenceFace, { face: face, size: 20, state: presence }), headerContent: _jsx(PresenceLine, { state: presence }), padding: 3, messageCount: items.length, onNewChat: () => undefined, onClear: () => undefined }), _jsx(Box, { sx: { flex: 1, minHeight: 0, overflow: 'hidden' }, children: _jsx(ChatMessageList, { displayItems: items, isLoading: false, isStreaming: false, showLoadingIndicator: false, hideMessagesAfterToolUI: false, avatarConfig: AVATARS, padding: 3, emptyContent: null, messagesEndRef: endRef, onRespond: async () => undefined, mcpServers: mcpServers }) }), composer && (_jsx(InputPrompt, { input: input, setInput: setInput, isLoading: false, connectionConfirmed: true, placeholder: "Send a message", autoFocus: false, padding: 3, onSend: () => undefined, onStop: () => undefined, showTokenUsage: false, showModelSelector: false, showToolsMenu: false, showSkillsMenu: false, codemodeEnabled: false, hasConfigData: false, hasSkillsData: false, isA2AProtocol: false }))] }));
 }
 // ---------------------------------------------------------------------------
 // The four screens
@@ -198,11 +217,16 @@ export function WorkerActivityScreen() {
 export function ApprovalScreen() {
     return (_jsx(Frame, { children: _jsx(Box, { sx: { flex: 1, display: 'flex', justifyContent: 'center' }, children: _jsx(Box, { sx: { width: '100%', maxWidth: 640, display: 'flex' }, children: _jsx(Conversation, { name: "Support desk", face: "\uD83E\uDD8A", presence: "waiting", items: APPROVAL }) }) }) }));
 }
+/** Tool calls, each led by the mark of whoever the tool belongs to. */
+export function ToolMarksScreen() {
+    return (_jsx(Frame, { children: _jsx(Box, { sx: { flex: 1, display: 'flex', justifyContent: 'center' }, children: _jsx(Box, { sx: { width: '100%', maxWidth: 680, display: 'flex' }, children: _jsx(Conversation, { name: "Bookkeeper", face: "\uD83E\uDDEE", presence: "idle", items: TOOL_MARKS, composer: false, mcpServers: TOOL_MARKS_SERVERS }) }) }) }));
+}
 export const REFERENCE_SCREEN_COMPONENTS = {
     conversation: ConversationScreen,
     'beside-work': BesideWorkScreen,
     'worker-activity': WorkerActivityScreen,
     approval: ApprovalScreen,
+    'tool-marks': ToolMarksScreen,
 };
 // ---------------------------------------------------------------------------
 // The floating assistant (T-27)

package/package.json

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