Skip to content

Ferrum v0.7.13

Choose a tag to compare

@ominiverdi ominiverdi released this 02 Nov 15:46
· 1 commit to main since this release

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. /session opens the picker, with /session all, /session new, /session delete, and /session info providing the remaining session operations. Alt+S, completion, inline hints, help, runtime guidance, and documentation use the same interface. /new remains 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 warnings passed.
  • 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 --version

Fedora / 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 --version

On 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 --version

From 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 --version

Full changes: https://codeberg.org/ominiverdi/ferrum/compare/v0.7.12...v0.7.13