@datalayer/agent-runtimes 1.3.114 → 1.5.0

package/lib/specs/apps.js

@@ -27,6 +27,8 @@ export const ACCOUNTING_APP_0_0_1 = {
             only: [],
         },
     ],
+    protocols: [],
+    ui: [],
     rules: [
         {
             action: 'Read the books',
@@ -67,6 +69,7 @@ export const ACCOUNTING_APP_0_0_1 = {
         ],
         commands: [],
         modes: [],
+        actions: [],
         profiles: [],
         language: 'en',
         translations: {},
@@ -180,6 +183,8 @@ export const CHANGE_DETECTION_APP_0_0_1 = {
             only: [],
         },
     ],
+    protocols: [],
+    ui: [],
     rules: [
         {
             action: 'Search and read the imagery',
@@ -220,6 +225,7 @@ export const CHANGE_DETECTION_APP_0_0_1 = {
         ],
         commands: [],
         modes: [],
+        actions: [],
         profiles: [],
         language: 'en',
         translations: {},
@@ -336,6 +342,8 @@ export const CROP_MONITORING_APP_0_0_1 = {
             only: [],
         },
     ],
+    protocols: [],
+    ui: [],
     rules: [
         {
             action: 'Search and read the imagery',
@@ -380,6 +388,7 @@ export const CROP_MONITORING_APP_0_0_1 = {
         ],
         commands: [],
         modes: [],
+        actions: [],
         profiles: [],
         language: 'en',
         translations: {},
@@ -489,6 +498,8 @@ export const CUSTOMER_INTERVIEW_APP_0_0_1 = {
     context: ['customer-research:0.0.1'],
     contents: [],
     connections: [],
+    protocols: [],
+    ui: [],
     rules: [
         {
             action: 'Send the summary by email',
@@ -520,6 +531,36 @@ export const CUSTOMER_INTERVIEW_APP_0_0_1 = {
         ],
         commands: [],
         modes: [],
+        actions: [
+            {
+                name: 'save',
+                description: 'Save an insight, with the words it cites.',
+                payload: {
+                    description: "An insight, in the interviewer's words, and the interviewee's own that it cites.",
+                    properties: {
+                        insight: {
+                            description: 'What was learned',
+                            minLength: 1,
+                            title: 'Insight',
+                            type: 'string',
+                        },
+                        quote: {
+                            description: "The interviewee's words it cites",
+                            minLength: 1,
+                            title: 'Quote',
+                            type: 'string',
+                        },
+                    },
+                    required: ['insight', 'quote'],
+                    title: 'Insight',
+                    type: 'object',
+                },
+            },
+            {
+                name: 'finish',
+                description: 'End the interview, and record its result.',
+            },
+        ],
         profiles: [],
         settings: {
             type: 'object',
@@ -697,6 +738,8 @@ export const DATA_QUALITY_APP_0_0_1 = {
     context: [],
     contents: ['The dataset under investigation'],
     connections: [],
+    protocols: [],
+    ui: [],
     rules: [],
     permissions: {
         spaces: [],
@@ -713,6 +756,7 @@ export const DATA_QUALITY_APP_0_0_1 = {
         starters: [],
         commands: [],
         modes: [],
+        actions: [],
         profiles: [],
         language: 'en',
         translations: {},
@@ -888,6 +932,8 @@ export const DECIDE_APP_0_0_1 = {
     context: [],
     contents: [],
     connections: [],
+    protocols: [],
+    ui: [],
     rules: [
         {
             action: 'Ask a decision',
@@ -923,6 +969,7 @@ export const DECIDE_APP_0_0_1 = {
         ],
         commands: [],
         modes: [],
+        actions: [],
         profiles: [],
         language: 'en',
         translations: {},
@@ -1023,6 +1070,8 @@ export const DISASTER_ASSESSMENT_APP_0_0_1 = {
             only: [],
         },
     ],
+    protocols: [],
+    ui: [],
     rules: [
         {
             action: 'Search and read the imagery',
@@ -1063,6 +1112,7 @@ export const DISASTER_ASSESSMENT_APP_0_0_1 = {
         ],
         commands: [],
         modes: [],
+        actions: [],
         profiles: [],
         language: 'en',
         translations: {},
@@ -1172,6 +1222,8 @@ export const EVENT_RESPONSE_APP_0_0_1 = {
     context: [],
     contents: [],
     connections: [],
+    protocols: [],
+    ui: [],
     rules: [],
     permissions: {
         spaces: [],
@@ -1205,6 +1257,7 @@ export const EVENT_RESPONSE_APP_0_0_1 = {
         ],
         commands: [],
         modes: [],
+        actions: [],
         profiles: [],
         language: 'en',
         translations: {},
@@ -1328,6 +1381,8 @@ export const EXCHANGE_DESK_APP_0_0_1 = {
     context: [],
     contents: [],
     connections: [],
+    protocols: ['pap'],
+    ui: [],
     pap: {
         connections: [],
         company: {
@@ -1370,6 +1425,7 @@ export const EXCHANGE_DESK_APP_0_0_1 = {
         starters: [],
         commands: [],
         modes: [],
+        actions: [],
         profiles: [],
         language: 'en',
         translations: {},
@@ -1465,6 +1521,8 @@ export const INBOX_TRIAGE_APP_0_0_1 = {
             only: ['*gmail*'],
         },
     ],
+    protocols: [],
+    ui: [],
     rules: [
         {
             action: 'Label and archive a message',
@@ -1529,6 +1587,7 @@ export const INBOX_TRIAGE_APP_0_0_1 = {
         ],
         commands: [],
         modes: [],
+        actions: [],
         profiles: [],
         language: 'en',
         translations: {},
@@ -1657,6 +1716,8 @@ export const MODEL_CHOICE_APP_0_0_1 = {
         'The Models page: how each model is billed (standard or credits) and who hosts it',
     ],
     connections: [],
+    protocols: [],
+    ui: [],
     rules: [],
     permissions: {
         spaces: [],
@@ -1673,6 +1734,7 @@ export const MODEL_CHOICE_APP_0_0_1 = {
         starters: [],
         commands: [],
         modes: [],
+        actions: [],
         profiles: [],
         language: 'en',
         translations: {},
@@ -1906,6 +1968,8 @@ export const MONTH_END_CLOSE_APP_0_0_1 = {
             only: [],
         },
     ],
+    protocols: [],
+    ui: [],
     rules: [
         {
             action: 'Read the books',
@@ -1950,6 +2014,7 @@ export const MONTH_END_CLOSE_APP_0_0_1 = {
         ],
         commands: [],
         modes: [],
+        actions: [],
         profiles: [],
         language: 'en',
         translations: {},
@@ -2059,6 +2124,8 @@ export const ORDER_DESK_APP_0_0_1 = {
     context: [],
     contents: [],
     connections: [],
+    protocols: ['pap'],
+    ui: [],
     pap: {
         connections: [
             {
@@ -2124,6 +2191,7 @@ export const ORDER_DESK_APP_0_0_1 = {
         ],
         commands: [],
         modes: [],
+        actions: [],
         profiles: [],
         language: 'en',
         translations: {},
@@ -2161,7 +2229,7 @@ export const ORDER_DESK_APP_0_0_1 = {
                 "The journey it takes is the Personal Agent Protocol SDK's demonstration with Manzanita Outfitters, run in the SDK's own tests (personal-agent-protocol 0.10.0).",
             ],
             unverified: [
-                "No company answers on Datalayer yet: the gateway's company tools are not shipped, so it has not run in the Studio.",
+                'No company answers on Datalayer yet: no test company is served on r1, so it has not run in the Studio against one.',
             ],
         },
     },
@@ -2218,6 +2286,8 @@ export const PIPELINE_REPORT_APP_0_0_1 = {
     context: ['datalayer:0.0.1'],
     contents: ['Sales pipeline export'],
     connections: [],
+    protocols: [],
+    ui: [],
     rules: [
         {
             action: 'Send the report',
@@ -2259,6 +2329,7 @@ export const PIPELINE_REPORT_APP_0_0_1 = {
         ],
         commands: [],
         modes: [],
+        actions: [],
         profiles: [],
         language: 'en',
         translations: {},
@@ -2512,6 +2583,8 @@ export const QUOTE_CALCULATOR_APP_0_0_1 = {
     context: [],
     contents: ['Price list'],
     connections: [],
+    protocols: [],
+    ui: [],
     rules: [],
     permissions: {
         spaces: [],
@@ -2528,6 +2601,7 @@ export const QUOTE_CALCULATOR_APP_0_0_1 = {
         starters: [],
         commands: [],
         modes: [],
+        actions: [],
         profiles: [],
         settings: {
             type: 'object',
@@ -2782,6 +2856,8 @@ export const REPORT_FROM_A_FILE_APP_0_0_1 = {
     context: [],
     contents: [],
     connections: [],
+    protocols: [],
+    ui: [],
     rules: [
         {
             action: 'Send the report by email',
@@ -2804,6 +2880,7 @@ export const REPORT_FROM_A_FILE_APP_0_0_1 = {
         starters: [],
         commands: [],
         modes: [],
+        actions: [],
         profiles: [],
         settings: {
             type: 'object',
@@ -3056,6 +3133,8 @@ export const SALES_APP_0_0_1 = {
     context: [],
     contents: [],
     connections: [],
+    protocols: [],
+    ui: [],
     rules: [],
     permissions: {
         spaces: [],
@@ -3089,6 +3168,7 @@ export const SALES_APP_0_0_1 = {
         ],
         commands: [],
         modes: [],
+        actions: [],
         profiles: [],
         language: 'en',
         translations: {},
@@ -3189,6 +3269,8 @@ export const SHIP_OR_FIX_APP_0_0_1 = {
     context: [],
     contents: ['The benchmark run: task results, traces, cost and latency'],
     connections: [],
+    protocols: [],
+    ui: [],
     rules: [],
     permissions: {
         spaces: [],
@@ -3205,6 +3287,7 @@ export const SHIP_OR_FIX_APP_0_0_1 = {
         starters: [],
         commands: [],
         modes: [],
+        actions: [],
         profiles: [],
         language: 'en',
         translations: {},
@@ -3404,6 +3487,8 @@ export const SUPPLIER_COMPARISON_APP_0_0_1 = {
     context: [],
     contents: ['Order history', 'Supplier price lists', 'Delivery records'],
     connections: [],
+    protocols: [],
+    ui: [],
     rules: [],
     permissions: {
         spaces: [],
@@ -3420,6 +3505,7 @@ export const SUPPLIER_COMPARISON_APP_0_0_1 = {
         starters: [],
         commands: [],
         modes: [],
+        actions: [],
         profiles: [],
         language: 'en',
         translations: {},
@@ -3606,6 +3692,8 @@ export const SUPPORT_DESK_APP_0_0_1 = {
     context: [],
     contents: ['Product documentation', 'Returns policy'],
     connections: [],
+    protocols: [],
+    ui: [],
     rules: [],
     permissions: {
         spaces: [],
@@ -3638,6 +3726,7 @@ export const SUPPORT_DESK_APP_0_0_1 = {
         ],
         commands: [],
         modes: [],
+        actions: [],
         profiles: [],
         settings: {
             type: 'object',
@@ -3849,7 +3938,7 @@ export const SUPPORT_DESK_APP_0_0_1 = {
             recorded: [],
             unverified: [
                 'No conversation has run: its agent was switched on in the catalogue on 2026-10-06 and has not answered yet.',
-                "Its two documents are Datalayer's samples, for a made-up product: a builder gives their own on What it knows.",
+                "Its two documents are Datalayer's own examples, for a made-up product: a builder gives their own on What it knows.",
                 'Its tests have not been run.',
             ],
         },
@@ -3922,6 +4011,8 @@ export const TRAVEL_DESK_APP_0_0_1 = {
     context: [],
     contents: [],
     connections: [],
+    protocols: ['pact'],
+    ui: [],
     pact: {
         connections: [
             {
@@ -3969,6 +4060,7 @@ export const TRAVEL_DESK_APP_0_0_1 = {
         ],
         commands: [],
         modes: [],
+        actions: [],
         profiles: [],
         language: 'en',
         translations: {},
@@ -4003,7 +4095,7 @@ export const TRAVEL_DESK_APP_0_0_1 = {
         verified: {
             live: [],
             recorded: [
-                "The journey is agent-runtimes' PACT example (examples/protocols/pact/personal_agent.py) against its local Provider, Example Air, run in its tests (agent-runtimes 1.3.112).",
+                "The journey is the developers' PACT example (examples/protocols/pact/personal_agent.py) against its local Provider, Example Air, run in its own tests (version 1.3.112).",
             ],
             unverified: [
                 "No airline answers PACT on Datalayer yet: the gateway's pact toolset is built, not deployed.",
@@ -4070,6 +4162,8 @@ export const WEB_RESEARCH_APP_0_0_1 = {
             only: [],
         },
     ],
+    protocols: [],
+    ui: [],
     rules: [],
     permissions: {
         spaces: [],
@@ -4099,6 +4193,7 @@ export const WEB_RESEARCH_APP_0_0_1 = {
         ],
         commands: [],
         modes: [],
+        actions: [],
         profiles: [],
         settings: {
             type: 'object',
@@ -4540,6 +4635,36 @@ export const APP_SOURCES = {
                     message: 'Interview me about my first week with the product.',
                 },
             ],
+            actions: [
+                {
+                    name: 'save',
+                    description: 'Save an insight, with the words it cites.',
+                    payload: {
+                        description: "An insight, in the interviewer's words, and the interviewee's own that it cites.",
+                        properties: {
+                            insight: {
+                                description: 'What was learned',
+                                minLength: 1,
+                                title: 'Insight',
+                                type: 'string',
+                            },
+                            quote: {
+                                description: "The interviewee's words it cites",
+                                minLength: 1,
+                                title: 'Quote',
+                                type: 'string',
+                            },
+                        },
+                        required: ['insight', 'quote'],
+                        title: 'Insight',
+                        type: 'object',
+                    },
+                },
+                {
+                    name: 'finish',
+                    description: 'End the interview, and record its result.',
+                },
+            ],
             settings: {
                 type: 'object',
                 properties: {
@@ -5033,6 +5158,7 @@ export const APP_SOURCES = {
                 does: ['write'],
             },
         ],
+        protocols: ['pap'],
         pap: {
             company: {
                 enabled: true,
@@ -5498,6 +5624,7 @@ export const APP_SOURCES = {
         owner: 'Datalayer <info@datalayer.io>',
         agent: 'cog-crawler:0.0.1',
         instructions: 'You work with Manzanita Outfitters for the person you talk to, through its tools. Ask the shop before saying anything about an order; when it asks the person to sign in, say so and wait. Never confirm what the shop proposes on your own: the person approves it, word for word, on Waiting for you.',
+        protocols: ['pap'],
         pap: {
             connections: [
                 {
@@ -5560,7 +5687,7 @@ export const APP_SOURCES = {
                     "The journey it takes is the Personal Agent Protocol SDK's demonstration with Manzanita Outfitters, run in the SDK's own tests (personal-agent-protocol 0.10.0).",
                 ],
                 unverified: [
-                    "No company answers on Datalayer yet: the gateway's company tools are not shipped, so it has not run in the Studio.",
+                    'No company answers on Datalayer yet: no test company is served on r1, so it has not run in the Studio against one.',
                 ],
             },
         },
@@ -6785,7 +6912,7 @@ export const APP_SOURCES = {
             verified: {
                 unverified: [
                     'No conversation has run: its agent was switched on in the catalogue on 2026-10-06 and has not answered yet.',
-                    "Its two documents are Datalayer's samples, for a made-up product: a builder gives their own on What it knows.",
+                    "Its two documents are Datalayer's own examples, for a made-up product: a builder gives their own on What it knows.",
                     'Its tests have not been run.',
                 ],
             },
@@ -6826,6 +6953,7 @@ export const APP_SOURCES = {
         owner: 'Datalayer <info@datalayer.io>',
         agent: 'cog-crawler:0.0.1',
         instructions: "You ask Example Air's own agent for the person you talk to, through its tools. Ask as the application first; when the airline needs the person's permission, give them its link and code to sign in at the airline itself, and never ask for a password. Change a booking only when the person asked.",
+        protocols: ['pact'],
         pact: {
             connections: [
                 {
@@ -6880,7 +7008,7 @@ export const APP_SOURCES = {
             ],
             verified: {
                 recorded: [
-                    "The journey is agent-runtimes' PACT example (examples/protocols/pact/personal_agent.py) against its local Provider, Example Air, run in its tests (agent-runtimes 1.3.112).",
+                    "The journey is the developers' PACT example (examples/protocols/pact/personal_agent.py) against its local Provider, Example Air, run in its own tests (version 1.3.112).",
                 ],
                 unverified: [
                     "No airline answers PACT on Datalayer yet: the gateway's pact toolset is built, not deployed.",

package/lib/specs/appspecSchema.js

@@ -76,6 +76,41 @@ export const APPSPEC_SCHEMA = {
             title: 'AppA2AExtension',
             type: 'object',
         },
+        AppAction: {
+            additionalProperties: false,
+            description: 'An action of its code a person presses (`@app.action`, REACTOR_UI RU-5).\n\nWhat its payload is, typed: the JSON Schema of an object, written from the\npydantic model its code declares (`@app.action(name, payload=Model)`); an\naction declaring none takes nothing. The runtime offers it only where a\ndisplay showed it, or to the session that runs it, each press with a\ntoken; a press of an action not declared here is refused, and its payload\nis checked against this schema before its code runs.',
+            properties: {
+                name: {
+                    description: 'Its name, as its button presses it',
+                    pattern: '^[A-Za-z_][A-Za-z0-9_]*$',
+                    title: 'Name',
+                    type: 'string',
+                },
+                description: {
+                    default: '',
+                    description: 'What it does, in a sentence',
+                    title: 'Description',
+                    type: 'string',
+                },
+                payload: {
+                    anyOf: [
+                        {
+                            additionalProperties: true,
+                            type: 'object',
+                        },
+                        {
+                            type: 'null',
+                        },
+                    ],
+                    default: null,
+                    description: 'The JSON Schema of what it is pressed with, an object; none when it takes nothing (a press with anything is then refused)',
+                    title: 'Payload',
+                },
+            },
+            required: ['name'],
+            title: 'AppAction',
+            type: 'object',
+        },
         AppChecks: {
             additionalProperties: false,
             description: "Optional: checks from the catalogue, for a builder who wants them — and its code's own.",
@@ -536,6 +571,14 @@ export const APPSPEC_SCHEMA = {
                     title: 'Modes',
                     type: 'array',
                 },
+                actions: {
+                    description: 'The actions of its code a person presses (`@app.action`, REACTOR_UI RU-5), each with the JSON Schema of its payload: what its buttons offer, with a token, and nothing else',
+                    items: {
+                        $ref: '#/$defs/AppAction',
+                    },
+                    title: 'Actions',
+                    type: 'array',
+                },
                 profiles: {
                     description: 'Several assistants in one application, two at least: the person picks one before the conversation starts — the first unless they do — and keeps it to the end; its instructions, model and starters go with every run (LOOP P-20). None when unsaid',
                     items: {
@@ -2267,6 +2310,22 @@ export const APPSPEC_SCHEMA = {
             title: 'Connections',
             type: 'array',
         },
+        protocols: {
+            description: 'The agent protocols it speaks, ids of the protocols catalogue (AGENT_PROTOCOLS PS-02): its `pap`, `pact` and `a2a` blocks are refused unless their protocol is listed, and a planned protocol only while it is not offered',
+            items: {
+                type: 'string',
+            },
+            title: 'Protocols',
+            type: 'array',
+        },
+        ui: {
+            description: 'The UI its answers render in, ids of `agentspecs/ui` (AGENT_PROTOCOLS PS-04): each once, and one that is not enabled only while it is not offered',
+            items: {
+                type: 'string',
+            },
+            title: 'Ui',
+            type: 'array',
+        },
         pap: {
             $ref: '#/$defs/AppPap',
             description: 'Personal Agent Protocol: companies it works with, or being one',

package/lib/specs/cogs.js

@@ -216,7 +216,8 @@ Check your output against every Guard before you hand it over, and say which you
         { id: 'research.gather' },
     ],
     protocol: undefined,
-    uiPlugin: undefined,
+    ui: undefined,
+    protocols: [],
     trigger: undefined,
     modelConfig: undefined,
     mcpServerTools: undefined,
@@ -378,7 +379,8 @@ Check your output against every Guard before you hand it over, and say which you
         { id: 'support.respond' },
     ],
     protocol: 'vercel-ai',
-    uiPlugin: 'a2ui',
+    ui: 'a2ui',
+    protocols: [],
     trigger: undefined,
     modelConfig: { temperature: 0.7, max_tokens: 4096 },
     mcpServerTools: undefined,
@@ -557,7 +559,8 @@ Check your output against every Guard before you hand it over, and say which you
         { id: 'report.author' },
     ],
     protocol: undefined,
-    uiPlugin: undefined,
+    ui: undefined,
+    protocols: [],
     trigger: undefined,
     modelConfig: undefined,
     mcpServerTools: undefined,

package/lib/specs/index.d.ts

@@ -19,7 +19,8 @@ export * from './outputs';
 export * from './skills';
 export * from './backendTools';
 export * from './triggers';
-export * from './uiPlugins';
+export * from './ui';
+export * from './protocols';
 export * from './frames';
 export * from './cogs';
 export * from './guards';

package/lib/specs/index.js

@@ -23,7 +23,8 @@ export * from './outputs';
 export * from './skills';
 export * from './backendTools';
 export * from './triggers';
-export * from './uiPlugins';
+export * from './ui';
+export * from './protocols';
 export * from './frames';
 export * from './cogs';
 export * from './guards';

package/lib/specs/protocols.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Protocol Catalog.
+ *
+ * The agent protocols Datalayer targets (AGENT_PROTOCOLS PS-01).
+ *
+ * This file is AUTO-GENERATED from YAML specifications.
+ * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
+ */
+import type { ProtocolSpec } from '../types/agentspecs';
+export declare const A2A_PROTOCOL_0_0_1: ProtocolSpec;
+export declare const A2UI_PROTOCOL_0_0_1: ProtocolSpec;
+export declare const ACP_PROTOCOL_0_0_1: ProtocolSpec;
+export declare const AG_UI_PROTOCOL_0_0_1: ProtocolSpec;
+export declare const MCP_PROTOCOL_0_0_1: ProtocolSpec;
+export declare const PACT_PROTOCOL_0_0_1: ProtocolSpec;
+export declare const PAP_PROTOCOL_0_0_1: ProtocolSpec;
+export declare const TAP_PROTOCOL_0_0_1: ProtocolSpec;
+export declare const UCP_PROTOCOL_0_0_1: ProtocolSpec;
+export declare const WEB_BOT_AUTH_PROTOCOL_0_0_1: ProtocolSpec;
+export declare const PROTOCOL_CATALOGUE: Record<string, ProtocolSpec>;
+/** A protocol by id. */
+export declare function getProtocol(protocolId: string): ProtocolSpec | undefined;
+/** Every protocol of the catalogue. */
+export declare function listProtocolSpecs(): ProtocolSpec[];