praisonai-code 0.0.5__tar.gz → 0.0.7__tar.gz

{praisonai_code-0.0.5 → praisonai_code-0.0.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: praisonai-code
-Version: 0.0.5
+Version: 0.0.7
 Summary: Agentic terminal CLI for PraisonAI — the terminal-native agent (run, chat, code, runtime, cli backends) extracted from the praisonai wrapper.
 Author: Mervin Praison
 License: MIT

{praisonai_code-0.0.5 → praisonai_code-0.0.7}/praisonai_code/__init__.py

@@ -12,6 +12,6 @@ the remaining terminal-agent modules, with PEP 562 shims left behind at the
 old ``praisonai.*`` paths for backward compatibility.
 """
 
-__version__ = "0.0.4"
+__version__ = "0.0.6"
 
 __all__ = ["__version__"]

{praisonai_code-0.0.5 → praisonai_code-0.0.7}/praisonai_code/_wrapper_bridge.py

@@ -39,10 +39,15 @@ def get_wrapper_attr(module_name: str, attr: str) -> Any:
 
 
 def optional_wrapper_attr(module_name: str, attr: str, default: T | None = None) -> Any | T | None:
-    """Return a wrapper attribute when installed, else ``default``."""
+    """Return a wrapper attribute when installed, else ``default``.
+
+    Falls back to ``default`` when the wrapper package is missing (ImportError)
+    or when an installed wrapper module lacks the requested attribute
+    (AttributeError), so callers degrade gracefully in both cases.
+    """
     if not wrapper_available():
         return default
     try:
         return get_wrapper_attr(module_name, attr)
-    except ImportError:
+    except (ImportError, AttributeError):
         return default

{praisonai_code-0.0.5 → praisonai_code-0.0.7}/praisonai_code/cli/app.py

@@ -223,6 +223,9 @@ _LAZY_COMMANDS: Dict[str, Tuple[str, str, str]] = {
 # relative ``.commands.*`` path would resolve to ``praisonai_code`` where the
 # modules do not live. The import happens lazily at invocation time only, so
 # ``praisonai_code`` keeps no static dependency on ``praisonai``.
+# C7.1 audit: wrapper-resident Typer modules only (no praisonai_code.cli.commands.*
+# copy). Do NOT add train/serve here — their impl lives in praisonai_code; bridge
+# internal wrapper imports instead. mint_link is wrapper-only but not in Typer registry.
 _WRAPPER_COMMANDS = frozenset({
     "bot",
     "gateway",
@@ -455,7 +458,8 @@ class LazyCommandGroup(TyperGroup):
             console = Console()
             
             try:
-                from praisonai import AgentOS
+                from praisonai_code._wrapper_bridge import get_wrapper_attr
+                AgentOS = get_wrapper_attr("praisonai", "AgentOS")
                 from praisonaiagents import AgentOSConfig
             except ImportError as e:
                 console.print(f"[red]Error importing AgentOS: {e}[/red]")

{praisonai_code-0.0.5 → praisonai_code-0.0.7}/praisonai_code/cli/commands/chat.py

@@ -5,6 +5,7 @@ Provides terminal-native interactive chat mode.
 This command NEVER opens a browser - it runs entirely in the terminal.
 """
 
+import logging
 from typing import List, Optional, Union
 
 import typer
@@ -231,6 +232,10 @@ def chat_main(
         response = tui.run_single(prompt)
         if response:
             print(response)
+        # Propagate a non-zero exit code on failure (e.g. invalid API key)
+        # so shell scripts and CI can detect authentication failures (#2562).
+        if tui.execution_failed:
+            raise typer.Exit(1)
     else:
         # Interactive split-pane TUI mode
         tui.run()
@@ -278,20 +283,41 @@ def _run_profiled_chat(
     agent = Agent(**agent_config)
     profiler.mark_init_end()
     
-    # Execution phase
+    # Execution phase. Capture auth failures (raised or logged-then-swallowed)
+    # so profiling still runs and CI can detect the failure (#2562).
+    from praisonai_code.cli.interactive.async_tui import _LogCapture
+
+    log_capture = _LogCapture()
+    root_logger = logging.getLogger()
+    root_logger.addHandler(log_capture)
+
+    response = None
+    failed = False
     profiler.mark_exec_start()
-    response = agent.start(prompt)
-    profiler.mark_exec_end()
-    
+    try:
+        response = agent.start(prompt)
+    except Exception as exc:  # noqa: BLE001 - surface any failure via exit code
+        typer.echo(f"Error: {exc}", err=True)
+        failed = True
+    finally:
+        profiler.mark_exec_end()
+        root_logger.removeHandler(log_capture)
+
     profiler.stop()
-    
+
     # Print response
     if response:
         print(response)
-    
-    # Print profiling report
+
+    # Print profiling report (always, even on failure)
     profiler.print_report()
 
+    # Propagate failure (e.g. invalid API key) so CI can detect it (#2562).
+    # An empty-but-successful response is NOT treated as a failure on its own;
+    # only a raised exception or a logged auth error (with no response) exits 1.
+    if failed or (not response and log_capture.find_auth_error()):
+        raise typer.Exit(1)
+
 
 def _run_legacy_terminal_chat(
     prompt: Optional[str] = None,

{praisonai_code-0.0.5 → praisonai_code-0.0.7}/praisonai_code/cli/commands/doctor.py

@@ -14,6 +14,38 @@ from ..output.console import get_output_controller
 app = typer.Typer(help="Health checks and diagnostics")
 
 
+@app.callback(invoke_without_command=True)
+def doctor_main(
+    ctx: typer.Context,
+    quick: bool = typer.Option(False, "--quick", help="Fast env-only checks (alias for 'doctor env')"),
+    live: bool = typer.Option(False, "--live", help="Include live provider pings (validate keys, not just presence)"),
+    deep: bool = typer.Option(False, "--deep", help="Enable deeper probes"),
+    strict: bool = typer.Option(False, "--strict", help="Treat warnings as failures"),
+    json_output: bool = typer.Option(False, "--json", help="Output machine-readable JSON"),
+):
+    """Run a full setup report when no subcommand is given.
+
+    ``praisonai doctor`` (no subcommand) now runs a comprehensive first-run /
+    operator troubleshooting report instead of failing with "Missing command".
+    Use ``praisonai doctor env`` (or ``--quick``) for the fast, CI-friendly path.
+    """
+    if ctx.invoked_subcommand is not None:
+        return
+
+    args: list = []
+    if quick:
+        args.append("env")
+    if live:
+        args.append("--live")
+    if deep:
+        args.append("--deep")
+    if strict:
+        args.append("--strict")
+    if json_output:
+        args.append("--json")
+    raise typer.Exit(_run_doctor(args))
+
+
 def _run_doctor(args: list) -> int:
     """Run doctor command with args."""
     try:
@@ -292,6 +324,38 @@ def doctor_runtime(
     raise typer.Exit(_run_doctor(args))
 
 
+@app.command("fix")
+def doctor_fix(
+    dry_run: bool = typer.Option(True, "--dry-run/--execute", help="Show proposed changes without applying them (default: dry-run)"),
+    no_backup: bool = typer.Option(False, "--no-backup", help="Skip creating backup files before applying fixes"),
+    file: Optional[str] = typer.Option(None, "--file", "-f", help="Config file to fix (default: search for YAML files in the current directory)"),
+    quiet: bool = typer.Option(False, "--quiet", "-q", help="Minimal output"),
+):
+    """
+    Run safe auto-remediation for common setup issues.
+
+    Dry-run by default: lists proposed changes without modifying anything.
+    Use --execute to apply fixes (a .bak backup is created unless --no-backup).
+
+    Scope (phase 1):
+      • Migrate deprecated cli_backend YAML configuration
+
+    Examples:
+        praisonai doctor fix             # Dry-run: list proposed changes
+        praisonai doctor fix --execute   # Apply safe fixes with backup
+    """
+    args = ["fix"]
+    if not dry_run:
+        args.append("--execute")
+    if no_backup:
+        args.append("--no-backup")
+    if file:
+        args.extend(["--file", file])
+    if quiet:
+        args.append("--quiet")
+    raise typer.Exit(_run_doctor(args))
+
+
 @app.command("troubleshoot")
 def doctor_troubleshoot():
     """

{praisonai_code-0.0.5 → praisonai_code-0.0.7}/praisonai_code/cli/features/capabilities.py

@@ -9,6 +9,12 @@ import sys
 from typing import Optional, List
 
 
+def _cap(submodule: str, attr: str):
+    """Load a wrapper capabilities symbol (requires pip install praisonai)."""
+    from praisonai_code._wrapper_bridge import get_wrapper_attr
+    return get_wrapper_attr(f"praisonai.capabilities.{submodule}", attr)
+
+
 class CapabilitiesHandler:
     """Handler for capabilities CLI commands."""
     
@@ -50,9 +56,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(remaining_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.audio import transcribe
-        
+        transcribe = _cap("audio", "transcribe")
         try:
             result = transcribe(
                 audio=parsed.file,
@@ -93,9 +97,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(remaining_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.audio import speech
-        
+        speech = _cap("audio", "speech")
         try:
             result = speech(
                 text=parsed.text,
@@ -149,9 +151,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(remaining_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.images import image_generate
-        
+        image_generate = _cap("images", "image_generate")
         try:
             results = image_generate(
                 prompt=parsed.prompt,
@@ -184,9 +184,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(remaining_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.images import image_edit
-        
+        image_edit = _cap("images", "image_edit")
         try:
             results = image_edit(
                 image=parsed.image,
@@ -244,9 +242,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(remaining_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.files import file_create
-        
+        file_create = _cap("files", "file_create")
         try:
             result = file_create(
                 file=parsed.file,
@@ -273,9 +269,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(remaining_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.files import file_list
-        
+        file_list = _cap("files", "file_list")
         try:
             results = file_list(purpose=parsed.purpose)
             
@@ -300,9 +294,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(remaining_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.files import file_retrieve
-        
+        file_retrieve = _cap("files", "file_retrieve")
         try:
             result = file_retrieve(file_id=parsed.file_id)
             
@@ -327,9 +319,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(remaining_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.files import file_delete
-        
+        file_delete = _cap("files", "file_delete")
         try:
             result = file_delete(file_id=parsed.file_id)
             
@@ -389,9 +379,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(unknown_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.rerank import rerank
-        
+        rerank = _cap("rerank", "rerank")
         try:
             result = rerank(
                 query=parsed.query,
@@ -420,9 +408,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(unknown_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.moderations import moderate
-        
+        moderate = _cap("moderations", "moderate")
         try:
             text_input = " ".join(parsed.text)
             results = moderate(
@@ -454,9 +440,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(unknown_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.ocr import ocr
-        
+        ocr = _cap("ocr", "ocr")
         try:
             result = ocr(
                 document=parsed.document,
@@ -514,9 +498,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(remaining_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.batches import batch_create
-        
+        batch_create = _cap("batches", "batch_create")
         try:
             result = batch_create(
                 input_file_id=parsed.file_id,
@@ -534,8 +516,7 @@ class CapabilitiesHandler:
     @staticmethod
     def _handle_batches_list(args, remaining_args):
         """Handle: praisonai batches list"""
-        from praisonai.capabilities.batches import batch_list
-        
+        batch_list = _cap("batches", "batch_list")
         try:
             results = batch_list()
             
@@ -560,9 +541,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(remaining_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.batches import batch_retrieve
-        
+        batch_retrieve = _cap("batches", "batch_retrieve")
         try:
             result = batch_retrieve(batch_id=parsed.batch_id)
             
@@ -587,9 +566,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(remaining_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.batches import batch_cancel
-        
+        batch_cancel = _cap("batches", "batch_cancel")
         try:
             result = batch_cancel(batch_id=parsed.batch_id)
             
@@ -633,9 +610,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(remaining_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.vector_stores import vector_store_create
-        
+        vector_store_create = _cap("vector_stores", "vector_store_create")
         try:
             result = vector_store_create(
                 name=parsed.name,
@@ -663,9 +638,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(remaining_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.vector_stores import vector_store_search
-        
+        vector_store_search = _cap("vector_stores", "vector_store_search")
         try:
             result = vector_store_search(
                 vector_store_id=parsed.store_id,
@@ -719,9 +692,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(remaining_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.assistants import assistant_create
-        
+        assistant_create = _cap("assistants", "assistant_create")
         try:
             result = assistant_create(
                 name=parsed.name,
@@ -741,8 +712,7 @@ class CapabilitiesHandler:
     @staticmethod
     def _handle_assistants_list(args, remaining_args):
         """Handle: praisonai assistants list"""
-        from praisonai.capabilities.assistants import assistant_list
-        
+        assistant_list = _cap("assistants", "assistant_list")
         try:
             results = assistant_list()
             
@@ -790,9 +760,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(remaining_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.fine_tuning import fine_tuning_create
-        
+        fine_tuning_create = _cap("fine_tuning", "fine_tuning_create")
         try:
             result = fine_tuning_create(
                 training_file=parsed.file_id,
@@ -812,8 +780,7 @@ class CapabilitiesHandler:
     @staticmethod
     def _handle_fine_tuning_list(args, remaining_args):
         """Handle: praisonai fine-tuning list"""
-        from praisonai.capabilities.fine_tuning import fine_tuning_list
-        
+        fine_tuning_list = _cap("fine_tuning", "fine_tuning_list")
         try:
             results = fine_tuning_list()
             
@@ -846,9 +813,7 @@ class CapabilitiesHandler:
         if not parsed.prompt:
             print("Usage: praisonai completions <prompt> [options]")
             return 1
-        
-        from praisonai.capabilities.completions import chat_completion
-        
+        chat_completion = _cap("completions", "chat_completion")
         try:
             messages = []
             if parsed.system:
@@ -899,9 +864,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(remaining_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.messages import messages_create
-        
+        messages_create = _cap("messages", "messages_create")
         try:
             result = messages_create(
                 messages=[{"role": "user", "content": parsed.prompt}],
@@ -931,9 +894,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(remaining_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.messages import count_tokens
-        
+        count_tokens = _cap("messages", "count_tokens")
         try:
             result = count_tokens(
                 messages=[{"role": "user", "content": parsed.text}],
@@ -958,9 +919,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(unknown_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.guardrails import apply_guardrail
-        
+        apply_guardrail = _cap("guardrails", "apply_guardrail")
         try:
             result = apply_guardrail(
                 content=parsed.content,
@@ -994,9 +953,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(unknown_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.rag import rag_query
-        
+        rag_query = _cap("rag", "rag_query")
         try:
             result = rag_query(
                 query=parsed.query,
@@ -1028,9 +985,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(unknown_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.realtime import realtime_connect
-        
+        realtime_connect = _cap("realtime", "realtime_connect")
         try:
             if parsed.action == "connect":
                 session = realtime_connect(model=parsed.model)
@@ -1059,9 +1014,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(unknown_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.videos import video_generate
-        
+        video_generate = _cap("videos", "video_generate")
         try:
             result = video_generate(
                 prompt=parsed.prompt,
@@ -1089,9 +1042,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(unknown_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.a2a import a2a_send
-        
+        a2a_send = _cap("a2a", "a2a_send")
         try:
             result = a2a_send(
                 message=parsed.message,
@@ -1137,9 +1088,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(remaining_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.containers import container_create
-        
+        container_create = _cap("containers", "container_create")
         try:
             result = container_create(
                 image=parsed.image,
@@ -1173,9 +1122,7 @@ class CapabilitiesHandler:
                 parsed = parser.parse_args(action_args)
             except SystemExit:
                 return 1
-            
-            from praisonai.capabilities.container_files import container_file_read
-            
+            container_file_read = _cap("container_files", "container_file_read")
             try:
                 result = container_file_read(
                     container_id=parsed.container_id,
@@ -1201,9 +1148,7 @@ class CapabilitiesHandler:
                 parsed = parser.parse_args(action_args)
             except SystemExit:
                 return 1
-            
-            from praisonai.capabilities.container_files import container_file_list
-            
+            container_file_list = _cap("container_files", "container_file_list")
             try:
                 results = container_file_list(
                     container_id=parsed.container_id,
@@ -1238,8 +1183,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(unknown_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.passthrough import passthrough
+        passthrough = _cap("passthrough", "passthrough")
         import json
         
         try:
@@ -1273,9 +1217,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(unknown_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.responses import responses_create
-        
+        responses_create = _cap("responses", "responses_create")
         try:
             result = responses_create(
                 input=parsed.input,
@@ -1301,9 +1243,7 @@ class CapabilitiesHandler:
             parsed = parser.parse_args(unknown_args)
         except SystemExit:
             return 1
-        
-        from praisonai.capabilities.search import search
-        
+        search = _cap("search", "search")
         try:
             result = search(
                 query=parsed.query,

praisonai_code-0.0.7/praisonai_code/cli/features/doctor/checks/_wrapper_checks.py

@@ -0,0 +1,38 @@
+"""Shared helpers for doctor checks that require the praisonai wrapper."""
+
+from __future__ import annotations
+
+import time
+from typing import Optional
+
+from ..models import CheckResult, CheckStatus, CheckCategory
+
+
+def skip_if_no_wrapper(
+    check_id: str,
+    title: str,
+    *,
+    start: Optional[float] = None,
+    category: CheckCategory = CheckCategory.BOTS,
+) -> Optional[CheckResult]:
+    """Return a SKIP result when the full wrapper is not installed."""
+    from praisonai_code._wrapper_bridge import wrapper_available
+
+    if wrapper_available():
+        return None
+    duration_ms = (time.time() - start) * 1000 if start is not None else None
+    return CheckResult(
+        id=check_id,
+        title=title,
+        category=category,
+        status=CheckStatus.SKIP,
+        message="Install full wrapper: pip install praisonai",
+        duration_ms=duration_ms,
+    )
+
+
+def bots_config_schema():
+    """Load ``praisonai.bots._config_schema`` via the wrapper bridge."""
+    from praisonai_code._wrapper_bridge import import_wrapper_module
+
+    return import_wrapper_module("praisonai.bots._config_schema")

{praisonai_code-0.0.5 → praisonai_code-0.0.7}/praisonai_code/cli/features/doctor/checks/acp_checks.py

@@ -8,6 +8,7 @@ import os
 
 from ..models import CheckCategory, CheckResult, CheckStatus
 from ..registry import register_check
+from ._wrapper_checks import skip_if_no_wrapper
 
 logger = logging.getLogger(__name__)
 
@@ -102,8 +103,12 @@ def check_acp_sdk(config=None) -> CheckResult:
 )
 def check_acp_server(config=None) -> CheckResult:
     """Check if ACP server can be imported."""
+    skipped = skip_if_no_wrapper("acp_server", "ACP Server Import", category=CheckCategory.TOOLS)
+    if skipped:
+        return skipped
     try:
-        from praisonai.acp import ACPServer  # noqa: F401
+        from praisonai_code._wrapper_bridge import get_wrapper_attr
+        get_wrapper_attr("praisonai.acp", "ACPServer")
         
         return CheckResult(
             id="acp_server",