agentic-contract 0.1.0__tar.gz

agentic_contract-0.1.0/PKG-INFO

@@ -0,0 +1,19 @@
+Metadata-Version: 2.4
+Name: agentic-contract
+Version: 0.1.0
+Summary: Policy engine for AI agents
+Author-email: Agentra Labs <contact@agentralabs.tech>
+License: MIT
+Project-URL: Homepage, https://agentralabs.tech
+Project-URL: Repository, https://github.com/agentralabs/agentic-contract
+Keywords: ai,agents,contract,policy,governance
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"

agentic_contract-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "agentic-contract"
+version = "0.1.0"
+description = "Policy engine for AI agents"
+readme = "README.md"
+requires-python = ">=3.9"
+license = {text = "MIT"}
+authors = [{name = "Agentra Labs", email = "contact@agentralabs.tech"}]
+keywords = ["ai", "agents", "contract", "policy", "governance"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Libraries",
+]
+dependencies = []
+
+[project.optional-dependencies]
+dev = ["pytest>=7.0", "pytest-cov>=4.0"]
+
+[project.urls]
+Homepage = "https://agentralabs.tech"
+Repository = "https://github.com/agentralabs/agentic-contract"

agentic_contract-0.1.0/setup.cfg

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

agentic_contract-0.1.0/src/agentic_contract/__init__.py

@@ -0,0 +1,86 @@
+"""AgenticContract — Policy engine for AI agents.
+
+This Python SDK wraps the `acon` CLI binary via subprocess.
+"""
+
+from __future__ import annotations
+
+import json
+import subprocess
+from pathlib import Path
+from typing import Any, Optional
+
+
+__version__ = "0.1.0"
+
+
+class ContractEngine:
+    """High-level wrapper around the acon CLI."""
+
+    def __init__(self, path: Optional[str] = None, binary: str = "acon"):
+        self._binary = binary
+        self._path = path or str(
+            Path.home() / ".agentic" / "contract.acon"
+        )
+
+    def _run(self, *args: str) -> str:
+        """Run an acon CLI command and return stdout."""
+        cmd = [self._binary, "--path", self._path, *args]
+        result = subprocess.run(
+            cmd, capture_output=True, text=True, timeout=30
+        )
+        if result.returncode != 0:
+            raise RuntimeError(
+                f"acon failed (exit {result.returncode}): {result.stderr.strip()}"
+            )
+        return result.stdout.strip()
+
+    def stats(self) -> dict[str, Any]:
+        """Get contract statistics."""
+        output = self._run("stats")
+        return json.loads(output)
+
+    def policy_add(
+        self,
+        label: str,
+        scope: str = "global",
+        action: str = "deny",
+        description: Optional[str] = None,
+    ) -> str:
+        """Add a policy and return its ID."""
+        args = ["policy", "add", label, "--scope", scope, "--action", action]
+        if description:
+            args.extend(["--description", description])
+        output = self._run(*args)
+        # Output: "Created policy: <uuid>"
+        return output.split(": ", 1)[-1]
+
+    def policy_check(self, action_type: str, scope: str = "global") -> str:
+        """Check if an action is allowed. Returns the decision string."""
+        output = self._run("policy", "check", action_type, "--scope", scope)
+        return output
+
+    def risk_limit_set(
+        self,
+        label: str,
+        max_value: float,
+        limit_type: str = "threshold",
+    ) -> str:
+        """Set a risk limit and return its ID."""
+        output = self._run(
+            "limit", "set", label, "--max", str(max_value), "--type", limit_type
+        )
+        return output.split(": ", 1)[-1]
+
+    def violation_report(
+        self,
+        description: str,
+        severity: str = "warning",
+        actor: str = "unknown",
+    ) -> str:
+        """Report a violation and return its ID."""
+        output = self._run(
+            "violation", "report", description,
+            "--severity", severity, "--actor", actor,
+        )
+        return output.split(": ", 1)[-1]

agentic_contract-0.1.0/src/agentic_contract.egg-info/PKG-INFO

@@ -0,0 +1,19 @@
+Metadata-Version: 2.4
+Name: agentic-contract
+Version: 0.1.0
+Summary: Policy engine for AI agents
+Author-email: Agentra Labs <contact@agentralabs.tech>
+License: MIT
+Project-URL: Homepage, https://agentralabs.tech
+Project-URL: Repository, https://github.com/agentralabs/agentic-contract
+Keywords: ai,agents,contract,policy,governance
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"

agentic_contract-0.1.0/src/agentic_contract.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+pyproject.toml
+src/agentic_contract/__init__.py
+src/agentic_contract.egg-info/PKG-INFO
+src/agentic_contract.egg-info/SOURCES.txt
+src/agentic_contract.egg-info/dependency_links.txt
+src/agentic_contract.egg-info/requires.txt
+src/agentic_contract.egg-info/top_level.txt
+tests/test_contract_engine.py

agentic_contract-0.1.0/src/agentic_contract.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

agentic_contract-0.1.0/src/agentic_contract.egg-info/requires.txt

@@ -0,0 +1,4 @@
+
+[dev]
+pytest>=7.0
+pytest-cov>=4.0

agentic_contract-0.1.0/src/agentic_contract.egg-info/top_level.txt

@@ -0,0 +1 @@
+agentic_contract

agentic_contract-0.1.0/tests/test_contract_engine.py

@@ -0,0 +1,28 @@
+"""Basic tests for the AgenticContract Python SDK."""
+
+import pytest
+
+from agentic_contract import ContractEngine
+
+
+def test_import():
+    """Verify the module imports correctly."""
+    assert ContractEngine is not None
+
+
+def test_version():
+    """Verify version is set."""
+    import agentic_contract
+    assert agentic_contract.__version__ == "0.1.0"
+
+
+def test_engine_init():
+    """Verify engine can be instantiated."""
+    engine = ContractEngine(path="/tmp/test.acon")
+    assert engine._path == "/tmp/test.acon"
+
+
+def test_engine_custom_binary():
+    """Verify engine accepts custom binary path."""
+    engine = ContractEngine(binary="/usr/local/bin/acon")
+    assert engine._binary == "/usr/local/bin/acon"