@ai-agent-forge/agent-forge 0.86.4 → 0.86.6

package/dist/core/settings-manager.js

@@ -7,6 +7,10 @@ import { CONFIG_DIR_NAME, getAgentDir } 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,
+};
 function isMergeableObject(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -25,9 +29,47 @@ function deepMergeObjects(base, overrides) {
     }
     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) {
-    return deepMergeObjects(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);
@@ -136,6 +178,7 @@ export class SettingsManager {
     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
+    capabilitiesWarningRecorded = false; // One capabilities-structure warning per manager lifetime
     writeQueue = Promise.resolve();
     errors;
     settingsPaths;
@@ -448,6 +491,59 @@ export class SettingsManager {
     getMemoryModeSetting() {
         return this.settings.memory?.mode;
     }
+    /**
+     * 能力槽位配置节（供应商能力槽位设计 §3.1）：返回合并层的原始
+     * `capabilities`。结构非法时记录一条 warning（经 drainErrors 以
+     * settings 诊断面呈现）并按 fail-closed 丢弃非法子节，不抛出、不崩溃；
+     * 槽位失效后由消费方（image-generation 插件）按 config_missing 报
+     * 可操作错误。warning 每实例至多记录一次。
+     */
+    getCapabilitiesSettings() {
+        const raw = this.settings.capabilities;
+        if (raw === undefined)
+            return undefined;
+        if (!isMergeableObject(raw)) {
+            this.recordCapabilitiesWarning("capabilities must be an object");
+            return undefined;
+        }
+        const imageGeneration = raw.imageGeneration;
+        if (imageGeneration === undefined)
+            return raw;
+        if (!isMergeableObject(imageGeneration)) {
+            this.recordCapabilitiesWarning("capabilities.imageGeneration must be an object");
+            return undefined;
+        }
+        const provider = imageGeneration.provider;
+        if (typeof provider !== "string" || provider.trim() === "") {
+            this.recordCapabilitiesWarning(`capabilities.imageGeneration.provider must be a non-empty string: ${String(provider)}`);
+            return undefined;
+        }
+        const model = imageGeneration.model;
+        if (model !== undefined && (typeof model !== "string" || model.trim() === "")) {
+            this.recordCapabilitiesWarning(`capabilities.imageGeneration.model must be a non-empty string when present: ${String(model)}`);
+            return undefined;
+        }
+        const slot = { provider, ...(model === undefined ? {} : { model }) };
+        return { ...raw, imageGeneration: slot };
+    }
+    /**
+     * 主备切换配置节（设计 §4.1）：raw 读出，原样透传合并层对象。Phase 1
+     * 不做结构校验与默认值解析——那是 Phase 2 provider-failover 插件的
+     * 消费面；此处提前收窄会把非法值静默变成合法语义。
+     */
+    getFailoverSettings() {
+        const failover = this.settings.failover;
+        return failover === undefined ? undefined : { ...failover };
+    }
+    recordCapabilitiesWarning(message) {
+        if (this.capabilitiesWarningRecorded)
+            return;
+        this.capabilitiesWarningRecorded = true;
+        // 槽位在两层合并后读取，无法逐字段追溯来源层；capabilities 节存在
+        // 于哪层就归到哪层（project 层存在即以 project 呈现，与深合并优先级一致）。
+        const scope = isMergeableObject(this.projectSettings.capabilities) ? "project" : "global";
+        this.recordError(scope, new Error(`Invalid ${message}`));
+    }
     setDefaultProvider(provider) {
         this.globalSettings.defaultProvider = provider;
         this.markModified("defaultProvider");
@@ -547,11 +643,28 @@ export class SettingsManager {
         this.markModified("compaction", "enabled");
         this.save();
     }
-    getCompactionReserveTokens() {
-        return this.settings.compaction?.reserveTokens ?? 16384;
+    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() {
-        return this.settings.compaction?.keepRecentTokens ?? 20000;
+    getCompactionKeepRecentTokens(model) {
+        return this.getCompactionTokenSetting("keepRecentTokens", model);
     }
     getSummarySelfCritique() {
         return this.settings.compaction?.summarySelfCritique ?? false;
@@ -559,11 +672,12 @@ export class SettingsManager {
     getMicrocompactEnabled() {
         return this.settings.compaction?.microcompactEnabled ?? false;
     }
-    getCompactionSettings() {
+    /** Resolve each token setting through model override, ordinary setting, then built-in default. */
+    getCompactionSettings(model) {
         return {
             enabled: this.getCompactionEnabled(),
-            reserveTokens: this.getCompactionReserveTokens(),
-            keepRecentTokens: this.getCompactionKeepRecentTokens(),
+            reserveTokens: this.getCompactionReserveTokens(model),
+            keepRecentTokens: this.getCompactionKeepRecentTokens(model),
             microcompactEnabled: this.getMicrocompactEnabled(),
             summarySelfCritique: this.getSummarySelfCritique(),
         };
@@ -881,6 +995,18 @@ export class SettingsManager {
         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;
     }
@@ -906,9 +1032,12 @@ export class SettingsManager {
     getEnabledModels() {
         return this.settings.enabledModels;
     }
+    /** The resolved `defaultTools` selection, or undefined when no settings layer sets it. */
     getDefaultTools() {
         const tools = this.settings.defaultTools;
-        return tools ? [...tools] : undefined;
+        if (tools === undefined)
+            return undefined;
+        return resolveDefaultTools(Array.isArray(tools) ? tools.filter((tool) => typeof tool === "string") : []);
     }
     setEnabledModels(patterns) {
         this.globalSettings.enabledModels = patterns;