universal-mcp-agents 0.1.23__py3-none-any.whl → 0.1.24rc3__py3-none-any.whl

universal_mcp/agents/codeact01/__main__.py

@@ -0,0 +1,26 @@
+import asyncio
+
+from langgraph.checkpoint.memory import MemorySaver
+from rich import print
+from universal_mcp.agentr.registry import AgentrRegistry
+
+from universal_mcp.agents.codeact01.agent import CodeActPlaybookAgent
+from universal_mcp.agents.utils import messages_to_list
+
+
+async def main():
+    memory = MemorySaver()
+    agent = CodeActPlaybookAgent(
+        name="CodeAct Agent",
+        instructions="Be very concise in your answers.",
+        model="azure/gpt-4.1",
+        registry=AgentrRegistry(),
+        memory=memory,
+    )
+    print("Starting agent...")
+    result = await agent.invoke(user_input="Check my google calendar and show my todays agenda")
+    print(messages_to_list(result["messages"]))
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

universal_mcp/agents/codeact01/agent.py

@@ -0,0 +1,413 @@
+import copy
+import json
+import re
+import uuid
+from typing import Literal, cast
+
+from langchain_anthropic import ChatAnthropic
+from langchain_core.messages import AIMessage, HumanMessage, ToolMessage
+from langgraph.checkpoint.base import BaseCheckpointSaver
+from langgraph.graph import START, StateGraph
+from langgraph.types import Command, RetryPolicy, StreamWriter
+from universal_mcp.tools.registry import ToolRegistry
+from universal_mcp.types import ToolFormat
+
+from universal_mcp.agents.base import BaseAgent
+from universal_mcp.agents.codeact01.llm_tool import smart_print
+from universal_mcp.agents.codeact01.prompts import (
+    AGENT_BUILDER_GENERATING_PROMPT,
+    AGENT_BUILDER_META_PROMPT,
+    AGENT_BUILDER_PLANNING_PROMPT,
+    build_tool_definitions,
+    create_default_prompt,
+)
+from universal_mcp.agents.codeact01.sandbox import eval_unsafe, execute_ipython_cell, handle_execute_ipython_cell
+from universal_mcp.agents.codeact01.state import AgentBuilderCode, AgentBuilderMeta, AgentBuilderPlan, CodeActState
+from universal_mcp.agents.codeact01.tools import (
+    create_agent_builder_tools,
+    create_meta_tools,
+    enter_agent_builder_mode,
+)
+from universal_mcp.agents.codeact01.utils import build_anthropic_cache_message, extract_plan_parameters, get_connected_apps_string, strip_thinking
+from universal_mcp.agents.llm import load_chat_model
+from universal_mcp.agents.utils import convert_tool_ids_to_dict, filter_retry_on, get_message_text
+
+
+class CodeActPlaybookAgent(BaseAgent):
+    def __init__(
+        self,
+        name: str,
+        instructions: str,
+        model: str,
+        memory: BaseCheckpointSaver | None = None,
+        registry: ToolRegistry | None = None,
+        agent_builder_registry: object | None = None,
+        sandbox_timeout: int = 20,
+        **kwargs,
+    ):
+        super().__init__(
+            name=name,
+            instructions=instructions,
+            model=model,
+            memory=memory,
+            **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.registry = registry
+        self.agent_builder_registry = agent_builder_registry
+        self.agent = agent_builder_registry.get_agent() if agent_builder_registry else None
+
+        self.tools_config = self.agent.tools if self.agent else {}
+        self.eval_fn = eval_unsafe
+        self.sandbox_timeout = sandbox_timeout
+        self.default_tools_config = {
+            "llm": ["generate_text", "classify_data", "extract_data", "call_llm"],
+        }
+        self.final_instructions = ""
+        self.tools_context = {}
+        self.eval_mode = kwargs.get("eval_mode", False)
+
+    async def handle_agent_save(
+        self,
+        meta_id: str,
+        agent_name: str,
+        agent_description: str,
+        python_code: str,
+        writer: StreamWriter,
+        state: CodeActState,
+        effective_previous_add_context: dict,
+    ) -> tuple[str, dict]:
+        """Handle saving agent code and updating the UI."""
+        if self.agent:
+            # Update flow: use existing name/description and do not re-generate
+            agent_name = getattr(self.agent, "name", None)
+            agent_description = getattr(self.agent, "description", None)
+            writer(
+                {
+                    "type": "custom",
+                    id: meta_id,
+                    "name": "generating",
+                    "data": {
+                        "update": True,
+                        "name": agent_name,
+                        "description": agent_description,
+                    },
+                }
+            )
+            tool_result = "Successfully updated the existing agent."
+        else:
+            # Emit intermediary UI update with created name/description
+            writer(
+                {
+                    "type": "custom",
+                    id: meta_id,
+                    "name": "generating",
+                    "data": {"update": False, "name": agent_name, "description": agent_description},
+                }
+            )
+        res_id = str(uuid.uuid4())
+
+        try:
+            if not self.agent_builder_registry:
+                raise ValueError("AgentBuilder registry is not configured")
+            
+            plan_params = extract_plan_parameters(state["plan"])
+
+            # Build instructions payload embedding the plan and function code
+            instructions_payload = {
+                "plan": state["plan"],
+                "script": python_code,
+                "params": plan_params,
+            }
+
+            # Convert tool ids list to dict
+            tool_dict = convert_tool_ids_to_dict(state["selected_tool_ids"])
+
+            res = self.agent_builder_registry.upsert_agent(
+                name=agent_name,
+                description=agent_description,
+                instructions=instructions_payload,
+                tools=tool_dict,
+            )
+            res_id = str(res.id)
+            tool_result = "Succesfully saved the agent plan and code."
+            writer(
+                {
+                    "type": "custom",
+                    id: meta_id,
+                    "name": "generating",
+                    "data": {
+                        "id": str(res.id),
+                        "update": bool(self.agent),
+                        "name": agent_name,
+                        "description": agent_description,
+                        "add_context": effective_previous_add_context,
+                    },
+                }
+            )
+        except Exception:
+            # In case of error, add the code to the exit message content
+            tool_result = f"Displaying the final saved code:\n\n{python_code}\nFinal Name: {agent_name}\nDescription: {agent_description}"
+
+        if "functions" not in effective_previous_add_context:
+            effective_previous_add_context["functions"] = []
+        effective_previous_add_context["functions"].append(python_code)
+
+        return tool_result, effective_previous_add_context, res_id
+
+    async def _build_graph(self):  # noqa: PLR0915
+        """Build the graph for the CodeAct Playbook Agent."""
+        meta_tools = create_meta_tools(self.registry)
+        agent_builder_tools = create_agent_builder_tools()
+        self.additional_tools = [
+            smart_print,
+            meta_tools["web_search"],
+            meta_tools["read_file"],
+            meta_tools["save_file"],
+            meta_tools["upload_file"],
+        ]
+
+        if self.tools_config:
+            await self.registry.load_tools(self.tools_config)  # Load provided tools
+        if self.default_tools_config:
+            await self.registry.load_tools(self.default_tools_config)  # Load default tools
+
+        async def call_model(state: CodeActState) -> Command[Literal["execute_tools"]]:
+            """This node now only ever binds the four meta-tools to the LLM."""
+            messages = build_anthropic_cache_message(self.final_instructions) + state["messages"]
+            agent_facing_tools = [
+                execute_ipython_cell,
+                # enter_agent_builder_mode,
+                agent_builder_tools["create_agent_plan"],
+                agent_builder_tools["modify_agent_plan"],
+                agent_builder_tools["save_agent_code"],
+                meta_tools["search_functions"],
+                meta_tools["load_functions"],
+            ]
+
+            if isinstance(self.model_instance, ChatAnthropic):
+                model_with_tools = self.model_instance.bind_tools(
+                    tools=agent_facing_tools,
+                    tool_choice="auto",
+                    cache_control={"type": "ephemeral", "ttl": "1h"},
+                )
+                if isinstance(messages[-1].content, str):
+                    pass
+                else:
+                    last = copy.deepcopy(messages[-1])
+                    last.content[-1]["cache_control"] = {"type": "ephemeral", "ttl": "5m"}
+                    messages[-1] = last
+            else:
+                model_with_tools = self.model_instance.bind_tools(
+                    tools=agent_facing_tools,
+                    tool_choice="auto",
+                )
+            response = cast(AIMessage, await model_with_tools.ainvoke(messages))
+            if response.tool_calls:
+                return Command(goto="execute_tools", update={"messages": [response]})
+            else:
+                return Command(update={"messages": [response], "model_with_tools": model_with_tools})
+
+        async def execute_tools(state: CodeActState, writer: StreamWriter) -> Command[Literal["call_model"]]:
+            """Execute tool calls"""
+            last_message = state["messages"][-1]
+            tool_calls = last_message.tool_calls if isinstance(last_message, AIMessage) else []
+
+            tool_messages = []
+            new_tool_ids = []
+            tool_result = ""
+            ask_user = False
+            ai_msg = ""
+            additional_kwargs = {}
+            effective_previous_add_context = state.get("add_context", {})
+            effective_existing_context = state.get("context", {})
+            plan = state.get("plan", None)
+            agent_name = state.get("agent_name", None)
+            agent_description = state.get("agent_description", None)
+            # logging.info(f"Initial new_tool_ids_for_context: {new_tool_ids_for_context}")
+
+            for tool_call in tool_calls:
+                tool_name = tool_call["name"]
+                tool_args = tool_call["args"]
+                try:
+                    if tool_name == "execute_ipython_cell":
+                        code = tool_call["args"]["snippet"]
+                        output, new_context, new_add_context = await handle_execute_ipython_cell(
+                            code,
+                            self.tools_context,  # Uses the dynamically updated context
+                            self.eval_fn,
+                            effective_previous_add_context,
+                            effective_existing_context,
+                        )
+                        effective_existing_context = new_context
+                        effective_previous_add_context = new_add_context
+                        tool_result = output
+                    elif tool_name == "load_functions":
+                        # The tool now does all the work of validation and formatting.
+                        tool_result, new_context_for_sandbox, valid_tools, unconnected_links = await meta_tools[
+                            "load_functions"
+                        ].ainvoke(tool_args)
+                        # We still need to update the sandbox context for `execute_ipython_cell`
+                        new_tool_ids.extend(valid_tools)
+                        if new_tool_ids:
+                            self.tools_context.update(new_context_for_sandbox)
+                        if unconnected_links:
+                            ask_user = True
+                            ai_msg = f"Please login to the following app(s) using the following links and let me know in order to proceed:\n {unconnected_links} "
+
+                    elif tool_name == "search_functions":
+                        tool_result = await meta_tools["search_functions"].ainvoke(tool_args)
+                    
+                    elif tool_name == "create_agent_plan":
+                        plan_id = str(uuid.uuid4())
+                        writer({"type": "custom", id: plan_id, "name": "planning", "data": {"update": False}})
+                        ask_user = True
+                        tool_result = "The user has been shown the plan. Proceed according to their next message"
+                        plan = await agent_builder_tools["create_agent_plan"].ainvoke(tool_args)
+                        writer({"type": "custom", id: plan_id, "name": "planning", "data": {"plan": plan}})
+                        additional_kwargs = {"type": "planning", "plan": plan, "update": False}
+                    elif tool_name =="modify_agent_plan":
+                        if plan is None:
+                            tool_result = "You must have an existing agent plan or created one using create_agent_plan before calling modify_agent_plan."
+                        else:
+                            plan_id = str(uuid.uuid4())
+                            writer({"type": "custom", id: plan_id, "name": "planning", "data": {"update": True}})
+                            # Apply modifications to the existing plan per docstring semantics
+                            modifications = await agent_builder_tools["modify_agent_plan"].ainvoke(tool_args)
+                            new_plan = []
+                            old_idx = 0
+                            total_old = len(plan)
+                            for step in modifications:
+                                s = step.strip() if isinstance(step, str) else ""
+                                if not s:
+                                    continue
+                                if s == "<nochange>":
+                                    if old_idx < total_old:
+                                        new_plan.append(plan[old_idx])
+                                    old_idx += 1
+                                    continue
+                                if s == "<delete>":
+                                    old_idx += 1
+                                    continue
+                                if s.startswith("<new>") and s.endswith("</new>"):
+                                    content = s[len("<new>"):-len("</new>")].strip()
+                                    if content:
+                                        new_plan.append(content)
+                                    continue
+                                if s.startswith("<modify>") and s.endswith("</modify>"):
+                                    content = s[len("<modify>"):-len("</modify>")].strip()
+                                    if content:
+                                        new_plan.append(content)
+                                    # consume the old step being modified
+                                    old_idx += 1
+                                    continue
+                                # Ignore unknown directives when modifying
+
+                            # Append any remaining old steps not explicitly addressed by modifications
+                            if old_idx < total_old:
+                                new_plan.extend(plan[old_idx:])
+
+                            plan = new_plan
+                            writer({"type": "custom", id: plan_id, "name": "planning", "data": {"plan": plan}})
+                            additional_kwargs = {"type": "planning", "plan": plan, "update": True}
+                            ask_user = True
+                            tool_result = "The user has been shown the plan. Proceed according to their next message."
+                        
+                    elif tool_name == "save_agent_code":
+                        self.meta_id = str(uuid.uuid4())
+                        writer({"type": "custom", id: self.meta_id, "name": "generating", "data": {"update": bool(self.agent)}})
+                        agent_name, agent_description, python_code = await agent_builder_tools["save_agent_code"].ainvoke(tool_args)
+                        tool_result, effective_previous_add_context, agent_id = await self.handle_agent_save(
+                            meta_id=self.meta_id,
+                            agent_name=agent_name,
+                            agent_description=agent_description,
+                            python_code=python_code,
+                            writer=writer,
+                            state=state,
+                            effective_previous_add_context=effective_previous_add_context,
+                        )
+
+                            
+                    else:
+                        raise Exception(
+                            f"Unexpected tool call: {tool_call['name']}. "
+                            "tool calls must be one of 'enter_agent_builder_mode', 'execute_ipython_cell', 'load_functions', 'search_functions', 'create_agent_plan', or 'save_agent_code'. For using functions, call them in code using 'execute_ipython_cell'."
+                        )
+
+
+
+
+                except Exception as e:
+                    tool_result = str(e)
+
+                tool_message = ToolMessage(
+                    content=json.dumps(tool_result),
+                    name=tool_call["name"],
+                    tool_call_id=tool_call["id"],
+                )
+                tool_messages.append(tool_message)
+
+            if ask_user:
+                tool_messages.append(AIMessage(content=ai_msg, additional_kwargs=additional_kwargs))
+                return Command(
+                    update={
+                        "messages": tool_messages,
+                        "selected_tool_ids": new_tool_ids,
+                        "context": effective_existing_context,
+                        "add_context": effective_previous_add_context,
+                        "agent_name": agent_name,
+                        "agent_description": agent_description,
+                        "plan": plan,
+                    }
+                )
+
+            return Command(
+                goto="call_model",
+                update={
+                    "messages": tool_messages,
+                    "selected_tool_ids": new_tool_ids,
+                    "context": effective_existing_context,
+                    "add_context": effective_previous_add_context,
+                    "agent_name": agent_name,
+                    "agent_description": agent_description,
+                    "plan": plan,
+                },
+            )
+
+        async def route_entry(state: CodeActState) -> Command[Literal["call_model", "execute_tools"]]:
+            """Route to either normal mode or agent builder creation"""
+            pre_tools = await self.registry.export_tools(format=ToolFormat.NATIVE)
+
+            # Create the initial system prompt and tools_context in one go
+            self.final_instructions, self.tools_context = create_default_prompt(
+                pre_tools,
+                self.additional_tools,
+                self.instructions,
+                await get_connected_apps_string(self.registry),
+                self.agent,
+                is_initial_prompt=True,
+            )
+            self.preloaded_defs, _ = build_tool_definitions(pre_tools)
+            self.preloaded_defs = "\n".join(self.preloaded_defs)
+            await self.registry.load_tools(state["selected_tool_ids"])
+            exported_tools = await self.registry.export_tools(
+                state["selected_tool_ids"], ToolFormat.NATIVE
+            )  # Get definition for only the new tools
+            _, loaded_tools_context = build_tool_definitions(exported_tools)
+            self.tools_context.update(loaded_tools_context)
+
+            if (
+                len(state["messages"]) == 1 and self.agent
+            ):  # Inject the agent's script function into add_context for execution
+                script = self.agent.instructions.get("script")
+                add_context = {"functions": [script]}
+                return Command(goto="call_model", update={"add_context": add_context})
+            return Command(goto="call_model")
+
+        agent = StateGraph(state_schema=CodeActState)
+        agent.add_node(call_model, retry_policy=RetryPolicy(max_attempts=3, retry_on=filter_retry_on))
+        agent.add_node(execute_tools)
+        agent.add_node(route_entry)
+        agent.add_edge(START, "route_entry")
+        return agent.compile(checkpointer=self.memory)

universal_mcp/agents/codeact01/config.py

@@ -0,0 +1,77 @@
+from typing import Annotated, Literal
+
+from pydantic import BaseModel, Field
+
+# Literal type for all available usecase filenames
+UseCaseName = Literal[
+    " ",
+    "1-unsubscribe",
+    "2-reddit",
+    "2.1-reddit",
+    "3-earnings",
+    "4-maps",
+    "4.1-maps",
+    "5-gmailreply",
+    "6-contract",
+    "7-overnight",
+    "8-sheets_chart",
+    "9-learning",
+    "10-reddit2",
+    "11-github",
+]
+
+
+class ContextSchema(BaseModel):
+    """The configuration for the agent."""
+
+    base_prompt: str = Field(
+        default=" ",
+        description="The base prompt to use for the agent's interactions. Leave blank if using a JSON prompt from the dropdown.",
+    )
+    model_provider: Annotated[
+        Literal[
+            "openai",
+            "anthropic",
+            "azure_openai",
+            "azure_ai",
+            "google_vertexai",
+            "google_genai",
+            "bedrock",
+            "bedrock_converse",
+            "cohere",
+            "fireworks",
+            "together",
+            "mistralai",
+            "huggingface",
+            "groq",
+            "ollama",
+            "google_anthropic_vertex",
+            "deepseek",
+            "ibm",
+            "nvidia",
+            "xai",
+            "perplexity",
+        ],
+        {"__template_metadata__": {"kind": "provider"}},
+    ] = Field(
+        default="anthropic",
+        description="The name of the model provider to use for the agent's main interactions. ",
+    )
+    model: Annotated[
+        Literal[
+            "claude-4-sonnet-20250514",
+            "claude-sonnet-4@20250514",
+        ],
+        {"__template_metadata__": {"kind": "llm"}},
+    ] = Field(
+        default="claude-4-sonnet-20250514",
+        description="The name of the language model to use for the agent's main interactions. ",
+    )
+    tool_names: list[str] = Field(
+        default=[],
+        description="The names of the tools to use for the agent's main interactions. Leave blank if using a JSON prompt from the dropdown.",
+    )
+    json_prompt_name: UseCaseName = Field(
+        default=" ",
+        description="The name of the JSON prompt to use for the agent's main interactions, instead of providing a base prompt and tool names. ",
+    )

universal_mcp/agents/codeact01/langgraph_agent.py

@@ -0,0 +1,14 @@
+from universal_mcp.agentr.registry import AgentrRegistry
+
+from universal_mcp.agents.codeact01 import CodeActPlaybookAgent
+
+
+async def agent():
+    agent_obj = CodeActPlaybookAgent(
+        name="CodeAct Agent",
+        instructions="Be very concise in your answers.",
+        model="anthropic:claude-4-sonnet-20250514",
+        tools=[],
+        registry=AgentrRegistry(),
+    )
+    return await agent_obj._build_graph()

universal_mcp/agents/codeact01/llm_tool.py

@@ -0,0 +1,25 @@
+from typing import Any
+
+from universal_mcp.agents.codeact01.utils import light_copy
+
+MAX_RETRIES = 3
+
+
+def get_context_str(source: Any | list[Any] | dict[str, Any]) -> str:
+    """Converts context to a string representation."""
+    if not isinstance(source, dict):
+        if isinstance(source, list):
+            source = {f"doc_{i + 1}": str(doc) for i, doc in enumerate(source)}
+        else:
+            source = {"content": str(source)}
+
+    return "\n".join(f"<{k}>\n{str(v)}\n</{k}>" for k, v in source.items())
+
+
+def smart_print(data: Any) -> None:
+    """Prints a dictionary or list of dictionaries with string values truncated to 30 characters.
+
+    Args:
+        data: Either a dictionary with string keys, or a list of such dictionaries
+    """
+    print(light_copy(data))  # noqa: T201