Supafone Labs ยท Documentation
Documentation menu

Why Supafone#

Choose the speaking model without rebuilding the agent. Keep Supervisor alongside it.

Supafone brings Ultravox, OpenAI, Gemini, Grok and Smallest AI Hydra into one S2S routing hub. Agent Factory keeps your instructions, tools and call stages; Supervisor adds a separate reasoning model that can guide the conversation.

Use one Supafone API key, or bring your own speaking-model and Supervisor keys. The two choices are independent, so you can mix your own provider access with Supafone's managed services. Start with a supervised agent or connect your keys.

Change the speaking model without rebuilding the agent#

The S2S harness keeps a native agent's prompt, supported tools, custom stages, server-side model credentials, and browser or phone transport together. Agent Factory creates that agent, then the shared SupafoneS2S provider classes choose Ultravox, OpenAI, Gemini, Grok, or Smallest AI Hydra. The native catalog has six model choices; Ultravox retains its default managed runtime. Configured platform keys make BYOK optional. Model changes apply to new sessions, with a voice valid for the selected model.

See the shared interface and native model support and limits. Hydra has no live transcript stream and keeps its persona and voice fixed per provider session. All five families share the workflow and reasoning layers; external TTS, language profiles and carrier controls retain their own limits. See Shared runtime, Manager and teams.

Problems we repeatedly encountered#

ProblemFailure in productionInnovation in the package
Self-supervisionThe speaking model misses cross-turn intent, emotion, workflow drift, and unsupported claimsSupafone Supervisor maintains a separate belief and directive loop off the audio hot path
Provider fragmentationEvery platform emits different transcript, tool, lifecycle, and control eventsCanonical event algebra and 14 audited adapters create one runtime contract
Weak intervention controlsA generic prompt cannot safely alter an active callCapability-aware compilation chooses native control, developer-owned context, host hook, observation, or no action
Tool hallucinationThe agent says a booking, transfer, or delivery happened before the tool confirms itTruth state separates verified outcomes from conversational language
Repeated agent engineeringEvery customer brief becomes another prompt, router, stage graph, and webhook projectAgent Factory creates an inspectable plan plus managed delivery primitives
Manual testingA few employee test calls miss the scenarios real callers produceObjective-driven adversarial QA generates cases from the actual agent contract
No stable quality scoreGeneric LLM scores fluctuate without an operational targetSSR grading converts nominal verdicts into inspectable score distributions
Scattered operationsCalls, recordings, transcripts, and decisions live in separate vendor consolesDurable activity APIs and telemetry expose one history to SDKs and product UIs
Multilingual discontinuityLanguage changes duplicate transcripts, lose state, or use the wrong voiceTranscript-authority rules and opt-in language/voice profiles preserve one canonical call
Rebuilt customer infrastructurePhone, WebRTC, SMS, campaigns, numbers, signing, and writebacks are implemented repeatedlyUnified SDK, REST, and MCP surfaces expose the surrounding operating system

The design response#

text
production call problem
  -> canonical event
  -> deterministic call state
  -> Supafone Supervisor belief and directive
  -> confidence, truth, and policy gate
  -> provider-aware compiler
  -> native action or safe no-op

The same call state also feeds replay, QA, telemetry, and optimization.

The architecture follows four rules:

  1. The live call remains primary. Supervision never blocks the speaking
  2. agent.

  3. Facts and warmth remain separate. Empathy cannot override tool truth,
  4. consent, or policy.

  5. Capability is explicit. Supafone never pretends a provider supports a
  6. control it does not expose.

  7. Evidence drives improvement. Calls can be replayed, graded, compared,
  8. and used to improve standing directives.

What developers stop rebuilding#

Continue with Framework coverage to see exactly how the runtime maps onto each supported platform, then use the SDK quickstart to create or supervise an agent.

View raw Markdown