osbot-utils 2.72.0__py3-none-any.whl → 2.74.0__py3-none-any.whl

osbot_utils/helpers/flows/actions/Flow__Data.py

@@ -1,5 +1,5 @@
 from typing                                                     import Optional, Dict, Any
-from osbot_utils.helpers.Timestamp_Now                          import Timestamp_Now
+from osbot_utils.type_safe.primitives.safe_int.Timestamp_Now     import Timestamp_Now
 from osbot_utils.helpers.flows.models.Flow_Run__Event           import Flow_Run__Event
 from osbot_utils.helpers.flows.models.Schema__Flow__Artifact    import Schema__Flow__Artifact
 from osbot_utils.helpers.flows.models.Schema__Flow__Result      import Schema__Flow__Result

osbot_utils/helpers/flows/models/Flow_Run__Event.py

@@ -1,8 +1,9 @@
-from osbot_utils.helpers.Random_Guid                        import Random_Guid
-from osbot_utils.type_safe.Type_Safe                        import Type_Safe
-from osbot_utils.helpers.Timestamp_Now                      import Timestamp_Now
-from osbot_utils.helpers.flows.models.Flow_Run__Event_Data  import Flow_Run__Event_Data
-from osbot_utils.helpers.flows.models.Flow_Run__Event_Type  import Flow_Run__Event_Type
+
+from osbot_utils.type_safe.primitives.safe_str.identifiers.Random_Guid  import Random_Guid
+from osbot_utils.type_safe.Type_Safe                                    import Type_Safe
+from osbot_utils.type_safe.primitives.safe_int.Timestamp_Now            import Timestamp_Now
+from osbot_utils.helpers.flows.models.Flow_Run__Event_Data              import Flow_Run__Event_Data
+from osbot_utils.helpers.flows.models.Flow_Run__Event_Type              import Flow_Run__Event_Type
 
 class Flow_Run__Event(Type_Safe):
     event_id    : Random_Guid

osbot_utils/helpers/flows/models/Schema__Flow__Artifact.py

@@ -1,5 +1,5 @@
 from typing                             import Any
-from osbot_utils.helpers.Timestamp_Now  import Timestamp_Now
+from osbot_utils.type_safe.primitives.safe_int.Timestamp_Now  import Timestamp_Now
 from osbot_utils.type_safe.Type_Safe    import Type_Safe
 
 

osbot_utils/helpers/flows/models/Schema__Flow__Result.py

@@ -1,5 +1,5 @@
 from osbot_utils.type_safe.Type_Safe                        import Type_Safe
-from osbot_utils.helpers.Timestamp_Now                      import Timestamp_Now
+from osbot_utils.type_safe.primitives.safe_int.Timestamp_Now import Timestamp_Now
 
 class Schema__Flow__Result(Type_Safe):                      # Represents a result produced by the flow
     key         : str

osbot_utils/helpers/flows/schemas/Schema__Flow__Data.py

@@ -1,5 +1,5 @@
 from typing                                                     import Optional, Dict, List, Any
-from osbot_utils.helpers.Timestamp_Now                          import Timestamp_Now
+from osbot_utils.type_safe.primitives.safe_int.Timestamp_Now     import Timestamp_Now
 from osbot_utils.helpers.flows.models.Flow_Run__Event           import Flow_Run__Event
 from osbot_utils.helpers.flows.models.Schema__Flow__Artifact    import Schema__Flow__Artifact
 from osbot_utils.helpers.flows.models.Schema__Flow__Result      import Schema__Flow__Result

osbot_utils/helpers/flows/schemas/Schema__Flow__Event.py

@@ -1,7 +1,7 @@
 # todo: this needs refactoring with the Flow_Run__Event events stored in the Schema__Flow__Data. object
 
 
-# from osbot_utils.helpers.Timestamp_Now                           import Timestamp_Now
+# from osbot_utils.type_safe.primitives.safe_int.Timestamp_Now      import Timestamp_Now
 # from osbot_utils.helpers.flows.schemas.Schema__Flow__Event__Data import Schema__Flow__Event__Data
 # from osbot_utils.type_safe.Type_Safe                             import Type_Safe
 #

osbot_utils/helpers/flows/schemas/Schema__Flow__Log.py

@@ -1,5 +1,5 @@
 from typing                             import Optional
-from osbot_utils.helpers.Timestamp_Now  import Timestamp_Now
+from osbot_utils.type_safe.primitives.safe_int.Timestamp_Now  import Timestamp_Now
 from osbot_utils.type_safe.Type_Safe    import Type_Safe
 
 

osbot_utils/helpers/flows/schemas/Schema__Flow__Task__Data.py

@@ -1,5 +1,5 @@
 from typing                             import Optional, Any
