meshagent-agents 0.0.37__py3-none-any.whl → 0.0.38__py3-none-any.whl

meshagent/agents/worker.py

@@ -1,6 +1,6 @@
 from .agent import SingleRoomAgent
 from meshagent.api.chan import Chan
-from meshagent.api import RoomMessage, RoomException, RoomClient, RemoteParticipant
+from meshagent.api import RoomMessage, RoomClient
 from meshagent.agents import AgentChatContext
 from meshagent.tools import Toolkit
 from .adapter import LLMAdapter, ToolResponseAdapter
@@ -14,7 +14,19 @@ logger = logging.getLogger("chat")
 
 
 class Worker(SingleRoomAgent):
-    def __init__(self, *, queue: str,  name, title = None, description = None, requires = None, llm_adapter: LLMAdapter, tool_adapter:  Optional[ToolResponseAdapter] = None, toolkits: Optional[list[Toolkit]] = None, rules : Optional[list[str]] = None):
+    def __init__(
+        self,
+        *,
+        queue: str,
+        name,
+        title=None,
+        description=None,
+        requires=None,
+        llm_adapter: LLMAdapter,
+        tool_adapter: Optional[ToolResponseAdapter] = None,
+        toolkits: Optional[list[Toolkit]] = None,
+        rules: Optional[list[str]] = None,
+    ):
         super().__init__(
             name=name,
             title=title,
@@ -24,7 +36,7 @@ class Worker(SingleRoomAgent):
 
         self._queue = queue
 
-        if toolkits == None:
+        if toolkits is None:
             toolkits = []
 
         self._llm_adapter = llm_adapter
@@ -32,38 +44,42 @@ class Worker(SingleRoomAgent):
 
         self._message_channel = Chan[RoomMessage]()
 
-        self._room : RoomClient | None = None
+        self._room: RoomClient | None = None
         self._toolkits = toolkits
 
-        if rules == None:
+        if rules is None:
             rules = []
 
         self._rules = rules
         self._done = False
-       
 
     async def start(self, *, room: RoomClient):
         self._done = False
 
         await super().start(room=room)
 
-        
         self._main_task = asyncio.create_task(self.run(room=room))
 
     async def stop(self):
-
         self._done = True
 
         await asyncio.gather(self._main_task)
 
         await super().stop()
 
-
-    async def append_message_context(self, *, room: RoomClient, message: dict, chat_context: AgentChatContext):
+    async def append_message_context(
+        self, *, room: RoomClient, message: dict, chat_context: AgentChatContext
+    ):
         chat_context.append_user_message(message=json.dumps(message))
-        
-    async def process_message(self, *, chat_context: AgentChatContext, room: RoomClient, message: dict, toolkits: list[Toolkit]):
 
+    async def process_message(
+        self,
+        *,
+        chat_context: AgentChatContext,
+        room: RoomClient,
+        message: dict,
+        toolkits: list[Toolkit],
+    ):
         return await self._llm_adapter.next(
             context=chat_context,
             room=room,
@@ -71,22 +87,21 @@ class Worker(SingleRoomAgent):
             tool_adapter=self._tool_adapter,
         )
 
-
     async def run(self, *, room: RoomClient):
-
         toolkits = [
-            *await self.get_required_toolkits(ToolContext(room=room, caller=room.local_participant)),
-            *self._toolkits
+            *await self.get_required_toolkits(
+                ToolContext(room=room, caller=room.local_participant)
+            ),
+            *self._toolkits,
         ]
-        
-        while not self._done:
 
-            message = await room.queues.receive(name=self._queue, create=True, wait=True)
-            if message != None:
-                
+        while not self._done:
+            message = await room.queues.receive(
+                name=self._queue, create=True, wait=True
+            )
+            if message is not None:
                 logger.info(f"received message on worker queue {message}")
                 try:
-
                     chat_context = await self.init_chat_context()
 
                     chat_context.append_rules(
@@ -94,12 +109,17 @@ class Worker(SingleRoomAgent):
                             *self._rules,
                         ]
                     )
-                    
-                    await self.append_message_context(room=room, message=message, chat_context=chat_context)
-                        
 
