Import AITURK IDE 1.0.0-beta.1 from Hermes 63279301; preserve MIT license

agent/tool_result_classification.py

@@ -0,0 +1,40 @@
+"""Shared helpers for classifying tool result payloads."""
+
+from __future__ import annotations
+
+import json
+from typing import Any
+
+
+FILE_MUTATING_TOOL_NAMES = frozenset({"write_file", "patch"})
+
+
+# Tools whose interrupted/dangling execution is safe to discard because they
+# cannot mutate either external state or Hermes session state. Unknown/plugin/
+# MCP tools stay effect-capable by default.
+NO_EFFECT_TOOL_NAMES = frozenset({
+    "read_file", "search_files", "session_search", "skill_view", "skills_list",
+    "web_extract", "web_search", "vision_analyze", "browser_snapshot",
+    "browser_get_images", "browser_console", "read_terminal",
+})
+
+
+def tool_may_have_side_effect(tool_name: str) -> bool:
+    return tool_name not in NO_EFFECT_TOOL_NAMES
+
+
+def file_mutation_result_landed(tool_name: str, result: Any) -> bool:
+    """Return True when a file mutation result proves the write landed."""
+    if tool_name not in FILE_MUTATING_TOOL_NAMES or not isinstance(result, str):
+        return False
+    try:
+        data = json.loads(result.strip())
+    except Exception:
+        return False
+    if not isinstance(data, dict) or data.get("error"):
+        return False
+    if tool_name == "write_file":
+        return "bytes_written" in data
+    if tool_name == "patch":
+        return data.get("success") is True
+    return False