fere-sdk 0.3.0.dev23__tar.gz → 0.3.0.dev25__tar.gz

fere_sdk-0.3.0.dev25/.gitignore

@@ -0,0 +1,52 @@
+*.log
+*.pyc
+__pycache__
+
+# Devcontainer local env (contains secrets)
+.devcontainer/.env.local
+.devcontainer/.env.local.override
+.devcontainer/.env.gitpod
+
+# Bruno gateway collection (GATEWAY_AGENT_ID / GATEWAY_PRIVATE_KEY_B64)
+bruno_specs/gateway-service/.env
+
+# Git worktrees
+.worktrees/
+
+# tmp/ — keep .gitkeep, ignore all else
+tmp/*
+!tmp/.gitkeep
+coverage.xml
+
+# triage-rum session state (contains stack traces / error data)
+.claude/skills/triage-rum/triage-session.json
+
+# Claude Code per-session scheduler lock (local runtime state)
+.claude/scheduled_tasks.lock
+
+# Ralph/autonomous loop runtime logs
+dev/logs/*
+!dev/logs/.gitignore
+
+# VSCode per-user IDE settings
+.vscode/settings.json
+
+# Poetry local venv preference (in-project .venv) — dev-only, per-service
+**/poetry.toml
+
+# Cursor SEO skill — regenerated report JSON (not source)
+.cursor/skills/seo-agent/artifacts/
+
+# Skills installed locally by the skills package manager (see skills-lock.json)
+.claude/skills/stripe-best-practices
+.claude/skills/stripe-projects
+.claude/skills/upgrade-stripe
+.agents/
+
+# Local GEO upstream reference (optional clone; not part of the product tree)
+geo-seo/
+
+# Eval output
+compare_results.json
+.secrets
+wallet_service/celerybeat-schedule-*

{fere_sdk-0.3.0.dev23 → fere_sdk-0.3.0.dev25}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fere-sdk
-Version: 0.3.0.dev23
+Version: 0.3.0.dev25
 Summary: Python SDK for the FereAI Gateway API
 Author-email: Fere AI <info@fere.ai>
 License-Expression: MIT

{fere_sdk-0.3.0.dev23 → fere_sdk-0.3.0.dev25}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fere-sdk"
-version = "0.3.0.dev23"
+version = "0.3.0.dev25"
 description = "Python SDK for the FereAI Gateway API"
 readme = "README.md"
 requires-python = ">=3.10"

{fere_sdk-0.3.0.dev23 → fere_sdk-0.3.0.dev25}/src/fere_sdk/auth.py

@@ -162,3 +162,20 @@ class AuthManager:
         """Invalidate the cached token to force a refresh."""
         self._token = None
         self._token_expires_at = 0
+
+
+class StaticTokenAuthManager:
+    """Auth provider for callers that already have a bearer token."""
+
+    def __init__(self, token: str) -> None:
+        self._token = token.removeprefix("Bearer ").strip()
+
+    async def ensure_token(self, client: httpx.AsyncClient) -> str:
+        return self._token
+
+    def auth_headers(self) -> dict[str, str]:
+        return {"Authorization": f"Bearer {self._token}"}
+
+    def clear_token(self) -> None:
+        """Static tokens cannot be refreshed by the SDK."""
+        return None

{fere_sdk-0.3.0.dev23 → fere_sdk-0.3.0.dev25}/src/fere_sdk/client.py

