@datalayer/agent-runtimes 1.3.82 → 1.3.83

package/lib/components/a2ui/datalayer/Form.js

@@ -12,6 +12,11 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * its action is dispatched, so the action's context reads them. A form the
  * schema refuses says why beside each field and sends nothing.
  *
+ * A form without an action is a set of settings (C-16) — an application's
+ * `interface.settings` drawn beside its conversation: no button, its values
+ * written where `values` points as they are filled, for the next run to take;
+ * the runtime checks them against the same schema.
+ *
  * @module components/a2ui/datalayer/Form
  */
 import { useEffect, useMemo, useState } from 'react';
@@ -34,11 +39,23 @@ export function FormView({ props }) {
     useEffect(() => {
         setLocal(JSON.parse(shownKey));
     }, [shownKey]);
-    const uiSchema = useMemo(() => ({ 'ui:submitButtonOptions': { submitText: submitLabel } }), [submitLabel]);
+    // Without an action, nothing is sent: no button, the values written as filled.
+    const live = action === undefined;
+    const uiSchema = useMemo(() => ({
+        'ui:submitButtonOptions': live
+            ? { norender: true }
+            : { submitText: submitLabel },
+    }), [live, submitLabel]);
     const problem = schema.type !== undefined && schema.type !== 'object'
         ? 'Its fields are not an object schema: a form asks for several named values.'
         : null;
-    return (_jsx(BlockFrame, { title: title, label: "Form", weight: props.weight, testId: "a2ui-form", children: problem ? (_jsx(Problem, { children: problem })) : (_jsx(SchemaForm, { schema: schema, uiSchema: uiSchema, formData: values, validator: validator, liveValidate: touched, onBlur: () => setTouched(true), onError: () => setTouched(true), showErrorList: false, onChange: event => setLocal((event.formData ?? {})), onSubmit: event => {
+    return (_jsx(BlockFrame, { title: title, label: "Form", weight: props.weight, testId: "a2ui-form", children: problem ? (_jsx(Problem, { children: problem })) : (_jsx(SchemaForm, { schema: schema, uiSchema: uiSchema, formData: values, validator: validator, liveValidate: touched, onBlur: () => setTouched(true), onError: () => setTouched(true), showErrorList: false, onChange: event => {
+                const filled = (event.formData ?? {});
+                setLocal(filled);
+                if (live) {
+                    setValues(filled);
+                }
+            }, onSubmit: event => {
                 setValues((event.formData ?? {}));
                 action?.();
             } })) }));

package/lib/loop/apps/appspec.js

@@ -124,7 +124,6 @@ export function emptyAppspec(kind = 'chat') {
             starters: [],
             commands: [],
             modes: [],
-            settings: [],
             components: [],
             outputs: [],
         },
@@ -148,6 +147,7 @@ export function emptyAppspec(kind = 'chat') {
         notifications: [],
         setup: [],
         enabled: true,
+        unavailable_because: '',
         tags: [],
         icon: DEFAULT_ICON,
         emoji: DEFAULT_EMOJI,
@@ -186,6 +186,7 @@ const KNOWN_KEYS = [
     'notifications',
     'decision',
     'enabled',
+    'unavailable_because',
     'tags',
     'icon',
     'emoji',
@@ -242,24 +243,6 @@ function parseMode(data) {
     }
     return mode;
 }
-function parseSetting(data) {
-    const setting = {
-        id: text(data.id),
-        type: oneOf(data.type, ['select', 'text', 'toggle', 'slider', 'number'], 'text'),
-        label: text(data.label),
-        options: texts(data.options),
-    };
-    if (['string', 'boolean', 'number'].includes(typeof data.default)) {
-        setting.default = data.default;
-    }
-    if (typeof data.min === 'number') {
-        setting.min = data.min;
-    }
-    if (typeof data.max === 'number') {
-        setting.max = data.max;
-    }
-    return setting;
-}
 function parseSurface(data) {
     return {
         protocol: text(data.protocol, DEFAULT_PROTOCOL),
@@ -300,11 +283,16 @@ function parseInterface(data, kind) {
         })),
         commands: records(data.commands).map(parseCommand),
         modes: records(data.modes).map(parseMode),
-        settings: records(data.settings).map(parseSetting),
         components: texts(data.components),
         voice: parseVoice(data.voice),
         outputs: texts(data.outputs),
     };
+    // Its settings are the JSON Schema of a form (C-16), kept as written: what
+    // is not one — the list of settings of earlier versions among it — is not
+    // read, and is said by the checks.
+    if (isData(data.settings)) {
+        parsed.settings = JSON.parse(JSON.stringify(data.settings));
+    }
     if (isData(data.surface)) {
         parsed.surface = parseSurface(data.surface);
     }
@@ -495,6 +483,7 @@ export function parseAppspec(document) {
         memory: text(data.memory),
         notifications: texts(data.notifications),
         enabled: flag(data.enabled, true),
+        unavailable_because: text(data.unavailable_because),
         tags: texts(data.tags),
         icon: text(data.icon, DEFAULT_ICON),
         emoji: text(data.emoji, DEFAULT_EMOJI) || DEFAULT_EMOJI,
@@ -598,19 +587,7 @@ function dumpInterface(spec, kind) {
         }
         return written.data;
     }))
-        .list('settings', spec.settings.map(setting => {
-        const written = new Writer()
-            .text('id', setting.id, '\u0000')
-            .text('type', setting.type, '\u0000')
-            .text('label', setting.label, '\u0000')
-            .list('options', setting.options);
-        for (const key of ['default', 'min', 'max']) {
-            if (setting[key] !== undefined) {
-                written.data[key] = setting[key];
-            }
-        }
-        return written.data;
-    }))
+        .part('settings', spec.settings ? { ...spec.settings } : {})
         .list('components', spec.components);
     if (spec.surface) {
         writer.data.surface = dumpSurface(spec.surface);
@@ -765,6 +742,7 @@ export function dumpAppspec(app) {
     }
     writer
         .value('enabled', app.enabled, true)
+        .text('unavailable_because', app.unavailable_because)
         .list('tags', app.tags)
         .text('icon', app.icon ?? DEFAULT_ICON, DEFAULT_ICON)
         .text('emoji', app.emoji, DEFAULT_EMOJI)

package/lib/loop/apps/checks.js

@@ -95,6 +95,14 @@ function shapeProblems(app) {
     if (Boolean(app.agent) === Boolean(app.team)) {
         problems.push('An application names who does the work: an `agent`, or a `team`, and not both.');
     }
+    // agentspecs refuses either way round (LOOP E-01): off says why, on says nothing.
+    const because = (app.unavailable_because ?? '').trim();
+    if (!app.enabled && !because) {
+        problems.push('An application that is not offered says why, under `unavailable_because`.');
+    }
+    if (app.enabled && because) {
+        problems.push('An application offered today is available: remove `unavailable_because`, or set `enabled: false`.');
+    }
     if (app.kind === 'decision' && !app.decision) {
         problems.push('A decision application says what it decides, under `decision`.');
     }
@@ -472,7 +480,6 @@ const ENUMS = {
     behaviour: ['do_it', 'if_asked', 'ask_first', 'leave_to_me'],
     layout: ['chat', 'page', 'split'],
     accent: ['green', 'rose', 'sky', 'lime', 'sun', 'violet'],
-    settingType: ['select', 'text', 'toggle', 'slider', 'number'],
     record: [
         'conversations',
         'actions',
@@ -721,13 +728,16 @@ export function documentShapeProblems(document) {
         if (choosingModel.length > 1) {
             at('interface.modes', `let only one mode choose the model, not ${choosingModel.join(', ')}`);
         }
-        records(ui.settings, 'interface.settings', (item, where) => {
-            required(item, 'id', where);
-            required(item, 'type', where);
-            required(item, 'label', where);
-            oneOf(item.type, ENUMS.settingType, `${where}.type`);
-            texts(item.options, `${where}.options`);
-        });
+        // Its settings are the JSON Schema of a form (C-16), checked as a Form's
+        // schema is; the list of settings of earlier versions is refused.
+        if (Array.isArray(ui.settings)) {
+            at('interface.settings', 'is the JSON Schema of a form, an object of named fields (LOOP C-16), not a list of settings: say each one as a property, its title and its default');
+        }
+        else {
+            mapping(ui.settings, 'interface.settings', settings => {
+                problems.push(...formProblems({ id: 'settings', schema: settings }));
+            });
+        }
         mapping(ui.surface, 'interface.surface', surface => {
             records(surface.components, 'interface.surface.components', (item, where) => {
                 required(item, 'id', where);

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/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']