@xopcai/xopc 0.0.432 → 0.0.434

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

@@ -7,8 +7,9 @@ import { resolveEffectiveAgentConfigForAgent } from "../../../config/agent-profi
 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 "../../../phone/model-adapter.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 { PhoneSetupService } from "../../../phone/setup/service.js";
 import { PhoneDependencyManager, probePhoneAdb } from "../../../runtime-tools/phone-dependencies.js";
@@ -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

@@ -3,15 +3,16 @@ import { init_logger } from "../../../utils/logger.js";
 import { setDevicePhoneAccess } from "../../../storage/sqlite/device-access-repository.js";
 import { getSessionMetadata } from "../../../storage/sqlite/session-read-repository.js";
 import { init_session_repository } from "../../../storage/sqlite/session-repository.js";
-import { createConversation, init_conversation_repository } from "../../../storage/sqlite/conversation-repository.js";
 import { MOCK_PHONE_MODEL, PhoneActionSchema, PhoneConfigSchema, PhoneDeviceSchema, PhoneError, PhoneExecutionModeSchema, PhoneInputSchema, init_contracts } from "../../../phone/contracts.js";
+import { createConversation, init_conversation_repository } from "../../../storage/sqlite/conversation-repository.js";
 import { getDefaultAgentId, init_resolve_route } from "../../../routing/resolve-route.js";
 import { phoneModelProfile } from "../../../phone/model-policy.js";
 import { getAllModels, init_providers, isProviderConfiguredSync } from "../../../providers/index.js";
 import { normalizePhoneAppAccess, phoneAppAccess } from "../../../phone/app-access.js";
-import { createPhoneModel } from "../../../phone/model-adapter.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";
 import { getGatewayPrincipal } from "../../security/gateway-principal.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

@@ -8,6 +8,9 @@ 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 { ProjectWorkspaceConflictError, ProjectWorkspaceMissingError } from "../../../projects/workspace-project.js";
 import { inferProjectExecutionMode, inferProjectKind } from "../../../projects/project-kind.js";
@@ -15,13 +18,10 @@ import { ProjectDeletionBlockedError, ProjectWorkspaceInUseError } from "../../.
 import { resolveProjectAgentId } from "../../../projects/project-agent.js";
 import { inferSuggestedProjectDefaultAgentId } from "../../../projects/project-agent-suggestion.js";
 import { buildProjectLoopOverview } from "../../../projects/project-loop.js";
-import { resolveEffectiveAgentProfile } from "../../../config/agent-profile.js";
 import "../../../projects/index.js";
 import { TaskApplicationService } from "../../../tasks/task-application-service.js";
-import { listKnowledgeItems, writeKnowledgeItem } from "../../../knowledge-memory/repository.js";
-import "../../../knowledge-memory/index.js";
-import { defineTaskContract } from "../../../tasks/task-contract-definition.js";
 import { createProductDispatcher } from "../../../capabilities/runtime/product.js";
+import { defineTaskContract } from "../../../tasks/task-contract-definition.js";
 import { ProjectOperatingViewService, summarizeProjectOperatingView } from "../../../tasks/project-operating-view-service.js";
 import "../../../tasks/index.js";
 import { parseActivityIncludeRelated, parseActivityQuery } from "./activity.js";

package/dist/src/gateway/hono/routes/runtime-tools.js

@@ -1,7 +1,7 @@
 import { init_paths_state, resolveStateDir } from "../../../config/paths-state.js";
+import { RuntimeToolsConfigSchema, init_schema } from "../../../config/schema.js";
 import { normalizeRuntimeVersionRequest } from "../../../runtime-tools/probe.js";
 import { ManagedRuntimeManager } from "../../../runtime-tools/manager.js";
-import { RuntimeToolsConfigSchema, init_schema } from "../../../config/schema.js";
 import { createGatewayRouteLogger } from "../lib/route-logger.js";
 import { pruneRuntimeTools } from "../../../runtime-tools/prune.js";
 import { registerPhoneDependencyRoutes } from "./phone-dependencies.js";

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

