Repository navigation
ServerFS v0.22.0
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
- v0.22.0 design and acceptance plan
- Phase F Linux/VPS acceptance
- Phase F macOS acceptance
- Phase F Windows acceptance
- Phase G release-readiness preflight
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