@alexkroman1/aai-ui 5.14.0 → 6.2.0

package/dist/default-client/assets/{playback-processor-6L8SIQ_l.js → playback-processor-DwQ9tE7X.js}

@@ -1,4 +1,4 @@
-import{i as e}from"./index-D35_z2WM.js";import{t}from"./_module-url-BX0RuRU2.js";var n=t(`
+import{a as e}from"./client-audio-constants-Ck0IJO4c.js";import{t}from"./_module-url-BX0RuRU2.js";var n=`
 class PlaybackProcessor extends AudioWorkletProcessor {
   constructor(options) {
     super();
@@ -7,12 +7,17 @@ class PlaybackProcessor extends AudioWorkletProcessor {
     // so the worklet-global sampleRate is authoritative; the option exists
     // for the node-less test harness.
     const rate = opts.sampleRate ?? sampleRate;
-    // Fill target for the start of a turn. If 'done' arrives first (short
-    // utterance), start immediately instead of waiting for audio that is
-    // never coming.
-    this.jitterSamples = Math.floor((rate * (opts.jitterMs ?? 400)) / 1000);
-    // Fill target after an underrun — see PLAYBACK_REFILL_MS.
-    this.refillSamples = Math.floor((rate * (opts.refillMs ?? 200)) / 1000);
+    // Kept, because every derived quantity below reads it and \`bufferedMs\` in
+    // process() is the one that used to read the worklet global instead. Those
+    // agree in production (the option is unset, so \`rate\` IS \`sampleRate\`) and
+    // diverge only in the node-less harness — which is the one place a spec
+    // could ever assert on the reported backlog, so the divergence made the
+    // number untestable rather than wrong.
+    this.rate = rate;
+    // The one fill target — for the start of a turn and for recovery after an
+    // underrun alike. If 'done' arrives first (short utterance), start
+    // immediately instead of waiting for audio that is never coming.
+    this.fillSamples = Math.floor((rate * (opts.fillMs ?? 200)) / 1000);
     // Concealment source: a ring of the most recently played samples, looped
     // under a decaying gain to cover a gap. Sized to the fade window, with a
     // per-sample decay that reaches the floor exactly at its end.
@@ -69,7 +74,6 @@ class PlaybackProcessor extends AudioWorkletProcessor {
     // pre-roll (nothing to extrapolate from, and not a defect) from a
     // mid-turn underrun.
     this.hasPlayed = false;
-    this.fillTarget = this.jitterSamples;
     // Carry-over byte for split samples across chunks
     this.carry = null;
     this.writePos = 0;
@@ -254,14 +258,14 @@ class PlaybackProcessor extends AudioWorkletProcessor {
     if (this.sinceReportSamples >= this.reportIntervalSamples) {
       this.sinceReportSamples = 0;
       if (avail > 0) {
-        this.port.postMessage({ event: 'progress', bufferedMs: (avail / sampleRate) * 1000 });
+        this.port.postMessage({ event: 'progress', bufferedMs: (avail / this.rate) * 1000 });
       }
     }
 
     // Filling: wait for the target. 'done' short-circuits it — what is
     // buffered is all there will be, so there is nothing left to wait for.
     if (!this.playing) {
-      if (avail >= this.fillTarget || this.isDone) {
+      if (avail >= this.fillSamples || this.isDone) {
         this.playing = true;
       } else {
         this.coverGap(out, 0);
@@ -270,13 +274,12 @@ class PlaybackProcessor extends AudioWorkletProcessor {
     }
 
     // Underrun: this quantum cannot be filled and more audio is still coming.
-    // Go back to filling (at the refill target) and cover the gap, leaving
+    // Go back to filling and cover the gap, leaving
     // readPos untouched — the fragment stays buffered and plays intact once
     // the buffer recovers, instead of being dribbled out a few samples at a
     // time for the rest of the turn.
     if (avail < out.length && !this.isDone) {
       this.playing = false;
-      this.fillTarget = this.refillSamples;
       this.coverGap(out, 0);
       return true;
     }
@@ -308,4 +311,4 @@ class PlaybackProcessor extends AudioWorkletProcessor {
 }
 
 registerProcessor('playback-processor', PlaybackProcessor);
-`);export{n as default};
+`,r=t(n);export{r as default};

package/dist/default-client/index.html

@@ -6,8 +6,9 @@
     <title>aai</title>
     <link rel="icon" href="./favicon.ico" />
     <style>html, body { background: #FBF8F2; margin: 0; }</style>
-    <script type="module" crossorigin src="./assets/index-D35_z2WM.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-DCjB3qtb.css">
+    <script type="module" crossorigin src="./assets/index-DCI51Xz_.js"></script>
+    <link rel="modulepreload" crossorigin href="./assets/client-audio-constants-Ck0IJO4c.js">
+    <link rel="stylesheet" crossorigin href="./assets/index-CDugAuLK.css">
   </head>
   <body>
     <main id="app"></main>

package/dist/define-client.d.ts

@@ -1,5 +1,5 @@
 /** @jsxImportSource react */
-import { type ComponentType } from "react";
+import { type ComponentType, type ReactNode } from "react";
 import { type ToolDisplayConfig } from "./components/tool-config-context.ts";
 import type { SessionCore } from "./session-core-types.ts";
 import type { ClientTheme, VoiceSessionOptions } from "./types.ts";
@@ -99,6 +99,45 @@ export type ClientHandle = {
     /** Alias for `dispose` for use with `using`. */
     [Symbol.dispose](): void;
 };
+/**
+ * The element a mount renders into.
+ *
+ * Exported so `page()` resolves its target the same way `client()` does — the
+ * default selector and the "element not found" sentence are part of what an
+ * author has learned, and a second copy is how the two mounts come to disagree
+ * about which one they were given.
+ *
+ * @internal
+ */
+export declare function resolveContainer(target?: string | HTMLElement): HTMLElement;
+/**
+ * What a mount hands back: unmount, and `using` support.
+ *
+ * @internal
+ */
+export type MountedRoot = {
+    /** Unmount the React tree (and, for `client()`, dispose the session). */
+    dispose(): void;
+    /** Alias for `dispose` for use with `using`. */
+    [Symbol.dispose](): void;
+};
+/**
+ * Render `node` into `container` and hand back its teardown.
+ *
+ * Shared by {@link client} and `page()` because the plumbing is identical and
+ * the two decisions in it are not obvious enough to be re-derived: the root is
+ * created here rather than by the caller so nothing else can hold one, and the
+ * render is `flushSync` so the mount is observable to the caller's NEXT
+ * STATEMENT (and to a test) rather than scheduled — `client()` returns a handle
+ * whose session is expected to be live, and `page()` returns one a caller may
+ * dispose immediately.
+ *
+ * `onDispose` runs after the unmount, which is the order `client()` needs: the
+ * tree comes down before the session under it goes away.
+ *
+ * @internal
+ */
+export declare function mountRoot(container: HTMLElement, node: ReactNode, onDispose?: () => void): MountedRoot;
 /**
  * Define and mount a client UI for a voice agent.
  *

package/dist/define-client.js

@@ -1,6 +1,6 @@
-import { r as fetchClientConfig, t as createSessionCore } from "./session-core-BA8H3qtF.js";
+import { r as fetchClientConfig, t as createSessionCore } from "./session-core-ClKdVgRU.js";
 import { SessionProvider, ThemeProvider } from "./context.js";
-import { t as ChatView } from "./chat-view-CgFytvGy.js";
+import { t as ChatView } from "./chat-view-CK61bWWx.js";
 import { t as pageBaseUrl } from "./_utils-CsqbIVGI.js";
 import { n as ToolConfigContext } from "./tool-call-block-CrLN7xlI.js";
 import { SidebarLayout } from "./components/sidebar-layout.js";
@@ -11,6 +11,16 @@ import { flushSync } from "react-dom";
 import { createRoot } from "react-dom/client";
 //#region define-client.tsx
 /** @jsxImportSource react */
+/**
+* The element a mount renders into.
+*
+* Exported so `page()` resolves its target the same way `client()` does — the
+* default selector and the "element not found" sentence are part of what an
+* author has learned, and a second copy is how the two mounts come to disagree
+* about which one they were given.
+*
+* @internal
+*/
 function resolveContainer(target = "#app") {
 	if (typeof target !== "string") return target;
 	const el = document.querySelector(target);
@@ -18,6 +28,37 @@ function resolveContainer(target = "#app") {
 	return el;
 }
 /**
+* Render `node` into `container` and hand back its teardown.
+*
+* Shared by {@link client} and `page()` because the plumbing is identical and
+* the two decisions in it are not obvious enough to be re-derived: the root is
+* created here rather than by the caller so nothing else can hold one, and the
+* render is `flushSync` so the mount is observable to the caller's NEXT
+* STATEMENT (and to a test) rather than scheduled — `client()` returns a handle
+* whose session is expected to be live, and `page()` returns one a caller may
+* dispose immediately.
+*
+* `onDispose` runs after the unmount, which is the order `client()` needs: the
+* tree comes down before the session under it goes away.
+*
+* @internal
+*/
+function mountRoot(container, node, onDispose) {
+	const root = createRoot(container);
+	flushSync(() => {
+		root.render(node);
+	});
+	return {
+		dispose() {
+			root.unmount();
+			onDispose?.();
+		},
+		[Symbol.dispose]() {
+			this.dispose();
+		}
+	};
+}
+/**
 * Default shell rendered in config tier.
 * Wraps StartScreen → (SidebarLayout →) ChatView.
 */
@@ -38,10 +79,22 @@ function DefaultShell({ name, Sidebar, sidebarWidth }) {
 * 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
+* `client({ 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-core.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.
 */
 function DefaultRoot({ platformUrl, name, Sidebar, sidebarWidth }) {
 	const [resolved, setResolved] = useState(null);
+	const needsLookup = name === void 0;
 	useEffect(() => {
+		if (!needsLookup) return;
 		let cancelled = false;
 		fetchClientConfig(platformUrl).then((cfg) => {
 			if (!cancelled) setResolved(cfg);
@@ -49,7 +102,7 @@ function DefaultRoot({ platformUrl, name, Sidebar, sidebarWidth }) {
 		return () => {
 			cancelled = true;
 		};
-	}, [platformUrl]);
+	}, [platformUrl, needsLookup]);
 	return /* @__PURE__ */ jsx(DefaultShell, {
 		name: name ?? resolved?.name,
 		Sidebar,
@@ -120,21 +173,10 @@ function client(config) {
 		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 = {
+	return {
 		session,
-		dispose() {
-			root.unmount();
-			session[Symbol.dispose]();
-		},
-		[Symbol.dispose]() {
-			handle.dispose();
-		}
+		...mountRoot(container, createElement(ToolConfigContext.Provider, { value: toolConfig }, createElement(ThemeProvider, { value: config.theme }, createElement(SessionProvider, { value: session }, rootNode))), () => session[Symbol.dispose]())
 	};
-	return handle;
 }
 //#endregion
-export { client };
+export { client, mountRoot, resolveContainer };

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export { AutoScroll } from "./components/auto-scroll.tsx";
 export { Button, type ButtonSize, type ButtonVariant } from "./components/button.tsx";
 export { ChatView } from "./components/chat-view.tsx";
 export { Controls } from "./components/controls.tsx";
+export { CheckboxField, Field, type FieldShell, FileField, type FileRead, type FileValue, Form, type FormProps, type FormValues, NumberField, SelectField, SubmitButton, TextAreaField, TextField, } from "./components/form.tsx";
 export { Markdown, type MarkdownVariant } from "./components/markdown.tsx";
 export { MessageList } from "./components/message-list.tsx";
 export { SidebarLayout } from "./components/sidebar-layout.tsx";
@@ -11,12 +12,21 @@ export { ToolCallRow, type ToolCallRowProps, type ToolCallRowVariant, } from "./
 export type { ToolDisplayConfig } from "./components/tool-config-context.ts";
 export { ToolConfigContext } from "./components/tool-config-context.ts";
 export { ApiUrlChip, SessionUrlChips, UiUrlChip } from "./components/url-chips.tsx";
+export { WorkflowFields } from "./components/workflow-fields.tsx";
+export { WorkflowProgress } from "./components/workflow-progress.tsx";
 export type { Session } from "./context.ts";
 export { SessionProvider, ThemeProvider, useSession, useSessionSelector, useTheme, } from "./context.ts";
 export type { BaseOptions, ClientConfig, ClientHandle, ComponentTier, ConfigTier, } from "./define-client.tsx";
 export { client } from "./define-client.tsx";
 export { useAgentState, useEvent, useToolCallStart, useToolResult } from "./hooks.ts";
+export { type PageConfig, type PageHandle, page } from "./page.tsx";
 export { createSessionCore } from "./session-core.ts";
 export type { AgentCustomEvent, SessionCore, SessionCoreOptions, SessionSnapshot, } from "./session-core-types.ts";
 export type { AgentState, ChatMessage, ClientTheme, SessionError, SessionErrorCode, ToolCallInfo, VoiceSessionOptions, WebSocketConstructor, } from "./types.ts";
 export { VOICE_CAPTURE_CONSTRAINTS } from "./types.ts";
+export { TRANSCRIBING_PLACEHOLDER, type UseUserTranscriptResult, useUserTranscript, } from "./use-user-transcript.ts";
+export { type UseWorkflowSubmitOptions, type UseWorkflowsOptions, type UseWorkflowsResult, useWorkflowSubmit, useWorkflows, type WorkflowSubmission, } from "./use-workflow-form.ts";
+export { DEFAULT_PROGRESS_POLL_MS, type UseWorkflowProgressResult, useWorkflowProgress, } from "./use-workflow-progress.ts";
+export { DEFAULT_WORKFLOW_POLL_MS, MAX_MISSING_READS, type UseWorkflowRunResult, useWorkflowRun, } from "./use-workflow-run.ts";
+export { type UseWorkflowRunsOptions, type UseWorkflowRunsResult, useWorkflowRuns, } from "./use-workflow-runs.ts";
+export { createWorkflowApi, isTerminal, type WorkflowApi, type WorkflowApiOptions, type WorkflowOutputOf, type WorkflowRun, type WorkflowSummary, } from "./workflow-client.ts";