feat: add web search gateway tool

README.md

@@ -23,6 +23,12 @@ cargo build
 cargo test
 ```
 
+## Web search
+
+The stateful `/v1/responses` executor supports OpenAI-compatible `web_search`
+tool declarations by normalizing them into a `web_search` function call for
+vLLM. Set `YOU_API_KEY` to enable execution through You.com's Search API.
+
 ## Lint and format
 
 ```bash

crates/agentic-core/src/events/normalize.rs

@@ -57,6 +57,7 @@ fn classify_event_type(type_str: &str) -> SSEEventType {
         "response.reasoning_summary_text.done" => SSEEventType::ReasoningSummaryTextDone,
         "response.file_search_call.searching" => SSEEventType::FileSearchCallSearching,
         "response.file_search_call.completed" => SSEEventType::FileSearchCallCompleted,
+        "response.web_search_call.in_progress" => SSEEventType::WebSearchCallInProgress,
         "response.web_search_call.searching" => SSEEventType::WebSearchCallSearching,
         "response.web_search_call.completed" => SSEEventType::WebSearchCallCompleted,
         _ => SSEEventType::Other,
@@ -90,6 +91,7 @@ fn extract_payload(event_type: SSEEventType, json: &Value) -> EventPayload {
         | SSEEventType::ReasoningPartDone
         | SSEEventType::FileSearchCallSearching
         | SSEEventType::FileSearchCallCompleted
+        | SSEEventType::WebSearchCallInProgress
         | SSEEventType::WebSearchCallSearching
         | SSEEventType::WebSearchCallCompleted
         | SSEEventType::Other => EventPayload::Raw(json.clone()),

crates/agentic-core/src/events/types.rs

@@ -88,6 +88,7 @@ pub enum SSEEventType {
     // Built-in tool calls
     FileSearchCallSearching,
     FileSearchCallCompleted,
+    WebSearchCallInProgress,
     WebSearchCallSearching,
     WebSearchCallCompleted,