@google/gemini-cli-core 0.0.1

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

@@ -0,0 +1,378 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ContentGenerator, ContentGeneratorConfig } from '../core/contentGenerator.js';
+import { AuthType } from '../core/contentGenerator.js';
+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 { FileDiscoveryService } from '../services/fileDiscoveryService.js';
+import { GitService } from '../services/gitService.js';
+import type { TelemetryTarget } from '../telemetry/index.js';
+import { DEFAULT_GEMINI_FLASH_MODEL } from './models.js';
+import type { MCPOAuthConfig } from '../mcp/oauth-provider.js';
+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';
+export type { MCPOAuthConfig, AnyToolInvocation };
+import type { AnyToolInvocation } from '../tools/tools.js';
+import { WorkspaceContext } from '../utils/workspaceContext.js';
+import { Storage } from './storage.js';
+import type { ShellExecutionConfig } from '../services/shellExecutionService.js';
+import { FileExclusions } from '../utils/ignorePatterns.js';
+import type { EventEmitter } from 'node:events';
+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"
+}
+export interface AccessibilitySettings {
+    disableLoadingPhrases?: boolean;
+    screenReader?: boolean;
+}
+export interface BugCommandSettings {
+    urlTemplate: string;
+}
+export interface ChatCompressionSettings {
+    contextPercentageThreshold?: number;
+}
+export interface SummarizeToolOutputSettings {
+    tokenBudget?: number;
+}
+export interface TelemetrySettings {
+    enabled?: boolean;
+    target?: TelemetryTarget;
+    otlpEndpoint?: string;
+    otlpProtocol?: 'grpc' | 'http';
+    logPrompts?: boolean;
+    outfile?: string;
+    useCollector?: boolean;
+}
+export interface OutputSettings {
+    format?: OutputFormat;
+}
+export interface GeminiCLIExtension {
+    name: string;
+    version: string;
+    isActive: boolean;
+    path: string;
+    installMetadata?: ExtensionInstallMetadata;
+}
+export interface ExtensionInstallMetadata {
+    source: string;
+    type: 'git' | 'local' | 'link' | 'github-release';
+    ref?: string;
+}
+export interface FileFilteringOptions {
+    respectGitIgnore: boolean;
+    respectGeminiIgnore: boolean;
+}
+export declare const DEFAULT_MEMORY_FILE_FILTERING_OPTIONS: FileFilteringOptions;
+export declare const DEFAULT_FILE_FILTERING_OPTIONS: FileFilteringOptions;
+export declare const DEFAULT_TRUNCATE_TOOL_OUTPUT_THRESHOLD = 4000000;
+export declare const DEFAULT_TRUNCATE_TOOL_OUTPUT_LINES = 1000;
+export declare class MCPServerConfig {
+    readonly command?: string | undefined;
+    readonly args?: string[] | undefined;
+    readonly env?: Record<string, string> | undefined;
+    readonly cwd?: string | undefined;
+    readonly url?: string | undefined;
+    readonly httpUrl?: string | undefined;
+    readonly headers?: Record<string, string> | undefined;
+    readonly tcp?: string | undefined;
+    readonly timeout?: number | undefined;
+    readonly trust?: boolean | undefined;
+    readonly description?: string | undefined;
+    readonly includeTools?: string[] | undefined;
+    readonly excludeTools?: string[] | undefined;
+    readonly extensionName?: string | undefined;
+    readonly oauth?: MCPOAuthConfig | undefined;
+    readonly authProviderType?: AuthProviderType | 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);
+}
+export declare enum AuthProviderType {
+    DYNAMIC_DISCOVERY = "dynamic_discovery",
+    GOOGLE_CREDENTIALS = "google_credentials"
+}
+export interface SandboxConfig {
+    command: 'docker' | 'podman' | 'sandbox-exec';
+    image: string;
+}
+export interface ConfigParameters {
+    sessionId: string;
+    embeddingModel?: string;
+    sandbox?: SandboxConfig;
+    targetDir: string;
+    debugMode: boolean;
+    question?: string;
+    fullContext?: boolean;
+    coreTools?: string[];
+    allowedTools?: string[];
+    excludeTools?: string[];
+    toolDiscoveryCommand?: string;
+    toolCallCommand?: string;
+    mcpServerCommand?: string;
+    mcpServers?: Record<string, MCPServerConfig>;
+    userMemory?: string;
+    geminiMdFileCount?: number;
+    approvalMode?: ApprovalMode;
+    showMemoryUsage?: boolean;
+    contextFileName?: string | string[];
+    accessibility?: AccessibilitySettings;
+    telemetry?: TelemetrySettings;
+    usageStatisticsEnabled?: boolean;
+    fileFiltering?: {
+        respectGitIgnore?: boolean;
+        respectGeminiIgnore?: boolean;
+        enableRecursiveFileSearch?: boolean;
+        disableFuzzySearch?: boolean;
+    };
+    checkpointing?: boolean;
+    proxy?: string;
+    cwd: string;
+    fileDiscoveryService?: FileDiscoveryService;
+    includeDirectories?: string[];
+    bugCommand?: BugCommandSettings;
+    model: string;
+    extensionContextFilePaths?: string[];
+    maxSessionTurns?: number;
+    experimentalZedIntegration?: boolean;
+    listExtensions?: boolean;
+    extensions?: GeminiCLIExtension[];
+    blockedMcpServers?: Array<{
+        name: string;
+        extensionName: string;
+    }>;
+    noBrowser?: boolean;
+    summarizeToolOutput?: Record<string, SummarizeToolOutputSettings>;
+    folderTrustFeature?: boolean;
+    folderTrust?: boolean;
+    ideMode?: boolean;
+    loadMemoryFromIncludeDirectories?: boolean;
+    chatCompression?: ChatCompressionSettings;
+    interactive?: boolean;
+    trustedFolder?: boolean;
+    useRipgrep?: boolean;
+    shouldUseNodePtyShell?: boolean;
+    skipNextSpeakerCheck?: boolean;
+    shellExecutionConfig?: ShellExecutionConfig;
+    extensionManagement?: boolean;
+    enablePromptCompletion?: boolean;
+    truncateToolOutputThreshold?: number;
+    truncateToolOutputLines?: number;
+    enableToolOutputTruncation?: boolean;
+    eventEmitter?: EventEmitter;
+    useSmartEdit?: boolean;
+    policyEngineConfig?: PolicyEngineConfig;
+    output?: OutputSettings;
+    useModelRouter?: boolean;
+}
+export declare class Config {
+    private toolRegistry;
+    private promptRegistry;
+    private readonly sessionId;
+    private fileSystemService;
+    private contentGeneratorConfig;
+    private contentGenerator;
+    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 userMemory;
+    private geminiMdFileCount;
+    private approvalMode;
+    private readonly showMemoryUsage;
+    private readonly accessibility;
+    private readonly telemetrySettings;
+    private readonly usageStatisticsEnabled;
+    private geminiClient;
+    private baseLlmClient;
+    private modelRouterService;
+    private readonly fileFiltering;
+    private fileDiscoveryService;
+    private gitService;
+    private readonly checkpointing;
+    private readonly proxy;
+    private readonly cwd;
+    private readonly bugCommand;
+    private model;
+    private readonly extensionContextFilePaths;
+    private readonly noBrowser;
+    private readonly folderTrustFeature;
+    private readonly folderTrust;
+    private ideMode;
+    private inFallbackMode;
+    private readonly maxSessionTurns;
+    private readonly listExtensions;
+    private readonly _extensions;
+    private readonly _blockedMcpServers;
+    fallbackModelHandler?: FallbackModelHandler;
+    private quotaErrorOccurred;
+    private readonly summarizeToolOutput;
+    private readonly experimentalZedIntegration;
+    private readonly loadMemoryFromIncludeDirectories;
+    private readonly chatCompression;
+    private readonly interactive;
+    private readonly trustedFolder;
+    private readonly useRipgrep;
+    private readonly shouldUseNodePtyShell;
+    private readonly skipNextSpeakerCheck;
+    private shellExecutionConfig;
+    private readonly extensionManagement;
+    private readonly enablePromptCompletion;
+    private readonly truncateToolOutputThreshold;
+    private readonly truncateToolOutputLines;
+    private readonly enableToolOutputTruncation;
+    private initialized;
+    readonly storage: Storage;
+    private readonly fileExclusions;
+    private readonly eventEmitter?;
+    private readonly useSmartEdit;
+    private readonly messageBus;
+    private readonly policyEngine;
+    private readonly outputSettings;
+    private readonly useModelRouter;
+    constructor(params: ConfigParameters);
+    /**
+     * Must only be called once, throws if called again.
+     */
+    initialize(): Promise<void>;
+    getContentGenerator(): ContentGenerator;
+    refreshAuth(authMethod: AuthType): Promise<void>;
+    getUserTier(): UserTierId | undefined;
+    /**
+     * Provides access to the BaseLlmClient for stateless LLM operations.
+     */
+    getBaseLlmClient(): BaseLlmClient;
+    getSessionId(): string;
+    shouldLoadMemoryFromIncludeDirectories(): boolean;
+    getContentGeneratorConfig(): ContentGeneratorConfig;
+    getModel(): string;
+    setModel(newModel: string): void;
+    isInFallbackMode(): boolean;
+    setFallbackMode(active: boolean): void;
+    setFallbackModelHandler(handler: FallbackModelHandler): void;
+    getMaxSessionTurns(): number;
+    setQuotaErrorOccurred(value: boolean): void;
+    getQuotaErrorOccurred(): boolean;
+    getEmbeddingModel(): string;
+    getSandbox(): SandboxConfig | undefined;
+    isRestrictiveSandbox(): boolean;
+    getTargetDir(): string;
+    getProjectRoot(): string;
+    getWorkspaceContext(): WorkspaceContext;
+    getToolRegistry(): ToolRegistry;
+    getPromptRegistry(): PromptRegistry;
+    getDebugMode(): boolean;
+    getQuestion(): string | undefined;
+    getFullContext(): boolean;
+    getCoreTools(): string[] | undefined;
+    getAllowedTools(): string[] | undefined;
+    getExcludeTools(): string[] | undefined;
+    getToolDiscoveryCommand(): string | undefined;
+    getToolCallCommand(): string | undefined;
+    getMcpServerCommand(): string | undefined;
+    getMcpServers(): Record<string, MCPServerConfig> | undefined;
+    getUserMemory(): string;
+    setUserMemory(newUserMemory: string): void;
+    getGeminiMdFileCount(): number;
+    setGeminiMdFileCount(count: number): void;
+    getApprovalMode(): ApprovalMode;
+    setApprovalMode(mode: ApprovalMode): void;
+    getShowMemoryUsage(): boolean;
+    getAccessibility(): AccessibilitySettings;
+    getTelemetryEnabled(): boolean;
+    getTelemetryLogPromptsEnabled(): boolean;
+    getTelemetryOtlpEndpoint(): string;
+    getTelemetryOtlpProtocol(): 'grpc' | 'http';
+    getTelemetryTarget(): TelemetryTarget;
+    getTelemetryOutfile(): string | undefined;
+    getTelemetryUseCollector(): boolean;
+    getGeminiClient(): GeminiClient;
+    getModelRouterService(): ModelRouterService;
+    getEnableRecursiveFileSearch(): boolean;
+    getFileFilteringDisableFuzzySearch(): boolean;
+    getFileFilteringRespectGitIgnore(): boolean;
+    getFileFilteringRespectGeminiIgnore(): boolean;
+    getFileFilteringOptions(): FileFilteringOptions;
+    /**
+     * Gets custom file exclusion patterns from configuration.
+     * TODO: This is a placeholder implementation. In the future, this could
+     * read from settings files, CLI arguments, or environment variables.
+     */
+    getCustomExcludes(): string[];
+    getCheckpointingEnabled(): boolean;
+    getProxy(): string | undefined;
+    getWorkingDir(): string;
+    getBugCommand(): BugCommandSettings | undefined;
+    getFileService(): FileDiscoveryService;
+    getUsageStatisticsEnabled(): boolean;
+    getExtensionContextFilePaths(): string[];
+    getExperimentalZedIntegration(): boolean;
+    getListExtensions(): boolean;
+    getExtensionManagement(): boolean;
+    getExtensions(): GeminiCLIExtension[];
+    getBlockedMcpServers(): Array<{
+        name: string;
+        extensionName: string;
+    }>;
+    getNoBrowser(): boolean;
+    isBrowserLaunchSuppressed(): boolean;
+    getSummarizeToolOutputConfig(): Record<string, SummarizeToolOutputSettings> | undefined;
+    getIdeMode(): boolean;
+    getFolderTrustFeature(): boolean;
+    /**
+     * Returns 'true' if the workspace is considered "trusted".
+     * 'false' for untrusted.
+     */
+    getFolderTrust(): boolean;
+    isTrustedFolder(): boolean;
+    setIdeMode(value: boolean): void;
+    /**
+     * Get the current FileSystemService
+     */
+    getFileSystemService(): FileSystemService;
+    /**
+     * Set a custom FileSystemService
+     */
+    setFileSystemService(fileSystemService: FileSystemService): void;
+    getChatCompression(): ChatCompressionSettings | undefined;
+    isInteractive(): boolean;
+    getUseRipgrep(): boolean;
+    getShouldUseNodePtyShell(): boolean;
+    getSkipNextSpeakerCheck(): boolean;
+    getShellExecutionConfig(): ShellExecutionConfig;
+    setShellExecutionConfig(config: ShellExecutionConfig): void;
+    getScreenReader(): boolean;
+    getEnablePromptCompletion(): boolean;
+    getEnableToolOutputTruncation(): boolean;
+    getTruncateToolOutputThreshold(): number;
+    getTruncateToolOutputLines(): number;
+    getUseSmartEdit(): boolean;
+    getOutputFormat(): OutputFormat;
+    getUseModelRouter(): boolean;
+    getGitService(): Promise<GitService>;
+    getFileExclusions(): FileExclusions;
+    getMessageBus(): MessageBus;
+    getPolicyEngine(): PolicyEngine;
+    createToolRegistry(): Promise<ToolRegistry>;
+}
+export { DEFAULT_GEMINI_FLASH_MODEL };