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,44 @@
+"""Slash command /tools."""
+
+from __future__ import annotations
+
+from rich.console import Console
+
+from surfaces.interactive_shell.command_registry.types import (
+    SlashCommand,
+    make_list_root_handler,
+)
+from surfaces.interactive_shell.runtime import Session
+from surfaces.interactive_shell.ui import render_tools_table
+from surfaces.interactive_shell.ui.tables.tool_catalog import build_tool_catalog
+
+
+def _list_tools(_session: Session, console: Console, _args: list[str]) -> bool:
+    render_tools_table(console, build_tool_catalog())
+    return True
+
+
+_cmd_tools = make_list_root_handler(
+    "/tools",
+    _list_tools,
+    list_aliases=("list", "ls", "tool", "tools"),
+)
+
+_TOOLS_FIRST_ARGS: tuple[tuple[str, str], ...] = (
+    ("list", "list registered tools (investigation + chat surfaces)"),
+    ("ls", "alias for list"),
+    ("tool", "alias for list"),
+    ("tools", "alias for list"),
+)
+
+COMMANDS: list[SlashCommand] = [
+    SlashCommand(
+        "/tools",
+        "List registered tools.",
+        _cmd_tools,
+        usage=("/tools", "/tools list"),
+        first_arg_completions=_TOOLS_FIRST_ARGS,
+    )
+]
+
+__all__ = ["COMMANDS", "_TOOLS_FIRST_ARGS", "_cmd_tools"]