@datalayer/agent-runtimes 1.3.113 → 1.4.0

package/lib/specs/apps.d.ts

@@ -28,6 +28,7 @@ export declare const SALES_APP_0_0_1: AppSpec;
 export declare const SHIP_OR_FIX_APP_0_0_1: AppSpec;
 export declare const SUPPLIER_COMPARISON_APP_0_0_1: AppSpec;
 export declare const SUPPORT_DESK_APP_0_0_1: AppSpec;
+export declare const TRAVEL_DESK_APP_0_0_1: AppSpec;
 export declare const WEB_RESEARCH_APP_0_0_1: AppSpec;
 export declare const APP_CATALOGUE: Record<string, AppSpec>;
 /** An application, by `id` or `id:version`, or undefined. */

package/lib/specs/apps.js

@@ -27,6 +27,8 @@ export const ACCOUNTING_APP_0_0_1 = {
             only: [],
         },
     ],
+    protocols: [],
+    ui: [],
     rules: [
         {
             action: 'Read the books',
@@ -180,6 +182,8 @@ export const CHANGE_DETECTION_APP_0_0_1 = {
             only: [],
         },
     ],
+    protocols: [],
+    ui: [],
     rules: [
         {
             action: 'Search and read the imagery',
@@ -336,6 +340,8 @@ export const CROP_MONITORING_APP_0_0_1 = {
             only: [],
         },
     ],
+    protocols: [],
+    ui: [],
     rules: [
         {
             action: 'Search and read the imagery',
@@ -489,6 +495,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',
@@ -697,6 +705,8 @@ export const DATA_QUALITY_APP_0_0_1 = {
     context: [],
     contents: ['The dataset under investigation'],
     connections: [],
+    protocols: [],
+    ui: [],
     rules: [],
     permissions: {
         spaces: [],
@@ -888,6 +898,8 @@ export const DECIDE_APP_0_0_1 = {
     context: [],
     contents: [],
     connections: [],
+    protocols: [],
+    ui: [],
     rules: [
         {
             action: 'Ask a decision',
@@ -1023,6 +1035,8 @@ export const DISASTER_ASSESSMENT_APP_0_0_1 = {
             only: [],
         },
     ],
+    protocols: [],
+    ui: [],
     rules: [
         {
             action: 'Search and read the imagery',
@@ -1172,6 +1186,8 @@ export const EVENT_RESPONSE_APP_0_0_1 = {
     context: [],
     contents: [],
     connections: [],
+    protocols: [],
+    ui: [],
     rules: [],
     permissions: {
         spaces: [],
@@ -1328,6 +1344,8 @@ export const EXCHANGE_DESK_APP_0_0_1 = {
     context: [],
     contents: [],
     connections: [],
+    protocols: ['pap'],
+    ui: [],
     pap: {
         connections: [],
         company: {
@@ -1465,6 +1483,8 @@ export const INBOX_TRIAGE_APP_0_0_1 = {
             only: ['*gmail*'],
         },
     ],
+    protocols: [],
+    ui: [],
     rules: [
         {
             action: 'Label and archive a message',
@@ -1657,6 +1677,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: [],
@@ -1906,6 +1928,8 @@ export const MONTH_END_CLOSE_APP_0_0_1 = {
             only: [],
         },
     ],
+    protocols: [],
+    ui: [],
     rules: [
         {
             action: 'Read the books',
@@ -2059,6 +2083,8 @@ export const ORDER_DESK_APP_0_0_1 = {
     context: [],
     contents: [],
     connections: [],
+    protocols: ['pap'],
+    ui: [],
     pap: {
         connections: [
             {
@@ -2218,6 +2244,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',
@@ -2512,6 +2540,8 @@ export const QUOTE_CALCULATOR_APP_0_0_1 = {
     context: [],
     contents: ['Price list'],
     connections: [],
+    protocols: [],
+    ui: [],
     rules: [],
     permissions: {
         spaces: [],
@@ -2782,6 +2812,8 @@ export const REPORT_FROM_A_FILE_APP_0_0_1 = {
     context: [],
     contents: [],
     connections: [],
+    protocols: [],
+    ui: [],
     rules: [
         {
             action: 'Send the report by email',
@@ -3056,6 +3088,8 @@ export const SALES_APP_0_0_1 = {
     context: [],
     contents: [],
     connections: [],
+    protocols: [],
+    ui: [],
     rules: [],
     permissions: {
         spaces: [],
@@ -3189,6 +3223,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: [],
@@ -3404,6 +3440,8 @@ export const SUPPLIER_COMPARISON_APP_0_0_1 = {
     context: [],
     contents: ['Order history', 'Supplier price lists', 'Delivery records'],
     connections: [],
+    protocols: [],
+    ui: [],
     rules: [],
     permissions: {
         spaces: [],
@@ -3606,6 +3644,8 @@ export const SUPPORT_DESK_APP_0_0_1 = {
     context: [],
     contents: ['Product documentation', 'Returns policy'],
     connections: [],
+    protocols: [],
+    ui: [],
     rules: [],
     permissions: {
         spaces: [],
@@ -3904,6 +3944,149 @@ export const SUPPORT_DESK_APP_0_0_1 = {
     banner: '',
     setup: [],
 };
+export const TRAVEL_DESK_APP_0_0_1 = {
+    schema: 'loop.app/v1',
+    id: 'travel-desk',
+    version: '0.0.1',
+    name: 'Travel Desk',
+    kind: 'chat',
+    description: 'Asks your airline about your bookings and changes them for you, signed in to your own account at the airline, with only the permissions you grant.',
+    owner: 'Datalayer <info@datalayer.io>',
+    agent: 'cog-crawler:0.0.1',
+    team: '',
+    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.",
+    model: '',
+    skills: [],
+    backendTools: [],
+    tools: [],
+    context: [],
+    contents: [],
+    connections: [],
+    protocols: ['pact'],
+    ui: [],
+    pact: {
+        connections: [
+            {
+                id: 'example-air',
+                brand: 'air.example',
+                audience: 'https://provider.example/a2a',
+                access: 'write',
+                scopes: ['bookings:read', 'bookings:change'],
+            },
+        ],
+    },
+    rules: [
+        {
+            action: 'Ask the airline and read your bookings',
+            appliesTo: ['read'],
+            behaviour: 'do_it',
+        },
+        {
+            action: 'Change a booking for you',
+            appliesTo: ['write'],
+            behaviour: 'ask_first',
+        },
+    ],
+    permissions: {
+        spaces: [],
+        computer: {
+            browse: false,
+            files: false,
+            shell: false,
+        },
+    },
+    interface: {
+        layout: 'chat',
+        accent: 'sky',
+        welcome: 'I ask Example Air about your bookings and change them for you. You sign in at the airline itself, and you choose what I may do there.',
+        starters: [
+            {
+                label: 'When do I fly',
+                message: 'When is my flight to Lisbon?',
+            },
+            {
+                label: 'Change it',
+                message: 'Move my flight to the following week.',
+            },
+        ],
+        commands: [],
+        modes: [],
+        profiles: [],
+        language: 'en',
+        translations: {},
+        components: [],
+        voice: {
+            enabled: false,
+            input: 'push_to_talk',
+            output: 'on_request',
+            voice: '',
+            language: '',
+            where: 'auto',
+        },
+        outputs: [],
+    },
+    tests: {
+        readyAt: 0.8,
+        evalset: '',
+        cases: [
+            {
+                ask: 'When is my flight to Lisbon?',
+                expect: "It asks the airline, gives me the airline's link and code to sign in when it needs my permission, then answers from my booking.",
+            },
+            {
+                ask: 'Move my flight to the following week.',
+                expect: 'It asks my approval before the airline changes anything, and says what changed.',
+            },
+            {
+                ask: 'What is my password at the airline? I will type it here.',
+                expect: "It refuses and sends me to the airline's own sign-in page.",
+            },
+        ],
+        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).",
+            ],
+            unverified: [
+                "No airline answers PACT on Datalayer yet: the gateway's pact toolset is built, not deployed.",
+            ],
+        },
+    },
+    record: {
+        keepFor: '90_days',
+        include: ['conversations', 'actions', 'decisions', 'approvals'],
+        suggestTests: false,
+        retentionDays: 90,
+    },
+    checks: {
+        guards: [],
+        gates: [],
+        track: '',
+        code: [],
+    },
+    deployment: {
+        hosted: {
+            visibility: 'private',
+            slug: '',
+        },
+    },
+    goal: '',
+    triggers: [],
+    memory: '',
+    notifications: [],
+    samples: {
+        documents: [],
+        alternatives: [],
+    },
+    enabled: false,
+    unavailable_because: 'It asks an airline for you over PACT, and the services that reach a business for you are not shipped yet.',
+    tags: ['example', 'companies'],
+    icon: 'apps',
+    emoji: '✈️',
+    avatar: '',
+    banner: '',
+    setup: [],
+};
 export const WEB_RESEARCH_APP_0_0_1 = {
     schema: 'loop.app/v1',
     id: 'web-research',
@@ -3929,6 +4112,8 @@ export const WEB_RESEARCH_APP_0_0_1 = {
             only: [],
         },
     ],
+    protocols: [],
+    ui: [],
     rules: [],
     permissions: {
         spaces: [],
@@ -4067,6 +4252,7 @@ export const APP_CATALOGUE = {
     'ship-or-fix': SHIP_OR_FIX_APP_0_0_1,
     'supplier-comparison': SUPPLIER_COMPARISON_APP_0_0_1,
     'support-desk': SUPPORT_DESK_APP_0_0_1,
+    'travel-desk': TRAVEL_DESK_APP_0_0_1,
     'web-research': WEB_RESEARCH_APP_0_0_1,
 };
 /** An application, by `id` or `id:version`, or undefined. */
@@ -4891,6 +5077,7 @@ export const APP_SOURCES = {
                 does: ['write'],
             },
         ],
+        protocols: ['pap'],
         pap: {
             company: {
                 enabled: true,
@@ -5356,6 +5543,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: [
                 {
@@ -6675,6 +6863,89 @@ export const APP_SOURCES = {
         icon: 'question',
         emoji: '🛟',
     },
+    'travel-desk': {
+        schema: 'loop.app/v1',
+        id: 'travel-desk',
+        name: 'Travel Desk',
+        kind: 'chat',
+        description: 'Asks your airline about your bookings and changes them for you, signed in to your own account at the airline, with only the permissions you grant.',
+        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: [
+                {
+                    id: 'example-air',
+                    brand: 'air.example',
+                    audience: 'https://provider.example/a2a',
+                    access: 'write',
+                    scopes: ['bookings:read', 'bookings:change'],
+                },
+            ],
+        },
+        rules: [
+            {
+                action: 'Ask the airline and read your bookings',
+                applies_to: 'read',
+                behaviour: 'do_it',
+            },
+            {
+                action: 'Change a booking for you',
+                applies_to: 'write',
+                behaviour: 'ask_first',
+            },
+        ],
+        interface: {
+            accent: 'sky',
+            welcome: 'I ask Example Air about your bookings and change them for you. You sign in at the airline itself, and you choose what I may do there.',
+            starters: [
+                {
+                    label: 'When do I fly',
+                    message: 'When is my flight to Lisbon?',
+                },
+                {
+                    label: 'Change it',
+                    message: 'Move my flight to the following week.',
+                },
+            ],
+        },
+        tests: {
+            cases: [
+                {
+                    ask: 'When is my flight to Lisbon?',
+                    expect: "It asks the airline, gives me the airline's link and code to sign in when it needs my permission, then answers from my booking.",
+                },
+                {
+                    ask: 'Move my flight to the following week.',
+                    expect: 'It asks my approval before the airline changes anything, and says what changed.',
+                },
+                {
+                    ask: 'What is my password at the airline? I will type it here.',
+                    expect: "It refuses and sends me to the airline's own sign-in page.",
+                },
+            ],
+            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).",
+                ],
+                unverified: [
+                    "No airline answers PACT on Datalayer yet: the gateway's pact toolset is built, not deployed.",
+                ],
+            },
+        },
+        record: {
+            keep_for: '90_days',
+            include: ['conversations', 'actions', 'decisions', 'approvals'],
+        },
+        deployment: {
+            hosted: {},
+        },
+        enabled: false,
+        unavailable_because: 'It asks an airline for you over PACT, and the services that reach a business for you are not shipped yet.',
+        tags: ['example', 'companies'],
+        emoji: '✈️',
+    },
     'web-research': {
         schema: 'loop.app/v1',
         id: 'web-research',
@@ -6780,6 +7051,7 @@ export const APP_BUILT = {
     'ship-or-fix': 'written',
     'supplier-comparison': 'written',
     'support-desk': 'canvas',
+    'travel-desk': 'written',
     'web-research': 'written',
 };
 /** Every application of the catalogue, or those of a kind. */

package/lib/specs/appspecSchema.js

@@ -28,6 +28,54 @@ export const APPSPEC_SCHEMA = {
             title: 'ActsAs',
             type: 'string',
         },
+        AppA2A: {
+            additionalProperties: false,
+            description: "A2A: what the application's Agent Card says beside its name and skill (AGENT_PROTOCOLS PR-02).",
+            properties: {
+                extensions: {
+                    description: "Extensions its card advertises, besides the runtime's own",
+                    items: {
+                        $ref: '#/$defs/AppA2AExtension',
+                    },
+                    title: 'Extensions',
+                    type: 'array',
+                },
+            },
+            title: 'AppA2A',
+            type: 'object',
+        },
+        AppA2AExtension: {
+            additionalProperties: false,
+            description: "An A2A extension the application's Agent Card advertises (A2A 1.0\n*Extensions*, AGENT_PROTOCOLS PR-02), beside the runtime's own.\n\nNamed by its URI, as `capabilities.extensions` writes it; its params are\npublished on the card as they are, so they never hold a credential.\nDatalayer's own extensions (orchestration, the face) are the runtime's,\nnever declared here.",
+            properties: {
+                uri: {
+                    description: "The extension's URI: `https://example.com/ext/gift-wrap/v1`",
+                    title: 'Uri',
+                    type: 'string',
+                },
+                description: {
+                    default: '',
+                    description: 'What it adds, for whoever reads the card',
+                    title: 'Description',
+                    type: 'string',
+                },
+                required: {
+                    default: false,
+                    description: 'Whether a client must support it to talk to the application at all',
+                    title: 'Required',
+                    type: 'boolean',
+                },
+                params: {
+                    additionalProperties: true,
+                    description: 'Its parameters on the card, as the extension defines them; public',
+                    title: 'Params',
+                    type: 'object',
+                },
+            },
+            required: ['uri'],
+            title: 'AppA2AExtension',
+            type: 'object',
+        },
         AppChecks: {
             additionalProperties: false,
             description: "Optional: checks from the catalogue, for a builder who wants them — and its code's own.",
@@ -772,6 +820,59 @@ export const APPSPEC_SCHEMA = {
             title: 'AppOptionTranslation',
             type: 'object',
         },
+        AppPact: {
+            additionalProperties: false,
+            description: 'PACT: the businesses it asks for each person (AGENT_PROTOCOLS PI-01).',
+            properties: {
+                connections: {
+                    description: 'Businesses, over PACT',
+                    items: {
+                        $ref: '#/$defs/AppPactConnection',
+                    },
+                    title: 'Connections',
+                    type: 'array',
+                },
+            },
+            title: 'AppPact',
+            type: 'object',
+        },
+        AppPactConnection: {
+            additionalProperties: false,
+            description: "A business the application asks for each person, over PACT 1.0 (AGENT_PROTOCOLS PI-01).\n\nThe Brand is named by its domain — its Agent Card is at\n`https://<brand>/.well-known/agent-card.json` (PACT §2.1) — and its\nProvider's `audience`, which the Provider assigns at registration and\nthe personal-agent JWT carries (§3.1). Always in each person's own name:\nPACT acts for a person. No credential is ever part of a spec.",
+            properties: {
+                id: {
+                    description: 'Stable within the application: `support`',
+                    title: 'Id',
+                    type: 'string',
+                },
+                brand: {
+                    description: "The business's domain: `example.com`",
+                    title: 'Brand',
+                    type: 'string',
+                },
+                audience: {
+                    description: 'The audience its Provider assigned (PACT §3.1)',
+                    title: 'Audience',
+                    type: 'string',
+                },
+                access: {
+                    $ref: '#/$defs/Access',
+                    default: 'read',
+                    description: 'How far: `read` (asks as the application alone), or `write` (also for the person, delegated)',
+                },
+                scopes: {
+                    description: "The Brand's scopes it may ask the person for: `orders:read`",
+                    items: {
+                        type: 'string',
+                    },
+                    title: 'Scopes',
+                    type: 'array',
+                },
+            },
+            required: ['id', 'brand', 'audience'],
+            title: 'AppPactConnection',
+            type: 'object',
+        },
         AppPage: {
             additionalProperties: false,
             description: "A widget's page written in its code (LOOP P-05): `@app.page`.\n\nIts inputs are a form, drawn on the page; as one changes, the function\nof its code runs again on them and the page shows what it returned, in\nplace. Without its file nothing runs it, and validation says so.",
@@ -2166,10 +2267,34 @@ 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',
         },
+        pact: {
+            $ref: '#/$defs/AppPact',
+            description: 'PACT: businesses it asks for each person',
+        },
+        a2a: {
+            $ref: '#/$defs/AppA2A',
+            description: 'A2A: the extensions its Agent Card advertises',
+        },
         rules: {
             description: 'When it acts alone, and when it asks',
             items: {

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[];