Release v0.10.0: Unified Event-Sourced Agent Runtime

[wxai-space]

Summary

• add versioned event-sourced Sessions with in-memory, JSONL, and SQLite stores, replay, pagination, checkpoints, fork lineage, migration hooks, context projection, and incomplete-Turn detection
• add compatible arun() / astream() APIs and persist balanced run, model, tool, policy, error, and terminal lifecycle events
• add scoped Capability Providers, deterministic conflict diagnostics, narrowing-only permissions, unified Policy, lifecycle/health APIs, and configuration-digest audit events
• add durable Inbox, Goals, model/tool/token/time/cost Budgets, progress detection, Jobs, bounded subagents, context compaction, and oversized tool-result references
• standardize adapters for Tools, Memory, Skills, MCP, LightFlow, RAG, and Session Search; add SQLite FTS5 retrieval with citations
• add deterministic Skill precedence and AGENTS.md discovery; add MCP Streamable HTTP capability detection, reconnect, refresh, namespaces, and external credential headers
• harden stream cleanup, Skill activation mapping, script path validation, and v0.10 regression coverage
• update version to 0.10.0, public exports, localized README News, roadmap, runtime documentation, and examples

Compatibility

The existing agent.run("hello"), stream=True, structured results, Tools, Hooks, Guardrails, Memory, LightSwarm, and LightFlow APIs remain compatible. New runtime features are opt-in, and optional Browser, Terminal, Shell, LSP, vector, sandbox, and hosted-service implementations remain external Providers.

Testing

• python -m pytest -q: 263 passed, 1 skipped
• v0.10 focused suite: 61 tests collected and passed
• python -m compileall -q LightAgent: passed
• git diff --check: passed
• GitHub Actions wheel build and full test suite: passed on Python 3.10, 3.11, 3.12, and 3.13

The skipped test is the opt-in real Mem0 Graph security matrix, which requires an external service configuration.

Review focus

• Session event schema, persistence failure behavior, and replay/fork semantics
• Policy ordering relative to existing Guardrails and Hooks
• async cancellation behavior for compatibility-wrapped synchronous clients
• MCP refresh/reconnect behavior against a real Streamable HTTP server
• public API naming before the v1.0 contract freeze