mojentic 0.9.0__py3-none-any.whl → 1.0.1__py3-none-any.whl

mojentic/llm/tools/tool_wrapper.py

@@ -1,10 +1,10 @@
 """
 Not sure about this module right now. There are a couple ways to do this.
 """
-from typing import Any, TYPE_CHECKING
+from typing import TYPE_CHECKING
 
 from mojentic.llm.tools.llm_tool import LLMTool
-from mojentic.llm.gateways.models import LLMMessage, MessageRole
+from mojentic.llm.gateways.models import LLMMessage
 
 # Use TYPE_CHECKING to avoid circular imports
 if TYPE_CHECKING:

mojentic/tracer/__init__.py

@@ -4,18 +4,9 @@ Mojentic tracer module for tracking system operations.
 """
 
 # Core tracer components
-from .tracer_system import TracerSystem
 from .null_tracer import NullTracer
-from .event_store import EventStore
 
 # Tracer event types
-from .tracer_events import (
-    TracerEvent,
-    LLMCallTracerEvent,
-    LLMResponseTracerEvent,
-    ToolCallTracerEvent,
-    AgentInteractionTracerEvent
-)
 
 # Create a singleton NullTracer instance for use throughout the application
-null_tracer = NullTracer()
+null_tracer = NullTracer()

mojentic/tracer/event_store.py

@@ -1,6 +1,4 @@
-from typing import Any, Callable, Dict, List, Optional, Type, Union
-import time
-from datetime import datetime
+from typing import Callable, List, Optional, Type
 
 from mojentic.event import Event
 from mojentic.tracer.tracer_events import TracerEvent
@@ -38,11 +36,12 @@ class EventStore:
         if self.on_store_callback is not None:
             self.on_store_callback(event)
 
-    def get_events(self, 
-                  event_type: Optional[Type[Event]] = None, 
-                  start_time: Optional[float] = None,
-                  end_time: Optional[float] = None,
-                  filter_func: Optional[Callable[[Event], bool]] = None) -> List[Event]:
+    def get_events(
+            self,
+            event_type: Optional[Type[Event]] = None,
+            start_time: Optional[float] = None,
+            end_time: Optional[float] = None,
+            filter_func: Optional[Callable[[Event], bool]] = None) -> List[Event]:
         """
         Get events from the store, optionally filtered by type, time range, and custom filter function.
 

mojentic/tracer/event_store_spec.py

@@ -1,8 +1,7 @@
 import time
-from typing import List
 
 from mojentic import Event
-from mojentic.tracer.tracer_events import TracerEvent, LLMCallTracerEvent, AgentInteractionTracerEvent
+from mojentic.tracer.tracer_events import TracerEvent
 from mojentic.tracer.event_store import EventStore
 
 

mojentic/tracer/null_tracer.py

@@ -32,15 +32,14 @@ class NullTracer:
             The tracer event to record (will be ignored).
         """
         # Do nothing
-        pass
-
-    def record_llm_call(self, 
-                      model: str, 
-                      messages: List[Dict], 
-                      temperature: float = 1.0,
-                      tools: Optional[List[Dict]] = None,
-                      source: Any = None,
-                      correlation_id: str = None) -> None:
+
+    def record_llm_call(self,
+                        model: str,
+                        messages: List[Dict],
+                        temperature: float = 1.0,
+                        tools: Optional[List[Dict]] = None,
+                        source: Any = None,
+                        correlation_id: str = None) -> None:
         """
         Do nothing implementation of record_llm_call.
 
@@ -60,15 +59,14 @@ class NullTracer:
             UUID string that is copied from cause-to-affect for tracing events.
         """
         # Do nothing
-        pass
 
-    def record_llm_response(self, 
-                         model: str,
-                         content: str,
-                         tool_calls: Optional[List[Dict]] = None,
-                         call_duration_ms: Optional[float] = None,
-                         source: Any = None,
-                         correlation_id: str = None) -> None:
+    def record_llm_response(self,
+                            model: str,
+                            content: str,
+                            tool_calls: Optional[List[Dict]] = None,
+                            call_duration_ms: Optional[float] = None,
+                            source: Any = None,
+                            correlation_id: str = None) -> None:
         """
         Do nothing implementation of record_llm_response.
 
