Stream partial thread search results and support cancellation (#62132)

## Why

Clients using `thread/search` have to wait for the search to finish before
they can show any matches. A search can also outlive the query that triggered
it, such as when a user changes their task mention query.

## What changed

- Add experimental `thread/search/stream` with best-effort
  `thread/search/partial` notifications. Each notification carries the original
  `requestId` and a batch of verified matches. Clients replace provisional
  matches with the final page, which determines results, ordering, and cursors.
- Support connection-scoped cancellation through `thread/search/stream/cancel`
  and `thread/search/cancel` for their respective search methods. Disconnecting
  also stops active searches and reaps their search subprocesses.
- Cancel superseded or timed-out TUI task mention searches without delaying
  available title matches.

## Testing

Add coverage for incremental results and final-page parity, slow clients,
connection-scoped cancellation and subprocess cleanup, and TUI task search
cancellation.

GitOrigin-RevId: b58abf7a1df424f191c8ede806d1d5266d299548
This commit is contained in:
matthewdavis-oai
2026-11-17 23:46:48 +00:00
committed by copyberry
parent c90234de95
commit 3bf4e138fe
53 changed files with 5965 additions and 420 deletions
@@ -6570,6 +6570,40 @@
],
"type": "object"
},
"ThreadSearchPartialNotification": {
"description": "A best-effort incremental batch for `thread/search/stream`. Match `requestId` to the request on this connection. Only a small subset of verified matches may be emitted; rows are unique and arrive in discovery order, but may be dropped under load or fall outside the final sorted page. Thread fields use stored metadata and the current watched status; live thread settings are enriched in the final response. Replace provisional rows with the authoritative final response. No partials follow it or an error.",
"properties": {
"data": {
"items": {
"$ref": "#/definitions/ThreadSearchResult"
},
"type": "array"
},
"requestId": {
"$ref": "#/definitions/RequestId"
}
},
"required": [
"data",
"requestId"
],
"type": "object"
},
"ThreadSearchResult": {
"properties": {
"snippet": {
"type": "string"
},
"thread": {
"$ref": "#/definitions/Thread"
}
},
"required": [
"snippet",
"thread"
],
"type": "object"
},
"ThreadSection": {
"description": "An independently persisted, user-visible thread section.",
"properties": {
@@ -8417,6 +8451,26 @@
"title": "Process/outputDeltaNotification",
"type": "object"
},
{
"properties": {
"method": {
"enum": [
"thread/search/partial"
],
"title": "Thread/search/partialNotificationMethod",
"type": "string"
},
"params": {
"$ref": "#/definitions/ThreadSearchPartialNotification"
}
},
"required": [
"method",
"params"
],
"title": "Thread/search/partialNotification",
"type": "object"
},
{
"description": "Final exit notification for a `process/spawn` session.",
"properties": {