@subimpact/e 0.100.0 → 0.100.1

package/dist/core/settings-manager.js

@@ -1,1107 +0,0 @@
-import { DEFAULT_MAX_AGENT_RETRY_DELAY_MS } from "@earendil-works/pi-ai";
-import { randomUUID } from "crypto";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
-import { dirname, join } from "path";
-import lockfile from "proper-lockfile";
-import { CONFIG_DIR_NAME, getAgentDir, readAppEnv } from "../config.js";
-import { normalizePath, resolvePath } from "../utils/paths.js";
-import { stripBom } from "../utils/text.js";
-import { DEFAULT_HTTP_IDLE_TIMEOUT_MS, parseHttpIdleTimeoutMs } from "./http-dispatcher.js";
-const DEFAULT_COMPACTION_TOKEN_SETTINGS = {
-    reserveTokens: 16384,
-    keepRecentTokens: 20000,
-};
-/** Cache-warming profile. "idle" also warms between agent runs. */
-export const CACHE_WARMING_MODES = ["off", "streaming", "idle"];
-function isMergeableObject(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function deepMergeObjects(base, overrides) {
-    const result = { ...base };
-    for (const key of Object.keys(overrides)) {
-        const overrideValue = overrides[key];
-        if (overrideValue === undefined) {
-            continue;
-        }
-        const baseValue = base[key];
-        result[key] =
-            isMergeableObject(baseValue) && isMergeableObject(overrideValue)
-                ? deepMergeObjects(baseValue, overrideValue)
-                : overrideValue;
-    }
-    return result;
-}
-/** Tools enabled at startup when `defaultTools` does not change them. */
-export const DEFAULT_TOOL_NAMES = ["read", "bash", "edit", "write"];
-function isToolModifier(entry) {
-    return typeof entry === "string" && (entry.startsWith("+") || entry.startsWith("-"));
-}
-/**
- * Merge `defaultTools` of two settings layers. A list with plain tool names replaces the inherited
- * one; a list of only `+name`/`-name` entries is appended, so it modifies the inherited selection.
- */
-function mergeDefaultTools(base, overrides) {
-    if (overrides === undefined)
-        return base;
-    // Settings files are not validated; a malformed value replaces instead of throwing here.
-    if (!Array.isArray(base) || !Array.isArray(overrides) || !overrides.every(isToolModifier))
-        return overrides;
-    return [...base, ...overrides];
-}
-/**
- * Resolve a merged `defaultTools` list: plain names replace `DEFAULT_TOOL_NAMES`, then `+name` adds
- * and `-name` removes a tool, in list order.
- */
-function resolveDefaultTools(entries) {
-    const plain = entries.filter((entry) => !isToolModifier(entry));
-    const tools = plain.length > 0 || entries.length === 0 ? plain : [...DEFAULT_TOOL_NAMES];
-    for (const entry of entries) {
-        if (!isToolModifier(entry))
-            continue;
-        const name = entry.slice(1);
-        const index = tools.indexOf(name);
-        if (entry.startsWith("+") && index === -1 && name)
-            tools.push(name);
-        else if (entry.startsWith("-") && index !== -1)
-            tools.splice(index, 1);
-    }
-    return tools;
-}
-/** Deep merge settings: project/overrides take precedence, nested objects merge recursively */
-function deepMergeSettings(base, overrides) {
-    const merged = deepMergeObjects(base, overrides);
-    const defaultTools = mergeDefaultTools(base.defaultTools, overrides.defaultTools);
-    return defaultTools === undefined ? merged : { ...merged, defaultTools };
-}
-function parseTimeoutSetting(value, settingName) {
-    const timeoutMs = parseHttpIdleTimeoutMs(value);
-    if (timeoutMs !== undefined) {
-        return timeoutMs;
-    }
-    if (value !== undefined) {
-        throw new Error(`Invalid ${settingName} setting: ${String(value)}`);
-    }
-    return undefined;
-}
-function toSettingsError(scope, error, path) {
-    return {
-        scope,
-        ...(path ? { path } : {}),
-        error: error instanceof Error ? error : new Error(String(error)),
-    };
-}
-export class FileSettingsStorage {
-    globalSettingsPath;
-    projectSettingsPath;
-    constructor(cwd, agentDir) {
-        const resolvedCwd = resolvePath(cwd);
-        const resolvedAgentDir = resolvePath(agentDir);
-        this.globalSettingsPath = join(resolvedAgentDir, "settings.json");
-        this.projectSettingsPath = join(resolvedCwd, CONFIG_DIR_NAME, "settings.json");
-    }
-    acquireLockSyncWithRetry(path) {
-        const maxAttempts = 10;
-        const delayMs = 20;
-        let lastError;
-        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-            try {
-                return lockfile.lockSync(path, { realpath: false });
-            }
-            catch (error) {
-                const code = typeof error === "object" && error !== null && "code" in error
-                    ? String(error.code)
-                    : undefined;
-                if (code !== "ELOCKED" || attempt === maxAttempts) {
-                    throw error;
-                }
-                lastError = error;
-                const start = Date.now();
-                while (Date.now() - start < delayMs) {
-                    // Sleep synchronously to avoid changing callers to async.
-                }
-            }
-        }
-        throw lastError ?? new Error("Failed to acquire settings lock");
-    }
-    withLock(scope, fn) {
-        const path = scope === "global" ? this.globalSettingsPath : this.projectSettingsPath;
-        const dir = dirname(path);
-        let release;
-        try {
-            // Only create directory and lock if file exists or we need to write
-            const fileExists = existsSync(path);
-            if (fileExists) {
-                release = this.acquireLockSyncWithRetry(path);
-            }
-            const current = fileExists ? readFileSync(path, "utf-8") : undefined;
-            const next = fn(current);
-            if (next !== undefined) {
-                // Only create directory when we actually need to write
-                if (!existsSync(dir)) {
-                    mkdirSync(dir, { recursive: true });
-                }
-                if (!release) {
-                    release = this.acquireLockSyncWithRetry(path);
-                }
-                writeFileSync(path, next, "utf-8");
-            }
-        }
-        finally {
-            if (release) {
-                release();
-            }
-        }
-    }
-}
-export class InMemorySettingsStorage {
-    global;
-    project;
-    withLock(scope, fn) {
-        const current = scope === "global" ? this.global : this.project;
-        const next = fn(current);
-        if (next !== undefined) {
-            if (scope === "global") {
-                this.global = next;
-            }
-            else {
-                this.project = next;
-            }
-        }
-    }
-}
-export class SettingsManager {
-    storage;
-    globalSettings;
-    projectSettings;
-    settings;
-    projectTrusted;
-    modifiedFields = new Set(); // Track global fields modified during session
-    modifiedNestedFields = new Map(); // Track global nested field modifications
-    modifiedProjectFields = new Set(); // Track project fields modified during session
-    modifiedProjectNestedFields = new Map(); // Track project nested field modifications
-    globalSettingsLoadError = null; // Track if global settings file had parse errors
-    projectSettingsLoadError = null; // Track if project settings file had parse errors
-    writeQueue = Promise.resolve();
-    errors;
-    settingsPaths;
-    constructor(storage, initialGlobal, initialProject, globalLoadError = null, projectLoadError = null, initialErrors = [], projectTrusted = true, settingsPaths = {}) {
-        this.storage = storage;
-        this.globalSettings = initialGlobal;
-        this.projectSettings = initialProject;
-        this.projectTrusted = projectTrusted;
-        this.globalSettingsLoadError = globalLoadError;
-        this.projectSettingsLoadError = projectLoadError;
-        this.errors = [...initialErrors];
-        this.settingsPaths = settingsPaths;
-        this.settings = deepMergeSettings(this.globalSettings, this.projectSettings);
-    }
-    /** Create a SettingsManager that loads from files */
-    static create(cwd, agentDir = getAgentDir(), options = {}) {
-        const resolvedCwd = resolvePath(cwd);
-        const resolvedAgentDir = resolvePath(agentDir);
-        const storage = new FileSettingsStorage(resolvedCwd, resolvedAgentDir);
-        return SettingsManager.fromStorageWithPaths(storage, options, {
-            global: join(resolvedAgentDir, "settings.json"),
-            project: join(resolvedCwd, CONFIG_DIR_NAME, "settings.json"),
-        });
-    }
-    /** Create a SettingsManager from an arbitrary storage backend */
-    static fromStorage(storage, options = {}) {
-        return SettingsManager.fromStorageWithPaths(storage, options);
-    }
-    /** Create a manager while retaining optional file paths for reported storage errors. */
-    static fromStorageWithPaths(storage, options, settingsPaths = {}) {
-        const projectTrusted = options.projectTrusted ?? true;
-        const globalLoad = SettingsManager.tryLoadFromStorage(storage, "global");
-        const projectLoad = SettingsManager.tryLoadFromStorage(storage, "project", projectTrusted);
-        const initialErrors = [];
-        if (globalLoad.error) {
-            initialErrors.push(toSettingsError("global", globalLoad.error, settingsPaths.global));
-        }
-        if (projectLoad.error) {
-            initialErrors.push(toSettingsError("project", projectLoad.error, settingsPaths.project));
-        }
-        return new SettingsManager(storage, globalLoad.settings, projectLoad.settings, globalLoad.error, projectLoad.error, initialErrors, projectTrusted, settingsPaths);
-    }
-    /** Create an in-memory SettingsManager (no file I/O) */
-    static inMemory(settings = {}, options = {}) {
-        const storage = new InMemorySettingsStorage();
-        const initialSettings = SettingsManager.migrateSettings(structuredClone(settings));
-        storage.withLock("global", () => JSON.stringify(initialSettings, null, 2));
-        return SettingsManager.fromStorage(storage, options);
-    }
-    static loadFromStorage(storage, scope, projectTrusted = true) {
-        if (scope === "project" && !projectTrusted) {
-            return {};
-        }
-        let content;
-        storage.withLock(scope, (current) => {
-            content = current;
-            return undefined;
-        });
-        if (!content) {
-            return {};
-        }
-        const settings = JSON.parse(stripBom(content));
-        return SettingsManager.migrateSettings(settings);
-    }
-    static tryLoadFromStorage(storage, scope, projectTrusted = true) {
-        try {
-            return { settings: SettingsManager.loadFromStorage(storage, scope, projectTrusted), error: null };
-        }
-        catch (error) {
-            return { settings: {}, error: error };
-        }
-    }
-    /** Migrate old settings format to new format */
-    static migrateSettings(settings) {
-        // Migrate queueMode -> steeringMode
-        if ("queueMode" in settings && !("steeringMode" in settings)) {
-            settings.steeringMode = settings.queueMode;
-            delete settings.queueMode;
-        }
-        // Migrate legacy websockets boolean -> transport enum
-        if (!("transport" in settings) && typeof settings.websockets === "boolean") {
-            settings.transport = settings.websockets ? "websocket" : "sse";
-            delete settings.websockets;
-        }
-        // Migrate old skills object format to new array format
-        if ("skills" in settings &&
-            typeof settings.skills === "object" &&
-            settings.skills !== null &&
-            !Array.isArray(settings.skills)) {
-            const skillsSettings = settings.skills;
-            if (skillsSettings.enableSkillCommands !== undefined && settings.enableSkillCommands === undefined) {
-                settings.enableSkillCommands = skillsSettings.enableSkillCommands;
-            }
-            if (Array.isArray(skillsSettings.customDirectories) && skillsSettings.customDirectories.length > 0) {
-                settings.skills = skillsSettings.customDirectories;
-            }
-            else {
-                delete settings.skills;
-            }
-        }
-        // Migrate retry.maxDelayMs -> retry.provider.maxRetryDelayMs
-        if ("retry" in settings &&
-            typeof settings.retry === "object" &&
-            settings.retry !== null &&
-            !Array.isArray(settings.retry)) {
-            const retrySettings = settings.retry;
-            const providerSettings = typeof retrySettings.provider === "object" && retrySettings.provider !== null
-                ? retrySettings.provider
-                : undefined;
-            if (typeof retrySettings.maxDelayMs === "number" &&
-                (providerSettings?.maxRetryDelayMs === undefined || providerSettings?.maxRetryDelayMs === null)) {
-                retrySettings.provider = {
-                    ...(providerSettings ?? {}),
-                    maxRetryDelayMs: retrySettings.maxDelayMs,
-                };
-            }
-            delete retrySettings.maxDelayMs;
-        }
-        return settings;
-    }
-    /** A copy of the effective settings: global and project settings merged, with overrides. */
-    getSettings() {
-        return structuredClone(this.settings);
-    }
-    getGlobalSettings() {
-        return structuredClone(this.globalSettings);
-    }
-    getProjectSettings() {
-        return structuredClone(this.projectSettings);
-    }
-    isProjectTrusted() {
-        return this.projectTrusted;
-    }
-    setProjectTrusted(trusted) {
-        if (this.projectTrusted === trusted) {
-            return;
-        }
-        this.projectTrusted = trusted;
-        this.modifiedProjectFields.clear();
-        this.modifiedProjectNestedFields.clear();
-        if (!trusted) {
-            this.projectSettings = {};
-            this.projectSettingsLoadError = null;
-            this.settings = deepMergeSettings(this.globalSettings, this.projectSettings);
-            return;
-        }
-        const projectLoad = SettingsManager.tryLoadFromStorage(this.storage, "project", trusted);
-        this.projectSettings = projectLoad.settings;
-        this.projectSettingsLoadError = projectLoad.error;
-        if (projectLoad.error) {
-            this.recordError("project", projectLoad.error);
-        }
-        this.settings = deepMergeSettings(this.globalSettings, this.projectSettings);
-    }
-    async reload() {
-        await this.writeQueue;
-        const globalLoad = SettingsManager.tryLoadFromStorage(this.storage, "global");
-        if (!globalLoad.error) {
-            this.globalSettings = globalLoad.settings;
-            this.globalSettingsLoadError = null;
-        }
-        else {
-            this.globalSettingsLoadError = globalLoad.error;
-            this.recordError("global", globalLoad.error);
-        }
-        this.modifiedFields.clear();
-        this.modifiedNestedFields.clear();
-        this.modifiedProjectFields.clear();
-        this.modifiedProjectNestedFields.clear();
-        const projectLoad = SettingsManager.tryLoadFromStorage(this.storage, "project", this.projectTrusted);
-        if (!projectLoad.error) {
-            this.projectSettings = projectLoad.settings;
-            this.projectSettingsLoadError = null;
-        }
-        else {
-            this.projectSettingsLoadError = projectLoad.error;
-            this.recordError("project", projectLoad.error);
-        }
-        this.settings = deepMergeSettings(this.globalSettings, this.projectSettings);
-    }
-    /** Apply additional overrides on top of current settings */
-    applyOverrides(overrides) {
-        this.settings = deepMergeSettings(this.settings, overrides);
-    }
-    /** Mark a global field as modified during this session */
-    markModified(field, nestedKey) {
-        this.modifiedFields.add(field);
-        if (nestedKey) {
-            if (!this.modifiedNestedFields.has(field)) {
-                this.modifiedNestedFields.set(field, new Set());
-            }
-            this.modifiedNestedFields.get(field).add(nestedKey);
-        }
-    }
-    /** Mark a project field as modified during this session */
-    markProjectModified(field, nestedKey) {
-        this.modifiedProjectFields.add(field);
-        if (nestedKey) {
-            if (!this.modifiedProjectNestedFields.has(field)) {
-                this.modifiedProjectNestedFields.set(field, new Set());
-            }
-            this.modifiedProjectNestedFields.get(field).add(nestedKey);
-        }
-    }
-    assertProjectTrustedForWrite() {
-        if (!this.projectTrusted) {
-            throw new Error("Project is not trusted; refusing to write project settings");
-        }
-    }
-    recordError(scope, error) {
-        this.errors.push(toSettingsError(scope, error, this.settingsPaths[scope]));
-    }
-    clearModifiedScope(scope) {
-        if (scope === "global") {
-            this.modifiedFields.clear();
-            this.modifiedNestedFields.clear();
-            return;
-        }
-        this.modifiedProjectFields.clear();
-        this.modifiedProjectNestedFields.clear();
-    }
-    enqueueWrite(scope, task) {
-        this.writeQueue = this.writeQueue
-            .then(() => {
-            if (scope === "project") {
-                this.assertProjectTrustedForWrite();
-            }
-            task();
-            this.clearModifiedScope(scope);
-        })
-            .catch((error) => {
-            this.recordError(scope, error);
-        });
-    }
-    cloneModifiedNestedFields(source) {
-        const snapshot = new Map();
-        for (const [key, value] of source.entries()) {
-            snapshot.set(key, new Set(value));
-        }
-        return snapshot;
-    }
-    persistScopedSettings(scope, snapshotSettings, modifiedFields, modifiedNestedFields) {
-        this.storage.withLock(scope, (current) => {
-            const currentFileSettings = current
-                ? SettingsManager.migrateSettings(JSON.parse(stripBom(current)))
-                : {};
-            const mergedSettings = { ...currentFileSettings };
-            for (const field of modifiedFields) {
-                const value = snapshotSettings[field];
-                if (modifiedNestedFields.has(field) && typeof value === "object" && value !== null) {
-                    const nestedModified = modifiedNestedFields.get(field);
-                    const baseNested = currentFileSettings[field] ?? {};
-                    const inMemoryNested = value;
-                    const mergedNested = { ...baseNested };
-                    for (const nestedKey of nestedModified) {
-                        mergedNested[nestedKey] = inMemoryNested[nestedKey];
-                    }
-                    mergedSettings[field] = mergedNested;
-                }
-                else {
-                    mergedSettings[field] = value;
-                }
-            }
-            return JSON.stringify(mergedSettings, null, 2);
-        });
-    }
-    save() {
-        this.settings = deepMergeSettings(this.globalSettings, this.projectSettings);
-        if (this.globalSettingsLoadError) {
-            return;
-        }
-        const snapshotGlobalSettings = structuredClone(this.globalSettings);
-        const modifiedFields = new Set(this.modifiedFields);
-        const modifiedNestedFields = this.cloneModifiedNestedFields(this.modifiedNestedFields);
-        this.enqueueWrite("global", () => {
-            this.persistScopedSettings("global", snapshotGlobalSettings, modifiedFields, modifiedNestedFields);
-        });
-    }
-    saveProjectSettings(settings) {
-        this.assertProjectTrustedForWrite();
-        this.projectSettings = structuredClone(settings);
-        this.settings = deepMergeSettings(this.globalSettings, this.projectSettings);
-        if (this.projectSettingsLoadError) {
-            return;
-        }
-        const snapshotProjectSettings = structuredClone(this.projectSettings);
-        const modifiedFields = new Set(this.modifiedProjectFields);
-        const modifiedNestedFields = this.cloneModifiedNestedFields(this.modifiedProjectNestedFields);
-        this.enqueueWrite("project", () => {
-            this.persistScopedSettings("project", snapshotProjectSettings, modifiedFields, modifiedNestedFields);
-        });
-    }
-    updateProjectSettings(field, update) {
-        this.assertProjectTrustedForWrite();
-        const projectSettings = structuredClone(this.projectSettings);
-        update(projectSettings);
-        this.markProjectModified(field);
-        this.saveProjectSettings(projectSettings);
-    }
-    async flush() {
-        await this.writeQueue;
-    }
-    drainErrors() {
-        const drained = [...this.errors];
-        this.errors = [];
-        return drained;
-    }
-    getLastChangelogVersion() {
-        return this.settings.lastChangelogVersion;
-    }
-    setLastChangelogVersion(version) {
-        this.globalSettings.lastChangelogVersion = version;
-        this.markModified("lastChangelogVersion");
-        this.save();
-    }
-    getSessionDir() {
-        const sessionDir = this.settings.sessionDir;
-        return sessionDir ? normalizePath(sessionDir) : sessionDir;
-    }
-    getDefaultProvider() {
-        return this.settings.defaultProvider;
-    }
-    getDefaultModel() {
-        return this.settings.defaultModel;
-    }
-    setDefaultProvider(provider) {
-        this.globalSettings.defaultProvider = provider;
-        this.markModified("defaultProvider");
-        this.save();
-    }
-    setDefaultModel(modelId) {
-        this.globalSettings.defaultModel = modelId;
-        this.markModified("defaultModel");
-        this.save();
-    }
-    setDefaultModelAndProvider(provider, modelId) {
-        this.globalSettings.defaultProvider = provider;
-        this.globalSettings.defaultModel = modelId;
-        this.markModified("defaultProvider");
-        this.markModified("defaultModel");
-        this.save();
-    }
-    getSteeringMode() {
-        return this.settings.steeringMode || "one-at-a-time";
-    }
-    setSteeringMode(mode) {
-        this.globalSettings.steeringMode = mode;
-        this.markModified("steeringMode");
-        this.save();
-    }
-    getFollowUpMode() {
-        return this.settings.followUpMode || "one-at-a-time";
-    }
-    setFollowUpMode(mode) {
-        this.globalSettings.followUpMode = mode;
-        this.markModified("followUpMode");
-        this.save();
-    }
-    getThemeSetting() {
-        const value = this.settings.theme;
-        if (typeof value === "string")
-            return value;
-        return undefined;
-    }
-    getTheme() {
-        const theme = this.getThemeSetting();
-        return theme?.includes("/") ? undefined : theme;
-    }
-    setTheme(theme) {
-        this.globalSettings.theme = theme;
-        this.markModified("theme");
-        this.save();
-    }
-    getDefaultThinkingLevel() {
-        return this.settings.defaultThinkingLevel;
-    }
-    setDefaultThinkingLevel(level) {
-        this.globalSettings.defaultThinkingLevel = level;
-        this.markModified("defaultThinkingLevel");
-        this.save();
-    }
-    getModelThinkingLevel(provider, modelId) {
-        return this.settings.modelThinkingLevels?.[`${provider}/${modelId}`];
-    }
-    getAllModelThinkingLevels() {
-        return { ...(this.settings.modelThinkingLevels ?? {}) };
-    }
-    setModelThinkingLevel(provider, modelId, level) {
-        if (!this.globalSettings.modelThinkingLevels) {
-            this.globalSettings.modelThinkingLevels = {};
-        }
-        this.globalSettings.modelThinkingLevels[`${provider}/${modelId}`] = level;
-        this.markModified("modelThinkingLevels");
-        this.save();
-    }
-    removeModelThinkingLevel(provider, modelId) {
-        if (!this.globalSettings.modelThinkingLevels)
-            return;
-        delete this.globalSettings.modelThinkingLevels[`${provider}/${modelId}`];
-        if (Object.keys(this.globalSettings.modelThinkingLevels).length === 0) {
-            delete this.globalSettings.modelThinkingLevels;
-        }
-        this.markModified("modelThinkingLevels");
-        this.save();
-    }
-    getTransport() {
-        return this.settings.transport ?? "auto";
-    }
-    setTransport(transport) {
-        this.globalSettings.transport = transport;
-        this.markModified("transport");
-        this.save();
-    }
-    getCompactionEnabled() {
-        return this.settings.compaction?.enabled ?? true;
-    }
-    setCompactionEnabled(enabled) {
-        if (!this.globalSettings.compaction) {
-            this.globalSettings.compaction = {};
-        }
-        this.globalSettings.compaction.enabled = enabled;
-        this.markModified("compaction", "enabled");
-        this.save();
-    }
-    getCompactionTokenSetting(field, model) {
-        const compaction = this.settings.compaction;
-        const ordinary = compaction?.[field];
-        if (ordinary !== undefined && (typeof ordinary !== "number" || !Number.isSafeInteger(ordinary) || ordinary < 0)) {
-            throw new Error(`Invalid compaction.${field} setting: ${String(ordinary)}. Expected a non-negative safe integer.`);
-        }
-        const modelKey = model ? `${model.provider}/${model.id}` : undefined;
-        const entry = modelKey !== undefined ? compaction?.modelOverrides?.[modelKey] : undefined;
-        if (entry !== undefined && !isMergeableObject(entry)) {
-            throw new Error(`Invalid compaction.modelOverrides["${modelKey}"] setting: ${String(entry)}. Expected an object.`);
-        }
-        const override = entry?.[field];
-        if (override !== undefined && (typeof override !== "number" || !Number.isSafeInteger(override) || override < 0)) {
-            throw new Error(`Invalid compaction.modelOverrides["${modelKey}"].${field} setting: ${String(override)}. Expected a non-negative safe integer.`);
-        }
-        return override ?? ordinary ?? DEFAULT_COMPACTION_TOKEN_SETTINGS[field];
-    }
-    getCompactionReserveTokens(model) {
-        return this.getCompactionTokenSetting("reserveTokens", model);
-    }
-    getCompactionKeepRecentTokens(model) {
-        return this.getCompactionTokenSetting("keepRecentTokens", model);
-    }
-    /** Resolve each token setting through model override, ordinary setting, then built-in default. */
-    getCompactionSettings(model) {
-        return {
-            enabled: this.getCompactionEnabled(),
-            reserveTokens: this.getCompactionReserveTokens(model),
-            keepRecentTokens: this.getCompactionKeepRecentTokens(model),
-        };
-    }
-    getBranchSummarySettings() {
-        return {
-            reserveTokens: this.settings.branchSummary?.reserveTokens ?? 16384,
-            skipPrompt: this.settings.branchSummary?.skipPrompt ?? false,
-        };
-    }
-    getBranchSummarySkipPrompt() {
-        return this.settings.branchSummary?.skipPrompt ?? false;
-    }
-    getRetryEnabled() {
-        return this.settings.retry?.enabled ?? true;
-    }
-    setRetryEnabled(enabled) {
-        if (!this.globalSettings.retry) {
-            this.globalSettings.retry = {};
-        }
-        this.globalSettings.retry.enabled = enabled;
-        this.markModified("retry", "enabled");
-        this.save();
-    }
-    getRetrySettings() {
-        return {
-            enabled: this.getRetryEnabled(),
-            maxRetries: this.settings.retry?.maxRetries ?? 3,
-            baseDelayMs: this.settings.retry?.baseDelayMs ?? 2000,
-            maxAgentDelayMs: this.settings.retry?.maxAgentDelayMs ?? DEFAULT_MAX_AGENT_RETRY_DELAY_MS,
-        };
-    }
-    getHttpIdleTimeoutMs() {
-        return parseTimeoutSetting(this.settings.httpIdleTimeoutMs, "httpIdleTimeoutMs") ?? DEFAULT_HTTP_IDLE_TIMEOUT_MS;
-    }
-    setHttpIdleTimeoutMs(timeoutMs) {
-        if (!Number.isFinite(timeoutMs) || timeoutMs < 0) {
-            throw new Error(`Invalid httpIdleTimeoutMs setting: ${String(timeoutMs)}`);
-        }
-        this.globalSettings.httpIdleTimeoutMs = Math.floor(timeoutMs);
-        this.markModified("httpIdleTimeoutMs");
-        this.save();
-    }
-    /** Read from global settings only because warming costs money. */
-    getCacheWarmingMode() {
-        const mode = this.globalSettings.cacheWarming;
-        return mode !== undefined && CACHE_WARMING_MODES.includes(mode) ? mode : "streaming";
-    }
-    setCacheWarmingMode(mode) {
-        this.globalSettings.cacheWarming = mode;
-        this.markModified("cacheWarming");
-        this.save();
-    }
-    getProviderRetrySettings() {
-        return {
-            timeoutMs: this.settings.retry?.provider?.timeoutMs,
-            maxRetries: this.settings.retry?.provider?.maxRetries,
-            maxRetryDelayMs: this.settings.retry?.provider?.maxRetryDelayMs ?? 60000,
-        };
-    }
-    getWebSocketConnectTimeoutMs() {
-        return parseTimeoutSetting(this.settings.websocketConnectTimeoutMs, "websocketConnectTimeoutMs");
-    }
-    getHideThinkingBlock() {
-        return this.settings.hideThinkingBlock ?? false;
-    }
-    getShowCacheMissNotices() {
-        return this.settings.showCacheMissNotices ?? false;
-    }
-    getExternalEditorCommand() {
-        const configuredEditor = this.settings.externalEditor;
-        if (typeof configuredEditor === "string" && configuredEditor.trim() !== "") {
-            return configuredEditor;
-        }
-        const environmentEditor = process.env.VISUAL || process.env.EDITOR;
-        if (environmentEditor) {
-            return environmentEditor;
-        }
-        return process.platform === "win32" ? "notepad" : "nano";
-    }
-    setHideThinkingBlock(hide) {
-        this.globalSettings.hideThinkingBlock = hide;
-        this.markModified("hideThinkingBlock");
-        this.save();
-    }
-    setShowCacheMissNotices(show) {
-        this.globalSettings.showCacheMissNotices = show;
-        this.markModified("showCacheMissNotices");
-        this.save();
-    }
-    getShellPath() {
-        const shellPath = this.settings.shellPath;
-        return shellPath ? normalizePath(shellPath) : shellPath;
-    }
-    setShellPath(path) {
-        this.globalSettings.shellPath = path;
-        this.markModified("shellPath");
-        this.save();
-    }
-    getQuietStartup() {
-        return this.settings.quietStartup ?? false;
-    }
-    setQuietStartup(quiet) {
-        this.globalSettings.quietStartup = quiet;
-        this.markModified("quietStartup");
-        this.save();
-    }
-    getDefaultProjectTrust() {
-        const value = this.globalSettings.defaultProjectTrust;
-        return value === "always" || value === "never" ? value : "ask";
-    }
-    setDefaultProjectTrust(defaultProjectTrust) {
-        this.globalSettings.defaultProjectTrust = defaultProjectTrust;
-        this.markModified("defaultProjectTrust");
-        this.save();
-    }
-    getShellCommandPrefix() {
-        return this.settings.shellCommandPrefix;
-    }
-    setShellCommandPrefix(prefix) {
-        this.globalSettings.shellCommandPrefix = prefix;
-        this.markModified("shellCommandPrefix");
-        this.save();
-    }
-    getNpmCommand() {
-        return this.settings.npmCommand ? [...this.settings.npmCommand] : undefined;
-    }
-    setNpmCommand(command) {
-        this.globalSettings.npmCommand = command ? [...command] : undefined;
-        this.markModified("npmCommand");
-        this.save();
-    }
-    getCollapseChangelog() {
-        return this.settings.collapseChangelog ?? false;
-    }
-    setCollapseChangelog(collapse) {
-        this.globalSettings.collapseChangelog = collapse;
-        this.markModified("collapseChangelog");
-        this.save();
-    }
-    getEnableInstallTelemetry() {
-        // e fork: default OFF. This flag gates the pi-brand provider attribution headers
-        // (pi.dev referer, "Pi" billing origin) and the install ping. e makes no phone-home
-        // by default and does not attribute its users' traffic to upstream pi (promise 8).
-        // A user can still opt in explicitly with `enableInstallTelemetry: true`.
-        return this.settings.enableInstallTelemetry ?? false;
-    }
-    setEnableInstallTelemetry(enabled) {
-        this.globalSettings.enableInstallTelemetry = enabled;
-        this.markModified("enableInstallTelemetry");
-        this.save();
-    }
-    getEnableAnalytics() {
-        return this.settings.enableAnalytics ?? false;
-    }
-    getTrackingId() {
-        return this.settings.trackingId;
-    }
-    /** Set the analytics opt-in preference; generates a tracking identifier on first opt-in */
-    setEnableAnalytics(enabled) {
-        this.globalSettings.enableAnalytics = enabled;
-        this.markModified("enableAnalytics");
-        if (enabled && !this.globalSettings.trackingId) {
-            this.globalSettings.trackingId = randomUUID();
-            this.markModified("trackingId");
-        }
-        this.save();
-    }
-    /**
-     * Stable ID of this installation, e.g. sent to OpenAI as its agent host ID.
-     * Created on first use. Project settings are ignored so a committed project
-     * settings file cannot give every clone the same ID.
-     */
-    getOrCreateDeviceId() {
-        if (!this.globalSettings.deviceId) {
-            this.globalSettings.deviceId = randomUUID();
-            this.markModified("deviceId");
-            this.save();
-        }
-        return this.globalSettings.deviceId;
-    }
-    getPackages() {
-        return [...(this.settings.packages ?? [])];
-    }
-    setPackages(packages) {
-        this.globalSettings.packages = packages;
-        this.markModified("packages");
-        this.save();
-    }
-    setProjectPackages(packages) {
-        this.updateProjectSettings("packages", (settings) => {
-            settings.packages = packages;
-        });
-    }
-    getExtensionPaths() {
-        return [...(this.settings.extensions ?? [])];
-    }
-    setExtensionPaths(paths) {
-        this.globalSettings.extensions = paths;
-        this.markModified("extensions");
-        this.save();
-    }
-    setProjectExtensionPaths(paths) {
-        this.updateProjectSettings("extensions", (settings) => {
-            settings.extensions = paths;
-        });
-    }
-    getSkillPaths() {
-        return [...(this.settings.skills ?? [])];
-    }
-    setSkillPaths(paths) {
-        this.globalSettings.skills = paths;
-        this.markModified("skills");
-        this.save();
-    }
-    setProjectSkillPaths(paths) {
-        this.updateProjectSettings("skills", (settings) => {
-            settings.skills = paths;
-        });
-    }
-    getPromptTemplatePaths() {
-        return [...(this.settings.prompts ?? [])];
-    }
-    setPromptTemplatePaths(paths) {
-        this.globalSettings.prompts = paths;
-        this.markModified("prompts");
-        this.save();
-    }
-    setProjectPromptTemplatePaths(paths) {
-        this.updateProjectSettings("prompts", (settings) => {
-            settings.prompts = paths;
-        });
-    }
-    getThemePaths() {
-        return [...(this.settings.themes ?? [])];
-    }
-    setThemePaths(paths) {
-        this.globalSettings.themes = paths;
-        this.markModified("themes");
-        this.save();
-    }
-    setProjectThemePaths(paths) {
-        this.updateProjectSettings("themes", (settings) => {
-            settings.themes = paths;
-        });
-    }
-    getEnableSkillCommands() {
-        return this.settings.enableSkillCommands ?? true;
-    }
-    setEnableSkillCommands(enabled) {
-        this.globalSettings.enableSkillCommands = enabled;
-        this.markModified("enableSkillCommands");
-        this.save();
-    }
-    getThinkingBudgets() {
-        return this.settings.thinkingBudgets;
-    }
-    getTerminalCapabilityOverrides() {
-        const terminal = this.settings.terminal;
-        const images = terminal?.images;
-        return {
-            ...(images === "kitty" || images === "iterm2" ? { images } : images === false ? { images: null } : {}),
-            ...(typeof terminal?.trueColor === "boolean" ? { trueColor: terminal.trueColor } : {}),
-            ...(typeof terminal?.hyperlinks === "boolean" ? { hyperlinks: terminal.hyperlinks } : {}),
-        };
-    }
-    getShowImages() {
-        return this.settings.terminal?.showImages ?? true;
-    }
-    setShowImages(show) {
-        if (!this.globalSettings.terminal) {
-            this.globalSettings.terminal = {};
-        }
-        this.globalSettings.terminal.showImages = show;
-        this.markModified("terminal", "showImages");
-        this.save();
-    }
-    getImageWidthCells() {
-        const width = this.settings.terminal?.imageWidthCells;
-        if (typeof width !== "number" || !Number.isFinite(width)) {
-            return 60;
-        }
-        return Math.max(1, Math.floor(width));
-    }
-    setImageWidthCells(width) {
-        if (!this.globalSettings.terminal) {
-            this.globalSettings.terminal = {};
-        }
-        this.globalSettings.terminal.imageWidthCells = Math.max(1, Math.floor(width));
-        this.markModified("terminal", "imageWidthCells");
-        this.save();
-    }
-    getClearOnShrink() {
-        // Settings takes precedence, then env var, then default false
-        if (this.settings.terminal?.clearOnShrink !== undefined) {
-            return this.settings.terminal.clearOnShrink;
-        }
-        return readAppEnv("CLEAR_ON_SHRINK") === "1";
-    }
-    setClearOnShrink(enabled) {
-        if (!this.globalSettings.terminal) {
-            this.globalSettings.terminal = {};
-        }
-        this.globalSettings.terminal.clearOnShrink = enabled;
-        this.markModified("terminal", "clearOnShrink");
-        this.save();
-    }
-    getShowTerminalProgress() {
-        return this.settings.terminal?.showTerminalProgress ?? false;
-    }
-    setShowTerminalProgress(enabled) {
-        if (!this.globalSettings.terminal) {
-            this.globalSettings.terminal = {};
-        }
-        this.globalSettings.terminal.showTerminalProgress = enabled;
-        this.markModified("terminal", "showTerminalProgress");
-        this.save();
-    }
-    getTuiMode() {
-        return this.settings.tuiMode === "regular" ? "regular" : "fullscreen";
-    }
-    setTuiMode(mode) {
-        this.globalSettings.tuiMode = mode;
-        this.markModified("tuiMode");
-        this.save();
-    }
-    getFullscreenExitOutput() {
-        return this.settings.fullscreenExitOutput === "resume-hint" ? "resume-hint" : "transcript";
-    }
-    setFullscreenExitOutput(output) {
-        this.globalSettings.fullscreenExitOutput = output;
-        this.markModified("fullscreenExitOutput");
-        this.save();
-    }
-    getFullscreenScrollbar() {
-        const mode = this.settings.fullscreenScrollbar;
-        return mode === "always" || mode === "hidden" ? mode : "auto";
-    }
-    setFullscreenScrollbar(mode) {
-        this.globalSettings.fullscreenScrollbar = mode;
-        this.markModified("fullscreenScrollbar");
-        this.save();
-    }
-    getFullscreenCopyOnSelect() {
-        return this.settings.fullscreenCopyOnSelect ?? true;
-    }
-    setFullscreenCopyOnSelect(enabled) {
-        this.globalSettings.fullscreenCopyOnSelect = enabled;
-        this.markModified("fullscreenCopyOnSelect");
-        this.save();
-    }
-    getFullscreenWheelScrollLines() {
-        const lines = this.settings.fullscreenWheelScrollLines;
-        return typeof lines === "number" && Number.isFinite(lines)
-            ? Math.max(1, Math.min(100, Math.floor(lines)))
-            : "auto";
-    }
-    setFullscreenWheelScrollLines(lines) {
-        this.globalSettings.fullscreenWheelScrollLines =
-            lines === "auto" ? lines : Math.max(1, Math.min(100, Math.floor(lines)));
-        this.markModified("fullscreenWheelScrollLines");
-        this.save();
-    }
-    getImageAutoResize() {
-        return this.settings.images?.autoResize ?? true;
-    }
-    setImageAutoResize(enabled) {
-        if (!this.globalSettings.images) {
-            this.globalSettings.images = {};
-        }
-        this.globalSettings.images.autoResize = enabled;
-        this.markModified("images", "autoResize");
-        this.save();
-    }
-    getBlockImages() {
-        return this.settings.images?.blockImages ?? false;
-    }
-    setBlockImages(blocked) {
-        if (!this.globalSettings.images) {
-            this.globalSettings.images = {};
-        }
-        this.globalSettings.images.blockImages = blocked;
-        this.markModified("images", "blockImages");
-        this.save();
-    }
-    getEnabledModels() {
-        return this.settings.enabledModels;
-    }
-    /** The resolved `defaultTools` selection, or undefined when no settings layer sets it. */
-    getDefaultTools() {
-        const tools = this.settings.defaultTools;
-        if (tools === undefined)
-            return undefined;
-        return resolveDefaultTools(Array.isArray(tools) ? tools.filter((tool) => typeof tool === "string") : []);
-    }
-    setEnabledModels(patterns) {
-        this.globalSettings.enabledModels = patterns;
-        this.markModified("enabledModels");
-        this.save();
-    }
-    getDoubleEscapeAction() {
-        return this.settings.doubleEscapeAction ?? "tree";
-    }
-    setDoubleEscapeAction(action) {
-        this.globalSettings.doubleEscapeAction = action;
-        this.markModified("doubleEscapeAction");
-        this.save();
-    }
-    getTreeFilterMode() {
-        const mode = this.settings.treeFilterMode;
-        const valid = ["default", "no-tools", "user-only", "labeled-only", "all"];
-        return mode && valid.includes(mode) ? mode : "default";
-    }
-    setTreeFilterMode(mode) {
-        this.globalSettings.treeFilterMode = mode;
-        this.markModified("treeFilterMode");
-        this.save();
-    }
-    getShowHardwareCursor() {
-        return this.settings.showHardwareCursor ?? readAppEnv("HARDWARE_CURSOR") === "1";
-    }
-    setShowHardwareCursor(enabled) {
-        this.globalSettings.showHardwareCursor = enabled;
-        this.markModified("showHardwareCursor");
-        this.save();
-    }
-    getEditorPaddingX() {
-        return this.settings.editorPaddingX ?? 0;
-    }
-    setEditorPaddingX(padding) {
-        this.globalSettings.editorPaddingX = Math.max(0, Math.min(3, Math.floor(padding)));
-        this.markModified("editorPaddingX");
-        this.save();
-    }
-    getOutputPad() {
-        return this.settings.outputPad === 0 ? 0 : 1;
-    }
-    setOutputPad(padding) {
-        this.globalSettings.outputPad = padding;
-        this.markModified("outputPad");
-        this.save();
-    }
-    getAutocompleteMaxVisible() {
-        return this.settings.autocompleteMaxVisible ?? 5;
-    }
-    setAutocompleteMaxVisible(maxVisible) {
-        this.globalSettings.autocompleteMaxVisible = Math.max(3, Math.min(20, Math.floor(maxVisible)));
-        this.markModified("autocompleteMaxVisible");
-        this.save();
-    }
-    getCodeBlockIndent() {
-        return this.settings.markdown?.codeBlockIndent ?? "  ";
-    }
-    getMermaidRenderingMode() {
-        const mode = this.settings.markdown?.mermaid;
-        return mode === "off" || mode === "final" ? mode : "streaming";
-    }
-    setMermaidRenderingMode(mode) {
-        this.globalSettings.markdown ??= {};
-        this.globalSettings.markdown.mermaid = mode;
-        this.markModified("markdown", "mermaid");
-        this.save();
-    }
-    getWarnings() {
-        return { ...(this.settings.warnings ?? {}) };
-    }
-    setWarnings(warnings) {
-        this.globalSettings.warnings = { ...warnings };
-        this.markModified("warnings");
-        this.save();
-    }
-}
-//# sourceMappingURL=settings-manager.js.map