from __future__ import annotations import requests # type: ignore[import-untyped] import json import time from typing import Any class ApiHookClient: def __init__(self, base_url: str = "http://127.0.0.1:8999", api_key: str | None = None): self.base_url = base_url.rstrip('/') self.api_key = api_key def _make_request(self, method: str, path: str, data: dict | None = None, timeout: float = 5.0) -> dict[str, Any] | None: """Helper to make HTTP requests to the hook server.""" url = f"{self.base_url}{path}" headers = {} if self.api_key: headers["X-API-KEY"] = self.api_key if method not in ('GET', 'POST', 'DELETE'): raise ValueError(f"Unsupported HTTP method: {method}") try: if method == 'GET': response = requests.get(url, headers=headers, timeout=timeout) elif method == 'POST': response = requests.post(url, json=data, headers=headers, timeout=timeout) elif method == 'DELETE': response = requests.delete(url, headers=headers, timeout=timeout) if response.status_code == 200: return response.json() return None except Exception as e: # Silently ignore connection errors unless we are in a wait loop return None def wait_for_server(self, timeout: int = 15) -> bool: """Polls the health endpoint until the server responds or timeout occurs.""" start = time.time() while time.time() - start < timeout: status = self.get_status() if status and (status.get("status") == "ok" or "status" in status): return True time.sleep(0.5) return False def get_status(self) -> dict[str, Any]: """Checks the health of the hook server.""" res = self._make_request('GET', '/status') if res is None: # For backward compatibility with tests expecting ConnectionError # But our _make_request handles it. Let's return empty if failed. return {} return res def get_project(self) -> dict[str, Any]: """Retrieves the current project state.""" return self._make_request('GET', '/api/project') or {} def get_session(self) -> dict[str, Any]: """Retrieves the current discussion session history.""" return self._make_request('GET', '/api/session') or {} def post_session(self, session_entries: list[dict]) -> dict[str, Any]: """Updates the session history.""" return self._make_request('POST', '/api/session', data={"entries": session_entries}) or {} def post_gui(self, payload: dict) -> dict[str, Any]: """Pushes an event to the GUI's SyncEventQueue via the /api/gui endpoint.""" return self._make_request('POST', '/api/gui', data=payload) or {} def push_event(self, action: str, payload: dict) -> dict[str, Any]: """Convenience to push a GUI task.""" return self.post_gui({"action": action, **payload}) def click(self, item: str, user_data: Any = None) -> dict[str, Any]: """Simulates a button click.""" return self.post_gui({"action": "click", "item": item, "user_data": user_data}) def set_value(self, item: str, value: Any) -> dict[str, Any]: """Sets the value of a GUI widget.""" return self.post_gui({"action": "set_value", "item": item, "value": value}) def select_tab(self, item: str, value: str) -> dict[str, Any]: """Selects a specific tab in a tab bar.""" return self.set_value(item, value) def select_list_item(self, item: str, value: str) -> dict[str, Any]: """Selects an item in a listbox or combo.""" return self.set_value(item, value) def get_gui_state(self) -> dict[str, Any]: """Returns the full GUI state available via the hook API.""" return self._make_request('GET', '/api/gui/state') or {} def get_value(self, item: str) -> Any: """Gets the value of a GUI item via its mapped field.""" # Try state endpoint first (new preferred way) state = self.get_gui_state() if item in state: return state[item] # Fallback for thinking/live/prior which are in diagnostics diag = self.get_gui_diagnostics() if diag and item in diag: return diag[item] # Map common indicator tags to diagnostics keys mapping = { "thinking_indicator": "thinking", "operations_live_indicator": "live", "prior_session_indicator": "prior" } key = mapping.get(item) if diag and key and key in diag: return diag[key] return None def get_text_value(self, item_tag: str) -> str | None: """Wraps get_value and returns its string representation, or None.""" val = self.get_value(item_tag) return str(val) if val is not None else None def get_indicator_state(self, item_tag: str) -> dict[str, bool]: """Returns the visibility/active state of a status indicator.""" val = self.get_value(item_tag) return {"shown": bool(val)} def get_gui_diagnostics(self) -> dict[str, Any]: """Retrieves performance and diagnostic metrics.""" return self._make_request('GET', '/api/gui/diagnostics') or {} def get_performance(self) -> dict[str, Any]: """Convenience for test_visual_sim_gui_ux.py.""" diag = self.get_gui_diagnostics() return {"performance": diag} def get_mma_status(self) -> dict[str, Any]: """Convenience to get the current MMA engine status. Returns FULL state.""" return self.get_gui_state() def get_node_status(self, node_id: str) -> dict[str, Any]: """Retrieves status for a specific node in the MMA DAG.""" return self._make_request('GET', f'/api/mma/node/{node_id}') or {} def request_confirmation(self, tool_name: str, args: dict) -> bool | None: """ Pushes a manual confirmation request and waits for response. Blocks for up to 60 seconds. """ # Long timeout as this waits for human input (60 seconds) res = self._make_request('POST', '/api/ask', data={'type': 'tool_approval', 'tool': tool_name, 'args': args}, timeout=60.0) return res.get('response') if res else None def reset_session(self) -> None: """Resets the current session via button click.""" self.click("btn_reset")