܎jJu:ddlmZddlmZmZmZmZmZmZddl 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&ZNdS)') 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/d"Zeddded#d0d'Z eeddded(d1d,Z dS)2r4returnEventsWithRawResponsec t|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 )r8selfs VC:\Projects\DSCons\.venv\Lib\site-packages\anthropic\resources\beta\sessions\events.pywith_raw_responsezEvents.with_raw_response's%T***EventsWithStreamingResponsec t|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 )r@r;s r=with_streaming_responsezEvents.with_streaming_response1s+4000r?N created_at_gtcreated_at_gte created_at_ltcreated_at_ltelimitorderpagetypesbetas extra_headers extra_query extra_bodytimeout session_idstrrEUnion[str, datetime] | OmitrFrGrHrI int | OmitrJLiteral['asc', 'desc'] | OmitrK str | OmitrLSequenceNotStr[str] | OmitrMList[AnthropicBetaParam] | OmitrNHeaders | NonerO Query | NonerP Body | NonerQ'float | httpx.Timeout | None | NotGiven-SyncPageCursor[BetaManagedAgentsSessionEvent]c |std|itdt| r.dt d| Ddgnt i| pi} ddi| pi} |td|ttt| | | |t|||||||| dtj  ttt S)  List Events Args: created_at_gt: Return events created after this time (exclusive). Compared against the event's `processed_at` value. created_at_gte: Return events created at or after this time (inclusive). Compared against the event's `processed_at` value. created_at_lt: Return events created before this time (exclusive). Compared against the event's `processed_at` value. created_at_lte: Return events created at or before this time (inclusive). Compared against the event's `processed_at` value. limit: Query parameter for limit order: Sort direction for results, ordered by the event's `processed_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,c34K|]}t|VdSNrS.0es r= zEvents.list..w(5L5Lc!ff5L5L5L5L5L5Lr?managed-agents-2026-04-01*/v1/sessions/{session_id}/events?beta=truerRrErFrGrHrIrJrKrLrNrOrPrQqueryrKoptionsmodel) ValueErrorrrjoinr r _get_api_listrr'r1r*rr+EventListParamsr rr<rRrErFrGrHrIrJrKrLrMrNrOrPrQs r=listz Events.list:sOp igYcgghh h  $'#chhu5L5Le5L5L5LOjNk/l/l&m&m&m"  "  *+F`=K^\^` !! FS] ^ ^ ^ =>(+'%%)6*8)6*8!&!& $!&  &5   &2-"   r?rMrNrOrPrQevents&Iterable[BetaManagedAgentsEventParams]r2c |std|itdt|r.dt d|Ddgnt i|pi}ddi|pi}|td|td|itj t|||| 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 rarbrcc34K|]}t|VdSrerfrgs r=rjzEvents.send..rkr?rlrmrnr|rNrOrPrQbodyrscast_to) rurrrvr r_postrrr,EventSendParamsr*r2r<rRr|rMrNrOrPrQs r=sendz Events.sends: igYcgghh h  $'#chhu5L5Le5L5L5LOjNk/l/l&m&m&m"  "  *+F`=K^\^` zz FS] ^ ^ ^ (F!35F5VWW(+Q[el7    r? event_deltasrMrNrOrPrQr'List[BetaManagedAgentsDeltaType] | Omit,Stream[BetaManagedAgentsStreamSessionEvents]c |std|itdt|r.dt d|Ddgnt i|pi}ddi|pi}|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 rarbrcc34K|]}t|VdSrerfrgs r=rjz Events.stream..rkr?rl1/v1/sessions/{session_id}/events/stream?beta=truernrrpTrsrstream stream_cls)rurrrvr r_getrr*rr-EventStreamParamsr rr3r%r<rRrrMrNrOrPrQs r=rz Events.streams1L igYcgghh h  $'#chhu5L5Le5L5L5LOjNk/l/l&m&m&m"  "  *+F`=K^\^` yy MZd e e e(+'%%~|&DFYFkll 9BC   r?)r7r8)r7r@)rRrSrErTrFrTrGrTrHrTrIrUrJrVrKrWrLrXrMrYrNrZrOr[rPr\rQr]r7r^rRrSr|r}rMrYrNrZrOr[rPr\rQr]r7r2)rRrSrrrMrYrNrZrOr[rPr\rQr]r7r) __name__ __module__ __qualname__r r>rCrrrzrrr?r=r4r4&s+++_+111_16:6:596: /3,015)-$("&;D%^ ^ ^ ^ ^ ^ J26)-$("&;D1 1 1 1 1 1 nAE15)-$("&;DA A A A A A A A r?ceZdZed6dZed7dZeeeeeeeeeddded d8d"Zeddded#d9d'Z eeddded(d:d,Z eddd-d;d5Z dS)zAsyncEvents.with_raw_responses*$///r? AsyncEventsWithStreamingResponsec t|SrB)rr;s r=rCz#AsyncEvents.with_streaming_responses0555r?NrDrRrSrErTrFrGrHrIrUrJrVrKrWrLrXrMrYrNrZrOr[rPr\rQr]]AsyncPaginator[BetaManagedAgentsSessionEvent, AsyncPageCursor[BetaManagedAgentsSessionEvent]]c |std|itdt| r.dt d| Ddgnt i| pi} ddi| pi} |td|ttt| | | |t|||||||| dtj  ttt S) r`rarbrcc34K|]}t|VdSrerfrgs r=rjz#AsyncEvents.list..brkr?rlrmrnrorprr)rurrrvr rrwrr(r1r*rr+rxr rrys r=rzzAsyncEvents.list%sOp igYcgghh h  $'#chhu5L5Le5L5L5LOjNk/l/l&m&m&m"  "  *+F`=K^\^` !! FS] ^ ^ ^ !>?(+'%%)6*8)6*8!&!& $!&  &5   &2-"   r?r{r|r}r2c K|std|itdt|r.dt d|Ddgnt i|pi}ddi|pi}|td|td|itj d {Vt|||| t d {VS) rrarbrcc34K|]}t|VdSrerfrgs r=rjz#AsyncEvents.send..rkr?rlrmrnr|Nrr) rurrrvr rrrrr,rr*r2rs r=rzAsyncEvents.sendsE: igYcgghh h  $'#chhu5L5Le5L5L5LOjNk/l/l&m&m&m"  "  *+F`=K^\^` ZZ FS] ^ ^ ^,h-?ARAbcccccccc(+Q[el7           r?rrr1AsyncStream[BetaManagedAgentsStreamSessionEvents]c K|std|itdt|r.dt d|Ddgnt i|pi}ddi|pi}|td|t||||td|itj d {V tttd tt d {VS) rrarbrcc34K|]}t|VdSrerfrgs r=rjz%AsyncEvents.stream..rkr?rlrrnrNrpTr)rurrrvr rrrr*rr-rr rr3r&rs r=rzAsyncEvents.streamsvL igYcgghh h  $'#chhu5L5Le5L5L5LOjNk/l/l&m&m&m"  "  *+F`=K^\^` YY MZd e e e(+'%1#\24G4Y 9"#GH         r?)max_idleenvironment_keyrNtoolsSequence[BetaAnyRunnableTool]rfloat | None | NotGivenr str | Nonerc|ddlm}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``. A call the server gated behind user confirmation (``evaluated_permission`` ``ask``, e.g. a tool configured with the ``always_ask`` permission policy) is held until the matching ``user.tool_confirmation`` event arrives — executed on ``allow``, never executed on ``deny`` (the denied call is still yielded with ``confirmation="deny"`` so it can be observed). 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)rrrrN)lib.tools._beta_session_runnerrrrr _client)r<rRrrrrNrrs r= tool_runnerzAsyncEvents.tool_runnersl^ [ZZZZZZZ!! ('H  !4< 0 0 +'     r?)r7r)r7r)rRrSrErTrFrTrGrTrHrTrIrUrJrVrKrWrLrXrMrYrNrZrOr[rPr\rQr]r7rr)rRrSrrrMrYrNrZrOr[rPr\rQr]r7r) rRrSrrrrrrrNrZr7r) rrrr r>rCrrrzrrrrr?r=r5r5sB000_0666_66:6:596: /3,015)-$("&;D%^ ^ ^ ^ ^ ^ J26)-$("&;D1 1 1 1 1 1 nAE15)-$("&;DC C C C C C T-6&*(,[ [ [ [ [ [ [ [ r?ceZdZddZdS)r8r|r4r7Nonec||_tj|j|_tj|j|_tj|j|_dSre)_eventsrto_raw_response_wrapperrzrrr<r|s r=__init__zEventsWithRawResponse.__init__\s\ $< K   %< K   '> M   r?Nr|r4r7rrrrrrr?r=r8r8[(       r?r8ceZdZddZdS)rr|r5r7rc||_tj|j|_tj|j|_tj|j|_dSre)rrasync_to_raw_response_wrapperrzrrrs r=rz#AsyncEventsWithRawResponse.__init__ks\ $B K   %B K   'D M   r?Nr|r5r7rrrr?r=rrjrr?rceZdZddZdS)r@r|r4r7rc||_t|j|_t|j|_t|j|_dSre)rr#rzrrrs r=rz$EventsWithStreamingResponse.__init__zsS 0 K   1 K   3 M   r?Nrrrr?r=r@r@yrr?r@ceZdZddZdS)rr|r5r7rc||_t|j|_t|j|_t|j|_dSre)rr$rzrrrs r=rz)AsyncEventsWithStreamingResponse.__init__sS 6 K   7 K   9 M   r?Nrrrr?r=rrrr?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__r4r5r8rr@rrr?r=rst#"""""BBBBBBBBBBBBBBBB%%%%%% Z((((((******YYYYYYYY!!!!!!\\\\\\\\\\\\\\\\\\\\gggggggggggggg'''''';;;;;;;;ZZZZZZZZ........::::::::AAAAAAAA]]]]]]]]]]======TTTTTTaaaaaaccccccnnnnnnrrrrrr ] #h h h h h _h h h VG G G G G "G G G T                                      r?