"j$SSKrSSKJr SSKJr SSKJr SSKJr SSK J r J r \S\ \S\ \4-rS \ S-S \S \4S jrg) N)Literal) assert_never) UserError)ModelRequestParameters) ModelSettings ToolOrOutput)noneautorequired)r r model_settingsmodel_request_parametersreturnc>^^ U=(d 0RS5nTR=(d TRn[TRR 55m SS.S[[ S[S[[ 4U U4SjjjnS[[ S[[ S [ SS 4S jnUS ;a U(aS $S$US/4;a^TRVs1sHofRiM nnU(a#U(aS nX4$TR(aSnX4$gU(agS5eUS:XaLTR(d [S5e[U4SjTR55(a [S5eg[U[5(a&[U5n U"U T SS9 U"U 5n U T :XagSU 4$[U[5(aTRVs1sHofRiM nnUR(dU(aU(aS OSnX4$g[UR5n TRVs1sHofRiM n nU"U U SS9 U"U [U5S9n X-n U(aS OSnU T :XaU$X4$[!U5 g s snfs snfs snf)aResolve user-facing tool_choice into a canonical form for providers. Pydantic AI distinguishes between function tools (e.g. user-registered via @agent.tool) and output tools (framework-internal for structured output). The user-facing `tool_choice` setting controls function tools only - this function resolves that into a canonical form that providers can use, incorporating output tools as needed. Args: model_settings: Optional settings containing the tool_choice value. model_request_parameters: Parameters describing available tools and output configuration. Input behavior: - `None` / `'auto'`: Returns `'auto'` if direct output allowed, else `'required'`. - `'none'` / `[]`: Disables function tools. If output tools exist, returns them with appropriate mode. Otherwise returns `'none'`. - `'required'`: Requires function tool use. Raises if no function tools are defined. - `list[str]`: Restricts to specified tools with `'required'` mode. Validates tool names. - `ToolOrOutput`: Combines specified function tools with all output tools. Returns `'auto'` mode if direct output is allowed, otherwise `'required'`. Raises: UserError: If tool_choice is incompatible with the available tools or output configuration. Returns: A canonical tool_choice value for providers: - `'none'`: No tools should be called. Only valid when direct output (text/image) is allowed. - `'auto'`: Model chooses whether to use tools. Direct output is allowed. - `'required'`: Model must use a tool. Direct output is not allowed. - `('auto', tool_names)`: Only these tools are available, direct output is allowed. - `('required', tool_names)`: Only these tools are available, must use one. tool_choiceF)has_output_fallbackchosen_tool_namesrrc>TRVs1sH0nTRUR5S:XdM$URiM2 nnX- nU(a)UT-(dU(d[S[ U5S35eU$s snf)Nwithheldz1No tool in `tool_choice` is currently available: zu. Hidden tools must be revealed with tool search, `load_capability`, or `ToolReturn.tools` before they can be forced.)function_tools visibility_ofnamersorted)rrtoolwithheld_tool_namesfilteredknown_tool_namesr s \/home/mande/repo/quber/.venv/lib/python3.13/site-packages/pydantic_ai/models/_tool_choice.py_filter_withheld_tools3resolve_tool_choice.._filter_withheld_tools<s1?? ?'55dii@JN DII?  %: h1A&AK^CFK\D]C^_@@  # s #A?A? known_tools known_labelNc X- nU(dgX0:Xa[SUSUSU=(d S35e[R"S[U5SUS[U53[SS9 g)Nz%Invalid tool names in `tool_choice`: z. z: r zMSome tools in `tool_choice` are not currently available and will be ignored: ) stacklevel)rwarningswarnr UserWarning)rr r!invalids r_check_invalid_tools1resolve_tool_choice.._check_invalid_toolsUsw#1   'CG9B{m[]^i^sms]tuv v  [gr+b 1D0E G   )Nr r r r zGEither output_tools or allow_text_output/allow_image_output must be setz`tool_choice` was set to "required", but no function tools are defined. Please define function tools or change `tool_choice` to "auto" or "none".c3`># UH#nTRUR5S:Hv M% g7f)rN)rr).0rr s r &resolve_tool_choice..s, ? % 2 2499 = K?s+.z`tool_choice` was set to "required", but every function tool is hidden until revealed. Reveal tools with tool search, `load_capability`, or `ToolReturn.tools`, or change `tool_choice`.z Known tools)r!zKnown function tools)getallow_text_outputallow_image_outputset tool_defskeysstrbool output_toolsrrrall isinstancelistrr)r r function_tool_choiceallow_direct_outputrr)toutput_tool_namesmode chosen_setchosen_function_setknown_function_tool_names allowed_toolsrs ` @rresolve_tool_choicerE sJ+0b55mD2DDsH`HsHs 3==BBDE[`#c(TXehilem2 C s3x ad im $~-,v<*< &" --E-R-RS-RVV-RS "4: , , *88!, ,"  `__u  +'66\   0??   +   ($ / /-. Z)9}U,J7 ) )J'' (, 7 7-E-R-RS-RVV-RS#22 >QFWa00!"6"E"EF5M5\5\$]5\VV5\!$]  %. 55H^bct^uv+? 6IFz , ,K$$)*[TjT%^sJJ;J)r%typingrtyping_extensionsrpydantic_ai.exceptionsrpydantic_ai.modelsrpydantic_ai.settingsrrtupler3r6ResolvedToolChoicerEr+rrNsg*,5<785I[A\^abe^fAf;ggl+!D(l+4l+l+r+