alpiecode 0.9.8__tar.gz → 1.0.0__tar.gz

{alpiecode-0.9.8 → alpiecode-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alpiecode
-Version: 0.9.8
+Version: 1.0.0
 Summary: AlpieCode — Autonomous AI Coding Agent CLI powered by local 169Pi GGUF VLM
 Requires-Python: >=3.9
 Requires-Dist: huggingface_hub>=0.20.0

alpiecode-1.0.0/README.md

@@ -0,0 +1,96 @@
+# 🤖 AlpieCode
+
+> **Autonomous AI Software Engineering Agent** powered by 169Pi. Operates locally on your device (CPU/GPU) with zero internet, or connects to high-speed cloud VLM endpoints. Integrates seamlessly into **CLI**, **REST/SSE API**, and **VS Code IDE**.
+
+```
+    _    _     _      ____            _      
+   / \  | |_ _| | ___ / ___|___   __| | ___ 
+  / _ \ | | '_ \ |/ _ \ |   / _ \ / _` |/ _  / ___ \| | |_) | |  __/ |__| (_) | (_| |  __/
+/_/   \_\_|_.__/|_|\___|\____\___/ \__,_|\___|
+```
+
+[![Python Version](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![FastAPI](https://img.shields.io/badge/FastAPI-0.100%2B-green.svg)](https://fastapi.tiangolo.com)
+[![VS Code Extension](https://img.shields.io/badge/VS%20Code-Extension-blue.svg)](./vscode)
+
+---
+
+## ⚡ Quick Start
+
+### 1. Installation
+```bash
+pip install --upgrade alpiecode
+```
+*Or install from source with uv:*
+```bash
+git clone https://github.com/169pi/codeagent-poc.git
+cd codeagent-poc
+uv venv && source .venv/bin/activate
+uv pip install -e .
+```
+
+### 2. Run Autonomous Coding Tasks (CLI)
+```bash
+# Direct task execution
+alpiecode run "Create a FastAPI REST API for a todo app with full test coverage"
+
+# Dry-run planning (read-only)
+alpiecode plan "Refactor database connection to async SQLModel"
+
+# Multimodal UI generation from image / screenshot
+alpiecode run "Build an HTML/CSS landing page matching this design" --image ./mockup.png
+```
+
+### 3. Launch Backend & VS Code Extension
+```bash
+alpiecode serve
+```
+*Starts the background API and automatically installs the AlpieCode VS Code Extension.*
+
+---
+
+## 🌟 Key Highlights
+
+- 🌐 **Dual Online & Offline Modes**: High-speed cloud VLM (80-120 tok/s) when online, automatic fallback to local GGUF (`169Pi/Alpie_learn_prototype_GGUF_NEW`) on CPU/GPU when offline.
+- 💭 **Thinking & Non-Thinking Modes**: Deep chain-of-thought reasoning for complex multi-file projects, or instant low-latency mode for rapid edits.
+- 🖼️ **Multimodal Perception**: Analyze UI mockups, screenshots, video recordings (`--video`), YouTube links (`--url`), and GitHub repos (`--github`).
+- ⚡ **VS Code Ghost-Text Autocomplete**: Real-time Fill-In-Middle inline suggestions. Press `Tab` to accept.
+- 📝 **Native Side-by-Side Diff Previews**: Inspect `Original ↔ Modified` diffs with one-click `Accept` or `Reject` in VS Code before writing to disk.
+- 🛡️ **Guardian Safety Gate**: Automatically classifies shell commands into `SAFE`, `WARNING`, and hard-blocks `DANGEROUS` operations (`rm -rf /`, `sudo`, `mkfs`).
+- 🧠 **Cross-Session Memory & Plan Preservation**: Automatically remembers working build/test commands and project architecture across chat sessions.
+
+---
+
+## 📖 Complete Documentation
+
+For the full detailed manual covering all 14 tools, CLI flags, REST API endpoints, vision extraction, and offline GGUF setup:
+
+👉 **[Read the Full Documentation (DOCUMENTATION.md)](./DOCUMENTATION.md)**
+
+---
+
+## 🛠️ CLI Cheat Sheet
+
+| Command | Description |
+|:---|:---|
+| `alpiecode run "<task>"` | Execute an autonomous software engineering task |
+| `alpiecode chat` | Multi-turn interactive terminal REPL |
+| `alpiecode plan "<task>"` | Generate a structured execution plan (read-only dry run) |
+| `alpiecode diff` | Show git diff of all modifications made by AlpieCode |
+| `alpiecode serve` | Start API server on `http://127.0.0.1:7169` & install VS Code plugin |
+| `alpiecode init` | Guided setup wizard (pre-download offline GGUF model) |
+
+### Important Flags
+- `--image <path>` : Analyze screenshot/diagram for vision tasks
+- `--video <path>` : Extract keyframes from video for debugging
+- `--url <url>` : Analyze YouTube tutorial/bug report
+- `--github <repo>` : Explore open-source repo (e.g. `facebook/react`)
+- `--no-thinking` : Disable reasoning tokens for instant execution
+- `--max-turns <n>` : Set maximum turn limit (default: `50`)
+- `--workdir <dir>` : Set target workspace directory
+
+---
+
+## 📄 License
+MIT License. Built by the **169Pi AI Research Team**.

{alpiecode-0.9.8 → alpiecode-1.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "alpiecode"
-version = "0.9.8"
+version = "1.0.0"
 description = "AlpieCode — Autonomous AI Coding Agent CLI powered by local 169Pi GGUF VLM"
 requires-python = ">=3.9"
 dependencies = [

{alpiecode-0.9.8 → alpiecode-1.0.0}/src/alpiecode.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alpiecode
-Version: 0.9.8
+Version: 1.0.0
 Summary: AlpieCode — Autonomous AI Coding Agent CLI powered by local 169Pi GGUF VLM
 Requires-Python: >=3.9
 Requires-Dist: huggingface_hub>=0.20.0

{alpiecode-0.9.8 → alpiecode-1.0.0}/src/codeagent/backends/openai_backend.py

@@ -63,14 +63,22 @@ class OpenAIBackend:
         tool_calls = None
         if msg.tool_calls:
             import json
-            tool_calls = [
-                ToolCall(
-                    id=tc.id,
-                    name=tc.function.name,
-                    arguments=json.loads(tc.function.arguments or "{}"),
+            tool_calls = []
+            for tc in msg.tool_calls:
+                try:
+                    args = json.loads(tc.function.arguments or "{}")
+                except (json.JSONDecodeError, TypeError):
+                    args = {}
+                # Defensive: ensure args is always a dict (model sometimes returns lists or strings)
+                if not isinstance(args, dict):
+                    args = {}
+                tool_calls.append(
+                    ToolCall(
+                        id=tc.id,
+                        name=tc.function.name,
+                        arguments=args,
+                    )
                 )
-                for tc in msg.tool_calls
-            ]
 
         reasoning = getattr(msg, "reasoning", None) or getattr(msg, "reasoning_content", None)
 

{alpiecode-0.9.8 → alpiecode-1.0.0}/src/codeagent/executor.py

@@ -133,9 +133,11 @@ class ToolExecutor:
                     if on_tool_start:
                         on_tool_start(tc.name, tc.arguments)
                     t0 = time.monotonic()
+                    # Defensive: ensure arguments is always a dict
+                    safe_args = tc.arguments if isinstance(tc.arguments, dict) else {}
                     fn = self.dispatch.get(tc.name)
                     if fn:
-                        future = pool.submit(fn, tc.arguments)
+                        future = pool.submit(fn, safe_args)
                     else:
                         future = pool.submit(lambda: f"error: Unknown tool '{tc.name}'")
                     future_to_tc[future] = (tc, t0)
@@ -161,10 +163,12 @@ class ToolExecutor:
             if on_tool_start:
                 on_tool_start(tc.name, tc.arguments)
             t0 = time.monotonic()
+            # Defensive: ensure arguments is always a dict
+            safe_args = tc.arguments if isinstance(tc.arguments, dict) else {}
             fn = self.dispatch.get(tc.name)
             if fn:
                 try:
-                    res_str = str(fn(tc.arguments))
+                    res_str = str(fn(safe_args))
                 except Exception as e:
                     res_str = f"error: {e}"
             else:

{alpiecode-0.9.8 → alpiecode-1.0.0}/src/codeagent/tools.py

@@ -334,6 +334,24 @@ def _smart_truncate(text: str, max_chars: int = 6000) -> str:
     )
 
 
+
+def _extract_script_path(command: str) -> str:
+    """Extract the script file path from a bash command, if any."""
+    import re as _re
+    patterns = [
+        r"python3?\s+(?:-[a-zA-Z]+\s+)*([^\s|>&;]+\.py)",
+        r"node\s+([^\s|>&;]+\.js)",
+        r"ruby\s+([^\s|>&;]+\.rb)",
+        r"\./([^\s|>&;]+)",
+        r"bash\s+([^\s|>&;]+\.sh)",
+    ]
+    for pat in patterns:
+        m = _re.search(pat, command)
+        if m:
+            return m.group(1)
+    return ""
+
+
 def _bash(workdir: Path, command: str) -> str:
     """Run a shell command with guardian safety gate.
 
@@ -391,13 +409,33 @@ def _bash(workdir: Path, command: str) -> str:
             "exit_code": result.returncode,
         })
 
-        # Inject clear error signal for failed commands
+        # ── Smart Guardrail 1: Failed command — inject actionable hints ──
         if result.returncode != 0:
-            output = (
+            script_file = _extract_script_path(command)
+            hint = (
                 f"⚠️ COMMAND FAILED (exit_code={result.returncode}). "
                 f"Read the error output carefully and fix the ROOT CAUSE.\n"
-                + output
             )
+            if script_file:
+                hint += (
+                    f"💡 HINT: Use read_file to examine \'{script_file}\' around the "
+                    f"failing line before making edits. Do NOT guess — read first.\n"
+                )
+            output = hint + output
+
+        # ── Smart Guardrail 2: Silent success — script ran but no output ──
+        elif result.returncode == 0 and not stdout.strip() and not stderr.strip():
+            script_file = _extract_script_path(command)
+            if script_file:
+                output += (
+                    "\n\n⚠️ WARNING: Command succeeded (exit_code=0) but produced "
+                    "NO OUTPUT. This usually means:\n"
+                    "  1. The main execution block (if __name__ == \'__main__\') is missing or broken\n"
+                    "  2. An exception is being silently caught with a bare \'except: pass\'\n"
+                    "  3. The print/output statements were accidentally removed\n"
+                    f"→ Use read_file to check \'{script_file}\' — especially the main block "
+                    "at the bottom of the file. Do NOT re-run the same command."
+                )
 
         return output
     except subprocess.TimeoutExpired:

alpiecode-0.9.8/README.md

@@ -1,74 +0,0 @@
-# AlpieCode
-
-Autonomous AI Coding Agent CLI backed by 169Pi Alpie VLM / OpenAI-compatible endpoint
-(speaks the `/v1/chat/completions` tool-calling protocol).
-
-```
-    _    _     _      ____            _      
-   / \  | |_ _| | ___ / ___|___   __| | ___ 
-  / _ \ | | '_ \ |/ _ \ |   / _ \ / _` |/ _ \
- / ___ \| | |_) | |  __/ |__| (_) | (_| |  __/
-/_/   \_\_|_.__/|_|\___|\____\___/ \__,_|\___|
-```
-
-## Quick Start
-
-```bash
-git clone <repo-url>
-cd codeagent-poc
-uv venv && source .venv/bin/activate
-uv pip install -e .
-```
-
-The defaults point directly to the team's Alpie VLM endpoint (`http://20.245.200.125:8000/v1` with model `169Pi/grpo_phase_2_merged`), so you can start using it immediately:
-
-```bash
-cd your-repo
-alpiecode "explain what this project does"
-# or
-alpiecode run "fix the failing test in tests/test_foo.py"
-```
-
-## Usage
-
-### 1. Direct Task Execution
-```bash
-alpiecode "create a python script to calculate fibonacci numbers and add unit tests"
-```
-
-### 2. Explicit Run Subcommand
-```bash
-alpiecode run "refactor database connection in main.py" --max-turns 30
-```
-
-### 3. Interactive Chat Mode
-```bash
-alpiecode chat
-```
-Maintains context across multiple prompts in an interactive REPL session. Type `exit` or `quit` to stop.
-
-### 4. Configuration (Optional)
-```bash
-alpiecode init
-```
-Configures custom endpoint settings saved to `~/.alpiecode/config.json`. Or set env vars:
-```bash
-export ALPIECODE_BASE_URL=http://your-host:8000/v1
-export ALPIECODE_MODEL=169Pi/grpo_phase_2_merged
-```
-
-## Built-in Tool Support
-AlpieCode comes equipped with native tool calling:
-- **`list_files`**: Inspect repository directory structure.
-- **`read_file`**: Read file contents with line range filtering.
-- **`write_file`**: Create new files or overwrite existing ones.
-- **`edit_file`**: Make exact, targeted line string replacements.
-- **`bash`**: Execute shell commands/tests in the repository directory.
-
-## Automatic Checkpoints
-AlpieCode automatically initializes `git` if not already present and creates a commit checkpoint after every turn.
-If you ever need to rollback:
-```bash
-git log --oneline
-git reset --hard <checkpoint-sha>
-```