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

universal_mcp/agents/codeact0/utils.py

@@ -1,9 +1,13 @@
+import ast
+import importlib
 import re
 from collections.abc import Sequence
 from typing import Any
 
 from langchain_core.messages import BaseMessage
 
+MAX_CHARS = 300
+
 
 def light_copy(data):
     """
@@ -13,13 +17,13 @@ def light_copy(data):
         data: Either a dictionary with string keys, or a sequence of such dictionaries
 
     Returns:
-        A deep copy where all string values are truncated to 30 characters
+        A deep copy where all string values are truncated to MAX_CHARS characters
     """
 
     def truncate_string(value):
-        """Truncate string to 30 chars, preserve other types"""
-        if isinstance(value, str) and len(value) > 30:
-            return value[:30] + "..."
+        """Truncate string to MAX_CHARS chars, preserve other types"""
+        if isinstance(value, str) and len(value) > MAX_CHARS:
+            return value[:MAX_CHARS] + "..."
         return value
 
     def copy_dict(d):
@@ -72,6 +76,7 @@ def make_safe_function_name(name: str) -> str:
         safe_name = "unnamed_tool"
     return safe_name
 
+
 def derive_context(code: str, context: dict[str, Any]) -> dict[str, Any]:
     """
     Derive context from code by extracting classes, functions, and import statements.
@@ -83,8 +88,6 @@ def derive_context(code: str, context: dict[str, Any]) -> dict[str, Any]:
     Returns:
         Updated context dictionary with extracted entities
     """
-    import ast
-    import re
 
     # Initialize context keys if they don't exist
     if "imports" not in context:
@@ -135,7 +138,7 @@ def derive_context(code: str, context: dict[str, Any]) -> dict[str, Any]:
 
                 if class_def not in context["classes"]:
                     context["classes"].append(class_def)
-        
+
         # Extract function definitions (including async)
         for node in ast.walk(tree):
             if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef)):
@@ -148,7 +151,6 @@ def derive_context(code: str, context: dict[str, Any]) -> dict[str, Any]:
                     if func_def not in context["functions"]:
                         context["functions"].append(func_def)
 
-
     except SyntaxError:
         # If the code has syntax errors, try a simpler regex-based approach
 
@@ -164,8 +166,8 @@ def derive_context(code: str, context: dict[str, Any]) -> dict[str, Any]:
                 if "from" in pattern:
                     module = match.group(1)
                     imports = match.group(2).split(",")
-                    for imp in imports:
-                        imp = imp.strip()
+                    for import_name in imports:
+                        imp = import_name.strip()
                         if " as " in imp:
                             name, alias = imp.split(" as ")
                             import_stmt = f"from {module} import {name.strip()} as {alias.strip()}"
