@datalayer/agent-runtimes 1.5.16 → 1.5.17

package/lib/specs/uiRenderers.d.ts

@@ -0,0 +1,17 @@
+/**
+ * UI Renderer Catalog.
+ *
+ * How a UI plugin's interface reaches a host that is not Datalayer's own
+ * page (AGENTIC_UI R8): A2UI, MCP Apps, MCP UI.
+ *
+ * This file is AUTO-GENERATED from YAML specifications.
+ * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
+ */
+import type { UiRendererSpec } from '../types/agentspecs';
+export declare const A2UI_UI_RENDERER_0_0_1: UiRendererSpec;
+export declare const MCP_APPS_UI_RENDERER_0_0_1: UiRendererSpec;
+export declare const MCP_UI_UI_RENDERER_0_0_1: UiRendererSpec;
+export declare const UI_RENDERER_CATALOGUE: Record<string, UiRendererSpec>;
+/** The UI renderer a plugin's `renderers` or a `ui` choice names, or undefined. */
+export declare function getUiRenderer(rendererId: string): UiRendererSpec | undefined;
+export declare function listUiRenderers(): UiRendererSpec[];

package/lib/specs/uiRenderers.js

@@ -0,0 +1,40 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+export const A2UI_UI_RENDERER_0_0_1 = {
+    id: 'a2ui',
+    version: '0.0.1',
+    name: 'A2UI',
+    description: 'An agent describes an interface — a form, a table, a card — as a tree of components from a catalogue the host allows, and the host renders it; what the user does in it comes back to the agent as an action.',
+    docsUrl: 'https://a2ui.org/',
+    enabled: true,
+};
+export const MCP_APPS_UI_RENDERER_0_0_1 = {
+    id: 'mcp-apps',
+    version: '0.0.1',
+    name: 'MCP Apps',
+    description: "An MCP server ships an interactive app with a tool: the host renders it in a sandboxed frame beside the conversation, and the app calls the server's tools through the host.",
+    docsUrl: 'https://modelcontextprotocol.io/docs/extensions/apps',
+    enabled: false,
+};
+export const MCP_UI_UI_RENDERER_0_0_1 = {
+    id: 'mcp-ui',
+    version: '0.0.1',
+    name: 'MCP UI',
+    description: 'An MCP tool answers with a UI resource — HTML, a remote page or a component — that the host renders in place of plain text.',
+    docsUrl: 'https://mcpui.dev/',
+    enabled: false,
+};
+export const UI_RENDERER_CATALOGUE = {
+    a2ui: A2UI_UI_RENDERER_0_0_1,
+    'mcp-apps': MCP_APPS_UI_RENDERER_0_0_1,
+    'mcp-ui': MCP_UI_UI_RENDERER_0_0_1,
+};
+/** The UI renderer a plugin's `renderers` or a `ui` choice names, or undefined. */
+export function getUiRenderer(rendererId) {
+    return UI_RENDERER_CATALOGUE[rendererId];
+}
+export function listUiRenderers() {
+    return Object.values(UI_RENDERER_CATALOGUE);
+}

package/lib/types/agentspecs.d.ts

