@tetral-ai/sdk 0.110.0-alpha.1

package/tools/memory/node.js

@@ -0,0 +1,331 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BetaLocalFilesystemMemoryTool = exports.betaMemoryTool = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+var memory_1 = require("../../helpers/beta/memory.js");
+Object.defineProperty(exports, "betaMemoryTool", { enumerable: true, get: function () { return memory_1.betaMemoryTool; } });
+const fs = tslib_1.__importStar(require("fs/promises"));
+const path = tslib_1.__importStar(require("path"));
+const crypto_1 = require("crypto");
+// Owner read/write only. Avoids the Node.js default of 0o666 which, in
+// environments with a permissive umask (e.g. Docker where umask is often
+// 0o000), would make memory files world-readable or even world-writable.
+const FILE_CREATE_MODE = 0o600;
+// fs.mkdir defaults to 0o777; restrict memory directories so they aren't
+// world-accessible in environments with permissive umasks.
+const DIR_CREATE_MODE = 0o700;
+async function exists(path) {
+    return await fs
+        .access(path)
+        .then(() => true)
+        .catch((err) => {
+        if (err.code === 'ENOENT')
+            return false;
+        throw err;
+    });
+}
+/**
+ * Atomically writes content to a file by writing to a temporary file first and then renaming it.
+ * This ensures the target file is never in a partially written state, preventing data corruption
+ * if the process crashes or is interrupted during the write operation. The rename operation is
+ * atomic on most file systems, guaranteeing that readers will only ever see the complete old
+ * content or the complete new content, never a mix or partial state.
+ *
+ * @param targetPath - The path where the file should be written
+ * @param content - The content to write to the file
+ */
+async function atomicWriteFile(targetPath, content) {
+    const dir = path.dirname(targetPath);
+    const tempPath = path.join(dir, `.tmp-${process.pid}-${(0, crypto_1.randomUUID)()}`);
+    let handle;
+    try {
+        handle = await fs.open(tempPath, 'wx', FILE_CREATE_MODE);
+        await handle.writeFile(content, 'utf-8');
+        await handle.sync();
+        await handle.close();
+        handle = undefined;
+        await fs.rename(tempPath, targetPath);
+    }
+    catch (err) {
+        if (handle) {
+            await handle.close().catch(() => { });
+        }
+        await fs.unlink(tempPath).catch(() => { });
+        throw err;
+    }
+}
+/**
+ * Validates that a target path doesn't escape the memory root via symlinks.
+ *
+ * Prevents symlink attacks where a malicious symlink inside /memories points
+ * outside (e.g., /memories/foo -> /etc), which would allow operations like
+ * creating /memories/foo/passwd to actually write to /etc/passwd.
+ *
+ * Walks up from the target path to find the deepest existing ancestor,
+ * then resolves it to ensure the real path stays within memoryRoot.
+ */
+async function validateNoSymlinkEscape(targetPath, memoryRoot) {
+    const resolvedRoot = await fs.realpath(memoryRoot);
+    let current = targetPath;
+    while (true) {
+        try {
+            const resolved = await fs.realpath(current);
+            if (resolved !== resolvedRoot && !resolved.startsWith(resolvedRoot + path.sep)) {
+                throw new Error(`Path would escape /memories directory via symlink`);
+            }
+            return;
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT')
+                throw err;
+            const parent = path.dirname(current);
+            if (parent === current || current === memoryRoot) {
+                return;
+            }
+            current = parent;
+        }
+    }
+}
+async function readFileContent(fullPath, memoryPath) {
+    try {
+        return await fs.readFile(fullPath, 'utf-8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw new Error(`The file ${memoryPath} no longer exists (may have been deleted or renamed concurrently).`);
+        }
+        throw err;
+    }
+}
+function formatFileSize(bytes) {
+    if (bytes === 0)
+        return '0B';
+    const k = 1024;
+    const sizes = ['B', 'K', 'M', 'G'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    const size = bytes / Math.pow(k, i);
+    return (size % 1 === 0 ? size.toString() : size.toFixed(1)) + sizes[i];
+}
+const MAX_LINES = 999999;
+const LINE_NUMBER_WIDTH = String(MAX_LINES).length;
+class BetaLocalFilesystemMemoryTool {
+    constructor(basePath = './memory') {
+        this.basePath = basePath;
+        this.memoryRoot = path.join(this.basePath, 'memories');
+    }
+    static async init(basePath = './memory') {
+        const memory = new BetaLocalFilesystemMemoryTool(basePath);
+        await fs.mkdir(memory.memoryRoot, { recursive: true, mode: DIR_CREATE_MODE });
+        return memory;
+    }
+    async validatePath(memoryPath) {
+        if (!memoryPath.startsWith('/memories')) {
+            throw new Error(`Path must start with /memories, got: ${memoryPath}`);
+        }
+        const relativePath = memoryPath.slice('/memories'.length).replace(/^\//, '');
+        const fullPath = relativePath ? path.join(this.memoryRoot, relativePath) : this.memoryRoot;
+        const resolvedPath = path.resolve(fullPath);
+        const resolvedRoot = path.resolve(this.memoryRoot);
+        if (resolvedPath !== resolvedRoot && !resolvedPath.startsWith(resolvedRoot + path.sep)) {
+            throw new Error(`Path ${memoryPath} would escape /memories directory`);
+        }
+        await validateNoSymlinkEscape(resolvedPath, this.memoryRoot);
+        return resolvedPath;
+    }
+    async view(command) {
+        const fullPath = await this.validatePath(command.path);
+        let stat;
+        try {
+            stat = await fs.stat(fullPath);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                throw new Error(`The path ${command.path} does not exist. Please provide a valid path.`);
+            }
+            throw err;
+        }
+        if (stat.isDirectory()) {
+            const items = [];
+            const collectItems = async (dirPath, relativePath, depth) => {
+                if (depth > 2)
+                    return;
+                const dirContents = await fs.readdir(dirPath);
+                for (const item of dirContents.sort()) {
+                    if (item.startsWith('.') || item === 'node_modules') {
+                        continue;
+                    }
+                    const itemPath = path.join(dirPath, item);
+                    const itemRelativePath = relativePath ? `${relativePath}/${item}` : item;
+                    let itemStat;
+                    try {
+                        itemStat = await fs.stat(itemPath);
+                    }
+                    catch {
+                        continue;
+                    }
+                    if (itemStat.isDirectory()) {
+                        items.push({ size: formatFileSize(itemStat.size), path: `${itemRelativePath}/` });
+                        if (depth < 2) {
+                            await collectItems(itemPath, itemRelativePath, depth + 1);
+                        }
+                    }
+                    else if (itemStat.isFile()) {
+                        items.push({ size: formatFileSize(itemStat.size), path: itemRelativePath });
+                    }
+                }
+            };
+            await collectItems(fullPath, '', 1);
+            const header = `Here're the files and directories up to 2 levels deep in ${command.path}, excluding hidden items and node_modules:`;
+            const dirSize = formatFileSize(stat.size);
+            const lines = [
+                `${dirSize}\t${command.path}`,
+                ...items.map((item) => `${item.size}\t${command.path}/${item.path}`),
+            ];
+            return `${header}\n${lines.join('\n')}`;
+        }
+        else if (stat.isFile()) {
+            const content = await readFileContent(fullPath, command.path);
+            const lines = content.split('\n');
+            if (lines.length > MAX_LINES) {
+                throw new Error(`File ${command.path} has too many lines (${lines.length}). Maximum is ${MAX_LINES.toLocaleString()} lines.`);
+            }
+            let displayLines = lines;
+            let startNum = 1;
+            if (command.view_range && command.view_range.length === 2) {
+                const startLine = Math.max(1, command.view_range[0]) - 1;
+                const endLine = command.view_range[1] === -1 ? lines.length : command.view_range[1];
+                displayLines = lines.slice(startLine, endLine);
+                startNum = startLine + 1;
+            }
+            const numberedLines = displayLines.map((line, i) => `${String(i + startNum).padStart(LINE_NUMBER_WIDTH, ' ')}\t${line}`);
+            return `Here's the content of ${command.path} with line numbers:\n${numberedLines.join('\n')}`;
+        }
+        else {
+            throw new Error(`Unsupported file type for ${command.path}`);
+        }
+    }
+    async create(command) {
+        const fullPath = await this.validatePath(command.path);
+        await fs.mkdir(path.dirname(fullPath), { recursive: true, mode: DIR_CREATE_MODE });
+        let handle;
+        try {
+            handle = await fs.open(fullPath, 'wx', FILE_CREATE_MODE);
+            await handle.writeFile(command.file_text, 'utf-8');
+            await handle.sync();
+        }
+        catch (err) {
+            if (err?.code === 'EEXIST') {
+                throw new Error(`File ${command.path} already exists`);
+            }
+            throw err;
+        }
+        finally {
+            await handle?.close().catch(() => { });
+        }
+        return `File created successfully at: ${command.path}`;
+    }
+    async str_replace(command) {
+        const fullPath = await this.validatePath(command.path);
+        let stat;
+        try {
+            stat = await fs.stat(fullPath);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                throw new Error(`The path ${command.path} does not exist. Please provide a valid path.`);
+            }
+            throw err;
+        }
+        if (!stat.isFile()) {
+            throw new Error(`The path ${command.path} is not a file.`);
+        }
+        const content = await readFileContent(fullPath, command.path);
+        const lines = content.split('\n');
+        const matchingLines = [];
+        lines.forEach((line, index) => {
+            if (line.includes(command.old_str)) {
+                matchingLines.push(index + 1);
+            }
+        });
+        if (matchingLines.length === 0) {
+            throw new Error(`No replacement was performed, old_str \`${command.old_str}\` did not appear verbatim in ${command.path}.`);
+        }
+        else if (matchingLines.length > 1) {
+            throw new Error(`No replacement was performed. Multiple occurrences of old_str \`${command.old_str}\` in lines: ${matchingLines.join(', ')}. Please ensure it is unique`);
+        }
+        const newContent = content.replace(command.old_str, command.new_str);
+        await atomicWriteFile(fullPath, newContent);
+        const newLines = newContent.split('\n');
+        const changedLineIndex = matchingLines[0] - 1;
+        const contextStart = Math.max(0, changedLineIndex - 2);
+        const contextEnd = Math.min(newLines.length, changedLineIndex + 3);
+        const snippet = newLines.slice(contextStart, contextEnd).map((line, i) => {
+            const lineNum = contextStart + i + 1;
+            return `${String(lineNum).padStart(LINE_NUMBER_WIDTH, ' ')}\t${line}`;
+        });
+        return `The memory file has been edited. Here is the snippet showing the change (with line numbers):\n${snippet.join('\n')}`;
+    }
+    async insert(command) {
+        const fullPath = await this.validatePath(command.path);
+        let stat;
+        try {
+            stat = await fs.stat(fullPath);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                throw new Error(`The path ${command.path} does not exist. Please provide a valid path.`);
+            }
+            throw err;
+        }
+        if (!stat.isFile()) {
+            throw new Error(`The path ${command.path} is not a file.`);
+        }
+        const content = await readFileContent(fullPath, command.path);
+        const lines = content.split('\n');
+        if (command.insert_line < 0 || command.insert_line > lines.length) {
+            throw new Error(`Invalid \`insert_line\` parameter: ${command.insert_line}. It should be within the range of lines of the file: [0, ${lines.length}]`);
+        }
+        lines.splice(command.insert_line, 0, command.insert_text.replace(/\n$/, ''));
+        await atomicWriteFile(fullPath, lines.join('\n'));
+        return `The file ${command.path} has been edited.`;
+    }
+    async delete(command) {
+        const fullPath = await this.validatePath(command.path);
+        if (command.path === '/memories') {
+            throw new Error('Cannot delete the /memories directory itself');
+        }
+        try {
+            await fs.rm(fullPath, { recursive: true, force: false });
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                throw new Error(`The path ${command.path} does not exist`);
+            }
+            throw err;
+        }
+        return `Successfully deleted ${command.path}`;
+    }
+    async rename(command) {
+        const oldFullPath = await this.validatePath(command.old_path);
+        const newFullPath = await this.validatePath(command.new_path);
+        // POSIX rename() silently overwrites existing files without error,
+        // so we can't catch this atomically. Best-effort check to warn user.
+        if (await exists(newFullPath)) {
+            throw new Error(`The destination ${command.new_path} already exists`);
+        }
+        const newDir = path.dirname(newFullPath);
+        await fs.mkdir(newDir, { recursive: true, mode: DIR_CREATE_MODE });
+        try {
+            await fs.rename(oldFullPath, newFullPath);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                throw new Error(`The path ${command.old_path} does not exist`);
+            }
+            throw err;
+        }
+        return `Successfully renamed ${command.old_path} to ${command.new_path}`;
+    }
+}
+exports.BetaLocalFilesystemMemoryTool = BetaLocalFilesystemMemoryTool;
+//# sourceMappingURL=node.js.map

