chainthread 0.1.0__tar.gz

chainthread-0.1.0/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: chainthread
+Version: 0.1.0
+Summary: Open agent handoff protocol and verification infrastructure.
+Home-page: https://github.com/eugene001dayne/chain-thread
+Author: Eugene Dayne Mawuli
+Author-email: bitelance.team@gmail.com
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# ChainThread Python SDK
+
+Open agent handoff protocol and verification infrastructure.
+
+## Install
+```bash
+pip install chainthread
+```
+
+## Quick Start
+```python
+from chainthread import ChainThread
+
+ct = ChainThread()
+
+# Create a chain
+chain = ct.create_chain(
+    name="my-agent-pipeline",
+    description="Research to writer handoff"
+)
+
+# Send a handoff envelope
+envelope = ct.send_envelope(
+    chain_id=chain["chain_id"],
+    sender_id="research-agent",
+    sender_role="researcher",
+    receiver_id="writer-agent",
+    receiver_role="writer",
+    payload={"summary": "AI is transforming software.", "confidence": 0.95},
+    summary="Research complete, handing off to writer",
+    provenance=[{"field": "summary", "source": "model_generated", "confidence": 0.95}],
+    contract={
+        "required_fields": ["summary", "confidence"],
+        "assertions": [{"field": "confidence", "type": "range", "value": {"min": 0.0, "max": 1.0}}],
+        "on_fail": "block"
+    }
+)
+
+print(envelope["contract_passed"])
+print(ct.stats())
+```
+
+## Links
+- GitHub: https://github.com/eugene001dayne/chain-thread
+- Live API: https://chain-thread.onrender.com

chainthread-0.1.0/README.md

@@ -0,0 +1,45 @@
+# ChainThread Python SDK
+
+Open agent handoff protocol and verification infrastructure.
+
+## Install
+```bash
+pip install chainthread
+```
+
+## Quick Start
+```python
+from chainthread import ChainThread
+
+ct = ChainThread()
+
+# Create a chain
+chain = ct.create_chain(
+    name="my-agent-pipeline",
+    description="Research to writer handoff"
+)
+
+# Send a handoff envelope
+envelope = ct.send_envelope(
+    chain_id=chain["chain_id"],
+    sender_id="research-agent",
+    sender_role="researcher",
+    receiver_id="writer-agent",
+    receiver_role="writer",
+    payload={"summary": "AI is transforming software.", "confidence": 0.95},
+    summary="Research complete, handing off to writer",
+    provenance=[{"field": "summary", "source": "model_generated", "confidence": 0.95}],
+    contract={
+        "required_fields": ["summary", "confidence"],
+        "assertions": [{"field": "confidence", "type": "range", "value": {"min": 0.0, "max": 1.0}}],
+        "on_fail": "block"
+    }
+)
+
+print(envelope["contract_passed"])
+print(ct.stats())
+```
+
+## Links
+- GitHub: https://github.com/eugene001dayne/chain-thread
+- Live API: https://chain-thread.onrender.com

chainthread-0.1.0/chainthread.egg-info/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: chainthread
+Version: 0.1.0
+Summary: Open agent handoff protocol and verification infrastructure.
+Home-page: https://github.com/eugene001dayne/chain-thread
+Author: Eugene Dayne Mawuli
+Author-email: bitelance.team@gmail.com
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# ChainThread Python SDK
+
+Open agent handoff protocol and verification infrastructure.
+
+## Install
+```bash
+pip install chainthread
+```
+
+## Quick Start
+```python
+from chainthread import ChainThread
+
+ct = ChainThread()
+
+# Create a chain
+chain = ct.create_chain(
+    name="my-agent-pipeline",
+    description="Research to writer handoff"
+)
+
+# Send a handoff envelope
+envelope = ct.send_envelope(
+    chain_id=chain["chain_id"],
+    sender_id="research-agent",
+    sender_role="researcher",
+    receiver_id="writer-agent",
+    receiver_role="writer",
+    payload={"summary": "AI is transforming software.", "confidence": 0.95},
+    summary="Research complete, handing off to writer",
+    provenance=[{"field": "summary", "source": "model_generated", "confidence": 0.95}],
+    contract={
+        "required_fields": ["summary", "confidence"],
+        "assertions": [{"field": "confidence", "type": "range", "value": {"min": 0.0, "max": 1.0}}],
+        "on_fail": "block"
+    }
+)
+
+print(envelope["contract_passed"])
+print(ct.stats())
+```
+
+## Links
+- GitHub: https://github.com/eugene001dayne/chain-thread
+- Live API: https://chain-thread.onrender.com

