universal-mcp-applications 0.1.3__tar.gz → 0.1.39rc12__tar.gz

universal_mcp_applications-0.1.39rc12/.gitignore

@@ -0,0 +1,62 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Environment variables
+.env
+.env.local
+
+
+dump/
+
+
+# SQLite database
+*.db
+*.sqlite
+*.sqlite3
+*.db-shm
+*.db-wal
+
+
+# Pyright
+.pyright
+
+# Ruff
+.ruff_cache
+
+# Pytest
+.pytest_cache
+
+
+# Local config
+local_config.json
+
+
+# Test Artifacts
+test_artifacts/
+src/universal_mcp/applications/complex/
+src/universal_mcp/applications/test/
+src/universal_mcp/applications/test_with_docs/
+src/universal_mcp/applications/test_without_docs/
+
+# Temporary files
+tmp/
+
+
+# Docs
+site/
+.cache/
+
+# langgraph temporary files
+.langgraph_api/
+langgraph.json
+agentr-1-6c4ebd5cc914.json
+
+.DS_Store

universal_mcp_applications-0.1.39rc12/GEMINI.md

@@ -0,0 +1,125 @@
+# Agent.md — Python + uv
+
+Purpose
+- This repository uses Python managed by uv for dependency resolution, virtual environments, locking, and execution. Always prefer uv subcommands (add/remove/run/sync/export) over raw pip/venv commands.
+
+Core rules
+- Use `uv add` to add or upgrade dependencies so that both `pyproject.toml` and `uv.lock` stay in sync; do not use `pip install` directly.
+- Keep runtime dependencies in `[project.dependencies]` and development-only tools in the `dev` group via `uv add --dev ...`.
+- Use `uv run` to execute Python, test, and tooling commands without manually activating a virtual environment.
+
+Project bootstrap
+- New project (scaffold files): `uv init`
+- First install or clean install: `uv sync`
+- Run the app: `uv run python -m <your_module>` or `uv run main.py`
+- REPL: `uv run python`
+- Scripts in pyproject: prefer `uv run <command>` to ensure the correct environment is used
+
+Managing dependencies
+- Add runtime dependency: `uv add <name>` (e.g., `uv add httpx`)
+- Add dev dependencies: `uv add --dev pytest ruff`
+- Pin/upgrade by constraint: `uv add "httpx>=0.27"` or adjust `pyproject.toml` and then `uv sync`
+- Remove dependency: `uv remove <name>`
+- Export lock for external tooling: `uv export --format requirements-txt --output-file requirements.txt`
+
+Locking and environments
+- `uv run` and `uv sync` will ensure the environment matches `pyproject.toml` and `uv.lock`
+- Avoid manual `pip install` or manual `venv` activation; let uv manage the environment
+- Commit `uv.lock` to version control for reproducible installs
+
+pyproject guidance
+- Dependencies live under `[project]` → `dependencies = [...]`
+- Development-only tooling should go under a dev group (e.g., `uv add --dev ruff pytest`) for clean separation
+- Keep `requires-python` current (e.g., `>=3.12`) to match the team’s baseline
+
+Usage in this repo
+- When adding libraries or changing versions, propose `uv add ...` changes that update both `pyproject.toml` and `uv.lock`, then run `uv run pytest -q` to validate
+- Prefer minimal diffs, explain the plan, apply changes, and run tests/tooling via `uv run`
+- If build/test fails, inspect error context, adjust constraints or code, and re-run via `uv run`
+
+Common commands (copy/paste)
+- Initialize: `uv init`  |  Install deps: `uv sync`
+- Add runtime: `uv add <pkg>`  |  Add dev: `uv add --dev <pkg>`
+- Remove: `uv remove <pkg>`
+- Run app: `uv run python -m <your_module>` or `uv run main.py`
+- Tests: `uv run pytest -q`
+- Lint/format: `uv run ruff check .` and/or `uv run ruff format .`
+- Export: `uv export --format requirements-txt --output-file requirements.txt`
+
+Of course. Based on your request and the example `app.py` you provided, here is a new section that you can append to your `gemini.md` file. This section provides clear guidance on how to write effective tool names and descriptions, using the Perplexity `chat` function as a concrete example.
+
+The proposed changes will make the function's purpose much clearer, especially its ability to access and cite real-time web information, which is a key feature.
+
+***
+
+### Tool Function Naming and Descriptions
+
+To ensure the AI agent can effectively understand and use the tools available, function names and their descriptions (docstrings) must be clear, descriptive, and accurate. A good description outlines the tool's purpose, its key capabilities, and what it returns.
+
+**Core Principles:**
+- **Use Action-Oriented Names:** Function names should be verbs that clearly state what the tool *does* (e.g., `search`, `create_file`, `list_users`).
+- **Be Specific in Descriptions:** The docstring is the primary source of context for the AI. It should explicitly mention the service it interacts with (e.g., "Perplexity AI") and its unique features (e.g., "performs real-time web searches," "provides citations").
+- **Detail Inputs and Outputs:** Clearly describe the purpose of each argument and what the function returns, as this helps the agent formulate correct calls.
+
+**Example: Improving the Perplexity Tool**
+
+Let's refine the tool in `app.py` to be more descriptive and unlock its full potential. The original `chat` function is too generic. We will rename it to `search` and significantly improve its docstring.
+
+**BEFORE:** The original function name and description are too simple.
+
+```python
+# from app.py
+def chat(
+    self,
+    query: str,
+    model: Literal[...] = "sonar",
+    temperature: float = 1,
+    system_prompt: str = "Be precise and concise.",
+) -> dict[str, Any] | str:
+    """
+    Initiates a chat completion request to generate AI responses using various models with customizable parameters.
+    ...
+    Tags:
+        chat, generate, ai, completion, important
+    """
+```
+
+**AFTER:** The updated name and description are highly specific, highlighting the core web search and citation capabilities. Do not leave any empty lines between the descriptions.
+
+```python
+# from app.py
+def search(
+    self,
+    query: str,
+    model: Literal[
+        "r1-1776",
+        "sonar",
+        "sonar-pro",
+        "sonar-reasoning",
+        "sonar-reasoning-pro",
+        "sonar-deep-research",
+    ] = "sonar-pro",
+    temperature: float = 1,
+    system_prompt: str = "You are a helpful AI assistant that answers questions using real-time information from the web.",
+) -> dict[str, Any] | str:
+    """
+    Performs a real-time web search using Perplexity AI to answer a query with up-to-date information and citations.
+    This tool is ideal for questions about current events, facts, or any topic that requires access to the latest information from the internet. It returns a natural language answer along with the sources used.
+
+    Args:
+        query: The search query or question to ask. For example: "What are the latest developments in AI regulation?"
+        model: The Perplexity model to use. 'sonar-pro' is recommended for comprehensive, up-to-date answers.
+        temperature: Controls randomness in the model's output. Higher values make the output more random, lower values make it more deterministic. Defaults to 1.
+        system_prompt: The initial system message to guide the model's behavior.
+
+    Returns:
+        A dictionary containing the generated 'content' (str) and a list of 'citations' (list) from the web search.
+
+    Raises:
+        AuthenticationError: Raised when API authentication fails due to missing or invalid credentials.
+        HTTPError: Raised when the API request fails or returns an error status.
+
+    Tags:
+        search, web, research, citations, current events, important
+    """
+```

