@tulex-cli/tulex-code 0.1.1

package/dist/src/config/keyBindings.js

@@ -0,0 +1,188 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Command enum for all available keyboard shortcuts
+ */
+export var Command;
+(function (Command) {
+    // Basic bindings
+    Command["RETURN"] = "return";
+    Command["ESCAPE"] = "escape";
+    // Cursor movement
+    Command["HOME"] = "home";
+    Command["END"] = "end";
+    // Text deletion
+    Command["KILL_LINE_RIGHT"] = "killLineRight";
+    Command["KILL_LINE_LEFT"] = "killLineLeft";
+    Command["CLEAR_INPUT"] = "clearInput";
+    Command["DELETE_WORD_BACKWARD"] = "deleteWordBackward";
+    // Screen control
+    Command["CLEAR_SCREEN"] = "clearScreen";
+    // History navigation
+    Command["HISTORY_UP"] = "historyUp";
+    Command["HISTORY_DOWN"] = "historyDown";
+    Command["NAVIGATION_UP"] = "navigationUp";
+    Command["NAVIGATION_DOWN"] = "navigationDown";
+    // Selection list navigation (dialogs, menus)
+    Command["SELECTION_UP"] = "selectionUp";
+    Command["SELECTION_DOWN"] = "selectionDown";
+    // Auto-completion
+    Command["ACCEPT_SUGGESTION"] = "acceptSuggestion";
+    Command["COMPLETION_UP"] = "completionUp";
+    Command["COMPLETION_DOWN"] = "completionDown";
+    // Text input
+    Command["SUBMIT"] = "submit";
+    Command["NEWLINE"] = "newline";
+    // External tools
+    Command["OPEN_EXTERNAL_EDITOR"] = "openExternalEditor";
+    Command["PASTE_CLIPBOARD_IMAGE"] = "pasteClipboardImage";
+    // App level bindings
+    Command["TOGGLE_TOOL_DESCRIPTIONS"] = "toggleToolDescriptions";
+    Command["TOGGLE_IDE_CONTEXT_DETAIL"] = "toggleIDEContextDetail";
+    Command["QUIT"] = "quit";
+    Command["EXIT"] = "exit";
+    Command["SHOW_MORE_LINES"] = "showMoreLines";
+    Command["RETRY_LAST"] = "retryLast";
+    Command["TOGGLE_COMPACT_MODE"] = "toggleCompactMode";
+    Command["TOGGLE_RENDER_MODE"] = "toggleRenderMode";
+    /**
+     * Promote the running foreground shell command to a background task.
+     * The child process keeps running and the agent's turn unblocks; the
+     * shell becomes a regular `BackgroundShellEntry` visible in `/tasks`,
+     * the Background tasks dialog, and stoppable via `task_stop`.
+     * No-op when no foreground shell is currently executing.
+     */
+    Command["PROMOTE_SHELL_TO_BACKGROUND"] = "promoteShellToBackground";
+    // Shell commands
+    Command["REVERSE_SEARCH"] = "reverseSearch";
+    Command["SUBMIT_REVERSE_SEARCH"] = "submitReverseSearch";
+    Command["ACCEPT_SUGGESTION_REVERSE_SEARCH"] = "acceptSuggestionReverseSearch";
+    Command["TOGGLE_SHELL_INPUT_FOCUS"] = "toggleShellInputFocus";
+    // Suggestion expansion
+    Command["EXPAND_SUGGESTION"] = "expandSuggestion";
+    Command["COLLAPSE_SUGGESTION"] = "collapseSuggestion";
+    // Scroll commands
+    Command["SCROLL_UP"] = "scrollUp";
+    Command["SCROLL_DOWN"] = "scrollDown";
+    Command["PAGE_UP"] = "pageUp";
+    Command["PAGE_DOWN"] = "pageDown";
+    Command["SCROLL_HOME"] = "scrollHome";
+    Command["SCROLL_END"] = "scrollEnd";
+})(Command || (Command = {}));
+/**
+ * Default key binding configuration
+ * Matches the original hard-coded logic exactly
+ */
+export const defaultKeyBindings = {
+    // Basic bindings
+    [Command.RETURN]: [{ key: 'return' }],
+    [Command.ESCAPE]: [{ key: 'escape' }],
+    // Cursor movement
+    [Command.HOME]: [{ key: 'a', ctrl: true }],
+    [Command.END]: [{ key: 'e', ctrl: true }],
+    // Text deletion
+    [Command.KILL_LINE_RIGHT]: [{ key: 'k', ctrl: true }],
+    [Command.KILL_LINE_LEFT]: [{ key: 'u', ctrl: true }],
+    [Command.CLEAR_INPUT]: [{ key: 'c', ctrl: true }],
+    // Added command (meta/alt/option) for mac compatibility
+    [Command.DELETE_WORD_BACKWARD]: [
+        { key: 'backspace', ctrl: true },
+        { key: 'backspace', command: true },
+        // MinTTY (Git Bash on Windows) emits the byte \x1f (ASCII Unit
+        // Separator, rendered as "^_" by `cat -v`) for Ctrl+Backspace under
+        // its standard Ctrl-modifies-meta-keys convention. The same byte is
+        // the historical Ctrl-mapping of the Unit Separator on traditional
+        // ANSI/VT terminals (Ctrl+_ and Ctrl+/ also emit it), but qwen-code
+        // doesn't bind those keystrokes elsewhere so this entry is additive
+        // and non-conflicting on every platform.
+        { sequence: '\x1f' },
+    ],
+    // Screen control
+    [Command.CLEAR_SCREEN]: [{ key: 'l', ctrl: true }],
+    // History navigation
+    [Command.HISTORY_UP]: [{ key: 'p', ctrl: true }],
+    [Command.HISTORY_DOWN]: [{ key: 'n', ctrl: true }],
+    [Command.NAVIGATION_UP]: [{ key: 'up' }],
+    [Command.NAVIGATION_DOWN]: [{ key: 'down' }],
+    // Selection-list nav: arrows + k/j + Ctrl+P/Ctrl+N
+    // ctrl: false on bare k/j skips Ctrl+K and Ctrl+J
+    [Command.SELECTION_UP]: [
+        { key: 'up' },
+        { key: 'k', ctrl: false },
+        { key: 'p', ctrl: true },
+    ],
+    [Command.SELECTION_DOWN]: [
+        { key: 'down' },
+        { key: 'j', ctrl: false },
+        { key: 'n', ctrl: true },
+    ],
+    // Auto-completion
+    [Command.ACCEPT_SUGGESTION]: [{ key: 'tab' }, { key: 'return', ctrl: false }],
+    // Completion navigation uses only arrow keys
+    [Command.COMPLETION_UP]: [{ key: 'up' }],
+    [Command.COMPLETION_DOWN]: [{ key: 'down' }],
+    // Text input
+    // Must also exclude shift to allow shift+enter for newline
+    [Command.SUBMIT]: [
+        {
+            key: 'return',
+            ctrl: false,
+            command: false,
+            paste: false,
+            shift: false,
+        },
+    ],
+    // Split into multiple data-driven bindings
+    // Now also includes shift+enter for multi-line input
+    [Command.NEWLINE]: [
+        { key: 'return', ctrl: true },
+        { key: 'return', command: true },
+        { key: 'return', paste: true },
+        { key: 'return', shift: true },
+        { key: 'j', ctrl: true },
+    ],
+    // External tools
+    [Command.OPEN_EXTERNAL_EDITOR]: [
+        { key: 'x', ctrl: true },
+        { sequence: '\x18', ctrl: true },
+    ],
+    [Command.PASTE_CLIPBOARD_IMAGE]: process.platform === 'win32'
+        ? [
+            { key: 'v', command: true },
+            { key: 'v', meta: true },
+        ]
+        : [
+            { key: 'v', ctrl: true },
+            { key: 'v', command: true },
+        ],
+    // App level bindings
+    [Command.TOGGLE_TOOL_DESCRIPTIONS]: [{ key: 't', ctrl: true }],
+    [Command.TOGGLE_IDE_CONTEXT_DETAIL]: [{ key: 'g', ctrl: true }],
+    [Command.QUIT]: [{ key: 'c', ctrl: true }],
+    [Command.EXIT]: [{ key: 'd', ctrl: true }],
+    [Command.SHOW_MORE_LINES]: [{ key: 's', ctrl: true }],
+    [Command.RETRY_LAST]: [{ key: 'y', ctrl: true }],
+    [Command.TOGGLE_COMPACT_MODE]: [{ key: 'o', ctrl: true }],
+    [Command.TOGGLE_RENDER_MODE]: [{ key: 'm', meta: true }],
+    [Command.PROMOTE_SHELL_TO_BACKGROUND]: [{ key: 'b', ctrl: true }],
+    // Shell commands
+    [Command.REVERSE_SEARCH]: [{ key: 'r', ctrl: true }],
+    // Note: original logic ONLY checked ctrl=false, ignored meta/shift/paste
+    [Command.SUBMIT_REVERSE_SEARCH]: [{ key: 'return', ctrl: false }],
+    [Command.ACCEPT_SUGGESTION_REVERSE_SEARCH]: [{ key: 'tab' }],
+    [Command.TOGGLE_SHELL_INPUT_FOCUS]: [{ key: 'f', ctrl: true }],
+    // Suggestion expansion
+    [Command.EXPAND_SUGGESTION]: [{ key: 'right' }],
+    [Command.COLLAPSE_SUGGESTION]: [{ key: 'left' }],
+    // Scroll commands
+    [Command.SCROLL_UP]: [{ key: 'up', shift: true }],
+    [Command.SCROLL_DOWN]: [{ key: 'down', shift: true }],
+    [Command.PAGE_UP]: [{ key: 'pageup' }],
+    [Command.PAGE_DOWN]: [{ key: 'pagedown' }],
+    [Command.SCROLL_HOME]: [{ key: 'home', ctrl: true }],
+    [Command.SCROLL_END]: [{ key: 'end', ctrl: true }],
+};
+//# sourceMappingURL=keyBindings.js.map

