@alexkroman1/aai-ui 0.12.2 → 0.13.0

package/dist/_components/transcript.js

@@ -1,35 +0,0 @@
-import { ThinkingIndicator } from "./thinking-indicator.js";
-import clsx from "clsx";
-import { jsx } from "preact/jsx-runtime";
-//#region _components/transcript.tsx
-/**
-* Live speech-to-text transcript shown while the user is speaking.
-* Returns `null` when there is no active utterance.
-*
-* Displays a {@link ThinkingIndicator} while waiting for the first
-* transcription text (i.e., `userUtterance` is `""`).
-*
-* @example
-* ```tsx
-* const { session } = useSession();
-* <Transcript userUtterance={session.userUtterance} />
-* ```
-*
-* @param userUtterance - Reactive string (`null` when idle, `""` when
-*   listening but no text yet, or the transcript text).
-* @param className - Additional CSS class names.
-*
-* @public
-*/
-function Transcript({ userUtterance, className }) {
-	if (userUtterance.value === null) return null;
-	return /* @__PURE__ */ jsx("div", {
-		class: clsx("flex flex-col items-end w-full", className),
-		children: /* @__PURE__ */ jsx("div", {
-			class: "max-w-[min(82%,64ch)] whitespace-pre-wrap wrap-break-word text-sm leading-[150%] text-aai-text-muted bg-aai-surface-faint border border-aai-border px-3 py-2 rounded-aai ml-auto",
-			children: userUtterance.value || /* @__PURE__ */ jsx(ThinkingIndicator, {})
-		})
-	});
-}
-//#endregion
-export { Transcript };

package/dist/audio.d.ts

@@ -1,45 +0,0 @@
-/** Configuration for creating a {@link VoiceIO} instance. */
-export type VoiceIOOptions = {
-    /** Sample rate in Hz expected by the STT engine (e.g. 16000). */
-    sttSampleRate: number;
-    /** Sample rate in Hz used by the TTS engine (e.g. 22050). */
-    ttsSampleRate: number;
-    /** Source URL or data URI for the capture AudioWorklet processor. */
-    captureWorkletSrc: string;
-    /** Source URL or data URI for the playback AudioWorklet processor. */
-    playbackWorkletSrc: string;
-    /** Callback invoked with buffered PCM16 microphone data to send to the server. */
-    onMicData: (pcm16: ArrayBuffer) => void;
-    /** Callback invoked with the current playback position in samples. */
-    onPlaybackProgress?: (samplesPlayed: number) => void;
-};
-/**
- * Audio I/O interface for voice capture and playback.
- *
- * Manages microphone capture via an AudioWorklet, resampling to the STT
- * sample rate, and TTS audio playback through a second AudioWorklet. Implements
- * {@link AsyncDisposable} for resource cleanup.
- */
-export type VoiceIO = AsyncDisposable & {
-    /** Enqueue a PCM16 audio buffer for playback through the TTS pipeline. */
-    enqueue(pcm16Buffer: ArrayBuffer): void;
-    /** Signal that all TTS audio for the current turn has been enqueued.
-     *  Resolves when the worklet has finished playing all buffered audio. */
-    done(): Promise<void>;
-    /** Immediately stop playback and discard any buffered TTS audio. */
-    flush(): void;
-    /** Release all audio resources (microphone, AudioContext, worklets). */
-    close(): Promise<void>;
-};
-/**
- * Create a {@link VoiceIO} instance that captures microphone audio and
- * plays back TTS audio using the Web Audio API.
- *
- * The AudioContext runs at the TTS sample rate for playback fidelity.
- * Captured audio is resampled to the STT rate when the rates differ.
- *
- * @param opts - Voice I/O configuration options.
- * @returns A promise that resolves to a {@link VoiceIO} handle.
- * @throws If microphone access is denied or AudioWorklet registration fails.
- */
-export declare function createVoiceIO(opts: VoiceIOOptions): Promise<VoiceIO>;

package/dist/audio.js

