xibecode 0.0.3 → 0.0.4

package/dist/core/mcp-client.js

@@ -0,0 +1,250 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+/**
+ * Manages connections to MCP servers and provides unified access to their capabilities
+ */
+export class MCPClientManager {
+    clients = new Map();
+    serverConfigs = new Map();
+    tools = new Map();
+    resources = new Map();
+    prompts = new Map();
+    /**
+     * Connect to an MCP server
+     */
+    async connect(serverConfig) {
+        if (this.clients.has(serverConfig.name)) {
+            throw new Error(`Already connected to MCP server: ${serverConfig.name}`);
+        }
+        try {
+            const client = new Client({
+                name: 'xibecode',
+                version: '1.0.0',
+            }, {
+                capabilities: {},
+            });
+            if (serverConfig.transport !== 'stdio') {
+                throw new Error(`Currently only 'stdio' transport is supported. Server: ${serverConfig.name}`);
+            }
+            if (!serverConfig.command) {
+                throw new Error(`stdio transport requires 'command' for server ${serverConfig.name}`);
+            }
+            const transport = new StdioClientTransport({
+                command: serverConfig.command,
+                args: serverConfig.args || [],
+                env: serverConfig.env,
+            });
+            await client.connect(transport);
+            // Store client and config
+            this.clients.set(serverConfig.name, client);
+            this.serverConfigs.set(serverConfig.name, serverConfig);
+            // Discover and cache capabilities
+            await this.discoverCapabilities(serverConfig.name);
+        }
+        catch (error) {
+            throw new Error(`Failed to connect to MCP server ${serverConfig.name}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Disconnect from an MCP server
+     */
+    async disconnect(serverName) {
+        const client = this.clients.get(serverName);
+        if (!client) {
+            return;
+        }
+        try {
+            await client.close();
+        }
+        catch (error) {
+            // Log but don't throw - we're disconnecting anyway
+            console.error(`Error disconnecting from ${serverName}:`, error);
+        }
+        this.clients.delete(serverName);
+        this.serverConfigs.delete(serverName);
+        // Remove cached capabilities
+        for (const [key, tool] of this.tools.entries()) {
+            if (tool.serverName === serverName) {
+                this.tools.delete(key);
+            }
+        }
+        for (const [key, resource] of this.resources.entries()) {
+            if (resource.serverName === serverName) {
+                this.resources.delete(key);
+            }
+        }
+        for (const [key, prompt] of this.prompts.entries()) {
+            if (prompt.serverName === serverName) {
+                this.prompts.delete(key);
+            }
+        }
+    }
+    /**
+     * Disconnect from all MCP servers
+     */
+    async disconnectAll() {
+        const serverNames = Array.from(this.clients.keys());
+        await Promise.all(serverNames.map(name => this.disconnect(name)));
+    }
+    /**
+     * Discover and cache capabilities from a connected server
+     */
+    async discoverCapabilities(serverName) {
+        const client = this.clients.get(serverName);
+        if (!client) {
+            throw new Error(`Not connected to server: ${serverName}`);
+        }
+        try {
+            // Discover tools
+            const toolsList = await client.listTools();
+            if (toolsList.tools) {
+                for (const tool of toolsList.tools) {
+                    const mcpTool = { ...tool, serverName };
+                    this.tools.set(`${serverName}::${tool.name}`, mcpTool);
+                }
+            }
+            // Discover resources
+            const resourcesList = await client.listResources();
+            if (resourcesList.resources) {
+                for (const resource of resourcesList.resources) {
+                    const mcpResource = { ...resource, serverName };
+                    this.resources.set(`${serverName}::${resource.uri}`, mcpResource);
+                }
+            }
+            // Discover prompts
+            const promptsList = await client.listPrompts();
+            if (promptsList.prompts) {
+                for (const prompt of promptsList.prompts) {
+                    const mcpPrompt = { ...prompt, serverName };
+                    this.prompts.set(`${serverName}::${prompt.name}`, mcpPrompt);
+                }
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to discover capabilities for ${serverName}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Get all available tools from all connected MCP servers
+     */
+    getAvailableTools() {
+        return Array.from(this.tools.values());
+    }
+    /**
+     * Get all available resources from all connected MCP servers
+     */
+    getAvailableResources() {
+        return Array.from(this.resources.values());
+    }
+    /**
+     * Get all available prompts from all connected MCP servers
+     */
+    getAvailablePrompts() {
+        return Array.from(this.prompts.values());
+    }
+    /**
+     * Execute a tool from an MCP server
+     */
+    async executeMCPTool(toolName, args) {
+        // Parse server name from toolName (format: "serverName::actualToolName")
+        const parts = toolName.split('::');
+        if (parts.length !== 2) {
+            throw new Error(`Invalid MCP tool name format: ${toolName}. Expected format: serverName::toolName`);
+        }
+        const [serverName, actualToolName] = parts;
+        const client = this.clients.get(serverName);
+        if (!client) {
+            throw new Error(`Not connected to MCP server: ${serverName}`);
+        }
+        const tool = this.tools.get(toolName);
+        if (!tool) {
+            throw new Error(`Tool not found: ${toolName}`);
+        }
+        try {
+            const result = await client.callTool({
+                name: actualToolName,
+                arguments: args,
+            });
+            return result;
+        }
+        catch (error) {
+            throw new Error(`Failed to execute MCP tool ${toolName}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Read a resource from an MCP server
+     */
+    async readResource(resourceUri) {
+        // Parse server name from resourceUri (format: "serverName::actualUri")
+        const parts = resourceUri.split('::');
+        if (parts.length !== 2) {
+            throw new Error(`Invalid MCP resource URI format: ${resourceUri}. Expected format: serverName::uri`);
+        }
+        const [serverName, actualUri] = parts;
+        const client = this.clients.get(serverName);
+        if (!client) {
+            throw new Error(`Not connected to MCP server: ${serverName}`);
+        }
+        const resource = this.resources.get(resourceUri);
+        if (!resource) {
+            throw new Error(`Resource not found: ${resourceUri}`);
+        }
+        try {
+            const result = await client.readResource({
+                uri: actualUri,
+            });
+            return result;
+        }
+        catch (error) {
+            throw new Error(`Failed to read MCP resource ${resourceUri}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Get a prompt from an MCP server
+     */
+    async getPrompt(promptName, args) {
+        // Parse server name from promptName (format: "serverName::actualPromptName")
+        const parts = promptName.split('::');
+        if (parts.length !== 2) {
+            throw new Error(`Invalid MCP prompt name format: ${promptName}. Expected format: serverName::promptName`);
+        }
+        const [serverName, actualPromptName] = parts;
+        const client = this.clients.get(serverName);
+        if (!client) {
+            throw new Error(`Not connected to MCP server: ${serverName}`);
+        }
+        const prompt = this.prompts.get(promptName);
+        if (!prompt) {
+            throw new Error(`Prompt not found: ${promptName}`);
+        }
+        try {
+            const result = await client.getPrompt({
+                name: actualPromptName,
+                arguments: args,
+            });
+            return result;
+        }
+        catch (error) {
+            throw new Error(`Failed to get MCP prompt ${promptName}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Get list of connected servers
+     */
+    getConnectedServers() {
+        return Array.from(this.clients.keys());
+    }
+    /**
+     * Check if connected to a specific server
+     */
+    isConnected(serverName) {
+        return this.clients.has(serverName);
+    }
+    /**
+     * Get server configuration
+     */
+    getServerConfig(serverName) {
+        return this.serverConfigs.get(serverName);
+    }
+}
+//# sourceMappingURL=mcp-client.js.map

package/dist/core/mcp-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.js","sourceRoot":"","sources":["../../src/core/mcp-client.ts"],"names":[],"mappings":"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"}

package/dist/core/modes.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Multi-mode architecture for XibeCode
+ * Defines different operating modes with specific capabilities and restrictions
+ */
+export type AgentMode = 'plan' | 'agent' | 'debugger' | 'security' | 'review';
+export type ToolCategory = 'read_only' | 'write_fs' | 'git_read' | 'git_mutation' | 'shell_command' | 'tests' | 'network' | 'context';
+export interface ModeCapabilities {
+    /** Human-readable mode name */
+    name: string;
+    /** Short description of the mode */
+    description: string;
+    /** Agent persona name (friendly name for this mode) */
+    personaName: string;
+    /** Agent persona role description */
+    personaRole: string;
+    /** Tool categories allowed in this mode */
+    allowedCategories: ToolCategory[];
+    /** Whether this mode can modify files */
+    canModify: boolean;
+    /** Whether dry-run is enabled by default */
+    defaultDryRun: boolean;
+    /** Color for TUI display (for chalk) */
+    displayColor: string;
+    /** Icon/emoji for TUI display */
+    icon: string;
+    /** Additional system prompt instructions for this mode */
+    promptSuffix: string;
+    /** Risk tolerance level for operations */
+    riskTolerance: 'low' | 'medium' | 'high';
+    /** Whether mode transitions require confirmation */
+    requiresConfirmation: boolean;
+}
+export declare const MODE_CONFIG: Record<AgentMode, ModeCapabilities>;
+export declare function isToolAllowed(mode: AgentMode, toolName: string): {
+    allowed: boolean;
+    reason?: string;
+};
+export declare function getAllowedTools(mode: AgentMode): string[];
+export declare function requiresModeTransitionConfirmation(fromMode: AgentMode, toMode: AgentMode): boolean;
+export declare function getModeTransitionMessage(fromMode: AgentMode, toMode: AgentMode): string;
+/**
+ * Mode state for tracking in agent session
+ */
+export interface ModeState {
+    current: AgentMode;
+    previous?: AgentMode;
+    history: Array<{
+        mode: AgentMode;
+        timestamp: number;
+        reason?: string;
+    }>;
+    transitionInProgress?: {
+        from: AgentMode;
+        to: AgentMode;
+        awaitingConfirmation: boolean;
+    };
+    pendingRequest?: ModeTransitionRequest;
+}
+/**
+ * Mode transition request
+ */
+export interface ModeTransitionRequest {
+    targetMode: AgentMode;
+    reason: string;
+    source: 'model' | 'user' | 'system';
+    timestamp: number;
+}
+/**
+ * Auto-approval policy for mode escalation
+ */
+export type AutoApprovalPolicy = 'never' | 'prompt-only' | 'always-for-debugger' | 'always';
+/**
+ * Mode transition policy configuration
+ */
+export interface ModeTransitionPolicy {
+    autoApprovalPolicy: AutoApprovalPolicy;
+    allowAutoEscalation: boolean;
+}
+export declare function createModeState(initialMode?: AgentMode): ModeState;
+export declare function transitionMode(state: ModeState, newMode: AgentMode, reason?: string): ModeState;
+/**
+ * Mode Orchestrator - manages mode transitions and policies
+ */
+export declare class ModeOrchestrator {
+    private policy;
+    constructor(policy?: ModeTransitionPolicy);
+    /**
+     * Request a mode change
+     */
+    requestModeChange(state: ModeState, targetMode: AgentMode, reason: string, source?: 'model' | 'user' | 'system'): ModeState;
+    /**
+     * Evaluate if a mode transition should be auto-approved
+     */
+    evaluateModeChangeRequest(state: ModeState): {
+        approved: boolean;
+        requiresConfirmation: boolean;
+        reason?: string;
+    };
+    /**
+     * Clear pending mode change request
+     */
+    clearPendingRequest(state: ModeState): ModeState;
+    /**
+     * Update policy
+     */
+    updatePolicy(policy: Partial<ModeTransitionPolicy>): void;
+    /**
+     * Get current policy
+     */
+    getPolicy(): ModeTransitionPolicy;
+}
+/**
+ * Parse mode request from text (looks for [[REQUEST_MODE: ...]] tags)
+ */
+export declare function parseModeRequest(text: string): {
+    mode: AgentMode;
+    reason: string;
+} | null;
+/**
+ * Strip mode request tags from text (for display)
+ */
+export declare function stripModeRequests(text: string): string;
+export declare function isValidMode(mode: string): mode is AgentMode;
+export declare function getAllModes(): AgentMode[];
+//# sourceMappingURL=modes.d.ts.map

package/dist/core/modes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modes.d.ts","sourceRoot":"","sources":["../../src/core/modes.ts"],"names":[],"mappings":"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"}