praisonAI 2.6.2__tar.gz → 2.6.4__tar.gz

{praisonai-2.6.2 → praisonai-2.6.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 2.6.2
+Version: 2.6.4
 Summary: PraisonAI is an AI Agents Framework with Self Reflection. PraisonAI application combines PraisonAI Agents, AutoGen, and CrewAI into a low-code solution for building and managing multi-agent LLM systems, focusing on simplicity, customisation, and efficient human-agent collaboration.
 Author: Mervin Praison
 License: MIT
@@ -11,7 +11,7 @@ Description-Content-Type: text/markdown
 Requires-Dist: rich>=13.7
 Requires-Dist: markdown>=3.5
 Requires-Dist: pyparsing>=3.0.0
-Requires-Dist: praisonaiagents>=0.4.0
+Requires-Dist: praisonaiagents>=0.4.1
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: instructor>=1.3.3
 Requires-Dist: PyYAML>=6.0
@@ -2091,18 +2091,22 @@ manager.delete_checkpoint("deploy-v1")
 
 ### Tools CLI:
 ```bash
-# List all available tools
 praisonai tools list
-
-# Get info about a specific tool
 praisonai tools info internet_search
-
-# Search for tools
 praisonai tools search "web"
-
-# Show all commands
-praisonai tools help
-```
+praisonai tools doctor
+praisonai tools resolve shell_tool
+praisonai tools discover
+praisonai tools show-sources
+praisonai tools show-sources --template ai-video-editor
+```
+
+| Command | Example | Docs |
+|---------|---------|------|
+| `tools list` | [example](examples/tools/) | [docs](https://docs.praison.ai/docs/cli/tools) |
+| `tools resolve` | [example](examples/tools/example_tools_resolve.py) | [docs](https://docs.praison.ai/docs/cli/tools-resolve) |
+| `tools discover` | [example](examples/tools/example_tools_discover.py) | [docs](https://docs.praison.ai/docs/cli/tools-discover) |
+| `tools show-sources` | [example](examples/tools/example_tools_sources.py) | [docs](https://docs.praison.ai/docs/cli/tools-show-sources) |
 
 ### Handoff CLI:
 ```bash

{praisonai-2.6.2 → praisonai-2.6.4}/PraisonAI.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 2.6.2
+Version: 2.6.4
 Summary: PraisonAI is an AI Agents Framework with Self Reflection. PraisonAI application combines PraisonAI Agents, AutoGen, and CrewAI into a low-code solution for building and managing multi-agent LLM systems, focusing on simplicity, customisation, and efficient human-agent collaboration.
 Author: Mervin Praison
 License: MIT
@@ -11,7 +11,7 @@ Description-Content-Type: text/markdown
 Requires-Dist: rich>=13.7
 Requires-Dist: markdown>=3.5
 Requires-Dist: pyparsing>=3.0.0
-Requires-Dist: praisonaiagents>=0.4.0
+Requires-Dist: praisonaiagents>=0.4.1
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: instructor>=1.3.3
 Requires-Dist: PyYAML>=6.0
@@ -2091,18 +2091,22 @@ manager.delete_checkpoint("deploy-v1")
 
 ### Tools CLI:
 ```bash
-# List all available tools
 praisonai tools list
-
-# Get info about a specific tool
 praisonai tools info internet_search
-
-# Search for tools
 praisonai tools search "web"
-
-# Show all commands
-praisonai tools help
-```
+praisonai tools doctor
+praisonai tools resolve shell_tool
+praisonai tools discover
+praisonai tools show-sources
+praisonai tools show-sources --template ai-video-editor
+```
+
+| Command | Example | Docs |
+|---------|---------|------|
+| `tools list` | [example](examples/tools/) | [docs](https://docs.praison.ai/docs/cli/tools) |
+| `tools resolve` | [example](examples/tools/example_tools_resolve.py) | [docs](https://docs.praison.ai/docs/cli/tools-resolve) |
+| `tools discover` | [example](examples/tools/example_tools_discover.py) | [docs](https://docs.praison.ai/docs/cli/tools-discover) |
+| `tools show-sources` | [example](examples/tools/example_tools_sources.py) | [docs](https://docs.praison.ai/docs/cli/tools-show-sources) |
 
 ### Handoff CLI:
 ```bash

{praisonai-2.6.2 → praisonai-2.6.4}/PraisonAI.egg-info/SOURCES.txt

@@ -27,6 +27,33 @@ praisonai/adapters/rerankers.py
 praisonai/adapters/retrievers.py
 praisonai/adapters/vector_stores.py
 praisonai/api/call.py
+praisonai/capabilities/__init__.py
+praisonai/capabilities/a2a.py
+praisonai/capabilities/assistants.py
+praisonai/capabilities/audio.py
+praisonai/capabilities/batches.py
+praisonai/capabilities/completions.py
+praisonai/capabilities/container_files.py
+praisonai/capabilities/containers.py
+praisonai/capabilities/embeddings.py
+praisonai/capabilities/files.py
+praisonai/capabilities/fine_tuning.py
+praisonai/capabilities/guardrails.py
+praisonai/capabilities/images.py
+praisonai/capabilities/mcp.py
+praisonai/capabilities/messages.py
+praisonai/capabilities/moderations.py
+praisonai/capabilities/ocr.py
+praisonai/capabilities/passthrough.py
+praisonai/capabilities/rag.py
+praisonai/capabilities/realtime.py
+praisonai/capabilities/rerank.py
+praisonai/capabilities/responses.py
+praisonai/capabilities/search.py
+praisonai/capabilities/skills.py
+praisonai/capabilities/vector_store_files.py
+praisonai/capabilities/vector_stores.py
+praisonai/capabilities/videos.py
 praisonai/chat/__init__.py
 praisonai/chat/app.py
 praisonai/cli/__init__.py
@@ -40,6 +67,7 @@ praisonai/cli/features/auto_memory.py
 praisonai/cli/features/autonomy_mode.py
 praisonai/cli/features/background.py
 praisonai/cli/features/base.py
+praisonai/cli/features/capabilities.py
 praisonai/cli/features/checkpoints.py
 praisonai/cli/features/compaction.py
 praisonai/cli/features/compare.py
@@ -62,6 +90,7 @@ praisonai/cli/features/message_queue.py
 praisonai/cli/features/metrics.py
 praisonai/cli/features/n8n.py
 praisonai/cli/features/observability.py
+praisonai/cli/features/ollama.py
 praisonai/cli/features/output_style.py
 praisonai/cli/features/persistence.py
 praisonai/cli/features/profile.py

{praisonai-2.6.2 → praisonai-2.6.4}/PraisonAI.egg-info/requires.txt

@@ -1,7 +1,7 @@
 rich>=13.7
 markdown>=3.5
 pyparsing>=3.0.0
-praisonaiagents>=0.4.0
+praisonaiagents>=0.4.1
 python-dotenv>=0.19.0
 instructor>=1.3.3
 PyYAML>=6.0

{praisonai-2.6.2 → praisonai-2.6.4}/README.md

@@ -1994,18 +1994,22 @@ manager.delete_checkpoint("deploy-v1")
 
 ### Tools CLI:
 ```bash
-# List all available tools
 praisonai tools list
-
-# Get info about a specific tool
 praisonai tools info internet_search
-
-# Search for tools
 praisonai tools search "web"
-
-# Show all commands
-praisonai tools help
-```
+praisonai tools doctor
+praisonai tools resolve shell_tool
+praisonai tools discover
+praisonai tools show-sources
+praisonai tools show-sources --template ai-video-editor
+```
+
+| Command | Example | Docs |
+|---------|---------|------|
+| `tools list` | [example](examples/tools/) | [docs](https://docs.praison.ai/docs/cli/tools) |
+| `tools resolve` | [example](examples/tools/example_tools_resolve.py) | [docs](https://docs.praison.ai/docs/cli/tools-resolve) |
+| `tools discover` | [example](examples/tools/example_tools_discover.py) | [docs](https://docs.praison.ai/docs/cli/tools-discover) |
+| `tools show-sources` | [example](examples/tools/example_tools_sources.py) | [docs](https://docs.praison.ai/docs/cli/tools-show-sources) |
 
 ### Handoff CLI:
 ```bash

praisonai-2.6.4/praisonai/capabilities/__init__.py

@@ -0,0 +1,275 @@
+"""
+PraisonAI Capabilities Module
+
+This module provides LiteLLM endpoint capability parity for PraisonAI.
+All capabilities are lazy-loaded to minimize import overhead.
+
+Capabilities:
+- audio: Transcription and text-to-speech
+- images: Image generation and editing
+- videos: Video generation
+- files: File upload and management
+- batches: Batch processing
+- vector_stores: Vector store management
+- embeddings: Text embeddings
+- rerank: Document reranking
+- moderations: Content moderation
+- ocr: Optical character recognition
+- assistants: OpenAI-style assistants
+- fine_tuning: Model fine-tuning
+- responses: Response management
+- passthrough: Generic API passthrough
+- containers: Container management
+- search: Search capabilities
+- a2a: Agent-to-agent gateway
+"""
+
+__all__ = [
+    # Audio
+    'transcribe',
+    'atranscribe',
+    'speech',
+    'aspeech',
+    # Images
+    'image_generate',
+    'aimage_generate',
+    'image_edit',
+    'aimage_edit',
+    # Videos
+    'video_generate',
+    'avideo_generate',
+    # Files
+    'file_create',
+    'afile_create',
+    'file_list',
+    'afile_list',
+    'file_retrieve',
+    'afile_retrieve',
+    'file_delete',
+    'afile_delete',
+    'file_content',
+    'afile_content',
+    # Batches
+    'batch_create',
+    'abatch_create',
+    'batch_list',
+    'abatch_list',
+    'batch_retrieve',
+    'abatch_retrieve',
+    'batch_cancel',
+    'abatch_cancel',
+    # Vector Stores
+    'vector_store_create',
+    'avector_store_create',
+    'vector_store_search',
+    'avector_store_search',
+    # Embeddings
+    'embed',
+    'aembed',
+    # Rerank
+    'rerank',
+    'arerank',
+    # Moderations
+    'moderate',
+    'amoderate',
+    # OCR
+    'ocr',
+    'aocr',
+    # Assistants
+    'assistant_create',
+    'aassistant_create',
+    'assistant_list',
+    'aassistant_list',
+    # Fine-tuning
+    'fine_tuning_create',
+    'afine_tuning_create',
+    'fine_tuning_list',
+    'afine_tuning_list',
+    # Responses
+    'responses_create',
+    'aresponses_create',
+    # Passthrough
+    'passthrough',
+    'apassthrough',
+    # Containers
+    'container_create',
+    'acontainer_create',
+    # Search
+    'search',
+    'asearch',
+    # A2A
+    'a2a_send',
+    'aa2a_send',
+    # Completions
+    'chat_completion',
+    'achat_completion',
+    'text_completion',
+    'atext_completion',
+    # Messages
+    'messages_create',
+    'amessages_create',
+    'count_tokens',
+    'acount_tokens',
+    # Guardrails
+    'apply_guardrail',
+    'aapply_guardrail',
+    # RAG
+    'rag_query',
+    'arag_query',
+    # Realtime
+    'realtime_connect',
+    'arealtime_connect',
+    'realtime_send',
+    'arealtime_send',
+    # Skills
+    'skill_list',
+    'askill_list',
+    'skill_load',
+    'askill_load',
+    # MCP
+    'mcp_list_tools',
+    'amcp_list_tools',
+    'mcp_call_tool',
+    'amcp_call_tool',
+    # Vector Store Files
+    'vector_store_file_create',
+    'avector_store_file_create',
+    'vector_store_file_list',
+    'avector_store_file_list',
+    'vector_store_file_delete',
+    'avector_store_file_delete',
+    # Container Files
+    'container_file_read',
+    'acontainer_file_read',
+    'container_file_write',
+    'acontainer_file_write',
+    'container_file_list',
+    'acontainer_file_list',
+    # Result types
+    'TranscriptionResult',
+    'SpeechResult',
+    'ImageResult',
+    'FileResult',
+    'BatchResult',
+    'VectorStoreResult',
+    'EmbeddingResult',
+    'RerankResult',
+    'ModerationResult',
+    'OCRResult',
+    'CompletionResult',
+    'MessageResult',
+    'TokenCountResult',
+    'GuardrailResult',
+    'RAGResult',
+    'RealtimeSession',
+    'RealtimeEvent',
+    'SkillResult',
+    'MCPResult',
+    'MCPToolCallResult',
+    'VectorStoreFileResult',
+    'ContainerFileResult',
+]
+
+_ATTR_TO_MODULE = {
+    # Audio
+    'transcribe': 'audio', 'atranscribe': 'audio', 'speech': 'audio', 'aspeech': 'audio',
+    'TranscriptionResult': 'audio', 'SpeechResult': 'audio',
+    # Images
+    'image_generate': 'images', 'aimage_generate': 'images', 'image_edit': 'images',
+    'aimage_edit': 'images', 'ImageResult': 'images',
+    # Videos
+    'video_generate': 'videos', 'avideo_generate': 'videos',
+    # Files
+    'file_create': 'files', 'afile_create': 'files', 'file_list': 'files',
+    'afile_list': 'files', 'file_retrieve': 'files', 'afile_retrieve': 'files',
+    'file_delete': 'files', 'afile_delete': 'files', 'file_content': 'files',
+    'afile_content': 'files', 'FileResult': 'files',
+    # Batches
+    'batch_create': 'batches', 'abatch_create': 'batches', 'batch_list': 'batches',
+    'abatch_list': 'batches', 'batch_retrieve': 'batches', 'abatch_retrieve': 'batches',
+    'batch_cancel': 'batches', 'abatch_cancel': 'batches', 'BatchResult': 'batches',
+    # Vector Stores
+    'vector_store_create': 'vector_stores', 'avector_store_create': 'vector_stores',
+    'vector_store_search': 'vector_stores', 'avector_store_search': 'vector_stores',
+    'VectorStoreResult': 'vector_stores',
+    # Embeddings
+    'embed': 'embeddings', 'aembed': 'embeddings', 'EmbeddingResult': 'embeddings',
+    # Rerank
+    'rerank': 'rerank_module', 'arerank': 'rerank_module', 'RerankResult': 'rerank_module',
+    # Moderations
+    'moderate': 'moderations', 'amoderate': 'moderations', 'ModerationResult': 'moderations',
+    # OCR
+    'ocr': 'ocr_module', 'aocr': 'ocr_module', 'OCRResult': 'ocr_module',
+    # Assistants
+    'assistant_create': 'assistants', 'aassistant_create': 'assistants',
+    'assistant_list': 'assistants', 'aassistant_list': 'assistants',
+    # Fine-tuning
+    'fine_tuning_create': 'fine_tuning', 'afine_tuning_create': 'fine_tuning',
+    'fine_tuning_list': 'fine_tuning', 'afine_tuning_list': 'fine_tuning',
+    # Responses
+    'responses_create': 'responses', 'aresponses_create': 'responses',
+    # Passthrough
+    'passthrough': 'passthrough_module', 'apassthrough': 'passthrough_module',
+    # Containers
+    'container_create': 'containers', 'acontainer_create': 'containers',
+    # Search
+    'search': 'search_module', 'asearch': 'search_module',
+    # A2A
+    'a2a_send': 'a2a', 'aa2a_send': 'a2a',
+    # Completions
+    'chat_completion': 'completions', 'achat_completion': 'completions',
+    'text_completion': 'completions', 'atext_completion': 'completions',
+    'CompletionResult': 'completions',
+    # Messages
+    'messages_create': 'messages', 'amessages_create': 'messages',
+    'count_tokens': 'messages', 'acount_tokens': 'messages',
+    'MessageResult': 'messages', 'TokenCountResult': 'messages',
+    # Guardrails
+    'apply_guardrail': 'guardrails', 'aapply_guardrail': 'guardrails',
+    'GuardrailResult': 'guardrails',
+    # RAG
+    'rag_query': 'rag', 'arag_query': 'rag', 'RAGResult': 'rag',
+    # Realtime
+    'realtime_connect': 'realtime', 'arealtime_connect': 'realtime',
+    'realtime_send': 'realtime', 'arealtime_send': 'realtime',
+    'RealtimeSession': 'realtime', 'RealtimeEvent': 'realtime',
+    # Skills
+    'skill_list': 'skills_module', 'askill_list': 'skills_module',
+    'skill_load': 'skills_module', 'askill_load': 'skills_module',
+    'SkillResult': 'skills_module',
+    # MCP
+    'mcp_list_tools': 'mcp', 'amcp_list_tools': 'mcp',
+    'mcp_call_tool': 'mcp', 'amcp_call_tool': 'mcp',
+    'MCPResult': 'mcp', 'MCPToolCallResult': 'mcp',
+    # Vector Store Files
+    'vector_store_file_create': 'vector_store_files', 'avector_store_file_create': 'vector_store_files',
+    'vector_store_file_list': 'vector_store_files', 'avector_store_file_list': 'vector_store_files',
+    'vector_store_file_delete': 'vector_store_files', 'avector_store_file_delete': 'vector_store_files',
+    'VectorStoreFileResult': 'vector_store_files',
+    # Container Files
+    'container_file_read': 'container_files', 'acontainer_file_read': 'container_files',
+    'container_file_write': 'container_files', 'acontainer_file_write': 'container_files',
+    'container_file_list': 'container_files', 'acontainer_file_list': 'container_files',
+    'ContainerFileResult': 'container_files',
+}
+
+# Module name mapping (for modules that conflict with function names)
+_MODULE_ALIASES = {
+    'rerank_module': 'rerank',
+    'ocr_module': 'ocr',
+    'passthrough_module': 'passthrough',
+    'search_module': 'search',
+    'skills_module': 'skills',
+}
+
+def __getattr__(name):
+    """Lazy load capabilities to minimize import overhead."""
+    if name in _ATTR_TO_MODULE:
+        import importlib
+        module_name = _ATTR_TO_MODULE[name]
+        # Handle module aliases
+        actual_module = _MODULE_ALIASES.get(module_name, module_name)
+        module = importlib.import_module(f'.{actual_module}', __package__)
+        return getattr(module, name)
+    
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

praisonai-2.6.4/praisonai/capabilities/a2a.py

@@ -0,0 +1,140 @@
+"""
+A2A (Agent-to-Agent) Capabilities Module
+
+Provides agent-to-agent communication gateway functionality.
+"""
+
+from dataclasses import dataclass, field
+from typing import Optional, Any, Dict, List
+
+
+@dataclass
+class A2AResult:
+    """Result from A2A operations."""
+    id: str
+    status: str = "sent"
+    response: Optional[Any] = None
+    target_agent: Optional[str] = None
+    metadata: Dict[str, Any] = field(default_factory=dict)
+
+
+def a2a_send(
+    message: str,
+    target_agent: str,
+    source_agent: Optional[str] = None,
+    context: Optional[Dict[str, Any]] = None,
+    timeout: float = 600.0,
+    api_key: Optional[str] = None,
+    api_base: Optional[str] = None,
+    metadata: Optional[Dict[str, Any]] = None,
+    **kwargs
+) -> A2AResult:
+    """
+    Send a message to another agent via A2A protocol.
+    
+    Args:
+        message: Message to send
+        target_agent: Target agent identifier
+        source_agent: Source agent identifier
+        context: Additional context
+        timeout: Request timeout in seconds
+        api_key: Optional API key override
+        api_base: Optional API base URL override
+        metadata: Optional metadata for tracing
+        
+    Returns:
+        A2AResult with response
+        
+    Example:
+        >>> result = a2a_send(
+        ...     "Please analyze this data",
+        ...     target_agent="data-analyst"
+        ... )
+        >>> print(result.response)
+    """
+    import uuid
+    
+    # A2A protocol implementation
+    # This integrates with PraisonAI's handoff mechanism
+    
+    message_id = f"a2a-{uuid.uuid4().hex[:12]}"
+    
+    # Try to use handoff if available
+    try:
+        from praisonaiagents import Agent
+        
+        # Create a simple agent to handle the message
+        agent = Agent(
+            name=target_agent,
+            instructions=f"You are {target_agent}. Process the following request.",
+        )
+        
+        response = agent.chat(message)
+        
+        return A2AResult(
+            id=message_id,
+            status="completed",
+            response=response,
+            target_agent=target_agent,
+            metadata=metadata or {},
+        )
+    except Exception:
+        # Return pending status if agent not available
+        return A2AResult(
+            id=message_id,
+            status="pending",
+            response=None,
+            target_agent=target_agent,
+            metadata=metadata or {},
+        )
+
+
+async def aa2a_send(
+    message: str,
+    target_agent: str,
+    source_agent: Optional[str] = None,
+    context: Optional[Dict[str, Any]] = None,
+    timeout: float = 600.0,
+    api_key: Optional[str] = None,
+    api_base: Optional[str] = None,
+    metadata: Optional[Dict[str, Any]] = None,
+    **kwargs
+) -> A2AResult:
+    """
+    Async: Send a message to another agent via A2A protocol.
+    
+    See a2a_send() for full documentation.
+    """
+    import uuid
+    
+    message_id = f"a2a-{uuid.uuid4().hex[:12]}"
+    
+    try:
+        from praisonaiagents import Agent
+        
+        agent = Agent(
+            name=target_agent,
+            instructions=f"You are {target_agent}. Process the following request.",
+        )
+        
+        # Use async chat if available
+        if hasattr(agent, 'achat'):
+            response = await agent.achat(message)
+        else:
+            response = agent.chat(message)
+        
+        return A2AResult(
+            id=message_id,
+            status="completed",
+            response=response,
+            target_agent=target_agent,
+            metadata=metadata or {},
+        )
+    except Exception:
+        return A2AResult(
+            id=message_id,
+            status="pending",
+            response=None,
+            target_agent=target_agent,
+            metadata=metadata or {},
+        )