Michał Pierzchała
819d7dc8aa
feat: expose structured MCP command tools ( #593 )
...
* feat: expose semantic MCP tools
* docs: remove semantic mcp prd
* refactor: deepen semantic command surface
* refactor: add mcp execution seam
* refactor: deepen command grammar
* refactor: remove legacy command definitions
* refactor: collapse semantic cli wrappers
* refactor: remove local mcp placeholders
* refactor: derive semantic cli routing
* refactor: trim mcp status metadata
* refactor: derive semantic input contracts
* refactor: split semantic grammar modules
* refactor: derive batch input schema
* refactor: centralize cli command schema catalog
* refactor: share semantic cli output projections
* refactor: remove legacy cli output paths
* refactor: consolidate command interface surface
* docs: align command contract wording
* refactor: split command projection from cli grammar
* refactor: trim projection exports
* fix: satisfy fallow command contract audit
* refactor: structure public batch steps
* chore: clean batch architecture references
* fix: keep legacy cli batch steps working
* fix: serialize mcp batches
* chore: tighten command surface cleanup
* fix: serialize mcp stdin requests
* chore: keep mcp config out of command contracts
* fix: project structured batch targets
* chore: harden command input typing
* fix: project maestro backend for replay tests
* fix: preserve session mcp request options
2026-05-28 09:20:55 +02:00
Michał Pierzchała
a5fffc6e49
feat: add Maestro YAML replay compatibility ( #581 )
...
* feat: add Maestro replay compatibility
* fix: harden Maestro replay compatibility
* fix: address Maestro replay review feedback
* fix: finalize Maestro replay compatibility
* refactor: tighten Maestro replay compatibility boundary
* refactor: reduce Maestro replay quality debt
* refactor: satisfy Maestro replay fallow audit
* fix: stabilize Android provider snapshot tests
2026-05-27 21:45:51 +02:00
Michał Pierzchała
bbe7c06fb6
feat: auto-reverse Android localhost opens ( #590 )
...
* feat: auto-reverse Android localhost opens
* test: cover Android localhost reverse edge cases
* fix: reduce Android reverse error complexity
* docs: simplify Android Metro reverse guidance
* docs: prefer scripted SkillGym checks
* test: clarify Android Metro SkillGym plan
2026-05-26 10:44:51 +02:00
Michał Pierzchała
ea21793154
feat: support ios transform gesture ( #586 )
2026-05-26 09:58:33 +02:00
Michał Pierzchała
c72cf0e1d2
fix: clarify Android gesture transform behavior ( #584 )
...
* fix: clarify Android gesture transform behavior
* fix: stabilize Android transform injection
2026-05-26 09:47:07 +02:00
Michał Pierzchała
47b981c8ad
feat: add gesture command coverage ( #576 )
...
* feat: add gesture command coverage
* fix: align iOS fling provider fixture
* feat: group gesture commands
* fix: clarify android gesture support
* feat: add android multitouch gestures
* fix: address gesture review feedback
* refactor: simplify gesture plumbing
* fix: keep gesture subcommands internal
* fix: update iOS provider pan transcript
2026-05-22 18:01:58 +02:00
Michał Pierzchała
0bc1b1e927
fix: simplify iOS interactive snapshots ( #578 )
2026-05-21 16:19:53 +02:00
Michał Pierzchała
67aa89af58
feat: add iOS repro evidence capabilities ( #573 )
2026-05-21 13:39:52 +02:00
Michał Pierzchała
b0e19c9d1e
perf: improve recording and interaction flows ( #563 )
...
* perf: improve recording and interaction flows
* feat: add React Native overlay dismiss command
* test: cover RedBox overlay dismissal
* fix: simplify React Native overlay snapshot hint
* fix: address daemon and scroll review feedback
* fix: unblock ci after recording polish
* chore: refresh fallow health baseline
* test: stabilize android provider suites
* test: cover rn overlay provider command
2026-05-20 20:32:08 +02:00
Michał Pierzchała
f71371ebb8
fix: handle platform alerts ( #562 )
...
* fix: handle Android platform alerts
* fix: handle iOS alerts in runner
* chore: type alert metadata
* refactor: colocate Android alert handling
2026-05-20 14:51:17 +02:00
Michał Pierzchała
896adcc625
feat: add maestro replay compatibility ( #561 )
2026-05-19 20:49:34 +02:00
Michał Pierzchała
840bef56ca
fix: tighten env var surface ( #560 )
2026-05-19 17:11:31 +02:00
Michał Pierzchała
41508d29b1
fix: make mcp discovery-only ( #556 )
2026-05-18 15:56:36 +02:00
Michał Pierzchała
59d28e8446
refactor: add provider-first device lab tests ( #542 )
...
* refactor: add provider-first device lab tests
* refactor: tighten device lab provider seams
* test: cover provider lab contracts
* docs: record device lab harness direction
* ci: run device lab integration tests
* test: move device lab under integration
* test: extract device lab helpers
* refactor: centralize apps filter defaults
* test: drop lab-covered unit tests
* test: fold platform happy paths into device lab
* test: reuse device lab helpers
* test: move device lab to in-process harness
* test: replace session handler cases with device lab
* test: harden device lab scenario contracts
* docs: define unit test retention policy
* test: expand provider device lab coverage
* test: harden provider device lab coverage
* test: cover manifest install and runner session contracts
* chore: remove unused provider cleanup code
* test: split android find device lab scenario
* test: track provider lab architecture progress
* test: clarify provider lab roadmap progress
* test: advance provider lab session coverage
* test: move menubar click routing to device lab
* test: move menubar snapshots to device lab
* refactor: centralize screenshot flag plumbing
* refactor: colocate screenshot flag metadata
* test: cover all public commands in device lab
* test: move macos wait success to device lab
* test: drop redundant perf and diff units
* test: move push payload paths to device lab
* test: move network parsing to device lab
* test: move log cleanup to device lab
* test: move log restart and boot to device lab
* test: move ios physical boot to device lab
* test: cover perf startup in device lab
* test: extract android and ios device lab worlds
* test: trim device lab world surface
* test: split snapshot capture unit coverage
* test: deepen device lab coverage and trim handler units
* test: clean up device lab migration scaffolding
* test: report device lab public command coverage
* refactor: make Apple provider seams semantic
* refactor: tighten device inventory and Linux provider seams
* refactor: tighten request provider scoping
* refactor: add semantic macos host provider
* test: broaden device lab find coverage
* test: cover workflow flags in device lab
* refactor: promote linux input provider seam
* test: clarify device lab flag coverage
* test: classify snapshot force-full progress
* test: enforce device lab progress in ci
* test: stabilize device lab ci
* test: move packaged metro smoke to integration
* test: drop stale provider seam coverage
* test: harden provider scope regression coverage
* refactor: remove stale platform barrels
* refactor: keep linux clipboard and screenshots semantic
* refactor: move macos host tools behind provider
* fix: honor remote artifact output paths
* test: deepen runtime coverage for daemon and runner paths
* test: share loopback test helpers
* refactor: make daemon runtime importable
* fix: honor replay target metadata
* chore: tighten final device lab quality gates
* test: share device lab setup helpers
* test: remove generic apple lab fallback
* test: deduplicate device lab helpers
* chore: tighten fallow duplication signal
* refactor: share apple diagnostic helpers
* fix: detect active android ime during fill verification
* test: consolidate provider-backed integration suite
* ci: fix fallow and iOS smoke setup
* chore: consolidate cleanup after ci fixes
* test: split vitest unit and integration projects
* docs: mention MCP discovery metadata
* docs: add agent skills context pointers
* fix: close provider recording coverage gaps
* fix: restore mcp compatibility smoke
* test: cover provider edge regressions
* test: consolidate loopback helpers
* docs: remove stale provider routing reference
* fix: harden final provider review issues
* chore: defer mcp cleanup from provider refactor
2026-05-18 14:50:52 +02:00
Michał Pierzchała
068d4c5d0a
chore: remove ensure-simulator lifecycle command ( #552 )
2026-05-15 19:23:45 +02:00
Michał Pierzchała
8f722c3c5f
docs: guide bounded react devtools profiling ( #548 )
2026-05-15 18:56:05 +02:00
Michał Pierzchała
c1550721ce
fix: collapse Android snapshot row noise ( #545 )
...
* fix: collapse Android snapshot row noise
* docs: clarify agent-facing snapshot text
* fix: preserve semantics when collapsing Android snapshots
* fix: trim redundant Android collapse hints
* fix: collapse passive Android duplicate children
* refactor: drop unused Android snapshot hint code
* docs: clarify Android Metro verification guidance
* test: cover Android Metro reverse planning
* test: fix codex skillgym runner
* fix: satisfy fallow snapshot checks
* docs: clarify PR validation guidance
2026-05-15 18:52:11 +02:00
Michał Pierzchała
7e14decce3
fix: improve Android text entry stability ( #540 )
...
* fix: improve android text entry stability
* fix: stabilize android daemon diagnostics
* chore: refresh fallow baselines
* refactor: tighten android text fallback
* fix: tighten android input ownership diagnostics
* fix: require settled android fill verification
* test: cover android fill prefix verification
2026-05-15 12:16:06 +02:00
Michał Pierzchała
83efe54407
fix: default apps listing to user-installed ( #541 )
2026-05-15 11:06:27 +02:00
Michał Pierzchała
801c2ae0b3
fix: improve rn agent-device stability guidance ( #519 )
2026-05-14 17:30:45 +02:00
Michał Pierzchała
d12d27de21
docs: clarify agent-device shell resolution ( #522 )
2026-05-14 13:27:59 +02:00
Michał Pierzchała
517b5198b4
docs: clarify agent-device binary resolution ( #511 )
2026-05-13 14:52:46 +02:00
Anupam Chugh
a90642544d
feat: support precise location settings ( #491 )
...
* feat: support precise location settings
* fix: address location settings review
* chore: refresh fallow baselines for location settings
* fix: clean up location settings dispatch
---------
Co-authored-by: anupamchugh <anupamchugh@gmail.com >
Co-authored-by: Michał Pierzchała <thymikee@gmail.com >
2026-05-12 12:07:59 +02:00
Michał Pierzchała
8a1e195599
docs: trim stale internal docs ( #498 )
2026-05-12 10:31:27 +02:00
Michał Pierzchała
2ebb9aa4a6
docs: improve agent discovery onboarding ( #496 )
2026-05-11 21:07:48 +02:00
Michał Pierzchała
25d72895c5
feat: add MCP discovery router ( #494 )
2026-05-11 17:28:04 +02:00
Michał Pierzchała
10fd292569
fix: stabilize remote DevTools and install workflow ( #490 )
...
* 0.14.6
* fix: harden remote install workflow
* fix: prevent companion startup state race
* fix: guide remote ios devtools reconnects
2026-05-01 07:27:36 -04:00
Michał Pierzchała
7d47c6796a
fix: persist remote react devtools companion ( #489 )
2026-04-30 16:18:54 -04:00
Michał Pierzchała
7ea8d9eea3
feat: discover cloud config during connect ( #488 )
...
* feat: discover cloud config during connect
* test: isolate cloud connect profile coverage
* docs: document cloud connect discovery
* fix: honor no-login after cloud auth reuse
* fix: validate cloud connection profiles
* refactor: require object cloud profiles
* refactor: trim cloud connect compatibility code
2026-04-30 16:16:56 -04:00
Michał Pierzchała
6a55d48938
fix: tunnel remote ios react devtools ( #486 )
2026-04-30 12:36:02 -04:00
Michał Pierzchała
8aa4abe465
feat: expand android adb provider boundary ( #481 )
2026-04-29 21:45:42 -04:00
Michał Pierzchała
cff8bd81e4
feat: add iOS frame perf sampling ( #477 )
...
* feat: add iOS frame perf sampling
* fix: satisfy fallow for iOS perf sampling
* refactor: address iOS perf review feedback
* fix: handle optional iOS display info export
* fix: retry iOS trace record lock failures
* fix: correct iOS perf retry windows
2026-04-29 21:20:21 -04:00
Michał Pierzchała
fea7a5b73f
feat: expose daemon embedding and Android ADB APIs ( #480 )
2026-04-29 19:18:17 -04:00
Michał Pierzchała
0c7e48d7d5
feat: add Android frame health perf metrics ( #474 )
2026-04-29 16:56:37 -04:00
Michał Pierzchała
6a2bf9f626
feat: export batch orchestration helpers ( #472 )
2026-04-29 10:48:17 -04:00
Michał Pierzchała
bbb1d363c2
fix: handle iOS keyboard Done dismiss controls ( #469 )
2026-04-28 21:20:09 -04:00
Michał Pierzchała
6c368bf792
docs: update agent-device guidance ( #467 )
2026-04-28 17:07:33 -04:00
Michał Pierzchała
d1a764105f
chore: update version guidance to >=0.14.0
2026-04-28 14:40:28 -04:00
Michał Pierzchała
140fe338c2
docs: replace bulky skills with versioned CLI help ( #352 )
...
* docs: move agent guidance into help workflows
* test: address skill help review feedback
* docs: surface agent workflow in top-level help
* docs: strengthen dogfood help workflow
* docs: improve react devtools performance routing
* test: thin skillgym prompt
* docs: gate skills on help topic version
* test: stabilize thin help skillgym
* docs: restore dogfood QA guidance
* test: cover truncated text scoped snapshots
* docs: clarify remote help wording
* test: cover rn overlays and expo launch guidance
* test: cover expo launch after app lookup miss
* test: refine rn warning overlay workflow
* docs: restore react devtools advanced guidance
* test: cover restored agent guidance gaps
* test: cover device workflow edge cases
* docs: clarify agent-device install guidance
* docs: route known limitations through help
* docs: clarify bootstrap help for small models
* docs: tighten debug workflow guidance
* docs: remove local test note from workflow help
2026-04-28 14:14:55 -04:00
Michał Pierzchała
d77a9211ab
feat: add Android snapshot helper ( #454 )
...
* feat: add android snapshot helper
* fix: harden android snapshot helper packaging
* fix: harden android xml attribute parsing
* fix: capture android helper window roots
* fix: validate android helper install args
* fix: harden android helper manifest and traversal
* refactor: drop unused helper timeout parameter
* feat: bundle android snapshot helper in npm package
* feat: enable bundled android snapshot helper by default
* refactor: simplify android snapshot helper resolution
* fix: harden android snapshot helper artifacts
* refactor: split android snapshot helper modules
* fix: use type-only snapshot helper imports
2026-04-27 16:01:37 -04:00
Michał Pierzchała
7c5b7670c8
feat: add skillgym tests ( #453 )
2026-04-26 20:49:59 -04:00
Michał Pierzchała
40fe5e23cc
fix: improve cloud remote auth UX ( #452 )
2026-04-26 18:42:45 -04:00
Michał Pierzchała
2e2b9af8c3
chore: drop hosted runtime entrypoints ( #448 )
2026-04-26 12:02:13 -04:00
Michał Pierzchała
f926d2c9e1
feat: add cloud remote auth flow ( #443 )
2026-04-25 20:25:55 -04:00
Michał Pierzchała
5cea4dd0b1
feat: pass through GitHub Actions artifact install sources ( #437 )
2026-04-25 19:30:51 -04:00
Michał Pierzchała
4ddd29cb5c
feat: add Metro reload command ( #440 )
2026-04-25 19:30:24 -04:00
Michał Pierzchała
6c7e8323e1
fix: support remote Android React DevTools tunnel ( #438 )
...
* 0.13.0
* fix: support remote android react devtools tunnel
2026-04-25 19:30:12 -04:00
Aziz Becha
18cbc6ced0
fix: use sh fences for .ad scripts in replay-e2e docs ( #436 )
...
Shiki's default bundle has no `ad` grammar, so rspress build failed on
three code fences in replay-e2e.md. Aligns them with the rest of the
file, which already uses ```sh for .ad script content.
2026-04-25 16:37:08 -04:00
Michał Pierzchała
b0813cad84
feat: add react devtools passthrough ( #435 )
...
* feat: add react devtools passthrough
* docs: clarify react devtools passthrough
* fix: preserve react devtools global flags
* docs: add react devtools validation guidance
* docs: simplify react devtools validation notes
2026-04-24 18:54:14 -04:00
Kacper Mikołajczak
2062bffc64
feat: parametrise .ad replay scripts ( #433 )
...
* feat: parametrise .ad replay scripts
Support ${VAR} substitution with env header directives and CLI -e
overrides so flows can be reused across app variants, environments,
and devices without duplicating the script.
Precedence (high->low): CLI -e > AD_* shell env > file-local env >
built-ins (AD_PLATFORM, AD_SESSION, AD_FILENAME, AD_DEVICE,
AD_ARTIFACTS). Supports ${VAR:-default} fallback, \${ escape, and
fails with file:line on unresolved vars.
* refactor: harden .ad replay parametrisation
Tighten the parametrisation surface introduced in the feat commit after
an internal review pass:
- Reserve the AD_* namespace for built-ins. User env (file env, CLI -e,
shell AD_VAR_*) can no longer define AD_* keys, which closes a built-in
shadowing vector (e.g. AD_VAR_AD_SESSION).
- Change the shell-env prefix from AD_* to AD_VAR_* so unrelated CI
secrets that happen to start with AD_ (AD_TOKEN, AD_SECRET_KEY) are
not auto-imported into replay scripts.
- Extend the replay -u guard to also reject scripts with \${VAR}
substitutions in any action, not just those with env directives, so
the writer never silently drops substitutions on heal-rewrite.
- Reword DX-unfriendly regex errors ("must match /^[A-Z_]...$/" ->
"must be uppercase letters, digits, and underscores, e.g. APP_ID").
- Docs rewrite with precedence table, three recipes, fallback/escape
examples, and a Notes block covering replay -u limitation, remote
daemon caveat, no nested fallback, and loud typo behaviour.
- Additional unit tests: namespace reservation on every path, shell
prefix migration, \${VAR} round-trip preservation through
writeReplayScript, green-path integration test with a fake invoke.
* fix: collect .ad replay shell env on the CLI, not the daemon
Review feedback (https://github.com/callstackincubator/agent-device/pull/433#discussion_r3130695225 ):
the daemon was reading AD_VAR_* from its own process.env, which meant
"AD_VAR_K=V agent-device replay" only worked if V was set when the
daemon started, and never worked for remote daemons.
The client now filters process.env for AD_VAR_* at request time and
ships the result as replayShellEnv on the DaemonRequest flags. The
daemon prefers the request value when present and falls back to its
own process.env for direct-daemon callers (internal tests).
Adds two integration tests pinning both paths and updates the docs
Notes block to reflect the new behaviour.
* fix: thread per-attempt artifacts dir into AD_ARTIFACTS under test
Review feedback (https://github.com/callstackincubator/agent-device/pull/433#discussion_r3130695235 ):
AD_ARTIFACTS is documented as available under "agent-device test", but
buildReplayBuiltinVars was only reading the raw flags.artifactsDir.
Under the default artifacts layout the flag is unset and \${AD_ARTIFACTS}
failed; when set with --artifacts-dir it pointed at the suite root, not
the resolved per-attempt directory the test runner actually writes to.
Plumb the attempt-level artifacts dir from session-test.ts through the
runReplay callback (via runReplayTestAttempt) down into the nested
replay request's flags.artifactsDir. The daemon side is unchanged -
buildReplayBuiltinVars just now sees the right value.
Extracts the nested-request flag merge into a testable helper
(buildNestedReplayFlags) to close the coverage gap between the test
harness and the replay runtime.
* refactor: DRY .ad replay parametrisation internals
- Share VAR_KEY_RE between session-replay-vars and session-replay-script
instead of re-declaring the same /^[A-Z_][A-Z0-9_]*$/ in each.
- Fold resolveReplayFlags + resolveReplayRuntime into a single generic
resolveStringProps<T>; the two were near-identical object-walkers.
- Un-export parseReplayEnvLine (was only used inside its own module).
- Table-drive the four "reject AD_* namespace" tests with test.each
instead of four near-duplicate test blocks.
- Extract runReplayFixture helper for runReplayScriptFile integration
tests; each test is now ~10 lines instead of ~30.
No behaviour change. 812 tests still green.
* docs: clarify replay built-in variables
* test: cover replay env serialization
---------
Co-authored-by: Michał Pierzchała <thymikee@gmail.com >
2026-04-24 18:54:03 -04:00