Delphi client SDK
Platform
v0.9.11Recommended SDKv0.1.3Supported SDK range>=0.1.0 <0.2.0@ki-kombinat/delphi-client-js-sdk is a headless TypeScript SDK for the Delphi voice-AI platform. It opens AI-runtime sessions from the browser, sends and receives realtime messages, triggers browser actions, streams TTS audio, and places full WebRTC voice calls — all through one unified API.
Naming
The npm package is @ki-kombinat/delphi-client-js-sdk. The source folder is packages/telphi-sdk in the monorepo and the GitHub repo is delphi-client-js-sdk. Every page on this site refers to the package by its npm name.
Why one SDK
- One client, all flows — text chat, read-aloud, browser actions, voice calls all run through the same session abstraction.
- Session-first — every interaction is wrapped in a server-issued session for accounting, rate limiting, and conversation history.
- Long-lived sessions — sessions are find-or-create per
endpointId+ mode, so repeated calls reuse the same WebSocket and the same endpoint can run speaker and listener modes in parallel. - Tree-shakeable — pure ESM/CJS dual build,
sideEffects: false. - Zero runtime dependencies in the core — React bindings are an optional sub-path that only depends on
react.
Where to start
- Installation — install, sub-paths, peer deps.
- Concepts — sessions and modes, configuration, capabilities.
- Quick start — read-aloud, voice call.
- Guides — React, browser actions, interpretation, reconnect and persistence.
- Reference — channel protocol, errors.
- Compatibility — browsers, React, TypeScript, platform versions.
- Changelog — SDK release history.