causal-logic-engine 2.3__py3-none-any.whl

causal_engine/__init__.py

@@ -0,0 +1,4 @@
+from .client import CausalClient
+from .exceptions import CausalAPIError, AuthenticationError, RateLimitError
+
+__all__ = ["CausalClient", "CausalAPIError", "AuthenticationError", "RateLimitError"]

causal_engine/client.py

@@ -0,0 +1,102 @@
+# causal-engine-sdk/causal_engine/client.py
+import os
+import requests
+from typing import List, Dict, Any, Optional
+from .exceptions import CausalAPIError, AuthenticationError, RateLimitError
+
+class AuditResponse:
+    """Wraps the strict JSON schema response from the Causal Engine."""
+    def __init__(self, data: Dict[str, Any]):
+        self.anomaly_detected: bool = data.get("anomaly_detected", False)
+        self.issue_summary: str = data.get("issue_summary", "")
+        self.severity_level: str = data.get("severity_level", "NONE")
+        self.remedy_steps: List[str] = data.get("remedy_steps", [])
+        self.sources: List[Dict[str, Any]] = data.get("sources", [])
+        self.latency_ms: int = data.get("latency_ms", 0)
+
+    def __repr__(self):
+        return f"<CausalAudit severity={self.severity_level} anomaly={self.anomaly_detected}>"
+
+class CausalClient:
+    def __init__(self, api_key: str, base_url: str = "https://causal-logic-engine.onrender.com"):
+        """Initializes the Sovereign API Client wrapper."""
+        self.api_key = api_key.strip()
+        self.base_url = base_url.rstrip("/")
+        
+        self.headers = {
+            "Content-Type": "application/json",
+            "X-Causal-Engine-Key": self.api_key
+        }
+
+    def _handle_response(self, response: requests.Response) -> Dict[str, Any]:
+        """Evaluates status codes and handles exceptions professionally."""
+        if response.status_code in [200, 201]:
+            return response.json()
+            
+        try:
+            error_data = response.json()
+            detail = error_data.get("detail", "An unhandled API error occurred.")
+        except Exception:
+            detail = response.text or "An unhandled API error occurred."
+
+        if response.status_code == 401:
+            raise AuthenticationError("Authentication Failed: Invalid or expired API Key.", status_code=401)
+        elif response.status_code == 429:
+            raise RateLimitError("Quota Exceeded: Your tenant sliding window limit has been hit.", status_code=429)
+        else:
+            raise CausalAPIError(f"API Error: {detail}", status_code=response.status_code)
+
+    def query(self, user_query: str, persona_override: Optional[str] = None) -> AuditResponse:
+        """
+        Executes a headless cognitive query against your isolated database partition.
+        Returns a structured AuditResponse object.
+        """
+        url = f"{self.base_url}/api/document/v1/query"
+        payload = {
+            "user_query": user_query,
+            "persona_override": persona_override
+        }
+        
+        response = requests.post(url, headers=self.headers, json=payload)
+        json_data = self._handle_response(response)
+        return AuditResponse(json_data)
+
+    def upload_file(self, file_path: str) -> Dict[str, Any]:
+        """
+        Uploads and indexes a local file (.pdf, .xlsx, .docx, .txt) 
+        directly into your secure database partition.
+        """
+        url = f"{self.base_url}/api/document/upload"
+        filename = os.path.basename(file_path)
+        
+        with open(file_path, "rb") as f:
+            files = {"file": (filename, f, "application/octet-stream")}
+            multipart_headers = {"X-Causal-Engine-Key": self.api_key}
+            response = requests.post(url, headers=multipart_headers, files=files)
+            
+        return self._handle_response(response)
+
+    def list_files(self) -> List[Dict[str, Any]]:
+        """
+        Lists all active files in your secure workspace registry.
+        Resolves both flat list keys and structured directory registries.
+        """
+        url = f"{self.base_url}/api/document/list"
+        response = requests.get(url, headers=self.headers)
+        data = self._handle_response(response)
+        # 🎯 BUG FIX: Resolves both "documents" and "directory_registry" keys seamlessly
+        return data.get("documents", data.get("directory_registry", []))
+
+    def execute_mcp_tool(self, tool_name: str, parameters: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Model Context Protocol (MCP) Gateway.
+        Allows external AI agents (Cursor, Claude) to programmatically invoke UCOS tools.
+        """
+        url = f"{self.base_url}/api/mcp/execute"
+        payload = {
+            "tool_name": tool_name,
+            "parameters": parameters
+        }
+        
+        response = requests.post(url, headers=self.headers, json=payload)
+        return self._handle_response(response)

causal_engine/exceptions.py

@@ -0,0 +1,14 @@
+class CausalAPIError(Exception):
+    """Base exception for all Causal Engine API faults."""
+    def __init__(self, message: str, status_code: int = None, details: str = None):
+        super().__init__(message)
+        self.status_code = status_code
+        self.details = details
+
+class AuthenticationError(CausalAPIError):
+    """Raised when the X-Causal-Engine-Key is invalid or expired."""
+    pass
+
+class RateLimitError(CausalAPIError):
+    """Raised when the workspace exceeds its dynamic tier sliding window limit."""
+    pass

causal_logic_engine-2.3.dist-info/METADATA

@@ -0,0 +1,15 @@
+Metadata-Version: 2.1
+Name: causal-logic-engine
+Version: 2.3
+Summary: The official Python SDK for the multi-tenant Causal Logic Engine API.
+Home-page: https://causal-logic-engine.onrender.com
+Author: Ben Denholm
+Author-email: bendenholm1@outlook.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+
+Sovereign Cognitive API Client.

causal_logic_engine-2.3.dist-info/RECORD

@@ -0,0 +1,7 @@
+causal_engine/__init__.py,sha256=vm9lRg8KiET-9bm7Om3Q4y-wbT9PrVrYvSRPDICKlNk,195
+causal_engine/client.py,sha256=LyEGaVhCdD1UAhITbOI6vGh8rupgJHR8c9L05B5ClO0,4474
+causal_engine/exceptions.py,sha256=MnSlHOaK9Zv1EfpLbIuZrnaKG17zE5Fv_94N4_9Hy9E,532
+causal_logic_engine-2.3.dist-info/METADATA,sha256=GzEhsmT0hG3KI8bHLVMtjaOutTTJTjelRZ_jFv2bqQ0,524
+causal_logic_engine-2.3.dist-info/WHEEL,sha256=51RkbunBAw4BWsgaQWTpPhg4Diwp3c9P5iaLk67Hdtg,92
+causal_logic_engine-2.3.dist-info/top_level.txt,sha256=2caYqiuD31RZ5eKFvP7HgWs_sNsmg_jk6wzXImtRBeU,14
+causal_logic_engine-2.3.dist-info/RECORD,,

causal_logic_engine-2.3.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.47.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

causal_logic_engine-2.3.dist-info/top_level.txt

@@ -0,0 +1 @@
+causal_engine