mojentic 0.9.0__tar.gz → 1.0.0__tar.gz

{mojentic-0.9.0/src/mojentic.egg-info → mojentic-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mojentic
-Version: 0.9.0
+Version: 1.0.0
 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.8.0
+Requires-Dist: structlog>=25.5.0
+Requires-Dist: numpy>=2.3.5
+Requires-Dist: ollama>=0.1.6
+Requires-Dist: openai>=2.8.1
+Requires-Dist: anthropic>=0.74.1
+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>=9.0.1; 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.10.0; extra == "dev"
-Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: flake8>=7.3.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: mkdocs>=1.5.2; extra == "dev"
+Requires-Dist: mkdocs-material>=9.6.10; 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

{mojentic-0.9.0 → mojentic-1.0.0}/README.md

@@ -25,16 +25,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 .
 ```
 
@@ -153,11 +163,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

{mojentic-0.9.0 → mojentic-1.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mojentic"
-version = "0.9.0"
+version = "1.0.0"
 authors = [
     { name = "Stacey Vetzal", email = "stacey@vetzal.com" },
 ]
@@ -14,35 +14,35 @@ classifiers = [
 ]
 
 dependencies = [
-    "pydantic",
-    "structlog",
-    "numpy",
-    "ollama",
-    "openai",
-    "anthropic",
-    "tiktoken",
-    "parsedatetime",
-    "pytz",
-    "serpapi",
-    "colorama",
+    "pydantic>=2.8.0",
+    "structlog>=25.5.0",
+    "numpy>=2.3.5",
+    "ollama>=0.1.6",
+    "openai>=2.8.1",
+    "anthropic>=0.74.1",
+    "tiktoken>=0.12.0",
+    "parsedatetime>=2.6",
+    "pytz>=2025.2",
+    "serpapi>=0.1.5",
+    "colorama>=0.4.6",
 ]
 
 [project.optional-dependencies]
 dev = [
-    "pytest>=7.0.0",
-    "pytest-asyncio",
-    "pytest-spec",
-    "pytest-cov",
+    "pytest>=9.0.1",
+    "pytest-asyncio>=1.3.0",
+    "pytest-spec>=5.2.0",
+    "pytest-cov>=7.0.0",
     "pytest-mock>=3.10.0",
-    "flake8>=6.0.0",
+    "flake8>=7.3.0",
     "bandit>=1.7.0",
     "pip-audit>=2.0.0",
-    "mkdocs",
-    "mkdocs-material",
-    "mkdocs-llmstxt",
-    "mkdocstrings[python]",
-    "griffe-fieldz",
-    "pymdown-extensions",
+    "mkdocs>=1.5.2",
+    "mkdocs-material>=9.6.10",
+    "mkdocs-llmstxt>=0.4.0",
+    "mkdocstrings[python]>=0.21.0",
+    "griffe-fieldz>=0.3.0",
+    "pymdown-extensions>=10.3",
 ]
 
 [build-system]

{mojentic-0.9.0 → mojentic-1.0.0}/src/_examples/async_dispatcher_example.py

@@ -62,7 +62,11 @@ class TextAnalyzerAgent(BaseAsyncLLMAgent):
     def __init__(self, llm: LLMBroker):
         super().__init__(
             llm=llm,
-            behaviour="You are a text analysis assistant. Your job is to provide a detailed analysis of the given text, including key themes, structure, and notable elements.",
+            behaviour=(
+                "You are a text analysis assistant. "
+                "Your job is to provide a detailed analysis of the given text, "
+                "including key themes, structure, and notable elements."
+            ),
             response_model=AnalysisResponse
         )
 
@@ -93,7 +97,11 @@ class TextSummarizerAgent(BaseAsyncLLMAgent):
     def __init__(self, llm: LLMBroker):
         super().__init__(
             llm=llm,
-            behaviour="You are a text summarization assistant. Your job is to provide concise, accurate summaries of texts while preserving the key information and main points.",
+            behaviour=(
+                "You are a text summarization assistant. "
+                "Your job is to provide concise, accurate summaries of texts "
+                "while preserving the key information and main points."
+            ),
             response_model=SummaryResponse
         )
 
@@ -143,8 +151,8 @@ Analysis: {analysis_event.analysis}
 
 Summary: {summary_event.summary}
 
-Please create a well-structured, insightful report that integrates the analysis and summary, 
-highlighting the most important aspects of the text. The report should provide a comprehensive 
+Please create a well-structured, insightful report that integrates the analysis and summary,
+highlighting the most important aspects of the text. The report should provide a comprehensive
 understanding of the text's content, structure, and significance.
 """
             # Create a temporary LLM agent to generate the response

{mojentic-0.9.0 → mojentic-1.0.0}/src/_examples/async_llm_example.py

@@ -5,14 +5,13 @@ This script shows how to create and use asynchronous LLM agents with the AsyncDi
 """
 
 import asyncio
-from typing import List, Optional
+from typing import List
 
 from pydantic import BaseModel, Field
 
 from mojentic.agents.async_aggregator_agent import AsyncAggregatorAgent
 from mojentic.agents.async_llm_agent import BaseAsyncLLMAgent
 from mojentic.async_dispatcher import AsyncDispatcher
-from mojentic.context.shared_working_memory import SharedWorkingMemory
 from mojentic.event import Event
 from mojentic.llm import LLMBroker
 from mojentic.router import Router

mojentic-1.0.0/src/_examples/broker_as_tool.py

@@ -0,0 +1,83 @@
+import os
+from mojentic.agents.base_llm_agent import BaseLLMAgent
+from mojentic.llm.llm_broker import LLMBroker
+from mojentic.llm.tools.date_resolver import ResolveDateTool
+from mojentic.llm.tools.file_manager import ListFilesTool, ReadFileTool, WriteFileTool, FilesystemGateway
+from mojentic.llm.tools.tool_wrapper import ToolWrapper
+
+#
+# This is largely a fail, but it was interesting.
+#
+
+temporal_specialist = BaseLLMAgent(
+    llm=LLMBroker(model="qwen3:7b"),
+    tools=[ResolveDateTool()],
+    behaviour=(
+        "You are a historian and sociologist who focuses on sorting out temporal events, "
+        "determining what happened or will happen when."
+    )
+)
+
+if not os.path.exists("local"):
+    os.mkdir("local")
+
+# Create a filesystem gateway for the local directory
+fs = FilesystemGateway(base_path="local")
+
+knowledge_specialist = BaseLLMAgent(
+    llm=LLMBroker(model="qwen3:32b"),
+    tools=[
+        ListFilesTool(fs),
+        ReadFileTool(fs),
+        WriteFileTool(fs),
+    ],
+    behaviour=(
+        "You are a knowledge management agent who focuses on sorting out facts and information, "
+        "able to organize elemental ideas and make connections between them. You can list files "
+        "to find out where you stored information, read files to review that information, and "
+        "write files to store that information for later retrieval."
+    )
+)
+
+
+coordinator = BaseLLMAgent(
+    llm=LLMBroker(model="qwen3:32b"),
+    behaviour="You are a coordinator who can manage multiple agents and delegate tasks to them to solve problems.",
+    tools=[
+        ToolWrapper(
+            temporal_specialist,
+            "temporal_specialist",
+            "A historian and sociologist who focuses on sorting out temporal events, figuring out "
+            "dates, determining what happened or will happen when."
+        ),
+        ToolWrapper(
+            knowledge_specialist,
+            "knowledge_specialist",
+            "A knowledge management specialist who focuses on sorting out facts and information, "
+            "able to organize elemental ideas and make connections between them. Can list files to "
+            "find out where you stored information, read files to review that information, and "
+            "write files to store that information for later retrieval."
+        ),
+    ]
+)
+
+result = coordinator.generate_response(
+    """
+I have several things I need to do this week:
+
+- On Monday, I need to ensure that I have called Scotiabank and ordered replacement cards for "
+  "my current, credit, and line of credit accounts.
+- On Wednesday, I need to drive into Toronto for work. While in Toronto I need to pick up "
+  "razors. I need to make sure I see Gregg, Britney and Vikram.
+- On Thursday, I need to ensure I'm up by 7am so that I can be showered and ready for work by 9.
+- On Friday, I need to ensure that I have my laundry done and my bags packed for my trip to "
+  "Ottawa.
+
+Create me a markdown file for each day of the week, named "YYYY-MM-DD-ToDo.md" where the date "
+"is the date of that day.
+Make a list of to-do items in the markdown file, and add a section for the day's daily notes that "
+"I can fill out each day.
+"""
+)
+
+print(result)

{mojentic-0.9.0 → mojentic-1.0.0}/src/_examples/broker_examples.py

@@ -1,18 +1,16 @@
 import logging
 import os
-
-from mojentic.llm import LLMBroker
-from mojentic.llm.gateways import OpenAIGateway
-
-logging.basicConfig(level=logging.WARN)
-
 from pathlib import Path
 
 from pydantic import BaseModel, Field
 
+from mojentic.llm import LLMBroker
+from mojentic.llm.gateways import OpenAIGateway
 from mojentic.llm.gateways.models import LLMMessage
 from mojentic.llm.tools.date_resolver import ResolveDateTool
 
+logging.basicConfig(level=logging.WARN)
+
 
 def openai_llm(model="gpt-5"):
     api_key = os.getenv("OPENAI_API_KEY")

{mojentic-0.9.0 → mojentic-1.0.0}/src/_examples/characterize_ollama.py

@@ -1,7 +1,7 @@
 from ollama import chat
 from pydantic import BaseModel, Field
 
-from mojentic.llm.gateways.models import LLMMessage, MessageRole
+from mojentic.llm.gateways.models import LLMMessage
 from mojentic.llm.gateways.ollama import OllamaGateway
 from mojentic.llm.tools.date_resolver import ResolveDateTool
 

{mojentic-0.9.0 → mojentic-1.0.0}/src/_examples/characterize_openai.py

@@ -2,7 +2,7 @@ import os
 
 from pydantic import BaseModel, Field
 
-from mojentic.llm.gateways.models import LLMMessage, MessageRole
+from mojentic.llm.gateways.models import LLMMessage
 from mojentic.llm.gateways.openai import OpenAIGateway
 
 api_key = os.getenv("OPENAI_API_KEY")

{mojentic-0.9.0 → mojentic-1.0.0}/src/_examples/chat_session.py

@@ -9,4 +9,4 @@ while True:
         break
     else:
         response = chat_session.send(query)
-        print(response)
+        print(response)

{mojentic-0.9.0 → mojentic-1.0.0}/src/_examples/chat_session_with_tool.py

@@ -10,4 +10,4 @@ while True:
         break
     else:
         response = chat_session.send(query)
-        print(response)
+        print(response)

{mojentic-0.9.0 → mojentic-1.0.0}/src/_examples/coding_file_tool.py

@@ -30,7 +30,7 @@ from mojentic.llm.tools.file_manager import (
     EditFileWithDiffTool, CreateDirectoryTool, FilesystemGateway
 )
 
-base_dir = Path(__file__).parent.parent.parent.parent / "code-playground2"
+base_dir = Path(__file__).parent.parent.parent.parent / "code-playground3"
 
 # Initialize the LLM broker
 
@@ -38,9 +38,7 @@ api_key = os.getenv("OPENAI_API_KEY")
 gateway = OpenAIGateway(api_key)
 llm = LLMBroker(model="o4-mini", gateway=gateway)
 
-# llm = LLMBroker("qwen3-coder:30b")
 llm = LLMBroker("qwen3-coder:30b")
-# llm = LLMBroker(model="qwen3-128k:32b")
 
 # Create a filesystem gateway for the sandbox
 fs = FilesystemGateway(base_path=str(base_dir))

{mojentic-0.9.0 → mojentic-1.0.0}/src/_examples/current_datetime_tool_example.py

@@ -25,4 +25,4 @@ result = llm.generate(
 )
 
 print("\nLLM Response with custom format:")
-print(result)
+print(result)

{mojentic-0.9.0 → mojentic-1.0.0}/src/_examples/embeddings.py

@@ -6,4 +6,4 @@ ollama = OllamaGateway()
 print(len(ollama.calculate_embeddings("Hello, world!")))
 
 openai = OpenAIGateway(os.environ["OPENAI_API_KEY"])
-print(len(openai.calculate_embeddings("Hello, world!")))
+print(len(openai.calculate_embeddings("Hello, world!")))

{mojentic-0.9.0 → mojentic-1.0.0}/src/_examples/ephemeral_task_manager_example.py

@@ -2,13 +2,6 @@
 Example script demonstrating the usage of the ephemeral task manager tools.
 """
 import logging
-import os
-
-from mojentic.llm.gateways import OpenAIGateway
-
-logging.basicConfig(
-    level=logging.WARN
-)
 
 from mojentic.llm import LLMBroker
 from mojentic.llm.gateways.models import LLMMessage
@@ -24,13 +17,24 @@ from mojentic.llm.tools.ephemeral_task_manager import (
 )
 from mojentic.llm.tools.tell_user_tool import TellUserTool
 
+logging.basicConfig(
+    level=logging.WARN
+)
+
 # llm = LLMBroker(model="qwen3:30b-a3b-q4_K_M")
 # llm = LLMBroker(model="qwen3:32b")
 llm = LLMBroker(model="qwen3:7b")
 # llm = LLMBroker(model="qwen3:72b")
 # llm = LLMBroker(model="o4-mini", gateway=OpenAIGateway(os.environ["OPENAI_API_KEY"]))
 message = LLMMessage(
-    content="I want you to count from 1 to 10. Break that request down into individual tasks, track them using available tools, and perform them one by one until you're finished. Interrupt me to tell the user as you complete every task.")
+    content=(
+        "I want you to count from 1 to 10. "
+        "Break that request down into individual tasks, "
+        "track them using available tools, "
+        "and perform them one by one until you're finished. "
+        "Interrupt me to tell the user as you complete every task."
+    )
+)
 task_list = EphemeralTaskList()
 tools = [
     AppendTaskTool(task_list),
@@ -45,4 +49,4 @@ tools = [
 
 result = llm.generate(messages=[message], tools=tools, temperature=0.0)
 print(result)
-print(task_list.list_tasks())
+print(task_list.list_tasks())

{mojentic-0.9.0 → mojentic-1.0.0}/src/_examples/fetch_openai_models.py

@@ -5,6 +5,7 @@ Script to fetch current OpenAI models and update the registry with up-to-date mo
 import os
 from mojentic.llm.gateways.openai import OpenAIGateway
 
+
 def fetch_current_openai_models():
     """Fetch the current list of OpenAI models."""
     api_key = os.getenv("OPENAI_API_KEY")
@@ -20,6 +21,7 @@ def fetch_current_openai_models():
         print(f"ERROR: Failed to fetch models from OpenAI API: {e}")
         return None
 
+
 def categorize_models(models):
     """Categorize models by type based on naming patterns."""
     reasoning_models = []
@@ -32,7 +34,7 @@ def categorize_models(models):
 
         # Reasoning models: o1, o3, o4, and gpt-5 series
         if (any(pattern in model_lower for pattern in ['o1-', 'o3-', 'o4-', 'gpt-5']) or
-            model_lower in ['o1', 'o3', 'o4', 'gpt-5']):
+                model_lower in ['o1', 'o3', 'o4', 'gpt-5']):
             reasoning_models.append(model)
         elif 'embedding' in model_lower:
             embedding_models.append(model)
@@ -48,6 +50,7 @@ def categorize_models(models):
         'other': sorted(other_models)
     }
 
+
 def print_model_lists(categorized_models):
     """Print the categorized models in a format ready for the registry."""
     print("=== Current OpenAI Models ===\n")
@@ -84,6 +87,7 @@ def print_model_lists(categorized_models):
         print(f'#     "{model}",')
     print("# ]\n")
 
+
 if __name__ == "__main__":
     print("Fetching current OpenAI models...")
     models = fetch_current_openai_models()
@@ -99,6 +103,9 @@ if __name__ == "__main__":
         print(f"Embedding models: {len(categorized['embedding'])}")
         print(f"Other models: {len(categorized['other'])}")
 
-        print("\nCopy the model lists above and update the _initialize_default_models() method in openai_model_registry.py")
+        print(
+            "\nCopy the model lists above and update the "
+            "_initialize_default_models() method in openai_model_registry.py"
+        )
     else:
-        print("Failed to fetch models. Please check your API key and try again.")
+        print("Failed to fetch models. Please check your API key and try again.")

{mojentic-0.9.0 → mojentic-1.0.0}/src/_examples/file_deduplication.py

@@ -14,9 +14,9 @@ message_builder.add_images(image_path, image_path)  # Adding the same image twic
 
 # Build the message and check the number of images
 message = message_builder.build()
-print(f"Number of images in message: {len(message.image_paths)}")
-print(f"Expected number of images: 1")
-print(f"De-duplication working: {len(message.image_paths) == 1}")
+print("Number of images in message: {len(message.image_paths)}")
+print("Expected number of images: 1")
+print("De-duplication working: {len(message.image_paths) == 1}")
 
 # Test de-duplication of files
 print("\nTesting file de-duplication:")
@@ -31,8 +31,8 @@ message_builder.add_files(file_path, file_path)  # Adding the same file twice mo
 # Build the message and check the number of files
 message = message_builder.build()
 # Since we're using the file content in the message, we need to check file_paths directly
-print(f"Number of files in message_builder.file_paths: {len(message_builder.file_paths)}")
-print(f"Expected number of files: 1")
-print(f"De-duplication working: {len(message_builder.file_paths) == 1}")
+print("Number of files in message_builder.file_paths: {len(message_builder.file_paths)}")
+print("Expected number of files: 1")
+print("De-duplication working: {len(message_builder.file_paths) == 1}")
 
 print("\nTest completed.")

{mojentic-0.9.0 → mojentic-1.0.0}/src/_examples/image_analysis.py

@@ -1,7 +1,6 @@
-import os
 from pathlib import Path
 
-from mojentic.llm.gateways import OllamaGateway, OpenAIGateway
+from mojentic.llm.gateways import OllamaGateway
 from mojentic.llm.gateways.models import LLMMessage
 
 llmg = OllamaGateway()
@@ -18,4 +17,4 @@ response = llmg.complete(
     ],
 )
 
-print(response)
+print(response)

{mojentic-0.9.0 → mojentic-1.0.0}/src/_examples/image_broker.py

@@ -1,7 +1,7 @@
 from pathlib import Path
 
 from mojentic.llm import LLMBroker
-from mojentic.llm.message_composers import MessagesBuilder, MessageBuilder
+from mojentic.llm.message_composers import MessageBuilder
 
 llm = LLMBroker(model="gemma3:27b")
 

{mojentic-0.9.0 → mojentic-1.0.0}/src/_examples/image_broker_splat.py

@@ -47,4 +47,4 @@ print(f"Example 4: Added {len(message4.image_paths)} image(s)")
 # Generate a response using one of the messages (e.g., message1)
 print("\nGenerating response for Example 1...")
 result = llm.generate(messages=[message1])
-print(result)
+print(result)

{mojentic-0.9.0 → mojentic-1.0.0}/src/_examples/model_characterization.py

@@ -2,6 +2,7 @@ import os
 from mojentic.llm.gateways.openai import OpenAIGateway
 from mojentic.llm.gateways.models import LLMMessage, MessageRole
 
+
 def check_model_characterization():
     """
     Test the model characterization functionality with different OpenAI models.
@@ -69,5 +70,6 @@ def check_model_characterization():
     print("\n" + "=" * 60)
     print("Model characterization test completed!")
 
+
 if __name__ == "__main__":
     check_model_characterization()