aiecs 1.1.0__tar.gz → 1.1.1__tar.gz

{aiecs-1.1.0/aiecs.egg-info → aiecs-1.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aiecs
-Version: 1.1.0
+Version: 1.1.1
 Summary: AI Execute Services - A middleware framework for AI-powered task execution and tool orchestration
 Author-email: AIECS Team <iretbl@gmail.com>
 License-Expression: MIT

{aiecs-1.1.0 → aiecs-1.1.1}/aiecs/__init__.py

@@ -5,7 +5,7 @@ A powerful Python middleware framework for building AI-powered applications
 with tool orchestration, task execution, and multi-provider LLM support.
 """
 
-__version__ = "1.1.0"
+__version__ = "1.1.1"
 __author__ = "AIECS Team"
 __email__ = "iretbl@gmail.com"
 

{aiecs-1.1.0 → aiecs-1.1.1}/aiecs/main.py

@@ -124,7 +124,7 @@ async def lifespan(app: FastAPI):
 app = FastAPI(
     title="AIECS - AI Execute Services",
     description="Middleware service for AI-powered task execution and tool orchestration",
-    version="1.1.0",    
+    version="1.1.1",    
     lifespan=lifespan
 )
 
@@ -149,7 +149,7 @@ async def health_check():
     return {
         "status": "healthy",
         "service": "aiecs",
-        "version": "1.1.0"
+        "version": "1.1.1"
     }
 
 

aiecs-1.1.1/aiecs/scripts/aid/VERSION_MANAGEMENT.md

@@ -0,0 +1,97 @@
+# AIECS 版本管理
+
+AIECS 提供了一个统一的版本管理工具，可以同时更新项目中所有相关文件的版本号。
+
+## 支持的文件
+
+版本管理工具会自动更新以下文件中的版本号：
+
+1. **`aiecs/__init__.py`** - 更新 `__version__` 变量
+2. **`aiecs/main.py`** - 更新 FastAPI 应用版本和健康检查端点版本
+3. **`pyproject.toml`** - 更新项目版本
+
+## 使用方法
+
+### 1. 显示当前版本
+
+```bash
+poetry run python -m aiecs.scripts.aid.version_manager --show
+```
+
+### 2. 设置特定版本
+
+```bash
+poetry run python -m aiecs.scripts.aid.version_manager --version 1.2.0
+```
+
+### 3. 自动递增版本
+
+#### 补丁版本 (Patch)
+```bash
+poetry run python -m aiecs.scripts.aid.version_manager --bump patch
+# 1.1.0 -> 1.1.1
+```
+
+#### 次版本 (Minor)
+```bash
+poetry run python -m aiecs.scripts.aid.version_manager --bump minor
+# 1.1.0 -> 1.2.0
+```
+
+#### 主版本 (Major)
+```bash
+poetry run python -m aiecs.scripts.aid.version_manager --bump major
+# 1.1.0 -> 2.0.0
+```
+
+## 版本号格式
+
+版本号遵循 [语义化版本控制](https://semver.org/) 规范：
+
+- **主版本号 (Major)**: 不兼容的API修改
+- **次版本号 (Minor)**: 向下兼容的功能性新增
+- **补丁版本号 (Patch)**: 向下兼容的问题修正
+
+格式：`X.Y.Z` (例如：1.2.3)
+
+## 命令行选项
+
+- `--version, -v`: 设置特定版本号
+- `--bump, -b`: 自动递增版本 (major/minor/patch)
+- `--show, -s`: 显示当前版本
+- `--help, -h`: 显示帮助信息
+
+## 示例
+
+```bash
+# 查看当前版本
+poetry run python -m aiecs.scripts.aid.version_manager --show
+
+# 发布补丁版本
+poetry run python -m aiecs.scripts.aid.version_manager --bump patch
+
+# 发布新功能版本
+poetry run python -m aiecs.scripts.aid.version_manager --bump minor
+
+# 发布重大更新版本
+poetry run python -m aiecs.scripts.aid.version_manager --bump major
+
+# 手动设置版本
+poetry run python -m aiecs.scripts.aid.version_manager --version 2.1.0
+```
+
+## 注意事项
+
+1. 版本管理工具会自动验证版本号格式
+2. 所有相关文件会同时更新，确保版本号一致性
+3. 更新前建议先提交当前更改到版本控制系统
+4. 工具会显示详细的更新日志，确认所有文件都已正确更新
+
+## 故障排除
+
+如果遇到问题，请检查：
+
+1. 确保在项目根目录下运行命令
+2. 确保所有目标文件存在且可写
+3. 检查版本号格式是否正确 (X.Y.Z)
+4. 确保没有其他进程正在编辑这些文件

aiecs-1.1.1/aiecs/scripts/aid/__init__.py

@@ -0,0 +1,15 @@
+"""
+AIECS Development Tools (AID)
+
+This module contains development and maintenance tools for the AIECS project.
+"""
+
+# Lazy import to avoid circular import issues
+def get_version_manager_main():
+    """Get the version manager main function"""
+    from .version_manager import main
+    return main
+
+__all__ = [
+    'get_version_manager_main',
+]

aiecs-1.1.1/aiecs/scripts/aid/version_manager.py

@@ -0,0 +1,224 @@
+#!/usr/bin/env python3
+"""
+AIECS Version Manager
+
+A script to manage version numbers across multiple files in the AIECS project.
+Updates version numbers in:
+- aiecs/__init__.py (__version__)
+- aiecs/main.py (FastAPI app version and health check version)
+- pyproject.toml (project version)
+
+Usage:
+    aiecs-version --version 1.2.0
+    aiecs-version --bump patch
+    aiecs-version --bump minor
+    aiecs-version --bump major
+    aiecs-version --show
+"""
+
+import argparse
+import re
+import sys
+from pathlib import Path
+from typing import Optional, Tuple
+
+
+class VersionManager:
+    """Manages version numbers across AIECS project files"""
+    
+    def __init__(self, project_root: Optional[Path] = None):
+        """Initialize the version manager with project root path"""
+        if project_root is None:
+            # Find project root by looking for pyproject.toml
+            current = Path(__file__).parent
+            while current != current.parent:
+                if (current / "pyproject.toml").exists():
+                    project_root = current
+                    break
+                current = current.parent
+            
+            if project_root is None:
+                raise RuntimeError("Could not find project root (pyproject.toml)")
+        
+        self.project_root = project_root
+        self.files = {
+            'init': project_root / "aiecs" / "__init__.py",
+            'main': project_root / "aiecs" / "main.py", 
+            'pyproject': project_root / "pyproject.toml"
+        }
+    
+    def get_current_version(self) -> str:
+        """Get the current version from __init__.py"""
+        init_file = self.files['init']
+        if not init_file.exists():
+            raise FileNotFoundError(f"Could not find {init_file}")
+        
+        content = init_file.read_text(encoding='utf-8')
+        match = re.search(r'__version__\s*=\s*["\']([^"\']+)["\']', content)
+        if not match:
+            raise ValueError("Could not find __version__ in __init__.py")
+        
+        return match.group(1)
+    
+    def parse_version(self, version: str) -> Tuple[int, int, int]:
+        """Parse version string into major, minor, patch components"""
+        match = re.match(r'^(\d+)\.(\d+)\.(\d+)$', version)
+        if not match:
+            raise ValueError(f"Invalid version format: {version}. Expected format: X.Y.Z")
+        
+        return int(match.group(1)), int(match.group(2)), int(match.group(3))
+    
+    def bump_version(self, current_version: str, bump_type: str) -> str:
+        """Bump version based on type (major, minor, patch)"""
+        major, minor, patch = self.parse_version(current_version)
+        
+        if bump_type == 'major':
+            major += 1
+            minor = 0
+            patch = 0
+        elif bump_type == 'minor':
+            minor += 1
+            patch = 0
+        elif bump_type == 'patch':
+            patch += 1
+        else:
+            raise ValueError(f"Invalid bump type: {bump_type}. Use 'major', 'minor', or 'patch'")
+        
+        return f"{major}.{minor}.{patch}"
+    
+    def update_init_file(self, new_version: str) -> None:
+        """Update version in aiecs/__init__.py"""
+        init_file = self.files['init']
+        content = init_file.read_text(encoding='utf-8')
+        
+        # Update __version__ line
+        content = re.sub(
+            r'(__version__\s*=\s*["\'])([^"\']+)(["\'])',
+            rf'\g<1>{new_version}\g<3>',
+            content
+        )
+        
+        init_file.write_text(content, encoding='utf-8')
+        print(f"✓ Updated {init_file.relative_to(self.project_root)}: __version__ = \"{new_version}\"")
+    
+    def update_main_file(self, new_version: str) -> None:
+        """Update version in aiecs/main.py"""
+        main_file = self.files['main']
+        content = main_file.read_text(encoding='utf-8')
+        
+        # Update FastAPI app version
+        content = re.sub(
+            r'(version=")([^"]+)(")',
+            rf'\g<1>{new_version}\g<3>',
+            content
+        )
+        
+        # Update health check version
+        content = re.sub(
+            r'("version":\s*")([^"]+)(")',
+            rf'\g<1>{new_version}\g<3>',
+            content
+        )
+        
+        main_file.write_text(content, encoding='utf-8')
+        print(f"✓ Updated {main_file.relative_to(self.project_root)}: FastAPI version and health check version")
+    
+    def update_pyproject_file(self, new_version: str) -> None:
+        """Update version in pyproject.toml"""
+        pyproject_file = self.files['pyproject']
+        content = pyproject_file.read_text(encoding='utf-8')
+        
+        # Update project version (only in [project] section, not in [project.scripts])
+        # Use a more specific pattern to avoid updating script entry points
+        content = re.sub(
+            r'^(\s*version\s*=\s*")([^"]+)(")',
+            rf'\g<1>{new_version}\g<3>',
+            content,
+            flags=re.MULTILINE
+        )
+        
+        pyproject_file.write_text(content, encoding='utf-8')
+        print(f"✓ Updated {pyproject_file.relative_to(self.project_root)}: project version")
+    
+    def update_version(self, new_version: str) -> None:
+        """Update version in all files"""
+        # Validate version format
+        self.parse_version(new_version)
+        
+        print(f"Updating version to {new_version}...")
+        print()
+        
+        # Update all files
+        self.update_init_file(new_version)
+        self.update_main_file(new_version)
+        self.update_pyproject_file(new_version)
+        
+        print()
+        print(f"✓ Successfully updated version to {new_version} in all files!")
+    
+    def show_version(self) -> None:
+        """Show current version"""
+        try:
+            version = self.get_current_version()
+            print(f"Current version: {version}")
+        except Exception as e:
+            print(f"Error getting current version: {e}", file=sys.stderr)
+            sys.exit(1)
+
+
+def main():
+    """Main entry point for the version manager"""
+    parser = argparse.ArgumentParser(
+        description="AIECS Version Manager - Update version numbers across project files",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  aiecs-version --version 1.2.0          # Set specific version
+  aiecs-version --bump patch             # Bump patch version (1.1.0 -> 1.1.1)
+  aiecs-version --bump minor             # Bump minor version (1.1.0 -> 1.2.0)
+  aiecs-version --bump major             # Bump major version (1.1.0 -> 2.0.0)
+  aiecs-version --show                   # Show current version
+        """
+    )
+    
+    # Create mutually exclusive group for version options
+    version_group = parser.add_mutually_exclusive_group(required=True)
+    version_group.add_argument(
+        '--version', '-v',
+        type=str,
+        help='Set specific version (e.g., 1.2.0)'
+    )
+    version_group.add_argument(
+        '--bump', '-b',
+        choices=['major', 'minor', 'patch'],
+        help='Bump version: major (X.0.0), minor (X.Y.0), or patch (X.Y.Z)'
+    )
+    version_group.add_argument(
+        '--show', '-s',
+        action='store_true',
+        help='Show current version'
+    )
+    
+    args = parser.parse_args()
+    
+    try:
+        manager = VersionManager()
+        
+        if args.show:
+            manager.show_version()
+        elif args.version:
+            manager.update_version(args.version)
+        elif args.bump:
+            current_version = manager.get_current_version()
+            new_version = manager.bump_version(current_version, args.bump)
+            print(f"Bumping {args.bump} version: {current_version} -> {new_version}")
+            print()
+            manager.update_version(new_version)
+    
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == '__main__':
+    main()

