@datalayer/agent-runtimes 1.3.114 → 1.4.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',
@@ -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: [],
@@ -3922,6 +3962,8 @@ export const TRAVEL_DESK_APP_0_0_1 = {
     context: [],
     contents: [],
     connections: [],
+    protocols: ['pact'],
+    ui: [],
     pact: {
         connections: [
             {
@@ -4070,6 +4112,8 @@ export const WEB_RESEARCH_APP_0_0_1 = {
             only: [],
         },
     ],
+    protocols: [],
+    ui: [],
     rules: [],
     permissions: {
         spaces: [],
@@ -5033,6 +5077,7 @@ export const APP_SOURCES = {
                 does: ['write'],
             },
         ],
+        protocols: ['pap'],
         pap: {
             company: {
                 enabled: true,
@@ -5498,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: [
                 {
@@ -6826,6 +6872,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: [
                 {

package/lib/specs/appspecSchema.js

@@ -2267,6 +2267,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[];

package/lib/specs/protocols.js

@@ -0,0 +1,197 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+export const A2A_PROTOCOL_0_0_1 = {
+    id: 'a2a',
+    version: '0.0.1',
+    name: 'Agent2Agent',
+    description: "How agents talk to agents: teams and scenes talk over it, an application's route serves it, and its Agent Card advertises its extensions.",
+    publisher: 'Google, now the Linux Foundation',
+    layer: 'transport',
+    specUrl: 'https://a2a-protocol.org',
+    specVersion: '1.0',
+    status: 'shipped',
+    connects: 'Other agents, each at its address with its Agent Card',
+    packages: {
+        python: ['fasta2a', 'a2a-sdk'],
+        typescript: ['@a2a-js/sdk'],
+    },
+    protocolTools: [],
+    appspecBlock: 'a2a',
+};
+export const A2UI_PROTOCOL_0_0_1 = {
+    id: 'a2ui',
+    version: '0.0.1',
+    name: 'A2UI',
+    description: "How an agent's answer becomes an interface: components the host renders from a declarative surface.",
+    publisher: 'Google',
+    layer: 'ui',
+    specUrl: 'https://a2ui.org',
+    specVersion: '0.9',
+    status: 'shipped',
+    connects: 'The person, through components an answer draws',
+    packages: {
+        python: ['agent-runtimes'],
+        typescript: ['@a2ui/react', '@a2ui/web_core'],
+    },
+    protocolTools: [],
+};
+export const ACP_PROTOCOL_0_0_1 = {
+    id: 'acp',
+    version: '0.0.1',
+    name: 'Agentic Commerce Protocol',
+    description: 'Checkout sessions at a seller, completed with a delegated payment token the model never sees. Planned in applications: the client exists, purchases wait on a source of payment tokens.',
+    publisher: 'OpenAI, Stripe',
+    layer: 'commerce',
+    specUrl: 'https://github.com/agentic-commerce-protocol/agentic-commerce-protocol',
+    specVersion: '2026-04-17',
+    status: 'planned',
+    connects: 'Sellers, to check out with a delegated payment',
+    packages: {
+        python: ['agent-runtimes'],
+        typescript: ['@datalayer/agent-runtimes'],
+    },
+    protocolTools: ['agentic-commerce'],
+};
+export const AG_UI_PROTOCOL_0_0_1 = {
+    id: 'ag-ui',
+    version: '0.0.1',
+    name: 'AG-UI',
+    description: 'How an agent streams its run to a page: messages, tool calls and state as events.',
+    publisher: 'CopilotKit',
+    layer: 'ui',
+    specUrl: 'https://docs.ag-ui.com',
+    specVersion: '0.0.57 (@ag-ui/core)',
+    status: 'shipped',
+    connects: 'The page a person talks to the agent on',
+    packages: {
+        python: ['ag-ui-protocol'],
+        typescript: ['@ag-ui/client', '@ag-ui/core'],
+    },
+    protocolTools: [],
+};
+export const MCP_PROTOCOL_0_0_1 = {
+    id: 'mcp',
+    version: '0.0.1',
+    name: 'Model Context Protocol',
+    description: 'How an agent calls tools and reads resources: clients and servers in both languages, and the MCP gateway every connection goes through.',
+    publisher: 'Anthropic',
+    layer: 'transport',
+    specUrl: 'https://modelcontextprotocol.io/specification',
+    specVersion: '2026-07-28 (Python), 2025-11-25 (TypeScript)',
+    status: 'shipped',
+    connects: 'Tools, resources and prompts served by MCP servers',
+    packages: {
+        python: ['mcp'],
+        typescript: ['@modelcontextprotocol/sdk', '@mcp-ui/client'],
+    },
+    protocolTools: [],
+};
+export const PACT_PROTOCOL_0_0_1 = {
+    id: 'pact',
+    version: '0.0.1',
+    name: 'Personal Agent Consent & Trust',
+    description: "A personal agent asking a business's agent over A2A, first as itself, then for a person who delegated some of their permissions.",
+    publisher: 'Decagon, Instinct',
+    layer: 'consent',
+    specUrl: 'https://openpactprotocol.org',
+    specVersion: '1.0',
+    status: 'shipped',
+    connects: "Businesses' agents, asked for a person with their delegation",
+    packages: {
+        python: ['agent-runtimes'],
+        typescript: ['@datalayer/agent-runtimes'],
+    },
+    protocolTools: ['pact'],
+    appspecBlock: 'pact',
+};
+export const PAP_PROTOCOL_0_0_1 = {
+    id: 'pap',
+    version: '0.0.1',
+    name: 'Personal Agent Protocol',
+    description: "A person's agent working with a company for them — signed out, then signed in at the company, its changes confirmed by the person — and an application being a company personal agents reach.",
+    publisher: 'Sierra, Meta',
+    layer: 'consent',
+    specUrl: 'https://poppy.md',
+    specVersion: 'draft 0.1',
+    status: 'shipped',
+    connects: "Companies, as a person's agent there, or being one",
+    packages: {
+        python: ['personal-agent-protocol'],
+        typescript: ['@datalayer/personal-agent-protocol'],
+    },
+    protocolTools: ['pap'],
+    appspecBlock: 'pap',
+};
+export const TAP_PROTOCOL_0_0_1 = {
+    id: 'tap',
+    version: '0.0.1',
+    name: 'Trusted Agent Protocol',
+    description: 'An agent-recognition profile over Web Bot Auth for merchants. Planned: nothing is built until its profile is confirmed.',
+    publisher: 'Visa',
+    layer: 'identity',
+    specUrl: 'https://developer.visa.com',
+    specVersion: 'none yet',
+    status: 'planned',
+    connects: 'Merchants that recognise an agent by its signature',
+    packages: {
+        python: [],
+        typescript: [],
+    },
+    protocolTools: [],
+};
+export const UCP_PROTOCOL_0_0_1 = {
+    id: 'ucp',
+    version: '0.0.1',
+    name: 'Universal Commerce Protocol',
+    description: 'Shopping at a merchant: catalogue, checkout and orders, every purchase an exact proposal the person approves. Planned in applications: the client exists, purchases wait on a source of payment tokens.',
+    publisher: 'Google, with Shopify and retailers',
+    layer: 'commerce',
+    specUrl: 'https://github.com/Universal-Commerce-Protocol/ucp',
+    specVersion: '2026-08-25',
+    status: 'planned',
+    connects: 'Merchants, to search, check out and follow orders',
+    packages: {
+        python: ['ucp-sdk', 'agent-runtimes'],
+        typescript: ['@ucp-js/sdk', '@datalayer/agent-runtimes'],
+    },
+    protocolTools: ['ucp'],
+};
+export const WEB_BOT_AUTH_PROTOCOL_0_0_1 = {
+    id: 'web-bot-auth',
+    version: '0.0.1',
+    name: 'Web Bot Auth',
+    description: 'Signed outbound requests (RFC 9421) and the key directory a website checks them against.',
+    publisher: 'Cloudflare (IETF draft)',
+    layer: 'identity',
+    specUrl: 'https://datatracker.ietf.org/doc/draft-ietf-webbotauth-httpsig-protocol/',
+    specVersion: 'draft-ietf-webbotauth-httpsig-protocol-00',
+    status: 'shipped',
+    connects: "Websites, which can tell the application's requests from someone pretending",
+    packages: {
+        python: ['agent-runtimes'],
+        typescript: ['@datalayer/agent-runtimes', 'web-bot-auth'],
+    },
+    protocolTools: [],
+};
+export const PROTOCOL_CATALOGUE = {
+    a2a: A2A_PROTOCOL_0_0_1,
+    a2ui: A2UI_PROTOCOL_0_0_1,
+    acp: ACP_PROTOCOL_0_0_1,
+    'ag-ui': AG_UI_PROTOCOL_0_0_1,
+    mcp: MCP_PROTOCOL_0_0_1,
+    pact: PACT_PROTOCOL_0_0_1,
+    pap: PAP_PROTOCOL_0_0_1,
+    tap: TAP_PROTOCOL_0_0_1,
+    ucp: UCP_PROTOCOL_0_0_1,
+    'web-bot-auth': WEB_BOT_AUTH_PROTOCOL_0_0_1,
+};
+/** A protocol by id. */
+export function getProtocol(protocolId) {
+    return PROTOCOL_CATALOGUE[protocolId];
+}
+/** Every protocol of the catalogue. */
+export function listProtocolSpecs() {
+    return Object.values(PROTOCOL_CATALOGUE);
+}

package/lib/specs/ui.d.ts

@@ -0,0 +1,21 @@
+/**
+ * UI Catalog.
+ *
+ * How an agent's answer becomes an interface: the protocols a host renders.
+ *
+ * This file is AUTO-GENERATED from YAML specifications.
+ * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
+ */
+import type { ComponentSpec, UISpec } from '../types/agentspecs';
+export declare const A2UI_UI_0_0_1: UISpec;
+export declare const MCP_APPS_UI_0_0_1: UISpec;
+export declare const MCP_UI_UI_0_0_1: UISpec;
+export declare const UI_CATALOGUE: Record<string, UISpec>;
+/** The UI an agent spec's `ui` names, or undefined. */
+export declare function getUI(pluginId: string): UISpec | undefined;
+export declare function listUI(): UISpec[];
+/** The visual components the enabled UI specs render, by the name a surface gives them (LOOP C-13). */
+export declare const COMPONENT_CATALOGUE: Record<string, ComponentSpec>;
+/** The component a layout names, or undefined. */
+export declare function getComponent(name: string): ComponentSpec | undefined;
+export declare function listComponents(): ComponentSpec[];

package/lib/specs/{uiPlugins.js → ui.js}

@@ -2,7 +2,7 @@
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-export const A2UI_UI_PLUGIN_0_0_1 = {
+export const A2UI_UI_0_0_1 = {
     id: 'a2ui',
     version: '0.0.1',
     name: 'A2UI',
@@ -1055,7 +1055,7 @@ export const A2UI_UI_PLUGIN_0_0_1 = {
         },
     ],
 };
-export const MCP_APPS_UI_PLUGIN_0_0_1 = {
+export const MCP_APPS_UI_0_0_1 = {
     id: 'mcp-apps',
     version: '0.0.1',
     name: 'MCP Apps',
@@ -1065,7 +1065,7 @@ export const MCP_APPS_UI_PLUGIN_0_0_1 = {
     catalog: '',
     components: [],
 };
-export const MCP_UI_UI_PLUGIN_0_0_1 = {
+export const MCP_UI_UI_0_0_1 = {
     id: 'mcp-ui',
     version: '0.0.1',
     name: 'MCP UI',
@@ -1075,20 +1075,20 @@ export const MCP_UI_UI_PLUGIN_0_0_1 = {
     catalog: '',
     components: [],
 };
-export const UI_PLUGIN_CATALOGUE = {
-    a2ui: A2UI_UI_PLUGIN_0_0_1,
-    'mcp-apps': MCP_APPS_UI_PLUGIN_0_0_1,
-    'mcp-ui': MCP_UI_UI_PLUGIN_0_0_1,
+export const UI_CATALOGUE = {
+    a2ui: A2UI_UI_0_0_1,
+    'mcp-apps': MCP_APPS_UI_0_0_1,
+    'mcp-ui': MCP_UI_UI_0_0_1,
 };
-/** The plugin an agent spec's `uiPlugin` names, or undefined. */
-export function getUIPlugin(pluginId) {
-    return UI_PLUGIN_CATALOGUE[pluginId];
+/** The UI an agent spec's `ui` names, or undefined. */
+export function getUI(pluginId) {
+    return UI_CATALOGUE[pluginId];
 }
-export function listUIPlugins() {
-    return Object.values(UI_PLUGIN_CATALOGUE);
+export function listUI() {
+    return Object.values(UI_CATALOGUE);
 }
-/** The visual components the enabled UI plugins render, by the name a surface gives them (LOOP C-13). */
-export const COMPONENT_CATALOGUE = Object.fromEntries(Object.values(UI_PLUGIN_CATALOGUE)
+/** The visual components the enabled UI specs render, by the name a surface gives them (LOOP C-13). */
+export const COMPONENT_CATALOGUE = Object.fromEntries(Object.values(UI_CATALOGUE)
     .filter(plugin => plugin.enabled)
     .flatMap(plugin => plugin.components.map(component => [component.id, component])));
 /** The component a layout names, or undefined. */

package/lib/types/agentspecs.d.ts

@@ -107,10 +107,10 @@ export interface ComponentSpec {
 }
 /**
  * How an agent's answer becomes an interface: a protocol the host renders
- * (`agentspecs/ui-plugins`). An agent spec's `uiPlugin` names one.
+ * (`agentspecs/ui`). An agent spec's `ui` names one.
  */
-export interface UIPluginSpec {
-    /** What an agent spec's `uiPlugin` names (e.g. 'a2ui'). */
+export interface UISpec {
+    /** What an agent spec's `ui` names (e.g. 'a2ui'). */
     id: string;
     version: string;
     name: string;
@@ -125,6 +125,39 @@ export interface UIPluginSpec {
     /** The visual components it renders (LOOP C-13). */
     components: ComponentSpec[];
 }
+/** The layer of an agent's visit a protocol answers (AGENT_PROTOCOLS §1). */
+export type ProtocolLayer = 'transport' | 'consent' | 'identity' | 'commerce' | 'ui';
+/**
+ * An agent protocol Datalayer targets (`agentspecs/protocols`, AGENT_PROTOCOLS
+ * PS-01). An agent spec's or an application's `protocols` names the ones it speaks.
+ */
+export interface ProtocolSpec {
+    /** What `protocols` lists (e.g. 'pap'). */
+    id: string;
+    version: string;
+    name: string;
+    description: string;
+    /** Who publishes the specification. */
+    publisher: string;
+    layer: ProtocolLayer;
+    /** The specification. */
+    specUrl: string;
+    /** The version implemented. */
+    specVersion: string;
+    /** Implemented by agent-runtimes today, or only planned: an application cannot ship a planned one. */
+    status: 'shipped' | 'planned';
+    /** What it connects an agent to. */
+    connects: string;
+    /** The packages implementing it, by language. */
+    packages: {
+        python: string[];
+        typescript: string[];
+    };
+    /** Its tools' action-class tables (`agentspecs/protocol-tools`). */
+    protocolTools: string[];
+    /** The Appspec block it configures, if any: refused unless `protocols` lists it. */
+    appspecBlock?: 'pap' | 'pact' | 'a2a';
+}
 /** A check a Frame requires of the output of work done under it. */
 export interface FrameGuardSpec {
     id: string;
@@ -1082,6 +1115,14 @@ export interface AppSpec {
     /** The documents and datasets it answers from. */
     contents: string[];
     connections: AppConnectionSpec[];
+    /**
+     * The agent protocols it speaks, ids of `agentspecs/protocols` (AGENT_PROTOCOLS
+     * PS-02): its `pap`, `pact` and `a2a` blocks are refused unless their protocol
+     * is listed, and a planned one only while it is not offered.
+     */
+    protocols: string[];
+    /** The UI its answers render in, ids of `agentspecs/ui` (AGENT_PROTOCOLS PS-04). */
+    ui: string[];
     /** Personal Agent Protocol; absent, the application has none. */
     pap?: AppPapSpec;
     /** PACT: the businesses it asks for each person (AGENT_PROTOCOLS PI-01). */
@@ -1208,8 +1249,13 @@ export interface Agentspec {
     delegable?: AgentCapability[];
     /** Communication protocol (e.g., 'ag-ui', 'acp', 'a2a', 'vercel-ai') */
     protocol?: string;
-    /** UI plugin (e.g., 'a2ui', 'mcp-apps'), one of the `UI_PLUGIN_CATALOGUE`. */
-    uiPlugin?: string;
+    /**
+     * The agent protocols it speaks, ids of `agentspecs/protocols` (AGENT_PROTOCOLS
+     * PS-02). `protocol` says how a page reaches it; this, what it speaks to the world.
+     */
+    protocols?: string[];
+    /** The UI its answers render in (e.g., 'a2ui', 'mcp-apps'), one of the `UI_CATALOGUE`. */
+    ui?: string;
     /** Trigger configuration (type, cron, event source, prompt) */
     trigger?: AgentTriggerConfig;
     /** Model configuration (temperature, max_tokens) */