praisonai-plugins 0.0.2__tar.gz

praisonai_plugins-0.0.2/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: praisonai-plugins
+Version: 0.0.2
+Summary: Protocol-driven plugins for PraisonAI Agents
+Author: Mervin Praison
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: praisonaiagents>=0.1.0
+
+# PraisonAI Plugins
+
+Protocol-driven plugins for PraisonAI Agents. This repository contains officially supported plugins that hook into the core agent lifecycle events.
+
+## Installation
+
+```bash
+pip install praisonai-plugins
+```
+
+If you are developing plugins locally:
+```bash
+git clone https://github.com/MervinPraison/PraisonAI-Plugins.git
+cd PraisonAI-Plugins
+pip install -e .
+```
+
+## How It Works
+
+PraisonAI's core SDK introduces a `discover_entry_points()` mechanism in its `PluginManager`. 
+When you install `praisonai-plugins`, the entry points declared in `pyproject.toml` are registered in your Python environment under the `praisonai.plugins` group.
+
+To load them in your agent:
+
+```python
+from praisonaiagents.plugins.manager import get_plugin_manager
+
+manager = get_plugin_manager()
+manager.discover_entry_points()
+
+# Your agent will now use the installed plugins!
+from praisonaiagents import Agent
+agent = Agent(name="Assistant", instructions="Be helpful.")
+agent.start("Hello!")
+```
+
+## Adding New Plugins
+
+1. Create your plugin class extending `praisonaiagents.plugins.plugin.Plugin`.
+2. Implement your desired hooks (`before_agent`, `after_tool`, etc.).
+3. Add an entry to the `[project.entry-points."praisonai.plugins"]` section in `pyproject.toml`.
+4. Run `pip install -e .` to register your new entry point during testing.

praisonai_plugins-0.0.2/README.md

@@ -0,0 +1,42 @@
+# PraisonAI Plugins
+
+Protocol-driven plugins for PraisonAI Agents. This repository contains officially supported plugins that hook into the core agent lifecycle events.
+
+## Installation
+
+```bash
+pip install praisonai-plugins
+```
+
+If you are developing plugins locally:
+```bash
+git clone https://github.com/MervinPraison/PraisonAI-Plugins.git
+cd PraisonAI-Plugins
+pip install -e .
+```
+
+## How It Works
+
+PraisonAI's core SDK introduces a `discover_entry_points()` mechanism in its `PluginManager`. 
+When you install `praisonai-plugins`, the entry points declared in `pyproject.toml` are registered in your Python environment under the `praisonai.plugins` group.
+
+To load them in your agent:
+
+```python
+from praisonaiagents.plugins.manager import get_plugin_manager
+
+manager = get_plugin_manager()
+manager.discover_entry_points()
+
+# Your agent will now use the installed plugins!
+from praisonaiagents import Agent
+agent = Agent(name="Assistant", instructions="Be helpful.")
+agent.start("Hello!")
+```
+
+## Adding New Plugins
+
+1. Create your plugin class extending `praisonaiagents.plugins.plugin.Plugin`.
+2. Implement your desired hooks (`before_agent`, `after_tool`, etc.).
+3. Add an entry to the `[project.entry-points."praisonai.plugins"]` section in `pyproject.toml`.
+4. Run `pip install -e .` to register your new entry point during testing.

praisonai_plugins-0.0.2/praisonai_plugins/__init__.py

@@ -0,0 +1,3 @@
+"""
+PraisonAI Plugins Hub.
+"""

praisonai_plugins-0.0.2/praisonai_plugins/hooks/__init__.py

@@ -0,0 +1,3 @@
+"""
+Protocol-driven Hook Plugins for PraisonAI.
+"""

praisonai_plugins-0.0.2/praisonai_plugins/hooks/simple_logger.py

@@ -0,0 +1,45 @@
+"""
+Simple Logger Plugin for PraisonAI Agents.
+"""
+from praisonaiagents.plugins.plugin import Plugin, PluginInfo, PluginHook
+from praisonaiagents._logging import get_logger
+from typing import Dict, Any
+
+logger = get_logger(__name__)
+
+class SimpleLoggerPlugin(Plugin):
+    """
+    A simple protocol-driven plugin that logs when an agent starts and finishes,
+    and when a tool is called and finishes.
+    """
+    
+    @property
+    def info(self) -> PluginInfo:
+        return PluginInfo(
+            name="simple_logger",
+            version="1.0.0",
+            description="Logs agent and tool execution steps.",
+            author="PraisonAI",
+            hooks=[
+                PluginHook.BEFORE_AGENT,
+                PluginHook.AFTER_AGENT,
+                PluginHook.BEFORE_TOOL,
+                PluginHook.AFTER_TOOL
+            ]
+        )
+        
+    def before_agent(self, prompt: str, context: Dict[str, Any]) -> str:
+        logger.info(f"Agent starting with prompt length: {len(prompt)}")
+        return prompt
+        
+    def after_agent(self, response: str, context: Dict[str, Any]) -> str:
+        logger.info(f"Agent finished. Response length: {len(response)}")
+        return response
+        
+    def before_tool(self, tool_name: str, args: Dict[str, Any]) -> Dict[str, Any]:
+        logger.info(f"Tool executing: {tool_name} with args: {args}")
+        return args
+        
+    def after_tool(self, tool_name: str, result: Any) -> Any:
+        logger.info(f"Tool {tool_name} finished. Result: {result}")
+        return result

