@xopcai/xopc 0.0.415 → 0.0.417

package/dist/src/gateway/hono/routes/phone-setup.js

@@ -0,0 +1,231 @@
+import { resolveStateDir } from "../../../config/paths-state.js";
+import { getSessionMetadata, init_session_read_repository } from "../../../storage/sqlite/session-read-repository.js";
+import { AgentCatalogRepository, init_repository } from "../../../agent-catalog/repository.js";
+import { init_paths } from "../../../config/paths.js";
+import { resolveEffectiveAgentConfigForAgent } from "../../../config/agent-profile.js";
+import { getModelRegistry, init_model_registry } from "../../../providers/model-registry.js";
+import { init_providers, isProviderConfiguredSync } from "../../../providers/index.js";
+import { phoneAllowsApp } from "../../../phone/app-access.js";
+import { managedPhoneAdbPath } from "../../../runtime-tools/phone-dependency-catalog.js";
+import { phoneModelProfile } from "../../../phone/model-adapter.js";
+import { getPhoneRuntime } from "../../../phone/runtime.js";
+import { AgentCatalogService } from "../../../agent-catalog/service.js";
+import { PhoneSetupService } from "../../../phone/setup/service.js";
+import { PhoneDependencyManager, probePhoneAdb } from "../../../runtime-tools/phone-dependencies.js";
+import { createHash } from "node:crypto";
+import { z } from "zod";
+//#region src/gateway/hono/routes/phone-setup.ts
+init_repository();
+init_paths();
+init_model_registry();
+init_providers();
+init_session_read_repository();
+function createPhoneSetupService(service) {
+	const runtime = getPhoneRuntime();
+	const manager = () => new PhoneDependencyManager({
+		stateDir: resolveStateDir(),
+		config: service.currentConfig.runtimeTools,
+		adbPath: service.currentConfig.phone.adbPath
+	});
+	const requireIdle = () => {
+		if (runtime.reports().some((report) => ![
+			"closed",
+			"cancelled",
+			"failed",
+			"outcome_unknown"
+		].includes(report.status))) throw new Error("PHONE_SETUP_BUSY: Close active phone sessions before changing shared configuration.");
+	};
+	return new PhoneSetupService({
+		runtime,
+		models: () => getModelRegistry().getAll().filter((model) => phoneModelProfile(model)).map((model) => ({
+			ref: `${model.provider}/${model.id}`,
+			name: model.name,
+			configured: isProviderConfiguredSync(model.provider)
+		})),
+		setModel: async (agentId, ref) => {
+			requireIdle();
+			const model = getModelRegistry().resolve(ref);
+			if (!model || !phoneModelProfile(model) || !isProviderConfiguredSync(model.provider)) throw new Error("PHONE_SETUP_MODEL_REQUIRED: Choose a compatible model with configured credentials.");
+			const repository = new AgentCatalogRepository();
+			const agent = repository.get(agentId);
+			if (!agent) throw new Error("Phone setup Agent not found");
+			await new AgentCatalogService(repository).update(agentId, { models: {
+				...agent.models,
+				phoneUse: {
+					primary: ref,
+					fallbacks: []
+				}
+			} }, agent.revision);
+			service.refreshAgentCatalog();
+		},
+		configure: async (enabled) => {
+			requireIdle();
+			const config = service.currentConfig;
+			const next = structuredClone(config);
+			next.phone.enabled = enabled;
+			if (!(await service.saveConfig(next, config)).saved) throw new Error("PHONE_SETUP_CONFIG_CONFLICT");
+		},
+		install: async (kind, repair) => {
+			if (kind === "adb") requireIdle();
+			const config = service.currentConfig;
+			await manager().install(kind, { repair });
+			if (kind === "adb" && config.phone.adbPath) {
+				const path = managedPhoneAdbPath(resolveStateDir());
+				await probePhoneAdb(path);
+				const next = structuredClone(config);
+				next.phone.adbPath = path;
+				if (!(await service.saveConfig(next, config)).saved) throw new Error("PHONE_SETUP_CONFIG_CONFLICT");
+			}
+		},
+		registerLocal: async (serial, name) => {
+			const discovered = (await runtime.discover(service.currentConfig)).find((phone) => phone.serial === serial && phone.state === "device");
+			if (!discovered) throw new Error("PHONE_SETUP_DEVICE_OFFLINE: Select an online discovered local phone.");
+			if (!runtime.repository.list().some((phone) => phone.serial === serial)) runtime.repository.save({
+				serial,
+				name: name?.trim() || discovered.name,
+				enabled: true,
+				appAccess: "selected",
+				allowedApps: ["com.android.settings"]
+			});
+		},
+		revision: (context, deviceId) => {
+			const agent = resolveEffectiveAgentConfigForAgent(context.agentId).config;
+			const device = runtime.repository.list().find((device) => device.id === deviceId);
+			const model = agent.models.phoneUse?.primary ? getModelRegistry().resolve(agent.models.phoneUse.primary) : void 0;
+			return createHash("sha256").update(JSON.stringify([
+				service.currentConfig.phone,
+				agent.models.phoneUse,
+				agent.tools.phone_use,
+				agent.toolAllowlist,
+				device,
+				model && [
+					model.api,
+					model.baseUrl,
+					model.input,
+					phoneModelProfile(model)
+				]
+			])).digest("hex");
+		},
+		leaseActive: (deviceId) => {
+			const device = runtime.repository.list().find((device) => device.id === deviceId);
+			return device ? runtime.repository.leaseActive(device.serial) : false;
+		},
+		connected: async (deviceId, signal) => {
+			const device = runtime.repository.get(deviceId);
+			return (await (await runtime.driverFor(device, service.currentConfig)).discover(signal)).some((found) => found.serial === device.serial && found.state === "device");
+		},
+		inspect: async (context, source) => {
+			const config = service.currentConfig;
+			const resolved = resolveEffectiveAgentConfigForAgent(context.agentId);
+			const agent = resolved.config;
+			const ref = agent.models.phoneUse?.primary;
+			const model = ref ? getModelRegistry().resolve(ref) : void 0;
+			const dependencies = await new PhoneDependencyManager({
+				stateDir: resolveStateDir(),
+				config: config.runtimeTools,
+				adbPath: config.phone.adbPath
+			}).status();
+			let localDiscovery = [];
+			let diagnostic;
+			if (source === "local" && dependencies.some((item) => item.kind === "adb" && item.state === "ready")) try {
+				localDiscovery = (await runtime.discover(config)).map(({ serial, name, state, emulator }) => ({
+					serial,
+					name,
+					state,
+					emulator
+				}));
+			} catch {
+				diagnostic = "PHONE_SETUP_DISCOVERY_FAILED";
+			}
+			return {
+				enabled: config.phone.enabled,
+				toolAllowed: agent.tools.phone_use?.mode !== "deny" && (!agent.toolAllowlist || agent.toolAllowlist.includes("phone_use")),
+				model: {
+					ref,
+					source: resolved.sources["models.phoneUse.primary"],
+					chatRef: agent.models.chat?.primary,
+					supported: Boolean(model && phoneModelProfile(model)),
+					configured: Boolean(model && isProviderConfiguredSync(model.provider))
+				},
+				dependencies: dependencies.map(({ kind, state, version, canInstall }) => ({
+					kind,
+					state,
+					version,
+					canInstall
+				})),
+				devices: runtime.repository.list().map((device) => ({
+					id: device.id,
+					name: device.name,
+					source: device.connection ? "aliyun" : "local",
+					enabled: device.enabled,
+					settingsAllowed: phoneAllowsApp(device, "com.android.settings")
+				})),
+				localDiscovery,
+				diagnostic
+			};
+		}
+	});
+}
+/** Registered inside the existing Phone admin route group. */
+function registerPhoneSetupRoutes(app, deps) {
+	const schema = z.strictObject({
+		conversationId: z.string().uuid(),
+		setupId: z.string().uuid().optional(),
+		action: z.enum([
+			"inspect",
+			"start",
+			"get",
+			"recheck",
+			"source",
+			"begin_verification",
+			"release",
+			"cancel"
+		]),
+		source: z.enum(["local", "aliyun"]).optional(),
+		deviceId: z.string().uuid().optional(),
+		expectedRevision: z.number().int().positive().optional()
+	});
+	app.post("/api/phone/setup", deps.strictRateLimitMiddleware, async (c) => {
+		const parsed = schema.safeParse(await c.req.json().catch(() => null));
+		if (!parsed.success) return c.json({
+			ok: false,
+			error: "Invalid phone setup request"
+		}, 400);
+		const body = parsed.data;
+		const metadata = getSessionMetadata(body.conversationId);
+		if (!metadata) return c.json({
+			ok: false,
+			error: "Conversation not found"
+		}, 404);
+		const context = {
+			conversationId: body.conversationId,
+			agentId: metadata.agentId
+		};
+		const setup = deps.service.phoneSetup;
+		try {
+			let payload;
+			if (body.action === "source") {
+				if (!body.setupId || !body.source || !body.expectedRevision) throw new Error("Choose a source and refresh current progress");
+				payload = await setup.source(context, body.setupId, body.source, body.expectedRevision);
+			} else if (body.action === "begin_verification") {
+				if (!body.setupId || !body.deviceId || !body.expectedRevision) throw new Error("Select a phone and approve the current test");
+				payload = await setup.begin(context, body.setupId, body.deviceId, body.expectedRevision, c.req.raw.signal);
+			} else if (body.action === "release") {
+				if (!body.setupId) throw new Error("setupId is required");
+				payload = await setup.release(context, body.setupId);
+			} else payload = await setup.command(body.action, { setupId: body.setupId }, context);
+			c.header("Cache-Control", "no-store");
+			return c.json({
+				ok: true,
+				payload
+			});
+		} catch (error) {
+			return c.json({
+				ok: false,
+				error: error instanceof Error ? error.message : "Phone setup failed"
+			}, 409);
+		}
+	});
+}
+//#endregion
+export { createPhoneSetupService, registerPhoneSetupRoutes };

