swarmauri 0.7.3.dev2__tar.gz → 0.7.4.dev18__tar.gz

{swarmauri-0.7.3.dev2 → swarmauri-0.7.4.dev18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: swarmauri
-Version: 0.7.3.dev2
+Version: 0.7.4.dev18
 Summary: Namespace package for components, packages, and plugins within the Swarmauri framework.
 License: Apache-2.0
 Author: Jacob Stewart
@@ -40,8 +40,8 @@ Description-Content-Type: text/markdown
 <p align="center">
     <a href="https://pypi.org/project/swarmauri/">
         <img src="https://img.shields.io/pypi/dm/swarmauri" alt="PyPI - Downloads"/></a>
-    <a href="https://github.com/swarmauri/swarmauri-sdk/blob/master/pkgs/swarmauri/README.md">
-        <img src="https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https://github.com/swarmauri/swarmauri-sdk/pkgs/swarmauri/README.md&count_bg=%2379C83D&title_bg=%23555555&icon=&icon_color=%23E7E7E7&title=hits&edge_flat=false" alt="GitHub Hits"/></a>
+    <a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/swarmauri/">
+        <img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/swarmauri.svg"/></a>
     <a href="https://pypi.org/project/swarmauri/">
         <img src="https://img.shields.io/pypi/pyversions/swarmauri" alt="PyPI - Python Version"/></a>
     <a href="https://pypi.org/project/swarmauri/">
@@ -54,7 +54,18 @@ Description-Content-Type: text/markdown
 
 # Swarmauri SDK
 
-The Swarmauri SDK offers a comprehensive suite of tools designed for building distributed, extensible systems using the Swarmauri framework. 
+The Swarmauri SDK offers a comprehensive suite of tools designed for building distributed, extensible systems using the Swarmauri framework.
+
+## Swarmauri Namespace Microkernel
+
+The `swarmauri` package is implemented as a namespace microkernel. When the
+package is imported it registers a custom importer that consults the interface
+and plugin citizenship registries to locate actual implementations. This design
+keeps the namespace lightweight while still allowing first-party and community
+plugins to be discovered and loaded on demand. New resource kinds are declared
+in `interface_registry.py`, then mapped to plugin modules via
+`plugin_citizenship_registry.py`. For a deeper look at the import flow, see
+[`docs/callflow.md`](docs/callflow.md).
 
 ## Core 
 - **Core Interfaces**: Define the fundamental communication and data-sharing protocols between components in a Swarmauri-based system.
@@ -76,7 +87,7 @@ The Swarmauri SDK offers a comprehensive suite of tools designed for building di
 - **Polymorphism**: Allows for dynamic behavior switching between components, enabling flexible, context-aware system behavior.
 - **Discriminated Unions**: Provides a robust method for handling multiple possible object types in a type-safe manner.
 - **Serialization**: Efficiently encode and decode data for transmission across different environments and system components, with support for both standard and custom serialization formats.
-- **Intensional and Extensional Programming**: Leverages both rule-based (intensional) and set-based (extensional) approaches to building and manipulating complex data structures, offering developers a wide range of tools for system design.
+- **Intensional and Extensional Programming**: The microkernel continues to leverage both rule-based (intensional) patterns and set-based (extensional) plugin discovery, allowing you to build and manipulate complex data structures with ease.
 
 ## Use Cases
 
@@ -100,6 +111,10 @@ The Swarmauri SDK is an evolving platform, and the community is encouraged to co
 ### Plugin Citizenship Registry
 - [plugin_citizenship_registry.py](swarmauri/plugin_citizenship_registry.py): Maintains a registry of plugins and their citizenship status within the Swarmauri ecosystem.
 
+When introducing a new resource kind or class, remember to update both the
+`plugin_citizenship_registry.py` and `interface_registry.py` so the framework can
+discover and validate your additions.
+
 ### Plugin Manager
 - [plugin_manager.py](swarmauri/plugin_manager.py): Oversees the loading, initialization, and management of plugins to extend the functionality of the Swarmauri framework.
 

{swarmauri-0.7.3.dev2 → swarmauri-0.7.4.dev18}/README.md

@@ -3,8 +3,8 @@
 <p align="center">
     <a href="https://pypi.org/project/swarmauri/">
         <img src="https://img.shields.io/pypi/dm/swarmauri" alt="PyPI - Downloads"/></a>
-    <a href="https://github.com/swarmauri/swarmauri-sdk/blob/master/pkgs/swarmauri/README.md">
-        <img src="https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https://github.com/swarmauri/swarmauri-sdk/pkgs/swarmauri/README.md&count_bg=%2379C83D&title_bg=%23555555&icon=&icon_color=%23E7E7E7&title=hits&edge_flat=false" alt="GitHub Hits"/></a>
+    <a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/swarmauri/">
+        <img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/swarmauri.svg"/></a>
     <a href="https://pypi.org/project/swarmauri/">
         <img src="https://img.shields.io/pypi/pyversions/swarmauri" alt="PyPI - Python Version"/></a>
     <a href="https://pypi.org/project/swarmauri/">
@@ -17,7 +17,18 @@
 
 # Swarmauri SDK
 
-The Swarmauri SDK offers a comprehensive suite of tools designed for building distributed, extensible systems using the Swarmauri framework. 
+The Swarmauri SDK offers a comprehensive suite of tools designed for building distributed, extensible systems using the Swarmauri framework.
+
+## Swarmauri Namespace Microkernel
+
+The `swarmauri` package is implemented as a namespace microkernel. When the
+package is imported it registers a custom importer that consults the interface
+and plugin citizenship registries to locate actual implementations. This design
+keeps the namespace lightweight while still allowing first-party and community
+plugins to be discovered and loaded on demand. New resource kinds are declared
+in `interface_registry.py`, then mapped to plugin modules via
+`plugin_citizenship_registry.py`. For a deeper look at the import flow, see
+[`docs/callflow.md`](docs/callflow.md).
 
 ## Core 
 - **Core Interfaces**: Define the fundamental communication and data-sharing protocols between components in a Swarmauri-based system.
@@ -39,7 +50,7 @@ The Swarmauri SDK offers a comprehensive suite of tools designed for building di
 - **Polymorphism**: Allows for dynamic behavior switching between components, enabling flexible, context-aware system behavior.
 - **Discriminated Unions**: Provides a robust method for handling multiple possible object types in a type-safe manner.
 - **Serialization**: Efficiently encode and decode data for transmission across different environments and system components, with support for both standard and custom serialization formats.
-- **Intensional and Extensional Programming**: Leverages both rule-based (intensional) and set-based (extensional) approaches to building and manipulating complex data structures, offering developers a wide range of tools for system design.
+- **Intensional and Extensional Programming**: The microkernel continues to leverage both rule-based (intensional) patterns and set-based (extensional) plugin discovery, allowing you to build and manipulate complex data structures with ease.
 
 ## Use Cases
 
@@ -63,6 +74,10 @@ The Swarmauri SDK is an evolving platform, and the community is encouraged to co
 ### Plugin Citizenship Registry
 - [plugin_citizenship_registry.py](swarmauri/plugin_citizenship_registry.py): Maintains a registry of plugins and their citizenship status within the Swarmauri ecosystem.
 
+When introducing a new resource kind or class, remember to update both the
+`plugin_citizenship_registry.py` and `interface_registry.py` so the framework can
+discover and validate your additions.
+
 ### Plugin Manager
 - [plugin_manager.py](swarmauri/plugin_manager.py): Oversees the loading, initialization, and management of plugins to extend the functionality of the Swarmauri framework.
 

{swarmauri-0.7.3.dev2 → swarmauri-0.7.4.dev18}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "swarmauri"
-version = "0.7.3.dev2"
+version = "0.7.4.dev18"
 description = "Namespace package for components, packages, and plugins within the Swarmauri framework."
 license = "Apache-2.0"
 readme = "README.md"

{swarmauri-0.7.3.dev2 → swarmauri-0.7.4.dev18}/swarmauri/interface_registry.py

@@ -46,6 +46,10 @@ from swarmauri_base.tools.ToolBase import ToolBase
 from swarmauri_base.transports.TransportBase import TransportBase
 from swarmauri_base.vector_stores.VectorStoreBase import VectorStoreBase
 from swarmauri_base.vectors.VectorBase import VectorBase
+from swarmauri_base.logger_formatters.FormatterBase import FormatterBase
+from swarmauri_base.loggers.LoggerBase import LoggerBase
+from swarmauri_base.logger_handlers.HandlerBase import HandlerBase
+from swarmauri_base.rate_limits.RateLimitBase import RateLimitBase
 
 # Configure logging
 logger = logging.getLogger(__name__)
@@ -99,6 +103,10 @@ class InterfaceRegistry:
         "swarmauri.utils": None,
         "swarmauri.vector_stores": VectorStoreBase,
         "swarmauri.vectors": VectorBase,
+        "swarmauri.logger_formatters": FormatterBase,
+        "swarmauri.loggers": LoggerBase,
+        "swarmauri.logger_handlers": HandlerBase,
+        "swarmauri.rate_limits": RateLimitBase,
     }
 
     @classmethod

