Skip to content

The open-source app everyone uses to manage agents at work

fix(sandbox): prevent E2B workspace upload + lease idle failures (PAPA-382) (#6560)

Devin Foleye3c875c1c76c
diff --git a/packages/adapter-utils/src/sandbox-managed-runtime.ts b/packages/adapter-utils/src/sandbox-managed-runtime.ts
index 62375d7da2..13e9e9120d 100644
--- a/packages/adapter-utils/src/sandbox-managed-runtime.ts
+++ b/packages/adapter-utils/src/sandbox-managed-runtime.ts
@@ -138,6 +138,13 @@ async function createTarballFromDirectory(input: {
const excludeArgs = ["._*", ...(input.exclude ?? [])].flatMap((entry) => ["--exclude", entry]);
await execTar([
"-c",
+ // Prevent macOS bsdtar from embedding LIBARCHIVE.xattr.* PAX extended
+ // headers for extended attributes (e.g. com.apple.provenance). GNU tar on
+ // Linux does not recognise these proprietary headers and fails extraction
+ // with "This does not look like a tar archive". COPYFILE_DISABLE=1 (set in
+ // execTar) already suppresses AppleDouble ._* sidecar files; --no-xattrs
+ // additionally suppresses the inline PAX xattr entries.
+ "--no-xattrs",
...(input.followSymlinks ? ["-h"] : []),
"-f",
input.archivePath,
diff --git a/packages/plugins/sandbox-providers/cloudflare/src/config.ts b/packages/plugins/sandbox-providers/cloudflare/src/config.ts
index 1ed62a266f..8bd6bab5bd 100644
--- a/packages/plugins/sandbox-providers/cloudflare/src/config.ts
+++ b/packages/plugins/sandbox-providers/cloudflare/src/config.ts
@@ -1,7 +1,7 @@
import type { CloudflareDriverConfig } from "./types.js";
const DEFAULT_REQUESTED_CWD = "/workspace/paperclip";
-const DEFAULT_SLEEP_AFTER = "10m";
+const DEFAULT_SLEEP_AFTER = "1h";
const DEFAULT_TIMEOUT_MS = 300_000;
const DEFAULT_BRIDGE_REQUEST_TIMEOUT_MS = 300_000;
const LOCALHOST_HOSTNAMES = new Set(["localhost", "127.0.0.1", "::1"]);
diff --git a/packages/plugins/sandbox-providers/cloudflare/src/manifest.ts b/packages/plugins/sandbox-providers/cloudflare/src/manifest.ts
index 21f3ddda74..52b18660d5 100644
--- a/packages/plugins/sandbox-providers/cloudflare/src/manifest.ts
+++ b/packages/plugins/sandbox-providers/cloudflare/src/manifest.ts
@@ -49,8 +49,9 @@ const manifest: PaperclipPluginManifestV1 = {
},
sleepAfter: {
type: "string",
- default: "10m",
- description: "Idle timeout passed to getSandbox(). Ignored when keepAlive is true.",
+ default: "1h",
+ description:
+ "Idle timeout passed to getSandbox() on lease creation. Defaults to 1 hour so a fresh sandbox survives normal Claude/Codex heartbeats. Ignored when keepAlive is true.",
},
normalizeId: {
type: "boolean",
diff --git a/packages/plugins/sandbox-providers/cloudflare/src/plugin.test.ts b/packages/plugins/sandbox-providers/cloudflare/src/plugin.test.ts
index 84a6077b2f..5e3908bd5c 100644
--- a/packages/plugins/sandbox-providers/cloudflare/src/plugin.test.ts
+++ b/packages/plugins/sandbox-providers/cloudflare/src/plugin.test.ts
@@ -62,7 +62,7 @@ describe("Cloudflare sandbox provider plugin", () => {
bridgeAuthToken: "secret-ref://bridge-token",
reuseLease: true,
keepAlive: true,
- sleepAfter: "10m",
+ sleepAfter: "1h",
normalizeId: false,
requestedCwd: "/workspace/custom",
sessionStrategy: "default",
@@ -145,6 +145,29 @@ describe("Cloudflare sandbox provider plugin", () => {
});
});
+ it("defaults the sleepAfter passed to the bridge to 1h so long runs don't idle out", async () => {
+ fetchMock.mockResolvedValueOnce(
+ jsonResponse({
+ providerLeaseId: "pc-run-1-abcd1234",
+ metadata: { provider: "cloudflare", remoteCwd: "/workspace/paperclip", resumedLease: false },
+ }),
+ );
+
+ await plugin.definition.onEnvironmentAcquireLease?.({
+ driverKey: "cloudflare",
+ companyId: "company-1",
+ environmentId: "env-1",
+ runId: "run-1",
+ requestedCwd: "/workspace/paperclip",
+ config: {
+ bridgeBaseUrl: "https://bridge.example.workers.dev",
+ bridgeAuthToken: "resolved-token",
+ },
+ });
+
+ expect(requestBodyAt()).toMatchObject({ sleepAfter: "1h" });
+ });
+
it("returns expired lease semantics when resume reports lost state", async () => {
fetchMock.mockResolvedValueOnce(
jsonResponse(
diff --git a/packages/plugins/sandbox-providers/e2b/src/manifest.ts b/packages/plugins/sandbox-providers/e2b/src/manifest.ts
index 11b235909b..a245e80c73 100644
--- a/packages/plugins/sandbox-providers/e2b/src/manifest.ts
+++ b/packages/plugins/sandbox-providers/e2b/src/manifest.ts
@@ -39,8 +39,9 @@ const manifest: PaperclipPluginManifestV1 = {
},
timeoutMs: {
type: "number",
- description: "Sandbox timeout in milliseconds.",
- default: 300000,
+ description:
+ "Sandbox lifetime in milliseconds, refreshed on each command. Defaults to 1 hour. Raise this if your runs commonly idle longer than the default between commands.",
+ default: 3600000,
},
reuseLease: {
type: "boolean",
diff --git a/packages/plugins/sandbox-providers/e2b/src/plugin.test.ts b/packages/plugins/sandbox-providers/e2b/src/plugin.test.ts
index 99b881c87c..3f982284f2 100644
--- a/packages/plugins/sandbox-providers/e2b/src/plugin.test.ts
+++ b/packages/plugins/sandbox-providers/e2b/src/plugin.test.ts
@@ -379,6 +379,59 @@ describe("E2B sandbox provider plugin", () => {
});
});
+ it("refreshes the sandbox lifetime on every execute so long runs don't die mid-command", async () => {
+ const sandbox = createMockSandbox();
+ mockConnect.mockResolvedValue(sandbox);
+
+ await plugin.definition.onEnvironmentExecute?.({
+ driverKey: "e2b",
+ companyId: "company-1",
+ environmentId: "env-1",
+ config: {
+ template: "base",
+ apiKey: "resolved-key",
+ timeoutMs: 1_800_000,
+ reuseLease: false,
+ },
+ lease: { providerLeaseId: "sandbox-123", metadata: {} },
+ command: "printf",
+ args: ["hello"],
+ cwd: "/workspace",
+ env: {},
+ timeoutMs: 1000,
+ });
+
+ expect(sandbox.setTimeout).toHaveBeenCalledWith(1_800_000);
+ });
+
+ it("still runs the command when the setTimeout refresh fails transiently", async () => {
+ const sandbox = createMockSandbox();
+ sandbox.setTimeout.mockRejectedValueOnce(new Error("transient e2b api error"));
+ mockConnect.mockResolvedValue(sandbox);
+
+ const result = await plugin.definition.onEnvironmentExecute?.({
+ driverKey: "e2b",
+ companyId: "company-1",
+ environmentId: "env-1",
+ config: {
+ template: "base",
+ apiKey: "resolved-key",
+ timeoutMs: 1_800_000,
+ reuseLease: false,
+ },
+ lease: { providerLeaseId: "sandbox-123", metadata: {} },
+ command: "printf",
+ args: ["hello"],
+ cwd: "/workspace",
+ env: {},
+ timeoutMs: 1000,
+ });
+
+ expect(sandbox.setTimeout).toHaveBeenCalledWith(1_800_000);
+ expect(sandbox.commands.run).toHaveBeenCalled();
+ expect(result?.exitCode).toBe(0);
+ });
+
it("cleans up staged stdin even when writing it fails", async () => {
const sandbox = createMockSandbox();
const failure = new Error("write failed");
diff --git a/packages/plugins/sandbox-providers/e2b/src/plugin.ts b/packages/plugins/sandbox-providers/e2b/src/plugin.ts
index daf1548645..e20dfd68c4 100644
--- a/packages/plugins/sandbox-providers/e2b/src/plugin.ts
+++ b/packages/plugins/sandbox-providers/e2b/src/plugin.ts
@@ -34,11 +34,11 @@ function parseDriverConfig(raw: Record<string, unknown>): E2bDriverConfig {
const template = typeof raw.template === "string" && raw.template.trim().length > 0
? raw.template.trim()
: "base";
- const timeoutMs = Number(raw.timeoutMs ?? 300_000);
+ const timeoutMs = Number(raw.timeoutMs ?? 3_600_000);
return {
template,
apiKey: typeof raw.apiKey === "string" && raw.apiKey.trim().length > 0 ? raw.apiKey.trim() : null,
- timeoutMs: Number.isFinite(timeoutMs) ? Math.trunc(timeoutMs) : 300_000,
+ timeoutMs: Number.isFinite(timeoutMs) ? Math.trunc(timeoutMs) : 3_600_000,
reuseLease: raw.reuseLease === true,
};
}
@@ -391,6 +391,18 @@ const plugin = definePlugin({
const config = parseDriverConfig(params.config);
const sandbox = await connectSandbox(config, params.lease.providerLeaseId);
+ // Refresh the sandbox death clock on every command. E2B's `timeoutMs` is
+ // the absolute sandbox lifetime from create/connect; without this, a run
+ // longer than `config.timeoutMs` will have its sandbox killed mid-command
+ // and the next call throws "Sandbox is probably not running anymore".
+ // The refresh is best-effort: the sandbox is already healthy at this
+ // point, so a transient API error on setTimeout should not block the
+ // command from running. Worst case the existing lifetime stands.
+ try {
+ await sandbox.setTimeout(config.timeoutMs);
+ } catch {
+ // ignore — keep going with the existing sandbox lifetime
+ }
const baseCommand = buildLoginShellScript({
command: params.command,
args: params.args ?? [],