@datalayer/agent-runtimes 1.3.82 → 1.3.83

package/lib/specs/appspecSchema.js

@@ -339,12 +339,18 @@ export const APPSPEC_SCHEMA = {
                     type: 'array',
                 },
                 settings: {
-                    description: 'What the user may set',
-                    items: {
-                        $ref: '#/$defs/AppSetting',
-                    },
+                    anyOf: [
+                        {
+                            additionalProperties: true,
+                            type: 'object',
+                        },
+                        {
+                            type: 'null',
+                        },
+                    ],
+                    default: null,
+                    description: "What the user may set: the JSON Schema of a form, an object of named fields, each with its `title` and its `default` (LOOP C-16). Drawn with `@datalayer/primer-rjsf` beside the conversation and on a deployment's Ship card, its values go with every run and are checked by the runtime against the same schema. None when unsaid",
                     title: 'Settings',
-                    type: 'array',
                 },
                 components: {
                     description: "The components of the catalog the surface may use; the kind's own when empty",
@@ -609,82 +615,6 @@ export const APPSPEC_SCHEMA = {
             title: 'AppScenario',
             type: 'object',
         },
-        AppSetting: {
-            additionalProperties: false,
-            description: 'Something the user may set for their session.',
-            properties: {
-                id: {
-                    description: 'The name the application reads it by',
-                    title: 'Id',
-                    type: 'string',
-                },
-                type: {
-                    $ref: '#/$defs/SettingType',
-                    description: '`select`, `text`, `toggle`, `slider` or `number`',
-                },
-                label: {
-                    description: 'What the user reads',
-                    title: 'Label',
-                    type: 'string',
-                },
-                options: {
-                    description: 'For a select: its options',
-                    items: {
-                        type: 'string',
-                    },
-                    title: 'Options',
-                    type: 'array',
-                },
-                default: {
-                    anyOf: [
-                        {
-                            type: 'string',
-                        },
-                        {
-                            type: 'boolean',
-                        },
-                        {
-                            type: 'number',
-                        },
-                        {
-                            type: 'null',
-                        },
-                    ],
-                    default: null,
-                    description: 'Its value at the start',
-                    title: 'Default',
-                },
-                min: {
-                    anyOf: [
-                        {
-                            type: 'number',
-                        },
-                        {
-                            type: 'null',
-                        },
-                    ],
-                    default: null,
-                    description: 'For a slider or a number: the least',
-                    title: 'Min',
-                },
-                max: {
-                    anyOf: [
-                        {
-                            type: 'number',
-                        },
-                        {
-                            type: 'null',
-                        },
-                    ],
-                    default: null,
-                    description: 'For a slider or a number: the most',
-                    title: 'Max',
-                },
-            },
-            required: ['id', 'type', 'label'],
-            title: 'AppSetting',
-            type: 'object',
-        },
         AppSpaceGrant: {
             additionalProperties: false,
             description: 'A Space the application may reach.',
@@ -1106,12 +1036,6 @@ export const APPSPEC_SCHEMA = {
             title: 'RecordItem',
             type: 'string',
         },
-        SettingType: {
-            description: 'What a setting is set with.',
-            enum: ['select', 'text', 'toggle', 'slider', 'number'],
-            title: 'SettingType',
-            type: 'string',
-        },
         ThemeMode: {
             description: 'The colour mode a theme is worn in: `auto` follows the device.',
             enum: ['light', 'dark', 'auto'],
@@ -1348,6 +1272,12 @@ export const APPSPEC_SCHEMA = {
             title: 'Enabled',
             type: 'boolean',
         },
+        unavailable_because: {
+            default: '',
+            description: 'Why it is not offered today, in a sentence its page shows: said when `enabled` is false, and only then',
+            title: 'Unavailable Because',
+            type: 'string',
+        },
         tags: {
             items: {
                 type: 'string',

package/lib/specs/cogs.js

@@ -242,8 +242,9 @@ const COG_CUSTOMER_INTERVIEWER_AGENTSPEC_0_0_1 = {
     description: `Conducts adaptive customer interviews under the Customer Research Frame: consent first, no leading question, and insights that each cite the interviewee's own words.`,
     tags: ['research', 'customer-support', 'analysis', 'cog'],
     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']
@@ -625,7 +626,7 @@ export const COG_CUSTOMER_INTERVIEWER_0_0_1 = {
     frames: ['customer-research'],
     lineage: ['datalayer', 'customer-research'],
     kind: 'context',
-    enabled: false,
+    enabled: true,
     guards: [
         {
             id: 'no-secrets',

package/lib/types/agentspecs.d.ts

@@ -485,15 +485,33 @@ export interface AppModeEffect {
     /** The model an option chosen names; the application's when unsaid. */
     model?: string;
 }
-export interface AppSettingSpec {
-    id: string;
-    type: 'select' | 'text' | 'toggle' | 'slider' | 'number';
-    label: string;
-    options: string[];
-    default?: string | boolean | number;
-    min?: number;
-    max?: number;
-}
+/**
+ * One field of a form (LOOP C-16): its JSON Schema — a `type`, the `title` a
+ * person reads, its `default`, and what it takes (`enum`, `minimum`,
+ * `maximum`…).
+ */
+export type AppFormField = {
+    type?: string;
+    title?: string;
+    description?: string;
+    default?: unknown;
+    enum?: unknown[];
+    minimum?: number;
+    maximum?: number;
+    [keyword: string]: unknown;
+};
+/**
+ * The JSON Schema of a form (LOOP C-16): an object of named fields, drawn with
+ * `@datalayer/primer-rjsf` and checked by the runtime against the same schema.
+ * An application's settings are one (`interface.settings`), as a Form block's
+ * schema is.
+ */
+export type AppFormSchema = {
+    type: 'object';
+    properties: Record<string, AppFormField>;
+    required?: string[];
+    [keyword: string]: unknown;
+};
 /** The component tree a user meets, over the approved catalog (A2UI). */
 export interface AppSurfaceSpec {
     protocol: string;
@@ -532,7 +550,11 @@ export interface AppInterfaceSpec {
     commands: AppCommandSpec[];
     /** Mode switches in the composer, the option picked going with every run (P-19). */
     modes: AppModeSpec[];
-    settings: AppSettingSpec[];
+    /**
+     * What a person may set: the JSON Schema of a form (C-16), drawn beside the
+     * conversation and on a deployment's Ship card; none when unsaid.
+     */
+    settings?: AppFormSchema;
     /** The components of the catalog the surface may use. */
     components: string[];
     surface?: AppSurfaceSpec;
@@ -710,6 +732,11 @@ export interface AppSpec {
     /** What it names that is not enabled today, in sentences. */
     setup: string[];
     enabled: boolean;
+    /**
+     * Why it is not offered today, in a sentence its page shows: said when
+     * `enabled` is false, and only then (empty otherwise).
+     */
+    unavailable_because: string;
     tags: string[];
     icon?: string;
     /** Its face: one emoji, shown wherever the application appears. */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datalayer/agent-runtimes",
-    "version": "1.3.82",
+    "version": "1.3.83",
     "type": "module",
     "workspaces": [
         ".",

package/scripts/codegen/generate_apps.py

@@ -216,7 +216,6 @@ def generate_python_code(specs: list[dict[str, Any]], built: dict[str, str]) ->
         "",
         "from agent_runtimes.types import AppSpec",
         "",
-        "",
         "# " + "=" * 76,
         "# Application Definitions",
         "# " + "=" * 76,