kKjTvdZddlmZddlZddlmZddlmZddlm Z m Z  ddl Z ddl m Z ddlmZmZdd lmZdd lmZmZmZmZmZmZmZmZdd lmZdd lmZm Z  e e jFe dk\Z$ddl%Z%ddl&m'Z' ddZ(Gdde'Z)y#e!$rZ"e!d e"dZ"["wwxYw#e $rdZ$Y?wxYw)upFormInput — a Provider that collects structured input from the user. Define a Pydantic model for the data you need, and ``FormInput`` generates a form UI. The user fills it out, the submission is validated, and an optional callback processes the result. Requires ``fastmcp[apps]`` (prefab-ui). Usage:: from pydantic import BaseModel from fastmcp import FastMCP from fastmcp.apps.form import FormInput class ShippingAddress(BaseModel): street: str city: str state: str zip_code: str mcp = FastMCP("My Server") mcp.add_provider(FormInput(model=ShippingAddress)) ) annotationsN)Callable)Any)InvalidVersionVersion)SetState)CallTool SendMessage) PrefabApp)H3Card CardContent CardFooter CardHeaderColumnFormMuted)If)RESULTSTATEzGFormInput requires prefab-ui. Install with: pip install 'fastmcp[apps]'z0.19.1F) FastMCPAppc|jjD]X\}}||vr |jtus|jt j jur|j||<Td||<Z|S)a Fill in missing boolean fields with their model defaults. HTML checkboxes omit the field entirely when unchecked, so the submitted data dict won't contain a key for ``False`` booleans. This backfills those missing keys so Pydantic validation succeeds. F) model_fieldsitems annotationbooldefaultpydanticfieldsPydanticUndefined)modeldataname field_infos b/Users/ahmed/devFolder/Ultron/claude-voice/.venv/lib/python3.12/site-packages/fastmcp/apps/form.py_backfill_boolean_defaultsr&Csq"..446j 4<   D (!!)J)JJ'//T "T 7 KcbeZdZdZddddddd d fdZd dZd dZxZS) FormInputaA Provider that collects structured input via a Pydantic model. Define a model for the data you need, and ``FormInput`` generates a form from it using ``Form.from_model()``. Field types, labels, descriptions, and validation are all derived from the model. Optionally provide an ``on_submit`` callback to process the validated data. The callback receives a model instance and returns a string that goes back to the LLM. Without a callback, the validated JSON is sent directly. Example:: from pydantic import BaseModel from fastmcp import FastMCP from fastmcp.apps.form import FormInput class Contact(BaseModel): name: str email: str mcp = FastMCP("My Server") mcp.add_provider(FormInput(model=Contact)) With a callback:: def save_contact(contact: Contact) -> str: db.insert(contact.model_dump()) return f"Saved {contact.name}" mcp.add_provider(FormInput(model=Contact, on_submit=save_contact)) NSubmitF)r#title submit_text tool_name on_submit send_messagec|xs |j}t | |||_|xs |j|_||_|xsd|jj |_||_||_ |jy)Ncollect_) __name__super__init___model_title _submit_textlower _tool_name _on_submit _send_message_register_tools) selfr!r#r+r,r-r.r/app_name __class__s r%r4zFormInput.__init__zs{)5>> " -u~~ '#J%..2F2F2H1I'J#) r'c6d|jjdS)Nz FormInput())r5r2)r=s r%__repr__zFormInput.__repr__sDKK003155r'c||j|jddfd }|jjdjdjd d d fd }y) Nc|i}t|}j|}jj|Stj|j dS)z%Validate and process form submission.json)mode)r&model_validater:rEdumps model_dump)r" validatedr!providers r% submit_formz.FormInput._register_tools..submit_formse|-eT:D,,T2I"".**955::i222?@ @r'zCollect zX information from the user via a form. Call this tool when you need the user to provide zi data. The user will see a validated form. After calling this tool, STOP and wait for the user to submit.)r# descriptionc |xs  j}|xs  j}td5}t5t |dddt 5t d5t|tddg} jr|jdtt|td | gd }|r tr||d <tj fi|ddddddt#5t%t&j(5td dddddddddt+ddiS#1swYxYw#1swYtxYw#1swYxxYw#1swYLxYw#1swYPxYw#1swYTxYw)uCollect structured input from the user. Args: prompt: Tell the user what you need and why. title: Optional heading for the form card. submit_text: Optional label for the submit button. default: Optional suggested response — a partial dict of form field values keyed by field name. The form renders with those values pre-filled so the user can confirm or edit rather than start from a blank form. Use this when you already know (or can infer) what the answer should be. Requires prefab-ui>=0.19.1; silently ignored on older versions. zmax-w-lg mx-auto) css_classN)gap submittedTrrL) on_success) submit_labelr.defaultsz Submitted.F)viewstate)r6r7r rr rrrrr;insertr rr _FORM_SUPPORTS_DEFAULTSr from_modelrrrrRr ) promptr+r,rr6_submitrVon_success_actionsfrom_model_kwargsr!rKs r% collect_inputz0FormInput._register_tools..collect_inputsE:-hooF!:X%:%:G 23t\vJ"!]FqM&M!d35& --*11'/ )0$ -+=&9%#:8?)*5OOE?->?1%2]4 \2eoo#6,'$7\=4B"E* A"\%2M]]4$7#6\\=43s E? EE? E$A8EE$E?6E3 E'E3$E?E E?E EE$ E?'E0 ,E33E< 8E??F)N)r"dict[str, Any] | Nonereturnstr)NNN) r[rbr+ str | Noner,rcrr`rar )r5tooluir9r2)r=rLr_r!rKs @@r%r<zFormInput._register_toolss   A  A $$5>>*+D>>"#QR  !%&*-1 ; ; ; $; + ;   ;  ; r')r!type[pydantic.BaseModel]r#rcr+rcr,rbr-rcr.zCallable[..., str] | Noner/rraNone)rarb)rarg)r2 __module__ __qualname____doc__r4rBr< __classcell__)r?s@r%r)r)Xs{J  # $/3"'     - *6Sr'r))r!rfr"dict[str, Any]rarl)*rj __future__rrEcollections.abcrtypingrpackaging.versionrr prefab_uiprefab_ui.actionsrprefab_ui.actions.mcpr r prefab_ui.appr prefab_ui.componentsr r rrrrrr!prefab_ui.components.control_flowr prefab_ui.rxrr ImportError_exc __version__rYrfastmcp.apps.apprr&r)r'r%r}s0# $5*;'   5*$%i&;&;<@QQ' # *M MM Q  $#$s):BB.B+ B&&B+.B87B8