package/dist/src/config/keyBindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyBindings.js","sourceRoot":"","sources":["../../../src/config/keyBindings.ts"],"names":[],"mappings":"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"}

package/dist/src/config/keyBindings.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/config/keyBindings.test.js

@@ -0,0 +1,51 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { Command, defaultKeyBindings } from './keyBindings.js';
+describe('keyBindings config', () => {
+    describe('defaultKeyBindings', () => {
+        it('should have bindings for all commands', () => {
+            const commands = Object.values(Command);
+            for (const command of commands) {
+                expect(defaultKeyBindings[command]).toBeDefined();
+                expect(Array.isArray(defaultKeyBindings[command])).toBe(true);
+            }
+        });
+        it('should have valid key binding structures', () => {
+            for (const [_, bindings] of Object.entries(defaultKeyBindings)) {
+                for (const binding of bindings) {
+                    // Each binding should have either key or sequence, but not both
+                    const hasKey = binding.key !== undefined;
+                    const hasSequence = binding.sequence !== undefined;
+                    expect(hasKey || hasSequence).toBe(true);
+                    expect(hasKey && hasSequence).toBe(false);
+                    // Modifier properties should be boolean or undefined
+                    if (binding.ctrl !== undefined) {
+                        expect(typeof binding.ctrl).toBe('boolean');
+                    }
+                    if (binding.shift !== undefined) {
+                        expect(typeof binding.shift).toBe('boolean');
+                    }
+                    if (binding.command !== undefined) {
+                        expect(typeof binding.command).toBe('boolean');
+                    }
+                    if (binding.paste !== undefined) {
+                        expect(typeof binding.paste).toBe('boolean');
+                    }
+                }
+            }
+        });
+        it('should export all required types', () => {
+            // Basic type checks
+            expect(typeof Command.HOME).toBe('string');
+            expect(typeof Command.END).toBe('string');
+            // Config should be readonly
+            const config = defaultKeyBindings;
+            expect(config[Command.HOME]).toBeDefined();
+        });
+    });
+});
+//# sourceMappingURL=keyBindings.test.js.map