@@ -1,121 +0,0 @@
-import { MIC_BUFFER_SECONDS } from "./types.js";
-//#region audio.ts
-/**
-* Create a {@link VoiceIO} instance that captures microphone audio and
-* plays back TTS audio using the Web Audio API.
-*
-* The AudioContext runs at the TTS sample rate for playback fidelity.
-* Captured audio is resampled to the STT rate when the rates differ.
-*
-* @param opts - Voice I/O configuration options.
-* @returns A promise that resolves to a {@link VoiceIO} handle.
-* @throws If microphone access is denied or AudioWorklet registration fails.
-*/
-async function createVoiceIO(opts) {
-	const { sttSampleRate, ttsSampleRate, captureWorkletSrc, playbackWorkletSrc, onMicData } = opts;
-	const contextRate = ttsSampleRate;
-	const ctx = new AudioContext({
-		sampleRate: contextRate,
-		latencyHint: "playback"
-	});
-	await ctx.resume();
-	const stream = await navigator.mediaDevices.getUserMedia({ audio: {
-		sampleRate: contextRate,
-		echoCancellation: true,
-		noiseSuppression: true,
-		autoGainControl: true
-	} });
-	try {
-		await Promise.all([ctx.audioWorklet.addModule(captureWorkletSrc), ctx.audioWorklet.addModule(playbackWorkletSrc)]);
-	} catch (err) {
-		for (const t of stream.getTracks()) t.stop();
-		await ctx.close().catch((err) => {
-			console.warn("AudioContext close failed:", err);
-		});
-		throw err;
-	}
-	const mic = ctx.createMediaStreamSource(stream);
-	const capNode = new AudioWorkletNode(ctx, "capture-processor", {
-		channelCount: 1,
-		channelCountMode: "explicit",
-		processorOptions: {
-			contextRate,
-			sttSampleRate
-		}
-	});
-	mic.connect(capNode);
-	const chunkSizeBytes = Math.floor(sttSampleRate * MIC_BUFFER_SECONDS) * 2;
-	const capBufA = new Uint8Array(chunkSizeBytes * 2);
-	const capBufB = new Uint8Array(chunkSizeBytes * 2);
-	let capBuf = capBufA;
-	let capOffset = 0;
-	capNode.port.postMessage({ event: "start" });
-	capNode.port.onmessage = (e) => {
-		if (e.data.event !== "chunk") return;
-		const chunk = new Uint8Array(e.data.buffer);
-		capBuf.set(chunk, capOffset);
-		capOffset += chunk.byteLength;
-		if (capOffset >= chunkSizeBytes) {
-			const sendBuf = capBuf;
-			const filled = capOffset;
-			capBuf = capBuf === capBufA ? capBufB : capBufA;
-			capOffset = 0;
-			onMicData(sendBuf.buffer.slice(0, filled));
-		}
-	};
-	let playNode = null;
-	let onPlaybackStop = null;
-	const lifecycle = new AbortController();
-	const { onPlaybackProgress } = opts;
-	function ensurePlayNode() {
-		if (playNode) return playNode;
-		const node = new AudioWorkletNode(ctx, "playback-processor", { processorOptions: { sampleRate: contextRate } });
-		node.connect(ctx.destination);
-		node.port.onmessage = (e) => {
-			if (e.data.event === "stop") {
-				node.disconnect();
-				if (playNode === node) playNode = null;
-				onPlaybackStop?.();
-				onPlaybackStop = null;
-			} else if (e.data.event === "progress") onPlaybackProgress?.(e.data.readPos);
-		};
-		playNode = node;
-		return node;
-	}
-	const io = {
-		enqueue(pcm16Buffer) {
-			if (lifecycle.signal.aborted) return;
-			if (pcm16Buffer.byteLength === 0) return;
-			ensurePlayNode().port.postMessage({
-				event: "write",
-				buffer: new Uint8Array(pcm16Buffer)
-			}, [pcm16Buffer]);
-		},
-		done() {
-			if (!playNode) return Promise.resolve();
-			return new Promise((resolve) => {
-				onPlaybackStop = resolve;
-				playNode?.port.postMessage({ event: "done" });
-			});
-		},
-		flush() {
-			if (playNode) playNode.port.postMessage({ event: "interrupt" });
-		},
-		async close() {
-			if (lifecycle.signal.aborted) return;
-			lifecycle.abort();
-			capNode.port.postMessage({ event: "stop" });
-			mic.disconnect();
-			capNode.disconnect();
-			if (playNode) playNode.disconnect();
-			for (const t of stream.getTracks()) t.stop();
-			await ctx.close().catch(() => {});
-		},
-		async [Symbol.asyncDispose]() {
-			await io.close();
-		}
-	};
-	return io;
-}
-//#endregion
-export { createVoiceIO };