@@ -106,25 +106,71 @@ export interface ComponentSpec {
     example?: Record<string, unknown>;
 }
 /**
- * How an agent's answer becomes an interface: a protocol the host renders
- * (`agentspecs/ui`). An agent spec's `ui` names one.
+ * A UI plugin (`agentspecs/ui`, AGENTIC_UI R8): one Reactor plugin of this
+ * package a Maker composes an interface with, read from its registration, and
+ * the UI renderers it may be exposed through. An agent's or an application's
+ * `ui` names plugins, each with its renderer.
  */
 export interface UISpec {
-    /** What an agent spec's `ui` names (e.g. 'a2ui'). */
+    /** What a `ui` choice's `plugin` names (e.g. 'chat'). */
     id: string;
     version: string;
+    /** What a Maker reads. */
     name: string;
-    /** What the plugin renders, and how the user's action comes back. */
+    /** What it is, in a Maker's words. */
     description: string;
-    /** The protocol's own documentation. */
-    docsUrl: string;
-    /** Whether an agent spec may name it today. */
-    enabled: boolean;
+    /** Its face. */
+    emoji: string;
+    /** Its Octicon. */
+    octicon?: string;
+    /** The name the Reactor plugin registers under. */
+    plugin: string;
+    /** Its folder under `src/apps/plugins`. */
+    folder: string;
+    /** Registered once per application, source or UI spec, as `<plugin>-<its id>`. */
+    per?: 'application' | 'source' | 'ui';
+    /** Its Contributions, as the reactor registers them. */
+    contributions: {
+        /** The Slots it fills. */
+        slots: string[];
+        /** The Contribution Points it contributes to. */
+        points: string[];
+        /** The Commands it adds: Reactor Commands by id, the composer's `/` commands by name. */
+        commands: string[];
+    };
+    /** The Contribution Points it offers. */
+    contributionPoints: string[];
+    /** Its settings, as the JSON Schema of an object; each default the plugin's. */
+    settings: Record<string, unknown>;
+    /** The UI renderers it may be exposed through, ids of `agentspecs/ui-renderers`. */
+    renderers: string[];
     /** The catalog its components are written in. */
     catalog: string;
     /** The visual components it renders (LOOP C-13). */
     components: ComponentSpec[];
 }
+/**
+ * A UI renderer (`agentspecs/ui-renderers`, AGENTIC_UI R8): how a UI plugin's
+ * interface reaches a host that is not Datalayer's own page.
+ */
+export interface UiRendererSpec {
+    /** What a plugin's `renderers` lists (e.g. 'a2ui'). */
+    id: string;
+    version: string;
+    name: string;
+    description: string;
+    /** Its own documentation. */
+    docsUrl: string;
+    /** Whether an application may be exposed through it today. */
+    enabled: boolean;
+}
+/** A UI plugin an agent or an application names, and the renderer it is exposed through, when it is. */
+export interface UiChoice {
+    /** A UI plugin of `agentspecs/ui`, by id. */
+    plugin: string;
+    /** The UI renderer of `agentspecs/ui-renderers` it is exposed through, by id. */
+    renderer?: string;
+}
 /** The layer of an agent's visit a protocol answers (AGENT_PROTOCOLS §1). */
 export type ProtocolLayer = 'transport' | 'consent' | 'identity' | 'commerce' | 'ui';
 /**
@@ -1257,8 +1303,8 @@ export interface AppSpec {
      * 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[];
+    /** Its UI plugins, each with the renderer it is exposed through, when it is (AGENTIC_UI R8). */
+    ui: UiChoice[];
     /** Personal Agent Protocol; absent, the application has none. */
     pap?: AppPapSpec;
     /** PACT: the businesses it asks for each person (AGENT_PROTOCOLS PI-01). */
