@autoark-ai/eva-client-sdk-ts 0.0.2-dev

package/GATEWAY_TERMS.md

@@ -0,0 +1,11 @@
+# AutoArk AI Gateway Service Notice
+
+Version 1.0 — Effective Date: July 20, 2026
+
+The official Eva Gateway is a hosted service separate from the Eva Client SDK. The SDK license does not grant any right to access or use the Gateway.
+
+Access to and use of the Gateway are governed by the terms and policies published on the official AutoArk AI website:
+
+https://autoarkai.com/
+
+Do not access or use the Gateway if you do not agree to those terms and policies.

package/LICENSE

@@ -0,0 +1,100 @@
+# AutoArk AI Proprietary SDK License Agreement
+
+Version 1.0 — Effective Date: July 20, 2026
+
+This Proprietary SDK License Agreement (the “Agreement”) governs your use of the Eva Client SDK package published as `@autoark-ai/eva-client-sdk-ts` (the “SDK”). “Licensor” means AutoArk AI and the legal entity identified as the SDK publisher or operator on the applicable official website, order form, or service console. “You” or “Licensee” means the individual or entity that downloads, installs, copies, or uses the SDK.
+
+By downloading, installing, copying, or using the SDK, You accept this Agreement. If You use the SDK for an entity, You represent that You have authority to bind that entity. If You do not agree, do not use the SDK.
+
+## 1. Definitions
+
+- “Application” means a software product or service developed and controlled by Licensee that incorporates the SDK for use as part of that product or service.
+- “Compiled Output” means JavaScript bundles or other executable artifacts produced from an unmodified SDK through the Permitted Build Operations in Section 3.
+- “Official Gateway” means the Eva Gateway endpoints selected and embedded by Licensor in an authorized SDK release.
+- “Third-Party Components” means software or model assets identified in `THIRD_PARTY_NOTICES.md`.
+
+## 2. Limited License Grant
+
+Subject to continuous compliance with this Agreement, Licensor grants Licensee a free-of-charge, non-exclusive, non-transferable, non-sublicensable, revocable, limited license to:
+
+1. install and use the SDK solely to develop, test, operate, and maintain Licensee’s Applications;
+2. integrate the SDK into Licensee’s Applications; and
+3. reproduce and distribute Compiled Output solely as an inseparable part of Licensee’s Applications to Licensee’s end users.
+
+No right is granted to distribute the SDK as a standalone product or to make the SDK available for use independently from an Application. This license does not include any right to access or use the Official Gateway; Gateway access is governed separately under Section 5.
+
+## 3. Permitted Build Operations
+
+The following ordinary build operations do not violate the prohibition on modification, provided they are performed only to incorporate the SDK into an Application and do not alter its functional behavior, security controls, Gateway binding, notices, or license terms:
+
+- compilation or transpilation;
+- linking and module resolution;
+- bundling;
+- minification and compression;
+- Tree Shaking and dead-code elimination;
+- code signing; and
+- format conversion reasonably necessary to package or deploy the Application.
+
+The resulting artifact remains subject to this Agreement. This Section does not permit source-level functional changes, patching, instrumentation intended to expose internal interfaces, removal of protections, or creation of a substitute or derivative SDK.
+
+## 4. Restrictions
+
+Except for the rights expressly granted in Sections 2 and 3, Licensee shall not, and shall not enable or assist any third party to:
+
+1. modify, adapt, translate, patch, or create derivative works of the SDK;
+2. reverse engineer, decompile, disassemble, decode, or otherwise attempt to discover the source code, internal protocols, non-public interfaces, models, keys, or underlying ideas of the SDK;
+3. separately publish, redistribute, sell, resell, sublicense, rent, lease, lend, host, time-share, or provide the SDK as a service or managed component;
+4. remove, obscure, or alter any copyright, proprietary, attribution, security, or license notice;
+5. bypass, disable, defeat, or interfere with any technical restriction, usage control, authentication, metering, or security mechanism;
+6. use the SDK, when initiating or participating in large-model or other model inference, with any endpoint other than the Official Gateway;
+7. bypass, replace, proxy, redirect, imitate, emulate, or simulate the Official Gateway, including by reproducing its protocol for production or commercial inference;
+8. use the SDK to develop, benchmark for publication, or provide a competing SDK, Gateway, model-routing service, or substantially similar substitute; or
+9. use the SDK in violation of applicable law, sanctions, export controls, third-party rights, or the terms published for the Official Gateway.
+
+Any right not expressly granted is reserved by Licensor.
+
+Item 7 does not prohibit local test doubles that perform no model inference and do not bypass authentication, metering, security controls, or the Official Gateway requirement in production.
+
+## 5. Gateway Services Are Separate
+
+The SDK and the Official Gateway are separate offerings. This Agreement governs only the SDK. Access to and use of the Official Gateway are governed separately as stated in `GATEWAY_TERMS.md`.
+
+## 6. Distribution Conditions
+
+Licensee may distribute Compiled Output under Section 2 only if:
+
+1. the Compiled Output is an inseparable part of an Application with material independent functionality;
+2. the Application does not expose the SDK for standalone use, extraction, or reuse;
+3. Licensee does not represent that it owns the SDK or grant recipients broader rights in the SDK than this Agreement permits;
+4. all proprietary and Third-Party Component notices remain intact where technically included; and
+5. Licensee is solely responsible for its Application, end-user terms, privacy disclosures, security, support, and legal compliance.
+
+## 7. Third-Party Components
+
+Third-Party Components are licensed under the separate terms identified in `THIRD_PARTY_NOTICES.md`. Those terms apply only to the identified components and do not make the SDK as a whole open source or expand the license granted under this Agreement. If a third-party license directly conflicts with this Agreement for that component, the third-party license controls only for that component.
+
+## 8. Ownership and Feedback
+
+The SDK is licensed, not sold. As between Licensor and Licensee, Licensor and its licensors retain all right, title, and interest in and to the SDK, its architecture, non-public interfaces, updates, documentation, trademarks, and all related intellectual property. Licensee retains ownership of its Application, excluding the SDK and Third-Party Components.
+
+If Licensee voluntarily provides suggestions or feedback, Licensee grants Licensor a perpetual, irrevocable, worldwide, royalty-free right to use and incorporate that feedback without restriction or obligation.
+
+## 9. Updates and Compatibility
+
+Licensor may update, replace, limit, or discontinue the SDK or any feature. Unless Licensor expressly states otherwise, Licensor has no obligation to provide maintenance, support, backward compatibility, security updates, or any particular release. A new SDK version may include updated terms presented with that version; continued use of the new version constitutes acceptance of those terms.
+
+## 10. Term and Termination
+
+This Agreement begins when Licensee first downloads, installs, copies, or uses the SDK and continues until terminated. Licensor may revoke or terminate the license immediately if Licensee breaches this Agreement, creates security or legal risk, fails to comply with applicable Gateway terms, or if continued distribution is prohibited by law. Licensor may otherwise revoke the license on at least 30 days’ notice.
+
+Upon termination, Licensee shall stop using and distributing the SDK, stop publishing new or updated Applications containing the SDK or Compiled Output, and delete all SDK copies under its control, except copies retained solely where required by law. End users may continue using Compiled Output lawfully distributed before termination, unless continued operation is prohibited by law or the termination notice identifies a specific security or legal risk that requires it to stop. Sections 4, 7, 8, 10, and 11 survive termination.
+
+## 11. Governing Law and General Terms
+
+This Agreement is governed by the laws of the People’s Republic of China, excluding its conflict-of-law rules. Any dispute that cannot be resolved through good-faith negotiation shall be submitted to the competent people’s court at Licensor’s domicile, except where mandatory law requires otherwise.
+
+If any provision is unenforceable, it shall be enforced to the maximum lawful extent and the remaining provisions remain effective. Failure to enforce a provision is not a waiver. Licensee may not assign this Agreement by contract, merger, change of control, or operation of law without Licensor’s prior written consent. Licensor may assign this Agreement as part of a reorganization, financing, or transfer of the SDK business.
+
+This Agreement, together with documents expressly incorporated into it, is the entire agreement about the SDK and supersedes prior discussions about the SDK license. Gateway services remain governed separately. Headings are for convenience only.
+
+Questions about this Agreement must be directed through the legal or support contact published on the official AutoArk AI website or Gateway console.

