AttractorEx.Agent.ProviderProfile (attractor_phoenix v0.1.0)

Provider-aligned configuration for the coding-agent loop.

A profile packages a model, toolset, provider options, and an optional system-prompt builder so agent sessions can stay portable across providers. Profiles can also be extended with register_tool/2 and register_tools/2, allowing custom tools to be layered on top of provider presets while overriding name collisions deterministically.

The module also exposes a maintained cross-provider integration matrix for the built-in OpenAI, Anthropic, and Gemini presets. Gemini can optionally include web-search tools via gemini(web_tools: true).

Summary

Types

integration_entry()

t()

Functions

anthropic(opts \\ [])

build_system_prompt(profile, context)

Builds the system prompt for a session request.

gemini(opts \\ [])

instruction_files(provider_profile)

Returns the project-instruction files relevant to the active provider profile.

integration_matrix()

Returns the maintained cross-provider integration matrix for built-in presets.

new(opts)

Builds a provider profile from keyword options.

openai(opts \\ [])

reasoning_option_path(provider_profile)

Returns the provider-native request path associated with reasoning/thinking controls.

reference_tool_names(profile)

Returns the upstream native tool names the preset is intended to align with.

register_tool(profile, tool)

Registers or replaces a tool on top of an existing profile.

register_tools(profile, tools)

Registers or replaces tools on top of an existing profile, preserving order.

system_prompt_style(provider_profile)

Returns the reference-agent prompt family used as the preset target.

tool_definitions(profile)

Returns the serialized tool definitions exposed to the model.

Types

integration_entry()

@type integration_entry() :: %{
  id: String.t(),
  provider_family: atom(),
  preset: atom(),
  supports_reasoning: boolean(),
  supports_streaming: boolean(),
  implemented_tool_names: [String.t()],
  reference_tool_names: [String.t()],
  instruction_files: [String.t()],
  reasoning_option_path: [String.t()],
  system_prompt_style: String.t(),
  event_kinds: [AttractorEx.Agent.Event.kind()]
}

t()

@type t() :: %AttractorEx.Agent.ProviderProfile{
  context_window_size: pos_integer() | nil,
  id: String.t(),
  model: String.t(),
  preset: atom() | nil,
  provider_family: atom(),
  provider_options: map(),
  supports_parallel_tool_calls: boolean(),
  supports_reasoning: boolean(),
  supports_streaming: boolean(),
  system_prompt_builder: (keyword() -> String.t()) | nil,
  tool_registry: AttractorEx.Agent.ToolRegistry.t(),
  tools: [AttractorEx.Agent.Tool.t()]
}

Functions

anthropic(opts \\ [])

@spec anthropic(keyword()) :: t()

build_system_prompt(profile, context)

@spec build_system_prompt(
  t(),
  keyword()
) :: String.t()

Builds the system prompt for a session request.

gemini(opts \\ [])

@spec gemini(keyword()) :: t()

instruction_files(provider_profile)

@spec instruction_files(t()) :: [String.t()]

Returns the project-instruction files relevant to the active provider profile.

integration_matrix()

@spec integration_matrix() :: [integration_entry()]

Returns the maintained cross-provider integration matrix for built-in presets.

new(opts)

@spec new(keyword()) :: t()

Builds a provider profile from keyword options.

openai(opts \\ [])

@spec openai(keyword()) :: t()

reasoning_option_path(provider_profile)

@spec reasoning_option_path(t()) :: [String.t()]

Returns the provider-native request path associated with reasoning/thinking controls.

reference_tool_names(profile)

@spec reference_tool_names(t()) :: [String.t()]

Returns the upstream native tool names the preset is intended to align with.

register_tool(profile, tool)

@spec register_tool(t(), AttractorEx.Agent.Tool.t()) :: t()

Registers or replaces a tool on top of an existing profile.

register_tools(profile, tools)

@spec register_tools(t(), [AttractorEx.Agent.Tool.t()]) :: t()

Registers or replaces tools on top of an existing profile, preserving order.

system_prompt_style(provider_profile)

@spec system_prompt_style(t()) :: String.t()

Returns the reference-agent prompt family used as the preset target.

tool_definitions(profile)

@spec tool_definitions(t()) :: [map()]

Returns the serialized tool definitions exposed to the model.