Gemini.Types.ToolSerialization (GeminiEx v0.7.2)

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 ADM FunctionDeclaration structs 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([Altar.ADM.FunctionDeclaration.t()]) :: api_tool_list()

Convert a list of ADM FunctionDeclaration structs into a Gemini API tools list.

Output shape (each entry): %{ "functionDeclarations" => [

%{
  "name" => String.t(),
  "description" => String.t(),
  "parameters" => map() # OpenAPI-like schema map, passed through as-is
}

] }