package/README.md

@@ -0,0 +1,344 @@
+# Eva TypeScript SDK
+
+`@autoark-ai/eva-client-sdk-ts` 是浏览器优先的 Eva 多轮语音对话 SDK。它提供一个稳定的 Agent Facade、可观察的消息与事件，以及可替换的音频输入、输出、AEC 和摄像头扩展点。
+
+## 安装
+
+当前预发布版本通过 `dev` dist-tag 提供：
+
+```bash
+npm install @autoark-ai/eva-client-sdk-ts@dev
+```
+
+请固定生产应用实际验收过的完整 package version；不要把 `dev` dist-tag 当作稳定性承诺。
+
+## 环境要求
+
+- 前端构建环境要求 Node.js `>=20`。
+- 浏览器运行已在 Chromium-based browsers、Safari 验证。
+
+## 版本与 Gateway 环境
+
+候选版本使用 `<代码版本>-<成熟度>.<Gateway环境>`：`alpha`、`beta`、`rc` 表示成熟度，`dev`、`prod` 表示制品内建的并行 Gateway 环境。例如 `X.Y.Z-alpha.dev` 调用 dev Gateway，`X.Y.Z-alpha.prod` 调用 prod Gateway；正式代码的 dev 制品使用 `X.Y.Z-dev`，正式 prod 制品使用 `X.Y.Z`。
+
+每个完整 package version 只对应一组内建 endpoint 和一份确定制品。Gateway 环境不能通过 Agent 配置改写；需要切换环境时应使用对应版本的 SDK 包。
+
+包只提供三个入口：
+
+```ts
+import {
+  createEvaVoiceDialogueAgent,
+  EvaSdkError,
+  type AgentEvent,
+  type ConversationMessage,
+  type EvaVoiceDialogueAgent,
+  type EvaVoiceDialogueAgentConfig,
+} from "@autoark-ai/eva-client-sdk-ts";
+
+import type {
+  AecProcessor,
+  AudioInputSource,
+  AudioOutputSink,
+  CameraSnapshotSource,
+  MediaTransportsConfig,
+} from "@autoark-ai/eva-client-sdk-ts/spi";
+
+import {
+  createBrowserAudioInputSource,
+  createBrowserAudioOutputSink,
+  createBrowserCameraSnapshotSource,
+  createPassthroughAecProcessor,
+} from "@autoark-ai/eva-client-sdk-ts/browser";
+```
+
+## 浏览器最小用法
+
+下面的 model 与 voice 组合已在 browser example 验证：
+
+```ts
+import {
+  createEvaVoiceDialogueAgent,
+  type AgentEvent,
+} from "@autoark-ai/eva-client-sdk-ts";
+import type { MediaTransportsConfig } from "@autoark-ai/eva-client-sdk-ts/spi";
+import {
+  createBrowserAudioInputSource,
+  createBrowserAudioOutputSink,
+  createBrowserCameraSnapshotSource,
+  createPassthroughAecProcessor,
+} from "@autoark-ai/eva-client-sdk-ts/browser";
+
+const transports: MediaTransportsConfig = {
+  input: createBrowserAudioInputSource({
+    echoCancellation: true,
+    noiseSuppression: true,
+    autoGainControl: true,
+    maxBufferedChunks: 64,
+  }),
+  output: createBrowserAudioOutputSink(),
+  aec: createPassthroughAecProcessor(),
+  camera: createBrowserCameraSnapshotSource({
+    video: { facingMode: { ideal: "environment" } },
+    mimeType: "image/png",
+  }),
+};
+
+const agent = createEvaVoiceDialogueAgent({
+  apiKey: applicationManagedApiKey,
+  asr: {
+    model: "ark_asr_3b",
+    sampleRate: 16_000,
+  },
+  llm: {
+    model: "qiduoduo_chat_vlm",
+  },
+  tts: {
+    model: "cosyvoice_tts",
+    voice: "longjielidou_v3",
+    sampleRate: 48_000,
+  },
+  vad: {
+    sensitivity: 0.6,
+    silenceThresholdMs: 400,
+  },
+  transports,
+  history: { maxTurns: 10 },
+  camera: { captureTimeoutMs: 1500 },
+});
+
+const unsubscribe = agent.onEvent((event: AgentEvent) => {
+  if (event.type === "reply.partial") {
+    console.log(event.text);
+  }
+});
+
+await agent.start();
+await agent.setAudioInputEnabled(true);
+// 摄像头默认关闭；需要时显式开启，开启期间持续持有一个 session。
+await agent.setCameraCaptureEnabled(true);
+await agent.submitText("你好");
+
+console.log(agent.getMessages());
+
+await agent.setTtsEnabled(false);
+await agent.stop();
+unsubscribe();
+```
+
+## Agent Facade
+
+`createEvaVoiceDialogueAgent(config)` 返回的 `EvaVoiceDialogueAgent` 只有八个方法：
+
+```ts
+interface EvaVoiceDialogueAgent {
+  start(): Promise<void>;
+  submitText(text: string, options?: SubmitTextOptions): Promise<void>;
+  setAudioInputEnabled(enabled: boolean): Promise<void>;
+  setCameraCaptureEnabled(enabled: boolean): Promise<void>;
+  setTtsEnabled(enabled: boolean): Promise<void>;
+  getMessages(): readonly ConversationMessage[];
+  onEvent(listener: AgentEventListener): Unsubscribe;
+  stop(): Promise<void>;
+}
+```
+
+| 方法 | created | running | stopped |
+|---|---|---|---|
+| `start()` | 启动 Agent；并发调用共享结果 | 幂等 | 拒绝 |
+| `submitText()` | 拒绝 | 提交文本 turn，可打断当前 turn | 拒绝 |
+| `setAudioInputEnabled()` | 设置初始麦克风状态 | 开启或关闭后续音频输入 | 拒绝 |
+| `setCameraCaptureEnabled()` | 设置初始摄像头状态，默认关闭 | 开启或关闭持续 camera session | 拒绝 |
+| `setTtsEnabled()` | 设置初始 TTS 状态 | 控制后续合成与播放 | 拒绝 |
+| `getMessages()` | 返回空快照 | 返回当前最终消息快照 | 仍可读取 |
+| `onEvent()` | 可订阅 | 可订阅 | 同步拒绝新订阅 |
+| `stop()` | 进入终态 | 完成收尾后进入终态 | 幂等 |
+
+Agent 一旦开始停止，就不再接受新的 turn 或事件订阅。需要新会话时，请创建新的 Agent。
+
+## 配置
+
+`EvaVoiceDialogueAgentConfig` 的公共字段如下：
+
+| 字段 | 必填 | 说明 |
+|---|---:|---|
+| `apiKey` | 是 | 应用提供并管理的 Eva Gateway AK |
+| `asr.model` | 是 | ASR model 标识 |
+| `asr.sampleRate` | 是 | ASR 接收的目标 PCM 采样率，必须为正整数 |
+| `llm.model` | 是 | LLM model 标识 |
+| `llm.temperature` | 否 | 采样温度 |
+| `llm.maxTokens` | 否 | 最大生成 token 数 |
+| `tts.model` | 是 | TTS model 标识 |
+| `tts.voice` | 否 | voice 标识 |
+| `tts.speakingRate` | 否 | 语速 |
+| `tts.pitch` | 否 | 音调倍率 |
+| `tts.sampleRate` | 否 | TTS 输出采样率，默认 `16000` |
+| `vad.sensitivity` | 否 | 语音概率阈值，默认 `0.5` |
+| `vad.silenceThresholdMs` | 否 | 判定停止说话所需的连续静音时间，默认 `200` ms |
+| `systemPrompt` | 否 | 每次 LLM 请求使用的系统指令 |
+| `greeting` | 否 | `disabled`、`static` 或 `dynamic` greeting |
+| `history.maxTurns` | 否 | LLM 上下文保留的已完成轮数 |
+| `camera.captureTimeoutMs` | 否 | 单次采图等待上限，默认 `1500` ms |
+| `metadata` | 否 | JSON-compatible Agent metadata |
+| `transports` | 否 | 完整的 `input`、`output`、`aec` 与可选 `camera` 组合；省略时为纯文本 Agent |
+
+当配置 `transports.input` 时，应同时提供 `vad`。`submitText()` 可通过 `SubmitTextOptions` 指定 `turnId` 和当前 turn 的 `metadata`。
+
+## 消息
+
+`getMessages()` 同步返回按提交顺序排列的只读快照。每条 `ConversationMessage` 包含：
+
+```ts
+interface ConversationMessage {
+  readonly id: string;
+  readonly turnId: string;
+  readonly role: "user" | "assistant";
+  readonly content: string;
+  readonly createdAt: number;
+  readonly metadata: JsonObject;
+}
+```
+
+user 与 assistant 的最终文本才会进入消息列表。同一轮的两条消息共享 `turnId`。`history.maxTurns` 只控制送给 LLM 的上下文，不会裁剪 `getMessages()` 的会话记录。
+
+## 事件
+
+`onEvent()` 接收 `AgentEvent` discriminated union。`AgentEventType` 是 type-only 字符串联合：
+
+| `type` | 主要字段 | 含义 |
+|---|---|---|
+| `speech.started` | — | 检测到开始说话 |
+| `image.captured` | `image` | 当前语音 turn 已在本地成功采图；不表示模型已接受图片 |
+| `speech.stopped` | — | 检测到停止说话 |
+| `transcript.partial` | `text`, `source: "speech"` | 增量转写 |
+| `transcript.final` | `text`, `source` | 最终用户文本 |
+| `interruption` | `reason` | 用户语音或手动文本打断当前 turn |
+| `reply.started` | — | assistant 开始回复 |
+| `reply.partial` | `text` | 新增回复片段 |
+| `reply.final` | `text` | 完整最终回复 |
+| `playback.started` | — | TTS 开始播放 |
+| `playback.stopped` | — | TTS 停止播放 |
+| `turn.latency` | `latency` | turn 总耗时与可用的阶段耗时 |
+| `error` | `error` | 可交给应用处理的结构化错误 |
+
+所有事件都有 `streamId`、`partial`、`final` 和只读 `metadata`；除无法定位 turn 的错误外都有 `turnId`。还可能包含 `sequence`、`timestamp` 和 `frameId`。
+
+建议用穷尽 switch 消费事件：
+
+```ts
+function consume(event: AgentEvent): void {
+  switch (event.type) {
+    case "speech.started":
+    case "image.captured":
+    case "speech.stopped":
+    case "reply.started":
+    case "playback.started":
+    case "playback.stopped":
+      return;
+    case "transcript.partial":
+    case "transcript.final":
+    case "reply.partial":
+    case "reply.final":
+      console.log(event.text);
+      return;
+    case "interruption":
+      console.log(event.reason);
+      return;
+    case "turn.latency":
+      console.log(event.latency);
+      return;
+    case "error":
+      console.error(event.error);
+      return;
+    default:
+      event satisfies never;
+  }
+}
+```
+
+## 错误
+
+同步输入校验和 lifecycle 错误会抛出 `EvaSdkError`。事件中的 `StructuredError` 提供：
+
+```ts
+interface StructuredError {
+  message: string;
+  fatal: boolean;
+  source: "sdk" | "provider" | "gateway" | "media";
+  provider?: string;
+  statusCode?: number;
+  role?: "audio-input" | "audio-output" | "aec" | "camera";
+  operation?: "start" | "capture" | "stop";
+  reason?: "not_configured" | "permission_denied" | "device_unavailable" | "unsupported" | "timeout" | "invalid_data" | "operation_failed";
+}
+```
+
+事件和错误不会额外回显 AK、Authorization header 或原始 provider 响应。
+
+## 可扩展 Media SPI
+
+音频输入、音频输出、AEC 和摄像头都是可替换的公共扩展点。应用可以直接使用 SDK 提供的浏览器默认实现，也可以按角色接入自己的实现。
+
+扩展契约从 `@autoark-ai/eva-client-sdk-ts/spi` 导入：
+
+- **输入 `AudioInputSource`**：负责采集音频，通过 `frames()` 以 `AsyncIterable<AudioChunk>` 持续产出数据；适合接入浏览器麦克风、原生采集桥、文件或其它实时音频源。
+- **输出 `AudioOutputSink`**：负责接收并播放音频，通过 `enqueue()`、`flush()`、`drain()` 和 `stop()` 管理队列与播放生命周期；可以替换为自定义播放器或原生音频输出。
+- **AEC `AecProcessor`**：接收 far-end 播放音频，并在 near-end 输入进入对话链路前处理回声；可以使用 passthrough、平台 AEC 或应用自带的软件 AEC。
+- **摄像头 `CameraSnapshotSource`**：以必需 `AbortSignal` 管理 `start()` / `capture()`，并通过幂等 `stop()` 释放 session；snapshot 只含图片 bytes、MIME 和实际尺寸。
+
+四个角色可以分别替换；其中 `input`、`output` 与 `aec` 是 `MediaTransportsConfig` 必填项，`camera` 可选。构造 Agent 后，已装配对象的 lifecycle 由 Agent 独占驱动，应用不应再并发调用这些对象。
+
+```ts
+import type {
+  AecProcessor,
+  AudioInputSource,
+  AudioOutputSink,
+  CameraSnapshotSource,
+  MediaTransportsConfig,
+} from "@autoark-ai/eva-client-sdk-ts/spi";
+
+declare const customInput: AudioInputSource;
+declare const customOutput: AudioOutputSink;
+declare const customAec: AecProcessor;
+declare const customCamera: CameraSnapshotSource;
+
+const customTransports: MediaTransportsConfig = {
+  input: customInput,
+  output: customOutput,
+  aec: customAec,
+  camera: customCamera,
+};
+```
+
+## SDK 提供的浏览器默认实现
+
+如果不需要自定义媒体链路，可以从 `@autoark-ai/eva-client-sdk-ts/browser` 直接使用 SDK 提供的四个默认 factory：
+
+| 角色 | 默认 factory | 行为 |
+|---|---|---|
+| 输入 | `createBrowserAudioInputSource()` | 使用浏览器麦克风采集音频 |
+| 输出 | `createBrowserAudioOutputSink()` | 使用 Web Audio 播放 TTS 音频 |
+| AEC | `createPassthroughAecProcessor()` | 不做软件回声处理，由浏览器和操作系统负责 AEC |
+| 摄像头 | `createBrowserCameraSnapshotSource()` | 持续持有 video session，并在语音开始时采一张 PNG/JPEG |
+
+```ts
+const defaultTransports: MediaTransportsConfig = {
+  input: createBrowserAudioInputSource({ echoCancellation: true }),
+  output: createBrowserAudioOutputSink(),
+  aec: createPassthroughAecProcessor(),
+  camera: createBrowserCameraSnapshotSource(),
+};
+```
+
+摄像头 factory 只是 `CameraSnapshotSource` 的默认浏览器实现，不会被 agent factory 自动补齐。不开启 camera 时不会申请摄像头权限；开启后可以直接问“图片里有什么”。图片只参与当前 LLM 请求，不进入 `getMessages()` 或后续 history。摄像头权限、设备、超时或本地采图失败会通过结构化 `media` error 可观测，并以纯文本继续当前 turn；已经发出的多模态请求若被模型拒绝，则按普通 gateway/provider error 结束，不会移除图片再做纯文本重试。
+
+默认组合开启浏览器 input 的 `echoCancellation`，同时使用 passthrough AEC。如果接入自己的软件 AEC，应将 `echoCancellation` 设为 `false`，避免平台 AEC 与软件 AEC 重复处理。
+
+## AK 责任边界
+
+`apiKey` 由应用提供和管理。只要 AK 进入浏览器应用，最终用户就可能通过开发者工具观察到它；SDK 不提供浏览器端秘密存储。SDK 的边界是不会通过公共事件、错误、metadata 或配置读取接口再次暴露 AK。
+
+## 许可与 Gateway 服务
+
+本 SDK 是公开下载的专有软件，并非开源软件。安装或使用 SDK 即表示接受 [Proprietary SDK License Agreement](LICENSE)：其中允许在应用中集成 SDK、执行正常的打包/压缩/Tree Shaking 等构建操作，并在应用内分发编译产物；禁止修改、逆向工程、制作衍生 SDK、单独再分发或绕过/替换/模拟官方 Gateway。
+
+SDK 许可不包含 Gateway 使用权，也不承诺 Gateway 免费或无限使用；Gateway 适用规则见独立的 [Gateway Service Notice](GATEWAY_TERMS.md)。第三方软件与模型资产适用 [Third-Party Notices](THIRD_PARTY_NOTICES.md) 中列明的各自许可。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,116 @@
+# Third-Party Notices
+
+This package redistributes or relies on the third-party components listed below. The notices and
+license terms in this file apply only to those components, not to the Eva SDK as a whole.
+
+## Silero VAD v6.2.1 ONNX model
+
+Source: `https://github.com/snakers4/silero-vad/blob/v6.2.1/src/silero_vad/data/silero_vad.onnx`
+
+Redistributed as: `dist/assets/silero_vad_v6.onnx`
+
+SHA-256: `1a153a22f4509e292a94e67d6f9b85e8deb25b4988682b7e174c65279d8788e3`
+
+MIT License
+
+Copyright (c) 2020-present Silero Team
+
+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.
+
+## ONNX Runtime Web 1.26.0
+
+Source: `https://github.com/microsoft/onnxruntime/tree/v1.26.0/js/web`
+
+Distributed as the exact direct dependency `onnxruntime-web@1.26.0`.
+
+MIT License
+
+Copyright (c) Microsoft Corporation
+
+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.
+
+## @alexanderolsen/libsamplerate-js 2.1.2
+
+Distributed as the exact direct dependency `@alexanderolsen/libsamplerate-js@2.1.2`.
+
+MIT License
+
+Copyright (c) 2021 Alexander Olsen
+
+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.
+
+### Embedded libsamplerate (Secret Rabbit Code)
+
+2-clause BSD License
+
+Copyright (c) 2012-2016, Erik de Castro Lopo <erikd@mega-nerd.com>
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice,
+   this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.

