@framers/agentos-ext-cli-executor 1.1.0

package/dist/services/shellService.js

@@ -0,0 +1,362 @@
+/**
+ * Shell Service
+ * Manages command execution with security validation.
+ *
+ * @module @framers/agentos-ext-cli-executor
+ */
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+const execPromise = promisify(exec);
+/**
+ * Dangerous command patterns to block by default
+ */
+const DANGEROUS_PATTERNS = [
+    /rm\s+(-rf?|--recursive)\s+\/(?!\S)/i, // rm -rf / (root)
+    /rm\s+(-rf?|--recursive)\s+~(?!\S)/i, // rm -rf ~ (home)
+    /format\s+[a-z]:/i, // format C:
+    /del\s+\/s\s+\/q\s+[a-z]:\\/i, // del /s /q C:\
+    /mkfs\./i, // mkfs.*
+    /dd\s+.+of=\/dev\/sd/i, // dd to disk
+    /:\(\)\s*\{\s*:\|\:\s*&\s*\}\s*;:/, // Fork bomb
+    />\s*\/dev\/sd[a-z]/i, // Write to disk device
+    /shutdown|reboot|poweroff/i, // System control
+    /passwd|chpasswd/i, // Password changes
+    /visudo|sudoers/i, // Sudo config
+    /chmod\s+777\s+\//i, // chmod 777 /
+    /chown\s+.+:\s*\//i, // chown root /
+];
+/**
+ * Shell service for executing commands
+ */
+export class ShellService {
+    config;
+    constructor(config = {}) {
+        this.config = {
+            defaultShell: 'auto',
+            timeout: 60000,
+            blockedCommands: [],
+            ...config,
+        };
+    }
+    /**
+     * Detect the appropriate shell for the current platform
+     */
+    detectShell() {
+        if (this.config.defaultShell && this.config.defaultShell !== 'auto') {
+            return this.config.defaultShell;
+        }
+        const platform = process.platform;
+        if (platform === 'win32') {
+            return 'powershell';
+        }
+        else if (platform === 'darwin') {
+            return 'zsh';
+        }
+        else {
+            return 'bash';
+        }
+    }
+    /**
+     * Check if a command is safe to execute
+     */
+    checkSecurity(command) {
+        const warnings = [];
+        let riskLevel = 'safe';
+        // Check against blocked commands list
+        const blockedCommands = this.config.blockedCommands || [];
+        for (const blocked of blockedCommands) {
+            if (command.includes(blocked)) {
+                return {
+                    allowed: false,
+                    reason: `Command contains blocked pattern: ${blocked}`,
+                    riskLevel: 'critical',
+                    warnings: [],
+                };
+            }
+        }
+        // Check against dangerous patterns
+        for (const pattern of DANGEROUS_PATTERNS) {
+            if (pattern.test(command)) {
+                return {
+                    allowed: false,
+                    reason: `Command matches dangerous pattern: ${pattern.source}`,
+                    riskLevel: 'critical',
+                    warnings: [],
+                };
+            }
+        }
+        // Check allowed commands whitelist
+        if (this.config.allowedCommands && this.config.allowedCommands.length > 0) {
+            const baseCommand = command.split(/\s+/)[0];
+            if (!this.config.allowedCommands.includes(baseCommand)) {
+                return {
+                    allowed: false,
+                    reason: `Command not in allowed list: ${baseCommand}`,
+                    riskLevel: 'medium',
+                    warnings: [],
+                };
+            }
+        }
+        // Risk assessment
+        if (/sudo|su\s/i.test(command)) {
+            warnings.push('Command uses elevated privileges');
+            riskLevel = 'high';
+        }
+        if (/curl.*\|.*sh|wget.*\|.*sh/i.test(command)) {
+            warnings.push('Piping downloaded content to shell');
+            riskLevel = 'high';
+        }
+        if (/eval|exec/i.test(command)) {
+            warnings.push('Command uses eval/exec');
+            riskLevel = 'medium';
+        }
+        if (/>|>>/.test(command)) {
+            warnings.push('Command redirects output to file');
+            if (riskLevel === 'safe')
+                riskLevel = 'low';
+        }
+        if (/rm\s|del\s|remove-item/i.test(command)) {
+            warnings.push('Command deletes files');
+            if (riskLevel === 'safe' || riskLevel === 'low')
+                riskLevel = 'medium';
+        }
+        return {
+            allowed: true,
+            riskLevel,
+            warnings,
+        };
+    }
+    /**
+     * Execute a shell command
+     */
+    async execute(command, options) {
+        const startTime = Date.now();
+        const shell = this.detectShell();
+        const cwd = options?.cwd || this.config.workingDirectory || process.cwd();
+        const timeout = options?.timeout || this.config.timeout || 60000;
+        // Security check
+        const securityCheck = this.checkSecurity(command);
+        if (!securityCheck.allowed) {
+            return {
+                command,
+                exitCode: 1,
+                stdout: '',
+                stderr: `Security violation: ${securityCheck.reason}`,
+                duration: 0,
+                success: false,
+                cwd,
+                shell,
+            };
+        }
+        try {
+            const env = { ...process.env, ...this.config.env, ...options?.env };
+            const { stdout, stderr } = await execPromise(command, {
+                cwd,
+                env,
+                timeout,
+                shell: shell === 'powershell' ? 'powershell.exe' : shell,
+                maxBuffer: 10 * 1024 * 1024, // 10MB
+            });
+            return {
+                command,
+                exitCode: 0,
+                stdout: stdout.toString(),
+                stderr: stderr.toString(),
+                duration: Date.now() - startTime,
+                success: true,
+                cwd,
+                shell,
+            };
+        }
+        catch (error) {
+            return {
+                command,
+                exitCode: error.code || 1,
+                stdout: error.stdout?.toString() || '',
+                stderr: error.stderr?.toString() || error.message,
+                duration: Date.now() - startTime,
+                success: false,
+                cwd,
+                shell,
+            };
+        }
+    }
+    /**
+     * Run a script file
+     */
+    async runScript(scriptPath, options) {
+        const startTime = Date.now();
+        const cwd = options?.cwd || this.config.workingDirectory || process.cwd();
+        const timeout = options?.timeout || this.config.timeout || 60000;
+        // Detect interpreter from file extension if not specified
+        let interpreter = options?.interpreter;
+        if (!interpreter) {
+            const ext = path.extname(scriptPath).toLowerCase();
+            interpreter = {
+                '.py': 'python',
+                '.js': 'node',
+                '.ts': 'npx ts-node',
+                '.sh': 'bash',
+                '.bash': 'bash',
+                '.ps1': 'powershell',
+                '.rb': 'ruby',
+                '.pl': 'perl',
+            }[ext] || 'bash';
+        }
+        const args = options?.args || [];
+        const command = `${interpreter} "${scriptPath}" ${args.join(' ')}`;
+        const result = await this.execute(command, { cwd, env: options?.env, timeout });
+        return {
+            ...result,
+            scriptPath,
+            interpreter,
+        };
+    }
+    /**
+     * Read a file
+     */
+    async readFile(filePath, options) {
+        const encoding = options?.encoding || 'utf-8';
+        const absolutePath = path.isAbsolute(filePath)
+            ? filePath
+            : path.resolve(this.config.workingDirectory || process.cwd(), filePath);
+        const stats = await fs.stat(absolutePath);
+        let content;
+        let truncated = false;
+        if (options?.lines) {
+            // Read specific number of lines
+            const fileContent = await fs.readFile(absolutePath, encoding);
+            const lines = fileContent.split('\n');
+            if (options.fromEnd) {
+                content = lines.slice(-options.lines).join('\n');
+            }
+            else {
+                content = lines.slice(0, options.lines).join('\n');
+            }
+            truncated = lines.length > options.lines;
+        }
+        else if (options?.maxBytes) {
+            // Read limited bytes
+            const handle = await fs.open(absolutePath, 'r');
+            const buffer = Buffer.alloc(options.maxBytes);
+            const { bytesRead } = await handle.read(buffer, 0, options.maxBytes, options?.start || 0);
+            await handle.close();
+            content = buffer.slice(0, bytesRead).toString(encoding);
+            truncated = stats.size > options.maxBytes;
+        }
+        else {
+            // Read entire file
+            content = await fs.readFile(absolutePath, encoding);
+        }
+        return {
+            path: absolutePath,
+            content,
+            size: stats.size,
+            truncated,
+            encoding,
+        };
+    }
+    /**
+     * Write to a file
+     */
+    async writeFile(filePath, content, options) {
+        const encoding = options?.encoding || 'utf-8';
+        const absolutePath = path.isAbsolute(filePath)
+            ? filePath
+            : path.resolve(this.config.workingDirectory || process.cwd(), filePath);
+        // Check if file exists
+        let fileExists = true;
+        try {
+            await fs.access(absolutePath);
+        }
+        catch {
+            fileExists = false;
+        }
+        // Create parent directories if needed
+        if (options?.createDirs) {
+            await fs.mkdir(path.dirname(absolutePath), { recursive: true });
+        }
+        // Write file
+        if (options?.append) {
+            await fs.appendFile(absolutePath, content, { encoding, mode: options?.mode });
+        }
+        else {
+            await fs.writeFile(absolutePath, content, { encoding, mode: options?.mode });
+        }
+        return {
+            path: absolutePath,
+            bytesWritten: Buffer.byteLength(content, encoding),
+            created: !fileExists,
+            appended: options?.append || false,
+        };
+    }
+    /**
+     * List directory contents
+     */
+    async listDirectory(dirPath, options) {
+        const absolutePath = path.isAbsolute(dirPath)
+            ? dirPath
+            : path.resolve(this.config.workingDirectory || process.cwd(), dirPath);
+        const entries = [];
+        const readDir = async (dir, depth) => {
+            const items = await fs.readdir(dir, { withFileTypes: true });
+            for (const item of items) {
+                // Skip hidden files unless requested
+                if (!options?.showHidden && item.name.startsWith('.')) {
+                    continue;
+                }
+                // Apply pattern filter
+                if (options?.pattern) {
+                    const regex = new RegExp(options.pattern.replace(/\*/g, '.*').replace(/\?/g, '.'));
+                    if (!regex.test(item.name)) {
+                        continue;
+                    }
+                }
+                const itemPath = path.join(dir, item.name);
+                const entry = {
+                    name: item.name,
+                    path: itemPath,
+                    type: item.isDirectory()
+                        ? 'directory'
+                        : item.isSymbolicLink()
+                            ? 'symlink'
+                            : item.isFile()
+                                ? 'file'
+                                : 'other',
+                };
+                if (item.isFile()) {
+                    entry.extension = path.extname(item.name);
+                }
+                // Include stats if requested
+                if (options?.includeStats) {
+                    try {
+                        const stats = await fs.stat(itemPath);
+                        entry.size = stats.size;
+                        entry.modifiedAt = stats.mtime.toISOString();
+                        entry.createdAt = stats.birthtime.toISOString();
+                    }
+                    catch {
+                        // Ignore stat errors
+                    }
+                }
+                entries.push(entry);
+                // Recursive listing
+                if (options?.recursive &&
+                    item.isDirectory() &&
+                    depth < (options?.maxDepth || 10)) {
+                    await readDir(itemPath, depth + 1);
+                }
+            }
+        };
+        await readDir(absolutePath, 0);
+        return {
+            path: absolutePath,
+            entries,
+            count: entries.length,
+            recursive: options?.recursive || false,
+        };
+    }
+}
+//# sourceMappingURL=shellService.js.map

