PraisonAI 4.6.47__tar.gz → 4.6.50__tar.gz

{praisonai-4.6.47 → praisonai-4.6.50}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.6.47
+Version: 4.6.50
 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.47
+Requires-Dist: praisonaiagents>=1.6.50
 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.47 → praisonai-4.6.50}/PraisonAI.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.6.47
+Version: 4.6.50
 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.47
+Requires-Dist: praisonaiagents>=1.6.50
 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.47 → praisonai-4.6.50}/PraisonAI.egg-info/SOURCES.txt

@@ -82,6 +82,7 @@ praisonai/bots/_resilience.py
 praisonai/bots/_session.py
 praisonai/bots/_slack_approval.py
 praisonai/bots/_telegram_approval.py
+praisonai/bots/_typing_indicator.py
 praisonai/bots/_unknown_user.py
 praisonai/bots/_webhook_approval.py
 praisonai/bots/_whatsapp_web_adapter.py
@@ -182,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
@@ -504,10 +506,12 @@ 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
 praisonai/gateway/pairing_routes.py
+praisonai/gateway/port_utils.py
 praisonai/gateway/push_channels.py
 praisonai/gateway/push_delivery.py
 praisonai/gateway/push_polling.py
@@ -515,6 +519,7 @@ praisonai/gateway/push_presence.py
 praisonai/gateway/rate_limiter.py
 praisonai/gateway/redis_pubsub.py
 praisonai/gateway/server.py
+praisonai/gateway/unicode_utils.py
 praisonai/inbuilt_tools/__init__.py
 praisonai/inbuilt_tools/autogen_tools.py
 praisonai/inc/__init__.py
@@ -528,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
@@ -562,6 +568,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
@@ -698,6 +708,7 @@ praisonai/sandbox/ssh.py
 praisonai/sandbox/subprocess.py
 praisonai/scheduler/__init__.py
 praisonai/scheduler/agent_scheduler.py
+praisonai/scheduler/async_agent_scheduler.py
 praisonai/scheduler/base.py
 praisonai/scheduler/daemon_manager.py
 praisonai/scheduler/deployment.py
@@ -759,6 +770,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.47 → praisonai-4.6.50}/PraisonAI.egg-info/requires.txt

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

{praisonai-4.6.47 → praisonai-4.6.50}/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.47 → praisonai-4.6.50}/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.47 → praisonai-4.6.50}/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._add_loader(name, loader)
         
-        self._load_entry_points()
+        self._discover_entry_points()
 
