@type api_key_auth() :: %{
  type: String.t(),
  api_key: String.t(),
  location: String.t(),
  var_name: String.t()
}

@type auth() :: %{type: String.t(), __struct__: module()}

@type basic_auth() :: %{type: String.t(), username: String.t(), password: String.t()}

@type call_result() :: {:ok, any()} | {:error, any()}

@type cli_provider() :: %{
  name: String.t(),
  type: :cli,
  command_name: String.t(),
  working_dir: String.t() | nil,
  env_vars: %{required(String.t()) => String.t()}
}

@type client_config() :: %{
  variables: %{required(String.t()) => String.t()},
  providers_file_path: String.t() | nil,
  load_variables_from: [module()]
}

@type deregister_result() :: :ok | {:error, any()}

@type graphql_provider() :: %{
  name: String.t(),
  type: :graphql,
  url: String.t(),
  auth: auth() | nil,
  headers: %{required(String.t()) => String.t()}
}

@type grpc_provider() :: %{
  name: String.t(),
  type: :grpc,
  host: String.t(),
  port: integer(),
  service_name: String.t(),
  method_name: String.t(),
  target: String.t() | nil,
  use_ssl: boolean(),
  auth: auth() | nil
}

@type http_provider() :: %{
  name: String.t(),
  type: :http,
  http_method: String.t(),
  url: String.t(),
  content_type: String.t(),
  auth: auth() | nil,
  headers: %{required(String.t()) => String.t()},
  body_field: String.t() | nil,
  header_fields: [String.t()]
}

@type manual() :: %{name: String.t(), description: String.t(), tools: [tool()]}

@type mcp_provider() :: %{
  name: String.t(),
  type: :mcp,
  url: String.t(),
  auth: auth() | nil
}

@type oauth2_auth() :: %{
  type: String.t(),
  client_id: String.t(),
  client_secret: String.t(),
  token_url: String.t(),
  scope: String.t()
}

@type provider() :: %{name: String.t(), type: provider_type(), __struct__: module()}

@type provider_type() ::
  :http
  | :sse
  | :http_stream
  | :cli
  | :websocket
  | :grpc
  | :graphql
  | :tcp
  | :udp
  | :webrtc
  | :mcp
  | :text

@type register_result() :: {:ok, [tool()]} | {:error, any()}

@type search_result() :: {:ok, [tool()]} | {:error, any()}

@type sse_provider() :: %{
  name: String.t(),
  type: :sse,
  url: String.t(),
  auth: auth() | nil,
  headers: %{required(String.t()) => String.t()}
}

@type stream_call_result() :: {:ok, stream_result()} | {:error, any()}

@type stream_chunk() :: %{
  data: any(),
  metadata: %{required(String.t()) => any()} | nil,
  timestamp: integer() | nil,
  sequence: integer() | nil
}

@type stream_end() :: %{type: :end, metadata: %{required(String.t()) => any()} | nil}

@type stream_error() :: %{
  type: :error,
  error: String.t(),
  code: integer() | nil,
  metadata: %{required(String.t()) => any()} | nil
}

@type stream_event() :: stream_chunk() | stream_error() | stream_end()

@type stream_result() :: %{
  type: :stream,
  data: [stream_chunk()] | Enumerable.t(),
  metadata: %{required(String.t()) => any()} | nil
}

@type streamable_http_provider() :: %{
  name: String.t(),
  type: :http_stream,
  url: String.t(),
  auth: auth() | nil,
  headers: %{required(String.t()) => String.t()}
}

@type tcp_provider() :: %{
  name: String.t(),
  type: :tcp,
  protocol: :tcp,
  host: String.t(),
  port: integer(),
  timeout: integer(),
  auth: auth() | nil
}

@type text_provider() :: %{name: String.t(), type: :text, file_path: String.t()}

@type tool() :: %{
  name: String.t(),
  description: String.t(),
  inputs: tool_input_output_schema(),
  outputs: tool_input_output_schema(),
  tags: [String.t()],
  average_response_size: integer() | nil,
  provider: provider()
}

@type tool_input_output_schema() :: %{
  type: String.t(),
  properties: %{required(String.t()) => any()},
  required: [String.t()],
  description: String.t(),
  title: String.t(),
  items: %{required(String.t()) => any()},
  enum: [any()],
  minimum: float() | nil,
  maximum: float() | nil,
  format: String.t()
}

@type tool_repository() :: %{
  tools: %{required(String.t()) => [tool()]},
  providers: %{required(String.t()) => provider()}
}

@type transport() :: module()

@type udp_provider() :: %{
  name: String.t(),
  type: :udp,
  protocol: :udp,
  host: String.t(),
  port: integer(),
  timeout: integer(),
  auth: auth() | nil
}

@type variable_not_found() :: %{__exception__: true, variable_name: String.t()}

@type webrtc_provider() :: %{
  name: String.t(),
  type: :webrtc,
  url: String.t(),
  auth: auth() | nil
}

@type websocket_provider() :: %{
  name: String.t(),
  type: :websocket,
  url: String.t(),
  protocol: String.t() | nil,
  keep_alive: boolean(),
  auth: auth() | nil,
  headers: %{required(String.t()) => String.t()},
  header_fields: [String.t()]
}