@datalayer/agent-runtimes 1.3.82 → 1.3.84

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,24 @@ 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,
+                // Drawn with the inputs its uiSchema names (P-20).
+                ...(app.interface.settingsUi ? { ui: app.interface.settingsUi } : {}),
+                values: { path: '/inputs' },
+            },
+        ]
+        : [];
 }
 /**
  * The page drawn when the application has a page layout and no surface
@@ -509,9 +505,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

@@ -372,11 +372,12 @@ export default function ChatView({ workspace }) {
      * itself (`modeEffect`, `BrowserAgentAdapter`).
      */
     const sendNow = useCallback((message, given) => {
-        const loop = given?.loop;
+        const forwardedProps = runForwardedProps(runPropsRef.current.map(entry => entry.value), given);
+        // The page's files, or those attached in the composer (LOOP P-21).
+        const loop = forwardedProps?.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;
@@ -752,6 +753,7 @@ export default function ChatView({ workspace }) {
     const suggestionEntries = useContributions(LoopChatSuggestion);
     const hiddenOpeners = chatExtras.hiddenOpeners;
     const hideOpeners = chatExtras.hideOpeners;
+    const liveOpeners = chatExtras.openers;
     const suggestions = useMemo(() => {
         if (hideOpeners) {
             return [];
@@ -760,6 +762,11 @@ export default function ChatView({ workspace }) {
         // the two-group merge below uses to tell openers apart.
         const hidden = new Set(hiddenOpeners ?? []);
         const offered = (items) => hidden.size === 0 ? items : items.filter(item => !hidden.has(item.text));
+        // What a plugin offers live (an application's profile's starters,
+        // LOOP P-20) wins over what was contributed when the reactor was built.
+        if (liveOpeners) {
+            return offered(liveOpeners);
+        }
         const contributed = suggestionEntries.flatMap(entry => entry.value.suggestions);
         if (contributed.length > 0) {
             return offered(contributed);
@@ -788,6 +795,7 @@ export default function ChatView({ workspace }) {
         agentId,
         hiddenOpeners,
         hideOpeners,
+        liveOpeners,
     ]);
     /*
      * The same openers in the shape the chat's empty state asks for.

package/lib/protocols/BrowserAgentAdapter.d.ts

@@ -70,7 +70,7 @@ export interface BrowserAgentAdapterConfig extends ProtocolAdapterConfig, Fronte
      * rules. Unsaid for an agent with no modes, which refuses a run sent in
      * some.
      */
-    modeEffect?: (chosen: Record<string, string>) => AppModeEffect;
+    modeEffect?: (chosen: Record<string, string>, profile?: string) => AppModeEffect;
 }
 /**
  * An agent loop running in the page, speaking the protocol adapter interface.
@@ -120,12 +120,14 @@ export declare class BrowserAgentAdapter extends BaseProtocolAdapter {
      */
     private resolveModel;
     /**
-     * What the modes a run is sent in tell it, and the model it runs on (LOOP
-     * P-19) — the runtime's session API applies the same, for that run only.
+     * What the modes a run is sent in, and the profile its conversation is
+     * with, tell it, and the model it runs on (LOOP P-19, P-20) — the
+     * runtime's session API applies the same, for that run only.
      *
-     * Refused, in a sentence, rather than run without them: modes sent to an
-     * agent that has none, modes that are not the application's, and a mode
-     * naming a model for an agent whose model is the host's own.
+     * Refused, in a sentence, rather than run without them: modes or a profile
+     * sent to an agent that has none, modes or a profile that are not the
+     * application's, and a model chosen for an agent whose model is the host's
+     * own.
      */
     private runModes;
     /**

package/lib/protocols/BrowserAgentAdapter.js

@@ -141,26 +141,29 @@ export class BrowserAgentAdapter extends BaseProtocolAdapter {
         return createBrowserModel({ ...inference, model: requested || model });
     }
     /**
-     * What the modes a run is sent in tell it, and the model it runs on (LOOP
-     * P-19) — the runtime's session API applies the same, for that run only.
+     * What the modes a run is sent in, and the profile its conversation is
+     * with, tell it, and the model it runs on (LOOP P-19, P-20) — the
+     * runtime's session API applies the same, for that run only.
      *
-     * Refused, in a sentence, rather than run without them: modes sent to an
-     * agent that has none, modes that are not the application's, and a mode
-     * naming a model for an agent whose model is the host's own.
+     * Refused, in a sentence, rather than run without them: modes or a profile
+     * sent to an agent that has none, modes or a profile that are not the
+     * application's, and a model chosen for an agent whose model is the host's
+     * own.
      */
     runModes(forwardedProps) {
         const loop = forwardedProps?.loop;
-        const chosen = loop?.modes;
-        if (!chosen || Object.keys(chosen).length === 0) {
+        const chosen = loop?.modes ?? {};
+        const profile = loop?.profile || undefined;
+        if (Object.keys(chosen).length === 0 && !profile) {
             return undefined;
         }
         const { modeEffect, languageModel } = this.browserConfig;
         if (!modeEffect) {
-            throw new Error('This agent has no modes: the options chosen in the composer cannot be applied to it.');
+            throw new Error('This agent has no modes or profiles: what was chosen in the composer cannot be applied to it.');
         }
-        const effect = modeEffect(chosen);
+        const effect = modeEffect(chosen, profile);
         if (effect.model && languageModel) {
-            throw new Error(`The mode chosen runs on ${effect.model}, and this agent's model is its host's own: it cannot run on another.`);
+            throw new Error(`The mode or profile chosen runs on ${effect.model}, and this agent's model is its host's own: it cannot run on another.`);
         }
         return effect;
     }

package/lib/runtimes/browser/protocol.d.ts

@@ -39,7 +39,7 @@ export type BrowserProtocolOptions = {
     /** Told what a delegated run does, as it does it — see `subagentTools`. */
     onSubagentEvent?: (event: AgentStreamSubagentPayload) => void;
     /** What the modes a run is sent in tell it (LOOP P-19); none when unsaid. */
-    modeEffect?: (chosen: Record<string, string>) => AppModeEffect;
+    modeEffect?: (chosen: Record<string, string>, profile?: string) => AppModeEffect;
 };
 /**
  * The protocol config for an agent whose loop runs in this page.

package/lib/specs/agents/agents.js

@@ -4900,8 +4900,9 @@ export const JUPYTER_DATA_ANALYST_AGENTSPEC_0_0_1 = {
         'collaboration',
     ],
     domain: undefined,
-    enabled: false,
+    enabled: true,
     model: 'bedrock:us.anthropic.claude-sonnet-4-6',
+    modelAdditionals: ['alibaba:qwen-max'],
     mcpServers: [],
     skills: [].filter(Boolean),
     backendTools: [TOOL_MAP['runtime-echo:0.0.1']],
@@ -7966,8 +7967,9 @@ export const WORKER_CUSTOMER_INTERVIEWER_AGENTSPEC_0_0_1 = {
     description: `Conducts adaptive, AI-led interviews that respond intelligently to each answer. It asks relevant follow-up questions, uncovers motivations and decision-making patterns, and transforms conversations into structured, actionable insights.`,
     tags: ['research', 'customer-support', 'analysis'],
     domain: 'market-analyst',
-    enabled: false,
+    enabled: true,
     model: 'bedrock:us.anthropic.claude-sonnet-4-6',
+    modelAdditionals: ['alibaba:qwen-max'],
     mcpServers: [],
     skills: [
         SKILL_MAP['text-summarizer:0.0.1']
@@ -8249,8 +8251,9 @@ export const WORKER_DOCUMENT_QA_AGENTSPEC_0_0_1 = {
         'qa',
     ],
     domain: 'personal-assistant',
-    enabled: false,
+    enabled: true,
     model: 'bedrock:us.anthropic.claude-sonnet-4-6',
+    modelAdditionals: ['alibaba:qwen-max'],
     mcpServers: [],
     skills: [
         SKILL_MAP['events:0.0.1']