# tester-army/e2e architecture

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

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

## Overview

e2e is an end-to-end testing framework: users write tests combining natural-language agent goals with ordinary locators and assertions, then run them against web or mobile apps. The visible runtime centers on browser and device engines, with a decision executor for semantic actions; provider packages extend those engines to hosted environments, and a GitHub reporter publishes results. The tree and excerpts do not include the core SDK/runner implementation, so its internal orchestration is not mapped. Links for capabilities documented only in the README use that README as evidence.

Main entry points: [`packages/decision/src/executor.ts`](https://github.com/tester-army/e2e/blob/main/packages/decision/src/executor.ts) (Decision executor), [`packages/web/src/engine.ts`](https://github.com/tester-army/e2e/blob/main/packages/web/src/engine.ts) (Browser engine), [`packages/mobile/src/engine.ts`](https://github.com/tester-army/e2e/blob/main/packages/mobile/src/engine.ts) (Mobile engine), [`packages/mobile/src/surface.ts`](https://github.com/tester-army/e2e/blob/main/packages/mobile/src/surface.ts) (Device surface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_decision["Agent decisions"]
  node_decisionexec["Decision executor<br/>[executor.ts]"]
  node_questionbuilder["Question builder<br/>[questions.ts]"]
  node_decisionmodel["Decision model adapter<br/>[decide.ts]"]
  node_actiondispatch["Action dispatch<br/>[dispatch.ts]"]
  node_visualoverlay["Image overlays<br/>[overlay.ts]"]
end

subgraph group_engines["App engines"]
  node_webengine["Browser engine<br/>[engine.ts]"]
  node_websurface["Browser surface<br/>[surface.ts]"]
  node_webbrowser["Browser fixture<br/>[browser.ts]"]
  node_mobileengine["Mobile engine<br/>[engine.ts]"]
  node_mobilesurface["Device surface<br/>[surface.ts]"]
  node_mobileactions["Device actions<br/>[actions.ts]"]
end

subgraph group_providers["Hosted providers"]
  node_kernel["Kernel browser provider<br/>[provider.ts]"]
  node_smol["smol browser provider<br/>[provider.ts]"]
  node_eas["EAS simulator provider<br/>[provider.ts]"]
  node_limrun["Limrun device provider<br/>[provider.ts]"]
end

subgraph group_reporting["Result reporting"]
  node_githubreporter["GitHub reporter<br/>[reporter.ts]"]
end

node_author(("Test author"))
node_webapp(("Web app"))
node_mobileapp(("Mobile app"))
node_pullrequest(("Pull request"))

node_author -->|"sets agent goal"| node_decisionexec
node_decisionexec -->|"builds questions"| node_questionbuilder
node_decisionexec -->|"requests decisions"| node_decisionmodel
node_decisionexec -->|"performs actions"| node_actiondispatch
node_decisionexec -.->|"uses image tools"| node_visualoverlay
node_author -->|"configures web tests"| node_webengine
node_author -->|"configures mobile tests"| node_mobileengine
node_webengine -->|"creates surface"| node_websurface
node_webengine -->|"creates fixture"| node_webbrowser
node_websurface -.->|"drives browser"| node_webapp
node_mobileengine -->|"configures surface"| node_mobilesurface
node_mobilesurface -->|"uses actions"| node_mobileactions
node_mobilesurface -.->|"drives device"| node_mobileapp
node_kernel -->|"provides browsers"| node_webengine
node_smol -->|"provides browsers"| node_webengine
node_eas -->|"provides simulators"| node_mobileengine
node_limrun -->|"provides devices"| node_mobileengine
node_githubreporter -->|"posts results"| node_pullrequest

click node_decisionexec "https://github.com/tester-army/e2e/blob/main/packages/decision/src/executor.ts"
click node_questionbuilder "https://github.com/tester-army/e2e/blob/main/packages/decision/src/questions.ts"
click node_decisionmodel "https://github.com/tester-army/e2e/blob/main/packages/decision/src/decide.ts"
click node_actiondispatch "https://github.com/tester-army/e2e/blob/main/packages/decision/src/dispatch.ts"
click node_visualoverlay "https://github.com/tester-army/e2e/blob/main/packages/decision/src/overlay.ts"
click node_webengine "https://github.com/tester-army/e2e/blob/main/packages/web/src/engine.ts"
click node_websurface "https://github.com/tester-army/e2e/blob/main/packages/web/src/surface.ts"
click node_webbrowser "https://github.com/tester-army/e2e/blob/main/packages/web/src/browser.ts"
click node_mobileengine "https://github.com/tester-army/e2e/blob/main/packages/mobile/src/engine.ts"
click node_mobilesurface "https://github.com/tester-army/e2e/blob/main/packages/mobile/src/surface.ts"
click node_mobileactions "https://github.com/tester-army/e2e/blob/main/packages/mobile/src/actions.ts"
click node_kernel "https://github.com/tester-army/e2e/blob/main/packages/kernel/src/provider.ts"
click node_smol "https://github.com/tester-army/e2e/blob/main/packages/smol/src/provider.ts"
click node_eas "https://github.com/tester-army/e2e/blob/main/packages/eas/src/provider.ts"
click node_limrun "https://github.com/tester-army/e2e/blob/main/packages/limrun/src/provider.ts"
click node_githubreporter "https://github.com/tester-army/e2e/blob/main/packages/github/src/reporter.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_decisionexec,node_questionbuilder,node_decisionmodel,node_actiondispatch,node_visualoverlay toneBlue
class node_webengine,node_websurface,node_webbrowser,node_mobileengine,node_mobilesurface,node_mobileactions toneAmber
class node_kernel,node_smol,node_eas,node_limrun,node_pullrequest toneMint
class node_githubreporter toneRose
class node_author,node_webapp,node_mobileapp toneIndigo
```

## Components

### Agent decisions

- [Decision executor](https://github.com/tester-army/e2e/blob/main/packages/decision/src/executor.ts): `packages/decision/src/executor.ts`
- [Question builder](https://github.com/tester-army/e2e/blob/main/packages/decision/src/questions.ts): `packages/decision/src/questions.ts`
- [Decision model adapter](https://github.com/tester-army/e2e/blob/main/packages/decision/src/decide.ts): `packages/decision/src/decide.ts`
- [Action dispatch](https://github.com/tester-army/e2e/blob/main/packages/decision/src/dispatch.ts): `packages/decision/src/dispatch.ts`
- [Image overlays](https://github.com/tester-army/e2e/blob/main/packages/decision/src/overlay.ts): `packages/decision/src/overlay.ts`

### App engines

- [Browser engine](https://github.com/tester-army/e2e/blob/main/packages/web/src/engine.ts): `packages/web/src/engine.ts`
- [Browser surface](https://github.com/tester-army/e2e/blob/main/packages/web/src/surface.ts): `packages/web/src/surface.ts`
- [Browser fixture](https://github.com/tester-army/e2e/blob/main/packages/web/src/browser.ts): `packages/web/src/browser.ts`
- [Mobile engine](https://github.com/tester-army/e2e/blob/main/packages/mobile/src/engine.ts): `packages/mobile/src/engine.ts`
- [Device surface](https://github.com/tester-army/e2e/blob/main/packages/mobile/src/surface.ts): `packages/mobile/src/surface.ts`
- [Device actions](https://github.com/tester-army/e2e/blob/main/packages/mobile/src/actions.ts): `packages/mobile/src/actions.ts`

### Hosted providers

- [Kernel browser provider](https://github.com/tester-army/e2e/blob/main/packages/kernel/src/provider.ts): `packages/kernel/src/provider.ts`
- [smol browser provider](https://github.com/tester-army/e2e/blob/main/packages/smol/src/provider.ts): `packages/smol/src/provider.ts`
- [EAS simulator provider](https://github.com/tester-army/e2e/blob/main/packages/eas/src/provider.ts): `packages/eas/src/provider.ts`
- [Limrun device provider](https://github.com/tester-army/e2e/blob/main/packages/limrun/src/provider.ts): `packages/limrun/src/provider.ts`

### Result reporting

- [GitHub reporter](https://github.com/tester-army/e2e/blob/main/packages/github/src/reporter.ts): `packages/github/src/reporter.ts`

### Other components

- **Test author**
- **Web app**
- **Mobile app**
- **Pull request**

## Connections

- Test author → Decision executor: sets agent goal (evidence: `README.md`)
- Decision executor → Question builder: builds questions (evidence: `packages/decision/src/executor.ts`)
- Decision executor → Decision model adapter: requests decisions (evidence: `packages/decision/src/executor.ts`)
- Decision executor → Action dispatch: performs actions (evidence: `packages/decision/src/executor.ts`)
- Decision executor → Image overlays: uses image tools (evidence: `packages/decision/src/executor.ts`)
- Test author → Browser engine: configures web tests (evidence: `README.md`)
- Test author → Mobile engine: configures mobile tests (evidence: `README.md`)
- Browser engine → Browser surface: creates surface (evidence: `packages/web/src/engine.ts`)
- Browser engine → Browser fixture: creates fixture (evidence: `packages/web/src/engine.ts`)
- Browser surface → Web app: drives browser
- Mobile engine → Device surface: configures surface (evidence: `packages/mobile/src/engine.ts`)
- Device surface → Device actions: uses actions (evidence: `packages/mobile/src/surface.ts`)
- Device surface → Mobile app: drives device
- Kernel browser provider → Browser engine: provides browsers (evidence: `README.md`)
- smol browser provider → Browser engine: provides browsers (evidence: `packages/smol/src/provider.ts`)
- EAS simulator provider → Mobile engine: provides simulators (evidence: `packages/eas/src/provider.ts`)
- Limrun device provider → Mobile engine: provides devices (evidence: `packages/limrun/src/provider.ts`)
- GitHub reporter → Pull request: posts results (evidence: `README.md`)
