@alexkroman1/aai-ui 3.2.0 → 5.0.0

package/dist/default-client/assets/index-CRfdZPH1.css

@@ -0,0 +1,2 @@
+/*! tailwindcss v4.3.3 | MIT License | https://tailwindcss.com */
+@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-border-style:solid;--tw-leading:initial;--tw-font-weight:initial;--tw-tracking:initial;--tw-shadow:0 0 #0000;--tw-shadow-color:initial;--tw-shadow-alpha:100%;--tw-inset-shadow:0 0 #0000;--tw-inset-shadow-color:initial;--tw-inset-shadow-alpha:100%;--tw-ring-color:initial;--tw-ring-shadow:0 0 #0000;--tw-inset-ring-color:initial;--tw-inset-ring-shadow:0 0 #0000;--tw-ring-inset:initial;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-offset-shadow:0 0 #0000;--tw-blur:initial;--tw-brightness:initial;--tw-contrast:initial;--tw-grayscale:initial;--tw-hue-rotate:initial;--tw-invert:initial;--tw-opacity:initial;--tw-saturate:initial;--tw-sepia:initial;--tw-drop-shadow:initial;--tw-drop-shadow-color:initial;--tw-drop-shadow-alpha:100%;--tw-drop-shadow-size:initial;--tw-duration:initial;--tw-ease:initial}}}@layer theme{:root,:host{--font-sans:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";--font-mono:ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;--spacing:.25rem;--text-xs:.75rem;--text-xs--line-height:calc(1 / .75);--text-sm:.875rem;--text-sm--line-height:calc(1.25 / .875);--font-weight-normal:400;--font-weight-medium:500;--font-weight-semibold:600;--tracking-wide:.025em;--radius-sm:.25rem;--radius-md:.375rem;--radius-lg:.5rem;--radius-xl:.75rem;--ease-in-out:cubic-bezier(.4, 0, .2, 1);--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4, 0, .2, 1);--default-font-family:var(--font-sans);--default-mono-font-family:var(--font-mono);--font-aai:"Monument Grotesk", "ABC Monument Grotesk", ui-sans-serif, system-ui, -apple-system, sans-serif;--font-aai-serif:"Source Serif 4", "Source Serif Pro", Charter, "Iowan Old Style", Georgia, serif;--font-aai-mono:"JetBrains Mono", ui-monospace, SFMono-Regular, Menlo, monospace;--radius-aai:4px}}@layer base{*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;tab-size:4;line-height:1.5;font-family:var(--default-font-family,-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring:where(:not(iframe)){outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::placeholder{opacity:1}@supports (not ((-webkit-appearance:-apple-pay-button))) or (contain-intrinsic-size:1px){::placeholder{color:currentColor}@supports (color:color-mix(in lab, red, red)){::placeholder{color:color-mix(in oklab, currentcolor 50%, transparent)}}}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}::-webkit-calendar-picker-indicator{line-height:1}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){appearance:button}::file-selector-button{appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}html,body{margin:0;padding:0}}@layer components;@layer utilities{.collapse{visibility:collapse}.invisible{visibility:hidden}.visible{visibility:visible}.absolute{position:absolute}.relative{position:relative}.static{position:static}.container{width:100%}@media (width>=40rem){.container{max-width:40rem}}@media (width>=48rem){.container{max-width:48rem}}@media (width>=64rem){.container{max-width:64rem}}@media (width>=80rem){.container{max-width:80rem}}@media (width>=96rem){.container{max-width:96rem}}.m-0{margin:0}.mx-auto{margin-inline:auto}.my-0\.5{margin-block:calc(var(--spacing) * .5)}.my-1\.5{margin-block:calc(var(--spacing) * 1.5)}.my-2\.5{margin-block:calc(var(--spacing) * 2.5)}.mt-2{margin-top:calc(var(--spacing) * 2)}.mt-3{margin-top:calc(var(--spacing) * 3)}.mb-1\.5{margin-bottom:calc(var(--spacing) * 1.5)}.ml-auto{margin-left:auto}.box-border{box-sizing:border-box}.block{display:block}.flex{display:flex}.grid{display:grid}.inline{display:inline}.inline-flex{display:inline-flex}.table{display:table}.h-1\.5{height:calc(var(--spacing) * 1.5)}.h-4{height:calc(var(--spacing) * 4)}.h-9{height:calc(var(--spacing) * 9)}.h-11{height:calc(var(--spacing) * 11)}.h-\[7px\]{height:7px}.h-screen{height:100vh}.max-h-64{max-height:calc(var(--spacing) * 64)}.min-h-0{min-height:0}.min-h-5{min-height:calc(var(--spacing) * 5)}.w-1\.5{width:calc(var(--spacing) * 1.5)}.w-4{width:calc(var(--spacing) * 4)}.w-\[7px\]{width:7px}.w-fit{width:fit-content}.w-full{width:100%}.max-w-75{max-width:calc(var(--spacing) * 75)}.max-w-105{max-width:calc(var(--spacing) * 105)}.max-w-190{max-width:calc(var(--spacing) * 190)}.max-w-\[60\%\]{max-width:60%}.max-w-\[82\%\]{max-width:82%}.max-w-\[min\(78\%\,64ch\)\]{max-width:min(78%,64ch)}.min-w-0{min-width:0}.flex-1{flex:1}.shrink-0{flex-shrink:0}.border-collapse{border-collapse:collapse}.rotate-90{rotate:90deg}.cursor-pointer{cursor:pointer}.\[scrollbar-width\:none\]{scrollbar-width:none}.list-decimal{list-style-type:decimal}.list-disc{list-style-type:disc}.appearance-none{appearance:none}.flex-col{flex-direction:column}.items-center{align-items:center}.items-end{align-items:flex-end}.justify-between{justify-content:space-between}.justify-center{justify-content:center}.justify-end{justify-content:flex-end}.gap-1{gap:var(--spacing)}.gap-1\.5{gap:calc(var(--spacing) * 1.5)}.gap-2{gap:calc(var(--spacing) * 2)}.gap-2\.5{gap:calc(var(--spacing) * 2.5)}.gap-3{gap:calc(var(--spacing) * 3)}.gap-4{gap:calc(var(--spacing) * 4)}.gap-5{gap:calc(var(--spacing) * 5)}.truncate{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-x-auto{overflow-x:auto}.overflow-y-auto{overflow-y:auto}.rounded-aai{border-radius:var(--radius-aai)}.rounded-full{border-radius:3.40282e38px}.rounded-lg{border-radius:var(--radius-lg)}.rounded-md{border-radius:var(--radius-md)}.rounded-sm{border-radius:var(--radius-sm)}.rounded-xl{border-radius:var(--radius-xl)}.border{border-style:var(--tw-border-style);border-width:1px}.border-t{border-top-style:var(--tw-border-style);border-top-width:1px}.border-b{border-bottom-style:var(--tw-border-style);border-bottom-width:1px}.border-l-2{border-left-style:var(--tw-border-style);border-left-width:2px}.border-none{--tw-border-style:none;border-style:none}.bg-transparent{background-color:#0000}.p-2\.5{padding:calc(var(--spacing) * 2.5)}.p-7{padding:calc(var(--spacing) * 7)}.px-1{padding-inline:var(--spacing)}.px-2{padding-inline:calc(var(--spacing) * 2)}.px-3\.5{padding-inline:calc(var(--spacing) * 3.5)}.px-5{padding-inline:calc(var(--spacing) * 5)}.px-6{padding-inline:calc(var(--spacing) * 6)}.px-7{padding-inline:calc(var(--spacing) * 7)}.px-10{padding-inline:calc(var(--spacing) * 10)}.py-0\.5{padding-block:calc(var(--spacing) * .5)}.py-1{padding-block:var(--spacing)}.py-2\.5{padding-block:calc(var(--spacing) * 2.5)}.py-3{padding-block:calc(var(--spacing) * 3)}.py-8{padding-block:calc(var(--spacing) * 8)}.py-12{padding-block:calc(var(--spacing) * 12)}.pl-3{padding-left:calc(var(--spacing) * 3)}.pl-5{padding-left:calc(var(--spacing) * 5)}.text-center{text-align:center}.text-left{text-align:left}.font-aai{font-family:var(--font-aai)}.font-aai-mono{font-family:var(--font-aai-mono)}.font-aai-serif{font-family:var(--font-aai-serif)}.text-sm{font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height))}.text-xs{font-size:var(--text-xs);line-height:var(--tw-leading,var(--text-xs--line-height))}.text-\[10px\]{font-size:10px}.text-\[11px\]{font-size:11px}.text-\[12\.5px\]{font-size:12.5px}.text-\[13px\]{font-size:13px}.text-\[15px\]{font-size:15px}.text-\[16px\]{font-size:16px}.text-\[17px\]{font-size:17px}.text-\[22px\]{font-size:22px}.text-\[32px\]{font-size:32px}.leading-4{--tw-leading:calc(var(--spacing) * 4);line-height:calc(var(--spacing) * 4)}.leading-\[1\.2\]{--tw-leading:1.2;line-height:1.2}.leading-\[1\.15\]{--tw-leading:1.15;line-height:1.15}.leading-\[22px\]{--tw-leading:22px;line-height:22px}.leading-\[23px\]{--tw-leading:23px;line-height:23px}.leading-\[130\%\]{--tw-leading:130%;line-height:130%}.leading-none{--tw-leading:1;line-height:1}.font-medium{--tw-font-weight:var(--font-weight-medium);font-weight:var(--font-weight-medium)}.font-normal{--tw-font-weight:var(--font-weight-normal);font-weight:var(--font-weight-normal)}.font-semibold{--tw-font-weight:var(--font-weight-semibold);font-weight:var(--font-weight-semibold)}.tracking-\[-0\.2px\]{--tw-tracking:-.2px;letter-spacing:-.2px}.tracking-\[1\.2px\]{--tw-tracking:1.2px;letter-spacing:1.2px}.tracking-\[1\.4px\]{--tw-tracking:1.4px;letter-spacing:1.4px}.tracking-wide{--tw-tracking:var(--tracking-wide);letter-spacing:var(--tracking-wide)}.text-balance{text-wrap:balance}.wrap-break-word{overflow-wrap:break-word}.whitespace-nowrap{white-space:nowrap}.whitespace-pre-wrap{white-space:pre-wrap}.uppercase{text-transform:uppercase}.underline{text-decoration-line:underline}.underline-offset-2{text-underline-offset:2px}.ring{--tw-ring-shadow:var(--tw-ring-inset,) 0 0 0 calc(1px + var(--tw-ring-offset-width)) var(--tw-ring-color,currentcolor);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.filter{filter:var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,)}.transition{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to,opacity,box-shadow,transform,translate,scale,rotate,filter,-webkit-backdrop-filter,backdrop-filter,display,content-visibility,overlay,pointer-events;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-colors{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-transform{transition-property:transform,translate,scale,rotate;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.duration-150{--tw-duration:.15s;transition-duration:.15s}.ease-in-out{--tw-ease:var(--ease-in-out);transition-timing-function:var(--ease-in-out)}.outline-none{--tw-outline-style:none;outline-style:none}.select-none{-webkit-user-select:none;user-select:none}.first\:mt-0:first-child{margin-top:0}.last\:mb-0:last-child{margin-bottom:0}.disabled\:cursor-not-allowed:disabled{cursor:not-allowed}.disabled\:opacity-50:disabled{opacity:.5}@media (width>=40rem){.sm\:px-16{padding-inline:calc(var(--spacing) * 16)}.sm\:py-14{padding-block:calc(var(--spacing) * 14)}}}@keyframes aai-pulse{0%,to{opacity:1;transform:scale(1)}50%{opacity:.45;transform:scale(.82)}}@keyframes aai-bounce{0%,80%,to{opacity:.3;transform:scale(.8)}40%{opacity:1;transform:scale(1)}}@keyframes aai-shimmer{0%{background-position:-200% 0}to{background-position:200% 0}}.tool-shimmer{-webkit-text-fill-color:transparent;background:linear-gradient(90deg,currentColor 25%,#0000 50%,currentColor 75%) 0 0/200% 100%;-webkit-background-clip:text;background-clip:text;animation:2s infinite aai-shimmer}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-leading{syntax:"*";inherits:false}@property --tw-font-weight{syntax:"*";inherits:false}@property --tw-tracking{syntax:"*";inherits:false}@property --tw-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-shadow-color{syntax:"*";inherits:false}@property --tw-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-inset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-shadow-color{syntax:"*";inherits:false}@property --tw-inset-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-ring-color{syntax:"*";inherits:false}@property --tw-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-ring-color{syntax:"*";inherits:false}@property --tw-inset-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-ring-inset{syntax:"*";inherits:false}@property --tw-ring-offset-width{syntax:"<length>";inherits:false;initial-value:0}@property --tw-ring-offset-color{syntax:"*";inherits:false;initial-value:#fff}@property --tw-ring-offset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-blur{syntax:"*";inherits:false}@property --tw-brightness{syntax:"*";inherits:false}@property --tw-contrast{syntax:"*";inherits:false}@property --tw-grayscale{syntax:"*";inherits:false}@property --tw-hue-rotate{syntax:"*";inherits:false}@property --tw-invert{syntax:"*";inherits:false}@property --tw-opacity{syntax:"*";inherits:false}@property --tw-saturate{syntax:"*";inherits:false}@property --tw-sepia{syntax:"*";inherits:false}@property --tw-drop-shadow{syntax:"*";inherits:false}@property --tw-drop-shadow-color{syntax:"*";inherits:false}@property --tw-drop-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-drop-shadow-size{syntax:"*";inherits:false}@property --tw-duration{syntax:"*";inherits:false}@property --tw-ease{syntax:"*";inherits:false}