package/dist/services/shellService.js.map

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

package/dist/tools/execute.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Execute Tool
+ * Execute shell commands.
+ *
+ * @module @framers/agentos-ext-cli-executor
+ */
+import type { ITool } from '@framers/agentos';
+import type { ShellService } from '../services/shellService';
+import type { ExecutionResult } from '../types';
+/**
+ * Tool for executing shell commands
+ */
+export declare class ExecuteTool implements ITool {
+    private shellService;
+    readonly id = "shellExecute";
+    readonly name = "Execute Shell Command";
+    readonly description = "Execute a shell command and return output";
+    constructor(shellService: ShellService);
+    /**
+     * Execute command
+     */
+    execute(input: {
+        command: string;
+        cwd?: string;
+        env?: Record<string, string>;
+        timeout?: number;
+    }): Promise<{
+        success: boolean;
+        output?: ExecutionResult;
+        error?: string;
+    }>;
+    /**
+     * Validate input
+     */
+    validate(input: any): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Get JSON schema for tool
+     */
+    getSchema(): any;
+}
+//# sourceMappingURL=execute.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/tools/execute.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;GAEG;AACH,qBAAa,WAAY,YAAW,KAAK;IAK3B,OAAO,CAAC,YAAY;IAJhC,SAAgB,EAAE,kBAAkB;IACpC,SAAgB,IAAI,2BAA2B;IAC/C,SAAgB,WAAW,+CAA+C;gBAEtD,YAAY,EAAE,YAAY;IAE9C;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,eAAe,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IA2B3E;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,GAAG,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAkB1D;;OAEG;IACH,SAAS,IAAI,GAAG;CA0BjB"}

