D_iy1 *SrSSKrSSKJrJrJrJr SSKJr SSK J r J r SSK J r JrJr SSKJr SSKJrJrJr SS KJr SS KJrJr "S S 5r"S S\\5r"SS\\5r"SS\5rS\ S\!\ \4S\ S-S\4Sjr""SS\5r#SSSSS.S\ S-S\ S-S\ S-S\$S-S\#4 Sjjr%SSSSS.S\ S-S\ S-S\ S-S\ S-S\4 Sjjr&S \'\!S\(\'\\'\44S!jr)S \'\!S\'\#4S"jr*S#\S$S%\S$S\S$4S&jr+g)'zMessages for tools.N)AnyLiteralcastoverload)UUID)Fieldmodel_validator) NotRequired TypedDictoverride)content) BaseMessageBaseMessageChunk merge_contentInvalidToolCall) merge_dicts merge_objc\rSrSrSrSrg)ToolOutputMixinaMixin for objects that tools can return directly. If a custom BaseTool is invoked with a `ToolCall` and the output of custom code is not an instance of `ToolOutputMixin`, the output will automatically be coerced to a string and wrapped in a `ToolMessage`. N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__rV/home/james-whalen/.local/lib/python3.13/site-packages/langchain_core/messages/tool.pyrrsrrc ^\rSrSr%Sr\\S'Sr\S\S'Sr \ \S'Sr \S \S '\ "\ S S 9r\ \S '\ "\ S S 9r\ \S'\"SS9\S\ S\ 4Sj55r\S\\\\ --S\ SS4Sj5r\SS\\\\ --S-S\\R.S-S\ SS4Sjj5rSS\\\\ --S-S\\R.S-S\ SS4U4SjjjrSrU=r$) ToolMessageaMessage for passing the result of executing a tool back to a model. `ToolMessage` objects contain the result of a tool invocation. Typically, the result is encoded inside the `content` field. `tool_call_id` is used to associate the tool call request with the tool call response. Useful in situations where a chat model is able to request multiple tool calls in parallel. Example: A `ToolMessage` representing a result of `42` from a tool call with id ```python from langchain_core.messages import ToolMessage ToolMessage(content="42", tool_call_id="call_Jja7J89XsjrOLA5r!MEOW!SL") ``` Example: A `ToolMessage` where only part of the tool output is sent to the model and the full output is passed in to artifact. ```python from langchain_core.messages import ToolMessage tool_output = { "stdout": "From the graph we can see that the correlation between " "x and y is ...", "stderr": None, "artifacts": {"type": "image", "base64_data": "/9j/4gIcSU..."}, } ToolMessage( content=tool_output["stdout"], artifact=tool_output, tool_call_id="call_Jja7J89XsjrOLA5r!MEOW!SL", ) ``` tool_call_idtooltypeNartifactsuccessr(errorstatusF)default_factoryrepradditional_kwargsresponse_metadatabefore)modevaluesreturncUSn[U[5(a [U5n[U[[45(d[U5US'O}[U[5(ah/US'[ U5HTupV[U[[ 45(d USR[U55 M@USRU5 MV USn[U[[[45(a[U5US'U$![anSU<S3n[ U5UeSnAff=f![anSUSU3n[ U5UeSnAff=f)zZCoerce the model arguments to the correct types. Args: values: The model arguments. r zUToolMessage content should be a string or a list of string/dicts. Received: content=z, which could not be coerced into a string.NzrToolMessage content should be a string or a list of string/dicts. Received a list but element ToolMessage.content[z8] is not a dict and could not be coerced to a string.: r$) isinstancetupleliststr ValueError enumeratedictappendrintfloat)clsr2r emsgixr$s r coerce_argsToolMessage.coerce_argsZs_# gu % %7mG'C;// -$'Ly! & & "F9 !'*!!c4[11 5y)00Q89%,,Q/+n- lT3$6 7 7%(%6F> " 7 --$+:. !o1,  -&5;;<#>??@cC )o145s0DD( D% D  D%( E 2EE r kwargsc gNr)selfr rFs r __init__ToolMessage.__init__s rcontent_blocksc grHr)rIr rLrFs r rJrKs rc j>Ub[TU]"SS[SU50UD6 g[TU]"SSU0UD6 g)zInitialize a `ToolMessage`. Specify `content` as positional arg or `content_blocks` for typing. Args: content: The contents of the message. content_blocks: Typed standard content. **kwargs: Additional fields. Nr zstr | list[str | dict]r)superrJr)rIr rLrF __class__s r rJrKsG  % G  5~F   G  7W 7 7rr)NN)rrrrrr8__annotations__r&rr'rr+rr;r.r/r classmethodrDrr7rJtypes ContentBlockr __classcell__rPs@r r"r"s&P7"D'&/";Hc+4FG& '3(#DuEtE?#DuEtE?(#))$)$)VtC$J''   26:>tC$J''$.U//047   26:>8tC$J''$.8U//0478 8  88rr"cX^\rSrSr%SrSr\S\S'\S\ S\ 4U4Sjj5r Sr U=r $)ToolMessageChunkzTool Message chunk.r&otherr3c >[U[5(aURUR:wa Sn[U5eUR UR[ UR UR 5[URUR5[URUR5[URUR5UR[URUR5S9$[TU]AU5$)Nz:Cannot concatenate ToolMessageChunks with different names.)r$r r'r.r/idr+)r5rXr$r9rPrr rr'rr.r/r\ _merge_statusr+rO__add__)rIrZrArPs r r^ToolMessageChunk.__add__s e- . .  E$6$66R o%>>!..%dllEMMB"4==%..A"-**E,C,C##.**E,C,C#77$T[[%,,?"  wu%%rr)rrrrrr&rrQr rrr^rrUrVs@r rXrXs9 );D'$ %: &S&%5&&rrXcd\rSrSr%Sr\\S'\\\4\S'\S-\S'\ \ S\S'S r g) ToolCallzRepresents an AI's request to call a tool. Example: ```python {"name": "foo", "args": {"a": 1}, "id": "123"} ``` This represents a request to call the tool named `'foo'` with arguments `{"a": 1}` and an identifier of `'123'`. nameargsNr\ tool_callr&r) rrrrrr8rQr;rr rrrrr rarasB  I, sCx.) d N gk* ++rrarcrdr\r3c[XUSS9$)zCreate a tool call. Args: name: The name of the tool to be called. args: The arguments to the tool call. id: An identifier associated with the tool call. Returns: The created tool call. re)rcrdr\r&)rarcrdr\s r reres Rk BBrcx\rSrSr%Sr\S-\S'\S-\S'\S-\S'\S-\S'\\ S\S 'S r g) ToolCallChunkaJA chunk of a tool call (yielded when streaming). When merging `ToolCallChunk`s (e.g., via `AIMessageChunk.__add__`), all string attributes are concatenated. Chunks are only merged if their values of `index` are equal and not None. Example: ```python left_chunks = [ToolCallChunk(name="foo", args='{"a":', index=0)] right_chunks = [ToolCallChunk(name=None, args="1}", index=0)] ( AIMessageChunk(content="", tool_call_chunks=left_chunks) + AIMessageChunk(content="", tool_call_chunks=right_chunks) ).tool_call_chunks == [ToolCallChunk(name="foo", args='{"a":1}', index=0)] ``` Nrcrdr\indextool_call_chunkr&r) rrrrrr8rQr=r rrrrr ririsM$ *, *) d N6 :3 g/0 11rrircrdr\rkrkc[XX#SS9$)a Create a tool call chunk. Args: name: The name of the tool to be called. args: The arguments to the tool call. id: An identifier associated with the tool call. index: The index of the tool call in a sequence. Returns: The created tool call chunk. rl)rcrdr\rkr&)rirms r rlrls$  7H rrcrdr\r*r*c[XX#SS9$)aCreate an invalid tool call. Args: name: The name of the tool to be called. args: The arguments to the tool call. id: An identifier associated with the tool call. error: An error message associated with the tool call. Returns: The created invalid tool call. invalid_tool_call)rcrdr\r*r&rros r rqrq1s$  7J rraw_tool_callsc /n/nUHmnSU;aM USSn[R"USS5n[U=(d SU=(d 0URS5S9nUR U5 Mo X4$![R a4 UR [ UUSSURS5SS95 Mf=f) zBest-effort parsing of tools. Args: raw_tool_calls: List of raw tool call dicts to parse. Returns: A list of tool calls and invalid tool calls. functionrc argumentsr\rgNro)jsonloadsregetr<JSONDecodeErrorrq)rr tool_callsinvalid_tool_calls raw_tool_call function_name function_argsparseds r default_tool_parserrHsJ' ] * %j1&9   JJ}Z'@'MNM"(b"(b $$T*F   f %(*  ))##   % %!&&z2;?$((.   sAA;;ACCc /nUHYnSU;aSnSnOUSSnUSSn[UUURS5URS5S9nURU5 M[ U$)zBest-effort parsing of tool chunks. Args: raw_tool_calls: List of raw tool call dicts to parse. Returns: List of parsed ToolCallChunk objects. rtNrurcr\rkrm)rlryr<)rrtool_call_chunksrerr~rs r default_tool_chunk_parserrms# Y & M M%j1+>M%j1&9M }}T"--(   '$ rleftr)rightcSX1;aS$S$)Nr*r(r)rrs r r]r]s$.7=I=r),rrwtypingrrrruuidrpydanticrr typing_extensionsr r r langchain_core.messagesr rSlangchain_core.messages.baserrrlangchain_core.messages.contentrlangchain_core.utils._mergerrrr"rXrar8r;rerir=rlrqr7r6rrr]rrr rs //+>>4UU;>Q8+Q8h&{$4&@,y,6C C sCx.C d C  C&2I2@  * * d  :   2  * * d  :   ."*J"* 4>40 01"*Jd4jT-=P6> $ %>.56H.I>  >r