Use child model classes as factories instead

demo/src/Audio/Chat.php

@@ -39,7 +39,7 @@ public function say(string $base64audio): void
         $path = tempnam(sys_get_temp_dir(), 'audio-').'.wav';
         file_put_contents($path, base64_decode($base64audio));
 
-        $result = $this->platform->invoke(new Whisper(), Audio::fromFile($path));
+        $result = $this->platform->invoke(Whisper::create(), Audio::fromFile($path));
 
         $this->submitMessage($result->asText());
     }

demo/src/Video/TwigComponent.php

@@ -47,7 +47,7 @@ public function submit(#[LiveArg] string $instruction, #[LiveArg] string $image)
             Message::ofUser($instruction, Image::fromDataUrl($image))
         );
 
-        $result = $this->platform->invoke(new Gpt(Gpt::GPT_4O_MINI), $messageBag, [
+        $result = $this->platform->invoke(Gpt::create(Gpt::GPT_4O_MINI), $messageBag, [
             'max_tokens' => 100,
         ]);
 

examples/albert/chat.php

@@ -19,7 +19,7 @@
 
 $platform = PlatformFactory::create(env('ALBERT_API_KEY'), env('ALBERT_API_URL'), http_client());
 
-$model = new Gpt('gpt-4o');
+$model = Gpt::create('gpt-4o');
 $agent = new Agent($platform, $model, logger: logger());
 
 $documentContext = <<<'CONTEXT'

examples/anthropic/chat.php

@@ -18,7 +18,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('ANTHROPIC_API_KEY'), httpClient: http_client());
-$model = new Claude(Claude::SONNET_37);
+$model = Claude::create(Claude::SONNET_37);
 
 $agent = new Agent($platform, $model, logger: logger());
 $messages = new MessageBag(

examples/anthropic/image-input-binary.php

@@ -19,7 +19,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('ANTHROPIC_API_KEY'), httpClient: http_client());
-$model = new Claude(Claude::SONNET_37);
+$model = Claude::create(Claude::SONNET_37);
 
 $agent = new Agent($platform, $model, logger: logger());
 $messages = new MessageBag(

examples/anthropic/image-input-url.php

@@ -19,7 +19,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('ANTHROPIC_API_KEY'), httpClient: http_client());
-$model = new Claude(Claude::SONNET_37);
+$model = Claude::create(Claude::SONNET_37);
 
 $agent = new Agent($platform, $model, logger: logger());
 $messages = new MessageBag(

examples/anthropic/pdf-input-binary.php

@@ -19,7 +19,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('ANTHROPIC_API_KEY'), httpClient: http_client());
-$model = new Claude(Claude::SONNET_37);
+$model = Claude::create(Claude::SONNET_37);
 
 $agent = new Agent($platform, $model, logger: logger());
 $messages = new MessageBag(

examples/anthropic/pdf-input-url.php

@@ -19,7 +19,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('ANTHROPIC_API_KEY'), httpClient: http_client());
-$model = new Claude(Claude::SONNET_37);
+$model = Claude::create(Claude::SONNET_37);
 
 $agent = new Agent($platform, $model, logger: logger());
 $messages = new MessageBag(

examples/anthropic/stream.php

@@ -18,7 +18,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('ANTHROPIC_API_KEY'), httpClient: http_client());
-$model = new Claude();
+$model = Claude::create();
 
 $agent = new Agent($platform, $model, logger: logger());
 $messages = new MessageBag(

examples/anthropic/toolcall.php

@@ -21,7 +21,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('ANTHROPIC_API_KEY'), httpClient: http_client());
-$model = new Claude();
+$model = Claude::create();
 
 $wikipedia = new Wikipedia(http_client());
 $toolbox = new Toolbox([$wikipedia], logger: logger());

examples/azure/audio-transcript.php

@@ -22,7 +22,7 @@
     env('AZURE_OPENAI_KEY'),
     http_client(),
 );
-$model = new Whisper();
+$model = Whisper::create();
 $file = Audio::fromFile(dirname(__DIR__, 2).'/fixtures/audio.mp3');
 
 $result = $platform->invoke($model, $file);

examples/azure/chat-gpt.php

@@ -24,7 +24,7 @@
     env('AZURE_OPENAI_KEY'),
     http_client(),
 );