@@ -4,24 +4,33 @@ 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";
 import { commandRegistry } from "../../../chat-commands/registry.js";
 import "../../../chat-commands/index.js";
-import { deviceTurnSourceContext, endpointClaimBelongsToPrincipal } from "../../../endpoint-tools/turn-context.js";
-import { validateWebchatAttachments, validateWebchatContent } from "../../chat-limits.js";
 import { isVoiceLikeAttachment } from "../../../channels/attachments/voice-stt-webchat.js";
+import { deviceTurnSourceContext, endpointClaimBelongsToPrincipal } from "../../../endpoint-tools/turn-context.js";
 import { SessionCommandError, getSessionInputReceipt, isConversationDeleted, retrySessionPreparation } from "../../../storage/sqlite/session-creation-repository.js";
 import { getGatewayPrincipal } from "../../security/gateway-principal.js";
 import { browserPageContextToAgentContext } from "../../../agent/source-context/browser-page.js";
 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,23 +4,25 @@ 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 { CapabilityError } from "../../../capabilities/runtime/errors.js";
 import "../../../capabilities/runtime/dispatcher.js";
-import { parseTurnContextRefs } from "../../../agent/source-context/types.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";
+import { isTaskDestructiveCommand } from "../../../session/reset-triggers.js";
 import { parseSlashCommand } from "../../../chat-commands/command-parse.js";
 import { commandRegistry } from "../../../chat-commands/registry.js";
 import "../../../chat-commands/index.js";
-import { deviceTurnSourceContext, endpointClaimBelongsToPrincipal } from "../../../endpoint-tools/turn-context.js";
-import { validateWebchatAttachments, validateWebchatContent } from "../../chat-limits.js";
-import { isTaskDestructiveCommand } from "../../../session/reset-triggers.js";
-import { getModelThinking } from "../../../providers/model-thinking.js";
 import { isVoiceLikeAttachment } from "../../../channels/attachments/voice-stt-webchat.js";
+import { deviceTurnSourceContext, endpointClaimBelongsToPrincipal } from "../../../endpoint-tools/turn-context.js";
 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

@@ -3,11 +3,11 @@ import { SessionDiscoveryQuerySchema } from "../../../../packages/gateway-contra
 import { init_src } from "../../../../packages/gateway-contract/src/index.js";
 import "../../../session/types.js";
 import { SidebarLayoutConflictError, getSidebarLayout, replaceSidebarLayout, sortBySidebarLayout } from "../../../storage/sqlite/sidebar-layout-repository.js";
-import { isPersonalConversation } from "../../../personal-agent/repository.js";
 import { summarizeAiUsageByConversations } from "../../../storage/sqlite/ai-usage-repository.js";
-import { SessionEnvironmentService } from "../../../execution-environments/session-environment-service.js";
-import { evictEmbeddedSessionRunner } from "../../../agent/embedded/session-runner.js";
+import { isPersonalConversation } from "../../../personal-agent/repository.js";
 import { messagesToClientHistory } from "../../../session/client-history.js";
+import { evictEmbeddedSessionRunner } from "../../../agent/embedded/session-runner.js";
+import { SessionEnvironmentService } from "../../../execution-environments/session-environment-service.js";
 import { deleteMediaUrisNoLongerReferenced } from "../../../media/session-references.js";
 import { getGatewayPrincipal } from "../../security/gateway-principal.js";
 import { createGatewayRouteLogger, logRouteError } from "../lib/route-logger.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/shares.js

@@ -4,7 +4,6 @@ import "../../../storage/sqlite/index.js";
 import { FileServiceError } from "../../../files/file-service.js";
 import { resolveReverseProxyPublicUrl } from "../../public-url.js";
 import { resolveGatewayEffectiveHost } from "../../../config/gateway-bind.js";
-import { getGatewayFileSpaceService } from "../../file-space-service.js";
 import { SHARE_CONFIG_DEFAULTS } from "../../../share/share-types.js";
 import { resolveSiteShareConfig } from "../../../share/site-share-config.js";
 import { logShareAudit } from "../../../share/share-audit.js";
