pub use codex_api::ResponseEvent; use codex_config::types::Personality; use codex_protocol::error::Result; use codex_protocol::models::BaseInstructions; use codex_protocol::models::FunctionCallOutputBody; use codex_protocol::models::ResponseItem; use codex_tools::ToolSpec; use futures::Stream; use serde::Deserialize; use serde_json::Value; use std::collections::HashSet; use std::pin::Pin; use std::task::Context; use std::task::Poll; use tokio::sync::mpsc; /// Review thread system prompt. Edit `core/src/review_prompt.md` to customize. pub const REVIEW_PROMPT: &str = include_str!("../review_prompt.md"); // Centralized templates for review-related user messages pub const REVIEW_EXIT_SUCCESS_TMPL: &str = include_str!("../templates/review/exit_success.xml"); pub const REVIEW_EXIT_INTERRUPTED_TMPL: &str = include_str!("../templates/review/exit_interrupted.xml"); /// API request payload for a single model turn #[derive(Default, Debug, Clone)] pub struct Prompt { /// Conversation context input items. pub input: Vec, /// Tools available to the model, including additional tools sourced from /// external MCP servers. pub(crate) tools: Vec, /// Whether parallel tool calls are permitted for this prompt. pub(crate) parallel_tool_calls: bool, pub base_instructions: BaseInstructions, /// Optionally specify the personality of the model. pub personality: Option, /// Optional the output schema for the model's response. pub output_schema: Option, } impl Prompt { pub(crate) fn get_formatted_input(&self) -> Vec { let mut input = self.input.clone(); // when using the *Freeform* apply_patch tool specifically, tool outputs // should be structured text, not json. Do NOT reserialize when using // the Function tool - note that this differs from the check above for // instructions. We declare the result as a named variable for clarity. let is_freeform_apply_patch_tool_present = self.tools.iter().any(|tool| match tool { ToolSpec::Freeform(f) => f.name == "apply_patch", _ => false, }); if is_freeform_apply_patch_tool_present { reserialize_shell_outputs(&mut input); } input } } fn reserialize_shell_outputs(items: &mut [ResponseItem]) { let mut shell_call_ids: HashSet = HashSet::new(); items.iter_mut().for_each(|item| match item { ResponseItem::LocalShellCall { call_id, id, .. } => { if let Some(identifier) = call_id.clone().or_else(|| id.clone()) { shell_call_ids.insert(identifier); } } ResponseItem::CustomToolCall { id: _, status: _, call_id, name, input: _, } => { if name == "apply_patch" { shell_call_ids.insert(call_id.clone()); } } ResponseItem::FunctionCall { name, call_id, .. } if is_shell_tool_name(name) || name == "apply_patch" => { shell_call_ids.insert(call_id.clone()); } ResponseItem::FunctionCallOutput { call_id, output, .. } | ResponseItem::CustomToolCallOutput { call_id, output, .. } => { if shell_call_ids.remove(call_id) && let Some(structured) = output .text_content() .and_then(parse_structured_shell_output) { output.body = FunctionCallOutputBody::Text(structured); } } _ => {} }) } fn is_shell_tool_name(name: &str) -> bool { matches!(name, "shell" | "container.exec") } #[derive(Deserialize)] struct ExecOutputJson { output: String, metadata: ExecOutputMetadataJson, } #[derive(Deserialize)] struct ExecOutputMetadataJson { exit_code: i32, duration_seconds: f32, } fn parse_structured_shell_output(raw: &str) -> Option { let parsed: ExecOutputJson = serde_json::from_str(raw).ok()?; Some(build_structured_output(&parsed)) } fn build_structured_output(parsed: &ExecOutputJson) -> String { let mut sections = Vec::new(); sections.push(format!("Exit code: {}", parsed.metadata.exit_code)); sections.push(format!( "Wall time: {} seconds", parsed.metadata.duration_seconds )); let mut output = parsed.output.clone(); if let Some((stripped, total_lines)) = strip_total_output_header(&parsed.output) { sections.push(format!("Total output lines: {total_lines}")); output = stripped.to_string(); } sections.push("Output:".to_string()); sections.push(output); sections.join("\n") } fn strip_total_output_header(output: &str) -> Option<(&str, u32)> { let after_prefix = output.strip_prefix("Total output lines: ")?; let (total_segment, remainder) = after_prefix.split_once('\n')?; let total_lines = total_segment.parse::().ok()?; let remainder = remainder.strip_prefix('\n').unwrap_or(remainder); Some((remainder, total_lines)) } pub struct ResponseStream { pub(crate) rx_event: mpsc::Receiver>, } impl Stream for ResponseStream { type Item = Result; fn poll_next(mut self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll> { self.rx_event.poll_recv(cx) } } #[cfg(test)] #[path = "client_common_tests.rs"] mod tests;