fix: changes to update pipecat version to 0.0.100 (#122)

* feat: add stt evals

* add smart turn as provider

* chore: remove deprecations

* chore: format files

* fix: remove deprecated UserIdleProcessor

* fix: remove deprecated TranscriptProcessor

* chore: update pipecat submodule

* feat: add evals visualisation

* fix: trigger llm generation on client connected and pipeline started

* chore: update pipecat

* chore: update pipecat submodule

* Add tests

* fix: slow loading of workflow page

* chore: update pipecat submodule

* Show version after release

* Fixes #99

* fix: provider check for websocket connection

* Fixes #107

* Fix #96

* chore: fix documentation

* fix: cloudonix campaign call error

---------

Co-authored-by: Sabiha Khan <sabihak89@gmail.com>
This commit is contained in:
Abhishek 2026-01-23 18:53:59 +05:30 committed by GitHub
parent a4367bd83b
commit 911c5ed416
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
104 changed files with 16919 additions and 597 deletions

41
evals/visualizer/.gitignore vendored Normal file
View file

@ -0,0 +1,41 @@
# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
# dependencies
/node_modules
/.pnp
.pnp.*
.yarn/*
!.yarn/patches
!.yarn/plugins
!.yarn/releases
!.yarn/versions
# testing
/coverage
# next.js
/.next/
/out/
# production
/build
# misc
.DS_Store
*.pem
# debug
npm-debug.log*
yarn-debug.log*
yarn-error.log*
.pnpm-debug.log*
# env files (can opt-in for committing if needed)
.env*
# vercel
.vercel
# typescript
*.tsbuildinfo
next-env.d.ts

View file

@ -0,0 +1,36 @@
This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
## Getting Started
First, run the development server:
```bash
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev
```
Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
## Learn More
To learn more about Next.js, take a look at the following resources:
- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
## Deploy on Vercel
The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.

View file

@ -0,0 +1,18 @@
import { defineConfig, globalIgnores } from "eslint/config";
import nextVitals from "eslint-config-next/core-web-vitals";
import nextTs from "eslint-config-next/typescript";
const eslintConfig = defineConfig([
...nextVitals,
...nextTs,
// Override default ignores of eslint-config-next.
globalIgnores([
// Default ignores of eslint-config-next:
".next/**",
"out/**",
"build/**",
"next-env.d.ts",
]),
]);
export default eslintConfig;

View file

@ -0,0 +1,7 @@
import type { NextConfig } from "next";
const nextConfig: NextConfig = {
/* config options here */
};
export default nextConfig;

View file

@ -0,0 +1,26 @@
{
"name": "visualizer",
"version": "0.1.0",
"private": true,
"scripts": {
"dev": "next dev",
"build": "next build",
"start": "next start",
"lint": "eslint"
},
"dependencies": {
"next": "16.1.4",
"react": "19.2.3",
"react-dom": "19.2.3"
},
"devDependencies": {
"@tailwindcss/postcss": "^4",
"@types/node": "^20",
"@types/react": "^19",
"@types/react-dom": "^19",
"eslint": "^9",
"eslint-config-next": "16.1.4",
"tailwindcss": "^4",
"typescript": "^5"
}
}

4008
evals/visualizer/pnpm-lock.yaml generated Normal file

File diff suppressed because it is too large Load diff

View file

@ -0,0 +1,5 @@
packages:
- .
ignoredBuiltDependencies:
- sharp
- unrs-resolver

View file

@ -0,0 +1,7 @@
const config = {
plugins: {
"@tailwindcss/postcss": {},
},
};
export default config;

View file

@ -0,0 +1 @@
<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

After

Width:  |  Height:  |  Size: 391 B

View file

@ -0,0 +1 @@
<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

After

Width:  |  Height:  |  Size: 1 KiB

View file

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

After

Width:  |  Height:  |  Size: 1.3 KiB

View file

@ -0,0 +1 @@
<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>

After

Width:  |  Height:  |  Size: 128 B

View file

@ -0,0 +1 @@
<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>

After

Width:  |  Height:  |  Size: 385 B

View file

@ -0,0 +1,42 @@
import { NextRequest, NextResponse } from "next/server";
import fs from "fs";
import path from "path";
const AUDIO_DIR = path.join(process.cwd(), "..", "stt", "audio");
const MIME_TYPES: Record<string, string> = {
".mp3": "audio/mpeg",
".wav": "audio/wav",
".m4a": "audio/mp4",
".ogg": "audio/ogg",
".webm": "audio/webm",
};
export async function GET(
request: NextRequest,
{ params }: { params: Promise<{ filename: string }> }
) {
try {
const { filename } = await params;
const filePath = path.join(AUDIO_DIR, filename);
if (!fs.existsSync(filePath)) {
return NextResponse.json({ error: "Audio file not found" }, { status: 404 });
}
const ext = path.extname(filename).toLowerCase();
const contentType = MIME_TYPES[ext] || "application/octet-stream";
const fileBuffer = fs.readFileSync(filePath);
return new NextResponse(fileBuffer, {
headers: {
"Content-Type": contentType,
"Content-Length": fileBuffer.length.toString(),
},
});
} catch (error) {
console.error("Error serving audio:", error);
return NextResponse.json({ error: "Failed to serve audio" }, { status: 500 });
}
}

