@xopcai/xopc 0.0.412 → 0.0.414

package/dist/src/config/models-json.d.ts

@@ -372,6 +372,12 @@ export declare const CustomModelSchema: z.ZodObject<{
             "openai-responses-computer-v1": "openai-responses-computer-v1";
         }>;
     }, z.core.$strict>>;
+    phoneUse: z.ZodOptional<z.ZodObject<{
+        profile: z.ZodEnum<{
+            "autoglm-phone-v1": "autoglm-phone-v1";
+            "structured-phone-v1": "structured-phone-v1";
+        }>;
+    }, z.core.$strict>>;
     id: z.ZodString;
     name: z.ZodOptional<z.ZodString>;
     api: z.ZodOptional<z.ZodEnum<{
@@ -454,6 +460,12 @@ export declare const ModelOverrideSchema: z.ZodObject<{
             "openai-responses-computer-v1": "openai-responses-computer-v1";
         }>;
     }, z.core.$strict>>;
+    phoneUse: z.ZodOptional<z.ZodObject<{
+        profile: z.ZodEnum<{
+            "autoglm-phone-v1": "autoglm-phone-v1";
+            "structured-phone-v1": "structured-phone-v1";
+        }>;
+    }, z.core.$strict>>;
     name: z.ZodOptional<z.ZodString>;
     reasoning: z.ZodOptional<z.ZodBoolean>;
     thinkingLevelMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
@@ -540,6 +552,12 @@ export declare const ProviderConfigSchema: z.ZodObject<{
                 "openai-responses-computer-v1": "openai-responses-computer-v1";
             }>;
         }, z.core.$strict>>;
+        phoneUse: z.ZodOptional<z.ZodObject<{
+            profile: z.ZodEnum<{
+                "autoglm-phone-v1": "autoglm-phone-v1";
+                "structured-phone-v1": "structured-phone-v1";
+            }>;
+        }, z.core.$strict>>;
         id: z.ZodString;
         name: z.ZodOptional<z.ZodString>;
         api: z.ZodOptional<z.ZodEnum<{
@@ -622,6 +640,12 @@ export declare const ProviderConfigSchema: z.ZodObject<{
                 "openai-responses-computer-v1": "openai-responses-computer-v1";
             }>;
         }, z.core.$strict>>;
+        phoneUse: z.ZodOptional<z.ZodObject<{
+            profile: z.ZodEnum<{
+                "autoglm-phone-v1": "autoglm-phone-v1";
+                "structured-phone-v1": "structured-phone-v1";
+            }>;
+        }, z.core.$strict>>;
         name: z.ZodOptional<z.ZodString>;
         reasoning: z.ZodOptional<z.ZodBoolean>;
         thinkingLevelMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
@@ -823,6 +847,12 @@ export declare const ModelsJsonSchema: z.ZodObject<{
                     "openai-responses-computer-v1": "openai-responses-computer-v1";
                 }>;
             }, z.core.$strict>>;
+            phoneUse: z.ZodOptional<z.ZodObject<{
+                profile: z.ZodEnum<{
+                    "autoglm-phone-v1": "autoglm-phone-v1";
+                    "structured-phone-v1": "structured-phone-v1";
+                }>;
+            }, z.core.$strict>>;
             id: z.ZodString;
             name: z.ZodOptional<z.ZodString>;
             api: z.ZodOptional<z.ZodEnum<{
@@ -905,6 +935,12 @@ export declare const ModelsJsonSchema: z.ZodObject<{
                     "openai-responses-computer-v1": "openai-responses-computer-v1";
                 }>;
             }, z.core.$strict>>;
