agentr 0.1.5__tar.gz → 0.1.7__tar.gz

{agentr-0.1.5 → agentr-0.1.7}/.gitignore

@@ -1,14 +1,14 @@
-# Python-generated files
-__pycache__/
-*.py[oc]
-build/
-dist/
-wheels/
-*.egg-info
-
-# Virtual environments
-.venv
-
-# Environment variables
-.env
-.env.local
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Environment variables
+.env
+.env.local

{agentr-0.1.5 → agentr-0.1.7}/.python-version

@@ -1 +1 @@
-3.13
+3.13

{agentr-0.1.5 → agentr-0.1.7}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 AgentR
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 AgentR
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{agentr-0.1.5 → agentr-0.1.7}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: agentr
-Version: 0.1.5
-Summary: AgentR is a Python framework for building MCP servers to serve agentic applications and LLM clients
+Version: 0.1.7
+Summary: A python framework to build MCP servers
 Author-email: Manoj Bajaj <manojbajaj95@gmail.com>
 License-File: LICENSE
 Requires-Python: >=3.11
@@ -9,6 +9,9 @@ Requires-Dist: loguru>=0.7.3
 Requires-Dist: mcp>=1.5.0
 Requires-Dist: pyyaml>=6.0.2
 Requires-Dist: typer>=0.15.2
+Provides-Extra: test
+Requires-Dist: pytest-asyncio>=0.26.0; extra == 'test'
+Requires-Dist: pytest>=8.3.5; extra == 'test'
 Description-Content-Type: text/markdown
 
 # AgentR

{agentr-0.1.5 → agentr-0.1.7}/README.md