package/dist/default-client/assets/{playback-processor-CeEGzgVT.js → playback-processor-CRwbxC1v.js}

@@ -1,4 +1,4 @@
-import{i as e}from"./index-BeVXjGwG.js";import{t}from"./_module-url-BX0RuRU2.js";var n=t(`
+import{i as e}from"./index-0-DXv-S4.js";import{t}from"./_module-url-BX0RuRU2.js";var n=t(`
 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: #FBF8F2; margin: 0; }</style>
-    <script type="module" crossorigin src="./assets/index-BeVXjGwG.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-Dv-Q5VRL.css">
+    <script type="module" crossorigin src="./assets/index-0-DXv-S4.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-CRfdZPH1.css">
   </head>
   <body>
     <main id="app"></main>

package/dist/define-client.d.ts

@@ -1,7 +1,7 @@
 /** @jsxImportSource react */
 import { type ComponentType } from "react";
 import { type ToolDisplayConfig } from "./components/tool-config-context.ts";
-import { type SessionCore } from "./session-core.ts";
+import type { SessionCore } from "./session-core-types.ts";
 import type { ClientTheme, WebSocketConstructor } from "./types.ts";
 /**
  * Base options shared by both client tiers.
@@ -46,7 +46,18 @@ type ConfigTier = BaseOptions & {
 type ComponentTier = BaseOptions & {
     /** Full custom component to render instead of the default shell. */
     component: ComponentType;
-    name?: never;
+    /**
+     * Agent name. With a custom component there is no shell header to put it
+     * in, so it becomes the page title.
+     *
+     * Allowed here rather than `never` because `client({ name, component })` is
+     * the natural thing to write and two different models wrote it. As `never`
+     * it failed with *"Type 'string' is not assignable to type 'undefined'"*,
+     * which explains nothing, and cost a build round each time. There is a real
+     * use for the value — a custom-UI page otherwise inherits whatever title
+     * the HTML shell shipped with — so it is honoured instead of banned.
+     */
+    name?: string;
     sidebar?: never;
     sidebarWidth?: never;
     tools?: never;

package/dist/define-client.js

@@ -1,5 +1,121 @@
-import { t as client } from "./define-client-fjNCp9be.js";
-import "./context.js";
-import "./components/sidebar-layout.js";
-import "./components/start-screen.js";
+import { r as fetchClientConfig, t as createSessionCore } from "./session-core-Bjkr4PAP.js";
+import { SessionProvider, ThemeProvider } from "./context.js";
+import { t as ChatView } from "./chat-view-CW-tZCMm.js";
+import { n as ToolConfigContext } from "./tool-call-block-DIxpG8GM.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 { flushSync } from "react-dom";
+import { createRoot } from "react-dom/client";
+//#region define-client.tsx
+/** @jsxImportSource react */
+function resolveContainer(target = "#app") {
+	if (typeof target !== "string") return target;
+	const el = document.querySelector(target);
+	if (!el) throw new Error(`Element not found: ${target}`);
+	return el;
+}
+/**
+* Default shell rendered in config tier.
+* Wraps StartScreen → (SidebarLayout →) ChatView.
+*/
+function DefaultShell({ name, Sidebar, sidebarWidth }) {
+	const chat = /* @__PURE__ */ jsx(ChatView, { title: name });
+	return /* @__PURE__ */ jsx(StartScreen, {
+		title: name,
+		children: Sidebar ? /* @__PURE__ */ jsx(SidebarLayout, {
+			sidebar: /* @__PURE__ */ jsx(Sidebar, {}),
+			sidebarWidth,
+			children: chat
+		}) : chat
+	});
+}
+/**
+* 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.
+*/
+function DefaultRoot({ platformUrl, name, Sidebar, sidebarWidth }) {
+	const [resolved, setResolved] = useState(null);
+	useEffect(() => {
+		let cancelled = false;
+		fetchClientConfig(platformUrl).then((cfg) => {
+			if (!cancelled) setResolved(cfg);
+		});
+		return () => {
+			cancelled = true;
+		};
+	}, [platformUrl]);
+	return /* @__PURE__ */ jsx(DefaultShell, {
+		name: name ?? resolved?.name,
+		Sidebar,
+		sidebarWidth
+	});
+}
+/**
+* Define and mount a client UI for a voice agent.
+*
+* **Tier 1 (config-only):** Pass options without `component` to get the
+* default shell (StartScreen + ChatView, optional sidebar).
+*
+* **Tier 2 (custom component):** Pass `component` to render a fully custom
+* root component inside the providers.
+*
+* @example Tier 1
+* ```tsx
+* client({
+*   name: "Pizza Ordering",
+*   theme: { bg: "#1a1a1a", primary: "#e55" },
+*   sidebar: OrderPanel,
+*   tools: { add_pizza: { icon: "🍕", label: "Adding pizza" } },
+* });
+* ```
+*
+* @example Tier 2
+* ```tsx
+* client({ component: MyCustomApp });
+* ```
+*
+* @returns A {@link ClientHandle} for cleanup.
+* @throws If the target element is not found in the DOM.
+*
+* @public
+*/
+function client(config) {
+	const container = resolveContainer(config.target);
+	const platformUrl = config.platformUrl ?? globalThis.location.origin + globalThis.location.pathname;
+	const session = createSessionCore({
+		platformUrl,
+		onSessionId: config.onSessionId,
+		resumeSessionId: config.resumeSessionId,
+		WebSocket: config.WebSocket
+	});
+	if (config.name && typeof document !== "undefined") document.title = config.name;
+	const rootNode = config.component ? createElement(config.component) : createElement(DefaultRoot, {
+		platformUrl,
+		name: config.name,
+		Sidebar: config.sidebar,
+		sidebarWidth: config.sidebarWidth
+	});
+	const toolConfig = config.tools ?? {};
+	const root = createRoot(container);
+	flushSync(() => {
+		root.render(createElement(ToolConfigContext.Provider, { value: toolConfig }, createElement(ThemeProvider, { value: config.theme }, createElement(SessionProvider, { value: session }, rootNode))));
+	});
+	const handle = {
+		session,
+		dispose() {
+			root.unmount();
+			session[Symbol.dispose]();
+		},
+		[Symbol.dispose]() {
+			handle.dispose();
+		}
+	};
+	return handle;
+}
+//#endregion
 export { client };

package/dist/hooks.d.ts

@@ -1,6 +1,44 @@
+import type { DefaultToolResult } from "@alexkroman1/aai";
 import type { ToolCallInfo } from "./types.ts";
-export declare function useToolResult<R = unknown>(toolName: string, callback: (result: R, toolCall: ToolCallInfo) => void): void;
-export declare function useToolResult(callback: (name: string, result: unknown, toolCall: ToolCallInfo) => void): void;
+/**
+ * Fire a callback when a tool call settles, with the tool's JSON result.
+ *
+ * @typeParam R - The result shape. Defaults to {@link DefaultToolResult} —
+ *   `any`, for the same reason `ctx.state` is: the value is the author's own
+ *   tool output round-tripped through JSON, so `unknown` (which this was) made
+ *   the ordinary spelling
+ *
+ *   ```tsx
+ *   useToolResult("get_quote", (r) => setPrice(r.price))
+ *   ```
+ *
+ *   a compile error on a client that runs correctly, and `aai build` refuses
+ *   to publish it. Pass the shape — `useToolResult<Quote>(…)` — to get real
+ *   checking, which also documents what the tool returns.
+ */
+export declare function useToolResult<R = DefaultToolResult>(toolName: string, callback: (result: R, toolCall: ToolCallInfo) => void): void;
+export declare function useToolResult<R = DefaultToolResult>(callback: (name: string, result: R, toolCall: ToolCallInfo) => void): void;
+/**
+ * The agent's projected session state, or `null` before the first push.
+ *
+ * The counterpart to `syncState` on the agent: whatever that projection
+ * returns is what arrives here. It replaces the pattern this exists to
+ * remove — returning a state snapshot from every tool, declaring a type for
+ * what those tools happen to return, and mirroring it into `useState` through
+ * `useToolResult`, which was three things to keep in step and which 58% of
+ * measured generated agents built by hand.
+ *
+ * ```tsx
+ * const cart = useAgentState<{ cart: Item[] }>();
+ * return <Cart items={cart?.cart ?? []} />;
+ * ```
+ *
+ * Typed by the caller for the same reason `useToolResult` is: the shape is
+ * the author's own projection, which the framework cannot see. It is
+ * nullable on purpose — nothing has been pushed before the first tool call,
+ * and a UI has to render that moment.
+ */
+export declare function useAgentState<S = DefaultToolResult>(): S | null;
 export declare function useEvent<T = unknown>(event: string, callback: (data: T) => void): void;
 export declare function useToolCallStart(toolName: string, callback: (toolCall: ToolCallInfo) => void): void;
 export declare function useToolCallStart(callback: (toolCall: ToolCallInfo) => void): void;

package/dist/hooks.js

@@ -77,6 +77,29 @@ function useToolResult(...args) {
 		else callback(tc.name, parsed, tc);
 	});
 }
