@datalayer/agent-runtimes 1.3.114 → 1.5.0

package/lib/apps/plugins/app-elements/index.d.ts

@@ -5,10 +5,12 @@
  * code (`session.close`) or by the person. Inline, an element is a message,
  * which the chat draws (P-04); this plugin draws the other two.
  *
- * The chat keeps what is open (`chat/base/loopElement`), from the session
- * API's `loop.element` events; this plugin draws it from the workspace's
- * root slot, positioned against the workspace, so that nothing is laid out
- * while nothing is open.
+ * The chat keeps what is open (`chat/base/loopElement`), from the session's
+ * ui socket (REACTOR_UI RU-3, RU-W); this plugin draws it from the
+ * workspace's root slot, positioned against the workspace, so that nothing
+ * is laid out while nothing is open. It also contributes the renderer of
+ * what the code asks (`QuestionView`, RU-4), drawn under the message that
+ * asks it.
  *
  * @module apps/plugins/app-elements
  */
@@ -17,4 +19,5 @@ export declare const APP_ELEMENTS_PLUGIN_NAME = "@datalayer/loop-plugin-app-elem
 /** The plugin that draws an application's side panel and pages. */
 export declare const AppElementsPlugin: ReactorPlugin<Record<string, never>, unknown, unknown>;
 export { AppElements, APP_PANEL_WIDTH, elementsByPlace } from './AppElements';
+export { QUESTION_DISPLAY_TYPE, QuestionView, questionOf, } from './QuestionView';
 export default AppElementsPlugin;

package/lib/apps/plugins/app-elements/index.js

@@ -9,17 +9,22 @@
  * code (`session.close`) or by the person. Inline, an element is a message,
  * which the chat draws (P-04); this plugin draws the other two.
  *
- * The chat keeps what is open (`chat/base/loopElement`), from the session
- * API's `loop.element` events; this plugin draws it from the workspace's
- * root slot, positioned against the workspace, so that nothing is laid out
- * while nothing is open.
+ * The chat keeps what is open (`chat/base/loopElement`), from the session's
+ * ui socket (REACTOR_UI RU-3, RU-W); this plugin draws it from the
+ * workspace's root slot, positioned against the workspace, so that nothing
+ * is laid out while nothing is open. It also contributes the renderer of
+ * what the code asks (`QuestionView`, RU-4), drawn under the message that
+ * asks it.
  *
  * @module apps/plugins/app-elements
  */
-import { definePlugin } from '@datalayer/reactor';
+import { contribution, definePlugin, } from '@datalayer/reactor';
+import { Renderers } from '@datalayer/reactor/ui';
+import { defineRenderer } from '@datalayer/reactor/ui/react';
 import { clearLoopElements } from '../../../chat/base/loopElement';
 import { LoopSlots } from '../../core';
 import { AppElements } from './AppElements';