@@ -234,8 +236,6 @@ def inject_context(
         namespace = inject_context(context, existing_ns)
         # namespace will contain: {'math': <math module>, 'data': [1, 2, 3], 'pandas': <module>, 'pd': <module>, 'numpy': <module>, 'np': <module>, 'MyClass': <class>, 'MC': <class>, 'my_function': <function>, ...}
     """
-    import importlib
-    from typing import Any
 
     # Start with existing namespace or create new one
     namespace: dict[str, Any] = existing_namespace.copy() if existing_namespace is not None else {}
@@ -248,7 +248,6 @@ def inject_context(
                 exec(import_statement, namespace)
             except Exception as e:
                 # If execution fails, try to extract module name and create placeholder
-                import re
 
                 # Handle different import patterns
                 import_match = re.search(r"import\s+(\w+)(?:\s+as\s+(\w+))?", import_statement)
@@ -279,7 +278,6 @@ def inject_context(
                 exec(class_definition, namespace)
             except Exception:
                 # If execution fails, try to extract class name and create placeholder
-                import re
 
                 class_match = re.search(r"class\s+(\w+)", class_definition)
                 if class_match:
@@ -288,14 +286,14 @@ def inject_context(
                     # Create a placeholder class
                     class PlaceholderClass:
                         def __init__(self, *args, **kwargs):
-                            raise NotImplementedError(f"Class '{class_name}' failed to load: {str(e)}")
+                            raise NotImplementedError("Class '{class_name}' failed to load")
 
                     namespace[class_name] = PlaceholderClass
                 else:
                     # If we can't extract class name, create a generic placeholder
                     class GenericPlaceholderClass:
                         def __init__(self, *args, **kwargs):
-                            raise NotImplementedError(f"Class definition failed to load: {str(e)}")
+                            raise NotImplementedError("Class definition failed to load")
 
                     namespace[f"class_{len(namespace)}"] = GenericPlaceholderClass
 
@@ -313,17 +311,20 @@ def inject_context(
                     is_async = bool(func_match.group(1))
 
                     if is_async:
+
                         async def placeholder_func(*args, **kwargs):
-                            raise NotImplementedError(f"Async function '{func_name}' failed to load: {str(e)}")
+                            raise NotImplementedError(f"Async function '{func_name}' failed to load")
                     else:
+
                         def placeholder_func(*args, **kwargs):
-                            raise NotImplementedError(f"Function '{func_name}' failed to load: {str(e)}")
+                            raise NotImplementedError(f"Function '{func_name}' failed to load")
 
                     placeholder_func.__name__ = func_name
                     namespace[func_name] = placeholder_func
 
     return namespace
 
+
 def schema_to_signature(schema: dict, func_name="my_function") -> str:
     type_map = {
         "integer": "int",
@@ -351,3 +352,37 @@ def schema_to_signature(schema: dict, func_name="my_function") -> str:
     # join into signature
     param_str = ",\n    ".join(params)
     return f"def {func_name}(\n    {param_str},\n):"
+
+
+def smart_truncate(
+    output: str, max_chars_full: int = 2000, max_lines_headtail: int = 20, summary_threshold: int = 10000
+) -> str:
+    """
+    Truncates or summarizes output intelligently to avoid filling the context too fast.
+
+    Args:
+        output (str): The string output from code execution.
+        max_chars_full (int): Max characters to keep full output.
+        max_lines_headtail (int): Number of lines to keep from head and tail for medium outputs.
+        summary_threshold (int): If truncated output exceeds this, hard-truncate.
+
+    Returns:
+        str: Truncated or summarized output.
+    """
+    if len(output) <= max_chars_full:
+        return output  # Small output, include fully
+
+    lines = output.splitlines()
+    if len(lines) <= 2 * max_lines_headtail:
+        return output  # Medium output, include fully
+
+    # Medium-large output: take head + tail
+    head = "\n".join(lines[:max_lines_headtail])
+    tail = "\n".join(lines[-max_lines_headtail:])
+    truncated = f"{head}\n... [truncated {len(lines) - 2 * max_lines_headtail} lines] ...\n{tail}"
+
+    # If still too big, cut to summary threshold
+    if len(truncated) > summary_threshold:
+        truncated = truncated[:summary_threshold] + "\n... [output truncated to fit context] ..."
+
+    return truncated

universal_mcp/agents/shared/__main__.py

@@ -2,9 +2,10 @@ import asyncio
 
 from rich import print
 from universal_mcp.agentr.registry import AgentrRegistry
+from universal_mcp.logger import setup_logger
+
 from universal_mcp.agents.llm import load_chat_model
 from universal_mcp.agents.shared.tool_node import build_tool_node_graph
-from universal_mcp.logger import setup_logger
 
 
 async def main():
@@ -40,4 +41,4 @@ async def main():
 
 
 if __name__ == "__main__":
-    asyncio.run(main())
+    asyncio.run(main())

universal_mcp/agents/shared/prompts.py

@@ -80,4 +80,4 @@ You are an AI assistant that selects the most appropriate tool(s) from a list to
 {tool_candidates}
 
 **YOUR SELECTED TOOL ID(s) (as a list of strings):**
-"""
+"""

universal_mcp/agents/shared/tool_node.py

@@ -113,33 +113,35 @@ def build_tool_node_graph(llm: BaseChatModel, registry: ToolRegistry) -> StateGr
         """
         A retry node that performs a general tool search without app filters.
         """
-        task = state["original_task"]
+        state["original_task"]
         queries = state["queries"]
         retry_count = state.get("retry_count", 0)
 
         if retry_count >= MAX_RETRIES:
             logger.error("Max retries reached. Failing the planning process.")
             return Command(
-                update={"messages": [AIMessage(content="I could not find any relevant tools after extensive searching.")]},
+                update={
+                    "messages": [AIMessage(content="I could not find any relevant tools after extensive searching.")]
+                },
                 goto="handle_failure",
             )
 
         logger.info(f"--- RETRY {retry_count + 1}/{MAX_RETRIES} ---")
         logger.info("Performing a general tool search without app filters.")
 
-        general_search_tasks = [
-            registry.search_tools(query, distance_threshold=0.85) for query in queries
-        ]
+        general_search_tasks = [registry.search_tools(query, distance_threshold=0.85) for query in queries]
         tool_results = await asyncio.gather(*general_search_tasks)
-        
-        unique_tools = {tool['id']: tool for tool_list in tool_results for tool in tool_list}
+
+        unique_tools = {tool["id"]: tool for tool_list in tool_results for tool in tool_list}
         candidate_tools = list(unique_tools.values())
 
         if not candidate_tools:
             logger.error("General search (retry) also failed to find any tools.")
             return Command(
                 update={
-                    "messages": [AIMessage(content="I could not find any tools for your request, even with a broader search.")],
+                    "messages": [
+                        AIMessage(content="I could not find any tools for your request, even with a broader search.")
+                    ],
                     "retry_count": retry_count + 1,
                 },
                 goto="handle_failure",
@@ -167,14 +169,17 @@ def build_tool_node_graph(llm: BaseChatModel, registry: ToolRegistry) -> StateGr
             if retry_count >= MAX_RETRIES:
                 logger.error("LLM did not select any tools, even after a retry. Failing.")
                 return Command(
-                    update={"messages": [AIMessage(content="I found potential tools, but could not create a final plan.")]},
+                    update={
+                        "messages": [AIMessage(content="I found potential tools, but could not create a final plan.")]
+                    },
                     goto="handle_failure",
                 )
             else:
-                logger.warning("LLM did not select any tools from the current candidate list. Triggering general search.")
+                logger.warning(
+                    "LLM did not select any tools from the current candidate list. Triggering general search."
+                )
                 return Command(goto="general_search_and_select")
 
-
         logger.success(f"Selected {len(selected_tool_ids)} tools for the final plan: {selected_tool_ids}")
 
         final_plan = defaultdict(list)
@@ -203,4 +208,4 @@ def build_tool_node_graph(llm: BaseChatModel, registry: ToolRegistry) -> StateGr
 
     workflow.set_entry_point("search_for_tools")
 
-    return workflow.compile()
+    return workflow.compile()

universal_mcp/agents/utils.py

@@ -1,16 +1,19 @@
 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
 from rich.panel import Panel
 from rich.prompt import Prompt
 from rich.table import Table
-from pydantic import ValidationError
-from requests import JSONDecodeError
 
 
 class RichCLI:
@@ -148,17 +151,14 @@ def get_message_text(message: BaseMessage):
 
 
 def filter_retry_on(exc: Exception) -> bool:
-    import httpx
-    import requests
-
     # Transient local/network issues and parsing hiccups
     if isinstance(
         exc,
         (
-            TimeoutError, 
-            ConnectionError, 
-            JSONDecodeError, 
-            ValidationError, 
+            TimeoutError,
+            ConnectionError,
+            JSONDecodeError,
+            ValidationError,
         ),
     ):
         return True
@@ -180,12 +180,18 @@ def filter_retry_on(exc: Exception) -> bool:
     # HTTP status based retries: 408 (timeout), 429 (rate limit), and 5xx
     if isinstance(exc, httpx.HTTPStatusError):
         status = exc.response.status_code
-        return status == 408 or status == 429 or 500 <= status < 600
+        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 == 408 or status == 429 or 500 <= status < 600
+        return (
+            status in {408, 429}
+            or HTTPStatus.INTERNAL_SERVER_ERROR.value <= status <= HTTPStatus.NETWORK_AUTHENTICATION_REQUIRED.value
+        )
 
     if isinstance(
         exc,
@@ -207,4 +213,4 @@ def filter_retry_on(exc: Exception) -> bool:
         return False
 
     # Default: do not retry unknown exceptions
-    return False
+    return False

{universal_mcp_agents-0.1.14.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.14
+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,14 +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
-- google_sheet__create_spreadsheet
-- google_sheet__write_values_to_sheet
-- google_sheet__delete_dimensions
-- google_sheet__append_values
-- google_sheet__update_values
-- clickup__tasks_create_new_task
-- clickup__spaces_get_details
-- clickup__lists_get_list_details
-- clickup__tasks_get_list_tasks
-- github__search_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