PraisonAI 4.6.48__tar.gz → 4.6.51__tar.gz

{praisonai-4.6.48 → praisonai-4.6.51}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.6.48
+Version: 4.6.51
 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>=1.6.48
+Requires-Dist: praisonaiagents>=1.6.51
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm<2,>=1.83.14
 Requires-Dist: PyYAML>=6.0
@@ -564,7 +564,7 @@ praisonai flow
 
 Open **http://localhost:7861** — use the **Agent** and **Agent Team** components to create sequential or parallel workflows. Connect Chat Input → Agent Team → Chat Output for instant multi-agent pipelines.
 
-> 📖 [Full Flow docs](https://docs.praison.ai/docs/concepts/flow) — visual agent building, component reference, and deployment
+> 📖 [Full Flow docs](https://docs.praison.ai/docs/concepts/agentflow) — visual agent building, component reference, and deployment
 
 ### 8. PraisonAI UI 🤖 (Clean Chat)
 

{praisonai-4.6.48 → praisonai-4.6.51}/PraisonAI.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.6.48
+Version: 4.6.51
 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>=1.6.48
+Requires-Dist: praisonaiagents>=1.6.51
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm<2,>=1.83.14
 Requires-Dist: PyYAML>=6.0
@@ -564,7 +564,7 @@ praisonai flow
 
 Open **http://localhost:7861** — use the **Agent** and **Agent Team** components to create sequential or parallel workflows. Connect Chat Input → Agent Team → Chat Output for instant multi-agent pipelines.
 
-> 📖 [Full Flow docs](https://docs.praison.ai/docs/concepts/flow) — visual agent building, component reference, and deployment
+> 📖 [Full Flow docs](https://docs.praison.ai/docs/concepts/agentflow) — visual agent building, component reference, and deployment
 
 ### 8. PraisonAI UI 🤖 (Clean Chat)
 

{praisonai-4.6.48 → praisonai-4.6.51}/PraisonAI.egg-info/SOURCES.txt

@@ -183,6 +183,7 @@ praisonai/cli/commands/flow.py
 praisonai/cli/commands/gateway.py
 praisonai/cli/commands/github.py
 praisonai/cli/commands/hooks.py
+praisonai/cli/commands/kanban.py
 praisonai/cli/commands/knowledge.py
 praisonai/cli/commands/langextract.py
 praisonai/cli/commands/langfuse.py
@@ -505,6 +506,7 @@ praisonai/gateway/auth.py
 praisonai/gateway/cookie_auth.py
 praisonai/gateway/exec_approval.py
 praisonai/gateway/gateway_approval.py
+praisonai/gateway/kanban_dispatcher.py
 praisonai/gateway/magic_link.py
 praisonai/gateway/origin_check.py
 praisonai/gateway/pairing.py
@@ -531,6 +533,7 @@ praisonai/integration/host_app.py
 praisonai/integration/bridges/__init__.py
 praisonai/integration/bridges/approvals_bridge.py
 praisonai/integration/bridges/hooks_query.py
+praisonai/integration/bridges/kanban_bridge.py
 praisonai/integration/bridges/schedules_runner.py
 praisonai/integration/bridges/usage_bridge.py
 praisonai/integration/bridges/workflows_service.py
@@ -540,6 +543,7 @@ praisonai/integration/pages/workflow_runs.py
 praisonai/integrations/__init__.py
 praisonai/integrations/_session_info.py
 praisonai/integrations/_tool_aliases.py
+praisonai/integrations/_unified_registry.py
 praisonai/integrations/base.py
 praisonai/integrations/claude_code.py
 praisonai/integrations/codex_cli.py
@@ -565,6 +569,10 @@ praisonai/jobs/models.py
 praisonai/jobs/router.py
 praisonai/jobs/server.py
 praisonai/jobs/store.py
+praisonai/kanban/__init__.py
+praisonai/kanban/models.py
+praisonai/kanban/paths.py
+praisonai/kanban/sqlite_store.py
 praisonai/llm/__init__.py
 praisonai/llm/env.py
 praisonai/llm/registry.py
@@ -603,6 +611,7 @@ praisonai/n8n/converter.py
 praisonai/n8n/preview.py
 praisonai/n8n/reverse_converter.py
 praisonai/observability/__init__.py
+praisonai/observability/hooks.py
 praisonai/observability/langextract.py
 praisonai/observability/langfuse.py
 praisonai/persistence/__init__.py
@@ -623,6 +632,7 @@ praisonai/persistence/conversation/singlestore.py
 praisonai/persistence/conversation/sqlite.py
 praisonai/persistence/conversation/supabase.py
 praisonai/persistence/conversation/surrealdb.py
+praisonai/persistence/conversation/sync_sqlite.py
 praisonai/persistence/conversation/turso.py
 praisonai/persistence/hooks/__init__.py
 praisonai/persistence/hooks/agent_hooks.py
@@ -763,6 +773,7 @@ praisonai/tools/__init__.py
 praisonai/tools/audio.py
 praisonai/tools/glob_tool.py
 praisonai/tools/grep_tool.py
+praisonai/tools/kanban_tools.py
 praisonai/tools/multiedit.py
 praisonai/tools/skill_manage.py
 praisonai/train/__init__.py

{praisonai-4.6.48 → praisonai-4.6.51}/PraisonAI.egg-info/requires.txt

@@ -1,7 +1,7 @@
 rich>=13.7
 markdown>=3.5
 pyparsing>=3.0.0
-praisonaiagents>=1.6.48
+praisonaiagents>=1.6.51
 python-dotenv>=0.19.0
 litellm<2,>=1.83.14
 PyYAML>=6.0

{praisonai-4.6.48 → praisonai-4.6.51}/README.md

@@ -382,7 +382,7 @@ praisonai flow
 
 Open **http://localhost:7861** — use the **Agent** and **Agent Team** components to create sequential or parallel workflows. Connect Chat Input → Agent Team → Chat Output for instant multi-agent pipelines.
 
-> 📖 [Full Flow docs](https://docs.praison.ai/docs/concepts/flow) — visual agent building, component reference, and deployment
+> 📖 [Full Flow docs](https://docs.praison.ai/docs/concepts/agentflow) — visual agent building, component reference, and deployment
 
 ### 8. PraisonAI UI 🤖 (Clean Chat)
 

{praisonai-4.6.48 → praisonai-4.6.51}/praisonai/_async_bridge.py

@@ -31,12 +31,8 @@ class _BackgroundLoop:
         server processes should call :func:`shutdown` explicitly to cancel
         in-flight tasks before process exit.
         """
-        # Enforce the documented invariant. ``threading.Lock.locked()``
-        # is process-wide, not thread-local, but combined with the fact
-        # that the only callers are :py:meth:`get` and :py:meth:`get_unlocked`
-        # (the latter only invoked from inside ``run_sync`` while holding
-        # the lock), this catches the "forgot to hold the lock" mistake.
-        assert self._lock.locked(), "_spawn_locked() requires self._lock to be held"
+        # Create the loop+thread; caller must hold self._lock.
+        # The lock contract is now enforced structurally by submit() method.
         if self._loop is None or self._loop.is_closed():
             self._loop = asyncio.new_event_loop()
             self._thread = threading.Thread(
@@ -51,9 +47,11 @@ class _BackgroundLoop:
         with self._lock:
             return self._spawn_locked()
 
-    def get_unlocked(self) -> asyncio.AbstractEventLoop:
-        """Get loop assuming caller holds _lock. For run_sync() use only."""
-        return self._spawn_locked()
+    def submit(self, coro):
+        """Atomically (re)spawn loop if needed and submit coro. Returns concurrent.futures.Future."""
+        with self._lock:
+            loop = self._spawn_locked()
+            return asyncio.run_coroutine_threadsafe(coro, loop)
 
     def shutdown(self, timeout: float = 5.0) -> None:
         with self._lock:
@@ -77,7 +75,16 @@ class _BackgroundLoop:
                 self._loop = None
                 self._thread = None
 
-_BG = _BackgroundLoop()
+_BG: "_BackgroundLoop | None" = None
+_BG_LOCK = threading.Lock()
+
+def _get_bg() -> "_BackgroundLoop":
+    global _BG
+    if _BG is None:
+        with _BG_LOCK:
+            if _BG is None:
+                _BG = _BackgroundLoop()
+    return _BG
 
 
 def run_sync(coro: Awaitable[T], *, timeout: float | None = _DEFAULT_TIMEOUT) -> T:
@@ -109,10 +116,8 @@ def run_sync(coro: Awaitable[T], *, timeout: float | None = _DEFAULT_TIMEOUT) ->
             "await the coroutine directly instead."
         )
 
-    # Submit the coroutine inside the lock to prevent shutdown races
-    with _BG._lock:
-        loop = _BG.get_unlocked()
-        fut: Future = asyncio.run_coroutine_threadsafe(coro, loop)
+    # Submit the coroutine atomically
+    fut = _get_bg().submit(coro)
     
     try:
         return fut.result(timeout=timeout)
@@ -139,4 +144,6 @@ def run_sync(coro: Awaitable[T], *, timeout: float | None = _DEFAULT_TIMEOUT) ->
 
 def shutdown() -> None:
     """Public hook for long-running server processes to stop the bridge cleanly."""
-    _BG.shutdown()
+    bg = _BG
+    if bg is not None:
+        bg.shutdown()

{praisonai-4.6.48 → praisonai-4.6.51}/praisonai/_registry.py

@@ -41,39 +41,28 @@ class PluginRegistry(Generic[T]):
             builtins: Dict of name -> loader function for built-in plugins
         """
         self._entry_point_group = entry_point_group
-        self._items: Dict[str, Type[T]] = {}
+        self._loaders: Dict[str, Callable[[], Type[T]]] = {}  # lazy loaders
+        self._items: Dict[str, Type[T]] = {}  # resolved cache
         self._aliases: Dict[str, str] = {}  # alias -> canonical name
-        self._lock = threading.Lock()
+        self._lock = threading.RLock()  # Use RLock for re-entrant access
         
-        # Load built-in plugins with error handling
+        # Store built-in loaders (normalized) without calling them
         if builtins:
             for name, loader in builtins.items():
-                try:
-                    self._items[name] = loader()
-                except ImportError:
-                    # Built-in plugin dependencies not available, skip
-                    pass
-                except Exception:
-                    # Log other errors but don't crash initialization
-                    logger.warning("Failed to load built-in plugin %r", name, exc_info=True)
-        
-        self._load_entry_points()
-
-    def _load_entry_points(self) -> None:
-        """Load plugins from entry points."""
+                self._add_loader(name, loader)
+        
+        self._discover_entry_points()
+
+    def _add_loader(self, name: str, loader: Callable[[], Type[T]]) -> None:
+        """Add a loader with normalized name."""
+        normalized_name = name.lower()
+        self._loaders[normalized_name] = loader
+
+    def _discover_entry_points(self) -> None:
+        """Discover entry point loaders without loading them."""
         try:
             for ep in entry_points(group=self._entry_point_group):
-                try:
-                    plugin_class = ep.load()
-                    with self._lock:
-                        self._items[ep.name] = plugin_class
-                except Exception:
-                    # Do not break plugin dispatch because one plugin is broken
-                    logger.warning(
-                        "Failed to load plugin %r from entry point",
-                        ep.name,
-                        exc_info=True,
-                    )
+                self._add_loader(ep.name, ep.load)
         except Exception:
             # entry_points() might not be available in older Python versions
             logger.debug("Entry points not available for group %s", self._entry_point_group)
@@ -94,6 +83,8 @@ class PluginRegistry(Generic[T]):
         """
         with self._lock:
             canonical_name = name.lower()
+            # Store both in loaders (for consistency with discovery) and items (for immediate access)
+            self._loaders[canonical_name] = lambda: cls
             self._items[canonical_name] = cls
             
             # Register aliases
@@ -120,7 +111,7 @@ class PluginRegistry(Generic[T]):
                 return True
             
             # Check if it's a canonical name
-            if normalized_name in self._items:
+            if normalized_name in self._loaders:
                 # Remove all aliases pointing to this plugin
                 aliases_to_remove = [
                     alias for alias, canonical in self._aliases.items()
@@ -129,7 +120,9 @@ class PluginRegistry(Generic[T]):
                 for alias in aliases_to_remove:
                     del self._aliases[alias]
                 
-                del self._items[normalized_name]
+                # Remove from both loaders and items cache
+                del self._loaders[normalized_name]
+                self._items.pop(normalized_name, None)
                 return True
             
             return False
@@ -146,28 +139,44 @@ class PluginRegistry(Generic[T]):
         Raises:
             ValueError: If plugin is not found
         """
+        normalized_name = name.lower()
+        
         with self._lock:
-            normalized_name = name.lower()
-            
-            # Resolve alias to canonical name
+            # Check cache first
             canonical_name = self._aliases.get(normalized_name, normalized_name)
             cls = self._items.get(canonical_name)
             
-            # Capture available plugins snapshot while holding lock
-            # to avoid race condition between check and error message
-            if cls is None:
-                available_plugins = sorted(self._items.keys())
+            if cls is not None:
+                return cls
+            
+            # Try to load from loaders
+            loader = self._loaders.get(canonical_name)
+            if loader is None:
+                # Capture available plugins snapshot while holding lock
+                available_loaders = sorted(self._loaders.keys())
                 available_aliases = sorted(self._aliases.keys())
-                available_snapshot = available_plugins + available_aliases
-            else:
-                available_snapshot = None
+                available_snapshot = available_loaders + available_aliases
+                raise ValueError(
+                    f"Unknown {self._entry_point_group} plugin: {name!r}. "
+                    f"Available: {available_snapshot}"
+                )
+            
+            # Load and cache the plugin (release lock during loading to prevent deadlock)
+            pass
         
-        if cls is None:
+        # Load outside the lock to prevent deadlock if loader calls back into registry
+        try:
+            cls = loader()
+        except ImportError as e:
             raise ValueError(
-                f"Unknown {self._entry_point_group} plugin: {name!r}. "
-                f"Available: {available_snapshot}"
-            )
-        return cls
+                f"Plugin {name!r} is registered but its dependencies "
+                f"are not installed: {e}"
+            ) from e
+        
+        # Re-acquire lock to cache the result
+        with self._lock:
+            self._items[canonical_name] = cls
+            return cls
 
     def create(self, name: str, *args, **kwargs) -> T:
         """Create an instance of the specified plugin.
@@ -192,7 +201,7 @@ class PluginRegistry(Generic[T]):
             Sorted list of plugin names
         """
         with self._lock:
-            return sorted(self._items.keys())
+            return sorted(self._loaders.keys())
 
     def is_available(self, name: str) -> bool:
         """Check if a plugin is available.
@@ -225,4 +234,59 @@ class PluginRegistry(Generic[T]):
             Sorted list of all registered names and aliases
         """
         with self._lock:
-            return sorted(list(self._items.keys()) + list(self._aliases.keys()))
+            return sorted(list(self._loaders.keys()) + list(self._aliases.keys()))
+    
+    def get_by_attr(self, module_name: str, attr_name: str) -> Type[T]:
+        """Get a plugin by attribute name for __getattr__ dispatch.
+        
+        Args:
+            module_name: Module name requesting the attribute (for error messages)
+            attr_name: Attribute name to resolve
+            
+        Returns:
+            Plugin class
+            
+        Raises:
+            AttributeError: If plugin is not found
+        """
+        try:
+            return self.resolve(attr_name)
+        except ValueError:
+            raise AttributeError(f"module {module_name!r} has no attribute {attr_name!r}")
+
+
+def create_lazy_getattr(registry: PluginRegistry[T]) -> Callable[[str], T]:
+    """Create a __getattr__ function backed by a PluginRegistry.
+    
+    This replaces manual if/elif ladders in __init__.py files with a data-driven
+    approach using the plugin registry.
+    
+    Args:
+        registry: The plugin registry to use for resolution
+        
+    Returns:
+        Function that can be used as __getattr__ in a module
+        
+    Example:
+        # In __init__.py:
+        from ._registry import create_lazy_getattr
+        
+        # Assuming you have a registry instance
+        __getattr__ = create_lazy_getattr(my_registry)
+    """
+    def __getattr__(name: str) -> T:
+        try:
+            plugin_class = registry.resolve(name)
+            return plugin_class
+        except ValueError:
+            # Get the calling module name for error context
+            import inspect
+            frame = inspect.currentframe()
+            if frame and frame.f_back:
+                module_name = frame.f_back.f_globals.get('__name__', 'unknown')
+            else:
+                module_name = 'unknown'
+            
+            raise AttributeError(f"module {module_name!r} has no attribute {name!r}")
+    
+    return __getattr__