OpenSquilla 0.3.1

Overview

OpenSquilla 0.3.1 is a maintenance release for the 0.3 line. It updates the stable install path while bringing the most user-visible fixes from the integration branch onto the release line.

The release focuses on making day-to-day use less fragile: chat messages render as authored, Slack channel setup and replies keep the context they need, media and voice workflow handoffs are easier to continue, and invalid provider or release states are caught earlier.

🛠 Fixed

Chat and channel replies keep their context

WebChat now preserves multiline user messages and gives authored messages more readable spacing. Slack setup and reply paths also keep more of the context they need, including Socket Mode and app-mention setup, signing-secret checks, existing-secret preservation, and thread/channel metadata for replies.

Workflow handoffs recover more cleanly

Voice/audio, media helper, and MetaSkill clarification handoffs are now on the stable release line. The bundled short-drama and video helper workflows remain available, with Windows-safe script handling and review pauses so generated workflow output is easier to inspect before continuing.

Provider and release checks fail earlier

Malformed tool-call history is kept away from providers before it becomes an invalid request. PR CI also classifies changed files by impact surface, so docs, runtime, dependency, release, and test changes can trigger the checks they need without forcing unnecessary work for every pull request.

Changed

• Release installer defaults now point to v0.3.1.
• README, quickstart, MCP, and operations docs now use the 0.3.1 wheel URL.
• pyproject.toml, uv.lock, release consistency tests, and install-script tests now agree on version 0.3.1.
• docs/releases/0.3.1.md is the GitHub Release body source for the final release review.

Downloads

• Python wheel: opensquilla-0.3.1-py3-none-any.whl
• Windows portable: OpenSquilla-0.3.1-windows-x64-py312-recommended-portable.zip
• Stable Windows portable alias: OpenSquilla-windows-x64-portable.zip
• Checksums: SHA256SUMS

Linux and macOS users should install the Python wheel with uv tool install. Windows users can use either the wheel or the portable zip.

The stable Windows portable alias contains the same build as the versioned portable zip, but keeps a fixed filename for scripts and docs.

Upgrading from 0.3.0

If OpenSquilla was installed with uv tool install, reinstall 0.3.1 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.3.1/opensquilla-0.3.1-py3-none-any.whl"

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

Windows portable users should extract the 0.3.1 zip to a fresh folder, or replace the whole extracted 0.3.0 folder while the gateway is stopped. Do not copy only individual files from the new zip into an old portable tree.

Acknowledgements

Thanks @openvictory for #123, #133, and #137, which helped bring visible running-state feedback plus short-drama and media helper workflows into the 0.3.1 release line.

Thanks @freeaccount-create for #142, which helped bring Slack Socket Mode and self-targeting replies into the channel workflow.

Thanks @ruhook for #124, and thanks @qq712696307 for the authored commit in that pull request, which preserved user message newlines in WebChat.

Thanks @Cola-Alex for #143, which increased tokenjuice summarize and failure-context windows for fallback tool-result projection.

Thanks @nice-code-la for #165 and #166, which helped make voice workflows usable end to end and clarification pauses resume cleanly.