{universal_mcp_applications-0.1.3 → universal_mcp_applications-0.1.39rc12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: universal-mcp-applications
-Version: 0.1.3
+Version: 0.1.39rc12
 Summary: A Universal MCP Application: universal_mcp_applications
 Project-URL: Homepage, https://github.com/universal-mcp/applications
 Project-URL: Repository, https://github.com/universal-mcp/applications
@@ -13,18 +13,21 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
 Requires-Python: >=3.11
 Requires-Dist: boto3>=1.38.32
+Requires-Dist: browser-use-sdk>=2.0.4
 Requires-Dist: dnspython>=2.4.0
 Requires-Dist: e2b-code-interpreter>=1.2.1
 Requires-Dist: elevenlabs>=2.14.0
+Requires-Dist: exa-py>=2.0.1
 Requires-Dist: fal-client>=0.5.9
 Requires-Dist: firecrawl-py>=3.0.3
 Requires-Dist: google-genai>=1.33.0
 Requires-Dist: google-search-results>=2.4.2
 Requires-Dist: gql[all]>=3.5.2
 Requires-Dist: httpx-aiohttp>=0.1.8
-Requires-Dist: markitdown[all]>=0.1.1
+Requires-Dist: markitdown[audio-transcription,az-doc-intel,docx,outlook,pdf,pptx,xls,xlsx]>=0.1.3
 Requires-Dist: office365-rest-python-client>=2.6.2
 Requires-Dist: openai>=1.75.0
+Requires-Dist: perplexityai>=0.22.0
 Requires-Dist: pyairtable>=3.1.1
 Requires-Dist: pytest-asyncio>=1.1.0
 Requires-Dist: pytest>=8.3.5
@@ -34,7 +37,9 @@ Requires-Dist: replicate>=1.0.6
 Requires-Dist: requests>=2.31.0
 Requires-Dist: resend>=2.10.0
 Requires-Dist: twilio>=9.8.0
-Requires-Dist: universal-mcp>=0.1.24rc17
+Requires-Dist: universal-mcp>=0.1.25rc2
+Requires-Dist: yfinance>=0.2.66
+Requires-Dist: youtube-transcript-api==1.2.2
 Provides-Extra: dev
 Requires-Dist: pre-commit; extra == 'dev'
 Requires-Dist: ruff; extra == 'dev'
@@ -84,91 +89,4 @@ result = app.some_method(param1="value1")
 
 # Process and print the output
 process_output(result)
-```
-
-## Included Applications
-
-This package includes the following 82 applications:
-
-- `ahrefs`
-- `airtable`
-- `apollo`
-- `asana`
-- `aws-s3`
-- `bill`
-- `box`
-- `braze`
-- `cal-com-v2`
-- `calendly`
-- `canva`
-- `clickup`
-- `coda`
-- `confluence`
-- `contentful`
-- `crustdata`
-- `dialpad`
-- `digitalocean`
-- `domain-checker`
-- `e2b`
-- `elevenlabs`
-- `exa`
-- `falai`
-- `figma`
-- `firecrawl`
-- `fireflies`
-- `fpl`
-- `ghost-content`
-- `github`
-- `gong`
-- `google-ads`
-- `google-calendar`
-- `google-docs`
-- `google-drive`
-- `google-gemini`
-- `google-mail`
-- `google-searchconsole`
-- `google-sheet`
-- `hashnode`
-- `heygen`
-- `http-tools`
-- `hubspot`
-- `jira`
-- `klaviyo`
-- `linkedin`
-- `mailchimp`
-- `markitdown`
-- `miro`
-- `ms-teams`
-- `neon`
-- `notion`
-- `openai`
-- `outlook`
-- `perplexity`
-- `pipedrive`
-- `posthog`
-- `reddit`
-- `replicate`
-- `resend`
-- `retell`
-- `rocketlane`
-- `semanticscholar`
-- `semrush`
-- `sendgrid`
-- `sentry`
-- `serpapi`
-- `sharepoint`
-- `shopify`
-- `shortcut`
-- `slack`
-- `spotify`
-- `supabase`
-- `tavily`
-- `trello`
-- `twillo`
-- `twitter`
-- `unipile`
-- `whatsapp`
-- `whatsapp-business`
-- `wrike`
-- `youtube`
-- `zenquotes`
+```

{universal_mcp_applications-0.1.3 → universal_mcp_applications-0.1.39rc12}/README.md

@@ -39,91 +39,4 @@ result = app.some_method(param1="value1")
 
 # Process and print the output
 process_output(result)
-```
-
-## Included Applications
-
-This package includes the following 82 applications:
-
-- `ahrefs`
-- `airtable`
-- `apollo`
-- `asana`
-- `aws-s3`
-- `bill`
-- `box`
-- `braze`
-- `cal-com-v2`
-- `calendly`
-- `canva`
-- `clickup`
-- `coda`
-- `confluence`
-- `contentful`
-- `crustdata`
-- `dialpad`
-- `digitalocean`
-- `domain-checker`
-- `e2b`
-- `elevenlabs`
-- `exa`
-- `falai`
-- `figma`
-- `firecrawl`
-- `fireflies`
-- `fpl`
-- `ghost-content`
-- `github`
-- `gong`
-- `google-ads`
-- `google-calendar`
-- `google-docs`
-- `google-drive`
-- `google-gemini`
-- `google-mail`
-- `google-searchconsole`
-- `google-sheet`
-- `hashnode`
-- `heygen`
-- `http-tools`
-- `hubspot`
-- `jira`
-- `klaviyo`
-- `linkedin`
-- `mailchimp`
-- `markitdown`
-- `miro`
-- `ms-teams`
-- `neon`
-- `notion`
-- `openai`
-- `outlook`
-- `perplexity`
-- `pipedrive`
-- `posthog`
-- `reddit`
-- `replicate`
-- `resend`
-- `retell`
-- `rocketlane`
-- `semanticscholar`
-- `semrush`
-- `sendgrid`
-- `sentry`
-- `serpapi`
-- `sharepoint`
-- `shopify`
-- `shortcut`
-- `slack`
-- `spotify`
-- `supabase`
-- `tavily`
-- `trello`
-- `twillo`
-- `twitter`
-- `unipile`
-- `whatsapp`
-- `whatsapp-business`
-- `wrike`
-- `youtube`
-- `zenquotes`
+```

{universal_mcp_applications-0.1.3 → universal_mcp_applications-0.1.39rc12}/bump_and_release.sh

@@ -5,7 +5,7 @@ set -x
 
 # Ensure dependencies are installed
 echo "Syncing dependencies..."
-uv sync
+uv sync --all-extras
 
 # Run tests with pytest
 echo "Running tests with pytest..."
@@ -25,7 +25,7 @@ IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT_VERSION"
 # Remove any rc suffix from PATCH if it exists
 PATCH_NUM=$(echo $PATCH | sed 's/-rc[0-9]*//')
 
-if [ "$BRANCH" = "master" ]; then
+if [ "$BRANCH" = "master" ] || [ "$BRANCH" = "main" ]; then
     # On main branch - bump patch version
     if [[ $PATCH == *"-rc"* ]]; then
         NEW_VERSION="$MAJOR.$MINOR.$PATCH_NUM"
@@ -55,7 +55,7 @@ sed -i '' "s/^version = ".*"/version = \"$NEW_VERSION\"/" pyproject.toml
 echo "Version bumped from $CURRENT_VERSION to $NEW_VERSION"
 
 # Stage the changed file
-git add pyproject.toml
+git add pyproject.toml uv.lock
 
 # Commit the change
 git commit -m "bump: version $CURRENT_VERSION → $NEW_VERSION"
@@ -81,13 +81,12 @@ if [ "$1" = "release" ]; then
     rm -rf .pytest_cache
     rm -rf .ruff_cache
     rm -rf .mypy_cache
-    rm -rf .venv
     rm -rf .cache
     rm -rf .DS_Store
     rm -rf .idea
     rm -rf .vscode
 
-    uv sync && uv build && uv publish
+    uv build && uv publish
     echo "Release complete!"
 else
     echo "Skipping release steps"

{universal_mcp_applications-0.1.3 → universal_mcp_applications-0.1.39rc12}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "universal-mcp-applications"
-version = "0.1.3"
+version = "0.1.39-rc12"
 description = "A Universal MCP Application: universal_mcp_applications"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -21,18 +21,21 @@ classifiers = [
 ]
 dependencies = [
     "boto3>=1.38.32",
+    "browser-use-sdk>=2.0.4",
     "dnspython>=2.4.0",
     "e2b-code-interpreter>=1.2.1",
     "elevenlabs>=2.14.0",
+    "exa-py>=2.0.1",
     "fal-client>=0.5.9",
     "firecrawl-py>=3.0.3",
     "google-genai>=1.33.0",
     "google-search-results>=2.4.2",
     "gql[all]>=3.5.2",
     "httpx-aiohttp>=0.1.8",
-    "markitdown[all]>=0.1.1",
+    "markitdown[audio-transcription,az-doc-intel,docx,outlook,pdf,pptx,xls,xlsx]>=0.1.3",
     "office365-rest-python-client>=2.6.2",
     "openai>=1.75.0",
+    "perplexityai>=0.22.0",
     "pyairtable>=3.1.1",
     "pytest-asyncio>=1.1.0",
     "pytest>=8.3.5",
@@ -42,7 +45,9 @@ dependencies = [
     "requests>=2.31.0",
     "resend>=2.10.0",
     "twilio>=9.8.0",
-    "universal-mcp >= 0.1.24rc17",
+    "universal-mcp>=0.1.25rc2",
+    "yfinance>=0.2.66",
+    "youtube-transcript-api==1.2.2",
 ]
 
 [project.license]
@@ -74,7 +79,6 @@ test-cov = "pytest --cov-report term-missing --cov-config=pyproject.toml --cov=s
 lint = "ruff check . && ruff format --check ."
 format = "ruff format ."
 
-
 [tool.hatch.build.targets.wheel]
 packages = [
     "src/universal_mcp",
@@ -82,7 +86,7 @@ packages = [
 
 [tool.coverage.run]
 source = [
-    "src",   
+    "src",
 ]
 branch = true
 
@@ -91,12 +95,11 @@ show_missing = true
 fail_under = 70
 
 [tool.ruff]
-line-length = 88
-select = [
+line-length = 140
+lint.select = [
     "E", "W", "F", "I", "UP", "PL", "T20",
 ]
-ignore = []
-
+lint.ignore = []
 
 [tool.ruff.format]
 quote-style = "double"
@@ -105,3 +108,9 @@ quote-style = "double"
 pythonpath = [
     "src",
 ]
+
+[dependency-groups]
+dev = [
+    "litellm>=1.77.3",
+    "universal-mcp-agents>=0.1.13",
+]