@alexkroman1/aai-ui 5.2.0 → 5.4.0

package/dist/types.d.ts

@@ -21,6 +21,9 @@ export { CAPTURE_STOP_ACK_TIMEOUT_MS, MIC_BUFFER_SECONDS, MIC_SEND_MAX_BUFFERED_
  *
  * Cast because `voiceIsolation` is newer than TypeScript's DOM lib.
  *
+ * Public so a custom client that opens its own microphone gets the same
+ * signal the built-in capture paths do.
+ *
  * @public
  */
 export declare const VOICE_CAPTURE_CONSTRAINTS: MediaTrackConstraints;
@@ -33,6 +36,11 @@ export type AgentState = "disconnected" | "connecting" | "ready" | "listening" |
 /**
  * A chat message exchanged between user and assistant.
  *
+ * `role` is `"user" | "assistant"` only — unlike the SDK's `Message`, there
+ * is no `"tool"` role here. Tool activity never arrives as messages: it is
+ * surfaced via `SessionSnapshot.toolCalls` (or `useEvent` for `ctx.send`
+ * events).
+ *
  * @public
  */
 export type ChatMessage = {
@@ -86,6 +94,10 @@ export type ToolCallInfo = {
      */
     afterMessageId: number;
 };
+/**
+ * Re-exported from `@alexkroman1/aai/protocol` (the canonical definition)
+ * so client code needs only this package.
+ */
 export type { SessionErrorCode } from "@alexkroman1/aai/protocol";
 /**
  * Error reported by the voice session.
@@ -99,7 +111,10 @@ export type SessionError = {
     readonly message: string;
 };
 /**
- * Options for creating a voice session.
+ * Options for creating a voice session — the shared field set accepted by
+ * both `client()` and `createSessionCore`. The one difference: `client()`
+ * defaults `platformUrl` from `location.href`, while `createSessionCore`
+ * requires it.
  *
  * @public
  */
@@ -118,9 +133,10 @@ export type VoiceSessionOptions = {
      */
     onSessionId?: ((sessionId: string) => void) | undefined;
     /**
-     * Session ID from a previous connection. When set, the server will
-     * attempt to restore persisted session state (if the agent has
-     * `persistence` enabled). Sensitive — see {@link onSessionId}.
+     * Session ID from a previous connection. When set, the server resumes
+     * that session if its per-session state is still within the resume grace
+     * window (`SESSION_RESUME_GRACE_MS`), replaying history into the new
+     * connection. Sensitive — see {@link onSessionId}.
      */
     resumeSessionId?: string | undefined;
     /**
@@ -151,10 +167,10 @@ export type ClientTheme = {
     bg?: string;
     /** Primary accent color. Default: `#3F2BC1`. */
     primary?: string;
-    /** Main text color. */
+    /** Main text color. Default: `#1B1A18`. */
     text?: string;
-    /** Surface/card color. */
+    /** Surface/card color. Default: `#FFFFFF`. */
     surface?: string;
-    /** Border color. */
+    /** Border color. Default: `#DCD7CC`. */
     border?: string;
 };

package/dist/types.js

@@ -20,6 +20,9 @@ import { CAPTURE_STOP_ACK_TIMEOUT_MS, MIC_BUFFER_SECONDS, MIC_SEND_MAX_BUFFERED_
 *
 * Cast because `voiceIsolation` is newer than TypeScript's DOM lib.
 *
+* Public so a custom client that opens its own microphone gets the same
+* signal the built-in capture paths do.
+*
 * @public
 */
 const VOICE_CAPTURE_CONSTRAINTS = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alexkroman1/aai-ui",
-  "version": "5.2.0",
+  "version": "5.4.0",
   "type": "module",
   "files": [
     "dist",
@@ -22,7 +22,7 @@
     "react-markdown": "^10.1.0",
     "remark-gfm": "^4.0.1",
     "use-sync-external-store": "^1.6.0",
-    "@alexkroman1/aai": "5.2.0"
+    "@alexkroman1/aai": "5.4.0"
   },
   "peerDependencies": {
     "react": "^19.0.0",