codehere 0.1.0 → 0.2.0

package/dist/infrastructure/protocols/mcp-server.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Infrastructure: Model Context Protocol (MCP) Server
+ * Exposes Codehere as an MCP-compatible server
+ * Enables integration with other MCP clients and agents
+ *
+ * Based on research: MCP Architecture and OAuth 2.1 security
+ * - Transport-agnostic (HTTP, gRPC, WebSocket)
+ * - Stateless design for cloud-native ecosystems
+ * - OAuth 2.1 with Dynamic Client Registration
+ * - One-to-one Client-Server relationship (architectural decoupling)
+ *
+ * MCP Specification: https://modelcontextprotocol.io
+ * Research: See docs/NOTEBOOKLM_RESEARCH_PROMPTS.md - Prompt #5
+ */
+export interface MCPServer {
+    /**
+     * Get server capabilities
+     */
+    getCapabilities(): MCPCapabilities;
+    /**
+     * List available tools
+     */
+    listTools(): MCPTool[];
+    /**
+     * Call a tool
+     */
+    callTool(name: string, args: Record<string, any>): Promise<MCPToolResult>;
+    /**
+     * List available resources
+     */
+    listResources(): MCPResource[];
+    /**
+     * Read a resource
+     */
+    readResource(uri: string): Promise<MCPResourceContent>;
+    /**
+     * List available prompts
+     */
+    listPrompts(): MCPPrompt[];
+    /**
+     * Get prompt
+     */
+    getPrompt(name: string, args?: Record<string, any>): Promise<MCPPromptResult>;
+}
+export interface MCPCapabilities {
+    tools?: {
+        listChanged?: boolean;
+    };
+    resources?: {
+        subscribe?: boolean;
+        listChanged?: boolean;
+    };
+    prompts?: {
+        listChanged?: boolean;
+    };
+    sampling?: {};
+}
+export interface MCPTool {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: Record<string, any>;
+        required?: string[];
+    };
+}
+export interface MCPToolResult {
+    content: Array<{
+        type: 'text' | 'image' | 'resource';
+        text?: string;
+        data?: string;
+        mimeType?: string;
+        uri?: string;
+    }>;
+    isError?: boolean;
+}
+export interface MCPResource {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+}
+export interface MCPResourceContent {
+    uri: string;
+    mimeType: string;
+    text?: string;
+    blob?: string;
+}
+export interface MCPPrompt {
+    name: string;
+    description?: string;
+    arguments?: Array<{
+        name: string;
+        description?: string;
+        required?: boolean;
+    }>;
+}
+export interface MCPPromptResult {
+    messages: Array<{
+        role: 'user' | 'assistant';
+        content: {
+            type: 'text';
+            text: string;
+        };
+    }>;
+}
+/**
+ * Codehere MCP Server Implementation
+ */
+export declare class CodehereMCPServer implements MCPServer {
+    private container;
+    constructor(container: any);
+    getCapabilities(): MCPCapabilities;
+    listTools(): MCPTool[];
+    callTool(name: string, args: Record<string, any>): Promise<MCPToolResult>;
+    listResources(): MCPResource[];
+    readResource(uri: string): Promise<MCPResourceContent>;
+    listPrompts(): MCPPrompt[];
+    getPrompt(name: string, promptArgs?: Record<string, any>): Promise<MCPPromptResult>;
+    private handleAsk;
+    private handleExplain;
+    private handleEdit;
+    private handleSearch;
+    private handleMemoryQuery;
+}
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/infrastructure/protocols/mcp-server.d.ts.map

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

package/dist/infrastructure/protocols/mcp-server.js

