How bug0inc/qa-agent works
Bug0 AI is a Playwright library for natural-language regression tests. The principal workflow starts at runSteps: it resolves dynamic inputs and per-step AI settings, executes browser actions through snapshot-based models or optional CUA, waits and extracts values, then validates assertions (including optional video review). Redis-backed caching, email extraction, script safety, and telemetry are supporting capabilities. Edges reflect imports/calls visible in the excerpts or SOURCE INDEX; README-only feature links are labeled as documented.
Main entry points: index.ts Step runner · loop.ts Computer-use loop · config.ts AI configuration · models.ts Model routing
Components 21
Test workflow
- Step runner
src/index.ts - Dynamic placeholders
src/data-cache.ts - AI wait conditions
src/utils/index.ts - Page data extraction
src/extract.ts - Safe script execution
src/utils/secure-script-runner.ts - Tab management
src/utils/tab-manager.ts
AI execution
- Model routing
src/models.ts - AI configuration
src/config.ts - Snapshot actions
src/tools.ts - Computer-use loop
src/cua/loop.ts - CUA actions
src/cua/actions.ts - OpenAI CUA client
src/cua/client.ts
Assertions and evidence
- Assertion consensus
src/assertion.ts - Video assertions
src/video.ts
Test data and integrations
- Redis cache
src/redis.ts - Email extraction
src/email.ts - Emailsink provider
src/providers/emailsink.ts
Runtime support
- AI telemetry
src/instrumentation.ts - Logging
src/logger.ts - Runtime errors
src/errors.ts
Other components
- Playwright test
Connections 26
- Playwright test → Step runner: invokes
README.md - Step runner → Dynamic placeholders: resolves inputs
src/index.ts - Step runner → Safe script execution: runs scripts
src/index.ts - Step runner → AI wait conditions: checks conditions
src/index.ts - Step runner → Page data extraction: applies extraction
src/index.ts - Step runner → Tab management: manages tabs
src/index.ts - Step runner → Snapshot actions: executes steps
src/index.ts - Step runner → Computer-use loop: dispatches CUA
src/index.ts - Computer-use loop → CUA actions: executes actions
src/cua/loop.ts - Computer-use loop → OpenAI CUA client: uses client
src/cua/loop.ts - Step runner → AI configuration: resolves AI
src/index.ts - Step runner → Assertion consensus: runs assertions
src/index.ts - Step runner → Video assertions: records and evaluates
src/index.ts - Assertion consensus → Model routing: resolves models
src/assertion.ts - Assertion consensus → Video assertions: evaluates video
src/assertion.ts - AI wait conditions → Model routing: resolves model
src/utils/index.ts - Page data extraction → Model routing: uses models
src/extract.ts - Dynamic placeholders → Redis cache: reads and writes
src/data-cache.ts - Dynamic placeholders → Email extraction: extracts email
src/data-cache.ts - Email extraction → Emailsink provider: uses provider
- Model routing → AI configuration: reads settings
src/models.ts - AI configuration → AI telemetry: initializes telemetry
src/config.ts - AI telemetry → Logging: logs
src/instrumentation.ts - Computer-use loop → Logging: logs
src/cua/loop.ts - Computer-use loop → AI configuration: reads settings
src/cua/loop.ts - OpenAI CUA client → AI configuration: checks gateway type
src/cua/client.ts