Skip to content

v0.2.13

Choose a tag to compare

View all tags
@jin-bo jin-bo released this 24 Apr 16:13
· 192 commits to main since this release
v0.2.13
02272b0

Agentao 0.2.13

Promotes 0.2.13rc1 to general availability and folds in one additive
feature — monorepo-aware skill install — discovered during the soak.

Most of the substantive feature work — the session replay subsystem
(agentao/replay/), the runtime decomposition across runtime/,
acp_client/manager/, cli/commands_ext/, the new prompts/ and
tooling/ packages, and the agentao --help / -h fix — landed in
the 0.2.13rc1 soak build. See the
CHANGELOG.md [0.2.13] entry for the full
Added / Changed breakdown.

Library-code delta vs 0.2.13rc1: one additive feature —
monorepo skill install. Backwards-compatible; no existing surfaces
change shape.

  • agentao/skills/sources.py: SourceSpec gains package_path: str;
    GitHubSkillSource.resolve() parses owner/repo:path[@ref] and
    rejects empty / absolute / . / .. path components.
  • agentao/skills/installer.py: _find_package_root() accepts an
    optional package_path, validates it exists, is a directory, and
    contains SKILL.md. The recorded source_ref preserves the full
    owner/repo:path@ref string so skill update round-trips.
  • agentao/cli/entrypoints.py: skill install help text advertises
    the new form.
  • Coverage: tests/test_skill_installer.py, tests/test_skill_cli.py.

The rest of the GA cut is a packaging + documentation pass:

  • agentao/__init__.py bumped 0.2.13rc1 → 0.2.13
  • docs/ACP.md version examples aligned to 0.2.13
  • README and docs/QUICKSTART.md Quick Start now list all three
    required provider variables (OPENAI_API_KEY, OPENAI_BASE_URL,
    OPENAI_MODEL). Previously only OPENAI_API_KEY was shown, which
    contradicts the strict-provider-gating behaviour introduced in
    0.2.11 — the single-key snippet raised ValueError at startup
  • docs/SKILLS_GUIDE.md and developer-guide/en|zh/part-5/2-skills.md
    document the new monorepo skill install form with worked examples
    against anthropics/skills
  • .github/workflows/jekyll-gh-pages.yml replaced by a VitePress build
    • deploy pipeline pointed at developer-guide/. The previous
      workflow was a repo-init Jekyll template; the actual docs site is
      VitePress, so the Pages deploy was effectively a no-op
  • Developer-guide install-pin / version-check examples refreshed from
    0.2.10 / 0.2.11 to 0.2.13 in part-1/5-requirements.md,
    part-2/1-install-import.md, part-3/2-agentao-as-server.md
    (JSON response example), and part-3/5-zed-ide-integration.md
    (en + zh mirrors). Historical statements ("Since v0.2.10…",
    "Pre-0.2.10 Agentao used…") are deliberately kept — they record when
    a surface was introduced, not the current pin

Highlights

  • Monorepo skill install (new in GA): agentao skill install owner/repo:path[@ref] pulls a single skill out of a multi-skill repository — e.g. agentao skill install anthropics/skills:pptx@main installs only the pptx/ subdirectory. See docs/SKILLS_GUIDE.md for worked examples against anthropics/skills (pptx, docx, xlsx, pdf, doc-coauthoring). Coverage: tests/test_skill_installer.py, tests/test_skill_cli.py.

Inherited from 0.2.13rc1:

  • Session replay subsystem: JSONL timeline of runtime events written
    to .agentao/replays/. Covers recorder, reader, redaction, retention,
    and sanitization. Wired through transport/events.py; surfaced by the
    new cli/replay_commands.py and replay_render.py. Feature docs:
    docs/features/session-replay.md.
  • Runtime decomposition: four monolithic modules split into focused
    packages (agent.py → runtime/, acp_client/manager.py →
    manager/ package, cli/commands_ext.py → commands_ext/ package,
    plus new prompts/ and tooling/ packages). Public Agentao.chat()
    and tool_runner contracts are preserved; agentao/tool_runner.py
    is kept as a compat shim.
  • agentao --help / -h fix: the top-level CLI parser now handles
    --help / -h explicitly and exits 0 instead of silently falling
    through to interactive mode. Regression coverage in
    tests/test_acp_cli_entrypoint.py.

Release Summary

  • Version: 0.2.13
  • Git tag: v0.2.13
  • GitHub release type: regular release, not pre-release
  • Publish workflow: .github/workflows/publish.yml

Install

pip install -U agentao

Maintainer Checklist

  1. Ensure agentao/__init__.py reports 0.2.13.

  2. Run the smoke path:
    uv run python -m pytest tests/ && uv build && uv run twine check dist/*.

  3. Create and push the tag:

    git tag v0.2.13
git push origin v0.2.13

  4. Create the GitHub release for v0.2.13.

  5. Leave Set as a pre-release unchecked so
    .github/workflows/publish.yml publishes to PyPI (the workflow's
    tag-vs-package version consistency check will validate alignment
    before upload).

Full Changelog

See CHANGELOG.md for the 0.2.13 entry.

Assets 2
Loading