View file

@ -0,0 +1,27 @@
import { NextRequest, NextResponse } from "next/server";
import fs from "fs";
import path from "path";
const RESULTS_DIR = path.join(process.cwd(), "..", "stt", "results");
export async function GET(
request: NextRequest,
{ params }: { params: Promise<{ id: string }> }
) {
try {
const { id } = await params;
const filePath = path.join(RESULTS_DIR, `${id}.json`);
if (!fs.existsSync(filePath)) {
return NextResponse.json({ error: "Result not found" }, { status: 404 });
}
const content = fs.readFileSync(filePath, "utf-8");
const data = JSON.parse(content);
return NextResponse.json(data);
} catch (error) {
console.error("Error reading result:", error);
return NextResponse.json({ error: "Failed to read result" }, { status: 500 });
}
}

View file

@ -0,0 +1,47 @@
import { NextResponse } from "next/server";
import fs from "fs";
import path from "path";
import { ResultSummary, EventCaptureResult } from "@/types";
const RESULTS_DIR = path.join(process.cwd(), "..", "stt", "results");
export async function GET() {
try {
if (!fs.existsSync(RESULTS_DIR)) {
return NextResponse.json([]);
}
const files = fs.readdirSync(RESULTS_DIR).filter((f) => f.endsWith(".json"));
const results: ResultSummary[] = [];
for (const file of files) {
try {
const filePath = path.join(RESULTS_DIR, file);
const content = fs.readFileSync(filePath, "utf-8");
const data: EventCaptureResult = JSON.parse(content);
results.push({
id: file.replace(".json", ""),
audio_file: data.audio_file,
provider: data.provider,
duration: data.duration,
created_at: data.created_at,
event_count: data.events.length,
});
} catch {
console.error(`Failed to parse ${file}`);
}
}
// Sort by created_at descending
results.sort(
(a, b) =>
new Date(b.created_at).getTime() - new Date(a.created_at).getTime()
);
return NextResponse.json(results);
} catch (error) {
console.error("Error reading results:", error);
return NextResponse.json({ error: "Failed to read results" }, { status: 500 });
}
}

Binary file not shown.

After

Width:  |  Height:  |  Size: 25 KiB

View file

@ -0,0 +1,26 @@
@import "tailwindcss";
:root {
--background: #ffffff;
--foreground: #171717;
}
@theme inline {
--color-background: var(--background);
--color-foreground: var(--foreground);
--font-sans: var(--font-geist-sans);
--font-mono: var(--font-geist-mono);
}
@media (prefers-color-scheme: dark) {
:root {
--background: #0a0a0a;
--foreground: #ededed;
}
}
body {
background: var(--background);
color: var(--foreground);
font-family: Arial, Helvetica, sans-serif;
}

View file

@ -0,0 +1,34 @@
import type { Metadata } from "next";
import { Geist, Geist_Mono } from "next/font/google";
import "./globals.css";
const geistSans = Geist({
variable: "--font-geist-sans",
subsets: ["latin"],
});
const geistMono = Geist_Mono({
variable: "--font-geist-mono",
subsets: ["latin"],
});
export const metadata: Metadata = {
title: "STT Event Visualizer",
description: "Visualize WebSocket events from STT providers",
};
export default function RootLayout({
children,
}: Readonly<{
children: React.ReactNode;
}>) {
return (
<html lang="en">
<body
className={`${geistSans.variable} ${geistMono.variable} antialiased`}
>
{children}
</body>
</html>
);
}

View file