package/dist/src/gateway/hono/routes/phone-wireless.d.ts

@@ -0,0 +1,4 @@
+import type { Hono } from 'hono';
+import type { PhoneRuntime } from '../../../phone/runtime.js';
+import type { AuthenticatedRouteDeps } from './deps.js';
+export declare function registerPhoneWirelessRoutes(app: Hono, deps: AuthenticatedRouteDeps, runtime: PhoneRuntime): void;

package/dist/src/gateway/hono/routes/phone-wireless.js

@@ -0,0 +1,63 @@
+import { resolveAdbPath } from "../../../phone/adb-driver.js";
+import { validateWirelessHost } from "../../../phone/wireless.js";
+import { getGatewayPrincipal } from "../../security/gateway-principal.js";
+import { z } from "zod";
+//#region src/gateway/hono/routes/phone-wireless.ts
+const hostSchema = z.string().max(100).refine((value) => {
+	validateWirelessHost(value);
+	return true;
+});
+const endpoint = z.object({
+	host: hostSchema,
+	port: z.number().int().min(1).max(65535)
+}).strict();
+function registerPhoneWirelessRoutes(app, deps, runtime) {
+	const { service, strictRateLimitMiddleware } = deps;
+	const path = () => resolveAdbPath(service.currentConfig.phone.adbPath);
+	app.use("/api/phone/wireless/*", async (c, next) => {
+		c.header("Cache-Control", "no-store");
+		await next();
+	});
+	app.get("/api/phone/wireless/discovery", async (c) => c.json({
+		ok: true,
+		payload: await runtime.wireless.discovery(path(), c.req.raw.signal)
+	}));
+	app.post("/api/phone/wireless/pairings", strictRateLimitMiddleware, async (c) => {
+		const input = z.discriminatedUnion("method", [z.object({ method: z.literal("qr") }).strict(), z.object({
+			method: z.literal("code"),
+			host: hostSchema,
+			pairingPort: z.number().int().min(1).max(65535),
+			code: z.string().regex(/^\d{6}$/),
+			connectPort: z.number().int().min(1).max(65535).optional()
+		}).strict()]).parse(await c.req.json());
+		return c.json({
+			ok: true,
+			payload: runtime.wireless.create(getGatewayPrincipal(c).principalId, path(), input.method === "code" ? input : void 0)
+		}, 201);
+	});
+	app.get("/api/phone/wireless/pairings/:id", (c) => c.json({
+		ok: true,
+		payload: runtime.wireless.get(getGatewayPrincipal(c).principalId, z.string().uuid().parse(c.req.param("id")))
+	}));
+	app.delete("/api/phone/wireless/pairings/:id", (c) => {
+		runtime.wireless.cancel(getGatewayPrincipal(c).principalId, z.string().uuid().parse(c.req.param("id")));
+		return c.json({ ok: true });
+	});
+	app.post("/api/phone/wireless/connect", strictRateLimitMiddleware, async (c) => {
+		const input = endpoint.parse(await c.req.json());
+		return c.json({
+			ok: true,
+			payload: (await runtime.wireless.connect(path(), input, c.req.raw.signal)).device
+		});
+	});
+	app.post("/api/phone/devices/:id/reconnect", strictRateLimitMiddleware, async (c) => {
+		const input = z.union([endpoint, z.object({}).strict().transform(() => void 0)]).parse(await c.req.json());
+		c.header("Cache-Control", "no-store");
+		return c.json({
+			ok: true,
+			payload: await runtime.reconnectWireless(c.req.param("id"), service.currentConfig, c.req.raw.signal, input)
+		});
+	});
+}
+//#endregion
+export { registerPhoneWirelessRoutes };