-from osbot_utils.helpers.Timestamp_Now  import Timestamp_Now
+from osbot_utils.type_safe.primitives.safe_int.Timestamp_Now  import Timestamp_Now
 from osbot_utils.type_safe.Type_Safe    import Type_Safe
 
 

osbot_utils/helpers/generators/Generator_Manager.py

@@ -4,7 +4,7 @@ from types                                                      import Generator
 from typing                                                     import Dict                               # Typing imports for type hints
 from typing                                                     import Union
 from osbot_utils.type_safe.Type_Safe                         import Type_Safe                          # Type_Safe base class for type-safe attributes
-from osbot_utils.helpers.Random_Guid                            import Random_Guid                        # Helper for generating unique IDs
+from osbot_utils.type_safe.primitives.safe_str.identifiers.Random_Guid                            import Random_Guid                        # Helper for generating unique IDs
 from osbot_utils.helpers.generators.Generator_Context_Manager   import Generator_Context_Manager
 from osbot_utils.helpers.generators.Model__Generator_State      import Model__Generator_State
 from osbot_utils.helpers.generators.Model__Generator_Target     import Model__Generator_Target

osbot_utils/helpers/generators/Model__Generator_Target.py

@@ -1,6 +1,6 @@
 from types                                                  import GeneratorType
 from osbot_utils.type_safe.Type_Safe                     import Type_Safe
-from osbot_utils.helpers.Random_Guid                        import Random_Guid
+from osbot_utils.type_safe.primitives.safe_str.identifiers.Random_Guid                        import Random_Guid
 from osbot_utils.helpers.generators.Model__Generator_State  import Model__Generator_State
 
 

osbot_utils/helpers/html/schemas/Schema__Html_Document.py

@@ -1,4 +1,4 @@
-from osbot_utils.helpers.Timestamp_Now                  import Timestamp_Now
+from osbot_utils.type_safe.primitives.safe_int.Timestamp_Now                  import Timestamp_Now
 from osbot_utils.helpers.html.schemas.Schema__Html_Node import Schema__Html_Node
 from osbot_utils.type_safe.Type_Safe                    import Type_Safe
 

osbot_utils/helpers/llms/actions/LLM_Request__Execute.py

@@ -5,7 +5,8 @@ from osbot_utils.helpers.llms.platforms.open_ai.API__LLM__Open_AI   import API__
 from osbot_utils.helpers.llms.schemas.Schema__LLM_Request           import Schema__LLM_Request
 from osbot_utils.helpers.llms.schemas.Schema__LLM_Response          import Schema__LLM_Response
 from osbot_utils.type_safe.Type_Safe                                import Type_Safe
-from osbot_utils.type_safe.decorators.type_safe                     import type_safe
+from osbot_utils.type_safe.type_safe_core.decorators.type_safe      import type_safe
+
 
 class LLM_Request__Execute(Type_Safe):
     llm_cache      : LLM_Request__Cache

osbot_utils/helpers/llms/actions/Type_Safe__Schema_For__LLMs.py

@@ -1,14 +1,14 @@
 import re
-from typing                                                     import Type, Any, List, Dict, Tuple, Set, Optional, Union, get_origin, get_args
-from osbot_utils.type_safe.Type_Safe                            import Type_Safe
-from osbot_utils.type_safe.decorators.type_safe                 import type_safe
-from osbot_utils.type_safe.shared.Type_Safe__Cache              import type_safe_cache
-from osbot_utils.type_safe.validators.Type_Safe__Validator      import Type_Safe__Validator
-from osbot_utils.type_safe.validators.Validator__Min            import Validator__Min
-from osbot_utils.type_safe.validators.Validator__Max            import Validator__Max
-from osbot_utils.type_safe.validators.Validator__Regex          import Validator__Regex
-from osbot_utils.type_safe.validators.Validator__One_Of         import Validator__One_Of
-from osbot_utils.helpers.python_compatibility.python_3_8        import Annotated
+from typing                                                         import Type, Any, List, Dict, Tuple, Set, Optional, Union, get_origin, get_args
+from osbot_utils.type_safe.Type_Safe                                import Type_Safe
+from osbot_utils.type_safe.type_safe_core.decorators.type_safe      import type_safe
+from osbot_utils.type_safe.type_safe_core.shared.Type_Safe__Cache   import type_safe_cache
+from osbot_utils.type_safe.validators.Type_Safe__Validator          import Type_Safe__Validator
+from osbot_utils.type_safe.validators.Validator__Min                import Validator__Min
+from osbot_utils.type_safe.validators.Validator__Max                import Validator__Max
+from osbot_utils.type_safe.validators.Validator__Regex              import Validator__Regex
+from osbot_utils.type_safe.validators.Validator__One_Of             import Validator__One_Of
+from osbot_utils.helpers.python_compatibility.python_3_8            import Annotated
 import inspect
 
 

osbot_utils/helpers/llms/builders/LLM_Request__Builder.py