package/dist/tools/execute.js

@@ -0,0 +1,94 @@
+/**
+ * Execute Tool
+ * Execute shell commands.
+ *
+ * @module @framers/agentos-ext-cli-executor
+ */
+/**
+ * Tool for executing shell commands
+ */
+export class ExecuteTool {
+    shellService;
+    id = 'shellExecute';
+    name = 'Execute Shell Command';
+    description = 'Execute a shell command and return output';
+    constructor(shellService) {
+        this.shellService = shellService;
+    }
+    /**
+     * Execute command
+     */
+    async execute(input) {
+        try {
+            // Security check first
+            const securityCheck = this.shellService.checkSecurity(input.command);
+            if (!securityCheck.allowed) {
+                return {
+                    success: false,
+                    error: `Security violation: ${securityCheck.reason}`,
+                };
+            }
+            const result = await this.shellService.execute(input.command, {
+                cwd: input.cwd,
+                env: input.env,
+                timeout: input.timeout,
+            });
+            return {
+                success: result.success,
+                output: result,
+                error: result.success ? undefined : result.stderr,
+            };
+        }
+        catch (error) {
+            return { success: false, error: error.message };
+        }
+    }
+    /**
+     * Validate input
+     */
+    validate(input) {
+        const errors = [];
+        if (!input.command) {
+            errors.push('Command is required');
+        }
+        else if (typeof input.command !== 'string') {
+            errors.push('Command must be a string');
+        }
+        if (input.timeout !== undefined) {
+            if (typeof input.timeout !== 'number' || input.timeout <= 0) {
+                errors.push('Timeout must be a positive number');
+            }
+        }
+        return { valid: errors.length === 0, errors };
+    }
+    /**
+     * Get JSON schema for tool
+     */
+    getSchema() {
+        return {
+            type: 'object',
+            required: ['command'],
+            properties: {
+                command: {
+                    type: 'string',
+                    description: 'Shell command to execute',
+                },
+                cwd: {
+                    type: 'string',
+                    description: 'Working directory for command',
+                },
+                env: {
+                    type: 'object',
+                    additionalProperties: { type: 'string' },
+                    description: 'Environment variables',
+                },
+                timeout: {
+                    type: 'number',
+                    description: 'Timeout in milliseconds',
+                    default: 60000,
+                },
+            },
+        };
+    }
+}
+//# sourceMappingURL=execute.js.map

