meshagent-agents 0.5.3__tar.gz → 0.5.4__tar.gz

{meshagent_agents-0.5.3 → meshagent_agents-0.5.4}/CHANGELOG.md

@@ -1,3 +1,6 @@
+## [0.5.4]
+- Stability
+
 ## [0.5.3]
 - Stability
 

{meshagent_agents-0.5.3/meshagent_agents.egg-info → meshagent_agents-0.5.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meshagent-agents
-Version: 0.5.3
+Version: 0.5.4
 Summary: Agent Building Blocks for Meshagent
 License-Expression: Apache-2.0
 Project-URL: Documentation, https://docs.meshagent.com
@@ -12,19 +12,19 @@ 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.3
-Requires-Dist: meshagent-tools~=0.5.3
-Requires-Dist: meshagent-openai~=0.5.3
+Requires-Dist: meshagent-api~=0.5.4
+Requires-Dist: meshagent-tools~=0.5.4
+Requires-Dist: meshagent-openai~=0.5.4
 Requires-Dist: pydantic~=2.11
 Requires-Dist: opentelemetry-distro~=0.54b1
 Provides-Extra: all
-Requires-Dist: meshagent-api[all]~=0.5.3; extra == "all"
+Requires-Dist: meshagent-api[all]~=0.5.4; 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.3; extra == "sync"
+Requires-Dist: meshagent-api[sync]~=0.5.4; extra == "sync"
 Provides-Extra: mail
 Requires-Dist: aiosmtplib~=4.0.1; extra == "mail"
 Provides-Extra: rag

{meshagent_agents-0.5.3 → meshagent_agents-0.5.4}/meshagent/agents/chat.py

@@ -1,4 +1,4 @@
-from .agent import SingleRoomAgent, AgentChatContext
+from meshagent.agents.agent import SingleRoomAgent, AgentChatContext
 from meshagent.api.chan import Chan
 from meshagent.api import (
     RoomMessage,
@@ -10,7 +10,7 @@ from meshagent.api import (
     MeshDocument,
 )
 from meshagent.tools import Toolkit, ToolContext
-from .adapter import LLMAdapter, ToolResponseAdapter
+from meshagent.agents.adapter import LLMAdapter, ToolResponseAdapter
 from meshagent.openai.tools.responses_adapter import ImageGenerationTool, LocalShellTool
 import asyncio
 from typing import Optional
@@ -22,6 +22,7 @@ from typing import Literal
 import base64
 from openai.types.responses import ResponseStreamEvent
 from asyncio import CancelledError
+from meshagent.api import RoomException
 
 from opentelemetry import trace
 import shlex
@@ -307,13 +308,22 @@ class ChatBot(SingleRoomAgent):
 
     async def _send_and_save_chat(
         self,
-        messages: Element,
+        thread: MeshDocument,
         path: str,
         to: RemoteParticipant,
         id: str,
         text: str,
         thread_attributes: dict,
     ):
+        messages = None
+
+        for prop in thread.root.get_children():
+            if prop.tag_name == "messages":
+                messages = prop
+
+        if messages is None:
+            raise RoomException("messages element was not found in thread document")
+
         with tracer.start_as_current_span("chatbot.thread.message") as span:
             span.set_attributes(thread_attributes)
             span.set_attribute("role", "assistant")
@@ -339,10 +349,10 @@ class ChatBot(SingleRoomAgent):
                 },
             )
 
