From 283c7678e5f71f96a5a86b1359fbaa741ef92261 Mon Sep 17 00:00:00 2001
From: Marcello Duarte <marcello.duarte@gmail.com>
Date: Mon, 27 Jul 2026 14:12:59 +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 | 52 ++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 53 insertions(+), 1 deletion(-)
 create mode 100644 docs/provider.md

diff --git a/composer.json b/composer.json
index 6d35f5d..385bf9d 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..43cafa3
--- /dev/null
+++ b/docs/provider.md
@@ -0,0 +1,52 @@
+# Grok (xAI)
+
+Grok provider for PapiAI, powered by xAI.
+
+## Installation
+
+```bash
+composer require papi-ai/grok
+```
+
+## Usage
+
+```php
+use PapiAI\Core\Agent;
+use PapiAI\Grok\GrokProvider;
+
+$provider = new GrokProvider(
+    apiKey: $_ENV['XAI_API_KEY'],
+);
+
+$agent = new Agent(
+    provider: $provider,
+    instructions: 'You are a helpful assistant.',
+);
+
+$response = $agent->run('Hello!');
+echo $response->text;
+```
+
+## Models
+
+```php
+GrokProvider::MODEL_GROK_3      // 'grok-3' (default)
+GrokProvider::MODEL_GROK_3_MINI // 'grok-3-mini' (fast)
+GrokProvider::MODEL_GROK_2      // 'grok-2'
+```
+
+## Capabilities
+
+| Capability | Supported |
+|---|---|
+| Chat | Yes |
+| Streaming | Yes |
+| Tool calling | Yes |
+| Vision | Yes |
+| Structured output | Yes |
+
+## Requirements
+
+- PHP 8.2+
+- `ext-curl`
+- `papi-ai/papi-core` ^0.14