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

ui_doc_type	view_id	status	frame	source_evidence	regions
view	runtime	구현됨	null	type path notes code apps/client/lib/widgets/runtime_panel.dart RuntimePanel renders edge selector, operation command actions, domain agent grid, and operation history. type path notes code apps/client/lib/client_home_page.dart ClientHomePage injects RuntimePanel into the shell runtime section. type path notes docs README.md Runtime and automation operations are Edge-owned shared operations exposed through Control Plane. type path notes user null Initial scaffold requested by user.	runtime.header runtime.edge-selector runtime.command-actions runtime.command-status runtime.domain-agents runtime.operation-history

Runtime

View ID: runtime

Frame:

• 없음

Status: 구현됨

Source Evidence

Type	Path	Notes
code	apps/client/lib/widgets/runtime_panel.dart	RuntimePanel이 operation command, agent status/command dialogs, domain agent grid, operation history를 렌더링한다.
code	apps/client/lib/client_home_page.dart	shell runtime section에 RuntimePanel을 주입한다.
docs	README.md	Runtime/Automation operation은 Edge가 소유하고 Control Plane이 제어 요청을 전달하는 구조다.
user	없음	초기 agent-ui 생성을 요청했다.

Purpose

운영자가 선택 Edge에 health check, agent status, agent command를 보내고 domain agent 상태와 command 이력을 확인한다.

Primary Users

• IOP operator
• runtime/automation command를 검증하는 engineer

Primary Tasks

• active Edge 선택
• health check 실행
• agent status 조회
• agent command 전송
• domain agent lifecycle 상태 확인
• operation execution history 확인

Information Priority

1. active Edge와 command action availability
2. command result status
3. domain agent lifecycle state
4. operation execution history

Regions

Region ID	Purpose	Component	Priority	Notes
runtime.header	title, active Edge selector, refresh 표시	edge-selector	high	narrow width에서는 header control이 줄바꿈된다.
runtime.edge-selector	active Edge 선택	edge-selector	high	command target Edge를 결정한다.
runtime.command-actions	system/agent command 실행 버튼 표시	command-action-bar	high	health check, agent status, agent command를 포함한다.
runtime.command-status	최근 command 결과 표시	status-badge	high	success/failure alert로 표시된다.
runtime.domain-agents	Edge domain agent grid 표시	domain-agent-card	medium	lifecycle state, summary, active command id를 포함한다.
runtime.operation-history	operation execution history 표시	operation-history-list	medium	command id, selector, summary, error, status를 포함한다.

Actions

Action ID	Trigger	Result	Guard
runtime.select-edge	Active Edge dropdown change	선택 Edge operations를 fetch한다.	Edge 목록이 있어야 한다.
runtime.refresh	Refresh icon button	선택 Edge operations를 다시 fetch한다.	선택 Edge가 있어야 한다.
runtime.health-check	Health Check button	health.check Edge command를 보낸다.	loading 중이 아니어야 한다.
runtime.agent-status	Agent Status dialog submit	agent.status Edge command를 target selector와 함께 보낸다.	selector가 비어 있지 않아야 한다.
runtime.agent-command	Agent Command dialog submit	agent.command Edge command를 selector와 command parameter로 보낸다.	selector와 command가 비어 있지 않아야 한다.

States

• loading: operations fetch 또는 command send 중 spinner/disabled action을 표시한다.
• empty: Edge가 없거나 domain agent/operation history가 없으면 empty message를 표시한다.
• error: operations fetch 또는 command send failure를 error text/status로 표시한다.
• permission-denied: 현재 구현 근거 없음

Open Questions

• 없음

Decision History

• 2026-06-25: RuntimePanel 구현을 기준으로 runtime view를 정의했다.