mcpower-proxy 0.0.67__py3-none-any.whl → 0.0.77__py3-none-any.whl

modules/utils/ids.py

@@ -24,6 +24,16 @@ def generate_event_id() -> str:
     return f"{timestamp}-{unique_part}"
 
 
+def generate_prompt_id() -> str:
+    """
+    Generate truly-random 8-character prompt ID for user request correlation
+    
+    Returns:
+        8-character random ID string
+    """
+    return str(uuid.uuid4())[:8]
+
+
 def get_session_id() -> str:
     """
     Get session ID for the current process. Returns the same value for all calls
@@ -109,20 +119,53 @@ def _get_or_create_uuid(uid_path: Path, logger, id_type: str) -> str:
                     time.sleep(0.1 * (2 ** attempt))
                     continue
                 raise
-        
+
         new_uid = str(uuid.uuid4())
-        
+
         if _atomic_write_uuid(uid_path, new_uid):
             logger.info(f"Generated {id_type}: {new_uid} at {uid_path}")
             return new_uid
-        
-        logger.debug(f"{id_type.title()} file created by another process, reading (attempt {attempt + 1}/{max_attempts})")
+
+        logger.debug(
+            f"{id_type.title()} file created by another process, reading (attempt {attempt + 1}/{max_attempts})")
         if attempt < max_attempts - 1:
             time.sleep(0.05)
-    
+
     raise RuntimeError(f"Failed to get or create {id_type} after {max_attempts} attempts")
 
 
+def get_home_mcpower_dir() -> Path:
+    """
+    Get the global MCPower directory path in user's home directory
+    
+    Returns:
+        Path to ~/.mcpower directory
+    """
+    return Path.home() / ".mcpower"
+
+
+def get_project_mcpower_dir(project_path: Optional[str] = None) -> str:
+    """
+    Get the MCPower directory path, with fallback to global ~/.mcpower
+
+    Args:
+        project_path: Optional project/workspace path. If None or invalid, falls back to ~/.mcpower
+
+    Returns:
+        Path to use for MCPower data (either project/.mcpower or ~/.mcpower)
+    """
+    if project_path:
+        try:
+            path = Path(project_path)
+            if path.exists() and path.is_dir():
+                return str(path)
+        except Exception:
+            pass
+
+    # Fallback to global ~/.mcpower
+    return str(get_home_mcpower_dir())
+
+
 def get_or_create_user_id(logger) -> str:
     """
     Get or create machine-wide user ID from ~/.mcpower/uid
@@ -134,7 +177,7 @@ def get_or_create_user_id(logger) -> str:
     Returns:
         User ID string
     """
-    uid_path = Path.home() / ".mcpower" / "uid"
+    uid_path = get_home_mcpower_dir() / "uid"
     return _get_or_create_uuid(uid_path, logger, "user ID")
 
 
@@ -158,5 +201,5 @@ def read_app_uid(logger, project_folder_path: str) -> str:
     else:
         # Project-specific case
         uid_path = project_path / ".mcpower" / "app_uid"
-    
+
     return _get_or_create_uuid(uid_path, logger, "app UID")

modules/utils/json.py

@@ -52,7 +52,7 @@ def safe_json_dumps(obj: Any, **kwargs) -> str:
     # If it's a Pydantic BaseModel, use its built-in JSON serialization
     if isinstance(obj, BaseModel):
         return obj.model_dump_json(**kwargs)
-    
+
     # If it's a dict or list that might contain Pydantic objects, use custom serializer
     def default_serializer(o):
         if isinstance(o, BaseModel):
@@ -72,7 +72,7 @@ def safe_json_dumps(obj: Any, **kwargs) -> str:
             return o.__dict__
         # Fallback to string representation
         return str(o)
-    
+
     return json.dumps(obj, default=default_serializer, **kwargs)
 
 
@@ -117,4 +117,4 @@ def parse_jsonc(text: str) -> Any:
             return json.loads(text)
         except json.JSONDecodeError:
             # Re-raise the original JSONC error if JSON also fails
-            raise json.JSONDecodeError(f"JSONC parsing failed: {str(e)}", text, 0)
+            raise json.JSONDecodeError(f"JSONC parsing failed: {str(e)}", text, 0)

modules/utils/platform.py

@@ -0,0 +1,23 @@
+"""Platform detection utilities"""
+import sys
+from typing import Optional, Literal
+
+
+def get_client_os() -> Optional[Literal["macos", "windows", "linux"]]:
+    """
+    Fetch Python's sys.platform and convert to standardized OS names.
+    
+    Returns:
+        "macos", "windows", "linux", or None if platform is unknown
+    """
+    platform = sys.platform
+    
+    if platform == "darwin":
+        return "macos"
+    elif platform == "win32":
+        return "windows"
+    elif platform == "linux":
+        return "linux"
+    else:
+        return None
+

modules/utils/string.py

@@ -0,0 +1,17 @@
+"""String utility functions"""
+
+
+def truncate_at(text: str, max_length: int) -> str:
+    """
+    Truncate string at max_length, appending '...' only if truncated.
+    
+    Args:
+        text: String to truncate
+        max_length: Maximum length before truncation
+        
+    Returns:
+        Truncated string with '...' suffix if truncated, original if not
+    """
+    if len(text) <= max_length:
+        return text
+    return f"{text[:max_length]}..."

wrapper/__version__.py

@@ -3,4 +3,4 @@
 Wrapper MCP Server Version
 """
 
-__version__ = "0.0.67"
+__version__ = "0.0.77"