Add parent-scoped guardian approval review events

Emit experimental item-scoped guardian approval review notifications for command execution, file change, and MCP tool call items while keeping the legacy autoApprovalReview notifications as deprecated aliases. Update the app-server docs and generated protocol schema fixtures.

Co-authored-by: Codex <noreply@openai.com>
This commit is contained in:
Charles Cunningham
2026-03-20 17:46:24 -07:00
co-authored by Codex
parent 7754dd1b89
commit bb2427564f
26 changed files with 1875 additions and 69 deletions
@@ -725,6 +725,56 @@
}
]
},
"CommandExecutionGuardianApprovalReviewCompletedNotification": {
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on a command execution item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"type": "object"
},
"CommandExecutionGuardianApprovalReviewStartedNotification": {
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on a command execution item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"type": "object"
},
"CommandExecutionOutputDeltaNotification": {
"properties": {
"delta": {
@@ -934,6 +984,56 @@
],
"type": "object"
},
"FileChangeGuardianApprovalReviewCompletedNotification": {
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on a file change item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"type": "object"
},
"FileChangeGuardianApprovalReviewStartedNotification": {
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on a file change item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"type": "object"
},
"FileChangeOutputDeltaNotification": {
"properties": {
"delta": {
@@ -1081,7 +1181,7 @@
"type": "object"
},
"GuardianApprovalReview": {
"description": "[UNSTABLE] Temporary guardian approval review payload used by `item/autoApprovalReview/*` notifications. This shape is expected to change soon.",
"description": "[UNSTABLE] Temporary guardian approval review payload used by guardian approval review notifications. This shape is expected to change soon.",
"properties": {
"rationale": {
"type": [
@@ -1349,7 +1449,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": "Deprecated: Use the parent item-specific `item/*/guardianApprovalReview/*` notifications instead.\n\n[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`.",
"properties": {
"action": true,
"review": {
@@ -1374,7 +1474,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": "Deprecated: Use the parent item-specific `item/*/guardianApprovalReview/*` notifications instead.\n\n[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`.",
"properties": {
"action": true,
"review": {
@@ -1479,6 +1579,56 @@
],
"type": "object"
},
"McpToolCallGuardianApprovalReviewCompletedNotification": {
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on an MCP tool call item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"type": "object"
},
"McpToolCallGuardianApprovalReviewStartedNotification": {
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on an MCP tool call item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"type": "object"
},
"McpToolCallProgressNotification": {
"properties": {
"itemId": {
@@ -4043,6 +4193,127 @@
"type": "object"
},
{
"properties": {
"method": {
"enum": [
"item/commandExecution/guardianApprovalReview/started"
],
"title": "Item/commandExecution/guardianApprovalReview/startedNotificationMethod",
"type": "string"
},
"params": {
"$ref": "#/definitions/CommandExecutionGuardianApprovalReviewStartedNotification"
}
},
"required": [
"method",
"params"
],
"title": "Item/commandExecution/guardianApprovalReview/startedNotification",
"type": "object"
},
{
"properties": {
"method": {
"enum": [
"item/commandExecution/guardianApprovalReview/completed"
],
"title": "Item/commandExecution/guardianApprovalReview/completedNotificationMethod",
"type": "string"
},
"params": {
"$ref": "#/definitions/CommandExecutionGuardianApprovalReviewCompletedNotification"
}
},
"required": [
"method",
"params"
],
"title": "Item/commandExecution/guardianApprovalReview/completedNotification",
"type": "object"
},
{
"properties": {
"method": {
"enum": [
"item/fileChange/guardianApprovalReview/started"
],
"title": "Item/fileChange/guardianApprovalReview/startedNotificationMethod",
"type": "string"
},
"params": {
"$ref": "#/definitions/FileChangeGuardianApprovalReviewStartedNotification"
}
},
"required": [
"method",
"params"
],
"title": "Item/fileChange/guardianApprovalReview/startedNotification",
"type": "object"
},
{
"properties": {
"method": {
"enum": [
"item/fileChange/guardianApprovalReview/completed"
],
"title": "Item/fileChange/guardianApprovalReview/completedNotificationMethod",
"type": "string"
},
"params": {
"$ref": "#/definitions/FileChangeGuardianApprovalReviewCompletedNotification"
}
},
"required": [
"method",
"params"
],
"title": "Item/fileChange/guardianApprovalReview/completedNotification",
"type": "object"
},
{
"properties": {
"method": {
"enum": [
"item/mcpToolCall/guardianApprovalReview/started"
],
"title": "Item/mcpToolCall/guardianApprovalReview/startedNotificationMethod",
"type": "string"
},
"params": {
"$ref": "#/definitions/McpToolCallGuardianApprovalReviewStartedNotification"
}
},
"required": [
"method",
"params"
],
"title": "Item/mcpToolCall/guardianApprovalReview/startedNotification",
"type": "object"
},
{
"properties": {
"method": {
"enum": [
"item/mcpToolCall/guardianApprovalReview/completed"
],
"title": "Item/mcpToolCall/guardianApprovalReview/completedNotificationMethod",
"type": "string"
},
"params": {
"$ref": "#/definitions/McpToolCallGuardianApprovalReviewCompletedNotification"
}
},
"required": [
"method",
"params"
],
"title": "Item/mcpToolCall/guardianApprovalReview/completedNotification",
"type": "object"
},
{
"description": "Deprecated: Use the parent item-specific `item/*/guardianApprovalReview/*` notifications instead.",
"properties": {
"method": {
"enum": [
@@ -4063,6 +4334,7 @@
"type": "object"
},
{
"description": "Deprecated: Use the parent item-specific `item/*/guardianApprovalReview/*` notifications instead.",
"properties": {
"method": {
"enum": [
@@ -3732,6 +3732,127 @@
"type": "object"
},
{
"properties": {
"method": {
"enum": [
"item/commandExecution/guardianApprovalReview/started"
],
"title": "Item/commandExecution/guardianApprovalReview/startedNotificationMethod",
"type": "string"
},
"params": {
"$ref": "#/definitions/v2/CommandExecutionGuardianApprovalReviewStartedNotification"
}
},
"required": [
"method",
"params"
],
"title": "Item/commandExecution/guardianApprovalReview/startedNotification",
"type": "object"
},
{
"properties": {
"method": {
"enum": [
"item/commandExecution/guardianApprovalReview/completed"
],
"title": "Item/commandExecution/guardianApprovalReview/completedNotificationMethod",
"type": "string"
},
"params": {
"$ref": "#/definitions/v2/CommandExecutionGuardianApprovalReviewCompletedNotification"
}
},
"required": [
"method",
"params"
],
"title": "Item/commandExecution/guardianApprovalReview/completedNotification",
"type": "object"
},
{
"properties": {
"method": {
"enum": [
"item/fileChange/guardianApprovalReview/started"
],
"title": "Item/fileChange/guardianApprovalReview/startedNotificationMethod",
"type": "string"
},
"params": {
"$ref": "#/definitions/v2/FileChangeGuardianApprovalReviewStartedNotification"
}
},
"required": [
"method",
"params"
],
"title": "Item/fileChange/guardianApprovalReview/startedNotification",
"type": "object"
},
{
"properties": {
"method": {
"enum": [
"item/fileChange/guardianApprovalReview/completed"
],
"title": "Item/fileChange/guardianApprovalReview/completedNotificationMethod",
"type": "string"
},
"params": {
"$ref": "#/definitions/v2/FileChangeGuardianApprovalReviewCompletedNotification"
}
},
"required": [
"method",
"params"
],
"title": "Item/fileChange/guardianApprovalReview/completedNotification",
"type": "object"
},
{
"properties": {
"method": {
"enum": [
"item/mcpToolCall/guardianApprovalReview/started"
],
"title": "Item/mcpToolCall/guardianApprovalReview/startedNotificationMethod",
"type": "string"
},
"params": {
"$ref": "#/definitions/v2/McpToolCallGuardianApprovalReviewStartedNotification"
}
},
"required": [
"method",
"params"
],
"title": "Item/mcpToolCall/guardianApprovalReview/startedNotification",
"type": "object"
},
{
"properties": {
"method": {
"enum": [
"item/mcpToolCall/guardianApprovalReview/completed"
],
"title": "Item/mcpToolCall/guardianApprovalReview/completedNotificationMethod",
"type": "string"
},
"params": {
"$ref": "#/definitions/v2/McpToolCallGuardianApprovalReviewCompletedNotification"
}
},
"required": [
"method",
"params"
],
"title": "Item/mcpToolCall/guardianApprovalReview/completedNotification",
"type": "object"
},
{
"description": "Deprecated: Use the parent item-specific `item/*/guardianApprovalReview/*` notifications instead.",
"properties": {
"method": {
"enum": [
@@ -3752,6 +3873,7 @@
"type": "object"
},
{
"description": "Deprecated: Use the parent item-specific `item/*/guardianApprovalReview/*` notifications instead.",
"properties": {
"method": {
"enum": [
@@ -6167,6 +6289,60 @@
"title": "CommandExecWriteResponse",
"type": "object"
},
"CommandExecutionGuardianApprovalReviewCompletedNotification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on a command execution item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/v2/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"title": "CommandExecutionGuardianApprovalReviewCompletedNotification",
"type": "object"
},
"CommandExecutionGuardianApprovalReviewStartedNotification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on a command execution item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/v2/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"title": "CommandExecutionGuardianApprovalReviewStartedNotification",
"type": "object"
},
"CommandExecutionOutputDeltaNotification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
@@ -7371,6 +7547,60 @@
"title": "FeedbackUploadResponse",
"type": "object"
},
"FileChangeGuardianApprovalReviewCompletedNotification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on a file change item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/v2/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"title": "FileChangeGuardianApprovalReviewCompletedNotification",
"type": "object"
},
"FileChangeGuardianApprovalReviewStartedNotification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on a file change item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/v2/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"title": "FileChangeGuardianApprovalReviewStartedNotification",
"type": "object"
},
"FileChangeOutputDeltaNotification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
@@ -7893,7 +8123,7 @@
"type": "object"
},
"GuardianApprovalReview": {
"description": "[UNSTABLE] Temporary guardian approval review payload used by `item/autoApprovalReview/*` notifications. This shape is expected to change soon.",
"description": "[UNSTABLE] Temporary guardian approval review payload used by guardian approval review notifications. This shape is expected to change soon.",
"properties": {
"rationale": {
"type": [
@@ -8196,7 +8426,7 @@
},
"ItemGuardianApprovalReviewCompletedNotification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"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": "Deprecated: Use the parent item-specific `item/*/guardianApprovalReview/*` notifications instead.\n\n[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`.",
"properties": {
"action": true,
"review": {
@@ -8223,7 +8453,7 @@
},
"ItemGuardianApprovalReviewStartedNotification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"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": "Deprecated: Use the parent item-specific `item/*/guardianApprovalReview/*` notifications instead.\n\n[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`.",
"properties": {
"action": true,
"review": {
@@ -8692,6 +8922,60 @@
],
"type": "object"
},
"McpToolCallGuardianApprovalReviewCompletedNotification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on an MCP tool call item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/v2/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"title": "McpToolCallGuardianApprovalReviewCompletedNotification",
"type": "object"
},
"McpToolCallGuardianApprovalReviewStartedNotification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on an MCP tool call item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/v2/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"title": "McpToolCallGuardianApprovalReviewStartedNotification",
"type": "object"
},
"McpToolCallProgressNotification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
@@ -2760,6 +2760,60 @@
"title": "CommandExecWriteResponse",
"type": "object"
},
"CommandExecutionGuardianApprovalReviewCompletedNotification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on a command execution item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"title": "CommandExecutionGuardianApprovalReviewCompletedNotification",
"type": "object"
},
"CommandExecutionGuardianApprovalReviewStartedNotification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on a command execution item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"title": "CommandExecutionGuardianApprovalReviewStartedNotification",
"type": "object"
},
"CommandExecutionOutputDeltaNotification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
@@ -3964,6 +4018,60 @@
"title": "FeedbackUploadResponse",
"type": "object"
},
"FileChangeGuardianApprovalReviewCompletedNotification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on a file change item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"title": "FileChangeGuardianApprovalReviewCompletedNotification",
"type": "object"
},
"FileChangeGuardianApprovalReviewStartedNotification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on a file change item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"title": "FileChangeGuardianApprovalReviewStartedNotification",
"type": "object"
},
"FileChangeOutputDeltaNotification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
@@ -4597,7 +4705,7 @@
"type": "object"
},
"GuardianApprovalReview": {
"description": "[UNSTABLE] Temporary guardian approval review payload used by `item/autoApprovalReview/*` notifications. This shape is expected to change soon.",
"description": "[UNSTABLE] Temporary guardian approval review payload used by guardian approval review notifications. This shape is expected to change soon.",
"properties": {
"rationale": {
"type": [
@@ -4944,7 +5052,7 @@
},
"ItemGuardianApprovalReviewCompletedNotification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"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": "Deprecated: Use the parent item-specific `item/*/guardianApprovalReview/*` notifications instead.\n\n[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`.",
"properties": {
"action": true,
"review": {
@@ -4971,7 +5079,7 @@
},
"ItemGuardianApprovalReviewStartedNotification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"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": "Deprecated: Use the parent item-specific `item/*/guardianApprovalReview/*` notifications instead.\n\n[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`.",
"properties": {
"action": true,
"review": {
@@ -5440,6 +5548,60 @@
],
"type": "object"
},
"McpToolCallGuardianApprovalReviewCompletedNotification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on an MCP tool call item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"title": "McpToolCallGuardianApprovalReviewCompletedNotification",
"type": "object"
},
"McpToolCallGuardianApprovalReviewStartedNotification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on an MCP tool call item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"title": "McpToolCallGuardianApprovalReviewStartedNotification",
"type": "object"
},
"McpToolCallProgressNotification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
@@ -8167,6 +8329,127 @@
"type": "object"
},
{
"properties": {
"method": {
"enum": [
"item/commandExecution/guardianApprovalReview/started"
],
"title": "Item/commandExecution/guardianApprovalReview/startedNotificationMethod",
"type": "string"
},
"params": {
"$ref": "#/definitions/CommandExecutionGuardianApprovalReviewStartedNotification"
}
},
"required": [
"method",
"params"
],
"title": "Item/commandExecution/guardianApprovalReview/startedNotification",
"type": "object"
},
{
"properties": {
"method": {
"enum": [
"item/commandExecution/guardianApprovalReview/completed"
],
"title": "Item/commandExecution/guardianApprovalReview/completedNotificationMethod",
"type": "string"
},
"params": {
"$ref": "#/definitions/CommandExecutionGuardianApprovalReviewCompletedNotification"
}
},
"required": [
"method",
"params"
],
"title": "Item/commandExecution/guardianApprovalReview/completedNotification",
"type": "object"
},
{
"properties": {
"method": {
"enum": [
"item/fileChange/guardianApprovalReview/started"
],
"title": "Item/fileChange/guardianApprovalReview/startedNotificationMethod",
"type": "string"
},
"params": {
"$ref": "#/definitions/FileChangeGuardianApprovalReviewStartedNotification"
}
},
"required": [
"method",
"params"
],
"title": "Item/fileChange/guardianApprovalReview/startedNotification",
"type": "object"
},
{
"properties": {
"method": {
"enum": [
"item/fileChange/guardianApprovalReview/completed"
],
"title": "Item/fileChange/guardianApprovalReview/completedNotificationMethod",
"type": "string"
},
"params": {
"$ref": "#/definitions/FileChangeGuardianApprovalReviewCompletedNotification"
}
},
"required": [
"method",
"params"
],
"title": "Item/fileChange/guardianApprovalReview/completedNotification",
"type": "object"
},
{
"properties": {
"method": {
"enum": [
"item/mcpToolCall/guardianApprovalReview/started"
],
"title": "Item/mcpToolCall/guardianApprovalReview/startedNotificationMethod",
"type": "string"
},
"params": {
"$ref": "#/definitions/McpToolCallGuardianApprovalReviewStartedNotification"
}
},
"required": [
"method",
"params"
],
"title": "Item/mcpToolCall/guardianApprovalReview/startedNotification",
"type": "object"
},
{
"properties": {
"method": {
"enum": [
"item/mcpToolCall/guardianApprovalReview/completed"
],
"title": "Item/mcpToolCall/guardianApprovalReview/completedNotificationMethod",
"type": "string"
},
"params": {
"$ref": "#/definitions/McpToolCallGuardianApprovalReviewCompletedNotification"
}
},
"required": [
"method",
"params"
],
"title": "Item/mcpToolCall/guardianApprovalReview/completedNotification",
"type": "object"
},
{
"description": "Deprecated: Use the parent item-specific `item/*/guardianApprovalReview/*` notifications instead.",
"properties": {
"method": {
"enum": [
@@ -8187,6 +8470,7 @@
"type": "object"
},
{
"description": "Deprecated: Use the parent item-specific `item/*/guardianApprovalReview/*` notifications instead.",
"properties": {
"method": {
"enum": [
@@ -0,0 +1,84 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"definitions": {
"GuardianApprovalReview": {
"description": "[UNSTABLE] Temporary guardian approval review payload used by guardian approval review notifications. This shape is expected to change soon.",
"properties": {
"rationale": {
"type": [
"string",
"null"
]
},
"riskLevel": {
"anyOf": [
{
"$ref": "#/definitions/GuardianRiskLevel"
},
{
"type": "null"
}
]
},
"riskScore": {
"format": "uint8",
"minimum": 0.0,
"type": [
"integer",
"null"
]
},
"status": {
"$ref": "#/definitions/GuardianApprovalReviewStatus"
}
},
"required": [
"status"
],
"type": "object"
},
"GuardianApprovalReviewStatus": {
"description": "[UNSTABLE] Lifecycle state for a guardian approval review.",
"enum": [
"inProgress",
"approved",
"denied",
"aborted"
],
"type": "string"
},
"GuardianRiskLevel": {
"description": "[UNSTABLE] Risk level assigned by guardian approval review.",
"enum": [
"low",
"medium",
"high"
],
"type": "string"
}
},
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on a command execution item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"title": "CommandExecutionGuardianApprovalReviewCompletedNotification",
"type": "object"
}
@@ -0,0 +1,84 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"definitions": {
"GuardianApprovalReview": {
"description": "[UNSTABLE] Temporary guardian approval review payload used by guardian approval review notifications. This shape is expected to change soon.",
"properties": {
"rationale": {
"type": [
"string",
"null"
]
},
"riskLevel": {
"anyOf": [
{
"$ref": "#/definitions/GuardianRiskLevel"
},
{
"type": "null"
}
]
},
"riskScore": {
"format": "uint8",
"minimum": 0.0,
"type": [
"integer",
"null"
]
},
"status": {
"$ref": "#/definitions/GuardianApprovalReviewStatus"
}
},
"required": [
"status"
],
"type": "object"
},
"GuardianApprovalReviewStatus": {
"description": "[UNSTABLE] Lifecycle state for a guardian approval review.",
"enum": [
"inProgress",
"approved",
"denied",
"aborted"
],
"type": "string"
},
"GuardianRiskLevel": {
"description": "[UNSTABLE] Risk level assigned by guardian approval review.",
"enum": [
"low",
"medium",
"high"
],
"type": "string"
}
},
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on a command execution item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"title": "CommandExecutionGuardianApprovalReviewStartedNotification",
"type": "object"
}
@@ -0,0 +1,84 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"definitions": {
"GuardianApprovalReview": {
"description": "[UNSTABLE] Temporary guardian approval review payload used by guardian approval review notifications. This shape is expected to change soon.",
"properties": {
"rationale": {
"type": [
"string",
"null"
]
},
"riskLevel": {
"anyOf": [
{
"$ref": "#/definitions/GuardianRiskLevel"
},
{
"type": "null"
}
]
},
"riskScore": {
"format": "uint8",
"minimum": 0.0,
"type": [
"integer",
"null"
]
},
"status": {
"$ref": "#/definitions/GuardianApprovalReviewStatus"
}
},
"required": [
"status"
],
"type": "object"
},
"GuardianApprovalReviewStatus": {
"description": "[UNSTABLE] Lifecycle state for a guardian approval review.",
"enum": [
"inProgress",
"approved",
"denied",
"aborted"
],
"type": "string"
},
"GuardianRiskLevel": {
"description": "[UNSTABLE] Risk level assigned by guardian approval review.",
"enum": [
"low",
"medium",
"high"
],
"type": "string"
}
},
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on a file change item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"title": "FileChangeGuardianApprovalReviewCompletedNotification",
"type": "object"
}
@@ -0,0 +1,84 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"definitions": {
"GuardianApprovalReview": {
"description": "[UNSTABLE] Temporary guardian approval review payload used by guardian approval review notifications. This shape is expected to change soon.",
"properties": {
"rationale": {
"type": [
"string",
"null"
]
},
"riskLevel": {
"anyOf": [
{
"$ref": "#/definitions/GuardianRiskLevel"
},
{
"type": "null"
}
]
},
"riskScore": {
"format": "uint8",
"minimum": 0.0,
"type": [
"integer",
"null"
]
},
"status": {
"$ref": "#/definitions/GuardianApprovalReviewStatus"
}
},
"required": [
"status"
],
"type": "object"
},
"GuardianApprovalReviewStatus": {
"description": "[UNSTABLE] Lifecycle state for a guardian approval review.",
"enum": [
"inProgress",
"approved",
"denied",
"aborted"
],
"type": "string"
},
"GuardianRiskLevel": {
"description": "[UNSTABLE] Risk level assigned by guardian approval review.",
"enum": [
"low",
"medium",
"high"
],
"type": "string"
}
},
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on a file change item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"title": "FileChangeGuardianApprovalReviewStartedNotification",
"type": "object"
}
@@ -2,7 +2,7 @@
"$schema": "http://json-schema.org/draft-07/schema#",
"definitions": {
"GuardianApprovalReview": {
"description": "[UNSTABLE] Temporary guardian approval review payload used by `item/autoApprovalReview/*` notifications. This shape is expected to change soon.",
"description": "[UNSTABLE] Temporary guardian approval review payload used by guardian approval review notifications. This shape is expected to change soon.",
"properties": {
"rationale": {
"type": [
@@ -57,7 +57,7 @@
"type": "string"
}
},
"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": "Deprecated: Use the parent item-specific `item/*/guardianApprovalReview/*` notifications instead.\n\n[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`.",
"properties": {
"action": true,
"review": {
@@ -2,7 +2,7 @@
"$schema": "http://json-schema.org/draft-07/schema#",
"definitions": {
"GuardianApprovalReview": {
"description": "[UNSTABLE] Temporary guardian approval review payload used by `item/autoApprovalReview/*` notifications. This shape is expected to change soon.",
"description": "[UNSTABLE] Temporary guardian approval review payload used by guardian approval review notifications. This shape is expected to change soon.",
"properties": {
"rationale": {
"type": [
@@ -57,7 +57,7 @@
"type": "string"
}
},
"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": "Deprecated: Use the parent item-specific `item/*/guardianApprovalReview/*` notifications instead.\n\n[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`.",
"properties": {
"action": true,
"review": {
@@ -0,0 +1,84 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"definitions": {
"GuardianApprovalReview": {
"description": "[UNSTABLE] Temporary guardian approval review payload used by guardian approval review notifications. This shape is expected to change soon.",
"properties": {
"rationale": {
"type": [
"string",
"null"
]
},
"riskLevel": {
"anyOf": [
{
"$ref": "#/definitions/GuardianRiskLevel"
},
{
"type": "null"
}
]
},
"riskScore": {
"format": "uint8",
"minimum": 0.0,
"type": [
"integer",
"null"
]
},
"status": {
"$ref": "#/definitions/GuardianApprovalReviewStatus"
}
},
"required": [
"status"
],
"type": "object"
},
"GuardianApprovalReviewStatus": {
"description": "[UNSTABLE] Lifecycle state for a guardian approval review.",
"enum": [
"inProgress",
"approved",
"denied",
"aborted"
],
"type": "string"
},
"GuardianRiskLevel": {
"description": "[UNSTABLE] Risk level assigned by guardian approval review.",
"enum": [
"low",
"medium",
"high"
],
"type": "string"
}
},
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on an MCP tool call item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"title": "McpToolCallGuardianApprovalReviewCompletedNotification",
"type": "object"
}
@@ -0,0 +1,84 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"definitions": {
"GuardianApprovalReview": {
"description": "[UNSTABLE] Temporary guardian approval review payload used by guardian approval review notifications. This shape is expected to change soon.",
"properties": {
"rationale": {
"type": [
"string",
"null"
]
},
"riskLevel": {
"anyOf": [
{
"$ref": "#/definitions/GuardianRiskLevel"
},
{
"type": "null"
}
]
},
"riskScore": {
"format": "uint8",
"minimum": 0.0,
"type": [
"integer",
"null"
]
},
"status": {
"$ref": "#/definitions/GuardianApprovalReviewStatus"
}
},
"required": [
"status"
],
"type": "object"
},
"GuardianApprovalReviewStatus": {
"description": "[UNSTABLE] Lifecycle state for a guardian approval review.",
"enum": [
"inProgress",
"approved",
"denied",
"aborted"
],
"type": "string"
},
"GuardianRiskLevel": {
"description": "[UNSTABLE] Risk level assigned by guardian approval review.",
"enum": [
"low",
"medium",
"high"
],
"type": "string"
}
},
"description": "[UNSTABLE] Temporary notification payload for guardian approval review on an MCP tool call item. This shape is expected to change soon.",
"properties": {
"action": true,
"itemId": {
"type": "string"
},
"review": {
"$ref": "#/definitions/GuardianApprovalReview"
},
"threadId": {
"type": "string"
},
"turnId": {
"type": "string"
}
},
"required": [
"itemId",
"review",
"threadId",
"turnId"
],
"title": "McpToolCallGuardianApprovalReviewStartedNotification",
"type": "object"
}
File diff suppressed because one or more lines are too long
@@ -0,0 +1,11 @@
// GENERATED CODE! DO NOT MODIFY BY HAND!
// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
import type { JsonValue } from "../serde_json/JsonValue";
import type { GuardianApprovalReview } from "./GuardianApprovalReview";
/**
* [UNSTABLE] Temporary notification payload for guardian approval review on a
* command execution item. This shape is expected to change soon.
*/
export type CommandExecutionGuardianApprovalReviewCompletedNotification = { threadId: string, turnId: string, itemId: string, review: GuardianApprovalReview, action: JsonValue | null, };
@@ -0,0 +1,11 @@
// GENERATED CODE! DO NOT MODIFY BY HAND!
// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
import type { JsonValue } from "../serde_json/JsonValue";
import type { GuardianApprovalReview } from "./GuardianApprovalReview";
/**
* [UNSTABLE] Temporary notification payload for guardian approval review on a
* command execution item. This shape is expected to change soon.
*/
export type CommandExecutionGuardianApprovalReviewStartedNotification = { threadId: string, turnId: string, itemId: string, review: GuardianApprovalReview, action: JsonValue | null, };
@@ -0,0 +1,11 @@
// GENERATED CODE! DO NOT MODIFY BY HAND!
// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
import type { JsonValue } from "../serde_json/JsonValue";
import type { GuardianApprovalReview } from "./GuardianApprovalReview";
/**
* [UNSTABLE] Temporary notification payload for guardian approval review on a
* file change item. This shape is expected to change soon.
*/
export type FileChangeGuardianApprovalReviewCompletedNotification = { threadId: string, turnId: string, itemId: string, review: GuardianApprovalReview, action: JsonValue | null, };
@@ -0,0 +1,11 @@
// GENERATED CODE! DO NOT MODIFY BY HAND!
// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
import type { JsonValue } from "../serde_json/JsonValue";
import type { GuardianApprovalReview } from "./GuardianApprovalReview";
/**
* [UNSTABLE] Temporary notification payload for guardian approval review on a
* file change item. This shape is expected to change soon.
*/
export type FileChangeGuardianApprovalReviewStartedNotification = { threadId: string, turnId: string, itemId: string, review: GuardianApprovalReview, action: JsonValue | null, };
@@ -5,8 +5,7 @@ import type { GuardianApprovalReviewStatus } from "./GuardianApprovalReviewStatu
import type { GuardianRiskLevel } from "./GuardianRiskLevel";
/**
* [UNSTABLE] Temporary guardian approval review payload used by
* `item/autoApprovalReview/*` notifications. This shape is expected to change
* soon.
* [UNSTABLE] Temporary guardian approval review payload used by guardian
* approval review notifications. This shape is expected to change soon.
*/
export type GuardianApprovalReview = { status: GuardianApprovalReviewStatus, riskScore: number | null, riskLevel: GuardianRiskLevel | null, rationale: string | null, };
@@ -5,6 +5,9 @@ import type { JsonValue } from "../serde_json/JsonValue";
import type { GuardianApprovalReview } from "./GuardianApprovalReview";
/**
* Deprecated: Use the parent item-specific
* `item/*/guardianApprovalReview/*` notifications instead.
*
* [UNSTABLE] Temporary notification payload for guardian automatic approval
* review. This shape is expected to change soon.
*
@@ -5,6 +5,9 @@ import type { JsonValue } from "../serde_json/JsonValue";
import type { GuardianApprovalReview } from "./GuardianApprovalReview";
/**
* Deprecated: Use the parent item-specific
* `item/*/guardianApprovalReview/*` notifications instead.
*
* [UNSTABLE] Temporary notification payload for guardian automatic approval
* review. This shape is expected to change soon.
*
@@ -0,0 +1,11 @@
// GENERATED CODE! DO NOT MODIFY BY HAND!
// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
import type { JsonValue } from "../serde_json/JsonValue";
import type { GuardianApprovalReview } from "./GuardianApprovalReview";
/**
* [UNSTABLE] Temporary notification payload for guardian approval review on
* an MCP tool call item. This shape is expected to change soon.
*/
export type McpToolCallGuardianApprovalReviewCompletedNotification = { threadId: string, turnId: string, itemId: string, review: GuardianApprovalReview, action: JsonValue | null, };
@@ -0,0 +1,11 @@
// GENERATED CODE! DO NOT MODIFY BY HAND!
// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
import type { JsonValue } from "../serde_json/JsonValue";
import type { GuardianApprovalReview } from "./GuardianApprovalReview";
/**
* [UNSTABLE] Temporary notification payload for guardian approval review on
* an MCP tool call item. This shape is expected to change soon.
*/
export type McpToolCallGuardianApprovalReviewStartedNotification = { threadId: string, turnId: string, itemId: string, review: GuardianApprovalReview, action: JsonValue | null, };
@@ -51,6 +51,8 @@ export type { CommandExecTerminateResponse } from "./CommandExecTerminateRespons
export type { CommandExecWriteParams } from "./CommandExecWriteParams";
export type { CommandExecWriteResponse } from "./CommandExecWriteResponse";
export type { CommandExecutionApprovalDecision } from "./CommandExecutionApprovalDecision";
export type { CommandExecutionGuardianApprovalReviewCompletedNotification } from "./CommandExecutionGuardianApprovalReviewCompletedNotification";
export type { CommandExecutionGuardianApprovalReviewStartedNotification } from "./CommandExecutionGuardianApprovalReviewStartedNotification";
export type { CommandExecutionOutputDeltaNotification } from "./CommandExecutionOutputDeltaNotification";
export type { CommandExecutionRequestApprovalParams } from "./CommandExecutionRequestApprovalParams";
export type { CommandExecutionRequestApprovalResponse } from "./CommandExecutionRequestApprovalResponse";
@@ -93,6 +95,8 @@ export type { ExternalAgentConfigMigrationItemType } from "./ExternalAgentConfig
export type { FeedbackUploadParams } from "./FeedbackUploadParams";
export type { FeedbackUploadResponse } from "./FeedbackUploadResponse";
export type { FileChangeApprovalDecision } from "./FileChangeApprovalDecision";
export type { FileChangeGuardianApprovalReviewCompletedNotification } from "./FileChangeGuardianApprovalReviewCompletedNotification";
export type { FileChangeGuardianApprovalReviewStartedNotification } from "./FileChangeGuardianApprovalReviewStartedNotification";
export type { FileChangeOutputDeltaNotification } from "./FileChangeOutputDeltaNotification";
export type { FileChangeRequestApprovalParams } from "./FileChangeRequestApprovalParams";
export type { FileChangeRequestApprovalResponse } from "./FileChangeRequestApprovalResponse";
@@ -175,6 +179,8 @@ export type { McpServerStartupState } from "./McpServerStartupState";
export type { McpServerStatus } from "./McpServerStatus";
export type { McpServerStatusUpdatedNotification } from "./McpServerStatusUpdatedNotification";
export type { McpToolCallError } from "./McpToolCallError";
export type { McpToolCallGuardianApprovalReviewCompletedNotification } from "./McpToolCallGuardianApprovalReviewCompletedNotification";
export type { McpToolCallGuardianApprovalReviewStartedNotification } from "./McpToolCallGuardianApprovalReviewStartedNotification";
export type { McpToolCallProgressNotification } from "./McpToolCallProgressNotification";
export type { McpToolCallResult } from "./McpToolCallResult";
export type { McpToolCallStatus } from "./McpToolCallStatus";
@@ -889,7 +889,35 @@ server_notification_definitions! {
TurnDiffUpdated => "turn/diff/updated" (v2::TurnDiffUpdatedNotification),
TurnPlanUpdated => "turn/plan/updated" (v2::TurnPlanUpdatedNotification),
ItemStarted => "item/started" (v2::ItemStartedNotification),
#[experimental("item/commandExecution/guardianApprovalReview/started")]
CommandExecutionGuardianApprovalReviewStarted =>
"item/commandExecution/guardianApprovalReview/started"
(v2::CommandExecutionGuardianApprovalReviewStartedNotification),
#[experimental("item/commandExecution/guardianApprovalReview/completed")]
CommandExecutionGuardianApprovalReviewCompleted =>
"item/commandExecution/guardianApprovalReview/completed"
(v2::CommandExecutionGuardianApprovalReviewCompletedNotification),
#[experimental("item/fileChange/guardianApprovalReview/started")]
FileChangeGuardianApprovalReviewStarted =>
"item/fileChange/guardianApprovalReview/started"
(v2::FileChangeGuardianApprovalReviewStartedNotification),
#[experimental("item/fileChange/guardianApprovalReview/completed")]
FileChangeGuardianApprovalReviewCompleted =>
"item/fileChange/guardianApprovalReview/completed"
(v2::FileChangeGuardianApprovalReviewCompletedNotification),
#[experimental("item/mcpToolCall/guardianApprovalReview/started")]
McpToolCallGuardianApprovalReviewStarted =>
"item/mcpToolCall/guardianApprovalReview/started"
(v2::McpToolCallGuardianApprovalReviewStartedNotification),
#[experimental("item/mcpToolCall/guardianApprovalReview/completed")]
McpToolCallGuardianApprovalReviewCompleted =>
"item/mcpToolCall/guardianApprovalReview/completed"
(v2::McpToolCallGuardianApprovalReviewCompletedNotification),
/// Deprecated: Use the parent item-specific
/// `item/*/guardianApprovalReview/*` notifications instead.
ItemGuardianApprovalReviewStarted => "item/autoApprovalReview/started" (v2::ItemGuardianApprovalReviewStartedNotification),
/// Deprecated: Use the parent item-specific
/// `item/*/guardianApprovalReview/*` notifications instead.
ItemGuardianApprovalReviewCompleted => "item/autoApprovalReview/completed" (v2::ItemGuardianApprovalReviewCompletedNotification),
ItemCompleted => "item/completed" (v2::ItemCompletedNotification),
/// This event is internal-only. Used by Codex Cloud.
@@ -4344,9 +4344,8 @@ impl From<CoreGuardianRiskLevel> for GuardianRiskLevel {
}
}
/// [UNSTABLE] Temporary guardian approval review payload used by
/// `item/autoApprovalReview/*` notifications. This shape is expected to change
/// soon.
/// [UNSTABLE] Temporary guardian approval review payload used by guardian
/// approval review notifications. This shape is expected to change soon.
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq, JsonSchema, TS)]
#[serde(rename_all = "camelCase")]
#[ts(export_to = "v2/")]
@@ -4829,6 +4828,87 @@ pub struct ItemStartedNotification {
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)]
#[serde(rename_all = "camelCase")]
#[ts(export_to = "v2/")]
/// [UNSTABLE] Temporary notification payload for guardian approval review on a
/// command execution item. This shape is expected to change soon.
pub struct CommandExecutionGuardianApprovalReviewStartedNotification {
pub thread_id: String,
pub turn_id: String,
pub item_id: String,
pub review: GuardianApprovalReview,
pub action: Option<JsonValue>,
}
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)]
#[serde(rename_all = "camelCase")]
#[ts(export_to = "v2/")]
/// [UNSTABLE] Temporary notification payload for guardian approval review on a
/// command execution item. This shape is expected to change soon.
pub struct CommandExecutionGuardianApprovalReviewCompletedNotification {
pub thread_id: String,
pub turn_id: String,
pub item_id: String,
pub review: GuardianApprovalReview,
pub action: Option<JsonValue>,
}
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)]
#[serde(rename_all = "camelCase")]
#[ts(export_to = "v2/")]
/// [UNSTABLE] Temporary notification payload for guardian approval review on a
/// file change item. This shape is expected to change soon.
pub struct FileChangeGuardianApprovalReviewStartedNotification {
pub thread_id: String,
pub turn_id: String,
pub item_id: String,
pub review: GuardianApprovalReview,
pub action: Option<JsonValue>,
}
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)]
#[serde(rename_all = "camelCase")]
#[ts(export_to = "v2/")]
/// [UNSTABLE] Temporary notification payload for guardian approval review on a
/// file change item. This shape is expected to change soon.
pub struct FileChangeGuardianApprovalReviewCompletedNotification {
pub thread_id: String,
pub turn_id: String,
pub item_id: String,
pub review: GuardianApprovalReview,
pub action: Option<JsonValue>,
}
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)]
#[serde(rename_all = "camelCase")]
#[ts(export_to = "v2/")]
/// [UNSTABLE] Temporary notification payload for guardian approval review on
/// an MCP tool call item. This shape is expected to change soon.
pub struct McpToolCallGuardianApprovalReviewStartedNotification {
pub thread_id: String,
pub turn_id: String,
pub item_id: String,
pub review: GuardianApprovalReview,
pub action: Option<JsonValue>,
}
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)]
#[serde(rename_all = "camelCase")]
#[ts(export_to = "v2/")]
/// [UNSTABLE] Temporary notification payload for guardian approval review on
/// an MCP tool call item. This shape is expected to change soon.
pub struct McpToolCallGuardianApprovalReviewCompletedNotification {
pub thread_id: String,
pub turn_id: String,
pub item_id: String,
pub review: GuardianApprovalReview,
pub action: Option<JsonValue>,
}
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)]
#[serde(rename_all = "camelCase")]
#[ts(export_to = "v2/")]
/// Deprecated: Use the parent item-specific
/// `item/*/guardianApprovalReview/*` notifications instead.
///
/// [UNSTABLE] Temporary notification payload for guardian automatic approval
/// review. This shape is expected to change soon.
///
@@ -4846,6 +4926,9 @@ pub struct ItemGuardianApprovalReviewStartedNotification {
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)]
#[serde(rename_all = "camelCase")]
#[ts(export_to = "v2/")]
/// Deprecated: Use the parent item-specific
/// `item/*/guardianApprovalReview/*` notifications instead.
///
/// [UNSTABLE] Temporary notification payload for guardian automatic approval
/// review. This shape is expected to change soon.
///