@@ -1396,8 +1442,8 @@ export interface Agentspec {
      * 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;
+    /** Its UI plugins, each with the renderer it is exposed through, when it is (AGENTIC_UI R8). */
+    ui?: UiChoice[];
     /** Trigger configuration (type, cron, event source, prompt) */
     trigger?: AgentTriggerConfig;
     /** Model configuration (temperature, max_tokens) */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datalayer/agent-runtimes",
-    "version": "1.5.16",
+    "version": "1.5.17",
     "type": "module",
     "workspaces": [
         ".",
@@ -160,7 +160,7 @@
         "@datalayer/lexical-loro": "^1.0.6",
         "@datalayer/primer-addons": "^1.0.39",
         "@datalayer/primer-rjsf": "^1.0.3",
-        "@datalayer/personal-agent-protocol": "^0.15.0",
+        "@datalayer/personal-agent-protocol": "^0.23.0",
         "@datalayer/reactor": "^1.3.0",
         "@datalayer/reactor-commands": "^1.0.4",
         "@datalayer/reactor-manager": "^1.0.4",

package/scripts/codegen/generate_agents.py

@@ -236,9 +236,21 @@ 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) or
-    `ui_plugin` (it is `ui` now, AGENT_PROTOCOLS PS-03)."""
+    `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")
+        raise SystemExit(
+            f"Error: {path} says `ui_plugin`: the field is `ui`, one of agentspecs/ui"
+        )
+    ui = spec.get("ui")
+    if ui is not None and (
+        not isinstance(ui, list)
+        or not all(isinstance(choice, dict) and "plugin" in choice for choice in ui)
+    ):
+        raise SystemExit(
+            f"Error: {path} says `ui: {ui!r}`: `ui` lists UI plugins, each "
+            "`{plugin, renderer}` (AGENTIC_UI R8); a renderer is said as a plugin's `renderer`"
+        )
     if "tools" in spec:
         raise SystemExit(
             f"Error: {path} says `tools`: the field is `backend_tools` — the tools "
@@ -305,7 +317,9 @@ def load_protocol_ids(specs_dir: Path) -> set[str]:
     return ids
 
 
-def check_protocols(specs: List[tuple[str, Dict[str, Any]]], protocol_ids: set[str]) -> None:
+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:
@@ -313,11 +327,15 @@ def check_protocols(specs: List[tuple[str, Dict[str, Any]]], protocol_ids: set[s
         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")
+            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)}")
+            problems.append(
+                f"{spec.get('id')}: protocols names what the catalogue does not know: {', '.join(unknown)}"
+            )
     if problems:
         raise SystemExit("\n".join(problems))
 
@@ -539,8 +557,7 @@ 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_id = spec.get("ui")
-            ui_str = f'"{ui_id}"' if ui_id else "None"
+            ui_str = _fmt_py_literal(list(spec.get("ui") or []))
             trigger_val = spec.get("trigger")
             model_cfg = spec.get("model_config")
             mcp_srv_tools = spec.get("mcp_server_tools")
@@ -1167,8 +1184,7 @@ 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_id = spec.get("ui")
-            ui_ts = f"'{ui_id}'" if ui_id else "undefined"
+            ui_ts = _fmt_ts_literal(list(spec.get("ui") or []))
             trigger_val = spec.get("trigger")
             model_cfg = spec.get("model_config")
             mcp_srv_tools = spec.get("mcp_server_tools")
@@ -1674,6 +1690,7 @@ export * from './skills';
 export * from './backendTools';
 export * from './triggers';
 export * from './ui';
+export * from './uiRenderers';
 export * from './protocols';
 export * from './frames';
 export * from './cogs';

package/scripts/codegen/generate_ui.py

@@ -5,10 +5,13 @@
 """
 Generate Python and TypeScript code from YAML UI specifications.
 
-A UI spec is how an agent's answer becomes an interface rather than text —
-a protocol the host knows how to render (A2UI, MCP Apps, MCP UI). One YAML per
-plugin under ``agentspecs/ui``; an agent spec's ``ui`` names
-one. A UI spec hosts the visual components it renders (LOOP C-13).
+A UI spec is one Reactor plugin of this package (``src/apps/plugins/``) a
+Maker composes an interface with (AGENTIC_UI R8): its registered name, its
+Contributions, the Contribution Points it offers, its settings, the visual
+components it renders (LOOP C-13) and the UI renderers it may be exposed
+through (``agentspecs/ui-renderers``, ``generate_ui_renderers.py``). One YAML
+per plugin under ``agentspecs/ui``; an agent's or an application's ``ui``
+names plugins, each with its renderer.
 
 Usage:
     python generate_ui.py \\
@@ -29,7 +32,13 @@ from versioning import ensure_spec_version, version_suffix
 
 
 def load_plugin_specs(specs_dir: Path) -> list[dict[str, Any]]:
-    """Load all UI YAML specifications from a directory."""
+    """Load all UI YAML specifications from a directory.
+
+    A spec of the old shape — a renderer listed as a UI, with no `plugin` —
+    is refused, and so is a renderer the `ui-renderers` beside it does not have.
+    """
+    renderers_dir = specs_dir.parent / "ui-renderers"
+    renderers = {path.stem for path in renderers_dir.glob("*.yaml")}
     specs = []
     for yaml_file in sorted(specs_dir.glob("*.yaml")):
         with open(yaml_file) as f:
@@ -39,6 +48,16 @@ def load_plugin_specs(specs_dir: Path) -> list[dict[str, Any]]:
                 raise ValueError(
                     f"{yaml_file.name}: the file is named for id {yaml_file.stem!r}, the spec says {spec['id']!r}"
                 )
+            if "plugin" not in spec:
+                raise ValueError(
+                    f"{yaml_file.name}: a UI spec is a Reactor plugin (`plugin`); "
+                    "a renderer is a spec of agentspecs/ui-renderers"
+                )
+            for renderer in spec.get("renderers") or []:
+                if renderer not in renderers:
+                    raise ValueError(
+                        f"{yaml_file.name}: there is no UI renderer {renderer!r} in {renderers_dir}"
+                    )
             specs.append(spec)
     return specs
 
@@ -122,8 +141,6 @@ def _py_calls(specs: list[dict[str, Any]]) -> list[str]:
         "        self._place = place",
     ]
     for spec in specs:
