@datalayer/agent-runtimes 1.3.113 → 1.4.0

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;
@@ -507,6 +540,25 @@ export interface AppPactConnectionSpec {
 export interface AppPactSpec {
     connections: AppPactConnectionSpec[];
 }
+/**
+ * An A2A extension the application's Agent Card advertises, beside the
+ * runtime's own (AGENT_PROTOCOLS PR-02). Its params are public: never a
+ * credential.
+ */
+export interface AppA2AExtensionSpec {
+    /** The extension's URI: an `https://` URL or a `urn:`. */
+    uri: string;
+    /** What it adds, for whoever reads the card. */
+    description: string;
+    /** Whether a client must support it to talk to the application at all. */
+    required: boolean;
+    /** Its parameters on the card, as the extension defines them. */
+    params: Record<string, unknown>;
+}
+/** A2A: the extensions its Agent Card advertises. */
+export interface AppA2ASpec {
+    extensions: AppA2AExtensionSpec[];
+}
 /** When an application acts alone, and when it asks. */
 export interface AppRuleSpec {
     /** The action, in the words a person reads. */
@@ -1063,10 +1115,20 @@ 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). */
     pact?: AppPactSpec;
+    /** A2A: the extensions its Agent Card advertises (AGENT_PROTOCOLS PR-02). */
+    a2a?: AppA2ASpec;
     rules: AppRuleSpec[];
     permissions: AppPermissionsSpec;
     interface: AppInterfaceSpec;
@@ -1187,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) */

package/lib/types/messages.d.ts

@@ -4,6 +4,7 @@
  *
  * @module types/messages
  */
+import type { Display } from '@datalayer/reactor/ui';
 /**
  * Message role enumeration
  */