@@ -88,16 +86,15 @@ class NullTracer:
             UUID string that is copied from cause-to-affect for tracing events.
         """
         # Do nothing
-        pass
 
     def record_tool_call(self,
-                       tool_name: str,
-                       arguments: Dict[str, Any],
-                       result: Any,
-                       caller: Optional[str] = None,
-                       call_duration_ms: Optional[float] = None,
-                       source: Any = None,
-                       correlation_id: str = None) -> None:
+                         tool_name: str,
+                         arguments: Dict[str, Any],
+                         result: Any,
+                         caller: Optional[str] = None,
+                         call_duration_ms: Optional[float] = None,
+                         source: Any = None,
+                         correlation_id: str = None) -> None:
         """
         Do nothing implementation of record_tool_call.
 
@@ -119,15 +116,15 @@ class NullTracer:
             UUID string that is copied from cause-to-affect for tracing events.
         """
         # Do nothing
-        pass
-
-    def record_agent_interaction(self,
-                               from_agent: str,
-                               to_agent: str,
-                               event_type: str,
-                               event_id: Optional[str] = None,
-                               source: Any = None,
-                               correlation_id: str = None) -> None:
+
+    def record_agent_interaction(
+            self,
+            from_agent: str,
+            to_agent: str,
+            event_type: str,
+            event_id: Optional[str] = None,
+            source: Any = None,
+            correlation_id: str = None) -> None:
         """
         Do nothing implementation of record_agent_interaction.
 
@@ -147,13 +144,13 @@ class NullTracer:
             UUID string that is copied from cause-to-affect for tracing events.
         """
         # Do nothing
-        pass
 
-    def get_events(self, 
-                  event_type: Optional[Type[TracerEvent]] = None, 
-                  start_time: Optional[float] = None,
-                  end_time: Optional[float] = None,
-                  filter_func: Optional[Callable[[TracerEvent], bool]] = None) -> List[TracerEvent]:
+    def get_events(
+            self,
+            event_type: Optional[Type[TracerEvent]] = None,
+            start_time: Optional[float] = None,
+            end_time: Optional[float] = None,
+            filter_func: Optional[Callable[[TracerEvent], bool]] = None) -> List[TracerEvent]:
         """
         Return an empty list for any get_events request.
 
@@ -195,12 +192,9 @@ class NullTracer:
 
     def clear(self) -> None:
         """Do nothing implementation of clear method."""
-        pass
 
     def enable(self) -> None:
         """No-op method for interface compatibility."""
-        pass
 
     def disable(self) -> None:
         """No-op method for interface compatibility."""
-        pass

mojentic/tracer/tracer_events.py

@@ -1,7 +1,7 @@
 """
 Defines tracer event types for tracking system interactions.
 """
-from typing import Any, Dict, List, Optional, Type
+from typing import Any, Dict, List, Optional
 from datetime import datetime
 import uuid
 
@@ -18,7 +18,13 @@ class TracerEvent(Event):
     They are distinct from regular events which are used for agent communication.
     """
     timestamp: float = Field(..., description="Timestamp when the event occurred")
-    correlation_id: str = Field(default_factory=lambda: str(uuid.uuid4()), description="UUID string that is copied from cause-to-affect for tracing events")
+    correlation_id: str = Field(
+        default_factory=lambda: str(uuid.uuid4()),
+        description=(
+            "UUID string that is copied from cause-to-affect "
+            "for tracing events"
+        )
+    )
 
     def printable_summary(self) -> str:
         """

mojentic/tracer/tracer_events_spec.py

@@ -1,5 +1,4 @@
 import time
-from typing import Dict, List
 
 from mojentic.tracer.tracer_events import (
     TracerEvent,
@@ -24,7 +23,7 @@ class DescribeTracerEvents:
             source=DescribeTracerEvents,
             timestamp=time.time()
         )
