voidx 2.0.6__tar.gz → 2.2.0__tar.gz

{voidx-2.0.6 → voidx-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: voidx
-Version: 2.0.6
+Version: 2.2.0
 Summary: A coding agent that quantifies everything and solves with tools, not fuzzy prompts.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown

{voidx-2.0.6 → voidx-2.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "voidx"
-version = "2.0.6"
+version = "2.2.0"
 description = "A coding agent that quantifies everything and solves with tools, not fuzzy prompts."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -44,8 +44,10 @@ where = ["src"]
 
 [tool.setuptools.package-data]
 "voidx.skills" = [
-    "bundled/superpowers/*/SKILL.md",
-    "bundled/superpowers/*/templates/*.md",
+    "bundled/*/SKILL.md",
+]
+"voidx.data" = [
+    "intent_classifier.json",
 ]
 
 [tool.pytest.ini_options]

{voidx-2.0.6 → voidx-2.2.0}/src/voidx/__init__.py

@@ -1,3 +1,3 @@
 """VoidX - A coding agent that quantifies everything."""
 
-__version__ = "2.0.6"
+__version__ = "2.2.0"

{voidx-2.0.6 → voidx-2.2.0}/src/voidx/agent/agents.py

@@ -47,20 +47,15 @@ BASE_SYSTEM_PROMPT = """You are voidx, a coding agent that lives in the terminal
 - Do not expose internal role names unless the user asks about architecture.
 - Never claim work is complete until it has been verified.
 
-## Workflow Skills
-
-- voidx may activate workflow skills such as systematic-debugging,
-  test-driven-development, verification-before-completion,
-  receiving-code-review, requesting-code-review, and writing-plans.
-- The Current Task State lists active workflow skills for this turn.
-- The Active Skills section contains the full instructions for active skills.
-- Follow active workflow skills before acting.
 
-## Parallel Execution
+## Workflow Skills
 
-- Multiple tool calls in one model response run in parallel.
-- Tool calls across separate model responses run sequentially.
-- Batch independent reads/searches together; keep dependent work sequential.
+- voidx has a workflow skill system.
+- Current Task State is the activation source for this turn's workflow skills.
+- Skill Context messages contain bundled workflow skill bodies as a reference
+  library. Follow only skills listed as active in Current Task State, unless the
+  user explicitly references another skill.
+- load_skills can return project/global skill bodies for the current turn.
 """
 
 
@@ -103,7 +98,7 @@ surgical edits directly when that is the shortest safe path.
    running write-capable commands, or delegating implement.
 
 4. **Code changes**
-   - Small, local, or mechanical changes → read first, then call write/edit
+   - Small, local, or mechanical changes → read first, then call write/edit/apply_patch
      yourself and verify.
    - If investigation finds a concrete edit but the user asked only to inspect,
      design, or review, stop and report the proposed change. Ask for
@@ -127,12 +122,6 @@ surgical edits directly when that is the shortest safe path.
   approval or clarification, call plan_checkpoint or clarify yourself.
 - Don't tell the user "done" until changes are verified.
 - Child agents have isolated context — give them complete, self-contained briefs.
-
-## Parallel Execution
-- Multiple tool calls in ONE response → they run in parallel.
-- Tool calls across SEPARATE responses → they run sequentially.
-- Batch independent work: read 3 files at once, search + fetch in the same step.
-- Sequential work: search first, then read based on what you found.
 """
 
 # Plan mode prompt — injected when plan_mode=True
@@ -199,7 +188,7 @@ You are the dedicated executor for broad or isolated implementation tasks.
 
 ## Rules
 - Read before writing. Never guess file contents.
-- Make minimal, precise edits. Use edit with exact old_string matches.
+- Make minimal, precise edits. Use edit with exact old_string matches, or apply_patch for unified diffs and multi-file changes.
 - Follow the plan if one was provided.
 - Run tests/bash after changes to verify.
 - Return: what files were changed, what was done, any issues encountered.
@@ -260,6 +249,13 @@ class AgentDef(BaseModel):
     max_steps: int = 25
     hidden: bool = False  # hidden from user-facing lists?
     model: str | None = None  # None = inherit from parent
+    mcp_tools: bool = False  # can see registered MCP tools
+
+    def with_max_steps(self, value: int) -> "AgentDef":
+        """Return a copy with max_steps overridden."""
+        if value == self.max_steps:
+            return self
+        return self.model_copy(update={"max_steps": value})
 
     @property
     def role_prompt(self) -> str:
@@ -282,6 +278,8 @@ class AgentDef(BaseModel):
             lines.append(f"- Available tools: {', '.join(self.tools)}")
         else:
             lines.append("- Available tools: none")
+        if self.mcp_tools:
+            lines.append("- MCP tools: available when configured; each call is permission-gated")
         if not self.can_write:
             lines.append("- Constraint: this role must not write or edit files.")
         if not self.can_delegate:
@@ -298,6 +296,39 @@ ROLE_PROMPTS = {
 PROMPTLESS_AGENTS = {"compaction", "title"}
 
 
+def role_prompt_for_llm(agent: AgentDef, *, parallel_subagents_enabled: bool = False) -> str:
+    """Return the role prompt with runtime-gated child-agent scheduling rules."""
+
+    prompt = agent.role_prompt
+    if agent.name != "orchestrator":
+        return prompt
+    child_agent_prompt = _parallel_subagents_prompt(
+        enabled=parallel_subagents_enabled,
+    )
+    if not prompt:
+        return child_agent_prompt
+    return f"{prompt.rstrip()}\n\n{child_agent_prompt}"
+
+
+def _parallel_subagents_prompt(*, enabled: bool) -> str:
+    if enabled:
+        return """## Child-Agent Scheduling
+
+- For independent child-agent tasks, you may issue multiple `agent` tool calls
+  in one response. They will run concurrently up to the configured limit.
+- Each child-agent brief must be complete and self-contained.
+- Keep dependent child-agent work sequential: wait for the result before
+  delegating follow-up work that depends on it.
+- Batch independent read/search tools when useful; keep dependent tool work
+  sequential."""
+    return """## Child-Agent Scheduling
+
+- Delegate at most one child agent in a response. Wait for that result before
+  deciding whether another child agent is needed.
+- Batch independent non-agent read/search tools when useful; keep dependent
+  work sequential."""
+
+
 # ── built-in agents ────────────────────────────────────────────────────────
 
 BUILTIN_AGENTS: dict[str, AgentDef] = {
@@ -308,15 +339,16 @@ BUILTIN_AGENTS: dict[str, AgentDef] = {
         when_to_use="Default agent for all user interactions. Always use first.",
         tools=[
             "on_intent", "clarify", "plan_checkpoint",
-            "read", "glob", "grep", "bash", "agent", "task_status", "todo",
+            "read", "glob", "grep", "bash", "agent", "task_status", "todo", "load_skills",
             "webfetch", "websearch", "repo_map",
             "lsp_diagnostics", "lsp_symbols", "lsp_definition", "lsp_references",
-            "write", "edit", "lsp_format",
+            "write", "edit", "apply_patch", "lsp_format",
         ],
         can_write=True,
         can_delegate=True,
-        max_steps=20,
+        max_steps=100,
         hidden=False,
+        mcp_tools=True,
     ),
     "explore": AgentDef(
         name="explore",
@@ -326,12 +358,12 @@ BUILTIN_AGENTS: dict[str, AgentDef] = {
                     "or answer 'how does X work' questions. Specify thoroughness: "
                     "'quick' for basic, 'medium' for moderate, 'very thorough' for exhaustive.",
         tools=[
-            "read", "glob", "grep", "webfetch", "websearch", "repo_map",
+            "read", "glob", "grep", "load_skills", "webfetch", "websearch", "repo_map",
             "lsp_diagnostics", "lsp_symbols", "lsp_definition", "lsp_references",
         ],
         can_write=False,
         can_delegate=False,
-        max_steps=10,
+        max_steps=25,
         hidden=False,
 
     ),
@@ -342,12 +374,12 @@ BUILTIN_AGENTS: dict[str, AgentDef] = {
         when_to_use="Use for design/architecture questions, before complex implementations, "
                     "or when the user asks for a plan/approach/solution design.",
         tools=[
-            "read", "glob", "grep", "webfetch", "websearch", "repo_map",
+            "read", "glob", "grep", "load_skills", "webfetch", "websearch", "repo_map",
             "lsp_diagnostics", "lsp_symbols", "lsp_definition", "lsp_references",
         ],
         can_write=False,
         can_delegate=False,
-        max_steps=15,
+        max_steps=30,
         hidden=False,
     ),
     "implement": AgentDef(
@@ -356,13 +388,13 @@ BUILTIN_AGENTS: dict[str, AgentDef] = {
         when_to_use="Use for all code writing, file editing, refactoring, bug fixing, "
                     "and bash execution. Give complete, self-contained task descriptions.",
         tools=[
-            "read", "write", "edit", "glob", "grep", "bash", "todo", "repo_map",
+            "read", "write", "edit", "apply_patch", "glob", "grep", "bash", "todo", "load_skills", "repo_map",
             "lsp_diagnostics", "lsp_symbols", "lsp_definition", "lsp_references",
             "lsp_format",
         ],
         can_write=True,
         can_delegate=False,
-        max_steps=25,
+        max_steps=100,
         hidden=False,
     ),
     "review": AgentDef(
@@ -372,12 +404,12 @@ BUILTIN_AGENTS: dict[str, AgentDef] = {
         when_to_use="ALWAYS invoke after implement finishes non-trivial work. "
                     "Use to verify correctness before reporting completion to the user.",
         tools=[
-            "read", "glob", "grep", "bash", "webfetch", "websearch", "repo_map",
+            "read", "glob", "grep", "bash", "load_skills", "webfetch", "websearch", "repo_map",
             "lsp_diagnostics", "lsp_symbols", "lsp_definition", "lsp_references",
         ],
         can_write=False,
         can_delegate=False,
-        max_steps=10,
+        max_steps=30,
         hidden=False,
     ),
     # ── hidden agents (not user-visible, internal only) ───────────────
@@ -435,6 +467,8 @@ def child_agent_descriptions_for_llm() -> str:
     lines = ["Available child agents and the tools they have access to:"]
     for agent in get_subagents():
         tools_str = ", ".join(agent.tools)
+        if agent.mcp_tools:
+            tools_str = f"{tools_str}, MCP tools" if tools_str else "MCP tools"
         lines.append(
             f"- {agent.name}: {agent.description}\n"
             f"  Tools: {tools_str}\n"

{voidx-2.0.6 → voidx-2.2.0}/src/voidx/agent/graph/compaction.py

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
+import logging
 from typing import TYPE_CHECKING
 
-from langchain_core.messages import AIMessage, SystemMessage
+from langchain_core.messages import HumanMessage, SystemMessage
 
 from voidx.agent.message_rows import messages_from_rows
 from voidx.agent.graph.runtime import console, ui
@@ -13,14 +14,22 @@ from voidx.llm.compaction import COMPACTION_MAX_RETRIES, CompactionService
 from voidx.llm.provider import resolve_protocol
 from voidx.llm.usage import estimate_context_tokens, estimate_message_tokens, extract_token_usage
 from voidx.memory.context_frames import save_context_frame_from_messages
-from voidx.ui.output.console import StreamingRenderer
-from voidx.ui.output.dock import dock
-from voidx.ui.output.events import StatusFinished, StatusUpdated, ui_events, via_events
+from voidx.runtime.ui import (
+    StatusFinished,
+    StatusUpdated,
+    StreamingRenderer,
+    dock,
+    ui_events,
+    via_events,
+)
 
 if TYPE_CHECKING:
     from voidx.agent.graph.contracts import GraphCompactionHost
 
 
+logger = logging.getLogger(__name__)
+
+
 class GraphCompactionMixin:
     async def _maybe_compact(
         self: GraphCompactionHost,
@@ -33,8 +42,7 @@ class GraphCompactionMixin:
         """Check overflow and compact if needed.
 
         Returns the messages removed from the live context and the persisted
-        tail anchor id when one is available. Fallback truncation has no stable
-        tail anchor, so it returns None for the second value.
+        tail anchor id when compaction removes an older complete turn.
         """
         total_tokens = estimate_context_tokens(messages, self.config.model.model)
         tokens = {"total": total_tokens, "input": total_tokens, "output": 0, "reasoning": 0}
@@ -73,40 +81,23 @@ class GraphCompactionMixin:
                 else "[yellow]Compacting context...[/yellow]"
             )
 
-        head_msgs, tail_id = self._compaction.select(messages)
-
-        if not head_msgs or not tail_id:
-            # Hard fallback: keep only last 6 messages
-            keep = min(6, len(messages))
-            if via_events():
-                await ui_events.emit(StatusUpdated(
-                    status_id="compaction",
-                    label="Compacting context",
-                    detail=f"fallback truncation, keeping last {keep} messages",
-                    stage="compacting",
-                ))
-            else:
-                ui.print(f"[dim]Aggressive truncation: keeping last {keep} messages[/dim]")
-
-            removed = _truncate_to_recent_messages(messages, keep)
-            # Generate a basic summary from the removed messages
-            fallback = CompactionService.fallback_summary(removed)
-            self._pending_summary = fallback
-            self._compaction_summary = fallback
-            self._compaction.compaction_count += 1
+        selection = self._compaction.select_details(messages)
+        head_msgs, tail_id = selection.head, selection.tail_id
 
+        if not selection.should_compact:
             if via_events():
                 await ui_events.emit(StatusFinished(
                     status_id="compaction",
-                    label=f"Compaction fallback kept last {keep} messages (with extracted summary)",
+                    label="Compaction skipped: no older complete turn to summarize",
                     remove=False,
                 ))
-            return removed, None
+            return None, None
 
         # Run compaction agent with retries
         summary = None
         previous_summary = getattr(self, "_compaction_summary", "") or None
         last_error: Exception | None = None
+        returned_no_summary = False
 
         for attempt in range(1, COMPACTION_MAX_RETRIES + 2):  # 1 initial + N retries
             try:
@@ -121,8 +112,11 @@ class GraphCompactionMixin:
                 summary = await self._run_compaction_agent(head_msgs, previous_summary)
                 if summary:
                     break
+                returned_no_summary = True
+                last_error = None
             except Exception as e:
                 last_error = e
+                returned_no_summary = False
                 if attempt <= COMPACTION_MAX_RETRIES:
                     if via_events():
                         await ui_events.emit(StatusUpdated(
@@ -135,37 +129,43 @@ class GraphCompactionMixin:
                         ui.print(f"[dim]Compaction agent failed ({e}) — retrying ({attempt}/{COMPACTION_MAX_RETRIES})[/dim]")
 
         if not summary:
-            # All retries exhausted — fallback truncation with basic summary
+            # All retries exhausted — use an extracted summary, but keep the selected tail.
+            if last_error:
+                failure_detail = f"{type(last_error).__name__}: {last_error}"
+            elif returned_no_summary:
+                failure_detail = "compaction agent returned no summary"
+            else:
+                failure_detail = "compaction agent did not produce a summary"
             if via_events():
-                err_detail = f"{last_error}; " if last_error else ""
                 await ui_events.emit(StatusUpdated(
                     status_id="compaction",
                     label="Compaction agent failed",
-                    detail=f"{err_detail}falling back to truncation with extracted summary",
+                    detail=f"{failure_detail}; using extracted summary",
                     stage="compacting",
                 ))
             else:
-                err_msg = f" ({last_error})" if last_error else ""
-                ui.print(f"[dim]Compaction agent failed{err_msg} — aggressive truncation with summary[/dim]")
-            keep = min(6, len(messages))
-            removed = _truncate_to_recent_messages(messages, keep)
-            # Generate a basic summary from the removed messages
-            fallback = CompactionService.fallback_summary(head_msgs if head_msgs else removed)
+                err_msg = f" ({failure_detail})"
+                ui.print(f"[dim]Compaction agent failed{err_msg} — using extracted summary[/dim]")
+            fallback = CompactionService.fallback_summary(head_msgs)
             self._pending_summary = fallback
             self._compaction_summary = fallback
             self._compaction.compaction_count += 1
+            tail_msgs = messages[selection.keep_from:]
+            messages.clear()
+            messages.extend(tail_msgs)
+            await self._persist_compaction(head_msgs)
             if via_events():
                 await ui_events.emit(StatusFinished(
                     status_id="compaction",
-                    label=f"Compaction fallback kept last {keep} messages (with extracted summary)",
+                    label=f"Compaction fallback summarized {len(head_msgs)} messages",
+                    detail=f"{failure_detail}; using extracted summary",
                     ok=False,
                     remove=False,
                 ))
-            return removed, None
+            return head_msgs, tail_id
 
         if summary:
-            keep_from = len(head_msgs)
-            tail_msgs = messages[keep_from:]
+            tail_msgs = messages[selection.keep_from:]
             messages.clear()
             messages.extend(tail_msgs)
             self._pending_summary = summary
@@ -222,6 +222,13 @@ class GraphCompactionMixin:
         cache = getattr(self, "_session_msg_cache", None)
         if cache is not None:
             self._session_msg_cache = [r for r in cache if r.id is not None and r.id > last_message_id]
+        context_cache = getattr(self, "_context_cache", None)
+        if context_cache is not None:
+            context_cache.row_messages = {
+                row_id: entry
+                for row_id, entry in context_cache.row_messages.items()
+                if row_id > last_message_id
+            }
 
     async def _compact_session_history(self: GraphCompactionHost, *, force: bool = True) -> bool:
         if getattr(self, "_session", None) is None:
@@ -252,7 +259,12 @@ class GraphCompactionMixin:
             return None
 
         prompt = self._compaction.build_prompt(head_messages, previous_summary)
-        renderer = StreamingRenderer(console, debug=self._debug, stream_to_dock=False)
+        renderer = StreamingRenderer(
+            console,
+            debug=self._debug,
+            stream_to_dock=False,
+            headless=True,
+        )
 
         messages = [SystemMessage(content=COMPACTION_PROMPT)]
         messages.append(HumanMessage(content=prompt))
@@ -284,7 +296,20 @@ class GraphCompactionMixin:
             cache_key=f"{self.config.model.provider}/{self.config.model.model}",
         )
         text = extract_text(assistant_msg)
-        return text if text else None
+        if text:
+            return text
+        logger.warning(
+            "Compaction agent returned empty text: message_type=%s content_type=%s",
+            type(assistant_msg).__name__,
+            _content_type_summary(getattr(assistant_msg, "content", None)),
+        )
+        return None
+
+
+def _content_type_summary(content: object) -> str:
+    if isinstance(content, list):
+        return ",".join(type(item).__name__ for item in content) or "list(empty)"
+    return type(content).__name__
 
 
 def _max_persisted_message_id(messages: list) -> int | None:
@@ -296,16 +321,3 @@ def _max_persisted_message_id(messages: list) -> int | None:
         except (TypeError, ValueError):
             continue
     return max(ids) if ids else None
-
-
-def _truncate_to_recent_messages(messages: list, keep: int) -> list:
-    original = list(messages)
-    system_msgs = [m for m in original if isinstance(m, SystemMessage)]
-    other_msgs = [m for m in original if not isinstance(m, SystemMessage)]
-    tail_msgs = other_msgs[-keep:] if keep > 0 else []
-    retained_ids = {id(m) for m in [*system_msgs, *tail_msgs]}
-    removed = [m for m in original if id(m) not in retained_ids]
-    messages.clear()
-    messages.extend(system_msgs)
-    messages.extend(tail_msgs)
-    return removed

{voidx-2.0.6 → voidx-2.2.0}/src/voidx/agent/graph/contracts.py

@@ -7,11 +7,12 @@ changing the runtime inheritance model.
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Any, Protocol
+import asyncio
+from typing import Any, Protocol
 
 from langchain_core.messages import BaseMessage
 
-from voidx.agent.runtime_context import InteractionMode
+from voidx.agent.runtime_context import ContextCompilerCache, InteractionMode
 from voidx.agent.state import AgentState
 from voidx.agent.task_state import TaskRun, TaskState
 from voidx.config import Config, Settings
@@ -22,10 +23,6 @@ from voidx.memory.session import SessionInfo
 from voidx.permission.service import PermissionService
 from voidx.tools.registry import ToolRegistry
 from voidx.tools.task_tracker import TaskTracker
-from voidx.ui.output.tree import OutputNode, OutputTree
-
-if TYPE_CHECKING:
-    from voidx.ui.tui import PureTui
 
 
 class GraphComponentHost(Protocol):
@@ -47,18 +44,22 @@ class GraphComponentHost(Protocol):
     _interaction_mode: InteractionMode
     _debug: bool
     _file_mtimes: dict[str, float]
-    _turn_node: OutputNode | None
-    _current_tree: OutputTree | None
+    _turn_node: Any | None
+    _current_tree: Any | None
     _current_messages: list[BaseMessage] | None
     _sub_buffers: dict[str, list[BaseMessage]]
     _pending_summary: str | None
     _compaction_summary: str
     _session_msg_cache: list[Any] | None
-    _app: PureTui | None
+    _context_cache: ContextCompilerCache
+    _app: Any | None
     _usage_stats: UsageStats
     _compaction: CompactionService
     _task_state: TaskState
     _task_run: TaskRun
+    _clear_session_tasks: set[asyncio.Task[None]]
+    _title_generation: int
+    _title_task: asyncio.Task[None] | None
 
     _mcp_manager: Any
     _lsp_manager: Any
@@ -70,15 +71,31 @@ class GraphComponentHost(Protocol):
     @property
     def _plan_mode(self) -> bool: ...
 
-    async def _show_startup(self, *, append_transcript: bool = False) -> None: ...
+    async def _show_startup(
+        self,
+        *,
+        append_transcript: bool = False,
+        prefer_direct: bool = False,
+    ) -> None: ...
     def _startup_title(self) -> str: ...
     async def _handle_web_command(self, app: Any, command: Any) -> None: ...
     async def _handle_user_input(self, app: Any, user_input: str) -> tuple[bool, str | None]: ...
-    async def _run_once(self, user_text: str) -> None: ...
+    async def _run_once(self, user_text: str, *, display_text: str | None = None) -> None: ...
     async def _dispatch_slash(self, inp: str) -> bool: ...
     async def _restore_runtime_state(self) -> None: ...
     async def _persist_runtime_state(self) -> None: ...
     async def _clear_runtime_state(self) -> None: ...
+    def _reset_runtime_state_memory(self) -> None: ...
+    def _invalidate_session_title_generation(self) -> None: ...
+    def _temporary_session_title(self, text: str) -> str: ...
+    def _schedule_session_title_generation(
+        self,
+        session_id: str,
+        first_user_text: str,
+        temporary_title: str,
+    ) -> None: ...
+    async def regenerate_session_title(self) -> bool: ...
+    async def _delete_empty_current_session(self) -> None: ...
     async def _persist_transcript_snapshot(self) -> None: ...
     async def _restore_transcript_snapshot(self, *, append: bool = False) -> bool: ...