@sandboxrouter/sdk 0.6.0 → 0.7.0

package/README.md

@@ -44,8 +44,8 @@ List price while running, 2 vCPU / 4 GB, cheapest first; waitlisted sign-ups fol
 |---|---|---|---|---|
 | [Agent37](https://sandboxrouter.vercel.app/providers/agent37) | $0.007 | none | passed (2026-11-11) | [pricing](https://www.agent37.com/docs/agents-api/billing) |
 | [Boat](https://sandboxrouter.vercel.app/providers/boat) | $0.018 | $20/mo (credited) | not run yet | [pricing](https://docs.boat.dev/pricing.md) |
-| [Maritime](https://sandboxrouter.vercel.app/providers/maritime) | $0.022 | $20/mo (credited) | passed (2026-11-11) | [pricing](https://maritime.sh/pricing) |
-| [Sailboxes (Sail Research)](https://sandboxrouter.vercel.app/providers/sail) | up to $0.062 | none | passed (2026-11-11) | [pricing](https://docs.sailresearch.com/sailboxes-pricing.md) |
+| [Maritime](https://sandboxrouter.vercel.app/providers/maritime) | $0.022 | $20/mo (credited) | passed (2026-11-13) | [pricing](https://maritime.sh/pricing) |
+| [Sailboxes (Sail Research)](https://sandboxrouter.vercel.app/providers/sail) | up to $0.062 | none | passed (2026-11-13) | [pricing](https://docs.sailresearch.com/sailboxes-pricing.md) |
 | [Northflank](https://sandboxrouter.vercel.app/providers/northflank) | $0.067 | none | not run yet | [pricing](https://northflank.com/pricing) |
 | [Morph Cloud](https://sandboxrouter.vercel.app/providers/morph) | $0.100 | none | not run yet | [pricing](https://cloud.morph.so/web/pricing) |
 | [exe.dev](https://sandboxrouter.vercel.app/providers/exedev) | $0.105 | $15/mo | not run yet | [pricing](https://exe.dev/docs/standalone-vms.md) |
@@ -54,15 +54,15 @@ List price while running, 2 vCPU / 4 GB, cheapest first; waitlisted sign-ups fol
 | [Beam](https://sandboxrouter.vercel.app/providers/beam) | $0.140 | $20/mo (credited) | not run yet | [pricing](https://www.beam.cloud/pricing) |
 | [CodeSandbox SDK (Together)](https://sandboxrouter.vercel.app/providers/codesandbox) | $0.149 | none | not run yet | [pricing](https://docs.together.ai/docs/together-code-sandbox-legacy) |
 | [Fly.io Sprites](https://sandboxrouter.vercel.app/providers/sprites) | up to $0.164 | none | passed (2026-11-11) | [pricing](https://fly.io/sprites) |
-| [Blaxel](https://sandboxrouter.vercel.app/providers/blaxel) | $0.166 | none | passed (2026-11-11) | [pricing](https://blaxel.ai/pricing) |
+| [Blaxel](https://sandboxrouter.vercel.app/providers/blaxel) | $0.166 | none | passed (2026-11-13) | [pricing](https://blaxel.ai/pricing) |
 | [HOPX](https://sandboxrouter.vercel.app/providers/hopx) | $0.166 | none | not run yet | [pricing](https://hopx.ai/pricing) |
 | [Superserve](https://sandboxrouter.vercel.app/providers/superserve) | $0.166 | maybe $20/mo (credited) | passed (2026-11-11) | [pricing](https://superserve.ai/pricing) |
 | [Tensorlake](https://sandboxrouter.vercel.app/providers/tensorlake) | up to $0.200 | none | not run yet | [pricing](https://www.tensorlake.ai/pricing) |
 | [Upstash Box](https://sandboxrouter.vercel.app/providers/upstash) | up to $0.200 | none | not run yet | [pricing](https://upstash.com/pricing/box) |
 | [Cloudflare Sandbox](https://sandboxrouter.vercel.app/providers/cloudflare) | up to $0.216 | $5/mo | passed (2026-11-11) | [pricing](https://developers.cloudflare.com/containers/platform/pricing/) |
-| [Amazon Bedrock AgentCore Code Interpreter](https://sandboxrouter.vercel.app/providers/agentcore) | up to $0.217 | none | passed (2026-11-11) | [pricing](https://aws.amazon.com/bedrock/agentcore/pricing/) |
+| [Amazon Bedrock AgentCore Code Interpreter](https://sandboxrouter.vercel.app/providers/agentcore) | up to $0.217 | none | passed (2026-11-13) | [pricing](https://aws.amazon.com/bedrock/agentcore/pricing/) |
 | [Modal](https://sandboxrouter.vercel.app/providers/modal) | up to $0.238 | none | passed (2026-11-11) | [pricing](https://modal.com/pricing) |
-| [AWS Lambda MicroVMs](https://sandboxrouter.vercel.app/providers/lambda) | $0.252 | none | passed (2026-11-11) | [pricing](https://aws.amazon.com/lambda/pricing/) |
+| [AWS Lambda MicroVMs](https://sandboxrouter.vercel.app/providers/lambda) | $0.252 | none | passed (2026-11-13) | [pricing](https://aws.amazon.com/lambda/pricing/) |
 | [Deno Sandbox](https://sandboxrouter.vercel.app/providers/deno) | up to $0.300 | $20/mo | not run yet | [pricing](https://deno.com/sandbox) |
 | [Runloop](https://sandboxrouter.vercel.app/providers/runloop) | $0.317 | none | not run yet | [pricing](https://www.runloop.ai/pricing) |
 | [Vercel Sandbox](https://sandboxrouter.vercel.app/providers/vercel) | up to $0.341 | none | passed (2026-11-11) | [pricing](https://vercel.com/docs/vercel-sandbox/pricing) |
@@ -70,12 +70,12 @@ List price while running, 2 vCPU / 4 GB, cheapest first; waitlisted sign-ups fol
 | [Koyeb Sandboxes (not taking new accounts)](https://sandboxrouter.vercel.app/providers/koyeb) | $0.058 | $29/mo | not run yet | [pricing](https://www.koyeb.com/docs/reference/instances) |
 | [Dedalus Machines (sign-up waitlisted)](https://sandboxrouter.vercel.app/providers/dedalus) | $0.149 | none | not run yet | [pricing](https://docs.dedaluslabs.ai/dcs/dm/pricing) |
 | [LangSmith Sandboxes (sign-up waitlisted)](https://sandboxrouter.vercel.app/providers/langsmith) | $0.189 | none | not run yet | [pricing](https://www.langchain.com/pricing) |
-| [OpenScale Sandboxes](https://sandboxrouter.vercel.app/providers/openscale) | skipped (default image is 2 vCPU / 1 GB; a bigger size needs image.openscale) | none | passed (2026-11-11) | [pricing](https://openscale.so/sandboxes) |
+| [OpenScale Sandboxes](https://sandboxrouter.vercel.app/providers/openscale) | skipped (default image is 2 vCPU / 1 GB; a bigger size needs image.openscale) | none | passed (2026-11-13) | [pricing](https://openscale.so/sandboxes) |
 | [Azure Container Apps dynamic sessions](https://sandboxrouter.vercel.app/providers/azure) | skipped (max 1 vCPU) | none | not run yet | [pricing](https://learn.microsoft.com/en-us/azure/container-apps/billing#dynamic-sessions) |
-| [Daytona](https://sandboxrouter.vercel.app/providers/daytona) | skipped (default image is 1 vCPU / 1 GB; a bigger size needs image.daytona) | none | passed (2026-11-11) | [pricing](https://www.daytona.io/pricing) |
+| [Daytona](https://sandboxrouter.vercel.app/providers/daytona) | skipped (default image is 1 vCPU / 1 GB; a bigger size needs image.daytona) | none | passed (2026-11-13) | [pricing](https://www.daytona.io/pricing) |
 | [Alibaba Cloud Agent Sandbox](https://sandboxrouter.vercel.app/providers/alibaba) | skipped (max 2 GB memory) | none | not run yet | [pricing](https://www.alibabacloud.com/help/en/agent-sandbox/product-overview/billing-overview) |
-| [E2B](https://sandboxrouter.vercel.app/providers/e2b) | skipped (default image is 2 vCPU / 0.5 GB; a bigger size needs image.e2b) | none | passed (2026-11-11) | [pricing](https://e2b.dev/pricing) |
-| [Docker (local)](https://sandboxrouter.vercel.app/providers/docker) | free | none | passed (2026-11-09) | [pricing](https://docs.docker.com/engine/) |
+| [E2B](https://sandboxrouter.vercel.app/providers/e2b) | skipped (default image is 2 vCPU / 0.5 GB; a bigger size needs image.e2b) | none | passed (2026-11-13) | [pricing](https://e2b.dev/pricing) |
+| [Docker (local)](https://sandboxrouter.vercel.app/providers/docker) | free | none | passed (2026-11-13) | [pricing](https://docs.docker.com/engine/) |
 
 Checked 2026-11-04 to 2026-11-06.
 

package/dist/cli.js

@@ -18,10 +18,12 @@ Usage:
   sandboxrouter providers [--vcpu N] [--memory GB]   price table + which keys are set
   sandboxrouter route     [spec flags] [route flags] dry run: the order providers would be tried
   sandboxrouter run "<cmd>" [spec flags] [route flags] [--keep]
-  sandboxrouter check     --provider ID[,ID] | --all [--json] [--save [dir]] [--by GITHUB_USER]
+  sandboxrouter check     --provider ID[,ID] | --all [--json] [--save [dir]] [--retry] [--out FILE] [--by GITHUB_USER]
                           test providers for real: exec, env, UTF-8, streaming, files, timeout, pause,
                           kill; exits 1 if any step fails. --all = every configured provider;
-                          --save writes results/conformance/<id>.json for the compatibility table
+                          --save writes results/conformance/<id>.json for the compatibility table;
+                          --retry runs a failed provider once more and keeps that result;
+                          --out writes every report as JSON (with the first try's failure, if retried)
   sandboxrouter ls        [--json]                       sandboxes this machine started that weren't killed
   sandboxrouter gc        [--all | --older-than MIN] [--dry-run]
                           kill leaked sandboxes: by default those past their lifetime
@@ -73,6 +75,7 @@ const { values, positionals } = parseArgs({
         label: { type: "string" },
         all: { type: "boolean" },
         save: { type: "boolean" },
+        retry: { type: "boolean" },
         "older-than": { type: "string" },
         "dry-run": { type: "boolean" },
         minutes: { type: "string" },
@@ -208,16 +211,23 @@ async function main() {
         const saveDir = values.save ? (rest[0] ?? "results/conformance") : undefined;
         const mark = { pass: "ok  ", fail: "FAIL", skip: "skip", info: "note" };
         const reports = [];
+        const run = (p) => checkProvider(router, p, {
+            spec,
+            onStep: (r) => {
+                if (!values.json)
+                    console.log(`  ${mark[r.status]}  ${r.step.padEnd(32)} ${String(r.ms).padStart(6)} ms  ${r.detail ?? ""}`);
+            },
+        });
         for (const p of ids) {
             if (!values.json)
                 console.log(`\n${p}`);
-            const report = await checkProvider(router, p, {
-                spec,
-                onStep: (r) => {
-                    if (!values.json)
-                        console.log(`  ${mark[r.status]}  ${r.step.padEnd(32)} ${String(r.ms).padStart(6)} ms  ${r.detail ?? ""}`);
-                },
-            });
+            let report = await run(p);
+            if (values.retry && !report.ok && !report.inconclusive) {
+                const failed = report.results.find((r) => r.status === "fail");
+                if (!values.json)
+                    console.log(`  failed; trying ${p} once more`);
+                report = { ...(await run(p)), firstTry: failed ? `${failed.step}: ${failed.detail ?? "failed"}` : "failed" };
+            }
             reports.push(report);
             if (report.inconclusive) {
                 if (!values.json)
@@ -226,10 +236,13 @@ async function main() {
             }
             if (saveDir) {
                 mkdirSync(saveDir, { recursive: true });
-                const saved = publishableCheck({ tool: "sandboxrouter-check", version, date: new Date().toISOString(), platform: `${platform()}-${arch()}`, ...(by ? { by } : {}), ...report });
+                const { firstTry: _, ...result } = report;
+                const saved = publishableCheck({ tool: "sandboxrouter-check", version, date: new Date().toISOString(), platform: `${platform()}-${arch()}`, ...(by ? { by } : {}), ...result });
                 writeFileSync(`${saveDir}/${p}.json`, JSON.stringify(saved, null, 2) + "\n");
             }
         }
+        if (values.out)
+            writeFileSync(values.out, JSON.stringify(reports, null, 2) + "\n");
         if (values.json)
             console.log(JSON.stringify(reports, null, 2));
         else {

package/dist/router.d.ts

@@ -63,6 +63,18 @@ export interface RouterOptions {
     requireVerified?: boolean;
     /** Billed / list-price ratio per provider, behind `estimatedHourlyUsd`. Default: the ratios in `BILLED_VS_LIST`, from saved cost runs. */
     billedVsList?: Partial<Record<ProviderId, number>>;
+    /**
+     * When a create runs well past a provider's usual start time, try the next provider sooner than
+     * `createTimeoutSeconds`. The wait becomes `factor` x the provider's median start time (or 1.5x the
+     * slowest of its recent starts, if longer), at least `minSeconds`. It applies only when the caller
+     * didn't set `createTimeoutSeconds`, the router has a start time for the provider (3 of its own creates,
+     * or the bench file), and another provider is left to try. Default `{ factor: 5, minSeconds: 10 }`;
+     * `false` always waits the full `createTimeoutSeconds`.
+     */
+    quickFallback?: false | {
+        factor?: number;
+        minSeconds?: number;
+    };
 }
 /** Desktop-only providers. Filled in as adapters are added. */
 export declare function defaultComputerProviders(): ComputerProvider[];
@@ -77,6 +89,7 @@ export declare class Router {
     /** Create times this router measured, most recent last. */
     private readonly live;
     private computerOnly;
+    private readonly quick;
     /** The local record of sandboxes this router created, or undefined when turned off. */
     readonly ledger?: Ledger;
     constructor(opts?: RouterOptions);
@@ -94,6 +107,11 @@ export declare class Router {
     private whyNone;
     /** Start a sandbox on the best available provider, falling back down the list on failure. */
     create(spec?: SandboxSpec, route?: RouteOptions): Promise<RoutedSandbox>;
+    /**
+     * Seconds to wait for this provider's create: the caller's `createTimeoutSeconds`, or (see
+     * `quickFallback`) a few times its usual start time when another provider is left to try.
+     */
+    private waitFor;
     /** Remember a successful create's time, for the speed tie-break and strategy "fastest". */
     private observe;
     private record;

package/dist/router.js

@@ -103,6 +103,7 @@ export class Router {
     /** Create times this router measured, most recent last. */
     live = new Map();
     computerOnly;
+    quick;
     /** The local record of sandboxes this router created, or undefined when turned off. */
     ledger;
     constructor(opts = {}) {
@@ -117,6 +118,7 @@ export class Router {
         this.billed =
             opts.billedVsList ?? Object.fromEntries(Object.entries(BILLED_VS_LIST).map(([id, b]) => [id, b.ratio]));
         this.computerOnly = opts.computers ?? (opts.providers ? [] : defaultComputerProviders());
+        this.quick = opts.quickFallback === false ? false : { factor: 5, minSeconds: 10, ...opts.quickFallback };
     }
     /** Registered and has credentials. False for providers this router doesn't know. */
     isConfigured(id) {
@@ -233,22 +235,23 @@ export class Router {
         }
         const attempts = [];
         const tries = route.fallback === false ? usable.slice(0, 1) : usable;
-        const limitS = route.createTimeoutSeconds ?? DEFAULT_CREATE_TIMEOUT_S;
         const deadline = Date.now() + (route.deadlineSeconds ?? DEFAULT_CREATE_DEADLINE_S) * 1000;
-        for (const c of tries) {
+        for (const [i, c] of tries.entries()) {
             const left = deadline - Date.now();
             if (left <= 0) {
                 throw new RouterError(`create ran out of time (deadlineSeconds) after trying ${attempts.map((a) => a.provider).join(", ")}: ${attempts.map((a) => `${a.provider}: ${a.error}`).join(" | ")}`, attempts, "timeout");
             }
             const t0 = Date.now();
             const pending = this.provider(c.provider).create(spec);
+            const { limitS, typicalMs } = this.waitFor(c.provider, route, i === tries.length - 1);
             const waitS = Math.min(limitS, left / 1000);
             const price = { estimatedHourlyUsd: c.estimatedHourlyUsd, listHourlyUsd: c.listHourlyUsd, size: c.size };
             let timedOut = false;
             try {
                 const box = await withDeadline(pending, waitS * 1000, () => {
                     timedOut = true;
-                    return new ProviderError(c.provider, `create timed out after ${Number(waitS.toFixed(1))}s`);
+                    const usual = typicalMs !== undefined && waitS < (route.createTimeoutSeconds ?? DEFAULT_CREATE_TIMEOUT_S) ? `; it usually starts in ${Number((typicalMs / 1000).toFixed(1))}s` : "";
+                    return new ProviderError(c.provider, `create timed out after ${Number(waitS.toFixed(1))}s${usual}`);
                 });
                 attempts.push({ provider: c.provider, ok: true, ms: Date.now() - t0 });
                 this.observe(c.provider, Date.now() - t0);
@@ -273,6 +276,22 @@ export class Router {
         }
         throw new RouterError(`all providers failed: ${attempts.map((a) => `${a.provider}: ${a.error}`).join(" | ")}`, attempts, "all_failed");
     }
+    /**
+     * Seconds to wait for this provider's create: the caller's `createTimeoutSeconds`, or (see
+     * `quickFallback`) a few times its usual start time when another provider is left to try.
+     */
+    waitFor(id, route, last) {
+        const full = route.createTimeoutSeconds ?? DEFAULT_CREATE_TIMEOUT_S;
+        if (!this.quick || last || route.createTimeoutSeconds !== undefined)
+            return { limitS: full };
+        const live = this.live.get(id);
+        const samples = live && live.length >= LIVE_MIN_SAMPLES ? live : loadBench(this.benchFile)[id]?.createMs;
+        const typicalMs = median(samples);
+        if (typicalMs === undefined || !samples?.length)
+            return { limitS: full };
+        const s = Math.max(this.quick.factor * typicalMs, 1.5 * Math.max(...samples)) / 1000;
+        return { limitS: Math.min(full, Math.max(this.quick.minSeconds, s)), typicalMs };
+    }
     /** Remember a successful create's time, for the speed tie-break and strategy "fastest". */
     observe(id, ms) {
         const xs = this.live.get(id) ?? [];

package/dist/verified.js

@@ -1,18 +1,18 @@
 export const VERIFIED = {
     agent37: "2026-11-11",
-    agentcore: "2026-11-11",
-    lambda: "2026-11-11",
-    blaxel: "2026-11-11",
+    agentcore: "2026-11-13",
+    lambda: "2026-11-13",
+    blaxel: "2026-11-13",
     cloudflare: "2026-11-11",
-    daytona: "2026-11-11",
-    e2b: "2026-11-11",
+    daytona: "2026-11-13",
+    e2b: "2026-11-13",
     sprites: "2026-11-11",
     freestyle: "2026-11-11",
-    maritime: "2026-11-11",
+    maritime: "2026-11-13",
     modal: "2026-11-11",
     novita: "2026-11-11",
-    openscale: "2026-11-11",
-    sail: "2026-11-11",
+    openscale: "2026-11-13",
+    sail: "2026-11-13",
     superserve: "2026-11-11",
     vercel: "2026-11-11",
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sandboxrouter/sdk",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "One API for every sandbox provider: route AI agents' code by price, speed or capability, with automatic fallback. Free and open source.",
   "type": "module",
   "main": "dist/index.js",
@@ -175,7 +175,7 @@
     "@aws-sdk/client-appstream": "^3.1162.0",
     "@aws-sdk/credential-provider-node": "^3.972.93",
     "@blaxel/core": "^0.3.34",
-    "@daytonaio/sdk": "^0.227.3",
+    "@daytonaio/sdk": "^0.230.0",
     "@e2b/desktop": "^2.5.0",
     "@fly/sprites": "^0.2.4",
     "@hopx-ai/sdk": "^0.5.1",