@@ -1,147 +1,147 @@
-# AgentR
-
-AgentR is a Python framework for building MCP servers to serve agentic applications and LLM clients. It provides a clean abstraction for incorporating various API services as "applications" into your agent workflow.
-
-## 🌟 Features
-
-- **MCP (Model Context Protocol) Integration**: Seamlessly works with MCP server architecture
-- **Simplified API Integration**: Connect to services like GitHub, Google Calendar, Gmail, Reddit, Tavily, and more with minimal code
-- **Managed Authentication**: Built-in support for API keys and OAuth-based authentication flows
-- **Extensible Architecture**: Easily build and add new app integrations with minimal boilerplate
-- **Credential Management**: Flexible storage options for API credentials with memory and environment-based implementations
-
-## 🔧 Installation
-
-Install AgentR using pip:
-
-```bash
-pip install agentr
-```
-
-## 🚀 Quick Start
-
-### 1. Get an API Key
-Before using AgentR with services that require authorization (like GitHub, Gmail, etc.), you'll need an AgentR API key:
-
-Visit https://agentr.dev to create an account
-Generate an API key from your dashboard
-Set it as an environment variable or include it directly in your code:
-
-```bash
-export AGENTR_API_KEY="your_api_key_here"
-```
-
-### 2. Create a basic server
-
-```bash
-from agentr.server import TestServer
-
-# Define your applications list
-apps_list = [
-    {
-        "name": "tavily",
-        "integration": {
-            "name": "tavily_api_key",
-            "type": "api_key",
-            "store": {
-                "type": "environment",
-            }
-        },        
-    },
-    {
-        "name": "zenquotes",
-        "integration": None
-    },
-    {
-        "name": "github",
-        "integration": {
-            "name": "github",
-            "type": "agentr",
-        }
-    }
-]
-
-# Create a server with these applications
-server = TestServer(name="My Agent Server", description="A server for my agent apps", apps_list=apps_list)
-
-# Run the server
-if __name__ == "__main__":
-    server.run()
-```
-
-## 🧩 Available Applications
-AgentR comes with several pre-built applications:
-
-| Application | Description | Authentication Type |
-|-------------|-------------|---------------------|
-| GitHub | Star repositories and more | OAuth (AgentR) |
-| Google Calendar | Retrieve calendar events | OAuth (AgentR) |
-| Gmail | Send emails | OAuth (AgentR) |
-| Reddit | Access Reddit data | OAuth (AgentR) |
-| Resend | Send emails via Resend API | API Key |
-| Tavily | Web search capabilities | API Key |
-| ZenQuotes | Get inspirational quotes | None |
-
-> **Note**: More applications are coming soon! Stay tuned for updates to our application catalog.
-
-## 🔐 Integration Types
-AgentR supports two primary integration types:
-
-### 1. API Key Integration
-For services that authenticate via API keys:
-```python
-{
-    "name": "service_name",
-    "integration": {
-        "name": "service_api_key",
-        "type": "api_key",
-        "store": {
-            "type": "environment",  # or "memory"
-        }
-    }
-}
-```
-
-### 2. OAuth Integration (via AgentR)
-For services requiring OAuth flow:
-```python
-{
-    "name": "service_name",
-    "integration": {
-        "name": "service_name",
-        "type": "agentr"
-    }
-}
-```
-When using OAuth integrations, users will be directed to authenticate with the service provider through a secure flow managed by AgentR.
-
-## 🤖 CLI Usage
-AgentR includes a command-line interface for common operations:
-
-```bash
-# Get version information
-agentr version
-
-# Generate API client from OpenAPI schema
-agentr generate --schema path/to/openapi.yaml
-
-# Run the test server
-agentr run
-
-# Install AgentR for specific applications
-agentr install claude
-```
-
-## 📋 Requirements
-
-- Python 3.11+
-- Dependencies (automatically installed):
-  - loguru >= 0.7.3
-  - mcp >= 1.5.0
-  - pyyaml >= 6.0.2
-  - typer >= 0.15.2
-
-
-## 📝 License
-
-This project is licensed under the MIT License.
+# AgentR
+
+AgentR is a Python framework for building MCP servers to serve agentic applications and LLM clients. It provides a clean abstraction for incorporating various API services as "applications" into your agent workflow.
+
+## 🌟 Features
+
+- **MCP (Model Context Protocol) Integration**: Seamlessly works with MCP server architecture
+- **Simplified API Integration**: Connect to services like GitHub, Google Calendar, Gmail, Reddit, Tavily, and more with minimal code
+- **Managed Authentication**: Built-in support for API keys and OAuth-based authentication flows
+- **Extensible Architecture**: Easily build and add new app integrations with minimal boilerplate
+- **Credential Management**: Flexible storage options for API credentials with memory and environment-based implementations
+
+## 🔧 Installation
+
+Install AgentR using pip:
+
+```bash
+pip install agentr
+```
+
+## 🚀 Quick Start
+
+### 1. Get an API Key
+Before using AgentR with services that require authorization (like GitHub, Gmail, etc.), you'll need an AgentR API key:
+
+Visit https://agentr.dev to create an account
+Generate an API key from your dashboard
+Set it as an environment variable or include it directly in your code:
+
+```bash
+export AGENTR_API_KEY="your_api_key_here"
+```
+
+### 2. Create a basic server
+
+```bash
+from agentr.server import TestServer
+
+# Define your applications list
+apps_list = [
+    {
+        "name": "tavily",
+        "integration": {
+            "name": "tavily_api_key",
+            "type": "api_key",
+            "store": {
+                "type": "environment",
+            }
+        },        
+    },
+    {
+        "name": "zenquotes",
+        "integration": None
+    },
+    {
+        "name": "github",
+        "integration": {
+            "name": "github",
+            "type": "agentr",
+        }
+    }
+]
+
+# Create a server with these applications
+server = TestServer(name="My Agent Server", description="A server for my agent apps", apps_list=apps_list)
+
+# Run the server
+if __name__ == "__main__":
+    server.run()
+```
+
+## 🧩 Available Applications
+AgentR comes with several pre-built applications:
+
+| Application | Description | Authentication Type |
+|-------------|-------------|---------------------|
+| GitHub | Star repositories and more | OAuth (AgentR) |
+| Google Calendar | Retrieve calendar events | OAuth (AgentR) |
+| Gmail | Send emails | OAuth (AgentR) |
+| Reddit | Access Reddit data | OAuth (AgentR) |
+| Resend | Send emails via Resend API | API Key |
+| Tavily | Web search capabilities | API Key |
+| ZenQuotes | Get inspirational quotes | None |
+
+> **Note**: More applications are coming soon! Stay tuned for updates to our application catalog.
+
+## 🔐 Integration Types
+AgentR supports two primary integration types:
+
+### 1. API Key Integration
+For services that authenticate via API keys:
+```python
+{
+    "name": "service_name",
+    "integration": {
+        "name": "service_api_key",
+        "type": "api_key",
+        "store": {
+            "type": "environment",  # or "memory"
+        }
+    }
+}
+```
+
+### 2. OAuth Integration (via AgentR)
+For services requiring OAuth flow:
+```python
+{
+    "name": "service_name",
+    "integration": {
+        "name": "service_name",
+        "type": "agentr"
+    }
+}
+```
+When using OAuth integrations, users will be directed to authenticate with the service provider through a secure flow managed by AgentR.
+
+## 🤖 CLI Usage
+AgentR includes a command-line interface for common operations:
+
+```bash
+# Get version information
+agentr version
+
+# Generate API client from OpenAPI schema
+agentr generate --schema path/to/openapi.yaml
+
+# Run the test server
+agentr run
+
+# Install AgentR for specific applications
+agentr install claude
+```
+
+## 📋 Requirements
+
+- Python 3.11+
+- Dependencies (automatically installed):
+  - loguru >= 0.7.3
+  - mcp >= 1.5.0
+  - pyyaml >= 6.0.2
+  - typer >= 0.15.2
+
+
+## 📝 License
+
+This project is licensed under the MIT License.

{agentr-0.1.5 → agentr-0.1.7}/pyproject.toml

