Behaviour for coding agent provider modules.

Each provider knows how to read the data directory of a specific coding agent (Claude Code, Codex, Gemini CLI, etc.) and extract learnable events from it.

Providers receive a config map containing at minimum %{data_paths: [String.t()]}. When no config is supplied, providers fall back to their default_data_paths/0.

Implementing a new provider

defmodule Recollect.Learner.CodingAgent.MyAgent do
  @behaviour Recollect.Learner.CodingAgent.Provider

  @impl true
  def agent_name, do: :my_agent

  @impl true
  def default_data_paths, do: ["~/.my_agent"]

  @impl true
  def available?(config) do
    resolve_paths(config)
    |> Enum.any?(fn p -> File.dir?(Path.expand(p)) end)
  end

  @impl true
  def fetch_events(config), do: fetch_events(config, [])

  @impl true
  def fetch_events(config, _opts) do
    base = hd(resolve_paths(config)) |> Path.expand()
    # Read data dirs, return list of event maps
  end

  @impl true
  def extract(event) do
    # Convert event into an extract map
  end

  defp resolve_paths(%{data_paths: [_ | _] = paths}), do: paths
  defp resolve_paths(_), do: default_data_paths()
end