@datalayer/agent-runtimes 1.3.30 → 1.3.33

package/lib/specs/appspecSchema.js

@@ -112,7 +112,7 @@ export const APPSPEC_SCHEMA = {
         },
         AppCriterion: {
             additionalProperties: false,
-            description: 'What an alternative is judged on.',
+            description: 'What an alternative is weighed on.',
             properties: {
                 name: {
                     description: 'Its name',
@@ -133,7 +133,7 @@ export const APPSPEC_SCHEMA = {
                 },
                 instructions: {
                     default: '',
-                    description: 'What a judgment model is asked, or how a metric is computed',
+                    description: 'What a decision model is asked, or how a metric is computed',
                     title: 'Instructions',
                     type: 'string',
                 },
@@ -182,7 +182,7 @@ export const APPSPEC_SCHEMA = {
                     type: 'array',
                 },
                 criteria: {
-                    description: 'What each is judged on',
+                    description: 'What each is weighed on',
                     items: {
                         $ref: '#/$defs/AppCriterion',
                     },
@@ -191,7 +191,7 @@ export const APPSPEC_SCHEMA = {
                 },
                 min_confidence: {
                     default: 0,
-                    description: 'A judgment less confident than this is put to the reader',
+                    description: 'An answer less confident than this is put to the reader',
                     maximum: 1,
                     minimum: 0,
                     title: 'Min Confidence',
@@ -205,10 +205,10 @@ export const APPSPEC_SCHEMA = {
                     title: 'Scenarios',
                     type: 'array',
                 },
-                judgment_model: {
+                decision_model: {
                     default: '',
-                    description: 'The model that answers the judgments',
-                    title: 'Judgment Model',
+                    description: "The model that answers the decision's typed questions",
+                    title: 'Decision Model',
                     type: 'string',
                 },
             },
@@ -371,6 +371,12 @@ export const APPSPEC_SCHEMA = {
                     title: 'Include',
                     type: 'array',
                 },
+                suggest_tests: {
+                    default: false,
+                    description: 'Whether its conversations may be used to suggest tests: a few, sampled from those kept while it is on, proposed to its builder; off unless said',
+                    title: 'Suggest Tests',
+                    type: 'boolean',
+                },
             },
             title: 'AppRecord',
             type: 'object',

package/lib/specs/models.d.ts

@@ -97,7 +97,7 @@ export declare const AI_MODEL_ALIASES: Record<string, string>;
 /** A model by its id, or by an id it had before; undefined when the catalogue has neither. */
 export declare function getModel(modelId: string): AIModel | undefined;
 /**
- * A model a chat can run on: not a typed-judgment model (Jev), which
+ * A model a chat can run on: not a typed-decision model (Jev), which
  * answers typed questions about a state and nothing else. A spec that
  * states no capability is read as a chat model.
  */

package/lib/specs/models.js

@@ -333,7 +333,7 @@ export const BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_6_0_0_1 = {
         'AWS_DEFAULT_REGION',
     ],
     tokensLimit: 64000,
-    capabilities: ['chat', 'tools', 'judge'],
+    capabilities: ['chat', 'tools', 'decider'],
     contextWindow: 200000,
 };
 export const BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_20250514_V1_0_0_0_1 = {
@@ -356,13 +356,13 @@ export const CLOUDFLARE_GTW_TYPESAFE_JEV_0_0_1 = {
     id: 'cloudflare:gtw/typesafe/jev',
     version: '0.0.1',
     name: 'Jev (Cloudflare AI Gateway)',
-    description: "Typesafe's typed-judgment model through the account's AI Gateway - noul, choice and score questions answered as calibrated probabilities; 32k context; zero data retention; the gateway keeps the logs and bills from its credits",
+    description: "Typesafe's typed-decision model through the account's AI Gateway - noul, choice and score questions answered as calibrated probabilities; 32k context; zero data retention; the gateway keeps the logs and bills from its credits",
     provider: 'cloudflare',
     providerUrl: 'https://docs.typesafe.ai/models',
     default: false,
     available: true,
     requiredEnvVars: [],
-    capabilities: ['judgments'],
+    capabilities: ['decisions'],
     billing: 'credits',
     route: 'ai-gateway',
     contextWindow: 32000,
@@ -415,7 +415,7 @@ export const CLOUDFLARE_WRK_OPENAI_GPT_OSS_120B_0_0_1 = {
     available: false,
     requiredEnvVars: [],
     tokensLimit: 32768,
-    capabilities: ['chat', 'tools', 'codemode', 'judge'],
+    capabilities: ['chat', 'tools', 'codemode', 'decider'],
     billing: 'standard',
     route: 'workers-ai',
     contextWindow: 128000,
@@ -476,13 +476,13 @@ export const CLOUDFLARE_WRK_TYPESAFE_JEV_0_0_1 = {
     id: 'cloudflare:wrk/typesafe/jev',
     version: '0.0.1',
     name: 'Jev (Cloudflare Workers AI)',
-    description: "Typesafe's typed-judgment model at Workers AI's own endpoint - noul, choice and score questions answered as calibrated probabilities; 32k context; zero data retention; billed from the account's credits, no gateway in the way",
+    description: "Typesafe's typed-decision model at Workers AI's own endpoint - noul, choice and score questions answered as calibrated probabilities; 32k context; zero data retention; billed from the account's credits, no gateway in the way",
     provider: 'cloudflare',
     providerUrl: 'https://docs.typesafe.ai/models',
     default: false,
     available: true,
     requiredEnvVars: [],
-    capabilities: ['judgments'],
+    capabilities: ['decisions'],
     billing: 'credits',
     route: 'workers-ai',
     contextWindow: 32000,
@@ -665,12 +665,12 @@ export function getModel(modelId) {
     return AI_MODEL_CATALOGUE[AI_MODEL_ALIASES[modelId] ?? modelId];
 }
 /**
- * A model a chat can run on: not a typed-judgment model (Jev), which
+ * A model a chat can run on: not a typed-decision model (Jev), which
  * answers typed questions about a state and nothing else. A spec that
  * states no capability is read as a chat model.
  */
 export function isChatModel(model) {
-    return !(model.capabilities ?? []).includes('judgments');
+    return !(model.capabilities ?? []).includes('decisions');
 }
 /** The models a person choosing a chat model is offered from. */
 export function listChatModels() {

package/lib/specs/tools.d.ts

@@ -9,6 +9,7 @@
 import type { ToolSpec } from '../types';
 export declare const CREATE_PLAN_TOOL_SPEC_0_0_1: ToolSpec;
 export declare const CURRENT_TIME_TOOL_SPEC_0_0_1: ToolSpec;
+export declare const DECIDE_TOOL_SPEC_0_0_1: ToolSpec;
 export declare const DISPLAY_RECIPE_TOOL_SPEC_0_0_1: ToolSpec;
 export declare const EXAMPLE_CREATE_PLAN_TOOL_SPEC_0_0_1: ToolSpec;
 export declare const EXAMPLE_CURRENT_TIME_TOOL_SPEC_0_0_1: ToolSpec;

package/lib/specs/tools.js

@@ -41,6 +41,24 @@ export const CURRENT_TIME_TOOL_SPEC_0_0_1 = {
     icon: 'clock',
     emoji: '🕒',
 };
+export const DECIDE_TOOL_SPEC_0_0_1 = {
+    id: 'decide',
+    version: '0.0.1',
+    name: 'Decide',
+    description: 'Ask Jev typed questions about a text — noul (does a statement hold, with its probability), choice (one of named options) or score (a step on a rubric) — and get the typed answers back, through datalayer-ai-inference.',
+    tags: ['runtime', 'decisions', 'jev'],
+    enabled: true,
+    approval: 'auto',
+    timeout: undefined,
+    requiresApproval: false,
+    runtime: {
+        language: 'python',
+        package: 'agent_runtimes.tools.decisions',
+        method: 'decide',
+    },
+    icon: 'law',
+    emoji: '⚖️',
+};
 export const DISPLAY_RECIPE_TOOL_SPEC_0_0_1 = {
     id: 'display-recipe',
     version: '0.0.1',
@@ -335,6 +353,7 @@ export const UPDATE_PLAN_STEP_TOOL_SPEC_0_0_1 = {
 export const TOOL_CATALOG = {
     'create-plan': CREATE_PLAN_TOOL_SPEC_0_0_1,
     'current-time': CURRENT_TIME_TOOL_SPEC_0_0_1,
+    decide: DECIDE_TOOL_SPEC_0_0_1,
     'display-recipe': DISPLAY_RECIPE_TOOL_SPEC_0_0_1,
     'example-create-plan': EXAMPLE_CREATE_PLAN_TOOL_SPEC_0_0_1,
     'example-current-time': EXAMPLE_CURRENT_TIME_TOOL_SPEC_0_0_1,

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

@@ -0,0 +1,21 @@
+import type { Meta, StoryObj } from '@storybook/react-vite';
+import { type AssistantPicture, type ReferenceMode } from './ReferenceScreens';
+import type { ThemeVariant } from '@datalayer/primer-addons';
+interface ReferenceArgs {
+    theme: ThemeVariant;
+    mode: ReferenceMode;
+    picture: AssistantPicture;
+}
+declare const meta: Meta<ReferenceArgs>;
+export default meta;
+type Story = StoryObj<ReferenceArgs>;
+/** A conversation. */
+export declare const Conversation: Story;
+/** A conversation beside its work. */
+export declare const BesideItsWork: Story;
+/** The activity of a worker. */
+export declare const WorkerActivity: Story;
+/** An approval. */
+export declare const Approval: Story;
+/** The floating assistant, in each of its states or stepped aside. */
+export declare const Assistant: Story;

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

@@ -0,0 +1,31 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { ASSISTANT_PICTURES, AssistantScreen, ApprovalScreen, BesideWorkScreen, ConversationScreen, REFERENCE_THEMES, ReferenceTheme, WorkerActivityScreen, } from './ReferenceScreens';
+const meta = {
+    title: 'Loop/Reference screens',
+    parameters: { layout: 'fullscreen' },
+    args: { theme: 'loop', mode: 'light', picture: 'idle' },
+    argTypes: {
+        theme: { control: 'select', options: REFERENCE_THEMES },
+        mode: { control: 'inline-radio', options: ['light', 'dark'] },
+        picture: { control: 'select', options: [...ASSISTANT_PICTURES] },
+    },
+};
+export default meta;
+function story(Screen) {
+    return {
+        argTypes: { picture: { table: { disable: true } } },
+        render: ({ theme, mode }) => (_jsx(ReferenceTheme, { theme: theme, mode: mode, children: _jsx(Screen, {}) })),
+    };
+}
+/** A conversation. */
+export const Conversation = story(ConversationScreen);
+/** A conversation beside its work. */
+export const BesideItsWork = story(BesideWorkScreen);
+/** The activity of a worker. */
+export const WorkerActivity = story(WorkerActivityScreen);
+/** An approval. */
+export const Approval = story(ApprovalScreen);
+/** 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

@@ -0,0 +1,53 @@
+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"];
+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", "speaking", "aside"];
+export type AssistantPicture = (typeof ASSISTANT_PICTURES)[number];
+/**
+ * The characters pictured idle, each in light and dark (T-25, T-24):
+ * Datalayer's wizard, cat and L👀P eyes — the paper clip's idle is
+ * `assistant-idle` — and the owl an example plugin contributes, drawn
+ * through `loop.assistant.character`.
+ */
+export declare const CHARACTER_PICTURES: readonly ["wizard", "cat", "eyes", "owl"];
+export type CharacterPicture = (typeof CHARACTER_PICTURES)[number];
+export type ReferenceMode = 'light' | 'dark';
+/** Every theme of the registry, in its order. */
+export declare const REFERENCE_THEMES: ThemeVariant[];
+/**
+ * A screen in a theme and a mode, on its stage: the flat tint of the accent
+ * in `loop` (mint, the default), the muted canvas in every other theme.
+ */
+export declare function ReferenceTheme({ theme, mode, children, }: {
+    theme: ThemeVariant;
+    mode: ReferenceMode;
+    children: ReactNode;
+}): JSX.Element;
+/** A conversation. */
+export declare function ConversationScreen(): JSX.Element;
+/** A conversation beside its work: the split, one hairline between them. */
+export declare function BesideWorkScreen(): JSX.Element;
+/** The activity of a worker: what it did on its own, as it did it. */
+export declare function WorkerActivityScreen(): JSX.Element;
+/** An approval: the action, the rule that asks, and the one decision. */
+export declare function ApprovalScreen(): 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
+ * over it: the real `useKeepClear` steps it aside, and the picture shows the
+ * dialog alone.
+ */
+export declare function AssistantScreen({ picture, }: {
+    picture: AssistantPicture;
+}): JSX.Element;
+/**
+ * One character idle in the page's corner, read from what the enabled
+ * plugins contribute; `ready` is drawn with it.
+ */
+export declare function CharacterScreen({ character, ready, }: {
+    character: CharacterPicture;
+    ready?: ReactNode;
+}): JSX.Element;

package/lib/stories/loop/ReferenceScreens.js

@@ -0,0 +1,256 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * The four reference screens of the `loop` theme (LOOP T-01), and the
+ * floating assistant's states (T-27), drawn from the real chat components
+ * with fixed data: no agent, no network, no clock.
+ *
+ * - a conversation;
+ * - a conversation beside its work;
+ * - the activity of a worker;
+ * - an approval.
+ *
+ * Each renders in any theme of the registry and in either mode, so the same
+ * screen is the design reference (the stories) and the picture a token change
+ * is compared against (`pictures/`, T-16).
+ *
+ * @module stories/loop/ReferenceScreens
+ */
+import { useEffect, useRef, useState } from 'react';
+import { Box, Button, Heading, Text } from '@primer/react';
+import { DatalayerThemeProvider, loopAccentStyles, setupPrimerPortals, themeConfigs, } from '@datalayer/primer-addons';
+import { ChatBaseHeader } from '../../chat/header/ChatHeaderBase';
+import { ChatMessageList } from '../../chat/messages/ChatMessageList';
+import { InputPrompt } from '../../chat/prompt/InputPrompt';
+import { PresenceFace, PresenceLine } from '../../chat/presence/Presence';
+import { AssistantStage } from '../../chat/assistant/AssistantStage';
+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. */
+export const REFERENCE_SCREENS = [
+    'conversation',
+    'beside-work',
+    'worker-activity',
+    'approval',
+];
+/** The floating assistant's pictures (T-27): its states, and stepped aside. */
+export const ASSISTANT_PICTURES = [
+    'idle',
+    'thinking',
+    'working',
+    'waiting',
+    'speaking',
+    'aside',
+];
+/**
+ * The characters pictured idle, each in light and dark (T-25, T-24):
+ * Datalayer's wizard, cat and L👀P eyes — the paper clip's idle is
+ * `assistant-idle` — and the owl an example plugin contributes, drawn
+ * through `loop.assistant.character`.
+ */
+export const CHARACTER_PICTURES = ['wizard', 'cat', 'eyes', 'owl'];
+/** Every theme of the registry, in its order. */
+export const REFERENCE_THEMES = Object.keys(themeConfigs);
+// ---------------------------------------------------------------------------
+// The theme around a screen
+// ---------------------------------------------------------------------------
+/**
+ * A screen in a theme and a mode, on its stage: the flat tint of the accent
+ * in `loop` (mint, the default), the muted canvas in every other theme.
+ */
+export function ReferenceTheme({ theme, mode, children, }) {
+    const config = themeConfigs[theme] ?? themeConfigs.loop;
+    useEffect(() => {
+        setupPrimerPortals();
+    }, []);
+    useEffect(() => {
+        document.documentElement.setAttribute('data-reference-theme', theme);
+        document.documentElement.setAttribute('data-reference-mode', mode);
+    }, [theme, mode]);
+    return (_jsx(DatalayerThemeProvider, { colorMode: mode, theme: config.primerTheme, themeStyles: config.themeStyles, baseStyles: theme === 'loop'
+            ? loopAccentStyles('green', mode)
+            : undefined, children: _jsx(Box, { "data-reference-stage": "", sx: {
+                position: 'fixed',
+                inset: 0,
+                p: 4,
+                bg: 'var(--loop-stage, var(--bgColor-muted))',
+                color: 'fg.default',
+                display: 'flex',
+            }, children: children }) }));
+}
+/** One rounded surface on the stage: the theme's frame. */
+function Frame({ children }) {
+    return (_jsx(Box, { sx: {
+            flex: 1,
+            minWidth: 0,
+            display: 'flex',
+            overflow: 'hidden',
+            bg: 'canvas.default',
+            borderRadius: 'var(--theme-radius-frame, 12px)',
+            border: 'var(--theme-hairline, 1px) solid',
+            borderColor: 'border.muted',
+            boxShadow: 'var(--theme-shadow, none)',
+        }, children: children }));
+}
+// ---------------------------------------------------------------------------
+// Fixed data
+// ---------------------------------------------------------------------------
+const AT = new Date('2026-10-04T09:30:00Z');
+function said(id, role, content) {
+    return { id, role, content, createdAt: AT };
+}
+function tool(id, toolName, args, status, result) {
+    return {
+        id,
+        type: 'tool-call',
+        toolCallId: id,
+        toolName,
+        args,
+        status,
+        result,
+    };
+}
+const CONVERSATION = [
+    said('m1', 'user', 'Which customers wrote about late deliveries this week?'),
+    said('m2', 'assistant', 'Three of them: **Ada Lovelace** (order 1042, four days late), ' +
+        '**Grace Hopper** (order 1057, asks for a refund) and **Alan Turing** ' +
+        '(order 1061, no tracking number). The details are in the ' +
+        '[support log](https://example.com/log).'),
+    said('m3', 'user', 'Draft a reply to Ada.'),
+    said('m4', 'assistant', 'Here is a draft, beside the conversation. It apologises, gives the new ' +
+        'date and offers free shipping on her next order.'),
+];
+const BESIDE_WORK = CONVERSATION.slice(2);
+const WORKER_ACTIVITY = [
+    said('w1', 'assistant', 'Morning run: 12 new messages in the inbox.'),
+    tool('w2', 'read_inbox', { since: '2026-10-04T06:00:00Z' }, 'complete', {
+        messages: 12,
+    }),
+    tool('w3', 'label_message', { id: 'msg-881', label: 'Refund' }, 'complete', {
+        ok: true,
+    }),
+    tool('w4', 'label_message', { id: 'msg-884', label: 'Delivery' }, 'complete', { ok: true }),
+    said('w5', 'assistant', 'Nine labelled, two answered from the help centre, one left for you: a ' +
+        'refund above the limit.'),
+    tool('w6', 'draft_reply', { id: 'msg-887' }, 'executing'),
+];
+const APPROVAL = [
+    said('a1', 'user', 'Send the reply to Ada.'),
+    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' }),
+];
+// ---------------------------------------------------------------------------
+// The conversation
+// ---------------------------------------------------------------------------
+const AVATARS = {
+    userAvatar: 'me',
+    assistantAvatar: 'ai',
+    showAvatars: false,
+    avatarSize: 24,
+    userAvatarBg: 'accent.subtle',
+    assistantAvatarBg: 'accent.emphasis',
+};
+/** A chat as an application shows it: its presence, its words, its composer. */
+function Conversation({ name, face, presence, items, composer = true, }) {
+    const endRef = useRef(null);
+    const [input, setInput] = useState('');
+    return (_jsxs(Box, { sx: {
+            flex: 1,
+            minWidth: 0,
+            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 }))] }));
+}
+// ---------------------------------------------------------------------------
+// The four screens
+// ---------------------------------------------------------------------------
+/** A conversation. */
+export function ConversationScreen() {
+    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: "idle", items: CONVERSATION }) }) }) }));
+}
+/** A conversation beside its work: the split, one hairline between them. */
+export function BesideWorkScreen() {
+    return (_jsxs(Frame, { children: [_jsx(Box, { sx: { width: 400, flexShrink: 0, display: 'flex' }, children: _jsx(Conversation, { name: "Support desk", face: "\uD83E\uDD8A", presence: "idle", items: BESIDE_WORK }) }), _jsx(Box, { sx: {
+                    width: 'var(--theme-hairline, 1px)',
+                    bg: 'border.muted',
+                    flexShrink: 0,
+                } }), _jsxs(Box, { "data-reference-work": "", sx: {
+                    flex: 1,
+                    minWidth: 0,
+                    p: 4,
+                    display: 'flex',
+                    flexDirection: 'column',
+                    gap: 3,
+                }, children: [_jsx(Text, { sx: { color: 'fg.muted', fontSize: 1 }, children: "Draft \u00B7 reply" }), _jsx(Heading, { as: "h2", sx: { fontSize: 3, fontWeight: 600 }, children: "Your order 1042" }), _jsx(Text, { sx: { color: 'fg.muted', fontSize: 1 }, children: "To ada@example.com" }), _jsxs(Box, { sx: { display: 'flex', flexDirection: 'column', gap: 2 }, children: [_jsx(Text, { as: "p", sx: { m: 0 }, children: "Dear Ada," }), _jsx(Text, { as: "p", sx: { m: 0 }, children: "We are sorry your order arrived four days late. It left our warehouse on Monday and is with you by Thursday, 8 October." }), _jsx(Text, { as: "p", sx: { m: 0 }, children: "Your next order ships free, with no code to enter." }), _jsx(Text, { as: "p", sx: { m: 0 }, children: "The support desk" })] }), _jsxs(Box, { sx: { display: 'flex', gap: 2, mt: 'auto' }, children: [_jsx(Button, { variant: "primary", children: "Send" }), _jsx(Button, { children: "Edit" })] })] })] }));
+}
+/** The activity of a worker: what it did on its own, as it did it. */
+export function WorkerActivityScreen() {
+    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: "Inbox triage", face: "\uD83D\uDCEC", presence: "working", items: WORKER_ACTIVITY, composer: false }) }) }) }));
+}
+/** An approval: the action, the rule that asks, and the one decision. */
+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 }) }) }) }));
+}
+export const REFERENCE_SCREEN_COMPONENTS = {
+    conversation: ConversationScreen,
+    'beside-work': BesideWorkScreen,
+    'worker-activity': WorkerActivityScreen,
+    approval: ApprovalScreen,
+};
+// ---------------------------------------------------------------------------
+// The floating assistant (T-27)
+// ---------------------------------------------------------------------------
+const BALLOONS = {
+    speaking: {
+        text: 'Three customers wrote about late deliveries this week: Ada, Grace and Alan.',
+        more: true,
+    },
+    waiting: { text: 'Waiting for you: send the reply to Ada?' },
+};
+/**
+ * The paper clip in one state, in the page's corner. `aside` puts a dialog
+ * over it: the real `useKeepClear` steps it aside, and the picture shows the
+ * dialog alone.
+ */
+export function AssistantScreen({ picture, }) {
+    const stageRef = useRef(null);
+    const state = picture === 'aside' ? 'idle' : picture;
+    const balloon = BALLOONS[picture];
+    return (_jsxs(Box, { sx: { flex: 1, position: 'relative' }, children: [picture === 'aside' && (_jsxs(Box, { role: "dialog", "aria-label": "A dialog over the assistant", sx: {
+                    position: 'fixed',
+                    right: 24,
+                    bottom: 24,
+                    width: 280,
+                    height: 160,
+                    p: 3,
+                    zIndex: 2000,
+                    bg: 'canvas.overlay',
+                    border: 'var(--theme-hairline, 1px) solid',
+                    borderColor: 'border.default',
+                    borderRadius: 'var(--theme-radius-card, 6px)',
+                    boxShadow: 'var(--theme-shadow, none)',
+                }, children: [_jsx(Text, { sx: { fontWeight: 600 }, children: "A dialog" }), _jsx(Text, { as: "p", sx: { color: 'fg.muted', fontSize: 1 }, children: "The assistant steps aside while this is open." })] })), _jsx(AssistantStage, { character: "paperclip", state: state, place: { right: 48, bottom: 48 }, stageRef: stageRef, onDragStart: () => undefined, open: false, onToggle: () => undefined, balloon: balloon, insist: !!balloon, onDismiss: () => undefined })] }));
+}
+// ---------------------------------------------------------------------------
+// The characters (T-25, T-24)
+// ---------------------------------------------------------------------------
+/** Datalayer's characters and the example plugin's owl, as contributed. */
+const characterReactor = buildReactorFromPlugins([
+    AssistantCharactersPlugin,
+    OwlCharacterPlugin,
+]);
+characterReactor.start();
+/**
+ * One character idle in the page's corner, read from what the enabled
+ * plugins contribute; `ready` is drawn with it.
+ */
+export function CharacterScreen({ character, ready, }) {
+    const stageRef = useRef(null);
+    const drawn = assistantCharacterNamed(characterReactor, character);
+    return (_jsxs(Box, { sx: { flex: 1, position: 'relative' }, children: [_jsx(AssistantStage, { character: drawn, state: "idle", place: { right: 48, bottom: 48 }, stageRef: stageRef, onDragStart: () => undefined, open: false, onToggle: () => undefined, onDismiss: () => undefined }), ready] }));
+}