@@ -1,23 +1,29 @@
-[project]
-name = "agentr"
-version = "0.1.5"
-description = "AgentR is a Python framework for building MCP servers to serve agentic applications and LLM clients"
-readme = "README.md"
-authors = [
-    { name = "Manoj Bajaj", email = "manojbajaj95@gmail.com" }
-]
-requires-python = ">=3.11"
-dependencies = [
-    "loguru>=0.7.3",
-    "mcp>=1.5.0",
-    "pyyaml>=6.0.2",
-    "typer>=0.15.2",
-]
-
-[project.scripts]
-agentr = "agentr.cli:app"
-
-
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
+[project]
+name = "agentr"
+version = "0.1.7"
+description = "A python framework to build MCP servers"
+readme = "README.md"
+authors = [
+    { name = "Manoj Bajaj", email = "manojbajaj95@gmail.com" }
+]
+requires-python = ">=3.11"
+dependencies = [
+    "loguru>=0.7.3",
+    "mcp>=1.5.0",
+    "pyyaml>=6.0.2",
+    "typer>=0.15.2",
+]
+
+[project.optional-dependencies]
+test = [
+  "pytest>=8.3.5",
+  "pytest-asyncio>=0.26.0",
+]
+
+[project.scripts]
+agentr = "agentr.cli:app"
+
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

agentr-0.1.7/src/agentr/__init__.py

@@ -0,0 +1,2 @@
+def main():
+    print("hello")

agentr-0.1.7/src/agentr/application.py

@@ -0,0 +1,93 @@
+from abc import ABC, abstractmethod
+
+from loguru import logger
+from agentr.exceptions import NotAuthorizedError
+from agentr.integration import Integration
+import httpx
+
+class Application(ABC):
+    """
+    Application is collection of tools that can be used by an agent.
+    """
+    def __init__(self, name: str, **kwargs):
+        self.name = name
+
+    @abstractmethod
+    def list_tools(self):
+        pass
+
+
+class APIApplication(Application):
+    """
+    APIApplication is an application that uses an API to interact with the world.
+    """
+    def __init__(self, name: str, integration: Integration = None, **kwargs):
+        super().__init__(name, **kwargs)
+        self.integration = integration
+
+    def _get_headers(self):
+        return {}
+    
+    def _get(self, url, params=None):
+        try:
+            headers = self._get_headers()
+            response = httpx.get(url, headers=headers, params=params)
+            response.raise_for_status()
+            return response
+        except NotAuthorizedError as e:
+            logger.warning(f"Reddit authorization needed: {e.message}")
+            return e.message 
+        except Exception as e:
+            logger.error(f"Error getting {url}: {e}")
+            raise e
+
+    
+    def _post(self, url, data):
+        try:
+            headers = self._get_headers()
+            response = httpx.post(url, headers=headers, json=data)
+            response.raise_for_status()
+            return response
+        except NotAuthorizedError as e:
+            logger.warning(f"Reddit authorization needed: {e.message}")
+            return e.message 
+        except httpx.HTTPStatusError as e:
+            if e.response.status_code == 429:
+                return e.response.text or "Rate limit exceeded. Please try again later."
+            else:
+                raise e
+        except Exception as e:
+            logger.error(f"Error posting {url}: {e}")
+            raise e
+
+    def _put(self, url, data):
+        try:
+            headers = self._get_headers()
+            response = httpx.put(url, headers=headers, json=data)
+            response.raise_for_status()
+            return response
+        except NotAuthorizedError as e:
+            logger.warning(f"Reddit authorization needed: {e.message}")
+            return e.message 
+        except Exception as e:
+            logger.error(f"Error posting {url}: {e}")
+            raise e
+
+    def _delete(self, url):
+        try:
+            headers = self._get_headers()
+            response = httpx.delete(url, headers=headers)
+            response.raise_for_status()
+            return response
+        except NotAuthorizedError as e:
+            logger.warning(f"Reddit authorization needed: {e.message}")
+            return e.message 
+        except Exception as e:
+            logger.error(f"Error posting {url}: {e}")
+
+    def validate(self):
+        pass
+    
+    @abstractmethod
+    def list_tools(self):
+        pass

agentr-0.1.7/src/agentr/applications/__init__.py

@@ -0,0 +1,27 @@
+from agentr.applications.zenquotes.app import ZenQuoteApp
+from agentr.applications.tavily.app import TavilyApp
+from agentr.applications.github.app import GithubApp
+from agentr.applications.google_calendar.app import GoogleCalendarApp
+from agentr.applications.google_mail.app import GmailApp
+from agentr.applications.resend.app import ResendApp
+from agentr.applications.reddit.app import RedditApp
+
+def app_from_name(name: str):
+    name = name.lower().strip()
+    name = name.replace(" ", "-")
+    if name == "zenquotes":
+        return ZenQuoteApp
+    elif name == "tavily":
+        return TavilyApp
+    elif name == "github":
+        return GithubApp
+    elif name == "google-calendar":
+        return GoogleCalendarApp
+    elif name == "google-mail":
+        return GmailApp
+    elif name == "resend":
+        return ResendApp
+    elif name == "reddit":
+        return RedditApp
+    else:
+        raise ValueError(f"App {name} not found")