OpenSquilla 0.3.1

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 records the GitHub Release body used for this release.

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.