universal-mcp-agents 0.1.13__py3-none-any.whl → 0.1.15__py3-none-any.whl

universal_mcp/agents/utils.py

@@ -1,8 +1,13 @@
 import json
 from contextlib import contextmanager
+from http import HTTPStatus
 
+import httpx
+import requests
 from langchain_core.messages.base import BaseMessage
 from loguru import logger
+from pydantic import ValidationError
+from requests import JSONDecodeError
 from rich.console import Console
 from rich.live import Live
 from rich.markdown import Markdown
@@ -143,3 +148,69 @@ def get_message_text(message: BaseMessage):
         logger.error(f"Error getting message text: {e}")
         logger.error(f"Message: {message}")
         raise e
+
+
+def filter_retry_on(exc: Exception) -> bool:
+    # Transient local/network issues and parsing hiccups
+    if isinstance(
+        exc,
+        (
+            TimeoutError,
+            ConnectionError,
+            JSONDecodeError,
+            ValidationError,
+        ),
+    ):
+        return True
+
+    # httpx transient request-layer errors
+    if isinstance(
+        exc,
+        (
+            httpx.TimeoutException,
+            httpx.ConnectError,
+            httpx.ReadError,
+        ),
+    ):
+        return True
+
+    if isinstance(exc, (requests.Timeout, requests.ConnectionError)):
+        return True
+
+    # HTTP status based retries: 408 (timeout), 429 (rate limit), and 5xx
+    if isinstance(exc, httpx.HTTPStatusError):
+        status = exc.response.status_code
+        return (
+            status in {408, 429}
+            or HTTPStatus.INTERNAL_SERVER_ERROR.value <= status <= HTTPStatus.NETWORK_AUTHENTICATION_REQUIRED.value
+        )
+    if isinstance(exc, requests.HTTPError):
+        if exc.response is None:
+            return True
+        status = exc.response.status_code
+        return (
+            status in {408, 429}
+            or HTTPStatus.INTERNAL_SERVER_ERROR.value <= status <= HTTPStatus.NETWORK_AUTHENTICATION_REQUIRED.value
+        )
+
+    if isinstance(
+        exc,
+        (
+            ValueError,
+            TypeError,
+            ArithmeticError,
+            ImportError,
+            LookupError,
+            NameError,
+            SyntaxError,
+            RuntimeError,
+            ReferenceError,
+            StopIteration,
+            StopAsyncIteration,
+            OSError,
+        ),
+    ):
+        return False
+
+    # Default: do not retry unknown exceptions
+    return False

universal_mcp/applications/ui/app.py

@@ -1,10 +1,10 @@
 import os
 from typing import Any, Literal, TypedDict
 
-from dotenv import load_dotenv
 import httpx
-from universal_mcp.applications.application import BaseApplication
+from dotenv import load_dotenv
 from markitdown import MarkItDown
+from universal_mcp.applications.application import BaseApplication
 
 load_dotenv()
 

