#src.wesktop.mcp_tools.ask_user

#src.wesktop.mcp_tools.ask_user

Ask-user MCP tool: posts a question to the wesktop dashboard via HTTP API and polls for the user's answer with configurable timeout.

Reaches the server via HTTP using server_url and auth_token parameters.

#_api

def _api(server_url: str, auth_token: str, method: str, path: str, payload: dict[str, Any] | None=None, timeout: int=15) -> dict[str, Any]

Make an authenticated JSON request and return the parsed response.

#ask_user

def ask_user(server_url: str, auth_token: str, session_id: str, branch: str, role: str, question: str, options: list[str] | None=None) -> str

Post a question to the dashboard inbox and block until it is answered.

Creates a persisted question via POST /api/questions, then polls GET /api/questions/{id} until status becomes "answered". Returns the answer text, or an error/timeout message.