# Upgrade Report — v25

Version: `25.0.0`

## Summary

v25 is a Swarm shell hardening and preservation release. It treats the pasted `Swarm · multisignature.io` multimodal shell as the final primary chat UI directive while preserving all richer operational runtimes from earlier releases.

## Decisions

- `/swarm-chat/` is the exact polished multimodal shell: text, image, document, simulated voice memo UI, signed receipts, wallet chip, theme persistence, and non-custodial posture language.
- `/swarm-chat/room-os.html` remains the preserved richer room OS for roster, BYOK providers, turn policy, QFTransport rails, checkpointing, egress ledger, and multi-agent orchestration.
- `/swarm-chat/orchestrator.html` is restored as a backwards-compatible BYOK orchestration lab with isolated `orchestrator-js/` dependencies.
- `integrations/swarm-multimodal-shell-v25/index.html` preserves the primary shell source as an auditable integration artifact.

## Security boundary

The primary Swarm shell remains a UI/runtime shell. It does not auto-sign transactions, auto-broadcast transactions, move value, call model providers by default, or store wallet/private keys server-side. The room OS and privacy modules remain the right place for production wallet/device binding, policy evaluation, encrypted checkpointing, and transport configuration.
