PraisonAI 4.6.44__tar.gz → 4.6.46__tar.gz

{praisonai-4.6.44 → praisonai-4.6.46}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.6.44
+Version: 4.6.46
 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.44
+Requires-Dist: praisonaiagents>=1.6.46
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm<2,>=1.83.14
 Requires-Dist: PyYAML>=6.0
@@ -138,6 +138,8 @@ Provides-Extra: postgresql
 Requires-Dist: psycopg2-binary>=2.9.0; extra == "postgresql"
 Provides-Extra: dynamodb
 Requires-Dist: boto3>=1.35.0; extra == "dynamodb"
+Provides-Extra: valkey
+Requires-Dist: valkey-glide-sync>=2.3.1; extra == "valkey"
 Provides-Extra: neon
 Requires-Dist: psycopg2-binary>=2.9.0; extra == "neon"
 Provides-Extra: turso

{praisonai-4.6.44 → praisonai-4.6.46}/PraisonAI.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.6.44
+Version: 4.6.46
 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.44
+Requires-Dist: praisonaiagents>=1.6.46
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm<2,>=1.83.14
 Requires-Dist: PyYAML>=6.0
@@ -138,6 +138,8 @@ Provides-Extra: postgresql
 Requires-Dist: psycopg2-binary>=2.9.0; extra == "postgresql"
 Provides-Extra: dynamodb
 Requires-Dist: boto3>=1.35.0; extra == "dynamodb"
+Provides-Extra: valkey
+Requires-Dist: valkey-glide-sync>=2.3.1; extra == "valkey"
 Provides-Extra: neon
 Requires-Dist: psycopg2-binary>=2.9.0; extra == "neon"
 Provides-Extra: turso

{praisonai-4.6.44 → praisonai-4.6.46}/PraisonAI.egg-info/SOURCES.txt

@@ -10,6 +10,7 @@ praisonai/__init__.py
 praisonai/__main__.py
 praisonai/_approval_spec.py
 praisonai/_async_bridge.py
+praisonai/_entrypoint.py
 praisonai/_framework_availability.py
 praisonai/_logging.py
 praisonai/_registry.py
@@ -21,7 +22,6 @@ praisonai/async_agent_scheduler.py
 praisonai/auto.py
 praisonai/deploy.py
 praisonai/profiler.py
-praisonai/scheduler.py
 praisonai/setup.py
 praisonai/test.py
 praisonai/tool_registry.py
@@ -520,6 +520,19 @@ praisonai/inbuilt_tools/autogen_tools.py
 praisonai/inc/__init__.py
 praisonai/inc/config.py
 praisonai/inc/models.py
+praisonai/integration/__init__.py
+praisonai/integration/_legacy_handlers.py
+praisonai/integration/context_files.py
+praisonai/integration/gateway_host.py
+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/schedules_runner.py
+praisonai/integration/bridges/usage_bridge.py
+praisonai/integration/bridges/workflows_service.py
+praisonai/integration/pages/bot_health.py
+praisonai/integration/pages/workflow_runs.py
 praisonai/integrations/__init__.py
 praisonai/integrations/_session_info.py
 praisonai/integrations/_tool_aliases.py
@@ -589,6 +602,7 @@ praisonai/observability/__init__.py
 praisonai/observability/langextract.py
 praisonai/observability/langfuse.py
 praisonai/persistence/__init__.py
+praisonai/persistence/_valkey_client.py
 praisonai/persistence/config.py
 praisonai/persistence/factory.py
 praisonai/persistence/orchestrator.py
@@ -628,6 +642,7 @@ praisonai/persistence/knowledge/redis_vector.py
 praisonai/persistence/knowledge/singlestore_vector.py
 praisonai/persistence/knowledge/surrealdb_vector.py
 praisonai/persistence/knowledge/upstash_vector.py
+praisonai/persistence/knowledge/valkey_vector.py
 praisonai/persistence/knowledge/weaviate.py
 praisonai/persistence/migrations/__init__.py
 praisonai/persistence/migrations/manager.py
@@ -641,8 +656,10 @@ praisonai/persistence/state/memory.py
 praisonai/persistence/state/mongodb.py
 praisonai/persistence/state/redis.py
 praisonai/persistence/state/upstash.py
+praisonai/persistence/state/valkey.py
 praisonai/persistence/tests/__init__.py
 praisonai/persistence/tests/test_all_backends.py
