Sandbox API

Changelog

API documentation and platform API changes.

Unreleased

Analytics

  • Consumer labels on Harbor, Agent, CodeEdit, and Sandboxes create/enqueue bodies
  • correlation_id and labels persisted on job status.json and sandbox records; returned on GET and webhooks
  • BigQuery event emission (run_completed, execution_completed, session_lifecycle) via SANDBOX_ANALYTICS_* env
  • Backfill script: scripts/backfill_analytics_to_bq.py
  • Docs: Analytics and reporting

Docs

  • Integrator docs regrouped: Introduction → Run workloads → Agents & catalog → Platform guides → Desktop deep dive
  • Architecture documents substrates: Kubernetes pods, cloud VMs (ec2-vm), and external Mac (aws-ec2-mac)
  • Supported agents lists every curated catalog id (opencode, claude-code, codex, gemini-cli, openhands, cursor-cli, aider, cline-cli, terminus-2, oracle) with examples
  • Desktop guides expanded: viewer API/UI, providers, operations (pods + VMs)

Platform API (selected)

  • Integrator docs site at /docs (Fumadocs + merged OpenAPI)
  • GET /sandbox/agent/v1/agents — catalog ∪ Harbor factory
  • harbor_extensions on Harbor; Agent runs prefer agent_options (old name still accepted)
  • Catalog enforcement modes: strict | warn | off (Harbor path)

Download the current contract: sandbox-platform.yaml.