@@ -6,9 +6,10 @@ from osbot_utils.helpers.llms.schemas.Schema__LLM_Request__Data             impo
 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.helpers.safe_str.Safe_Str__Text                            import Safe_Str__Text
 from osbot_utils.type_safe.Type_Safe                                        import Type_Safe
-from osbot_utils.type_safe.decorators.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):
     schema_generator : Type_Safe__Schema_For__LLMs

osbot_utils/helpers/llms/builders/LLM_Request__Builder__Open_AI.py

@@ -1,6 +1,7 @@
 from typing                                                     import Dict, Any
 from osbot_utils.helpers.llms.builders.LLM_Request__Builder     import LLM_Request__Builder
-from osbot_utils.type_safe.decorators.type_safe                 import type_safe
+from osbot_utils.type_safe.type_safe_core.decorators.type_safe  import type_safe
+
 
 class LLM_Request__Builder__Open_AI(LLM_Request__Builder):
 

osbot_utils/helpers/llms/builders/LLM_Request__Factory.py

@@ -2,7 +2,7 @@ from typing                                                     import Type, Opt
 from osbot_utils.helpers.llms.builders.LLM_Request__Builder     import LLM_Request__Builder
 from osbot_utils.helpers.llms.schemas.Schema__LLM_Request__Data import Schema__LLM_Request__Data
 from osbot_utils.type_safe.Type_Safe                            import Type_Safe
-from osbot_utils.type_safe.decorators.type_safe                 import type_safe
+from osbot_utils.type_safe.type_safe_core.decorators.type_safe  import type_safe
 
 
 class LLM_Request__Factory(Type_Safe):                              # Factory class for creating common LLM request patterns.

osbot_utils/helpers/llms/cache/LLM_Cache__Path_Generator.py

@@ -1,9 +1,10 @@
-from datetime                                           import datetime
-from typing                                             import List, Optional
-from osbot_utils.helpers.Safe_Id                        import Safe_Id
-from osbot_utils.helpers.safe_str.Safe_Str__File__Path  import Safe_Str__File__Path
-from osbot_utils.type_safe.Type_Safe                    import Type_Safe
-from osbot_utils.type_safe.decorators.type_safe         import type_safe
+from datetime                                                                   import datetime
+from typing                                                                     import List, Optional
+from osbot_utils.type_safe.primitives.safe_str.identifiers.Safe_Id              import Safe_Id
+from osbot_utils.type_safe.Type_Safe                                            import Type_Safe
+from osbot_utils.type_safe.primitives.safe_str.filesystem.Safe_Str__File__Path  import Safe_Str__File__Path
+from osbot_utils.type_safe.type_safe_core.decorators.type_safe                  import type_safe
+
 
 class LLM_Cache__Path_Generator(Type_Safe):
     @type_safe

osbot_utils/helpers/llms/cache/LLM_Request__Cache.py

@@ -1,13 +1,13 @@
-from typing                                                       import Dict, Optional, List
-from osbot_utils.helpers.Obj_Id                                   import Obj_Id
-from osbot_utils.helpers.llms.schemas.Schema__LLM_Cache__Index    import Schema__LLM_Cache__Index
-from osbot_utils.helpers.llms.schemas.Schema__LLM_Request         import Schema__LLM_Request
-from osbot_utils.helpers.llms.schemas.Schema__LLM_Response        import Schema__LLM_Response
-from osbot_utils.helpers.llms.schemas.Schema__LLM_Response__Cache import Schema__LLM_Response__Cache
-from osbot_utils.helpers.safe_str.Safe_Str__Hash                  import Safe_Str__Hash
-from osbot_utils.type_safe.Type_Safe                              import Type_Safe
-from osbot_utils.type_safe.decorators.type_safe                   import type_safe
-from osbot_utils.utils.Json                                       import json_md5
+from typing                                                                       import Dict, Optional, List
+from osbot_utils.helpers.Obj_Id                                                   import Obj_Id
+from osbot_utils.helpers.llms.schemas.Schema__LLM_Cache__Index                    import Schema__LLM_Cache__Index
+from osbot_utils.helpers.llms.schemas.Schema__LLM_Request                         import Schema__LLM_Request
+from osbot_utils.helpers.llms.schemas.Schema__LLM_Response                        import Schema__LLM_Response
+from osbot_utils.helpers.llms.schemas.Schema__LLM_Response__Cache                 import Schema__LLM_Response__Cache
+from osbot_utils.type_safe.Type_Safe                                              import Type_Safe
+from osbot_utils.type_safe.primitives.safe_str.cryptography.hashes.Safe_Str__Hash import Safe_Str__Hash
+from osbot_utils.type_safe.type_safe_core.decorators.type_safe                    import type_safe
+from osbot_utils.utils.Json                                                       import json_md5
 
 SIZE__VALUE_HASH = 10
 

