praisonai-code 0.0.1__tar.gz

praisonai_code-0.0.1/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: praisonai-code
+Version: 0.0.1
+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
+Project-URL: Homepage, https://docs.praison.ai
+Project-URL: Repository, https://github.com/mervinpraison/PraisonAI
+Requires-Python: <3.15,>=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: praisonaiagents>=1.6.101
+Requires-Dist: rich>=13.7
+Requires-Dist: typer>=0.12.0
+Requires-Dist: click>=8.4.2
+Requires-Dist: textual>=0.47.0
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: python-dotenv>=0.19.0
+Requires-Dist: litellm<2,>=1.83.14
+Requires-Dist: mcp>=1.20.0
+Requires-Dist: pydantic>=2.0.0
+
+# praisonai-code
+
+Agentic terminal CLI for PraisonAI — the terminal-native agent product
+(`run`, `chat`, `code`, warm runtime, CLI backends) extracted from the
+`praisonai` wrapper.
+
+**Analogues:** opencode, codex, gemini-cli.
+
+## Status
+
+Migration in progress. `runtime/` and `cli_backends/` have moved into
+`praisonai_code` (step C1); the remaining terminal-agent modules follow
+incrementally in steps C2–C6 (see issue #2512):
+
+| Step | Scope |
+|------|-------|
+| C0 | Scaffold |
+| C1 | `runtime/` + `cli_backends/` |
+| C2 | `interactive/`, `execution/`, `ui/`, `output/`, `state/` |
+| C3 | Agentic commands |
+| C4 | Agentic features |
+| C5 | `main.py`, `app.py`, config/session/utils + shims |
+| C6 | Integration gate |
+
+- `praisonai_code.runtime` — warm local runtime (daemon + thin client).
+- `praisonai_code.cli_backends` — CLI backend implementations (e.g. Claude Code).
+
+## Dependency rules
+
+```
+praisonai (main)  →  depends on  praisonai-code
+praisonai-code    →  depends on  praisonaiagents (core SDK)
+```
+
+`praisonai-code` also pulls in its own third-party runtime deps (rich, typer,
+click, textual, PyYAML, python-dotenv, litellm, mcp, pydantic — see
+`pyproject.toml`). The rules above govern the **inter-package** direction.
+
+> **Migration note (C1):** `cli_backends/registry.py` still imports
+> `PluginRegistry` from the `praisonai` main package (same "keep main-package
+> import" pattern as `runtime/descriptor.py`'s `from praisonai.version`).
+> `praisonai-code` is wired via an editable path dependency and `praisonai` is
+> always present at runtime during migration, so this residual back-import is a
+> deliberate C1 tradeoff to be removed in a later step — not a standalone-publish
+> guarantee yet.
+
+Backward compatibility is preserved via PEP 562 shims at the old
+`praisonai.*` import paths, so `pip install praisonai` and
+`from praisonai.cli.main import PraisonAI` keep working unchanged.
+
+## Install (development)
+
+```bash
+pip install -e src/praisonai-code
+python -c "import praisonai_code; print(praisonai_code.__version__)"
+```
+
+`praisonai-code` is **not** published standalone to PyPI during migration;
+`praisonai` remains the user-facing install.

praisonai_code-0.0.1/README.md

@@ -0,0 +1,59 @@
+# praisonai-code
+
+Agentic terminal CLI for PraisonAI — the terminal-native agent product
+(`run`, `chat`, `code`, warm runtime, CLI backends) extracted from the
+`praisonai` wrapper.
+
+**Analogues:** opencode, codex, gemini-cli.
+
+## Status
+
+Migration in progress. `runtime/` and `cli_backends/` have moved into
+`praisonai_code` (step C1); the remaining terminal-agent modules follow
+incrementally in steps C2–C6 (see issue #2512):
+
+| Step | Scope |
+|------|-------|
+| C0 | Scaffold |
+| C1 | `runtime/` + `cli_backends/` |
+| C2 | `interactive/`, `execution/`, `ui/`, `output/`, `state/` |
+| C3 | Agentic commands |
+| C4 | Agentic features |
+| C5 | `main.py`, `app.py`, config/session/utils + shims |
+| C6 | Integration gate |
+
+- `praisonai_code.runtime` — warm local runtime (daemon + thin client).
+- `praisonai_code.cli_backends` — CLI backend implementations (e.g. Claude Code).
+
+## Dependency rules
+
+```
+praisonai (main)  →  depends on  praisonai-code
+praisonai-code    →  depends on  praisonaiagents (core SDK)
+```
+
+`praisonai-code` also pulls in its own third-party runtime deps (rich, typer,
+click, textual, PyYAML, python-dotenv, litellm, mcp, pydantic — see
+`pyproject.toml`). The rules above govern the **inter-package** direction.
+
+> **Migration note (C1):** `cli_backends/registry.py` still imports
+> `PluginRegistry` from the `praisonai` main package (same "keep main-package
+> import" pattern as `runtime/descriptor.py`'s `from praisonai.version`).
+> `praisonai-code` is wired via an editable path dependency and `praisonai` is
+> always present at runtime during migration, so this residual back-import is a
+> deliberate C1 tradeoff to be removed in a later step — not a standalone-publish
+> guarantee yet.
+
+Backward compatibility is preserved via PEP 562 shims at the old
+`praisonai.*` import paths, so `pip install praisonai` and
+`from praisonai.cli.main import PraisonAI` keep working unchanged.
+
+## Install (development)
+
+```bash
+pip install -e src/praisonai-code
+python -c "import praisonai_code; print(praisonai_code.__version__)"
+```
+
+`praisonai-code` is **not** published standalone to PyPI during migration;
+`praisonai` remains the user-facing install.

praisonai_code-0.0.1/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-0.0.1/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-0.0.1/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-0.0.1/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-0.0.1/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