@@ -17,6 +16,7 @@ import { HostedStaticSitePublicationBuilder } from "../../../share/hosted-static
 import { publishHostedStaticSite } from "../../../share/hosted-static-site-publish.js";
 import { audienceDefaults, cleanupStagedSite, decideShareKind, forgetStagedSite, makeDescription, makeTitle, probeShareTarget, rememberStagedSite, stageSingleHtmlAsSite } from "../../../share/share-auto.js";
 import { deleteThumbnail, placeholderSvg, readThumbnail, scheduleThumbnail, thumbnailContentType, thumbnailExists } from "../../../share/share-thumbnail.js";
+import { getGatewayFileSpaceService } from "../../file-space-service.js";
 import { SHARED_HTML_CSP } from "../../security/csp.js";
 import { getGatewayPrincipal } from "../../security/gateway-principal.js";
 import { renderFolderLandingPage, renderShareExpiredPage, renderShareLandingPage, renderSnapshotShareLandingPage } from "../../../share/share-landing.js";

package/dist/src/gateway/hono/routes/side-chats.js

@@ -2,8 +2,8 @@ import { chooseModelThinking } from "../../../../packages/gateway-contract/src/m
 import { clarificationSubmissionSchema } from "../../../../packages/gateway-contract/src/clarifications.js";
 import { init_src } from "../../../../packages/gateway-contract/src/index.js";
 import { init_providers, resolveModel } from "../../../providers/index.js";
-import { validateWebchatAttachments, validateWebchatContent } from "../../chat-limits.js";
 import { getModelThinking } from "../../../providers/model-thinking.js";
+import { validateWebchatAttachments, validateWebchatContent } from "../../chat-limits.js";
 import { validateSideChatSelections } from "../../side-chat/context-snapshot.js";
 import { SideChatError, parseThinkingLevel } from "../../side-chat/manager.js";
 import "../../side-chat/index.js";

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

@@ -8,11 +8,11 @@ import { TaskRepository, init_task_repository } from "../../../tasks/task-reposi
 import { TaskRunRepository, init_task_run_repository } from "../../../tasks/task-run-repository.js";
 import { CapabilityError } from "../../../capabilities/runtime/errors.js";
 import "../../../capabilities/runtime/dispatcher.js";
-import { TaskCollaborationRepository } from "../../../tasks/task-collaboration-repository.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";
+import { TaskCollaborationRepository } from "../../../tasks/task-collaboration-repository.js";
 import { TaskMutationOutputSchema } from "../../../tasks/capabilities/write.js";
 import { createProductDispatcher } from "../../../capabilities/runtime/product.js";
 import { ProjectOperatingViewService } from "../../../tasks/project-operating-view-service.js";

package/dist/src/gateway/hono/routes/user-model.js

@@ -1,20 +1,20 @@
 import { init_transaction, runSqliteWriteTransaction } from "../../../storage/sqlite/transaction.js";
 import { createCollaborationRule, getCollaborationRule, listCollaborationRules, setCollaborationRuleStatus } from "../../../storage/sqlite/collaboration-rule-repository.js";
+import { getActiveUnderstandingConsent } from "../../../user-context/sources/consent-repository.js";
+import { KnowledgeReviewConflictError, deleteKnowledgeItem, getKnowledgeItem, listKnowledgeItems, reviewKnowledgeItem, searchKnowledgeItems } from "../../../knowledge-memory/repository.js";
+import "../../../knowledge-memory/index.js";
+import { createPriorityWindow, createUserGoal, listPriorityWindows, listUserGoals, setUserGoalStatus, updatePriorityWindow, updateUserGoal } from "../../../user-model/goals.js";
 import { deleteUserAssertion, getAssertionSlot, getUserAssertion, listUserAssertionSources, listUserAssertions, reconcileAssertion, setAssertionStatus, setUserAssertionScope } from "../../../user-model/repository.js";
-import { applyUserProfilePatch, getUserProfileSnapshot } from "../../../user-model/profile.js";
 import { listActionRuleSuggestions } from "../../../user-model/action-rule-suggestions.js";
