@datalayer/agent-runtimes 1.3.82 → 1.3.84

package/lib/specs/uiPlugins.js

@@ -949,7 +949,7 @@ export const A2UI_UI_PLUGIN_0_0_1 = {
             category: 'input',
             emoji: '🧾',
             description: 'Several fields asked at once, from a JSON Schema, checked as they are filled and again when they arrive (drawn with @datalayer/primer-rjsf).',
-            version: '1.0.0',
+            version: '1.1.0',
             standard: false,
             properties: {
                 type: 'object',
@@ -965,6 +965,11 @@ export const A2UI_UI_PLUGIN_0_0_1 = {
                         title: 'Fields',
                         description: 'The JSON Schema of what is asked: its fields, their types, what is required.',
                     },
+                    ui: {
+                        type: 'object',
+                        title: 'How its fields are drawn',
+                        description: "By field name, the ui: options @datalayer/primer-rjsf reads (a uiSchema): ui:widget one of select, radio, range, updown, switch, checkbox, text, textarea, date, checkboxes, tags; each field's own widget when unsaid.",
+                    },
                     submit_label: {
                         type: 'string',
                         title: 'Send button',

package/lib/types/agentspecs.d.ts

@@ -446,6 +446,59 @@ export interface AppPermissionsSpec {
 export interface AppStarterSpec {
     label: string;
     message: string;
+    /**
+     * The heading it is offered under (LOOP P-20): the starters of one
+     * category together, those without one first. Absent when unsaid.
+     */
+    category?: string;
+}
+/**
+ * One of several assistants in one application (LOOP P-20): picked before
+ * the conversation starts — the first unless another is — and kept to its
+ * end. Its instructions are told in every run, its model run in place of the
+ * application's (a mode's wins over it), its starters offered in place of
+ * the application's.
+ */
+export interface AppProfileSpec {
+    id: string;
+    label: string;
+    description: string;
+    instructions: string;
+    model: string | null;
+    starters: AppStarterSpec[];
+}
+/**
+ * What a person reads of an application in another language (LOOP P-26):
+ * each part keyed by what names it in the spec — a starter by its label, a
+ * category by its words, a setting by its field, a command by its name, a
+ * mode and a profile by their ids. Every key present; empty is untranslated.
+ */
+export interface AppTranslationSpec {
+    name: string;
+    description: string;
+    welcome: string;
+    starters: Record<string, {
+        label: string;
+        message: string;
+    }>;
+    categories: Record<string, string>;
+    settings: Record<string, {
+        title: string;
+        description: string;
+        options: Record<string, string>;
+    }>;
+    commands: Record<string, string>;
+    modes: Record<string, {
+        label: string;
+        options: Record<string, {
+            label: string;
+            description: string;
+        }>;
+    }>;
+    profiles: Record<string, {
+        label: string;
+        description: string;
+    }>;
 }
 /** A slash command the user picks in the composer (LOOP P-19). */
 export interface AppCommandSpec {
@@ -485,15 +538,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;
@@ -519,6 +590,25 @@ export interface AppVoiceSpec {
     language: string;
     where: 'auto' | 'device' | 'server';
 }
+/**
+ * A kind of file a person may send, and how large (LOOP P-21): a media type
+ * (`application/pdf`), a family (`image/*`, `audio/*`) or an extension
+ * (`.csv`), lowercase.
+ */
+export interface AppUploadKindSpec {
+    type: string;
+    /** The largest file of this kind, in megabytes; 10 unless said, 25 at most. */
+    maxMb: number;
+}
+/**
+ * What a person may send in the composer without being asked (LOOP P-21):
+ * the kinds it takes, each with its largest size, and how many at once.
+ */
+export interface AppUploadsSpec {
+    kinds: AppUploadKindSpec[];
+    /** The most files sent with one message; 5 unless said. */
+    maxFiles: number;
+}
 /** What the user of an application sees. */
 export interface AppInterfaceSpec {
     layout: AppLayout;
@@ -532,7 +622,33 @@ export interface AppInterfaceSpec {
     commands: AppCommandSpec[];
     /** Mode switches in the composer, the option picked going with every run (P-19). */
     modes: AppModeSpec[];
-    settings: AppSettingSpec[];
+    /**
+     * Several assistants in one application (P-20): two at least, or none.
+     * Absent from a spec made before profiles.
+     */
+    profiles?: AppProfileSpec[];
+    /**
+     * 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;
+    /**
+     * How the settings' fields are drawn (P-20): a uiSchema as
+     * `@datalayer/primer-rjsf` reads it, by field name — `ui:widget` one of
+     * `select`, `radio`, `range`, `updown`, `switch`, `checkbox`, `text`,
+     * `textarea`, `date`, `checkboxes`, `tags`. Each field's own when unsaid.
+     */
+    settingsUi?: Record<string, unknown>;
+    /** The language its own words are in, BCP 47 (P-26); `en` when absent. */
+    language?: string;
+    /** Its words in other languages, by BCP 47 tag (P-26). */
+    translations?: Record<string, AppTranslationSpec>;
+    /**
+     * What a person may send in the composer without being asked (P-21): none
+     * when unsaid — the composer offers no attachment, and the runtime refuses
+     * a file sent with a message.
+     */
+    uploads?: AppUploadsSpec;
     /** The components of the catalog the surface may use. */
     components: string[];
     surface?: AppSurfaceSpec;
@@ -559,6 +675,12 @@ export interface AppInterfaceSpec {
 export interface AppTestCaseSpec {
     ask: string;
     expect: string;
+    /**
+     * The function of its code that decides the case, by name (LOOP P-06:
+     * `@app.test`); `expect` still says it in words, and decides it without
+     * the file. Empty, or absent, for a case in words alone.
+     */
+    code?: string;
 }
 /**
  * What was verified, and how, each in a sentence a person reads (LOOP E-14):
@@ -590,11 +712,38 @@ export interface AppRecordSpec {
      */
     suggestTests: boolean;
 }
-/** Optional checks from the catalogue. */
+/** Where a check of an application's code runs (LOOP P-06). */
+export type AppCheckStage = 'answer' | 'tool_call';
+/** A check written in an application's code (LOOP P-06: `@app.check`). */
+export interface AppCodeCheckSpec {
+    /** The function of its code that checks. */
+    name: string;
+    /** On every answer, or every tool call the rules let through. */
+    on: AppCheckStage;
+    /** What it checks, in a sentence a person reads. */
+    description: string;
+}
+/** Optional checks from the catalogue, and its code's own. */
 export interface AppChecksSpec {
     guards: string[];
     gates: string[];
     track: string;
+    /** Checks written in its code (LOOP P-06); absent when it has none. */
+    code?: AppCodeCheckSpec[];
+}
+/**
+ * A tool of an application's own, written in its code (LOOP P-06:
+ * `@app.tool`): its agent calls it, and the rules decide each call by what
+ * it `does`, or by a rule that names it by its name alone.
+ */
+export interface AppToolSpec {
+    name: string;
+    /** What it does, for the agent. */
+    description: string;
+    /** The JSON Schema of its arguments, an object. */
+    parameters: Record<string, unknown>;
+    /** What it does, by class of action: `read`, `write`, `send`… */
+    does: string[];
 }
 /** A function of the host page the application's agent may call (LOOP D-10). */
 export interface AppHostFunctionSpec {
@@ -689,6 +838,8 @@ export interface AppSpec {
     skills: string[];
     /** Backend tools (agentspecs/backend-tools) it adds to its agent's. */
     backendTools: string[];
+    /** Tools of its own, written in its code (LOOP P-06); absent when it has none. */
+    tools?: AppToolSpec[];
     /** The Frames it works under. */
     context: string[];
     /** The documents and datasets it answers from. */
@@ -710,6 +861,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.84",
     "type": "module",
     "workspaces": [
         ".",

package/scripts/codegen/generate_apps.py

@@ -54,6 +54,7 @@ CAMEL = {
     "decision_model": "decisionModel",
     "backend_tools": "backendTools",
     "character_alone": "characterAlone",
+    "settings_ui": "settingsUi",
 }
 
 #: The keys whose value is carried as it is written: a component tree, weights by name.
@@ -110,6 +111,21 @@ def load_specs(specs_dir: Path) -> tuple[list[dict[str, Any]], dict[str, Any]]:
                 if isinstance(rule["applies_to"], str)
                 else rule["applies_to"]
             )
+        # A starter offered under a category names it; the others say nothing of it.
+        for starter in [
+            *spec["interface"]["starters"],
+            *(
+                item
+                for profile in spec["interface"]["profiles"]
+                for item in profile["starters"]
+            ),
+        ]:
+            if not starter.get("category"):
+                starter.pop("category", None)
+        # A case decided by code names it; the others say nothing of it.
+        for case in spec["tests"]["cases"]:
+            if not case.get("code"):
+                case.pop("code", None)
         for key in ("description", "instructions", "goal"):
             spec[key] = _flat(spec.get(key))
         spec["interface"]["welcome"] = _flat(spec["interface"].get("welcome"))
@@ -216,7 +232,6 @@ def generate_python_code(specs: list[dict[str, Any]], built: dict[str, str]) ->
         "",
         "from agent_runtimes.types import AppSpec",
         "",
-        "",
         "# " + "=" * 76,
         "# Application Definitions",
         "# " + "=" * 76,