{universal_mcp_agents-0.1.13.dist-info → universal_mcp_agents-0.1.15.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: universal-mcp-agents
-Version: 0.1.13
+Version: 0.1.15
 Summary: Add your description here
 Project-URL: Homepage, https://github.com/universal-mcp/applications
 Project-URL: Repository, https://github.com/universal-mcp/applications
@@ -12,8 +12,8 @@ Requires-Dist: langchain-google-genai>=2.1.10
 Requires-Dist: langchain-openai>=0.3.32
 Requires-Dist: langgraph>=0.6.6
 Requires-Dist: typer>=0.17.4
-Requires-Dist: universal-mcp-applications>=0.1.14
-Requires-Dist: universal-mcp>=0.1.24rc21
+Requires-Dist: universal-mcp-applications>=0.1.24
+Requires-Dist: universal-mcp>=0.1.24rc25
 Provides-Extra: dev
 Requires-Dist: pre-commit; extra == 'dev'
 Requires-Dist: ruff; extra == 'dev'

universal_mcp_agents-0.1.15.dist-info/RECORD

@@ -0,0 +1,50 @@
+universal_mcp/agents/__init__.py,sha256=5aE4zVgem6ehzfRrt5QqE6gLi7949vySZAn_uFuaU7Q,1252
+universal_mcp/agents/base.py,sha256=GmagwWFJdPpp_yLeAfsrr4fu-zzxh7CgIlBJbTgFgWM,7072
+universal_mcp/agents/cli.py,sha256=AG9e4iSX3GazT537573YrYT1wSaZYOr42rrYQ7xP3YA,1016
+universal_mcp/agents/hil.py,sha256=_5PCK6q0goGm8qylJq44aSp2MadP-yCPvhOJYKqWLMo,3808
+universal_mcp/agents/llm.py,sha256=hVRwjZs3MHl5_3BWedmurs2Jt1oZDfFX0Zj9F8KH7fk,1787
+universal_mcp/agents/react.py,sha256=8XQvJ0HLVgc-K0qn9Ml48WGcgUGuIKtL67HatlT6Da0,3334
+universal_mcp/agents/simple.py,sha256=NSATg5TWzsRNS7V3LFiDG28WSOCIwCdcC1g7NRwg2nM,2095
+universal_mcp/agents/utils.py,sha256=lGeDam3Efcrxv6dve31LQonBtwkSpNmBuoNXap_TqaQ,7128
+universal_mcp/agents/bigtool/__init__.py,sha256=mZG8dsaCVyKlm82otxtiTA225GIFLUCUUYPEIPF24uw,2299
+universal_mcp/agents/bigtool/__main__.py,sha256=0i-fbd2yQ90qa8n2nM3luqoJVN9Reh5HZXR5oK7SAck,445
+universal_mcp/agents/bigtool/agent.py,sha256=mtCDNN8WjE2hjJjooDqusmbferKBHeJMHrhXUPUWaVc,252
+universal_mcp/agents/bigtool/context.py,sha256=ny7gd-vvVpUOYAeQbAEUT0A6Vm6Nn2qGywxTzPBzYFg,929
+universal_mcp/agents/bigtool/graph.py,sha256=2Sy0dtevTWeT3hJDq4BDerZFvk_zJqx15j8VH2XLq8Y,5848
+universal_mcp/agents/bigtool/prompts.py,sha256=Joi5mCzZX63aM_6eBrMOKuNRHjTkceVIibSsGBGqhYE,2041
+universal_mcp/agents/bigtool/state.py,sha256=TQeGZD99okclkoCh5oz-VYIlEsC9yLQyDpnBnm7QCN8,759
+universal_mcp/agents/bigtool/tools.py,sha256=-u80ta6xEaqzEMSzDVe3QZiTZm3YlgLkBD8WTghzClw,6315
+universal_mcp/agents/builder/__main__.py,sha256=VJDJOr-dJJerT53ibh5LVqIsMJ0m0sG2UlzFB784pKw,11680
+universal_mcp/agents/builder/builder.py,sha256=mh3MZpMVB1FE1DWzvMW9NnfiaF145VGn8cJzKSYUlzY,8587
+universal_mcp/agents/builder/helper.py,sha256=8igR1b3Gy_N2u3WxHYKIWzvw7F5BMnfpO2IU74v6vsw,2680
+universal_mcp/agents/builder/prompts.py,sha256=8Xs6uzTUHguDRngVMLak3lkXFkk2VV_uQXaDllzP5cI,4670
+universal_mcp/agents/builder/state.py,sha256=7DeWllxfN-yD6cd9wJ3KIgjO8TctkJvVjAbZT8W_zqk,922
+universal_mcp/agents/codeact/__init__.py,sha256=rLE8gvOo5H4YSr71DRq76b3RV3uuotxuAy_VnBVaVwk,60
+universal_mcp/agents/codeact/__main__.py,sha256=W2cHXRwH1dZG3ETIkMwUqA_d62K3IctHP-FDZWDjxdw,1067
+universal_mcp/agents/codeact/agent.py,sha256=sKZWokTHcuL68Y6SNyaaHe6_XkWxaIq36TrNmPJfQto,9762
+universal_mcp/agents/codeact/models.py,sha256=2fdAcF5bxWDpljjEwDEdPBflTMShSPwwncHrphRjsYg,222
+universal_mcp/agents/codeact/prompts.py,sha256=EMI-imnd0Ps0Bd2FOvSqgiicvvtFFu0MF9s93PiC_3k,4493
+universal_mcp/agents/codeact/sandbox.py,sha256=NjN6ISj8psFtHf8V0w24ChJdUMUWkq7OrlbHdzm4wBc,2299
+universal_mcp/agents/codeact/state.py,sha256=WTPfpxDlGRnlr5tZuXMg_KU7GS7TZbnrIKslOvZLbQI,565
+universal_mcp/agents/codeact/utils.py,sha256=JUbT_HYGS_D1BzmzoVpORIe7SGur1KgJguTZ_1tZ4JY,1918
+universal_mcp/agents/codeact0/__init__.py,sha256=ebKkpgg-0UnsvDtagEJ2tMer1VsfhmEE5KJcFzUk9fU,133
+universal_mcp/agents/codeact0/__main__.py,sha256=V2wLWW9ym3rtiSvPEs-N0Mki7G5dYHzV5dAsAoF-ygQ,1148
+universal_mcp/agents/codeact0/agent.py,sha256=9BInAQr3csES-XHSscmeJlYJ3-wQUHPvLOf-6wFILUU,6695
+universal_mcp/agents/codeact0/config.py,sha256=H-1woj_nhSDwf15F63WYn723y4qlRefXzGxuH81uYF0,2215
+universal_mcp/agents/codeact0/langgraph_agent.py,sha256=ehjMV_Z1118pCFWB_Sa5H7XnUp0udsbUHjfjXjhIQM8,435
+universal_mcp/agents/codeact0/llm_tool.py,sha256=I7QIlgZZbzBdxHuNUYODA28Z7xqWgYz5v5qWSWqB0rE,13781
+universal_mcp/agents/codeact0/playbook_agent.py,sha256=oj8zP-c8rObzjAlS-lkP-pl3xleIr0fCJ_ENtn-C_OM,17435
+universal_mcp/agents/codeact0/prompts.py,sha256=j8HxA3Rp-EZsms9qMBcRmFrUjeySrG1IWjqrNFXZZn8,9457
+universal_mcp/agents/codeact0/sandbox.py,sha256=zMgHrWnQYkSkJb2MzfXvT3euCc4hvqzBE_EbX2_iLxA,3142
+universal_mcp/agents/codeact0/state.py,sha256=Qcr1whST3J8v7w0opnKSfOG9u5gRtxAzPs2NFhaAhJE,1199
+universal_mcp/agents/codeact0/tools.py,sha256=emfBLA3eChQ5B1wirOWf5RWHMy3OIRDQYnN5h5OPqFk,7401
+universal_mcp/agents/codeact0/utils.py,sha256=s1SfVrC1_UePxYSIL9zt-cG0xhwzFPuViyLl2Xj-45c,15943
+universal_mcp/agents/shared/__main__.py,sha256=XxH5qGDpgFWfq7fwQfgKULXGiUgeTp_YKfcxftuVZq8,1452
+universal_mcp/agents/shared/prompts.py,sha256=yjP3zbbuKi87qCj21qwTTicz8TqtkKgnyGSeEjMu3ho,3761
+universal_mcp/agents/shared/tool_node.py,sha256=DC9F-Ri28Pam0u3sXWNODVgmj9PtAEUb5qP1qOoGgfs,9169
+universal_mcp/applications/llm/__init__.py,sha256=xnpxq4Wl_pevvwtSUtEwcty8_d61ywO1V2YnEXyCREY,46
+universal_mcp/applications/llm/app.py,sha256=iNLU6z2LRZc01GfSKvV0vNzT1LhKAjq_UrSJEmjthjw,6032
+universal_mcp/applications/ui/app.py,sha256=c7OkZsO2fRtndgAzAQbKu-1xXRuRp9Kjgml57YD2NR4,9459
+universal_mcp_agents-0.1.15.dist-info/METADATA,sha256=8FNfgWbbFHVStTqIwzHZzohMEvvD27IuPvIUWRjea80,878
+universal_mcp_agents-0.1.15.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+universal_mcp_agents-0.1.15.dist-info/RECORD,,

universal_mcp/agents/codeact0/usecases/1-unsubscribe.yaml

@@ -1,4 +0,0 @@
-base_prompt: 'Find and extract unsubscribe links from all emails in my inbox from the last 7 days. List all unsubscribe links found with the email subject and sender.'
-tools:
-- google_mail__list_messages
-- google_mail__get_message_details

universal_mcp/agents/codeact0/usecases/10-reddit2.yaml

@@ -1,10 +0,0 @@
-base_prompt: 'Process rows 2-5 from the Google Sheet (ID: 1nnnCp3_IWcdHv4UVgXtwYF5wedxbqF4RIeyjN6mCKD8). For each unprocessed row, extract Reddit post links, fetch post details and comments, analyze content relevance to AgentR/Wingmen products, classify into tiers 1-4, generate appropriate response drafts, and update the sheet with all findings.'
-tools:
-- google_sheet__add_table
-- google_sheet__append_values
-- google_sheet__update_values
-- reddit__get_post_comments_details
-- google_mail__list_messages
-- google_sheet__format_cells
-- google_sheet__get_spreadsheet_metadata
-- google_sheet__batch_get_values_by_range

universal_mcp/agents/codeact0/usecases/11-github.yaml

@@ -1,13 +0,0 @@
-base_prompt: 'Fetch all open issues from the GitHub repository "microsoft/vscode" and add them to a new Google Sheet. Then create corresponding tasks in ClickUp for each issue with descriptions, tags, and "In Progress" status. Delete processed rows from the sheet after creating ClickUp tasks.'
-tools:
-- google_sheet__get_values
-- clickup__tasks_create_new_task
-- clickup__spaces_get_details
-- clickup__lists_get_list_details
-- clickup__tasks_get_list_tasks
-- google_sheet__delete_dimensions
-- google_sheet__update_values
-- google_sheet__get_spreadsheet_metadata
-- google_sheet__batch_get_values_by_range
-- github__list_issues
-- github__update_issue

universal_mcp/agents/codeact0/usecases/2-reddit.yaml

@@ -1,27 +0,0 @@
-base_prompt: 'Goal: Process unprocessed rows in a fixed Google Sheet, scrape Reddit
-  for context, filter posts, and generate short, natural comments linking to AgentR/Wingmen
-  when relevant. Workflow: 1) Sheet & Row Selection: Fixed Sheet ID 1nnnCp3_IWcdHv4UVgXtwYF5wedxbqF4RIeyjN6mCKD8,
-  tab Posts. Process rows 2-5 (first 4 unprocessed rows) immediately without asking for user input. Only process rows with empty Match Type (Col
-  I) and no Tier 1-4 assigned. 2) Reddit Context Fetch: Extract Post Link & ID. Use reddit to fetch post upvotes + top comments (max 5). Ensure
-  post/comment is active, visible, and unlocked. 3) Filtration & Fit: Classify content
-  (developer, consumer, anecdotal). Apply GTM Filtration to skip irrelevant, negative,
-  political, or low-quality posts. Identify direct or adjacent fit to AgentR (Universal
-  MCP Server) or Wingmen. Decide platform + account type: Direct fit/competitor mention
-  → Technical Q = Team account, Non-technical = Burner account. Adjacent fit → Official
-  account. Decide reply target (original comment/post or parent post). 4) Comment
-  Generation: For Tier 1-3, craft a 2-3 line, context-aware, conversational reply.
-  Mention AgentR/Wingmen organically, avoid sales tone or forced CTAs. Use light imperfections
-  for human tone. Skip negative sentiment entirely. One comment per post. 5) Populate
-  Output: Fill Upvote Count, Match Type, Account Type, Response Draft, Respond on.
-  Return updated Google Sheet link. Tier Definitions: Tier 1 = Deep MCP, AI agent,
-  tool integrations, or architecture discussions where infra is highly relevant. Tier
-  2 = Specific workflows, automation tooling, or productivity systems where Wingmen
-  or MCP Server could be useful. Tier 3 = Broader ecosystem (LangChain/CrewAI/agent
-  tooling) where a soft recommendation adds value. Tier 4 = Unclear, generic, sarcastic,
-  hostile, or irrelevant mentions — skip. Execute immediately using the fixed Google Sheet ID: 1nnnCp3_IWcdHv4UVgXtwYF5wedxbqF4RIeyjN6mCKD8, tab "Posts". Process rows(first 4 unprocessed rows) without asking for user input. Only process rows where Match Type (Column I) is empty. For each row, extract the Post Link, fetch Reddit data, apply GTM filtration, generate appropriate responses, and update the sheet. Return the updated Google Sheet link when complete.'
-tools:
-- reddit__get_post_comments_details
-- google_sheet__update_values
-- google_sheet__get_values
-- google_sheet__get_spreadsheet_metadata
-- google_sheet__batch_get_values_by_range

