osbot-utils 2.88.0__py3-none-any.whl → 2.89.0__py3-none-any.whl

osbot_utils/helpers/duration/decorators/capture_duration.py

@@ -1,5 +1,4 @@
 import time
-
 from osbot_utils.type_safe.Type_Safe import Type_Safe
 
 

osbot_utils/helpers/html/schemas/Schema__Html_Node__Data__Type.py

@@ -1,4 +1,4 @@
 from enum import Enum
 
-class Schema__Html_Node__Data__Type(Enum):
+class Schema__Html_Node__Data__Type(str, Enum):
     TEXT : str = 'text'

osbot_utils/helpers/llms/builders/LLM_Request__Builder.py

@@ -1,14 +1,14 @@
-from typing                                                                 import Dict, Any, Type
-from osbot_utils.helpers.llms.actions.Type_Safe__Schema_For__LLMs           import Type_Safe__Schema_For__LLMs
-from osbot_utils.helpers.llms.schemas.Safe_Str__LLM__Model_Name             import Safe_Str__LLM__Model_Name
-from osbot_utils.helpers.llms.schemas.Schema__LLM_Request                   import Schema__LLM_Request
-from osbot_utils.helpers.llms.schemas.Schema__LLM_Request__Data             import Schema__LLM_Request__Data
-from osbot_utils.helpers.llms.schemas.Schema__LLM_Request__Function_Call    import Schema__LLM_Request__Function_Call
-from osbot_utils.helpers.llms.schemas.Schema__LLM_Request__Message__Content import Schema__LLM_Request__Message__Content
-from osbot_utils.helpers.llms.schemas.Schema__LLM_Request__Message__Role    import Schema__LLM_Request__Message__Role
-from osbot_utils.type_safe.Type_Safe                                        import Type_Safe
-from osbot_utils.type_safe.primitives.safe_str.text.Safe_Str__Text          import Safe_Str__Text
-from osbot_utils.type_safe.type_safe_core.decorators.type_safe              import type_safe
+from typing                                                                  import Dict, Any, Type
+from osbot_utils.helpers.llms.actions.Type_Safe__Schema_For__LLMs            import Type_Safe__Schema_For__LLMs
+from osbot_utils.type_safe.primitives.safe_str.llm.Safe_Str__LLM__Model_Name import Safe_Str__LLM__Model_Name
+from osbot_utils.helpers.llms.schemas.Schema__LLM_Request                    import Schema__LLM_Request
+from osbot_utils.helpers.llms.schemas.Schema__LLM_Request__Data              import Schema__LLM_Request__Data
+from osbot_utils.helpers.llms.schemas.Schema__LLM_Request__Function_Call     import Schema__LLM_Request__Function_Call
+from osbot_utils.helpers.llms.schemas.Schema__LLM_Request__Message__Content  import Schema__LLM_Request__Message__Content
+from osbot_utils.helpers.llms.schemas.Schema__LLM_Request__Message__Role     import Schema__LLM_Request__Message__Role
+from osbot_utils.type_safe.Type_Safe                                         import Type_Safe
+from osbot_utils.type_safe.primitives.safe_str.text.Safe_Str__Text           import Safe_Str__Text
+from osbot_utils.type_safe.type_safe_core.decorators.type_safe               import type_safe
 
 
 class LLM_Request__Builder(Type_Safe):

osbot_utils/helpers/llms/schemas/Schema__LLM_Request__Data.py

@@ -1,9 +1,9 @@
-from typing                                                                 import List, Optional
-from osbot_utils.helpers.llms.schemas.Safe_Str__LLM__Model_Name             import Safe_Str__LLM__Model_Name
-from osbot_utils.helpers.llms.schemas.Schema__LLM_Request__Function_Call    import Schema__LLM_Request__Function_Call
-from osbot_utils.helpers.llms.schemas.Schema__LLM_Request__Message__Content import Schema__LLM_Request__Message__Content
-from osbot_utils.type_safe.Type_Safe                                        import Type_Safe
-from osbot_utils.type_safe.primitives.safe_str.text.Safe_Str__Text         import Safe_Str__Text
+from typing                                                                     import List, Optional
+from osbot_utils.helpers.llms.schemas.Schema__LLM_Request__Function_Call        import Schema__LLM_Request__Function_Call
+from osbot_utils.helpers.llms.schemas.Schema__LLM_Request__Message__Content     import Schema__LLM_Request__Message__Content
+from osbot_utils.type_safe.Type_Safe                                            import Type_Safe
+from osbot_utils.type_safe.primitives.safe_str.llm.Safe_Str__LLM__Model_Name    import Safe_Str__LLM__Model_Name
+from osbot_utils.type_safe.primitives.safe_str.text.Safe_Str__Text              import Safe_Str__Text
 
 
 class Schema__LLM_Request__Data(Type_Safe):                                         # Schema for LLM API request data

osbot_utils/type_safe/primitives/safe_str/Safe_Str.py

@@ -8,16 +8,16 @@ TYPE_SAFE__STR__MAX_LENGTH      = 512
 
 
 class Safe_Str(Type_Safe__Primitive, str):
