promptthread 0.1.0__tar.gz

promptthread-0.1.0/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: promptthread
+Version: 0.1.0
+Summary: Git for prompts. Version control and performance tracking for AI prompts.
+Home-page: https://github.com/eugene001dayne/prompt-thread
+Author: Eugene Mawuli
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: httpx
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# PromptThread Python SDK
+
+Git for prompts. Version control and performance tracking for AI prompts.
+
+Part of the [Thread Suite](https://github.com/eugene001dayne/prompt-thread) — open-source reliability tools for AI agents.
+
+## Installation
+```bash
+pip install promptthread
+```
+
+## Quick Start
+```python
+from promptthread import PromptThread
+
+pt = PromptThread("https://prompt-thread.onrender.com")
+
+# Create a prompt
+prompt = pt.create_prompt(
+    name="summarizer-v1",
+    content="You are a summarizer. Return a 3-sentence summary.",
+    description="First summarizer prompt",
+    tags=["summarizer"]
+)
+
+prompt_id = prompt["id"]
+
+# Log a run against it
+pt.log_run(
+    prompt_id=prompt_id,
+    prompt_version=1,
+    input="Long text here...",
+    output="Summary here...",
+    latency_ms=340.5,
+    cost_usd=0.000021,
+    passed=True,
+    metadata={"model": "gpt-4o"}
+)
+
+# Get performance stats
+stats = pt.get_stats(prompt_id)
+print(stats)
+
+# Update the prompt (creates new version automatically)
+pt.update_prompt(
+    prompt_id=prompt_id,
+    content="You are a summarizer. Return a 2-sentence summary.",
+)
+
+# See what changed
+diff = pt.diff(prompt_id, version_a=1, version_b=2)
+print(diff)
+
+# Roll back to version 1
+pt.rollback(prompt_id, version=1)
+```
+
+## API Reference
+
+### Prompts
+
+| Method | Description |
+|--------|-------------|
+| `create_prompt(name, content, description, tags)` | Create a new prompt at version 1 |
+| `list_prompts()` | List all prompts |
+| `get_prompt(prompt_id)` | Get a prompt by ID |
+| `update_prompt(prompt_id, content, description, tags)` | Update prompt, auto-increments version |
+| `get_history(prompt_id)` | Get all previous versions |
+| `rollback(prompt_id, version)` | Roll back to a previous version |
+| `diff(prompt_id, version_a, version_b)` | Compare two versions |
+
+### Runs
+
+| Method | Description |
+|--------|-------------|
+| `log_run(prompt_id, prompt_version, ...)` | Log a run against a prompt version |
+| `get_runs(prompt_id)` | Get all runs for a prompt |
+| `get_stats(prompt_id)` | Get pass rate, latency, cost stats |
+| `compare(prompt_id, version_a, version_b)` | Compare performance between versions |
+
+## Part of the Thread Suite
+
+| Tool | What it does |
+|------|-------------|
+| [Iron-Thread](https://github.com/eugene001dayne/iron-thread) | Validates AI output structure before it hits your database |
+| [TestThread](https://github.com/eugene001dayne/test-thread) | Tests whether your agent behaves correctly across runs |
+| **PromptThread** | Versions and tracks prompt performance over time |

promptthread-0.1.0/README.md

@@ -0,0 +1,87 @@
+# PromptThread Python SDK
+
+Git for prompts. Version control and performance tracking for AI prompts.
+
+Part of the [Thread Suite](https://github.com/eugene001dayne/prompt-thread) — open-source reliability tools for AI agents.
+
+## Installation
+```bash
+pip install promptthread
+```
+
+## Quick Start
+```python
+from promptthread import PromptThread
+
+pt = PromptThread("https://prompt-thread.onrender.com")
+
+# Create a prompt
+prompt = pt.create_prompt(
+    name="summarizer-v1",
+    content="You are a summarizer. Return a 3-sentence summary.",
+    description="First summarizer prompt",
+    tags=["summarizer"]
+)
+
+prompt_id = prompt["id"]
+
+# Log a run against it
+pt.log_run(
+    prompt_id=prompt_id,
+    prompt_version=1,
+    input="Long text here...",
+    output="Summary here...",
+    latency_ms=340.5,
+    cost_usd=0.000021,
+    passed=True,
+    metadata={"model": "gpt-4o"}
+)
+
+# Get performance stats
+stats = pt.get_stats(prompt_id)
+print(stats)
+
+# Update the prompt (creates new version automatically)
+pt.update_prompt(
+    prompt_id=prompt_id,
+    content="You are a summarizer. Return a 2-sentence summary.",
+)
+
+# See what changed
+diff = pt.diff(prompt_id, version_a=1, version_b=2)
+print(diff)
+
+# Roll back to version 1
+pt.rollback(prompt_id, version=1)
+```
+
+## API Reference
+
+### Prompts
+
+| Method | Description |
+|--------|-------------|
+| `create_prompt(name, content, description, tags)` | Create a new prompt at version 1 |
+| `list_prompts()` | List all prompts |
+| `get_prompt(prompt_id)` | Get a prompt by ID |
+| `update_prompt(prompt_id, content, description, tags)` | Update prompt, auto-increments version |
+| `get_history(prompt_id)` | Get all previous versions |
+| `rollback(prompt_id, version)` | Roll back to a previous version |
+| `diff(prompt_id, version_a, version_b)` | Compare two versions |
+
+### Runs
+
+| Method | Description |
+|--------|-------------|
+| `log_run(prompt_id, prompt_version, ...)` | Log a run against a prompt version |
+| `get_runs(prompt_id)` | Get all runs for a prompt |
+| `get_stats(prompt_id)` | Get pass rate, latency, cost stats |
+| `compare(prompt_id, version_a, version_b)` | Compare performance between versions |
+
+## Part of the Thread Suite
+
+| Tool | What it does |
+|------|-------------|
+| [Iron-Thread](https://github.com/eugene001dayne/iron-thread) | Validates AI output structure before it hits your database |
+| [TestThread](https://github.com/eugene001dayne/test-thread) | Tests whether your agent behaves correctly across runs |
+| **PromptThread** | Versions and tracks prompt performance over time |

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

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: promptthread
+Version: 0.1.0
+Summary: Git for prompts. Version control and performance tracking for AI prompts.
+Home-page: https://github.com/eugene001dayne/prompt-thread
+Author: Eugene Mawuli
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: httpx
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# PromptThread Python SDK
+
+Git for prompts. Version control and performance tracking for AI prompts.
+
+Part of the [Thread Suite](https://github.com/eugene001dayne/prompt-thread) — open-source reliability tools for AI agents.
+
+## Installation
+```bash
+pip install promptthread
+```
+
+## Quick Start
+```python
+from promptthread import PromptThread
+
+pt = PromptThread("https://prompt-thread.onrender.com")
+
+# Create a prompt
+prompt = pt.create_prompt(
+    name="summarizer-v1",
+    content="You are a summarizer. Return a 3-sentence summary.",
+    description="First summarizer prompt",
+    tags=["summarizer"]
+)
+
+prompt_id = prompt["id"]
+
+# Log a run against it
+pt.log_run(
+    prompt_id=prompt_id,
+    prompt_version=1,
+    input="Long text here...",
+    output="Summary here...",
+    latency_ms=340.5,
+    cost_usd=0.000021,
+    passed=True,
+    metadata={"model": "gpt-4o"}
+)
+
+# Get performance stats
+stats = pt.get_stats(prompt_id)
+print(stats)
+
+# Update the prompt (creates new version automatically)
+pt.update_prompt(
+    prompt_id=prompt_id,
+    content="You are a summarizer. Return a 2-sentence summary.",
+)
+
+# See what changed
+diff = pt.diff(prompt_id, version_a=1, version_b=2)
+print(diff)
+
+# Roll back to version 1
+pt.rollback(prompt_id, version=1)
+```
+
+## API Reference
+
+### Prompts
+
+| Method | Description |
+|--------|-------------|
+| `create_prompt(name, content, description, tags)` | Create a new prompt at version 1 |
+| `list_prompts()` | List all prompts |
+| `get_prompt(prompt_id)` | Get a prompt by ID |
+| `update_prompt(prompt_id, content, description, tags)` | Update prompt, auto-increments version |
+| `get_history(prompt_id)` | Get all previous versions |
+| `rollback(prompt_id, version)` | Roll back to a previous version |
+| `diff(prompt_id, version_a, version_b)` | Compare two versions |
+
+### Runs
+
+| Method | Description |
+|--------|-------------|
+| `log_run(prompt_id, prompt_version, ...)` | Log a run against a prompt version |
+| `get_runs(prompt_id)` | Get all runs for a prompt |
+| `get_stats(prompt_id)` | Get pass rate, latency, cost stats |
+| `compare(prompt_id, version_a, version_b)` | Compare performance between versions |
+
+## Part of the Thread Suite
+
+| Tool | What it does |
+|------|-------------|
+| [Iron-Thread](https://github.com/eugene001dayne/iron-thread) | Validates AI output structure before it hits your database |
+| [TestThread](https://github.com/eugene001dayne/test-thread) | Tests whether your agent behaves correctly across runs |
+| **PromptThread** | Versions and tracks prompt performance over time |

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

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

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

@@ -0,0 +1 @@
+

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

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

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

@@ -0,0 +1 @@
+promptthread

promptthread-0.1.0/promptthread.py

@@ -0,0 +1,87 @@
+import httpx
+from typing import Optional, Dict, Any, List
+
+
+class PromptThread:
+    def __init__(self, base_url: str):
+        self.base_url = base_url.rstrip("/")
+        self.client = httpx.Client(base_url=self.base_url)
+
+    # --- Prompts ---
+
+    def create_prompt(self, name: str, content: str, description: str = None, tags: List[str] = []):
+        r = self.client.post("/prompts/", json={
+            "name": name,
+            "content": content,
+            "description": description,
+            "tags": tags
+        })
+        r.raise_for_status()
+        return r.json()
+
+    def list_prompts(self):
+        r = self.client.get("/prompts/")
+        r.raise_for_status()
+        return r.json()
+
+    def get_prompt(self, prompt_id: str):
+        r = self.client.get(f"/prompts/{prompt_id}")
+        r.raise_for_status()
+        return r.json()
+
+    def update_prompt(self, prompt_id: str, content: str, description: str = None, tags: List[str] = []):
+        r = self.client.put(f"/prompts/{prompt_id}", json={
+            "content": content,
+            "description": description,
+            "tags": tags
+        })
+        r.raise_for_status()
+        return r.json()
+
+    def get_history(self, prompt_id: str):
+        r = self.client.get(f"/prompts/{prompt_id}/history")
+        r.raise_for_status()
+        return r.json()
+
+    def rollback(self, prompt_id: str, version: int):
+        r = self.client.post(f"/prompts/{prompt_id}/rollback/{version}")
+        r.raise_for_status()
+        return r.json()
+
+    def diff(self, prompt_id: str, version_a: int, version_b: int):
+        r = self.client.get(f"/prompts/{prompt_id}/diff/{version_a}/{version_b}")
+        r.raise_for_status()
+        return r.json()
+
+    # --- Runs ---
+
+    def log_run(self, prompt_id: str, prompt_version: int, input: str = None,
+                output: str = None, latency_ms: float = None, cost_usd: float = None,
+                passed: bool = None, metadata: Dict[str, Any] = {}):
+        r = self.client.post("/runs/", json={
+            "prompt_id": prompt_id,
+            "prompt_version": prompt_version,
+            "input": input,
+            "output": output,
+            "latency_ms": latency_ms,
+            "cost_usd": cost_usd,
+            "passed": passed,
+            "metadata": metadata
+        })
+        r.raise_for_status()
+        return r.json()
+
+    def get_runs(self, prompt_id: str):
+        r = self.client.get(f"/runs/prompt/{prompt_id}")
+        r.raise_for_status()
+        return r.json()
+
+    def get_stats(self, prompt_id: str):
+        r = self.client.get(f"/runs/prompt/{prompt_id}/stats")
+        r.raise_for_status()
+        return r.json()
+
+    def compare(self, prompt_id: str, version_a: int, version_b: int):
+        r = self.client.get(f"/runs/compare/{prompt_id}/{version_a}/{version_b}")
+        r.raise_for_status()
+        return r.json()

promptthread-0.1.0/setup.cfg

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

promptthread-0.1.0/setup.py

@@ -0,0 +1,19 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="promptthread",
+    version="0.1.0",
+    description="Git for prompts. Version control and performance tracking for AI prompts.",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    author="Eugene Mawuli",
+    url="https://github.com/eugene001dayne/prompt-thread",
+    py_modules=["promptthread"],
+    install_requires=["httpx"],
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires=">=3.8",
+)