@xopcai/xopc 0.0.416 → 0.0.417

package/dist/src/phone/scrcpy.js

@@ -3,7 +3,8 @@ import { spawnPhoneCommand } from "../process/phone-process.js";
 import { SCRCPY_SHA256, SCRCPY_VERSION } from "../runtime-tools/phone-dependency-catalog.js";
 import { readScrcpyServer, scrcpyServerPath } from "./scrcpy-assets.js";
 import { ScrcpyTextChannel } from "./scrcpy-text.js";
-import { AdbPhoneDriver, runAdb } from "./adb-driver.js";
+import { runAdb } from "./adb-command.js";
+import { readPhoneForeground } from "./foreground.js";
 import { randomBytes } from "node:crypto";
 import { connect } from "node:net";
 import { setTimeout as setTimeout$1 } from "node:timers/promises";
@@ -195,7 +196,7 @@ var LocalScrcpyProvider = class extends ScrcpyProvider {
 		this.textOnly = textOnly;
 	}
 	foreground(signal) {
-		return new AdbPhoneDriver(this.adb).foreground(this.serial, signal);
+		return readPhoneForeground(runAdb, this.adb, this.serial, signal);
 	}
 	async startTransport() {
 		await readScrcpyServer();

package/dist/src/phone/setup/service.d.ts

@@ -4,8 +4,12 @@ import type { PhoneRuntime } from '../runtime.js';
 type Context = {
     conversationId: string;
     agentId: string;
+    canConfigure?: boolean;
+    runId?: string;
 };
 type Setup = Omit<PhoneSetupView, 'readiness' | 'stale' | 'settingsPath' | 'guidanceRefs'> & {
+    verificationRunId?: string;
+    automaticAttempts?: number;
     environmentRevision?: string;
     calls: number;
     owner?: string;
@@ -16,8 +20,17 @@ export interface PhoneSetupDeps {
     revision(context: Context, deviceId: string): string;
     connected(deviceId: string, signal?: AbortSignal): Promise<boolean>;
     leaseActive(deviceId: string): boolean;
+    setModel?: (agentId: string, ref: string) => Promise<void>;
+    models?: () => Array<{
+        ref: string;
+        name: string;
+        configured: boolean;
+    }>;
+    configure?: (enabled: boolean) => Promise<void>;
+    install?: (kind: 'adb' | 'scrcpy', repair: boolean) => Promise<void>;
+    registerLocal?: (serial: string, name?: string) => Promise<void>;
 }
-/** Setup only orchestrates existing settings; secrets and configuration writes stay in product forms. */
+/** Bounded product actions automate setup; credentials remain in secure product forms. */
 export declare class PhoneSetupService {
     private readonly deps;
     constructor(deps: PhoneSetupDeps);
@@ -54,6 +67,7 @@ export declare class PhoneSetupService {
                 settingsAllowed: boolean;
             }>;
             localDiscovery: Array<{
+                serial?: string;
                 name: string;
                 state: string;
                 emulator: boolean;
@@ -67,74 +81,13 @@ export declare class PhoneSetupService {
             path: string;
             resourceVersion: string;
         }[];
+        models?: undefined;
     } | {
-        message: string;
-        id: string;
-        conversationId: string;
-        agentId: string;
-        revision: number;
-        state: "configuring" | "verifying" | "completed" | "needs_attention" | "cancelled";
-        source?: "local" | "aliyun";
-        error?: string;
-        stale: boolean;
-        settingsPath: string;
-        readiness: {
-            enabled: boolean;
-            toolAllowed: boolean;
-            model: {
-                ref?: string;
-                chatRef?: string;
-                source?: "system" | "global" | "agent";
-                supported: boolean;
-                configured: boolean;
-            };
-            dependencies: Array<{
-                kind: "adb" | "scrcpy";
-                state: string;
-                version?: string;
-                canInstall: boolean;
-            }>;
-            devices: Array<{
-                id: string;
-                name: string;
-                source: "local" | "aliyun";
-                enabled: boolean;
-                settingsAllowed: boolean;
-            }>;
-            localDiscovery: Array<{
-                name: string;
-                state: string;
-                emulator: boolean;
-            }>;
-            diagnostic?: string;
-        };
-        checks: {
+        models: {
+            ref: string;
+            name: string;
             configured: boolean;
-            read: boolean;
-            operated: boolean;
-            verified: boolean;
-            released: boolean;
-        };
-        attempt?: {
-            id: string;
-            deviceId: string;
-            modelRef: string;
-            sessionId?: string;
-            goal: string;
-            completion: {
-                appPackage: string;
-                textAny: string[];
-                requireChange: boolean;
-            };
-            maxActions: number;
-            expiresAt: number;
-            released: boolean;
-        };
-        guidanceRefs: Array<{
-            sceneId: "phone";
-            path: string;
-            resourceVersion: string;
-        }>;
+        }[];
     }>;
     source(context: Context, id: string, source: 'local' | 'aliyun', revision: number): Promise<PhoneSetupView>;
     begin(context: Context, id: string, deviceId: string, revision: number, signal?: AbortSignal): Promise<PhoneSetupView>;

package/dist/src/phone/setup/service.js

@@ -1,7 +1,7 @@
 import { DurableState } from "../../storage/sqlite/durable-state.js";
 import { randomUUID } from "node:crypto";
 //#region src/phone/setup/service.ts
-/** Setup only orchestrates existing settings; secrets and configuration writes stay in product forms. */
+/** Bounded product actions automate setup; credentials remain in secure product forms. */
 var PhoneSetupService = class {
 	constructor(deps) {
 		this.deps = deps;
@@ -31,7 +31,7 @@ var PhoneSetupService = class {
 		return setup;
 	}
 	async view(context, setup) {
-		const { owner: _owner, calls: _calls, environmentRevision: _revision, ...summary } = setup;
+		const { owner: _owner, calls: _calls, verificationRunId: _run, automaticAttempts: _attempts, environmentRevision: _revision, ...summary } = setup;
 		const stale = Boolean(setup.attempt && setup.environmentRevision !== this.deps.revision(context, setup.attempt.deviceId));
 		const interrupted = setup.state === "verifying" && (Date.now() > setup.attempt.expiresAt || Boolean(setup.attempt?.sessionId && !this.deps.runtime.status(setup.owner)));
 		return {
@@ -66,7 +66,8 @@ var PhoneSetupService = class {
 		if (command === "start") {
 			if (!setup || ["completed", "cancelled"].includes(setup.state) && (!setup.attempt || setup.attempt.released)) setup = this.save(context, {
 				id: randomUUID(),
-				...context,
+				conversationId: context.conversationId,
+				agentId: context.agentId,
 				state: "configuring",
 				revision: setup?.revision ?? 0,
 				calls: 0,
@@ -80,6 +81,7 @@ var PhoneSetupService = class {
 			});
 			return this.view(context, setup);
 		}
+		if (command === "models") return { models: this.deps.models?.() ?? [] };
 		if (typeof args.setupId !== "string") throw new Error("setupId is required");
 		setup = this.owned(context, args.setupId);
 		if ([
@@ -87,10 +89,50 @@ var PhoneSetupService = class {
 			"recheck",
 			"verification_report"
 		].includes(command)) return this.view(context, setup);
-		if (command === "begin_verification") return {
-			...await this.view(context, setup),
-			message: "Choose the phone and approve the Settings-only test in the original conversation panel."
-		};
+		if (command === "release") return this.release(context, setup.id);
+		if ([
+			"source",
+			"configure",
+			"set_model",
+			"install_dependency",
+			"register_local",
+			"begin_verification"
+		].includes(command)) {
+			if (!context.canConfigure) throw new Error("PHONE_SETUP_INTERACTIVE_REQUIRED: Continue in an authorized interactive conversation.");
+			if (!Number.isInteger(args.expectedRevision) || args.expectedRevision !== setup.revision) throw new Error("PHONE_SETUP_CONFLICT: Re-read current progress.");
+			if (command === "source") {
+				if (args.source !== "local" && args.source !== "aliyun") throw new Error("Choose local or aliyun");
+				return this.source(context, setup.id, args.source, setup.revision);
+			}
+			if (command === "begin_verification") {
+				if (typeof args.deviceId !== "string") throw new Error("Select the exact registered phone with the user before testing");
+				return this.begin(context, setup.id, args.deviceId, setup.revision);
+			}
+			if (setup.attempt && !setup.attempt.released || ["completed", "cancelled"].includes(setup.state)) throw new Error("PHONE_SETUP_CONFLICT: Release the test or start a fresh setup first.");
+			if (command === "configure") {
+				if (!this.deps.configure || typeof args.enabled !== "boolean") throw new Error("Phone configuration is unavailable");
+				if ((await this.deps.inspect(context, setup.source)).enabled !== args.enabled) await this.deps.configure(args.enabled);
+			} else if (command === "set_model") {
+				if (!this.deps.setModel || typeof args.modelRef !== "string") throw new Error("Choose a compatible configured Phone model");
+				const current = (await this.deps.inspect(context, setup.source)).model;
+				if (current.ref !== args.modelRef) {
+					if (current.ref && current.supported && current.configured && args.replaceExisting !== true) throw new Error("PHONE_SETUP_MODEL_CHANGE_REQUIRED: A working Phone model is already configured. Confirm the intended replacement with the user.");
+					await this.deps.setModel(context.agentId, args.modelRef);
+				}
+			} else if (command === "install_dependency") {
+				if (!this.deps.install || args.kind !== "adb" && args.kind !== "scrcpy" || args.repair !== void 0 && typeof args.repair !== "boolean") throw new Error("Choose a managed Phone dependency");
+				if (args.kind === "adb" && setup.source === "aliyun") throw new Error("Cloud direct connections do not need local ADB");
+				const dependency = (await this.deps.inspect(context, setup.source)).dependencies.find((item) => item.kind === args.kind);
+				if (dependency?.state !== "ready" || args.repair === true) {
+					if (!dependency?.canInstall) throw new Error("PHONE_SETUP_INSTALL_UNAVAILABLE: Use an existing verified dependency or review runtime download settings.");
+					await this.deps.install(args.kind, args.repair === true);
+				}
+			} else {
+				if (!this.deps.registerLocal || setup.source !== "local" || typeof args.serial !== "string" || args.name !== void 0 && (typeof args.name !== "string" || args.name.length > 100)) throw new Error("Select a discovered local phone");
+				await this.deps.registerLocal(args.serial, args.name);
+			}
+			return this.view(context, this.owned(context, setup.id));
+		}
 		if (command === "cancel") {
 			setup = this.save(context, {
 				...setup,
@@ -111,6 +153,7 @@ var PhoneSetupService = class {
 	}
 	async begin(context, id, deviceId, revision, signal) {
 		let setup = this.owned(context, id);
+		if (context.runId && setup.verificationRunId === context.runId && (setup.automaticAttempts ?? 0) >= 2) throw new Error("PHONE_SETUP_RETRY_LIMIT: Two attempts in this turn failed. Release control and report the external blocker; wait for a fresh user request.");
 		if (setup.revision !== revision || setup.state === "cancelled" || setup.attempt && !setup.attempt.released) throw new Error("PHONE_SETUP_CONFLICT: Refresh progress and release the old test.");
 		const environmentRevision = this.deps.revision(context, deviceId);
 		const readiness = await this.deps.inspect(context, setup.source);
@@ -150,6 +193,8 @@ var PhoneSetupService = class {
 			owner: `phone-setup:${latest.id}:${attempt.id}`,
 			environmentRevision,
 			calls: 0,
+			verificationRunId: context.runId,
+			automaticAttempts: context.runId && latest.verificationRunId === context.runId ? (latest.automaticAttempts ?? 0) + 1 : 1,
 			checks: {
 				configured: true,
 				read: false,

package/dist/src/phone/task-feedback.d.ts

@@ -0,0 +1,4 @@
+import type { PhoneReport, PhoneTaskFeedback, PhoneRequestedOutput, PhoneObservation } from './contracts.js';
+export declare function nativePhoneOutput(request: PhoneRequestedOutput, observation: PhoneObservation): PhoneTaskFeedback['outputs'][number];
+/** Completion is evidence-based; dispatch and model summaries never establish success. */
+export declare function updatePhoneFeedback(report: PhoneReport, usage: PhoneTaskFeedback['usage'], previous?: PhoneTaskFeedback): PhoneTaskFeedback | undefined;

package/dist/src/phone/task-feedback.js

@@ -0,0 +1,47 @@
+//#region src/phone/task-feedback.ts
+function nativePhoneOutput(request, observation) {
+	const selector = request.selector;
+	const nodes = selector ? observation.elements.filter((node) => !node.password && node.bounds[0] >= 0 && node.bounds[1] >= 0 && node.bounds[2] <= observation.width && node.bounds[3] <= observation.height && node.bounds[2] > node.bounds[0] && node.bounds[3] > node.bounds[1] && (!selector.resourceId || node.resourceId === selector.resourceId) && (!selector.text || node.text === selector.text) && (!selector.description || node.description === selector.description)) : [];
+	const value = nodes.length === 1 ? nodes[0].text || nodes[0].description : void 0;
+	return {
+		key: request.key,
+		...value ? { value: value.slice(0, 4e3) } : {},
+		source: "native_ui",
+		verification: value ? "observed" : "unavailable",
+		frameId: observation.frameId,
+		capturedAt: observation.capturedAt,
+		...!value ? { reason: nodes.length > 1 ? "ambiguous_native_output" : "native_output_unavailable" } : {}
+	};
+}
+/** Completion is evidence-based; dispatch and model summaries never establish success. */
+function updatePhoneFeedback(report, usage, previous) {
+	if (!report.task || !previous) return void 0;
+	const inspection = report.status === "outcome_unknown" || report.status !== "running" && report.steps.at(-1)?.dispatch === "unknown";
+	const stopped = report.stopReason === "cancel" || report.status === "cancelled" || report.status === "closed";
+	const exhausted = [
+		"action_limit",
+		"task_action_limit",
+		"operation_timeout"
+	].includes(report.stopReason ?? "") || ["PHONE_MODEL_LIMIT", "PHONE_ACTION_LIMIT"].includes(report.errorCode ?? "");
+	const outcome = inspection ? "needs_user" : stopped ? "cancelled" : exhausted ? "partial" : report.status === "running" ? "running" : report.status === "needs_user" ? "needs_user" : report.status === "failed" ? "failed" : report.status === "paused" ? "blocked" : report.verified && report.status === "completed" ? "completed" : "partial";
+	const outputs = previous.outputs;
+	const missing = outputs.filter((output) => output.verification === "unavailable").map((output) => `Output unavailable: ${output.key}`);
+	return {
+		...previous,
+		outcome,
+		stopReason: report.stopReason,
+		verified: report.verified,
+		verificationLevel: report.verified ? report.verificationLevel : "none",
+		progress: {
+			completed: report.verified ? ["Declared UI completion conditions satisfied"] : [],
+			remaining: [...report.verified ? [] : ["Current goal has not been verified"], ...missing],
+			source: "runtime"
+		},
+		outputs,
+		evidence: structuredClone(report.readings ?? []),
+		usage,
+		nextAction: inspection || report.stopReason === "operation_timeout" ? "inspect" : exhausted && report.stopReason !== "action_limit" ? "user" : outcome === "needs_user" ? "user" : outcome === "running" ? "wait" : outcome === "completed" ? "done" : outcome === "partial" ? "replan" : outcome === "blocked" ? "inspect" : "user"
+	};
+}
+//#endregion
+export { nativePhoneOutput, updatePhoneFeedback };

package/dist/src/phone/ui-dump-binary.d.ts

@@ -0,0 +1 @@
+export declare const PHONE_UI_DEX = "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Q2hhclNlcXVlbmNlOwARTGphdmEvbGFuZy9DbGFzczsAFUxqYXZhL2xhbmcvRXhjZXB0aW9uOwAhTGphdmEvbGFuZy9JbGxlZ2FsU3RhdGVFeGNlcHRpb247ABNMamF2YS9sYW5nL0ludGVnZXI7ABBMamF2YS9sYW5nL01hdGg7ABJMamF2YS9sYW5nL09iamVjdDsAEkxqYXZhL2xhbmcvU3RyaW5nOwAZTGphdmEvbGFuZy9TdHJpbmdCdWlsZGVyOwASTGphdmEvbGFuZy9TeXN0ZW07ABJMamF2YS9sYW5nL1RocmVhZDsAH0xqYXZhL2xhbmcvcmVmbGVjdC9Db25zdHJ1Y3RvcjsAGkxqYXZhL2xhbmcvcmVmbGVjdC9NZXRob2Q7AB5Mb3JnL3htbHB1bGwvdjEvWG1sU2VyaWFsaXplcjsAHE5vIGFjdGl2ZSBhY2Nlc3NpYmlsaXR5IHJvb3QAEFBob25lVWlEdW1wLmphdmEABFRZUEUABVVURi04AAFWAAJWSgACVkwAA1ZMTAAEVkxMSQABWgABWwASW0xqYXZhL2xhbmcvQ2xhc3M7ABNbTGphdmEvbGFuZy9PYmplY3Q7ABNbTGphdmEvbGFuZy9TdHJpbmc7AAFdAAJdWwAjYW5kcm9pZC5hcHAuSVVpQXV0b21hdGlvbkNvbm5lY3Rpb24AImFuZHJvaWQuYXBwLlVpQXV0b21hdGlvbkNvbm5lY3Rpb24ABmFwcGVuZAAJYXR0cmlidXRlAAZib3R0b20ABmJvdW5kcwAFY2xhc3MACWNsaWNrYWJsZQAHY29ubmVjdAAMY29udGVudC1kZXNjAApkaXNjb25uZWN0AARkdW1wAAtlbmREb2N1bWVudAAGZW5kVGFnAAVmbGFncwAHZm9jdXNlZAAHZm9yTmFtZQARZ2V0Qm91bmRzSW5TY3JlZW4ACGdldENoaWxkAA1nZXRDaGlsZENvdW50AAxnZXRDbGFzc05hbWUAFWdldENvbnRlbnREZXNjcmlwdGlvbgAWZ2V0RGVjbGFyZWRDb25zdHJ1Y3RvcgAJZ2V0TG9vcGVyAAlnZXRNZXRob2QADmdldFBhY2thZ2VOYW1lABVnZXRSb290SW5BY3RpdmVXaW5kb3cADmdldFNlcnZpY2VJbmZvAAdnZXRUZXh0ABVnZXRWaWV3SWRSZXNvdXJjZU5hbWUACWhpZXJhcmNoeQAGaW52b2tlAAtpc0NsaWNrYWJsZQAJaXNGb2N1c2VkAAppc1Bhc3N3b3JkAA9pc1Zpc2libGVUb1VzZXIABGxlZnQABmxlbmd0aAAEbWFpbgADbWF4AANtaW4AC25ld0luc3RhbmNlAA1uZXdTZXJpYWxpemVyAARub2RlAAVub2RlcwADb3V0AAdwYWNrYWdlAAhwYXNzd29yZAAHcHJpbnRsbgAKcXVpdFNhZmVseQAHcmVjeWNsZQALcmVzb3VyY2UtaWQABXJpZ2h0AAlzZXRPdXRwdXQADnNldFNlcnZpY2VJbmZvAAVzbGVlcAAFc3RhcnQADXN0YXJ0RG9jdW1lbnQACHN0YXJ0VGFnAAlzdWJzdHJpbmcABHRleHQACHRvU3RyaW5nAAN0b3AABXZhbHVlAAd2YWx1ZU9mABZ4b3BjLXBob25lLW9ic2VydmF0aW9uAJ0Bfn5EOHsiYmFja2VuZCI6ImRleCIsImNvbXBpbGF0aW9uLW1vZGUiOiJkZWJ1ZyIsImhhcy1jaGVja3N1bXMiOmZhbHNlLCJtaW4tYXBpIjoyNCwic2hhLTEiOiJhN2FkMThhNzA0NjBiNzk5ZDA0ODJlNDk3YzEwOWE3NWJmN2Y5MWRlIiwidmVyc2lvbiI6IjguMTAuOS1kZXYifQACCgF4HAEYEQEABAAACgCBgATMDQEK5A0BCcQSAQqMDQAAAQAAAKYTAAAAAAAAAAAAAAIAAAAAAAAAAQAAAMgTAAACAAAAyBMAABAAAAAAAAAAAQAAAAAAAAABAAAAfAAAAHAAAAACAAAAIgAAAGACAAADAAAAIQAAAOgCAAAEAAAACAAAAHQEAAAFAAAANwAAALQEAAAGAAAAAQAAAGwGAAABIAAABAAAAIwGAAADIAAABAAAAFILAAABEAAAEgAAALwLAAACIAAAfAAAAFIMAAAEIAAAAQAAAKYTAAAAIAAAAQAAAK4TAAADEAAAAQAAAMgTAAAGIAAAAQAAANATAAAAEAAAAQAAAPATAAA=";

package/dist/src/phone/ui-dump-binary.js

@@ -0,0 +1,4 @@
+//#region src/phone/ui-dump-binary.ts
+const PHONE_UI_DEX = "ZGV4CjAzNwDKubV7xpK6F99L4fHSxADN0lzEMQvznKm0FAAAcAAAAHhWNBIAAAAAAAAAAPATAAB8AAAAcAAAACIAAABgAgAAIQAAAOgCAAAIAAAAdAQAADcAAAC0BAAAAQAAAGwGAAAoDgAAjAYAAFIMAABUDAAAVwwAAF8MAABiDAAAZwwAAGoMAABtDAAAcQwAAHYMAAB6DAAAfwwAAIQMAACKDAAAjgwAAKsMAADkDAAAAA0AABkNAAA1DQAASg0AAF4NAACSDQAArg0AAMUNAADdDQAA7w0AAAQOAAAeDgAAMQ4AAEgOAABrDgAAgA4AAJIOAACmDgAAug4AANUOAADpDgAA/Q4AAB4PAAA6DwAAWg8AAHgPAACKDwAAkA8AAJcPAACaDwAAng8AAKIPAACnDwAArQ8AALAPAACzDwAAxw8AANwPAADxDwAA9A8AAPgPAAAdEAAAQRAAAEkQAABUEAAAXBAAAGQQAABrEAAAdhAAAH8QAACNEAAAmRAAAJ8QAACsEAAAtBAAALsQAADEEAAAzRAAAOAQAADqEAAA+RAAAAcRAAAeEQAANhEAAEERAABMEQAAXBEAAHMRAACDEQAAjBEAAKMRAACuEQAAthEAAMMRAADOEQAA2hEAAOsRAADxEQAA+REAAP8RAAAEEgAACRIAABYSAAAlEgAAKxIAADISAAA3EgAAQBIAAEoSAABTEgAAXxIAAGgSAAB1EgAAfBIAAIcSAACXEgAAnhIAAKUSAAC0EgAAvhIAAMkSAADPEgAA2RIAAN4SAADlEgAA7hIAAAYTAAADAAAABQAAAA4AAAAPAAAAEAAAABEAAAASAAAAEwAAABQAAAAVAAAAFgAAABcAAAAYAAAAGQAAABoAAAAbAAAAHAAAAB0AAAAeAAAAHwAAACAAAAAhAAAAIgAAACMAAAAkAAAAJQAAACYAAAAnAAAAKAAAAC0AAAAyAAAANAAAADUAAAA2AAAAAwAAAAAAAAAAAAAABAAAAAAAAAC8CwAABgAAAAMAAAAAAAAABgAAAAcAAAAAAAAABgAAAAkAAAAAAAAABwAAAAkAAADECwAADQAAAA4AAADMCwAABgAAAA8AAAAAAAAACQAAABAAAADUCwAABwAAABMAAADECwAACwAAABUAAADcCwAACQAAABUAAADkCwAABgAAABYAAAAAAAAACAAAABYAAAC8CwAACgAAABYAAADsCwAADQAAABYAAADMCwAABwAAABcAAADECwAACQAAABcAAADUCwAACQAAABoAAAD0CwAACwAAABsAAAD8CwAABgAAABwAAAAAAAAACwAAABwAAAAEDAAADAAAABwAAAAMDAAALQAAAB0AAAAAAAAALgAAAB0AAAAYDAAALwAAAB0AAAAgDAAALwAAAB0AAAAoDAAALwAAAB0AAAAwDAAALwAAAB0AAADUCwAAMAAAAB0AAAA4DAAAMQAAAB0AAABADAAALwAAAB0AAABMDAAAMgAAAB4AAAAAAAAAAgAAAGUAAAADAAAARwAAAAUAAAA9AAAABQAAAF0AAAAFAAAAbQAAAAUAAAB3AAAAEwAQACsAAAAYAAsAZgAAAAIAFwACAAAAAgAeAEQAAAACAB8AXwAAAAIADgB1AAAABAAEAFMAAAAEAAIAVAAAAAQAGQBvAAAABQAXAAIAAAAGABwAAgAAAAYAAwBQAAAABgAgAGoAAAAGABcAcQAAAAgAFABjAAAACQAaAEoAAAAJAAUASwAAAAkAAABMAAAACQAHAE0AAAAJAAcATgAAAAkABwBSAAAACQAHAFUAAAAJAAwAVgAAAAkAIABZAAAACQAgAFoAAAAJACAAWwAAAAkAIABcAAAACQAXAGsAAAALABwAaQAAAAwAFwACAAAADAAMAHYAAAAOAAYAeQAAAA8ADAB2AAAAEAAIAEkAAAAQABIATwAAABAAEwBRAAAAEgAcAAIAAAATAAkAeQAAABQAAQBgAAAAFAABAGEAAAAVABcAAgAAABYAAABeAAAAFgANAHQAAAAWAA8AeQAAABcAFwACAAAAFwAQADsAAAAXABEAOwAAABcADAB2AAAAGQAYAHAAAAAaAAsAYgAAABsACgBYAAAAHAAWADwAAAAcABcARQAAABwAFQBGAAAAHAAbAG4AAAAcAB0AcgAAABwAFQBzAAAAAgAAABEAAAAVAAAAAAAAACoAAADQEwAArhMAAAAAAAADAAIAAwAAAFILAAAXAAAAOQEFABoBAAARAXIQHgABAAwBbhAnAAEACgBxICUAIAAKAhIAbjAoAAECDAERAQAAAQABAAEAAABaCwAABAAAAHAQJgAAAA4ADAADAAQAAgBeCwAAHgEAABoAAQAaAWQAOQoDAA4AEwIyADYrEQFgAgAAEwP0ATUyCwFuEBgACgAKAjkCBAApAAMBYAIAANgCAgFnAgAAIgIFAHAQBwACAG4gDQAqABIEcjA2AEkBGgVnAG4QEgAKAAwGEwcsAXEgAwB2AAwGckAxAEllGgU/AG4QEAAKAAwGcSADAHYADAZyQDEASWUaBWwAbhAUAAoADAZxIAMANgAMBnJAMQBJZRoFaABuEBcACgAKBnEQKQAGAAwGckAxAEllGgV1AG4QFwAKAAoGGggAADgGBAAHhigJbhATAAoADAZxIAMANgAMBnJAMQBJZRoFQgBuEBcACgAKBjgGAwAoCW4QEQAKAAwGcSADAHYADAhyQDEASYUaBUAAbhAVAAoACgZxECkABgAMBnJAMQBJZRoFSABuEBYACgAKBnEQKQAGAAwGckAxAEllGgU+ACIGFwBwECoABgAaBzMAbiAsAHYADAZSJwMAEghxICQAeAAKB24gKwB2AAwGbiAsAAYADAZSJwUAcSAkAHgACgduICsAdgAMBhoHOABuICwAdgAMBlInBABxICQAeAAKB24gKwB2AAwGbiAsAAYADABSIgIAcSAkACgACgJuICsAIAAMABoCNwBuICwAIAAMAG4QLQAAAAwAckAxAEkFAABuEA8ACgAKADUIEgBgAAAANTAOAG4gDgCKAAwA2AILAXEwAQAJAtgICAEo63IwMwBJAW4QGQAKAA4ADQluEBkACgAnCW4QGQAKAA4ACwAAAFwAAQBtAAAApAABAAEAlQIMAAEAAwAEAIULAADqAAAAGgtXABoAQwAiAQYAGgJ6AHAgCAAhAG4QCwABAAAAAAASAhIDGgQ5AHEQHwAEAAwEGgU6AHEQHwAFAAwFIzYfAG4gIABlAAwFIzYgAG4gLwBlAAwFHAYEABwHBwAkIB8ARwAMBG4gIABGAAwEbhAJAAEADAYkICAAVgAMBW4gLwBUAAwEHwQEABwFBAAaBkEAYgcGACQQHwAHAAwHbjAhAGUHDAUSFnEQIwAGAAwHJBAgAAcADAduMDAARQcAAG4QBQAEAAwFUlcBAN4HBxBZVwEAUlcBAN0HB/1ZVwEAbiAGAFQAAAAHJwE1EwgUADWFEgA5BxAAbhAEAAQADAc5BwcAFggyAHEgLgCYANgFBQEo7TgHPgAiBQwAcBAbAAUAcQAMAAAADAhyIDQAWAAaCSwAcRAdAAYADApyMDUAmApyMDYAKAtxMAEAeANyMDMAKAtyEDIACABiCwcAbhAcAAUADAJuIBoAKwAcCwQAIzIfAG4wIQALAgwLIzAgAG4wMABLAG4QCgABAAAADgAiCxIAGgIpAHAgIgArACcLDQsoAw0LATYHQigDDQsBNjgGDwAcBAQAIzUfAG4wIQAEBQwAIzMgAG4wMAAgA24QCgABACcLEgAAADIAAQBEAAAAGgAEAF8AAABWAAcAxwAAAAgABwADANUBANEBAM8BEgIAAA5aSwAOAA4AGAMAAAAOeQESD2laPEvw0tLSARcPARQP0tIBUQ8BFw88PBwCcIYALgEADrQ8Hh+HARIPARoQARoPHktpaTweh0t1Py1aSzyWPDw8PJfSPB4Cch0CC4YBFw88AAAAAAIAAAAAAAAAAQAAAAAAAAABAAAAHgAAAAEAAAAWAAAAAgAAABUAIAABAAAAIAAAAAIAAAAPAAAAAQAAAB8AAAACAAAAFgAfAAIAAAAWABYAAwAAABYAFgAWAAAAAQAAAAEAAAABAAAAAwAAAAEAAAAFAAAAAQAAAA0AAAACAAAAFgAOAAMAAAAcAAkAAAAAAAEAAAAhAAAAASwABjxpbml0PgABSQADSUlJAAFKAAFMAAJMSQADTElJAAJMTAADTExJAANMTEwABExMTEwAAkxaABtMYWkveG9wYy9waG9uZS9QaG9uZVVpRHVtcDsAN0xhbmRyb2lkL2FjY2Vzc2liaWxpdHlzZXJ2aWNlL0FjY2Vzc2liaWxpdHlTZXJ2aWNlSW5mbzsAGkxhbmRyb2lkL2FwcC9VaUF1dG9tYXRpb247ABdMYW5kcm9pZC9ncmFwaGljcy9SZWN0OwAaTGFuZHJvaWQvb3MvSGFuZGxlclRocmVhZDsAE0xhbmRyb2lkL29zL0xvb3BlcjsAEkxhbmRyb2lkL3V0aWwvWG1sOwAyTGFuZHJvaWQvdmlldy9hY2Nlc3NpYmlsaXR5L0FjY2Vzc2liaWxpdHlOb2RlSW5mbzsAGkxkYWx2aWsvYW5ub3RhdGlvbi9UaHJvd3M7ABVMamF2YS9pby9QcmludFN0cmVhbTsAFkxqYXZhL2lvL1N0cmluZ1dyaXRlcjsAEExqYXZhL2lvL1dyaXRlcjsAE0xqYXZhL2xhbmcvQm9vbGVhbjsAGExqYXZhL2xhbmcvQ2hhclNlcXVlbmNlOwARTGphdmEvbGFuZy9DbGFzczsAFUxqYXZhL2xhbmcvRXhjZXB0aW9uOwAhTGphdmEvbGFuZy9JbGxlZ2FsU3RhdGVFeGNlcHRpb247ABNMamF2YS9sYW5nL0ludGVnZXI7ABBMamF2YS9sYW5nL01hdGg7ABJMamF2YS9sYW5nL09iamVjdDsAEkxqYXZhL2xhbmcvU3RyaW5nOwAZTGphdmEvbGFuZy9TdHJpbmdCdWlsZGVyOwASTGphdmEvbGFuZy9TeXN0ZW07ABJMamF2YS9sYW5nL1RocmVhZDsAH0xqYXZhL2xhbmcvcmVmbGVjdC9Db25zdHJ1Y3RvcjsAGkxqYXZhL2xhbmcvcmVmbGVjdC9NZXRob2Q7AB5Mb3JnL3htbHB1bGwvdjEvWG1sU2VyaWFsaXplcjsAHE5vIGFjdGl2ZSBhY2Nlc3NpYmlsaXR5IHJvb3QAEFBob25lVWlEdW1wLmphdmEABFRZUEUABVVURi04AAFWAAJWSgACVkwAA1ZMTAAEVkxMSQABWgABWwASW0xqYXZhL2xhbmcvQ2xhc3M7ABNbTGphdmEvbGFuZy9PYmplY3Q7ABNbTGphdmEvbGFuZy9TdHJpbmc7AAFdAAJdWwAjYW5kcm9pZC5hcHAuSVVpQXV0b21hdGlvbkNvbm5lY3Rpb24AImFuZHJvaWQuYXBwLlVpQXV0b21hdGlvbkNvbm5lY3Rpb24ABmFwcGVuZAAJYXR0cmlidXRlAAZib3R0b20ABmJvdW5kcwAFY2xhc3MACWNsaWNrYWJsZQAHY29ubmVjdAAMY29udGVudC1kZXNjAApkaXNjb25uZWN0AARkdW1wAAtlbmREb2N1bWVudAAGZW5kVGFnAAVmbGFncwAHZm9jdXNlZAAHZm9yTmFtZQARZ2V0Qm91bmRzSW5TY3JlZW4ACGdldENoaWxkAA1nZXRDaGlsZENvdW50AAxnZXRDbGFzc05hbWUAFWdldENvbnRlbnREZXNjcmlwdGlvbgAWZ2V0RGVjbGFyZWRDb25zdHJ1Y3RvcgAJZ2V0TG9vcGVyAAlnZXRNZXRob2QADmdldFBhY2thZ2VOYW1lABVnZXRSb290SW5BY3RpdmVXaW5kb3cADmdldFNlcnZpY2VJbmZvAAdnZXRUZXh0ABVnZXRWaWV3SWRSZXNvdXJjZU5hbWUACWhpZXJhcmNoeQAGaW52b2tlAAtpc0NsaWNrYWJsZQAJaXNGb2N1c2VkAAppc1Bhc3N3b3JkAA9pc1Zpc2libGVUb1VzZXIABGxlZnQABmxlbmd0aAAEbWFpbgADbWF4AANtaW4AC25ld0luc3RhbmNlAA1uZXdTZXJpYWxpemVyAARub2RlAAVub2RlcwADb3V0AAdwYWNrYWdlAAhwYXNzd29yZAAHcHJpbnRsbgAKcXVpdFNhZmVseQAHcmVjeWNsZQALcmVzb3VyY2UtaWQABXJpZ2h0AAlzZXRPdXRwdXQADnNldFNlcnZpY2VJbmZvAAVzbGVlcAAFc3RhcnQADXN0YXJ0RG9jdW1lbnQACHN0YXJ0VGFnAAlzdWJzdHJpbmcABHRleHQACHRvU3RyaW5nAAN0b3AABXZhbHVlAAd2YWx1ZU9mABZ4b3BjLXBob25lLW9ic2VydmF0aW9uAJ0Bfn5EOHsiYmFja2VuZCI6ImRleCIsImNvbXBpbGF0aW9uLW1vZGUiOiJkZWJ1ZyIsImhhcy1jaGVja3N1bXMiOmZhbHNlLCJtaW4tYXBpIjoyNCwic2hhLTEiOiJhN2FkMThhNzA0NjBiNzk5ZDA0ODJlNDk3YzEwOWE3NWJmN2Y5MWRlIiwidmVyc2lvbiI6IjguMTAuOS1kZXYifQACCgF4HAEYEQEABAAACgCBgATMDQEK5A0BCcQSAQqMDQAAAQAAAKYTAAAAAAAAAAAAAAIAAAAAAAAAAQAAAMgTAAACAAAAyBMAABAAAAAAAAAAAQAAAAAAAAABAAAAfAAAAHAAAAACAAAAIgAAAGACAAADAAAAIQAAAOgCAAAEAAAACAAAAHQEAAAFAAAANwAAALQEAAAGAAAAAQAAAGwGAAABIAAABAAAAIwGAAADIAAABAAAAFILAAABEAAAEgAAALwLAAACIAAAfAAAAFIMAAAEIAAAAQAAAKYTAAAAIAAAAQAAAK4TAAADEAAAAQAAAMgTAAAGIAAAAQAAANATAAAAEAAAAQAAAPATAAA=";
+//#endregion
+export { PHONE_UI_DEX };

package/dist/src/phone/wireless.d.ts

@@ -0,0 +1,80 @@
+import { runAdb } from './adb-command.js';
+import { type DiscoveredPhone, type PhoneDevice } from './contracts.js';
+type Command = typeof runAdb;
+export type WirelessService = {
+    name: string;
+    host: string;
+    port: number;
+    kind: 'pairing' | 'connect';
+};
+export type WirelessStatus = 'waiting' | 'pairing' | 'paired' | 'connecting' | 'connected' | 'timeout' | 'error' | 'cancelled';
+export type WirelessSession = {
+    id: string;
+    status: WirelessStatus;
+    expiresAt: number;
+    qrPayload?: string;
+    device?: DiscoveredPhone;
+    errorCode?: string;
+};
+export declare function validateWirelessHost(host: string): string;
+export declare function parseWirelessServices(output: string): WirelessService[];
+/** Pairing credentials are ephemeral; only verified device identities may be registered. */
+export declare class WirelessPhones {
+    private command;
+    private intervalMs;
+    private lifetimeMs;
+    private controller;
+    private sessions;
+    private identities;
+    constructor(command?: Command, intervalMs?: number, lifetimeMs?: number);
+    services(path: string, signal?: AbortSignal): Promise<WirelessService[]>;
+    discovery(path: string, signal?: AbortSignal): Promise<{
+        mdns: boolean;
+        services: WirelessService[];
+    }>;
+    known(serial: string): {
+        guid: string;
+        hardwareSerial: string;
+        host: string;
+        port: number;
+    };
+    private view;
+    get(owner: string, id: string): WirelessSession;
+    cancel(owner: string, id: string): void;
+    close(): void;
+    create(owner: string, path: string, input?: {
+        host: string;
+        pairingPort: number;
+        code: string;
+        connectPort?: number;
+    }): WirelessSession;
+    private run;
+    connect(path: string, endpoint: {
+        host: string;
+        port: number;
+    }, signal?: AbortSignal, expected?: {
+        guid: string;
+        hardwareSerial?: string;
+    }): Promise<{
+        device: DiscoveredPhone;
+        wireless: {
+            host: string;
+            port: number;
+            hardwareSerial: string;
+            guid: string;
+        };
+    }>;
+    reconnect(path: string, wireless: NonNullable<PhoneDevice['wireless']>, signal?: AbortSignal, endpoint?: {
+        host: string;
+        port: number;
+    }): Promise<{
+        device: DiscoveredPhone;
+        wireless: {
+            host: string;
+            port: number;
+            hardwareSerial: string;
+            guid: string;
+        };
+    }>;
+}
+export {};

package/dist/src/phone/wireless.js

@@ -0,0 +1,244 @@
+import { PhoneError, init_contracts } from "./contracts.js";
+import { runAdb } from "./adb-command.js";
+import { parseAdbDevices } from "./adb-driver.js";
+import { randomBytes, randomUUID } from "node:crypto";
+import { isIP } from "node:net";
+import { setTimeout } from "node:timers/promises";
+//#region src/phone/wireless.ts
+init_contracts();
+function validateWirelessHost(host) {
+	if (isIP(host) !== 4 || !/^(10\.|192\.168\.|172\.(1[6-9]|2\d|3[01])\.|169\.254\.)/.test(host)) throw new PhoneError("PHONE_WIRELESS_ADDRESS", "Enter the phone’s private IPv4 address on the Gateway network");
+	return host;
+}
+function parseWirelessServices(output) {
+	return output.split(/\r?\n/).flatMap((line) => {
+		const match = /^\s*(\S+)\s+_adb-tls-(pairing|connect)\._tcp\.?\s+(\d+\.\d+\.\d+\.\d+):(\d+)\s*$/.exec(line);
+		if (!match) return [];
+		const port = Number(match[4]);
+		try {
+			validateWirelessHost(match[3]);
+		} catch {
+			return [];
+		}
+		return port > 0 && port <= 65535 ? [{
+			name: match[1].replace(/\._adb-tls-(?:pairing|connect)\._tcp(?:\.local)?\.?$/, ""),
+			kind: match[2],
+			host: match[3],
+			port
+		}] : [];
+	});
+}
+/** Pairing credentials are ephemeral; only verified device identities may be registered. */
+var WirelessPhones = class {
+	controller = new AbortController();
+	sessions = /* @__PURE__ */ new Map();
+	identities = /* @__PURE__ */ new Map();
+	constructor(command = runAdb, intervalMs = 1500, lifetimeMs = 9e4) {
+		this.command = command;
+		this.intervalMs = intervalMs;
+		this.lifetimeMs = lifetimeMs;
+	}
+	async services(path, signal) {
+		signal = AbortSignal.any([this.controller.signal, ...signal ? [signal] : []]);
+		return parseWirelessServices((await this.command(path, ["mdns", "services"], signal, 5e3)).toString());
+	}
+	async discovery(path, signal) {
+		await this.command(path, ["version"], signal, 5e3);
+		try {
+			const check = (await this.command(path, ["mdns", "check"], signal, 5e3)).toString();
+			const mdns = !/unavailable|disabled|not available|not running|error/i.test(check);
+			return {
+				mdns,
+				services: mdns ? await this.services(path, signal) : []
+			};
+		} catch {
+			signal?.throwIfAborted();
+			return {
+				mdns: false,
+				services: []
+			};
+		}
+	}
+	known(serial) {
+		return this.identities.get(serial);
+	}
+	view(session) {
+		return {
+			id: session.id,
+			status: session.status,
+			expiresAt: session.expiresAt,
+			...session.status === "waiting" ? { qrPayload: session.qrPayload } : {},
+			device: session.device,
+			errorCode: session.errorCode
+		};
+	}
+	get(owner, id) {
+		const session = this.sessions.get(id);
+		if (!session || session.owner !== owner) throw new PhoneError("PHONE_PAIRING_NOT_FOUND", "Pairing session expired", 404);
+		return this.view(session);
+	}
+	cancel(owner, id) {
+		this.get(owner, id);
+		const session = this.sessions.get(id);
+		session.controller.abort();
+		session.secret = "";
+		session.qrPayload = void 0;
+		session.status = "cancelled";
+		this.sessions.delete(id);
+	}
+	close() {
+		this.controller.abort();
+		this.controller = new AbortController();
+		for (const session of this.sessions.values()) session.controller.abort();
+		this.sessions.clear();
+		this.identities.clear();
+	}
+	create(owner, path, input) {
+		if (input) validateWirelessHost(input.host);
+		for (const [id, session] of this.sessions) if (session.owner === owner || session.expiresAt < Date.now()) {
+			session.controller.abort();
+			session.secret = "";
+			this.sessions.delete(id);
+		}
+		if (this.sessions.size >= 8) throw new PhoneError("PHONE_PAIRING_BUSY", "Too many pairing sessions", 409);
+		const name = `studio-${randomBytes(8).toString("hex")}`;
+		const secret = input?.code ?? randomBytes(16).toString("hex");
+		const session = {
+			id: randomUUID(),
+			owner,
+			path,
+			name: input ? void 0 : name,
+			secret,
+			qrPayload: input ? void 0 : `WIFI:T:ADB;S:${name};P:${secret};;`,
+			status: input ? "pairing" : "waiting",
+			paired: false,
+			expiresAt: Date.now() + this.lifetimeMs,
+			controller: new AbortController(),
+			host: input?.host,
+			connectPort: input?.connectPort
+		};
+		this.sessions.set(session.id, session);
+		session.task = this.run(session, input?.pairingPort);
+		return this.view(session);
+	}
+	async run(session, pairingPort) {
+		const deadline = AbortSignal.timeout(Math.max(1, session.expiresAt - Date.now()));
+		const signal = AbortSignal.any([session.controller.signal, deadline]);
+		try {
+			while (!signal.aborted) {
+				const services = await this.services(session.path, signal).catch(() => {
+					signal.throwIfAborted();
+					return [];
+				});
+				if (!session.paired) {
+					const pair = pairingPort && session.host ? {
+						host: session.host,
+						port: pairingPort
+					} : services.find((item) => item.kind === "pairing" && item.name === session.name);
+					if (pair) {
+						session.status = "pairing";
+						const output = (await this.command(session.path, [
+							"pair",
+							`${pair.host}:${pair.port}`,
+							session.secret
+						], signal, 25e3)).toString();
+						if (!/Successfully paired/i.test(output)) throw new PhoneError("PHONE_PAIRING_FAILED", "Pairing failed");
+						signal.throwIfAborted();
+						session.pairedGuid = /\[guid=([^\]]+)\]/i.exec(output)?.[1];
+						session.paired = true;
+						session.host = pair.host;
+						session.status = "paired";
+						session.secret = "";
+						session.qrPayload = void 0;
+					}
+				}
+				if (session.paired) {
+					const candidates = session.connectPort ? [{
+						host: session.host,
+						port: session.connectPort
+					}] : services.filter((item) => item.kind === "connect" && item.host === session.host && (!session.pairedGuid || item.name === session.pairedGuid || item.name.startsWith(`${session.pairedGuid}-`)));
+					for (const endpoint of candidates) {
+						session.status = "connecting";
+						try {
+							const result = await this.connect(session.path, endpoint, signal, session.pairedGuid ? { guid: session.pairedGuid } : void 0);
+							signal.throwIfAborted();
+							session.device = result.device;
+							session.status = "connected";
+							return;
+						} catch {
+							signal.throwIfAborted();
+							session.status = "paired";
+						}
+					}
+				}
+				await setTimeout(this.intervalMs, void 0, { signal });
+			}
+		} catch (error) {
+			if (session.controller.signal.aborted) return;
+			session.status = deadline.aborted ? "timeout" : "error";
+			session.errorCode = deadline.aborted ? session.paired ? "PHONE_CONNECT_TIMEOUT" : "PHONE_PAIRING_TIMEOUT" : error instanceof PhoneError ? error.code : "PHONE_PAIRING_FAILED";
+		} finally {
+			session.secret = "";
+			session.qrPayload = void 0;
+		}
+	}
+	async connect(path, endpoint, signal, expected) {
+		signal = AbortSignal.any([this.controller.signal, ...signal ? [signal] : []]);
+		validateWirelessHost(endpoint.host);
+		if (!Number.isInteger(endpoint.port) || endpoint.port < 1 || endpoint.port > 65535) throw new PhoneError("PHONE_WIRELESS_PORT", "Enter a valid connection port");
+		const serial = `${endpoint.host}:${endpoint.port}`;
+		const output = (await this.command(path, ["connect", serial], signal, 1e4)).toString();
+		if (!/^(?:already )?connected to /im.test(output)) throw new PhoneError("PHONE_CONNECT_FAILED", "Unable to connect; check wireless debugging and connection port");
+		const devices = parseAdbDevices((await this.command(path, ["devices", "-l"], signal)).toString());
+		let device = devices.find((item) => item.serial === serial && item.state === "device");
+		if (!device) {
+			const names = (await this.services(path, signal)).filter((item) => item.kind === "connect" && item.host === endpoint.host && item.port === endpoint.port).map((item) => item.name);
+			device = devices.find((item) => item.state === "device" && names.some((name) => item.serial === `${name}._adb-tls-connect._tcp` || item.serial === `${name}._adb-tls-connect._tcp.local.`));
+		}
+		if (!device) throw new PhoneError("PHONE_DEVICE_OFFLINE", "Phone is not online and authorized");
+		const hardwareSerial = (await this.command(path, [
+			"-s",
+			device.serial,
+			"shell",
+			"getprop",
+			"ro.serialno"
+		], signal)).toString().trim();
+		const guid = (await this.command(path, [
+			"-s",
+			device.serial,
+			"shell",
+			"getprop",
+			"persist.adb.wifi.guid"
+		], signal)).toString().trim();
+		if (!hardwareSerial || !guid || hardwareSerial.length > 200 || guid.length > 200 || expected && (expected.hardwareSerial && expected.hardwareSerial !== hardwareSerial || expected.guid !== guid)) throw new PhoneError("PHONE_WIRELESS_IDENTITY", "Phone identity changed; pair the intended device again");
+		signal?.throwIfAborted();
+		const wireless = {
+			host: endpoint.host,
+			port: endpoint.port,
+			hardwareSerial,
+			guid
+		};
+		if (this.identities.size >= 100) this.identities.delete(this.identities.keys().next().value);
+		this.identities.set(device.serial, wireless);
+		return {
+			device,
+			wireless
+		};
+	}
+	async reconnect(path, wireless, signal, endpoint) {
+		signal = AbortSignal.any([this.controller.signal, ...signal ? [signal] : []]);
+		if (endpoint) return this.connect(path, endpoint, signal, wireless);
+		const candidates = (await this.services(path, signal).catch(() => {
+			signal?.throwIfAborted();
+			return [];
+		})).filter((item) => item.kind === "connect" && (item.name === wireless.guid || item.name.startsWith(`${wireless.guid}-`)));
+		for (const item of [...candidates, wireless]) try {
+			return await this.connect(path, item, signal, wireless);
+		} catch {
+			signal?.throwIfAborted();
+		}
+		throw new PhoneError("PHONE_RECONNECT_FAILED", "Enable wireless debugging on the same network, or enter its current connection address");
+	}
+};
+//#endregion
+export { WirelessPhones, parseWirelessServices, validateWirelessHost };