Release notes

About 1547 wordsAbout 5 min

Spora ships as a set: the framework (spora-core), the admin UI (spora-frontend), the plugins, and the spora skeleton that pulls them together. Each note below covers the whole set — what an operator gets, and what a plugin author has to do about it.

Versions are 0.x.y until 1.0. Under the pre-1.0 policy a minor bump may carry breaking changes, so read the breaking-change section before you upgrade. The roadmap explains the policy.

v0.15 — 27 October 2026

The headline is Spora speaks German, end to end. Underneath that sit two new subsystems an operator has been asking for — settings you can change without a shell, and a per-agent HTTP API — and a chat that compacts its history instead of losing it.

A language setting that follows the account

The admin UI and the framework now ship a German catalogue alongside English, and every plugin joined in. Pick a language on the account page and the choice is written to the server — not just remembered by the browser — so it follows you to another machine and survives a cleared localStorage.

The picker only offers languages the server has a catalogue for. If your instance carries extra catalogues, they appear in the picker; if a locale is missing, it is not offered rather than offered and broken.

Framework strings, the admin UI, and each plugin’s own copy — tool names, setting descriptions, plugin descriptions — are translated. Anything the model reads stays English, on purpose: the model and the operator are looking at different text.

Settings you can change without editing a file

Settings → Runtime settings is a new page that holds Spora’s runtime configuration, and it is where the values live from now on. It has five tabs: General, Mail & Realtime, Worker & Performance, Media & Plugins, and System.

The page saves to the database, and the database is the layer that wins:

registry default  <  config.php  <  .env / OS environment  <  database

That ordering surprises people, so the page says so when it happens: a value you save here overrides one you set in .env months ago and forgot about. On a shared host where you cannot reach a shell, it is the only layer you can write to.

Sixteen keys stay file-only — the SPORA_DB_* family and the other bootOnly ones are read before the database opens, so they cannot live in it. They are listed read-only on the System tab, each with the reason it is read where it is.

Full details: Global settings.

A per-agent HTTP API

Spora can expose an HTTP API scoped to one agent, for talking to it from outside the admin UI — a script, another service, a phone. It is off by default; turn it on with the SPORA_AGENT_API setting, and manage each agent’s keys from that agent’s tab in the UI.

The API has its own reference, including the chat, media and callback endpoints: Agent API.

Chat that compacts instead of forgetting

Long conversations used to run into the model’s context limit and stop. Now Spora compacts: it summarises the older turns, keeps the summary in the transcript, and carries on.

Three things changed with it. You can read above the newest message and see exactly where the compaction happened, marked in place. The notice about it lives in the transcript rather than floating in the composer. And you can compact by hand, when you want to, instead of waiting for the model to need it.

Sub-agents that hand over in the background

A sub-agent call can now run auto-approved — the sub_agent operation no longer waits for a human to approve it. When the child finishes it can hand the work back in the background, and a sub_agent_continue operation picks it up. The UI shows a card for the child so you can see what it did.

Two related fixes: a missing argument no longer reports itself as approved, and the expected child count now tracks the list of spawned ids rather than drifting from it.

The ask operation now ships enabled

The ask tool is on by default. It was available before and had to be switched on per agent.

Plugins speak German too

Every plugin in the set ships a German catalogue: the 19 plugins and the 5 plugin frontends all did, in the same release. A German install reads your tool names, your setting descriptions and your plugin description in German, with no i18n code on your side.

If you write a plugin and want the same, the pattern is a locales/ directory and one hook: Plugin author guide — Translations.

One breaking change, for plugin authors

Spora\Core\Database::__construct() now takes a Spora\Core\Config instead of an array, and the keys it reads are named SPORA_DB_DRIVER and SPORA_DB_PATH rather than db_driver and db_path.

If you run an operator’s Spora install: nothing to do. No plugin’s production code builds a Database, so this changes nothing you can see.

If you write a plugin and boot a database in your tests: one line. Where you had

$db = new Database(['db_driver' => 'sqlite', 'db_path' => $tmpDb]);

write

$db = new Database(new Config(['SPORA_DB_DRIVER' => 'sqlite', 'SPORA_DB_PATH' => $tmpDb]));

