Validate input length in generate_id utility (#460)

Author: DunuraWitharama

agentlightning/utils/id.py

@@ -7,12 +7,18 @@
 
 
 def generate_id(length: int) -> str:
-    """Generate a random ID of the given length.
+    """Generate a random hexadecimal ID of the given length.
 
     Args:
-        length: The length of the ID to generate.
+        length: The desired length of the generated ID. Must be a positive integer.
 
     Returns:
-        A random ID of the given length.
+        A random hexadecimal ID string of the given length.
+
+    Raises:
+        ValueError: If length is not a positive integer.
     """
+    if length <= 0:
+        raise ValueError("length must be a positive integer")
+
     return hashlib.sha1(uuid.uuid4().bytes).hexdigest()[:length]