@fishaudio/agent-react 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fish Audio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,48 @@
+# @fishaudio/agent-react
+
+React hooks and components for [Fish Audio](https://fish.audio) voice agents, built on [`@fishaudio/agent-client`](https://github.com/fishaudio/fish-agent-sdk-web/tree/main/packages/client).
+
+## Installation
+
+```bash
+npm install @fishaudio/agent-react
+```
+
+Requires React 18+.
+
+## Quickstart
+
+```tsx
+"use client";
+
+import { useConversation } from "@fishaudio/agent-react";
+
+export function VoiceWidget() {
+  const conversation = useConversation();
+
+  const start = async () => {
+    const sessionToken = await fetch("/api/voice-session", { method: "POST" }).then((r) => r.json());
+    await conversation.startSession({ sessionToken });
+  };
+
+  return conversation.status === "connected" ? (
+    <button onClick={() => conversation.endSession()}>
+      End call{conversation.isSpeaking ? " · speaking" : ""}
+    </button>
+  ) : (
+    <button onClick={start}>Start call</button>
+  );
+}
+```
+
+The hook ends the session automatically when the component unmounts. Start calls made from the required user interaction path are safe under React StrictMode's effect replay.
+
+## Documentation
+
+- [React overview](https://github.com/fishaudio/fish-agent-sdk-web/blob/main/docs/react/README.md) — quickstart, Next.js.
+- [`useConversation`](https://github.com/fishaudio/fish-agent-sdk-web/blob/main/docs/react/useConversation.md) — session lifecycle as a hook.
+- [Provider](https://github.com/fishaudio/fish-agent-sdk-web/blob/main/docs/react/provider.md) — share one conversation across a component tree.
+- [`useAgentMessages`](https://github.com/fishaudio/fish-agent-sdk-web/blob/main/docs/react/useAgentMessages.md) — build a streaming chat UI.
+- [Audio visualization](https://github.com/fishaudio/fish-agent-sdk-web/blob/main/docs/react/audio-visualization.md) — `useAudioLevels` and `<AgentAudioVisualizer />`.
+
+Authentication, events, client tools, and errors are documented with the [client SDK](https://github.com/fishaudio/fish-agent-sdk-web/blob/main/docs/README.md) — everything there applies here.

package/dist/index.cjs

@@ -0,0 +1,389 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  AgentAudioVisualizer: () => AgentAudioVisualizer,
+  AgentSession: () => import_agent_client2.AgentSession,
+  AgentSessionProvider: () => AgentSessionProvider,
+  FishAgentError: () => import_agent_client2.FishAgentError,
+  useAgentMessages: () => useAgentMessages,
+  useAgentSessionContext: () => useAgentSessionContext,
+  useAudioLevels: () => useAudioLevels,
+  useConversation: () => useConversation,
+  useOptionalAgentSessionContext: () => useOptionalAgentSessionContext
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/useConversation.ts
+var import_agent_client = require("@fishaudio/agent-client");
+var import_react = require("react");
+function startCancelledError() {
+  const error = new Error("Conversation start was cancelled by endSession");
+  error.name = "AbortError";
+  return error;
+}
+function useConversation(defaults = {}) {
+  const defaultsRef = (0, import_react.useRef)(defaults);
+  defaultsRef.current = defaults;
+  const sessionRef = (0, import_react.useRef)(null);
+  const startingRef = (0, import_react.useRef)(null);
+  const abandonedSessionRef = (0, import_react.useRef)(null);
+  const lifecycleEpochRef = (0, import_react.useRef)(0);
+  const mountedRef = (0, import_react.useRef)(true);
+  const [session, setSession] = (0, import_react.useState)(null);
+  const [status, setStatus] = (0, import_react.useState)("idle");
+  const [mode, setMode] = (0, import_react.useState)("listening");
+  const [micMuted, setMicMutedState] = (0, import_react.useState)(false);
+  const releaseAbandonedSession = (0, import_react.useCallback)(async () => {
+    const abandoned = abandonedSessionRef.current;
+    if (!abandoned) {
+      return;
+    }
+    await abandoned.end();
+    if (abandonedSessionRef.current === abandoned) {
+      abandonedSessionRef.current = null;
+    }
+  }, []);
+  const startSession = (0, import_react.useCallback)(
+    async (overrides = {}) => {
+      const requestEpoch = lifecycleEpochRef.current;
+      const startAtEpoch = async () => {
+        if (!mountedRef.current) {
+          throw new Error("Cannot start a conversation after useConversation has unmounted");
+        }
+        if (requestEpoch !== lifecycleEpochRef.current) {
+          throw startCancelledError();
+        }
+        if (abandonedSessionRef.current) {
+          await releaseAbandonedSession();
+          if (requestEpoch !== lifecycleEpochRef.current) {
+            throw startCancelledError();
+          }
+        }
+        const current = sessionRef.current;
+        if (current) {
+          if (current.status !== "ended") {
+            return current.sessionId;
+          }
+          await current.end();
+          if (requestEpoch !== lifecycleEpochRef.current) {
+            throw startCancelledError();
+          }
+        }
+        const existing = startingRef.current;
+        if (existing) {
+          if (!existing.state.cancelled) {
+            return existing.promise;
+          }
+          try {
+            await existing.promise;
+          } catch (error) {
+            if (existing.state.sessionCreated) {
+              throw error;
+            }
+          }
+          if (requestEpoch !== lifecycleEpochRef.current) {
+            throw startCancelledError();
+          }
+          return startAtEpoch();
+        }
+        setStatus("connecting");
+        const state = { cancelled: false, sessionCreated: false };
+        const starting = (async () => {
+          try {
+            const next = await import_agent_client.AgentSession.start({
+              ...defaultsRef.current,
+              ...overrides
+            });
+            state.sessionCreated = true;
+            if (state.cancelled || requestEpoch !== lifecycleEpochRef.current || !mountedRef.current) {
+              try {
+                await next.end();
+              } catch (error) {
+                abandonedSessionRef.current = next;
+                if (!mountedRef.current) {
+                  void releaseAbandonedSession().catch(() => void 0);
+                }
+                throw error;
+              }
+              return next.sessionId;
+            }
+            sessionRef.current = next;
+            setSession(next);
+            setMicMutedState(next.micMuted);
+            setMode(next.mode);
+            setStatus(next.status);
+            next.on("statusChange", setStatus);
+            next.on("modeChange", setMode);
+            return next.sessionId;
+          } catch (error) {
+            if (!state.cancelled && mountedRef.current) {
+              setStatus("idle");
+            }
+            throw error;
+          } finally {
+            if (startingRef.current?.state === state) {
+              startingRef.current = null;
+            }
+          }
+        })();
+        const pending = { state, promise: starting };
+        startingRef.current = pending;
+        return starting;
+      };
+      return startAtEpoch();
+    },
+    [releaseAbandonedSession]
+  );
+  const endSession = (0, import_react.useCallback)(async () => {
+    lifecycleEpochRef.current += 1;
+    const pending = startingRef.current;
+    const current = sessionRef.current;
+    const abandoned = abandonedSessionRef.current;
+    if (!pending && !abandoned && !current) {
+      return;
+    }
+    if (pending) {
+      pending.state.cancelled = true;
+      if (mountedRef.current) {
+        setStatus("ended");
+      }
+    }
+    await current?.end();
+    if (abandoned) {
+      await releaseAbandonedSession();
+    }
+    if (pending) {
+      try {
+        await pending.promise;
+      } catch (error) {
+        if (pending.state.sessionCreated) {
+          throw error;
+        }
+      }
+    }
+  }, [releaseAbandonedSession]);
+  const setMicMuted = (0, import_react.useCallback)(async (muted) => {
+    await sessionRef.current?.setMicMuted(muted);
+    setMicMutedState(muted);
+  }, []);
+  (0, import_react.useEffect)(() => {
+    mountedRef.current = true;
+    return () => {
+      mountedRef.current = false;
+      lifecycleEpochRef.current += 1;
+      const pending = startingRef.current;
+      if (pending) {
+        pending.state.cancelled = true;
+      }
+      const current = sessionRef.current;
+      if (current) {
+        current.off("statusChange", setStatus);
+        current.off("modeChange", setMode);
+        void current.end().catch(() => void 0);
+      }
+      void releaseAbandonedSession().catch(() => void 0);
+    };
+  }, [releaseAbandonedSession]);
+  return {
+    session,
+    status,
+    mode,
+    isSpeaking: mode === "speaking",
+    micMuted,
+    startSession,
+    endSession,
+    setMicMuted,
+    sendUserMessage: (0, import_react.useCallback)(
+      (text, options) => sessionRef.current?.sendUserMessage(text, options),
+      []
+    ),
+    sendUserActivity: (0, import_react.useCallback)(() => sessionRef.current?.sendUserActivity(), []),
+    interrupt: (0, import_react.useCallback)(() => sessionRef.current?.interrupt(), []),
+    startAudio: (0, import_react.useCallback)(async () => sessionRef.current?.startAudio(), []),
+    setOutputVolume: (0, import_react.useCallback)(
+      (volume) => sessionRef.current?.setOutputVolume(volume),
+      []
+    ),
+    setInputDevice: (0, import_react.useCallback)(
+      async (deviceId) => sessionRef.current?.setInputDevice(deviceId),
+      []
+    ),
+    setOutputDevice: (0, import_react.useCallback)(
+      async (deviceId) => sessionRef.current?.setOutputDevice(deviceId),
+      []
+    )
+  };
+}
+
+// src/provider.tsx
+var import_react2 = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var ConversationContext = (0, import_react2.createContext)(null);
+function AgentSessionProvider({
+  options,
+  children
+}) {
+  const conversation = useConversation(options ?? {});
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(ConversationContext.Provider, { value: conversation, children });
+}
+function useAgentSessionContext() {
+  const context = (0, import_react2.useContext)(ConversationContext);
+  if (!context) {
+    throw new Error("useAgentSessionContext must be used within <AgentSessionProvider>");
+  }
+  return context;
+}
+function useOptionalAgentSessionContext() {
+  return (0, import_react2.useContext)(ConversationContext);
+}
+
+// src/useAgentMessages.ts
+var import_react3 = require("react");
+function useAgentMessages(session) {
+  const context = useOptionalAgentSessionContext();
+  const active = session !== void 0 ? session : context?.session ?? null;
+  const [messages, setMessages] = (0, import_react3.useState)([]);
+  (0, import_react3.useEffect)(() => {
+    if (!active) {
+      return;
+    }
+    setMessages(
+      active.getTranscript().map((segment) => ({
+        key: `${segment.role}-${segment.segmentId}`,
+        role: segment.role,
+        text: segment.text,
+        final: segment.final
+      }))
+    );
+    const upsert = (key, role, text, final) => {
+      setMessages((previous) => {
+        const index = previous.findIndex((message) => message.key === key);
+        const entry = { key, role, text, final };
+        if (index === -1) {
+          return [...previous, entry];
+        }
+        const next = [...previous];
+        next[index] = entry;
+        return next;
+      });
+    };
+    const onUserTranscript = (event) => upsert(`user-${event.segmentId}`, "user", event.text, event.final);
+    const onAgentDelta = (event) => upsert(`agent-${event.segmentId}`, "agent", event.text, false);
+    const onAgentResponse = (event) => upsert(`agent-${event.segmentId}`, "agent", event.text, true);
+    active.on("userTranscript", onUserTranscript);
+    active.on("agentResponseDelta", onAgentDelta);
+    active.on("agentResponse", onAgentResponse);
+    return () => {
+      active.off("userTranscript", onUserTranscript);
+      active.off("agentResponseDelta", onAgentDelta);
+      active.off("agentResponse", onAgentResponse);
+    };
+  }, [active]);
+  return messages;
+}
+
+// src/useAudioLevels.ts
+var import_react4 = require("react");
+function useAudioLevels(session, fps = 20) {
+  const context = useOptionalAgentSessionContext();
+  const active = session !== void 0 ? session : context?.session ?? null;
+  const [levels, setLevels] = (0, import_react4.useState)({ input: 0, output: 0 });
+  (0, import_react4.useEffect)(() => {
+    if (!active) {
+      return;
+    }
+    const timer = setInterval(
+      () => {
+        setLevels({ input: active.getInputVolume(), output: active.getOutputVolume() });
+      },
+      Math.max(1e3 / fps, 16)
+    );
+    return () => {
+      clearInterval(timer);
+    };
+  }, [active, fps]);
+  return levels;
+}
+
+// src/AgentAudioVisualizer.tsx
+var import_react5 = require("react");
+var import_jsx_runtime2 = require("react/jsx-runtime");
+function AgentAudioVisualizer({
+  session,
+  bars = 24,
+  width = 240,
+  height = 64,
+  className
+}) {
+  const context = useOptionalAgentSessionContext();
+  const active = session !== void 0 ? session : context?.session ?? null;
+  const canvasRef = (0, import_react5.useRef)(null);
+  (0, import_react5.useEffect)(() => {
+    const canvas = canvasRef.current;
+    if (!canvas || !active) {
+      return;
+    }
+    const context2d = canvas.getContext("2d");
+    if (!context2d) {
+      return;
+    }
+    let frame = 0;
+    const draw = () => {
+      const data = active.getOutputFrequencyData();
+      context2d.clearRect(0, 0, canvas.width, canvas.height);
+      context2d.fillStyle = getComputedStyle(canvas).color;
+      const barWidth = canvas.width / bars;
+      for (let index = 0; index < bars; index += 1) {
+        const sample = data.length ? (data[Math.floor(index / bars * data.length)] ?? 0) / 255 : 0;
+        const barHeight = Math.max(2, sample * canvas.height);
+        context2d.fillRect(
+          index * barWidth + barWidth * 0.15,
+          (canvas.height - barHeight) / 2,
+          barWidth * 0.7,
+          barHeight
+        );
+      }
+      frame = requestAnimationFrame(draw);
+    };
+    frame = requestAnimationFrame(draw);
+    return () => {
+      cancelAnimationFrame(frame);
+    };
+  }, [active, bars]);
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("canvas", { ref: canvasRef, width, height, className });
+}
+
+// src/index.ts
+var import_agent_client2 = require("@fishaudio/agent-client");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AgentAudioVisualizer,
+  AgentSession,
+  AgentSessionProvider,
+  FishAgentError,
+  useAgentMessages,
+  useAgentSessionContext,
+  useAudioLevels,
+  useConversation,
+  useOptionalAgentSessionContext
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/useConversation.ts","../src/provider.tsx","../src/useAgentMessages.ts","../src/useAudioLevels.ts","../src/AgentAudioVisualizer.tsx"],"sourcesContent":["export { useConversation, type ConversationStatus, type UseConversationReturn } from \"./useConversation.js\";\nexport {\n  AgentSessionProvider,\n  useAgentSessionContext,\n  useOptionalAgentSessionContext,\n  type AgentSessionProviderProps,\n} from \"./provider.js\";\nexport { useAgentMessages, type ChatMessage } from \"./useAgentMessages.js\";\nexport { useAudioLevels, type AudioLevels } from \"./useAudioLevels.js\";\nexport {\n  AgentAudioVisualizer,\n  type AgentAudioVisualizerProps,\n} from \"./AgentAudioVisualizer.js\";\n// Convenience re-exports so app code can stay on one import.\nexport {\n  AgentSession,\n  FishAgentError,\n  type AgentMode,\n  type AgentSessionOptions,\n  type ConversationMessage,\n  type EndReason,\n  type SessionStatus,\n  type SessionToken,\n  type TranscriptSegment,\n} from \"@fishaudio/agent-client\";\n","import {\n  AgentSession,\n  type AgentMode,\n  type AgentSessionOptions,\n  type SessionStatus,\n} from \"@fishaudio/agent-client\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\n/** \"idle\" = no session yet (or a failed start); the rest mirror the session. */\nexport type ConversationStatus = SessionStatus | \"idle\";\n\nexport interface UseConversationReturn {\n  /** Live session object for event access; null before the first start. */\n  session: AgentSession | null;\n  status: ConversationStatus;\n  mode: AgentMode;\n  isSpeaking: boolean;\n  micMuted: boolean;\n  startSession: (overrides?: Partial<AgentSessionOptions>) => Promise<string>;\n  endSession: () => Promise<void>;\n  setMicMuted: (muted: boolean) => Promise<void>;\n  sendUserMessage: (text: string, options?: { audio?: boolean }) => void;\n  sendUserActivity: () => void;\n  interrupt: () => void;\n  startAudio: () => Promise<void>;\n  setOutputVolume: (volume: number) => void;\n  setInputDevice: (deviceId: string) => Promise<void>;\n  setOutputDevice: (deviceId: string) => Promise<void>;\n}\n\ninterface PendingStart {\n  state: { cancelled: boolean; sessionCreated: boolean };\n  promise: Promise<string>;\n}\n\nfunction startCancelledError(): Error {\n  const error = new Error(\"Conversation start was cancelled by endSession\");\n  error.name = \"AbortError\";\n  return error;\n}\n\nexport function useConversation(\n  defaults: Partial<AgentSessionOptions> = {},\n): UseConversationReturn {\n  const defaultsRef = useRef(defaults);\n  defaultsRef.current = defaults;\n\n  const sessionRef = useRef<AgentSession | null>(null);\n  const startingRef = useRef<PendingStart | null>(null);\n  const abandonedSessionRef = useRef<AgentSession | null>(null);\n  const lifecycleEpochRef = useRef(0);\n  const mountedRef = useRef(true);\n  const [session, setSession] = useState<AgentSession | null>(null);\n  const [status, setStatus] = useState<ConversationStatus>(\"idle\");\n  const [mode, setMode] = useState<AgentMode>(\"listening\");\n  const [micMuted, setMicMutedState] = useState(false);\n\n  const releaseAbandonedSession = useCallback(async () => {\n    const abandoned = abandonedSessionRef.current;\n    if (!abandoned) {\n      return;\n    }\n    await abandoned.end();\n    if (abandonedSessionRef.current === abandoned) {\n      abandonedSessionRef.current = null;\n    }\n  }, []);\n\n  const startSession = useCallback(\n    async (overrides: Partial<AgentSessionOptions> = {}): Promise<string> => {\n      const requestEpoch = lifecycleEpochRef.current;\n\n      const startAtEpoch = async (): Promise<string> => {\n        if (!mountedRef.current) {\n          throw new Error(\"Cannot start a conversation after useConversation has unmounted\");\n        }\n        if (requestEpoch !== lifecycleEpochRef.current) {\n          throw startCancelledError();\n        }\n\n        if (abandonedSessionRef.current) {\n          await releaseAbandonedSession();\n          if (requestEpoch !== lifecycleEpochRef.current) {\n            throw startCancelledError();\n          }\n        }\n\n        const current = sessionRef.current;\n        if (current) {\n          if (current.status !== \"ended\") {\n            return current.sessionId;\n          }\n          // status can reach ended before an in-flight transport teardown\n          // promise settles. AgentSession.end() joins that promise, so a fresh\n          // session never overlaps the old connection's cleanup.\n          await current.end();\n          if (requestEpoch !== lifecycleEpochRef.current) {\n            throw startCancelledError();\n          }\n        }\n\n        // Double-click guard: a second call while a start is in flight joins\n        // the first. A call queued after hangup waits for the cancelled start\n        // to release its resources before it creates a fresh session.\n        const existing = startingRef.current;\n        if (existing) {\n          if (!existing.state.cancelled) {\n            return existing.promise;\n          }\n          try {\n            await existing.promise;\n          } catch (error) {\n            // A failed session request leaves nothing to clean up, so a queued\n            // restart may continue. A teardown failure means the old session may\n            // still own resources and must stop the restart.\n            if (existing.state.sessionCreated) {\n              throw error;\n            }\n          }\n          if (requestEpoch !== lifecycleEpochRef.current) {\n            throw startCancelledError();\n          }\n          return startAtEpoch();\n        }\n\n        setStatus(\"connecting\");\n        const state = { cancelled: false, sessionCreated: false };\n        const starting = (async () => {\n          try {\n            const next = await AgentSession.start({\n              ...defaultsRef.current,\n              ...overrides,\n            } as AgentSessionOptions);\n            state.sessionCreated = true;\n            // endSession or a real unmount may happen while permissions/session\n            // creation are still pending. Never publish that late session into\n            // the hook; close it before it can leak its microphone or connection.\n            if (\n              state.cancelled ||\n              requestEpoch !== lifecycleEpochRef.current ||\n              !mountedRef.current\n            ) {\n              try {\n                await next.end();\n              } catch (error) {\n                abandonedSessionRef.current = next;\n                if (!mountedRef.current) {\n                  void releaseAbandonedSession().catch(() => undefined);\n                }\n                throw error;\n              }\n              return next.sessionId;\n            }\n            sessionRef.current = next;\n            setSession(next);\n            // Mirror, don't assume: a microphone:false start joins muted.\n            setMicMutedState(next.micMuted);\n            setMode(next.mode);\n            setStatus(next.status);\n            next.on(\"statusChange\", setStatus);\n            next.on(\"modeChange\", setMode);\n            return next.sessionId;\n          } catch (error) {\n            if (!state.cancelled && mountedRef.current) {\n              setStatus(\"idle\");\n            }\n            throw error;\n          } finally {\n            if (startingRef.current?.state === state) {\n              startingRef.current = null;\n            }\n          }\n        })();\n        const pending: PendingStart = { state, promise: starting };\n        startingRef.current = pending;\n        return starting;\n      };\n\n      return startAtEpoch();\n    },\n    [releaseAbandonedSession],\n  );\n\n  const endSession = useCallback(async () => {\n    lifecycleEpochRef.current += 1;\n    const pending = startingRef.current;\n    const current = sessionRef.current;\n    const abandoned = abandonedSessionRef.current;\n    if (!pending && !abandoned && !current) {\n      return;\n    }\n\n    if (pending) {\n      pending.state.cancelled = true;\n      if (mountedRef.current) {\n        setStatus(\"ended\");\n      }\n    }\n    await current?.end();\n    if (abandoned) {\n      await releaseAbandonedSession();\n    }\n    if (pending) {\n      try {\n        await pending.promise;\n      } catch (error) {\n        // The original startSession caller still receives a start failure. From\n        // endSession's perspective, a failed request means there is nothing to\n        // release; a failure after creation is a teardown failure and propagates.\n        if (pending.state.sessionCreated) {\n          throw error;\n        }\n      }\n    }\n  }, [releaseAbandonedSession]);\n\n  const setMicMuted = useCallback(async (muted: boolean) => {\n    await sessionRef.current?.setMicMuted(muted);\n    setMicMutedState(muted);\n  }, []);\n\n  useEffect(() => {\n    mountedRef.current = true;\n    return () => {\n      mountedRef.current = false;\n      lifecycleEpochRef.current += 1;\n      const pending = startingRef.current;\n      if (pending) {\n        pending.state.cancelled = true;\n      }\n      const current = sessionRef.current;\n      if (current) {\n        current.off(\"statusChange\", setStatus);\n        current.off(\"modeChange\", setMode);\n        void current.end().catch(() => undefined);\n      }\n      void releaseAbandonedSession().catch(() => undefined);\n    };\n  }, [releaseAbandonedSession]);\n\n  return {\n    session,\n    status,\n    mode,\n    isSpeaking: mode === \"speaking\",\n    micMuted,\n    startSession,\n    endSession,\n    setMicMuted,\n    sendUserMessage: useCallback(\n      (text: string, options?: { audio?: boolean }) =>\n        sessionRef.current?.sendUserMessage(text, options),\n      [],\n    ),\n    sendUserActivity: useCallback(() => sessionRef.current?.sendUserActivity(), []),\n    interrupt: useCallback(() => sessionRef.current?.interrupt(), []),\n    startAudio: useCallback(async () => sessionRef.current?.startAudio(), []),\n    setOutputVolume: useCallback(\n      (volume: number) => sessionRef.current?.setOutputVolume(volume),\n      [],\n    ),\n    setInputDevice: useCallback(\n      async (deviceId: string) => sessionRef.current?.setInputDevice(deviceId),\n      [],\n    ),\n    setOutputDevice: useCallback(\n      async (deviceId: string) => sessionRef.current?.setOutputDevice(deviceId),\n      [],\n    ),\n  };\n}\n","import type { AgentSessionOptions } from \"@fishaudio/agent-client\";\nimport { createContext, useContext, type PropsWithChildren, type ReactElement } from \"react\";\nimport { useConversation, type UseConversationReturn } from \"./useConversation.js\";\n\nconst ConversationContext = createContext<UseConversationReturn | null>(null);\n\nexport type AgentSessionProviderProps = PropsWithChildren<{\n  options?: Partial<AgentSessionOptions>;\n}>;\n\n/** Hosts one conversation for a component tree. */\nexport function AgentSessionProvider({\n  options,\n  children,\n}: AgentSessionProviderProps): ReactElement {\n  const conversation = useConversation(options ?? {});\n  return (\n    <ConversationContext.Provider value={conversation}>{children}</ConversationContext.Provider>\n  );\n}\n\nexport function useAgentSessionContext(): UseConversationReturn {\n  const context = useContext(ConversationContext);\n  if (!context) {\n    throw new Error(\"useAgentSessionContext must be used within <AgentSessionProvider>\");\n  }\n  return context;\n}\n\n/** Nullable variant for components that also accept an explicit session prop. */\nexport function useOptionalAgentSessionContext(): UseConversationReturn | null {\n  return useContext(ConversationContext);\n}\n","import type { AgentSession } from \"@fishaudio/agent-client\";\nimport { useEffect, useState } from \"react\";\nimport { useOptionalAgentSessionContext } from \"./provider.js\";\n\nexport interface ChatMessage {\n  /** Stable per-segment key for list rendering. */\n  key: string;\n  role: \"user\" | \"agent\";\n  text: string;\n  /** False while the segment is still streaming (interim transcript / deltas). */\n  final: boolean;\n}\n\n/**\n * Streaming chat log: user segments update in place as transcription refines,\n * agent segments grow with each delta and pin on completion. Pass a session or\n * rely on the surrounding <AgentSessionProvider>.\n */\nexport function useAgentMessages(session?: AgentSession | null): ChatMessage[] {\n  const context = useOptionalAgentSessionContext();\n  const active = session !== undefined ? session : (context?.session ?? null);\n  const [messages, setMessages] = useState<ChatMessage[]>([]);\n\n  useEffect(() => {\n    if (!active) {\n      return;\n    }\n    // Backfill events emitted before this effect ran (React commits the session\n    // after startSession resolves); live events then update the same keys.\n    setMessages(\n      active.getTranscript().map((segment) => ({\n        key: `${segment.role}-${segment.segmentId}`,\n        role: segment.role,\n        text: segment.text,\n        final: segment.final,\n      })),\n    );\n\n    const upsert = (key: string, role: \"user\" | \"agent\", text: string, final: boolean) => {\n      setMessages((previous) => {\n        const index = previous.findIndex((message) => message.key === key);\n        const entry: ChatMessage = { key, role, text, final };\n        if (index === -1) {\n          return [...previous, entry];\n        }\n        const next = [...previous];\n        next[index] = entry;\n        return next;\n      });\n    };\n\n    const onUserTranscript = (event: { segmentId: string; text: string; final: boolean }) =>\n      upsert(`user-${event.segmentId}`, \"user\", event.text, event.final);\n    const onAgentDelta = (event: { segmentId: string; text: string }) =>\n      upsert(`agent-${event.segmentId}`, \"agent\", event.text, false);\n    const onAgentResponse = (event: { segmentId: string; text: string }) =>\n      upsert(`agent-${event.segmentId}`, \"agent\", event.text, true);\n\n    active.on(\"userTranscript\", onUserTranscript);\n    active.on(\"agentResponseDelta\", onAgentDelta);\n    active.on(\"agentResponse\", onAgentResponse);\n    return () => {\n      active.off(\"userTranscript\", onUserTranscript);\n      active.off(\"agentResponseDelta\", onAgentDelta);\n      active.off(\"agentResponse\", onAgentResponse);\n    };\n  }, [active]);\n\n  return messages;\n}\n","import type { AgentSession } from \"@fishaudio/agent-client\";\nimport { useEffect, useState } from \"react\";\nimport { useOptionalAgentSessionContext } from \"./provider.js\";\n\nexport interface AudioLevels {\n  /** Microphone RMS in [0, 1]. */\n  input: number;\n  /** Agent audio RMS in [0, 1]. */\n  output: number;\n}\n\n/** Polls session audio levels for meters/animations. */\nexport function useAudioLevels(session?: AgentSession | null, fps = 20): AudioLevels {\n  const context = useOptionalAgentSessionContext();\n  const active = session !== undefined ? session : (context?.session ?? null);\n  const [levels, setLevels] = useState<AudioLevels>({ input: 0, output: 0 });\n\n  useEffect(() => {\n    if (!active) {\n      return;\n    }\n    const timer = setInterval(\n      () => {\n        setLevels({ input: active.getInputVolume(), output: active.getOutputVolume() });\n      },\n      Math.max(1000 / fps, 16),\n    );\n    return () => {\n      clearInterval(timer);\n    };\n  }, [active, fps]);\n\n  return levels;\n}\n","import type { AgentSession } from \"@fishaudio/agent-client\";\nimport { useEffect, useRef, type ReactElement } from \"react\";\nimport { useOptionalAgentSessionContext } from \"./provider.js\";\n\nexport interface AgentAudioVisualizerProps {\n  session?: AgentSession | null;\n  bars?: number;\n  width?: number;\n  height?: number;\n  className?: string;\n}\n\n/**\n * Frequency bars for the agent's voice, drawn from the session's analyser data\n * (no transport objects involved). Colors follow CSS `color` on the canvas.\n */\nexport function AgentAudioVisualizer({\n  session,\n  bars = 24,\n  width = 240,\n  height = 64,\n  className,\n}: AgentAudioVisualizerProps): ReactElement {\n  const context = useOptionalAgentSessionContext();\n  const active = session !== undefined ? session : (context?.session ?? null);\n  const canvasRef = useRef<HTMLCanvasElement | null>(null);\n\n  useEffect(() => {\n    const canvas = canvasRef.current;\n    if (!canvas || !active) {\n      return;\n    }\n    const context2d = canvas.getContext(\"2d\");\n    if (!context2d) {\n      return;\n    }\n\n    let frame = 0;\n    const draw = () => {\n      const data = active.getOutputFrequencyData();\n      context2d.clearRect(0, 0, canvas.width, canvas.height);\n      context2d.fillStyle = getComputedStyle(canvas).color;\n      const barWidth = canvas.width / bars;\n      for (let index = 0; index < bars; index += 1) {\n        const sample = data.length\n          ? (data[Math.floor((index / bars) * data.length)] ?? 0) / 255\n          : 0;\n        const barHeight = Math.max(2, sample * canvas.height);\n        context2d.fillRect(\n          index * barWidth + barWidth * 0.15,\n          (canvas.height - barHeight) / 2,\n          barWidth * 0.7,\n          barHeight,\n        );\n      }\n      frame = requestAnimationFrame(draw);\n    };\n    frame = requestAnimationFrame(draw);\n    return () => {\n      cancelAnimationFrame(frame);\n    };\n  }, [active, bars]);\n\n  return <canvas ref={canvasRef} width={width} height={height} className={className} />;\n}\n"],"mappings":"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","names":["import_react","import_react","import_react","import_react","import_jsx_runtime","import_agent_client"]}

package/dist/index.d.cts

@@ -0,0 +1,75 @@
+import { SessionStatus, AgentSession, AgentMode, AgentSessionOptions } from '@fishaudio/agent-client';
+export { AgentMode, AgentSession, AgentSessionOptions, ConversationMessage, EndReason, FishAgentError, SessionStatus, SessionToken, TranscriptSegment } from '@fishaudio/agent-client';
+import { PropsWithChildren, ReactElement } from 'react';
+
+/** "idle" = no session yet (or a failed start); the rest mirror the session. */
+type ConversationStatus = SessionStatus | "idle";
+interface UseConversationReturn {
+    /** Live session object for event access; null before the first start. */
+    session: AgentSession | null;
+    status: ConversationStatus;
+    mode: AgentMode;
+    isSpeaking: boolean;
+    micMuted: boolean;
+    startSession: (overrides?: Partial<AgentSessionOptions>) => Promise<string>;
+    endSession: () => Promise<void>;
+    setMicMuted: (muted: boolean) => Promise<void>;
+    sendUserMessage: (text: string, options?: {
+        audio?: boolean;
+    }) => void;
+    sendUserActivity: () => void;
+    interrupt: () => void;
+    startAudio: () => Promise<void>;
+    setOutputVolume: (volume: number) => void;
+    setInputDevice: (deviceId: string) => Promise<void>;
+    setOutputDevice: (deviceId: string) => Promise<void>;
+}
+declare function useConversation(defaults?: Partial<AgentSessionOptions>): UseConversationReturn;
+
+type AgentSessionProviderProps = PropsWithChildren<{
+    options?: Partial<AgentSessionOptions>;
+}>;
+/** Hosts one conversation for a component tree. */
+declare function AgentSessionProvider({ options, children, }: AgentSessionProviderProps): ReactElement;
+declare function useAgentSessionContext(): UseConversationReturn;
+/** Nullable variant for components that also accept an explicit session prop. */
+declare function useOptionalAgentSessionContext(): UseConversationReturn | null;
+
+interface ChatMessage {
+    /** Stable per-segment key for list rendering. */
+    key: string;
+    role: "user" | "agent";
+    text: string;
+    /** False while the segment is still streaming (interim transcript / deltas). */
+    final: boolean;
+}
+/**
+ * Streaming chat log: user segments update in place as transcription refines,
+ * agent segments grow with each delta and pin on completion. Pass a session or
+ * rely on the surrounding <AgentSessionProvider>.
+ */
+declare function useAgentMessages(session?: AgentSession | null): ChatMessage[];
+
+interface AudioLevels {
+    /** Microphone RMS in [0, 1]. */
+    input: number;
+    /** Agent audio RMS in [0, 1]. */
+    output: number;
+}
+/** Polls session audio levels for meters/animations. */
+declare function useAudioLevels(session?: AgentSession | null, fps?: number): AudioLevels;
+
+interface AgentAudioVisualizerProps {
+    session?: AgentSession | null;
+    bars?: number;
+    width?: number;
+    height?: number;
+    className?: string;
+}
+/**
+ * Frequency bars for the agent's voice, drawn from the session's analyser data
+ * (no transport objects involved). Colors follow CSS `color` on the canvas.
+ */
+declare function AgentAudioVisualizer({ session, bars, width, height, className, }: AgentAudioVisualizerProps): ReactElement;
+
+export { AgentAudioVisualizer, type AgentAudioVisualizerProps, AgentSessionProvider, type AgentSessionProviderProps, type AudioLevels, type ChatMessage, type ConversationStatus, type UseConversationReturn, useAgentMessages, useAgentSessionContext, useAudioLevels, useConversation, useOptionalAgentSessionContext };

package/dist/index.d.ts

@@ -0,0 +1,75 @@
+import { SessionStatus, AgentSession, AgentMode, AgentSessionOptions } from '@fishaudio/agent-client';
+export { AgentMode, AgentSession, AgentSessionOptions, ConversationMessage, EndReason, FishAgentError, SessionStatus, SessionToken, TranscriptSegment } from '@fishaudio/agent-client';
+import { PropsWithChildren, ReactElement } from 'react';
+
+/** "idle" = no session yet (or a failed start); the rest mirror the session. */
+type ConversationStatus = SessionStatus | "idle";
+interface UseConversationReturn {
+    /** Live session object for event access; null before the first start. */
+    session: AgentSession | null;
+    status: ConversationStatus;
+    mode: AgentMode;
+    isSpeaking: boolean;
+    micMuted: boolean;
+    startSession: (overrides?: Partial<AgentSessionOptions>) => Promise<string>;
+    endSession: () => Promise<void>;
+    setMicMuted: (muted: boolean) => Promise<void>;
+    sendUserMessage: (text: string, options?: {
+        audio?: boolean;
+    }) => void;
+    sendUserActivity: () => void;
+    interrupt: () => void;
+    startAudio: () => Promise<void>;
+    setOutputVolume: (volume: number) => void;
+    setInputDevice: (deviceId: string) => Promise<void>;
+    setOutputDevice: (deviceId: string) => Promise<void>;
+}
+declare function useConversation(defaults?: Partial<AgentSessionOptions>): UseConversationReturn;
+
+type AgentSessionProviderProps = PropsWithChildren<{
+    options?: Partial<AgentSessionOptions>;
+}>;
+/** Hosts one conversation for a component tree. */
+declare function AgentSessionProvider({ options, children, }: AgentSessionProviderProps): ReactElement;
+declare function useAgentSessionContext(): UseConversationReturn;
+/** Nullable variant for components that also accept an explicit session prop. */
+declare function useOptionalAgentSessionContext(): UseConversationReturn | null;
+
+interface ChatMessage {
+    /** Stable per-segment key for list rendering. */
+    key: string;
+    role: "user" | "agent";
+    text: string;
+    /** False while the segment is still streaming (interim transcript / deltas). */
+    final: boolean;
+}
+/**
+ * Streaming chat log: user segments update in place as transcription refines,
+ * agent segments grow with each delta and pin on completion. Pass a session or
+ * rely on the surrounding <AgentSessionProvider>.
+ */
+declare function useAgentMessages(session?: AgentSession | null): ChatMessage[];
+
+interface AudioLevels {
+    /** Microphone RMS in [0, 1]. */
+    input: number;
+    /** Agent audio RMS in [0, 1]. */
+    output: number;
+}
+/** Polls session audio levels for meters/animations. */
+declare function useAudioLevels(session?: AgentSession | null, fps?: number): AudioLevels;
+
+interface AgentAudioVisualizerProps {
+    session?: AgentSession | null;
+    bars?: number;
+    width?: number;
+    height?: number;
+    className?: string;
+}
+/**
+ * Frequency bars for the agent's voice, drawn from the session's analyser data
+ * (no transport objects involved). Colors follow CSS `color` on the canvas.
+ */
+declare function AgentAudioVisualizer({ session, bars, width, height, className, }: AgentAudioVisualizerProps): ReactElement;
+
+export { AgentAudioVisualizer, type AgentAudioVisualizerProps, AgentSessionProvider, type AgentSessionProviderProps, type AudioLevels, type ChatMessage, type ConversationStatus, type UseConversationReturn, useAgentMessages, useAgentSessionContext, useAudioLevels, useConversation, useOptionalAgentSessionContext };

package/dist/index.js

@@ -0,0 +1,359 @@
+// src/useConversation.ts
+import {
+  AgentSession
+} from "@fishaudio/agent-client";
+import { useCallback, useEffect, useRef, useState } from "react";
+function startCancelledError() {
+  const error = new Error("Conversation start was cancelled by endSession");
+  error.name = "AbortError";
+  return error;
+}
+function useConversation(defaults = {}) {
+  const defaultsRef = useRef(defaults);
+  defaultsRef.current = defaults;
+  const sessionRef = useRef(null);
+  const startingRef = useRef(null);
+  const abandonedSessionRef = useRef(null);
+  const lifecycleEpochRef = useRef(0);
+  const mountedRef = useRef(true);
+  const [session, setSession] = useState(null);
+  const [status, setStatus] = useState("idle");
+  const [mode, setMode] = useState("listening");
+  const [micMuted, setMicMutedState] = useState(false);
+  const releaseAbandonedSession = useCallback(async () => {
+    const abandoned = abandonedSessionRef.current;
+    if (!abandoned) {
+      return;
+    }
+    await abandoned.end();
+    if (abandonedSessionRef.current === abandoned) {
+      abandonedSessionRef.current = null;
+    }
+  }, []);
+  const startSession = useCallback(
+    async (overrides = {}) => {
+      const requestEpoch = lifecycleEpochRef.current;
+      const startAtEpoch = async () => {
+        if (!mountedRef.current) {
+          throw new Error("Cannot start a conversation after useConversation has unmounted");
+        }
+        if (requestEpoch !== lifecycleEpochRef.current) {
+          throw startCancelledError();
+        }
+        if (abandonedSessionRef.current) {
+          await releaseAbandonedSession();
+          if (requestEpoch !== lifecycleEpochRef.current) {
+            throw startCancelledError();
+          }
+        }
+        const current = sessionRef.current;
+        if (current) {
+          if (current.status !== "ended") {
+            return current.sessionId;
+          }
+          await current.end();
+          if (requestEpoch !== lifecycleEpochRef.current) {
+            throw startCancelledError();
+          }
+        }
+        const existing = startingRef.current;
+        if (existing) {
+          if (!existing.state.cancelled) {
+            return existing.promise;
+          }
+          try {
+            await existing.promise;
+          } catch (error) {
+            if (existing.state.sessionCreated) {
+              throw error;
+            }
+          }
+          if (requestEpoch !== lifecycleEpochRef.current) {
+            throw startCancelledError();
+          }
+          return startAtEpoch();
+        }
+        setStatus("connecting");
+        const state = { cancelled: false, sessionCreated: false };
+        const starting = (async () => {
+          try {
+            const next = await AgentSession.start({
+              ...defaultsRef.current,
+              ...overrides
+            });
+            state.sessionCreated = true;
+            if (state.cancelled || requestEpoch !== lifecycleEpochRef.current || !mountedRef.current) {
+              try {
+                await next.end();
+              } catch (error) {
+                abandonedSessionRef.current = next;
+                if (!mountedRef.current) {
+                  void releaseAbandonedSession().catch(() => void 0);
+                }
+                throw error;
+              }
+              return next.sessionId;
+            }
+            sessionRef.current = next;
+            setSession(next);
+            setMicMutedState(next.micMuted);
+            setMode(next.mode);
+            setStatus(next.status);
+            next.on("statusChange", setStatus);
+            next.on("modeChange", setMode);
+            return next.sessionId;
+          } catch (error) {
+            if (!state.cancelled && mountedRef.current) {
+              setStatus("idle");
+            }
+            throw error;
+          } finally {
+            if (startingRef.current?.state === state) {
+              startingRef.current = null;
+            }
+          }
+        })();
+        const pending = { state, promise: starting };
+        startingRef.current = pending;
+        return starting;
+      };
+      return startAtEpoch();
+    },
+    [releaseAbandonedSession]
+  );
+  const endSession = useCallback(async () => {
+    lifecycleEpochRef.current += 1;
+    const pending = startingRef.current;
+    const current = sessionRef.current;
+    const abandoned = abandonedSessionRef.current;
+    if (!pending && !abandoned && !current) {
+      return;
+    }
+    if (pending) {
+      pending.state.cancelled = true;
+      if (mountedRef.current) {
+        setStatus("ended");
+      }
+    }
+    await current?.end();
+    if (abandoned) {
+      await releaseAbandonedSession();
+    }
+    if (pending) {
+      try {
+        await pending.promise;
+      } catch (error) {
+        if (pending.state.sessionCreated) {
+          throw error;
+        }
+      }
+    }
+  }, [releaseAbandonedSession]);
+  const setMicMuted = useCallback(async (muted) => {
+    await sessionRef.current?.setMicMuted(muted);
+    setMicMutedState(muted);
+  }, []);
+  useEffect(() => {
+    mountedRef.current = true;
+    return () => {
+      mountedRef.current = false;
+      lifecycleEpochRef.current += 1;
+      const pending = startingRef.current;
+      if (pending) {
+        pending.state.cancelled = true;
+      }
+      const current = sessionRef.current;
+      if (current) {
+        current.off("statusChange", setStatus);
+        current.off("modeChange", setMode);
+        void current.end().catch(() => void 0);
+      }
+      void releaseAbandonedSession().catch(() => void 0);
+    };
+  }, [releaseAbandonedSession]);
+  return {
+    session,
+    status,
+    mode,
+    isSpeaking: mode === "speaking",
+    micMuted,
+    startSession,
+    endSession,
+    setMicMuted,
+    sendUserMessage: useCallback(
+      (text, options) => sessionRef.current?.sendUserMessage(text, options),
+      []
+    ),
+    sendUserActivity: useCallback(() => sessionRef.current?.sendUserActivity(), []),
+    interrupt: useCallback(() => sessionRef.current?.interrupt(), []),
+    startAudio: useCallback(async () => sessionRef.current?.startAudio(), []),
+    setOutputVolume: useCallback(
+      (volume) => sessionRef.current?.setOutputVolume(volume),
+      []
+    ),
+    setInputDevice: useCallback(
+      async (deviceId) => sessionRef.current?.setInputDevice(deviceId),
+      []
+    ),
+    setOutputDevice: useCallback(
+      async (deviceId) => sessionRef.current?.setOutputDevice(deviceId),
+      []
+    )
+  };
+}
+
+// src/provider.tsx
+import { createContext, useContext } from "react";
+import { jsx } from "react/jsx-runtime";
+var ConversationContext = createContext(null);
+function AgentSessionProvider({
+  options,
+  children
+}) {
+  const conversation = useConversation(options ?? {});
+  return /* @__PURE__ */ jsx(ConversationContext.Provider, { value: conversation, children });
+}
+function useAgentSessionContext() {
+  const context = useContext(ConversationContext);
+  if (!context) {
+    throw new Error("useAgentSessionContext must be used within <AgentSessionProvider>");
+  }
+  return context;
+}
+function useOptionalAgentSessionContext() {
+  return useContext(ConversationContext);
+}
+
+// src/useAgentMessages.ts
+import { useEffect as useEffect2, useState as useState2 } from "react";
+function useAgentMessages(session) {
+  const context = useOptionalAgentSessionContext();
+  const active = session !== void 0 ? session : context?.session ?? null;
+  const [messages, setMessages] = useState2([]);
+  useEffect2(() => {
+    if (!active) {
+      return;
+    }
+    setMessages(
+      active.getTranscript().map((segment) => ({
+        key: `${segment.role}-${segment.segmentId}`,
+        role: segment.role,
+        text: segment.text,
+        final: segment.final
+      }))
+    );
+    const upsert = (key, role, text, final) => {
+      setMessages((previous) => {
+        const index = previous.findIndex((message) => message.key === key);
+        const entry = { key, role, text, final };
+        if (index === -1) {
+          return [...previous, entry];
+        }
+        const next = [...previous];
+        next[index] = entry;
+        return next;
+      });
+    };
+    const onUserTranscript = (event) => upsert(`user-${event.segmentId}`, "user", event.text, event.final);
+    const onAgentDelta = (event) => upsert(`agent-${event.segmentId}`, "agent", event.text, false);
+    const onAgentResponse = (event) => upsert(`agent-${event.segmentId}`, "agent", event.text, true);
+    active.on("userTranscript", onUserTranscript);
+    active.on("agentResponseDelta", onAgentDelta);
+    active.on("agentResponse", onAgentResponse);
+    return () => {
+      active.off("userTranscript", onUserTranscript);
+      active.off("agentResponseDelta", onAgentDelta);
+      active.off("agentResponse", onAgentResponse);
+    };
+  }, [active]);
+  return messages;
+}
+
+// src/useAudioLevels.ts
+import { useEffect as useEffect3, useState as useState3 } from "react";
+function useAudioLevels(session, fps = 20) {
+  const context = useOptionalAgentSessionContext();
+  const active = session !== void 0 ? session : context?.session ?? null;
+  const [levels, setLevels] = useState3({ input: 0, output: 0 });
+  useEffect3(() => {
+    if (!active) {
+      return;
+    }
+    const timer = setInterval(
+      () => {
+        setLevels({ input: active.getInputVolume(), output: active.getOutputVolume() });
+      },
+      Math.max(1e3 / fps, 16)
+    );
+    return () => {
+      clearInterval(timer);
+    };
+  }, [active, fps]);
+  return levels;
+}
+
+// src/AgentAudioVisualizer.tsx
+import { useEffect as useEffect4, useRef as useRef2 } from "react";
+import { jsx as jsx2 } from "react/jsx-runtime";
+function AgentAudioVisualizer({
+  session,
+  bars = 24,
+  width = 240,
+  height = 64,
+  className
+}) {
+  const context = useOptionalAgentSessionContext();
+  const active = session !== void 0 ? session : context?.session ?? null;
+  const canvasRef = useRef2(null);
+  useEffect4(() => {
+    const canvas = canvasRef.current;
+    if (!canvas || !active) {
+      return;
+    }
+    const context2d = canvas.getContext("2d");
+    if (!context2d) {
+      return;
+    }
+    let frame = 0;
+    const draw = () => {
+      const data = active.getOutputFrequencyData();
+      context2d.clearRect(0, 0, canvas.width, canvas.height);
+      context2d.fillStyle = getComputedStyle(canvas).color;
+      const barWidth = canvas.width / bars;
+      for (let index = 0; index < bars; index += 1) {
+        const sample = data.length ? (data[Math.floor(index / bars * data.length)] ?? 0) / 255 : 0;
+        const barHeight = Math.max(2, sample * canvas.height);
+        context2d.fillRect(
+          index * barWidth + barWidth * 0.15,
+          (canvas.height - barHeight) / 2,
+          barWidth * 0.7,
+          barHeight
+        );
+      }
+      frame = requestAnimationFrame(draw);
+    };
+    frame = requestAnimationFrame(draw);
+    return () => {
+      cancelAnimationFrame(frame);
+    };
+  }, [active, bars]);
+  return /* @__PURE__ */ jsx2("canvas", { ref: canvasRef, width, height, className });
+}
+
+// src/index.ts
+import {
+  AgentSession as AgentSession2,
+  FishAgentError
+} from "@fishaudio/agent-client";
+export {
+  AgentAudioVisualizer,
+  AgentSession2 as AgentSession,
+  AgentSessionProvider,
+  FishAgentError,
+  useAgentMessages,
+  useAgentSessionContext,
+  useAudioLevels,
+  useConversation,
+  useOptionalAgentSessionContext
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/useConversation.ts","../src/provider.tsx","../src/useAgentMessages.ts","../src/useAudioLevels.ts","../src/AgentAudioVisualizer.tsx","../src/index.ts"],"sourcesContent":["import {\n  AgentSession,\n  type AgentMode,\n  type AgentSessionOptions,\n  type SessionStatus,\n} from \"@fishaudio/agent-client\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\n/** \"idle\" = no session yet (or a failed start); the rest mirror the session. */\nexport type ConversationStatus = SessionStatus | \"idle\";\n\nexport interface UseConversationReturn {\n  /** Live session object for event access; null before the first start. */\n  session: AgentSession | null;\n  status: ConversationStatus;\n  mode: AgentMode;\n  isSpeaking: boolean;\n  micMuted: boolean;\n  startSession: (overrides?: Partial<AgentSessionOptions>) => Promise<string>;\n  endSession: () => Promise<void>;\n  setMicMuted: (muted: boolean) => Promise<void>;\n  sendUserMessage: (text: string, options?: { audio?: boolean }) => void;\n  sendUserActivity: () => void;\n  interrupt: () => void;\n  startAudio: () => Promise<void>;\n  setOutputVolume: (volume: number) => void;\n  setInputDevice: (deviceId: string) => Promise<void>;\n  setOutputDevice: (deviceId: string) => Promise<void>;\n}\n\ninterface PendingStart {\n  state: { cancelled: boolean; sessionCreated: boolean };\n  promise: Promise<string>;\n}\n\nfunction startCancelledError(): Error {\n  const error = new Error(\"Conversation start was cancelled by endSession\");\n  error.name = \"AbortError\";\n  return error;\n}\n\nexport function useConversation(\n  defaults: Partial<AgentSessionOptions> = {},\n): UseConversationReturn {\n  const defaultsRef = useRef(defaults);\n  defaultsRef.current = defaults;\n\n  const sessionRef = useRef<AgentSession | null>(null);\n  const startingRef = useRef<PendingStart | null>(null);\n  const abandonedSessionRef = useRef<AgentSession | null>(null);\n  const lifecycleEpochRef = useRef(0);\n  const mountedRef = useRef(true);\n  const [session, setSession] = useState<AgentSession | null>(null);\n  const [status, setStatus] = useState<ConversationStatus>(\"idle\");\n  const [mode, setMode] = useState<AgentMode>(\"listening\");\n  const [micMuted, setMicMutedState] = useState(false);\n\n  const releaseAbandonedSession = useCallback(async () => {\n    const abandoned = abandonedSessionRef.current;\n    if (!abandoned) {\n      return;\n    }\n    await abandoned.end();\n    if (abandonedSessionRef.current === abandoned) {\n      abandonedSessionRef.current = null;\n    }\n  }, []);\n\n  const startSession = useCallback(\n    async (overrides: Partial<AgentSessionOptions> = {}): Promise<string> => {\n      const requestEpoch = lifecycleEpochRef.current;\n\n      const startAtEpoch = async (): Promise<string> => {\n        if (!mountedRef.current) {\n          throw new Error(\"Cannot start a conversation after useConversation has unmounted\");\n        }\n        if (requestEpoch !== lifecycleEpochRef.current) {\n          throw startCancelledError();\n        }\n\n        if (abandonedSessionRef.current) {\n          await releaseAbandonedSession();\n          if (requestEpoch !== lifecycleEpochRef.current) {\n            throw startCancelledError();\n          }\n        }\n\n        const current = sessionRef.current;\n        if (current) {\n          if (current.status !== \"ended\") {\n            return current.sessionId;\n          }\n          // status can reach ended before an in-flight transport teardown\n          // promise settles. AgentSession.end() joins that promise, so a fresh\n          // session never overlaps the old connection's cleanup.\n          await current.end();\n          if (requestEpoch !== lifecycleEpochRef.current) {\n            throw startCancelledError();\n          }\n        }\n\n        // Double-click guard: a second call while a start is in flight joins\n        // the first. A call queued after hangup waits for the cancelled start\n        // to release its resources before it creates a fresh session.\n        const existing = startingRef.current;\n        if (existing) {\n          if (!existing.state.cancelled) {\n            return existing.promise;\n          }\n          try {\n            await existing.promise;\n          } catch (error) {\n            // A failed session request leaves nothing to clean up, so a queued\n            // restart may continue. A teardown failure means the old session may\n            // still own resources and must stop the restart.\n            if (existing.state.sessionCreated) {\n              throw error;\n            }\n          }\n          if (requestEpoch !== lifecycleEpochRef.current) {\n            throw startCancelledError();\n          }\n          return startAtEpoch();\n        }\n\n        setStatus(\"connecting\");\n        const state = { cancelled: false, sessionCreated: false };\n        const starting = (async () => {\n          try {\n            const next = await AgentSession.start({\n              ...defaultsRef.current,\n              ...overrides,\n            } as AgentSessionOptions);\n            state.sessionCreated = true;\n            // endSession or a real unmount may happen while permissions/session\n            // creation are still pending. Never publish that late session into\n            // the hook; close it before it can leak its microphone or connection.\n            if (\n              state.cancelled ||\n              requestEpoch !== lifecycleEpochRef.current ||\n              !mountedRef.current\n            ) {\n              try {\n                await next.end();\n              } catch (error) {\n                abandonedSessionRef.current = next;\n                if (!mountedRef.current) {\n                  void releaseAbandonedSession().catch(() => undefined);\n                }\n                throw error;\n              }\n              return next.sessionId;\n            }\n            sessionRef.current = next;\n            setSession(next);\n            // Mirror, don't assume: a microphone:false start joins muted.\n            setMicMutedState(next.micMuted);\n            setMode(next.mode);\n            setStatus(next.status);\n            next.on(\"statusChange\", setStatus);\n            next.on(\"modeChange\", setMode);\n            return next.sessionId;\n          } catch (error) {\n            if (!state.cancelled && mountedRef.current) {\n              setStatus(\"idle\");\n            }\n            throw error;\n          } finally {\n            if (startingRef.current?.state === state) {\n              startingRef.current = null;\n            }\n          }\n        })();\n        const pending: PendingStart = { state, promise: starting };\n        startingRef.current = pending;\n        return starting;\n      };\n\n      return startAtEpoch();\n    },\n    [releaseAbandonedSession],\n  );\n\n  const endSession = useCallback(async () => {\n    lifecycleEpochRef.current += 1;\n    const pending = startingRef.current;\n    const current = sessionRef.current;\n    const abandoned = abandonedSessionRef.current;\n    if (!pending && !abandoned && !current) {\n      return;\n    }\n\n    if (pending) {\n      pending.state.cancelled = true;\n      if (mountedRef.current) {\n        setStatus(\"ended\");\n      }\n    }\n    await current?.end();\n    if (abandoned) {\n      await releaseAbandonedSession();\n    }\n    if (pending) {\n      try {\n        await pending.promise;\n      } catch (error) {\n        // The original startSession caller still receives a start failure. From\n        // endSession's perspective, a failed request means there is nothing to\n        // release; a failure after creation is a teardown failure and propagates.\n        if (pending.state.sessionCreated) {\n          throw error;\n        }\n      }\n    }\n  }, [releaseAbandonedSession]);\n\n  const setMicMuted = useCallback(async (muted: boolean) => {\n    await sessionRef.current?.setMicMuted(muted);\n    setMicMutedState(muted);\n  }, []);\n\n  useEffect(() => {\n    mountedRef.current = true;\n    return () => {\n      mountedRef.current = false;\n      lifecycleEpochRef.current += 1;\n      const pending = startingRef.current;\n      if (pending) {\n        pending.state.cancelled = true;\n      }\n      const current = sessionRef.current;\n      if (current) {\n        current.off(\"statusChange\", setStatus);\n        current.off(\"modeChange\", setMode);\n        void current.end().catch(() => undefined);\n      }\n      void releaseAbandonedSession().catch(() => undefined);\n    };\n  }, [releaseAbandonedSession]);\n\n  return {\n    session,\n    status,\n    mode,\n    isSpeaking: mode === \"speaking\",\n    micMuted,\n    startSession,\n    endSession,\n    setMicMuted,\n    sendUserMessage: useCallback(\n      (text: string, options?: { audio?: boolean }) =>\n        sessionRef.current?.sendUserMessage(text, options),\n      [],\n    ),\n    sendUserActivity: useCallback(() => sessionRef.current?.sendUserActivity(), []),\n    interrupt: useCallback(() => sessionRef.current?.interrupt(), []),\n    startAudio: useCallback(async () => sessionRef.current?.startAudio(), []),\n    setOutputVolume: useCallback(\n      (volume: number) => sessionRef.current?.setOutputVolume(volume),\n      [],\n    ),\n    setInputDevice: useCallback(\n      async (deviceId: string) => sessionRef.current?.setInputDevice(deviceId),\n      [],\n    ),\n    setOutputDevice: useCallback(\n      async (deviceId: string) => sessionRef.current?.setOutputDevice(deviceId),\n      [],\n    ),\n  };\n}\n","import type { AgentSessionOptions } from \"@fishaudio/agent-client\";\nimport { createContext, useContext, type PropsWithChildren, type ReactElement } from \"react\";\nimport { useConversation, type UseConversationReturn } from \"./useConversation.js\";\n\nconst ConversationContext = createContext<UseConversationReturn | null>(null);\n\nexport type AgentSessionProviderProps = PropsWithChildren<{\n  options?: Partial<AgentSessionOptions>;\n}>;\n\n/** Hosts one conversation for a component tree. */\nexport function AgentSessionProvider({\n  options,\n  children,\n}: AgentSessionProviderProps): ReactElement {\n  const conversation = useConversation(options ?? {});\n  return (\n    <ConversationContext.Provider value={conversation}>{children}</ConversationContext.Provider>\n  );\n}\n\nexport function useAgentSessionContext(): UseConversationReturn {\n  const context = useContext(ConversationContext);\n  if (!context) {\n    throw new Error(\"useAgentSessionContext must be used within <AgentSessionProvider>\");\n  }\n  return context;\n}\n\n/** Nullable variant for components that also accept an explicit session prop. */\nexport function useOptionalAgentSessionContext(): UseConversationReturn | null {\n  return useContext(ConversationContext);\n}\n","import type { AgentSession } from \"@fishaudio/agent-client\";\nimport { useEffect, useState } from \"react\";\nimport { useOptionalAgentSessionContext } from \"./provider.js\";\n\nexport interface ChatMessage {\n  /** Stable per-segment key for list rendering. */\n  key: string;\n  role: \"user\" | \"agent\";\n  text: string;\n  /** False while the segment is still streaming (interim transcript / deltas). */\n  final: boolean;\n}\n\n/**\n * Streaming chat log: user segments update in place as transcription refines,\n * agent segments grow with each delta and pin on completion. Pass a session or\n * rely on the surrounding <AgentSessionProvider>.\n */\nexport function useAgentMessages(session?: AgentSession | null): ChatMessage[] {\n  const context = useOptionalAgentSessionContext();\n  const active = session !== undefined ? session : (context?.session ?? null);\n  const [messages, setMessages] = useState<ChatMessage[]>([]);\n\n  useEffect(() => {\n    if (!active) {\n      return;\n    }\n    // Backfill events emitted before this effect ran (React commits the session\n    // after startSession resolves); live events then update the same keys.\n    setMessages(\n      active.getTranscript().map((segment) => ({\n        key: `${segment.role}-${segment.segmentId}`,\n        role: segment.role,\n        text: segment.text,\n        final: segment.final,\n      })),\n    );\n\n    const upsert = (key: string, role: \"user\" | \"agent\", text: string, final: boolean) => {\n      setMessages((previous) => {\n        const index = previous.findIndex((message) => message.key === key);\n        const entry: ChatMessage = { key, role, text, final };\n        if (index === -1) {\n          return [...previous, entry];\n        }\n        const next = [...previous];\n        next[index] = entry;\n        return next;\n      });\n    };\n\n    const onUserTranscript = (event: { segmentId: string; text: string; final: boolean }) =>\n      upsert(`user-${event.segmentId}`, \"user\", event.text, event.final);\n    const onAgentDelta = (event: { segmentId: string; text: string }) =>\n      upsert(`agent-${event.segmentId}`, \"agent\", event.text, false);\n    const onAgentResponse = (event: { segmentId: string; text: string }) =>\n      upsert(`agent-${event.segmentId}`, \"agent\", event.text, true);\n\n    active.on(\"userTranscript\", onUserTranscript);\n    active.on(\"agentResponseDelta\", onAgentDelta);\n    active.on(\"agentResponse\", onAgentResponse);\n    return () => {\n      active.off(\"userTranscript\", onUserTranscript);\n      active.off(\"agentResponseDelta\", onAgentDelta);\n      active.off(\"agentResponse\", onAgentResponse);\n    };\n  }, [active]);\n\n  return messages;\n}\n","import type { AgentSession } from \"@fishaudio/agent-client\";\nimport { useEffect, useState } from \"react\";\nimport { useOptionalAgentSessionContext } from \"./provider.js\";\n\nexport interface AudioLevels {\n  /** Microphone RMS in [0, 1]. */\n  input: number;\n  /** Agent audio RMS in [0, 1]. */\n  output: number;\n}\n\n/** Polls session audio levels for meters/animations. */\nexport function useAudioLevels(session?: AgentSession | null, fps = 20): AudioLevels {\n  const context = useOptionalAgentSessionContext();\n  const active = session !== undefined ? session : (context?.session ?? null);\n  const [levels, setLevels] = useState<AudioLevels>({ input: 0, output: 0 });\n\n  useEffect(() => {\n    if (!active) {\n      return;\n    }\n    const timer = setInterval(\n      () => {\n        setLevels({ input: active.getInputVolume(), output: active.getOutputVolume() });\n      },\n      Math.max(1000 / fps, 16),\n    );\n    return () => {\n      clearInterval(timer);\n    };\n  }, [active, fps]);\n\n  return levels;\n}\n","import type { AgentSession } from \"@fishaudio/agent-client\";\nimport { useEffect, useRef, type ReactElement } from \"react\";\nimport { useOptionalAgentSessionContext } from \"./provider.js\";\n\nexport interface AgentAudioVisualizerProps {\n  session?: AgentSession | null;\n  bars?: number;\n  width?: number;\n  height?: number;\n  className?: string;\n}\n\n/**\n * Frequency bars for the agent's voice, drawn from the session's analyser data\n * (no transport objects involved). Colors follow CSS `color` on the canvas.\n */\nexport function AgentAudioVisualizer({\n  session,\n  bars = 24,\n  width = 240,\n  height = 64,\n  className,\n}: AgentAudioVisualizerProps): ReactElement {\n  const context = useOptionalAgentSessionContext();\n  const active = session !== undefined ? session : (context?.session ?? null);\n  const canvasRef = useRef<HTMLCanvasElement | null>(null);\n\n  useEffect(() => {\n    const canvas = canvasRef.current;\n    if (!canvas || !active) {\n      return;\n    }\n    const context2d = canvas.getContext(\"2d\");\n    if (!context2d) {\n      return;\n    }\n\n    let frame = 0;\n    const draw = () => {\n      const data = active.getOutputFrequencyData();\n      context2d.clearRect(0, 0, canvas.width, canvas.height);\n      context2d.fillStyle = getComputedStyle(canvas).color;\n      const barWidth = canvas.width / bars;\n      for (let index = 0; index < bars; index += 1) {\n        const sample = data.length\n          ? (data[Math.floor((index / bars) * data.length)] ?? 0) / 255\n          : 0;\n        const barHeight = Math.max(2, sample * canvas.height);\n        context2d.fillRect(\n          index * barWidth + barWidth * 0.15,\n          (canvas.height - barHeight) / 2,\n          barWidth * 0.7,\n          barHeight,\n        );\n      }\n      frame = requestAnimationFrame(draw);\n    };\n    frame = requestAnimationFrame(draw);\n    return () => {\n      cancelAnimationFrame(frame);\n    };\n  }, [active, bars]);\n\n  return <canvas ref={canvasRef} width={width} height={height} className={className} />;\n}\n","export { useConversation, type ConversationStatus, type UseConversationReturn } from \"./useConversation.js\";\nexport {\n  AgentSessionProvider,\n  useAgentSessionContext,\n  useOptionalAgentSessionContext,\n  type AgentSessionProviderProps,\n} from \"./provider.js\";\nexport { useAgentMessages, type ChatMessage } from \"./useAgentMessages.js\";\nexport { useAudioLevels, type AudioLevels } from \"./useAudioLevels.js\";\nexport {\n  AgentAudioVisualizer,\n  type AgentAudioVisualizerProps,\n} from \"./AgentAudioVisualizer.js\";\n// Convenience re-exports so app code can stay on one import.\nexport {\n  AgentSession,\n  FishAgentError,\n  type AgentMode,\n  type AgentSessionOptions,\n  type ConversationMessage,\n  type EndReason,\n  type SessionStatus,\n  type SessionToken,\n  type TranscriptSegment,\n} from \"@fishaudio/agent-client\";\n"],"mappings":"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","names":["useEffect","useState","useState","useEffect","useEffect","useState","useState","useEffect","useEffect","useRef","jsx","useRef","useEffect","AgentSession"]}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@fishaudio/agent-react",
+  "version": "0.0.1",
+  "description": "React hooks and components for Fish Audio voice agents.",
+  "keywords": [
+    "fish-audio",
+    "voice",
+    "agent",
+    "react",
+    "hooks",
+    "webrtc"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fishaudio/fish-agent-sdk-web.git",
+    "directory": "packages/react"
+  },
+  "homepage": "https://github.com/fishaudio/fish-agent-sdk-web/tree/main/packages/react#readme",
+  "bugs": "https://github.com/fishaudio/fish-agent-sdk-web/issues",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@fishaudio/agent-client": "^0.0.1"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.0",
+    "@types/react": "^19.1.0",
+    "jsdom": "^26.1.0",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.5"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}