-    def _load_entry_points(self) -> None:
-        """Load plugins from 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,4 @@ 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()))

{praisonai-4.6.47 → praisonai-4.6.50}/praisonai/agents_generator.py

@@ -28,14 +28,33 @@ from .tool_registry import ToolRegistry
 
 # BaseTool import is now handled centrally by ToolResolver
 
-# Check for additional framework availability using centralized detection
+# Framework availability detection (lazy via __getattr__)
 from ._framework_availability import is_available
-PRAISONAI_TOOLS_AVAILABLE = is_available("praisonai_tools")
-CREWAI_AVAILABLE          = is_available("crewai")
-AUTOGEN_AVAILABLE         = is_available("autogen")
-AG2_AVAILABLE             = is_available("ag2")
-PRAISONAI_AVAILABLE       = is_available("praisonaiagents")
-AGENTOPS_AVAILABLE        = is_available("agentops")
+
+# Lazy constants mapping for backward compatibility
+_AVAIL = {
+    "PRAISONAI_TOOLS_AVAILABLE": "praisonai_tools",
+    "CREWAI_AVAILABLE": "crewai",
+    "AUTOGEN_AVAILABLE": "autogen",
+    "AG2_AVAILABLE": "ag2",
+    "PRAISONAI_AVAILABLE": "praisonaiagents",
+    "AGENTOPS_AVAILABLE": "agentops",
+}
+
+__all__ = list(_AVAIL.keys())
+
+def __getattr__(name):
+    """Lazy attribute access for framework availability constants.
+    
+    This allows backward compatibility while avoiding import-time probing.
+    Only probes the framework when the constant is actually accessed.
+    """
+    if name in _AVAIL:
+        return is_available(_AVAIL[name])
+    raise AttributeError(f"module '{__name__}' has no attribute '{name}'")
+
+def __dir__():
+    return sorted(set(globals()) | set(_AVAIL))
 
 # Framework adapter registry - now uses proper registry pattern
 # This replaces the hardcoded FRAMEWORK_ADAPTERS dict
@@ -282,7 +301,7 @@ class AgentsGenerator:
         
         # Keep tool registry for backward compatibility with autogen adapters
         self.tool_registry = ToolRegistry()
-        self.tool_registry.register_builtin_autogen_adapters()
+        self.tool_registry.register_builtin_autogen_adapters(_suppress_deprecation_warning=True)
         
         # Initialize tool resolver with the registry wired in (single source of truth for tool resolution)
         from .tool_resolver import ToolResolver
@@ -555,7 +574,7 @@ class AgentsGenerator:
             for agent_name, agent_config in config['agents'].items():
                 role_config = dict(agent_config) if agent_config else {}
                 # Convert 'instructions' to 'backstory' if present
-                # Note: preserve 'instructions' key for framework adapters
+                # Note: preserve 'instructions' key for adapters that pass it to PraisonAgent
                 if 'instructions' in role_config and 'backstory' not in role_config:
                     role_config['backstory'] = role_config['instructions']
                 # Ensure required fields have defaults
@@ -576,7 +595,7 @@ class AgentsGenerator:
         tools_dict = {}
         
         # Demand-driven tool resolution - only resolve tools actually used in YAML
-        if CREWAI_AVAILABLE or AUTOGEN_AVAILABLE or PRAISONAI_AVAILABLE or AG2_AVAILABLE:
+        if is_available("crewai") or is_available("autogen") or is_available("praisonaiagents") or is_available("ag2"):
             try:
                 # Collect all tool names mentioned in the YAML config
                 needed_tools: set[str] = set()
@@ -696,7 +715,7 @@ class AgentsGenerator:
         Returns:
             str: Result of the workflow execution
         """
-        if not PRAISONAI_AVAILABLE:
+        if not is_available("praisonaiagents"):
             raise ImportError("PraisonAI is not installed. Please install it with 'pip install praisonaiagents'")
         
         try:
@@ -736,4 +755,4 @@ class AgentsGenerator:
         if result.get("status") == "completed":
             return result.get("output", "Workflow completed successfully")
         else:
-            return f"Workflow failed: {result.get('error', 'Unknown error')}"
+            return f"Workflow failed: {result.get('error', 'Unknown error')}"

praisonai-4.6.50/praisonai/async_agent_scheduler.py

@@ -0,0 +1,23 @@
+"""Backward-compatible re-export. Prefer `praisonai.scheduler`.
+
+This module is deprecated. Use the canonical implementation in the
+scheduler package for full functionality including async support.
+"""
+
+import warnings
+
+warnings.warn(
+    "praisonai.async_agent_scheduler is deprecated; "
+    "use 'from praisonai.scheduler import AsyncAgentScheduler' instead.",
+    DeprecationWarning, 
+    stacklevel=2,
+)
+
+# Re-export from the canonical location
+from .scheduler.async_agent_scheduler import (  # noqa: F401
+    AsyncAgentScheduler, 
+    AsyncPraisonAgentExecutor, 
+    AsyncAgentExecutorInterface,
+    create_async_agent_scheduler,
+    logger,
+)

{praisonai-4.6.47 → praisonai-4.6.50}/praisonai/auto.py

@@ -65,37 +65,7 @@ def _load_optional(key: str, loader):
 # Availability checks now delegated to centralized module
 from ._framework_availability import is_available
 
-def _check_crewai_available() -> bool:
-    """Check if crewai is available (cached, thread-safe)."""
-    return is_available("crewai")
-
-def _check_autogen_available() -> bool:
-    """Check if autogen v0.2 is available (cached, thread-safe)."""
-    return is_available("autogen")
-
-def _check_autogen_v4_available() -> bool:
-    """Check if autogen v0.4 is available (cached, thread-safe)."""
-    return is_available("autogen_v4")
-
-def _check_ag2_available() -> bool:
-    """Check if AG2 (community fork of AutoGen) is available (cached, thread-safe)."""
-    return is_available("ag2")
-
-def _check_praisonai_available() -> bool:
-    """Check if praisonaiagents is available (cached, thread-safe)."""
-    return is_available("praisonaiagents")
-
-def _check_praisonai_tools_available() -> bool:
-    """Check if praisonai_tools is available (cached, thread-safe)."""
-    return is_available("praisonai_tools")
-
-def _check_litellm_available() -> bool:
-    """Check if litellm is available (cached, thread-safe)."""
-    return is_available("litellm")
-
-def _check_openai_available() -> bool:
-    """Check if openai is available (cached, thread-safe)."""
-    return is_available("openai")
+# Redundant wrapper functions removed - use is_available() directly
 
 
 def _get_crewai():