+praisonai/persistence/tests/test_valkey_backends.py
 praisonai/push/__init__.py
 praisonai/push/client.py
 praisonai/push/transports.py
@@ -682,6 +699,7 @@ praisonai/scheduler/__init__.py
 praisonai/scheduler/agent_scheduler.py
 praisonai/scheduler/base.py
 praisonai/scheduler/daemon_manager.py
+praisonai/scheduler/deployment.py
 praisonai/scheduler/executor.py
 praisonai/scheduler/shared.py
 praisonai/scheduler/state_manager.py
@@ -714,6 +732,7 @@ praisonai/storage/dynamodb_adapter.py
 praisonai/storage/mongodb_adapter.py
 praisonai/storage/postgresql_adapter.py
 praisonai/storage/redis_adapter.py
+praisonai/storage/valkey_adapter.py
 praisonai/suite_runner/__init__.py
 praisonai/suite_runner/batch_source.py
 praisonai/suite_runner/cli_docs_source.py
@@ -762,6 +781,7 @@ praisonai/ui_bot/__init__.py
 praisonai/ui_bot/default_app.py
 praisonai/ui_chat/__init__.py
 praisonai/ui_chat/default_app.py
+praisonai/ui_dashboard/default_app.py
 praisonai/ui_realtime/__init__.py
 praisonai/ui_realtime/default_app.py
 tests/test.py

{praisonai-4.6.44 → praisonai-4.6.46}/PraisonAI.egg-info/requires.txt

@@ -1,7 +1,7 @@
 rich>=13.7
 markdown>=3.5
 pyparsing>=3.0.0
-praisonaiagents>=1.6.44
+praisonaiagents>=1.6.46
 python-dotenv>=0.19.0
 litellm<2,>=1.83.14
 PyYAML>=6.0
@@ -202,5 +202,8 @@ libsql-experimental>=0.0.50
 [ui]
 aiui>=0.3.100
 
+[valkey]
+valkey-glide-sync>=2.3.1
+
 [xata]
 psycopg2-binary>=2.9.0

{praisonai-4.6.44 → praisonai-4.6.46}/praisonai/__init__.py

