Repository navigation
v0.12.0 — One Host storage layout, Entra ID OAuth, Host-bound OAuth tokens, per-user files
A minor release, led by one storage layout for every Host, Microsoft Entra ID as a remote OAuth lane, Host-bound OAuth tokens, per-user generated files, and EvenDrive drag-and-drop. 1022 non-merge commits since v0.11.0. No breaking API changes. Some behaviour changes need an operator's attention; see Upgrade notes.
Storage and Hosts
- Every Host uses one storage layout on its workspace PVC, whatever its lifecycle. A
workspace-layout-mergeinit container folds older split layouts back into the PVC root on the Host's next start (#1111). - Workflow step tool allowlists are enforced when a tool is called, not only when tools are offered (#1061).
- Provider non-secret env resolves from per-Host env (#1079).
OAuth and connectors
- Remote OAuth lane for Microsoft Entra ID (
entra-v2profile): tenant ID prompt at discovery, editable scopes, and no RFC 8707 resource sent to Entra (#1176). - The OAuth broker binds
user-tokenandgrants/existsto the authenticated Host. The control token carries the Host uid, and the Context and user come from that Host, not from the request (#1193). - User-scope MCP OAuth is gated by the Context allowlist (#1088).
- The CIMD client metadata document is served publicly (#1074), and the OAuth install callback is read from control-api at runtime (#1077).
- Connectors show their authentication type in Control UI and the desktop app, with clearer access actions (#1059).
- Secrets → Connector tab: Add and Update per connector Secret, per-key rotation that waits for the connector rollout, and Secret reuse through a new picker (#858). The mcp-secrets list returns each Secret's identity (
uid,resourceVersion) (#1178).
Files and EvenDrive
- Chat-generated files are per user (
<workspace>/users/<key>/.clerum-outputs). One user never lists or downloads another user's files. Artifact generators are hardened (#931). - EvenDrive drag-and-drop moves in Control UI and the desktop app, with confirmation for folder moves and refused drops that explain why. Sharing dialogs show access inherited from parent folders, and changing or removing an inherited member updates the parent that grants it (#1167).
Guardrails and workflows
- Hook guards apply on the tool lane, and guardrail hooks are scoped to Host phases (#1078).
- Scheduled workflow runs default to
concurrencyPolicy: Forbid(#1062). - Snippet secret ownership is judged against the parent recipe (#1060).
Desktop app
- Faster chat open, with reopened transcripts kept in memory (#1112).
- Attachments survive a cancelled send, and folders download as a zip (#972). "New chat" sends always start a fresh chat (#976).
- Profile desktop handoffs route to the matching environment (#978), and the embedded app view runs on a state machine (#1148).
Security and accounts
- Invitation links are valid for 7 days (password-reset links stay at 48 hours), and retiring a Control Admin revokes their pending invitations (#1195).
- Verified accounts keep access under password-admission abuse (#1056).
- Platform NGINX images move to 1.30.6 for the October 2026 advisories (#1177), and platform images, tooling and CI require Node 24.22.1 (#1173).
Docs, tooling and UI copy
- The public docs are reorganized, completed, and cover production deployment, releases, monitoring, guardrails, OAuth connectors, LLM subscriptions, and the desktop app (#1064, #1065, #1066, #1068, #1071).
- Monitoring, dev-mode tooling, CRD descriptions and admin copy fixes (#1072, #1073, #1075, #1076). Test and build hygiene (#1070, #1097, #1198).
Upgrade notes
Four CRDs change: apply charts/clerum-crds before the app. mcpservers.clerum.io adds the optional, immutable spec.oauth.asProfile (enum entra-v2) with CEL rules: remote OAuth only, and only with a Microsoft Entra ID tenant issuer. hosts, llmhooks and globalfilesystems change descriptions only.
Host PVC layout (#1111). No flag is needed: CONTEXT_MAPPER_WORKSPACE_LAYOUT_MERGE defaults to true. Every Host restarts once and runs workspace-layout-merge. Before upgrading from v0.10.x or v0.11.x with stateless Hosts, run deploy/scripts/host-layout-merge.sh inventory. Copy /workspace/state.db* out of any desktop Host Pod first, or its history is lost. See Host PVC Layout Upgrade Note.
Generated files from before this release (#931).
- Chat files written before v0.12.0 to the shared
<workspace>/outputsare no longer listed or served. They stay on the volume, and mcp-host logs how many there are at startup. - To restore one, move it to its owner's
<workspace>/users/<key>/.clerum-outputs/folder (mode700).<key>is the first 16 hex characters ofsha256("rpc:<userId>").
OAuth broker (#1193).
- control-api must run as a single replica with the
Recreatestrategy, asdeploy/basesets. - After the upgrade, each Host gets one 401 on its control token and renews it.
- Context membership alone no longer grants a user's OAuth token on a Host: the user must enter that Host directly or through an active team.
Other behaviour changes.
- Workflow schedules default to
Forbid, so a run is skipped while the previous one is still live (#1062). - New invitations, desktop invitations, Control Admin invitations and setup resends last 7 days (#1195). Existing invitations keep their expiry.
deploy/base.
- NGINX gateway images move to
nginx:1.30.6-alpine(#1177). - The profile control funnel serves the public CIMD document at
/api/v1/.well-known/evenfire-mcp-client(#1074). - HCC drops the unused
STDIO_BRIDGE_IMAGEenv (#1075). - webhook-proxy's port 9090 is renamed from
metricstohealthin the Deployment, probes and Service (#1073). - Comment and doc-link updates in cluster-wide, cloudflared and the workflow-output PVC.
No new services, RBAC or ServiceAccounts, so no post-deploy RBAC sync is needed.
Desktop app. The v0.12.0 desktop builds use Electron 41.10.7, which bundles Node 24.18.0.
Images
Release images are promoted, not rebuilt. release-images.yml copies the exact digests already proven on :latest into :v0.12.0, so they are byte-identical to what was tested.
Pull by tag, or pin by digest:
ghcr.io/evenfire-ai/<image>:v0.12.0
The same set is attached to this release as release-images-v0.12.0.json, so a deployment can consume the digests directly rather than scraping this table.
| Image | Digest |
|---|---|
airtable-mcp-server |
sha256:1a14d5afe9c528f032b78e890fd15a1ca30c1a3e6f8f2cce3974ed6ca8373b44 |
channel-reader |
sha256:f93713e33d72a9098ea3bf4fdee82c64814e2423d8e00ea5228f99b7b33ed438 |
clerum-workflow-base |
sha256:3e04948b19ca723757ab89e07faff019473b2a32403e2ecfb29b94f5bb461709 |
codex-llm-proxy |
sha256:f1ac4e03e436d3cb5a32b341c35300a9221200accc4445bfe987055ccafcf112 |
control-api |
sha256:8fe74f2690f1d4f9147701e81677433b6e598fe857b3e37d21f248113dac40cf |
control-ui |
sha256:579f81e259163418df24a7bb1c6060aac7bfd9292001773d117b2ea1037c74b6 |
external-rest-api |
sha256:dfd6db6d0e3d9185fde202fd6ce33ff88a5994c06a57304d0e874a6e724b56ff |
gfs-controller |
sha256:e6270bc986d4d7d7acfef542b113833e34c593652e9fafd1c20512d8e8a4dd81 |
grok-llm-proxy |
sha256:eb35a9e64f3f915bcd3e6dd144252c4fc9db8d94b6dd179a95a3f458f3aafdd7 |
host-context-controller |
sha256:ca98abe6b44eaa4bfb1027db1c40da65dddc46490630635e260e9649b40006d4 |
mcp-host |
sha256:fcb71ee9667d1d5b3a92eec752d1c22c85607ad3cc2591d151bd6bb81992140b |
mcp-host-desktop |
sha256:0e4ca67e31a6fc6334a47334c840be81896c69901b70b8e219c7d0d9d053a715 |
mcp-host-full |
sha256:fc895d49b0fc0481d3434604fb7cccea700060dcf02b02c7e59b04824c0e5ffd |
mcp-host-slim |
sha256:b6ee231809b3e1c716705176c495d2e7ce595480c0a07074b6452d9a4aa53ea7 |
mcp-proxy |
sha256:7664c3596090ddb46edffa6b82eb73492cf4cfd8e32672b6ec02d75a25ddf766 |
mock-mcp-server |
sha256:06681f3a4c04f051e5df333824466497c6842030c383d899bc24ca259d98efd0 |
mock-stdio-mcp-server |
sha256:6c6dcb949c15344ec15e11169fb780953d2bd9764ecacf29f47aae376393d551 |
nginx-egress-proxy |
sha256:a9d15378dc33ea5b134113211fc9162aa20f13252f2438d96d82554bab06778a |
playwright-server |
sha256:fc603bbc05d216ca9394940463e5e216d0a48732c24555fb9b67d20775fccf73 |
profile-ui |
sha256:fae1e2730c27c44ecefd83321b81d3b199816c67fad56a27526b3a66e098b316 |
rpc-proxy |
sha256:f71ab9582bbd0ab005e39dc11df58860e00dcff38d0976265c95651181e6f6d9 |
stdio-bridge |
sha256:2ce4f40756c0250982dcb1889bda7cbebff42188be84e1c936d48e39a089df3a |
web-search-mcp |
sha256:e7ee4c9c5393049ecd8d7881d92f967e0d590ce7cfbc79506dfc1395dfb1bcb0 |
webhook-gateway |
sha256:56f934623110c8f52440d8069278bcca411c8ac95504ef050ea57c9e865d6e22 |
webhook-proxy |
sha256:a59a296364278f71191529ee2c8479741240457479b943d3e8b6aada9e3092f2 |
workflow-approval-request-reader |
sha256:1c34e9abd75dd9e546d3077bc18f747b55414a4192607f29faef964bc74a1428 |
workflow-coordinator |
sha256:4e88e488107e0a4762e571d1e2d78559d00ed767bfc0b19dca613fc757ea7edb |
workflow-recipes |
sha256:fb8c6b047dd94fb0ebba65118a4125f429b196d6b4ffad41586441c68065fc59 |
workflow-snippet-runner |
sha256:326b7fd9b13c99692756ab255bcd5a88554168882f81141f6b0b8c1c1a434670 |
workspace-files-controller |
sha256:cb59200cfde3248ad907fc9db8ac3e83fb54014bfa3834b170ca5e464696740b |