@datalayer/agent-runtimes 1.3.40 → 1.3.43

package/lib/loop/plugins/app-rules/index.js

@@ -0,0 +1,31 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { definePlugin } from '@datalayer/reactor';
+import { LoopSlots } from '../../core';
+import { AppRulesCard } from './AppRulesCard';
+export const APP_RULES_PLUGIN_NAME = '@datalayer/loop-plugin-app-rules';
+/** The plugin that lists an application's rules and the approvals waiting for the person. */
+export function defineAppRulesPlugin(app) {
+    // One component per plugin: the slot keeps it, and the application with it.
+    function Card() {
+        return _jsx(AppRulesCard, { app: app });
+    }
+    const plugin = definePlugin({
+        name: `${APP_RULES_PLUGIN_NAME}-${app.id}`,
+        displayName: `${app.name}: rules and approvals`,
+        description: `When ${app.name} acts alone, when it asks, and what waits for your yes.`,
+        octicon: 'shield-check',
+        build: () => ({
+            components: [
+                {
+                    id: 'app-rules',
+                    slot: LoopSlots.sidebar,
+                    order: 10,
+                    Component: Card,
+                },
+            ],
+        }),
+    });
+    return plugin;
+}
+export { AppRulesCard, APP_RULES_WORDS, ruleInWords, ruleOfApproval, } from './AppRulesCard';
+export default defineAppRulesPlugin;

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

