@openspecui/core 3.7.1 → 3.8.0

package/dist/index.mjs

@@ -1,18 +1,20 @@
-import { a as normalizeOpsxEntityPath, c as parseOpsxEntityMetadata, i as isOpsxGlobPattern, n as getOpsxEntityMetadataPath, o as opsxGlobToRegex, r as getOpsxEntityRootRelativePath, s as opsxPathMatchesPattern, t as buildOpsxEntityDetail } from "./opsx-entity-B_Od4N3r.mjs";
-import { n as toMarkdownFactKind, t as parseMarkdownFacts } from "./markdown-facts-BFqXdPfN.mjs";
-import { a as getMarkdownAnnotation, c as getMarkdownHeadingEnd, d as trimMarkdownSlice, i as createMarkdownReadingDocumentFromFacts, l as getMarkdownHeadingFacts, n as buildMarkdownParentMap, o as getMarkdownAnnotationsForFact, r as createMarkdownReadingDocument, s as getMarkdownFactSpan, t as MarkdownReadingPluginRegistry, u as sortMarkdownReadingPlugins } from "./markdown-reading-CsL1q84q.mjs";
-import { a as getOpenSpecAnnotationsForFact, i as getOpenSpecAnnotation, n as annotateOpenSpecMarkdown, o as openSpecAnnotationRules, r as builtinOpenSpecReadingPlugin, t as annotateOpenSpecFacts } from "./openspec-annotations-D_xQqQOB.mjs";
-import { a as getOpenSpecReadingSections, c as projectOpenSpecMarkdown, i as getOpenSpecProjectionAnnotation, n as OPEN_SPEC_SPEC_PROJECTION_ID, o as parseOpenSpecMarkdownToSpec, r as createOpenSpecReadingPlugin, s as projectAnnotatedOpenSpecToSpec, t as OPEN_SPEC_READING_SECTIONS_PROJECTION_ID } from "./openspec-projection-DLGD1JFD.mjs";
-import { a as MAX_TRANSLATION_CACHE_ENTRY_LIMIT, c as TranslationCacheEntrySchema, d as TranslationCacheStatsSchema, f as TranslationCacheWriteInputSchema, i as DocumentTranslationDisplayModeSchema, l as TranslationCacheReadInputSchema, n as DOCUMENT_TRANSLATION_DISPLAY_MODES, o as MIN_TRANSLATION_CACHE_ENTRY_LIMIT, r as DocumentTranslationConfigSchema, s as TRANSLATION_CACHE_POLICY_VERSION, t as DEFAULT_TRANSLATION_CACHE_ENTRY_LIMIT, u as TranslationCacheSettingsSchema } from "./document-translation-CvUxMOPl.mjs";
-import { _ as customHashFromSoundId, a as CustomSoundHashSchema, b as soundIdFromCustomHash, c as CustomSoundMetadataSchema, f as LEGACY_SOUND_ID_MAP, g as SoundVolumeSchema, h as SoundIdSchema, i as CUSTOM_SOUND_ADD_VALUE, l as DEFAULT_BELL_SOUND_ID, m as SoundConfigIdSchema, n as BUILTIN_SOUND_OPTIONS, o as CustomSoundIdSchema, p as SILENT_SOUND_ID, r as BuiltinSoundIdSchema, s as CustomSoundMetadataFileSchema, t as BUILTIN_SOUND_IDS, u as DEFAULT_NOTIFICATION_SOUND_ID, v as getBuiltinSoundUrl, y as normalizeLegacySoundId } from "./sounds-Ctm3QEtf.mjs";
-import { n as terminalNotificationEventToPublishInput, t as TerminalControlParser } from "./terminal-control-CMkG-o9C.mjs";
-import { a as NotificationPublishInputSchema, c as NotificationSoundSchema, h as groupNotifications, i as NotificationGroupKeySchema, l as NotificationSourceSchema, m as getNotificationGroupLabel, n as NOTIFICATION_SOUND_VALUES, o as NotificationRecordSchema, p as getNotificationGroupKey, r as NotificationActionSchema, s as NotificationSettingsSchema, t as NOTIFICATION_SOUND_OPTIONS, u as TerminalNotificationParser } from "./notifications-DXOoOJ3m.mjs";
-import { n as TERMINAL_BELL_SOUND_VALUES, r as TerminalBellSoundSchema, t as TERMINAL_BELL_SOUND_OPTIONS } from "./terminal-audio-BiQ9qJJW.mjs";
-import { a as TERMINAL_THEME_VALUES, i as TERMINAL_THEME_MODE_VALUES, n as DEFAULT_TERMINAL_LIGHT_THEME, r as DEFAULT_TERMINAL_THEME_MODE, t as DEFAULT_TERMINAL_DARK_THEME } from "./terminal-theme-BOGPIiVm.mjs";
-import { a as buildEmbeddedUiLaunchUrl, c as isHostedBackendHealthResponse, d as normalizeHostedAppBaseUrl, f as resolveHostedAppBaseUrl, i as buildBackendHealthPayload, l as isSupportedEmbeddedUiUrl, n as OFFICIAL_APP_BASE_URL, o as buildHostedLaunchUrl, r as OPENSPECUI_RUNTIME_CAPABILITIES, s as isBackendHealthRuntimeMetadata, t as HOSTED_SHELL_PROTOCOL_VERSION, u as normalizeEmbeddedUiUrl } from "./hosted-app-Du65UHRo.mjs";
-import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-BHEPZsJx.mjs";
-import { a as TerminalInvocationSettingsSchema, c as TerminalSpawnCommandSchema, f as quoteTerminalShellArg, g as resolveTerminalShellDefaults, h as renderTerminalSpawnCommandLine, i as TerminalCommandFieldSchema, n as TERMINAL_COMMAND_FIELD_TYPE_VALUES, o as TerminalShellProfileSchema, p as renderTerminalCommandArgs, r as TERMINAL_SHELL_QUOTE_STYLE_VALUES, s as TerminalShellQuoteStyleSchema, t as BUILTIN_TERMINAL_SPAWN_COMMANDS, u as getTerminalCommandDefaultValues } from "./terminal-invocation-CX1LDM89.mjs";
-import { t as parseOpsxSchemaDetail } from "./opsx-schema-detail-Bh-aNaSk.mjs";
+import { a as normalizeOpsxEntityPath, c as parseOpsxEntityMetadata, i as isOpsxGlobPattern, n as getOpsxEntityMetadataPath, o as opsxGlobToRegex, r as getOpsxEntityRootRelativePath, s as opsxPathMatchesPattern, t as buildOpsxEntityDetail } from "./opsx-entity-BR_6djiM.mjs";
+import { n as toMarkdownFactKind, t as parseMarkdownFacts } from "./markdown-facts-B5RvYPKF.mjs";
+import { a as getMarkdownAnnotation, c as getMarkdownHeadingEnd, d as trimMarkdownSlice, i as createMarkdownReadingDocumentFromFacts, l as getMarkdownHeadingFacts, n as buildMarkdownParentMap, o as getMarkdownAnnotationsForFact, r as createMarkdownReadingDocument, s as getMarkdownFactSpan, t as MarkdownReadingPluginRegistry, u as sortMarkdownReadingPlugins } from "./markdown-reading-DYBp7qoI.mjs";
+import { a as getOpenSpecAnnotationsForFact, i as getOpenSpecAnnotation, n as annotateOpenSpecMarkdown, o as openSpecAnnotationRules, r as builtinOpenSpecReadingPlugin, t as annotateOpenSpecFacts } from "./openspec-annotations-BxBoWlyv.mjs";
+import { a as getOpenSpecReadingSections, c as projectOpenSpecMarkdown, i as getOpenSpecProjectionAnnotation, n as OPEN_SPEC_SPEC_PROJECTION_ID, o as parseOpenSpecMarkdownToSpec, r as createOpenSpecReadingPlugin, s as projectAnnotatedOpenSpecToSpec, t as OPEN_SPEC_READING_SECTIONS_PROJECTION_ID } from "./openspec-projection-Cd6oydiK.mjs";
+import { _ as TranslationLocalSettingsSchema, a as LocalModelAssetPlanSnapshotSchema, c as SERVICE_TRANSLATION_ENGINE_IDS, d as TRANSLATION_ENGINE_MANIFESTS, f as TRANSLATOR_CONTRACT_VERSION, g as TranslationEngineIdSchema, h as TranslationEngineGlobalSettingsSchema, i as LocalModelAssetLogSchema, l as ServiceTranslationEngineIdSchema, m as TranslationDownloadGroupPlanSchema, n as BatchTranslateInputSchema, o as LocalModelAssetStateSchema, p as TranslationDownloadFilePlanSchema, r as DEFAULT_TRANSLATION_ENGINE_ID, s as LocalModelDownloadStatusSchema, t as BatchTranslateEventSchema, u as TRANSLATION_ENGINE_IDS, v as TranslationOpenAISettingsSchema, y as getTranslationEngineManifest } from "./translator-C3LT7PqW.mjs";
+import { a as MAX_TRANSLATION_CACHE_ENTRY_LIMIT, c as TranslationCacheEntrySchema, d as TranslationCacheStatsSchema, f as TranslationCacheWriteInputSchema, i as DocumentTranslationDisplayModeSchema, l as TranslationCacheReadInputSchema, n as DOCUMENT_TRANSLATION_DISPLAY_MODES, o as MIN_TRANSLATION_CACHE_ENTRY_LIMIT, p as TranslationEngineProjectSettingsSchema, r as DocumentTranslationConfigSchema, s as TRANSLATION_CACHE_POLICY_VERSION, t as DEFAULT_TRANSLATION_CACHE_ENTRY_LIMIT, u as TranslationCacheSettingsSchema } from "./document-translation-BrE402YR.mjs";
+import { _ as customHashFromSoundId, a as CustomSoundHashSchema, b as soundIdFromCustomHash, c as CustomSoundMetadataSchema, f as LEGACY_SOUND_ID_MAP, g as SoundVolumeSchema, h as SoundIdSchema, i as CUSTOM_SOUND_ADD_VALUE, l as DEFAULT_BELL_SOUND_ID, m as SoundConfigIdSchema, n as BUILTIN_SOUND_OPTIONS, o as CustomSoundIdSchema, p as SILENT_SOUND_ID, r as BuiltinSoundIdSchema, s as CustomSoundMetadataFileSchema, t as BUILTIN_SOUND_IDS, u as DEFAULT_NOTIFICATION_SOUND_ID, v as getBuiltinSoundUrl, y as normalizeLegacySoundId } from "./sounds-CB_gpY-y.mjs";
+import { n as terminalNotificationEventToPublishInput, t as TerminalControlParser } from "./terminal-control-CNcEd9Rl.mjs";
+import { a as NotificationPublishInputSchema, c as NotificationSoundSchema, h as groupNotifications, i as NotificationGroupKeySchema, l as NotificationSourceSchema, m as getNotificationGroupLabel, n as NOTIFICATION_SOUND_VALUES, o as NotificationRecordSchema, p as getNotificationGroupKey, r as NotificationActionSchema, s as NotificationSettingsSchema, t as NOTIFICATION_SOUND_OPTIONS, u as TerminalNotificationParser } from "./notifications-9vbSJQ8N.mjs";
+import { n as TERMINAL_BELL_SOUND_VALUES, r as TerminalBellSoundSchema, t as TERMINAL_BELL_SOUND_OPTIONS } from "./terminal-audio-DVz0HA2H.mjs";
+import { a as TERMINAL_THEME_VALUES, i as TERMINAL_THEME_MODE_VALUES, n as DEFAULT_TERMINAL_LIGHT_THEME, r as DEFAULT_TERMINAL_THEME_MODE, t as DEFAULT_TERMINAL_DARK_THEME } from "./terminal-theme-CHkfTDk4.mjs";
+import { i as selectLocalDownloadGroup, n as buildLocalDownloadPlanFromRepositoryFiles, r as buildLocalDownloadPlanFromRuntimeProfileFiles, t as LOCAL_MODEL_PROFILE_DEFINITIONS } from "./local-download-profiles-BppI_PAq.mjs";
+import { a as buildEmbeddedUiLaunchUrl, c as isHostedBackendHealthResponse, d as normalizeHostedAppBaseUrl, f as resolveHostedAppBaseUrl, i as buildBackendHealthPayload, l as isSupportedEmbeddedUiUrl, n as OFFICIAL_APP_BASE_URL, o as buildHostedLaunchUrl, r as OPENSPECUI_RUNTIME_CAPABILITIES, s as isBackendHealthRuntimeMetadata, t as HOSTED_SHELL_PROTOCOL_VERSION, u as normalizeEmbeddedUiUrl } from "./hosted-app-CxpQvD1s.mjs";
+import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-Bf89ZyM5.mjs";
+import { a as TerminalInvocationSettingsSchema, c as TerminalSpawnCommandSchema, f as quoteTerminalShellArg, g as resolveTerminalShellDefaults, h as renderTerminalSpawnCommandLine, i as TerminalCommandFieldSchema, n as TERMINAL_COMMAND_FIELD_TYPE_VALUES, o as TerminalShellProfileSchema, p as renderTerminalCommandArgs, r as TERMINAL_SHELL_QUOTE_STYLE_VALUES, s as TerminalShellQuoteStyleSchema, t as BUILTIN_TERMINAL_SPAWN_COMMANDS, u as getTerminalCommandDefaultValues } from "./terminal-invocation-wUmtJMPl.mjs";
+import { t as parseOpsxSchemaDetail } from "./opsx-schema-detail-5Wv1oWLT.mjs";
 import { mkdir, readFile, rename, writeFile } from "fs/promises";
 import { dirname, join } from "path";
 import { AsyncLocalStorage } from "node:async_hooks";