-                    await self.process_message(chat_context=chat_context, room=room, message=message, toolkits=toolkits)
-       
-                except Exception as e:
+                    await self.append_message_context(
+                        room=room, message=message, chat_context=chat_context
+                    )
 
+                    await self.process_message(
+                        chat_context=chat_context,
+                        room=room,
+                        message=message,
+                        toolkits=toolkits,
+                    )
+
+                except Exception as e:
                     logger.error(f"Failed to process a message {message}", exc_info=e)

meshagent/agents/writer.py

@@ -1,8 +1,9 @@
-from meshagent.agents.agent import  AgentCallContext
+from meshagent.agents.agent import AgentCallContext
 from meshagent.api.room_server_client import RoomClient
 from meshagent.api.schema_document import Document
-from meshagent.api import RoomClient, RequiredToolkit, RequiredSchema, Requirement
-#from meshagent.tools.document_tools import DocumentToolkit
+from meshagent.api import Requirement
+
+# from meshagent.tools.document_tools import DocumentToolkit
 from typing import Optional
 import asyncio
 import logging
@@ -12,32 +13,48 @@ logger = logging.getLogger("writer_agent")
 
 
 class WriterContext:
-    def __init__(self, room: RoomClient, document: Document, call_context: AgentCallContext, path: str):
+    def __init__(
+        self,
+        room: RoomClient,
+        document: Document,
+        call_context: AgentCallContext,
+        path: str,
+    ):
         self._room = room
         self._document = document
-        self._call_context = call_context 
+        self._call_context = call_context
         self._path = path
 
     @property
     def room(self) -> RoomClient:
         return self._room
-    
+
     @property
     def path(self) -> str:
         return self._path
-    
+
     @property
     def document(self) -> Document:
         return self._document
-    
+
     @property
     def call_context(self) -> AgentCallContext:
         return self._call_context
-    
+
 
 # writes to a path, the document must already exist, optionally create the document if it does not exist
 class Writer(TaskRunner):
-    def __init__(self, name: str, input_schema:dict, output_schema:dict, create: bool = True, title: Optional[str] = None, description: Optional[str] = None, requires: Optional[list[Requirement]] = None, supports_tools: Optional[bool] = None):
+    def __init__(
+        self,
+        name: str,
+        input_schema: dict,
+        output_schema: dict,
+        create: bool = True,
+        title: Optional[str] = None,
+        description: Optional[str] = None,
+        requires: Optional[list[Requirement]] = None,
+        supports_tools: Optional[bool] = None,
+    ):
         super().__init__(
             name=name,
             input_schema=input_schema,
@@ -45,37 +62,33 @@ class Writer(TaskRunner):
             description=description,
             title=title,
             requires=requires,
-            supports_tools=supports_tools
+            supports_tools=supports_tools,
         )
-        
+
         self._create = create
 
         if "path" not in input_schema["properties"]:
             raise Exception("input schema must include a 'path' property")
-        
+
     def pop_path(self, arguments: dict):
         return arguments["path"]
-    
+
     async def write(self, writer_context: WriterContext, arguments: dict) -> dict:
         pass
- 
+
     async def ask(self, *, context: AgentCallContext, arguments: dict):
-    
         path = arguments["path"]
-        
+
         client = context.room
         document = await client.sync.open(path=path, create=self._create)
 
         writer_context = WriterContext(
-            room=client,
-            document=document,
-            call_context=context,
-            path=path
+            room=client, document=document, call_context=context, path=path
         )
-    
+
         try:
             return await self.write(writer_context, arguments)
         finally:
             # TODO: need a way to wait for changes to be synchronized
             await asyncio.sleep(1)
-            await client.sync.close(path=path)
+            await client.sync.close(path=path)

