opensquilla--opensquilla/docs/releases/0.5.0rc2.md

OpenSquilla 0.5.0 Preview 2

Overview

OpenSquilla 0.5.0 Preview 2 is a preview maintenance release for the 0.5 routing and desktop/runtime line. It keeps the default path on the single-model squilla_router, while the front-end ensemble toggle still defaults enabled ensemble sessions to the packaged static_openrouter_b5 profile. This preview focuses on provider/router recovery, Web UI upload refresh, desktop and session stability, and CI contract repair before the next 0.5 release candidate.

Existing gateway configuration and session data stay in place. Users upgrading from 0.4.1 or 0.5.0 Preview 1 should close any running desktop app or gateway process, install the 0.5.0 Preview 2 package, and restart OpenSquilla.

What's Improved

Model Ensemble and provider routing

Provider and router settings are easier to recover and inspect across the Web UI, desktop onboarding, config provenance RPCs, and the provider catalog. Fresh installs continue to use the direct single-model router path by default. Users who explicitly enable ensemble mode get the static OpenRouter B5 profile as the default ensemble selection, with doctor and timeout checks scoped to that opt-in path.

Managed execution and sandbox alignment

Cancelled turns, sandbox denial resume recovery, approval grant behavior, and bounded code-task verification have tighter rollback and recovery behavior. The code-task build scaffold now stays non-interactive by using the scaffold package's supported skip flag.

Desktop and Control UI polish

The desktop app and Control UI improve local HTML artifact opening, desktop reopen behavior, session deletion, attachment isolation, composer draft persistence, refreshed-session recovery, empty states, voice readiness, and ensemble progress trace display.

Web UI uploads and runtime contracts

Expired or near-expired staged uploads refresh their file UUIDs before send when the original local file is still available. The Preview 2 branch also repairs main CI contract drift around onboarding status fields, router mode classification, migration/provider persistence, and static-B5 doctor coverage.

Non-user-initiated network observability can be disabled before startup with OPENSQUILLA_PRIVACY_DISABLE_NETWORK_OBSERVABILITY=true or:

[privacy]
disable_network_observability = true

That unified switch covers automatic install telemetry, passive update checks, and desktop startup auto-update checks. The legacy compatibility environment variables OPENSQUILLA_TELEMETRY_DISABLED=true and OPENSQUILLA_UPDATE_CHECK_DISABLED=true remain honored; manual user-initiated release, download, or update checks may still contact GitHub after user intent.

Downloads

Recommended desktop downloads:

• macOS desktop installer: OpenSquilla-0.5.0-rc2-mac-arm64.dmg
• macOS desktop zip: OpenSquilla-0.5.0-rc2-mac-arm64.zip
• Windows desktop installer: OpenSquilla-0.5.0-rc2-win-x64.exe

Code signing policy: docs/code-signing-policy.md.

Terminal and automation downloads:

• Python wheel: opensquilla-0.5.0rc2-py3-none-any.whl
• Checksums: SHA256SUMS

No Windows portable assets are published for 0.5.0 preview releases. Existing 0.4.x portable downloads remain available on their original release pages for legacy scripts and portable-folder workflows. New Windows users should use the Electron installer or the terminal wheel install path. Do not expect a new 0.5.0rc2 portable zip or /releases/latest/download/ portable alias.

Privacy and third-party attribution are documented in PRIVACY.md and THIRD_PARTY_NOTICES.md.

Updater metadata:

• latest-mac.yml
• latest.yml
• *.blockmap

Upgrading from 0.4.1

If OpenSquilla was installed with uv tool install, reinstall 0.5.0 Preview 2 over the existing tool environment:

uv tool install --python 3.12 --force --reinstall-package opensquilla \
  "opensquilla[recommended] @ https://github.com/opensquilla/opensquilla/releases/download/v0.5.0rc2/opensquilla-0.5.0rc2-py3-none-any.whl"

The release installers use the same forced reinstall path. Close any running OpenSquilla gateway or desktop app before upgrading, then restart it after the install. Existing ~/.opensquilla/config.toml and session data are reused.

Desktop users should quit the running desktop app before replacing it. macOS users install the .dmg by dragging OpenSquilla into Applications, ejecting the mounted DMG, and opening the Applications copy. If the Dock icon keeps bouncing or startup reports a busy/translocated app, force quit any old OpenSquilla process, eject the DMG, and reopen OpenSquilla. Windows users run the .exe installer.

Legacy Windows portable users should switch to the Windows Electron installer or terminal wheel install path for 0.5.0 previews. Do not expect a new 0.5.0rc2 portable zip or /releases/latest/download/ portable alias.

Acknowledgements

Thanks to the contributor whose work is newly present in the 0.5.0 Preview 2 release surface:

• @HuaXiawithMoon for keeping code-task build scaffolding non-interactive.

See CONTRIBUTORS.md for the full attribution ledger and PR/commit evidence.