gitx.do 0.0.1

package/dist/mcp/adapter.d.ts

@@ -0,0 +1,231 @@
+/**
+ * MCP (Model Context Protocol) SDK Adapter
+ *
+ * This module provides an adapter that bridges the MCP protocol to git operations,
+ * handling request/response, tool registration/invocation, resource listing,
+ * and error handling.
+ */
+import { type MCPToolResult } from './tools';
+/**
+ * JSON-RPC 2.0 error codes and MCP-specific error codes
+ */
+export declare enum MCPErrorCode {
+    PARSE_ERROR = -32700,
+    INVALID_REQUEST = -32600,
+    METHOD_NOT_FOUND = -32601,
+    INVALID_PARAMS = -32602,
+    INTERNAL_ERROR = -32603,
+    RESOURCE_NOT_FOUND = -32001,
+    TOOL_NOT_FOUND = -32601,
+    PROMPT_NOT_FOUND = -32003,
+    CAPABILITY_NOT_SUPPORTED = -32004
+}
+/**
+ * Custom error class for MCP errors
+ */
+export declare class MCPError extends Error {
+    code: MCPErrorCode;
+    data?: unknown;
+    constructor(code: MCPErrorCode, message: string, data?: unknown);
+    toJSON(): {
+        code: MCPErrorCode;
+        message: string;
+        data?: unknown;
+    };
+}
+/**
+ * MCP capability types
+ */
+export type MCPCapability = 'tools' | 'resources' | 'prompts';
+/**
+ * Server configuration for MCP adapter
+ */
+export interface MCPServerConfig {
+    name?: string;
+    version?: string;
+    capabilities?: MCPCapability[];
+}
+/**
+ * MCP request structure (JSON-RPC 2.0)
+ */
+export interface MCPRequest {
+    jsonrpc: '2.0';
+    id?: string | number;
+    method: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * MCP response structure (JSON-RPC 2.0)
+ */
+export interface MCPResponse {
+    jsonrpc: '2.0';
+    id?: string | number;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/**
+ * Tool information for registration
+ */
+export interface MCPToolInfo {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties?: Record<string, unknown>;
+        required?: string[];
+    };
+    handler: (params: Record<string, unknown>) => Promise<MCPToolResult>;
+}
+/**
+ * Resource information for registration
+ */
+export interface MCPResourceInfo {
+    uri: string;
+    name: string;
+    mimeType?: string;
+    description?: string;
+    handler?: () => Promise<{
+        content: string;
+    }>;
+}
+/**
+ * Prompt argument definition
+ */
+export interface MCPPromptArgument {
+    name: string;
+    description?: string;
+    required?: boolean;
+}
+/**
+ * Prompt information for registration
+ */
+export interface MCPPromptInfo {
+    name: string;
+    description?: string;
+    arguments?: MCPPromptArgument[];
+    handler?: (args: Record<string, unknown>) => Promise<{
+        messages: Array<{
+            role: string;
+            content: {
+                type: string;
+                text: string;
+            };
+        }>;
+    }>;
+}
+/**
+ * MCP Adapter class that bridges MCP protocol to git operations
+ */
+export declare class MCPAdapter {
+    private config;
+    private initialized;
+    private tools;
+    private resources;
+    private prompts;
+    constructor(config?: MCPServerConfig);
+    /**
+     * Get the server configuration
+     */
+    getConfig(): MCPServerConfig;
+    /**
+     * Check if adapter has a specific capability
+     */
+    hasCapability(capability: MCPCapability): boolean;
+    /**
+     * Check if the adapter is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Start the MCP adapter
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the MCP adapter
+     */
+    stop(): Promise<void>;
+    /**
+     * Register a tool
+     */
+    registerTool(toolInfo: MCPToolInfo): void;
+    /**
+     * Unregister a tool by name
+     */
+    unregisterTool(name: string): void;
+    /**
+     * List all registered tools (without handlers)
+     */
+    listTools(): Array<Omit<MCPToolInfo, 'handler'>>;
+    /**
+     * Get a tool by name (without handler)
+     */
+    getTool(name: string): Omit<MCPToolInfo, 'handler'> | undefined;
+    /**
+     * Register all git tools
+     */
+    registerGitTools(): void;
+    /**
+     * Register a resource
+     */
+    registerResource(resourceInfo: MCPResourceInfo): void;
+    /**
+     * Register a prompt
+     */
+    registerPrompt(promptInfo: MCPPromptInfo): void;
+    /**
+     * Handle a raw JSON string request
+     */
+    handleRawRequest(rawRequest: string): Promise<MCPResponse>;
+    /**
+     * Handle a batch of requests
+     */
+    handleBatchRequest(requests: MCPRequest[]): Promise<MCPResponse[]>;
+    /**
+     * Handle a single MCP request
+     */
+    handleRequest(request: MCPRequest): Promise<MCPResponse | undefined>;
+    /**
+     * Handle initialize request
+     */
+    private handleInitialize;
+    /**
+     * Handle tools/list request
+     */
+    private handleToolsList;
+    /**
+     * Handle tools/call request
+     */
+    private handleToolsCall;
+    /**
+     * Validate tool parameters against schema
+     */
+    private validateToolParams;
+    /**
+     * Handle resources/list request
+     */
+    private handleResourcesList;
+    /**
+     * Handle resources/read request
+     */
+    private handleResourcesRead;
+    /**
+     * Handle prompts/list request
+     */
+    private handlePromptsList;
+    /**
+     * Handle prompts/get request
+     */
+    private handlePromptsGet;
+    /**
+     * Create an error response
+     */
+    private errorResponse;
+}
+/**
+ * Factory function to create an MCP adapter
+ */
+export declare function createMCPAdapter(config?: MCPServerConfig): MCPAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/mcp/adapter.d.ts.map

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