universal_mcp/agents/codeact0/usecases/2.1-instructions.md

@@ -1,81 +0,0 @@
-# Goal: Reddit Engagement of Wingmen.app
-Process unprocessed rows in a fixed Google Sheet, scrape Reddit for context, filter posts, and generate short, natural comments linked to Wingmen.app when relevant. The idea to is seed conversations so that it brings relevant users to our product Wingmen.app.
-
-# Knowledge
-
-Wingmen.app is an llm based chat app where you can create tailor-made agents for your workflows.
-It is an MCP Client that has access to a large collection of tools. Some popular tool categories are:
-1) Google Suite: Gmail, Google Sheets, Docs, Calendar, Maps, etc.
-2) Microsoft Suite: Outlook, Excel, Teams, etc.
-3) Other productivity apps: Slack, Clickup, Notion, etc.
-4) Enterprise data providers: Apollo.io, Semrush, Ahref, etc.
-5) Web & search utilities: Exa, Perplexity, Domain Availability, Firecrawl etc.
-6) CRMs: Hubspot, etc.
-7) Developer Apps: Github, Jira, Linear, etc.
-
-The coolest USPs of Wingmen are:
-1) You can schedule workflows like everyday at 9am mail me a daily summary of news related to my stock portfolio
-2) Creating workflows is super easy – with a single prompt in natural language (useful for non-technical people)
-3) Can handle complex taks like find all .ai and .com domains available by combining (play, go, run) with (work, flow, automation)
-4) We also have workspaces for enterprise teams. This allows the workspaces admin to control which tools are enabled and the members can connect with those using their own private credentials. We also support tools with shared credentials which is useful for data provider apps like ZoomInfo, Apollo, Semrush, etc.
-
-# Workflow
-
-## Step 1
-Get all the unprocessed rows from the Google Sheet ID: 1_5Ao61LWZHo5QijHdXdRw0u9aj7JIoHtp4uBIBwi84U
-Each row contains details of a Reddit comment with content and post link.
-
-For each unprocessed row follow Step 2 to Step 5 to process it.
-If there are more than 20 unprocessed rows just process 20 rows.
-## Step 2
-Fetch the context of the comment.
-The context will contain details about the parent post and other top comments.
-
-## Step 3
-Decide the ideal place (post/comment id) to comment. This should be based on two factors: Relevance and Popularity. Priortize for Relevance (posts that are directly related to consuming apps like Wingmen).
-- High relevance themes:
-  - People asking for our USPs.
-  - Posts mentioning other MCP Client apps or General chat apps like ChatGPT, Claude Desktop, Langdock, etc.
-  - Posts mentioning our competitors like Usedash, Runable.com, or Manus
-  - Posts trying to consume MCP Servers.
-- Medium relevance themes:
-  - building apps like Wingmen, or building Agents in general.
-  - consuming MCP Servers, tool authentication etc. Could be mentioning Composio, Toolhouse, etc.
-  - Analysing MCP Protocol in general. Could be a comment around MCP Security, Tool sprawl etc.
-- If you could not find anything relevant then look for
-  - posts where people are genuinely asking for help; or
-  - posts where we can steer the conversation towards Wingmen.app. We can do it two steps by asking for suggestions for apps which have one of the USPs of Wingmen. And in the next step answering the question with a link to Wingmen.app
-- Otherwise, just pick the most popular comments (highest upvote). It is generally the parent post.
-- Note: If the thread is deleted or archived we should skip this row. We should also skip low quality posts.
-
-The final output of this step should be:
-- skip: bool
-- comment_id: str (Optional, should be empty when skip is true)
-- reasoning: str
-
-## Step 4
-Try to identify the theme using the reasoning of the previous step and the entire conversation. The theme buckets are:
-- Consuming apps/agents (here we can subtly promote Wingmen.app)
-  - Engagement Strategy: A happy Wingmen.app user sharing his positive experience in a specific usecase.
-- Building apps/agents (here we can bond with other builders)
-  - Engagement Strategy: A developer from Wingmen.app team sharing his insights or just bonding over the development challenges. 
-- Altruistic Help (here we are just resolving any genuine pain point which is not relevant to our product)
-  - Engagement Strategy: Helping the commentor in purely altruistic way. No need to talk about Wingmen.app.
-- Artifical Nudge (here we will steer the conversation towards Wingmen.app)
-  - Engagement Strategy: A typical consumer/developer plants a question so that the official team members can reply to this and highlight the USPs of Wingmen.app. The generated comment_content should be just the question.
-
-The final output of this step should be:
-- match_type: str (one of [consumer, builder, altruistic_help, artificial_nudge])
-- comment_content: str
-
-**Guidelines for generating comment content:**
-- craft a 2-3 line, context-aware, conversational reply.
-- when mentioning AgentR/Wingmen, avoid sales tone or forced CTAs. 
-- Use light imperfections for human tone.
-
-## Step 5
-
-Fill remaining columns (Skip, Comment ID, Reasoning, Match Type, Comment Content) for each row
-
-## Step 6
-After all the rows are processed just return the sheet link again in markdown format.