+    allow_all_replacement_char: bool                       = True
+    allow_empty               : bool                       = True                # note: making this False does cause some side effects on .json() on cases like auto serialization in environments like FastAPI (like it requires more explict value setting), so all have now been converted into a value of True
+    exact_length              : bool                       = False               # If True, require exact length match, not just max length
     max_length                : int                        = TYPE_SAFE__STR__MAX_LENGTH
     regex                     : re.Pattern                 = TYPE_SAFE__STR__REGEX__SAFE_STR
     regex_mode                : Enum__Safe_Str__Regex_Mode = Enum__Safe_Str__Regex_Mode.REPLACE
     replacement_char          : str                        = '_'
-    allow_empty               : bool                       = True                # note: making this False does cause some side effects on .json() on cases like auto serialization in environments like FastAPI (like it requires more explict value setting), so all have now been converted into a value of True
-    trim_whitespace           : bool                       = False
-    allow_all_replacement_char: bool                       = True
     strict_validation         : bool                       = False               # If True, don't replace invalid chars, raise an error instead
-    exact_length              : bool                       = False               # If True, require exact length match, not just max length
-
+    to_lower_case             : bool                       = False               # If True, convert string to lowercase
+    trim_whitespace           : bool                       = False
 
     def __new__(cls, value: Optional[str] = None) -> 'Safe_Str':
 
@@ -46,6 +46,8 @@ class Safe_Str(Type_Safe__Primitive, str):
 
         sanitized_value = cls.validate_and_sanitize(value)
 
+        if cls.to_lower_case:
+            sanitized_value = sanitized_value.lower()
 
         return str.__new__(cls, sanitized_value)
 

osbot_utils/type_safe/primitives/safe_str/llm/Enum__LLM__Role.py

@@ -0,0 +1,10 @@
+from enum import Enum
+
+class Enum__LLM__Role(str, Enum): # Extended roles for specific providers
+    SYSTEM    = "system"
+    USER      = "user"
+    ASSISTANT = "assistant"
+    TOOL      = "tool"
+
+    def __str__(self):
+        return self.value  # Override to return the value

osbot_utils/type_safe/primitives/safe_str/llm/Safe_Str__LLM__Description.py

@@ -0,0 +1,14 @@
+import re
+from osbot_utils.type_safe.primitives.safe_str.Safe_Str import Safe_Str
+
+class Safe_Str__LLM__Description(Safe_Str):                                            # LLM model or feature description
+    max_length = 4096
+    regex      = re.compile(r'[^a-zA-Z0-9_ ()\[\]\-+=:;,.?*/\\×\n`&"\'#%<>{}$@|!\s~]')  # Allows common description chars
+
+    # Supports rich descriptions with:
+    # - Basic punctuation and formatting
+    # - Mathematical symbols (×, +, -)
+    # - Common special characters for technical descriptions
+    # - Newlines for multi-line descriptions
+    # - Brackets for annotations [like this]
+    # - Quotes for "emphasis" or 'terms'

osbot_utils/type_safe/primitives/safe_str/llm/Safe_Str__LLM__Message__Assistant.py

@@ -0,0 +1,7 @@
+import re
+from osbot_utils.type_safe.primitives.safe_str.Safe_Str import Safe_Str
+
+
+class Safe_Str__LLM__Message__Assistant(Safe_Str):              # For assistant/AI responses
+    max_length  = 32768                                         # Full context window for responses
+    regex       = re.compile(r'[\x00-\x08\x0B\x0C\x0E-\x1F]')   # Permissive - only control chars

osbot_utils/type_safe/primitives/safe_str/llm/Safe_Str__LLM__Message__System.py

@@ -0,0 +1,7 @@
+import re
+from osbot_utils.type_safe.primitives.safe_str.Safe_Str import Safe_Str
+
+
+class Safe_Str__LLM__Message__System(Safe_Str):  # For system prompts
+    max_length  = 4096                                         # Shorter than full prompts
+    regex = re.compile(r'[\x00-\x08\x0B\x0C\x0E-\x1F]')        # Remove control chars EXCEPT tab (\x09), newline (\x0A), and carriage return (\x0D)

osbot_utils/type_safe/primitives/safe_str/llm/Safe_Str__LLM__Message__Tool.py

@@ -0,0 +1,7 @@
+import re
+from osbot_utils.type_safe.primitives.safe_str.Safe_Str import Safe_Str
+
+
+class Safe_Str__LLM__Message__Tool(Safe_Str):                   # For tool/function responses
+    max_length  = 16384                                         # Tool responses often shorter
+    regex       = re.compile(r'[\x00-\x08\x0B\x0C\x0E-\x1F]')   # Permissive for JSON/structured data

osbot_utils/type_safe/primitives/safe_str/llm/Safe_Str__LLM__Message__User.py

@@ -0,0 +1,7 @@
+import re
+from osbot_utils.type_safe.primitives.safe_str.Safe_Str import Safe_Str
+
+
+class Safe_Str__LLM__Message__User(Safe_Str):                  # For user messages
+    max_length  = 32768                                        # Full context window for user input
+    regex       = re.compile(r'[\x00-\x08\x0B\x0C\x0E-\x1F]')  # Permissive - only control chars

osbot_utils/type_safe/primitives/safe_str/llm/Safe_Str__LLM__Modality.py

@@ -0,0 +1,14 @@
+import re
+from osbot_utils.type_safe.primitives.safe_str.Safe_Str import Safe_Str
+
+class Safe_Str__LLM__Modality(Safe_Str):                                        # LLM model modality descriptor
+    max_length = 128
+    regex      = re.compile(r'[^a-zA-Z0-9+\->\s]')                             # Allows: alphanumeric, +, -, >, space
+
+    # Supports modality descriptions:
+    # - "text"
+    # - "text->image"
+    # - "image+text->text"
+    # - "multimodal"
+    # - "text + vision"
+    # - "audio->text"