package/dist/src/config/keyBindings.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyBindings.test.js","sourceRoot":"","sources":["../../../src/config/keyBindings.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE/D,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAExC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;gBAClD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChE,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,KAAK,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBAC/D,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;oBAC/B,gEAAgE;oBAChE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC;oBACzC,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC;oBAEnD,MAAM,CAAC,MAAM,IAAI,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACzC,MAAM,CAAC,MAAM,IAAI,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBAE1C,qDAAqD;oBACrD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;wBAC/B,MAAM,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBAC9C,CAAC;oBACD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;wBAChC,MAAM,CAAC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBAC/C,CAAC;oBACD,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;wBAClC,MAAM,CAAC,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBACjD,CAAC;oBACD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;wBAChC,MAAM,CAAC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBAC/C,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,oBAAoB;YACpB,MAAM,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3C,MAAM,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAE1C,4BAA4B;YAC5B,MAAM,MAAM,GAAqB,kBAAkB,CAAC;YACpD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/config/loadedSettingsAdapter.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2025 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Adapter that lets core's `applyProviderInstallPlan` write through
+ * `LoadedSettings` while preserving CLI-specific guarantees:
+ * - scope resolution via `getPersistScopeForModelSelection`
+ * - on-disk `.orig` backup of the target settings file
+ * - in-memory snapshot of `settings` / `originalSettings` for rollback
+ * - merged-settings recomputation after restore
+ */
+import type { ProviderSettingsAdapter } from '@tulex-cli/tulex-cli-core';
+import type { LoadedSettings, SettingScope } from './settings.js';
+export declare function createLoadedSettingsAdapter(settings: LoadedSettings, scope?: SettingScope): ProviderSettingsAdapter;