@@ -43,8 +43,9 @@ import { messageText, 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 { FaceDrawing, PresenceFace, PresenceLine, } from '../../../chat/presence/Presence';
 import { presenceState, presenceToolOf, } from '../../../chat/presence/presenceStatus';
+import { latestSaying, newestIsAnswer, } from '../../../chat/assistant/state';
 /** No editor: the conversation on its own. */
 const NO_SURFACE = '';
 /**
@@ -203,6 +204,14 @@ export default function ChatView({ workspace }) {
     useEffect(() => {
         onPresence?.(presenceNow);
     }, [onPresence, presenceNow]);
+    // What it last said, for a host that says it outside the conversation —
+    // the embed's floating chrome (LOOP R-01): its balloon and its blink.
+    // Through a ref: the handler below is made once.
+    const onSayingRef = useRef(config?.presence?.onSaying);
+    onSayingRef.current = config?.presence?.onSaying;
+    const saidRef = useRef({
+        answering: false,
+    });
     const handleSendReady = useCallback((controls) => {
         controlsRef.current = controls;
         setSendReady(!!controls);
@@ -221,6 +230,17 @@ export default function ChatView({ workspace }) {
         setPresenceTool(previous => previous.open === open && previous.pendingApproval === pendingApproval
             ? previous
             : { open, pendingApproval });
+        const said = {
+            saying: latestSaying(items),
+            answering: newestIsAnswer(items),
+        };
+        const before = saidRef.current;
+        if (before.saying?.id !== said.saying?.id ||
+            before.saying?.text !== said.saying?.text ||
+            before.answering !== said.answering) {
+            saidRef.current = said;
+            onSayingRef.current?.(said);
+        }
         const feed = turnFeedRef.current;
         if (!feed) {
             return;
@@ -1484,7 +1504,7 @@ export default function ChatView({ workspace }) {
                     // The theme it wears, when the host names one (an application's).
                     , { 
                         // The theme it wears, when the host names one (an application's).
-                        themeVariant: config?.themeVariant, themeOverrides: config?.themeOverrides, 
+                        themeVariant: config?.themeVariant, themeOverrides: config?.themeOverrides, colorMode: config?.colorMode, 
                         // The header says why, beside the title, for the same reason the
                         // placeholder does: a dead control with no explanation is worse
                         // than an absent one.
@@ -1525,7 +1545,7 @@ export default function ChatView({ workspace }) {
                         headerContent: presence ? _jsx(PresenceLine, { state: presenceNow }) : undefined, emptyState: {
                             // An application's own face, at the page's size of the three
                             // (LOOP T-08, T-19): the thing a person's eye lands on first.
-                            icon: presence?.face ? (_jsx("span", { "aria-hidden": true, style: { fontSize: FACE_LARGE, lineHeight: 1 }, children: presence.face })) : (_jsx(BrandIcon, { size: 48 })),
+                            icon: presence?.face ? (_jsx("span", { "aria-hidden": true, style: { fontSize: FACE_LARGE, lineHeight: 1 }, children: _jsx(FaceDrawing, { face: presence.face, size: FACE_LARGE }) })) : (_jsx(BrandIcon, { size: 48 })),
                             // `ChatEmptyState` reads its heading from here and nowhere
                             // else — the `title` above reaches the header only — so
                             // without this the agent introduced itself as "Start a

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

@@ -1,4 +1,5 @@
 import type { PresenceState } from '../../../chat/presence/presenceStatus';
+import type { AssistantSaying } from '../../../chat/assistant/state';
 import type { ThemeOverrides } from '../../../types/chat';
 /** What a host may set on the chat. */
 /** Who is answering, as the person meets them. */
@@ -15,7 +16,22 @@ export interface ChatPresence {
      * a state setter.
      */
     onPresence?: (state: PresenceState) => void;
+    /**
+     * Told what it last said, and whether its newest words are an answer, as
+     * they change — for a host that says them outside the conversation, as the
+     * embed's floating chrome does in its balloon and its blink (LOOP R-01).
+     * Read once, when the workspace is built: pass a stable function, such as
+     * a state setter.
+     */
+    onSaying?: (said: ChatSaid) => void;
 }
+/** What the chat last said, as `onSaying` tells it. */
+export type ChatSaid = {
+    /** The newest words of the agent, cut for a balloon. */
+    saying?: AssistantSaying;
+    /** Whether the newest item of the conversation is the agent's answer. */
+    answering: boolean;
+};
 export type ChatPluginConfig = {
     /**
      * The theme the conversation wears, by name: the person's unless said. An
@@ -28,6 +44,13 @@ export type ChatPluginConfig = {
      * that its bubbles and its one button wear its colour and not the theme's.
      */
     themeOverrides?: ThemeOverrides;
+    /**
+     * The mode the conversation is drawn in, when its host decides it — an
+     * embed in another product's page, whose mode is the host's or its
+     * visitor's system's, not the person's Datalayer setting. The person's
+     * unless said.
+     */
+    colorMode?: 'light' | 'dark';
     /**
      * Who is answering, as the person meets them (LOOP T-08): a name, a face
      * and a welcome, in place of the agent's id and a generic icon. An

package/lib/loop/presets.d.ts

@@ -143,6 +143,8 @@ export type LoopPresetOptions = {
     themeVariant?: string;
     /** Laid over that theme, by mode: an application's accent (LOOP T-05). */
     themeOverrides?: ThemeOverrides;
+    /** The mode the conversation is drawn in, when the host decides it; the person's unless said. */
+    colorMode?: 'light' | 'dark';
     /** Who is answering, as the person meets them (LOOP T-08). */
     presence?: ChatPresence;
     /** Whether the counters are shown under the prompt; on unless said. */

package/lib/loop/presets.js

@@ -52,7 +52,7 @@ import { LoopPageLayoutPlugin } from './plugins/page-layout';
  * be installed or signed into, and the switches a demonstration wants are off.
  */
 export function loopPlugins(options = {}) {
-    const { serverUrl, target = 'browser', defaultEditor: askedEditor, showViewSelector = true, hideChatHeader = false, chatHeaderButtons = false, promptPlacement, autoFocusPrompt = true, suggestionLabels = true, fullScreenTopOffset = 0, showAgentVariants = false, agentSummary = true, teamId, teamPicker = true, pageLayout = false, pageLayoutArrangement = 'page', pageLayoutTurnPanel = 'below', pageLayoutPrompt = 'docked', pageLayoutPromptAnchor = 'top', pageLayoutSize, pageLayoutTurnPanelFooter = 'full', localAgent, localAgentSpec, datalayerAgentSpecId, datalayerCreatePayload, targetFixed, themeVariant, themeOverrides, presence, showTokenUsage, floatingPrompt = false, editorSelector = false, editors = true, conversation = true, graph = false, commandPalette = false, pluginsPanel = false, windowFrame = false, firstPromptHook, } = options;
+    const { serverUrl, target = 'browser', defaultEditor: askedEditor, showViewSelector = true, hideChatHeader = false, chatHeaderButtons = false, promptPlacement, autoFocusPrompt = true, suggestionLabels = true, fullScreenTopOffset = 0, showAgentVariants = false, agentSummary = true, teamId, teamPicker = true, pageLayout = false, pageLayoutArrangement = 'page', pageLayoutTurnPanel = 'below', pageLayoutPrompt = 'docked', pageLayoutPromptAnchor = 'top', pageLayoutSize, pageLayoutTurnPanelFooter = 'full', localAgent, localAgentSpec, datalayerAgentSpecId, datalayerCreatePayload, targetFixed, themeVariant, themeOverrides, colorMode, presence, showTokenUsage, floatingPrompt = false, editorSelector = false, editors = true, conversation = true, graph = false, commandPalette = false, pluginsPanel = false, windowFrame = false, firstPromptHook, } = options;
     const defaultEditor = askedEditor ?? (editors ? 'notebook' : 'none');
     // A workspace without a conversation: the theme, the shell's points, and
     // the host's chrome; its view is a host's plugin's.
@@ -86,6 +86,7 @@ export function loopPlugins(options = {}) {
             fullScreenTopOffset,
             themeVariant,
             themeOverrides,
+            colorMode,
             presence,
             showTokenUsage,
         }),

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datalayer/agent-runtimes",
-    "version": "1.3.40",
+    "version": "1.3.43",
     "type": "module",
     "workspaces": [
         ".",
@@ -145,7 +145,7 @@
         "@ai-sdk/react": "4.0.93",
         "@anthropic-ai/sdk": "^0.52.0",
         "@datalayer/agent-teams": "^1.0.0",
-        "@datalayer/core": "^1.2.12",
+        "@datalayer/core": "^1.2.14",
         "@datalayer/decks": "^1.0.4",
         "@datalayer/icons-react": "^1.0.14",
         "@datalayer/jupyter-lexical": "^2.0.18",