Repository navigation
Ferrum v0.7.13
Ferrum v0.7.13 stabilizes prompt caching for OpenAI-compatible providers, exposes provider-reported cache reuse through /perf, and consolidates interactive session management under /session.
Highlights
- Keep provider prompt prefixes stable. Ferrum now limits the immutable provider prefix to the initial contiguous system block, sends temporary late guidance without mutating that prefix, and preserves canonical tools during final synthesis while disabling tool calls explicitly. OpenAI-compatible and OpenAI Codex requests use the same boundary rules.
- Canonicalize tool definitions. Tools are ordered by exported name and JSON Schema object keys are sorted recursively immediately before provider serialization, preventing discovery-order changes from invalidating otherwise reusable prefixes.
- Show real cache reuse in
/perf. When a provider reports cached input tokens, compact and detailed performance output show the weighted cached/input percentage and exact counts. Missing cache telemetry is kept distinct from a reported zero cache hit and is never estimated. - Resume with current immutable context. Resumed sessions rebuild the current runtime, project, and skill context ahead of conversation history. Legacy persisted runtime-system records are removed, and legacy system-role compaction summaries are treated as untrusted conversation context.
- Use one session command.
/sessionopens the picker, with/session all,/session new,/session delete, and/session infoproviding the remaining session operations. Alt+S, completion, inline hints, help, runtime guidance, and documentation use the same interface./newremains available.
Cache diagnostics
FERRUM_METRICS=1 now reports normalized leading-system, tool, and message segment sizes with per-process keyed digests and the first segment that changed. It never prints prompt, schema, image, or credential content. Digests are intentionally incomparable across process restarts, and compaction is labeled as an expected prefix reset.
Upgrade note
The plural interactive command /sessions has been removed. Replace it as follows:
/sessions -> /session
/sessions all -> /session all
/sessions new -> /session new
/sessions del -> /session delete
/session -> /session info # old detailed status behavior
Validation
- 681 tests passed.
- Formatting, strict Clippy across all targets and features, release build, benchmark/package checks, release-document checks, and
cargo audit --deny warningspassed. - The release assets were produced twice in clean pinned compatibility containers and were byte-identical.
- DEB and tarball installation checks passed on Debian 12; RPM installation checks passed on Fedora.
Linux downloads
All packages target x86_64 Linux. The GNU tarball is built on Debian 12 with a glibc 2.36 / OpenSSL 3 compatibility baseline. Build provenance is included in every package. SHA-256 checksum files accompany the tarball, DEB, and RPM.
Codeberg is the primary release host; GitHub carries the same assets as a backup mirror.
Debian / Ubuntu
curl -fLO https://codeberg.org/ominiverdi/ferrum/releases/download/v0.7.13/ferrum_0.7.13_amd64.deb
curl -fLO https://codeberg.org/ominiverdi/ferrum/releases/download/v0.7.13/ferrum_0.7.13_amd64.deb.sha256
sha256sum -c ferrum_0.7.13_amd64.deb.sha256
sudo apt install ./ferrum_0.7.13_amd64.deb
ferrum --versionFedora / RHEL / openSUSE
curl -fLO https://codeberg.org/ominiverdi/ferrum/releases/download/v0.7.13/ferrum-0.7.13-1.x86_64.rpm
curl -fLO https://codeberg.org/ominiverdi/ferrum/releases/download/v0.7.13/ferrum-0.7.13-1.x86_64.rpm.sha256
sha256sum -c ferrum-0.7.13-1.x86_64.rpm.sha256
sudo dnf install ./ferrum-0.7.13-1.x86_64.rpm
ferrum --versionOn openSUSE, use sudo zypper install ./ferrum-0.7.13-1.x86_64.rpm instead.
GNU tarball
curl -fLO https://codeberg.org/ominiverdi/ferrum/releases/download/v0.7.13/ferrum-v0.7.13-x86_64-unknown-linux-gnu.tar.gz
curl -fLO https://codeberg.org/ominiverdi/ferrum/releases/download/v0.7.13/ferrum-v0.7.13-x86_64-unknown-linux-gnu.tar.gz.sha256
sha256sum -c ferrum-v0.7.13-x86_64-unknown-linux-gnu.tar.gz.sha256
tar xzf ferrum-v0.7.13-x86_64-unknown-linux-gnu.tar.gz
sudo install -Dm755 ferrum-v0.7.13-x86_64-unknown-linux-gnu/ferrum /usr/local/bin/ferrum
sudo install -Dm644 ferrum-v0.7.13-x86_64-unknown-linux-gnu/docs/ferrum.1 /usr/local/share/man/man1/ferrum.1
ferrum --versionFrom source with Cargo
git clone --branch v0.7.13 --depth 1 https://codeberg.org/ominiverdi/ferrum.git
cd ferrum
cargo install --path . --locked --force
ferrum --versionFull changes: https://codeberg.org/ominiverdi/ferrum/compare/v0.7.12...v0.7.13