+
    Ui	}                       ^ RI Ht ^ RIHtHt ^ RIHt ^ RIHt ^ RI	t	^RI
HtHtHtHtHtHt ^RIHtHtHtHtHtHtHtHt ^RIHtHtHtHt ^R	IH t H!t!H"t"H#t#H$t$H%t% ^R
I&H't' ^RI(H)t)H*t*H+t+H,t,H-t-H.t. ^RI/H0t0H1t1 ^RI2H3t3H4t4H5t5H6t6 ^RI7H8t8H9t9 ^RI:H;t; ^RI<H=t= ^RI>H?t? ^RI@HAtA ^RIBHCtC ^RIDHEtE ^RIFHGtG RR.tH ! R R]04      tI ! R R]14      tJ ! R R4      tK ! R R4      tL ! R R4      tM ! R  R!4      tNR# )"    )annotations)ListOptional)chain)LiteralN)FindAllResourceAsyncFindAllResourceFindAllResourceWithRawResponse#AsyncFindAllResourceWithRawResponse$FindAllResourceWithStreamingResponse)AsyncFindAllResourceWithStreamingResponse)BodyOmitQueryHeadersNotGivenSequenceNotStromit	not_given)is_givenmaybe_transformstrip_not_givenasync_maybe_transform)TaskRunResourceAsyncTaskRunResourceTaskRunResourceWithRawResponse#AsyncTaskRunResourceWithRawResponse$TaskRunResourceWithStreamingResponse)AsyncTaskRunResourceWithStreamingResponse)cached_property)TaskGroupResourceAsyncTaskGroupResource TaskGroupResourceWithRawResponse%AsyncTaskGroupResourceWithRawResponse&TaskGroupResourceWithStreamingResponse+AsyncTaskGroupResourceWithStreamingResponse)SyncAPIResourceAsyncAPIResource)to_raw_response_wrapperto_streamed_response_wrapperasync_to_raw_response_wrapper"async_to_streamed_response_wrapper)beta_search_paramsbeta_extract_params)make_request_options)SearchResult)ExtractResponse)FetchPolicyParam)ParallelBetaParam)ExcerptSettingsParam)SourcePolicyBetaResourceAsyncBetaResourcec                     ] tR t^9t]R R l4       t]R R l4       t]R R l4       t]R R l4       t]R	 R
 l4       t	R]
R]
R]
R]
R]
R]
RRRRRRR]/
R R lltR]
R]
R]
R]
R]
R]
R]
R]
R]
R]
RRRRRRR]/R R lltRtR# ) r6   c                   V ^8  d   QhRR/# )   returnr    )formats   "[/home/ubuntu/hermes-agent/venv/lib/python3.14/site-packages/parallel/resources/beta/beta.py__annotate__BetaResource.__annotate__;   s     - -/ -    c                ,    \        V P                  4      # a  The Task API executes web research and extraction tasks.

Clients submit a natural-language objective with an optional input schema; the service plans retrieval, fetches relevant URLs, and returns outputs that conform to a provided or inferred JSON schema. Supports deep research style queries and can return rich structured JSON outputs. Processors trade-off between cost, latency, and quality. Each processor supports calibrated confidences.
- Output metadata: citations, excerpts, reasoning, and confidence per field
)r   _clientselfs   &r>   task_runBetaResource.task_run:   s     t||,,rA   c                   V ^8  d   QhRR/# )r:   r;   r!   r<   )r=   s   "r>   r?   r@   D   s     
/ 
/- 
/rA   c                ,    \        V P                  4      # a  
The Task Group API is currently in beta and enables batch execution of many independent Task runs with group-level monitoring and failure handling.
 - Submit hundreds or thousands of Tasks as a single group
