Этап 8: настраиваемые команды

- commands.yaml с рабочими примерами: медиа, громкость, поиск, папки, блокировка;
  перечитывается автоматически, ошибки не ломают остальные команды
- Действия run / open / http / keys; вывод и ответы возвращаются модели
- Вызов через модель (tool calling) и мгновенно по точным фразам, в том числе с параметрами
- Подтверждение «да/нет» для опасных команд, после голосового вопроса микрофон включается сам
- Безопасность: запуск без оболочки, защита аргументов cmd/PowerShell/.bat,
  переменные окружения раскрываются только в шаблоне
- Вкладка «Команды» в настройках
- Тесты разбора, действий, фраз и полных сценариев через Assistant

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

src/agr_assistent/llm/tools.py

@@ -28,6 +28,13 @@ class Tool:
     description: str
     parameters: dict[str, Any]  # JSON Schema объекта аргументов
     handler: Callable[[dict[str, Any]], ToolResult]
+    # Выполнять только после явного «да» пользователя
+    confirm: bool = False
+    # Человекочитаемое описание вызова для вопроса-подтверждения и журнала
+    describe: Callable[[dict[str, Any]], str] | None = None
+
+    def summary(self, arguments: dict[str, Any]) -> str:
+        return self.describe(arguments) if self.describe else self.description
 
     def schema(self) -> dict[str, Any]:
         return {
@@ -55,7 +62,17 @@ class ToolRegistry:
     def schemas(self) -> list[dict[str, Any]]:
         return [tool.schema() for tool in self._tools.values()]
 
+    def get(self, name: str) -> Tool | None:
+        return self._tools.get(name)
+
     def execute(self, name: str, arguments_json: str) -> ToolResult:
+        prepared = self.prepare(name, arguments_json)
+        if isinstance(prepared, ToolResult):
+            return prepared
+        return self.run(*prepared)
+
+    def prepare(self, name: str, arguments_json: str) -> tuple[Tool, dict[str, Any]] | ToolResult:
+        """Находит инструмент и проверяет аргументы; ToolResult — описание ошибки."""
         tool = self._tools.get(name)
         if tool is None:
             return ToolResult(False, f"Инструмента {name} не существует", f"Неизвестный инструмент {name}")
@@ -70,6 +87,11 @@ class ToolRegistry:
         if errors:
             message = "; ".join(errors)
             return ToolResult(False, f"Некорректные аргументы: {message}", f"{name}: {message}")
+        return tool, arguments
+
+    @staticmethod
+    def run(tool: Tool, arguments: dict[str, Any]) -> ToolResult:
+        name = tool.name
         try:
             return tool.handler(arguments)
         except ToolError as exc:
@@ -104,6 +126,12 @@ def validate_arguments(
             allowed = ", ".join(str(option) for option in spec["enum"])
             errors.append(f"{name}: недопустимое значение {converted!r} (допустимы: {allowed})")
             continue
+        if "minimum" in spec and converted < spec["minimum"]:
+            errors.append(f"{name}: значение меньше {spec['minimum']}")
+            continue
+        if "maximum" in spec and converted > spec["maximum"]:
+            errors.append(f"{name}: значение больше {spec['maximum']}")
+            continue
         result[name] = converted
     return result, errors