focus_pane_tool.py 1.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647
  1. #!/usr/bin/env python3
  2. """Reveal/focus a pane in the Hermes desktop GUI (``pane.reveal`` via ``desktop_ui``).
  3. The renderer runs each pane's own reveal path and only acts on the active window, so
  4. a background turn never moves the user's focus. URLs/files go through `desktop_preview`.
  5. """
  6. from tools import desktop_ui
  7. from tools.registry import registry, tool_error
  8. PANES = ("chat", "files", "terminal", "review", "sessions")
  9. def focus_pane_tool(pane: str) -> str:
  10. """Ask the desktop GUI to reveal and focus ``pane``."""
  11. name = (pane or "").strip().lower()
  12. if name not in PANES:
  13. return tool_error(f"pane must be one of: {', '.join(PANES)}.")
  14. return desktop_ui.emit_or_error(
  15. "pane.reveal", {"pane": name}, f"Failed to focus the {name} pane: ",
  16. "Pane focus is only available in the Hermes desktop app.", {"success": True, "pane": name})
  17. registry.register(
  18. name="focus_pane",
  19. toolset="desktop_ui",
  20. schema={
  21. "name": "focus_pane",
  22. "description": (
  23. "Show a desktop pane: chat, files, terminal, review (git diff) or sessions. "
  24. "Use when the user asks to see one; for URLs/files use desktop_preview."
  25. ),
  26. "parameters": {
  27. "type": "object",
  28. "properties": {
  29. "pane": {
  30. "type": "string",
  31. "enum": list(PANES),
  32. "description": "Which pane to reveal.",
  33. },
  34. },
  35. "required": ["pane"],
  36. },
  37. },
  38. handler=lambda args, **kw: focus_pane_tool(pane=args.get("pane", "")),
  39. emoji="🪟",
  40. )