- Observe group progress and receive results as they complete
- Real-time updates via Server-Sent Events (SSE)
- Add tasks to an existing group while it is running
- Group-level retry and error aggregation
Status: beta and subject to change.
)r!   rD   rE   s   &r>   
task_groupBetaResource.task_groupC   s     !..rA   c                   V ^8  d   QhRR/# )r:   r;   r   r<   )r=   s   "r>   r?   r@   Q   s     - - -rA   c                ,    \        V P                  4      # a  
The FindAll API discovers and evaluates entities that match complex criteria from natural language objectives. Submit a high-level goal and the service automatically generates structured match conditions, discovers relevant candidates, and evaluates each against the criteria. Returns comprehensive results with detailed reasoning, citations, and confidence scores for each match decision. Streaming events and webhooks are supported.
)r   rD   rE   s   &r>   findallBetaResource.findallP   s    
 t||,,rA   c                   V ^8  d   QhRR/# )r:   r;   BetaResourceWithRawResponser<   )r=   s   "r>   r?   r@   X   s     1 1#> 1rA   c                    \        V 4      # z
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/parallel-web/parallel-sdk-python#accessing-raw-response-data-eg-headers
)rT   rE   s   &r>   with_raw_responseBetaResource.with_raw_responseW   s     +400rA   c                   V ^8  d   QhRR/# )r:   r;   !BetaResourceWithStreamingResponser<   )r=   s   "r>   r?   r@   b   s     7 7)J 7rA   c                    \        V 4      # z
An alternative to `.with_raw_response` that doesn't eagerly read the response body.

