@xopcai/xopc 0.0.411 → 0.0.413

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

@@ -1,6 +1,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 { validatePhoneModelChange } from "../phone/model-adapter.js";
 import { AgentCatalogService } from "../agent-catalog/service.js";
 import { validateComputerModelChange } from "../computer/model-config.js";
 import { GATEWAY_BUILTIN_TOOLS } from "./agent-builtin-tools.js";
@@ -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/agents.js

@@ -1,6 +1,6 @@
+import { normalizeAgentId } from "../../../agent-catalog/id.js";
 import { AgentEntrySchema, AgentModelsOverrideSchema, AgentProfileSchema, RuntimePolicySchema, SkillOverrideSchema, ToolPoliciesSchema } from "../../../agent-config/schema.js";
 import { init_agent_config } from "../../../agent-config/index.js";
-import { normalizeAgentId } from "../../../agent-catalog/id.js";
 import { init_agent_scope } from "../../../agent/agent-scope.js";
 import { getVoiceModelsConfig } from "../../../config/voice.js";
 import { createGatewayAgent, deleteAgentAvatarFile, deleteGatewayAgent, getGatewayAgentEffectiveConfig, listAgentProfileFiles, listGatewayAgents, readAgentAvatarFile, readAgentProfileFile, resolveAgentAvatarImage, updateGatewayAgent, writeAgentAvatarFromBase64, writeAgentProfileFile } from "../../agents-admin.js";

package/dist/src/gateway/hono/routes/config-patch/misc.js

@@ -1,10 +1,10 @@
 import { BindingsSchema, init_binding_schema } from "../../../../routing/binding-schema.js";
-import { AgentCatalogService } from "../../../../agent-catalog/service.js";
 import { ComputerConfigSchema, init_config } from "../../../../computer/config.js";
 import { ContextPlanningConfigSchema, HomeIntelligenceConfigSchema, KnowledgeMemoryConfigSchema, UserContextConfigSchema, UserModelConfigSchema, init_config as init_config$1 } from "../../../../user-context/config.js";
 import { BrowserConfigSchema, McpConfigSchema, VoiceConfigSchema, init_schema } from "../../../../config/schema.js";
 import { CredentialResolver, init_credentials } from "../../../../auth/credentials.js";
 import { canonicalizeConfiguredMcpServer } from "../../../../config/mcp-config-normalize.js";
+import { AgentCatalogService } from "../../../../agent-catalog/service.js";
 import { mergeGatewaySkillsMarketplacePatch, mergeSessionConfigPatch, mergeUpdateConfigPatch } from "../../../../config/web-patch.js";
 import { assertGatewayAuthConfigured, resolveGatewayAuth } from "../../../auth.js";
 import { isMaskedSecretPatchValue } from "../../lib/mask-secret-length.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/notes.js

@@ -1,9 +1,9 @@
 import { NoteDeleteOutputSchema, NoteGetOutputSchema, ProductReadContracts } from "../../../../packages/gateway-contract/src/capabilities.js";
 import { init_src } from "../../../../packages/gateway-contract/src/index.js";
-import { CapabilityError } from "../../../capabilities/runtime/errors.js";
-import "../../../capabilities/runtime/dispatcher.js";
 import { init_session_key, resolveConversationId } from "../../../routing/session-key.js";
 import { agentExists, getDefaultAgentId, init_resolve_route } from "../../../routing/resolve-route.js";
+import { CapabilityError } from "../../../capabilities/runtime/errors.js";
+import "../../../capabilities/runtime/dispatcher.js";
 import { resolveGatewayEffectiveHost } from "../../../config/gateway-bind.js";
 import { getShareStore } from "../../../share/share-store.js";
 import { resolveShareUrl } from "../../../share/share-url.js";

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;