package/dist/browser.d.ts

@@ -0,0 +1,84 @@
+import type { AecProcessor, AudioInputSource, AudioOutputSink, CameraSnapshotSource } from "./spi.js";
+/** Options for the SDK-provided browser microphone input. */
+export interface BrowserAudioInputOptions {
+    /**
+     * Maximum encoded chunks buffered before the current capture session fails.
+     * @defaultValue 128
+     * @remarks Must be a positive integer.
+     */
+    maxBufferedChunks?: number;
+    /**
+     * Requests platform echo cancellation through `getUserMedia`.
+     * @defaultValue true
+     * @remarks The browser or device may ignore this constraint. Disable it when using active software AEC.
+     */
+    echoCancellation?: boolean;
+    /**
+     * Requests platform noise suppression through `getUserMedia`.
+     * @defaultValue true
+     * @remarks The browser or device may ignore this constraint.
+     */
+    noiseSuppression?: boolean;
+    /**
+     * Requests platform automatic gain control through `getUserMedia`.
+     * @defaultValue true
+     * @remarks The browser or device may ignore this constraint.
+     */
+    autoGainControl?: boolean;
+}
+/**
+ * Creates the SDK-provided browser microphone implementation of `AudioInputSource`.
+ * The dialogue runtime owns `start()` / `frames()` / `stop()` after agent construction.
+ */
+export declare function createBrowserAudioInputSource(options?: BrowserAudioInputOptions): AudioInputSource;
+/**
+ * Creates the SDK-provided browser playback implementation of `AudioOutputSink`.
+ * It initializes Web Audio lazily on the first `enqueue()` call.
+ */
+export declare function createBrowserAudioOutputSink(): AudioOutputSink;
+/** Options for the SDK-provided browser still-camera source. */
+export interface BrowserCameraSnapshotOptions {
+    /**
+     * Native video track constraints passed to `getUserMedia`.
+     * @defaultValue `true`
+     * @remarks The browser may adapt or ignore individual ideal constraints.
+     */
+    video?: MediaTrackConstraints;
+    /**
+     * Requested still-image encoding.
+     * @defaultValue `image/png`
+     */
+    mimeType?: "image/png" | "image/jpeg";
+    /**
+     * JPEG encoder quality from 0 through 1.
+     * @remarks Used only when `mimeType` is `image/jpeg`. Omit to use the browser default.
+     */
+    jpegQuality?: number;
+}
+/**
+ * Creates the SDK-provided browser implementation of `CameraSnapshotSource`.
+ *
+ * @remarks
+ * The factory does not request permission. After composition, the runtime exclusively owns
+ * `start`/`capture`/`stop`: `start` requests one continuously held video-only session and
+ * resolves after a drawable frame is ready; `capture` encodes one frame from that same session;
+ * `stop` waits for pending acquisition/encoding and releases every track and element reference.
+ * The helper permits only one session and one in-flight capture.
+ *
+ * Abort rejects the outward `start`/`capture` promptly, but the helper retains cleanup ownership:
+ * a late MediaStream is stopped and a late encoded Blob is discarded. The runtime applies the
+ * fixed 1500ms cancellation settlement deadline; a non-settling operation or unconfirmed release
+ * faults the camera role and later camera controls reject deterministically. A successful `stop`
+ * permits a later sequential restart.
+ *
+ * @param options - Browser video constraints and still-image encoding preferences. Omit to use
+ * the default video device and PNG encoding at the captured frame's native dimensions.
+ * @returns A reusable `CameraSnapshotSource` to pass as `MediaTransportsConfig.camera`.
+ */
+export declare function createBrowserCameraSnapshotSource(options?: BrowserCameraSnapshotOptions): CameraSnapshotSource;
+/**
+ * Creates the default no-op `AecProcessor` for platform-managed echo cancellation.
+ * Use an active custom AEC implementation instead when platform AEC is disabled.
+ */
+export declare function createPassthroughAecProcessor(): AecProcessor;
+export {};