Files

tegwick 1415e17230 Implement SAND-WP-0006: SaaS payments, routing, and ext.saas-stub

Add credits store, metering on create/destroy, extension routing resolver,
metered SaaS stub extension, burst/saas profiles, credits CLI, docs, and tests.

2026-06-24 07:52:20 +02:00

1.3 KiB

Raw Blame History

Payments and metering

Version 0.1 — SAND-WP-0006. OpenRouter-style credits for metered SaaS extensions.

Credits store

Path: ~/.local/share/sandboxer/credits.json (override via test injection).

Env	Default
`SANDBOXER_DEFAULT_CREDITS`	`10.0` USD on first use

sandboxer credits show
sandboxer credits add 25.00

Metered lifecycle

create — estimate_cost on metered extension; block if balance insufficient
ready — SandboxStatus.meter.estimate_usd recorded
destroy — meter_actual (or prorated estimate); debit credits; State Hub note event

Self-hosted extensions (pricing_model: self-hosted) skip credits.

Extension contract

Metered extensions implement on SandboxExtension:

def estimate_cost(self, profile, inputs, *, duration_s=3600) -> MeterQuote | None
def meter_actual(self, handle, *, duration_s: float) -> float | None

Reference: ext.saas-stub (no external API).

BYOK

Provider API keys are resolved at provision boundary via secret_refs / OpenBao — not implemented in v0 stub. Set provider env vars per extension when adapters land.

Billing export

sand-boxer meters sandbox consumption only. Domain billing authority (fin-hub) is a future export consumer of State Hub meter events — not owned here.

1.3 KiB Raw Blame History