For more information, see https://www.github.com/parallel-web/parallel-sdk-python#with_streaming_response
)rZ   rE   s   &r>   with_streaming_response$BetaResource.with_streaming_responsea   s     166rA   excerptsfetch_policyfull_content	objectivesearch_queriesbetasextra_headersNextra_query
extra_bodytimeoutc               H    V ^8  d   QhRRRRRRRRR	R
RRRRRRRRRRRRRR/# r:   urlszSequenceNotStr[str]r_   z#beta_extract_params.Excerpts | Omitr`   !Optional[FetchPolicyParam] | Omitra   z&beta_extract_params.FullContent | Omitrb   Optional[str] | Omitrc   $Optional[SequenceNotStr[str]] | Omitrd   List[ParallelBetaParam] | Omitre   Headers | Nonerf   Query | Nonerg   Body | Nonerh   'float | httpx.Timeout | None | NotGivenr;   r1   r<   )r=   s   "r>   r?   r@   j        K
 K
 "K
 6	K

 8K
 =K
 (K
 =K
 .K
 &K
 "K
  K
 9K
  
!K
rA   c               X   / \        R\        V4      '       d$   RP                  \        R V 4       R.4      4      M\        /4      CT;'       g    / CpRR/T;'       g    / CpV P                  R\        RVRVRVR	VR
VRV/\        P                  4      \        WWR7      \        R7      # )<  
Extracts relevant content from specific web URLs.

To access this endpoint, pass the `parallel-beta` header with the value
`search-extract-2025-10-10`.

Args:
  excerpts: Include excerpts from each URL relevant to the search objective and queries.
      Note that if neither objective nor search_queries is provided, excerpts are
      redundant with full content.

  fetch_policy: Policy for live fetching web results.

  full_content: Include full content from each URL. Note that if neither objective nor
      search_queries is provided, excerpts are redundant with full content.

  objective: If provided, focuses extracted content on the specified search objective.

  search_queries: If provided, focuses extracted content on the specified keyword search queries.

  betas: Optional header to specify the beta version(s) to enable.

  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
parallel-beta,c              3  8   "   T F  p\        V4      x  K  	  R # 5iNstr.0es   & r>   	<genexpr>'BetaResource.extract.<locals>.<genexpr>        4KUSVVU   search-extract-2025-10-10/v1beta/extractrk   r_   r`   ra   rb   rc   re   rf   rg   rh   bodyoptionscast_to)r   r   joinr   r   _postr   r.   BetaExtractParamsr/   r1   rF   rk   r_   r`   ra   rb   rc   rd   re   rf   rg   rh   s   &$$$$$$$$$$$r>   extractBetaResource.extractj   s    ^	
# &)XXe4KU4KNiMj.k%l"	
 ""	
 )*E_-J]J][]_zz D"L"L$n $55
 )+Q[ $!  
 	
rA   max_chars_per_resultmax_resultsmode	processorsource_policyc               T    V ^8  d   QhRRRRRRRRRR	R
RRRRRRRRRRRRRRRRRRR/# r:   r_   zExcerptSettingsParam | Omitr`   rl   r   zOptional[int] | Omitr   r   z7Optional[Literal['one-shot', 'agentic', 'fast']] | Omitrb   rm   r   z'Optional[Literal['base', 'pro']] | Omitrc   rn   r   zOptional[SourcePolicy] | Omitrd   ro   re   rp   rf   rq   rg   rr   rh   rs   r;   r0   r<   )r=   s   "r>   r?   r@           `
 `
 .`
 8	`

 3`
 *`
 F`
 (`
 ;`
 =`
 5`
 .`
 &`
  "!`
"  #`
$ 9%`
& 
'`
rA   c               d   / \        R\        V
4      '       d$   RP                  \        R V
 4       R.4      4      M\        /4      CT;'       g    / CpRR/T;'       g    / CpV P                  R\        RVRVRVR	VR
VRVRVRVRV	/	\        P                  4      \        WWR7      \        R7      # )  
Searches the web.

Args:
  excerpts: Optional settings to configure excerpt generation.

  fetch_policy: Policy for live fetching web results.

  max_chars_per_result: DEPRECATED: Use `excerpts.max_chars_per_result` instead.

  max_results: Upper bound on the number of results to return. Defaults to 10 if not provided.

  mode: Presets default values for parameters for different use cases.

      - `one-shot` returns more comprehensive results and longer excerpts to answer
        questions from a single response
      - `agentic` returns more concise, token-efficient results for use in an agentic
        loop
      - `fast` trades some quality for lower latency, with best results when used with
        concise and high-quality objective and keyword queries

  objective: Natural-language description of what the web search is trying to find. May
      include guidance about preferred sources or freshness. At least one of objective
      or search_queries must be provided.

  processor: DEPRECATED: use `mode` instead.

  search_queries: Optional list of traditional keyword search queries to guide the search. May
      contain search operators. At least one of objective or search_queries must be
      provided.

  source_policy: Source policy for web search results.

      This policy governs which sources are allowed/disallowed in results.

  betas: Optional header to specify the beta version(s) to enable.

  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
rw   rx   c              3  8   "   T F  p\        V4      x  K  	  R # 5irz   r{   r}   s   & r>   r   &BetaResource.search.<locals>.<genexpr>   r   r   r   /v1beta/searchr_   r`   r   r   r   rb   r   rc   r   r   r   )r   r   r   r   r   r   r   r-   BetaSearchParamsr/   r0   rF   r_   r`   r   r   r   rb   r   rc   r   rd   re   rf   rg   rh   s   &$$$$$$$$$$$$$$r>   searchBetaResource.search   s    B	
# &)XXe4KU4KNiMj.k%l"	
 ""	
 )*E_-J]J][]_zz "L*,@!;D$n#]
 #33 )+Q[ !'  
 	
rA   r<   __name__
__module____qualname____firstlineno__r    rG   rL   rQ   rW   r]   r   r   r   r   __static_attributes__r<   rA   r>   r6   r6   9   s   - - 
/ 
/ - - 1 1 7 7K
 9=	K

 ;?K
 @DK
 +/K
 @DK
 15K
 )-K
 %)K
 #'K
 <EK
Z`
 15`
 ;?	`

 6:`
 -1`
 IM`
 +/`
 >B`
 @D`
 8<`
 15`
 )-`
  %)!`
" #'#`
$ <E%`
 `
rA   c                     ] tR tRt]R R l4       t]R R l4       t]R R l4       t]R R	 l4       t]R
 R l4       t	R]