package/lib/stories/loop/pictures-main.d.ts

@@ -0,0 +1,2 @@
+import '../../../style/primer-primitives.css';
+import '@datalayer/primer-addons/style/loop-face.css';

package/lib/stories/loop/pictures-main.js

@@ -0,0 +1,75 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * The page the pictures are taken of (LOOP T-16): one reference screen, or
+ * one state of the floating assistant, in one theme and one mode, chosen by
+ * the address — `html/pictures.html?screen=approval&theme=loop&mode=dark`,
+ * or `?assistant=thinking&mode=light`, or a character idle,
+ * `?character=wizard&mode=dark` (Datalayer's, or the owl a plugin contributes).
+ *
+ * It sets `data-pictures-ready` on the document once the fonts are in — Inter
+ * in its two weights, served by this page (T-04) — and two frames have
+ * painted, which is what the capture waits for.
+ *
+ * @module stories/loop/pictures-main
+ */
+const globals = globalThis;
+if (globals['__webpack_public_path__'] === undefined) {
+    globals['__webpack_public_path__'] = '';
+}
+import { useEffect } from 'react';
+import { createRoot } from 'react-dom/client';
+import { ASSISTANT_PICTURES, AssistantScreen, CHARACTER_PICTURES, CharacterScreen, REFERENCE_SCREEN_COMPONENTS, REFERENCE_SCREENS, REFERENCE_THEMES, ReferenceTheme, } from './ReferenceScreens';
+import '../../../style/primer-primitives.css';
+// The `loop` theme's face (LOOP T-04): Inter and its metric-matched fallback,
+// served by this page's own Vite, as the landing serves them from its build.
+import '@datalayer/primer-addons/style/loop-face.css';
+const params = new URLSearchParams(window.location.search);
+const theme = (REFERENCE_THEMES.includes(params.get('theme'))
+    ? params.get('theme')
+    : 'loop');
+const mode = params.get('mode') === 'dark' ? 'dark' : 'light';
+const screen = params.get('screen');
+const assistant = params.get('assistant');
+const character = params.get('character');
+function Ready() {
+    useEffect(() => {
+        let cancelled = false;
+        // Inter is fetched only once text asks for it: ask for both weights, so
+        // that the picture is never taken in the fallback.
+        void Promise.all([
+            document.fonts.load('400 14px "Inter Variable"'),
+            document.fonts.load('600 14px "Inter Variable"'),
+        ])
+            .then(() => document.fonts.ready)
+            .then(() => {
+            requestAnimationFrame(() => requestAnimationFrame(() => {
+                if (!cancelled) {
+                    document.documentElement.setAttribute('data-pictures-ready', '');
+                }
+            }));
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, []);
+    return null;
+}
+function Page() {
+    if (character && CHARACTER_PICTURES.includes(character)) {
+        return (_jsx(ReferenceTheme, { theme: theme, mode: mode, children: _jsx(CharacterScreen, { character: character, ready: _jsx(Ready, {}) }) }));
+    }
+    if (assistant && ASSISTANT_PICTURES.includes(assistant)) {
+        return (_jsxs(ReferenceTheme, { theme: theme, mode: mode, children: [_jsx(AssistantScreen, { picture: assistant }), _jsx(Ready, {})] }));
+    }
+    const name = screen && REFERENCE_SCREENS.includes(screen) ? screen : 'conversation';
+    const Screen = REFERENCE_SCREEN_COMPONENTS[name];
+    return (_jsxs(ReferenceTheme, { theme: theme, mode: mode, children: [_jsx(Screen, {}), _jsx(Ready, {})] }));
+}
+const container = document.getElementById('root');
+if (container) {
+    createRoot(container).render(_jsx(Page, {}));
+}

package/lib/types/agentspecs.d.ts

@@ -476,6 +476,11 @@ export interface AppRecordSpec {
     keepFor: string;
     retentionDays: number;
     include: string[];
+    /**
+     * Whether its conversations may be used to suggest tests (LOOP V-16): off
+     * unless said, and only those kept while it is on are sampled.
+     */
+    suggestTests: boolean;
 }
 /** Optional checks from the catalogue. */
 export interface AppChecksSpec {
@@ -522,7 +527,7 @@ export interface AppDecisionSpec {
     criteria: AppCriterionSpec[];
     minConfidence: number;
     scenarios: AppScenarioSpec[];
-    judgmentModel: string;
+    decisionModel: string;
 }
 /**
  * An application (`agentspecs/apps`): the Appspec. An agent with an interface,

package/lib/types/chat.d.ts

@@ -653,6 +653,11 @@ export interface ChatBaseProps {
         stop: () => void;
         /** Start the conversation over — what the header's + does. */
         newChat: () => void;
+        /**
+         * The conversation the next message goes to, as the runtime knows it
+         * (AG-UI's thread): what an application's record keeps it under.
+         */
+        thread: () => string;
     } | null) => void;
     /**
      * Reports whether the chat is streaming a reply, so a host that owns the