iop/agent-ui/definition/components/console-shell/index.md
toki 4cafc91323 fix(transport): 터널 지연에 맞춰 heartbeat 경계를 보강한다
장시간 provider prefill과 stream backpressure가 정상 노드를 끊지 않도록 liveness window를 확장하고 Chronos 분리 완료 문서와 잔여 artifact를 정리한다.
2026-08-02 22:30:25 +09:00

75 lines
2.5 KiB
Markdown

---
ui_doc_type: component
component_id: console-shell
status: 구현됨
source_evidence:
- type: code
path: packages/flutter/iop_console/lib/src/iop_console_shell.dart
notes: IopConsoleShell defines left rail section navigation and content slots.
- type: docs
path: apps/client/README.md
notes: iop_console is the IOP-owned widget boundary for standalone and embedded consumers.
- type: docs
path: agent-roadmap/archive/sdd/automation-runtime-bridge/iop-agent-chronos-extraction-decoupling/SDD.md
notes: The approved SDD removes the standalone Agent section while retaining generic IOP operations sections.
- type: user
path: null
notes: Initial scaffold requested by user.
---
# Console Shell
Component ID: `console-shell`
Status: `구현됨`
## Source Evidence
| Type | Path | Notes |
|------|------|-------|
| code | `packages/flutter/iop_console/lib/src/iop_console_shell.dart` | `IopConsoleShell`, `_IopConsoleRail`, `_RailButton`, `_IopPlaceholder`가 shell structure를 구현한다. |
| docs | `apps/client/README.md` | standalone IOP app과 외부 embedding consumer가 같은 widget boundary를 사용한다고 설명한다. |
| docs | `agent-roadmap/archive/sdd/automation-runtime-bridge/iop-agent-chronos-extraction-decoupling/SDD.md` | Agent section은 제거하고 범용 IOP 운영 section은 유지하도록 확정한다. |
| user | 없음 | 초기 agent-ui 생성을 요청했다. |
## Purpose
IOP console view들을 좌측 rail navigation과 section content slot으로 묶는다.
## Used By
- `overview`: shell initial section
- `edges`: shell section
- `nodes`: shell section
- `runtime`: shell section
- `execution-logs`: shell section
## Anatomy
- left rail
- section icon buttons with tooltip
- content slot
- placeholder fallback
## Variants
- default: dark ops/dev shell
## States
- default
- selected section
- placeholder
- disabled: 없음
## Rules
- shell은 view content를 소유하지 않고 section slot을 mount한다.
- `maintenance``settings`는 package shell placeholder가 있으나 현재 app에서 concrete panel을 주입하지 않는다.
## Decision History
- 2026-06-25: `IopConsoleShell` 구현을 기준으로 component를 정의했다.
- 2026-08-01: 승인된 extraction SDD를 근거로 Agent section 제거 계획을 반영했다.
- 2026-08-02: `agent` enum/slot/rail action을 `IopConsoleShell`에서 제거했다.
- 2026-08-02: Canonical promotion verified the provider-only shell with no standalone Agent section; client tests and the web build passed.