Changelog

​

v0.68.2 & v0.68.3

​

New Features:

• DeepSeek OCR Provider: Added new OCR provider using Ollama’s deepseek-ocr:3b model for image text extraction with customizable host, model, and prompt support
• New Model Support: Expanded model compatibility with additional model integrations for enhanced AI capabilities

​

Improvements:

• Smoke Tests & Refactoring: Added comprehensive smoke tests and refactored codebase for improved reliability and maintainability
• Image Output Utilities: Added utility functions for enhanced image output processing and handling capabilities

​

Bug Fixes:

• Bedrock Profile Creation: Fixed AWS Bedrock API profile creation issue that prevented proper inference profile setup and model initialization

​

Pull Requests:

• feat: Added deepseek-ocr with ollama: @onuratakan in #491
• refactor: new smoke tests and bug fix: @DoganK01 in #492
• New models: @DoganK01 in #493
• chore: image output utils: @DoganK01 in #494
• fix: bedroc profile creation fix: @DoganK01 in #495

​

v0.68.1

​

New Features:

​

Improvements:

​

Bug Fixes:

• Fixed Knowledge Base Search Tool Docstring: Corrected the docstring for the search tool from knowledge base to ensure accurate documentation.
• Fixed MCP Closing Logic: Added proper closing logic for MCP (Model Context Protocol) connections to prevent resource leaks.

​

Pull Requests:

• fix docstring of search tool from knowledgebase, add mcp closing logic: @DoganK01 in #489
• version 0.68.1: @DoganK01 in #490

​

v0.68.0

​

New Features:

• Dynamic Tool Management via Agent Class: Added add_tools() and remove_tools() methods to the Agent class and Task class, enabling runtime tool configuration and dynamic tool lifecycle management.
• KnowledgeBase as Tool (RAG as Tool): KnowledgeBase can now be injected as a tool, allowing RAG capabilities to be seamlessly integrated into agent workflows through the tool system.
• Gmail Integration Interface: New Gmail tools and interface with OAuth 2.0 authentication support, enabling agents to send and manage emails through Gmail API.
• WhatsApp Integration Interface: New WhatsApp tools and interface for sending messages and managing WhatsApp communications programmatically.
• Slack Integration Interface: New Slack tools and interface for interacting with Slack workspaces, channels, and messages.
• Tool Safety Policy Framework: Introduced ToolPolicyManager with pre-execution and post-execution validation capabilities, providing robust security layers for tool registration and invocation.
• String Task Auto-Conversion: Agents now support string task descriptions that are automatically converted to Task objects, simplifying the API with agent.do("task description") and agent.do_async("task description") syntax.

​

Improvements:

• DeepAgent Architecture Refactoring: Complete refactoring of DeepAgent from monolithic structure to modular architecture with clear separation of concerns, including new backend abstractions (BackendProtocol, StateBackend, MemoryBackend) and toolkit-based design.
• Centralized Tool Handling: Tool management has been centralized and streamlined, removing unnecessary complexity and providing better organization through the improved ToolManager system.
• Import Error Handling: Added comprehensive import_error() helper function across 73 files to provide better user experience and clearer error messages when optional dependencies are missing.
• Tool Deduplication: Enhanced tool registration system with smart deduplication logic to prevent duplicate tool registrations and improve tool lifecycle management.
• Async Tool Validation: Improved async/await patterns in tool policy validation.

​

Bug Fixes:

• Groq Client Import Fix: Fixed import issues with Groq client to ensure proper module loading and error handling.
• Test Suite Fixes: Fixed various unit tests to align with the refactored architecture and new tool management system.
• Conftest Configuration Fix: Resolved configuration issues in test setup files to ensure proper test execution.
• Tool Registration Edge Cases: Fixed issues with tool registration duplication and improved handling of edge cases in the tool management system.

​

Pull Requests:

• New features: @DoganK01 in #488

​

v0.67.4

​

New Features:

​

Improvements:

​

Bug Fixes:

• Fixed Run Command Import Functionality: The run command was not properly importing other files from the same directory or project structure. This has been fixed by correctly setting up sys.path, package, and name attributes to ensure proper module resolution and relative imports work correctly when executing agents.

​

Pull Requests:

• fix: fix run command not importing other files: @DoganK01 in #486
• chor: new version 0.67.4: @DoganK01 in #487

​

v0.67.3

​

New Features:

​

Improvements:

• Import Error Handling: Added comprehensive error logging for import errors and fixed circular import issues to improve code reliability and debugging capabilities.

​

Bug Fixes:

• Circular Import Fix: Resolved circular import dependencies that were causing import errors in the codebase.

​

Pull Requests:

• refactor: import error log adding and circular import fix: @DoganK01 in #484

​

v0.67.2

​

New Features:

• CLI Update for AgentOS Compatibility: Updated CLI structure to align with AgentOS standards, including improved project structure with src/ directory, consistent naming conventions, and enhanced configuration management.

​

Improvements:

• Comprehensive Unit Tests for Team Feature: Added extensive unit test coverage for the team/multi-agent functionality, including tests for context sharing, coordinator setup, delegation management, result combining, task assignment, and team execution modes.
• MCP Tool Handling Class Refactor: Refactored MCP tool handling architecture with better separation of concerns, transitioning from direct session management to a cleaner composition-based design where MultiMCPHandler delegates to individual MCPHandler instances, improving code maintainability and introspection capabilities.
• Unit Tests for Graph Feature: Added comprehensive unit tests for the graph feature, ensuring better code quality and reliability.
• Unit Tests for Tools Feature: Added comprehensive unit tests for the tools system, improving test coverage and ensuring robust tool functionality.

