pangea-sdk 5.2.0b1__tar.gz → 5.2.0b2__tar.gz

{pangea_sdk-5.2.0b1 → pangea_sdk-5.2.0b2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pangea-sdk
-Version: 5.2.0b1
+Version: 5.2.0b2
 Summary: Pangea API SDK
 Home-page: https://pangea.cloud/docs/sdk/python/
 License: MIT
@@ -18,7 +18,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development
 Classifier: Topic :: Software Development :: Libraries
 Requires-Dist: aiohttp (>=3.10.10,<4.0.0)
-Requires-Dist: cryptography (>=43.0.1,<44.0.0)
+Requires-Dist: cryptography (>=43.0.3,<44.0.0)
 Requires-Dist: deprecated (>=1.2.14,<2.0.0)
 Requires-Dist: google-crc32c (>=1.5.0,<2.0.0)
 Requires-Dist: pydantic (>=2.9.2,<3.0.0)
@@ -64,9 +64,10 @@ $ poetry add pangea-sdk
 #### Beta releases
 
 Pre-release versions may be available with the `b` (beta) denotation in the
-version number. These releases serve to preview beta services and APIs. Per
-Semantic Versioning, they are considered unstable and do not carry the same
-compatibility guarantees as stable releases. [Beta changelog](https://github.com/pangeacyber/pangea-python/blob/beta/CHANGELOG.md).
+version number. These releases serve to preview Beta and Early Access services
+and APIs. Per Semantic Versioning, they are considered unstable and do not carry
+the same compatibility guarantees as stable releases.
+[Beta changelog](https://github.com/pangeacyber/pangea-python/blob/beta/CHANGELOG.md).
 
 Via pip:
 

{pangea_sdk-5.2.0b1 → pangea_sdk-5.2.0b2}/README.md

@@ -33,9 +33,10 @@ $ poetry add pangea-sdk
 #### Beta releases
 
 Pre-release versions may be available with the `b` (beta) denotation in the
-version number. These releases serve to preview beta services and APIs. Per
-Semantic Versioning, they are considered unstable and do not carry the same
-compatibility guarantees as stable releases. [Beta changelog](https://github.com/pangeacyber/pangea-python/blob/beta/CHANGELOG.md).
+version number. These releases serve to preview Beta and Early Access services
+and APIs. Per Semantic Versioning, they are considered unstable and do not carry
+the same compatibility guarantees as stable releases.
+[Beta changelog](https://github.com/pangeacyber/pangea-python/blob/beta/CHANGELOG.md).
 
 Via pip:
 

{pangea_sdk-5.2.0b1 → pangea_sdk-5.2.0b2}/pangea/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "5.2.0beta1"
+__version__ = "5.2.0beta2"
 
 from pangea.asyncio.request import PangeaRequestAsync
 from pangea.config import PangeaConfig

{pangea_sdk-5.2.0b1 → pangea_sdk-5.2.0b2}/pangea/asyncio/services/__init__.py

@@ -1,9 +1,11 @@
+from .ai_guard import AIGuardAsync
 from .audit import AuditAsync
 from .authn import AuthNAsync
 from .authz import AuthZAsync
 from .embargo import EmbargoAsync
 from .file_scan import FileScanAsync
 from .intel import DomainIntelAsync, FileIntelAsync, IpIntelAsync, UrlIntelAsync, UserIntelAsync
+from .prompt_guard import PromptGuardAsync
 from .redact import RedactAsync
 from .sanitize import SanitizeAsync
 from .share import ShareAsync

pangea_sdk-5.2.0b2/pangea/asyncio/services/ai_guard.py

@@ -0,0 +1,75 @@
+from __future__ import annotations
+
+from pangea.asyncio.services.base import ServiceBaseAsync
+from pangea.config import PangeaConfig
+from pangea.response import PangeaResponse
+from pangea.services.ai_guard import TextGuardResult
+
+
+class AIGuardAsync(ServiceBaseAsync):
+    """AI Guard service client.
+
+    Provides methods to interact with Pangea's AI Guard service.
+
+    Examples:
+        from pangea import PangeaConfig
+        from pangea.asyncio.services import AIGuardAsync
+
+        config = PangeaConfig(domain="aws.us.pangea.cloud")
+        ai_guard = AIGuardAsync(token="pangea_token", config=config)
+    """
+
+    service_name = "ai-guard"
+
+    def __init__(
+        self, token: str, config: PangeaConfig | None = None, logger_name: str = "pangea", config_id: str | None = None
+    ) -> None:
+        """
+        AI Guard service client.
+
+        Initializes a new AI Guard client.
+
+        Args:
+            token: Pangea API token.
+            config: Pangea service configuration.
+            logger_name: Logger name.
+            config_id: Configuration ID.
+
+        Examples:
+            from pangea import PangeaConfig
+            from pangea.asyncio.services import AIGuardAsync
+
+            config = PangeaConfig(domain="aws.us.pangea.cloud")
+            ai_guard = AIGuardAsync(token="pangea_token", config=config)
+        """
+
+        super().__init__(token, config, logger_name, config_id)
+
+    async def guard_text(
+        self,
+        text: str,
+        *,
+        recipe: str = "pangea_prompt_guard",
+        debug: bool = False,
+    ) -> PangeaResponse[TextGuardResult]:
+        """
+        Text guard (Beta)
+
+        Guard text.
+
+        How to install a [Beta release](https://pangea.cloud/docs/sdk/python/#beta-releases).
+
+        OperationId: ai_guard_post_v1beta_text_guard
+
+        Args:
+            text: Text.
+            recipe: Recipe.
+            debug: Debug.
+
+        Examples:
+            response = await ai_guard.guard_text("text")
+        """
+
+        return await self.request.post(
+            "v1beta/text/guard", TextGuardResult, data={"text": text, "recipe": recipe, "debug": debug}
+        )

{pangea_sdk-5.2.0b1 → pangea_sdk-5.2.0b2}/pangea/asyncio/services/base.py

@@ -1,8 +1,11 @@
 # Copyright 2022 Pangea Cyber Corporation
 # Author: Pangea Cyber Corporation
+from __future__ import annotations
 
 from typing import Dict, Optional, Type, Union
 
+from typing_extensions import override
+
 from pangea.asyncio.request import PangeaRequestAsync
 from pangea.exceptions import AcceptedRequestException
 from pangea.response import AttachedFile, PangeaResponse, PangeaResponseResult
@@ -23,6 +26,7 @@ class ServiceBaseAsync(ServiceBase):
 
         return self._request
 
+    @override
     async def poll_result(  # type: ignore[override]
         self,
         exception: Optional[AcceptedRequestException] = None,
@@ -36,7 +40,8 @@ class ServiceBaseAsync(ServiceBase):
         Returns request's result that has been accepted by the server
 
         Args:
-            exception (AcceptedRequestException): Exception raise by SDK on the call that is been processed.
+            exception: Exception that was previously raised by the SDK on a call
+              that is being processed.
 
         Returns:
             PangeaResponse

pangea_sdk-5.2.0b2/pangea/asyncio/services/prompt_guard.py

@@ -0,0 +1,73 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from pangea.asyncio.services.base import ServiceBaseAsync
+from pangea.config import PangeaConfig
+from pangea.services.prompt_guard import GuardResult, Message
+
+if TYPE_CHECKING:
+    from collections.abc import Iterable
+
+    from pangea.response import PangeaResponse
+
+
+class PromptGuardAsync(ServiceBaseAsync):
+    """Prompt Guard service client.
+
+    Provides methods to interact with Pangea's Prompt Guard service.
+
+    Examples:
+        from pangea import PangeaConfig
+        from pangea.asyncio.services import PromptGuardAsync
+
+        config = PangeaConfig(domain="aws.us.pangea.cloud")
+        prompt_guard = PromptGuardAsync(token="pangea_token", config=config)
+    """
+
+    service_name = "prompt-guard"
+
+    def __init__(
+        self, token: str, config: PangeaConfig | None = None, logger_name: str = "pangea", config_id: str | None = None
+    ) -> None:
+        """
+        Prompt Guard service client.
+
+        Initializes a new Prompt Guard client.
+
+        Args:
+            token: Pangea API token.
+            config: Pangea service configuration.
+            logger_name: Logger name.
+            config_id: Configuration ID.
+
+        Examples:
+            from pangea import PangeaConfig
+            from pangea.asyncio.services import PromptGuardAsync
+
+            config = PangeaConfig(domain="aws.us.pangea.cloud")
+            prompt_guard = PromptGuardAsync(token="pangea_token", config=config)
+        """
+
+        super().__init__(token, config, logger_name, config_id)
+
+    async def guard(self, messages: Iterable[Message]) -> PangeaResponse[GuardResult]:
+        """
+        Guard (Beta)
+
+        Guard messages.
+
+        How to install a [Beta release](https://pangea.cloud/docs/sdk/python/#beta-releases).
+
+        OperationId: prompt_guard_post_v1beta_guard
+
+        Args:
+            messages: Messages.
+
+        Examples:
+            from pangea.asyncio.services.prompt_guard import Message
+
+            response = await prompt_guard.guard([Message(role="user", content="hello world")])
+        """
+
+        return await self.request.post("v1beta/guard", GuardResult, data={"messages": messages})

{pangea_sdk-5.2.0b1 → pangea_sdk-5.2.0b2}/pangea/services/__init__.py

@@ -1,7 +1,7 @@
+from .ai_guard import AIGuard
 from .audit.audit import Audit
 from .authn.authn import AuthN
 from .authz import AuthZ
-from .data_guard import DataGuard
 from .embargo import Embargo
 from .file_scan import FileScan
 from .intel import DomainIntel, FileIntel, IpIntel, UrlIntel, UserIntel

pangea_sdk-5.2.0b1/pangea/services/data_guard.py → pangea_sdk-5.2.0b2/pangea/services/ai_guard.py

@@ -4,6 +4,7 @@ from typing import List, Optional
 
 from typing_extensions import Literal
 
+from pangea.config import PangeaConfig
 from pangea.response import PangeaResponse, PangeaResponseResult
 from pangea.services.base import ServiceBase
 from pangea.services.intel import UserBreachedData
@@ -14,12 +15,12 @@ class TextGuardSecurityIssues(PangeaResponseResult):
     malicious_domain_count: int
     malicious_ip_count: int
     malicious_url_count: int
-    redacted_item_count: int
+    redact_rule_match_count: int
 
 
 class TextGuardFindings(PangeaResponseResult):
-    artifact_count: int
-    malicious_count: int
+    artifact_count: Optional[int] = None
+    malicious_count: Optional[int] = None
     security_issues: TextGuardSecurityIssues
 
 
@@ -87,13 +88,44 @@ class TextGuardResult(PangeaResponseResult):
     report: Optional[TextGuardReport] = None
 
 
-class DataGuard(ServiceBase):
-    """Data Guard service client.
+class AIGuard(ServiceBase):
+    """AI Guard service client.
 
-    Provides methods to interact with Pangea's Data Guard service.
+    Provides methods to interact with Pangea's AI Guard service.
+
+    Examples:
+        from pangea import PangeaConfig
+        from pangea.services import AIGuard
+
+        config = PangeaConfig(domain="aws.us.pangea.cloud")
+        ai_guard = AIGuard(token="pangea_token", config=config)
     """
 
-    service_name = "data-guard"
+    service_name = "ai-guard"
+
+    def __init__(
+        self, token: str, config: PangeaConfig | None = None, logger_name: str = "pangea", config_id: str | None = None
+    ) -> None:
+        """
+        AI Guard service client.
+
+        Initializes a new AI Guard client.
+
+        Args:
+            token: Pangea API token.
+            config: Pangea service configuration.
+            logger_name: Logger name.
+            config_id: Configuration ID.
+
+        Examples:
+            from pangea import PangeaConfig
+            from pangea.services import AIGuard
+
+            config = PangeaConfig(domain="aws.us.pangea.cloud")
+            ai_guard = AIGuard(token="pangea_token", config=config)
+        """
+
+        super().__init__(token, config, logger_name, config_id)
 
     def guard_text(
         self,
@@ -109,7 +141,7 @@ class DataGuard(ServiceBase):
 
         How to install a [Beta release](https://pangea.cloud/docs/sdk/python/#beta-releases).
 
-        OperationId: data_guard_post_v1_text_guard
+        OperationId: ai_guard_post_v1beta_text_guard
 
         Args:
             text: Text.
@@ -117,31 +149,9 @@ class DataGuard(ServiceBase):
             debug: Debug.
 
         Examples:
-            response = data_guard.guard_text("text")
+            response = ai_guard.guard_text("text")
         """
 
         return self.request.post(
-            "v1/text/guard", TextGuardResult, data={"text": text, "recipe": recipe, "debug": debug}
+            "v1beta/text/guard", TextGuardResult, data={"text": text, "recipe": recipe, "debug": debug}
         )
-
-    def guard_file(
-        self,
-        file_url: str,
-    ) -> PangeaResponse[PangeaResponseResult]:
-        """
-        File guard (Beta)
-
-        Guard a file URL.
-
-        How to install a [Beta release](https://pangea.cloud/docs/sdk/python/#beta-releases).
-
-        OperationId: data_guard_post_v1_file_guard
-
-        Args:
-            file_url: File URL.
-
-        Examples:
-            response = data_guard.guard_file("https://example.org/file.txt")
-        """
-
-        return self.request.post("v1/file/guard", PangeaResponseResult, data={"file_url": file_url})

{pangea_sdk-5.2.0b1 → pangea_sdk-5.2.0b2}/pangea/services/base.py

@@ -80,7 +80,8 @@ class ServiceBase(object):
         Returns request's result that has been accepted by the server
 
         Args:
-            exception (AcceptedRequestException): Exception raise by SDK on the call that is been processed.
+            exception: Exception that was previously raised by the SDK on a call
+              that is being processed.
 
         Returns:
             PangeaResponse

pangea_sdk-5.2.0b2/pangea/services/prompt_guard.py

@@ -0,0 +1,83 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Optional
+
+from pangea.config import PangeaConfig
+from pangea.response import APIRequestModel, PangeaResponse, PangeaResponseResult
+from pangea.services.base import ServiceBase
+
+if TYPE_CHECKING:
+    from collections.abc import Iterable
+
+
+class Message(APIRequestModel):
+    role: str
+    content: str
+
+
+class GuardResult(PangeaResponseResult):
+    detected: bool
+    type: Optional[str] = None
+    detector: Optional[str] = None
+    confidence: int
+
+
+class PromptGuard(ServiceBase):
+    """Prompt Guard service client.
+
+    Provides methods to interact with Pangea's Prompt Guard service.
+
+    Examples:
+        from pangea import PangeaConfig
+        from pangea.services import PromptGuard
+
+        config = PangeaConfig(domain="aws.us.pangea.cloud")
+        prompt_guard = PromptGuard(token="pangea_token", config=config)
+    """
+
+    service_name = "prompt-guard"
+
+    def __init__(
+        self, token: str, config: PangeaConfig | None = None, logger_name: str = "pangea", config_id: str | None = None
+    ) -> None:
+        """
+        Prompt Guard service client.
+
+        Initializes a new Prompt Guard client.
+
+        Args:
+            token: Pangea API token.
+            config: Pangea service configuration.
+            logger_name: Logger name.
+            config_id: Configuration ID.
+
+        Examples:
+            from pangea import PangeaConfig
+            from pangea.services import PromptGuard
+
+            config = PangeaConfig(domain="aws.us.pangea.cloud")
+            prompt_guard = PromptGuard(token="pangea_token", config=config)
+        """
+
+        super().__init__(token, config, logger_name, config_id)
+
+    def guard(self, messages: Iterable[Message]) -> PangeaResponse[GuardResult]:
+        """
+        Guard (Beta)
+
+        Guard messages.
+
+        How to install a [Beta release](https://pangea.cloud/docs/sdk/python/#beta-releases).
+
+        OperationId: prompt_guard_post_v1beta_guard
+
+        Args:
+            messages: Messages.
+
+        Examples:
+            from pangea.services.prompt_guard import Message
+
+            response = prompt_guard.guard([Message(role="user", content="hello world")])
+        """
+
+        return self.request.post("v1beta/guard", GuardResult, data={"messages": messages})

{pangea_sdk-5.2.0b1 → pangea_sdk-5.2.0b2}/pangea/utils.py

@@ -6,7 +6,6 @@ import datetime
 import io
 import json
 from hashlib import md5, new, sha1, sha256, sha512
-from typing import Union
 
 from google_crc32c import Checksum as CRC32C
 from pydantic import BaseModel
@@ -67,7 +66,7 @@ def canonicalize(data: dict) -> str:
         return str(data)
 
 
-def hash_sha256(input: Union[str, io.BufferedReader]) -> str:
+def hash_sha256(input: str | io.BufferedReader) -> str:
     # Return SHA256 hash in hex format
     hash = sha256()
     if isinstance(input, io.BufferedReader):
@@ -80,12 +79,12 @@ def hash_sha256(input: Union[str, io.BufferedReader]) -> str:
 
         input.seek(0)  # restart reading
     else:
-        hash.update(input)  # type: ignore
+        hash.update(input.encode("utf-8"))
 
     return hash.hexdigest()
 
 
-def hash_sha1(input: Union[str, io.BufferedReader]) -> str:
+def hash_sha1(input: str | io.BufferedReader) -> str:
     # Return SHA1 hash in hex format
     hash = sha1()
     if isinstance(input, io.BufferedReader):
@@ -98,12 +97,12 @@ def hash_sha1(input: Union[str, io.BufferedReader]) -> str:
 
         input.seek(0)  # restart reading
     else:
-        hash.update(input)  # type: ignore
+        hash.update(input.encode("utf-8"))
 
     return hash.hexdigest()
 
 
-def hash_sha512(input: Union[str, io.BufferedReader]) -> str:
+def hash_sha512(input: str | io.BufferedReader) -> str:
     # Return SHA512 hash in hex format
     hash = sha512()
     if isinstance(input, io.BufferedReader):
@@ -116,7 +115,7 @@ def hash_sha512(input: Union[str, io.BufferedReader]) -> str:
 
         input.seek(0)  # restart reading
     else:
-        hash.update(input)  # type: ignore
+        hash.update(input.encode("utf-8"))
 
     return hash.hexdigest()
 
@@ -126,7 +125,7 @@ def hash_ntlm(data: str) -> str:
     return new("md4", data.encode("utf-16le")).hexdigest()
 
 
-def hash_md5(input: Union[str, io.BufferedReader]) -> str:
+def hash_md5(input: str | io.BufferedReader) -> str:
     # Return MD5 hash in hex format
     hash = md5()
     if isinstance(input, io.BufferedReader):
@@ -140,7 +139,7 @@ def hash_md5(input: Union[str, io.BufferedReader]) -> str:
 
         input.seek(0)  # restart reading
     else:
-        hash.update(input)  # type: ignore
+        hash.update(input.encode("utf-8"))
 
     return hash.hexdigest()
 

{pangea_sdk-5.2.0b1 → pangea_sdk-5.2.0b2}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "pangea-sdk"
-version = "5.2.0beta1"
+version = "5.2.0beta2"
 description = "Pangea API SDK"
 authors = ["Glenn Gallien <glenn.gallien@pangea.cloud>"]
 license = "MIT"
@@ -19,7 +19,7 @@ packages = [
 [tool.poetry.dependencies]
 python = "^3.9.0"
 requests = "^2.31.0"
-cryptography = "^43.0.1"
+cryptography = "^43.0.3"
 python-dateutil = "^2.9.0"
 pydantic = "^2.9.2"
 deprecated = "^1.2.14"
@@ -29,10 +29,10 @@ requests-toolbelt = "^1.0.0"
 typing-extensions = "^4.12.2"
 
 [tool.poetry.group.dev.dependencies]
-black = "^24.8.0"
+black = "^24.10.0"
 docstring-parser = "^0.15"
 isort = "^5.13.2"
-mypy = "1.11.2"
+mypy = "1.13.0"
 types-Deprecated = "^1.2.9.3"
 types-python-dateutil = "^2.8.19.14"
 types-requests = "^2.31.0.10"

pangea_sdk-5.2.0b1/pangea/asyncio/services/data_guard.py

@@ -1,65 +0,0 @@
-from __future__ import annotations
-
-from pangea.asyncio.services.base import ServiceBaseAsync
-from pangea.response import PangeaResponse, PangeaResponseResult
-from pangea.services.data_guard import TextGuardResult
-
-
-class DataGuard(ServiceBaseAsync):
-    """Data Guard service client.
-
-    Provides methods to interact with Pangea's Data Guard service.
-    """
-
-    service_name = "data-guard"
-
-    async def guard_text(
-        self,
-        text: str,
-        *,
-        recipe: str = "pangea_prompt_guard",
-        debug: bool = False,
-    ) -> PangeaResponse[TextGuardResult]:
-        """
-        Text guard (Beta)
-
-        Guard text.
-
-        How to install a [Beta release](https://pangea.cloud/docs/sdk/python/#beta-releases).
-
-        OperationId: data_guard_post_v1_text_guard
-
-        Args:
-            text: Text.
-            recipe: Recipe.
-            debug: Debug.
-
-        Examples:
-            response = await data_guard.guard_text("text")
-        """
-
-        return await self.request.post(
-            "v1/text/guard", TextGuardResult, data={"text": text, "recipe": recipe, "debug": debug}
-        )
-
-    async def guard_file(
-        self,
-        file_url: str,
-    ) -> PangeaResponse[PangeaResponseResult]:
-        """
-        File guard (Beta)
-
-        Guard a file URL.
-
-        How to install a [Beta release](https://pangea.cloud/docs/sdk/python/#beta-releases).
-
-        OperationId: data_guard_post_v1_file_guard
-
-        Args:
-            file_url: File URL.
-
-        Examples:
-            response = await data_guard.guard_file("https://example.org/file.txt")
-        """
-
-        return await self.request.post("v1/file/guard", PangeaResponseResult, data={"file_url": file_url})

pangea_sdk-5.2.0b1/pangea/asyncio/services/prompt_guard.py

@@ -1,39 +0,0 @@
-from __future__ import annotations
-
-from typing import TYPE_CHECKING
-
-from pangea.asyncio.services.base import ServiceBaseAsync
-from pangea.services.prompt_guard import GuardResult, Message
-
-if TYPE_CHECKING:
-    from collections.abc import Iterable
-
-    from pangea.response import PangeaResponse
-
-
-class PromptGuard(ServiceBaseAsync):
-    """Prompt Guard service client.
-
-    Provides methods to interact with Pangea's Prompt Guard service.
-    """
-
-    service_name = "prompt-guard"
-
-    async def guard(self, messages: Iterable[Message]) -> PangeaResponse[GuardResult]:
-        """
-        Guard (Beta)
-
-        Guard messages.
-
-        How to install a [Beta release](https://pangea.cloud/docs/sdk/python/#beta-releases).
-
-        OperationId: prompt_guard_post_v1_guard
-
-        Args:
-            messages: Messages..
-
-        Examples:
-            response = await prompt_guard.guard([Message(role="user", content="hello world")])
-        """
-
-        return await self.request.post("v1/guard", GuardResult, data={"messages": messages})

pangea_sdk-5.2.0b1/pangea/services/prompt_guard.py

@@ -1,48 +0,0 @@
-from __future__ import annotations
-
-from typing import TYPE_CHECKING, Optional
-
-from pangea.response import APIRequestModel, PangeaResponse, PangeaResponseResult
-from pangea.services.base import ServiceBase
-
-if TYPE_CHECKING:
-    from collections.abc import Iterable
-
-
-class Message(APIRequestModel):
-    role: str
-    content: str
-
-
-class GuardResult(PangeaResponseResult):
-    prompt_injection_detected: bool
-    prompt_injection_type: Optional[str] = None
-    prompt_injection_detector: Optional[str] = None
-
-
-class PromptGuard(ServiceBase):
-    """Prompt Guard service client.
-
-    Provides methods to interact with Pangea's Prompt Guard service.
-    """
-
-    service_name = "prompt-guard"
-
-    def guard(self, messages: Iterable[Message]) -> PangeaResponse[GuardResult]:
-        """
-        Guard (Beta)
-
-        Guard messages.
-
-        How to install a [Beta release](https://pangea.cloud/docs/sdk/python/#beta-releases).
-
-        OperationId: prompt_guard_post_v1_guard
-
-        Args:
-            messages: Messages.
-
-        Examples:
-            response = prompt_guard.guard([Message(role="user", content="hello world")])
-        """
-
-        return self.request.post("v1/guard", GuardResult, data={"messages": messages})