@hasna/sandboxes 0.1.25 → 0.1.27

package/dist/index.d.ts

@@ -15,7 +15,7 @@ export { BUILTIN_IMAGES, resolveImage, getBuiltinImageSetupScript } from "./lib/
 export { getProvider } from "./providers/index.js";
 export type { SandboxProvider, ProviderSandbox, CreateSandboxOpts, ExecOptions } from "./providers/types.js";
 export { SandboxesSDK, createSandboxesSDK, } from "./sdk.js";
-export type { ExecCommandResult, ProviderFactory, RunAgentOptions, SandboxesSDKOptions, WaitForSessionOptions, } from "./sdk.js";
+export type { ExecCommandResult, ProviderFactory, RunAgentOptions, RunCommandInSandboxOptions, RunCommandInSandboxResult, RunCommandInSandboxUploadOptions, SandboxesSDKOptions, OneShotSandboxCleanup, WaitForSessionOptions, } from "./sdk.js";
 export { createStreamCollector, addStreamListener, emitLifecycleEvent } from "./lib/stream.js";
 export { getAgentDriver, listAgentDrivers } from "./lib/agents/index.js";
 export type { AgentDriver } from "./lib/agents/types.js";

package/dist/index.js

@@ -11643,6 +11643,49 @@ class SandboxesSDK {
     emitLifecycleEvent(sandbox.id, `uploaded ${localDir} -> ${remoteDir} (${result.bytes} bytes)`);
     return result;
   }
+  async runCommandInSandbox(input) {
+    const cleanupMode = input.cleanup ?? "delete";
+    const sandbox = await this.createSandbox({
+      provider: input.provider,
+      name: input.name,
+      image: input.image,
+      timeout: input.sandboxTimeout,
+      env_vars: input.sandboxEnvVars,
+      config: input.config,
+      project_id: input.projectId
+    });
+    let upload;
+    let exec;
+    try {
+      if (input.upload) {
+        upload = await this.uploadDir(sandbox.id, input.upload.localDir, input.upload.remoteDir, { exclude: input.upload.exclude });
+      }
+      exec = await this.execCommand(sandbox.id, input.command, {
+        cwd: input.cwd ?? input.upload?.remoteDir,
+        env: input.callEnvVars,
+        timeout: input.commandTimeoutMs,
+        onStdout: input.onStdout,
+        onStderr: input.onStderr
+      });
+    } finally {
+      if (cleanupMode === "delete") {
+        await this.deleteSandbox(sandbox.id);
+      } else if (cleanupMode === "stop") {
+        await this.stopSandbox(sandbox.id);
+      }
+    }
+    if (!exec) {
+      throw new Error("Sandbox command did not produce an execution result");
+    }
+    return {
+      sandbox,
+      session: exec.session,
+      result: exec.result,
+      upload,
+      remoteDir: input.upload?.remoteDir,
+      cleanup: cleanupMode === "delete" ? "deleted" : cleanupMode === "stop" ? "stopped" : "kept"
+    };
+  }
   async runAgent(sandboxId, opts) {
     const sandbox = this.requireProviderSandbox(sandboxId);
     const provider = await this.getProvider(sandbox.provider);

package/dist/sdk.d.ts

@@ -15,6 +15,37 @@ export interface ExecCommandResult {
     session: SandboxSession;
     result: ExecResult;
 }
+export type OneShotSandboxCleanup = "delete" | "stop" | "keep";
+export interface RunCommandInSandboxUploadOptions {
+    localDir: string;
+    remoteDir: string;
+    exclude?: string[];
+}
+export interface RunCommandInSandboxOptions {
+    command: string;
+    provider?: SandboxProviderName;
+    name?: string;
+    image?: string;
+    sandboxTimeout?: number;
+    commandTimeoutMs?: number;
+    projectId?: string;
+    config?: Record<string, unknown>;
+    sandboxEnvVars?: Record<string, string>;
+    callEnvVars?: Record<string, string>;
+    cwd?: string;
+    upload?: RunCommandInSandboxUploadOptions;
+    cleanup?: OneShotSandboxCleanup;
+    onStdout?: (data: string) => void;
+    onStderr?: (data: string) => void;
+}
+export interface RunCommandInSandboxResult {
+    sandbox: Sandbox;
+    session: SandboxSession;
+    result: ExecResult;
+    upload?: UploadDirResult;
+    remoteDir?: string;
+    cleanup: "deleted" | "stopped" | "kept";
+}
 export interface RunAgentOptions {
     agentType: AgentType;
     prompt: string;
@@ -54,6 +85,7 @@ export declare class SandboxesSDK {
         glob?: string;
     }): Promise<FileInfo[]>;
     uploadDir(sandboxId: string, localDir: string, remoteDir: string, opts?: UploadDirOptions): Promise<UploadDirResult>;
+    runCommandInSandbox(input: RunCommandInSandboxOptions): Promise<RunCommandInSandboxResult>;
     runAgent(sandboxId: string, opts: RunAgentOptions): Promise<SandboxSession>;
     getSession(sessionId: string): SandboxSession;
     waitForSession(sessionId: string, opts?: WaitForSessionOptions): Promise<SandboxSession>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/sandboxes",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "author": "Andrei Hasna <andrei@hasna.com>",
   "repository": {
     "type": "git",