pari-cli 0.1.2__tar.gz → 0.1.4__tar.gz

pari_cli-0.1.4/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.4
+Name: pari-cli
+Version: 0.1.4
+Summary: A resilient, sandbox-first terminal coding agent engineered for high pass rates and low token burn.
+Author: PARI Contributors
+License: MIT
+Project-URL: Homepage, https://pari-cli.in
+Project-URL: Documentation, https://pari-cli.in
+Project-URL: Repository, https://github.com/MdTanwer/pari
+Keywords: ai,coding-agent,terminal,llm,developer-tools
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich>=13.0.0
+Requires-Dist: prompt_toolkit>=3.0.36
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: httpx>=0.24.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: ruff>=0.12.10; extra == "dev"
+Requires-Dist: pre-commit>=4.3.0; extra == "dev"
+Requires-Dist: pycodestyle>=2.12.0; extra == "dev"
+Provides-Extra: ast
+Requires-Dist: tree-sitter>=0.21.0; extra == "ast"
+Requires-Dist: tree-sitter-languages>=1.10.0; extra == "ast"
+Requires-Dist: networkx>=3.0; extra == "ast"
+Requires-Dist: grep-ast>=0.3.0; extra == "ast"
+Provides-Extra: cloud
+Requires-Dist: e2b>=0.14.0; extra == "cloud"
+Provides-Extra: all
+Requires-Dist: pari-cli[ast,cloud,dev]; extra == "all"
+Dynamic: license-file
+
+# PARI — Next-Generation Terminal Coding Agent
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![Architecture: 11-Layer Stack](https://img.shields.io/badge/architecture-11--layer-green.svg)](docs/architecture/overview.md)
+[![Security: Kernel Sandboxed](https://img.shields.io/badge/sandbox-bwrap%20%7C%20Seatbelt%20%7C%20E2B-orange.svg)](docs/layers/layer-0-sandboxing.md)
+
+---
+
+## ⚡ The Core Thesis
+
+$$\text{\bf Agent failure is a systems engineering failure, not a reasoning failure.}$$
+
+The exact same frontier reasoning model (Claude 3.7 Sonnet, GPT-4o) demonstrates a **15% pass rate** in a naive loop, but achieves a **50–55% pass rate** inside an engineered harness. The 35% delta is not model intelligence; it is accounted for by **six fatal systems failure modes**:
+
+1. **Unbounded stdout poisoning** $\rightarrow$ Solved by Layer 7 (50KB/2k-line disk spooler + balanced head/tail extraction).
+2. **Mid-stream token truncation** $\rightarrow$ Solved by Layer 4 (Strict `stop_reason == "length"` rejection guard).
+3. **File write race conditions** $\rightarrow$ Solved by Layer 6 (`FileMutationQueue` canonical realpath serialization).
+4. **KV cache invalidation cascades** $\rightarrow$ Solved by Layer 2 (Immutable Baseline Epochs freezing Tiers 1–4).
+5. **Blind file traversal loops** $\rightarrow$ Solved by Layer 3 (v1: Fast substring ripgrep & globbing / v2: Tree-sitter AST fallback).
+6. **Unsandboxed host execution** $\rightarrow$ Solved by Layer 0 (Multi-platform kernel isolation: `bwrap`, `Seatbelt`, E2B MicroVMs).
+
+---
+
+## 🚀 Installation & Quick Start
+
+Official Website & Documentation: **[https://pari-cli.in](https://pari-cli.in)**
+
+Choose your platform's installation command:
+
+### 1. macOS & Linux (`curl`)
+```bash
+curl -fsSL https://pari-cli.in/install.sh | bash
+```
+
+### 2. Windows (`irm` in PowerShell)
+```powershell
+irm https://www.pari-cli.in/install.ps1 | iex
+```
+
+### 3. Via `pip` / `pipx` / `uv`
+```bash
+# Recommended (isolated CLI)
+pipx install pari-cli
+
+# Fast via uv
+uv tool install pari-cli
+
+# Standard pip
+pip install pari-cli
+```
+
+---
+
+### 💻 Launch Interactive Session
+```bash
+# Export your API key
+export ANTHROPIC_API_KEY="sk-ant-..."
+
+# Launch PARI anywhere in your project workspace
+pari-cli
+```
+
+---
+
+## ⚖️ License
+
+MIT License. See [LICENSE](LICENSE) for details.

pari_cli-0.1.4/README.md

@@ -0,0 +1,68 @@
+# PARI — Next-Generation Terminal Coding Agent
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![Architecture: 11-Layer Stack](https://img.shields.io/badge/architecture-11--layer-green.svg)](docs/architecture/overview.md)
+[![Security: Kernel Sandboxed](https://img.shields.io/badge/sandbox-bwrap%20%7C%20Seatbelt%20%7C%20E2B-orange.svg)](docs/layers/layer-0-sandboxing.md)
+
+---
+
+## ⚡ The Core Thesis
+
+$$\text{\bf Agent failure is a systems engineering failure, not a reasoning failure.}$$
+
+The exact same frontier reasoning model (Claude 3.7 Sonnet, GPT-4o) demonstrates a **15% pass rate** in a naive loop, but achieves a **50–55% pass rate** inside an engineered harness. The 35% delta is not model intelligence; it is accounted for by **six fatal systems failure modes**:
+
+1. **Unbounded stdout poisoning** $\rightarrow$ Solved by Layer 7 (50KB/2k-line disk spooler + balanced head/tail extraction).
+2. **Mid-stream token truncation** $\rightarrow$ Solved by Layer 4 (Strict `stop_reason == "length"` rejection guard).
+3. **File write race conditions** $\rightarrow$ Solved by Layer 6 (`FileMutationQueue` canonical realpath serialization).
+4. **KV cache invalidation cascades** $\rightarrow$ Solved by Layer 2 (Immutable Baseline Epochs freezing Tiers 1–4).
+5. **Blind file traversal loops** $\rightarrow$ Solved by Layer 3 (v1: Fast substring ripgrep & globbing / v2: Tree-sitter AST fallback).
+6. **Unsandboxed host execution** $\rightarrow$ Solved by Layer 0 (Multi-platform kernel isolation: `bwrap`, `Seatbelt`, E2B MicroVMs).
+
+---
+
+## 🚀 Installation & Quick Start
+
+Official Website & Documentation: **[https://pari-cli.in](https://pari-cli.in)**
+
+Choose your platform's installation command:
+
+### 1. macOS & Linux (`curl`)
+```bash
+curl -fsSL https://pari-cli.in/install.sh | bash
+```
+
+### 2. Windows (`irm` in PowerShell)
+```powershell
+irm https://www.pari-cli.in/install.ps1 | iex
+```
+
+### 3. Via `pip` / `pipx` / `uv`
+```bash
+# Recommended (isolated CLI)
+pipx install pari-cli
+
+# Fast via uv
+uv tool install pari-cli
+
+# Standard pip
+pip install pari-cli
+```
+
+---
+
+### 💻 Launch Interactive Session
+```bash
+# Export your API key
+export ANTHROPIC_API_KEY="sk-ant-..."
+
+# Launch PARI anywhere in your project workspace
+pari-cli
+```
+
+---
+
+## ⚖️ License
+
+MIT License. See [LICENSE](LICENSE) for details.

{pari_cli-0.1.2 → pari_cli-0.1.4}/pari/__init__.py

@@ -1,5 +1,3 @@
 """PARI — High-performance terminal coding agent."""
 
-__version__ = "0.1.2"
-
-
+__version__ = "0.1.4"

{pari_cli-0.1.2 → pari_cli-0.1.4}/pari/__main__.py

@@ -6,7 +6,9 @@ Allows running PARI via:
 """
 
 import sys
+
 from pari.cli import main
 
+
 if __name__ == "__main__":
     sys.exit(main())

pari_cli-0.1.4/pari/agent/__init__.py

@@ -0,0 +1,43 @@
+"""PARI Layer 4: The Execution Loop (Agent Runtime).
+
+Architectural Purpose:
+    Implements the double-while execution loop with stop_reason == "length" truncation
+    guard,
+    bounded reflection retry limits, and lightweight asyncio fiber-based subagents.
+
+Subsystems:
+    - loop: Core double-while agent loop with continuation handling
+    - runtime: Turn execution, tool orchestration, and state transitions
+    - reflection: Structured error injection with max 3 reflection retries
+    - subagent: Fiber-based read-only research subagents (closing Pi F2 RAM bloat)
+"""
+
+from pari.agent.guards import (
+    DAEMON_IDLE_SECONDS,
+    LENGTH_TRUNCATION_NOTICE,
+    MAX_TURNS,
+    TURN_WARNING,
+    format_daemon_notice,
+    is_length_stop,
+)
+from pari.agent.loop import AgentExecutionLoop, TurnResult
+from pari.agent.reflection import ReflectionManager, format_lint_error
+from pari.agent.runtime import AgentRuntime
+from pari.agent.subagent import FiberSubagentPool, SubagentTask
+
+
+__all__ = [
+    "DAEMON_IDLE_SECONDS",
+    "LENGTH_TRUNCATION_NOTICE",
+    "MAX_TURNS",
+    "TURN_WARNING",
+    "AgentExecutionLoop",
+    "AgentRuntime",
+    "FiberSubagentPool",
+    "ReflectionManager",
+    "SubagentTask",
+    "TurnResult",
+    "format_daemon_notice",
+    "format_lint_error",
+    "is_length_stop",
+]

pari_cli-0.1.4/pari/agent/guards.py

@@ -0,0 +1,35 @@
+"""Constants and checks the execution loop applies before it runs a tool.
+
+The loop itself decides when to stop. These values are the limits it checks.
+"""
+
+MAX_TURNS = 40
+TURN_WARNING = 30
+TURN_EXTENSION = 10
+DAEMON_IDLE_SECONDS = 10
+TURN_LIMIT_PROMPT = "[Turn limit reached. Continue (+10 turns) | Revert | Stop]?"
+
+# Shown when stop_reason is "length". The loop must drop the pending tool
+# calls before it appends this notice. A truncated edit must not touch disk.
+LENGTH_TRUNCATION_NOTICE = (
+    "WARNING: Your previous tool call was truncated due to the "
+    "output token ceiling. No changes were written to disk. "
+    "Please break your modification into smaller, focused "
+    "search/replace blocks of <= 100 lines."
+)
+
+
+def is_length_stop(stop_reason: str | None) -> bool:
+    """True when the model hit max_tokens and the tool payload may be cut off."""
+    return stop_reason == "length"
+
+
+def format_daemon_notice(command: str, idle_seconds: int = DAEMON_IDLE_SECONDS) -> str:
+    """Notice for a command that kept streaming past the idle window."""
+    shown = command.strip() or "command"
+    return (
+        f"[DAEMON DETECTED]: Command '{shown}' did not exit after "
+        f"{idle_seconds}s. Process was backgrounded. "
+        "Stdout snapshot spooled to disk. "
+        "To manage background daemons, use background task APIs."
+    )

pari_cli-0.1.4/pari/agent/lint.py

@@ -0,0 +1,49 @@
+"""Syntax check for a file the loop just wrote.
+
+The check uses the standard library parser. It returns a short window around
+the failing line so the next model turn does not receive a compiler log.
+"""
+
+import ast
+
+from pari.agent.reflection import format_lint_error
+
+
+def lint_python(path: str, source: str) -> str | None:
+    """Return a lint block when path is Python and source does not parse."""
+    if not path.endswith(".py"):
+        return None
+    try:
+        ast.parse(source)
+    except SyntaxError as exc:
+        line = exc.lineno or 1
+        return format_lint_error(
+            path,
+            line,
+            _enclosing(source, line),
+            _window(source, line, exc.msg),
+        )
+    return None
+
+
+def _enclosing(source: str, line: int) -> str:
+    rows = source.splitlines()
+    last = min(line, len(rows)) - 1
+    for index in range(last, -1, -1):
+        stripped = rows[index].lstrip()
+        if stripped.startswith(("def ", "async def ", "class ")):
+            return stripped
+    return "<module>"
+
+
+def _window(source: str, line: int, message: str) -> str:
+    rows = source.splitlines()
+    start = max(line - 5, 1)
+    end = min(line + 5, len(rows))
+    shown: list[str] = []
+    for number in range(start, end + 1):
+        text = rows[number - 1] if number <= len(rows) else ""
+        if number == line:
+            text = f"{text}  # {message}"
+        shown.append(f"{number}: {text}")
+    return "\n".join(shown)