@intella/sdk 0.0.1 → 0.0.2

package/src/sandbox/modal-provider.ts

@@ -1,597 +0,0 @@
-import { BaseSandboxProvider } from './base-provider.js';
-import type { SandboxConfig, CommandResult, CodeExecutionResult, SandboxInfo } from '../types.js';
-import { ModalClient, Sandbox } from 'modal';
-
-/**
- * Modal Sandbox Provider
- * Provides sandbox execution capabilities using Modal
- */
-export class ModalSandboxProvider extends BaseSandboxProvider {
-  protected client: ModalClient | null = null;
-  private sandboxInstance: Sandbox | null = null;
-  private app: any | null = null;
-  private image: any | null = null;
-
-  constructor(config?: SandboxConfig) {
-    super('modal');
-    if (config) {
-      this.config = config;
-    }
-  }
-
-  getClient(): ModalClient {
-    if (!this.client) {
-      const tokenId = this.config.apiKey || process.env.MODAL_TOKEN_ID;
-      const tokenSecret = process.env.MODAL_TOKEN_SECRET;
-      if (tokenId && tokenSecret) {
-        this.client = new ModalClient({
-          tokenId,
-          tokenSecret,
-        });
-      } else {
-        console.warn('Modal token ID and secret are not set. Using environment variables.');
-        try {
-          this.client = new ModalClient();
-        } catch (error) {
-          throw new Error('Failed to initialize Modal client: ' + (error instanceof Error ? error.message : String(error)));
-        }
-      }
-    }
-    return this.client;
-  }
-
-  /**
-   * Initialize/create a Modal sandbox
-   */
-  protected async initializeSandbox(config?: SandboxConfig): Promise<void> {
-    if (config) {
-      this.config = { ...this.config, ...config };
-    }
-
-    try {
-      // Dynamic import to handle optional dependency
-
-      // Initialize Modal client
-      // ModalClient can be initialized without parameters if MODAL_TOKEN_ID and MODAL_TOKEN_SECRET are in env
-      const modalClient = this.getClient()!;
-
-      // Get or create app
-      const appName = (this.config.appName as string) || 'intella-sandbox';
-      this.app = await modalClient.apps.fromName(appName, {
-        createIfMissing: true,
-      });
-
-      // Create or get image
-      const imageName = (this.config.imageName as string) || 'python:3.13-slim';
-      if (imageName.includes(':')) {
-        // Registry image (e.g., "python:3.13-slim")
-        this.image = modalClient.images.fromRegistry(imageName);
-      } else {
-        // Try named image first, fallback to registry if not found
-        try {
-          this.image = modalClient.images.fromId(this.config.fromSandboxId || '');
-        } catch {
-          // If named image doesn't exist, try as registry image
-          this.image = modalClient.images.fromRegistry(imageName);
-        }
-      }
-
-      // Create sandbox with configuration
-      const sandboxOptions: any = {
-        timeout: Math.floor((this.config.timeout || 5 * 60 * 1000) / 1000), // Convert to seconds
-      };
-
-      if (this.config.env) {
-        const secret = await modalClient.secrets.fromObject(this.config.env);
-        sandboxOptions.secrets = [secret];
-      }
-
-      if (this.config.workdir) {
-        sandboxOptions.workdir = this.config.workdir;
-      }
-
-      this.sandboxInstance = await modalClient.sandboxes.create(
-        this.app,
-        this.image,
-        sandboxOptions
-      );
-
-      this.sandboxId = this.sandboxInstance.sandboxId || '';
-      this.initialized = true;
-    } catch (error) {
-      throw new Error(
-        `Failed to initialize Modal sandbox: ${error instanceof Error ? error.message : String(error)}`
-      );
-    }
-  }
-
-  /**
-   * Connect to an existing Modal sandbox by ID
-   */
-  async fromSandbox(sandboxId: string, config?: SandboxConfig): Promise<Sandbox> {
-    if (config) {
-      this.config = { ...this.config, ...config };
-    }
-
-    try {
-      // Initialize Modal client
-      const modalClient = this.getClient()!;
-
-      // Get or create app (needed for fromId)
-      const appName = (this.config.appName as string) || 'intella-sandbox';
-      this.app = await modalClient.apps.fromName(appName, {
-        createIfMissing: true,
-      });
-
-      // Get existing sandbox by ID
-      this.sandboxInstance = await modalClient.sandboxes.fromId(sandboxId);
-
-      this.sandboxId = this.sandboxInstance.sandboxId || sandboxId;
-      this.initialized = true;
-      return this.sandboxInstance;
-    } catch (error) {
-      throw new Error(
-        `Failed to connect to Modal sandbox: ${error instanceof Error ? error.message : String(error)}`
-      );
-    }
-  }
-
-  /**
-   * Close/cleanup the Modal sandbox
-   */
-  async close(): Promise<void> {
-    if (this.sandboxInstance && this.initialized) {
-      try {
-        await this.sandboxInstance.terminate();
-      } catch (error) {
-        // Ignore errors during cleanup
-        console.warn('Error closing Modal sandbox:', error);
-      }
-      this.sandboxInstance = null;
-      this.client = null;
-      this.app = null;
-      this.image = null;
-      this.sandboxId = null;
-      this.initialized = false;
-    }
-  }
-
-  /**
-   * Execute a command in the Modal sandbox
-   */
-  async executeCommand(
-    command: string,
-    options?: {
-      cwd?: string;
-      env?: Record<string, string>;
-      timeout?: number;
-    }
-  ): Promise<CommandResult> {
-    this.ensureInitialized();
-
-    const startTime = Date.now();
-    try {
-      // Parse command string into array
-      // Handle quoted arguments properly
-      const commandParts = command.match(/(?:[^\s"]+|"[^"]*")+/g) || [command];
-      const cmdArray = commandParts.map((part) => part.replace(/^"|"$/g, ''));
-
-      const execOptions: any = {
-        timeout: Math.floor((options?.timeout || this.config.timeout || 3000) / 1000), // Convert to seconds
-      };
-
-      // Execute command
-      const process = await this.sandboxInstance!.exec(cmdArray, execOptions);
-
-      // Read stdout and stderr
-      let stdout = '';
-      let stderr = '';
-
-      // Read stdout
-      try {
-        stdout = await process.stdout.readText();
-      } catch (e) {
-        // If readText is not available, try iterating
-        if (process.stdout && typeof process.stdout[Symbol.asyncIterator] === 'function') {
-          for await (const chunk of process.stdout) {
-            stdout += typeof chunk === 'string' ? chunk : [chunk as string].toString();
-          }
-        }
-      }
-
-      // Read stderr
-      try {
-        stderr = await process.stderr.readText();
-      } catch (e) {
-        // If readText is not available, try iterating
-        if (process.stderr && typeof process.stderr[Symbol.asyncIterator] === 'function') {
-          for await (const chunk of process.stderr) {
-            stderr += typeof chunk === 'string' ? chunk : [chunk as string].toString();
-          }
-        }
-      }
-
-      // Wait for process to complete
-      await process.wait();
-
-      const executionTime = Date.now() - startTime;
-
-      return {
-        exitCode: process.returncode || 0,
-        stdout: stdout || '',
-        stderr: stderr || '',
-        executionTime,
-      };
-    } catch (error) {
-      const executionTime = Date.now() - startTime;
-      return {
-        exitCode: 1,
-        stdout: '',
-        stderr: error instanceof Error ? error.message : String(error),
-        executionTime,
-      };
-    }
-  }
-
-  /**
-   * Run code (e.g., Python, JavaScript) in the Modal sandbox
-   */
-  async runCode(
-    code: string,
-    options?: {
-      language?: string;
-      env?: Record<string, string>;
-      timeout?: number;
-      onStdout?: (data: string) => void;
-      onStderr?: (data: string) => void;
-    }
-  ): Promise<CodeExecutionResult> {
-    this.ensureInitialized();
-
-    const startTime = Date.now();
-    try {
-      // Determine interpreter based on language
-      const language = options?.language || 'python';
-      const interpreterMap: Record<string, string[]> = {
-        python: ['python', '-c'],
-        javascript: ['node', '-e'],
-        typescript: ['ts-node', '-e'],
-        bash: ['bash', '-c'],
-        sh: ['sh', '-c'],
-      };
-
-      const interpreter = interpreterMap[language.toLowerCase()] || ['python', '-c'];
-
-      const execOptions: any = {
-        timeout: (options?.timeout || this.config.timeout || 30000) / 1000, // Convert to seconds
-      };
-
-      // Execute code
-      const process = await this.sandboxInstance!.exec(
-        [...interpreter, code],
-        execOptions
-      );
-
-      // Stream stdout/stderr if callbacks provided
-      const stdoutChunks: string[] = [];
-      const stderrChunks: string[] = [];
-
-      // Handle stdout
-      if (options?.onStdout && process.stdout && typeof process.stdout[Symbol.asyncIterator] === 'function') {
-        // Stream mode with callback
-        for await (const line of process.stdout) {
-          const text = typeof line === 'string' ? line : [line as string].toString();
-          stdoutChunks.push(text);
-          options.onStdout(text);
-        }
-      } else {
-        // Read all at once
-        try {
-          const stdoutText = await process.stdout.readText();
-          const lines = stdoutText.split('\n');
-          stdoutChunks.push(...lines);
-        } catch (e) {
-          // Fallback to iteration
-          if (process.stdout && typeof process.stdout[Symbol.asyncIterator] === 'function') {
-            for await (const line of process.stdout) {
-              const text = typeof line === 'string' ? line : [line as string].toString();
-              stdoutChunks.push(text);
-            }
-          }
-        }
-      }
-
-      // Handle stderr
-      if (options?.onStderr && process.stderr && typeof process.stderr[Symbol.asyncIterator] === 'function') {
-        // Stream mode with callback
-        for await (const line of process.stderr) {
-          const text = typeof line === 'string' ? line : [line as string].toString();
-          stderrChunks.push(text);
-          options.onStderr(text);
-        }
-      } else {
-        // Read all at once
-        try {
-          const stderrText = await process.stderr.readText();
-          const lines = stderrText.split('\n');
-          stderrChunks.push(...lines);
-        } catch (e) {
-          // Fallback to iteration
-          if (process.stderr && typeof process.stderr[Symbol.asyncIterator] === 'function') {
-            for await (const line of process.stderr) {
-              const text = typeof line === 'string' ? line : [line as string].toString();
-              stderrChunks.push(text);
-            }
-          }
-        }
-      }
-
-      // Wait for process to complete
-      await process.wait();
-
-      const stdout = stdoutChunks.join('\n');
-      const stderr = stderrChunks.join('\n');
-      const executionTime = Date.now() - startTime;
-
-      return {
-        text: stdout || undefined,
-        results: stdout ? [{ text: stdout }] : [],
-        stdout: stdoutChunks,
-        stderr: stderrChunks,
-        error:
-          process.returncode !== 0
-            ? {
-              name: 'CodeExecutionError',
-              value: stderr || 'Code execution failed',
-              traceback: stderr || '',
-            }
-            : undefined,
-        executionTime,
-      };
-    } catch (error) {
-      const executionTime = Date.now() - startTime;
-      return {
-        text: undefined,
-        results: [],
-        stdout: [],
-        stderr: [error instanceof Error ? error.message : String(error)],
-        error: {
-          name: 'CodeExecutionError',
-          value: error instanceof Error ? error.message : String(error),
-          traceback: error instanceof Error ? error.stack || '' : '',
-        },
-        executionTime,
-      };
-    }
-  }
-
-  /**
-   * Upload a file to the Modal sandbox
-   * Uses the filesystem API
-   */
-  async uploadFile(localPath: string, remotePath: string): Promise<void> {
-    this.ensureInitialized();
-
-    try {
-      const fs = await import('fs/promises');
-      const content = await fs.readFile(localPath);
-
-      // Use filesystem API to write file
-      const file = await this.sandboxInstance!.open(remotePath, 'w');
-      await file.write(content);
-      file.close();
-    } catch (error) {
-      throw new Error(
-        `Failed to upload file to Modal sandbox: ${error instanceof Error ? error.message : String(error)}`
-      );
-    }
-  }
-
-  /**
-   * Download a file from the Modal sandbox
-   * Uses the filesystem API
-   */
-  async downloadFile(remotePath: string, localPath: string): Promise<void> {
-    this.ensureInitialized();
-
-    try {
-      // Use filesystem API to read file
-      const file = await this.sandboxInstance!.open(remotePath, 'r');
-      const content = await file.read();
-      file.close();
-
-      const fs = await import('fs/promises');
-      // Handle Buffer or Uint8Array
-      const buffer = Buffer.isBuffer(content) ? content : Buffer.from(content);
-      await fs.writeFile(localPath, buffer);
-    } catch (error) {
-      throw new Error(
-        `Failed to download file from Modal sandbox: ${error instanceof Error ? error.message : String(error)}`
-      );
-    }
-  }
-
-  /**
-   * Read a file from the Modal sandbox
-   * Uses the filesystem API
-   */
-  async readFile(path: string): Promise<string> {
-    this.ensureInitialized();
-
-    try {
-      // Use filesystem API to read file
-      const file = await this.sandboxInstance!.open(path, 'r');
-      const content = await file.read();
-      file.close();
-      return typeof content === 'string' ? content : [content as unknown as string].toString();
-    } catch (error) {
-      throw new Error(
-        `Failed to read file from Modal sandbox: ${error instanceof Error ? error.message : String(error)}`
-      );
-    }
-  }
-
-  /**
-   * Write a file to the Modal sandbox
-   * Uses the filesystem API
-   */
-  async writeFile(path: string, content: string): Promise<void> {
-    this.ensureInitialized();
-
-    try {
-      // Use filesystem API to write file
-      const file = await this.sandboxInstance!.open(path, 'w');
-      file.write(Buffer.from(content, 'utf-8'));
-      file.close();
-    } catch (error) {
-      throw new Error(
-        `Failed to write file to Modal sandbox: ${error instanceof Error ? error.message : String(error)}`
-      );
-    }
-  }
-
-  /**
-   * List files in a directory
-   * Uses exec to run ls command
-   */
-  async listFiles(path: string): Promise<string[]> {
-    this.ensureInitialized();
-
-    try {
-      const process = await this.sandboxInstance!.exec(['ls', '-1', path], {
-        timeoutMs: 5000,
-      });
-
-      let output = '';
-      try {
-        output = await process.stdout.readText();
-      } catch (e) {
-        // Fallback to iteration
-        if (process.stdout && typeof process.stdout[Symbol.asyncIterator] === 'function') {
-          for await (const chunk of process.stdout) {
-            output += typeof chunk === 'string' ? chunk : [chunk as string].toString();
-          }
-        }
-      }
-
-      await process.wait();
-
-      // Parse ls output
-      return output
-        .split('\n')
-        .map((line: string) => line.trim())
-        .filter((line: string) => line.length > 0);
-    } catch (error) {
-      throw new Error(
-        `Failed to list files in Modal sandbox: ${error instanceof Error ? error.message : String(error)}`
-      );
-    }
-  }
-
-  /**
-   * Check if a file exists
-   */
-  async fileExists(path: string): Promise<boolean> {
-    this.ensureInitialized();
-
-    try {
-      const process = await this.sandboxInstance!.exec(['test', '-f', path], {
-        timeoutMs: 5000,
-      });
-      await process.wait();
-      return (process.returncode || 0) === 0;
-    } catch {
-      return false;
-    }
-  }
-
-  /**
-   * Delete a file
-   * Uses exec to run rm command
-   */
-  async deleteFile(path: string): Promise<void> {
-    this.ensureInitialized();
-
-    try {
-      const process = await this.sandboxInstance!.exec(['rm', path], {
-        timeoutMs: 5000,
-      });
-      await process.wait();
-
-      if ((process.returncode || 0) !== 0) {
-        let stderr = '';
-        try {
-          stderr = await process.stderr.readText();
-        } catch (e) {
-          // Ignore read errors
-        }
-        throw new Error(`Failed to delete file: ${stderr || 'Unknown error'}`);
-      }
-    } catch (error) {
-      throw new Error(
-        `Failed to delete file in Modal sandbox: ${error instanceof Error ? error.message : String(error)}`
-      );
-    }
-  }
-
-  /**
-   * Get sandbox status
-   */
-  async getStatus(): Promise<{
-    isRunning: boolean;
-    createdAt?: number;
-    [key: string]: unknown;
-  }> {
-    this.ensureInitialized();
-
-    try {
-      // Modal sandboxes don't expose a direct status endpoint
-      // We can check if the sandbox instance is available
-      return {
-        isRunning: this.initialized && this.sandboxInstance !== null,
-        sandboxId: this.sandboxId,
-      };
-    } catch {
-      return {
-        isRunning: false,
-      };
-    }
-  }
-
-  /**
-   * Get detailed sandbox information
-   */
-  async getInfo(sandboxId?: string): Promise<SandboxInfo> {
-
-    if (!sandboxId && this.sandboxInstance) {
-      this.ensureInitialized();
-      const info = this.sandboxInstance
-      const isRunning = await info.poll();
-      return {
-        sandboxId: this.sandboxId!,
-        provider: this.type,
-        isRunning: isRunning === null,
-        isInitialized: this.initialized,
-        createdAt: new Date(),
-        metadata: {
-          error: isRunning
-        },
-        info: this.sandboxInstance,
-      };
-    } else if (sandboxId) {
-      const sandbox = await this.client!.sandboxes.fromId(sandboxId);
-      const isRunning = await sandbox.poll();
-      return {
-        sandboxId: sandbox.sandboxId,
-        provider: this.type,
-        isRunning: isRunning === null,
-        isInitialized: this.initialized,
-        createdAt: new Date(),
-        metadata: {},
-        info: sandbox,
-      };
-    } else {
-      throw new Error('Sandbox ID or active instance is required to get sandbox info');
-    }
-  }
-}