{aiecs-1.1.0 → aiecs-1.1.1}/aiecs/tools/__init__.py

@@ -11,25 +11,25 @@ from aiecs.tools.base_tool import BaseTool
 
 logger = logging.getLogger(__name__)
 
-# 全局工具注册表
+# Global tool registry
 TOOL_REGISTRY = {}
 TOOL_CLASSES = {}
 TOOL_CONFIGS = {}
 
 def register_tool(name):
     """
-    装饰器，用于注册工具类
+    Decorator for registering tool classes
 
     Args:
-        name: 工具名称
+        name: Tool name
 
     Returns:
-        装饰后的类
+        Decorated class
     """
     def wrapper(cls):
-        # 存储工具类，但不立即实例化
+        # Store tool class but don't instantiate immediately
         TOOL_CLASSES[name] = cls
-        # 兼容旧版本：如果类继承自BaseTool，则不立即实例化
+        # Backward compatibility: if class inherits from BaseTool, don't instantiate immediately
         if not issubclass(cls, BaseTool):
             TOOL_REGISTRY[name] = cls()
         return cls
@@ -37,25 +37,25 @@ def register_tool(name):
 
 def get_tool(name):
     """
-    获取工具实例
+    Get tool instance
 
     Args:
-        name: 工具名称
+        name: Tool name
 
     Returns:
-        工具实例
+        Tool instance
 
     Raises:
-        ValueError: 如果工具未注册
+        ValueError: If tool is not registered
     """
