#21612: feat(gateway): add ops runtime summary API
gateway
size: L
Cluster:
Cron Job Stability Fixes
## Summary
- add a read-only gateway method `ops.runtime.summary` to aggregate runtime status for cron/jobs, sessions, and subagents
- include basic filters: `activeMinutes`, `limit`, `search`, `fromMs`, `toMs`, `includeDisabledCron`
- wire the method into gateway method registry and read scope
- add unit tests for response aggregation and params validation
## Why
Mission Control needs one endpoint to answer quickly: what is running, what is failing, and what needs manual action.
## API
Method: `ops.runtime.summary`
Response includes:
- `summary.cron/sessions/subagents`
- `cron[]`
- `sessions[]`
- `subagents[]`
## Validation
- `pnpm vitest src/gateway/server-methods/ops-runtime.test.ts src/gateway/method-scopes.test.ts`
- `pnpm exec oxlint --type-aware src/gateway/server-methods/ops-runtime.ts src/gateway/server-methods/ops-runtime.test.ts src/gateway/server-methods.ts src/gateway/server-methods-list.ts src/gateway/method-scopes.ts`
- `pnpm exec oxfmt --check src/gateway/server-methods.ts src/gateway/server-methods/ops-runtime.test.ts src/gateway/server-methods/ops-runtime.ts src/gateway/server-methods-list.ts src/gateway/method-scopes.ts`
Related: #21600
<!-- greptile_comment -->
<h3>Greptile Summary</h3>
Added a new read-only gateway method `ops.runtime.summary` that aggregates runtime status for cron jobs, sessions, and subagents into a single endpoint. The implementation includes proper parameter validation, filtering (activeMinutes, limit, search, time range), and comprehensive unit tests.
<h3>Confidence Score: 5/5</h3>
- This PR is safe to merge with minimal risk
- The implementation is clean, well-tested, and follows established patterns in the codebase. Parameter validation is thorough, the method is properly scoped as read-only, integration points are correctly wired, and unit tests cover both success and error cases.
- No files require special attention
<sub>Last reviewed commit: 3733ef0</sub>
<!-- greptile_other_comments_section -->
<sub>(3/5) Reply to the agent's comments like "Can you suggest a fix for this @greptileai?" or ask follow-up questions!</sub>
<!-- /greptile_comment -->
Most Similar PRs
#21639: feat(gateway): add ops runtime runs history API
by frank8ai · 2026-02-20
88.2%
#21644: feat(control-ui): add runtime runs filters in cron tab
by frank8ai · 2026-02-20
76.8%
#12917: feat(gateway): add agents.health RPC method for per-agent health over…
by jlwainwright · 2026-02-09
75.8%
#13537: Gateway: add commands.list slash command metadata API
by Pyiner · 2026-02-10
73.2%
#11175: fix: add sessions.usage methods to READ_METHODS for authorization
by Yida-Dev · 2026-02-07
71.4%
#11788: feat: inter-agent communication via CLI scripts
by jingkang0822 · 2026-02-08
71.1%
#10748: feat: Add sessions.spawn gateway method for direct subagent spawning
by fox-openclaw · 2026-02-06
71.0%
#10273: fix(agents): detect and auto-compact mid-run context overflow
by terryops · 2026-02-06
70.9%
#22858: Gateway: add eager secrets runtime snapshot activation
by joshavant · 2026-02-21
70.1%
#12998: feat(agents): Add parallel sub-agent execution with concurrency con...
by trevorgordon981 · 2026-02-10
70.1%