universal_mcp/agents/codeact0/usecases/2.2-instructions.md

@@ -1,71 +0,0 @@
-# Goal: Reddit Engagement of Wingmen.app
-Given a reddit comment, scrape Reddit for context, filter posts, and generate short, natural comments linked to Wingmen.app when relevant. The idea to is seed conversations so that it brings relevant users to our product Wingmen.app.
-
-# Knowledge
-
-Wingmen.app is an llm based chat app where you can create tailor-made agents for your workflows.
-It is an MCP Client that has access to a large collection of tools. Some popular tool categories are:
-1) Google Suite: Gmail, Google Sheets, Docs, Calendar, Maps, etc.
-2) Microsoft Suite: Outlook, Excel, Teams, etc.
-3) Other productivity apps: Slack, Clickup, Notion, etc.
-4) Enterprise data providers: Apollo.io, Semrush, Ahref, etc.
-5) Web & search utilities: Exa, Perplexity, Domain Availability, Firecrawl etc.
-6) CRMs: Hubspot, etc.
-7) Developer Apps: Github, Jira, Linear, etc.
-
-The coolest USPs of Wingmen are:
-1) You can schedule workflows like everyday at 9am mail me a daily summary of news related to my stock portfolio
-2) Creating workflows is super easy – with a single prompt in natural language (useful for non-technical people)
-3) Can handle complex taks like find all .ai and .com domains available by combining (play, go, run) with (work, flow, automation)
-4) We also have workspaces for enterprise teams. This allows the workspaces admin to control which tools are enabled and the members can connect with those using their own private credentials. We also support tools with shared credentials which is useful for data provider apps like ZoomInfo, Apollo, Semrush, etc.
-
-# Workflow
-
-## Input
-I will give you a reddit comment id.
-
-## Step 1
-Fetch the context of the comment.
-The context will contain details about the parent post and other top comments.
-
-## Step 2
-Decide the ideal place (post/comment id) to comment. This should be based on two factors: Relevance and Popularity. Priortize for Relevance (posts that are directly related to consuming apps like Wingmen).
-- High relevance themes:
-  - People asking for our USPs.
-  - Posts mentioning other MCP Client apps or General chat apps like ChatGPT, Claude Desktop, Langdock, etc.
-  - Posts mentioning our competitors like Usedash, Runable.com, or Manus
-  - Posts trying to consume MCP Servers.
-- Medium relevance themes:
-  - building apps like Wingmen, or building Agents in general.
-  - consuming MCP Servers, tool authentication etc. Could be mentioning Composio, Toolhouse, etc.
-  - Analysing MCP Protocol in general. Could be a comment around MCP Security, Tool sprawl etc.
-- If you could not find anything relevant then look for
-  - posts where people are genuinely asking for help; or
-  - posts where we can steer the conversation towards Wingmen.app. We can do it two steps by asking for suggestions for apps which have one of the USPs of Wingmen. And in the next step answering the question with a link to Wingmen.app
-- Otherwise, just pick the most popular comments (highest upvote). It is generally the parent post.
-- Note: If the thread is deleted or archived we should skip this row. We should also skip low quality posts.
-
-The final output of this step should be:
-- skip: bool
-- comment_id: str (Optional, should be empty when skip is true)
-- reasoning: str
-
-## Final step
-Try to identify the theme using the reasoning of the previous step and the entire conversation. The theme buckets are:
-- Consuming apps/agents (here we can subtly promote Wingmen.app)
-  - Engagement Strategy: A happy Wingmen.app user sharing his positive experience in a specific usecase.
-- Building apps/agents (here we can bond with other builders)
-  - Engagement Strategy: A developer from Wingmen.app team sharing his insights or just bonding over the development challenges. 
-- Pain Resolution (here we are just trying to be helpful)
-  - Engagement Strategy: Helping the commentor in purely altruistic way.
-- Artifical Nudge (here we will steer the conversation towards Wingmen.app)
-  - Engagement Strategy: A typical consumer/developer plants a question so that the official team members can comment and highlight the USPs of Wingmen.app.
-
-The final output of the workflow should be:
-- match_type: str (one of [consumer, builder, pain_resolver, artificial_nudge])
-- comment_content: str
-
-**Guidelines for generating comment content:**
-- craft a 2-3 line, context-aware, conversational reply.
-- when mentioning AgentR/Wingmen, avoid sales tone or forced CTAs. 
-- Use light imperfections for human tone.

