Lightweight coding agent that runs in your terminal
Rust
Surface misalignment policy violations as typed errors (#38682)
Francis Chalisseryeb147c0db364
diff --git a/codex-rs/app-server-protocol/schema/json/ServerNotification.json b/codex-rs/app-server-protocol/schema/json/ServerNotification.jsonindex a12721c12f..ea6ab7f963 100644--- a/codex-rs/app-server-protocol/schema/json/ServerNotification.json+++ b/codex-rs/app-server-protocol/schema/json/ServerNotification.json@@ -606,6 +606,7 @@"usageLimitExceeded","serverOverloaded","cyberPolicy",+ "misalignmentPolicyViolation","internalServerError","unauthorized","badRequest",diff --git a/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.schemas.json b/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.schemas.jsonindex 02f6e514c1..b29284db0b 100644--- a/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.schemas.json+++ b/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.schemas.json@@ -7573,6 +7573,7 @@"usageLimitExceeded","serverOverloaded","cyberPolicy",+ "misalignmentPolicyViolation","internalServerError","unauthorized","badRequest",diff --git a/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.v2.schemas.json b/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.v2.schemas.jsonindex e5add5a626..7e5d4ca22d 100644--- a/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.v2.schemas.json+++ b/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.v2.schemas.json@@ -3691,6 +3691,7 @@"usageLimitExceeded","serverOverloaded","cyberPolicy",+ "misalignmentPolicyViolation","internalServerError","unauthorized","badRequest",diff --git a/codex-rs/app-server-protocol/schema/json/v2/ErrorNotification.json b/codex-rs/app-server-protocol/schema/json/v2/ErrorNotification.jsonindex 101cd1d778..36721e3704 100644--- a/codex-rs/app-server-protocol/schema/json/v2/ErrorNotification.json+++ b/codex-rs/app-server-protocol/schema/json/v2/ErrorNotification.json@@ -11,6 +11,7 @@"usageLimitExceeded","serverOverloaded","cyberPolicy",+ "misalignmentPolicyViolation","internalServerError","unauthorized","badRequest",diff --git a/codex-rs/app-server-protocol/schema/json/v2/ReviewStartResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ReviewStartResponse.jsonindex 8f2b83b537..a909e681ee 100644--- a/codex-rs/app-server-protocol/schema/json/v2/ReviewStartResponse.json+++ b/codex-rs/app-server-protocol/schema/json/v2/ReviewStartResponse.json@@ -34,6 +34,7 @@"usageLimitExceeded","serverOverloaded","cyberPolicy",+ "misalignmentPolicyViolation","internalServerError","unauthorized","badRequest",diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadForkResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadForkResponse.jsonindex 8d3f71feea..5876704afc 100644--- a/codex-rs/app-server-protocol/schema/json/v2/ThreadForkResponse.json+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadForkResponse.json@@ -115,6 +115,7 @@"usageLimitExceeded","serverOverloaded","cyberPolicy",+ "misalignmentPolicyViolation","internalServerError","unauthorized","badRequest",diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadListResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadListResponse.jsonindex ed476d2c2a..98aef0c946 100644--- a/codex-rs/app-server-protocol/schema/json/v2/ThreadListResponse.json+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadListResponse.json@@ -37,6 +37,7 @@"usageLimitExceeded","serverOverloaded","cyberPolicy",+ "misalignmentPolicyViolation","internalServerError","unauthorized","badRequest",diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadMetadataUpdateResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadMetadataUpdateResponse.jsonindex 3d66bfef44..bcebfc360c 100644--- a/codex-rs/app-server-protocol/schema/json/v2/ThreadMetadataUpdateResponse.json+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadMetadataUpdateResponse.json@@ -37,6 +37,7 @@"usageLimitExceeded","serverOverloaded","cyberPolicy",+ "misalignmentPolicyViolation","internalServerError","unauthorized","badRequest",diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadReadResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadReadResponse.jsonindex 13cf57b6ab..16a20062b3 100644--- a/codex-rs/app-server-protocol/schema/json/v2/ThreadReadResponse.json+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadReadResponse.json@@ -37,6 +37,7 @@"usageLimitExceeded","serverOverloaded","cyberPolicy",+ "misalignmentPolicyViolation","internalServerError","unauthorized","badRequest",diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadResumeResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadResumeResponse.jsonindex 6fc3dbbc12..2fb3538f85 100644--- a/codex-rs/app-server-protocol/schema/json/v2/ThreadResumeResponse.json+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadResumeResponse.json@@ -115,6 +115,7 @@"usageLimitExceeded","serverOverloaded","cyberPolicy",+ "misalignmentPolicyViolation","internalServerError","unauthorized","badRequest",diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadRollbackResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadRollbackResponse.jsonindex 3ecebc79c4..a27e02cca5 100644--- a/codex-rs/app-server-protocol/schema/json/v2/ThreadRollbackResponse.json+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadRollbackResponse.json@@ -37,6 +37,7 @@"usageLimitExceeded","serverOverloaded","cyberPolicy",+ "misalignmentPolicyViolation","internalServerError","unauthorized","badRequest",diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadStartResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadStartResponse.jsonindex 4b07755c40..2ece3204c0 100644--- a/codex-rs/app-server-protocol/schema/json/v2/ThreadStartResponse.json+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadStartResponse.json@@ -115,6 +115,7 @@"usageLimitExceeded","serverOverloaded","cyberPolicy",+ "misalignmentPolicyViolation","internalServerError","unauthorized","badRequest",diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadStartedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadStartedNotification.jsonindex 3132907fef..c53a7f8937 100644--- a/codex-rs/app-server-protocol/schema/json/v2/ThreadStartedNotification.json+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadStartedNotification.json@@ -37,6 +37,7 @@"usageLimitExceeded","serverOverloaded","cyberPolicy",+ "misalignmentPolicyViolation","internalServerError","unauthorized","badRequest",diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchiveResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchiveResponse.jsonindex 0a14a81681..5451f70940 100644--- a/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchiveResponse.json+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchiveResponse.json@@ -37,6 +37,7 @@"usageLimitExceeded","serverOverloaded","cyberPolicy",+ "misalignmentPolicyViolation","internalServerError","unauthorized","badRequest",diff --git a/codex-rs/app-server-protocol/schema/json/v2/TurnCompletedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/TurnCompletedNotification.jsonindex 40dc021878..bc7a0e1b6c 100644--- a/codex-rs/app-server-protocol/schema/json/v2/TurnCompletedNotification.json+++ b/codex-rs/app-server-protocol/schema/json/v2/TurnCompletedNotification.json@@ -34,6 +34,7 @@"usageLimitExceeded","serverOverloaded","cyberPolicy",+ "misalignmentPolicyViolation","internalServerError","unauthorized","badRequest",diff --git a/codex-rs/app-server-protocol/schema/json/v2/TurnStartResponse.json b/codex-rs/app-server-protocol/schema/json/v2/TurnStartResponse.jsonindex 4e4505228a..48e799fd15 100644--- a/codex-rs/app-server-protocol/schema/json/v2/TurnStartResponse.json+++ b/codex-rs/app-server-protocol/schema/json/v2/TurnStartResponse.json@@ -34,6 +34,7 @@"usageLimitExceeded","serverOverloaded","cyberPolicy",+ "misalignmentPolicyViolation","internalServerError","unauthorized","badRequest",diff --git a/codex-rs/app-server-protocol/schema/json/v2/TurnStartedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/TurnStartedNotification.jsonindex 927306c05f..de4b894c06 100644--- a/codex-rs/app-server-protocol/schema/json/v2/TurnStartedNotification.json+++ b/codex-rs/app-server-protocol/schema/json/v2/TurnStartedNotification.json@@ -34,6 +34,7 @@"usageLimitExceeded","serverOverloaded","cyberPolicy",+ "misalignmentPolicyViolation","internalServerError","unauthorized","badRequest",diff --git a/codex-rs/app-server-protocol/schema/precomputed/app-server-exports-experimental.json.zst b/codex-rs/app-server-protocol/schema/precomputed/app-server-exports-experimental.json.zstindex ae26f19844..14d34815a2 100644Binary files a/codex-rs/app-server-protocol/schema/precomputed/app-server-exports-experimental.json.zst and b/codex-rs/app-server-protocol/schema/precomputed/app-server-exports-experimental.json.zst differdiff --git a/codex-rs/app-server-protocol/schema/precomputed/app-server-exports-stable.json.zst b/codex-rs/app-server-protocol/schema/precomputed/app-server-exports-stable.json.zstindex a78af9ad45..d9f5acc201 100644Binary files a/codex-rs/app-server-protocol/schema/precomputed/app-server-exports-stable.json.zst and b/codex-rs/app-server-protocol/schema/precomputed/app-server-exports-stable.json.zst differdiff --git a/codex-rs/app-server-protocol/schema/typescript/v2/CodexErrorInfo.ts b/codex-rs/app-server-protocol/schema/typescript/v2/CodexErrorInfo.tsindex ec50328e1d..142048048f 100644--- a/codex-rs/app-server-protocol/schema/typescript/v2/CodexErrorInfo.ts+++ b/codex-rs/app-server-protocol/schema/typescript/v2/CodexErrorInfo.ts@@ -9,4 +9,4 @@ import type { NonSteerableTurnKind } from "./NonSteerableTurnKind";* When an upstream HTTP status is available (for example, from the Responses API or a provider),* it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.*/-export type CodexErrorInfo = "contextWindowExceeded" | "sessionBudgetExceeded" | "usageLimitExceeded" | "serverOverloaded" | "cyberPolicy" | { "httpConnectionFailed": { httpStatusCode: number | null, } } | { "responseStreamConnectionFailed": { httpStatusCode: number | null, } } | "internalServerError" | "unauthorized" | "badRequest" | "threadRollbackFailed" | "sandboxError" | { "responseStreamDisconnected": { httpStatusCode: number | null, } } | { "responseTooManyFailedAttempts": { httpStatusCode: number | null, } } | { "activeTurnNotSteerable": { turnKind: NonSteerableTurnKind, } } | "other";+export type CodexErrorInfo = "contextWindowExceeded" | "sessionBudgetExceeded" | "usageLimitExceeded" | "serverOverloaded" | "cyberPolicy" | "misalignmentPolicyViolation" | { "httpConnectionFailed": { httpStatusCode: number | null, } } | { "responseStreamConnectionFailed": { httpStatusCode: number | null, } } | "internalServerError" | "unauthorized" | "badRequest" | "threadRollbackFailed" | "sandboxError" | { "responseStreamDisconnected": { httpStatusCode: number | null, } } | { "responseTooManyFailedAttempts": { httpStatusCode: number | null, } } | { "activeTurnNotSteerable": { turnKind: NonSteerableTurnKind, } } | "other";diff --git a/codex-rs/app-server-protocol/src/protocol/v2/shared.rs b/codex-rs/app-server-protocol/src/protocol/v2/shared.rsindex 340c0ab496..ddcf232b47 100644--- a/codex-rs/app-server-protocol/src/protocol/v2/shared.rs+++ b/codex-rs/app-server-protocol/src/protocol/v2/shared.rs@@ -80,6 +80,7 @@ pub enum CodexErrorInfo {UsageLimitExceeded,ServerOverloaded,CyberPolicy,+ MisalignmentPolicyViolation,HttpConnectionFailed {#[serde(rename = "httpStatusCode")]#[ts(rename = "httpStatusCode")]@@ -126,6 +127,9 @@ impl From<CoreCodexErrorInfo> for CodexErrorInfo {CoreCodexErrorInfo::UsageLimitExceeded => CodexErrorInfo::UsageLimitExceeded,CoreCodexErrorInfo::ServerOverloaded => CodexErrorInfo::ServerOverloaded,CoreCodexErrorInfo::CyberPolicy => CodexErrorInfo::CyberPolicy,+ CoreCodexErrorInfo::MisalignmentPolicyViolation => {+ CodexErrorInfo::MisalignmentPolicyViolation+ }CoreCodexErrorInfo::HttpConnectionFailed { http_status_code } => {CodexErrorInfo::HttpConnectionFailed { http_status_code }}diff --git a/codex-rs/app-server/README.md b/codex-rs/app-server/README.mdindex 3fcdd5f05c..d9a534a22f 100644--- a/codex-rs/app-server/README.md+++ b/codex-rs/app-server/README.md@@ -1662,6 +1662,7 @@ There are additional item-specific events:- `ContextWindowExceeded`- `SessionBudgetExceeded`- `UsageLimitExceeded`+- `misalignmentPolicyViolation`: a non-retryable request blocked by the misalignment policy- `HttpConnectionFailed { httpStatusCode? }`: upstream HTTP failures including 4xx/5xx- `ResponseStreamConnectionFailed { httpStatusCode? }`: failure to connect to the response SSE stream- `ResponseStreamDisconnected { httpStatusCode? }`: disconnect of the response SSE stream in the middle of a turn before completiondiff --git a/codex-rs/app-server/tests/suite/v2/misalignment_policy.rs b/codex-rs/app-server/tests/suite/v2/misalignment_policy.rsnew file mode 100644index 0000000000..375b49dd07--- /dev/null+++ b/codex-rs/app-server/tests/suite/v2/misalignment_policy.rs@@ -0,0 +1,149 @@+use anyhow::Result;+use app_test_support::MockResponsesConfig;+use app_test_support::TestAppServer;+use codex_app_server_protocol::ClientRequest;+use codex_app_server_protocol::CodexErrorInfo;+use codex_app_server_protocol::ErrorNotification;+use codex_app_server_protocol::ThreadStartParams;+use codex_app_server_protocol::ThreadStartResponse;+use codex_app_server_protocol::TurnCompletedNotification;+use codex_app_server_protocol::TurnError;+use codex_app_server_protocol::TurnStartParams;+use codex_app_server_protocol::TurnStartResponse;+use codex_app_server_protocol::TurnStatus;+use codex_app_server_protocol::UserInput;+use core_test_support::responses;+use core_test_support::skip_if_no_network;+use pretty_assertions::assert_eq;+use tempfile::TempDir;+use tokio::time::timeout;+use wiremock::ResponseTemplate;++const MESSAGE: &str = "This request violated the misalignment policy.";++#[tokio::test]+async fn streamed_policy_violation_completes_turn_with_typed_terminal_error() -> Result<()> {+ skip_if_no_network!(Ok(()));++ let response = responses::sse_response(responses::sse(vec![+ responses::ev_response_created("resp-misalignment"),+ serde_json::json!({+ "type": "response.failed",+ "response": {+ "id": "resp-misalignment",+ "status": "failed",+ "error": {+ "type": "invalid_request_error",+ "code": "misalignment_policy_violation",+ "message": MESSAGE+ }+ }+ }),+ ]));++ assert_policy_violation_completes_turn_with_typed_terminal_error(response).await+}++#[tokio::test]+async fn http_400_policy_violation_completes_turn_with_typed_terminal_error() -> Result<()> {+ skip_if_no_network!(Ok(()));++ let response = ResponseTemplate::new(400).set_body_json(serde_json::json!({+ "error": {+ "type": "invalid_request_error",+ "code": "misalignment_policy_violation",+ "message": MESSAGE,+ }+ }));++ assert_policy_violation_completes_turn_with_typed_terminal_error(response).await+}++#[tokio::test]+async fn http_403_policy_violation_completes_turn_with_typed_terminal_error() -> Result<()> {+ skip_if_no_network!(Ok(()));++ let response = ResponseTemplate::new(403).set_body_json(serde_json::json!({+ "error": {+ "type": "invalid_request_error",+ "code": "misalignment_policy_violation",+ "message": MESSAGE,+ }+ }));++ assert_policy_violation_completes_turn_with_typed_terminal_error(response).await+}++async fn assert_policy_violation_completes_turn_with_typed_terminal_error(+ response: ResponseTemplate,+) -> Result<()> {+ let server = responses::start_mock_server().await;+ let response_mock = responses::mount_response_once(&server, response).await;++ let codex_home = TempDir::new()?;+ MockResponsesConfig::new(&server.uri()).write(codex_home.path())?;++ let mut app_server = TestAppServer::builder()+ .with_codex_home(codex_home.path())+ .build_initialized()+ .await?;+ let ThreadStartResponse { thread, .. } = app_server+ .start_thread(ThreadStartParams {+ model: Some("mock-model".to_string()),+ ..Default::default()+ })+ .await?;+ let TurnStartResponse { turn } = app_server+ .request(|request_id| ClientRequest::TurnStart {+ request_id,+ params: TurnStartParams {+ thread_id: thread.id.clone(),+ client_user_message_id: None,+ input: vec![UserInput::Text {+ text: "trigger policy violation".to_string(),+ text_elements: Vec::new(),+ }],+ ..Default::default()+ },+ })+ .await?;++ let error: ErrorNotification = timeout(+ std::time::Duration::from_secs(10),+ app_server.read_notification("error"),+ )+ .await??;+ assert_eq!(+ error,+ ErrorNotification {+ error: TurnError {+ message: MESSAGE.to_string(),+ codex_error_info: Some(CodexErrorInfo::MisalignmentPolicyViolation),+ additional_details: None,+ },+ will_retry: false,+ thread_id: thread.id.clone(),+ turn_id: turn.id.clone(),+ }+ );++ let completed: TurnCompletedNotification = timeout(+ std::time::Duration::from_secs(10),+ app_server.read_notification("turn/completed"),+ )+ .await??;+ assert_eq!(completed.thread_id, thread.id);+ assert_eq!(completed.turn.id, turn.id);+ assert_eq!(completed.turn.status, TurnStatus::Failed);+ assert_eq!(+ completed.turn.error,+ Some(TurnError {+ message: MESSAGE.to_string(),+ codex_error_info: Some(CodexErrorInfo::MisalignmentPolicyViolation),+ additional_details: None,+ })+ );+ response_mock.single_request();++ Ok(())+}diff --git a/codex-rs/app-server/tests/suite/v2/mod.rs b/codex-rs/app-server/tests/suite/v2/mod.rsindex d473fcfab5..553819b7dd 100644--- a/codex-rs/app-server/tests/suite/v2/mod.rs+++ b/codex-rs/app-server/tests/suite/v2/mod.rs@@ -45,6 +45,7 @@ mod mcp_server_elicitation;mod mcp_server_status;mod mcp_tool;mod memory_reset;+mod misalignment_policy;mod model_auto_review;mod model_list;mod model_provider_capabilities_read;diff --git a/codex-rs/cli/src/doctor.rs b/codex-rs/cli/src/doctor.rsindex 6a7d8a8d5d..712d63984c 100644--- a/codex-rs/cli/src/doctor.rs+++ b/codex-rs/cli/src/doctor.rs@@ -2493,6 +2493,7 @@ fn websocket_error_detail(err: &ApiError) -> String {| ApiError::RateLimit(_)| ApiError::InvalidRequest { .. }| ApiError::CyberPolicy { .. }+ | ApiError::MisalignmentPolicyViolation { .. }| ApiError::ServerOverloaded => format!("handshake error: {err}"),}}diff --git a/codex-rs/codex-api/src/api_bridge.rs b/codex-rs/codex-api/src/api_bridge.rsindex 37271934b4..aa536e0a25 100644--- a/codex-rs/codex-api/src/api_bridge.rs+++ b/codex-rs/codex-api/src/api_bridge.rs@@ -48,6 +48,9 @@ pub fn map_api_error(err: ApiError) -> CodexErr {ApiError::CyberPolicy { message } => {CodexErr::new(CodexErrorDetails::CyberPolicy { message })}+ ApiError::MisalignmentPolicyViolation { message } => {+ CodexErr::new(CodexErrorDetails::MisalignmentPolicyViolation { message })+ }ApiError::Transport(transport) => match transport {TransportError::Http {status,@@ -70,6 +73,26 @@ pub fn map_api_error(err: ApiError) -> CodexErr {return CodexErr::ServerOverloaded;}+ if (status == http::StatusCode::BAD_REQUEST+ || status == http::StatusCode::FORBIDDEN)+ && let Ok(parsed) = serde_json::from_str::<Value>(&body_text)+ && let Some(error) = parsed.get("error")+ && error.get("code").and_then(Value::as_str)+ == Some(MISALIGNMENT_POLICY_VIOLATION_ERROR_CODE)+ {+ let message = error+ .get("message")+ .and_then(Value::as_str)+ .filter(|message| !message.trim().is_empty())+ .map(str::to_string)+ .unwrap_or_else(|| {+ MISALIGNMENT_POLICY_VIOLATION_FALLBACK_MESSAGE.to_string()+ });+ return CodexErr::new(CodexErrorDetails::MisalignmentPolicyViolation {+ message,+ });+ }+if status == http::StatusCode::BAD_REQUEST {if let Ok(parsed) = serde_json::from_str::<Value>(&body_text)&& let Some(error) = parsed.get("error")@@ -167,6 +190,9 @@ const X_ERROR_JSON_HEADER: &str = "x-error-json";const CYBER_POLICY_ERROR_CODE: &str = "cyber_policy";const CYBER_POLICY_FALLBACK_MESSAGE: &str ="This request has been flagged for possible cybersecurity risk.";+const MISALIGNMENT_POLICY_VIOLATION_ERROR_CODE: &str = "misalignment_policy_violation";+const MISALIGNMENT_POLICY_VIOLATION_FALLBACK_MESSAGE: &str =+ "This request was blocked due to a misalignment policy violation.";const CLOUDFLARE_BLOCKED_MESSAGE: &str ="Access blocked by Cloudflare. This usually happens when connecting from a restricted region";diff --git a/codex-rs/codex-api/src/api_bridge_tests.rs b/codex-rs/codex-api/src/api_bridge_tests.rsindex 391b4f5ea8..62e153be6c 100644--- a/codex-rs/codex-api/src/api_bridge_tests.rs+++ b/codex-rs/codex-api/src/api_bridge_tests.rs@@ -146,6 +146,39 @@ fn map_api_error_uses_cyber_policy_fallback_for_missing_message() {);}+#[test]+fn map_api_error_maps_misalignment_policy_violation_from_400_body() {+ assert_misalignment_policy_violation_from_http_body(http::StatusCode::BAD_REQUEST);+}++#[test]+fn map_api_error_maps_misalignment_policy_violation_from_403_body() {+ assert_misalignment_policy_violation_from_http_body(http::StatusCode::FORBIDDEN);+}++fn assert_misalignment_policy_violation_from_http_body(status: http::StatusCode) {+ let body = serde_json::json!({+ "error": {+ "message": "This request violated the misalignment policy.",+ "type": "invalid_request_error",+ "code": "misalignment_policy_violation"+ }+ })+ .to_string();+ let err = map_api_error(ApiError::Transport(TransportError::Http {+ status,+ url: Some("http://example.com/v1/responses".to_string()),+ headers: None,+ body: Some(body),+ }));++ let CodexErrorDetails::MisalignmentPolicyViolation { message } = err.details() else {+ panic!("expected CodexErrorDetails::MisalignmentPolicyViolation, got {err:?}");+ };+ assert_eq!(message, "This request violated the misalignment policy.");+ assert!(!err.is_retryable());+}+#[test]fn map_api_error_keeps_unknown_400_errors_generic() {let body = serde_json::json!({diff --git a/codex-rs/codex-api/src/error.rs b/codex-rs/codex-api/src/error.rsindex c6cb5fd405..7929326aad 100644--- a/codex-rs/codex-api/src/error.rs+++ b/codex-rs/codex-api/src/error.rs@@ -29,6 +29,8 @@ pub enum ApiError {InvalidRequest { message: String },#[error("cyber policy: {message}")]CyberPolicy { message: String },+ #[error("misalignment policy violation: {message}")]+ MisalignmentPolicyViolation { message: String },#[error("server overloaded")]ServerOverloaded,}diff --git a/codex-rs/codex-api/src/sse/responses.rs b/codex-rs/codex-api/src/sse/responses.rsindex 233186dc6d..3712b28c78 100644--- a/codex-rs/codex-api/src/sse/responses.rs+++ b/codex-rs/codex-api/src/sse/responses.rs@@ -420,6 +420,15 @@ pub fn process_responses_event(} else if is_cyber_policy_error(&error) {let message = cyber_policy_message(error.message);response_error = ApiError::CyberPolicy { message };+ } else if error.code.as_deref() == Some("misalignment_policy_violation") {+ let message = error+ .message+ .filter(|message| !message.trim().is_empty())+ .unwrap_or_else(|| {+ "This request was blocked due to a misalignment policy violation."+ .to_string()+ });+ response_error = ApiError::MisalignmentPolicyViolation { message };} else if matches!(error.code.as_deref(), Some("invalid_prompt" | "bio_policy")){let message = error@@ -1148,6 +1157,51 @@ mod tests {}}+ #[tokio::test]+ async fn misalignment_policy_violation_error_is_fatal() {+ let raw_error = r#"{"type":"response.failed","sequence_number":3,"response":{"id":"resp_fatal_misalignment","object":"response","status":"failed","error":{"type":"invalid_request_error","code":"misalignment_policy_violation","message":"This request violated the misalignment policy."}}}"#;++ let sse = format!("event: response.failed\ndata: {raw_error}\n\n");+ let events = collect_events(&[sse.as_bytes()]).await;++ assert_eq!(events.len(), 1);+ match &events[0] {+ Err(ApiError::MisalignmentPolicyViolation { message }) => {+ assert_eq!(message, "This request violated the misalignment policy.");+ }+ other => panic!("unexpected event: {other:?}"),+ }+ }++ #[tokio::test]+ async fn misalignment_policy_violation_uses_fallback_for_blank_message() {+ for message in ["", " "] {+ let raw_error = serde_json::json!({+ "type": "response.failed",+ "response": {+ "id": "resp_fatal_misalignment",+ "status": "failed",+ "error": {+ "type": "invalid_request_error",+ "code": "misalignment_policy_violation",+ "message": message,+ },+ },+ });+ let sse = format!("event: response.failed\ndata: {raw_error}\n\n");+ let events = collect_events(&[sse.as_bytes()]).await;++ assert_eq!(events.len(), 1);+ match &events[0] {+ Err(ApiError::MisalignmentPolicyViolation { message }) => assert_eq!(+ message,+ "This request was blocked due to a misalignment policy violation."+ ),+ other => panic!("unexpected event: {other:?}"),+ }+ }+ }+#[tokio::test]async fn content_policy_errors_without_type_are_invalid_requests() {for (code, expected_message) in [diff --git a/codex-rs/protocol/src/error.rs b/codex-rs/protocol/src/error.rsindex 33ef62273a..f503093d92 100644--- a/codex-rs/protocol/src/error.rs+++ b/codex-rs/protocol/src/error.rs@@ -132,6 +132,8 @@ pub enum CodexErrorDetails {ServerOverloaded,#[error("{message}")]CyberPolicy { message: String },+ #[error("{message}")]+ MisalignmentPolicyViolation { message: String },#[error("{0}")]ResponseStreamFailed(ResponseStreamFailed),#[error("{0}")]@@ -383,7 +385,8 @@ impl CodexErr {| CodexErrorDetails::SessionConfiguredNotFirstEvent| CodexErrorDetails::UsageLimitReached(_)| CodexErrorDetails::ServerOverloaded- | CodexErrorDetails::CyberPolicy { .. } => false,+ | CodexErrorDetails::CyberPolicy { .. }+ | CodexErrorDetails::MisalignmentPolicyViolation { .. } => false,CodexErrorDetails::Stream(..)| CodexErrorDetails::Timeout| CodexErrorDetails::RequestTimeout@@ -426,6 +429,9 @@ impl CodexErr {| CodexErrorDetails::UsageNotIncluded => CodexErrorInfo::UsageLimitExceeded,CodexErrorDetails::ServerOverloaded => CodexErrorInfo::ServerOverloaded,CodexErrorDetails::CyberPolicy { .. } => CodexErrorInfo::CyberPolicy,+ CodexErrorDetails::MisalignmentPolicyViolation { .. } => {+ CodexErrorInfo::MisalignmentPolicyViolation+ }CodexErrorDetails::RetryLimit(_) => CodexErrorInfo::ResponseTooManyFailedAttempts {http_status_code: self.http_status_code_value(),},diff --git a/codex-rs/protocol/src/protocol.rs b/codex-rs/protocol/src/protocol.rsindex bd5579987b..c8b5992b7a 100644--- a/codex-rs/protocol/src/protocol.rs+++ b/codex-rs/protocol/src/protocol.rs@@ -1770,6 +1770,7 @@ pub enum CodexErrorInfo {UsageLimitExceeded,ServerOverloaded,CyberPolicy,+ MisalignmentPolicyViolation,HttpConnectionFailed {http_status_code: Option<u16>,},@@ -1808,6 +1809,7 @@ impl CodexErrorInfo {| Self::UsageLimitExceeded| Self::ServerOverloaded| Self::CyberPolicy+ | Self::MisalignmentPolicyViolation| Self::HttpConnectionFailed { .. }| Self::ResponseStreamConnectionFailed { .. }| Self::InternalServerErrordiff --git a/codex-rs/response-debug-context/src/lib.rs b/codex-rs/response-debug-context/src/lib.rsindex cee5799bab..822210d144 100644--- a/codex-rs/response-debug-context/src/lib.rs+++ b/codex-rs/response-debug-context/src/lib.rs@@ -83,6 +83,7 @@ pub fn telemetry_api_error_message(error: &ApiError) -> String {ApiError::RateLimit(_) => "rate limit".to_string(),ApiError::InvalidRequest { .. } => "invalid request".to_string(),ApiError::CyberPolicy { .. } => "cyber policy".to_string(),+ ApiError::MisalignmentPolicyViolation { .. } => "misalignment policy violation".to_string(),ApiError::ServerOverloaded => "server overloaded".to_string(),}}