@@ -121,6 +122,12 @@ export interface ChatMessage {
     note?: 'waiting' | 'failed' | 'stopped';
     /** Optional metadata */
     metadata?: Record<string, unknown>;
+    /**
+     * What the message shows besides its words: the displays sent under it
+     * (`reactor.ui`, REACTOR_UI RU-2), in the order they came; each drawn by
+     * the renderer a plugin contributed for its type.
+     */
+    displays?: Display[];
     /** Tool calls for assistant messages */
     toolCalls?: ToolCallContentPart[];
     /** For activity messages (A2A, A2UI, etc.) */

package/lib/types/protocol.d.ts

@@ -44,6 +44,14 @@ export interface ProtocolConfig {
     enableConfigQuery?: boolean;
     /** Config endpoint URL for non-Jupyter protocols (if not set, uses Jupyter requestAPI) */
     configEndpoint?: string;
+    /**
+     * The ui channel's WebSocket (`ws://` or `wss://`, REACTOR_UI RU-W): an
+     * application's session says on it what its messages show, its steps, its
+     * elements, its authors and its window messages, and takes the presses of
+     * what they offered. Set for an application's agent; one connection per
+     * conversation, its thread the scope.
+     */
+    uiSocket?: string;
     /** Additional protocol options */
     options?: Record<string, unknown>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datalayer/agent-runtimes",
-    "version": "1.3.113",
+    "version": "1.4.0",
     "type": "module",
     "workspaces": [
         ".",
@@ -161,7 +161,7 @@
         "@datalayer/primer-addons": "^1.0.39",
         "@datalayer/primer-rjsf": "^1.0.3",
         "@datalayer/personal-agent-protocol": "^0.6.0",
-        "@datalayer/reactor": "^1.0.4",
+        "@datalayer/reactor": "^1.2.0",
         "@datalayer/reactor-commands": "^1.0.4",
         "@datalayer/reactor-manager": "^1.0.4",
         "@datalayer/reactor-shell": "^1.0.4",

package/scripts/codegen/generate_agents.py

@@ -235,7 +235,10 @@ def load_fragments(specs_dir: Path) -> List[Dict[str, Any]]:
 
 
 def refuse_tools_field(spec: Dict[str, Any], path: Path) -> None:
-    """Refuse an agent spec that still says `tools`: it is `backend_tools` now."""
+    """Refuse an agent spec that still says `tools` (it is `backend_tools` now) or
+    `ui_plugin` (it is `ui` now, AGENT_PROTOCOLS PS-03)."""
+    if "ui_plugin" in spec:
+        raise SystemExit(f"Error: {path} says `ui_plugin`: the field is `ui`, one of agentspecs/ui")
     if "tools" in spec:
         raise SystemExit(
             f"Error: {path} says `tools`: the field is `backend_tools` — the tools "
@@ -288,9 +291,37 @@ def load_yaml_specs(specs_dir: Path) -> List[tuple[str, Dict[str, Any]]]:
         resolved.append((subfolder, spec))
 
     check_model_additionals(resolved, load_model_ids(specs_dir))
+    check_protocols(resolved, load_protocol_ids(specs_dir))
     return resolved
 
 
+def load_protocol_ids(specs_dir: Path) -> set[str]:
+    """Every id of the protocols catalogue (`agentspecs/protocols`, AGENT_PROTOCOLS PS-01)."""
+    ids: set[str] = set()
+    for yaml_file in sorted((specs_dir.parent / "protocols").glob("*.yaml")):
+        protocol = yaml.safe_load(yaml_file.read_text()) or {}
+        if protocol.get("id"):
+            ids.add(str(protocol["id"]))
+    return ids
+
+
+def check_protocols(specs: List[tuple[str, Dict[str, Any]]], protocol_ids: set[str]) -> None:
+    """Refuse an agent whose `protocols` is not a list of the catalogue's ids, each once (PS-02)."""
+    problems = []
+    for _, spec in specs:
+        said = spec.get("protocols")
+        if said is None:
+            continue
+        if not isinstance(said, list) or len(set(map(str, said))) != len(said):
+            problems.append(f"{spec.get('id')}: protocols is a list of protocol ids, each once")
+            continue
+        unknown = [str(p) for p in said if str(p) not in protocol_ids]
+        if unknown:
+            problems.append(f"{spec.get('id')}: protocols names what the catalogue does not know: {', '.join(unknown)}")
+    if problems:
+        raise SystemExit("\n".join(problems))
+
+
 def load_model_ids(specs_dir: Path) -> set[str]:
     """Every id the models catalogue answers to: its ids and their aliases."""
     ids: set[str] = set()
@@ -508,8 +539,8 @@ from agent_runtimes.types import (
             protocol_val = spec.get("protocol")
             protocol_str = f'"{protocol_val}"' if protocol_val else "None"
             delegable_str = _fmt_py_delegable(spec.get("delegable", []))
-            ui_plugin = spec.get("ui_plugin")
-            ui_plugin_str = f'"{ui_plugin}"' if ui_plugin else "None"
+            ui_id = spec.get("ui")
+            ui_str = f'"{ui_id}"' if ui_id else "None"
             trigger_val = spec.get("trigger")
             model_cfg = spec.get("model_config")
             mcp_srv_tools = spec.get("mcp_server_tools")
@@ -620,7 +651,8 @@ from agent_runtimes.types import (
     goal={goal_str},
     delegable={delegable_str},
     protocol={protocol_str},
-    ui_plugin={ui_plugin_str},
+    ui={ui_str},
+    protocols={_fmt_list([str(p) for p in spec.get("protocols") or []])},
     trigger={_fmt_py_literal(trigger_val)},
     model_configuration={_fmt_py_literal(model_cfg)},
     mcp_server_tools={_fmt_py_literal(mcp_srv_tools)},
@@ -1135,8 +1167,8 @@ const FRONTEND_TOOL_MAP: Record<string, any> = {
             protocol_val = spec.get("protocol")
             protocol_ts = f"'{protocol_val}'" if protocol_val else "undefined"
             delegable_ts = _fmt_ts_delegable(spec.get("delegable", []))
-            ui_plugin = spec.get("ui_plugin")
-            ui_plugin_ts = f"'{ui_plugin}'" if ui_plugin else "undefined"
+            ui_id = spec.get("ui")
+            ui_ts = f"'{ui_id}'" if ui_id else "undefined"
             trigger_val = spec.get("trigger")
             model_cfg = spec.get("model_config")
             mcp_srv_tools = spec.get("mcp_server_tools")
@@ -1195,7 +1227,8 @@ const FRONTEND_TOOL_MAP: Record<string, any> = {
     goal: {goal_ts},
     delegable: {delegable_ts},
     protocol: {protocol_ts},
-    uiPlugin: {ui_plugin_ts},
+    ui: {ui_ts},
+    protocols: {_fmt_ts_literal([str(p) for p in spec.get("protocols") or []])},
     trigger: {_fmt_ts_literal(trigger_val)},
     modelConfig: {_fmt_ts_literal(model_cfg)},
     mcpServerTools: {_fmt_ts_literal(mcp_srv_tools)},
@@ -1635,11 +1668,13 @@ export * from './memory';
 export * from './models';
 export * from './modelProviders';
 export * from './notifications';
+export * from './voices';
 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/scripts/codegen/generate_apps.py

@@ -152,8 +152,16 @@ def load_specs(specs_dir: Path) -> tuple[list[dict[str, Any]], dict[str, Any]]:
         # Personal Agent Protocol only when the application says something of it:
         # an Appspec that does not mention `pap` reads back with none (the TypeScript
         # reader's rule), so the catalogue leaves the defaults out too.
-        if "pap" in spec and spec["pap"] == type(app.pap)().model_dump(mode="json", by_alias=True):
+        if "pap" in spec and spec["pap"] == type(app.pap)().model_dump(
+            mode="json", by_alias=True
+        ):
             spec.pop("pap")
+        # PACT and A2A's extensions the same way (AGENT_PROTOCOLS PI-01, PR-02).
+        for block in ("pact", "a2a"):
+            if block in spec and spec[block] == type(getattr(app, block))().model_dump(
+                mode="json", by_alias=True
+            ):
+                spec.pop(block)
         for key in ("description", "instructions", "goal"):
             spec[key] = _flat(spec.get(key))
         spec["interface"]["welcome"] = _flat(spec["interface"].get("welcome"))
@@ -198,8 +206,24 @@ def load_specs(specs_dir: Path) -> tuple[list[dict[str, Any]], dict[str, Any]]:
                 if (signs := actions_module.server_tool_signs(server, name))
             },
         }
+    # The agent protocols' tools (AGENT_PROTOCOLS PR-54): by protocol, the
+    # connection prefix its connections take and what each tool can do.
+    protocols = {
+        identity: {
+            "connection": spec["connection"],
+            "tools": {
+                name: [
+                    item.value
+                    for item in actions_module.protocol_tool_classes(identity, name)
+                ]
+                for name in actions_module.protocol_tool_names(identity)
+            },
+        }
+        for identity, spec in sorted(actions_module.protocol_tool_specs().items())
+    }
     actions = {
         "classes": [item.value for item in actions_module.ActionClass],
+        "protocols": protocols,
         "tools": tools,
         "servers": servers,
         "behaviours": behaviours,
@@ -419,6 +443,10 @@ def generate_actions_python_code(actions: dict[str, Any]) -> str:
         [
             "}",
             "",
+            "#: What each agent protocol's tools do, by protocol id: the prefix its",
+            "#: connections take (`pap:<domain>`) and each tool's classes (PR-54).",
+            f"PROTOCOL_TOOL_CLASSES: Dict[str, Dict[str, Any]] = {actions['protocols']!r}",
+            "",
             "#: What each application of the catalogue does about each classed tool of the",
             "#: servers it connects to, as agentspecs decides it: `do_it`, `if_asked`,",
             "#: `ask_first` or `leave_to_me`. What the rules engine has to reproduce.",
@@ -471,6 +499,15 @@ def generate_actions_typescript_code(actions: dict[str, Any]) -> str:
         + ";",
         "",
         "/**",
+        " * What each agent protocol's tools do, by protocol id: the prefix its",
+        " * connections take (`pap:<domain>`) and each tool's classes (PR-54).",
+        " */",
+        "export const PROTOCOL_TOOL_CLASSES: Record<",
+        "  string,",
+        "  { connection: string; tools: Record<string, ActionClass[]> }",
+        "> = " + json.dumps(actions["protocols"], indent=2) + ";",
+        "",
+        "/**",
         " * What each application of the catalogue does about each classed tool of the",
         " * servers it connects to, as agentspecs decides it. What the rules engine has",
         " * to reproduce.",