agentbridge-sdk 0.1.0__tar.gz

agentbridge_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: agentbridge-sdk
+Version: 0.1.0
+Requires-Python: >=3.9
+Requires-Dist: requests>=2.20.0
+Dynamic: requires-dist
+Dynamic: requires-python

agentbridge_sdk-0.1.0/README.md

@@ -0,0 +1,126 @@
+# AgentBridge Python SDK
+
+Official Python SDK for the AgentBridge API. Execute tools across connected providers (GitHub, Slack, Notion, Gmail, Google Drive) with a single API key.
+
+## Installation
+
+```bash
+pip install agentbridge-sdk
+```
+
+## Quick Start
+
+```python
+from agentbridge import AgentBridge
+
+client = AgentBridge(
+    api_key="ab_your_api_key_here",
+    base_url="http://localhost:3000",  # optional
+)
+
+result = client.execute(provider="github", tool="list_repos")
+print(result["data"])
+```
+
+## Configuration
+
+| Parameter  | Type | Required | Default                 | Description            |
+| ---------- | ---- | -------- | ----------------------- | ---------------------- |
+| `api_key`  | str  | Yes      | —                       | Your AgentBridge API key |
+| `base_url` | str  | No       | `http://localhost:3000` | API base URL           |
+
+## Methods
+
+### `execute(provider, tool, params=None)`
+
+Execute a tool on a connected provider.
+
+```python
+result = client.execute(
+    provider="github",
+    tool="create_issue",
+    params={
+        "owner": "octocat",
+        "repo": "hello-world",
+        "title": "Bug report",
+        "body": "Something is broken",
+    },
+)
+```
+
+**Parameters:**
+
+| Argument   | Type          | Required | Description                  |
+| ---------- | ------------- | -------- | ---------------------------- |
+| `provider` | str           | Yes      | Provider slug (e.g. `github`, `slack`, `notion`) |
+| `tool`     | str           | Yes      | Tool name (e.g. `list_repos`, `create_issue`)    |
+| `params`   | dict or None  | No       | Tool-specific parameters     |
+
+**Returns:** `{"status": "success", "data": ...}`
+
+### `get_providers()`
+
+List all active providers.
+
+```python
+providers = client.get_providers()
+# [{"id": "...", "name": "GitHub", "slug": "github", "active": True}, ...]
+```
+
+### `get_provider_tools(slug)`
+
+List available tools for a provider.
+
+```python
+tools = client.get_provider_tools("github")
+# [{"name": "list_repos", "description": "...", "parameters": {...}}, ...]
+```
+
+## Error Handling
+
+The SDK raises `requests.exceptions.HTTPError` for failed requests:
+
+```python
+from requests.exceptions import HTTPError
+
+try:
+    result = client.execute(provider="github", tool="list_repos")
+except HTTPError as e:
+    print(f"Request failed: {e.response.status_code} - {e.response.text}")
+```
+
+## Available Providers & Tools
+
+### GitHub
+
+| Tool           | Description                          | Parameters                                  |
+| -------------- | ------------------------------------ | ------------------------------------------- |
+| `list_repos`   | List authenticated user repositories | —                                           |
+| `create_issue` | Create a GitHub issue                | `owner`, `repo`, `title`, `body`(optional)  |
+| `create_pr`    | Create a pull request                | `owner`, `repo`, `title`, `head`, `base`, `body`(optional) |
+| `get_file`     | Get file contents from a repository  | `owner`, `repo`, `path`                     |
+
+### Slack
+
+Use `get_provider_tools("slack")` to list available tools.
+
+### Notion
+
+Use `get_provider_tools("notion")` to list available tools.
+
+### Gmail
+
+Use `get_provider_tools("gmail")` to list available tools.
+
+### Google Drive
+
+Use `get_provider_tools("google-drive")` to list available tools.
+
+## Requirements
+
+- Python >= 3.9
+- requests >= 2.20.0
+
+## License
+
+MIT

agentbridge_sdk-0.1.0/agentbridge/__init__.py

@@ -0,0 +1,3 @@
+from .client import AgentBridge
+
+__all__ = ["AgentBridge"]

agentbridge_sdk-0.1.0/agentbridge/client.py

@@ -0,0 +1,48 @@
+from __future__ import annotations
+
+from typing import Any
+from urllib.parse import quote
+
+import requests
+
+
+class AgentBridge:
+    """Python SDK for AgentBridge API."""
+
+    def __init__(self, api_key: str, base_url: str = "http://localhost:3000") -> None:
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self._session = requests.Session()
+        self._session.headers.update(
+            {
+                "Authorization": f"Bearer {self.api_key}",
+                "Content-Type": "application/json",
+            }
+        )
+
+    def _request(self, method: str, path: str, json: dict | None = None) -> Any:
+        url = f"{self.base_url}/api/mcp{path}"
+        resp = self._session.request(method, url, json=json)
+        resp.raise_for_status()
+        return resp.json()
+
+    def execute(
+        self,
+        provider: str,
+        tool: str,
+        params: dict[str, Any] | None = None,
+    ) -> dict[str, Any]:
+        """Execute a tool on a provider."""
+        return self._request(
+            "POST",
+            "/execute",
+            json={"provider": provider, "tool": tool, "params": params or {}},
+        )
+
+    def get_providers(self) -> list[dict[str, Any]]:
+        """List all active providers."""
+        return self._request("GET", "/providers")
+
+    def get_provider_tools(self, slug: str) -> list[dict[str, Any]]:
+        """List tools for a provider."""
+        return self._request("GET", f"/providers/{quote(slug, safe='')}/tools")

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

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: agentbridge-sdk
+Version: 0.1.0
+Requires-Python: >=3.9
+Requires-Dist: requests>=2.20.0
+Dynamic: requires-dist
+Dynamic: requires-python

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

@@ -0,0 +1,9 @@
+README.md
+setup.py
+agentbridge/__init__.py
+agentbridge/client.py
+agentbridge_sdk.egg-info/PKG-INFO
+agentbridge_sdk.egg-info/SOURCES.txt
+agentbridge_sdk.egg-info/dependency_links.txt
+agentbridge_sdk.egg-info/requires.txt
+agentbridge_sdk.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+requests>=2.20.0

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

@@ -0,0 +1 @@
+agentbridge

agentbridge_sdk-0.1.0/setup.cfg

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

agentbridge_sdk-0.1.0/setup.py

@@ -0,0 +1,9 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="agentbridge-sdk",
+    version="0.1.0",
+    packages=find_packages(),
+    install_requires=["requests>=2.20.0"],
+    python_requires=">=3.9",
+)