D_i%SrSSKJr SSKrSSKrSSKJrJr SSKJ r SSK J r J r J r Jr SSKJrJr SSKJr SS KJrJr SS KJrJr SS KJrJrJrJrJrJ r J!r! SS K"J#r# \ (aSS K$J%r% "SS\5r&SSjr'g)zStructured tool.) annotationsN) AwaitableCallable) signature) TYPE_CHECKING AnnotatedAnyLiteral)FieldSkipValidation)override)AsyncCallbackManagerForToolRunCallbackManagerForToolRun)RunnableConfigrun_in_executor) _EMPTY_SET FILTERED_ARGS ArgsSchemaBaseTool_get_runnable_config_param_is_injected_arg_typecreate_schema_from_function)is_basemodel_subclass)ToolCallcn^\rSrSr%SrSrS\S'\"SSS9rS \S 'S r S \S 'S r S\S'\ SSU4Sjjj5r S S.SSjjr S S.SU4Sjjjr\SSSSS.SSjjj5r\R$S Sj5rSrU=r$)!StructuredTool(z.Tool that can operate on any number of inputs.str description.zThe tool schema.)r z'Annotated[ArgsSchema, SkipValidation()] args_schemaNzCallable[..., Any] | Nonefunc$Callable[..., Awaitable[Any]] | None coroutinec># UR(d[X RX40UD6IShvN $[TU]"X40UD6IShvN $NN7fN)r$rinvokesuperainvoke)selfinputconfigkwargs __class__s Y/home/james-whalen/.local/lib/python3.13/site-packages/langchain_core/tools/structured.pyr)StructuredTool.ainvoke8sH~~(eVvVV VW_U=f===W=s!,AA AA AA) run_managerc<UR(aU(aF[UR5RRS5(aUR 5US'[ UR5=n(aXU'UR"U0UD6$Sn[ U5e)aUse the tool. Args: *args: Positional arguments to pass to the tool config: Configuration for the run run_manager: Optional callback manager to use for the run **kwargs: Keyword arguments to pass to the tool Returns: The result of the tool execution callbacksz0StructuredTool does not support sync invocation.)r"r parametersget get_childrNotImplementedError)r*r,r1argsr- config_parammsgs r/_runStructuredTool._runGs$ 99y3>>BB;OO&1&;&;&={#9$))DD|D'-|$99d-f- -@!#&&cx># UR(aU(aF[UR5RRS5(aUR 5US'[ UR5=n(aXU'UR"U0UD6IShvN $[ TU]"X1US.UD6IShvN $NN7f)aUse the tool asynchronously. Args: *args: Positional arguments to pass to the tool config: Configuration for the run run_manager: Optional callback manager to use for the run **kwargs: Keyword arguments to pass to the tool Returns: The result of the tool execution r3N)r,r1)r$rr4r5r6rr(_arun)r*r,r1r8r-r9r.s r/r?StructuredTool._arunbs$ >>y8CCGG TT&1&;&;&={#9$..II|I'-|$888 8W] k =C   9 s$BB:B6B:1B82B:8B:Fcontent)response_formatparse_docstringerror_on_invalid_docstringc UbUn OUbUn O Sn [U 5eU=(d U RnUcU(a[UU U U [U 5S9nUnUcU (dU R=(d SnUcU(a[ U[ 5(a6[U5(a&URnU(a SU;aSnOAU(dSnO7[ U[5(aURS5nOSU3n [U 5eUc Sn [U 5eUc$[R"U5R5nUR5nU"S UUUUUUUS .U D6$) aCreate tool from a given function. A classmethod that helps to create a tool from a function. Args: func: The function from which to create a tool. coroutine: The async function from which to create a tool. name: The name of the tool. Defaults to the function name. description: The description of the tool. Defaults to the function docstring. return_direct: Whether to return the result directly or as a callback. args_schema: The schema of the tool's input arguments. infer_schema: Whether to infer the schema from the function's signature. response_format: The tool response format. If `"content"` then the output of the tool is interpreted as the contents of a `ToolMessage`. If `"content_and_artifact"` then the output is expected to be a two-tuple corresponding to the `(content, artifact)` of a `ToolMessage`. parse_docstring: If `infer_schema` and `parse_docstring`, will attempt to parse parameter descriptions from Google Style function docstrings. error_on_invalid_docstring: if `parse_docstring` is provided, configure whether to raise `ValueError` on invalid Google Style docstrings. **kwargs: Additional arguments to pass to the tool Returns: The tool. Raises: ValueError: If the function is not provided. ValueError: If the function does not have a docstring and description is not provided. TypeError: If the `args_schema` is not a `BaseModel` or dict. Examples: ```python def add(a: int, b: int) -> int: """Add two numbers""" return a + b tool = StructuredTool.from_function(add) tool.run(1, 2) # 3 ``` Nz*Function and/or coroutine must be provided)rCrD filter_argsz)A base class for creating Pydantic modelsrr z5Invalid args_schema: expected BaseModel or dict, got z;Function must have a docstring if description not provided.)namer"r$r!r return_directrB) ValueError__name__r_filter_schema_args__doc__ isinstancetyperdictr5 TypeErrortextwrapdedentstrip)clsr"r$rGr rHr! infer_schemarBrCrDr-source_functionr: description_s r/ from_functionStructuredTool.from_functionstx  "O  "'O>CS/ !///  <5 /+E/@ K#  *22:dL  K+t,,1F{1S1S*22  C|S#%L%#'LK..*}= &-) n$  OCS/ !  #??<8>>@L',,./   #$'+    r=cUR=(d URnUc[$[S[ U5R R 555$)Nc3b# UH%up[UR5(dM!Uv M' g7fr&)r annotation).0kvs r/ 5StructuredTool._injected_args_keys..s' 8$Q\\2 A8s / /)r"r$r frozensetrr4items)r*fns r/_injected_args_keys"StructuredTool._injected_args_keyssL YY ($.. :  !" 00668   r=rIr&)r+zstr | dict | ToolCallr,zRunnableConfig | Noner-r returnr ) r8r r,rr1z CallbackManagerForToolRun | Noner-r rhr ) r8r r,rr1z%AsyncCallbackManagerForToolRun | Noner-r rhr )NNNNFNT)r"zCallable | Noner$r#rG str | Noner rirHboolr!zArgsSchema | NonerVrjrBz*Literal['content', 'content_and_artifact']rCrjrDrjr-r rhr)rhzfrozenset[str])rK __module__ __qualname____firstlineno__rMr __annotations__r r!r"r$r r)r;r? classmethodrY functoolscached_propertyrf__static_attributes__ __classcell__)r.s@r/rr(s8K;@ +<K8'&*D #*66:I3:3 )- >$ >& > > > >$9= '''6 '  ' '>>B    ;      >!%:>"&#)-!t GP %+0t t 8t  t  t  t 't t Dt t %)t t  t t l  r=rcj[[5n[U5=n(aURU5 U$r&)listrrappend)r"rFr9s r/rLrLs0}%K1$77|7<( r=)r"rrhz list[str])(rM __future__rrprRcollections.abcrrinspectrtypingrrr r pydanticr r typing_extensionsr langchain_core.callbacksrrlangchain_core.runnablesrrlangchain_core.tools.baserrrrrrrlangchain_core.utils.pydanticrlangchain_core.messagesrrrLrIr=r/rsc"/+&E@0Y XY xr=