Skip to content

[NA] [BE] First build of Local Runner backend#5406

Draft
collincunn wants to merge 9 commits intomainfrom
collinc/local-runner-impl
Draft

[NA] [BE] First build of Local Runner backend#5406
collincunn wants to merge 9 commits intomainfrom
collinc/local-runner-impl

Conversation

@collincunn
Copy link
Contributor

@collincunn collincunn commented Feb 26, 2026

Details

The Local Runner feature allows users to execute AI agents on their own machines, triggered from the Opik UI.

  • Implemented the full backend for the Local Runner feature (zero SDK yet)
  • Added REST API under /v1/private/runners with endpoints for pairing, connection, job lifecycle, log streaming, heartbeat, and cancellation
  • Implemented RunnerServiceImpl with all Redis-backed state management (runner state, job queues, agent registry, heartbeat liveness)
  • Added RunnerReaperJob for periodic cleanup of dead runners and orphaned job recovery
  • Added RunnerConfig for feature gating and tunable parameters (job timeout, queue depth, heartbeat TTL)
  • Included comprehensive unit tests covering pairing, connection, job creation/execution/cancellation, log streaming, heartbeat/eviction, reaper logic, and workspace isolation

Change checklist

  • User facing
  • Documentation update

Testing

  • Created ~80 unit tests that cover 100% of the runner service.
  • Created an integration test that runs against Redis

Issues

Documentation

See design doc

@github-actions github-actions bot added java Pull requests that update Java code Backend tests Including test files, or tests related like configuration. labels Feb 26, 2026
@github-actions
Copy link
Contributor

📋 PR Linter Failed

Missing Section. The description is missing the ## Issues section.

@github-actions
Copy link
Contributor

📋 PR Linter Failed

Missing Section. The description is missing the ## Issues section.

@github-actions
Copy link
Contributor

📋 PR Linter Failed

Missing Section. The description is missing the ## Issues section.

@github-actions
Copy link
Contributor

github-actions bot commented Feb 26, 2026

Backend Tests Results

  452 files    452 suites   56m 33s ⏱️
6 945 tests 6 932 ✅ 13 💤 0 ❌
5 476 runs  5 463 ✅ 13 💤 0 ❌

Results for commit 6873c55.

♻️ This comment has been updated with latest results.

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

Labels

Backend java Pull requests that update Java code tests Including test files, or tests related like configuration.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant