package Langertha::Engine::MiniMax;
# ABSTRACT: MiniMax API (OpenAI-compatible)
our $VERSION = '0.403';
use Moose;
use Carp qw( croak );

extends 'Langertha::Engine::OpenAIBase';

with map { 'Langertha::Role::'.$_ } qw(
  StaticModels
  ResponseFormat
  Tools
);


sub _build_supported_operations {[qw(
  createChatCompletion
)]}

has '+url' => (
  lazy => 1,
  default => sub { 'https://api.minimax.io/v1' },
);

sub _build_api_key {
  my ( $self ) = @_;
  return $ENV{LANGERTHA_MINIMAX_API_KEY}
    || croak "".(ref $self)." requires LANGERTHA_MINIMAX_API_KEY or api_key set";
}

sub default_model { 'MiniMax-M2.7' }

sub default_response_size { 4096 }

sub _build_static_models {[
  { id => 'MiniMax-M2.7' },
  { id => 'MiniMax-M2.5' },
  { id => 'MiniMax-M2.5-highspeed' },
  { id => 'MiniMax-M2.1' },
  { id => 'MiniMax-M2.1-highspeed' },
  { id => 'MiniMax-M2' },
]}

__PACKAGE__->meta->make_immutable;


1;

__END__

=pod

=encoding UTF-8

=head1 NAME

Langertha::Engine::MiniMax - MiniMax API (OpenAI-compatible)

=head1 VERSION

version 0.403

=head1 SYNOPSIS

    use Langertha::Engine::MiniMax;

    my $minimax = Langertha::Engine::MiniMax->new(
        api_key => $ENV{MINIMAX_API_KEY},
        model   => 'MiniMax-M2.7',
    );

    print $minimax->simple_chat('Hello from Perl!');

    # Streaming
    $minimax->simple_chat_stream(sub {
        print shift->content;
    }, 'Write a poem');

    # Tool calling
    my $response = await $minimax->chat_with_tools_f('Search for Perl modules');

=head1 DESCRIPTION

Provides access to L<MiniMax|https://www.minimax.io/> models via their
native OpenAI-compatible endpoint at C<https://api.minimax.io/v1>.

MiniMax is a Chinese AI company based in Shanghai offering large language
models with strong coding, reasoning, and agentic capabilities.

B<Why the OpenAI endpoint, not the Anthropic one:> MiniMax also exposes an
C</anthropic> endpoint, but that endpoint is a shim — it does not always
re-parse stringified tool-call arguments, leading to intermittent tool-
calling failures where the Anthropic SDK sees a wrapper object whose key
rotates between C<result>, C<arguments>, and the tool name. The native
OpenAI-compatible endpoint avoids the shim entirely. If you need the
Anthropic wire format, use L<Langertha::Engine::MiniMaxAnthropic>.

B<Available text models:>

=over 4

=item * C<MiniMax-M2.7> — Latest flagship (default).

=item * C<MiniMax-M2.5> — 1M context window, SOTA coding (80.2%
SWE-Bench Verified), agentic tool use, and search.

=item * C<MiniMax-M2.5-highspeed> — Same M2.5 performance with lower
latency. 205K context window.

=item * C<MiniMax-M2.1> — 230B total parameters, 10B activated per
inference. Strong multilingual coding and reasoning.

=item * C<MiniMax-M2.1-highspeed> — Same M2.1 performance with lower
latency.

=item * C<MiniMax-M2> — 200K context, 128K max output. Function calling
and agentic capabilities.

=back

See L<https://platform.minimax.io/docs/guides/models-intro> for the full
model catalog including audio, video, and music models.

Supports chat, streaming, tool calling, and structured output. Embeddings,
transcription, images, and documents are not supported via this endpoint.

Get your API key at L<https://platform.minimax.io/> and set
C<LANGERTHA_MINIMAX_API_KEY> in your environment.

=head1 SEE ALSO

=over

=item * L<Langertha::Engine::MiniMaxAnthropic> - MiniMax via legacy Anthropic-compatible endpoint

=item * L<https://platform.minimax.io/docs/api-reference/text-openai-api> - MiniMax OpenAI-compatible API docs

=item * L<Langertha::Engine::OpenAIBase> - Base class for OpenAI-compatible engines

=item * L<Langertha::Role::Tools> - MCP tool calling interface

=back

=head1 SUPPORT

=head2 Issues

Please report bugs and feature requests on GitHub at
L<https://github.com/Getty/langertha/issues>.

=head2 IRC

Join C<#langertha> on C<irc.perl.org> or message Getty directly.

=head1 CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

=head1 AUTHOR

Torsten Raudssus <torsten@raudssus.de> L<https://raudssus.de/>

=head1 COPYRIGHT AND LICENSE

This software is copyright (c) 2026 by Torsten Raudssus.

This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.

=cut
