agentnova 0.4.0__tar.gz → 0.4.2__tar.gz

{agentnova-0.4.0 → agentnova-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentnova
-Version: 0.4.0
+Version: 0.4.2
 Summary: ⚛️ AgentNova - A minimal, hackable agentic framework for local LLM inference
 Author-email: VTSTech <veritas@vts-tech.org>
 Maintainer-email: VTSTech <veritas@vts-tech.org>
@@ -32,7 +32,7 @@ Requires-Dist: black>=23.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
 Dynamic: license-file
 
-# ⚛️ AgentNova R04.0
+# ⚛️ AgentNova R04.2
 
 **Status: Alpha**
 
@@ -56,9 +56,10 @@ Inspired by the architecture of OpenClaw, rebuilt from scratch for local-first o
 
 | Document | Description |
 |----------|-------------|
-| [Architecture.md](https://github.com/VTSTech/AgentNova/blob/main/Architecture.md) | Technical documentation for developers (directory structure, core design, orchestrator modes) |
+| [ARCH.md](https://github.com/VTSTech/AgentNova/blob/main/ARCH.md) | Technical documentation for developers (directory structure, core design, orchestrator modes) |
 | [CHANGELOG.md](https://github.com/VTSTech/AgentNova/blob/main/CHANGELOG.md) | Version history and release notes (includes LocalClaw history) |
 | [TESTS.md](https://github.com/VTSTech/AgentNova/blob/main/TESTS.md) | Benchmark results, model recommendations, and testing guide |
+| [CREDITS.md](https://github.com/VTSTech/AgentNova/blob/main/CREDITS.md) | Acknowledges every project, inspiration, API, model creator, and specification that makes AgentNova possible |
 
 ## Features
 
@@ -376,10 +377,5 @@ MIT License - See LICENSE file for details.
 
 ## Contributing
 
-Contributions welcome! Please read the contributing guidelines first.
+Contributions welcome!
 
-## Acknowledgments
-
-- Built for local inference with [Ollama](https://ollama.ai)
-- Optimized for small, efficient models
-- Inspired by ReAct and other agentic frameworks

{agentnova-0.4.0 → agentnova-0.4.2}/README.md

@@ -1,4 +1,4 @@
-# ⚛️ AgentNova R04.0
+# ⚛️ AgentNova R04.2
 
 **Status: Alpha**
 
@@ -22,9 +22,10 @@ Inspired by the architecture of OpenClaw, rebuilt from scratch for local-first o
 
 | Document | Description |
 |----------|-------------|
-| [Architecture.md](https://github.com/VTSTech/AgentNova/blob/main/Architecture.md) | Technical documentation for developers (directory structure, core design, orchestrator modes) |
+| [ARCH.md](https://github.com/VTSTech/AgentNova/blob/main/ARCH.md) | Technical documentation for developers (directory structure, core design, orchestrator modes) |
 | [CHANGELOG.md](https://github.com/VTSTech/AgentNova/blob/main/CHANGELOG.md) | Version history and release notes (includes LocalClaw history) |
 | [TESTS.md](https://github.com/VTSTech/AgentNova/blob/main/TESTS.md) | Benchmark results, model recommendations, and testing guide |
+| [CREDITS.md](https://github.com/VTSTech/AgentNova/blob/main/CREDITS.md) | Acknowledges every project, inspiration, API, model creator, and specification that makes AgentNova possible |
 
 ## Features
 
@@ -342,10 +343,5 @@ MIT License - See LICENSE file for details.
 
 ## Contributing
 
-Contributions welcome! Please read the contributing guidelines first.
+Contributions welcome!
 
-## Acknowledgments
-
-- Built for local inference with [Ollama](https://ollama.ai)
-- Optimized for small, efficient models
-- Inspired by ReAct and other agentic frameworks

{agentnova-0.4.0 → agentnova-0.4.2}/agentnova/__init__.py

@@ -28,10 +28,51 @@ Example Usage:
     agent = Agent(model="qwen2.5:0.5b", soul="/path/to/soul/package")
 """
 
-__version__ = "0.4.0"
+__version__ = "0.4.2"
 __author__ = "VTSTech"
 __status__ = "Alpha"
 
+
+def _get_git_short_hash() -> str:
+    """
+    Get the short git commit hash of the repository.
+    
+    Works when running from source (has .git directory).
+    Returns empty string when installed via pip or git is unavailable.
+    """
+    import subprocess
+    try:
+        # Try to find the repo root from this file's location
+        # Walk up from agentnova/ looking for .git
+        import os
+        check_dir = os.path.dirname(os.path.abspath(__file__))
+        for _ in range(5):  # don't walk up more than 5 levels
+            if os.path.isdir(os.path.join(check_dir, ".git")):
+                # We're inside a git repo — get the short hash
+                result = subprocess.run(
+                    ["git", "rev-parse", "--short", "HEAD"],
+                    cwd=check_dir,
+                    capture_output=True,
+                    text=True,
+                    timeout=5,
+                )
+                if result.returncode == 0:
+                    return result.stdout.strip()
+                break
+            parent = os.path.dirname(check_dir)
+            if parent == check_dir:
+                break
+            check_dir = parent
+    except Exception:
+        pass
+    return ""
+
+
+# Append git commit hash to version if available
+_git_hash = _get_git_short_hash()
+if _git_hash:
+    __version__ = f"{__version__}-{_git_hash}"
+
 from .agent import Agent
 from .agent_mode import AgentMode, AgentState, TaskPlan
 from .orchestrator import Orchestrator, AgentCard

{agentnova-0.4.0 → agentnova-0.4.2}/agentnova/acp_plugin.py

@@ -4,7 +4,7 @@
 This plugin connects AgentNova agents to an ACP (Agent Control Panel) server,
 enabling real-time monitoring, token tracking, and STOP/Resume control.
 
-ACP Specification: v1.0.5 (A2A Compliance)
+ACP Specification: v1.0.6 (A2A Compliance)
 Compliance: Full (mandatory requirements, hints, orphan handling, nudge support, batch ops, shutdown, A2A, JSON-RPC 2.0, primary agent nudge delivery)
 
 Features:
@@ -25,6 +25,11 @@ Features:
 - contextId tracking for session continuity (1.0.4)
 - primary_agent in /api/whoami response (1.0.5)
 - Nudges delivered only to primary agent (1.0.5)
+- CSRF protection optional, disabled by default (1.0.6)
+- CORS preflight support (1.0.6)
+- GET /api/nudge polling support (1.0.6)
+- POST /api/todos/toggle (1.0.6)
+- Bootstrap activity auto-completed (no orphans)
 
 Usage:
     from agentnova import Agent
@@ -246,6 +251,9 @@ class ACPPlugin:
         self._capabilities_override = capabilities  # Store for later, derive from tools if not provided
         self.endpoint = endpoint  # v1.0.4: A2A endpoint
 
+        # 1.0.6: CSRF disabled by default per spec §4.2
+        self._csrf_enabled: bool | None = None  # Unknown until first request
+
         self._csrf_token: str | None = None
         self._csrf_expiry: float = 0
         self._current_activity_id: str | None = None
@@ -339,7 +347,8 @@ class ACPPlugin:
             "Authorization": f"Basic {self.auth}",
             "Content-Type": "application/json",
         }
-        if method == "POST" and self._csrf_token:
+        # 1.0.6: Only send CSRF token if enabled (disabled by default per spec §4.2)
+        if method == "POST" and self._csrf_token and self._csrf_enabled:
             headers["X-CSRF-Token"] = self._csrf_token
 
         url = f"{self.base_url}{endpoint}"
@@ -377,6 +386,9 @@ class ACPPlugin:
         now = time.time()
         if self._csrf_token is None or (now - self._csrf_expiry) > 3000:
             resp = self._request("/api/csrf-token")
+            # 1.0.6: CSRF is optional and disabled by default per spec §4.2
+            # Track the enabled state so we can skip header when not needed
+            self._csrf_enabled = resp.get("csrf_enabled", False)
             token = resp.get("csrf_token")
             # If CSRF is disabled, use empty string sentinel so we don't re-fetch
             self._csrf_token = token if token else ""
@@ -889,11 +901,35 @@ class ACPPlugin:
             "metadata": metadata,
         })
 
+    def check_nudge(self) -> dict:
+        """
+        Check if a nudge is pending without logging a new activity.
+
+        1.0.6: GET /api/nudge returns {nudge, has_pending} for polling.
+        Useful for checking nudge status between steps without
+        triggering a full /api/action call.
+
+        Returns
+        -------
+        dict
+            Response with 'nudge' and 'has_pending' fields
+
+        Example
+        -------
+        >>> result = acp.check_nudge()
+        >>> if result.get("has_pending"):
+        ...     print(f"Pending nudge: {result['nudge'].get('message')}")
+        >>>     acp.ack_nudge()
+        """
+        return self._request("/api/nudge")
+
     def ack_nudge(self) -> dict:
         """
         Acknowledge a pending nudge.
 
         Call this after processing a nudge that had requires_ack=true.
+
+        1.0.6: Also clears the nudge by setting it to None server-side.
         """
         resp = self._request("/api/nudge/ack", "POST", {})
         self._pending_nudge = None
@@ -1636,6 +1672,67 @@ class ACPPlugin:
         resp = self._request("/api/todos")
         return resp.get("todos", [])
 
+    def add_todo(self, content: str, priority: str = "medium", status: str = "pending") -> dict:
+        """
+        Add a single TODO item (1.0.6).
+
+        Unlike sync_todos() which replaces the entire list, this adds one item.
+
+        Parameters
+        ----------
+        content : str
+            Task description
+        priority : str
+            "high", "medium" (default), or "low"
+        status : str
+            "pending" (default), "in_progress", or "completed"
+
+        Returns
+        -------
+        dict
+            API response
+
+        Example
+        -------
+        >>> acp.add_todo("Fix the login bug", priority="high")
+        >>> acp.add_todo("Run tests", priority="low", status="in_progress")
+        """
+        metadata = self._build_metadata()
+        return self._request("/api/todos/add", "POST", {
+            "todo": {"content": content, "priority": priority, "status": status},
+            "agent_name": self.agent_name,
+        })
+
+    def toggle_todo(self, todo_id: str) -> dict:
+        """
+        Toggle a TODO item's status between pending and completed (1.0.6).
+
+        Uses POST /api/todos/toggle which flips a TODO between
+        pending ↔ completed in a single call.
+
+        Parameters
+        ----------
+        todo_id : str
+            The TODO item ID to toggle
+
+        Returns
+        -------
+        dict
+            Response with 'todo' and 'toggled' fields
+        """
+        return self._request("/api/todos/toggle", "POST", {
+            "id": todo_id,
+        })
+
+    def clear_completed_todos(self) -> dict:
+        """
+        Clear completed TODOs (1.0.6).
+
+        Removes all TODOs with status="completed" from the list.
+        """
+        return self._request("/api/todos/clear", "POST", {})
+
+
     def bootstrap(self, claim_primary: bool = True) -> dict:
         """
         Bootstrap ACP session - check status, establish identity, claim primary.

{agentnova-0.4.0 → agentnova-0.4.2}/agentnova/agent.py

@@ -30,9 +30,12 @@ from .core.tool_parse import ToolParser
 from .core.error_recovery import (
     ErrorRecoveryTracker,
     build_enhanced_observation,
+    build_retry_context,
     is_error_result,
     DEFAULT_MAX_CONSECUTIVE_FAILURES,
     DEFAULT_MAX_TOTAL_FAILURES,
+    DEFAULT_MAX_TOOL_RETRIES,
+    DEFAULT_RETRY_ON_ERROR,
 )
 from .core.openresponses import (
     Response, ResponseStatus, ItemStatus,
@@ -120,6 +123,9 @@ class Agent:
         allowed_tools: list[str] | None = None,
         # Skills injection
         skills_prompt: str | None = None,
+        # Retry-with-error-feedback
+        retry_on_error: bool = DEFAULT_RETRY_ON_ERROR,
+        max_tool_retries: int = DEFAULT_MAX_TOOL_RETRIES,
         **kwargs,
     ):
         """
@@ -142,6 +148,8 @@ class Agent:
             tool_choice: Control tool invocation ("auto", "required", "none", or specific tool name)
             allowed_tools: List of tools the model is allowed to invoke (subset of tools)
             skills_prompt: Optional skill instructions to append to the system prompt
+            retry_on_error: Whether to retry failed tool calls with error feedback (default: True)
+            max_tool_retries: Maximum retries per tool call failure (default: 2)
             **kwargs: Additional configuration
         """
         self.model = model
@@ -159,6 +167,17 @@ class Agent:
         self._top_p = top_p
         self._num_predict = num_predict
 
+        # Retry-with-error-feedback
+        self._retry_on_error = retry_on_error
+        self._max_tool_retries = max_tool_retries
+
+        # Dangerous tool confirmation callback.
+        # When set, any tool with dangerous=True must be approved by
+        # this callback before execution. The callback receives
+        # (tool_name, args) and returns True (allow) or False (deny).
+        # If not set, dangerous tools execute without confirmation.
+        self._confirm_dangerous = kwargs.pop("confirm_dangerous", None)
+
         # Initialize backend
         if backend is None:
             self.backend = get_default_backend()
@@ -320,6 +339,9 @@ class Agent:
             max_consecutive_failures=DEFAULT_MAX_CONSECUTIVE_FAILURES,
             max_total_failures=DEFAULT_MAX_TOTAL_FAILURES,
         )
+        
+        if self.debug:
+            print(f"[Agent] Retry on error: {self._retry_on_error}, max_tool_retries: {self._max_tool_retries}")
 
     @property
     def _is_comp_mode(self) -> bool:
@@ -649,6 +671,18 @@ Final Answer: <the answer>
                             name=tool_name,
                             content=str(result),
                         )
+                        # Native tool calls also get retry context on error
+                        if is_error and self._retry_on_error:
+                            retry_msg = build_retry_context(
+                                tool_name=tool_name,
+                                tool_args=tool_args,
+                                tracker=self._error_tracker,
+                                max_tool_retries=self._max_tool_retries,
+                            )
+                            if retry_msg:
+                                if self.debug:
+                                    print(f"  [Retry Context] Adding retry hint for native tool call: {tool_name}")
+                                self.memory.add("user", retry_msg)
                     else:
                         # Use error recovery module for enhanced observation
                         observation_msg = build_enhanced_observation(
@@ -656,7 +690,9 @@ Final Answer: <the answer>
                             result=str(result),
                             tracker=self._error_tracker,
                             available_tools=self.tools.names(),
-                            is_error=is_error
+                            is_error=is_error,
+                            retry_on_error=self._retry_on_error,
+                            tool_args=tool_args,
                         )
                         
                         # Update expecting_final_answer flag
@@ -1091,6 +1127,8 @@ Final Answer: <the answer>
                         tracker=self._error_tracker,
                         available_tools=self.tools.names(),
                         is_error=is_error,
+                        retry_on_error=self._retry_on_error,
+                        tool_args=tool_args,
                     )
 
                     if is_error:
@@ -1356,12 +1394,24 @@ Final Answer: <the answer>
 
         OpenResponses: Tool execution is straightforward - no synthesis.
         Arguments must come from the model.
+
+        If the tool is marked dangerous=True and a confirm_dangerous
+        callback is set, the callback is invoked before execution.
+        Returning False from the callback blocks the tool call.
         """
         tool = self.tools.get(name)
 
         if tool is None:
             return f"Error: Unknown tool '{name}'. Available tools: {self.tools.names()}"
 
+        # Confirmation gate for dangerous tools
+        if getattr(tool, 'dangerous', False) and self._confirm_dangerous is not None:
+            if not self._confirm_dangerous(name, args):
+                return (
+                    f"Tool '{name}' was blocked by user confirmation. "
+                    f"The tool is marked as dangerous and was not approved."
+                )
+
         # Normalize arguments with tool-specific aliases
         expected_params = [p.name for p in tool.params]
         

{agentnova-0.4.0 → agentnova-0.4.2}/agentnova/agent_mode.py

@@ -611,9 +611,20 @@ Example: [{{"description": "Step 1"}}, {{"description": "Step 2"}}]"""
         })
         
         try:
-            # Simple prompt - let the agent use its existing context
-            # This works better with Modelfile system prompts
-            step_prompt = step.description
+            # Build step prompt with plan context for multi-step awareness.
+            # The agent reuses the same memory instance across steps, so it
+            # already has access to previous step results. We add a brief
+            # context header so it knows where it is in the overall plan.
+            if self.plan and self.plan.total_steps > 1:
+                step_idx = self.plan.current_step_index + 1
+                step_count = self.plan.total_steps
+                step_prompt = (
+                    f"[Step {step_idx} of {step_count}] "
+                    f"Goal: {self.plan.goal}\n\n"
+                    f"{step.description}"
+                )
+            else:
+                step_prompt = step.description
             
             # Run the agent with the step prompt
             if self.verbose:
@@ -746,11 +757,16 @@ Example: [{{"description": "Step 1"}}, {{"description": "Step 2"}}]"""
     def _inject_context(self, message: str):
         """
         Inject a context message into the agent's memory.
-        Used to provide awareness prompts during long executions.
+
+        Used to provide awareness prompts during long executions so the
+        agent stays focused on the goal and knows where it is in the plan.
+        The message is added as a 'user' role message so the model
+        processes it on the next step.
         """
-        # This would add a system message to the agent's memory
-        # Implementation depends on Agent class internals
-        pass
+        try:
+            self.agent.memory.add("user", message)
+        except Exception:
+            pass  # Non-fatal — context injection is best-effort
 
 
 # ------------------------------------------------------------------ #

{agentnova-0.4.0 → agentnova-0.4.2}/agentnova/backends/__init__.py

@@ -8,7 +8,8 @@ Written by VTSTech — https://www.vts-tech.org
 from .base import BaseBackend
 from .ollama import OllamaBackend
 from .bitnet import BitNetBackend
-from ..config import AGENTNOVA_BACKEND, OLLAMA_BASE_URL, BITNET_BASE_URL
+from .llama_server import LlamaServerBackend
+from ..config import AGENTNOVA_BACKEND, OLLAMA_BASE_URL, BITNET_BASE_URL, LLAMA_SERVER_BASE_URL
 from ..core.types import ApiMode
 
 
@@ -16,6 +17,8 @@ from ..core.types import ApiMode
 _BACKENDS: dict[str, type[BaseBackend]] = {
     "ollama": OllamaBackend,
     "bitnet": BitNetBackend,
+    "llama-server": LlamaServerBackend,
+    "llama_server": LlamaServerBackend,  # alias
 }
 
 
@@ -47,6 +50,8 @@ def get_backend(name: str, timeout: int | None = None, api_mode: ApiMode | str |
             kwargs["base_url"] = OLLAMA_BASE_URL
         elif name_lower == "bitnet":
             kwargs["base_url"] = BITNET_BASE_URL
+        elif name_lower in ("llama-server", "llama_server"):
+            kwargs["base_url"] = LLAMA_SERVER_BASE_URL
 
     # Create BackendConfig with timeout if specified
     if "config" not in kwargs and timeout is not None:
@@ -92,6 +97,7 @@ __all__ = [
     "BaseBackend",
     "OllamaBackend",
     "BitNetBackend",
+    "LlamaServerBackend",
     "get_backend",
     "get_default_backend",
     "register_backend",