@alexkroman1/aai-ui 0.16.0 → 0.18.0

package/dist/default-client/assets/{playback-processor-DXHfyQD9.js → playback-processor-BHk-iXEU.js}

@@ -1,4 +1,4 @@
-import{r as e}from"./index-BOTLwsNO.js";import{t}from"./_module-url-BX0RuRU2.js";var n=`
+import{r as e}from"./index-DUQoaxdq.js";import{t}from"./_module-url-BX0RuRU2.js";var n=`
 class PlaybackProcessor extends AudioWorkletProcessor {
   constructor(options) {
     super();

package/dist/default-client/index.html

@@ -6,8 +6,8 @@
     <title>aai</title>
     <link rel="icon" href="./favicon.ico" />
     <style>html,body{background:#fafafa;margin:0}</style>
-    <script type="module" crossorigin src="./assets/index-BOTLwsNO.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-_-x5JLLa.css">
+    <script type="module" crossorigin src="./assets/index-DUQoaxdq.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-BkjCv4MX.css">
   </head>
   <body>
     <main id="app"></main>

package/dist/default-client.d.ts

@@ -1,8 +1,6 @@
 /** The two mounts the default client chooses between, injectable for a spec. */
 export type DefaultClientMounts = {
-    mountClient: (config: {
-        name?: string;
-    }) => unknown;
+    mountClient: (config: Record<string, never>) => unknown;
     mountPage: (config: {
         name?: string;
     }) => unknown;

package/dist/define-client.d.ts

@@ -1,6 +1,5 @@
 /** @jsxImportSource react */
 import { type ComponentType, type ReactNode } from "react";
-import { type ToolDisplayConfig } from "./components/tool-config-context.ts";
 import type { BrowserSession } from "./session/index.ts";
 import { createBrowserSession } from "./session/index.ts";
 import type { ClientTheme, VoiceSessionOptions } from "./types.ts";
@@ -19,14 +18,17 @@ import type { ClientTheme, VoiceSessionOptions } from "./types.ts";
  * sidebar); present, the caller's own component inside the same providers —
  * and that decision is made at runtime, where every field can be honoured. It
  * used to be a union whose two arms banned each other's fields with `?: never`,
- * and the failure that shape produces is recorded twice in this file's history:
- * `mountClient({ name, component })` and `mountClient({ component, tools })` were both
- * the natural thing to write, both were refused with *"Type 'string' is not
- * assignable to type 'undefined'"*, and both cost a build round each time
- * before the ban was lifted. What was left banned was `sidebar` beside a
- * `component`, which invited the identical failure for a combination
- * {@link mountClient} can simply render.
+ * and the failure that shape produces is recorded in this file's history:
+ * `sidebar` beside a `component` was the natural thing to write, was refused
+ * with *"Type '…' is not assignable to type 'undefined'"*, and cost a build
+ * round each time, for a combination {@link mountClient} can simply render.
  *
+ * The agent's name and each tool's icon and label are not options here: both
+ * come from the agent's own `GET /client-config` body — `agent({ name })` and
+ * `tool({ ui })` — which the mount looks up, so a page never restates what the
+ * agent already declared.
+ *
+ * @input
  * @public
  */
 export type ClientConfig = Pick<VoiceSessionOptions, "onSessionId" | "resumeSessionId" | "location" | "phone" | "client" | "token" | "WebSocket"> & {
@@ -34,8 +36,22 @@ export type ClientConfig = Pick<VoiceSessionOptions, "onSessionId" | "resumeSess
     target?: string | HTMLElement;
     /** Base URL of the AAI platform server. Derived from `location.href` by default. */
     platformUrl?: string;
-    /** Theme color overrides. */
+    /**
+     * Theme colors — the five tokens, or `{ primary, mode: "dark" | "light" }`
+     * with the rest derived. See {@link ClientTheme}.
+     */
     theme?: ClientTheme;
+    /**
+     * A stylesheet for the PAGE, injected into `<head>` for the life of the
+     * mount and removed on dispose.
+     *
+     * For the rules a custom chrome has that no component prop reaches — a
+     * `@keyframes`, a scrollbar palette, a font face — which otherwise meant a
+     * `<style>` element written into `index.html` beside the mount, in the one
+     * file the scaffold's CSP is strict about. The five theme tokens are already
+     * on `:root` as `--aai-*` when these rules run, so a sheet may use them.
+     */
+    css?: string;
     /**
      * Full custom component to render instead of the default shell.
      *
@@ -43,12 +59,6 @@ export type ClientConfig = Pick<VoiceSessionOptions, "onSessionId" | "resumeSess
      * session hook, `useTheme` and the tool display config work in it unchanged.
      */
     component?: ComponentType;
-    /**
-     * Agent name shown in the header and start screen — and, with a `component`,
-     * the page title, there being no shell header to put it in. Left out, the
-     * default shell asks the agent for its own declared name.
-     */
-    name?: string;
     /**
      * Optional sidebar component rendered alongside the main pane.
      *
@@ -79,21 +89,13 @@ export type ClientConfig = Pick<VoiceSessionOptions, "onSessionId" | "resumeSess
     subtitle?: string;
     /** Label of the start CTA. Defaults to `"Start Conversation"`. */
     buttonText?: string;
-    /**
-     * Tool display config: icon and label overrides keyed by tool name.
-     *
-     * Honoured with a custom `component` too: {@link mountClient} installs it into
-     * `ToolConfigContext`, and the consumer is `ToolCallBlock` — which a custom
-     * component renders as soon as it uses `MessageList` or `ChatView`, the usual
-     * way to build one.
-     */
-    tools?: ToolDisplayConfig;
 };
 /**
  * Handle returned by {@link mountClient} for cleanup.
  *
  * Implements `Disposable` so it can be used with `using`.
  *
+ * @sealed
  * @public
  */
 export type ClientHandle = {
@@ -151,8 +153,12 @@ export declare function mountRoot(container: HTMLElement, node: ReactNode, onDis
  *
  * **A custom component:** pass `component` and it is rendered inside the same
  * providers instead of the default shell — beside a `sidebar` if one is given,
- * in the same {@link SidebarLayout}. A provided `name` then also sets
- * `document.title`, there being no shell header to show it in.
+ * in the same {@link SidebarLayout}. The page title is the HTML's own; a
+ * custom component that wants another sets `document.title` itself.
+ *
+ * The agent's name on the start card and in the header, and each tool's icon
+ * and label, are what the agent declared (`agent({ name })`, `tool({ ui })`),
+ * read from its `GET /client-config` body — not options here.
  *
  * Mounts into `target` — a CSS selector or DOM element, defaulting to
  * `"#app"` — and throws `Element not found: <target>` when the selector
@@ -167,10 +173,8 @@ export declare function mountRoot(container: HTMLElement, node: ReactNode, onDis
  * }
  *
  * mountClient({
- *   name: "Pizza Ordering",
  *   theme: { bg: "#1a1a1a", primary: "#e55" },
  *   sidebar: OrderPanel,
- *   tools: { add_pizza: { icon: "🍕", label: "Adding pizza" } },
  * });
  * ```
  *

package/dist/define-client.js

@@ -1,13 +1,13 @@
-import { t as ChatView } from "./chat-view-DIwPoAEG.js";
-import { n as pageBaseUrl, r as setPageTitle } from "./_utils-Mi-SCFA1.js";
-import { n as fetchClientConfig } from "./client-config-C7fQrioM.js";
-import { t as createBrowserSession } from "./session-CYdjRvbl.js";
-import { SessionProvider, ThemeProvider } from "./context.js";
-import { t as ToolConfigContext } from "./tool-config-context-Es4YUzV2.js";
+import { t as ChatView } from "./chat-view-BwKpF0MN.js";
+import { n as pageBaseUrl } from "./_utils-BlZBJPdj.js";
+import { n as fetchClientConfig } from "./client-config-DcMCWmkO.js";
+import { t as createBrowserSession } from "./session-Rud8mmU-.js";
+import { c as useSessionSelector, n as ThemeProvider, t as SessionProvider } from "./context-BF0KsI9X.js";
+import { n as ToolConfigContext, t as EMPTY_TOOL_DISPLAY } from "./tool-config-context-Bd-7xrfP.js";
 import { SidebarLayout } from "./components/sidebar-layout.js";
 import { StartScreen } from "./components/start-screen.js";
 import { createElement, useEffect, useState } from "react";
-import { jsx } from "react/jsx-runtime";
+import { jsx, jsxs } from "react/jsx-runtime";
 import { flushSync } from "react-dom";
 import { createRoot } from "react-dom/client";
 //#region src/define-client.tsx
@@ -82,39 +82,75 @@ function DefaultShell({ name, icon, subtitle, buttonText, Sidebar, ...layout })
 	});
 }
 /**
-* Config-tier root: fetches the server-declared display name via
-* `GET client-config` and renders the chat shell. The shell renders
-* immediately — optimistically — while the lookup is in flight; servers
-* without the endpoint (every lookup failure resolves to the empty default)
-* work exactly as before.
-*
-* **The lookup is SKIPPED when the caller already named the agent.** The
-* response's only consumer here is the fallback below, so with an explicit
-* `mountClient({ name })` the request was issued and its answer thrown away — and on
-* the platform this endpoint is the BROKER, so the discarded request is one that
-* can boot a sandbox. The session's own per-attempt lookup
-* (`session/browser-session.ts`'s URL provider) is a different question and deliberately
-* left alone: it re-brokers on every connection attempt, which is what makes a
-* reconnect land on a REPLACEMENT sandbox, so it may not be served from
-* anything this render already has.
+* The session-config lookup the mount makes, and WHEN.
+*
+* The response feeds two things: the default shell's title (the agent's own
+* declared name), and every tool's declared icon and label (`tools`), which a
+* custom component's `ToolCallBlock` reads too. The timing rule is the one
+* this file has always had, kept because on the platform this endpoint is the
+* BROKER and a request to it can boot a sandbox: the lookup is issued at mount
+* only when the default shell renders, since its start card needs the name;
+* under a custom `component` it waits until the session has STARTED — at
+* which point the session's own per-attempt lookup is booting that sandbox
+* anyway, so the second request costs no boot. Either way it is issued once;
+* the session's own lookup stays separate (it re-brokers per attempt, which
+* this must not interfere with — see `session/dial.ts`).
 */
-function DefaultRoot({ platformUrl, ...display }) {
-	const { name } = display;
+function useMountLookup(platformUrl, eager) {
+	const started = useSessionSelector(selectStarted);
+	const wanted = eager || started;
 	const [resolved, setResolved] = useState(null);
-	const needsLookup = name === void 0;
 	useEffect(() => {
-		if (!needsLookup) return;
+		if (!wanted || resolved !== null) return;
 		let cancelled = false;
-		fetchClientConfig(platformUrl).then((cfg) => {
+		fetchClientConfig({ platformUrl }).then((cfg) => {
 			if (!cancelled) setResolved(cfg);
 		});
 		return () => {
 			cancelled = true;
 		};
-	}, [platformUrl, needsLookup]);
-	return /* @__PURE__ */ jsx(DefaultShell, {
-		...display,
-		name: name ?? resolved?.name
+	}, [
+		platformUrl,
+		wanted,
+		resolved
+	]);
+	return resolved;
+}
+/** Module-scope, for the reason `context.ts` hoists its own two selectors. */
+const selectStarted = (snapshot) => snapshot.started;
+/**
+* The page-level stylesheet `mountClient({ css })` injects — see that field.
+* A `<style>` in `<head>` rather than inline on an element, so `@keyframes`,
+* `@font-face` and pseudo-element rules all work; removed on unmount so a
+* client disposed mid-page leaves the page as it found it.
+*/
+function PageCss({ css }) {
+	useEffect(() => {
+		if (css === void 0 || css === "" || typeof document === "undefined") return;
+		const style = document.createElement("style");
+		style.setAttribute("data-aai-css", "");
+		style.textContent = css;
+		document.head.appendChild(style);
+		return () => {
+			style.remove();
+		};
+	}, [css]);
+	return null;
+}
+/**
+* Everything under the session provider: the lookup, the two display
+* contexts, the page stylesheet, then the caller's component or the default
+* shell. Inside `SessionProvider` because the lookup's timing reads the
+* session (`useMountLookup`).
+*/
+function ClientRoot({ config, platformUrl }) {
+	const resolved = useMountLookup(platformUrl, config.component === void 0);
+	return /* @__PURE__ */ jsx(ToolConfigContext.Provider, {
+		value: resolved?.tools ?? EMPTY_TOOL_DISPLAY,
+		children: /* @__PURE__ */ jsxs(ThemeProvider, {
+			value: config.theme,
+			children: [/* @__PURE__ */ jsx(PageCss, { css: config.css }), rootFor(config, resolved?.name)]
+		})
 	});
 }
 /**
@@ -124,14 +160,17 @@ function DefaultRoot({ platformUrl, ...display }) {
 * `sidebar` off — but the layout the default shell uses is right here, and
 * `mountClient({ component, sidebar })` names one pane and one aside, which is
 * exactly what it renders. Honouring the combination rather than ignoring it is
-* the same call this file already made for `name` and `tools`.
+* the same call this file makes for every display field.
+*
+* The default shell renders immediately — optimistically — without a name;
+* `serverName` arrives from the mount's lookup, which is the agent's own
+* `agent({ name })`.
 */
-function rootFor(config, platformUrl) {
+function rootFor(config, serverName) {
 	const Custom = config.component;
 	const Sidebar = config.sidebar;
-	if (!Custom) return /* @__PURE__ */ jsx(DefaultRoot, {
-		platformUrl,
-		name: config.name,
+	if (!Custom) return /* @__PURE__ */ jsx(DefaultShell, {
+		name: serverName,
 		icon: config.icon,
 		subtitle: config.subtitle,
 		buttonText: config.buttonText,
@@ -155,8 +194,12 @@ function rootFor(config, platformUrl) {
 *
 * **A custom component:** pass `component` and it is rendered inside the same
 * providers instead of the default shell — beside a `sidebar` if one is given,
-* in the same {@link SidebarLayout}. A provided `name` then also sets
-* `document.title`, there being no shell header to show it in.
+* in the same {@link SidebarLayout}. The page title is the HTML's own; a
+* custom component that wants another sets `document.title` itself.
+*
+* The agent's name on the start card and in the header, and each tool's icon
+* and label, are what the agent declared (`agent({ name })`, `tool({ ui })`),
+* read from its `GET /client-config` body — not options here.
 *
 * Mounts into `target` — a CSS selector or DOM element, defaulting to
 * `"#app"` — and throws `Element not found: <target>` when the selector
@@ -171,10 +214,8 @@ function rootFor(config, platformUrl) {
 * }
 *
 * mountClient({
-*   name: "Pizza Ordering",
 *   theme: { bg: "#1a1a1a", primary: "#e55" },
 *   sidebar: OrderPanel,
-*   tools: { add_pizza: { icon: "🍕", label: "Adding pizza" } },
 * });
 * ```
 *
@@ -216,12 +257,12 @@ function mountClientWith(config, createSession) {
 		token: config.token,
 		WebSocket: config.WebSocket
 	});
-	setPageTitle(config.name);
-	const rootNode = rootFor(config, platformUrl);
-	const toolConfig = config.tools ?? {};
 	return {
 		session,
-		...mountRoot(container, createElement(ToolConfigContext.Provider, { value: toolConfig }, createElement(ThemeProvider, { value: config.theme }, createElement(SessionProvider, { value: session }, rootNode))), () => session[Symbol.dispose]())
+		...mountRoot(container, createElement(SessionProvider, { value: session }, createElement(ClientRoot, {
+			config,
+			platformUrl
+		})), () => session[Symbol.dispose]())
 	};
 }
 //#endregion

package/dist/dictation-transcriber.d.ts

@@ -0,0 +1,49 @@
+/**
+ * `dictationTranscriber(url)` — the `transcribe` callback `useDictation` needs,
+ * for a server answering the SDK's `handleDictationRequest`.
+ *
+ * Every page that dictates writes the same few lines: POST the clip, read
+ * `{ text }`, and turn a refusal into an error whose message is the SERVER's
+ * sentence ("Recording too long — keep it under 120 seconds", "Transcription
+ * is rate limited — try again shortly") rather than a bare status. This is
+ * those lines, against the one reply shape the SDK route answers with.
+ */
+/**
+ * Options for {@link dictationTranscriber}.
+ *
+ * @input
+ */
+export type DictationTranscriberOptions = {
+    /**
+     * Headers sent with each clip — an `authorization` for a route behind a
+     * bearer. A FUNCTION is read per request, so a token that rotates is never
+     * sent stale.
+     */
+    headers?: Record<string, string> | (() => Record<string, string>);
+    /** The transport. Defaults to the global `fetch`. */
+    fetch?: typeof fetch;
+};
+/**
+ * A `transcribe` for `useDictation` that POSTs each clip to `url` and
+ * reads the `{ text } | { error }` reply `handleDictationRequest` answers with.
+ *
+ * Rejects with the server's own `error` sentence on a refusal, and with a
+ * status-naming message when the reply is not that shape (a proxy's HTML error
+ * page) — `useDictation` shows either as its `error`.
+ *
+ * @param url - The route, resolved like any `fetch` URL (relative to the page).
+ *
+ * @example
+ * ```ts
+ * import { dictationTranscriber } from "@alexkroman1/aai-ui";
+ *
+ * export const transcribe = dictationTranscriber("/api/dictation", {
+ *   headers: () => ({ authorization: `Bearer ${localStorage.getItem("token") ?? ""}` }),
+ * });
+ * ```
+ *
+ * @public
+ */
+export declare function dictationTranscriber(url: string, options?: DictationTranscriberOptions): (audio: Blob, options: {
+    signal: AbortSignal;
+}) => Promise<string>;

package/dist/{eyebrow-UfmSz9yy.js → eyebrow-Bp4y1rZ9.js}

@@ -1,4 +1,4 @@
-import { useTheme } from "./context.js";
+import { u as useTheme } from "./context-BF0KsI9X.js";
 import clsx from "clsx";
 import { jsx } from "react/jsx-runtime";
 //#region src/components/eyebrow.tsx

package/dist/{hooks-DN4gHYsj.js → hooks-1CoQY_Fc.js}

@@ -1,5 +1,5 @@
-import { a as tryParseJSON } from "./_utils-Mi-SCFA1.js";
-import { useSessionSelector } from "./context.js";
+import { a as tryParseJSON } from "./_utils-BlZBJPdj.js";
+import { c as useSessionSelector } from "./context-BF0KsI9X.js";
 import { useEffect, useMemo, useRef } from "react";
 //#region src/agent-state.ts
 /** One stable selector per slot name — see {@link selectAgentState}. */

package/dist/hooks.js

@@ -1,3 +1,2 @@
-import "./context.js";
-import { a as useAgentState, i as selectAgentState, n as useToolCallStart, r as useToolResult, t as useEvent } from "./hooks-DN4gHYsj.js";
+import { a as useAgentState, i as selectAgentState, n as useToolCallStart, r as useToolResult, t as useEvent } from "./hooks-1CoQY_Fc.js";
 export { selectAgentState, useAgentState, useEvent, useToolCallStart, useToolResult };

package/dist/inbox-protocol.d.ts

@@ -37,6 +37,7 @@ import { type InboxClientFrame, type InboxServerFrame } from "@alexkroman1/aai/p
  * One notice from the agent — what a workflow step sent with
  * `stepNotifyClient`, e.g. a reminder coming due.
  *
+ * @sealed
  * @public
  */
 export type InboxNotice = {
@@ -57,6 +58,11 @@ export type InboxNotice = {
  * for events: every session bound to the client, this tab's own included —
  * filter on `sessionId` (`useSessionId()`) to show only the OTHER ones.
  *
+ * `"other"` is a frame this version does not know (`frameType` is the wire
+ * `type` it arrived with) — a member from the start so that a frame the server
+ * adds later reaches an existing `switch`'s `default`, not a compile error.
+ * Ignore it.
+ *
  * @public
  */
 export type InboxEvent = {
@@ -69,6 +75,9 @@ export type InboxEvent = {
 } | {
     readonly type: "session_ended";
     readonly sessionId: string;
+} | {
+    readonly type: "other";
+    readonly frameType: string;
 };
 /**
  * The largest notice taken: 60 s of 16 kHz PCM16, the firmware's
@@ -103,10 +112,11 @@ export type AssemblerOutput = {
  */
 export declare function parseNoticeHeader(json: string): NoticeHeader | undefined;
 /**
- * A live-event frame, or undefined for anything else (a notice header, say).
- * The wire's live frames are returned as the published {@link InboxEvent}, so
- * that view cannot drift from what the server sends without this failing to
- * compile.
+ * A live-event frame, or undefined for a notice header or a frame that is not
+ * one at all. The wire's live frames are returned as the published
+ * {@link InboxEvent}, so that view cannot drift from what the server sends
+ * without this failing to compile; a well-formed frame of a type this version
+ * does not know is `{ type: "other" }`.
  */
 export declare function parseInboxEvent(json: string): InboxEvent | undefined;
 /**

package/dist/inbox.d.ts

@@ -44,6 +44,7 @@ export declare const INBOX_RECONNECT_MAX_MS = 30000;
 /**
  * Options for {@link createInbox}.
  *
+ * @input
  * @public
  */
 export type CreateInboxOptions = {

package/dist/index.d.ts

@@ -63,7 +63,8 @@
  */
 export { type ClientRun, type ClientRunStatus, type ClientRunsResponse, errorMessage, } from "@alexkroman1/aai";
 export { AGENT_STATE_LABELS } from "./agent-state-labels.ts";
-export { type ClientConfigResponse, fetchClientConfig, } from "./client-config.ts";
+export { appendDictation } from "./append-dictation.ts";
+export { type ClientConfigResponse, type FetchClientConfigOptions, fetchClientConfig, } from "./client-config.ts";
 export { browserClientId, type SessionIdentity } from "./client-identity.ts";
 export { useClientTool } from "./client-tool.ts";
 export { AudioResult, type AudioResultCaptions, type AudioResultProps, } from "./components/audio-result.tsx";
@@ -75,18 +76,17 @@ export { ConsoleShell, type ConsoleShellProps } from "./components/console-shell
 export { Controls, type ControlsProps } from "./components/controls.tsx";
 export { ConversationView, type ConversationViewProps, } from "./components/conversation-view.tsx";
 export { Facts, type FactsProps } from "./components/facts.tsx";
-export { CheckboxField, Field, type FieldShell, FileField, type FileReadMode, type FileValue, Form, type FormProps, type FormValues, NumberField, SelectField, SubmitButton, TextAreaField, TextField, } from "./components/form.tsx";
+export { CheckboxField, Field, type FieldShell, FileField, type FileReadMode, type FileValue, type FileValueShape, Form, type FormProps, type FormValues, isFileValue, type NamedTextValue, NumberField, SelectField, SubmitButton, TextAreaField, TextField, type TextSplitMode, } from "./components/form.tsx";
 export { Markdown, type MarkdownProps, type MarkdownVariant } from "./components/markdown.tsx";
 export { MessageList, type MessageListProps } from "./components/message-list.tsx";
 export { type SessionControlAction, type SessionControlButton, SessionControls, type SessionControlsLabels, type SessionControlsProps, } from "./components/session-controls.tsx";
 export { SessionErrorBanner, type SessionErrorBannerProps, } from "./components/session-error-banner.tsx";
-export { SessionStateDot, type SessionStateDotProps, } from "./components/session-state-dot.tsx";
+export { SessionStateDot, type SessionStateDotColors, type SessionStateDotGroup, type SessionStateDotProps, } from "./components/session-state-dot.tsx";
 export { SidebarLayout } from "./components/sidebar-layout.tsx";
 export { StartScreen } from "./components/start-screen.tsx";
 export { ToolCallRow, type ToolCallRowProps, type ToolCallRowVariant, } from "./components/tool-call-row.tsx";
-export type { ToolDisplayConfig } from "./components/tool-config-context.ts";
 export { UploadProgressBar } from "./components/upload-progress.tsx";
-export { WorkflowFields } from "./components/workflow-fields.tsx";
+export { WorkflowFields, type WorkflowFieldsProps } from "./components/workflow-fields.tsx";
 export { WorkflowPendingNote, type WorkflowPendingNoteProps, } from "./components/workflow-pending-note.tsx";
 export { WorkflowProgress } from "./components/workflow-progress.tsx";
 export { WorkflowRunError, type WorkflowRunErrorProps, } from "./components/workflow-run-error.tsx";
@@ -96,6 +96,7 @@ export { useSession, useSessionActions, useSessionError, useSessionSelector, use
 export { type ConversationLogEntry, inboxEventToItem } from "./conversation-log.ts";
 export type { ClientConfig, ClientHandle } from "./define-client.tsx";
 export { mountClient } from "./define-client.tsx";
+export { type DictationTranscriberOptions, dictationTranscriber } from "./dictation-transcriber.ts";
 export { selectAgentState, useAgentState, useEvent, useToolCallStart, useToolResult, } from "./hooks.ts";
 export { type CreateInboxOptions, createInbox, type Inbox } from "./inbox.ts";
 export type { InboxEvent, InboxNotice } from "./inbox-protocol.ts";
@@ -106,11 +107,12 @@ export { type RouteFetchOptions, type RouteMethod, routeFetch } from "./route-fe
 export type { AgentCustomEvent, AgentStateFrame, BrowserSession, browserSessionBrand, SendTextOptions, SessionSnapshot, ToolCallOutcome, UserTurnControls, } from "./session/index.ts";
 export { createBrowserSession } from "./session/index.ts";
 export { createStoredValue, type StoredValue, type StoredValueOptions, useStoredValue, } from "./stored-value.ts";
-export type { AgentState, ChatMessage, ClientTheme, SessionError, SessionErrorCode, ToolCallInfo, VoiceSessionOptions, WebSocketConstructor, } from "./types.ts";
+export type { AgentState, ChatMessage, ClientTheme, ClientThemePreset, ClientThemeTokens, ResolvedClientTheme, SessionError, SessionErrorCode, ToolCallInfo, VoiceSessionOptions, WebSocketConstructor, } from "./types.ts";
 export { type UseClientRunsOptions, type UseClientRunsResult, useClientRuns, } from "./use-client-runs.ts";
 export { type ConversationItem, type UseConversationResult, useConversation, } from "./use-conversation.ts";
 export { type UseConversationLogOptions, type UseConversationLogResult, useConversationLog, } from "./use-conversation-log.ts";
 export { type UseCopyResult, useCopy } from "./use-copy.ts";
+export { type UseDictationOptions, type UseDictationResult, useDictation, } from "./use-dictation.ts";
 export { type UseDownloadUrlOptions, type UseDownloadUrlResult, useDownloadUrl, } from "./use-download-url.ts";
 export { type UseFlashResult, useFlash } from "./use-flash.ts";
 export { type UseInboxOptions, type UseInboxResult, useInbox } from "./use-inbox.ts";
@@ -122,13 +124,14 @@ export { type UseSessionControlsResult, useSessionControls } from "./use-session
 export { useClientId, useSessionId } from "./use-session-id.ts";
 export { type UseTapToTalkOptions, type UseTapToTalkResult, useTapToTalk, } from "./use-tap-to-talk.ts";
 export { type UseUserTranscriptResult, useUserTranscript } from "./use-user-transcript.ts";
-export { type UploadStatus, type UseWorkflowSubmitOptions, useWorkflowSubmit, type WorkflowSubmission, } from "./use-workflow-form.ts";
+export { type UseWorkflowSubmitOptions, useWorkflowSubmit } from "./use-workflow-form.ts";
 export { type UseWorkflowProgressResult, useWorkflowProgress, } from "./use-workflow-progress.ts";
 export { type UseWorkflowRunResult, useWorkflowRun } from "./use-workflow-run.ts";
 export { type UseWorkflowRunsOptions, type UseWorkflowRunsResult, useWorkflowRuns, } from "./use-workflow-runs.ts";
 export { type UseWorkflowStreamOptions, useWorkflowStream, type WorkflowStreamSubmission, } from "./use-workflow-stream.ts";
 export { type UseWorkflowsOptions, type UseWorkflowsResult, useWorkflows, } from "./use-workflows.ts";
 export { type AgentClient, createWorkflowApi, isTerminal, type WorkflowApi, type WorkflowApiOptions, type WorkflowInputOf, type WorkflowOutputOf, type WorkflowRun, type WorkflowRunStatus, type WorkflowSummary, } from "./workflow-client.ts";
-export type { SubmitInputOf } from "./workflow-def-types.ts";
-export { fieldKindFor, type WorkflowFieldKind } from "./workflow-field-kind.ts";
+export type { SubmitInputOf, WorkflowAppLike, WorkflowDefOf, WorkflowNameOf, WorkflowsOf, } from "./workflow-def-types.ts";
+export { fieldKindFor, type WorkflowFieldKind, type WorkflowFieldRender, } from "./workflow-field-kind.ts";
 export { WORKFLOW_STATUS_LABELS } from "./workflow-status-labels.ts";
+export type { UploadStatus, WorkflowSubmission, WorkflowSubmissionOf, WorkflowSubmissionScope, WorkflowSubmissionTiming, } from "./workflow-submission.ts";