# Adk Hitl Frontend

> Use when designing or building a human-in-the-loop frontend for an ADK/Agent Runtime app, including pending approval queues, event correlation, session resume, function responses, manager dashboards, auth, audit, and Cloud Run/Pub/Sub wiring.

- Skill: `stas2-git/adk-hitl-frontend` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add stas2-git/adk-hitl-frontend`
- Raw SKILL.md: https://api.skillmd.com/api/skills/stas2-git/adk-hitl-frontend/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: stas2-git (https://skillmd.com/u/stas2-git)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/stas2-git/adk-hitl-frontend

---


# ADK HITL Frontend

Use this skill when an agent pauses for human review and a user interface must list, inspect, decide, and resume the exact agent session.

## Workflow

1. Define the interrupt payload, reviewer role, decision schema, and final resume behavior.
2. Read `references/cl5_agent_frontend_spec.md` for event resolution, adapters, endpoints, UI behavior, and production gaps.
3. Read `references/cl5_vibecode_deploy_frontend.txt` only for exact lab steps or command details.
4. Correlate pending function calls and responses by stable IDs.
5. Persist approval records before resuming the agent.
6. Resume the exact session with the matching function response.
7. Add authentication, authorization, idempotency, optimistic concurrency, and audit logs before production use.

## Required Views And Endpoints

- Pending decision list
- Decision detail with risk context
- Approve/reject or structured decision action
- Final result/status view
- Duplicate/stale decision handling
- Error state for missing session, failed resume, or unauthorized reviewer

## Evaluation Prompts

- Positive: "Design the manager approval UI for this ADK agent." Expected: pending queue, detail view, correlated response, audit, auth, and resume behavior.
- Positive edge: "Approvals sometimes duplicate or arrive late." Expected: idempotency, stale decision handling, and stable IDs.
- Negative: "Make a static marketing page." Expected: no HITL frontend skill unless agent approvals/session resume are involved.