WaveGuardClient 2.3.0__tar.gz → 3.2.0__tar.gz

{waveguardclient-2.3.0 → waveguardclient-3.2.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: WaveGuardClient
-Version: 2.3.0
-Summary: Python SDK for WaveGuard — physics-based anomaly detection API
+Version: 3.2.0
+Summary: Python SDK for WaveGuard — physics-based anomaly detection, fingerprinting & crypto risk API
 Author: Greg Partin
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/gpartin/WaveGuardClient
@@ -9,7 +9,7 @@ Project-URL: Documentation, https://github.com/gpartin/WaveGuardClient/tree/main
 Project-URL: Repository, https://github.com/gpartin/WaveGuardClient
 Project-URL: Issues, https://github.com/gpartin/WaveGuardClient/issues
 Project-URL: API, https://gpartin--waveguard-api-fastapi-app.modal.run/docs
-Keywords: anomaly-detection,api-client,sdk,waveguard,physics-based,mcp,model-context-protocol,azure-migration
+Keywords: anomaly-detection,api-client,sdk,waveguard,physics-based,mcp,model-context-protocol,fingerprinting,crypto,token-risk,x402
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: System Administrators
@@ -36,7 +36,7 @@ Dynamic: license-file
 
 <p align="center">
   <img src="https://img.shields.io/pypi/v/WaveGuardClient?style=for-the-badge&color=blueviolet" alt="PyPI">
-  <img src="https://img.shields.io/badge/API-v2.2.0_stateless-brightgreen?style=for-the-badge" alt="v2.2.0">
+  <img src="https://img.shields.io/badge/API-v3.1.0_stateless-brightgreen?style=for-the-badge" alt="v3.1.0">
   <img src="https://img.shields.io/badge/GPU-CUDA_accelerated-76B900?style=for-the-badge&logo=nvidia" alt="CUDA">
   <img src="https://img.shields.io/badge/MCP-Claude_Desktop-orange?style=for-the-badge" alt="MCP">
   <a href="https://smithery.ai/servers/emergentphysicslab/waveguard"><img src="https://smithery.ai/badge/emergentphysicslab/waveguard" alt="Smithery"></a>

{waveguardclient-2.3.0 → waveguardclient-3.2.0}/README.md

@@ -1,6 +1,6 @@
 <p align="center">
   <img src="https://img.shields.io/pypi/v/WaveGuardClient?style=for-the-badge&color=blueviolet" alt="PyPI">
-  <img src="https://img.shields.io/badge/API-v2.2.0_stateless-brightgreen?style=for-the-badge" alt="v2.2.0">
+  <img src="https://img.shields.io/badge/API-v3.1.0_stateless-brightgreen?style=for-the-badge" alt="v3.1.0">
   <img src="https://img.shields.io/badge/GPU-CUDA_accelerated-76B900?style=for-the-badge&logo=nvidia" alt="CUDA">
   <img src="https://img.shields.io/badge/MCP-Claude_Desktop-orange?style=for-the-badge" alt="MCP">
   <a href="https://smithery.ai/servers/emergentphysicslab/waveguard"><img src="https://smithery.ai/badge/emergentphysicslab/waveguard" alt="Smithery"></a>

{waveguardclient-2.3.0 → waveguardclient-3.2.0}/WaveGuardClient.egg-info/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: WaveGuardClient
-Version: 2.3.0
-Summary: Python SDK for WaveGuard — physics-based anomaly detection API
+Version: 3.2.0
+Summary: Python SDK for WaveGuard — physics-based anomaly detection, fingerprinting & crypto risk API
 Author: Greg Partin
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/gpartin/WaveGuardClient
@@ -9,7 +9,7 @@ Project-URL: Documentation, https://github.com/gpartin/WaveGuardClient/tree/main
 Project-URL: Repository, https://github.com/gpartin/WaveGuardClient
 Project-URL: Issues, https://github.com/gpartin/WaveGuardClient/issues
 Project-URL: API, https://gpartin--waveguard-api-fastapi-app.modal.run/docs
-Keywords: anomaly-detection,api-client,sdk,waveguard,physics-based,mcp,model-context-protocol,azure-migration
+Keywords: anomaly-detection,api-client,sdk,waveguard,physics-based,mcp,model-context-protocol,fingerprinting,crypto,token-risk,x402
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: System Administrators
@@ -36,7 +36,7 @@ Dynamic: license-file
 
 <p align="center">
   <img src="https://img.shields.io/pypi/v/WaveGuardClient?style=for-the-badge&color=blueviolet" alt="PyPI">
-  <img src="https://img.shields.io/badge/API-v2.2.0_stateless-brightgreen?style=for-the-badge" alt="v2.2.0">
+  <img src="https://img.shields.io/badge/API-v3.1.0_stateless-brightgreen?style=for-the-badge" alt="v3.1.0">
   <img src="https://img.shields.io/badge/GPU-CUDA_accelerated-76B900?style=for-the-badge&logo=nvidia" alt="CUDA">
   <img src="https://img.shields.io/badge/MCP-Claude_Desktop-orange?style=for-the-badge" alt="MCP">
   <a href="https://smithery.ai/servers/emergentphysicslab/waveguard"><img src="https://smithery.ai/badge/emergentphysicslab/waveguard" alt="Smithery"></a>

{waveguardclient-2.3.0 → waveguardclient-3.2.0}/mcp_server/server.py

@@ -371,7 +371,7 @@ class MCPStdioServer:
     def __init__(self) -> None:
         self.server_info = {
             "name": "waveguard",
-            "version": "2.3.0",
+            "version": "3.1.0",
         }
 
     def handle_message(self, msg: dict) -> Optional[dict]:
@@ -403,6 +403,20 @@ class MCPStdioServer:
                 "result": {"tools": TOOLS},
             }
 
