Skip to content

Define Voicepath routing contract#23

Merged
rogerchappel merged 1 commit into
mainfrom
agent/define-routing-contract
May 1, 2026
Merged

Define Voicepath routing contract#23
rogerchappel merged 1 commit into
mainfrom
agent/define-routing-contract

Conversation

@rogerchappel
Copy link
Copy Markdown
Owner

Summary

  • Defines the Wave 1 Voicepath routing contract and utterance/segment lifecycle.
  • Adds importable TypeScript contract types for provider capabilities, routing requests, latency budgets, lifecycle events, fallback reasons/outcomes, and continuity-critical audio chunks.
  • Adds lightweight contract tests and a repo-level validation script.

Product invariants covered

  • Fast first audio is represented in explicit latency budgets and fallback reasons.
  • Graceful fallback is constrained to normalized reasons/outcomes and safe boundaries.
  • Voice/provider continuity is locked per sentence so fallback cannot randomly switch voice mid-sentence.

Validation

  • bash scripts/validate.sh
    • npm test
    • npm run typecheck
    • npm run build

Note: docs/ORCHESTRATION.md and docs/TASKS.md were not present on current main; this PR adds the requested Wave 1 contract without broadening scope beyond Voicepath.

@rogerchappel rogerchappel merged commit 51ae372 into main May 1, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant