Skip to main content

What's New in Version 0.668.0

Released on January 26, 2026

This release delivers powerful enhancements to Agentic Tooling, advanced vectorisation for enterprise users, desktop file access capabilities, A2A Protocol support, and comprehensive SDK/API coverage! 🚀

🎯 Agentic Tooling & Planning Enhancements​

Smarter Planning & Tool Detection​

We've significantly improved how Agentic Tooling agents plan and select tools. Agents now make more intelligent decisions about which tools to use based on the specific task requirements, resulting in more efficient and accurate plan execution.

Key Improvements:

  • Enhanced Tool Selection - Agents better understand context and choose optimal tools for each step
  • Optimised Planning - Reduced unnecessary steps by identifying the most direct execution paths
  • Adaptive Execution - Plans dynamically adjust based on intermediate results and available capabilities within any given reasoning thread
  • Interleaved Reasoning - Introduced interleaved reasoning capabilities when interacting with API, MCP, and Database procedures, increasing flexibility when executing long-running tasks via agentic tooling. Agents can now naturally explore tools outputs, gather intermediate results, make reasoned decisions, and continue processing with enhanced adaptability.

Desktop Client File Access​

One of our most requested features has arrived! Desktop clients can now connect to and manipulate files in your local folders!

What's New:

  • Folder Selection - Choose exactly which folders the desktop client can access
  • File Manipulation - Agents can read, write, and modify files within authorised directories
  • Secure Access Control - Full control over which folders are exposed to agentic workflows
  • Seamless Integration - File operations work naturally within multi-step plans

This enables agents to work with your local files - updating documents, processing spreadsheets, managing code files, all while maintaining strict access boundaries you define.

Planner UI Bug Fix​

Resolved an issue where the new Planner UI would not display correctly, preventing users from viewing and managing agent plans. The Planner now loads reliably, giving you full visibility into plan steps, decision points, and execution progress.

📊 Advanced Vectorisation​

We've enabled advanced vectorisation capabilities for Business and Enterprise subscriptions, dramatically improving search quality and retrieval accuracy across your knowledge base.

New Capabilities:

  • Enhanced Embeddings - Higher-quality vector embeddings capture semantic meaning more accurately
  • Improved Retrieval - Better matching of queries to relevant documents and topics
  • Multi-Modal Support - Better handling of different content types in your knowledge hub

Availability: Advanced vectorisation is available exclusively for Business and Enterprise subscriptions.

🤖 A2A Protocol Integration​

Agent-to-Agent Communication​

We're excited to introduce support for the A2A (Agent-to-Agent) Protocol, a standardised way for AI agents to communicate with each other. A2A enables multi-agent workflows, cross-platform automation, and seamless integration with other A2A-compatible systems.

Key Features:

  • JSON-RPC 2.0 Standard - Universal protocol for agent interoperability using industry-standard JSON-RPC 2.0
  • Task-Based Conversations - Structured task lifecycle with states (active, completed, failed, canceled) for reliable tracking
  • Streaming Support - Real-time streaming responses via Server-Sent Events (SSE) for long-running operations
  • Agent Discovery - Standardised Agent Cards describe capabilities, enabling automated agent selection and orchestration
  • Artifact Management - Generated outputs (images, charts, documents) are tracked as artifacts within tasks

Available Methods:

  • message/send - Send messages to start or continue conversations
  • message/stream - Stream responses in real-time
  • tasks/get - Retrieve task state, messages, and artifacts
  • tasks/list - List and filter tasks
  • tasks/cancel - Cancel running tasks
  • agent/getExtendedCard - Discover agent capabilities

When to Use A2A:

  • Building orchestrator agents that delegate to specialised ToothFairyAI agents
  • Integrating ToothFairyAI with other A2A-compatible AI platforms
  • Creating multi-agent workflows that span multiple systems
  • Standardised task tracking across your AI infrastructure

