# OpenSquilla 0.5.0 Preview 1

## Overview

OpenSquilla 0.5.0 Preview 1 is a preview release for the next routing and
managed-execution line. The headline feature is dynamic Model Ensemble routing:
OpenSquilla can route across multiple candidate models, progressively reveal
results, and still fall back to direct single-model defaults when that is the
better fit. The second major theme is sandbox and managed-execution alignment,
followed by Control UI polish, OpenTUI preview reliability, and Windows/runtime
cleanup.

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

## What's Improved

### Model Ensemble and smarter provider routing

Dynamic Model Ensemble routing is a first-class preview feature: OpenSquilla
can route across multiple candidate models, progressively reveal results, and
fall back to direct single-model defaults when that is the better fit.
OpenAI-compatible and Codex-oriented provider paths are easier to select,
inspect, and combine with router timeout tuning and clearer target labels for
model requests.

### Managed execution and sandbox alignment

Sandbox run modes, approval boundaries, and managed host execution now share
clearer authorization behavior and diagnostics. This preview also tightens
gateway lifecycle conflict reporting and cross-platform subprocess handling.

### Desktop and Control UI polish

The desktop app and Control UI improve router/provider settings, drag-and-drop
attachments, history materialization, image preview navigation, settings
restore, refreshed-session recovery, and package runtime checks.

### OpenTUI preview and terminal reliability

OpenTUI preview work continues with stronger terminal behavior, while Windows
process cleanup, GBK/UTF-8 subprocess handling, pidlock behavior, and gateway
runtime diagnostics are more predictable.

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

```toml
[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-rc1-mac-arm64.dmg`
- macOS desktop zip: `OpenSquilla-0.5.0-rc1-mac-arm64.zip`
- Windows desktop installer: `OpenSquilla-0.5.0-rc1-win-x64.exe`

Code signing policy: [`docs/code-signing-policy.md`](https://github.com/opensquilla/opensquilla/blob/v0.5.0rc1/docs/code-signing-policy.md).

Terminal and automation downloads:

- Python wheel: `opensquilla-0.5.0rc1-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.

Privacy and third-party attribution are documented in
[`PRIVACY.md`](https://github.com/opensquilla/opensquilla/blob/v0.5.0rc1/PRIVACY.md) and
[`THIRD_PARTY_NOTICES.md`](https://github.com/opensquilla/opensquilla/blob/v0.5.0rc1/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 1
over the existing tool environment:

```sh
uv tool install --python 3.12 --force --reinstall-package opensquilla \
  "opensquilla[recommended] @ https://github.com/opensquilla/opensquilla/releases/download/v0.5.0rc1/opensquilla-0.5.0rc1-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.0rc1 portable zip or `/releases/latest/download/` portable alias.

## Acknowledgements

Thanks to the contributors whose work is newly present in the 0.5.0 Preview 1
release surface:

- [@ab2ence](https://github.com/ab2ence) for drag-and-drop attachment work,
  dynamic Model Ensemble routing, and ensemble timeout tuning.
- [@Liu-RK](https://github.com/Liu-RK) for sandbox authorization alignment and
  managed execution host routing.
- [@TUOXI293](https://github.com/TUOXI293), a first-time OpenSquilla release
  contributor, for image preview navigation.
- [@tqangxl](https://github.com/tqangxl), a first-time OpenSquilla release contributor,
  for gateway lifecycle conflict diagnostics and SQLAlchemy core dependency work.
- [@HuaXiawithMoon](https://github.com/HuaXiawithMoon), a first-time OpenSquilla
  release contributor, for WeCom AI Bot websocket mode work.

See [`CONTRIBUTORS.md`](https://github.com/opensquilla/opensquilla/blob/v0.5.0rc1/CONTRIBUTORS.md)
for the full attribution ledger and PR/commit evidence.