-        if not spec.get("enabled", True):
-            continue
         for component in spec.get("components") or []:
             schema = component.get("properties") or {}
             required = set(schema.get("required") or [])
@@ -203,7 +220,7 @@ def generate_python_code(specs: list[dict[str, Any]]) -> str:
         '"""',
         "UI Catalog.",
         "",
-        "How an agent's answer becomes an interface: the protocols a host renders.",
+        "The UI plugins: the Reactor plugins an interface is made of (AGENTIC_UI R8).",
         "",
         "This file is AUTO-GENERATED from YAML specifications.",
         "DO NOT EDIT MANUALLY - run 'make specs' to regenerate.",
@@ -211,7 +228,12 @@ def generate_python_code(specs: list[dict[str, Any]]) -> str:
         "",
         "from typing import Any, Callable, Dict, List, Literal, Mapping, Optional, Union",
         "",
-        "from agent_runtimes.types import ComponentBindingsSpec, ComponentSpec, UISpec",
+        "from agent_runtimes.types import (",
+        "    ComponentBindingsSpec,",
+        "    ComponentSpec,",
+        "    UiContributionsSpec,",
+        "    UISpec,",
+        ")",
         "",
         "# " + "=" * 76,
         "# UI Definitions",
@@ -227,9 +249,20 @@ def generate_python_code(specs: list[dict[str, Any]]) -> str:
                 f"    version={_py(str(spec['version']))},",
                 f"    name={_py(spec['name'])},",
                 f"    description={_py(str(spec.get('description', '')).strip())},",
-                f"    docs_url={_py(str(spec.get('docs_url', '')))},",
-                f"    enabled={bool(spec.get('enabled', True))},",
-                f"    catalog={_py(str(spec.get('catalog', '')))},",
+                f"    emoji={json.dumps(spec['emoji'], ensure_ascii=False)},",
+                f"    octicon={_py(spec['octicon']) if spec.get('octicon') else 'None'},",
+                f"    plugin={_py(spec['plugin'])},",
+                f"    folder={_py(spec['folder'])},",
+                f"    per={_py(spec['per']) if spec.get('per') else 'None'},",
+                "    contributions=UiContributionsSpec(",
+                f"        slots={list((spec.get('contributions') or {}).get('slots') or [])!r},",
+                f"        points={list((spec.get('contributions') or {}).get('points') or [])!r},",
+                f"        commands={list((spec.get('contributions') or {}).get('commands') or [])!r},",
+                "    ),",
+                f"    contribution_points={list(spec.get('contribution_points') or [])!r},",
+                f"    settings={spec.get('settings') or {}!r},",
+                f"    renderers={list(spec.get('renderers') or [])!r},",
+                f"    catalog={_py(str(spec.get('catalog') or ''))},",
                 "    components=[",
                 *[f"        {_py_component(c)}," for c in spec.get("components") or []],
                 "    ],",