package/dist/src/gateway/hono/routes/phone.js

@@ -1,13 +1,17 @@
 import { createLogger } from "../../../utils/logger/index.js";
 import { init_logger } from "../../../utils/logger.js";
-import { MOCK_PHONE_MODEL, PhoneActionSchema, PhoneConfigSchema, PhoneDeviceSchema, PhoneError, PhoneInputSchema, init_contracts } from "../../../phone/contracts.js";
+import { MOCK_PHONE_MODEL, PhoneActionSchema, PhoneConfigSchema, PhoneDeviceSchema, PhoneError, PhoneExecutionModeSchema, PhoneInputSchema, init_contracts } from "../../../phone/contracts.js";
+import { createConversation, init_conversation_repository } from "../../../storage/sqlite/conversation-repository.js";
 import { getDefaultAgentId, init_resolve_route } from "../../../routing/resolve-route.js";
 import { getModelRegistry, init_model_registry } from "../../../providers/model-registry.js";
 import { init_providers, isProviderConfiguredSync } from "../../../providers/index.js";
 import { normalizePhoneAppAccess, phoneAppAccess } from "../../../phone/app-access.js";
+import { resolveAdbPath } from "../../../phone/adb-driver.js";
 import { createPhoneModel, phoneModelProfile } from "../../../phone/model-adapter.js";
 import { getPhoneRuntime, phoneExecutionContext } from "../../../phone/runtime.js";
