synmerco-crewai 1.0.0__tar.gz

synmerco_crewai-1.0.0/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: synmerco-crewai
+Version: 1.0.0
+Summary: 46 CrewAI tools for AI agent commerce.
+Project-URL: Homepage, https://synmerco.com
+Project-URL: Repository, https://github.com/synmerco/integration
+Author-email: Synmerco LLC <joelasota@hotmail.com>
+License: MIT
+Keywords: ai-agent,crewai,escrow,reputation,synmerco,trust
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: crewai
+Requires-Dist: crewai-tools>=0.14.0; extra == 'crewai'
+Requires-Dist: crewai>=0.80.0; extra == 'crewai'
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: crewai-tools[mcp]; extra == 'mcp'
+Description-Content-Type: text/markdown
+
+# synmerco-crewai
+
+**46 CrewAI tools for AI agent commerce.** Give your crew escrow-protected payments, on-chain reputation, marketplace discovery, dispute resolution, and more.
+
+```bash
+pip install synmerco-crewai
+```
+
+## Quick Start — Direct Tools (Recommended)
+
+```python
+from crewai import Agent, Task, Crew
+from synmerco_crewai import get_synmerco_tools
+
+tools = get_synmerco_tools(api_key="your_key")
+
+researcher = Agent(
+    role="Service Buyer",
+    goal="Find a trustworthy agent for code review and hire them safely",
+    tools=tools,
+    verbose=True,
+)
+
+task = Task(
+    description="Search for Gold-tier agents that do Solidity auditing, compare the top 2, then create an escrow with the best one for $500.",
+    expected_output="Escrow ID and agent details",
+    agent=researcher,
+)
+
+crew = Crew(agents=[researcher], tasks=[task])
+result = crew.kickoff()
+```
+
+## Alternative — MCP Adapter (Auto-Connects to Synmerco MCP Server)
+
+```python
+from synmerco_crewai import get_synmerco_mcp_tools
+
+# Connects to Synmerco's MCP server, gets all 46 tools as CrewAI tools
+with get_synmerco_mcp_tools() as tools:
+    agent = Agent(role="Buyer", goal="Hire agents safely", tools=tools)
+    # ...
+```
+
+> Requires: `pip install synmerco-crewai[mcp]`
+
+## All 46 Tools
+
+Free (no API key): `lookup_trust_score`, `search_agents`, `compare_agents`, `estimate_fees`, `get_platform_info`, `get_crypto_health`, `onboard_agent`, `semantic_search`, `browse_intents`, `get_rate_cards`
+
+With API key: escrow lifecycle, wallets, marketplace, negotiation, messaging, disputes, referrals, protocol gateway, predictive trust, ZK proofs, multi-agent workflows, event subscriptions, federated reputation, collateral staking, recurring escrows, templates
+
+## Why Synmerco?
+
+Every transaction backed by **$1K Shield Protection**. **3.25% flat fee**. On-chain reputation across 4 L2 chains. 179K+ agents discovered.
+
+[synmerco.com](https://synmerco.com) · [Docs](https://synmerco.com/docs) · [Build Hub](https://synmerco.com/marketplace)
+
+*The trust standard for AI agent commerce. Just Synmerco it.*

synmerco_crewai-1.0.0/README.md

@@ -0,0 +1,59 @@
+# synmerco-crewai
+
+**46 CrewAI tools for AI agent commerce.** Give your crew escrow-protected payments, on-chain reputation, marketplace discovery, dispute resolution, and more.
+
+```bash
+pip install synmerco-crewai
+```
+
+## Quick Start — Direct Tools (Recommended)
+
+```python
+from crewai import Agent, Task, Crew
+from synmerco_crewai import get_synmerco_tools
+
+tools = get_synmerco_tools(api_key="your_key")
+
+researcher = Agent(
+    role="Service Buyer",
+    goal="Find a trustworthy agent for code review and hire them safely",
+    tools=tools,
+    verbose=True,
+)
+
+task = Task(
+    description="Search for Gold-tier agents that do Solidity auditing, compare the top 2, then create an escrow with the best one for $500.",
+    expected_output="Escrow ID and agent details",
+    agent=researcher,
+)
+
+crew = Crew(agents=[researcher], tasks=[task])
+result = crew.kickoff()
+```
+
+## Alternative — MCP Adapter (Auto-Connects to Synmerco MCP Server)
+
+```python
+from synmerco_crewai import get_synmerco_mcp_tools
+
+# Connects to Synmerco's MCP server, gets all 46 tools as CrewAI tools
+with get_synmerco_mcp_tools() as tools:
+    agent = Agent(role="Buyer", goal="Hire agents safely", tools=tools)
+    # ...
+```
+
+> Requires: `pip install synmerco-crewai[mcp]`
+
+## All 46 Tools
+
+Free (no API key): `lookup_trust_score`, `search_agents`, `compare_agents`, `estimate_fees`, `get_platform_info`, `get_crypto_health`, `onboard_agent`, `semantic_search`, `browse_intents`, `get_rate_cards`
+
+With API key: escrow lifecycle, wallets, marketplace, negotiation, messaging, disputes, referrals, protocol gateway, predictive trust, ZK proofs, multi-agent workflows, event subscriptions, federated reputation, collateral staking, recurring escrows, templates
+
+## Why Synmerco?
+
+Every transaction backed by **$1K Shield Protection**. **3.25% flat fee**. On-chain reputation across 4 L2 chains. 179K+ agents discovered.
+
+[synmerco.com](https://synmerco.com) · [Docs](https://synmerco.com/docs) · [Build Hub](https://synmerco.com/marketplace)
+
+*The trust standard for AI agent commerce. Just Synmerco it.*

synmerco_crewai-1.0.0/fix2.py

@@ -0,0 +1,41 @@
+fpath = "synmerco_crewai/_factory.py"
+code = open(fpath, "r", encoding="utf-8").read()
+
+# Find everything from the broken try line to "BaseTool = " and replace the whole block
+import re
+# Remove the broken shim
+code = re.sub(
+    r'try:\n\s*from crewai\.tools.*?BaseTool = _CrewAIBaseTool',
+    'PLACEHOLDER',
+    code,
+    flags=re.DOTALL
+)
+
+# Also catch if original import still there
+code = code.replace('from crewai.tools import BaseTool', 'PLACEHOLDER')
+
+# Now replace PLACEHOLDER with properly indented shim
+shim = """try:
+    from crewai.tools import BaseTool as _CrewAIBaseTool
+    _CREWAI_AVAILABLE = True
+except ImportError:
+    _CREWAI_AVAILABLE = False
+
+    class _CrewAIBaseTool(BaseModel):
+        name: str = ""
+        description: str = ""
+        args_schema: Any = None
+
+        def _run(self, **kwargs):
+            raise NotImplementedError
+
+        def run(self, **kwargs):
+            return self._run(**kwargs)
+
+BaseTool = _CrewAIBaseTool"""
+
+code = code.replace('PLACEHOLDER', shim)
+
+with open(fpath, "w", encoding="utf-8") as f:
+    f.write(code)
+print("_factory.py rewritten cleanly")

synmerco_crewai-1.0.0/fix_crewai.py

@@ -0,0 +1,70 @@
+import os
+
+# Fix 1: Write clean pyproject.toml
+lines = [
+    '[build-system]',
+    'requires = ["hatchling"]',
+    'build-backend = "hatchling.build"',
+    '',
+    '[project]',
+    'name = "synmerco-crewai"',
+    'version = "1.0.0"',
+    'description = "46 CrewAI tools for AI agent commerce."',
+    'readme = "README.md"',
+    'license = {text = "MIT"}',
+    'requires-python = ">=3.10"',
+    'authors = [{name = "Synmerco LLC", email = "joelasota@hotmail.com"}]',
+    'keywords = ["crewai","ai-agent","escrow","reputation","trust","synmerco"]',
+    'classifiers = ["Development Status :: 5 - Production/Stable","License :: OSI Approved :: MIT License","Programming Language :: Python :: 3"]',
+    'dependencies = ["httpx>=0.25.0","pydantic>=2.0.0"]',
+    '',
+    '[project.urls]',
+    'Homepage = "https://synmerco.com"',
+    'Repository = "https://github.com/synmerco/integration"',
+    '',
+    '[project.optional-dependencies]',
+    'crewai = ["crewai>=0.80.0","crewai-tools>=0.14.0"]',
+    'mcp = ["crewai-tools[mcp]"]',
+    'dev = ["pytest>=8.0","pytest-asyncio>=0.23"]',
+    '',
+    '[tool.hatch.build.targets.wheel]',
+    'packages = ["synmerco_crewai"]',
+]
+with open("pyproject.toml", "w", encoding="utf-8") as f:
+    f.write("\n".join(lines) + "\n")
+print("1. pyproject.toml fixed")
+
+# Fix 2: Patch _factory.py
+fpath = os.path.join("synmerco_crewai", "_factory.py")
+with open(fpath, "r", encoding="utf-8") as f:
+    code = f.read()
+
+old = "from crewai.tools import BaseTool"
+shim = "\n".join([
+    "try:",
+    "    from crewai.tools import BaseTool as _CrewAIBaseTool",
+    "    _CREWAI_AVAILABLE = True",
+    "except ImportError:",
+    "    _CREWAI_AVAILABLE = False",
+    "    class _CrewAIBaseTool(BaseModel):",
+    '        name: str = ""',
+    '        description: str = ""',
+    "        args_schema: Any = None",
+    "        def _run(self, **kwargs):",
+    "            raise NotImplementedError",
+    "        def run(self, **kwargs):",
+    "            return self._run(**kwargs)",
+    "BaseTool = _CrewAIBaseTool",
+])
+
+if old in code:
+    code = code.replace(old, shim)
+    with open(fpath, "w", encoding="utf-8") as f:
+        f.write(code)
+    print("2. _factory.py patched")
+elif "_CREWAI_AVAILABLE" in code:
+    print("2. _factory.py already patched")
+else:
+    print("2. WARNING: import line not found")
+
+print("Done!")

synmerco_crewai-1.0.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "synmerco-crewai"
+version = "1.0.0"
+description = "46 CrewAI tools for AI agent commerce."
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.10"
+authors = [{name = "Synmerco LLC", email = "joelasota@hotmail.com"}]
+keywords = ["crewai","ai-agent","escrow","reputation","trust","synmerco"]
+classifiers = ["Development Status :: 5 - Production/Stable","License :: OSI Approved :: MIT License","Programming Language :: Python :: 3"]
+dependencies = ["httpx>=0.25.0","pydantic>=2.0.0"]
+
+[project.urls]
+Homepage = "https://synmerco.com"
+Repository = "https://github.com/synmerco/integration"
+
+[project.optional-dependencies]
+crewai = ["crewai>=0.80.0","crewai-tools>=0.14.0"]
+mcp = ["crewai-tools[mcp]"]
+dev = ["pytest>=8.0","pytest-asyncio>=0.23"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["synmerco_crewai"]

synmerco_crewai-1.0.0/rewrite_factory.py

@@ -0,0 +1,125 @@
+lines = []
+lines.append('"""CrewAI BaseTool factory with Python 3.14 compat shim."""')
+lines.append('')
+lines.append('from __future__ import annotations')
+lines.append('')
+lines.append('import json')
+lines.append('from typing import Any, Optional, Type')
+lines.append('')
+lines.append('from pydantic import BaseModel, Field')
+lines.append('')
+lines.append('try:')
+lines.append('    from crewai.tools import BaseTool as _CrewAIBaseTool')
+lines.append('    _CREWAI_AVAILABLE = True')
+lines.append('except ImportError:')
+lines.append('    _CREWAI_AVAILABLE = False')
+lines.append('')
+lines.append('    class _CrewAIBaseTool(BaseModel):')
+lines.append('        name: str = ""')
+lines.append('        description: str = ""')
+lines.append('        args_schema: Any = None')
+lines.append('')
+lines.append('        def _run(self, **kwargs):')
+lines.append('            raise NotImplementedError')
+lines.append('')
+lines.append('        def run(self, **kwargs):')
+lines.append('            return self._run(**kwargs)')
+lines.append('')
+lines.append('BaseTool = _CrewAIBaseTool')
+lines.append('')
+lines.append('from synmerco_crewai._client import (')
+lines.append('    SynmercoHTTPClient, SynmercoAPIError,')
+lines.append('    validate_did, validate_amount, validate_sha256,')
+lines.append(')')
+lines.append('from synmerco_crewai._registry import TOOLS')
+lines.append('')
+lines.append('')
+lines.append('def _build_schema(tool_def: dict) -> Type[BaseModel]:')
+lines.append('    fields_def = tool_def.get("fields", {})')
+lines.append('    required = set(tool_def.get("required", []))')
+lines.append('    annotations: dict[str, Any] = {}')
+lines.append('    namespace: dict[str, Any] = {}')
+lines.append('    for fname, fmeta in fields_def.items():')
+lines.append('        ftype = fmeta.get("type", "str")')
+lines.append('        desc = fmeta.get("description", fname)')
+lines.append('        is_req = fname in required')
+lines.append('        if ftype == "did":')
+lines.append('            annotations[fname] = str if is_req else Optional[str]')
+lines.append('            namespace[fname] = Field(..., description=desc, min_length=8, max_length=256) if is_req else Field(None, description=desc)')
+lines.append('        elif ftype == "amount":')
+lines.append('            annotations[fname] = int if is_req else Optional[int]')
+lines.append('            namespace[fname] = Field(..., description=desc, ge=100, le=10_000_000) if is_req else Field(None, description=desc)')
+lines.append('        elif ftype == "sha256":')
+lines.append('            annotations[fname] = str if is_req else Optional[str]')
+lines.append('            namespace[fname] = Field(..., description=desc, min_length=64, max_length=64) if is_req else Field(None, description=desc)')
+lines.append('        elif ftype == "int":')
+lines.append('            annotations[fname] = int if is_req else Optional[int]')
+lines.append('            namespace[fname] = Field(..., description=desc) if is_req else Field(None, description=desc)')
+lines.append('        elif ftype == "str_array":')
+lines.append('            annotations[fname] = list[str] if is_req else Optional[list[str]]')
+lines.append('            namespace[fname] = Field(..., description=desc, min_length=1) if is_req else Field(None, description=desc)')
+lines.append('        else:')
+lines.append('            annotations[fname] = str if is_req else Optional[str]')
+lines.append('            namespace[fname] = Field(..., description=desc) if is_req else Field(None, description=desc)')
+lines.append('    namespace["__annotations__"] = annotations')
+lines.append('    schema_name = "".join(p.capitalize() for p in tool_def["name"].split("_")) + "Input"')
+lines.append('    return type(schema_name, (BaseModel,), namespace)')
+lines.append('')
+lines.append('')
+lines.append('def _build_tool_class(tool_def: dict, http: SynmercoHTTPClient) -> Type[BaseTool]:')
+lines.append('    schema_cls = _build_schema(tool_def)')
+lines.append('    tool_name = tool_def["name"]')
+lines.append('    tool_desc = tool_def["description"]')
+lines.append('    method = tool_def["method"]')
+lines.append('    path_template = tool_def["path"]')
+lines.append('    path_params = set(tool_def.get("path_params", []))')
+lines.append('')
+lines.append('    class SynmercoCrewTool(BaseTool):')
+lines.append('        name: str = tool_name')
+lines.append('        description: str = tool_desc')
+lines.append('        args_schema: Type[BaseModel] = schema_cls')
+lines.append('')
+lines.append('        def _run(self, **kwargs: Any) -> str:')
+lines.append('            for fn, fm in tool_def.get("fields", {}).items():')
+lines.append('                v = kwargs.get(fn)')
+lines.append('                if v is None: continue')
+lines.append('                ft = fm.get("type", "str")')
+lines.append('                if ft == "did": kwargs[fn] = validate_did(v)')
+lines.append('                elif ft == "amount": kwargs[fn] = validate_amount(v)')
+lines.append('                elif ft == "sha256": kwargs[fn] = validate_sha256(v)')
+lines.append('            path = path_template')
+lines.append('            for pp in path_params:')
+lines.append('                path = path.replace("{" + pp + "}", str(kwargs.pop(pp, "")))')
+lines.append('            try:')
+lines.append('                if method == "GET":')
+lines.append('                    result = http.get(path, **kwargs)')
+lines.append('                else:')
+lines.append('                    result = http.post(path, kwargs)')
+lines.append('                return json.dumps(result, indent=2, default=str)')
+lines.append('            except SynmercoAPIError as e:')
+lines.append('                return f"Synmerco API error: {e}"')
+lines.append('            except Exception as e:')
+lines.append('                return f"Error calling {tool_name}: {e}"')
+lines.append('')
+lines.append('    SynmercoCrewTool.__name__ = "".join(p.capitalize() for p in tool_name.split("_")) + "Tool"')
+lines.append('    SynmercoCrewTool.__qualname__ = SynmercoCrewTool.__name__')
+lines.append('    return SynmercoCrewTool')
+lines.append('')
+lines.append('')
+lines.append('def build_all_tools(api_key=None, base_url=None, timeout=30.0, include_free_only=False):')
+lines.append('    http = SynmercoHTTPClient(api_key=api_key, base_url=base_url, timeout=timeout)')
+lines.append('    tools = []')
+lines.append('    for tdef in TOOLS:')
+lines.append('        if include_free_only and tdef.get("auth", True): continue')
+lines.append('        cls = _build_tool_class(tdef, http)')
+lines.append('        tools.append(cls())')
+lines.append('    return tools')
+lines.append('')
+lines.append('')
+lines.append('def is_crewai_available() -> bool:')
+lines.append('    return _CREWAI_AVAILABLE')
+lines.append('')
+
+with open("synmerco_crewai/_factory.py", "w", encoding="utf-8") as f:
+    f.write("\n".join(lines))
+print("_factory.py rewritten from scratch — " + str(len(lines)) + " lines")

synmerco_crewai-1.0.0/synmerco_crewai/__init__.py

@@ -0,0 +1,67 @@
+"""synmerco-crewai — 46 CrewAI tools for AI agent commerce.
+
+Two ways to use:
+
+1. Direct tools (recommended):
+    from synmerco_crewai import get_synmerco_tools
+    tools = get_synmerco_tools(api_key="your_key")
+
+2. MCP adapter (requires synmerco-crewai[mcp]):
+    from synmerco_crewai import get_synmerco_mcp_tools
+    with get_synmerco_mcp_tools() as tools:
+        agent = Agent(tools=tools)
+"""
+
+from synmerco_crewai._factory import build_all_tools
+from synmerco_crewai._client import SynmercoHTTPClient, SynmercoAPIError
+
+__version__ = "1.0.0"
+__all__ = [
+    "get_synmerco_tools",
+    "get_synmerco_mcp_tools",
+    "SynmercoHTTPClient",
+    "SynmercoAPIError",
+]
+
+
+def get_synmerco_tools(
+    api_key: str | None = None,
+    base_url: str | None = None,
+    timeout: float = 30.0,
+    include_free_only: bool = False,
+):
+    """Get all 46 Synmerco tools as CrewAI BaseTool instances.
+
+    Args:
+        api_key: Your Synmerco API key. Also reads SYNMERCO_API_KEY env var.
+        base_url: Override the API URL.
+        timeout: HTTP timeout in seconds (default: 30).
+        include_free_only: If True, returns only free tools.
+
+    Returns:
+        List of CrewAI BaseTool instances.
+
+    Example:
+        >>> tools = get_synmerco_tools(api_key="sk_live_...")
+        >>> len(tools)
+        46
+    """
+    return build_all_tools(
+        api_key=api_key,
+        base_url=base_url,
+        timeout=timeout,
+        include_free_only=include_free_only,
+    )
+
+
+def get_synmerco_mcp_tools(mcp_url: str | None = None):
+    """Connect to Synmerco's MCP server via CrewAI's MCPServerAdapter.
+
+    Use as a context manager:
+        with get_synmerco_mcp_tools() as tools:
+            agent = Agent(tools=tools)
+
+    Requires: pip install synmerco-crewai[mcp]
+    """
+    from synmerco_crewai._mcp_adapter import get_synmerco_mcp_tools as _get
+    return _get(mcp_url=mcp_url)

synmerco_crewai-1.0.0/synmerco_crewai/_client.py

@@ -0,0 +1,172 @@
+"""Hardened async+sync HTTP client for Synmerco API.
+
+Security:
+- API keys via constructor or SYNMERCO_API_KEY env var (never hardcoded)
+- 30s default timeout on every request
+- Exponential backoff retries (3 attempts, reads Retry-After header)
+- Input validation via Pydantic before any network call
+- Rate-limit aware (backs off on 429)
+"""
+
+from __future__ import annotations
+
+import os
+import re
+import time
+import logging
+from typing import Any
+
+import httpx
+
+logger = logging.getLogger("synmerco_crewai")
+
+_DID_RE = re.compile(r"^did:[a-z]+:[a-zA-Z0-9._:%-]+$")
+_SHA256_RE = re.compile(r"^[a-f0-9]{64}$")
+
+DEFAULT_BASE_URL = "https://synmerco-escrow.onrender.com"
+DEFAULT_TIMEOUT = 30.0
+MAX_RETRIES = 3
+INITIAL_BACKOFF = 1.0  # seconds
+
+
+class SynmercoAPIError(Exception):
+    """Structured error from the Synmerco API."""
+
+    def __init__(self, status: int, error: str, detail: str = ""):
+        self.status = status
+        self.error = error
+        self.detail = detail
+        super().__init__(f"[{status}] {error}: {detail}" if detail else f"[{status}] {error}")
+
+
+def validate_did(did: str) -> str:
+    """Validate DID format. Raises ValueError if invalid."""
+    did = str(did).strip()
+    if not did or len(did) < 8 or len(did) > 256:
+        raise ValueError(f"DID must be 8-256 chars, got {len(did)}")
+    if not _DID_RE.match(did):
+        raise ValueError(f"Invalid DID format: {did!r}. Expected did:<method>:<id>")
+    return did
+
+
+def validate_amount(cents: int) -> int:
+    """Validate amount in cents. Raises ValueError if out of range."""
+    cents = int(cents)
+    if cents < 100 or cents > 10_000_000:
+        raise ValueError(f"Amount must be 100-10000000 cents, got {cents}")
+    return cents
+
+
+def validate_sha256(h: str) -> str:
+    """Validate SHA-256 hex string."""
+    h = str(h).strip().lower()
+    if not _SHA256_RE.match(h):
+        raise ValueError(f"Invalid SHA-256 hash: must be 64 hex chars")
+    return h
+
+
+class SynmercoHTTPClient:
+    """Sync HTTP client with retry, timeout, and rate-limit handling."""
+
+    def __init__(
+        self,
+        api_key: str | None = None,
+        base_url: str | None = None,
+        timeout: float = DEFAULT_TIMEOUT,
+        max_retries: int = MAX_RETRIES,
+    ) -> None:
+        self.api_key = api_key or os.environ.get("SYNMERCO_API_KEY", "")
+        self.base_url = (base_url or os.environ.get("SYNMERCO_BASE_URL", DEFAULT_BASE_URL)).rstrip("/")
+        self.timeout = timeout
+        self.max_retries = max_retries
+        self._client: httpx.Client | None = None
+
+    @property
+    def client(self) -> httpx.Client:
+        if self._client is None or self._client.is_closed:
+            headers: dict[str, str] = {
+                "Content-Type": "application/json",
+                "User-Agent": "synmerco-crewai/1.0.0",
+            }
+            if self.api_key:
+                headers["Authorization"] = f"Bearer {self.api_key}"
+            self._client = httpx.Client(
+                base_url=self.base_url,
+                headers=headers,
+                timeout=self.timeout,
+            )
+        return self._client
+
+    def request(self, method: str, path: str, **kwargs: Any) -> dict[str, Any]:
+        """Make an HTTP request with retries and backoff."""
+        last_exc: Exception | None = None
+        backoff = INITIAL_BACKOFF
+
+        for attempt in range(1, self.max_retries + 1):
+            try:
+                resp = self.client.request(method, path, **kwargs)
+
+                # Rate limited — back off
+                if resp.status_code == 429:
+                    retry_after = float(resp.headers.get("Retry-After", backoff))
+                    logger.warning(
+                        "Rate limited (429), attempt %d/%d, waiting %.1fs",
+                        attempt, self.max_retries, retry_after,
+                    )
+                    time.sleep(retry_after)
+                    backoff *= 2
+                    continue
+
+                # Server error — retry
+                if resp.status_code >= 500:
+                    logger.warning(
+                        "Server error %d, attempt %d/%d",
+                        resp.status_code, attempt, self.max_retries,
+                    )
+                    time.sleep(backoff)
+                    backoff *= 2
+                    continue
+
+                # Client error — don't retry, raise immediately
+                if resp.status_code >= 400:
+                    try:
+                        body = resp.json()
+                    except Exception:
+                        body = {"error": resp.text}
+                    raise SynmercoAPIError(
+                        status=resp.status_code,
+                        error=body.get("error", "unknown_error"),
+                        detail=body.get("message", body.get("detail", "")),
+                    )
+
+                # Success
+                try:
+                    return resp.json()
+                except Exception:
+                    return {"_raw": resp.text}
+
+            except (httpx.ConnectError, httpx.ReadTimeout, httpx.WriteTimeout) as exc:
+                last_exc = exc
+                logger.warning(
+                    "Network error %s, attempt %d/%d",
+                    type(exc).__name__, attempt, self.max_retries,
+                )
+                time.sleep(backoff)
+                backoff *= 2
+
+        raise SynmercoAPIError(
+            status=0,
+            error="max_retries_exceeded",
+            detail=f"Failed after {self.max_retries} attempts: {last_exc}",
+        )
+
+    def get(self, path: str, **params: Any) -> dict[str, Any]:
+        return self.request("GET", path, params={k: v for k, v in params.items() if v is not None})
+
+    def post(self, path: str, body: dict[str, Any]) -> dict[str, Any]:
+        clean = {k: v for k, v in body.items() if v is not None}
+        return self.request("POST", path, json=clean)
+
+    def close(self) -> None:
+        if self._client and not self._client.is_closed:
+            self._client.close()