Cj%SSKJr SSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK J r J r J r SSKJrJr SSKJr SSKJr SSKJrJrJrJrJrJrJrJrJrJrJrJ r J!r!J"r" SSK#J$r$ SS K%J&r&J'r' SS K(J)r)J*r* SS K+J,r,J-r- SS K.J/r/J0r0J1r1 SS K2J&r3 SSK4J5r5 SSK6J7r7J8r8J9r9J:r: SSK;Jr> SSK?J@r@ SSKAJBrBJCrCJDrDJErE SSKFJGrGJHrH SSKIJJrJJKrK SSKLJMrMJNrNJOrO SSKPJQrQJPrP SSKRJRrR SSKSJTrT SSKUJVrV SSKWJXrX SSKYJZrZJ[r[ SSK\J]r] SSK^J_r_ SSK`Jara \(aSS KbJcrcJdrd SS!KeJfrfJgrg \="S"5rh\ \h\4ri\ \\T\\h4\4rj\ \\X\h4\4rk\i\h\j\h-\k\h-rlS#rm\S$rn\ \T\\o/\a\p4rq\ \X\\p/\a\4rr\ \T\\p\p/\a\s4rtS%ru\v"5rw"S&S'\75rx"S(S)\>S*S+9ry"S,S-\75rz"S.S/\>S*S+9r{"S0S1\75r|"S2S3\>S*S+9r}\x\z-\|-r~\8"\~5rS4\S5'"S6S7\p\5r\"S8S99"S:S;55r\H\G-r\"S<\S=9r\"S>\S8S?9r\"S@\S8SA9r"SBSC\\5r"SDSE\\5r\"SFSG\\55r\\\-\\-r\"SHSI55r\"SJSK55r"SLSM5rSSNjr\wS8S8SSS*SSOSS*S*SSSP. SSQjjrSSRjr\"SSST55r\"SUSV55r\"S*SW9"SXSY\\55r\"SZS[55r\ GR*"5rS\\S]'\ GR*"5rS^\S_'\ GR*"5rS`\Sa'SSbjrSScjr\"SdSe55r\"SfSg55r"ShSi\>5r\ \/\a\4r\ \T\Sj\p/\a\s4r"SkSl\>5r\ \T\Sm/\a\4r\ \T\\K\p/\a\s4r"SnSo\>5r\ \T\Sm/\a\4r"SpSq\>5r\ \T\Sm/\a\4r\"SrSs55r\"StSu55r\"SvSw55r\"SxSy55r\ \/\a\p4r\"SzS{55r"S|S}\>5r"S~S\>5r"SS\>5r"SS\>5r\\-r"SS\>5r"SS\>5r"SS\>5r\\-r"SS\>5r"SS\>5r"SS\>5r\\-r\\-r\"SS55r\"SS55r\"SS55r\"SSj55r\"SS55r\"SS55r\ \/\a\p\-4rSSjr\"SS55r\"SS55r\"SS55r\"SS55r\\-\-\\-\-\-\-\-\-\-\-\-rSSjrSSjrSSjrSSjrSSjrSSjrSSjrSSjrS*S.SSjjrSSjrSSjrSSjrSS8S8S.SSjjrSSjrSSjrSSjrS$rS\S'SSjr\w4SSjjrSSjr"SS\o5rSSjrSSjrSSjrSSjrSSjrSSjrSSjrSSjr\"SSSS8SS8S8S*SSSSOSS*S.SSjj5r\"SSSS8SS8S8S*SSSSOSS*S.SSjj5rSSSSS8\wS8S8S*SSSSOSS*S.SSjjjrSSjrSSjrSSjrSSjrSSjrg)) annotationsN) AwaitableCallableMapping) dataclassfield)Enum) UnionType) TYPE_CHECKING AnnotatedAny ConcatenateGenericLiteralProtocolTypeVarUnioncastget_args get_originget_type_hintsoverload)CustomToolParam)FiltersRankingOptions)PendingSafetyCheckResponseComputerToolCall)LocalShellCallMcpApprovalRequest)CodeInterpreterImageGenerationMcp)r) UserLocation) BaseModel TypeAdapterValidationErrormodel_validator) NotRequired ParamSpec TypedDict)_debug)$get_explicit_function_tool_namespacetool_qualified_name+validate_function_tool_lookup_configuration&validate_function_tool_namespace_shape) AsyncComputerComputer)ApplyPatchEditorApplyPatchOperation)ModelBehaviorErrorToolTimeoutError UserError)DocstringStylefunction_schema)logger)RunContextWrapper)ensure_strict_json_schema) ToolContext)ToolInputGuardrailToolOutputGuardrail) SpanError)_error_tracing)MaybeAwaitable)Agent AgentBase)RunItemToolApprovalItem ToolParamsz Tool execution was not approved.)error_as_resultraise_exception__agents_sync_function_tool__c2\rSrSr%SrSrS\S'S\S'Srg) ToolOutputText[zBRepresents a tool output that should be sent to the model as text.textLiteral['text']typestrN)__name__ __module__ __qualname____firstlineno____doc__rP__annotations____static_attributes__rR]/home/rurouni/.local/share/pipx/venvs/strix-agent/lib/python3.13/site-packages/agents/tool.pyrLrL[sL"D/" IrZrLc.\rSrSr%SrS\S'S\S'Srg) ToolOutputTextDictbz(TypedDict variant for text tool outputs.rOrPrQrNrRNrSrTrUrVrWrXrYrRrZr[r]r]bs2  IrZr]F)totalcn\rSrSr%SrSrS\S'SrS\S'SrS\S 'Sr S \S '\ "S S 9SSj5r Sr g)ToolOutputImageizRepresents a tool output that should be sent to the model as an image. You can provide either an `image_url` (URL or data URL) or a `file_id` for previously uploaded content. The optional `detail` can control vision detail. imageLiteral['image']rPN str | None image_urlfile_idz%Literal['low', 'high', 'auto'] | NonedetailaftermodecPURcURc [S5eU$)z?Validate that at least one of image_url or file_id is provided.z5At least one of image_url or file_id must be provided)rgrh ValueErrorselfs r[!check_at_least_one_required_field1ToolOutputImage.check_at_least_one_required_fieldus( >> !dll&:TU U rZrR)returnrb) rSrTrUrVrWrPrXrgrhrir'rqrYrRrZr[rbrbisJ %D $ Iz GZ48F 18'"#rZrbcB\rSrSr%SrS\S'S\S'S\S'S\S 'S rg ) ToolOutputImageDict}z)TypedDict variant for image tool outputs.rerPNotRequired[str]rgrhz+NotRequired[Literal['low', 'high', 'auto']]rirRNr_rRrZr[ruru}s3   77rZruc|\rSrSr%SrSrS\S'SrS\S'SrS\S 'Sr S\S 'Sr S\S '\ "S S 9SSj5r Sr g)ToolOutputFileContentzRepresents a tool output that should be sent to the model as a file. Provide one of `file_data` (base64), `file_url`, or `file_id`. You may also provide an optional `filename` when using `file_data` to hint file name. fileLiteral['file']rPNrf file_datafile_urlrhfilenamerjrkcjURc%URcURc [S5eU$)zJValidate that at least one of file_data, file_url, or file_id is provided.z@At least one of file_data, file_url, or file_id must be provided)r}r~rhrnros r[rq7ToolOutputFileContent.check_at_least_one_required_fields1 >> !dmm&; @T_` ` rZrR)rsry)rSrTrUrVrWrPrXr}r~rhrr'rqrYrRrZr[ryrysR #D/" Iz HjGZHj'"#rZrycL\rSrSr%SrS\S'S\S'S\S'S\S'S\S 'S rg ) ToolOutputFileContentDictz0TypedDict variant for file content tool outputs.r|rPrwr}r~rhrrRNr_rRrZr[rrs#:  rZrz*TypeAdapter[ValidToolOutputPydanticModels](ValidToolOutputPydanticModelsTypeAdapterc$\rSrSrSrSrSrSrSrg)ToolOriginTypezAEnumerates the runtime source of a function-tool-backed run item.functionmcp agent_as_toolrRN) rSrTrUrVrWFUNCTIONMCP AGENT_AS_TOOLrYrRrZr[rrsKH C#MrZrT)frozencl\rSrSr%SrS\S'SrS\S'SrS\S'SrS\S 'S S jr \ SS j5r S r g) ToolOriginzMSerializable metadata describing where a function-tool-backed item came from.rrPNrfmcp_server_name agent_nameagent_tool_namecSURR0nURbURUS'URbURUS'URbURUS'U$)z/Convert the metadata to a JSON-compatible dict.rPrrr)rPvaluerrr)rpresults r[ to_json_dictToolOrigin.to_json_dictsk"($))//!:    +(,(<(TRU5n[U[5(aU$S$N)get isinstancerQ)keyrdatas r[_optional_string3ToolOrigin.from_json_dict.._optional_strings'HHSME&uc225 < ?' 5,->?     s A.. A;:A;rR)rszdict[str, str])rr rsToolOrigin | None) rSrTrUrVrWrXrrrr classmethodrrYrRrZr[rrsBW "&OZ&!J !"&OZ&   rZr ComputerT)bound ComputerT_co)r covariantComputerT_contra)r contravariantc"\rSrSrSrSSjrSrg)ComputerCreatez3Initializes a computer for the current run context.cgrrR)rp run_contexts r[__call__ComputerCreate.__call__s`crZrRN)rRunContextWrapper[Any]rszMaybeAwaitable[ComputerT_co]rSrTrUrVrWrrYrRrZr[rrs=crZrc.\rSrSrSrSSjrSrg)ComputerDisposez3Cleans up a computer initialized for a run context.cgrrR)rprcomputers r[rComputerDispose.__call__s #rZrRN)rrrrrszMaybeAwaitable[None]rrRrZr[rrs(=#,## #  #rZrc2\rSrSr%SrS\S'SrS\S'Srg) ComputerProviderzJConfigures create/dispose hooks for per-run computer lifecycle management.zComputerCreate[ComputerT]createNz!ComputerDispose[ComputerT] | NonedisposerR)rSrTrUrVrWrXrrYrRrZr[rrsT %%15G .5rZrc`\rSrSr%S\S'S\S'S\S'\"\S9rS \S 'S rS\S 'S r g )FunctionToolResulti FunctionTooltoolr outputzRunItem | Nonerun_itemdefault_factoryzlist[ToolApprovalItem] interruptionsNagent_run_resultrR) rSrTrUrVrXrlistrrrYrRrZr[rrsA  K! -2$,GM)GC c 6rZrc\rSrSr%SrS\S'S\S'S\S'S\S 'S rS \S 'S rS \S'SrS\S'Sr S\S'Sr S\S'Sr S\S'Sr S\S'Sr S\S'SrS \S'\"SS SS9rS\S '\"S S SS9rS \S!'\"SS SS9rS \S"'\"SS SS9rS \S#'\"SS SS9rS$\S%'\"SS SS9rS&\S''\"SS SS9rS&\S('\"SS SS9rS&\S)'\"SS SS9rS*\S+'\"S S SS9rS \S,'\S1S-j5rS.rS2S/jrS0rg)3rizA tool that wraps a function. In most cases, you should use the `function_tool` helpers to create a FunctionTool, as they let you easily wrap a Python function. rQname descriptiondict[str, Any]params_json_schema1Callable[[ToolContext[Any], str], Awaitable[Any]]on_invoke_toolTboolstrict_json_schemaJbool | Callable[[RunContextWrapper[Any], AgentBase], MaybeAwaitable[bool]] is_enabledN$list[ToolInputGuardrail[Any]] | Nonetool_input_guardrails%list[ToolOutputGuardrail[Any]] | Nonetool_output_guardrailsFObool | Callable[[RunContextWrapper[Any], dict[str, Any], str], Awaitable[bool]]needs_approval float | Nonetimeout_secondsrHToolTimeoutBehaviortimeout_behaviorToolErrorFunction | Nonetimeout_error_function defer_loading)defaultkw_onlyrepr_failure_error_function#_use_default_failure_error_function_is_agent_tool_is_codex_toolr _agent_instancerf_tool_namespace_tool_namespace_description _mcp_titler _tool_origin_emit_tool_origincf[UR[U55=(d UR$)zEReturn the public qualified name used to identify this function tool.)r.rr-ros r[qualified_nameFunctionTool.qualified_names*  +OPT+U V cZ^ZcZc rZc[URSS5n[U5(a U"U5UlUR(a[ UR 5Ul[ U5 g)N__agents_bind_function_tool__)getattrrcallablerr<r&_validate_function_tool_timeout_config)rpbind_to_function_tools r[ __post_init__FunctionTool.__post_init__sV '(;(;=\^b c ) * *"7"=D   " "&?@W@W&XD #.t4rZc [R"U5n[R"[5Vs1sHo"RiM nn[R"[5H?nUR (aM[ XR[XR55 MA URR5HupEXC;dM [ XU5 M U$s snfr) dataclassesreplacefieldsrrinitsetattrr__dict__items)rp copied_tool tool_fielddataclass_field_names attr_name attr_values r[__copy__FunctionTool.__copy__s!))$/ CNCUCUVbCc dCcZCc d%,,\:J K'$2P Q;&*]]%8%8%: !I5 ;&;!esC)rrrsrQ)rsr)rSrTrUrVrWrXrrrrrrrrrrrrrrrrrrrrpropertyrrr rYrRrZr[rrs IX9&&4EE  $#=^bJZa$CG?FMDHAHM W%%)O\(>,=)= 8<4;[M4`8= 95 U05 1' T 5INDID 5INDIH t%HOSHO"'d"OOZOY.3D$UZ.[[V"4EJJ JD&+D$U&SL#SW#D$UKtKY   5 rZrcT\rSrSrSrSS.S SjjrS SjrS SjrSrg) #_FailureHandlingFunctionToolInvokerizOInternal callable that rebinds wrapper error handling for copied FunctionTools.N function_toolc(XlX lX0lgr)_invoke_tool_impl_on_handled_error_function_tool)rpinvoke_tool_implon_handled_errorrs r[__init__,_FailureHandlingFunctionToolInvoker.__init__s"2!1+rZcURULaU$[URURUS9n[ U[ S5(a[ U[ S5 U$)NrFT)rrrrr_SYNC_FUNCTION_TOOL_MARKERr)rpr bound_invokers r[rA_FailureHandlingFunctionToolInvoker.__agents_bind_function_tool__s[   - /K;  " "  " "' 43U ; ; M#=t DrZc# URX5IShvN $N![aYnURce[URUUS9IShvN nUceUR URX25 UsSnA$SnAff=f7f)N)rcontexterror)r Exceptionr1maybe_invoke_function_tool_failure_error_functionr)rpctxinputers r[r,_FailureHandlingFunctionToolInvoker.__call__s //;; ;; &&2 22L"11F ~  " "4#6#6 AM sHBB B'A=A&A=7B8B=BB)rrr)rrr.Callable[[FunctionTool, Exception, str], None]rzFunctionTool | NonersNone)rrrsrr&ToolContext[Any]r'rQrsr ) rSrTrUrVrWrrrrYrRrZr[rrsPY.2 ,K ,I , + ,  , )  , rZrc[X5$)zVWrap a tool invoker so copied FunctionTools resolve failure policy against themselves.)r)rrs r[(with_function_tool_failure_error_handlerr/s //? RRrZrH) failure_error_functionrrrrrrrrr sync_invoker mcp_title tool_originc[UU5nU(a[U[S5 [[ UUUUUUUU U U U U UUUS9U5$)zQCreate a FunctionTool with copied-tool-aware failure handling bound in one place.T)rrrrrrrrrrrrrrr)r/rr(set_function_tool_failure_error_functionr)rrrrrr0rrrrrrrrrr1r2r3rs r[_build_wrapped_function_toolr6sm0>N :DA 3#1)1!"7#9)+-#9' $ " % rZczUR(dgUR=(d [[RS9$)z2Return scalar origin metadata for a function tool.NrP)rrrrrrs r[get_function_tool_originr9 s*  * *  % % Q9P9P)QQrZcv\rSrSr%SrS\S'SrS\S'SrS \S 'SrS \S 'Sr S \S'\ S5r Sr g)FileSearchToolizA hosted tool that lets the LLM search through a vector store. Currently only supported with OpenAI models, using the Responses API. list[str]vector_store_idsN int | Nonemax_num_resultsFrinclude_search_resultszRankingOptions | Noneranking_optionszFilters | Nonefilterscg)N file_searchrRros r[rFileSearchTool.name)rZrR) rSrTrUrVrWrXr?r@rArBrrrYrRrZr[r;r;sZ 1"&OZ&2#(D(R-1O*1%"G^"5 rZr;cj\rSrSr%SrSrS\S'SrS\S'SrS \S 'Sr S \S '\ S 5r Sr g) WebSearchTooli.zvA hosted tool that lets the LLM search the web. Currently only supported with OpenAI models, using the Responses API. NzUserLocation | None user_locationzWebSearchToolFilters | NonerBmediumz Literal['low', 'medium', 'high']search_context_sizez bool | Noneexternal_web_accesscg)N web_searchrRros r[rWebSearchTool.nameDrZrR) rSrTrUrVrWrIrXrBrKrLrrrYrRrZr[rHrH.sX*.M&-d+/G (/57> rZrc6\rSrSr%SrS\S'\S5rSrg)CodeInterpreterTooliMzFA tool that allows the LLM to execute code in a sandboxed environment.r rcg)Ncode_interpreterrRros r[rCodeInterpreterTool.nameT!rZrRN rSrTrUrVrWrXrrrYrRrZr[rrMs P  K ""rZrc6\rSrSr%SrS\S'\S5rSrg)ImageGenerationTooliYz.A tool that allows the LLM to generate images.r!rcg)Nimage_generationrRros r[rImageGenerationTool.name`rrZrRNrrRrZr[rrYs 8  ; ""rZrc0\rSrSr%SrS\S'S\S'Srg) LocalShellCommandRequestiez*A request to execute a command on a shell.rrrrrRNr_rRrZr[rres4'' 2rZrc6\rSrSr%SrS\S'\S5rSrg)LocalShellToolitzA tool that allows the LLM to execute commands on a shell. For more details, see: https://platform.openai.com/docs/guides/tools-local-shell LocalShellExecutorexecutorcg)N local_shellrRros r[rLocalShellTool.namerFrZrRNrrRrZr[rrts$ ! 8 rZrc8\rSrSr%SrS\S'S\S'S\S'Srg) ShellToolLocalSkilliz,Skill metadata for local shell environments.rQrrpathrRNr_rRrZr[rrs6 I IrZrc8\rSrSr%SrS\S'S\S'S\S'S rg ) ShellToolSkillReferenceiz"Reference to a hosted shell skill.zLiteral['skill_reference']rPrQskill_idrwversionrRNr_rRrZr[rrs, $$M rZrc8\rSrSr%SrS\S'S\S'S\S'S rg ) ShellToolInlineSkillSourceizInline skill source payload.rQrzLiteral['application/zip'] media_typezLiteral['base64']rPrRNr_rRrZr[rrs& I** rZrcB\rSrSr%SrS\S'S\S'S\S'S\S 'S rg ) ShellToolInlineSkilliz!Inline hosted shell skill bundle.rQrrrsourcezLiteral['inline']rPrRNr_rRrZr[rrs+ I && rZrc8\rSrSr%SrS\S'S\S'S\S'Srg) +ShellToolContainerNetworkPolicyDomainSecretiz4A secret bound to a single domain in allowlist mode.rQdomainrrrRNr_rRrZr[rrs> K I JrZrc8\rSrSr%SrS\S'S\S'S\S'S rg ) (ShellToolContainerNetworkPolicyAllowlistiz/Allowlist network policy for hosted containers.r<allowed_domainszLiteral['allowlist']rPz>NotRequired[list[ShellToolContainerNetworkPolicyDomainSecret]]domain_secretsrRNr_rRrZr[rrs9 RRrZrc$\rSrSr%SrS\S'Srg)'ShellToolContainerNetworkPolicyDisablediz.Disabled network policy for hosted containers.zLiteral['disabled']rPrRNr_rRrZr[rrs 8 rZrc.\rSrSr%SrS\S'S\S'Srg) ShellToolLocalEnvironmentiz"Local shell execution environment.zLiteral['local']rPz&NotRequired[list[ShellToolLocalSkill]]skillsrRNr_rRrZr[rrs,  22rZrcL\rSrSr%SrS\S'S\S'S\S'S \S 'S \S 'S rg)!ShellToolContainerAutoEnvironmentiz.Auto-provisioned hosted container environment.zLiteral['container_auto']rPzNotRequired[list[str]]file_idsz5NotRequired[Literal['1g', '4g', '16g', '64g'] | None] memory_limitz,NotRequired[ShellToolContainerNetworkPolicy]network_policyz*NotRequired[list[ShellToolContainerSkill]]rrRNr_rRrZr[rrs#8 ##$$GG@@ 66rZrc.\rSrSr%SrS\S'S\S'Srg) &ShellToolContainerReferenceEnvironmentiz*Reference to an existing hosted container.zLiteral['container_reference']rPrQ container_idrRNr_rRrZr[rrs4 ((rZrc2\rSrSr%SrS\S'SrS\S'Srg) ShellCallOutcomeiz4Describes the terminal condition of a shell command.zLiteral['exit', 'timeout']rPNr> exit_coderR)rSrTrUrVrWrXrrYrRrZr[rrs> $$ Iz rZrc\rSrSr%SrSrS\S'SrS\S'\"SS9r S \S 'S r S \S 'S r S\S'\ SSj5r \ SSj5rSrg )ShellCommandOutputiz7Structured output for a single shell command execution.rQstdoutstderrc[SS9$)Nexitr8)rrRrZr[ShellCommandOutput.s >NTZ>[rZrroutcomeNrfcommanddict[str, Any] | None provider_datac.URR$r)rrros r[rShellCommandOutput.exit_codes||%%%rZc>URRS:XaS$S$)Ntimeout completed)rrPros r[statusShellCommandOutput.statuss LL--:yK KrZrR)rsr>)rszLiteral['completed', 'timeout'])rSrTrUrVrWrrXrrrrrrrrrYrRrZr[rrsgAFCFC %6[ \G \GZ+/M(/ &&LLrZrc@\rSrSr%SrS\S'SrS\S'SrS\S 'S rg) ShellResultiz$Result returned by a shell executor.zlist[ShellCommandOutput]rNr>max_output_lengthrrrR) rSrTrUrVrWrXrrrYrRrZr[rrs!. $$$(z(+/M(/rZrc@\rSrSr%SrS\S'SrS\S'SrS\S'S rg) ri z0Action payload for a next-generation shell call.r<commandsNr> timeout_msrrR) rSrTrUrVrWrXrrrYrRrZr[rr s :!J !$(z(rZcJ\rSrSr%SrS\S'S\S'SrS\S 'SrS \S 'S rg) ShellCallDataiz7Normalized shell call data provided to shell executors.rQcall_idractionNz*Literal['in_progress', 'completed'] | Nonerz Any | NonerawrR) rSrTrUrVrWrXrrrYrRrZr[rrs%A L 9=F 6=CrZrc.\rSrSr%SrS\S'S\S'Srg) ShellCommandRequestiz)A request to execute a modern shell call.rrrrrRNr_rRrZr[rrs3'' rZrcUcSS0$[U[5(d [S5e[U5nSU;aSUS'[ [ U5$)z=Normalize shell environment into a predictable mapping shape.rPlocalz(ShellTool environment must be a mapping.)rrr7dictrShellToolEnvironment) environment normalizeds r[!_normalize_shell_tool_environmentr)sX  k7 + +BCCk"J Z$ 6 $j 11rZc\rSrSr%SrSrS\S'SrS\S'S rS \S 'Sr S \S 'Sr S\S'SSjr \ SSj5r Srg) ShellTooli8zONext-generation shell tool. LocalShellTool will be deprecated in favor of this.NzShellExecutor | NonershellrQrFzbool | ShellApprovalFunctionrzShellOnApprovalFunction | None on_approvalShellToolEnvironment | Nonerc[UR5nXlUSnUS:XaURc [S5egURb [S5eURSLd UR b [S5eSUlSUlg)zCValidate shell tool configuration and normalize environment fields.rPrNz6ShellTool with local environment requires an executor.z>ShellTool with hosted environment does not accept an executor.FzQShellTool with hosted environment does not support needs_approval or on_approval.)rrrr7rr)rpnormalized_environmentenvironment_types r[rShellTool.__post_init__Os!B4CSCS!T11&9 w &}}$ XYY  == $\] ]   e +t/?/?/Kc $rZcg)NrrRros r[rPShellTool.typecsrZ)rrrr^r)rSrTrUrVrWrrXrrrrrrrPrYrRrZr[rr8sgY%)H")D#38N08 37K/604K,3  (rZrcf\rSrSr%SrS\S'SrS\S'SrS \S 'S rS \S '\ SSj5r Sr g )ApplyPatchToolihzQHosted apply_patch tool. Lets the model request file mutations via unified diffs.r3editor apply_patchrQrFz!bool | ApplyPatchApprovalFunctionrNz#ApplyPatchOnApprovalFunction | Nonercg)Nr rRros r[rPApplyPatchTool.typezrFrZrRr) rSrTrUrVrWrXrrrrrPrYrRrZr[rrhsK[ D#8=N5= 8!tool_namespace..s @%$z$ - - -%s"$z6tool_namespace() only supports FunctionTool instances.) rrQstripr7anyr0rcopyrrry)rrtoolsnamespace_namenormalized_descriptionnamespaced_toolsrnamespaced_tools r[tool_namespacer3s dC  OPP k3 ' '{/@/@/B/BLMM @% @@@PQQZZ\N(..0+-.tyy.I))D/*8'6L30  rZc/n[U5bURS5 UR(aURS5 [U5$)z7Return Responses-only features used by a function tool.ztool_namespace()zdefer_loading=True)r-ryrtuple)rfeaturess r[)get_function_tool_responses_only_featuresr7s?H+D1=*+ ,- ?rZc [U5nU(dgURn[SSRU5SUSUS35e)zEReject Responses-only function-tool features on unsupported backends.NzVThe following function-tool features are only supported with OpenAI Responses models: , z. Tool `z` cannot be used with .)r7rr7join)r backend_nameunsupported_features tool_names r[5ensure_function_tool_supports_responses_only_featuresr?s\ ETJ ##I  991234 1,q B rZcg)zBBackend-specific converters should validate reserved tool choices.NrR) tool_choicer<s r[#ensure_tool_choice_supports_backendrBs rZc[U[5(a UR=(d [U5SL$[U[5(a$[ UR RS55$g)zLReturn True when a tool can be exposed through hosted Responses tool search.NrF)rrrr-rrrrrs r[ is_responses_tool_search_surfacerE sX$ %%!![%I$%OW[%[[$ &&D$$((9:: rZc&[SU55$)zJReturn True when tool search has at least one eligible searchable surface.c38# UHn[U5v M g7fr)rEr's r[r)4has_responses_tool_search_surface..sH%$/55%r,r.s r[!has_responses_tool_search_surfacerLs H%H HHrZc[U[5(a UR$[U[5(a$[ UR R S55$g)zDReturn True when a tool requires ToolSearchTool() to stay reachable.rF)rrrrrrrrDs r[is_required_tool_search_surfacerNsG$ %%!!!$ &&D$$((9:: rZc&[SU55$)z?Return True when any enabled surface requires ToolSearchTool().c38# UHn[U5v M g7fr)rNr's r[r)3has_required_tool_search_surface.."sG.t44rIrJrKs r[ has_required_tool_search_surfacerR s GG GGrZ)allow_opaque_search_surfacecZUVs/sHn[U[5(dMUPM nn[U5nUS:n[U5n[ U5nUS:a [ S5e[ U5 U(aU(d [ S5eU(aU(dU(d [ S5egggs snf)zCValidate the Responses-only tool_search and defer-loading contract.rr+zHOnly one ToolSearchTool() is allowed when using OpenAI Responses models.z]Deferred-loading Responses tools require ToolSearchTool() when using OpenAI Responses models.aToolSearchTool() requires at least one searchable Responses surface: a tool_namespace(...) function tool, a deferred-loading function tool (`function_tool(..., defer_loading=True)`), or a deferred-loading hosted MCP server (`HostedMCPTool(tool_config={..., 'defer_loading': True})`).N)rrlenrLrRr7r/)r.rSrtool_search_toolstool_search_counthas_tool_searchhas_tool_search_surfacehas_required_tool_searchs r[,validate_responses_tool_search_configurationr[%s +0T%$:dN3S%T-.'!+O?F?F1bcc/6   6?Z R  @[6Us B(B(cU$)aPreserve explicit ToolSearchTool entries until request conversion validates them. Whether a tool_search definition is valid can depend on prompt-managed surfaces that are only known during request conversion, so pruning here hides misconfiguration instead of surfacing a clear error. rRrKs r[ prune_orphaned_tool_search_toolsr]Bs  LrZcUnUbE[U[R5(aU$UR=(d URnUbMEgr)rjsonJSONDecodeError __cause__ __context__)r#currents r[_extract_json_decode_errorrdLsH$)G   gt33 4 4N##:w':':   rZc[U[5(dg[U5RS5(dg[ U5$)NzInvalid JSON input for tool)rr5rQ startswithrdr#s r[!_extract_tool_argument_json_errorrhUs7 e/ 0 0 u: !> ? ? %e ,,rZ)"span_message_for_json_decode_errorinclude_input_json_in_logs!include_tool_name_in_log_messagesc(^^^^^SUUUUU4SjjnU$)zECreate a consistent handled-error reporter for wrapped FunctionTools.c>[U5nUbT bT n[U5nO T n[U5n[R"[ UUR US.S95 T(aT SUR 3OT n[ R(a[R"US35 gT(a[R"USUSU3US9 g[R"USU3US9 g)N)r>r#)messager z failedz failed: )exc_info) rhrQrAattach_error_to_current_spanr@rr,DONT_LOG_TOOL_DATAr:debugr#) rr# input_jsonjson_decode_errorresolved_span_messagespan_error_detail log_prefixrjrk log_label span_messageris r[rE_build_handled_function_tool_error_handler.._on_handled_errorgs=eD  (-O-[$F ! #$5 6 $0 ! #E 33 -!.!3!3.  4Uyk=--. /Zc   $ $ LLJ rZc U(a[R"U5$0$![abn[R(a[ R "SU35 O[ R "SUSU35 [SUSU35UeSnAff=f)z6Decode raw tool arguments with consistent diagnostics.Invalid JSON input for tool : N)r_loadsr$r,rrr:rsr5)r>rtr~s r[_parse_function_tool_json_inputrsd)3tzz*%;; d  $ $ LL7 {C D LL7 {"ZLQ R #? {"ZL!YZ`cc ds!! B ABB c[R(a[R"SU35 g[R"SUSU35 g)zELog the start of a tool invocation with the current redaction policy.zInvoking tool z with input N)r,rrr:rsr>rts r[_log_function_tool_invocationrs7    ~i[12 ~i[ ZLIJrZcD[U5nUbSU3$S[U53$)zLThe default tool error function, which just returns a generic error message.zYAn error occurred while parsing tool arguments. Please try again with valid JSON. Error: zCAn error occurred while running the tool. Please try again. Error: )rhrQ)r&r#rus r[default_tool_error_functionrs@9%@$ '( * QQTUZQ[P\ ]]rZztuple[ToolTimeoutBehavior, ...] _FUNCTION_TOOL_TIMEOUT_BEHAVIORScSUSUSS3$)zFBuild the default message returned to the model when a tool times out.zTool 'z' timed out after gz seconds.rRr>rs r["default_tool_timeout_error_messagers I;00C9 MMrZctU[LUlU[La SUlU$[[S-U5UlU$)zPStore internal failure formatter config for tool wrappers and runtime fallbacks.N)_UNSET_FAILURE_ERROR_FUNCTIONrrToolErrorFunctionr)rr0s r[r5r5sX "??5 "%B B ) #d*,B C) rZcHUR(a[$UR$)zRReturn the configured tool failure formatter for runtime-generated error handling.)rrrrs r[,resolve_function_tool_failure_error_functionrs88**  0 00rZc<^\rSrSr%SrS\S'SU4SjjrSrU=r$)_FunctionToolCancelledErrorizWAdapter that preserves the public ToolErrorFunction Exception contract on cancellation.asyncio.CancelledErrorcancelled_errorcX>Xl[U5=(d Sn[TU] U5 g)NzTool execution cancelled.)rrQsuperr)rprrn __class__s r[r$_FunctionToolCancelledError.__init__s&.o&E*E !rZ)r)rr) rSrTrUrVrWrXrrY __classcell__)rs@r[rrsa++""rZrc[U[5(aU$[U[R5(a [ U5$[[ U5=(d UR R5$)zXConvert runtime failures into the public Exception contract expected by tool formatters.)rr$asyncioCancelledErrorrrQrrSrgs r[-_coerce_tool_error_for_failure_error_functionrsP%## %//00*511 SZ;5??#;#; <YYz7<<  2* RR s * 77c`^[U[R5(a3[UR[5(a[ URTS9$[ U5T:Xag[U[R5(aX[UR[R5(a/[URTS9=(d [URTS9$[U[R5(a[ UR5n[UR[R5(aURR O UR4nUS:Xa[#U5=(a [USTS9$US;a[%U4SjU55$[URTS9$g)zYReturn True when an annotation expression structurally references the given context type.rTr r>rOptionalc38># UHn[UTS9v M g7f)rN)r)r(argrs r[r)9_annotation_expr_mentions_context_type..s\`UX6siP\`F)rrConstantrrQrrBinOpopBitOrrleftright SubscriptsliceTupleeltsrr,)rr wrapper_nameargss ` r[rrsD$ %%*TZZ*E*E7 iXXT"i/$ ""z$''399'E'E5 II U 3DJJ) T U$ &&,TZZ8 ",TZZ"C"Ctzz$** ; &:"HQ9#  0 0\` 6djjIVV rZc^U[RRLag[U[5(a[ UTR S9$[U5nUTLdUTLagU[La*[U5n[U5=(a [USTS9$U[[4;a[U4Sj[U555$g)zNReturn True when an annotation structurally references the given context type.FrTr context_typec38># UHn[UTS9v M g7f)rN)!_annotation_mentions_context_type)r(rrs r[r)4_annotation_mentions_context_type..8s + .c M+r)rl SignatureemptyrrQrrSrr rrrrr r,)rroriginrs ` r[rr&sW&&,,,*c""7 lNcNcdd  #F\!V|%;  #Dzc?QVbcc %##  +   rZc[[R"UR5RR 55nU(dU$USRn[URSS9nURUSRU5n[U[S9(aU$[U[S9(aUR!UR"5$U$![ [4a Us$f=f![a Nif=f)aChoose the runtime context object to pass into a function tool wrapper. Third-party wrappers may declare a narrower `RunContextWrapper` contract and then serialize that object downstream. In those cases, passing the richer `ToolContext` can leak runtime-only metadata such as agents or run config into incompatible serializers. When the wrapper explicitly declares `RunContextWrapper`, preserve only the base context state. rT)include_extrasr)r5rl signaturerr!values TypeErrorrnrrrrr$rr=r;_fork_with_tool_input tool_input)rr"r!context_annotationresolved_annotationss r[!_get_function_tool_invoke_contextr@s7,,]-I-IJUU\\^_  #A11^-m.J.J[_`255jm6H6HJ\]();+V();J[\,,W-?-?@@ N% z "    s$ACC,C)(C), C98C9c*# [X5nURnUc(UR[[U5U5IShvN $[ R "UR[[U5U55n[ R"XTS9IShvN $NUN![ RanUR5(a@UR5(d+UR5nUcUR5sSnA$USe[URUS9nURS:XaXeUR n U c[#URUS9sSnA$U "X5n [$R&"U 5(aU IShvN sSnA$U sSnA$SnAff=f7f)zFInvoke a function tool, enforcing timeout configuration when provided.N)rrrI)rrrrr r ensure_futurewait_for TimeoutErrordone cancelled exceptionrr6rrrrrlrm) rr" argumentsinvoke_contextr tool_taskr~tool_exception timeout_errorrtimeout_results r[invoke_function_toolrbsm7}NN#33O"11$sN2KYWWW%,%:%:$$T#~%> J&I%%iIII X J    >>  I$7$7$9$9&002N% '')) d *(#((+   ) )-> > (!.!E!E ! )5',, /  0G   ~ . .''' '1s>FB8F:BBBFBF.A F :F;FA F  F F(F 9E<:F >F?FF FF FF name_overridedescription_overridedocstring_styleuse_docstring_infor0 strict_moderrrrrrrrcg)z6Overload for usage as @function_tool (no parentheses).NrR)funcrrrrr0rrrrrrrrrs r[rrs*rZcg)z*Overload for usage as @function_tool(...).NrRrs r[rrs(rZc^^^^^^^^^ ^ ^ ^ ^ ^^SUUUUUUUUU U U U U U4Sjjm[U5(aT"U5$SU4SjjnU$)a Decorator to create a FunctionTool from a function. By default, we will: 1. Parse the function signature to create a JSON schema for the tool's parameters. 2. Use the function's docstring to populate the tool's description. 3. Use the function's docstring to populate argument descriptions. The docstring style is detected automatically, but you can override it. If the function takes a `RunContextWrapper` as the first argument, it *must* match the context type of the agent that uses the tool. Args: func: The function to wrap. name_override: If provided, use this name for the tool instead of the function's name. description_override: If provided, use this description for the tool instead of the function's docstring. docstring_style: If provided, use this style for the tool's docstring. If not provided, we will attempt to auto-detect the style. use_docstring_info: If True, use the function's docstring to populate the tool's description and argument descriptions. failure_error_function: If provided, use this function to generate an error message when the tool call fails. The error message is sent to the LLM. If you pass None, then no error message will be sent and instead an Exception will be raised. strict_mode: Whether to enable strict mode for the tool's JSON schema. We *strongly* recommend setting this to True, as it increases the likelihood of correct JSON input. If False, it allows non-strict JSON schemas. For example, if a parameter has a default value, it will be optional, additional properties are allowed, etc. See here for more: https://platform.openai.com/docs/guides/structured-outputs?api-mode=responses#supported-schemas is_enabled: Whether the tool is enabled. Can be a bool or a callable that takes the run context and agent and returns whether the tool is enabled. Disabled tools are hidden from the LLM at runtime. needs_approval: Whether the tool needs approval before execution. If True, the run will be interrupted and the tool call will need to be approved using RunState.approve() or rejected using RunState.reject() before continuing. Can be a bool (always/never needs approval) or a function that takes (run_context, tool_parameters, call_id) and returns whether this specific call needs approval. tool_input_guardrails: Optional list of guardrails to run before invoking the tool. tool_output_guardrails: Optional list of guardrails to run after the tool returns. timeout: Optional timeout in seconds for each tool call. timeout_behavior: Timeout handling mode. "error_as_result" returns a model-visible message, while "raise_exception" raises ToolTimeoutError and fails the run. timeout_error_function: Optional formatter used for timeout messages when timeout_behavior="error_as_result". defer_loading: Whether to hide this tool definition until Responses API tool search explicitly loads it. c F>^^^[R"T5(+m[TT TTTT S9mSUUU4Sjjn[S0STR_STR =(d S_STR _SU_S[S S S S 9_S T_ST _ST _ST _ST_ST_ST _ST_ST_ST_ST_6nU$)N)rrrrrrcD># URn[X!S9n[X!S9 U(aT R"S 0UD6OT R5nT R U5upg[R(d[R"SUSU35 T (d7T R(aT "U/UQ70UD6IShvN nOhT "U0UD6IShvN nOWT R(a$[R"T U/UQ70UD6IShvN nO"[R"T /UQ70UD6IShvN n[R(a[R"SUS35 U$[R"SUSU35 U$![an[ SUSU35UeSnAff=fNNNN}7f) Nrr~rzTool call args: z , kwargs: zTool z completed.z returned rR)r>rrparams_pydantic_modelr&r5 to_call_argsr,rrr:rs takes_contextr to_thread) r&r'r> json_dataparsedr(r kwargs_dictris_sync_function_toolschemathe_funcs r[_on_invoke_tool_implJfunction_tool.._create_function_tool.._on_invoke_tool_impl s I7)^I )I P a!00=9=557!' 3 3F ; D,, /vZ }MN(''#+C#F$#F+#FFF#+T#A[#AAF''#*#4#4Xs#YT#Y[#YYF#*#4#4X#T#T #TTF(( uYK{;<M uYKz&BCM1# a(+G {RTUVTW)XY_`` aGAZTslF )E4 A+F 7F8F F 4F =F>"F  F!AF 4 F>FFF F F F rrrrrrzError running tool (non-fatal)zError running toolTool)rzriryr0rrrrrrrrrr1r,rR)rliscoroutinefunctionr9r6rrrr|)rrrrrrrrr0rrrrrrrrrrs` @@r[_create_function_tool,function_tool.._create_function_tools$+$?$?$I I '!5+1*  # # J5  **0b  &88 2  H=3G   $:  + " * #8 $: $! ".# $$:% &(' (/) ,rZc>T"U5$rrR) real_funcrs r[ decorator function_tool..decoratorKs$Y//rZ)rToolFunction[...]rsr)rrrsr)r)rrrrrr0rrrrrrrrrrrs `````````````` @r[rrs;BFFFR~~$T**0 rZc[U[5=(d( [US5=(a [UR5$)Nr)rrhasattrrr) candidates r[rkrkVs1 i!1 2  8$C)2B2B)CrZcPURnUb[U[5(d[U[[-5(d [ S5e[ U5n[ R"U5(d [S5eUS::a [S5e[UR[S5(a [S5eXlUR[;a![SSR[5-5eURb&[!UR5(d [ S 5egg) NzJFunctionTool timeout_seconds must be a positive number in seconds or None.z5FunctionTool timeout_seconds must be a finite number.rz4FunctionTool timeout_seconds must be greater than 0.FzQFunctionTool timeout_seconds is only supported for async @function_tool handlers.z.FunctionTool timeout_behavior must be one of: r9z=FunctionTool timeout_error_function must be callable or None.)rrrintfloatrmathisfiniternrrrrrr;rr)rrs r[rr\s**O" ot , ,JPSV[P[4\4\\  0}}_--TU U a ST T 4&&(BE J Jc  / $DD <ii89 :   "".x@[@[7\7\WXX8].rZcpURn[U5(d[U5(a U[U'ggr)rrrkrc)rconfigs r[rVrVxs1 ]]F088*0!$'9rZcU[;a [U$[UR5(d[UR5(a UR$gr)rcrrrkrDs r[rjrj~sA (((.. "7 "F"F}} rZcR[RU5nUc 0nU[U'X#U'gr)rdr)rrrfresolved_by_runs r[riris2 033K@O1@!+.$DrZ)rrrr*rsr)&rrQrrQrrrrrr*r0!ToolErrorFunction | None | objectrrrrrrrrrrrrrrrrrrr1rr2rfr3rrsr)rrrsr)rComputerTool[Any]rrrsra)rrrsr+)rrrsr)rrQrrfr.list[FunctionTool]rsr)rrrsztuple[str, ...])rrr<rQrsr+)rAz6Literal['auto', 'required', 'none'] | str | Any | Noner<rQrsr+)rrrsr)r. list[Tool]rsr)r.rrSrrsr+)r.rrsr)r# BaseExceptionrsjson.JSONDecodeError | None)r#r$rsr) rzrQryrQrirfrjrrkrrsr*)r>rQrtrQrsr)r>rQrtrQrsr+)r&rr#r$rsrQ)r>rQrr rsrQ)rrr0rrsr)rrrsr)r#rrsr$)rrr"rr#rrsrf)rast.exprrsrf)rrQrrQrsr)rrrrQrsr)rr rz type[Any]rsr)rrr"r-rsz)ToolContext[Any] | RunContextWrapper[Any])rrr"r-rrQrsr ) rrrrfrrfrDocstringStyle | Nonerrr0rrrrrrrrrrrrrrrrrrrrsr)rrfrrfrrrrr0rrrrrrrrrrrrrrrrrrrrsz+Callable[[ToolFunction[...]], FunctionTool]r) rzToolFunction[...] | Nonerrfrrfrrrrr0rrrrrrrrrrrrrrrrrrrrsz:FunctionTool | Callable[[ToolFunction[...]], FunctionTool])r objectrsr)rrrsr+)rrrsr+)rrrszComputerConfig | None)rrrrrfr`rsr+) __future__rrrr-rrlr_r rgcollections.abcrrrrrenumr typesr typingr r r rrrrrrrrrrropenai.types.responsesr-openai.types.responses.file_search_tool_paramrr2openai.types.responses.response_computer_tool_callrr+openai.types.responses.response_output_itemrr!openai.types.responses.tool_paramr r!r"&openai.types.responses.web_search_toolWebSearchToolFilters,openai.types.responses.web_search_tool_paramr#pydanticr$r%r&r'typing_extensionsr(r)r*rr,_tool_identityr-r.r/r0rr1r2rr3r4 exceptionsr5r6r7r9r8r:rr; strict_schemar< tool_contextr=tool_guardrailsr>r?tracingr@utilrA util._typesrBrrCrDrrErFrGToolFunctionWithoutContextToolFunctionWithContextToolFunctionWithToolContext ToolFunction"DEFAULT_APPROVAL_REJECTION_MESSAGErr$rQrrrCustomToolApprovalFunctionrrrrLr]rbruryrValidToolOutputPydanticModelsrrXrrrarrrrrrComputerConfigrrrr/r6r9r;rHrSr`rhrbrcrdrvrrrrMCPToolApprovalFunctionShellApprovalFunctionrShellOnApprovalFunctionApplyPatchApprovalFunctionrApplyPatchOnApprovalFunctionrCustomToolOnApprovalFunctionrrrrrrrrrrShellToolContainerSkillrrrShellToolContainerNetworkPolicyrrrShellToolHostedEnvironmentrrrrrrr ShellExecutorrrrr rrr3r7r?rBrErLrNrRr[r]rdrhr|rrrrrr5rrrr%rrrrrrrrkrrVrjrirRrZr[rFs"   88("3Q[SSREMM?? .9GG<*4%D ''0| $ %j#o6";/@/Ez/Q#RTW#WX&{; 3J'KS'PQz*j)*!*-. &H"BC/4i@.QTBUUV{3/5~c7JJK%'8'=sC&H.Y]J^&^_< &Y%i(8)58I* !/ @CX XWb!X(*T $S$$ $+ + + \-' K| 4 ~\TJ -\QUVdXl+d #h/0# 6wy)6 6s 336Fs6KK 77 7( FF FR**ZSGSDS7SA^#]aBFDH $(,=7; %)+2 22' 2 H 2 E 2>22[2@2B2 X2"2 *!2"5#2$%2&'2()2*#+2,-2jR  2  4 e79%2 99 9   W   1 1-C11hR:  3 3  3  77 7+I+#n-JKK7!s1379MM +I+#s/0.A^2__ &s0#6t8LL ++ (s/0.Ac2dd  ++ (s/0.Ac2dd    ( "" " "" " 33 378.:MMN4     )i924HH$)SySi-/VV @3 37 7Y&(NN)03MM' !! ! LL L$ 00 0 )) )    -.s[?P0QQR U 2, 2 2 ,, ,^  , %% %P     "3        +     4  $G I H).  "&   :-6:'+.2 ))))3 ) !% ) (, )4)X dK ^E "A NA^  =   111")"=$    $S@4 /D))) )  )X !%'+-1#7;]aQVBFDH ,=7;# %  +   5[O@B* 5!"#$% . !%'+-1#7;]aQVBFDH ,=7;!%+    5 [O@B*5 !"1# .&*Q!%'+-1#@]]aQVBFDH ,=7;#Q "QQ% Q + Q  Q>QQ[QOQ@QBQQ*Q 5!Q"#Q$@%Qr Y81  %  %( % %  %rZ