@datalayer/agent-runtimes 1.3.30 → 1.3.33

package/lib/chat/assistant/state.d.ts

@@ -60,3 +60,31 @@ export declare const ASSISTANT_AWAY_KEY = "datalayer-assistant-away";
 export declare function keptAway(): AssistantAway;
 /** Keep the choice where it lasts as long as it says; `none` forgets it. */
 export declare function keepAway(away: AssistantAway): void;
+/** A box on the screen, as `getBoundingClientRect` gives it. */
+export interface ScreenBox {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}
+/**
+ * What the assistant never sits over (T-27): an open dialog or overlay —
+ * Primer's `Dialog`, an `ActionMenu` or `SelectPanel` overlay, a native
+ * `<dialog>` — and the composer of a chat.
+ */
+export declare const ASSISTANT_OBSTACLES: string;
+/** How near the pointer works, in pixels, before the assistant steps aside. */
+export declare const POINTER_ROOM = 24;
+/** How long the pointer stays away before the assistant comes back, in ms. */
+export declare const POINTER_CALM_MS = 1500;
+/** Whether two boxes share any area, the first grown by `margin`. */
+export declare function boxesMeet(a: ScreenBox, b: ScreenBox, margin?: number): boolean;
+/**
+ * Whether the pointer at `point` works where the assistant stands: over it,
+ * or within `POINTER_ROOM` of it — a press beside it is aimed at what it
+ * hides or crowds.
+ */
+export declare function pointerNear(box: ScreenBox, point: {
+    x: number;
+    y: number;
+}, room?: number): boolean;

package/lib/chat/assistant/state.js

@@ -114,3 +114,34 @@ export function keepAway(away) {
         // Without storage the choice holds for the page.
     }
 }
+/**
+ * What the assistant never sits over (T-27): an open dialog or overlay —
+ * Primer's `Dialog`, an `ActionMenu` or `SelectPanel` overlay, a native
+ * `<dialog>` — and the composer of a chat.
+ */
+export const ASSISTANT_OBSTACLES = [
+    '[role="dialog"]',
+    '[role="alertdialog"]',
+    'dialog[open]',
+    '[class*="prc-Overlay-Overlay"]',
+    '[data-chat-composer]',
+].join(', ');
+/** How near the pointer works, in pixels, before the assistant steps aside. */
+export const POINTER_ROOM = 24;
+/** How long the pointer stays away before the assistant comes back, in ms. */
+export const POINTER_CALM_MS = 1500;
+/** Whether two boxes share any area, the first grown by `margin`. */
+export function boxesMeet(a, b, margin = 0) {
+    return (a.left - margin < b.right &&
+        b.left < a.right + margin &&
+        a.top - margin < b.bottom &&
+        b.top < a.bottom + margin);
+}
+/**
+ * Whether the pointer at `point` works where the assistant stands: over it,
+ * or within `POINTER_ROOM` of it — a press beside it is aimed at what it
+ * hides or crowds.
+ */
+export function pointerNear(box, point, room = POINTER_ROOM) {
+    return boxesMeet(box, { left: point.x, top: point.y, right: point.x, bottom: point.y }, room);
+}

package/lib/chat/base/ChatBase.js

@@ -1400,7 +1400,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
              * four are current.
              */
             const catalogued = Object.values(AI_MODEL_CATALOGUE)