osbot_utils/helpers/llms/cache/LLM_Request__Cache__File_System.py

@@ -2,7 +2,7 @@ from datetime
 from typing                                                                     import Optional, List
 from osbot_utils.decorators.methods.cache_on_self                               import cache_on_self
 from osbot_utils.helpers.Obj_Id                                                 import Obj_Id
-from osbot_utils.helpers.Safe_Id                                                import Safe_Id
+from osbot_utils.type_safe.primitives.safe_str.identifiers.Safe_Id              import Safe_Id
 from osbot_utils.helpers.llms.cache.LLM_Cache__Path_Generator                   import LLM_Cache__Path_Generator
 from osbot_utils.helpers.llms.cache.LLM_Request__Cache                          import LLM_Request__Cache
 from osbot_utils.helpers.llms.cache.LLM_Request__Cache__Storage                 import LLM_Request__Cache__Storage
@@ -11,8 +11,10 @@ from osbot_utils.helpers.llms.schemas.Schema__LLM_Cache__Index
 from osbot_utils.helpers.llms.schemas.Schema__LLM_Request                       import Schema__LLM_Request
 from osbot_utils.helpers.llms.schemas.Schema__LLM_Response                      import Schema__LLM_Response
 from osbot_utils.helpers.llms.schemas.Schema__LLM_Response__Cache               import Schema__LLM_Response__Cache
-from osbot_utils.helpers.safe_str.Safe_Str__File__Path                          import Safe_Str__File__Path
-from osbot_utils.type_safe.decorators.type_safe                                 import type_safe
+from osbot_utils.type_safe.primitives.safe_str.filesystem.Safe_Str__File__Path  import Safe_Str__File__Path
+
+from osbot_utils.type_safe.type_safe_core.decorators.type_safe                  import type_safe
+
 
 class LLM_Request__Cache__File_System(LLM_Request__Cache):
     virtual_storage: Virtual_Storage__Local__Folder    

osbot_utils/helpers/llms/cache/LLM_Request__Cache__Storage.py

@@ -4,10 +4,10 @@ from osbot_utils.decorators.methods.cache_on_self
 from osbot_utils.helpers.llms.cache.Virtual_Storage__Local__Folder              import Virtual_Storage__Local__Folder
 from osbot_utils.helpers.llms.schemas.Schema__LLM_Cache__Index                  import Schema__LLM_Cache__Index
 from osbot_utils.helpers.llms.schemas.Schema__LLM_Response__Cache               import Schema__LLM_Response__Cache
-from osbot_utils.helpers.safe_str.Safe_Str__File__Path                          import Safe_Str__File__Path
 from osbot_utils.type_safe.Type_Safe                                            import Type_Safe
-from osbot_utils.type_safe.decorators.type_safe                                 import type_safe
 from osbot_utils.helpers.Obj_Id                                                 import Obj_Id, is_obj_id
+from osbot_utils.type_safe.primitives.safe_str.filesystem.Safe_Str__File__Path  import Safe_Str__File__Path
+from osbot_utils.type_safe.type_safe_core.decorators.type_safe                  import type_safe
 from osbot_utils.utils.Files                                                    import path_combine_safe, file_name_without_extension, parent_folder
 
 FILE_NAME__CACHE_INDEX            = "cache_index.json"

osbot_utils/helpers/llms/cache/Virtual_Storage__Local__Folder.py

@@ -1,10 +1,10 @@
-from typing                                                         import List, Optional, Dict, Any
-from osbot_utils.decorators.methods.cache_on_self                   import cache_on_self
-from osbot_utils.helpers.safe_str.Safe_Str__File__Path              import Safe_Str__File__Path
-from osbot_utils.type_safe.Type_Safe                                import Type_Safe
-from osbot_utils.type_safe.decorators.type_safe                     import type_safe
-from osbot_utils.utils.Files                                        import current_temp_folder, path_combine_safe, folder_create, file_exists, folder_exists, file_delete, parent_folder, create_folder, files_recursive
-from osbot_utils.utils.Json                                         import json_save_file, json_load_file
+from typing                                                                    import List, Optional, Dict, Any
+from osbot_utils.decorators.methods.cache_on_self                              import cache_on_self
+from osbot_utils.type_safe.Type_Safe                                           import Type_Safe
+from osbot_utils.type_safe.primitives.safe_str.filesystem.Safe_Str__File__Path import Safe_Str__File__Path
+from osbot_utils.type_safe.type_safe_core.decorators.type_safe                 import type_safe
+from osbot_utils.utils.Files                                                   import current_temp_folder, path_combine_safe, folder_create, file_exists, folder_exists, file_delete, parent_folder, create_folder, files_recursive
+from osbot_utils.utils.Json                                                    import json_save_file, json_load_file
 
 class Virtual_Storage__Local__Folder(Type_Safe):
 

