feat: add agent-events-inspector demo - #25
Closed
luke-speechify wants to merge 2 commits into
Closed
Conversation
A debug timeline for Voice Agent calls: replay a sample realtime event stream, or inspect a live conversation by id via the Voice Agents API. Hosted under /agent-events-inspector, gated with the shared Turnstile helper. The workspace key stays server-side in one route handler.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
Author
|
Closing in favour of #31. The 'realtime agent events' feature this demo was built around couldn't be verified against the API or docs (no live event stream/schema exists that I could find). Rather than ship a demo + changelog for something unconfirmed, DRG-381 pivots to a real, verified capability: realtime streaming TTS with word timestamps and dual highlighting — see #31. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Pairs with the upcoming speechify.ai post "Realtime agent events: debugging a live voice agent call."
What this demo is
A tiny debug timeline for a Speechify Voice Agent call. Two modes:
app/sample-events.ts) against a scrubber at 0.5×–4× — session start, user transcripts, agent replies, tool calls/results, session end, colour-coded with expandable JSON.conv_…id — the server proxiesGET /v1/agents/conversations/{id}on the Voice Agents API and renders what comes back.The workspace key stays server-side in a single route handler (
app/api/conversation/route.ts).Hosting + abuse protection
/agent-events-inspector(vercel.json+pnpm-workspace.yaml),basePathset, README table regenerated viapnpm generate./api/conversationwith the shared Cloudflare Turnstile helper (app/lib/turnstile.ts, verbatim). Fail-opens whenTURNSTILE_SECRET_KEYis unset.Verification
pnpm --filter agent-events-inspector build✅/v1/agents/conversationsreturns the list envelope).This one rides on a realtime-events capability that may not be fully shipped yet. The confirmed conversation fields (
id,agent_id,status,started_at,ended_at,duration_ms) match whatvoice-agent-showcasereads. The per-event stream schema insample-events.tsis illustrative — the inspector renders whichever event/transcript array a live conversation returns, and the README says so. Confirm the live event field names against the docs before the blog post commits to them.Part of a batch getting the speechify.ai demo backlog ahead of schedule. Blog post is written separately.