OpenSquilla 0.3.0

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.

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.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, #81, and #88, which helped bring
Tokenjuice-backed tool compression and canonical tool-result projection into
OpenSquilla.

Thanks @lose4578 for #80, which helped extract the TUI backend/runtime
foundation.

Thanks @nice-code-la for #93 and #119, which helped preserve router
model-switch intent and harden router/MetaSkill execution.

Thanks @openvictory for #116, which fixed UTF-8 migration loading for yoyo
migrations.

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.