osbot_utils/helpers/llms/cache/Virtual_Storage__Sqlite.py

@@ -1,10 +1,10 @@
-from typing                                                         import List, Optional, Dict, Any
-from osbot_utils.decorators.methods.cache_on_self                   import cache_on_self
-from osbot_utils.helpers.safe_str.Safe_Str__File__Path              import Safe_Str__File__Path
-from osbot_utils.helpers.sqlite.domains.Sqlite__DB__Files           import Sqlite__DB__Files
-from osbot_utils.helpers.llms.cache.Virtual_Storage__Local__Folder  import Virtual_Storage__Local__Folder
-from osbot_utils.utils.Files                                        import path_combine_safe
-from osbot_utils.utils.Json                                         import json_parse, json_dumps
+from typing                                                                    import List, Optional, Dict, Any
+from osbot_utils.utils.Files                                                   import path_combine_safe
+from osbot_utils.utils.Json                                                    import json_parse, json_dumps
+from osbot_utils.decorators.methods.cache_on_self                              import cache_on_self
+from osbot_utils.helpers.sqlite.domains.Sqlite__DB__Files                      import Sqlite__DB__Files
+from osbot_utils.helpers.llms.cache.Virtual_Storage__Local__Folder             import Virtual_Storage__Local__Folder
+from osbot_utils.type_safe.primitives.safe_str.filesystem.Safe_Str__File__Path import Safe_Str__File__Path
 
 class Virtual_Storage__Sqlite(Virtual_Storage__Local__Folder):
     db          : Sqlite__DB__Files                                                         # SQLite database for file storage (defaults to an in memory db)

osbot_utils/helpers/llms/schemas/Safe_Str__LLM__Model_Name.py

@@ -1,6 +1,6 @@
 import re
 
-from osbot_utils.helpers.safe_str.Safe_Str import Safe_Str
+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/_\-.:]'

osbot_utils/helpers/llms/schemas/Schema__LLM_Cache__Index.py

@@ -1,8 +1,9 @@
-from typing                                             import Dict
-from osbot_utils.helpers.Obj_Id                         import Obj_Id
-from osbot_utils.helpers.safe_str.Safe_Str__File__Path  import Safe_Str__File__Path
-from osbot_utils.helpers.safe_str.Safe_Str__Hash        import Safe_Str__Hash
-from osbot_utils.type_safe.Type_Safe                    import Type_Safe
+from typing                                                                       import Dict
+from osbot_utils.helpers.Obj_Id                                                   import Obj_Id
+from osbot_utils.type_safe.Type_Safe                                              import Type_Safe
+from osbot_utils.type_safe.primitives.safe_str.cryptography.hashes.Safe_Str__Hash import Safe_Str__Hash
+from osbot_utils.type_safe.primitives.safe_str.filesystem.Safe_Str__File__Path    import Safe_Str__File__Path
+
 
 class Schema__LLM_Cache__Index(Type_Safe):
     cache_id__from__hash__request : Dict[Safe_Str__Hash, Obj_Id]                     # map hash of the full request to a Schema__LLM_Response__Cache to the cache_id

osbot_utils/helpers/llms/schemas/Schema__LLM_Request__Data.py

@@ -2,8 +2,9 @@ from typing                                                                 impo
 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.helpers.safe_str.Safe_Str__Text                            import Safe_Str__Text
 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
+
 
 class Schema__LLM_Request__Data(Type_Safe):                                         # Schema for LLM API request data
     model         : Safe_Str__LLM__Model_Name                                       # LLM model identifier

osbot_utils/helpers/llms/schemas/Schema__LLM_Response.py

@@ -1,5 +1,5 @@
 from osbot_utils.helpers.Obj_Id         import Obj_Id
-from osbot_utils.helpers.Timestamp_Now  import Timestamp_Now
+from osbot_utils.type_safe.primitives.safe_int.Timestamp_Now  import Timestamp_Now
 from osbot_utils.type_safe.Type_Safe    import Type_Safe
 
 

osbot_utils/helpers/llms/schemas/Schema__LLM_Response__Cache.py

@@ -1,9 +1,10 @@
-from osbot_utils.helpers.Obj_Id                             import Obj_Id
-from osbot_utils.helpers.Timestamp_Now                      import Timestamp_Now
-from osbot_utils.helpers.llms.schemas.Schema__LLM_Request   import Schema__LLM_Request
-from osbot_utils.helpers.llms.schemas.Schema__LLM_Response  import Schema__LLM_Response
-from osbot_utils.helpers.safe_str.Safe_Str__Hash            import Safe_Str__Hash
-from osbot_utils.type_safe.Type_Safe                        import Type_Safe
+from osbot_utils.helpers.Obj_Id                                                   import Obj_Id
+from osbot_utils.type_safe.primitives.safe_int.Timestamp_Now                       import Timestamp_Now
+from osbot_utils.helpers.llms.schemas.Schema__LLM_Request                         import Schema__LLM_Request
+from osbot_utils.helpers.llms.schemas.Schema__LLM_Response                        import Schema__LLM_Response
+from osbot_utils.type_safe.Type_Safe                                              import Type_Safe
+from osbot_utils.type_safe.primitives.safe_str.cryptography.hashes.Safe_Str__Hash import Safe_Str__Hash
+
 
 class Schema__LLM_Response__Cache(Type_Safe):
     cache_id          : Obj_Id

