Name mapping
| Legacy | Canonical Dialt name | Compatibility |
|---|---|---|
ck_... | dk_... for newly issued keys | Existing keys remain valid. |
CONVERSE_API_KEY | DIALT_API_KEY | Environment fallback remains temporary. |
@trelis/converse | @dialt/sdk 0.27.1 | Install the Dialt package for updates. |
ConverseClient | DialtClient | Legacy construction warns once. |
mode.kind: 'converse' | mode.kind: 'dialt' | Legacy input warns once and is normalized. |
converse-sdk | dialt-sdk 0.20.0 | The final bridge remains installable. |
converse_sdk | dialt | Legacy imports emit a deprecation warning. |
ConverseError, ConverseMode, ConverseSession | DialtError, DialtMode, DialtSession | Legacy access warns once. |
https://converse.trelis.com | https://dialt.com | HTTP redirects permanently with method preservation. |
wss://converse.trelis.com/ws | wss://dialt.com/ws | The legacy WebSocket remains proxied because WebSockets do not follow redirects. |
Browser
npm remove @trelis/converse
npm install @dialt/sdk
import { DialtClient } from '@dialt/sdk';
const client = new DialtClient({
url: 'wss://dialt.com/ws',
mode: { kind: 'dialt' },
});
Use the canonical Browser SDK guide for new integrations. It covers secure scoped credentials, SDK and AudioWorklet loading, microphone lifecycle, and input selection.
Python
uv remove converse-sdk
uv add dialt-sdk
from dialt import DialtMode, DialtSession
Credentials and endpoints
DIALT_API_KEY=dk_your_key
Mint browser credentials with
POST https://dialt.com/api/v1/session-keys. Do not rely on an HTTP redirect
for credential creation. Keep persistent keys out of browser JavaScript.
Compatibility policy
The warning-bearing releases provide a migration window. Dialt will announce a specific removal version before deleting legacy aliases. Existing persistent keys are not invalidated by the SDK migration.