@alexkroman1/aai-ui 1.0.6 → 1.2.0

package/dist/default-client/{default-client.html → index.html}

@@ -6,8 +6,8 @@
     <title>aai</title>
     <link rel="icon" href="data:," />
     <style>html, body { background: #101010; margin: 0; }</style>
-    <script type="module" crossorigin src="./assets/default-client-AeJhjHfj.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/default-client-BK1ItCvw.css">
+    <script type="module" crossorigin src="./assets/index-D6dL8nYr.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-BZqVGR2o.css">
   </head>
   <body>
     <main id="app"></main>

package/dist/define-client.js

@@ -1,5 +1,5 @@
 import { SessionProvider, ThemeProvider } from "./context.js";
-import { n as ToolConfigContext } from "./tool-call-block-CCuChsFm.js";
+import { n as ToolConfigContext } from "./tool-call-block-wby_jyoY.js";
 import { ChatView } from "./components/chat-view.js";
 import { SidebarLayout } from "./components/sidebar-layout.js";
 import { StartScreen } from "./components/start-screen.js";

package/dist/hooks.d.ts

@@ -1,5 +1,6 @@
 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;
+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

@@ -40,6 +40,24 @@ function useToolResult(...args) {
 		});
 	}, [session.toolCalls, filterName]);
 }
+function useEvent(event, callback) {
+	const session = useSession();
+	const seenRef = useRef(/* @__PURE__ */ new Set());
+	const callbackRef = useRef(callback);
+	callbackRef.current = callback;
+	useEffect(() => {
+		if (session.customEvents.length === 0) {
+			seenRef.current.clear();
+			return;
+		}
+		for (const ce of session.customEvents) {
+			if (ce.event !== event) continue;
+			if (seenRef.current.has(ce.id)) continue;
+			seenRef.current.add(ce.id);
+			callbackRef.current(ce.data);
+		}
+	}, [session.customEvents, event]);
+}
 function useToolCallStart(...args) {
 	const filterName = typeof args[0] === "string" ? args[0] : null;
 	const callback = typeof args[0] === "string" ? args[1] : args[0];
@@ -52,4 +70,4 @@ function useToolCallStart(...args) {
 	}, [session.toolCalls, filterName]);
 }
 //#endregion
-export { useToolCallStart, useToolResult };
+export { useEvent, useToolCallStart, useToolResult };

package/dist/index.d.ts

@@ -9,7 +9,7 @@ export type { Session } from "./context.ts";
 export { SessionProvider, ThemeProvider, useSession, useTheme } from "./context.ts";
 export type { ClientConfig, ClientHandle, } from "./define-client.tsx";
 export { client } from "./define-client.tsx";
-export { useToolCallStart, useToolResult } from "./hooks.ts";
-export type { SessionCore, SessionCoreOptions, SessionSnapshot, } from "./session-core.ts";
+export { useEvent, useToolCallStart, useToolResult } from "./hooks.ts";
+export type { CustomEvent, SessionCore, SessionCoreOptions, SessionSnapshot, } from "./session-core.ts";
 export { createSessionCore } from "./session-core.ts";
 export type { AgentState, ChatMessage, ClientTheme, SessionError, SessionErrorCode, ToolCallInfo, VoiceSessionOptions, WebSocketConstructor, } from "./types.ts";

package/dist/index.js

@@ -1,11 +1,11 @@
 import { SessionProvider, ThemeProvider, useSession, useTheme } from "./context.js";
 import { Button } from "./components/button.js";
-import { n as ToolConfigContext } from "./tool-call-block-CCuChsFm.js";
+import { n as ToolConfigContext } from "./tool-call-block-wby_jyoY.js";
 import { MessageList } from "./components/message-list.js";
 import { ChatView } from "./components/chat-view.js";
 import { SidebarLayout } from "./components/sidebar-layout.js";
 import { StartScreen } from "./components/start-screen.js";
 import { createSessionCore } from "./session-core.js";
 import { client } from "./define-client.js";
-import { useToolCallStart, useToolResult } from "./hooks.js";
-export { Button, ChatView, MessageList, SessionProvider, SidebarLayout, StartScreen, ThemeProvider, ToolConfigContext, client, createSessionCore, useSession, useTheme, useToolCallStart, useToolResult };
+import { useEvent, useToolCallStart, useToolResult } from "./hooks.js";
+export { Button, ChatView, MessageList, SessionProvider, SidebarLayout, StartScreen, ThemeProvider, ToolConfigContext, client, createSessionCore, useEvent, useSession, useTheme, useToolCallStart, useToolResult };

package/dist/session-core.d.ts

@@ -1,5 +1,15 @@
 import type { AgentState, ChatMessage, SessionError, ToolCallInfo, VoiceSessionOptions } from "./types.ts";
 export type { AgentState, ChatMessage, SessionError, SessionErrorCode, ToolCallInfo, VoiceSessionOptions, WebSocketConstructor, } from "./types.ts";
+/**
+ * A custom event emitted by the agent via `ctx.send`.
+ *
+ * @public
+ */
+export type CustomEvent = {
+    readonly id: number;
+    readonly event: string;
+    readonly data: unknown;
+};
 /**
  * Immutable snapshot of the session state.
  *
@@ -12,6 +22,7 @@ export type SessionSnapshot = {
     readonly state: AgentState;
     readonly messages: ChatMessage[];
     readonly toolCalls: ToolCallInfo[];
+    readonly customEvents: CustomEvent[];
     readonly userTranscript: string | null;
     readonly agentTranscript: string | null;
     readonly error: SessionError | null;

package/dist/session-core.js

@@ -93,6 +93,7 @@ function createSessionCore(options) {
 		state: "disconnected",
 		messages: [],
 		toolCalls: [],
+		customEvents: [],
 		userTranscript: null,
 		agentTranscript: null,
 		error: null,
@@ -136,6 +137,7 @@ function createSessionCore(options) {
 		updateState({
 			messages: [],
 			toolCalls: [],
+			customEvents: [],
 			userTranscript: null,
 			agentTranscript: null,
 			error: null
@@ -154,6 +156,8 @@ function createSessionCore(options) {
 	};
 	/** Incremented on each turn boundary -- stale async callbacks compare against this. */
 	let handlerGeneration = 0;
+	/** Monotonically increasing counter for custom events -- used by useEvent to deduplicate. */
+	let customEventSeq = 0;
 	function handleUserTranscriptEvent(text) {
 		handlerGeneration++;
 		updateState({
@@ -233,12 +237,20 @@ function createSessionCore(options) {
 				updateState({
 					messages: [],
 					toolCalls: [],
+					customEvents: [],
 					userTranscript: null,
 					agentTranscript: null,
 					error: null,
 					state: "listening"
 				});
 				break;
+			case "custom_event":
+				updateState({ customEvents: [...currentSnapshot.customEvents, {
+					id: ++customEventSeq,
+					event: e.event,
+					data: e.data
+				}] });
+				break;
 			case "error":
 				console.error("Agent error:", e.message);
 				updateState({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alexkroman1/aai-ui",
-  "version": "1.0.6",
+  "version": "1.2.0",
   "type": "module",
   "files": [
     "dist",
@@ -18,7 +18,7 @@
   },
   "dependencies": {
     "clsx": "^2.1.1",
-    "@alexkroman1/aai": "1.0.6"
+    "@alexkroman1/aai": "1.2.0"
   },
   "peerDependencies": {
     "react": "^19.0.0",