feat: new op type for sub-agents communication (#15556)

Add `InterAgentCommunication` for v2 agent communication

codex-rs/core/src/tools/handlers/multi_agents_tests.rs

@@ -24,6 +24,7 @@ use crate::tools::handlers::multi_agents_v2::SpawnAgentHandler as SpawnAgentHand
 use crate::tools::handlers::multi_agents_v2::WaitAgentHandler as WaitAgentHandlerV2;
 use crate::turn_diff_tracker::TurnDiffTracker;
 use codex_features::Feature;
+use codex_protocol::AgentPath;
 use codex_protocol::ThreadId;
 use codex_protocol::models::BaseInstructions;
 use codex_protocol::models::ContentItem;
@@ -373,6 +374,18 @@ async fn multi_agent_v2_spawn_returns_path_and_send_input_accepts_relative_path(
         .await
         .expect("send_input should accept v2 path");
 
+    assert!(manager.captured_ops().iter().any(|(id, op)| {
+        *id == child_thread_id
+            && matches!(
+                op,
+                Op::InterAgentCommunication { communication }
+                    if communication.author == AgentPath::root()
+                        && communication.recipient.as_str() == "/root/test_process"
+                        && communication.other_recipients.is_empty()
+                        && communication.content == "continue"
+            )
+    }));
+
     let child_thread = manager
         .get_thread(child_thread_id)
         .await
@@ -618,6 +631,16 @@ async fn multi_agent_v2_send_input_interrupts_busy_child_without_losing_message(
         .filter_map(|(id, op)| (*id == agent_id).then_some(op))
         .collect();
     assert!(ops_for_agent.iter().any(|op| matches!(op, Op::Interrupt)));
+    assert!(ops_for_agent.iter().any(|op| {
+        matches!(
+            op,
+            Op::InterAgentCommunication { communication }
+                if communication.author == AgentPath::root()
+                    && communication.recipient.as_str() == "/root/worker"
+                    && communication.other_recipients.is_empty()
+                    && communication.content == "continue"
+        )
+    }));
     assert!(!ops_for_agent.iter().any(|op| matches!(
         op,
         Op::UserInput { items, .. }

codex-rs/core/src/tools/handlers/multi_agents_v2/send_input.rs

@@ -1,6 +1,5 @@
 use super::*;
-use crate::agent::inter_agent_instruction::InterAgentDelivery;
-use crate::agent::inter_agent_instruction::InterAgentInstruction;
+use codex_protocol::protocol::InterAgentCommunication;
 
 pub(crate) struct Handler;
 
@@ -66,7 +65,7 @@ impl ToolHandler for Handler {
                     "target agent is missing an agent_path".to_string(),
                 )
             })?;
-            let instruction = InterAgentInstruction::new(
+            let communication = InterAgentCommunication::new(
                 turn.session_source
                     .get_agent_path()
                     .unwrap_or_else(AgentPath::root),
@@ -77,15 +76,7 @@ impl ToolHandler for Handler {
             session
                 .services
                 .agent_control
-                .deliver_inter_agent_instruction(
-                    receiver_thread_id,
-                    instruction,
-                    if args.interrupt {
-                        InterAgentDelivery::NextTurn
-                    } else {
-                        InterAgentDelivery::CurrentTurn
-                    },
-                )
+                .send_inter_agent_communication(receiver_thread_id, communication)
                 .await
         } else {
             session