# e2e-inc/e2e architecture

> Architecture diagram of the GitHub repository e2e-inc/e2e, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/e2e-inc/e2e
- Repository: https://github.com/e2e-inc/e2e

## Overview

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: [`packages/core/src/run/engine-sessions.ts`](https://github.com/e2e-inc/e2e/blob/main/packages/core/src/run/engine-sessions.ts) (SDK and runner), [`packages/core/src/agent/tool-loop.ts`](https://github.com/e2e-inc/e2e/blob/main/packages/core/src/agent/tool-loop.ts) (Agent actions), [`packages/web/src/engine.ts`](https://github.com/e2e-inc/e2e/blob/main/packages/web/src/engine.ts) (Web engine), [`packages/mobile/src/engine.ts`](https://github.com/e2e-inc/e2e/blob/main/packages/mobile/src/engine.ts) (Mobile engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Test authoring and runner"]
  node_sdk_runner["SDK and runner<br/>[engine-sessions.ts]"]
  node_target_config["Target configuration<br/>[app.ts]"]
  node_engine_contract["Engine contract<br/>[contract.ts]"]
  node_locator_runtime["Locators and assertions<br/>[engine.ts]"]
end

subgraph group_agent["Agent and decisions"]
  node_agent_loop["Agent actions<br/>[tool-loop.ts]"]
  node_decision_models["Decision models<br/>[decide.ts]"]
  node_acp_executor["ACP executor<br/>[executor.ts]"]
end

subgraph group_engines["App engines"]
  node_web_engine["Web engine<br/>[engine.ts]"]
  node_web_surface["Browser surface<br/>[surface.ts]"]
  node_mobile_engine["Mobile engine<br/>[engine.ts]"]
  node_mobile_surface["Device surface<br/>[surface.ts]"]
end

subgraph group_providers["Execution providers"]
  node_browser_provider["Browser providers<br/>[provider.ts]"]
  node_mobile_provider["Mobile providers<br/>[provider.ts]"]
  node_hosted_services["Hosted runtimes<br/>[provider.ts]"]
end

subgraph group_results["Results and integrations"]
  node_reporters["Run reporters<br/>[reporter.ts]"]
  node_github_reporter["GitHub reporter<br/>[reporter.ts]"]
  node_run_artifacts["Run artifacts<br/>[artifacts.ts]"]
end

node_test_author(("Test author"))
node_model_service(("Model service"))
node_web_app["Web app"]
node_mobile_app["Mobile app"]

node_test_author -->|"defines tests"| node_sdk_runner
node_sdk_runner -->|"resolves targets"| node_target_config
node_sdk_runner -->|"drives engine"| node_engine_contract
node_target_config -.->|"selects web"| node_web_engine
node_target_config -.->|"selects mobile"| node_mobile_engine
node_sdk_runner -->|"runs assertions"| node_locator_runtime
node_sdk_runner -->|"runs agent steps"| node_agent_loop
node_agent_loop -->|"requests decisions"| node_model_service
node_agent_loop -.->|"uses executors"| node_decision_models
node_agent_loop -.->|"can delegate"| node_acp_executor
node_web_engine -->|"implements contract"| node_engine_contract
node_mobile_engine -->|"implements contract"| node_engine_contract
node_web_engine -->|"configures browser"| node_web_surface
node_mobile_engine -->|"configures device"| node_mobile_surface
node_web_engine -.->|"uses provider"| node_browser_provider
node_mobile_engine -.->|"uses provider"| node_mobile_provider
node_browser_provider -.->|"can provision"| node_hosted_services
node_mobile_provider -.->|"can provision"| node_hosted_services
node_web_surface -.->|"drives browser"| node_web_app
node_mobile_surface -.->|"drives device"| node_mobile_app
node_sdk_runner -.->|"records artifacts"| node_run_artifacts
node_sdk_runner -.->|"reports results"| node_reporters
node_sdk_runner -.->|"can post results"| node_github_reporter

click node_sdk_runner "https://github.com/e2e-inc/e2e/blob/main/packages/core/src/run/engine-sessions.ts"
click node_target_config "https://github.com/e2e-inc/e2e/blob/main/packages/core/src/config/app.ts"
click node_engine_contract "https://github.com/e2e-inc/e2e/blob/main/packages/core/src/engine/contract.ts"
click node_locator_runtime "https://github.com/e2e-inc/e2e/blob/main/packages/core/src/locator/engine.ts"
click node_agent_loop "https://github.com/e2e-inc/e2e/blob/main/packages/core/src/agent/tool-loop.ts"
click node_decision_models "https://github.com/e2e-inc/e2e/blob/main/packages/decision/src/decide.ts"
click node_acp_executor "https://github.com/e2e-inc/e2e/blob/main/packages/acp/src/executor.ts"
click node_web_engine "https://github.com/e2e-inc/e2e/blob/main/packages/web/src/engine.ts"
click node_web_surface "https://github.com/e2e-inc/e2e/blob/main/packages/web/src/surface.ts"
click node_mobile_engine "https://github.com/e2e-inc/e2e/blob/main/packages/mobile/src/engine.ts"
click node_mobile_surface "https://github.com/e2e-inc/e2e/blob/main/packages/mobile/src/surface.ts"
click node_browser_provider "https://github.com/e2e-inc/e2e/blob/main/packages/web/src/provider.ts"
click node_mobile_provider "https://github.com/e2e-inc/e2e/blob/main/packages/mobile/src/provider.ts"
click node_hosted_services "https://github.com/e2e-inc/e2e/blob/main/packages/browser-run/src/provider.ts"
click node_reporters "https://github.com/e2e-inc/e2e/blob/main/packages/html-reporter/src/reporter.ts"
click node_github_reporter "https://github.com/e2e-inc/e2e/blob/main/packages/github/src/reporter.ts"
click node_run_artifacts "https://github.com/e2e-inc/e2e/blob/main/packages/core/src/run/artifacts.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_sdk_runner,node_target_config,node_engine_contract,node_locator_runtime toneBlue
class node_agent_loop,node_decision_models,node_acp_executor toneAmber
class node_web_engine,node_web_surface,node_mobile_engine,node_mobile_surface toneMint
class node_browser_provider,node_mobile_provider,node_hosted_services toneRose
class node_reporters,node_github_reporter,node_run_artifacts,node_test_author,node_model_service,node_web_app,node_mobile_app toneIndigo
```

## Components

### Test authoring and runner

- [SDK and runner](https://github.com/e2e-inc/e2e/blob/main/packages/core/src/run/engine-sessions.ts): `packages/core/src/run/engine-sessions.ts`
- [Target configuration](https://github.com/e2e-inc/e2e/blob/main/packages/core/src/config/app.ts): `packages/core/src/config/app.ts`
- [Engine contract](https://github.com/e2e-inc/e2e/blob/main/packages/core/src/engine/contract.ts): `packages/core/src/engine/contract.ts`
- [Locators and assertions](https://github.com/e2e-inc/e2e/blob/main/packages/core/src/locator/engine.ts): `packages/core/src/locator/engine.ts`

### Agent and decisions

- [Agent actions](https://github.com/e2e-inc/e2e/blob/main/packages/core/src/agent/tool-loop.ts): `packages/core/src/agent/tool-loop.ts`
- [Decision models](https://github.com/e2e-inc/e2e/blob/main/packages/decision/src/decide.ts): `packages/decision/src/decide.ts`
- [ACP executor](https://github.com/e2e-inc/e2e/blob/main/packages/acp/src/executor.ts): `packages/acp/src/executor.ts`

### App engines

- [Web engine](https://github.com/e2e-inc/e2e/blob/main/packages/web/src/engine.ts): `packages/web/src/engine.ts`
- [Browser surface](https://github.com/e2e-inc/e2e/blob/main/packages/web/src/surface.ts): `packages/web/src/surface.ts`
- [Mobile engine](https://github.com/e2e-inc/e2e/blob/main/packages/mobile/src/engine.ts): `packages/mobile/src/engine.ts`
- [Device surface](https://github.com/e2e-inc/e2e/blob/main/packages/mobile/src/surface.ts): `packages/mobile/src/surface.ts`

### Execution providers

- [Browser providers](https://github.com/e2e-inc/e2e/blob/main/packages/web/src/provider.ts): `packages/web/src/provider.ts`
- [Mobile providers](https://github.com/e2e-inc/e2e/blob/main/packages/mobile/src/provider.ts): `packages/mobile/src/provider.ts`
- [Hosted runtimes](https://github.com/e2e-inc/e2e/blob/main/packages/browser-run/src/provider.ts): `packages/browser-run/src/provider.ts`

### Results and integrations

- [Run reporters](https://github.com/e2e-inc/e2e/blob/main/packages/html-reporter/src/reporter.ts): `packages/html-reporter/src/reporter.ts`
- [GitHub reporter](https://github.com/e2e-inc/e2e/blob/main/packages/github/src/reporter.ts): `packages/github/src/reporter.ts`
- [Run artifacts](https://github.com/e2e-inc/e2e/blob/main/packages/core/src/run/artifacts.ts): `packages/core/src/run/artifacts.ts`

### Other components

- **Test author**
- **Model service**
- **Web app**
- **Mobile app**

## Connections

- Test author → SDK and runner: defines tests (evidence: `README.md`)
- SDK and runner → Target configuration: resolves targets (evidence: `packages/core/src/run/engine-sessions.ts`)
- SDK and runner → Engine contract: drives engine (evidence: `packages/core/src/run/engine-sessions.ts`)
- Target configuration → Web engine: selects web (evidence: `README.md`)
- Target configuration → Mobile engine: selects mobile (evidence: `README.md`)
- SDK and runner → Locators and assertions: runs assertions (evidence: `README.md`)
- SDK and runner → Agent actions: runs agent steps (evidence: `README.md`)
- Agent actions → Model service: requests decisions (evidence: `README.md`)
- Agent actions → Decision models: uses executors (evidence: `README.md`)
- Agent actions → ACP executor: can delegate (evidence: `README.md`)
- Web engine → Engine contract: implements contract (evidence: `packages/web/src/engine.ts`)
- Mobile engine → Engine contract: implements contract (evidence: `packages/mobile/src/engine.ts`)
- Web engine → Browser surface: configures browser (evidence: `packages/web/src/engine.ts`)
- Mobile engine → Device surface: configures device (evidence: `packages/mobile/src/engine.ts`)
- Web engine → Browser providers: uses provider (evidence: `packages/web/src/engine.ts`)
- Mobile engine → Mobile providers: uses provider
- Browser providers → Hosted runtimes: can provision (evidence: `README.md`)
- Mobile providers → Hosted runtimes: can provision (evidence: `README.md`)
- Browser surface → Web app: drives browser (evidence: `README.md`)
- Device surface → Mobile app: drives device (evidence: `README.md`)
- SDK and runner → Run artifacts: records artifacts (evidence: `README.md`)
- SDK and runner → Run reporters: reports results (evidence: `README.md`)
- SDK and runner → GitHub reporter: can post results (evidence: `README.md`)