-        
+
         # Then
         assert isinstance(event, TracerEvent)
         assert isinstance(event.timestamp, float)
@@ -44,7 +43,7 @@ class DescribeTracerEvents:
             temperature=0.7,
             tools=None
         )
-        
+
         # Then
         assert isinstance(event, LLMCallTracerEvent)
         assert event.model == "test-model"
@@ -64,7 +63,7 @@ class DescribeTracerEvents:
             content="This is a test response",
             call_duration_ms=150.5
         )
-        
+
         # Then
         assert isinstance(event, LLMResponseTracerEvent)
         assert event.model == "test-model"
@@ -86,7 +85,7 @@ class DescribeTracerEvents:
             result="test result",
             caller="TestAgent"
         )
-        
+
         # Then
         assert isinstance(event, ToolCallTracerEvent)
         assert event.tool_name == "test-tool"
@@ -107,10 +106,10 @@ class DescribeTracerEvents:
             event_type="RequestEvent",
             event_id="12345"
         )
-        
+
         # Then
         assert isinstance(event, AgentInteractionTracerEvent)
         assert event.from_agent == "AgentA"
         assert event.to_agent == "AgentB"
         assert event.event_type == "RequestEvent"
-        assert event.event_id == "12345"
+        assert event.event_id == "12345"

mojentic/tracer/tracer_system.py

@@ -4,19 +4,18 @@ TracerSystem module for coordinating tracer events.
 This provides a central system for recording, filtering, and querying tracer events.
 """
 import time
-from typing import Any, Callable, Dict, List, Optional, Type, Union
+from typing import Any, Callable, Dict, List, Optional, Type
 
 import structlog
 
 from mojentic.tracer.tracer_events import (
-    TracerEvent, 
+    TracerEvent,
     LLMCallTracerEvent,
     LLMResponseTracerEvent,
     ToolCallTracerEvent,
     AgentInteractionTracerEvent
 )
 from mojentic.tracer.event_store import EventStore
-from mojentic.event import Event
 
 logger = structlog.get_logger()
 
@@ -58,13 +57,13 @@ class TracerSystem:
 
         self.event_store.store(event)
 
-    def record_llm_call(self, 
-                      model: str, 
-                      messages: List[Dict], 
-                      temperature: float = 1.0,
-                      tools: Optional[List[Dict]] = None,
-                      source: Any = None,
-                      correlation_id: str = None) -> None:
+    def record_llm_call(self,
+                        model: str,
+                        messages: List[Dict],
+                        temperature: float = 1.0,
+                        tools: Optional[List[Dict]] = None,
+                        source: Any = None,
+                        correlation_id: str = None) -> None:
         """
         Record an LLM call event.
 
@@ -97,13 +96,13 @@ class TracerSystem:
         )
         self.event_store.store(event)
 
-    def record_llm_response(self, 
-                         model: str,
-                         content: str,
-                         tool_calls: Optional[List[Dict]] = None,
-                         call_duration_ms: Optional[float] = None,
-                         source: Any = None,
-                         correlation_id: str = None) -> None:
+    def record_llm_response(self,
+                            model: str,
+                            content: str,
+                            tool_calls: Optional[List[Dict]] = None,
+                            call_duration_ms: Optional[float] = None,
+                            source: Any = None,
+                            correlation_id: str = None) -> None:
         """
         Record an LLM response event.
 
@@ -137,13 +136,13 @@ class TracerSystem:
         self.event_store.store(event)
 
     def record_tool_call(self,
-                       tool_name: str,
-                       arguments: Dict[str, Any],
-                       result: Any,
-                       caller: Optional[str] = None,
-                       call_duration_ms: Optional[float] = None,
-                       source: Any = None,
-                       correlation_id: str = None) -> None:
+                         tool_name: str,
+                         arguments: Dict[str, Any],
+                         result: Any,
+                         caller: Optional[str] = None,
+                         call_duration_ms: Optional[float] = None,
+                         source: Any = None,
+                         correlation_id: str = None) -> None:
         """
         Record a tool call event.
 
