meshagent-agents 0.5.15__tar.gz → 0.6.0__tar.gz

{meshagent_agents-0.5.15 → meshagent_agents-0.6.0}/CHANGELOG.md

@@ -1,3 +1,18 @@
+## [0.6.0]
+- Stability
+
+## [0.5.19]
+- Stability
+
+## [0.5.18]
+- Stability
+
+## [0.5.17]
+- Stability
+
+## [0.5.16]
+- Stability
+
 ## [0.5.15]
 - Stability
 

{meshagent_agents-0.5.15/meshagent_agents.egg-info → meshagent_agents-0.6.0}/PKG-INFO

@@ -1,30 +1,30 @@
 Metadata-Version: 2.4
 Name: meshagent-agents
-Version: 0.5.15
+Version: 0.6.0
 Summary: Agent Building Blocks for Meshagent
 License-Expression: Apache-2.0
 Project-URL: Documentation, https://docs.meshagent.com
 Project-URL: Website, https://www.meshagent.com
 Project-URL: Source, https://www.meshagent.com
-Requires-Python: >=3.12
+Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pyjwt~=2.10
 Requires-Dist: pytest~=8.4
 Requires-Dist: pytest-asyncio~=0.26
-Requires-Dist: meshagent-api~=0.5.15
-Requires-Dist: meshagent-tools~=0.5.15
-Requires-Dist: meshagent-openai~=0.5.15
+Requires-Dist: meshagent-api~=0.6.0
+Requires-Dist: meshagent-tools~=0.6.0
+Requires-Dist: meshagent-openai~=0.6.0
 Requires-Dist: pydantic~=2.11
 Requires-Dist: opentelemetry-distro~=0.54b1
 Provides-Extra: all
-Requires-Dist: meshagent-api[all]~=0.5.15; extra == "all"
+Requires-Dist: meshagent-api[all]~=0.6.0; extra == "all"
 Requires-Dist: chonkie~=0.5.1; extra == "all"
 Requires-Dist: chonkie[semantic]~=0.5.1; extra == "all"
 Requires-Dist: chonkie[openai]~=0.5.1; extra == "all"
 Requires-Dist: aiosmtplib~=4.0.1; extra == "all"
 Provides-Extra: sync
-Requires-Dist: meshagent-api[sync]~=0.5.15; extra == "sync"
+Requires-Dist: meshagent-api[sync]~=0.6.0; extra == "sync"
 Provides-Extra: mail
 Requires-Dist: aiosmtplib~=4.0.1; extra == "mail"
 Provides-Extra: rag
@@ -54,7 +54,7 @@ The ``TaskRunner`` agent is useful when you want to invoke an agent with a well-
 The ``Worker`` is a queue-based ``SingleRoomAgent`` that processes queued messages with an LLM and optional tools. This is particularly helpful for running asynchronous jobs. With the ``Worker`` agent you can create a set of tasks that need to run in a Room and the ``Worker`` will execute all of the tasks in the queue. 
 
 ### ChatBot