+/**
+* The agent's projected session state, or `null` before the first push.
+*
+* The counterpart to `syncState` on the agent: whatever that projection
+* returns is what arrives here. It replaces the pattern this exists to
+* remove — returning a state snapshot from every tool, declaring a type for
+* what those tools happen to return, and mirroring it into `useState` through
+* `useToolResult`, which was three things to keep in step and which 58% of
+* measured generated agents built by hand.
+*
+* ```tsx
+* const cart = useAgentState<{ cart: Item[] }>();
+* return <Cart items={cart?.cart ?? []} />;
+* ```
+*
+* Typed by the caller for the same reason `useToolResult` is: the shape is
+* the author's own projection, which the framework cannot see. It is
+* nullable on purpose — nothing has been pushed before the first tool call,
+* and a UI has to render that moment.
+*/
+function useAgentState() {
+	return useSessionSelector((snapshot) => snapshot.agentState);
+}
 function useEvent(event, callback) {
 	const customEvents = useSessionSelector((s) => s.customEvents);
 	const watermarkRef = useRef(0);
@@ -102,4 +125,4 @@ function useToolCallStart(...args) {
 	});
 }
 //#endregion
-export { useEvent, useToolCallStart, useToolResult };
+export { useAgentState, useEvent, useToolCallStart, useToolResult };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-export { floatToPcm16 } from "./audio.ts";
 export { buildAgentUrl, type ClientConfigResponse, fetchClientConfig, } from "./client-config.ts";
 export { Button } from "./components/button.tsx";
 export { ChatView } from "./components/chat-view.tsx";
 export { Controls } from "./components/controls.tsx";
