Spectre.Action.Planner behaviour (Spectre v0.3.0)

Port implemented by optional action-planning libraries.

A planner may inspect an LLM reply and return provider-neutral Spectre.Action values. It cannot execute providers or mutate Agent state.

Summary

response()

@type response() :: %{reply_text: String.t(), actions: [Spectre.Action.t() | map()]}

(optional)

@callback clean_reply(String.t(), Spectre.Context.t() | map(), keyword()) :: String.t()

(optional)

@callback plan(String.t(), Spectre.Context.t() | map(), keyword()) ::
  {:ok, Spectre.Action.t() | map()} | {:error, term()}

@callback plan_response(String.t(), Spectre.Context.t() | map(), keyword()) ::
  {:ok, response()} | {:error, term()}