-$model = new Gpt(Gpt::GPT_4O_MINI);
+$model = Gpt::create(Gpt::GPT_4O_MINI);
 
 $agent = new Agent($platform, $model, logger: logger());
 $messages = new MessageBag(

examples/azure/chat-llama.php

@@ -18,7 +18,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('AZURE_LLAMA_BASEURL'), env('AZURE_LLAMA_KEY'), http_client());
-$model = new Llama(Llama::V3_3_70B_INSTRUCT);
+$model = Llama::create(Llama::V3_3_70B_INSTRUCT);
 
 $agent = new Agent($platform, $model, logger: logger());
 $messages = new MessageBag(Message::ofUser('I am going to Paris, what should I see?'));

examples/azure/embeddings.php

@@ -21,7 +21,7 @@
     env('AZURE_OPENAI_KEY'),
     http_client(),
 );
-$embeddings = new Embeddings();
+$embeddings = Embeddings::create();
 
 $result = $platform->invoke($embeddings, <<<TEXT
     Once upon a time, there was a country called Japan. It was a beautiful country with a lot of mountains and rivers.

examples/bedrock/chat-claude.php

@@ -24,7 +24,7 @@
 }
 
 $platform = PlatformFactory::create();
-$model = new Claude('claude-3-7-sonnet-20250219');
+$model = Claude::create('claude-3-7-sonnet-20250219');
 
 $agent = new Agent($platform, $model, logger: logger());
 $messages = new MessageBag(

examples/bedrock/chat-llama.php

@@ -24,7 +24,7 @@
 }
 
 $platform = PlatformFactory::create();
-$model = new Llama(Llama::V3_2_3B_INSTRUCT);
+$model = Llama::create(Llama::V3_2_3B_INSTRUCT);
 
 $agent = new Agent($platform, $model, logger: logger());
 $messages = new MessageBag(

examples/bedrock/chat-nova.php

@@ -24,7 +24,7 @@
 }
 
 $platform = PlatformFactory::create();
-$model = new Nova(Nova::PRO);
+$model = Nova::create(Nova::PRO);
 
 $agent = new Agent($platform, $model, logger: logger());
 $messages = new MessageBag(

examples/bedrock/image-claude-binary.php

@@ -25,7 +25,7 @@
 }
 
 $platform = PlatformFactory::create();
-$model = new Claude('claude-3-7-sonnet-20250219');
+$model = Claude::create('claude-3-7-sonnet-20250219');
 
 $agent = new Agent($platform, $model, logger: logger());
 $messages = new MessageBag(

examples/bedrock/image-nova.php

@@ -25,7 +25,7 @@
 }
 
 $platform = PlatformFactory::create();
-$model = new Nova(Nova::PRO);
+$model = Nova::create(Nova::PRO);
 
 $agent = new Agent($platform, $model, logger: logger());
 $messages = new MessageBag(

examples/bedrock/toolcall-claude.php

@@ -27,7 +27,7 @@
 }
 
 $platform = PlatformFactory::create();
-$model = new Claude('claude-3-7-sonnet-20250219');
+$model = Claude::create('claude-3-7-sonnet-20250219');
 
 $wikipedia = new Wikipedia(http_client());
 $toolbox = new Toolbox([$wikipedia]);

examples/bedrock/toolcall-nova.php

@@ -27,7 +27,7 @@
 }
 
 $platform = PlatformFactory::create();
-$model = new Nova();
+$model = Nova::create();
 
 $wikipedia = new Wikipedia(http_client());
 $toolbox = new Toolbox([$wikipedia]);

examples/document/vectorizing.php

