universal-mcp 0.1.24rc14__py3-none-any.whl → 0.1.24rc17__py3-none-any.whl

universal_mcp/agents/bigtool2/graph.py

@@ -1,169 +0,0 @@
-import json
-from datetime import UTC, datetime
-from typing import Literal, TypedDict, cast
-
-from langchain_anthropic import ChatAnthropic
-from langchain_core.language_models import BaseChatModel
-from langchain_core.messages import AIMessage, ToolMessage
-from langchain_core.tools import tool
-from langgraph.graph import StateGraph
-from langgraph.runtime import Runtime
-from langgraph.types import Command
-
-from universal_mcp.agents.bigtool2.context import Context
-from universal_mcp.agents.bigtool2.state import State
-from universal_mcp.logger import logger
-from universal_mcp.tools.registry import ToolRegistry
-from universal_mcp.types import ToolFormat
-
-
-
-def build_graph(
-    tool_registry: ToolRegistry,
-    llm: BaseChatModel
-):
-    @tool
-    async def search_tools(queries: list[str]) -> str:
-        """Search tools for a given list of queries
-        Each single query should be atomic (doable with a single tool).
-        For tasks requiring multiple tools, add separate queries for each subtask"""
-        logger.info(f"Searching tools for queries: '{queries}'")
-        try:
-            all_tool_candidates = ""
-            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_tools = {}
-            for task_query in queries:
-                tools_list = await tool_registry.search_tools(task_query, limit=40)
-                tool_candidates = [f"{tool['id']}: {tool['description']}" for tool in tools_list]
-                for tool in tool_candidates:
-                    app = tool.split("__")[0]
-                    if app not in app_tools:
-                        if len(app_tools.keys()) >= 10:
-                            break
-                        app_tools[app] = []
-                    if len(app_tools[app]) < 3:
-                        app_tools[app].append(tool)
-            for app in app_tools:
-                app_status = "connected" if app in connected_apps else "NOT connected"
-                all_tool_candidates += f"Tools from {app} (status: {app_status} by user):\n"
-                for tool in app_tools[app]:
-                    all_tool_candidates += f" - {tool}\n"
-                all_tool_candidates += "\n"
-                
-            
-            return all_tool_candidates
-        except Exception as e:
-            logger.error(f"Error retrieving tools: {e}")
-            return "Error: " + str(e)
-    
-    @tool
-    async def load_tools(tool_ids: list[str]) -> list[str]:
-        """Load the tools for the given tool ids. Returns the tool ids."""
-        return tool_ids
-
-
-    async def call_model(state: State, runtime: Runtime[Context]) -> Command[Literal["select_tools", "call_tools"]]:
-        logger.info("Calling model...")
-        try:
-            system_message = runtime.context.system_prompt.format(system_time=datetime.now(tz=UTC).isoformat())
-            messages = [{"role": "system", "content": system_message}, *state["messages"]]
-
-            logger.info(f"Selected tool IDs: {state['selected_tool_ids']}")
-            if len(state["selected_tool_ids"]) > 0:
-                selected_tools = await tool_registry.export_tools(tools=state["selected_tool_ids"], format=ToolFormat.LANGCHAIN)
-                logger.info(f"Exported {len(selected_tools)} tools for model.")
-            else:
-                selected_tools = []
-
-            model = llm
-
-            model_with_tools = model.bind_tools([search_tools, load_tools, *selected_tools], tool_choice="auto")
-            response = cast(AIMessage, await model_with_tools.ainvoke(messages))
-
-            if response.tool_calls:
-                logger.info(f"Model responded with {len(response.tool_calls)} tool calls.")
-                if len(response.tool_calls) > 1:
-                    raise Exception("Not possible in Claude with llm.bind_tools(tools=tools, tool_choice='auto')")
-                tool_call = response.tool_calls[0]
-                if tool_call["name"] == search_tools.name:
-                    logger.info("Model requested to select tools.")
-                    return Command(goto="select_tools", update={"messages": [response]})
-                elif tool_call["name"] == load_tools.name:
-                    logger.info("Model requested to load tools.")
-                    tool_msg = ToolMessage(f"Loaded tools.", tool_call_id=tool_call["id"])
-                    selected_tool_ids = tool_call["args"]["tool_ids"]
-                    logger.info(f"Loaded tools: {selected_tool_ids}")
-                    return Command(goto="call_model", update={ "messages": [response, tool_msg], "selected_tool_ids": selected_tool_ids})
-
-                elif tool_call["name"] not in state["selected_tool_ids"]:
-                    try:
-                        await tool_registry.export_tools([tool_call["name"]], ToolFormat.LANGCHAIN)
-                        logger.info(
-                            f"Tool '{tool_call['name']}' not in selected tools, but available. Proceeding to call."
-                        )
-                        return Command(goto="call_tools", update={"messages": [response]})
-                    except Exception as e:
-                        logger.error(f"Unexpected tool call: {tool_call['name']}. Error: {e}")
-                        raise Exception(
-                            f"Unexpected tool call: {tool_call['name']}. Available tools: {state['selected_tool_ids']}"
-                        ) from e
-                logger.info(f"Proceeding to call tool: {tool_call['name']}")
-                return Command(goto="call_tools", update={"messages": [response]})
-            else:
-                logger.info("Model responded with a message, ending execution.")
-                return Command(update={"messages": [response]})
-        except Exception as e:
-            logger.error(f"Error in call_model: {e}")
-            raise
-
-    async def select_tools(state: State, runtime: Runtime[Context]) -> Command[Literal["call_model"]]:
-        logger.info("Selecting tools...")
-        try:
-            tool_call = state["messages"][-1].tool_calls[0]
-            searched_tools= await search_tools.ainvoke(input=tool_call["args"])
-            tool_msg = ToolMessage(f"Available tools: {searched_tools}", tool_call_id=tool_call["id"])
-            return Command(goto="call_model", update={"messages": [tool_msg]})
-        except Exception as e:
-            logger.error(f"Error in select_tools: {e}")
-            raise
-
-    async def call_tools(state: State) -> Command[Literal["call_model"]]:
-        logger.info("Calling tools...")
-        outputs = []
-        recent_tool_ids = []
-        for tool_call in state["messages"][-1].tool_calls:
-            logger.info(f"Executing tool: {tool_call['name']} with args: {tool_call['args']}")
-            try:
-                await tool_registry.export_tools([tool_call["name"]], ToolFormat.LANGCHAIN)
-                tool_result = await tool_registry.call_tool(tool_call["name"], tool_call["args"])
-                logger.info(f"Tool '{tool_call['name']}' executed successfully.")
-                outputs.append(
-                    ToolMessage(
-                        content=json.dumps(tool_result),
-                        name=tool_call["name"],
-                        tool_call_id=tool_call["id"],
-                    )
-                )
-                recent_tool_ids.append(tool_call["name"])
-            except Exception as e:
-                logger.error(f"Error executing tool '{tool_call['name']}': {e}")
-                outputs.append(
-                    ToolMessage(
-                        content=json.dumps("Error: " + str(e)),
-                        name=tool_call["name"],
-                        tool_call_id=tool_call["id"],
-                    )
-                )
-        return Command(goto="call_model", update={"messages": outputs, "selected_tool_ids": recent_tool_ids})
-
-    builder = StateGraph(State, context_schema=Context)
-
-    builder.add_node(call_model)
-    builder.add_node(select_tools)
-    builder.add_node(call_tools)
-    builder.set_entry_point("call_model")
-    return builder