package/dist/client-context.d.ts

@@ -1,33 +0,0 @@
-/**
- * Theme overrides for the default UI. Applied as CSS custom properties.
- *
- * @public
- */
-export type ClientTheme = {
-    /** Background color. Default: `#101010`. */
-    bg?: string;
-    /** Primary accent color. Default: `#fab283`. */
-    primary?: string;
-    /** Main text color. */
-    text?: string;
-    /** Surface/card color. */
-    surface?: string;
-    /** Border color. */
-    border?: string;
-};
-/**
- * Resolved client-level configuration available to default UI components.
- *
- * @public
- */
-export type ClientConfig = {
-    title?: string | undefined;
-    theme?: ClientTheme | undefined;
-};
-export declare const ClientConfigProvider: import("preact").Provider<ClientConfig>;
-/**
- * Read client config (title, theme) from the nearest provider.
- *
- * @public
- */
-export declare function useClientConfig(): ClientConfig;

package/dist/client-context.js

@@ -1,15 +0,0 @@
-import { createContext } from "preact";
-import { useContext } from "preact/hooks";
-//#region client-context.ts
-const Ctx = createContext({});
-const ClientConfigProvider = Ctx.Provider;
-/**
-* Read client config (title, theme) from the nearest provider.
-*
-* @public
-*/
-function useClientConfig() {
-	return useContext(Ctx);
-}
-//#endregion
-export { ClientConfigProvider, useClientConfig };

package/dist/client-handler.d.ts

@@ -1,43 +0,0 @@
-import type { ReadyConfig } from "@alexkroman1/aai/protocol";
-import type { VoiceIO } from "./audio.ts";
-import type { AgentState, ChatMessage, Reactive, SessionError, ToolCallInfo } from "./types.ts";
-type BatchFn = (fn: () => void) => void;
-/**
- * Handles server→client messages and updates reactive Preact signals
- * accordingly (state transitions, transcripts, messages, audio playback).
- *
- * @internal Exported for testing only.
- */
-export declare class ClientHandler {
-    #private;
-    constructor(opts: {
-        state: Reactive<AgentState>;
-        messages: Reactive<ChatMessage[]>;
-        toolCalls: Reactive<ToolCallInfo[]>;
-        userUtterance: Reactive<string | null>;
-        agentUtterance: Reactive<string | null>;
-        error: Reactive<SessionError | null>;
-        voiceIO: () => VoiceIO | null;
-        batch: BatchFn;
-    });
-    /** Single entry point for all server→client session events. */
-    event(e: import("@alexkroman1/aai/protocol").ClientEvent): void;
-    /** Enqueue a PCM16 audio chunk for playback. Transitions state to `"speaking"` on the first chunk. */
-    playAudioChunk(chunk: Uint8Array): void;
-    /**
-     * Signal that the server has finished sending audio for this turn.
-     * Waits for the audio queue to drain, then transitions state to `"listening"`.
-     * Uses the `#generation` counter to discard stale completions from interrupted turns.
-     */
-    playAudioDone(): void;
-    /**
-     * Dispatch an incoming WebSocket message (text or binary).
-     *
-     * Returns the parsed config if the message is a `config` message,
-     * otherwise `null`.
-     */
-    handleMessage(data: string | ArrayBuffer): (ReadyConfig & {
-        sessionId?: string;
-    }) | null;
-}
-export {};