@machina.ai/cell-cli-core 1.20.2-rc1 → 1.25.0-rc1

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

@@ -6,6 +6,7 @@
 import type { ContentGenerator, ContentGeneratorConfig } from '../core/contentGenerator.js';
 import { AuthType } from '../core/contentGenerator.js';
 import { PromptRegistry } from '../prompts/prompt-registry.js';
+import { ResourceRegistry } from '../resources/resource-registry.js';
 import { ToolRegistry } from '../tools/tool-registry.js';
 import { GeminiClient } from '../core/client.js';
 import { BaseLlmClient } from '../core/baseLlmClient.js';
@@ -20,9 +21,10 @@ import type { FallbackModelHandler } from '../fallback/types.js';
 import { ModelAvailabilityService } from '../availability/modelAvailabilityService.js';
 import { ModelRouterService } from '../routing/modelRouterService.js';
 import { OutputFormat } from '../output/types.js';
-import type { ModelConfigServiceConfig } from '../services/modelConfigService.js';
+import type { ModelConfig, ModelConfigServiceConfig } from '../services/modelConfigService.js';
 import { ModelConfigService } from '../services/modelConfigService.js';
 import { ContextManager } from '../services/contextManager.js';
+import type { GenerateContentParameters } from '@google/genai';
 export type { MCPOAuthConfig, AnyToolInvocation };
 import type { AnyToolInvocation } from '../tools/tools.js';
 import { WorkspaceContext } from '../utils/workspaceContext.js';
@@ -32,13 +34,15 @@ 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 { ApprovalMode, type PolicyEngineConfig } from '../policy/types.js';
 import { HookSystem } from '../hooks/index.js';
 import type { UserTierId } from '../code_assist/types.js';
+import type { RetrieveUserQuotaResponse } from '../code_assist/types.js';
+import type { GeminiCodeAssistSetting } from '../code_assist/types.js';
 import type { Experiments } from '../code_assist/experiments/experiments.js';
 import { AgentRegistry } from '../agents/registry.js';