osbot_utils/type_safe/primitives/safe_str/llm/Safe_Str__LLM__Model_ID.py

@@ -0,0 +1,14 @@
+import re
+from osbot_utils.type_safe.primitives.safe_str.Safe_Str import Safe_Str
+
+class Safe_Str__LLM__Model_ID(Safe_Str):                                        # Generic LLM model identifier
+    max_length = 256
+    regex      = re.compile(r'[^a-zA-Z0-9/\-.:_@]')                             # Allows: alphanumeric, /, -, ., :, _, @
+
+
+    # Supports various model ID formats:
+    # - OpenRouter: "openai/gpt-4", "anthropic/claude-3-opus"
+    # - OpenAI: "gpt-4", "gpt-3.5-turbo"
+    # - Anthropic: "claude-3-opus-20240229", "claude-3-sonnet@20240229"
+    # - Cohere: "command-r-plus"
+    # - Google: "models/gemini-pro"

osbot_utils/type_safe/primitives/safe_str/llm/Safe_Str__LLM__Model_Name.py

@@ -0,0 +1,13 @@
+import re
+from osbot_utils.type_safe.primitives.safe_str.Safe_Str import Safe_Str
+
+class Safe_Str__LLM__Model_Name(Safe_Str):                                      # Human-readable LLM model name
+    max_length = 256
+    regex = re.compile(r'[^a-zA-Z0-9: .\-()+,]')                               # Allows: alphanumeric, :, space, ., -, (, ), +, &, ,
+
+    # Supports various display names:
+    # - "GPT-4 Turbo"
+    # - "Claude 3 Opus (Latest)"
+    # - "Llama 3.1: Instruct (70B)"
+    # - "Command R+"
+    # - "Gemini Pro 1.5"

osbot_utils/type_safe/primitives/safe_str/llm/Safe_Str__LLM__Model_Slug.py

@@ -0,0 +1,12 @@
+import re
+from osbot_utils.type_safe.primitives.safe_str.Safe_Str import Safe_Str
+
+class Safe_Str__LLM__Model_Slug(Safe_Str):                                      # URL-safe LLM model slug
+    max_length = 256
+    regex      = re.compile(r'[^a-zA-Z0-9/\-._]')                              # Allows: alphanumeric, /, -, ., _
+
+    # URL-safe slugs for routing/APIs:
+    # - "gpt-4-turbo"
+    # - "claude-3-opus"
+    # - "llama-3.1-70b"
+    # - "command_r_plus"

osbot_utils/type_safe/primitives/safe_str/llm/Safe_Str__LLM__Prompt.py

@@ -0,0 +1,7 @@
+import re
+from osbot_utils.type_safe.primitives.safe_str.Safe_Str import Safe_Str
+
+
+class Safe_Str__LLM__Prompt(Safe_Str):                       # Or Safe_Str__LLM__Message
+    max_length = 32768                                       # Common context window size
+    regex = re.compile(r'[\x00\x01-\x08\x0B\x0C\x0E-\x1F]')  # Remove control chars only

osbot_utils/type_safe/primitives/safe_str/llm/Safe_Str__LLM__Tokenizer.py

@@ -0,0 +1,13 @@
+import re
+from osbot_utils.type_safe.primitives.safe_str.Safe_Str import Safe_Str
+
+class Safe_Str__LLM__Tokenizer(Safe_Str):                                       # LLM tokenizer type identifier
+    max_length = 64
+    regex      = re.compile(r'[^a-zA-Z0-9\-_\s]')                              # Allows: alphanumeric, -, _, space
+
+    # Supports tokenizer names:
+    # - "cl100k_base"
+    # - "tiktoken"
+    # - "GPT-4 Tokenizer"
+    # - "sentencepiece"
+    # - "BPE"

osbot_utils/type_safe/primitives/safe_str/text/Safe_Str__Code__Snippet.py

@@ -0,0 +1,9 @@
+import re
+
+from osbot_utils.type_safe.primitives.safe_str.Safe_Str import Safe_Str
+
+
+class Safe_Str__Code__Snippet(Safe_Str):     # Allows various characters needed for code snippets.
+    regex = re.compile(r'[^a-zA-Z0-9_\-.\s(),;:=+\[\]{}\'"]<>')
+    max_length = 1024
+    trim_whitespace = False  # Preserve leading whitespace for code indentation

osbot_utils/type_safe/primitives/safe_str/web/Safe_Str__API__Parameter.py

@@ -0,0 +1,13 @@
+import re
+from osbot_utils.type_safe.primitives.safe_str.Safe_Str import Safe_Str
+
+class Safe_Str__API__Parameter(Safe_Str):                                       # Generic API parameter name
+    max_length = 64
+    regex      = re.compile(r'[^a-zA-Z0-9_]')                                  # Allows: alphanumeric, _
+
+    # Standard API parameter names:
+    # - "max_tokens"
+    # - "temperature"
+    # - "top_p"
+    # - "stream"
+    # - "response_format"

osbot_utils/type_safe/primitives/safe_str/web/Safe_Str__Email.py

