Gemini.Types.ToolSerialization (GeminiEx v0.10.0)

Copy Markdown View Source

Pure data transformation utilities to serialize ALTAR ADM tool structures into the exact JSON maps expected by the Gemini API.

  • Converts snake_case atom keys to camelCase string keys
  • Shapes FunctionDeclaration into the correct Tool list payload
  • Shapes ToolConfig into %{functionCallingConfig: %{...}}

Summary

Types

api_tool()
api_tool_config()
api_tool_list()

Functions

to_api_tool_config(tool_config)

Convert ADM ToolConfig into Gemini API toolConfig map.

to_api_tool_list(declarations)

Convert a list of tools into a Gemini API tools list.

Types

api_tool()

@type api_tool() :: map()

api_tool_config()

@type api_tool_config() :: map()

api_tool_list()

@type api_tool_list() :: [api_tool()]

Functions

to_api_tool_config(tool_config)

@spec to_api_tool_config(Altar.ADM.ToolConfig.t()) :: api_tool_config()

Convert ADM ToolConfig into Gemini API toolConfig map.

Input: %ToolConfig{mode: :auto | :any | :none, function_names: ["..."]}

Output: %{ functionCallingConfig: %{

mode: "AUTO" | "ANY" | "NONE",
allowedFunctionNames: ["..."] # present only when non-empty

} }

to_api_tool_list(declarations)

@spec to_api_tool_list(list()) :: api_tool_list()

Convert a list of tools into a Gemini API tools list.

Supports:

  • ADM FunctionDeclaration structs
  • Built-in tools (googleSearch, urlContext, codeExecution)
  • Atom shorthand for built-ins (:google_search, :url_context, :code_execution)