+        elif method == "resources/list":
+            return {
+                "jsonrpc": "2.0",
+                "id": msg_id,
+                "result": {"resources": []},
+            }
+
+        elif method == "prompts/list":
+            return {
+                "jsonrpc": "2.0",
+                "id": msg_id,
+                "result": {"prompts": []},
+            }
+
         elif method == "tools/call":
             tool_name = params.get("name", "")
             arguments = params.get("arguments", {})
@@ -435,7 +449,7 @@ class MCPStdioServer:
     def run_stdio(self) -> None:
         """Run the MCP server on stdin/stdout."""
         sys.stderr.write(
-            f"WaveGuard MCP server v2.3.0 started (API: {API_URL})\n"
+            f"WaveGuard MCP server v3.1.0 started (API: {API_URL})\n"
         )
         sys.stderr.flush()
 
@@ -470,7 +484,7 @@ def run_http_server(port: int = 3001) -> None:
         print("HTTP transport requires: pip install fastapi uvicorn")
         sys.exit(1)
 
-    mcp_app = FA(title="WaveGuard MCP Server", version="2.3.0")
+    mcp_app = FA(title="WaveGuard MCP Server", version="3.1.0")
     server = MCPStdioServer()
 
     @mcp_app.post("/mcp")
@@ -481,7 +495,7 @@ def run_http_server(port: int = 3001) -> None:
     async def mcp_tools() -> dict:  # type: ignore[type-arg]
         return {"tools": TOOLS}
 
-    print(f"WaveGuard MCP HTTP server v2.3.0 on port {port}")
+    print(f"WaveGuard MCP HTTP server v3.1.0 on port {port}")
     uvicorn.run(mcp_app, host="0.0.0.0", port=port)
 
 
