praisonai-code 0.0.28__tar.gz → 0.0.30__tar.gz

{praisonai_code-0.0.28 → praisonai_code-0.0.30}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: praisonai-code
-Version: 0.0.28
+Version: 0.0.30
 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
@@ -71,17 +71,32 @@ click, textual, PyYAML, python-dotenv, litellm, mcp, pydantic — see
 
 ### Standalone limits (`pip install praisonai-code` only)
 
+The terminal-native commands (`run`, `chat`, `code`, `doctor`, `daemon`) live in
+`praisonai_code.cli.commands.*` and resolve via `LazyCommandGroup` without
+importing the wrapper. Only commands in `_WRAPPER_RESIDENT_COMMANDS` (see
+`praisonai_code/cli/app.py`) require `pip install praisonai`.
+
 | Command | Works standalone? | Notes |
 |---------|-------------------|-------|
+| `praisonai-code --version` | Yes | |
 | `run --help`, `config`, `doctor` | Yes | |
-| `run --output actions "…"` | Yes | In-process `Agent` |
-| `run "…"` (default) | No | Requires `pip install praisonai` |
-| `chat`, `code` | No | TUI / interactive legacy live in wrapper |
+| `run --output verbose "…"` | Yes | In-process `Agent` (verified). `run` modes: `silent` (default), `actions`, `verbose`, `json`, `stream` |
+| `run "…"` (default) | Yes | Resolves via `praisonai_code.cli.commands.run` |
+| `run --output actions "…"` | Yes (intended) | Currently affected by an `auto_save` shadow-import bug — tracked separately |
+| `chat --output plain "…"` | Yes | One-shot; interactive REPL also in code package. `chat` modes: `actions` (default), `plain`, `verbose`, `json`, `silent` |
+| `code --help` | Yes | Full code assistant command registered |
 | `daemon start` (foreground) | Yes | |
 | `daemon start --background` | Yes | Spawns `python -m praisonai_code.runtime` |
+| `batch`, `docs`, `langfuse`, `flow`, `n8n`, `train`, … | No | `_WRAPPER_RESIDENT_COMMANDS` — needs `pip install praisonai` |
+| `bot`, `gateway`, `pairing`, … | No | Needs `praisonai` bot package |
+
+**Known limitations:**
+- `praisonai-code --help` may crash on Windows (cp1252) due to emoji in command
+  descriptions — tracked separately.
+- Piped stdin (`file | run`) is not yet supported on Windows.
 
-For full terminal UX (`chat`, `code`, default `run`), install the wrapper:
-`pip install praisonai`.
+For bots, gateway, batch, observability sinks, and the wrapper-resident commands
+above, install the full wrapper: `pip install praisonai`.
 
 Completed C7 steps:
 - `praisonai_code._registry` — vendored plugin registry (no wrapper import)

{praisonai_code-0.0.28 → praisonai_code-0.0.30}/README.md

@@ -49,17 +49,32 @@ click, textual, PyYAML, python-dotenv, litellm, mcp, pydantic — see
 
 ### Standalone limits (`pip install praisonai-code` only)
 
+The terminal-native commands (`run`, `chat`, `code`, `doctor`, `daemon`) live in
+`praisonai_code.cli.commands.*` and resolve via `LazyCommandGroup` without
+importing the wrapper. Only commands in `_WRAPPER_RESIDENT_COMMANDS` (see
+`praisonai_code/cli/app.py`) require `pip install praisonai`.
+
 | Command | Works standalone? | Notes |
 |---------|-------------------|-------|
+| `praisonai-code --version` | Yes | |
 | `run --help`, `config`, `doctor` | Yes | |
-| `run --output actions "…"` | Yes | In-process `Agent` |
-| `run "…"` (default) | No | Requires `pip install praisonai` |
-| `chat`, `code` | No | TUI / interactive legacy live in wrapper |
+| `run --output verbose "…"` | Yes | In-process `Agent` (verified). `run` modes: `silent` (default), `actions`, `verbose`, `json`, `stream` |
+| `run "…"` (default) | Yes | Resolves via `praisonai_code.cli.commands.run` |
+| `run --output actions "…"` | Yes (intended) | Currently affected by an `auto_save` shadow-import bug — tracked separately |
+| `chat --output plain "…"` | Yes | One-shot; interactive REPL also in code package. `chat` modes: `actions` (default), `plain`, `verbose`, `json`, `silent` |
+| `code --help` | Yes | Full code assistant command registered |
 | `daemon start` (foreground) | Yes | |
 | `daemon start --background` | Yes | Spawns `python -m praisonai_code.runtime` |