osbot_utils/helpers/xml/rss/RSS__Feed__Parser.py

@@ -1,5 +1,5 @@
 from typing                                     import Dict, Any
-from osbot_utils.helpers.Guid                   import Guid
+from osbot_utils.type_safe.primitives.safe_str.identifiers.Guid                   import Guid
 from osbot_utils.helpers.xml.rss.RSS__Channel   import RSS__Channel
 from osbot_utils.helpers.xml.rss.RSS__Feed      import RSS__Feed
 from osbot_utils.helpers.xml.rss.RSS__Image     import RSS__Image

osbot_utils/helpers/xml/rss/RSS__Item.py

@@ -1,6 +1,6 @@
 from typing                                         import Dict, List, Any
 from osbot_utils.type_safe.Type_Safe             import Type_Safe
-from osbot_utils.helpers.Guid                       import Guid
+from osbot_utils.type_safe.primitives.safe_str.identifiers.Guid                       import Guid
 from osbot_utils.helpers.xml.rss.RSS__Enclosure     import RSS__Enclosure
 
 class RSS__Item(Type_Safe):

osbot_utils/type_safe/Type_Safe.py

@@ -1,12 +1,12 @@
 # todo: find a way to add these documentations strings to a separate location so that
 #       the data is available in IDE's code complete
-from osbot_utils.type_safe.shared.Type_Safe__Validation             import type_safe_validation
-from osbot_utils.type_safe.steps.Type_Safe__Step__Class_Kwargs      import type_safe_step_class_kwargs
-from osbot_utils.type_safe.steps.Type_Safe__Step__Default_Kwargs    import type_safe_step_default_kwargs
-from osbot_utils.type_safe.steps.Type_Safe__Step__Default_Value     import type_safe_step_default_value
-from osbot_utils.type_safe.steps.Type_Safe__Step__Init              import type_safe_step_init
-from osbot_utils.type_safe.steps.Type_Safe__Step__Set_Attr          import type_safe_step_set_attr
-from osbot_utils.utils.Objects                                      import serialize_to_dict
+from osbot_utils.type_safe.type_safe_core.shared.Type_Safe__Validation import type_safe_validation
+from osbot_utils.type_safe.type_safe_core.steps.Type_Safe__Step__Class_Kwargs   import type_safe_step_class_kwargs
+from osbot_utils.type_safe.type_safe_core.steps.Type_Safe__Step__Default_Kwargs  import type_safe_step_default_kwargs
+from osbot_utils.type_safe.type_safe_core.steps.Type_Safe__Step__Default_Value  import type_safe_step_default_value
+from osbot_utils.type_safe.type_safe_core.steps.Type_Safe__Step__Init           import type_safe_step_init
+from osbot_utils.type_safe.type_safe_core.steps.Type_Safe__Step__Set_Attr       import type_safe_step_set_attr
+from osbot_utils.utils.Objects                                                  import serialize_to_dict
 
 class Type_Safe:
 
@@ -63,7 +63,7 @@ class Type_Safe:
         return self.serialize_to_dict()
 
     def json__compress(self):                                           # todo: see if this is the best place to put these Type_Safe__Json_Compressor methods
-        from osbot_utils.type_safe.shared.Type_Safe__Json_Compressor import Type_Safe__Json_Compressor
+        from osbot_utils.type_safe.type_safe_core.shared.Type_Safe__Json_Compressor import Type_Safe__Json_Compressor
         return Type_Safe__Json_Compressor().compress(self)
 
     # todo: see if we still need this. now that Type_Safe handles base types, there should be no need for this
@@ -107,11 +107,12 @@ class Type_Safe:
 
     @classmethod
     def from_json(cls, json_data, raise_on_not_found=False):
-        from osbot_utils.type_safe.steps.Type_Safe__Step__From_Json import type_safe_step_from_json     # circular dependency on Type_Safe
+        from osbot_utils.type_safe.type_safe_core.steps.Type_Safe__Step__From_Json import type_safe_step_from_json      # circular dependency on Type_Safe
         return type_safe_step_from_json.from_json(cls, json_data, raise_on_not_found)
 
     @classmethod
     def from_json__compressed(cls, json_data):                          # todo: see if this is the best place to put these Type_Safe__Json_Compressor methods
