Repository navigation
ServerFS v0.19.0
Highlights
Generic standards-first ACP v1 profiles ship alongside native Codex, Claude and Qoder runtimes. Profiles use an operator-configured absolute executable and fixed argv, with a workspace-write boundary.
Real ACP acceptance
OpenCode 2.1.2 using opencode/glm-5.3-flash-free passed real-prompt, persisted-session continuation, and active-tool cancellation and cleanup acceptance on Linux, macOS and Windows.
Reliability
Fixed a Windows ACP process-stop race with a bounded synchronization wait while keeping shutdown fail-closed.
Security/capability boundary
The ACP Registry is reference metadata, not a trust root. Provider authentication remains provider-owned. Task-level command/argv/env overrides, ACP model discovery/override, elicitation, client filesystem access and terminal access remain unsupported.
Release artifacts
The tag workflow publishes GHCR exact-version, 0.19 and latest image tags, and builds three Windows wheels plus serverfs-plugin-v0.19.0.zip. Production deployments should pin exact versions.
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.19.0-py3-none-any.whl | ServerFS env | 11b4d43556f45196a26e101e152666bfe1468ba9dda2e95908c6c123ce4536f8 |
| serverfs_windows_native-0.19.0-cp312-abi3-win_amd64.whl | ServerFS env | e4259b6e54aa72c81c30a0c196591e1cd553707561bd23ef18e42d962f437735 |
| serverfs_agent_bridge-0.19.0-py3-none-any.whl | Agent Bridge env | 78f69fc9f200229d04d360b43cddb2dd6b62f2d88a6595ec79bd4e629968eae3 |
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.19.0/serverfs_mcp-0.19.0-py3-none-any.whl https://github.com/NTLx/ServerFS_MCP/releases/download/v0.19.0/serverfs_windows_native-0.19.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.19.0/serverfs_agent_bridge-0.19.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.19.0/serverfs_windows_native-0.19.0-cp312-abi3-win_amd64.whl" --sha256 e4259b6e54aa72c81c30a0c196591e1cd553707561bd23ef18e42d962f437735