praisonai-code 0.0.1__py3-none-any.whl

praisonai_code/__init__.py

@@ -0,0 +1,17 @@
+"""praisonai-code — agentic terminal CLI for PraisonAI.
+
+This package hosts the terminal-native agent product (``run``, ``chat``,
+``code``, warm runtime, CLI backends) extracted from the ``praisonai``
+wrapper. It depends on ``praisonaiagents`` only — never on ``praisonai`` —
+to avoid a PyPI dependency cycle.
+
+Migration in progress: ``runtime/`` and ``cli_backends/`` have moved here
+(step C1), and the ``interactive``/``execution``/``ui``/``output``/``state``
+CLI sub-packages have moved here (step C2). Subsequent steps (C3–C6) migrate
+the remaining terminal-agent modules, with PEP 562 shims left behind at the
+old ``praisonai.*`` paths for backward compatibility.
+"""
+
+__version__ = "0.0.0"
+
+__all__ = ["__version__"]

praisonai_code/cli/__init__.py

@@ -0,0 +1,12 @@
+"""praisonai_code.cli: terminal agent CLI package.
+
+Sub-packages are moved here incrementally (see parent migration issue). During
+the migration, old import paths under ``praisonai.cli`` remain valid through
+shims in the main package, and not-yet-moved siblings (``configuration``,
+``utils``, ``session``, ``features``) are forwarded back to ``praisonai.cli``
+via a temporary meta-path shim.
+"""
+
+from ._forward_shim import install as _install_forward_shim
+
+_install_forward_shim()

praisonai_code/cli/_forward_shim.py

@@ -0,0 +1,10 @@
+"""Temporary forward shims removed in C5 — configuration, session, and utils
+now live in ``praisonai_code.cli``. Bot-channel feature modules remain under
+``praisonai.cli.features`` and are reached via that package's ``__path__`` extension.
+"""
+
+from __future__ import annotations
+
+
+def install() -> None:
+    """No-op — forward shims no longer required after C5."""

praisonai_code/cli/_paths.py

@@ -0,0 +1,88 @@
+"""Canonical filesystem paths for PraisonAI user state.
+
+Mirrors the conventions used by ``hermes-agent`` (``~/.hermes``) and
+``openclaw`` (``~/.openclaw``): one user-home directory per tool, with
+configurable overrides via environment variables, so ``bot.yaml`` and
+``.env`` don't pollute whatever working directory the user happened to
+run ``praisonai onboard`` from.
+
+Layout::
+
+    ~/.praisonai/
+    ├── .env              # secrets (chmod 600) — managed by onboard
+    ├── bot.yaml          # default bot / gateway config
+    └── logs/             # daemon stdout / stderr (created by launchd helper)
+
+Overrides (first match wins for each key):
+
+* ``PRAISONAI_HOME``        — full path for the directory (e.g. Nix store)
+* ``PRAISONAI_ENV_FILE``    — full path for the ``.env`` file
+* ``PRAISONAI_BOT_CONFIG``  — full path for the default ``bot.yaml``
+"""
+
+from __future__ import annotations
+
+import os
+from pathlib import Path
+
+__all__ = [
+    "praison_home",
+    "default_env_file",
+    "default_bot_config_path",
+    "resolve_bot_config_path",
+]
+
+
+def praison_home() -> Path:
+    """Return the canonical PraisonAI home directory.
+
+    Honours ``PRAISONAI_HOME`` so packaging systems (Nix, Docker) can
+    relocate state. Defaults to ``~/.praisonai``.
+    """
+    override = os.environ.get("PRAISONAI_HOME")
+    return Path(override).expanduser() if override else Path.home() / ".praisonai"
+
+
+def default_env_file() -> Path:
+    """Return the path to the canonical ``.env`` file."""
+    override = os.environ.get("PRAISONAI_ENV_FILE")
+    return Path(override).expanduser() if override else praison_home() / ".env"
+
+
+def default_bot_config_path() -> Path:
+    """Return the path where ``praisonai onboard`` writes ``bot.yaml``.
+
+    Users can force a custom path with ``PRAISONAI_BOT_CONFIG``.
+    """
+    override = os.environ.get("PRAISONAI_BOT_CONFIG")
+    return Path(override).expanduser() if override else praison_home() / "bot.yaml"
+
+
+def resolve_bot_config_path(cli_value: str = "bot.yaml") -> str:
+    """Resolve the bot config path for CLI commands with sensible fallback.
+
+    Precedence:
+
+    1. ``cli_value`` if it is not the sentinel ``"bot.yaml"`` (i.e. user
+       passed an explicit ``--config X``).
+    2. ``./bot.yaml`` if it exists in the current working directory
+       (back-compat for projects that already keep bot.yaml checked in).
+    3. ``~/.praisonai/bot.yaml`` (or ``PRAISONAI_BOT_CONFIG``) — the
+       canonical location written by ``praisonai onboard``.
+    4. Fall back to ``cli_value`` unchanged so existing error messages
+       ("config not found at bot.yaml") keep working.
+    """
+    # (1) explicit override from the caller
+    if cli_value and cli_value != "bot.yaml":
+        return cli_value
+    # (2) honour an existing cwd file (back-compat)
+    cwd_path = Path.cwd() / "bot.yaml"
+    if cwd_path.is_file():
+        return str(cwd_path)
+    # (3) canonical home location
+    home_path = default_bot_config_path()
+    if home_path.is_file():
+        return str(home_path)
+    # (4) give up — return the caller's value so their own error handling
+    # surfaces a useful "not found" message.
+    return cli_value

