Files

tegwick 15f031fd65 feat: cloud adapters E2B/Modal and billing export (SAND-WP-0010)

Add credentialed E2B and Modal extensions, burst routing fallback,
fin-hub meter export hook, BYOK docs, and 77 tests.

2026-06-24 12:50:19 +02:00

1.4 KiB

Raw Blame History

Extension routing

Version 0.1 — SAND-WP-0006. Select backend when a profile lists multiple extensions.

Profile route block

extension: ext.compose-ssh   # default / explicit fallback
route:
  strategy: prefer-self-hosted
  extensions:
    - ext.compose-ssh
    - ext.e2b
    - ext.modal
    - ext.saas-stub
  max_cost_per_hour_usd: 1.0

Strategies

Strategy	Behavior
`explicit`	Use `profile.extension` (default when no route)
`prefer-self-hosted`	Self-hosted if host available; else credentialed E2B/Modal; else stub
`lowest-cost`	Self-hosted if available; else cheapest `estimate_cost`
`lowest-latency`	Self-hosted if available; else last candidate (v0)

Testing SaaS fallback

# Skip self-hosted when host unavailable:
unset SANDBOXER_HOST
SANDBOXER_FORCE_SAAS=1 sandboxer create --profile profile.burst-sandbox

# Or use metered-only profile:
sandboxer create --profile profile.saas-stub

Reference profiles

Profile	Route
`profile.burst-sandbox`	compose-ssh → e2b → modal → saas-stub
`profile.e2b-burst`	explicit `ext.e2b`
`profile.modal-gpu`	explicit `ext.modal`
`profile.saas-stub`	explicit `ext.saas-stub`

Cloud adapters require provider credentials (E2B_API_KEY, MODAL_TOKEN_ID). See docs/cloud-adapters.md.

Resolver: sandboxer.routing.resolver.resolve_extension.

1.4 KiB Raw Blame History