vantura 0.1.0
vantura: ^0.1.0 copied to clipboard
An AI Agentic Framework for Flutter. Build LLM-powered agents that reason, use tools, remember conversations, and stream responses in real-time. Works with any OpenAI-compatible API.
Changelog #
All notable changes to the Vantura SDK will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
0.1.0 - 2026-02-22 #
Added #
- Core Agent Loop:
VanturaAgentwith ReAct-style reasoning (up to 10 iterations), supporting bothrun()(blocking) andrunStreaming()(SSE token-by-token). - HTTP Client:
VanturaClientwith connection pooling, 3-retry exponential backoff, and automatic HTTP 429 rate-limit handling. - Memory System:
VanturaMemorywith short-term (recent messages) and long-term (LLM-summarized) memory, plus automatic pruning. - Persistence Interface: Abstract
VanturaPersistence— plug in any storage backend (SQLite, Hive, Firestore, etc.) without SDK modification. - Tool Framework: Generic
VanturaTool<T>base class with type-safe argument parsing, JSON Schema definitions viaSchemaHelper, and human-in-the-loop confirmation support. - Built-in Tools:
CalculatorTool,NetworkConnectivityTool,DeviceInfoTool,ApiTestTool. - Multi-Agent Coordination:
AgentCoordinatorclass for routing conversations between specialist agents with automatictransfer_to_agenttool injection. - Request Cancellation:
CancellationTokenfor aborting generation mid-request at both the HTTP and reasoning-loop levels. - Token Usage Tracking:
TokenUsageobject returned inVanturaResponsewithpromptTokens,completionTokens, andtotalTokens. - Error Callbacks:
onToolError,onAgentFailure, andonWarninghooks onVanturaAgentfor structured error reporting and telemetry. - UI State Management:
VanturaState(ChangeNotifier) for syncing agent status (isRunning,currentStep,errorMessage) with Flutter UI. - Markdown Renderer: Zero-dependency
MarkdownTextFlutter widget supporting headers, bold, italic, inline code, bullet lists, and horizontal rules. - Logger Interface: Abstract
VanturaLoggerwith a defaultSimpleVanturaLogger(colored console output).
Notes #
- First public release as an extracted, standalone Flutter package.
- Compatible with any OpenAI-compatible API provider (Groq, OpenAI, Ollama, Together AI, etc.).