parmana 1.0.0__tar.gz

parmana-1.0.0/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: parmana
+Version: 1.0.0
+Summary: Python SDK for Parmana Execution Trust Infrastructure.
+Author: Parmana
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/parmana-ai/parmana
+Project-URL: Documentation, https://github.com/parmana-ai/parmana/tree/main/python
+Project-URL: Repository, https://github.com/parmana-ai/parmana
+Keywords: ai,artificial-intelligence,autonomous-ai,agents,governance,authorization,execution,trust,policy,sdk
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.32.0
+Dynamic: license-file
+
+\# Parmana Python SDK
+
+
+
+> Proof of Human Authority in AI Systems
+
+
+
+The official Python SDK for Parmana.
+
+
+
+Parmana ensures AI executes only policy-compliant actions.
+
+
+
+\## Status
+
+
+
+Under active development.
+

parmana-1.0.0/README.md

@@ -0,0 +1,22 @@
+\# Parmana Python SDK
+
+
+
+> Proof of Human Authority in AI Systems
+
+
+
+The official Python SDK for Parmana.
+
+
+
+Parmana ensures AI executes only policy-compliant actions.
+
+
+
+\## Status
+
+
+
+Under active development.
+

parmana-1.0.0/parmana/__init__.py

@@ -0,0 +1,38 @@
+"""
+Parmana Python SDK.
+
+Proof of Human Authority in AI Systems.
+
+Parmana ensures AI executes only policy-compliant actions.
+"""
+
+from .client import ParmanaClient
+from .version import __version__
+
+from .models.authority import Authority
+from .models.authorization import Authorization
+from .models.intent import Intent
+from .models.policy import PolicyReference
+from .models.business_transaction import (
+    BusinessTransaction,
+    BusinessTransactionMetadata,
+)
+from .models.verification import Verification
+from .models.receipt import Receipt
+from .models.replay_result import ReplayResult
+from .models.trust_record import ExecutionTrustRecord
+
+__all__ = [
+    "__version__",
+    "ParmanaClient",
+    "Authority",
+    "Authorization",
+    "Intent",
+    "PolicyReference",
+    "BusinessTransactionMetadata",
+    "BusinessTransaction",
+    "Verification",
+    "Receipt",
+    "ReplayResult",
+    "ExecutionTrustRecord",
+]

parmana-1.0.0/parmana/api/__init__.py

@@ -0,0 +1,21 @@
+"""
+Parmana Client APIs.
+"""
+
+from .execution_api import ExecutionApi
+from .verification_api import VerificationApi
+from .replay_api import ReplayApi
+from .receipt_api import ReceiptApi
+from .policy_api import PolicyApi
+from .transaction_api import TransactionApi
+from .trust_record_api import TrustRecordApi
+
+__all__ = [
+    "ExecutionApi",
+    "VerificationApi",
+    "ReplayApi",
+    "ReceiptApi",
+    "PolicyApi",
+    "TransactionApi",
+    "TrustRecordApi",
+]

parmana-1.0.0/parmana/api/execution_api.py

@@ -0,0 +1,73 @@
+"""
+Parmana Execution API.
+
+Execute Business Transactions through the Parmana Runtime.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from parmana.config.transport import Transport
+from parmana.models.business_transaction import BusinessTransaction
+from parmana.models.trust_record import ExecutionTrustRecord
+from parmana.serialization import encode
+
+
+class ExecutionApi:
+    """
+    Execution API.
+
+    Responsibilities
+    ----------------
+    - Runtime health check
+    - Execute Business Transactions
+
+    This API does NOT:
+    - verify trust records
+    - replay executions
+    - generate receipts
+    - validate policies
+    """
+
+    def __init__(
+        self,
+        transport: Transport,
+    ) -> None:
+        self._transport = transport
+
+    def health(
+        self,
+    ) -> dict[str, Any]:
+        """
+        Returns the Runtime health status.
+        """
+
+        return self._transport.send(
+            method="GET",
+            path="/health",
+        )
+
+    def execute(
+        self,
+        transaction: BusinessTransaction,
+    ) -> ExecutionTrustRecord:
+        """
+        Execute a Business Transaction.
+
+        Parameters
+        ----------
+        transaction:
+            Business Transaction submitted to the Parmana Runtime.
+
+        Returns
+        -------
+        Execution Trust Record.
+        """
+
+        return self._transport.send(
+            method="POST",
+            path="/execute",
+            body=encode(transaction),
+            response_model=ExecutionTrustRecord,
+        )

parmana-1.0.0/parmana/api/policy_api.py

@@ -0,0 +1,56 @@
+"""
+Parmana Policy API.
+
+Validate Runtime policies.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from parmana.config.transport import Transport
+
+
+class PolicyApi:
+    """
+    Policy API.
+
+    Responsibilities
+    ----------------
+    - Validate Runtime policies
+
+    This API does NOT:
+    - execute Business Transactions
+    - verify trust records
+    - replay executions
+    - generate receipts
+    """
+
+    def __init__(
+        self,
+        transport: Transport,
+    ) -> None:
+        self._transport = transport
+
+    def validate(
+        self,
+        policy: dict[str, Any],
+    ) -> dict[str, Any]:
+        """
+        Validate a Runtime policy.
+
+        Parameters
+        ----------
+        policy:
+            Policy document.
+
+        Returns
+        -------
+        Policy validation result.
+        """
+
+        return self._transport.send(
+            method="POST",
+            path="/policies/validate",
+            body=policy,
+        )

parmana-1.0.0/parmana/api/receipt_api.py

@@ -0,0 +1,58 @@
+"""
+Parmana Receipt API.
+
+Generate cryptographic execution receipts.
+"""
+
+from __future__ import annotations
+
+from parmana.config.transport import Transport
+from parmana.models.receipt import Receipt
+
+
+class ReceiptApi:
+    """
+    Receipt API.
+
+    Responsibilities
+    ----------------
+    - Generate execution receipts
+
+    This API does NOT:
+    - execute Business Transactions
+    - replay executions
+    - verify trust records
+    - validate policies
+    """
+
+    def __init__(
+        self,
+        transport: Transport,
+    ) -> None:
+        self._transport = transport
+
+    def generate(
+        self,
+        business_transaction_id: str,
+    ) -> Receipt:
+        """
+        Generate an execution receipt.
+
+        Parameters
+        ----------
+        business_transaction_id:
+            Business Transaction identifier.
+
+        Returns
+        -------
+        Receipt.
+        """
+
+        return self._transport.send(
+    method="POST",
+    path="/receipt",
+    body={
+        "businessTransactionId": business_transaction_id,
+    },
+    response_model=Receipt,
+)

parmana-1.0.0/parmana/api/replay_api.py

@@ -0,0 +1,59 @@
+"""
+Parmana Replay API.
+
+Replay Business Transactions.
+"""
+
+from __future__ import annotations
+
+from parmana.config.transport import Transport
+from parmana.models.replay_result import ReplayResult
+
+
+class ReplayApi:
+    """
+    Replay API.
+
+    Responsibilities
+    ----------------
+    - Replay Business Transactions
+    - Verify deterministic execution
+
+    This API does NOT:
+    - execute Business Transactions
+    - verify trust records
+    - generate receipts
+    - validate policies
+    """
+
+    def __init__(
+        self,
+        transport: Transport,
+    ) -> None:
+        self._transport = transport
+
+    def replay(
+        self,
+        business_transaction_id: str,
+    ) -> ReplayResult:
+        """
+        Replay a Business Transaction.
+
+        Parameters
+        ----------
+        business_transaction_id:
+            Business Transaction identifier.
+
+        Returns
+        -------
+        Replay Result.
+        """
+
+        return self._transport.send(
+            method="POST",
+            path="/replay",
+            body={
+                "businessTransactionId": business_transaction_id,
+            },
+            response_model=ReplayResult,
+        )

parmana-1.0.0/parmana/api/transaction_api.py

@@ -0,0 +1,84 @@
+"""
+Parmana Transaction API.
+
+Retrieve Business Transactions.
+"""
+
+from __future__ import annotations
+
+from parmana.config.transport import Transport
+from parmana.models.business_transaction import BusinessTransaction
+
+
+class TransactionApi:
+    """
+    Transaction API.
+
+    Responsibilities
+    ----------------
+    - Retrieve Business Transactions
+    - List Business Transactions
+
+    This API does NOT:
+    - execute Business Transactions
+    - verify trust records
+    - replay executions
+    - generate receipts
+    """
+
+    def __init__(
+        self,
+        transport: Transport,
+    ) -> None:
+        self._transport = transport
+
+    def get(
+        self,
+        business_transaction_id: str,
+    ) -> BusinessTransaction:
+        """
+        Retrieve a Business Transaction.
+
+        Parameters
+        ----------
+        business_transaction_id:
+            Business Transaction identifier.
+
+        Returns
+        -------
+        Business Transaction.
+        """
+
+        return self._transport.send(
+            method="GET",
+            path=f"/transactions/{business_transaction_id}",
+            response_model=BusinessTransaction,
+        )
+
+    def list(
+        self,
+        *,
+        page: int = 1,
+        page_size: int = 25,
+    ) -> list[BusinessTransaction]:
+        """
+        List Business Transactions.
+
+        Parameters
+        ----------
+        page:
+            Page number.
+
+        page_size:
+            Number of transactions per page.
+
+        Returns
+        -------
+        List of Business Transactions.
+        """
+
+        return self._transport.send(
+            method="GET",
+            path=f"/transactions?page={page}&pageSize={page_size}",
+            response_model=list[BusinessTransaction],
+        )

parmana-1.0.0/parmana/api/trust_record_api.py

