universal-mcp-agents 0.1.8__py3-none-any.whl → 0.1.10__py3-none-any.whl

universal_mcp/applications/ui/app.py

@@ -134,9 +134,7 @@ class UiApp(BaseApplication):
                 "headers": dict(response.headers),
             }
 
-    def http_get(
-        self, url: str, headers: dict | None = None, query_params: dict | None = None
-    ):
+    def http_get(self, url: str, headers: dict | None = None, query_params: dict | None = None):
         """
         Perform a GET request to the specified URL with optional parameters.
 
@@ -150,16 +148,12 @@ class UiApp(BaseApplication):
         Tags:
             get, important
         """
-        logger.debug(
-            f"GET request to {url} with headers {headers} and query params {query_params}"
-        )
+        logger.debug(f"GET request to {url} with headers {headers} and query params {query_params}")
         response = httpx.get(url, params=query_params, headers=headers)
         response.raise_for_status()
         return self._handle_response(response)
 
-    def http_post(
-        self, url: str, headers: dict | None = None, body: dict | None = None
-    ):
+    def http_post(self, url: str, headers: dict | None = None, body: dict | None = None):
         """
         Perform a POST request to the specified URL with optional parameters.
 
@@ -197,9 +191,7 @@ class UiApp(BaseApplication):
         response.raise_for_status()
         return self._handle_response(response)
 
-    def http_delete(
-        self, url: str, headers: dict | None = None, body: dict | None = None
-    ):
+    def http_delete(self, url: str, headers: dict | None = None, body: dict | None = None):
         """
         Perform a DELETE request to the specified URL with optional parameters.
 
@@ -218,9 +210,7 @@ class UiApp(BaseApplication):
         response.raise_for_status()
         return self._handle_response(response)
 
