Cj>SSKJr SSKrSSKrSSKrSSKrSSKJr SSKJ r SSK J r J r J r JrJrJr SSKJrJr SSKJrJrJr SSKJr S S KJr S S KJr S S KJr S S K J!r! \ "SS55r"\ "SS55r#\ Sr$SSjr%\RLS5r'SSSjjr(SSjr)SSjr*SSjr+S S!Sjjr,g)") annotationsN)Callable) dataclass) AnnotatedAnyLiteralget_args get_originget_type_hints) DocstringDocstringSectionKind) BaseModelField create_model) FieldInfo) UserError)RunContextWrapper)ensure_strict_json_schema) ToolContextc\rSrSr%SrS\S'S\S'S\S'S \S 'S \S 'S rS\S'SrS\S'SSjrSr g) FuncSchemaz_ Captures the schema for a python function, in preparation for sending it to an LLM as a tool. strname str | None descriptionztype[BaseModel]params_pydantic_modelzdict[str, Any]params_json_schemazinspect.Signature signatureFbool takes_contextTstrict_json_schemac@/n0nSn[URRR55HunupgUR(aUS:XaM![ XS5nUR UR:XaURU=(d /5 SnMeUR UR:XaURU=(d 05 MUR URUR4;a U(dURU5 MXU'MXU'M X#4$)zr Converts validated data from the Pydantic model into (args, kwargs), suitable for calling the original function. FrNT) enumerater parametersitemsr"getattrkindVAR_POSITIONALextend VAR_KEYWORDupdatePOSITIONAL_ONLYPOSITIONAL_OR_KEYWORDappend) selfdatapositional_args keyword_argsseen_var_positionalidxrparamvalues h/home/rurouni/.local/share/pipx/venvs/strix-agent/lib/python3.13/site-packages/agents/function_schema.py to_call_argsFuncSchema.to_call_args,s &(') ##,DNN,E,E,K,K,M"N C$!!cQhD-EzzU111&&u{3&*#u000##EKR0 5 5u7R7RSS*#**51).&&+T"+#O,,,N)r2rreturnz tuple[list[Any], dict[str, Any]]) __name__ __module__ __qualname____firstlineno____doc____annotations__r"r#r:__static_attributes__r=r<r9rrsW I#***E&&Y  (M4_##= -r<rc<\rSrSr%SrS\S'S\S'S\S'S rg ) FuncDocumentationOzHContains metadata about a Python function, extracted from its docstring.rrrrzdict[str, str] | Noneparam_descriptionsr=N)r?r@rArBrCrDrEr=r<r9rGrGOsR I3F--Qr<rG)googlenumpysphinxc&SSSS.n/SQnUH<n[R"X0[R5(dM/US==S- ss'M> /SQnUH<n[R"X0[R5(dM/US==S- ss'M> /SQnUH<n[R"X0[R5(dM/US ==S- ss'M> [UR 55nUS:Xag /SQnUHnXU:XdM Us $ g ) Nr)rLrKrJ)z ^:param\sz^:type\sz ^:return:z^:rtype:rLr)z^Parameters\s*\n\s*-{3,}z^Returns\s*\n\s*-{3,}z^Yields\s*\n\s*-{3,}rK)z^(Args|Arguments):z ^(Returns):z ^(Raises):rJ)research MULTILINEmaxvalues) docscoressphinx_patternspatternnumpy_patternsgoogle_patterns max_scorestylesstyles r9_detect_docstring_styler\`s34qA(NFMO" 99W2<< 0 0 8  ! # N " 99W2<< 0 0 7Oq O" MO" 99W2<< 0 0 8  ! #FMMO$IA~$AF =I %L r<c## [R"S5nUR5nUR[R5 Sv URU5 g!URU5 f=f7f)Ngriffe)logging getLoggergetEffectiveLevelsetLevelERROR)loggerprevious_levels r9_suppress_griffe_loggingrfsU  x (F--/N OOGMM"( ''sAA5 A A5A22A5c4URn[R"U5nU(d [USSS9$[ 5 [ USU=(d [ U5S9nUR5nSSS5 [SW5S5nUVVs0sHNnUR[R:XdM#URHnURUR_M MP n nn[URUU =(d SS9$!,(df  N=fs snnf)a Extracts metadata from a function docstring, in preparation for sending it to an LLM as a tool. Args: func: The function to extract documentation from. style: The style of the docstring to use for parsing. If not provided, we will attempt to auto-detect the style. Returns: A FuncDocumentation object containing the function's name, description, and parameter descriptions. N)rrrIr)linenoparserc3x# UH0oR[R:XdM"URv M2 g7fN)r)r textr8).0sections r9 .generate_func_documentation..s&Zf7 @T@Y@Y0Yfs!::)r?inspectgetdocrGrfr r\parsenextr)r r&r8rr) funcr[rrS docstringparsedrrnr7rIs r9generate_func_documentationrxs ==D .. C  dQUVV ! #c!E4Y=TUX=YZ " $#ZfZ\`K *G <</:: : ]]E  E%%%# *  ]]-5  $ #*s.D "D3/D DcSnUn[U5[La9[U5nU(dX!4$USn/UQUSSQ7n[U5[LaM9X!4$)zIReturns the underlying annotation and any metadata from typing.Annotated.r=rrN)r rr ) annotationmetadataannargss r9_strip_annotatedr~sk!#H C S/Y &}  =1g)X)QR) S/Y & =r<cHUHn[U[5(dMUs $ g)zIExtracts a human readable description from Annotated metadata if present.N) isinstancerr{items r9"_extract_description_from_metadatars% dC K r<cHUHn[U[5(dMUs $ g)z;Returns the first FieldInfo in Annotated metadata, or None.N)rrrs r9!_extract_field_info_from_metadatars% dI & &K r<c  U(a*[X5n[UR=(d 05nOSn0n[USS9n0n 0n 0n UR 5H6upU S:XaM [ U 5upXU 'XU '[ U5nUcM2UX'M8 U R 5Hun nURU U5 M U=(d U(a URO URn[R"U5n[URR 55nSn/nU(aUSunnU RUUR5nU[R :wa=[#U5=(d UnU[$Ld U[&LaSnO'UR)UU45 OUR)UU45 USSHun nU RU UR5nU[R :wa>[#U5=(d UnU[$Ld U[&La[+SUR35eUR)U U45 M 0nUGHun nU RU UR5nUR,nU[R :Xa[.nURU S5nUR0UR2:Xaq[#U5[4LaA[7U5n[9U5S :XaUS[:La [USnO[[.nO [UnU[=[US 94UU 'MUR0UR>:Xaw[#U5[La@[7U5n[9U5S :Xa[USUS4nO#[[@[.4nO[[@U4nU[=[US 94UU 'GMwU RU S 5n[CU5n U b[DRF"U U=(d U RHS 9n!U[R :wa+[KU[D5(d[DRF"U!US 9n!O,[KU[D5(a[DRF"U!U5n!UU!4UU 'GM4U[R :XaU[=SUS 94UU 'GMZ[KU[D5(a0U[DRF"UU=(d URHS 94UU 'GMU[=UUS94UU 'GM [MUS34S[N0UD6n"U"RQ5n#U(a [SU#5n#[UUU=(d U(a URHOSU"U#UUUS9$)a7 Given a Python function, extracts a `FuncSchema` from it, capturing the name, description, parameter descriptions, and other metadata. Args: func: The function to extract the schema from. docstring_style: The style of the docstring to use for parsing. If not provided, we will attempt to auto-detect the style. name_override: If provided, use this name instead of the function's `__name__`. description_override: If provided, use this description instead of the one derived from the docstring. use_docstring_info: If True, uses the docstring to generate the description and parameter descriptions. strict_json_schema: Whether the JSON schema is in strict mode. If True, we'll ensure that the schema adheres to the "strict" standard the OpenAI API expects. We **strongly** recommend setting this to True, as it increases the likelihood of the LLM producing correct JSON input. Returns: A `FuncSchema` object containing the function's name, description, parameter descriptions, and other metadata. NT)include_extrasr>FrrzLRunContextWrapper/ToolContext param found at non-first position in function )default_factoryrr=)r)default.)rr_args__base__)rrrrr r"r#)+rxdictrIr r'r~r setdefaultrr?rqr listr&getrz_emptyr rrr0rrrr)r*tupler lenEllipsisrr,rrrmerge_field_infosrrrrmodel_json_schemarr)$rudocstring_style name_overridedescription_overrideuse_docstring_infor#doc_info param_descstype_hints_with_extras type_hintsannotated_param_descsparam_metadatarrz stripped_annr{r func_namesigparamsr"filtered_params first_name first_paramr|originr7fieldsrfield_description args_of_tuple dict_argsfield_info_from_annotatedmerged dynamic_model json_schemas$ r9function_schemars @.tE866<"=  +DF!#J,.13N288: 8  !1*!= '4't8B  "*5 ! ';388:kt[1;O8(--I   D !C #..&&( )FMO "() KnnZ)?)?@ '.. _+F**f .C $ && K'@A  " "J #< =abz ennT5#3#34 '.. _+F**f .C ( e}-" F& ennT5#3#34-- '.. C(OOD$7 ::-- -#%' ( }%*}Q/?8/K}Q/0Cs)C3id8IJF4L ZZ5,, ,#$&$SM y>Q&y|Yq\9:CsCx.C38nd8IJF4L&))$3H(I((S %(4"44- 1 Z5N5Z5Zgnn,Z5S5S&88QF33&88IF #V}t GNN*#+<= t GY////->-U'BUBU t '7HI t a'l!I;e!4SySFSM 113K/ <   (XXX-A-ASW+&#-  r<)rSrr>DocstringStylerk)ruCallable[..., Any]r[DocstringStyle | Noner>rG)rzrr>ztuple[Any, tuple[Any, ...]])r{tuple[Any, ...]r>r)r{rr>zFieldInfo | None)NNNTT)rurrrrrrrrr!r#r!r>r)- __future__r contextlibrqr_rNcollections.abcr dataclassesrtypingrrrr r r r^r r pydanticrrrpydantic.fieldsr exceptionsr run_contextr strict_schemar tool_contextrrrGrr\contextmanagerrfrxr~rrrr=r<r9rs0" $!PP333%!*4% 5-5- 5-p RR R45 %P ((>B' '%:''T  .2 $'+## H H*HH% H  H  HHr<