flutter_ai_tools 0.1.0

Provider-neutral tool calling for flutter_ai: declare tools with executors, run tool calls into results, and expose web search as a tool — all in pure Dart with no Flutter dependency.

flutter_ai_tools

Provider-neutral tool calling for the flutter_ai family. Pure Dart, no Flutter dependency.

What it does

• ToolSpec — declare a tool (name, description, JSON-Schema parameters) and an optional client-side executor.
• ToolRegistry — collect tools, hand their definitions to a provider, and run a ToolCallPart into a ToolResultPart. Unknown tools and thrown executors become error results, never crashes.
• Web search — webSearchTool(adapter) turns any WebSearchAdapter (Tavily, Brave, SerpAPI, custom) into a callable tool returning SearchResults.

Usage

final tools = ToolRegistry([
  ToolSpec(
    name: 'get_weather',
    description: 'Get the weather for a city',
    parametersSchema: const {
      'type': 'object',
      'properties': {'city': {'type': 'string'}},
      'required': ['city'],
    },
    execute: (args) => weatherApi.fetch(args['city']! as String),
  ),
]);

// Advertise to a provider:
controller.setTools(tools.definitions);

// Fulfill a call the model made:
final result = await tools.run(toolCallPart); // -> ToolResultPart

Web search

final tools = ToolRegistry([webSearchTool(MyTavilyAdapter())]);

class MyTavilyAdapter implements WebSearchAdapter {
  @override
  Future<List<SearchResult>> search(String query, {int? maxResults}) async {
    // call your search backend, map hits into SearchResult
  }
}

Status

0.1.0. Published on pub.dev; depends on flutter_ai_core. See example/.