Python: Fix server_tool_use input_json_delta handling and improve Anthropic samples

[chetantoshniwal]

Motivation and Context

Anthropic Sample fix and regression test coverage for the server_tool_use streaming edge case.

Description

• Fix: Skip input_json_delta for server_tool_use content blocks in AnthropicClient streaming. Server-managed tools (e.g., skills with code interpreter) were producing Content.from_function_call(name='') entries that caused Anthropic API 400 errors on subsequent turns.

• Test: Added regression test test_parse_contents_server_tool_use_input_json_delta_ignored to verify that after a server_tool_use content block, subsequent input_json_delta events produce no Content.from_function_call(name='') entries, preventing the fix from silently regressing.

• Samples: Add dotenv loading and environment variable documentation to Anthropic Claude samples (MCP, permissions, session, shell, tools, URL, skills).

Contribution Checklist

• The code builds clean without any errors or warnings
• The PR follows the Contribution Guidelines
• All unit tests pass, and I have added new tests where possible
• Is this a breaking change? If yes, add "[BREAKING]" prefix to the title of the PR.

[Mark Wallace (markwallace-microsoft)]

Python Test Coverage Report •

File	Stmts	Miss	Cover	Missing
packages/anthropic/agent_framework_anthropic
_chat_client.py	437	35	91%	446, 449, 530, 623, 625, 768, 795–796, 874, 904–905, 950, 966–967, 974–976, 980–982, 986–989, 1103, 1113, 1165, 1286, 1313–1314, 1331, 1344, 1357, 1382–1383
TOTAL	26994	3187	88%

Python Unit Test Overview

Tests	Skipped	Failures	Errors	Time
5341	20 💤	0 ❌	0 🔥	1m 22s ⏱️

[Copilot]

Pull request overview

This PR addresses an Anthropic streaming edge case in the Python Anthropic chat client (avoiding invalid tool-call content during server-managed tool execution) and updates the Anthropic Claude Python samples to make environment setup clearer and more consistent.

Changes:

• Skip input_json_delta parsing for server_tool_use (in addition to mcp_tool_use) to prevent generating Content.from_function_call(name="") that can cause Anthropic 400s on subsequent turns.
• Update Anthropic Claude samples to document required environment variables.
• Add .env loading (python-dotenv) to several Anthropic Claude samples for easier local execution.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
python/packages/anthropic/agent_framework_anthropic/_chat_client.py	Prevents emitting invalid function-call delta content for server-managed tools during streaming.
python/samples/02-agents/providers/anthropic/anthropic_skills.py	Documents required Anthropic environment variables for the skills sample.
python/samples/02-agents/providers/anthropic/anthropic_claude_with_url.py	Adds .env loading and documents ANTHROPIC_API_KEY.
python/samples/02-agents/providers/anthropic/anthropic_claude_with_tools.py	Adds .env loading and documents ANTHROPIC_API_KEY.
python/samples/02-agents/providers/anthropic/anthropic_claude_with_shell.py	Adds .env loading and documents ANTHROPIC_API_KEY.
python/samples/02-agents/providers/anthropic/anthropic_claude_with_session.py	Adds .env loading and documents ANTHROPIC_API_KEY.
python/samples/02-agents/providers/anthropic/anthropic_claude_with_multiple_permissions.py	Adds .env loading and documents ANTHROPIC_API_KEY.
python/samples/02-agents/providers/anthropic/anthropic_claude_with_mcp.py	Documents ANTHROPIC_API_KEY for the MCP sample.

[Copilot]

Just as a heads up, I was blocked by some firewall rules while working on your feedback. Expand below for details.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• astral.sh
  • Triggering command: /usr/bin/curl curl -LsSf REDACTED (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)