@datalayer/agent-runtimes 1.3.27 → 1.3.29

package/lib/loop/core/index.js

@@ -141,6 +141,7 @@ export const LoopChatComposer = defineContributionPoint('loop.chat.composer');
 export const LoopChatHeader = defineContributionPoint('loop.chat.header');
 export const LoopAgentBlueprint = defineContributionPoint('loop.agent.blueprint');
 export const LoopChatSuggestion = defineContributionPoint('loop.chat.suggestion');
+export const LoopAssistantCharacter = defineContributionPoint('loop.assistant.character');
 export const LoopChatExtras = defineContributionPoint('loop.chat.extras');
 export const LoopOpeningNotebook = defineContributionPoint('loop.notebook.opening');
 export const LoopOpeningDocument = defineContributionPoint('loop.document.opening');

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

@@ -0,0 +1,30 @@
+/**
+ * Datalayer's own characters for the floating assistant, contributed
+ * (LOOP T-24, T-25): the paper clip, the wizard, the cat and the L👀P eyes.
+ * Disabled, they leave the catalogue; another plugin may contribute others.
+ *
+ * @module loop/plugins/assistant-characters
+ */
+import { type ReactorPlugin } from '@datalayer/reactor';
+import { type AssistantCharacter } from '../../../chat/assistant/characters';
+import type { AssistantCharacterData } from '../../../chat/assistant/formats/types';
+import { LoopAssistantCharacter, type AssistantCharacterContribution } from '../../core';
+/** What is read of a reactor here: its contributions to the point. */
+type ContributionsReader = {
+    getContributions: (point: typeof LoopAssistantCharacter) => ReadonlyArray<{
+        value: AssistantCharacterContribution;
+    }>;
+};
+export declare const ASSISTANT_CHARACTERS_PLUGIN_NAME = "@datalayer/loop-plugin-assistant-characters";
+export declare const AssistantCharactersPlugin: ReactorPlugin<Record<string, never>, unknown, unknown>;
+/** The characters the enabled plugins contribute, in contribution order. */
+export declare function assistantCharactersOf(reactor: ContributionsReader): {
+    id: string;
+    character: AssistantCharacter | AssistantCharacterData;
+}[];
+/**
+ * The character an application names, from what is contributed; an id no
+ * enabled plugin contributes is an error that says which ids there are.
+ */
+export declare function assistantCharacterNamed(reactor: ContributionsReader, id: string): AssistantCharacter | AssistantCharacterData;
+export default AssistantCharactersPlugin;

package/lib/loop/plugins/assistant-characters/index.js

@@ -0,0 +1,41 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * Datalayer's own characters for the floating assistant, contributed
+ * (LOOP T-24, T-25): the paper clip, the wizard, the cat and the L👀P eyes.
+ * Disabled, they leave the catalogue; another plugin may contribute others.
+ *
+ * @module loop/plugins/assistant-characters
+ */
+import { contribution, definePlugin, } from '@datalayer/reactor';
+import { ASSISTANT_CHARACTERS, } from '../../../chat/assistant/characters';
+import { LoopAssistantCharacter, } from '../../core';
+export const ASSISTANT_CHARACTERS_PLUGIN_NAME = '@datalayer/loop-plugin-assistant-characters';
+export const AssistantCharactersPlugin = definePlugin({
+    name: ASSISTANT_CHARACTERS_PLUGIN_NAME,
+    displayName: 'Assistant characters',
+    description: "Datalayer's own characters for the floating assistant: a paper clip, a wizard, a cat and the L👀P eyes.",
+    octicon: 'paperclip',
+    contributes: ASSISTANT_CHARACTERS.map(character => contribution(LoopAssistantCharacter, { id: character.id, character }, { id: character.id })),
+});
+/** The characters the enabled plugins contribute, in contribution order. */
+export function assistantCharactersOf(reactor) {
+    return reactor
+        .getContributions(LoopAssistantCharacter)
+        .map(entry => entry.value);
+}
+/**
+ * The character an application names, from what is contributed; an id no
+ * enabled plugin contributes is an error that says which ids there are.
+ */
+export function assistantCharacterNamed(reactor, id) {
+    const all = assistantCharactersOf(reactor);
+    const found = all.find(entry => entry.id === id);
+    if (!found) {
+        throw new Error(`No enabled plugin contributes the assistant character "${id}"; the characters are ${all.map(entry => entry.id).join(', ') || 'none'}.`);
+    }
+    return found.character;
+}
+export default AssistantCharactersPlugin;

package/lib/loop/plugins/chat/ChatView.js

@@ -43,6 +43,8 @@ import { turnWritersOf } from './turnState';
 import { isInactiveSurfaceContribution, orderToolContributions, toolsForChatView, } from './chatViewTools';
 import { useAgentCommandTools } from '../../../tools/adapters/commands';
 import { NONE_EDITOR, seedEditorChoice, setEditorOptions, } from '../shell/editorChoice';
+import { PresenceFace, PresenceLine } from '../../../chat/presence/Presence';
+import { presenceState, presenceToolOf, } from '../../../chat/presence/presenceStatus';
 /** No editor: the conversation on its own. */
 const NO_SURFACE = '';
 /**
@@ -186,6 +188,16 @@ export default function ChatView({ workspace }) {
      */
     const [busy, setBusy] = useState(false);
     const [sendReady, setSendReady] = useState(false);