meshagent_agents-0.0.38.dist-info/METADATA

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: meshagent-agents
+Version: 0.0.38
+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
+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.0.38
+Requires-Dist: meshagent-tools~=0.0.38
+Requires-Dist: meshagent-openai~=0.0.38
+Requires-Dist: pydantic~=2.11
+Requires-Dist: opentelemetry-distro~=0.54b1
+Provides-Extra: all
+Requires-Dist: meshagent-api[all]~=0.0.38; 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.0.38; extra == "sync"
+Provides-Extra: mail
+Requires-Dist: aiosmtplib~=4.0.1; extra == "mail"
+Provides-Extra: rag
+Requires-Dist: chonkie~=0.5.1; extra == "rag"
+Requires-Dist: chonkie[semantic]~=0.5.1; extra == "rag"
+Requires-Dist: chonkie[openai]~=0.5.1; extra == "rag"
+Dynamic: license-file
+
+### MeshAgent Agents
+
+The ``meshagent.agents`` package provides higher-level agent classes that orchestrate tools and tasks. The primary agents you will build will use the ``TaskRunner``, ``Worker``, and ``ChatBot`` agent types. These agents extend the base ``Agent`` and ``SingleRoomAgent`` classes which setup the fundamentals for working with Agents in MeshAgent Rooms.
+
+Note that agents use LLMAdapters and ToolResponseAdapters to translate between language model calls and tool executions. They also use the ServiceHost to run. 
+
+### Agent
+The ``Agent`` base class handles static info such as the agent name, description, and requirements. This class is not used directly, but is the foundation for specialized agents. 
+
+### SingleRoomAgent
+The ``SingleRoomAgent``extends the ``Agent`` class, connects to a ``RoomClient``, and installs any declared schemas or toolkits when the agent starts up. All other MeshAgent Agent types extend the ``SingleRoomAgent`` class with additional functionality.
+
+### TaskRunner
+The ``TaskRunner`` agent is useful when you want to invoke an agent with a well-defined JSON schemas for input and output. This is important for running agents-as-tools or running remote tasks. Often you will define a ``TaskRunner`` and pass it to a ``ChatBot`` or ``VoiceBot`` as a tool for that agent to use. 
+
+### Worker
+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.
+
+---
+### Learn more about MeshAgent on our website or check out the docs for additional examples!
+
+**Website**: [www.meshagent.com](https://www.meshagent.com/)
+
+**Documentation**: [docs.meshagent.com](https://docs.meshagent.com/)
+
+---

meshagent_agents-0.0.38.dist-info/RECORD

@@ -0,0 +1,30 @@
+meshagent/agents/__init__.py,sha256=d2cplyLH8xqDWqP_GoPQ8ApHzuv8Iiq4rz-vYBlGMTw,706
+meshagent/agents/adapter.py,sha256=CZgVzUTTY8dyPBYA7O_Kaawb40maxAbUUhBFk1YjbsI,1386
+meshagent/agents/agent.py,sha256=bBEMlI2E0P97gkP93J68o9XvIxtTB_bEiFXSrRH3iyk,20623
+meshagent/agents/chat.py,sha256=SPcD0FTBcs5H-e0s53FofoWPHvfAYF_OMeQEr-tWaSs,28954
+meshagent/agents/context.py,sha256=6txCXA22aHQaikvIKED6YjPyasM_bPqGqCE4HGj04_E,4035
+meshagent/agents/development.py,sha256=AEBkkycNZDRLYIdmX2LkrVZv715ALswiwSR9CiV3HE4,894
+meshagent/agents/hosting.py,sha256=tCcswAweEhlMxGaBR_m2YvUkwZiaHbTBT64urRHfK7I,5446
+meshagent/agents/indexer.py,sha256=xFEzAmwAxhKu9xHppnxFUFlzeRHMfVk6MatRyka0ZW8,19367
+meshagent/agents/listener.py,sha256=q5z216FMVW-a7FBs706u3IuB81VArfucxEHaHvPFHEo,5139
+meshagent/agents/mail.py,sha256=jFr9YBTzYc14adOAAl9rYC9bOmEVYTj6NAOKvtLsfVo,11038
+meshagent/agents/planning.py,sha256=QRDDC8VLmlS1rbRETT1EdJo8LYLfIcuOe_wiAyO_6LU,22242
+meshagent/agents/prompt.py,sha256=OSSqbzaugyQtuvYxTY5UcZQWyeV73e3GUJz_iC5xZkA,1883
+meshagent/agents/pydantic.py,sha256=RrdOESZg-n_FyxbfkOBwRPVxV39IOjxK2unsyAGn9as,6278
+meshagent/agents/single_shot_writer.py,sha256=4-anwnE5Prpi9vqF9YInGDBgezQVDYzxhmRTNUcrqXw,3370
+meshagent/agents/thread_schema.py,sha256=c6KuLhcBxjxcz8M5NQzmmlyJLqv8RB7W491uWOu6Z34,3485
+meshagent/agents/utils.py,sha256=6D9GXpYu9xx5XlfD3DiGFdyOwq46e5-sTYOF_FYep1o,1446
+meshagent/agents/version.py,sha256=R5QxTjVaID7odO0eBWpOnyCjNQxBZ7cpyruM_NMOoDc,23
+meshagent/agents/worker.py,sha256=6-SDWm-4aqlx9G8321g1lS0caZUybBpJRhrg5jxqTy8,3500
+meshagent/agents/writer.py,sha256=dXglYgHwBrBJIaapMqBDyD3kmwSyi94tOdHH44itODc,2682
+meshagent/agents/schemas/__init__.py,sha256=TqLbKu8AWahYaXYGQf0qK1CdcYCtjm7PuMEFlQLAyvA,295
+meshagent/agents/schemas/document.py,sha256=H-aolubkRHdTAH-rLI2SJ8y3JKwXvpNsR3ZCqghwAWI,1515
+meshagent/agents/schemas/gallery.py,sha256=65IsrH2wiFIR-DNo8est-nCOC72i1Aa5EmVNUHtVnK0,1091
+meshagent/agents/schemas/presentation.py,sha256=aaMzkFQryurbHd1fbzTQPdN7v8QIhsjXuvbE8ZiuXNY,1589
+meshagent/agents/schemas/schema.py,sha256=8OXGCLVouoPg6eHBU9mgf1pTGTMvVZqiKNq15wkQJe0,5310
+meshagent/agents/schemas/super_editor_document.py,sha256=iRv4Q-DE_5kUdsAD5Rm4GwHek8L_7ZEpxIZ1x2dWjdg,1813
+meshagent_agents-0.0.38.dist-info/licenses/LICENSE,sha256=eTt0SPW-sVNdkZe9PS_S8WfCIyLjRXRl7sUBWdlteFg,10254
+meshagent_agents-0.0.38.dist-info/METADATA,sha256=bojAeYseNHLxvu5X5z0i3DPKqsVfWK7TzuxYB5uH_-E,3737
+meshagent_agents-0.0.38.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+meshagent_agents-0.0.38.dist-info/top_level.txt,sha256=GlcXnHtRP6m7zlG3Df04M35OsHtNXy_DY09oFwWrH74,10
+meshagent_agents-0.0.38.dist-info/RECORD,,

meshagent_agents-0.0.37.dist-info/METADATA

@@ -1,36 +0,0 @@
-Metadata-Version: 2.4
-Name: meshagent-agents
-Version: 0.0.37
-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
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: pyjwt~=2.10
-Requires-Dist: pytest~=8.3
-Requires-Dist: pytest-asyncio~=0.26
-Requires-Dist: meshagent-api~=0.0.37
-Requires-Dist: meshagent-tools~=0.0.37
-Requires-Dist: meshagent-openai~=0.0.37
-Requires-Dist: pydantic~=2.11
-Requires-Dist: opentelemetry-distro~=0.54b1
-Provides-Extra: all
-Requires-Dist: meshagent-api[all]~=0.0.37; 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.0.37; extra == "sync"
-Provides-Extra: mail
-Requires-Dist: aiosmtplib~=4.0.1; extra == "mail"
-Provides-Extra: rag
-Requires-Dist: chonkie~=0.5.1; extra == "rag"
-Requires-Dist: chonkie[semantic]~=0.5.1; extra == "rag"
-Requires-Dist: chonkie[openai]~=0.5.1; extra == "rag"
-Dynamic: license-file
-
-### Meshagent Agents

meshagent_agents-0.0.37.dist-info/RECORD

@@ -1,30 +0,0 @@
-meshagent/agents/__init__.py,sha256=S83622vDM9hWErcgfwZg8lJT2ncu00OEgnxoIbY3VcM,376
-meshagent/agents/adapter.py,sha256=_83Q2XiA8e6Xh37xYnJ9z75AbDWskR-mmKH-LLq6mpA,1318
-meshagent/agents/agent.py,sha256=b41t1XLG5QYxjlWrkf7EbR7ecVfwcTtXMe8p3N9_32Y,19419
-meshagent/agents/chat.py,sha256=tNwHYEA-_tLoB2_9DNZ9mXpU1n--l6t_q5Q0XgPKVj0,26059
-meshagent/agents/context.py,sha256=6eFK7wizjzZmZyhbqwazlT_E_e_Cpb17Qa3tBk2BJzw,3804
-meshagent/agents/development.py,sha256=04VYL1Q_BWUTQeVuiVOpyjcs8bzUIX1eQ4VyTtjc5s0,926
-meshagent/agents/hosting.py,sha256=1vzr6aV_HPJGzGPkQdLgt4CqvDAgpHdBEmSym_0r3j8,4982
-meshagent/agents/indexer.py,sha256=Lz7hJvC7hbvnmiFQLEzmakw_1OPh93pp96iSwIv1fQc,19410
-meshagent/agents/listener.py,sha256=39u20ZwTNUVR0CRUOi4CTgBreg2ZPbrHQOohwjsfijg,5359
-meshagent/agents/mail.py,sha256=bDQdJphKJr0Sl1_XiVhdd1J7E2DBqbjvxvnIVxGt5UU,10951
-meshagent/agents/planning.py,sha256=NtXzYiwykeYdQghWjwsChy4f9OgIsQZWiIstpZvtGtU,21811
-meshagent/agents/prompt.py,sha256=sidiyLLC6Lr9KO3cUTKttd2oROlcizle_4iKoaNrfhA,1864
-meshagent/agents/pydantic.py,sha256=My9sv1A56unA0qVoPSH-mYtxcgl0AKyxFgyOM70pjLM,6062
-meshagent/agents/single_shot_writer.py,sha256=QsGvTIw1qtp8nGLfzuJwdZj6ucY4cW9rdecqNwv83FA,3355
-meshagent/agents/thread_schema.py,sha256=-KGAMNxQsVuXpvc0avV-OYHe2LMXpjTu5PyQ-1nBnyE,2667
-meshagent/agents/utils.py,sha256=upMbvG4KODZijeTO3IdW4GgzFPz4jXTzNhZBDmtroic,1431
-meshagent/agents/version.py,sha256=JaGEpJ5xP3R4j7pGgCziGajlIRjy1_NJdv_OaXPQius,22
-meshagent/agents/worker.py,sha256=G2Q3UpUCQQ8GtPK5_LW4q8uDOyuJXJM_zdRPsx4puck,3260
-meshagent/agents/writer.py,sha256=2Nk52JcjdRz3EnGBO4EHnv49QzByWiije1LKMNuCAIo,2687
-meshagent/agents/schemas/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-meshagent/agents/schemas/document.py,sha256=GrHkyJ6ZsImqL33FnGKqjBmBpX4u2lAsUMLW4AzDHEM,1318
-meshagent/agents/schemas/gallery.py,sha256=fzAdlDrn_dJz4FDPkSTH9ir7QmRpV8wFjj6RTOyVwmA,902
-meshagent/agents/schemas/presentation.py,sha256=DreBXAU7Lx92NBPTlEOZq1gdaRs0OkZrJgPT5N7fYH4,1265
-meshagent/agents/schemas/schema.py,sha256=O52T5nUGRNQ8AsamZ_W_IQ8WRDqSBo3vWFDSQcC7Lcg,4473
-meshagent/agents/schemas/super_editor_document.py,sha256=lFpbZn_s_6hchimddzpnGneJ7LaB6dTN_AnLZsx2r9c,1469
-meshagent_agents-0.0.37.dist-info/licenses/LICENSE,sha256=eTt0SPW-sVNdkZe9PS_S8WfCIyLjRXRl7sUBWdlteFg,10254
-meshagent_agents-0.0.37.dist-info/METADATA,sha256=g8JilzX9cTv6vvA_bcAfDLpP3JGyIAE61SJxnxRsplg,1308
-meshagent_agents-0.0.37.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-meshagent_agents-0.0.37.dist-info/top_level.txt,sha256=GlcXnHtRP6m7zlG3Df04M35OsHtNXy_DY09oFwWrH74,10
-meshagent_agents-0.0.37.dist-info/RECORD,,