@ -0,0 +1,129 @@
"use client";
import { useEffect, useState } from "react";
import Link from "next/link";
import { ResultSummary } from "@/types";
function formatDuration(seconds: number): string {
const mins = Math.floor(seconds / 60);
const secs = Math.floor(seconds % 60);
return `${mins}:${secs.toString().padStart(2, "0")}`;
}
function formatDate(isoString: string): string {
const date = new Date(isoString);
return date.toLocaleDateString("en-US", {
year: "numeric",
month: "short",
day: "numeric",
hour: "2-digit",
minute: "2-digit",
});
}
const PROVIDER_COLORS: Record<string, string> = {
deepgram: "bg-blue-500/20 text-blue-300",
"deepgram-flux": "bg-green-500/20 text-green-300",
speechmatics: "bg-purple-500/20 text-purple-300",
};
export default function Home() {
const [results, setResults] = useState<ResultSummary[]>([]);
const [loading, setLoading] = useState(true);
const [error, setError] = useState<string | null>(null);
useEffect(() => {
async function fetchResults() {
try {
const response = await fetch("/api/results");
if (!response.ok) {
throw new Error("Failed to fetch results");
}
const data = await response.json();
setResults(data);
} catch (err) {
setError(err instanceof Error ? err.message : "Unknown error");
} finally {
setLoading(false);
}
}
fetchResults();
}, []);
return (
<div className="min-h-screen bg-zinc-950 text-white">
<div className="max-w-4xl mx-auto px-6 py-12">
<header className="mb-12">
<h1 className="text-3xl font-bold">STT Event Visualizer</h1>
<p className="text-zinc-400 mt-2">
Visualize captured WebSocket events from STT providers
</p>
</header>
{loading && (
<div className="flex items-center justify-center py-12">
<div className="animate-spin rounded-full h-8 w-8 border-b-2 border-white"></div>
</div>
)}
{error && (
<div className="bg-red-500/20 text-red-300 p-4 rounded-lg">
{error}
</div>
)}
{!loading && !error && results.length === 0 && (
<div className="text-center py-12 text-zinc-500">
<p className="text-lg mb-4">No results found</p>
<p className="text-sm">
Run the event capture script to generate results:
</p>
<code className="block mt-2 bg-zinc-800 p-3 rounded text-zinc-300 text-sm">
python -m evals.stt.event_capture audio/multi_speaker.m4a --provider deepgram
</code>
</div>
)}
{!loading && !error && results.length > 0 && (
<div className="space-y-3">
{results.map((result) => (
<Link
key={result.id}
href={`/view/${result.id}`}
className="block bg-zinc-900 hover:bg-zinc-800 rounded-lg p-4 transition-colors"
>
<div className="flex items-center justify-between">
<div className="space-y-1">
<div className="flex items-center gap-3">
<span className="font-medium">{result.audio_file}</span>
<span
className={`text-xs px-2 py-0.5 rounded ${
PROVIDER_COLORS[result.provider] ||
"bg-zinc-700 text-zinc-300"
}`}
>
{result.provider}
</span>
</div>
<div className="text-sm text-zinc-500">
{formatDate(result.created_at)}
</div>
</div>
<div className="text-right space-y-1">
<div className="text-sm text-zinc-400">
{formatDuration(result.duration)}
</div>
<div className="text-xs text-zinc-500">
{result.event_count} events
</div>
</div>
</div>
</Link>
))}
</div>
)}
</div>
</div>
);
}

View file

@ -0,0 +1,158 @@
"use client";
import { useEffect, useState, useCallback } from "react";
import { useParams } from "next/navigation";
import Link from "next/link";
import { EventCaptureResult } from "@/types";
import AudioPlayer from "@/components/AudioPlayer";
import EventTimeline from "@/components/EventTimeline";
import EventList from "@/components/EventList";
const PROVIDER_COLORS: Record<string, string> = {
deepgram: "bg-blue-500/20 text-blue-300",
"deepgram-flux": "bg-green-500/20 text-green-300",
speechmatics: "bg-purple-500/20 text-purple-300",
};
export default function ViewPage() {
const params = useParams();
const id = params.id as string;
const [result, setResult] = useState<EventCaptureResult | null>(null);
const [loading, setLoading] = useState(true);
const [error, setError] = useState<string | null>(null);
const [currentTime, setCurrentTime] = useState(0);
const [isPlaying, setIsPlaying] = useState(false);
useEffect(() => {
async function fetchResult() {
try {
const response = await fetch(`/api/results/${id}`);
if (!response.ok) {
if (response.status === 404) {
throw new Error("Result not found");
}
throw new Error("Failed to fetch result");
}
const data = await response.json();
setResult(data);
} catch (err) {
setError(err instanceof Error ? err.message : "Unknown error");
} finally {
setLoading(false);
}
}
if (id) {
fetchResult();
}
}, [id]);
const handleTimeUpdate = useCallback((time: number) => {
setCurrentTime(time);
}, []);
const handlePlayingChange = useCallback((playing: boolean) => {
setIsPlaying(playing);
}, []);
const handleSeek = useCallback((time: number) => {
setCurrentTime(time);
}, []);
if (loading) {
return (
<div className="min-h-screen bg-zinc-950 text-white flex items-center justify-center">
<div className="animate-spin rounded-full h-8 w-8 border-b-2 border-white"></div>
</div>
);
}
if (error) {
return (
<div className="min-h-screen bg-zinc-950 text-white p-6">
<div className="max-w-4xl mx-auto">
<Link href="/" className="text-zinc-400 hover:text-white mb-4 inline-block">
&larr; Back to results
</Link>
<div className="bg-red-500/20 text-red-300 p-4 rounded-lg">{error}</div>
</div>
</div>
);
}
if (!result) {
return null;
}
const audioUrl = `/api/audio/${result.audio_file}`;
return (
<div className="min-h-screen bg-zinc-950 text-white">
<div className="max-w-7xl mx-auto px-6 py-6">
{/* Header */}
<header className="mb-6">
<Link href="/" className="text-zinc-400 hover:text-white mb-2 inline-block text-sm">
&larr; Back to results
</Link>
<div className="flex items-center gap-3">
<h1 className="text-2xl font-bold">{result.audio_file}</h1>
<span
className={`text-sm px-2 py-0.5 rounded ${
PROVIDER_COLORS[result.provider] || "bg-zinc-700 text-zinc-300"
}`}
>
{result.provider}
</span>
</div>
{result.transcript && (
<p className="text-zinc-400 mt-2 text-sm line-clamp-2">
{result.transcript}
</p>
)}
</header>
{/* Main content */}
<div className="grid grid-cols-1 lg:grid-cols-3 gap-6">
{/* Left column: Audio player and timeline */}
<div className="lg:col-span-2 space-y-4">
<AudioPlayer
audioUrl={audioUrl}
duration={result.duration}
currentTime={currentTime}
onTimeUpdate={handleTimeUpdate}
onPlayingChange={handlePlayingChange}
/>
<EventTimeline
events={result.events}
duration={result.duration}
currentTime={currentTime}
onSeek={handleSeek}
/>
{/* Transcript section */}
{result.transcript && (
<div className="bg-zinc-800 rounded-lg p-4">
<div className="text-sm text-zinc-400 font-medium mb-2">
Final Transcript
</div>
<p className="text-zinc-300">{result.transcript}</p>
</div>
)}
</div>
{/* Right column: Event list */}
<div className="lg:col-span-1 h-[calc(100vh-12rem)]">
<EventList
events={result.events}
currentTime={currentTime}
onSeek={handleSeek}
provider={result.provider}
/>
</div>
</div>
</div>
</div>
);
}

