kKj8dZddlmZddlZddlmZmZmZddlm Z ddl m Z m Z m Z mZmZddlmZmZmZddlmZdd lmZdd lmZe r dd lmZdd lmZeeZed ede fZ dddZ! ddZ"GddeZ#y)u4FastMCPApp — a Provider that represents a composable MCP application. FastMCPApp binds entry-point tools (model calls these) together with backend tools (the UI calls these via CallTool). Backend tools are tagged with ``meta["fastmcp"]["app"]`` so they can be found through the provider chain even when transforms (namespace, visibility, etc.) have renamed or hidden them — the server sets a context var that tells ``Provider.get_tool`` to fall back to a direct lookup for app-visible tools. Usage:: from fastmcp import FastMCP, FastMCPApp app = FastMCPApp("Dashboard") @app.ui() def show_dashboard() -> Component: return Column(...) @app.tool() def save_contact(name: str, email: str) -> str: return name server = FastMCP("Platform") server.add_provider(app) ) annotationsN) AsyncIteratorCallableSequence)asynccontextmanager) TYPE_CHECKINGAnyLiteralTypeVaroverload) AnyFunctionIconToolAnnotations)Provider) AuthCheck) get_logger LocalProviderToolF.)boundc:ddlmmdfd dfd }|S)uCreate a CallTool resolver that prefixes tool names with a hash. Structurally identical to the old ``___`` resolver — ``app_name`` is the FastMCPApp's name, known at serialization time from the tool's ``meta["fastmcp"]["app"]`` tag. The only change is the wire format: ``_`` instead of ``___``. The dispatcher recognizes the hashed form and routes it via ``get_tool_by_hash`` which walks the provider tree recursively — same pattern as ``get_app_tool``. r)hashed_backend_nameparse_hashed_backend_namec2r||S|S|SN) local_nameapp_namerrs a/Users/ahmed/devFolder/Ultron/claude-voice/.venv/lib/python3.12/site-packages/fastmcp/apps/app.py_prefixz_make_resolver.._prefixHs, )4@!!&x< <c&ddlm}t|tr||Sd} ddlm}||}|t|dd}|||St|dd}|||Std|#t $rYWwxYw)Nr) ResolvedToolname)get_fastmcp_metar'__name__zCannot resolve tool reference: ) prefab_ui.appr% isinstancestrfastmcp.decoratorsr( Exceptiongetattr ValueError)fnr%fmetar(r'fn_namer"s r!_resolve_tool_refz)_make_resolver.._resolve_tool_refQs. b# WR[1 1  ;$R(E  &ufd;D#77"j$/  WW%56 6:2&ABB   sB BB)rr,returnr,)r1r r5r )#fastmcp.server.providers.addressingrr)r r4r"rrs` @@@r!_make_resolverr77s C2 r#ctj|r ||St|tr| t d|n||nt d|dt |dfd }|S)zEShared dispatch logic for @app.tool() and @app.ui() calling patterns.zECannot specify both a name as first argument and as keyword argument.zFirst argument to @z* must be a function, string, or None, got c|Srr)r1register tool_names r! decoratorz&_dispatch_decorator..decoratorsI&&r#)r1rr5r)inspect isroutiner+r, TypeErrortype) name_or_fnr'r:decorator_namer<r;s ` @r!_dispatch_decoratorrCms$ D))*c"  W !+   !.!12 #$ &  ' r#c :eZdZdZdfd ZddZedddddd ddZe ddddddd ddZ ddddddd dd Zeddddddddd  dd Ze dddddddddd  d d Z dddddddddd  d!d Z d"dZ d#dZ dd$dZ d%dZ dd&dZ d%dZdd&dZd%dZdd'dZed(dZ d d)dZxZS)* FastMCPAppaOA Provider that represents an MCP application. Binds together entry-point tools (``@app.ui``), backend tools (``@app.tool``), and the Prefab renderer resource. Backend tools are tagged with ``meta["fastmcp"]["app"]`` so ``Provider.get_tool`` can find them by original name even when transforms have been applied. cXddlm}t| ||_|d|_y)Nrrerror) on_duplicate)'fastmcp.server.providers.local_providerrsuper__init__r'_local)selfr'r __class__s r!rKzFastMCPApp.__init__s$I  %2%H r#c"d|jdS)Nz FastMCPApp()r&rMs r!__repr__zFastMCPApp.__repr__sTYYM++r#NF)r' descriptionmodelauthtimeoutcyrrrMrAr'rSrTrUrVs r!toolzFastMCPApp.tools r#cyrrrXs r!rYzFastMCPApp.toolsr#cN|rddgndgdfd }t|||dS)aRegister a backend tool that the UI calls via CallTool. Backend tools default to ``visibility=["app"]``. Pass ``model=True`` to also expose the tool to the model (``visibility=["app", "model"]``). Supports multiple calling patterns:: @app.tool def save(name: str): ... @app.tool() def save(name: str): ... @app.tool("custom_name") def save(name: str): ... apprTc<ddlm}|xs t|dd}|td|ddlm}m}ddlm}|}|| j| j|dd }|j|| | } jj| |S) Nrrr)zCannot determine tool name for  AppConfigapp_config_to_meta_dict hash_tool) visibilityr\ _tool_hashuifastmcp)r'rSmetarVrU) fastmcp.tools.baserr/r0fastmcp.apps.configr_r`r6rbr' from_functionrL_add_component)r1r;r resolved_namer_r`rb app_configritool_objrUrSrMrVrcs r! _registerz"FastMCPApp.tool.._registers /%FZ)FM$ #B2&!IJJ N E"j9J-j999"+DII}"E$D*t))"' H KK & &x 0Ir#rYr1rr; str | Noner5rrC) rMrAr'rSrTrUrVrqrcs ` ` `` @r!rYzFastMCPApp.tools56!&UG E7   <#:tYGGr#)r'rStitletagsiconsrrUrVcyrr rMrAr'rSrurvrwrrUrVs r!rgz FastMCPApp.uis r#cyrrrys r!rgz FastMCPApp.uisr#c H d fd } t||| dS)a!Register a UI entry-point tool that the model calls. Entry-point tools default to ``visibility=["model"]`` and auto-wire the Prefab renderer resource and CSP. They are tagged with the app name so structured content includes ``_meta.fastmcp.app``. Supports multiple calling patterns:: @app.ui def dashboard() -> Component: ... @app.ui() def dashboard() -> Component: ... @app.ui("my_dashboard") def dashboard() -> Component: ... c <ddlm}m}ddlm}ddlm}ddlm}|xst|ddxsd}||dg }||j|j|d d } |j||  |  } jj| |S) Nrr^ra)PREFAB_RENDERER_URIrr)unknownrT) resource_urircrdrf) r'rSrurvrwrrirVrU)rkr_r`r6rb8fastmcp.server.providers.local_provider.decorators.toolsr}rjrr/r'rlrLrm)r1r;r_r`rbr}rresolvedrorirprrUrSrwrMrvrVrus r!rqz FastMCPApp.ui.._register>s N E  0 NGB D$ANYH"0#9J .j999"+DIIx"@$D*t))'' H KK & &x 0Ir#rgrrrt) rMrAr'rSrurvrwrrUrVrqs ` ``````` r!rgz FastMCPApp.uis!>$ $ L#:tYEEr#cddlm}t||s|j|}ddlm}|j rt|j ni}|jdi}|j|d<||j|j|d<|jdi}d|vrdg|d<||_|jj||S) zoAdd a tool to this app programmatically. The tool is tagged with this app's name for routing. rrrarhr\rergrc) rjrr+ _ensure_toolr6rbridict setdefaultr'rLrm)rMrYrrbrifmrgs r!add_toolzFastMCPApp.add_tooljs ,$%$4$$T*DA"&))tDII __Y +II5 $TYY :< __T2 & r ! %wB|   ""4( r#cRK|jjd{S7wr)rL _list_toolsrQs r!rzFastMCPApp._list_toolss[[,,.... '%'cVK|jj||d{S7wr)rL _get_toolrMr'versions r!rzFastMCPApp._get_tools#[[**49999 )')cRK|jjd{S7wr)rL_list_resourcesrQs r!rzFastMCPApp._list_resourcess[[002222rcVK|jj||d{S7wr)rL _get_resourcerMurirs r!rzFastMCPApp._get_resources#[[..sG<<<A<AA A>AAAA AAc ~ddlm}||j}|j||jdd|i|y)z>Create a temporary FastMCP server and run this app standalone.r)FastMCP transportNr)fastmcp.server.serverrr' add_providerrun)rMrkwargsrservers r!rzFastMCPApp.runs9 2#D! 1Y1&1r#)r'r,r5None)r5r,)rArr'rsrSrsrTboolrU"AuthCheck | list[AuthCheck] | NonerV float | Noner5rr)rArsr'rsrSrsrTrrUrrVrr5Callable[[F], F])rAstr | AnyFunction | Noner'rsrSrsrTrrUrrVrr5r )rArr'rsrSrsrursrvset[str] | Nonerwlist[Icon] | NonerToolAnnotations | NonerUrrVrr5r)rArsr'rsrSrsrursrvrrwrrrrUrrVrr5r)rArr'rsrSrsrursrvrrwrrrrUrrVrr5r )rYzTool | Callable[..., Any]r5r)r5zSequence[Tool])r'r,rr r5z Tool | None)r5z Sequence[Any])rr,rr r5 Any | None)r'r,rr r5r)r5zAsyncIterator[None])rz9Literal['stdio', 'http', 'sse', 'streamable-http'] | Nonerr r5r)r) __module__ __qualname____doc__rKrRr rYrgrrrrrrrrrrrr __classcell__)rNs@r!rErEsI,  "&37 $       1     "&  "&37 $       1     04<H "&37 $<H,<H <H  <H  <H1<H<H <HD  "& $#'.237 $        ! , 1     "&  "& $#'.237 $        ! , 1      04EF "& $#'.237 $EF,EF EF  EF  EFEF!EF,EF1EFEF EFV' >/:3=<F1<PT 2L 2 2  2r#rEr)r rsr5r ) rArr'rsr:z Callable[[Any, str | None], Any]rBr,r5r )$r __future__rr=collections.abcrrr contextlibrtypingrr r r r mcp.typesr rrfastmcp.server.providers.baserfastmcp.utilities.authorizationrfastmcp.utilities.loggingrrIrrjrr)loggerrr7rCrErr#r!rs6#==*AA88250E' H  CxS)*3l( /   Fd2d2r#