iop/agent-ui/definition/views/nodes/index.md

ui_doc_type	view_id	status	frame	source_evidence	regions
view	nodes	구현됨	null	type path notes code apps/client/lib/widgets/nodes_panel.dart NodesPanel renders the active edge selector and composes the node content section. type path notes code apps/client/lib/widgets/nodes_panel_sections.dart NodesPanelContent, NodeStatusCard, and ProviderSnapshotCard render node states, adapter chips, and provider catalog cards. type path notes code apps/client/lib/client_home_page.dart ClientHomePage injects NodesPanel into the shell nodes section. type path notes docs README.md Nodes are Edge-connected executors responsible for adapter execution and runtime status. type path notes user null Initial scaffold requested by user.	nodes.header nodes.edge-selector nodes.node-list nodes.node-status nodes.adapter-config nodes.provider-catalog

Nodes

View ID: nodes

Frame:

• 없음

Status: 구현됨

Source Evidence

Type	Path	Notes
code	apps/client/lib/widgets/nodes_panel.dart	NodesPanel이 Edge selector와 node content composition을 렌더링한다.
code	apps/client/lib/widgets/nodes_panel_sections.dart	NodesPanelContent, NodeStatusCard, ProviderSnapshotCard가 상태 분기, node card, adapter chip, provider catalog를 렌더링한다.
code	apps/client/lib/client_home_page.dart	shell nodes section에 NodesPanel을 주입한다.
docs	README.md	Node는 Edge에 연결되는 실제 실행자이며 runtime status를 보고한다.
user	없음	초기 agent-ui 생성을 요청했다.

Purpose

선택 Edge에 등록된 Node와 provider runtime 상태를 빠르게 점검한다.

Primary Users

• IOP operator
• runtime/provider capacity를 확인하는 engineer

Primary Tasks

• active Edge 선택
• Node 연결 상태 확인
• Node config와 adapter enablement 확인
• provider catalog의 health, load, model, lifecycle capability 확인

Information Priority

1. active Edge와 Node 연결 상태
2. Node config, concurrency, adapter 상태
3. provider catalog capacity와 lifecycle capability

Regions

Region ID	Purpose	Component	Priority	Notes
nodes.header	view title, refresh action 표시	없음	high	Nodes View heading을 포함한다.
nodes.edge-selector	active Edge 선택	edge-selector	high	Edge 목록이 있을 때 dropdown을 보여준다.
nodes.node-list	Node card 목록 표시	node-card	high	alias, node id, connection badge를 포함한다.
nodes.node-status	Node connected/offline 상태 표시	status-badge	high	card header badge로 표시된다.
nodes.adapter-config	Node adapter enablement 표시	status-badge	medium	adapter chip으로 enabled/disabled를 나타낸다.
nodes.provider-catalog	provider snapshot 목록 표시	provider-snapshot-card	medium	provider health, capacity, queue, served models를 포함한다.

Actions

Action ID	Trigger	Result	Guard
nodes.select-edge	Active Edge dropdown change	선택 Edge의 status view로 전환한다.	Edge 목록이 있어야 한다.
nodes.refresh	Refresh icon button	선택 Edge status를 다시 fetch한다.	선택 Edge가 있어야 한다.

States

• loading: 선택 Edge status fetch 중 spinner를 표시한다.
• empty: Edge가 없거나 Node가 없으면 안내 메시지를 표시한다.
• error: status fetch 실패 메시지를 표시한다.
• permission-denied: 현재 구현 근거 없음

Open Questions

• 없음

Decision History

• 2026-06-25: NodesPanel 구현을 기준으로 nodes view를 정의했다.
• 2026-07-18: Node와 provider rendering의 코드 근거를 책임 분리된 nodes_panel_sections.dart로 동기화했다.