View file

@ -0,0 +1,145 @@
"use client";
import { useRef, useEffect, useState, useCallback } from "react";
interface AudioPlayerProps {
audioUrl: string;
duration: number;
currentTime: number;
onTimeUpdate: (time: number) => void;
onPlayingChange: (playing: boolean) => void;
}
function formatTime(seconds: number): string {
const mins = Math.floor(seconds / 60);
const secs = Math.floor(seconds % 60);
return `${mins}:${secs.toString().padStart(2, "0")}`;
}
export default function AudioPlayer({
audioUrl,
duration,
currentTime,
onTimeUpdate,
onPlayingChange,
}: AudioPlayerProps) {
const audioRef = useRef<HTMLAudioElement>(null);
const [isPlaying, setIsPlaying] = useState(false);
const [internalTime, setInternalTime] = useState(0);
useEffect(() => {
const audio = audioRef.current;
if (!audio) return;
const handleTimeUpdate = () => {
setInternalTime(audio.currentTime);
onTimeUpdate(audio.currentTime);
};
const handlePlay = () => {
setIsPlaying(true);
onPlayingChange(true);
};
const handlePause = () => {
setIsPlaying(false);
onPlayingChange(false);
};
const handleEnded = () => {
setIsPlaying(false);
onPlayingChange(false);
};
audio.addEventListener("timeupdate", handleTimeUpdate);
audio.addEventListener("play", handlePlay);
audio.addEventListener("pause", handlePause);
audio.addEventListener("ended", handleEnded);
return () => {
audio.removeEventListener("timeupdate", handleTimeUpdate);
audio.removeEventListener("play", handlePlay);
audio.removeEventListener("pause", handlePause);
audio.removeEventListener("ended", handleEnded);
};
}, [onTimeUpdate, onPlayingChange]);
// Seek to currentTime when it changes externally
useEffect(() => {
const audio = audioRef.current;
if (!audio) return;
// Only seek if the difference is significant (user clicked timeline)
if (Math.abs(audio.currentTime - currentTime) > 0.5) {
audio.currentTime = currentTime;
}
}, [currentTime]);
const togglePlay = useCallback(() => {
const audio = audioRef.current;
if (!audio) return;
if (isPlaying) {
audio.pause();
} else {
audio.play();
}
}, [isPlaying]);
const handleSeek = useCallback((e: React.ChangeEvent<HTMLInputElement>) => {
const audio = audioRef.current;
if (!audio) return;
const newTime = parseFloat(e.target.value);
audio.currentTime = newTime;
setInternalTime(newTime);
onTimeUpdate(newTime);
}, [onTimeUpdate]);
return (
<div className="bg-zinc-900 rounded-lg p-4 space-y-3">
<audio ref={audioRef} src={audioUrl} preload="metadata" />
<div className="flex items-center gap-4">
<button
onClick={togglePlay}
className="w-12 h-12 rounded-full bg-white text-black flex items-center justify-center hover:bg-zinc-200 transition-colors"
>
{isPlaying ? (
<svg className="w-5 h-5" fill="currentColor" viewBox="0 0 20 20">
<path
fillRule="evenodd"
d="M18 10a8 8 0 11-16 0 8 8 0 0116 0zM7 8a1 1 0 012 0v4a1 1 0 11-2 0V8zm5-1a1 1 0 00-1 1v4a1 1 0 102 0V8a1 1 0 00-1-1z"
clipRule="evenodd"
/>
</svg>
) : (
<svg className="w-5 h-5 ml-1" fill="currentColor" viewBox="0 0 20 20">
<path
fillRule="evenodd"
d="M10 18a8 8 0 100-16 8 8 0 000 16zM9.555 7.168A1 1 0 008 8v4a1 1 0 001.555.832l3-2a1 1 0 000-1.664l-3-2z"
clipRule="evenodd"
/>
</svg>
)}
</button>
<div className="flex-1 space-y-1">
<input
type="range"
min={0}
max={duration}
step={0.1}
value={internalTime}
onChange={handleSeek}
className="w-full h-2 bg-zinc-700 rounded-lg appearance-none cursor-pointer accent-white"
/>
<div className="flex justify-between text-xs text-zinc-400">
<span>{formatTime(internalTime)}</span>
<span>{formatTime(duration)}</span>
</div>
</div>
</div>
</div>
);
}

