@qduc/term2 0.7.3 → 0.8.0

package/dist/services/settings/settings-schema.test.js.map

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

package/dist/services/settings/settings-service.d.ts

@@ -0,0 +1,93 @@
+import { LoggingService } from '../logging/logging-service.js';
+import { type SettingSource, type SettingsData, type SettingsWithSources } from './settings-schema.js';
+/**
+ * Service for managing application settings.
+ * Follows singleton pattern and supports:
+ * - XDG-compliant storage
+ * - Hierarchical precedence (CLI > Env > Config > Defaults)
+ * - Zod validation with graceful degradation
+ * - Runtime-modifiable vs startup-only settings
+ * - Setting source tracking
+ */
+export declare class SettingsService {
+    private settings;
+    private sources;
+    private settingsDir;
+    private disableLogging;
+    private disableFilePersistence;
+    private listeners;
+    private loggingService;
+    constructor(options?: {
+        settingsDir?: string;
+        disableLogging?: boolean;
+        disableFilePersistence?: boolean;
+        cli?: Partial<SettingsData>;
+        env?: Partial<SettingsData>;
+        loggingService?: LoggingService;
+    });
+    private registerRuntimeProviders;
+    private validateSelectedProvider;
+    /**
+     * Get a setting value by dot-notation key (e.g., 'agent.model')
+     */
+    get<T = any>(key: string): T;
+    /**
+     * Get the source of a setting
+     */
+    getSource(key: string): SettingSource;
+    /**
+     * Check if a setting is runtime-modifiable
+     */
+    isRuntimeModifiable(key: string): boolean;
+    /**
+     * Check if a setting is sensitive and should not be saved to disk
+     */
+    isSensitive(key: string): boolean;
+    private validateAndApplySetting;
+    private normalizeExclusiveAppModes;
+    /**
+     * Set a setting value (runtime modification)
+     * Only runtime-modifiable settings can be changed.
+     * Sensitive settings cannot be modified (must come from environment).
+     */
+    set(key: string, value: any, options?: {
+        persist?: boolean;
+    }): void;
+    /**
+     * Persist a setting even if it only takes effect after restart.
+     * This still validates against the full schema and updates in-memory state
+     * so the settings UI reflects the saved value immediately.
+     */
+    setPersistent(key: string, value: any): void;
+    /**
+     * Reset a setting to its default value.
+     * Sensitive settings cannot be reset as they should only come from env.
+     */
+    reset(key?: string): void;
+    /**
+     * Subscribe to changes; returns an unsubscribe function.
+     */
+    onChange(listener: (key?: string) => void): () => void;
+    private notifyChange;
+    /**
+     * Get all settings with their sources
+     */
+    getAll(): SettingsWithSources;
+    /**
+     * Load settings from file
+     * Returns both raw (pre-Zod) and validated data
+     */
+    private loadFromFile;
+    /**
+     * Save settings to file, excluding sensitive values
+     */
+    private saveToFile;
+    /**
+     * Check if target object is missing any keys that exist in source
+     */
+    private hasMissingKeys;
+}
+export { buildEnvOverrides } from './settings-env.js';
+export { SETTING_KEYS, SENSITIVE_SETTINGS } from './settings-schema.js';
+export type { SettingsData, SettingSource, SettingWithSource, SettingsWithSources } from './settings-schema.js';
+//# sourceMappingURL=settings-service.d.ts.map

package/dist/services/settings/settings-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-service.d.ts","sourceRoot":"","sources":["../../../source/services/settings/settings-service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAG/D,OAAO,EAOL,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAC;AAqB9B;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,sBAAsB,CAAU;IACxC,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,cAAc,CAAiB;gBAE3B,OAAO,CAAC,EAAE;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,sBAAsB,CAAC,EAAE,OAAO,CAAC;QACjC,GAAG,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QAC5B,GAAG,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QAC5B,cAAc,CAAC,EAAE,cAAc,CAAC;KACjC;IA0HD,OAAO,CAAC,wBAAwB;IAyChC,OAAO,CAAC,wBAAwB;IAchC;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC;IAe5B;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa;IAIrC;;OAEG;IACH,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzC;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIjC,OAAO,CAAC,uBAAuB;IA2B/B,OAAO,CAAC,0BAA0B;IAsBlC;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAsEnE;;;;OAIG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAmB5C;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IA6CzB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAOtD,OAAO,CAAC,YAAY;IAepB;;OAEG;IACH,MAAM,IAAI,mBAAmB;IAI7B;;;OAGG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,OAAO,CAAC,UAAU;IAalB;;OAEG;IACH,OAAO,CAAC,cAAc;CAGvB;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACxE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/services/settings/settings-service.js

