@caupulican/pi-adaptative 0.80.86 → 0.80.88

package/dist/core/settings-manager.js

@@ -6,11 +6,47 @@ import { basename, dirname, join, relative, resolve, sep } from "path";
 import lockfile from "proper-lockfile";
 import { CONFIG_DIR_NAME, getAgentDir, getProfilesDir } from "../config.js";
 import { normalizePath, resolvePath } from "../utils/paths.js";
+import { DEFAULT_GOAL_AUTO_CONTINUE, DEFAULT_GOAL_AUTO_CONTINUE_DELAY_MS, DEFAULT_GOAL_CONTINUE_MAX_STALL_TURNS, DEFAULT_GOAL_CONTINUE_MAX_TURNS, DEFAULT_GOAL_CONTINUE_MAX_WALL_CLOCK_MINUTES, MAX_GOAL_AUTO_CONTINUE_DELAY_MS, MAX_GOAL_CONTINUE_MAX_STALL_TURNS, MAX_GOAL_CONTINUE_MAX_TURNS, MAX_GOAL_CONTINUE_MAX_WALL_CLOCK_MINUTES, } from "./goals/goal-continuation-defaults.js";
 import { DEFAULT_HTTP_IDLE_TIMEOUT_MS, parseHttpIdleTimeoutMs } from "./http-dispatcher.js";
 import { ProfileRegistry } from "./profile-registry.js";
 import { mergeResourceProfileMap } from "./resource-profile-blocks.js";
 import { validateSkillName } from "./skills.js";
-export const DEFAULT_AUTONOMY_MAX_STALL_TURNS = 20;
+export const MEMORY_RETRIEVAL_MAX_RESULTS_MIN = 1;
+export const MEMORY_RETRIEVAL_MAX_RESULTS_MAX = 20;
+const MEMORY_RETRIEVAL_MAX_RESULTS_DEFAULT = 5;
+function clampMemoryRetrievalMaxResults(value) {
+    return Math.min(MEMORY_RETRIEVAL_MAX_RESULTS_MAX, Math.max(MEMORY_RETRIEVAL_MAX_RESULTS_MIN, Math.trunc(value)));
+}
+export const DEFAULT_AUTONOMY_MAX_STALL_TURNS = DEFAULT_GOAL_CONTINUE_MAX_STALL_TURNS;
+export const DEFAULT_AUTONOMY_GOAL_CONTINUE_TURNS = DEFAULT_GOAL_CONTINUE_MAX_TURNS;
+export const DEFAULT_AUTONOMY_GOAL_CONTINUE_MAX_WALL_CLOCK_MINUTES = DEFAULT_GOAL_CONTINUE_MAX_WALL_CLOCK_MINUTES;
+export const DEFAULT_AUTONOMY_GOAL_AUTO_CONTINUE = DEFAULT_GOAL_AUTO_CONTINUE;
+export const DEFAULT_AUTONOMY_GOAL_AUTO_CONTINUE_DELAY_MS = DEFAULT_GOAL_AUTO_CONTINUE_DELAY_MS;
+export const DEFAULT_RESEARCH_LANE_ENABLED = false;
+export const DEFAULT_RESEARCH_LANE_MAX_USD = 0.25;
+export const DEFAULT_RESEARCH_LANE_MAX_SOURCES = 8;
+export const DEFAULT_RESEARCH_LANE_MAX_FINDINGS = 10;
+export const DEFAULT_RESEARCH_LANE_MAX_WALL_CLOCK_MS = 120_000;
+export const DEFAULT_RESEARCH_LANE_IDLE_DELAY_MS = 0;
+export const DEFAULT_RESEARCH_LANE_MAX_RUNS_PER_SESSION = 10;
+export const MAX_RESEARCH_LANE_MAX_USD = 5;
+export const MAX_RESEARCH_LANE_MAX_SOURCES = 32;
+export const MAX_RESEARCH_LANE_MAX_FINDINGS = 50;
+export const MAX_RESEARCH_LANE_MAX_WALL_CLOCK_MS = 3_600_000;
+export const MAX_RESEARCH_LANE_IDLE_DELAY_MS = 300_000;
+export const MAX_RESEARCH_LANE_MAX_RUNS_PER_SESSION = 100;
+export const DEFAULT_WORKER_DELEGATION_ENABLED = false;
+export const DEFAULT_WORKER_DELEGATION_MAX_USD = 0.5;
+export const DEFAULT_WORKER_DELEGATION_MAX_WALL_CLOCK_MS = 120_000;
+export const MAX_WORKER_DELEGATION_MAX_USD = 5;
+export const MAX_WORKER_DELEGATION_MAX_WALL_CLOCK_MS = 3_600_000;
+export const DEFAULT_LEARNING_POLICY_ENABLED = false;
+export const DEFAULT_LEARNING_POLICY_AUTO_APPLY_ENABLED = false;
+export const DEFAULT_LEARNING_POLICY_CONFIDENCE_THRESHOLD = 90;
+export const DEFAULT_LEARNING_POLICY_MIN_OBSERVATIONS = 2;
+export const DEFAULT_LEARNING_POLICY_ALLOWED_AUTO_APPLY_LAYERS = ["memory"];
+export const DEFAULT_LEARNING_POLICY_REFLECTION_SOURCE_CONFIDENCE = 50;
+export const DEFAULT_MODEL_CAPABILITY_MODE = "auto";
 /** Deep merge settings: project/overrides take precedence, nested objects merge recursively */
 function deepMergeSettings(base, overrides) {
     const result = { ...base };
@@ -145,6 +181,20 @@ function parseTimeoutSetting(value, settingName) {
     }
     return undefined;
 }