View file

@ -0,0 +1,141 @@
"use client";
import { useEffect, useRef, useMemo, useState } from "react";
import { CapturedEvent } from "@/types";
import { DeepgramEventItem, FluxEventItem, SpeechmaticsEventItem } from "./events";
interface EventListProps {
events: CapturedEvent[];
currentTime: number;
onSeek: (time: number) => void;
provider: string;
}
function formatTime(seconds: number): string {
const mins = Math.floor(seconds / 60);
const secs = Math.floor(seconds % 60);
const ms = Math.floor((seconds % 1) * 100);
return `${mins}:${secs.toString().padStart(2, "0")}.${ms.toString().padStart(2, "0")}`;
}
function getEventItemComponent(provider: string) {
if (provider === "deepgram-flux") {
return FluxEventItem;
}
if (provider === "speechmatics") {
return SpeechmaticsEventItem;
}
// Default to Deepgram Nova
return DeepgramEventItem;
}
export default function EventList({
events,
currentTime,
onSeek,
provider,
}: EventListProps) {
const containerRef = useRef<HTMLDivElement>(null);
const [expandedEvents, setExpandedEvents] = useState<Set<number>>(new Set());
const [autoScroll, setAutoScroll] = useState(true);
const EventItemComponent = getEventItemComponent(provider);
// Find the current event index based on time
const currentEventIndex = useMemo(() => {
for (let i = events.length - 1; i >= 0; i--) {
if (events[i].timestamp <= currentTime) {
return i;
}
}
return -1;
}, [events, currentTime]);
// Auto-scroll to current event
useEffect(() => {
if (!autoScroll || currentEventIndex < 0) return;
const container = containerRef.current;
if (!container) return;
const eventElement = container.querySelector(`[data-index="${currentEventIndex}"]`);
if (eventElement) {
eventElement.scrollIntoView({ behavior: "smooth", block: "center" });
}
}, [currentEventIndex, autoScroll]);
const toggleExpand = (index: number) => {
setExpandedEvents((prev) => {
const next = new Set(prev);
if (next.has(index)) {
next.delete(index);
} else {
next.add(index);
}
return next;
});
};
return (
<div className="bg-zinc-800 rounded-lg flex flex-col h-full">
<div className="flex justify-between items-center px-4 py-2 border-b border-zinc-700">
<div className="text-sm text-zinc-400 font-medium">
Events ({events.length})
</div>
<label className="flex items-center gap-2 text-xs text-zinc-500 cursor-pointer">
<input
type="checkbox"
checked={autoScroll}
onChange={(e) => setAutoScroll(e.target.checked)}
className="rounded"
/>
Auto-scroll
</label>
</div>
<div
ref={containerRef}
className="flex-1 overflow-y-auto divide-y divide-zinc-700/50"
>
{events.map((event, index) => {
const isCurrent = index === currentEventIndex;
const isExpanded = expandedEvents.has(index);
return (
<div
key={index}
data-index={index}
className={`p-3 cursor-pointer transition-colors ${
isCurrent ? "bg-zinc-700/50" : "hover:bg-zinc-700/30"
}`}
onClick={() => onSeek(event.timestamp)}
>
<div className="flex items-start gap-2">
{/* Current indicator */}
<div className="pt-1">
{isCurrent ? (
<div className="w-2 h-2 rounded-full bg-white" />
) : (
<div className="w-2 h-2 rounded-full bg-zinc-600" />
)}
</div>
{/* Timestamp */}
<span className="text-xs text-zinc-500 font-mono pt-0.5">
{formatTime(event.timestamp)}
</span>
{/* Provider-specific event item */}
<EventItemComponent
event={event}
isExpanded={isExpanded}
onToggleExpand={() => toggleExpand(index)}
/>
</div>
</div>
);
})}
</div>
</div>
);
}

