@dipoleml/dcode-cli 1.0.0 → 1.2.0

package/node_modules/@dcode/shared/dist/validationAppSettings.d.ts

@@ -1,6 +1,5 @@
 import { z } from "zod";
 export declare const appSettingsOccupationEnum: z.ZodEnum<{
-    other: "other";
     office: "office";
     developer: "developer";
     independent: "independent";
@@ -14,9 +13,10 @@ export declare const appSettingsOccupationEnum: z.ZodEnum<{
     finance: "finance";
     accounting: "accounting";
     legal: "legal";
+    other: "other";
 }>;
 export declare const localeSchema: z.ZodEnum<{
-    "zh-CN": "zh-CN";
+    "fr-CA": "fr-CA";
     "en-US": "en-US";
 }>;
 export declare const integratedTerminalShellSelectionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -37,7 +37,7 @@ export declare const postUpdateReleaseNotesPayloadSchema: z.ZodObject<{
     markdown: z.ZodString;
     releaseDate: z.ZodOptional<z.ZodString>;
     releaseNotesByLocale: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
-        "zh-CN": "zh-CN";
+        "fr-CA": "fr-CA";
         "en-US": "en-US";
     }> & z.core.$partial, z.ZodObject<{
         title: z.ZodString;
@@ -46,15 +46,15 @@ export declare const postUpdateReleaseNotesPayloadSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const appSettingsSchema: z.ZodPreprocess<z.ZodObject<{
     recentProjects: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    locale: z.ZodDefault<z.ZodEnum<{
-        "zh-CN": "zh-CN";
+    locale: z.ZodCatch<z.ZodEnum<{
+        "fr-CA": "fr-CA";
         "en-US": "en-US";
     }>>;
     shortcutBindings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
     localePreference: z.ZodDefault<z.ZodEnum<{
-        "zh-CN": "zh-CN";
-        "en-US": "en-US";
         system: "system";
+        "fr-CA": "fr-CA";
+        "en-US": "en-US";
     }>>;
     terminalInheritSystemProfile: z.ZodDefault<z.ZodBoolean>;
     terminalFontFamily: z.ZodOptional<z.ZodString>;
@@ -98,6 +98,7 @@ export declare const appSettingsSchema: z.ZodPreprocess<z.ZodObject<{
     taskAutoArchiveOlderThanDays: z.ZodDefault<z.ZodNumber>;
     closeToTrayOnWindows: z.ZodDefault<z.ZodBoolean>;
     closeToTrayOnWindowsMigrationInitialized: z.ZodDefault<z.ZodBoolean>;
+    closeToTrayLinuxMigrationInitialized: z.ZodDefault<z.ZodBoolean>;
     keepAwakeWhileRunning: z.ZodDefault<z.ZodBoolean>;
     desktopZoomLevel: z.ZodOptional<z.ZodNumber>;
     desktopWindowSize: z.ZodOptional<z.ZodObject<{
@@ -118,6 +119,18 @@ export declare const appSettingsSchema: z.ZodPreprocess<z.ZodObject<{
     }>>;
     askUserQuestionAutoResolutionEnabled: z.ZodDefault<z.ZodBoolean>;
     modelIoFullRetentionEnabled: z.ZodDefault<z.ZodBoolean>;
+    dynamicWorkflowMode: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
+        disabled: "disabled";
+        onDemand: "onDemand";
+        alwaysOn: "alwaysOn";
+    }>>>;
+    enabledBuiltinAgentCliProviders: z.ZodDefault<z.ZodPipe<z.ZodArray<z.ZodEnum<{
+        glm: "glm";
+        claude: "claude";
+        opencode: "opencode";
+        gemini: "gemini";
+        codex: "codex";
+    }>>, z.ZodTransform<"glm"[], ("glm" | "claude" | "opencode" | "gemini" | "codex")[]>>>;
     startPlanRecommendationDismissed: z.ZodDefault<z.ZodBoolean>;
     providerFamilyConnectionSelections: z.ZodDefault<z.ZodObject<{
         dcode: z.ZodOptional<z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -149,7 +162,6 @@ export declare const appSettingsSchema: z.ZodPreprocess<z.ZodObject<{
     providerFamilyDomainMigrated: z.ZodDefault<z.ZodBoolean>;
     nativeSearchEnhancementsEnabled: z.ZodDefault<z.ZodBoolean>;
     onboardingOccupation: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        other: "other";
         office: "office";
         developer: "developer";
         independent: "independent";
@@ -163,6 +175,7 @@ export declare const appSettingsSchema: z.ZodPreprocess<z.ZodObject<{
         finance: "finance";
         accounting: "accounting";
         legal: "legal";
+        other: "other";
     }>>>;
     proactiveSuggestionsEnabled: z.ZodOptional<z.ZodBoolean>;
     memoryEnabled: z.ZodDefault<z.ZodBoolean>;
@@ -201,6 +214,13 @@ export declare const appSettingsSchema: z.ZodPreprocess<z.ZodObject<{
         }, z.core.$strip>, z.ZodObject<{
             kind: z.ZodLiteral<"docker">;
             container: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"server">;
+            url: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            workspacePath: z.ZodOptional<z.ZodString>;
+            serverId: z.ZodOptional<z.ZodString>;
+            tokenCredentialKey: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>], "kind">;
         lastOpenedAt: z.ZodNumber;
         lastConnectionStatus: z.ZodEnum<{
@@ -218,7 +238,7 @@ export declare const appSettingsSchema: z.ZodPreprocess<z.ZodObject<{
         markdown: z.ZodString;
         releaseDate: z.ZodOptional<z.ZodString>;
         releaseNotesByLocale: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
-            "zh-CN": "zh-CN";
+            "fr-CA": "fr-CA";
             "en-US": "en-US";
         }> & z.core.$partial, z.ZodObject<{
             title: z.ZodString;
@@ -232,19 +252,27 @@ export declare const appSettingsSchema: z.ZodPreprocess<z.ZodObject<{
         stable: "stable";
     }> & z.core.$partial, z.ZodString>>;
     settingsSyncFirstRunPromptHandled: z.ZodOptional<z.ZodBoolean>;
+    webRemoteControlExternalRelayDevice: z.ZodOptional<z.ZodObject<{
+        deviceSid: z.ZodString;
+    }, z.core.$strip>>;
+    webRemoteControlLastEnabledContext: z.ZodOptional<z.ZodObject<{
+        workspacePath: z.ZodString;
+        workspaceIdentity: z.ZodOptional<z.ZodString>;
+        initialTaskId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     dcodeEndpointOrigin: z.ZodOptional<z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>>;
 }, z.core.$strip>, unknown>;
 export declare const appSettingsPatchSchema: z.ZodObject<{
     recentProjects: z.ZodOptional<z.ZodArray<z.ZodString>>;
     locale: z.ZodOptional<z.ZodEnum<{
-        "zh-CN": "zh-CN";
+        "fr-CA": "fr-CA";
         "en-US": "en-US";
     }>>;
     shortcutBindings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
     localePreference: z.ZodOptional<z.ZodEnum<{
-        "zh-CN": "zh-CN";
-        "en-US": "en-US";
         system: "system";
+        "fr-CA": "fr-CA";
+        "en-US": "en-US";
     }>>;
     terminalInheritSystemProfile: z.ZodOptional<z.ZodBoolean>;
     terminalFontFamily: z.ZodOptional<z.ZodString>;
@@ -289,6 +317,7 @@ export declare const appSettingsPatchSchema: z.ZodObject<{
     closeToTrayOnWindows: z.ZodOptional<z.ZodBoolean>;
     keepAwakeWhileRunning: z.ZodOptional<z.ZodBoolean>;
     closeToTrayOnWindowsMigrationInitialized: z.ZodOptional<z.ZodBoolean>;
+    closeToTrayLinuxMigrationInitialized: z.ZodOptional<z.ZodBoolean>;
     desktopZoomLevel: z.ZodOptional<z.ZodNumber>;
     desktopWindowSize: z.ZodOptional<z.ZodObject<{
         width: z.ZodNumber;
@@ -308,6 +337,18 @@ export declare const appSettingsPatchSchema: z.ZodObject<{
     }>>;
     askUserQuestionAutoResolutionEnabled: z.ZodOptional<z.ZodBoolean>;
     modelIoFullRetentionEnabled: z.ZodOptional<z.ZodBoolean>;
+    dynamicWorkflowMode: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        disabled: "disabled";
+        onDemand: "onDemand";
+        alwaysOn: "alwaysOn";
+    }>, z.ZodLiteral<"">]>>;
+    enabledBuiltinAgentCliProviders: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodEnum<{
+        glm: "glm";
+        claude: "claude";
+        opencode: "opencode";
+        gemini: "gemini";
+        codex: "codex";
+    }>>, z.ZodTransform<"glm"[], ("glm" | "claude" | "opencode" | "gemini" | "codex")[]>>>;
     startPlanRecommendationDismissed: z.ZodOptional<z.ZodBoolean>;
     providerFamilyConnectionSelections: z.ZodOptional<z.ZodObject<{
         dcode: z.ZodOptional<z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -339,7 +380,6 @@ export declare const appSettingsPatchSchema: z.ZodObject<{
     providerFamilyDomainMigrated: z.ZodOptional<z.ZodBoolean>;
     nativeSearchEnhancementsEnabled: z.ZodOptional<z.ZodBoolean>;
     onboardingOccupation: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        other: "other";
         office: "office";
         developer: "developer";
         independent: "independent";
@@ -353,6 +393,7 @@ export declare const appSettingsPatchSchema: z.ZodObject<{
         finance: "finance";
         accounting: "accounting";
         legal: "legal";
+        other: "other";
     }>>>;
     proactiveSuggestionsEnabled: z.ZodOptional<z.ZodBoolean>;
     memoryEnabled: z.ZodOptional<z.ZodBoolean>;
@@ -391,6 +432,13 @@ export declare const appSettingsPatchSchema: z.ZodObject<{
         }, z.core.$strip>, z.ZodObject<{
             kind: z.ZodLiteral<"docker">;
             container: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"server">;
+            url: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            workspacePath: z.ZodOptional<z.ZodString>;
+            serverId: z.ZodOptional<z.ZodString>;
+            tokenCredentialKey: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>], "kind">;
         lastOpenedAt: z.ZodNumber;
         lastConnectionStatus: z.ZodEnum<{
@@ -408,7 +456,7 @@ export declare const appSettingsPatchSchema: z.ZodObject<{
         markdown: z.ZodString;
         releaseDate: z.ZodOptional<z.ZodString>;
         releaseNotesByLocale: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
-            "zh-CN": "zh-CN";
+            "fr-CA": "fr-CA";
             "en-US": "en-US";
         }> & z.core.$partial, z.ZodObject<{
             title: z.ZodString;
@@ -422,6 +470,14 @@ export declare const appSettingsPatchSchema: z.ZodObject<{
         stable: "stable";
     }> & z.core.$partial, z.ZodString>>;
     settingsSyncFirstRunPromptHandled: z.ZodOptional<z.ZodBoolean>;
+    webRemoteControlExternalRelayDevice: z.ZodOptional<z.ZodObject<{
+        deviceSid: z.ZodString;
+    }, z.core.$strip>>;
+    webRemoteControlLastEnabledContext: z.ZodOptional<z.ZodObject<{
+        workspacePath: z.ZodString;
+        workspaceIdentity: z.ZodOptional<z.ZodString>;
+        initialTaskId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     dcodeEndpointOrigin: z.ZodOptional<z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>>;
 }, z.core.$strip>;
 //# sourceMappingURL=validationAppSettings.d.ts.map

package/node_modules/@dcode/shared/dist/validationAppSettings.js

@@ -3,6 +3,8 @@ import { z } from "zod";
 import { REMOTE_ASSET_INSTALL_MODES } from "./remoteAssetInstallMode.js";
 import { isKnownRemoteResourcePackageId } from "./remoteResourcePackages.js";
 import { wslUserSchema } from "./wslUserValidation.js";
+import { DCODE_ENABLED_AGENT_PROVIDERS } from "./dcode-agent-policy.js";
+import { DYNAMIC_WORKFLOW_MODES } from "./dynamic-workflow-feature.js";
 import { normalizeDCodeEndpointOrigin } from "./dcodeEndpoint.js";
 import { DEFAULT_EMBEDDED_BROWSER_VIEWPORT_PREFERENCE, embeddedBrowserViewportPreferenceSchema, } from "./browser-use/command-metadata.js";
 import { providerFamilyConnectionSelectionSettingsSchema } from "./provider-family-connection-selection.js";
@@ -25,9 +27,12 @@ const appSettingsOccupationSchema = z.enum([
 ]);
 export const appSettingsOccupationEnum = appSettingsOccupationSchema;
 const nonEmptyStringSchema = z.string().trim().min(1);
-export const localeSchema = z.enum(["zh-CN", "en-US"]);
-const localePreferenceSchema = z.enum(["system", "zh-CN", "en-US"]);
+export const localeSchema = z.enum(["fr-CA", "en-US"]);
+const localePreferenceSchema = z.enum(["system", "fr-CA", "en-US"]);
 const dcodeInteractionBehaviorSchema = z.enum(["queue", "guide"]);
+// launch.md「The user's choice」：读文件时未知取值（降级后读到新版本写的值）按「跟随」处理，
+// 不能让一个偏好字段把整份设置读坏。
+const dynamicWorkflowModeSettingSchema = z.enum(DYNAMIC_WORKFLOW_MODES).optional().catch(undefined);
 const electronReleaseChannelSchema = z.enum(["stable", "preview"]);
 const desktopZoomLevelSchema = z.number().int().min(-3).max(5);
 const desktopWindowSizeSchema = z.object({
@@ -47,6 +52,10 @@ export const integratedTerminalShellSelectionSchema = z.discriminatedUnion("mode
         path: nonEmptyStringSchema,
     }),
 ]);
+const enabledBuiltinAgentCliProvidersSchema = z
+    // 兼容旧 settings：历史列表可能残留三方 CLI provider，解析后统一归一为 DCode Agent。
+    .array(z.enum(["claude", "opencode", "gemini", "codex", "glm"]))
+    .transform(() => [...DCODE_ENABLED_AGENT_PROVIDERS]);
 const providerFamilyDomainSchema = z.enum(["dcode", "bigmodel"]);
 export const postUpdateReleaseNotesPayloadSchema = z.object({
     version: nonEmptyStringSchema,
@@ -87,6 +96,14 @@ const remoteWorkspaceTargetSchema = z.discriminatedUnion("kind", [
         kind: z.literal("docker"),
         container: nonEmptyStringSchema,
     }),
+    z.object({
+        kind: z.literal("server"),
+        url: z.string().url(),
+        name: nonEmptyStringSchema.optional(),
+        workspacePath: z.string().optional(),
+        serverId: nonEmptyStringSchema.optional(),
+        tokenCredentialKey: nonEmptyStringSchema.optional(),
+    }),
 ]);
 const appWorkspaceSessionEntrySchema = z.discriminatedUnion("kind", [
     z.object({
@@ -105,6 +122,14 @@ const appWorkspaceSessionEntrySchema = z.discriminatedUnion("kind", [
         lastConnectionError: z.string().optional(),
     }),
 ]);
+const webRemoteControlExternalRelayDeviceSchema = z.object({
+    deviceSid: nonEmptyStringSchema,
+});
+const webRemoteControlLastEnabledContextSchema = z.object({
+    workspacePath: nonEmptyStringSchema,
+    workspaceIdentity: nonEmptyStringSchema.optional(),
+    initialTaskId: nonEmptyStringSchema.optional(),
+});
 const dcodeEndpointOriginSchema = z.preprocess((value) => {
     if (typeof value !== "string") {
         return undefined;
@@ -207,19 +232,29 @@ function migrateLegacyLocalePreference(value) {
         return value;
     }
     const raw = value;
-    if ("localePreference" in raw || !("locale" in raw)) {
+    if (!("locale" in raw) && !("localePreference" in raw)) {
         return value;
     }
-    const parsedLocale = localeSchema.safeParse(raw.locale);
-    if (!parsedLocale.success) {
+    // 旧 setting.json 里可能还存着已下线的 locale（如 zh-CN）。直接丢弃会让整份配置
+    // 解析失败、用户设置被整体重置；这里把不可识别的旧值显式迁移到 en-US，
+    // 再交由上层 schema 校验。
+    const normalized = { ...raw };
+    if (typeof normalized.locale === "string" && !localeSchema.safeParse(normalized.locale).success) {
+        normalized.locale = "en-US";
+    }
+    if (typeof normalized.localePreference === "string" &&
+        !localePreferenceSchema.safeParse(normalized.localePreference).success) {
+        normalized.localePreference = "en-US";
+    }
+    if (normalized.locale === raw.locale && normalized.localePreference === raw.localePreference) {
         return value;
     }
-    return {
-        ...raw,
-        // 旧 setting.json 只有 locale，无法区分“用户显式选择 zh-CN”和“默认值 zh-CN”。
+    if (!("localePreference" in normalized) && "locale" in normalized) {
+        // 旧 setting.json 只有 locale，无法区分“用户显式选择”和“默认值”。
         // 对已经落盘的旧配置保留原 locale 作为显式偏好，避免升级后误切到 system。
-        localePreference: parsedLocale.data,
-    };
+        return { ...normalized, localePreference: normalized.locale };
+    }
+    return normalized;
 }
 const legacyRemoteWorkspaceHistoryEntrySchema = z.object({
     id: nonEmptyStringSchema,
@@ -231,6 +266,19 @@ const legacyRemoteWorkspaceHistoryEntrySchema = z.object({
     lastConnectionStatus: z.enum(["connected", "failed"]),
     lastConnectionError: z.string().optional(),
 });
+function migrateLegacyBuiltinAgentCliProviders(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return value;
+    }
+    const raw = value;
+    // Bugfix: 单 DCode Agent 迁移后，旧 setting.json 可能还保存已移除的第三方 CLI provider
+    // 的启用状态。若这些值继续进入 UI / bot 的 provider 选项，会和 server 侧唯一 glm 状态打架。
+    // 这里在 schema 入口统一归一到 DCode Agent，让核心 provider 状态只有一个事实源。
+    return {
+        ...raw,
+        enabledBuiltinAgentCliProviders: [...DCODE_ENABLED_AGENT_PROVIDERS],
+    };
+}
 function stripHistoricalRemoteResourcePackages(target) {
     if (!target || typeof target !== "object" || Array.isArray(target)) {
         return target;
@@ -358,7 +406,7 @@ function migrateLegacyWorkspaceSession(value) {
 }
 const appSettingsObjectSchema = z.object({
     recentProjects: z.array(z.string()).default([]),
-    locale: localeSchema.default("zh-CN"),
+    locale: localeSchema.catch("en-US"),
     // 快捷键用户覆盖（语义校验在 ui/src/shortcuts 生效表阶段容错，schema 只管形状）
     shortcutBindings: z.record(z.string(), z.array(z.string())).optional(),
     localePreference: localePreferenceSchema.default("system"),
@@ -377,6 +425,8 @@ const appSettingsObjectSchema = z.object({
     taskAutoArchiveOlderThanDays: z.number().int().positive().max(365).default(7),
     closeToTrayOnWindows: z.boolean().default(true),
     closeToTrayOnWindowsMigrationInitialized: z.boolean().default(true),
+    // default(false)：新装与存量用户首次启动都视为未归位，由 main 进程按平台决定是否迁移。
+    closeToTrayLinuxMigrationInitialized: z.boolean().default(false),
     keepAwakeWhileRunning: z.boolean().default(false),
     desktopZoomLevel: desktopZoomLevelSchema.optional(),
     desktopWindowSize: desktopWindowSizeSchema.optional(),
@@ -390,6 +440,10 @@ const appSettingsObjectSchema = z.object({
     dcodeInteractionBehavior: dcodeInteractionBehaviorSchema.default("queue"),
     askUserQuestionAutoResolutionEnabled: z.boolean().default(true),
     modelIoFullRetentionEnabled: z.boolean().default(false),
+    dynamicWorkflowMode: dynamicWorkflowModeSettingSchema,
+    enabledBuiltinAgentCliProviders: enabledBuiltinAgentCliProvidersSchema.default([
+        ...DCODE_ENABLED_AGENT_PROVIDERS,
+    ]),
     startPlanRecommendationDismissed: z.boolean().default(false),
     providerFamilyConnectionSelections: providerFamilyConnectionSelectionSettingsSchema.default({}),
     providerFamilyDomain: providerFamilyDomainSchema.optional(),
@@ -408,9 +462,11 @@ const appSettingsObjectSchema = z.object({
     autoDownloadAndInstallUpdates: z.boolean().default(false),
     skippedElectronUpdateVersions: skippedElectronUpdateVersionsSchema,
     settingsSyncFirstRunPromptHandled: z.boolean().optional(),
+    webRemoteControlExternalRelayDevice: webRemoteControlExternalRelayDeviceSchema.optional(),
+    webRemoteControlLastEnabledContext: webRemoteControlLastEnabledContextSchema.optional(),
     dcodeEndpointOrigin: dcodeEndpointOriginSchema.optional(),
 });
-export const appSettingsSchema = z.preprocess((value) => sanitizeEmbeddedBrowserViewportPreference(sanitizeDesktopWindowSize(migrateMessageStreamShowReasoningDefault(migrateCloseToTrayOnWindowsDefault(migrateLegacyLocalePreference(sanitizeDCodeEndpointOrigin(migrateLegacyWorkspaceSession(value))))))), appSettingsObjectSchema);
+export const appSettingsSchema = z.preprocess((value) => sanitizeEmbeddedBrowserViewportPreference(sanitizeDesktopWindowSize(migrateMessageStreamShowReasoningDefault(migrateCloseToTrayOnWindowsDefault(migrateLegacyLocalePreference(sanitizeDCodeEndpointOrigin(migrateLegacyWorkspaceSession(migrateLegacyBuiltinAgentCliProviders(value)))))))), appSettingsObjectSchema);
 export const appSettingsPatchSchema = z.object({
     recentProjects: z.array(z.string()).optional(),
     locale: localeSchema.optional(),
@@ -430,6 +486,7 @@ export const appSettingsPatchSchema = z.object({
     closeToTrayOnWindows: z.boolean().optional(),
     keepAwakeWhileRunning: z.boolean().optional(),
     closeToTrayOnWindowsMigrationInitialized: z.boolean().optional(),
+    closeToTrayLinuxMigrationInitialized: z.boolean().optional(),
     desktopZoomLevel: desktopZoomLevelSchema.optional(),
     desktopWindowSize: desktopWindowSizeSchema.optional(),
     desktopChromiumHardwareAccelerationEnabled: z.boolean().optional(),
@@ -442,6 +499,9 @@ export const appSettingsPatchSchema = z.object({
     dcodeInteractionBehavior: dcodeInteractionBehaviorSchema.optional(),
     askUserQuestionAutoResolutionEnabled: z.boolean().optional(),
     modelIoFullRetentionEnabled: z.boolean().optional(),
+    // 空串是「删除选择、回到跟随」的哨兵：RPC 会吞掉 undefined，normalizeSettingsPatch 把它归一成删除。
+    dynamicWorkflowMode: z.union([z.enum(DYNAMIC_WORKFLOW_MODES), z.literal("")]).optional(),
+    enabledBuiltinAgentCliProviders: enabledBuiltinAgentCliProvidersSchema.optional(),
     startPlanRecommendationDismissed: z.boolean().optional(),
     providerFamilyConnectionSelections: providerFamilyConnectionSelectionSettingsSchema.optional(),
     providerFamilyDomain: z.union([providerFamilyDomainSchema, z.literal("")]).optional(),
@@ -479,6 +539,8 @@ export const appSettingsPatchSchema = z.object({
         .partialRecord(electronReleaseChannelSchema, nonEmptyStringSchema)
         .optional(),
     settingsSyncFirstRunPromptHandled: z.boolean().optional(),
+    webRemoteControlExternalRelayDevice: webRemoteControlExternalRelayDeviceSchema.optional(),
+    webRemoteControlLastEnabledContext: webRemoteControlLastEnabledContextSchema.optional(),
     dcodeEndpointOrigin: dcodeEndpointOriginSchema.optional(),
 });
 //# sourceMappingURL=validationAppSettings.js.map

package/node_modules/@dcode/shared/dist/web-remote-control-heartbeat.d.ts

@@ -0,0 +1,8 @@
+export declare const WEB_REMOTE_CONTROL_HEARTBEAT_INTERVAL_MS = 10000;
+export declare const WEB_REMOTE_CONTROL_HEARTBEAT_JITTER_MS = 2000;
+export declare const WEB_REMOTE_CONTROL_HEARTBEAT_ACK_TIMEOUT_MS = 30000;
+export declare const WEB_REMOTE_CONTROL_RECONNECT_JITTER_MS = 2000;
+export declare function getWebRemoteControlHeartbeatJitterMs(baseIntervalMs?: number, configuredJitterMs?: number): number;
+export declare function getWebRemoteControlHeartbeatDelayMs(baseIntervalMs?: number, configuredJitterMs?: number, random?: () => number): number;
+export declare function getWebRemoteControlReconnectJitterMs(configuredJitterMs?: number, random?: () => number): number;
+//# sourceMappingURL=web-remote-control-heartbeat.d.ts.map

package/node_modules/@dcode/shared/dist/web-remote-control-heartbeat.js

@@ -0,0 +1,40 @@
+export const WEB_REMOTE_CONTROL_HEARTBEAT_INTERVAL_MS = 10_000;
+export const WEB_REMOTE_CONTROL_HEARTBEAT_JITTER_MS = 2_000;
+export const WEB_REMOTE_CONTROL_HEARTBEAT_ACK_TIMEOUT_MS = 30_000;
+export const WEB_REMOTE_CONTROL_RECONNECT_JITTER_MS = 2_000;
+function safeRandom(random) {
+    const value = random();
+    if (!Number.isFinite(value)) {
+        return 0;
+    }
+    return Math.min(0.999999999, Math.max(0, value));
+}
+export function getWebRemoteControlHeartbeatJitterMs(baseIntervalMs = WEB_REMOTE_CONTROL_HEARTBEAT_INTERVAL_MS, configuredJitterMs) {
+    const normalizedBase = Number.isFinite(baseIntervalMs) && baseIntervalMs > 0
+        ? Math.floor(baseIntervalMs)
+        : WEB_REMOTE_CONTROL_HEARTBEAT_INTERVAL_MS;
+    const defaultJitterMs = Math.min(WEB_REMOTE_CONTROL_HEARTBEAT_JITTER_MS, Math.floor(normalizedBase * 0.2));
+    const requestedJitterMs = configuredJitterMs ?? defaultJitterMs;
+    if (!Number.isFinite(requestedJitterMs) || requestedJitterMs <= 0) {
+        return 0;
+    }
+    // 心跳 jitter 必须小于基准间隔，避免把合法的 transport heartbeat 变成 0ms 风暴。
+    return Math.min(Math.floor(requestedJitterMs), Math.max(0, normalizedBase - 1));
+}
+export function getWebRemoteControlHeartbeatDelayMs(baseIntervalMs = WEB_REMOTE_CONTROL_HEARTBEAT_INTERVAL_MS, configuredJitterMs, random = Math.random) {
+    const normalizedBase = Number.isFinite(baseIntervalMs) && baseIntervalMs > 0
+        ? Math.floor(baseIntervalMs)
+        : WEB_REMOTE_CONTROL_HEARTBEAT_INTERVAL_MS;
+    const jitterMs = getWebRemoteControlHeartbeatJitterMs(normalizedBase, configuredJitterMs);
+    const minDelayMs = Math.max(1, normalizedBase - jitterMs);
+    const maxDelayMs = normalizedBase + jitterMs;
+    return minDelayMs + Math.floor(safeRandom(random) * (maxDelayMs - minDelayMs + 1));
+}
+export function getWebRemoteControlReconnectJitterMs(configuredJitterMs = WEB_REMOTE_CONTROL_RECONNECT_JITTER_MS, random = Math.random) {
+    if (!Number.isFinite(configuredJitterMs) || configuredJitterMs <= 0) {
+        return 0;
+    }
+    const maxJitterMs = Math.floor(configuredJitterMs);
+    return Math.floor(safeRandom(random) * (maxJitterMs + 1));
+}
+//# sourceMappingURL=web-remote-control-heartbeat.js.map

package/node_modules/@dcode/shared/dist/web-remote-control-rpc-transport.d.ts

@@ -0,0 +1,183 @@
+import { z } from "zod";
+export declare const WEB_REMOTE_CONTROL_RPC_TRANSPORT_LIMITS: {
+    readonly maxPhysicalFrameBytes: number;
+    readonly maxMessageBytes: number;
+    readonly maxFragments: 64;
+    readonly assemblyTimeoutMs: 30000;
+    readonly transportIdMaxChars: 256;
+};
+export declare const webRemoteControlRpcTransportIdSchema: z.ZodString;
+export declare const webRemoteControlRpcTransportIdentitySchema: z.ZodObject<{
+    bridgeSessionId: z.ZodString;
+    bridgeGeneration: z.ZodOptional<z.ZodNumber>;
+    recoveryId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type WebRemoteControlRpcTransportIdentity = z.infer<typeof webRemoteControlRpcTransportIdentitySchema>;
+export declare const webRemoteControlRpcTransportChecksumSchema: z.ZodObject<{
+    algorithm: z.ZodLiteral<"crc32">;
+    value: z.ZodString;
+}, z.core.$strict>;
+export type WebRemoteControlRpcTransportChecksum = z.infer<typeof webRemoteControlRpcTransportChecksumSchema>;
+export declare const webRemoteControlRpcTransportFrameSchema: z.ZodObject<{
+    dcode_type: z.ZodLiteral<"rpc-frame">;
+    bridgeSessionId: z.ZodString;
+    bridgeGeneration: z.ZodOptional<z.ZodNumber>;
+    recoveryId: z.ZodOptional<z.ZodString>;
+    seq: z.ZodNumber;
+    messageSeq: z.ZodNumber;
+    fragmentIndex: z.ZodNumber;
+    fragmentCount: z.ZodNumber;
+    messageBytes: z.ZodNumber;
+    checksum: z.ZodObject<{
+        algorithm: z.ZodLiteral<"crc32">;
+        value: z.ZodString;
+    }, z.core.$strict>;
+    dataBase64: z.ZodString;
+}, z.core.$strict>;
+export type WebRemoteControlRpcTransportFramePayload = z.infer<typeof webRemoteControlRpcTransportFrameSchema>;
+export declare const webRemoteControlRpcTransportAckSchema: z.ZodObject<{
+    dcode_type: z.ZodLiteral<"rpc-frame-ack">;
+    bridgeSessionId: z.ZodString;
+    bridgeGeneration: z.ZodOptional<z.ZodNumber>;
+    recoveryId: z.ZodOptional<z.ZodString>;
+    ackMessageSeq: z.ZodNumber;
+}, z.core.$strict>;
+export type WebRemoteControlRpcTransportAckPayload = z.infer<typeof webRemoteControlRpcTransportAckSchema>;
+export declare const webRemoteControlRpcTransportPayloadSchema: z.ZodUnion<readonly [z.ZodObject<{
+    dcode_type: z.ZodLiteral<"rpc-frame">;
+    bridgeSessionId: z.ZodString;
+    bridgeGeneration: z.ZodOptional<z.ZodNumber>;
+    recoveryId: z.ZodOptional<z.ZodString>;
+    seq: z.ZodNumber;
+    messageSeq: z.ZodNumber;
+    fragmentIndex: z.ZodNumber;
+    fragmentCount: z.ZodNumber;
+    messageBytes: z.ZodNumber;
+    checksum: z.ZodObject<{
+        algorithm: z.ZodLiteral<"crc32">;
+        value: z.ZodString;
+    }, z.core.$strict>;
+    dataBase64: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    dcode_type: z.ZodLiteral<"rpc-frame-ack">;
+    bridgeSessionId: z.ZodString;
+    bridgeGeneration: z.ZodOptional<z.ZodNumber>;
+    recoveryId: z.ZodOptional<z.ZodString>;
+    ackMessageSeq: z.ZodNumber;
+}, z.core.$strict>]>;
+export type WebRemoteControlRpcTransportPayload = z.infer<typeof webRemoteControlRpcTransportPayloadSchema>;
+export declare const webRemoteControlRpcRelayEnvelopeSchema: z.ZodObject<{
+    type: z.ZodLiteral<"data">;
+    payload: z.ZodUnion<readonly [z.ZodObject<{
+        dcode_type: z.ZodLiteral<"rpc-frame">;
+        bridgeSessionId: z.ZodString;
+        bridgeGeneration: z.ZodOptional<z.ZodNumber>;
+        recoveryId: z.ZodOptional<z.ZodString>;
+        seq: z.ZodNumber;
+        messageSeq: z.ZodNumber;
+        fragmentIndex: z.ZodNumber;
+        fragmentCount: z.ZodNumber;
+        messageBytes: z.ZodNumber;
+        checksum: z.ZodObject<{
+            algorithm: z.ZodLiteral<"crc32">;
+            value: z.ZodString;
+        }, z.core.$strict>;
+        dataBase64: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        dcode_type: z.ZodLiteral<"rpc-frame-ack">;
+        bridgeSessionId: z.ZodString;
+        bridgeGeneration: z.ZodOptional<z.ZodNumber>;
+        recoveryId: z.ZodOptional<z.ZodString>;
+        ackMessageSeq: z.ZodNumber;
+    }, z.core.$strict>]>;
+    client_ts: z.ZodOptional<z.ZodNumber>;
+    server_ts: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type WebRemoteControlRpcRelayEnvelope = z.infer<typeof webRemoteControlRpcRelayEnvelopeSchema>;
+export interface WebRemoteControlRpcTransportFault {
+    reasonCode: string;
+    terminal: boolean;
+    seq?: number;
+    messageSeq?: number;
+    expectedSeq?: number;
+    expectedMessageSeq?: number;
+}
+export type ParseWebRemoteControlRpcRelayEnvelopeResult = {
+    kind: "accepted";
+    bytes: number;
+    envelope: WebRemoteControlRpcRelayEnvelope;
+} | {
+    kind: "fault";
+    fault: WebRemoteControlRpcTransportFault;
+};
+/** 最终 relay JSON（默认同时含最坏 client/server timestamp）的精确 UTF-8 byte 数。 */
+export declare function measureWebRemoteControlRpcRelayEnvelopeBytes(payload: WebRemoteControlRpcTransportPayload, timestamps?: {
+    clientTimestamp?: number | null;
+    serverTimestamp?: number | null;
+}): number;
+export declare function parseWebRemoteControlRpcTransportPayload(value: unknown): WebRemoteControlRpcTransportPayload | null;
+/** D3 接线时在 JSON.parse 前调用；本切片只提供 standalone primitive。 */
+export declare function parseWebRemoteControlRpcRelayEnvelopeJson(rawJson: string, options?: {
+    maxPhysicalFrameBytes?: number;
+}): ParseWebRemoteControlRpcRelayEnvelopeResult;
+export declare class WebRemoteControlRpcTransportEncodingError extends Error {
+    readonly reasonCode: string;
+    constructor(reasonCode: string);
+}
+export interface EncodeWebRemoteControlRpcTransportMessageOptions extends WebRemoteControlRpcTransportIdentity {
+    firstPhysicalSeq: number;
+    messageSeq: number;
+    maxPhysicalFrameBytes?: number;
+    maxMessageBytes?: number;
+    maxFragments?: number;
+}
+/** raw Channel bytes -> immutable bounded physical payload batch。 */
+export declare function encodeWebRemoteControlRpcTransportMessage(bytes: Uint8Array, options: EncodeWebRemoteControlRpcTransportMessageOptions): readonly WebRemoteControlRpcTransportFramePayload[];
+export type WebRemoteControlRpcTransportAssemblyEvent = {
+    kind: "incomplete";
+    messageSeq: number;
+    receivedFragments: number;
+} | {
+    kind: "duplicate";
+    ackMessageSeq: number | null;
+} | {
+    kind: "complete";
+    messageSeq: number;
+    bytes: Uint8Array;
+} | {
+    kind: "fault";
+    fault: WebRemoteControlRpcTransportFault;
+};
+export interface WebRemoteControlRpcTransportAssemblerOptions {
+    identity: WebRemoteControlRpcTransportIdentity;
+    initialPhysicalSeq?: number;
+    initialMessageSeq?: number;
+    maxPhysicalFrameBytes?: number;
+    maxMessageBytes?: number;
+    maxFragments?: number;
+    timeoutMs?: number;
+    now?: () => number;
+}
+/** 每方向一个实例；任何 terminal fault 后由 04D-2 映射为 bridge degraded。 */
+export declare class WebRemoteControlRpcTransportAssembler {
+    private readonly identity;
+    private readonly maxPhysicalFrameBytes;
+    private readonly maxMessageBytes;
+    private readonly maxFragments;
+    private readonly timeoutMs;
+    private readonly now;
+    private expectedPhysicalSeq;
+    private expectedMessageSeq;
+    private lastCompletedMessageSeq;
+    private physicalSequenceExhausted;
+    private messageSequenceExhausted;
+    private settledFrameFingerprintsBySeq;
+    private active;
+    private terminalReason;
+    constructor(options: WebRemoteControlRpcTransportAssemblerOptions);
+    get nextExpiryAt(): number | null;
+    private fault;
+    expire(now?: number): WebRemoteControlRpcTransportAssemblyEvent | null;
+    accept(candidate: unknown, now?: number): WebRemoteControlRpcTransportAssemblyEvent;
+}
+//# sourceMappingURL=web-remote-control-rpc-transport.d.ts.map