R]
R]
R]
R]
R]
RRRRRRR]/
R R lltR]
R]
R]
R]
R]
R]
R]
R]
R]
R]
RRRRRRR]/R R lltR tR# )!r7   i  c                   V ^8  d   QhRR/# )r:   r;   r   r<   )r=   s   "r>   r?   AsyncBetaResource.__annotate__  s     2 2. 2rA   c                ,    \        V P                  4      # rC   )r   rD   rE   s   &r>   rG   AsyncBetaResource.task_run  s     $DLL11rA   c                   V ^8  d   QhRR/# )r:   r;   r"   r<   )r=   s   "r>   r?   r   %  s     
4 
42 
4rA   c                ,    \        V P                  4      # rK   )r"   rD   rE   s   &r>   rL   AsyncBetaResource.task_group$  s     &dll33rA   c                   V ^8  d   QhRR/# )r:   r;   r	   r<   )r=   s   "r>   r?   r   2  s     2 2- 2rA   c                ,    \        V P                  4      # rP   )r	   rD   rE   s   &r>   rQ   AsyncBetaResource.findall1  s    
 $DLL11rA   c                   V ^8  d   QhRR/# )r:   r;    AsyncBetaResourceWithRawResponser<   )r=   s   "r>   r?   r   9  s     6 6#C 6rA   c                    \        V 4      # rV   )r   rE   s   &r>   rW   #AsyncBetaResource.with_raw_response8  s     055rA   c                   V ^8  d   QhRR/# )r:   r;   &AsyncBetaResourceWithStreamingResponser<   )r=   s   "r>   r?   r   C  s     < <)O <rA   c                    \        V 4      # r\   )r   rE   s   &r>   r]   )AsyncBetaResource.with_streaming_responseB  s     6d;;rA   r_   r`   ra   rb   rc   rd   re   Nrf   rg   rh   c               H    V ^8  d   QhRRRRRRRRR	R
RRRRRRRRRRRRRR/# rj   r<   )r=   s   "r>   r?   r   K  rt   rA   c                 "   / \        R\        V4      '       d$   RP                  \        R V 4       R.4      4      M\        /4      CT;'       g    / CpRR/T;'       g    / CpT P                  R\        RVRVRVR	VR
VRV/\        P                  4      G Rj  xL
 \        WWR7      \        R7      G Rj  xL
 #  L" L5i)rv   rw   rx   c              3  8   "   T F  p\        V4      x  K  	  R # 5irz   r{   r}   s   & r>   r   ,AsyncBetaResource.extract.<locals>.<genexpr>}  r   r   r   r   rk   r_   r`   ra   rb   rc   Nr   r   )r   r   r   r   r   r   r   r.   r   r/   r1   r   s   &$$$$$$$$$$$r>   r   AsyncBetaResource.extractK  s     ^	
# &)XXe4KU4KNiMj.k%l"	
 ""	
 )*E_-J]J][]_ZZ,D"L"L$n $55
 
 )+Q[ $!   
 
 	


s0   ACC"9CB>
C9C :C Cr   r   r   r   r   c               T    V ^8  d   QhRRRRRRRRRR	R
RRRRRRRRRRRRRRRRRRR/# r   r<   )r=   s   "r>   r?   r     r   rA   c                 "   / \        R\        V
4      '       d$   RP                  \        R V
 4       R.4      4      M\        /4      CT;'       g    / CpRR/T;'       g    / CpT P                  R\        RVRVRVR	VR
VRVRVRVRV	/	\        P                  4      G Rj  xL
 \        WWR7      \        R7      G Rj  xL
 #  L" L5i)r   rw   rx   c              3  8   "   T F  p\        V4      x  K  	  R # 5irz   r{   r}   s   & r>   r   +AsyncBetaResource.search.<locals>.<genexpr>  r   r   r   r   r_   r`   r   r   r   rb   r   rc   r   Nr   r   )r   r   r   r   r   r   r   r-   r   r/   r0   r   s   &$$$$$$$$$$$$$$r>   r   AsyncBetaResource.search  s    B	
# &)XXe4KU4KNiMj.k%l"	
 ""	
 )*E_-J]J][]_ZZ,"L*,@!;D$n#]
 #33  )+Q[ !'   
 
 	