@@ -257,7 +290,7 @@ def generate_python_code(specs: list[dict[str, Any]]) -> str:
             "",
             "",
             "def get_ui(plugin_id: str) -> UISpec | None:",
-            '    """The UI an agent spec\'s `ui` names, or None."""',
+            '    """The UI plugin an agent\'s or an application\'s `ui` names, or None."""',
             "    return UI_CATALOGUE.get(plugin_id)",
             "",
             "",
@@ -265,12 +298,11 @@ def generate_python_code(specs: list[dict[str, Any]]) -> str:
             "    return list(UI_CATALOGUE.values())",
             "",
             "",
-            "#: The visual components the enabled UI specs render, by the name a",
+            "#: The visual components the UI plugins render, by the name a",
             "#: surface gives them (LOOP C-13).",
             "COMPONENT_CATALOGUE: Dict[str, ComponentSpec] = {",
             "    component.id: component",
             "    for plugin in UI_CATALOGUE.values()",
-            "    if plugin.enabled",
             "    for component in plugin.components",
             "}",
             "",
@@ -300,7 +332,7 @@ def generate_typescript_code(specs: list[dict[str, Any]]) -> str:
         "/**",
         " * UI Catalog.",
         " *",
-        " * How an agent's answer becomes an interface: the protocols a host renders.",
+        " * The UI plugins: the Reactor plugins an interface is made of (AGENTIC_UI R8).",
         " *",
         " * This file is AUTO-GENERATED from YAML specifications.",
         " * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.",
@@ -318,9 +350,24 @@ def generate_typescript_code(specs: list[dict[str, Any]]) -> str:
                 f"  version: {_ts(str(spec['version']))},",
                 f"  name: {_ts(spec['name'])},",
                 f"  description: {_ts(str(spec.get('description', '')).strip())},",
-                f"  docsUrl: {_ts(str(spec.get('docs_url', '')))},",
-                f"  enabled: {'true' if spec.get('enabled', True) else 'false'},",
-                f"  catalog: {_ts(str(spec.get('catalog', '')))},",
+                f"  emoji: {json.dumps(spec['emoji'], ensure_ascii=False)},",
+                *(
+                    [f"  octicon: {_ts(spec['octicon'])},"]
+                    if spec.get("octicon")
+                    else []
+                ),
+                f"  plugin: {_ts(spec['plugin'])},",
+                f"  folder: {_ts(spec['folder'])},",
+                *([f"  per: {_ts(spec['per'])},"] if spec.get("per") else []),
+                "  contributions: {",
+                f"    slots: {json.dumps(list((spec.get('contributions') or {}).get('slots') or []))},",
+                f"    points: {json.dumps(list((spec.get('contributions') or {}).get('points') or []))},",
+                f"    commands: {json.dumps(list((spec.get('contributions') or {}).get('commands') or []))},",
+                "  },",
+                f"  contributionPoints: {json.dumps(list(spec.get('contribution_points') or []))},",
+                f"  settings: {json.dumps(spec.get('settings') or {}, ensure_ascii=False)},",
+                f"  renderers: {json.dumps(list(spec.get('renderers') or []))},",
+                f"  catalog: {_ts(str(spec.get('catalog') or ''))},",
                 f"  components: {json.dumps([{**c, 'events': c.get('events', [])} for c in spec.get('components') or []], indent=2, ensure_ascii=False)},",
                 "};",
                 "",
