@datalayer/agent-runtimes 1.3.37 → 1.3.39

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

@@ -11,14 +11,70 @@
  * previous turn), `assistant` as the reply arrives, `end` when the agent
  * stops. Readers hold the signal.
  *
+ * Beside the turn, the whole conversation (`conversation`), for a page that
+ * shows it as the Chat component does: the chat view hands it every change
+ * of its items, streaming included.
+ *
  * @module loop/plugins/chat/turnState
  */
 import { signal } from '@datalayer/reactor';
+/** A message's words, whether its content is a string or parts. */
+export function messageText(message) {
+    const content = message.content;
+    return typeof content === 'string'
+        ? content
+        : content
+            .map(part => typeof part === 'string'
+            ? part
+            : (part.text ?? ''))
+            .join('');
+}
+const isToolCall = (item) => item.type === 'tool-call';
+/**
+ * The conversation as a page shows it: each person's and assistant's
+ * message with words in it, and each tool call by its name, its arguments
+ * and its result once it has one. A system message is the chat's own and is
+ * left out.
+ */
+export function conversationOf(items) {
+    const entries = [];
+    for (const item of items) {
+        if (isToolCall(item)) {
+            entries.push({
+                role: 'tool',
+                name: item.toolName,
+                args: item.args ?? {},
+                ...(item.result === undefined ? {} : { result: item.result }),
+            });
+            continue;
+        }
+        if (item.role !== 'user' && item.role !== 'assistant') {
+            continue;
+        }
+        const text = messageText(item);
+        if (text.trim()) {
+            entries.push({ role: item.role, text });
+        }
+    }
+    return entries;
+}
+/** Whether two conversations say the same, entry by entry. */
+const sameConversation = (one, other) => one.length === other.length &&
+    one.every((entry, index) => JSON.stringify(entry) === JSON.stringify(other[index]));
 const IDLE = { id: 0, status: 'idle' };
 export function createTurnFeed() {
     const turn = signal(IDLE);
+    const conversation = signal([]);
     return {
         turn,
+        conversation,
+        items: items => {
+            const next = conversationOf(items);
+            // Nothing new: readers do not re-render for an identical conversation.
+            if (!sameConversation(conversation.value, next)) {
+                conversation.value = next;
+            }
+        },
         begin: (user, thread) => {
             // The window's fill carries over: it is the conversation's, not the
             // turn's, and the footer under a fresh turn should not read empty

package/lib/loop/presets.d.ts

@@ -173,6 +173,17 @@ export type LoopPresetOptions = {
      * cells and documents.
      */
     editors?: boolean;
+    /**
+     * Whether the workspace holds a conversation at all.
+     *
+     * True by default. A host whose one view is a page of its own — an
+     * application that answers in its page and has no agent to talk to, a
+     * decision (LOOP R-02) — passes `false`: the chat and its composer, the
+     * agents, the models, the editors and the page layout all stay out, so
+     * that nothing is launched or fetched for a conversation nobody has, and
+     * the workspace opens on the view a host's plugin contributes.
+     */
+    conversation?: boolean;
     /**
      * The editor choice in the workspace header rather than above the chat.
      *

package/lib/loop/presets.js

@@ -52,8 +52,23 @@ 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, 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, 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.
+    if (!conversation) {
+        return [
+            ThemePlugin,
+            configurePlugin(ShellPlugin, {
+                defaultEditor: 'none',
+                showSelector: false,
+            }),
+            ...(graph ? [GraphViewPlugin] : []),
+            ...(commandPalette ? [LoopCommandsPlugin] : []),
+            ...(pluginsPanel ? [PluginsPanelPlugin] : []),
+            ...(windowFrame ? [WindowFramePlugin] : []),
+        ];
+    }
     return [
         // The chat owns the editor beside it, so which one opens is its
         // configuration rather than the workspace's.

package/lib/protocols/AGUIAdapter.d.ts

@@ -83,6 +83,8 @@ export declare class AGUIAdapter extends BaseProtocolAdapter {
             provider: string;
             accessToken: string;
         }>;
+        /** What goes with the run besides the conversation (AG-UI's). */
+        forwardedProps?: Record<string, unknown>;
     }): Promise<void>;
     /**
      * Send tool result back through AG-UI and continue the conversation.

package/lib/protocols/AGUIAdapter.js

@@ -191,7 +191,7 @@ export class AGUIAdapter extends BaseProtocolAdapter {
                 skills: options.skills,
             }),
             context: [],
-            forwardedProps: null,
+            forwardedProps: options?.forwardedProps ?? null,
             // Include model for per-request model override
             ...(options?.model && { model: options.model }),
             // Include identities for tool execution with OAuth tokens

package/lib/types/chat.d.ts

@@ -654,7 +654,8 @@ export interface ChatBaseProps {
      * Called again with `null` when the chat can no longer send.
      */
     onSendReady?: (controls: {
-        send: (message: string) => void;
+        /** Send a message; `forwardedProps` go with its run (AG-UI's). */
+        send: (message: string, forwardedProps?: Record<string, unknown>) => void;
         stop: () => void;
         /** Start the conversation over — what the header's + does. */
         newChat: () => void;

package/lib/types/protocol.d.ts

@@ -142,6 +142,8 @@ export interface ProtocolAdapter {
             provider: string;
             accessToken: string;
         }>;
+        /** What goes with the run besides the conversation (AG-UI's `forwardedProps`). */
+        forwardedProps?: Record<string, unknown>;
     }): Promise<void>;
     /**
      * Send tool execution result back

package/package.json

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