@google/gemini-cli-core 0.36.0 → 0.37.0-preview.1

package/dist/src/config/config.d.ts

@@ -5,11 +5,15 @@
  */
 import { SandboxPolicyManager } from '../policy/sandboxPolicyManager.js';
 import { z } from 'zod';
+import type { ConversationRecord } from '../services/chatRecordingService.js';
+import type { AgentHistoryProviderConfig } from '../services/types.js';
+export type { ConversationRecord };
 import { AuthType, type ContentGenerator, type ContentGeneratorConfig } from '../core/contentGenerator.js';
 import type { OverageStrategy } from '../billing/billing.js';
 import { PromptRegistry } from '../prompts/prompt-registry.js';
 import { ResourceRegistry } from '../resources/resource-registry.js';
 import { ToolRegistry } from '../tools/tool-registry.js';
+import { TopicState } from './topicState.js';
 import { GeminiClient } from '../core/client.js';
 import { BaseLlmClient } from '../core/baseLlmClient.js';
 import { LocalLiteRtLmClient } from '../core/localLiteRtLmClient.js';
@@ -26,7 +30,7 @@ import { ModelAvailabilityService } from '../availability/modelAvailabilityServi
 import { ModelRouterService } from '../routing/modelRouterService.js';
 import { OutputFormat } from '../output/types.js';
 import { ModelConfigService, type ModelConfig, type ModelConfigServiceConfig } from '../services/modelConfigService.js';
-import { ContextManager } from '../services/contextManager.js';
+import { ContextManager } from '../context/contextManager.js';
 import { TrackerService } from '../services/trackerService.js';
 import type { GenerateContentParameters } from '@google/genai';
 export type { MCPOAuthConfig, AnyToolInvocation, AnyDeclarativeTool };
@@ -61,6 +65,7 @@ export interface SummarizeToolOutputSettings {
     tokenBudget?: number;
 }
 export interface PlanSettings {
+    enabled?: boolean;
     directory?: string;
     modelRouting?: boolean;
 }
@@ -78,11 +83,29 @@ export interface OutputSettings {
     format?: OutputFormat;
 }
 export interface ToolOutputMaskingConfig {
-    enabled: boolean;
-    toolProtectionThreshold: number;
-    minPrunableTokensThreshold: number;
+    protectionThresholdTokens: number;
+    minPrunableThresholdTokens: number;
     protectLatestTurn: boolean;
 }
