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,17 @@
+"""Shell command machinery for the interactive REPL.
+
+Groups the shell command-line concern next to the agent-facing
+``tools.interactive_shell.actions.shell``:
+
+* ``parsing`` turns command text into an executable shape,
+* ``policy`` resolves the (alpha-mode, allow-everything) shell execution plan,
+* ``execution`` runs the subprocess and returns a structured result,
+* ``runner`` wires parsing, policy, builtins (``cd`` / ``pwd``), and execution
+  together and records the turn.
+
+Import submodules explicitly (for example ``tools.interactive_shell.shell.runner``)
+rather than relying on this package initializer, to keep interactive-shell
+startup import-light.
+"""
+
+from __future__ import annotations