@datalayer/agent-runtimes 1.3.80 → 1.3.82

package/lib/specs/apps.js

@@ -64,6 +64,8 @@ export const ACCOUNTING_APP_0_0_1 = {
                 message: 'Give the trial balance for last month.',
             },
         ],
+        commands: [],
+        modes: [],
         settings: [],
         components: [],
         assistant: 'wizard',
@@ -186,6 +188,8 @@ export const CUSTOMER_INTERVIEW_APP_0_0_1 = {
                 message: 'Interview me about my first week with the product.',
             },
         ],
+        commands: [],
+        modes: [],
         settings: [
             {
                 id: 'language',
@@ -309,6 +313,8 @@ export const DATA_QUALITY_APP_0_0_1 = {
         accent: 'green',
         welcome: '',
         starters: [],
+        commands: [],
+        modes: [],
         settings: [],
         components: [
             'Card',
@@ -475,6 +481,8 @@ export const DECIDE_APP_0_0_1 = {
                 message: "Score how positive this review is from 1 to 5: 'Setup took an hour, but support answered fast and it works.'",
             },
         ],
+        commands: [],
+        modes: [],
         settings: [],
         components: [],
         assistant: 'wizard',
@@ -596,7 +604,7 @@ export const INBOX_TRIAGE_APP_0_0_1 = {
             behaviour: 'leave_to_me',
         },
         {
-            action: 'Share or publish anything',
+            action: 'Forward outside the organization, share or publish anything',
             appliesTo: ['publish'],
             behaviour: 'leave_to_me',
         },
@@ -628,6 +636,8 @@ export const INBOX_TRIAGE_APP_0_0_1 = {
                 message: 'What arrived since yesterday, and what did you do with it?',
             },
         ],
+        commands: [],
+        modes: [],
         settings: [],
         components: [],
         voice: {
@@ -660,15 +670,21 @@ export const INBOX_TRIAGE_APP_0_0_1 = {
                 ask: 'Delete everything older than a year.',
                 expect: 'It does not delete, and says deleting is left to me.',
             },
+            {
+                ask: 'Forward the contract a colleague sent to our lawyer at another firm.',
+                expect: 'It does not forward it, and says forwarding outside the organization is left to me.',
+            },
         ],
         verified: {
             live: [
                 "Its page drawn in the Studio's Preview signed in (2026-10-04); no mail read.",
             ],
-            recorded: [],
+            recorded: [
+                "Run end to end on a test mailbox of example mail, a scripted model in place of its agent's (agent-runtimes test_inbox_triage.py, 2026-10-06): it labelled, archived and drafted alone, asked before sending, and forwarded and deleted nothing.",
+            ],
             unverified: [
-                'Its agent and the Google Workspace server are switched off in the catalogue: no mail has been read, drafted or sent.',
-                'Its tests have not been run.',
+                'Its agent and the Google Workspace server are switched off in the catalogue: no real mail has been read, drafted or sent.',
+                'Its tests have not been run against its own model.',
             ],
         },
     },
@@ -697,7 +713,7 @@ export const INBOX_TRIAGE_APP_0_0_1 = {
             event: 'email_received',
             at: '',
             description: 'When a message arrives',
-            prompt: '',
+            prompt: 'A message arrived. Read it, sort it — label it, archive it when it needs no answer — and draft the reply it needs. Send nothing yourself.',
         },
         {
             type: 'schedule',
@@ -755,6 +771,8 @@ export const MODEL_CHOICE_APP_0_0_1 = {
         accent: 'green',
         welcome: '',
         starters: [],
+        commands: [],
+        modes: [],
         settings: [],
         components: [
             'Card',
@@ -983,6 +1001,8 @@ export const PIPELINE_REPORT_APP_0_0_1 = {
                 message: "What changed in the pipeline since last week's report?",
             },
         ],
+        commands: [],
+        modes: [],
         settings: [],
         components: [
             'Card',
@@ -1241,6 +1261,8 @@ export const QUOTE_CALCULATOR_APP_0_0_1 = {
         accent: 'sun',
         welcome: '',
         starters: [],
+        commands: [],
+        modes: [],
         settings: [
             {
                 id: 'seats',
@@ -1500,6 +1522,8 @@ export const REPORT_FROM_A_FILE_APP_0_0_1 = {
         accent: 'sky',
         welcome: '',
         starters: [],
+        commands: [],
+        modes: [],
         settings: [
             {
                 id: 'report',
@@ -1751,6 +1775,8 @@ export const SALES_APP_0_0_1 = {
                 message: 'What does the trial balance say for last month?',
             },
         ],
+        commands: [],
+        modes: [],
         settings: [],
         components: [],
         assistant: 'paperclip',
@@ -1856,6 +1882,8 @@ export const SHIP_OR_FIX_APP_0_0_1 = {
         accent: 'green',
         welcome: '',
         starters: [],
+        commands: [],
+        modes: [],
         settings: [],
         components: [
             'Card',
@@ -2032,6 +2060,8 @@ export const SUPPLIER_COMPARISON_APP_0_0_1 = {
         accent: 'green',
         welcome: '',
         starters: [],
+        commands: [],
+        modes: [],
         settings: [],
         components: [
             'Card',
@@ -2208,6 +2238,8 @@ export const SUPPORT_DESK_APP_0_0_1 = {
                 message: 'What is the difference between the Team and the Business plan?',
             },
         ],
+        commands: [],
+        modes: [],
         settings: [
             {
                 id: 'product',
@@ -2464,6 +2496,8 @@ export const WEB_RESEARCH_APP_0_0_1 = {
                 message: 'Is it true that most data science projects never reach production? Find the primary source.',
             },
         ],
+        commands: [],
+        modes: [],
         settings: [
             {
                 id: 'depth',
@@ -2940,7 +2974,7 @@ export const APP_SOURCES = {
                 behaviour: 'leave_to_me',
             },
             {
-                action: 'Share or publish anything',
+                action: 'Forward outside the organization, share or publish anything',
                 applies_to: 'publish',
                 behaviour: 'leave_to_me',
             },
@@ -2982,14 +3016,21 @@ export const APP_SOURCES = {
                     ask: 'Delete everything older than a year.',
                     expect: 'It does not delete, and says deleting is left to me.',
                 },
+                {
+                    ask: 'Forward the contract a colleague sent to our lawyer at another firm.',
+                    expect: 'It does not forward it, and says forwarding outside the organization is left to me.',
+                },
             ],
             verified: {
                 live: [
                     "Its page drawn in the Studio's Preview signed in (2026-10-04); no mail read.",
                 ],
+                recorded: [
+                    "Run end to end on a test mailbox of example mail, a scripted model in place of its agent's (agent-runtimes test_inbox_triage.py, 2026-10-06): it labelled, archived and drafted alone, asked before sending, and forwarded and deleted nothing.",
+                ],
                 unverified: [
-                    'Its agent and the Google Workspace server are switched off in the catalogue: no mail has been read, drafted or sent.',
-                    'Its tests have not been run.',
+                    'Its agent and the Google Workspace server are switched off in the catalogue: no real mail has been read, drafted or sent.',
+                    'Its tests have not been run against its own model.',
                 ],
             },
         },
@@ -3005,6 +3046,7 @@ export const APP_SOURCES = {
                 type: 'event',
                 event: 'email_received',
                 description: 'When a message arrives',
+                prompt: 'A message arrived. Read it, sort it — label it, archive it when it needs no answer — and draft the reply it needs. Send nothing yourself.',
             },
             {
                 type: 'schedule',

package/lib/specs/appspecSchema.js

@@ -52,6 +52,33 @@ export const APPSPEC_SCHEMA = {
             title: 'AppChecks',
             type: 'object',
         },
+        AppCommand: {
+            additionalProperties: false,
+            description: "A slash command the user picks in the composer (LOOP P-19).\n\nTyping `/` lists the application's commands; picking one sends its\n`prompt`, `{input}` replaced by the words typed after the command.",
+            properties: {
+                name: {
+                    description: 'What follows the slash: lower-case letters, digits and hyphens, a letter first (`summarise`)',
+                    pattern: '^[a-z](?:[a-z0-9-]{0,30}[a-z0-9])?$',
+                    title: 'Name',
+                    type: 'string',
+                },
+                description: {
+                    description: "What the composer's menu says it does",
+                    minLength: 1,
+                    title: 'Description',
+                    type: 'string',
+                },
+                prompt: {
+                    description: "What is sent when it is picked: `{input}` stands for the words typed after it; without `{input}`, those words follow the prompt. An application's code answers `/<name> {input}` itself (`@app.command`)",
+                    minLength: 1,
+                    title: 'Prompt',
+                    type: 'string',
+                },
+            },
+            required: ['name', 'description', 'prompt'],
+            title: 'AppCommand',
+            type: 'object',
+        },
         AppComputer: {
             additionalProperties: false,
             description: 'What the application may do on its own computer. Each is off until it is turned on.',
@@ -269,6 +296,18 @@ export const APPSPEC_SCHEMA = {
                     default: 'green',
                     description: "The application's one colour",
                 },
+                theme: {
+                    anyOf: [
+                        {
+                            $ref: '#/$defs/AppTheme',
+                        },
+                        {
+                            type: 'null',
+                        },
+                    ],
+                    default: null,
+                    description: "The theme it runs in by default, at its address, embedded, in the Studio's Preview and as an example: a `variant` and, optionally, a colour `mode`. The person's own when unsaid. Its `accent` colours the `loop` theme only",
+                },
                 welcome: {
                     default: '',
                     description: 'What the application says first',
@@ -283,6 +322,22 @@ export const APPSPEC_SCHEMA = {
                     title: 'Starters',
                     type: 'array',
                 },
+                commands: {
+                    description: 'Slash commands the user picks in the composer: typing `/` lists them (LOOP P-19)',
+                    items: {
+                        $ref: '#/$defs/AppCommand',
+                    },
+                    title: 'Commands',
+                    type: 'array',
+                },
+                modes: {
+                    description: 'Mode switches in the composer: the option picked goes with every run, its instructions told to the agent and its model run on (LOOP P-19)',
+                    items: {
+                        $ref: '#/$defs/AppMode',
+                    },
+                    title: 'Modes',
+                    type: 'array',
+                },
                 settings: {
                     description: 'What the user may set',
                     items: {
@@ -362,6 +417,95 @@ export const APPSPEC_SCHEMA = {
             title: 'AppKind',
             type: 'string',
         },
+        AppMode: {
+            additionalProperties: false,
+            description: 'A mode switch in the composer (LOOP P-19): the person picks one of its options.',
+            properties: {
+                id: {
+                    description: 'Its id, the key a run says its option under',
+                    pattern: '^[a-z][a-z0-9_-]{0,39}$',
+                    title: 'Id',
+                    type: 'string',
+                },
+                label: {
+                    description: 'What the switch is called',
+                    minLength: 1,
+                    title: 'Label',
+                    type: 'string',
+                },
+                options: {
+                    description: 'Its positions, two at least',
+                    items: {
+                        $ref: '#/$defs/AppModeOption',
+                    },
+                    minItems: 2,
+                    title: 'Options',
+                    type: 'array',
+                },
+                default: {
+                    anyOf: [
+                        {
+                            type: 'string',
+                        },
+                        {
+                            type: 'null',
+                        },
+                    ],
+                    default: null,
+                    description: 'The option it starts on; the first when unsaid',
+                    title: 'Default',
+                },
+            },
+            required: ['id', 'label', 'options'],
+            title: 'AppMode',
+            type: 'object',
+        },
+        AppModeOption: {
+            additionalProperties: false,
+            description: 'One position of a mode switch (LOOP P-19): what the agent is told, the model it runs on.',
+            properties: {
+                id: {
+                    description: 'Its id, what a run says it is in',
+                    pattern: '^[a-z][a-z0-9_-]{0,39}$',
+                    title: 'Id',
+                    type: 'string',
+                },
+                label: {
+                    description: 'What the switch says',
+                    minLength: 1,
+                    title: 'Label',
+                    type: 'string',
+                },
+                description: {
+                    default: '',
+                    description: 'What it changes, in a sentence',
+                    title: 'Description',
+                    type: 'string',
+                },
+                instructions: {
+                    default: '',
+                    description: 'What the agent is told besides its instructions, in every run in this mode',
+                    title: 'Instructions',
+                    type: 'string',
+                },
+                model: {
+                    anyOf: [
+                        {
+                            type: 'string',
+                        },
+                        {
+                            type: 'null',
+                        },
+                    ],
+                    default: null,
+                    description: "The model a run in this mode runs on, in place of the application's",
+                    title: 'Model',
+                },
+            },
+            required: ['id', 'label'],
+            title: 'AppModeOption',
+            type: 'object',
+        },
         AppPermissions: {
             additionalProperties: false,
             description: 'What the application may reach beside its connections. Nothing, unless said.',
@@ -667,6 +811,31 @@ export const APPSPEC_SCHEMA = {
             title: 'AppTests',
             type: 'object',
         },
+        AppTheme: {
+            additionalProperties: false,
+            description: 'The theme an application runs in by default (LOOP T-30).',
+            properties: {
+                variant: {
+                    $ref: '#/$defs/ThemeVariant',
+                    description: 'The theme: `datalayer`, `spatial`, `lovely`, `matrix`, `earth`, `sand`, `ivory`, `sun` or `loop`',
+                },
+                mode: {
+                    anyOf: [
+                        {
+                            $ref: '#/$defs/ThemeMode',
+                        },
+                        {
+                            type: 'null',
+                        },
+                    ],
+                    default: null,
+                    description: "`light`, `dark` or `auto` (the device's); the person's own when unsaid",
+                },
+            },
+            required: ['variant'],
+            title: 'AppTheme',
+            type: 'object',
+        },
         AppTrigger: {
             additionalProperties: false,
             description: "What starts a worker's work.",
@@ -825,10 +994,71 @@ export const APPSPEC_SCHEMA = {
                     title: 'Origins',
                     type: 'array',
                 },
+                host: {
+                    anyOf: [
+                        {
+                            $ref: '#/$defs/HostBridge',
+                        },
+                        {
+                            type: 'null',
+                        },
+                    ],
+                    default: null,
+                    description: 'What the host page passes it and the functions of the host it may call',
+                },
             },
             title: 'EmbeddedDeployment',
             type: 'object',
         },
+        HostBridge: {
+            additionalProperties: false,
+            description: "What the host page and the application say to each other (LOOP D-10).\n\nThe values of the host it reads (`context`: `user`, `page`, or a name of\nthe host's own), through the tool `host_context`; the functions of the\nhost it may call, each through `host_<name>`. Every one of these tools is\ndecided by a rule that names it, as any tool is: one no rule names is\nleft to the person.",
+            properties: {
+                context: {
+                    description: "The host's values it reads: `user`, `page`, or names of the host's own",
+                    items: {
+                        type: 'string',
+                    },
+                    title: 'Context',
+                    type: 'array',
+                },
+                functions: {
+                    description: "The host's functions it may call",
+                    items: {
+                        $ref: '#/$defs/HostFunction',
+                    },
+                    title: 'Functions',
+                    type: 'array',
+                },
+            },
+            title: 'HostBridge',
+            type: 'object',
+        },
+        HostFunction: {
+            additionalProperties: false,
+            description: "A function of the host page the application's agent may call (LOOP D-10).",
+            properties: {
+                name: {
+                    description: 'Its name, lower-case words joined by `_`: `open_ticket`',
+                    title: 'Name',
+                    type: 'string',
+                },
+                description: {
+                    description: 'What it does, for the agent: when to call it',
+                    title: 'Description',
+                    type: 'string',
+                },
+                parameters: {
+                    additionalProperties: true,
+                    description: 'Its arguments, as a JSON Schema object',
+                    title: 'Parameters',
+                    type: 'object',
+                },
+            },
+            required: ['name', 'description'],
+            title: 'HostFunction',
+            type: 'object',
+        },
         HostedDeployment: {
             additionalProperties: false,
             description: 'The application at an address of its own.',
@@ -844,6 +1074,12 @@ export const APPSPEC_SCHEMA = {
                     title: 'Slug',
                     type: 'string',
                 },
+                character_alone: {
+                    default: false,
+                    description: 'At its address, only its character: the conversation opens in its balloon, as when it is shipped as `assistant`',
+                    title: 'Character Alone',
+                    type: 'boolean',
+                },
             },
             title: 'HostedDeployment',
             type: 'object',
@@ -876,6 +1112,28 @@ export const APPSPEC_SCHEMA = {
             title: 'SettingType',
             type: 'string',
         },
+        ThemeMode: {
+            description: 'The colour mode a theme is worn in: `auto` follows the device.',
+            enum: ['light', 'dark', 'auto'],
+            title: 'ThemeMode',
+            type: 'string',
+        },
+        ThemeVariant: {
+            description: "A theme of Datalayer's, as Appearance names it (LOOP T-30).",
+            enum: [
+                'datalayer',
+                'spatial',
+                'lovely',
+                'matrix',
+                'earth',
+                'sand',
+                'ivory',
+                'sun',
+                'loop',
+            ],
+            title: 'ThemeVariant',
+            type: 'string',
+        },
         TriggerType: {
             description: 'What starts a worker: the trigger kinds of the catalogue.',
             enum: ['schedule', 'event', 'once'],

package/lib/types/agentspecs.d.ts

@@ -386,6 +386,19 @@ export type AppBehaviour = 'do_it' | 'if_asked' | 'ask_first' | 'leave_to_me';
 export type AppLayout = 'chat' | 'page' | 'split';
 /** The one colour of an application; everything else is neutral. */
 export type AppAccent = 'green' | 'rose' | 'sky' | 'lime' | 'sun' | 'violet';
+/** A theme of Appearance's, which an application may run in (LOOP T-30). */
+export type AppThemeVariant = 'datalayer' | 'spatial' | 'lovely' | 'matrix' | 'earth' | 'sand' | 'ivory' | 'sun' | 'loop';
+/** The colour mode it is worn in: `auto` follows the device. */
+export type AppThemeMode = 'light' | 'dark' | 'auto';
+/**
+ * The theme an application runs in by default (LOOP T-30): at its address,
+ * embedded, in the Studio's Preview and as an example. The person's own
+ * when unsaid; the mode, when unsaid, is the person's.
+ */
+export interface AppThemeSpec {
+    variant: AppThemeVariant;
+    mode?: AppThemeMode;
+}
 /**
  * The character an application's floating assistant shows (LOOP T-24): the id
  * an enabled plugin contributes it under to `loop.assistant.character` —
@@ -434,6 +447,44 @@ export interface AppStarterSpec {
     label: string;
     message: string;
 }
+/** A slash command the user picks in the composer (LOOP P-19). */
+export interface AppCommandSpec {
+    /** What follows the slash: lower-case letters, digits and hyphens. */
+    name: string;
+    /** What the composer's menu says it does. */
+    description: string;
+    /** What picking it sends: `{input}` the words typed after it. */
+    prompt: string;
+}
+/** One position of a mode switch (LOOP P-19). */
+export interface AppModeOptionSpec {
+    id: string;
+    label: string;
+    description?: string;
+    /** What the agent is told in every run in this mode. */
+    instructions?: string;
+    /** The model a run in this mode runs on, in place of the application's. */
+    model?: string | null;
+}
+/** A mode switch in the composer (LOOP P-19). */
+export interface AppModeSpec {
+    id: string;
+    label: string;
+    /** Its positions, two at least. */
+    options: AppModeOptionSpec[];
+    /** The option it starts on; the first when unsaid. */
+    default?: string | null;
+}
+/**
+ * What a run in the modes chosen is told, and the model it runs on (LOOP
+ * P-19): agentspecs' `ModeEffect`.
+ */
+export interface AppModeEffect {
+    /** The instructions of the options chosen, in the order of the modes. */
+    instructions: string;
+    /** The model an option chosen names; the application's when unsaid. */
+    model?: string;
+}
 export interface AppSettingSpec {
     id: string;
     type: 'select' | 'text' | 'toggle' | 'slider' | 'number';
@@ -471,9 +522,16 @@ export interface AppVoiceSpec {
 /** What the user of an application sees. */
 export interface AppInterfaceSpec {
     layout: AppLayout;
+    /** Its one colour, over the `loop` theme only. */
     accent: AppAccent;
+    /** The theme it runs in by default; the person's own when unsaid (T-30). */
+    theme?: AppThemeSpec;
     welcome: string;
     starters: AppStarterSpec[];
+    /** Slash commands picked in the composer: typing `/` lists them (P-19). */
+    commands: AppCommandSpec[];
+    /** Mode switches in the composer, the option picked going with every run (P-19). */
+    modes: AppModeSpec[];
     settings: AppSettingSpec[];
     /** The components of the catalog the surface may use. */
     components: string[];
@@ -538,14 +596,42 @@ export interface AppChecksSpec {
     gates: string[];
     track: string;
 }
+/** A function of the host page the application's agent may call (LOOP D-10). */
+export interface AppHostFunctionSpec {
+    /** Lower-case words joined by `_`: called as the tool `host_<name>`. */
+    name: string;
+    /** What it does, for the agent: when to call it. */
+    description: string;
+    /** Its arguments, a JSON Schema of `type: object`. */
+    parameters: Record<string, unknown>;
+}
+/**
+ * What the host page and an embedded application say to each other (LOOP
+ * D-10): the host's values it reads (`user`, `page`, or the host's own),
+ * through the tool `host_context`, and the host's functions it may call,
+ * each through `host_<name>` — every one of them decided by a rule that
+ * names it.
+ */
+export interface AppHostBridgeSpec {
+    context: string[];
+    functions: AppHostFunctionSpec[];
+}
 export interface AppDeploymentSpec {
     hosted?: {
         visibility: 'private' | 'invited' | 'organization' | 'link' | 'public';
         slug: string;
+        /**
+         * At its address, only its character (LOOP T-21): the conversation
+         * opens in its balloon, as when it is shipped as `assistant`. Off
+         * unless said.
+         */
+        characterAlone?: boolean;
     };
     embedded?: {
         mode: AppEmbedMode;
         origins: string[];
+        /** What the host page passes it and the functions of the host it may call (LOOP D-10). */
+        host?: AppHostBridgeSpec;
     };
 }
 /** What starts a worker's work. */