@@ -0,0 +1,449 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import envPaths from 'env-paths';
+import { LoggingService } from '../logging/logging-service.js';
+import { getProvider, upsertProvider } from '../../providers/registry.js';
+import { createOpenAICompatibleProviderDefinition } from '../../providers/openai-compatible-lazy.js';
+import { DEFAULT_SETTINGS, OPTIONAL_DEFAULT_KEYS, RUNTIME_MODIFIABLE_SETTINGS, SENSITIVE_SETTING_KEYS, SettingsSchema, normalizeAppModes, } from './settings-schema.js';
+import { isTestEnvironment, parseBooleanEnv } from './settings-env.js';
+import { flattenSettings, mergeSettings, trackSettingSources } from './settings-merger.js';
+import { buildSettingsWithSources } from './settings-sources.js';
+import { hasMissingKeys, loadSettingsFromFile, saveSettingsToFile, stripSensitiveSettings, } from './settings-persistence.js';
+const paths = envPaths('term2');
+function cloneSettingValue(value) {
+    if (value == null || typeof value !== 'object') {
+        return value;
+    }
+    return structuredClone(value);
+}
+/**
+ * Service for managing application settings.
+ * Follows singleton pattern and supports:
+ * - XDG-compliant storage
+ * - Hierarchical precedence (CLI > Env > Config > Defaults)
+ * - Zod validation with graceful degradation
+ * - Runtime-modifiable vs startup-only settings
+ * - Setting source tracking
+ */
+export class SettingsService {
+    settings;
+    sources;
+    settingsDir;
+    disableLogging;
+    disableFilePersistence;
+    listeners = new Set();
+    loggingService;
+    constructor(options) {
+        const { settingsDir = path.join(paths.log), disableLogging = false, disableFilePersistence, cli = {}, env = {}, loggingService, } = options ?? {};
+        const resolvedDisableLogging = disableLogging || parseBooleanEnv(process.env.DISABLE_LOGGING);
+        this.settingsDir = settingsDir;
+        this.disableLogging = resolvedDisableLogging;
+        this.sources = new Map();
+        // Use injected LoggingService or create a new one if not provided
+        this.loggingService =
+            loggingService ||
+                new LoggingService({
+                    disableLogging: this.disableLogging,
+                });
+        // Disk persistence can be explicitly disabled (e.g., for tests), and is
+        // also automatically disabled when running under a known test runner.
+        this.disableFilePersistence = disableFilePersistence ?? isTestEnvironment();
+        // Ensure settings directory exists
+        if (!fs.existsSync(this.settingsDir)) {
+            try {
+                fs.mkdirSync(this.settingsDir, { recursive: true });
+            }
+            catch (error) {
+                if (!this.disableLogging) {
+                    this.loggingService.error('Failed to create settings directory', {
+                        error: error instanceof Error ? error.message : String(error),
+                        path: this.settingsDir,
+                    });
+                }
+            }
+        }
+        // Load settings with precedence: CLI > Env > Config > Default
+        const settingsFilePath = path.join(this.settingsDir, 'settings.json');
+        const configFileExisted = fs.existsSync(settingsFilePath);
+        const { validated: fileConfig, raw: rawFileConfig, hadErrors: fileHadErrors } = this.loadFromFile();
+        this.settings = mergeSettings(DEFAULT_SETTINGS, fileConfig, env, cli, {
+            disableLogging: this.disableLogging,
+            loggingService: this.loggingService,
+        });
+        this.sources = trackSettingSources(DEFAULT_SETTINGS, fileConfig, env, cli);
+        // Normalize exclusive app modes so conflicting persisted state is resolved
+        // on load, not lazily at first set() call.
+        {
+            const app = this.settings.app ?? {};
+            const normalized = normalizeAppModes({
+                orchestratorMode: app.orchestratorMode ?? false,
+                liteMode: app.liteMode ?? false,
+                planMode: app.planMode ?? false,
+                mentorMode: app.mentorMode ?? false,
+            });
+            this.settings.app = { ...app, ...normalized };
+        }
+        // Register any runtime-defined providers from settings.json so they appear
+        // in the model selection menu and can be selected as agent.provider.
+        this.registerRuntimeProviders();
+        // Validate selected provider and fall back if invalid (without rejecting the
+        // entire settings file).
+        this.validateSelectedProvider();
+        // Apply logging level from settings to the logging service so it respects settings
+        try {
+            this.loggingService.setLogLevel(this.settings.logging.logLevel);
+            this.loggingService.setSuppressConsoleOutput(this.settings.logging.suppressConsoleOutput);
+        }
+        catch (error) {
+            if (!this.disableLogging) {
+                this.loggingService.warn('Failed to apply logging level from settings', {
+                    error: error instanceof Error ? error.message : String(error),
+                    loggingLevel: this.settings.logging.logLevel,
+                });
+            }
+        }
+        if (!this.disableLogging) {
+            this.loggingService.debug('SettingsService initialized', {
+                cliOverrides: Object.keys(flattenSettings(cli)).length > 0,
+                envOverrides: Object.keys(flattenSettings(env)).length > 0,
+                configOverrides: Object.keys(flattenSettings(fileConfig)).length > 0,
+            });
+        }
+        // Check if file config is missing any keys that exist in defaults
+        // Use raw file config (pre-Zod) to detect missing keys since Zod adds defaults
+        const shouldUpdateFile = configFileExisted && this.hasMissingKeys(rawFileConfig, DEFAULT_SETTINGS);
+        // If there was no config file on disk, persist the current merged settings so
+        // users get a settings.json created at startup (rather than waiting for a
+        // manual change). saveToFile is safe and handles errors/logging internally.
+        // Also update the file if new settings have been added since the file was created.
+        if (!configFileExisted) {
+            if (!this.disableFilePersistence) {
+                this.saveToFile();
+                if (!this.disableLogging) {
+                    this.loggingService.debug('Created settings file at startup', {
+                        settingsFile: settingsFilePath,
+                    });
+                }
+            }
+        }
+        else if (shouldUpdateFile && !fileHadErrors) {
+            if (!this.disableFilePersistence) {
+                this.saveToFile();
+                if (!this.disableLogging) {
+                    this.loggingService.debug('Updated settings file with new default values', {
+                        settingsFile: settingsFilePath,
+                    });
+                }
+            }
+        }
+    }
+    registerRuntimeProviders() {
+        const configured = this.settings?.providers;
+        if (!Array.isArray(configured) || configured.length === 0)
+            return;
+        for (const p of configured) {
+            const providerId = p?.name;
+            const baseUrl = p?.baseUrl;
+            const providerType = String(p?.type || '');
+            const baseUrlOptional = providerType === 'anthropic' || providerType === 'google' || providerType === 'opencode';
+            if (!providerId || (!baseUrl && !baseUrlOptional))
+                continue;
+            const existing = getProvider(providerId);
+            if (existing && !existing.isRuntimeDefined) {
+                if (!this.disableLogging) {
+                    this.loggingService.warn('Skipping custom provider because it conflicts with a built-in provider id', {
+                        providerId,
+                    });
+                }
+                continue;
+            }
+            try {
+                upsertProvider(createOpenAICompatibleProviderDefinition({
+                    name: String(providerId),
+                    type: p?.type ? String(p.type) : 'openai-compatible',
+                    baseUrl: baseUrl ? String(baseUrl) : undefined,
+                    apiKey: p?.apiKey ? String(p.apiKey) : undefined,
+                }));
+            }
+            catch (error) {
+                if (!this.disableLogging) {
+                    this.loggingService.warn('Failed to register custom provider', {
+                        providerId,
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                }
+            }
+        }
+    }
+    validateSelectedProvider() {
+        const current = this.settings?.agent?.provider || 'openai';
+        if (getProvider(current))
+            return;
+        if (!this.disableLogging) {
+            this.loggingService.warn('Configured agent.provider is not registered; falling back to openai', {
+                provider: current,
+            });
+        }
+        this.settings.agent.provider = 'openai';
+        this.sources.set('agent.provider', 'default');
+    }
+    /**
+     * Get a setting value by dot-notation key (e.g., 'agent.model')
+     */
+    get(key) {
+        const keys = key.split('.');
+        let value = this.settings;
+        for (const k of keys) {
+            if (value && typeof value === 'object') {
+                value = value[k];
+            }
+            else {
+                return undefined;
+            }
+        }
+        return value;
+    }
+    /**
+     * Get the source of a setting
+     */
+    getSource(key) {
+        return this.sources.get(key) || 'default';
+    }
+    /**
+     * Check if a setting is runtime-modifiable
+     */
+    isRuntimeModifiable(key) {
+        return RUNTIME_MODIFIABLE_SETTINGS.has(key);
+    }
+    /**
+     * Check if a setting is sensitive and should not be saved to disk
+     */
+    isSensitive(key) {
+        return SENSITIVE_SETTING_KEYS.has(key);
+    }
+    validateAndApplySetting(key, value) {
+        const nextSettings = structuredClone(this.settings);
+        const keys = key.split('.');
+        let obj = nextSettings;
+        for (let i = 0; i < keys.length - 1; i++) {
+            if (!obj[keys[i]]) {
+                obj[keys[i]] = {};
+            }
+            obj = obj[keys[i]];
+        }
+        obj[keys[keys.length - 1]] = value;
+        const result = SettingsSchema.safeParse(nextSettings);
+        if (!result.success) {
+            const matchingIssue = result.error.issues.find((issue) => issue.path.join('.') === key) ?? result.error.issues[0];
+            const issuePath = matchingIssue?.path?.join('.') || key;
+            const issueMessage = matchingIssue?.message || 'Invalid setting value';
+            throw new Error(`Invalid value for '${issuePath}': ${issueMessage}`);
+        }
+        this.settings = result.data;
+        this.validateSelectedProvider();
+    }
+    normalizeExclusiveAppModes(key, value) {
+        if (!key.startsWith('app.') ||
+            (key !== 'app.orchestratorMode' &&
+                key !== 'app.liteMode' &&
+                key !== 'app.planMode' &&
+                key !== 'app.mentorMode') ||
+            value !== true) {
+            return;
+        }
+        const app = this.settings.app ?? {};
+        this.settings.app = {
+            ...app,
+            orchestratorMode: key === 'app.orchestratorMode',
+            liteMode: key === 'app.liteMode',
+            planMode: key === 'app.planMode',
+            mentorMode: key === 'app.mentorMode',
+        };
+    }
+    /**
+     * Set a setting value (runtime modification)
+     * Only runtime-modifiable settings can be changed.
+     * Sensitive settings cannot be modified (must come from environment).
+     */
+    set(key, value, options) {
+        if (this.isSensitive(key)) {
+            throw new Error(`Cannot modify '${key}' - it is a sensitive setting that can only be configured via environment variables.`);
+        }
+        if (!this.isRuntimeModifiable(key)) {
+            throw new Error(`Cannot modify '${key}' at runtime. Requires restart.`);
+        }
+        this.validateAndApplySetting(key, value);
+        this.normalizeExclusiveAppModes(key, value);
+        // Track source as 'cli' for runtime-set values
+        this.sources.set(key, 'cli');
+        // Enforce exclusive app mode invariants. When one mode is enabled, all
+        // sibling modes are cleared.  This is the single enforcement point so
+        // that neither slash-command handlers nor direct set() calls can bypass
+        // mutual exclusion.  (normalizeAppModes implements the precedence.)
+        if (key.startsWith('app.') &&
+            (key === 'app.orchestratorMode' || key === 'app.liteMode' || key === 'app.planMode' || key === 'app.mentorMode')) {
+            if (value === true) {
+                for (const modeKey of ['app.orchestratorMode', 'app.liteMode', 'app.planMode', 'app.mentorMode']) {
+                    if (modeKey !== key) {
+                        this.sources.set(modeKey, 'cli');
+                    }
+                }
+            }
+        }
+        // If we're changing the logging level, update the logging service runtime
+        if (key === 'logging.logLevel') {
+            try {
+                this.loggingService.setLogLevel(value);
+            }
+            catch (err) {
+                if (!this.disableLogging) {
+                    this.loggingService.warn('Failed to update logging level at runtime', {
+                        error: err instanceof Error ? err.message : String(err),
+                        loggingLevel: value,
+                    });
+                }
+            }
+        }
+        if (key === 'logging.suppressConsoleOutput') {
+            try {
+                this.loggingService.setSuppressConsoleOutput(Boolean(value));
+            }
+            catch (err) {
+                if (!this.disableLogging) {
+                    this.loggingService.warn('Failed to update console output suppression at runtime', {
+                        error: err instanceof Error ? err.message : String(err),
+                        suppressConsoleOutput: value,
+                    });
+                }
+            }
+        }
+        // Persist to file unless the caller explicitly opts out
+        const persist = options?.persist !== false;
+        if (persist && !this.disableFilePersistence) {
+            this.saveToFile();
+        }
+        this.notifyChange(key);
+    }
+    /**
+     * Persist a setting even if it only takes effect after restart.
+     * This still validates against the full schema and updates in-memory state
+     * so the settings UI reflects the saved value immediately.
+     */
+    setPersistent(key, value) {
+        if (this.isSensitive(key)) {
+            throw new Error(`Cannot modify '${key}' - it is a sensitive setting that can only be configured via environment variables.`);
+        }
+        this.validateAndApplySetting(key, value);
+        this.normalizeExclusiveAppModes(key, value);
+        this.sources.set(key, 'cli');
+        if (!this.disableFilePersistence) {
+            this.saveToFile();
+        }
+        this.notifyChange(key);
+    }
+    /**
+     * Reset a setting to its default value.
+     * Sensitive settings cannot be reset as they should only come from env.
+     */
+    reset(key) {
+        if (key && this.isSensitive(key)) {
+            throw new Error(`Cannot reset '${key}' - it is a sensitive setting that can only be configured via environment variables.`);
+        }
+        if (key) {
+            // Reset specific setting
+            const keys = key.split('.');
+            let obj = this.settings;
+            // Navigate to parent
+            for (let i = 0; i < keys.length - 1; i++) {
+                if (!obj[keys[i]]) {
+                    obj[keys[i]] = {};
+                }
+                obj = obj[keys[i]];
+            }
+            // Reset to default
+            const lastKey = keys[keys.length - 1];
+            const defaultKeys = key.split('.');
+            let defaultValue = DEFAULT_SETTINGS;
+            for (const k of defaultKeys) {
+                defaultValue = defaultValue[k];
+            }
+            obj[lastKey] = cloneSettingValue(defaultValue);
+            this.sources.set(key, 'default');
+        }
+        else {
+            // Reset all settings
+            this.settings = JSON.parse(JSON.stringify(DEFAULT_SETTINGS));
+            this.sources.clear();
+        }
+        if (!this.disableFilePersistence) {
+            this.saveToFile();
+        }
+        this.notifyChange(key);
+    }
+    /**
+     * Subscribe to changes; returns an unsubscribe function.
+     */
+    onChange(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    notifyChange(changedKey) {
+        for (const listener of this.listeners) {
+            try {
+                listener(changedKey);
+            }
+            catch (error) {
+                if (!this.disableLogging) {
+                    this.loggingService.warn('Settings change listener threw', {
+                        error: error instanceof Error ? error.message : String(error),
+                        changedKey,
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Get all settings with their sources
+     */
+    getAll() {
+        return buildSettingsWithSources(this.settings, (key) => this.getSource(key));
+    }
+    /**
+     * Load settings from file
+     * Returns both raw (pre-Zod) and validated data
+     */
+    loadFromFile() {
+        return loadSettingsFromFile({
+            settingsDir: this.settingsDir,
+            schema: SettingsSchema,
+            disableLogging: this.disableLogging,
+            loggingService: this.loggingService,
+        });
+    }
+    /**
+     * Save settings to file, excluding sensitive values
+     */
+    saveToFile() {
+        if (this.disableFilePersistence) {
+            return;
+        }
+        saveSettingsToFile({
+            settingsDir: this.settingsDir,
+            settings: this.settings,
+            stripSensitiveSettings,
+            disableLogging: this.disableLogging,
+            loggingService: this.loggingService,
+        });
+    }
+    /**
+     * Check if target object is missing any keys that exist in source
+     */
+    hasMissingKeys(target, source, prefix = '') {
+        return hasMissingKeys(target, source, OPTIONAL_DEFAULT_KEYS, prefix);
+    }
+}
+export { buildEnvOverrides } from './settings-env.js';
+export { SETTING_KEYS, SENSITIVE_SETTINGS } from './settings-schema.js';
+//# sourceMappingURL=settings-service.js.map

package/dist/services/settings/settings-service.js.map

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

package/dist/services/settings/settings-service.mock.d.ts

@@ -0,0 +1,20 @@
+import { SettingsService } from './settings-service.js';
+/**
+ * Creates a mock SettingsService instance for testing.
+ * This prevents tests from modifying the user's actual settings file
+ * and ensures test isolation by using unique temporary directories.
+ *
+ * @param overrides - Optional settings to override defaults (supports dot-notation keys)
+ * @returns A mock SettingsService instance
+ */
+export declare function createMockSettingsService(overrides?: Partial<{
+    [key: string]: any;
+}>): SettingsService;
+/**
+ * Mock settings service instance for testing.
+ * This is a pre-configured mock that can be used in tests.
+ * Note: If you modify settings on this instance, other tests using it will verify those changes.
+ * For true isolation, prefer calling createMockSettingsService() in your test setup.
+ */
+export declare const mockSettingsService: SettingsService;
+//# sourceMappingURL=settings-service.mock.d.ts.map

package/dist/services/settings/settings-service.mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-service.mock.d.ts","sourceRoot":"","sources":["../../../source/services/settings/settings-service.mock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AA0BxD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,GAAE,OAAO,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,CAAM,GACN,eAAe,CAgBjB;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,iBAA8B,CAAC"}

package/dist/services/settings/settings-service.mock.js

@@ -0,0 +1,55 @@
+import { SettingsService } from './settings-service.js';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { mkdtempSync } from 'fs';
+/**
+ * Helper to unflatten dot-notation keys into nested objects.
+ * e.g. {'agent.model': 'gpt-4'} -> {agent: {model: 'gpt-4'}}
+ */
+function unflatten(data) {
+    const result = {};
+    for (const key in data) {
+        if (Object.prototype.hasOwnProperty.call(data, key)) {
+            const parts = key.split('.');
+            let current = result;
+            for (let i = 0; i < parts.length - 1; i++) {
+                const part = parts[i];
+                current[part] = current[part] || {};
+                current = current[part];
+            }
+            current[parts[parts.length - 1]] = data[key];
+        }
+    }
+    return result;
+}
+/**
+ * Creates a mock SettingsService instance for testing.
+ * This prevents tests from modifying the user's actual settings file
+ * and ensures test isolation by using unique temporary directories.
+ *
+ * @param overrides - Optional settings to override defaults (supports dot-notation keys)
+ * @returns A mock SettingsService instance
+ */
+export function createMockSettingsService(overrides = {}) {
+    // Create a unique temporary directory for each mock instance
+    // This ensures tests running in parallel don't interfere with each other
+    const tempDir = mkdtempSync(join(tmpdir(), 'term2-test-'));
+    // Unflatten overrides so they match the nested structure expected by SettingsService
+    // This allows passing {'agent.model': 'val'} convenience keys
+    const nestedOverrides = unflatten(overrides);
+    // Create a mock settings service with isolated storage
+    return new SettingsService({
+        settingsDir: tempDir,
+        disableLogging: true, // Disable logging for tests
+        disableFilePersistence: true, // Never write settings.json during tests
+        cli: nestedOverrides, // Apply any overrides
+    });
+}
+/**
+ * Mock settings service instance for testing.
+ * This is a pre-configured mock that can be used in tests.
+ * Note: If you modify settings on this instance, other tests using it will verify those changes.
+ * For true isolation, prefer calling createMockSettingsService() in your test setup.
+ */
+export const mockSettingsService = createMockSettingsService();
+//# sourceMappingURL=settings-service.mock.js.map