namespace Cognesy\Polyglot\LLM;

class Inference {
    // Create and manage the LLM instance
    public function __construct(
        string $connection = '',
        ?LLMConfig $config = null,
        ?CanHandleHttpRequest $httpClient = null,
        ?CanHandleInference $driver = null,
        ?EventDispatcher $events = null
    ) { ... }

    // Configure the instance
    public function using(string $preset): self { ... }
    public function withConfig(LLMConfig $config): self { ... }
    public function withHttpClient(CanHandleHttpRequest $httpClient): self { ... }
    public function withDriver(CanHandleInference $driver): self { ... }
    public function withDebugPreset(?string $preset): self { ... }
    public function withCachedContext(...): self { ... }

    // Main method for creating inference requests
    public function create(
        string|array $messages = [],
        string $model = '',
        array $tools = [],
        string|array $toolChoice = [],
        array $responseFormat = [],
        array $options = [],
        Mode $mode = OutputMode::Text
    ): PendingInference { ... }

    // Static convenience method for simple text generation
    public static function text(
        string|array $messages,
        string $connection = '',
        string $model = '',
        array $options = []
    ): string { ... }
}

namespace Cognesy\Polyglot\Embeddings;

use Cognesy\Polyglot\Embeddings\Data\EmbeddingsResponse;class Embeddings {
    public function __construct(
        string $connection = '',
        ?EmbeddingsConfig $config = null,
        ?CanHandleHttpRequest $httpClient = null,
        ?CanVectorize $driver = null,
        ?EventDispatcher $events = null
    ) { ... }

    // Configuration methods
    public function using(string $preset): self { ... }
    public function withConfig(EmbeddingsConfig $config): self { ... }
    public function withModel(string $model): self { ... }
    public function withHttpClient(CanHandleHttpRequest $httpClient): self { ... }
    public function withDriver(CanVectorize $driver): self { ... }

    // Main method for generating embeddings
    public function create(string|array $input, array $options = []): EmbeddingsResponse { ... }

    // Utility methods for finding similar content
    public function findSimilar(string $query, array $documents, int $topK = 5): array { ... }
}