universal-mcp-agents 0.1.23rc11__tar.gz → 0.1.24rc1__tar.gz

{universal_mcp_agents-0.1.23rc11 → universal_mcp_agents-0.1.24rc1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: universal-mcp-agents
-Version: 0.1.23rc11
+Version: 0.1.24rc1
 Summary: Add your description here
 Project-URL: Homepage, https://github.com/universal-mcp/applications
 Project-URL: Repository, https://github.com/universal-mcp/applications

{universal_mcp_agents-0.1.23rc11 → universal_mcp_agents-0.1.24rc1}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "universal-mcp-agents"
-version = "0.1.23-rc11"
+version = "0.1.24-rc1"
 description = "Add your description here"
 readme = "README.md"
 authors = [

{universal_mcp_agents-0.1.23rc11 → universal_mcp_agents-0.1.24rc1}/src/universal_mcp/agents/codeact0/agent.py

@@ -52,7 +52,7 @@ class CodeActPlaybookAgent(BaseAgent):
             **kwargs,
         )
         self.model_instance = load_chat_model(model)
-        self.agent_builder_model_instance = load_chat_model("anthropic:claude-sonnet-4-5-20250929", thinking = False)
+        self.agent_builder_model_instance = load_chat_model("anthropic:claude-sonnet-4-5-20250929", thinking=False)
         self.registry = registry
         self.agent_builder_registry = agent_builder_registry
         self.agent = agent_builder_registry.get_agent() if agent_builder_registry else None

{universal_mcp_agents-0.1.23rc11 → universal_mcp_agents-0.1.24rc1}/src/universal_mcp/agents/codeact0/prompts.py

@@ -12,21 +12,33 @@ Your job is to answer the user's question or perform the task they ask for.
 - For writing, text/document generation (like HTML/markdown document generation) or language processing tasks DO NOT answer directly. Instead you MUST use `execute_ipython_cell` tool with the llm functions provided to you for tasks like summarizing, text generation, classification, data extraction from text or unstructured data, etc. Avoid hardcoded approaches to classification, data extraction, or creative writing.
 - You also have access to two tools for finding and loading more python functions- `search_functions` and `load_functions`, which you must use for finding functions for using different external applications or additional functionality.
     - Prioritize connected applications over unconnected ones from the output of `search_functions`. However, if the user specifically asks for an application, you MUST use that irrespective of connection status.
-    - When multiple apps are connected, or none of the apps are connected, YOU MUST ask the user to choose the application(s). The search results will inform you when such a case occurs, and you must stop and ask the user if multiple apps are relevant.
-- The code you write will be executed in a sandbox environment, and you can use the output of previous executions in your code. variables, functions, imports are retained.
-- Read and understand the output of the previous code snippet and use it to answer the user's request. Note that the code output is NOT visible to the user, so after the task is complete, you have to give the output to the user in a markdown format. Similarly, you should only use print/smart_print for your own analysis, the user does not get the output.
+    - When multiple relevant apps are connected, or none of the apps are connected, YOU MUST ask the user to choose the application(s). The search results may also inform you when such a case occurs, and you must stop and ask the user if multiple apps are relevant.
 - If needed, feel free to ask for more information from the user (without using the `execute_ipython_cell` tool) to clarify the task.
 
-**Code Execution Guidelines:**
-- The code you write will be executed in a sandbox environment, and you can use the output of previous executions in your code. Variables, functions, imports are retained.
-- Read and understand the output of the previous code snippet and use it to answer the user's request. Note that the code output is NOT visible to the user, so after the task is complete, you have to give the output to the user in a markdown format. Similarly, you should only use print/smart_print for your own analysis, the user does not get the output.
-- If needed, feel free to ask for more information from the user (without using the `execute_ipython_cell` tool) to clarify the task.
-- DO NOT use the code execution to communicate/show anything to the user. The user is not able to see the output of the code cells, it is only for your processing and actions.
-- Whenever you need to generate a large body of text, such as a document, an HTML file, or a report, use llm functions and save the output file using save functions. Do not generate text yourself and do not print the entire text in order to save your memory.
-
-**Coding Best Practices:**
+**Code Design**: 
 - Structure your code into multiple small, well-defined functions within a single execution snippet. This ensures modularity and makes it easier to debug or update specific logic without rewriting or re-executing large portions of code. You can only rewrite the function/portion that you need to edit since the others are retained in context.
-- Variables, functions, classes defined at the top level of previous code snippets can be referenced in your code.
+- Every snippet you execute using `execute_ipython_cell` MUST follow this structure:
+    - Break down logic into 3-5 small helper functions (30 lines each max)
+    - Each helper function should do ONE thing
+    - Example:
+        def _helper_function_1(...):
+            ...
+
+        def _helper_function_2(...):
+            ...
+        result1 = _helper_function_1(...)
+        smart_print(result1[:1]) #As an example, to check if it has been processed correctly
+        result2 = _helper_function_2(...)
+        smart_print(result2[:1])
+        final_result = ...
+        smart_print(final_result)
+- Thus, while debugging, if you face an error in result2, you do not need to rewrite _helper_function_1. 
+
+
+**Code Writing Rules:**
+- The code you write will be executed in a sandbox environment, and you can use the output of previous executions in your code. Variables, defined functions, imports, loaded functions are retained.
+- DO NOT use the code execution to communicate/show anything to the user. The user is not able to see the output of the code cells, it is only for your processing and actions. Similarly, you should only use print/smart_print for your own analysis, the user does not get the output.
+- Whenever you need to generate a large body of text, such as a document, an HTML file, or a report, use llm functions and save the output file using save/upload functions. Do not generate text yourself and do not print the entire text in order to save your memory.
 - External functions which return a dict or list[dict] are ambiguous. Therefore, you MUST explore the structure of the returned data using `smart_print()` statements before using it, printing keys and values. `smart_print` truncates long strings from data, preventing huge output logs.
 - When an operation involves running a fixed set of steps on a list of items, run one run correctly and then use a for loop to run the steps on each item in the list.
 - You can only import libraries that come pre-installed with Python. However, do consider searching for external functions first, using the search and load tools to access them in the code.
@@ -91,16 +103,23 @@ Note that the following tools are pre-loaded for the agent's use, and can be inl
 
 
 AGENT_BUILDER_GENERATING_PROMPT = """
-You are tasked with generating a reusable agent function based on the final confirmed agent plan and preceding conversation history including user messages, assistant messages, and code executions.
-Create an appropriately named python function that combines relevent previously executed code from the conversation history to achieve the plan objectives.
+You are tasked with generating granular, reusable Python code for an agent based on the final confirmed plan and the conversation history (user messages, assistant messages, and code executions).
+
+Produce a set of small, single-purpose functions—typically one function per plan step—plus one top-level orchestrator function that calls the step functions in order to complete the task.
+
 Rules-
-- Do NOT include the searching and loading of functions. Assume that the functions have already been loaded. Imports should be included.
-- Your response must be **ONLY Python code** for the function.
-- Do not include any text, explanations, or Markdown.
-- The response must start with `def` or `async def` and define a single, complete, executable function.
-- The function parameters **must exactly match the external variables** in the agent plan. External variables are marked using backticks `` `variable_name` ``.  Any variables in italics (i.e. enclosed in *...*) are to be used internally, but not as the main function paramters.
-- Any imports, variables, helper or child functions required must be defined **inside the main top-level function**.
-- Ensure that the outer function is self-contained and can run independently, based on previously validated code snippets.
+- Do NOT include the searching and loading of functions. Assume required functions have already been loaded. Include imports you need.
+- Your response must be **ONLY Python code**. No markdown or explanations.
+- Define multiple top-level functions:
+  1) One small, clear function for each plan step (as granular as practical).
+  2) One top-level orchestrator function that calls the step functions in sequence to achieve the plan objectives.
+- The orchestrator function's parameters **must exactly match the external variables** in the agent plan (the ones marked with backticks `` `variable_name` ``). Provide defaults exactly as specified in the plan when present. Variables in italics (i.e. enclosed in *...*) are internal and must not be orchestrator parameters.
+- The orchestrator function MUST be declared with `def` or `async def` and be directly runnable with a single Python command (e.g., `image_generator(...)`). If it is async, assume the caller will `await` it.
+- Step functions should accept only the inputs they need, return explicit outputs, and pass intermediate results forward via return values—not globals.
+- Name functions in snake_case derived from their purpose/step. Use keyword arguments in calls; avoid positional-only calls.
+- Keep the code self-contained and executable. Put imports at the top of the code. Do not nest functions unless strictly necessary.
+- If previously executed code snippets exist, adapt and reuse their validated logic inside the appropriate step functions.
+- Do not print the final output; return it from the orchestrator.
 
 Example:
 
@@ -113,16 +132,31 @@ If the plan has:
 "Upload *temp_file_path* to OneDrive folder onedrive_parent_folder(default = 'root')"
 ]
 
-Then the function signature should be:
+Then the functions should look like:
 
 ```python
-def image_generator(image_prompt, style="comic", onedrive_parent_folder="root"):
-    #Code based on previously executed snippets
+from typing import Dict
+
+def generate_image(image_prompt: str, style: str = "comic") -> Dict:
+    # previously validated code to call Gemini
+    ...
+
+def save_temp_image(image_result: Dict) -> str:
+    # previously validated code to write bytes to a temp file
+    ...
 
-And all internal variables (e.g., *temp_file_path*) should be defined inside the function.
+def upload_to_onedrive(temp_file_path: str, onedrive_parent_folder: str = "root") -> Dict:
+    # previously validated code to upload
+    ...
 
+def image_generator(image_prompt: str, style: str = "comic", onedrive_parent_folder: str = "root") -> Dict:
+    image_result = generate_image(image_prompt=image_prompt, style=style)
+    temp_file_path = save_temp_image(image_result=image_result)
+    upload_result = upload_to_onedrive(temp_file_path=temp_file_path, onedrive_parent_folder=onedrive_parent_folder)
+    return upload_result
+```
 
-Use this convention consistently to generate the final agent function.
+Use this convention consistently to generate the final code.
 Note that the following tools are pre-loaded for the agent's use, and can be included in your code-\n
 """
 

{universal_mcp_agents-0.1.23rc11 → universal_mcp_agents-0.1.24rc1}/src/universal_mcp/agents/codeact0/tools.py

@@ -203,10 +203,10 @@ def create_meta_tools(tool_registry: AgentrRegistry) -> dict[str, Any]:
                 )
 
             result_parts.append("Call load_functions to select the required functions only.")