Availability: A2A Protocol access requires a Business or Enterprise subscription.

📖 Documentation: A2A Protocol Integration

📖 API Documentation: apidocs.toothfairyai.com - A2A

🔌 SDK, CLI & API Expansions​

Comprehensive SDK Coverage​

Our Node.js and Python SDKs and CLIs now cover approximately 80% of all ToothFairyAI API endpoints, giving developers full programmatic access to platform capabilities directly from their applications.

What's Included:

  • Agent Management - Create, update, and manage agents programmatically
  • Knowledge Hub Operations - Upload, organise, and retrieve from knowledge bases
  • Tool & Hook Configurations - Set up tools and hooks via code
  • Secrets Management - Create and manage API secrets securely
  • Conversation Control - Start, monitor, and manage agent conversations
  • Authorisation Entities - Create and assign credentials to tools and hooks

Both SDKs and CLIs now provide feature parity with the core API, enabling full automation of ToothFairyAI workflows.

Enhanced MCP Server with Full SDK Integration​

The Model Context Protocol (MCP) server now provides 98 tools across 24 categories, powered by the ToothFairyAI Python SDK. This gives AI assistants like Claude complete programmatic access to your workspace.

New Capabilities:

  • Agent Management - Create, read, update, delete, list, and search agents
  • Knowledge Hub - Full document, folder, and entity management
  • Chat Operations - Send messages and manage conversations programmatically
  • Functions & Hooks - Configure external API tools and custom code execution
  • Authorisations & Secrets - Secure credential management
  • Channels & Sites - Communication integrations and web deployments
  • Benchmarks & Scheduled Jobs - Testing and automation
  • Release Notes Access - List, search, and retrieve product updates
  • Billing & Embeddings - Cost tracking and text embedding generation

Documentation & Examples:

  • Detailed Usage Guides - Step-by-step instructions for common operations
  • Code Examples - Working examples for Python and direct HTTP calls
  • API Reference - Complete parameter documentation and response formats
  • Best Practices - Guidance on authentication, error handling, and performance

📖 Documentation: MCP Integration

Secrets Management API​

We've extended the API with new endpoints for creating and deleting secrets, which can then be associated with authorisation entities for secure tool and hook access.

New Features:

  • Create Secrets - Generate and store API keys, tokens, and credentials securely
  • Delete Secrets - Remove credentials when no longer needed
  • Authorisation Linking - Associate secrets with specific tools and hooks
  • Granular Access - Control which tools can access which credentials

This enables secure credential management where tools and hooks can access external services without hardcoding sensitive information.

Example Workflow:

  1. Create a secret containing your API key
  2. Create an authorisation entity referencing the secret
  3. Assign the authorisation entity to a tool or hook
  4. The tool automatically accesses the credential when executing

🛠️ Improvements & Fixes​

Planner UI Display Issue​

Fixed a bug preventing the new Planner UI from loading, restoring full visibility into agent plans and execution steps.

📋 Summary​

This update includes:

  • Enhanced Planning - Smarter tool selection and adaptive execution in Agentic Tooling
  • Desktop File Access - Agents can now manipulate files in authorised folders via desktop client
  • Planner UI Fix - Resolved display issue showing agent plans and progress
  • Advanced Vectorisation - Higher-quality embeddings for Business and Enterprise users
  • A2A Protocol - Agent-to-Agent communication for multi-agent workflows and cross-platform integration
  • SDK Expansion - Node.js and Python SDKs now cover 80% of API endpoints
  • MCP Server with 98 Tools - Full SDK integration with complete workspace management capabilities
  • Secrets Management - New API endpoints for creating and managing secure credentials

Thank you for using ToothFairy! We're constantly working to improve your experience. If you have any feedback or encounter any issues, please don't hesitate to reach out to our support team at support@toothfairyai.com.

Keep building magic with AI! 🧚‍♀️✨

v0.668.0