Chat API

use Mateffy\Magic;

$answer = Magic::ask('What is the capital of France?');
// -> "The capital of France is Paris."

use Mateffy\Magic;
use Mateffy\Magic\Chat\Messages\Step;

$messages = Magic::chat()
    ->model('google/gemini-2.0-flash-lite')
    ->temperature(0.5)
    ->messages([
        Step::user([
            Step\Text::make('What is in this picture and where was it taken?'),
            Step\Image::make('https://example.com/eiffel-tower.jpg'),
        ]),
        Step::assistant([
            Step\Text::make('The picture shows the Eiffel Tower, which is located in Paris, France.'),
        ]),
        Step::user('How much is a flight to Paris?'),
    ])
    ->stream();

Magic::chat()
    ->model('google/gemini-2.0-flash-lite')
    // ... rest of configuration

Magic::chat()
    ->temperature(0.5)
    // ... rest of configuration

Magic::chat()
    ->system('You are a helpful assistant specialized in travel planning.')
    ->prompt('Plan a trip to Paris')
    ->stream();

Magic::chat()
    ->model('google/gemini-2.0-flash-lite')
    ->prompt('What is the capital of France?')
    ->stream();

use Mateffy\Magic\Chat\Messages\Step;

// Text only
Step::user('Tell me about Paris');

// Text with image
Step::user([
    Step\Text::make('What is in this image?'),
    Step\Image::make('https://example.com/photo.jpg'),
]);

Step::assistant('Paris is the capital of France.');

Step::assistant([
    Step\Text::make('Here is the information you requested.'),
]);

Magic::chat()
    ->messages([
        Step::user('What is the weather in Paris?'),
        Step::assistant('Let me check that for you.'),
        Step::user('Thanks!'),
    ])
    ->stream();

use Mateffy\Magic;

$messages = Magic::chat()
    ->model('google/gemini-2.0-flash-lite')
    ->messages([
        Step::user('How much is a flight to Paris?'),
    ])
    ->tools([
        'search_flight' => function (string $from_airport_code, string $to_airport_code) {
            return app(FlightService::class)
                ->search($from_airport_code, $to_airport_code)
                ->toArray();
        },
    ])
    ->stream();

use Mateffy\Magic\Chat\ToolChoice;

// Let the AI decide (default)
Magic::chat()
    ->tools([/* ... */])
    ->toolChoice(ToolChoice::Auto)
    ->stream();

// Force a specific tool
Magic::chat()
    ->tools(['extract' => /* ... */])
    ->toolChoice('extract')
    ->stream();

// Require any tool to be called
Magic::chat()
    ->tools([/* ... */])
    ->forceTool(ToolChoice::Required)
    ->stream();

Magic::chat()
    ->tools([/* ... */])
    ->onToolError(function (\Throwable $error) {
        logger()->error('Tool execution failed', [
            'error' => $error->getMessage(),
        ]);
    })
    ->stream();

use Mateffy\Magic\Chat\Messages\ToolCall;

Magic::chat()
    ->tools([/* ... */])
    ->interrupt(function (ToolCall $call) {
        // Return true to interrupt execution
        if ($call->name === 'delete_data') {
            return true; // Requires confirmation
        }
        return false; // Continue execution
    })
    ->stream();

$messages = Magic::chat()
    ->prompt('Write a story about Paris')
    ->stream();

// Access the final text
$text = $messages->text();

$messages = Magic::chat()
    ->prompt('What is 2+2?')
    ->send();

$messages = Magic::chat()->prompt('Hello')->stream();

// First text message
$firstText = $messages->firstText();

// Last text message
$lastText = $messages->lastText();

// All text concatenated
$allText = $messages->text();

// First tool call
$toolCall = $messages->firstToolCallMessage();

// First tool result
$result = $messages->firstToolResultMessage();

// Get the output
$output = $result->output;

// Find specific tool results
$flightResult = $messages->firstToolResultMessage(
    fn($msg) => $msg->call->name === 'search_flight'
);

Magic::chat()
    ->prompt('Tell me a story')
    ->onMessage(function ($message) {
        // Called for each complete message
        logger()->info('New message', ['type' => get_class($message)]);
    })
    ->onMessageProgress(function ($message) {
        // Called during streaming for each chunk
        echo $message->text();
    })
    ->stream();

Magic::chat()
    ->prompt('Explain quantum computing')
    ->onTokenStats(function ($stats) {
        logger()->info('Tokens used', $stats);
    })
    ->stream();

Magic::chat()
    ->tools([/* ... */])
    ->attempts(3) // Retry up to 3 times on error
    ->stream();

use Mateffy\Magic;
use Mateffy\Magic\Chat\Messages\Step;

$conversation = Magic::chat()
    ->model('google/gemini-2.0-flash-lite')
    ->temperature(0.7)
    ->system('You are a travel assistant. Help users plan their trips.')
    ->messages([
        Step::user('I want to visit Paris next month'),
    ])
    ->tools([
        'search_flights' => function (string $destination, string $date) {
            return FlightAPI::search($destination, $date);
        },
        'get_weather' => function (string $city, string $date) {
            return WeatherAPI::forecast($city, $date);
        },
        'find_hotels' => function (string $city, int $nights) {
            return HotelAPI::search($city, $nights);
        },
    ])
    ->onMessage(function ($message) {
        logger()->info('Message received', ['message' => $message]);
    })
    ->onTokenStats(function ($stats) {
        logger()->info('Token usage', $stats);
    })
    ->stream();

echo $conversation->text();