Skip to content

feat: enhance run events API with session_id and span_id filters, and add export functionality#42

Merged
Gsbreddy merged 2 commits into
mainfrom
2026-05-02-h8gi
May 2, 2026
Merged

feat: enhance run events API with session_id and span_id filters, and add export functionality#42
Gsbreddy merged 2 commits into
mainfrom
2026-05-02-h8gi

Conversation

@Gsbreddy
Copy link
Copy Markdown
Collaborator

@Gsbreddy Gsbreddy commented May 2, 2026

Summary

Why

Changes

Validation

Run the same checks as CI (see .github/workflows/ci.yml) before opening / updating the PR. Cursor loads .cursor/rules/flightdeck-ci-artifacts.mdc as a short reminder for static/ + schemas/ gates.

  • uv sync --frozen --extra dev
  • uv run python -m ruff check src tests
  • uv run python -m pytest
  • uv run python scripts/generate_schemas.py then git diff --exit-code schemas/ (if models/schemas touched)
  • cd web && npm ci && npm run build && cd .. && git diff --exit-code src/flightdeck/server/static/ (if web/ sources, Vite config, or web/ deps / lockfile change the production bundle)
  • cd web && npx playwright install chromium && npm run test:e2e (if web/ changed)
  • uv run flightdeck-quickstart-verify
  • uv run flightdeck --help

With pip / venv only, use python -m … equivalents from DEVELOPMENT.md.

Schema / Storage Impact

  • None
  • Schema change
  • Storage change

Risk

Review

  • Requested review from maintainers (CODEOWNERS@flightdeckdev/maintainers on the org repo). On a fork, GitHub may not auto-request; use Reviewers on the PR.
  • PR is small and scoped (see AGENTS.md); linked issue or release note intent noted if helpful.

Notes

zendaya added 2 commits May 2, 2026 23:52
… add export functionality

- Introduced `session_id` and `span_id` query parameters for `GET /v1/runs` and `GET /v1/runs/export`, allowing users to filter run events based on these identifiers.
- Updated the CLI commands `flightdeck runs list` and `flightdeck runs export` to support the new filters, enhancing the forensics capabilities of the platform.
- Added a new endpoint `GET /v1/runs/export` to provide an NDJSON stream of filtered run events, improving data export options for users.
- Enhanced documentation to reflect the new features and updated examples for clarity.
- Updated tests to ensure the correct functionality of the new filters and export capabilities.

This update significantly improves the ability to analyze and export run events, making it easier for users to work with specific data sets.
@Gsbreddy Gsbreddy merged commit f92f148 into main May 2, 2026
2 checks passed
@Gsbreddy Gsbreddy deleted the 2026-05-02-h8gi branch May 2, 2026 21:54
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.

2 participants