nova-terminal-ai 0.3.4

package/dist/packages/core/src/tools/ToolRegistry.js

@@ -0,0 +1,208 @@
+// ============================================================================
+// ToolRegistry - Central registry for tool management
+// ============================================================================
+import { ToolError, ToolValidationError } from '../types/errors.js';
+import { BUILTIN_TOOLS } from '../types/tools.js';
+export class ToolRegistry {
+    tools = new Map();
+    categories = new Map();
+    /** Register a tool */
+    register(definition, handler) {
+        if (this.tools.has(definition.name)) {
+            throw new ToolError(`Tool "${definition.name}" is already registered`, definition.name);
+        }
+        this.tools.set(definition.name, {
+            definition,
+            handler,
+            enabled: true,
+        });
+        // Add to category index
+        const cat = definition.category;
+        if (!this.categories.has(cat)) {
+            this.categories.set(cat, new Set());
+        }
+        this.categories.get(cat).add(definition.name);
+    }
+    /** Unregister a tool by name */
+    unregister(name) {
+        const entry = this.tools.get(name);
+        if (!entry)
+            return false;
+        this.tools.delete(name);
+        this.categories.get(entry.definition.category)?.delete(name);
+        return true;
+    }
+    /** Get a tool entry by name */
+    get(name) {
+        return this.tools.get(name);
+    }
+    /** Get a tool's definition */
+    getDefinition(name) {
+        return this.tools.get(name)?.definition;
+    }
+    /** Get a tool's handler */
+    getHandler(name) {
+        return this.tools.get(name)?.handler;
+    }
+    /** Check if a tool exists */
+    has(name) {
+        return this.tools.has(name);
+    }
+    /** Enable a tool */
+    enable(name) {
+        const entry = this.tools.get(name);
+        if (entry)
+            entry.enabled = true;
+    }
+    /** Disable a tool */
+    disable(name) {
+        const entry = this.tools.get(name);
+        if (entry)
+            entry.enabled = false;
+    }
+    /** Check if a tool is enabled */
+    isEnabled(name) {
+        return this.tools.get(name)?.enabled ?? false;
+    }
+    /** Get all tool names */
+    getToolNames() {
+        return Array.from(this.tools.keys());
+    }
+    /** Get all enabled tool names */
+    getEnabledToolNames() {
+        return Array.from(this.tools.entries())
+            .filter(([, entry]) => entry.enabled)
+            .map(([name]) => name);
+    }
+    /** Get tools by category */
+    getToolsByCategory(category) {
+        const names = this.categories.get(category);
+        if (!names)
+            return [];
+        return Array.from(names)
+            .map((name) => this.tools.get(name))
+            .filter(Boolean);
+    }
+    /** Get all tool definitions (for LLM schema) */
+    getAllDefinitions() {
+        return Array.from(this.tools.values())
+            .filter((entry) => entry.enabled)
+            .map((entry) => entry.definition);
+    }
+    /** Get tool definitions in Anthropic tool use format */
+    getAnthropicToolDefinitions() {
+        return this.getAllDefinitions().map((def) => ({
+            name: def.name,
+            description: def.description,
+            input_schema: def.inputSchema,
+        }));
+    }
+    /** Get tool definitions in OpenAI function calling format */
+    getOpenAIToolDefinitions() {
+        return this.getAllDefinitions().map((def) => ({
+            type: 'function',
+            function: {
+                name: def.name,
+                description: def.description,
+                parameters: def.inputSchema,
+            },
+        }));
+    }
+    /** Check if a tool requires approval for given input and mode */
+    requiresApproval(name, input, mode) {
+        const entry = this.tools.get(name);
+        if (!entry)
+            return false;
+        // yolo mode: never require approval
+        if (mode === 'yolo')
+            return false;
+        // accepting_edits: never require approval
+        if (mode === 'accepting_edits')
+            return false;
+        const { requiresApproval } = entry.definition;
+        if (requiresApproval === undefined)
+            return false;
+        if (typeof requiresApproval === 'boolean')
+            return requiresApproval;
+        return requiresApproval(input, mode);
+    }
+    /** Get the risk level of a tool */
+    getRiskLevel(name) {
+        return this.tools.get(name)?.definition.riskLevel ?? 'medium';
+    }
+    /** Validate tool input against its schema */
+    validateInput(name, input) {
+        const entry = this.tools.get(name);
+        if (!entry) {
+            return { valid: false, errors: [{ field: '_', message: `Tool "${name}" not found` }] };
+        }
+        const schema = entry.definition.inputSchema;
+        // Basic validation against JSON Schema properties
+        const errors = [];
+        const properties = (schema.properties || {});
+        const required = (schema.required || []);
+        // Check required fields
+        for (const fieldName of required) {
+            if (input[fieldName] === undefined || input[fieldName] === null) {
+                errors.push({ field: fieldName, message: `Required field "${fieldName}" is missing` });
+            }
+        }
+        // Check property types
+        for (const [fieldName, value] of Object.entries(input)) {
+            const propSchema = properties[fieldName];
+            if (!propSchema)
+                continue;
+            const expectedType = propSchema.type;
+            const actualType = Array.isArray(value) ? 'array' : typeof value;
+            if (Array.isArray(expectedType)) {
+                if (!expectedType.includes(actualType)) {
+                    errors.push({
+                        field: fieldName,
+                        message: `Expected type ${expectedType.join('|')}, got ${actualType}`,
+                    });
+                }
+            }
+            else if (expectedType && expectedType !== actualType) {
+                errors.push({
+                    field: fieldName,
+                    message: `Expected type ${expectedType}, got ${actualType}`,
+                });
+            }
+        }
+        return errors.length === 0 ? { valid: true } : { valid: false, errors };
+    }
+    /** Execute a tool with the given input */
+    async execute(name, input) {
+        const entry = this.tools.get(name);
+        if (!entry) {
+            throw new ToolError(`Tool "${name}" not found`, name);
+        }
+        if (!entry.enabled) {
+            throw new ToolError(`Tool "${name}" is disabled`, name);
+        }
+        // Validate input
+        const validation = this.validateInput(name, input.params);
+        if (!validation.valid) {
+            const errors = 'errors' in validation ? validation.errors : [];
+            throw new ToolValidationError(`Invalid input for tool "${name}"`, name, errors);
+        }
+        return entry.handler(input);
+    }
+    /** Get all builtin tool names */
+    getBuiltinToolNames() {
+        return Object.values(BUILTIN_TOOLS);
+    }
+    /** Get statistics about registered tools */
+    getStats() {
+        const byCategory = {};
+        for (const [cat, names] of this.categories) {
+            byCategory[cat] = names.size;
+        }
+        return {
+            total: this.tools.size,
+            enabled: this.getEnabledToolNames().length,
+            byCategory,
+        };
+    }
+}
+//# sourceMappingURL=ToolRegistry.js.map

