@caupulican/pi-adaptative 0.80.86 → 0.80.89

package/dist/core/settings-manager.d.ts

@@ -1,5 +1,6 @@
 import type { Transport } from "@caupulican/pi-ai";
 import { ProfileRegistry } from "./profile-registry.ts";
+import type { ToolkitScript } from "./toolkit/script-registry.ts";
 export interface CompactionSettings {
     enabled?: boolean;
     reserveTokens?: number;
@@ -20,6 +21,46 @@ export interface ContextGcSettings {
     tools?: string[];
     semanticMemory?: SemanticMemoryGcSettings;
 }
+/**
+ * Conservative, opt-in first enforcement pilot for the context-policy layer (observe-only
+ * by default -- see context/context-prompt-enforcement.ts). When enabled, stale
+ * artifact-backed tool_output results outside the recent window are stubbed in place in
+ * the provider-visible prompt only; the transcript/session history is never touched.
+ */
+export interface ContextPromptEnforcementSettings {
+    enabled?: boolean;
+    preserveRecentMessages?: number;
+    minChars?: number;
+}
+/**
+ * Local memory retrieval (see context/memory-retrieval.ts, context/memory-prompt-block.ts):
+ * when `enabled`, each turn queries the local, read-only Pi OKF memory provider under
+ * `<agentDir>/okf-memory` (fixed path, not user-configurable in this slice) and stores a
+ * report of source-labeled evidence. By default (`includeInPrompt` false) this is
+ * report-only -- nothing is injected into the provider-visible prompt or transcript. When
+ * `includeInPrompt` is also true, a single bounded, source-labeled, untrusted-content-
+ * wrapped evidence block is appended to the provider-visible prompt each turn (never
+ * written to the transcript/session history). External/non-local providers are never
+ * constructed or queried by this setting.
+ */
+export interface MemoryRetrievalSettings {
+    enabled?: boolean;
+    maxResults?: number;
+    includeInPrompt?: boolean;
+}
+export interface ContextCurationSettings {
+    enabled?: boolean;
+    /** Local model ref ("provider/id" or bare id) used for curation jobs. Required to drain. */
+    model?: string;
+    maxJobsPerTurn?: number;
+}
+export interface ContextPolicySettings {
+    enforcement?: ContextPromptEnforcementSettings;
+    memory?: MemoryRetrievalSettings;
+    curation?: ContextCurationSettings;
+}
+export declare const MEMORY_RETRIEVAL_MAX_RESULTS_MIN = 1;
+export declare const MEMORY_RETRIEVAL_MAX_RESULTS_MAX = 20;
 export interface BranchSummarySettings {
     reserveTokens?: number;
     skipPrompt?: boolean;
@@ -80,15 +121,96 @@ export interface AutoLearnSettings {
 }
 export type AutonomyMode = "off" | "safe" | "balanced" | "full";
 export declare const DEFAULT_AUTONOMY_MAX_STALL_TURNS = 20;
+export declare const DEFAULT_AUTONOMY_GOAL_CONTINUE_TURNS = 20;
+export declare const DEFAULT_AUTONOMY_GOAL_CONTINUE_MAX_WALL_CLOCK_MINUTES = 0;
+export declare const DEFAULT_AUTONOMY_GOAL_AUTO_CONTINUE = true;
+export declare const DEFAULT_AUTONOMY_GOAL_AUTO_CONTINUE_DELAY_MS = 0;
 export interface AutonomySettings {
     mode?: AutonomyMode;
     maxStallTurns?: number;
+    goalContinueTurns?: number;
+    goalContinueMaxWallClockMinutes?: number;
+    goalAutoContinue?: boolean;
+    goalAutoContinueDelayMs?: number;
 }
 export interface ModelRouterSettings {
     enabled?: boolean;
     cheapModel?: string;
+    mediumModel?: string;
     expensiveModel?: string;
     learningModel?: string;
+    judgeEnabled?: boolean;
+    judgeModel?: string;
+}
+export declare const DEFAULT_RESEARCH_LANE_ENABLED = false;
+export declare const DEFAULT_RESEARCH_LANE_MAX_USD = 0.25;
+export declare const DEFAULT_RESEARCH_LANE_MAX_SOURCES = 8;
+export declare const DEFAULT_RESEARCH_LANE_MAX_FINDINGS = 10;
+export declare const DEFAULT_RESEARCH_LANE_MAX_WALL_CLOCK_MS = 120000;
+export declare const DEFAULT_RESEARCH_LANE_IDLE_DELAY_MS = 0;
+export declare const DEFAULT_RESEARCH_LANE_MAX_RUNS_PER_SESSION = 10;
+export declare const MAX_RESEARCH_LANE_MAX_USD = 5;
+export declare const MAX_RESEARCH_LANE_MAX_SOURCES = 32;
+export declare const MAX_RESEARCH_LANE_MAX_FINDINGS = 50;
+export declare const MAX_RESEARCH_LANE_MAX_WALL_CLOCK_MS = 3600000;
+export declare const MAX_RESEARCH_LANE_IDLE_DELAY_MS = 300000;
+export declare const MAX_RESEARCH_LANE_MAX_RUNS_PER_SESSION = 100;
+export interface ResearchLaneSettings {
+    enabled?: boolean;
+    model?: string;
+    profile?: string;
+    systemPrompt?: string;
+    maxUsd?: number;
+    maxSources?: number;
+    maxFindings?: number;
+    maxWallClockMs?: number;
+    idleDelayMs?: number;
+    maxRunsPerSession?: number;
+}
+export type ResolvedResearchLaneSettings = Required<Omit<ResearchLaneSettings, "model" | "profile" | "systemPrompt">> & Pick<ResearchLaneSettings, "model" | "profile" | "systemPrompt">;
+export declare const DEFAULT_WORKER_DELEGATION_ENABLED = false;
+export declare const DEFAULT_WORKER_DELEGATION_MAX_USD = 0.5;
+export declare const DEFAULT_WORKER_DELEGATION_MAX_WALL_CLOCK_MS = 120000;
+export declare const MAX_WORKER_DELEGATION_MAX_USD = 5;
+export declare const MAX_WORKER_DELEGATION_MAX_WALL_CLOCK_MS = 3600000;
+export interface WorkerDelegationSettings {
+    enabled?: boolean;
+    model?: string;
+    profile?: string;
+    systemPrompt?: string;
+    maxUsd?: number;
+    maxWallClockMs?: number;
+}
+export type ResolvedWorkerDelegationSettings = Required<Omit<WorkerDelegationSettings, "model" | "profile" | "systemPrompt">> & Pick<WorkerDelegationSettings, "model" | "profile" | "systemPrompt">;
+export type LearningPolicyLayer = "memory" | "skill" | "prompt" | "extension" | "tool" | "script" | "settings" | "source";
+export declare const DEFAULT_LEARNING_POLICY_ENABLED = false;
+export declare const DEFAULT_LEARNING_POLICY_AUTO_APPLY_ENABLED = false;
+export declare const DEFAULT_LEARNING_POLICY_CONFIDENCE_THRESHOLD = 90;
+export declare const DEFAULT_LEARNING_POLICY_MIN_OBSERVATIONS = 2;
+export declare const DEFAULT_LEARNING_POLICY_ALLOWED_AUTO_APPLY_LAYERS: readonly LearningPolicyLayer[];
+export declare const DEFAULT_LEARNING_POLICY_REFLECTION_SOURCE_CONFIDENCE = 50;
+export interface LearningPolicySettings {
+    enabled?: boolean;
+    autoApplyEnabled?: boolean;
+    confidenceThreshold?: number;
+    minObservations?: number;
+    allowedAutoApplyLayers?: LearningPolicyLayer[];
+    requireRollbackPlan?: boolean;
+    reflectionSourceConfidence?: number;
+}
+export type ResolvedLearningPolicySettings = Required<LearningPolicySettings>;
+export interface ToolkitSettings {
+    /** The blessed daily-ops scripts run_toolkit_script may execute. Nothing else ever runs. */
+    scripts?: ToolkitScript[];
+}
+export type ModelCapabilityMode = "auto" | "off" | "full" | "lean" | "minimal" | "chat";
+export declare const DEFAULT_MODEL_CAPABILITY_MODE: ModelCapabilityMode;
+export interface ModelCapabilitySettings {
+    /**
+     * default: "auto" — derive the tool/lane surface from the model's context window so small open
+     * models stay usable for chat. "off" disables detection; a class name forces that class.
+     */
+    mode?: ModelCapabilityMode;
 }
 export type TransportSetting = Transport;
 /**
@@ -142,6 +264,7 @@ export interface Settings {
         staleDays?: number;
     };
     contextGc?: ContextGcSettings;
+    contextPolicy?: ContextPolicySettings;
     branchSummary?: BranchSummarySettings;
     retry?: RetrySettings;
     hideThinkingBlock?: boolean;
@@ -176,6 +299,11 @@ export interface Settings {
     warnings?: WarningSettings;
     selfModification?: SelfModificationSettings;
     autonomy?: AutonomySettings;
+    researchLane?: ResearchLaneSettings;
+    workerDelegation?: WorkerDelegationSettings;
+    learningPolicy?: LearningPolicySettings;
+    modelCapability?: ModelCapabilitySettings;
+    toolkit?: ToolkitSettings;
     modelRouter?: ModelRouterSettings;
     autoLearn?: AutoLearnSettings;
     sessionDir?: string;
@@ -383,8 +511,11 @@ export declare class SettingsManager {
     getModelRouterSettings(): {
         enabled: boolean;
         cheapModel?: string;
+        mediumModel?: string;
         expensiveModel?: string;
         learningModel?: string;
+        judgeEnabled: boolean;
+        judgeModel?: string;
     };
     setModelRouterSettings(settings: ModelRouterSettings, scope?: SettingsScope): void;
     /** Configured auxiliary summarizer model id, or "auto" (default) to pick the cheapest authed model. */
@@ -407,6 +538,24 @@ export declare class SettingsManager {
             markers: string[];
         };
     };
+    getContextPromptEnforcementSettings(): {
+        enabled: boolean;
+        preserveRecentMessages: number;
+        minChars: number;
+    };
+    getContextCurationSettings(): {
+        enabled: boolean;
+        model?: string;
+        maxJobsPerTurn: number;
+    };
+    setContextCurationSettings(settings: ContextCurationSettings, scope?: SettingsScope): void;
+    setContextPromptEnforcementSettings(settings: ContextPromptEnforcementSettings, scope?: SettingsScope): void;
+    getMemoryRetrievalSettings(): {
+        enabled: boolean;
+        maxResults: number;
+        includeInPrompt: boolean;
+    };
+    setMemoryRetrievalSettings(settings: MemoryRetrievalSettings, scope?: SettingsScope): void;
     getBranchSummarySettings(): {
         reserveTokens: number;
         skipPrompt: boolean;
@@ -492,11 +641,18 @@ export declare class SettingsManager {
         sourcePaths?: string[];
     };
     setSelfModificationSettings(settings: SelfModificationSettings, scope?: SettingsScope): void;
-    getAutonomySettings(): {
-        mode: AutonomyMode;
-        maxStallTurns: number;
-    };
+    getAutonomySettings(): Required<AutonomySettings>;
     setAutonomySettings(settings: AutonomySettings, scope?: SettingsScope): void;
+    getResearchLaneSettings(): ResolvedResearchLaneSettings;
+    setResearchLaneSettings(settings: ResearchLaneSettings, scope?: SettingsScope): void;
+    getWorkerDelegationSettings(): ResolvedWorkerDelegationSettings;
+    setWorkerDelegationSettings(settings: WorkerDelegationSettings, scope?: SettingsScope): void;
+    getLearningPolicySettings(): ResolvedLearningPolicySettings;
+    getToolkitScripts(): ToolkitScript[];
+    setToolkitSettings(settings: ToolkitSettings, scope?: SettingsScope): void;
+    getModelCapabilitySettings(): Required<ModelCapabilitySettings>;
+    setModelCapabilitySettings(settings: ModelCapabilitySettings, scope?: SettingsScope): void;
+    setLearningPolicySettings(settings: LearningPolicySettings, scope?: SettingsScope): void;
     getAutoLearnSettings(): AutoLearnSettings;
     setAutoLearnSettings(settings: AutoLearnSettings, scope?: SettingsScope): void;
     getExternalResourceRoots(): string[];