voidx 2.2.0__tar.gz → 2.3.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: voidx
-Version: 2.2.0
+Version: 2.3.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.2.0 → voidx-2.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "voidx"
-version = "2.2.0"
+version = "2.3.0"
 description = "A coding agent that quantifies everything and solves with tools, not fuzzy prompts."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -48,6 +48,7 @@ where = ["src"]
 ]
 "voidx.data" = [
     "intent_classifier.json",
+    "templates/*.md",
 ]
 
 [tool.pytest.ini_options]

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

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

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

@@ -46,15 +46,20 @@ BASE_SYSTEM_PROMPT = """You are voidx, a coding agent that lives in the terminal
 - Keep user-facing responses concise and focused on outcomes.
 - Do not expose internal role names unless the user asks about architecture.
 - Never claim work is complete until it has been verified.
+- When Current Task State lists an active workflow gate, that workflow gate takes precedence
+  over role prompts, delegation rules, and the decision flow below.
 
 
-## Workflow Skills
+## Workflow Runtime
 
-- 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.
+- voidx has a structured workflow runtime.
+- Current Task State is the activation source for this turn's workflow nodes.
+- Workflow Context messages contain structured workflow node definitions as a
+  reference library. Active node definitions are expanded; inactive nodes may
+  appear only as summaries. Follow ONLY nodes listed as active in Current Task
+  State, unless the user explicitly references another node by name.
+- When a node is not listed as active, its summary is reference only. Do not
+  follow its gate, workflow, or transition instructions.
 - load_skills can return project/global skill bodies for the current turn.
 """
 
@@ -76,8 +81,9 @@ surgical edits directly when that is the shortest safe path.
      Do not call implement. Do not start plan→implement→review.
    - Discuss/design/propose → produce options or a plan. Do not implement unless
      the user explicitly approves.
-   - Fix/implement/modify → edit directly for small scoped changes, or delegate
-     broad/isolated work to implement.
+   - Fix/implement/modify → unless blocked by an active workflow gate, edit
+     directly for small scoped changes, or delegate broad/isolated work to
+     implement.
    - Ambiguous → continue with read-only investigation when useful. Use clarify
      for one structured question before edits, unsafe bash, or implement delegation.
 
@@ -98,14 +104,14 @@ 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/apply_patch
-     yourself and verify.
+   - Small documentation or single-file edits → unless blocked by an active
+     workflow gate, read first, then call write/edit 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
      confirmation before editing.
-   - Broad, risky, or isolated implementation work → use todo and delegate a
-     complete brief to implement. Review non-trivial delegated work before
-     reporting completion.
+   - Broad, risky, source/test/config, or multi-file patch work → unless blocked
+     by an active workflow gate, use todo and delegate a complete brief to
+     implement. Review non-trivial delegated work before reporting completion.
    - If review says FAIL or NEEDS_CHANGE → fix, review again.
 
 5. **Unclear intent** — ask through clarify. One specific clarifying question is
@@ -118,10 +124,15 @@ surgical edits directly when that is the shortest safe path.
 - In plan mode, do not call write/edit/lsp_format, unsafe bash, or implement.
 - Ambiguous implementation intent is not enough for write/edit/lsp_format,
   unsafe bash, or implement delegation.
+- apply_patch is implement-only. As orchestrator, use write/edit for direct
+  edits and delegate multi-file patch work to implement.
 - Child agents do not interact with the user. If a child plan result needs user
   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.
+- If Current Task State lists an active workflow gate, that workflow gate takes precedence over
+  this decision flow. Do not delegate to implement or take implementation action while a gate
+  blocks implementation workflows.
 """
 
 # Plan mode prompt — injected when plan_mode=True
@@ -233,6 +244,9 @@ verdict: PASS | FAIL | NEEDS_CHANGE
 - PASS means the code is ready to ship — no issues found.
 - NEEDS_CHANGE for minor issues that don't block functionality.
 - FAIL for bugs, security issues, or broken functionality.
+- Workflow impact: PASS leaves review workflow completion to the orchestrator.
+  FAIL or NEEDS_CHANGE means the orchestrator should advance review with
+  `review_has_issues` into review-feedback.
 """
 
 
