v0.6.5 release

LightAgent v0.6.5 Release Notes

We are pleased to announce the release of LightAgent v0.6.5. This release focuses on runtime stability, structured diagnostics, tool argument validation, and test coverage while preserving backward compatibility for existing agent.run() usage.

Upgrade Guide

pip install --upgrade lightagent>=0.6.5

New Features

• Structured Run Results: Adds optional RunResult support through agent.run(..., result_format="object") for callers that need content, tool_calls, trace_id, usage, and error fields.
• Structured Stream Events: Adds optional StreamEvent support through agent.run(..., stream=True, result_format="event").
• Catchable LightAgent Errors: Adds LightAgentError for programmatic error handling alongside the existing user-facing error-code taxonomy.
• Tool Argument Validation: Validates required tool parameters and basic JSON-schema-like parameter types before dispatch.

Compatibility

Existing default behavior is preserved:

response = agent.run("hello")

still returns a string by default.

Streaming behavior is also preserved:

response = agent.run(query, stream=True, user_id=user_id)
for chunk in response:
    print(chunk)

still returns the legacy stream generator by default.

Structured outputs are opt-in only.

Improvements

• Exports RunResult, StreamEvent, and LightAgentError from the public package API.
• Adds documentation for result_format="object" and result_format="event".
• Adds focused tests for compatibility, runtime tools, structured results, stream events, error handling, and tool validation.

Tests

• python -m compileall -q LightAgent example tests/test_v065_core.py
• PYTHONPATH=. python -m pytest -q tests/test_v065_core.py
• PYTHONPATH=. python tests/example.py

What's Changed

• feat: start v0.6.5 stability work

Full Changelog: v0.6.4...v0.6.5