Package org.machanism.machai.ai.provider.impl

Class CodeMieProvider

java.lang.Object

org.machanism.machai.ai.provider.GenaiAdapter

org.machanism.machai.ai.provider.impl.CodeMieProvider

All Implemented Interfaces:

EmbeddingProvider, Genai

public class CodeMieProvider
extends GenaiAdapter
implements EmbeddingProvider

Genai implementation that integrates with EPAM CodeMie.

This provider authenticates against a CodeMie OpenID Connect (OIDC) token endpoint to obtain an OAuth 2.0 access token and then configures an OpenAI-compatible backend (CodeMie Code Assistant REST API).

Authentication modes

• Password grant is used when GENAI_USERNAME contains "@" (typical e-mail login).
• Client credentials is used otherwise (service-to-service).

Provider delegation

After retrieving a token, this provider sets the following configuration keys before delegating to a downstream provider:

• OPENAI_BASE_URL to BASE_URL
• OPENAI_API_KEY to the retrieved access token

Delegation is selected based on the configured model prefix:

• gpt-* (or blank/unspecified) models delegate to OpenAIProvider
• claude-* models delegate to AnthropicProvider

Field Summary

Fields

Modifier and Type	Field	Description
static final String	AUTH_URL	Default OpenID Connect token endpoint for CodeMie.
static final String	AUTH_URL_PROP_NAME	Configuration key used to override the default token endpoint.
static final String	BASE_URL	Base URL for the CodeMie Code Assistant API.

Fields inherited from class org.machanism.machai.ai.provider.GenaiAdapter

provider

Constructor Summary

Constructors

Constructor	Description
CodeMieProvider()	Creates a CodeMie provider instance.

Method Summary

Modifier and Type	Method	Description
List<Double>	embedding(String text, long dimensions)	Requests an embedding vector for the given input text.
static String	getToken(String url, String username, String password)	Requests an OAuth 2.0 access token from the given token endpoint.
void	init(String model, Configurator conf)	Initializes the provider using configuration values.

Methods inherited from class org.machanism.machai.ai.provider.GenaiAdapter

addPrompts, addTools, clear, inputsLog, instructions, perform, prompt, setErrorHandling, setProjectDir, setProvider

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

AUTH_URL_PROP_NAME

public static final String AUTH_URL_PROP_NAME

Configuration key used to override the default token endpoint.

See Also:

• Constant Field Values

AUTH_URL

public static final String AUTH_URL

Default OpenID Connect token endpoint for CodeMie.

Can be overridden via the AUTH_URL configuration key.

See Also:

• Constant Field Values

BASE_URL

public static final String BASE_URL

Base URL for the CodeMie Code Assistant API.

This base URL is used to configure the underlying OpenAI-compatible client.

See Also:

• Constant Field Values

Constructor Details

CodeMieProvider

public CodeMieProvider()

Creates a CodeMie provider instance.

Method Details

init

public void init(String model,
 Configurator conf)

Initializes the provider using configuration values.

Required configuration keys:

• GENAI_USERNAME – user e-mail or client id.
• GENAI_PASSWORD – password or client secret.
• model – model identifier (for example gpt-4o-mini, gemini-1.5-pro, claude-3-5-sonnet).

Optional configuration keys:

• AUTH_URL – token endpoint override.

Specified by:

init in interface EmbeddingProvider

Specified by:

init in interface Genai

Overrides:

init in class GenaiAdapter

Parameters:

model - the model identifier or name to use

conf - configuration source

config - configuration source

Throws:

IllegalArgumentException - if a configuration conflict is detected, authorization fails, or an unsupported model is configured

getToken

public static String getToken(String url,
 String username,
 String password)
                       throws IOException

Requests an OAuth 2.0 access token from the given token endpoint.

The request uses application/x-www-form-urlencoded and selects the grant type based on the username value:

• password if the username contains "@".
• client_credentials otherwise.

Parameters:

url - token endpoint URL

username - user e-mail (password grant) or client id (client credentials)

password - password (password grant) or client secret (client credentials)

Returns:

the access_token value extracted from the response

Throws:

IOException - if the HTTP request fails, returns a non-200 response, or the token cannot be read

embedding

public List<Double> embedding(String text,
 long dimensions)

Requests an embedding vector for the given input text.

Specified by:

embedding in interface EmbeddingProvider

Parameters:

text - input to embed

dimensions - number of dimensions requested from the embedding model

Returns:

embedding as a list of double values, or null when text is null