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

OpenSquilla 0.5.0 Preview 3

Overview

OpenSquilla 0.5.0 Preview 3 is a broad preview release for the 0.5 runtime, desktop, routing, and deployment line. It adds a transactional migration path for older OpenSquilla homes, expands provider and router choices, strengthens the shared agent runtime, refreshes the terminal and Control UI experiences, and introduces prebuilt multi-architecture container images.

Existing CLI and desktop configuration remains in place when it already lives in the active OpenSquilla home. Retired Windows portable homes and other legacy or relocated homes can now be discovered, previewed, and imported explicitly.

Preview 2, Preview 1, and 0.4.1 clients should not wait for an in-app RC3 notification. Those released clients either predate the macOS prerelease feed resolver or consult GitHub's stable-only latest-release endpoint, so a correctly marked RC3 pre-release is not reliably visible to them. Install Preview 3 manually using one of the pinned downloads below. Preview 3 includes the macOS resolver needed for future same-line preview and stable updates.

✨ What's Improved

Legacy home migration and upgrade safety

opensquilla migrate now detects legacy OpenSquilla homes alongside the existing migration sources. The dedicated opensquilla migrate opensquilla path supports CLI homes, retired Windows portable data directories, desktop homes, restored backups, Docker volumes, and other explicit source paths.

Migration is dry-run by default. Apply mode stages the complete import, normalizes stale paths and configuration, moves inline provider secrets to .env, pauses imported scheduled jobs, and publishes the target transactionally. Recovery metadata makes interrupted imports repeatable instead of leaving a partial home or forcing users to discard their source data.

Desktop onboarding, Settings, gateway boot diagnostics, doctor, and the Web UI surface legacy data and provide the matching recovery command. Configuration formats from every released OpenSquilla version remain supported, so older homes can be imported without hand-editing their files.

Providers, models, and routing

TokenRhythm support now includes a verified provider integration, a curated router ladder, a static ensemble profile, live model-limit corrections, and GLM 5.2 coverage. The ensemble configuration has been redesigned around clear presets and custom lineups.

New provider coverage includes Tencent TokenHub and Token Plan for the Hunyuan hy3 family, plus Alibaba Cloud IQS for runtime web search. Live catalogs and model discovery expose fuller model lists and current limits. Provider probes report latency, per-model context-window overrides participate in budgeting, API-key shape diagnostics catch common setup mistakes, and an explicitly saved llm.base_url now wins over provider environment defaults.

Provider request and stream handling has tighter compatibility across strict OpenAI-compatible gateways, DashScope thinking and prompt-cache behavior, reasoning-only responses, length limits, and one-shot thinking fallbacks. Code-task subagents inherit the configured provider and fail early when the selected credentials cannot be used.

The opt-in router self-learning loop can collect privacy-preserving routing features, learn from explicit feedback, evaluate candidate heads offline, and roll back a regressed promotion. It remains disabled unless the operator turns it on.

Desktop, terminal, and Control UI

The terminal UI gains a substantial interaction and rendering overhaul, including inline approvals and clearer live activity. The Control UI adds a theme engine, improved monitoring and diagnostics, safer Settings navigation, copyable desktop-shell commands, better image navigation, compact long tool traces, and an opt-in background-music player for user-supplied media.

Desktop fixes cover gateway boot recovery, language selection, Windows native theme behavior, the macOS prerelease feed resolver, gateway lifecycle guidance, and packaged CLI invocation. Chat keeps scroll position and token-linked state more reliably, while code blocks and skill details are easier to inspect and copy.

Attachments can now accept opaque file types without parsing their contents, with bounded upload memory and workspace disk usage. Large valid UTF-8 text files and larger channel downloads have clearer, safer staging behavior.

Runtime, safety, and data reliability

Persistence migrations, scheduling, session cleanup, MCP lifecycle, channel reply routing, provider retry behavior, context compaction, tool dispatch, and workspace writes have all received contract hardening. The per-turn objective reminder is now off by default to preserve provider prompt-cache reuse and avoid unnecessary repeated reasoning.

The gateway now disables CORS by default and rejects cross-origin browser requests to state-changing routes unless the origin is explicitly allowed. Diagnostics redact more secret shapes, provider credential reveal windows are shorter, and sandbox/search/file-access boundaries are more consistent across platforms.

Container deployment

Release tags now build and publish a prebuilt gateway image for both linux/amd64 and linux/arm64:

• ghcr.io/opensquilla/opensquilla:v0.5.0rc3
• ghcr.io/opensquilla/opensquilla:latest

Docker latest follows the most recently pushed release tag, including previews and backports. Use the versioned tag for reproducible deployments and rollback. State remains in the configured volume when the container is replaced.

Downloads

Recommended desktop downloads:

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

The Windows desktop installer is currently unsigned. See the code signing policy before installation.

Terminal and automation downloads:

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

Updater metadata:

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

No Windows portable assets are published for 0.5.0 preview releases. Existing 0.4.x portable downloads remain on their original release pages so users can recover the old data directory, but new installations should use Electron, the versioned Python wheel, or the container image. Do not expect a new 0.5.0rc3 portable zip or a portable /releases/latest/download/ alias.

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

Upgrading from Preview 2, Preview 1, or 0.4.1

Quit the running desktop app and gateway before replacing them. macOS users should drag the new app into Applications, eject the DMG, and open the Applications copy. Windows users should run the new installer. Existing active home configuration and session data are reused.

When moving from Preview 3 to RC4 or a later Windows Desktop build, install the new package directly over the existing installation. Do not uninstall Preview 3 first: its uninstaller may remove %APPDATA%\OpenSquilla. Back up that directory before upgrading. RC4 and later installers preserve profile data during a normal uninstall.

Back up the active home before upgrading if you may need to roll back. Preview 3 relocates data left in older desktop layouts; after that relocation, downgrading to Preview 2 or Preview 1 can make workspaces, skills, secrets, or sessions look missing because those builds still expect the old paths. Prefer restoring a backup over running an older client against a migrated home.

CLI users can reinstall the published wheel over the current tool environment:

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

To inspect legacy OpenSquilla data before importing it:

opensquilla migrate

The command is a dry-run unless --apply is present. For a retired Windows portable home, the explicit path is also available:

opensquilla migrate opensquilla --kind windows-portable
opensquilla migrate opensquilla --kind windows-portable --apply

If multiple portable homes are found, use the displayed chooser or pass --home <path>. The source is left untouched after a successful import.

Container users should pin this release for reproducible deployments:

docker pull ghcr.io/opensquilla/opensquilla:v0.5.0rc3
docker compose up -d

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

[privacy]
disable_network_observability = true

The legacy compatibility environment variables OPENSQUILLA_TELEMETRY_DISABLED=true and OPENSQUILLA_UPDATE_CHECK_DISABLED=true remain honored.

Acknowledgements

Thanks to the human contributors whose work is newly present in Preview 3:

• @ab2ence for desktop gateway boot recovery.
• @JarvisPei for desktop language resolution and the opt-in background-music player.
• @labulalala for more reliable Windows source-installer PATH setup and clearer shell guidance.
• @Liu-RK for token deep links, zero-output chat recovery, and sandbox file-access alignment.
• @lyteen for the router self-learning foundation adopted into the hardened opt-in loop.
• @nice-code-la for verified coding-provider router presets.
• @TUOXI293 for chat, code-copy, skill-details, tool-trace, title-bar, and native-theme improvements.

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