@alexkroman1/aai-ui 7.0.0 → 8.0.0

package/dist/internal.d.ts

@@ -38,3 +38,6 @@ export { ToolConfigContext } from "./components/tool-config-context.ts";
 export { ApiUrlChip, SessionUrlChips, UiUrlChip } from "./components/url-chips.tsx";
 export { SessionProvider, ThemeProvider } from "./context.ts";
 export { VOICE_CAPTURE_CONSTRAINTS } from "./types.ts";
+export { TRANSCRIBING_PLACEHOLDER } from "./use-user-transcript.ts";
+export { DEFAULT_PROGRESS_POLL_MS } from "./use-workflow-progress.ts";
+export { DEFAULT_WORKFLOW_POLL_MS, MAX_MISSING_READS } from "./use-workflow-run.ts";

package/dist/internal.js

@@ -1,6 +1,8 @@
-import { r as loadClientConfig, t as buildAgentUrl } from "./client-config-B4nznRvH.js";
+import { r as loadClientConfig, t as buildAgentUrl } from "./client-config-BT_kWID5.js";
 import { SessionProvider, ThemeProvider } from "./context.js";
-import { n as SessionUrlChips, r as UiUrlChip, t as ApiUrlChip } from "./url-chips-DpM7Oocj.js";
+import { n as SessionUrlChips, r as UiUrlChip, t as ApiUrlChip } from "./url-chips-DxXKgyL9.js";
+import { t as TRANSCRIBING_PLACEHOLDER } from "./use-user-transcript-C14qWFu2.js";
 import { t as ToolConfigContext } from "./tool-config-context-DzAofqi_.js";
+import { i as MAX_MISSING_READS, r as DEFAULT_WORKFLOW_POLL_MS, t as DEFAULT_PROGRESS_POLL_MS } from "./use-workflow-progress-C4KgVldr.js";
 import { VOICE_CAPTURE_CONSTRAINTS } from "./types.js";
-export { ApiUrlChip, SessionProvider, SessionUrlChips, ThemeProvider, ToolConfigContext, UiUrlChip, VOICE_CAPTURE_CONSTRAINTS, buildAgentUrl, loadClientConfig };
+export { ApiUrlChip, DEFAULT_PROGRESS_POLL_MS, DEFAULT_WORKFLOW_POLL_MS, MAX_MISSING_READS, SessionProvider, SessionUrlChips, TRANSCRIBING_PLACEHOLDER, ThemeProvider, ToolConfigContext, UiUrlChip, VOICE_CAPTURE_CONSTRAINTS, buildAgentUrl, loadClientConfig };

package/dist/{message-list-DHddO4QC.js → message-list-Dtl03sGr.js}

@@ -1,6 +1,7 @@
 import { useSessionSelector, useTheme } from "./context.js";
-import { i as primaryTint, r as inkTint } from "./_colors-CcAi2FOU.js";
-import { t as ToolCallBlock } from "./tool-call-block-DoF-cSIZ.js";
+import { i as primaryTint, r as inkTint } from "./_colors-j8XMToi9.js";
+import { n as useUserTranscript } from "./use-user-transcript-C14qWFu2.js";
+import { t as ToolCallBlock } from "./tool-call-block-B7KlhaWl.js";
 import clsx from "clsx";
 import { StickToBottom } from "use-stick-to-bottom";
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -65,71 +66,6 @@ function AutoScroll({ children, className, contentClassName, scrollClassName = "
 	});
 }
 //#endregion
