Developer Documentation
How SpaceBot is built and operated — the runtimes, the REST API, the local runner, the workflow engine, and integrations. Sourced from the repo’s docs/ folder.
Start here
Architecture SpaceBot is not a single process. The same repository produces code for
several cooperating runtimes that share one Cloudflare D1 (SQLite) database. A
file's location determines which runtime it runs SpaceBot API The stable external API lives under /api/v1/ and uses Authorization: Bearer sblive... API keys.SpaceBot Integration Protocol This guide explains how external projects can integrate with SpaceBot to provide Discord slash commands, receive lifecycle events, and maintain a live connection.
Features & subsystems
AI Autopilot (Workflows + Queues Foundation) This document describes the initial implementation for durable DM AI execution with retries, recovery, and timeline visibility.Local Runner V2 (Typed Jobs) This document covers the typed local-runner capabilities added for cross-platform host automation.Superadmin Workflows The superadmin workflow system replaces the hardcoded gateway cron jobs with
D1-defined workflow templates that are editable in the builder UI
(Admin → Superadmin → Workflows), scheduled with real cro
Operations
Observability Set SENTRYDSN to enable Sentry for client and server runtime errors. Optional values:Alerting Configure project alerts for new issues, error-rate spikes, and transaction latency regressions after SENTRYDSN is set.HTTP/3 on Cloudflare HTTP/3 is a Cloudflare zone-level setting, not SvelteKit application code.Asset Optimization Source PNG/JPG assets are kept when they are canonical screenshots or icons. Optimized WebP variants should be used by app surfaces where available.