universal_mcp/agents/bigtool2/prompts.py

@@ -1,12 +0,0 @@
-"""Default prompts used by the agent."""
-
-SYSTEM_PROMPT = """You are a helpful AI assistant.
-
-**Core Directives:**
-1.  **Always Use Tools for Tasks:** For any user request that requires an action (e.g., sending an email, searching for information, creating an event), you MUST use a tool. Do not answer from your own knowledge or refuse a task if a tool might exist for it.
-2.  **First Step is ALWAYS `search_tools`:** Before you can use any other tool, you MUST first call the `search_tools` function to find the right tools for the user's request. This is your mandatory first action. You must not use the same/similar query multiple times in the list. The list should have multiple queries only if the task has clearly different sub-tasks.
-3.  **Load Tools:** After looking at the output of `search_tools`, you MUST call the `load_tools` function to load only the tools you want to use. Use your judgement to eliminate irrelevant apps that came up just because of semantic similarity. However, sometimes, multiple apps might be relevant for the same task. 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. The tool will return a link for connecting that you should pass on to the user.
-3.  **Strictly Follow the Process:** Your only job in your first turn is to analyze the user's request and call `search_tools` with a concise query describing the core task. Do not engage in conversation.
-
-System time: {system_time}
-"""

universal_mcp/agents/bigtool2/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/builder.py

