ToolApprovalDialog

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

Usage

ui.toolApprovalDialog({
  id: "approval",
  open: state.pendingApproval !== null,
  request: state.pendingApproval,
  onPress: (action) =>
    action === "allow"
      ? executeTool(state.pendingApproval)
      : 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
`width`	`number`	`50`	Dialog width in cells (clamped to viewport width)
`height`	`number`	`15`	Dialog height in cells (clamped to viewport height)
`focusedAction`	`"allow" \| "deny" \| "allowSession"`	-	Focused action button
`onPress`	`(action: "allow" \| "deny") => void`	required	Allow/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.
Default dialog size is 50x15 cells when width/height are omitted.

ToolApprovalDialog

Usage

Props

Notes

Related

On this page