+export interface ContextManagementConfig {
+    enabled: boolean;
+    historyWindow: {
+        maxTokens: number;
+        retainedTokens: number;
+    };
+    messageLimits: {
+        normalMaxTokens: number;
+        retainedMaxTokens: number;
+        normalizationHeadRatio: number;
+    };
+    tools: {
+        distillation: {
+            maxOutputTokens: number;
+            summarizationThresholdTokens: number;
+        };
+        outputMasking: ToolOutputMaskingConfig;
+    };
+}
 export interface GemmaModelRouterSettings {
     enabled?: boolean;
     classifier?: {
@@ -104,6 +127,22 @@ export interface ResolvedExtensionSetting {
     scope?: 'user' | 'workspace';
     source?: string;
 }
+export interface TrajectoryProvider {
+    /** Prefix used to identify sessions from this provider (e.g., 'ext:') */
+    prefix: string;
+    /** Optional display name for UI Tabs */
+    displayName?: string;
+    /** Return an array of conversational tags/ids */
+    listSessions(workspaceUri?: string): Promise<Array<{
+        id: string;
+        mtime: string;
+        name?: string;
+        displayName?: string;
+        messageCount?: number;
+    }>>;
+    /** Load a single conversation payload */
+    loadSession(id: string): Promise<ConversationRecord | null>;
+}
 export interface AgentRunConfig {
     maxTimeMinutes?: number;
     maxTurns?: number;
@@ -197,6 +236,8 @@ export interface BrowserAgentCustomConfig {
     allowedDomains?: string[];
     /** Disable user input on the browser window during automation. Default: true in non-headless mode */
     disableUserInput?: boolean;
+    /** Maximum number of actions (tool calls) allowed per task. Default: 100 */
+    maxActionsPerTask?: number;
     /** Whether to confirm sensitive actions (e.g., fill_form, evaluate_script). */
     confirmSensitiveActions?: boolean;
     /** Whether to block file uploads. */
@@ -251,6 +292,8 @@ export interface GeminiCLIExtension {
      * Used to migrate an extension to a new repository source.
      */
     migratedTo?: string;
+    /** Loaded JS module for trajectory decoding */
+    trajectoryProviderModule?: TrajectoryProvider;
 }
 export interface ExtensionInstallMetadata {
     source: string;
@@ -312,34 +355,34 @@ export declare const ConfigSchema: z.ZodObject<{
         image: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         enabled: boolean;
-        allowedPaths: string[];
         networkAccess: boolean;
+        allowedPaths: string[];
         command?: "docker" | "podman" | "sandbox-exec" | "runsc" | "lxc" | "windows-native" | undefined;
         image?: string | undefined;
     }, {
         command?: "docker" | "podman" | "sandbox-exec" | "runsc" | "lxc" | "windows-native" | undefined;
         image?: string | undefined;
         enabled?: boolean | undefined;
-        allowedPaths?: string[] | undefined;
         networkAccess?: boolean | undefined;
+        allowedPaths?: string[] | undefined;
     }>, {
         enabled: boolean;
-        allowedPaths: string[];
         networkAccess: boolean;
+        allowedPaths: string[];
         command?: "docker" | "podman" | "sandbox-exec" | "runsc" | "lxc" | "windows-native" | undefined;
         image?: string | undefined;
     }, {
         command?: "docker" | "podman" | "sandbox-exec" | "runsc" | "lxc" | "windows-native" | undefined;
         image?: string | undefined;
         enabled?: boolean | undefined;
-        allowedPaths?: string[] | undefined;
         networkAccess?: boolean | undefined;
+        allowedPaths?: string[] | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     sandbox?: {
         enabled: boolean;
-        allowedPaths: string[];
         networkAccess: boolean;
+        allowedPaths: string[];
         command?: "docker" | "podman" | "sandbox-exec" | "runsc" | "lxc" | "windows-native" | undefined;
         image?: string | undefined;
     } | undefined;
@@ -348,8 +391,8 @@ export declare const ConfigSchema: z.ZodObject<{
         command?: "docker" | "podman" | "sandbox-exec" | "runsc" | "lxc" | "windows-native" | undefined;
         image?: string | undefined;
         enabled?: boolean | undefined;
-        allowedPaths?: string[] | undefined;
         networkAccess?: boolean | undefined;
+        allowedPaths?: string[] | undefined;
     } | undefined;
 }>;
 /**
@@ -449,6 +492,7 @@ export interface ConfigParameters {
     useAlternateBuffer?: boolean;
     useRipgrep?: boolean;
     enableInteractiveShell?: boolean;
+    shellBackgroundCompletionBehavior?: string;
     skipNextSpeakerCheck?: boolean;
     shellExecutionConfig?: ShellExecutionConfig;
     extensionManagement?: boolean;
@@ -480,6 +524,7 @@ export interface ConfigParameters {
     enableHooks?: boolean;
     enableHooksUI?: boolean;
     experiments?: Experiments;
+    contextManagement?: Partial<ContextManagementConfig>;
     hooks?: {
         [K in HookEventName]?: HookDefinition[];
     };
@@ -493,9 +538,14 @@ export interface ConfigParameters {
     disabledSkills?: string[];
     adminSkillsEnabled?: boolean;
     experimentalJitContext?: boolean;
+    autoDistillation?: boolean;
     experimentalMemoryManager?: boolean;
+    experimentalAgentHistoryTruncation?: boolean;
+    experimentalAgentHistoryTruncationThreshold?: number;
+    experimentalAgentHistoryRetainedMessages?: number;
+    experimentalAgentHistorySummarization?: boolean;
+    memoryBoundaryMarkers?: string[];
     topicUpdateNarration?: boolean;
-    toolOutputMasking?: Partial<ToolOutputMaskingConfig>;
     disableLLMCorrection?: boolean;
     plan?: boolean;
     tracker?: boolean;
@@ -535,11 +585,13 @@ export declare class Config implements McpContext, AgentLoopContext {
     private clientVersion;
     private fileSystemService;
     private trackerService?;
+    readonly topicState: TopicState;
     private contentGeneratorConfig;
     private contentGenerator;
     readonly modelConfigService: ModelConfigService;
     private readonly embeddingModel;
     private readonly sandbox;
+    private _sandboxForbiddenPaths;
     private readonly targetDir;
     private workspaceContext;
     private readonly debugMode;
@@ -618,6 +670,7 @@ export declare class Config implements McpContext, AgentLoopContext {
     private readonly directWebFetch;
     private readonly useRipgrep;
     private readonly enableInteractiveShell;
+    private readonly shellBackgroundCompletionBehavior;
     private readonly skipNextSpeakerCheck;
     private readonly useBackgroundColor;
     private readonly useAlternateBuffer;
@@ -654,7 +707,6 @@ export declare class Config implements McpContext, AgentLoopContext {
     private pendingIncludeDirectories;
     private readonly enableHooks;
     private readonly enableHooksUI;
-    private readonly toolOutputMasking;
     private hooks;
     private projectHooks;
     private disabledHooks;
@@ -672,6 +724,7 @@ export declare class Config implements McpContext, AgentLoopContext {
     private readonly adminSkillsEnabled;
     private readonly experimentalJitContext;
     private readonly experimentalMemoryManager;
+    private readonly memoryBoundaryMarkers;
     private readonly topicUpdateNarration;
     private readonly disableLLMCorrection;
     private readonly planEnabled;
@@ -679,6 +732,7 @@ export declare class Config implements McpContext, AgentLoopContext {
     private readonly planModeRoutingEnabled;
     private readonly modelSteering;
     private contextManager?;
+    private readonly contextManagement;
     private terminalBackground;
     private remoteAdminSettings;
     private latestApiRequest;
@@ -731,6 +785,7 @@ export declare class Config implements McpContext, AgentLoopContext {
      * Use the injected AgentLoopContext instead.
      */
     get geminiClient(): GeminiClient;
+    private getSandboxForbiddenPaths;
     private refreshSandboxManager;
     get sandboxPolicyManager(): SandboxPolicyManager;
     get sandboxManager(): SandboxManager;
@@ -842,9 +897,11 @@ export declare class Config implements McpContext, AgentLoopContext {
     setUserMemory(newUserMemory: string | HierarchicalMemory): void;
     /**
      * Returns memory for the system instruction.
-     * When JIT is enabled, only global memory (Tier 1) goes in the system
-     * instruction. Extension and project memory (Tier 2) are placed in the
-     * first user message instead, per the tiered context model.
+     * When JIT is enabled, global memory and user project memory (Tier 1) go
+     * in the system instruction. Extension and project memory (Tier 2) are
+     * placed in the first user message instead, per the tiered context model.
+     * User project memory is in Tier 1 so mid-session saves are reflected
+     * via system instruction updates.
      */
     getSystemInstructionMemory(): string | HierarchicalMemory;
     /**
@@ -857,10 +914,13 @@ export declare class Config implements McpContext, AgentLoopContext {
     getEnvironmentMemory(): string;
     getContextManager(): ContextManager | undefined;
     isJitContextEnabled(): boolean;
+    isAutoDistillationEnabled(): boolean;
+    getMemoryBoundaryMarkers(): readonly string[];
     isMemoryManagerEnabled(): boolean;
+    getContextManagementConfig(): ContextManagementConfig;
+    get agentHistoryProviderConfig(): AgentHistoryProviderConfig;
     isTopicUpdateNarrationEnabled(): boolean;
     isModelSteeringEnabled(): boolean;
-    getToolOutputMaskingEnabled(): boolean;
     getToolOutputMaskingConfig(): Promise<ToolOutputMaskingConfig>;
     getGeminiMdFileCount(): number;
     setGeminiMdFileCount(count: number): void;
@@ -916,6 +976,7 @@ export declare class Config implements McpContext, AgentLoopContext {
      */
     updateSystemInstructionIfInitialized(): void;
     getModelRouterService(): ModelRouterService;
+    getModelConfigService(): ModelConfigService;
     getModelAvailabilityService(): ModelAvailabilityService;
     getEnableRecursiveFileSearch(): boolean;
     getFileFilteringEnableFuzzySearch(): boolean;
@@ -1037,6 +1098,7 @@ export declare class Config implements McpContext, AgentLoopContext {
      * Note: This method should only be called after startup, once experiments have been loaded.
      */
     getUseCustomToolModelSync(): boolean;
+    private isGemini31LaunchedForAuthType;
     /**
      * Returns whether Gemini 3.1 has been launched.
      *
@@ -1069,6 +1131,7 @@ export declare class Config implements McpContext, AgentLoopContext {
     getUseBackgroundColor(): boolean;
     getUseAlternateBuffer(): boolean;
     getEnableInteractiveShell(): boolean;
+    getShellBackgroundCompletionBehavior(): 'inject' | 'notify' | 'silent';
     getSkipNextSpeakerCheck(): boolean;
     getContinueOnFailedApiCall(): boolean;
     getRetryFetchErrors(): boolean;
@@ -1079,6 +1142,8 @@ export declare class Config implements McpContext, AgentLoopContext {
     setShellExecutionConfig(config: ShellExecutionConfig): void;
     getScreenReader(): boolean;
     getTruncateToolOutputThreshold(): number;
+    getToolMaxOutputTokens(): number;
+    getToolSummarizationThresholdTokens(): number;
     getNextCompressionTruncationId(): number;
     getUseWriteTodos(): boolean;
     getOutputFormat(): OutputFormat;