@datalayer/agent-runtimes 1.5.15 → 1.5.17

package/lib/apps/apps/appspec.d.ts

@@ -97,9 +97,11 @@ export interface ParsedAppspec {
  */
 export declare function parseAppspec(document: unknown): ParsedAppspec;
 /**
- * What is wrong with the UI an application says its answers render in
- * (AGENT_PROTOCOLS PS-04), as agentspecs says it: an id the catalogue does not
- * know or said twice, one not enabled while it is offered.
+ * What is wrong with the UI plugins an application names (AGENTIC_UI R8), in
+ * the sentences agentspecs says (`ui_choices_problems`): a plugin the
+ * catalogue does not have or said twice — a renderer named as a plugin is
+ * refused —, a renderer the catalogue does not have or the plugin may not be
+ * exposed through, and one not enabled while the application is offered.
  */
 export declare function uiProblems(app: Pick<AppSpec, 'ui' | 'enabled'>): string[];
 /**

package/lib/apps/apps/appspec.js

@@ -5,6 +5,7 @@
 import { BEHAVIOURS } from './rules';
 import { PROTOCOL_CATALOGUE } from '../../specs/protocols';
 import { UI_CATALOGUE } from '../../specs/ui';
+import { UI_RENDERER_CATALOGUE } from '../../specs/uiRenderers';
 import { DEFAULT_MAX_FILES, DEFAULT_UPLOAD_MB } from './uploads';
 /** The version of the spec itself. */
 export const APP_SCHEMA = 'loop.app/v1';
@@ -90,6 +91,25 @@ const texts = (value) => Array.isArray(value)
     ? value.filter((item) => typeof item === 'string')
     : [];
 const records = (value) => Array.isArray(value) ? value.filter(isData) : [];
+/**
+ * An application's UI plugins as its document says them (AGENTIC_UI R8):
+ * `{plugin, renderer}` each. A bare id — the old shape, a renderer named as a
+ * UI — is read as the plugin it names, which `uiProblems` refuses.
+ */
+const uiChoices = (value) => Array.isArray(value)
+    ? value.flatMap((item) => typeof item === 'string'
+        ? [{ plugin: item }]
+        : isData(item)
+            ? [
+                {
+                    plugin: text(item.plugin),
+                    ...(text(item.renderer)
+                        ? { renderer: text(item.renderer) }
+                        : {}),
+                },
+            ]
+            : [])
+    : [];
 /**
  * One turn of a test's conversation as its document says it (STUDIO E-01):
  * what it says, chooses or presses, with a press's payload; nothing it does
@@ -984,7 +1004,7 @@ export function parseAppspec(document) {
         contents: texts(data.contents),
         connections: records(data.connections).map(parseConnection),
         protocols: texts(data.protocols),
-        ui: texts(data.ui),
+        ui: uiChoices(data.ui),
         rules: records(data.rules).map(parseRule),
         permissions: {
             spaces: records(permissions.spaces).map(grant => ({
@@ -1097,25 +1117,45 @@ export function parseAppspec(document) {
     return { app, problems };
 }
 /**
- * What is wrong with the UI an application says its answers render in
- * (AGENT_PROTOCOLS PS-04), as agentspecs says it: an id the catalogue does not
- * know or said twice, one not enabled while it is offered.
+ * What is wrong with the UI plugins an application names (AGENTIC_UI R8), in
+ * the sentences agentspecs says (`ui_choices_problems`): a plugin the
+ * catalogue does not have or said twice — a renderer named as a plugin is
+ * refused —, a renderer the catalogue does not have or the plugin may not be
+ * exposed through, and one not enabled while the application is offered.
  */
 export function uiProblems(app) {
     const problems = [];
     const seen = [];
-    for (const id of app.ui) {
+    for (const choice of app.ui) {
+        const id = choice.plugin;
         if (seen.includes(id)) {
-            problems.push(`It lists the UI '${id}' twice.`);
+            problems.push(`It lists the UI plugin '${id}' twice.`);
             continue;
         }
         seen.push(id);
         const spec = UI_CATALOGUE[id];
         if (!spec) {
-            problems.push(`There is no UI named '${id}': one of ${Object.keys(UI_CATALOGUE).sort().join(', ')}.`);
+            problems.push(`There is no UI plugin named '${id}': one of ${Object.keys(UI_CATALOGUE).sort().join(', ')}.` +
+                (UI_RENDERER_CATALOGUE[id]
+                    ? ` '${id}' is a UI renderer: say it as a plugin's \`renderer\`.`
+                    : ''));
+            continue;
+        }
+        if (choice.renderer === undefined) {
+            continue;
+        }
+        const renderer = UI_RENDERER_CATALOGUE[choice.renderer];
+        if (!renderer) {
+            problems.push(`There is no UI renderer named '${choice.renderer}': one of ${Object.keys(UI_RENDERER_CATALOGUE).sort().join(', ')}.`);
+        }
+        else if (!spec.renderers.includes(renderer.id)) {
+            problems.push(`The UI plugin ${spec.name} ('${id}') is not exposed through ${renderer.name}: ` +
+                (spec.renderers.length > 0
+                    ? `through ${spec.renderers.join(', ')} only.`
+                    : 'through no renderer.'));
         }
-        else if (app.enabled && !spec.enabled) {
-            problems.push(`The UI ${spec.name} ('${id}') is not enabled: an application cannot render in it yet.`);
+        else if (app.enabled && !renderer.enabled) {
+            problems.push(`The UI renderer ${renderer.name} ('${renderer.id}') is not enabled: an application cannot be exposed through it yet.`);
         }
     }
     return problems;
@@ -1426,7 +1466,9 @@ export function dumpAppspec(app) {
         .value('as', connection.as, 'owner')
         .list('only', connection.only).data))
         .list('protocols', app.protocols)
-        .list('ui', app.ui)
+        .list('ui', app.ui.map(choice => choice.renderer
+        ? { plugin: choice.plugin, renderer: choice.renderer }
+        : { plugin: choice.plugin }))
         .part('pap', dumpPap(app.pap))
         .part('pact', dumpPact(app.pact))
         .part('commerce', dumpCommerce(app.commerce))

package/lib/apps/apps/threads.d.ts

@@ -13,12 +13,32 @@
  *
  * @module apps/apps/threads
  */
+import type { ResumedThread } from '../../types/chat';
 import type { ChatMessage } from '../../types/messages';
 /** What opening a thread says, in a person's words. */
 export declare const THREAD_WORDS: {
     readonly opening: "Opening your conversation…";
     readonly notOpened: (detail: string) => string;
 };
+/**
+ * The deployment an application's agent is created for, as its create
+ * payload names it (`app_instance.deployment_uid`, `appDatalayerCreatePayload`),
+ * or `''` for a Preview, a test or no application.
+ */
+export declare function deploymentOfPayload(createPayload: Record<string, unknown> | undefined): string;
+/**
+ * The thread a deployment's chat opens on when its host gave none: a new one,
+ * `id` (PAP_DATALAYER's release gates, found on r1, 14 October 2026).
+ *
+ * A deployment's agent serves every visitor, and what its runtime holds in
+ * memory is the last run's, whoever ran it: drawn as the page's
+ * conversation, a second account opening the same link saw the first
+ * person's turns. A given thread is drawn as given and never replaced by the
+ * runtime's snapshot, so each visitor sees only their own conversation —
+ * this one, or one opened from their history. A Preview, or a chat that runs
+ * no deployment, keeps what it was given.
+ */
+export declare function threadOfVisit(given: ResumedThread | undefined, deploymentUid: string, id: string): ResumedThread | undefined;
 /** The AG-UI messages a session-API stream's `MESSAGES_SNAPSHOT` carries, if one does. */
 export declare function snapshotOfStream(text: string): unknown[] | undefined;
 /**

package/lib/apps/apps/threads.js

@@ -8,6 +8,37 @@ export const THREAD_WORDS = {
     opening: 'Opening your conversation…',
     notOpened: (detail) => `Your conversation could not be opened, so this is a new one: ${detail}`,
 };
+/**
+ * The deployment an application's agent is created for, as its create
+ * payload names it (`app_instance.deployment_uid`, `appDatalayerCreatePayload`),
+ * or `''` for a Preview, a test or no application.
+ */
+export function deploymentOfPayload(createPayload) {
+    const instance = createPayload?.app_instance;
+    if (!instance || typeof instance !== 'object') {
+        return '';
+    }
+    const uid = instance.deployment_uid;
+    return typeof uid === 'string' ? uid.trim() : '';
+}
+/**
+ * The thread a deployment's chat opens on when its host gave none: a new one,
+ * `id` (PAP_DATALAYER's release gates, found on r1, 14 October 2026).
+ *
+ * A deployment's agent serves every visitor, and what its runtime holds in
+ * memory is the last run's, whoever ran it: drawn as the page's
+ * conversation, a second account opening the same link saw the first
+ * person's turns. A given thread is drawn as given and never replaced by the
+ * runtime's snapshot, so each visitor sees only their own conversation —
+ * this one, or one opened from their history. A Preview, or a chat that runs
+ * no deployment, keeps what it was given.
+ */
+export function threadOfVisit(given, deploymentUid, id) {
+    if (given || !deploymentUid) {
+        return given;
+    }
+    return { id, messages: [] };
+}
 /** The AG-UI messages a session-API stream's `MESSAGES_SNAPSHOT` carries, if one does. */
 export function snapshotOfStream(text) {
     let found;

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

@@ -1,7 +1,8 @@
 /**
- * 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
+ * The Canvas's palette as a Contribution Point (LOOP C-12): each UI plugin
+ * of the catalogue that renders components (`agentspecs/ui`, C-13 — the
+ * A2UI surfaces, `a2ui-surface`) has its components contributed to
+ * `loop.canvas.block` by a Reactor plugin of its own, one per UI spec. 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
  * of them says so in its setup notes (`blockSetupNotes`).
@@ -24,10 +25,7 @@ type BlocksReader = {
 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 specs that render components and may
- * be named today (`enabled` in the catalogue).
- */
+/** The block plugins of the catalogue's UI plugins that render components. */
 export declare const CANVAS_BLOCK_PLUGINS: ReactorPlugin<Record<string, never>, unknown, unknown>[];
 /**
  * A reactor holding the block plugins given, started, with those named in
@@ -35,8 +33,8 @@ 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 specs it has
- * turned off (`plugins_off` in IAM, catalogue ids such as 'a2ui') switched
+ * The palette of an organization: the block plugins of the UI plugins it has
+ * turned off (`plugins_off` in IAM, ids of `agentspecs/ui` such as 'a2ui-surface') switched
  * off. A UI of the catalogue that contributes no block takes nothing
  * off; an id the catalogue does not have is said by `unknownPluginsOff`.
  */

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

@@ -3,9 +3,10 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * 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
+ * The Canvas's palette as a Contribution Point (LOOP C-12): each UI plugin
+ * of the catalogue that renders components (`agentspecs/ui`, C-13 — the
+ * A2UI surfaces, `a2ui-surface`) has its components contributed to
+ * `loop.canvas.block` by a Reactor plugin of its own, one per UI spec. 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
  * of them says so in its setup notes (`blockSetupNotes`).
@@ -30,12 +31,9 @@ export function uiPluginBlocks(ui) {
         contributes: ui.components.map(component => contribution(LoopCanvasBlock, { id: component.id, ui: ui.id, component }, { id: component.id })),
     });
 }
-/**
- * The plugins of the catalogue's UI specs that render components and may
- * be named today (`enabled` in the catalogue).
- */
+/** The block plugins of the catalogue's UI plugins that render components. */
 export const CANVAS_BLOCK_PLUGINS = listUI()
-    .filter(ui => ui.enabled && ui.components.length > 0)
+    .filter(ui => ui.components.length > 0)
     .map(uiPluginBlocks);
 /**
  * A reactor holding the block plugins given, started, with those named in
@@ -53,8 +51,8 @@ export function canvasBlocksReactor(disabled = [], plugins = CANVAS_BLOCK_PLUGIN
     return reactor;
 }
 /**
- * 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
+ * The palette of an organization: the block plugins of the UI plugins it has
+ * turned off (`plugins_off` in IAM, ids of `agentspecs/ui` such as 'a2ui-surface') switched
  * off. A UI of the catalogue that contributes no block takes nothing
  * off; an id the catalogue does not have is said by `unknownPluginsOff`.
  */

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

@@ -32,7 +32,10 @@ export declare const TEST_PARTS: CanvasPartContribution[];
 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). */
+/**
+ * Each UI plugin of the catalogue (AGENTIC_UI R8): a part of the agent's
+ * interface, dropped on it, then exposed through a renderer it may be.
+ */
 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[];

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

@@ -187,14 +187,18 @@ export const PROTOCOL_PARTS = listProtocolSpecs().map(protocol => ({
     example: protocol.id,
     enabled: protocol.status === 'shipped',
 }));
-/** Each UI of the catalogue its answers may render in (AGENT_PROTOCOLS PS-04). */
+/**
+ * Each UI plugin of the catalogue (AGENTIC_UI R8): a part of the agent's
+ * interface, dropped on it, then exposed through a renderer it may be.
+ */
 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,
+    // The Appspec's `ui` entry it adds: the plugin, its renderer chosen after.
+    example: { plugin: ui.id },
+    enabled: true,
 }));
 /** Datalayer's characters for its floating assistant, dropped on the agent (AGENT_PROTOCOLS PS-05). */
 export const CHARACTER_PARTS = ASSISTANT_CHARACTERS.map(character => ({

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

@@ -48,7 +48,7 @@ import { isInactiveSurfaceContribution, orderToolContributions, toolsForChatView
 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';
+import { deploymentOfPayload, openThread, THREAD_WORDS, threadOfVisit, } from '../../apps/threads';
 import { FaceDrawing, PresenceFace, PresenceLine, } from '../../../chat/presence/Presence';
 import { presenceState, presenceToolOf, } from '../../../chat/presence/presenceStatus';
 import { latestSaying, newestIsAnswer, } from '../../../chat/assistant/state';
@@ -1280,9 +1280,10 @@ export default function ChatView({ workspace }) {
      * not published (STUDIO D-15). It speaks to the application's session API,
      * whose refusal says why.
      */
-    const runsApp = Boolean(blueprintTurn?.createPayload?.app_spec ||
-        reactor.getConfig(AGENTS_PLUGIN_NAME)?.datalayerCreatePayload
-            ?.app_spec);
+    const hostCreatePayload = reactor.getConfig(AGENTS_PLUGIN_NAME)?.datalayerCreatePayload;
+    const runsApp = Boolean(blueprintTurn?.createPayload?.app_spec || hostCreatePayload?.app_spec);
+    // The deployment its host runs, if it runs one: its agent is every visitor's.
+    const deploymentUid = deploymentOfPayload(hostCreatePayload);
     const memberToken = useIAMStore(state => state.token);
     /*
      * Without an account (LOOP R-30) the application runs on the visitors'
@@ -1300,7 +1301,12 @@ export default function ChatView({ workspace }) {
      * its record — then drawn and gone on with on the same thread. One that
      * cannot be opened is said, and a new one starts.
      */
-    const givenThread = config?.thread;
+    /*
+     * A deployment's visit with no thread given opens a new one: its runtime's
+     * agent holds every visitor's turns, never drawn as this person's.
+     */
+    const [visitThreadId] = useState(generateMessageId);
+    const givenThread = useMemo(() => threadOfVisit(config?.thread, deploymentUid, visitThreadId), [config?.thread, deploymentUid, visitThreadId]);
     const [openedThread, setOpenedThread] = useState(null);
     const opening = Boolean(givenThread?.fromRuntime && openedThread?.given !== givenThread.id);
     useEffect(() => {

package/lib/chat/base/ChatBase.js

@@ -32,6 +32,8 @@ import { useCoreStore } from '@datalayer/core';
 import { DEFAULT_SERVICE_URLS } from '@datalayer/core/lib/api/constants';
 import { useChatStore } from '../../stores/chatStore';
 import { useConversationStore } from '../../stores/conversationStore';
+import { askedOf } from '../../apps/apps/records';
+import { extractChatMessagesFromFullContext } from './fullContextMessages';
 import { generateMessageId, createUserMessage, createAssistantMessage, } from '../../types/messages';
 import { AI_MODEL_CATALOGUE, DEFAULT_MODEL, isChatModel, } from '../../specs/models';
 import { internalQueryClient, isToolCallMessage, convertHistoryToDisplayItems, createProtocolAdapter, getApiBaseFromConfig, sanitizeAssistantContent, } from '../../utils';
@@ -315,99 +317,6 @@ function formatToolResultFallback(result) {
         return 'Tool completed successfully.';
     }
 }
-function extractChatMessagesFromFullContext(fullContext) {
-    if (!fullContext) {
-        return [];
-    }
-    const rawMessages = Array.isArray(fullContext.messages)
-        ? fullContext.messages
-        : [];
-    return rawMessages
-        .map((msg, index) => {
-        const role = String(msg.role || '').toLowerCase();
-        const timestampValue = typeof msg.timestamp === 'string' && msg.timestamp.length > 0
-            ? msg.timestamp
-            : new Date().toISOString();
-        const createdAtRaw = new Date(timestampValue);
-        const createdAt = Number.isNaN(createdAtRaw.getTime())
-            ? new Date()
-            : createdAtRaw;
-        const rawContent = typeof msg.content === 'string'
-            ? msg.content
-            : JSON.stringify(msg.content ?? '');
-        const isToolCall = Boolean(msg.isToolCall);
-        const isToolResult = Boolean(msg.isToolResult);
-        const toolCallId = typeof msg.toolCallId === 'string' && msg.toolCallId.length > 0
-            ? msg.toolCallId
-            : undefined;
-        const toolName = typeof msg.toolName === 'string' && msg.toolName.length > 0
-            ? msg.toolName
-            : undefined;
-        // Tool-call turns arrive as assistant messages whose `content` is the
-        // JSON-encoded tool arguments. Reconstruct a structured `toolCalls`
-        // entry so it renders as a tool card (matching the live stream) instead
-        // of leaking raw JSON into the transcript.
-        if (isToolCall) {
-            let args = {};
-            if (rawContent) {
-                try {
-                    const parsed = JSON.parse(rawContent);
-                    if (parsed &&
-                        typeof parsed === 'object' &&
-                        !Array.isArray(parsed)) {
-                        args = parsed;
-                    }
-                }
-                catch {
-                    args = {};
-                }
-            }
-            const resolvedToolCallId = toolCallId || `history-tc-${index}`;
-            return {
-                id: `history-toolcall-${index}-${timestampValue}`,
-                role: 'assistant',
-                content: '',
-                createdAt,
-                toolCalls: [
-                    {
-                        type: 'tool-call',
-                        toolCallId: resolvedToolCallId,
-                        toolName: toolName || 'tool',
-                        args,
-                        status: 'completed',
-                    },
-                ],
-            };
-        }
-        // Tool results arrive as `role: 'tool'` messages; keep them (with the
-        // matching toolCallId) so `convertHistoryToDisplayItems` can merge the
-        // result into its tool card.
-        if (isToolResult || role === 'tool') {
-            return {
-                id: `history-toolresult-${index}-${timestampValue}`,
-                role: 'tool',
-                content: rawContent,
-                createdAt,
-                metadata: {
-                    toolCallId,
-                    toolName,
-                },
-            };
-        }
-        // Only hydrate conversational turns in the visible history.
-        // System messages may contain internal prompts and metadata.
-        if (role !== 'user' && role !== 'assistant') {
-            return null;
-        }
-        return {
-            id: `history-${role}-${index}-${timestampValue}`,
-            role,
-            content: rawContent,
-            createdAt,
-        };
-    })
-        .filter((m) => m !== null);
-}
 function parseEnabledMcpToolsByServer(mcpStatusData) {
     if (!mcpStatusData || typeof mcpStatusData !== 'object') {
         return null;
@@ -3867,7 +3776,9 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
         typingSuggestions: resolvedSuggestions?.map(item => item.message || item.title), autoFocus: autoFocus, focusTrigger: focusTrigger, padding: padding, onSend: () => handleSend(), onStop: handleStop, disableInputPrompt: disableInputPrompt || disabled || !!overlay || launching, promptVariant: promptVariant, mentionableAgents: mentionableAgents, promptCommands: promptCommands, 
         // The runtime's memory of what was sent to this agent, for the arrow
         // keys — part of the same initial state as the models and tools.
-        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, 
+        // Without what the runtime told the application before a personal
+        // agent's request (`askedOf`): the person never wrote it.
+        promptHistory: configQuery.data?.promptHistory?.map(askedOf), 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, 

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

@@ -0,0 +1,2 @@
+import type { ChatMessage } from '../../types/messages';
+export declare function extractChatMessagesFromFullContext(fullContext: Record<string, unknown> | null): ChatMessage[];

package/lib/chat/base/fullContextMessages.js

@@ -0,0 +1,110 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * A chat's conversation as the runtime's agent holds it (`fullContext`, from
+ * the `agent.snapshot` it sends), drawn as messages — kept out of `ChatBase`
+ * so it can be read and tested without rendering a chat.
+ *
+ * A shipped application's page opens on this conversation, so a turn a
+ * personal agent asked over PAP or PACT is drawn through `askedOf`: the
+ * preamble the runtime told the application (`<asked-for>…</asked-for>`) is
+ * kept in the record for the builder and never shown to the person.
+ */
+import { askedOf } from '../../apps/apps/records';
+export function extractChatMessagesFromFullContext(fullContext) {
+    if (!fullContext) {
+        return [];
+    }
+    const rawMessages = Array.isArray(fullContext.messages)
+        ? fullContext.messages
+        : [];
+    return rawMessages
+        .map((msg, index) => {
+        const role = String(msg.role || '').toLowerCase();
+        const timestampValue = typeof msg.timestamp === 'string' && msg.timestamp.length > 0
+            ? msg.timestamp
+            : new Date().toISOString();
+        const createdAtRaw = new Date(timestampValue);
+        const createdAt = Number.isNaN(createdAtRaw.getTime())
+            ? new Date()
+            : createdAtRaw;
+        const rawContent = typeof msg.content === 'string'
+            ? msg.content
+            : JSON.stringify(msg.content ?? '');
+        const isToolCall = Boolean(msg.isToolCall);
+        const isToolResult = Boolean(msg.isToolResult);
+        const toolCallId = typeof msg.toolCallId === 'string' && msg.toolCallId.length > 0
+            ? msg.toolCallId
+            : undefined;
+        const toolName = typeof msg.toolName === 'string' && msg.toolName.length > 0
+            ? msg.toolName
+            : undefined;
+        // Tool-call turns arrive as assistant messages whose `content` is the
+        // JSON-encoded tool arguments. Reconstruct a structured `toolCalls`
+        // entry so it renders as a tool card (matching the live stream) instead
+        // of leaking raw JSON into the transcript.
+        if (isToolCall) {
+            let args = {};
+            if (rawContent) {
+                try {
+                    const parsed = JSON.parse(rawContent);
+                    if (parsed &&
+                        typeof parsed === 'object' &&
+                        !Array.isArray(parsed)) {
+                        args = parsed;
+                    }
+                }
+                catch {
+                    args = {};
+                }
+            }
+            const resolvedToolCallId = toolCallId || `history-tc-${index}`;
+            return {
+                id: `history-toolcall-${index}-${timestampValue}`,
+                role: 'assistant',
+                content: '',
+                createdAt,
+                toolCalls: [
+                    {
+                        type: 'tool-call',
+                        toolCallId: resolvedToolCallId,
+                        toolName: toolName || 'tool',
+                        args,
+                        status: 'completed',
+                    },
+                ],
+            };
+        }
+        // Tool results arrive as `role: 'tool'` messages; keep them (with the
+        // matching toolCallId) so `convertHistoryToDisplayItems` can merge the
+        // result into its tool card.
+        if (isToolResult || role === 'tool') {
+            return {
+                id: `history-toolresult-${index}-${timestampValue}`,
+                role: 'tool',
+                content: rawContent,
+                createdAt,
+                metadata: {
+                    toolCallId,
+                    toolName,
+                },
+            };
+        }
+        // Only hydrate conversational turns in the visible history.
+        // System messages may contain internal prompts and metadata.
+        if (role !== 'user' && role !== 'assistant') {
+            return null;
+        }
+        // A turn a personal agent asked: what the runtime told the application
+        // before the person's words is never shown to them (decided 2026-10-14).
+        return {
+            id: `history-${role}-${index}-${timestampValue}`,
+            role,
+            content: role === 'user' ? askedOf(rawContent) : rawContent,
+            createdAt,
+        };
+    })
+        .filter((m) => m !== null);
+}

package/lib/config/AgentConfiguration.d.ts

@@ -29,7 +29,11 @@ export interface LibraryAgentspec {
     welcomeDocument?: string | null;
     sandboxVariant?: string | null;
     protocol?: string | null;
-    ui?: string | null;
+    /** Its UI plugins, each with the renderer it is exposed through (AGENTIC_UI R8). */
+    ui?: Array<{
+        plugin: string;
+        renderer?: string;
+    }> | null;
     trigger?: Record<string, unknown> | null;
     modelConfig?: Record<string, unknown> | null;
     mcpServerTools?: Array<Record<string, unknown>> | null;