-The ``ChatBot`` is a conversational agent derived from the ``SingleRoomAgent``. It wires an LLMAdapter, optoinal tools, and manages chat threads for each user. This means multiple users can be in the same room interacting with a chat agent, but each user will have private messages with the agent. Check out the [Build and Deploy a Chat Agent](https://docs.meshagent.com/agents/standard/buildanddeploychatbot) example to learn how to create a simple Chat Agent without tools then add built-in MeshAgent tools and custom tools to the agent.
+The ``ChatBot`` is a conversational agent derived from the ``SingleRoomAgent``. It wires an LLMAdapter, optoinal tools, and manages chat threads for each user. This means multiple users can be in the same room interacting with a chat agent, but each user will have private messages with the agent. Check out the [Build a Chat Agent](https://docs.meshagent.com/agents/standard/buildanddeploychatbot) example to learn how to create a simple Chat Agent without tools then add built-in MeshAgent tools and custom tools to the agent.
 
 ---
 ### Learn more about MeshAgent on our website or check out the docs for additional examples!

{meshagent_agents-0.5.15 → meshagent_agents-0.6.0}/README.md

@@ -19,7 +19,7 @@ The ``TaskRunner`` agent is useful when you want to invoke an agent with a well-
 The ``Worker`` is a queue-based ``SingleRoomAgent`` that processes queued messages with an LLM and optional tools. This is particularly helpful for running asynchronous jobs. With the ``Worker`` agent you can create a set of tasks that need to run in a Room and the ``Worker`` will execute all of the tasks in the queue. 
 
 ### ChatBot
-The ``ChatBot`` is a conversational agent derived from the ``SingleRoomAgent``. It wires an LLMAdapter, optoinal tools, and manages chat threads for each user. This means multiple users can be in the same room interacting with a chat agent, but each user will have private messages with the agent. Check out the [Build and Deploy a Chat Agent](https://docs.meshagent.com/agents/standard/buildanddeploychatbot) example to learn how to create a simple Chat Agent without tools then add built-in MeshAgent tools and custom tools to the agent.
+The ``ChatBot`` is a conversational agent derived from the ``SingleRoomAgent``. It wires an LLMAdapter, optoinal tools, and manages chat threads for each user. This means multiple users can be in the same room interacting with a chat agent, but each user will have private messages with the agent. Check out the [Build a Chat Agent](https://docs.meshagent.com/agents/standard/buildanddeploychatbot) example to learn how to create a simple Chat Agent without tools then add built-in MeshAgent tools and custom tools to the agent.
 
 ---
 ### Learn more about MeshAgent on our website or check out the docs for additional examples!

{meshagent_agents-0.5.15 → meshagent_agents-0.6.0}/meshagent/agents/__init__.py

@@ -8,7 +8,6 @@ from .agent import (
 )
 from .development import connect_development_agent
 from .listener import Listener, ListenerContext
-from .hosting import RemoteTaskRunnerServer
 from .adapter import ToolResponseAdapter, LLMAdapter
 from .thread_schema import thread_schema
 from .version import __version__
@@ -24,7 +23,6 @@ __all__ = [
     connect_development_agent,
     Listener,
     ListenerContext,
-    RemoteTaskRunnerServer,
     ToolResponseAdapter,
     LLMAdapter,
     thread_schema,

{meshagent_agents-0.5.15 → meshagent_agents-0.6.0}/meshagent/agents/adapter.py

@@ -1,11 +1,11 @@
 from abc import ABC, abstractmethod
 from .agent import AgentChatContext
 from jsonschema import validate
-from meshagent.tools.toolkit import Response, Toolkit
-from meshagent.api import RoomClient
+from meshagent.tools import Response, Toolkit, ToolkitBuilder, ToolkitConfig
+from meshagent.api import RoomClient, RoomException, RemoteParticipant
 from typing import Any, Optional, Callable, TypeVar, Generic
 
-T = TypeVar("T")
+TEvent = TypeVar("T")
 
 
 class ToolResponseAdapter(ABC):
@@ -28,7 +28,10 @@ class ToolResponseAdapter(ABC):
         pass
 
 
-class LLMAdapter(Generic[T]):
+class LLMAdapter(Generic[TEvent]):
+    @abstractmethod
+    def default_model(self) -> str: ...
+
     def create_chat_context(self) -> AgentChatContext:
         return AgentChatContext()
 
@@ -38,6 +41,18 @@ class LLMAdapter(Generic[T]):
     ):
         return True
 
+    def tool_providers(self, *, model: str) -> list[ToolkitBuilder]:
+        return []
+
+    def make_toolkit(self, *, model: str, config: ToolkitConfig) -> Toolkit:
+        for tool in self.tool_providers(model=model):
+            if tool.name == config.name:
+                return Toolkit(
+                    name=config.name, tools=[tool.make(model=model, config=config)]
+                )
+
+        raise RoomException(f"Unexpected tool: {config.name} for model {model}")
+
     @abstractmethod
     async def next(
         self,
@@ -47,7 +62,9 @@ class LLMAdapter(Generic[T]):
         toolkits: list[Toolkit],
         tool_adapter: Optional[ToolResponseAdapter] = None,
         output_schema: Optional[dict] = None,
-        event_handler: Optional[Callable[[T], None]] = None,
+        event_handler: Optional[Callable[[TEvent], None]] = None,
+        model: Optional[str] = None,
+        on_behalf_of: Optional[RemoteParticipant] = None,
     ) -> Any:
         pass
 

{meshagent_agents-0.5.15 → meshagent_agents-0.6.0}/meshagent/agents/agent.py

@@ -12,16 +12,13 @@ from meshagent.api import (
     ToolkitDescription,
     Participant,
     RemoteParticipant,
-    meshagent_base_url,
     StorageEntry,
 )
 from meshagent.api.protocol import Protocol
-from meshagent.tools.toolkit import (
+from meshagent.tools import (
     Toolkit,
     Tool,
     ToolContext,
-    toolkit_factory,
-    register_toolkit_factory,
 )
 from meshagent.api.room_server_client import RoomClient
 from jsonschema import validate
@@ -194,12 +191,10 @@ class SingleRoomAgent(Agent):
 
         installed = False
 
+        builtin_agents_url = "http://localhost:8080"
+
         for requirement in self.requires:
             if isinstance(requirement, RequiredToolkit):
-                if toolkit_factory(requirement.name) is not None:
-                    # no need to install something we can create from a factory
-                    continue
-
                 if requirement.name == "ui":
                     # TODO: maybe requirements can be marked as non installable?
                     continue
@@ -207,12 +202,14 @@ class SingleRoomAgent(Agent):
                 if requirement.name not in toolkits_by_name:
                     installed = True
 
-                    logger.info(f"Installing required tool {requirement.name}")
+                    logger.info(f"calling required tool into room {requirement.name}")
 
-                    if requirement.name.startswith("https://"):
+                    if requirement.name.startswith(
+                        "https://"
+                    ) or requirement.name.startswith("http://"):
                         url = requirement.name
                     else:
-                        url = f"{meshagent_base_url()}/toolkits/{requirement.name}"
+                        url = f"{builtin_agents_url}/toolkits/{requirement.name}"
 
                     await self._room.agents.make_call(
                         url=url, name=requirement.name, arguments={}
@@ -224,10 +221,12 @@ class SingleRoomAgent(Agent):
 
                     logger.info(f"Installing required schema {requirement.name}")
 
-                    if requirement.name.startswith("https://"):
+                    if requirement.name.startswith(
+                        "https://"
+                    ) or requirement.name.startswith("http://"):
                         url = requirement.name
                     else:
-                        url = f"{meshagent_base_url()}/schemas/{requirement.name}"
+                        url = f"{builtin_agents_url}/schemas/{requirement.name}"
 
                     await self._room.agents.make_call(
                         url=url, name=requirement.name, arguments={}
@@ -239,7 +238,9 @@ class SingleRoomAgent(Agent):
         if installed:
             await asyncio.sleep(5)
 
-    async def get_required_toolkits(self, context: ToolContext) -> list[Toolkit]:
+    async def get_toolkits(
+        self, context: ToolContext, remote_toolkits: list[RequiredToolkit]
+    ):
         tool_target = context.caller
         if context.on_behalf_of is not None:
             tool_target = context.on_behalf_of
@@ -255,20 +256,18 @@ class SingleRoomAgent(Agent):
         for toolkit_description in visible_tools:
             toolkits_by_name[toolkit_description.name] = toolkit_description
 
-        for required_toolkit in self.requires:
+        for required_toolkit in remote_toolkits:
             if isinstance(required_toolkit, RequiredToolkit):
-                if toolkit_factory(required_toolkit.name) is not None:
-                    toolkit = await toolkit_factory(required_toolkit.name)(
-                        context, required_toolkit
-                    )
-                    toolkits.append(toolkit)
-                    continue
-
                 toolkit = toolkits_by_name.get(required_toolkit.name, None)
                 if toolkit is None:
-                    raise RoomException(
-                        f"unable to locate required toolkit {required_toolkit.name}"
-                    )
+                    if context.on_behalf_of is not None:
+                        raise RoomException(
+                            f"unable to get toolkit {required_toolkit.name} on behalf of {context.on_behalf_of}"
+                        )
+                    else:
+                        raise RoomException(
+                            f"unable to get toolkit {required_toolkit.name} for caller {context.caller.id}"
+                        )
 
                 room_tools = list[RoomTool]()
 
@@ -296,7 +295,7 @@ class SingleRoomAgent(Agent):
                         tool_description = tools_by_name.get(required_tool, None)
                         if tool_description is None:
                             raise RoomException(
-                                f"unable to locate required tool {required_tool}"
+                                f"unable to locate required tool {required_tool} in toolkit {required_toolkit.name}"
                             )
 
                         tool = RoomTool(
@@ -324,6 +323,9 @@ class SingleRoomAgent(Agent):
 
         return toolkits
 
+    async def get_required_toolkits(self, context: ToolContext) -> list[Toolkit]:
+        return await self.get_toolkits(context, self.requires)
+
 
 class TaskRunner(SingleRoomAgent):
     def __init__(
@@ -624,6 +626,3 @@ async def make_run_task_tool(context: ToolContext, toolkit: RequiredToolkit):
         )
 
     return Toolkit(name="agents", tools=tools)
-
-
-register_toolkit_factory("agents", make_run_task_tool)