universal_mcp/agents/codeact0/usecases/3-earnings.yaml

@@ -1,4 +0,0 @@
-base_prompt: 'Generate a financial flash report for Apple Inc. Research their latest earnings data including revenue, net income, EPS, and year-over-year changes. Create a formatted report with highlights, upcoming events, and summary. Present the report in chat and email it to adit@agentr.dev.'
-tools:
-- exa__answer
-- google_mail__send_email

universal_mcp/agents/codeact0/usecases/4-maps.yaml

@@ -1,41 +0,0 @@
-base_prompt: 'Objective: Find businesses from Google Maps for a given category & location,
-  store them in a Google Sheet, then process unprocessed leads to scrape emails and
-  sync with HubSpot CRM. Stage 1 - Lead Discovery Get coordinates of Area + City.
-  Search on Google Maps  with category & coordinates.
-  Extract: Name, Google Maps URL, Address, Phone, Website; leave Email & CRM Status
-  blank. Sheet: Name: {Area}, {City} Leads - {Category} - {dd-mmm} If exists → append
-  non-duplicate rows; else create in folder "Leads from Google Maps" (ID: 142QBejJX0jAqzDz_NHdwVTkcmagoog__).
-  Add headers: Name | Google Maps URL | Address | Phone | Website | Email | CRM Status.
-  Populate with businesses found. Edge Cases: No results → return message, skip sheet
-  creation. Missing data → leave blank. Stage 2 - Lead Processing & CRM Sync Locate
-  sheet in Google Drive, ensure headers match. Parse category from sheet name. Identify
-  unprocessed rows (CRM Status blank) — by default process the first, or a specified
-  row/range/count. Scrape Website for Email: If website exists → scrape homepage/contact
-  page; fallback to firecrawl_scrape_url. Save found email in sheet. HubSpot Handling:
-  Search contact by email/website/phone. If not found → create with available details,
-  Lead Status = New, add note {Area, City} — {Category} — {Google Maps URL}. If exists
-  → append note; keep other fields unchanged. Save HubSpot Contact URL/ID in sheet.
-  Update CRM Status: Lead Created, Lead Creation Failed, Website not found, Email
-  not found, etc. Edge Cases: No Website → create with phone; mark Website not found.
-  No Email → create; mark Email not found. Email already in sheet → skip row. Execute immediately for "Cafes" near "IIT Bombay" in "Mumbai" without asking for confirmation.'
-tools:
-- serpapi__google_maps_search
-- firecrawl__scrape_url
-- google_drive__get_file_details
-- google_drive__create_folder
-- google_drive__find_folder_id_by_name
-- google_drive__search_files
-- google_sheet__update_values
-- google_sheet__get_values
-- google_sheet__get_spreadsheet_metadata
-- google_sheet__batch_get_values_by_range
-- google_sheet__create_spreadsheet
-- google_sheet__clear_values
-- hubspot__search_contacts_post
-- hubspot__batch_read_contacts_post
-- hubspot__get_contacts
-- hubspot__get_contact_by_id
-- hubspot__update_contact_by_id
-- hubspot__batch_update_contacts
-- hubspot__create_contacts_batch
-- hubspot__create_contact