chainthread-0.1.0/chainthread.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+chainthread.py
+setup.py
+chainthread.egg-info/PKG-INFO
+chainthread.egg-info/SOURCES.txt
+chainthread.egg-info/dependency_links.txt
+chainthread.egg-info/requires.txt
+chainthread.egg-info/top_level.txt

chainthread-0.1.0/chainthread.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

chainthread-0.1.0/chainthread.egg-info/requires.txt

@@ -0,0 +1 @@
+httpx

chainthread-0.1.0/chainthread.egg-info/top_level.txt

@@ -0,0 +1 @@
+chainthread

chainthread-0.1.0/chainthread.py

@@ -0,0 +1,105 @@
+import httpx
+from typing import Optional, List, Dict, Any
+
+
+class ChainThread:
+    """
+    Python SDK for ChainThread — open agent handoff protocol
+    and verification infrastructure.
+    """
+
+    def __init__(self, base_url: str = "https://chain-thread.onrender.com"):
+        self.base_url = base_url.rstrip("/")
+
+    def _get(self, path: str):
+        with httpx.Client() as client:
+            r = client.get(f"{self.base_url}{path}")
+            r.raise_for_status()
+            return r.json()
+
+    def _post(self, path: str, data: dict):
+        with httpx.Client() as client:
+            r = client.post(f"{self.base_url}{path}", json=data)
+            r.raise_for_status()
+            return r.json()
+
+    # --- Chains ---
+
+    def create_chain(self, name: str, description: str = None, tags: dict = {}):
+        return self._post("/chains", {
+            "name": name,
+            "description": description,
+            "tags": tags
+        })
+
+    def list_chains(self):
+        return self._get("/chains")
+
+    # --- Envelopes ---
+
+    def send_envelope(
+        self,
+        chain_id: str,
+        sender_id: str,
+        sender_role: str,
+        receiver_id: str,
+        receiver_role: str,
+        payload: Dict[str, Any],
+        summary: str,
+        provenance: List[Dict] = [],
+        contract: Dict = {},
+        on_fail: str = "block"
+    ):
+        return self._post("/envelopes", {
+            "chain_id": chain_id,
+            "sender_id": sender_id,
+            "sender_role": sender_role,
+            "receiver_id": receiver_id,
+            "receiver_role": receiver_role,
+            "payload": payload,
+            "summary": summary,
+            "provenance": provenance,
+            "contract": contract,
+            "on_fail": on_fail
+        })
+
+    def get_envelope(self, envelope_id: str):
+        return self._get(f"/envelopes/{envelope_id}")
+
+    def get_chain_envelopes(self, chain_id: str):
+        return self._get(f"/chains/{chain_id}/envelopes")
+
+    def validate_envelope(self, envelope_id: str):
+        return self._post(f"/envelopes/{envelope_id}/validate", {})
+
+    # --- Violations ---
+
+    def get_violations(self):
+        return self._get("/violations")
+
+    # --- Checkpoints ---
+
+    def create_checkpoint(
+        self,
+        chain_id: str,
+        state_snapshot: Dict[str, Any],
+        envelope_id: str = None,
+        checkpoint_name: str = None
+    ):
+        return self._post("/checkpoints", {
+            "chain_id": chain_id,
+            "envelope_id": envelope_id,
+            "state_snapshot": state_snapshot,
+            "checkpoint_name": checkpoint_name
+        })
+
+    def get_checkpoints(self, chain_id: str):
+        return self._get(f"/checkpoints/{chain_id}")
+
+    # --- Dashboard ---
+
+    def stats(self):
+        return self._get("/dashboard/stats")
+
+    def health(self):
+        return self._get("/health")

chainthread-0.1.0/setup.cfg

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

chainthread-0.1.0/setup.py

@@ -0,0 +1,16 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="chainthread",
+    version="0.1.0",
+    description="Open agent handoff protocol and verification infrastructure.",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    author="Eugene Dayne Mawuli",
+    author_email="bitelance.team@gmail.com",
+    url="https://github.com/eugene001dayne/chain-thread",
+    packages=find_packages(),
+    py_modules=["chainthread"],
+    python_requires=">=3.9",
+    install_requires=["httpx"],
+)