ToolApprovalDialog

Dialog for reviewing and approving tool execution (developer tooling).

Usage

ui.toolApprovalDialog({
  id: "approval",
  open: state.pendingApproval !== null,
  request: state.pendingApproval,
  onAllow: () => executeTool(state.pendingApproval),
  onDeny: () => app.update((s) => ({ ...s, pendingApproval: null })),
  onAllowForSession: () => allowForSession(state.pendingApproval),
  onClose: () => app.update((s) => ({ ...s, pendingApproval: null })),
})

Props

Prop	Type	Default	Description
id	string	required	Widget identifier
request	ToolRequest	required	Tool request details
open	boolean	required	Visible state
focusedAction	"allow" \| "deny" \| "allowSession"	-	Focused action button
onAllow	() => void	required	Allow callback
onDeny	() => void	required	Deny callback
onAllowForSession	() => void	-	Allow for session callback
onClose	() => void	required	Close callback

Notes

• ToolRequest includes metadata like toolId, toolName, riskLevel, and optional fileChanges.
• fileChanges entries include path, changeType, and optional preview/oldPath for renames.

Related

• Modal
• Callout