package/dist/src/config/loadedSettingsAdapter.js

@@ -0,0 +1,80 @@
+/**
+ * @license
+ * Copyright 2025 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Adapter that lets core's `applyProviderInstallPlan` write through
+ * `LoadedSettings` while preserving CLI-specific guarantees:
+ * - scope resolution via `getPersistScopeForModelSelection`
+ * - on-disk `.orig` backup of the target settings file
+ * - in-memory snapshot of `settings` / `originalSettings` for rollback
+ * - merged-settings recomputation after restore
+ */
+import { getPersistScopeForModelSelection } from './modelProvidersScope.js';
+import { backupSettingsFile, cleanupSettingsBackup, restoreSettingsFromBackup, getNestedProperty, } from '../utils/settingsUtils.js';
+export function createLoadedSettingsAdapter(settings, scope) {
+    const persistScope = scope ?? getPersistScopeForModelSelection(settings);
+    const settingsFile = settings.forScope(persistScope);
+    let settingsSnapshot = null;
+    let originalSnapshot = null;
+    return {
+        getValue(key) {
+            return getNestedProperty(settings.merged, key);
+        },
+        setValue(key, value) {
+            // Defense in depth: refuse prototype-chain segments before delegating to
+            // LoadedSettings.setValue, which goes through setNestedPropertySafe and
+            // doesn't enforce this itself. Inline literal === comparisons (rather
+            // than Set.has) are what CodeQL's prototype-pollution sanitiser
+            // recognises — keep this list in sync with the matching guard in
+            // `packages/vscode-ide-companion/src/services/settingsWriter.ts`.
+            for (const part of key.split('.')) {
+                if (part === '__proto__' ||
+                    part === 'constructor' ||
+                    part === 'prototype') {
+                    throw new Error(`Refusing to write settings key with reserved segment: ${key}`);
+                }
+            }
+            settings.setValue(persistScope, key, value);
+        },
+        getModelProviders() {
+            return (settings.merged.modelProviders ?? {});
+        },
+        persist() {
+            // LoadedSettings.setValue already persists on each write.
+        },
+        backup() {
+            backupSettingsFile(settingsFile.path);
+            settingsSnapshot = structuredClone(settingsFile.settings);
+            originalSnapshot = structuredClone(settingsFile.originalSettings);
+        },
+        restore() {
+            // restoreSettingsFromBackup returns false (rather than throwing) when
+            // the .orig copy can't be restored (EACCES, disk full, missing .orig).
+            // Log loudly so a user staring at the next CLI session knows the
+            // on-disk file may be inconsistent with the recovered in-memory state.
+            const restored = restoreSettingsFromBackup(settingsFile.path);
+            if (!restored) {
+                // eslint-disable-next-line no-console -- best-effort rollback path
+                console.error(`[loadedSettingsAdapter] On-disk rollback of ${settingsFile.path} failed; ` +
+                    `in-memory state was restored but the file may be inconsistent. ` +
+                    `Re-run /auth or inspect the file directly to recover.`);
+            }
+            if (settingsSnapshot !== null) {
+                settingsFile.settings =
+                    settingsSnapshot;
+            }
+            if (originalSnapshot !== null) {
+                settingsFile.originalSettings =
+                    originalSnapshot;
+            }
+            settings.recomputeMerged();
+        },
+        cleanupBackup() {
+            cleanupSettingsBackup(settingsFile.path);
+            settingsSnapshot = null;
+            originalSnapshot = null;
+        },
+    };
+}
+//# sourceMappingURL=loadedSettingsAdapter.js.map