+import { registerPhoneSetupRoutes } from "./phone-setup.js";
 import { getGatewayPrincipal } from "../../security/gateway-principal.js";
+import { registerPhoneWirelessRoutes } from "./phone-wireless.js";
 import { randomUUID } from "node:crypto";
 import { z } from "zod";
 import { Hono } from "hono";
@@ -18,12 +22,14 @@ init_model_registry();
 init_providers();
 init_contracts();
 init_logger();
+init_conversation_repository();
 const log = createLogger("Hono:Phone");
 const deviceInput = PhoneDeviceSchema.omit({
 	id: true,
 	createdAt: true,
 	revision: true,
-	connection: true
+	connection: true,
+	wireless: true
 });
 function registerPhoneRoutes(parent, deps, runtime = getPhoneRuntime()) {
 	const app = new Hono();
@@ -37,6 +43,7 @@ function registerPhoneRoutes(parent, deps, runtime = getPhoneRuntime()) {
 			ok: false,
 			error: {
 				code,
+				...error instanceof PhoneError ? error.details : {},
 				message: error instanceof PhoneError ? error.message : error instanceof z.ZodError ? "Invalid phone request" : "Phone operation failed. Check device diagnostics."
 			}
 		}, error instanceof PhoneError ? error.status : error instanceof z.ZodError ? 400 : 500);
@@ -53,6 +60,53 @@ function registerPhoneRoutes(parent, deps, runtime = getPhoneRuntime()) {
 		}, 403);
 		return next();
 	});