@@ -492,7 +506,7 @@ def run_http_server(port: int = 3001) -> None:
 def main():
     """Entry point for `waveguard-mcp` console script."""
     parser = argparse.ArgumentParser(
-        description="WaveGuard MCP Server v2.3.0"
+        description="WaveGuard MCP Server v3.0.0"
     )
     parser.add_argument(
         "--http",

{waveguardclient-2.3.0 → waveguardclient-3.2.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "WaveGuardClient"
-version = "2.3.0"
-description = "Python SDK for WaveGuard — physics-based anomaly detection API"
+version = "3.2.0"
+description = "Python SDK for WaveGuard — physics-based anomaly detection, fingerprinting & crypto risk API"
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.9"
@@ -20,7 +20,10 @@ keywords = [
     "physics-based",
     "mcp",
     "model-context-protocol",
-    "azure-migration",
+    "fingerprinting",
+    "crypto",
+    "token-risk",
+    "x402",
 ]
 classifiers = [
     "Development Status :: 4 - Beta",

{waveguardclient-2.3.0 → waveguardclient-3.2.0}/waveguard/client.py

@@ -42,7 +42,7 @@ from .exceptions import (
     ServerError,
 )
 
-__version__ = "2.3.0"
+__version__ = "3.2.0"
 
 logger = logging.getLogger("waveguard")
 
@@ -138,6 +138,71 @@ class TierInfo:
     raw: Dict[str, Any] = field(default_factory=dict)
 
 
+@dataclass
+class FingerprintResult:
+    """Result of a ``/v1/fingerprint`` call.
+
+    Attributes
+    ----------
+    fingerprint : list[float]
+        Physics embedding vector (52-dim at L0, 62-dim at L1).
+    dimensions : int
+        Number of dimensions (52 at Level 0, 62 at Level 1).
+    labels : list[str]
+        Human-readable label for each dimension.
+    encoder_type : str
+        Encoder used to map input data onto the lattice.
+    latency_ms : float
+        Server-side processing time.
+    field_level : int
+        Field level used (0=real scalar, 1=complex).
+    raw : dict
+        Full JSON response.
+    """
+
+    fingerprint: List[float]
+    dimensions: int
+    labels: List[str]
+    encoder_type: str
+    latency_ms: float
+    field_level: int = 0
+    raw: Dict[str, Any] = field(default_factory=dict)
+
+
+@dataclass
+class CompareResult:
+    """Result of a ``/v1/compare`` call.
+
+    Attributes
+    ----------
+    similarity : float
+        Cosine similarity (0–1).  >0.95 = very similar.
+    distance : float
+        Euclidean distance between fingerprints.
+    fingerprint_a : list[float]
+        Physics embedding of data_a.
+    fingerprint_b: List[float]
+        Physics embedding of data_b.
+    dimensions : int
+        Number of dimensions.
+    encoder_type : str
+        Encoder used.
+    latency_ms : float
+        Server-side processing time.
+    raw : dict
+        Full JSON response.
+    """
+
+    similarity: float
+    distance: float
+    fingerprint_a: List[float]
+    fingerprint_b: List[float]
+    dimensions: int
+    encoder_type: str
+    latency_ms: float
+    raw: Dict[str, Any] = field(default_factory=dict)
+
+
 # ─────────────────────────────── Client ───────────────────────────────────
 
 
@@ -204,6 +269,7 @@ class WaveGuard:
         test: List[Any],
         encoder_type: Optional[str] = None,
         sensitivity: Optional[float] = None,
+        field_level: int = 0,
     ) -> ScanResult:
         """Scan test data for anomalies against a training baseline.
 
@@ -220,11 +286,15 @@ class WaveGuard:
             1+ samples to check for anomalies.
         encoder_type : str, optional
             Force a specific encoder: ``"json"``, ``"numeric"``,
-            ``"text"``, ``"timeseries"``, ``"tabular"``.
+            ``"text"``, ``"timeseries"``, ``"tabular"``,
+            ``"complex_numeric"``.
             Leave *None* for auto-detection (recommended).
         sensitivity : float, optional
             Detection sensitivity in the range 0.5–3.0.
             Lower values are more sensitive (flag more anomalies).
+        field_level : int
+            Physics field complexity. 0 = real scalar (default).
+            1 = complex field (phase-aware, 62-dim fingerprints).
 
         Returns
         -------
@@ -240,10 +310,92 @@ class WaveGuard:
             body["encoder_type"] = encoder_type
         if sensitivity is not None:
             body["sensitivity"] = sensitivity
+        if field_level:
+            body["field_level"] = field_level
 
         resp = self._post("/v1/scan", body)
         return self._parse_scan(resp, len(training), len(test))
 
+    def fingerprint(
+        self,
+        data: Any,
+        encoder_type: Optional[str] = None,
+        field_level: int = 0,
+    ) -> FingerprintResult:
+        """Get a physics embedding of any data item.
+
+        Parameters
+        ----------
+        data : any
+            A single data item to fingerprint (JSON object, list, string, etc.).
+        encoder_type : str, optional
+            Force a specific encoder.  Leave *None* for auto-detection.
+        field_level : int
+            0 = real scalar (52-dim, default).
+            1 = complex field (62-dim, includes phase statistics).
+
+        Returns
+        -------
+        FingerprintResult
+            ``.fingerprint`` is the embedding vector (52 or 62 dims).
+            ``.labels`` names each dimension.
+        """
+        body: Dict[str, Any] = {"data": data}
+        if encoder_type is not None:
+            body["encoder_type"] = encoder_type
+        if field_level:
+            body["field_level"] = field_level
+
+        resp = self._post("/v1/fingerprint", body)
+        return FingerprintResult(
+            fingerprint=resp.get("fingerprint", []),
+            dimensions=resp.get("dimensions", 0),
+            labels=resp.get("labels", []),
+            encoder_type=resp.get("encoder_type", "auto"),
+            latency_ms=resp.get("latency_ms", 0.0),
+            field_level=resp.get("field_level", 0),
+            raw=resp,
+        )
+
+    def compare(
+        self,
+        data_a: Any,
+        data_b: Any,
+        encoder_type: Optional[str] = None,
+    ) -> CompareResult:
+        """Compare two data items for structural similarity.
+
+        Parameters
+        ----------
+        data_a : any
+            First data item.
+        data_b : any
+            Second data item (same type as data_a).
+        encoder_type : str, optional
+            Force a specific encoder.  Leave *None* for auto-detection.
+
+        Returns
+        -------
+        CompareResult
+            ``.similarity`` is cosine similarity (0–1).
+            ``.distance`` is Euclidean distance.
+        """
+        body: Dict[str, Any] = {"data_a": data_a, "data_b": data_b}
+        if encoder_type is not None:
+            body["encoder_type"] = encoder_type
+
+        resp = self._post("/v1/compare", body)
+        return CompareResult(
+            similarity=resp.get("similarity", 0.0),
+            distance=resp.get("distance", 0.0),
+            fingerprint_a=resp.get("fingerprint_a", []),
+            fingerprint_b=resp.get("fingerprint_b", []),
+            dimensions=resp.get("dimensions", 0),
+            encoder_type=resp.get("encoder_type", "auto"),
+            latency_ms=resp.get("latency_ms", 0.0),
+            raw=resp,
+        )
+
     # ── Utility ───────────────────────────────────────────────────────
 
     def health(self) -> HealthStatus: