tool_labels.py 6.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163
  1. from __future__ import annotations
  2. import logging
  3. from dataclasses import dataclass
  4. from typing import Any, Dict, List, Optional
  5. from tools.connectors.gateway.names import parse_connector_name
  6. from tools.mcp_tool_schema import MCP_TOOL_NAME_PREFIX
  7. logger = logging.getLogger("tools.tool_labels")
  8. CONNECTOR_EMOJI = "🔗"
  9. MCP_EMOJI = "🔌"
  10. SEARCH_EMOJI = "🔎"
  11. DESCRIBE_EMOJI = "📖"
  12. DEFAULT_TOOL_EMOJI = "⚡"
  13. _APP_TITLES = {
  14. "discord": "Discord",
  15. "figma": "Figma",
  16. "github": "GitHub",
  17. "gmail": "Gmail",
  18. "googlecalendar": "Google Calendar",
  19. "googledocs": "Google Docs",
  20. "googledrive": "Google Drive",
  21. "jira": "Jira",
  22. "linear": "Linear",
  23. "notion": "Notion",
  24. "outlook": "Outlook",
  25. "slack": "Slack",
  26. "stripe_mcp": "Stripe",
  27. "todoist": "Todoist",
  28. }
  29. BRIDGE_TOOL_NAMES = frozenset({"tool_call", "tool_search", "tool_describe"})
  30. __all__ = [
  31. "BRIDGE_TOOL_NAMES", "CONNECTOR_EMOJI", "DEFAULT_TOOL_EMOJI", "MCP_EMOJI", "ToolLabel",
  32. "app_title", "label_for_tool_name", "labels_for_call"]
  33. @dataclass(frozen=True)
  34. class ToolLabel:
  35. kind: str
  36. app: str
  37. action: str
  38. emoji: str
  39. name: str
  40. preview: str = ""
  41. @property
  42. def text(self) -> str:
  43. return f"{self.app} · {self.action}" if self.action else self.app
  44. def as_payload(self) -> dict[str, str]:
  45. return {"kind": self.kind, "app": self.app, "action": self.action, "emoji": self.emoji,
  46. "text": self.text, "name": self.name, "preview": self.preview}
  47. def app_title(slug: str) -> str:
  48. key = (slug or "").strip()
  49. known = _APP_TITLES.get(key.lower())
  50. if known:
  51. return known
  52. words = [word for word in key.replace("-", " ").replace("_", " ").split() if word]
  53. return " ".join(word[:1].upper() + word[1:] for word in words) or key
  54. def _action_phrase(tool: str, app_slug: str = "") -> str:
  55. text = (tool or "").strip()
  56. prefix = f"{app_slug.replace('-', '_').upper()}_"
  57. if app_slug and text.upper().startswith(prefix):
  58. text = text[len(prefix):]
  59. words = [word for word in text.replace("-", " ").replace("_", " ").split() if word]
  60. return " ".join(words).lower()
  61. def _registry_emoji(name: str) -> str:
  62. try:
  63. from tools.registry import registry
  64. return registry.get_emoji(name, default="") or DEFAULT_TOOL_EMOJI
  65. except Exception:
  66. return DEFAULT_TOOL_EMOJI
  67. def _arg_preview(name: str, arguments: Any) -> str:
  68. if not isinstance(arguments, dict) or not arguments:
  69. return ""
  70. try:
  71. from agent.display import build_tool_preview
  72. return build_tool_preview(name, arguments) or ""
  73. except Exception:
  74. logger.debug("argument preview failed for %s", name, exc_info=True)
  75. return ""
  76. def _local_tool_label(name: str, arguments: Any) -> ToolLabel:
  77. verb = ""
  78. try:
  79. from agent.display import get_tool_verb
  80. verb = get_tool_verb(name) or ""
  81. except Exception:
  82. logger.debug("friendly verb lookup failed for %s", name, exc_info=True)
  83. return ToolLabel(kind="tool", app=verb or app_title(name), action="",
  84. emoji=_registry_emoji(name), name=name, preview=_arg_preview(name, arguments))
  85. def _unnamed_label(arguments: Any) -> ToolLabel:
  86. return ToolLabel(kind="tool", app="Unnamed call", action="", emoji=DEFAULT_TOOL_EMOJI,
  87. name="", preview=_arg_preview("", arguments))
  88. def label_for_tool_name(name: str, arguments: Any = None) -> Optional[ToolLabel]:
  89. if not isinstance(name, str) or not name.strip():
  90. return None
  91. connector = parse_connector_name(name)
  92. if connector is not None:
  93. action = _action_phrase(connector.tool, connector.connector)
  94. alias = arguments.get("connector_alias") if isinstance(arguments, dict) else None
  95. if isinstance(alias, str) and alias.strip():
  96. action = f"{action} ({alias.strip()})"
  97. return ToolLabel(kind="connector", app=app_title(connector.connector), action=action,
  98. emoji=CONNECTOR_EMOJI, name=name, preview=_arg_preview(name, arguments))
  99. if name.startswith(MCP_TOOL_NAME_PREFIX):
  100. server, _, tool = name[len(MCP_TOOL_NAME_PREFIX):].partition("__")
  101. if tool:
  102. return ToolLabel(kind="mcp", app=app_title(server), action=_action_phrase(tool),
  103. emoji=MCP_EMOJI, name=name, preview=_arg_preview(name, arguments))
  104. return _local_tool_label(name, arguments)
  105. def _bridge_labels(function_name: str, args: dict[str, Any]) -> list[ToolLabel]:
  106. if function_name == "tool_search":
  107. queries = args.get("queries")
  108. queries = [queries] if isinstance(queries, str) else queries
  109. first = next((str(q) for q in queries if str(q or "").strip()), "") if isinstance(queries, list) else ""
  110. return [ToolLabel(kind="tool", app="Searching tools", action=first,
  111. emoji=SEARCH_EMOJI, name=function_name)]
  112. names = args.get("names")
  113. names = [names] if isinstance(names, str) else names
  114. count = len(names) if isinstance(names, list) else 0
  115. return [ToolLabel(kind="tool", app="Reading tool details",
  116. action=f"{count} tool" if count == 1 else f"{count} tools",
  117. emoji=DESCRIBE_EMOJI, name=function_name)]
  118. def labels_for_call(function_name: str, function_args: Any) -> list[ToolLabel]:
  119. args = function_args if isinstance(function_args, dict) else {}
  120. if function_name in ("tool_search", "tool_describe"):
  121. return _bridge_labels(function_name, args)
  122. if function_name != "tool_call":
  123. label = label_for_tool_name(function_name, args)
  124. return [label] if label is not None and label.kind != "tool" else []
  125. entries = args.get("calls")
  126. entries = entries if isinstance(entries, list) else [args]
  127. labels = []
  128. for entry in entries:
  129. entry = entry if isinstance(entry, dict) else {}
  130. arguments = entry.get("arguments")
  131. label = label_for_tool_name(entry.get("name"), arguments)
  132. labels.append(label if label is not None else _unnamed_label(arguments))
  133. return labels