stackresolve 0.1.0__tar.gz → 0.2.0__tar.gz

stackresolve-0.2.0/.gitignore

@@ -0,0 +1,21 @@
+node_modules/
+node_modules
+.next/
+.env*
+!.env.example
+.DS_Store
+*.log
+/.claude/worktrees/
+
+# prior-work semantic vector cache (machine-local)
+.claude/cache/
+
+# playwright e2e artifacts
+test-results/
+playwright-report/
+blob-report/
+playwright/.cache/
+**/e2e/.auth/
+
+# SEO submit run logs (per-run audit trail, written by scripts/seo/*)
+scripts/seo/index-submit-log.tsv

{stackresolve-0.1.0 → stackresolve-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: stackresolve
-Version: 0.1.0
+Version: 0.2.0
 Summary: Official Python SDK for the StackResolve API (AgentReady + CompanyData).
 Project-URL: Homepage, https://stackresolve.dev
 Author: StackResolve

{stackresolve-0.1.0 → stackresolve-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "stackresolve"
-version = "0.1.0"
+version = "0.2.0"
 description = "Official Python SDK for the StackResolve API (AgentReady + CompanyData)."
 readme = "README.md"
 requires-python = ">=3.9"

{stackresolve-0.1.0 → stackresolve-0.2.0}/stackresolve/__init__.py

@@ -2,5 +2,5 @@
 
 from .client import StackResolve, StackResolveError
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"
 __all__ = ["StackResolve", "StackResolveError", "__version__"]

{stackresolve-0.1.0 → stackresolve-0.2.0}/stackresolve/client.py

@@ -41,6 +41,11 @@ class StackResolve:
         base_url: Base URL override. Falls back to STACKRESOLVE_BASE_URL,
             then https://api.stackresolve.dev .
         timeout: Per-request timeout in seconds (default 60).
+        integration: Identifies the caller in the User-Agent, e.g.
+            "langchain-stackresolve/0.1.0". Framework adapters set this so a call
+            through an adapter is distinguishable from a raw SDK call. Without it
+            every caller looks identical to the API and we cannot tell which
+            distribution surface is working.
     """
 
     def __init__(
@@ -48,15 +53,31 @@ class StackResolve:
         api_key: Optional[str] = None,
         base_url: Optional[str] = None,
         timeout: float = 60.0,
+        integration: Optional[str] = None,
     ) -> None:
         self.api_key = api_key or os.environ.get("STACKRESOLVE_API_KEY")
         base = base_url or os.environ.get("STACKRESOLVE_BASE_URL") or DEFAULT_BASE_URL
         self.base_url = base.rstrip("/")
-        headers = {"accept": "application/json"}
+        self.integration = integration or os.environ.get("STACKRESOLVE_INTEGRATION")
+        headers = {"accept": "application/json", "user-agent": self._user_agent()}
         if self.api_key:
             headers["x-api-key"] = self.api_key
         self._client = httpx.Client(base_url=self.base_url, headers=headers, timeout=timeout)
 
+    def _user_agent(self) -> str:
+        """Identify the SDK, and the adapter on top of it when there is one."""
+        from . import __version__
+
+        ua = f"stackresolve-python/{__version__}"
+        # Keep it to the printable subset a header allows; a label is a package
+        # name, never user input, but the SDK should not be the thing that
+        # produces an invalid header.
+        if self.integration:
+            safe = "".join(c for c in self.integration if c.isprintable() and c not in '\r\n')[:80]
+            if safe:
+                ua += f" ({safe})"
+        return ua
+
     # ---- context manager + cleanup ----
 
     def close(self) -> None:

stackresolve-0.1.0/.gitignore

@@ -1,10 +0,0 @@
-node_modules/
-.next/
-.env*
-!.env.example
-.DS_Store
-*.log
-/.claude/worktrees/
-
-# prior-work semantic vector cache (machine-local)
-.claude/cache/