@@ -29,6 +29,27 @@ from .models import (
 DEFAULT_TIMEOUT = 120
 
 
+class ToolsClient:
+    """Convenience namespace for tool discovery and invocation."""
+
+    def __init__(self, api: FereAPI) -> None:
+        self._api = api
+
+    async def list(self, category: str | None = None) -> dict:
+        return await self._api.list_tools(category=category)
+
+    async def describe(self, name: str) -> dict:
+        return await self._api.describe_tool(name)
+
+    async def call(
+        self,
+        name: str,
+        args: dict[str, Any] | None = None,
+        chat_id: str | None = None,
+    ) -> dict:
+        return await self._api.call_tool(name, args=args, chat_id=chat_id)
+
+
 class FereClient:
     """High-level async client that blocks until tasks complete.
 
@@ -38,6 +59,7 @@ class FereClient:
 
     def __init__(self, api: FereAPI) -> None:
         self._api = api
+        self.tools = ToolsClient(api)
 
     @classmethod
     async def create(
@@ -59,6 +81,15 @@ class FereClient:
         await api.authenticate()
         return cls(api)
 
+    @classmethod
+    def from_token(
+        cls,
+        token: str,
+        base_url: str = "https://api.fereai.xyz",
+    ) -> FereClient:
+        """Create a client from an existing Clerk or AgentDoor bearer token."""
+        return cls(FereAPI.from_token(token, base_url=base_url))
+
     async def close(self) -> None:
         await self._api.close()
 

{fere_sdk-0.3.0.dev23 → fere_sdk-0.3.0.dev25}/src/fere_sdk/low_level.py

@@ -9,7 +9,7 @@ from typing import Any
 
 import httpx
 
-from .auth import AuthManager
+from .auth import AuthManager, StaticTokenAuthManager
 from .models import (
     ChatEvent,
     CreditsInfo,
@@ -43,17 +43,35 @@ class FereAPI:
 
     def __init__(
         self,
-        agent_name: str,
+        agent_name: str = "fere-sdk",
         base_url: str = DEFAULT_BASE_URL,
         key_path: str | None = None,
         timeout: int = 120,
+        bearer_token: str | None = None,
     ) -> None:
         self.base_url = base_url.rstrip("/")
-        self._auth = AuthManager(
-            agent_name, base_url=self.base_url, key_path=key_path
-        )
+        if bearer_token:
+            self._auth = StaticTokenAuthManager(bearer_token)
+        else:
+            self._auth = AuthManager(
+                agent_name, base_url=self.base_url, key_path=key_path
+            )
         self._client = httpx.AsyncClient(timeout=timeout)
 
+    @classmethod
+    def from_token(
+        cls,
+        token: str,
+        base_url: str = DEFAULT_BASE_URL,
+        timeout: int = 120,
+    ) -> FereAPI:
+        """Create a low-level client from an existing bearer token."""
+        return cls(
+            base_url=base_url,
+            timeout=timeout,
+            bearer_token=token,
+        )
+
     async def __aenter__(self):
         return self
 
@@ -195,6 +213,31 @@ class FereAPI:
         """GET /v1/chat/threads/{thread_id}"""
         return await self._authed_get(f"/v1/chat/threads/{thread_id}")
 
+    # ----------------------------------------------------------
+    # Tools
+    # ----------------------------------------------------------
+
+    async def list_tools(self, category: str | None = None) -> dict:
+        """GET /v1/tools"""
+        params = {"category": category} if category else None
+        return await self._authed_get("/v1/tools", params=params)
+
+    async def describe_tool(self, name: str) -> dict:
+        """GET /v1/tools/{name}"""
+        return await self._authed_get(f"/v1/tools/{name}")
+
+    async def call_tool(
+        self,
+        name: str,
+        args: dict[str, Any] | None = None,
+        chat_id: str | None = None,
+    ) -> dict:
+        """POST /v1/tools/{name}/invoke"""
+        return await self._authed_post(
+            f"/v1/tools/{name}/invoke",
+            {"args": args or {}, "chat_id": chat_id},
+        )
+
     # ----------------------------------------------------------
     # Trading
     # ----------------------------------------------------------

fere_sdk-0.3.0.dev23/.gitignore

@@ -1,21 +0,0 @@
-*.log
-*.pyc
-__pycache__
-
-# Devcontainer local env (contains secrets)
-.devcontainer/.env.local
-.devcontainer/.env.gitpod
-
-# Git worktrees
-.worktrees/
-
-# tmp/ — keep .gitkeep, ignore all else
-tmp/*
-!tmp/.gitkeep
-coverage.xml
-
-# triage-rum session state (contains stack traces / error data)
-.claude/skills/triage-rum/triage-session.json
-
-# Eval output
-compare_results.json