package/dist/src/config/loadedSettingsAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadedSettingsAdapter.js","sourceRoot":"","sources":["../../../src/config/loadedSettingsAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,UAAU,2BAA2B,CACzC,QAAwB,EACxB,KAAoB;IAEpB,MAAM,YAAY,GAAG,KAAK,IAAI,gCAAgC,CAAC,QAAQ,CAAC,CAAC;IACzE,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAErD,IAAI,gBAAgB,GAAkB,IAAI,CAAC;IAC3C,IAAI,gBAAgB,GAAkB,IAAI,CAAC;IAE3C,OAAO;QACL,QAAQ,CAAC,GAAW;YAClB,OAAO,iBAAiB,CAAC,QAAQ,CAAC,MAAiC,EAAE,GAAG,CAAC,CAAC;QAC5E,CAAC;QAED,QAAQ,CAAC,GAAW,EAAE,KAAc;YAClC,yEAAyE;YACzE,wEAAwE;YACxE,sEAAsE;YACtE,gEAAgE;YAChE,iEAAiE;YACjE,kEAAkE;YAClE,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClC,IACE,IAAI,KAAK,WAAW;oBACpB,IAAI,KAAK,aAAa;oBACtB,IAAI,KAAK,WAAW,EACpB,CAAC;oBACD,MAAM,IAAI,KAAK,CACb,yDAAyD,GAAG,EAAE,CAC/D,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9C,CAAC;QAED,iBAAiB;YACf,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,IAAI,EAAE,CAAyB,CAAC;QACxE,CAAC;QAED,OAAO;YACL,0DAA0D;QAC5D,CAAC;QAED,MAAM;YACJ,kBAAkB,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YACtC,gBAAgB,GAAG,eAAe,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YAC1D,gBAAgB,GAAG,eAAe,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;QACpE,CAAC;QAED,OAAO;YACL,sEAAsE;YACtE,uEAAuE;YACvE,iEAAiE;YACjE,uEAAuE;YACvE,MAAM,QAAQ,GAAG,yBAAyB,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAC9D,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,mEAAmE;gBACnE,OAAO,CAAC,KAAK,CACX,+CAA+C,YAAY,CAAC,IAAI,WAAW;oBACzE,iEAAiE;oBACjE,uDAAuD,CAC1D,CAAC;YACJ,CAAC;YACD,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;gBAC9B,YAAY,CAAC,QAAQ;oBACnB,gBAAgD,CAAC;YACrD,CAAC;YACD,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;gBAC9B,YAAY,CAAC,gBAAgB;oBAC3B,gBAAwD,CAAC;YAC7D,CAAC;YACD,QAAQ,CAAC,eAAe,EAAE,CAAC;QAC7B,CAAC;QAED,aAAa;YACX,qBAAqB,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,gBAAgB,GAAG,IAAI,CAAC;YACxB,gBAAgB,GAAG,IAAI,CAAC;QAC1B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/config/loadedSettingsAdapter.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/config/loadedSettingsAdapter.test.js

