causal-logic-engine 2.21.0__tar.gz

causal_logic_engine-2.21.0/PKG-INFO

@@ -0,0 +1,24 @@
+Metadata-Version: 2.4
+Name: causal-logic-engine
+Version: 2.21.0
+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
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+Sovereign Cognitive API Client.

causal_logic_engine-2.21.0/causal_engine/__init__.py

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

causal_logic_engine-2.21.0/causal_engine/client.py

@@ -0,0 +1,97 @@
+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."""
+        url = f"{self.base_url}/api/document/list"
+        response = requests.get(url, headers=self.headers)
+        data = self._handle_response(response)
+        return data.get("documents", [])
+
+    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_logic_engine-2.21.0/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.21.0/causal_logic_engine.egg-info/PKG-INFO

@@ -0,0 +1,24 @@
+Metadata-Version: 2.4
+Name: causal-logic-engine
+Version: 2.21.0
+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
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+Sovereign Cognitive API Client.

causal_logic_engine-2.21.0/causal_logic_engine.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+setup.py
+causal_engine/__init__.py
+causal_engine/client.py
+causal_engine/exceptions.py
+causal_logic_engine.egg-info/PKG-INFO
+causal_logic_engine.egg-info/SOURCES.txt
+causal_logic_engine.egg-info/dependency_links.txt
+causal_logic_engine.egg-info/requires.txt
+causal_logic_engine.egg-info/top_level.txt

causal_logic_engine-2.21.0/causal_logic_engine.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

causal_logic_engine-2.21.0/causal_logic_engine.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.25.0

causal_logic_engine-2.21.0/causal_logic_engine.egg-info/top_level.txt

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

causal_logic_engine-2.21.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

causal_logic_engine-2.21.0/setup.py

@@ -0,0 +1,24 @@
+# causal-engine-sdk/setup.py
+import os
+from setuptools import setup, find_packages
+
+setup(
+    name="causal-logic-engine",  # Changed to be unique
+    version="2.21.0", # 🎯 UPGRADED TO UCOS CURRENT ARCHITECTURE
+    author="Ben Denholm",
+    author_email="bendenholm1@outlook.com",
+    description="The official Python SDK for the multi-tenant Causal Logic Engine API.",
+    long_description=open("README.md").read() if os.path.exists("README.md") else "Sovereign Cognitive API Client.",
+    long_description_content_type="text/markdown",
+    url="https://causal-logic-engine.onrender.com",
+    packages=find_packages(),
+    install_requires=[
+        "requests>=2.25.0",
+    ],
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires=">=3.8",
+)