Skip to content

Testing and CI

weego edited this page Nov 15, 2026 · 3 revisions

Testing and CI

LightAgent uses focused tests for core behavior and GitHub Actions for Python version coverage.

Local Focused Tests

From the repository root:

python -m compileall -q LightAgent tests/test_v065_core.py tests/test_v070_tracing.py tests/test_memory_policy.py tests/test_lightflow.py
PYTHONPATH=. python -m pytest -q tests/test_v065_core.py tests/test_v070_tracing.py tests/test_memory_policy.py tests/test_lightflow.py

These tests cover structured result compatibility, runtime tools, structured stream events, trace events, memory policy behavior, and LightFlow dependency ordering, retries, result formats, and flow trace events.

CI Matrix

The GitHub Actions workflow runs on:

  • Python 3.10
  • Python 3.11
  • Python 3.12
  • Python 3.13

The v1.0.0 release CI builds the wheel, checks a base install without MCP, runs the core acceptance suite, and smoke-tests an installed wheel. It also tests MCP SDK versions 1.12.4, 1.30.0, and 2.3.0 in separate jobs.

The 15-minute soak is manually triggered. Real Codex, Mem0 Graph, Docker, and LightResearch integration checks are not ordinary PR matrix results. See the v1.0.0 verification guide for exact scope and opt-in checks.

Workflow file:

.github/workflows/ci.yml

Example Smoke Tests

For manual checks, run examples one capability at a time:

python example/01.single_agent.py
python example/02.tools_agent.py
python example/04.multi_agent.py
python example/10.lightflow.py

Examples that call external providers require valid credentials. Memory, MCP, and browser examples require extra setup.

PR Checklist

  • Keep changes scoped.
  • Preserve default agent.run() compatibility unless a breaking change is intentional.
  • Add tests for new runtime behavior.
  • Update Wiki or docs for public API changes.
  • Run focused tests locally before opening a PR.

Clone this wiki locally