+export { Markdown } from "./components/markdown.tsx";
 export { MessageList } from "./components/message-list.tsx";
 export { SidebarLayout } from "./components/sidebar-layout.tsx";
 export { StartScreen } from "./components/start-screen.tsx";
@@ -13,8 +13,8 @@ export type { Session } from "./context.ts";
 export { SessionProvider, ThemeProvider, useSession, useSessionSelector, useTheme, } from "./context.ts";
 export type { ClientConfig, ClientHandle, } from "./define-client.tsx";
 export { client } from "./define-client.tsx";
-export { useEvent, useToolCallStart, useToolResult } from "./hooks.ts";
-export type { CustomEvent, SessionCore, SessionCoreOptions, SessionSnapshot, } from "./session-core.ts";
+export { useAgentState, useEvent, useToolCallStart, useToolResult } from "./hooks.ts";
 export { createSessionCore } from "./session-core.ts";
-export type { AgentState, ChatMessage, ClientTheme, SessionError, SessionErrorCode, ToolCallInfo, VoiceSessionOptions, WebSocketConstructor, } from "./types.ts";
+export type { CustomEvent, SessionCore, SessionCoreOptions, SessionSnapshot, } from "./session-core-types.ts";
+export type { AgentState, ChatMessage, ClientTheme, SessionError, SessionErrorCode, ToolCallInfo, VoiceSessionOptions, } from "./types.ts";
 export { VOICE_CAPTURE_CONSTRAINTS } from "./types.ts";

