OpenSquilla 0.3.0

Overview

Every agent workspace eventually grows little rituals: search this, inspect that, ask for the missing detail, write the report, keep the useful trace.

0.3.0 is the release where OpenSquilla starts saving those rituals instead of making you re-teach them every time.

OpenSquilla 0.3.0 brings MetaSkills into the product as reusable agent workflows. It also adds a practical Health Doctor, stronger structured tool-output compression, a real task-oriented documentation set, and a broad round of runtime/WebUI fixes for long-running agent work.

What’s New

MetaSkills: repeated work becomes a protocol

MetaSkills package repeatable multi-step work into reusable, inspectable workflows. This release adds the runtime pieces needed to make them practical: composition parsing, step scheduling, pause/resume user-input flows, run history, proposal gates, bundled stable MetaSkills, and authoring docs.

Use this when a task is more than a single prompt: research-to-report, document-to-decision, daily operating briefs, account watching, job-search preparation, kid project planning, academic paper drafting, and creating new workflow proposals. If a task has a shape you recognize, OpenSquilla can now start treating that shape as reusable product behavior.

Health Doctor: fewer mystery failures

opensquilla doctor and the WebUI Health view now turn runtime state into actionable findings. Provider, gateway, memory, logs, search, image generation, router, channels, sandbox, and embedding problems can now surface as concrete readiness diagnostics with recovery commands instead of scattered manual debugging. The goal is simple: when something is degraded, the product should say what needs attention.

Structured Tool Compression: noisy tools, cleaner context

Tool-heavy sessions are less likely to drown the model in raw output. The new Tokenjuice-backed projection path compacts large logs, diffs, JSON, test output, package-manager output, and other known tool shapes before they reach provider context, while OpenSquilla keeps runtime-side evidence and projection telemetry available for inspection.

Product Documentation: finally, a map

The repository now includes a real task-oriented docs set: quickstart, configuration, CLI, WebUI, providers, sessions, tools and sandboxing, usage and cost, memory, compaction, MetaSkills, tool compression, scheduling, channels, MCP, troubleshooting, and contribution guidance.

Fixed

Long Sessions and Compaction

Long-session memory and compaction flows now preserve raw archive evidence, checkpoint receipts, repair queues, and WebUI-safe status. Context safety, semantic memory quality, and repair work are reported as separate signals.

WebUI Chat and Artifacts

WebChat fixes cover router replay, session restore gaps, duplicate compaction status, attachment and pasted-text rendering, artifact downloads, composer layout, model-router animation timing, and visible recovery during long turns.

Runtime and Provider Handling

Provider/runtime hardening reduces malformed tool-call fallout, preserves configured model-switch intent, handles provider tool-choice requirements, and keeps oversized current-turn tool payloads from surfacing as bare internal failures.

Cross-Platform Reliability

CLI help rendering, sqlite fallback behavior, UTF-8 subprocess handling, Windows-only test fixtures, onboarding commands, and release-surface checks are more portable across supported platforms.

Downloads

Python wheel: opensquilla-0.3.0-py3-none-any.whl
Windows portable: OpenSquilla-0.3.0-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.

Upgrading from 0.2.1

If OpenSquilla was installed with uv tool install, reinstall 0.3.0 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.0/opensquilla-0.3.0-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; legacy agent_token_saving.tool_result_compression_* settings are ignored or migrated because Tokenjuice projection is now the built-in tool-result path.

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

Acknowledgements

Thanks @ab2ence for #56, #61, #81, #88, and #109, which helped bring Tokenjuice-backed tool compression, canonical tool-result projection, memory dream consolidation, chat streaming restore work, and cross-platform release gate hardening into OpenSquilla.

Thanks @lose4578 for submitting #80, and thanks cwan0785 (@Anonymous-4427 on GitHub) for authoring the TUI backend/runtime extraction commits behind that pull request.

Thanks @nice-code-la for #82, #93, #96, #110, #114 (replayed through #115), and #119, which helped preserve router model-switch intent, harden router/MetaSkill execution, and mature the retained high-value MetaSkill workflows.

Thanks @openvictory for #116, which fixed UTF-8 migration loading for yoyo migrations and helped keep the release gates aligned on Windows.

OpenSquilla’s Tokenjuice-backed projection includes a Python adaptation of rule-driven reduction ideas and bundled rules derived from vincentkoc/tokenjuice, redistributed under the MIT license. See THIRD_PARTY_NOTICES.md and src/opensquilla/plugins/tokenjuice/PROVENANCE.md for provenance details.