Launch a Cursor subagent with the given prompt. Returns immediately with a run_id; the subagent runs asynchronously. Model must be in the allowlist. Use get_subagent_events or subscribe to subagent:///events to observe progress.

Send a follow-up message to a running subagent (resumes the same chat). Errors if a turn is already in flight.

Return the current status of a subagent run.

Fetch NDJSON events emitted by a subagent since a given event id. Use for polling or to catch up after a notifications/resources/updated ping.

List subagent runs known to this harness.

Terminate a running subagent (SIGTERM).

Return the final structured completion payload for a terminated run (status ∈ {completed, failed, cancelled, timed_out}).

Compress / delete old terminal runs. By default follows the retention config (compress after N days, delete after M days, LRU cap). Pass overrides to run a manual cleanup or set dry_run=true to preview what would happen.