-    # 检查是否需要替换占位符或延迟实例化
+    # Check if placeholder needs to be replaced or lazy instantiation is needed
     if name in TOOL_CLASSES:
-        # 如果 TOOL_REGISTRY 中是占位符，或者不存在，则实例化真实工具类
+        # If TOOL_REGISTRY contains placeholder or doesn't exist, instantiate real tool class
         current_tool = TOOL_REGISTRY.get(name)
         is_placeholder = getattr(current_tool, 'is_placeholder', False)
 
         if current_tool is None or is_placeholder:
-            # 延迟实例化BaseTool子类，替换占位符
+            # Lazy instantiation of BaseTool subclasses, replace placeholder
             tool_class = TOOL_CLASSES[name]
             config = TOOL_CONFIGS.get(name, {})
             TOOL_REGISTRY[name] = tool_class(config)
@@ -68,17 +68,17 @@ def get_tool(name):
 
 def list_tools():
     """
-    列出所有已注册的工具
+    List all registered tools
 
     Returns:
-        工具信息字典列表
+        List of tool information dictionaries
     """
     tools = []
     all_tool_names = list(set(list(TOOL_REGISTRY.keys()) + list(TOOL_CLASSES.keys())))
     
     for tool_name in all_tool_names:
         try:
-            # 优先使用已有实例的信息
+            # Prefer using information from existing instances
             if tool_name in TOOL_REGISTRY:
                 tool_instance = TOOL_REGISTRY[tool_name]
                 tool_info = {
@@ -90,7 +90,7 @@ def list_tools():
                     "status": "loaded"
                 }
             elif tool_name in TOOL_CLASSES:
