>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #3572139. --> Reported by: [camoa](https://www.drupal.org/user/2448054) Related to !25 >>> <h3 id="summary-problem-motivation">Problem/Motivation</h3> <p>To support native Anthropic API features (effort, thinking, caching, compaction), we need the official PHP SDK installed and a Drupal service wrapping it. This is the foundation that all subsequent<br> feature issues in the <a href="https://www.drupal.org/project/ai_provider_anthropic/issues/XXXXXXX">[META] Native Anthropic SDK integration</a> depend on.</p> <p>The SDK provides two approaches for making API calls:</p> <ul> <li><strong>Typed methods</strong> (<code>$client-&gt;messages-&gt;create()</code>): For features with full SDK support (prompt caching, structured outputs, tool cache_control)</li> <li><strong>Raw requests</strong> (<code>$client-&gt;request()</code>): The SDK's recommended escape hatch for features not yet typed (adaptive thinking, effort). Same auth, retries, and error handling.</li> </ul> <p>Both paths use the same SDK infrastructure. As the SDK adds types for more features, raw request calls migrate to typed methods with no API changes.</p> <h4 id="summary-steps-reproduce">Steps to reproduce</h4> <p>N/A &mdash; new functionality.</p> <h3 id="summary-proposed-resolution">Proposed resolution</h3> <ol> <li>Add <code>anthropic-ai/sdk: ^0.5</code> and <code>php-http/guzzle7-adapter</code> to <code>composer.json</code></li> <li>Create <code>AnthropicNativeClient</code> service (<code>src/Service/AnthropicNativeClient.php</code>) wrapping the SDK with Drupal's HTTP client</li> <li>Register the service in <code>ai_provider_anthropic.services.yml</code></li> <li>Override <code>chat()</code> in <code>AnthropicProvider</code> with hybrid routing: detect when native features are configured &rarr; route to <code>nativeChat()</code>, otherwise fall through to<br> <code>parent::chat()</code></li> <li>Basic <code>nativeChat()</code> implementation using <code>$client-&gt;request()</code></li> </ol> <p><strong>Key constraint:</strong> SDK v0.5.0 has a known issue where <code>extraBodyParams</code> is defined in <code>RequestOptions</code> but never merged into requests. The<br> <code>$client-&gt;request()</code> method is the reliable alternative.</p> <p><strong>No new features in this issue</strong> &mdash; just the plumbing. Effort, thinking, streaming, and token usage are handled in follow-up issues.</p> <h3 id="summary-remaining-tasks">Remaining tasks</h3> <ul> <li>Add composer dependencies</li> <li>Create AnthropicNativeClient service</li> <li>Create services.yml</li> <li>Override chat() with hybrid routing</li> <li>Verify basic chat still works via compat layer (no regression)</li> </ul> <h3 id="summary-ui-changes">User interface changes</h3> <p>None.</p> <h3 id="summary-api-changes">API changes</h3> <p>None. Internal routing only.</p> <h3 id="summary-data-model-changes">Data model changes</h3> <p>None.</p>