package/dist/tools/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../src/tools/execute.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,OAAO,WAAW;IAKF;IAJJ,EAAE,GAAG,cAAc,CAAC;IACpB,IAAI,GAAG,uBAAuB,CAAC;IAC/B,WAAW,GAAG,2CAA2C,CAAC;IAE1E,YAAoB,YAA0B;QAA1B,iBAAY,GAAZ,YAAY,CAAc;IAAG,CAAC;IAElD;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,KAKb;QACC,IAAI,CAAC;YACH,uBAAuB;YACvB,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACrE,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;gBAC3B,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,uBAAuB,aAAa,CAAC,MAAM,EAAE;iBACrD,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE;gBAC5D,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,MAAM,EAAE,MAAM;gBACd,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM;aAClD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAU;QACjB,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACrC,CAAC;aAAM,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC1C,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC;gBAC5D,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0BAA0B;iBACxC;gBACD,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+BAA+B;iBAC7C;gBACD,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,oBAAoB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACxC,WAAW,EAAE,uBAAuB;iBACrC;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yBAAyB;oBACtC,OAAO,EAAE,KAAK;iBACf;aACF;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/tools/fileRead.d.ts

@@ -0,0 +1,45 @@
+/**
+ * File Read Tool
+ * Read file contents.
+ *
+ * @module @framers/agentos-ext-cli-executor
+ */
+import type { ITool } from '@framers/agentos';
+import type { ShellService } from '../services/shellService';
+import type { FileReadResult } from '../types';
+/**
+ * Tool for reading files
+ */
+export declare class FileReadTool implements ITool {
+    private shellService;
+    readonly id = "fileRead";
+    readonly name = "Read File";
+    readonly description = "Read contents of a file";
+    constructor(shellService: ShellService);
+    /**
+     * Read file
+     */
+    execute(input: {
+        path: string;
+        encoding?: BufferEncoding;
+        maxBytes?: number;
+        lines?: number;
+        fromEnd?: boolean;
+    }): Promise<{
+        success: boolean;
+        output?: FileReadResult;
+        error?: string;
+    }>;
+    /**
+     * Validate input
+     */
+    validate(input: any): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Get JSON schema for tool
+     */
+    getSchema(): any;
+}
+//# sourceMappingURL=fileRead.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fileRead.d.ts","sourceRoot":"","sources":["../../src/tools/fileRead.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;GAEG;AACH,qBAAa,YAAa,YAAW,KAAK;IAK5B,OAAO,CAAC,YAAY;IAJhC,SAAgB,EAAE,cAAc;IAChC,SAAgB,IAAI,eAAe;IACnC,SAAgB,WAAW,6BAA6B;gBAEpC,YAAY,EAAE,YAAY;IAE9C;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,cAAc,CAAC;QAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,cAAc,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAe1E;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,GAAG,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAY1D;;OAEG;IACH,SAAS,IAAI,GAAG;CA8BjB"}

