OpenSquilla 0.5.0 Preview 3

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.

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.