BrowserLaunch
Sole Developer & Architect
Browser automation coordination layer built as a Convex component. Manages automation tasks, runs, steps, sessions, and wake signals for browser-based workloads. Used by AdaScout for ADA compliance scanning and MyLaddr for job application automation. The component provides a task queue (enqueueTask) with app/queue/status indexing, replay step recording with screenshots, and session lifecycle management. Browser execution delegates to Browserless (Chromium via CDP) or Browserbase (Stagehand).
automationTasks, automationRuns, automationRunSteps, automationRunArtifacts, automationSessions, automationWakeSignals
AdaScout (ADA scanning) and MyLaddr (job applications)
The Problem
Running browser automation at scale requires managing task queues, session state, step replay for debugging, and coordination between multiple automation apps — each with different browser requirements.
The Solution
Built a reusable Convex component (launchthat-plugin-browserlaunch) that provides automation task orchestration. Apps enqueue tasks with type/queue/payload, the component tracks runs and steps, records artifacts and screenshots for replay, and manages wake signals. Browser execution uses Browserless Chromium (CDP WebSocket) or Browserbase Stagehand depending on the scanning mode.
System Architecture
Engineering Details
- Convex component schema: automationTasks indexed by (status, createdAt), (queue, status, createdAt), (app, status, createdAt)
- Task lifecycle: enqueueTask → run creation → step recording with artifacts/screenshots → completion/failure
- Wake signal system for coordinating between browser sessions and consuming apps
- Replay: listBrowserLaunchReplayStepsForPageRun links screenshots and step data to parent scan runs
Key Highlights
- Convex component for automation task orchestration (enqueueTask, runs, steps, artifacts)
- Task queue with app/queue/status indexing for priority-based execution
- Replay step recording with screenshots for debugging
- Used by AdaScout and MyLaddr as a shared automation substrate
- Browserless Chromium (CDP) and Browserbase Stagehand execution backends
- Session lifecycle management with wake signals