Kanshō/Handoff approval gate

Handoff approval gate

A human gate before a handoff begins. The operator can approve, deny, edit the scope, or reroute. Action buttons are always visible — not hover-only — so the decision is reachable; once resolved the gate shows the outcome.

Included in the single kansho full pack. Components are not offered as separate installs.

Awaiting decision

Pick an action to resolve the gate
HG-512PendingNeeds decision
Plan & dispatchSandbox runner

Run the migration script against the staging database and capture the row delta.

Scope
db:staging:writefs:readnet:none

Already resolved

HG-509Accepted
Plan & dispatchVault rotator

Rotate the sandbox secrets and revoke the previous credentials after validation.

Scope
vault:sandbox/*audit:write
HG-508Rejected
Plan & dispatchLegacy summariser

Summarise the 40-page compliance PDF into a one-page brief.

Scope
fs:read

Component documentation

Handoff Approval Gate

components/agent-setup/handoff-approval-gate.tsx

Purpose

Presents a human decision gate before an agent-to-agent handoff begins.

Appropriate use

Use when scope, source, target, and routing alternatives must be reviewed before delegation.

Example

components/agent-setup/handoff-approval-gate.tsx has a representative live example in the "Awaiting decision" section on /components/handoff-approval-gate.

States

An unresolved gate exposes actions; resolved decision uses the shared handoff states and hides decision controls.

API and props

HandoffApprovalGate accepts id, source, target, summary, scope, decision, onAction, and className.

Dependencies

Direct imports are React, Lucide icons, AgentDot, Button, ScopeChip, StatusPill, setup-state metadata, and cn.

Accessibility

All decisions are labelled native buttons and scope is repeated as visible text chips.

Limitations

It does not enforce policy, confirm destructive denial, persist decisions, or show asynchronous pending/error state.

Source

Source: components/agent-setup/handoff-approval-gate.tsx.

Full pack

components/agent-setup/handoff-approval-gate.tsx is documented at /components/handoff-approval-gate and installs only through the single Kansho full pack; no individual component install is offered.