-            if 0 < len(connected_apps_in_results) < len(apps_in_results):
+            if 0 <= len(connected_apps_in_results) < len(apps_in_results):
                 result_parts.append(
-                    "Unconnected app functions can also be loaded if required by the user, "
-                    "but prefer connected ones. Ask the user to choose if none of the "
+                    "Unconnected app functions can also be loaded if asked for by the user, they will generate a connection link"
+                    "but prefer connected ones. Ask the user to choose the app if none of the "
                     "relevant apps are connected."
                 )
 
@@ -396,7 +396,7 @@ def create_meta_tools(tool_registry: AgentrRegistry) -> dict[str, Any]:
         response = await markitdown.convert_to_markdown(uri)
         return response
 
-    async def save_file(file_name: str, content: str) -> dict:
+    def save_file(file_name: str, content: str) -> dict:
         """
         Saves a file to the local filesystem.
 
@@ -418,7 +418,7 @@ def create_meta_tools(tool_registry: AgentrRegistry) -> dict[str, Any]:
             "file_path": Path(file_name).absolute(),
         }
 
-    async def upload_file(file_name: str, mime_type: str, base64_data: str) -> dict:
+    def upload_file(file_name: str, mime_type: str, base64_data: str) -> dict:
         """
         Uploads a file to the server via the AgentrClient.
 