@@ -19,7 +19,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('OPENAI_API_KEY'), http_client());
-$embeddings = new Embeddings(Embeddings::TEXT_3_LARGE);
+$embeddings = Embeddings::create(Embeddings::TEXT_3_LARGE);
 
 $textDocuments = [
     new TextDocument(Uuid::v4(), 'Hello World'),

examples/gemini/audio-input.php

@@ -19,7 +19,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('GEMINI_API_KEY'), http_client());
-$model = new Gemini(Gemini::GEMINI_1_5_FLASH);
+$model = Gemini::create(Gemini::GEMINI_1_5_FLASH);
 
 $agent = new Agent($platform, $model, logger: logger());
 $messages = new MessageBag(

examples/gemini/chat.php

@@ -18,7 +18,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('GEMINI_API_KEY'), http_client());
-$model = new Gemini(Gemini::GEMINI_2_FLASH);
+$model = Gemini::create(Gemini::GEMINI_2_FLASH);
 
 $agent = new Agent($platform, $model, logger: logger());
 $messages = new MessageBag(

examples/gemini/embeddings.php

@@ -15,7 +15,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('GEMINI_API_KEY'), http_client());
-$embeddings = new Embeddings();
+$embeddings = Embeddings::create();
 
 $result = $platform->invoke($embeddings, <<<TEXT
     Once upon a time, there was a country called Japan. It was a beautiful country with a lot of mountains and rivers.

examples/gemini/image-input.php

@@ -19,7 +19,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('GEMINI_API_KEY'), http_client());
-$model = new Gemini(Gemini::GEMINI_1_5_FLASH);
+$model = Gemini::create(Gemini::GEMINI_1_5_FLASH);
 
 $agent = new Agent($platform, $model, logger: logger());
 $messages = new MessageBag(

examples/gemini/pdf-input-binary.php

@@ -19,7 +19,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('GEMINI_API_KEY'), http_client());
-$model = new Gemini(Gemini::GEMINI_1_5_FLASH);
+$model = Gemini::create(Gemini::GEMINI_1_5_FLASH);
 
 $agent = new Agent($platform, $model, logger: logger());
 $messages = new MessageBag(

examples/gemini/server-tools.php

@@ -23,7 +23,7 @@
 $platform = PlatformFactory::create(env('GEMINI_API_KEY'), http_client());
 
 // Available server-side tools as of 2025-06-28: url_context, google_search, code_execution
-$llm = new Gemini('gemini-2.5-pro-preview-03-25', ['server_tools' => ['url_context' => true], 'temperature' => 1.0]);
+$llm = Gemini::create('gemini-2.5-pro-preview-03-25', options: ['server_tools' => ['url_context' => true], 'temperature' => 1.0]);
 
 $toolbox = new Toolbox([new Clock()], logger: logger());
 $processor = new AgentProcessor($toolbox);

examples/gemini/stream.php

@@ -18,7 +18,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('GEMINI_API_KEY'), http_client());
-$model = new Gemini(Gemini::GEMINI_2_FLASH);
+$model = Gemini::create(Gemini::GEMINI_2_FLASH);
 
 $agent = new Agent($platform, $model, logger: logger());
 $messages = new MessageBag(

examples/gemini/structured-output-clock.php

@@ -23,7 +23,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('GEMINI_API_KEY'), http_client());
-$model = new Gemini(Gemini::GEMINI_1_5_FLASH);
+$model = Gemini::create(Gemini::GEMINI_1_5_FLASH);
 
 $clock = new Clock(new SymfonyClock());
 $toolbox = new Toolbox([$clock]);

examples/gemini/structured-output-math.php

@@ -20,7 +20,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('GEMINI_API_KEY'), http_client());
-$model = new Gemini(Gemini::GEMINI_1_5_FLASH);
+$model = Gemini::create(Gemini::GEMINI_1_5_FLASH);
 
 $processor = new AgentProcessor();
 $agent = new Agent($platform, $model, [$processor], [$processor], logger());

examples/gemini/toolcall.php

@@ -21,7 +21,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('GEMINI_API_KEY'), http_client());
-$llm = new Gemini(Gemini::GEMINI_2_FLASH);
+$llm = Gemini::create(Gemini::GEMINI_2_FLASH);
 
 $toolbox = new Toolbox([new Clock()], logger: logger());
 $processor = new AgentProcessor($toolbox);

examples/lmstudio/chat.php

