@datalayer/agent-runtimes 1.5.16 → 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/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;