@fishaudio/agent-client 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,45 @@
+# @fishaudio/agent-client
+
+Framework-agnostic JavaScript/TypeScript SDK for embedding [Fish Audio](https://fish.audio) voice agents into any website or web app: realtime voice over WebRTC, live transcripts, text input, and client tools — behind one small, event-driven API.
+
+Using React? [`@fishaudio/agent-react`](https://github.com/fishaudio/fish-agent-sdk-web/tree/main/packages/react) wraps this SDK in hooks and components.
+
+## Installation
+
+```bash
+npm install @fishaudio/agent-client
+```
+
+## Quickstart
+
+```js
+import { AgentSession } from "@fishaudio/agent-client";
+
+// Session token from your backend — or { agentId } for a public agent.
+const sessionToken = await fetch("/api/voice-session", { method: "POST" }).then((r) => r.json());
+
+const session = await AgentSession.start({
+  sessionToken,
+  callbacks: {
+    onModeChange: (mode) => setOrbState(mode), // "listening" | "thinking" | "speaking"
+    onMessage: ({ role, text }) => renderChatBubble(role, text),
+    onDisconnect: ({ reason }) => showCallEnded(reason),
+  },
+});
+
+// Later:
+session.sendUserMessage("Can you summarize that?");
+await session.end();
+```
+
+Starting a session requests microphone access; call `start()` from a user gesture (button click) for the best permission and autoplay behavior.
+
+## Documentation
+
+- [Quickstart](https://github.com/fishaudio/fish-agent-sdk-web/blob/main/docs/quickstart.md) — first call, with or without a backend.
+- [Authentication](https://github.com/fishaudio/fish-agent-sdk-web/blob/main/docs/authentication.md) — server-created session tokens vs. public agents.
+- [Sessions](https://github.com/fishaudio/fish-agent-sdk-web/blob/main/docs/sessions.md) — `start()` options, the session API, lifecycle and reconnection.
+- [Events](https://github.com/fishaudio/fish-agent-sdk-web/blob/main/docs/events.md) — event reference and live transcripts.
+- [Client tools](https://github.com/fishaudio/fish-agent-sdk-web/blob/main/docs/client-tools.md) — let the agent call functions in the browser.
+- [Customization](https://github.com/fishaudio/fish-agent-sdk-web/blob/main/docs/customization.md) — per-session overrides and dynamic variables.
+- [Errors](https://github.com/fishaudio/fish-agent-sdk-web/blob/main/docs/errors.md) — `FishAgentError` codes.

package/dist/chunk-PEVOZB5Y.js

@@ -0,0 +1,36 @@
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+var __privateWrapper = (obj, member, setter, getter) => ({
+  set _(value) {
+    __privateSet(obj, member, value, setter);
+  },
+  get _() {
+    return __privateGet(obj, member, getter);
+  }
+});
+
+// src/errors.ts
+var FishAgentError = class extends Error {
+  constructor(code, message, options) {
+    super(message, options?.cause !== void 0 ? { cause: options.cause } : void 0);
+    this.name = "FishAgentError";
+    this.code = code;
+    this.statusCode = options?.statusCode;
+  }
+};
+
+export {
+  __privateGet,
+  __privateAdd,
+  __privateSet,
+  __privateMethod,
+  __privateWrapper,
+  FishAgentError
+};
+//# sourceMappingURL=chunk-PEVOZB5Y.js.map

package/dist/chunk-PEVOZB5Y.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts"],"sourcesContent":["export type FishAgentErrorCode =\n  | \"session_request_failed\"\n  | \"agent_not_public\"\n  | \"origin_forbidden\"\n  | \"unsupported_transport\"\n  | \"mic_permission_denied\"\n  /** A requested audio device could not be activated, or the browser does not support selecting it. */\n  | \"device_change_failed\"\n  | \"connection_failed\"\n  | \"session_expired\"\n  | \"tool_failed\"\n  | \"tool_timeout\"\n  /** An upstream model/speech provider failed during the session. */\n  | \"provider_error\"\n  /** The agent runtime hit an internal error. */\n  | \"internal_error\";\n\nexport class FishAgentError extends Error {\n  readonly code: FishAgentErrorCode;\n  /** HTTP status of the failing session request, when the error originated there. */\n  readonly statusCode?: number;\n\n  constructor(\n    code: FishAgentErrorCode,\n    message: string,\n    options?: { statusCode?: number; cause?: unknown },\n  ) {\n    super(message, options?.cause !== undefined ? { cause: options.cause } : undefined);\n    this.name = \"FishAgentError\";\n    this.code = code;\n    this.statusCode = options?.statusCode;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAiBO,IAAM,iBAAN,cAA6B,MAAM;AAAA,EAKxC,YACE,MACA,SACA,SACA;AACA,UAAM,SAAS,SAAS,UAAU,SAAY,EAAE,OAAO,QAAQ,MAAM,IAAI,MAAS;AAClF,SAAK,OAAO;AACZ,SAAK,OAAO;AACZ,SAAK,aAAa,SAAS;AAAA,EAC7B;AACF;","names":[]}