@gotza02/smartagent 1.2.0

package/dist/tools/filesystem.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Filesystem Tool Integration
+ * Secure file operations with path validation
+ */
+import type { SecurityPolicy } from "../types/index.js";
+export interface FileSystemConfig {
+    basePath: string;
+    allowedExtensions?: string[];
+    maxFileSize: number;
+    securityPolicy: SecurityPolicy;
+}
+export interface FileOperation {
+    path: string;
+    content?: string;
+    encoding?: BufferEncoding;
+}
+export interface FileInfo {
+    path: string;
+    name: string;
+    size: number;
+    isDirectory: boolean;
+    isFile: boolean;
+    modifiedAt: Date;
+    createdAt: Date;
+}
+/**
+ * Filesystem Tool
+ * Secure file operations with validation
+ */
+export declare class FileSystemTool {
+    private config;
+    constructor(config?: Partial<FileSystemConfig>);
+    /**
+     * Read file contents
+     */
+    readFile(operation: FileOperation): Promise<{
+        success: boolean;
+        content?: string;
+        error?: string;
+    }>;
+    /**
+     * Write file contents
+     */
+    writeFile(operation: FileOperation & {
+        content: string;
+    }): Promise<{
+        success: boolean;
+        bytesWritten?: number;
+        error?: string;
+    }>;
+    /**
+     * List directory contents
+     */
+    listDirectory(dirPath: string): Promise<{
+        success: boolean;
+        files?: FileInfo[];
+        error?: string;
+    }>;
+    /**
+     * Get file information
+     */
+    getFileInfo(filePath: string): Promise<{
+        success: boolean;
+        info?: FileInfo;
+        error?: string;
+    }>;
+    /**
+     * Create directory
+     */
+    createDirectory(dirPath: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Check if file exists
+     */
+    exists(filePath: string): Promise<boolean>;
+    /**
+     * Search files by pattern
+     */
+    searchFiles(dirPath: string, pattern: string, options?: {
+        recursive?: boolean;
+        maxResults?: number;
+    }): Promise<{
+        success: boolean;
+        files?: string[];
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/tools/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/tools/filesystem.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,cAAc,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,IAAI,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,GAAE,OAAO,CAAC,gBAAgB,CAAM;IAelD;;OAEG;IACG,QAAQ,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC;QAChD,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAsEF;;OAEG;IACG,SAAS,CAAC,SAAS,EAAE,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QACvE,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAgDF;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAC5C,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAmDF;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAC3C,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,QAAQ,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IA6BF;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAC9C,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAwBF;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYhD;;OAEG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;KAChB,GACL,OAAO,CAAC;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CAyCH"}

package/dist/tools/filesystem.js

@@ -0,0 +1,292 @@
+/**
+ * Filesystem Tool Integration
+ * Secure file operations with path validation
+ */
+import { readFile, writeFile, mkdir, readdir, stat, access, constants } from "fs/promises";
+import { dirname, join, extname } from "path";
+import { logger, logToolExecution } from "../utils/logger.js";
+import { validatePath } from "../security/validation.js";
+/**
+ * Filesystem Tool
+ * Secure file operations with validation
+ */
+export class FileSystemTool {
+    config;
+    constructor(config = {}) {
+        this.config = {
+            basePath: process.cwd(),
+            maxFileSize: 10 * 1024 * 1024, // 10MB
+            securityPolicy: config.securityPolicy || {
+                id: "default",
+                name: "Default",
+                pathValidation: { enabled: true, allowedPaths: [], blockedPaths: [] },
+                commandValidation: { enabled: false, whitelist: [], blacklist: [], dangerousPatterns: [] },
+                rateLimit: { enabled: false, maxRequestsPerMinute: 0, maxRequestsPerHour: 0 },
+            },
+            ...config,
+        };
+    }
+    /**
+     * Read file contents
+     */
+    async readFile(operation) {
+        const startTime = Date.now();
+        try {
+            // Validate path
+            const validation = validatePath(operation.path, this.config.securityPolicy);
+            if (!validation.valid) {
+                logToolExecution("filesystem", "unknown", "unknown", Date.now() - startTime, false, {
+                    operation: "read",
+                    error: validation.error,
+                });
+                return { success: false, error: validation.error };
+            }
+            const resolvedPath = validation.resolvedPath;
+            // Check file exists
+            try {
+                await access(resolvedPath, constants.R_OK);
+            }
+            catch {
+                return { success: false, error: `File not accessible: ${operation.path}` };
+            }
+            // Check file size
+            const fileStat = await stat(resolvedPath);
+            if (fileStat.size > this.config.maxFileSize) {
+                return {
+                    success: false,
+                    error: `File too large: ${fileStat.size} bytes (max: ${this.config.maxFileSize})`,
+                };
+            }
+            // Check extension using proper path parsing
+            if (this.config.allowedExtensions && this.config.allowedExtensions.length > 0) {
+                const ext = extname(resolvedPath).toLowerCase().replace(/^\./, '');
+                const allowedLower = this.config.allowedExtensions.map(e => e.toLowerCase().replace(/^\./, ''));
+                if (!ext || !allowedLower.includes(ext)) {
+                    return {
+                        success: false,
+                        error: `File extension not allowed: ${ext || 'none'}`,
+                    };
+                }
+            }
+            // Read file
+            const content = await readFile(resolvedPath, {
+                encoding: operation.encoding || "utf-8",
+            });
+            const duration = Date.now() - startTime;
+            logToolExecution("filesystem", "unknown", "unknown", duration, true, {
+                operation: "read",
+                path: resolvedPath,
+                size: content.length,
+            });
+            return { success: true, content };
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logToolExecution("filesystem", "unknown", "unknown", duration, false, {
+                operation: "read",
+                error: errorMessage,
+            });
+            return { success: false, error: errorMessage };
+        }
+    }
+    /**
+     * Write file contents
+     */
+    async writeFile(operation) {
+        const startTime = Date.now();
+        try {
+            // Validate path
+            const validation = validatePath(operation.path, this.config.securityPolicy);
+            if (!validation.valid) {
+                return { success: false, error: validation.error };
+            }
+            const resolvedPath = validation.resolvedPath;
+            // Check content size
+            const contentBuffer = Buffer.from(operation.content);
+            if (contentBuffer.length > this.config.maxFileSize) {
+                return {
+                    success: false,
+                    error: `Content too large: ${contentBuffer.length} bytes (max: ${this.config.maxFileSize})`,
+                };
+            }
+            // Create directory if needed
+            const dir = dirname(resolvedPath);
+            try {
+                await mkdir(dir, { recursive: true });
+            }
+            catch {
+                // Directory might already exist
+            }
+            // Write file
+            await writeFile(resolvedPath, operation.content, {
+                encoding: operation.encoding || "utf-8",
+            });
+            const duration = Date.now() - startTime;
+            logToolExecution("filesystem", "unknown", "unknown", duration, true, {
+                operation: "write",
+                path: resolvedPath,
+                size: contentBuffer.length,
+            });
+            return { success: true, bytesWritten: contentBuffer.length };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return { success: false, error: errorMessage };
+        }
+    }
+    /**
+     * List directory contents
+     */
+    async listDirectory(dirPath) {
+        const startTime = Date.now();
+        try {
+            // Validate path
+            const validation = validatePath(dirPath, this.config.securityPolicy);
+            if (!validation.valid) {
+                return { success: false, error: validation.error };
+            }
+            const resolvedPath = validation.resolvedPath;
+            // Check if directory
+            const dirStat = await stat(resolvedPath);
+            if (!dirStat.isDirectory()) {
+                return { success: false, error: `Not a directory: ${dirPath}` };
+            }
+            // Read directory
+            const entries = await readdir(resolvedPath, { withFileTypes: true });
+            const files = [];
+            for (const entry of entries) {
+                const entryPath = join(resolvedPath, entry.name);
+                const entryStat = await stat(entryPath);
+                files.push({
+                    path: entryPath,
+                    name: entry.name,
+                    size: entryStat.size,
+                    isDirectory: entry.isDirectory(),
+                    isFile: entry.isFile(),
+                    modifiedAt: entryStat.mtime,
+                    createdAt: entryStat.birthtime,
+                });
+            }
+            const duration = Date.now() - startTime;
+            logToolExecution("filesystem", "unknown", "unknown", duration, true, {
+                operation: "list",
+                path: resolvedPath,
+                count: files.length,
+            });
+            return { success: true, files };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return { success: false, error: errorMessage };
+        }
+    }
+    /**
+     * Get file information
+     */
+    async getFileInfo(filePath) {
+        try {
+            // Validate path
+            const validation = validatePath(filePath, this.config.securityPolicy);
+            if (!validation.valid) {
+                return { success: false, error: validation.error };
+            }
+            const resolvedPath = validation.resolvedPath;
+            const fileStat = await stat(resolvedPath);
+            return {
+                success: true,
+                info: {
+                    path: resolvedPath,
+                    name: resolvedPath.split("/").pop() || "",
+                    size: fileStat.size,
+                    isDirectory: fileStat.isDirectory(),
+                    isFile: fileStat.isFile(),
+                    modifiedAt: fileStat.mtime,
+                    createdAt: fileStat.birthtime,
+                },
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return { success: false, error: errorMessage };
+        }
+    }
+    /**
+     * Create directory
+     */
+    async createDirectory(dirPath) {
+        try {
+            // Validate path
+            const validation = validatePath(dirPath, this.config.securityPolicy);
+            if (!validation.valid) {
+                return { success: false, error: validation.error };
+            }
+            const resolvedPath = validation.resolvedPath;
+            await mkdir(resolvedPath, { recursive: true });
+            logger.info("Directory created", {
+                category: "tool",
+                operation: "mkdir",
+                path: resolvedPath,
+            });
+            return { success: true };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return { success: false, error: errorMessage };
+        }
+    }
+    /**
+     * Check if file exists
+     */
+    async exists(filePath) {
+        try {
+            const validation = validatePath(filePath, this.config.securityPolicy);
+            if (!validation.valid)
+                return false;
+            await access(validation.resolvedPath, constants.F_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Search files by pattern
+     */
+    async searchFiles(dirPath, pattern, options = {}) {
+        const results = [];
+        try {
+            const validation = validatePath(dirPath, this.config.securityPolicy);
+            if (!validation.valid) {
+                return { success: false, error: validation.error };
+            }
+            const searchDir = async (currentPath) => {
+                if (options.maxResults && results.length >= options.maxResults) {
+                    return;
+                }
+                const entries = await readdir(currentPath, { withFileTypes: true });
+                for (const entry of entries) {
+                    const entryPath = join(currentPath, entry.name);
+                    if (entry.isDirectory() && options.recursive) {
+                        await searchDir(entryPath);
+                    }
+                    else if (entry.isFile()) {
+                        if (entry.name.includes(pattern)) {
+                            results.push(entryPath);
+                        }
+                    }
+                    if (options.maxResults && results.length >= options.maxResults) {
+                        break;
+                    }
+                }
+            };
+            await searchDir(validation.resolvedPath);
+            return { success: true, files: results };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return { success: false, error: errorMessage };
+        }
+    }
+}
+//# sourceMappingURL=filesystem.js.map

package/dist/tools/filesystem.js.map

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

package/dist/tools/terminal.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Terminal Tool Integration
+ * Secure command execution with validation and sandboxing
+ */
+import type { SecurityPolicy } from "../types/index.js";
+export interface TerminalConfig {
+    cwd: string;
+    env: Record<string, string>;
+    timeout: number;
+    maxOutputSize: number;
+    shell: string;
+    securityPolicy: SecurityPolicy;
+    sandboxEnabled: boolean;
+}
+export interface CommandExecution {
+    command: string;
+    args?: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    timeout?: number;
+}
+export interface CommandResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    executionTime: number;
+}
+/**
+ * Terminal Tool
+ * Secure command execution
+ */
+export declare class TerminalTool {
+    private config;
+    constructor(config?: Partial<TerminalConfig>);
+    /**
+     * Execute a command
+     */
+    execute(execution: CommandExecution): Promise<{
+        success: boolean;
+        result?: CommandResult;
+        error?: string;
+        blocked?: boolean;
+    }>;
+    /**
+     * Prepare sandboxed environment
+     */
+    private prepareSandboxEnv;
+    /**
+     * Validate cwd against allowed paths
+     */
+    private validateCwd;
+    /**
+     * Run command with spawn
+     */
+    private runCommand;
+    /**
+     * Execute a simple command (no args)
+     */
+    run(command: string, options?: Partial<CommandExecution>): Promise<{
+        success: boolean;
+        output?: string;
+        error?: string;
+    }>;
+    /**
+     * Check if a command exists
+     */
+    commandExists(command: string): Promise<boolean>;
+    /**
+     * Get system information
+     */
+    getSystemInfo(): Promise<{
+        success: boolean;
+        info?: {
+            platform: string;
+            arch: string;
+            nodeVersion: string;
+            shell: string;
+            cwd: string;
+        };
+        error?: string;
+    }>;
+    /**
+     * Execute piped commands
+     */
+    pipe(commands: string[]): Promise<{
+        success: boolean;
+        result?: CommandResult;
+        error?: string;
+    }>;
+    /**
+     * Execute script from file
+     */
+    executeScript(scriptPath: string, args?: string[]): Promise<{
+        success: boolean;
+        result?: CommandResult;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=terminal.d.ts.map

package/dist/tools/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/tools/terminal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAuBxD,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,cAAc,CAAC;IAC/B,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAiB;gBAEnB,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM;IAmBhD;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAClD,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IA+EF;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;IACH,OAAO,CAAC,UAAU;IA0HlB;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,CAAC,gBAAgB,CAAM,GAAG,OAAO,CAAC;QAC3E,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAqBF;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAStD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC;QAC7B,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE;YACL,QAAQ,EAAE,MAAM,CAAC;YACjB,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,KAAK,EAAE,MAAM,CAAC;YACd,GAAG,EAAE,MAAM,CAAC;SACb,CAAC;QACF,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAoBF;;OAEG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QACtC,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAkBF;;OAEG;IACG,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,MAAM,EAAO,GAClB,OAAO,CAAC;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CA+BH"}