@office-ai/aioncli-core 0.8.1 → 0.18.5

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

@@ -9,6 +9,7 @@ import { PromptRegistry } from '../prompts/prompt-registry.js';
 import { ToolRegistry } from '../tools/tool-registry.js';
 import { GeminiClient } from '../core/client.js';
 import { BaseLlmClient } from '../core/baseLlmClient.js';
+import type { HookDefinition, HookEventName } from '../hooks/types.js';
 import { FileDiscoveryService } from '../services/fileDiscoveryService.js';
 import { GitService } from '../services/gitService.js';
 import type { TelemetryTarget } from '../telemetry/index.js';
@@ -18,6 +19,8 @@ import type { FileSystemService } from '../services/fileSystemService.js';
 import type { FallbackModelHandler } from '../fallback/types.js';
 import { ModelRouterService } from '../routing/modelRouterService.js';
 import { OutputFormat } from '../output/types.js';
+import type { ModelConfigServiceConfig } from '../services/modelConfigService.js';
+import { ModelConfigService } from '../services/modelConfigService.js';
 export type { MCPOAuthConfig, AnyToolInvocation };
 import type { AnyToolInvocation } from '../tools/tools.js';
 import { WorkspaceContext } from '../utils/workspaceContext.js';
@@ -29,11 +32,9 @@ import { MessageBus } from '../confirmation-bus/message-bus.js';
 import { PolicyEngine } from '../policy/policy-engine.js';
 import type { PolicyEngineConfig } from '../policy/types.js';
 import type { UserTierId } from '../code_assist/types.js';