@@ -504,7 +474,7 @@ class BaseAutoGenerator:
         model_name = self.config_list[0]['model']
         
         # Try LiteLLM first (preferred - supports 100+ providers)
-        if _check_litellm_available():
+        if is_available("litellm"):
             litellm = _get_litellm()
             response = litellm.completion(
                 model=model_name,
@@ -516,7 +486,7 @@ class BaseAutoGenerator:
             return response_model.model_validate_json(content)
         
         # Fallback to OpenAI SDK (uses beta.chat.completions.parse)
-        if _check_openai_available():
+        if is_available("openai"):
             client = self._get_openai_client()
             response = client.beta.chat.completions.parse(
                 model=model_name,
@@ -554,7 +524,7 @@ class BaseAutoGenerator:
         model_name = self.config_list[0]['model']
         
         # Try LiteLLM async first (preferred - supports 100+ providers)
-        if _check_litellm_available():
+        if is_available("litellm"):
             litellm = _get_litellm()
             response = await litellm.acompletion(
                 model=model_name,
@@ -566,7 +536,7 @@ class BaseAutoGenerator:
             return response_model.model_validate_json(content)
         
         # Fallback to OpenAI AsyncSDK (uses beta.chat.completions.parse)
-        if _check_openai_available():
+        if is_available("openai"):
             if self._async_openai_client is None:
                 with self._client_lock:
                     if self._async_openai_client is None:
@@ -728,7 +698,7 @@ class AutoGenerator(BaseAutoGenerator):
             raise ImportError(f"{adapter.name} is not installed. Please install with:\n    {install_hint}")
         
         # Check tools availability if required by this framework
-        if requires_tools_extra and not _check_praisonai_tools_available():
+        if requires_tools_extra and not is_available("praisonai_tools"):
             logger.warning(f"Tools are not available for {framework}. To use tools, install:\n    {install_hint}")
 
         self.topic = topic

{praisonai-4.6.47 → praisonai-4.6.50}/praisonai/bots/_config_schema.py

@@ -23,11 +23,14 @@ class AgentConfigSchema(BaseModel):
 
 class ChannelConfigSchema(BaseModel):
     """Schema for a single channel configuration."""
+    platform: Optional[str] = None
     token: str = ""
     mode: str = "poll"  # poll | ws | webhook | hybrid
     group_policy: str = "respond_all"  # respond_all, mention_only, command_only
     allowlist: List[str] = Field(default_factory=list)
     blocklist: List[str] = Field(default_factory=list)
+    allowed_users: Optional[str] = None
+    routes: Dict[str, str] = Field(default_factory=dict)
     webhook_url: Optional[str] = None
     webhook_port: int = 8080
     
@@ -102,12 +105,15 @@ class BotYamlSchema(BaseModel):
                 "No channels configured. Add at least one channel "
                 "(telegram, discord, slack, whatsapp) to your bot.yaml"
             )
-        # Validate channel names
+        # Channel keys may be platform names (telegram) or custom ids (telegram_cfo)
+        # when ``platform`` is set on the channel block (gateway / multi-bot YAML).
         valid_platforms = {"telegram", "discord", "slack", "whatsapp", "email", "agentmail"}
-        for name in self.channels:
-            if name not in valid_platforms:
+        for name, channel in self.channels.items():
+            platform = (channel.platform or name).lower()
+            if platform not in valid_platforms:
                 raise ValueError(
-                    f"Unknown channel '{name}'. Supported: {', '.join(sorted(valid_platforms))}"
+                    f"Unknown channel '{name}' (platform '{platform}'). "
+                    f"Supported platforms: {', '.join(sorted(valid_platforms))}"
                 )
         return self