+ Q(iv@Rt^RIHt^RIt^RIt^RIHtHtHtH t ^RI t ^RI H t ]'d ^RIt^RIHtHt^RIHt^RIHt^RIHt^R IHt^R IHt^R IHt^R IHt^R I H!t!^RI"H#t#]!]$4t%] ] PLPN] PLP ,,t(!RR4t)RRRllt*R#)z(Tool-related methods for FastMCP Client.) annotationsN) TYPE_CHECKINGAnyLiteraloverload) RootModel)CallToolResultClient)ProgressHandler)ToolTask) client_span) ToolError)inject_trace_context)json_schema_to_type) get_logger)normalize_timeout_to_timedelta)get_cached_typeadapterc]tRt^ tRtRR/RRlltRRltR RR lltR!R R llt] R"R RRRRRRRRRRR /RRlll4t ] R"R RRRRRRRRRRRRR/RRlll4t R"R RRRRRRRRRRR RRRR/RRlllt R#RRllt Rt R#)$ClientToolsMixinz0Mixin providing tool-related methods for Client.cursorNc$V^8dQhRRRRRR/#)selfr r str | Nonereturnzmcp.types.ListToolsResult)formats"a/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/fastmcp/client/mixins/tools.py __annotate__ClientToolsMixin.__annotate__%s$!+ "c "\PRVP R24VPVPP VR74GRjxL pV#L5i)aSend a tools/list request and return the complete MCP protocol result. Args: cursor: Optional pagination cursor from a previous request's nextCursor. Returns: mcp.types.ListToolsResult: The complete response object from the protocol, containing the list of tools and any additional metadata. Raises: RuntimeError: If called while the client is not connected. McpError: If the request results in a TimeoutError | JSONRPCError [z] called list_toolsrN)loggerdebugname_await_with_session_monitoringsession list_tools)rrresults&$ rlist_tools_mcpClientToolsMixin.list_tools_mcp%sW  q #678:: LL # #6 # 2    sAAAAc V^8dQhRRRR/#)rrr rzlist[mcp.types.Tool]r)rs"rrr<s  v *> r c ".pRp\4pVPVR7GRjxL pVPVP4VP'gV#VPV9d5\ P RVP RVP: R24V#VPVP4VPpKL5i)aRetrieve all tools available on the server. This method automatically fetches all pages if the server paginates results, returning the complete list. For manual pagination control (e.g., to handle large result sets incrementally), use list_tools_mcp() with the cursor parameter. Returns: list[mcp.types.Tool]: A list of all Tool objects. Raises: RuntimeError: If called while the client is not connected. McpError: If the request results in a TimeoutError | JSONRPCError Nr#r"z.] Server returned duplicate pagination cursor z$ for list_tools; stopping pagination) setr+extendtools nextCursorr$warningr&add)r all_toolsr seen_cursorsr*s& rr)ClientToolsMixin.list_tools<s+- !!$ ..f.==F   V\\ *$$$  L0 {#)),,PR   V.. /&&F>s%C C 0C A2C c4V^8dQhRRRRRRRRR R R R R R/#)rrr r&str argumentszdict[str, Any]progress_handlerProgressHandler | Nonetimeout'datetime.timedelta | float | int | Nonemetadict[str, Any] | Nonermcp.types.CallToolResultr)rs"rrr`sN3333"31 3 9 3 $ 3 "3r c "\RV 2RVVPP4R7;_uu_4\P RVP RV 24\ V4pTPVPPTT\V4T;'g VPV'dTMRR74GRjxL pVuuRRR4#L +'giR#;i5i)aSend a tools/call request and return the complete MCP protocol result. This method returns the raw CallToolResult object, which includes an isError flag and other metadata. It does not raise an exception if the tool call results in an error. Args: name (str): The name of the tool to call. arguments (dict[str, Any]): Arguments to pass to the tool. timeout (datetime.timedelta | float | int | None, optional): The timeout for the tool call. Defaults to None. progress_handler (ProgressHandler | None, optional): The progress handler to use for the tool call. Defaults to None. meta (dict[str, Any] | None, optional): Additional metadata to include with the request. This is useful for passing contextual information (like user IDs, trace IDs, or preferences) that shouldn't be tool arguments but may influence server-side processing. The server can access this via `context.request_context.meta`. Defaults to None. Returns: mcp.types.CallToolResult: The complete response object from the protocol, containing the tool result and any additional metadata. Raises: RuntimeError: If called while the client is not connected. McpError: If the tool call requests results in a TimeoutError | JSONRPCError z tools/call z tools/call) session_idr"z] called call_tool: N)r&r:read_timeout_secondsprogress_callbackr?) r transportget_session_idr$r%r&rr'r( call_toolr_progress_handler)rr&r:r;r=r?propagated_metar*s&&&&&& r call_tool_mcpClientToolsMixin.call_tool_mcp`s>$  ~~446   LL1TYYK';D6B C348O>> &&')G)P&6&P&P$:P:P,; 'F)     s53C&A9C/C?CC C&C C#  C&Fc ,V^8dQhRRRRRRRRR R /#) rrr r&r9r*rAraise_on_errorboolrrr)rs"rrrs:    )     r c "\VVVPPVPPVPVR7GRjxL #L5i)aParse an mcp.types.CallToolResult into our CallToolResult dataclass. Args: name: Tool name (for schema lookup) result: Raw MCP protocol result raise_on_error: Whether to raise ToolError on errors Returns: CallToolResult: Parsed result with structured data )r&r*tool_output_schemas list_tools_fn client_namerNN)_parse_call_tool_resultr(_tool_output_schemasr)r&)rr&r*rNs&&&&rrT(ClientToolsMixin._parse_call_tool_resultsH"- $ A A,,11 )     sAA A Aversionr=r;rNTr?taskc@V^8dQhRRRRRRRRR R R R R RRRRRRR/ #)rrr r&r9r:r@rWrr=r>r;r<rNrOr?rXzLiteral[False]rrr)rs"rrrsl    )    9 1  $    r c "R#5iNr) rr&r:rWr=r;rNr?rXs &&&$$$$$$rrHClientToolsMixin.call_tools task_idttl`cHV^8dQhRRRRRRRRR R R R R RRRRRRRRRRR/ #)rrr r&r9r:r@rWrr=r>r;r<rNrOr?rXz Literal[True]r^r_intrr r)rs"rrrs    )    9 1  $      r c "R#5ir[r) rr&r:rWr=r;rNr?rXr^r_s &&&$$$$$$$$rrHr\s r]cHV^8dQhRRRRRRRRR R R R R RRRRRRRRRRR/ #)rrr r&r9r:r@rWrr=r>r;r<rNrOr?rXr^r_rbrzCallToolResult | ToolTaskr)rs"rrrsE E E E )E  E 9 E 1E E $E E E E  #E r c t"V'd \V4M/p Ve/V PR/4CRV/CV R&V'd'TPYYT ;'gRR7GRjxL #TPTT;'g/TTT ;'gRR7GRjxL p VP WVR7GRjxL #LQL!L5i)aCall a tool on the server. Unlike call_tool_mcp, this method raises a ToolError if the tool call results in an error. Args: name (str): The name of the tool to call. arguments (dict[str, Any] | None, optional): Arguments to pass to the tool. Defaults to None. version (str | None, optional): Specific tool version to call. If None, calls highest version. timeout (datetime.timedelta | float | int | None, optional): The timeout for the tool call. Defaults to None. progress_handler (ProgressHandler | None, optional): The progress handler to use for the tool call. Defaults to None. raise_on_error (bool, optional): Whether to raise an exception if the tool call results in an error. Defaults to True. meta (dict[str, Any] | None, optional): Additional metadata to include with the request. This is useful for passing contextual information (like user IDs, trace IDs, or preferences) that shouldn't be tool arguments but may influence server-side processing. The server can access this via `context.request_context.meta`. Defaults to None. task (bool): If True, execute as background task (SEP-1686). Defaults to False. task_id (str | None): Optional client-provided task ID (auto-generated if not provided). ttl (int): Time to keep results available in milliseconds (default 60s). Returns: CallToolResult | ToolTask: The content returned by the tool if task=False, or a ToolTask object if task=True. If the tool returns structured outputs, they are returned as a dataclass (if an output schema is available) or a dictionary; otherwise, a list of content blocks is returned. Note: to receive both structured and unstructured outputs, use call_tool_mcp instead and access the raw result object. Raises: ToolError: If the tool call results in an error. McpError: If the tool call request results in a TimeoutError | JSONRPCError RuntimeError: If called while the client is not connected. NfastmcprW)r?)r&r:r=r;r?)rN)dictget_call_tool_as_taskrKrT) rr&r:rWr=r;rNr?rXr^r_ request_metar*s &&&$$$$$$$$ rrHr\s`&*tDzr  '""9b1'7'L # 00L4H4HD1 ))oo2-%% *  11 2     sL"\V4p\PP\PP TT;'g/\PP VR7VR7R7pVP VPPV\R74GRjxL pVPp \V \PP4'deV PPp VPP!V 4\#W VRR7p \$P&!V 4VP(V &V #VP+W4GRjxL p T;'g\-\.P0!44p \#VV VV R7#LL=5i)aCall a tool for background execution (SEP-1686). Returns a ToolTask object that handles both background and immediate execution. If the server accepts background execution, ToolTask will poll for results. If the server declines (graceful degradation), ToolTask wraps the immediate result. Args: name: Tool name to call arguments: Tool arguments task_id: Optional client-provided task ID (ignored, for backward compatibility) ttl: Time to keep results available in milliseconds (default 60s) meta: Optional request metadata (e.g., version info) Returns: ToolTask: Future-like object for accessing task status and results )r_)r&r:rX_meta)params)request result_typeN) tool_nameimmediate_result)rmcptypesCallToolRequestCallToolRequestParams TaskMetadatar'r( send_requestToolTaskResponseUnionroot isinstanceCreateTaskResultrXtaskId_submitted_task_idsr4r weakrefref_task_registryrTr9uuiduuid4)rr&r:r^r_r?rJrowrapped_result raw_resultserver_task_idtask_obj parsed_resultsynthetic_task_ids&&&&&& rri#ClientToolsMixin._call_tool_as_taskse4/t4))++9922#//rYY+++4% 3,  $BB LL % %1 &    $(( j#))"<"< = ='__33N  $ $ ( ( 8tH3:++h2GD   /O#'">">t"PPM ' < <3tzz|+< !!.  - (Qs+B(F*F+B2FF F+/FFr)NNN)Fr[)NNr`N) __name__ __module__ __qualname____firstlineno____doc__r+r)rKrTrrHri__static_attributes__rr rrr sA:.2. H3j 4  #  <@ 48  $ '+  %    #  <@ 48  $ '+ #   E # E <@ E 48E  $E '+E E #E E E NCCr rc4V^8dQhRRRRRRRRR R R R R R/#)rr&r9r*rArQz dict[str, dict[str, Any] | None]rRrrSrrNrOrrr)rs"rrrZsN;; ; $;:; ;  ;  ;;r c"^RIHp^RIHpRpVP'dPV'dHV!\ P PVP^,4Pp \V 4hVP'dW9dV!4GRjxL W9dVPV4p V 'dV PR4'd>V PR/4PR4p VPPR4p M VPp \V 4p \V 4p V PV 4pM VPpV!VPVPVP&VVPR 7#L \ d0p\"P%RT;'gR R T 24Rp?LlRp?ii;i5i) aParse an mcp.types.CallToolResult into our CallToolResult dataclass. Args: name: Tool name (for schema lookup) result: Raw MCP protocol result tool_output_schemas: Dictionary mapping tool names to their output schemas list_tools_fn: Async function to refresh tool schemas if needed client_name: Optional client name for logging raise_on_error: Whether to raise ToolError on errors Returns: CallToolResult: Parsed result with structured data )cast)rNzx-fastmcp-wrap-result propertiesr*r"clientz$] Error parsing structured content: )contentstructured_contentr?datais_error)typingrfastmcp.client.clientrisErrorrsrt TextContentrtextr structuredContentrhrrvalidate_python Exceptionr$errorr?)r&r*rQrRrSrNrrrmsg output_schemar output_type type_adapteres&&&&&& rrTrTZs*4 D ~~~.399((&..*;<AAn  ! ! ! .#o%%* 3 7 7 =  $(()@AA(5(9(9,(K(O(O$) .4-E-E-I-I(-S*-3-E-E*"5m"DK#9+#FL'778JKD!33D !33 [[   +&   LLK++8,,PQRPST   s`(GAGFF"F9FA0FG F 5GF F>%F94G9F>>G)NF)+r __future__rrrrrrrr mcp.typesrspydanticrdatetimerrr fastmcp.client.progressr fastmcp.client.tasksr fastmcp.client.telemetryr fastmcp.exceptionsr fastmcp.telemetryr"fastmcp.utilities.json_schema_typerfastmcp.utilities.loggingrfastmcp.utilities.timeoutrfastmcp.utilities.typesrrr$rtr|ryrrTrr rrs." 88<3)0(2B0D: H "#))"<"