@@ -335,7 +382,7 @@ def generate_typescript_code(specs: list[dict[str, Any]]) -> str:
         [
             "};",
             "",
-            "/** The UI an agent spec's `ui` names, or undefined. */",
+            "/** The UI plugin an agent's or an application's `ui` names, or undefined. */",
             "export function getUI(pluginId: string): UISpec | undefined {",
             "  return UI_CATALOGUE[pluginId];",
             "}",
@@ -344,10 +391,9 @@ def generate_typescript_code(specs: list[dict[str, Any]]) -> str:
             "  return Object.values(UI_CATALOGUE);",
             "}",
             "",
-            "/** The visual components the enabled UI specs render, by the name a surface gives them (LOOP C-13). */",
+            "/** The visual components the UI plugins render, by the name a surface gives them (LOOP C-13). */",
             "export const COMPONENT_CATALOGUE: Record<string, ComponentSpec> = Object.fromEntries(",
             "  Object.values(UI_CATALOGUE)",
-            "    .filter(plugin => plugin.enabled)",
             "    .flatMap(plugin => plugin.components.map(component => [component.id, component])),",
             ");",
             "",

package/scripts/codegen/generate_ui_renderers.py

@@ -0,0 +1,176 @@
+#!/usr/bin/env python3
+# Copyright (c) 2025-2026 Datalayer, Inc.
+# Distributed under the terms of the Modified BSD License.
+
+"""
+Generate Python and TypeScript code from the YAML UI renderer specifications.
+
+One YAML per UI renderer under ``agentspecs/ui-renderers`` (AGENTIC_UI R8,
+F-01): how a UI plugin's interface reaches a host that is not Datalayer's own
+page — A2UI, MCP Apps, MCP UI. A UI plugin (``agentspecs/ui``) says the
+renderers it may be exposed through; an agent's or an application's ``ui``
+names, per plugin, the one it uses.
+
+Usage:
+    python generate_ui_renderers.py \\
+      --specs-dir agentspecs/agentspecs/ui-renderers \\
+      --python-output agent_runtimes/specs/ui_renderers.py \\
+      --typescript-output src/specs/uiRenderers.ts
+"""
+
+import argparse
+import json
+from pathlib import Path
+from typing import Any
+
+import yaml
+from versioning import ensure_spec_version, version_suffix
+
+FIELDS = {"id", "version", "name", "description", "docs_url", "enabled"}
+
+
+def load_ui_renderer_specs(specs_dir: Path) -> list[dict[str, Any]]:
+    """Every UI renderer spec of a directory, each named for its id, with its fields and no other."""
+    specs = []
+    for yaml_file in sorted(specs_dir.glob("*.yaml")):
+        spec = yaml.safe_load(yaml_file.read_text()) or {}
+        ensure_spec_version(spec)
+        if spec["id"] != yaml_file.stem:
+            raise ValueError(
+                f"{yaml_file.name}: the file is named for {yaml_file.stem!r}, the spec says {spec['id']!r}"
+            )
+        if set(spec) != FIELDS:
+            raise ValueError(f"{yaml_file.name}: a UI renderer says {sorted(FIELDS)}")
+        specs.append(spec)
+    return specs
+
+
+def _const(spec: dict[str, Any]) -> str:
+    return (
+        spec["id"].replace("-", "_").upper()
+        + "_UI_RENDERER"
+        + version_suffix(spec["version"])
+    )
+
+
+def _s(value: Any) -> str:
+    return json.dumps(" ".join(str(value).split()), ensure_ascii=False)
+
+
+def generate_python_code(specs: list[dict[str, Any]]) -> str:
+    """The Python catalogue of the UI renderers."""
+    lines = [
+        "# Copyright (c) 2025-2026 Datalayer, Inc.",
+        "# Distributed under the terms of the Modified BSD License.",
+        '"""',
+        "UI Renderer Catalog.",
+        "",
+        "How a UI plugin's interface reaches a host that is not Datalayer's own page",
+        "(AGENTIC_UI R8): A2UI, MCP Apps, MCP UI.",
+        "",
+        "This file is AUTO-GENERATED from YAML specifications.",
+        "DO NOT EDIT MANUALLY - run 'make specs' to regenerate.",
+        '"""',
+        "",
+        "from typing import Dict",
+        "",
+        "from agent_runtimes.types import UiRendererSpec",
+        "",
+    ]
+    for spec in specs:
+        lines += [
+            f"{_const(spec)} = UiRendererSpec(",
+            f"    id={_s(spec['id'])},",
+            f"    version={_s(spec['version'])},",
+            f"    name={_s(spec['name'])},",
+            f"    description={_s(spec['description'])},",
+            f"    docs_url={_s(spec['docs_url'])},",
+            f"    enabled={bool(spec['enabled'])},",
+            ")",
+            "",
+        ]
+    lines += ["UI_RENDERER_CATALOGUE: Dict[str, UiRendererSpec] = {"]
+    lines += [f"    {_s(spec['id'])}: {_const(spec)}," for spec in specs]
+    lines += [
+        "}",
+        "",
+        "",
+        "def get_ui_renderer(renderer_id: str) -> UiRendererSpec | None:",
+        '    """The UI renderer a plugin\'s `renderers` or a `ui` choice names, or None."""',
+        "    return UI_RENDERER_CATALOGUE.get(renderer_id)",
+        "",
+        "",
+        "def list_ui_renderers() -> list[UiRendererSpec]:",
+        "    return list(UI_RENDERER_CATALOGUE.values())",
+        "",
+    ]
+    return "\n".join(lines)
+
+
+def generate_typescript_code(specs: list[dict[str, Any]]) -> str:
+    """The TypeScript catalogue of the UI renderers."""
+    lines = [
+        "/*",
+        " * Copyright (c) 2025-2026 Datalayer, Inc.",
+        " * Distributed under the terms of the Modified BSD License.",
+        " */",
+        "",
+        "/**",
+        " * UI Renderer Catalog.",
+        " *",
+        " * How a UI plugin's interface reaches a host that is not Datalayer's own",
+        " * page (AGENTIC_UI R8): A2UI, MCP Apps, MCP UI.",
+        " *",
+        " * This file is AUTO-GENERATED from YAML specifications.",
+        " * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.",
+        " */",
+        "",
+        "import type { UiRendererSpec } from '../types/agentspecs';",
+        "",
+    ]
+    for spec in specs:
+        lines += [
+            f"export const {_const(spec)}: UiRendererSpec = {{",
+            f"  id: {_s(spec['id'])},",
+            f"  version: {_s(spec['version'])},",
+            f"  name: {_s(spec['name'])},",
+            f"  description: {_s(spec['description'])},",
+            f"  docsUrl: {_s(spec['docs_url'])},",
+            f"  enabled: {'true' if spec['enabled'] else 'false'},",
+            "};",
+            "",
+        ]
+    lines += ["export const UI_RENDERER_CATALOGUE: Record<string, UiRendererSpec> = {"]
+    lines += [f"  {_s(spec['id'])}: {_const(spec)}," for spec in specs]
+    lines += [
+        "};",
+        "",
+        "/** The UI renderer a plugin's `renderers` or a `ui` choice names, or undefined. */",
+        "export function getUiRenderer(rendererId: string): UiRendererSpec | undefined {",
+        "  return UI_RENDERER_CATALOGUE[rendererId];",
+        "}",
+        "",
+        "export function listUiRenderers(): UiRendererSpec[] {",
+        "  return Object.values(UI_RENDERER_CATALOGUE);",
+        "}",
+        "",
+    ]
+    return "\n".join(lines)
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--specs-dir", type=Path, required=True)
+    parser.add_argument("--python-output", type=Path, required=True)
+    parser.add_argument("--typescript-output", type=Path, required=True)
+    args = parser.parse_args()
+    specs = load_ui_renderer_specs(args.specs_dir)
+    args.python_output.write_text(generate_python_code(specs))
+    args.typescript_output.write_text(generate_typescript_code(specs))
+    print(
+        f"Generated {len(specs)} UI renderers: {args.python_output}, {args.typescript_output}"
+    )
+
+
+if __name__ == "__main__":
+    main()