-import { createPriorityWindow, createUserGoal, listPriorityWindows, listUserGoals, setUserGoalStatus, updatePriorityWindow, updateUserGoal } from "../../../user-model/goals.js";
 import { listUserAssertionEdges, listUserModelObservations } from "../../../user-model/observation-repository.js";
+import { applyUserProfilePatch, getUserProfileSnapshot } from "../../../user-model/profile.js";
 import { bootstrapUserModel } from "../../../user-model/bootstrap.js";
-import { getActiveUnderstandingConsent } from "../../../user-context/sources/consent-repository.js";
 import { canUseAssertion } from "../../../user-model/usage-policy.js";
 import "../../../user-model/index.js";
-import { listUnderstandingSourceGrants } from "../../../user-context/sources/repository.js";
-import { KnowledgeReviewConflictError, deleteKnowledgeItem, getKnowledgeItem, listKnowledgeItems, reviewKnowledgeItem, searchKnowledgeItems } from "../../../knowledge-memory/repository.js";
-import "../../../knowledge-memory/index.js";
-import { getExecutionContextAudit, recordExecutionContextFeedback } from "../../../agent/context/audit.js";
 import { listMemoryMaintenanceRuns } from "../../../memory-maintenance/service.js";
 import "../../../memory-maintenance/index.js";
+import { getExecutionContextAudit, recordExecutionContextFeedback } from "../../../agent/context/audit.js";
+import { listUnderstandingSourceGrants } from "../../../user-context/sources/repository.js";
 import { registerMemoryLearningRoutes } from "./memory-learning.js";
 import { userInfo } from "node:os";
 //#region src/gateway/hono/routes/user-model.ts

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

@@ -1,22 +1,22 @@
-import { isPersonalConversation } from "../../../personal-agent/repository.js";
 import { init_model_usage, withModelUsageOrigin } from "../../../providers/model-usage.js";
 import { voiceSelectionSchema } from "../../../../packages/realtime-protocol/src/voice-catalog.js";
 import { VOICE_TIMING_METRICS, createVoiceSessionRequestSchema, init_voice } from "../../../../packages/realtime-protocol/src/voice.js";
 import { getDefaultModelSync, init_providers, resolveModel } from "../../../providers/index.js";
 import { completeWithResolvedCredentials } from "../../../providers/model-call.js";
+import { isPersonalConversation } from "../../../personal-agent/repository.js";
 import { PlatformVoiceError } from "../../../voice/platform-streams.js";
-import { resolveTtsProviderConfigSlice } from "../../../voice/tts/config-slice.js";
-import { isTTSAvailable, resolveSpeechProvider } from "../../../voice/tts/factory.js";
-import { mergeTtsConfigFromAppConfig } from "../../../voice/tts/merge-config.js";
-import { speak, speakStream } from "../../../voice/tts/speak-core.js";
 import { resolveSttProviderConfigSlice } from "../../../voice/stt/config-slice.js";
 import { resolveSTTProviderChain } from "../../../voice/stt/factory.js";
-import { isSTTAvailable } from "../../../voice/stt/availability.js";
-import "../../../voice/tts/index.js";
 import { STTTranscriptionError, transcribe } from "../../../voice/stt/transcribe-core.js";
+import { isSTTAvailable } from "../../../voice/stt/availability.js";
 import { mergeSttConfigFromAppConfig } from "../../../voice/stt/config.js";
 import "../../../voice/stt/index.js";
+import { resolveTtsProviderConfigSlice } from "../../../voice/tts/config-slice.js";
+import { isTTSAvailable, resolveSpeechProvider } from "../../../voice/tts/factory.js";
+import { speak, speakStream } from "../../../voice/tts/speak-core.js";
+import { mergeTtsConfigFromAppConfig } from "../../../voice/tts/merge-config.js";
 import { listSttProvidersForApi } from "../../../voice/stt/list-providers.js";
+import "../../../voice/tts/index.js";
 import { withModelConfigLock } from "../../../session/model-config-lock.js";
 import { getSessionPreparation } from "../../../storage/sqlite/session-creation-repository.js";
 import { resolveOmniRoute } from "../../../voice/realtime/omniRoute.js";