Skip to content

ServerFS v0.22.0

Choose a tag to compare

@github-actions github-actions released this 23 Oct 02:35

ServerFS v0.22.0 — Correlated Agent Diagnostics

ServerFS v0.22.0 adds bounded, process-local Correlated Agent Diagnostics inside the Agent Bridge. Operators can inspect a diagnostics snapshot and the causal event sequence for an individual task through private Bridge RPC/CLI surfaces. The feature preserves the v0.21 observation contract and metric semantics.

Scope and compatibility

  • Phase F acceptance passed on Linux/VPS, supported macOS, and supported Windows; Phase G release-readiness acceptance passed.
  • Diagnostics remain private to the Agent Bridge. This release adds no public MCP tool, listener, persistent trace store, OpenTelemetry dependency/exporter, or telemetry egress.
  • Existing v0.21 bounded process-local observations and common native status projection remain compatible; diagnostics do not redefine their metrics or durable task state.

Acceptance evidence

Artifacts

Release assets include the Linux container image, the Windows product and Agent Bridge distributions with the native kernel wheel, and the portable Agent Plugin. Windows wheel installation instructions and SHA-256 digests follow.

Windows installation assets (Python >= 3.12; no Rust/MSVC/Docker required)

The three release wheels install into two isolated environments, matching the
frozen ServerFS/Agent-Bridge process boundary (the supervisor selects the Bridge
interpreter through SERVERFS_BRIDGE_PYTHON; the packages never share one dependency
graph):

file installs into sha256
serverfs_mcp-0.22.0-py3-none-any.whl ServerFS env d54b78b90058e53ab8f365e30a5e35f84434d7504c4b9679f0709624d75e891b
serverfs_windows_native-0.22.0-cp312-abi3-win_amd64.whl ServerFS env 945f301c366ebe92dcad04958986a157b77473a0fa6d3d2bf66ae58db052c6ee
serverfs_agent_bridge-0.22.0-py3-none-any.whl Agent Bridge env 17c94f51b4100a892e5856120932b5ff9681566490172113774910cf7287f27f

ServerFS environment (product + native kernel):

uv venv --python 3.12 .venv-serverfs
uv pip install --python .venv-serverfs/Scripts/python.exe https://github.com/NTLx/ServerFS_MCP/releases/download/v0.22.0/serverfs_mcp-0.22.0-py3-none-any.whl https://github.com/NTLx/ServerFS_MCP/releases/download/v0.22.0/serverfs_windows_native-0.22.0-cp312-abi3-win_amd64.whl

Agent Bridge environment (Bridge + provider SDKs; it must NOT contain the product):

uv venv --python 3.12 .venv-bridge
uv pip install --python .venv-bridge/Scripts/python.exe https://github.com/NTLx/ServerFS_MCP/releases/download/v0.22.0/serverfs_agent_bridge-0.22.0-py3-none-any.whl

Point the ServerFS supervisor at the Bridge interpreter (set this in the environment
that starts serverfs supervisor; it is not a provider setting and does not belong in
[agent] config):

$env:SERVERFS_BRIDGE_PYTHON = "<path>\.venv-bridge\Scripts\python.exe"

Verified native-wheel storage alternative:

serverfs bootstrap native-wheel --url "https://github.com/NTLx/ServerFS_MCP/releases/download/v0.22.0/serverfs_windows_native-0.22.0-cp312-abi3-win_amd64.whl" --sha256 945f301c366ebe92dcad04958986a157b77473a0fa6d3d2bf66ae58db052c6ee