@loopstack/sandbox-filesystem 0.2.0

package/dist/tools/sandbox-file-info.tool.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import { ToolResult } from '@loopstack/common';
+import { ToolBase, WorkflowExecution } from '@loopstack/core';
+declare const propertiesSchema: z.ZodObject<{
+    containerId: z.ZodString;
+    path: z.ZodString;
+}, z.core.$strict>;
+type SandboxFileInfoArgs = z.infer<typeof propertiesSchema>;
+interface SandboxFileInfoResult {
+    path: string;
+    name: string;
+    type: 'file' | 'directory' | 'symlink' | 'other';
+    size: number;
+    permissions: string;
+    owner: string;
+    group: string;
+    modifiedAt: string;
+    accessedAt: string;
+    createdAt: string;
+}
+export declare class SandboxFileInfo extends ToolBase<SandboxFileInfoArgs> {
+    private readonly logger;
+    private sandboxCommand;
+    execute(args: SandboxFileInfoArgs, _ctx: WorkflowExecution): Promise<ToolResult<SandboxFileInfoResult>>;
+    private parseFileType;
+}
+export {};

package/dist/tools/sandbox-file-info.tool.js

@@ -0,0 +1,96 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var SandboxFileInfo_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SandboxFileInfo = void 0;
+const common_1 = require("@nestjs/common");
+const zod_1 = require("zod");
+const common_2 = require("@loopstack/common");
+const core_1 = require("@loopstack/core");
+const sandbox_tool_1 = require("@loopstack/sandbox-tool");
+const propertiesSchema = zod_1.z
+    .object({
+    containerId: zod_1.z.string().describe('The ID of the container to get file info from'),
+    path: zod_1.z.string().describe('The path to the file or directory'),
+})
+    .strict();
+let SandboxFileInfo = SandboxFileInfo_1 = class SandboxFileInfo extends core_1.ToolBase {
+    logger = new common_1.Logger(SandboxFileInfo_1.name);
+    sandboxCommand;
+    async execute(args, _ctx) {
+        const { containerId, path: targetPath } = args;
+        this.logger.debug(`Getting file info for ${targetPath} in container ${containerId}`);
+        const result = await this.sandboxCommand.execute({
+            containerId,
+            executable: 'stat',
+            args: ['-c', '%F|%s|%A|%U|%G|%y|%x|%w', targetPath],
+            workingDirectory: '/',
+            timeout: 10000,
+        });
+        if (!result.data) {
+            this.logger.error(`Failed to get file info for ${targetPath}: No result data`);
+            throw new Error(`Failed to get file info for ${targetPath}: No result data`);
+        }
+        if (result.data.exitCode !== 0) {
+            this.logger.error(`Failed to get file info for ${targetPath}: ${result.data.stderr || 'Unknown error'}`);
+            throw new Error(`Failed to get file info for ${targetPath}: ${result.data.stderr || 'Unknown error'}`);
+        }
+        const output = result.data.stdout.trim();
+        const parts = output.split('|');
+        if (parts.length < 8) {
+            this.logger.error(`Unexpected stat output format: ${output}`);
+            throw new Error(`Unexpected stat output format: ${output}`);
+        }
+        const [typeStr, sizeStr, permissions, owner, group, mtime, atime, ctime] = parts;
+        const name = targetPath.split('/').pop() || targetPath;
+        const fileType = this.parseFileType(typeStr);
+        this.logger.debug(`Retrieved info for ${targetPath}: type=${fileType}, size=${sizeStr}`);
+        return {
+            data: {
+                path: targetPath,
+                name,
+                type: fileType,
+                size: parseInt(sizeStr, 10),
+                permissions,
+                owner,
+                group,
+                modifiedAt: mtime,
+                accessedAt: atime,
+                createdAt: ctime === '-' ? mtime : ctime,
+            },
+        };
+    }
+    parseFileType(typeStr) {
+        const lower = typeStr.toLowerCase();
+        if (lower.includes('regular'))
+            return 'file';
+        if (lower.includes('directory'))
+            return 'directory';
+        if (lower.includes('symbolic link'))
+            return 'symlink';
+        return 'other';
+    }
+};
+exports.SandboxFileInfo = SandboxFileInfo;
+__decorate([
+    (0, common_2.Tool)(),
+    __metadata("design:type", sandbox_tool_1.SandboxCommand)
+], SandboxFileInfo.prototype, "sandboxCommand", void 0);
+exports.SandboxFileInfo = SandboxFileInfo = SandboxFileInfo_1 = __decorate([
+    (0, common_1.Injectable)(),
+    (0, common_2.BlockConfig)({
+        config: {
+            description: 'Get detailed information about a file or directory in a sandbox container',
+        },
+    }),
+    (0, common_2.WithArguments)(propertiesSchema)
+], SandboxFileInfo);
+//# sourceMappingURL=sandbox-file-info.tool.js.map

