Added #

• Example: Created a standard example/example.dart and example/README.md for better package presentation.
• Enhanced Intelligence: Finalized persistence for tool_calls and tool_results in VanturaMemory, enabling consistent multi-turn reasoning.

Changed #

• Security & Privacy Hardening:
  • Implemented recursive redaction of sensitive keys (API keys, Authorization tokens) in logs.
  • Added VanturaLoggerOptions to disable logging of sensitive content (prompts/responses) by default.
  • Added VanturaLogLevel to filter SDK logs.
  • Hardened ApiTestTool with hostname blacklisting (SSRF protection) and strict output truncation.
  • Added SDK-level guardrails to prevent instruction overriding and prompt injection.
• Robustness:
  • Added execution timeouts to VanturaTool (default 30s) to prevent agent hangs.
  • Implemented robust JSON extraction to handle LLM conversational filler and markdown blocks.
  • Added finishReason to VanturaResponse for better observability.
• Dependency Updates: Modernized constraints for connectivity_plus (v7) and device_info_plus (v12).
• Documentation: SIGNIFICANT improvements to API documentation (dartdoc) and a completely rewritten high-end README guide.
• Project Structure: Moved repository marketing assets to root and cleaned up .pubignore.

Changed #

• Documentation Upgrade: Completely rewritten "marketing-first" README with premium visuals, use-cases, and comparison tables.
• Package Polishing: Standardized LICENSE to BSD 3-Clause and added .pubignore for a leaner package size.
• Bug Fixes: Regenerated test mocks to ensure internal test suite compatibility.

Added #

• Core Agent Loop: VanturaAgent with ReAct-style reasoning (up to 10 iterations), supporting both run() (blocking) and runStreaming() (SSE token-by-token).
• HTTP Client: VanturaClient with connection pooling, 3-retry exponential backoff, and automatic HTTP 429 rate-limit handling.
• Memory System: VanturaMemory with 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 via SchemaHelper, and human-in-the-loop confirmation support.
• Built-in Tools: CalculatorTool, NetworkConnectivityTool, DeviceInfoTool, ApiTestTool.
• Multi-Agent Coordination: AgentCoordinator class for routing conversations between specialist agents with automatic transfer_to_agent tool injection.
• Request Cancellation: CancellationToken for aborting generation mid-request at both the HTTP and reasoning-loop levels.
• Token Usage Tracking: TokenUsage object returned in VanturaResponse with promptTokens, completionTokens, and totalTokens.
• Error Callbacks: onToolError, onAgentFailure, and onWarning hooks on VanturaAgent for structured error reporting and telemetry.
• UI State Management: VanturaState (ChangeNotifier) for syncing agent status (isRunning, currentStep, errorMessage) with Flutter UI.
• Markdown Renderer: Zero-dependency MarkdownText Flutter widget supporting headers, bold, italic, inline code, bullet lists, and horizontal rules.
• Logger Interface: Abstract VanturaLogger with a default SimpleVanturaLogger (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.).