From 5e8fc7ed7becbe46adb0f4750100a8326fd06171 Mon Sep 17 00:00:00 2001
From: Marcello Duarte <marcello.duarte@gmail.com>
Date: Mon, 27 Jul 2026 14:13:06 +0100
Subject: [PATCH] Require papi-core ^0.14

Caret locks the minor below 1.0, so ^0.13 excluded core 0.14 and left this
package resolvable only against a stale core.

Also commits the docs page, correcting its requirements line: the package is
papi-ai/papi-core, not papi-ai/core.
---
 composer.json    |  2 +-
 docs/provider.md | 50 ++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 51 insertions(+), 1 deletion(-)
 create mode 100644 docs/provider.md

diff --git a/composer.json b/composer.json
index 99fe5cf..50415b2 100644
--- a/composer.json
+++ b/composer.json
@@ -11,7 +11,7 @@
     ],
     "require": {
         "php": "^8.2",
-        "papi-ai/papi-core": "^0.13",
+        "papi-ai/papi-core": "^0.14",
         "ext-curl": "*"
     },
     "require-dev": {
diff --git a/docs/provider.md b/docs/provider.md
new file mode 100644
index 0000000..eac9899
--- /dev/null
+++ b/docs/provider.md
@@ -0,0 +1,50 @@
+# DeepSeek
+
+DeepSeek provider for PapiAI.
+
+## Installation
+
+```bash
+composer require papi-ai/deepseek
+```
+
+## Usage
+
+```php
+use PapiAI\Core\Agent;
+use PapiAI\DeepSeek\DeepSeekProvider;
+
+$provider = new DeepSeekProvider(
+    apiKey: $_ENV['DEEPSEEK_API_KEY'],
+);
+
+$agent = new Agent(
+    provider: $provider,
+    instructions: 'You are a helpful assistant.',
+);
+
+$response = $agent->run('Hello!');
+echo $response->text;
+```
+
+## Models
+
+```php
+DeepSeekProvider::MODEL_DEEPSEEK_CHAT      // 'deepseek-chat' (default)
+DeepSeekProvider::MODEL_DEEPSEEK_REASONER  // 'deepseek-reasoner' (reasoning)
+```
+
+## Capabilities
+
+| Capability | Supported |
+|---|---|
+| Chat | Yes |
+| Streaming | Yes |
+| Tool calling | Yes |
+| Structured output | Yes |
+
+## Requirements
+
+- PHP 8.2+
+- `ext-curl`
+- `papi-ai/papi-core` ^0.14