View file

@ -0,0 +1,119 @@
"use client";
import { useMemo } from "react";
import { CapturedEvent } from "@/types";
interface EventTimelineProps {
events: CapturedEvent[];
duration: number;
currentTime: number;
onSeek: (time: number) => void;
}
const EVENT_COLORS: Record<string, string> = {
Results: "bg-blue-500",
TurnInfo: "bg-green-500",
AddTranscript: "bg-purple-500",
Connected: "bg-yellow-500",
RecognitionStarted: "bg-yellow-500",
EndOfTranscript: "bg-red-500",
Metadata: "bg-gray-500",
Error: "bg-red-600",
default: "bg-zinc-400",
};
function formatTime(seconds: number): string {
const mins = Math.floor(seconds / 60);
const secs = Math.floor(seconds % 60);
return `${mins}:${secs.toString().padStart(2, "0")}`;
}
export default function EventTimeline({
events,
duration,
currentTime,
onSeek,
}: EventTimelineProps) {
const timeMarkers = useMemo(() => {
const markers: number[] = [];
const interval = Math.ceil(duration / 6);
for (let i = 0; i <= duration; i += interval) {
markers.push(i);
}
if (markers[markers.length - 1] !== Math.floor(duration)) {
markers.push(Math.floor(duration));
}
return markers;
}, [duration]);
const handleClick = (e: React.MouseEvent<HTMLDivElement>) => {
const rect = e.currentTarget.getBoundingClientRect();
const x = e.clientX - rect.left;
const percent = x / rect.width;
const time = percent * duration;
onSeek(Math.max(0, Math.min(time, duration)));
};
const progressPercent = (currentTime / duration) * 100;
return (
<div className="bg-zinc-800 rounded-lg p-4 space-y-2">
<div className="text-sm text-zinc-400 font-medium">Event Timeline</div>
<div
className="relative h-16 bg-zinc-900 rounded cursor-pointer overflow-hidden"
onClick={handleClick}
>
{/* Progress indicator */}
<div
className="absolute top-0 bottom-0 bg-zinc-700/50 pointer-events-none"
style={{ width: `${Math.min(progressPercent, 100)}%` }}
/>
{/* Current time indicator */}
<div
className="absolute top-0 bottom-0 w-0.5 bg-white z-10 pointer-events-none"
style={{ left: `${Math.min(progressPercent, 100)}%` }}
/>
{/* Event markers */}
<div className="absolute inset-0 flex items-center">
{events.map((event, index) => {
const leftPercent = Math.min((event.timestamp / duration) * 100, 100);
const colorClass =
EVENT_COLORS[event.event_type] || EVENT_COLORS.default;
return (
<div
key={index}
className={`absolute w-2 h-8 rounded-sm ${colorClass} opacity-80 hover:opacity-100 transition-opacity`}
style={{ left: `${leftPercent}%`, transform: "translateX(-50%)" }}
title={`${formatTime(event.timestamp)} - ${event.event_type}`}
/>
);
})}
</div>
</div>
{/* Time markers */}
<div className="flex justify-between text-xs text-zinc-500">
{timeMarkers.map((time, index) => (
<span key={index}>{formatTime(time)}</span>
))}
</div>
{/* Legend */}
<div className="flex flex-wrap gap-3 pt-2">
{Object.entries(EVENT_COLORS)
.filter(([key]) => key !== "default")
.slice(0, 6)
.map(([eventType, colorClass]) => (
<div key={eventType} className="flex items-center gap-1 text-xs text-zinc-400">
<div className={`w-2 h-2 rounded-sm ${colorClass}`} />
<span>{eventType}</span>
</div>
))}
</div>
</div>
);
}

View file

