+ Q(iGDa0t$^RIHt^RIt^RIHt^RIHtHtH t H t H t H t ^RI t^RIt^RIHt^RI HtHtHtHtHtHt^RI Ht^RIHtHtHt^R IHt^R I H!t!^R I"H#t#H$t$^R I%H&t&^R I'H(t(^RI)H*t*H+t+H,t,H-t-H.t.^RI/H0t1^RI2H3t4Rt5]'d^RI7H8t8^RI9H:t:^RI;Ht>H?t?](!]@4tA]] .]B3,tCR]DR&RRltE!RR]4tF!RR]&4tR*RR lltGR*R!R"lltHR#tIR$R%ltJR*R&R'lltKRR.tLR(R)ltMR# ]6dRt5Li;i)+) annotationsN)Callable) TYPE_CHECKING AnnotatedAnyClassVar TypeAliasoverload)validate_and_warn_tool_name)CallToolResult ContentBlockIcon TextContentToolAnnotations ToolExecution)Tool) BaseModelFieldmodel_validator)SkipJsonSchema) AuthCheck) TaskConfigTaskMeta)FastMCPComponent) get_logger)AudioFileImageNotSetNotSetT) PrefabApp) ComponentTF)Docket) Execution FunctionTool) ArgTransformTransformedToolr ToolResultSerializerTypec V^8dQhRRRR/#)datarreturnstr)formats"X/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/fastmcp/tools/tool.py __annotate__r2@s>>S>S>cV\P!V\R7P4#))fallback) pydantic_coreto_jsonr.decode)r,s&r1default_serializerr9@s   4 ; ; ==r3ca]tRt^Dt$]!RR7tR]R&]!RRR7tR]R &]!RR R7tR]R &RR V3R lllt RRlt Rt V;t #) ToolResultz*List of content blocks for the tool result) descriptionlist[ContentBlock]contentNz4Structured content matching the tool's output schema)defaultr<dict[str, Any] | Nonestructured_contentz)Runtime metadata about the tool executionmetac$V^8dQhRRRRRR/#)r+r>zlist[ContentBlock] | Any | NonerAzdict[str, Any] | Any | NonerBr@r/)r0s"r1r2ToolResult.__annotate__Os(( ( 0( 8( $ ( r3c V<VfVf \R4hVfTp\VR7pVe\'dX\V\4'dVP 4pM0\V\ 4'd\ VR7P 4p\P!VR7p\T\4'g'\R\T4P RT: R24h\SV`AWBVR 7R# \Pdp\PRT 24hRp?ii;i) Nz5Either content or structured_content must be provided)resultview)valuezCould not serialize structured content. If this is unexpected, set your tool's output_schema to None to disable automatic serialization: z/structured_content must be a dict or None. Got z: zA. Tools should wrap non-dict values based on their output_schema.)r>rArB) ValueError_convert_to_content _HAS_PREFAB isinstance _PrefabAppr7_PrefabComponentr6to_jsonable_pythonPydanticSerializationErrorloggererrordicttype__name__super__init__)selfr>rArBconverted_contente __class__s&&&& r1rXToolResult.__init__Os> ?19TU U _(G0C70S  ){0*==);)C)C)E& 24DEE)39K)L)T)T)V& %2%E%E,&"0$77  23<<=R@R?UVVV %SW  !;;  `ab`cd  sC55D( D##D(cV^8dQhRR/#)r+r-zOlist[ContentBlock] | tuple[list[ContentBlock], dict[str, Any]] | CallToolResultr/)r0s"r1r2rDys 5 5 X 5r3c VPe-\VPVPVPR7#VPf VP#VPVP3#)N)structuredContentr>_meta)rBr rAr>rYs&r1 to_mcp_resultToolResult.to_mcp_resultys_ 99 !"&"9"9 ii   " " *<< ||T4444r3r/)NNN) rV __module__ __qualname____firstlineno__rr>__annotations__rArBrXrc__static_attributes__ __classcell__r\s@r1r;r;Dsb"'@#G 16"X1-#("M#D ( ( T 5 5r3r;ca]tRt^t$RtRtR]R&R]R&RtR]R &RtR ]R &Rt R ]R &Rt R]R&Rt R]R&Rt R]R&] !RR7RRl4tRRlt]RRRRRRRRRRRRR RR RR ]RRR!RR"RRRRR/R#R$ll4tR%R&ltR'R(lt]R>R)R*ll4t]R+R,l4tR>R-R.lltR/R0ltR1RR2R/R3R4llt]RRR]R]RRR ]R ]RRR!]R5RR6R/ R7R8ll4t]R9R:l4tR;V3R<lltR=tV;t#)?rz Internal tool registration info.toolz ClassVar[str] KEY_PREFIXzOAnnotated[dict[str, Any], Field(description='JSON schema for tool parameters')] parametersNzRAnnotated[dict[str, Any] | None, Field(description='JSON schema for tool output')] output_schemaz]Annotated[ToolAnnotations | None, Field(description='Additional annotations about the tool')]rz]Annotated[ToolExecution | None, Field(description='Task execution configuration (SEP-1686)')] executionzAnnotated[SkipJsonSchema[ToolResultSerializerType | None], Field(description='Deprecated. Return ToolResult from your tools for full control over serialization.')] serializerzAnnotated[SkipJsonSchema[AuthCheck | list[AuthCheck] | None], Field(description='Authorization checks for this tool', exclude=True)]authzkAnnotated[float | None, Field(description='Execution timeout in seconds. If None, no timeout is applied.')]timeoutafter)modecV^8dQhRR/#)r+r-rr/)r0s"r1r2Tool.__annotate__sTr3c 0\VP4V#)z Ej Er3c "\R4h5i)z Run the tool with arguments. This method is not implemented in the base Tool class and must be implemented by subclasses. `run()` can EITHER return a list of ContentBlocks, or a tuple of (list of ContentBlocks, dict of structured output). zSubclasses must implement run())NotImplementedError)rYrs&&r1runTool.runs""CDDs c V^8dQhRRRR/#)r+ raw_valuerr-r;r/)r0s"r1r2rxs, , , , r3c \V\4'dV#\'dM\V\4'd \ V4#\V\ 4'd\ \VR74#\ WPR7pVPf\V\\,\,\,4'g\\V\\,4'dG\;QJdRV4F 'gK RM RM !RV44'd \VR7#\ P"!V4pTPf/\T\&4'd \Y#R7#\TR7#TPP)R4p\TT'd R T/R7#TR7# \ P$d\TR7u#i;i) zConvert a raw result to ToolResult. Handles ToolResult passthrough and converts raw values using the tool's attributes (serializer, output_schema) for proper conversion. rG)rrc3B"TFp\V\4xK R#5iNrMr .0items& r1 &Tool.convert_result..sM94 4669TF)r>r>rAzx-fastmcp-wrap-resultrF)rMr;rLrN_prefab_to_tool_resultrOrKrrrpr rrrlisttupleanyr6rPrQrTr)rYrr> structured wrap_results&& r1convert_resultTool.convert_resultsq i , ,  ;)Z00-i88)%566-ji.HII%iOOL    % y,"6">"E F F9dUl33CM9MCCCM9MMMg. . /&99)DJ    %*d++!'QQg. .((,,-DE 9D*5  JT  77 /g. . /s4F??!G#"G#c$V^8dQhRRRRRR/#)r+rr task_metaNoner-r;r/)r0s"r1r2rx1s(!  r3c "R#5irr/rYrrs&&&r1_run Tool._run0s c$V^8dQhRRRRRR/#)r+rrrrr-zmcp.types.CreateTaskResultr/)r0s"r1r2rx8s())!)) $ )r3c "R#5irr/rs&&&r1rr7s &)rc$V^8dQhRRRRRR/#)r+rrrzTaskMeta | Noner-z'ToolResult | mcp.types.CreateTaskResultr/)r0s"r1r2rx>s($)$)!$)#$) 1 $)r3c "^RIHpV!VRVVR7GRjxL pV'dV#VPV4GRjxL #L'L5i)aServer entry point that handles task routing. This allows ANY Tool subclass to support background execution by setting task_config.mode to "supported" or "required". The server calls this method instead of run() directly. Args: arguments: Tool arguments task_meta: If provided, execute as background task and return CreateTaskResult. If None (default), execute synchronously and return ToolResult. Returns: ToolResult when task_meta is None. CreateTaskResult when task_meta is provided. Subclasses can override this to customize task routing behavior. For example, FastMCPProviderTool overrides to delegate to child middleware without submitting to Docket. )check_background_taskrm) component task_typerrN)fastmcp.server.tasks.routingrr)rYrrr task_results&&& r1rr>sM2 G1    XXi((( )s$AA AAAAAc V^8dQhRRRR/#)r+docketr#r-rr/)r0s"r1r2rxds4464d4r3c VPP4'gR#VPVPVP.R7R#)z8Register this tool with docket for background execution.N)names) task_configsupports_tasksregisterrkey)rYrs&&r1register_with_docketTool.register_with_docketds4..00  3r3fn_keytask_keyc 0V^8dQhRRRRRRRRRR R R /#) r+rr#rrrrrkwargsrr-r$r/)r0s"r1r2rxjsNAAA"A  A  AA Ar3c "T;'g VPpV'dWER&VP!V3/VB!V4GRjxL #L5i)a-Schedule this tool for background execution via docket. Args: docket: The Docket instance arguments: Tool arguments 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() rN)radd)rYrrrrr lookup_keys&&&$$, r1 add_to_docketTool.add_to_docketjsA$''txx $5MZZ 5f5i@@@@sA AAAtransform_args transform_fncHV^8dQhRRRRRRRRRR R R R R RRRR RRRRRR/ #)r+rmTool | Callable[..., Any]rzrrzstr | NotSetT | Noner<rrrz ToolAnnotations | NotSetT | NonerprrrrrBrzdict[str, ArgTransform] | NonerzCallable[..., Any] | Noner-r(r/)r0s"r1r2rxs  '   $  *   6 7 4 . 7 0   r3c  j^RIHp VPV4pV P!VV VVV VVVVVV R7 #)r)r() rmrrzrrr<rrrprrrB)fastmcp.tools.tool_transformr( _ensure_tool from_tool) rrmrzrr<rrrprrrBrrr(s &&$$$$$$$$$$ r1rTool.from_toolsL A%((%)##'!  r3c V^8dQhRRRR/#)r+rmrr-rr/)r0s"r1r2rxs ' ' 9 'd 'r3c \V\4'dV#^RIHp^RIHpHpV!V4p\WT4'dVP!WR7#VPV4#)zCCoerce a callable into a Tool, respecting @tool decorator metadata.)get_fastmcp_meta)r&ToolMeta)metadata)rMrfastmcp.decoratorsrrr&rr)rrmrr&rfmetas&& r1rTool._ensure_toolsS dD ! !K7F & e & &--dC C  &&r3cV^8dQhRR/#)r+r-rr/)r0s"r1r2rxs  ^ r3c 6<\SV`4RRRR/,#)zfastmcp.component.typermzfastmcp.provider.type LocalProvider)rWget_span_attributes)rYr\s&r1rTool.get_span_attributess'w*, $f #_0   r3r/r)rVrerfrg__doc__rnrhrprrqrrrsrtrr{r classmethodrrrrr rrrrrrrirjrks@r1rrsE* &J &              '"#  4&  & %) & ! & #'& $(& !%& /3& *.& :@& 7;& '+& *.& !%!& "48#& & P E, \ )) $)L4 A " A $ A.   '-  -3  !% 9? :@ 7; 17 :> 37  B ' '  r3rc$V^8dQhRRRRRR/#)r+rFrrrrr-r.r/)r0s"r1r2r2s$ & &  &< & &r3cVe V!V4#\V4# \d#p\PRTRR7Rp?L3Rp?ii;i)Nz!Error serializing tool result: %sT)exc_info) ExceptionrRwarningr9)rFrrr[s&& r1_serialize_with_fallbackrsX f% % f %%  NN3    s AAAc$V^8dQhRRRRRR/#)r+rrrrrr-r r/)r0s"r1r2r2s+UU U/UUr3c\V\4'dV#\V\4'dVP4#\V\4'dVP 4#\V\ 4'dVP4#\V\4'd\RVR7#\R\W4R7#)textrUr) rMr rto_image_contentrto_audio_contentrto_resource_contentr.rr)rrrs&&r1 _convert_to_single_content_blockrs$ %% $$$&&$$$&&$''))$T22 F)A$)S TTr3z[Rendered Prefab UI]c V^8dQhRRRR/#)r+apprr-r;r/)r0s"r1r2r2s r3cX\\R\R7.VP4R7#)z,Convert a PrefabApp to a FastMCP ToolResult.rrr)r;r_PREFAB_TEXT_FALLBACKr7)rs&r1rrs& &/DEF;;= r3c$V^8dQhRRRRRR/#)r+rFrrrrr-r=r/)r0s"r1r2r2s+YY Y/YYr3cVf.#\V\\,4'g \W4.#\;QJdRV4F 'dK RM RM !RV44'dV#\ ;QJdRV4F 'gK RM RM !RV44'd4VUu.uF&p\V\ 4'g \W!4MTNK( up#\R\W4R7.#uupi)z2Convert a result to a sequence of content objects.c3B"TFp\V\4xK R#5irrrs& r1r&_convert_to_content..s =fd:dL ) )frFTc3"TF6p\V\\,\,\,4xK8 R#5ir)rMr rrrrs& r1rrs) TVT:dL50584? @ @Vs>Arr) rMrrrallrr rr)rFrrrs&& r1rKrKs ~ fte| - -0DEE s =f =sss =f ===  s TV Tsss TV TTT   dL11 -T >     V*B6*V W XX s.,C4c V^8dQhRRRR/#)r+rzr.r-rr/)r0s"r1r2r2 sKKcKcKr3cRRRRRR/pW9dS^RIpVPP'd"\P!RV R2\ ^R7^RIHp\W04#\R \: R V: 24h) z2Deprecated re-exports for backwards compatibility.r&ParsedFunctionrmNz Importing zX from fastmcp.tools.tool is deprecated. Import from fastmcp.tools.function_tool instead.) stacklevel) function_toolzmodule z has no attribute ) fastmcpsettingsdeprecation_warningswarningswarnDeprecationWarning fastmcp.toolsr getattrAttributeErrorrV)rzdeprecated_exportsr r s& r1 __getattr__r s *  !    0 0 0 MMTF#CD"   0}++ 78,.@I JJr3r)N__conditional_annotations__ __future__rrcollections.abcrtypingrrrrr r mcp.typesmcpr6mcp.shared.tool_name_validationr r r rrrrrrpydanticrrrpydantic.json_schemar!fastmcp.server.auth.authorizationrfastmcp.server.tasks.configrrfastmcp.utilities.componentsrfastmcp.utilities.loggingrfastmcp.utilities.typesrrrrr prefab_ui.appr!rNprefab_ui.components.baser"rOrL ImportErrorrr#docket.executionr$rr&rr'r(rVrRr.r)rhr9r;rrrrrK__all__r)rs@r1r+s""$G&66/7<905GK*8J H '/ucz&:):>B5B5Jm m ` & U,/Y: < KyKsD DD