s0   ACC"?C!C
"C?C CCr<   r   r<   rA   r>   r7   r7     s   2 2 
4 
4 2 2 6 6 < <K
 9=	K

 ;?K
 @DK
 +/K
 @DK
 15K
 )-K
 %)K
 #'K
 <EK
Z`
 15`
 ;?	`

 6:`
 -1`
 IM`
 +/`
 >B`
 @D`
 8<`
 15`
 )-`
  %)!`
" #'#`
$ <E%`
 `
rA   c                  d    ] tR tRtR R lt]R R l4       t]R R l4       t]R R	 l4       tR
t	R# )rT   i  c                    V ^8  d   QhRRRR/# r:   betar6   r;   Noner<   )r=   s   "r>   r?   (BetaResourceWithRawResponse.__annotate__       
 
\ 
d 
rA   c                	z    Wn         \        VP                  4      V n        \        VP                  4      V n        R # rz   )_betar)   r   r   rF   r   s   &&r>   __init__$BetaResourceWithRawResponse.__init__  s/    
.LL
 .KK
rA   c                   V ^8  d   QhRR/# )r:   r;   r   r<   )r=   s   "r>   r?   r     s     C C8 CrA   c                @    \        V P                  P                  4      # rC   )r   r   rG   rE   s   &r>   rG   $BetaResourceWithRawResponse.task_run  s     .djj.A.ABBrA   c                   V ^8  d   QhRR/# )r:   r;   r#   r<   )r=   s   "r>   r?   r     s     
G 
G< 
GrA   c                @    \        V P                  P                  4      # rK   )r#   r   rL   rE   s   &r>   rL   &BetaResourceWithRawResponse.task_group  s     0

0E0EFFrA   c                   V ^8  d   QhRR/# )r:   r;   r
   r<   )r=   s   "r>   r?   r     s     B B7 BrA   c                @    \        V P                  P                  4      # rP   )r
   r   rQ   rE   s   &r>   rQ   #BetaResourceWithRawResponse.findall  s    
 .djj.@.@AArA   r   r   r   N
r   r   r   r   r   r    rG   rL   rQ   r   r<   rA   r>   rT   rT     sI    
 C C 
G 
G B BrA   rT   c                  d    ] tR tRtR R lt]R R l4       t]R R l4       t]R R	 l4       tR
t	R# )r   i$  c                    V ^8  d   QhRRRR/# r:   r   r7   r;   r   r<   )r=   s   "r>   r?   -AsyncBetaResourceWithRawResponse.__annotate__%       
 
. 
4 
rA   c                	z    Wn         \        VP                  4      V n        \        VP                  4      V n        R # rz   )r   r+   r   r   r   s   &&r>   r   )AsyncBetaResourceWithRawResponse.__init__%  s/    
4LL
 4KK
rA   c                   V ^8  d   QhRR/# )r:   r;   r   r<   )r=   s   "r>   r?   r   0  s     H H= HrA   c                @    \        V P                  P                  4      # rC   )r   r   rG   rE   s   &r>   rG   )AsyncBetaResourceWithRawResponse.task_run/  s     34::3F3FGGrA   c                   V ^8  d   QhRR/# )r:   r;   r$   r<   )r=   s   "r>   r?   r   9  s     
L 
LA 
LrA   c                @    \        V P                  P                  4      # rK   )r$   r   rL   rE   s   &r>   rL   +AsyncBetaResourceWithRawResponse.task_group8  s     5TZZ5J5JKKrA   c                   V ^8  d   QhRR/# )r:   r;   r   r<   )r=   s   "r>   r?   r   F  s     G G< GrA   c                @    \        V P                  P                  4      # rP   )r   r   rQ   rE   s   &r>   rQ   (AsyncBetaResourceWithRawResponse.findallE  s    
 34::3E3EFFrA   r   Nr   r<   rA   r>   r   r   $  sI    
 H H 
