@steerprotocol/agentconnect-ui
v0.4.0
Published
React display and trusted-operator components for AgentConnect wallet state and request review.
Readme
AgentConnect UI
Display-only React components for AgentConnect browser apps.
import { AgentConnectPanel, AgentConnectWalletOverlay, RequestInspectionPanel } from "@steerprotocol/agentconnect-ui";The UI package imports shared AgentConnect types only. It does not import the provider, Wagmi connector, daemon, MCP tools, or any signing/key material. Components accept request/account state from the host app and render status, pending requests, request summaries, and MCP review context.
The dapp-facing components intentionally expose no approval, rejection, signing, broadcast, key import, or request mutation callbacks. MCP/operator review happens outside the browser app.
AgentConnectWalletOverlay is the embeddable in-app wallet widget for React layouts. It renders a collapsed hover pill, a compact wallet/session summary, and a read-only request review modal over the dapp. Its only action callback is onConnect, which should call the host app's provider or Wagmi connector connect flow. It does not link to an operator surface and does not approve, reject, sign, broadcast, import keys, or unlock custody.
Layout embed example:
export function AppLayout({ children }: { children: React.ReactNode }) {
return (
<>
{children}
<AgentConnectWalletOverlay
account={account}
chainName="Sepolia"
daemonOnline={daemonOnline}
onConnect={() => connectAgentConnect()}
paired={paired}
requests={pendingRequests}
/>
</>
);
}Trusted operator approval primitives are exported separately from @steerprotocol/agentconnect-ui/operator. They are for privileged local operator surfaces, not dapp embeds. The operator panel requires MCP/control-plane authority metadata and exact request-hash confirmation before enabling approval; the host app still supplies the MCP/control-plane adapter that calls agentconnect_approve_request or agentconnect_reject_request.
TrustedOperatorShell is the first-pass standalone shell composition for those trusted local hosts. It displays MCP authority, daemon status, key-store policy, and request queue context, then routes approve/reject intent through the same host-supplied MCP/control-plane callbacks.
The operator entrypoint does not collect private keys, seed material, or key-store passphrases.
Provider and Wagmi integration belongs in host apps or future explicit secondary entrypoints. The root UI entrypoint stays display-only and shared-types-only.
agentConnectUiFixtures provides reusable display fixtures for connected, disconnected, daemon-unreachable, unsupported-chain, empty-queue, pending-request, and rejected-request states. These fixtures are intended for examples, docs, and future story files without requiring provider or Wagmi imports.
License
BUSL-1.1. See LICENSE.
