Request and Response Objects

namespace Cognesy\Polyglot\LLM;

class InferenceRequest {
    public array $messages = [];
    public string $model = '';
    public array $tools = [];
    public string|array $toolChoice = [];
    public array $responseFormat = [];
    public array $options = [];
    public Mode $mode = Mode::Text;
    public ?CachedContext $cachedContext;

    public function __construct(...) { ... }

    // Getters
    public function messages(): array { ... }
    public function model(): string { ... }
    public function isStreamed(): bool { ... }
    public function tools(): array { ... }
    public function toolChoice(): string|array { ... }
    public function responseFormat(): array { ... }
    public function options(): array { ... }
    public function mode(): Mode { ... }
    public function cachedContext(): ?CachedContext { ... }

    // Fluent setters
    public function withMessages(string|array $messages): self { ... }
    public function withModel(string $model): self { ... }
    public function withStreaming(bool $streaming): self { ... }
    public function withTools(array $tools): self { ... }
    public function withToolChoice(string|array $toolChoice): self { ... }
    public function withResponseFormat(array $responseFormat): self { ... }
    public function withOptions(array $options): self { ... }
    public function withMode(Mode $mode): self { ... }
    public function withCachedContext(?CachedContext $cachedContext): self { ... }

    // Utility methods
    public function toArray(): array { ... }
    public function withCacheApplied(): self { ... }
}

namespace Cognesy\Polyglot\LLM;

class InferenceResponse {
    public function __construct(
        HttpClientResponse $response,
        CanHandleInference $driver,
        LLMConfig $config,
        bool $isStreamed = false,
        ?EventDispatcher $events = null
    ) { ... }

    // Access methods
    public function isStreamed(): bool { ... }
    public function toText(): string { ... }
    public function toJson(): array { ... }
    public function stream(): InferenceStream { ... }
    public function response(): LLMResponse { ... }
}

namespace Cognesy\Polyglot\LLM;

class InferenceStream {
    public function __construct(
        HttpClientResponse $response,
        CanHandleInference $driver,
        LLMConfig $config,
        ?EventDispatcher $events = null
    ) { ... }

    // Stream processing methods
    public function responses(): Generator { ... }
    public function all(): array { ... }
    public function final(): ?LLMResponse { ... }
    public function onPartialResponse(callable $callback): self { ... }
}

namespace Cognesy\Polyglot\Embeddings;

class EmbeddingsResponse {
    public function __construct(
        public array $vectors,
        public ?Usage $usage
    ) { ... }

    // Access methods
    public function first(): Vector { ... }
    public function last(): Vector { ... }
    public function all(): array { ... }
    public function usage(): Usage { ... }
    public function toValuesArray(): array { ... }
    public function totalTokens(): int { ... }
    public function split(int $index): array { ... }
}