Skip to content

feat(evaluations): add runtime evaluator#1286

Open
jstar0 wants to merge 1 commit into
RailtownAI:mainfrom
jstar0:feat/runtime-evaluator
Open

feat(evaluations): add runtime evaluator#1286
jstar0 wants to merge 1 commit into
RailtownAI:mainfrom
jstar0:feat/runtime-evaluator

Conversation

@jstar0

@jstar0 jstar0 commented Jul 22, 2026

Copy link
Copy Markdown

Summary

Add a RuntimeEvaluator for comparing end-to-end wall-clock time across complete agent invocations. Run boundaries are retained on root agent data points, while open or incomplete runs are omitted instead of being reported as zero.

The evaluator reuses the existing numerical aggregate result, so serialized evaluation output includes minimum, maximum, mean, median, mode, and standard deviation without introducing a visualizer-specific result type. Legacy session payloads without per-run boundaries remain supported.

Closes #1163

Type of change

  • Bug fix
  • Feature
  • Breaking change
  • Docs
  • Refactor / chore / build / tests

Checklist

  • Lint & format pass (ruff check . && ruff format .)
  • Tests added/updated and pass locally (pytest tests)
  • Docs updated if user-facing behavior changed
  • Breaking changes include migration notes

Verification

  • pytest -q packages/railtracks/tests/unit_tests/evaluations packages/railtracks/tests/integration_tests/evaluations
  • ruff check . --no-fix
  • ruff format --check .
  • mkdocs build --strict

Notes

Runtime is recorded once for each run's root agent so nested agents do not duplicate a flow-level measurement. Failed runs with complete timing boundaries remain measurable; open and malformed runs are skipped.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feature] [Evaluation] RuntimeEvaluator

1 participant