starkgate-sdk 0.2.0__tar.gz

starkgate_sdk-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sentinel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

starkgate_sdk-0.2.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include LICENSE
+include pyproject.toml
+recursive-include tests *.py
+recursive-include src/starkgate *.py

starkgate_sdk-0.2.0/PKG-INFO

@@ -0,0 +1,202 @@
+Metadata-Version: 2.4
+Name: starkgate-sdk
+Version: 0.2.0
+Summary: Official Python SDK for StarkGate — The Universal Firewall for AI Agents
+Author-email: StarkGate <hello@starkgate.dev>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/wenjoseph16/starkgate
+Project-URL: Documentation, https://docs.starkgate.dev
+Project-URL: Repository, https://github.com/wenjoseph16/starkgate
+Project-URL: Issues, https://github.com/wenjoseph16/starkgate/issues
+Keywords: ai,guardrails,security,agents,firewall
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+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 :: Security
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: cryptography>=41.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+Provides-Extra: wasm
+Requires-Dist: wasmtime>=25.0; extra == "wasm"
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.20; extra == "mcp"
+Requires-Dist: pydantic>=2.0; extra == "mcp"
+Provides-Extra: langchain
+Requires-Dist: langchain-core>=0.3; extra == "langchain"
+Dynamic: license-file
+
+# 🛡️ StarkGate SDK
+
+Official Python SDK for [StarkGate](https://github.com/wenjoseph16/starkgate) — The Universal Firewall for AI Agents.
+
+## Installation
+
+```bash
+pip install starkgate-sdk
+```
+
+## Quick Start
+
+```python
+from starkgate import StarkGate
+
+guard = StarkGate(api_key="sk_live_your_key")
+
+result = guard.evaluate(
+    agent_id="my-bot",
+    policy_id="pol_safe",
+    action_type="sql_query",
+    payload={"query": "DROP TABLE users;"}
+)
+
+if result.is_denied:
+    print(f"🛑 Blocked: {result.reason}")
+```
+
+## Decorator Protection
+
+```python
+from starkgate import StarkGate
+
+guard = StarkGate(api_key="sk_live_your_key")
+
+@guard.protect(agent_id="devops", policy_id="pol_prod", action_type="terminal")
+def run_command(cmd: str):
+    import os
+    os.system(cmd)
+
+run_command("ls -la")  # ✅ Allowed
+run_command("rm -rf /")  # ❌ Blocked
+```
+
+## Async Support
+
+```python
+import asyncio
+from starkgate import StarkGate
+
+async def main():
+    guard = StarkGate(api_key="sk_live_your_key")
+    result = await guard.async_evaluate(
+        agent_id="trading-bot",
+        policy_id="pol_trading",
+        action_type="execute_trade",
+        payload={"amount": 50000, "ticker": "AAPL"}
+    )
+    print(result.decision)
+
+asyncio.run(main())
+```
+
+## LangChain
+
+```bash
+pip install "starkgate-sdk[langchain]"
+```
+
+```python
+from starkgate.langchain_guard import make_starkgate_tool
+
+# hors-ligne : politique inline, aucun serveur
+tools = [make_starkgate_tool(policy=my_policy)]
+# cloud      : politique gérée côté serveur
+# tools = [make_starkgate_tool(api_key="sk_live_...", policy_id="pol_x")]
+```
+
+## OpenAI (function calling)
+
+```bash
+pip install "starkgate-sdk[langchain]"   # ou sans LangChain
+```
+
+```python
+from starkgate.openai_guard import make_starkgate_function, run_starkgate_call
+
+tools = [make_starkgate_function(policy=my_policy)]          # mode local
+# … app de chat avec tools=tools ; le modèle renvoie tool_calls …
+
+verdict = run_starkgate_call(policy=my_policy, action_type="transfer",
+                            payload={"op": "payday"})
+if verdict["decision"] == "ALLOW":
+    exécuter_l_action()
+else:
+    # disjoncteur : bloqué, preuve dans verdict["auditHash"]
+    refuser(verdict)
+```
+
+## Engine local (hors-ligne)
+
+Le moteur d'évaluation peut tourner **sans aucun serveur** — bit-à-bit identique
+au moteur serveur (mêmes verdicts, mêmes `auditHash`). Idéal pour l'edge,
+l'air-gap, le drone, la voiture ou le satellite.
+
+```python
+from starkgate import engine
+
+policy = {
+  "id": "pol-1", "name": "demo", "mode": "enforce", "defaultDecision": "ALLOW",
+  "rules": [{
+    "id": "r1", "name": "block payday", "enabled": True,
+    "condition": {"field": "op", "operator": "eq", "value": "payday"},
+    "decision": "DENY", "message": "Bloqué.", "riskLevel": "high",
+  }],
+}
+
+verdict = engine.evaluate(
+  {"agentId": "bot", "policyId": "pol-1",
+   "actionType": "transfer", "payload": {"op": "payday"}},
+  policy,
+)
+print(verdict["decision"], verdict["auditHash"])  # DENY sha256:…
+```
+
+## Serveur MCP
+
+Expose StarkGate à n'importe quel agent (Claude Desktop, Cursor, claude-code…)
+via le [Model Context Protocol](https://modelcontextprotocol.io).
+
+```bash
+pip install "starkgate-sdk[mcp]"
+python -m starkgate.mcp_server            # stdio
+```
+
+Outils : `evaluate` (cloud ou local), `evaluate_local` (100 % hors-ligne) et
+`verify` (re-vérifie une preuve sans le serveur).
+
+Exemple de config `claude_desktop_config.json` :
+
+```json
+{
+  "mcpServers": {
+    "starkgate": {
+      "command": "python",
+      "args": ["-m", "starkgate.mcp_server"]
+    }
+  }
+}
+```
+
+## Démo de bout en bout
+
+```bash
+pip install "starkgate-sdk[mcp]"
+python examples/demo.py
+```
+
+Enregistre un compte, crée une policy, évalue ALLOW + DENY en production, puis
+**re-vérifie la preuve cryptographique hors-ligne** — « Trust the Math, not the
+Platform. »
+
+## License
+
+MIT

starkgate_sdk-0.2.0/README.md

@@ -0,0 +1,165 @@
+# 🛡️ StarkGate SDK
+
+Official Python SDK for [StarkGate](https://github.com/wenjoseph16/starkgate) — The Universal Firewall for AI Agents.
+
+## Installation
+
+```bash
+pip install starkgate-sdk
+```
+
+## Quick Start
+
+```python
+from starkgate import StarkGate
+
+guard = StarkGate(api_key="sk_live_your_key")
+
+result = guard.evaluate(
+    agent_id="my-bot",
+    policy_id="pol_safe",
+    action_type="sql_query",
+    payload={"query": "DROP TABLE users;"}
+)
+
+if result.is_denied:
+    print(f"🛑 Blocked: {result.reason}")
+```
+
+## Decorator Protection
+
+```python
+from starkgate import StarkGate
+
+guard = StarkGate(api_key="sk_live_your_key")
+
+@guard.protect(agent_id="devops", policy_id="pol_prod", action_type="terminal")
+def run_command(cmd: str):
+    import os
+    os.system(cmd)
+
+run_command("ls -la")  # ✅ Allowed
+run_command("rm -rf /")  # ❌ Blocked
+```
+
+## Async Support
+
+```python
+import asyncio
+from starkgate import StarkGate
+
+async def main():
+    guard = StarkGate(api_key="sk_live_your_key")
+    result = await guard.async_evaluate(
+        agent_id="trading-bot",
+        policy_id="pol_trading",
+        action_type="execute_trade",
+        payload={"amount": 50000, "ticker": "AAPL"}
+    )
+    print(result.decision)
+
+asyncio.run(main())
+```
+
+## LangChain
+
+```bash
+pip install "starkgate-sdk[langchain]"
+```
+
+```python
+from starkgate.langchain_guard import make_starkgate_tool
+
+# hors-ligne : politique inline, aucun serveur
+tools = [make_starkgate_tool(policy=my_policy)]
+# cloud      : politique gérée côté serveur
+# tools = [make_starkgate_tool(api_key="sk_live_...", policy_id="pol_x")]
+```
+
+## OpenAI (function calling)
+
+```bash
+pip install "starkgate-sdk[langchain]"   # ou sans LangChain
+```
+
+```python
+from starkgate.openai_guard import make_starkgate_function, run_starkgate_call
+
+tools = [make_starkgate_function(policy=my_policy)]          # mode local
+# … app de chat avec tools=tools ; le modèle renvoie tool_calls …
+
+verdict = run_starkgate_call(policy=my_policy, action_type="transfer",
+                            payload={"op": "payday"})
+if verdict["decision"] == "ALLOW":
+    exécuter_l_action()
+else:
+    # disjoncteur : bloqué, preuve dans verdict["auditHash"]
+    refuser(verdict)
+```
+
+## Engine local (hors-ligne)
+
+Le moteur d'évaluation peut tourner **sans aucun serveur** — bit-à-bit identique
+au moteur serveur (mêmes verdicts, mêmes `auditHash`). Idéal pour l'edge,
+l'air-gap, le drone, la voiture ou le satellite.
+
+```python
+from starkgate import engine
+
+policy = {
+  "id": "pol-1", "name": "demo", "mode": "enforce", "defaultDecision": "ALLOW",
+  "rules": [{
+    "id": "r1", "name": "block payday", "enabled": True,
+    "condition": {"field": "op", "operator": "eq", "value": "payday"},
+    "decision": "DENY", "message": "Bloqué.", "riskLevel": "high",
+  }],
+}
+
+verdict = engine.evaluate(
+  {"agentId": "bot", "policyId": "pol-1",
+   "actionType": "transfer", "payload": {"op": "payday"}},
+  policy,
+)
+print(verdict["decision"], verdict["auditHash"])  # DENY sha256:…
+```
+
+## Serveur MCP
+
+Expose StarkGate à n'importe quel agent (Claude Desktop, Cursor, claude-code…)
+via le [Model Context Protocol](https://modelcontextprotocol.io).
+
+```bash
+pip install "starkgate-sdk[mcp]"
+python -m starkgate.mcp_server            # stdio
+```
+
+Outils : `evaluate` (cloud ou local), `evaluate_local` (100 % hors-ligne) et
+`verify` (re-vérifie une preuve sans le serveur).
+
+Exemple de config `claude_desktop_config.json` :
+
+```json
+{
+  "mcpServers": {
+    "starkgate": {
+      "command": "python",
+      "args": ["-m", "starkgate.mcp_server"]
+    }
+  }
+}
+```
+
+## Démo de bout en bout
+
+```bash
+pip install "starkgate-sdk[mcp]"
+python examples/demo.py
+```
+
+Enregistre un compte, crée une policy, évalue ALLOW + DENY en production, puis
+**re-vérifie la preuve cryptographique hors-ligne** — « Trust the Math, not the
+Platform. »
+
+## License
+
+MIT

starkgate_sdk-0.2.0/pyproject.toml

@@ -0,0 +1,59 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta:__legacy__"
+
+[project]
+name = "starkgate-sdk"
+version = "0.2.0"
+description = "Official Python SDK for StarkGate — The Universal Firewall for AI Agents"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [{name = "StarkGate", email = "hello@starkgate.dev"}]
+keywords = ["ai", "guardrails", "security", "agents", "firewall"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "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 :: Security",
+    "Topic :: Software Development :: Libraries",
+]
+dependencies = [
+    "httpx>=0.25.0",
+    "cryptography>=41.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.21",
+]
+wasm = [
+    "wasmtime>=25.0",
+]
+mcp = [
+    "mcp>=1.20",
+    "pydantic>=2.0",
+]
+langchain = [
+    "langchain-core>=0.3",
+]
+
+[project.urls]
+Homepage = "https://github.com/wenjoseph16/starkgate"
+Documentation = "https://docs.starkgate.dev"
+Repository = "https://github.com/wenjoseph16/starkgate"
+Issues = "https://github.com/wenjoseph16/starkgate/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+starkgate = ["*.wasm"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

starkgate_sdk-0.2.0/setup.cfg

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

starkgate_sdk-0.2.0/src/starkgate/__init__.py

@@ -0,0 +1,42 @@
+from starkgate.client import StarkGate
+from starkgate.models import EvaluationResult, Policy, Rule
+from starkgate.ed25519 import (
+    sign_ed25519,
+    verify_ed25519,
+    ed25519_public_key,
+)
+from starkgate.local_audit import (
+    audit_hash,
+    chain_hash,
+    verify_chain,
+    verify_audit_entry,
+    verify_verdict_local,
+)
+from starkgate.engine import (
+    evaluate as evaluate,
+    evaluate_condition,
+    evaluate_operator,
+    get_nested_value,
+    StarkGateLocalError,
+)
+
+__version__ = "0.2.0"
+__all__ = [
+    "StarkGate",
+    "EvaluationResult",
+    "Policy",
+    "Rule",
+    "sign_ed25519",
+    "verify_ed25519",
+    "ed25519_public_key",
+    "audit_hash",
+    "chain_hash",
+    "verify_chain",
+    "verify_audit_entry",
+    "verify_verdict_local",
+    "evaluate",
+    "evaluate_condition",
+    "evaluate_operator",
+    "get_nested_value",
+    "StarkGateLocalError",
+]