mgraph-ai-service-cache-client 0.18.0__tar.gz → 0.23.0__tar.gz

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: mgraph_ai_service_cache__client
-Version: 0.18.0
+Version: 0.23.0
 Summary: MGraph-AI__Service__Cache__Client
 Home-page: https://github.com/the-cyber-boardroom/MGraph-AI__Service__Cache__Client
 License: Apache 2.0
@@ -16,7 +16,7 @@ Description-Content-Type: text/markdown
 
 # MGraph AI Service Cache Client
 
-[![Current Release](https://img.shields.io/badge/release-v0.18.0-blue)](https://github.com/the-cyber-boardroom/MGraph-AI__Service__Cache__Client/releases)
+[![Current Release](https://img.shields.io/badge/release-v0.23.0-blue)](https://github.com/the-cyber-boardroom/MGraph-AI__Service__Cache__Client/releases)
 [![Python](https://img.shields.io/badge/python-3.12-blue)](https://www.python.org/downloads/)
 [![FastAPI](https://img.shields.io/badge/FastAPI-0.116.1-009688)](https://fastapi.tiangolo.com/)
 [![AWS Lambda](https://img.shields.io/badge/AWS-Lambda-orange)](https://aws.amazon.com/lambda/)

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/README.md

@@ -1,6 +1,6 @@
 # MGraph AI Service Cache Client
 
-[![Current Release](https://img.shields.io/badge/release-v0.18.0-blue)](https://github.com/the-cyber-boardroom/MGraph-AI__Service__Cache__Client/releases)
+[![Current Release](https://img.shields.io/badge/release-v0.23.0-blue)](https://github.com/the-cyber-boardroom/MGraph-AI__Service__Cache__Client/releases)
 [![Python](https://img.shields.io/badge/python-3.12-blue)](https://www.python.org/downloads/)
 [![FastAPI](https://img.shields.io/badge/FastAPI-0.116.1-009688)](https://fastapi.tiangolo.com/)
 [![AWS Lambda](https://img.shields.io/badge/AWS-Lambda-orange)](https://aws.amazon.com/lambda/)

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/client/client_contract/data/Service__Fast_API__Client__Data__Retrieve.py

@@ -20,8 +20,9 @@ class Service__Fast_API__Client__Data__Retrieve(Type_Safe):
             path   = path,
             body   = body
         )
-                                                                                    # Return response data
-        return result.json if result.json else result.text
+        if result.status_code == 200:                                                                            # Return response data
+            return result.json
+        return None
 
     def data__json__with__id_and_key(self, cache_id: str, namespace: str, data_key: str, data_file_id: str) -> Dict:                              # Auto-generated from endpoint get__data__json__with__id_and_key
                                                                                     # Build path
@@ -33,8 +34,9 @@ class Service__Fast_API__Client__Data__Retrieve(Type_Safe):
             path   = path,
             body   = body
         )
-                                                                                    # Return response data
-        return result.json if result.json else result.text
+        if result.status_code == 200:                                                                                       # Return response data
+            return result.json
+        return None
 
     @type_safe
     def data__string__with__id(self,
@@ -82,8 +84,9 @@ class Service__Fast_API__Client__Data__Retrieve(Type_Safe):
             path   = path,
             body   = body
         )
-        return result.content
-        #return result.json if result.json else result.text                         # Return response data
+        if result.status_code == 200:                                                                                       # Return response data
+            return result.content
+        return None
 
     def data__binary__with__id_and_key(self, cache_id: str, namespace: str, data_key: str, data_file_id: str) -> Dict:                              # Auto-generated from endpoint get__data__binary__with__id_and_key
                                                                                     # Build path
@@ -95,5 +98,6 @@ class Service__Fast_API__Client__Data__Retrieve(Type_Safe):
             path   = path,
             body   = body
         )
-        return result.content
-        return result.json if result.json else result.text                          # Return response data
+        if result.status_code == 200:                                                                                       # Return response data
+            return result.content
+        return None

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/client/client_contract/namespace/Service__Fast_API__Client__Namespace.py

@@ -1,7 +1,7 @@
 from typing                                                                                    import Dict, List
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                             import Cache_Id
 from osbot_utils.type_safe.Type_Safe                                                           import Type_Safe
 from osbot_utils.type_safe.primitives.domains.cryptography.safe_str.Safe_Str__Cache_Hash       import Safe_Str__Cache_Hash
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid                          import Random_Guid
 from osbot_utils.type_safe.primitives.domains.identifiers.safe_str.Safe_Str__Id                import Safe_Str__Id
 from osbot_utils.type_safe.type_safe_core.collections.Type_Safe__List                          import Type_Safe__List
 from osbot_utils.type_safe.type_safe_core.decorators.type_safe                                 import type_safe
@@ -34,7 +34,7 @@ class Service__Fast_API__Client__Namespace(Type_Safe):
     @type_safe
     def cache_ids(self,
                   namespace: Safe_Str__Id
-             ) -> List[Random_Guid]:
+             ) -> List[Cache_Id]:
                                                                                     # Build path
         path = f"/{namespace}/file-ids"                                             # todo: BUG: rename file_ids to cache_ids     (after client refactor)
         body = None

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/client/client_contract/update/Service__Fast_API__Client__File__Update.py

@@ -1,6 +1,6 @@
 from typing                                                                          import Any
 from osbot_utils.type_safe.Type_Safe                                                 import Type_Safe
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid                import Random_Guid
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                   import Cache_Id
 from osbot_utils.type_safe.primitives.domains.identifiers.safe_str.Safe_Str__Id      import Safe_Str__Id
 from mgraph_ai_service_cache_client.schemas.cache.Schema__Cache__Update__Response    import Schema__Cache__Update__Response
 
@@ -13,7 +13,7 @@ class Service__Fast_API__Client__File__Update(Type_Safe):
         return self._client.requests()
 
     def update__string(self,
-                       cache_id : Random_Guid   ,
+                       cache_id : Cache_Id   ,
                        namespace: Safe_Str__Id  ,
                        body     : str
                   ) -> Schema__Cache__Update__Response:                            # Update string data in existing cache entry
@@ -29,7 +29,7 @@ class Service__Fast_API__Client__File__Update(Type_Safe):
         return Schema__Cache__Update__Response.from_json(result.json)
 
     def update__json(self,
-                     cache_id : Random_Guid   ,
+                     cache_id : Cache_Id   ,
                      namespace: Safe_Str__Id  ,
                      body     : dict
                 ) -> Schema__Cache__Update__Response:                              # Update JSON data in existing cache entry
@@ -45,7 +45,7 @@ class Service__Fast_API__Client__File__Update(Type_Safe):
         return Schema__Cache__Update__Response.from_json(result.text)
 
     def update__binary(self,
-                       cache_id : Random_Guid   ,
+                       cache_id : Cache_Id   ,
                        namespace: Safe_Str__Id  ,
                        body     : bytes
                   ) -> Schema__Cache__Update__Response:                            # Update binary data in existing cache entry

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/client/decorator/cache_operations/Cache__Key__Builder.py

@@ -6,8 +6,8 @@ from osbot_utils.type_safe.Type_Safe
 from osbot_utils.type_safe.Type_Safe__Primitive                                                 import Type_Safe__Primitive
 from osbot_utils.type_safe.primitives.domains.cryptography.safe_str.Safe_Str__Cache_Hash        import Safe_Str__Cache_Hash
 from osbot_utils.type_safe.primitives.domains.files.safe_str.Safe_Str__File__Path               import Safe_Str__File__Path
-from osbot_utils.type_safe.primitives.domains.identifiers.safe_str.Safe_Str__Python__Identifier import Safe_Str__Python__Identifier
 from osbot_utils.type_safe.primitives.domains.identifiers.safe_str.Safe_Str__Json__Field_Path   import Safe_Str__Json__Field_Path
+from osbot_utils.type_safe.primitives.domains.python.safe_str.Safe_Str__Python__Identifier      import Safe_Str__Python__Identifier
 from osbot_utils.type_safe.type_safe_core.decorators.type_safe                                  import type_safe
 from osbot_utils.helpers.cache.Cache__Hash__Generator                                           import Cache__Hash__Generator
 from mgraph_ai_service_cache_client.client.decorator.schemas.Schema__Cache__Decorator__Config   import Schema__Cache__Decorator__Config

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/client/testing/Cache_Client_Test_Helpers.py

@@ -11,7 +11,7 @@ Usage:
 """
 
 from typing                                                                                      import Dict, List, Tuple
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid                            import Random_Guid
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                               import Cache_Id
 from osbot_utils.utils.Misc                                                                      import random_string, random_bytes, str_to_bytes
 from osbot_utils.type_safe.Type_Safe                                                             import Type_Safe
 from osbot_utils.type_safe.type_safe_core.decorators.type_safe                                   import type_safe
@@ -50,8 +50,8 @@ class Cache_Client_Test_Helpers(Type_Safe):
                                                   file_id    = file_id or '')
             else:
                 return _.store__string(strategy  = strategy  ,
-                                      namespace = namespace ,
-                                      body      = value     )
+                                       namespace = namespace ,
+                                       body      = value     )
 
     @type_safe
     def create_json_entry(self,
@@ -211,7 +211,7 @@ class Cache_Client_Test_Helpers(Type_Safe):
                                     json_count     : int = 2    ,
                                     binary_count   : int = 1    ,
                                     use_data_keys  : bool = False
-                               ) -> Tuple[Random_Guid, Schema__Cache__Store__Response, List[str]]:
+                               ) -> Tuple[Cache_Id, Schema__Cache__Store__Response, List[str]]:
         """
         Create a cache entry with multiple data files attached
 

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/schemas/cache/Schema__Cache__Binary__Reference.py

@@ -2,7 +2,7 @@ from osbot_utils.type_safe.Type_Safe
 from osbot_utils.type_safe.primitives.core.Safe_UInt                                      import Safe_UInt
 from osbot_utils.type_safe.primitives.domains.common.safe_str.Safe_Str__Text              import Safe_Str__Text
 from osbot_utils.type_safe.primitives.domains.files.safe_str.Safe_Str__File__Path         import Safe_Str__File__Path
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid                     import Random_Guid
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                        import Cache_Id
 from osbot_utils.type_safe.primitives.domains.identifiers.safe_str.Safe_Str__Id           import Safe_Str__Id
 from osbot_utils.type_safe.primitives.domains.cryptography.safe_str.Safe_Str__Cache_Hash  import Safe_Str__Cache_Hash
 from mgraph_ai_service_cache_client.schemas.cache.enums.Enum__Cache__Data_Type            import Enum__Cache__Data_Type
@@ -15,7 +15,7 @@ class Schema__Cache__Binary__Reference(Type_Safe):      # Reference to binary da
     data_type    : Enum__Cache__Data_Type               # Always BINARY
     size         : Safe_UInt                            # Size of binary data
     cache_hash   : Safe_Str__Cache_Hash                 # Hash of the data
-    cache_id     : Random_Guid                          # ID of the entry
+    cache_id     : Cache_Id                          # ID of the entry
     namespace    : Safe_Str__Id                         # Namespace
     binary_url   : Safe_Str__File__Path                 # URL to retrieve binary data
     metadata     : Schema__Cache__Metadata              # Full metadata

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/schemas/cache/Schema__Cache__Delete__Success.py

@@ -3,13 +3,13 @@ from osbot_utils.type_safe.Type_Safe
 from osbot_utils.type_safe.primitives.core.Safe_UInt                              import Safe_UInt
 from osbot_utils.type_safe.primitives.domains.common.safe_str.Safe_Str__Text      import Safe_Str__Text
 from osbot_utils.type_safe.primitives.domains.files.safe_str.Safe_Str__File__Path import Safe_Str__File__Path
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid             import Random_Guid
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                import Cache_Id
 from osbot_utils.type_safe.primitives.domains.identifiers.safe_str.Safe_Str__Id   import Safe_Str__Id
 
 # todo: this needs to be refactored to handle more cases (not just the success)
 # Response for delete operations
 class Schema__Cache__Delete__Success(Type_Safe):                                      # Successful deletion
-    cache_id       : Random_Guid                                                      # ID that was deleted
+    cache_id       : Cache_Id                                                      # ID that was deleted
     namespace      : Safe_Str__Id                                                     # Namespace it was in
     deleted_count  : Safe_UInt                                                        # Number of files deleted
     deleted_paths  : List[Safe_Str__File__Path]                                       # Paths that were deleted

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/schemas/cache/Schema__Cache__Exists__Response.py

@@ -1,5 +1,5 @@
 from osbot_utils.type_safe.Type_Safe                                                        import Type_Safe
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid                       import Random_Guid
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                          import Cache_Id
 from osbot_utils.type_safe.primitives.domains.identifiers.safe_str.Safe_Str__Id             import Safe_Str__Id
 from osbot_utils.type_safe.primitives.domains.cryptography.safe_str.Safe_Str__Cache_Hash    import Safe_Str__Cache_Hash
 from mgraph_ai_service_cache_client.schemas.cache.Schema__Cache__Metadata                   import Schema__Cache__Metadata
@@ -10,5 +10,5 @@ class Schema__Cache__Exists__Response(Type_Safe):
     exists       : bool                                                               # Whether entry exists
     cache_hash   : Safe_Str__Cache_Hash                                               # Hash that was checked
     namespace    : Safe_Str__Id                                                       # Namespace checked
-    cache_id     : Random_Guid             = None                                     # ID if it exists
+    cache_id     : Cache_Id             = None                                     # ID if it exists
     metadata     : Schema__Cache__Metadata = None                                     # Metadata if it exists

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/schemas/cache/Schema__Cache__Metadata.py

@@ -1,7 +1,7 @@
 from osbot_utils.type_safe.Type_Safe                                                        import Type_Safe
 from osbot_utils.type_safe.primitives.core.Safe_UInt                                        import Safe_UInt
 from osbot_utils.type_safe.primitives.domains.common.safe_str.Safe_Str__Text                import Safe_Str__Text
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid                       import Random_Guid
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                          import Cache_Id
 from osbot_utils.type_safe.primitives.domains.identifiers.safe_int.Timestamp_Now            import Timestamp_Now
 from osbot_utils.type_safe.primitives.domains.identifiers.safe_str.Safe_Str__Id             import Safe_Str__Id
 from osbot_utils.type_safe.primitives.domains.cryptography.safe_str.Safe_Str__Cache_Hash    import Safe_Str__Cache_Hash
@@ -11,7 +11,7 @@ from mgraph_ai_service_cache_client.schemas.cache.enums.Enum__Cache__Store__Stra
 
 # Base response metadata that all responses share
 class Schema__Cache__Metadata(Type_Safe):                                             # Metadata about cached entry
-    cache_id         : Random_Guid                  = None                            # Unique ID of this cache entry
+    cache_id         : Cache_Id                  = None                            # Unique ID of this cache entry
     cache_hash       : Safe_Str__Cache_Hash         = None                            # Content hash
     cache_key        : Safe_Str__Text               = None                            # Optional semantic key
     file_id          : Safe_Str__Id                 = None                            # Optional file ID

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/schemas/cache/Schema__Cache__Retrieve__Request.py

@@ -1,11 +1,11 @@
-from osbot_utils.type_safe.Type_Safe                                                import Type_Safe
+from osbot_utils.type_safe.Type_Safe                                                        import Type_Safe
 from osbot_utils.type_safe.primitives.domains.cryptography.safe_str.Safe_Str__Cache_Hash    import Safe_Str__Cache_Hash
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid              import Random_Guid
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                          import Cache_Id
 
 
 class Schema__Cache__Retrieve__Request(Type_Safe):  # Request schema for retrieving cache data
     cache_hash      : Safe_Str__Cache_Hash  = None
-    cache_id        : Random_Guid           = None
+    cache_id        : Cache_Id           = None
     include_data    : bool                  = True
     include_metadata: bool                  = True
     include_config  : bool                  = True

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/schemas/cache/Schema__Cache__Store__Response.py

@@ -1,14 +1,14 @@
 from typing                                                                                 import List, Dict
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                          import Cache_Id
 from osbot_utils.type_safe.Type_Safe                                                        import Type_Safe
 from osbot_utils.type_safe.primitives.core.Safe_UInt                                        import Safe_UInt
 from osbot_utils.type_safe.primitives.domains.files.safe_str.Safe_Str__File__Path           import Safe_Str__File__Path
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid                       import Random_Guid
 from osbot_utils.type_safe.primitives.domains.identifiers.safe_str.Safe_Str__Id             import Safe_Str__Id
 from osbot_utils.type_safe.primitives.domains.cryptography.safe_str.Safe_Str__Cache_Hash    import Safe_Str__Cache_Hash
 
 
 class Schema__Cache__Store__Response(Type_Safe):
-    cache_id   : Random_Guid
+    cache_id   : Cache_Id
     cache_hash : Safe_Str__Cache_Hash
     namespace  : Safe_Str__Id
     paths      : Dict[str,List[Safe_Str__File__Path]]                     # Structured paths

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/schemas/cache/Schema__Cache__Update__Response.py

@@ -1,15 +1,15 @@
 from typing                                                                                 import List
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                          import Cache_Id
 from osbot_utils.type_safe.Type_Safe                                                        import Type_Safe
 from osbot_utils.type_safe.primitives.core.Safe_UInt                                        import Safe_UInt
 from osbot_utils.type_safe.primitives.domains.cryptography.safe_str.Safe_Str__Cache_Hash    import Safe_Str__Cache_Hash
 from osbot_utils.type_safe.primitives.domains.files.safe_str.Safe_Str__File__Path           import Safe_Str__File__Path
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid                       import Random_Guid
 from osbot_utils.type_safe.primitives.domains.identifiers.safe_int.Timestamp_Now            import Timestamp_Now
 from osbot_utils.type_safe.primitives.domains.identifiers.safe_str.Safe_Str__Id             import Safe_Str__Id
 
 
 class Schema__Cache__Update__Response(Type_Safe):                      # Response for cache update operations
-    cache_id         : Random_Guid                                      # Cache entry ID (unchanged)
+    cache_id         : Cache_Id                                        # Cache entry ID (unchanged)
     cache_hash       : Safe_Str__Cache_Hash                             # Content hash (V1: unchanged)
     namespace        : Safe_Str__Id                                     # Namespace
     paths            : List[Safe_Str__File__Path]                       # All updated file paths

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/schemas/cache/data/Schema__Cache__Data__Files__List.py

@@ -1,12 +1,12 @@
 from typing                                                                         import List
 from osbot_utils.type_safe.Type_Safe                                                import Type_Safe
 from osbot_utils.type_safe.primitives.domains.files.safe_str.Safe_Str__File__Path   import Safe_Str__File__Path
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid               import Random_Guid
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                  import Cache_Id
 from osbot_utils.type_safe.primitives.domains.identifiers.safe_str.Safe_Str__Id     import Safe_Str__Id
 
 
 class Schema__Cache__Data__Files__List(Type_Safe):
-    cache_id  : Random_Guid                 = None
+    cache_id  : Cache_Id                 = None
     namespace : Safe_Str__Id                = None
     data_key  : Safe_Str__File__Path        = None
     data_files : List[Safe_Str__File__Path]

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/schemas/cache/data/Schema__Cache__Data__Retrieve__Request.py

@@ -1,13 +1,13 @@
 from osbot_utils.type_safe.Type_Safe                                                import Type_Safe
 from osbot_utils.type_safe.primitives.domains.files.safe_str.Safe_Str__File__Path   import Safe_Str__File__Path
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid               import Random_Guid
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                  import Cache_Id
 from osbot_utils.type_safe.primitives.domains.identifiers.safe_str.Safe_Str__Id     import Safe_Str__Id
-from mgraph_ai_service_cache_client.schemas.cache.consts__Cache_Service                    import DEFAULT_CACHE__NAMESPACE
-from mgraph_ai_service_cache_client.schemas.cache.enums.Enum__Cache__Data_Type             import Enum__Cache__Data_Type
+from mgraph_ai_service_cache_client.schemas.cache.consts__Cache_Service             import DEFAULT_CACHE__NAMESPACE
+from mgraph_ai_service_cache_client.schemas.cache.enums.Enum__Cache__Data_Type      import Enum__Cache__Data_Type
 
 
 class Schema__Cache__Data__Retrieve__Request(Type_Safe):
-    cache_id     : Random_Guid               = None
+    cache_id     : Cache_Id               = None
     data_type    : Enum__Cache__Data_Type    = None  # Required: 'string', 'json', or 'binary'
     data_key     : Safe_Str__File__Path      = None
     data_file_id : Safe_Str__Id              = None

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/schemas/cache/data/Schema__Cache__Data__Store__Request.py

@@ -1,14 +1,14 @@
 from typing                                                                         import Union
 from osbot_utils.type_safe.Type_Safe                                                import Type_Safe
 from osbot_utils.type_safe.primitives.domains.files.safe_str.Safe_Str__File__Path   import Safe_Str__File__Path
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid               import Random_Guid
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                  import Cache_Id
 from osbot_utils.type_safe.primitives.domains.identifiers.safe_str.Safe_Str__Id     import Safe_Str__Id
-from mgraph_ai_service_cache_client.schemas.cache.consts__Cache_Service                    import DEFAULT_CACHE__NAMESPACE
-from mgraph_ai_service_cache_client.schemas.cache.enums.Enum__Cache__Data_Type             import Enum__Cache__Data_Type
+from mgraph_ai_service_cache_client.schemas.cache.consts__Cache_Service             import DEFAULT_CACHE__NAMESPACE
+from mgraph_ai_service_cache_client.schemas.cache.enums.Enum__Cache__Data_Type      import Enum__Cache__Data_Type
 
 
 class Schema__Cache__Data__Store__Request(Type_Safe):
-    cache_id    : Random_Guid               = None
+    cache_id    : Cache_Id               = None
     data        : Union[str, dict, bytes]   = None                           # Data to store as child
     data_type   : Enum__Cache__Data_Type    = None                           # Type: 'string', 'json', or 'binary'
     data_key    : Safe_Str__File__Path      = None

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/schemas/cache/data/Schema__Cache__Data__Store__Response.py

@@ -1,16 +1,16 @@
 from typing                                                                                 import List, Dict
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                          import Cache_Id
 from osbot_utils.type_safe.Type_Safe                                                        import Type_Safe
 from osbot_utils.type_safe.primitives.core.Safe_UInt                                        import Safe_UInt
 from osbot_utils.type_safe.primitives.domains.files.safe_str.Safe_Str__File__Path           import Safe_Str__File__Path
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid                       import Random_Guid
-from osbot_utils.type_safe.primitives.domains.identifiers.safe_int.Timestamp_Now import Timestamp_Now
+from osbot_utils.type_safe.primitives.domains.identifiers.safe_int.Timestamp_Now            import Timestamp_Now
 from osbot_utils.type_safe.primitives.domains.identifiers.safe_str.Safe_Str__Id             import Safe_Str__Id
 
 from mgraph_ai_service_cache_client.schemas.cache.enums.Enum__Cache__Data_Type import Enum__Cache__Data_Type
 
 
 class Schema__Cache__Data__Store__Response(Type_Safe):
-    cache_id           : Random_Guid                            = None
+    cache_id           : Cache_Id                               = None
     data_files_created : List[Safe_Str__File__Path]             = None
     data_key           : Safe_Str__File__Path                   = None
     data_type          : Enum__Cache__Data_Type                 = None          # Type: 'string', 'json', or 'binary'

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/schemas/cache/file/Schema__Cache__File__Refs.py

@@ -1,17 +1,17 @@
 from osbot_utils.type_safe.Type_Safe                                                        import Type_Safe
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid                       import Random_Guid
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                          import Cache_Id
 from osbot_utils.type_safe.primitives.domains.identifiers.safe_int.Timestamp_Now            import Timestamp_Now
 from osbot_utils.type_safe.primitives.domains.identifiers.safe_str.Safe_Str__Id             import Safe_Str__Id
 from osbot_utils.type_safe.primitives.domains.cryptography.safe_str.Safe_Str__Cache_Hash    import Safe_Str__Cache_Hash
-from mgraph_ai_service_cache_client.schemas.cache.enums.Enum__Cache__File_Type                     import Enum__Cache__File_Type
-from mgraph_ai_service_cache_client.schemas.cache.enums.Enum__Cache__Store__Strategy               import Enum__Cache__Store__Strategy
-from mgraph_ai_service_cache_client.schemas.cache.file.Schema__Cache__File__Paths                  import Schema__Cache__File__Paths
-from mgraph_ai_service_cache_client.schemas.cache.store.Schema__Cache__Store__Paths                import Schema__Cache__Store__Paths
+from mgraph_ai_service_cache_client.schemas.cache.enums.Enum__Cache__File_Type              import Enum__Cache__File_Type
+from mgraph_ai_service_cache_client.schemas.cache.enums.Enum__Cache__Store__Strategy        import Enum__Cache__Store__Strategy
+from mgraph_ai_service_cache_client.schemas.cache.file.Schema__Cache__File__Paths           import Schema__Cache__File__Paths
+from mgraph_ai_service_cache_client.schemas.cache.store.Schema__Cache__Store__Paths         import Schema__Cache__Store__Paths
 
 # todo: review the field name 'all_paths' (in light of the new file_paths field)
 class Schema__Cache__File__Refs(Type_Safe):                # ID-to-hash reference with content paths
     all_paths        : Schema__Cache__Store__Paths         # All file paths created
-    cache_id         : Random_Guid                         # Cache ID
+    cache_id         : Cache_Id                            # Cache ID
     cache_hash       : Safe_Str__Cache_Hash                # Hash value
     file_type        : Enum__Cache__File_Type              # Type of stored data
     namespace        : Safe_Str__Id                        # Namespace

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/schemas/cache/store/Schema__Cache__Hash__Entry.py

@@ -1,8 +1,8 @@
 from osbot_utils.type_safe.Type_Safe                                                     import Type_Safe
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid                    import Random_Guid
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                       import Cache_Id
 from osbot_utils.type_safe.primitives.domains.identifiers.safe_int.Timestamp_Now         import Timestamp_Now
 
 
 class Schema__Cache__Hash__Entry(Type_Safe):       # Individual cache ID entry in hash reference
-    cache_id   : Random_Guid                       # Cache ID
+    cache_id   : Cache_Id                       # Cache ID
     timestamp : Timestamp_Now

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/schemas/cache/store/Schema__Cache__Hash__Reference.py

@@ -2,12 +2,12 @@ from typing
 from osbot_utils.type_safe.Type_Safe                                                     import Type_Safe
 from osbot_utils.type_safe.primitives.core.Safe_UInt                                     import Safe_UInt
 from osbot_utils.type_safe.primitives.domains.cryptography.safe_str.Safe_Str__Cache_Hash import Safe_Str__Cache_Hash
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid                    import Random_Guid
-from mgraph_ai_service_cache_client.schemas.cache.store.Schema__Cache__Hash__Entry              import Schema__Cache__Hash__Entry
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                       import Cache_Id
+from mgraph_ai_service_cache_client.schemas.cache.store.Schema__Cache__Hash__Entry       import Schema__Cache__Hash__Entry
 
 
 class Schema__Cache__Hash__Reference(Type_Safe):           # Hash-to-ID reference structure
     cache_hash     : Safe_Str__Cache_Hash                  # The hash value
     cache_ids      : List[Schema__Cache__Hash__Entry]      # All cache IDs with this hash
-    latest_id      : Random_Guid                           # Most recent cache ID
+    latest_id      : Cache_Id                           # Most recent cache ID
     total_versions : Safe_UInt

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/schemas/cache/store/Schema__Cache__Store__Metadata.py

@@ -1,6 +1,6 @@
 from osbot_utils.type_safe.Type_Safe                                                          import Type_Safe
 from osbot_utils.type_safe.primitives.domains.common.safe_str.Safe_Str__Text                  import Safe_Str__Text
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid                         import Random_Guid
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                            import Cache_Id
 from osbot_utils.type_safe.primitives.domains.identifiers.safe_str.Safe_Str__Id               import Safe_Str__Id
 from osbot_utils.type_safe.primitives.domains.identifiers.safe_int.Timestamp_Now              import Timestamp_Now
 from osbot_utils.type_safe.primitives.domains.cryptography.safe_str.Safe_Str__Cache_Hash      import Safe_Str__Cache_Hash
@@ -12,7 +12,7 @@ from mgraph_ai_service_cache_client.schemas.cache.enums.Enum__Cache__Store__Stra
 class Schema__Cache__Store__Metadata(Type_Safe):                                             # Metadata for stored cache entries
     cache_hash       : Safe_Str__Cache_Hash             = None                               # Hash of the data
     cache_key        : Safe_Str__Text                   = None                               # Optional semantic key
-    cache_id         : Random_Guid                      = None                               # Cache entry ID
+    cache_id         : Cache_Id                      = None                               # Cache entry ID
     content_encoding : Safe_Str__Id                     = None                               # Optional encoding
     file_id          : Safe_Str__Id                     = None                               # File ID used for storage
     file_type        : Enum__Cache__File_Type           = None                               # Type: 'json' or 'binary'

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/schemas/cache/zip/Schema__Cache__Zip__Batch__Request.py

@@ -1,15 +1,15 @@
-from typing                                                                       import List
-from osbot_utils.type_safe.Type_Safe                                              import Type_Safe
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid             import Random_Guid
-from osbot_utils.type_safe.primitives.domains.identifiers.safe_str.Safe_Str__Id   import Safe_Str__Id
-from mgraph_ai_service_cache_client.schemas.cache.consts__Cache_Service                  import DEFAULT_CACHE__NAMESPACE
-from mgraph_ai_service_cache_client.schemas.cache.enums.Enum__Cache__Store__Strategy     import Enum__Cache__Store__Strategy
-from mgraph_ai_service_cache_client.schemas.cache.zip.Schema__Zip__Batch__Operation      import Schema__Zip__Batch__Operation
+from typing                                                                          import List
+from osbot_utils.type_safe.Type_Safe                                                 import Type_Safe
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                   import Cache_Id
+from osbot_utils.type_safe.primitives.domains.identifiers.safe_str.Safe_Str__Id      import Safe_Str__Id
+from mgraph_ai_service_cache_client.schemas.cache.consts__Cache_Service              import DEFAULT_CACHE__NAMESPACE
+from mgraph_ai_service_cache_client.schemas.cache.enums.Enum__Cache__Store__Strategy import Enum__Cache__Store__Strategy
+from mgraph_ai_service_cache_client.schemas.cache.zip.Schema__Zip__Batch__Operation  import Schema__Zip__Batch__Operation
 
 
 class Schema__Cache__Zip__Batch__Request(Type_Safe):                                        # Request for batch zip operations
     atomic       : bool                                = True                               # All-or-nothing execution
-    cache_id     : Random_Guid                         = None                               # ID of the zip file to operate on
+    cache_id     : Cache_Id                            = None                               # ID of the zip file to operate on
     namespace    : Safe_Str__Id                        = DEFAULT_CACHE__NAMESPACE           # Namespace for isolation
     strategy     : Enum__Cache__Store__Strategy        = None                               # How to save result
     operations   : List[Schema__Zip__Batch__Operation]                                      # List of operations to perform

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/schemas/cache/zip/Schema__Cache__Zip__Batch__Response.py

@@ -1,17 +1,17 @@
-from typing                                                                                      import List
-from osbot_utils.type_safe.Type_Safe                                                             import Type_Safe
-from osbot_utils.type_safe.primitives.core.Safe_UInt                                             import Safe_UInt
-from osbot_utils.type_safe.primitives.domains.files.safe_str.Safe_Str__File__Path                import Safe_Str__File__Path
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid                            import Random_Guid
-from osbot_utils.type_safe.primitives.domains.identifiers.safe_int.Timestamp_Now                 import Timestamp_Now
+from typing                                                                                             import List
+from osbot_utils.type_safe.Type_Safe                                                                    import Type_Safe
+from osbot_utils.type_safe.primitives.core.Safe_UInt                                                    import Safe_UInt
+from osbot_utils.type_safe.primitives.domains.files.safe_str.Safe_Str__File__Path                       import Safe_Str__File__Path
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                                      import Cache_Id
+from osbot_utils.type_safe.primitives.domains.identifiers.safe_int.Timestamp_Now                        import Timestamp_Now
 from mgraph_ai_service_cache_client.schemas.cache.zip.Schema__Zip__Operation__Result                    import Schema__Zip__Operation__Result
 from mgraph_ai_service_cache_client.schemas.cache.zip.safe_str.Safe_Str__Cache__Zip__Operation__Message import Safe_Str__Cache__Zip__Operation__Message
 
 
 class Schema__Cache__Zip__Batch__Response(Type_Safe):                                   # Response from batch operations
     success              : bool                                                         # Overall success status
-    cache_id             : Random_Guid              = None                              # Original zip ID
-    original_cache_id    : Random_Guid              = None                              # Original ID for provenance
+    cache_id             : Cache_Id              = None                              # Original zip ID
+    original_cache_id    : Cache_Id              = None                              # Original ID for provenance
     operations_applied   : Safe_UInt                                                    # Number of successful operations
     operations_failed    : Safe_UInt                                                    # Number of failed operations
     operation_results    : List[Schema__Zip__Operation__Result]                         # Individual results

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/schemas/cache/zip/Schema__Cache__Zip__Operation__Request.py

@@ -1,13 +1,13 @@
-from osbot_utils.type_safe.Type_Safe                                              import Type_Safe
-from osbot_utils.type_safe.primitives.domains.files.safe_str.Safe_Str__File__Path import Safe_Str__File__Path
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid             import Random_Guid
-from osbot_utils.type_safe.primitives.domains.identifiers.safe_str.Safe_Str__Id   import Safe_Str__Id
+from osbot_utils.type_safe.Type_Safe                                                     import Type_Safe
+from osbot_utils.type_safe.primitives.domains.files.safe_str.Safe_Str__File__Path        import Safe_Str__File__Path
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                       import Cache_Id
+from osbot_utils.type_safe.primitives.domains.identifiers.safe_str.Safe_Str__Id          import Safe_Str__Id
 from mgraph_ai_service_cache_client.schemas.cache.consts__Cache_Service                  import DEFAULT_CACHE__NAMESPACE
 from mgraph_ai_service_cache_client.schemas.cache.zip.enums.Enum__Cache__Zip__Operation  import Enum__Cache__Zip__Operation
 
 
 class Schema__Cache__Zip__Operation__Request(Type_Safe):                # Request for single zip operation
-    cache_id    : Random_Guid                                           # ID of the zip file to operate on
+    cache_id    : Cache_Id                                           # ID of the zip file to operate on
     operation   : Enum__Cache__Zip__Operation                           # Operation type
     file_path   : Safe_Str__File__Path      = None                      # Path within zip (for get/add/remove/replace)
     file_content: bytes                     = None                      # Content for add/replace operations

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/schemas/cache/zip/Schema__Cache__Zip__Operation__Response.py

@@ -1,8 +1,8 @@
-from typing                                                                                      import List, Dict, Any, Optional
-from osbot_utils.type_safe.Type_Safe                                                             import Type_Safe
-from osbot_utils.type_safe.primitives.core.Safe_UInt                                             import Safe_UInt
-from osbot_utils.type_safe.primitives.domains.files.safe_str.Safe_Str__File__Path                import Safe_Str__File__Path
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid                            import Random_Guid
+from typing                                                                                             import List, Dict, Any, Optional
+from osbot_utils.type_safe.Type_Safe                                                                    import Type_Safe
+from osbot_utils.type_safe.primitives.core.Safe_UInt                                                    import Safe_UInt
+from osbot_utils.type_safe.primitives.domains.files.safe_str.Safe_Str__File__Path                       import Safe_Str__File__Path
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                                      import Cache_Id
 from mgraph_ai_service_cache_client.schemas.cache.zip.enums.Enum__Cache__Zip__Operation                 import Enum__Cache__Zip__Operation
 from mgraph_ai_service_cache_client.schemas.cache.zip.safe_str.Safe_Str__Cache__Zip__Operation__Message import Safe_Str__Cache__Zip__Operation__Message
 
@@ -10,8 +10,8 @@ from mgraph_ai_service_cache_client.schemas.cache.zip.safe_str.Safe_Str__Cache__
 class Schema__Cache__Zip__Operation__Response(Type_Safe):                                  # Response from zip operation
     success           : bool                                                                # Whether operation succeeded
     operation         : Enum__Cache__Zip__Operation                                         # Operation that was performed
-    cache_id          : Random_Guid                                 = None                  # ID of the zip file operated on
-    original_cache_id : Optional[Random_Guid]                       = None
+    cache_id          : Cache_Id                                 = None                  # ID of the zip file operated on
+    original_cache_id : Optional[Cache_Id]                       = None
     message           : Safe_Str__Cache__Zip__Operation__Message    = None                  # Optional status message
     file_list         : List[Safe_Str__File__Path]                                         # For list operation
     file_content      : bytes                                                              # For get operation

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/schemas/cache/zip/Schema__Cache__Zip__Store__Response.py

@@ -1,15 +1,15 @@
-from typing                                                                                      import List, Dict, Optional
-from osbot_utils.type_safe.Type_Safe                                                             import Type_Safe
-from osbot_utils.type_safe.primitives.core.Safe_UInt                                             import Safe_UInt
-from osbot_utils.type_safe.primitives.domains.files.safe_str.Safe_Str__File__Path                import Safe_Str__File__Path
-from osbot_utils.type_safe.primitives.domains.identifiers.Random_Guid                            import Random_Guid
-from osbot_utils.type_safe.primitives.domains.identifiers.safe_str.Safe_Str__Id                  import Safe_Str__Id
-from osbot_utils.type_safe.primitives.domains.cryptography.safe_str.Safe_Str__Cache_Hash         import Safe_Str__Cache_Hash
-from osbot_utils.type_safe.primitives.domains.identifiers.safe_int.Timestamp_Now                 import Timestamp_Now
+from typing                                                                                             import List, Dict, Optional
+from osbot_utils.type_safe.Type_Safe                                                                    import Type_Safe
+from osbot_utils.type_safe.primitives.core.Safe_UInt                                                    import Safe_UInt
+from osbot_utils.type_safe.primitives.domains.files.safe_str.Safe_Str__File__Path                       import Safe_Str__File__Path
+from osbot_utils.type_safe.primitives.domains.identifiers.Cache_Id                                      import Cache_Id
+from osbot_utils.type_safe.primitives.domains.identifiers.safe_str.Safe_Str__Id                         import Safe_Str__Id
+from osbot_utils.type_safe.primitives.domains.cryptography.safe_str.Safe_Str__Cache_Hash                import Safe_Str__Cache_Hash
+from osbot_utils.type_safe.primitives.domains.identifiers.safe_int.Timestamp_Now                        import Timestamp_Now
 from mgraph_ai_service_cache_client.schemas.cache.zip.safe_str.Safe_Str__Cache__Zip__Operation__Message import Safe_Str__Cache__Zip__Operation__Message
 
 class Schema__Cache__Zip__Store__Response(Type_Safe):                                   # Response after storing zip file
-    cache_id         : Optional[Random_Guid]                               = None       # Generated ID for this zip entry
+    cache_id         : Optional[Cache_Id]                               = None       # Generated ID for this zip entry
     cache_hash       : Optional[Safe_Str__Cache_Hash]                      = None       # Hash of the zip content
     namespace        : Safe_Str__Id                                                     # Namespace where stored
     paths            : Dict[Safe_Str__Id, List[Safe_Str__File__Path]]                   # Storage paths by type

{mgraph_ai_service_cache_client-0.18.0 → mgraph_ai_service_cache_client-0.23.0}/mgraph_ai_service_cache_client/schemas/cache/zip/Schema__Zip__Batch__Operation.py

@@ -6,8 +6,8 @@ from mgraph_ai_service_cache_client.schemas.cache.zip.safe_str.Safe_Str__Cache__
 
 
 class Schema__Zip__Batch__Operation(Type_Safe):                                         # Individual operation in batch
-    action       : Enum__Cache__Zip__Operation                                          # Operation type
-    path         : Safe_Str__File__Path                                                 # File path in zip
+    action       : Enum__Cache__Zip__Operation              = None                      # Operation type
+    path         : Safe_Str__File__Path                     = None                      # File path in zip
     content      : bytes                                    = None                                   # Content for add/replace
     new_path     : Safe_Str__File__Path                     = None                                   # New path for rename/move
     condition    : Enum__Cache__Zip__Condition              = Enum__Cache__Zip__Condition.ALWAYS     # Conditional execution