-    async def greet(
+    async def _greet(
         self,
         *,
-        messages: Element,
+        thread: MeshDocument,
         path: str,
         chat_context: AgentChatContext,
         participant: RemoteParticipant,
@@ -353,7 +363,7 @@ class ChatBot(SingleRoomAgent):
             await self._send_and_save_chat(
                 id=str(uuid.uuid4()),
                 to=RemoteParticipant(id=participant.id),
-                messages=messages,
+                thread=thread,
                 path=path,
                 text=self._auto_greet_message,
                 thread_attributes=thread_attributes,
@@ -403,107 +413,149 @@ class ChatBot(SingleRoomAgent):
     async def close_thread(self, *, path: str):
         return await self.room.sync.close(path=path)
 
-    async def _spawn_thread(self, path: str, messages: Chan[RoomMessage]):
-        self.room.developer.log_nowait(
-            type="chatbot.thread.started", data={"path": path}
-        )
-        chat_context = await self.init_chat_context()
-        opened = False
+    async def load_thread_context(self, *, thread_context: ChatThreadContext):
+        """
+        load the thread from the thread document by inserting the current messages in the thread into the chat context
+        """
+        thread = thread_context.thread
+        chat_context = thread_context.chat
+        for prop in thread.root.get_children():
+            if prop.tag_name == "messages":
+                doc_messages = prop
+
+                for element in doc_messages.get_children():
+                    if isinstance(element, Element) and element.tag_name == "message":
+                        msg = element["text"]
+                        if element[
+                            "author_name"
+                        ] == self.room.local_participant.get_attribute("name"):
+                            chat_context.append_assistant_message(msg)
+                        else:
+                            chat_context.append_user_message(msg)
+
+                        for child in element.get_children():
+                            if child.tag_name == "file":
+                                chat_context.append_assistant_message(
+                                    f"the user attached a file with the path '{child.get_attribute('path')}'"
+                                )
 
+        if doc_messages is None:
+            raise Exception("thread was not properly initialized")
+
+    async def prepare_llm_context(self, *, context: ChatThreadContext):
+        """
+        called prior to sending the request to the LLM in case the agent needs to modify the context prior to sending
+        """
+        pass
+
+    async def _process_llm_events(
+        self,
+        *,
+        thread_context: ChatThreadContext,
+        llm_messages: asyncio.Queue,
+        thread_attributes: dict,
+    ):
+        thread = thread_context.thread
         doc_messages = None
-        current_file = None
-        llm_messages = Chan[ResponseStreamEvent]()
-        thread_context = None
+        for prop in thread.root.get_children():
+            if prop.tag_name == "messages":
+                doc_messages = prop
 
-        thread_attributes = None
+        if doc_messages is None:
+            raise RoomException("messages element is missing from thread document")
+
+        context_message = None
+        updates = asyncio.Queue()
 
-        def done_processing_llm_events(task: asyncio.Task):
+        # throttle updates so we don't send too many syncs over the wire at once
+        async def update_thread():
             try:
-                task.result()
-            except Exception as e:
-                logger.error("error sending delta", exc_info=e)
-
-        async def process_llm_events():
-            context_message = None
-            updates = asyncio.Queue()
-
-            # throttle updates so we don't send too many syncs over the wire at once
-            async def update_thread():
-                try:
-                    changes = {}
-                    while True:
-                        try:
-                            element, partial = updates.get_nowait()
-                            changes[element] = partial
+                changes = {}
+                while True:
+                    try:
+                        element, partial = updates.get_nowait()
+                        changes[element] = partial
 
-                        except asyncio.QueueEmpty:
-                            for e, p in changes.items():
-                                e["text"] = p
+                    except asyncio.QueueEmpty:
+                        for e, p in changes.items():
+                            e["text"] = p
 
-                            changes.clear()
+                        changes.clear()
 
-                            e, p = await updates.get()
-                            changes[e] = p
+                        e, p = await updates.get()
+                        changes[e] = p
 
-                            await asyncio.sleep(0.1)
+                        await asyncio.sleep(0.1)
 
-                except asyncio.QueueShutDown:
-                    pass
+            except asyncio.QueueShutDown:
+                # flush any pending changes
+                for e, p in changes.items():
+                    e["text"] = p
 
-            update_thread_task = asyncio.create_task(update_thread())
-            try:
-                async for evt in llm_messages:
-                    for participant in self._room.messaging.get_participants():
-                        logger.debug(
-                            f"sending event {evt.type} to {participant.get_attribute('name')}"
-                        )
+                changes.clear()
+                pass
 
-                        # self.room.messaging.send_message_nowait(to=participant, type="llm.event", message=json.loads(evt.to_json()))
+        update_thread_task = asyncio.create_task(update_thread())
+        try:
+            while True:
+                evt = await llm_messages.get()
+                for participant in self._room.messaging.get_participants():
+                    logger.debug(
+                        f"sending event {evt.type} to {participant.get_attribute('name')}"
+                    )
 
-                    if evt.type == "response.content_part.added":
-                        partial = ""
-                        content_element = doc_messages.append_child(
-                            tag_name="message",
-                            attributes={
-                                "text": "",
-                                "created_at": datetime.datetime.now(
-                                    datetime.timezone.utc
-                                )
-                                .isoformat()
-                                .replace("+00:00", "Z"),
-                                "author_name": self.room.local_participant.get_attribute(
-                                    "name"
-                                ),
-                            },
-                        )
+                    # self.room.messaging.send_message_nowait(to=participant, type="llm.event", message=json.loads(evt.to_json()))
+
+                if evt.type == "response.content_part.added":
+                    partial = ""
+
+                    content_element = doc_messages.append_child(
+                        tag_name="message",
+                        attributes={
+                            "text": "",
+                            "created_at": datetime.datetime.now(datetime.timezone.utc)
+                            .isoformat()
+                            .replace("+00:00", "Z"),
+                            "author_name": self.room.local_participant.get_attribute(
+                                "name"
+                            ),
+                        },
+                    )
 
-                        context_message = {"role": "assistant", "content": ""}
-                        chat_context.messages.append(context_message)
+                    context_message = {"role": "assistant", "content": ""}
+                    thread_context.chat.messages.append(context_message)
 
-                    elif evt.type == "response.output_text.delta":
-                        partial += evt.delta
-                        updates.put_nowait((content_element, partial))
-                        context_message["content"] = partial
+                elif evt.type == "response.output_text.delta":
+                    partial += evt.delta
+                    updates.put_nowait((content_element, partial))
+                    context_message["content"] = partial
 
-                    elif evt.type == "response.output_text.done":
-                        content_element = None
+                elif evt.type == "response.output_text.done":
+                    content_element = None
 
-                        with tracer.start_as_current_span(
-                            "chatbot.thread.message"
-                        ) as span:
-                            span.set_attribute(
-                                "from_participant_name",
-                                self.room.local_participant.get_attribute("name"),
-                            )
-                            span.set_attribute("role", "assistant")
-                            span.set_attributes(thread_attributes)
-                            span.set_attributes({"text": evt.text})
-            finally:
-                updates.shutdown()
-                await update_thread_task
+                    with tracer.start_as_current_span("chatbot.thread.message") as span:
+                        span.set_attribute(
+                            "from_participant_name",
+                            self.room.local_participant.get_attribute("name"),
+                        )
+                        span.set_attribute("role", "assistant")
+                        span.set_attributes(thread_attributes)
+                        span.set_attributes({"text": evt.text})
+        except asyncio.QueueShutDown:
+            pass
+        finally:
+            updates.shutdown()
+            await update_thread_task
 
-        llm_task = asyncio.create_task(process_llm_events())
-        llm_task.add_done_callback(done_processing_llm_events)
+    async def _spawn_thread(self, path: str, messages: Chan[RoomMessage]):
+        logger.debug("chatbot is starting a thread", extra={"path": path})
+        chat_context = await self.init_chat_context()
+        opened = False
+
+        current_file = None
+        thread_context = None
+
+        thread_attributes = None
 
         thread = None
 
@@ -512,9 +564,9 @@ class ChatBot(SingleRoomAgent):
 
             while True:
                 while True:
-                    logger.info(f"waiting for message on thread {path}")
+                    logger.debug(f"waiting for message on thread {path}")
                     received = await messages.recv()
-                    logger.info(f"received message on thread {path}: {received.type}")
+                    logger.debug(f"received message on thread {path}: {received.type}")
 
                     chat_with_participant = None
                     for participant in self._room.messaging.get_participants():
@@ -569,83 +621,57 @@ class ChatBot(SingleRoomAgent):
 
                             thread = await self.open_thread(path=path)
 
-                            for prop in thread.root.get_children():
-                                if prop.tag_name == "messages":
-                                    doc_messages = prop
-
-                                    for element in doc_messages.get_children():
-                                        if (
-                                            isinstance(element, Element)
-                                            and element.tag_name == "message"
-                                        ):
-                                            msg = element["text"]
-                                            if (
-                                                element["author_name"]
-                                                == self.room.local_participant.get_attribute(
-                                                    "name"
-                                                )
-                                            ):
-                                                chat_context.append_assistant_message(
-                                                    msg
-                                                )
-                                            else:
-                                                chat_context.append_user_message(msg)
-
-                                            for child in element.get_children():
-                                                if child.tag_name == "file":
-                                                    chat_context.append_assistant_message(
-                                                        f"the user attached a file with the path '{child.get_attribute('path')}'"
-                                                    )
-
-                            if doc_messages is None:
-                                raise Exception("thread was not properly initialized")
+                            thread_context = ChatThreadContext(
+                                path=path,
+                                chat=chat_context,
+                                thread=thread,
+                                participants=get_thread_participants(
+                                    room=self.room, thread=thread
+                                ),
+                            )
+
+                            await self.load_thread_context(
+                                thread_context=thread_context
+                            )
 
                     if received.type == "opened":
                         if not opened:
                             opened = True
 
-                            await self.greet(
+                            await self._greet(
                                 path=path,
                                 chat_context=chat_context,
                                 participant=chat_with_participant,
-                                messages=doc_messages,
+                                thread=thread,
                                 thread_attributes=thread_attributes,
                             )
 
                     if received.type == "chat":
                         if thread is None:
-                            self.room.developer.log_nowait(
-                                type="thread is not open", data={}
-                            )
+                            logger.info("thread is not open", extra={"path": path})
                             break
 
-                        if chat_with_participant.id == received.from_participant_id:
-                            self.room.developer.log_nowait(
-                                type="llm.message",
-                                data={
-                                    "context": chat_context.id,
-                                    "participant_id": self.room.local_participant.id,
-                                    "participant_name": self.room.local_participant.get_attribute(
-                                        "name"
-                                    ),
-                                    "message": {
-                                        "content": {
-                                            "role": "user",
-                                            "text": received.message["text"],
-                                        }
-                                    },
-                                },
-                            )
+                        logger.debug(
+                            "chatbot received a chat",
+                            extra={
+                                "context": chat_context.id,
+                                "participant_id": self.room.local_participant.id,
+                                "participant_name": self.room.local_participant.get_attribute(
+                                    "name"
+                                ),
+                                "text": received.message["text"],
+                            },
+                        )
 
-                            attachments = received.message.get("attachments", [])
-                            text = received.message["text"]
+                        attachments = received.message.get("attachments", [])
+                        text = received.message["text"]
 
-                            for attachment in attachments:
-                                chat_context.append_assistant_message(
-                                    message=f"the user attached a file at the path '{attachment['path']}'"
-                                )
+                        for attachment in attachments:
+                            chat_context.append_assistant_message(
+                                message=f"the user attached a file at the path '{attachment['path']}'"
+                            )
 
-                            chat_context.append_user_message(message=text)
+                        chat_context.append_user_message(message=text)
 
                         if messages.empty():
                             break
@@ -690,9 +716,6 @@ class ChatBot(SingleRoomAgent):
                                     room=self.room, thread=thread
                                 )
 
-                            def handle_event(evt):
-                                llm_messages.send_nowait(evt)
-
                             with tracer.start_as_current_span("chatbot.llm") as span:
                                 try:
                                     with tracer.start_as_current_span(
@@ -705,6 +728,23 @@ class ChatBot(SingleRoomAgent):
                                             )
                                         )
 
+                                    await self.prepare_llm_context(
+                                        context=thread_context
+                                    )
+
+                                    llm_messages = asyncio.Queue[ResponseStreamEvent]()
+
+                                    def handle_event(evt):
+                                        llm_messages.put_nowait(evt)
+
+                                    llm_task = asyncio.create_task(
+                                        self._process_llm_events(
+                                            thread_context=thread_context,
+                                            llm_messages=llm_messages,
+                                            thread_attributes=thread_attributes,
+                                        )
+                                    )
+
                                     await self._llm_adapter.next(
                                         context=chat_context,
                                         room=self._room,
@@ -713,10 +753,13 @@ class ChatBot(SingleRoomAgent):
                                         event_handler=handle_event,
                                     )
 
+                                    llm_messages.shutdown()
+                                    await llm_task
+
                                 except Exception as e:
                                     logger.error("An error was encountered", exc_info=e)
                                     await self._send_and_save_chat(
-                                        messages=doc_messages,
+                                        thread=thread,
                                         to=chat_with_participant,
                                         path=path,
                                         id=str(uuid.uuid4()),
@@ -741,13 +784,9 @@ class ChatBot(SingleRoomAgent):
         finally:
 
             async def cleanup():
-                llm_messages.close()
-
                 if self.room is not None:
                     logger.info(f"thread was ended {path}")
-                    self.room.developer.log_nowait(
-                        type="chatbot.thread.ended", data={"path": path}
-                    )
+                    logger.info("chatbot thread ended", extra={"path": path})
 
                     if thread is not None:
                         await self.close_thread(path=path)
@@ -786,7 +825,7 @@ class ChatBot(SingleRoomAgent):
 
                 messages = self._get_message_channel(path)
 
-                logger.info(
+                logger.debug(
                     f"queued incoming message for thread {path}: {message.type}"
                 )
 
@@ -806,7 +845,7 @@ class ChatBot(SingleRoomAgent):
                                 f"The chat thread ended with an error {e}", exc_info=e
                             )
 
-                    logger.info(f"spawning chat thread for {path}")
+                    logger.debug(f"spawning chat thread for {path}")
                     task = asyncio.create_task(
                         self._spawn_thread(messages=messages, path=path)
                     )

meshagent_agents-0.5.4/meshagent/agents/version.py

@@ -0,0 +1 @@
+__version__ = "0.5.4"

{meshagent_agents-0.5.3 → meshagent_agents-0.5.4/meshagent_agents.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meshagent-agents
-Version: 0.5.3
+Version: 0.5.4
 Summary: Agent Building Blocks for Meshagent
 License-Expression: Apache-2.0
 Project-URL: Documentation, https://docs.meshagent.com
@@ -12,19 +12,19 @@ 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.3
-Requires-Dist: meshagent-tools~=0.5.3
-Requires-Dist: meshagent-openai~=0.5.3
+Requires-Dist: meshagent-api~=0.5.4
+Requires-Dist: meshagent-tools~=0.5.4
+Requires-Dist: meshagent-openai~=0.5.4
 Requires-Dist: pydantic~=2.11
 Requires-Dist: opentelemetry-distro~=0.54b1
 Provides-Extra: all
-Requires-Dist: meshagent-api[all]~=0.5.3; extra == "all"
+Requires-Dist: meshagent-api[all]~=0.5.4; 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.3; extra == "sync"
+Requires-Dist: meshagent-api[sync]~=0.5.4; extra == "sync"
 Provides-Extra: mail
 Requires-Dist: aiosmtplib~=4.0.1; extra == "mail"
 Provides-Extra: rag

{meshagent_agents-0.5.3 → meshagent_agents-0.5.4}/meshagent_agents.egg-info/requires.txt

@@ -1,14 +1,14 @@
 pyjwt~=2.10
 pytest~=8.4
 pytest-asyncio~=0.26
-meshagent-api~=0.5.3
-meshagent-tools~=0.5.3
-meshagent-openai~=0.5.3
+meshagent-api~=0.5.4
+meshagent-tools~=0.5.4
+meshagent-openai~=0.5.4
 pydantic~=2.11
 opentelemetry-distro~=0.54b1
 
 [all]
-meshagent-api[all]~=0.5.3
+meshagent-api[all]~=0.5.4
 chonkie~=0.5.1
 chonkie[semantic]~=0.5.1
 chonkie[openai]~=0.5.1
@@ -23,4 +23,4 @@ chonkie[semantic]~=0.5.1
 chonkie[openai]~=0.5.1
 
 [sync]
-meshagent-api[sync]~=0.5.3
+meshagent-api[sync]~=0.5.4

{meshagent_agents-0.5.3 → meshagent_agents-0.5.4}/pyproject.toml

@@ -17,16 +17,16 @@ dependencies = [
   "pyjwt~=2.10",
   "pytest~=8.4",
   "pytest-asyncio~=0.26",
-  "meshagent-api~=0.5.3",
-  "meshagent-tools~=0.5.3",
-  "meshagent-openai~=0.5.3",
+  "meshagent-api~=0.5.4",
+  "meshagent-tools~=0.5.4",
+  "meshagent-openai~=0.5.4",
   "pydantic~=2.11",
   "opentelemetry-distro~=0.54b1"
 ]
 
 [project.optional-dependencies]
 all = [
-    "meshagent-api[all]~=0.5.3",
+    "meshagent-api[all]~=0.5.4",
     "chonkie~=0.5.1",
     "chonkie[semantic]~=0.5.1",
     "chonkie[openai]~=0.5.1",
@@ -34,7 +34,7 @@ all = [
 ]
 
 sync = [
-    "meshagent-api[sync]~=0.5.3",
+    "meshagent-api[sync]~=0.5.4",
 ]
 
 mail = [

meshagent_agents-0.5.3/meshagent/agents/version.py

@@ -1 +0,0 @@
-__version__ = "0.5.3"