[bruno-f-cruz]

Stacked on #292 (uses run_async(executor=...)). Lets an experiment start the Open Ephys GUI, wait until it's ready, drive it, and shut it down, on this machine or on another rig:

ephys = OpenEphysApp(OpenEphysAppSettings(signal_chain=..., headless=True))
await ephys.launch(executor=remote)       # starts the GUI, waits for its HTTP API
try:
    ephys.start()                         # start recording
    await bonsai_app.run_async()
    ephys.stop()
finally:
    await ephys.close()                   # quits the GUI and waits for the process to end

Changes

• launch() / start() / stop() / close() (no context manager):
  • launch(executor=None, timeout=180, ...) runs the GUI in the background, polls /api/status until it responds, and returns the client. If launching fails (the GUI exits first, or timeout passes), it closes the GUI itself before raising CommandError / RuntimeError / TimeoutError.
  • start(record=True) / stop() start and stop recording (or only acquisition).
  • close() quits the GUI, waits for it to exit and returns its result (raising CommandError on a non-zero exit). Calling it when nothing is launched does nothing.
• Remote runs. With an executor that has a host (RemoteRepository) and an address of localhost / 127.0.0.1 / ::1, the client is pointed at the remote host. An explicit address is kept.
• headless setting: adds --headless.
• client.quit() fix. It now uses PUT /api/quit, falling back to the old /api/window command only on a 404. On GUI v1.1.0, /api/window returns 404, so the old quit() didn't work on the version Aind.Physiology.OpenEphys ships. /api/quit also works headless.
• Default executable fix: now ./.open-ephys/open-ephys.exe (hyphens), matching Aind.Physiology.OpenEphys. The old ./.open_ephys/open_ephys.exe never matched.
• Test submodule. tests/assets/Aind.Physiology.OpenEphys, pinned to 09c8579 (GUI v1.1.0).
• Removed an unused test fixture that couldn't construct OpenEphysApp.

Tests

• Fake GUI (fake_open_ephys_gui fixture): a small HTTP script covering readiness, early exit, timeout, caller errors and quit. Also run through a real RemoteRepository.
• Real GUI, headless, locally and through RemoteRepository: launch, status, processors, start/stop acquisition, quit with exit code 0. About 4 s each.
  • Uses the File Reader chain that ships with the GUI. The repo's example.xml contains Neuropix-PXI, which blocks headless startup indefinitely with no hardware attached.
  • Skipped unless the GUI was downloaded (tests/assets/Aind.Physiology.OpenEphys/.open-ephys/setup.ps1 -NoLaunch), so CI (no submodules) skips them.

Review notes

• Startup time. Windowed with example.xml, startup took 40–110 s on a machine without hardware, while hardware plugins searched for devices. Hence the 180 s default timeout.
• Cancelling doesn't stop the GUI process (locally or remotely). If the GUI ignores the quit request, launch logs a warning that it may still be running.
• Network access. For remote use, the GUI's port (37497) must be reachable from the launcher machine.
• Possible follow-up: CI could run the real-GUI tests with submodules: true plus the setup step on a Windows runner.