@@ -0,0 +1,333 @@
+/**
+ * Infrastructure: Model Context Protocol (MCP) Server
+ * Exposes Codehere as an MCP-compatible server
+ * Enables integration with other MCP clients and agents
+ *
+ * Based on research: MCP Architecture and OAuth 2.1 security
+ * - Transport-agnostic (HTTP, gRPC, WebSocket)
+ * - Stateless design for cloud-native ecosystems
+ * - OAuth 2.1 with Dynamic Client Registration
+ * - One-to-one Client-Server relationship (architectural decoupling)
+ *
+ * MCP Specification: https://modelcontextprotocol.io
+ * Research: See docs/NOTEBOOKLM_RESEARCH_PROMPTS.md - Prompt #5
+ */
+/**
+ * Codehere MCP Server Implementation
+ */
+export class CodehereMCPServer {
+    container;
+    constructor(container // Dependency container
+    ) {
+        this.container = container;
+    }
+    getCapabilities() {
+        return {
+            tools: {
+                listChanged: true,
+            },
+            resources: {
+                listChanged: true,
+            },
+            prompts: {
+                listChanged: true,
+            },
+        };
+    }
+    listTools() {
+        return [
+            {
+                name: 'codehere_ask',
+                description: 'Ask questions about codebase using semantic search',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        query: {
+                            type: 'string',
+                            description: 'The question to ask about the codebase',
+                        },
+                        maxResults: {
+                            type: 'number',
+                            description: 'Maximum number of code chunks to retrieve',
+                            default: 15,
+                        },
+                    },
+                    required: ['query'],
+                },
+            },
+            {
+                name: 'codehere_explain',
+                description: 'Get detailed explanation of a code file',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        filepath: {
+                            type: 'string',
+                            description: 'Path to the file to explain',
+                        },
+                    },
+                    required: ['filepath'],
+                },
+            },
+            {
+                name: 'codehere_edit',
+                description: 'Edit a file with AI-generated changes',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        filepath: {
+                            type: 'string',
+                            description: 'Path to the file to edit',
+                        },
+                        instruction: {
+                            type: 'string',
+                            description: 'Natural language instruction for the edit',
+                        },
+                    },
+                    required: ['filepath', 'instruction'],
+                },
+            },
+            {
+                name: 'codehere_search',
+                description: 'Search codebase using semantic search',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        query: {
+                            type: 'string',
+                            description: 'Search query',
+                        },
+                        maxResults: {
+                            type: 'number',
+                            description: 'Maximum number of results',
+                            default: 10,
+                        },
+                    },
+                    required: ['query'],
+                },
+            },
+            {
+                name: 'codehere_memory_query',
+                description: 'Query persistent episodic memory',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        query: {
+                            type: 'string',
+                            description: 'Memory query',
+                        },
+                        limit: {
+                            type: 'number',
+                            description: 'Maximum number of memories to retrieve',
+                            default: 10,
+                        },
+                    },
+                    required: ['query'],
+                },
+            },
+        ];
+    }
+    async callTool(name, args) {
+        try {
+            switch (name) {
+                case 'codehere_ask':
+                    return await this.handleAsk(args);
+                case 'codehere_explain':
+                    return await this.handleExplain(args);
+                case 'codehere_edit':
+                    return await this.handleEdit(args);
+                case 'codehere_search':
+                    return await this.handleSearch(args);
+                case 'codehere_memory_query':
+                    return await this.handleMemoryQuery(args);
+                default:
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Unknown tool: ${name}`,
+                            },
+                        ],
+                        isError: true,
+                    };
+            }
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    listResources() {
+        return [
+            {
+                uri: 'codehere://codebase',
+                name: 'Codebase',
+                description: 'The entire codebase',
+                mimeType: 'application/json',
+            },
+            {
+                uri: 'codehere://memory',
+                name: 'Memory',
+                description: 'Persistent episodic memory',
+                mimeType: 'application/json',
+            },
+        ];
+    }
+    async readResource(uri) {
+        if (uri === 'codehere://codebase') {
+            // Return codebase metadata
+            return {
+                uri,
+                mimeType: 'application/json',
+                text: JSON.stringify({
+                    description: 'Codehere codebase',
+                    capabilities: ['ask', 'explain', 'edit', 'search', 'memory'],
+                }, null, 2),
+            };
+        }
+        if (uri === 'codehere://memory') {
+            // Return memory statistics
+            const memoryStream = this.container.memoryStreamService;
+            const stats = await memoryStream.getStatistics?.() || {};
+            return {
+                uri,
+                mimeType: 'application/json',
+                text: JSON.stringify(stats, null, 2),
+            };
+        }
+        throw new Error(`Unknown resource: ${uri}`);
+    }
+    listPrompts() {
+        return [
+            {
+                name: 'codehere_analyze',
+                description: 'Analyze codebase structure and patterns',
+                arguments: [
+                    {
+                        name: 'focus',
+                        description: 'What to analyze (architecture, patterns, dependencies, etc.)',
+                        required: false,
+                    },
+                ],
+            },
+        ];
+    }
+    async getPrompt(name, promptArgs) {
+        if (name === 'codehere_analyze') {
+            const focus = promptArgs?.focus || 'general';
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `Analyze the codebase focusing on: ${focus}. Provide insights about architecture, patterns, and dependencies.`,
+                        },
+                    },
+                ],
+            };
+        }
+        throw new Error(`Unknown prompt: ${name}`);
+    }
+    async handleAsk(args) {
+        const useCase = this.container.askQuestionUseCase;
+        const result = await useCase.execute({
+            query: args.query,
+            maxResults: args.maxResults || 15,
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: result.answer,
+                },
+            ],
+        };
+    }
+    async handleExplain(args) {
+        const useCase = this.container.explainFileUseCase;
+        const result = await useCase.execute({
+            filepath: args.filepath,
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: result.explanation,
+                },
+            ],
+        };
+    }
+    async handleEdit(args) {
+        const useCase = this.container.editFileUseCase;
+        const result = await useCase.execute({
+            filepath: args.filepath,
+            instruction: args.instruction,
+        });
+        if (!result.success) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Edit failed: ${result.error}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Edit applied successfully',
+                },
+            ],
+        };
+    }
+    async handleSearch(args) {
+        const useCase = this.container.askQuestionUseCase;
+        const result = await useCase.execute({
+            query: args.query,
+            maxResults: args.maxResults || 10,
+        });
+        const chunks = result.chunks.map((chunk) => ({
+            filepath: chunk.filepath,
+            content: chunk.content.substring(0, 200),
+            score: chunk.score,
+        }));
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(chunks, null, 2),
+                },
+            ],
+        };
+    }
+    async handleMemoryQuery(args) {
+        const memoryStream = this.container.memoryStreamService;
+        const memories = await memoryStream.retrieve(args.query, args.limit || 10);
+        const memoryData = memories.map((m) => ({
+            type: m.type,
+            description: m.description,
+            timestamp: m.timestamp,
+            importance: m.importance,
+        }));
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(memoryData, null, 2),
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/infrastructure/protocols/mcp-server.js.map

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

package/dist/infrastructure/protocols/streaming-handler.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Infrastructure: Streaming Handler
+ * Provides streaming interface for real-time responses
+ * Target: < 200ms perceived latency
+ */
+export interface StreamChunk {
+    type: 'token' | 'progress' | 'complete' | 'error';
+    data: string | any;
+    metadata?: Record<string, any>;
+}
+export interface StreamingHandler {
+    /**
+     * Handle streaming token (word/sentence chunk)
+     */
+    onToken(token: string): void;
+    /**
+     * Handle progress update
+     */
+    onProgress(phase: string, message: string): void;
+    /**
+     * Handle completion
+     */
+    onComplete(data: any): void;
+    /**
+     * Handle error
+     */
+    onError(error: Error): void;
+}
+/**
+ * Enhanced streaming handler with buffering and batching
+ * Optimizes for < 200ms perceived latency
+ */
+export declare class OptimizedStreamingHandler implements StreamingHandler {
+    private output;
+    private buffer;
+    private flushInterval;
+    private readonly FLUSH_INTERVAL_MS;
+    private readonly MAX_BUFFER_SIZE;
+    constructor(output?: (text: string) => void);
+    onToken(token: string): void;
+    onProgress(phase: string, message: string): void;
+    onComplete(data: any): void;
+    onError(error: Error): void;
+    /**
+     * Flush buffered tokens
+     */
+    private flush;
+}
+/**
+ * Create streaming handler for CLI
+ */
+export declare function createCLIStreamingHandler(): StreamingHandler;
+/**
+ * Create streaming handler for API
+ */
+export declare function createAPIStreamingHandler(res: any): StreamingHandler;
+//# sourceMappingURL=streaming-handler.d.ts.map

package/dist/infrastructure/protocols/streaming-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-handler.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/protocols/streaming-handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;IAClD,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjD;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC7B;AAED;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,gBAAgB;IAO9D,OAAO,CAAC,MAAM;IANhB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAM;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAO;gBAG7B,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAA2C;IAG/E,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAiB5B,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAchD,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAS3B,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAU3B;;OAEG;IACH,OAAO,CAAC,KAAK;CAOd;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,gBAAgB,CAI5D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,GAAG,GAAG,gBAAgB,CAiBpE"}

package/dist/infrastructure/protocols/streaming-handler.js

@@ -0,0 +1,103 @@
+/**
+ * Infrastructure: Streaming Handler
+ * Provides streaming interface for real-time responses
+ * Target: < 200ms perceived latency
+ */
+/**
+ * Enhanced streaming handler with buffering and batching
+ * Optimizes for < 200ms perceived latency
+ */
+export class OptimizedStreamingHandler {
+    output;
+    buffer = [];
+    flushInterval = null;
+    FLUSH_INTERVAL_MS = 50; // Flush every 50ms for better UX
+    MAX_BUFFER_SIZE = 100; // Max tokens before forced flush
+    constructor(output = (text) => process.stdout.write(text)) {
+        this.output = output;
+    }
+    onToken(token) {
+        this.buffer.push(token);
+        // Force flush if buffer is too large
+        if (this.buffer.length >= this.MAX_BUFFER_SIZE) {
+            this.flush();
+        }
+        else {
+            // Schedule flush if not already scheduled
+            if (!this.flushInterval) {
+                this.flushInterval = setTimeout(() => {
+                    this.flush();
+                    this.flushInterval = null;
+                }, this.FLUSH_INTERVAL_MS);
+            }
+        }
+    }
+    onProgress(phase, message) {
+        // Clear any pending flushes
+        if (this.flushInterval) {
+            clearTimeout(this.flushInterval);
+            this.flushInterval = null;
+        }
+        // Flush buffer before progress update
+        this.flush();
+        // Output progress (can be formatted differently)
+        this.output(`\n[${phase}] ${message}\n`);
+    }
+    onComplete(data) {
+        // Final flush
+        if (this.flushInterval) {
+            clearTimeout(this.flushInterval);
+            this.flushInterval = null;
+        }
+        this.flush();
+    }
+    onError(error) {
+        // Clear buffer and output error
+        if (this.flushInterval) {
+            clearTimeout(this.flushInterval);
+            this.flushInterval = null;
+        }
+        this.flush();
+        this.output(`\nError: ${error.message}\n`);
+    }
+    /**
+     * Flush buffered tokens
+     */
+    flush() {
+        if (this.buffer.length > 0) {
+            const text = this.buffer.join('');
+            this.output(text);
+            this.buffer = [];
+        }
+    }
+}
+/**
+ * Create streaming handler for CLI
+ */
+export function createCLIStreamingHandler() {
+    return new OptimizedStreamingHandler((text) => {
+        process.stdout.write(text);
+    });
+}
+/**
+ * Create streaming handler for API
+ */
+export function createAPIStreamingHandler(res) {
+    return {
+        onToken: (token) => {
+            res.write(`data: ${JSON.stringify({ type: 'token', data: token })}\n\n`);
+        },
+        onProgress: (phase, message) => {
+            res.write(`data: ${JSON.stringify({ type: 'progress', phase, message })}\n\n`);
+        },
+        onComplete: (data) => {
+            res.write(`data: ${JSON.stringify({ type: 'complete', data })}\n\n`);
+            res.end();
+        },
+        onError: (error) => {
+            res.write(`data: ${JSON.stringify({ type: 'error', error: error.message })}\n\n`);
+            res.end();
+        },
+    };
+}
+//# sourceMappingURL=streaming-handler.js.map

package/dist/infrastructure/protocols/streaming-handler.js.map

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