package/dist/tools/fileRead.js

@@ -0,0 +1,82 @@
+/**
+ * File Read Tool
+ * Read file contents.
+ *
+ * @module @framers/agentos-ext-cli-executor
+ */
+/**
+ * Tool for reading files
+ */
+export class FileReadTool {
+    shellService;
+    id = 'fileRead';
+    name = 'Read File';
+    description = 'Read contents of a file';
+    constructor(shellService) {
+        this.shellService = shellService;
+    }
+    /**
+     * Read file
+     */
+    async execute(input) {
+        try {
+            const result = await this.shellService.readFile(input.path, {
+                encoding: input.encoding,
+                maxBytes: input.maxBytes,
+                lines: input.lines,
+                fromEnd: input.fromEnd,
+            });
+            return { success: true, output: result };
+        }
+        catch (error) {
+            return { success: false, error: error.message };
+        }
+    }
+    /**
+     * Validate input
+     */
+    validate(input) {
+        const errors = [];
+        if (!input.path) {
+            errors.push('Path is required');
+        }
+        else if (typeof input.path !== 'string') {
+            errors.push('Path must be a string');
+        }
+        return { valid: errors.length === 0, errors };
+    }
+    /**
+     * Get JSON schema for tool
+     */
+    getSchema() {
+        return {
+            type: 'object',
+            required: ['path'],
+            properties: {
+                path: {
+                    type: 'string',
+                    description: 'File path to read',
+                },
+                encoding: {
+                    type: 'string',
+                    default: 'utf-8',
+                    description: 'File encoding',
+                },
+                maxBytes: {
+                    type: 'number',
+                    description: 'Maximum bytes to read',
+                },
+                lines: {
+                    type: 'number',
+                    description: 'Number of lines to read',
+                },
+                fromEnd: {
+                    type: 'boolean',
+                    default: false,
+                    description: 'Read lines from end of file',
+                },
+            },
+        };
+    }
+}
+//# sourceMappingURL=fileRead.js.map

package/dist/tools/fileRead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileRead.js","sourceRoot":"","sources":["../../src/tools/fileRead.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,OAAO,YAAY;IAKH;IAJJ,EAAE,GAAG,UAAU,CAAC;IAChB,IAAI,GAAG,WAAW,CAAC;IACnB,WAAW,GAAG,yBAAyB,CAAC;IAExD,YAAoB,YAA0B;QAA1B,iBAAY,GAAZ,YAAY,CAAc;IAAG,CAAC;IAElD;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,KAMb;QACC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE;gBAC1D,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC;YAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAU;QACjB,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAClC,CAAC;aAAM,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,MAAM,CAAC;YAClB,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mBAAmB;iBACjC;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,OAAO;oBAChB,WAAW,EAAE,eAAe;iBAC7B;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uBAAuB;iBACrC;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yBAAyB;iBACvC;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,KAAK;oBACd,WAAW,EAAE,6BAA6B;iBAC3C;aACF;SACF,CAAC;IACJ,CAAC;CACF"}