@ -0,0 +1,98 @@
"use client";
import { CapturedEvent } from "@/types";
interface DeepgramEventItemProps {
event: CapturedEvent;
isExpanded: boolean;
onToggleExpand: () => void;
}
const EVENT_COLORS: Record<string, string> = {
Results: "text-blue-400 bg-blue-500/10",
SpeechStarted: "text-yellow-400 bg-yellow-500/10",
Metadata: "text-gray-400 bg-gray-500/10",
UtteranceEnd: "text-red-500 bg-red-600/10",
default: "text-zinc-400 bg-zinc-500/10",
};
function getTranscript(event: CapturedEvent): string {
const data = event.data;
const channel = data.channel as Record<string, unknown> | undefined;
if (channel) {
const alternatives = channel.alternatives as Array<{ transcript?: string }> | undefined;
if (alternatives?.[0]?.transcript) {
return alternatives[0].transcript;
}
}
return "";
}
export default function DeepgramEventItem({
event,
isExpanded,
onToggleExpand,
}: DeepgramEventItemProps) {
const colorClass = EVENT_COLORS[event.event_type] || EVENT_COLORS.default;
const data = event.data;
const transcript = getTranscript(event);
const isFinal = data.is_final as boolean | undefined;
const speechFinal = data.speech_final as boolean | undefined;
// For non-Results events
const isConnection = event.event_type === "Connected";
const isMetadata = event.event_type === "Metadata";
return (
<div className="flex-1 min-w-0 space-y-1">
<div className="flex items-center gap-2 flex-wrap">
<span className={`text-xs px-2 py-0.5 rounded ${colorClass}`}>
{event.event_type}
</span>
{/* Final/Partial indicator for Results */}
{isFinal !== undefined && (
<span
className={`text-xs px-2 py-0.5 rounded ${isFinal
? "text-emerald-400 bg-emerald-500/10"
: "text-amber-400 bg-amber-500/10"
}`}
>
{isFinal ? "Final" : "Partial"}
</span>
)}
{/* Speech Final indicator */}
{speechFinal && (
<span className="text-xs px-2 py-0.5 rounded text-cyan-400 bg-cyan-500/10">
Speech Final
</span>
)}
</div>
{/* Transcript or status message */}
<div className="text-sm text-zinc-300 truncate">
{transcript}
</div>
{/* Expand/collapse button */}
<button
onClick={(e) => {
e.stopPropagation();
onToggleExpand();
}}
className="text-xs text-zinc-500 hover:text-zinc-300"
>
{isExpanded ? "Hide details" : "Show details"}
</button>
{/* Expanded JSON view */}
{isExpanded && (
<pre className="mt-2 p-2 bg-zinc-900 rounded text-xs text-zinc-400 overflow-x-auto max-h-64">
{JSON.stringify(event.data, null, 2)}
</pre>
)}
</div>
);
}

View file

@ -0,0 +1,115 @@
"use client";
import { CapturedEvent } from "@/types";
interface FluxEventItemProps {
event: CapturedEvent;
isExpanded: boolean;
onToggleExpand: () => void;
}
const EVENT_COLORS: Record<string, string> = {
TurnInfo: "text-green-400 bg-green-500/10",
Connected: "text-yellow-400 bg-yellow-500/10",
Error: "text-red-500 bg-red-600/10",
default: "text-zinc-400 bg-zinc-500/10",
};
const FLUX_EVENT_COLORS: Record<string, string> = {
Update: "text-amber-300 bg-amber-500/20",
EndOfTurn: "text-emerald-300 bg-emerald-500/20",
EagerEndOfTurn: "text-cyan-300 bg-cyan-500/20",
StartOfTurn: "text-blue-300 bg-blue-500/20",
TurnResumed: "text-purple-300 bg-purple-500/20",
default: "text-zinc-300 bg-zinc-500/20",
};
export default function FluxEventItem({
event,
isExpanded,
onToggleExpand,
}: FluxEventItemProps) {
const colorClass = EVENT_COLORS[event.event_type] || EVENT_COLORS.default;
const data = event.data;
// Flux TurnInfo fields
const fluxEvent = data.event as string | undefined;
const transcript = data.transcript as string | undefined;
const endOfTurnConfidence = data.end_of_turn_confidence as number | undefined;
const turnIndex = data.turn_index as number | undefined;
const isFinal = fluxEvent === "EndOfTurn";
const fluxEventColor = fluxEvent
? FLUX_EVENT_COLORS[fluxEvent] || FLUX_EVENT_COLORS.default
: "";
// For non-TurnInfo events
const isConnection = event.event_type === "Connected";
return (
<div className="flex-1 min-w-0 space-y-1">
<div className="flex items-center gap-2 flex-wrap">
<span className={`text-xs px-2 py-0.5 rounded ${colorClass}`}>
{event.event_type}
</span>
{/* Flux sub-event type */}
{fluxEvent && (
<span className={`text-xs px-2 py-0.5 rounded ${fluxEventColor}`}>
{fluxEvent}
</span>
)}
{/* Final/Partial indicator */}
{fluxEvent && (
<span
className={`text-xs px-2 py-0.5 rounded ${
isFinal
? "text-emerald-400 bg-emerald-500/10"
: "text-amber-400 bg-amber-500/10"
}`}
>
{isFinal ? "Final" : "Partial"}
</span>
)}
{/* Turn index */}
{turnIndex !== undefined && (
<span className="text-xs text-zinc-500">
Turn {turnIndex}
</span>
)}
{/* EOT confidence */}
{endOfTurnConfidence !== undefined && (
<span className="text-xs text-zinc-500 font-mono">
EOT: {(endOfTurnConfidence * 100).toFixed(1)}%
</span>
)}
</div>
{/* Transcript or status message */}
<div className="text-sm text-zinc-300 truncate">
{transcript || (isConnection ? "[Connected]" : `[${fluxEvent || event.event_type}]`)}
</div>
{/* Expand/collapse button */}
<button
onClick={(e) => {
e.stopPropagation();
onToggleExpand();
}}
className="text-xs text-zinc-500 hover:text-zinc-300"
>
{isExpanded ? "Hide details" : "Show details"}
</button>
{/* Expanded JSON view */}
{isExpanded && (
<pre className="mt-2 p-2 bg-zinc-900 rounded text-xs text-zinc-400 overflow-x-auto max-h-64">
{JSON.stringify(event.data, null, 2)}
</pre>
)}
</div>
);
}