package/dist/tools/sandbox-file-info.tool.js.map

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

package/dist/tools/sandbox-list-directory.tool.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { ToolResult } from '@loopstack/common';
+import { ToolBase, WorkflowExecution } from '@loopstack/core';
+declare const propertiesSchema: z.ZodObject<{
+    containerId: z.ZodString;
+    path: z.ZodString;
+    recursive: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+type SandboxListDirectoryArgs = z.infer<typeof propertiesSchema>;
+interface FileEntry {
+    name: string;
+    type: 'file' | 'directory' | 'symlink' | 'other';
+    size: number;
+    path: string;
+}
+interface SandboxListDirectoryResult {
+    path: string;
+    entries: FileEntry[];
+}
+export declare class SandboxListDirectory extends ToolBase<SandboxListDirectoryArgs> {
+    private readonly logger;
+    private sandboxCommand;
+    execute(args: SandboxListDirectoryArgs, _ctx: WorkflowExecution): Promise<ToolResult<SandboxListDirectoryResult>>;
+    private parseFileType;
+}
+export {};

package/dist/tools/sandbox-list-directory.tool.js

@@ -0,0 +1,102 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var SandboxListDirectory_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SandboxListDirectory = void 0;
+const common_1 = require("@nestjs/common");
+const zod_1 = require("zod");
+const common_2 = require("@loopstack/common");
+const core_1 = require("@loopstack/core");
+const sandbox_tool_1 = require("@loopstack/sandbox-tool");
+const propertiesSchema = zod_1.z
+    .object({
+    containerId: zod_1.z.string().describe('The ID of the container to list the directory from'),
+    path: zod_1.z.string().describe('The path to the directory to list'),
+    recursive: zod_1.z.boolean().default(false).describe('Whether to list directories recursively'),
+})
+    .strict();
+let SandboxListDirectory = SandboxListDirectory_1 = class SandboxListDirectory extends core_1.ToolBase {
+    logger = new common_1.Logger(SandboxListDirectory_1.name);
+    sandboxCommand;
+    async execute(args, _ctx) {
+        const { containerId, path: dirPath, recursive } = args;
+        this.logger.debug(`Listing directory ${dirPath} in container ${containerId} (recursive: ${recursive})`);
+        const command = recursive
+            ? `find '${dirPath.replace(/'/g, "'\\''")}' -printf '%y %s %p\\n'`
+            : `find '${dirPath.replace(/'/g, "'\\''")}' -maxdepth 1 -printf '%y %s %p\\n'`;
+        const result = await this.sandboxCommand.execute({
+            containerId,
+            executable: 'sh',
+            args: ['-c', command],
+            workingDirectory: '/',
+            timeout: 30000,
+        });
+        if (!result.data) {
+            this.logger.error(`Failed to list directory ${dirPath}: No result data`);
+            throw new Error(`Failed to list directory ${dirPath}: No result data`);
+        }
+        if (result.data.exitCode !== 0) {
+            this.logger.error(`Failed to list directory ${dirPath}: ${result.data.stderr || 'Unknown error'}`);
+            throw new Error(`Failed to list directory ${dirPath}: ${result.data.stderr || 'Unknown error'}`);
+        }
+        const entries = [];
+        const lines = result.data.stdout.split('\n').filter((line) => line.trim());
+        for (const line of lines) {
+            const match = line.match(/^(\S)\s+(\d+)\s+(.+)$/);
+            if (match) {
+                const [, typeChar, sizeStr, fullPath] = match;
+                const name = fullPath.split('/').pop() || fullPath;
+                if (fullPath === dirPath)
+                    continue;
+                entries.push({
+                    name,
+                    type: this.parseFileType(typeChar),
+                    size: parseInt(sizeStr, 10),
+                    path: fullPath,
+                });
+            }
+        }
+        this.logger.debug(`Listed ${entries.length} entries in ${dirPath}`);
+        return {
+            data: {
+                path: dirPath,
+                entries,
+            },
+        };
+    }
+    parseFileType(typeChar) {
+        switch (typeChar) {
+            case 'f':
+                return 'file';
+            case 'd':
+                return 'directory';
+            case 'l':
+                return 'symlink';
+            default:
+                return 'other';
+        }
+    }
+};
+exports.SandboxListDirectory = SandboxListDirectory;
+__decorate([
+    (0, common_2.Tool)(),
+    __metadata("design:type", sandbox_tool_1.SandboxCommand)
+], SandboxListDirectory.prototype, "sandboxCommand", void 0);
+exports.SandboxListDirectory = SandboxListDirectory = SandboxListDirectory_1 = __decorate([
+    (0, common_1.Injectable)(),
+    (0, common_2.BlockConfig)({
+        config: {
+            description: 'List files and directories in a sandbox container',
+        },
+    }),
+    (0, common_2.WithArguments)(propertiesSchema)
+], SandboxListDirectory);
+//# sourceMappingURL=sandbox-list-directory.tool.js.map

package/dist/tools/sandbox-list-directory.tool.js.map

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

package/dist/tools/sandbox-read-file.tool.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import { ToolResult } from '@loopstack/common';
+import { ToolBase, WorkflowExecution } from '@loopstack/core';
+declare const propertiesSchema: z.ZodObject<{
+    containerId: z.ZodString;
+    path: z.ZodString;
+    encoding: z.ZodDefault<z.ZodEnum<{
+        utf8: "utf8";
+        base64: "base64";
+    }>>;
+}, z.core.$strict>;
+type SandboxReadFileArgs = z.infer<typeof propertiesSchema>;
+interface SandboxReadFileResult {
+    content: string;
+    encoding: string;
+}
+export declare class SandboxReadFile extends ToolBase<SandboxReadFileArgs> {
+    private readonly logger;
+    private sandboxCommand;
+    execute(args: SandboxReadFileArgs, _ctx: WorkflowExecution): Promise<ToolResult<SandboxReadFileResult>>;
+}
+export {};

package/dist/tools/sandbox-read-file.tool.js

@@ -0,0 +1,71 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var SandboxReadFile_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SandboxReadFile = void 0;
+const common_1 = require("@nestjs/common");
+const zod_1 = require("zod");
+const common_2 = require("@loopstack/common");
+const core_1 = require("@loopstack/core");
+const sandbox_tool_1 = require("@loopstack/sandbox-tool");
+const propertiesSchema = zod_1.z
+    .object({
+    containerId: zod_1.z.string().describe('The ID of the container to read the file from'),
+    path: zod_1.z.string().describe('The path to the file to read'),
+    encoding: zod_1.z.enum(['utf8', 'base64']).default('utf8').describe('The encoding to use when reading the file'),
+})
+    .strict();
+let SandboxReadFile = SandboxReadFile_1 = class SandboxReadFile extends core_1.ToolBase {
+    logger = new common_1.Logger(SandboxReadFile_1.name);
+    sandboxCommand;
+    async execute(args, _ctx) {
+        const { containerId, path, encoding } = args;
+        this.logger.debug(`Reading file ${path} from container ${containerId} (encoding: ${encoding})`);
+        const executable = encoding === 'base64' ? 'base64' : 'cat';
+        const result = await this.sandboxCommand.execute({
+            containerId,
+            executable,
+            args: [path],
+            workingDirectory: '/',
+            timeout: 30000,
+        });
+        if (!result.data) {
+            this.logger.error(`Failed to read file ${path}: No result data`);
+            throw new Error(`Failed to read file ${path}: No result data`);
+        }
+        if (result.data.exitCode !== 0) {
+            this.logger.error(`Failed to read file ${path}: ${result.data.stderr || 'Unknown error'}`);
+            throw new Error(`Failed to read file ${path}: ${result.data.stderr || 'Unknown error'}`);
+        }
+        this.logger.debug(`Successfully read file ${path} (${result.data.stdout.length} characters)`);
+        return {
+            data: {
+                content: result.data.stdout,
+                encoding,
+            },
+        };
+    }
+};
+exports.SandboxReadFile = SandboxReadFile;
+__decorate([
+    (0, common_2.Tool)(),
+    __metadata("design:type", sandbox_tool_1.SandboxCommand)
+], SandboxReadFile.prototype, "sandboxCommand", void 0);
+exports.SandboxReadFile = SandboxReadFile = SandboxReadFile_1 = __decorate([
+    (0, common_1.Injectable)(),
+    (0, common_2.BlockConfig)({
+        config: {
+            description: 'Read file contents from a sandbox container',
+        },
+    }),
+    (0, common_2.WithArguments)(propertiesSchema)
+], SandboxReadFile);
+//# sourceMappingURL=sandbox-read-file.tool.js.map

package/dist/tools/sandbox-read-file.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-read-file.tool.js","sourceRoot":"","sources":["../../src/tools/sandbox-read-file.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAeA,2CAAoD;AACpD,6BAAwB;AACxB,8CAAiF;AACjF,0CAA8D;AAC9D,0DAAyD;AAEzD,MAAM,gBAAgB,GAAG,OAAC;KACvB,MAAM,CAAC;IACN,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IACjF,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACzD,QAAQ,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;CAC3G,CAAC;KACD,MAAM,EAAE,CAAC;AAgBL,IAAM,eAAe,uBAArB,MAAM,eAAgB,SAAQ,eAA6B;IAC/C,MAAM,GAAG,IAAI,eAAM,CAAC,iBAAe,CAAC,IAAI,CAAC,CAAC;IAE3C,cAAc,CAAiB;IAE/C,KAAK,CAAC,OAAO,CAAC,IAAyB,EAAE,IAAuB;QAC9D,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAE7C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,IAAI,mBAAmB,WAAW,eAAe,QAAQ,GAAG,CAAC,CAAC;QAEhG,MAAM,UAAU,GAAG,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;QAC5D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC;YAC/C,WAAW;YACX,UAAU;YACV,IAAI,EAAE,CAAC,IAAI,CAAC;YACZ,gBAAgB,EAAE,GAAG;YACrB,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,IAAI,kBAAkB,CAAC,CAAC;YACjE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,kBAAkB,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,eAAe,EAAE,CAAC,CAAC;YAC3F,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,eAAe,EAAE,CAAC,CAAC;QAC3F,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,cAAc,CAAC,CAAC;QAE9F,OAAO;YACL,IAAI,EAAE;gBACJ,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;gBAC3B,QAAQ;aACT;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AAtCY,0CAAe;AAGV;IAAf,IAAA,aAAI,GAAE;8BAAyB,6BAAc;uDAAC;0BAHpC,eAAe;IAP3B,IAAA,mBAAU,GAAE;IACZ,IAAA,oBAAW,EAAC;QACX,MAAM,EAAE;YACN,WAAW,EAAE,6CAA6C;SAC3D;KACF,CAAC;IACD,IAAA,sBAAa,EAAC,gBAAgB,CAAC;GACnB,eAAe,CAsC3B"}

package/dist/tools/sandbox-write-file.tool.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import { ToolResult } from '@loopstack/common';
+import { ToolBase, WorkflowExecution } from '@loopstack/core';
+declare const propertiesSchema: z.ZodObject<{
+    containerId: z.ZodString;
+    path: z.ZodString;
+    content: z.ZodString;
+    encoding: z.ZodDefault<z.ZodEnum<{
+        utf8: "utf8";
+        base64: "base64";
+    }>>;
+    createParentDirs: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+type SandboxWriteFileArgs = z.infer<typeof propertiesSchema>;
+interface SandboxWriteFileResult {
+    path: string;
+    bytesWritten: number;
+}
+export declare class SandboxWriteFile extends ToolBase<SandboxWriteFileArgs> {
+    private readonly logger;
+    private sandboxCommand;
+    execute(args: SandboxWriteFileArgs, _ctx: WorkflowExecution): Promise<ToolResult<SandboxWriteFileResult>>;
+}
+export {};

package/dist/tools/sandbox-write-file.tool.js

@@ -0,0 +1,96 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var SandboxWriteFile_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SandboxWriteFile = void 0;
+const common_1 = require("@nestjs/common");
+const path = require("path");
+const zod_1 = require("zod");
+const common_2 = require("@loopstack/common");
+const core_1 = require("@loopstack/core");
+const sandbox_tool_1 = require("@loopstack/sandbox-tool");
+const propertiesSchema = zod_1.z
+    .object({
+    containerId: zod_1.z.string().describe('The ID of the container to write the file to'),
+    path: zod_1.z.string().describe('The path where the file should be written'),
+    content: zod_1.z.string().describe('The content to write to the file'),
+    encoding: zod_1.z.enum(['utf8', 'base64']).default('utf8').describe('The encoding of the content'),
+    createParentDirs: zod_1.z.boolean().default(true).describe("Whether to create parent directories if they don't exist"),
+})
+    .strict();
+let SandboxWriteFile = SandboxWriteFile_1 = class SandboxWriteFile extends core_1.ToolBase {
+    logger = new common_1.Logger(SandboxWriteFile_1.name);
+    sandboxCommand;
+    async execute(args, _ctx) {
+        const { containerId, path: filePath, content, encoding, createParentDirs } = args;
+        this.logger.debug(`Writing file ${filePath} to container ${containerId} (encoding: ${encoding})`);
+        if (createParentDirs) {
+            const parentDir = path.posix.dirname(filePath);
+            if (parentDir !== '/' && parentDir !== '.') {
+                this.logger.debug(`Creating parent directory ${parentDir}`);
+                const mkdirResult = await this.sandboxCommand.execute({
+                    containerId,
+                    executable: 'mkdir',
+                    args: ['-p', parentDir],
+                    workingDirectory: '/',
+                    timeout: 5000,
+                });
+                if (!mkdirResult.data) {
+                    this.logger.error(`Failed to create parent directory ${parentDir}: No result data`);
+                    throw new Error(`Failed to create parent directory ${parentDir}: No result data`);
+                }
+                if (mkdirResult.data.exitCode !== 0) {
+                    this.logger.error(`Failed to create parent directory ${parentDir}: ${mkdirResult.data.stderr || 'Unknown error'}`);
+                    throw new Error(`Failed to create parent directory ${parentDir}: ${mkdirResult.data.stderr || 'Unknown error'}`);
+                }
+            }
+        }
+        const base64Content = encoding === 'utf8' ? Buffer.from(content, 'utf8').toString('base64') : content.replace(/[^A-Za-z0-9+/=]/g, '');
+        const result = await this.sandboxCommand.execute({
+            containerId,
+            executable: 'sh',
+            args: ['-c', `echo '${base64Content}' | base64 -d > '${filePath.replace(/'/g, "'\\''")}'`],
+            workingDirectory: '/',
+            timeout: 30000,
+        });
+        if (!result.data) {
+            this.logger.error(`Failed to write file ${filePath}: No result data`);
+            throw new Error(`Failed to write file ${filePath}: No result data`);
+        }
+        if (result.data.exitCode !== 0) {
+            this.logger.error(`Failed to write file ${filePath}: ${result.data.stderr || 'Unknown error'}`);
+            throw new Error(`Failed to write file ${filePath}: ${result.data.stderr || 'Unknown error'}`);
+        }
+        const bytesWritten = encoding === 'utf8' ? Buffer.from(content, 'utf8').length : Buffer.from(content, 'base64').length;
+        this.logger.log(`Successfully wrote ${bytesWritten} bytes to ${filePath} in container ${containerId}`);
+        return {
+            data: {
+                path: filePath,
+                bytesWritten,
+            },
+        };
+    }
+};
+exports.SandboxWriteFile = SandboxWriteFile;
+__decorate([
+    (0, common_2.Tool)(),
+    __metadata("design:type", sandbox_tool_1.SandboxCommand)
+], SandboxWriteFile.prototype, "sandboxCommand", void 0);
+exports.SandboxWriteFile = SandboxWriteFile = SandboxWriteFile_1 = __decorate([
+    (0, common_1.Injectable)(),
+    (0, common_2.BlockConfig)({
+        config: {
+            description: 'Write content to a file in a sandbox container',
+        },
+    }),
+    (0, common_2.WithArguments)(propertiesSchema)
+], SandboxWriteFile);
+//# sourceMappingURL=sandbox-write-file.tool.js.map

package/dist/tools/sandbox-write-file.tool.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@loopstack/sandbox-filesystem",
+  "displayName": "Sandbox Filesystem",
+  "description": "Secure, controlled filesystem operations within Docker sandbox environments",
+  "version": "0.2.0",
+  "author": {
+    "name": "Tobias Blättermann, Jakob Klippel"
+  },
+  "keywords": [
+    "sandbox",
+    "filesystem",
+    "docker"
+  ],
+  "license": "Apache-2.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./src/*": "./src/*"
+  },
+  "scripts": {
+    "build": "nest build",
+    "compile": "tsc --noEmit",
+    "format": "prettier --write .",
+    "lint": "eslint .",
+    "test": "jest --passWithNoTests",
+    "watch": "nest build --watch"
+  },
+  "dependencies": {
+    "@loopstack/common": "^0.18.0",
+    "@loopstack/core": "^0.18.0",
+    "@loopstack/sandbox-tool": "^0.2.0",
+    "@nestjs/common": "^11.1.12",
+    "zod": "^4.3.5"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "jest": {
+    "testEnvironment": "node",
+    "rootDir": "src",
+    "testRegex": ".*\\.spec\\.ts$",
+    "transform": {
+      "^.+\\.ts$": "ts-jest"
+    },
+    "testTimeout": 10000,
+    "forceExit": true,
+    "maxWorkers": 1
+  }
+}

package/src/index.ts

@@ -0,0 +1,8 @@
+export * from './sandbox-filesystem.module';
+export * from './tools/sandbox-read-file.tool';
+export * from './tools/sandbox-write-file.tool';
+export * from './tools/sandbox-list-directory.tool';
+export * from './tools/sandbox-create-directory.tool';
+export * from './tools/sandbox-delete.tool';
+export * from './tools/sandbox-exists.tool';
+export * from './tools/sandbox-file-info.tool';

package/src/sandbox-filesystem.module.ts

@@ -0,0 +1,48 @@
+/*
+Copyright 2025 The Loopstack Authors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+import { Module } from '@nestjs/common';
+import { LoopCoreModule } from '@loopstack/core';
+import { SandboxToolModule } from '@loopstack/sandbox-tool';
+import { SandboxCreateDirectory } from './tools/sandbox-create-directory.tool';
+import { SandboxDelete } from './tools/sandbox-delete.tool';
+import { SandboxExists } from './tools/sandbox-exists.tool';
+import { SandboxFileInfo } from './tools/sandbox-file-info.tool';
+import { SandboxListDirectory } from './tools/sandbox-list-directory.tool';
+import { SandboxReadFile } from './tools/sandbox-read-file.tool';
+import { SandboxWriteFile } from './tools/sandbox-write-file.tool';
+
+@Module({
+  imports: [LoopCoreModule, SandboxToolModule],
+  providers: [
+    SandboxReadFile,
+    SandboxWriteFile,
+    SandboxListDirectory,
+    SandboxCreateDirectory,
+    SandboxDelete,
+    SandboxExists,
+    SandboxFileInfo,
+  ],
+  exports: [
+    SandboxReadFile,
+    SandboxWriteFile,
+    SandboxListDirectory,
+    SandboxCreateDirectory,
+    SandboxDelete,
+    SandboxExists,
+    SandboxFileInfo,
+  ],
+})
+export class SandboxFilesystemModule {}