@@ -0,0 +1,127 @@
+/**
+ * @license
+ * Copyright 2025 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, expect, it, vi } from 'vitest';
+import { createLoadedSettingsAdapter } from './loadedSettingsAdapter.js';
+import { SettingScope } from './settings.js';
+// settingsUtils makes real fs calls in backup/restore — stub them out so the
+// tests can focus on adapter behavior without touching disk.
+vi.mock('../utils/settingsUtils.js', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        backupSettingsFile: vi.fn(),
+        restoreSettingsFromBackup: vi.fn(),
+        cleanupSettingsBackup: vi.fn(),
+    };
+});
+function makeSettings(initial = {}) {
+    const file = {
+        settings: structuredClone(initial),
+        originalSettings: structuredClone(initial),
+        path: '/tmp/qwen-test-settings.json',
+    };
+    const setValue = vi.fn((_scope, key, value) => {
+        const parts = key.split('.');
+        let current = file.settings;
+        for (let i = 0; i < parts.length; i++) {
+            const part = parts[i];
+            // Mirror setNestedPropertySafe's reserved-segment rejection. Inline
+            // literal === comparisons (rather than e.g. Set.has) are what
+            // CodeQL's prototype-pollution sanitiser recognises, so we use them
+            // at the only step that actually writes to `current`.
+            if (part === '__proto__' ||
+                part === 'constructor' ||
+                part === 'prototype') {
+                throw new Error(`mock setValue refused reserved segment in: ${key}`);
+            }
+            if (i === parts.length - 1) {
+                current[part] = value;
+            }
+            else {
+                if (!current[part] || typeof current[part] !== 'object') {
+                    current[part] = {};
+                }
+                current = current[part];
+            }
+        }
+        file.originalSettings = structuredClone(file.settings);
+    });
+    const recomputeMerged = vi.fn(() => {
+        /* merged() is computed lazily via the getter below */
+    });
+    const settings = {
+        get merged() {
+            return file.settings;
+        },
+        forScope: vi.fn(() => file),
+        setValue,
+        recomputeMerged,
+    };
+    return { settings, file, setValue, recomputeMerged };
+}
+describe('createLoadedSettingsAdapter', () => {
+    it('forwards setValue to LoadedSettings.setValue with the resolved scope', () => {
+        const { settings, setValue } = makeSettings();
+        const adapter = createLoadedSettingsAdapter(settings, SettingScope.User);
+        adapter.setValue('env.MY_KEY', 'val');
+        expect(setValue).toHaveBeenCalledWith(SettingScope.User, 'env.MY_KEY', 'val');
+    });
+    it('rejects prototype-pollution keys before reaching LoadedSettings', () => {
+        const { settings, setValue } = makeSettings();
+        const adapter = createLoadedSettingsAdapter(settings, SettingScope.User);
+        expect(() => adapter.setValue('__proto__.polluted', 'x')).toThrow(/reserved segment/);
+        expect(() => adapter.setValue('foo.constructor.bar', 'x')).toThrow(/reserved segment/);
+        expect(() => adapter.setValue('prototype.x', 'x')).toThrow(/reserved segment/);
+        // The guard short-circuits before delegating to LoadedSettings — that's the
+        // contract this test exists to lock in.
+        expect(setValue).not.toHaveBeenCalled();
+    });
+    it('getValue reads from settings.merged via dotted key', () => {
+        const { settings } = makeSettings({
+            env: { MY_KEY: 'from-merged' },
+            modelProviders: { openai: [{ id: 'gpt' }] },
+        });
+        const adapter = createLoadedSettingsAdapter(settings, SettingScope.User);
+        expect(adapter.getValue('env.MY_KEY')).toBe('from-merged');
+        expect(adapter.getValue('modelProviders.openai')).toEqual([{ id: 'gpt' }]);
+        expect(adapter.getValue('missing.path')).toBeUndefined();
+    });
+    it('backup() snapshots in-memory state; restore() reverts and recomputes merged', () => {
+        const { settings, file, recomputeMerged } = makeSettings({
+            env: { ORIGINAL: '1' },
+        });
+        const adapter = createLoadedSettingsAdapter(settings, SettingScope.User);
+        // backup/restore/cleanupBackup are optional in the contract, but
+        // createLoadedSettingsAdapter always installs them — assert + use !.
+        expect(adapter.backup).toBeTypeOf('function');
+        adapter.backup();
+        // Simulate mutations that would happen during an install plan apply.
+        adapter.setValue('env.NEW_KEY', 'new-value');
+        expect(file.settings.env).toEqual({
+            ORIGINAL: '1',
+            NEW_KEY: 'new-value',
+        });
+        expect(adapter.restore).toBeTypeOf('function');
+        adapter.restore();
+        expect(file.settings).toEqual({ env: { ORIGINAL: '1' } });
+        expect(file.originalSettings).toEqual({ env: { ORIGINAL: '1' } });
+        expect(recomputeMerged).toHaveBeenCalled();
+    });
+    it('cleanupBackup() clears the in-memory snapshot so a later restore is a no-op', () => {
+        const { settings, file } = makeSettings({ env: { K: 'v1' } });
+        const adapter = createLoadedSettingsAdapter(settings, SettingScope.User);
+        expect(adapter.backup).toBeTypeOf('function');
+        adapter.backup();
+        adapter.setValue('env.K', 'v2');
+        expect(adapter.cleanupBackup).toBeTypeOf('function');
+        adapter.cleanupBackup();
+        // restore after cleanup should not bring v1 back
+        expect(adapter.restore).toBeTypeOf('function');
+        adapter.restore();
+        expect(file.settings.env).toEqual({ K: 'v2' });
+    });
+});
+//# sourceMappingURL=loadedSettingsAdapter.test.js.map