+    const [presenceTool, setPresenceTool] = useState({
+        open: false,
+        pendingApproval: false,
+    });
+    const presenceNow = presenceState(busy, presenceTool);
+    const onPresence = config?.presence?.onPresence;
+    // A host drawing the face in a frame of its own is told as it changes.
+    useEffect(() => {
+        onPresence?.(presenceNow);
+    }, [onPresence, presenceNow]);
     const handleSendReady = useCallback((controls) => {
         controlsRef.current = controls;
         setSendReady(!!controls);
@@ -199,6 +211,11 @@ export default function ChatView({ workspace }) {
      * Cleared when nothing is running.
      */
     const handleDisplayItemsChange = useCallback((items) => {
+        // The newest tool call, for an application's line of status (T-08).
+        const { open, pendingApproval } = presenceToolOf(items);
+        setPresenceTool(previous => previous.open === open && previous.pendingApproval === pendingApproval
+            ? previous
+            : { open, pendingApproval });
         const feed = turnFeedRef.current;
         if (!feed) {
             return;
@@ -1436,7 +1453,10 @@ export default function ChatView({ workspace }) {
                         // Big enough to read as the agent's mark rather than as
                         // punctuation before its name, and still short enough not to
                         // set the header's height.
-                        brandIcon: presence?.face ? (_jsx("span", { "aria-hidden": true, style: { fontSize: 20, lineHeight: 1 }, children: presence.face })) : (_jsx(BrandIcon, { size: 20 })), emptyState: {
+                        brandIcon: presence?.face ? (_jsx(PresenceFace, { face: presence.face, size: 20, state: presenceNow })) : (_jsx(BrandIcon, { size: 20 })), 
+                        // An application says what it is doing, in plain words, beside
+                        // its name (T-08); an agent's chat keeps its header as it is.
+                        headerContent: presence ? _jsx(PresenceLine, { state: presenceNow }) : undefined, emptyState: {
                             // An application's own face, large: the thing a person's eye
                             // lands on first (LOOP T-08).
                             icon: presence?.face ? (_jsx("span", { "aria-hidden": true, style: { fontSize: 48, lineHeight: 1 }, children: presence.face })) : (_jsx(BrandIcon, { size: 48 })),

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

@@ -1,3 +1,4 @@
+import type { PresenceState } from '../../../chat/presence/presenceStatus';
 /** What a host may set on the chat. */
 /** Who is answering, as the person meets them. */
 export interface ChatPresence {
@@ -6,6 +7,13 @@ export interface ChatPresence {
     face?: string;
     /** What it says before anyone writes. */
     welcome?: string;
+    /**
+     * Told what it is doing as it changes — idle, thinking, working, waiting
+     * for you — for a host that draws the face itself, in a frame of its own.
+     * Read once, when the workspace is built: pass a stable function, such as
+     * a state setter.
+     */
+    onPresence?: (state: PresenceState) => void;
 }
 export type ChatPluginConfig = {
     /**

package/lib/loop/plugins/page-layout/index.js

@@ -35,6 +35,8 @@ const promptStance = signal('floating-top');
  * page layout to a page, the assumption that signal already makes.
  */
 let floatingStance = 'floating-top';
+/** The modes the page layout does not place. */
+const PAGE_LAYOUT_DISABLED_MODES = ['assistant'];
 export function pageLayoutForChatMode(mode) {
     switch (mode) {
         case 'sidebar':
@@ -60,7 +62,9 @@ export function setPageLayoutChatMode(mode) {
 /** The toggle in the floating composer's footer. */
 function ChatModeAction() {
     const mode = useSignalValue(pageLayoutChatMode);
-    return _jsx(ChatViewModeToggle, { value: mode, onChange: setPageLayoutChatMode });
+    // The page layout places the chat itself: the floating assistant, which
+    // ChatFloating draws, is offered greyed out with its reason (T-21).
+    return (_jsx(ChatViewModeToggle, { value: mode, onChange: setPageLayoutChatMode, disabledModes: PAGE_LAYOUT_DISABLED_MODES }));
 }
 /**
  * The chat view's parts on the page layout.

package/lib/specs/actions.js

@@ -439,6 +439,7 @@ export const SERVER_ACTIONS = {
  * to reproduce.
  */
 export const APP_BEHAVIOURS = {
+    'data-quality': {},
     'inbox-triage': {
         'google-workspace.append_table_rows': 'leave_to_me',
         'google-workspace.batch_modify_gmail_message_labels': 'do_it',
@@ -561,8 +562,10 @@ export const APP_BEHAVIOURS = {
         'google-workspace.update_drive_file': 'leave_to_me',
         'google-workspace.update_paragraph_style': 'leave_to_me',
     },
+    'model-choice': {},
     'quote-calculator': {},
     'ship-or-fix': {},
+    'supplier-comparison': {},
     'web-research': {
         'tavily.tavily_crawl': 'do_it',
         'tavily.tavily_extract': 'do_it',
@@ -576,6 +579,7 @@ export const APP_BEHAVIOURS = {
  * application and tool, each condition and the behaviour when it holds.
  */
 export const APP_ESCALATIONS = {
+    'data-quality': {},
     'inbox-triage': {
         'google-workspace.batch_modify_gmail_message_labels': [
             {
@@ -610,7 +614,9 @@ export const APP_ESCALATIONS = {
             },
         ],
     },
+    'model-choice': {},
     'quote-calculator': {},
     'ship-or-fix': {},
+    'supplier-comparison': {},
     'web-research': {},
 };

package/lib/specs/apps.d.ts

@@ -8,9 +8,12 @@
  * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
  */
 import type { AppKind, AppSpec } from '../types/agentspecs';
+export declare const DATA_QUALITY_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 QUOTE_CALCULATOR_APP_0_0_1: AppSpec;
 export declare const SHIP_OR_FIX_APP_0_0_1: AppSpec;
+export declare const SUPPLIER_COMPARISON_APP_0_0_1: AppSpec;
 export declare const WEB_RESEARCH_APP_0_0_1: AppSpec;
 export declare const APP_CATALOGUE: Record<string, AppSpec>;
 /** An application, by `id` or `id:version`, or undefined. */