Changelog

​

v0.71.0

​

New Features:

• Culture and CultureManager: Added a new Culture system that allows defining agent behavior and communication guidelines through user descriptions, with CultureManager automatically extracting structured guidelines (tone of speech, topics to avoid/help with, attention points) using LLM extraction and formatting them for system prompt injection.

​

Improvements:

• Makefile for Smoke Tests: Created Makefile to streamline smoke testing processes with automated docker-compose integration, health checks, and better test execution workflows.
• README Documentation: Refactored README to follow open-source standards, improving project documentation quality and accessibility for new contributors and users.
• Interface Testing: Enhanced testing coverage for interface components (WhatsApp, Slack, Gmail) to ensure better reliability and stability of communication platform integrations.

​

Bug Fixes:

• Fixed metrics not being set using Direct class.

​

Pull Requests:

• Cultural Knowledge: DoganK01 in #506
• refactor: Makefile for smoke tests: DoganK01 in #505
• docs: refactor README to follow open-source standards: IremOztimur in #507
• Interface testing: DoganK01 in #508
• chore: version 0.71.0: DoganK01 in #510

​

v0.70.0

​

New Features:

• Agent Run Implementation: Introduced “Agent Run” architecture with AgentRunInput and AgentRunOutput dataclasses, providing type safety, clear contracts, and a single source of truth for agent execution state.
• Memory Modes for UEL: Added user_memory_mode parameter with ‘update’ and ‘replace’ options to solve conflicts between placeholder history and model history.
• AgentSession Class: New session management class for storing agent-related information across multiple runs with proper lifecycle management.
• Parallel Tool Call Support: Added support for parallel tool calls when external tool execution is enabled, improving throughput for multi-tool operations.
• Agent Metadata Attribute: New metadata attribute in Agent class that enables users to inject any metadata directly into the prompt.
• Dynamic Search Tool for KnowledgeBase: Introduced dynamic search tool when KnowledgeBase is used as a tool (RAG as tool functionality).
• MCP Tool Name Prefix: Added tool name prefix support for MCP tools, allowing different function tools with the same name to be used for different purposes.
• RunRequirement Class: New class for managing Human-in-the-Loop (HITL) requirements with clear distinction between confirmation, user input, and external execution needs.
• Run Cancellation Manager: Thread-safe cancellation management with proper lifecycle methods (register_run, cancel_run, cleanup_run).
• External Tool Callable Support: For one-tool-at-a-time calls with external tool execution, callable is provided as argument for background handling.
• Debug Level 2: Enhanced debugging capabilities with additional logging and visibility.

​

Improvements:

• Context Managers Refactored: Converted context managers to regular classes to align with the step-based architecture in Agent flow.
• HITL Logic Refactored: Human-in-the-Loop logics are now managed by the RunRequirement class with improved and cleaner usage patterns.
• Streaming Logic Refactored: Removed unnecessary and confusing stream methods in Agent class, consolidating streaming functionality.
• Storage Providers Refactored: Comprehensive storage system overhaul with abstract Storage base class and support for multiple backends (In-Memory, JSON, SQLite, Redis, PostgreSQL, MongoDB, Mem0).
• Improved Event System: Enhanced event streaming architecture with comprehensive event types for better observability.
• Test Organization: Reorganized tests by moving smoke tests from unit_tests directory into dedicated smoke_tests directory for clearer separation.
• AgentRunContext Removal: Removed AgentRunContext class and made everything dependent on AgentRunOutput for simplified state management.

​

Bug Fixes:

• Fixed System Prompt Setup: Resolved issue where system prompt was not being set up correctly in certain scenarios.
• Fixed Test Compatibility: Addressed test compatibility issues across different Python versions.
• Fixed Notebook Issues: Resolved issues with Jupyter notebook examples.

​

Pull Requests:

• Agent Run Implementation: DoganK01 in #504

​

v0.69.1

​

New Features:

• Model ID Normalization: Allows simplified model IDs (e.g., bedrock/claude-3-5-sonnet:v2) to be automatically normalized to full provider IDs.

​

Improvements:

• Structured Output Mode: Changed output_mode from “native” to “auto” for better cross-model compatibility.
• Output Tools Support: Added tool-based structured output for models that don’t support native JSON schemas (like Bedrock).

​

Bug Fixes:

• Fixed Structured Output for Bedrock: Resolved UserError: Native structured output is not supported by this model when using Pydantic response formats with Bedrock models.

​

Pull Requests:

• fix: fix normalizing model ids: DoganK01 in #498

​

v0.69.0

​

New Features:

• Event-Based Streaming System: Introduced an event-based streaming architecture with 30+ event types providing granular visibility into agent execution, including PipelineEvents, StepEvents, and LLM Stream Events with proper timestamp tracking and type-safe event handling.
• Profanity Safety Policy: Added profanity detection capabilities using Detoxify ML library with support for 5 different models (original, unbiased, multilingual variants) with configurable sensitivity thresholds and proper lazy loading for optimal performance.
• Policy Feedback Loop: Implemented user and agent policy feedback mechanisms that provide constructive feedback instead of hard blocking, allowing policies to guide users and agents with helpful messages and configurable retry counts to prevent wasted agent cycles.
• CLI Remove Command: Added new “remove” command for removing packages from upsonic_configs.json, providing better package management capabilities in the CLI interface.
• Azure and Grok Model Providers: Added support for Azure and Grok model providers, expanding the framework’s model compatibility and integration options.
• ismethod Support for Tool Management: Added support for handling methods in tool management, enabling more flexible tool registration and usage patterns.

​

Improvements:

• Runtime Performance Optimization: Enhanced runtime performance through lazy importing to reduce initial load times and improve overall framework responsiveness.
• Memory Logging: Added informative logging for Memory operations to improve debugging and monitoring capabilities during agent execution.
• DeepAgent TODO Printing: Enhanced DeepAgent with TODO printing functionality to provide better visibility into planning and execution steps.
• CLI Configuration Management: Refactored CLI initialization to use upsonic_configs.json for all configurations, removing io.py dependency and improving maintainability and performance.

​

Bug Fixes:

• LLMLingua Prompt Compression API Fix: Resolved issues with the LLMLingua prompt compression API integration to ensure proper prompt compression functionality.
• Milvus Import Error Handling: Fixed unnecessary import error for Milvus by moving error management to init to prevent import failures when Milvus is not installed.
• Bedrock Model Profile Creation: Fixed Bedrock provider model profile creation to ensure proper initialization and configuration of AWS Bedrock models.

​

Pull Requests:

• feat: version 0.69.0: @DoganK01 in #497

​

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