LightAgent v0.10.2

LightFlow Runtime Hardening

Highlights

• Added a thread-safe CancellationToken with parent-child propagation across LightFlow steps, Jobs, agents, and subagents.
• Made cancellation execution-scoped and addressable by run ID, preventing cancellation state from leaking into later runs.
• Normalized agent exceptions into the existing retry and fallback paths while keeping internal exception details out of user-facing output.
• Improved soft-timeout cleanup so timed-out runs return promptly without blocking on executor shutdown.
• Added stable run and job idempotency keys and propagated them across runtime boundaries.
• Expanded runtime documentation and regression coverage for cancellation, timeout, fallback, and idempotency behavior.

Compatibility

Existing agent.run(...) and streaming defaults remain compatible. Timeout retries or fallbacks that are allowed to overlap a still-running timed-out task must now opt in explicitly with allow_timeout_overlap=True. The safer default avoids duplicate side effects.

Credits

This release integrates the cancellation, exception normalization, and timeout findings from #97, #98, and #99. Thanks to XuQuanxin04 for identifying and proposing fixes for these runtime edge cases.

Verification

• 289 tests passed, 1 skipped
• Python 3.10, 3.11, 3.12, and 3.13 CI passed
• compileall and git diff --check passed
• Source distribution and wheel built successfully
• Isolated wheel installation and import verified version 0.10.2

Full changes: #103