Skip to content

v0.12.0 — One Host storage layout, Entra ID OAuth, Host-bound OAuth tokens, per-user files

Choose a tag to compare

@jozer-rami jozer-rami released this 28 Oct 09:35
· 23 commits to main since this release
e6a2db7

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-merge init 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-v2 profile): tenant ID prompt at discovery, editable scopes, and no RFC 8707 resource sent to Entra (#1176).
  • The OAuth broker binds user-token and grants/exists to 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>/outputs are 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 (mode 700). <key> is the first 16 hex characters of sha256("rpc:<userId>").

OAuth broker (#1193).

  • control-api must run as a single replica with the Recreate strategy, as deploy/base sets.
  • 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_IMAGE env (#1075).
  • webhook-proxy's port 9090 is renamed from metrics to health in 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