package/dist/packages/core/src/tools/ToolRegistry.js.map

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

package/dist/packages/core/src/tools/impl/EditFileTool.d.ts

@@ -0,0 +1,3 @@
+import type { ToolHandler } from '../../types/tools.js';
+export declare const editFileHandler: ToolHandler;
+//# sourceMappingURL=EditFileTool.d.ts.map

package/dist/packages/core/src/tools/impl/EditFileTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EditFileTool.d.ts","sourceRoot":"","sources":["../../../../../../../core/src/tools/impl/EditFileTool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAuC,MAAM,sBAAsB,CAAC;AAG7F,eAAO,MAAM,eAAe,EAAE,WAwE7B,CAAC"}

package/dist/packages/core/src/tools/impl/EditFileTool.js

@@ -0,0 +1,76 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { ToolError } from '../../types/errors.js';
+export const editFileHandler = async (input) => {
+    const { filePath, oldText, newText, allOccurrences = false, dryRun = false } = input.params;
+    const resolvedPath = path.resolve(filePath);
+    try {
+        const content = await fs.readFile(resolvedPath, 'utf-8');
+        // Check if oldText exists
+        if (!content.includes(oldText)) {
+            throw new ToolError(`The specified text was not found in the file. Make sure oldText matches exactly (including whitespace).`, 'edit_file');
+        }
+        // Count occurrences
+        const occurrences = content.split(oldText).length - 1;
+        if (occurrences > 1 && !allOccurrences) {
+            throw new ToolError(`The text appears ${occurrences} times in the file. Set allOccurrences=true to replace all, or make oldText more specific to match only once.`, 'edit_file', undefined, { occurrences });
+        }
+        let newContent;
+        if (allOccurrences) {
+            newContent = content.split(oldText).join(newText);
+        }
+        else {
+            newContent = content.replace(oldText, newText);
+        }
+        if (dryRun) {
+            // Show a unified diff-like preview
+            const oldLines = content.split('\n');
+            const newLines = newContent.split('\n');
+            const preview = generateDiffPreview(oldLines, newLines);
+            return {
+                content: `Dry run preview for ${resolvedPath}:\n${preview}\n\n${occurrences} occurrence(s) would be replaced.`,
+                metadata: { dryRun: true, occurrences, path: resolvedPath },
+            };
+        }
+        await fs.writeFile(resolvedPath, newContent, 'utf-8');
+        return {
+            content: `Successfully replaced ${occurrences} occurrence(s) in ${resolvedPath}`,
+            metadata: {
+                path: resolvedPath,
+                occurrences,
+                oldSize: Buffer.byteLength(content, 'utf-8'),
+                newSize: Buffer.byteLength(newContent, 'utf-8'),
+            },
+            filesAffected: [resolvedPath],
+        };
+    }
+    catch (err) {
+        if (err instanceof ToolError)
+            throw err;
+        const code = err.code;
+        if (code === 'ENOENT') {
+            throw new ToolError(`File not found: ${filePath}`, 'edit_file', undefined, { code });
+        }
+        throw new ToolError(`Failed to edit file: ${err.message}`, 'edit_file');
+    }
+};
+function generateDiffPreview(oldLines, newLines) {
+    const result = [];
+    const maxLines = Math.max(oldLines.length, newLines.length);
+    let shown = 0;
+    for (let i = 0; i < maxLines && shown < 20; i++) {
+        const oldLine = oldLines[i];
+        const newLine = newLines[i];
+        if (oldLine === newLine)
+            continue;
+        if (oldLine !== undefined)
+            result.push(`- ${oldLine}`);
+        if (newLine !== undefined)
+            result.push(`+ ${newLine}`);
+        shown++;
+    }
+    if (shown >= 20)
+        result.push('... (truncated)');
+    return result.join('\n');
+}
+//# sourceMappingURL=EditFileTool.js.map

