@vostride/agent-qa-appium-runtime 0.0.0-stage → 0.3.7

package/LICENSE.md

@@ -0,0 +1,105 @@
+# Functional Source License, Version 1.1, ALv2 Future License
+
+## Abbreviation
+
+FSL-1.1-ALv2
+
+## Notice
+
+Copyright 2026 Pranshu Chittora
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the Apache License, Version 2.0 that is effective on the second anniversary of
+the date we make the Software available. On or after that date, you may use the
+Software under the Apache License, Version 2.0, in which case the following
+will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.

package/NOTICE.md

@@ -0,0 +1,11 @@
+# agent-qa Notice
+
+agent-qa is provided by Pranshu Chittora.
+
+Copyright 2026 Pranshu Chittora
+
+agent-qa is licensed under the Functional Source License, Version 1.1, ALv2 Future License (FSL-1.1-ALv2). See `LICENSE.md` for the full license terms.
+
+Under the Grant of Future License in `LICENSE.md`, each version of the Software is also granted under the Apache License, Version 2.0 effective on the second anniversary of the date that version was made available.
+
+Third-party dependencies are distributed under their own license terms. This notice covers agent-qa itself and does not replace or modify notices required by third-party dependency owners.

package/README.md

@@ -1,3 +1,78 @@
-# Temporary Holding Version
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/vostride/agent-qa/main/docs/assets/readme/banner-dark.jpg">
+  <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/vostride/agent-qa/main/docs/assets/readme/banner-light.png">
+  <img src="https://raw.githubusercontent.com/vostride/agent-qa/main/docs/assets/readme/banner-light.png" alt="agent-qa by vostride — a self-improving QA agent for your software factory" width="100%">
+</picture>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<p align="center">
+  <strong>English</strong> · <a href="https://github.com/vostride/agent-qa/blob/main/README.zh-CN.md">中文</a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/agent-qa"><img src="https://img.shields.io/npm/v/agent-qa?color=196872" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/agent-qa"><img src="https://img.shields.io/npm/dm/agent-qa?color=196872" alt="npm downloads per month"></a>
+  <a href="https://github.com/vostride/agent-qa/stargazers"><img src="https://img.shields.io/github/stars/vostride/agent-qa?color=196872" alt="GitHub stars"></a>
+  <a href="https://github.com/vostride/agent-qa/actions/workflows/ci.yml"><img src="https://github.com/vostride/agent-qa/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI"></a>
+  <a href="https://vostride.com/docs/agent-qa"><img src="https://img.shields.io/badge/docs-agent--qa-196872" alt="Documentation"></a>
+  <a href="https://github.com/vostride/agent-qa/blob/main/LICENSE.md"><img src="https://img.shields.io/badge/license-FSL--1.1--ALv2-196872" alt="License: FSL-1.1-ALv2"></a>
+</p>
+
+<p align="center">
+  <a href="https://vostride.com/agent-qa">Website</a> · <a href="https://vostride.com/docs/agent-qa">Docs</a> · <a href="https://vostride.com/demo/agent-qa">Demo</a> · <a href="https://vostride.com/blog">Blog</a> · <a href="https://vostride.com/changelog">Changelog</a>
+</p>
+
+**Your AI QA engineer, with memory.** Describe a user journey in plain language. agent-qa tests it on web, Android or iOS and keeps the evidence. Use the CLI, the dashboard, or your coding agent through MCP and skills.
+
+- **memidex:** remembers facts and working procedures as reviewable files in your repository.
+- **Self-improvement:** validates lessons from runs, retires stale knowledge, and uses your feedback to correct mistakes.
+
+| Benchmark | Rank | Published result |
+| --- | --- | --- |
+| [AndroidWorld](https://vostride.com/benchmark/android-world) | **#1** | **100% pass@1** (116/116 tasks) |
+| [AppControlBench](https://vostride.com/benchmark/app-control-bench) | **#1** | **99.6% completion** (114.5/115 points) |
+
+Read the full benchmark reports, with run evidence and methodology, on [our blog](https://vostride.com/blog). Both used gpt-6-sol with memory and self-improvement off; AppControlBench gives half credit for partial completion.
+
+## See it in action
+
+**Inspect a failure.** The demo catches a cart showing $29 instead of $53, with the failed step and its screenshot side by side.
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/vostride/agent-qa/main/docs/assets/readme/evidence-dark.png">
+  <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/vostride/agent-qa/main/docs/assets/readme/evidence-light.png">
+  <img src="https://raw.githubusercontent.com/vostride/agent-qa/main/docs/assets/readme/evidence-light.png" alt="The dashboard shows the deliberate cart-total bug, its failed assertion, and recorded browser evidence" width="100%">
+</picture>
+
+**See what memory contributed.** Inspect the knowledge supplied to a run and trace it back to the steps that used it.
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/vostride/agent-qa/main/docs/assets/readme/knowledge-dark.png">
+  <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/vostride/agent-qa/main/docs/assets/readme/knowledge-light.png">
+  <img src="https://raw.githubusercontent.com/vostride/agent-qa/main/docs/assets/readme/knowledge-light.png" alt="The Knowledge tab shows stored facts retrieved for the demo run" width="100%">
+</picture>
+
+**Run from your terminal.** Real output from the demo examples: the checkout passes and the test on the deliberate cart-total bug fails.
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/vostride/agent-qa/main/docs/assets/readme/cli-dark.png">
+  <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/vostride/agent-qa/main/docs/assets/readme/cli-light.png">
+  <img src="https://raw.githubusercontent.com/vostride/agent-qa/main/docs/assets/readme/cli-light.png" alt="CLI output excerpt showing one passed test, one failed test, and eight of nine steps passing" width="100%">
+</picture>
+
+## Get started
+
+Requires Node.js 24+.
+
+```sh
+npm install -D agent-qa
+npx agent-qa init
+```
+
+Follow the [quickstart](https://vostride.com/docs/agent-qa/quickstart) to connect a model and run the demo, or [set up with your coding agent](https://vostride.com/docs/agent-qa/agent-quickstart).
+
+> [!NOTE]
+> Early stage. Expect bugs. [Report an issue](https://github.com/vostride/agent-qa/issues) when something breaks.
+
+## License
+
+[Functional Source License (FSL-1.1-ALv2)](https://github.com/vostride/agent-qa/blob/main/LICENSE.md).

package/dist/index.cjs

@@ -0,0 +1,268 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="926327cf-3053-5645-bf57-b1fd4889d76c")}catch(e){}}();
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+// \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+let node_child_process = require("node:child_process");
+let node_fs = require("node:fs");
+let node_http = require("node:http");
+let node_net = require("node:net");
+let node_fs_promises = require("node:fs/promises");
+let node_os = require("node:os");
+let node_path = require("node:path");
+let node_module = require("node:module");
+let tree_kill = require("tree-kill");
+tree_kill = __toESM(tree_kill, 1);
+// src/appium-home.ts
+async function prepareAppiumHome(driverFolders) {
+	const home = await (0, node_fs_promises.realpath)(await (0, node_fs_promises.mkdtemp)((0, node_path.join)((0, node_os.tmpdir)(), "agent-qa-appium-")));
+	try {
+		await (0, node_fs_promises.mkdir)((0, node_path.join)(home, "node_modules"));
+		for (const folder of driverFolders) await (0, node_fs_promises.symlink)(folder, (0, node_path.join)(home, "node_modules", (0, node_path.basename)(folder)), "junction");
+	} catch (error) {
+		await removeAppiumHome(home).catch(() => {});
+		throw error;
+	}
+	return home;
+}
+async function removeAppiumHome(home) {
+	await (0, node_fs_promises.rm)(home, {
+		recursive: true,
+		force: true,
+		maxRetries: 3,
+		retryDelay: 100
+	});
+}
+// src/bundled-appium.ts
+const require$1 = (0, node_module.createRequire)(typeof __filename === "string" ? __filename : require("url").pathToFileURL(__filename).href);
+function resolveBundledAppium() {
+	return {
+		serverEntry: require$1.resolve("appium/build/lib/main.js"),
+		driverFolders: [(0, node_path.dirname)(require$1.resolve("appium-uiautomator2-driver/package.json")), (0, node_path.dirname)(require$1.resolve("appium-xcuitest-driver/package.json"))]
+	};
+}
+// src/kill-tree.ts
+function killTree(pid, options = {}) {
+	if ((options.platform ?? process.platform) === "linux") {
+		let members = [pid];
+		try {
+			members = linuxTree(pid, options.proc ?? "/proc");
+		} catch {}
+		for (const member of members) try {
+			process.kill(member, "SIGKILL");
+		} catch {}
+		return Promise.resolve();
+	}
+	return new Promise((settle) => {
+		(0, tree_kill.default)(pid, "SIGKILL", () => settle());
+	});
+}
+function linuxTree(root, proc) {
+	const children = /* @__PURE__ */ new Map();
+	for (const entry of (0, node_fs.readdirSync)(proc)) {
+		if (!/^\d+$/u.test(entry)) continue;
+		let stat;
+		try {
+			stat = (0, node_fs.readFileSync)((0, node_path.join)(proc, entry, "stat"), "utf8");
+		} catch {
+			continue;
+		}
+		const parent = Number(stat.slice(stat.lastIndexOf(")") + 2).split(" ")[1]);
+		children.set(parent, [...children.get(parent) ?? [], Number(entry)]);
+	}
+	const tree = [root];
+	for (const member of tree) tree.push(...children.get(member) ?? []);
+	return tree;
+}
+// src/start-appium-server.ts
+const LOOPBACK = "127.0.0.1";
+const STARTUP_TIMEOUT_MS = 3e4;
+const POLL_INTERVAL_MS = 500;
+const KEPT_LINES = 10;
+const spawnNode = (command, args, options) => (0, node_child_process.spawn)(command, [...args], options);
+function isAppiumReady(url) {
+	return new Promise((settle) => {
+		const req = (0, node_http.request)(`${url}/status`, {
+			method: "GET",
+			timeout: 3e3
+		}, (res) => {
+			let data = "";
+			res.on("data", (chunk) => {
+				data += chunk.toString();
+			});
+			res.on("end", () => {
+				try {
+					settle(JSON.parse(data)?.value?.ready === true);
+				} catch {
+					settle(false);
+				}
+			});
+		});
+		req.on("error", () => settle(false));
+		req.on("timeout", () => {
+			req.destroy();
+			settle(false);
+		});
+		req.end();
+	});
+}
+function findFreePort() {
+	return new Promise((settle, fail) => {
+		const server = (0, node_net.createServer)();
+		server.unref();
+		server.once("error", fail);
+		server.listen({
+			port: 0,
+			host: LOOPBACK
+		}, () => {
+			const address = server.address();
+			const port = typeof address === "object" && address !== null ? address.port : 0;
+			server.close(() => settle(port));
+		});
+	});
+}
+async function startAppiumServer(options = {}) {
+	const spawn = options.spawn ?? spawnNode;
+	const probe = options.probe ?? isAppiumReady;
+	const { serverEntry, driverFolders } = resolveBundledAppium();
+	const port = await findFreePort();
+	const home = await prepareAppiumHome(driverFolders);
+	let child;
+	try {
+		child = spawn(process.execPath, [
+			serverEntry,
+			"--address",
+			LOOPBACK,
+			"--port",
+			String(port),
+			"--relaxed-security",
+			"--deny-insecure",
+			"*:cors",
+			"--log-no-colors"
+		], {
+			env: {
+				...process.env,
+				APPIUM_HOME: home
+			},
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			]
+		});
+	} catch (error) {
+		await removeAppiumHome(home).catch(() => {});
+		throw error;
+	}
+	const killOnExit = () => {
+		try {
+			child.kill("SIGKILL");
+		} catch {}
+		try {
+			(0, node_fs.rmSync)(home, {
+				recursive: true,
+				force: true
+			});
+		} catch {}
+	};
+	process.once("exit", killOnExit);
+	child.unref();
+	child.stdout?.unref();
+	child.stderr?.unref();
+	const lastLines = [];
+	const forward = (stream) => (chunk) => {
+		const text = chunk.toString("utf8");
+		options.onOutput?.(text, stream);
+		for (const line of text.split(/\r?\n/u)) {
+			if (line.trim() === "") continue;
+			lastLines.push(line);
+			if (lastLines.length > KEPT_LINES) lastLines.shift();
+		}
+	};
+	child.stdout?.on("data", forward("stdout"));
+	child.stderr?.on("data", forward("stderr"));
+	const withLastLines = (message) => [message, ...lastLines].join("\n");
+	let cleaned;
+	const cleanUp = () => cleaned ??= removeAppiumHome(home).catch(() => {}).then(() => {
+		process.off("exit", killOnExit);
+	});
+	let wake = () => {};
+	let spawnError;
+	child.once("error", (error) => {
+		spawnError = error;
+		wake();
+	});
+	let closedBy;
+	const exited = new Promise((settle) => {
+		child.once("close", (code, signal) => {
+			closedBy = signal === null ? `exit code ${code}` : `signal ${signal}`;
+			wake();
+			settle();
+		});
+	}).then(cleanUp);
+	const ended = () => spawnError !== void 0 || closedBy !== void 0;
+	const pause = () => new Promise((settle) => {
+		if (ended()) return settle();
+		const timer = setTimeout(settle, POLL_INTERVAL_MS);
+		wake = () => {
+			clearTimeout(timer);
+			settle();
+		};
+	});
+	let stopping;
+	const stop = () => {
+		stopping ??= (async () => {
+			if (closedBy === void 0) {
+				child.ref();
+				child.stdout?.ref();
+				child.stderr?.ref();
+				if (child.pid !== void 0) await killTree(child.pid);
+			}
+			await exited;
+		})();
+		return stopping;
+	};
+	const url = `http://${LOOPBACK}:${port}`;
+	const deadline = Date.now() + STARTUP_TIMEOUT_MS;
+	while (!ended() && Date.now() < deadline) {
+		if (await probe(url) && !ended()) return {
+			url,
+			exited,
+			stop
+		};
+		await pause();
+	}
+	if (spawnError !== void 0) {
+		await cleanUp();
+		throw spawnError;
+	}
+	if (closedBy !== void 0) {
+		await exited;
+		throw new Error(withLastLines(`Appium exited before it was ready (${closedBy})`));
+	}
+	await stop();
+	throw new Error(withLastLines(`Appium server did not become ready within ${STARTUP_TIMEOUT_MS}ms`));
+}
+exports.startAppiumServer = startAppiumServer;
+
+//# sourceMappingURL=index.cjs.map
+//# debugId=926327cf-3053-5645-bf57-b1fd4889d76c

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/appium-home.ts","../src/bundled-appium.ts","../src/kill-tree.ts","../src/start-appium-server.ts"],"sourcesContent":["import { mkdir, mkdtemp, realpath, rm, symlink } from 'node:fs/promises'\nimport { tmpdir } from 'node:os'\nimport { basename, join } from 'node:path'\n\n// A fresh folder has no extension manifest yet, so Appium scans its node_modules and finds the\n// linked drivers at every start. A junction needs no administrator rights on Windows; elsewhere\n// it is an ordinary symlink.\nexport async function prepareAppiumHome(driverFolders: readonly string[]): Promise<string> {\n  const home = await realpath(await mkdtemp(join(tmpdir(), 'agent-qa-appium-')))\n  try {\n    await mkdir(join(home, 'node_modules'))\n    for (const folder of driverFolders) {\n      await symlink(folder, join(home, 'node_modules', basename(folder)), 'junction')\n    }\n  } catch (error) {\n    await removeAppiumHome(home).catch(() => {})\n    throw error\n  }\n  return home\n}\n\n// Removing a link never descends into the folder it points at. The retries cover a file that is\n// still held open for a moment.\nexport async function removeAppiumHome(home: string): Promise<void> {\n  await rm(home, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 })\n}\n","import { createRequire } from 'node:module'\nimport { dirname } from 'node:path'\n\nexport interface BundledAppium {\n  readonly serverEntry: string\n  readonly driverFolders: readonly string[]\n}\n\nconst require = createRequire(typeof __filename === 'string' ? __filename : import.meta.url)\n\n// Resolved from this package's own file: under pnpm only the package that declares a dependency\n// can resolve it, and a project's or the machine's own Appium is never reached.\nexport function resolveBundledAppium(): BundledAppium {\n  return {\n    serverEntry: require.resolve('appium/build/lib/main.js'),\n    driverFolders: [\n      dirname(require.resolve('appium-uiautomator2-driver/package.json')),\n      dirname(require.resolve('appium-xcuitest-driver/package.json')),\n    ],\n  }\n}\n","import { readdirSync, readFileSync } from 'node:fs'\nimport { join } from 'node:path'\n\nimport treeKill from 'tree-kill'\n\n// tree-kill finds a Linux process's children by running ps, which slim Linux images do not have,\n// and a missing ps throws in the host process. Linux keeps each process's parent in /proc.\nexport function killTree(\n  pid: number,\n  options: { readonly platform?: NodeJS.Platform; readonly proc?: string } = {},\n): Promise<void> {\n  if ((options.platform ?? process.platform) === 'linux') {\n    // When /proc cannot be listed, the process itself is still signalled.\n    let members = [pid]\n    try {\n      members = linuxTree(pid, options.proc ?? '/proc')\n    } catch {}\n    for (const member of members) {\n      try {\n        process.kill(member, 'SIGKILL')\n      } catch {}\n    }\n    return Promise.resolve()\n  }\n  // tree-kill lists the tree before it signals any of it, so the tree is killed only once its\n  // callback runs. What the callback reports is not passed on.\n  return new Promise((settle) => {\n    treeKill(pid, 'SIGKILL', () => settle())\n  })\n}\n\nfunction linuxTree(root: number, proc: string): number[] {\n  const children = new Map<number, number[]>()\n  for (const entry of readdirSync(proc)) {\n    if (!/^\\d+$/u.test(entry)) continue\n    let stat: string\n    try {\n      stat = readFileSync(join(proc, entry, 'stat'), 'utf8')\n    } catch {\n      continue\n    }\n    // The command name sits in parentheses and may hold spaces and parentheses itself; the\n    // parent's id is the second field after the last one.\n    const parent = Number(stat.slice(stat.lastIndexOf(')') + 2).split(' ')[1])\n    children.set(parent, [...(children.get(parent) ?? []), Number(entry)])\n  }\n  const tree = [root]\n  for (const member of tree) tree.push(...(children.get(member) ?? []))\n  return tree\n}\n","import { spawn as nodeSpawn, type ChildProcessByStdio, type SpawnOptions } from 'node:child_process'\nimport { rmSync } from 'node:fs'\nimport { request } from 'node:http'\nimport { createServer, type Socket } from 'node:net'\n\nimport { prepareAppiumHome, removeAppiumHome } from './appium-home'\nimport { resolveBundledAppium } from './bundled-appium'\nimport { killTree } from './kill-tree'\n\nconst LOOPBACK = '127.0.0.1'\nconst STARTUP_TIMEOUT_MS = 30_000\nconst POLL_INTERVAL_MS = 500\nconst KEPT_LINES = 10\n\nexport interface AppiumServer {\n  // http://127.0.0.1 and the port the server listens on\n  readonly url: string\n  // Settles once the server process has ended, by stop() or on its own, and the prepared home\n  // is removed. Never rejects.\n  readonly exited: Promise<void>\n  // Settles once the process tree is killed, the child has closed and the prepared home is\n  // removed. Never rejects. Safe to call twice.\n  stop(): Promise<void>\n}\n\ninterface ChildOutput {\n  on(event: 'data', listener: (chunk: Buffer) => void): unknown\n  ref(): unknown\n  unref(): unknown\n}\n\ninterface AppiumChild {\n  readonly pid?: number | undefined\n  readonly stdout: ChildOutput | null\n  readonly stderr: ChildOutput | null\n  once(event: 'error', listener: (error: Error) => void): unknown\n  once(\n    event: 'close',\n    listener: (code: number | null, signal: NodeJS.Signals | null) => void,\n  ): unknown\n  kill(signal: NodeJS.Signals): unknown\n  ref(): unknown\n  unref(): unknown\n}\n\nexport type AppiumSpawn = (\n  command: string,\n  args: readonly string[],\n  options: SpawnOptions,\n) => AppiumChild\n\nexport interface StartAppiumServerOptions {\n  // Every chunk the server prints, for its whole life.\n  readonly onOutput?: (text: string, stream: 'stdout' | 'stderr') => void\n  // The two seams a test passes fakes through; the defaults are the real spawn and the real probe.\n  readonly spawn?: AppiumSpawn\n  readonly probe?: (url: string) => Promise<boolean>\n}\n\n// A child's piped output streams are sockets, which Node types only as Readable.\nconst spawnNode: AppiumSpawn = (command, args, options) =>\n  nodeSpawn(command, [...args], options) as ChildProcessByStdio<null, Socket, Socket>\n\nfunction isAppiumReady(url: string): Promise<boolean> {\n  return new Promise<boolean>((settle) => {\n    const req = request(`${url}/status`, { method: 'GET', timeout: 3000 }, (res) => {\n      let data = ''\n      res.on('data', (chunk: Buffer) => {\n        data += chunk.toString()\n      })\n      res.on('end', () => {\n        try {\n          const parsed = JSON.parse(data)\n          settle(parsed?.value?.ready === true)\n        } catch {\n          settle(false)\n        }\n      })\n    })\n    req.on('error', () => settle(false))\n    req.on('timeout', () => {\n      req.destroy()\n      settle(false)\n    })\n    req.end()\n  })\n}\n\n// The port the system hands out on loopback, released at once.\nfunction findFreePort(): Promise<number> {\n  return new Promise((settle, fail) => {\n    const server = createServer()\n    server.unref()\n    server.once('error', fail)\n    server.listen({ port: 0, host: LOOPBACK }, () => {\n      const address = server.address()\n      const port = typeof address === 'object' && address !== null ? address.port : 0\n      server.close(() => settle(port))\n    })\n  })\n}\n\nexport async function startAppiumServer(\n  options: StartAppiumServerOptions = {},\n): Promise<AppiumServer> {\n  const spawn = options.spawn ?? spawnNode\n  const probe = options.probe ?? isAppiumReady\n  const { serverEntry, driverFolders } = resolveBundledAppium()\n  const port = await findFreePort()\n  const home = await prepareAppiumHome(driverFolders)\n  let child: AppiumChild\n  try {\n    child = spawn(\n      process.execPath,\n      [\n        serverEntry,\n        '--address',\n        LOOPBACK,\n        '--port',\n        String(port),\n        '--relaxed-security',\n        '--deny-insecure',\n        '*:cors',\n        '--log-no-colors',\n      ],\n      { env: { ...process.env, APPIUM_HOME: home }, stdio: ['ignore', 'pipe', 'pipe'] },\n    )\n  } catch (error) {\n    // No child exists yet, so nothing else would remove the home.\n    await removeAppiumHome(home).catch(() => {})\n    throw error\n  }\n\n  // An exiting process cannot wait for tree-kill to list the tree, so only the server itself is\n  // signalled here.\n  const killOnExit = (): void => {\n    try {\n      child.kill('SIGKILL')\n    } catch {}\n    try {\n      rmSync(home, { recursive: true, force: true })\n    } catch {}\n  }\n  process.once('exit', killOnExit)\n  // A command that succeeded ends only once nothing holds the event loop, and a child with piped\n  // output would hold it for ever, so the exit listener would never run.\n  child.unref()\n  child.stdout?.unref()\n  child.stderr?.unref()\n\n  const lastLines: string[] = []\n  const forward = (stream: 'stdout' | 'stderr') => (chunk: Buffer) => {\n    const text = chunk.toString('utf8')\n    options.onOutput?.(text, stream)\n    for (const line of text.split(/\\r?\\n/u)) {\n      if (line.trim() === '') continue\n      lastLines.push(line)\n      if (lastLines.length > KEPT_LINES) lastLines.shift()\n    }\n  }\n  child.stdout?.on('data', forward('stdout'))\n  child.stderr?.on('data', forward('stderr'))\n  const withLastLines = (message: string): string => [message, ...lastLines].join('\\n')\n\n  let cleaned: Promise<void> | undefined\n  const cleanUp = (): Promise<void> =>\n    (cleaned ??= removeAppiumHome(home)\n      .catch(() => {})\n      .then(() => {\n        process.off('exit', killOnExit)\n      }))\n\n  let wake = (): void => {}\n  let spawnError: Error | undefined\n  child.once('error', (error) => {\n    spawnError = error\n    wake()\n  })\n  let closedBy: string | undefined\n  const exited = new Promise<void>((settle) => {\n    child.once('close', (code, signal) => {\n      closedBy = signal === null ? `exit code ${code}` : `signal ${signal}`\n      wake()\n      settle()\n    })\n  }).then(cleanUp)\n  const ended = (): boolean => spawnError !== undefined || closedBy !== undefined\n  const pause = (): Promise<void> =>\n    new Promise((settle) => {\n      if (ended()) return settle()\n      const timer = setTimeout(settle, POLL_INTERVAL_MS)\n      wake = () => {\n        clearTimeout(timer)\n        settle()\n      }\n    })\n\n  let stopping: Promise<void> | undefined\n  const stop = (): Promise<void> => {\n    stopping ??= (async () => {\n      if (closedBy === undefined) {\n        // A process that is only waiting for this stop stays alive until the child has closed.\n        child.ref()\n        child.stdout?.ref()\n        child.stderr?.ref()\n        if (child.pid !== undefined) await killTree(child.pid)\n      }\n      await exited\n    })()\n    return stopping\n  }\n\n  const url = `http://${LOOPBACK}:${port}`\n  const deadline = Date.now() + STARTUP_TIMEOUT_MS\n  while (!ended() && Date.now() < deadline) {\n    // Once the child has ended, whatever answers on its port is another process.\n    if ((await probe(url)) && !ended()) return { url, exited, stop }\n    await pause()\n  }\n\n  if (spawnError !== undefined) {\n    await cleanUp()\n    throw spawnError\n  }\n  if (closedBy !== undefined) {\n    await exited\n    throw new Error(withLastLines(`Appium exited before it was ready (${closedBy})`))\n  }\n  await stop()\n  throw new Error(\n    withLastLines(`Appium server did not become ready within ${STARTUP_TIMEOUT_MS}ms`),\n  )\n}\n"],"names":["realpath","mkdtemp","join","tmpdir","mkdir","symlink","basename","rm","require","createRequire","dirname","readdirSync","readFileSync","join","nodeSpawn","request","createServer"],"mappings":"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","debugId":"926327cf-3053-5645-bf57-b1fd4889d76c"}

package/dist/index.d.cts

@@ -0,0 +1,29 @@
+import { SpawnOptions } from "node:child_process";
+interface AppiumServer {
+  readonly url: string;
+  readonly exited: Promise<void>;
+  stop(): Promise<void>;
+}
+interface ChildOutput {
+  on(event: 'data', listener: (chunk: Buffer) => void): unknown;
+  ref(): unknown;
+  unref(): unknown;
+}
+interface AppiumChild {
+  readonly pid?: number | undefined;
+  readonly stdout: ChildOutput | null;
+  readonly stderr: ChildOutput | null;
+  once(event: 'error', listener: (error: Error) => void): unknown;
+  once(event: 'close', listener: (code: number | null, signal: NodeJS.Signals | null) => void): unknown;
+  kill(signal: NodeJS.Signals): unknown;
+  ref(): unknown;
+  unref(): unknown;
+}
+type AppiumSpawn = (command: string, args: readonly string[], options: SpawnOptions) => AppiumChild;
+interface StartAppiumServerOptions {
+  readonly onOutput?: (text: string, stream: 'stdout' | 'stderr') => void;
+  readonly spawn?: AppiumSpawn;
+  readonly probe?: (url: string) => Promise<boolean>;
+}
+export declare function startAppiumServer(options?: StartAppiumServerOptions): Promise<AppiumServer>;
+export type { AppiumServer, StartAppiumServerOptions };

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+import { SpawnOptions } from "node:child_process";
+interface AppiumServer {
+  readonly url: string;
+  readonly exited: Promise<void>;
+  stop(): Promise<void>;
+}
+interface ChildOutput {
+  on(event: 'data', listener: (chunk: Buffer) => void): unknown;
+  ref(): unknown;
+  unref(): unknown;
+}
+interface AppiumChild {
+  readonly pid?: number | undefined;
+  readonly stdout: ChildOutput | null;
+  readonly stderr: ChildOutput | null;
+  once(event: 'error', listener: (error: Error) => void): unknown;
+  once(event: 'close', listener: (code: number | null, signal: NodeJS.Signals | null) => void): unknown;
+  kill(signal: NodeJS.Signals): unknown;
+  ref(): unknown;
+  unref(): unknown;
+}
+type AppiumSpawn = (command: string, args: readonly string[], options: SpawnOptions) => AppiumChild;
+interface StartAppiumServerOptions {
+  readonly onOutput?: (text: string, stream: 'stdout' | 'stderr') => void;
+  readonly spawn?: AppiumSpawn;
+  readonly probe?: (url: string) => Promise<boolean>;
+}
+export declare function startAppiumServer(options?: StartAppiumServerOptions): Promise<AppiumServer>;
+export type { AppiumServer, StartAppiumServerOptions };

package/dist/index.js

@@ -0,0 +1,245 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="c772727d-14c3-532a-a31d-8c4b1188089b")}catch(e){}}();
+import { createRequire } from "node:module";
+import { spawn } from "node:child_process";
+import { readFileSync, readdirSync, rmSync } from "node:fs";
+import { request } from "node:http";
+import { createServer } from "node:net";
+import { mkdir, mkdtemp, realpath, rm, symlink } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { basename, dirname, join } from "node:path";
+import treeKill from "tree-kill";
+// src/appium-home.ts
+async function prepareAppiumHome(driverFolders) {
+	const home = await realpath(await mkdtemp(join(tmpdir(), "agent-qa-appium-")));
+	try {
+		await mkdir(join(home, "node_modules"));
+		for (const folder of driverFolders) await symlink(folder, join(home, "node_modules", basename(folder)), "junction");
+	} catch (error) {
+		await removeAppiumHome(home).catch(() => {});
+		throw error;
+	}
+	return home;
+}
+async function removeAppiumHome(home) {
+	await rm(home, {
+		recursive: true,
+		force: true,
+		maxRetries: 3,
+		retryDelay: 100
+	});
+}
+// src/bundled-appium.ts
+const require = createRequire(typeof __filename === "string" ? __filename : import.meta.url);
+function resolveBundledAppium() {
+	return {
+		serverEntry: require.resolve("appium/build/lib/main.js"),
+		driverFolders: [dirname(require.resolve("appium-uiautomator2-driver/package.json")), dirname(require.resolve("appium-xcuitest-driver/package.json"))]
+	};
+}
+// src/kill-tree.ts
+function killTree(pid, options = {}) {
+	if ((options.platform ?? process.platform) === "linux") {
+		let members = [pid];
+		try {
+			members = linuxTree(pid, options.proc ?? "/proc");
+		} catch {}
+		for (const member of members) try {
+			process.kill(member, "SIGKILL");
+		} catch {}
+		return Promise.resolve();
+	}
+	return new Promise((settle) => {
+		treeKill(pid, "SIGKILL", () => settle());
+	});
+}
+function linuxTree(root, proc) {
+	const children = /* @__PURE__ */ new Map();
+	for (const entry of readdirSync(proc)) {
+		if (!/^\d+$/u.test(entry)) continue;
+		let stat;
+		try {
+			stat = readFileSync(join(proc, entry, "stat"), "utf8");
+		} catch {
+			continue;
+		}
+		const parent = Number(stat.slice(stat.lastIndexOf(")") + 2).split(" ")[1]);
+		children.set(parent, [...children.get(parent) ?? [], Number(entry)]);
+	}
+	const tree = [root];
+	for (const member of tree) tree.push(...children.get(member) ?? []);
+	return tree;
+}
+// src/start-appium-server.ts
+const LOOPBACK = "127.0.0.1";
+const STARTUP_TIMEOUT_MS = 3e4;
+const POLL_INTERVAL_MS = 500;
+const KEPT_LINES = 10;
+const spawnNode = (command, args, options) => spawn(command, [...args], options);
+function isAppiumReady(url) {
+	return new Promise((settle) => {
+		const req = request(`${url}/status`, {
+			method: "GET",
+			timeout: 3e3
+		}, (res) => {
+			let data = "";
+			res.on("data", (chunk) => {
+				data += chunk.toString();
+			});
+			res.on("end", () => {
+				try {
+					settle(JSON.parse(data)?.value?.ready === true);
+				} catch {
+					settle(false);
+				}
+			});
+		});
+		req.on("error", () => settle(false));
+		req.on("timeout", () => {
+			req.destroy();
+			settle(false);
+		});
+		req.end();
+	});
+}
+function findFreePort() {
+	return new Promise((settle, fail) => {
+		const server = createServer();
+		server.unref();
+		server.once("error", fail);
+		server.listen({
+			port: 0,
+			host: LOOPBACK
+		}, () => {
+			const address = server.address();
+			const port = typeof address === "object" && address !== null ? address.port : 0;
+			server.close(() => settle(port));
+		});
+	});
+}
+async function startAppiumServer(options = {}) {
+	const spawn = options.spawn ?? spawnNode;
+	const probe = options.probe ?? isAppiumReady;
+	const { serverEntry, driverFolders } = resolveBundledAppium();
+	const port = await findFreePort();
+	const home = await prepareAppiumHome(driverFolders);
+	let child;
+	try {
+		child = spawn(process.execPath, [
+			serverEntry,
+			"--address",
+			LOOPBACK,
+			"--port",
+			String(port),
+			"--relaxed-security",
+			"--deny-insecure",
+			"*:cors",
+			"--log-no-colors"
+		], {
+			env: {
+				...process.env,
+				APPIUM_HOME: home
+			},
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			]
+		});
+	} catch (error) {
+		await removeAppiumHome(home).catch(() => {});
+		throw error;
+	}
+	const killOnExit = () => {
+		try {
+			child.kill("SIGKILL");
+		} catch {}
+		try {
+			rmSync(home, {
+				recursive: true,
+				force: true
+			});
+		} catch {}
+	};
+	process.once("exit", killOnExit);
+	child.unref();
+	child.stdout?.unref();
+	child.stderr?.unref();
+	const lastLines = [];
+	const forward = (stream) => (chunk) => {
+		const text = chunk.toString("utf8");
+		options.onOutput?.(text, stream);
+		for (const line of text.split(/\r?\n/u)) {
+			if (line.trim() === "") continue;
+			lastLines.push(line);
+			if (lastLines.length > KEPT_LINES) lastLines.shift();
+		}
+	};
+	child.stdout?.on("data", forward("stdout"));
+	child.stderr?.on("data", forward("stderr"));
+	const withLastLines = (message) => [message, ...lastLines].join("\n");
+	let cleaned;
+	const cleanUp = () => cleaned ??= removeAppiumHome(home).catch(() => {}).then(() => {
+		process.off("exit", killOnExit);
+	});
+	let wake = () => {};
+	let spawnError;
+	child.once("error", (error) => {
+		spawnError = error;
+		wake();
+	});
+	let closedBy;
+	const exited = new Promise((settle) => {
+		child.once("close", (code, signal) => {
+			closedBy = signal === null ? `exit code ${code}` : `signal ${signal}`;
+			wake();
+			settle();
+		});
+	}).then(cleanUp);
+	const ended = () => spawnError !== void 0 || closedBy !== void 0;
+	const pause = () => new Promise((settle) => {
+		if (ended()) return settle();
+		const timer = setTimeout(settle, POLL_INTERVAL_MS);
+		wake = () => {
+			clearTimeout(timer);
+			settle();
+		};
+	});
+	let stopping;
+	const stop = () => {
+		stopping ??= (async () => {
+			if (closedBy === void 0) {
+				child.ref();
+				child.stdout?.ref();
+				child.stderr?.ref();
+				if (child.pid !== void 0) await killTree(child.pid);
+			}
+			await exited;
+		})();
+		return stopping;
+	};
+	const url = `http://${LOOPBACK}:${port}`;
+	const deadline = Date.now() + STARTUP_TIMEOUT_MS;
+	while (!ended() && Date.now() < deadline) {
+		if (await probe(url) && !ended()) return {
+			url,
+			exited,
+			stop
+		};
+		await pause();
+	}
+	if (spawnError !== void 0) {
+		await cleanUp();
+		throw spawnError;
+	}
+	if (closedBy !== void 0) {
+		await exited;
+		throw new Error(withLastLines(`Appium exited before it was ready (${closedBy})`));
+	}
+	await stop();
+	throw new Error(withLastLines(`Appium server did not become ready within ${STARTUP_TIMEOUT_MS}ms`));
+}
+export { startAppiumServer };
+
+//# sourceMappingURL=index.js.map
+//# debugId=c772727d-14c3-532a-a31d-8c4b1188089b

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/appium-home.ts","../src/bundled-appium.ts","../src/kill-tree.ts","../src/start-appium-server.ts"],"sourcesContent":["import { mkdir, mkdtemp, realpath, rm, symlink } from 'node:fs/promises'\nimport { tmpdir } from 'node:os'\nimport { basename, join } from 'node:path'\n\n// A fresh folder has no extension manifest yet, so Appium scans its node_modules and finds the\n// linked drivers at every start. A junction needs no administrator rights on Windows; elsewhere\n// it is an ordinary symlink.\nexport async function prepareAppiumHome(driverFolders: readonly string[]): Promise<string> {\n  const home = await realpath(await mkdtemp(join(tmpdir(), 'agent-qa-appium-')))\n  try {\n    await mkdir(join(home, 'node_modules'))\n    for (const folder of driverFolders) {\n      await symlink(folder, join(home, 'node_modules', basename(folder)), 'junction')\n    }\n  } catch (error) {\n    await removeAppiumHome(home).catch(() => {})\n    throw error\n  }\n  return home\n}\n\n// Removing a link never descends into the folder it points at. The retries cover a file that is\n// still held open for a moment.\nexport async function removeAppiumHome(home: string): Promise<void> {\n  await rm(home, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 })\n}\n","import { createRequire } from 'node:module'\nimport { dirname } from 'node:path'\n\nexport interface BundledAppium {\n  readonly serverEntry: string\n  readonly driverFolders: readonly string[]\n}\n\nconst require = createRequire(typeof __filename === 'string' ? __filename : import.meta.url)\n\n// Resolved from this package's own file: under pnpm only the package that declares a dependency\n// can resolve it, and a project's or the machine's own Appium is never reached.\nexport function resolveBundledAppium(): BundledAppium {\n  return {\n    serverEntry: require.resolve('appium/build/lib/main.js'),\n    driverFolders: [\n      dirname(require.resolve('appium-uiautomator2-driver/package.json')),\n      dirname(require.resolve('appium-xcuitest-driver/package.json')),\n    ],\n  }\n}\n","import { readdirSync, readFileSync } from 'node:fs'\nimport { join } from 'node:path'\n\nimport treeKill from 'tree-kill'\n\n// tree-kill finds a Linux process's children by running ps, which slim Linux images do not have,\n// and a missing ps throws in the host process. Linux keeps each process's parent in /proc.\nexport function killTree(\n  pid: number,\n  options: { readonly platform?: NodeJS.Platform; readonly proc?: string } = {},\n): Promise<void> {\n  if ((options.platform ?? process.platform) === 'linux') {\n    // When /proc cannot be listed, the process itself is still signalled.\n    let members = [pid]\n    try {\n      members = linuxTree(pid, options.proc ?? '/proc')\n    } catch {}\n    for (const member of members) {\n      try {\n        process.kill(member, 'SIGKILL')\n      } catch {}\n    }\n    return Promise.resolve()\n  }\n  // tree-kill lists the tree before it signals any of it, so the tree is killed only once its\n  // callback runs. What the callback reports is not passed on.\n  return new Promise((settle) => {\n    treeKill(pid, 'SIGKILL', () => settle())\n  })\n}\n\nfunction linuxTree(root: number, proc: string): number[] {\n  const children = new Map<number, number[]>()\n  for (const entry of readdirSync(proc)) {\n    if (!/^\\d+$/u.test(entry)) continue\n    let stat: string\n    try {\n      stat = readFileSync(join(proc, entry, 'stat'), 'utf8')\n    } catch {\n      continue\n    }\n    // The command name sits in parentheses and may hold spaces and parentheses itself; the\n    // parent's id is the second field after the last one.\n    const parent = Number(stat.slice(stat.lastIndexOf(')') + 2).split(' ')[1])\n    children.set(parent, [...(children.get(parent) ?? []), Number(entry)])\n  }\n  const tree = [root]\n  for (const member of tree) tree.push(...(children.get(member) ?? []))\n  return tree\n}\n","import { spawn as nodeSpawn, type ChildProcessByStdio, type SpawnOptions } from 'node:child_process'\nimport { rmSync } from 'node:fs'\nimport { request } from 'node:http'\nimport { createServer, type Socket } from 'node:net'\n\nimport { prepareAppiumHome, removeAppiumHome } from './appium-home'\nimport { resolveBundledAppium } from './bundled-appium'\nimport { killTree } from './kill-tree'\n\nconst LOOPBACK = '127.0.0.1'\nconst STARTUP_TIMEOUT_MS = 30_000\nconst POLL_INTERVAL_MS = 500\nconst KEPT_LINES = 10\n\nexport interface AppiumServer {\n  // http://127.0.0.1 and the port the server listens on\n  readonly url: string\n  // Settles once the server process has ended, by stop() or on its own, and the prepared home\n  // is removed. Never rejects.\n  readonly exited: Promise<void>\n  // Settles once the process tree is killed, the child has closed and the prepared home is\n  // removed. Never rejects. Safe to call twice.\n  stop(): Promise<void>\n}\n\ninterface ChildOutput {\n  on(event: 'data', listener: (chunk: Buffer) => void): unknown\n  ref(): unknown\n  unref(): unknown\n}\n\ninterface AppiumChild {\n  readonly pid?: number | undefined\n  readonly stdout: ChildOutput | null\n  readonly stderr: ChildOutput | null\n  once(event: 'error', listener: (error: Error) => void): unknown\n  once(\n    event: 'close',\n    listener: (code: number | null, signal: NodeJS.Signals | null) => void,\n  ): unknown\n  kill(signal: NodeJS.Signals): unknown\n  ref(): unknown\n  unref(): unknown\n}\n\nexport type AppiumSpawn = (\n  command: string,\n  args: readonly string[],\n  options: SpawnOptions,\n) => AppiumChild\n\nexport interface StartAppiumServerOptions {\n  // Every chunk the server prints, for its whole life.\n  readonly onOutput?: (text: string, stream: 'stdout' | 'stderr') => void\n  // The two seams a test passes fakes through; the defaults are the real spawn and the real probe.\n  readonly spawn?: AppiumSpawn\n  readonly probe?: (url: string) => Promise<boolean>\n}\n\n// A child's piped output streams are sockets, which Node types only as Readable.\nconst spawnNode: AppiumSpawn = (command, args, options) =>\n  nodeSpawn(command, [...args], options) as ChildProcessByStdio<null, Socket, Socket>\n\nfunction isAppiumReady(url: string): Promise<boolean> {\n  return new Promise<boolean>((settle) => {\n    const req = request(`${url}/status`, { method: 'GET', timeout: 3000 }, (res) => {\n      let data = ''\n      res.on('data', (chunk: Buffer) => {\n        data += chunk.toString()\n      })\n      res.on('end', () => {\n        try {\n          const parsed = JSON.parse(data)\n          settle(parsed?.value?.ready === true)\n        } catch {\n          settle(false)\n        }\n      })\n    })\n    req.on('error', () => settle(false))\n    req.on('timeout', () => {\n      req.destroy()\n      settle(false)\n    })\n    req.end()\n  })\n}\n\n// The port the system hands out on loopback, released at once.\nfunction findFreePort(): Promise<number> {\n  return new Promise((settle, fail) => {\n    const server = createServer()\n    server.unref()\n    server.once('error', fail)\n    server.listen({ port: 0, host: LOOPBACK }, () => {\n      const address = server.address()\n      const port = typeof address === 'object' && address !== null ? address.port : 0\n      server.close(() => settle(port))\n    })\n  })\n}\n\nexport async function startAppiumServer(\n  options: StartAppiumServerOptions = {},\n): Promise<AppiumServer> {\n  const spawn = options.spawn ?? spawnNode\n  const probe = options.probe ?? isAppiumReady\n  const { serverEntry, driverFolders } = resolveBundledAppium()\n  const port = await findFreePort()\n  const home = await prepareAppiumHome(driverFolders)\n  let child: AppiumChild\n  try {\n    child = spawn(\n      process.execPath,\n      [\n        serverEntry,\n        '--address',\n        LOOPBACK,\n        '--port',\n        String(port),\n        '--relaxed-security',\n        '--deny-insecure',\n        '*:cors',\n        '--log-no-colors',\n      ],\n      { env: { ...process.env, APPIUM_HOME: home }, stdio: ['ignore', 'pipe', 'pipe'] },\n    )\n  } catch (error) {\n    // No child exists yet, so nothing else would remove the home.\n    await removeAppiumHome(home).catch(() => {})\n    throw error\n  }\n\n  // An exiting process cannot wait for tree-kill to list the tree, so only the server itself is\n  // signalled here.\n  const killOnExit = (): void => {\n    try {\n      child.kill('SIGKILL')\n    } catch {}\n    try {\n      rmSync(home, { recursive: true, force: true })\n    } catch {}\n  }\n  process.once('exit', killOnExit)\n  // A command that succeeded ends only once nothing holds the event loop, and a child with piped\n  // output would hold it for ever, so the exit listener would never run.\n  child.unref()\n  child.stdout?.unref()\n  child.stderr?.unref()\n\n  const lastLines: string[] = []\n  const forward = (stream: 'stdout' | 'stderr') => (chunk: Buffer) => {\n    const text = chunk.toString('utf8')\n    options.onOutput?.(text, stream)\n    for (const line of text.split(/\\r?\\n/u)) {\n      if (line.trim() === '') continue\n      lastLines.push(line)\n      if (lastLines.length > KEPT_LINES) lastLines.shift()\n    }\n  }\n  child.stdout?.on('data', forward('stdout'))\n  child.stderr?.on('data', forward('stderr'))\n  const withLastLines = (message: string): string => [message, ...lastLines].join('\\n')\n\n  let cleaned: Promise<void> | undefined\n  const cleanUp = (): Promise<void> =>\n    (cleaned ??= removeAppiumHome(home)\n      .catch(() => {})\n      .then(() => {\n        process.off('exit', killOnExit)\n      }))\n\n  let wake = (): void => {}\n  let spawnError: Error | undefined\n  child.once('error', (error) => {\n    spawnError = error\n    wake()\n  })\n  let closedBy: string | undefined\n  const exited = new Promise<void>((settle) => {\n    child.once('close', (code, signal) => {\n      closedBy = signal === null ? `exit code ${code}` : `signal ${signal}`\n      wake()\n      settle()\n    })\n  }).then(cleanUp)\n  const ended = (): boolean => spawnError !== undefined || closedBy !== undefined\n  const pause = (): Promise<void> =>\n    new Promise((settle) => {\n      if (ended()) return settle()\n      const timer = setTimeout(settle, POLL_INTERVAL_MS)\n      wake = () => {\n        clearTimeout(timer)\n        settle()\n      }\n    })\n\n  let stopping: Promise<void> | undefined\n  const stop = (): Promise<void> => {\n    stopping ??= (async () => {\n      if (closedBy === undefined) {\n        // A process that is only waiting for this stop stays alive until the child has closed.\n        child.ref()\n        child.stdout?.ref()\n        child.stderr?.ref()\n        if (child.pid !== undefined) await killTree(child.pid)\n      }\n      await exited\n    })()\n    return stopping\n  }\n\n  const url = `http://${LOOPBACK}:${port}`\n  const deadline = Date.now() + STARTUP_TIMEOUT_MS\n  while (!ended() && Date.now() < deadline) {\n    // Once the child has ended, whatever answers on its port is another process.\n    if ((await probe(url)) && !ended()) return { url, exited, stop }\n    await pause()\n  }\n\n  if (spawnError !== undefined) {\n    await cleanUp()\n    throw spawnError\n  }\n  if (closedBy !== undefined) {\n    await exited\n    throw new Error(withLastLines(`Appium exited before it was ready (${closedBy})`))\n  }\n  await stop()\n  throw new Error(\n    withLastLines(`Appium server did not become ready within ${STARTUP_TIMEOUT_MS}ms`),\n  )\n}\n"],"names":["nodeSpawn"],"mappings":"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","debugId":"c772727d-14c3-532a-a31d-8c4b1188089b"}

package/package.json

@@ -1,6 +1,67 @@
 {
   "name": "@vostride/agent-qa-appium-runtime",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.7",
+  "private": false,
+  "description": "Carries Appium and the UiAutomator2 and XCUITest drivers at pinned versions and starts that Appium server for agent-qa.",
+  "keywords": [
+    "agent-qa",
+    "testing",
+    "appium",
+    "mobile"
+  ],
+  "license": "FSL-1.1-ALv2",
+  "homepage": "https://github.com/vostride/agent-qa#readme",
+  "bugs": {
+    "url": "https://github.com/vostride/agent-qa/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vostride/agent-qa.git",
+    "directory": "packages/appium-runtime"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE.md",
+    "NOTICE.md"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo"
+  },
+  "dependencies": {
+    "appium": "4.0.0-beta.7",
+    "appium-uiautomator2-driver": "9.0.2",
+    "appium-xcuitest-driver": "13.0.8",
+    "tree-kill": "1.2.2"
+  },
+  "devDependencies": {
+    "@types/node": "~24.19.2",
+    "@vostride/agent-qa-arch": "0.3.7",
+    "tsdown": "~0.23.4",
+    "typescript": "~7.0.2",
+    "vitest": "~5.0.5"
+  }
+}