Voice provider policy — Workweaver admin

Catalog

Voice provider readiness

Providers marked coming soon can be selected as policy values; the runtime falls back to xAI grok-voice transparently until the underlying transport flips to live. Gemini Live becomes available once the VertexAI jurisdiction gate (#3224) lands.

Policy

Per-tenant × per-channel policy

Set the voice provider for each channel on a specific tenant, or use __platform__ for the global default. Setting a new provider for a live channel takes effect on the next voice session for that tenant.

Tenant id (use __platform__ for global default)

Runtime fallback active (force_coming_soon=true)

This tenant policy currently selects a coming_soon voice provider. The runtime transparently falls back to xai-grok-voice on every voice session, and emits a voice_silent_fallback Decision Trace so the audit log records each swap. Clear force_coming_soon and pick a LIVE provider to remove this banner.

Mode (default route when no per-channel override is set)

Per-channel overrides

Channel	Override provider

Voice recall & hot-cache (W8)

Adaptive recall budget = min(model_context * 0.6, recall_budget_override or 128000). Hot cache is a per-session LRU keyed by (tenant_id, session_id); entries refresh their TTL on prefetch.

Recall budget override (tokens, optional — blank uses platform default 128000)

Hot-cache size (entries; 1–8192)

Hot-cache entry TTL (seconds; 1–3600)

Runtime status enforcement (#4847)

By default, the API rejects any policy that picks a coming_soon voice provider. Check the box below to acknowledge that the runtime will fall back to xai-grok-voice until the underlying transport flips to LIVE. Every fallback emits a voice_silent_fallback Decision Trace.

force_coming_soon — accept fallback to xAI grok-voice

Surface parity: REST (PUT /api/v1/founder/voice/policy/{tenant_id}), CLI (ww admin voice policy set), MCP (ww.admin.voice.policy_set). All emit a voice_policy_changed Decision Trace.

Reference

About voice provider policy

Voice channels carry the same call to different transports:

PSTN — incoming and outgoing phone calls. Canonical default xAI grok-voice-think-fast-1.0.
Browser — in-browser Zara WebSocket relay (the "Talk to Zara" demo).
Meeting — Recall / Zoom / Google Meet bridges.

Permissions: voice:read for inspection, voice:write for policy mutations.