How e2e-inc/e2e works
e2e is an end-to-end testing framework for web and mobile apps. A test declares a goal; the runner resolves its target and app, starts an engine session, and uses an agent to drive the app. Locators and assertions check the outcome, while recorded agent actions can be replayed on later runs. The graph shows the documented workflow and major engine, model, cloud-provider, and reporting capabilities. Source excerpts are partial, so some implementation-level links—especially provider wiring—are not shown.
Main entry points: engine-sessions.ts SDK and runner · tool-loop.ts Agent actions · src/engine.ts Web engine · src/engine.ts Mobile engine
Components 21
Test authoring and runner
- SDK and runner
packages/core/src/run/engine-sessions.ts - Target configuration
packages/core/src/config/app.ts - Engine contract
packages/core/src/engine/contract.ts - Locators and assertions
packages/core/src/locator/engine.ts
Agent and decisions
- Agent actions
packages/core/src/agent/tool-loop.ts - Decision models
packages/decision/src/decide.ts - ACP executor
packages/acp/src/executor.ts
App engines
- Web engine
packages/web/src/engine.ts - Browser surface
packages/web/src/surface.ts - Mobile engine
packages/mobile/src/engine.ts - Device surface
packages/mobile/src/surface.ts
Execution providers
- Browser providers
packages/web/src/provider.ts - Mobile providers
packages/mobile/src/provider.ts - Hosted runtimes
packages/browser-run/src/provider.ts
Results and integrations
- Run reporters
packages/html-reporter/src/reporter.ts - GitHub reporter
packages/github/src/reporter.ts - Run artifacts
packages/core/src/run/artifacts.ts
Other components
- Test author
- Model service
- Web app
- Mobile app
Connections 23
- Test author → SDK and runner: defines tests
README.md - SDK and runner → Target configuration: resolves targets
packages/core/src/run/engine-sessions.ts - SDK and runner → Engine contract: drives engine
packages/core/src/run/engine-sessions.ts - Target configuration → Web engine: selects web
README.md - Target configuration → Mobile engine: selects mobile
README.md - SDK and runner → Locators and assertions: runs assertions
README.md - SDK and runner → Agent actions: runs agent steps
README.md - Agent actions → Model service: requests decisions
README.md - Agent actions → Decision models: uses executors
README.md - Agent actions → ACP executor: can delegate
README.md - Web engine → Engine contract: implements contract
packages/web/src/engine.ts - Mobile engine → Engine contract: implements contract
packages/mobile/src/engine.ts - Web engine → Browser surface: configures browser
packages/web/src/engine.ts - Mobile engine → Device surface: configures device
packages/mobile/src/engine.ts - Web engine → Browser providers: uses provider
packages/web/src/engine.ts - Mobile engine → Mobile providers: uses provider
- Browser providers → Hosted runtimes: can provision
README.md - Mobile providers → Hosted runtimes: can provision
README.md - Browser surface → Web app: drives browser
README.md - Device surface → Mobile app: drives device
README.md - SDK and runner → Run artifacts: records artifacts
README.md - SDK and runner → Run reporters: reports results
README.md - SDK and runner → GitHub reporter: can post results
README.md