kKjdZddlmZddlmZ ddlmZddlmZddl m Z ddl m Z m Z mZmZmZmZmZmZmZmZddlmZdd lmZdd lmZGd deZy #e$rZed ed Z[wwxYw)uApproval — a Provider that adds human-in-the-loop approval to any server. The LLM presents a summary of what it's about to do, and the user approves or rejects via buttons. The result is sent back into the conversation as a message, prompting the LLM's next turn. Requires ``fastmcp[apps]`` (prefab-ui). Usage:: from fastmcp import FastMCP from fastmcp.apps.approval import Approval mcp = FastMCP("My Server") mcp.add_provider(Approval()) ) annotations)Literal)SetState) SendMessage) PrefabApp) H3ButtonCard CardContent CardFooter CardHeaderColumnMutedRowText)If)STATEzFApproval requires prefab-ui. Install with: pip install 'fastmcp[apps]'N) FastMCPAppc`eZdZdZ d dddddd d fdZd d Zdd ZxZS)ApprovalanA Provider that adds human-in-the-loop approval to a server. The LLM calls the ``request_approval`` tool with a summary and optional details. The user sees an approval card with Approve and Reject buttons. Clicking either sends a message back into the conversation (via ``SendMessage``), triggering the LLM's next turn. The message appears as if the user sent it, so the LLM sees something like ``'"Deploy v3.2 to production" is APPROVED'``. Example:: from fastmcp import FastMCP from fastmcp.apps.approval import Approval mcp = FastMCP("My Server") mcp.add_provider(Approval()) Customized:: Approval( title="Deploy Gate", approve_text="Ship it", approve_variant="default", reject_text="Abort", reject_variant="destructive", ) zApproval RequiredApproveRejectdefaultoutline)title approve_text reject_textapprove_variantreject_variantct||||_||_||_||_||_|jy)N)super__init___title _approve_text _reject_text_approve_variant_reject_variant_register_tools)selfnamerrrrr __class__s f/Users/ahmed/devFolder/Ultron/claude-voice/.venv/lib/python3.12/site-packages/fastmcp/apps/approval.pyr"zApproval.__init__OsE  )' /- c"d|jdS)Nz Approval())r*)r)s r,__repr__zApproval.__repr__es499-q))r-ch||j d dfd }y)Nc  |xs j}|xs j}|xs j} |xs j} |xs j} d|d|} d|d| } t d5}t 5t|dddt5td5t|d|r t|ddddddt5ttj5td dddttj5t!d d 5t#| | t%| t'd dgt#|| t%| t'd dgddddddddddddt)d diS#1swY"xYw#1swYxYw#1swYxYw#1swYxYw#1swYaxYw#1swYexYw#1swYixYw#1swYmxYw)u`Request human approval before proceeding with an action. Call this tool proactively whenever you are about to take a significant or irreversible action and want the user to confirm first. Do NOT wait for the user to ask you to seek approval — use your judgment about when confirmation is appropriate. The user will see an approval card with the summary, optional details, and Approve/Reject buttons. When they click a button, their decision appears as a message in the conversation (as if the user typed it), like: "Deploy v3.2 to production" — I selected: Approve or: "Deploy v3.2 to production" — I selected: Reject IMPORTANT: After calling this tool, you MUST stop and wait for the user's response. Do not continue, do not take any other actions, do not generate further output until you see the "I selected:" message. If approved, continue with the action. If rejected, acknowledge and ask how to proceed. Args: summary: Brief description of the action requiring approval (shown prominently to the user). details: Optional longer explanation, context, or consequences of the action. title: Heading for the approval card (default: "Approval Required"). approve_text: Label for the approve button (default: "Approve"). reject_text: Label for the reject button (default: "Reject"). approve_variant: Button style — "default", "destructive", "success", or "info". reject_variant: Button style for the reject button (same options plus "outline"). "u" — I selected: zmax-w-lg mx-auto) css_classN)gapz font-mediumzResponse sent.zw-full justify-end)r6r4decidedT)varianton_clickF)viewstate)r#r$r%r&r'r r rr rrrr rrr8rr rrr)summarydetailsrrrrrr#_approve_reject _approve_v _reject_v approve_msg reject_msgr;providers r,request_approvalz2Approval._register_tools..request_approvalks`-hooF#=x'='=H!:X%:%:G(EH,E,EJ&B(*B*BIgY&8 CKWI%7yAJ 23t\vJ"!]FqMM:g%2]  \EMM*./+U]]N+ Q2FG" '(1$/ $;$,Y$=*"# ((2$/ $<$,Y$=*"H,"4> %( ="\%2M]] +*HG,+"\43s. G:9 F%G: F>$F2?F>G:G.3 G ?"G.!G"/AG 6G">G.G:%F/ *G:2F; 7F>>G G: G G.G G""G+ 'G..G7 3G::H)NNNNNN)r=strr> str | NonerrHrrHrrHrrHrrHreturnr)ui)r)rFrEs @r,r(zApproval._register_toolshs #' $'+&**.)-Z Z Z Z % Z  $ Z  ( Z 'Z Z  Z r-)r)r*rGrrGrrGrrGrz4Literal['default', 'destructive', 'success', 'info']rz?Literal['default', 'outline', 'destructive', 'success', 'info']rINone)rIrG)rIrK)__name__ __module__ __qualname____doc__r"r0r( __classcell__)r+s@r,rr1s{>)%#          ,*^r-r)rO __future__rtypingrprefab_ui.actionsrprefab_ui.actions.mcpr prefab_ui.apprprefab_ui.componentsrr r r r r rrrr!prefab_ui.components.control_flowr prefab_ui.rxr ImportError_excfastmcp.apps.apprrr-r,r]so"#*1'   5"(UzU P  s6AA+ A&&A+