-import { ApprovalMode } from '../policy/types.js';
-export { ApprovalMode };
+import { SkillManager, type SkillDefinition } from '../skills/skillManager.js';
+import type { AgentDefinition } from '../agents/types.js';
 export interface AccessibilitySettings {
     disableLoadingPhrases?: boolean;
     screenReader?: boolean;
@@ -57,6 +61,7 @@ export interface TelemetrySettings {
     logPrompts?: boolean;
     outfile?: string;
     useCollector?: boolean;
+    useCliAuth?: boolean;
 }
 export interface OutputSettings {
     format?: OutputFormat;
@@ -68,6 +73,35 @@ export interface CodebaseInvestigatorSettings {
     thinkingBudget?: number;
     model?: string;
 }
+export interface ExtensionSetting {
+    name: string;
+    description: string;
+    envVar: string;
+    sensitive?: boolean;
+}
+export interface ResolvedExtensionSetting {
+    name: string;
+    envVar: string;
+    value: string;
+    sensitive: boolean;
+    scope?: 'user' | 'workspace';
+    source?: string;
+}
+export interface CliHelpAgentSettings {
+    enabled?: boolean;
+}
+export interface AgentRunConfig {
+    maxTimeMinutes?: number;
+    maxTurns?: number;
+}
+export interface AgentOverride {
+    modelConfig?: ModelConfig;
+    runConfig?: AgentRunConfig;
+    disabled?: boolean;
+}
+export interface AgentSettings {
+    overrides?: Record<string, AgentOverride>;
+}
 /**
  * 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
@@ -87,6 +121,10 @@ export interface GeminiCLIExtension {
     hooks?: {
         [K in HookEventName]?: HookDefinition[];
     };
+    settings?: ExtensionSetting[];
+    resolvedSettings?: ResolvedExtensionSetting[];
+    skills?: SkillDefinition[];
+    agents?: AgentDefinition[];
 }
 export interface ExtensionInstallMetadata {
     source: string;
@@ -100,6 +138,7 @@ import type { FileFilteringOptions } 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';
+import type { EnvironmentSanitizationConfig } from '../services/environmentSanitization.js';
 export type { FileFilteringOptions };
 export { DEFAULT_FILE_FILTERING_OPTIONS, DEFAULT_MEMORY_FILE_FILTERING_OPTIONS, };
 export declare const DEFAULT_TRUNCATE_TOOL_OUTPUT_THRESHOLD = 4000000;
@@ -114,6 +153,7 @@ export declare class MCPServerConfig {
     readonly httpUrl?: string | undefined;
     readonly headers?: Record<string, string> | undefined;
     readonly tcp?: string | undefined;
+    readonly type?: "sse" | "http" | undefined;
     readonly timeout?: number | undefined;
     readonly trust?: boolean | undefined;
     readonly description?: string | undefined;
@@ -124,7 +164,7 @@ export declare class MCPServerConfig {
     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, stdio?: boolean | 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);
+    constructor(command?: string | undefined, args?: string[] | undefined, env?: Record<string, string> | undefined, cwd?: string | undefined, stdio?: boolean | undefined, url?: string | undefined, httpUrl?: string | undefined, headers?: Record<string, string> | undefined, tcp?: string | undefined, type?: "sse" | "http" | 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",
@@ -185,6 +225,9 @@ export interface ConfigParameters {
     enableExtensionReloading?: boolean;
     allowedMcpServers?: string[];
     blockedMcpServers?: string[];
+    allowedEnvironmentVariables?: string[];
+    blockedEnvironmentVariables?: string[];
+    enableEnvironmentVariableRedaction?: boolean;
     noBrowser?: boolean;
     summarizeToolOutput?: Record<string, SummarizeToolOutputSettings>;
     folderTrust?: boolean;
@@ -205,13 +248,12 @@ export interface ConfigParameters {
     truncateToolOutputLines?: number;
     enableToolOutputTruncation?: boolean;
     eventEmitter?: EventEmitter;
-    useSmartEdit?: boolean;
     useWriteTodos?: boolean;
     policyEngineConfig?: PolicyEngineConfig;
     output?: OutputSettings;
-    enableMessageBusIntegration?: boolean;
     disableModelRouterForAuth?: AuthType[];
     codebaseInvestigatorSettings?: CodebaseInvestigatorSettings;
+    cliHelpAgentSettings?: CliHelpAgentSettings;
     continueOnFailedApiCall?: boolean;
     retryFetchErrors?: boolean;
     enableShellOutputEfficiency?: boolean;
@@ -222,21 +264,46 @@ export interface ConfigParameters {
     disableYoloMode?: boolean;
     modelConfigServiceConfig?: ModelConfigServiceConfig;
     enableHooks?: boolean;
+    enableHooksUI?: boolean;
     experiments?: Experiments;
     hooks?: {
         [K in HookEventName]?: HookDefinition[];
+    } & {
+        disabled?: string[];
+    };
+    projectHooks?: {
+        [K in HookEventName]?: HookDefinition[];
+    } & {
+        disabled?: string[];
     };
     previewFeatures?: boolean;
-    enableModelAvailabilityService?: boolean;
+    enableAgents?: boolean;
+    skillsSupport?: boolean;
+    disabledSkills?: string[];
+    adminSkillsEnabled?: boolean;
     experimentalJitContext?: boolean;
+    disableLLMCorrection?: boolean;
+    onModelChange?: (model: string) => void;
+    mcpEnabled?: boolean;
+    extensionsEnabled?: boolean;
+    agents?: AgentSettings;
+    onReload?: () => Promise<{
+        disabledSkills?: string[];
+        adminSkillsEnabled?: boolean;
+    }>;
 }
 export declare class Config {
     private toolRegistry;
     private mcpClientManager?;
     private allowedMcpServers;
     private blockedMcpServers;
+    private allowedEnvironmentVariables;
+    private blockedEnvironmentVariables;
+    private readonly enableEnvironmentVariableRedaction;
     private promptRegistry;
+    private resourceRegistry;
     private agentRegistry;
+    private skillManager;
     private sessionId;
     private fileSystemService;
     private contentGeneratorConfig;
@@ -254,11 +321,12 @@ export declare class Config {
     private readonly toolDiscoveryCommand;
     private readonly toolCallCommand;
     private readonly mcpServerCommand;
+    private readonly mcpEnabled;
+    private readonly extensionsEnabled;
     private mcpServers;
     private userMemory;
     private geminiMdFileCount;
     private geminiMdFilePaths;
-    private approvalMode;
     private readonly showMemoryUsage;
     private readonly accessibility;
     private readonly telemetrySettings;
@@ -280,10 +348,11 @@ export declare class Config {
     private readonly bugCommand;
     private model;
     private previewFeatures;
+    private hasAccessToPreviewModel;
     private readonly noBrowser;
     private readonly folderTrust;
     private ideMode;
-    private inFallbackMode;
+    private _activeModel;
     private readonly maxSessionTurns;
     private readonly listSessions;
     private readonly deleteSession;
@@ -315,13 +384,12 @@ export declare class Config {
     readonly storage: Storage;
     private readonly fileExclusions;
     private readonly eventEmitter?;
-    private readonly useSmartEdit;
     private readonly useWriteTodos;
     private readonly messageBus;
     private readonly policyEngine;
     private readonly outputSettings;
-    private readonly enableMessageBusIntegration;
     private readonly codebaseInvestigatorSettings;
+    private readonly cliHelpAgentSettings;
     private readonly continueOnFailedApiCall;
     private readonly retryFetchErrors;
     private readonly enableShellOutputEfficiency;
@@ -331,15 +399,26 @@ export declare class Config {
     private readonly disableYoloMode;
     private pendingIncludeDirectories;
     private readonly enableHooks;
+    private readonly enableHooksUI;
     private readonly hooks;
+    private readonly projectHooks;
+    private readonly disabledHooks;
     private experiments;
     private experimentsPromise;
     private hookSystem?;
-    private previewModelFallbackMode;
-    private previewModelBypassMode;
-    private readonly enableModelAvailabilityService;
+    private readonly onModelChange;
+    private readonly onReload;
+    private readonly enableAgents;
+    private readonly agents;
+    private readonly skillsSupport;
+    private disabledSkills;
+    private readonly adminSkillsEnabled;
     private readonly experimentalJitContext;
+    private readonly disableLLMCorrection;
     private contextManager?;
+    private terminalBackground;
+    private remoteAdminSettings;
+    private latestApiRequest;
     constructor(params: ConfigParameters);
     /**
      * Must only be called once, throws if called again.
@@ -355,20 +434,24 @@ export declare class Config {
     getBaseLlmClient(): BaseLlmClient;
     getSessionId(): string;
     setSessionId(sessionId: string): void;
+    setTerminalBackground(terminalBackground: string | undefined): void;
+    getTerminalBackground(): string | undefined;
+    getLatestApiRequest(): GenerateContentParameters | undefined;
+    setLatestApiRequest(req: GenerateContentParameters): void;
+    getRemoteAdminSettings(): GeminiCodeAssistSetting | undefined;
+    setRemoteAdminSettings(settings: GeminiCodeAssistSetting): void;
     shouldLoadMemoryFromIncludeDirectories(): boolean;
     getImportFormat(): 'tree' | 'flat';
     getDiscoveryMaxDirs(): number;
     getContentGeneratorConfig(): ContentGeneratorConfig;
     getModel(): string;
-    setModel(newModel: string): void;
-    isInFallbackMode(): boolean;
-    setFallbackMode(active: boolean): void;
+    setModel(newModel: string, isTemporary?: boolean): void;
+    activateFallbackMode(model: string): void;
+    getActiveModel(): string;
+    setActiveModel(model: string): void;
     setFallbackModelHandler(handler: FallbackModelHandler): void;
     getFallbackModelHandler(): FallbackModelHandler | undefined;
-    isPreviewModelFallbackMode(): boolean;
-    setPreviewModelFallbackMode(active: boolean): void;
-    isPreviewModelBypassMode(): boolean;
-    setPreviewModelBypassMode(active: boolean): void;
+    resetTurn(): void;
     getMaxSessionTurns(): number;
     setQuotaErrorOccurred(value: boolean): void;
     getQuotaErrorOccurred(): boolean;
@@ -381,10 +464,15 @@ export declare class Config {
     getAgentRegistry(): AgentRegistry;
     getToolRegistry(): ToolRegistry;
     getPromptRegistry(): PromptRegistry;
+    getSkillManager(): SkillManager;
+    getResourceRegistry(): ResourceRegistry;
     getDebugMode(): boolean;
     getQuestion(): string | undefined;
     getPreviewFeatures(): boolean | undefined;
     setPreviewFeatures(previewFeatures: boolean): void;
+    getHasAccessToPreviewModel(): boolean;
+    setHasAccessToPreviewModel(hasAccess: boolean): void;
+    refreshUserQuota(): Promise<RetrieveUserQuotaResponse | undefined>;
     getCoreTools(): string[] | undefined;
     getAllowedTools(): string[] | undefined;
     /**
@@ -403,9 +491,12 @@ export declare class Config {
      * Does NOT include mcp servers configured by extensions.
      */
     getMcpServers(): Record<string, MCPServerConfig> | undefined;
+    getMcpEnabled(): boolean;
+    getExtensionsEnabled(): boolean;
     getMcpClientManager(): McpClientManager | undefined;
     getAllowedMcpServers(): string[] | undefined;
     getBlockedMcpServers(): string[] | undefined;
+    get sanitizationConfig(): EnvironmentSanitizationConfig;
     setMcpServers(mcpServers: Record<string, MCPServerConfig>): void;
     getUserMemory(): string;
     setUserMemory(newUserMemory: string): void;
@@ -431,6 +522,7 @@ export declare class Config {
     getTelemetryTarget(): TelemetryTarget;
     getTelemetryOutfile(): string | undefined;
     getTelemetryUseCollector(): boolean;
+    getTelemetryUseCliAuth(): boolean;
     getGeminiClient(): GeminiClient;
     /**
      * Updates the system instruction with the latest user memory.
@@ -469,8 +561,10 @@ export declare class Config {
     getExtensionLoader(): ExtensionLoader;
     getEnabledExtensions(): string[];
     getEnableExtensionReloading(): boolean;
-    isModelAvailabilityServiceEnabled(): boolean;
+    getDisableLLMCorrection(): boolean;
+    isAgentsEnabled(): boolean;
     getNoBrowser(): boolean;
+    getAgentsSettings(): AgentSettings;
     isBrowserLaunchSuppressed(): boolean;
     getSummarizeToolOutputConfig(): Record<string, SummarizeToolOutputSettings> | undefined;
     getIdeMode(): boolean;
@@ -498,6 +592,11 @@ export declare class Config {
     getBannerTextCapacityIssues(): Promise<string>;
     private ensureExperimentsLoaded;
     isInteractiveShellEnabled(): boolean;
+    isSkillsSupportEnabled(): boolean;
+    /**
+     * Reloads skills by re-discovering them from extensions and local directories.
+     */
+    reloadSkills(): Promise<void>;
     isInteractive(): boolean;
     getUseRipgrep(): boolean;
     getEnableInteractiveShell(): boolean;
@@ -513,17 +612,21 @@ export declare class Config {
     getEnableToolOutputTruncation(): boolean;
     getTruncateToolOutputThreshold(): number;
     getTruncateToolOutputLines(): number;
-    getUseSmartEdit(): boolean;
     getUseWriteTodos(): boolean;
     getOutputFormat(): OutputFormat;
     getGitService(): Promise<GitService>;
     getFileExclusions(): FileExclusions;
     getMessageBus(): MessageBus;
     getPolicyEngine(): PolicyEngine;
-    getEnableMessageBusIntegration(): boolean;
     getEnableHooks(): boolean;
+    getEnableHooksUI(): boolean;
     getCodebaseInvestigatorSettings(): CodebaseInvestigatorSettings;
+    getCliHelpAgentSettings(): CliHelpAgentSettings;
     createToolRegistry(): Promise<ToolRegistry>;
+    /**
+     * Registers the DelegateToAgentTool if agents or related features are enabled.
+     */
+    private registerDelegateToAgentTool;
     /**
      * Get the hook system instance
      */
@@ -534,6 +637,18 @@ export declare class Config {
     getHooks(): {
         [K in HookEventName]?: HookDefinition[];
     } | undefined;
+    /**
+     * Get project-specific hooks configuration
+     */
+    getProjectHooks(): ({
+        [K in HookEventName]?: HookDefinition[];
+    } & {
+        disabled?: string[];
+    }) | undefined;
+    /**
+     * Get disabled hooks list
+     */
+    getDisabledHooks(): string[];
     /**
      * Get experiments configuration
      */
@@ -542,5 +657,10 @@ export declare class Config {
      * Set experiments configuration
      */
     setExperiments(experiments: Experiments): void;
+    private onAgentsRefreshed;
+    /**
+     * Disposes of resources and removes event listeners.
+     */
+    dispose(): Promise<void>;
 }
 export { DEFAULT_GEMINI_FLASH_MODEL };