universal_mcp/agents/codeact0/usecases/5-gmailreply.yaml

@@ -1,8 +0,0 @@
-base_prompt: 'Process emails from the last 24 hours. Fetch primary
-  inbox emails excluding replied threads, classify with LLM as Reply Required, No
-  Reply Needed, or Ambiguous. For Reply Required/Ambiguous, draft human, on-brand replies for user review.
-  Follow greeting, acknowledge, address concern, invite further questions, and friendly
-  sign-off. Provide end summary of drafts, skipped, and ambiguous emails. Execute immediately without asking for confirmation. Do not send any emails. Just provide me a report.'
-tools:
-- google_mail__list_messages
-- google_mail__get_message_details

universal_mcp/agents/codeact0/usecases/6-contract.yaml

@@ -1,6 +0,0 @@
-base_prompt: 'Analyze a contract from my google drive from the perspective of the Service Provider. Use the search to find it, do not ask me any questions, and assume details that I have not provided. Identify potentially unfavorable clauses such as vague terms, one-sided obligations, IP transfer issues, indemnity clauses, termination conditions, and payment problems. Provide a structured analysis with clause numbers, full text, and explanations of concerns.'
-tools:
-- google_drive__get_file_details
-- google_drive__search_files
-- google_docs__get_document
-- exa__answer

