Reference
About 322 wordsAbout 1 min
This page is the canonical TOC for the Spora reference material. The user-facing Guide, Develop, and Deploy sections duplicate the relevant pieces in context; this index is the single source of truth for exact specifications.
These pages are the authoritative source.
spora-core’s owndocs/directory holds only04_api.mdand14_speech.md; every other topic was consolidated here, so the pages below are where to look and where to file a correction. Core’sAGENTS.mdpoints athttps://docs.spora-ai.com/…for the same reason.
Core internals
| Topic | Location |
|---|---|
| Architecture (config priority, orchestrator, plugin system, agent templates, database) | /reference/concepts/architecture |
| Database schema (tables, columns, migrations) | /reference/concepts/schema |
| PHP interface contracts (ToolInterface, Orchestrator, LLMDriverConfig, PluginInterface) | /reference/concepts/interfaces |
Extending Spora
| Topic | Location |
|---|---|
LLM drivers (LLMDriverConfigInterface, OpenAICompatibleDriver, AnthropicCompatibleDriver) | /reference/concepts/drivers |
Tool system (#[Tool], #[ToolOperation], #[ToolParameter], #[ToolSetting]) | /reference/concepts/tools |
| Plugin system (manifest, auto-discovery, conflicts) | /reference/concepts/plugins-system |
App extensions (app/App.php) | /reference/concepts/app-extension |
Media assets (binary outputs, AssetStore, MediaEmbed) | /reference/concepts/media-assets |
| Plugin author guide (end-to-end) | /develop/plugins/author-guide |
Operations
| Topic | Location |
|---|---|
| Logging (PSR-3, PII policy, what gets logged) | /reference/concepts/logging |
| Error handling (envelope, codes, toast mapping) | /reference/concepts/error-handling |
| Agent loop and async mode (tick structure, SSE) | /reference/concepts/agent-loop-async |
| Worker deployment (cron / daemon) | /reference/concepts/worker-deployment |
| Installation (5 routes) | /start/operators/install |
Environment variables (canonical SPORA_* reference) | /start/operators/env-vars |
| Security (encryption, auth, rate limiting, plugin risk) | /start/operators/security |
| REST API reference | /reference/api — source of record: spora-core/docs/04_api.md |
Plugin install API (/api/v1/plugins/*) | /develop/plugins/install-api |
Frontend
| Topic | Location |
|---|---|
| Frontend architecture (Vue 3 + Vite + Tailwind + radix-vue) | /reference/concepts/frontend-architecture |
Contributor docs
| Topic | Location |
|---|---|
| Code documentation (delete / keep / add) | /reference/concepts/code-documentation |
| Testing (Pest, Vitest, SonarQube coverage gate) | /reference/concepts/testing |