@spec __default_plugins__() :: [module() | {module(), map()}]

Returns the default plugins for agents bound to this Jido instance.

@spec __jido_storage__() :: {module(), keyword()}

Returns the storage configuration for this Jido instance.

@spec agent_count(keyword()) :: non_neg_integer()

Returns the count of running agents under this Jido instance.

@spec agent_supervisor_name() :: atom()

Returns the AgentSupervisor name for this Jido instance.

@spec config(keyword()) :: keyword()

Returns the runtime config for this Jido instance.

Configuration is loaded from config :vibe, Vibe.Agent.Jido and overridden by any runtime options passed in.

@spec debug() :: Jido.Debug.level()

Controls debug mode for this Jido instance.

• debug() — returns current debug level
• debug(:on) — enable developer-friendly verbosity
• debug(:verbose) — enable maximum detail
• debug(:off) — disable debug overrides
• debug(pid) — toggle per-agent debug mode
• debug(:on, redact: false) — also disable redaction

@spec debug_status() :: map()

Returns the current debug status for this instance.

@spec hibernate(
  Jido.Agent.t(),
  keyword()
) :: :ok | {:error, term()}

Hibernate an agent to storage.

@spec list_agents(keyword()) :: [{String.t(), pid()}]

Lists all agents under this Jido instance.

@spec recent(pid(), non_neg_integer()) :: {:ok, [map()]} | {:error, term()}

Returns recent debug events from an agent's ring buffer.

@spec registry_name() :: atom()

Returns the Registry name for this Jido instance.

@spec runtime_store_name() :: atom()

Returns the RuntimeStore name for this Jido instance.

@spec start_agent(
  module() | struct(),
  keyword()
) :: DynamicSupervisor.on_start_child()

Starts an agent under this Jido instance.

@spec stop_agent(
  pid() | String.t(),
  keyword()
) :: :ok | {:error, :not_found}

Stops an agent (by pid or id) under this Jido instance.

@spec task_supervisor_name() :: atom()

Returns the TaskSupervisor name for this Jido instance.

@spec thaw(module(), term(), keyword()) :: {:ok, Jido.Agent.t()} | {:error, term()}

Thaw an agent from storage.

@spec whereis(
  String.t(),
  keyword()
) :: pid() | nil

Looks up an agent by ID under this Jido instance.