fix pause and resume

Author: xingyaoww

sdk/guides/convo-pause-and-resume.mdx

@@ -3,11 +3,12 @@ title: Pause and Resume
 description: Pause agent execution, perform operations, and resume without losing state.
 ---
 
+
 <Note>
 This example is available on GitHub: [examples/01_standalone_sdk/09_pause_example.py](https://github.com/All-Hands-AI/agent-sdk/blob/main/examples/01_standalone_sdk/09_pause_example.py)
 </Note>
 
-Pause agent execution mid-task and resume from where it left off:
+Pause agent execution mid-task by calling `conversation.pause()`:
 
 ```python icon="python" expandable examples/01_standalone_sdk/09_pause_example.py
 import os
@@ -21,7 +22,6 @@ from openhands.sdk import (
     Agent,
     Conversation,
 )
-from openhands.sdk.conversation.state import AgentExecutionStatus
 from openhands.sdk.tool import Tool, register_tool
 from openhands.tools.execute_bash import BashTool
 from openhands.tools.file_editor import FileEditorTool
@@ -54,30 +54,57 @@ agent = Agent(llm=llm, tools=tools)
 conversation = Conversation(agent, workspace=os.getcwd())
 
 
-print("Simple pause example - Press Ctrl+C to pause")
+print("=" * 60)
+print("Pause and Continue Example")
+print("=" * 60)
+print()
+
+# Phase 1: Start a long-running task
+print("Phase 1: Starting agent with a task...")
+conversation.send_message(
+    "Create a file called countdown.txt and write numbers from 100 down to 1, "
+    "one number per line. After you finish, summarize what you did."
+)
 
-# Send a message to get the conversation started
-conversation.send_message("repeatedly say hello world and don't stop")
+print(f"Initial status: {conversation.state.agent_status}")
+print()
 
 # Start the agent in a background thread
 thread = threading.Thread(target=conversation.run)
 thread.start()
 
-try:
-    # Main loop - similar to the user's sample script
-    while (
-        conversation.state.agent_status != AgentExecutionStatus.FINISHED
-        and conversation.state.agent_status != AgentExecutionStatus.PAUSED
-    ):
-        # Send encouraging messages periodically
-        conversation.send_message("keep going! you can do it!")
-        time.sleep(1)
-except KeyboardInterrupt:
-    conversation.pause()
+# Let the agent work for a few seconds
+print("Letting agent work for 5 seconds...")
+time.sleep(5)
 
+# Phase 2: Pause the agent
+print()
+print("Phase 2: Pausing the agent...")
+conversation.pause()
+
+# Wait for the thread to finish (it will stop when paused)
 thread.join()
 
-print(f"Agent status: {conversation.state.agent_status}")
+print(f"Agent status after pause: {conversation.state.agent_status}")
+print()
+
+
+# Phase 3: Send a new message while paused
+print("Phase 3: Sending a new message while agent is paused...")
+conversation.send_message(
+    "Actually, stop working on countdown.txt. Instead, create a file called "
+    "hello.txt with just the text 'Hello, World!' in it."
+)
+print()
+
+# Phase 4: Resume the agent with .run()
+print("Phase 4: Resuming agent with .run()...")
+print(f"Status before resume: {conversation.state.agent_status}")
+
+# Resume execution
+conversation.run()
+
+print(f"Final status: {conversation.state.agent_status}")
 ```
 
 ```bash Running the Example
@@ -90,29 +117,27 @@ uv run python examples/01_standalone_sdk/09_pause_example.py
 
 Pause the agent from another thread or after a delay:
 
-```python highlight={4-6,9}
-import threading
-import time
+```python highlight={11}
+thread = threading.Thread(target=conversation.run)
+thread.start()
 
-def pause_after_delay(conversation, seconds):
-    time.sleep(seconds)
-    conversation.pause()
+# Let the agent work for a few seconds
+print("Letting agent work for 5 seconds...")
+time.sleep(5)
 
-thread = threading.Thread(target=pause_after_delay, args=(conversation, 5))
-thread.start()
-conversation.run()  # Will pause after 5 seconds
+# Phase 2: Pause the agent
+print()
+print("Phase 2: Pausing the agent...")
+conversation.pause()
 ```
 
-### Resuming Execution
 
-Resume the paused conversation after performing operations:
+### Resuming Execution
 
-```python highlight={4-5}
-# Agent is paused, perform operations
-process_results()
+Resume the paused conversation after performing operations by calling `conversation.run()` again:
 
-conversation.resume()
-conversation.run()  # Continues from where it paused
+```python
+conversation.run()
 ```
 
 ## Next Steps