​

Bug Fixes:

• Fixed YFinanceTools Import and Notebook Cells: Corrected incorrect YFinanceTools import and updated notebook cells to ensure proper functionality of financial data tools.

​

Pull Requests:

• unit tests added for team feature: @sxroads in #478
• refactor: mcp tool handling class refactor: @DoganK01 in #481
• unit tests added for the graph feature: @sxroads in #477
• tests : unit tests added for the tools feauture: @sxroads in #476
• fix: correct YFinanceTools import and update notebook cells: @IremOztimur in #473
• cli update for agentos: @DoganK01 in #482

​

v0.67.1

​

New Features:

• Image Output Support: Added comprehensive image output support for agent responses, enabling agents to generate and return images through the Agent and Whatsapp interfaces. Supports multiple image outputs with proper base64 encoding/decoding and media upload handling.
• Interface support: Added Whatsapp interface support enabling users to communicate with Agents through Whatsapp.

​

Improvements:

• Interfaces System Enhancement: Improved WebSocket authentication flow with message-based action handling, better connection management, and cleaner API design. Added support for action-based messages (authenticate, ping, message) with structured event responses and enhanced error handling.

​

Bug Fixes:

• No bug fixes in this release.

​

Pull Requests:

• Interfaces: @DoganK01 in #479
• refactor: image output support adding and general refactor: @DoganK01 in #474
• chore: v0.67.1: @DoganK01 in #480

​

v0.67.0

​

New Features:

• CLI Support: Added comprehensive command-line interface support for Upsonic, enabling users to interact with the framework directly from the terminal with intuitive commands and workflows.

​

Improvements:

• VectorDB v2 Refactoring: Complete architectural overhaul of the vector database system with improved async-first design, enhanced provider abstraction, and better performance optimization for vector operations across all supported providers.
• Dependency Management: Removed the ‘run’ optional dependency group to streamline package installation and reduce unnecessary dependencies, making the framework more lightweight and easier to install.

​

Bug Fixes:

• Unit Tests: Fixed various unit test issues and improved test reliability to ensure better code quality and framework stability across different environments and configurations.

​

Pull Requests:

• refactor: vectordb v2: @DoganK01 in #467
• feat: CLI support for upsonic: @DoganK01 in #468
• fix of unit tests commit: @sxroads in #469
• refactor: remove ‘run’ optional dependency group: @DoganK01 in #471
• feat: 0.67.0 release: @DoganK01 in #472

​

v0.66.1

​

Improvements:

• Ollama Model Configuration: Enhanced Ollama provider integration by enabling “model as string” support, allowing simplified string-based model configuration instead of requiring model class instantiation. Users can now specify Ollama models using the convenient "ollama/model-name" string format, making it easier to switch between models and configure them via environment variables.

​

Bug Fixes:

• Model Configuration: Improved model initialization flow for Ollama provider to ensure proper string-based model handling and compatibility with existing Upsonic model interfaces.

​

Pull Requests:

• Model as string ollama: @onuratakan in #463

​

v0.66.0

​

New Features:

• Expression Language: Introduced Upsonic Expression Language (UEL) enabling declarative chain composition with pipe operators, runnables, and dynamic workflow construction for building sophisticated AI agent pipelines.
• State Graph and Recursive Tool Handling for Streaming: Added recursive tool handling capabilities for streaming in Agent class and StateGraph logic.

​

Improvements:

• MCP Smoke Test Coverage: Added comprehensive smoke tests for Model Context Protocol (MCP) integration to ensure reliable MCP server connections and tool discovery functionality.

​

Bug Fixes:

• External Tool Execution: Fixed issues with external tool execution handling that prevented proper pausing and resumption of agent workflows when tools require external processing.
• Logging and Memory Error Handling: Resolved logging inconsistencies and added robust error handling for memory operations to prevent framework crashes during memory storage and retrieval operations.
• Documentation Links: Fixed broken links in README documentation to ensure accurate navigation and improve developer experience.

​

Pull Requests:

• Expression Language: @DoganK01 in #453
• smoke test for mcp added: @sxroads in #454
• docs: fix broken links in README: @gokborayilmaz in #456
• feat: state graph, recursive tool handling for streaming logic: @DoganK01 in #455
• External tool fix: @DoganK01 in #457
• fix: logging fix, memory error handling adding: @DoganK01 in #458

​

v0.65.1

​

New Features:

• Centralized Logging System: Introduced a unified logging configuration system that replaces ad-hoc logging instances across the framework, providing consistent logging behavior and centralized control.
• Sentry Integration: Added comprehensive Sentry integration for telemetry and error tracking, enabling better monitoring and debugging of agent executions and pipeline operations.

​

Improvements:

• Improved Logging Configuration: Enhanced logging system with flexible module-level log control, multiple format options, and environment variable-based configuration for better developer experience.
• Pipeline Tracing: Added systematic transaction and span tracking in pipeline manager for improved observability and debugging of agent execution flows.

​

Bug Fixes:

• Fixed Logging Issues: Resolved logging problems and inconsistencies across the framework by implementing a centralized logging system with proper error handling.

​

Pull Requests:

• Redesigned Logging system: @onuratakan in #452