L 
L G GrA   r   c                  d    ] tR tRtR R lt]R R l4       t]R R l4       t]R R	 l4       tR
t	R# )rZ   iM  c                    V ^8  d   QhRRRR/# r   r<   )r=   s   "r>   r?   .BetaResourceWithStreamingResponse.__annotate__N  r   rA   c                	z    Wn         \        VP                  4      V n        \        VP                  4      V n        R # rz   )r   r*   r   r   r   s   &&r>   r   *BetaResourceWithStreamingResponse.__init__N  s/    
3LL
 3KK
rA   c                   V ^8  d   QhRR/# )r:   r;   r   r<   )r=   s   "r>   r?   r   Y  s     I I> IrA   c                @    \        V P                  P                  4      # rC   )r   r   rG   rE   s   &r>   rG   *BetaResourceWithStreamingResponse.task_runX  s     4DJJ4G4GHHrA   c                   V ^8  d   QhRR/# )r:   r;   r%   r<   )r=   s   "r>   r?   r   b  s     
M 
MB 
MrA   c                @    \        V P                  P                  4      # rK   )r%   r   rL   rE   s   &r>   rL   ,BetaResourceWithStreamingResponse.task_groupa  s     6djj6K6KLLrA   c                   V ^8  d   QhRR/# )r:   r;   r   r<   )r=   s   "r>   r?   r   o  s     H H= HrA   c                @    \        V P                  P                  4      # rP   )r   r   rQ   rE   s   &r>   rQ   )BetaResourceWithStreamingResponse.findalln  s    
 4DJJ4F4FGGrA   r   Nr   r<   rA   r>   rZ   rZ   M  sI    
 I I 
M 
M H HrA   rZ   c                  d    ] tR tRtR R lt]R R l4       t]R R l4       t]R R	 l4       tR
t	R# )r   iv  c                    V ^8  d   QhRRRR/# r   r<   )r=   s   "r>   r?   3AsyncBetaResourceWithStreamingResponse.__annotate__w  r   rA   c                	z    Wn         \        VP                  4      V n        \        VP                  4      V n        R # rz   )r   r,   r   r   r   s   &&r>   r   /AsyncBetaResourceWithStreamingResponse.__init__w  s/    
9LL
 9KK
rA   c                   V ^8  d   QhRR/# )r:   r;   r   r<   )r=   s   "r>   r?   r     s     N NC NrA   c                @    \        V P                  P                  4      # rC   )r   r   rG   rE   s   &r>   rG   /AsyncBetaResourceWithStreamingResponse.task_run  s     99L9LMMrA   c                   V ^8  d   QhRR/# )r:   r;   r&   r<   )r=   s   "r>   r?   r     s     
R 
RG 
RrA   c                @    \        V P                  P                  4      # rK   )r&   r   rL   rE   s   &r>   rL   1AsyncBetaResourceWithStreamingResponse.task_group  s     ;4::;P;PQQrA   c                   V ^8  d   QhRR/# )r:   r;   r   r<   )r=   s   "r>   r?   r     s     M MB MrA   c                @    \        V P                  P                  4      # rP   )r   r   rQ   rE   s   &r>   rQ   .AsyncBetaResourceWithStreamingResponse.findall  s    
 99K9KLLrA   r   Nr   r<   rA   r>   r   r   v  sI    
 N N 
R 
R M MrA   r   )O
__future__r   typingr   r   	itertoolsr   typing_extensionsr   httpxrQ   r   r	   r
   r   r   r   _typesr   r   r   r   r   r   r   r   _utilsr   r   r   r   rG   r   r   r   r   r   r   _compatr    rL   r!   r"   r#   r$   r%   r&   	_resourcer'   r(   	_responser)   r*   r+   r,   
types.betar-   r.   _base_clientr/   types.beta.search_resultr0   types.beta.extract_responser1   types.beta.fetch_policy_paramr2   types.beta.parallel_beta_paramr3   !types.beta.excerpt_settings_paramr4   !types.shared_params.source_policyr5   __all__r6   r7   rT   r   rZ   r   r<   rA   r>   <module>r     s    # !  %   \ [ [ W W  '  ;  B 0 4 : = ? E =.
/^
? ^
B^
( ^
B&B &BR&G &GR&H &HR&M &MrA   