Returns a specification to start this module under a supervisor.

See Supervisor.

@spec disable_plugin(atom()) :: :ok | {:error, term()}

Disables a registered plugin.

@spec dispatch_tool(String.t(), map()) :: term()

Dispatches a single tool call.

@spec dispatch_tools(
  [tuple() | map()],
  keyword()
) :: {:ok, list()}

Dispatches multiple tool calls in parallel for non-destructive tools (:destruction_level == :none). Accepts a list of tool calls: [{"tool1", %{...}}, {"tool2", %{...}}] or [%{name: "tool1", args: %{...}}].

@spec enable_plugin(atom()) :: :ok | {:error, term()}

Enables a registered plugin.

@spec list_plugin_dependencies() :: %{required(atom()) => [atom()]}

Returns dependency mapping for all registered plugins.

@spec list_plugins() :: [map()]

Lists all registered plugins ordered topologically by dependency and priority.

@spec list_running_tools() :: [map()]

Lists currently running tools executing in parallel.

@spec list_tools() :: [map()]

Returns aggregated tool schemas across all active plugins in priority order.

@spec register_plugin(
  module(),
  keyword()
) :: :ok | {:error, term()}

Registers a plugin module dynamically.

@spec start_link(keyword()) :: GenServer.on_start()

Starts the plugin registry GenServer.

@spec unregister_plugin(atom()) :: :ok | {:error, term()}

Unregisters a plugin by its ID.