@@ -18,7 +18,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('LMSTUDIO_HOST_URL'), http_client());
-$model = new Completions('gemma-3-4b-it-qat');
+$model = Completions::create('gemma-3-4b-it-qat');
 
 $agent = new Agent($platform, $model, logger: logger());
 $messages = new MessageBag(

examples/lmstudio/image-input-binary.php

@@ -20,7 +20,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('LMSTUDIO_HOST_URL'), http_client());
-$model = new Completions(
+$model = Completions::create(
     name: 'gemma-3-4b-it-qat',
     capabilities: [...Completions::DEFAULT_CAPABILITIES, Capability::INPUT_IMAGE]
 );

examples/memory/mariadb.php

@@ -58,15 +58,15 @@
 
 // create embeddings for documents as preparation of the chain memory
 $platform = PlatformFactory::create(env('OPENAI_API_KEY'), http_client());
-$vectorizer = new Vectorizer($platform, $embeddings = new Embeddings());
+$vectorizer = new Vectorizer($platform, $embeddings = Embeddings::create());
 $indexer = new Indexer($vectorizer, $store, logger());
 $indexer->index($documents);
 
 // Execute a chat call that is utilizing the memory
 $embeddingsMemory = new EmbeddingProvider($platform, $embeddings, $store);
 $memoryProcessor = new MemoryInputProcessor($embeddingsMemory);
 
-$agent = new Agent($platform, new Gpt(Gpt::GPT_4O_MINI), [$memoryProcessor], logger: logger());
+$agent = new Agent($platform, Gpt::create(Gpt::GPT_4O_MINI), [$memoryProcessor], logger: logger());
 $messages = new MessageBag(Message::ofUser('Have we discussed about my friend John in the past? If yes, what did we talk about?'));
 $result = $agent->call($messages);
 

examples/memory/static.php

@@ -21,7 +21,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create($_ENV['OPENAI_API_KEY'], http_client());
-$model = new Gpt(Gpt::GPT_4O_MINI);
+$model = Gpt::create(Gpt::GPT_4O_MINI);
 
 $systemPromptProcessor = new SystemPromptInputProcessor('You are a professional trainer with short, personalized advice and a motivating claim.');
 

examples/misc/chat-system-prompt.php

@@ -19,7 +19,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('OPENAI_API_KEY'), http_client());
-$model = new Gpt(Gpt::GPT_4O_MINI);
+$model = Gpt::create(Gpt::GPT_4O_MINI);
 
 $processor = new SystemPromptInputProcessor('You are Yoda and write like he speaks. But short.');
 

examples/misc/parallel-chat-gpt.php

@@ -17,7 +17,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('OPENAI_API_KEY'), http_client());
-$model = new Gpt(Gpt::GPT_4O_MINI, [
+$model = Gpt::create(Gpt::GPT_4O_MINI, [
     'temperature' => 0.5, // default options for the model
 ]);
 

examples/misc/parallel-embeddings.php

@@ -15,9 +15,9 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('OPENAI_API_KEY'), http_client());
-$ada = new Embeddings(Embeddings::TEXT_ADA_002);
-$small = new Embeddings(Embeddings::TEXT_3_SMALL);
-$large = new Embeddings(Embeddings::TEXT_3_LARGE);
+$ada = Embeddings::create(Embeddings::TEXT_ADA_002);
+$small = Embeddings::create(Embeddings::TEXT_3_SMALL);
+$large = Embeddings::create(Embeddings::TEXT_3_LARGE);
 
 echo 'Initiating parallel embeddings calls to platform ...'.\PHP_EOL;
 $results = [];

examples/misc/persistent-chat.php

@@ -20,7 +20,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('OPENAI_API_KEY'), http_client());
-$llm = new Gpt(Gpt::GPT_4O_MINI);
+$llm = Gpt::create(Gpt::GPT_4O_MINI);
 
 $agent = new Agent($platform, $llm, logger: logger());
 $chat = new Chat($agent, new InMemoryStore());

examples/mistral/chat-multiple.php

@@ -18,7 +18,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('MISTRAL_API_KEY'), http_client());
-$agent = new Agent($platform, new Mistral(), logger: logger());
+$agent = new Agent($platform, Mistral::create(), logger: logger());
 
 $messages = new MessageBag(
     Message::forSystem('Just give short answers.'),

examples/mistral/chat.php

@@ -18,7 +18,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('MISTRAL_API_KEY'), http_client());
-$model = new Mistral();
+$model = Mistral::create();
 $agent = new Agent($platform, $model, logger: logger());
 
 $messages = new MessageBag(Message::ofUser('What is the best French cheese?'));

examples/mistral/embeddings.php

@@ -15,7 +15,7 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('MISTRAL_API_KEY'), http_client());
-$model = new Embeddings();
+$model = Embeddings::create();
 
 $result = $platform->invoke($model, <<<TEXT
     In the middle of the 20th century, food scientists began to understand the importance of vitamins and minerals in