Circuit-Forge/osprey
3
0
Fork 0
Code Issues 23 Pull requests Projects Releases Packages Wiki Activity Actions

Wire BridgeAnnouncementConfig into Twilio bridge webhook handler #22

New issue
Open
opened 2026-04-06 15:11:20 -07:00 by pyr0ball · 0 comments
pyr0ball commented 2026-04-06 15:11:20 -07:00
Owner
Copy link

Context

cf-orch#18 defines the live-human identification contract. contracts/bridge.py now contains:

  • BridgeAnnouncementConfig — product name, user_name_enabled, tone, silence durations
  • BridgeSession — model with announced_at: datetime | None (None = announcement not yet fired)
  • render_announcement(config, session) → TTS-ready string
  • BridgeSession.with_announced(transcript) → returns updated session

Required in Osprey bridge webhook handler

  1. Instantiate BridgeAnnouncementConfig(product_name="Osprey by CircuitForge") from product config
  2. At bridge connection (before user audio): call render_announcement() and play via Twilio <Say>
  3. Call session.with_announced(transcript=text) and persist to context checkpoint
  4. Log the BridgeAnnouncementEvent to the run record

Osprey MUST NOT pass audio to the live human before session.has_announced is True.

References

  • cf-orch#18
  • cf-orch#1 (FTB dialer implementation)
## Context cf-orch#18 defines the live-human identification contract. `contracts/bridge.py` now contains: - `BridgeAnnouncementConfig` — product name, user_name_enabled, tone, silence durations - `BridgeSession` — model with `announced_at: datetime | None` (None = announcement not yet fired) - `render_announcement(config, session)` → TTS-ready string - `BridgeSession.with_announced(transcript)` → returns updated session ## Required in Osprey bridge webhook handler 1. Instantiate `BridgeAnnouncementConfig(product_name="Osprey by CircuitForge")` from product config 2. At bridge connection (before user audio): call `render_announcement()` and play via Twilio `<Say>` 3. Call `session.with_announced(transcript=text)` and persist to context checkpoint 4. Log the `BridgeAnnouncementEvent` to the run record Osprey MUST NOT pass audio to the live human before `session.has_announced` is True. ## References - cf-orch#18 - cf-orch#1 (FTB dialer implementation)
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
No results found.
Labels
Clear labels   
backlog
No labels
backlog
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: Circuit-Forge/osprey#22
No description provided.
Delete branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?