-    def http_patch(
-        self, url: str, headers: dict | None = None, body: dict | None = None
-    ):
+    def http_patch(self, url: str, headers: dict | None = None, body: dict | None = None):
         """
         Perform a PATCH request to the specified URL with optional parameters.
 

{universal_mcp_agents-0.1.8.dist-info → universal_mcp_agents-0.1.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: universal-mcp-agents
-Version: 0.1.8
+Version: 0.1.10
 Summary: Add your description here
 Project-URL: Homepage, https://github.com/universal-mcp/applications
 Project-URL: Repository, https://github.com/universal-mcp/applications
@@ -11,6 +11,7 @@ Requires-Dist: langchain-anthropic>=0.3.19
 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
 Provides-Extra: dev

universal_mcp_agents-0.1.10.dist-info/RECORD

@@ -0,0 +1,42 @@
+universal_mcp/agents/__init__.py,sha256=oPoHMITGbHN4Ey68ZrVbmy7sNzVYhoXQgVII9fZwqL8,1245
+universal_mcp/agents/base.py,sha256=KXBxf3TXrVHi-wBVD-cs6PSKfMtUnm73l-hC83FjOog,6753
+universal_mcp/agents/builder.py,sha256=Xl_dGmzbtop3lICH2njnN6yxFF0SnEGY8u1tOIJy2Pk,8677
+universal_mcp/agents/cli.py,sha256=-luC55FHCTwnpcRgqnV95yQa-mGlLYDlseUjLqFrAfs,1014
+universal_mcp/agents/hil.py,sha256=_xLlBte4v5ex-RxXy5H3LqwFhtd3KE1QUHX1QDGIl2w,3760
+universal_mcp/agents/llm.py,sha256=hVRwjZs3MHl5_3BWedmurs2Jt1oZDfFX0Zj9F8KH7fk,1787
+universal_mcp/agents/react.py,sha256=0OZvdBTnQdFF3Wliv2l4wiF2BMd0VG1cVflOaWDC8r0,3166
+universal_mcp/agents/simple.py,sha256=W5_zb2DAGtAx_p5weSQGIC3gheZwxhmwZBuKKBTjd04,1938
+universal_mcp/agents/utils.py,sha256=lnRmP6HBIme4W-iKy1BOb9gTyb9-ooJxXwCyWAQFP9k,4712
+universal_mcp/agents/bigtool2/__init__.py,sha256=i4virR9r1_1FcS_-iuSHZWgEzYZwOroT6J44qPb0ZgM,2462
+universal_mcp/agents/bigtool2/__main__.py,sha256=t6fWhLh3SnpN_05cww3LA_r_5Rb0gaF_U4FH1Mpsv1Y,655
+universal_mcp/agents/bigtool2/agent.py,sha256=4GIQIy2VQgdXOezmET8G7tvP_37Vv8C027bGdGXJbTI,437
+universal_mcp/agents/bigtool2/graph.py,sha256=FuW1XyTIr1aUbAC4ea8JWRR0JENvLfZGUSgQFmk0h3A,6544
+universal_mcp/agents/bigtool2/meta_tools.py,sha256=02xOsGdxZpXBirn2KWk63UqYPQjI41nQ2KGj2zKBf7Y,5306
+universal_mcp/agents/bigtool2/prompts.py,sha256=rQFtZDkwU9z8d4PWdt6jpohGhyab658Xvk8hvNVBFBA,1843
+universal_mcp/agents/bigtool2/state.py,sha256=TQeGZD99okclkoCh5oz-VYIlEsC9yLQyDpnBnm7QCN8,759
+universal_mcp/agents/bigtoolcache/__init__.py,sha256=qrUwYqhZNE0PdmUCGc5jRQt45Tr1xPDSfBxCPJA1DDM,2260
+universal_mcp/agents/bigtoolcache/__main__.py,sha256=noqT7Nqr17q7Eeiib-Dk2qG6AH4LkNyveeU_ceNDfMA,473
+universal_mcp/agents/bigtoolcache/agent.py,sha256=NCF6fdBPwVcaOyhv8xbAy5DBqbGxJiv8_fLqKib7QJc,267
+universal_mcp/agents/bigtoolcache/context.py,sha256=ny7gd-vvVpUOYAeQbAEUT0A6Vm6Nn2qGywxTzPBzYFg,929
+universal_mcp/agents/bigtoolcache/graph.py,sha256=9KUjsVu5dtPdnyNkqJ5LsMnfH-IF_4H2me_L5aHgsug,4315
+universal_mcp/agents/bigtoolcache/prompts.py,sha256=Rz30qNGdscDG65vMj9d0Vfe7X1pQjBDQBBNc3BuyC94,1886
+universal_mcp/agents/bigtoolcache/state.py,sha256=TQeGZD99okclkoCh5oz-VYIlEsC9yLQyDpnBnm7QCN8,759
+universal_mcp/agents/bigtoolcache/tools.py,sha256=ynyEj9mVwKKDhxm76sjspyH51SFi63g2Vydi39pY0qY,5562
+universal_mcp/agents/codeact/__init__.py,sha256=rLE8gvOo5H4YSr71DRq76b3RV3uuotxuAy_VnBVaVwk,60
+universal_mcp/agents/codeact/__main__.py,sha256=FRfIkgcZfawP-M66v4ePijA6J2fs7nQv92G_8cj5qYA,1142
+universal_mcp/agents/codeact/agent.py,sha256=L5UlVc13AMLRDgx5l1dANoAHSCqAf5A_7wpU4qPXTsc,6326
+universal_mcp/agents/codeact/prompts.py,sha256=Atv6pd5Y7fuBZiQuXS_FKdRJk7oSETEGIob5gDGOK6E,3854
+universal_mcp/agents/codeact/sandbox.py,sha256=qeydhM1vBhgbTWpjEWVdrSRCAcw2P-qVmRXW42YXEbA,1875
+universal_mcp/agents/codeact/state.py,sha256=xu_iPOBus3xqah_5ERhkLa5ZaBZQpHqpia9O-7_3pGw,211
+universal_mcp/agents/codeact/utils.py,sha256=JUbT_HYGS_D1BzmzoVpORIe7SGur1KgJguTZ_1tZ4JY,1918
+universal_mcp/agents/planner/__init__.py,sha256=9P1UL-ABvrTIWTJ8wcvZmkqT8uyROZxsmUFhpjTK-Q4,1313
+universal_mcp/agents/planner/__main__.py,sha256=OfhTfYDZK_ZUfc8sX-Sa6TWk-dNqD2rl13Ln64mNAtw,771
+universal_mcp/agents/planner/graph.py,sha256=70hhIoEZOcYojpiyVSCedgYpnmxVP7aqdn8s6VBu-D4,3228
+universal_mcp/agents/planner/prompts.py,sha256=_JoHqiAvswtqCDu90AGUHmfsu8eWE1-_yI4LLn3pqMU,657
+universal_mcp/agents/planner/state.py,sha256=qqyp-jSGsCxe1US-PRLT4-y1sITAcVE6nCMlQLnvop0,278
+universal_mcp/agents/shared/prompts.py,sha256=VOsXSUEwBXPaAuxJTUF6bgDGr41u6uctUNQSMRt_OJc,6414
+universal_mcp/agents/shared/tool_node.py,sha256=Ua_wzMt4YgIx4zLp3_ZCow-28qORwrZ2FvKqLPt3RlI,10415
+universal_mcp/applications/ui/app.py,sha256=uaS1KrwrGxw9oexdLj2Jok77DrZQAmby3uVxCONQyV8,11276
+universal_mcp_agents-0.1.10.dist-info/METADATA,sha256=x-whXAce-crCYn1O1JVaV-ur0sEIlbsls_1qFbeFa0Q,878
+universal_mcp_agents-0.1.10.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+universal_mcp_agents-0.1.10.dist-info/RECORD,,

universal_mcp/agents/autoagent/__init__.py

@@ -1,30 +0,0 @@
-from langgraph.checkpoint.base import BaseCheckpointSaver
-from universal_mcp.tools.registry import ToolRegistry
-
-from universal_mcp.agents.autoagent.graph import build_graph
-from universal_mcp.agents.base import BaseAgent
-
-
-class AutoAgent(BaseAgent):
-    def __init__(
-        self,
-        name: str,
-        instructions: str,
-        model: str,
-        memory: BaseCheckpointSaver | None = None,
-        registry: ToolRegistry | None = None,
-        **kwargs,
-    ):
-        super().__init__(name, instructions, model, memory, **kwargs)
-        self.tool_registry = registry
-
-    async def _build_graph(self):
-        builder = await build_graph(self.tool_registry, self.instructions)
-        return builder.compile(checkpointer=self.memory)
-
-    @property
-    def graph(self):
-        return self._graph
-
-
-__all__ = ["AutoAgent"]

universal_mcp/agents/autoagent/__main__.py

@@ -1,25 +0,0 @@
-import asyncio
-
-from loguru import logger
-from universal_mcp.agentr.registry import AgentrRegistry
-
-from universal_mcp.agents.autoagent import AutoAgent
-
-
-async def main():
-    agent = AutoAgent(
-        name="autoagent",
-        instructions="You are a helpful assistant that can use tools to help the user.",
-        model="azure/gpt-4.1",
-        registry=AgentrRegistry(),
-    )
-    async for event in agent.stream(
-        user_input="Send an email to manoj@agentr.dev",
-        thread_id="test123",
-    ):
-        logger.info(event.content)
-    # from loguru import logger; logger.debug(result)
-
-
-if __name__ == "__main__":
-    asyncio.run(main())

universal_mcp/agents/autoagent/context.py

@@ -1,26 +0,0 @@
-from dataclasses import dataclass, field
-from typing import Annotated
-
-from universal_mcp.agents.autoagent.prompts import SYSTEM_PROMPT
-
-
-@dataclass(kw_only=True)
-class Context:
-    """The context for the agent."""
-
-    system_prompt: str = field(
-        default=SYSTEM_PROMPT,
-        metadata={
-            "description": "The system prompt to use for the agent's interactions. "
-            "This prompt sets the context and behavior for the agent."
-        },
-    )
-
-    model: Annotated[str, {"__template_metadata__": {"kind": "llm"}}] = field(
-        default="anthropic/claude-4-sonnet-20250514",
-        # default="vertex/gemini-2.5-flash",
-        metadata={
-            "description": "The name of the language model to use for the agent's main interactions. "
-            "Should be in the form: provider/model-name."
-        },
-    )

universal_mcp/agents/autoagent/graph.py

@@ -1,170 +0,0 @@
-import json
-from datetime import UTC, datetime
-from typing import cast
-
-from langchain_core.messages import AIMessage, ToolMessage
-from langchain_core.tools import tool
-from langgraph.graph import END, START, StateGraph
-from langgraph.runtime import Runtime
-from universal_mcp.tools.registry import ToolRegistry
-from universal_mcp.types import ToolFormat
-
-from universal_mcp.agents.autoagent.context import Context
-from universal_mcp.agents.autoagent.prompts import SYSTEM_PROMPT
-from universal_mcp.agents.autoagent.state import State
-from universal_mcp.agents.llm import load_chat_model
-
-
-async def build_graph(tool_registry: ToolRegistry, instructions: str = ""):
-    @tool()
-    async def search_tools(query: str, app_ids: list[str] | None = None) -> list[str]:
-        """Retrieve tools using a search query and a list of app ids. Use multiple times if you require tools for different queries."""
-        tools_list = []
-        if app_ids is not None:
-            for app_id in app_ids:
-                tools_list.extend(
-                    await tool_registry.search_tools(query, limit=10, app_id=app_id)
-                )
-        else:
-            tools_list = await tool_registry.search_tools(query, limit=10)
-        tools_list = [f"{tool['id']}: {tool['description']}" for tool in tools_list]
-        return tools_list
-
-    @tool()
-    async def ask_user(question: str) -> str:
-        """Ask the user a question. Use this tool to ask the user for any missing information for performing a task, or when you have multiple apps to choose from for performing a task."""
-        full_question = question
-        return f"ASKING_USER: {full_question}"
-
-    @tool()
-    async def load_tools(tools: list[str]) -> list[str]:
-        """Choose the tools you want to use by passing their tool ids.  Loads the tools for the chosen tools and returns the tool ids."""
-        return tools
-
-    async def call_model(
-        state: State,
-        runtime: Runtime[Context],
-    ):
-        system_prompt = SYSTEM_PROMPT
-        app_ids = await tool_registry.list_all_apps()
-        connections = await tool_registry.list_connected_apps()
-        connection_ids = set([connection["app_id"] for connection in connections])
-        connected_apps = [app["id"] for app in app_ids if app["id"] in connection_ids]
-        unconnected_apps = [
-            app["id"] for app in app_ids if app["id"] not in connection_ids
-        ]
-        app_id_descriptions = (
-            "These are the apps connected to the user's account:\n"
-            + "\n".join([f"{app}" for app in connected_apps])
-        )
-        if unconnected_apps:
-            app_id_descriptions += "\n\nOther (not connected) apps: " + "\n".join(
-                [f"{app}" for app in unconnected_apps]
-            )
-
-        system_prompt = system_prompt.format(
-            system_time=datetime.now(tz=UTC).isoformat(), app_ids=app_id_descriptions
-        )
-
-        messages = [
-            {"role": "system", "content": system_prompt + "\n" + instructions},
-            *state["messages"],
-        ]
-        model = load_chat_model(runtime.context.model)
-        loaded_tools = await tool_registry.export_tools(
-            tools=state["selected_tool_ids"], format=ToolFormat.LANGCHAIN
-        )
-        model_with_tools = model.bind_tools(
-            [search_tools, ask_user, load_tools, *loaded_tools], tool_choice="auto"
-        )
-        response_raw = model_with_tools.invoke(messages)
-        response = cast(AIMessage, response_raw)
-        return {"messages": [response]}
-
-    # Define the conditional edge that determines whether to continue or not
-    def should_continue(state: State):
-        messages = state["messages"]
-        last_message = messages[-1]
-        # If there is no function call, then we finish
-        if not last_message.tool_calls:
-            return END
-        else:
-            return "tools"
-
-    def tool_router(state: State):
-        last_message = state["messages"][-1]
-        if isinstance(last_message, ToolMessage) and last_message.name == ask_user.name:
-            return END
-        else:
-            return "agent"
-
-    async def tool_node(state: State):
-        outputs = []
-        tool_ids = state["selected_tool_ids"]
-        for tool_call in state["messages"][-1].tool_calls:
-            if tool_call["name"] == ask_user.name:
-                outputs.append(
-                    ToolMessage(
-                        content=json.dumps(
-                            "The user has been asked the question, and the run will wait for the user's response."
-                        ),
-                        name=tool_call["name"],
-                        tool_call_id=tool_call["id"],
-                    )
-                )
-            elif tool_call["name"] == search_tools.name:
-                tools = await search_tools.ainvoke(tool_call["args"])
-                outputs.append(
-                    ToolMessage(
-                        content=json.dumps(tools)
-                        + "\n\nUse the load_tools tool to load the tools you want to use.",
-                        name=tool_call["name"],
-                        tool_call_id=tool_call["id"],
-                    )
-                )
-
-            elif tool_call["name"] == load_tools.name:
-                tool_ids = await load_tools.ainvoke(tool_call["args"])
-
-                outputs.append(
-                    ToolMessage(
-                        content=json.dumps(tool_ids),
-                        name=tool_call["name"],
-                        tool_call_id=tool_call["id"],
-                    )
-                )
-            else:
-                await tool_registry.export_tools(
-                    [tool_call["name"]], ToolFormat.LANGCHAIN
-                )
-                try:
-                    tool_result = await tool_registry.call_tool(
-                        tool_call["name"], tool_call["args"]
-                    )
-                    outputs.append(
-                        ToolMessage(
-                            content=json.dumps(tool_result),
-                            name=tool_call["name"],
-                            tool_call_id=tool_call["id"],
-                        )
-                    )
-                except Exception as e:
-                    outputs.append(
-                        ToolMessage(
-                            content=json.dumps("Error: " + str(e)),
-                            name=tool_call["name"],
-                            tool_call_id=tool_call["id"],
-                        )
-                    )
-        return {"messages": outputs, "selected_tool_ids": tool_ids}
-
-    builder = StateGraph(State, context_schema=Context)
-
-    builder.add_node("agent", call_model)
-    builder.add_node("tools", tool_node)
-
-    builder.add_edge(START, "agent")
-    builder.add_conditional_edges("agent", should_continue)
-    builder.add_conditional_edges("tools", tool_router)
-
-    return builder

universal_mcp/agents/autoagent/prompts.py

@@ -1,9 +0,0 @@
-"""Default prompts used by the agent."""
-
-SYSTEM_PROMPT = """You are a helpful AI assistant. When you lack tools for any task you should use the `search_tools` function to unlock relevant tools. Whenever you need to ask the user for any information, or choose between multiple different applications, you can ask the user using the `ask_user` function.
-
-System time: {system_time}
-These are the list of apps available to you:
-{app_ids}
-Note that when multiple apps seem relevant for a task, you MUST ask the user to choose the app. Prefer connected apps over unconnected apps while breaking a tie. If more than one relevant app (or none of the relevant apps) are connected, you must ask the user to choose the app. In case the user asks you to use an app that is not connected, call the apps tools normally. You will be provided a link for connection that you should pass on to the user.
-"""

universal_mcp/agents/autoagent/state.py

@@ -1,27 +0,0 @@
-from typing import Annotated
-
-from langgraph.prebuilt.chat_agent_executor import AgentState
-
-
-def _enqueue(left: list, right: list) -> list:
-    """Treat left as a FIFO queue, append new items from right (preserve order),
-    keep items unique, and cap total size to 20 (drop oldest items)."""
-    max_size = 30
-    preferred_size = 20
-    if len(right) > preferred_size:
-        preferred_size = min(max_size, len(right))
-    queue = list(left or [])
-
-    for item in right[:preferred_size] or []:
-        if item in queue:
-            queue.remove(item)
-        queue.append(item)
-
-    if len(queue) > preferred_size:
-        queue = queue[-preferred_size:]
-
-    return queue
-
-
-class State(AgentState):
-    selected_tool_ids: Annotated[list[str], _enqueue]

universal_mcp/agents/autoagent/utils.py

@@ -1,13 +0,0 @@
-from langchain_core.messages import BaseMessage
-
-
-def get_message_text(msg: BaseMessage) -> str:
-    """Get the text content of a message."""
-    content = msg.content
-    if isinstance(content, str):
-        return content
-    elif isinstance(content, dict):
-        return content.get("text", "")
-    else:
-        txts = [c if isinstance(c, str) else (c.get("text") or "") for c in content]
-        return "".join(txts).strip()

universal_mcp/agents/bigtool/__init__.py

@@ -1,58 +0,0 @@
-from langgraph.checkpoint.base import BaseCheckpointSaver
-from universal_mcp.logger import logger
-from universal_mcp.tools.registry import ToolRegistry
-
-from universal_mcp.agents.base import BaseAgent
-from universal_mcp.agents.llm import load_chat_model
-
-from .graph import build_graph
-from .prompts import SYSTEM_PROMPT
-
-
-class BigToolAgent(BaseAgent):
-    def __init__(
-        self,
-        name: str,
-        instructions: str,
-        model: str,
-        registry: ToolRegistry,
-        memory: BaseCheckpointSaver | None = None,
-        **kwargs,
-    ):
-        super().__init__(name, instructions, model, memory, **kwargs)
-        self.registry = registry
-        self.llm = load_chat_model(self.model)
-
-        logger.info(
-            f"BigToolAgent '{self.name}' initialized with model '{self.model}'."
-        )
-
-    def _build_system_message(self):
-        return SYSTEM_PROMPT.format(
-            name=self.name,
-            instructions=self.instructions,
-        )
-
-    async def _build_graph(self):
-        """Build the bigtool agent graph using the existing create_agent function."""
-        logger.info(f"Building graph for BigToolAgent '{self.name}'...")
-        try:
-            graph_builder = build_graph(
-                tool_registry=self.registry,
-                llm=self.llm,
-                system_prompt=self._build_system_message(),
-            )
-
-            compiled_graph = graph_builder.compile(checkpointer=self.memory)
-            logger.info("Graph built and compiled successfully.")
-            return compiled_graph
-        except Exception as e:
-            logger.error(f"Error building graph for BigToolAgent '{self.name}': {e}")
-            raise
-
-    @property
-    def graph(self):
-        return self._graph
-
-
-__all__ = ["BigToolAgent"]

universal_mcp/agents/bigtool/__main__.py

@@ -1,23 +0,0 @@
-import asyncio
-
-from loguru import logger
-from universal_mcp.agentr.registry import AgentrRegistry
-
-from universal_mcp.agents.bigtool import BigToolAgent
-from universal_mcp.agents.utils import messages_to_list
-
-
-async def main():
-    agent = BigToolAgent(
-        name="bigtool",
-        instructions="You are a helpful assistant that can use tools to help the user.",
-        model="azure/gpt-4.1",
-        registry=AgentrRegistry(),
-    )
-    await agent.ainit()
-    output = await agent.invoke(
-        user_input="Send an email to manoj@agentr.dev")
-    logger.info(messages_to_list(output["messages"]))
-
-if __name__ == "__main__":
-    asyncio.run(main())