Geniusbot architecture¶
Geniusbot is a PySide6 desktop entry point for the agent platform. It provides operator-facing graph, fleet, metrics, search, tool, and terminal panels.
Platform boundary¶
Graph OS is the governed gateway and composition host. Agent Utilities owns agent execution and control-plane behavior. Epistemic Graph owns durable graph storage, ontology, and reasoning. Agent Connector SDK connects external systems to the graph.
Geniusbot request paths¶
Most networked panels use GatewayClient to call Graph OS. The desktop UI sends longer work through background workers so the Qt event loop remains responsive.
BackendAdapter retains a limited in-process Agent Utilities path for workspace graph execution, service-dashboard configuration and aggregation, and local log-directory resolution. This path is used by specific panels; it is not the gateway contract.
Operator approvals¶
The tool guard presents sensitive actions and their arguments for operator approval before execution. The UI provides the confirmation step; Graph OS remains the platform gateway and policy boundary for governed service requests.