+	registerPhoneSetupRoutes(app, deps);
+	registerPhoneWirelessRoutes(app, deps, runtime);
+	app.get("/api/phone/connections", async (c) => {
+		c.header("Cache-Control", "no-store");
+		const payload = await Promise.all(runtime.reports().filter((report) => report.status !== "closed").map(async (report) => {
+			const source = report.sourceConversationId ?? report.owner;
+			const conversation = /^[\da-f]{8}-[\da-f-]{27}$/i.test(source) ? await service.sessions.getSession(source) : void 0;
+			const { facts: _facts, readings: _readings, steps: _steps, task: _task, feedback: _feedback, ...metadata } = report;
+			return {
+				...metadata,
+				sourceConversationName: conversation?.name
+			};
+		}));
+		return c.json({
+			ok: true,
+			payload
+		});
+	});
+	app.post("/api/phone/devices/:id/disconnect", strictRateLimitMiddleware, async (c) => {
+		await runtime.stopDevice(z.string().uuid().parse(c.req.param("id")));
+		return c.json({ ok: true });
+	});
+	app.post("/api/phone/devices/:id/view", strictRateLimitMiddleware, async (c) => {
+		const id = z.string().uuid().parse(c.req.param("id"));
+		await runtime.viewDevice(id, service.currentConfig, getDefaultAgentId(), c.req.raw.signal);
+		c.header("Cache-Control", "no-store");
+		return c.json({ ok: true });
+	});
+	app.post("/api/phone/devices/:id/conversations", strictRateLimitMiddleware, async (c) => {
+		const device = runtime.repository.get(z.string().uuid().parse(c.req.param("id")));
+		if (!device.enabled) throw new PhoneError("PHONE_DEVICE_DENIED", "This phone is disabled", 403);
+		const conversation = createConversation({
+			agentId: getDefaultAgentId(),
+			sourceChannel: "webchat",
+			sourceChatId: "webchat",
+			name: device.name,
+			customData: { phoneDeviceId: device.id }
+		});
+		c.header("Cache-Control", "no-store");
+		return c.json({
+			ok: true,
+			payload: {
+				conversationId: conversation.key,
+				deviceId: device.id
+			}
+		}, 201);
+	});
 	app.use("/api/phone/cloud/aliyun/*", bodyLimit({
 		maxSize: 24 * 1024,
 		onError: (c) => c.json({
@@ -103,10 +157,11 @@ function registerPhoneRoutes(parent, deps, runtime = getPhoneRuntime()) {
 	}));
 	app.patch("/api/phone/settings", strictRateLimitMiddleware, async (c) => {
 		const config = PhoneConfigSchema.parse(await c.req.json());
-		await runtime.shutdown();
+		if (!config.enabled || config.adbPath !== service.currentConfig.phone.adbPath) await runtime.shutdown();
 		const next = structuredClone(service.currentConfig);
 		next.phone = config;
 		if (!(await service.saveConfig(next)).saved) throw new PhoneError("PHONE_CONFIG_SAVE_FAILED", "Unable to save Phone Use settings");
+		runtime.updateConnectionPolicy(next);
 		return c.json({
 			ok: true,
 			payload: { config }
@@ -158,7 +213,12 @@ function registerPhoneRoutes(parent, deps, runtime = getPhoneRuntime()) {
 	app.post("/api/phone/devices", strictRateLimitMiddleware, async (c) => {
 		const input = deviceInput.parse(await c.req.json());
 		if (!(await runtime.discover(service.currentConfig, c.req.raw.signal)).some((device) => device.serial === input.serial && device.state === "device")) throw new PhoneError("PHONE_DEVICE_OFFLINE", "Choose a connected and authorized ADB device");
-		const device = runtime.repository.save(input);
+		const wireless = runtime.wireless.known(input.serial);
+		if (wireless) input.serial = (await runtime.wireless.connect(resolveAdbPath(service.currentConfig.phone.adbPath), wireless, c.req.raw.signal, wireless)).device.serial;
+		const device = runtime.repository.save({
+			...input,
+			...wireless ? { wireless } : {}
+		});
 		if (!runtime.repository.defaultDevice()) runtime.repository.setDefault(device.id);
 		return c.json({
 			ok: true,
@@ -217,13 +277,7 @@ function registerPhoneRoutes(parent, deps, runtime = getPhoneRuntime()) {
 	});
 	app.get("/api/phone/models", (c) => c.json({
 		ok: true,
-		payload: { models: [{
-			id: MOCK_PHONE_MODEL,
-			name: "Mock · Android Settings test",
-			profile: "mock-settings-about",
-			mock: true,
-			configured: true
-		}, ...getModelRegistry().getAll().flatMap((model) => {
+		payload: { models: [...getModelRegistry().getAll().flatMap((model) => {
 			const profile = phoneModelProfile(model);
 			return profile ? [{
 				id: `${model.provider}/${model.id}`,
@@ -293,6 +347,18 @@ function registerPhoneRoutes(parent, deps, runtime = getPhoneRuntime()) {
 		action: PhoneActionSchema.optional()
 	}).strict();
 	async function conversationPhone(conversationId, requestedSessionId) {
+		if (conversationId.startsWith("device:")) {
+			const deviceId = z.string().uuid().parse(conversationId.slice(7));
+			const report = runtime.reports().find((report) => report.deviceId === deviceId && report.status !== "closed");
+			if (!report || requestedSessionId && report.sessionId !== requestedSessionId) throw new PhoneError("PHONE_SESSION_NOT_FOUND", "Phone connection changed. Refresh the phone panel.", 404);
+			const conversation = /^[\da-f]{8}-[\da-f-]{27}$/i.test(report.owner) ? await service.sessions.getSession(report.owner) : void 0;
+			return {
+				owner: report.owner,
+				report,
+				transcriptId: conversation?.transcriptId,
+				context: runtime.deviceContext(deviceId, service.currentConfig)
+			};
+		}
 		z.string().uuid().parse(conversationId);
 		const conversation = await service.sessions.getSession(conversationId);
 		if (!conversation) throw new PhoneError("PHONE_CONVERSATION_NOT_FOUND", "Conversation not found", 404);
@@ -300,25 +366,45 @@ function registerPhoneRoutes(parent, deps, runtime = getPhoneRuntime()) {
 		if (requestedSessionId && report?.sessionId !== requestedSessionId) throw new PhoneError("PHONE_SESSION_NOT_FOUND", "Phone session not found", 404);
 		if (report && report.agentId !== conversation.agentId) throw new PhoneError("PHONE_ACCESS_CHANGED", "Conversation Agent changed", 403);
 		return {
+			owner: conversationId,
 			report,
 			transcriptId: conversation.transcriptId,
 			context: phoneExecutionContext(service.currentConfig, conversation.agentId)
 		};
 	}
 	app.get("/api/phone/conversations/:conversationId", async (c) => {
-		const owner = c.req.param("conversationId");
+		let owner = c.req.param("conversationId");
 		const client = liveClient.parse(c.req.query("clientId"));
-		const { report, context } = await conversationPhone(owner);
+		const { report, context, owner: resolvedOwner } = await conversationPhone(owner);
+		owner = resolvedOwner;
+		c.header("Cache-Control", "no-store");
+		return c.json({
+			ok: true,
+			payload: report ? runtime.liveStatus(owner, report.sessionId, context, `${getGatewayPrincipal(c).principalId}:${client}${c.req.param("conversationId").startsWith("device:") ? ":viewer" : ""}`) : null
+		});
+	});
+	app.post("/api/phone/conversations/:conversationId/:sessionId/execution-mode", strictRateLimitMiddleware, async (c) => {
+		const address = c.req.param("conversationId");
+		if (address.startsWith("device:")) throw new PhoneError("PHONE_OBSERVE_ONLY", "Change execution mode from the source conversation", 403);
+		const { owner, context } = await conversationPhone(address, c.req.param("sessionId"));
+		const input = z.object({
+			executionMode: PhoneExecutionModeSchema,
+			applyCurrent: z.boolean().default(false),
+			epoch: z.number().int().positive(),
+			clientId: liveClient
+		}).strict().parse(await c.req.json());
+		await runtime.setExecutionMode(owner, input.executionMode, context, input.applyCurrent, input.epoch);
 		c.header("Cache-Control", "no-store");
 		return c.json({
 			ok: true,
-			payload: report ? runtime.liveStatus(owner, report.sessionId, context, `${getGatewayPrincipal(c).principalId}:${client}`) : null
+			payload: runtime.liveStatus(owner, c.req.param("sessionId"), context, `${getGatewayPrincipal(c).principalId}:${input.clientId}`)
 		});
 	});
 	app.get("/api/phone/conversations/:conversationId/:sessionId/frame", async (c) => {
-		const owner = c.req.param("conversationId");
+		let owner = c.req.param("conversationId");
 		const id = c.req.param("sessionId");
-		const { context } = await conversationPhone(owner, id);
+		const { context, owner: resolvedOwner } = await conversationPhone(owner, id);
+		owner = resolvedOwner;
 		const frame = await runtime.liveFrame(owner, id, context, c.req.raw.signal);
 		c.header("Cache-Control", "no-store");
 		c.header("Content-Type", "image/png");
@@ -333,15 +419,15 @@ function registerPhoneRoutes(parent, deps, runtime = getPhoneRuntime()) {
 		return c.body(bytes);
 	});
 	app.post("/api/phone/conversations/:conversationId/:sessionId/video-ticket", strictRateLimitMiddleware, async (c) => {
-		const owner = c.req.param("conversationId");
+		const address = c.req.param("conversationId");
 		const id = c.req.param("sessionId");
 		const { clientId } = z.object({ clientId: liveClient }).strict().parse(await c.req.json());
-		await conversationPhone(owner, id);
+		await conversationPhone(address, id);
 		const principal = getGatewayPrincipal(c);
-		const client = `${principal.principalId}:${clientId}`;
+		const client = `${principal.principalId}:${clientId}${c.req.param("conversationId").startsWith("device:") ? ":viewer" : ""}`;
 		const validate = async () => {
-			const { context } = await conversationPhone(owner, id);
-			runtime.liveStatus(owner, id, context, client);
+			const resolved = await conversationPhone(address, id);
+			runtime.liveStatus(resolved.owner, id, resolved.context, client);
 		};
 		const issued = service.phoneStreams.issue({
 			origin: new URL(c.req.url).origin,
@@ -349,10 +435,13 @@ function registerPhoneRoutes(parent, deps, runtime = getPhoneRuntime()) {
 			client,
 			validate,
 			connect: async () => {
-				const { context } = await conversationPhone(owner, id);
-				return runtime.liveVideo(owner, id, context);
+				const resolved = await conversationPhone(address, id);
+				return runtime.liveVideo(resolved.owner, id, resolved.context);
 			},
-			disconnect: () => runtime.disconnectVideo(owner, id, client)
+			disconnect: async () => {
+				const resolved = await conversationPhone(address, id).catch(() => void 0);
+				if (resolved) await runtime.disconnectVideo(resolved.owner, id, client);
+			}
 		});
 		c.header("Cache-Control", "no-store");
 		return c.json({
@@ -365,18 +454,20 @@ function registerPhoneRoutes(parent, deps, runtime = getPhoneRuntime()) {
 		});
 	});
 	app.post("/api/phone/conversations/:conversationId/:sessionId/control", async (c) => {
-		const owner = c.req.param("conversationId");
+		if (c.req.param("conversationId").startsWith("device:")) throw new PhoneError("PHONE_OBSERVE_ONLY", "The global phone viewer is read only. Use the controlling conversation for input.", 403);
+		let owner = c.req.param("conversationId");
 		const id = c.req.param("sessionId");
-		const { context, transcriptId } = await conversationPhone(owner, id);
+		const { context, transcriptId, owner: resolvedOwner } = await conversationPhone(owner, id);
+		owner = resolvedOwner;
 		const { clientId, ...input } = liveControlInput.parse(await c.req.json());
 		const result = await runtime.liveControl(owner, id, context, `${getGatewayPrincipal(c).principalId}:${clientId}`, input);
-		if (input.op === "handback" && result.resumeTurnRequired && !service.sessions.getActiveRun(owner).active) {
+		if (transcriptId && input.op === "handback" && result.resumeTurnRequired && !service.sessions.getActiveRun(owner).active) {
 			if (!(await service.submitSessionInput({
 				conversationId: owner,
 				expectedTranscriptId: transcriptId,
 				clientMessageId: input.operationId,
 				delivery: "next",
-				content: "手机已交还，请先确认当前页面，继续未完成的任务；已完成的步骤不要重复，结束后关闭手机会话。",
+				content: "手机已交还，请先确认当前页面，继续未完成的任务；已完成的步骤不要重复，结束后释放操作权，保持手机连接。",
 				origin: {
 					type: "system",
 					source: "internal"

package/dist/src/gateway/hono/routes/projects.js

@@ -3,15 +3,15 @@ import { init_src } from "../../../../packages/gateway-contract/src/index.js";
 import { TaskRepository } from "../../../tasks/task-repository.js";
 import { getSessionMetadata } from "../../../storage/sqlite/session-read-repository.js";
 import { loadTranscriptRowsForSession } from "../../../storage/sqlite/transcript-repository.js";
-import { init_sqlite } from "../../../storage/sqlite/index.js";
+import "../../../storage/sqlite/index.js";
 import { ActivityService } from "../../../activity/service.js";
 import "../../../activity/index.js";
-import { CapabilityError } from "../../../capabilities/runtime/errors.js";
-import "../../../capabilities/runtime/dispatcher.js";
 import { listKnowledgeItems, writeKnowledgeItem } from "../../../knowledge-memory/repository.js";
 import "../../../knowledge-memory/index.js";
 import { resolveEffectiveAgentProfile } from "../../../config/agent-profile.js";
 import { TaskReadModelProjector } from "../../../tasks/task-read-model-projector.js";
+import { CapabilityError } from "../../../capabilities/runtime/errors.js";
+import "../../../capabilities/runtime/dispatcher.js";
 import { ProjectWorkspaceConflictError, ProjectWorkspaceMissingError } from "../../../projects/workspace-project.js";
 import { inferProjectExecutionMode, inferProjectKind } from "../../../projects/project-kind.js";
 import { ProjectDeletionBlockedError, ProjectWorkspaceInUseError } from "../../../projects/project-service.js";
@@ -29,7 +29,6 @@ import { capabilityHttpContext, capabilityHttpError } from "../../../capabilitie
 import { randomUUID } from "node:crypto";
 //#region src/gateway/hono/routes/projects.ts
 init_src();
-init_sqlite();
 function projectWriteError(c, error) {
 	const cause = error instanceof CapabilityError ? error.cause : error;
 	if (cause instanceof ProjectWorkspaceConflictError) return c.json({

package/dist/src/gateway/hono/routes/public-gateway.js

@@ -1,15 +1,16 @@
 import { PACKAGE_VERSION, init_package_version } from "../../../package-version.js";
 import { claimConnectorWebhookDelivery, completeConnectorWebhookDelivery, releaseConnectorWebhookDelivery } from "../../../storage/sqlite/connector-repository.js";
-import { init_sqlite } from "../../../storage/sqlite/index.js";
+import "../../../storage/sqlite/index.js";
 import { resolveAutomationWebhookSecret } from "../../../automations/webhook-secrets.js";
-import { appendComposioTriggerEvent, applyComposioConnectionLifecycleEvent, normalizeComposioTriggerPayload, verifyComposioWebhook } from "../../../connectors/composio-triggers.js";
 import { composioLogoResponse } from "../../../connectors/composio-logo.js";
+import { appendComposioTriggerEvent, applyComposioConnectionLifecycleEvent, normalizeComposioTriggerPayload, verifyComposioWebhook } from "../../../connectors/composio-triggers.js";
 import { serveStaticFile } from "../lib/static-ui.js";
 import { createHash, timingSafeEqual } from "node:crypto";
 //#region src/gateway/hono/routes/public-gateway.ts
 init_package_version();
-init_sqlite();
 const PUBLIC_UI_ROOT_ASSETS = [
+	"browser-setup-test.html",
+	"browser-setup-test.js",
 	"apple-touch-icon.png",
 	"favicon-16x16.png",
 	"favicon-32x32.png",

package/dist/src/gateway/hono/routes/session-input-handler.js

@@ -5,9 +5,9 @@ import { endpointContextSchema } from "../../../../packages/gateway-contract/src
 import { parseUserTurnDocument, userTurnDocumentRefIds } from "../../../../packages/gateway-contract/src/user-turn-document.js";
 import { init_src } from "../../../../packages/gateway-contract/src/index.js";
 import { endpointTurnClaimSchema, init_src as init_src$1 } from "../../../../packages/endpoint-tools-protocol/src/index.js";
+import { init_providers, resolveModel } from "../../../providers/index.js";
 import { CapabilityError } from "../../../capabilities/runtime/errors.js";
 import "../../../capabilities/runtime/dispatcher.js";
-import { init_providers, resolveModel } from "../../../providers/index.js";
 import { getModelThinking } from "../../../providers/model-thinking.js";
 import { parseTurnContextRefs } from "../../../agent/source-context/types.js";
 import { validateWebchatAttachments, validateWebchatContent } from "../../chat-limits.js";

package/dist/src/gateway/hono/routes/sessions.js

@@ -1,8 +1,8 @@
-import { deleteBrowserTabBinding, init_browser_tab_binding_repository } from "../../../storage/sqlite/browser-tab-binding-repository.js";
+import { deleteBrowserTabBinding } from "../../../storage/sqlite/browser-tab-binding-repository.js";
 import { SessionDiscoveryQuerySchema } from "../../../../packages/gateway-contract/src/session-identity.js";
 import { init_src } from "../../../../packages/gateway-contract/src/index.js";
 import "../../../session/types.js";
-import { SidebarLayoutConflictError, getSidebarLayout, init_sidebar_layout_repository, replaceSidebarLayout, sortBySidebarLayout } from "../../../storage/sqlite/sidebar-layout-repository.js";
+import { SidebarLayoutConflictError, getSidebarLayout, replaceSidebarLayout, sortBySidebarLayout } from "../../../storage/sqlite/sidebar-layout-repository.js";
 import { summarizeAiUsageByConversations } from "../../../storage/sqlite/ai-usage-repository.js";
 import { isPersonalConversation } from "../../../personal-agent/repository.js";
 import { messagesToClientHistory } from "../../../session/client-history.js";
@@ -18,8 +18,6 @@ import { listSidebarTaskGroups } from "../../../tasks/task-sidebar-hierarchy.js"
 import { createHash } from "node:crypto";
 //#region src/gateway/hono/routes/sessions.ts
 init_src();
-init_browser_tab_binding_repository();
-init_sidebar_layout_repository();
 const log = createGatewayRouteLogger("Sessions");
 const SESSION_TYPES = new Set([
 	"chat",