@@ -1,80 +0,0 @@
-import asyncio
-from collections.abc import Sequence
-from typing import Annotated, TypedDict
-
-from langchain_core.language_models import BaseChatModel
-from langchain_core.messages import BaseMessage
-from langgraph.checkpoint.base import BaseCheckpointSaver
-from langgraph.graph import END, START, StateGraph
-from langgraph.graph.message import add_messages
-
-from universal_mcp.agents.base import BaseAgent
-from universal_mcp.agents.llm import load_chat_model
-from universal_mcp.agents.shared.agent_node import Agent, generate_agent
-from universal_mcp.agents.shared.tool_node import build_tool_node_graph
-from universal_mcp.tools.registry import ToolRegistry
-from universal_mcp.types import ToolConfig
-
-
-class BuilderState(TypedDict):
-    messages: Annotated[Sequence[BaseMessage], add_messages]
-    generated_agent: Agent | None
-    tool_config: ToolConfig | None
-
-
-class BuilderAgent(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: BaseChatModel = load_chat_model(model)
-
-    async def _create_agent(self, state: BuilderState):
-        last_message = state["messages"][-1]
-        generated_agent = await generate_agent(self.llm, last_message.content)
-        return {"generated_agent": generated_agent}
-
-    async def _create_tool_config(self, state: BuilderState):
-        last_message = state["messages"][-1]
-        tool_finder_graph = build_tool_node_graph(self.llm, self.registry)
-        tool_config = await tool_finder_graph.ainvoke({"task": last_message.content, "messages": [last_message]})
-        tool_config = tool_config.get("apps_with_tools", {})
-        return {"tool_config": tool_config}
-
-    async def _build_graph(self):
-        builder = StateGraph(BuilderState)
-        builder.add_node("create_agent", self._create_agent)
-        builder.add_node("create_tool_config", self._create_tool_config)
-        builder.add_edge(START, "create_agent")
-        builder.add_edge("create_agent", "create_tool_config")
-        builder.add_edge("create_tool_config", END)
-        return builder.compile()
-
-
-async def main():
-    from universal_mcp.agentr.registry import AgentrRegistry
-
-    registry = AgentrRegistry()
-    agent = BuilderAgent(
-        name="Builder Agent",
-        instructions="You are a builder agent that creates other agents.",
-        model="gemini/gemini-1.5-pro",
-        registry=registry,
-    )
-    result = await agent.invoke(
-        "Send a daily email to manoj@agentr.dev with daily agenda of the day",
-    )
-    print(result.model_dump_json(indent=2))
-    # print(f"Agent: {result['generated_agent'].model_dump_json(indent=2)}")
-    # print(f"Tool Config: {result['tool_config'].model_dump_json(indent=2)}")
-
-
-if __name__ == "__main__":
-    asyncio.run(main())

universal_mcp/agents/cli.py

@@ -1,27 +0,0 @@
-from typer import Typer
-
-from universal_mcp.agents import ReactAgent
-from universal_mcp.logger import setup_logger
-
-app = Typer()
-
-
-@app.command(
-    help="Run the agent CLI",
-    epilog="""
-    Example:
-    mcp client run --config client_config.json
-    """,
-)
-def run():
-    """Run the agent CLI"""
-    import asyncio
-
-    setup_logger(log_file=None, level="WARNING")
-
-    agent = ReactAgent("React Agent", "You are a helpful assistant", "openrouter/auto")
-    asyncio.run(agent.run_interactive())
-
-
-if __name__ == "__main__":
-    app()

universal_mcp/agents/codeact/__init__.py

@@ -1,243 +0,0 @@
-import inspect
-import re
-from collections.abc import Awaitable, Callable, Sequence
-from typing import Any, TypeVar
-
-from langchain_core.language_models import BaseChatModel
-from langchain_core.tools import StructuredTool
-from langchain_core.tools import tool as create_tool
-from langgraph.graph import END, START, MessagesState, StateGraph
-from langgraph.types import Command
-
-from .utils import extract_and_combine_codeblocks
-
-EvalFunction = Callable[[str, dict[str, Any]], tuple[str, dict[str, Any]]]
-EvalCoroutine = Callable[[str, dict[str, Any]], Awaitable[tuple[str, dict[str, Any]]]]
-
-
-class CodeActState(MessagesState):
-    """State for CodeAct agent."""
-
-    script: str | None
-    """The Python code script to be executed."""
-    context: dict[str, Any]
-    """Dictionary containing the execution context with available tools and variables."""
-
-
-StateSchema = TypeVar("StateSchema", bound=CodeActState)
-StateSchemaType = type[StateSchema]
-
-
-def make_safe_function_name(name: str) -> str:
-    """Convert a tool name to a valid Python function name."""
-    # Replace non-alphanumeric characters with underscores
-    safe_name = re.sub(r"[^a-zA-Z0-9_]", "_", name)
-    # Ensure the name doesn't start with a digit
-    if safe_name and safe_name[0].isdigit():
-        safe_name = f"tool_{safe_name}"
-    # Handle empty name edge case
-    if not safe_name:
-        safe_name = "unnamed_tool"
-    return safe_name
-
-
-def create_default_prompt(tools: list[StructuredTool], base_prompt: str | None = None):
-    """Create default prompt for the CodeAct agent."""
-    tools = [t if isinstance(t, StructuredTool) else create_tool(t) for t in tools]
-    prompt = f"{base_prompt}\n\n" if base_prompt else ""
-    prompt += """You will be given a task to perform. You should output either
-- a Python code snippet that provides the solution to the task, or a step towards the solution. Any output you want to extract from the code should be printed to the console. Code should be output in a fenced code block.
-- text to be shown directly to the user, if you want to ask for more information or provide the final answer.
-
-In addition to the Python Standard Library, you can use the following functions:
-"""
-
-    for tool in tools:
-        # Use coroutine if it exists, otherwise use func
-        tool_callable = tool.coroutine if hasattr(tool, "coroutine") and tool.coroutine is not None else tool.func
-        # Create a safe function name
-        safe_name = make_safe_function_name(tool.name)
-        # Determine if it's an async function
-        is_async = inspect.iscoroutinefunction(tool_callable)
-        # Add appropriate function definition
-        prompt += f'''
-{"async " if is_async else ""}def {safe_name}{str(inspect.signature(tool_callable))}:
-    """{tool.description}"""
-    ...
-'''
-
-    prompt += """
-
-Variables defined at the top level of previous code snippets can be referenced in your code.
-
-Reminder: use Python code snippets to call tools"""
-    return prompt
-
-
-def create_codeact(
-    model: BaseChatModel,
-    tools: Sequence[StructuredTool | Callable],
-    eval_fn: EvalFunction | EvalCoroutine,
-    *,
-    prompt: str | None = None,
-    reflection_prompt: str | None = None,
-    reflection_model: BaseChatModel | None = None,
-    max_reflections: int = 3,
-    state_schema: StateSchemaType = CodeActState,
-) -> StateGraph:
-    """Create a CodeAct agent.
-
-    Args:
-        model: The language model to use for generating code
-        tools: List of tools available to the agent. Can be passed as python functions or StructuredTool instances.
-        eval_fn: Function or coroutine that executes code in a sandbox. Takes code string and locals dict,
-            returns a tuple of (stdout output, new variables dict)
-        prompt: Optional custom system prompt. If None, uses default prompt.
-            To customize default prompt you can use `create_default_prompt` helper:
-            `create_default_prompt(tools, "You are a helpful assistant.")`
-        reflection_prompt: Optional prompt for reflection. If provided, will be used to evaluate responses.
-            If the reflection output contains "NONE", the response is considered valid, otherwise the
-            reflection output is passed back to the model for regeneration.
-        reflection_model: Optional model to use for reflection. If None, uses the same model as for generation.
-        max_reflections: Maximum number of reflection iterations (default: 3).
-        state_schema: The state schema to use for the agent.
-
-    Returns:
-        A StateGraph implementing the CodeAct architecture
-    """
-    tools = [t if isinstance(t, StructuredTool) else create_tool(t) for t in tools]
-
-    if prompt is None:
-        prompt = create_default_prompt(tools)
-
-    # If no reflection model is provided, use the main model
-    if reflection_model is None:
-        reflection_model = model
-
-    # Make tools available to the code sandbox - use safe names for keys
-    tools_context = {}
-    for tool in tools:
-        safe_name = make_safe_function_name(tool.name)
-        # Use coroutine if it exists, otherwise use func (same as in create_default_prompt)
-        tool_callable = tool.coroutine if hasattr(tool, "coroutine") and tool.coroutine is not None else tool.func
-        # Only use the safe name for consistency with the prompt
-        tools_context[safe_name] = tool_callable
-
-    def call_model(state: StateSchema) -> Command:
-        messages = [{"role": "system", "content": prompt}] + state["messages"]
-
-        # Run the model and potentially loop for reflection
-        response = model.invoke(messages)
-
-        # Extract and combine all code blocks
-        code = extract_and_combine_codeblocks(response.content)
-
-        # Loop for reflection if needed and if code is present
-        if reflection_prompt and code:
-            reflection_count = 0
-            while reflection_count < max_reflections:
-                # Format conversation history with XML-style tags
-                conversation_history = "\n".join(
-                    [
-                        f'<message role="{("user" if m.type == "human" else "assistant")}">\n{m.content}\n</message>'
-                        for m in state["messages"]
-                    ]
-                )
-
-                # Add the current response
-                conversation_history += f'\n<message role="assistant">\n{response.content}\n</message>'
-
-                # Create the reflection prompt with the tagged conversation history
-                formatted_prompt = f"""
-Review the assistant's latest code for as per the quality rules:
-
-<conversation_history>
-{conversation_history}
-</conversation_history>
-
-If you find ANY of these issues, describe the problem briefly and clearly.
-If NO issues are found, respond with EXACTLY: "NONE"
-"""
-
-                # Create messages for reflection with correct ordering
-                reflection_messages = [
-                    {"role": "system", "content": reflection_prompt},
-                    # Include the formatted reflection prompt as the final user message
-                    {"role": "user", "content": formatted_prompt},
-                ]
-                reflection_result = reflection_model.invoke(reflection_messages)
-
-                # Check if reflection passed
-                if "NONE" in reflection_result.content:
-                    # Reflection passed, exit loop
-                    break
-
-                # Reflection didn't pass, regenerate response
-                reflection_messages = [
-                    {"role": "system", "content": prompt},
-                    *state["messages"],
-                    {"role": "assistant", "content": response.content},
-                    {
-                        "role": "user",
-                        "content": f"""
-I need you to completely regenerate your previous response based on this feedback:
-
-'''
-{reflection_result.content}
-'''
-
-DO NOT reference the feedback directly. Instead, provide a completely new response that addresses the issues.
-""",
-                    },
-                ]
-                response = model.invoke(reflection_messages)
-
-                # Extract code from the new response
-                code = extract_and_combine_codeblocks(response.content)
-
-                # If no code in the new response, exit the reflection loop
-                if not code:
-                    break
-
-                # Increment reflection count
-                reflection_count += 1
-
-        # Return appropriate command with only the latest response
-        if code:
-            return Command(goto="sandbox", update={"messages": [response], "script": code})
-        else:
-            # no code block, end the loop and respond to the user
-            return Command(update={"messages": [response], "script": None})
-
-    # If eval_fn is a async, we define async node function.
-    if inspect.iscoroutinefunction(eval_fn):
-
-        async def sandbox(state: StateSchema):
-            existing_context = state.get("context", {})
-            context = {**existing_context, **tools_context}
-            # Execute the script in the sandbox
-            output, new_vars = await eval_fn(state["script"], context)
-            new_context = {**existing_context, **new_vars}
-            return {
-                "messages": [{"role": "user", "content": output}],
-                "context": new_context,
-            }
-    else:
-
-        def sandbox(state: StateSchema):
-            existing_context = state.get("context", {})
-            context = {**existing_context, **tools_context}
-            # Execute the script in the sandbox
-            output, new_vars = eval_fn(state["script"], context)
-            new_context = {**existing_context, **new_vars}
-            return {
-                "messages": [{"role": "user", "content": output}],
-                "context": new_context,
-            }
-
-    agent = StateGraph(state_schema)
-    agent.add_node(call_model, destinations=(END, "sandbox"))
-    agent.add_node(sandbox)
-    agent.add_edge(START, "call_model")
-    agent.add_edge("sandbox", "call_model")
-    return agent

universal_mcp/agents/codeact/sandbox.py

@@ -1,27 +0,0 @@
-import builtins
-import contextlib
-import io
-from typing import Any
-
-
-def eval_unsafe(code: str, _locals: dict[str, Any]) -> tuple[str, dict[str, Any]]:
-    # Store original keys before execution
-    original_keys = set(_locals.keys())
-    result = f"Executing code...\n{code}\n\nOutput:\n"
-    result += "=" * 50 + "\n"
-    try:
-        with contextlib.redirect_stdout(io.StringIO()) as f:
-            # Execute the code in the provided locals context
-            # Using exec to allow dynamic code execution
-            # This is a simplified version; in production, consider security implications
-            exec(code, builtins.__dict__, _locals)
-        result += f.getvalue()
-        if not result:
-            result = "<code ran, no output printed to stdout>"
-    except Exception as e:
-        result += f"Error during execution: {repr(e)}"
-
-    # Determine new variables created during execution
-    new_keys = set(_locals.keys()) - original_keys
-    new_vars = {key: _locals[key] for key in new_keys}
-    return result, new_vars

universal_mcp/agents/codeact/test.py

@@ -1,15 +0,0 @@
-from universal_mcp.agentr import Agentr
-from universal_mcp.agents.codeact import create_codeact
-from universal_mcp.agents.codeact.sandbox import eval_unsafe
-from universal_mcp.agents.llm import load_chat_model
-from universal_mcp.tools.adapters import ToolFormat
-
-model = load_chat_model("gpt-4.1")
-
-agentr = Agentr()
-agentr.load_tools(["google-mail_send_email"])
-
-tools = agentr.list_tools(format=ToolFormat.NATIVE)
-
-code_act = create_codeact(model, tools, eval_unsafe)
-agent = code_act.compile()

universal_mcp/agents/codeact/utils.py

@@ -1,61 +0,0 @@
-import re
-
-BACKTICK_PATTERN = r"(?:^|\n)```(.*?)(?:```(?:\n|$))"
-
-
-def extract_and_combine_codeblocks(text: str) -> str:
-    """
-    Extracts all codeblocks from a text string and combines them into a single code string.
-
-    Args:
-        text: A string containing zero or more codeblocks, where each codeblock is
-            surrounded by triple backticks (```).
-
-    Returns:
-        A string containing the combined code from all codeblocks, with each codeblock
-        separated by a newline.
-
-    Example:
-        text = '''Here's some code:
-
-        ```python
-        print('hello')
-        ```
-        And more:
-
-        ```
-        print('world')
-        ```'''
-
-        result = extract_and_combine_codeblocks(text)
-
-        Result:
-
-        print('hello')
-
-        print('world')
-    """
-    # Find all code blocks in the text using regex
-    # Pattern matches anything between triple backticks, with or without a language identifier
-    code_blocks = re.findall(BACKTICK_PATTERN, text, re.DOTALL)
-
-    if not code_blocks:
-        return ""
-
-    # Process each codeblock
-    processed_blocks = []
-    for block in code_blocks:
-        # Strip leading and trailing whitespace
-        block = block.strip()
-
-        # If the first line looks like a language identifier, remove it
-        lines = block.split("\n")
-        if lines and (not lines[0].strip() or " " not in lines[0].strip()):
-            # First line is empty or likely a language identifier (no spaces)
-            block = "\n".join(lines[1:])
-
-        processed_blocks.append(block)
-
-    # Combine all codeblocks with newlines between them
-    combined_code = "\n\n".join(processed_blocks)
-    return combined_code