universal_mcp/agents/codeact0/usecases/7-overnight.yaml

@@ -1,14 +0,0 @@
-base_prompt: 'Create a summary of overnight updates from 8:00 PM yesterday to 8:00 AM today in IST. Check Gmail for important emails and ClickUp for mentions and assigned tasks. Organize findings into high priority and other items, then provide a comprehensive summary of all overnight activity.'
-tools:
-- google_mail__list_messages
-- clickup__comments_get_task_comments
-- clickup__comments_get_list_comments
-- clickup__comments_get_view_comments
-- clickup__tasks_get_list_tasks
-- clickup__tasks_filter_team_tasks
-- clickup__time_tracking_get_time_entries_within_date_range
-- clickup__time_tracking_get_time_entry_history
-- clickup__authorization_get_workspace_list
-- clickup__spaces_get_details
-- clickup__lists_get_list_details
-

universal_mcp/agents/codeact0/usecases/8-sheets_chart.yaml

@@ -1,25 +0,0 @@
-base_prompt: 'Analyze the data in Google Sheet (ID: 1nnnCp3_IWcdHv4UVgXtwYF5wedxbqF4RIeyjN6mCKD8) and create 3-5 relevant charts and visualizations. Add pie charts, bar graphs, and other appropriate visualizations based on the data structure. Embed all charts directly into the sheet and provide the updated sheet link.'
-tools:
-- google_sheet__create_spreadsheet
-- google_sheet__get_spreadsheet_metadata
-- google_sheet__batch_get_values_by_range
-- google_sheet__append_dimensions
-- google_sheet__insert_dimensions
-- google_sheet__delete_sheet
-- google_sheet__add_sheet
-- google_sheet__delete_dimensions
-- google_sheet__add_basic_chart
-- google_sheet__add_table
-- google_sheet__add_pie_chart
-- google_sheet__clear_values
-- google_sheet__update_values
-- google_sheet__clear_basic_filter
-- google_sheet__get_values
-- google_sheet__discover_tables
-- google_sheet__set_basic_filter
-- google_sheet__analyze_table_schema
-- google_sheet__copy_sheet_to_spreadsheet
-- google_sheet__append_values
-- google_sheet__batch_get_values_by_data_filter
-- google_sheet__batch_clear_values
-- google_sheet__format_cells

