제22강: 커스텀 명령어와 확장 개발

Cursor Extension API

// cursor-extension-api.d.ts
declare module 'cursor-api' {
    export namespace cursor {
        // AI Chat API
        namespace chat {
            function sendMessage(message: string): Promise;
            function streamMessage(
                message: string, 
                onChunk: (chunk: string) => void
            ): Promise;
            function setContext(context: string[]): void;
            function clearContext(): void;
        }

        // AI 코드 생성 API
        namespace ai {
            function generateCode(
                prompt: string,
                options?: GenerateOptions
            ): Promise;
            
            function refactorCode(
                code: string,
                instructions: string
            ): Promise;
            
            function explainCode(
                code: string,
                language?: string
            ): Promise;
            
            function suggestFixes(
                code: string,
                error: string
            ): Promise;
        }

        // 컨텍스트 관리 API
        namespace context {
            function addFile(path: string): void;
            function removeFile(path: string): void;
            function setProjectContext(context: ProjectContext): void;
            function getActiveContext(): Context;
        }

        // 명령어 등록 API
        namespace commands {
            function registerCommand(
                command: string,
                callback: (...args: any[]) => any
            ): Disposable;
            
            function registerAICommand(
                command: string,
                handler: AICommandHandler
            ): Disposable;
        }
    }

    // 타입 정의
    interface GenerateOptions {
        language?: string;
        framework?: string;
        style?: 'functional' | 'oop' | 'procedural';
        includeTests?: boolean;
        includeComments?: boolean;
    }

    interface Fix {
        description: string;
        code: string;
        severity: 'error' | 'warning' | 'info';
    }

    interface AICommandHandler {
        prompt: (args: any[]) => string;
        processResponse?: (response: string) => any;
        validateInput?: (args: any[]) => boolean;
    }
}