Important update — strongly recommended
We strongly recommend that all DollhouseMCP users update to 2.0.41. This is a significant reliability and policy-correctness fix, especially for installations that use the Permissions dashboard, active agents or ensembles, Gatekeeper enforcement, or persisted activation restore.
Upgrade
For global installations:
npm install -g @dollhousemcp/mcp-server@latestFor project-local installations:
npm install @dollhousemcp/mcp-server@latestFor npx-based client configurations, use @latest or pin @2.0.41, then restart the client so it starts the updated server.
What this fixes
- Runaway dashboard polling and resource amplification: Permissions dashboard polling no longer expands complete element catalogs and amplifies overlapping requests into sustained CPU, memory, parsing, activation, validation, and logging work. (#2618, #2621)
- Bounded active-policy resolution: reporting now uses lightweight indexed lookups, coalesces same-generation dashboard snapshots, deduplicates ensemble references, and resolves members through a bounded worker pool. (#2618, #2621)
- Fresh and correct enforcement: Gatekeeper enforcement reads remain fresh, while invalidations from overlapping storage scans are merged instead of being lost behind stale in-flight work. (#2618, #2621)
- Stable activation identity: policy-bearing agents retain their identity across metadata renames, filename collisions, deactivation, session-policy aggregation, deadlock relief, and restart restoration. (#2618, #2621)
- Serialized policy exports: concurrent export requests now drain through the newest queued work instead of allowing stale completion ordering. (#2618, #2621)
- macOS/Node 22 helper reliability: OAuth helper signal handlers are installed before readiness, fixing the shutdown race found by the extended compatibility suite. (#2618, #2621)
There are no intentional API breaks or unrelated product behavior changes in this patch. The behavior changes are confined to eliminating redundant policy work, preserving policy identity and freshness, serializing export completion, and correcting the helper readiness race.
Distribution
The release workflows publish:
- npm package
@dollhousemcp/mcp-server@2.0.41under thelatesttag with provenance - MCP Registry metadata
- the DollhouseMCP
.mcpbdesktop bundle and SHA-256 checksum - GitHub Packages
See CHANGELOG.md for the complete release history.