Config::getString() returns the caller’s default for a key that is absent, so those two keys are all a SQLite connection needs.

What else changed

  • openai-image — image variations now go to the edits endpoint, a single variation is allowed, the multipart upload is repaired, and the input image the plugin stages on disk is capped.
  • typst — the skill now declares the tools it uses, and the SonarCloud test-execution report is read at the property the PHPUnit sensor actually reads.
  • muse — this repository is scanned by its own CI rather than relying on automatic analysis.
  • word — the build fails when SonarCloud stored no analysis, instead of going green having measured nothing.
  • custom-skills frontend — the file size cap is measured in bytes, not characters.
  • memories frontend — a route segment that is not a number yields null, not 0.
  • team-graph frontend — the agent detail panel drops the Hierarchy chain.
  • scaffolder (spora-maker) — scaffolds the four-parameter ToolInterface::execute(), stops naming hooks that were removed in 1.0, prints the complete App subscriber for controller route wiring, and names the resource rather than the PHP class in the route.
  • installer — a .gitignore tidy for the scratch directory.
  • skeleton — Renovate now keeps the Docker base images current. The runtime tag stays pinned to an exact release, because a floating frankenphp tag moved to a new Caddy and Mercure hub under a running deployment once already and broke every boot.

Versions in this release

PackageVersion
spora-ai/spora-corev0.31.0
spora-ai/spora-frontendv0.26.0
spora-ai/installerv1.6.1
spora-ai/spora-makerv0.1.5
spora-ai/spora-plugin-calendarv0.9.0
spora-ai/spora-plugin-custom-skillsv0.2.1
spora-ai/spora-plugin-custom-skills-frontendv0.4.0
spora-ai/spora-plugin-emailv0.7.0
spora-ai/spora-plugin-media-archivev0.7.1
spora-ai/spora-plugin-media-archive-frontendv0.7.0
spora-ai/spora-plugin-memoriesv0.8.1
spora-ai/spora-plugin-memories-frontendv0.3.0
spora-ai/spora-plugin-minimaxv0.17.0
spora-ai/spora-plugin-musev0.3.0
spora-ai/spora-plugin-openai-imagev0.7.0
spora-ai/spora-plugin-semantic-scholarv0.6.0
spora-ai/spora-plugin-serperv0.7.0
spora-ai/spora-plugin-skeletonv0.4.0
spora-ai/spora-plugin-staanv0.3.0
spora-ai/spora-plugin-tavilyv0.6.0
spora-ai/spora-plugin-team-graphv0.2.0
spora-ai/spora-plugin-team-graph-frontendv0.2.0
spora-ai/spora-plugin-typstv0.6.1
spora-ai/spora-plugin-typst-frontendv0.3.0
spora-ai/spora-plugin-weatherv0.7.0
spora-ai/spora-plugin-wordv0.2.0
spora-ai/spora-plugin-worldnewsv0.7.0
spora-ai/spora-plugin-zerniov0.6.0

The spora skeleton is v0.15.0, with v0.15.1 picking up the installer and scaffolder patches.

Upgrading

composer update spora-ai/spora-core spora-ai/spora-frontend

The frontend ships as a prebuilt asset on a GitHub Release, so the update pulls the new bundle; there is nothing to build. The language selector appears on the account page once the framework and the UI are both on v0.15.

v0.14 — 22 October 2026

The release that made skills first-class.

  • Skills — a provider seam for skills, a read-only skill tool, and agent self-configuration. A skill can read a per-file sidecar, and a grammar for allowed-tools puts the declared tool names on the wire. The bundled skills are MIT, and the two agent skills became distinct.
  • Media — markdown_content was replaced by markdown derivatives, a create_media operation and a document embed arrived, and a MIME-refiner seam was added. Control characters are stripped from download filenames.
  • Breaking — the inert legacy $userId was dropped from ToolInterface::execute(), and core no longer ships a skill search provider.
  • Admin UI — the command palette finally calls GET /search, a skill can declare a tool the agent does not have, and the spora-file-card download got a style.
PackageVersion
spora-ai/spora-corev0.30.0
spora-ai/spora-frontendv0.25.0

Where to look next