praisonai_code/cli/_warnings.py

@@ -0,0 +1,58 @@
+# praisonai/cli/_warnings.py
+"""Lightweight warning filter support for CLI usage.
+
+This module contains self-contained warning filter functions that were
+previously in cli/main.py. Extracted to avoid importing the heavy 7000-line
+main.py module (with its yaml/rich/dotenv dependencies) just to set up
+warning filters.
+"""
+
+import warnings
+import atexit
+
+_SUPPRESSED_PATTERNS = (
+    "Pydantic serializer warnings",
+    "PydanticSerializationUnexpectedValue",
+    "Expected ",  # Narrowed from just "Expected" to avoid false positives
+    "StreamingChoices",
+    "serialized value may not be as expected",
+    "duckduckgo_search",
+)
+
+_installed = False
+_original_showwarning = None
+_original_filters = None
+
+def install_warning_filters() -> None:
+    """Install PraisonAI's noise filters. Idempotent. CLI-only."""
+    global _installed, _original_showwarning, _original_filters
+    if _installed:
+        return
+    _original_showwarning = warnings.showwarning
+    _original_filters = list(warnings.filters)
+
+    # Install filterwarnings for common patterns
+    for pattern in _SUPPRESSED_PATTERNS:
+        warnings.filterwarnings("ignore", message=f".*{pattern}.*")
+    warnings.filterwarnings("ignore", category=UserWarning, module="pydantic.*")
+
+    def _filtered_showwarning(message, category, filename, lineno, file=None, line=None):
+        msg_str = str(message)
+        if any(pattern in msg_str for pattern in _SUPPRESSED_PATTERNS):
+            return
+        if category is UserWarning and "pydantic" in filename.lower():
+            return
+        _original_showwarning(message, category, filename, lineno, file, line)
+
+    warnings.showwarning = _filtered_showwarning
+    atexit.register(_uninstall_warning_filters)
+    _installed = True
+
+def _uninstall_warning_filters() -> None:
+    """Restore original warnings behavior on exit."""
+    global _installed, _original_filters, _original_showwarning
+    if _installed and _original_showwarning is not None:
+        warnings.showwarning = _original_showwarning
+        if _original_filters is not None:
+            warnings.filters[:] = _original_filters
+        _installed = False