g3fiy1 dZddlZddlmZmZmZmZddlmZddl m Z m Z ddl m Z mZmZddlmZddlmZmZmZdd lmZdd lmZmZGd d ZGd deeZGddeeZGddeZde de!e efde dzdefdZ"GddeZ#dddddde dzde dzde dzde$dzde#f dZ%dddddde dzde dzde dzde dzdef dZ&d e'e!de(e'ee'effd!Z)d e'e!de'e#fd"Z*d#ed$d%ed$ded$fd&Z+y)'zMessages for tools.N)AnyLiteralcastoverload)UUID)Fieldmodel_validator) NotRequired TypedDictoverride)content) BaseMessageBaseMessageChunk merge_contentInvalidToolCall) merge_dicts merge_objceZdZdZy)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____doc__Z/var/www/auto_recruiter/arenv/lib/python3.12/site-packages/langchain_core/messages/tool.pyrrsrrc eZdZUdZeed< dZeded< dZe ed< dZ eded < e e d Z e ed < e e d Ze ed < edede de fdZedeeee zzde ddfdZe ddeeee zzdzdeej,dzde ddfdZ ddeeee zzdzdeej,dzde ddffd ZxZS) 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)modevaluesreturnc`|d}t|tr t|}t|ttfs t||d<nqt|trag|d<t |D]N\}}t|tt fs |djt|;|dj|P|d}t|tttfrt||d<|S#t$r}d|d}t ||d}~wwxYw#t$r}d|d|}t ||d}~wwxYw)zrCoerce 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)clsr.r emsgixr s r coerce_argszToolMessage.coerce_argsZsW# gu %7mG'C;/ -$'Ly! & "F9 !'* 01!!c4[1 5y)00Q89%,,Q/ 0n- lT3$6 7%(%6F> " 7 --$+:. !o1,  -&5;;<#>??@cC )o145s/C(D ( D1DD D-D((D-r kwargsc yNr)selfr rAs r__init__zToolMessage.__init__s rcontent_blocksc yrCr)rDr rFrAs rrEzToolMessage.__init__s rc d|t|ddtd|i|yt|dd|i|y)aInitialize 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)superrEr)rDr rFrA __class__s rrEzToolMessage.__init__sG  % G  5~F   G  7W 7 7r)NN)rrrrr4__annotations__r"rr#rr'rr7r*r+r classmethodr@rr3rEtypes ContentBlock __classcell__rJs@rrrs&P7"D'&/";Hc+4FG& '3(#DuEtE?#DuEtE?(#))$)$)VtC$J''   26:>tC$J''$.U//047   26:>8tC$J''$.8U//0478 8  88rrcLeZdZUdZdZeded<edede ffd Z xZ S)ToolMessageChunkzTool Message chunk.r"otherr/c t|tr|j|jk7r d}t||j |jt |j |j t|j|jt|j|jt|j|j|jt|j|jSt|A|S)Nz:Cannot concatenate ToolMessageChunks with different names.)r r r#r*r+idr')r1rRr r5rJrr rr#rr*r+rU _merge_statusr'rI__add__)rDrSr=rJs rrWzToolMessageChunk.__add__s e- .  E$6$66R o%>>!..%dllEMMB"4==%..A"-**E,C,C##.**E,C,C#77$T[[%,,?"  wu%%r) rrrrr"rrKr rrrWrOrPs@rrRrRs9 );D'$ %: &S&%5&&rrRc\eZdZUdZeed< eeefed< edzed< ee ded<y)ToolCallaRepresents 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'`. nameargsNrU tool_callr") rrrrr4rKr7rr rrrrrYrYsB  I, sCx.) d N gk* ++rrYrZr[rUr/c t|||dS)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. r\)rZr[rUr")rYrZr[rUs rr\r\s DRk BBrcpeZdZUdZedzed< edzed< edzed< edzed< eeded<y) ToolCallChunka~A 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)] ``` NrZr[rUindextool_call_chunkr") rrrrr4rKr9r rrrrr`r`sM$ *, *) d N6 :3 g/0 11rr`rZr[rUrarac"t||||dS)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. rb)rZr[rUrar")r`rcs rrbrbs$  57H rrZr[rUr&r&c"t||||dS)a8Create 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)rZr[rUr&r"rres rrgrg1s$  57J rraw_tool_callsc vg}g}|D]a}d|vr|dd} tj|dd}t|xsd|xsi|jd}|j |c||fS#tj $r6|j t ||dd|jddYwxYw) 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. functionrZ argumentsrUr^Nre)jsonloadsr\getr8JSONDecodeErrorrg)rh tool_callsinvalid_tool_calls raw_tool_call function_name function_argsparseds rdefault_tool_parserrwHsJ' ] * %j1&9   JJ}Z'@'MNM"(b"(b $$T*F   f %* ) ))##   % %!&&z2;?$((.   sAA//AB87B8c g}|D]Y}d|vrd}d}n|dd}|dd}t|||jd|jd}|j|[|S)zBest-effort parsing of tool chunks. Args: raw_tool_calls: List of raw tool call dicts to parse. Returns: List of parsed ToolCallChunk objects. rjNrkrZrUrarc)rbror8)rhtool_call_chunksr\rurtrvs rdefault_tool_chunk_parserrzms# ( Y & M M%j1+>M%j1&9M }}T"--(   ' ( rleftr%rightcd||hvrdSdS)Nr&r$r)r{r|s rrVrVs$.7=I=r),rrmtypingrrrruuidrpydanticrr typing_extensionsr r r langchain_core.messagesr rMlangchain_core.messages.baserrrlangchain_core.messages.contentrlangchain_core.utils._mergerrrrrRrYr4r7r\r`r9rbrgr3r2rwrzrVrrrrs //+>>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