@@ -0,0 +1,12 @@
+import re
+from osbot_utils.type_safe.primitives.safe_str.Safe_Str import Safe_Str
+
+class Safe_Str__Email(Safe_Str):    # Special class for emails with simple custom validation.
+    regex = re.compile(r'[^a-zA-Z0-9_\-.@]')
+    max_length = 256
+
+    def __new__(cls, value=None):
+        result = super().__new__(cls, value)
+        if '@' not in result:                                                               # Additional validation for email format
+            raise ValueError(f"in {cls.__name__}, email must contain an @ symbol")
+        return result

osbot_utils/type_safe/primitives/safe_str/web/Safe_Str__Password.py

@@ -0,0 +1,14 @@
+import re
+
+from osbot_utils.type_safe.primitives.safe_str.Safe_Str import Safe_Str
+
+
+class Safe_Str__Password(Safe_Str): # Password with minimum requirements.
+    regex = re.compile(r'[^a-zA-Z0-9_\-.\s!@#$%^&*()]')
+    min_length = 8  # Custom attribute
+
+    def __new__(cls, value=None):
+        result = super().__new__(cls, value)
+        if len(result) < cls.min_length:
+            raise ValueError(f"Password must be at least {cls.min_length} characters long")
+        return result

osbot_utils/type_safe/primitives/safe_str/web/Safe_Str__Username.py

@@ -0,0 +1,8 @@
+import re
+from osbot_utils.type_safe.primitives.safe_str.Safe_Str import Safe_Str
+
+
+class Safe_Str__Username(Safe_Str):
+    """Allows only alphanumerics and underscores, with a 32 character limit."""
+    regex = re.compile(r'[^a-zA-Z0-9_]')
+    max_length = 32

osbot_utils/type_safe/type_safe_core/steps/Type_Safe__Step__Init.py

@@ -33,13 +33,16 @@ class Type_Safe__Step__Init:
                 raise ValueError(f"{__self.__class__.__name__} has no attribute '{key}' and cannot be assigned the value '{value}'. "
                                  f"Use {__self.__class__.__name__}.__default_kwargs__() see what attributes are available") from None
 
-    def convert_value_to_type_safe_objects(self, __self, key, value):                                # todo: see if we should use _self here (like in Type_Safe__Step__From_Json, or vice versa)
+    def convert_value_to_type_safe_objects(self, __self, key, value):
         annotation = type_safe_annotations.obj_attribute_annotation(__self, key)
         if annotation:
             if isinstance(annotation, EnumMeta) and type(value) is str:
-                if value not in annotation.__members__:
+                if value in annotation.__members__:                                                             # First check if it's a valid name (e.g., 'SYSTEM')
+                    value = annotation[value]
+                elif hasattr(annotation, '_value2member_map_') and value in annotation._value2member_map_:      # Then check if it's a valid value (e.g., 'system')
+                    value = annotation._value2member_map_[value]
+                else:
                     raise ValueError(f"Invalid value '{value}' for enum {annotation.__name__}")
-                value = annotation[value]
             else:
 
                 origin = type_safe_annotations.get_origin(annotation)

osbot_utils/utils/Objects.py

@@ -1,5 +1,4 @@
-from types import SimpleNamespace
-
+from types                  import SimpleNamespace
 from osbot_utils.testing.__ import __
 
 def base_classes(cls):
@@ -96,10 +95,13 @@ def str_to_obj(target):
     return dict_to_obj(json.loads(target))
 
 def enum_from_value(enum_type, value):
-    try:
-        return enum_type[value]         # Attempt to convert the value to an Enum member by name
-    except KeyError:
-        raise ValueError(f"Value '{value}' is not a valid member of {enum_type.__name__}.")     # Handle the case where the value does not match any Enum member
+    if value in enum_type.__members__:                                                              # Try to get by name (e.g., 'SYSTEM')
+        return enum_type[value]
+
+    if hasattr(enum_type, '_value2member_map_') and value in enum_type._value2member_map_:          # Try to get by value (e.g., 'system') using the reverse mapping
+        return enum_type._value2member_map_[value]
+
+    raise ValueError(f"Value '{value}' is not a valid member of {enum_type.__name__}.")             # If neither worked, raise an error
 
 
 def get_field(target, field, default=None):
@@ -276,13 +278,18 @@ def serialize_to_dict(obj):
         return obj.json()                                                                           #   use the provided .json() method, which handles the type conversions more specifically to those types (dict, list, set and tuple)
     elif hasattr(obj, '__primitive_base__') and isinstance(obj, (str, int, float)):
         return obj.__primitive_base__(obj)
+    elif isinstance(obj, Enum):
+        if isinstance(obj.value, (str, int, float, bool, type(None))):                          # Check if the enum value is directly serializable
+            return obj.value
+        elif isinstance(obj.value, (list, tuple, dict, set)):                                        # Recursively serialize complex values
+            return serialize_to_dict(obj.value)
+        else:
+            return obj.name                                                                     # Fallback to name for non-serializable values
     elif isinstance(obj, (str, int, float, bool, bytes, Decimal)) or obj is None:                # todo: add support for objects like datetime
         return obj
-    elif isinstance(obj, Enum):
-        return obj.name
     elif isinstance(obj, type):
         return f"{obj.__module__}.{obj.__name__}"                                   # save the full type name
