The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
"""``manage_connections`` action ``display``: the desktop's browsable connector card.
The card is an operation with no targets, so only Continue, words typed in the composer, the deadline or /stop settle it. Connecting from the card runs the Connectors page's own account operation, never this one."""
from __future__ import annotations
import json
from dataclasses import dataclass, field
from typing import Any, Optional
from tools.connectors.contract import SettleReason
from tools.connectors.operation import ConnectionOperation
from tools.connectors.run import Callback, Kind, open_and_drive
OFF_DESKTOP_NOTE = (
"The connector card shows only in the Hermes desktop app. Tell the user to connect apps from the "
"desktop app or the portal."
)
@dataclass
class DisplayOperation(ConnectionOperation):
suggested: list[str] = field(default_factory=list)
said: str | None = None
def request_payload(self) -> dict[str, Any]:
return {**super().request_payload(), "display": {"suggested": list(self.suggested)}}
def apply_answer(operation: DisplayOperation, raw: str) -> None:
answer = json.loads(raw)
said = str(answer.get("said") or "").strip()
if said:
operation.said = said
if said or answer.get("settled_by") == SettleReason.continue_.value:
operation.settle(SettleReason.continue_)
def connected_slugs(client: Any) -> set[str]:
return {str(i.get("connector", "")).lower() for i in client.list_connectors()
if isinstance(i, dict) and i.get("connected")}
def _result(client: Any, before: set[str], operation: DisplayOperation) -> dict[str, Any]:
after = connected_slugs(client)
result = {"connected": sorted(after), "newly_connected": sorted(after - before), "suggested": operation.suggested}
if operation.said:
result["said"] = operation.said
# A user who connected an app and walked away still gets it reported.
return {**result, "timed_out": True} if operation.settled_by == SettleReason.deadline else result
def _unchanged(_operation: Any) -> None:
return None
def run_display(client: Any, suggested: list[str], *, session_key: str, tool_call_id: Optional[str],
connection_callback: Callback, call: Optional[Any] = None) -> str:
"""Draw the card and hold the tool thread until it settles."""
before = connected_slugs(client)
operation = DisplayOperation([], session_key=session_key, tool_call_id=tool_call_id, call=call,
suggested=suggested)
kind = Kind(prepare=_unchanged, observe=_unchanged, note="",
result=lambda _settled: _result(client, before, operation))
return open_and_drive(operation, kind, connection_callback=connection_callback, with_urls_in_result=False)