@datalayer/agent-runtimes 1.5.16 → 1.5.18

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/specs/voices.d.ts

@@ -45,6 +45,8 @@ export interface SpeechModelSpec {
     id: string;
     version: string;
     name: string;
+    /** What it is for, in a sentence or two. */
+    description: string;
     task: 'stt' | 'tts' | 'vad';
     engine: string;
     dtype: string;

package/lib/specs/voices.js

@@ -72,6 +72,7 @@ export const SPEECH_MODEL_CATALOGUE = {
         id: 'kokoro-82m',
         version: '0.0.1',
         name: 'Kokoro 82M',
+        description: "Text to speech on Datalayer's servers, on CPU: hexgrad's Kokoro-82M v1.0 exported to ONNX, in full precision, with the voices file that holds its 54 voices, run by kokoro-onnx. Its phonemes come from eSpeak NG (GPL-3.0), which runs on the server and is never sent to a browser. Full precision, not the 8-bit export: on a 16-core CPU the 8-bit one speaks slower than real time (6 s for 3.9 s of speech), this one about four times faster than real time (1 s).",
         task: 'tts',
         engine: 'kokoro-onnx',
         dtype: 'fp32',
@@ -102,6 +103,7 @@ export const SPEECH_MODEL_CATALOGUE = {
         id: 'moonshine-base-en',
         version: '0.0.1',
         name: 'Moonshine Base (English)',
+        description: "Speech to text in the browser, in English: Useful Sensors' Moonshine Base (61M parameters), its ONNX export quantized to 8 bits, run by transformers.js. One of the English models whose weights are MIT; the legacy non-English Moonshine models are under a non-commercial licence and are not listed.",
         task: 'stt',
         engine: 'transformers.js',
         dtype: 'q8',
@@ -162,6 +164,7 @@ export const SPEECH_MODEL_CATALOGUE = {
         id: 'moonshine-tiny-en',
         version: '0.0.1',
         name: 'Moonshine Tiny (English)',
+        description: "Speech to text in the browser, in English: Useful Sensors' Moonshine Tiny (27M parameters), its ONNX export quantized to 8 bits, run by transformers.js. One of the English models whose weights are MIT; the legacy non-English Moonshine models are under a non-commercial licence and are not listed.",
         task: 'stt',
         engine: 'transformers.js',
         dtype: 'q8',
@@ -222,6 +225,7 @@ export const SPEECH_MODEL_CATALOGUE = {
         id: 'silero-vad',
         version: '0.0.1',
         name: 'Silero VAD',
+        description: 'Where speech starts and ends in what the microphone heard, in the browser: Silero VAD (about 2 MB), the build @ricky0123/vad-web 0.0.31 ships and runs on onnxruntime-web. Push-to-talk keeps the speech it finds and drops the rest.',
         task: 'vad',
         engine: 'vad-web',
         dtype: 'fp32',
@@ -247,6 +251,7 @@ export const SPEECH_MODEL_CATALOGUE = {
         id: 'whisper-base',
         version: '0.0.1',
         name: 'Whisper Base',
+        description: "Speech to text in the browser for the languages Moonshine's MIT models do not speak, French first: OpenAI's Whisper base (74M parameters, 99 languages), its ONNX export quantized to 8 bits, run by transformers.js. A clip at a time.",
         task: 'stt',
         engine: 'transformers.js',
         dtype: 'q8',

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) */
@@ -1437,6 +1483,11 @@ export interface Agentspec {
     parameters?: Record<string, any>;
     /** Subagent delegation configuration. */
     subagents?: SubAgentsConfig;
+    /**
+     * Its voice, for an agent that is not an application (VOICE.md VO-41):
+     * the fields an Appspec says under `interface.voice`; absent when unsaid.
+     */
+    voice?: AppVoiceSpec;
 }
 /**
  * Where a subagent reached over A2A lives, or how to launch it.

package/lib/types/chat.d.ts

@@ -1004,6 +1004,12 @@ export interface ChatBaseProps {
     voiceSpeaking?: boolean;
     /** Stops the agent's voice: the composer's *Stop speaking*, and the microphone opening (VO-13). */
     onStopSpeaking?: () => void;
+    /**
+     * Reads an answer aloud (VOICE.md VO-21): given, each answer the agent has
+     * finished writing has a *Read aloud* under it, which calls it with the
+     * answer's text.
+     */
+    onReadAloud?: (answer: string) => void;
     /**
      * Show the information icon in the header.
      * When clicked, fires onInformationClick.

package/lib/types/protocol.d.ts

@@ -59,6 +59,23 @@ export interface ProtocolConfig {
      * never the bytes. Set for an application's agent.
      */
     uiFiles?: string;
+    /**
+     * The application's sessions (`…/api/v1/apps/sessions`), each AG-UI thread
+     * one of them: Stop is its session's (`{appSessions}/{thread}/stop`). Set
+     * for an application's agent. The runtime's generic `/ag-ui/terminate`
+     * never knew a session's thread, and a deployment's runtime does not
+     * answer it (OwnRoutesOnly).
+     */
+    appSessions?: string;
+    /**
+     * The runtime answers only the application's own routes (OwnRoutesOnly,
+     * PAP_DATALAYER's release gates): it serves a deployment — kept always on,
+     * launched by a hosted page for it — or is the visitors' runtime. Nothing
+     * outside them is opened: not the monitoring stream (an application's
+     * session asks its approvals in the conversation, over `uiSocket`), not
+     * the sandbox's socket, nor any runtime-wide setting. Needs `appSessions`.
+     */
+    ownRoutesOnly?: boolean;
     /** Additional protocol options */
     options?: Record<string, unknown>;
 }

package/lib/utils/utils.js

@@ -195,7 +195,14 @@ export function createProtocolAdapter(config) {
     };
     switch (config.type) {
         case 'ag-ui':
-            return new AGUIAdapter(adapterConfig);
+            if (config.ownRoutesOnly && !config.appSessions) {
+                // Its runtime answers no generic Stop: an application's own or none.
+                throw new Error('A chat whose runtime answers only the application’s own routes is an application’s: it needs its sessions (appSessions).');
+            }
+            return new AGUIAdapter({
+                ...adapterConfig,
+                ...(config.appSessions ? { appSessions: config.appSessions } : {}),
+            });
         case 'a2a':
             return new A2AAdapter(adapterConfig);
         case 'vercel-ai':

package/lib/voice/ReadAloud.d.ts

@@ -0,0 +1,35 @@
+/**
+ * *Read aloud*, under an answer (VOICE.md VO-21, `on_request`): the answer,
+ * read as plain words and cut into sentences, given to the speaker — what it
+ * was saying stops first. The press is the gesture a browser plays sound
+ * after.
+ *
+ * @module voice/ReadAloud
+ */
+import type { JSX } from 'react';
+import type { SentenceSink } from './useSpokenAnswers';
+/** What *Read aloud* gives an answer to: a sink a press may unlock. */
+export interface ReadingSink extends SentenceSink {
+    unlock?: () => void;
+}
+/** An answer read from its start: what was being said stops, its sentences follow. */
+export declare function readAloud(sink: ReadingSink, answer: string): string[];
+/** A message, as far as *Read aloud* reads it. */
+export interface ReadableMessage {
+    id: string;
+    role: string;
+    live?: boolean;
+    note?: unknown;
+}
+/**
+ * Whether a message has *Read aloud* under it: an answer of the agent with
+ * words, finished — not live, and not the one the agent is writing now.
+ */
+export declare function readsAloud(message: ReadableMessage, text: string, writingId: string | undefined): boolean;
+export interface ReadAloudProps {
+    /** Reads the answer aloud. */
+    onRead: () => void;
+}
+/** The button under an answer. */
+export declare function ReadAloud({ onRead }: ReadAloudProps): JSX.Element;
+export default ReadAloud;

package/lib/voice/ReadAloud.js

@@ -0,0 +1,29 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { IconButton, Tooltip } from '@primer/react';
+import { UnmuteIcon } from '@primer/octicons-react';
+import { SentenceCutter } from './sentences';
+/** An answer read from its start: what was being said stops, its sentences follow. */
+export function readAloud(sink, answer) {
+    sink.unlock?.();
+    sink.stop();
+    const cutter = new SentenceCutter();
+    const sentences = [...cutter.feed(answer), ...cutter.end(answer)];
+    sentences.forEach(sentence => sink.say(sentence));
+    return sentences;
+}
+/**
+ * Whether a message has *Read aloud* under it: an answer of the agent with
+ * words, finished — not live, and not the one the agent is writing now.
+ */
+export function readsAloud(message, text, writingId) {
+    return (message.role === 'assistant' &&
+        !message.live &&
+        !message.note &&
+        message.id !== writingId &&
+        text.trim().length > 0);
+}
+/** The button under an answer. */
+export function ReadAloud({ onRead }) {
+    return (_jsx(Tooltip, { text: "Read aloud", direction: "n", children: _jsx(IconButton, { "data-read-aloud": "", icon: UnmuteIcon, "aria-label": "Read aloud", size: "small", variant: "invisible", onClick: onRead }) }));
+}
+export default ReadAloud;

package/lib/voice/index.d.ts

@@ -18,6 +18,8 @@ export * from './consent';
 export * from './useSpokenAnswers';
 export { VoiceInput } from './VoiceInput';
 export type { VoiceInputProps, ListeningState } from './VoiceInput';
+export { ReadAloud, readAloud, readsAloud } from './ReadAloud';
+export type { ReadAloudProps, ReadableMessage, ReadingSink } from './ReadAloud';
 /**
  * A chat's voice: what a host gives `ChatBase` and `ChatFloating` to let a
  * person talk to the agent and hear it — the Appspec's `interface.voice`,
@@ -28,8 +30,11 @@ export interface ChatVoice {
     language: string;
     /** `push_to_talk`, or `off`. Hands-free is Phase V3. */
     input: 'off' | 'push_to_talk';
-    /** When answers are heard: `always`, or `off`. */
-    output: 'off' | 'always';
+    /**
+     * When answers are heard: `always`, as they are written; `on_request`, a
+     * *Read aloud* under each answer (VO-21); or `off`.
+     */
+    output: 'off' | 'on_request' | 'always';
     /** The voice of the catalogue answers are spoken with. */
     voice: string;
     /** Datalayer's origin for the browser's models: the pinned store. */

package/lib/voice/index.js

@@ -11,3 +11,4 @@ export * from './speaker';
 export * from './consent';
 export * from './useSpokenAnswers';
 export { VoiceInput } from './VoiceInput';
+export { ReadAloud, readAloud, readsAloud } from './ReadAloud';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datalayer/agent-runtimes",
-    "version": "1.5.16",
+    "version": "1.5.18",
     "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.24.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 "
@@ -292,9 +304,33 @@ def load_yaml_specs(specs_dir: Path) -> List[tuple[str, Dict[str, Any]]]:
 
     check_model_additionals(resolved, load_model_ids(specs_dir))
     check_protocols(resolved, load_protocol_ids(specs_dir))
+    check_voices(resolved)
     return resolved
 
 
+def check_voices(specs: List[tuple[str, Dict[str, Any]]]) -> None:
+    """Refuse an agent whose `voice` is not an `interface.voice` block of the voice catalogue (VOICE.md VO-41)."""
+    from agentspecs.apps import agent_voice_problems
+
+    problems = [
+        problem
+        for _, spec in specs
+        if "voice" in spec
+        for problem in agent_voice_problems(str(spec.get("id")), spec["voice"])
+    ]
+    if problems:
+        raise SystemExit("\n".join(problems))
+
+
+def voice_of(spec: Dict[str, Any]) -> Dict[str, Any] | None:
+    """An agent's voice with every field said, as the Appspec's block reads it; None when unsaid."""
+    if "voice" not in spec:
+        return None
+    from agentspecs.apps import AppVoice
+
+    return AppVoice(**spec["voice"]).model_dump(mode="json")
+
+
 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()
@@ -305,7 +341,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 +351,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))
 
@@ -507,6 +549,10 @@ from agent_runtimes.types import (
                 if model_additionals
                 else ""
             )
+            voice = voice_of(spec)
+            voice_py_line = (
+                f"    voice={_fmt_py_literal(voice)},\n" if voice is not None else ""
+            )
             inference_provider = spec.get("inference_provider")
             inference_provider_str = (
                 f'"{inference_provider}"' if inference_provider else "None"
@@ -539,8 +585,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")
@@ -670,7 +715,7 @@ from agent_runtimes.types import (
     tool_hooks={_fmt_py_literal(tool_hooks_val)},
     parameters={_fmt_py_literal(parameters_val)},
     subagents={subagents_str},
-)
+{voice_py_line})
 
 '''
 
@@ -1137,6 +1182,10 @@ const FRONTEND_TOOL_MAP: Record<string, any> = {
                 if model_additionals
                 else ""
             )
+            voice = voice_of(spec)
+            voice_ts_line = (
+                f"    voice: {_fmt_ts_literal(voice)},\n" if voice is not None else ""
+            )
             inference_provider = spec.get("inference_provider")
             inference_provider_ts = (
                 f"'{inference_provider}'" if inference_provider else "undefined"
@@ -1167,8 +1216,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")
@@ -1246,7 +1294,7 @@ const FRONTEND_TOOL_MAP: Record<string, any> = {
     toolHooks: {_fmt_ts_literal(tool_hooks_val)},
     parameters: {_fmt_ts_literal(parameters_val)},
     subagents: {subagents_ts},
-}};
+{voice_ts_line}}};
 
 """
 
@@ -1674,6 +1722,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';