systemr 1.0.0__tar.gz

systemr-1.0.0/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: systemr
+Version: 1.0.0
+Summary: Python SDK for agents.systemr.ai - AI-native risk intelligence for trading agents
+Author-email: System R AI <agents@systemr.ai>
+License: MIT
+Project-URL: Homepage, https://systemr.ai
+Project-URL: Documentation, https://agents.systemr.ai/docs
+Project-URL: Repository, https://github.com/systemr-ai/systemr-python
+Keywords: trading,risk-management,position-sizing,ai-agents,mcp
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.24.0
+
+# systemr
+
+Python SDK for [agents.systemr.ai](https://agents.systemr.ai) — AI-native risk intelligence for trading agents.
+
+## Install
+
+```bash
+pip install systemr
+```
+
+## Quick Start
+
+```python
+from systemr import SystemRClient
+
+client = SystemRClient(api_key="sr_agent_...")
+
+# Position sizing ($0.003)
+result = client.calculate_position_size(
+    equity="100000",
+    entry_price="185.50",
+    stop_price="180.00",
+    direction="long",
+)
+print(result["shares"], result["risk_amount"])
+
+# Risk validation ($0.004)
+risk = client.check_risk(
+    symbol="AAPL",
+    direction="long",
+    entry_price="185.50",
+    stop_price="180.00",
+    quantity="100",
+    equity="100000",
+)
+print(risk["approved"], risk["score"])
+
+# Strategy evaluation ($0.10 - $1.00)
+eval_result = client.basic_eval(r_multiples=["1.5", "-1.0", "2.3", "-0.5", "1.8"])
+print(eval_result["g_score"], eval_result["verdict"])
+```
+
+## API Reference
+
+### Agent Management
+- `client.get_info()` — Get agent info
+- `client.list_agents()` — List owner's agents
+- `client.update_mode(mode)` — Change mode (sandbox/live/suspended/terminated)
+
+### Position Sizing
+- `client.calculate_position_size(equity, entry_price, stop_price, direction)` — G-formula sizing ($0.003)
+
+### Risk Validation
+- `client.check_risk(symbol, direction, entry_price, stop_price, quantity, equity)` — Iron Fist validation ($0.004)
+
+### Evaluation
+- `client.basic_eval(r_multiples)` — G metric + verdict ($0.10)
+- `client.full_eval(r_multiples)` — G + rolling G + System R Score ($0.50)
+- `client.comprehensive_eval(r_multiples)` — Full analysis + impact ($1.00)
+
+### Billing
+- `client.get_pricing()` — Operation prices (no auth)
+- `client.get_balance()` — Current USDC balance
+- `client.deposit(amount)` — Record deposit
+- `client.get_transactions()` — Transaction history
+- `client.get_usage()` — Usage summary
+
+## Authentication
+
+Register at [agents.systemr.ai](https://agents.systemr.ai) to get an API key. All paid operations are billed in USDC.
+
+## License
+
+MIT

systemr-1.0.0/README.md

@@ -0,0 +1,74 @@
+# systemr
+
+Python SDK for [agents.systemr.ai](https://agents.systemr.ai) — AI-native risk intelligence for trading agents.
+
+## Install
+
+```bash
+pip install systemr
+```
+
+## Quick Start
+
+```python
+from systemr import SystemRClient
+
+client = SystemRClient(api_key="sr_agent_...")
+
+# Position sizing ($0.003)
+result = client.calculate_position_size(
+    equity="100000",
+    entry_price="185.50",
+    stop_price="180.00",
+    direction="long",
+)
+print(result["shares"], result["risk_amount"])
+
+# Risk validation ($0.004)
+risk = client.check_risk(
+    symbol="AAPL",
+    direction="long",
+    entry_price="185.50",
+    stop_price="180.00",
+    quantity="100",
+    equity="100000",
+)
+print(risk["approved"], risk["score"])
+
+# Strategy evaluation ($0.10 - $1.00)
+eval_result = client.basic_eval(r_multiples=["1.5", "-1.0", "2.3", "-0.5", "1.8"])
+print(eval_result["g_score"], eval_result["verdict"])
+```
+
+## API Reference
+
+### Agent Management
+- `client.get_info()` — Get agent info
+- `client.list_agents()` — List owner's agents
+- `client.update_mode(mode)` — Change mode (sandbox/live/suspended/terminated)
+
+### Position Sizing
+- `client.calculate_position_size(equity, entry_price, stop_price, direction)` — G-formula sizing ($0.003)
+
+### Risk Validation
+- `client.check_risk(symbol, direction, entry_price, stop_price, quantity, equity)` — Iron Fist validation ($0.004)
+
+### Evaluation
+- `client.basic_eval(r_multiples)` — G metric + verdict ($0.10)
+- `client.full_eval(r_multiples)` — G + rolling G + System R Score ($0.50)
+- `client.comprehensive_eval(r_multiples)` — Full analysis + impact ($1.00)
+
+### Billing
+- `client.get_pricing()` — Operation prices (no auth)
+- `client.get_balance()` — Current USDC balance
+- `client.deposit(amount)` — Record deposit
+- `client.get_transactions()` — Transaction history
+- `client.get_usage()` — Usage summary
+
+## Authentication
+
+Register at [agents.systemr.ai](https://agents.systemr.ai) to get an API key. All paid operations are billed in USDC.
+
+## License
+
+MIT

systemr-1.0.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "systemr"
+version = "1.0.0"
+description = "Python SDK for agents.systemr.ai - AI-native risk intelligence for trading agents"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.9"
+authors = [
+    {name = "System R AI", email = "agents@systemr.ai"},
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Office/Business :: Financial :: Investment",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+keywords = ["trading", "risk-management", "position-sizing", "ai-agents", "mcp"]
+dependencies = [
+    "httpx>=0.24.0",
+]
+
+[project.urls]
+Homepage = "https://systemr.ai"
+Documentation = "https://agents.systemr.ai/docs"
+Repository = "https://github.com/systemr-ai/systemr-python"

systemr-1.0.0/setup.cfg

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

systemr-1.0.0/systemr/__init__.py

@@ -0,0 +1,30 @@
+"""
+System R Python SDK - AI-native risk intelligence for trading agents.
+
+Usage:
+    from systemr import SystemRClient
+
+    client = SystemRClient(api_key="sr_agent_...")
+    result = client.calculate_position_size(
+        equity="100000",
+        entry_price="150.00",
+        stop_price="145.00",
+        direction="long",
+    )
+"""
+
+from systemr.client import (
+    AuthenticationError,
+    InsufficientBalanceError,
+    SystemRClient,
+    SystemRError,
+)
+
+__all__ = [
+    "SystemRClient",
+    "SystemRError",
+    "AuthenticationError",
+    "InsufficientBalanceError",
+]
+
+__version__ = "1.0.0"

systemr-1.0.0/systemr/client.py

@@ -0,0 +1,257 @@
+"""
+System R Python SDK client.
+
+A simple, ergonomic client for agents to call System R services.
+Uses httpx for HTTP requests with proper error handling.
+
+Usage:
+    client = SystemRClient(api_key="sr_agent_...")
+    result = client.calculate_position_size(...)
+"""
+
+import httpx
+from typing import Dict, List, Optional
+
+
+class SystemRError(Exception):
+    """Base exception for System R SDK errors."""
+
+    def __init__(self, message: str, status_code: int = 0, detail: str = ""):
+        super().__init__(message)
+        self.status_code = status_code
+        self.detail = detail
+
+
+class InsufficientBalanceError(SystemRError):
+    """Raised when the agent's balance is too low for an operation."""
+    pass
+
+
+class AuthenticationError(SystemRError):
+    """Raised when the API key is invalid or agent is inactive."""
+    pass
+
+
+class SystemRClient:
+    """
+    Python SDK client for agents.systemr.ai.
+
+    All methods return dicts with string values for financial amounts
+    to preserve Decimal precision.
+    """
+
+    DEFAULT_BASE_URL = "https://agents.systemr.ai"
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: Optional[str] = None,
+        timeout: float = 30.0,
+    ):
+        """
+        Initialize the System R client.
+
+        Args:
+            api_key: Agent API key (starts with 'sr_agent_').
+            base_url: API base URL. Defaults to https://agents.systemr.ai.
+            timeout: Request timeout in seconds.
+        """
+        self._base_url = (base_url or self.DEFAULT_BASE_URL).rstrip("/")
+        self._client = httpx.Client(
+            base_url=self._base_url,
+            headers={"X-API-Key": api_key},
+            timeout=timeout,
+        )
+
+    def _request(self, method: str, path: str, **kwargs) -> dict:
+        """Make an API request with error handling."""
+        resp = self._client.request(method, path, **kwargs)
+
+        if resp.status_code == 401:
+            raise AuthenticationError(
+                "Authentication failed", status_code=401,
+                detail=resp.json().get("detail", ""),
+            )
+        if resp.status_code == 402:
+            raise InsufficientBalanceError(
+                "Insufficient balance", status_code=402,
+                detail=resp.json().get("detail", ""),
+            )
+        if resp.status_code == 403:
+            raise AuthenticationError(
+                "Agent is not active", status_code=403,
+                detail=resp.json().get("detail", ""),
+            )
+        if resp.status_code >= 400:
+            detail = resp.json().get("detail", resp.text)
+            raise SystemRError(
+                f"API error: {detail}",
+                status_code=resp.status_code,
+                detail=detail,
+            )
+
+        return resp.json()
+
+    # === Agent Management ===
+
+    def get_info(self) -> dict:
+        """Get current agent information."""
+        return self._request("GET", "/v1/agents/me")
+
+    def list_agents(self) -> dict:
+        """List all agents owned by the same owner."""
+        return self._request("GET", "/v1/agents/list")
+
+    def update_mode(self, mode: str) -> dict:
+        """Change agent mode (sandbox, live, suspended, terminated)."""
+        return self._request("PUT", "/v1/agents/mode", json={"mode": mode})
+
+    # === Billing ===
+
+    def get_balance(self) -> dict:
+        """Get current USDC balance."""
+        return self._request("GET", "/v1/billing/balance")
+
+    def deposit(
+        self,
+        amount: str,
+        funding_path: str = "direct_transfer",
+        on_chain_tx_hash: Optional[str] = None,
+    ) -> dict:
+        """Record a USDC deposit."""
+        payload: Dict[str, str] = {
+            "amount": amount,
+            "funding_path": funding_path,
+        }
+        if on_chain_tx_hash:
+            payload["on_chain_tx_hash"] = on_chain_tx_hash
+        return self._request("POST", "/v1/billing/deposit", json=payload)
+
+    def get_transactions(self, limit: int = 100) -> dict:
+        """Get recent billing transactions."""
+        return self._request("GET", f"/v1/billing/transactions?limit={limit}")
+
+    def get_usage(self) -> dict:
+        """Get usage summary grouped by operation."""
+        return self._request("GET", "/v1/billing/usage")
+
+    def get_pricing(self) -> dict:
+        """Get current operation pricing (no auth required)."""
+        return self._request("GET", "/v1/billing/pricing")
+
+    # === Position Sizing ===
+
+    def calculate_position_size(
+        self,
+        equity: str,
+        entry_price: str,
+        stop_price: str,
+        direction: str,
+        risk_percent: Optional[str] = None,
+        instrument: Optional[str] = None,
+    ) -> dict:
+        """
+        Calculate optimal position size using G-formula.
+
+        Cost: $0.003 USDC.
+
+        Args:
+            equity: Account equity in USD.
+            entry_price: Planned entry price.
+            stop_price: Stop loss price.
+            direction: 'long' or 'short'.
+            risk_percent: Risk as decimal (e.g. '0.02'). Optional.
+            instrument: Instrument symbol. Optional.
+
+        Returns:
+            Dict with shares, risk_amount, risk_percent, notional, one_r_dollars.
+        """
+        payload: Dict[str, str] = {
+            "equity": equity,
+            "entry_price": entry_price,
+            "stop_price": stop_price,
+            "direction": direction,
+        }
+        if risk_percent:
+            payload["risk_percent"] = risk_percent
+        if instrument:
+            payload["instrument"] = instrument
+        return self._request("POST", "/v1/sizing/calculate", json=payload)
+
+    # === Risk Check ===
+
+    def check_risk(
+        self,
+        symbol: str,
+        direction: str,
+        entry_price: str,
+        stop_price: str,
+        quantity: str,
+        equity: str,
+        daily_pnl: str = "0",
+    ) -> dict:
+        """
+        Validate trade risk using Iron Fist rules.
+
+        Cost: $0.004 USDC.
+
+        Returns:
+            Dict with approved (bool), score (0-100), errors, warnings.
+        """
+        return self._request("POST", "/v1/risk/check", json={
+            "symbol": symbol,
+            "direction": direction,
+            "entry_price": entry_price,
+            "stop_price": stop_price,
+            "quantity": quantity,
+            "equity": equity,
+            "daily_pnl": daily_pnl,
+        })
+
+    # === Evaluation ===
+
+    def basic_eval(self, r_multiples: List[str]) -> dict:
+        """
+        Basic evaluation -- G metric and verdict.
+
+        Cost: $0.10 USDC.
+        """
+        return self._request("POST", "/v1/eval/basic", json={
+            "r_multiples": r_multiples,
+        })
+
+    def full_eval(
+        self, r_multiples: List[str], window_size: int = 10
+    ) -> dict:
+        """
+        Full evaluation -- G + rolling G + System R Score.
+
+        Cost: $0.50 USDC.
+        """
+        return self._request("POST", "/v1/eval/full", json={
+            "r_multiples": r_multiples,
+            "window_size": window_size,
+        })
+
+    def comprehensive_eval(
+        self, r_multiples: List[str], window_size: int = 10
+    ) -> dict:
+        """
+        Comprehensive evaluation -- all metrics + impact analysis.
+
+        Cost: $1.00 USDC.
+        """
+        return self._request("POST", "/v1/eval/comprehensive", json={
+            "r_multiples": r_multiples,
+            "window_size": window_size,
+        })
+
+    def close(self):
+        """Close the HTTP client."""
+        self._client.close()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.close()

systemr-1.0.0/systemr.egg-info/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: systemr
+Version: 1.0.0
+Summary: Python SDK for agents.systemr.ai - AI-native risk intelligence for trading agents
+Author-email: System R AI <agents@systemr.ai>
+License: MIT
+Project-URL: Homepage, https://systemr.ai
+Project-URL: Documentation, https://agents.systemr.ai/docs
+Project-URL: Repository, https://github.com/systemr-ai/systemr-python
+Keywords: trading,risk-management,position-sizing,ai-agents,mcp
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.24.0
+
+# systemr
+
+Python SDK for [agents.systemr.ai](https://agents.systemr.ai) — AI-native risk intelligence for trading agents.
+
+## Install
+
+```bash
+pip install systemr
+```
+
+## Quick Start
+
+```python
+from systemr import SystemRClient
+
+client = SystemRClient(api_key="sr_agent_...")
+
+# Position sizing ($0.003)
+result = client.calculate_position_size(
+    equity="100000",
+    entry_price="185.50",
+    stop_price="180.00",
+    direction="long",
+)
+print(result["shares"], result["risk_amount"])
+
+# Risk validation ($0.004)
+risk = client.check_risk(
+    symbol="AAPL",
+    direction="long",
+    entry_price="185.50",
+    stop_price="180.00",
+    quantity="100",
+    equity="100000",
+)
+print(risk["approved"], risk["score"])
+
+# Strategy evaluation ($0.10 - $1.00)
+eval_result = client.basic_eval(r_multiples=["1.5", "-1.0", "2.3", "-0.5", "1.8"])
+print(eval_result["g_score"], eval_result["verdict"])
+```
+
+## API Reference
+
+### Agent Management
+- `client.get_info()` — Get agent info
+- `client.list_agents()` — List owner's agents
+- `client.update_mode(mode)` — Change mode (sandbox/live/suspended/terminated)
+
+### Position Sizing
+- `client.calculate_position_size(equity, entry_price, stop_price, direction)` — G-formula sizing ($0.003)
+
+### Risk Validation
+- `client.check_risk(symbol, direction, entry_price, stop_price, quantity, equity)` — Iron Fist validation ($0.004)
+
+### Evaluation
+- `client.basic_eval(r_multiples)` — G metric + verdict ($0.10)
+- `client.full_eval(r_multiples)` — G + rolling G + System R Score ($0.50)
+- `client.comprehensive_eval(r_multiples)` — Full analysis + impact ($1.00)
+
+### Billing
+- `client.get_pricing()` — Operation prices (no auth)
+- `client.get_balance()` — Current USDC balance
+- `client.deposit(amount)` — Record deposit
+- `client.get_transactions()` — Transaction history
+- `client.get_usage()` — Usage summary
+
+## Authentication
+
+Register at [agents.systemr.ai](https://agents.systemr.ai) to get an API key. All paid operations are billed in USDC.
+
+## License
+
+MIT

systemr-1.0.0/systemr.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+systemr/__init__.py
+systemr/client.py
+systemr.egg-info/PKG-INFO
+systemr.egg-info/SOURCES.txt
+systemr.egg-info/dependency_links.txt
+systemr.egg-info/requires.txt
+systemr.egg-info/top_level.txt

systemr-1.0.0/systemr.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

systemr-1.0.0/systemr.egg-info/requires.txt

@@ -0,0 +1 @@
+httpx>=0.24.0

systemr-1.0.0/systemr.egg-info/top_level.txt

@@ -0,0 +1 @@
+systemr