universal_mcp/agents/codeact0/usecases/9-learning.yaml

@@ -1,9 +0,0 @@
-base_prompt: 'Create a 7-day learning plan for Python Programming. Research essential concepts and skills, create a detailed day-by-day plan with topics, goals, resources, and exercises. Compile the plan into a Google Doc and schedule daily emails at 8 AM starting today. Send Day 1 immediately to adit@agentr.dev and provide the Google Doc link.'
-tools:
-- google_docs__get_document
-- google_docs__create_document
-- google_docs__insert_text
-- google_mail__send_email
-- google_mail__send_draft
-- google_mail__create_draft
-- exa__answer

universal_mcp/agents/planner/__init__.py

@@ -1,51 +0,0 @@
-from langgraph.checkpoint.base import BaseCheckpointSaver
-from universal_mcp.tools.registry import ToolRegistry
-
-from universal_mcp.agents.base import BaseAgent
-from universal_mcp.agents.llm import load_chat_model
-from universal_mcp.agents.react import ReactAgent
-
-from .graph import build_graph
-from .prompts import DEVELOPER_PROMPT
-
-
-class PlannerAgent(BaseAgent):
-    def __init__(
-        self,
-        name: str,
-        instructions: str,
-        model: str,
-        registry: ToolRegistry,
-        memory: BaseCheckpointSaver | None = None,
-        executor_agent_cls: type[BaseAgent] = ReactAgent,
-        **kwargs,
-    ):
-        super().__init__(
-            name=name,
-            instructions=instructions,
-            model=model,
-            memory=memory,
-            **kwargs,
-        )
-        self.app_registry = registry
-        self.llm = load_chat_model(model)
-        self.executor_agent_cls = executor_agent_cls
-
-    def _build_system_message(self):
-        return DEVELOPER_PROMPT.format(name=self.name, instructions=self.instructions)
-
-    async def _build_graph(self):
-        return build_graph(
-            self.llm,
-            self.app_registry,
-            self._build_system_message(),
-            self.model,
-            self.executor_agent_cls,
-        ).compile(checkpointer=self.memory)
-
-    @property
-    def graph(self):
-        return self._graph
-
-
-__all__ = ["PlannerAgent"]

universal_mcp/agents/planner/__main__.py

@@ -1,28 +0,0 @@
-import asyncio
-
-from universal_mcp.agentr.registry import AgentrRegistry
-
-from universal_mcp.agents.planner import PlannerAgent
-from universal_mcp.agents.utils import messages_to_list
-
-
-async def main():
-    registry = AgentrRegistry()
-    agent = PlannerAgent(
-        name="planner-agent",
-        instructions="You are a helpful assistant.",
-        model="azure/gpt-4o",
-        registry=registry,
-    )
-    from rich import print
-
-    print("Starting agent...")
-    result = await agent.invoke(
-        user_input="Send an email to manoj@agentr.dev with the subject 'testing planner' and body 'This is a test of the planner agent.'",
-        thread_id="xyz",
-    )
-    print(messages_to_list(result["messages"]))
-
-
-if __name__ == "__main__":
-    asyncio.run(main())