feat: add vended tools — shell, editor, python_repl (2/N)

src/strands/vended_tools/__init__.py

@@ -0,0 +1,39 @@
+"""Vended tools for Strands agents.
+
+These are production-ready tools that ship with the SDK and integrate
+with the :class:`~strands.sandbox.base.Sandbox` abstraction. They work
+transparently whether the agent uses a local :class:`~strands.sandbox.host.HostSandbox`
+or a remote sandbox implementation.
+
+Each tool reads its configuration from ``tool_context.agent.state`` using
+a namespaced key (e.g., ``strands_shell_tool``). This means configuration
+persists across tool calls and survives session serialization.
+
+Available tools:
+
+- :func:`~strands.vended_tools.shell.shell` — Execute shell commands
+- :func:`~strands.vended_tools.editor.editor` — View, create, and edit files
+- :func:`~strands.vended_tools.python_repl.python_repl` — Execute Python code
+
+Example::
+
+    from strands import Agent
+    from strands.vended_tools import shell, editor, python_repl
+
+    agent = Agent(tools=[shell, editor, python_repl])
+
+    # Configure tools via agent state (persists across calls)
+    agent.state.set("strands_shell_tool", {
+        "timeout": 60,
+    })
+"""
+
+from .editor import editor
+from .python_repl import python_repl
+from .shell import shell
+
+__all__ = [
+    "editor",
+    "python_repl",
+    "shell",
+]

src/strands/vended_tools/editor/__init__.py

@@ -0,0 +1,20 @@
+"""File editor tool for viewing, creating, and editing files in the agent's sandbox.
+
+Example::
+
+    from strands import Agent
+    from strands.vended_tools import editor
+
+    agent = Agent(tools=[editor])
+    agent("View the contents of /tmp/example.py")
+
+Configuration via agent state::
+
+    agent.state.set("strands_editor_tool", {
+        "max_file_size": 1048576,  # Maximum file size in bytes (default: 1MB)
+    })
+"""
+
+from .editor import editor
+
+__all__ = ["editor"]