-                # 从类定义获取信息，但不实例化
+                # Get information from class definition but don't instantiate
                 tool_class = TOOL_CLASSES[tool_name]
                 tool_info = {
                     "name": tool_name,
@@ -107,7 +107,7 @@ def list_tools():
             
         except Exception as e:
             logger.warning(f"Failed to get info for tool {tool_name}: {e}")
-            # 提供基本信息
+            # Provide basic information
             tools.append({
                 "name": tool_name,
                 "description": f"{tool_name} (info unavailable)",
@@ -121,26 +121,26 @@ def list_tools():
 
 def discover_tools(package_path: str = "aiecs.tools"):
     """
-    发现并注册包中的所有工具
+    Discover and register all tools in the package
 
     Args:
-        package_path: 要搜索的包路径
+        package_path: Package path to search
     """
     package = importlib.import_module(package_path)
     package_dir = os.path.dirname(package.__file__)
 
     for _, module_name, is_pkg in pkgutil.iter_modules([package_dir]):
         if is_pkg:
-            # 递归搜索子包中的工具
+            # Recursively search for tools in subpackages
             discover_tools(f"{package_path}.{module_name}")
         else:
-            # 导入模块
+            # Import module
             try:
                 importlib.import_module(f"{package_path}.{module_name}")
             except Exception as e:
                 logger.error(f"Error importing module {module_name}: {e}")
 
-# 导入基础工具类供继承使用
+# Import base tool class for inheritance
 from aiecs.tools.base_tool import BaseTool
 
 # Lazy loading strategy: don't import all tools at package init

{aiecs-1.1.0 → aiecs-1.1.1}/aiecs/tools/docs/__init__.py

@@ -30,6 +30,9 @@ def _lazy_load_doc_tool(tool_name: str):
     if tool_name in _LOADED_DOC_TOOLS:
         return
     
+    # Mark as loading to prevent infinite recursion
+    _LOADED_DOC_TOOLS.add(tool_name)
+    
     try:
         if tool_name == 'document_parser_tool':
             from . import document_parser_tool
@@ -53,9 +56,9 @@ def _lazy_load_doc_tool(tool_name: str):
             from . import content_insertion_tool
             globals()['content_insertion_tool'] = content_insertion_tool
         
-        _LOADED_DOC_TOOLS.add(tool_name)
-        
     except ImportError as e:
+        # Remove from loaded set if import failed
+        _LOADED_DOC_TOOLS.discard(tool_name)
         print(f"Warning: Could not import {tool_name}: {e}")
 
 def __getattr__(name: str):