{swarmauri-0.7.3.dev2 → swarmauri-0.7.4.dev18}/swarmauri/plugin_citizenship_registry.py

@@ -112,6 +112,7 @@ class PluginCitizenshipRegistry:
         "swarmauri.llms.AI21StudioModel": "swarmauri_standard.llms.AI21StudioModel",
         "swarmauri.llms.AnthropicModel": "swarmauri_standard.llms.AnthropicModel",
         "swarmauri.llms.AnthropicToolModel": "swarmauri_standard.llms.AnthropicToolModel",
+        "swarmauri.llms.CerebrasModel": "swarmauri_standard.llms.CerebrasModel",
         "swarmauri.llms.CohereModel": "swarmauri_standard.llms.CohereModel",
         "swarmauri.llms.CohereToolModel": "swarmauri_standard.llms.CohereToolModel",
         "swarmauri.llms.DeepInfraModel": "swarmauri_standard.llms.DeepInfraModel",
@@ -272,6 +273,10 @@ class PluginCitizenshipRegistry:
         "swarmauri.embeddings.NmfEmbedding": "swarmauri_embedding_nmf.NmfEmbedding",
         "swarmauri.parsers.BeautifulSoupElementParser": "swarmauri_parser_beautifulsoupelement.BeautifulSoupElementParser",
         "swarmauri.distances.MinkowskiDistance": "swarmauri_distance_minkowski.MinkowskiDistance",
+        "swarmauri.loggers.Logger": "swarmauri_standard.loggers.Logger",
+        "swarmauri.logger_handlers.StreamHandler": "swarmauri_standard.logger_handlers.StreamHandler",
+        "swarmauri.logger_formatters.LoggerFormatter": "swarmauri_standard.logger_formatters.LoggerFormatter",
+        "swarmauri.rate_limits.TokenBucketRateLimit": "swarmauri_standard.rate_limits.TokenBucketRateLimit",
     }
     SECOND_CLASS_REGISTRY: Dict[str, str] = {}
     THIRD_CLASS_REGISTRY: Dict[str, str] = {}