+import { QUESTION_DISPLAY_TYPE, QuestionView } from './QuestionView';
 export const APP_ELEMENTS_PLUGIN_NAME = '@datalayer/loop-plugin-app-elements';
 /** The plugin that draws an application's side panel and pages. */
 export const AppElementsPlugin = definePlugin({
@@ -27,6 +32,9 @@ export const AppElementsPlugin = definePlugin({
     displayName: 'Side panel and pages',
     description: 'What an application opens beside the conversation: a side panel, or a page of its own.',
     octicon: 'sidebar-expand',
+    contributes: [
+        contribution(Renderers, defineRenderer({ type: QUESTION_DISPLAY_TYPE, component: QuestionView }), { id: 'app-elements:question' }),
+    ],
     build: () => ({
         components: [
             {
@@ -40,4 +48,5 @@ export const AppElementsPlugin = definePlugin({
     register: () => clearLoopElements,
 });
 export { AppElements, APP_PANEL_WIDTH, elementsByPlace } from './AppElements';
+export { QUESTION_DISPLAY_TYPE, QuestionView, questionOf, } from './QuestionView';
 export default AppElementsPlugin;

package/lib/apps/plugins/app-page/appPageModel.d.ts

@@ -162,16 +162,14 @@ export declare function settingsOf(app: Pick<AppSpec, 'interface'>, inputs: unkn
  */
 export declare function pageInputsOf(app: Pick<AppSpec, 'kind' | 'interface'>, inputs: unknown): Record<string, unknown>;
 /**
- * What the page did besides its message, for the session API: the action of
- * the block pressed, the files given with it, the settings it holds. Sent
- * with the chat's own run (AG-UI's `forwardedProps.loop`), so that what it
- * answers streams in the conversation (LOOP R-04).
+ * What the page did besides its message, for the session API: the files
+ * given with it, the settings it holds. Sent with the chat's own run (AG-UI's
+ * `forwardedProps.loop`), so that what it answers streams in the
+ * conversation (LOOP R-04). A block sends a message, never an action of its
+ * own: an action of the application's code is pressed with the token its
+ * session offered, up the ui socket (REACTOR_UI RU-5).
  */
 export type AppPageLoop = {
-    action: {
-        name: string;
-        payload: Record<string, unknown>;
-    };
     files?: GivenFile[];
     settings?: Record<string, unknown>;
 };

package/lib/apps/plugins/app-page/appPageModel.js

@@ -474,9 +474,7 @@ export function appPageAction(app, event, read, lastInputs = '') {
     const message = typeof given === 'string' ? given.trim() : '';
     const inputs = paths.inputs ? inputsInWords(app, read('/inputs')) : '';
     const settings = paths.inputs ? settingsOf(app, read('/inputs')) : undefined;
-    const payload = Object.fromEntries(Object.entries(event.context ?? {}).filter(([key]) => key !== 'message' && key !== 'files'));
     const loop = (files) => ({
-        action: { name: event.name, payload },
         ...(files && files.length > 0 ? { files } : {}),
         ...(settings ? { settings } : {}),
     });

package/lib/apps/plugins/app-page/pageRun.d.ts

@@ -3,8 +3,8 @@
  *
  * The page opens a session of the application's agent on its runtime
  * (`POST /api/v1/apps/sessions`), then, each time an input changes, sends
- * them all as the session's `page` action (`POST …/sessions/{uid}/actions`,
- * `{name: "page", payload: {inputs}}`). The runtime checks them against the
+ * them all to its page (`POST …/sessions/{uid}/page`, `{inputs}`) — not an
+ * action of its code (REACTOR_UI RU-5). The runtime checks them against the
  * page's form — refused with 422 and a sentence — runs its code's
  * `@app.page` on them, and answers its outputs as a `CUSTOM` event named
  * `loop.page`, `{inputs, outputs}`, which the page shows in place. Nothing is

package/lib/apps/plugins/app-page/pageRun.js

@@ -7,8 +7,8 @@
  *
  * The page opens a session of the application's agent on its runtime
  * (`POST /api/v1/apps/sessions`), then, each time an input changes, sends
- * them all as the session's `page` action (`POST …/sessions/{uid}/actions`,
- * `{name: "page", payload: {inputs}}`). The runtime checks them against the
+ * them all to its page (`POST …/sessions/{uid}/page`, `{inputs}`) — not an
+ * action of its code (REACTOR_UI RU-5). The runtime checks them against the
  * page's form — refused with 422 and a sentence — runs its code's
  * `@app.page` on them, and answers its outputs as a `CUSTOM` event named
  * `loop.page`, `{inputs, outputs}`, which the page shows in place. Nothing is
@@ -98,7 +98,7 @@ export async function openPageSession(context) {
  */
 export async function runPageIn(context, uid, inputs) {
     try {
-        const stream = await posted(context, `${base(context)}/${encodeURIComponent(uid)}/actions`, { name: 'page', payload: { inputs } });
+        const stream = await posted(context, `${base(context)}/${encodeURIComponent(uid)}/page`, { inputs });
         return pageTurnOf(stream);
     }
     catch (error) {

package/lib/apps/plugins/canvas-blocks/index.d.ts

@@ -1,6 +1,6 @@
 /**
- * The Canvas's palette as a contribution point (LOOP C-12): each UI plugin of
- * the catalogue that renders components (`agentspecs/ui-plugins`, C-13) is a
+ * The Canvas's palette as a contribution point (LOOP C-12): each UI of
+ * the catalogue that renders components (`agentspecs/ui`, C-13) is a
  * Reactor plugin contributing its components to `loop.canvas.block`. The
  * palette lists what the enabled plugins contribute, and nothing else; a
  * plugin disabled takes its blocks off it, and an application that uses one
@@ -12,7 +12,7 @@
  * @module apps/plugins/canvas-blocks
  */
 import { type ReactorPlatform, type ReactorPlugin } from '@datalayer/reactor';
-import type { AppSpec, ComponentSpec, UIPluginSpec } from '../../../types/agentspecs';
+import type { AppSpec, ComponentSpec, UISpec } from '../../../types/agentspecs';
 import { LoopCanvasBlock, type CanvasBlockContribution } from '../../core/canvasBlocks';
 /** What is read of a reactor here: its contributions to the point, and who is enabled. */
 type BlocksReader = {
@@ -20,12 +20,12 @@ type BlocksReader = {
         value: CanvasBlockContribution;
     }>;
 };
-/** The name of the Reactor plugin that contributes a UI plugin's blocks. */
-export declare const canvasBlocksPluginName: (uiPlugin: string) => string;
-/** A UI plugin of the catalogue as the Reactor plugin contributing its components as blocks. */
-export declare function uiPluginBlocks(uiPlugin: UIPluginSpec): ReactorPlugin<Record<string, never>, unknown, unknown>;
+/** The name of the Reactor plugin that contributes a UI's blocks. */
+export declare const canvasBlocksPluginName: (ui: string) => string;
+/** A UI of the catalogue as the Reactor plugin contributing its components as blocks. */
+export declare function uiPluginBlocks(ui: UISpec): ReactorPlugin<Record<string, never>, unknown, unknown>;
 /**
- * The plugins of the catalogue's UI plugins that render components and may
+ * The plugins of the catalogue's UI specs that render components and may
  * be named today (`enabled` in the catalogue).
  */
 export declare const CANVAS_BLOCK_PLUGINS: ReactorPlugin<Record<string, never>, unknown, unknown>[];
@@ -35,16 +35,16 @@ export declare const CANVAS_BLOCK_PLUGINS: ReactorPlugin<Record<string, never>,
  */
 export declare function canvasBlocksReactor(disabled?: readonly string[], plugins?: ReactorPlugin<any, any, any>[]): ReactorPlatform;
 /**
- * The palette of an organization: the block plugins of the UI plugins it has
+ * The palette of an organization: the block plugins of the UI specs it has
  * turned off (`plugins_off` in IAM, catalogue ids such as 'a2ui') switched
- * off. A UI plugin of the catalogue that contributes no block takes nothing
+ * off. A UI of the catalogue that contributes no block takes nothing
  * off; an id the catalogue does not have is said by `unknownPluginsOff`.
  */
 export declare function canvasBlocksReactorOf(pluginsOff: readonly string[]): ReactorPlatform;
-/** The ids an organization turns off that no UI plugin of the catalogue has. */
+/** The ids an organization turns off that no UI of the catalogue has. */
 export declare function unknownPluginsOff(pluginsOff: readonly string[]): string[];
 /**
- * What an application's page uses from a UI plugin its organization has
+ * What an application's page uses from a UI its organization has
  * turned off, as its setup notes say it (`blockSetupNotes`, on the palette of
  * `canvasBlocksReactorOf`).
  */
@@ -55,7 +55,7 @@ export declare function canvasBlocksOf(reactor: BlocksReader): ComponentSpec[];
 export declare function componentsUsedBy(app: Pick<AppSpec, 'interface'>): string[];
 /**
  * What an application's page uses that no enabled plugin contributes, as its
- * setup notes say it: one sentence per UI plugin of the catalogue whose
+ * setup notes say it: one sentence per UI of the catalogue whose
  * blocks it uses while its plugin is off. A component the catalogue does not
  * have is not a note but a problem of the instant checks.
  */

package/lib/apps/plugins/canvas-blocks/index.js

@@ -3,8 +3,8 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * The Canvas's palette as a contribution point (LOOP C-12): each UI plugin of
- * the catalogue that renders components (`agentspecs/ui-plugins`, C-13) is a
+ * The Canvas's palette as a contribution point (LOOP C-12): each UI of
+ * the catalogue that renders components (`agentspecs/ui`, C-13) is a
  * Reactor plugin contributing its components to `loop.canvas.block`. The
  * palette lists what the enabled plugins contribute, and nothing else; a
  * plugin disabled takes its blocks off it, and an application that uses one
@@ -16,26 +16,26 @@
  * @module apps/plugins/canvas-blocks
  */
 import { buildReactorFromPlugins, contribution, definePlugin, } from '@datalayer/reactor';
-import { listUIPlugins } from '../../../specs/uiPlugins';
+import { listUI } from '../../../specs/ui';
 import { LoopCanvasBlock, } from '../../core/canvasBlocks';
-/** The name of the Reactor plugin that contributes a UI plugin's blocks. */
-export const canvasBlocksPluginName = (uiPlugin) => `@datalayer/loop-plugin-ui-${uiPlugin}`;
-/** A UI plugin of the catalogue as the Reactor plugin contributing its components as blocks. */
-export function uiPluginBlocks(uiPlugin) {
+/** The name of the Reactor plugin that contributes a UI's blocks. */
+export const canvasBlocksPluginName = (ui) => `@datalayer/loop-plugin-ui-${ui}`;
+/** A UI of the catalogue as the Reactor plugin contributing its components as blocks. */
+export function uiPluginBlocks(ui) {
     return definePlugin({
-        name: canvasBlocksPluginName(uiPlugin.id),
-        displayName: uiPlugin.name,
-        description: `The blocks of ${uiPlugin.name} on the Canvas: ${uiPlugin.components.map(component => component.name).join(', ')}.`,
+        name: canvasBlocksPluginName(ui.id),
+        displayName: ui.name,
+        description: `The blocks of ${ui.name} on the Canvas: ${ui.components.map(component => component.name).join(', ')}.`,
         octicon: 'apps',
-        contributes: uiPlugin.components.map(component => contribution(LoopCanvasBlock, { id: component.id, uiPlugin: uiPlugin.id, component }, { id: component.id })),
+        contributes: ui.components.map(component => contribution(LoopCanvasBlock, { id: component.id, ui: ui.id, component }, { id: component.id })),
     });
 }
 /**
- * The plugins of the catalogue's UI plugins that render components and may
+ * The plugins of the catalogue's UI specs that render components and may
  * be named today (`enabled` in the catalogue).
  */
-export const CANVAS_BLOCK_PLUGINS = listUIPlugins()
-    .filter(uiPlugin => uiPlugin.enabled && uiPlugin.components.length > 0)
+export const CANVAS_BLOCK_PLUGINS = listUI()
+    .filter(ui => ui.enabled && ui.components.length > 0)
     .map(uiPluginBlocks);
 /**
  * A reactor holding the block plugins given, started, with those named in
@@ -53,9 +53,9 @@ export function canvasBlocksReactor(disabled = [], plugins = CANVAS_BLOCK_PLUGIN
     return reactor;
 }
 /**
- * The palette of an organization: the block plugins of the UI plugins it has
+ * The palette of an organization: the block plugins of the UI specs it has
  * turned off (`plugins_off` in IAM, catalogue ids such as 'a2ui') switched
- * off. A UI plugin of the catalogue that contributes no block takes nothing
+ * off. A UI of the catalogue that contributes no block takes nothing
  * off; an id the catalogue does not have is said by `unknownPluginsOff`.
  */
 export function canvasBlocksReactorOf(pluginsOff) {
@@ -64,13 +64,13 @@ export function canvasBlocksReactorOf(pluginsOff) {
         .map(canvasBlocksPluginName)
         .filter(name => blockPlugins.has(name)));
 }
-/** The ids an organization turns off that no UI plugin of the catalogue has. */
+/** The ids an organization turns off that no UI of the catalogue has. */
 export function unknownPluginsOff(pluginsOff) {
-    const known = new Set(listUIPlugins().map(uiPlugin => uiPlugin.id));
+    const known = new Set(listUI().map(ui => ui.id));
     return pluginsOff.filter(id => !known.has(id));
 }
 /**
- * What an application's page uses from a UI plugin its organization has
+ * What an application's page uses from a UI its organization has
  * turned off, as its setup notes say it (`blockSetupNotes`, on the palette of
  * `canvasBlocksReactorOf`).
  */
@@ -96,7 +96,7 @@ export function componentsUsedBy(app) {
 }
 /**
  * What an application's page uses that no enabled plugin contributes, as its
- * setup notes say it: one sentence per UI plugin of the catalogue whose
+ * setup notes say it: one sentence per UI of the catalogue whose
  * blocks it uses while its plugin is off. A component the catalogue does not
  * have is not a note but a problem of the instant checks.
  */
@@ -107,12 +107,12 @@ export function blockSetupNotes(app, reactor) {
         if (contributed.has(name)) {
             continue;
         }
-        for (const uiPlugin of listUIPlugins()) {
-            const component = uiPlugin.components.find(each => each.id === name);
+        for (const ui of listUI()) {
+            const component = ui.components.find(each => each.id === name);
             if (component) {
-                off.set(uiPlugin, [...(off.get(uiPlugin) ?? []), component.name]);
+                off.set(ui, [...(off.get(ui) ?? []), component.name]);
             }
         }
     }
-    return [...off.entries()].map(([uiPlugin, names]) => `The UI plugin “${uiPlugin.name}” is not enabled, and its page uses its ${names.length === 1 ? 'block' : 'blocks'} ${names.join(', ')}: ${names.length === 1 ? 'it is' : 'they are'} off the Canvas until it is.`);
+    return [...off.entries()].map(([ui, names]) => `The UI “${ui.name}” is not enabled, and its page uses its ${names.length === 1 ? 'block' : 'blocks'} ${names.join(', ')}: ${names.length === 1 ? 'it is' : 'they are'} off the Canvas until it is.`);
 }

package/lib/apps/plugins/canvas-parts/index.d.ts

@@ -15,7 +15,7 @@ type PartsReader = {
     }>;
 };
 /** The short ids an organization turns off, and the plugin each names. */
-export declare const CANVAS_PART_SOURCES: readonly ["connections", "skills", "models", "rules", "tests", "events"];
+export declare const CANVAS_PART_SOURCES: readonly ["connections", "skills", "models", "rules", "tests", "events", "protocols", "ui", "characters"];
 export type CanvasPartSource = (typeof CANVAS_PART_SOURCES)[number];
 export declare const canvasPartsPluginName: (source: CanvasPartSource) => string;
 /** A connection to each server of the catalogue: read-only, as its owner, every tool. */
@@ -30,6 +30,12 @@ export declare const RULE_PARTS: CanvasPartContribution[];
 export declare const TEST_PARTS: CanvasPartContribution[];
 /** The events an application answers (C-21): on a schedule, on an event, once. */
 export declare const EVENT_PARTS: CanvasPartContribution[];
+/** Each protocol of the catalogue (AGENT_PROTOCOLS PS-04): a planned one offered, not enabled. */
+export declare const PROTOCOL_PARTS: CanvasPartContribution[];
+/** Each UI of the catalogue its answers may render in (AGENT_PROTOCOLS PS-04). */
+export declare const UI_PARTS: CanvasPartContribution[];
+/** Datalayer's characters for its floating assistant, dropped on the agent (AGENT_PROTOCOLS PS-05). */
+export declare const CHARACTER_PARTS: CanvasPartContribution[];
 export declare const CANVAS_PART_PLUGINS: ReactorPlugin<Record<string, never>, unknown, unknown>[];
 /** The toolbox's reactor, its named plugins disabled; a name no plugin has is refused. */
 export declare function canvasPartsReactor(disabled?: readonly string[], plugins?: ReactorPlugin<any, any, any>[]): ReactorPlatform;

package/lib/apps/plugins/canvas-parts/index.js

@@ -15,6 +15,9 @@ import { buildReactorFromPlugins, contribution, definePlugin, } from '@datalayer
 import { MCP_SERVER_LIBRARY } from '../../../specs/mcpServers';
 import { listChatModels } from '../../../specs/models';
 import { getSkillSpecs } from '../../../specs/skills';
+import { listProtocolSpecs } from '../../../specs/protocols';
+import { listUI } from '../../../specs/ui';
+import { ASSISTANT_CHARACTERS } from '../../../chat/assistant/characters';
 import { LoopCanvasPart, } from '../../core/canvasParts';
 /** The short ids an organization turns off, and the plugin each names. */
 export const CANVAS_PART_SOURCES = [
@@ -24,6 +27,9 @@ export const CANVAS_PART_SOURCES = [
     'rules',
     'tests',
     'events',
+    'protocols',
+    'ui',
+    'characters',
 ];
 export const canvasPartsPluginName = (source) => `@datalayer/loop-plugin-parts-${source}`;
 const partsPlugin = (source, displayName, parts) => definePlugin({
@@ -172,6 +178,33 @@ export const EVENT_PARTS = [
         enabled: true,
     },
 ];
+/** Each protocol of the catalogue (AGENT_PROTOCOLS PS-04): a planned one offered, not enabled. */
+export const PROTOCOL_PARTS = listProtocolSpecs().map(protocol => ({
+    id: `protocol:${protocol.id}`,
+    kind: 'protocol',
+    label: protocol.name,
+    says: protocol.connects,
+    example: protocol.id,
+    enabled: protocol.status === 'shipped',
+}));
+/** Each UI of the catalogue its answers may render in (AGENT_PROTOCOLS PS-04). */
+export const UI_PARTS = listUI().map(ui => ({
+    id: `ui:${ui.id}`,
+    kind: 'ui',
+    label: ui.name,
+    says: ui.description,
+    example: ui.id,
+    enabled: ui.enabled,
+}));
+/** Datalayer's characters for its floating assistant, dropped on the agent (AGENT_PROTOCOLS PS-05). */
+export const CHARACTER_PARTS = ASSISTANT_CHARACTERS.map(character => ({
+    id: `character:${character.id}`,
+    kind: 'character',
+    label: character.name,
+    says: `Its floating assistant shows ${character.name}.`,
+    example: character.id,
+    enabled: true,
+}));
 export const CANVAS_PART_PLUGINS = [
     partsPlugin('connections', 'Connections', CONNECTION_PARTS),
     partsPlugin('skills', 'Skills', SKILL_PARTS),
@@ -179,6 +212,9 @@ export const CANVAS_PART_PLUGINS = [
     partsPlugin('rules', 'Rules', RULE_PARTS),
     partsPlugin('tests', 'Tests', TEST_PARTS),
     partsPlugin('events', 'Events', EVENT_PARTS),
+    partsPlugin('protocols', 'Protocols', PROTOCOL_PARTS),
+    partsPlugin('ui', 'UI', UI_PARTS),
+    partsPlugin('characters', 'Characters', CHARACTER_PARTS),
 ];
 /** The toolbox's reactor, its named plugins disabled; a name no plugin has is refused. */
 export function canvasPartsReactor(disabled = [], plugins = CANVAS_PART_PLUGINS) {

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

@@ -6,7 +6,7 @@ import { ScreenFullIcon, ScreenNormalIcon } from '@primer/octicons-react';
 import { computed, signal } from '@datalayer/reactor';
 /* A signal to read when the layout publishes no live stance: the hook needs one. */
 const NO_STANCE = signal(undefined);
-import { useContributions, useSignalValue, useGate, useReactorPlatform, ReactorLazy, ReactorSlot, useSlotComponents, } from '@datalayer/reactor/react';
+import { useAgentToolBundles, useContributions, useSignalValue, useGate, useReactorPlatform, ReactorLazy, ReactorSlot, useSlotComponents, } from '@datalayer/reactor/react';
 import { ChatBase } from '../../../chat/base/ChatBase';
 import { useChatAvailability } from '../../../chat/base/ChatAvailability';
 import { offeredModels as offeredModelsFor, readServerCatalogue, readServerDecisions, } from '../../../chat/base/modelChoice';
@@ -45,7 +45,7 @@ import { AI_MODEL_CATALOGUE, isChatModel } from '../../../specs/models';
 import { LoopAgentBlueprint, LoopAgentGate, LoopChatComposer, LoopChatExtras, LoopChatHeader, LoopChatLayout, LoopChatSuggestion, LoopChatSurface, LoopChatTurn, LoopCommand, LoopFrontendTool, LoopRunProps, LoopSlots, agentServerOf, noRuntimeSaid, canOpenView, runForwardedProps, onPromptFocusRequest, onSurfaceRequest, useLoopPromptStore, } from '../../core';
 import { messageText, turnWritersOf } from './turnState';
 import { isInactiveSurfaceContribution, orderToolContributions, toolsForChatView, } from './chatViewTools';
-import { useAgentCommandTools } from '../../../tools/adapters/commands';
+import { agentBundleToolDefinitions, useAgentCommandTools, } from '../../../tools/adapters/commands';
 import { NONE_EDITOR, seedEditorChoice, setEditorOptions, } from '../shell/editorChoice';
 import { generateMessageId } from '../../../types/messages';
 import { openThread, THREAD_WORDS } from '../../apps/threads';
@@ -982,6 +982,23 @@ export default function ChatView({ workspace }) {
             ...commandTools.filter(tool => !taken.has(tool.name)),
         ];
     }, [notebookTools, commandTools]);
+    /*
+     * The page's own tools for an agent on a server: a host example's, and
+     * the tools of the `AgentTools` bundles its extras name (REACTOR_UI RU-7:
+     * the host page's functions, `host_<name>`, each running its command on
+     * this reactor). An in-page agent has every bundle already (above).
+     */
+    const bundles = useAgentToolBundles();
+    const handedBundles = chatExtras.agentToolBundles;
+    const pageTools = useMemo(() => {
+        const own = chatExtras.frontendTools ?? [];
+        if (!handedBundles?.length) {
+            return chatExtras.frontendTools;
+        }
+        const handed = agentBundleToolDefinitions(bundles.filter(bundle => handedBundles.includes(bundle.id)), reactor);
+        const taken = new Set(own.map(tool => tool.name));
+        return [...own, ...handed.filter(tool => !taken.has(tool.name))];
+    }, [chatExtras.frontendTools, handedBundles, bundles, reactor]);
     // The page's sandbox, while the agent turned here runs its code in it.
     pageSandboxRef.current =
         inPage && agentTools.some(tool => tool.name === BROWSER_CODE_TOOL)
@@ -1374,6 +1391,15 @@ export default function ChatView({ workspace }) {
                     ? `${agentServerUrl}/api/v1/apps/agents/${encodeURIComponent(agentId)}/ag-ui/`
                     : `${agentServerUrl}/api/v1/ag-ui/${agentId}/`,
                 ...(runsApp && iamToken ? { authToken: iamToken } : {}),
+                // Its session's ui channel (REACTOR_UI RU-W): what its answers
+                // show, its steps and its elements, beside the run's text.
+                ...(runsApp
+                    ? {
+                        uiSocket: `${agentServerUrl.replace(/^http/, 'ws')}/api/v1/apps/ui`,
+                        // Its files, uploaded before what names them (RU-6).
+                        uiFiles: `${agentServerUrl}/api/v1/apps/agents/${encodeURIComponent(agentId)}/files`,
+                    }
+                    : {}),
                 agentId,
                 // `/api/v1/configure`, not `/api/v1/configure/config`: the hooks
                 // strip one trailing `config`/`configure` segment to find the API
@@ -1724,7 +1750,7 @@ export default function ChatView({ workspace }) {
                           embedded application's run carried no tool at all (seen
                           2026-10-10: `toolsForRequest: []`).
                         */
-                        frontendTools: inPage ? undefined : chatExtras.frontendTools, 
+                        frontendTools: inPage ? undefined : pageTools, 
                         /*
                           The model this view is on, as the chat's opening pick.