iop/agent-ui/definition/components/node-card/index.md
toki bebd95f909 docs(agent-ui): legacy 상태값을 보정한다
validate-agent-ui 규칙이 요구하는 상태값 스키마에 맞춰 기존 code-first agent-ui 문서의 legacy 상태 표기를 정규화한다.
2026-06-25 10:54:05 +09:00

70 lines
1.6 KiB
Markdown

---
ui_doc_type: component
component_id: node-card
status: 구현됨
source_evidence:
- type: code
path: apps/client/lib/widgets/nodes_panel.dart
notes: NodesPanel renders one Card per node with status, label, config, adapters, and provider catalog.
- type: docs
path: README.md
notes: Node is the Edge-connected executor responsible for runtime adapter execution.
- type: user
path: null
notes: Initial scaffold requested by user.
---
# Node Card
Component ID: `node-card`
Status: `구현됨`
## Source Evidence
| Type | Path | Notes |
|------|------|-------|
| code | `apps/client/lib/widgets/nodes_panel.dart` | Node list builder가 alias/id, connected badge, label, config, adapter chip을 가진 card를 렌더링한다. |
| docs | `README.md` | Node는 Edge에 연결되는 실제 실행자다. |
| user | 없음 | 초기 agent-ui 생성을 요청했다. |
## Purpose
단일 Node의 identity, connectivity, execution config를 한눈에 보여준다.
## Used By
- `nodes`: `nodes.node-list`, `nodes.node-status`, `nodes.adapter-config`
## Anatomy
- alias or node id
- connection badge
- optional label
- concurrency limit
- adapter chips
- provider catalog section
## Variants
- connected
- offline
- with config
- without config
## States
- default
- loading: view-level state
- empty: no adapters configured
- error: view-level state
- disabled: 없음
## Rules
- alias가 있으면 alias를 primary label로 사용한다.
- adapter enabled/disabled는 badge color와 icon을 함께 사용한다.
## Decision History
- 2026-06-25: `NodesPanel`의 Node card pattern을 component로 정의했다.