feat: support remote runtime hints and artifact retrieval (#199)

* feat: add remote runtime hints and artifact retrieval

* fix: apply session runtime transport hints on open

* fix: secure and time out artifact downloads

Author: thymikee

README.md

@@ -314,6 +314,8 @@ Navigation helpers:
 - `reinstall <app> <path>` uninstalls and installs the app binary in one command (Android + iOS simulator/device).
 - `install`/`reinstall` accept package/bundle id style app names and support `~` in paths.
 - When `AGENT_DEVICE_DAEMON_BASE_URL` targets a remote daemon, local `.apk`/`.aab`/`.ipa` files and `.app` bundles are uploaded automatically before `install`/`reinstall`.
+- Remote daemon clients can persist session-scoped runtime hints with `runtime set` before `open`; Android launches write React Native dev prefs, and iOS simulator launches write React Native bundle defaults before app start. Example: `agent-device runtime set --session my-session --platform android --metro-host 10.0.0.10 --metro-port 8081 --launch-url "myapp://dev"`.
+- Remote daemon screenshots and recordings are materialized back to the caller path instead of returning host-local daemon paths.
 - To force a daemon-side path instead of uploading a local file, prefix it with `remote:`, for example `remote:/srv/builds/MyApp.app`.
 - Supported binary formats for `install`/`reinstall`: Android `.apk` and `.aab`, iOS `.app` and `.ipa`.
 - `.aab` requires `bundletool` in `PATH`, or `AGENT_DEVICE_BUNDLETOOL_JAR=<path-to-bundletool-all.jar>` (with `java` in `PATH`).

src/cli.ts

@@ -262,6 +262,39 @@ export async function runCli(argv: string[], deps: CliDeps = DEFAULT_CLI_DEPS):
         if (logTailStopper) logTailStopper();
         return;
       }
+      if (command === 'runtime') {
+        const data = response.data as Record<string, unknown> | undefined;
+        const cleared = data?.cleared === true;
+        const configured = data?.configured === true;
+        if (cleared) {
+          process.stdout.write('Runtime hints cleared\n');
+          if (logTailStopper) logTailStopper();
+          return;
+        }
+        if (!configured) {
+          process.stdout.write('No runtime hints configured\n');
+          if (logTailStopper) logTailStopper();
+          return;
+        }
+        process.stdout.write(`${JSON.stringify(data?.runtime ?? {}, null, 2)}\n`);
+        if (logTailStopper) logTailStopper();
+        return;
+      }
+      if (command === 'screenshot') {
+        const pathOut = typeof (response.data as any)?.path === 'string' ? (response.data as any).path : '';
+        if (pathOut) {
+          process.stdout.write(`${pathOut}\n`);
+        }
+        if (logTailStopper) logTailStopper();
+        return;
+      }
+      if (command === 'record') {
+        const data = response.data as Record<string, unknown> | undefined;
+        const outPath = typeof data?.outPath === 'string' ? data.outPath : '';
+        if (outPath) process.stdout.write(`${outPath}\n`);
+        if (logTailStopper) logTailStopper();
+        return;
+      }
       if (command === 'logs') {
         const data = response.data as Record<string, unknown> | undefined;
         const pathOut = typeof data?.path === 'string' ? data.path : '';