+| `batch`, `docs`, `langfuse`, `flow`, `n8n`, `train`, … | No | `_WRAPPER_RESIDENT_COMMANDS` — needs `pip install praisonai` |
+| `bot`, `gateway`, `pairing`, … | No | Needs `praisonai` bot package |
+
+**Known limitations:**
+- `praisonai-code --help` may crash on Windows (cp1252) due to emoji in command
+  descriptions — tracked separately.
+- Piped stdin (`file | run`) is not yet supported on Windows.
 
-For full terminal UX (`chat`, `code`, default `run`), install the wrapper:
-`pip install praisonai`.
+For bots, gateway, batch, observability sinks, and the wrapper-resident commands
+above, install the full wrapper: `pip install praisonai`.
 
 Completed C7 steps:
 - `praisonai_code._registry` — vendored plugin registry (no wrapper import)

{praisonai_code-0.0.28 → praisonai_code-0.0.30}/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.28"
+__version__ = "0.0.30"
 
 __all__ = ["__version__"]

{praisonai_code-0.0.28 → praisonai_code-0.0.30}/praisonai_code/cli/commands/chat.py

@@ -60,7 +60,7 @@ def chat_main(
         flag_value="true",
     ),
     no_memory: bool = typer.Option(False, "--no-memory", help="Disable memory"),
-    tools: Optional[str] = typer.Option(None, "--tools", "-t", help="Tools file path"),
+    tools: Optional[str] = typer.Option(None, "--tools", "-t", help="Comma-separated tool names (e.g. web_search,github) or a tools.py file path"),
     toolset: Optional[str] = typer.Option(None, "--toolset", help="Named toolset groups (comma-separated, e.g., web,files)"),
     user_id: Optional[str] = typer.Option(None, "--user-id", help="User ID for memory isolation"),
     session_id: Optional[str] = typer.Option(None, "--session", "-s", help="Session ID to resume"),

{praisonai_code-0.0.28 → praisonai_code-0.0.30}/praisonai_code/cli/commands/code.py

