Skip to main content

Architecture

Documentation Map​

Architecture

Summary​

jhf-tenter is the repo-owned contract and runtime truth for:

  • the Asterisk / ARI / GUI stack boundary
  • the bounded softphone agent bridge
  • the Windows tray-owned local audio lane contract

Current Runtime Topology​

Linux host <internal-runtime-redacted>​

Owns:

  • Asterisk runtime containers
  • ARI / GUI endpoints
  • OpenClaw agent execution
  • softphone agent bridge

Shared live heartbeat posture on this host:

  • doubtfire-control is the shared live heartbeat owner
  • local-mistral is maintenance-only and must not be described here as the shared live heartbeat owner

Consumes:

  • the Windows-hosted local audio lane via local loopback <internal-runtime-redacted>:18180 on the Windows host and LAN address <internal-runtime-redacted>:18180 for the Linux voice bridge

Windows host​

Owns:

  • the existing tray app
  • the local audio server process started by that tray-owned control plane
  • local GPU binding and warmup
  • local audio health / version / models / latency surfaces

Voice Path​

Current bounded path:

  1. SIP / RTP enters Asterisk
  2. softphone agent bridge reads the recording
  3. bridge calls the Windows local audio lane
  4. bridge dispatches the resolved agent call to OpenClaw
  5. bridge normalizes audio back to Asterisk format

Current Model Pins​

  • STT:
    • voxtral-mini-4b-realtime-2602
  • TTS:
    • voxtral-mini-tts-2603

Streaming Rule​

The contract is streaming-capable by design.

The first executable runtime stage may still use bounded compatibility behavior per turn, but the repo must not fall back to a new batch-only truth boundary.

Tray Runtime Reuse Rule​

The existing Windows tray app is mandatory.

Forbidden:

  • replacement tray app
  • sidecar tray app
  • second Windows runtime supervisor

Legacy Boundary​

Older local Mistral / Ollama material in this repository is legacy maintenance history only.

It is not the active Windows voice-lane architecture anymore.