@@ -503,7 +503,7 @@ async def get_valid_tools(tool_ids: list[str], registry: AgentrRegistry) -> tupl
             start = text.find(":") + 1
             end = text.find(". R", start)
             url = text[start:end].strip()
-            markdown_link = f"![Connect to {app.capitalize()}]({url})"
+            markdown_link = f"[Connect to {app.capitalize()}]({url})"
             unconnected_links.append(markdown_link)
         for tool_id, tool_name in tool_entries:
             if tool_name in available:

{universal_mcp_agents-0.1.23rc11 → universal_mcp_agents-0.1.24rc1}/src/universal_mcp/agents/codeact0/utils.py

@@ -29,6 +29,7 @@ def build_anthropic_cache_message(text: str, role: str = "system", ttl: str = "1
         }
     ]
 
+
 def strip_thinking(messages: list[BaseMessage]):
     """Remove Anthropic 'thinking' segments from the most recent AIMessage in-place.
 

{universal_mcp_agents-0.1.23rc11 → universal_mcp_agents-0.1.24rc1}/src/universal_mcp/agents/llm.py

@@ -9,7 +9,11 @@ from loguru import logger
 
 @lru_cache(maxsize=8)
 def load_chat_model(
-    fully_specified_name: str, temperature: float = 1.0, tags: tuple[str, ...] | None = None, thinking: bool = True, disable_streaming: bool = False
+    fully_specified_name: str,
+    temperature: float = 1.0,
+    tags: tuple[str, ...] | None = None,
+    thinking: bool = True,
+    disable_streaming: bool = False,
 ) -> BaseChatModel:
     """Load a chat model from a fully specified name.
     Args:
