@datalayer/agent-runtimes 1.3.81 → 1.3.83

package/lib/loop/embed/embedTheme.js

@@ -2,46 +2,56 @@
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import { loopAccentStyles, loopFontFamily, loopThemeStyles, scopeThemeCss, THEME_SCOPE_ATTRIBUTE, } from '@datalayer/primer-addons';
+import { getThemeConfig, loopAccentStyles, loopFontFamily, scopeThemeCss, THEME_SCOPE_ATTRIBUTE, } from '@datalayer/primer-addons';
 /** One mode's properties, with the theme's face replaced by the host's. */
-function withFace(styles, font) {
-    if (!font) {
+function withFace(styles, font, own) {
+    if (!font || !own) {
         return styles;
     }
     return Object.fromEntries(Object.entries(styles).map(([name, value]) => [
         name,
-        typeof value === 'string'
-            ? value.split(loopFontFamily).join(font)
-            : value,
+        typeof value === 'string' ? value.split(own).join(font) : value,
     ]));
 }
+/** The face a theme names in a mode: `loop`'s own, or the theme's `fontFamily`. */
+function faceOf(variant, styles) {
+    if (variant === 'loop') {
+        return loopFontFamily;
+    }
+    return typeof styles.fontFamily === 'string' ? styles.fontFamily : '';
+}
+/** The accent over a theme: `loop`'s colours, over `loop` only (T-30). */
+const accentOver = (variant, accent, which) => variant === 'loop' ? loopAccentStyles(accent, which) : {};
 /**
- * The `loop` theme as the embed wears it: the application's accent over it
- * in both modes (T-05), and the host's face when it named one.
+ * The theme as the embed wears it — `loop`, or the one the application
+ * names (T-30) — with the application's accent over `loop` in both modes
+ * (T-05), and the host's face when it named one.
  */
-export function embedThemeStyles({ accent, font = '', }) {
-    const mode = (which) => withFace({
-        ...loopThemeStyles[which],
-        ...loopAccentStyles(accent, which),
-    }, font);
+export function embedThemeStyles({ accent, font = '', variant = 'loop', }) {
+    const base = getThemeConfig(variant).themeStyles;
+    const mode = (which) => {
+        const theme = base[which];
+        return withFace({ ...theme, ...accentOver(variant, accent, which) }, font, faceOf(variant, theme));
+    };
     return {
-        ...loopThemeStyles,
+        ...base,
         light: mode('light'),
         dark: mode('dark'),
     };
 }
 /**
  * The same accent and face laid over the conversation's own theme (T-05,
- * D-11): the chat sets the `loop` theme again inside it, which would put the
- * theme's mint and face back over what the embed set around it. The
- * accent's properties in each mode, and, when the host named a face, every
- * property of the theme that names its own.
+ * D-11): the chat sets its theme again inside it, which would put the
+ * theme's colours and face back over what the embed set around it. The
+ * accent's properties in each mode (over `loop` only), and, when the host
+ * named a face, every property of the theme that names its own.
  */
-export function embedThemeOverrides({ accent, font = '', }) {
+export function embedThemeOverrides({ accent, font = '', variant = 'loop', }) {
+    const base = getThemeConfig(variant).themeStyles;
     const mode = (which) => {
-        const theme = loopThemeStyles[which];
-        const faced = Object.fromEntries(Object.entries(withFace(theme, font)).filter(([name, value]) => typeof value === 'string' && value !== theme[name]));
-        return { ...faced, ...loopAccentStyles(accent, which) };
+        const theme = base[which];
+        const faced = Object.fromEntries(Object.entries(withFace(theme, font, faceOf(variant, theme))).filter(([name, value]) => typeof value === 'string' && value !== theme[name]));
+        return { ...faced, ...accentOver(variant, accent, which) };
     };
     return { light: mode('light'), dark: mode('dark') };
 }

package/lib/loop/index.d.ts

@@ -6,7 +6,7 @@
  *
  * @module loop
  */
-export { LoopCommand, LoopDocumentToolbar, LoopMention, LoopNotebookToolbar, LoopSlots, LoopViewType, canOpenView, createPromptChannel, parseCommand, type CommandArgSpec, type CommandContribution, type CommandResult, type EditorToolbarContext, type EditorToolbarContribution, type LoopCommandContext, type LoopViewProps, type LoopWorkspaceContext, type MentionCandidate, type MentionContribution, type PromptChannel, type SandboxSnapshot, type SandboxState, type ViewControls, type ViewTypeContribution, useLoopPromptStore, suggestLoopPrompt, focusPrompt, onPromptFocusRequest, type LoopPromptState, type SuggestedPrompt, } from './core';
+export { LoopCommand, LoopDocumentToolbar, LoopMention, LoopNotebookToolbar, LoopRunProps, LoopSlots, LoopViewType, canOpenView, createPromptChannel, parseCommand, runForwardedProps, type CommandArgSpec, type CommandContribution, type CommandResult, type EditorToolbarContext, type EditorToolbarContribution, type LoopCommandContext, type LoopViewProps, type LoopWorkspaceContext, type MentionCandidate, type MentionContribution, type PromptChannel, type RunPropsContribution, type SandboxSnapshot, type SandboxState, type ViewControls, type ViewTypeContribution, useLoopPromptStore, suggestLoopPrompt, focusPrompt, onPromptFocusRequest, type LoopPromptState, type SuggestedPrompt, } from './core';
 export { useEditorToolbar } from './core/toolbar';
 export { LoopWorkspace, PluginToggles, ViewSwitcher, WorkspaceFullScreenAction, buildLoopReactor, useWorkspaceFullScreen, type LoopWorkspaceProps, type PluginTogglesProps, type ViewSwitcherProps, } from './shell';
 export { A2uiPlugin, A2UI_PLUGIN_NAME } from './plugins/a2ui';
@@ -67,10 +67,11 @@ export { WindowFrame, WindowFramePlugin, WINDOW_ACTIONS_SLOT, WINDOW_CONTROLS_SL
 export { LoopCommandsPlugin, COMMANDS_PLUGIN_NAME } from './plugins/commands';
 export { PromptPlugin, PROMPT_PLUGIN_NAME } from './plugins/prompt';
 export { LoopEmbed, type LoopEmbedProps } from './embed/LoopEmbed';
-export { AppEmbed, AppFloating, embedAssistantCharacter, type AppEmbedProps, type AppFloatingProps, useHostBridge, } from './embed/AppEmbed';
+export { AppEmbed, AppFloating, embedAssistantCharacter, type AppEmbedProps, type AppFloatingProps, type EmbedSession, useEmbedSession, useHostBridge, } from './embed/AppEmbed';
+export { EMBED_SESSION_KEY_PREFIX, embedSessionKey, visitOfToken, } from './embed/embedSession';
 export { HOST_CONTEXT_TOOL, hostFrontendTools, hostNotAllowed, hostRefused, hostTool, hostToolsOf, type AppEmbedHost, type HostEvent, type HostFunction, type HostQuestion, } from './embed/hostBridge';
 export { defineDatalayerAppElement, type DatalayerAppElementOptions, } from './embed/element';
-export { EMBED_ATTRIBUTES, EMBED_HOST_VARIABLES, EMBED_TAG, embedLookOf, embedSnippetOf, floatingViewOf, type EmbedLook, type EmbedSnippetOptions, } from './embed/embedConfig';
+export { EMBED_ATTRIBUTES, EMBED_HOST_VARIABLES, EMBED_TAG, embedLookOf, embedSnippetOf, floatingViewOf, resumeOf, type EmbedLook, type EmbedSnippetOptions, } from './embed/embedConfig';
 export { SubagentActivityPlugin, SubagentPulse, SUBAGENT_ACTIVITY_PLUGIN_NAME, } from './plugins/subagent-activity';
 export { loopPlugins, type LoopPresetOptions } from './presets';
 export { DocumentExtension, NotebookExtension } from './extensions';

package/lib/loop/index.js

@@ -11,7 +11,7 @@
  * @module loop
  */
 // The contracts. A plugin depends on these and on the reactor, never on the shell.
-export { LoopCommand, LoopDocumentToolbar, LoopMention, LoopNotebookToolbar, LoopSlots, LoopViewType, canOpenView, createPromptChannel, parseCommand, useLoopPromptStore, suggestLoopPrompt, focusPrompt, onPromptFocusRequest, } from './core';
+export { LoopCommand, LoopDocumentToolbar, LoopMention, LoopNotebookToolbar, LoopRunProps, LoopSlots, LoopViewType, canOpenView, createPromptChannel, parseCommand, runForwardedProps, useLoopPromptStore, suggestLoopPrompt, focusPrompt, onPromptFocusRequest, } from './core';
 export { useEditorToolbar } from './core/toolbar';
 // The shell.
 export { LoopWorkspace, PluginToggles, ViewSwitcher, WorkspaceFullScreenAction, buildLoopReactor, useWorkspaceFullScreen, } from './shell';
@@ -87,11 +87,12 @@ export { PromptPlugin, PROMPT_PLUGIN_NAME } from './plugins/prompt';
 export { LoopEmbed } from './embed/LoopEmbed';
 // An application in another product's page: the React component, the
 // `<datalayer-app>` element, and the snippet a host pastes (LOOP D-07 to D-09).
-export { AppEmbed, AppFloating, embedAssistantCharacter, useHostBridge, } from './embed/AppEmbed';
+export { AppEmbed, AppFloating, embedAssistantCharacter, useEmbedSession, useHostBridge, } from './embed/AppEmbed';
+export { EMBED_SESSION_KEY_PREFIX, embedSessionKey, visitOfToken, } from './embed/embedSession';
 // The host page and an embedded application, talking (LOOP D-10).
 export { HOST_CONTEXT_TOOL, hostFrontendTools, hostNotAllowed, hostRefused, hostTool, hostToolsOf, } from './embed/hostBridge';
 export { defineDatalayerAppElement, } from './embed/element';
-export { EMBED_ATTRIBUTES, EMBED_HOST_VARIABLES, EMBED_TAG, embedLookOf, embedSnippetOf, floatingViewOf, } from './embed/embedConfig';
+export { EMBED_ATTRIBUTES, EMBED_HOST_VARIABLES, EMBED_TAG, embedLookOf, embedSnippetOf, floatingViewOf, resumeOf, } from './embed/embedConfig';
 export { SubagentActivityPlugin, SubagentPulse, SUBAGENT_ACTIVITY_PLUGIN_NAME, } from './plugins/subagent-activity';
 // The set a workspace normally has, so a host starts from a working Loop
 // rather than assembling one — and never from the example.

package/lib/loop/plugins/agent-capacity/index.d.ts

@@ -17,7 +17,7 @@
  * @module loop/plugins/agent-capacity
  */
 import { type ReactorPlugin } from '@datalayer/reactor';
-import { type ChatSuggestionItem } from '../../core';
+import { type AgentBlueprintContribution, type ChatSuggestionItem } from '../../core';
 export type AgentCapacityOptions = {
     /** Short slug: `hooks`, `codemode`, … names the plugin `…-agent-<key>`. */
     key: string;
@@ -38,6 +38,8 @@ export type AgentCapacityOptions = {
     instructions?: string;
     /** The model it runs on in the page, in place of its spec's. */
     model?: string;
+    /** What its modes tell a run turned in the page (LOOP P-19). */
+    modeEffect?: AgentBlueprintContribution['modeEffect'];
 };
 export declare function defineAgentCapacityPlugin(options: AgentCapacityOptions): ReactorPlugin<Record<string, never>, unknown, unknown>;
 export default defineAgentCapacityPlugin;

package/lib/loop/plugins/agent-capacity/index.js

@@ -23,7 +23,7 @@
 import { contribution, definePlugin, } from '@datalayer/reactor';
 import { LoopAgentBlueprint, LoopChatSuggestion, } from '../../core';
 export function defineAgentCapacityPlugin(options) {
-    const { key, displayName, description, specId, octicon, emoji, codemode, createPayload, suggestions, instructions, model, } = options;
+    const { key, displayName, description, specId, octicon, emoji, codemode, createPayload, suggestions, instructions, model, modeEffect, } = options;
     return definePlugin({
         name: `@datalayer/loop-plugin-agent-${key}`,
         displayName,
@@ -42,6 +42,7 @@ export function defineAgentCapacityPlugin(options) {
                 },
                 ...(instructions ? { instructions } : {}),
                 ...(model ? { model } : {}),
+                ...(modeEffect ? { modeEffect } : {}),
             }, { id: key }),
             ...(suggestions && suggestions.length > 0
                 ? [

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

@@ -23,7 +23,7 @@
  *
  * @module loop/plugins/app-page/appPageModel
  */
-import type { AppSettingSpec, AppSpec } from '../../../types/agentspecs';
+import type { AppFormField, AppFormSchema, AppSpec } from '../../../types/agentspecs';
 import type { ChatTurnSnapshot, ConversationEntry } from '../../core';
 /** The id of the editor surface an application's page is drawn in. */
 export declare const APP_PAGE_SURFACE = "app-page";
@@ -77,6 +77,15 @@ export declare const APP_KIND_PATHS: Record<AppPageKind, AppKindPaths>;
 export declare const isAppPageKind: (kind: string) => kind is AppPageKind;
 /** The path a setting, an input of the page, is kept at. */
 export declare const inputPath: (id: string) => string;
+/**
+ * The fields of an application's settings (C-16), by name, in the order its
+ * form says them; none when it has no settings.
+ */
+export declare function settingFields(settings: AppFormSchema | undefined): Array<[string, AppFormField]>;
+/** A setting as a person reads it: its field's `title`, else its name. */
+export declare const settingTitle: (id: string, field: AppFormField) => string;
+/** What each setting starts at: its field's `default`, for those that say one. */
+export declare function settingDefaults(settings: AppFormSchema | undefined): Record<string, unknown>;
 /**
  * What an application publishes and takes, with its own settings: the kind's
  * list, and for a kind that has inputs each setting at `/inputs/<id>`, both
@@ -95,8 +104,6 @@ export declare function hasAppPage(app: Pick<AppSpec, 'kind' | 'interface' | 'ag
  * none): the application's layout is `chat`, the conversation alone.
  */
 export declare function surfaceUnshown(app: Pick<AppSpec, 'kind' | 'interface' | 'agent'>): string | null;
-/** A setting's first value, as its input holds it. */
-export declare function initialInput(setting: AppSettingSpec): unknown;
 /**
  * What the conversation publishes to the page, by path, now: from its
  * current turn, and for a chat its whole conversation.
@@ -136,8 +143,10 @@ export declare function givenFiles(files: unknown): {
 };
 /**
  * The application's settings as the page holds them, as the session API
- * takes them: a choice as the option chosen, a number as a number, a toggle
- * as on or off — each setting the page has a value for.
+ * takes them, each as its field's type says (C-16): a number as a number, a
+ * boolean as on or off, a word as the option chosen — a ChoicePicker holds a
+ * list of them — each setting the page has a value for. The runtime checks
+ * them against the settings' form.
  */
 export declare function settingsOf(app: Pick<AppSpec, 'interface'>, inputs: unknown): Record<string, unknown>;
 /**

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

@@ -141,6 +141,25 @@ export const APP_KIND_PATHS = {
 export const isAppPageKind = (kind) => Object.prototype.hasOwnProperty.call(APP_KIND_PATHS, kind);
 /** The path a setting, an input of the page, is kept at. */
 export const inputPath = (id) => `/inputs/${id}`;
+/**
+ * The fields of an application's settings (C-16), by name, in the order its
+ * form says them; none when it has no settings.
+ */
+export function settingFields(settings) {
+    const properties = settings?.properties;
+    if (!properties || typeof properties !== 'object') {
+        return [];
+    }
+    return Object.entries(properties).filter((entry) => typeof entry[1] === 'object' && entry[1] !== null);
+}
+/** A setting as a person reads it: its field's `title`, else its name. */
+export const settingTitle = (id, field) => typeof field.title === 'string' && field.title ? field.title : id;
+/** What each setting starts at: its field's `default`, for those that say one. */
+export function settingDefaults(settings) {
+    return Object.fromEntries(settingFields(settings)
+        .filter(([, field]) => field.default !== undefined)
+        .map(([id, field]) => [id, field.default]));
+}
 /**
  * What an application publishes and takes, with its own settings: the kind's
  * list, and for a kind that has inputs each setting at `/inputs/<id>`, both
@@ -154,10 +173,10 @@ export function appKindPaths(app) {
     if (!kind.inputs) {
         return kind;
     }
-    const inputs = app.interface.settings.map(setting => ({
-        path: inputPath(setting.id),
-        meaning: `The setting “${setting.label || setting.id}”.`,
-        words: setting.label || setting.id,
+    const inputs = settingFields(app.interface.settings).map(([id, field]) => ({
+        path: inputPath(id),
+        meaning: `The setting “${settingTitle(id, field)}”.`,
+        words: settingTitle(id, field),
     }));
     return {
         ...kind,
@@ -199,24 +218,6 @@ const STATUS_WORDS = {
     done: 'Answered',
     error: 'Stopped',
 };
-/** A setting's first value, as its input holds it. */
-export function initialInput(setting) {
-    switch (setting.type) {
-        case 'toggle':
-            return Boolean(setting.default ?? false);
-        case 'select':
-            // A ChoicePicker holds a list of the values chosen.
-            return setting.default === undefined ? [] : [String(setting.default)];
-        case 'slider':
-            return Number(setting.default ?? setting.min ?? 0);
-        case 'number':
-            return setting.max === undefined
-                ? String(setting.default ?? '')
-                : Number(setting.default ?? setting.min ?? 0);
-        default:
-            return String(setting.default ?? '');
-    }
-}
 /**
  * What the conversation publishes to the page, by path, now: from its
  * current turn, and for a chat its whole conversation.
@@ -253,10 +254,20 @@ export function appPageInitialData(app) {
     }
     const paths = appKindPaths(app);
     if (paths.inputs) {
-        tree.inputs = Object.fromEntries(app.interface.settings.map(setting => [
-            setting.id,
-            initialInput(setting),
-        ]));
+        // Each setting at its default, as the settings' form holds it; a
+        // ChoicePicker a builder placed at a setting holds a list of the values
+        // chosen.
+        const inputs = settingDefaults(app.interface.settings);
+        for (const node of app.interface.surface?.components ?? []) {
+            const bound = node.value?.path;
+            const id = typeof bound === 'string' && bound.startsWith('/inputs/')
+                ? bound.slice('/inputs/'.length)
+                : undefined;
+            if (node.component === 'ChoicePicker' && id && id in inputs) {
+                inputs[id] = Array.isArray(inputs[id]) ? inputs[id] : [inputs[id]];
+            }
+        }
+        tree.inputs = inputs;
     }
     if (paths.accepts.some(entry => entry.path === DRAFT.path)) {
         tree.draft = '';
@@ -289,9 +300,9 @@ export function inputsInWords(app, inputs) {
         : {};
     const lines = [];
     const seen = new Set();
-    for (const setting of app.interface.settings) {
-        seen.add(setting.id);
-        lines.push(inputWords(setting.label || setting.id, values[setting.id]));
+    for (const [id, field] of settingFields(app.interface.settings)) {
+        seen.add(id);
+        lines.push(inputWords(settingTitle(id, field), values[id]));
     }
     for (const [id, value] of Object.entries(values)) {
         if (!seen.has(id)) {
@@ -345,38 +356,43 @@ export function givenFiles(files) {
 }
 /**
  * The application's settings as the page holds them, as the session API
- * takes them: a choice as the option chosen, a number as a number, a toggle
- * as on or off — each setting the page has a value for.
+ * takes them, each as its field's type says (C-16): a number as a number, a
+ * boolean as on or off, a word as the option chosen — a ChoicePicker holds a
+ * list of them — each setting the page has a value for. The runtime checks
+ * them against the settings' form.
  */
 export function settingsOf(app, inputs) {
     const values = inputs && typeof inputs === 'object'
         ? inputs
         : {};
     const settings = {};
-    for (const setting of app.interface.settings) {
-        const value = values[setting.id];
+    for (const [id, field] of settingFields(app.interface.settings)) {
+        const held = values[id];
+        if (held === undefined || held === null) {
+            continue;
+        }
+        if (field.type === 'array' || field.type === 'object') {
+            settings[id] = held;
+            continue;
+        }
+        const value = Array.isArray(held) ? held[0] : held;
         if (value === undefined || value === null) {
             continue;
         }
-        switch (setting.type) {
-            case 'select': {
-                const chosen = Array.isArray(value) ? value[0] : value;
-                if (chosen !== undefined && chosen !== '') {
-                    settings[setting.id] = String(chosen);
-                }
-                break;
-            }
-            case 'toggle':
-                settings[setting.id] = Boolean(value);
-                break;
-            case 'slider':
+        switch (field.type) {
+            case 'integer':
             case 'number':
                 if (value !== '' && !Number.isNaN(Number(value))) {
-                    settings[setting.id] = Number(value);
+                    settings[id] = Number(value);
                 }
                 break;
+            case 'boolean':
+                settings[id] = Boolean(value);
+                break;
             default:
-                settings[setting.id] = String(value);
+                if (value !== '' || !Array.isArray(field.enum)) {
+                    settings[id] = typeof value === 'string' ? value : String(value);
+                }
         }
     }
     return settings;
@@ -464,44 +480,22 @@ const button = (id, label, name, primary = false) => [
     },
     { id: `${id}-label`, component: 'Text', text: label },
 ];
-/** A setting as the input of the catalog that holds its value. */
-function settingInput(setting) {
-    const base = {
-        id: `input-${setting.id}`,
-        label: setting.label || setting.id,
-        value: { path: inputPath(setting.id) },
-    };
-    switch (setting.type) {
-        case 'toggle':
-            return { ...base, component: 'CheckBox' };
-        case 'select':
-            return {
-                ...base,
-                component: 'ChoicePicker',
-                options: setting.options.map(option => ({
-                    label: option,
-                    value: option,
-                })),
-            };
-        case 'slider':
-            return {
-                ...base,
-                component: 'Slider',
-                min: setting.min ?? 0,
-                max: setting.max ?? 100,
-            };
-        case 'number':
-            return setting.max === undefined
-                ? { ...base, component: 'TextField', variant: 'number' }
-                : {
-                    ...base,
-                    component: 'Slider',
-                    min: setting.min ?? 0,
-                    max: setting.max,
-                };
-        default:
-            return { ...base, component: 'TextField' };
-    }
+/**
+ * The settings as one Form block (C-16): their form drawn with
+ * `@datalayer/primer-rjsf`, the values written at `/inputs` as they are
+ * filled — no action, no button: they go with the next run.
+ */
+function settingsForm(app) {
+    return app.interface.settings && settingFields(app.interface.settings).length
+        ? [
+            {
+                id: 'settings',
+                component: 'Form',
+                schema: app.interface.settings,
+                values: { path: '/inputs' },
+            },
+        ]
+        : [];
 }
 /**
  * The page drawn when the application has a page layout and no surface
@@ -509,9 +503,7 @@ function settingInput(setting) {
  * buttons its kind handles that the conversation does not already give.
  */
 export function defaultAppSurface(app) {
-    const inputs = appKindPaths(app).inputs
-        ? app.interface.settings.map(settingInput)
-        : [];
+    const inputs = appKindPaths(app).inputs ? settingsForm(app) : [];
     const body = [];
     switch (app.kind) {
         case 'chat':

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

@@ -41,7 +41,7 @@ import { AGENTS_PLUGIN_NAME } from '../agents/plugin';
 import { useConfig } from '../../../hooks/useConfig';
 import { useSkills, useSkillActions } from '../../../hooks/useSkills';
 import { AI_MODEL_CATALOGUE, isChatModel } from '../../../specs/models';
-import { LoopAgentBlueprint, LoopAgentGate, LoopChatComposer, LoopChatExtras, LoopChatHeader, LoopChatLayout, LoopChatSuggestion, LoopChatSurface, LoopChatTurn, LoopFrontendTool, LoopSlots, canOpenView, onPromptFocusRequest, onSurfaceRequest, useLoopPromptStore, } from '../../core';
+import { LoopAgentBlueprint, LoopAgentGate, LoopChatComposer, LoopChatExtras, LoopChatHeader, LoopChatLayout, LoopChatSuggestion, LoopChatSurface, LoopChatTurn, LoopCommand, LoopFrontendTool, LoopRunProps, LoopSlots, canOpenView, runForwardedProps, onPromptFocusRequest, onSurfaceRequest, useLoopPromptStore, } from '../../core';
 import { messageText, turnWritersOf } from './turnState';
 import { isInactiveSurfaceContribution, orderToolContributions, toolsForChatView, } from './chatViewTools';
 import { useAgentCommandTools } from '../../../tools/adapters/commands';
@@ -353,6 +353,10 @@ export default function ChatView({ workspace }) {
     const heldForAdapter = useRef([]);
     /** Whether the agent is turned in this page: read by `sendNow`, set below. */
     const inPageRef = useRef(false);
+    /** What goes with every run (an application's modes, LOOP P-19), read when it is sent. */
+    const runProps = useContributions(LoopRunProps);
+    const runPropsRef = useRef(runProps);
+    runPropsRef.current = runProps;
     /*
      * Every message that goes to the agent goes through here: the composer's
      * (through the workspace's dispatch and the prompt channel), a host's, and
@@ -362,13 +366,17 @@ export default function ChatView({ workspace }) {
      * What the page did besides the message goes with it as AG-UI's
      * `forwardedProps` (`loop`, LOOP R-04): the application's session takes a
      * file there. An agent turned in this page has no session, and no file is
-     * handed to it: said, rather than dropped.
+     * handed to it: said, rather than dropped. What the workspace's plugins
+     * send with every run (`LoopRunProps`: the modes the person is in, LOOP
+     * P-19) goes under it — and an agent turned in this page applies the modes
+     * itself (`modeEffect`, `BrowserAgentAdapter`).
      */
-    const sendNow = useCallback((message, forwardedProps) => {
-        const loop = forwardedProps?.loop;
+    const sendNow = useCallback((message, given) => {
+        const loop = given?.loop;
         if (inPageRef.current && loop?.files && loop.files.length > 0) {
             return 'A file is given to an application running on a runtime: run it on Datalayer or on your machine to give it one.';
         }
+        const forwardedProps = runForwardedProps(runPropsRef.current.map(entry => entry.value), given);
         // A new turn: whatever the panel showed is gone, this message is it.
         turnFeedRef.current?.begin(message, controlsRef.current?.thread());
         const send = controlsRef.current?.send;
@@ -936,6 +944,18 @@ export default function ChatView({ workspace }) {
      * silent no-ops. Derived here rather than in the plugin because it changes
      * with the selected member.
      */
+    /*
+     * The commands the composer lists while `/` is typed: those contributed for
+     * it, an application's (LOOP P-19). Picking one writes `/<name> `, and the
+     * workspace runs it when the message is sent.
+     */
+    const commands = useContributions(LoopCommand);
+    const composerCommands = useMemo(() => commands
+        .filter(entry => entry.value.composer)
+        .map(entry => ({
+        name: entry.value.name,
+        description: entry.value.description,
+    })), [commands]);
     const mentionable = useMemo(() => {
         if (!team || !member) {
             // No team: the spec's own subagents, which the in-page loop can reach
@@ -1175,6 +1195,10 @@ export default function ChatView({ workspace }) {
             // server's monitoring stream fills, so the side panel and the
             // composer's pulse draw an in-page delegation like any other.
             onSubagentEvent: event => agentRuntimeStore.getState().appendSubagentEvent(event),
+            // An application's modes (LOOP P-19): the options sent with a
+            // run tell it their instructions, on the model one names, as
+            // its session API does on a runtime.
+            modeEffect: blueprintTurn?.modeEffect,
         })
         : {
             type: 'ag-ui',
@@ -1402,6 +1426,7 @@ export default function ChatView({ workspace }) {
         // because focusing an input on mount scrolls the browser to it.
         autoFocus: config?.autoFocusPrompt ?? true,
         mentionableAgents: mentionable,
+        promptCommands: composerCommands,
         headerContent: inpromptMenu.length > 0 ? (_jsx(ReactorSlot, { slot: LoopSlots.inpromptMenu, props: { workspace } })) : undefined,
         footerExtras: promptActions.length > 0 ? (_jsx(ReactorSlot, { slot: LoopSlots.promptAction, props: { workspace } })) : undefined,
         /*
@@ -1531,6 +1556,8 @@ export default function ChatView({ workspace }) {
                     , { 
                         // The theme it wears, when the host names one (an application's).
                         themeVariant: config?.themeVariant, themeOverrides: config?.themeOverrides, colorMode: config?.colorMode, 
+                        // The session an embed goes on with after a reload (LOOP D-13).
+                        thread: config?.thread, 
                         // 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.

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

@@ -1,6 +1,6 @@
 import type { PresenceState } from '../../../chat/presence/presenceStatus';
 import type { AssistantSaying } from '../../../chat/assistant/state';
-import type { ThemeOverrides } from '../../../types/chat';
+import type { ResumedThread, ThemeOverrides } from '../../../types/chat';
 /** What a host may set on the chat. */
 /** Who is answering, as the person meets them. */
 export interface ChatPresence {
@@ -62,6 +62,11 @@ export type ChatPluginConfig = {
      * application sets its own.
      */
     presence?: ChatPresence;
+    /**
+     * The conversation to go on with (LOOP D-13): an embedded application's
+     * session, reattached after its page reloaded, and what it holds.
+     */
+    thread?: ResumedThread;
     /**
      * Whether the counters — tokens, context — are shown under the prompt.
      * On unless said: a person using an application is not asking.

package/lib/loop/presets.d.ts

@@ -23,7 +23,7 @@ import { type PluginRef } from '@datalayer/reactor';
 import { type AgentsConfig, type SandboxTarget } from './plugins/agents';
 import { type ChatPluginConfig, type ChatPresence } from './plugins/chat';
 import { type PageSize } from './plugins/page-layout';
-import type { ThemeOverrides } from '../types/chat';
+import type { ResumedThread, ThemeOverrides } from '../types/chat';
 export type LoopPresetOptions = {
     /** Where the agent runtimes service is. */
     serverUrl?: string;
@@ -155,6 +155,8 @@ export type LoopPresetOptions = {
     presence?: ChatPresence;
     /** Whether the counters are shown under the prompt; on unless said. */
     showTokenUsage?: boolean;
+    /** The conversation to go on with: an embed's session after a reload (LOOP D-13). */
+    thread?: ResumedThread;
     /**
      * The agentspec the local agent is created from, by id.
      *

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, datalayerVisitors, datalayerKept, embedToken, 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 { 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, datalayerVisitors, datalayerKept, embedToken, targetFixed, themeVariant, themeOverrides, colorMode, presence, showTokenUsage, thread, 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.
@@ -89,6 +89,7 @@ export function loopPlugins(options = {}) {
             colorMode,
             presence,
             showTokenUsage,
+            ...(thread ? { thread } : {}),
         }),
         // The composer and the title bar are plugins of their own: the chat
         // assembles their props, these render them. In the preset by default —

package/lib/loop/shell/LoopWorkspace.js

@@ -91,8 +91,11 @@ function WorkspaceBody({ serverUrl, agentId: initialAgentId, conversationId, mod
             workspace: currentWorkspace.current,
             argv: command.argv,
         });
+        // What a command sends goes to the agent as if typed: an
+        // application's command sends its prompt (LOOP P-19).
         if (result?.prompt) {
             onSend?.(result.prompt, currentWorkspace.current);
+            prompts.submit(result.prompt);
         }
         return {
             handled: true,