@alexkroman1/aai-ui 0.16.0 → 0.17.0

package/dist/default-client/assets/{playback-processor-DXHfyQD9.js → playback-processor-CCwTknSu.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-BlUYCTB5.js";import{t}from"./_module-url-BX0RuRU2.js";var n=`
 class PlaybackProcessor extends AudioWorkletProcessor {
   constructor(options) {
     super();

package/dist/default-client/index.html

@@ -6,7 +6,7 @@
     <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>
+    <script type="module" crossorigin src="./assets/index-BlUYCTB5.js"></script>
     <link rel="stylesheet" crossorigin href="./assets/index-_-x5JLLa.css">
   </head>
   <body>

package/dist/define-client.d.ts

@@ -27,6 +27,7 @@ import type { ClientTheme, VoiceSessionOptions } from "./types.ts";
  * `component`, which invited the identical failure for a combination
  * {@link mountClient} can simply render.
  *
+ * @input
  * @public
  */
 export type ClientConfig = Pick<VoiceSessionOptions, "onSessionId" | "resumeSessionId" | "location" | "phone" | "client" | "token" | "WebSocket"> & {
@@ -94,6 +95,7 @@ export type ClientConfig = Pick<VoiceSessionOptions, "onSessionId" | "resumeSess
  *
  * Implements `Disposable` so it can be used with `using`.
  *
+ * @sealed
  * @public
  */
 export type ClientHandle = {

package/dist/define-client.js

@@ -1,7 +1,7 @@
-import { t as ChatView } from "./chat-view-DIwPoAEG.js";
+import { t as ChatView } from "./chat-view-W6KcdjJY.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 { n as fetchClientConfig } from "./client-config-CzvWmw4X.js";
+import { t as createBrowserSession } from "./session-3lgPYNNO.js";
 import { SessionProvider, ThemeProvider } from "./context.js";
 import { t as ToolConfigContext } from "./tool-config-context-Es4YUzV2.js";
 import { SidebarLayout } from "./components/sidebar-layout.js";
@@ -105,7 +105,7 @@ function DefaultRoot({ platformUrl, ...display }) {
 	useEffect(() => {
 		if (!needsLookup) return;
 		let cancelled = false;
-		fetchClientConfig(platformUrl).then((cfg) => {
+		fetchClientConfig({ platformUrl }).then((cfg) => {
 			if (!cancelled) setResolved(cfg);
 		});
 		return () => {

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,7 @@
  */
 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 { 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,7 +75,7 @@ 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, Form, type FormProps, type FormValues, isFileValue, NumberField, SelectField, SubmitButton, TextAreaField, TextField, } 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";
@@ -106,7 +106,7 @@ 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, 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";

package/dist/index.js

@@ -1,10 +1,10 @@
-import { a as AGENT_STATE_LABELS, i as SessionErrorBanner, n as ConsoleShell, r as SessionStateDot, t as ChatView } from "./chat-view-DIwPoAEG.js";
+import { a as AGENT_STATE_LABELS, i as SessionErrorBanner, n as ConsoleShell, r as SessionStateDot, t as ChatView } from "./chat-view-W6KcdjJY.js";
 import { n as pageBaseUrl, r as setPageTitle, t as isTypingTarget } from "./_utils-Mi-SCFA1.js";
-import { n as fetchClientConfig, t as buildAgentUrl } from "./client-config-C7fQrioM.js";
-import { a as ticketCarriage, c as resolveReported, d as storageSet, f as urlSlot, i as resolveSessionTokenSync, l as storageGet, r as resolveSessionToken, s as browserClientId, t as createBrowserSession, u as storageRemove } from "./session-CYdjRvbl.js";
+import { n as fetchClientConfig, t as buildAgentUrl } from "./client-config-CzvWmw4X.js";
+import { a as ticketCarriage, c as resolveReported, d as storageSet, f as urlSlot, i as resolveSessionTokenSync, l as storageGet, r as resolveSessionToken, s as browserClientId, t as createBrowserSession, u as storageRemove } from "./session-3lgPYNNO.js";
 import { ThemeProvider, useOptionalSessionCore, useSession, useSessionActions, useSessionCore, useSessionError, useSessionSelector, useSessionStatus, useTheme } from "./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 useConversation, i as interleave, n as Markdown, o as AutoScroll, r as ConversationView, t as MessageList } from "./message-list-DHZcLhRA.js";
+import { a as useConversation, i as interleave, n as Markdown, o as AutoScroll, r as ConversationView, t as MessageList } from "./message-list-BsaBkBgo.js";
 import { a as inkTint, i as focusRingStyle, n as FOCUS_RING } from "./_colors-CpZO-88A.js";
 import { Button } from "./components/button.js";
 import { a as useFlash, i as useCopy } from "./url-chips-oyy_Eiqh.js";
@@ -797,6 +797,27 @@ function FileField({ name, label, hint, className, read = "none", upload = false
 	});
 }
 //#endregion
+//#region src/components/form-types.ts
+/**
+* What a form's controls CONTRIBUTE — the types both halves of the form code
+* share, and {@link isFileValue}, the guard that reads one back.
+*
+* Their own module because `form.tsx` (the components) and `_form-values.ts`
+* (the DOM read) both need them, and a type living in one of those would make
+* the pair import each other.
+*/
+/**
+* Whether one {@link FormValues} entry is what a {@link FileField} contributed.
+*
+* A field with nothing chosen contributes no key at all, so the absent case is
+* the ordinary one — this is `false` for `undefined`, not an error.
+*
+* @public
+*/
+function isFileValue(value) {
+	return isRecord(value) && typeof value.name === "string" && typeof value.size === "number" && typeof value.type === "string" && typeof value.lastModified === "number" && (value.content === void 0 || typeof value.content === "string");
+}
+//#endregion
 //#region src/components/form.tsx
 /** @jsxImportSource react */
 /**
@@ -1019,7 +1040,7 @@ const DEFAULT_VARIANT = {
 };
 function defaultButton({ action, label, onClick }) {
 	return /* @__PURE__ */ jsx(Button, {
-		variant: DEFAULT_VARIANT[action],
+		variant: DEFAULT_VARIANT[action] ?? "secondary",
 		onClick,
 		children: label
 	});
@@ -1339,9 +1360,10 @@ function useWorkflows(options = {}) {
 * studio's SDK-subpath list: mirroring "would just move the drift somewhere
 * new".
 *
-* So a NEW control added to `<WorkflowFields>` is a new member of
-* {@link WorkflowFieldKind}, and every reader of the rule finds out from the
-* type rather than from a table somebody remembered to edit.
+* So a NEW control added to `<WorkflowFields>` is a new value of
+* {@link WorkflowFieldKind}. The set is open, so that addition is not a break:
+* a reader's `switch` keeps a `default` and treats a kind it does not know the
+* way it treats `"none"`.
 */
 /**
 * A property's declared type, taking the first non-null member of a union.
@@ -1835,7 +1857,7 @@ function WorkflowRunPanel({ run, statusLabels, onClear, api, live, children, cla
 */
 /** The item as the log keeps it: a tool call's `result` dropped. */
 function logItem(item) {
-	if (item.kind === "message" || item.toolCall.result === void 0) return item;
+	if (item.kind !== "tool" || item.toolCall.result === void 0) return item;
 	const { result: _result, ...toolCall } = item.toolCall;
 	return {
 		kind: "tool",
@@ -1845,7 +1867,11 @@ function logItem(item) {
 /** One item's identity as a turn — ignoring ids and a tool call going pending → done. */
 function turnKey(item) {
 	if (!item) return "";
-	return item.kind === "message" ? `m${item.message.role}:${item.message.content}` : `t${item.toolCall.name}:${JSON.stringify(item.toolCall.args)}`;
+	switch (item.kind) {
+		case "message": return `m${item.message.role}:${item.message.content}`;
+		case "tool": return `t${item.toolCall.name}:${JSON.stringify(item.toolCall.args)}`;
+		default: return `o${item.type}`;
+	}
 }
 /** The same turn in the same state — what makes a rewrite a no-op. */
 function sameItem(a, b) {
@@ -1976,11 +2002,15 @@ function parseItem(raw) {
 	if (!isRecord(raw)) return void 0;
 	if (raw.kind === "message" && isRecord(raw.message)) return parseMessage(raw.message);
 	if (raw.kind === "tool" && isRecord(raw.toolCall)) return parseToolCall(raw.toolCall);
+	if (typeof raw.kind === "string" && raw.kind !== "message" && raw.kind !== "tool") return {
+		kind: "other",
+		type: raw.kind === "other" && typeof raw.type === "string" ? raw.type : raw.kind
+	};
 }
 function parseMessage(raw) {
 	const { id, role, content } = raw;
 	if (typeof id !== "number" || typeof content !== "string") return void 0;
-	return role === "user" || role === "assistant" ? message(id, role, content) : void 0;
+	return typeof role === "string" && role !== "" ? message(id, role, content) : void 0;
 }
 function parseToolCall(raw) {
 	const { callId, name, args, status, seq, afterMessageId } = raw;
@@ -2055,15 +2085,27 @@ function parseNoticeHeader(json) {
 		bytes
 	};
 }
+/** The wire frame types this version knows; anything else is an `"other"` event. */
+const KNOWN_FRAME_TYPES = /* @__PURE__ */ new Set([
+	"notice",
+	"session_event",
+	"session_ended"
+]);
 /**
-* 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" }`.
 */
 function parseInboxEvent(json) {
-	const frame = parseServerFrame(json);
-	return frame === void 0 || frame.type === "notice" ? void 0 : frame;
+	const raw = safeJsonParse$1(json);
+	if (isRecord(raw) && typeof raw.type === "string" && !KNOWN_FRAME_TYPES.has(raw.type)) return {
+		type: "other",
+		frameType: raw.type
+	};
+	const parsed = InboxServerFrameSchema.safeParse(raw);
+	return !parsed.success || parsed.data.type === "notice" ? void 0 : parsed.data;
 }
 /**
 * The receiving state machine of one socket — see the module doc for its four
@@ -4405,7 +4447,7 @@ function useConversationLog(options = {}) {
 	own.current = sessionId;
 	const mirrored = useRef(/* @__PURE__ */ new Map());
 	const mirror = useCallback((event) => {
-		if (event.sessionId === own.current) return;
+		if (event.type === "other" || event.sessionId === own.current) return;
 		if (event.type === "session_ended") {
 			mirrored.current.delete(event.sessionId);
 			return;
@@ -5661,4 +5703,4 @@ function fileAt(input, field) {
 	return filesOf(input[field])[0];
 }
 //#endregion
-export { AGENT_STATE_LABELS, AudioResult, AutoScroll, BulletList, Button, ChatView, CheckboxField, ConsoleShell, Controls, ConversationView, Facts, Field, FileField, Form, Markdown, MessageList, NumberField, SelectField, SessionControls, SessionErrorBanner, SessionStateDot, SidebarLayout, StartScreen, SubmitButton, TextAreaField, TextField, ToolCallRow, UploadProgressBar, WORKFLOW_STATUS_LABELS, WorkflowFields, WorkflowPendingNote, WorkflowProgress, WorkflowRunError, WorkflowRunPanel, browserClientId, createBrowserSession, createInbox, createLinkedClient, createStoredValue, createWorkflowApi, errorMessage, fetchClientConfig, fieldKindFor, inboxEventToItem, isTerminal, mountClient, mountPage, phoneE164, routeFetch, selectAgentState, useAgentState, useClientId, useClientRuns, useClientTool, useConversation, useConversationLog, useCopy, useDownloadUrl, useEvent, useFlash, useInbox, usePushToTalk, useRoute, useRouteMutation, useRunKey, useSession, useSessionActions, useSessionControls, useSessionError, useSessionId, useSessionSelector, useSessionStatus, useStoredValue, useTapToTalk, useTheme, useToolCallStart, useToolResult, useUserTranscript, useWorkflowProgress, useWorkflowRun, useWorkflowRuns, useWorkflowStream, useWorkflowSubmit, useWorkflows };
+export { AGENT_STATE_LABELS, AudioResult, AutoScroll, BulletList, Button, ChatView, CheckboxField, ConsoleShell, Controls, ConversationView, Facts, Field, FileField, Form, Markdown, MessageList, NumberField, SelectField, SessionControls, SessionErrorBanner, SessionStateDot, SidebarLayout, StartScreen, SubmitButton, TextAreaField, TextField, ToolCallRow, UploadProgressBar, WORKFLOW_STATUS_LABELS, WorkflowFields, WorkflowPendingNote, WorkflowProgress, WorkflowRunError, WorkflowRunPanel, browserClientId, createBrowserSession, createInbox, createLinkedClient, createStoredValue, createWorkflowApi, errorMessage, fetchClientConfig, fieldKindFor, inboxEventToItem, isFileValue, isTerminal, mountClient, mountPage, phoneE164, routeFetch, selectAgentState, useAgentState, useClientId, useClientRuns, useClientTool, useConversation, useConversationLog, useCopy, useDownloadUrl, useEvent, useFlash, useInbox, usePushToTalk, useRoute, useRouteMutation, useRunKey, useSession, useSessionActions, useSessionControls, useSessionError, useSessionId, useSessionSelector, useSessionStatus, useStoredValue, useTapToTalk, useTheme, useToolCallStart, useToolResult, useUserTranscript, useWorkflowProgress, useWorkflowRun, useWorkflowRuns, useWorkflowStream, useWorkflowSubmit, useWorkflows };

package/dist/internal.js

@@ -1,4 +1,4 @@
-import { r as loadClientConfig, t as buildAgentUrl } from "./client-config-C7fQrioM.js";
+import { r as loadClientConfig, t as buildAgentUrl } from "./client-config-CzvWmw4X.js";
 import { SessionProvider, ThemeProvider } from "./context.js";
 import { n as SessionUrlChips, r as UiUrlChip, t as ApiUrlChip } from "./url-chips-oyy_Eiqh.js";
 import { t as TRANSCRIBING_PLACEHOLDER } from "./use-user-transcript-uyHhzy4d.js";

package/dist/linked-client.d.ts

@@ -17,6 +17,7 @@
 /**
  * Options for {@link createLinkedClient}.
  *
+ * @input
  * @public
  */
 export type LinkedClientOptions = {
@@ -31,6 +32,7 @@ export type LinkedClientOptions = {
 /**
  * Which client a page is — see {@link createLinkedClient}.
  *
+ * @sealed
  * @public
  */
 export type LinkedClient = {

package/dist/{message-list-DHZcLhRA.js → message-list-BsaBkBgo.js}

@@ -152,15 +152,20 @@ function isThinking(state, messages, toolCalls) {
 *   const { items, streaming, transcript, thinking } = useConversation();
 *   return (
 *     <div>
-*       {items.map((item) =>
-*         item.kind === "message" ? (
-*           <p key={item.message.id} data-role={item.message.role}>
-*             {item.message.content}
-*           </p>
-*         ) : (
-*           <code key={item.toolCall.callId}>{item.toolCall.name}</code>
-*         ),
-*       )}
+*       {items.map((item) => {
+*         switch (item.kind) {
+*           case "message":
+*             return (
+*               <p key={item.message.id} data-role={item.message.role}>
+*                 {item.message.content}
+*               </p>
+*             );
+*           case "tool":
+*             return <code key={item.toolCall.callId}>{item.toolCall.name}</code>;
+*           default:
+*             return null;
+*         }
+*       })}
 *       {streaming !== null && <p data-role="assistant">{streaming}</p>}
 *       {transcript.speaking && <p data-role="user">{transcript.text}</p>}
 *       {thinking && <p>…</p>}
@@ -280,7 +285,13 @@ function ConversationView({ renderMessage, renderTool = defaultTool, renderStrea
 	const { items, streaming, transcript, thinking } = useConversation();
 	const liveItems = log ? void 0 : items;
 	const rows = useMemo(() => {
-		const renderItem = (item, key) => item.kind === "message" ? renderKeyed(`${key}m${item.message.id}`, renderMessage(item.message)) : renderKeyed(`${key}t${item.toolCall.callId}`, renderTool(item.toolCall));
+		const renderItem = (item, key) => {
+			switch (item.kind) {
+				case "message": return renderKeyed(`${key}m${item.message.id}`, renderMessage(item.message));
+				case "tool": return renderKeyed(`${key}t${item.toolCall.callId}`, renderTool(item.toolCall));
+				default: return null;
+			}
+		};
 		if (!log) return (liveItems ?? []).map((item) => renderItem(item, ""));
 		return logRows(log, renderItem, renderMessage, renderNote, renderSessionHeader);
 	}, [

package/dist/page.d.ts

@@ -27,6 +27,7 @@ import type { ClientTheme } from "./types.ts";
 /**
  * Configuration for {@link mountPage}.
  *
+ * @input
  * @public
  */
 export type PageConfig = {
@@ -55,6 +56,7 @@ export type PageConfig = {
 /**
  * Handle returned by {@link mountPage}. `Disposable`, so `using` works.
  *
+ * @sealed
  * @public
  */
 export type PageHandle = {

package/dist/phone.d.ts

@@ -12,6 +12,7 @@
 /**
  * Options for {@link phoneE164}.
  *
+ * @input
  * @public
  */
 export type PhoneE164Options = {

package/dist/route-fetch.d.ts

@@ -29,6 +29,7 @@ export type RouteMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
 /**
  * Options for {@link routeFetch}.
  *
+ * @input
  * @public
  */
 export type RouteFetchOptions = {

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

@@ -53,5 +53,5 @@ export type AudioPathCallbacks = {
  * up for a connection nobody wants any more is a live microphone, and no
  * amount of cancellation upstream releases the device.
  */
-export declare function openAudioPath(config: AudioPathConfig, callbacks: AudioPathCallbacks, preConnect?: Promise<PreConnectCapture | null> | null): Promise<VoiceIO>;
+export declare function openAudioPath(config: AudioPathConfig, callbacks: AudioPathCallbacks, preConnect?: Promise<PreConnectCapture | null> | null, signal?: AbortSignal): Promise<VoiceIO>;
 export {};

package/dist/session/audio-state.d.ts

@@ -32,14 +32,14 @@
  *   anywhere; as context of `down`/`starting` they are cleared by entering
  *   `down` rather than by three call sites remembering to.
  *
- * ## What cancellation does NOT do, and the one guard that had to survive
+ * ## Cancellation follows the microphone's ownership
  *
  * Stopping the `bringUp` actor hides its resolution; it does not close a
  * microphone the browser has already granted. So `bringUp` checks its own
- * `signal` after `openAudioPath` settles and releases what it built. That is
- * the single remaining "is this still wanted?" test, and it lives in the
- * producer — which owns the value nobody adopted — rather than at the four
- * consumer sites that used to re-ask.
+ * `signal` after `openAudioPath` settles and releases what it built. The same
+ * signal reaches the opening path and the transferred pre-connect capture,
+ * so cancellation before the lazy modules load prevents a permission request
+ * in the first place. Both checks live with the producer that owns the device.
  *
  * ## Effects stay in the session core
  *
@@ -63,7 +63,7 @@ export type AudioPathEffects = {
      * hand it a promise they resolve by hand, which is the only way to hold a
      * bring-up open across the events that abandon it.
      */
-    open(config: AudioPathConfig, callbacks: AudioPathCallbacks): Promise<VoiceIO>;
+    open(config: AudioPathConfig, callbacks: AudioPathCallbacks, signal: AbortSignal): Promise<VoiceIO>;
     /** Relay captured microphone audio to the server. */
     sendMicAudio(pcm16: ArrayBuffer): void;
     /**

package/dist/session/index.js

@@ -1,2 +1,2 @@
-import { a as ticketCarriage, i as resolveSessionTokenSync, n as CLEARED_SESSION_STATE, o as loadAudioModules, r as resolveSessionToken, t as createBrowserSession } from "../session-CYdjRvbl.js";
+import { a as ticketCarriage, i as resolveSessionTokenSync, n as CLEARED_SESSION_STATE, o as loadAudioModules, r as resolveSessionToken, t as createBrowserSession } from "../session-3lgPYNNO.js";
 export { CLEARED_SESSION_STATE, createBrowserSession, loadAudioModules, resolveSessionToken, resolveSessionTokenSync, ticketCarriage };

package/dist/session/messages.d.ts

@@ -7,15 +7,7 @@ import { type ConnState, type SessionSnapshot } from "./types.ts";
  * The empty arrays are safe to share: snapshot collections are never mutated
  * in place, only replaced.
  */
-export declare const CLEARED_SESSION_STATE: {
-    messages: never[];
-    toolCalls: never[];
-    customEvents: never[];
-    agentState: null;
-    userTranscript: null;
-    agentTranscript: null;
-    error: null;
-};
+export declare const CLEARED_SESSION_STATE: Readonly<Pick<SessionSnapshot, "messages" | "toolCalls" | "customEvents" | "agentState" | "userTranscript" | "agentTranscript" | "error">>;
 /** Config payload extracted from a `config` server message. */
 export type SessionConfigMessage = {
     sampleRate: number;

package/dist/session/preconnect.d.ts

@@ -40,7 +40,7 @@ export type PreConnectAudio = {
      */
     begin(): void;
     /** Hand the held capture to a bring-up, or `null` when none is held. */
-    take(): Promise<PreConnectCapture | null> | null;
+    take(signal?: AbortSignal): Promise<PreConnectCapture | null> | null;
     /** Release a held capture: the session is over or starting afresh. */
     release(): void;
 };

package/dist/session/types.d.ts

@@ -15,6 +15,7 @@ import type { AudioPath } from "./audio-state.ts";
  * Deliberately NOT the DOM `CustomEvent`: it shares nothing with that
  * interface, and the old name shadowed the global in `.tsx` files.
  *
+ * @sealed
  * @public
  */
 export type AgentCustomEvent = {
@@ -47,6 +48,7 @@ export type AgentStateFrame = Readonly<Record<string, unknown>>;
  * | `recording` | Is the microphone actually live right now? |
  * | `state` | What is the agent doing — see {@link AgentState}. |
  *
+ * @sealed
  * @public
  */
 export type SessionSnapshot = {
@@ -179,6 +181,7 @@ export declare const browserSessionBrand: unique symbol;
  * the session, so a feature one agent in many declares is not three members
  * every session carries in its autocomplete.
  *
+ * @sealed
  * @public
  */
 export type UserTurnControls = {
@@ -209,6 +212,7 @@ export type ToolCallOutcome = {
 /**
  * Options for {@link BrowserSession.sendText}.
  *
+ * @input
  * @public
  */
 export type SendTextOptions = {

package/dist/{session-CYdjRvbl.js → session-3lgPYNNO.js}

@@ -1,8 +1,8 @@
 import { n as pageBaseUrl } from "./_utils-Mi-SCFA1.js";
-import { r as loadClientConfig, t as buildAgentUrl } from "./client-config-C7fQrioM.js";
+import { r as loadClientConfig, t as buildAgentUrl } from "./client-config-CzvWmw4X.js";
 import { MIC_SEND_MAX_BUFFERED_BYTES } from "./types.js";
-import { SessionEventSchema, errorMessage, safeJsonParse } from "@alexkroman1/aai";
-import { SESSION_AUTH_PROTOCOL_PREFIX, SESSION_PROTOCOL, lenientParse } from "@alexkroman1/aai/protocol";
+import { errorMessage, safeJsonParse } from "@alexkroman1/aai";
+import { SESSION_AUTH_PROTOCOL_PREFIX, SESSION_PROTOCOL, SessionEventSchema, lenientParse } from "@alexkroman1/aai/protocol";
 import { CLIENT_ID_RE, MAX_CLIENT_MESSAGES, RESUME_ID_RE, WS_OPEN, createEpoch, toArgsRecord } from "@alexkroman1/aai/internal";
 import { omitUndefined } from "@alexkroman1/aai/utils";
 import { and, assign, createActor, fromPromise, not, setup, stateIn } from "xstate";
@@ -213,17 +213,19 @@ function loadAudioModules() {
 * up for a connection nobody wants any more is a live microphone, and no
 * amount of cancellation upstream releases the device.
 */
-async function openAudioPath(config, callbacks, preConnect) {
+async function openAudioPath(config, callbacks, preConnect, signal) {
 	const pre = await preConnect ?? void 0;
 	try {
-		return await openVoiceIO(config, callbacks, pre);
+		signal?.throwIfAborted();
+		return await openVoiceIO(config, callbacks, pre, signal);
 	} catch (err) {
 		pre?.close();
 		throw err;
 	}
 }
-async function openVoiceIO(config, callbacks, pre) {
+async function openVoiceIO(config, callbacks, pre, signal) {
 	const [{ createVoiceIO }, captureWorklet, playbackWorklet] = await loadAudioModules();
+	signal?.throwIfAborted();
 	return createVoiceIO({
 		preConnect: pre,
 		onPreConnectAudio: callbacks.onPreConnectAudio,
@@ -297,7 +299,7 @@ function createAudioEffects(deps) {
 		});
 	}
 	return {
-		open: (config, callbacks) => (deps.openAudioPath ?? openAudioPath)(config, callbacks, preConnect.take()),
+		open: (config, callbacks, signal) => (deps.openAudioPath ?? openAudioPath)(config, callbacks, preConnect.take(signal), signal),
 		sendMicAudio: (pcm16) => {
 			try {
 				mic.sendAudio(pcm16);
@@ -379,14 +381,14 @@ function createAudioEffects(deps) {
 *   anywhere; as context of `down`/`starting` they are cleared by entering
 *   `down` rather than by three call sites remembering to.
 *
-* ## What cancellation does NOT do, and the one guard that had to survive
+* ## Cancellation follows the microphone's ownership
 *
 * Stopping the `bringUp` actor hides its resolution; it does not close a
 * microphone the browser has already granted. So `bringUp` checks its own
-* `signal` after `openAudioPath` settles and releases what it built. That is
-* the single remaining "is this still wanted?" test, and it lives in the
-* producer — which owns the value nobody adopted — rather than at the four
-* consumer sites that used to re-ask.
+* `signal` after `openAudioPath` settles and releases what it built. The same
+* signal reaches the opening path and the transferred pre-connect capture,
+* so cancellation before the lazy modules load prevents a permission request
+* in the first place. Both checks live with the producer that owns the device.
 *
 * ## Effects stay in the session core
 *
@@ -438,7 +440,7 @@ bringUp: fromPromise(async ({ input, signal }) => {
 					message
 				});
 			}
-		});
+		}, signal);
 		if (signal.aborted) {
 			input.effects.release(io);
 			throw ABANDONED;
@@ -1651,10 +1653,19 @@ function createPreConnectAudio(enabled) {
 				maxSeconds: 10
 			})).catch(() => null);
 		},
-		take() {
+		take(signal) {
 			const taken = held;
+			const current = attempt;
 			held = null;
 			attempt = null;
+			if (taken && current && signal) {
+				const release = () => {
+					current.released = true;
+				};
+				if (signal.aborted) release();
+				else signal.addEventListener("abort", release, { once: true });
+				return taken.finally(() => signal.removeEventListener("abort", release));
+			}
 			return taken;
 		},
 		release() {

package/dist/stored-value.d.ts

@@ -19,6 +19,7 @@
 /**
  * Options for {@link createStoredValue}.
  *
+ * @input
  * @public
  */
 export type StoredValueOptions = {
@@ -30,6 +31,7 @@ export type StoredValueOptions = {
 /**
  * One remembered string — see {@link createStoredValue}.
  *
+ * @sealed
  * @public
  */
 export type StoredValue = {