jimbrub
diff --git a/‎README.md‎
Lines changed: 30 additions & 1 deletion b/‎README.md‎
Lines changed: 30 additions & 1 deletion
diff --git a/‎pyproject.toml‎
Lines changed: 3 additions & 1 deletion b/‎pyproject.toml‎
Lines changed: 3 additions & 1 deletion
@@ -121,6 +121,7 @@ Below is a comprehensive table of all available tools, how to use them with an a
 | slack | `agent.tool.slack(action="post_message", channel="general", text="Hello team!")` | Interact with Slack workspace for messaging and monitoring |
 | speak | `agent.tool.speak(text="Operation completed successfully", style="green", mode="polly")` | Output status messages with rich formatting and optional text-to-speech |
 | stop | `agent.tool.stop(message="Process terminated by user request")` | Gracefully terminate agent execution with custom message |
+| handoff_to_user | `agent.tool.handoff_to_user(message="Please confirm action", breakout_of_loop=False)` | Hand off control to user for confirmation, input, or complete task handoff |
 | use_llm | `agent.tool.use_llm(prompt="Analyze this data", system_prompt="You are a data analyst")` | Create nested AI loops with customized system prompts for specialized tasks |
 | workflow | `agent.tool.workflow(action="create", name="data_pipeline", steps=[{"tool": "file_read"}, {"tool": "python_repl"}])` | Define, execute, and manage multi-step automated workflows |
 | batch| `agent.tool.batch(invocations=[{"name": "current_time", "arguments": {"timezone": "Europe/London"}}, {"name": "stop", "arguments": {}}])` | Call multiple other tools in parallel. |
@@ -186,6 +187,13 @@ response = agent.tool.http_request(
     auth_type="Bearer",
     auth_token="your_token_here"
 )
+
+# Convert HTML webpages to markdown for better readability
+response = agent.tool.http_request(
+    method="GET",
+    url="https://example.com/article",
+    convert_to_markdown=True
+)
 ```
 
 ### Python Code Execution
@@ -331,6 +339,27 @@ result = agent.tool.use_browser(actions=[
 ])
 ```
 
+### Handoff to User
+
+```python
+from strands import Agent
+from strands_tools import handoff_to_user
+
+agent = Agent(tools=[handoff_to_user])
+
+# Request user confirmation and continue
+response = agent.tool.handoff_to_user(
+    message="I need your approval to proceed with deleting these files. Type 'yes' to confirm.",
+    breakout_of_loop=False
+)
+
+# Complete handoff to user (stops agent execution)
+agent.tool.handoff_to_user(
+    message="Task completed. Please review the results and take any necessary follow-up actions.",
+    breakout_of_loop=True
+)
+```
+
 ### A2A Client
 
 ```python
@@ -527,4 +556,4 @@ See [CONTRIBUTING](CONTRIBUTING.md#security-issue-notifications) for more inform
 
 Strands Agents is currently in public preview. During this period:
 - APIs may change as we refine the SDK
-- We welcome feedback and contributions
+- We welcome feedback and contributions
@@ -35,6 +35,8 @@ dependencies = [
     "tenacity>=9.1.2,<10.0.0",
     "watchdog>=6.0.0,<7.0.0",
     "slack_bolt>=1.23.0,<2.0.0",
+    "markdownify>=1.0.0,<2.0.0",
+    "readabilipy>=0.2.0,<1.0.0",
     # Note: Always want the latest tzdata
     "tzdata ; platform_system == 'Windows'",
 ]
@@ -185,4 +187,4 @@ name = "cz_conventional_commits"
 tag_format = "v$version"
 bump_message = "chore(release): bump version $current_version -> $new_version"
 version_files = ["pyproject.toml:version"]
-update_changelog_on_bump = true
+update_changelog_on_bump = true