@hasna/sandboxes 0.1.26 → 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/mcp/http.d.ts

@@ -1,7 +1,6 @@
 import { type Server } from "node:http";
-export declare const DEFAULT_MCP_HTTP_PORT = 8875;
+export declare const DEFAULT_MCP_HTTP_PORT = 8831;
 export declare function isHttpMode(argv: string[]): boolean;
-export declare function isStdioMode(argv: string[]): boolean;
 export declare function resolveMcpHttpPort(argv: string[]): number;
 export declare function healthPayload(name?: string): {
     status: string;

package/dist/mcp/index.js

@@ -16930,9 +16930,9 @@ function buildServer() {
 import { createServer } from "http";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
-var DEFAULT_MCP_HTTP_PORT = 8875;
-function isStdioMode(argv) {
-  return argv.includes("--stdio") || process.env["MCP_STDIO"] === "1";
+var DEFAULT_MCP_HTTP_PORT = 8831;
+function isHttpMode(argv) {
+  return argv.includes("--http") || process.env["MCP_HTTP"] === "1";
 }
 function resolveMcpHttpPort(argv) {
   const portIdx = argv.indexOf("--port");
@@ -17014,12 +17014,12 @@ if (handleCliFlags(argv)) {
   process.exit(0);
 }
 async function main() {
-  if (isStdioMode(argv)) {
-    const server = buildServer();
-    const transport = new StdioServerTransport;
-    await server.connect(transport);
+  if (isHttpMode(argv)) {
+    startMcpHttpServer({ port: resolveMcpHttpPort(argv) });
     return;
   }
-  startMcpHttpServer({ port: resolveMcpHttpPort(argv) });
+  const server = buildServer();
+  const transport = new StdioServerTransport;
+  await server.connect(transport);
 }
 main().catch(console.error);

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.26",
+  "version": "0.1.27",
   "author": "Andrei Hasna <andrei@hasna.com>",
   "repository": {
     "type": "git",