+function sanitizeIntegerSetting(value, fallback, min, max) {
+    if (typeof value !== "number" || !Number.isInteger(value))
+        return fallback;
+    if (value < min || value > max)
+        return fallback;
+    return value;
+}
+function sanitizeNumberSetting(value, fallback, min, max) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return fallback;
+    if (value < min || value > max)
+        return fallback;
+    return value;
+}
 const VALID_THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh"];
 function isThinkingLevel(value) {
     return typeof value === "string" && VALID_THINKING_LEVELS.includes(value);
@@ -185,7 +235,7 @@ function normalizeModelRouterSettings(value) {
     const settings = {};
     if (typeof input.enabled === "boolean")
         settings.enabled = input.enabled;
-    for (const key of ["cheapModel", "expensiveModel", "learningModel"]) {
+    for (const key of ["cheapModel", "mediumModel", "expensiveModel", "learningModel"]) {
         const candidate = input[key];
         if (typeof candidate !== "string")
             continue;
@@ -579,11 +629,24 @@ export class SettingsManager {
         const profileFilter = {};
         const seenProfiles = new Set();
         const registry = this.getProfileRegistry();
-        for (const profileName of this.getActiveResourceProfileNames()) {
+        const activeProfileNames = this.getActiveResourceProfileNames();
+        let kindMentionedByProfile = false;
+        for (const profileName of activeProfileNames) {
             if (seenProfiles.has(profileName))
                 continue;
             seenProfiles.add(profileName);
-            appendFilter(profileFilter, registry.getProfile(profileName)?.resources[kind]);
+            const kindFilter = registry.getProfile(profileName)?.resources[kind];
+            if (kindFilter && ((kindFilter.allow?.length ?? 0) > 0 || (kindFilter.block?.length ?? 0) > 0)) {
+                kindMentionedByProfile = true;
+            }
+            appendFilter(profileFilter, kindFilter);
+        }
+        // Strict UAC: an active profile set is the COMPLETE grant. An authority-bearing kind that no
+        // active profile explicitly mentions is denied outright — grant-all must be said out loud
+        // via `allow: ["*"]`. Themes are exempt (cosmetic, no authority). With no active profile,
+        // behavior is unchanged: profiles are the opt-in least-privilege boundary.
+        if (activeProfileNames.length > 0 && kind !== "themes" && !kindMentionedByProfile) {
+            return { allow: [], block: ["*"] };
         }
         const filter = mergeResourceProfileFilters(legacyFilter, profileFilter);
         return {
@@ -1354,6 +1417,8 @@ export class SettingsManager {
                 merged.enabled = router.enabled;
             if (router.cheapModel !== undefined)
                 merged.cheapModel = router.cheapModel;
+            if (router.mediumModel !== undefined)
+                merged.mediumModel = router.mediumModel;
             if (router.expensiveModel !== undefined)
                 merged.expensiveModel = router.expensiveModel;
             if (router.learningModel !== undefined)
@@ -1366,22 +1431,31 @@ export class SettingsManager {
         const settings = {
             enabled: this.settings.modelRouter?.enabled ?? false,
             cheapModel: this.settings.modelRouter?.cheapModel?.trim() || undefined,
+            mediumModel: this.settings.modelRouter?.mediumModel?.trim() || undefined,
             expensiveModel: this.settings.modelRouter?.expensiveModel?.trim() || undefined,
             learningModel: this.settings.modelRouter?.learningModel?.trim() || undefined,
+            judgeEnabled: this.settings.modelRouter?.judgeEnabled ?? true,
+            judgeModel: this.settings.modelRouter?.judgeModel?.trim() || undefined,
         };
         return {
             enabled: profileSettings?.enabled ?? settings.enabled,
             cheapModel: profileSettings?.cheapModel?.trim() || settings.cheapModel,
+            mediumModel: profileSettings?.mediumModel?.trim() || settings.mediumModel,
             expensiveModel: profileSettings?.expensiveModel?.trim() || settings.expensiveModel,
             learningModel: profileSettings?.learningModel?.trim() || settings.learningModel,
+            judgeEnabled: profileSettings?.judgeEnabled ?? settings.judgeEnabled,
+            judgeModel: profileSettings?.judgeModel?.trim() || settings.judgeModel,
         };
     }
     setModelRouterSettings(settings, scope = "global") {
         const normalized = {
             enabled: settings.enabled ?? false,
             cheapModel: settings.cheapModel?.trim() || undefined,
+            mediumModel: settings.mediumModel?.trim() || undefined,
             expensiveModel: settings.expensiveModel?.trim() || undefined,
             learningModel: settings.learningModel?.trim() || undefined,
+            judgeEnabled: settings.judgeEnabled ?? true,
+            judgeModel: settings.judgeModel?.trim() || undefined,
         };
         if (scope === "project") {
             const projectSettings = structuredClone(this.projectSettings);
@@ -1439,6 +1513,10 @@ export class SettingsManager {
                 preserveRecentPages: this.settings.contextGc?.semanticMemory?.preserveRecentPages ?? 1,
                 minChars: this.settings.contextGc?.semanticMemory?.minChars ?? 900,
                 markers: this.settings.contextGc?.semanticMemory?.markers ?? [
+                    // Generic recall-page marker the bundled default provider (transcript-recall)
+                    // emits; must be present here because a non-empty settings list fully replaces
+                    // the context-gc code default that already includes it.
+                    "<memory_context",
                     "<automata_context",
                     "<automata_response",
                     "<automata_query",
@@ -1452,6 +1530,49 @@ export class SettingsManager {
             },
         };
     }
+    getContextPromptEnforcementSettings() {
+        return {
+            enabled: this.settings.contextPolicy?.enforcement?.enabled ?? false,
+            preserveRecentMessages: this.settings.contextPolicy?.enforcement?.preserveRecentMessages ?? 8,
+            minChars: this.settings.contextPolicy?.enforcement?.minChars ?? 1200,
+        };
+    }
+    setContextPromptEnforcementSettings(settings, scope = "global") {
+        if (scope === "project") {
+            const projectSettings = structuredClone(this.projectSettings);
+            projectSettings.contextPolicy = { ...projectSettings.contextPolicy, enforcement: { ...settings } };
+            this.markProjectModified("contextPolicy");
+            this.saveProjectSettings(projectSettings);
+            return;
+        }
+        this.globalSettings.contextPolicy = { ...this.globalSettings.contextPolicy, enforcement: { ...settings } };
+        this.markModified("contextPolicy");
+        this.save();
+    }
+    getMemoryRetrievalSettings() {
+        return {
+            enabled: this.settings.contextPolicy?.memory?.enabled ?? false,
+            maxResults: clampMemoryRetrievalMaxResults(this.settings.contextPolicy?.memory?.maxResults ?? MEMORY_RETRIEVAL_MAX_RESULTS_DEFAULT),
+            includeInPrompt: this.settings.contextPolicy?.memory?.includeInPrompt ?? false,
+        };
+    }
+    setMemoryRetrievalSettings(settings, scope = "global") {
+        const normalized = {
+            enabled: settings.enabled,
+            maxResults: settings.maxResults === undefined ? undefined : clampMemoryRetrievalMaxResults(settings.maxResults),
+            includeInPrompt: settings.includeInPrompt,
+        };
+        if (scope === "project") {
+            const projectSettings = structuredClone(this.projectSettings);
+            projectSettings.contextPolicy = { ...projectSettings.contextPolicy, memory: normalized };
+            this.markProjectModified("contextPolicy");
+            this.saveProjectSettings(projectSettings);
+            return;
+        }
+        this.globalSettings.contextPolicy = { ...this.globalSettings.contextPolicy, memory: normalized };
+        this.markModified("contextPolicy");
+        this.save();
+    }
     getBranchSummarySettings() {
         return {
             reserveTokens: this.settings.branchSummary?.reserveTokens ?? 16384,
@@ -1798,11 +1919,25 @@ export class SettingsManager {
     }
     getAutonomySettings() {
         const mode = this.settings.autonomy?.mode;
-        const configuredRounds = this.settings.autonomy?.maxStallTurns;
-        const maxStallTurns = typeof configuredRounds === "number" && Number.isInteger(configuredRounds) && configuredRounds >= 0
-            ? configuredRounds
-            : DEFAULT_AUTONOMY_MAX_STALL_TURNS;
-        return { mode: mode === "safe" || mode === "balanced" || mode === "full" ? mode : "off", maxStallTurns };
+        const configuredMaxStallTurns = this.settings.autonomy?.maxStallTurns;
+        const configuredGoalContinueTurns = this.settings.autonomy?.goalContinueTurns;
+        const configuredGoalContinueMaxWallClockMinutes = this.settings.autonomy?.goalContinueMaxWallClockMinutes;
+        const configuredGoalAutoContinue = this.settings.autonomy?.goalAutoContinue;
+        const configuredGoalAutoContinueDelayMs = this.settings.autonomy?.goalAutoContinueDelayMs;
+        const maxStallTurns = sanitizeIntegerSetting(configuredMaxStallTurns, DEFAULT_AUTONOMY_MAX_STALL_TURNS, 0, MAX_GOAL_CONTINUE_MAX_STALL_TURNS);
+        const goalContinueTurns = sanitizeIntegerSetting(configuredGoalContinueTurns, DEFAULT_AUTONOMY_GOAL_CONTINUE_TURNS, 1, MAX_GOAL_CONTINUE_MAX_TURNS);
+        const goalContinueMaxWallClockMinutes = sanitizeIntegerSetting(configuredGoalContinueMaxWallClockMinutes, DEFAULT_AUTONOMY_GOAL_CONTINUE_MAX_WALL_CLOCK_MINUTES, 0, MAX_GOAL_CONTINUE_MAX_WALL_CLOCK_MINUTES);
+        const goalAutoContinueDelayMs = sanitizeIntegerSetting(configuredGoalAutoContinueDelayMs, DEFAULT_AUTONOMY_GOAL_AUTO_CONTINUE_DELAY_MS, 0, MAX_GOAL_AUTO_CONTINUE_DELAY_MS);
+        return {
+            mode: mode === "safe" || mode === "balanced" || mode === "full" ? mode : "off",
+            maxStallTurns,
+            goalContinueTurns,
+            goalContinueMaxWallClockMinutes,
+            goalAutoContinue: typeof configuredGoalAutoContinue === "boolean"
+                ? configuredGoalAutoContinue
+                : DEFAULT_AUTONOMY_GOAL_AUTO_CONTINUE,
+            goalAutoContinueDelayMs,
+        };
     }
     setAutonomySettings(settings, scope = "global") {
         if (scope === "project") {
@@ -1816,6 +1951,147 @@ export class SettingsManager {
         this.markModified("autonomy");
         this.save();
     }
+    getResearchLaneSettings() {
+        const configured = this.settings.researchLane ?? {};
+        const resolved = {
+            enabled: typeof configured.enabled === "boolean" ? configured.enabled : DEFAULT_RESEARCH_LANE_ENABLED,
+            maxUsd: sanitizeNumberSetting(configured.maxUsd, DEFAULT_RESEARCH_LANE_MAX_USD, 0, MAX_RESEARCH_LANE_MAX_USD),
+            maxSources: sanitizeIntegerSetting(configured.maxSources, DEFAULT_RESEARCH_LANE_MAX_SOURCES, 1, MAX_RESEARCH_LANE_MAX_SOURCES),
+            maxFindings: sanitizeIntegerSetting(configured.maxFindings, DEFAULT_RESEARCH_LANE_MAX_FINDINGS, 1, MAX_RESEARCH_LANE_MAX_FINDINGS),
+            maxWallClockMs: sanitizeIntegerSetting(configured.maxWallClockMs, DEFAULT_RESEARCH_LANE_MAX_WALL_CLOCK_MS, 0, MAX_RESEARCH_LANE_MAX_WALL_CLOCK_MS),
+            idleDelayMs: sanitizeIntegerSetting(configured.idleDelayMs, DEFAULT_RESEARCH_LANE_IDLE_DELAY_MS, 0, MAX_RESEARCH_LANE_IDLE_DELAY_MS),
+            maxRunsPerSession: sanitizeIntegerSetting(configured.maxRunsPerSession, DEFAULT_RESEARCH_LANE_MAX_RUNS_PER_SESSION, 0, MAX_RESEARCH_LANE_MAX_RUNS_PER_SESSION),
+        };
+        if (typeof configured.model === "string" && configured.model.trim().length > 0) {
+            resolved.model = configured.model;
+        }
+        if (typeof configured.profile === "string" && configured.profile.trim().length > 0) {
+            resolved.profile = configured.profile;
+        }
+        if (typeof configured.systemPrompt === "string" && configured.systemPrompt.trim().length > 0) {
+            resolved.systemPrompt = configured.systemPrompt;
+        }
+        return resolved;
+    }
+    setResearchLaneSettings(settings, scope = "global") {
+        if (scope === "project") {
+            const projectSettings = structuredClone(this.projectSettings);
+            projectSettings.researchLane = { ...settings };
+            this.markProjectModified("researchLane");
+            this.saveProjectSettings(projectSettings);
+            return;
+        }
+        this.globalSettings.researchLane = { ...settings };
+        this.markModified("researchLane");
+        this.save();
+    }
+    getWorkerDelegationSettings() {
+        const configured = this.settings.workerDelegation ?? {};
+        const resolved = {
+            enabled: typeof configured.enabled === "boolean" ? configured.enabled : DEFAULT_WORKER_DELEGATION_ENABLED,
+            maxUsd: sanitizeNumberSetting(configured.maxUsd, DEFAULT_WORKER_DELEGATION_MAX_USD, 0, MAX_WORKER_DELEGATION_MAX_USD),
+            maxWallClockMs: sanitizeIntegerSetting(configured.maxWallClockMs, DEFAULT_WORKER_DELEGATION_MAX_WALL_CLOCK_MS, 0, MAX_WORKER_DELEGATION_MAX_WALL_CLOCK_MS),
+        };
+        if (typeof configured.model === "string" && configured.model.trim().length > 0) {
+            resolved.model = configured.model;
+        }
+        if (typeof configured.profile === "string" && configured.profile.trim().length > 0) {
+            resolved.profile = configured.profile;
+        }
+        if (typeof configured.systemPrompt === "string" && configured.systemPrompt.trim().length > 0) {
+            resolved.systemPrompt = configured.systemPrompt;
+        }
+        return resolved;
+    }
+    setWorkerDelegationSettings(settings, scope = "global") {
+        if (scope === "project") {
+            const projectSettings = structuredClone(this.projectSettings);
+            projectSettings.workerDelegation = { ...settings };
+            this.markProjectModified("workerDelegation");
+            this.saveProjectSettings(projectSettings);
+            return;
+        }
+        this.globalSettings.workerDelegation = { ...settings };
+        this.markModified("workerDelegation");
+        this.save();
+    }
+    getLearningPolicySettings() {
+        const configured = this.settings.learningPolicy ?? {};
+        const allowedLayers = Array.isArray(configured.allowedAutoApplyLayers)
+            ? configured.allowedAutoApplyLayers.filter((layer) => typeof layer === "string" &&
+                ["memory", "skill", "prompt", "extension", "tool", "script", "settings", "source"].includes(layer))
+            : [...DEFAULT_LEARNING_POLICY_ALLOWED_AUTO_APPLY_LAYERS];
+        return {
+            enabled: typeof configured.enabled === "boolean" ? configured.enabled : DEFAULT_LEARNING_POLICY_ENABLED,
+            autoApplyEnabled: typeof configured.autoApplyEnabled === "boolean"
+                ? configured.autoApplyEnabled
+                : DEFAULT_LEARNING_POLICY_AUTO_APPLY_ENABLED,
+            confidenceThreshold: sanitizeIntegerSetting(configured.confidenceThreshold, DEFAULT_LEARNING_POLICY_CONFIDENCE_THRESHOLD, 0, 100),
+            minObservations: sanitizeIntegerSetting(configured.minObservations, DEFAULT_LEARNING_POLICY_MIN_OBSERVATIONS, 0, 100),
+            allowedAutoApplyLayers: allowedLayers,
+            requireRollbackPlan: typeof configured.requireRollbackPlan === "boolean" ? configured.requireRollbackPlan : true,
+            reflectionSourceConfidence: sanitizeIntegerSetting(configured.reflectionSourceConfidence, DEFAULT_LEARNING_POLICY_REFLECTION_SOURCE_CONFIDENCE, 0, 100),
+        };
+    }
+    getToolkitScripts() {
+        const configured = this.settings.toolkit?.scripts;
+        if (!Array.isArray(configured))
+            return [];
+        return configured.filter((script) => Boolean(script) &&
+            typeof script.name === "string" &&
+            script.name.length > 0 &&
+            typeof script.description === "string" &&
+            typeof script.path === "string" &&
+            (script.runner === "uv" || script.runner === "powershell" || script.runner === "bash"));
+    }
+    setToolkitSettings(settings, scope = "global") {
+        if (scope === "project") {
+            const projectSettings = structuredClone(this.projectSettings);
+            projectSettings.toolkit = { ...settings };
+            this.markProjectModified("toolkit");
+            this.saveProjectSettings(projectSettings);
+            return;
+        }
+        this.globalSettings.toolkit = { ...settings };
+        this.markModified("toolkit");
+        this.save();
+    }
+    getModelCapabilitySettings() {
+        const configured = this.settings.modelCapability?.mode;
+        const mode = configured === "auto" ||
+            configured === "off" ||
+            configured === "full" ||
+            configured === "lean" ||
+            configured === "minimal" ||
+            configured === "chat"
+            ? configured
+            : DEFAULT_MODEL_CAPABILITY_MODE;
+        return { mode };
+    }
+    setModelCapabilitySettings(settings, scope = "global") {
+        if (scope === "project") {
+            const projectSettings = structuredClone(this.projectSettings);
+            projectSettings.modelCapability = { ...settings };
+            this.markProjectModified("modelCapability");
+            this.saveProjectSettings(projectSettings);
+            return;
+        }
+        this.globalSettings.modelCapability = { ...settings };
+        this.markModified("modelCapability");
+        this.save();
+    }
+    setLearningPolicySettings(settings, scope = "global") {
+        if (scope === "project") {
+            const projectSettings = structuredClone(this.projectSettings);
+            projectSettings.learningPolicy = { ...settings };
+            this.markProjectModified("learningPolicy");
+            this.saveProjectSettings(projectSettings);
+            return;
+        }
+        this.globalSettings.learningPolicy = { ...settings };
+        this.markModified("learningPolicy");
+        this.save();
+    }
     getAutoLearnSettings() {
         const settings = this.settings.autoLearn ?? {};
         return {