@dialt/sdk 0.23.0

package/CHANGELOG.md

@@ -0,0 +1,336 @@
+# Changelog
+
+## 0.23.0
+
+- The package is now published as `@dialt/sdk`; `@trelis/converse` is deprecated.
+- Package metadata and documentation now point to Dialt and
+  [`dialt-ai/dialt`](https://github.com/dialt-ai/dialt).
+- The runtime API and wire protocol are unchanged.
+
+## 0.22.1
+
+- `startMic()` and the WebRTC track feeder retry their packaged source worklet when a CDN-transformed
+  SDK entry cannot load its sibling asset. This fixes esm.sh imports, where the transformed entry
+  lives under `es2022/` while the worklets remain under `es2022/src/`.
+
+## 0.22.0
+
+- Playback-health telemetry: the player counts mid-reply underruns (queue drained at the
+  speaker) and, at each reply's `done`, the client sends
+  `{"type":"client_event","event":"playback_report", underruns, starved_ms, max_gap_ms, turn_id}`
+  over WebSocket transports. No behaviour change: buffering is untouched; the report is
+  record-only on the server and sizes the jitter buffer from real sessions. Not sent over
+  WebRTC, where the browser owns the jitter buffer.
+
+## 0.21.1
+
+- Removed `playAcknowledgements` and the `ack` frame handler: the server does not send assistant
+  backchannel clips yet (roadmap, not shipped), so the option was a no-op and the docs overstated
+  it. Passing the old option is still silently accepted.
+
+## 0.21.0 - 2026-08-30
+
+- `mode.end_call` (default `false`) declares the managed `end_call(farewell)` tool so the agent can
+  end the session. When it calls the tool, Dialt speaks only the farewell, sends
+  `session_end_requested` with that `farewell`, and closes after a short grace unless the user
+  speaks. Without the flag the agent cannot end the session; the host ends it with `wrap_up` or by
+  closing. While enabled, the name `end_call` is reserved, like `web_search` (`invalid_tools`). Pass-through only:
+  validation and the default are the only client changes.
+
+## 0.20.0 - 2026-08-28
+
+- `mode.modality` selects `"voice"` (the default) or `"text"`. Text sessions use the same
+  instructions, tools, history and event lifecycle without microphone or playback setup.
+- `sendText(text)` commits one `input_text` user turn in text mode and returns whether it was
+  written to the live connection. In voice sessions `sendText` is unchanged: still the user-role
+  `injectContext` shorthand returning the acknowledgement promise, so existing voice
+  integrations keep working. Text rejects microphone capture and the WebRTC transport so
+  integrations cannot accidentally open an unused media pipeline.
+
+## 0.19.1 - 2026-08-22
+
+- Tool declarations: `expected_duration` (`"instant"` / `"seconds"` / `"long"`) replaces
+  `wait_for_tool` in the docs. It says what the caller should hear on a tool turn (the answer
+  directly, or an acknowledgement first); left out, Dialt learns from observed results.
+  `wait_for_tool: true` still passes through as a deprecated alias of `"instant"` during alpha and
+  will be removed at beta. Pass-through only: no client code changed.
+
+## 0.19.0 - 2026-08-22
+
+- `ambience` constructor option (`'thinking'` DEFAULT; `'off'`, `'continuous'`; or an object with
+  `mode` plus `afterS`/`fadeInS`/`fadeOutS`/`level`) and `client.setAmbience(mode)`: a soft
+  generative bed rendered in the SDK and mixed THROUGH the SDK player, so it sits in the echo
+  canceller's far-end reference on every transport and on WebKit/iOS (where the old playground
+  bed on its own AudioContext had to be disabled). `'continuous'` plays it under the whole call
+  from the first reply; `'thinking'` plays it only while Dialt is blocking on a tool result with
+  nothing to say - fading in after ~1.5 s of silence and out again under the reply's first
+  syllables, a real crossfade - so a caller waiting on a slow backend hears "still working"
+  instead of dead air. The thinking sound is ON BY DEFAULT from this release (it plays nothing
+  unless a tool wait runs long); pass `ambience: 'off'` to keep the old silence. Bed-only audio
+  is never queued ahead of a reply and never counts toward
+  barge `discarded_ms`. Same musical design and constants as the server-mixed WebRTC
+  `background_audio` bed (the two renderers share the score, not the samples). WebSocket
+  transport only: over webrtc the SDK player is not in the audio path, so the local ambience
+  stays silent and `mode.background_audio` is the option there.
+- New server event `working` (`active: true|false`): Dialt is blocking on a tool result
+  (client tools, web_search, think_deeply) with nothing audible, or that wait ended. Drives the
+  thinking sound; also usable for a "working..." UI state.
+- `StreamingPlayer.setUnderlay(bed)` / `resumeUnderlay()`: the underlay path the ambience uses.
+  Audio is now resampled at schedule time rather than at enqueue (no wire or API change).
+
+## 0.18.0 - 2026-08-18
+
+- `mode.background_audio` (default `false`): a server-mixed background underscore that plays for
+  the whole call, so the silence between turns feels connected. **Requires
+  `transport: 'webrtc'`** — the bed rides the server's playout track, the only downlink that runs
+  continuously between turns. The SDK drops the field with a console warning rather than sending
+  it on any non-WebRTC session, which matters because WebKit downgrades `webrtc` to `ws` for you;
+  without that, asking for both would cost the whole session on iOS instead of just the music.
+
+## 0.17.0 - 2026-08-17
+
+- **Breaking (inert):** removed the reversible-playback protocol. The broker stopped sending
+  `playback_pause`/`playback_resume` when the ink-decider barge fallback was deleted, so this
+  client half has been dead code since. `StreamingPlayer.pause()`, `.resume()` and `.paused` are
+  gone, custom players no longer need them, and start frames no longer advertise
+  `playback_pause_v1` (`client.capabilities` is now always `[]`). Barge handling is unchanged:
+  `interrupted` still fade-clears and reports `discarded_ms`/`remaining_ms`.
+
+## 0.16.0 - 2026-08-16
+
+- Interactions accept a `resolver` binding (`{tool, args, option_args, answer_arg}`): once the ask
+  has been voiced, subsequent user turns are constrained to an explicit transition
+  (resolve / clarify / supersede / cancel) via the broker-managed `interaction_transition` tool,
+  and `resolve` executes the bound client tool with host-declared arguments — the model picks the
+  option, never the arguments. See docs/client-tool-protocol.md §3a.
+
+## 0.15.0 - 2026-08-16
+
+- `tool_choice` lands in `ConverseMode` and as `setToolChoice(choice, { oneShot })` — the familiar
+  OpenAI/Gemini restriction vocabulary (`"auto"` | `"none"` | `"required"` | `{allowed: [...]}` |
+  `{tool: "..."}`). `required`/`allowed`/`tool` constrain the first planning round of each user
+  turn; `none` withholds declared client tools while broker protocol tools stay available;
+  `oneShot` reverts after the next user turn. Unknown names are rejected server-side with the new
+  `invalid_tool_choice` error code; `setTools` resets the choice to `"auto"`.
+## 0.14.1 - 2026-08-16
+
+- `sendToolInteractionUpdate` normalizes whitespace-padded interaction ids the same way the server
+  does, so the ack (which echoes the stripped id) correlates instead of surfacing as a timeout;
+  ack correlation is additionally state-matched, so a server answer arriving after a client-side
+  timeout can no longer be handed to the next same-id caller.
+
+## 0.14.0 - 2026-08-16
+
+- Interactions now carry a stable identity: pass `interaction.id` in `sendToolPartialResult` (or
+  read the broker-derived id from `tool_job_narration.interaction_ids`), then close an ask without
+  completing its parent call via `sendToolInteractionUpdate(id, interactionId, state, { note })`
+  (`state`: `resolved` | `cancelled` | `superseded`). Queued or actively-speaking narration for it
+  stops, the model is told not to act on it, and the returned promise resolves with the server's
+  deterministic `tool_interaction_update_ack` (late/duplicate/unknown updates come back
+  `applied: false` with a stable `reason`). Add `interactionState(interactionId)`; narration and
+  interaction state caches now reset on connection loss (a resumed session implicitly supersedes
+  any open interaction — re-raise it if still needed).
+
+## 0.13.1 - 2026-08-15
+
+- `sendToolPartialResult(id, content, { interaction })` marks a partial as needing a user decision
+  (docs/client-tool-protocol.md §3a): unlike `reply: true` alone, it is never silently dropped when
+  the floor is busy — it queues and preempts pending completion narration, with a far more
+  persistent delivery retry. Add `narrationState(jobId)` and `waitForNarrationState(jobId, states,
+  { timeoutMs })` to track its queued/started/superseded/cancelled lifecycle via the new
+  `tool_job_narration` server frame.
+
+## 0.13.0 - 2026-08-13
+
+- `startMic()` now resolves only after the first AudioWorklet frame. If an opened capture produces
+  no frames within the bounded startup window, the SDK fully releases it and reacquires once; a
+  repeated stall rejects with the structured `capture_stalled` error. Silent frames remain valid.
+- Add `warming_up`, `listening`, `recovering`, and `failed` capture lifecycle events so host apps can
+  render status without implementing their own retry or readiness fallback.
+- Add audio-input enumeration and selection with `getInputDevices()`, `setInputDevice(deviceId)`,
+  the `inputDeviceId` option/property, `devices_changed`, and `input_device_changed`. Active capture
+  follows relevant `devicechange` events through guarded track restart.
+- Make `stopMic()` a cancellation barrier and harden stop/retry, overlapping device-switch, and
+  delayed WebRTC track-replacement races without leaking tracks, worklets, or AudioContexts.
+
+## 0.12.3 - 2026-08-11
+
+- Tool result, progress, deferred, partial-result, and cancellation methods now return whether a
+  live transport accepted the frame, allowing durable bridges to retain controls across reconnects.
+
+## 0.12.2 - 2026-08-11
+
+- Keep a newer successful connection authoritative when an older failed WebSocket delivers its
+  close event late, so explicit capacity retries cannot clear the live transport.
+
+## 0.12.1 - 2026-08-11
+
+- Bound correlated injection acknowledgement waits and reject with cleanup when an older or
+  mismatched broker never returns `inject_context_ack`.
+
+## 0.12.0 - 2026-08-11
+
+- `injectContext(text, {messageId, role, reply})` now returns the broker's authoritative
+  accepted/rejected acknowledgement. The client-generated ID and `input_source: "text"` are
+  echoed on the canonical final `asr` event; spoken transcripts carry `input_source: "voice"`.
+- `sendText(text, {messageId})` exposes the same correlation and acknowledgement contract.
+
+## 0.11.0 - 2026-08-11
+
+- Add `sendText(text)` as the concise alias for a typed user turn that should receive a reply.
+  Typed and spoken turns use the same `asr` event contract, including a stable `turn_id`.
+
+## 0.10.0 - 2026-08-10
+
+- Add a supported, versioned Browser SDK resume-state API for full page reloads:
+  `resumeState`, `exportResumeState()`, `importResumeState()`, and the `resume_state` event. The
+  state rotates with each server token and clears on terminal or rejected sessions, so apps can
+  safely keep a tab-scoped `sessionStorage` copy without reading private SDK fields.
+- Add `injectContext(text, {role, reply})` as the supported Browser SDK surface for the existing
+  `inject_context` protocol frame, including proactive host announcements with `reply: true`.
+
+## 0.9.0 - 2026-08-09
+
+- Add `mode.silence_nudge_s` / `mode.silence_end_s` to override the broker's two-stage idle
+  policy (check-in nudge, then sign-off + end) per session — useful for benchmark harnesses or
+  flows with long think-time. Both default to the broker's env-configured values (10s/20s) when
+  omitted; the broker also falls back to those defaults if either value is non-positive or
+  `silence_end_s` does not exceed `silence_nudge_s`.
+
+## 0.8.0 - 2026-08-08
+
+- License Dialt-authored Browser SDK code under Apache 2.0; bundled AEC components remain under
+  the third-party terms reproduced in the package.
+- Keep assistant playback on the browser's unity-gain path, with no SDK limiter, software boost,
+  output-route switch, or `navigator.audioSession` manipulation.
+- Document that device volume, physical routing, and mobile full-duplex attenuation are controlled
+  by the browser and operating system; native integration is required for routing guarantees.
+- Document the Browser SDK support matrix across Chromium, Brave, Firefox and Safari, including
+  the automatic WebKit fallback from experimental WebRTC to WebSocket.
+
+## 0.7.0 - 2026-08-07
+
+- Add `sendToolDeferred(id, {handle, statusLabel})` for jobs that outlive their originating voice
+  turn. Eligible tools opt in with `deferred`, `deferred_timeout`, and `notify_on_complete`.
+- Deferred jobs remain addressable by their original call ID or host handle for progress,
+  cancellation, and exactly one terminal result. The SDK forwards `tool_deferred_ack` and
+  `tool_deferred_resume` events through the normal typed and catch-all event APIs.
+- Tool interruption is unchanged: barge-in never cancels deferred work; explicit cancellation does.
+
+## 0.6.0 - 2026-08-06
+
+- **Hidden-tab playback fix.** Browsers throttle `setInterval` to ~1 Hz in hidden tabs while the
+  AudioContext keeps running, so the player's 0.2 s scheduling horizon starved playback into
+  0.2 s bursts with ~0.8 s gaps whenever the user wasn't looking at the page. The player now
+  commits a 2.5 s horizon while `document.visibilityState === 'hidden'` (and tops up immediately
+  on `visibilitychange`), keeping playback gapless; the short barge-friendly horizon is unchanged
+  in visible tabs, and barge/clear still stops committed-but-unplayed sources at any horizon.
+- **Tool replies from anywhere.** `ConverseClient` gains `sendToolResult(id, content)`,
+  `sendToolProgress(id, note)`, `sendToolPartialResult(id, content, {reply})` and
+  `sendToolCancel(id)`, mirroring the Python SDK. Listen for `tool_call` events and answer them
+  from the page or relay them to a backend — no raw-socket sidecar needed.
+- `binaryToFloat32` and `toWebSocketUrl` are re-exported from the package root for raw-socket
+  integrations.
+- Server-side (deployed independently): the per-tool `timeout` ceiling rises from 120 s to 600 s
+  for long-running agentic tools.
+
+## 0.5.0 - 2026-08-06
+
+- **Downlink audio is PCM16 on the wire — required update.** The server's downlink default
+  changed from Float32 to PCM16 (bandwidth-halving negotiation, `start.audio.output_encoding`).
+  0.4.5 and earlier decode the downlink as Float32 and therefore produce noise or decode errors
+  against current servers. This release requests `output_encoding: "pcm16"` explicitly in the
+  start frame, decodes Int16, and fails `connect()` loudly if the server's `ready.audio` field
+  announces a format other than pcm16 at 16 kHz instead of playing garbage.
+- `transport: 'webrtc'` option (experimental): carries the session over a WebRTC peer connection
+  with a native remote audio track; the WS protocol remains the default and recommended path.
+  Includes bounded ICE gathering, the `webrtc_connect_failed` error, and mic dropout/resampler
+  fixes from the field-test rounds.
+
+## 0.4.5 - 2026-07-30
+
+- **Remove the speaker/earpiece output option entirely (`audioOutputMode`, `setAudioOutputMode`,
+  and the 0.4.1 `<audio>`-element sink)** — settled by an 11-configuration on-device experiment
+  (iPhone 17, Chrome + Safari): modern iOS routes web audio to the loudspeakers in every reachable
+  configuration, "earpiece AND speaker at once" is normal iPhone stereo playback (the receiver is
+  the second stereo speaker), and no configuration reaches earpiece-only. Web pages have no output
+  routing to control, so the SDK ships none: playback is a plain
+  `AudioContext` → master gain → `destination` path on every platform. The
+  never-touch-`navigator.audioSession` regression guard remains.
+
+## 0.4.4 - 2026-07-30
+
+- **Revert 0.4.3's `navigator.audioSession` usage — field-falsified on real iPhones (Chrome and
+  Safari).** Setting `type = 'playback'` (speaker mode) before capture made `getUserMedia` fail
+  with a mic-permission error — a broken mic in the DEFAULT mode — and `'play-and-record'`
+  (earpiece mode) still produced earpiece+loudspeaker dual output. Speaker routing is back on the
+  0.4.2 `<audio>`-element sink (mic works; known-imperfect dual output remains the open bug). A
+  regression test now pins that the SDK never touches `navigator.audioSession`.
+  `setAudioOutputMode()` (live switching) and the speaker/earpiece option remain.
+
+## 0.4.3 - 2026-07-30
+
+- `ConverseClient.setAudioOutputMode(mode)`: the 0.4.2 speaker/earpiece choice is now live-switchable
+  mid-session (previously took effect on the next `Start` only) — re-wires `StreamingPlayer`'s output
+  route and, on WebKit, sets `navigator.audioSession.type` (`'playback'` for speaker, `'play-and-record'`
+  for earpiece; Safari 16.4+, feature-detected, a no-op elsewhere). This directly targets the
+  documented WebKit routing decision the `<audio>`-element sink workaround (0.4.1) could only work
+  around indirectly — field testing on iPhone showed the 0.4.1 fix alone produced simultaneous
+  earpiece + loudspeaker output rather than a clean switch, and `navigator.audioSession.type` is the
+  platform's own API for this exact "mic is live, but I want loudspeaker anyway" case.
+- The two mechanisms are mutually exclusive, not stacked: where `navigator.audioSession` exists
+  (Safari 16.4+), the 0.4.1 `<audio>`-element sink route is skipped entirely (`hasAudioSessionApi()`
+  in `aec.js`) — running both at once would leave two live output paths fighting over the same
+  routing decision, the same shape that produced the dual-output field result. The element sink
+  remains only as the pre-16.4 WebKit fallback.
+
+## 0.4.2 - 2026-07-30
+
+- Add the `audioOutputMode` (`'speaker' | 'earpiece'`, default `'speaker'`) `StreamingPlayer`
+  constructor option so apps can explicitly choose between the loudspeaker route (0.4.1) and the
+  platform's own call-audio/earpiece routing on iOS/WebKit, instead of only ever getting one. No
+  effect on platforms without that fork (desktop, Android).
+
+## 0.4.1 - 2026-07-30
+
+- Route assistant playback through a sink `<audio>` element (instead of `AudioContext.destination`
+  directly) on iOS/WebKit, to avoid the call-audio session routing playback to the earpiece
+  receiver instead of the loudspeaker while a mic stream is active (WebKit bug 218012). Pending
+  on-device confirmation.
+
+## 0.4.0 - 2026-07-29
+
+- Publish the package publicly on npm with installation and authentication guidance.
+
+- Advertise reversible playback only for players that implement pause and resume, and report the
+  actual SDK-owned microphone/AEC frontend across reconnects for echo diagnostics.
+- Make web search opt-in by default.
+- Add `setMicEnabled(enabled)` to gate SDK-owned microphone tracks without reopening capture.
+- Add the default-on `playAcknowledgements` constructor option so half-duplex integrations can
+  suppress automatic backchannel playback while retaining `ack` and `audio` event dispatch.
+- Add `setVoice(voice)` to switch character voice from the next reply and reassert it on reconnect.
+- Add `sendAmbienceState(active)` to report the client's ambience state on the session timeline.
+
+## 0.3.1 - 2026-07-16
+
+- Enable web search by default while preserving an explicit `webSearch: false` opt-out.
+
+## 0.3.0 - 2026-07-16
+
+- Add the opt-in `webSearch` session capability.
+
+## 0.2.1 - 2026-07-15
+
+- Gate `playback_pause_v1` to desktop Chromium and Firefox until physical WebKit validation.
+
+## 0.2.0 - 2026-07-15
+
+- Add synchronized processed/raw uplink framing for raw-assisted barge detection.
+- Keep WebKit on one physical raw capture teed through SDK WASM AEC.
+- Add reversible `playback_pause` / `playback_resume` handling for backchannels.
+- Add AEC configuration plumbing and explicit desktop/WebKit engine controls.
+- Fail closed to processed-only audio when raw capture or classification is unavailable.
+
+## 0.1.0
+
+- Initial browser SDK extracted from the Dialt web client.

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,12 @@
+Dialt Browser SDK
+Copyright 2026 Dialt
+
+Dialt-authored portions of this SDK are licensed under the Apache License, Version 2.0.
+
+The bundled src/aec3-wasm.js includes third-party WebRTC audio-processing and Emscripten
+components, including libc++abi. Their copyright, license, disclaimer, and patent texts are
+reproduced under
+THIRD_PARTY_LICENSES/ and continue to govern those components.
+
+Neither the Apache license nor these third-party licenses grant rights to the hosted Dialt
+service, its models, Dialt trademarks, or server-side software.