-export declare enum ApprovalMode {
-    DEFAULT = "default",
-    AUTO_EDIT = "autoEdit",
-    YOLO = "yolo"
-}
+import type { Experiments } from '../code_assist/experiments/experiments.js';
+import { AgentRegistry } from '../agents/registry.js';
+import { ApprovalMode } from '../policy/types.js';
 export interface AccessibilitySettings {
     disableLoadingPhrases?: boolean;
     screenReader?: boolean;
@@ -41,9 +42,6 @@ export interface AccessibilitySettings {
 export interface BugCommandSettings {
     urlTemplate: string;
 }
-export interface ChatCompressionSettings {
-    contextPercentageThreshold?: number;
-}
 export interface SummarizeToolOutputSettings {
     tokenBudget?: number;
 }
@@ -59,12 +57,32 @@ export interface TelemetrySettings {
 export interface OutputSettings {
     format?: OutputFormat;
 }
+export interface CodebaseInvestigatorSettings {
+    enabled?: boolean;
+    maxNumTurns?: number;
+    maxTimeMinutes?: number;
+    thinkingBudget?: number;
+    model?: string;
+}
+/**
+ * All information required in CLI to handle an extension. Defined in Core so
+ * that the collection of loaded, active, and inactive extensions can be passed
+ * around on the config object though Core does not use this information
+ * directly.
+ */
 export interface GeminiCLIExtension {
     name: string;
     version: string;
     isActive: boolean;
     path: string;
     installMetadata?: ExtensionInstallMetadata;
+    mcpServers?: Record<string, MCPServerConfig>;
+    contextFiles: string[];
+    excludeTools?: string[];
+    id: string;
+    hooks?: {
+        [K in HookEventName]?: HookDefinition[];
+    };
 }
 export interface ExtensionInstallMetadata {
     source: string;
@@ -72,11 +90,14 @@ export interface ExtensionInstallMetadata {
     releaseTag?: string;
     ref?: string;
     autoUpdate?: boolean;
+    allowPreRelease?: boolean;
 }
 import type { FileFilteringOptions } from './constants.js';
-import { DEFAULT_MEMORY_FILE_FILTERING_OPTIONS, DEFAULT_FILE_FILTERING_OPTIONS } from './constants.js';
+import { DEFAULT_FILE_FILTERING_OPTIONS, DEFAULT_MEMORY_FILE_FILTERING_OPTIONS } from './constants.js';
+import { type ExtensionLoader } from '../utils/extensionLoader.js';
+import { McpClientManager } from '../tools/mcp-client-manager.js';
 export type { FileFilteringOptions };
-export { DEFAULT_MEMORY_FILE_FILTERING_OPTIONS, DEFAULT_FILE_FILTERING_OPTIONS, };
+export { DEFAULT_FILE_FILTERING_OPTIONS, DEFAULT_MEMORY_FILE_FILTERING_OPTIONS, };
 export declare const DEFAULT_TRUNCATE_TOOL_OUTPUT_THRESHOLD = 4000000;
 export declare const DEFAULT_TRUNCATE_TOOL_OUTPUT_LINES = 1000;
 export declare class MCPServerConfig {
@@ -93,12 +114,12 @@ export declare class MCPServerConfig {
     readonly description?: string | undefined;
     readonly includeTools?: string[] | undefined;
     readonly excludeTools?: string[] | undefined;
-    readonly extensionName?: string | undefined;
+    readonly extension?: GeminiCLIExtension | undefined;
     readonly oauth?: MCPOAuthConfig | undefined;
     readonly authProviderType?: AuthProviderType | undefined;
     readonly targetAudience?: string | undefined;
     readonly targetServiceAccount?: string | undefined;
-    constructor(command?: string | undefined, args?: string[] | undefined, env?: Record<string, string> | undefined, cwd?: string | undefined, url?: string | undefined, httpUrl?: string | undefined, headers?: Record<string, string> | undefined, tcp?: string | undefined, timeout?: number | undefined, trust?: boolean | undefined, description?: string | undefined, includeTools?: string[] | undefined, excludeTools?: string[] | undefined, extensionName?: string | undefined, oauth?: MCPOAuthConfig | undefined, authProviderType?: AuthProviderType | undefined, targetAudience?: string | undefined, targetServiceAccount?: string | undefined);
+    constructor(command?: string | undefined, args?: string[] | undefined, env?: Record<string, string> | undefined, cwd?: string | undefined, url?: string | undefined, httpUrl?: string | undefined, headers?: Record<string, string> | undefined, tcp?: string | undefined, timeout?: number | undefined, trust?: boolean | undefined, description?: string | undefined, includeTools?: string[] | undefined, excludeTools?: string[] | undefined, extension?: GeminiCLIExtension | undefined, oauth?: MCPOAuthConfig | undefined, authProviderType?: AuthProviderType | undefined, targetAudience?: string | undefined, targetServiceAccount?: string | undefined);
 }
 export declare enum AuthProviderType {
     DYNAMIC_DISCOVERY = "dynamic_discovery",
@@ -116,7 +137,6 @@ export interface ConfigParameters {
     targetDir: string;
     debugMode: boolean;
     question?: string;
-    fullContext?: boolean;
     coreTools?: string[];
     allowedTools?: string[];
     excludeTools?: string[];
@@ -126,6 +146,7 @@ export interface ConfigParameters {
     mcpServers?: Record<string, MCPServerConfig>;
     userMemory?: string;
     geminiMdFileCount?: number;
+    geminiMdFilePaths?: string[];
     approvalMode?: ApprovalMode;
     showMemoryUsage?: boolean;
     contextFileName?: string | string[];
@@ -145,26 +166,28 @@ export interface ConfigParameters {
     includeDirectories?: string[];
     bugCommand?: BugCommandSettings;
     model: string;
-    extensionContextFilePaths?: string[];
     maxSessionTurns?: number;
     experimentalZedIntegration?: boolean;
+    listSessions?: boolean;
+    deleteSession?: string;
     listExtensions?: boolean;
-    extensions?: GeminiCLIExtension[];
-    blockedMcpServers?: Array<{
-        name: string;
-        extensionName: string;
-    }>;
+    extensionLoader?: ExtensionLoader;
+    enabledExtensions?: string[];
+    enableExtensionReloading?: boolean;
+    allowedMcpServers?: string[];
+    blockedMcpServers?: string[];
     noBrowser?: boolean;
     summarizeToolOutput?: Record<string, SummarizeToolOutputSettings>;
-    folderTrustFeature?: boolean;
     folderTrust?: boolean;
     ideMode?: boolean;
     loadMemoryFromIncludeDirectories?: boolean;
-    chatCompression?: ChatCompressionSettings;
+    importFormat?: 'tree' | 'flat';
+    discoveryMaxDirs?: number;
+    compressionThreshold?: number;
     interactive?: boolean;
     trustedFolder?: boolean;
     useRipgrep?: boolean;
-    shouldUseNodePtyShell?: boolean;
+    enableInteractiveShell?: boolean;
     skipNextSpeakerCheck?: boolean;
     shellExecutionConfig?: ShellExecutionConfig;
     extensionManagement?: boolean;
@@ -179,30 +202,51 @@ export interface ConfigParameters {
     output?: OutputSettings;
     useModelRouter?: boolean;
     enableMessageBusIntegration?: boolean;
+    disableModelRouterForAuth?: AuthType[];
+    codebaseInvestigatorSettings?: CodebaseInvestigatorSettings;
+    continueOnFailedApiCall?: boolean;
+    retryFetchErrors?: boolean;
+    enableShellOutputEfficiency?: boolean;
+    fakeResponses?: string;
+    recordResponses?: string;
+    ptyInfo?: string;
+    disableYoloMode?: boolean;
+    modelConfigServiceConfig?: ModelConfigServiceConfig;
+    enableHooks?: boolean;
+    experiments?: Experiments;
+    hooks?: {
+        [K in HookEventName]?: HookDefinition[];
+    };
+    previewFeatures?: boolean;
 }
 export declare class Config {
     private toolRegistry;
+    private mcpClientManager?;
+    private allowedMcpServers;
+    private blockedMcpServers;
     private promptRegistry;
-    private readonly sessionId;
+    private agentRegistry;
+    private sessionId;
     private fileSystemService;
     private contentGeneratorConfig;
     private contentGenerator;
+    readonly modelConfigService: ModelConfigService;
     private readonly embeddingModel;
     private readonly sandbox;
     private readonly targetDir;
     private workspaceContext;
     private readonly debugMode;
     private readonly question;
-    private readonly fullContext;
     private readonly coreTools;
     private readonly allowedTools;
     private readonly excludeTools;
     private readonly toolDiscoveryCommand;
     private readonly toolCallCommand;
     private readonly mcpServerCommand;
-    private readonly mcpServers;
+    private mcpServers;
     private userMemory;
     private geminiMdFileCount;
+    private geminiMdFilePaths;
     private approvalMode;
     private readonly showMemoryUsage;
     private readonly accessibility;
@@ -219,26 +263,31 @@ export declare class Config {
     private readonly cwd;
     private readonly bugCommand;
     private model;
-    private readonly extensionContextFilePaths;
+    private previewFeatures;
     private readonly noBrowser;
-    private readonly folderTrustFeature;
     private readonly folderTrust;
     private ideMode;
     private inFallbackMode;
     private readonly maxSessionTurns;
+    private readonly listSessions;
+    private readonly deleteSession;
     private readonly listExtensions;
-    private readonly _extensions;
-    private readonly _blockedMcpServers;
+    private readonly _extensionLoader;
+    private readonly _enabledExtensions;
+    private readonly enableExtensionReloading;
     fallbackModelHandler?: FallbackModelHandler;
     private quotaErrorOccurred;
     private readonly summarizeToolOutput;
     private readonly experimentalZedIntegration;
     private readonly loadMemoryFromIncludeDirectories;
-    private readonly chatCompression;
+    private readonly importFormat;
+    private readonly discoveryMaxDirs;
+    private readonly compressionThreshold;
     private readonly interactive;
+    private readonly ptyInfo;
     private readonly trustedFolder;
     private readonly useRipgrep;
-    private readonly shouldUseNodePtyShell;
+    private readonly enableInteractiveShell;
     private readonly skipNextSpeakerCheck;
     private shellExecutionConfig;
     private readonly extensionManagement;
@@ -255,8 +304,24 @@ export declare class Config {
     private readonly messageBus;
     private readonly policyEngine;
     private readonly outputSettings;
-    private readonly useModelRouter;
+    private useModelRouter;
+    private readonly initialUseModelRouter;
+    private readonly disableModelRouterForAuth?;
     private readonly enableMessageBusIntegration;
+    private readonly codebaseInvestigatorSettings;
+    private readonly continueOnFailedApiCall;
+    private readonly retryFetchErrors;
+    private readonly enableShellOutputEfficiency;
+    readonly fakeResponses?: string;
+    readonly recordResponses?: string;
+    private readonly disableYoloMode;
+    private pendingIncludeDirectories;
+    private readonly enableHooks;
+    private readonly hooks;
+    private experiments;
+    private experimentsPromise;
+    private previewModelFallbackMode;
+    private previewModelBypassMode;
     constructor(params: ConfigParameters);
     /**
      * Must only be called once, throws if called again.
@@ -270,13 +335,21 @@ export declare class Config {
      */
     getBaseLlmClient(): BaseLlmClient;
     getSessionId(): string;
+    setSessionId(sessionId: string): void;
     shouldLoadMemoryFromIncludeDirectories(): boolean;
+    getImportFormat(): 'tree' | 'flat';
+    getDiscoveryMaxDirs(): number;
     getContentGeneratorConfig(): ContentGeneratorConfig;
     getModel(): string;
     setModel(newModel: string): void;
     isInFallbackMode(): boolean;
     setFallbackMode(active: boolean): void;
     setFallbackModelHandler(handler: FallbackModelHandler): void;
+    getFallbackModelHandler(): FallbackModelHandler | undefined;
+    isPreviewModelFallbackMode(): boolean;
+    setPreviewModelFallbackMode(active: boolean): void;
+    isPreviewModelBypassMode(): boolean;
+    setPreviewModelBypassMode(active: boolean): void;
     getMaxSessionTurns(): number;
     setQuotaErrorOccurred(value: boolean): void;
     getQuotaErrorOccurred(): boolean;
@@ -286,24 +359,46 @@ export declare class Config {
     getTargetDir(): string;
     getProjectRoot(): string;
     getWorkspaceContext(): WorkspaceContext;
+    getAgentRegistry(): AgentRegistry;
     getToolRegistry(): ToolRegistry;
     getPromptRegistry(): PromptRegistry;
     getDebugMode(): boolean;
     getQuestion(): string | undefined;
-    getFullContext(): boolean;
+    getPreviewFeatures(): boolean | undefined;
+    setPreviewFeatures(previewFeatures: boolean): void;
     getCoreTools(): string[] | undefined;
     getAllowedTools(): string[] | undefined;
-    getExcludeTools(): string[] | undefined;
+    /**
+     * All the excluded tools from static configuration, loaded extensions, or
+     * other sources.
+     *
+     * May change over time.
+     */
+    getExcludeTools(): Set<string> | undefined;
     getToolDiscoveryCommand(): string | undefined;
     getToolCallCommand(): string | undefined;
     getMcpServerCommand(): string | undefined;
+    /**
+     * The user configured MCP servers (via gemini settings files).
+     *
+     * Does NOT include mcp servers configured by extensions.
+     */
     getMcpServers(): Record<string, MCPServerConfig> | undefined;
+    getMcpClientManager(): McpClientManager | undefined;
+    getAllowedMcpServers(): string[] | undefined;
+    getBlockedMcpServers(): string[] | undefined;
+    setMcpServers(mcpServers: Record<string, MCPServerConfig>): void;
     getUserMemory(): string;
     setUserMemory(newUserMemory: string): void;
     getGeminiMdFileCount(): number;
     setGeminiMdFileCount(count: number): void;
+    getGeminiMdFilePaths(): string[];
+    setGeminiMdFilePaths(paths: string[]): void;
     getApprovalMode(): ApprovalMode;
     setApprovalMode(mode: ApprovalMode): void;
+    isYoloModeDisabled(): boolean;
+    getPendingIncludeDirectories(): string[];
+    clearPendingIncludeDirectories(): void;
     getShowMemoryUsage(): boolean;
     getAccessibility(): AccessibilitySettings;
     getTelemetryEnabled(): boolean;
@@ -314,6 +409,11 @@ export declare class Config {
     getTelemetryOutfile(): string | undefined;
     getTelemetryUseCollector(): boolean;
     getGeminiClient(): GeminiClient;
+    /**
+     * Updates the system instruction with the latest user memory.
+     * Whenever the user memory (GEMINI.md files) is updated.
+     */
+    updateSystemInstructionIfInitialized(): Promise<void>;
     getModelRouterService(): ModelRouterService;
     getEnableRecursiveFileSearch(): boolean;
     getFileFilteringDisableFuzzySearch(): boolean;
@@ -332,25 +432,27 @@ export declare class Config {
     getBugCommand(): BugCommandSettings | undefined;
     getFileService(): FileDiscoveryService;
     getUsageStatisticsEnabled(): boolean;
-    getExtensionContextFilePaths(): string[];
     getExperimentalZedIntegration(): boolean;
     getListExtensions(): boolean;
+    getListSessions(): boolean;
+    getDeleteSession(): string | undefined;
     getExtensionManagement(): boolean;
     getExtensions(): GeminiCLIExtension[];
-    getBlockedMcpServers(): Array<{
-        name: string;
-        extensionName: string;
-    }>;
+    getExtensionLoader(): ExtensionLoader;
+    getEnabledExtensions(): string[];
+    getEnableExtensionReloading(): boolean;
     getNoBrowser(): boolean;
     isBrowserLaunchSuppressed(): boolean;
     getSummarizeToolOutputConfig(): Record<string, SummarizeToolOutputSettings> | undefined;
     getIdeMode(): boolean;
-    getFolderTrustFeature(): boolean;
+    /**
+     * Returns 'true' if the folder trust feature is enabled.
+     */
+    getFolderTrust(): boolean;
     /**
      * Returns 'true' if the workspace is considered "trusted".
      * 'false' for untrusted.
      */
-    getFolderTrust(): boolean;
     isTrustedFolder(): boolean;
     setIdeMode(value: boolean): void;
     /**
@@ -361,11 +463,19 @@ export declare class Config {
      * Set a custom FileSystemService
      */
     setFileSystemService(fileSystemService: FileSystemService): void;
-    getChatCompression(): ChatCompressionSettings | undefined;
+    getCompressionThreshold(): Promise<number | undefined>;
+    getUserCaching(): Promise<boolean | undefined>;
+    getBannerTextNoCapacityIssues(): Promise<string>;
+    getBannerTextCapacityIssues(): Promise<string>;
+    private ensureExperimentsLoaded;
+    isInteractiveShellEnabled(): boolean;
     isInteractive(): boolean;
     getUseRipgrep(): boolean;
-    getShouldUseNodePtyShell(): boolean;
+    getEnableInteractiveShell(): boolean;
     getSkipNextSpeakerCheck(): boolean;
+    getContinueOnFailedApiCall(): boolean;
+    getRetryFetchErrors(): boolean;
+    getEnableShellOutputEfficiency(): boolean;
     getShellExecutionConfig(): ShellExecutionConfig;
     setShellExecutionConfig(config: ShellExecutionConfig): void;
     getScreenReader(): boolean;
@@ -382,6 +492,22 @@ export declare class Config {
     getMessageBus(): MessageBus;
     getPolicyEngine(): PolicyEngine;
     getEnableMessageBusIntegration(): boolean;
+    getEnableHooks(): boolean;
+    getCodebaseInvestigatorSettings(): CodebaseInvestigatorSettings;
     createToolRegistry(): Promise<ToolRegistry>;
+    /**
+     * Get hooks configuration
+     */
+    getHooks(): {
+        [K in HookEventName]?: HookDefinition[];
+    } | undefined;
+    /**
+     * Get experiments configuration
+     */
+    getExperiments(): Experiments | undefined;
+    /**
+     * Set experiments configuration
+     */
+    setExperiments(experiments: Experiments): void;
 }
 export { DEFAULT_GEMINI_FLASH_MODEL };