Pipeline.Providers.AIProvider behaviour (pipeline v0.0.1)

Behavior for AI service providers (Claude, Gemini, etc.)

This interface allows swapping between live and mock implementations for testing and development.

Summary

error_reason()

options()

prompt()

response()

Query the AI service with a prompt and options.

get_provider()

Get the provider implementation based on configuration.

@type error_reason() :: String.t()

@type options() :: map()

@type prompt() :: String.t()

@type response() :: %{text: String.t(), success: boolean(), cost: float()}

@callback query(prompt(), options()) :: {:ok, response()} | {:error, error_reason()}

Query the AI service with a prompt and options.

Returns either a successful response with text, success status and cost, or an error with a reason string.

Get the provider implementation based on configuration.