-//#region use-user-transcript.ts
-/**
-* `useUserTranscript` — what the caller is saying RIGHT NOW, read correctly.
-*
-* `SessionSnapshot.userTranscript` is `string | null`, and the two falsy values
-* mean different things:
-*
-* - `null` — nobody is speaking. There is no partial turn.
-* - `""` — speech HAS been detected and no words have come back yet. A live
-*   session sits here for a few hundred milliseconds at the start of every turn.
-*
-* Read as one falsy check, those collapse and the indicator never appears at the
-* start of a turn — which is the moment it is for. So every custom chrome writes
-* `transcript !== null && (transcript === "" ? "…" : transcript)`, three
-* templates did exactly that, and each one re-derived a protocol distinction
-* from the type rather than from anything that told them.
-*
-* This is the same distinction as two named booleans, so a component can say
-* what it means: render on `speaking`, show `text`, and use the SDK's own
-* placeholder when there is nothing to show yet.
-*/
-/**
-* Placeholder for "listening, no words yet" — the `""` case above.
-*
-* A one-character ellipsis rather than three dots, because it is read by a
-* screen reader as an ellipsis and it does not reflow the row when the first
-* real word replaces it.
-*
-* @public
-*/
-const TRANSCRIBING_PLACEHOLDER = "…";
-/**
-* Subscribe to the caller's in-progress turn.
-*
-* Narrowly subscribed — a component using this re-renders at STT-partial rate,
-* which is exactly what it is for and exactly what a whole-page `useSession()`
-* should not do.
-*
-* @example
-* ```tsx
-* import { useUserTranscript } from "@alexkroman1/aai-ui";
-*
-* function LiveTranscript() {
-*   const { speaking, text } = useUserTranscript();
-*   if (!speaking) return null;
-*   return <div className="italic opacity-60">{text}</div>;
-* }
-* ```
-*
-* @public
-*/
-function useUserTranscript() {
-	const partial = useSessionSelector((snapshot) => snapshot.userTranscript);
-	return {
-		speaking: partial !== null,
-		text: displayText(partial),
-		partial
-	};
-}
-/** The three cases, spelled out: silent, detected-but-wordless, and words. */
-function displayText(partial) {
-	if (partial === null) return "";
-	return partial === "" ? "…" : partial;
-}
-//#endregion
 //#region use-conversation.ts
 /**
 * `useConversation` — the exchange, already assembled, with nothing rendered.
@@ -581,4 +517,4 @@ const MessageList = memo(function MessageList({ className }) {
 	});
 });
 //#endregion
-export { useUserTranscript as a, TRANSCRIBING_PLACEHOLDER as i, Markdown as n, AutoScroll as o, useConversation as r, MessageList as t };
+export { AutoScroll as i, Markdown as n, useConversation as r, MessageList as t };

package/dist/{session-core-C2JtLArh.js → session-core-CMEpwRP1.js}

@@ -1,6 +1,6 @@
-import { r as loadClientConfig, t as buildAgentUrl } from "./client-config-B4nznRvH.js";
+import { r as loadClientConfig, t as buildAgentUrl } from "./client-config-BT_kWID5.js";
 import { MIC_SEND_MAX_BUFFERED_BYTES } from "./types.js";
-import { ServerMessageSchema, lenientParse } from "@alexkroman1/aai/protocol";
+import { SessionEventSchema, lenientParse } from "@alexkroman1/aai/protocol";
 import { errorMessage, safeJsonParse } from "@alexkroman1/aai";
 import { omitUndefined } from "@alexkroman1/aai/utils";
 import { DEFAULT_MAX_HISTORY, WS_OPEN, createEpoch, toArgsRecord } from "@alexkroman1/aai/internal";
@@ -427,7 +427,7 @@ function createHandshakeGuard(opts) {
 * Incoming-message handling for the voice session core.
 *
 * Split out of `session-core.ts`: this module owns the interpretation of
-* server→client frames (audio chunks + JSON {@link ServerMessage}s) and the
+* server→client frames (audio chunks + JSON {@link SessionEvent}s) and the
 * turn-boundary generation counters, while `session-core.ts` owns the state
 * store and connection lifecycle. The handlers read and mutate session state
 * exclusively through the injected `getSnapshot`/`updateState` deps.
@@ -734,7 +734,7 @@ function createMessageHandlers(deps) {
 			console.warn("session-core: invalid JSON; dropping");
 			return;
 		}
-		const parsed = lenientParse(ServerMessageSchema, raw);
+		const parsed = lenientParse(SessionEventSchema, raw);
 		if (!parsed.ok) {
 			if (parsed.malformed) console.warn("session-core: malformed server message", parsed.error);
 			return;

package/dist/session-core-audio-setup.d.ts

@@ -1,10 +1,10 @@
-import type { ClientMessage } from "@alexkroman1/aai/protocol";
+import type { SessionCommand } from "@alexkroman1/aai/protocol";
 import type { VoiceIO } from "./audio.ts";
 import type { SessionStateMachine } from "./session-core-state.ts";
 import type { ConnState, SessionSnapshot } from "./session-core-types.ts";
 /** Dependencies `initAudioCapture` needs from the owning session core. */
 export type AudioSetupDeps = {
-    sendJson: (msg: ClientMessage) => void;
+    sendJson: (msg: SessionCommand) => void;
     sendAudio: (bytes: ArrayBuffer) => void;
     updateState: (partial: Partial<SessionSnapshot>) => void;
     /** The session's state and error, as one fact — see `session-core-state.ts`. */

package/dist/session-core-messages.d.ts

@@ -36,7 +36,7 @@ type MessageHandlers = {
      * Dispatch an incoming WebSocket message.
      *
      * Binary frames carry raw PCM16 audio chunks. Text frames are JSON-encoded
-     * {@link ServerMessage} values validated via Zod.
+     * {@link SessionEvent} values validated via Zod.
      *
      * Returns the parsed config if the message is a `config` message,
      * otherwise `undefined`.

package/dist/session-core.js

@@ -1,2 +1,2 @@
-import { t as createSessionCore } from "./session-core-C2JtLArh.js";
+import { t as createSessionCore } from "./session-core-CMEpwRP1.js";
 export { createSessionCore };

package/dist/{tool-call-block-DoF-cSIZ.js → tool-call-block-B7KlhaWl.js}

@@ -1,5 +1,5 @@
 import { useTheme } from "./context.js";
-import { r as inkTint } from "./_colors-CcAi2FOU.js";
+import { r as inkTint } from "./_colors-j8XMToi9.js";
 import { t as Eyebrow } from "./eyebrow-C6ZFuiz6.js";
 import { i as tryParseJSON, r as truncate } from "./_utils-B6498_bm.js";
 import { n as useToolConfig } from "./tool-config-context-DzAofqi_.js";

package/dist/{url-chips-DpM7Oocj.js → url-chips-DxXKgyL9.js}

@@ -1,5 +1,5 @@
 import { useSessionSelector, useTheme } from "./context.js";
-import { r as inkTint } from "./_colors-CcAi2FOU.js";
+import { r as inkTint } from "./_colors-j8XMToi9.js";
 import { t as pageBaseUrl } from "./_utils-B6498_bm.js";
 import clsx from "clsx";
 import { jsx, jsxs } from "react/jsx-runtime";

package/dist/use-user-transcript-C14qWFu2.js

@@ -0,0 +1,72 @@
+import { useSessionSelector } from "./context.js";
+//#region use-user-transcript.ts
+/**
+* `useUserTranscript` — what the caller is saying RIGHT NOW, read correctly.
+*
+* `SessionSnapshot.userTranscript` is `string | null`, and the two falsy values
+* mean different things:
+*
+* - `null` — nobody is speaking. There is no partial turn.
+* - `""` — speech HAS been detected and no words have come back yet. A live
+*   session sits here for a few hundred milliseconds at the start of every turn.
+*
+* Read as one falsy check, those collapse and the indicator never appears at the
+* start of a turn — which is the moment it is for. So every custom chrome writes
+* `transcript !== null && (transcript === "" ? "…" : transcript)`, three
+* templates did exactly that, and each one re-derived a protocol distinction
+* from the type rather than from anything that told them.
+*
+* This is the same distinction as two named booleans, so a component can say
+* what it means: render on `speaking`, show `text`, and use the SDK's own
+* placeholder when there is nothing to show yet.
+*/
+/**
+* Placeholder for "listening, no words yet" — the `""` case above.
+*
+* A one-character ellipsis rather than three dots, because it is read by a
+* screen reader as an ellipsis and it does not reflow the row when the first
+* real word replaces it.
+*
+* On `@alexkroman1/aai-ui/internal`, not the root: no public signature names
+* it, and a `client.tsx` rendering its own transcript row compares against the
+* character. `UseUserTranscriptResult.text` therefore spells the value out
+* rather than linking here.
+*
+* @internal
+*/
+const TRANSCRIBING_PLACEHOLDER = "…";
+/**
+* Subscribe to the caller's in-progress turn.
+*
+* Narrowly subscribed — a component using this re-renders at STT-partial rate,
+* which is exactly what it is for and exactly what a whole-page `useSession()`
+* should not do.
+*
+* @example
+* ```tsx
+* import { useUserTranscript } from "@alexkroman1/aai-ui";
+*
+* function LiveTranscript() {
+*   const { speaking, text } = useUserTranscript();
+*   if (!speaking) return null;
+*   return <div className="italic opacity-60">{text}</div>;
+* }
+* ```
+*
+* @public
+*/
+function useUserTranscript() {
+	const partial = useSessionSelector((snapshot) => snapshot.userTranscript);
+	return {
+		speaking: partial !== null,
+		text: displayText(partial),
+		partial
+	};
+}
+/** The three cases, spelled out: silent, detected-but-wordless, and words. */
+function displayText(partial) {
+	if (partial === null) return "";
+	return partial === "" ? "…" : partial;
+}
+//#endregion
+export { useUserTranscript as n, TRANSCRIBING_PLACEHOLDER as t };

package/dist/use-user-transcript.d.ts

@@ -25,7 +25,12 @@
  * screen reader as an ellipsis and it does not reflow the row when the first
  * real word replaces it.
  *
- * @public
+ * On `@alexkroman1/aai-ui/internal`, not the root: no public signature names
+ * it, and a `client.tsx` rendering its own transcript row compares against the
+ * character. `UseUserTranscriptResult.text` therefore spells the value out
+ * rather than linking here.
+ *
+ * @internal
  */
 export declare const TRANSCRIBING_PLACEHOLDER = "\u2026";
 /** What {@link useUserTranscript} returns. */
@@ -36,7 +41,7 @@ export interface UseUserTranscriptResult {
      */
     speaking: boolean;
     /**
-     * The words so far, or {@link TRANSCRIBING_PLACEHOLDER} while there are none.
+     * The words so far, or a one-character ellipsis (`…`) while there are none.
      * Empty string when nobody is speaking.
      */
     text: string;