package/tools/memory/node.js.map

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

package/tools/memory/node.mjs

@@ -0,0 +1,325 @@
+export { betaMemoryTool } from "../../helpers/beta/memory.mjs";
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { randomUUID } from 'crypto';
+// Owner read/write only. Avoids the Node.js default of 0o666 which, in
+// environments with a permissive umask (e.g. Docker where umask is often
+// 0o000), would make memory files world-readable or even world-writable.
+const FILE_CREATE_MODE = 0o600;
+// fs.mkdir defaults to 0o777; restrict memory directories so they aren't
+// world-accessible in environments with permissive umasks.
+const DIR_CREATE_MODE = 0o700;
+async function exists(path) {
+    return await fs
+        .access(path)
+        .then(() => true)
+        .catch((err) => {
+        if (err.code === 'ENOENT')
+            return false;
+        throw err;
+    });
+}
+/**
+ * Atomically writes content to a file by writing to a temporary file first and then renaming it.
+ * This ensures the target file is never in a partially written state, preventing data corruption
+ * if the process crashes or is interrupted during the write operation. The rename operation is
+ * atomic on most file systems, guaranteeing that readers will only ever see the complete old
+ * content or the complete new content, never a mix or partial state.
+ *
+ * @param targetPath - The path where the file should be written
+ * @param content - The content to write to the file
+ */
+async function atomicWriteFile(targetPath, content) {
+    const dir = path.dirname(targetPath);
+    const tempPath = path.join(dir, `.tmp-${process.pid}-${randomUUID()}`);
+    let handle;
+    try {
+        handle = await fs.open(tempPath, 'wx', FILE_CREATE_MODE);
+        await handle.writeFile(content, 'utf-8');
+        await handle.sync();
+        await handle.close();
+        handle = undefined;
+        await fs.rename(tempPath, targetPath);
+    }
+    catch (err) {
+        if (handle) {
+            await handle.close().catch(() => { });
+        }
+        await fs.unlink(tempPath).catch(() => { });
+        throw err;
+    }
+}
+/**
+ * Validates that a target path doesn't escape the memory root via symlinks.
+ *
+ * Prevents symlink attacks where a malicious symlink inside /memories points
+ * outside (e.g., /memories/foo -> /etc), which would allow operations like
+ * creating /memories/foo/passwd to actually write to /etc/passwd.
+ *
+ * Walks up from the target path to find the deepest existing ancestor,
+ * then resolves it to ensure the real path stays within memoryRoot.
+ */
+async function validateNoSymlinkEscape(targetPath, memoryRoot) {
+    const resolvedRoot = await fs.realpath(memoryRoot);
+    let current = targetPath;
+    while (true) {
+        try {
+            const resolved = await fs.realpath(current);
+            if (resolved !== resolvedRoot && !resolved.startsWith(resolvedRoot + path.sep)) {
+                throw new Error(`Path would escape /memories directory via symlink`);
+            }
+            return;
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT')
+                throw err;
+            const parent = path.dirname(current);
+            if (parent === current || current === memoryRoot) {
+                return;
+            }
+            current = parent;
+        }
+    }
+}
+async function readFileContent(fullPath, memoryPath) {
+    try {
+        return await fs.readFile(fullPath, 'utf-8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw new Error(`The file ${memoryPath} no longer exists (may have been deleted or renamed concurrently).`);
+        }
+        throw err;
+    }
+}
+function formatFileSize(bytes) {
+    if (bytes === 0)
+        return '0B';
+    const k = 1024;
+    const sizes = ['B', 'K', 'M', 'G'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    const size = bytes / Math.pow(k, i);
+    return (size % 1 === 0 ? size.toString() : size.toFixed(1)) + sizes[i];
+}
+const MAX_LINES = 999999;
+const LINE_NUMBER_WIDTH = String(MAX_LINES).length;
+export class BetaLocalFilesystemMemoryTool {
+    constructor(basePath = './memory') {
+        this.basePath = basePath;
+        this.memoryRoot = path.join(this.basePath, 'memories');
+    }
+    static async init(basePath = './memory') {
+        const memory = new BetaLocalFilesystemMemoryTool(basePath);
+        await fs.mkdir(memory.memoryRoot, { recursive: true, mode: DIR_CREATE_MODE });
+        return memory;
+    }
+    async validatePath(memoryPath) {
+        if (!memoryPath.startsWith('/memories')) {
+            throw new Error(`Path must start with /memories, got: ${memoryPath}`);
+        }
+        const relativePath = memoryPath.slice('/memories'.length).replace(/^\//, '');
+        const fullPath = relativePath ? path.join(this.memoryRoot, relativePath) : this.memoryRoot;
+        const resolvedPath = path.resolve(fullPath);
+        const resolvedRoot = path.resolve(this.memoryRoot);
+        if (resolvedPath !== resolvedRoot && !resolvedPath.startsWith(resolvedRoot + path.sep)) {
+            throw new Error(`Path ${memoryPath} would escape /memories directory`);
+        }
+        await validateNoSymlinkEscape(resolvedPath, this.memoryRoot);
+        return resolvedPath;
+    }
+    async view(command) {
+        const fullPath = await this.validatePath(command.path);
+        let stat;
+        try {
+            stat = await fs.stat(fullPath);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                throw new Error(`The path ${command.path} does not exist. Please provide a valid path.`);
+            }
+            throw err;
+        }
+        if (stat.isDirectory()) {
+            const items = [];
+            const collectItems = async (dirPath, relativePath, depth) => {
+                if (depth > 2)
+                    return;
+                const dirContents = await fs.readdir(dirPath);
+                for (const item of dirContents.sort()) {
+                    if (item.startsWith('.') || item === 'node_modules') {
+                        continue;
+                    }
+                    const itemPath = path.join(dirPath, item);
+                    const itemRelativePath = relativePath ? `${relativePath}/${item}` : item;
+                    let itemStat;
+                    try {
+                        itemStat = await fs.stat(itemPath);
+                    }
+                    catch {
+                        continue;
+                    }
+                    if (itemStat.isDirectory()) {
+                        items.push({ size: formatFileSize(itemStat.size), path: `${itemRelativePath}/` });
+                        if (depth < 2) {
+                            await collectItems(itemPath, itemRelativePath, depth + 1);
+                        }
+                    }
+                    else if (itemStat.isFile()) {
+                        items.push({ size: formatFileSize(itemStat.size), path: itemRelativePath });
+                    }
+                }
+            };
+            await collectItems(fullPath, '', 1);
+            const header = `Here're the files and directories up to 2 levels deep in ${command.path}, excluding hidden items and node_modules:`;
+            const dirSize = formatFileSize(stat.size);
+            const lines = [
+                `${dirSize}\t${command.path}`,
+                ...items.map((item) => `${item.size}\t${command.path}/${item.path}`),
+            ];
+            return `${header}\n${lines.join('\n')}`;
+        }
+        else if (stat.isFile()) {
+            const content = await readFileContent(fullPath, command.path);
+            const lines = content.split('\n');
+            if (lines.length > MAX_LINES) {
+                throw new Error(`File ${command.path} has too many lines (${lines.length}). Maximum is ${MAX_LINES.toLocaleString()} lines.`);
+            }
+            let displayLines = lines;
+            let startNum = 1;
+            if (command.view_range && command.view_range.length === 2) {
+                const startLine = Math.max(1, command.view_range[0]) - 1;
+                const endLine = command.view_range[1] === -1 ? lines.length : command.view_range[1];
+                displayLines = lines.slice(startLine, endLine);
+                startNum = startLine + 1;
+            }
+            const numberedLines = displayLines.map((line, i) => `${String(i + startNum).padStart(LINE_NUMBER_WIDTH, ' ')}\t${line}`);
+            return `Here's the content of ${command.path} with line numbers:\n${numberedLines.join('\n')}`;
+        }
+        else {
+            throw new Error(`Unsupported file type for ${command.path}`);
+        }
+    }
+    async create(command) {
+        const fullPath = await this.validatePath(command.path);
+        await fs.mkdir(path.dirname(fullPath), { recursive: true, mode: DIR_CREATE_MODE });
+        let handle;
+        try {
+            handle = await fs.open(fullPath, 'wx', FILE_CREATE_MODE);
+            await handle.writeFile(command.file_text, 'utf-8');
+            await handle.sync();
+        }
+        catch (err) {
+            if (err?.code === 'EEXIST') {
+                throw new Error(`File ${command.path} already exists`);
+            }
+            throw err;
+        }
+        finally {
+            await handle?.close().catch(() => { });
+        }
+        return `File created successfully at: ${command.path}`;
+    }
+    async str_replace(command) {
+        const fullPath = await this.validatePath(command.path);
+        let stat;
+        try {
+            stat = await fs.stat(fullPath);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                throw new Error(`The path ${command.path} does not exist. Please provide a valid path.`);
+            }
+            throw err;
+        }
+        if (!stat.isFile()) {
+            throw new Error(`The path ${command.path} is not a file.`);
+        }
+        const content = await readFileContent(fullPath, command.path);
+        const lines = content.split('\n');
+        const matchingLines = [];
+        lines.forEach((line, index) => {
+            if (line.includes(command.old_str)) {
+                matchingLines.push(index + 1);
+            }
+        });
+        if (matchingLines.length === 0) {
+            throw new Error(`No replacement was performed, old_str \`${command.old_str}\` did not appear verbatim in ${command.path}.`);
+        }
+        else if (matchingLines.length > 1) {
+            throw new Error(`No replacement was performed. Multiple occurrences of old_str \`${command.old_str}\` in lines: ${matchingLines.join(', ')}. Please ensure it is unique`);
+        }
+        const newContent = content.replace(command.old_str, command.new_str);
+        await atomicWriteFile(fullPath, newContent);
+        const newLines = newContent.split('\n');
+        const changedLineIndex = matchingLines[0] - 1;
+        const contextStart = Math.max(0, changedLineIndex - 2);
+        const contextEnd = Math.min(newLines.length, changedLineIndex + 3);
+        const snippet = newLines.slice(contextStart, contextEnd).map((line, i) => {
+            const lineNum = contextStart + i + 1;
+            return `${String(lineNum).padStart(LINE_NUMBER_WIDTH, ' ')}\t${line}`;
+        });
+        return `The memory file has been edited. Here is the snippet showing the change (with line numbers):\n${snippet.join('\n')}`;
+    }
+    async insert(command) {
+        const fullPath = await this.validatePath(command.path);
+        let stat;
+        try {
+            stat = await fs.stat(fullPath);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                throw new Error(`The path ${command.path} does not exist. Please provide a valid path.`);
+            }
+            throw err;
+        }
+        if (!stat.isFile()) {
+            throw new Error(`The path ${command.path} is not a file.`);
+        }
+        const content = await readFileContent(fullPath, command.path);
+        const lines = content.split('\n');
+        if (command.insert_line < 0 || command.insert_line > lines.length) {
+            throw new Error(`Invalid \`insert_line\` parameter: ${command.insert_line}. It should be within the range of lines of the file: [0, ${lines.length}]`);
+        }
+        lines.splice(command.insert_line, 0, command.insert_text.replace(/\n$/, ''));
+        await atomicWriteFile(fullPath, lines.join('\n'));
+        return `The file ${command.path} has been edited.`;
+    }
+    async delete(command) {
+        const fullPath = await this.validatePath(command.path);
+        if (command.path === '/memories') {
+            throw new Error('Cannot delete the /memories directory itself');
+        }
+        try {
+            await fs.rm(fullPath, { recursive: true, force: false });
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                throw new Error(`The path ${command.path} does not exist`);
+            }
+            throw err;
+        }
+        return `Successfully deleted ${command.path}`;
+    }
+    async rename(command) {
+        const oldFullPath = await this.validatePath(command.old_path);
+        const newFullPath = await this.validatePath(command.new_path);
+        // POSIX rename() silently overwrites existing files without error,
+        // so we can't catch this atomically. Best-effort check to warn user.
+        if (await exists(newFullPath)) {
+            throw new Error(`The destination ${command.new_path} already exists`);
+        }
+        const newDir = path.dirname(newFullPath);
+        await fs.mkdir(newDir, { recursive: true, mode: DIR_CREATE_MODE });
+        try {
+            await fs.rename(oldFullPath, newFullPath);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                throw new Error(`The path ${command.old_path} does not exist`);
+            }
+            throw err;
+        }
+        return `Successfully renamed ${command.old_path} to ${command.new_path}`;
+    }
+}
+//# sourceMappingURL=node.mjs.map