@@ -2002,6 +2004,56 @@ function createFileChangeObservable(watcher) {
 	} };
 }
 
+//#endregion
+//#region src/persisted-settings-sanitize.ts
+function isPlainObject(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function readPath(value, path) {
+	let current = value;
+	for (const key of path) {
+		if (!isPlainObject(current) || !Object.prototype.hasOwnProperty.call(current, key)) return {
+			exists: false,
+			value: void 0
+		};
+		current = current[key];
+	}
+	return {
+		exists: true,
+		value: current
+	};
+}
+function writePath(value, path, nextValue) {
+	if (!isPlainObject(value)) return value;
+	const [head, ...tail] = path;
+	const clone = { ...value };
+	if (tail.length === 0) {
+		if (nextValue === void 0) delete clone[head];
+		else clone[head] = nextValue;
+		return clone;
+	}
+	const currentChild = clone[head];
+	clone[head] = writePath(isPlainObject(currentChild) ? currentChild : {}, tail, nextValue);
+	return clone;
+}
+/**
+* Treat persisted settings/config as untrusted input and repair known invalid
+* fields before the authoritative schema parse runs.
+*/
+function sanitizePersistedSettings(value, rules) {
+	let sanitized = value;
+	for (const rule of rules) {
+		const current = readPath(sanitized, rule.path);
+		if (!current.exists) continue;
+		if (rule.kind === "object") {
+			if (!isPlainObject(current.value)) sanitized = writePath(sanitized, rule.path, rule.fallback);
+			continue;
+		}
+		if (!rule.schema.safeParse(current.value).success) sanitized = writePath(sanitized, rule.path, rule.fallback);
+	}
+	return sanitized;
+}
+
 //#endregion
 //#region src/spawn-safe.ts
 function getSpawnErrorCode(err) {
@@ -2501,7 +2553,7 @@ const TerminalConfigSchema = z.object({
 	useTheme: TerminalThemeModeSchema.default(DEFAULT_TERMINAL_THEME_MODE),
 	lightTheme: TerminalThemeSchema.default(DEFAULT_TERMINAL_LIGHT_THEME),
 	darkTheme: TerminalThemeSchema.default(DEFAULT_TERMINAL_DARK_THEME),
-	rendererEngine: z.string().default("xterm"),
+	rendererEngine: TerminalRendererEngineSchema.default("xterm"),
 	bellSound: TerminalBellSoundSchema.default(DEFAULT_BELL_SOUND_ID),
 	bellVolume: SoundVolumeSchema
 });
@@ -2543,6 +2595,133 @@ const DEFAULT_CONFIG = {
 	notifications: NotificationSettingsSchema.parse({}),
 	translation: DocumentTranslationConfigSchema.parse({})
 };
+const PERSISTED_CONFIG_SANITIZE_RULES = [
+	{
+		kind: "object",
+		path: ["cli"],
+		fallback: {}
+	},
+	{
+		kind: "field",
+		path: ["theme"],
+		schema: z.enum(THEME_VALUES),
+		fallback: DEFAULT_CONFIG.theme
+	},
+	{
+		kind: "object",
+		path: ["codeEditor"],
+		fallback: {}
+	},
+	{
+		kind: "field",
+		path: ["codeEditor", "theme"],
+		schema: CodeEditorThemeSchema,
+		fallback: DEFAULT_CONFIG.codeEditor.theme
+	},
+	{
+		kind: "object",
+		path: ["opsx"],
+		fallback: {}
+	},
+	{
+		kind: "field",
+		path: ["opsx", "agentInvocationMode"],
+		schema: OpsxAgentInvocationModeSchema,
+		fallback: DEFAULT_CONFIG.opsx.agentInvocationMode
+	},
+	{
+		kind: "object",
+		path: ["terminal"],
+		fallback: {}
+	},
+	{
+		kind: "field",
+		path: ["terminal", "cursorStyle"],
+		schema: z.enum(CURSOR_STYLE_VALUES),
+		fallback: DEFAULT_CONFIG.terminal.cursorStyle
+	},
+	{
+		kind: "field",
+		path: ["terminal", "useTheme"],
+		schema: TerminalThemeModeSchema,
+		fallback: DEFAULT_CONFIG.terminal.useTheme
+	},
+	{
+		kind: "field",
+		path: ["terminal", "lightTheme"],
+		schema: TerminalThemeSchema,
+		fallback: DEFAULT_CONFIG.terminal.lightTheme
+	},
+	{
+		kind: "field",
+		path: ["terminal", "darkTheme"],
+		schema: TerminalThemeSchema,
+		fallback: DEFAULT_CONFIG.terminal.darkTheme
+	},
+	{
+		kind: "field",
+		path: ["terminal", "rendererEngine"],
+		schema: TerminalRendererEngineSchema,
+		fallback: DEFAULT_CONFIG.terminal.rendererEngine
+	},
+	{
+		kind: "field",
+		path: ["terminal", "bellSound"],
+		schema: TerminalBellSoundSchema,
+		fallback: DEFAULT_CONFIG.terminal.bellSound
+	},
+	{
+		kind: "object",
+		path: ["notifications"],
+		fallback: {}
+	},
+	{
+		kind: "field",
+		path: ["notifications", "sound"],
+		schema: NotificationSettingsSchema.shape.sound,
+		fallback: DEFAULT_CONFIG.notifications.sound
+	},
+	{
+		kind: "object",
+		path: ["translation"],
+		fallback: {}
+	},
+	{
+		kind: "object",
+		path: ["translation", "engines"],
+		fallback: {}
+	},
+	{
+		kind: "object",
+		path: [
+			"translation",
+			"engines",
+			"local"
+		],
+		fallback: {}
+	},
+	{
+		kind: "object",
+		path: [
+			"translation",
+			"engines",
+			"openai"
+		],
+		fallback: {}
+	},
+	{
+		kind: "field",
+		path: ["translation", "displayMode"],
+		schema: DocumentTranslationConfigSchema.shape.displayMode,
+		fallback: DEFAULT_CONFIG.translation.displayMode
+	},
+	{
+		kind: "field",
+		path: ["translation", "engineId"],
+		schema: DocumentTranslationConfigSchema.shape.engineId,
+		fallback: DEFAULT_CONFIG.translation.engineId
+	}
+];
 function areStringArraysEqual(left, right) {
 	if (left === right) return true;
 	if (!left || !right) return !left && !right;
@@ -2613,6 +2792,14 @@ function toPersistedConfig(config, options = {}) {
 	if (config.translation.targetLanguage !== DEFAULT_CONFIG.translation.targetLanguage) translation.targetLanguage = config.translation.targetLanguage;
 	if (config.translation.displayMode !== DEFAULT_CONFIG.translation.displayMode) translation.displayMode = config.translation.displayMode;
 	if (config.translation.cacheEnabled !== DEFAULT_CONFIG.translation.cacheEnabled) translation.cacheEnabled = config.translation.cacheEnabled;
+	if (config.translation.engineId !== DEFAULT_CONFIG.translation.engineId) translation.engineId = config.translation.engineId;
+	const translationEngines = {};
+	const localEngine = {};
+	if (config.translation.engines.local.model !== DEFAULT_CONFIG.translation.engines.local.model) localEngine.model = config.translation.engines.local.model;
+	if (config.translation.engines.local.selectedGroupId !== DEFAULT_CONFIG.translation.engines.local.selectedGroupId) localEngine.selectedGroupId = config.translation.engines.local.selectedGroupId;
+	if (localEngine && hasOwnEntries$1(localEngine)) translationEngines.local = localEngine;
+	if (config.translation.engines.openai.model !== DEFAULT_CONFIG.translation.engines.openai.model) translationEngines.openai = { model: config.translation.engines.openai.model };
+	if (hasOwnEntries$1(translationEngines)) translation.engines = translationEngines;
 	if (hasOwnEntries$1(translation)) persisted.translation = translation;
 	return persisted;
 }
@@ -2640,8 +2827,8 @@ var ConfigManager = class {
 	parseConfigContent(content) {
 		if (!content) return DEFAULT_CONFIG;
 		try {
-			const normalized = pruneNullish$1(JSON.parse(content)) ?? {};
-			const result = OpenSpecUIConfigSchema.safeParse(normalized);
+			const sanitized = sanitizePersistedSettings(pruneNullish$1(JSON.parse(content)) ?? {}, PERSISTED_CONFIG_SANITIZE_RULES);
+			const result = OpenSpecUIConfigSchema.safeParse(sanitized);
 			if (result.success) return result.data;
 			console.warn("Invalid config format, using defaults:", result.error.message);
 			return DEFAULT_CONFIG;
@@ -2715,7 +2902,17 @@ var ConfigManager = class {
 			},
 			translation: {
 				...current.translation,
-				...config.translation
+				...config.translation,
+				engines: {
+					local: {
+						...current.translation.engines.local,
+						...config.translation?.engines?.local
+					},
+					openai: {
+						...current.translation.engines.openai,
+						...config.translation?.engines?.openai
+					}
+				}
 			}
 		});
 		if (isPersistedConfigEmpty(persisted) && !fileExists) return;
@@ -2842,8 +3039,33 @@ var ConfigManager = class {
 
 //#endregion
 //#region src/global-settings.ts
-const OpenSpecUIGlobalSettingsSchema = z.object({ translationCache: TranslationCacheSettingsSchema.default(TranslationCacheSettingsSchema.parse({})) });
+const OpenSpecUIGlobalSettingsSchema = z.object({
+	translationCache: TranslationCacheSettingsSchema.default(TranslationCacheSettingsSchema.parse({})),
+	translationEngines: TranslationEngineGlobalSettingsSchema.default(TranslationEngineGlobalSettingsSchema.parse({}))
+});
 const DEFAULT_GLOBAL_SETTINGS = OpenSpecUIGlobalSettingsSchema.parse({});
+const PERSISTED_GLOBAL_SETTINGS_SANITIZE_RULES = [
+	{
+		kind: "object",
+		path: ["translationCache"],
+		fallback: {}
+	},
+	{
+		kind: "object",
+		path: ["translationEngines"],
+		fallback: {}
+	},
+	{
+		kind: "object",
+		path: ["translationEngines", "openai"],
+		fallback: {}
+	},
+	{
+		kind: "object",
+		path: ["translationEngines", "local"],
+		fallback: {}
+	}
+];
 function getDefaultGlobalSettingsPath() {
 	return join$1(homedir(), ".openspecui", "settings.json");
 }
@@ -2864,6 +3086,19 @@ function toPersistedGlobalSettings(settings) {
 	const translationCache = {};
 	if (settings.translationCache.entryLimit !== DEFAULT_GLOBAL_SETTINGS.translationCache.entryLimit) translationCache.entryLimit = settings.translationCache.entryLimit;
 	if (hasOwnEntries(translationCache)) persisted.translationCache = translationCache;
+	const translationEngines = {};
+	const defaultTranslationEngines = DEFAULT_GLOBAL_SETTINGS.translationEngines;
+	const openai = {};
+	if (settings.translationEngines.openai.baseUrl !== defaultTranslationEngines.openai.baseUrl) openai.baseUrl = settings.translationEngines.openai.baseUrl;
+	if (settings.translationEngines.openai.token !== defaultTranslationEngines.openai.token) openai.token = settings.translationEngines.openai.token;
+	if (settings.translationEngines.openai.model !== defaultTranslationEngines.openai.model) openai.model = settings.translationEngines.openai.model;
+	if (hasOwnEntries(openai)) translationEngines.openai = openai;
+	const local = {};
+	if (settings.translationEngines.local.model !== defaultTranslationEngines.local.model) local.model = settings.translationEngines.local.model;
+	if (settings.translationEngines.local.selectedGroupId !== defaultTranslationEngines.local.selectedGroupId) local.selectedGroupId = settings.translationEngines.local.selectedGroupId;
+	if (settings.translationEngines.local.hfEndpoint !== defaultTranslationEngines.local.hfEndpoint) local.hfEndpoint = settings.translationEngines.local.hfEndpoint;
+	if (hasOwnEntries(local)) translationEngines.local = local;
+	if (hasOwnEntries(translationEngines)) persisted.translationEngines = translationEngines;
 	return persisted;
 }
 function isPersistedGlobalSettingsEmpty(settings) {
@@ -2886,8 +3121,8 @@ var GlobalSettingsManager = class {
 	parseSettingsContent(content) {
 		if (!content) return DEFAULT_GLOBAL_SETTINGS;
 		try {
-			const normalized = pruneNullish(JSON.parse(content)) ?? {};
-			const result = OpenSpecUIGlobalSettingsSchema.safeParse(normalized);
+			const sanitized = sanitizePersistedSettings(pruneNullish(JSON.parse(content)) ?? {}, PERSISTED_GLOBAL_SETTINGS_SANITIZE_RULES);
+			const result = OpenSpecUIGlobalSettingsSchema.safeParse(sanitized);
 			if (result.success) return result.data;
 			console.warn("Invalid global settings format, using defaults:", result.error.message);
 			return DEFAULT_GLOBAL_SETTINGS;
@@ -2909,6 +3144,17 @@ var GlobalSettingsManager = class {
 			translationCache: {
 				...current.translationCache,
 				...update.translationCache
+			},
+			translationEngines: {
+				...current.translationEngines,
+				openai: {
+					...current.translationEngines.openai,
+					...update.translationEngines?.openai
+				},
+				local: {
+					...current.translationEngines.local,
+					...update.translationEngines?.local
+				}
 			}
 		}));
 		if (isPersistedGlobalSettingsEmpty(persisted) && !fileExists) return;
@@ -4034,6 +4280,7 @@ async function touchOpsxChangeDeps(projectDir, changeId) {
 	const changeDir = join$1(projectDir, "openspec", "changes", changeId);
 	await reactiveReadDir(changeDir, { includeHidden: true });
 	await reactiveReadFile(join$1(changeDir, ".openspec.yaml"));
+	await touchDirectoryTree(changeDir);
 }
 async function touchDirectoryPathDeps(rootDir, relativePath) {
 	let currentPath = rootDir;
@@ -4756,4 +5003,4 @@ const PtyServerMessageSchema = z.discriminatedUnion("type", [
 ]);
 
 //#endregion
-export { AI_TOOLS, ApplyInstructionsContextFilesSchema, ApplyInstructionsSchema, ApplyTaskSchema, ArtifactInstructionsSchema, ArtifactStatusSchema, BUILTIN_SOUND_IDS, BUILTIN_SOUND_OPTIONS, BUILTIN_TERMINAL_SPAWN_COMMANDS, BuiltinSoundIdSchema, CODE_EDITOR_THEME_VALUES, CUSTOM_SOUND_ADD_VALUE, ChangeFileSchema, ChangeSchema, ChangeStatusSchema, CliExecutor, CodeEditorThemeSchema, ConfigManager, CustomSoundHashSchema, CustomSoundIdSchema, CustomSoundMetadataFileSchema, CustomSoundMetadataSchema, DASHBOARD_METRIC_KEYS, DEFAULT_BELL_SOUND_ID, DEFAULT_CONFIG, DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET, DEFAULT_GLOBAL_SETTINGS, DEFAULT_NOTIFICATION_SOUND_ID, DEFAULT_TERMINAL_DARK_THEME, DEFAULT_TERMINAL_LIGHT_THEME, DEFAULT_TERMINAL_THEME_MODE, DEFAULT_TRANSLATION_CACHE_ENTRY_LIMIT, DOCUMENT_TRANSLATION_DISPLAY_MODES, DashboardConfigSchema, DeltaOperationType, DeltaSchema, DeltaSpecSchema, DependencyInfoSchema, DocumentTranslationConfigSchema, DocumentTranslationDisplayModeSchema, GitConfigSchema, GlobalSettingsManager, HOSTED_SHELL_PROTOCOL_VERSION, LEGACY_SOUND_ID_MAP, MAX_TRANSLATION_CACHE_ENTRY_LIMIT, MIN_TRANSLATION_CACHE_ENTRY_LIMIT, MarkdownParser, MarkdownReadingPluginRegistry, NOTIFICATION_SOUND_OPTIONS, NOTIFICATION_SOUND_VALUES, NotificationActionSchema, NotificationGroupKeySchema, NotificationPublishInputSchema, NotificationRecordSchema, NotificationSettingsSchema, NotificationSoundSchema, NotificationSourceSchema, OFFICIAL_APP_BASE_URL, OPENSPECUI_HOOKS_VERSION, OPENSPECUI_RUNTIME_CAPABILITIES, OPEN_SPEC_READING_SECTIONS_PROJECTION_ID, OPEN_SPEC_SPEC_PROJECTION_ID, OPSX_AGENT_INVOCATION_MODE_VALUES, OpenSpecAdapter, OpenSpecUIConfigSchema, OpenSpecUIGlobalSettingsSchema, OpenSpecWatcher, OpsxAgentInvocationModeSchema, OpsxConfigSchema, OpsxKernel, ProjectWatcher, PtyAttachMessageSchema, PtyBellResponseSchema, PtyBufferResponseSchema, PtyClientMessageSchema, PtyCloseMessageSchema, PtyCreateMessageSchema, PtyCreatedResponseSchema, PtyErrorCodeSchema, PtyErrorResponseSchema, PtyExitResponseSchema, PtyInputMessageSchema, PtyListMessageSchema, PtyListResponseSchema, PtyOutputResponseSchema, PtyPlatformSchema, PtyProcessTitleResponseSchema, PtyResizeMessageSchema, PtyServerMessageSchema, PtyTitleResponseSchema, ReactiveContext, ReactiveState, RequirementSchema, SILENT_SOUND_ID, ScenarioStepKeywordSchema, ScenarioStepSchema, SchemaArtifactSchema, SchemaDetailSchema, SchemaInfoSchema, SchemaResolutionSchema, SoundConfigIdSchema, SoundIdSchema, SpecSchema, TERMINAL_BELL_SOUND_OPTIONS, TERMINAL_BELL_SOUND_VALUES, TERMINAL_COMMAND_FIELD_TYPE_VALUES, TERMINAL_SHELL_QUOTE_STYLE_VALUES, TERMINAL_THEME_MODE_VALUES, TERMINAL_THEME_VALUES, TOOL_WORKFLOW_TO_SKILL_DIR, TRANSLATION_CACHE_POLICY_VERSION, TaskSchema, TemplatesSchema, TerminalBellSoundSchema, TerminalCommandFieldSchema, TerminalConfigSchema, TerminalControlParser, TerminalInvocationSettingsSchema, TerminalNotificationParser, TerminalRendererEngineSchema, TerminalShellProfileSchema, TerminalShellQuoteStyleSchema, TerminalSpawnCommandSchema, TerminalThemeModeSchema, TerminalThemeSchema, TranslationCacheEntrySchema, TranslationCacheReadInputSchema, TranslationCacheSettingsSchema, TranslationCacheStatsSchema, TranslationCacheWriteInputSchema, VIRTUAL_PROJECT_DIRNAME, Validator, acquireWatcher, annotateOpenSpecFacts, annotateOpenSpecMarkdown, buildBackendHealthPayload, buildCliRunnerCandidates, buildEmbeddedUiLaunchUrl, buildHostedLaunchUrl, buildMarkdownParentMap, buildOpsxEntityDetail, builtinOpenSpecReadingPlugin, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, createMarkdownReadingDocument, createMarkdownReadingDocumentFromFacts, createOpenSpecReadingPlugin, customHashFromSoundId, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getBuiltinSoundUrl, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getDefaultGlobalSettingsPath, getDetectedProjectTools, getMarkdownAnnotation, getMarkdownAnnotationsForFact, getMarkdownFactSpan, getMarkdownHeadingEnd, getMarkdownHeadingFacts, getNotificationGroupKey, getNotificationGroupLabel, getOpenSpecAnnotation, getOpenSpecAnnotationsForFact, getOpenSpecProjectionAnnotation, getOpenSpecReadingSections, getOpsxEntityMetadataPath, getOpsxEntityRootRelativePath, getProjectWatcher, getTerminalCommandDefaultValues, getToolById, getToolInitStates, getWatchedProjectDir, getWatcherRuntimeStatus, groupNotifications, initWatcherPool, isBackendHealthRuntimeMetadata, isGlobPattern, isHostedBackendHealthResponse, isOpsxGlobPattern, isSupportedEmbeddedUiUrl, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, normalizeEmbeddedUiUrl, normalizeHostedAppBaseUrl, normalizeLegacySoundId, normalizeOpsxEntityPath, openSpecAnnotationRules, opsxGlobToRegex, opsxPathMatchesPattern, parseCliCommand, parseMarkdownFacts, parseOpenSpecMarkdownToSpec, parseOpsxEntityMetadata, parseOpsxSchemaDetail, projectAnnotatedOpenSpecToSpec, projectOpenSpecMarkdown, quoteTerminalShellArg, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, renderTerminalCommandArgs, renderTerminalSpawnCommandLine, resolveHostedAppBaseUrl, resolveTerminalShellDefaults, sniffGlobalCli, sortMarkdownReadingPlugins, soundIdFromCustomHash, subscribeWatcherRuntimeStatus, terminalNotificationEventToPublishInput, toMarkdownFactKind, toOpsxDisplayPath, toPersistedGlobalSettings, trimMarkdownSlice };
+export { AI_TOOLS, ApplyInstructionsContextFilesSchema, ApplyInstructionsSchema, ApplyTaskSchema, ArtifactInstructionsSchema, ArtifactStatusSchema, BUILTIN_SOUND_IDS, BUILTIN_SOUND_OPTIONS, BUILTIN_TERMINAL_SPAWN_COMMANDS, BatchTranslateEventSchema, BatchTranslateInputSchema, BuiltinSoundIdSchema, CODE_EDITOR_THEME_VALUES, CUSTOM_SOUND_ADD_VALUE, ChangeFileSchema, ChangeSchema, ChangeStatusSchema, CliExecutor, CodeEditorThemeSchema, ConfigManager, CustomSoundHashSchema, CustomSoundIdSchema, CustomSoundMetadataFileSchema, CustomSoundMetadataSchema, DASHBOARD_METRIC_KEYS, DEFAULT_BELL_SOUND_ID, DEFAULT_CONFIG, DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET, DEFAULT_GLOBAL_SETTINGS, DEFAULT_NOTIFICATION_SOUND_ID, DEFAULT_TERMINAL_DARK_THEME, DEFAULT_TERMINAL_LIGHT_THEME, DEFAULT_TERMINAL_THEME_MODE, DEFAULT_TRANSLATION_CACHE_ENTRY_LIMIT, DEFAULT_TRANSLATION_ENGINE_ID, DOCUMENT_TRANSLATION_DISPLAY_MODES, DashboardConfigSchema, DeltaOperationType, DeltaSchema, DeltaSpecSchema, DependencyInfoSchema, DocumentTranslationConfigSchema, DocumentTranslationDisplayModeSchema, GitConfigSchema, GlobalSettingsManager, HOSTED_SHELL_PROTOCOL_VERSION, LEGACY_SOUND_ID_MAP, LOCAL_MODEL_PROFILE_DEFINITIONS, LocalModelAssetLogSchema, LocalModelAssetPlanSnapshotSchema, LocalModelAssetStateSchema, LocalModelDownloadStatusSchema, MAX_TRANSLATION_CACHE_ENTRY_LIMIT, MIN_TRANSLATION_CACHE_ENTRY_LIMIT, MarkdownParser, MarkdownReadingPluginRegistry, NOTIFICATION_SOUND_OPTIONS, NOTIFICATION_SOUND_VALUES, NotificationActionSchema, NotificationGroupKeySchema, NotificationPublishInputSchema, NotificationRecordSchema, NotificationSettingsSchema, NotificationSoundSchema, NotificationSourceSchema, OFFICIAL_APP_BASE_URL, OPENSPECUI_HOOKS_VERSION, OPENSPECUI_RUNTIME_CAPABILITIES, OPEN_SPEC_READING_SECTIONS_PROJECTION_ID, OPEN_SPEC_SPEC_PROJECTION_ID, OPSX_AGENT_INVOCATION_MODE_VALUES, OpenSpecAdapter, OpenSpecUIConfigSchema, OpenSpecUIGlobalSettingsSchema, OpenSpecWatcher, OpsxAgentInvocationModeSchema, OpsxConfigSchema, OpsxKernel, ProjectWatcher, PtyAttachMessageSchema, PtyBellResponseSchema, PtyBufferResponseSchema, PtyClientMessageSchema, PtyCloseMessageSchema, PtyCreateMessageSchema, PtyCreatedResponseSchema, PtyErrorCodeSchema, PtyErrorResponseSchema, PtyExitResponseSchema, PtyInputMessageSchema, PtyListMessageSchema, PtyListResponseSchema, PtyOutputResponseSchema, PtyPlatformSchema, PtyProcessTitleResponseSchema, PtyResizeMessageSchema, PtyServerMessageSchema, PtyTitleResponseSchema, ReactiveContext, ReactiveState, RequirementSchema, SERVICE_TRANSLATION_ENGINE_IDS, SILENT_SOUND_ID, ScenarioStepKeywordSchema, ScenarioStepSchema, SchemaArtifactSchema, SchemaDetailSchema, SchemaInfoSchema, SchemaResolutionSchema, ServiceTranslationEngineIdSchema, SoundConfigIdSchema, SoundIdSchema, SpecSchema, TERMINAL_BELL_SOUND_OPTIONS, TERMINAL_BELL_SOUND_VALUES, TERMINAL_COMMAND_FIELD_TYPE_VALUES, TERMINAL_SHELL_QUOTE_STYLE_VALUES, TERMINAL_THEME_MODE_VALUES, TERMINAL_THEME_VALUES, TOOL_WORKFLOW_TO_SKILL_DIR, TRANSLATION_CACHE_POLICY_VERSION, TRANSLATION_ENGINE_IDS, TRANSLATION_ENGINE_MANIFESTS, TRANSLATOR_CONTRACT_VERSION, TaskSchema, TemplatesSchema, TerminalBellSoundSchema, TerminalCommandFieldSchema, TerminalConfigSchema, TerminalControlParser, TerminalInvocationSettingsSchema, TerminalNotificationParser, TerminalRendererEngineSchema, TerminalShellProfileSchema, TerminalShellQuoteStyleSchema, TerminalSpawnCommandSchema, TerminalThemeModeSchema, TerminalThemeSchema, TranslationCacheEntrySchema, TranslationCacheReadInputSchema, TranslationCacheSettingsSchema, TranslationCacheStatsSchema, TranslationCacheWriteInputSchema, TranslationDownloadFilePlanSchema, TranslationDownloadGroupPlanSchema, TranslationEngineGlobalSettingsSchema, TranslationEngineIdSchema, TranslationEngineProjectSettingsSchema, TranslationLocalSettingsSchema, TranslationOpenAISettingsSchema, VIRTUAL_PROJECT_DIRNAME, Validator, acquireWatcher, annotateOpenSpecFacts, annotateOpenSpecMarkdown, buildBackendHealthPayload, buildCliRunnerCandidates, buildEmbeddedUiLaunchUrl, buildHostedLaunchUrl, buildLocalDownloadPlanFromRepositoryFiles, buildLocalDownloadPlanFromRuntimeProfileFiles, buildMarkdownParentMap, buildOpsxEntityDetail, builtinOpenSpecReadingPlugin, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, createMarkdownReadingDocument, createMarkdownReadingDocumentFromFacts, createOpenSpecReadingPlugin, customHashFromSoundId, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getBuiltinSoundUrl, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getDefaultGlobalSettingsPath, getDetectedProjectTools, getMarkdownAnnotation, getMarkdownAnnotationsForFact, getMarkdownFactSpan, getMarkdownHeadingEnd, getMarkdownHeadingFacts, getNotificationGroupKey, getNotificationGroupLabel, getOpenSpecAnnotation, getOpenSpecAnnotationsForFact, getOpenSpecProjectionAnnotation, getOpenSpecReadingSections, getOpsxEntityMetadataPath, getOpsxEntityRootRelativePath, getProjectWatcher, getTerminalCommandDefaultValues, getToolById, getToolInitStates, getTranslationEngineManifest, getWatchedProjectDir, getWatcherRuntimeStatus, groupNotifications, initWatcherPool, isBackendHealthRuntimeMetadata, isGlobPattern, isHostedBackendHealthResponse, isOpsxGlobPattern, isSupportedEmbeddedUiUrl, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, normalizeEmbeddedUiUrl, normalizeHostedAppBaseUrl, normalizeLegacySoundId, normalizeOpsxEntityPath, openSpecAnnotationRules, opsxGlobToRegex, opsxPathMatchesPattern, parseCliCommand, parseMarkdownFacts, parseOpenSpecMarkdownToSpec, parseOpsxEntityMetadata, parseOpsxSchemaDetail, projectAnnotatedOpenSpecToSpec, projectOpenSpecMarkdown, quoteTerminalShellArg, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, renderTerminalCommandArgs, renderTerminalSpawnCommandLine, resolveHostedAppBaseUrl, resolveTerminalShellDefaults, selectLocalDownloadGroup, sniffGlobalCli, sortMarkdownReadingPlugins, soundIdFromCustomHash, subscribeWatcherRuntimeStatus, terminalNotificationEventToPublishInput, toMarkdownFactKind, toOpsxDisplayPath, toPersistedGlobalSettings, trimMarkdownSlice };

package/dist/local-download-profiles-BA0ArrI0.d.mts

@@ -0,0 +1,100 @@
+import { D as TranslationDownloadGroupPlan, z as TranslationModelDownloadPlan } from "./translator-LOd1jBrH.mjs";
+
+//#region src/local-download-profiles.d.ts
+declare const LOCAL_MODEL_PROFILE_DEFINITIONS: readonly [{
+  readonly id: "q1";
+  readonly label: "q1";
+  readonly dtype: "q1";
+  readonly suffix: "_q1";
+  readonly description: "1-bit quantized ONNX profile.";
+}, {
+  readonly id: "q1f16";
+  readonly label: "q1f16";
+  readonly dtype: "q1f16";
+  readonly suffix: "_q1f16";
+  readonly description: "1-bit block quantized fp16 ONNX profile.";
+}, {
+  readonly id: "q2";
+  readonly label: "q2";
+  readonly dtype: "q2";
+  readonly suffix: "_q2";
+  readonly description: "2-bit quantized ONNX profile.";
+}, {
+  readonly id: "q2f16";
+  readonly label: "q2f16";
+  readonly dtype: "q2f16";
+  readonly suffix: "_q2f16";
+  readonly description: "2-bit block quantized fp16 ONNX profile.";
+}, {
+  readonly id: "q4";
+  readonly label: "q4";
+  readonly dtype: "q4";
+  readonly suffix: "_q4";
+  readonly description: "4-bit quantized ONNX profile.";
+}, {
+  readonly id: "q4f16";
+  readonly label: "q4f16";
+  readonly dtype: "q4f16";
+  readonly suffix: "_q4f16";
+  readonly description: "4-bit block quantized fp16 ONNX profile.";
+}, {
+  readonly id: "bnb4";
+  readonly label: "bnb4";
+  readonly dtype: "bnb4";
+  readonly suffix: "_bnb4";
+  readonly description: "bitsandbytes 4-bit ONNX profile.";
+}, {
+  readonly id: "q8";
+  readonly label: "q8";
+  readonly dtype: "q8";
+  readonly suffix: "_quantized";
+  readonly description: "8-bit quantized ONNX profile.";
+}, {
+  readonly id: "int8";
+  readonly label: "int8";
+  readonly dtype: "int8";
+  readonly suffix: "_int8";
+  readonly description: "int8 ONNX profile.";
+}, {
+  readonly id: "uint8";
+  readonly label: "uint8";
+  readonly dtype: "uint8";
+  readonly suffix: "_uint8";
+  readonly description: "uint8 ONNX profile.";
+}, {
+  readonly id: "fp16";
+  readonly label: "fp16";
+  readonly dtype: "fp16";
+  readonly suffix: "_fp16";
+  readonly description: "fp16 ONNX profile.";
+}, {
+  readonly id: "fp32";
+  readonly label: "fp32";
+  readonly dtype: "fp32";
+  readonly suffix: "";
+  readonly description: "fp32 ONNX profile.";
+}];
+type LocalModelProfileId = (typeof LOCAL_MODEL_PROFILE_DEFINITIONS)[number]['id'];
+interface LocalRepositoryFile {
+  path: string;
+  sizeBytes?: number;
+}
+interface LocalRuntimeProfileFiles {
+  profile: LocalModelProfileId;
+  dtype: string;
+  files: ReadonlyArray<LocalRepositoryFile>;
+}
+declare function buildLocalDownloadPlanFromRepositoryFiles(input: {
+  modelId: string;
+  files: ReadonlyArray<LocalRepositoryFile>;
+  isEncoderDecoder?: boolean;
+  selectedGroupId?: string;
+}): TranslationModelDownloadPlan | null;
+declare function buildLocalDownloadPlanFromRuntimeProfileFiles(input: {
+  modelId: string;
+  groups: ReadonlyArray<LocalRuntimeProfileFiles>;
+  selectedGroupId?: string;
+}): TranslationModelDownloadPlan | null;
+declare function selectLocalDownloadGroup(plan: TranslationModelDownloadPlan | null, selectedGroupId: string | undefined): TranslationDownloadGroupPlan | null;
+//#endregion
+export { buildLocalDownloadPlanFromRepositoryFiles as a, LocalRuntimeProfileFiles as i, LocalModelProfileId as n, buildLocalDownloadPlanFromRuntimeProfileFiles as o, LocalRepositoryFile as r, selectLocalDownloadGroup as s, LOCAL_MODEL_PROFILE_DEFINITIONS as t };