-        from osbot_utils.type_safe.shared.Type_Safe__Json_Compressor import Type_Safe__Json_Compressor
+
+        from osbot_utils.type_safe.type_safe_core.shared.Type_Safe__Json_Compressor import Type_Safe__Json_Compressor
         json_data__decompressed = Type_Safe__Json_Compressor().decompress(json_data)
         return cls.from_json(json_data__decompressed)

osbot_utils/type_safe/Type_Safe__Base.py

@@ -1,7 +1,7 @@
 import types
-from typing                                         import get_args, Union, Optional, Any, ForwardRef
-from osbot_utils.helpers.Obj_Id                     import Obj_Id
-from osbot_utils.type_safe.shared.Type_Safe__Cache  import type_safe_cache
+from typing                                                       import get_args, Union, Optional, Any, ForwardRef
+from osbot_utils.helpers.Obj_Id                                   import Obj_Id
+from osbot_utils.type_safe.type_safe_core.shared.Type_Safe__Cache import type_safe_cache
 
 EXACT_TYPE_MATCH = (int, float, str, bytes, bool, complex)
 

osbot_utils/{helpers → type_safe/primitives}/safe_float/Safe_Float__Engineering.py

@@ -1,4 +1,5 @@
-from osbot_utils.helpers.safe_float.Safe_Float import Safe_Float
+from osbot_utils.type_safe.primitives.safe_float.Safe_Float import Safe_Float
+
 
 class Safe_Float__Engineering(Safe_Float):          # Engineering calculations with controlled precision
     #decimal_places  = 6

osbot_utils/{helpers → type_safe/primitives}/safe_float/Safe_Float__Money.py

@@ -1,5 +1,4 @@
-# Safe_Float__Money.py
-from osbot_utils.helpers.safe_float.Safe_Float import Safe_Float
+from osbot_utils.type_safe.primitives.safe_float.Safe_Float import Safe_Float
 
 
 class Safe_Float__Money(Safe_Float):    # Money calculations with exact decimal arithmetic

osbot_utils/{helpers → type_safe/primitives}/safe_float/Safe_Float__Percentage_Exact.py

@@ -1,4 +1,4 @@
-from osbot_utils.helpers.safe_float.Safe_Float import Safe_Float
+from osbot_utils.type_safe.primitives.safe_float.Safe_Float import Safe_Float
 
 
 class Safe_Float__Percentage_Exact(Safe_Float):         # Exact percentage calculations

osbot_utils/{helpers → type_safe/primitives}/safe_int/Safe_Int.py

@@ -1,6 +1,6 @@
-from typing                                     import Optional, Union
-from osbot_utils.helpers.safe_float.Safe_Float  import Safe_Float
-from osbot_utils.type_safe.Type_Safe__Primitive import Type_Safe__Primitive
+from typing                                                 import Optional, Union
+from osbot_utils.type_safe.Type_Safe__Primitive             import Type_Safe__Primitive
+from osbot_utils.type_safe.primitives.safe_float.Safe_Float import Safe_Float
 
 
 class Safe_Int(Type_Safe__Primitive, int):            # Base class for type-safe integers with validation rules

osbot_utils/{helpers → type_safe/primitives}/safe_int/__init__.py

@@ -1,4 +1,4 @@
-from osbot_utils.helpers.safe_int.Safe_Int import Safe_Int
+from osbot_utils.type_safe.primitives.safe_int.Safe_Int import Safe_Int
 
 TYPE_SAFE_INT__BYTE__MIN_VALUE = 0
 TYPE_SAFE_INT__BYTE__MAX_VALUE = 255

osbot_utils/{helpers → type_safe/primitives}/safe_str/Safe_Str.py

@@ -1,7 +1,7 @@
 import re
-from typing                                                          import Optional
-from osbot_utils.helpers.safe_str.schemas.Enum__Safe_Str__Regex_Mode import Enum__Safe_Str__Regex_Mode
-from osbot_utils.type_safe.Type_Safe__Primitive                      import Type_Safe__Primitive
+from typing                                                               import Optional
+from osbot_utils.type_safe.Type_Safe__Primitive                           import Type_Safe__Primitive
+from osbot_utils.type_safe.primitives.safe_str.Enum__Safe_Str__Regex_Mode import Enum__Safe_Str__Regex_Mode
 
 TYPE_SAFE__STR__REGEX__SAFE_STR = re.compile(r'[^a-zA-Z0-9]')    # Only allow alphanumerics and numbers
 TYPE_SAFE__STR__MAX_LENGTH      = 512

osbot_utils/{helpers/safe_str → type_safe/primitives/safe_str/cryptography/hashes}/Safe_Str__Hash.py

@@ -1,7 +1,7 @@
 import re