@@ -338,11 +352,12 @@ BUILTIN_AGENTS: dict[str, AgentDef] = {
                     "delegates broad work to specialists, reviews results.",
         when_to_use="Default agent for all user interactions. Always use first.",
         tools=[
-            "on_intent", "clarify", "plan_checkpoint",
+            "on_intent", "clarify", "plan_checkpoint", "advance_workflow",
             "read", "glob", "grep", "bash", "agent", "task_status", "todo", "load_skills",
+            "load_doc_template",
             "webfetch", "websearch", "repo_map",
             "lsp_diagnostics", "lsp_symbols", "lsp_definition", "lsp_references",
-            "write", "edit", "apply_patch", "lsp_format",
+            "write", "edit", "lsp_format",
         ],
         can_write=True,
         can_delegate=True,

{voidx-2.2.0 → voidx-2.3.0}/src/voidx/agent/attachments.py

@@ -56,7 +56,13 @@ def serialize_message_content(content: str | list[dict[str, Any]]) -> tuple[str,
     return content, "text"
 
 
-def build_user_message_payload(user_text: str, workspace: str) -> UserMessagePayload:
+def build_user_message_payload(
+    user_text: str,
+    workspace: str,
+    *,
+    text_prefix: str = "",
+    extra_removed_spans: list[tuple[int, int]] | None = None,
+) -> UserMessagePayload:
     workspace_path = Path(workspace).resolve()
     tokens = _attachment_tokens(user_text)
     removed_spans: list[tuple[int, int]] = []
@@ -112,8 +118,13 @@ def build_user_message_payload(user_text: str, workspace: str) -> UserMessagePay
         if section:
             text_sections.append(section)
 
+    display_clean_text = _normalize_text(_remove_spans(user_text, removed_spans))
+    if extra_removed_spans:
+        removed_spans.extend(extra_removed_spans)
     clean_text = _normalize_text(_remove_spans(user_text, removed_spans))
     text_content = _build_text_content(clean_text, attachments, text_sections)
+    if text_prefix.strip():
+        text_content = _prefix_text_content(text_prefix.strip(), text_content)
     content: str | list[dict[str, Any]]
     content_format = "text"
     if image_parts:
@@ -122,7 +133,7 @@ def build_user_message_payload(user_text: str, workspace: str) -> UserMessagePay
     else:
         content = text_content
 
-    display_text = _display_text(clean_text, attachments)
+    display_text = _display_text(display_clean_text, attachments)
     title_text = clean_text or (f"Attached {attachments[0].rel_path}" if attachments else user_text)
     return UserMessagePayload(
         raw_text=user_text,
@@ -158,7 +169,9 @@ def _remove_spans(text: str, spans: list[tuple[int, int]]) -> str:
         return text
     result: list[str] = []
     last = 0
-    for start, end in spans:
+    for start, end in sorted(spans):
+        if start < last:
+            continue
         result.append(text[last:start])
         result.append(" ")
         last = end
@@ -166,6 +179,13 @@ def _remove_spans(text: str, spans: list[tuple[int, int]]) -> str:
     return "".join(result)
 
 
+def _prefix_text_content(prefix: str, text: str) -> str:
+    text = text.strip()
+    if not text:
+        return prefix
+    return f"{prefix}\n\n{text}"
+
+
 def _resolve_workspace_path(workspace: Path, raw_path: str) -> Path | None:
     candidate = Path(raw_path).expanduser()
     resolved = candidate.resolve() if candidate.is_absolute() else (workspace / candidate).resolve()

voidx-2.3.0/src/voidx/agent/graph/compaction.py

@@ -0,0 +1,81 @@
+"""Context compaction method proxies for the agent graph."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from voidx.agent.graph.compaction_coordinator import CompactionResult, GraphCompactionCoordinator
+
+if TYPE_CHECKING:
+    from voidx.agent.graph.contracts import GraphCompactionHost
+
+
+def _compaction_component_for(host: GraphCompactionHost) -> GraphCompactionCoordinator:
+    coordinator = getattr(host, "_compaction_coordinator", None)
+    if coordinator is None:
+        # Bare mixin tests can instantiate a host without VoidXGraph.__init__.
+        coordinator = GraphCompactionCoordinator(host)
+        host._compaction_coordinator = coordinator
+    return coordinator
+
+
+class GraphCompactionMixin:
+    def _compaction_component(self: GraphCompactionHost) -> GraphCompactionCoordinator:
+        return _compaction_component_for(self)
+
+    async def _maybe_compact(
+        self: GraphCompactionHost,
+        messages: list,
+        session_msgs: list | None = None,
+        *,
+        force: bool = False,
+        ask: bool = True,
+    ) -> tuple[list | None, str | None]:
+        return await _compaction_component_for(self).maybe_compact(
+            messages,
+            session_msgs,
+            force=force,
+            ask=ask,
+            run_compaction_agent=self._run_compaction_agent,
+            persist_compaction=self._persist_compaction,
+        )
+
+    async def _in_turn_compact(
+        self: GraphCompactionHost,
+        messages: list,
+    ) -> CompactionResult | None:
+        count = getattr(self, "_in_turn_compaction_count", 0) + 1
+        self._in_turn_compaction_count = count
+        if count > 2:
+            return None
+        return await _compaction_component_for(self).compact_for_live_state(
+            messages,
+            force=True,
+            ask=False,
+            include_summary_message=True,
+            run_compaction_agent=self._run_compaction_agent,
+            persist_compaction=self._persist_compaction,
+        )
+
+    async def _ask_compact(self: GraphCompactionHost, total_tokens: int) -> bool:
+        return await _compaction_component_for(self).ask_compact(total_tokens)
+
+    async def _persist_compaction(self: GraphCompactionHost, head_messages: list) -> None:
+        await _compaction_component_for(self).persist_compaction(head_messages)
+
+    async def _compact_session_history(self: GraphCompactionHost, *, force: bool = True) -> bool:
+        return await _compaction_component_for(self).compact_session_history(
+            force=force,
+            run_compaction_agent=self._run_compaction_agent,
+            persist_compaction=self._persist_compaction,
+        )
+
+    async def _run_compaction_agent(
+        self: GraphCompactionHost,
+        head_messages: list,
+        previous_summary: str | None,
+    ) -> str | None:
+        return await _compaction_component_for(self).run_compaction_agent(
+            head_messages,
+            previous_summary,
+        )