anthropics / anthropics/anthropic-sdk-python

[Bug] append_messages() inside tool runner loop causes infinite loop (advanced usage docs example)

Open
#1,536 4 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
3.9k
Forks
853
Avg merge
1d 11h
Merged PRs (30d)
10

Description

[Link to Advanced Usage Docs Example
](https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-runner#:~:text=(block.text)-,Advanced%20usage,-Within%20the%20loop)
# Root cause

Calling `runner.append_messages(user_message)` inside the loop sets
`_messages_modified = True`, which causes `__run__` to skip the auto-append
of the assistant message + tool result (line 281 of `_beta_runner.py`).
The next iteration sends a request with no tool result in history, so Claude
sees the original question unanswered and makes the tool call again.

## Minimal repro

Compacted and consolidated from the website

```
from anthropic import beta_tool, Anthropic

client = Anthropic()

@beta_tool
def get_weather(location: str, unit: str = 'fahrenheit') -> str:
return json.dumps({
'temperature': '20°c', 'condition': 'sunny'
})

runner = client.beta.messages.tool_runner(
model="claude-haiku-4-5",
max_tokens=1024,
tools=[get_weather],
messages=[{
"role": "user",
"content": "what's the weather in San Francisco?"
}]
)

for message in runner:
tool_response = runner.generate_tool_call_response()
if tool_response:
print(f"Tool result: {tool_response}")

# increase tokens for next request
runner.set_messages_params(
lambda params: {
**params,
"max_tokens": 2048,
}
)

# add additional messages
runner.append_messages(
{"role": "user", "content": "be concise in your response"}
)
```

## Expected behavior
The "be concise" user message is appended, tool results are still
auto-appended, loop terminates.

## Actual behavior
Infinite loop — tool result never reaches history.

## Note
The "Modifying tool results" example on the same page correctly calls
`runner.append_messages(message, tool_response)` (both the assistant
message and the tool result), which is the pattern that works correctly.

The "Advanced usage" example is inconsistent with this.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.