app-server: add review ids for guardian notifications

Keep `targetItemId` as a deprecated compatibility alias while emitting the clearer `reviewId` field on legacy guardian approval review notifications.\n\nCo-authored-by: Codex <noreply@openai.com>
This commit is contained in:
Charles Cunningham
2026-03-23 20:24:06 -07:00
parent 013081babe
commit ecd19feeb4
12 changed files with 195 additions and 20 deletions
@@ -1372,7 +1372,7 @@
"type": "object"
},
"ItemGuardianApprovalReviewCompletedNotification": {
"description": "[UNSTABLE] Temporary notification payload for guardian automatic approval review. This shape is expected to change soon.\n\nTODO(ccunningham): Attach guardian review state to the reviewed tool item's lifecycle instead of sending separate standalone review notifications so the app-server API can persist and replay review state via `thread/read`.",
"description": "[UNSTABLE] Temporary notification payload for guardian automatic approval review.\n\nTODO(ccunningham): Attach guardian review state to the reviewed tool item's lifecycle instead of sending separate standalone review notifications so the app-server API can persist and replay review state via `thread/read`.",
"properties": {
"action": true,
"parentToolItemId": {
@@ -1385,7 +1385,16 @@
"review": {
"$ref": "#/definitions/GuardianApprovalReview"
},
"reviewId": {
"default": null,
"description": "Stable guardian review identifier for matching started/completed events.",
"type": [
"string",
"null"
]
},
"targetItemId": {
"description": "Deprecated alias for `review_id`, retained for backwards compatibility.",
"type": "string"
},
"threadId": {
@@ -1404,7 +1413,7 @@
"type": "object"
},
"ItemGuardianApprovalReviewStartedNotification": {
"description": "[UNSTABLE] Temporary notification payload for guardian automatic approval review. This shape is expected to change soon.\n\nTODO(ccunningham): Attach guardian review state to the reviewed tool item's lifecycle instead of sending separate standalone review notifications so the app-server API can persist and replay review state via `thread/read`.",
"description": "[UNSTABLE] Temporary notification payload for guardian automatic approval review.\n\nTODO(ccunningham): Attach guardian review state to the reviewed tool item's lifecycle instead of sending separate standalone review notifications so the app-server API can persist and replay review state via `thread/read`.",
"properties": {
"action": true,
"parentToolItemId": {
@@ -1417,7 +1426,16 @@
"review": {
"$ref": "#/definitions/GuardianApprovalReview"
},
"reviewId": {
"default": null,
"description": "Stable guardian review identifier for matching started/completed events.",
"type": [
"string",
"null"
]
},
"targetItemId": {
"description": "Deprecated alias for `review_id`, retained for backwards compatibility.",
"type": "string"
},
"threadId": {