از اولین Composer require تا Production، همه‌چیز اینجاست.

<?php

use AmirKateb\AiCoreClient\Client;

$ai = new Client(
    'https://ai.avaztek.ir',
    getenv('AI_CORE_API_KEY'),
    timeoutSeconds: 300,
    connectTimeoutSeconds: 10,
);

$request = $ai->chat([
    'model' => 'provider:model',
    'message' => 'سلام! یک پاسخ کوتاه بده.',
    'temperature' => 0.4,
    'metadata' => ['user_id' => 'u_123'],
], Client::idempotencyKey());

$result = $request->wait();

echo $result['result']['content'] ?? '';

$ai = $ai
    ->withClientRequestId('order_4815')
    ->withOrigin('https://app.example.com')
    ->withHeaders(['X-Correlation-ID' => 'corr_123']);

use AmirKateb\AiCoreClient\Value\SseEvent;

$request = $ai->chatStream([
    'model' => 'provider:model',
    'message' => 'یک توضیح مرحله‌ای بده.',
], Client::idempotencyKey('stream'));

$request->stream(function (SseEvent $event): void {
    if ($event->event === 'delta') {
        echo $event->data['text'] ?? '';
        flush();
    }
});

GET https://ai.avaztek.ir/health
Accept: application/json

{
    "name": "Avaztek Ai Core",
    "contract": "ai-core-health/v1",
    "ok": true,
    "healthy": true,
    "status": "healthy",
    "score": 100,
    "checked_at": "ISO-8601 timestamp",
    "time": "ISO-8601 timestamp",
    "checks": {
        "application": "ok",
        "database": "ok",
        "redis": "ok",
        "storage": "ok",
        "queue": "ok",
        "scheduler": "ok",
        "nginx": "ok",
        "php_fpm": "ok",
        "ssl": "ok"
    }
}

$request = $ai->systemOne([
    'model' => 'v1m:v1m-latest',
    'state' => 'تراکنش غیرعادی در نیمه‌شب ثبت شده است.',
    'questions' => [
        'is_fraud' => ['type' => 'noul', 'instructions' => 'احتمال تقلب بالا است؟'],
        'action' => ['type' => 'choice', 'choices' => ['block', 'verify', 'pass']],
        'risk' => ['type' => 'score', 'min' => 0, 'max' => 100],
    ],
], Client::idempotencyKey('system-one'));

$result = $request->wait();
print_r($result['result']['answers'] ?? []);

$profiles = $ai->autoSwitchProfiles('chat');

foreach ($profiles['data'] as $profile) {
    echo $profile['name'].' · '.$profile['model_count'].' models'.PHP_EOL;
    foreach ($profile['models'] as $candidate) {
        echo '#'.$candidate['position'].' '.$candidate['provider'].' / '.$candidate['model'];
        echo ' · direct='.($candidate['direct_access'] ? 'yes' : 'no').PHP_EOL;
    }
}

$profileId = 'PROFILE_UUID';

$request = $ai->chatWithProfile($profileId, [
    'message' => 'با زنجیره اضطراری پاسخ بده.',
], Client::idempotencyKey('failover'));

$result = $request->wait();

echo $result['model'];          // auto_switch:<uuid>
echo $result['resolved_model']; // Provider/Model برنده
print_r($result['auto_switch']['attempts'] ?? []);

$request = $ai->visionAnalyze(
    __DIR__.'/invoice.jpg',
    ['model' => 'provider:vision-model', 'prompt' => 'فاکتور را تحلیل کن'],
    Client::idempotencyKey('vision'),
);

$result = $request->wait();

$request = $ai->imageGeneration([
    'model' => 'provider:image-model',
    'prompt' => 'A minimal futuristic AI gateway icon',
    'size' => '1024x1024',
]);

$result = $request->wait();
$request->downloadMedia(storage_path('app/generated.webp'));

$batch = $ai->batchBuilder()
    ->metadata(['job' => 'nightly-enrichment'])
    ->chat('provider:model', ['message' => 'خلاصه کن: ...'], 'item_1')
    ->embeddings('provider:embedding-model', ['input' => ['متن اول', 'متن دوم']], 'item_2')
    ->rerank('provider:rerank-model', [
        'query' => 'بهترین نتیجه',
        'documents' => ['سند اول', 'سند دوم'],
        'top_n' => 2,
    ], 'item_3')
    ->send(Client::idempotencyKey('batch'));

$result = $batch->wait();

use AmirKateb\AiCoreClient\WebhookVerifier;

$rawBody = file_get_contents('php://input');
$headers = getallheaders();

$payload = WebhookVerifier::fromHeaders(
    getenv('AI_CORE_WEBHOOK_SECRET'),
    $headers,
    $rawBody,
);

// Signature + timestamp are valid here.

use AmirKateb\AiCoreClient\Exception\ApiException;
use AmirKateb\AiCoreClient\Exception\TransportException;

try {
    $result = $ai->chat(['message' => 'سلام'])->wait();
} catch (ApiException $e) {
    error_log('HTTP '.$e->statusCode.' / '.($e->errorCode ?? 'unknown'));
    error_log($e->getMessage());
} catch (TransportException $e) {
    error_log('Network error: '.$e->getMessage());
}

// .env
AI_CORE_URL=https://ai.avaztek.ir
AI_CORE_API_KEY=aik_...
AI_CORE_TIMEOUT=300

// Laravel 8–13: package auto-discovery binds Client automatically.
use AmirKateb\AiCoreClient\Client;

final class SummarizeService
{
    public function __construct(private Client $ai) {}

    public function run(string $text): array
    {
        return $this->ai->chat(['message' => $text])->wait();
    }
}

// Optional facade: AiCore::chat([...])->wait();