package/dist/src/config/loadedSettingsAdapter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadedSettingsAdapter.test.js","sourceRoot":"","sources":["../../../src/config/loadedSettingsAdapter.test.ts"],"names":[],"mappings":"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"}

package/dist/src/config/migration/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export type { SettingsMigration, MigrationResult } from './types.js';
+export { MigrationScheduler } from './scheduler.js';
+export { v1ToV2Migration, V1ToV2Migration } from './versions/v1-to-v2.js';
+export { v2ToV3Migration, V2ToV3Migration } from './versions/v2-to-v3.js';
+export { v3ToV4Migration, V3ToV4Migration } from './versions/v3-to-v4.js';
+import type { MigrationResult } from './types.js';
+/**
+ * Ordered array of all settings migrations.
+ * Use this with MigrationScheduler to run the full migration chain.
+ *
+ * @example
+ * ```typescript
+ * const scheduler = new MigrationScheduler(ALL_MIGRATIONS);
+ * const result = scheduler.migrate(settings);
+ * ```
+ */
+export declare const ALL_MIGRATIONS: readonly [import("./versions/v1-to-v2.js").V1ToV2Migration, import("./versions/v2-to-v3.js").V2ToV3Migration, import("./versions/v3-to-v4.js").V3ToV4Migration];
+/**
+ * Convenience function that runs all migrations on the given settings.
+ * This is the primary entry point for settings migration.
+ *
+ * @param settings - The settings object to migrate
+ * @param scope - The scope of settings being migrated
+ * @returns MigrationResult containing the final settings, version, and execution log
+ *
+ * @example
+ * ```typescript
+ * const result = runMigrations(settings, 'User');
+ * if (result.executedMigrations.length > 0) {
+ *   console.log(`Migrated from version ${result.executedMigrations[0].fromVersion} to ${result.finalVersion}`);
+ * }
+ * ```
+ */
+export declare function runMigrations(settings: unknown, scope: string): MigrationResult;
+/**
+ * Checks if the given settings need migration.
+ * Returns true only if at least one registered migration would be applied.
+ *
+ * This function checks:
+ * 1. If $version field exists and is a number:
+ *    - Returns false if $version >= SETTINGS_VERSION
+ *    - Returns true only when $version < SETTINGS_VERSION AND at least one
+ *      migration can execute for the current settings shape
+ * 2. If $version field is missing or invalid:
+ *    - Uses fallback logic by checking individual migrations
+ *
+ * Note:
+ * - Legacy numeric versions that have no executable migrations are handled by
+ *   the settings loader via version normalization (bump metadata to current).
+ *
+ * @param settings - The settings object to check
+ * @returns true if migration is needed, false otherwise
+ */
+export declare function needsMigration(settings: unknown): boolean;