+            phoneUse: z.ZodOptional<z.ZodObject<{
+                profile: z.ZodEnum<{
+                    "autoglm-phone-v1": "autoglm-phone-v1";
+                    "structured-phone-v1": "structured-phone-v1";
+                }>;
+            }, z.core.$strict>>;
             name: z.ZodOptional<z.ZodString>;
             reasoning: z.ZodOptional<z.ZodBoolean>;
             thinkingLevelMap: z.ZodOptional<z.ZodRecord<z.ZodEnum<{

package/dist/src/config/models-json.js

@@ -1,6 +1,7 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { init_write_file_atomic, writeTextAtomicSync } from "../infra/write-file-atomic.js";
 import { init_paths, resolveModelsJsonPath } from "./paths.js";
+import { PhoneModelMetadataSchema, init_contracts } from "../phone/contracts.js";
 import { ComputerProfileSchema, init_src } from "../../packages/computer-control-contract/src/index.js";
 import { init_model_policy, isComputerModel } from "../computer/model-policy.js";
 import { assertCurrentModelProvider, init_provider_policy } from "../providers/provider-policy.js";
@@ -124,6 +125,11 @@ function validateModelsConfig(config) {
 		});
 		if (providerConfig.models) for (let i = 0; i < providerConfig.models.length; i++) {
 			const model = providerConfig.models[i];
+			if (model.phoneUse && (!model.input?.includes("image") || (model.api ?? providerConfig.api) !== "openai-completions")) errors.push({
+				path: `providers.${providerName}.models[${i}].phoneUse`,
+				message: "Phone Use requires image input and OpenAI Chat Completions",
+				severity: "error"
+			});
 			if (model.computerUse && !isComputerModel({
 				...model,
 				api: model.api ?? providerConfig.api
@@ -237,6 +243,7 @@ function modelsJsonExists(path = resolveModelsJsonPath()) {
 }
 var OpenRouterRoutingSchema, VercelGatewayRoutingSchema, OpenAICompletionsCompatSchema, OpenAIResponsesCompatSchema, OpenAICompatSchema, ImageGenerationResolutionSchema, ImageGenerationQualitySchema, ImageGenerationOutputFormatSchema, ImageGenerationBackgroundSchema, ImageGeometrySchema, ImageGenerationCapabilitiesSchema, ImageGenerationModelSchema, ImageGenerationProviderSchema, CustomModelSchema, ModelOverrideSchema, ProviderConfigSchema, ModelsJsonSchema, PROVIDER_ID_REGEX, RESERVED_PROVIDER_IDS;
 var init_models_json = __esmMin((() => {
+	init_contracts();
 	init_src();
 	init_write_file_atomic();
 	init_paths();
@@ -374,6 +381,7 @@ var init_models_json = __esmMin((() => {
 	CustomModelSchema = z.object({
 		supportsTools: z.boolean().optional(),
 		computerUse: z.object({ profile: ComputerProfileSchema }).strict().optional(),
+		phoneUse: PhoneModelMetadataSchema.optional(),
 		id: z.string().min(1),
 		name: z.string().min(1).optional(),
 		api: z.enum([
@@ -411,6 +419,7 @@ var init_models_json = __esmMin((() => {
 	ModelOverrideSchema = z.object({
 		supportsTools: z.boolean().optional(),
 		computerUse: z.object({ profile: ComputerProfileSchema }).strict().optional(),
+		phoneUse: PhoneModelMetadataSchema.optional(),
 		name: z.string().min(1).optional(),
 		reasoning: z.boolean().optional(),
 		thinkingLevelMap: z.partialRecord(z.enum([

package/dist/src/config/schema.d.ts

@@ -49,6 +49,10 @@ export declare const AgentModelsSchema: z.ZodObject<{
         primary: z.ZodString;
         fallbacks: z.ZodDefault<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>>;
+    phoneUse: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        primary: z.ZodString;
+        fallbacks: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>>;
     imageGeneration: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         primary: z.ZodString;
         fallbacks: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -1774,6 +1778,14 @@ export declare const ConfigSchema: z.ZodDefault<z.ZodObject<{
         maxSessionDurationMs: z.ZodDefault<z.ZodNumber>;
         idleGrantTtlMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
+    phone: z.ZodPrefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        adbPath: z.ZodOptional<z.ZodString>;
+        maxActionsPerSession: z.ZodDefault<z.ZodNumber>;
+        maxModelRequests: z.ZodDefault<z.ZodNumber>;
+        maxOperationDurationMs: z.ZodDefault<z.ZodNumber>;
+        maxSessionDurationMs: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
     tunnel: z.ZodOptional<z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         brokerUrl: z.ZodDefault<z.ZodString>;

package/dist/src/config/schema.js

@@ -3,13 +3,14 @@ import { AgentModelsOverrideSchema, ImageGenerationRouteSchema, ModelRouteSchema
 import { resolveEffectiveAgentConfig } from "../agent-config/resolver.js";
 import { init_agent_config } from "../agent-config/index.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
+import { PhoneConfigSchema, init_contracts } from "../phone/contracts.js";
 import { getModelUsageOrigin, init_model_usage } from "../providers/model-usage.js";
 import { TracingConfigSchema, init_config } from "../observability/config.js";
 import { OutboundProxySchema, init_outbound_proxy } from "./outbound-proxy.js";
 import { ComputerConfigSchema, init_config as init_config$1 } from "../computer/config.js";
 import { DEFAULT_CONTEXT_COMPACTION_POLICY, UserContextConfigSchema, init_config as init_config$2 } from "../user-context/config.js";
 import { init_public_url, validatePublicUrl } from "./public-url.js";
-import { PlatformConfigSchema, init_contracts } from "../platform/contracts.js";
+import { PlatformConfigSchema, init_contracts as init_contracts$1 } from "../platform/contracts.js";
 import { deepseekSearchEndpoint, init_deepseek_protocol } from "../agent/tools/search/providers/deepseek-protocol.js";
 import { TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema, init_config_schema } from "../../extensions/telegram/src/config-schema.js";
 import { WeixinAccountConfigSchema, WeixinConfigSchema, init_config_schema as init_config_schema$1 } from "../../extensions/weixin/src/config-schema.js";
@@ -52,6 +53,7 @@ function parseModelRef(ref) {
 }
 var AgentModelRefSchema, AgentImageGenerationModelSchema, AgentModelsSchema, BrowserDriverSchema, BrowserHostnameSchema, BrowserConfigSchema, SessionDmScopeSchema, SessionStorageConfigSchema, SessionResetModeSchema, SessionResetConfigSchema, SessionResetByTypeSchema, SessionScopeSchema, SessionConfigSchema, ChannelsConfigSchema, SearchProviderEntrySchema, WebSearchConfigSchema, WebsiteBlocklistSchema, WebToolsConfigSchema, ToolsConfigSchema, RuntimePreferenceSchema, RuntimeProvisionSchema, RuntimeVersionRequestSchema, LanguageRuntimeSchema, DEFAULT_RUNTIME_TOOLS_CONFIG, RuntimeToolsConfigSchema, GatewayAuthRateLimitSchema, GatewaySecuritySchema, GatewayTrustedProxySchema, GatewayAuthSchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayRemoteSchema, GatewayTlsSchema, GatewayModeSchema, GatewayChannelConnectDeferModeSchema, TunnelConsentSchema, TunnelBrokerUrlSchema, TunnelConfigSchema, WorkspaceImportConfigSchema, WorkspaceConfigSchema, GatewayBindModeSchema, GatewayWebchatConfigSchema, GatewayConfigSchema, ModelsDevConfigSchema, ModelCatalogConfigSchema, SttProviderConfigCatchallSchema, STTProviderConfigSchema, STTFallbackConfigSchema, MediaUnderstandingCapabilitiesSchema, MediaUnderstandingModelSchema, STTConfigSchema, TtsProviderConfigCatchallSchema, TTSProviderConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSEdgeConfigSchema, TTSSummarizationConfigSchema, TTSConfigSchema, VoiceRefinementConfigSchema, VoiceConfigSchema, MessagesConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, ProviderAzureConfigSchema, ProviderRequestOverridesSchema, ProviderAuthConfigSchema, ProvidersConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, UpdateAutoConfigSchema, UpdateConfigSchema, CommandsConfigSchema, McpHttpUrlSchema, ConnectorSecretReferenceSchema, McpConfigScalarSchema, McpExposureSchema, McpOAuthConfigSchema, McpServerSchema, McpConfigSchema, ConnectorsConfigSchema, ExperimentalConfigSchema, ConfigSchema;
 var init_schema = __esmMin((() => {
+	init_contracts();
 	init_model_usage();
 	init_config();
 	init_outbound_proxy();
@@ -60,7 +62,7 @@ var init_schema = __esmMin((() => {
 	init_repository();
 	init_config$2();
 	init_public_url();
-	init_contracts();
+	init_contracts$1();
 	init_deepseek_protocol();
 	init_config_schema();
 	init_config_schema$1();
@@ -1019,6 +1021,7 @@ workDiscoveryOnboarding: z.boolean().default(true) }).strict().default({ workDis
 		gateway: GatewayConfigSchema,
 		browser: BrowserConfigSchema,
 		computer: ComputerConfigSchema,
+		phone: PhoneConfigSchema,
 		tunnel: TunnelConfigSchema.optional(),
 		workspace: WorkspaceConfigSchema,
 		tools: ToolsConfigSchema,
@@ -1126,6 +1129,7 @@ workDiscoveryOnboarding: z.boolean().default(true) }).strict().default({ workDis
 			skillsStoreBaseUrl: "https://store.xopc.ai"
 		},
 		computer: ComputerConfigSchema.parse({}),
+		phone: PhoneConfigSchema.parse({}),
 		browser: {
 			enabled: true,
 			driver: { kind: "extension" },

package/dist/src/extensions/update.js

@@ -4,8 +4,8 @@ import { init_paths, resolveBundledExtensionsDir, resolveExtensionsDir } from ".
 import { computeExtensionDirectoryIntegrity, getExtensionLockfileManager } from "./lockfile.js";
 import { downloadExtensionStoreZipBuffer, resolveExtensionZipDownloadUrl, resolveExtensionsStoreBaseUrl, verifyStoreArtifactSha256 } from "../agent/skills/marketplace/adapters/store/store-api-client.js";
 import { loadConfig } from "../config/loader.js";
-import { commitStagedExtensionInstall, finalizeStagedExtensionInstall, rollbackStagedExtensionInstall, stageExtensionNpm, stageExtensionStoreZip } from "./install-transaction.js";
 import { findExtension } from "./marketplace.js";
+import { commitStagedExtensionInstall, finalizeStagedExtensionInstall, rollbackStagedExtensionInstall, stageExtensionNpm, stageExtensionStoreZip } from "./install-transaction.js";
 import { join } from "node:path";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { createHash } from "node:crypto";

package/dist/src/gateway/agent-builtin-tools.d.ts

@@ -7,6 +7,12 @@ export type GatewayBuiltinToolSummary = {
 };
 /** Built-in agent tools exposed by the gateway configuration UI. */
 export declare const GATEWAY_BUILTIN_TOOLS: readonly [{
+    readonly id: "phone_use";
+    readonly description: {
+        readonly en: "Observe and control an authorized Android phone through the local ADB runner.";
+        readonly zh: "通过本地 ADB 执行端观察和操作已授权的 Android 手机。";
+    };
+}, {
     readonly id: "computer_use";
     readonly description: {
         readonly en: "Observe and control a locally authorized desktop application.";
@@ -271,4 +277,4 @@ export declare const GATEWAY_BUILTIN_TOOLS: readonly [{
         readonly zh: "使用已验证的参数执行选定的外部工具。";
     };
 }];
-export declare const GATEWAY_BUILTIN_TOOL_IDS: ("automation" | "find" | "image" | "knowledge_search" | "knowledge_get" | "knowledge_write" | "user_context_search" | "user_context_get" | "user_context_update" | "web_search" | "web_fetch" | "browser_use" | "grep" | "session_search" | "read_file" | "list_dir" | "write_file" | "apply_patch" | "exec_command" | "update_plan" | "todo" | "web_extract" | "clarify" | "xopc_tool_execute" | "tool_manual" | "session_status" | "read_media" | "xopc_tool_search" | "xopc_tool_describe" | "image_generate" | "skills_list" | "skill_view" | "skill_manage" | "skills_marketplace_search" | "computer_use" | "send_message" | "text_to_speech" | "execute_code" | "send_media" | "create_share" | "memory_maintenance" | "delegate_task" | "skill_install" | "create_desktop_pet")[];
+export declare const GATEWAY_BUILTIN_TOOL_IDS: ("automation" | "find" | "image" | "knowledge_search" | "knowledge_get" | "knowledge_write" | "user_context_search" | "user_context_get" | "user_context_update" | "web_search" | "web_fetch" | "browser_use" | "grep" | "session_search" | "read_file" | "list_dir" | "write_file" | "apply_patch" | "exec_command" | "update_plan" | "todo" | "web_extract" | "clarify" | "xopc_tool_execute" | "tool_manual" | "session_status" | "read_media" | "xopc_tool_search" | "xopc_tool_describe" | "phone_use" | "image_generate" | "skills_list" | "skill_view" | "skill_manage" | "skills_marketplace_search" | "computer_use" | "send_message" | "text_to_speech" | "execute_code" | "send_media" | "create_share" | "memory_maintenance" | "delegate_task" | "skill_install" | "create_desktop_pet")[];

package/dist/src/gateway/agent-builtin-tools.js

@@ -3,6 +3,13 @@ import "../agent/external-tools/index.js";
 //#region src/gateway/agent-builtin-tools.ts
 /** Built-in agent tools exposed by the gateway configuration UI. */
 const GATEWAY_BUILTIN_TOOLS = [
+	{
+		id: "phone_use",
+		description: {
+			en: "Observe and control an authorized Android phone through the local ADB runner.",
+			zh: "通过本地 ADB 执行端观察和操作已授权的 Android 手机。"
+		}
+	},
 	{
 		id: "computer_use",
 		description: {

package/dist/src/gateway/global-defaults-admin.js

@@ -2,6 +2,7 @@ import { AgentDefaultsSchema } from "../agent-config/schema.js";
 import { init_agent_config } from "../agent-config/index.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
 import { AgentCatalogService } from "../agent-catalog/service.js";
+import { validatePhoneModelChange } from "../phone/model-adapter.js";
 import { validateComputerModelChange } from "../computer/model-config.js";
 import { GATEWAY_BUILTIN_TOOLS } from "./agent-builtin-tools.js";
 import { isDeepStrictEqual } from "node:util";
@@ -38,6 +39,7 @@ function prepareUpdateGlobalDefaults(body) {
 		status: 400
 	};
 	try {
+		validatePhoneModelChange(parsed.data.models.phoneUse, current.models.phoneUse);
 		validateComputerModelChange(parsed.data.models.computerUse, current.models.computerUse);
 	} catch (error) {
 		return {

package/dist/src/gateway/hono/lib/config-payload.d.ts

@@ -43,6 +43,10 @@ export declare function buildSafeWebConfigPayload(service: GatewayService, optio
                     primary: string;
                     fallbacks: string[];
                 };
+                phoneUse?: {
+                    primary: string;
+                    fallbacks: string[];
+                };
                 imageGeneration?: {
                     primary: string;
                     fallbacks: string[];
@@ -87,6 +91,10 @@ export declare function buildSafeWebConfigPayload(service: GatewayService, optio
                     primary: string;
                     fallbacks: string[];
                 };
+                phoneUse?: {
+                    primary: string;
+                    fallbacks: string[];
+                };
                 imageGeneration?: {
                     primary: string;
                     fallbacks: string[];

package/dist/src/gateway/hono/routes/auth-registry-extensions.js

@@ -2,8 +2,8 @@ import { getAllModels, getAvailableModels, init_providers } from "../../../provi
 import { ActivationPlanner } from "../../../extensions/activation-planner.js";
 import { mergeActivationContext } from "../../../extensions/activation-context.js";
 import { validateExtensionConfig } from "../../../extensions/config-validation.js";
-import { fetchRegistry, listExtensions, searchExtensions } from "../../../extensions/marketplace.js";
 import { listAgentPluginInventory } from "../../../extensions/agent-plugins/inventory.js";
+import { fetchRegistry, listExtensions, searchExtensions } from "../../../extensions/marketplace.js";
 import { createOAuthAsyncHandler } from "../oauth-async.js";
 import { createOAuthHandler } from "../oauth.js";
 import { extensionAssetMimeType } from "../lib/extension-assets.js";

package/dist/src/gateway/hono/routes/lazy-bundles.js

@@ -3,6 +3,14 @@ function startsWithAny(path, prefixes) {
 	return prefixes.some((prefix) => path === prefix || path.startsWith(`${prefix}/`));
 }
 const AUTHENTICATED_LAZY_ROUTE_BUNDLES = [
+	{
+		id: "phone",
+		match: (path) => startsWithAny(path, ["/api/phone"]),
+		load: async () => {
+			const { registerPhoneRoutes } = await import("./phone.js");
+			return { register: registerPhoneRoutes };
+		}
+	},
 	{
 		id: "next-turn-suggestions",
 		match: (path) => /^\/api\/sessions\/[^/]+\/(?:next-turn-suggestion|next-turn-suggestion-feedback)$/.test(path),

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

@@ -12,6 +12,7 @@ import { CredentialResolver, init_credentials } from "../../../auth/credentials.
 import { getProviderRegistry, init_plugin_registry } from "../../../providers/plugin-registry.js";
 import { PROVIDER_META, getAllModels, getAllProviders, getAvailableModels, getProviderAuthState, init_providers, isProviderConfigured, isProviderConfiguredSync } from "../../../providers/index.js";
 import { XopcCloudAccountError, XopcCloudAccountService } from "../../../providers/xopc-cloud-account-service.js";
+import { phoneModelProfile } from "../../../phone/model-adapter.js";
 import { buildCapabilityPlansForConfig } from "../../../capabilities/readiness/from-config.js";
 import "../../../capabilities/readiness/index.js";
 import { getModelThinking } from "../../../providers/model-thinking.js";
@@ -324,6 +325,7 @@ function registerModelsRoutes(authenticated, deps) {
 			name: m.name,
 			...catalogDisplayNames(m.provider, m.id),
 			provider: m.provider,
+			...phoneModelProfile(m) ? { phoneUse: { profile: phoneModelProfile(m) } } : {},
 			...computerModelProfile(m) ? { computerUse: {
 				profile: computerModelProfile(m),
 				dedicated: isDedicatedComputerModel(m)
@@ -710,6 +712,7 @@ function registerModelsRoutes(authenticated, deps) {
 			name: m.name,
 			...catalogDisplayNames(m.provider, m.id),
 			provider: m.provider,
+			...phoneModelProfile(m) ? { phoneUse: { profile: phoneModelProfile(m) } } : {},
 			contextWindow: m.contextWindow ?? 128e3,
 			maxTokens: m.maxTokens ?? 4096,
 			reasoning: m.reasoning ?? false,

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

@@ -0,0 +1,3 @@
+import { Hono } from 'hono';
+import type { AuthenticatedRouteDeps } from './deps.js';
+export declare function registerPhoneDependencyRoutes(parent: Hono, deps: AuthenticatedRouteDeps): void;

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

@@ -0,0 +1,137 @@
+import { init_paths_state, resolveStateDir } from "../../../config/paths-state.js";
+import { resolveAdbPath } from "../../../phone/adb-driver.js";
+import { getPhoneRuntime } from "../../../phone/runtime.js";
+import { RuntimeError } from "../../../runtime-tools/errors.js";
+import { getGatewayPrincipal } from "../../security/gateway-principal.js";
+import { PhoneDependencyManager, probePhoneAdb } from "../../../runtime-tools/phone-dependencies.js";
+import { z } from "zod";
+import { Hono } from "hono";
+import { bodyLimit } from "hono/body-limit";
+import { streamSSE } from "hono/streaming";
+//#region src/gateway/hono/routes/phone-dependencies.ts
+init_paths_state();
+function registerPhoneDependencyRoutes(parent, deps) {
+	const app = new Hono();
+	const base = "/api/runtime-tools/phone-dependencies";
+	const manager = () => new PhoneDependencyManager({
+		stateDir: resolveStateDir(),
+		config: deps.service.currentConfig.runtimeTools,
+		adbPath: deps.service.currentConfig.phone.adbPath
+	});
+	const adbBusy = () => getPhoneRuntime().reports().some((report) => ![
+		"closed",
+		"cancelled",
+		"failed",
+		"outcome_unknown"
+	].includes(report.status));
+	app.use(`${base}/*`, bodyLimit({ maxSize: 8192 }));
+	const admin = async (c, next) => {
+		const principal = getGatewayPrincipal(c);
+		if (!["owner", "trusted-proxy"].includes(principal.kind) || !principal.scopes.includes("gateway.admin")) return c.json({
+			ok: false,
+			message: "Gateway administrator access is required"
+		}, 403);
+		return next();
+	};
+	app.use(base, admin);
+	app.use(`${base}/*`, admin);
+	app.onError((error, c) => c.json({
+		ok: false,
+		message: error instanceof z.ZodError ? "Invalid dependency request" : error.message,
+		error: error instanceof RuntimeError ? error.code : "PHONE_DEPENDENCY_FAILED"
+	}, 400));
+	app.get(base, async (c) => {
+		c.header("Cache-Control", "no-store");
+		return c.json({
+			ok: true,
+			payload: {
+				location: "gateway",
+				installationEnabled: deps.service.currentConfig.runtimeTools.enabled,
+				statuses: await manager().status()
+			}
+		});
+	});
+	app.post(`${base}/adb/path`, deps.strictRateLimitMiddleware, async (c) => {
+		const { path } = z.object({ path: z.string().trim().max(4096) }).strict().parse(await c.req.json());
+		if (adbBusy()) return c.json({
+			ok: false,
+			message: "Close the current phone session before changing ADB",
+			error: "PHONE_DEPENDENCY_BUSY"
+		}, 409);
+		if (path && !/^(?:\/|[A-Za-z]:[\\/]|\\\\)/.test(path)) return c.json({
+			ok: false,
+			message: "Enter an absolute ADB executable path on the Gateway host"
+		}, 400);
+		await probePhoneAdb(resolveAdbPath(path || void 0));
+		const next = structuredClone(deps.service.currentConfig);
+		next.phone.adbPath = path || void 0;
+		if (!(await deps.service.saveConfig(next)).saved) return c.json({
+			ok: false,
+			message: "Could not save the ADB path"
+		}, 500);
+		deps.service.emit("runtime-tools.updated", { dependency: "adb" });
+		return c.json({ ok: true });
+	});
+	app.post(`${base}/:kind/:action/stream`, deps.strictRateLimitMiddleware, async (c) => {
+		const kind = z.enum(["adb", "scrcpy"]).parse(c.req.param("kind"));
+		const action = z.enum([
+			"install",
+			"repair",
+			"import"
+		]).parse(c.req.param("action"));
+		const input = z.object({ path: z.string().trim().min(1).max(4096).optional() }).strict().parse(await c.req.json());
+		if (action === "import" && (kind !== "scrcpy" || !input.path) || action !== "import" && input.path) return c.json({
+			ok: false,
+			message: "Only scrcpy server imports accept a file path"
+		}, 400);
+		if (kind === "adb" && adbBusy()) return c.json({
+			ok: false,
+			message: "Close the current phone session before installing or repairing ADB",
+			error: "PHONE_DEPENDENCY_BUSY"
+		}, 409);
+		const runtime = manager();
+		return streamSSE(c, async (stream) => {
+			let writes = Promise.resolve();
+			const progress = (event) => {
+				writes = writes.then(async () => {
+					try {
+						await stream.writeSSE({
+							event: "progress",
+							data: JSON.stringify(event)
+						});
+					} catch {}
+				});
+			};
+			runtime.on("progress", progress);
+			try {
+				await runtime.install(kind, {
+					repair: action === "repair",
+					sourcePath: input.path
+				});
+				await writes;
+				deps.service.emit("runtime-tools.updated", { dependency: kind });
+				await stream.writeSSE({
+					event: "result",
+					data: JSON.stringify({ ok: true })
+				});
+			} catch (error) {
+				await writes;
+				try {
+					await stream.writeSSE({
+						event: "result",
+						data: JSON.stringify({
+							ok: false,
+							message: error instanceof Error ? error.message : String(error),
+							error: error instanceof RuntimeError ? error.code : "PHONE_DEPENDENCY_FAILED"
+						})
+					});
+				} catch {}
+			} finally {
+				runtime.off("progress", progress);
+			}
+		});
+	});
+	parent.route("/", app);
+}
+//#endregion
+export { registerPhoneDependencyRoutes };

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

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