@xopcai/xopc 0.0.411 → 0.0.413

package/dist/src/agent-config/schema.js

@@ -3,7 +3,7 @@ import { SpecialistProfileSchema } from "../../packages/gateway-contract/src/spe
 import { init_src } from "../../packages/gateway-contract/src/index.js";
 import { z } from "zod";
 //#region src/agent-config/schema.ts
-var DEFAULT_AGENT_MODEL_REF, DEFAULT_CORE_SKILLS, DEFAULT_SKILL_POLICY, AgentIdSchema, ModelRefSchema, ModelRouteSchema, ImageGenerationRouteSchema, ComputerModelRouteSchema, ModelIntentSchema, ModelIntentRoutesSchema, ModelIntentOverridesSchema, AgentModelsDefaultsSchema, AgentModelsOverrideSchema, ToolModeSchema, ToolPolicySchema, ToolPoliciesSchema, SkillDefaultsSchema, SkillOverrideSchema, RuntimePolicySchema, AgentDefaultsSchema, AgentProfileSchema, AgentEntrySchema, EffectiveAgentConfigSchema;
+var DEFAULT_AGENT_MODEL_REF, DEFAULT_CORE_SKILLS, DEFAULT_SKILL_POLICY, AgentIdSchema, ModelRefSchema, ModelRouteSchema, ImageGenerationRouteSchema, ComputerModelRouteSchema, PhoneModelRouteSchema, ModelIntentSchema, ModelIntentRoutesSchema, ModelIntentOverridesSchema, AgentModelsDefaultsSchema, AgentModelsOverrideSchema, ToolModeSchema, ToolPolicySchema, ToolPoliciesSchema, SkillDefaultsSchema, SkillOverrideSchema, RuntimePolicySchema, AgentDefaultsSchema, AgentProfileSchema, AgentEntrySchema, EffectiveAgentConfigSchema;
 var init_schema = __esmMin((() => {
 	init_src();
 	DEFAULT_AGENT_MODEL_REF = "xopc-cloud/auto";
@@ -31,6 +31,7 @@ var init_schema = __esmMin((() => {
 		autoProviderFallback: z.boolean().default(false)
 	}).strict();
 	ComputerModelRouteSchema = ModelRouteSchema.extend({ fallbacks: z.array(ModelRefSchema).max(0, "Computer Use does not support fallback models").default([]) }).strict();
+	PhoneModelRouteSchema = ModelRouteSchema.extend({ fallbacks: z.array(ModelRefSchema).max(0, "Phone Use does not support fallback models").default([]) }).strict();
 	ModelIntentSchema = z.enum([
 		"fast",
 		"reasoning",
@@ -47,6 +48,7 @@ var init_schema = __esmMin((() => {
 		intents: ModelIntentRoutesSchema.default({}),
 		imageUnderstanding: ModelRouteSchema.optional(),
 		computerUse: ComputerModelRouteSchema.optional(),
+		phoneUse: PhoneModelRouteSchema.optional(),
 		imageGeneration: ImageGenerationRouteSchema.optional()
 	}).strict();
 	AgentModelsOverrideSchema = z.object({
@@ -55,6 +57,7 @@ var init_schema = __esmMin((() => {
 		intents: ModelIntentOverridesSchema.optional(),
 		imageUnderstanding: ModelRouteSchema.nullable().optional(),
 		computerUse: ComputerModelRouteSchema.nullable().optional(),
+		phoneUse: PhoneModelRouteSchema.nullable().optional(),
 		imageGeneration: ImageGenerationRouteSchema.nullable().optional()
 	}).strict();
 	ToolModeSchema = z.enum([
@@ -175,4 +178,4 @@ var init_schema = __esmMin((() => {
 }));
 //#endregion
 init_schema();
-export { AgentDefaultsSchema, AgentEntrySchema, AgentIdSchema, AgentModelsDefaultsSchema, AgentModelsOverrideSchema, AgentProfileSchema, ComputerModelRouteSchema, DEFAULT_AGENT_MODEL_REF, DEFAULT_CORE_SKILLS, DEFAULT_SKILL_POLICY, EffectiveAgentConfigSchema, ImageGenerationRouteSchema, ModelIntentSchema, ModelRefSchema, ModelRouteSchema, RuntimePolicySchema, SkillDefaultsSchema, SkillOverrideSchema, ToolModeSchema, ToolPoliciesSchema, ToolPolicySchema, init_schema };
+export { AgentDefaultsSchema, AgentEntrySchema, AgentIdSchema, AgentModelsDefaultsSchema, AgentModelsOverrideSchema, AgentProfileSchema, ComputerModelRouteSchema, DEFAULT_AGENT_MODEL_REF, DEFAULT_CORE_SKILLS, DEFAULT_SKILL_POLICY, EffectiveAgentConfigSchema, ImageGenerationRouteSchema, ModelIntentSchema, ModelRefSchema, ModelRouteSchema, PhoneModelRouteSchema, RuntimePolicySchema, SkillDefaultsSchema, SkillOverrideSchema, ToolModeSchema, ToolPoliciesSchema, ToolPolicySchema, init_schema };

package/dist/src/automations/capabilities/drafts.js

@@ -3,10 +3,10 @@ import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { init_trust_policy, resolveAutomationSafetyForTrust } from "../../user-context/trust-policy.js";
 import { getUserTrustPolicy } from "../../storage/sqlite/user-trust-repository.js";
 import { init_sqlite } from "../../storage/sqlite/index.js";
+import { init_agent_scope, resolveDefaultAgentId } from "../../agent/agent-scope.js";
 import { CapabilityError } from "../../capabilities/runtime/errors.js";
 import { ExternalEffectNotAppliedError } from "../../capabilities/runtime/external-operations.js";
 import { defineExternalCapability, defineReadCapability } from "../../capabilities/runtime/dispatcher.js";
-import { init_agent_scope, resolveDefaultAgentId } from "../../agent/agent-scope.js";
 import { AutomationCreateCapabilityInputSchema } from "./write.js";
 import { simulateAutomation } from "../draft/automation-draft-validator.js";
 import { AutomationDraftService } from "../draft/automation-draft-service.js";

package/dist/src/browser/providers/browser-ext-install.js

@@ -13,8 +13,8 @@ import { chmodSync, existsSync, mkdirSync, readFileSync, readdirSync, realpathSy
 import { fileURLToPath } from "node:url";
 import { execFileSync, spawn } from "node:child_process";
 import { createHash } from "node:crypto";
-import { readFile, readdir, rm } from "node:fs/promises";
 import AdmZip from "adm-zip";
+import { readFile, readdir, rm } from "node:fs/promises";
 //#region src/browser/providers/browser-ext-install.ts
 /**
 * Install bundled Chrome extension artifacts into {resolveBinDir()}/browser-ext/.

package/dist/src/capabilities/runtime/dispatcher.js

@@ -1,7 +1,7 @@
 import { SqliteCommitEffectError, init_transaction } from "../../storage/sqlite/transaction.js";
-import { OperationConflictError, executeAtomicOperation } from "./atomic-operations.js";
 import { CapabilityError } from "./errors.js";
 import { executeExternalOperation } from "./external-operations.js";
+import { OperationConflictError, executeAtomicOperation } from "./atomic-operations.js";
 import { createHash } from "node:crypto";
 import { z } from "zod";
 //#region src/capabilities/runtime/dispatcher.ts

package/dist/src/capabilities/runtime/product.js

@@ -1,6 +1,5 @@
 import { CapabilityError } from "./errors.js";
 import { CapabilityDispatcher } from "./dispatcher.js";
-import { registerAgentCapabilities } from "../../agent-catalog/capabilities.js";
 import { registerLocalAppReadCapabilities } from "../../local-apps/capabilities/read.js";
 import { registerNoteReadCapabilities } from "../../notes/capabilities/read.js";
 import { registerNoteWriteCapabilities } from "../../notes/capabilities/write.js";
@@ -17,6 +16,7 @@ import { registerAutomationDraftCapabilities } from "../../automations/capabilit
 import { registerTaskWriteCapabilities } from "../../tasks/capabilities/write.js";
 import { registerSettingsCapability } from "./settings.js";
 import { registerAppContextCapability } from "./app-context.js";
+import { registerAgentCapabilities } from "../../agent-catalog/capabilities.js";
 //#region src/capabilities/runtime/product.ts
 function createProductDispatcher(getNotes, taskWrites) {
 	const dispatcher = new CapabilityDispatcher();

package/dist/src/cli/command-manifest.js

@@ -93,7 +93,7 @@ const ROOT_HELP_COMMANDS = [
 	},
 	{
 		name: "runtime",
-		description: "Manage Node.js and Python tool runtimes used by agents"
+		description: "Manage agent runtimes and phone dependencies"
 	},
 	{
 		name: "mcp",

package/dist/src/cli/commands/agents.js

@@ -1,8 +1,8 @@
 import { normalizeAgentId, validateAgentIdForNewAgent } from "../../agent-catalog/id.js";
 import { AgentCatalogRepository, init_repository } from "../../agent-catalog/repository.js";
 import { init_agent_scope, resolveAgentDir, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../../agent/agent-scope.js";
-import { AgentCatalogService } from "../../agent-catalog/service.js";
 import { resolveEffectiveAgentConfigForAgent } from "../../config/agent-profile.js";
+import { AgentCatalogService } from "../../agent-catalog/service.js";
 import { colors } from "../utils/colors.js";
 //#region src/cli/commands/agents.ts
 init_repository();

package/dist/src/cli/commands/models.js

@@ -1,11 +1,11 @@
 import { creditDecimal } from "../../../packages/gateway-contract/src/cloud-credits.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { AgentCatalogRepository, init_repository } from "../../agent-catalog/repository.js";
-import { AgentCatalogService } from "../../agent-catalog/service.js";
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { CredentialResolver, init_credentials } from "../../auth/credentials.js";
 import { getAllModels, getAvailableModels, getConfiguredProviders, getProviderAuthState, getProviderDisplayName, init_providers, isProviderConfigured, providerSupportsApiKey, providerSupportsOAuth, resolveModel } from "../../providers/index.js";
 import { XopcCloudAccountService } from "../../providers/xopc-cloud-account-service.js";
+import { AgentCatalogService } from "../../agent-catalog/service.js";
 import { listImageProviderSpecs } from "../../../packages/image-providers/src/catalog.js";
 import "../../../packages/image-providers/src/index.js";
 import { loadConfig } from "../../config/loader.js";

package/dist/src/cli/commands/onboard/model.js

@@ -1,5 +1,4 @@
 import { AgentCatalogRepository, init_repository } from "../../../agent-catalog/repository.js";
-import { AgentCatalogService } from "../../../agent-catalog/service.js";
 import { resolveModelsJsonPath } from "../../../config/paths.js";
 import { ConfigSchema, getAgentDefaultModelRef, init_schema } from "../../../config/schema.js";
 import { init_models_json, loadModelsJson, saveModelsJson } from "../../../config/models-json.js";
@@ -7,6 +6,7 @@ import { getApiKeyFromEnv } from "../../../providers/env-keys.js";
 import { getModelRegistry } from "../../../providers/model-registry.js";
 import { CredentialResolver, init_credentials } from "../../../auth/credentials.js";
 import { getAllProviders, getModelsByProvider, getProviderDisplayName, init_providers, providerSupportsApiKey, providerSupportsOAuth } from "../../../providers/index.js";
+import { AgentCatalogService } from "../../../agent-catalog/service.js";
 import { prepareUpdateGlobalDefaults } from "../../../gateway/global-defaults-admin.js";
 import { discoverProviderModels, isProviderApiDiscoverable } from "../../../providers/model-discovery.js";
 import { getXopcCloudCatalogCoordinator } from "../../../providers/xopc-cloud-catalog-coordinator.js";

package/dist/src/cli/commands/onboard.js

@@ -5,8 +5,8 @@ import { resolveGatewayLocalClientHost } from "../../config/gateway-bind.js";
 import { saveConfig } from "../../config/loader.js";
 import { formatExamples, register } from "../registry.js";
 import "../../config/index.js";
-import { provisionEagerRuntimes } from "../../runtime-tools/bootstrap.js";
 import { colors } from "../utils/colors.js";
+import { provisionEagerRuntimes } from "../../runtime-tools/bootstrap.js";
 import { initWorkspace } from "../utils/init-workspace.js";
 import { setupModel } from "./onboard/model.js";
 import { getChannelConfigurators } from "./onboard/channels/registry.js";

package/dist/src/cli/commands/runtime.js

@@ -6,6 +6,15 @@ import { pruneRuntimeTools } from "../../runtime-tools/prune.js";
 import { Command } from "commander";
 //#region src/cli/commands/runtime.ts
 init_paths_state();
+async function phoneDependencies(ctx) {
+	const { PhoneDependencyManager } = await import("../../runtime-tools/phone-dependencies.js");
+	const config = loadConfig(ctx.configPath);
+	return new PhoneDependencyManager({
+		stateDir: resolveStateDir(),
+		config: config.runtimeTools,
+		adbPath: config.phone.adbPath
+	});
+}
 const RUNTIMES = [
 	"node",
 	"uv",
@@ -29,25 +38,44 @@ function printStatuses(statuses) {
 	}
 }
 function createRuntimeCommand(ctx) {
-	const command = new Command("runtime").description("Manage Node.js and Python tool runtimes used by agents").addHelpText("after", formatExamples([
+	const command = new Command("runtime").description("Manage agent runtimes and phone dependencies").addHelpText("after", formatExamples([
 		"xopc runtime status",
 		"xopc runtime install node",
 		"xopc runtime install python --version 3.12",
+		"xopc runtime install adb",
+		"xopc runtime install scrcpy",
 		"xopc runtime repair python",
 		"xopc runtime prune"
 	]));
-	command.command("status").description("Show managed tool runtime status").option("--json", "Output JSON").action(async (options) => {
+	command.command("status").description("Show managed tool runtime status").option("--json", "Output JSON").option("--phone", "Show ADB and scrcpy server dependencies").action(async (options) => {
+		if (options.phone) {
+			const statuses = await (await phoneDependencies(ctx)).status();
+			console.log(options.json ? JSON.stringify(statuses, null, 2) : statuses.map((status) => `${status.kind.padEnd(6)} ${status.state.padEnd(10)} ${status.version ?? status.requestedVersion}${status.path ? ` — ${status.path}` : ""}`).join("\n"));
+			if (statuses.some((status) => status.state === "corrupted")) process.exitCode = 1;
+			return;
+		}
 		const statuses = await manager(ctx).statusAll();
 		if (options.json) console.log(JSON.stringify(statuses, null, 2));
 		else printStatuses(statuses);
 		if (statuses.some((status) => status.state === "corrupted" || status.state === "failed")) process.exitCode = 1;
 	});
-	command.command("install").description("Install one managed runtime").argument("<runtime>", "node, uv, or python").option("--version <version>", "Requested runtime version").action(async (runtimeValue, options) => {
+	command.command("install").description("Install one managed runtime").argument("<runtime>", "node, uv, python, adb, or scrcpy").option("--version <version>", "Requested runtime version").action(async (runtimeValue, options) => {
+		if (runtimeValue === "adb" || runtimeValue === "scrcpy") {
+			if (options.version) throw new Error("Phone dependencies use the pinned catalog version; omit --version");
+			await (await phoneDependencies(ctx)).install(runtimeValue);
+			console.log(`${runtimeValue} installed in the Gateway state directory`);
+			return;
+		}
 		const runtime = parseRuntime(runtimeValue);
 		const resolved = await manager(ctx).install(runtime, options.version);
 		console.log(`${runtime} ${resolved.version} installed at ${resolved.executable}`);
 	});
-	command.command("repair").description("Reinstall one invalid managed runtime").argument("<runtime>", "node, uv, or python").action(async (runtimeValue) => {
+	command.command("repair").description("Reinstall one invalid managed runtime").argument("<runtime>", "node, uv, python, adb, or scrcpy").action(async (runtimeValue) => {
+		if (runtimeValue === "adb" || runtimeValue === "scrcpy") {
+			await (await phoneDependencies(ctx)).install(runtimeValue, { repair: true });
+			console.log(`${runtimeValue} managed installation repaired`);
+			return;
+		}
 		const runtime = parseRuntime(runtimeValue);
 		const resolved = await manager(ctx).repair(runtime);
 		console.log(`${runtime} ${resolved.version} repaired at ${resolved.executable}`);

package/dist/src/cli/utils/init-workspace-core.js

@@ -1,11 +1,12 @@
 import { AgentCatalogRepository, init_repository } from "../../agent-catalog/repository.js";
-import { AgentCatalogService } from "../../agent-catalog/service.js";
 import { ConfigSchema, init_schema } from "../../config/schema.js";
+import { AgentCatalogService } from "../../agent-catalog/service.js";
+import { readConfigFileSnapshot } from "../../config/config-file.js";
 import { saveConfig } from "../../config/loader.js";
 import { ensureStarterAgentsInitialized } from "../../agent/starter-agents.js";
 import { bootstrapApplicationStateSync } from "../../bootstrap/application-state.js";
 import { dirname } from "node:path";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
 import { randomBytes } from "node:crypto";
 //#region src/cli/utils/init-workspace-core.ts
 init_schema();
@@ -19,9 +20,10 @@ async function serializeConfig(cfg, assertChannelPlugins) {
 	return JSON.stringify(validated, null, 2);
 }
 async function readDiskConfig(configPath, assertChannelPlugins) {
-	const raw = readFileSync(configPath, "utf-8");
-	const cfg = ConfigSchema.parse(JSON.parse(raw));
+	const snapshot = readConfigFileSnapshot(configPath);
+	const cfg = snapshot.config;
 	await assertChannelPluginsIfNeeded(cfg, assertChannelPlugins);
+	snapshot.discardRetiredFields();
 	return cfg;
 }
 /**

package/dist/src/computer/diagnostics.d.ts

@@ -178,12 +178,12 @@ export declare const ComputerSessionReportSchema: z.ZodObject<{
     recentActions: z.ZodArray<z.ZodObject<{
         kind: z.ZodEnum<{
             wait: "wait";
+            typeText: "typeText";
             activate: "activate";
             showMenu: "showMenu";
             click: "click";
             drag: "drag";
             setValue: "setValue";
-            typeText: "typeText";
             pressKeys: "pressKeys";
             scroll: "scroll";
         }>;

package/dist/src/config/agent-profile.js

@@ -1,6 +1,6 @@
+import { normalizeAgentId } from "../agent-catalog/id.js";
 import { resolveEffectiveAgentConfig } from "../agent-config/resolver.js";
 import { init_agent_config } from "../agent-config/index.js";
-import { normalizeAgentId } from "../agent-catalog/id.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
 import { init_agent_scope, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
 import { getConversationRouting } from "../storage/sqlite/conversation-repository.js";

package/dist/src/config/config-file.d.ts

@@ -0,0 +1,6 @@
+import { type Config } from './schema.js';
+/** Validate existing settings before committing removal of retired fields. */
+export declare function readConfigFileSnapshot(path: string): {
+    config: Config;
+    discardRetiredFields: () => void;
+};

package/dist/src/config/config-file.js

@@ -0,0 +1,35 @@
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
+import { init_write_file_atomic, writeTextAtomicSync } from "../infra/write-file-atomic.js";
+import { ConfigSchema, init_schema } from "./schema.js";
+import { readFileSync } from "node:fs";
+//#region src/config/config-file.ts
+init_write_file_atomic();
+init_logger();
+init_schema();
+const log = createLogger("ConfigFile");
+/** Validate existing settings before committing removal of retired fields. */
+function readConfigFileSnapshot(path) {
+	const original = readFileSync(path, "utf8");
+	const raw = JSON.parse(original);
+	const hasRetiredFields = raw !== null && typeof raw === "object" && !Array.isArray(raw) && Object.hasOwn(raw, "workflows");
+	const current = hasRetiredFields ? { ...raw } : raw;
+	if (hasRetiredFields) delete current.workflows;
+	return {
+		config: ConfigSchema.parse(current),
+		discardRetiredFields: () => {
+			if (!hasRetiredFields) return;
+			try {
+				if (readFileSync(path, "utf8") !== original) return;
+				writeTextAtomicSync(path, `${JSON.stringify(current, null, 2)}\n`);
+			} catch (err) {
+				log.warn({
+					err,
+					path
+				}, "Could not remove retired configuration fields from disk");
+			}
+		}
+	};
+}
+//#endregion
+export { readConfigFileSnapshot };

package/dist/src/config/loader.js

@@ -5,8 +5,9 @@ import { init_paths, resolveConfigPath } from "./paths.js";
 import { ConfigSchema, init_schema } from "./schema.js";
 import { init_resolution, setActivePlatformDiscovery } from "../platform/resolution.js";
 import { assertChannelPluginConfigs } from "./validate-channel-configs.js";
+import { readConfigFileSnapshot } from "./config-file.js";
 import { dirname } from "path";
-import { existsSync, mkdirSync, promises, readFileSync } from "fs";
+import { existsSync, mkdirSync, promises } from "fs";
 import { config } from "dotenv";
 //#region src/config/loader.ts
 init_write_file_atomic();
@@ -47,10 +48,10 @@ function loadConfig(configPath) {
 	config({ quiet: true });
 	const path = configPath || process.env.XOPC_CONFIG_PATH || resolveConfigPath();
 	if (existsSync(path)) try {
-		const content = readFileSync(path, "utf-8");
-		const json = JSON.parse(content);
-		const cfg = ConfigSchema.parse(json);
+		const snapshot = readConfigFileSnapshot(path);
+		const cfg = snapshot.config;
 		assertChannelPluginConfigs(cfg);
+		snapshot.discardRetiredFields();
 		return activateConfig(cfg);
 	} catch (error) {
 		log.error({

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/execution-environments/local-worktree-manager.js

@@ -8,8 +8,8 @@ import { assertManagedWorktreePath, assertNoNestedRegisteredWorktrees, readDirec
 import { dirname, resolve } from "node:path";
 import { existsSync } from "node:fs";
 import { randomUUID } from "node:crypto";
-import { mkdir, rm, stat } from "node:fs/promises";
 import lockfile from "proper-lockfile";
+import { mkdir, rm, stat } from "node:fs/promises";
 //#region src/execution-environments/local-worktree-manager.ts
 init_logger();
 const log = createLogger("ExecutionEnvironment:LocalWorktree");

package/dist/src/extensions/agent-plugins/skill-catalog.js

@@ -1,6 +1,6 @@
-import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { containedPath } from "./validation.js";
 import { AgentPluginStore } from "./store.js";
+import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { createSkillConfigManager } from "../../agent/skills/config.js";
 import { parseSkillLocalizations } from "../../agent/skills/parse-skill-metadata.js";
 import { buildSkillMarkdownPreviewFromRaw } from "../../agent/skills/skill-markdown-preview-from-raw.js";

package/dist/src/extensions/agent-plugins/validation.js

@@ -8,8 +8,8 @@ import { dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { existsSync, lstatSync, readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
 import { createHash } from "node:crypto";
 import { z } from "zod";
-import yaml from "js-yaml";
 import { validateHeaderName, validateHeaderValue } from "node:http";
+import yaml from "js-yaml";
 //#region src/extensions/agent-plugins/validation.ts
 init_schema();
 const PLUGIN_SCHEMA = "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json";

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/agents-admin.js

@@ -1,10 +1,10 @@
 import { normalizeAgentId, validateAgentIdForNewAgent } from "../agent-catalog/id.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
 import { init_agent_scope, listAgentEntries, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId, resolveUserPath } from "../agent/agent-scope.js";
-import { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES, REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET } from "../agent/context/workspace.js";
-import { AgentCatalogService } from "../agent-catalog/service.js";
 import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
+import { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES, REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET } from "../agent/context/workspace.js";
 import { isPathUnderWorkspace, resolveWorkspaceSafePath } from "./workspace-editor-path.js";
+import { AgentCatalogService } from "../agent-catalog/service.js";
 import { GATEWAY_BUILTIN_TOOL_IDS } from "./agent-builtin-tools.js";
 import { resolve } from "node:path";
 import { mkdir, readFile, realpath, stat, unlink, writeFile } from "node:fs/promises";