change previous_response_id bootstrap value from "bootstrap" to empty string

Author: ihower

docs/running_agents.md

@@ -174,8 +174,13 @@ from agents import Agent, Runner
 async def main():
     agent = Agent(name="Assistant", instructions="Reply very concisely.")
 
-    # First turn
-    result1 = await Runner.run(agent, "What city is the Golden Gate Bridge in?")
+    # First turn: since there's no previous_response_id yet,
+    # you can set it to an empty string to force-enable response chaining
+    # for internal function calls inside the first turn.
+    result1 = await Runner.run(
+        agent,
+        "What city is the Golden Gate Bridge in?",
+        previous_response_id="")
     print(result1.final_output)
     # San Francisco
 
@@ -189,8 +194,6 @@ async def main():
     # California
 ```
 
-For the first turn where no real `previous_response_id` exists, you can set `previous_response_id="bootstrap"` to force-enable response chaining for internal function calls inside the first turn.
-
 ## Long running agents & human-in-the-loop
 
 You can use the Agents SDK [Temporal](https://temporal.io/) integration to run durable, long-running workflows, including human-in-the-loop tasks. View a demo of Temporal and the Agents SDK working in action to complete long-running tasks [in this video](https://www.youtube.com/watch?v=fFBZqzT4DD8), and [view docs here](https://github.com/temporalio/sdk-python/tree/main/temporalio/contrib/openai_agents).

src/agents/run.py

@@ -131,7 +131,7 @@ class _ServerConversationTracker:
     """Tracks server-side conversation state for either conversation_id or
     previous_response_id modes.
 
-    Special value 'bootstrap' for previous_response_id enables chaining for internal
+    Special value '' (empty string) for previous_response_id enables chaining for internal
     function calls in the first turn, even when there's no actual previous response ID yet.
     """
 
@@ -1364,7 +1364,7 @@ async def _run_single_turn_streamed(
         previous_response_id = (
             server_conversation_tracker.previous_response_id
             if server_conversation_tracker
-            and server_conversation_tracker.previous_response_id != "bootstrap"
+            and server_conversation_tracker.previous_response_id != ""
             else None
         )
         conversation_id = (
@@ -1803,7 +1803,7 @@ async def _get_new_response(
         previous_response_id = (
             server_conversation_tracker.previous_response_id
             if server_conversation_tracker
-            and server_conversation_tracker.previous_response_id != "bootstrap"
+            and server_conversation_tracker.previous_response_id != ""
             else None
         )
         conversation_id = (

tests/test_agent_runner.py

@@ -1226,7 +1226,7 @@ async def test_default_send_all_items_streamed():
 
 @pytest.mark.asyncio
 async def test_bootstrap_mode_multi_turn():
-    """Test that bootstrap mode (previous_response_id='bootstrap') enables
+    """Test that bootstrap mode (previous_response_id='') enables
     chaining from the first internal turn."""
     model = FakeModel()
     agent = Agent(
@@ -1244,7 +1244,7 @@ async def test_bootstrap_mode_multi_turn():
         ]
     )
 
-    result = await Runner.run(agent, input="user_message", previous_response_id="bootstrap")
+    result = await Runner.run(agent, input="user_message", previous_response_id="")
     assert result.final_output == "done"
 
     # Check the first call
@@ -1281,7 +1281,7 @@ async def test_bootstrap_mode_multi_turn():
 
 @pytest.mark.asyncio
 async def test_bootstrap_mode_multi_turn_streamed():
-    """Test that bootstrap mode (previous_response_id='bootstrap') enables
+    """Test that bootstrap mode (previous_response_id='') enables
     chaining from the first internal turn (streamed mode)."""
     model = FakeModel()
     agent = Agent(
@@ -1299,7 +1299,7 @@ async def test_bootstrap_mode_multi_turn_streamed():
         ]
     )
 
-    result = Runner.run_streamed(agent, input="user_message", previous_response_id="bootstrap")
+    result = Runner.run_streamed(agent, input="user_message", previous_response_id="")
     async for _ in result.stream_events():
         pass