How tester-army/e2e works
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: executor.ts Decision executor · src/engine.ts Browser engine · src/engine.ts Mobile engine · surface.ts Device surface
Components 20
Agent decisions
- Decision executor
packages/decision/src/executor.ts - Question builder
packages/decision/src/questions.ts - Decision model adapter
packages/decision/src/decide.ts - Action dispatch
packages/decision/src/dispatch.ts - Image overlays
packages/decision/src/overlay.ts
App engines
- Browser engine
packages/web/src/engine.ts - Browser surface
packages/web/src/surface.ts - Browser fixture
packages/web/src/browser.ts - Mobile engine
packages/mobile/src/engine.ts - Device surface
packages/mobile/src/surface.ts - Device actions
packages/mobile/src/actions.ts
Hosted providers
- Kernel browser provider
packages/kernel/src/provider.ts - smol browser provider
packages/smol/src/provider.ts - EAS simulator provider
packages/eas/src/provider.ts - Limrun device provider
packages/limrun/src/provider.ts
Result reporting
- GitHub reporter
packages/github/src/reporter.ts
Other components
- Test author
- Web app
- Mobile app
- Pull request
Connections 18
- Test author → Decision executor: sets agent goal
README.md - Decision executor → Question builder: builds questions
packages/decision/src/executor.ts - Decision executor → Decision model adapter: requests decisions
packages/decision/src/executor.ts - Decision executor → Action dispatch: performs actions
packages/decision/src/executor.ts - Decision executor → Image overlays: uses image tools
packages/decision/src/executor.ts - Test author → Browser engine: configures web tests
README.md - Test author → Mobile engine: configures mobile tests
README.md - Browser engine → Browser surface: creates surface
packages/web/src/engine.ts - Browser engine → Browser fixture: creates fixture
packages/web/src/engine.ts - Browser surface → Web app: drives browser
- Mobile engine → Device surface: configures surface
packages/mobile/src/engine.ts - Device surface → Device actions: uses actions
packages/mobile/src/surface.ts - Device surface → Mobile app: drives device
- Kernel browser provider → Browser engine: provides browsers
README.md - smol browser provider → Browser engine: provides browsers
packages/smol/src/provider.ts - EAS simulator provider → Mobile engine: provides simulators
packages/eas/src/provider.ts - Limrun device provider → Mobile engine: provides devices
packages/limrun/src/provider.ts - GitHub reporter → Pull request: posts results
README.md