@@ -0,0 +1,55 @@
+"""
+Parmana Trust Record API.
+
+Retrieve Execution Trust Records.
+"""
+
+from __future__ import annotations
+
+from parmana.config.transport import Transport
+from parmana.models.trust_record import ExecutionTrustRecord
+
+
+class TrustRecordApi:
+    """
+    Trust Record API.
+
+    Responsibilities
+    ----------------
+    - Retrieve Execution Trust Records
+
+    This API does NOT:
+    - execute Business Transactions
+    - verify trust records
+    - replay executions
+    - generate receipts
+    """
+
+    def __init__(
+        self,
+        transport: Transport,
+    ) -> None:
+        self._transport = transport
+
+    def get(
+        self,
+        business_transaction_id: str,
+    ) -> ExecutionTrustRecord:
+        """
+        Retrieve an Execution Trust Record.
+
+        Parameters
+        ----------
+        business_transaction_id:
+            Business Transaction identifier.
+
+        Returns
+        -------
+        Execution Trust Record.
+        """
+
+        return self._transport.send(
+            method="GET",
+            path=f"/trust-records/{business_transaction_id}",
+            response_model=ExecutionTrustRecord,
+        )

parmana-1.0.0/parmana/api/verification_api.py

@@ -0,0 +1,58 @@
+"""
+Parmana Verification API.
+
+Verify Execution Trust Records.
+"""
+
+from __future__ import annotations
+
+from parmana.config.transport import Transport
+from parmana.models.verification import Verification
+
+
+class VerificationApi:
+    """
+    Verification API.
+
+    Responsibilities
+    ----------------
+    - Verify Execution Trust Records
+
+    This API does NOT:
+    - execute Business Transactions
+    - replay executions
+    - generate receipts
+    - validate policies
+    """
+
+    def __init__(
+        self,
+        transport: Transport,
+    ) -> None:
+        self._transport = transport
+
+    def verify(
+        self,
+        business_transaction_id: str,
+    ) -> Verification:
+        """
+        Verify an Execution Trust Record.
+
+        Parameters
+        ----------
+        business_transaction_id:
+            Business Transaction identifier.
+
+        Returns
+        -------
+        Verification.
+        """
+
+        return self._transport.send(
+    method="POST",
+    path="/verify",
+    body={
+        "businessTransactionId": business_transaction_id,
+    },
+    response_model=Verification,
+)

parmana-1.0.0/parmana/client.py

@@ -0,0 +1,121 @@
+"""
+Parmana Client.
+
+Main entry point for the Parmana Python SDK.
+"""
+
+from __future__ import annotations
+
+from parmana.api.execution_api import ExecutionApi
+from parmana.api.policy_api import PolicyApi
+from parmana.api.receipt_api import ReceiptApi
+from parmana.api.replay_api import ReplayApi
+from parmana.api.transaction_api import TransactionApi
+from parmana.api.trust_record_api import TrustRecordApi
+from parmana.api.verification_api import VerificationApi
+
+from parmana.transport.http_transport import HttpTransport
+from parmana.version import __version__
+
+
+class ParmanaClient:
+    """
+    Parmana SDK Client.
+
+    Parmana ensures AI executes only policy-compliant actions.
+
+    Example
+    -------
+    >>> client = ParmanaClient(
+    ...     endpoint="http://localhost:3000",
+    ... )
+
+    >>> trust_record = client.execution.execute(transaction)
+
+    >>> verification = client.verification.verify(
+    ...     transaction.business_transaction_id,
+    ... )
+    """
+
+    DEFAULT_TIMEOUT = 30
+
+    def __init__(
+        self,
+        *,
+        endpoint: str,
+        timeout: int = DEFAULT_TIMEOUT,
+        debug: bool = False,
+    ) -> None:
+        """
+        Create a Parmana SDK client.
+
+        Parameters
+        ----------
+        endpoint:
+            Base URL of the Parmana Runtime.
+
+        timeout:
+            HTTP timeout in seconds.
+
+        debug:
+            Enable request/response logging.
+        """
+
+        self._transport = HttpTransport(
+            endpoint=endpoint,
+            timeout=timeout,
+            debug=debug,
+        )
+
+        #
+        # APIs
+        #
+
+        self.execution = ExecutionApi(
+            self._transport,
+        )
+
+        self.verification = VerificationApi(
+            self._transport,
+        )
+
+        self.replay = ReplayApi(
+            self._transport,
+        )
+
+        self.receipt = ReceiptApi(
+            self._transport,
+        )
+
+        self.transactions = TransactionApi(
+            self._transport,
+        )
+
+        self.trust_records = TrustRecordApi(
+            self._transport,
+        )
+
+        self.policy = PolicyApi(
+            self._transport,
+        )
+
+    @property
+    def endpoint(self) -> str:
+        """
+        Parmana Runtime endpoint.
+        """
+        return self._transport.endpoint
+
+    @property
+    def version(self) -> str:
+        """
+        Parmana SDK version.
+        """
+        return __version__
+
+    def __repr__(self) -> str:
+        return (
+            f"{self.__class__.__name__}("
+            f"endpoint='{self.endpoint}', "
+            f"version='{self.version}')"
+        )

parmana-1.0.0/parmana/config/client_config.py

@@ -0,0 +1,10 @@
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class ClientConfig:
+    """
+    Parmana Client configuration.
+    """
+
+    endpoint: str