"j] %SSKJr SSKrSSKrSSKJrJr SSKJrJ r J r J r J r J r JrJrJr SSKJrJrJrJr SSKJr SSKJrJrJr SSKrSSKrSSKrSSKJr S S K J!r! S S K"J#r# S S K!J$r$ S S K%J&r& S SK'J(r(J)r)J*r* S SK+J,r, S SK-J.r. S SK/J0r1 \Rd"\35r4\ \5\ \14r6S\7S'"SS\85r9\ S\64r:\ "S\:S9r;\ S\\\\644r<\ "S\"SS\5r?"SS\ \,5r@"S S!\@\;5rA"S"S#\@\=5rBS0S$jrCS0S%jrDS1S&jrE\S2S'j5rF\SSSSSSSSSS(. S3S)jj5rF\SSSSSSSSSS(. S4S*jj5rFS5SSSSSSSSSS(. S6S+jjjrF\S7S,j5rG\SSSSSSSSSS(. S8S-jj5rG\SSSSSSSSSS(. S9S.jj5rGS5SSSSSSSSSS(. S:S/jjjrG\ \A\\>4rH\ \B\\?4rIg);) annotationsN)ABCabstractmethod) AnyUnionGenericTypeVarCallableIterable Coroutinecastoverload) isawaitableisasyncgenfunctioniscoroutinefunctionisgeneratorfunction) Awaitable)Literal TypeAliasoverride) BaseModel)_compat)is_dict)cached_property) TypeAdapter) BetaToolParamBetaToolUnionParamBetaCacheControlEphemeralParam) CallableT) InputSchema)ContentrBetaFunctionToolResultTypec<^\rSrSr%SrS\S'SU4SjjrSrU=r$) ToolErroraError that can be raised from a tool to return structured content with `is_error: True`. When the tool runner catches this error, it will use the `content` property as the tool result instead of `repr(exc)`. Example: ```py raise ToolError( [ {"type": "text", "text": "Error details here"}, {"type": "image", "source": {"type": "base64", "data": "...", "media_type": "image/png"}}, ] ) ``` r#contentcT>[U[5(aUnOz/nUHXnURS5nUbUR[U55 M3URSURSS5S35 MZ U(aSR U5OSn[ TU]U5 Xlg)Ntext[typeunknown] z Tool error) isinstancestrgetappendjoinsuper__init__r')selfr'messagepartsblockr) __class__s `/home/mande/repo/quber/.venv/lib/python3.13/site-packages/anthropic/lib/tools/_beta_functions.pyr5ToolError.__init__2s gs # #G!E yy(#LLT+LL1UYYvy%A$B!!DE ! */chhuoLG ! )r')r'r#returnNone) __name__ __module__ __qualname____firstlineno____doc____annotations__r5__static_attributes__ __classcell__r:s@r;r%r%s"('  r=r%. FunctionT)boundAsyncFunctionTcP\rSrSr\SSj5r\SSj5r\S Sj5rSr g) BetaBuiltinFunctionToolIcgNr6s r;to_dictBetaBuiltinFunctionTool.to_dictJ-0r=cgrPrQr6inputs r;callBetaBuiltinFunctionTool.callMsADr=cUR5nSU;aUS$URS5nUc[SURS5<S35eU$Nmcp_server_namenamez Tool of type r+z does not have a namerSr1 ValueErrorr6rawr^s r;r^BetaBuiltinFunctionTool.namePVlln  #() )wwv <}SWWV_,??TUV V r=rQNr>rrXobjectr>r#r>r0 r@rArBrCrrSrYpropertyr^rFrQr=r;rMrMIs000DD r=rMcP\rSrSr\SSj5r\SSj5r\S Sj5rSr g) BetaAsyncBuiltinFunctionTool[cgrPrQrRs r;rS$BetaAsyncBuiltinFunctionTool.to_dict\rUr=c # g7frPrQrWs r;rY!BetaAsyncBuiltinFunctionTool.call_sGJscUR5nSU;aUS$URS5nUc[SURS5<S35eU$r\r_ras r;r^!BetaAsyncBuiltinFunctionTool.namebrdr=rQNrerfrhrirQr=r;rlrl[s000JJ r=rlc \rSrSr%S\S'S\S'S\S'S\S'S rS \S 'S rS \S 'S S S S S S S S S S. SSjjr\SSj5r SSjr \ SSj5r SSjr SSjr\ SSj5rSrg )BaseFunctionToolmr funcr0r^ descriptionr! input_schemaNz+Callable[[], None | Awaitable[None]] | Noneclosez object | None_context_manager r^rxry defer_loading cache_controlallowed_callerseager_input_streaminginput_examplesstrictc [R(a [S5eXl[R "U5UlU=(d URUlXPl X`l Xpl Xl Xl XlU=(d UR5UlUb2[#U[$5(aUR'5UlgX@lgUR+5Ulg)N2Tool functions are only supported with Pydantic v2)r PYDANTIC_V1 RuntimeErrorrwpydantic validate_call_func_with_validater@r^_defer_loading_cache_control_allowed_callers_eager_input_streaming_input_examples_strict_get_description_from_docstringrxr/r+model_json_schemary_create_schema_from_function) r6rwr^rxryr}r~rrrrs r;r5BaseFunctionTool.__init__s"   ST T #+#9#9$#? )DMM ++ /&;#- &P$*N*N*P  #,--1=1O1O1Q!$0! $ A A CD r=cUR$rPrwrRs r;__call__BaseFunctionTool.__call__s yyr=cURURURS.nURbURUS'URbURUS'UR bUR US'UR bUR US'URbURUS'URbURUS'U$)N)r^rxryr}r~rrrr) r^rxryrrrrrr)r6defns r;rSBaseFunctionTool.to_dictsII++ --     *$($7$7D !    *$($7$7D !  ,&*&;&;D" #  & & 2,0,G,GD( )    +%)%9%9D! " << #!\\DN r=ch[R"URR=(d S5$)N)docstring_parserparserwrDrRs r;_parsed_docstring"BaseFunctionTool._parsed_docstrings"%%dii&7&7&=2>>r=cURR(aOURRnURR(aUSURR3- nU$g)z*Extract description from parsed docstring.z r)rshort_descriptionlong_description)r6rxs r;r0BaseFunctionTool._get_description_from_docstringsX  ! ! 3 300BBK%%66d&<&<&M&M%NOO  r=cSSKJn SSKJnJn SSKJn "SSU5nU"URURS9nURRUS9$) z:Create JSON schema from function signature using pydantic.r) CoreSchema)JsonSchemaValueGenerateJsonSchema)ArgumentsParameterc\^\rSrSrSU4SjjrSSjr\SU4Sjj5rSrU=r $) OBaseFunctionTool._create_schema_from_function..CustomGenerateJsonSchemac:>[TU]5 XlX lgrP)r4r5_funcr)r6rwparsed_docstringr:s r;r5XBaseFunctionTool._create_schema_from_function..CustomGenerateJsonSchema.__init__s "! )9&r=cU$rPrQ)r6_args_kwdss r;rXBaseFunctionTool._create_schema_from_function..CustomGenerateJsonSchema.__call__s r=c>[TU]X5nURS5S:waU$URS5nU(a[U5(dU$URR HanURUR 5nU(a[U5(dM7UR(dMJSU;dMRURUS'Mc U$)Nr+rg propertiesrx)r4kw_arguments_schemar1rrparamsarg_namerx)r6 argumentsvar_kwargs_schemaschemarparam prop_schemar:s r;rcBaseFunctionTool._create_schema_from_function..CustomGenerateJsonSchema.kw_arguments_schemas 4YR::f%1!M#ZZ 5 !)<)<!M!33::E",.."@K&gk.B.B (((]+-M5:5F5F M2 ; r=)rr)rwzCallable[..., Any]rrr>r?)rrrrr>z'CustomGenerateJsonSchema')rz'list[ArgumentsParameter]'rzCoreSchema | Noner>r) r@rArBrCr5rrrrFrGrHs@r;CustomGenerateJsonSchemars= :   5 $5 !   r=r)rwr)schema_generator) pydantic_corerpydantic.json_schemarrpydantic_core.core_schemarrwr_adapter json_schema)r6rrrrrrs r;r-BaseFunctionTool._create_schema_from_functionsN -L@ '9 B4UYUkUkl}}((:J(KKr=c,[UR5$rP)rrrRs r;rBaseFunctionTool._adapter s43344r=) rrrrrrrrxrwryr^)rwr r^ str | Nonerxrry$InputSchema | type[BaseModel] | Noner} bool | Noner~%BetaCacheControlEphemeralParam | Nonerolist[Literal['direct', 'code_execution_20250825', 'code_execution_20260120', 'code_execution_20260521']] | Nonerrr"Iterable[dict[str, object]] | Nonerrr>r?)r>r )r>r)r>zdocstring_parser.Docstringrh)r>r!)r>zTypeAdapter[Any])r@rArBrCrErzr{r5rjrrSrrrrrrFrQr=r;rurums* O, I;9=E 6=$'+m* "&=A%)?C-1=A"&D&D &D  &D ; &D#&D=&D&D +&D;&D&D !&DP(??)LV55r=ruc\rSrSrSSjrSrg)BetaFunctionToolicZ[UR5(a [S5e[U5(d![ S[ U5R 35eUR"S0[[U5D6$![Ran[SUR35UeSnAff=f)NzJCannot call a coroutine function synchronously. Use `@async_tool` instead. Input must be a dictionary, got Invalid arguments for function rQrrwrr TypeErrorr+r@rr rrValidationErrorr`r^r6rXes r;rYBetaFunctionTool.calls tyy ) )kl lu~~>tE{?S?S>TUV V S++?d3.>? ?'' S>tyykJKQR R SsA88B* B%%B*rQNrfr@rArBrCrYrFrQr=r;rr Sr=rc\rSrSrSSjrSrg)BetaAsyncFunctionToolicv# [UR5(d [S5e[U5(d![ S[ U5R 35eUR"S0[[U5D6IShvN $N![Ran[SUR35UeSnAff=f7f)NzGCannot call a synchronous function asynchronously. Use `@tool` instead.rrrQrrs r;rYBetaAsyncFunctionTool.calls"499--hi iu~~>tE{?S?S>TUV V S11EDe4DEE EE'' S>tyykJKQR R Ss<AB9#B=B>BB9BB6B11B66B9rQNrfrrQr=r;rrrr=rcH[USS5nUSL=(a [U5$)ubTrue when `fn` is a function produced by `contextlib.contextmanager`. `contextmanager` wraps the generator function with `functools.wraps`, so the original generator function is reachable as `__wrapped__` — the same signal `inspect` itself uses. We never call `fn` to find out, so a plain tool function is never accidentally invoked during detection. __wrapped__N)getattrrfnwrappeds r;_is_sync_cm_factoryr,s(b-.G $  ?#6w#??r=cH[USS5nUSL=(a [U5$)zJTrue when `fn` is a function produced by `contextlib.asynccontextmanager`.rN)rrrs r;_is_async_cm_factoryr8s&b-.G $  >#5g#>>r=c # [USS5=(d [USS5nUb"U"5n[U5(a UIShvN [USS5nUb8[USS5nUbU"SSS5IShvN gUR SSS5 ggNM![a,n[R S[USS5U5 SnAN|SnAff=fNU![a,n[R S [USS5U5 SnAgSnAff=f7f) uRun a runnable tool's optional cleanup. Drives the legacy `aclose` / `close` attribute (awaited if it returns an awaitable) and, when the tool was defined as a context manager via `beta_tool` / `beta_async_tool`, its `__exit__` / `__aexit__`. Both run when both are present — the context-manager support is purely additive to `close`. Exceptions are logged, never raised, so one tool's bad cleanup can't abort another tool's. acloseNrzz"tool.close failed tool=%s error=%sr^?r{ __aexit__z4tool context-manager cleanup failed tool=%s error=%s)rr Exceptionlogwarning__exit__)toolcloserresultrcmaexits r;aclose_runnable_toolr>sT8T * JgdGT.JF  ]XF6""  )4 0B ~ oB T2E D$--- D$-   ] KKXZ[ \ \ ]. o KKNPWX\^dfiPjlm n n os%DBBB DC7C 8C<D=CDB C "CDC  D C D"D;DDDcgrPrQrs r; beta_toolr]s?Br=r|c grPrQ rwr^rxryr}r~rrrrs r;rras #&r=c grPrQr|s r;rrts:=r=c ^^^^^^^^^ [R(a [S5eSUUUUUUUUU 4 Sjjn UbU "U5$U $)aACreate a FunctionTool from a function with automatic schema inference. Can be used as a decorator with or without parentheses: @function_tool def my_func(x: int) -> str: ... @function_tool() def my_func(x: int) -> str: ... @function_tool(name="custom_name") def my_func(x: int) -> str: ... `SessionToolRunner` and `EnvironmentWorker` call the function on a worker thread. A `@contextmanager` tool is entered at decoration time and exited by the runner's cleanup, both off that thread, so avoid thread-bound resources such as a default `sqlite3` connection in `__enter__`. rc |> [U5(a [S5e[U5(aN[[U5"5nUR 5n[ [[U5T TT TTTTT T S9 nXl U$[ UT TT TTTTT T S9 $![a$ UR"[R"56 ef=f)Nzi@beta_tool was applied to an @asynccontextmanager; use @beta_async_tool for an async context-manager toolr|) rrrr r __enter__rrI BaseExceptionrsysexc_infor{) rrinnerrrr~r}rxrrryr^rs r;_makebeta_tool.._makes  # #I  r " " c2BLLNE 'E* +!-"/"/$3*?#1! "%' !K #%''+"7)  !  S\\^,  s  B .B;)rrIr>BetaFunctionTool[FunctionT]rrr rwr^rxryr}r~rrrrrs ````````` r;rrs>DOPP, , \ T{ Lr=cgrPrQrs r;beta_async_toolr sTWr=c grPrQrs r;r r s -0r=c grPrQr|s r;r r s ILr=c ^^^^^^^^^ [R(a [S5eSUUUUUUUUU 4 Sjjn UbU "U5$U $)a5Create an AsyncFunctionTool from a function with automatic schema inference. Can be used as a decorator with or without parentheses: @async_tool async def my_func(x: int) -> str: ... @async_tool() async def my_func(x: int) -> str: ... @async_tool(name="custom_name") async def my_func(x: int) -> str: ... rc > ^^^^^[U5(a [S5e[U5(aTc [S5e[[U5"5mSSS.m[ R "5m/mS UUUU4SjjmS U4SjjnT=(d [USS5UlT bT O [US S5Ul [[[U5TT TT T TT T TS 9 nTRU5 U$[UTT TT T TT T TS 9 $) Nza@beta_async_tool was applied to a @contextmanager; use @beta_tool for a sync context-manager toolzan @asynccontextmanager tool needs an explicit input_schema= (its parameters can't be inferred until the context manager is entered)F) validatedenteredcF># TS(djTIShvN TS(d@TR5IShvN n[R"U5TS'STS'TTSlSSS5IShvN TS$TS$NhNHN!,IShvN (df  TS$=f7f)NrrTr) __aenter__rrr{)rr enter_lockstatetool_boxs r;_entered0beta_async_tool.._make.._entered=sY')z$Y/*,--/$9E191G1G1NE+./3E),<>HQK8 *z[))u[)) *$9 *zz[))sTB!A=B!BA?,B# B!.B/B!?BB!B B B B!cn># T"5IShvN n[[U"S0UD6IShvN 5$N"N 7f)NrQ)r r#)kwargsrrs r;_lazy-beta_async_tool.._make.._lazyIs1"**, 6i>Q&>Q8QRR-8Qs 5153 55r@rrDr|)r>r)rrr>r#) rrrr ranyioLockrr@rDrrKr2)rrrrrrrrrr~r}rxrrryr^rs @@@@@r;rbeta_async_tool.._make(s r " "s   # # #^c2B265$IEJDFH * * S"DWRV%DEN+6+BKPRT]_cHdEM(^U+')++ /&;- D OOD !K$ #%''+"7)  r=)rrKr>%BetaAsyncFunctionTool[AsyncFunctionT]rrs ````````` r;r r s?:OPP@ @ D T{ Lr=)rrgr>bool)rrgr>r?)rwrIr>r)rwrIr^rrxrryrr}rr~rrrrrrrrrr>r)r^rrxrryrr}rr~rrrrrrrrrr>z2Callable[[FunctionT], BetaFunctionTool[FunctionT]]rP)rwzFunctionT | Noner^rrxrryrr}rr~rrrrrrrrrr>zPBetaFunctionTool[FunctionT] | Callable[[FunctionT], BetaFunctionTool[FunctionT]])rwrKr>r)rwrKr^rrxrryrr}rr~rrrrrrrrrr>r)r^rrxrryrr}rr~rrrrrrrrrr>zACallable[[AsyncFunctionT], BetaAsyncFunctionTool[AsyncFunctionT]])rwzAsyncFunctionT | Noner^rrxrryrr}rr~rrrrrrrrrr>ziBetaAsyncFunctionTool[AsyncFunctionT] | Callable[[AsyncFunctionT], BetaAsyncFunctionTool[AsyncFunctionT]])J __future__rrloggingabcrrtypingrrrr r r r r rinspectrrrrcollections.abcrtyping_extensionsrrrrrrrrr_utilsrr_modelsr types.betarrr _utils._utilsr types.tool_paramr!'types.beta.beta_tool_result_block_paramr" BetaContent getLoggerr@rr0r#rErr%FunctionrI AsyncFunctionrKrMrlrurrrrrrr BetaRunnableToolBetaAsyncRunnableToolrQr=r;r4sJ" #^^^]]%:: &"[[&+M !(-c8K3H.H(III! !H C33 4 Kx 0 iS2L(LMMN )?c$3$`5wy)`5F S' 2 S S,^< S @? o> B B "9=!%;?)-9=& & & & 7 &  &9& &'&7& &!& &$ "9=!%;?)-9== ==7 =  = 9 = ='=7= =8= =$"V"9=!%;?)-9=V V V V 7 V  V9V V'V7V VVVr W W "9=!%;?)-9=0 0 0 0 7 0  090 0'070 0+0 0$ "9=!%;?)-9=L LL7 L  L 9 L L'L7L LGL L$#'e"9=!%;?)-9=e e e e 7 e  e9e e'e7e eoeP)#.0GGH3C8:VVWr=