package/dist/packages/core/src/tools/impl/EditFileTool.js.map

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

package/dist/packages/core/src/tools/impl/FileProcessor.d.ts

@@ -0,0 +1,85 @@
+export interface FileProcessResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+    metadata?: Record<string, any>;
+}
+export interface PdfExtractOptions {
+    startPage?: number;
+    endPage?: number;
+    includeMetadata?: boolean;
+}
+export interface WordExtractOptions {
+    includeStyles?: boolean;
+    includeImages?: boolean;
+}
+export interface ExcelExtractOptions {
+    sheetName?: string;
+    headerRow?: number;
+    includeFormulas?: boolean;
+}
+export declare class FileProcessor {
+    /**
+     * 读取文件内容
+     */
+    readFile(filePath: string, encoding?: BufferEncoding): Promise<FileProcessResult>;
+    /**
+     * 写入文件内容
+     */
+    writeFile(filePath: string, content: string | Buffer, encoding?: BufferEncoding): Promise<FileProcessResult>;
+    /**
+     * 获取文件信息
+     */
+    getFileInfo(filePath: string): Promise<FileProcessResult>;
+    /**
+     * 提取PDF文本内容
+     */
+    extractPdfText(filePath: string, options?: PdfExtractOptions): Promise<FileProcessResult>;
+    /**
+     * 创建PDF文档
+     */
+    createPdf(content: string, outputPath: string): Promise<FileProcessResult>;
+    /**
+     * 提取Word文档文本
+     */
+    extractWordText(filePath: string, options?: WordExtractOptions): Promise<FileProcessResult>;
+    /**
+     * 创建Word文档
+     */
+    createWord(content: string, outputPath: string): Promise<FileProcessResult>;
+    /**
+     * 读取Excel文件
+     */
+    readExcel(filePath: string, options?: ExcelExtractOptions): Promise<FileProcessResult>;
+    /**
+     * 创建Excel文件
+     */
+    createExcel(data: any[], outputPath: string, sheetName?: string): Promise<FileProcessResult>;
+    /**
+     * 读取JSON文件
+     */
+    readJson(filePath: string): Promise<FileProcessResult>;
+    /**
+     * 创建JSON文件
+     */
+    createJson(data: any, outputPath: string, pretty?: boolean): Promise<FileProcessResult>;
+    /**
+     * 读取XML文件
+     */
+    readXml(filePath: string): Promise<FileProcessResult>;
+    /**
+     * 读取Markdown文件
+     */
+    readMarkdown(filePath: string): Promise<FileProcessResult>;
+    /**
+     * 根据文件扩展名自动选择处理方法
+     */
+    processFile(filePath: string, options?: any): Promise<FileProcessResult>;
+    /**
+     * 创建文件（根据扩展名自动选择格式）
+     */
+    createFile(content: any, outputPath: string, options?: any): Promise<FileProcessResult>;
+}
+export declare const fileProcessor: FileProcessor;
+export default fileProcessor;
+//# sourceMappingURL=FileProcessor.d.ts.map

package/dist/packages/core/src/tools/impl/FileProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileProcessor.d.ts","sourceRoot":"","sources":["../../../../../../../core/src/tools/impl/FileProcessor.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,qBAAa,aAAa;IAMtB;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAoB/F;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,GAAE,cAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA4B1H;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA6B/D;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiDnG;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA2ChF;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAsCrG;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwCjF;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAmChG;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,GAAE,MAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA6B5G;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAsB5D;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAE,OAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgBnG;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAsD3D;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAoChE;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,GAAQ,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA+BlF;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,GAAQ,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAqBpG;AAMD,eAAO,MAAM,aAAa,eAAsB,CAAC;AAEjD,eAAe,aAAa,CAAC"}