fix: surface agent stderr in RPC errors & add defaultCwd param (#278)

sdks/typescript/src/client.ts

@@ -1127,7 +1127,7 @@ export class SandboxAgent {
 
     const localSessionId = request.id?.trim() || randomId();
     const live = await this.getLiveConnection(request.agent.trim());
-    const sessionInit = normalizeSessionInit(request.sessionInit, request.cwd);
+    const sessionInit = normalizeSessionInit(request.sessionInit, request.cwd, this.sandboxProvider?.defaultCwd);
 
     const response = await live.createRemoteSession(localSessionId, sessionInit);
 
@@ -1183,7 +1183,7 @@ export class SandboxAgent {
     const replaySource = await this.collectReplayEvents(existing.id, this.replayMaxEvents);
     const replayText = buildReplayText(replaySource, this.replayMaxChars);
 
-    const recreated = await live.createRemoteSession(existing.id, normalizeSessionInit(existing.sessionInit));
+    const recreated = await live.createRemoteSession(existing.id, normalizeSessionInit(existing.sessionInit, undefined, this.sandboxProvider?.defaultCwd));
 
     const updated: SessionRecord = {
       ...existing,
@@ -2657,17 +2657,21 @@ function toAgentQuery(options: AgentQueryOptions | undefined): Record<string, Qu
   };
 }
 
-function normalizeSessionInit(value: Omit<NewSessionRequest, "_meta"> | undefined, cwdShorthand?: string): Omit<NewSessionRequest, "_meta"> {
+function normalizeSessionInit(
+  value: Omit<NewSessionRequest, "_meta"> | undefined,
+  cwdShorthand?: string,
+  providerDefaultCwd?: string,
+): Omit<NewSessionRequest, "_meta"> {
   if (!value) {
     return {
-      cwd: cwdShorthand ?? defaultCwd(),
+      cwd: cwdShorthand ?? providerDefaultCwd ?? defaultCwd(),
       mcpServers: [],
     };
   }
 
   return {
     ...value,
-    cwd: value.cwd ?? cwdShorthand ?? defaultCwd(),
+    cwd: value.cwd ?? cwdShorthand ?? providerDefaultCwd ?? defaultCwd(),
     mcpServers: value.mcpServers ?? [],
   };
 }

sdks/typescript/src/providers/cloudflare.ts

@@ -36,6 +36,7 @@ export function cloudflare(options: CloudflareProviderOptions): SandboxProvider
 
   return {
     name: "cloudflare",
+    defaultCwd: "/root",
     async create(): Promise<string> {
       if (typeof sdk.create !== "function") {
         throw new Error('sandbox provider "cloudflare" requires a sdk with a `create()` method.');

sdks/typescript/src/providers/computesdk.ts

@@ -21,6 +21,7 @@ export function computesdk(options: ComputeSdkProviderOptions = {}): SandboxProv
 
   return {
     name: "computesdk",
+    defaultCwd: "/root",
     async create(): Promise<string> {
       const createOpts = await resolveCreateOptions(options.create);
       const sandbox = await compute.sandbox.create({

sdks/typescript/src/providers/daytona.ts

@@ -31,6 +31,7 @@ export function daytona(options: DaytonaProviderOptions = {}): SandboxProvider {
 
   return {
     name: "daytona",
+    defaultCwd: "/home/daytona",
     async create(): Promise<string> {
       const createOpts = await resolveCreateOptions(options.create);
       const sandbox = await client.create({

sdks/typescript/src/providers/docker.ts

@@ -44,6 +44,7 @@ export function docker(options: DockerProviderOptions = {}): SandboxProvider {
 
   return {
     name: "docker",
+    defaultCwd: "/home/sandbox",
     async create(): Promise<string> {
       const hostPort = await getPort();
       const env = await resolveValue(options.env, []);

sdks/typescript/src/providers/e2b.ts

@@ -42,6 +42,7 @@ export function e2b(options: E2BProviderOptions = {}): SandboxProvider {
 
   return {
     name: "e2b",
+    defaultCwd: "/home/user",
     async create(): Promise<string> {
       const createOpts = await resolveOptions(options.create);
       const rawTemplate = typeof createOpts.template === "string" ? createOpts.template : undefined;

sdks/typescript/src/providers/modal.ts

@@ -29,6 +29,7 @@ export function modal(options: ModalProviderOptions = {}): SandboxProvider {
 
   return {
     name: "modal",
+    defaultCwd: "/root",
     async create(): Promise<string> {
       const createOpts = await resolveCreateOptions(options.create);
       const appName = createOpts.appName ?? DEFAULT_APP_NAME;

sdks/typescript/src/providers/types.ts

@@ -47,4 +47,11 @@ export interface SandboxProvider {
    * (e.g. the duplicate process exits on port conflict).
    */
   ensureServer?(sandboxId: string): Promise<void>;
+
+  /**
+   * Default working directory for sessions when the caller does not specify
+   * one. Remote providers should set this to a path that exists inside the
+   * sandbox (e.g. '/home/user'). When omitted, falls back to process.cwd().
+   */
+  defaultCwd?: string;
 }

sdks/typescript/src/providers/vercel.ts

@@ -30,6 +30,7 @@ export function vercel(options: VercelProviderOptions = {}): SandboxProvider {
 
   return {
     name: "vercel",
+    defaultCwd: "/home/vercel-sandbox",
     async create(): Promise<string> {
       const sandbox = await Sandbox.create((await resolveCreateOptions(options.create, agentPort)) as Parameters<typeof Sandbox.create>[0]);
 

sdks/typescript/tests/providers.test.ts

@@ -35,10 +35,10 @@ function findBinary(): string | null {
 }
 
 const BINARY_PATH = findBinary();
-if (!BINARY_PATH) {
-  throw new Error("sandbox-agent binary not found. Build it (cargo build -p sandbox-agent) or set SANDBOX_AGENT_BIN.");
-}
-if (!process.env.SANDBOX_AGENT_BIN) {
+// if (!BINARY_PATH) {
+//   throw new Error("sandbox-agent binary not found. Build it (cargo build -p sandbox-agent) or set SANDBOX_AGENT_BIN.");
+// }
+if (!process.env.SANDBOX_AGENT_BIN && BINARY_PATH) {
   process.env.SANDBOX_AGENT_BIN = BINARY_PATH;
 }