secondopinion-sdk 0.1.0__tar.gz

secondopinion_sdk-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+node_modules
+dist
+.env
+.env.local
+.env*.local
+.next
+.vercel
+*.tsbuildinfo
+*.tgz
+nul
+.2ndopinion/
+docs/specs/

secondopinion_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: secondopinion-sdk
+Version: 0.1.0
+Summary: Python SDK for the 2ndOpinion API
+Project-URL: Homepage, https://get2ndopinion.dev
+Project-URL: Repository, https://github.com/brianmello8/2ndopinion
+Author-email: 2ndOpinion <hello@get2ndopinion.dev>
+License: MIT
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Requires-Dist: httpx>=0.24.0
+Description-Content-Type: text/markdown
+
+# secondopinion
+
+Python SDK for the [2ndOpinion](https://get2ndopinion.dev) API — AI-to-AI code review.
+
+## Installation
+
+```bash
+pip install secondopinion-sdk
+```
+
+## Quick Start
+
+```python
+from secondopinion import SecondOpinion
+
+client = SecondOpinion(api_key="sk_2op_...")
+
+# Get a code review
+result = client.opinion(diff="your git diff here", llm="codex")
+print(result["analysis"]["summary"])
+
+# Ask a question
+answer = client.ask(question="Is this SQL query safe?", code="SELECT * FROM users WHERE id = " + user_id)
+print(answer["response"])
+
+# Check usage
+status = client.status()
+print(f"Credits: {status['totalAvailable']}")
+```
+
+## Available Methods
+
+| Method | Description | Credits |
+|--------|-------------|---------|
+| `opinion(diff, llm, context)` | Single-model code review | 1 |
+| `ask(question, llm, code, context)` | Ask an AI model a question | 1 |
+| `review(diff, llm, context)` | Code review (alias for opinion) | 1 |
+| `explain(diff, audience)` | Explain changes | 1 |
+| `consensus(diff, context)` | 3-model consensus review | 3 |
+| `bug_hunt(diff, context)` | 3-model bug detection | 3 |
+| `security_audit(diff, context)` | OWASP security scan | 1-3 |
+| `generate_tests(diff, llm, framework)` | Generate tests | 1 |
+| `status()` | Check account credits | 0 |
+
+## Links
+
+- [Documentation](https://get2ndopinion.dev/docs)
+- [Pricing](https://get2ndopinion.dev/pricing)
+- [API Reference](https://get2ndopinion.dev/docs/api)

secondopinion_sdk-0.1.0/README.md

@@ -0,0 +1,49 @@
+# secondopinion
+
+Python SDK for the [2ndOpinion](https://get2ndopinion.dev) API — AI-to-AI code review.
+
+## Installation
+
+```bash
+pip install secondopinion-sdk
+```
+
+## Quick Start
+
+```python
+from secondopinion import SecondOpinion
+
+client = SecondOpinion(api_key="sk_2op_...")
+
+# Get a code review
+result = client.opinion(diff="your git diff here", llm="codex")
+print(result["analysis"]["summary"])
+
+# Ask a question
+answer = client.ask(question="Is this SQL query safe?", code="SELECT * FROM users WHERE id = " + user_id)
+print(answer["response"])
+
+# Check usage
+status = client.status()
+print(f"Credits: {status['totalAvailable']}")
+```
+
+## Available Methods
+
+| Method | Description | Credits |
+|--------|-------------|---------|
+| `opinion(diff, llm, context)` | Single-model code review | 1 |
+| `ask(question, llm, code, context)` | Ask an AI model a question | 1 |
+| `review(diff, llm, context)` | Code review (alias for opinion) | 1 |
+| `explain(diff, audience)` | Explain changes | 1 |
+| `consensus(diff, context)` | 3-model consensus review | 3 |
+| `bug_hunt(diff, context)` | 3-model bug detection | 3 |
+| `security_audit(diff, context)` | OWASP security scan | 1-3 |
+| `generate_tests(diff, llm, framework)` | Generate tests | 1 |
+| `status()` | Check account credits | 0 |
+
+## Links
+
+- [Documentation](https://get2ndopinion.dev/docs)
+- [Pricing](https://get2ndopinion.dev/pricing)
+- [API Reference](https://get2ndopinion.dev/docs/api)

secondopinion_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "secondopinion-sdk"
+version = "0.1.0"
+description = "Python SDK for the 2ndOpinion API"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [{name = "2ndOpinion", email = "hello@get2ndopinion.dev"}]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = ["httpx>=0.24.0"]
+
+[project.urls]
+Homepage = "https://get2ndopinion.dev"
+Repository = "https://github.com/brianmello8/2ndopinion"
+
+[tool.hatch.build.targets.wheel]
+packages = ["secondopinion"]

secondopinion_sdk-0.1.0/secondopinion/__init__.py

@@ -0,0 +1,4 @@
+from .client import SecondOpinion, SecondOpinionError
+
+__all__ = ["SecondOpinion", "SecondOpinionError"]
+__version__ = "0.1.0"

secondopinion_sdk-0.1.0/secondopinion/client.py

@@ -0,0 +1,176 @@
+"""2ndOpinion Python SDK"""
+
+from __future__ import annotations
+
+import time
+from typing import Any, AsyncIterator, Optional
+
+import httpx
+
+
+class SecondOpinionError(Exception):
+    """Error from the 2ndOpinion API."""
+
+    def __init__(self, message: str, status: int, code: str):
+        super().__init__(message)
+        self.status = status
+        self.code = code
+
+
+class SecondOpinion:
+    """Client for the 2ndOpinion API.
+
+    Usage::
+
+        client = SecondOpinion(api_key="sk_2op_...")
+        result = client.opinion(diff="diff --git a/foo.ts ...")
+        print(result["analysis"]["summary"])
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = "https://get2ndopinion.dev",
+        timeout: float = 45.0,
+        max_retries: int = 2,
+    ):
+        if not api_key:
+            raise ValueError("api_key is required")
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+        self.max_retries = max_retries
+        self._client = httpx.Client(
+            base_url=self.base_url,
+            headers={
+                "Content-Type": "application/json",
+                "X-2ndOpinion-Key": self.api_key,
+            },
+            timeout=self.timeout,
+        )
+
+    def _request(self, method: str, path: str, **kwargs: Any) -> dict:
+        last_error: Optional[Exception] = None
+
+        for attempt in range(self.max_retries + 1):
+            try:
+                response = self._client.request(method, path, **kwargs)
+
+                if response.status_code >= 400:
+                    body = response.json() if response.headers.get("content-type", "").startswith("application/json") else {}
+                    error = SecondOpinionError(
+                        body.get("error", f"HTTP {response.status_code}"),
+                        response.status_code,
+                        "RATE_LIMIT" if response.status_code == 429
+                        else "INSUFFICIENT_CREDITS" if response.status_code == 402
+                        else "FORBIDDEN" if response.status_code == 403
+                        else "UNAUTHORIZED" if response.status_code == 401
+                        else "API_ERROR",
+                    )
+                    if response.status_code != 429 and response.status_code < 500:
+                        raise error
+                    last_error = error
+                    continue
+
+                return response.json()
+
+            except SecondOpinionError:
+                raise
+            except Exception as e:
+                last_error = e
+                if attempt < self.max_retries:
+                    time.sleep(2**attempt)
+
+        raise last_error or Exception("Request failed")
+
+    def opinion(
+        self,
+        diff: str,
+        context: str = "",
+        llm: str = "codex",
+    ) -> dict:
+        """Analyze a git diff for risks and suggestions."""
+        return self._request(
+            "POST",
+            "/api/gateway/opinion",
+            json={"diff": diff, "context": context, "llm": llm},
+        )
+
+    def review(
+        self,
+        diff: str,
+        context: str = "",
+        llm: str = "codex",
+    ) -> dict:
+        """Detailed code review of a git diff."""
+        return self._request(
+            "POST",
+            "/api/gateway/review",
+            json={"diff": diff, "context": context, "llm": llm},
+        )
+
+    def ask(
+        self,
+        question: str,
+        context: str = "",
+        code: str = "",
+        llm: str = "codex",
+    ) -> dict:
+        """Ask a question about code."""
+        return self._request(
+            "POST",
+            "/api/gateway/ask",
+            json={"question": question, "context": context, "code": code, "llm": llm},
+        )
+
+    def batch(
+        self,
+        files: list[dict],
+        llm: str = "codex",
+    ) -> dict:
+        """Analyze multiple files in one request.
+
+        Args:
+            files: List of {"file": "path", "diff": "diff content"}
+            llm: LLM to use
+        """
+        return self._request(
+            "POST",
+            "/api/gateway/batch",
+            json={"files": files, "llm": llm},
+        )
+
+    def status(self) -> dict:
+        """Get account status, usage, and available features."""
+        return self._request("GET", "/api/gateway/status")
+
+    def stream(
+        self,
+        diff: str,
+        context: str = "",
+        llm: str = "codex",
+    ) -> httpx.Response:
+        """Stream an analysis response (SSE).
+
+        Returns an httpx Response that can be iterated::
+
+            with client.stream(diff="...") as response:
+                for line in response.iter_lines():
+                    if line.startswith("data: "):
+                        print(line[6:])
+        """
+        return self._client.stream(
+            "POST",
+            "/api/gateway/opinion/stream",
+            json={"diff": diff, "context": context, "llm": llm},
+        )
+
+    def close(self):
+        """Close the HTTP client."""
+        self._client.close()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.close()