snow-ai 0.3.6 → 0.3.8

package/dist/mcp/ideDiagnostics.js

@@ -44,9 +44,7 @@ export class IdeDiagnosticsMCPService {
         // Add summary
         const counts = [
             grouped.error.length > 0 ? `${grouped.error.length} errors` : null,
-            grouped.warning.length > 0
-                ? `${grouped.warning.length} warnings`
-                : null,
+            grouped.warning.length > 0 ? `${grouped.warning.length} warnings` : null,
             grouped.info.length > 0 ? `${grouped.info.length} info` : null,
             grouped.hint.length > 0 ? `${grouped.hint.length} hints` : null,
         ].filter(Boolean);
@@ -76,7 +74,7 @@ export const ideDiagnosticsService = new IdeDiagnosticsMCPService();
 // Export MCP tool definitions
 export const mcpTools = [
     {
-        name: 'ide_get_diagnostics',
+        name: 'ide-get_diagnostics',
         description: '🔍 Get diagnostics (errors, warnings, hints) for a specific file from the connected IDE. Works with both VSCode and JetBrains IDEs. Returns array of diagnostic information including severity, line number, character position, message, and source. Requires IDE plugin to be installed and running.',
         inputSchema: {
             type: 'object',

package/dist/mcp/todo.d.ts

@@ -1,19 +1,5 @@
 import { Tool, type CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-interface TodoItem {
-    id: string;
-    content: string;
-    status: 'pending' | 'completed';
-    createdAt: string;
-    updatedAt: string;
-    parentId?: string;
-}
-interface TodoList {
-    sessionId: string;
-    todos: TodoItem[];
-    createdAt: string;
-    updatedAt: string;
-}
-type GetCurrentSessionId = () => string | null;
+import type { TodoItem, TodoList, GetCurrentSessionId } from './types/todo.types.js';
 /**
  * TODO 管理服务 - 支持创建、查询、更新 TODO
  */
@@ -23,7 +9,6 @@ export declare class TodoService {
     constructor(baseDir: string, getCurrentSessionId: GetCurrentSessionId);
     initialize(): Promise<void>;
     private getTodoPath;
-    private formatDateForFolder;
     private ensureTodoDir;
     /**
      * 创建或更新会话的 TODO List
@@ -59,4 +44,3 @@ export declare class TodoService {
      */
     executeTool(toolName: string, args: Record<string, unknown>): Promise<CallToolResult>;
 }
-export {};

package/dist/mcp/todo.js

@@ -1,5 +1,7 @@
 import fs from 'fs/promises';
 import path from 'path';
+// Utility functions
+import { formatDateForFolder } from './utils/todo/date.utils.js';
 /**
  * TODO 管理服务 - 支持创建、查询、更新 TODO
  */
@@ -25,21 +27,15 @@ export class TodoService {
     }
     getTodoPath(sessionId, date) {
         const sessionDate = date || new Date();
-        const dateFolder = this.formatDateForFolder(sessionDate);
+        const dateFolder = formatDateForFolder(sessionDate);
         const todoDir = path.join(this.todoDir, dateFolder);
         return path.join(todoDir, `${sessionId}.json`);
     }
-    formatDateForFolder(date) {
-        const year = date.getFullYear();
-        const month = String(date.getMonth() + 1).padStart(2, '0');
-        const day = String(date.getDate()).padStart(2, '0');
-        return `${year}-${month}-${day}`;
-    }
     async ensureTodoDir(date) {
         try {
             await fs.mkdir(this.todoDir, { recursive: true });
             if (date) {
-                const dateFolder = this.formatDateForFolder(date);
+                const dateFolder = formatDateForFolder(date);
                 const todoDir = path.join(this.todoDir, dateFolder);
                 await fs.mkdir(todoDir, { recursive: true });
             }
@@ -151,7 +147,7 @@ export class TodoService {
         const todoList = await this.getTodoList(sessionId);
         const now = new Date().toISOString();
         const newTodo = {
-            id: `todo_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`,
+            id: `todo-${Date.now()}_${Math.random().toString(36).slice(2, 9)}`,
             content,
             status: 'pending',
             createdAt: now,
@@ -420,12 +416,12 @@ Deleting a parent task automatically deletes all its subtasks (parentId relation
         }
         try {
             switch (toolName) {
-                case 'todo-create': {
+                case 'create': {
                     const { todos } = args;
                     const todoItems = todos.map(t => {
                         const now = new Date().toISOString();
                         return {
-                            id: `todo_${Date.now()}_${Math.random()
+                            id: `todo-${Date.now()}_${Math.random()
                                 .toString(36)
                                 .slice(2, 9)}`,
                             content: t.content,
@@ -446,7 +442,7 @@ Deleting a parent task automatically deletes all its subtasks (parentId relation
                         ],
                     };
                 }
-                case 'todo-get': {
+                case 'get': {
                     const result = await this.getTodoList(sessionId);
                     return {
                         content: [
@@ -459,7 +455,7 @@ Deleting a parent task automatically deletes all its subtasks (parentId relation
                         ],
                     };
                 }
-                case 'todo-update': {
+                case 'update': {
                     const { todoId, status, content } = args;
                     const updates = {};
                     if (status)
@@ -478,7 +474,7 @@ Deleting a parent task automatically deletes all its subtasks (parentId relation
                         ],
                     };
                 }
-                case 'todo-add': {
+                case 'add': {
                     const { content, parentId } = args;
                     const result = await this.addTodoItem(sessionId, content, parentId);
                     return {
@@ -490,7 +486,7 @@ Deleting a parent task automatically deletes all its subtasks (parentId relation
                         ],
                     };
                 }
-                case 'todo-delete': {
+                case 'delete': {
                     const { todoId } = args;
                     const result = await this.deleteTodoItem(sessionId, todoId);
                     return {

package/dist/mcp/types/aceCodeSearch.types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Type definitions for ACE Code Search Service
+ */
+/**
+ * Code symbol types
+ */
+export type SymbolType = 'function' | 'class' | 'method' | 'variable' | 'constant' | 'interface' | 'type' | 'enum' | 'import' | 'export';
+/**
+ * Code symbol information
+ */
+export interface CodeSymbol {
+    name: string;
+    type: SymbolType;
+    filePath: string;
+    line: number;
+    column: number;
+    endLine?: number;
+    endColumn?: number;
+    signature?: string;
+    scope?: string;
+    language: string;
+    context?: string;
+}
+/**
+ * Code reference types
+ */
+export type ReferenceType = 'definition' | 'usage' | 'import' | 'type';
+/**
+ * Code reference information
+ */
+export interface CodeReference {
+    symbol: string;
+    filePath: string;
+    line: number;
+    column: number;
+    context: string;
+    referenceType: ReferenceType;
+}
+/**
+ * Semantic search result
+ */
+export interface SemanticSearchResult {
+    query: string;
+    symbols: CodeSymbol[];
+    references: CodeReference[];
+    totalResults: number;
+    searchTime: number;
+}
+/**
+ * AST node structure
+ */
+export interface ASTNode {
+    type: string;
+    name?: string;
+    line: number;
+    column: number;
+    endLine?: number;
+    endColumn?: number;
+    children?: ASTNode[];
+}
+/**
+ * Text search result
+ */
+export interface TextSearchResult {
+    filePath: string;
+    line: number;
+    column: number;
+    content: string;
+}
+/**
+ * Language configuration
+ */
+export interface LanguageConfig {
+    extensions: string[];
+    parser: string;
+    symbolPatterns: {
+        function: RegExp;
+        class: RegExp;
+        variable?: RegExp;
+        import?: RegExp;
+        export?: RegExp;
+    };
+}
+/**
+ * Index statistics
+ */
+export interface IndexStats {
+    totalFiles: number;
+    totalSymbols: number;
+    languageBreakdown: Record<string, number>;
+    cacheAge: number;
+}

package/dist/mcp/types/aceCodeSearch.types.js

@@ -0,0 +1,4 @@
+/**
+ * Type definitions for ACE Code Search Service
+ */
+export {};

package/dist/mcp/types/bash.types.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Type definitions for Terminal Command Service
+ */
+/**
+ * Result of command execution
+ */
+export interface CommandExecutionResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    command: string;
+    executedAt: string;
+}

package/dist/mcp/types/bash.types.js

@@ -0,0 +1,4 @@
+/**
+ * Type definitions for Terminal Command Service
+ */
+export {};

package/dist/mcp/types/filesystem.types.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Type definitions for Filesystem MCP Service
+ */
+import type { Diagnostic } from '../../utils/vscodeConnection.js';
+/**
+ * Structure analysis result for code validation
+ */
+export interface StructureAnalysis {
+    bracketBalance: {
+        curly: {
+            open: number;
+            close: number;
+            balanced: boolean;
+        };
+        round: {
+            open: number;
+            close: number;
+            balanced: boolean;
+        };
+        square: {
+            open: number;
+            close: number;
+            balanced: boolean;
+        };
+    };
+    htmlTags?: {
+        unclosedTags: string[];
+        unopenedTags: string[];
+        balanced: boolean;
+    };
+    indentationWarnings: string[];
+    codeBlockBoundary?: {
+        isInCompleteBlock: boolean;
+        suggestion?: string;
+    };
+}
+/**
+ * Match candidate for fuzzy search
+ */
+export interface MatchCandidate {
+    startLine: number;
+    endLine: number;
+    similarity: number;
+    preview: string;
+}
+/**
+ * File read configuration
+ */
+export interface FileReadConfig {
+    path: string;
+    startLine?: number;
+    endLine?: number;
+}
+/**
+ * Edit by search configuration
+ */
+export interface EditBySearchConfig {
+    path: string;
+    searchContent: string;
+    replaceContent: string;
+    occurrence?: number;
+}
+/**
+ * Edit by line range configuration
+ */
+export interface EditByLineConfig {
+    path: string;
+    startLine: number;
+    endLine: number;
+    newContent: string;
+}
+/**
+ * Single file edit result (common fields)
+ */
+export interface SingleFileEditResult {
+    message: string;
+    oldContent: string;
+    newContent: string;
+    contextStartLine: number;
+    contextEndLine: number;
+    totalLines: number;
+    structureAnalysis?: StructureAnalysis;
+    diagnostics?: Diagnostic[];
+}
+/**
+ * Edit by search single file result
+ */
+export interface EditBySearchSingleResult extends SingleFileEditResult {
+    replacedContent: string;
+    matchLocation: {
+        startLine: number;
+        endLine: number;
+    };
+}
+/**
+ * Edit by line single file result
+ */
+export interface EditByLineSingleResult extends SingleFileEditResult {
+    replacedLines: string;
+    linesModified: number;
+}
+/**
+ * Batch operation result item (generic)
+ */
+export interface BatchResultItem {
+    path: string;
+    success: boolean;
+    error?: string;
+}
+/**
+ * Edit by search batch result item
+ */
+export type EditBySearchBatchResultItem = BatchResultItem & Partial<EditBySearchSingleResult>;
+/**
+ * Edit by line batch result item
+ */
+export type EditByLineBatchResultItem = BatchResultItem & Partial<EditByLineSingleResult>;
+/**
+ * Batch operation result (generic)
+ */
+export interface BatchOperationResult<T extends BatchResultItem> {
+    message: string;
+    results: T[];
+    totalFiles: number;
+    successCount: number;
+    failureCount: number;
+}
+/**
+ * Edit by search return type
+ */
+export type EditBySearchResult = EditBySearchSingleResult | BatchOperationResult<EditBySearchBatchResultItem>;
+/**
+ * Edit by line return type
+ */
+export type EditByLineResult = EditByLineSingleResult | BatchOperationResult<EditByLineBatchResultItem>;

package/dist/mcp/types/filesystem.types.js

@@ -0,0 +1,4 @@
+/**
+ * Type definitions for Filesystem MCP Service
+ */
+export {};

package/dist/mcp/types/todo.types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Type definitions for TODO Service
+ */
+/**
+ * TODO item
+ */
+export interface TodoItem {
+    id: string;
+    content: string;
+    status: 'pending' | 'completed';
+    createdAt: string;
+    updatedAt: string;
+    parentId?: string;
+}
+/**
+ * TODO list for a session
+ */
+export interface TodoList {
+    sessionId: string;
+    todos: TodoItem[];
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Callback function type for getting current session ID
+ */
+export type GetCurrentSessionId = () => string | null;

package/dist/mcp/types/todo.types.js

@@ -0,0 +1,4 @@
+/**
+ * Type definitions for TODO Service
+ */
+export {};

package/dist/mcp/types/websearch.types.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Type definitions for Web Search Service
+ */
+/**
+ * Search result item
+ */
+export interface SearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+    displayUrl: string;
+}
+/**
+ * Search response
+ */
+export interface SearchResponse {
+    query: string;
+    results: SearchResult[];
+    totalResults: number;
+}
+/**
+ * Web page content
+ */
+export interface WebPageContent {
+    url: string;
+    title: string;
+    content: string;
+    textLength: number;
+    contentPreview: string;
+}

package/dist/mcp/types/websearch.types.js

@@ -0,0 +1,4 @@
+/**
+ * Type definitions for Web Search Service
+ */
+export {};

package/dist/mcp/utils/aceCodeSearch/filesystem.utils.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Filesystem utilities for ACE Code Search
+ */
+/**
+ * Default exclusion directories
+ */
+export declare const DEFAULT_EXCLUDES: string[];
+/**
+ * Check if a directory should be excluded based on exclusion patterns
+ * @param dirName - Directory name
+ * @param fullPath - Full path to directory
+ * @param basePath - Base path for relative path calculation
+ * @param customExcludes - Custom exclusion patterns
+ * @param regexCache - Cache for compiled regex patterns
+ * @returns True if directory should be excluded
+ */
+export declare function shouldExcludeDirectory(dirName: string, fullPath: string, basePath: string, customExcludes: string[], regexCache: Map<string, RegExp>): boolean;
+/**
+ * Load custom exclusion patterns from .gitignore and .snowignore
+ * @param basePath - Base path to search for ignore files
+ * @returns Array of exclusion patterns
+ */
+export declare function loadExclusionPatterns(basePath: string): Promise<string[]>;
+/**
+ * Read file with LRU cache to reduce repeated file system access
+ * @param filePath - Path to file
+ * @param fileContentCache - Cache for file contents
+ * @param maxCacheSize - Maximum cache size
+ * @returns File content
+ */
+export declare function readFileWithCache(filePath: string, fileContentCache: Map<string, {
+    content: string;
+    mtime: number;
+}>, maxCacheSize?: number): Promise<string>;

package/dist/mcp/utils/aceCodeSearch/filesystem.utils.js

@@ -0,0 +1,146 @@
+/**
+ * Filesystem utilities for ACE Code Search
+ */
+import { promises as fs } from 'fs';
+import * as path from 'path';
+/**
+ * Default exclusion directories
+ */
+export const DEFAULT_EXCLUDES = [
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    '__pycache__',
+    'target',
+    '.next',
+    '.nuxt',
+    'coverage',
+    'out',
+    '.cache',
+    'vendor',
+];
+/**
+ * Check if a directory should be excluded based on exclusion patterns
+ * @param dirName - Directory name
+ * @param fullPath - Full path to directory
+ * @param basePath - Base path for relative path calculation
+ * @param customExcludes - Custom exclusion patterns
+ * @param regexCache - Cache for compiled regex patterns
+ * @returns True if directory should be excluded
+ */
+export function shouldExcludeDirectory(dirName, fullPath, basePath, customExcludes, regexCache) {
+    // Check default excludes
+    if (DEFAULT_EXCLUDES.includes(dirName)) {
+        return true;
+    }
+    // Check hidden directories
+    if (dirName.startsWith('.')) {
+        return true;
+    }
+    // Check custom exclusion patterns
+    const relativePath = path.relative(basePath, fullPath);
+    for (const pattern of customExcludes) {
+        // Simple pattern matching: exact match or glob-style wildcards
+        if (pattern.includes('*')) {
+            // Use cached regex to avoid recompilation
+            let regex = regexCache.get(pattern);
+            if (!regex) {
+                const regexPattern = pattern
+                    .replace(/\./g, '\\.')
+                    .replace(/\*/g, '.*');
+                regex = new RegExp(`^${regexPattern}$`);
+                regexCache.set(pattern, regex);
+            }
+            if (regex.test(relativePath) || regex.test(dirName)) {
+                return true;
+            }
+        }
+        else {
+            // Exact match
+            if (relativePath === pattern ||
+                dirName === pattern ||
+                relativePath.startsWith(pattern + '/')) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Load custom exclusion patterns from .gitignore and .snowignore
+ * @param basePath - Base path to search for ignore files
+ * @returns Array of exclusion patterns
+ */
+export async function loadExclusionPatterns(basePath) {
+    const patterns = [];
+    // Load .gitignore if exists
+    const gitignorePath = path.join(basePath, '.gitignore');
+    try {
+        const gitignoreContent = await fs.readFile(gitignorePath, 'utf-8');
+        const lines = gitignoreContent.split('\n');
+        for (const line of lines) {
+            const trimmed = line.trim();
+            // Skip empty lines and comments
+            if (trimmed && !trimmed.startsWith('#')) {
+                // Remove leading slash and trailing slash
+                const pattern = trimmed.replace(/^\//, '').replace(/\/$/, '');
+                if (pattern) {
+                    patterns.push(pattern);
+                }
+            }
+        }
+    }
+    catch {
+        // .gitignore doesn't exist or cannot be read, skip
+    }
+    // Load .snowignore if exists
+    const snowignorePath = path.join(basePath, '.snowignore');
+    try {
+        const snowignoreContent = await fs.readFile(snowignorePath, 'utf-8');
+        const lines = snowignoreContent.split('\n');
+        for (const line of lines) {
+            const trimmed = line.trim();
+            // Skip empty lines and comments
+            if (trimmed && !trimmed.startsWith('#')) {
+                // Remove leading slash and trailing slash
+                const pattern = trimmed.replace(/^\//, '').replace(/\/$/, '');
+                if (pattern) {
+                    patterns.push(pattern);
+                }
+            }
+        }
+    }
+    catch {
+        // .snowignore doesn't exist or cannot be read, skip
+    }
+    return patterns;
+}
+/**
+ * Read file with LRU cache to reduce repeated file system access
+ * @param filePath - Path to file
+ * @param fileContentCache - Cache for file contents
+ * @param maxCacheSize - Maximum cache size
+ * @returns File content
+ */
+export async function readFileWithCache(filePath, fileContentCache, maxCacheSize = 50) {
+    const stats = await fs.stat(filePath);
+    const mtime = stats.mtimeMs;
+    // Check cache
+    const cached = fileContentCache.get(filePath);
+    if (cached && cached.mtime === mtime) {
+        return cached.content;
+    }
+    // Read file
+    const content = await fs.readFile(filePath, 'utf-8');
+    // Manage cache size (simple LRU: remove oldest if over limit)
+    if (fileContentCache.size >= maxCacheSize) {
+        const firstKey = fileContentCache.keys().next().value;
+        if (firstKey) {
+            fileContentCache.delete(firstKey);
+        }
+    }
+    // Cache the content
+    fileContentCache.set(filePath, { content, mtime });
+    return content;
+}

package/dist/mcp/utils/aceCodeSearch/language.utils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Language configuration utilities for ACE Code Search
+ */
+import type { LanguageConfig } from '../../types/aceCodeSearch.types.js';
+/**
+ * Language-specific parsers configuration
+ */
+export declare const LANGUAGE_CONFIG: Record<string, LanguageConfig>;
+/**
+ * Detect programming language from file extension
+ * @param filePath - File path to detect language from
+ * @returns Language name or null if not supported
+ */
+export declare function detectLanguage(filePath: string): string | null;