View file

@ -0,0 +1,101 @@
"use client";
import { CapturedEvent } from "@/types";
interface SpeechmaticsEventItemProps {
event: CapturedEvent;
isExpanded: boolean;
onToggleExpand: () => void;
}
const EVENT_COLORS: Record<string, string> = {
AddTranscript: "text-purple-400 bg-purple-500/10",
RecognitionStarted: "text-yellow-400 bg-yellow-500/10",
EndOfTranscript: "text-red-400 bg-red-500/10",
Warning: "text-orange-400 bg-orange-500/10",
Error: "text-red-500 bg-red-600/10",
default: "text-zinc-400 bg-zinc-500/10",
};
function getTranscript(event: CapturedEvent): string {
const data = event.data;
const results = data.results as Array<{
type?: string;
alternatives?: Array<{ content?: string }>;
}> | undefined;
if (results) {
const words = results
.filter((r) => r.type === "word" && r.alternatives?.[0]?.content)
.map((r) => r.alternatives![0].content)
.join(" ");
return words;
}
return "";
}
export default function SpeechmaticsEventItem({
event,
isExpanded,
onToggleExpand,
}: SpeechmaticsEventItemProps) {
const colorClass = EVENT_COLORS[event.event_type] || EVENT_COLORS.default;
const data = event.data;
const transcript = getTranscript(event);
// Status events
const isRecognitionStarted = event.event_type === "RecognitionStarted";
const isEndOfTranscript = event.event_type === "EndOfTranscript";
const isWarning = event.event_type === "Warning";
// Warning reason
const warningReason = isWarning ? (data.reason as string | undefined) : undefined;
return (
<div className="flex-1 min-w-0 space-y-1">
<div className="flex items-center gap-2 flex-wrap">
<span className={`text-xs px-2 py-0.5 rounded ${colorClass}`}>
{event.event_type}
</span>
{/* AddTranscript is always final in Speechmatics */}
{event.event_type === "AddTranscript" && (
<span className="text-xs px-2 py-0.5 rounded text-emerald-400 bg-emerald-500/10">
Final
</span>
)}
</div>
{/* Transcript or status message */}
<div className="text-sm text-zinc-300 truncate">
{transcript ||
(isRecognitionStarted
? "[Recognition Started]"
: isEndOfTranscript
? "[End of Transcript]"
: isWarning
? `[Warning: ${warningReason || "unknown"}]`
: `[${event.event_type}]`)}
</div>
{/* Expand/collapse button */}
<button
onClick={(e) => {
e.stopPropagation();
onToggleExpand();
}}
className="text-xs text-zinc-500 hover:text-zinc-300"
>
{isExpanded ? "Hide details" : "Show details"}
</button>
{/* Expanded JSON view */}
{isExpanded && (
<pre className="mt-2 p-2 bg-zinc-900 rounded text-xs text-zinc-400 overflow-x-auto max-h-64">
{JSON.stringify(event.data, null, 2)}
</pre>
)}
</div>
);
}

View file

@ -0,0 +1,3 @@
export { default as DeepgramEventItem } from "./DeepgramEventItem";
export { default as FluxEventItem } from "./FluxEventItem";
export { default as SpeechmaticsEventItem } from "./SpeechmaticsEventItem";

View file

@ -0,0 +1,24 @@
export interface CapturedEvent {
timestamp: number;
event_type: string;
data: Record<string, unknown>;
}
export interface EventCaptureResult {
audio_file: string;
audio_path: string;
provider: string;
duration: number;
created_at: string;
events: CapturedEvent[];
transcript: string;
}
export interface ResultSummary {
id: string;
audio_file: string;
provider: string;
duration: number;
created_at: string;
event_count: number;
}

View file

@ -0,0 +1,34 @@
{
"compilerOptions": {
"target": "ES2017",
"lib": ["dom", "dom.iterable", "esnext"],
"allowJs": true,
"skipLibCheck": true,
"strict": true,
"noEmit": true,
"esModuleInterop": true,
"module": "esnext",
"moduleResolution": "bundler",
"resolveJsonModule": true,
"isolatedModules": true,
"jsx": "react-jsx",
"incremental": true,
"plugins": [
{
"name": "next"
}
],
"paths": {
"@/*": ["./src/*"]
}
},
"include": [
"next-env.d.ts",
"**/*.ts",
"**/*.tsx",
".next/types/**/*.ts",
".next/dev/types/**/*.ts",
"**/*.mts"
],
"exclude": ["node_modules"]
}