@@ -179,13 +178,14 @@ class TracerSystem:
         )
         self.event_store.store(event)
 
-    def record_agent_interaction(self,
-                               from_agent: str,
-                               to_agent: str,
-                               event_type: str,
-                               event_id: Optional[str] = None,
-                               source: Any = None,
-                               correlation_id: str = None) -> None:
+    def record_agent_interaction(
+            self,
+            from_agent: str,
+            to_agent: str,
+            event_type: str,
+            event_id: Optional[str] = None,
+            source: Any = None,
+            correlation_id: str = None) -> None:
         """
         Record an agent interaction event.
 
@@ -218,11 +218,12 @@ class TracerSystem:
         )
         self.event_store.store(event)
 
-    def get_events(self, 
-                  event_type: Optional[Type[TracerEvent]] = None, 
-                  start_time: Optional[float] = None,
-                  end_time: Optional[float] = None,
-                  filter_func: Optional[Callable[[TracerEvent], bool]] = None) -> List[TracerEvent]:
+    def get_events(
+            self,
+            event_type: Optional[Type[TracerEvent]] = None,
+            start_time: Optional[float] = None,
+            end_time: Optional[float] = None,
+            filter_func: Optional[Callable[[TracerEvent], bool]] = None) -> List[TracerEvent]:
         """
         Get tracer events from the store, optionally filtered.
 

mojentic/tracer/tracer_system_spec.py

@@ -1,10 +1,7 @@
 import time
-from typing import Dict, List, Optional, Type, Union
 