praisonai_plugins-0.0.2/praisonai_plugins/observability/__init__.py

@@ -0,0 +1,3 @@
+"""
+Protocol-driven Observability Plugins for PraisonAI.
+"""

praisonai_plugins-0.0.2/praisonai_plugins/observability/custom_tracer.py

@@ -0,0 +1,35 @@
+"""
+Custom Tracer Plugin for PraisonAI Agents.
+"""
+from praisonaiagents.plugins.plugin import Plugin, PluginInfo, PluginHook
+from praisonaiagents._logging import get_logger
+from typing import Dict, Any, List
+
+logger = get_logger(__name__)
+
+class CustomTracerPlugin(Plugin):
+    """
+    A simple protocol-driven plugin that traces LLM calls.
+    """
+    
+    @property
+    def info(self) -> PluginInfo:
+        return PluginInfo(
+            name="custom_tracer",
+            version="1.0.0",
+            description="Traces LLM completion calls.",
+            author="PraisonAI",
+            hooks=[
+                PluginHook.BEFORE_LLM,
+                PluginHook.AFTER_LLM
+            ]
+        )
+        
+    def before_llm(self, messages: List[Dict], params: Dict[str, Any]) -> tuple:
+        logger.info(f"[Trace] Sending {len(messages)} messages to LLM model {params.get('model', 'unknown')}")
+        return messages, params
+        
+    def after_llm(self, response: str, usage: Dict[str, Any]) -> str:
+        tokens = usage.get('total_tokens', 0) if usage else 0
+        logger.info(f"[Trace] LLM responded. Tokens used: {tokens}")
+        return response

praisonai_plugins-0.0.2/praisonai_plugins.egg-info/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: praisonai-plugins
+Version: 0.0.2
+Summary: Protocol-driven plugins for PraisonAI Agents
+Author: Mervin Praison
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: praisonaiagents>=0.1.0
+
+# PraisonAI Plugins
+
+Protocol-driven plugins for PraisonAI Agents. This repository contains officially supported plugins that hook into the core agent lifecycle events.
+
+## Installation
+
+```bash
+pip install praisonai-plugins
+```
+
+If you are developing plugins locally:
+```bash
+git clone https://github.com/MervinPraison/PraisonAI-Plugins.git
+cd PraisonAI-Plugins
+pip install -e .
+```
+
+## How It Works
+
+PraisonAI's core SDK introduces a `discover_entry_points()` mechanism in its `PluginManager`. 
+When you install `praisonai-plugins`, the entry points declared in `pyproject.toml` are registered in your Python environment under the `praisonai.plugins` group.
+
+To load them in your agent:
+
+```python
+from praisonaiagents.plugins.manager import get_plugin_manager
+
+manager = get_plugin_manager()
+manager.discover_entry_points()
+
+# Your agent will now use the installed plugins!
+from praisonaiagents import Agent
+agent = Agent(name="Assistant", instructions="Be helpful.")
+agent.start("Hello!")
+```
+
+## Adding New Plugins
+
+1. Create your plugin class extending `praisonaiagents.plugins.plugin.Plugin`.
+2. Implement your desired hooks (`before_agent`, `after_tool`, etc.).
+3. Add an entry to the `[project.entry-points."praisonai.plugins"]` section in `pyproject.toml`.
+4. Run `pip install -e .` to register your new entry point during testing.

praisonai_plugins-0.0.2/praisonai_plugins.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+praisonai_plugins/__init__.py
+praisonai_plugins.egg-info/PKG-INFO
+praisonai_plugins.egg-info/SOURCES.txt
+praisonai_plugins.egg-info/dependency_links.txt
+praisonai_plugins.egg-info/entry_points.txt
+praisonai_plugins.egg-info/requires.txt
+praisonai_plugins.egg-info/top_level.txt
+praisonai_plugins/hooks/__init__.py
+praisonai_plugins/hooks/simple_logger.py
+praisonai_plugins/observability/__init__.py
+praisonai_plugins/observability/custom_tracer.py

praisonai_plugins-0.0.2/praisonai_plugins.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

praisonai_plugins-0.0.2/praisonai_plugins.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[praisonai.plugins]
+custom_tracer = praisonai_plugins.observability.custom_tracer:CustomTracerPlugin
+simple_logger = praisonai_plugins.hooks.simple_logger:SimpleLoggerPlugin

praisonai_plugins-0.0.2/praisonai_plugins.egg-info/requires.txt

@@ -0,0 +1 @@
+praisonaiagents>=0.1.0

praisonai_plugins-0.0.2/praisonai_plugins.egg-info/top_level.txt

@@ -0,0 +1 @@
+praisonai_plugins

praisonai_plugins-0.0.2/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "praisonai-plugins"
+version = "0.0.2"
+description = "Protocol-driven plugins for PraisonAI Agents"
+authors = [
+    {name = "Mervin Praison"},
+]
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "praisonaiagents>=0.1.0",
+]
+
+[project.entry-points."praisonai.plugins"]
+simple_logger = "praisonai_plugins.hooks.simple_logger:SimpleLoggerPlugin"
+custom_tracer = "praisonai_plugins.observability.custom_tracer:CustomTracerPlugin"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["praisonai_plugins", "praisonai_plugins.*"]

praisonai_plugins-0.0.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+