@spec add_req_http_options(
  keyword(),
  list() | nil
) :: keyword()

Adds req_http_options option to a keyword list if options are specified.

@spec add_timeout_opt(
  keyword(),
  integer() | nil
) :: keyword()

Adds timeout option to a keyword list if timeout is specified.

@spec add_tools_opt(
  keyword(),
  list()
) :: keyword()

Adds tools option to a keyword list if tools are specified.

@spec build_directive_messages(term(), String.t() | nil) :: list()

Builds messages for LLM calls from context and optional system prompt.

@spec classify_error(term()) :: atom()

Classifies an error into a runtime category.

Returns one of: :rate_limit, :auth, :timeout, :provider_error, :network, :validation, :unknown.

Gets the task supervisor from agent state.

First checks the TaskSupervisorSkill's internal state (__task_supervisor_skill__), then falls back to the top-level :task_supervisor field for standalone usage.

Examples

iex> state = %{__task_supervisor_skill__: %{supervisor: supervisor_pid}}
iex> Jido.AI.Directive.Helpers.get_task_supervisor(state)
supervisor_pid

iex> state = %{task_supervisor: supervisor_pid}
iex> Jido.AI.Directive.Helpers.get_task_supervisor(state)
supervisor_pid

@spec resolve_directive_model(map()) :: String.t()

Resolves a model from directive fields.

Supports both direct model specification and model alias resolution.