-from typing                                 import Any
-from osbot_utils.helpers.safe_str.Safe_Str  import Safe_Str
-from osbot_utils.utils.Misc                 import bytes_md5
+from typing                                              import Any
+from osbot_utils.type_safe.primitives.safe_str.Safe_Str  import Safe_Str
+from osbot_utils.utils.Misc                              import bytes_md5
 
 # Constants for hash validation
 SIZE__VALUE_HASH           = 10

osbot_utils/type_safe/primitives/safe_str/cryptography/hashes/Safe_Str__SHA1.py

@@ -0,0 +1,26 @@
+import re
+
+from osbot_utils.type_safe.primitives.safe_str.Enum__Safe_Str__Regex_Mode import Enum__Safe_Str__Regex_Mode
+from osbot_utils.type_safe.primitives.safe_str.Safe_Str                           import Safe_Str
+
+
+# Full 40-character commit SHA
+TYPE_SAFE_STR__GITHUB__SHA__REGEX = re.compile(r'^[a-fA-F0-9]{40}$')
+TYPE_SAFE_STR__GITHUB__SHA__LENGTH = 40
+
+# todo: move to OSBot_Utils
+class Safe_Str__SHA1(Safe_Str):
+    """
+    Safe string class for full 40-character Git commit SHAs.
+
+    Examples:
+    - "7fd1a60b01f91b314f59955a4e4d4e80d8edf11d"
+    - "abc1234567890abcdef1234567890abcdef12345"
+    """
+    regex             = TYPE_SAFE_STR__GITHUB__SHA__REGEX
+    regex_mode        = Enum__Safe_Str__Regex_Mode.MATCH
+    max_length        = TYPE_SAFE_STR__GITHUB__SHA__LENGTH
+    exact_length      = True
+    allow_empty       = False
+    trim_whitespace   = True
+    strict_validation = True

osbot_utils/type_safe/primitives/safe_str/cryptography/hashes/Safe_Str__SHA1__Short.py

@@ -0,0 +1,24 @@
+import re
+from osbot_utils.type_safe.primitives.safe_str.Enum__Safe_Str__Regex_Mode import Enum__Safe_Str__Regex_Mode
+from osbot_utils.type_safe.primitives.safe_str.Safe_Str                   import Safe_Str
+
+
+TYPE_SAFE_STR__GITHUB__SHA_SHORT__REGEX  = re.compile(r'^[a-fA-F0-9]{7}$')
+TYPE_SAFE_STR__GITHUB__SHA_SHORT__LENGTH = 7
+
+# todo: move to OSBot_Utils
+class Safe_Str__SHA1__Short(Safe_Str):
+    """
+    Safe string class for short 7-character Git commit SHAs.
+
+    Examples:
+    - "7fd1a60"
+    - "abc1234"
+    """
+    regex             = TYPE_SAFE_STR__GITHUB__SHA_SHORT__REGEX
+    regex_mode        = Enum__Safe_Str__Regex_Mode.MATCH
+    max_length        = TYPE_SAFE_STR__GITHUB__SHA_SHORT__LENGTH
+    exact_length      = True
+    allow_empty       = False
+    trim_whitespace   = True
+    strict_validation = True

osbot_utils/type_safe/primitives/safe_str/cryptography/nacl/Safe_Str__NaCl__Private_Key.py

@@ -0,0 +1,27 @@
+import re
+from osbot_utils.type_safe.primitives.safe_str.Safe_Str                   import Safe_Str
+from osbot_utils.type_safe.primitives.safe_str.Enum__Safe_Str__Regex_Mode import Enum__Safe_Str__Regex_Mode
+
+TYPE_SAFE_STR__NACL__PRIVATE_KEY__REGEX  = re.compile(r'^[a-fA-F0-9]{64}$')
+TYPE_SAFE_STR__NACL__PRIVATE_KEY__LENGTH = 64  # 32 bytes as hex = 64 characters
+
+class Safe_Str__NaCl__Private_Key(Safe_Str):
+    """
+    Safe string class for NaCl (Curve25519) private keys in hexadecimal format.
+
+    NaCl private keys are 32 bytes (256 bits), represented as 64 hexadecimal characters.
+    These keys are used with libsodium/PyNaCl for asymmetric encryption.
+
+    Examples:
+    - "d4c8f7e3a2b1c9d8e7f6a5b4c3d2e1f0a9b8c7d6e5f4a3b2c1d0e9f8a7b6c5d4e3"
+    - "1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
+
+    Security Note: Private keys should NEVER be exposed or logged.
+    """
+    regex             = TYPE_SAFE_STR__NACL__PRIVATE_KEY__REGEX
+    regex_mode        = Enum__Safe_Str__Regex_Mode.MATCH
+    max_length        = TYPE_SAFE_STR__NACL__PRIVATE_KEY__LENGTH
+    exact_length      = True
+    allow_empty       = False
+    trim_whitespace   = True
+    strict_validation = True