@@ -30,7 +34,7 @@ def load_chat_model(
             max_tokens=8096,
             tags=tags,
             stream_usage=True,
-            disable_streaming = disable_streaming
+            disable_streaming=disable_streaming,
         )  # pyright: ignore[reportCallIssue]
     elif provider == "azure":
         return AzureChatOpenAI(
@@ -40,7 +44,7 @@ def load_chat_model(
             temperature=temperature,
             tags=tags,
             stream_usage=True,
-            disable_streaming = disable_streaming
+            disable_streaming=disable_streaming,
         )
     elif provider == "gemini":
         return ChatGoogleGenerativeAI(model=model, temperature=temperature)

{universal_mcp_agents-0.1.23rc11 → universal_mcp_agents-0.1.24rc1}/src/universal_mcp/applications/llm/app.py

@@ -91,7 +91,7 @@ class LlmApp(BaseApplication):
 
         full_prompt = f"{prompt}\n\nContext:\n{context_str}\n\n"
 
-        model = load_chat_model("azure/gpt-5-mini", disable_streaming = True, tags=("quiet",))
+        model = load_chat_model("azure/gpt-5-mini", disable_streaming=True, tags=("quiet",))
         response = model.with_retry(stop_after_attempt=MAX_RETRIES).invoke(full_prompt, stream=False)
         return str(response.content)
 
@@ -158,7 +158,7 @@ class LlmApp(BaseApplication):
             reason: str = Field(..., description="The reasoning behind the classification.")
             top_class: str = Field(..., description="The class with the highest probability.")
 
-        model = load_chat_model("azure/gpt-5-mini", temperature=0, disable_streaming = True, tags=("quiet",))
+        model = load_chat_model("azure/gpt-5-mini", temperature=0, disable_streaming=True, tags=("quiet",))
         agent = create_agent(
             model=model,
             tools=[],
@@ -229,7 +229,7 @@ class LlmApp(BaseApplication):
             "Return ONLY a valid JSON object that conforms to the provided schema, with no extra text."
         )
 
-        model = load_chat_model("azure/gpt-5-mini", temperature=0, disable_streaming = True, tags=("quiet",))
+        model = load_chat_model("azure/gpt-5-mini", temperature=0, disable_streaming=True, tags=("quiet",))
 
         response = (
             model.with_structured_output(schema=output_schema, method="json_mode")
@@ -282,7 +282,7 @@ class LlmApp(BaseApplication):
 
         prompt = f"{task_instructions}\n\nContext:\n{context_str}\n\nReturn ONLY a valid JSON object, no extra text."
 
-        model = load_chat_model("azure/gpt-5-mini", temperature=0, disable_streaming = True, tags=("quiet",))
+        model = load_chat_model("azure/gpt-5-mini", temperature=0, disable_streaming=True, tags=("quiet",))
 
         agent = create_agent(
             model=model,

{universal_mcp_agents-0.1.23rc11 → universal_mcp_agents-0.1.24rc1}/uv.lock

@@ -4902,7 +4902,7 @@ wheels = [
 
 [[package]]
 name = "universal-mcp-agents"
-version = "0.1.23rc10"
+version = "0.1.23"
 source = { editable = "." }
 dependencies = [
     { name = "cloudpickle" },