Skip to content

LightAgent v0.10.0

Choose a tag to compare

View all tags
@wxai-space wxai-space released this 15 Aug 18:28
v0.10.0
28ed1c9
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Highlights

LightAgent v0.10.0 introduces a unified event-sourced Agent Runtime for durable, inspectable, and recoverable agent execution while preserving the existing lightweight agent.run() experience.

  • Add versioned Session, SessionEvent, and SessionStore contracts with in-memory, atomic JSONL, and transactional SQLite backends.
  • Add deterministic replay, event pagination, checkpoints, forks with lineage, schema migration hooks, exact model-request reconstruction, and incomplete/failed Turn detection.
  • Add compatible native async entry points with arun() and cancellable astream() resource cleanup.
  • Add scoped Capability Providers, deterministic conflict diagnostics, narrowing-only permissions, unified fail-closed Policy evaluation, lifecycle/health APIs, timeout/output limits, approvals, and credential-safe audit digests.
  • Add durable Inbox, Goals, multidimensional Budgets, no-progress detection, background Jobs, bounded subagents, pause/resume/cancel controls, 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, document lifecycle APIs, scope/owner/tenant filtering, and LIKE fallback when FTS5 is unavailable.
  • Add deterministic Skill precedence, conflict reporting, hierarchical AGENTS.md discovery, path traversal protection, and corrected skill.activate delegation.
  • Add MCP Streamable HTTP capability detection, reconnect attempts, refresh without duplicate tools, namespaces, external credential headers, and sanitized failure diagnostics.

Compatibility

  • Existing agent.run("hello"), agent.run(query, stream=True, user_id=user_id), structured results, Tools, Hooks, Guardrails, Memory, LightSwarm, and LightFlow APIs remain compatible.
  • New durable runtime features are opt-in and do not require applications to migrate existing synchronous calls.
  • Browser, Terminal, Shell, LSP, vector, sandbox, and hosted-service implementations remain external Capability Providers rather than required core dependencies.

Validation

  • Full test suite: 263 passed, 1 skipped.
  • v0.10 focused suite: 61 tests covering Session persistence, Policy, runtime state, MCP, Skills, async execution, LightFlow, RAG, and Provider adapters.
  • GitHub CI and wheel build passed on Python 3.10, 3.11, 3.12, and 3.13.
  • python -m compileall -q LightAgent and git diff --check passed.
  • The skipped test is the explicitly opt-in real Mem0 Graph security matrix, which requires an external backend configuration.

Documentation

See docs/runtime_v010.md and example/13.runtime_v010.py for the new runtime contracts and a local example.

Full changes: v0.9.7...v0.10.0

Assets 2
Loading