Changelog
All notable changes to this project are documented here. The format follows Keep a Changelog and the project adheres to Semantic Versioning.
[0.1.0] - 2026-11-12
First release, published on PyPI as voxbridge-sdk (import name voxbridge).
First release.
Added
VoiceClient, one typed facade over Vapi and Retell, with sync methods anda-prefixed async twins, selected by a provider string.- Agent create, update, get and delete; outbound calls (
create_call,get_call,list_calls(limit=...)); PydanticAgent,CallandToolmodels that keep the provider payload under.raw. - Define-once
Toolregistration that maps to each provider's native tool shape, andtool_responseto build the reply a provider expects for a tool call. - Normalized webhooks:
parse_webhookandverify_signaturemap both providers to oneWebhookEventunion (CallStarted,CallEnded,TranscriptChunk,ToolCall,ErrorEvent), with per-provider signature verification. VoiceClient.from_env()readingVOICE_PROVIDER,<P>_API_KEY,<P>_WEBHOOK_SECRETand<P>_WEBHOOK_MAX_AGE; atimeoutoption (default 30 s).- Error hierarchy:
VoxBridgeError,ProviderError(status_code,body),AuthError,RateLimited(retry_after),NotSupported,SignatureError. NotSupportedfor every capability gap instead of silent no-ops.- Retell: webhooks verified by default with the API key (or
webhook_secret), with a 300 second replay window (webhook_max_age). - Vapi:
Authorization: Bearer <secret>accepted alongsideX-Vapi-Secret; E.164from_numberresolved to a phone-number id. - Docs site (MkDocs Material), README, configuration, webhooks and providers guides, runnable FastAPI and quickstart examples, CI matrix and trusted-publisher release workflow.
Fixed
- Vapi tool calls now parse the real nested
function.name/function.argumentsshape (arguments as object or JSON string); previouslynamecame back empty. - Vapi
update_agentmerges onto the existing assistant instead of replacing settings voxbridge does not model. - Retell
get_agentandupdate_agentread and write the agent's LLM, so the prompt, greeting, model and tools are no longer dropped;update_agentraisesNotSupportedfor non-retell-llmagents. - Retell
create_agentdeletes the LLM it created if agent creation fails. - Retell
list_callsnow reads the v3itemsenvelope; Retell voice ids round-trip through the canonical"<tts-provider>:<voiceId>"form (elevenlabsbecomes11labs). - Retell custom-function requests parse to
ToolCall. - Retell
create_callraisesValueErrorup front whenfrom_numberis missing. - Retries: only idempotent requests are retried on read/write timeouts and
500/502/503/504 responses; connect errors, connect timeouts and 429s are retried for any
request;
Retry-After(seconds or HTTP date) is honoured, capped at 10 seconds. - Passing
webhook_max_agefor Vapi raisesNotSupportedinstead of being ignored;from_envrejects an unknown provider before reading other variables. - Malformed webhook bodies raise
ProviderErrorrather than a bare decode error. update_agentkeeps per-tool provider settings (Vapi server secret and headers, Retell headers and timeouts) for tools it re-sends.- Retell
create_agent/update_agentraiseValueErrorup front for a tool withoutendpoint_url.