package/dist/index.js

@@ -1,14 +1,13 @@
-import { VOICE_CAPTURE_CONSTRAINTS } from "./types.js";
-import { floatToPcm16 } from "./audio.js";
-import { n as buildAgentUrl, r as fetchClientConfig, t as client } from "./define-client-fjNCp9be.js";
+import { n as buildAgentUrl, r as fetchClientConfig, t as createSessionCore } from "./session-core-Bjkr4PAP.js";
 import { SessionProvider, ThemeProvider, useSession, useSessionSelector, useTheme } from "./context.js";
 import { Button } from "./components/button.js";
-import { t as ChatView } from "./chat-view-C1oJxsWz.js";
+import { t as ChatView } from "./chat-view-CW-tZCMm.js";
 import { i as UiUrlChip, n as ApiUrlChip, r as SessionUrlChips, t as Controls } from "./controls-DV368uhb.js";
+import { n as Markdown, t as MessageList } from "./message-list-q2lTiFhF.js";
 import { n as ToolConfigContext } from "./tool-call-block-DIxpG8GM.js";
-import { MessageList } from "./components/message-list.js";
 import { SidebarLayout } from "./components/sidebar-layout.js";
 import { StartScreen } from "./components/start-screen.js";
-import { t as createSessionCore } from "./session-core-DgioOYyx.js";
-import { useEvent, useToolCallStart, useToolResult } from "./hooks.js";
-export { ApiUrlChip, Button, ChatView, Controls, MessageList, SessionProvider, SessionUrlChips, SidebarLayout, StartScreen, ThemeProvider, ToolConfigContext, UiUrlChip, VOICE_CAPTURE_CONSTRAINTS, buildAgentUrl, client, createSessionCore, fetchClientConfig, floatToPcm16, useEvent, useSession, useSessionSelector, useTheme, useToolCallStart, useToolResult };
+import { VOICE_CAPTURE_CONSTRAINTS } from "./types.js";
+import { client } from "./define-client.js";
+import { useAgentState, useEvent, useToolCallStart, useToolResult } from "./hooks.js";
+export { ApiUrlChip, Button, ChatView, Controls, Markdown, MessageList, SessionProvider, SessionUrlChips, SidebarLayout, StartScreen, ThemeProvider, ToolConfigContext, UiUrlChip, VOICE_CAPTURE_CONSTRAINTS, buildAgentUrl, client, createSessionCore, fetchClientConfig, useAgentState, useEvent, useSession, useSessionSelector, useTheme, useToolCallStart, useToolResult };