-    elif isinstance(obj, (list, tuple, List)):  # Added tuple here
+    elif isinstance(obj, (list, tuple, List)):                                     # Added tuple here
         return [serialize_to_dict(item) for item in obj]
     elif isinstance(obj, set):
         return [serialize_to_dict(item) for item in obj]
@@ -296,6 +303,12 @@ def serialize_to_dict(obj):
             serialized_dict[serialized_key] = serialize_to_dict(value)         # Recursively serialize the value
         return serialized_dict
         #return {key: serialize_to_dict(value) for key, value in obj.items()}
+    elif callable(obj) and not isinstance(obj, type):                                                         # For functions/lambdas, return a string representation
+        if hasattr(obj, '__name__'):
+            return obj.__name__
+        if hasattr(obj, '__class__'):
+            return obj.__class__.__name__
+        return str(obj)
     elif hasattr(obj, "__dict__"):
         data = {}                                                                   # todo: look at a more advanced version which saved the type of the object, for example with {'__type__': type(obj).__name__}
         for key, value in obj.__dict__.items():

osbot_utils/version

@@ -1 +1 @@
-v2.88.0
+v2.89.0

{osbot_utils-2.88.0.dist-info → osbot_utils-2.89.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: osbot_utils
-Version: 2.88.0
+Version: 2.89.0
 Summary: OWASP Security Bot - Utils
 License: MIT
 Author: Dinis Cruz
@@ -21,7 +21,7 @@ Description-Content-Type: text/markdown
 
 # OSBot-Utils
 
-![Current Release](https://img.shields.io/badge/release-v2.88.0-blue)
+![Current Release](https://img.shields.io/badge/release-v2.89.0-blue)
 ![Python](https://img.shields.io/badge/python-3.8+-green)
 ![Type-Safe](https://img.shields.io/badge/Type--Safe-✓-brightgreen)
 ![Caching](https://img.shields.io/badge/Caching-Built--In-orange)

{osbot_utils-2.88.0.dist-info → osbot_utils-2.89.0.dist-info}/RECORD

@@ -137,7 +137,7 @@ osbot_utils/helpers/cache_requests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQe
 osbot_utils/helpers/duration/Duration.py,sha256=KvHaAB6NWa40DXQl2gC9m98gM-arVP-aYqFrmAyQQzM,2306
 osbot_utils/helpers/duration/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/helpers/duration/decorators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-osbot_utils/helpers/duration/decorators/capture_duration.py,sha256=8ObmbP9_qfYtxx30NGXThRE_E1XZ5IXtX9PHWqtLGfs,1240
+osbot_utils/helpers/duration/decorators/capture_duration.py,sha256=_JGWEE8xzYFhNvPjUVmERQP9ev2N65Aqx0hBIt2iy5A,1239
 osbot_utils/helpers/duration/decorators/duration.py,sha256=ucJP1fCQEN8ALCDCG9CPzPn1KqojD4ttFc3HLke-nvY,651
 osbot_utils/helpers/duration/decorators/print_duration.py,sha256=w7k3OPiRkL5KqLv0S5o1NVo2y_TeOOvDOb-51YbJjAc,283
 osbot_utils/helpers/duration/schemas/Schema__Duration.py,sha256=-h32wBcpiVRkEbc_sZoamnRFNGaQQM4YsxqoVzPGe38,209
@@ -179,7 +179,7 @@ osbot_utils/helpers/html/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZ
 osbot_utils/helpers/html/schemas/Schema__Html_Document.py,sha256=tQJLc0rf2CuG1sGNB04cPyVV7KpCGXYDt0wEnFtWohg,403
 osbot_utils/helpers/html/schemas/Schema__Html_Node.py,sha256=iMGClwil99_KoeLuft53DQLu9Jw-PCqRjBXpfInd7rM,794
 osbot_utils/helpers/html/schemas/Schema__Html_Node__Data.py,sha256=GiAZY5mO3DNasUO_oNM4ndTvRU2VpjPxOi7kYzu2DHE,568
-osbot_utils/helpers/html/schemas/Schema__Html_Node__Data__Type.py,sha256=mbYivcm6BfN5-oeCyl6gjbnSKs_b_t-G2H1rpSK6nUY,90
+osbot_utils/helpers/html/schemas/Schema__Html_Node__Data__Type.py,sha256=D2imfu_SWJkSkUENqOqxM2IKQpAb7YESuPBwSHhpvbY,95
 osbot_utils/helpers/html/schemas/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/helpers/html/tags/Tag__Base.py,sha256=W6zw5Sn4i8bEM6PTUVRlZgOwDRZFRxpaOjVthpJRPn4,4483
 osbot_utils/helpers/html/tags/Tag__Body.py,sha256=BK_VJHMnGl-RpV_6C_C21hThgMVq76r5XtvtKAqFf0c,114
@@ -207,7 +207,7 @@ osbot_utils/helpers/llms/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZ
 osbot_utils/helpers/llms/actions/LLM_Request__Execute.py,sha256=mgibU74brzKsO4lZEuQrs2AADDRik6WjZEb3KxiGUfE,2454
 osbot_utils/helpers/llms/actions/Type_Safe__Schema_For__LLMs.py,sha256=SfatdVI7sbFXSiEY--6FkW9amLrYUFhZw1xvgKrE_-s,12064
 osbot_utils/helpers/llms/actions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-osbot_utils/helpers/llms/builders/LLM_Request__Builder.py,sha256=9DTjtpTDCSBnZJelemOsGhLFaETOhyzUl8CFfwnzn_Q,4009
+osbot_utils/helpers/llms/builders/LLM_Request__Builder.py,sha256=EaI9uGhlBHvxRlX4J89GKdA0eYZAJkL34qqblgLPRzw,4020
 osbot_utils/helpers/llms/builders/LLM_Request__Builder__Open_AI.py,sha256=j9m99MS0NwJPqHj85Q4FOhhyIPKHnx2wj6RJLOOKlls,3431
 osbot_utils/helpers/llms/builders/LLM_Request__Factory.py,sha256=OQW0nIfmXvc2RdT84GtMM-BlMp04iQOUsgIieU8NKcs,6291
 osbot_utils/helpers/llms/builders/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -221,10 +221,9 @@ osbot_utils/helpers/llms/cache/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5
 osbot_utils/helpers/llms/platforms/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/helpers/llms/platforms/open_ai/API__LLM__Open_AI.py,sha256=Yyy2ZnIS6CfxXepP9pZNsOYx02d-5EnK1IFeFf8myyk,2148
 osbot_utils/helpers/llms/platforms/open_ai/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-osbot_utils/helpers/llms/schemas/Safe_Str__LLM__Model_Name.py,sha256=DzQmAe_8IEDKYjUAAbzRYx23g_wGqgd9bT5zc0FBrr8,371
 osbot_utils/helpers/llms/schemas/Schema__LLM_Cache__Index.py,sha256=GNzOvihBlQ9QWWYAF_-70IkWdquGdhm5QyPXZRMWaNQ,848
 osbot_utils/helpers/llms/schemas/Schema__LLM_Request.py,sha256=UUiqZQ5mj16SPdlzef7_j3myLaKKCZdAUjsWUJnK1Ag,378
-osbot_utils/helpers/llms/schemas/Schema__LLM_Request__Data.py,sha256=dcgiEF5lKvNpC4JLa76AH4_HO0SkTDOSgD_2K04cK2A,1489
+osbot_utils/helpers/llms/schemas/Schema__LLM_Request__Data.py,sha256=JF-anC4Hd1Jn_F1MOubDxW9WmAaHKWn1yBPzY1n5-vw,1514
 osbot_utils/helpers/llms/schemas/Schema__LLM_Request__Function_Call.py,sha256=VJgWi4aK-DJmuJvfY2qZUZuLkrLlmu5lgyzxZrrp3hM,440
 osbot_utils/helpers/llms/schemas/Schema__LLM_Request__Message__Content.py,sha256=nl-16yz4G_72ViACKE9CvGStrKxw2Gm_JcaU8wVcJXI,521
 osbot_utils/helpers/llms/schemas/Schema__LLM_Request__Message__Role.py,sha256=T99w0cRrDPXQqPT-Nw7_14tMr4vKpUlhw74UJZL6w6w,168
@@ -363,7 +362,7 @@ osbot_utils/type_safe/primitives/safe_int/Safe_Int.py,sha256=IB_ZVtuQlAfRWZH1teZ
 osbot_utils/type_safe/primitives/safe_int/Timestamp_Now.py,sha256=OZwSwmYA1pZAnVglpx2lBL5t8Pu_HxzmYdNEJnmTqKI,536
 osbot_utils/type_safe/primitives/safe_int/__init__.py,sha256=Prle-pyYi8l4hjbzGACVxX89Uc5aAhYjGRojywWysQM,323
 osbot_utils/type_safe/primitives/safe_str/Enum__Safe_Str__Regex_Mode.py,sha256=15y_afYIf_LsweutaVVdIJ0qClbVITJGWNEqfRKapNI,120
-osbot_utils/type_safe/primitives/safe_str/Safe_Str.py,sha256=u6AWM9CCVBxo2s_QmjgC-91m3N9mA3FJzmXcwneTwPg,5022
+osbot_utils/type_safe/primitives/safe_str/Safe_Str.py,sha256=9Gb6TyXySuN1OI1wFYwEOJUASDniWrvgEE7PBYteZRs,5225
 osbot_utils/type_safe/primitives/safe_str/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/type_safe/primitives/safe_str/cryptography/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/type_safe/primitives/safe_str/cryptography/hashes/Safe_Str__Hash.py,sha256=zmARKnR6k0d7zg2DESPSZU8Qj91nx-qrnNrXln6UcYk,1287
@@ -397,12 +396,30 @@ osbot_utils/type_safe/primitives/safe_str/identifiers/Random_Guid.py,sha256=86xn
 osbot_utils/type_safe/primitives/safe_str/identifiers/Random_Guid_Short.py,sha256=cXye_Bo5cco24FOyXwyN0qotXHc-X4-eQ-ZgOaQrocE,496
 osbot_utils/type_safe/primitives/safe_str/identifiers/Safe_Id.py,sha256=Mj66QVcEHqUKDFb0cdl7cbMOlQKxfFuRxnupmKo6UG8,696
 osbot_utils/type_safe/primitives/safe_str/identifiers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+osbot_utils/type_safe/primitives/safe_str/llm/Enum__LLM__Role.py,sha256=NnuPmct-FPwzfGRw507aIarOQXUNoigJE2_E0x7etTw,277
+osbot_utils/type_safe/primitives/safe_str/llm/Safe_Str__LLM__Description.py,sha256=IuSnjJv0KFWcvTcNmEqu47QJeYgidNvXwiDamnB0cz8,662
+osbot_utils/type_safe/primitives/safe_str/llm/Safe_Str__LLM__Message__Assistant.py,sha256=4SVKHE8oiY_GQtlFcoDqv3z-Y_9Xp5bc9DRNIadTD7Q,374
+osbot_utils/type_safe/primitives/safe_str/llm/Safe_Str__LLM__Message__System.py,sha256=AGessh1EtfwodQYldHKsBz8hU-719SU38oIdag9omJo,393
+osbot_utils/type_safe/primitives/safe_str/llm/Safe_Str__LLM__Message__Tool.py,sha256=evu0is9UG6AZSnUXUGJOq44kq5NqGoq1nqC1nreGjvo,374
+osbot_utils/type_safe/primitives/safe_str/llm/Safe_Str__LLM__Message__User.py,sha256=ciioB8_vfK4dd9YDb8eP5VZC4fb0sm_sETjdzP3ZcWU,363
+osbot_utils/type_safe/primitives/safe_str/llm/Safe_Str__LLM__Modality.py,sha256=87x4TXMBllICeEDWZ1c7iT80wcqRZ8xe7w-b6eHtJi8,503
+osbot_utils/type_safe/primitives/safe_str/llm/Safe_Str__LLM__Model_ID.py,sha256=FHpISUMXJL0F2CQfSW-eP9UOcBxzcj8HJcwun-0-1iQ,622
+osbot_utils/type_safe/primitives/safe_str/llm/Safe_Str__LLM__Model_Name.py,sha256=N-nsKiqEtg_nYzEu5vxxF6edLwpL2_19hPQk3LoAs3w,524
+osbot_utils/type_safe/primitives/safe_str/llm/Safe_Str__LLM__Model_Slug.py,sha256=XWJdStnMeTZbds4quKjMFQYR8EqUlNKYuuJZk4GKzQw,458
+osbot_utils/type_safe/primitives/safe_str/llm/Safe_Str__LLM__Prompt.py,sha256=YY5kXc0OrNGOyPssiUDcPagLSa0yhCUBmYOydqI5ELU,351
+osbot_utils/type_safe/primitives/safe_str/llm/Safe_Str__LLM__Tokenizer.py,sha256=L34FBL49xC5RCyirlpzPBCaARWlwK6VguDM9-m9kLmA,467
+osbot_utils/type_safe/primitives/safe_str/llm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+osbot_utils/type_safe/primitives/safe_str/text/Safe_Str__Code__Snippet.py,sha256=hhdAkOqgaGA8NmuOXXOOm8jWnIQmh_aTNRFecdvrDbc,350
 osbot_utils/type_safe/primitives/safe_str/text/Safe_Str__Text.py,sha256=95E4ALhah2AEfL-m5JB7XpUOkyxQ0lJQM139RPQJjv4,327
 osbot_utils/type_safe/primitives/safe_str/text/Safe_Str__Text__Dangerous.py,sha256=WrEvoXeHWuevzgbfUkm2xisGUMIlDS39Nte3P2_hyHg,401
 osbot_utils/type_safe/primitives/safe_str/text/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+osbot_utils/type_safe/primitives/safe_str/web/Safe_Str__API__Parameter.py,sha256=ZI9kw3N2JQaCXBs2SbKwBN6hF0LB8gCErlOS7wylIZE,455
+osbot_utils/type_safe/primitives/safe_str/web/Safe_Str__Email.py,sha256=FXydnlrbJSaZKl_dgN32en2cchgWjG-tVTQ7HgsUcEs,560
 osbot_utils/type_safe/primitives/safe_str/web/Safe_Str__Html.py,sha256=HnCnKUBPB0IfEXSoeK4XFB08qjnAaOYyd-s1smvI2pQ,675
 osbot_utils/type_safe/primitives/safe_str/web/Safe_Str__IP_Address.py,sha256=wOcEt0adsE6-CX08erlRYyGyOLoe4QRaAYdI6sKyKlM,1672
+osbot_utils/type_safe/primitives/safe_str/web/Safe_Str__Password.py,sha256=cV6wyO_sGTp9pyXDttmzTaInrC8jBeBXqik4P14t82w,489
 osbot_utils/type_safe/primitives/safe_str/web/Safe_Str__Url.py,sha256=9xVINemoNS2LtXshAZdhEzKHyneB7Ml4AELqFHJfWWw,562
+osbot_utils/type_safe/primitives/safe_str/web/Safe_Str__Username.py,sha256=aMhYz8sCQNUtti4wM4sZRyVSRB2IwD1BVDEUeGp59hE,260
 osbot_utils/type_safe/primitives/safe_str/web/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/type_safe/primitives/safe_uint/Safe_UInt.py,sha256=8cCS9wI0w1w5YuWIhrVHJKzczHiK3cw_dnXhMgnQAto,331
 osbot_utils/type_safe/primitives/safe_uint/Safe_UInt__Byte.py,sha256=yRYzj42EpuLU46l-azYEeszbUBdfgnA_Pb6m_41D7Us,342
@@ -435,7 +452,7 @@ osbot_utils/type_safe/type_safe_core/steps/Type_Safe__Step__Class_Kwargs.py,sha2
 osbot_utils/type_safe/type_safe_core/steps/Type_Safe__Step__Default_Kwargs.py,sha256=tzKXDUc0HVP5QvCWsmcPuuZodNvQZ9FeMDNI2x00Ngw,1943
 osbot_utils/type_safe/type_safe_core/steps/Type_Safe__Step__Default_Value.py,sha256=mRu0yV3w7Ch1H8SOfXMRqMBp3ooY95yR_oni7JafJBc,4603
 osbot_utils/type_safe/type_safe_core/steps/Type_Safe__Step__From_Json.py,sha256=QDVf-cN7aK8_xYdkHS74seSrMYyhurd_MEzgTlUyStg,15712
-osbot_utils/type_safe/type_safe_core/steps/Type_Safe__Step__Init.py,sha256=lZpQCCTNt6JcqyWwDoj-9Zgrq10vHXIUBh9lx37vRkE,4990
+osbot_utils/type_safe/type_safe_core/steps/Type_Safe__Step__Init.py,sha256=Dcs382ZqJ1ycuBYO_1LU2TaadQsUZ_MBihAKdM7PxDk,5230
 osbot_utils/type_safe/type_safe_core/steps/Type_Safe__Step__Set_Attr.py,sha256=OLAzZ6FUfTYk4tqIRe_JGvBR_WZqPZFqM2aD_AMKb0c,9320
 osbot_utils/type_safe/type_safe_core/steps/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/type_safe/validators/Type_Safe__Validator.py,sha256=cJIPSBarjV716SZUOLvz7Mthjk-aUYKUQtRDtKUBmN4,779
@@ -458,7 +475,7 @@ osbot_utils/utils/Json.py,sha256=TvfDoXwOkWzWH-9KMnme5C7iFsMZOleAeue92qmkH6g,883
 osbot_utils/utils/Json_Cache.py,sha256=mLPkkDZN-3ZVJiDvV1KBJXILtKkTZ4OepzOsDoBPhWg,2006
 osbot_utils/utils/Lists.py,sha256=tPz5x5s3sRO97WZ_nsxREBPC5cwaHrhgaYBhsrffTT8,5599
 osbot_utils/utils/Misc.py,sha256=H_xexJgiTxB3jDeDiW8efGQbO0Zuy8MM0iQ7qXC92JI,17363
-osbot_utils/utils/Objects.py,sha256=fLwnB0bv0vqGBE7uGYUxB4IUNEXjn-rjakYz8mp3VVY,14198
+osbot_utils/utils/Objects.py,sha256=KjRvw2ElXrmd0Y7xtQ2prFbYGCsKDnMQmEvQ1zoL2tk,15321
 osbot_utils/utils/Png.py,sha256=V1juGp6wkpPigMJ8HcxrPDIP4bSwu51oNkLI8YqP76Y,1172
 osbot_utils/utils/Process.py,sha256=lr3CTiEkN3EiBx3ZmzYmTKlQoPdkgZBRjPulMxG-zdo,2357
 osbot_utils/utils/Python_Logger.py,sha256=M9Oi62LxfnRSlCN8GhaiwiBINvcSdGy39FCWjyDD-Xg,12792
@@ -470,8 +487,8 @@ osbot_utils/utils/Toml.py,sha256=grjWkVPIMVkawJ499FVIJKxQp8FJ2wcsd0Z3YIR4drM,114
 osbot_utils/utils/Version.py,sha256=Ww6ChwTxqp1QAcxOnztkTicShlcx6fbNsWX5xausHrg,422
 osbot_utils/utils/Zip.py,sha256=mG42lgTY0tnm14T3P1-DSAIZKkTiYoO3odZ1aOUdc1I,14394
 osbot_utils/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-osbot_utils/version,sha256=u1LBWyu3twx83JpD3wK_Gaq_Qp9K5LjWM2VKJa6aO50,8
-osbot_utils-2.88.0.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-osbot_utils-2.88.0.dist-info/METADATA,sha256=nnRNyYqN_GhoIZJE0Al-lCnDdCNWQ3bB4dqbDIeoHhU,7918
-osbot_utils-2.88.0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-osbot_utils-2.88.0.dist-info/RECORD,,
+osbot_utils/version,sha256=OKa3BNcbPy8l886C7z7_sfvcKm8rLoKGNBQkfm9o2kQ,8
+osbot_utils-2.89.0.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+osbot_utils-2.89.0.dist-info/METADATA,sha256=bgQC3MRSIKAxl6qSFBZc8Jco5LJBcVkxCi0tap8h0lk,7918
+osbot_utils-2.89.0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+osbot_utils-2.89.0.dist-info/RECORD,,

osbot_utils/helpers/llms/schemas/Safe_Str__LLM__Model_Name.py

@@ -1,10 +0,0 @@
-import re
-
-from osbot_utils.type_safe.primitives.safe_str.Safe_Str import Safe_Str
-
-TYPE_SAFE_STR__LLM__MODEL_NAME__MAX_LENGTH = 256
-TYPE_SAFE_STR__LLM__MODEL_NAME__REGEX      =  r'[^a-zA-Z0-9/_\-.:]'
-
-class Safe_Str__LLM__Model_Name(Safe_Str):
-    regex      = re.compile(TYPE_SAFE_STR__LLM__MODEL_NAME__REGEX)
-    max_length = TYPE_SAFE_STR__LLM__MODEL_NAME__MAX_LENGTH