@@ -6,6 +6,8 @@ from .version import __version__
 # Define __all__ for lazy loading
 __all__ = [
     'PraisonAI',
+    'run',
+    'arun',
     '__version__',
     'Deploy',
     'DeployConfig',
@@ -92,7 +94,13 @@ def __getattr__(name):
     # Note: Telemetry initialization moved out of lazy hook to avoid side effects
     # It should be called explicitly from cli.PraisonAI.__init__ instead
 
-    if name == 'PraisonAI':
+    if name == 'run':
+        from ._entrypoint import run
+        return run
+    elif name == 'arun':
+        from ._entrypoint import arun
+        return arun
+    elif name == 'PraisonAI':
         from .cli import PraisonAI
         return PraisonAI
     elif name == 'Agent':
@@ -130,9 +138,12 @@ def __getattr__(name):
     elif name == 'EmbeddingResult':
         from praisonaiagents.embedding import EmbeddingResult
         return EmbeddingResult
-    elif name == 'AgentOS':
-        from .app import AgentOS
-        return AgentOS
+    elif name == 'build_host_app':
+        from .integration.host_app import build_host_app
+        return build_host_app
+    elif name == 'configure_host':
+        from .integration.host_app import configure_host
+        return configure_host
     elif name == 'AgentApp':
         # Silent alias for AgentOS (backward compatibility)
         from .app import AgentOS

{praisonai-4.6.44 → praisonai-4.6.46}/praisonai/_dev/api_md.py

@@ -119,7 +119,7 @@ class ApiMdGenerator:
         'Observability': ['obs', 'FlowDisplay', 'track_workflow'],
         'Context': ['FastContext', 'FastContextResult', 'FileMatch', 'LineRange',
                     'ContextManager', 'ManagerConfig'],
-        'UI': ['AGUI', 'A2A'],
+        'UI': ['AGUI', 'A2A', 'A2UI'],
         'Config': ['MemoryConfig', 'KnowledgeConfig', 'PlanningConfig', 'ReflectionConfig',
                    'GuardrailConfig', 'WebConfig', 'OutputConfig', 'ExecutionConfig',
                    'TemplateConfig', 'CachingConfig', 'HooksConfig', 'SkillsConfig',

{praisonai-4.6.44 → praisonai-4.6.46}/praisonai/_dev/parity/python_extractor.py

@@ -82,7 +82,7 @@ class PythonFeatureExtractor:
         'telemetry': ['telemetry'],
         'context': ['context.fast', 'context.manager', 'context.models'],
         'session': ['session'],
-        'ui': ['ui.agui', 'ui.a2a'],
+        'ui': ['ui.agui', 'ui.a2a', 'ui.a2ui'],
         'rag': ['rag'],
         'planning': ['planning'],
         'config': ['config.feature_configs', 'config.param_resolver', 

praisonai-4.6.46/praisonai/_entrypoint.py

@@ -0,0 +1,73 @@
+"""Top-level convenience entry points for the Python API.
+
+Keep this file minimal - it is part of the Minimal API surface and must defer
+all heavy imports to call time.
+"""
+from __future__ import annotations
+
+from typing import Any
+
+
+def _build_config_list() -> list[dict[str, Any]]:
+    """Reuse the same env/keyfile resolution the CLI already performs."""
+    # Import LLM endpoint resolution from the same path the CLI uses
+    from praisonai.llm.env import resolve_llm_endpoint
+    ep = resolve_llm_endpoint()
+    
+    return [{
+        'model': ep.model,
+        'base_url': ep.base_url,
+        'api_key': ep.api_key,
+        'api_type': 'openai'        # AutoGen expects this field
+    }]
+
+
+def run(agent_file: str,
+        framework: str | None = None,
+        *,
+        tools: list | None = None,
+        agent_yaml: str | None = None,
+        cli_config: dict | None = None) -> str:
+    """One-line Python entry point. Equivalent to `praisonai <agent_file>`."""
+    from .agents_generator import AgentsGenerator
+    from ._framework_availability import is_available
+
+    if framework is None:
+        # Mirror the CLI default-resolution order
+        for candidate in ("crewai", "praisonaiagents", "autogen", "ag2"):
+            if is_available(candidate):
+                framework = "praisonai" if candidate == "praisonaiagents" else candidate
+                break
+        else:
+            raise RuntimeError(
+                "No supported framework installed. "
+                "Install one of: crewai, praisonaiagents, autogen, ag2."
+            )
+    else:
+        # Validate explicit framework like CLI does
+        from .framework_adapters.validators import assert_framework_available
+        assert_framework_available(framework)
+
+    gen = AgentsGenerator(
+        agent_file=agent_file,
+        framework=framework,
+        config_list=_build_config_list(),
+        tools=tools,
+        agent_yaml=agent_yaml,
+        cli_config=cli_config,
+    )
+    return gen.generate_crew_and_kickoff()
+
+
+async def arun(agent_file: str,
+               framework: str | None = None,
+               *,
+               tools: list | None = None,
+               agent_yaml: str | None = None,
+               cli_config: dict | None = None) -> str:
+    """Async equivalent of `run()` for FastAPI / Jupyter async callers."""
+    import asyncio
+    return await asyncio.to_thread(
+        run, agent_file, framework,
+        tools=tools, agent_yaml=agent_yaml, cli_config=cli_config,
+    )

{praisonai-4.6.44 → praisonai-4.6.46}/praisonai/_framework_availability.py

@@ -30,6 +30,11 @@ _PROBES: dict[str, Callable[[], bool]] = {
     "agentops":          lambda: importlib.util.find_spec("agentops") is not None,
     "litellm":           lambda: importlib.util.find_spec("litellm") is not None,
     "openai":            lambda: importlib.util.find_spec("openai") is not None,
+    # Additional probes for Gap 2 consolidation
+    "acp":               lambda: importlib.util.find_spec("acp") is not None,
+    "rich":              lambda: importlib.util.find_spec("rich") is not None,
+    "gradio":            lambda: importlib.util.find_spec("gradio") is not None,
+    "unsloth":           lambda: importlib.util.find_spec("unsloth") is not None,
 }
 
 def is_available(name: str) -> bool:

{praisonai-4.6.44 → praisonai-4.6.46}/praisonai/acp/__init__.py

@@ -42,7 +42,8 @@ def __getattr__(name: str):
 
 def _check_acp_available() -> bool:
     """Check if agent-client-protocol package is installed."""
-    return importlib.util.find_spec("acp") is not None
+    from .._framework_availability import is_available
+    return is_available("acp")
 
 
 def _get_install_instructions() -> str:

{praisonai-4.6.44 → praisonai-4.6.46}/praisonai/agents_generator.py

@@ -221,14 +221,14 @@ class AgentsGenerator:
         elif os.environ.get('LOGLEVEL'):
             self.logger.setLevel(getattr(logging, os.environ.get('LOGLEVEL', 'INFO').upper(), logging.INFO))
         
-        # Initialize tool resolver (single source of truth for tool resolution)
-        from .tool_resolver import ToolResolver
-        self.tool_resolver = ToolResolver()
-        
         # Keep tool registry for backward compatibility with autogen adapters
         self.tool_registry = ToolRegistry()
         self.tool_registry.register_builtin_autogen_adapters()
         
+        # Initialize tool resolver with the registry wired in (single source of truth for tool resolution)
+        from .tool_resolver import ToolResolver
+        self.tool_resolver = ToolResolver(registry=self.tool_registry)
+        
         # DI-friendly: tests/multi-tenant runtimes pass their own registry;
         # CLI users get the process default.
         self._adapter_registry = adapter_registry or get_default_registry()

{praisonai-4.6.44 → praisonai-4.6.46}/praisonai/claw/default_app.py

@@ -8,29 +8,9 @@ Custom page: Feature Explorer
 """
 
 import os
+
 import praisonaiui as aiui
-from praisonai.ui._aiui_datastore import PraisonAISessionDataStore
-
-# ── Set up datastore bridge ─────────────────────────────────
-aiui.set_datastore(PraisonAISessionDataStore())
-
-# ── Dashboard style ─────────────────────────────────────────
-aiui.set_style("dashboard")
-aiui.set_pages([
-    "chat",        # Core AI chat
-    "channels",    # Messaging platforms
-    "agents",      # Agent management
-    "skills",      # Available tools
-    "memory",      # Agent memory
-    "knowledge",   # Knowledge base
-    "cron",        # Scheduled jobs
-    "guardrails",  # Safety rules
-    "sessions",    # Conversation history
-    "usage",       # Token usage & costs
-    "config",      # Runtime configuration
-    "logs",        # Server logs
-    "debug",       # System debug info
-])
+from praisonai.integration.host_app import configure_host, create_host_app
 
 # ── Agent definitions ───────────────────────────────────────
 AGENTS = [
@@ -71,6 +51,35 @@ AGENTS = [
 ]
 
 
+def _build_praison_agents():
+    from praisonaiagents import Agent
+
+    return [
+        Agent(name=a["name"], instructions=a["instructions"], llm=a["model"])
+        for a in AGENTS
+    ]
+
+
+configure_host(
+    pages=[
+        "chat",
+        "channels",
+        "agents",
+        "skills",
+        "memory",
+        "knowledge",
+        "cron",
+        "guardrails",
+        "sessions",
+        "usage",
+        "config",
+        "logs",
+        "debug",
+    ],
+    agents=_build_praison_agents(),
+    modules=["jobs"],
+)
+
 
 # ── Custom page: Feature Explorer ───────────────────────────
 
@@ -110,7 +119,10 @@ def _register_agents_in_dashboard():
         })
         print(f"   ✓ Agent: {agent_def['icon']} {agent_def['name']}")
 
+
 try:
     _register_agents_in_dashboard()
 except Exception as e:
     print(f"   ⚠️  Agent registration failed (non-fatal): {e}")
+
+app = create_host_app()

{praisonai-4.6.44 → praisonai-4.6.46}/praisonai/cli/commands/dashboard.py

@@ -199,93 +199,24 @@ def _auto_start_services(console, host: str) -> bool:
 
 
 def _run_aiui_dashboard(port: int, host: str, console) -> bool:
-    """Run the aiui dashboard interface using proper CLI entrypoint."""
-    console.print("[bold green]🦞 Starting aiui Dashboard...[/bold green]")
-    
-    try:
-        import tempfile
-        import os
-        
-        # Check if aiui is available first
-        result = subprocess.run([
-            sys.executable, "-c", "import praisonaiui"
-        ], capture_output=True, text=True)
-        
-        if result.returncode != 0:
-            console.print("[red]Error: aiui package not installed.[/red]")
-            console.print("[yellow]Install with: pip install aiui[/yellow]")
-            return False
-        
-        # Create a temporary script for aiui dashboard based on claw pattern
-        aiui_script = '''import os
-import praisonaiui as aiui
-from praisonai.ui._aiui_datastore import PraisonAISessionDataStore
-
-# Set up datastore bridge
-aiui.set_datastore(PraisonAISessionDataStore())
+    """Run the aiui dashboard in-process via ``build_host_app()`` (Pattern B)."""
+    console.print("[bold green]🦞 Starting aiui Dashboard (Pattern B host)...[/bold green]")
 
-# Configure dashboard style
-aiui.set_style("dashboard")
-aiui.set_branding(title="PraisonAI Unified Dashboard", logo="🌟")
-
-# Set up pages for unified dashboard
-aiui.set_pages([
-    "chat", "agents", "memory", "knowledge", 
-    "skills", "sessions", "usage", "config", "logs"
-])
-
-# Register a simple welcome message
-@aiui.welcome
-async def on_welcome():
-    await aiui.say("🌟 Welcome to PraisonAI Unified Dashboard!")
-    await aiui.say("Access all your AI services from one interface.")
-
-# Register basic reply handler
-@aiui.reply
-async def on_reply(message: str, settings: dict | None = None):
-    await aiui.think("Processing...")
-    await aiui.say(f"Unified Dashboard received: {message}")
-    await aiui.say("Use the sidebar to access Flow, Agents, Memory, and more!")
-'''
-
-        # Create temp file safely
-        with tempfile.NamedTemporaryFile(mode='w', suffix='.py', delete=False) as f:
-            f.write(aiui_script)
-            temp_script = f.name
-        
-        try:
-            console.print(f"[green]✓ Starting aiui dashboard on {host}:{port}[/green]")
-            
-            # Use aiui CLI to run the dashboard (NOT create_app)
-            # Try aiui command first, fallback to python -m
-            try:
-                result = subprocess.run([
-                    "aiui", "run", temp_script, "--port", str(port), "--host", host
-                ], check=True)
-            except (subprocess.CalledProcessError, FileNotFoundError):
-                # Fallback to python -m praisonaiui
-                result = subprocess.run([
-                    sys.executable, "-m", "praisonaiui.cli", "run", 
-                    temp_script, "--port", str(port), "--host", host
-                ], check=True)
-            
-            return True
-            
-        except subprocess.CalledProcessError as e:
-            console.print(f"[red]aiui dashboard exited with code {e.returncode}[/red]")
-            return False
-        finally:
-            # Clean up temp file
-            try:
-                os.unlink(temp_script)
-            except (OSError, FileNotFoundError):
-                pass
-        
-    except subprocess.CalledProcessError as e:
-        console.print(f"[red]aiui dashboard failed with code {e.returncode}[/red]")
+    try:
+        import uvicorn
+        from praisonai.integration.host_app import build_host_app
+    except ImportError:
+        console.print("[red]Error: aiui integration dependencies missing.[/red]")
+        console.print('[yellow]Install with: pip install "praisonai[ui]"[/yellow]')
         return False
+
+    try:
+        app = build_host_app(pages=["chat", "sessions", "workflows", "hooks", "usage"])
+        console.print(f"[green]✓ Starting in-process host on {host}:{port}[/green]")
+        uvicorn.run(app, host=host, port=port, log_level="info")
+        return True
     except Exception as e:
-        console.print(f"[red]Error running aiui dashboard: {e}[/red]")
+        console.print(f"[red]Error running in-process host: {e}[/red]")
         return False
 
 
@@ -612,6 +543,10 @@ def unified(
     """
     Launch the PraisonAI Unified Dashboard.
     
+    Pattern B (default with --aiui): in-process ``build_host_app()`` host.
+    Pattern C: ``praisonai serve gateway`` or ``run_integrated_gateway()``.
+    Legacy: set ``PRAISONAI_HOST_LEGACY=1`` for callback-only ``@aiui.reply`` mode.
+    
     Provides a single interface at localhost:3000 to access:
     - Flow Visual Builder (Langflow) - port 7860
     - Claw Dashboard (Full UI) - port 8082  

{praisonai-4.6.44 → praisonai-4.6.46}/praisonai/cli/commands/doctor.py

@@ -237,6 +237,23 @@ def doctor_cleanup(
     raise typer.Exit(0 if removed == len(stale_dirs) else 1)
 
 
+@app.command("skills")
+def doctor_skills(
+    deep: bool = typer.Option(False, "--deep", help="Enable deeper probes"),
+    json_output: bool = typer.Option(False, "--json", help="Output JSON"),
+    show_requirements: bool = typer.Option(False, "--requirements", help="Show detailed requirements"),
+):
+    """Check skills capabilities and requirements."""
+    args = ["skills"]
+    if deep:
+        args.append("--deep")
+    if json_output:
+        args.append("--json")
+    if show_requirements:
+        args.append("--requirements")
+    raise typer.Exit(_run_doctor(args))
+
+
 @app.command("troubleshoot")
 def doctor_troubleshoot():
     """

{praisonai-4.6.44 → praisonai-4.6.46}/praisonai/cli/commands/ui.py

@@ -13,7 +13,12 @@ from typing import Optional
 
 import typer
 
-app = typer.Typer(help="🤖 PraisonAI Clean Chat UI")
+app = typer.Typer(
+    help=(
+        "🤖 PraisonAI Clean Chat UI (Pattern B host via bundled default_app). "
+        "Pattern C: AIUIGateway. Legacy: PRAISONAI_HOST_LEGACY=1."
+    )
+)
 
 UI_DIR = Path.home() / ".praisonai" / "ui"
 DEFAULT_APP = UI_DIR / "app.py"

{praisonai-4.6.44 → praisonai-4.6.46}/praisonai/cli/features/agent_tools.py

@@ -110,21 +110,8 @@ def create_agent_centric_tools(
     if orchestrator is None:
         orchestrator = ActionOrchestrator(runtime)
     
-    # Helper to run async functions synchronously
-    def run_async(coro):
-        """Run async coroutine synchronously."""
-        try:
-            loop = asyncio.get_event_loop()
-            if loop.is_running():
-                # Create a new loop in a thread
-                import concurrent.futures
-                with concurrent.futures.ThreadPoolExecutor() as executor:
-                    future = executor.submit(asyncio.run, coro)
-                    return future.result(timeout=60)
-            else:
-                return loop.run_until_complete(coro)
-        except RuntimeError:
-            return asyncio.run(coro)
+    # Helper to run async functions synchronously using the shared bridge
+    from praisonai._async_bridge import run_sync
     
     # =========================================================================
     # ACP-Powered File Tools
@@ -204,7 +191,7 @@ def create_agent_centric_tools(
                 "verified": result.success
             })
         
-        return run_async(_create())
+        return run_sync(_create())
     
     def acp_edit_file(filepath: str, new_content: str) -> str:
         """
@@ -261,7 +248,7 @@ def create_agent_centric_tools(
                 "error": result.error
             })
         
-        return run_async(_edit())
+        return run_sync(_edit())
     
     def acp_delete_file(filepath: str) -> str:
         """
@@ -313,7 +300,7 @@ def create_agent_centric_tools(
                 "verified": result.success
             })
         
-        return run_async(_delete())
+        return run_sync(_delete())
     
     def acp_execute_command(command: str, cwd: str = None) -> str:
         """
@@ -372,7 +359,7 @@ def create_agent_centric_tools(
                 "error": result.error
             })
         
-        return run_async(_execute())
+        return run_sync(_execute())
     
     # =========================================================================
     # LSP-Powered Code Intelligence Tools
@@ -404,7 +391,7 @@ def create_agent_centric_tools(
             except asyncio.TimeoutError:
                 return json.dumps({"error": "LSP list_symbols timed out (10s)", "success": False})
         
-        return run_async(_list())
+        return run_sync(_list())
     
     def lsp_find_definition(symbol: str, file_path: str = None) -> str:
         """
@@ -432,7 +419,7 @@ def create_agent_centric_tools(
             except asyncio.TimeoutError:
                 return json.dumps({"error": "LSP find_definition timed out (10s)", "success": False})
         
-        return run_async(_find())
+        return run_sync(_find())
     
     def lsp_find_references(symbol: str, file_path: str = None) -> str:
         """
@@ -460,7 +447,7 @@ def create_agent_centric_tools(
             except asyncio.TimeoutError:
                 return json.dumps({"error": "LSP find_references timed out (10s)", "success": False})
         
-        return run_async(_find())
+        return run_sync(_find())
     
     def lsp_get_diagnostics(file_path: str = None) -> str:
         """
@@ -487,7 +474,7 @@ def create_agent_centric_tools(
             except asyncio.TimeoutError:
                 return json.dumps({"error": "LSP diagnostics timed out (10s)", "success": False})
         
-        return run_async(_get())
+        return run_sync(_get())
     
     # =========================================================================
     # Basic File Tools (for read-only operations)