> ## Documentation Index
> Fetch the complete documentation index at: https://docs.upsonic.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Latest updates and improvements to Upsonic AI Agent Framework

> Product updates, improvements, and bug fixes for Upsonic

<Update label="Apr 22, 2026">
  ## v0.76.3

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.76.3)

  ## Improvements:

  * **AppliedScientist: `current_data` is now optional**. When omitted, the agent reads the current notebook and figures out the data source itself.

  Full Changelog: [https://github.com/Upsonic/Upsonic/compare/v0.76.2...v0.76.3](https://github.com/Upsonic/Upsonic/compare/v0.76.2...v0.76.3)

  ### Pull Requests:

  * feat: current\_data optional, agent infers data source from notebook: [onuratakan](https://github.com/onuratakan) in [#575](https://github.com/Upsonic/Upsonic/pull/575)
</Update>

<Update label="Apr 22, 2026">
  ## v0.76.2

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.76.2)

  ## Improvements:

  * **AppliedScientist: flexible `research_source`**: Accepts anything — local path, URL, git / Kaggle / arXiv / Hugging Face link, or a plain-text idea. The agent-side skill inspects the value, fetches it with whichever tool fits (`cp` / `git clone` / `curl` / `kaggle` CLI / `huggingface-cli` / …), and for text ideas saves the description verbatim to `research_source.md`. No hardcoded scheme sniffing on the Python side.
  * **Auto-derived `inputs`**: `scientist.new_experiment(...)` no longer needs an `inputs=[...]` argument. Any of `research_source`, `current_notebook`, `current_data` that points at an existing local path is auto-copied into the workspace.
  * **`experiments_directory` optional**: now defaults to `./experiments`.

  Full Changelog: [https://github.com/Upsonic/Upsonic/compare/v0.76.1...v0.76.2](https://github.com/Upsonic/Upsonic/compare/v0.76.1...v0.76.2)

  ### Pull Requests:

  * feat: AppliedScientist accepts any research\_source + auto inputs: [onuratakan](https://github.com/onuratakan) in [#571](https://github.com/Upsonic/Upsonic/pull/571)
  * chore: New Version 0.76.2: [onuratakan](https://github.com/onuratakan) in [#572](https://github.com/Upsonic/Upsonic/pull/572)
</Update>

<Update label="Apr 22, 2026">
  ## v0.76.1

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.76.1)

  ## Improvements:

  * **AppliedScientist `research_paper` → `research_source`**: The prebuilt Applied Scientist agent now accepts any reference describing a new method — local file (PDF, Markdown, HTML, `.ipynb`, text), web URL (blog post, arXiv, documentation), git repository URL, or Kaggle notebook / dataset page — not just a PDF. The agent detects the source kind at Phase 0 and materializes it into the experiment folder (as `research.pdf`, `research_source.{ext}`, or `research_source/`) before reading it in Phase 2.
  * **Upsonic/Docs submodule**: Added the public docs repository as a git submodule at `Docs/` so the docs site can be kept in lockstep with code changes.

  Full Changelog: [https://github.com/Upsonic/Upsonic/compare/v0.76.0...v0.76.1](https://github.com/Upsonic/Upsonic/compare/v0.76.0...v0.76.1)

  ### Pull Requests:

  * feat: rename AppliedScientist research\_paper to research\_source: [onuratakan](https://github.com/onuratakan) in [#570](https://github.com/Upsonic/Upsonic/pull/570)
  * chore: New Version 0.76.1: [onuratakan](https://github.com/onuratakan) in [#571](https://github.com/Upsonic/Upsonic/pull/571)
</Update>

<Update label="Apr 21, 2026">
  ## v0.76.0

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.76.0)

  ## New Features:

  * **New Prebuilt Applied Scientist**: Added a new prebuilt Autonomous Agent for automating the testing of new papers on current ML models.

  Full Changelog: [https://github.com/Upsonic/Upsonic/compare/v0.75.0...v0.76.0](https://github.com/Upsonic/Upsonic/compare/v0.75.0...v0.76.0)

  ### Pull Requests:

  * feat: added prebuilt agent, AppliedScientist: [onuratakan](https://github.com/onuratakan) in [#568](https://github.com/Upsonic/Upsonic/pull/568)
  * chore: New Version 0.76.0: [onuratakan](https://github.com/onuratakan) in [#569](https://github.com/Upsonic/Upsonic/pull/569)
</Update>

<Update label="Apr 14, 2026">
  ## v0.75.0

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.75.0)

  ## New Features:

  * KnowledgeBase State Machine: Added `KBState` enum state machine (`UNINITIALIZED → CONNECTED → INDEXED → CLOSED`) replacing boolean flags, with `RuntimeError` guards on invalid states for safer lifecycle management.
  * KnowledgeBase Content Management APIs: New sync + async APIs including `aadd_source`, `aadd_text`, `aremove_document`, `arefresh`, `adelete_by_filter`, and `aupdate_document_metadata` for comprehensive document management.
  * KnowledgeBase Storage Table: Added `KnowledgeRow` dataclass with full CRUD support across all 7 storage providers (SQLite, PostgreSQL, MongoDB, Redis, JSON, InMemory, Mem0) for document tracking and content-hash deduplication.
  * Incremental Change Detection: KnowledgeBase now checks `doc_content_hash` in vectordb to skip unchanged documents and delete stale chunks before re-indexing edited documents.
  * Isolated Search for KnowledgeBase: New `isolate_search` parameter (default `True`) auto-injects `knowledge_base_id` filter, allowing multiple KnowledgeBases to safely share one collection.

  ## Improvements:

  * VectorDB Payload Standardization: Enforced a strict, uniform payload contract across all 6 vector database providers (Qdrant, Milvus, Pgvector, Pinecone, Weaviate, Chroma), making `VectorSearchResult.payload` shape identical regardless of backend.
  * KnowledgeBase Architecture Refactor: Dropped `ToolKit` inheritance in favor of `get_tools()` returning `FunctionTool.from_callable()`, added `build_context()`/`abuild_context()` for system-prompt generation, and auto-derived collection naming.
  * VectorDB `aupsert` Validation: Added strict length validation on all per-item arrays with clear `ValueError` messages, and introduced `knowledge_base_ids` as a dedicated parameter across all 6 providers.

  ## Bug Fixes:

  * Fixed Autonomous Agent Print Default: Set the autonomous agent class `print` attribute to `True` as default so agent output is visible without manual configuration.
  * Fixed MCP Streamable HTTP Client: Resolved issues with the MCP Streamable HTTP client connection handling.
  * Fixed MCP Session Duplication: Fixed a bug where MCP sessions were being duplicated.
  * Fixed Milvus Metadata Leak: `aupdate_metadata` no longer silently reverts user-specified fields to config defaults.
  * Fixed Pgvector Delete Bug: Resolved dotted-path bug in `adelete_by_metadata` and fixed JSONB flattening in `_row_to_payload`.
  * Fixed Qdrant Payload Flattening: Neutered `_flatten_payload` which was actively undoing the standardized payload contract on reads.
  * Fixed VectorDB Standard Fields Drift: Corrected 3 stale hardcoded literals in Milvus and Weaviate that were missing `knowledge_base_id`, causing silent filter failures and missing scalar indexes.

  Full Changelog: [https://github.com/Upsonic/Upsonic/compare/v0.74.4...v0.75.0](https://github.com/Upsonic/Upsonic/compare/v0.74.4...v0.75.0)

  ### Pull Requests:

  * fix: set autonomous agent class print attribute True as default: [DoganK01](https://github.com/DoganK01) in [#565](https://github.com/Upsonic/Upsonic/pull/565)
  * Rag refactors: [DoganK01](https://github.com/DoganK01) in [#566](https://github.com/Upsonic/Upsonic/pull/566)
  * Version 0.75.0: [DoganK01](https://github.com/DoganK01) in [#567](https://github.com/Upsonic/Upsonic/pull/567)
</Update>

<Update label="Apr 2, 2026">
  ## v0.74.4

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.74.4)

  ## New Features:

  * **Mail Interface**: A full-featured SMTP/IMAP-based mail interface that enables agents to send, receive, and process emails with attachment handling, whitelist-based access control, and heartbeat auto-poll. Works with any standard mail provider including Gmail, Outlook, Yahoo, Zoho, and self-hosted servers.

  ## Improvements:

  * **Memory flags separation**: Save and load memory flags have been separated, giving more granular control over agent memory persistence behavior.
  * **VectorDB flags separation**: Setup and query vectordb flags have been separated, allowing independent control over vector database initialization and querying.
  * **KnowledgeBase query default**: `query_knowledge_base` is now set to `True` by default, enabling knowledge base querying out of the box without explicit configuration.
  * **PromptLayer threading**: Fixed a threading issue in PromptLayer integration to prevent race conditions during concurrent agent operations.
  * **StreamableHTTPClientParams auth**: Added `auth` attribute to `StreamableHTTPClientParams`, enabling authentication support for streamable HTTP MCP connections.

  ## Bug Fixes:

  * **Command injection in `check_command_exists` (CWE-78)**: Replaced unsafe `subprocess.run` shell invocation with `shutil.which()` to prevent arbitrary command execution via shell metacharacters.
  * **Profanity policy implementation**: Corrected the profanity policy logic in the safety engine to ensure proper content filtering and policy enforcement.

  **Full Changelog address:** [v0.74.3...v0.74.4](https://github.com/Upsonic/Upsonic/compare/v0.74.3...v0.74.4)

  ### Pull Requests:

  * fix: prevent command injection in check\_command\_exists (CWE-78): [spidershield-contrib](https://github.com/spidershield-contrib) in [#559](https://github.com/Upsonic/Upsonic/pull/559)
  * feat: mail interface: [DoganK01](https://github.com/DoganK01) in [#560](https://github.com/Upsonic/Upsonic/pull/560)
</Update>

<Update label="Mar 30, 2026">
  ## v0.74.3

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.74.3)

  ## New Features:

  * **Exa web search toolkit**: Agents can use Exa for neural and keyword web search, URL content retrieval, similar-page discovery, and LLM-oriented answers with citations via `ExaTools`.
  * **E2B sandbox toolkit**: Agents can run Python, JavaScript, Java, R, and Bash in isolated E2B cloud sandboxes with file transfer, shell commands, package installs, and lifecycle controls via `E2BTools`.
  * **Daytona sandbox toolkit**: Agents can execute code and manage files, Git workflows, and sandbox lifecycle in Daytona cloud environments via `DaytonaTools`.

  ## Improvements:

  * **User policy coverage**: Safety policies now evaluate all configured input sources (task description, context, system prompt, chat history, and tool outputs where scoped), not only the task description, so sanitization matches policy scope consistently.
  * **OCR engine initialization**: OCR providers use thread-safe lazy initialization so concurrent callers share a single reader instance instead of racing during first load.

  ## Bug Fixes:

  * **OCR duplicate downloads**: Parallel or repeated initialization of OCR engines could trigger redundant model downloads; locking ensures the engine is created once per provider.

  **Full Changelog address:** [v0.74.2...v0.74.3](https://github.com/Upsonic/Upsonic/compare/v0.74.2...v0.74.3)

  ### Pull Requests:

  * fix: add threading for initializing ocr engines preventing multiple download: [DoganK01](https://github.com/DoganK01) in [#557](https://github.com/Upsonic/Upsonic/pull/557)
</Update>

<Update label="Mar 24, 2026">
  ## v0.74.2

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/tag/v0.74.2)

  ## New Features

  * **Skills safety policies**: Optional safety-engine policies for skill content (prompt injection, secret leak, and code injection) that run when skills are validated, with structured logging and Rich panels for pass/block visibility.

  ## Improvements

  * **Execution timing and metrics**: Clearer reporting of total duration, model time, tool time, paused time, and framework overhead, aligned with usage metadata and OpenTelemetry-style attributes where applicable.
  * **Agent pipeline / message construction**: Former monolithic message build work is split into focused steps (system prompt, context, user input, assembly) so ordering and observability match the rest of the pipeline.
  * **Streaming parity**: Build-related steps that were missing from the streaming path are now included so streamed runs expose the same step progression as non-streaming runs.

  ## Bug Fixes

  * **Total duration tracking**: Fixed incorrect total-duration aggregation so end-to-end timing matches actual wall-clock behavior.
  * **Metric setting**: Corrected how run-level metrics are set and propagated so dashboards and traces show consistent values.
  * **Unit tests**: Adjusted tests that incorrectly depended on API keys so they run reliably in CI without live credentials.

  **Full Changelog:** [v0.74.1…v0.74.2](https://github.com/Upsonic/Upsonic/compare/v0.74.1...v0.74.2)

  ### Pull Requests

  * refactor: metric setting fix, safety policies for skills: [DoganK01](https://github.com/DoganK01) in [#552](https://github.com/Upsonic/Upsonic/pull/552)
</Update>

<Update label="Mar 18, 2026">
  ## v0.74.1

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.74.1)

  ## Bug Fixes

  * **Skill integration smoke tests**: Some tests for skill integration were failing; they are updated so the suite matches current skills behavior and passes reliably.

  **Full Changelog:** [v0.74.0...v0.74.1](https://github.com/Upsonic/Upsonic/compare/v0.74.0...v0.74.1)

  ### Pull Requests

  * fix: fix tests for skill integration: [DoganK01](https://github.com/DoganK01) in [#551](https://github.com/Upsonic/Upsonic/pull/551)
</Update>

<Update label="Mar 18, 2026">
  ## v0.74.0

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.74.0)

  ## New Features

  * **Apify tools (parameter support)**: Apify actor and run tools accept parameters so agents pass structured inputs to actors and runs.
  * **Discord interface**: New Discord integration via `DiscordInterface`—Gateway WebSocket, per-user CHAT sessions, attachments, HITL via buttons, streaming edits, whitelist and typing options.
  * **Skills integration**: Skills load from multiple sources and apply in agent runs as first-class context.

  ## Improvements

  * **PgVector provider (identifier safety)**: Schema and table names are validated (alphanumeric and underscores) and DDL uses quoted identifiers, hardening against unsafe identifiers when collection names come from config or agents.

  ## Bug Fixes

  * **MCP `call_tool` (streamable-HTTP / SSE)**: Tool calls failed because streamable-HTTP/SSE return a `(read, write, session_id)` tuple like stdio, not a session object—aligned with `connect` so TaskGroup errors no longer occur on every tool call.
  * **MCP tool results (`EmbeddedResource`)**: `AnyUrl` on embedded resource URIs broke JSON serialization; URIs are normalized with `str()`.
  * **MCP smoke tests**: Smoke tests updated for the streamable-HTTP/SSE `call_tool` behavior.

  ## New Contributors

  * [@RinZ27](https://github.com/RinZ27) made their first contribution in [#541](https://github.com/Upsonic/Upsonic/pull/541)
  * [@Jimgitsit](https://github.com/Jimgitsit) made their first contribution in [#550](https://github.com/Upsonic/Upsonic/pull/550)

  **Full Changelog:** [v0.73.2...v0.74.0](https://github.com/Upsonic/Upsonic/compare/v0.73.2...v0.74.0)

  ### Pull Requests

  * vectordb: hardening pgvector provider against potential SQL injection: [RinZ27](https://github.com/RinZ27) in [#541](https://github.com/Upsonic/Upsonic/pull/541)
  * fix: MCP call\_tool fails for streamable-http and SSE transports: [Jimgitsit](https://github.com/Jimgitsit) in [#550](https://github.com/Upsonic/Upsonic/pull/550)
  * feat: parameter support for apify tools: [DoganK01](https://github.com/DoganK01) in [#547](https://github.com/Upsonic/Upsonic/pull/547)
</Update>

<Update label="Mar 13, 2026">
  ## v0.73.2

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.73.2)

  ## Bug Fixes

  * **Apify tool function schema**: Corrected function tool schema setting for Apify actors so the framework passes the expected schema to the model.

  **Full Changelog:** [v0.73.1...v0.73.2](https://github.com/Upsonic/Upsonic/compare/v0.73.1...v0.73.2)

  ### Pull Requests

  * fix: apify tool function schema fix: [DoganK01](https://github.com/DoganK01) in [#546](https://github.com/Upsonic/Upsonic/pull/546)
</Update>

<Update label="Mar 12, 2026">
  ## v0.73.1

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.73.1)

  ## New Features

  * **Clanker type alias**: `Clanker` is an alias for `Agent`, exported from `upsonic` / `upsonic.agent` so you can standardize on one symbol or the other without duplicate implementations.
  * **README IDE integration**: New README section for Cursor, Windsurf, and VS Code using Mintlify-generated `llms-full.txt` to give IDEs full framework context.

  ## Improvements

  * **PromptLayer & Langfuse integrations**: Logging flows support primary and named scores (0–100), post-hoc `score`/`ascore`, and dataset run IDs; Langfuse integration adds dataset and dataset-item APIs for evaluation and dataset workflows.

  ## Bug Fixes

  * **Unit tests for tracing**: Tests updated/fixed to align with the refactored PromptLayer and Langfuse clients.

  **Full Changelog:** [v0.73.0...v0.73.1](https://github.com/Upsonic/Upsonic/compare/v0.73.0...v0.73.1)

  ### Pull Requests

  * doc: add IDE integration section to README: [IremOztimur](https://github.com/IremOztimur) in [#544](https://github.com/Upsonic/Upsonic/pull/544)
  * feat: clanker type alias: [DoganK01](https://github.com/DoganK01) in [#545](https://github.com/Upsonic/Upsonic/pull/545)
</Update>

<Update label="Mar 9, 2026">
  ## v0.73.0

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.73.0)

  ## New Features

  * **Model setting dataclasses for providers**: Typed model configuration classes for multiple LLM providers for clearer, type-safe model setup.
  * **Langfuse and PromptLayer integration**: Tracing and observability integration with Langfuse and PromptLayer for agent runs.
  * **HITL integrations (User input, User confirmation, Dynamic user input)**: New human-in-the-loop flows for user input, confirmation, and dynamic input during execution.
  * **Telegram HITL integration**: Human-in-the-loop support via Telegram for remote confirmation and input.
  * **Apify integration**: Integration with Apify for using Apify actors and tools from the framework.
  * **Examples repository as git submodule**: Official [Upsonic/Examples](https://github.com/Upsonic/Examples) repository added as a git submodule under `examples/`.
  * **Model and tool execution time tracking and metrics table**: Execution time for model and tool calls plus framework overhead surfaced in the metrics table.
  * **New model providers**: Additional LLM provider support beyond existing providers.

  ## Improvements

  * **README content and examples**: Simplified overview and key features; added AutonomousAgent section with code example; Safety Engine example updated to PIIAnonymizePolicy; OCR installation and usage example; AgentOS section condensed.
  * **Discord community badge and CTA**: Discord badge in the header badge row and invite link in quick nav and Community & Support section for better community visibility.
  * **ToolKit refactor**: Refactored ToolKit implementation for clearer structure and maintainability.
  * **Task and Agent metrics refactor**: Refactored task and agent metrics collection and reporting.
  * **Anthropic input type**: Enhanced input type handling for the Anthropic provider.
  * **Team printing logic**: Team printing behavior aligned with Agent printing for consistent console output.
  * **Usage tracking**: Refactored usage tracking implementation.

  ## Bug Fixes

  * **AutonomousAgent streaming**: Fixed streaming behavior for AutonomousAgent.
  * **ContextManagementMiddleware**: Fixed context management middleware behavior.
  * **Bedrock environment variable**: Corrected environment variable handling for AWS Bedrock.

  **Full Changelog**: [https://github.com/Upsonic/Upsonic/compare/v0.72.6...v0.73.0](https://github.com/Upsonic/Upsonic/compare/v0.72.6...v0.73.0)

  ### Pull Requests

  * docs: update README content and examples: [@IremOztimur](https://github.com/IremOztimur) in [#535](https://github.com/Upsonic/Upsonic/pull/535)
  * feat: add Examples repository as a git submodule: [@IremOztimur](https://github.com/IremOztimur) in [#542](https://github.com/Upsonic/Upsonic/pull/542)
  * doc: add Discord community badge to README: [@IremOztimur](https://github.com/IremOztimur) in [#543](https://github.com/Upsonic/Upsonic/pull/543)
  * feat: new model setting classes for models: [@DoganK01](https://github.com/DoganK01) in [#540](https://github.com/Upsonic/Upsonic/pull/540)
</Update>

<Update label="Feb 23, 2026">
  ## v0.72.6

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.72.6)

  ## New Features:

  * **Qdrant config smoke tests:** Test classes for every QdrantConfig attribute in IN\_MEMORY and CLOUD modes.

  ## Improvements:

  * **Qdrant text index creation:** TextIndexParams now always include a tokenizer and defaults so Cloud and local work without "unknown tokenizer type."
  * **Qdrant error handling:** Field index failures raise one VectorDBError; full-text index and collection\_exists no longer swallow exceptions (only 404/not-found is handled).
  * **Qdrant smoke test assertions:** Smoke test enhanced

  ## Bug Fixes:

  * **Qdrant text index on Cloud:** Fixed "unknown tokenizer type" by always setting tokenizer and default params in schema and index creation.

  * **Qdrant swallowed exceptions:** \_create\_field\_indexes, \_server\_side\_full\_text\_search, and collection\_exists now propagate errors instead of silently ignoring them.

  Full Changelog: [v0.72.5...v0.72.6](https://github.com/Upsonic/Upsonic/compare/v0.72.5...v0.72.6)

  ### Pull Requests:

  * *(Add PR name and link when merged.)*
</Update>

<Update label="Feb 21, 2026">
  ## v0.72.5

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.72.5)

  ## New Features:

  * **Agent metrics**: Agent runs now expose accumulated usage (tokens, cost) and tool execution tracking for observability and cost monitoring.
  * **SuperMemory integration**: New vector database provider `SuperMemoryProvider` for RAG and knowledge base, with async SuperMemory API support, configurable via `SuperMemoryConfig` or `upsonic[supermemory]`.

  ## Improvements:

  * **Tool managers (Task vs Agent)**: Task-level tools use a dedicated `ToolManager` on the task; agent and task tool definitions are combined and resolved correctly for validation and execution.
  * **Anthropic default max tokens**: Default `max_tokens` for Anthropic API increased from 4096 to 16384 for longer responses.
  * **Pydantic response format in streaming**: When using a Pydantic `response_format` on a task, streaming tool calls for the output tool are validated with `model_validate` and handled correctly in streaming mode.

  ## Bug Fixes:

  * **finish\_reason "length"**: When the model hits `max_tokens` and returns `finish_reason == "length"`, tool calls are no longer executed with possibly truncated arguments; the agent is informed via a tool-return message and can retry with shorter content or smaller steps.

  Full Changelog: [https://github.com/Upsonic/Upsonic/compare/v0.72.4...v0.72.5](https://github.com/Upsonic/Upsonic/compare/v0.72.4...v0.72.5)

  ### Pull Requests:

  * feat: supermemory storage, agent metrics: [DoganK01](https://github.com/DoganK01) in [#536](https://github.com/Upsonic/Upsonic/pull/536)
</Update>

<Update label="Feb 19, 2026">
  ## v0.72.4

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.72.4)

  ## Bug Fixes:

  * **Firecrawl & Anthropic API:** Fixed incorrect Firecrawl and Anthropic API usage so the framework works with current API versions.

  Full Changelog: [https://github.com/Upsonic/Upsonic/compare/v0.72.3...v0.72.4](https://github.com/Upsonic/Upsonic/compare/v0.72.3...v0.72.4)

  ### Pull Requests:

  * fix: fix wrong api usage and anthropic api usage for new versions: [DoganK01](https://github.com/DoganK01) in [#533](https://github.com/Upsonic/Upsonic/pull/533)
  * Version 0.72.4: [DoganK01](https://github.com/DoganK01) in [#534](https://github.com/Upsonic/Upsonic/pull/534)
</Update>

<Update label="Feb 17, 2026">
  ## v0.72.3

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.72.3)

  ## New Features:

  * Agent execution timeout: Optional `timeout` (seconds) on `do`, `do_async`, `print_do`, and `print_do_async`; execution is cancelled after the limit and `ExecutionTimeoutError` is raised unless partial results are requested.
  * Partial result on timeout: When `partial_on_timeout=True` and a timeout is set, the agent returns whatever text was generated so far instead of raising; uses streaming internally to accumulate output progressively.
  * Firecrawl custom tool: New Firecrawl integration with sync/async support; added as optional dependency `firecrawl-py>=4.14.1`.
  * ExecutionTimeoutError: New exception in `upsonic.exceptions` for timeout scenarios, carrying the timeout value for programmatic handling.

  ## Improvements:

  * Persistent background event loop: Sync entry points use a single daemon-thread event loop instead of `asyncio.run()` per call, avoiding "Event loop is closed" and connection-pool issues with SDK clients.
  * Token usage on partial/timeout: When execution ends due to timeout with partial results, usage is recorded so task token counts remain accurate.
  * Pipeline cancellation handling: Pipeline manager handles `GeneratorExit` gracefully when execution is cancelled by timeout; `RunCompletedEvent` only emitted when step results exist.
  * Mem0 storage: Implementation and tests updated for mem0 sync/async storage.
  * Retry and usage utilities: Adjusted for timeout and partial-result flows; Firecrawl and custom tools aligned with shared patterns and tests added.

  ## Bug Fixes:

  * Sync execution event loop: Fixed sync agent/team methods failing or leaving closed event loops when called repeatedly by using a persistent background loop.
  * Firecrawl tool attributes: Corrected tool attribute definitions and usage in Firecrawl custom tool and tests.
  * Unit test usage: Fixed unit test usage and expectations for new timeout and partial-result behavior.

  Full Changelog: [https://github.com/Upsonic/Upsonic/compare/v0.72.2...v0.72.3](https://github.com/Upsonic/Upsonic/compare/v0.72.2...v0.72.3)

  ### Pull Requests:

  * feat: add timeout and partial result handling in Agent execution [@onuratakan](https://github.com/onuratakan) in [#532](https://github.com/Upsonic/Upsonic/pull/532)
</Update>

<Update label="Feb 14, 2026">
  ## v0.72.2

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.72.2)

  ## New Features:

  * Agent/Team as MCP tool: Agent and Team can be exposed as MCP via `as_mcp()` and consumed as MCP tools by other agents.
  * Nested Teams: Teams can contain both Agents and other Teams for hierarchical multi-agent workflows.
  * Team leader and router: Optional `leader` and `router` Agent arguments when creating a Team for coordinate and route modes.
  * Team async and streaming: Team supports `do_async`/`ado` and `astream`/`stream` for use as an entity inside another Team or in async pipelines.
  * Task list execution: Agent and Team accept a list of tasks for `do`, `do_async`, `print_do`, and `print_do_async`, returning a list of results.
  * Eval and MCP smoke tests: New smoke tests for Accuracy/Performance/Reliability evals and for Agent/Team as MCP; nested team and task metrics tests added.
  * Makefile deps\_smoke: New target to install optional deps (storage, faiss) for smoke tests.

  ## Improvements:

  * Printing and cost tracking: Price tracking runs even when `print_output` is False; new `show_tool_calls` allows showing tool-calls tables independently.
  * Jupyter compatibility: Team and Autonomous Agent sync methods run async work in a separate thread when a loop is already running, fixing `print_do`/`do` in notebooks.
  * MCP environment: MCP server subprocesses inherit the full process environment (API keys, PYTHONPATH, .env) with user overrides.
  * Workspace: References use `AGENTS.md`; greeting prompt and behavior refined.
  * Storage: Optional backends use safe lazy loading so missing deps do not break other storage imports.
  * Team internals: Coordinator, task assignment, context sharing, delegation, and result combiner support both Agent and Team entities; delegation tool simplified and debug option added.
  * Agent: Added `get_entity_id()` for unified entity interface with Team.

  ## Bug Fixes:

  * print\_do in Jupyter: Fixed sync `do`/`print_do` hanging or failing when a reactor (e.g. Jupyter) already has a running event loop by using a dedicated thread for async execution.
  * Smoke tests: Updated to new printing behavior, print capture, and optional deps so the smoke suite passes with current Agent/Team and eval usage.
  * Fixed retry and Task error status conflict.

  Full Changelog: [https://github.com/Upsonic/Upsonic/compare/v0.72.1...v0.72.2](https://github.com/Upsonic/Upsonic/compare/v0.72.1...v0.72.2)

  ### Pull Requests:

  * feat: Agent/Team as mcp tool, Team can be put inside Team [@DoganK01](https://github.com/DoganK01) in [#526](https://github.com/Upsonic/Upsonic/pull/526)
  * fix: fix smoke tests by using new printing usage [@DoganK01](https://github.com/DoganK01) in [#529](https://github.com/Upsonic/Upsonic/pull/529)
  * chor: version 0.72.2 [@DoganK01](https://github.com/DoganK01) in [#530](https://github.com/Upsonic/Upsonic/pull/530)
  * fix: fix retry and task error status collision [@DoganK01](https://github.com/DoganK01) in [#531](https://github.com/Upsonic/Upsonic/pull/531)
</Update>

<Update label="Feb 12, 2026">
  ## v0.72.1

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.72.1)

  ## New Features:

  * **Asynchronous OCR processing**: Added async-first OCR pipeline with `get_text_async` and `process_file_async` entry points so document processing can run without blocking.
  * **Document conversion layer (Layer 0)**: New document-to-image conversion layer using PyMuPDF for PDF rendering, EXIF-based orientation correction, and optional downscaling for large images before OCR.
  * **OCR engine API and timeouts**: OCR providers refactored into instantiated engine classes (e.g. `EasyOCREngine`, `RapidOCREngine`, `TesseractOCREngine`, `DeepSeekOCREngine`, Paddle engines); added `OCRTimeoutError` and optional per-page timeouts for long-running jobs.

  ## Improvements:

  * **OCR PDF backend**: PDF conversion switched from pdf2image/poppler to PyMuPDF (fitz) for rendering; `ocr` extra dependency updated accordingly.
  * **OCR image preprocessing**: `load_image` now applies EXIF-based orientation correction so rotated images are normalized before OCR.
  * **Dependency and tooling**: Updated vulnerable packages and pinned/specified uv version for reproducible installs.

  ## Bug Fixes:

  * **LLM usage tracking**: Fixed usage (input/output/reasoning tokens and details) not being accumulated when agent runs used `do_async` without returning output, or when `RunUsage.incr` received usage objects with non-dict or missing `details`; usage is now correctly aggregated across agent, safety engine LLM, reflection, reliability layer, cache, culture, tools, and storage.

  **Full Changelog:** [https://github.com/Upsonic/Upsonic/compare/v0.72.0...v0.72.1](https://github.com/Upsonic/Upsonic/compare/v0.72.0...v0.72.1)

  ### Pull Requests:

  * fix: fix LLM usage tracking – [DoganK01](https://github.com/DoganK01) in [#525](https://github.com/Upsonic/Upsonic/pull/525)
  * chore: update vulnerable packages and specify uv version – [angryfoxx](https://github.com/angryfoxx) in [#523](https://github.com/Upsonic/Upsonic/pull/523)
  * feat: implement asynchronous OCR processing and add new document conversion layer – [onuratakan](https://github.com/onuratakan) in [#527](https://github.com/Upsonic/Upsonic/pull/527)
  * chore: version 0.72.1 – [DoganK01](https://github.com/DoganK01) in [#528](https://github.com/Upsonic/Upsonic/pull/528)
</Update>

<Update label="Feb 9, 2026">
  ## v0.72.0

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/tag/v0.72.0)

  ## New Features:

  * Telegram interface: Adds a full Telegram bot interface and tooling so agents can be used over Telegram (webhook, messages, media).
  * Chat and Task modes for interfaces: All interfaces (Slack, WhatsApp, Gmail, Telegram) support Chat mode (single Chat instance) and Task mode (single Agent instance) for consistent behavior.
  * Autonomous Agent: New AutonomousAgent class — a pre-configured agent with built-in filesystem and shell toolkits, workspace sandboxing, and default in-memory storage for coding assistants, DevOps automation, and system administration tasks.
  * Context management middleware: Automatic context window management that prunes tool call history and summarizes old messages when the conversation approaches the model's context limit, replacing the previous compression strategy.
  * Workspace support: Agents can be configured with a workspace folder containing an Agents.md file whose content is included in the system prompt and used to generate a greeting message before the first task or chat.

  ## Improvements:

  * Benchmarks documentation: benchmarks/QUICKSTART.md was translated from Turkish to English for consistent English docs.
  * CLI and interface compatibility: Interfaces can now be started via the upsonic run CLI command instead of only programmatically.
  * Optional context compression model: Context management middleware accepts an optional context\_compression\_model parameter, allowing a separate (typically larger-context-window) model for the summarization step while keeping the primary model for regular operations.

  ## Bug Fixes:

  * Gmail encoding: Fixed encoding for non-ASCII characters in the Gmail interface so messages with non-ASCII letters are handled correctly.

  Full Changelog address: [https://github.com/Upsonic/Upsonic/compare/v0.71.6...v0.72.0](https://github.com/Upsonic/Upsonic/compare/v0.71.6...v0.72.0)

  ### Pull Requests:

  * docs: translate benchmarks QUICKSTART.md to English: [IremOztimur](https://github.com/IremOztimur) in [#522](https://github.com/Upsonic/Upsonic/pull/522)
  * feat: telegram interface, chat/task modes for interfaces: [DoganK01](https://github.com/DoganK01) in [#521](https://github.com/Upsonic/Upsonic/pull/521)
  * refactor: cli and interface compatibility: [DoganK01](https://github.com/DoganK01) in [#524](https://github.com/Upsonic/Upsonic/pull/524)
</Update>

<Update label="Feb 6, 2026">
  ## v0.71.6

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.71.6)

  ## Improvements:

  * Anonymization: We moved the anonymization step to an earlier part of the pipeline for a better developer experience.

  **Full Changelog**: [https://github.com/Upsonic/Upsonic/compare/v0.71.5...v0.71.6](https://github.com/Upsonic/Upsonic/compare/v0.71.5...v0.71.6)
</Update>

<Update label="Feb 5, 2026">
  ## v0.71.5

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.71.5)

  ## New Features:

  * Benchmark Module: Added a benchmark module for analyzing framework speed
  * New Tool: Added Bocha Web Search Tool

  ## Improvements:

  * Anonymization: Resolved an issue with the anonymization action in the safety policies
  * Test Run Commands: Updated the test run commands for a better test run experience

  ## New Contributors

  * @weijintaocode made their first contribution in [https://github.com/Upsonic/Upsonic/pull/518](https://github.com/Upsonic/Upsonic/pull/518)

  **Full Changelog**: [https://github.com/Upsonic/Upsonic/compare/v0.71.4...v0.71.5](https://github.com/Upsonic/Upsonic/compare/v0.71.4...v0.71.5)

  ### Pull Requests:

  * feat: add comprehensive benchmark system for performance analysis by @IremOztimur in [https://github.com/Upsonic/Upsonic/pull/511](https://github.com/Upsonic/Upsonic/pull/511)
  * add bocha web search tool by @weijintaocode in [https://github.com/Upsonic/Upsonic/pull/518](https://github.com/Upsonic/Upsonic/pull/518)
  * fix: Resolved anonymization action logic by @onuratakan in [https://github.com/Upsonic/Upsonic/pull/519](https://github.com/Upsonic/Upsonic/pull/519)
  * docs: fix test command in CONTRIBUTING.md to use uv run by @IremOztimur in [https://github.com/Upsonic/Upsonic/pull/520](https://github.com/Upsonic/Upsonic/pull/520)
</Update>

<Update label="Jan 31, 2026">
  ## v0.71.4

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.71.4)

  ## New Features:

  * Event Streaming Chat: Added event streaming capability to chat functionality, enabling real-time visibility into tool calls, text deltas, and execution events through `chat.stream(events=True)`.

  ## Improvements:

  * Agent Printing Hierarchy: Refactored the agent printing system with a clear priority hierarchy (environment variable > constructor parameter > method name) for better control over output behavior.

  ## Bug Fixes:

  *(No bug fixes in this release)*

  Full Changelog address: [https://github.com/Upsonic/Upsonic/compare/v0.71.3...v0.71.4](https://github.com/Upsonic/Upsonic/compare/v0.71.3...v0.71.4)

  ### Pull Requests:

  * Refactor agent printing hierarchy: [@DoganK01](https://github.com/DoganK01) in [#515](https://github.com/Upsonic/Upsonic/pull/515)
  * Add event streaming chat: [@DoganK01](https://github.com/DoganK01) in [#516](https://github.com/Upsonic/Upsonic/pull/516)
  * Version 0.71.4: [@DoganK01](https://github.com/DoganK01) in [#517](https://github.com/Upsonic/Upsonic/pull/517)
</Update>

<Update label="Jan 29, 2026">
  ## v0.71.2

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.71.2)

  ## New Features:

  ## Improvements:

  ## Bug Fixes:

  * Fixed Agent Printing: Resolved issue with Agent instance string representation and display functionality.

  Full Changelog address: [https://github.com/Upsonic/Upsonic/compare/v0.71.1...v0.71.2](https://github.com/Upsonic/Upsonic/compare/v0.71.1...v0.71.2)

  ### Pull Requests:

  * fix: fix Agent printing: [@DoganK01](https://github.com/DoganK01) in [#513](https://github.com/Upsonic/Upsonic/pull/513)
</Update>

<Update label="Jan 29, 2026">
  ## v0.71.1/v0.71.2

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.71.1)

  ## New Features:

  ## Improvements:

  * Developer Onboarding Documentation: Enhanced the CONTRIBUTING.md file with improved developer onboarding flow, clearer setup instructions, and comprehensive development guidelines to help new contributors get started faster.
  * Infrastructure Documentation Section: Added a dedicated infrastructure section to the documentation, providing developers with essential information about the project's technical infrastructure, setup requirements, and development environment configuration.
  * Culture Module Refactoring: Instructions are improved so that Agent strictly follows the culture.
  * Agent and Direct class printing: Made Agent and Direct class printings dependent on 'print' flag.

  ## Bug Fixes:

  Full Changelog address: [https://github.com/Upsonic/Upsonic/compare/v0.71.0...v0.71.1](https://github.com/Upsonic/Upsonic/compare/v0.71.0...v0.71.1)

  ### Pull Requests:

  * docs: improve developer onboarding flow and add infrastructure section: [IremOztimur](https://github.com/IremOztimur) in [#509](https://github.com/Upsonic/Upsonic/pull/509)
  * refactor: refactor culture: [DoganK01](https://github.com/DoganK01) in [#512](https://github.com/Upsonic/Upsonic/pull/512)
</Update>

<Update label="Jan 28, 2026">
  ## v0.71.0

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/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.

  Full Changelog: [https://github.com/Upsonic/Upsonic/compare/v0.70.0...v0.71.0](https://github.com/Upsonic/Upsonic/compare/v0.70.0...v0.71.0)

  ### Pull Requests:

  * Cultural Knowledge: [DoganK01](https://github.com/DoganK01) in [#506](https://github.com/Upsonic/Upsonic/pull/506)
  * refactor: Makefile for smoke tests: [DoganK01](https://github.com/DoganK01) in [#505](https://github.com/Upsonic/Upsonic/pull/505)
  * docs: refactor README to follow open-source standards: [IremOztimur](https://github.com/IremOztimur) in [#507](https://github.com/Upsonic/Upsonic/pull/507)
  * Interface testing: [DoganK01](https://github.com/DoganK01) in [#508](https://github.com/Upsonic/Upsonic/pull/508)
  * chore: version 0.71.0: [DoganK01](https://github.com/DoganK01) in [#510](https://github.com/Upsonic/Upsonic/pull/510)
</Update>

<Update label="Jan 17, 2026">
  ## v0.70.0

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/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.

  Full Changelog address: [https://github.com/Upsonic/Upsonic/compare/v0.69.0...v0.70.0](https://github.com/Upsonic/Upsonic/compare/v0.69.0...v0.70.0)

  ### Pull Requests:

  * Agent Run Implementation: [DoganK01](https://github.com/DoganK01) in [#504](https://github.com/Upsonic/Upsonic/pull/504)
</Update>

<Update label="Dec 16, 2025">
  ## v0.69.1

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/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.

  Full Changelog: [https://github.com/Upsonic/Upsonic/compare/v0.69.0...v0.69.1](https://github.com/Upsonic/Upsonic/compare/v0.69.0...v0.69.1)

  ### Pull Requests:

  * fix: fix normalizing model ids: [DoganK01](https://github.com/DoganK01) in [#498](https://github.com/Upsonic/Upsonic/pull/498)
</Update>

<Update label="Dec 16, 2025">
  ## v0.69.0

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/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.

  Full Changelog address: [https://github.com/Upsonic/Upsonic/compare/v0.68.3...v0.69.0](https://github.com/Upsonic/Upsonic/compare/v0.68.3...v0.69.0)

  ### Pull Requests:

  * feat: version 0.69.0: [@DoganK01](https://github.com/DoganK01) in [#497](https://github.com/Upsonic/Upsonic/pull/497)
</Update>

<Update label="Dec 12, 2025">
  ## v0.68.2 & v0.68.3

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/v0.68.2)

  ## 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

  Full Changelog address: [https://github.com/Upsonic/Upsonic/compare/v0.68.1...v0.68.2](https://github.com/Upsonic/Upsonic/compare/v0.68.1...v0.68.2)

  ### Pull Requests:

  * feat: Added deepseek-ocr with ollama: [@onuratakan](https://github.com/onuratakan) in [#491](https://github.com/Upsonic/Upsonic/pull/491)
  * refactor: new smoke tests and bug fix: [@DoganK01](https://github.com/DoganK01) in [#492](https://github.com/Upsonic/Upsonic/pull/492)
  * New models: [@DoganK01](https://github.com/DoganK01) in [#493](https://github.com/Upsonic/Upsonic/pull/493)
  * chore: image output utils: [@DoganK01](https://github.com/DoganK01) in [#494](https://github.com/Upsonic/Upsonic/pull/494)
  * fix: bedroc profile creation fix: [@DoganK01](https://github.com/DoganK01) in [#495](https://github.com/Upsonic/Upsonic/pull/495)
</Update>

<Update label="Dec 4, 2025">
  ## v0.68.1

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/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.

  Full Changelog address: [https://github.com/Upsonic/Upsonic/compare/v0.68.0...v0.68.1](https://github.com/Upsonic/Upsonic/compare/v0.68.0...v0.68.1)

  ### Pull Requests:

  * fix docstring of search tool from knowledgebase, add mcp closing logic: [@DoganK01](https://github.com/DoganK01) in [#489](https://github.com/Upsonic/Upsonic/pull/489)
  * version 0.68.1: [@DoganK01](https://github.com/DoganK01) in [#490](https://github.com/Upsonic/Upsonic/pull/490)
</Update>

<Update label="Dec 2, 2025">
  ## v0.68.0

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/tag/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.

  Full Changelog: [https://github.com/Upsonic/Upsonic/compare/v0.67.4...v0.68.0](https://github.com/Upsonic/Upsonic/compare/v0.67.4...v0.68.0)

  ### Pull Requests:

  * New features: [@DoganK01](https://github.com/DoganK01) in [#488](https://github.com/Upsonic/Upsonic/pull/488)
</Update>

<Update label="Nov 27, 2025">
  ## v0.67.4

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/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.

  Full Changelog address: [https://github.com/Upsonic/Upsonic/compare/v0.67.3...v0.67.4](https://github.com/Upsonic/Upsonic/compare/v0.67.3...v0.67.4)

  ### Pull Requests:

  * fix: fix run command not importing other files: [@DoganK01](https://github.com/DoganK01) in [#486](https://github.com/Upsonic/Upsonic/pull/486)
  * chor: new version 0.67.4: [@DoganK01](https://github.com/DoganK01) in [#487](https://github.com/Upsonic/Upsonic/pull/487)
</Update>

<Update label="Nov 25, 2025">
  ## v0.67.3

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/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.

  Full Changelog address: [https://github.com/Upsonic/Upsonic/compare/v0.67.2...v0.67.3](https://github.com/Upsonic/Upsonic/compare/v0.67.2...v0.67.3)

  ### Pull Requests:

  * refactor: import error log adding and circular import fix: [@DoganK01](https://github.com/DoganK01) in [#484](https://github.com/Upsonic/Upsonic/pull/484)
</Update>

<Update label="Nov 25, 2025">
  ## v0.67.2

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/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.

  Full Changelog address: [https://github.com/Upsonic/Upsonic/compare/v0.67.1...v0.67.2](https://github.com/Upsonic/Upsonic/compare/v0.67.1...v0.67.2)

  ### Pull Requests:

  * unit tests added for team feature: [@sxroads](https://github.com/sxroads) in [#478](https://github.com/Upsonic/Upsonic/pull/478)
  * refactor: mcp tool handling class refactor: [@DoganK01](https://github.com/DoganK01) in [#481](https://github.com/Upsonic/Upsonic/pull/481)
  * unit tests added for the graph feature: [@sxroads](https://github.com/sxroads) in [#477](https://github.com/Upsonic/Upsonic/pull/477)
  * tests : unit tests added for the tools feauture: [@sxroads](https://github.com/sxroads) in [#476](https://github.com/Upsonic/Upsonic/pull/476)
  * fix: correct YFinanceTools import and update notebook cells: [@IremOztimur](https://github.com/IremOztimur) in [#473](https://github.com/Upsonic/Upsonic/pull/473)
  * cli update for agentos: [@DoganK01](https://github.com/DoganK01) in [#482](https://github.com/Upsonic/Upsonic/pull/482)
</Update>

<Update label="Nov 18, 2025">
  ## v0.67.1

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/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.

  Full Changelog address: [https://github.com/Upsonic/Upsonic/compare/v0.67.0...v0.67.1](https://github.com/Upsonic/Upsonic/compare/v0.67.0...v0.67.1)

  ### Pull Requests:

  * Interfaces: [@DoganK01](https://github.com/DoganK01) in [#479](https://github.com/Upsonic/Upsonic/pull/479)
  * refactor: image output support adding and general refactor: [@DoganK01](https://github.com/DoganK01) in [#474](https://github.com/Upsonic/Upsonic/pull/474)
  * chore: v0.67.1: [@DoganK01](https://github.com/DoganK01) in [#480](https://github.com/Upsonic/Upsonic/pull/480)
</Update>

<Update label="Nov 13, 2025">
  ## v0.67.0

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/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.

  **Full Changelog**: [https://github.com/Upsonic/Upsonic/compare/v0.66.1...v0.67.0](https://github.com/Upsonic/Upsonic/compare/v0.66.1...v0.67.0)

  ### Pull Requests:

  * refactor: vectordb v2: [@DoganK01](https://github.com/DoganK01) in [#467](https://github.com/Upsonic/Upsonic/pull/467)
  * feat: CLI support for upsonic: [@DoganK01](https://github.com/DoganK01) in [#468](https://github.com/Upsonic/Upsonic/pull/468)
  * fix of unit tests commit: [@sxroads](https://github.com/sxroads) in [#469](https://github.com/Upsonic/Upsonic/pull/469)
  * refactor: remove 'run' optional dependency group: [@DoganK01](https://github.com/DoganK01) in [#471](https://github.com/Upsonic/Upsonic/pull/471)
  * feat: 0.67.0 release: [@DoganK01](https://github.com/DoganK01) in [#472](https://github.com/Upsonic/Upsonic/pull/472)
</Update>

<Update label="Nov 6, 2025">
  ## v0.66.1

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/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.

  Full Changelog: [v0.66.0...v0.66.1](https://github.com/Upsonic/Upsonic/compare/v0.66.0...v0.66.1)

  ### Pull Requests:

  * Model as string ollama: [@onuratakan](https://github.com/onuratakan) in [#463](https://github.com/Upsonic/Upsonic/pull/463)
</Update>

<Update label="Nov 3, 2025">
  ## v0.66.0

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/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.

  Full Changelog address: [v0.65.1...v0.66.0](https://github.com/Upsonic/Upsonic/compare/v0.65.1...v0.66.0)

  ### Pull Requests:

  * Expression Language: [@DoganK01](https://github.com/DoganK01) in [#453](https://github.com/Upsonic/Upsonic/pull/453)

  * smoke test for mcp added: [@sxroads](https://github.com/sxroads) in [#454](https://github.com/Upsonic/Upsonic/pull/454)

  * docs: fix broken links in README: [@gokborayilmaz](https://github.com/gokborayilmaz) in [#456](https://github.com/Upsonic/Upsonic/pull/456)

  * feat: state graph, recursive tool handling for streaming logic: [@DoganK01](https://github.com/DoganK01) in [#455](https://github.com/Upsonic/Upsonic/pull/455)

  * External tool fix: [@DoganK01](https://github.com/DoganK01) in [#457](https://github.com/Upsonic/Upsonic/pull/457)

  * fix: logging fix, memory error handling adding: [@DoganK01](https://github.com/DoganK01) in [#458](https://github.com/Upsonic/Upsonic/pull/458)
</Update>

<Update label="Oct 20, 2025">
  ## v0.65.1

  [View releases on GitHub](https://github.com/Upsonic/Upsonic/releases/tag/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.

  Full Changelog: [v0.65.0...v0.65.1](https://github.com/Upsonic/Upsonic/compare/v0.65.0...v0.65.1)

  ### Pull Requests:

  * Redesigned Logging system: [@onuratakan](https://github.com/onuratakan) in [#452](https://github.com/Upsonic/Upsonic/pull/452)
</Update>