Trace Core Engine
Trace is an AI-powered debugging intelligence engine that understands web application state and provides automated analysis.
What It Actually Is
Input: User Query + Tool Execution Results
Output: Intelligent analysis, issues, recommendations
- /v1/plan → AI decides which tools to run
- /v1/analyze → AI explains what the results mean
The Core Engine Does:
- Planning — Given a debugging question, determines which tools to execute.
- Analysis — Given tool results, provides human-readable explanations.
The Core Engine Does NOT:
- Execute tools (that's done by the clients: Extension, SDK, CLI).
- Connect to browsers (that's the client's job).
- Store any browser data (stateless API).
Clients (One Brain, Many Hands)
| Client | Executes Tools Via | Use Case |
|---|---|---|
| Extension | CDP (local browser) | Live debugging in Chrome |
| SDK | Puppeteer / CDP | CI/CD pipelines, automated tests |
| CLI | Puppeteer / CDP | Terminal-based debugging |
How it works
- 1User Asks QuestionClient sends query to
/v1/plan. - 2Engine Plans ToolsEngine returns a plan (e.g., "Run
get_dom_state"). - 3Client Executes ToolsClient runs tools via CDP/Puppeteer and sends results to
/v1/analyze. - 4Engine Analyzing InsightsEngine returns a human-readable explanation and fix.