Interaction

MAESTROSDK.confirm(request)

Shows a native confirmation dialog attached to the Cowork window and waits for the person's answer.

Parameters

Name	Type	Required	Description
request.title	string	Yes	Dialog title
request.message	string	Yes	The question
request.confirmLabel	string	No	Text of the confirm button; default Cowork's own OK
request.cancelLabel	string	No	Text of the cancel button; default Cowork's own Cancel

Returns

Promise<boolean>: true when the person confirms, otherwise false.

Returns false when

Case	Why
The person cancels or closes the dialog	No answer is a no
This tab is not the active tab	Only the tab in front may ask, so a background tab cannot interrupt. Inside a beforeRefresh handler for a refresh the person started, the tab may ask even if it is not in front
title or message is missing or not a string	Invalid request
Another confirmation is already open in the same window	One dialog at a time
The page has no Cowork tab identity, or Cowork cannot show the dialog	Not available

Example

const ok = await MAESTROSDK.confirm({
  title: 'Delete draft',
  message: 'Delete this draft? This cannot be undone.',
  confirmLabel: 'Delete',
  cancelLabel: 'Keep'
});
if (ok) deleteDraft();

Related

• Lifecycle Ask before the tab refreshes
• Overview All modules of the Mini App SDK