@@ -18,7 +18,7 @@ def code_main(
     prompt: Optional[str] = typer.Argument(None, help="Code task or question"),
     model: Optional[str] = typer.Option(None, "--model", "-m", help="LLM model to use"),
     verbose: bool = typer.Option(False, "--verbose", "-v", help="Verbose output"),
-    tools: Optional[str] = typer.Option(None, "--tools", "-t", help="Tools file path"),
+    tools: Optional[str] = typer.Option(None, "--tools", "-t", help="Comma-separated tool names (e.g. web_search,github) or a tools.py file path"),
     workspace: Optional[str] = typer.Option(None, "--workspace", "-w", help="Workspace directory"),
     file: Optional[List[str]] = typer.Option(None, "--file", "-f", help="Attach file(s) to context"),
     no_acp: bool = typer.Option(False, "--no-acp", help="Disable ACP tools (file operations)"),

{praisonai_code-0.0.28 → praisonai_code-0.0.30}/praisonai_code/cli/commands/run.py

@@ -252,6 +252,68 @@ def _build_mcp_tools(
     return tools
 
 
+def _resolve_tools_arg(value: Optional[str], verbose: bool = False) -> list:
+    """Resolve a ``--tools`` value into a list of tool callables.
+
+    ``value`` may be a comma-separated list of tool *names* (resolved by name
+    through :class:`ToolResolver`, so CLI == YAML == Python), a path to a
+    ``tools.py`` file, or a mix of both. Items ending in ``.py`` or that exist
+    on disk are loaded as files; everything else is resolved by name.
+
+    Returns an empty list when ``value`` is falsy so callers can unconditionally
+    extend an agent's tool list.
+    """
+    import os as _os
+
+    if not value:
+        return []
+
+    from praisonai_code.tool_resolver import ToolResolver
+    resolver = ToolResolver()
+    resolved: list = []
+    for item in (v.strip() for v in value.split(",")):
+        if not item:
+            continue
+        if item.endswith(".py") or _os.path.exists(item):
+            module_fns = resolver.load_functions_from_module(item)
+            if module_fns:
+                resolved.extend(module_fns.values())
+            elif not _os.path.exists(item):
+                # A .py name that isn't on disk: fall through to name resolution.
+                # Strip the .py suffix so "internet_search.py" resolves as the
+                # named tool "internet_search" instead of missing outright.
+                name_only = item[:-3] if item.endswith(".py") else item
+                tool = resolver.resolve(name_only, instantiate=True)
+                if tool is not None:
+                    resolved.append(tool)
+                else:
+                    from ..output import get_output_controller
+                    get_output_controller().print_info(
+                        f"Unknown tool '{item}'. Run 'praisonai tools list' to see available tools."
+                    )
+            else:
+                # tools.py present on disk but produced no callables.
+                from ..output import get_output_controller
+                if not _os.environ.get("PRAISONAI_ALLOW_LOCAL_TOOLS"):
+                    get_output_controller().print_info(
+                        f"Skipped '{item}': set PRAISONAI_ALLOW_LOCAL_TOOLS=true to load local tools."
+                    )
+                else:
+                    get_output_controller().print_info(
+                        f"No callable tools found in '{item}'."
+                    )
+        else:
+            tool = resolver.resolve(item, instantiate=True)
+            if tool is not None:
+                resolved.append(tool)
+            else:
+                from ..output import get_output_controller
+                get_output_controller().print_info(
+                    f"Unknown tool '{item}'. Run 'praisonai tools list' to see available tools."
+                )
+    return resolved
+
+
 def _permissions_from_config(config) -> Optional[dict]:
     """Convert a resolved ``permissions`` config section to a pattern->action dict.
 
@@ -510,7 +572,7 @@ def run_main(
     stream: bool = typer.Option(False, "--stream/--no-stream", help="Stream output (default: off for production use)"),
     trace: bool = typer.Option(False, "--trace", help="Enable tracing"),
     memory: bool = typer.Option(False, "--memory", help="Enable memory"),
-    tools: Optional[str] = typer.Option(None, "--tools", "-t", help="Tools file path"),
+    tools: Optional[str] = typer.Option(None, "--tools", "-t", help="Comma-separated tool names (e.g. web_search,github) or a tools.py file path"),
     toolset: Optional[str] = typer.Option(None, "--toolset", help="Named toolset groups (comma-separated, e.g., web,files)"),
     max_tokens: int = typer.Option(16000, "--max-tokens", help="Maximum output tokens"),
     profile: bool = typer.Option(False, "--profile", help="Enable CLI profiling (timing breakdown)"),
@@ -1143,6 +1205,17 @@ def _run_prompt(
                 if mcp_tools:
                     agent_config["tools"] = list(agent_config.get("tools", [])) + mcp_tools
 
+            # Wire --tools (names or file) and --toolset so actions mode reaches
+            # parity with the default/YAML/Python surfaces (previously dropped).
+            selected_tools = _resolve_tools_arg(tools, verbose=verbose)
+            if toolset:
+                from praisonai_code.tool_resolver import resolve_toolsets as _resolve_toolsets
+                toolset_names = [t.strip() for t in toolset.split(",") if t.strip()]
+                if toolset_names:
+                    selected_tools.extend(_resolve_toolsets(toolset_names))
+            if selected_tools:
+                agent_config["tools"] = list(agent_config.get("tools", [])) + selected_tools
+
             agent = Agent(**agent_config)
             # Reasoning effort applied via the property setter (not a
             # constructor kwarg) so defaults are unchanged when omitted.

{praisonai_code-0.0.28 → praisonai_code-0.0.30}/praisonai_code/cli/commands/setup.py

@@ -14,9 +14,6 @@ from ..output.console import get_output_controller
 
 app = typer.Typer(help="Interactive onboarding / configuration wizard")
 
-# Source the OpenAI default from the single source of truth so setup never
-# re-declares the terminal fallback literal.
-from praisonai_code.llm.env import DEFAULT_FALLBACK_MODEL as _OPENAI_DEFAULT_MODEL
 
 # Default PRAISON_HOME directory
 def get_praison_home() -> Path:
@@ -29,22 +26,9 @@ def get_praison_home() -> Path:
 PRAISON_HOME = get_praison_home()
 ENV_FILE = PRAISON_HOME / ".env"
 
-# Provider configurations
-PROVIDERS = {
-    "1": ("openai",    "OPENAI_API_KEY",    _OPENAI_DEFAULT_MODEL),
-    "2": ("anthropic", "ANTHROPIC_API_KEY", "claude-3-5-sonnet-latest"),
-    "3": ("google",    "GEMINI_API_KEY",    "gemini-2.0-flash"),
-    "4": ("ollama",    None,                "llama3.2"),
-    "5": ("custom",    None,                None),
-}
-
-PROVIDER_NAMES = {
-    "openai": ("OpenAI", "OPENAI_API_KEY", _OPENAI_DEFAULT_MODEL),
-    "anthropic": ("Anthropic", "ANTHROPIC_API_KEY", "claude-3-5-sonnet-latest"),
-    "google": ("Google", "GEMINI_API_KEY", "gemini-2.0-flash"),
-    "ollama": ("Ollama", None, "llama3.2"),
-    "custom": ("Custom", None, None),
-}
+# Provider configurations (names, env-vars, and refreshed default models) live
+# in a single source of truth: SetupHandler._provider_defaults(). Do not
+# re-declare them here.
 
 
 def _run_setup(
@@ -52,6 +36,7 @@ def _run_setup(
     provider: Optional[str] = None,
     api_key: Optional[str] = None,
     model: Optional[str] = None,
+    verify: bool = True,
 ) -> int:
     """Run the setup wizard."""
     try:
@@ -61,7 +46,8 @@ def _run_setup(
             non_interactive=non_interactive,
             provider=provider,
             api_key=api_key,
-            model=model
+            model=model,
+            verify=verify,
         )
     except ImportError as e:
         output = get_output_controller()
@@ -80,6 +66,7 @@ def setup_callback(
     provider: Optional[str] = typer.Option(None, "--provider", help="LLM provider (openai, anthropic, google, ollama, custom)"),
     api_key: Optional[str] = typer.Option(None, "--api-key", help="API key for the provider"),
     model: Optional[str] = typer.Option(None, "--model", help="Default model to use"),
+    no_verify: bool = typer.Option(False, "--no-verify", help="Skip the post-setup smoke test (offline/CI)"),
 ):
     """Run the onboarding wizard (idempotent — safe to re-run)."""
     if ctx.invoked_subcommand:
@@ -89,7 +76,8 @@ def setup_callback(
         non_interactive=non_interactive,
         provider=provider,
         api_key=api_key,
-        model=model
+        model=model,
+        verify=not no_verify,
     )
     raise typer.Exit(exit_code)
 
@@ -99,13 +87,15 @@ def setup_wizard(
     provider: Optional[str] = typer.Option(None, "--provider", help="LLM provider"),
     api_key: Optional[str] = typer.Option(None, "--api-key", help="API key"),
     model: Optional[str] = typer.Option(None, "--model", help="Default model"),
+    no_verify: bool = typer.Option(False, "--no-verify", help="Skip the post-setup smoke test (offline/CI)"),
 ):
     """Run the interactive setup wizard."""
     exit_code = _run_setup(
         non_interactive=False,
         provider=provider,
         api_key=api_key,
-        model=model
+        model=model,
+        verify=not no_verify,
     )
     raise typer.Exit(exit_code)
 

{praisonai_code-0.0.28 → praisonai_code-0.0.30}/praisonai_code/cli/commands/tools.py

@@ -11,6 +11,7 @@ from typing import Optional
 
 import typer
 from rich.console import Console
+from rich.markup import escape
 from rich.table import Table
 
 app = typer.Typer(help="Tool management and discovery")
@@ -92,6 +93,51 @@ def tools_list(
         console.print(f"[dim]  Built-in: {len(builtin_tools)} | Local: {len(local_tools)} | External: {len(external_tools)} | Registered: {len(registered_tools)}[/dim]")
 
 
+@app.command("search")
+def tools_search(
+    query: str = typer.Argument(..., help="Substring to search tool names for"),
+    verbose: bool = typer.Option(False, "--verbose", "-v", help="Show detailed info"),
+):
+    """Search available tools by name substring (case-insensitive).
+
+    Enumerates the same catalogue as 'tools list' (built-in, local, external,
+    registered/entry-point) and filters to names containing the query.
+    """
+    from praisonai_code.tool_resolver import ToolResolver
+
+    resolver = ToolResolver()
+    available = resolver.list_available()
+    sources = resolver.list_available_sources()
+
+    needle = query.strip().lower()
+    matches = {
+        name: desc for name, desc in available.items() if needle in name.lower()
+    }
+
+    safe_query = escape(query)
+    if not matches:
+        console.print(f"[yellow]No tools matching '{safe_query}'.[/yellow]")
+        console.print("[dim]Run 'praisonai tools list' to see all available tools.[/dim]")
+        return
+
+    table = Table(title=f"Tools matching '{safe_query}'", show_header=True, header_style="bold cyan")
+    table.add_column("Tool Name", style="green")
+    table.add_column("Source", style="blue")
+    if verbose:
+        table.add_column("Description", style="dim")
+
+    for name in sorted(matches.keys()):
+        desc = matches[name]
+        src = sources.get(name, "builtin")
+        if verbose:
+            table.add_row(name, src, desc[:60] + "..." if len(desc) > 60 else desc)
+        else:
+            table.add_row(name, src)
+
+    console.print(table)
+    console.print(f"\n[dim]Total: {len(matches)} match(es)[/dim]")
+
+
 @app.command("validate")
 def tools_validate(
     yaml_file: str = typer.Argument("agents.yaml", help="YAML file to validate"),