chore: import upstream snapshot with attribution

2026-07-13 13:10:45 +08:00
commit 4b6817381b
3933 changed files with 525247 additions and 0 deletions
@@ -0,0 +1,59 @@
+"""Shell execution tool."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from core.agent_harness.tools.tool_context import (
+    ActionToolContext,
+    capability_available_from_sources,
+    execute_with_action_context,
+    object_schema,
+    string_property,
+)
+from core.tool_framework.registered_tool import RegisteredTool
+from tools.interactive_shell.shell.runner import run_shell_command
+from tools.interactive_shell.subprocess import require_subprocess_presenter
+
+
+def execute_shell_tool(args: dict[str, Any], ctx: ActionToolContext) -> dict[str, Any]:
+    command = str(args.get("command", "")).strip()
+    if not command:
+        return {"ok": False, "command": "", "response_text": "missing shell command"}
+    return run_shell_command(command, require_subprocess_presenter(ctx))
+
+
+def run_shell(*, command: str, context: Any) -> dict[str, Any]:
+    return execute_with_action_context({"command": command}, context, execute_shell_tool)
+
+
+shell_run_tool = RegisteredTool(
+    name="shell_run",
+    description=(
+        "Run a narrowly scoped local diagnostic shell command. Use for read-only inspection "
+        "or controlled operational steps already requested by the user; avoid destructive, "
+        "credential-exfiltrating, or unrelated commands."
+    ),
+    input_schema=object_schema(
+        properties={
+            "command": string_property(
+                description=(
+                    "Exact shell command to execute. Prefer safe diagnostics (for example: "
+                    "`ls`, `pwd`, `git status`, `uv run python -m pytest ...`). Do not use "
+                    "commands that wipe data or alter unrelated system state."
+                ),
+                min_length=1,
+            )
+        },
+        required=("command",),
+    ),
+    source="interactive_shell",
+    surfaces=("action",),
+    parallel_safe=False,
+    accepts_runtime_context=True,
+    run=run_shell,
+    is_available=lambda sources: capability_available_from_sources(sources, "shell_commands"),
+)
+
+
+__all__ = ["execute_shell_tool", "shell_run_tool"]