-import pytest
 
 from mojentic.tracer.tracer_events import (
-    TracerEvent,
     LLMCallTracerEvent,
     LLMResponseTracerEvent,
     ToolCallTracerEvent,
@@ -185,13 +182,31 @@ class DescribeTracerSystem:
         now = time.time()
         correlation_id = "test-correlation-id"
         tracer_system.event_store.store(
-            LLMCallTracerEvent(source=DescribeTracerSystem, timestamp=now - 100, model="model1", messages=[], correlation_id=correlation_id)
+            LLMCallTracerEvent(
+                source=DescribeTracerSystem,
+                timestamp=now - 100,
+                model="model1",
+                messages=[],
+                correlation_id=correlation_id
+            )
         )
         tracer_system.event_store.store(
-            LLMCallTracerEvent(source=DescribeTracerSystem, timestamp=now - 50, model="model2", messages=[], correlation_id=correlation_id)
+            LLMCallTracerEvent(
+                source=DescribeTracerSystem,
+                timestamp=now - 50,
+                model="model2",
+                messages=[],
+                correlation_id=correlation_id
+            )
         )
         tracer_system.event_store.store(
-            LLMCallTracerEvent(source=DescribeTracerSystem, timestamp=now, model="model3", messages=[], correlation_id=correlation_id)
+            LLMCallTracerEvent(
+                source=DescribeTracerSystem,
+                timestamp=now,
+                model="model3",
+                messages=[],
+                correlation_id=correlation_id
+            )
         )
 
         # When

mojentic/utils/__init__.py

@@ -2,4 +2,4 @@
 
 from .formatting import format_block
 
-__all__ = ['format_block']
+__all__ = ['format_block']

mojentic/utils/formatting.py

@@ -8,6 +8,7 @@ from colorama import init, Fore, Style
 # Initialize colorama
 init()
 
+
 def format_block(content: str, separator: str = "#" * 39) -> str:
     """Format a block of text with separator lines for clear console output.
 

{mojentic-0.9.0.dist-info → mojentic-1.0.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mojentic
-Version: 0.9.0
+Version: 1.0.1
 Summary: Mojentic is an agentic framework that aims to provide a simple and flexible way to assemble teams of agents to solve complex problems.
 Author-email: Stacey Vetzal <stacey@vetzal.com>
 Project-URL: Homepage, https://github.com/svetzal/mojentic
@@ -11,32 +11,32 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE.md
-Requires-Dist: pydantic
-Requires-Dist: structlog
-Requires-Dist: numpy
-Requires-Dist: ollama
-Requires-Dist: openai
-Requires-Dist: anthropic
-Requires-Dist: tiktoken
-Requires-Dist: parsedatetime
-Requires-Dist: pytz
-Requires-Dist: serpapi
-Requires-Dist: colorama
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: structlog>=25.5.0
+Requires-Dist: numpy>=2.3.5
+Requires-Dist: ollama>=0.6.1
+Requires-Dist: openai>=2.12.0
+Requires-Dist: anthropic>=0.75.0
+Requires-Dist: tiktoken>=0.12.0
+Requires-Dist: parsedatetime>=2.6
+Requires-Dist: pytz>=2025.2
+Requires-Dist: serpapi>=0.1.5
+Requires-Dist: colorama>=0.4.6
 Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: pytest-asyncio; extra == "dev"
-Requires-Dist: pytest-spec; extra == "dev"
-Requires-Dist: pytest-cov; extra == "dev"
-Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
-Requires-Dist: flake8>=6.0.0; extra == "dev"
-Requires-Dist: bandit>=1.7.0; extra == "dev"
-Requires-Dist: pip-audit>=2.0.0; extra == "dev"
-Requires-Dist: mkdocs; extra == "dev"
-Requires-Dist: mkdocs-material; extra == "dev"
-Requires-Dist: mkdocs-llmstxt; extra == "dev"
-Requires-Dist: mkdocstrings[python]; extra == "dev"
-Requires-Dist: griffe-fieldz; extra == "dev"
-Requires-Dist: pymdown-extensions; extra == "dev"
+Requires-Dist: pytest>=9.0.2; extra == "dev"
+Requires-Dist: pytest-asyncio>=1.3.0; extra == "dev"
+Requires-Dist: pytest-spec>=5.2.0; extra == "dev"
+Requires-Dist: pytest-cov>=7.0.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.15.0; extra == "dev"
+Requires-Dist: flake8>=7.3.0; extra == "dev"
+Requires-Dist: bandit>=1.9.2; extra == "dev"
+Requires-Dist: pip-audit>=2.10.0; extra == "dev"
+Requires-Dist: mkdocs>=1.6.1; extra == "dev"
+Requires-Dist: mkdocs-material>=9.7.0; extra == "dev"
+Requires-Dist: mkdocs-llmstxt>=0.4.0; extra == "dev"
+Requires-Dist: mkdocstrings[python]>=0.21.0; extra == "dev"
+Requires-Dist: griffe-fieldz>=0.3.0; extra == "dev"
+Requires-Dist: pymdown-extensions>=10.3; extra == "dev"
 Dynamic: license-file
 
 # Mojentic
@@ -66,16 +66,26 @@ Mojentic is a framework that provides a simple and flexible way to interact with
 
 ## 🔧 Installation
 
+We recommend using [uv](https://docs.astral.sh/uv/) for fast, reliable Python project management.
+
 ```bash
-# Install from PyPI
+# Install from PyPI using uv
+uv pip install mojentic
+
+# Or with pip
 pip install mojentic
 ```
 
-Or install from source
+Or install from source:
 
 ```bash
 git clone https://github.com/svetzal/mojentic.git
 cd mojentic
+
+# Using uv (recommended)
+uv sync
+
+# Or with pip
 pip install -e .
 ```
 
@@ -194,11 +204,19 @@ Visit [the documentation](https://svetzal.github.io/mojentic/) for comprehensive
 git clone https://github.com/svetzal/mojentic.git
 cd mojentic
 
-# Install dependencies
+# Using uv (recommended)
+uv sync --extra dev
+
+# Or with pip
 pip install -e ".[dev]"
 
 # Run tests
 pytest
+
+# Quality checks
+flake8 src          # Linting
+bandit -r src       # Security scan
+pip-audit           # Dependency vulnerabilities
 ```
 
 ## ✅ Project Status