AXjnddlmZddlmZmZmZmZmZmZddl m Z ddl m Z ddl m Z ddlZerddlmZdd lmZdd lmZmZdd lmZdd lmZmZmZmZmZmZmZm Z dd l!m"Z"m#Z#m$Z$m%Z%m&Z&ddl'm(Z(ddl)m*Z*m+Z+ddl,m-Z-m.Z.ddl/m0Z0m1Z1ddl2m3Z3m4Z4ddl5m6Z6m7Z7ddl8m9Z9m:Z:m;Z;ddlm?Z?ddl@mAZAddlBmCZCddlDmEZEddlFmGZGddgZHGdde*ZIGdde+ZJGdd ZKGd!d"ZLGd#d$ZMGd%d&ZNy)') annotations) TYPE_CHECKINGAnyListUnionIterablecast)datetime)chain)LiteralN)Sequence)AsyncAnthropic)SessionToolRunnerBetaAnyRunnableTool)_legacy_response)BodyOmitQueryHeadersNotGivenSequenceNotStromit not_given)is_given path_templatemaybe_transformstrip_not_givenasync_maybe_transform)cached_property)SyncAPIResourceAsyncAPIResource)to_streamed_response_wrapper"async_to_streamed_response_wrapper)Stream AsyncStream)SyncPageCursorAsyncPageCursor)AsyncPaginatormake_request_options)event_list_paramsevent_send_paramsevent_stream_params)AnthropicBetaParam)BetaManagedAgentsDeltaType)BetaManagedAgentsEventParams)BetaManagedAgentsSessionEvent)"BetaManagedAgentsSendSessionEvents)$BetaManagedAgentsStreamSessionEventsEvents AsyncEventsceZdZed dZed dZeeeeeeeeeddded d dZeddded d dZ eeddded dd Z y)r4ct|Sa This property can be used as a prefix for any HTTP method call to return the raw response object instead of the parsed content. For more information, see https://www.github.com/anthropics/anthropic-sdk-python#accessing-raw-response-data-eg-headers )EventsWithRawResponseselfs n/var/www/html/content_generation/venv/lib/python3.12/site-packages/anthropic/resources/beta/sessions/events.pywith_raw_responsezEvents.with_raw_response's%T**ct|Sz An alternative to `.with_raw_response` that doesn't eagerly read the response body. For more information, see https://www.github.com/anthropics/anthropic-sdk-python#with_streaming_response )EventsWithStreamingResponser:s r<with_streaming_responsezEvents.with_streaming_response1s+400r>N created_at_gtcreated_at_gte created_at_ltcreated_at_ltelimitorderpagetypesbetas extra_headers extra_query extra_bodytimeoutc |std|itdt| r#djt d| Ddgnt i| xsi} ddi| xsi} |j td|ttt| | | |t|||||||| dtj ttt S)  List Events Args: created_at_gt: Return events created after this time (exclusive). created_at_gte: Return events created at or after this time (inclusive). created_at_lt: Return events created before this time (exclusive). created_at_lte: Return events created at or before this time (inclusive). limit: Query parameter for limit order: Sort direction for results, ordered by created_at. Defaults to asc (chronological). page: Opaque pagination cursor from a previous response's next_page. types: Filter by event type. Values match the `type` field on returned events (for example, `user.message` or `agent.tool_use`). Omit to return all event types. betas: Optional header to specify the beta version(s) you want to use. extra_headers: Send extra headers extra_query: Add additional query parameters to the request extra_body: Add additional JSON properties to the request timeout: Override the client-level default timeout for this request, in seconds 9Expected a non-empty value for `session_id` but received anthropic-beta,c32K|]}t|ywNstr.0es r< zEvents.list..s5Lec!femanaged-agents-2026-04-01*/v1/sessions/{session_id}/events?beta=true session_idrDrErFrGrHrIrJrKrMrNrOrPqueryrJoptionsmodel) ValueErrorrrjoinr r _get_api_listrr'r1r*rr+EventListParamsr rr;rcrDrErFrGrHrIrJrKrLrMrNrOrPs r<listz Events.list:s hXYcXfgh h  $'*hhu5Le5LOjNk/l&m"  "  *+F`=K^\^` !! FS] ^ =>(+'%%)6*8)6*8!&!& $!& &55  &2-"  r>rLrMrNrOrPc Z|std|itdt|r#djt d|Ddgnt i|xsi}ddi|xsi}|j td|td|itjt|||| t S)  Send Events Args: events: Events to send to the `session`. betas: Optional header to specify the beta version(s) you want to use. extra_headers: Send extra headers extra_query: Add additional query parameters to the request extra_body: Add additional JSON properties to the request timeout: Override the client-level default timeout for this request, in seconds rSrTrUc32K|]}t|ywrWrXrZs r<r]zEvents.send..r^r_r`rarbeventsrMrNrOrPbodyrhcast_to) rjrrrkr r_postrrr,EventSendParamsr*r2r;rcrtrLrMrNrOrPs r<sendz Events.sends:XYcXfgh h  $'*hhu5Le5LOjNk/l&m"  "  *+F`=K^\^` zz FS] ^ (F!35F5V5VW(+Q[el7   r> event_deltasrLrMrNrOrPc |std|itdt|r#djt d|Ddgnt i|xsi}ddi|xsi}|j td|t||||td|itj tttd tt S)  Stream Events Args: event_deltas: When set, this connection also receives streaming deltas (`event_start`, `event_delta`) while an event is being produced, before the event itself arrives. Deltas are best-effort; when the final event is produced it carries the complete content. A model request that ends early (an error or interrupt) produces no final event — its terminal `span.model_request_end` closes the preview. Accepts one or more event types to preview and may be repeated: `agent.message` streams `content_delta` fragments; `agent.thinking` is start-only — a signal that the agent has begun extended thinking, concluded by the `agent.thinking` event itself. Only previews of the requested event types are sent. betas: Optional header to specify the beta version(s) you want to use. extra_headers: Send extra headers extra_query: Add additional query parameters to the request extra_body: Add additional JSON properties to the request timeout: Override the client-level default timeout for this request, in seconds rSrTrUc32K|]}t|ywrWrXrZs r<r]z Events.stream..r^r_r`1/v1/sessions/{session_id}/events/stream?beta=truerbr~reTrhrxstream stream_cls)rjrrrkr r_getrr*rr-EventStreamParamsr rr3r%r;rcr~rLrMrNrOrPs r<rz Events.streamsLXYcXfgh h  $'*hhu5Le5LOjNk/l&m"  "  *+F`=K^\^` yy MZd e(+'%%~|&DFYFkFkl 9BC  r>)returnr9)rrA)rcrYrDUnion[str, datetime] | OmitrErrFrrGrrH int | OmitrILiteral['asc', 'desc'] | OmitrJ str | OmitrKSequenceNotStr[str] | OmitrLList[AnthropicBetaParam] | OmitrMHeaders | NonerN Query | NonerO Body | NonerP'float | httpx.Timeout | None | NotGivenrz-SyncPageCursor[BetaManagedAgentsSessionEvent]rcrYrtz&Iterable[BetaManagedAgentsEventParams]rLrrMrrNrrOrrPrrr2)rcrYr~'List[BetaManagedAgentsDeltaType] | OmitrLrrMrrNrrOrrPrrz,Stream[BetaManagedAgentsStreamSessionEvents]) __name__ __module__ __qualname__r r=rBrrror|rr>r<r4r4&s++116:6:596: /3,015)-$("&;D%Z Z 3 Z 4 Z 3 Z 4Z Z -Z Z *Z /Z &Z "!Z " #Z $9%Z & 7'Z B26)-$("&;D1 1 7 1 / 1 &1 "1  1 91  ,1 nAE15)-$("&;DA A > A / A &A "A  A 9A  6A r>c"eZdZed dZed dZeeeeeeeeeddded ddZeddded ddZ eeddded dd Z eddd  dd Z y)r5ct|Sr8)AsyncEventsWithRawResponser:s r<r=zAsyncEvents.with_raw_responses*$//r>ct|Sr@) AsyncEventsWithStreamingResponser:s r<rBz#AsyncEvents.with_streaming_responses055r>NrCc |std|itdt| r#djt d| Ddgnt i| xsi} ddi| xsi} |j td|ttt| | | |t|||||||| dtj ttt S) rRrSrTrUc32K|]}t|ywrWrXrZs r<r]z#AsyncEvents.list..Zr^r_r`rarbrdrerg)rjrrrkr rrlrr(r1r*rr+rmr rrns r<rozAsyncEvents.list!s hXYcXfgh h  $'*hhu5Le5LOjNk/l&m"  "  *+F`=K^\^` !! FS] ^ !>?(+'%%)6*8)6*8!&!& $!& &55  &2-"  r>rpc K|std|itdt|r#djt d|Ddgnt i|xsi}ddi|xsi}|j td|td|itjd {t|||| t d {S7$7w) rrrSrTrUc32K|]}t|ywrWrXrZs r<r]z#AsyncEvents.send..r^r_r`rarbrtNrurv) rjrrrkr rryrrr,rzr*r2r{s r<r|zAsyncEvents.send}s:XYcXfgh h  $'*hhu5Le5LOjNk/l&m"  "  *+F`=K^\^` ZZ FS] ^,h-?ARAbAbcc(+Q[el7     c s$BCB? C:C;CCr}c K|std|itdt|r#djt d|Ddgnt i|xsi}ddi|xsi}|j td|t||||td|itjd { tttd tt d {S767w) rrSrTrUc32K|]}t|ywrWrXrZs r<r]z%AsyncEvents.stream..r^r_r`rrbr~NreTr)rjrrrkr rrrr*rr-rr rr3r&rs r<rzAsyncEvents.streamsLXYcXfgh h  $'*hhu5Le5LOjNk/l&m"  "  *+F`=K^\^` YY MZd e(+'%1#\24G4Y4Y 9"#GH    s$B!C#C$1CCCC)max_idleenvironment_keyrMcpddlm}m}t|s|}|t d|j |||||S)uDispatch a self-hosted session's tool-call events. The sessions-side counterpart to ``client.beta.messages.tool_runner``: returns a :class:`~anthropic.lib.environments.SessionToolRunner` — an async iterable that attaches to the session's event stream, reconciles against the events-list endpoint, runs the matching tool from ``tools`` for each tool-call event, posts the matching result event back, and yields one :class:`~anthropic.lib.environments.DispatchedToolCall` per completed call. It handles both tool-call kinds: ``agent.tool_use`` (built-in agent-toolset tools) answered with ``user.tool_result``, and ``agent.custom_tool_use`` (custom, user-defined tools) answered with ``user.custom_tool_result``. Internally drives event-stream reconnect (with capped backoff) via an anyio task group so it works under both ``asyncio`` and ``trio``. Iteration ends when the session terminates (``session.status_terminated`` / ``session.deleted``), when the consumer breaks out of the loop, or — once the session has gone idle with ``stop_reason`` ``end_turn`` — ``max_idle`` seconds elapse with no new event (any new event resets that countdown; it re-arms on the next ``end_turn`` idle). ``max_idle=None`` disables that last condition. It does **not** touch the work-item lease — wrap it in an :class:`~anthropic.lib.environments.EnvironmentWorker` if you need heartbeating / force-stop. Usage:: from anthropic.lib.tools.agent_toolset import AgentToolContext, beta_agent_toolset_20260401 async with AgentToolContext(workdir=...) as env: async for call in client.beta.sessions.events.tool_runner( work.data.id, tools=[*beta_agent_toolset_20260401(env), my_tool], ): ... Args: session_id: The session whose events stream we attach to. Passed positionally, matching ``list`` / ``send`` / ``stream`` on this resource. tools: Registry of tool callables the runner will execute when the agent emits matching ``agent.tool_use`` / ``agent.custom_tool_use`` events — the same :class:`~anthropic.lib.tools.BetaAsyncFunctionTool` shape ``client.beta.messages.tool_runner`` accepts. max_idle: Seconds to keep running after the session goes idle with ``stop_reason`` ``end_turn`` before stopping; any new event resets the countdown. Defaults to ``DEFAULT_MAX_IDLE`` (60s) when not given. ``None`` disables it. environment_key: The self-hosted environment key. When set, the runner builds a Bearer-only scoped sub-client keyed to that environment for the event stream / list / send calls; leave it unset to authenticate those calls with the parent client's own credentials. extra_headers: Optional headers passed through per request on every call the runner makes (event stream / list / send). They are threaded into each call's ``extra_headers=`` and never assigned onto the client, so client state is not mutated. Auth and ``x-stainless-helper`` are supplied by the runner's scoped sub-client (and the parent client's ``default_headers`` propagate via its ``client.copy()``); a header given here overrides the scoped client's same-named default for that request, so use it for caller passthrough (e.g. trace ids), not to set auth. r)DEFAULT_MAX_IDLErr)toolsrrrM)lib.tools._beta_session_runnerrrrr _client)r;rcrrrrMrrs r< tool_runnerzAsyncEvents.tool_runnersAT [!'H !4<< 0 +'   r>)rr)rr)rcrYrDrrErrFrrGrrHrrIrrJrrKrrLrrMrrNrrOrrPrrz]AsyncPaginator[BetaManagedAgentsSessionEvent, AsyncPageCursor[BetaManagedAgentsSessionEvent]]r)rcrYr~rrLrrMrrNrrOrrPrrz1AsyncStream[BetaManagedAgentsStreamSessionEvents]) rcrYrzSequence[BetaAnyRunnableTool]rzfloat | None | NotGivenrz str | NonerMrrr) rrrr r=rBrrror|rrrr>r<r5r5 s+00666:6:596: /3,015)-$("&;D%Z Z 3 Z 4 Z 3 Z 4Z Z -Z Z *Z /Z &Z "!Z " #Z $9%Z & g'Z B26)-$("&;D1 1 7 1 / 1 &1 "1  1 91  ,1 nAE15)-$("&;DC C > C / C &C "C  C 9C  ;C T-6&*(,V V - V * V $ V &V  V r>ceZdZddZy)r9c||_tj|j|_tj|j|_tj|j |_yrW)_eventsrto_raw_response_wrapperror|rr;rts r<__init__zEventsWithRawResponse.__init__OsX $<< KK  %<< KK  '>> MM  r>Nrtr4rNonerrrrrr>r<r9r9N  r>r9ceZdZddZy)rc||_tj|j|_tj|j|_tj|j |_yrW)rrasync_to_raw_response_wrapperror|rrs r<rz#AsyncEventsWithRawResponse.__init__^sX $BB KK  %BB KK  'DD MM  r>Nrtr5rrrrr>r<rr]rr>rceZdZddZy)rAc||_t|j|_t|j|_t|j|_yrW)rr#ror|rrs r<rz$EventsWithStreamingResponse.__init__msF 0 KK  1 KK  3 MM  r>Nrrrr>r<rArAlrr>rAceZdZddZy)rc||_t|j|_t|j|_t|j|_yrW)rr$ror|rrs r<rz)AsyncEventsWithStreamingResponse.__init__|sF 6 KK  7 KK  9 MM  r>Nrrrr>r<rr{rr>r)O __future__rtypingrrrrrr r itertoolsr typing_extensionsr httpxcollections.abcr rrrrrr_typesrrrrrrrr_utilsrrrrr_compatr _resourcer!r" _responser#r$ _streamingr%r& paginationr'r( _base_clientr)r*types.beta.sessionsr+r,r-types.anthropic_beta_paramr.)types.beta.beta_managed_agents_delta_typer/4types.beta.sessions.beta_managed_agents_event_paramsr05types.beta.sessions.beta_managed_agents_session_eventr1;types.beta.sessions.beta_managed_agents_send_session_eventsr2=types.beta.sessions.beta_managed_agents_stream_session_eventsr3__all__r4r5r9rrArrr>r<rs#BB% (*Y!\\\gg';Z.:A]]=Tacnr ] #d _d N~ "~ B            r>