@datalayer/agent-runtimes 1.3.25 → 1.3.28

package/lib/ui-plugins/index.js

@@ -0,0 +1,12 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * UI plugin exports for the chat: how an agent's answer becomes an interface (A2UI, MCP UI).
+ *
+ * @module components/uiPlugins
+ */
+export { UIPluginRegistry } from './UIPluginRegistry';
+export { createA2UIRenderer, A2UIPluginImpl, } from './A2UIPlugin';
+export { createMCPUIRenderer, MCPUIPluginImpl, } from './MCPUIPlugin';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datalayer/agent-runtimes",
-    "version": "1.3.25",
+    "version": "1.3.28",
     "type": "module",
     "workspaces": [
         ".",

package/scripts/codegen/generate_agents.py

@@ -455,8 +455,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_ext = spec.get("ui_plugin") or spec.get("ui_extension")
-            ui_ext_str = f'"{ui_ext}"' if ui_ext else "None"
+            ui_plugin = spec.get("ui_plugin")
+            ui_plugin_str = f'"{ui_plugin}"' if ui_plugin else "None"
             trigger_val = spec.get("trigger")
             model_cfg = spec.get("model_config")
             mcp_srv_tools = spec.get("mcp_server_tools")
@@ -567,7 +567,7 @@ from agent_runtimes.types import (
     goal={goal_str},
     delegable={delegable_str},
     protocol={protocol_str},
-    ui_plugin={ui_ext_str},
+    ui_plugin={ui_plugin_str},
     trigger={_fmt_py_literal(trigger_val)},
     model_configuration={_fmt_py_literal(model_cfg)},
     mcp_server_tools={_fmt_py_literal(mcp_srv_tools)},
@@ -1075,8 +1075,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_ext = spec.get("ui_plugin") or spec.get("ui_extension")
-            ui_ext_ts = f"'{ui_ext}'" if ui_ext else "undefined"
+            ui_plugin = spec.get("ui_plugin")
+            ui_plugin_ts = f"'{ui_plugin}'" if ui_plugin else "undefined"
             trigger_val = spec.get("trigger")
             model_cfg = spec.get("model_config")
             mcp_srv_tools = spec.get("mcp_server_tools")
@@ -1135,7 +1135,7 @@ const FRONTEND_TOOL_MAP: Record<string, any> = {
     goal: {goal_ts},
     delegable: {delegable_ts},
     protocol: {protocol_ts},
-    uiPlugin: {ui_ext_ts},
+    uiPlugin: {ui_plugin_ts},
     trigger: {_fmt_ts_literal(trigger_val)},
     modelConfig: {_fmt_ts_literal(model_cfg)},
     mcpServerTools: {_fmt_ts_literal(mcp_srv_tools)},

package/scripts/codegen/generate_ui_plugins.py

@@ -8,7 +8,7 @@ Generate Python and TypeScript code from YAML UI-plugin specifications.
 A UI plugin 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-plugins``; an agent spec's ``ui_plugin`` names
-one. They were called UI extensions before agentspecs 0.0.11.
+one. A plugin hosts the visual components it renders (LOOP C-13).
 
 Usage:
     python generate_ui_plugins.py \\
@@ -18,6 +18,7 @@ Usage:
 """
 
 import argparse
+import json
 import sys
 from pathlib import Path
 from typing import Any
@@ -53,6 +54,25 @@ def _ts(value: str) -> str:
     return "'" + value.replace("\\", "\\\\").replace("'", "\\'") + "'"
 
 
+def _py_component(component: dict[str, Any]) -> str:
+    """A component as the Python that builds it."""
+    bindings = component.get("bindings")
+    return (
+        "ComponentSpec("
+        f"id={_py(component['id'])}, name={json.dumps(component['name'], ensure_ascii=False)}, "
+        f"description={json.dumps(component['description'].strip(), ensure_ascii=False)}, "
+        f"category={_py(component['category'])}, emoji={json.dumps(component['emoji'], ensure_ascii=False)}, "
+        f"standard={bool(component['standard'])}, "
+        f"properties={component.get('properties')!r}, "
+        + (
+            f"bindings=ComponentBindingsSpec(shows={bindings['shows']!r}, sends={bindings['sends']!r}), "
+            if bindings
+            else "bindings=None, "
+        )
+        + f"events={component.get('events') or []!r}, example={component.get('example')!r})"
+    )
+
+
 def generate_python_code(specs: list[dict[str, Any]]) -> str:
     """Generate Python code from UI-plugin specifications."""
     lines = [
@@ -69,8 +89,7 @@ def generate_python_code(specs: list[dict[str, Any]]) -> str:
         "",
         "from typing import Dict",
         "",
-        "from agent_runtimes.types import UIPluginSpec",
-        "",
+        "from agent_runtimes.types import ComponentBindingsSpec, ComponentSpec, UIPluginSpec",
         "",
         "# " + "=" * 76,
         "# UI Plugin Definitions",
@@ -88,6 +107,10 @@ def generate_python_code(specs: list[dict[str, Any]]) -> str:
                 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', '')))},",
+                "    components=[",
+                *[f"        {_py_component(c)}," for c in spec.get("components") or []],
+                "    ],",
                 ")",
                 "",
             ]
@@ -119,6 +142,25 @@ def generate_python_code(specs: list[dict[str, Any]]) -> str:
             "def list_ui_plugins() -> list[UIPluginSpec]:",
             "    return list(UI_PLUGIN_CATALOGUE.values())",
             "",
+            "",
+            "#: The visual components the enabled 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_PLUGIN_CATALOGUE.values()",
+            "    if plugin.enabled",
+            "    for component in plugin.components",
+            "}",
+            "",
+            "",
+            "def get_component(name: str) -> ComponentSpec | None:",
+            '    """The component a layout names, or None."""',
+            "    return COMPONENT_CATALOGUE.get(name)",
+            "",
+            "",
+            "def list_components() -> list[ComponentSpec]:",
+            "    return list(COMPONENT_CATALOGUE.values())",
+            "",
         ]
     )
     return "\n".join(lines)
@@ -141,7 +183,7 @@ def generate_typescript_code(specs: list[dict[str, Any]]) -> str:
         " * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.",
         " */",
         "",
-        "import type { UIPluginSpec } from '../types/agentspecs';",
+        "import type { ComponentSpec, UIPluginSpec } from '../types/agentspecs';",
         "",
     ]
     for spec in specs:
@@ -155,6 +197,8 @@ def generate_typescript_code(specs: list[dict[str, Any]]) -> str:
                 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"  components: {json.dumps([{**c, 'events': c.get('events', [])} for c in spec.get('components') or []], indent=2, ensure_ascii=False)},",
                 "};",
                 "",
             ]
@@ -177,6 +221,22 @@ def generate_typescript_code(specs: list[dict[str, Any]]) -> str:
             "  return Object.values(UI_PLUGIN_CATALOGUE);",
             "}",
             "",
+            "/** The visual components the enabled 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_PLUGIN_CATALOGUE)",
+            "    .filter(plugin => plugin.enabled)",
+            "    .flatMap(plugin => plugin.components.map(component => [component.id, component])),",
+            ");",
+            "",
+            "/** The component a layout names, or undefined. */",
+            "export function getComponent(name: string): ComponentSpec | undefined {",
+            "  return COMPONENT_CATALOGUE[name];",
+            "}",
+            "",
+            "export function listComponents(): ComponentSpec[] {",
+            "  return Object.values(COMPONENT_CATALOGUE);",
+            "}",
+            "",
         ]
     )
     return "\n".join(lines)

package/lib/extensions/ExtensionRegistry.d.ts

@@ -1,65 +0,0 @@
-/**
- * Extension registry for chat component.
- * Manages custom renderers and extension points.
- *
- * @module components/extensions/ExtensionRegistry
- */
-import type { ChatExtension, MessageRendererExtension, ActivityRendererExtension, ToolUIExtension, ProtocolEventExtension, PanelExtension } from '../types/extensions';
-/** Internal extension type for registry organization */
-export type InternalExtensionType = 'message-renderer' | 'activity-renderer' | 'tool-ui' | 'protocol-event' | 'panel';
-/**
- * Extension registry class
- */
-export declare class ExtensionRegistry {
-    private extensions;
-    private byType;
-    constructor();
-    /**
-     * Register an extension
-     */
-    register(extension: ChatExtension): void;
-    /**
-     * Unregister an extension
-     */
-    unregister(extensionName: string): void;
-    /**
-     * Get an extension by name
-     */
-    get<T extends ChatExtension>(extensionName: string): T | undefined;
-    /**
-     * Get all extensions of a specific type
-     */
-    getByType<T extends ChatExtension>(type: InternalExtensionType): T[];
-    /**
-     * Get all registered extensions
-     */
-    getAll(): ChatExtension[];
-    /**
-     * Check if an extension is registered
-     */
-    has(extensionName: string): boolean;
-    /**
-     * Get message renderers
-     */
-    getMessageRenderers(): MessageRendererExtension[];
-    /**
-     * Get activity renderer for a specific activity type
-     */
-    getActivityRenderer(activityType: string): ActivityRendererExtension | undefined;
-    /**
-     * Get tool UI for a specific tool
-     */
-    getToolUI(toolName: string): ToolUIExtension | undefined;
-    /**
-     * Get all panels
-     */
-    getPanels(): PanelExtension[];
-    /**
-     * Get protocol event handlers for an event type
-     */
-    getProtocolEventHandlers(eventType: string): ProtocolEventExtension[];
-    /**
-     * Clear all extensions
-     */
-    clear(): void;
-}

package/lib/extensions/index.d.ts

@@ -1,9 +0,0 @@
-/**
- * Extension exports for chat component.
- *
- * @module components/extensions
- */
-export { ExtensionRegistry } from './ExtensionRegistry';
-export type { InternalExtensionType } from './ExtensionRegistry';
-export { createA2UIRenderer, A2UIExtensionImpl, type A2UIMessage, } from './A2UIExtension';
-export { createMCPUIRenderer, MCPUIExtensionImpl, type MCPUIMessage, type MCPUIResource, } from './MCPUIExtension';

package/lib/extensions/index.js

@@ -1,12 +0,0 @@
-/*
- * Copyright (c) 2025-2026 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-/**
- * Extension exports for chat component.
- *
- * @module components/extensions
- */
-export { ExtensionRegistry } from './ExtensionRegistry';
-export { createA2UIRenderer, A2UIExtensionImpl, } from './A2UIExtension';
-export { createMCPUIRenderer, MCPUIExtensionImpl, } from './MCPUIExtension';