+ Q(i%WRt^RIHt^RIt^RIt^RIHt^RIHtH t H t H t ^RI H t Ht^RIt^RIHtHt^RIHt]'d ^RIHt^R IHt^R IHt^R IHtHtHt^R IH t H!t!^R I"H#t#^RI$H%t%^RI&H't'H(t(^RI)H*t*H+t+^RI,H-t-^RI.H/t/^RI0H1t1RRlt2RRlt3RRlt4!RR]-4t!RR]4t5R#)z Resource template functionality.) annotationsN)Callable) TYPE_CHECKINGAnyClassVaroverload)parse_qsunquote) AnnotationsIcon)SkipJsonSchema)Docket) Execution)ResourceTemplate)Fieldfield_validator validate_call)ResourceResourceResult)resolve_ui_mime_type) AuthCheck)transform_context_annotationswithout_injected_parameters) TaskConfigTaskMeta)FastMCPComponent)compress_schema)get_cached_typeadapterc V^8dQhRRRR/#) uri_templatestrreturnzset[str])formats"`/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/fastmcp/resources/template.py __annotate__r&&ssxc\P!RV4pV'd>VP^4PR4Uu0uFq"P 4kK up#\ 4#uupi)zFExtract query parameter names from RFC 6570 `{?param1,param2}` syntax.z \{\?([^}]+)\},)researchgroupsplitstripset)r matchps& r%extract_query_paramsr2&sP II& 5E #(;;q>#7#7#<=#sA'c V^8dQhRRRR/#)rtemplater!r"z re.Patternr#)r$s"r%r&r&.s&&#&*&r'c\P!RRV4p\P!RV4pRpVFpVPR4'dWVP R4'd@V^R pVP R4'dVRR pVRV R 2, pKaVRV R 2, pKpV\P !V4, pK \P !R V R 24#)zBuild regex pattern for URI template, handling RFC 6570 syntax. Supports: - `{var}` - simple path parameter - `{var*}` - wildcard path parameter (captures multiple segments) - `{?var1,var2}` - query parameters (ignored in path matching) z \{\?[^}]+\}z (\{[^}]+\}){}*Nz(?P.+)z>[^/]+)^$)r*subr- startswithendswithescapecompile)r4template_without_querypartspatternpartnames& r% build_regexrG.s VVNBA HH^%;  - %D#+1!4 & MCsB8ca]tRt^gt$RtRtR]R&]!RR7tR]R&]!R R R 7t R]R &]!R R7t R]R&]!RRR 7t R]R&]!RRRR7t R]R&RRlt ]R>RRll4t]!R RR7]RR l44tR!R"ltR#R$ltR%R&lt]R?R'R(ll4t]R)R*l4tR?R+R,lltR-R.ltR/R0lt]R1R2l4t]R3R4l4tR5R6ltR7RR8R/R9R:lltR;V3R<lltR=t V;t!#)@r.A template for dynamically creating resources.r4z ClassVar[str] KEY_PREFIXzSubclasses must implement read() or override create_resource()NotImplementedError)rmrs&&r%readResourceTemplate.reads! L   c V^8dQhRRRR/#)r raw_valuerr"rr#)r$s"r%r&rgs))))r'c H\V\4'dV#\V4#)a>Convert a raw result to ResourceResult. This is used in two contexts: 1. In _read() to convert user function return values to ResourceResult 2. In tasks_result_handler() to convert Docket task results to ResourceResult Handles ResourceResult passthrough and converts raw values using ResourceResult's normalization. ) isinstancer)rmrs&&r%convert_resultResourceTemplate.convert_results$ i 0 0 i((r'c(V^8dQhRRRRRRRR/# rrIr!rUr` task_metaNoner"rr#)r$s"r%r&rg, .;? r'c "R#5iNr#rmrIrUrs&&&&r%_readResourceTemplate._read c(V^8dQhRRRRRRRR/# rrIr!rUr`rrr"zmcp.types.CreateTaskResultr#)r$s"r%r&rg,))) .);C) #)r'c "R#5irr#rs&&&&r%rr &)rc(V^8dQhRRRRRRRR/# rrIr!rUr`rzTaskMeta | Noner"z+ResourceResult | mcp.types.CreateTaskResultr#)r$s"r%r&rgs,$+$+$+ .$+;J$+ 4$+r'c "^RIHpV!VRW#R7GRjxL pV'dV#VPW4GRjxL pVP4GRjxL pVP V4#LPL/L5i)a(Server entry point that handles task routing. This allows ANY ResourceTemplate subclass to support background execution by setting task_config.mode to "supported" or "required". The server calls this method instead of create_resource()/read() directly. Args: uri: The concrete URI being read params: Template parameters extracted from the URI task_meta: If provided, execute as a background task and return CreateTaskResult. If None (default), execute synchronously and return ResourceResult. Returns: ResourceResult when task_meta is None. CreateTaskResult when task_meta is provided. Subclasses can override this to customize task routing behavior. For example, FastMCPProviderResourceTemplate overrides to delegate to child middleware without submitting to Docket. check_background_taskr4 component task_typerrN)fastmcp.server.tasks.routingrcreate_resourcerr)rmrIrUrr task_resultresourceresults&&&& r%rrsm0 G1jF    --c::}}&""6** ;&s6A.A( A.A.A*A.A,A.*A.,A.c$V^8dQhRRRRRR/#rrIr!rUr`r"rr#)r$s"r%r&rgs!     n    r'c "\R4h5i)zCreate a resource from the template with the given parameters. The base implementation does not support background tasks. Use FunctionResourceTemplate for task support. z[Subclasses must implement create_resource(). Use FunctionResourceTemplate for task support.r)rmrIrUs&&&r%r ResourceTemplate.create_resources " =  rc V^8dQhRRRR/#)r overridesrr"SDKResourceTemplater#)r$s"r%r&rgs     r'c \VPRVP4VPRVP4VPRVP4VPRVP 4VPRVP 4VPRVP4VPRVP4VPRVP44R 7#) z8Convert the resource template to an SDKResourceTemplate.rF uriTemplater\mimeTyperurvr_meta)rFrr\rrurvrr) rgetrFr r\r_rurvrget_meta)rmrs&,r%to_mcp_template ResourceTemplate.to_mcp_templates #vtyy1! mT5F5FG! mT5E5EF]]:t~~>--4--4! mT5E5EF--  r'c V^8dQhRRRR/#)r mcp_templaterr"rr#)r$s"r%r&rgs   -@  EU  r'c T!VPVPVPVP;'gR/R7#)zJCreates a FastMCP ResourceTemplate from a raw MCP ResourceTemplate object.r])r rFr\r_ra)rrFr\r)rrs&&r%from_mcp_template"ResourceTemplate.from_mcp_templates@ %11""$00"++;;|   r'cV^8dQhRR/#rfr#)r$s"r%r&rgs22S2r'c nVPVP4pT RVP;'gR 2#)z1The globally unique lookup key for this template.@r6)make_keyr rt)rmbase_keys& r%keyResourceTemplate.keys6==!2!231T\\//R011r'c V^8dQhRRRR/#rdocketr r"rr#)r$s"r%r&rg$s5565d5r'c VPP4'gR#VPVPVP.R7R#)z>>>  >  >> >r'c "T;'g VPpV'dWER&VP!V3/VB!V4GRjxL #L5i)a3Schedule this template for background execution via docket. Args: docket: The Docket instance params: Template parameters fn_key: Function lookup key in Docket registry (defaults to self.key) task_key: Redis storage key for the result **kwargs: Additional kwargs passed to docket.add() rNraddrmrrUrrr lookup_keys&&&$$, r% add_to_docketResourceTemplate.add_to_docket*sA$''txx $5MZZ 5f5f====A AAAcV^8dQhRR/#)rr"r`r#)r$s"r%r&rgAs  ^ r'c 6<\SV`4RRRR/,#)zfastmcp.component.typeresource_templatezfastmcp.provider.type LocalProvider)superget_span_attributes)rmrjs&r%r$ResourceTemplate.get_span_attributesAs(w*, $&9 #_0   r'r# NNNNNNNNNNNr)"rk __module__ __qualname____firstlineno____doc__r[__annotations__rr r_rarrdrn staticmethodr}r classmethodrrrrrrrrrpropertyrrrr__static_attributes__ __classcell__)rjs@r%rrgsa8 *J *RL#*MIs"'9"J',"V'K#@EE@D < X  >[x01 : ) ))$+L   &    22 5 > " > $ >.  r'rc]tRtRt$RtR]R&]RRRll4t]RR l4tRR R lltR R ltRRlt RRlt RRRR/RRllt ] RRRll4t RtR#)rziHrZz"SkipJsonSchema[Callable[..., Any]]rrNc(V^8dQhRRRRRRRR/#rr#)r$s"r%r&%FunctionResourceTemplate.__annotate__Nrr'c "R#5irr#rs&&&&r%rFunctionResourceTemplate._readMrrc(V^8dQhRRRRRRRR/#rr#)r$s"r%r&rSrr'c "R#5irr#rs&&&&r%rrRrrc(V^8dQhRRRRRRRR/#rr#)r$s"r%r&rWs,+++ .+;J+ 4+r'c "^RIHpV!VRW#R7GRjxL pV'dV#VPVR7GRjxL pVPV4#L9L5i)a6Optimized server entry point that skips ephemeral resource creation. For FunctionResourceTemplate, we can call read() directly instead of creating a temporary resource, which is more efficient. Args: uri: The concrete URI being read params: Template parameters extracted from the URI task_meta: If provided, execute as a background task and return CreateTaskResult. If None (default), execute synchronously and return ResourceResult. Returns: ResourceResult when task_meta is None. CreateTaskResult when task_meta is provided. rr4rNr)rrrr)rmrIrUrrrrs&&&& r%rrWs\& G1jF    yy6y22""6** 3s$AA AAAAAc$V^8dQhRRRRRR/#rr#)r$s"r%r&rvs!   n  r'c aa"RVV3Rllp\P!VVSPSPSPSP SP SPR7#5i)z>Create a resource from the template with the given parameters.cV^8dQhRR/#)rr"rr#)r$s"r%r&>FunctionResourceTemplate.create_resource..__annotate__ys  (D r'cH<"SPSR7GRjxL pV#L5i)r N)r)rrUrms r%resource_read_fnBFunctionResourceTemplate.create_resource..resource_read_fnys#99v966FM7s " ")rrrIrFr\r_rlryrd)rr}rFr\r_rlrrd)rmrIrUrsf&f r%r(FunctionResourceTemplate.create_resourcevsY   %%((nn!!  sA%A)c V^8dQhRRRR/#rr#)r$s"r%r&rsN7Sr'c "VP4p\P!VP4p\ VP 44FwrEWCP 9gK\V\4'gK/VP V,pVPpV\PPJg V\JdKxV\Jd\V4W$&KV\Jd\V4W$&KV\JdVP4R9W$&KK VP!R/VBp\P$!V4'd VGRjxL pV# \ \"3dEKi;iL5i)rN)true1yesr#)copyinspect signaturerrlistrNrarr! annotation Parameteremptyintfloatboollower ValueErrorAttributeError isawaitable) rmrrsig param_name param_valueparamrrs && r%rFunctionResourceTemplate.reads-!('+FLLN'; #J^^+ ;0L0Lz2"-- !2!2!8!88J#->-@DX-X*,(<("6"   v & &!\F #N3"saAE1#E1;A E1EE1E5E17E3E1 E1E/E1E,'E1+E,,E1c V^8dQhRRRR/#rr#)r$s"r%r&rs3363d3r'c VPP4'gR#VPVPVP.R7R#)zRegister this template with docket for background execution. FunctionResourceTemplate registers the underlying function, which has the user's Depends parameters for docket to resolve. Nr)rrrrrrrs&&r%r-FunctionResourceTemplate.register_with_dockets6 ..00 z2r'rrc 0V^8dQhRRRRRRRRRR R R /#rr#)r$s"r%r&rsN@@@@  @  @@ @r'c "T;'g VPpV'dWER&VP!V3/VB!R/VBGRjxL #L5i)aSchedule this template for background execution via docket. FunctionResourceTemplate splats the params dict since .fn expects **kwargs. Args: docket: The Docket instance params: Template parameters fn_key: Function lookup key in Docket registry (defaults to self.key) task_key: Redis storage key for the result **kwargs: Additional kwargs passed to docket.add() rNr#rrs&&&$$, r%r&FunctionResourceTemplate.add_to_docketsD(''txx $5MZZ 5f5?????rcPV^8dQhRRRRRRRRR RR RR R R RRRRRRRRRRRRR/#rqr#)r$s"r%r&rsB B B B  B " B  B  B !B B B (B $B 'B 1B  "B r'c  T;'g,\VRR4;'gVPPpVR8Xd \R4h\P !V4pVP P4F7pVP\PP8XgK.\R4h \\P!RV44p\V4pVV,pV'g \R4h\V4p\P !V4p\VP P!44pVUu0uF|pVP V,P"\PP$JgK>VP V,P\PP&8wgKzVkK~ ppVUu0uF|pVP V,P"\PP$JgK>VP V,P\PP&8wgKzVkK~ ppV'd!VV, pV'd\RV R 24hVP)V4'g\R V R V 24h\*;QJd4R VP P44F 'gK R M) RM%!R VP P444'g)VP)V4'g\RV RV 24hT;'g\P,!V4pV f\/RR7pM/\1V \24'd\.P4!V 4pMT pVP7W4\P8!V4'g VP:p\1V\<4'd VP>p\AV4p\V4p\CV4pVPE4p\GVR R7p\IV4p\KW(4pT!TTVe \MV4MRTTTT;'gRTTT ;'g \4V V VV R7#uupiuupi)z"Create a template from a function.rkNzz,You must provide a name for lambda functionsz9FunctionResourceTemplate.from_function..s, 0 JJ'++77 70s46TFzURI parameters z- must be a subset of the function arguments: forbiddenr) prune_titlesr])r rFrtrur\rvr_rrrarlrrwrrd)'getattrrjrkr"rrravaluesr3rVAR_POSITIONALr/r*findallr2rkeysr^rr4issubsetanygetdocrrr  from_boolvalidate_function isroutine__call__r__func__rr json_schemarrrr!)rrrr rFrtrur\rvr_rlrrwryrd func_namer%r( path_params query_paramsall_uri_params wrapper_fnuser_sig func_paramsr1required_paramsoptional_paramsinvalid_query_paramsr type_adapterra resolved_mimes&&&&&&&&&&&&&& r%r}&FunctionResourceTemplate.from_functions&RRGB D9RRR\\=R=R  "KL L#^^**,EzzW..=== R-"**%6 EF +L9 $|3OP P14 $$Z0(--2245 !  ""1%--1B1B1H1HH ##A&++w/@/@/L/LL A   !  ""1%--W5F5F5L5LL ##A&++w/@/@/L/LL A    #//#A # '(<'==vw '' 44..??lmxlyz  s ..0 sss ..0   "**;77 %n%55bcnbop"77W^^B%7  <$+6K d # #$..t4KK%%b4  $$B b, ' 'B+2 .04 -j9 !--/ $ZdC : &-\E %$+$7CLT##33|!##  M  s$;R7R>R ;R 7RRr#rr)rkrrrrrrrrrrrrr}rr#r'r%rzrzHsw8** ))+> &>3@ " @ $ @2B B r'rz)6r __future__rrr*collections.abcrtypingrrrr urllib.parserr mcp.typesmcpr r pydantic.json_schemar rr docket.executionrrrpydanticrrrfastmcp.resources.resourcerrfastmcp.server.appsr!fastmcp.server.auth.authorizationrfastmcp.server.dependenciesrrfastmcp.server.tasks.configrrfastmcp.utilities.componentsrfastmcp.utilities.json_schemarfastmcp.utilities.typesrr2rGrXrzr#r'r%rfs&" $99*'/*= @47=99:&4>^ '^ BF /F r'