@intella/sdk 0.0.7 → 0.0.9

package/dist/sandbox/operations/git-operations.js

@@ -0,0 +1,235 @@
+function escapeForDoubleQuoted(s) {
+    return s
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"')
+        .replace(/\$/g, '\\$')
+        .replace(/`/g, '\\`');
+}
+function assertSuccess(result, context) {
+    const stderr = typeof result.stderr === 'string' ? result.stderr : String(result.stderr ?? '');
+    console.log(`[git-operations] ${context}: ${result.stdout || result.stderr}`);
+    if (result.exitCode !== 0) {
+        throw new Error(`${context}: ${stderr || 'command failed'}`);
+    }
+}
+export function buildGitAuthUrl(url, username, password) {
+    if (!username && !password)
+        return url;
+    try {
+        const u = new URL(url);
+        u.username = username ?? '';
+        u.password = password ?? '';
+        return u.toString();
+    }
+    catch {
+        return url;
+    }
+}
+/**
+ * Extract repository name from a git URL.
+ * Handles HTTPS and SSH URLs like:
+ * - https://github.com/user/repo.git
+ * - https://github.com/user/repo
+ * - git@github.com:user/repo.git
+ */
+export function extractRepoName(url) {
+    // Remove trailing slashes and .git suffix
+    const cleaned = url.replace(/\/+$/, '').replace(/\.git$/, '');
+    // Extract the last path segment
+    const match = cleaned.match(/[/:]([^/:]+)$/);
+    return match ? match[1] : 'repo';
+}
+/**
+ * Creates the default git implementation that uses executeCommand and createDirectory.
+ * Used by E2B, Modal, Vercel, and Local providers.
+ */
+export function createDefaultGitOperations(provider) {
+    return {
+        async clone(url, path, options) {
+            const branch = options?.branch;
+            const commitId = options?.commitId;
+            const username = options?.username;
+            const password = options?.password;
+            // Extract repo name from URL and use path as the parent directory
+            const repoName = extractRepoName(url);
+            const parent = path.replace(/\/+$/, '') || '.';
+            const dest = repoName;
+            // Create the parent directory if needed
+            if (parent !== '.') {
+                await provider.createDirectory(parent, { recursive: true });
+            }
+            // check if the repo already exists at path/repoName
+            const existsCmd = `test -d "${escapeForDoubleQuoted(dest)}/.git" && echo "exists" || echo "not_exists"`;
+            const existsResult = await provider.executeCommand(existsCmd, { cwd: parent });
+            const existsOutput = (typeof existsResult.stdout === 'string' ? existsResult.stdout : String(existsResult.stdout ?? '')).trim();
+            const repoExists = existsOutput === 'exists';
+            let shouldClone = true;
+            if (repoExists) {
+                const fullPath = parent === '.' ? dest : `${parent}/${dest}`;
+                console.info(`[git-operations] Repo already exists at ${fullPath}, skipping clone`);
+                if (options?.pullOnExists) {
+                    //  check current branch, if its different from the branch we want to checkout, fetch all remote branches and checkout the branch
+                    // else just pull
+                    // fetch all remote branches
+                    const currentBranchCmd = `git -C "${escapeForDoubleQuoted(fullPath)}" branch --show-current`;
+                    const currentBranchResult = await provider.executeCommand(currentBranchCmd);
+                    assertSuccess(currentBranchResult, 'git branch --show-current');
+                    const currentBranch = (typeof currentBranchResult.stdout === 'string' ? currentBranchResult.stdout : String(currentBranchResult.stdout ?? '')).trim();
+                    if (currentBranch !== branch) {
+                        const fetchCmd = `git -C "${escapeForDoubleQuoted(fullPath)}" fetch --all`;
+                        const fetchResult = await provider.executeCommand(fetchCmd);
+                        assertSuccess(fetchResult, 'git fetch --all');
+                        // checkout the branch
+                        if (branch) {
+                            const checkoutCmd = `git -C "${escapeForDoubleQuoted(fullPath)}" checkout "${escapeForDoubleQuoted(branch)}"`;
+                            const checkoutResult = await provider.executeCommand(checkoutCmd);
+                            assertSuccess(checkoutResult, 'git checkout');
+                        }
+                    }
+                    else {
+                        const pullCmd = `git -C "${escapeForDoubleQuoted(fullPath)}" pull`;
+                        const pullResult = await provider.executeCommand(pullCmd);
+                        assertSuccess(pullResult, 'git pull');
+                    }
+                }
+                shouldClone = false;
+            }
+            if (shouldClone) {
+                const authUrl = buildGitAuthUrl(url, username, password);
+                const branchFlag = branch ? `--branch "${escapeForDoubleQuoted(branch)}"` : '';
+                const cloneCmd = `git clone ${branchFlag} "${escapeForDoubleQuoted(authUrl)}" "${escapeForDoubleQuoted(dest)}"`;
+                const inner = `cd "${escapeForDoubleQuoted(parent)}" && ${cloneCmd}`;
+                const cmd = `sh -c "${inner.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+                const targetPath = parent === '.' ? dest : `${parent}/${dest}`;
+                console.info(`[git-operations] Cloning ${url} to ${targetPath}`);
+                console.log(cmd);
+                const result = await provider.executeCommand(cmd);
+                assertSuccess(result, 'git clone');
+            }
+            if (commitId) {
+                const fullPath = parent === '.' ? dest : `${parent}/${dest}`;
+                const checkCmd = `git -C "${escapeForDoubleQuoted(fullPath)}" checkout "${escapeForDoubleQuoted(commitId)}"`;
+                const checkResult = await provider.executeCommand(checkCmd);
+                assertSuccess(checkResult, 'git checkout (commitId)');
+            }
+        },
+        async status(path) {
+            const esc = escapeForDoubleQuoted(path);
+            const sbResult = await provider.executeCommand(`git -C "${esc}" status -sb`);
+            const shortResult = await provider.executeCommand(`git -C "${esc}" status --short`);
+            const sb = typeof sbResult.stdout === 'string' ? sbResult.stdout : String(sbResult.stdout ?? '');
+            const short = typeof shortResult.stdout === 'string' ? shortResult.stdout : String(shortResult.stdout ?? '');
+            let currentBranch = 'HEAD';
+            let ahead = 0;
+            let behind = 0;
+            const branchMatch = sb.match(/^##\s+(.+?)(?:\s+\.\.\.|\s*$)/m);
+            if (branchMatch) {
+                currentBranch = branchMatch[1].trim();
+            }
+            const aheadMatch = sb.match(/\[ahead\s+(\d+)/);
+            if (aheadMatch)
+                ahead = parseInt(aheadMatch[1], 10);
+            const behindMatch = sb.match(/behind\s+(\d+)\]/);
+            if (behindMatch)
+                behind = parseInt(behindMatch[1], 10);
+            const fileStatus = short
+                .split('\n')
+                .map((line) => line.trim())
+                .filter(Boolean)
+                .map((line) => {
+                const match = line.match(/^(.{2})\s+(.+)$/);
+                const staging = match ? match[1].trim().split('')[0] ?? undefined : undefined;
+                const worktree = match ? match[1].trim().split('')[1] ?? undefined : undefined;
+                const name = match ? match[2].trim() : line;
+                return { name, staging, worktree };
+            });
+            return { currentBranch, ahead, behind, fileStatus };
+        },
+        async branches(path) {
+            const esc = escapeForDoubleQuoted(path);
+            const result = await provider.executeCommand(`git -C "${esc}" branch`);
+            assertSuccess(result, 'git branch');
+            const out = typeof result.stdout === 'string' ? result.stdout : String(result.stdout ?? '');
+            const branches = out
+                .split('\n')
+                .map((line) => line.replace(/^\*?\s*/, '').trim())
+                .filter(Boolean);
+            return { branches };
+        },
+        async createBranch(path, name) {
+            const esc = escapeForDoubleQuoted(path);
+            const nameEsc = escapeForDoubleQuoted(name);
+            const result = await provider.executeCommand(`git -C "${esc}" branch "${nameEsc}"`);
+            assertSuccess(result, 'git branch (create)');
+        },
+        async checkoutBranch(path, branch) {
+            const esc = escapeForDoubleQuoted(path);
+            const branchEsc = escapeForDoubleQuoted(branch);
+            const result = await provider.executeCommand(`git -C "${esc}" checkout "${branchEsc}"`);
+            assertSuccess(result, 'git checkout');
+        },
+        async deleteBranch(path, name) {
+            const esc = escapeForDoubleQuoted(path);
+            const nameEsc = escapeForDoubleQuoted(name);
+            const result = await provider.executeCommand(`git -C "${esc}" branch -d "${nameEsc}"`);
+            assertSuccess(result, 'git branch -d');
+        },
+        async add(path, files) {
+            const esc = escapeForDoubleQuoted(path);
+            const filesEsc = files.map((f) => `"${escapeForDoubleQuoted(f)}"`).join(' ');
+            const result = await provider.executeCommand(`git -C "${esc}" add -- ${filesEsc}`);
+            assertSuccess(result, 'git add');
+        },
+        async commit(path, message, author, email, allowEmpty) {
+            const esc = escapeForDoubleQuoted(path);
+            const msgEsc = escapeForDoubleQuoted(message);
+            const authorEsc = escapeForDoubleQuoted(`${author} <${email}>`);
+            const allow = allowEmpty ? ' --allow-empty' : '';
+            const result = await provider.executeCommand(`git -C "${esc}" commit -m "${msgEsc}" --author="${authorEsc}"${allow}`);
+            assertSuccess(result, 'git commit');
+            const revResult = await provider.executeCommand(`git -C "${esc}" rev-parse HEAD`);
+            assertSuccess(revResult, 'git rev-parse');
+            const sha = (typeof revResult.stdout === 'string' ? revResult.stdout : String(revResult.stdout ?? '')).trim();
+            return { sha };
+        },
+        async push(path, username, password) {
+            const esc = escapeForDoubleQuoted(path);
+            if (username !== undefined || password !== undefined) {
+                const urlResult = await provider.executeCommand(`git -C "${esc}" config --get remote.origin.url`);
+                if (urlResult.exitCode !== 0)
+                    throw new Error('git push: no remote origin');
+                const originUrl = (typeof urlResult.stdout === 'string' ? urlResult.stdout : String(urlResult.stdout ?? '')).trim();
+                const authUrl = buildGitAuthUrl(originUrl, username, password);
+                const branchResult = await provider.executeCommand(`git -C "${esc}" branch --show-current`);
+                assertSuccess(branchResult, 'git branch --show-current');
+                const branch = (typeof branchResult.stdout === 'string' ? branchResult.stdout : String(branchResult.stdout ?? '')).trim();
+                const pushResult = await provider.executeCommand(`git -C "${esc}" push "${escapeForDoubleQuoted(authUrl)}" "${escapeForDoubleQuoted(branch)}"`);
+                assertSuccess(pushResult, 'git push');
+            }
+            else {
+                const result = await provider.executeCommand(`git -C "${esc}" push`);
+                assertSuccess(result, 'git push');
+            }
+        },
+        async pull(path, username, password) {
+            const esc = escapeForDoubleQuoted(path);
+            if (username !== undefined || password !== undefined) {
+                const urlResult = await provider.executeCommand(`git -C "${esc}" config --get remote.origin.url`);
+                if (urlResult.exitCode !== 0)
+                    throw new Error('git pull: no remote origin');
+                const originUrl = (typeof urlResult.stdout === 'string' ? urlResult.stdout : String(urlResult.stdout ?? '')).trim();
+                const authUrl = buildGitAuthUrl(originUrl, username, password);
+                const branchResult = await provider.executeCommand(`git -C "${esc}" branch --show-current`);
+                assertSuccess(branchResult, 'git branch --show-current');
+                const branch = (typeof branchResult.stdout === 'string' ? branchResult.stdout : String(branchResult.stdout ?? '')).trim();
+                const pullResult = await provider.executeCommand(`git -C "${esc}" pull "${escapeForDoubleQuoted(authUrl)}" "${escapeForDoubleQuoted(branch)}"`);
+                assertSuccess(pullResult, 'git pull');
+            }
+            else {
+                const result = await provider.executeCommand(`git -C "${esc}" pull`);
+                assertSuccess(result, 'git pull');
+            }
+        },
+    };
+}
+//# sourceMappingURL=git-operations.js.map

package/dist/sandbox/operations/git-operations.js.map

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

package/dist/sandbox/providers/base-provider.d.ts

@@ -0,0 +1,283 @@
+import type { SandboxProviderType, SandboxConfig, CommandResult, CodeExecutionResult, ISandboxProvider, SandboxInfo, SandboxCommand, WriteFileContent, WriteFileEntry, UploadFileEntry, ReadFileOptions, IGitOperations, RunCmdEntry, NpmInstallEntry, BunInstallEntry, AptInstallEntry, PipInstallEntry, GitCloneEntry, SessionMetadata, SessionInitSetup, TaskRequest, SandboxAgentStreamChunk, SessionMetadataCallable } from '../../types.js';
+import { AgentType, StreamEventType } from '../../types.js';
+import type { SandboxCommandResult, StreamEventsOptions } from '../../types.js';
+/**
+ * Base sandbox provider
+ * Abstract implementation that provides common functionality
+ */
+export declare abstract class BaseSandboxProvider implements ISandboxProvider {
+    protected initialized: boolean;
+    protected config: SandboxConfig;
+    protected sandboxId: string | null;
+    protected client: any | null;
+    readonly type: SandboxProviderType;
+    protected _git: IGitOperations;
+    constructor(type: SandboxProviderType, config?: SandboxConfig);
+    get git(): IGitOperations;
+    abstract getClient(): any;
+    /**
+     * Initialize/create a sandbox
+     * If fromSandboxId is provided in config, will call fromSandbox instead
+     * After initialization, runs any setup commands defined in config (runCmd, npmInstall, etc.)
+     */
+    initialize(config?: SandboxConfig): Promise<void>;
+    /**
+     * Provider-specific initialization (creates new sandbox)
+     */
+    protected abstract initializeSandbox(config?: SandboxConfig): Promise<void>;
+    /**
+     * Connect to an existing sandbox by ID
+     */
+    abstract fromSandbox(sandboxId: string, config?: SandboxConfig): Promise<any>;
+    /**
+     * Check if sandbox is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Close/cleanup the sandbox
+     */
+    abstract close(): Promise<void>;
+    /**
+     * Get sandbox ID
+     */
+    getSandboxId(): string | null;
+    /**
+     * Execute a command in the sandbox
+     * Handles detach option by wrapping with nohup if specified
+     */
+    executeCommand(command: string, options?: {
+        cwd?: string;
+        env?: Record<string, string>;
+        timeout?: number;
+        detach?: boolean;
+    }): Promise<CommandResult>;
+    /**
+     * Provider-specific command execution (implemented by each provider)
+     */
+    protected abstract executeCommandRaw(command: string, options?: {
+        cwd?: string;
+        env?: Record<string, string>;
+        timeout?: number;
+    }): Promise<CommandResult>;
+    /**
+     * Run code (e.g., Python, JavaScript) in the sandbox
+     */
+    abstract runCode(code: string, options?: {
+        language?: string;
+        env?: Record<string, string>;
+        timeout?: number;
+        onStdout?: (data: string) => void;
+        onStderr?: (data: string) => void;
+    }): Promise<CodeExecutionResult>;
+    /**
+     * Upload a file to the sandbox (single: source path or URL, remotePath; or batch entries).
+     * Resolves source to bytes in base, then calls writeFileSingle so providers need not duplicate fetch/read logic.
+     */
+    uploadFile(sourceOrEntries: string | UploadFileEntry[], remotePath?: string): Promise<void>;
+    /** Resolve source (path or URL) to bytes and write via writeFileSingle. Override only if provider needs different behavior. */
+    protected uploadFileSingle(source: string, remotePath: string): Promise<void>;
+    /**
+     * Download a file from the sandbox
+     */
+    abstract downloadFile(remotePath: string, localPath: string): Promise<void>;
+    /**
+     * Read a file from the sandbox (default format: text).
+     * Resolves bytes via readFileRaw, then converts to requested format via bytesToReadResult.
+     */
+    readFile(path: string, options?: ReadFileOptions): Promise<string | Uint8Array | Blob | ReadableStream<Uint8Array>>;
+    /** Provider implements reading file as raw bytes (Uint8Array). */
+    protected abstract readFileRaw(path: string): Promise<Uint8Array>;
+    /**
+     * Write file(s) to the sandbox (single path+content or batch entries)
+     */
+    writeFile(pathOrEntries: string | WriteFileEntry[], content?: WriteFileContent): Promise<void>;
+    /** Provider implements single-file write */
+    protected abstract writeFileSingle(path: string, content: WriteFileContent): Promise<void>;
+    /**
+     * Create a directory (recursive by default)
+     */
+    abstract createDirectory(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    /**
+     * List files in a directory
+     */
+    abstract listFiles(path: string): Promise<string[]>;
+    /**
+     * Check if a file exists
+     */
+    abstract fileExists(path: string): Promise<boolean>;
+    /**
+     * Delete a file
+     */
+    abstract deleteFile(path: string): Promise<void>;
+    /**
+     * Get host URL for a service running on the specified port
+     * @param port - The port number to get the host for
+     * @returns A URL string (e.g., "localhost:3000" or "https://sandbox-id.provider.com")
+     */
+    abstract getHost(port: number, timeout?: number): Promise<string>;
+    /**
+     * Get sandbox status
+     */
+    abstract getStatus(): Promise<{
+        isRunning: boolean;
+        createdAt?: number;
+        [key: string]: unknown;
+    }>;
+    /**
+     * Get detailed sandbox information
+     */
+    abstract getInfo(sandboxId?: string): Promise<SandboxInfo>;
+    /**
+     * Ensure sandbox is initialized before operation
+     */
+    protected ensureInitialized(): void;
+    /**
+     * Normalize path (remove leading/trailing slashes, handle ..)
+     */
+    protected normalizePath(path: string): string;
+    /**
+     * Run all config setup steps (runCmd, npmInstall, bunInstall, aptInstall, pipInstall, gitClone)
+     * Filters by run option (creation, resume, default) based on isResume flag
+     * Background entries are fired without awaiting
+     */
+    protected runConfigSetup(config: SandboxConfig, isResume: boolean): Promise<void>;
+    /**
+     * Run a command or batch of commands
+     * If detach is true, runs with nohup and pipes output to {command_name}.log
+     */
+    runCmd(entryOrEntries: RunCmdEntry | RunCmdEntry[]): Promise<CommandResult | CommandResult[]>;
+    /**
+     * Install npm package(s)
+     * If detach is true, runs with nohup and pipes output to log file
+     */
+    npmInstall(entryOrEntries: NpmInstallEntry | NpmInstallEntry[]): Promise<CommandResult | CommandResult[]>;
+    /**
+     * Track if bun has been installed in this session
+     */
+    private bunInstalled;
+    /**
+     * Ensure bun is installed, installing it if necessary
+     */
+    protected ensureBunInstalled(): Promise<void>;
+    /**
+     * Install bun package(s) - ensures bun is installed first
+     * If detach is true, runs with nohup and pipes output to log file
+     */
+    bunInstall(entryOrEntries: BunInstallEntry | BunInstallEntry[]): Promise<CommandResult | CommandResult[]>;
+    /**
+     * Track if apt-get update has been run in this session
+     */
+    private aptUpdated;
+    /**
+     * Install apt package(s)
+     * If detach is true, runs with nohup and pipes output to log file
+     */
+    aptInstall(entryOrEntries: AptInstallEntry | AptInstallEntry[]): Promise<CommandResult | CommandResult[]>;
+    /**
+     * Install pip package(s)
+     * If packages is empty array or empty string, uses -r requirements.txt
+     * If venv option is true, creates/uses .venv and updates .gitignore
+     * If detach is true, runs with nohup and pipes output to log file
+     */
+    pipInstall(entryOrEntries: PipInstallEntry | PipInstallEntry[]): Promise<CommandResult | CommandResult[]>;
+    /**
+     * Clone git repository(ies)
+     * - Uses options.path for target directory (from SetupExecutionOptions)
+     * - Supports autoInstall to auto-detect and install dependencies
+     * - Supports onSuccess to run commands after successful clone
+     */
+    gitCloneRepo(entryOrEntries: GitCloneEntry | GitCloneEntry[]): Promise<void>;
+    /**
+     * Check if the CLI daemon is running in this sandbox.
+     *
+     * @returns True if daemon is running, false otherwise
+     *
+     * @example
+     * ```typescript
+     * const isRunning = await sandbox.checkDaemonStatus();
+     * if (!isRunning) {
+     *   await sandbox.ensureDaemonRunning();
+     * }
+     * ```
+     */
+    checkDaemonStatus(): Promise<boolean>;
+    /**
+     * Ensure the CLI daemon is running in this sandbox.
+     * Checks status first, then starts the daemon if not running.
+     *
+     * @param options - Optional configuration
+     * @param options.startTimeout - Timeout in ms to wait for daemon to start (default: 3000)
+     * @param options.setSandboxId - Whether to set SANDBOX_ID env var (default: true)
+     *
+     * @example
+     * ```typescript
+     * await sandbox.ensureDaemonRunning();
+     * // Daemon is now running and ready to accept commands
+     * ```
+     */
+    ensureDaemonRunning(options?: {
+        startTimeout?: number;
+        setSandboxId?: boolean;
+    }): Promise<void>;
+    /**
+     * Create a session in the sandbox by running the intella CLI command.
+     *
+     * This method executes `intella session:init` inside the sandbox to create
+     * a new session with the specified configuration.
+     *
+     * @param options - Session creation options
+     * @returns The created session metadata
+     *
+     * @example
+     * ```typescript
+     * const session = await sandbox.createSession({
+     *   agentType: AgentType.CLAUDE,
+     *   model: 'sonnet',
+     * });
+     * console.log('Session created:', session.id);
+     * ```
+     */
+    createSession(options: {
+        sessionId?: string;
+        agentType: AgentType;
+        model?: string;
+        metadata?: Record<string, unknown>;
+        setup?: SessionInitSetup;
+    }): Promise<SessionMetadataCallable>;
+    /**
+     * Run setup steps for a session (git clone, npm install, etc.)
+     *
+     * @param sessionId - Session ID
+     * @param setup - Setup configuration
+     */
+    runSessionSetup(sessionId: string, setup: SessionInitSetup): Promise<void>;
+    /**
+     * End a session in the sandbox by running the intella CLI command.
+     *
+     * @param sessionId - Session ID to end
+     * @returns The ended session metadata
+     */
+    endSession(sessionId: string): Promise<SessionMetadata | null>;
+    /**
+     * Get a session from the sandbox by running the intella CLI command.
+     *
+     * @param sessionId - Session ID to get
+     * @returns The session metadata or null if not found
+     */
+    getSession(sessionId: string): Promise<SessionMetadata | null>;
+    /** Publish a command to this sandbox's Redis stream */
+    publishCommand(command: SandboxCommand, redisUrl?: string): Promise<string>;
+    /** Stream events from Session or Sandbox Redis stream (Sandbox uses this instance's ID) */
+    streamEvents(eventType: StreamEventType, options?: StreamEventsOptions): AsyncIterable<SandboxAgentStreamChunk | SandboxCommandResult>;
+    /**
+     * Publish agent:execute command and stream response from session (requires taskRequest.sessionId).
+     * Convenience wrapper around publishCommand + readFromSession.
+     */
+    executeAgent(taskRequest: TaskRequest, agentType?: AgentType, options?: {
+        redisUrl?: string;
+        apiKeys?: Record<string, string>;
+    }): AsyncIterable<SandboxAgentStreamChunk>;
+}
+//# sourceMappingURL=base-provider.d.ts.map

package/dist/sandbox/providers/base-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-provider.d.ts","sourceRoot":"","sources":["../../../src/sandbox/providers/base-provider.ts"],"names":[],"mappings":"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"}