[1.1.3]

Signed-off-by: OEvortex <abhat8283@gmail.com>

Author: OEvortex

CHANGELOG.md

@@ -0,0 +1,62 @@
+# Changelog
+
+All notable changes to the HelpingAI Python SDK will be documented in this file.
+
+## [1.1.3] - 2025-07-18
+
+### Added
+- **🔧 Tool Calling Framework**: New [`@tools decorator`](HelpingAI/tools/core.py:144) for effortless tool creation
+- **🤖 Automatic Schema Generation**: Type hint-based JSON schema creation with docstring parsing
+- **📝 Smart Documentation**: Multi-format docstring parsing (Google, Sphinx, NumPy styles)
+- **🧠 Thread-Safe Tool Registry**: Reliable tool management in multi-threaded environments
+- **🔍 Tool Validation**: Automatic parameter validation against JSON schema
+- **Extended Python Support**: Now supports Python 3.7-3.14
+- **Streaming Support**: Real-time response streaming
+- **Advanced Filtering**: Hide reasoning blocks with `hide_think` parameter
+- New comprehensive [Tool Calling Guide](docs/tool_calling.md)
+
+### Changed
+- **🔄 Universal Compatibility**: Seamless integration with existing OpenAI-format tools
+- **Updated Models**: Support for latest models (Dhanishtha-2.0-preview, Dhanishtha-2.0-preview-mini)
+- **Improved Model Management**: Better fallback handling and detailed model descriptions
+- Deprecated `get_tools_format()` in favor of `get_tools()`
+- Updated documentation to reflect current model names and best practices
+
+### Enhanced
+- **🛡️ Enhanced Tool Error Handling**: Comprehensive exception types for tool operations
+- **Dhanishtha-2.0 Integration**: World's first intermediate thinking model with multi-phase reasoning
+- **Dhanishtha Models**: Advanced reasoning capabilities with transparent thinking processes
+- **OpenAI-Compatible Interface**: Familiar API design
+- **Enhanced Error Handling**: Comprehensive exception types
+
+## [1.1.2] - 2025-06-15
+
+### Added
+- Support for Dhanishtha-2.0-preview model
+- Improved error handling for API requests
+- Enhanced streaming capabilities
+
+### Fixed
+- Various bug fixes and performance improvements
+
+## [1.1.1] - 2025-05-20
+
+### Added
+- Initial support for tool calling
+- Enhanced type hints for better IDE support
+
+### Fixed
+- Connection handling for unstable networks
+- Token counting accuracy
+
+## [1.1.0] - 2025-04-10
+
+### Added
+- Initial public release
+- Support for chat completions
+- Basic streaming functionality
+- Error handling framework
+
+---
+
+For more details, see the [documentation](docs/) or [GitHub repository](https://github.com/HelpingAI/HelpingAI-python).

HelpingAI/tools/__init__.py

@@ -3,6 +3,12 @@
 
 This module provides decorators and utilities for creating standard
 tool definitions from Python functions with minimal boilerplate.
+
+Key components:
+- @tools decorator: Transform Python functions into AI-callable tools
+- Fn class: Represent callable functions with metadata
+- get_tools(): Get registered tools (preferred over get_tools_format)
+- get_registry(): Access the tool registry for advanced management
 """
 
 from .core import Fn, tools, get_tools, get_tools_format, clear_registry, get_registry
@@ -23,7 +29,7 @@
     get_compatibility_warnings
 )
 
-__version__ = "1.1.0"
+__version__ = "1.1.3"
 
 __all__ = [
     # Core classes and functions

HelpingAI/tools/compatibility.py

@@ -228,7 +228,7 @@ def is_fn_object(obj: Any) -> bool:
     Returns:
         True if object is an Fn instance
     """
-    return hasattr(obj, 'to_openai_tool') and hasattr(obj, 'call')
+    return hasattr(obj, 'to_tool_format') and hasattr(obj, 'call')
 
 
 def normalize_tool_choice(

HelpingAI/tools/core.py

@@ -195,16 +195,22 @@ def get_tools(names: List[str] = None) -> List[Fn]:
     return _get_global_registry().get_tools(names)
 
 
-def get_tools_format(names: List[str] = None) -> List[Dict[str, Any]]:
+def get_tools_format(names: List[str] = None, category: str = None) -> List[Dict[str, Any]]:
     """Get tools in standard tool format.
     
     Args:
         names: Specific tool names to retrieve
+        category: Category name to filter tools (optional)
         
     Returns:
         List of tool definitions in standard format
     """
     tools_list = get_tools(names)
+    
+    # Filter by category if provided
+    if category and hasattr(tools_list[0], 'category'):
+        tools_list = [tool for tool in tools_list if tool.category == category]
+        
     return [tool.to_tool_format() for tool in tools_list]
 
 

HelpingAI/version.py

@@ -1,2 +1,2 @@
 """Version information."""
-VERSION = "1.1.2"
+VERSION = "1.1.3"

README.md

@@ -52,7 +52,7 @@ hai = HAI()
 
 # Create a chat completion
 response = hai.chat.completions.create(
-    model="Helpingai3-raw",
+    model="Dhanishtha-2.0-preview",
     messages=[
         {"role": "system", "content": "You are an expert in emotional intelligence."},
         {"role": "user", "content": "What makes a good leader?"}
@@ -67,7 +67,7 @@ print(response.choices[0].message.content)
 ```python
 # Stream responses in real-time
 for chunk in hai.chat.completions.create(
-    model="Helpingai3-raw",
+    model="Dhanishtha-2.0-preview",
     messages=[{"role": "user", "content": "Tell me about empathy"}],
     stream=True
 ):
@@ -113,7 +113,7 @@ def make_completion_with_retry(messages, max_retries=3):
     for attempt in range(max_retries):
         try:
             return hai.chat.completions.create(
-                model="Helpingai3-raw",
+                model="Dhanishtha-2.0-preview",
                 messages=messages
             )
         except RateLimitError as e:
@@ -130,24 +130,24 @@ def make_completion_with_retry(messages, max_retries=3):
 
 ## 🤖 Available Models
 
-### Helpingai3-raw
-- **Advanced Emotional Intelligence**: Enhanced emotional understanding and contextual awareness
-- **Training Data**: 15M emotional dialogues, 3M therapeutic exchanges, 250K cultural conversations, 1M crisis response scenarios
-- **Best For**: AI companionship, emotional support, therapy guidance, personalized learning
-
 ### Dhanishtha-2.0-preview
 - **World's First Intermediate Thinking Model**: Multi-phase reasoning with self-correction capabilities
 - **Unique Features**: `<think>...</think>` blocks for transparent reasoning, structured emotional reasoning (SER)
 - **Best For**: Complex problem-solving, analytical tasks, educational content, reasoning-heavy applications
 
+### Dhanishtha-2.0-preview-mini
+- **Lightweight Reasoning Model**: Efficient version of Dhanishtha-2.0-preview
+- **Unique Features**: Same reasoning capabilities in a more compact model
+- **Best For**: Faster responses, mobile applications, resource-constrained environments
+
 ```python
 # List all available models
 models = hai.models.list()
 for model in models:
     print(f"Model: {model.id} - {model.description}")
 
 # Get specific model info
-model = hai.models.retrieve("Helpingai3-raw")
+model = hai.models.retrieve("Dhanishtha-2.0-preview")
 print(f"Model: {model.name}")
 
 # Use Dhanishtha-2.0 for complex reasoning
@@ -165,7 +165,7 @@ Transform any Python function into a powerful AI tool with zero boilerplate usin
 
 ```python
 from HelpingAI import HAI
-from HelpingAI.tools import tools, get_tools_format
+from HelpingAI.tools import tools, get_tools
 
 @tools
 def get_weather(city: str, units: str = "celsius") -> str:
@@ -193,9 +193,9 @@ def calculate_tip(bill_amount: float, tip_percentage: float = 15.0) -> dict:
 # Use with chat completions
 hai = HAI()
 response = hai.chat.completions.create(
-    model="Helpingai3-raw",
+    model="Dhanishtha-2.0-preview",
     messages=[{"role": "user", "content": "What's the weather in Paris and calculate tip for $50 bill?"}],
-    tools=get_tools_format()  # Automatically includes all @tools functions
+    tools=get_tools()  # Automatically includes all @tools functions
 )
 
 print(response.choices[0].message.content)
@@ -286,13 +286,13 @@ legacy_tools = [{
 # Combine with @tools functions
 combined_tools = merge_tool_lists(
     legacy_tools,           # Existing tools
-    get_tools_format(),     # @tools functions
+    get_tools(),            # @tools functions
     "math"                  # Category name (if you have categorized tools)
 )
 
 # Use in chat completion
 response = hai.chat.completions.create(
-    model="Helpingai3-raw",
+    model="Dhanishtha-2.0-preview",
     messages=[{"role": "user", "content": "Help me with weather, calculations, and web search"}],
     tools=combined_tools
 )
@@ -396,32 +396,10 @@ Comprehensive documentation is available:
 
 - [📖 Getting Started Guide](docs/getting_started.md) - Installation and basic usage
 - [🔧 API Reference](docs/api_reference.md) - Complete API documentation
+- [🛠️ Tool Calling Guide](docs/tool_calling.md) - Creating and using AI-callable tools
 - [💡 Examples](docs/examples.md) - Code examples and use cases
 - [❓ FAQ](docs/faq.md) - Frequently asked questions
 
-## 🏗️ Project Structure
-
-```
-HelpingAI-python/
-├── HelpingAI/              # Main package
-│   ├── __init__.py         # Package initialization
-│   ├── client.py           # Main HAI client
-│   ├── models.py           # Model management
-│   ├── base_models.py      # Data models
-│   ├── error.py            # Exception classes
-│   ├── version.py          # Version information
-│   └── tools/              # Tool calling utilities
-│       ├── __init__.py     # Tools module exports
-│       ├── core.py         # @tools decorator and Fn class
-│       ├── schema.py       # Automatic schema generation
-│       ├── registry.py     # Tool registry management
-│       ├── compatibility.py # Format conversion utilities
-│       └── errors.py       # Tool-specific exceptions
-├── docs/                   # Documentation
-├── tests/                  # Test suite
-├── setup.py               # Package configuration
-└── README.md              # This file
-```
 
 ## 🔧 Requirements
 
@@ -449,26 +427,8 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 - **Issues**: [GitHub Issues](https://github.com/HelpingAI/HelpingAI-python/issues)
 - **Documentation**: [HelpingAI Docs](https://helpingai.co/docs)
 - **Dashboard**: [HelpingAI Dashboard](https://helpingai.co/dashboard)
-- **Email**: varun@helpingai.co
-
-## 🚀 What's New in v1.1.0
-
-- **🔧 Tool Calling Framework**: New [`@tools decorator`](HelpingAI/tools/core.py:144) for effortless tool creation
-- **🤖 Automatic Schema Generation**: Type hint-based JSON schema creation with docstring parsing
-- **🔄 Universal Compatibility**: Seamless integration with existing OpenAI-format tools
-- **📝 Smart Documentation**: Multi-format docstring parsing (Google, Sphinx, NumPy styles)
-- **🛡️ Enhanced Tool Error Handling**: Comprehensive exception types for tool operations
-- **Extended Python Support**: Now supports Python 3.7-3.14
-- **Updated Models**: Support for latest models (Helpingai3-raw, Dhanishtha-2.0-preview)
-- **Dhanishtha-2.0 Integration**: World's first intermediate thinking model with multi-phase reasoning
-- **HelpingAI3 Support**: Enhanced emotional intelligence with advanced contextual awareness
-- **Improved Model Management**: Better fallback handling and detailed model descriptions
-- **OpenAI-Compatible Interface**: Familiar API design
-- **Enhanced Error Handling**: Comprehensive exception types
-- **Streaming Support**: Real-time response streaming
-- **Advanced Filtering**: Hide reasoning blocks with `hide_think` parameter
+- **Email**: Team@helpingai.co
 
----
 
 **Built with ❤️ by the HelpingAI Team**
 

docs/api_reference.md

@@ -94,7 +94,7 @@ def create(
 
 | Parameter | Type | Description |
 |-----------|------|-------------|
-| `model` | `str` | Model ID to use (e.g., "Helpingai3-raw", "Dhanishtha-2.0-preview") |
+| `model` | `str` | Model ID to use (e.g., "Dhanishtha-2.0-preview", "Dhanishtha-2.0-preview-mini") |
 | `messages` | `List[Dict[str, str]]` | List of message objects with "role" and "content" |
 
 **Optional Parameters:**
@@ -128,7 +128,7 @@ def create(
 ```python
 # Basic completion
 response = hai.chat.completions.create(
-    model="Helpingai3-raw",
+    model="Dhanishtha-2.0-preview",
     messages=[
         {"role": "user", "content": "Hello!"}
     ]
@@ -151,7 +151,7 @@ response = hai.chat.completions.create(
 
 # Streaming completion
 for chunk in hai.chat.completions.create(
-    model="Helpingai3-raw",
+    model="Dhanishtha-2.0-preview",
     messages=[{"role": "user", "content": "Tell me a story"}],
     stream=True
 ):
@@ -198,7 +198,7 @@ def retrieve(model_id: str) -> Model
 **Example:**
 
 ```python
-model = hai.models.retrieve("Helpingai3-raw")
+model = hai.models.retrieve("Dhanishtha-2.0-preview")
 print(f"Model: {model.name}")
 ```
 
@@ -461,7 +461,7 @@ import time
 def handle_completion_errors():
     try:
         response = hai.chat.completions.create(
-            model="Helpingai3-raw",
+            model="Dhanishtha-2.0-preview",
             messages=[{"role": "user", "content": "Hello"}]
         )
         return response
@@ -611,7 +611,7 @@ except Exception as e:
 def stream_completion(prompt: str):
     try:
         stream = hai.chat.completions.create(
-            model="Helpingai3-raw",
+            model="Dhanishtha-2.0-preview",
             messages=[{"role": "user", "content": prompt}],
             stream=True,
             hide_think=True