@loopstack/sandbox-filesystem 0.2.0

package/README.md

@@ -0,0 +1,234 @@
+# @loopstack/sandbox-filesystem
+
+> A module for the [Loopstack AI](https://loopstack.ai) automation framework.
+
+This module provides secure, controlled filesystem operations within Docker sandbox environments for Loopstack workflows.
+
+## Overview
+
+The Sandbox Filesystem module enables workflows to perform file and directory operations in isolated Docker containers. It provides a comprehensive set of tools for reading, writing, listing, and managing files within sandbox environments, ensuring secure execution of filesystem operations.
+
+By using this module, you'll be able to:
+
+- Create, read, update, and delete files within sandbox containers
+- List directory contents with recursive options
+- Create directories with automatic parent directory creation
+- Get detailed file and directory metadata
+- Check for file/directory existence
+- Handle both text and binary file content using UTF-8 or base64 encoding
+- Perform all operations within the security boundary of Docker containers
+
+This module is essential for workflows that need to manipulate files in isolated environments, such as code execution sandboxes, build environments, or secure file processing pipelines.
+
+**Note:** This module requires `@loopstack/sandbox-tool` as a dependency. The Docker sandbox containers must be initialized using `SandboxInit` and destroyed using `SandboxDestroy` from the `@loopstack/sandbox-tool` module. The filesystem tools operate on containers that have been created by the sandbox-tool.
+
+## Installation
+
+You can add this module using the `loopstack` cli or via `npm`.
+
+### a) Add Sources via `loopstack add`
+
+```bash
+loopstack add @loopstack/sandbox-filesystem
+```
+
+This command copies the source files into your `src` directory.
+
+- It is a great way to explore the code to learn new concepts or add own customizations
+- It will set up the module for you, so you do not need to manually update your application
+
+### b) Install via `npm install`(recommended)
+
+```bash
+npm install --save @loopstack/sandbox-filesystem
+```
+
+Use npm install if you want to use and maintain the module as node dependency.
+
+- Use this, if you do not need to make changes to the code or want to review the source code.
+
+## Setup
+
+### 1. Manual setup (optional)
+
+> This step is automatically done for you when using the `loopstack add` command.
+
+- Add `SandboxFilesystemModule` to the imports of `default.module.ts` or any other custom module.
+
+See here for more information about working with [Modules](https://loopstack.ai/docs/building-with-loopstack/creating-a-module) and [Workspaces](https://loopstack.ai/docs/building-with-loopstack/creating-workspaces)
+
+### 2. Use in Your Workflow
+
+Inject the tools in your workflow class using the @Tool() decorator:
+
+```typescript
+import { Injectable } from '@nestjs/common';
+import { z } from 'zod';
+import { BlockConfig, Tool, WithArguments, WithState } from '@loopstack/common';
+import { WorkflowBase } from '@loopstack/core';
+import {
+  SandboxCreateDirectory,
+  SandboxDelete,
+  SandboxExists,
+  SandboxFileInfo,
+  SandboxListDirectory,
+  SandboxReadFile,
+  SandboxWriteFile,
+} from '@loopstack/sandbox-filesystem';
+import { SandboxDestroy, SandboxInit } from '@loopstack/sandbox-tool';
+
+@Injectable()
+@BlockConfig({
+  configFile: __dirname + '/my.workflow.yaml',
+})
+@WithArguments(
+  z.object({
+    outputDir: z.string().default(process.cwd() + '/out'),
+  }),
+)
+@WithState(
+  z.object({
+    containerId: z.string().optional(),
+    fileContent: z.string().optional(),
+    fileList: z.array(z.any()).optional(),
+  }),
+)
+export class MyWorkflow extends WorkflowBase {
+  // Sandbox lifecycle tools (from @loopstack/sandbox-tool)
+  @Tool() sandboxInit: SandboxInit;
+  @Tool() sandboxDestroy: SandboxDestroy;
+
+  // Filesystem tools (from @loopstack/sandbox-filesystem)
+  @Tool() sandboxWriteFile: SandboxWriteFile;
+  @Tool() sandboxReadFile: SandboxReadFile;
+  @Tool() sandboxListDirectory: SandboxListDirectory;
+  @Tool() sandboxCreateDirectory: SandboxCreateDirectory;
+  @Tool() sandboxDelete: SandboxDelete;
+  @Tool() sandboxExists: SandboxExists;
+  @Tool() sandboxFileInfo: SandboxFileInfo;
+}
+```
+
+And use them in your YAML workflow configuration:
+
+```yaml
+# src/my.workflow.yaml
+transitions:
+  # Initialize the sandbox container (required before filesystem operations)
+  - id: init_sandbox
+    from: start
+    to: sandbox_ready
+    call:
+      - tool: sandboxInit
+        args:
+          containerId: my-sandbox
+          imageName: node:18
+          containerName: my-filesystem-sandbox
+          projectOutPath: ${ args.outputDir }
+          rootPath: workspace
+        assign:
+          containerId: ${ result.data.containerId }
+
+  # Create a directory
+  - id: create_dir
+    from: sandbox_ready
+    to: dir_created
+    call:
+      - tool: sandboxCreateDirectory
+        args:
+          containerId: ${ containerId }
+          path: /workspace
+          recursive: true
+
+  # Write a file
+  - id: write_file
+    from: dir_created
+    to: file_written
+    call:
+      - tool: sandboxWriteFile
+        args:
+          containerId: ${ containerId }
+          path: /workspace/result.txt
+          content: 'Hello from sandbox!'
+          encoding: utf8
+          createParentDirs: true
+
+  # Read the file
+  - id: read_file
+    from: file_written
+    to: file_read
+    call:
+      - tool: sandboxReadFile
+        args:
+          containerId: ${ containerId }
+          path: /workspace/result.txt
+          encoding: utf8
+        assign:
+          fileContent: ${ result.data.content }
+
+  # List directory contents
+  - id: list_dir
+    from: file_read
+    to: dir_listed
+    call:
+      - tool: sandboxListDirectory
+        args:
+          containerId: ${ containerId }
+          path: /workspace
+          recursive: false
+        assign:
+          fileList: ${ result.data.entries }
+
+  # Check file existence
+  - id: check_exists
+    from: dir_listed
+    to: existence_checked
+    call:
+      - tool: sandboxExists
+        args:
+          containerId: ${ containerId }
+          path: /workspace/result.txt
+
+  # Get file info
+  - id: get_info
+    from: existence_checked
+    to: info_retrieved
+    call:
+      - tool: sandboxFileInfo
+        args:
+          containerId: ${ containerId }
+          path: /workspace/result.txt
+
+  # Delete the file
+  - id: delete_file
+    from: info_retrieved
+    to: file_deleted
+    call:
+      - tool: sandboxDelete
+        args:
+          containerId: ${ containerId }
+          path: /workspace/result.txt
+          force: true
+
+  # Destroy the sandbox container (cleanup)
+  - id: destroy_sandbox
+    from: file_deleted
+    to: end
+    call:
+      - tool: sandboxDestroy
+        args:
+          containerId: ${ containerId }
+          removeContainer: true
+```
+
+## About
+
+Author: Tobias Blättermann, Jakob Klippel
+
+License: Apache-2.0
+
+### Additional Resources:
+
+- [Loopstack Documentation](https://loopstack.ai)
+- [Getting Started with Loopstack](https://loopstack.ai)
+- For more examples how to use this tool look for `@loopstack/sandbox-filesystem` in the [Loopstack Registry](https://loopstack.ai/registry)

package/dist/index.d.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/dist/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./sandbox-filesystem.module"), exports);
+__exportStar(require("./tools/sandbox-read-file.tool"), exports);
+__exportStar(require("./tools/sandbox-write-file.tool"), exports);
+__exportStar(require("./tools/sandbox-list-directory.tool"), exports);
+__exportStar(require("./tools/sandbox-create-directory.tool"), exports);
+__exportStar(require("./tools/sandbox-delete.tool"), exports);
+__exportStar(require("./tools/sandbox-exists.tool"), exports);
+__exportStar(require("./tools/sandbox-file-info.tool"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA4C;AAC5C,iEAA+C;AAC/C,kEAAgD;AAChD,sEAAoD;AACpD,wEAAsD;AACtD,8DAA4C;AAC5C,8DAA4C;AAC5C,iEAA+C"}

package/dist/sandbox-filesystem.module.d.ts

@@ -0,0 +1,2 @@
+export declare class SandboxFilesystemModule {
+}

package/dist/sandbox-filesystem.module.js

@@ -0,0 +1,46 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SandboxFilesystemModule = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@loopstack/core");
+const sandbox_tool_1 = require("@loopstack/sandbox-tool");
+const sandbox_create_directory_tool_1 = require("./tools/sandbox-create-directory.tool");
+const sandbox_delete_tool_1 = require("./tools/sandbox-delete.tool");
+const sandbox_exists_tool_1 = require("./tools/sandbox-exists.tool");
+const sandbox_file_info_tool_1 = require("./tools/sandbox-file-info.tool");
+const sandbox_list_directory_tool_1 = require("./tools/sandbox-list-directory.tool");
+const sandbox_read_file_tool_1 = require("./tools/sandbox-read-file.tool");
+const sandbox_write_file_tool_1 = require("./tools/sandbox-write-file.tool");
+let SandboxFilesystemModule = class SandboxFilesystemModule {
+};
+exports.SandboxFilesystemModule = SandboxFilesystemModule;
+exports.SandboxFilesystemModule = SandboxFilesystemModule = __decorate([
+    (0, common_1.Module)({
+        imports: [core_1.LoopCoreModule, sandbox_tool_1.SandboxToolModule],
+        providers: [
+            sandbox_read_file_tool_1.SandboxReadFile,
+            sandbox_write_file_tool_1.SandboxWriteFile,
+            sandbox_list_directory_tool_1.SandboxListDirectory,
+            sandbox_create_directory_tool_1.SandboxCreateDirectory,
+            sandbox_delete_tool_1.SandboxDelete,
+            sandbox_exists_tool_1.SandboxExists,
+            sandbox_file_info_tool_1.SandboxFileInfo,
+        ],
+        exports: [
+            sandbox_read_file_tool_1.SandboxReadFile,
+            sandbox_write_file_tool_1.SandboxWriteFile,
+            sandbox_list_directory_tool_1.SandboxListDirectory,
+            sandbox_create_directory_tool_1.SandboxCreateDirectory,
+            sandbox_delete_tool_1.SandboxDelete,
+            sandbox_exists_tool_1.SandboxExists,
+            sandbox_file_info_tool_1.SandboxFileInfo,
+        ],
+    })
+], SandboxFilesystemModule);
+//# sourceMappingURL=sandbox-filesystem.module.js.map

package/dist/sandbox-filesystem.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-filesystem.module.js","sourceRoot":"","sources":["../src/sandbox-filesystem.module.ts"],"names":[],"mappings":";;;;;;;;;AAeA,2CAAwC;AACxC,0CAAiD;AACjD,0DAA4D;AAC5D,yFAA+E;AAC/E,qEAA4D;AAC5D,qEAA4D;AAC5D,2EAAiE;AACjE,qFAA2E;AAC3E,2EAAiE;AACjE,6EAAmE;AAuB5D,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;CAAG,CAAA;AAA1B,0DAAuB;kCAAvB,uBAAuB;IArBnC,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,qBAAc,EAAE,gCAAiB,CAAC;QAC5C,SAAS,EAAE;YACT,wCAAe;YACf,0CAAgB;YAChB,kDAAoB;YACpB,sDAAsB;YACtB,mCAAa;YACb,mCAAa;YACb,wCAAe;SAChB;QACD,OAAO,EAAE;YACP,wCAAe;YACf,0CAAgB;YAChB,kDAAoB;YACpB,sDAAsB;YACtB,mCAAa;YACb,mCAAa;YACb,wCAAe;SAChB;KACF,CAAC;GACW,uBAAuB,CAAG"}

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

@@ -0,0 +1,19 @@
+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 SandboxCreateDirectoryArgs = z.infer<typeof propertiesSchema>;
+interface SandboxCreateDirectoryResult {
+    path: string;
+    created: boolean;
+}
+export declare class SandboxCreateDirectory extends ToolBase<SandboxCreateDirectoryArgs> {
+    private readonly logger;
+    private sandboxCommand;
+    execute(args: SandboxCreateDirectoryArgs, _ctx: WorkflowExecution): Promise<ToolResult<SandboxCreateDirectoryResult>>;
+}
+export {};

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

@@ -0,0 +1,77 @@
+"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 SandboxCreateDirectory_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SandboxCreateDirectory = 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 create the directory in'),
+    path: zod_1.z.string().describe('The path of the directory to create'),
+    recursive: zod_1.z.boolean().default(true).describe("Whether to create parent directories if they don't exist"),
+})
+    .strict();
+let SandboxCreateDirectory = SandboxCreateDirectory_1 = class SandboxCreateDirectory extends core_1.ToolBase {
+    logger = new common_1.Logger(SandboxCreateDirectory_1.name);
+    sandboxCommand;
+    async execute(args, _ctx) {
+        const { containerId, path: dirPath, recursive } = args;
+        this.logger.debug(`Creating directory ${dirPath} in container ${containerId} (recursive: ${recursive})`);
+        const mkdirArgs = recursive ? ['-p', dirPath] : [dirPath];
+        const result = await this.sandboxCommand.execute({
+            containerId,
+            executable: 'mkdir',
+            args: mkdirArgs,
+            workingDirectory: '/',
+            timeout: 10000,
+        });
+        if (!result.data) {
+            this.logger.error(`Failed to create directory ${dirPath}: No result data`);
+            throw new Error(`Failed to create directory ${dirPath}: No result data`);
+        }
+        const alreadyExists = result.data.exitCode !== 0 && result.data.stderr.includes('File exists');
+        if (result.data.exitCode !== 0 && !alreadyExists) {
+            this.logger.error(`Failed to create directory ${dirPath}: ${result.data.stderr || 'Unknown error'}`);
+            throw new Error(`Failed to create directory ${dirPath}: ${result.data.stderr || 'Unknown error'}`);
+        }
+        if (alreadyExists) {
+            this.logger.debug(`Directory ${dirPath} already exists`);
+        }
+        else {
+            this.logger.log(`Successfully created directory ${dirPath} in container ${containerId}`);
+        }
+        return {
+            data: {
+                path: dirPath,
+                created: result.data.exitCode === 0,
+            },
+        };
+    }
+};
+exports.SandboxCreateDirectory = SandboxCreateDirectory;
+__decorate([
+    (0, common_2.Tool)(),
+    __metadata("design:type", sandbox_tool_1.SandboxCommand)
+], SandboxCreateDirectory.prototype, "sandboxCommand", void 0);
+exports.SandboxCreateDirectory = SandboxCreateDirectory = SandboxCreateDirectory_1 = __decorate([
+    (0, common_1.Injectable)(),
+    (0, common_2.BlockConfig)({
+        config: {
+            description: 'Create a directory in a sandbox container',
+        },
+    }),
+    (0, common_2.WithArguments)(propertiesSchema)
+], SandboxCreateDirectory);
+//# sourceMappingURL=sandbox-create-directory.tool.js.map

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

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

package/dist/tools/sandbox-delete.tool.d.ts

@@ -0,0 +1,20 @@
+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>;
+    force: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+type SandboxDeleteArgs = z.infer<typeof propertiesSchema>;
+interface SandboxDeleteResult {
+    path: string;
+    deleted: boolean;
+}
+export declare class SandboxDelete extends ToolBase<SandboxDeleteArgs> {
+    private readonly logger;
+    private sandboxCommand;
+    execute(args: SandboxDeleteArgs, _ctx: WorkflowExecution): Promise<ToolResult<SandboxDeleteResult>>;
+}
+export {};

package/dist/tools/sandbox-delete.tool.js

@@ -0,0 +1,77 @@
+"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 SandboxDelete_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SandboxDelete = 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 delete the file/directory from'),
+    path: zod_1.z.string().describe('The path to the file or directory to delete'),
+    recursive: zod_1.z.boolean().default(false).describe('Whether to recursively delete directories and their contents'),
+    force: zod_1.z.boolean().default(false).describe('Whether to force deletion without prompting for confirmation'),
+})
+    .strict();
+let SandboxDelete = SandboxDelete_1 = class SandboxDelete extends core_1.ToolBase {
+    logger = new common_1.Logger(SandboxDelete_1.name);
+    sandboxCommand;
+    async execute(args, _ctx) {
+        const { containerId, path: targetPath, recursive, force } = args;
+        this.logger.debug(`Deleting ${targetPath} in container ${containerId} (recursive: ${recursive}, force: ${force})`);
+        const rmArgs = [];
+        if (recursive)
+            rmArgs.push('-r');
+        if (force)
+            rmArgs.push('-f');
+        rmArgs.push(targetPath);
+        const result = await this.sandboxCommand.execute({
+            containerId,
+            executable: 'rm',
+            args: rmArgs,
+            workingDirectory: '/',
+            timeout: 30000,
+        });
+        if (!result.data) {
+            this.logger.error(`Failed to delete ${targetPath}: No result data`);
+            throw new Error(`Failed to delete ${targetPath}: No result data`);
+        }
+        if (result.data.exitCode !== 0) {
+            this.logger.error(`Failed to delete ${targetPath}: ${result.data.stderr || 'Unknown error'}`);
+            throw new Error(`Failed to delete ${targetPath}: ${result.data.stderr || 'Unknown error'}`);
+        }
+        this.logger.log(`Successfully deleted ${targetPath} in container ${containerId}`);
+        return {
+            data: {
+                path: targetPath,
+                deleted: true,
+            },
+        };
+    }
+};
+exports.SandboxDelete = SandboxDelete;
+__decorate([
+    (0, common_2.Tool)(),
+    __metadata("design:type", sandbox_tool_1.SandboxCommand)
+], SandboxDelete.prototype, "sandboxCommand", void 0);
+exports.SandboxDelete = SandboxDelete = SandboxDelete_1 = __decorate([
+    (0, common_1.Injectable)(),
+    (0, common_2.BlockConfig)({
+        config: {
+            description: 'Delete a file or directory in a sandbox container',
+        },
+    }),
+    (0, common_2.WithArguments)(propertiesSchema)
+], SandboxDelete);
+//# sourceMappingURL=sandbox-delete.tool.js.map

package/dist/tools/sandbox-delete.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-delete.tool.js","sourceRoot":"","sources":["../../src/tools/sandbox-delete.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,2DAA2D,CAAC;IAC7F,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACxE,SAAS,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,8DAA8D,CAAC;IAC9G,KAAK,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,8DAA8D,CAAC;CAC3G,CAAC;KACD,MAAM,EAAE,CAAC;AAgBL,IAAM,aAAa,qBAAnB,MAAM,aAAc,SAAQ,eAA2B;IAC3C,MAAM,GAAG,IAAI,eAAM,CAAC,eAAa,CAAC,IAAI,CAAC,CAAC;IAEzC,cAAc,CAAiB;IAE/C,KAAK,CAAC,OAAO,CAAC,IAAuB,EAAE,IAAuB;QAC5D,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAEjE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,UAAU,iBAAiB,WAAW,gBAAgB,SAAS,YAAY,KAAK,GAAG,CAAC,CAAC;QAEnH,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,SAAS;YAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAExB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC;YAC/C,WAAW;YACX,UAAU,EAAE,IAAI;YAChB,IAAI,EAAE,MAAM;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,oBAAoB,UAAU,kBAAkB,CAAC,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,oBAAoB,UAAU,kBAAkB,CAAC,CAAC;QACpE,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,UAAU,KAAK,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,eAAe,EAAE,CAAC,CAAC;YAC9F,MAAM,IAAI,KAAK,CAAC,oBAAoB,UAAU,KAAK,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,eAAe,EAAE,CAAC,CAAC;QAC9F,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,wBAAwB,UAAU,iBAAiB,WAAW,EAAE,CAAC,CAAC;QAElF,OAAO;YACL,IAAI,EAAE;gBACJ,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,IAAI;aACd;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AA1CY,sCAAa;AAGR;IAAf,IAAA,aAAI,GAAE;8BAAyB,6BAAc;qDAAC;wBAHpC,aAAa;IAPzB,IAAA,mBAAU,GAAE;IACZ,IAAA,oBAAW,EAAC;QACX,MAAM,EAAE;YACN,WAAW,EAAE,mDAAmD;SACjE;KACF,CAAC;IACD,IAAA,sBAAa,EAAC,gBAAgB,CAAC;GACnB,aAAa,CA0CzB"}

package/dist/tools/sandbox-exists.tool.d.ts

@@ -0,0 +1,20 @@
+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 SandboxExistsArgs = z.infer<typeof propertiesSchema>;
+interface SandboxExistsResult {
+    path: string;
+    exists: boolean;
+    type: 'file' | 'directory' | 'symlink' | 'other' | null;
+}
+export declare class SandboxExists extends ToolBase<SandboxExistsArgs> {
+    private readonly logger;
+    private sandboxCommand;
+    execute(args: SandboxExistsArgs, _ctx: WorkflowExecution): Promise<ToolResult<SandboxExistsResult>>;
+    private parseFileType;
+}
+export {};

package/dist/tools/sandbox-exists.tool.js

@@ -0,0 +1,89 @@
+"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 SandboxExists_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SandboxExists = 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 check for file existence'),
+    path: zod_1.z.string().describe('The path to check for existence'),
+})
+    .strict();
+let SandboxExists = SandboxExists_1 = class SandboxExists extends core_1.ToolBase {
+    logger = new common_1.Logger(SandboxExists_1.name);
+    sandboxCommand;
+    async execute(args, _ctx) {
+        const { containerId, path: targetPath } = args;
+        this.logger.debug(`Checking existence of ${targetPath} in container ${containerId}`);
+        const result = await this.sandboxCommand.execute({
+            containerId,
+            executable: 'sh',
+            args: [
+                '-c',
+                `if [ -e '${targetPath.replace(/'/g, "'\\''")}' ]; then stat -c '%F' '${targetPath.replace(/'/g, "'\\''")}'; else echo 'NOT_FOUND'; fi`,
+            ],
+            workingDirectory: '/',
+            timeout: 10000,
+        });
+        if (!result.data) {
+            this.logger.error(`Failed to check existence of ${targetPath}: No result data`);
+            throw new Error(`Failed to check existence of ${targetPath}: No result data`);
+        }
+        if (result.data.exitCode !== 0) {
+            this.logger.error(`Failed to check existence of ${targetPath}: ${result.data.stderr || 'Unknown error'}`);
+            throw new Error(`Failed to check existence of ${targetPath}: ${result.data.stderr || 'Unknown error'}`);
+        }
+        const output = result.data.stdout.trim();
+        const exists = output !== 'NOT_FOUND';
+        let type = null;
+        if (exists) {
+            type = this.parseFileType(output);
+        }
+        this.logger.debug(`Path ${targetPath} exists: ${exists}${exists ? `, type: ${type}` : ''}`);
+        return {
+            data: {
+                path: targetPath,
+                exists,
+                type,
+            },
+        };
+    }
+    parseFileType(statOutput) {
+        const lower = statOutput.toLowerCase();
+        if (lower.includes('regular'))
+            return 'file';
+        if (lower.includes('directory'))
+            return 'directory';
+        if (lower.includes('symbolic link'))
+            return 'symlink';
+        return 'other';
+    }
+};
+exports.SandboxExists = SandboxExists;
+__decorate([
+    (0, common_2.Tool)(),
+    __metadata("design:type", sandbox_tool_1.SandboxCommand)
+], SandboxExists.prototype, "sandboxCommand", void 0);
+exports.SandboxExists = SandboxExists = SandboxExists_1 = __decorate([
+    (0, common_1.Injectable)(),
+    (0, common_2.BlockConfig)({
+        config: {
+            description: 'Check if a file or directory exists in a sandbox container',
+        },
+    }),
+    (0, common_2.WithArguments)(propertiesSchema)
+], SandboxExists);
+//# sourceMappingURL=sandbox-exists.tool.js.map

package/dist/tools/sandbox-exists.tool.js.map

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