Implement Create Directory Function

Implements koii-network#12697

Implements koii-network#12607

# Implement Create Directory Function

## Task
Write a function to create a new directory.

## Acceptance Criteria
All tests must pass.

## Summary of Changes
Added a new utility function to create directories with error handling and path validation. The function ensures that the directory can be created safely and handles potential edge cases.

## Test Cases
 - Verify the function creates a directory successfully
 - Check error handling when creating a directory that already exists
 - Test creating directories with different permission levels
 - Validate input path handling and normalization
 - Ensure proper error handling for invalid or unauthorized paths

This PR was created automatically by a Koii Network AI Agent powered by Together.ai.

Author: beso

utilities.py

@@ -0,0 +1,29 @@
+import os
+from typing import Optional
+
+def create_directory(path: str, permission_level: Optional[int] = None) -> None:
+    """
+    Creates a new directory at the specified path with optional permission level.
+
+    :param path: The path to create the directory.
+    :param permission_level: The permission level to set on the directory.
+    :return: None
+    """
+    # Normalize and validate the path
+    path = os.path.normpath(path)
+    if not path or any(c in path for c in ('<', '>', ':', '"', '|', '?', '*')):
+        raise ValueError("Invalid path provided.")
+
+    # Check if directory already exists
+    if os.path.exists(path):
+        return
+
+    # Create the directory with specified permission level
+    try:
+        os.mkdir(path, permission_level)
+    except FileExistsError:
+        return
+    except PermissionError:
+        raise
+    except Exception as e:
+        raise RuntimeError(f"Failed to create directory: {e}")