Skip to content

Release notes

0.2

0.2.0

Enhanced Chat Functionality

  • Advanced multi-turn conversations for seamless interactions. #91
  • Agentic execution of database tools, file system operations, and automatic to-do list generation.
  • Support for both automatic and manual compaction (.compact). #125
  • Session management with .resume and .clear commands.
  • Provide dedicated context by introducing it with the @ Table, @ file, @ metrics, @sql_history commands. #134 #152
  • Token consumption tracking and estimation for better resource visibility. #119
  • Write-capability confirmations before executing sensitive tool actions.
  • Plan Mode: An AI-assisted planning feature that generates and manages a to-do list. #147

Automatic building knowledge base

  • Automatic generation of Metric YAML files in MetricFlow format from historyical success stories. #10
  • Automatic summary and labeling SQL history files from *.sql files in workspace. #132
  • Improves SQL accuracy and generation speed using metrics & SQL history.

MCP Extension

  • New .mcp commands to add, remove, list, and call MCP servers and tools. #54

Flexible Workflow Configuration

  • Fully customizable workflow definitions via agent.yml.
  • Configurable nodes, models, and database connections.
  • Support for sub-workflows and result selection to improve accuracy. #88

Context Exploration

  • Improve @catalogs to display all databases, schemas, and tables across multiple databases.
  • New @subject to show all metrics built with MetricFlow. #165
  • Context search tools integration to enhance recall of metadata and metrics. #138

User Behavior Logging

  • Automatic collection of user behavior logs.
  • Transforms human–computer interaction data into trainable datasets for future improvements.

0.2.1

New Features

  • Web Chatbot Upgrade - Added feedback collection, issue reporting, stream output, and &hide_sidebar=true parameter for embedding. docs
  • Context Generation Commands - New /gen_semantic_model, /gen_metrics, and /gen_sql_summary commands in subagents for dynamic knowledge base enrichment. #192 docs
  • Interactive Context Editing - Visual editing support for @catalog and @subject commands to modify semantic models, metrics, and SQL summaries. #219 #199 #175 docs
  • Scoped Knowledge Base - Subagents now support scoped KB initialization for better context isolation and management. #217

Enhancements

  • MetricFlow Integration - Load configuration from env_settings.yml, improved project detection, and cleaner output formatting. #214 #216 docs
  • Flexible Model Configuration - Support for multiple model providers and specifications in agent configuration. #195
  • CLI Display Improvements - Enhanced table width rendering for better SQL query readability. #200
  • Improved Initialization - Enhanced datus-agent init command with better error handling and setup flow. #194

Dependencies changes

  • openai-agents upgraded to 0.3.2 (requires manual update: pip install -U openai-agents)
  • datus-metricflow updated to 0.1.2

0.2.2

skipped

0.2.3

New Features

  • Embedded Tutorial Dataset - California Schools dataset now bundled with installation and integrated into datus-agent init workflow for hands-on learning of contextual data engineering. #277 tutorial
  • Enhanced Evaluation Framework - New evaluation command with expanded categories: Exact Match, Same Result Count (different values), Schema/Table Usage Match, and Semantic/Metric Layer Correctness. #264
  • Plugin-Based Database Connector - Refactored database connector to plugin-based architecture for easier extensibility and custom adapter development. #284

Enhancements

  • Simplified Installation - Removed legacy transformers dependency from default installation for faster setup and reduced package size. #247
  • Streamlined MetricFlow Configuration - Simplified configuration as MetricFlow now natively supports Datus config format. #243
  • Built-in Generation Commands - /gen_semantic_model, /gen_metrics, and /gen_sql_summary subagents now work out of the box without additional setup. #250
  • Agentic Node Integration - Workflow-based evaluations now support agentic nodes for more sophisticated testing scenarios. #262
  • Code Quality Improvements - Refactored tool modules and enhanced node logic. Unified bootstrap-kb and gen_semantic_model to use the same implementation. #245 #250
  • Optimized Embedding Storage - Refactored embedding model storage and updated dependencies for better performance. #247

Bug Fixes

  • Schema Metadata Handling - Fixed empty definition field in schema_linking command to ensure proper schema metadata is passed to downstream nodes. #327
  • Initialization Issues - Resolved multiple initialization bugs and corrected configuration file validation for tutorial mode. #304 #303
  • Environment Variable Compatibility - Fixed environment variable handling across different platforms for improved deployment compatibility. #294
  • Evaluation Summary Generation - Fixed summary generation in benchmark evaluation for more accurate evaluation reports. #314
  • FastEmbed Cache Directory - Fixed cache directory path for fastembed to resolve caching issues on different platforms. #251

0.1

0.1.0

Datus-cli

  • Supports connecting to SQLite, DuckDB, StarRocks, and Snowflake, and performing common command-line operations.
  • Supports three types of command extensions: !run_command, @context, and /chat to enhance development efficiency.

Datus-agent

  • Supports automatic NL2SQL generation using the React paradigm.
  • Supports retrieving database metadata and building vector-based search on metadata.
  • Supports deep reasoning via the MCP server.
  • Supports integration with bird-dev and spider2-snow benchmarks.
  • Supports saving and restoring workflows, allowing execution context and node inputs/outputs to be recorded.
  • Offers flexible configuration: you can define multiple models, databases, and node execution strategies in Agent.yaml.

0.1.2

Datus-cli

  • Add fix node, use !fix to quick fix the last sql with error, a simple template to make llm foucs on this task.

Datus-agent

  • Peroformance improvement for bootstrap-kb for multi-thread.
  • Other minor bugfixes.

0.1.3

Datus-cli

  • Added datus-init to initialize the ~/.datus/ directory.
  • Included a sample DuckDB database in ~/.datus/sample.

Datus-agent

  • Added the check_result option to the output node (default: False).

0.1.4

Datus-agent

  • Added the check-mcp command to confirm the MCP server configuration and availability.
  • Added support for both DuckDB and SQLite MCP servers.
  • Implemented automatic installation of the MCP server into the datus-mcp directory.

0.1.5

Datus-agent

  • Automated semantic layer generation.
  • Introduced a new internal workflow: metrics2SQL.
  • Added save_llm_trace to facilitate training dataset collection.

Datus-cli

  • Enhanced !reason and !gen_semantic_model commands for a more agentic and intuitive experience.