@mcp-use/cli 1.0.0 → 1.0.1

package/dist/services/cli-service.d.ts

@@ -0,0 +1,132 @@
+import type { CommandResult } from '../types.js';
+import type { ToolCall } from '../types.js';
+export declare class CLIService {
+    private isInitialized;
+    private agentService;
+    private llmService;
+    private mcpConfigService;
+    private utilityService;
+    private commandRegistry;
+    /**
+     * Initializes the CLIService and its dependencies. This acts as the
+     * composition root for the application's services.
+     */
+    constructor();
+    /**
+     * Registers all available commands in the command registry.
+     * This creates a centralized mapping of command names to their handlers.
+     */
+    private registerCommands;
+    /**
+     * Initializes the CLI service, ensuring the agent is ready.
+     * This method is idempotent and will only run once.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Initializes the underlying MCP agent via the AgentService.
+     * If initialization fails, an error is logged, but the CLI can continue
+     * to operate for command-line tasks.
+     */
+    initializeAgent(): Promise<void>;
+    /**
+     * Re-initializes the agent. This is useful when the configuration
+     * (e.g., model or servers) has changed.
+     */
+    refreshAgent(): Promise<void>;
+    /**
+     * Checks if the input is a slash command.
+     * @param input - The user input to check
+     * @returns True if the input starts with /
+     */
+    private isCommand;
+    /**
+     * Handles command execution by routing to the appropriate service.
+     * @param input - The full command input including the slash
+     * @returns A promise that resolves to the command result
+     */
+    private handleCommand;
+    /**
+     * Processes a user's message. It determines if the message is a command
+     * or a prompt for the agent and routes it accordingly. It also handles
+     * special input modes like API key entry or server configuration.
+     * @param message The raw input string from the user.
+     * @param isApiKeyInput True if the input is an API key.
+     * @param pendingProvider The provider for which the API key is being entered.
+     * @param pendingModel The model for which the API key is being entered.
+     * @param isServerConfigInput True if the input is part of the server config flow.
+     * @param serverConfigStep The current step in the server configuration flow.
+     * @param serverConfig The server configuration object being built.
+     * @returns A promise that resolves to the result of the message processing.
+     */
+    sendMessage(message: string, isApiKeyInput?: boolean, pendingProvider?: string, pendingModel?: string, isServerConfigInput?: boolean, serverConfigStep?: string, serverConfig?: any): AsyncGenerator<{
+        response?: string;
+        toolCalls?: ToolCall[];
+        thought?: string;
+        isCommand?: boolean;
+        commandResult?: CommandResult;
+        done: boolean;
+    }>;
+    /**
+     * Returns an example model name for a given provider.
+     * @param provider The name of the LLM provider.
+     * @returns An example model name string.
+     */
+    private getExampleModel;
+    /**
+     * Checks if the CLI service has been initialized.
+     * @returns True if the service is initialized, false otherwise.
+     */
+    isReady(): boolean;
+    /**
+     * Gets a formatted string representing the current model.
+     * @returns A string like "provider/model-name" or a status message.
+     */
+    getCurrentModel(): string;
+    /**
+     * Gets a list of all configured server names from persistent storage.
+     * @returns An array of configured server names.
+     */
+    getConfiguredServers(): string[];
+    /**
+     * Gets a list of currently connected server names.
+     * @returns An array of connected server names.
+     */
+    getConnectedServers(): string[];
+    /**
+     * Gets the list of available tools from the agent.
+     * @returns A promise that resolves to an object containing the tools or an error.
+     */
+    getAvailableTools(): Promise<{
+        tools: any[];
+        error?: string;
+    }>;
+    /**
+     * Handles the /servers command by combining configuration and connection status.
+     * @returns A CommandResult with the server list including connection status
+     */
+    private handleListServersCommand;
+    /**
+     * Handles the base /server command to show subcommands.
+     * @param args - Command arguments
+     * @returns A CommandResult with help information
+     */
+    private handleServerCommand;
+    /**
+     * Handles the /server add subcommand.
+     * @returns A CommandResult to start server configuration
+     */
+    private handleServerAddCommand;
+    /**
+     * Handles the /server connect subcommand.
+     * @param args - Array where args[0] is the server name
+     * @returns A CommandResult with connection status
+     */
+    private handleServerConnectCommand;
+    /**
+     * Handles the /server disconnect subcommand.
+     * @param args - Array where args[0] is the server name
+     * @returns A CommandResult with disconnection status
+     */
+    private handleServerDisconnectCommand;
+}
+export declare const cliService: CLIService;