@xopcai/xopc 0.0.433 → 0.0.434

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

@@ -9,8 +9,8 @@ import { dirname, join, resolve } from "node:path";
 import { existsSync, lstatSync, readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
 import { createHash } from "node:crypto";
 import { z } from "zod";
-import { validateHeaderName, validateHeaderValue } from "node:http";
 import yaml from "js-yaml";
+import { validateHeaderName, validateHeaderValue } from "node:http";
 //#region src/extensions/agent-plugins/validation.ts
 init_schema();
 const PLUGIN_SCHEMA = "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json";
@@ -204,7 +204,8 @@ function inspectAgentPlugin(rootDir, dataDir = join(rootDir, ".inspection-data")
 			seenSkills.add(name);
 			result.skills.push({
 				name,
-				filePath
+				filePath,
+				description: metadata.description
 			});
 			const references = [...new Set(content.match(/\bmcp__[A-Za-z0-9_-]+__[A-Za-z0-9_-]+|\bfunctions\.(?:exec_command|apply_patch|spawn_agent|send_input|wait_agent)|\$\{(?:CLAUDE_)?PLUGIN_(?:ROOT|DATA|RESOURCES)\}/g) ?? [])].slice(0, 20);
 			const message = references.length ? `Host-specific references need execution verification: ${references.join(", ")}` : "Skill format accepted; business execution is not verified.";

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

@@ -277,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" | "phone_use" | "skill_view" | "skills_list" | "image_generate" | "skill_manage" | "skills_marketplace_search" | "computer_use" | "send_message" | "text_to_speech" | "execute_code" | "send_media" | "create_share" | "memory_maintenance" | "skill_install" | "delegate_task" | "create_desktop_pet")[];
+export declare const GATEWAY_BUILTIN_TOOL_IDS: ("automation" | "find" | "image" | "xopc_tool_search" | "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_describe" | "phone_use" | "skill_view" | "skills_list" | "image_generate" | "skill_manage" | "skills_marketplace_search" | "computer_use" | "send_message" | "text_to_speech" | "execute_code" | "send_media" | "create_share" | "memory_maintenance" | "skill_install" | "delegate_task" | "create_desktop_pet")[];

package/dist/src/gateway/agents-admin.js

@@ -1,9 +1,9 @@
 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 { resolveEffectiveAgentProfile } from "../config/agent-profile.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 { isPathUnderWorkspace, resolveWorkspaceSafePath } from "./workspace-editor-path.js";
 import { GATEWAY_BUILTIN_TOOL_IDS } from "./agent-builtin-tools.js";
 import { resolve } from "node:path";

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

@@ -1,8 +1,8 @@
 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 { 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";

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

@@ -27,6 +27,14 @@ const AUTHENTICATED_LAZY_ROUTE_BUNDLES = [
 			return { register: registerPhoneRoutes };
 		}
 	},
+	{
+		id: "session-input-control",
+		match: (path) => /^\/api\/sessions\/[^/]+\/input-control$/.test(path),
+		load: async () => {
+			const { registerSessionInputControlRoutes } = await import("./session-input-control.js");
+			return { register: registerSessionInputControlRoutes };
+		}
+	},
 	{
 		id: "next-turn-suggestions",
 		match: (path) => /^\/api\/sessions\/[^/]+\/(?:next-turn-suggestion|next-turn-suggestion-feedback)$/.test(path),

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 { 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 { init_session_key, resolveConversationId } from "../../../routing/session-key.js";
+import { agentExists, getDefaultAgentId, init_resolve_route } from "../../../routing/resolve-route.js";
 import { resolveReverseProxyPublicUrl } from "../../public-url.js";
 import { createProductDispatcher } from "../../../capabilities/runtime/product.js";
 import { resolveGatewayEffectiveHost } from "../../../config/gateway-bind.js";

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

@@ -1,4 +1,5 @@
 import { init_paths_state, resolveStateDir } from "../../../config/paths-state.js";
+import { managedHdcPath, managedHosJar, managedJavaHome } from "../../../runtime-tools/harmony-paths.js";
 import { resolveAdbPath } from "../../../phone/adb-driver.js";
 import { getPhoneRuntime } from "../../../phone/runtime.js";
 import { RuntimeError } from "../../../runtime-tools/errors.js";
@@ -16,7 +17,8 @@ function registerPhoneDependencyRoutes(parent, deps) {
 	const manager = () => new PhoneDependencyManager({
 		stateDir: resolveStateDir(),
 		config: deps.service.currentConfig.runtimeTools,
-		adbPath: deps.service.currentConfig.phone.adbPath
+		adbPath: deps.service.currentConfig.phone.adbPath,
+		phone: deps.service.currentConfig.phone
 	});
 	const adbBusy = () => getPhoneRuntime().reports().some((report) => report.status !== "closed");
 	app.use(`${base}/*`, bodyLimit({ maxSize: 8192 }));
@@ -68,7 +70,13 @@ function registerPhoneDependencyRoutes(parent, deps) {
 		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 kind = z.enum([
+			"adb",
+			"scrcpy",
+			"hdc",
+			"hoscrcpy",
+			"java"
+		]).parse(c.req.param("kind"));
 		const action = z.enum([
 			"install",
 			"repair",
@@ -79,9 +87,9 @@ function registerPhoneDependencyRoutes(parent, deps) {
 			ok: false,
 			message: "Only scrcpy server imports accept a file path"
 		}, 400);
-		if (kind === "adb" && adbBusy()) return c.json({
+		if (kind !== "scrcpy" && adbBusy()) return c.json({
 			ok: false,
-			message: "Close the current phone session before installing or repairing ADB",
+			message: "Close the current phone session before installing or repairing shared phone dependencies",
 			error: "PHONE_DEPENDENCY_BUSY"
 		}, 409);
 		const runtime = manager();
@@ -99,10 +107,23 @@ function registerPhoneDependencyRoutes(parent, deps) {
 			};
 			runtime.on("progress", progress);
 			try {
+				const config = deps.service.currentConfig;
 				await runtime.install(kind, {
 					repair: action === "repair",
-					sourcePath: input.path
+					sourcePath: input.path,
+					beforeCommit: () => {
+						if (kind !== "scrcpy" && adbBusy()) throw new Error("Close active phone sessions before changing shared phone dependencies");
+					}
 				});
+				if (kind === "hdc" || kind === "hoscrcpy" || kind === "java") {
+					const next = structuredClone(config);
+					if (kind === "hdc") next.phone.hdcPath = managedHdcPath();
+					else next.phone.hdcVideo = {
+						...next.phone.hdcVideo,
+						...kind === "java" ? { javaHome: managedJavaHome() } : { sdkJar: managedHosJar() }
+					};
+					if (!(await deps.service.saveConfig(next, config)).saved) throw new Error("Phone configuration changed; refresh before using the installed dependency");
+				}
 				await writes;
 				deps.service.emit("runtime-tools.updated", { dependency: kind });
 				await stream.writeSSE({

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

@@ -1,15 +1,16 @@
 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 { AgentCatalogService } from "../../../agent-catalog/service.js";
 import { init_paths } from "../../../config/paths.js";
 import { resolveEffectiveAgentConfigForAgent } from "../../../config/agent-profile.js";
 import { phoneModelProfile } from "../../../phone/model-policy.js";
 import { getAllModels, init_providers, isProviderConfiguredSync, resolveModel } from "../../../providers/index.js";
 import { phoneAllowsApp } from "../../../phone/app-access.js";
+import { managedHdcPath, managedHosJar, managedJavaHome } from "../../../runtime-tools/harmony-paths.js";
 import { managedPhoneAdbPath } from "../../../runtime-tools/phone-dependency-catalog.js";
 import "../../../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";
@@ -31,7 +32,8 @@ function createPhoneSetupService(service) {
 	const manager = () => new PhoneDependencyManager({
 		stateDir: resolveStateDir(),
 		config: service.currentConfig.runtimeTools,
-		adbPath: service.currentConfig.phone.adbPath
+		adbPath: service.currentConfig.phone.adbPath,
+		phone: service.currentConfig.phone
 	});
 	const requireIdle = () => {
 		if (runtime.reports().some((report) => ![
@@ -75,14 +77,26 @@ function createPhoneSetupService(service) {
 		},
 		install: async (kind, repair, mutation) => {
 			mutation?.check();
-			if (kind === "adb") requireIdle();
+			if (kind !== "scrcpy") requireIdle();
 			const config = service.currentConfig;
 			await manager().install(kind, {
 				repair,
 				signal: mutation?.signal,
-				beforeCommit: mutation?.check
+				beforeCommit: () => {
+					mutation?.check();
+					if (kind !== "scrcpy") requireIdle();
+				}
 			});
 			mutation?.check();
+			if (kind === "hdc" || kind === "hoscrcpy" || kind === "java") {
+				const next = structuredClone(config);
+				if (kind === "hdc") next.phone.hdcPath = managedHdcPath();
+				else next.phone.hdcVideo = {
+					...next.phone.hdcVideo,
+					...kind === "java" ? { javaHome: managedJavaHome() } : { sdkJar: managedHosJar() }
+				};
+				if (!(await service.saveConfig(next, config, mutation?.check)).saved) throw new Error("PHONE_SETUP_CONFIG_CONFLICT");
+			}
 			if (kind === "adb" && config.phone.adbPath) {
 				const path = managedPhoneAdbPath(resolveStateDir());
 				await probePhoneAdb(path);
@@ -92,16 +106,17 @@ function createPhoneSetupService(service) {
 				if (!(await service.saveConfig(next, config, mutation?.check)).saved) throw new Error("PHONE_SETUP_CONFIG_CONFLICT");
 			}
 		},
-		registerLocal: async (serial, name, mutation) => {
-			const discovered = (await runtime.discover(service.currentConfig)).find((phone) => phone.serial === serial && phone.state === "device");
+		registerLocal: async (serial, name, mutation, platform = "android") => {
+			const discovered = (await runtime.discover(service.currentConfig, mutation?.signal, platform)).find((phone) => phone.serial === serial && phone.state === "device" && (phone.platform ?? "android") === platform);
 			mutation?.check();
 			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({
+			if (!runtime.repository.list().some((phone) => phone.serial === serial && (phone.platform ?? "android") === platform)) runtime.repository.save({
 				serial,
+				platform,
 				name: name?.trim() || discovered.name,
 				enabled: true,
 				appAccess: "selected",
-				allowedApps: ["com.android.settings"]
+				allowedApps: [platform === "harmonyos" ? "com.huawei.hmos.settings" : "com.android.settings"]
 			});
 		},
 		revision: (context, deviceId) => {
@@ -139,12 +154,17 @@ function createPhoneSetupService(service) {
 			const dependencies = await new PhoneDependencyManager({
 				stateDir: resolveStateDir(),
 				config: config.runtimeTools,
-				adbPath: config.phone.adbPath
-			}).status();
+				adbPath: config.phone.adbPath,
+				phone: config.phone
+			}).status(source === "harmonyos" ? [
+				"hdc",
+				"java",
+				"hoscrcpy"
+			] : source ? ["adb", "scrcpy"] : void 0);
 			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 }) => ({
+			if ((source === "local" || source === "harmonyos") && dependencies.some((item) => item.kind === (source === "harmonyos" ? "hdc" : "adb") && item.state === "ready")) try {
+				localDiscovery = (await runtime.discover(config, void 0, source === "harmonyos" ? "harmonyos" : "android")).map(({ serial, name, state, emulator }) => ({
 					serial,
 					name,
 					state,
@@ -163,18 +183,20 @@ function createPhoneSetupService(service) {
 					supported: Boolean(model && phoneModelProfile(model)),
 					configured: Boolean(model && isProviderConfiguredSync(model.provider))
 				},
-				dependencies: dependencies.map(({ kind, state, version, canInstall }) => ({
+				dependencies: dependencies.map(({ kind, state, version, canInstall, distribution, downloadUrl }) => ({
 					kind,
 					state,
 					version,
-					canInstall
+					canInstall,
+					distribution,
+					downloadUrl
 				})),
 				devices: runtime.repository.list().map((device) => ({
 					id: device.id,
 					name: device.name,
-					source: device.connection ? "aliyun" : "local",
+					source: device.platform === "harmonyos" ? "harmonyos" : device.connection ? "aliyun" : "local",
 					enabled: device.enabled,
-					settingsAllowed: phoneAllowsApp(device, "com.android.settings")
+					settingsAllowed: phoneAllowsApp(device, device.platform === "harmonyos" ? "com.huawei.hmos.settings" : "com.android.settings")
 				})),
 				localDiscovery,
 				diagnostic
@@ -200,7 +222,11 @@ function registerPhoneSetupRoutes(app, deps) {
 		]),
 		modelRef: z.string().min(1).max(500).optional(),
 		replaceExisting: z.boolean().optional(),
-		source: z.enum(["local", "aliyun"]).optional(),
+		source: z.enum([
+			"local",
+			"aliyun",
+			"harmonyos"
+		]).optional(),
 		deviceId: z.string().uuid().optional(),
 		expectedRevision: z.number().int().positive().optional()
 	});

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

@@ -11,6 +11,7 @@ import { getAllModels, init_providers, isProviderConfiguredSync } from "../../..
 import { normalizePhoneAppAccess, phoneAppAccess } from "../../../phone/app-access.js";
 import { cancelPhoneAssistance, pendingPhoneAssistance, phoneAssistance, phoneAssistanceReport } from "../../../phone/assistance.js";
 import { resolveAdbPath } from "../../../phone/adb-driver.js";
+import { resolveHdcVideoTools } from "../../../phone/hdc-video-tools.js";
 import { createPhoneModel } from "../../../phone/model-adapter.js";
 import { getPhoneRuntime, phoneExecutionContext } from "../../../phone/runtime.js";
 import { registerPhoneSetupRoutes } from "./phone-setup.js";
@@ -72,6 +73,7 @@ function registerPhoneRoutes(parent, deps, runtime = getPhoneRuntime()) {
 				body.payload = {
 					ownControl: body.payload.ownControl,
 					textInput: body.payload.textInput,
+					media: body.payload.media,
 					report: {
 						sessionId,
 						deviceId,
@@ -270,12 +272,18 @@ function registerPhoneRoutes(parent, deps, runtime = getPhoneRuntime()) {
 			config: service.currentConfig.phone,
 			defaultDeviceId: runtime.repository.defaultDevice(),
 			runner: "gateway-local",
-			agentId: getDefaultAgentId()
+			agentId: getDefaultAgentId(),
+			hdcVideo: { available: Boolean(resolveHdcVideoTools(service.currentConfig.phone)) }
 		}
 	}));
 	app.patch("/api/phone/settings", strictRateLimitMiddleware, async (c) => {
 		const config = PhoneConfigSchema.parse(await c.req.json());
-		if (!config.enabled || config.adbPath !== service.currentConfig.phone.adbPath) await runtime.shutdown();
+		const videoChanged = [
+			"devecoPath",
+			"javaHome",
+			"sdkJar"
+		].some((key) => config.hdcVideo?.[key] !== service.currentConfig.phone.hdcVideo?.[key]);
+		if (!config.enabled || config.adbPath !== service.currentConfig.phone.adbPath || config.hdcPath !== service.currentConfig.phone.hdcPath || videoChanged) 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");
@@ -286,10 +294,11 @@ function registerPhoneRoutes(parent, deps, runtime = getPhoneRuntime()) {
 		});
 	});
 	app.get("/api/phone/devices", async (c) => {
+		const platform = z.enum(["android", "harmonyos"]).optional().parse(c.req.query("platform"));
 		let discovery = [];
 		let diagnostic;
 		try {
-			discovery = await runtime.discover(service.currentConfig, c.req.raw.signal);
+			discovery = await runtime.discover(service.currentConfig, c.req.raw.signal, platform);
 		} catch (error) {
 			diagnostic = error instanceof PhoneError ? error.code : "PHONE_ADB_UNAVAILABLE";
 		}
@@ -304,7 +313,10 @@ function registerPhoneRoutes(parent, deps, runtime = getPhoneRuntime()) {
 		});
 	});
 	app.get("/api/phone/apps", async (c) => {
-		const input = z.object({ serial: z.string().min(1).max(200) }).strict().parse(c.req.query());
+		const input = z.object({
+			serial: z.string().min(1).max(200),
+			platform: z.enum(["android", "harmonyos"]).optional()
+		}).strict().parse(c.req.query());
 		const applications = await runtime.applications(input, service.currentConfig, c.req.raw.signal);
 		c.header("Cache-Control", "no-store");
 		return c.json({
@@ -330,8 +342,8 @@ 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 wireless = runtime.wireless.known(input.serial);
+		if (!(await runtime.discover(service.currentConfig, c.req.raw.signal, input.platform ?? "android")).some((device) => device.serial === input.serial && (device.platform ?? "android") === (input.platform ?? "android") && device.state === "device")) throw new PhoneError("PHONE_DEVICE_OFFLINE", "Choose a connected and authorized USB device");
+		const wireless = input.platform === "harmonyos" ? void 0 : 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,
@@ -346,7 +358,10 @@ function registerPhoneRoutes(parent, deps, runtime = getPhoneRuntime()) {
 	app.patch("/api/phone/devices/:id", strictRateLimitMiddleware, async (c) => {
 		const id = c.req.param("id");
 		const previous = runtime.repository.get(id);
-		const patch = deviceInput.omit({ serial: true }).partial().parse(await c.req.json());
+		const patch = deviceInput.omit({
+			serial: true,
+			platform: true
+		}).partial().parse(await c.req.json());
 		const next = normalizePhoneAppAccess({
 			...previous,
 			...patch,

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

@@ -6,12 +6,12 @@ import { loadTranscriptRowsForSession } from "../../../storage/sqlite/transcript
 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";

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

@@ -4,6 +4,7 @@ import { conversationIdSchema } from "../../../../packages/gateway-contract/src/
 import { sessionInputCommandSchema, sessionMaterializeCommandSchema } from "../../../../packages/gateway-contract/src/session-input-command.js";
 import { parseUserTurnDocument, userTurnDocumentRefIds } from "../../../../packages/gateway-contract/src/user-turn-document.js";
 import { init_src } from "../../../../packages/gateway-contract/src/index.js";
+import { SessionInputControlConflict, init_session_input_control_repository } from "../../../storage/sqlite/session-input-control-repository.js";
 import { endpointTurnClaimSchema, init_src as init_src$1 } from "../../../../packages/endpoint-tools-protocol/src/index.js";
 import { validateWebchatAttachments, validateWebchatContent } from "../../chat-limits.js";
 import { parseSlashCommand } from "../../../chat-commands/command-parse.js";
@@ -17,11 +18,19 @@ import { browserPageContextToAgentContext } from "../../../agent/source-context/
 import { receiveSessionCommand, sessionCommandSnapshot } from "../../service/session-command-service.js";
 import { z } from "zod";
 //#region src/gateway/hono/routes/session-command-handler.ts
+init_session_input_control_repository();
 init_src();
 init_src$1();
 init_logger();
 const log = createLogger("Gateway:SessionCommand");
 function commandError(c, error) {
+	if (error instanceof SessionInputControlConflict) return c.json({
+		ok: false,
+		error: {
+			code: "CONTROL_CHANGED",
+			message: error.message
+		}
+	}, 409);
 	if (error instanceof SessionCommandError) {
 		const status = error.code === "BAD_REQUEST" ? 400 : error.code === "SESSION_DELETED" ? 410 : error.code === "FORBIDDEN" ? 403 : error.code === "NOT_FOUND" ? 404 : 409;
 		return c.json({

package/dist/src/gateway/hono/routes/session-input-control.d.ts

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

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

@@ -0,0 +1,37 @@
+import { sessionInputControlCommandSchema } from "../../../../packages/gateway-contract/src/session-input-command.js";
+import { init_src } from "../../../../packages/gateway-contract/src/index.js";
+import { SessionInputControlConflict, init_session_input_control_repository } from "../../../storage/sqlite/session-input-control-repository.js";
+//#region src/gateway/hono/routes/session-input-control.ts
+init_src();
+init_session_input_control_repository();
+function registerSessionInputControlRoutes(authenticated, { service, chatRateLimitMiddleware }) {
+	authenticated.post("/api/sessions/:conversationId/input-control", chatRateLimitMiddleware, async (c) => {
+		const command = sessionInputControlCommandSchema.safeParse(await c.req.json().catch(() => null));
+		if (!command.success) return c.json({
+			ok: false,
+			error: {
+				code: "BAD_REQUEST",
+				message: "Invalid input control"
+			}
+		}, 400);
+		try {
+			const state = await service.controlSessionInputs(c.req.param("conversationId"), command.data);
+			return c.json({
+				ok: true,
+				payload: state
+			}, state.control.phase === "stopping" ? 202 : 200);
+		} catch (error) {
+			if (!(error instanceof SessionInputControlConflict)) throw error;
+			return c.json({
+				ok: false,
+				error: {
+					code: "CONFLICT",
+					message: error.message
+				},
+				payload: service.getSessionInputState(c.req.param("conversationId"))
+			}, 409);
+		}
+	});
+}
+//#endregion
+export { registerSessionInputControlRoutes };

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

@@ -27,6 +27,12 @@ export declare function submitSessionInput(c: Context, deps: AuthenticatedRouteD
         ok: true;
         effectiveDelivery: import("../../../storage/sqlite/session-input-repository.js").SessionInputDelivery;
         state: {
+            control: {
+                paused: boolean;
+                version: number;
+                phase: "idle" | "running" | "stopping";
+                reviewRequired: boolean;
+            };
             preparation?: {
                 operationId: string;
                 revision: number;
@@ -189,6 +195,12 @@ export declare function replaceLatestSessionTurn(c: Context, deps: Authenticated
         ok: true;
         effectiveDelivery: "next";
         state: {
+            control: {
+                paused: boolean;
+                version: number;
+                phase: "idle" | "running" | "stopping";
+                reviewRequired: boolean;
+            };
             preparation?: {
                 operationId: string;
                 revision: number;

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

@@ -4,10 +4,11 @@ import { browserPageContextsInputSchema } from "../../../../packages/gateway-con
 import { endpointContextSchema } from "../../../../packages/gateway-contract/src/session-input-command.js";
 import { parseUserTurnDocument, userTurnDocumentRefIds } from "../../../../packages/gateway-contract/src/user-turn-document.js";
 import { init_src } from "../../../../packages/gateway-contract/src/index.js";
+import { SessionInputControlConflict, init_session_input_control_repository } from "../../../storage/sqlite/session-input-control-repository.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 { parseTurnContextRefs } from "../../../agent/source-context/types.js";
 import { getModelThinking } from "../../../providers/model-thinking.js";
 import { validateWebchatAttachments, validateWebchatContent } from "../../chat-limits.js";
@@ -21,6 +22,7 @@ import { withModelConfigLock } from "../../../session/model-config-lock.js";
 import { getGatewayPrincipal } from "../../security/gateway-principal.js";
 import { browserPageContextToAgentContext } from "../../../agent/source-context/browser-page.js";
 //#region src/gateway/hono/routes/session-input-handler.ts
+init_session_input_control_repository();
 init_src();
 init_src$1();
 init_providers();
@@ -252,6 +254,15 @@ async function submitSessionInput(c, deps, conversationId, options) {
 				conversationId
 			}
 		}, 202);
+	}).catch((error) => {
+		if (!(error instanceof SessionInputControlConflict)) throw error;
+		return c.json({
+			ok: false,
+			error: {
+				code: "CONTROL_CHANGED",
+				message: error.message
+			}
+		}, 409);
 	});
 }
 async function replaceLatestSessionTurn(c, deps, conversationId, targetTurnId) {
@@ -363,6 +374,8 @@ async function replaceLatestSessionTurn(c, deps, conversationId, targetTurnId) {
 		const result = await deps.service.replaceLatestSessionTurn({
 			conversationId,
 			targetTurnId,
+			expectedTranscriptId: typeof body.expectedTranscriptId === "string" ? body.expectedTranscriptId : void 0,
+			controlVersion: typeof body.controlVersion === "number" ? body.controlVersion : void 0,
 			clientMessageId: typeof body.clientMessageId === "string" ? body.clientMessageId : "",
 			delivery: "next",
 			content,
@@ -392,6 +405,15 @@ async function replaceLatestSessionTurn(c, deps, conversationId, targetTurnId) {
 				conversationId
 			}
 		}, 202);
+	}).catch((error) => {
+		if (!(error instanceof SessionInputControlConflict)) throw error;
+		return c.json({
+			ok: false,
+			error: {
+				code: "CONTROL_CHANGED",
+				message: error.message
+			}
+		}, 409);
 	});
 }
 //#endregion

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

@@ -122,6 +122,7 @@ function registerSessionsRoutes(authenticated, deps) {
 				includePinned: true,
 				includeConversationId,
 				rootConversationsOnly: true,
+				excludeAutomationRuns: true,
 				sortBy: "updatedAt",
 				sortOrder: "desc"
 			});
@@ -141,6 +142,7 @@ function registerSessionsRoutes(authenticated, deps) {
 			includePinned: true,
 			includeConversationId,
 			rootConversationsOnly: true,
+			excludeAutomationRuns: true,
 			sortBy: "updatedAt",
 			sortOrder: "desc"
 		});
@@ -161,6 +163,7 @@ function registerSessionsRoutes(authenticated, deps) {
 			includePinned: true,
 			includeConversationId,
 			rootConversationsOnly: true,
+			excludeAutomationRuns: true,
 			sortBy: "updatedAt",
 			sortOrder: "desc"
 		})).items, pinnedLayout, (session) => session.key);
@@ -277,6 +280,7 @@ function registerSessionsRoutes(authenticated, deps) {
 			sources: query.sources?.split(","),
 			purposes: query.purposes?.split(","),
 			activity: query.activity,
+			excludeAutomationRuns: query.excludeAutomationRuns === "true",
 			agentId: query.agentId,
 			excludeArchived: query.excludeArchived === "true"
 		});

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

@@ -6,9 +6,9 @@ import { hasGatewayScope } from "../../security/gateway-scopes.js";
 import { enqueueTaskChangedEvent, init_task_change_events } from "../../../tasks/task-change-events.js";
 import { TaskRepository, init_task_repository } from "../../../tasks/task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "../../../tasks/task-run-repository.js";
-import { TaskConversationRepository } from "../../../tasks/task-conversation-repository.js";
 import { CapabilityError } from "../../../capabilities/runtime/errors.js";
 import "../../../capabilities/runtime/dispatcher.js";
+import { TaskConversationRepository } from "../../../tasks/task-conversation-repository.js";
 import { TaskCriterionReviewRepository } from "../../../tasks/task-criterion-review-repository.js";
 import { TaskContextMutationOutputSchema } from "../../../tasks/capabilities/relations.js";
 import { TaskDeleteOutputSchema } from "../../../tasks/capabilities/management.js";

package/dist/src/gateway/image-generation-setup.js

@@ -1,11 +1,11 @@
 import { normalizeAgentId } from "../agent-catalog/id.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
 import { init_agent_scope } from "../agent/agent-scope.js";
+import { AgentCatalogService } from "../agent-catalog/service.js";
 import { ConfigSchema, init_schema } from "../config/schema.js";
 import { resolveEffectiveAgentConfigForAgent } from "../config/agent-profile.js";
 import { fetchWithTimeoutGuarded } from "../media-shared/http/provider-http.js";
 import "../media-shared/http/index.js";
-import { AgentCatalogService } from "../agent-catalog/service.js";
 import { getImageGenerationProvider, listImageGenerationProvidersSummary } from "../agent/image/generation/provider-registry.js";
 //#region src/gateway/image-generation-setup.ts
 init_repository();