-                // A typed-judgment model answers typed questions, not a chat.
+                // A typed-decision model answers typed questions, not a chat.
                 .filter(model => model.available && isChatModel(model))
                 .map(model => ({
                 id: model.id,
@@ -2124,9 +2124,13 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
         const store = useConversationStore.getState();
         const currentlyFetching = store.isFetching(historyScopeId);
         const storedMessages = store.getMessages(historyScopeId);
-        // 1) Fast local hydration for view switches in the same browser session.
+        // 1) Fast local hydration for view switches in the same browser session:
+        // only into an empty conversation. The saved copy holds messages, not
+        // tool calls, and this effect runs again on every change of the socket's
+        // state — put over a live conversation, it erased its tool cards, a
+        // pending approval among them, at the socket's first retry.
         if (storedMessages.length > 0) {
-            setDisplayItems(storedMessages);
+            setDisplayItems(prev => (prev.length > 0 ? prev : storedMessages));
             setHistoryLoaded(true);
         }
         if (currentlyFetching) {
@@ -2384,16 +2388,24 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
                         const incomingId = event.message.id;
                         const currentId = currentAssistantMessageRef.current?.id;
                         const isNewMessage = !currentId || (incomingId && incomingId !== currentId);
-                        if (currentAssistantMessageRef.current && !isNewMessage) {
+                        if (currentId && !isNewMessage) {
+                            /*
+                             * The message to write to is the one current now, as the event
+                             * arrives — not whichever the ref names when React gets round
+                             * to running the updater. A whole answer in one network chunk
+                             * queues every delta's updater in the same task, and the turn's
+                             * end clears the ref before any of them runs: read lazily, all
+                             * but the first found nothing to update, and the conversation
+                             * and the balloon showed only the answer's first word.
+                             */
+                            const rawContent = event.message.content;
+                            const sanitizedContent = typeof rawContent === 'string'
+                                ? sanitizeAssistantContent(rawContent)
+                                : (rawContent ?? '');
                             setDisplayItems(prev => {
                                 const newItems = [...prev];
-                                const idx = newItems.findIndex(item => !isToolCallMessage(item) &&
-                                    item.id === currentAssistantMessageRef.current?.id);
+                                const idx = newItems.findIndex(item => !isToolCallMessage(item) && item.id === currentId);
                                 if (idx >= 0 && !isToolCallMessage(newItems[idx])) {
-                                    const rawContent = event.message?.content;
-                                    const sanitizedContent = typeof rawContent === 'string'
-                                        ? sanitizeAssistantContent(rawContent)
-                                        : (rawContent ?? '');
                                     newItems[idx] = {
                                         ...newItems[idx],
                                         content: sanitizedContent,
@@ -2401,14 +2413,8 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
                                 }
                                 return newItems;
                             });
-                            if (useStoreMode && currentAssistantMessageRef.current) {
-                                const rawContent = event.message?.content;
-                                const sanitizedContent = typeof rawContent === 'string'
-                                    ? sanitizeAssistantContent(rawContent)
-                                    : (rawContent ?? '');
-                                useChatStore
-                                    .getState()
-                                    .updateMessage(currentAssistantMessageRef.current.id, {
+                            if (useStoreMode) {
+                                useChatStore.getState().updateMessage(currentId, {
                                     content: sanitizedContent,
                                 });
                             }
@@ -3096,6 +3102,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
             // The same reset the header's + performs, for a host whose controls
             // live outside this component — the LOOP prompt's + reaches it here.
             newChat: handleNewChat,
+            thread: () => threadIdRef.current,
         });
         return () => {
             onSendReady(null);
@@ -3490,7 +3497,15 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
         promptHistory: configQuery.data?.promptHistory, showTokenUsage: showTokenUsage, showContextRing: showContextRing, agentUsage: agentUsage, showModelSelector: showModelSelector, showToolsMenu: showToolsMenu, showSkillsMenu: showSkillsMenu, codemodeEnabled: codemodeEnabled, onToggleCodemode: onToggleCodemode, isA2AProtocol: isA2AProtocol, showAgentsMenu: showAgentsMenu, agents: footerAgents, selectedAgentId: selectedAgentId ?? footerAgents[0]?.id, onSelectAgent: onSelectAgent, hasConfigData: !!configQuery.data, hasSkillsData: !!skillsQuery.data, 
         // So the bar can tell "not here yet" from "not coming": a chat whose
         // agent has no config endpoint waits for ever otherwise.
-        configLoading: configQuery.isLoading, models: offeredModels, selectedModel: selectedModel, onModelSelect: setSelectedModel, availableTools: builtinTools, mcpServers: filteredMcpServers, enabledMcpTools: enabledMcpTools, enabledMcpToolCount: getEnabledMcpToolNames().length, onToggleMcpTool: toggleMcpTool, onToggleAllMcpServerTools: toggleAllMcpServerTools, approvedMcpTools: approvedMcpTools, onToggleMcpToolApproval: toggleMcpToolApproval, skills: skillsQuery.data?.skills || [], skillsLoading: !!skillsQuery.isLoading, enabledSkills: enabledSkills, onToggleSkill: toggleSkill, onToggleAllSkills: toggleAllSkills, approvedSkills: approvedSkills, onToggleSkillApproval: toggleSkillApproval, apiBase: indicatorApiBase, authToken: protocol?.authToken, mcpStatusData: effectiveMcpStatusData })) : null;
+        configLoading: configQuery.isLoading, models: offeredModels, 
+        // Listed apart and read-only: a typed-decision model is never the
+        // agent's model.
+        decisions: configQuery.data
+            ? {
+                models: configQuery.data.decisionModels,
+                note: configQuery.data.decisionsNote,
+            }
+            : undefined, selectedModel: selectedModel, onModelSelect: setSelectedModel, availableTools: builtinTools, mcpServers: filteredMcpServers, enabledMcpTools: enabledMcpTools, enabledMcpToolCount: getEnabledMcpToolNames().length, onToggleMcpTool: toggleMcpTool, onToggleAllMcpServerTools: toggleAllMcpServerTools, approvedMcpTools: approvedMcpTools, onToggleMcpToolApproval: toggleMcpToolApproval, skills: skillsQuery.data?.skills || [], skillsLoading: !!skillsQuery.isLoading, enabledSkills: enabledSkills, onToggleSkill: toggleSkill, onToggleAllSkills: toggleAllSkills, approvedSkills: approvedSkills, onToggleSkillApproval: toggleSkillApproval, apiBase: indicatorApiBase, authToken: protocol?.authToken, mcpStatusData: effectiveMcpStatusData })) : null;
     // Shared header element. It is rendered either at the top of the chat (when
     // no ephemeral notebook is shown) or INSIDE the chat body column (when the
     // notebook is visible) so the header always follows the chat body across all

package/lib/chat/base/modelChoice.d.ts

@@ -57,9 +57,28 @@ export type ServerCatalogueModel = {
     name?: string;
     available?: boolean;
     missing_env_vars?: string[];
-    reason?: string;
+    reason?: string | null;
     warning?: string | null;
 };
+/**
+ * The typed-decision models a runtime lists apart (Jev).
+ *
+ * They answer a decision's typed questions, not a conversation: the menu
+ * shows them read-only, under their own heading, with `note` saying so, and
+ * never offers one as the agent's model.
+ */
+export type Decisions = {
+    models: ModelConfig[];
+    note: string;
+};
+/** The runtime's `/configure/models` answer, as far as the chat reads it. */
+export type ServerCatalogue = {
+    models?: ServerCatalogueModel[];
+    source?: string;
+    note?: string;
+    decision_models: ServerCatalogueModel[];
+    decisions_note: string;
+};
 /**
  * The server's catalogue in the chat's shape.
  *
@@ -73,3 +92,10 @@ export declare function readServerCatalogue(payload: {
     source?: string;
     note?: string;
 } | null | undefined): ModelConfig[];
+/**
+ * The typed-decision models of the runtime's answer, in the chat's shape.
+ *
+ * Read apart from `readServerCatalogue`, so no list a chat picks its model
+ * from ever holds one.
+ */
+export declare function readServerDecisions(payload: ServerCatalogue): Decisions;

package/lib/chat/base/modelChoice.js

@@ -51,19 +51,33 @@ export function initialModelId(offered, preferred) {
  * its spec was known went to the first row — Alibaba, and its missing key.
  */
 export function readServerCatalogue(payload) {
-    return (payload?.models ?? []).map(model => {
-        const missing = model.missing_env_vars ?? [];
-        const reason = model.reason ??
-            (missing.length > 0 ? `Set ${missing.join(', ')}` : undefined) ??
-            model.warning ??
-            undefined;
-        return {
-            id: model.id,
-            name: model.name ?? model.id,
-            isAvailable: model.available !== false,
-            ...(reason && model.available === false
-                ? { unavailableReason: reason }
-                : {}),
-        };
-    });
+    return (payload?.models ?? []).map(readServerModel);
+}
+/**
+ * The typed-decision models of the runtime's answer, in the chat's shape.
+ *
+ * Read apart from `readServerCatalogue`, so no list a chat picks its model
+ * from ever holds one.
+ */
+export function readServerDecisions(payload) {
+    return {
+        models: payload.decision_models.map(readServerModel),
+        note: payload.decisions_note,
+    };
+}
+/** One row of the runtime's answer, in the chat's shape. */
+function readServerModel(model) {
+    const missing = model.missing_env_vars ?? [];
+    const reason = model.reason ??
+        (missing.length > 0 ? `Set ${missing.join(', ')}` : undefined) ??
+        model.warning ??
+        undefined;
+    return {
+        id: model.id,
+        name: model.name ?? model.id,
+        isAvailable: model.available !== false,
+        ...(reason && model.available === false
+            ? { unavailableReason: reason }
+            : {}),
+    };
 }

package/lib/chat/prompt/InputPrompt.d.ts

@@ -16,6 +16,7 @@ import type { PromptSuggestion } from './menus/SuggestionsMenu';
 import type { MentionableAgent } from './plugins/AgentMentionPlugin';
 /** One agent the footer may offer. */
 import type { FooterAgent } from '../../types/chat';
+import type { Decisions } from '../base/modelChoice';
 export type { FooterAgent };
 /** Where the prompt stands: in the flow, or in a draggable card over it. */
 export type InputPromptPlacement = 'docked' | 'floating';
@@ -187,6 +188,11 @@ export interface InputPromptProps {
      */
     configLoading?: boolean;
     models?: ModelConfig[];
+    /**
+     * The typed-decision models the runtime lists apart (Jev): shown read-only
+     * under the models, never one to pick. See `modelChoice`'s `Decisions`.
+     */
+    decisions?: Decisions;
     selectedModel?: string;
     onModelSelect?: (modelId: string) => void;
     availableTools?: BuiltinTool[];
@@ -214,4 +220,4 @@ export interface InputPromptProps {
     /** Pre-fetched MCP status from WebSocket — bypasses REST polling */
     mcpStatusData?: McpToolsetsStatusResponse | null;
 }
-export declare function InputPrompt({ input, setInput, isLoading, kernelStatus, connectionConfirmed, placeholder, typingSuggestions, autoFocus, focusTrigger, padding, placement, floatingAnchor, draggable, container, footerExtras, leadingPanel, trailingPanel, onSend, onStop, disableInputPrompt, promptVariant, mentionableAgents, promptHistory, headerContent, showAgentsMenu, showInlineAgentsMenu, agents, selectedAgentId, onSelectAgent, showTokenUsage, showContextRing, agentUsage, showModelSelector, showToolsMenu, showSkillsMenu, showSuggestionsMenu, suggestions, codemodeEnabled, onToggleCodemode, isA2AProtocol, hasConfigData, hasSkillsData, configLoading, models, selectedModel, onModelSelect, availableTools, mcpServers, enabledMcpTools, enabledMcpToolCount, onToggleMcpTool, onToggleAllMcpServerTools, approvedMcpTools, onToggleMcpToolApproval, skills, skillsLoading, enabledSkills, onToggleSkill, onToggleAllSkills, approvedSkills, onToggleSkillApproval, apiBase, authToken, mcpStatusData, }: InputPromptProps): import("react").JSX.Element;
+export declare function InputPrompt({ input, setInput, isLoading, kernelStatus, connectionConfirmed, placeholder, typingSuggestions, autoFocus, focusTrigger, padding, placement, floatingAnchor, draggable, container, footerExtras, leadingPanel, trailingPanel, onSend, onStop, disableInputPrompt, promptVariant, mentionableAgents, promptHistory, headerContent, showAgentsMenu, showInlineAgentsMenu, agents, selectedAgentId, onSelectAgent, showTokenUsage, showContextRing, agentUsage, showModelSelector, showToolsMenu, showSkillsMenu, showSuggestionsMenu, suggestions, codemodeEnabled, onToggleCodemode, isA2AProtocol, hasConfigData, hasSkillsData, configLoading, models, decisions, selectedModel, onModelSelect, availableTools, mcpServers, enabledMcpTools, enabledMcpToolCount, onToggleMcpTool, onToggleAllMcpServerTools, approvedMcpTools, onToggleMcpToolApproval, skills, skillsLoading, enabledSkills, onToggleSkill, onToggleAllSkills, approvedSkills, onToggleSkillApproval, apiBase, authToken, mcpStatusData, }: InputPromptProps): import("react").JSX.Element;

package/lib/chat/prompt/InputPrompt.js

@@ -29,7 +29,7 @@ const EMPTY_ID_SET = new Set();
 // ---------------------------------------------------------------------------
 // Component
 // ---------------------------------------------------------------------------
-export function InputPrompt({ input, setInput, isLoading, kernelStatus, connectionConfirmed, placeholder, typingSuggestions, autoFocus, focusTrigger, padding, placement, floatingAnchor = 'bottom', draggable = false, container, footerExtras, leadingPanel, trailingPanel, onSend, onStop, disableInputPrompt = false, promptVariant, mentionableAgents, promptHistory, headerContent, showAgentsMenu = false, showInlineAgentsMenu = true, agents = [], selectedAgentId, onSelectAgent, showTokenUsage, showContextRing = false, agentUsage, showModelSelector, showToolsMenu, showSkillsMenu, showSuggestionsMenu = true, suggestions, codemodeEnabled, onToggleCodemode, isA2AProtocol, hasConfigData, hasSkillsData, configLoading = false, models = [], selectedModel = '', onModelSelect = () => { }, availableTools = [], mcpServers = [], enabledMcpTools = EMPTY_TOOL_MAP, enabledMcpToolCount = 0, onToggleMcpTool = () => { }, onToggleAllMcpServerTools = () => { }, approvedMcpTools = EMPTY_TOOL_MAP, onToggleMcpToolApproval = () => { }, skills = [], skillsLoading = false, enabledSkills = EMPTY_ID_SET, onToggleSkill = () => { }, onToggleAllSkills = () => { }, approvedSkills = EMPTY_ID_SET, onToggleSkillApproval = () => { }, apiBase, authToken, mcpStatusData, }) {
+export function InputPrompt({ input, setInput, isLoading, kernelStatus, connectionConfirmed, placeholder, typingSuggestions, autoFocus, focusTrigger, padding, placement, floatingAnchor = 'bottom', draggable = false, container, footerExtras, leadingPanel, trailingPanel, onSend, onStop, disableInputPrompt = false, promptVariant, mentionableAgents, promptHistory, headerContent, showAgentsMenu = false, showInlineAgentsMenu = true, agents = [], selectedAgentId, onSelectAgent, showTokenUsage, showContextRing = false, agentUsage, showModelSelector, showToolsMenu, showSkillsMenu, showSuggestionsMenu = true, suggestions, codemodeEnabled, onToggleCodemode, isA2AProtocol, hasConfigData, hasSkillsData, configLoading = false, models = [], decisions, selectedModel = '', onModelSelect = () => { }, availableTools = [], mcpServers = [], enabledMcpTools = EMPTY_TOOL_MAP, enabledMcpToolCount = 0, onToggleMcpTool = () => { }, onToggleAllMcpServerTools = () => { }, approvedMcpTools = EMPTY_TOOL_MAP, onToggleMcpToolApproval = () => { }, skills = [], skillsLoading = false, enabledSkills = EMPTY_ID_SET, onToggleSkill = () => { }, onToggleAllSkills = () => { }, approvedSkills = EMPTY_ID_SET, onToggleSkillApproval = () => { }, apiBase, authToken, mcpStatusData, }) {
     const isKernelBusy = kernelStatus === 'busy';
     /*
      * Each menu is offered when it is switched on *and* has something behind it.
@@ -143,7 +143,7 @@ export function InputPrompt({ input, setInput, isLoading, kernelStatus, connecti
                             minHeight: 36,
                             bordered: true,
                             subtle: true,
-                            content: (_jsx(_Fragment, { children: anyOffered || extrasOffered || suggestionsOffered ? (_jsxs(_Fragment, { children: [agentsOffered && (_jsx(AgentsMenu, { agents: agents, selectedAgentId: selectedAgentId, onSelectAgent: onSelectAgent })), toolsOffered && (_jsx(ToolsMenu, { codemodeEnabled: codemodeEnabled, onToggleCodemode: onToggleCodemode, mcpServers: mcpServers, enabledMcpTools: enabledMcpTools, enabledMcpToolCount: enabledMcpToolCount, onToggleMcpTool: onToggleMcpTool, onToggleAllMcpServerTools: onToggleAllMcpServerTools, approvedMcpTools: approvedMcpTools, onToggleMcpToolApproval: onToggleMcpToolApproval, availableTools: availableTools })), skillsOffered && (_jsx(SkillsMenu, { skills: skills, skillsLoading: skillsLoading, enabledSkills: enabledSkills, onToggleSkill: onToggleSkill, onToggleAllSkills: onToggleAllSkills, approvedSkills: approvedSkills, onToggleSkillApproval: onToggleSkillApproval })), modelsOffered && (_jsx(ModelSelector, { models: models, selectedModel: selectedModel, onModelSelect: onModelSelect, isA2AProtocol: isA2AProtocol })), suggestionsOffered && (_jsx(SuggestionsMenu, { suggestions: suggestionItems, onPick: text => {
+                            content: (_jsx(_Fragment, { children: anyOffered || extrasOffered || suggestionsOffered ? (_jsxs(_Fragment, { children: [agentsOffered && (_jsx(AgentsMenu, { agents: agents, selectedAgentId: selectedAgentId, onSelectAgent: onSelectAgent })), toolsOffered && (_jsx(ToolsMenu, { codemodeEnabled: codemodeEnabled, onToggleCodemode: onToggleCodemode, mcpServers: mcpServers, enabledMcpTools: enabledMcpTools, enabledMcpToolCount: enabledMcpToolCount, onToggleMcpTool: onToggleMcpTool, onToggleAllMcpServerTools: onToggleAllMcpServerTools, approvedMcpTools: approvedMcpTools, onToggleMcpToolApproval: onToggleMcpToolApproval, availableTools: availableTools })), skillsOffered && (_jsx(SkillsMenu, { skills: skills, skillsLoading: skillsLoading, enabledSkills: enabledSkills, onToggleSkill: onToggleSkill, onToggleAllSkills: onToggleAllSkills, approvedSkills: approvedSkills, onToggleSkillApproval: onToggleSkillApproval })), modelsOffered && (_jsx(ModelSelector, { models: models, decisions: decisions, selectedModel: selectedModel, onModelSelect: onModelSelect, isA2AProtocol: isA2AProtocol })), suggestionsOffered && (_jsx(SuggestionsMenu, { suggestions: suggestionItems, onPick: text => {
                                                 setInput(text);
                                                 setPickedFocus(n => n + 1);
                                             } })), extrasOffered && (_jsx(Box, { sx: {

package/lib/chat/prompt/InputPromptBase.js

@@ -192,7 +192,7 @@ export function InputPromptBase({ variant = 'lexical', placeholder = 'Ask anythi
             , { 
                 // Named so the turn-end refocus can ask whether the caret is already
                 // somewhere inside this prompt before it reaches for it.
-                ref: containerRef, onFocusCapture: () => {
+                ref: containerRef, "data-chat-composer": "", onFocusCapture: () => {
                     if (selfFocused.current) {
                         selfFocused.current = false;
                         return;

package/lib/chat/prompt/menus/ModelSelector.d.ts

@@ -1,6 +1,18 @@
 import type { ModelConfig } from '../../../types';
-export declare function ModelSelector({ models, selectedModel, onModelSelect, isA2AProtocol, }: {
+import type { Decisions } from '../../base/modelChoice';
+/**
+ * The typed-decision models, read-only under the models.
+ *
+ * A decision asks them through `/decisions`; an agent cannot run on one, so
+ * no row here selects anything. Each says so, in the runtime's sentence, and
+ * why it cannot be used when it cannot — the same rule as the models above.
+ */
+export declare function DecisionsGroup({ decisions }: {
+    decisions: Decisions;
+}): import("react").JSX.Element;
+export declare function ModelSelector({ models, decisions, selectedModel, onModelSelect, isA2AProtocol, }: {
     models: ModelConfig[];
+    decisions?: Decisions;
     selectedModel: string;
     onModelSelect: (modelId: string) => void;
     isA2AProtocol: boolean;

package/lib/chat/prompt/menus/ModelSelector.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 /*
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
@@ -11,7 +11,19 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Text, Button, ActionMenu, ActionList, Tooltip } from '@primer/react';
 import { Box } from '@datalayer/primer-addons';
 import { AiModelIcon } from '@primer/octicons-react';
-export function ModelSelector({ models, selectedModel, onModelSelect, isA2AProtocol, }) {
+/**
+ * The typed-decision models, read-only under the models.
+ *
+ * A decision asks them through `/decisions`; an agent cannot run on one, so
+ * no row here selects anything. Each says so, in the runtime's sentence, and
+ * why it cannot be used when it cannot — the same rule as the models above.
+ */
+export function DecisionsGroup({ decisions }) {
+    return (_jsxs(ActionList.Group, { selectionVariant: false, children: [_jsx(ActionList.GroupHeading, { children: "Decisions" }), decisions.models.map(model => (_jsxs(ActionList.Item, { disabled: true, sx: { color: 'fg.muted' }, children: [model.name, _jsx(ActionList.Description, { variant: "block", children: model.isAvailable === false
+                            ? `${model.unavailableReason ?? 'Not usable here'} · ${decisions.note}`
+                            : decisions.note })] }, model.id)))] }));
+}
+export function ModelSelector({ models, decisions, selectedModel, onModelSelect, isA2AProtocol, }) {
     const active = models.find(model => model.id === selectedModel);
     /*
      * A count, not a name — the same trigger as tools, skills, agents and
@@ -28,7 +40,7 @@ export function ModelSelector({ models, selectedModel, onModelSelect, isA2AProto
             alignItems: 'flex-end',
         }, children: [_jsxs(ActionMenu, { children: [_jsx(ActionMenu.Anchor, { children: _jsx(Tooltip, { text: `Model — ${summary}`, direction: "n", children: _jsx(Button, { type: "button", variant: "invisible", size: "small", "aria-label": `Model — ${summary}`, leadingVisual: AiModelIcon, disabled: isA2AProtocol, sx: isA2AProtocol
                                     ? { opacity: 0.5, cursor: 'not-allowed' }
-                                    : undefined, children: _jsx(Text, { sx: { fontSize: 0 }, children: models.length }) }) }) }), _jsx(ActionMenu.Overlay, { side: "outside-top", align: "end", children: _jsx(ActionList, { selectionVariant: "single", children: models.map(modelItem => (_jsxs(ActionList.Item, { selected: selectedModel === modelItem.id, onSelect: () => onModelSelect(modelItem.id), disabled: modelItem.isAvailable === false || isA2AProtocol, sx: modelItem.isAvailable === false
-                                    ? { color: 'fg.muted' }
-                                    : undefined, children: [modelItem.name, modelItem.isAvailable === false && (_jsx(ActionList.Description, { variant: "block", children: modelItem.unavailableReason ?? 'Missing API key' }))] }, modelItem.id))) }) })] }), isA2AProtocol && (_jsx(Text, { sx: { fontSize: 0, color: 'attention.fg', mt: 1 }, children: "A2A: Model set by agent config" }))] }));
+                                    : undefined, children: _jsx(Text, { sx: { fontSize: 0 }, children: models.length }) }) }) }), _jsx(ActionMenu.Overlay, { side: "outside-top", align: "end", children: _jsxs(ActionList, { selectionVariant: "single", children: [models.map(modelItem => (_jsxs(ActionList.Item, { selected: selectedModel === modelItem.id, onSelect: () => onModelSelect(modelItem.id), disabled: modelItem.isAvailable === false || isA2AProtocol, sx: modelItem.isAvailable === false
+                                        ? { color: 'fg.muted' }
+                                        : undefined, children: [modelItem.name, modelItem.isAvailable === false && (_jsx(ActionList.Description, { variant: "block", children: modelItem.unavailableReason ?? 'Missing API key' }))] }, modelItem.id))), decisions && decisions.models.length > 0 && (_jsxs(_Fragment, { children: [_jsx(ActionList.Divider, {}), _jsx(DecisionsGroup, { decisions: decisions })] }))] }) })] }), isA2AProtocol && (_jsx(Text, { sx: { fontSize: 0, color: 'attention.fg', mt: 1 }, children: "A2A: Model set by agent config" }))] }));
 }

package/lib/chat/useViewportDrag.d.ts

@@ -3,7 +3,15 @@ export type DragPosition = {
     left: number;
     top: number;
 } | null;
-export declare function useViewportDrag(boxRef: React.RefObject<HTMLElement | null>): {
+export interface ViewportDragOptions {
+    /**
+     * Keep the whole box inside the viewport, not only a margin of it: the
+     * floating assistant's character, whose balloon and conversation open
+     * from where it stands (LOOP T-23).
+     */
+    whole?: boolean;
+}
+export declare function useViewportDrag(boxRef: React.RefObject<HTMLElement | null>, { whole }?: ViewportDragOptions): {
     position: DragPosition;
     onHandlePointerDown: (event: React.PointerEvent<HTMLElement>) => void;
     reset: () => void;

package/lib/chat/useViewportDrag.js

@@ -17,7 +17,7 @@
 import { useCallback, useRef, useState } from 'react';
 /** How much of the box must stay inside the viewport. */
 const MARGIN = 24;
-export function useViewportDrag(boxRef) {
+export function useViewportDrag(boxRef, { whole = false } = {}) {
     const [position, setPosition] = useState(null);
     /* Where the pointer took hold, so the box moves by the pointer's delta
        rather than snapping its corner to the cursor. */
@@ -39,8 +39,8 @@ export function useViewportDrag(boxRef) {
             if (!grip.current) {
                 return;
             }
-            const left = Math.min(Math.max(moved.clientX - grip.current.dx, MARGIN - rect.width), window.innerWidth - MARGIN);
-            const top = Math.min(Math.max(moved.clientY - grip.current.dy, 0), window.innerHeight - MARGIN);
+            const left = Math.min(Math.max(moved.clientX - grip.current.dx, whole ? 0 : MARGIN - rect.width), window.innerWidth - (whole ? rect.width : MARGIN));
+            const top = Math.min(Math.max(moved.clientY - grip.current.dy, 0), window.innerHeight - (whole ? rect.height : MARGIN));
             setPosition({ left, top });
         };
         const up = () => {
@@ -53,7 +53,7 @@ export function useViewportDrag(boxRef) {
         handle.addEventListener('pointerup', up);
         handle.addEventListener('pointercancel', up);
         event.preventDefault();
-    }, [boxRef]);
+    }, [boxRef, whole]);
     /** Back to wherever the box starts: called when the mode changes. */
     const reset = useCallback(() => setPosition(null), []);
     return { position, onHandlePointerDown, reset };

package/lib/components/a2ui/index.d.ts

@@ -1,3 +1,5 @@
 export * from './A2uiMarkdownProvider';
 export * from './A2uiSurfaceComposed';
 export * from './styles';
+export * from './visibleWhen';
+export * from './visibility';

package/lib/components/a2ui/index.js

@@ -5,3 +5,5 @@
 export * from './A2uiMarkdownProvider';
 export * from './A2uiSurfaceComposed';
 export * from './styles';
+export * from './visibleWhen';
+export * from './visibility';

package/lib/components/a2ui/visibility.d.ts

@@ -0,0 +1,15 @@
+/**
+ * What `visible_when` is, without the renderer: the key and the rule, for
+ * whatever writes or checks a surface (the Studio's Canvas) as well as for
+ * what draws it (`visibleWhen`).
+ *
+ * @module components/a2ui/visibility
+ */
+/** The key any block may carry to be shown only under a condition. */
+export declare const VISIBLE_WHEN = "visible_when";
+/**
+ * Whether a block whose condition resolved to `value` is shown: `true`, or a
+ * value that is not empty. `false`, `''`, `0`, `null`, an empty list, or
+ * nothing published at the path yet hide it.
+ */
+export declare function isShown(value: unknown): boolean;

package/lib/components/a2ui/visibility.js

@@ -0,0 +1,24 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * What `visible_when` is, without the renderer: the key and the rule, for
+ * whatever writes or checks a surface (the Studio's Canvas) as well as for
+ * what draws it (`visibleWhen`).
+ *
+ * @module components/a2ui/visibility
+ */
+/** The key any block may carry to be shown only under a condition. */
+export const VISIBLE_WHEN = 'visible_when';
+/**
+ * Whether a block whose condition resolved to `value` is shown: `true`, or a
+ * value that is not empty. `false`, `''`, `0`, `null`, an empty list, or
+ * nothing published at the path yet hide it.
+ */
+export function isShown(value) {
+    if (Array.isArray(value)) {
+        return value.length > 0;
+    }
+    return Boolean(value);
+}

package/lib/components/a2ui/visibleWhen.d.ts

@@ -0,0 +1,17 @@
+import { type ReactComponentImplementation } from '@a2ui/react/v0_9';
+import { Catalog } from '@a2ui/web_core/v0_9';
+/**
+ * Whether a node's resolved properties let it be drawn: no condition, or one
+ * that holds. A2UI resolves a dynamic property to a binding whether the block
+ * gave it or not; a path's is writable, and its value may be nothing yet,
+ * which hides the block. A literal or a function call that resolved to
+ * nothing is a block without a condition.
+ */
+export declare function nodeIsShown(props: Record<string, unknown>): boolean;
+/** A component, its schema declaring `visible_when`, drawn behind the guard. */
+export declare function withVisibleWhen(component: ReactComponentImplementation): ReactComponentImplementation;
+/**
+ * The catalog Datalayer's renderer draws from: A2UI's basic catalog, under
+ * its own id — the payloads name it — with `visible_when` on every component.
+ */
+export declare const datalayerCatalog: Catalog<ReactComponentImplementation, import("@a2ui/web_core/v0_9").FunctionImplementation>;

package/lib/components/a2ui/visibleWhen.js

@@ -0,0 +1,54 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { basicCatalog, useSignalValue, } from '@a2ui/react/v0_9';
+import { Catalog, DynamicBooleanSchema, ResolvedBinding, isWritable, } from '@a2ui/web_core/v0_9';
+import { VISIBLE_WHEN, isShown } from './visibility';
+/**
+ * Whether a node's resolved properties let it be drawn: no condition, or one
+ * that holds. A2UI resolves a dynamic property to a binding whether the block
+ * gave it or not; a path's is writable, and its value may be nothing yet,
+ * which hides the block. A literal or a function call that resolved to
+ * nothing is a block without a condition.
+ */
+export function nodeIsShown(props) {
+    const condition = props[VISIBLE_WHEN];
+    if (!(condition instanceof ResolvedBinding)) {
+        throw new Error(`${VISIBLE_WHEN} resolved to ${String(condition)}, not a binding: the catalog's schema does not declare it.`);
+    }
+    if (isWritable(condition)) {
+        return isShown(condition.value);
+    }
+    return condition.value === undefined || isShown(condition.value);
+}
+const VISIBLE_WHEN_SCHEMA = DynamicBooleanSchema.describe('REF:#/$defs/DynamicBoolean|Datalayer: the block is shown only while this is true or not empty — a path the application publishes.').optional();
+/** A component, its schema declaring `visible_when`, drawn behind the guard. */
+export function withVisibleWhen(component) {
+    const View = component.view;
+    if (!View) {
+        throw new Error(`${component.name} has no node view: visible_when is read from the node, and A2uiSurface draws through it.`);
+    }
+    // A zod object: what every basic component's schema is.
+    const schema = component.schema;
+    if (!schema.shape || typeof schema.extend !== 'function') {
+        throw new Error(`${component.name}'s schema is not an object: visible_when cannot be declared on it.`);
+    }
+    if (VISIBLE_WHEN in schema.shape) {
+        throw new Error(`${component.name} already declares ${VISIBLE_WHEN}.`);
+    }
+    const Guarded = ({ node, buildChild }) => {
+        const props = useSignalValue(node.props);
+        return nodeIsShown(props) ? (_jsx(View, { node: node, buildChild: buildChild })) : null;
+    };
+    Guarded.displayName = `${component.name}.visibleWhen`;
+    return {
+        ...component,
+        schema: schema.extend({ [VISIBLE_WHEN]: VISIBLE_WHEN_SCHEMA }),
+        // A2uiSurface draws through the view; `render` is only its fallback for
+        // a component without one, which this one is not.
+        view: Guarded,
+    };
+}
+/**
+ * The catalog Datalayer's renderer draws from: A2UI's basic catalog, under
+ * its own id — the payloads name it — with `visible_when` on every component.
+ */
+export const datalayerCatalog = new Catalog(basicCatalog.id, basicCatalog.protocolVersion, [...basicCatalog.components.values()].map(withVisibleWhen), [...basicCatalog.functions.values()], basicCatalog.themeSchema, basicCatalog.instructions);

package/lib/examples/ChatAssistantExample.d.ts

@@ -2,6 +2,10 @@
  * The floating assistant (LOOP T-21 to T-27): the chat as a character on the
  * page, after the Office Assistant — Datalayer's own characters, chosen
  * here, acting out what the agent does and speaking in a balloon.
+ *
+ * The characters offered are what the enabled plugins contribute to
+ * `loop.assistant.character` (T-24): Datalayer's four, and an owl from a
+ * small example plugin (`utils/owlCharacterPlugin`).
  */
 import React from 'react';
 declare const ChatAssistantExample: React.FC;