feat(api): manual updates - update openapi spec

added session_id

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 23
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/parallel-web%2Fparallel-sdk-7099c3aac2f0edacf413e426c176150404e1603f709cdd1f0af5c6689d33bd4f.yml
-openapi_spec_hash: eb61e027506aa339543ce33d7f052046
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/parallel-web%2Fparallel-sdk-c4cc922783460c6e65811d13c9abe35807a551c77c126d452806f93caaaf48fb.yml
+openapi_spec_hash: 99c9e48d4dafaca71f058107008d174b
 config_hash: fe820a5a10ee48e143c9e49a153b23b4

src/parallel/_client.py

@@ -236,6 +236,7 @@ def extract(
         max_chars_total: Optional[int] | Omit = omit,
         objective: Optional[str] | Omit = omit,
         search_queries: Optional[SequenceNotStr[str]] | Omit = omit,
+        session_id: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -251,6 +252,9 @@ def extract(
 
           advanced_settings: Advanced extract configuration.
 
+              These settings may impact result quality and latency unless used carefully. See
+              https://docs.parallel.ai/search/advanced-extract-settings for more info.
+
           client_model: The model generating this request and consuming the results. Enables
               optimizations and tailors default settings for the model's capabilities.
 
@@ -265,6 +269,10 @@ def extract(
           search_queries: Optional keyword search queries, as in SearchRequest. Used together with
               objective to focus excerpts on the most relevant content.
 
+          session_id: Session identifier for calls to search and extract made by an agent as part of a
+              larger task. May be a user-generated random string, e.g. a uuid, or a session_id
+              returned by a previous request.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -283,6 +291,7 @@ def extract(
                     "max_chars_total": max_chars_total,
                     "objective": objective,
                     "search_queries": search_queries,
+                    "session_id": session_id,
                 },
                 client_extract_params.ClientExtractParams,
             ),
@@ -301,6 +310,7 @@ def search(
         max_chars_total: Optional[int] | Omit = omit,
         mode: Optional[Literal["basic", "standard"]] | Omit = omit,
         objective: Optional[str] | Omit = omit,
+        session_id: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -318,6 +328,9 @@ def search(
 
           advanced_settings: Advanced search configuration.
 
+              These settings may impact result quality and latency unless used carefully. See
+              https://docs.parallel.ai/search/advanced-search-settings for more info.
+
           client_model: The model generating this request and consuming the results. Enables
               optimizations and tailors default settings for the model's capabilities.
 
@@ -334,6 +347,10 @@ def search(
               content. Should be self-contained with enough context to understand the intent
               of the search.
 
+          session_id: Session identifier for calls to search and extract made by an agent as part of a
+              larger task. May be a user-generated random string, e.g. a uuid, or a session_id
+              returned by a previous request.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -352,6 +369,7 @@ def search(
                     "max_chars_total": max_chars_total,
                     "mode": mode,
                     "objective": objective,
+                    "session_id": session_id,
                 },
                 client_search_params.ClientSearchParams,
             ),
@@ -562,6 +580,7 @@ async def extract(
         max_chars_total: Optional[int] | Omit = omit,
         objective: Optional[str] | Omit = omit,
         search_queries: Optional[SequenceNotStr[str]] | Omit = omit,
+        session_id: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -577,6 +596,9 @@ async def extract(
 
           advanced_settings: Advanced extract configuration.
 
+              These settings may impact result quality and latency unless used carefully. See
+              https://docs.parallel.ai/search/advanced-extract-settings for more info.
+
           client_model: The model generating this request and consuming the results. Enables
               optimizations and tailors default settings for the model's capabilities.
 
@@ -591,6 +613,10 @@ async def extract(
           search_queries: Optional keyword search queries, as in SearchRequest. Used together with
               objective to focus excerpts on the most relevant content.
 
+          session_id: Session identifier for calls to search and extract made by an agent as part of a
+              larger task. May be a user-generated random string, e.g. a uuid, or a session_id
+              returned by a previous request.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -609,6 +635,7 @@ async def extract(
                     "max_chars_total": max_chars_total,
                     "objective": objective,
                     "search_queries": search_queries,
+                    "session_id": session_id,
                 },
                 client_extract_params.ClientExtractParams,
             ),
@@ -627,6 +654,7 @@ async def search(
         max_chars_total: Optional[int] | Omit = omit,
         mode: Optional[Literal["basic", "standard"]] | Omit = omit,
         objective: Optional[str] | Omit = omit,
+        session_id: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -644,6 +672,9 @@ async def search(
 
           advanced_settings: Advanced search configuration.
 
+              These settings may impact result quality and latency unless used carefully. See
+              https://docs.parallel.ai/search/advanced-search-settings for more info.
+
           client_model: The model generating this request and consuming the results. Enables
               optimizations and tailors default settings for the model's capabilities.
 
@@ -660,6 +691,10 @@ async def search(
               content. Should be self-contained with enough context to understand the intent
               of the search.
 
+          session_id: Session identifier for calls to search and extract made by an agent as part of a
+              larger task. May be a user-generated random string, e.g. a uuid, or a session_id
+              returned by a previous request.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -678,6 +713,7 @@ async def search(
                     "max_chars_total": max_chars_total,
                     "mode": mode,
                     "objective": objective,
+                    "session_id": session_id,
                 },
                 client_search_params.ClientSearchParams,
             ),

src/parallel/resources/beta/beta.py

@@ -122,6 +122,7 @@ def extract(
         full_content: beta_extract_params.FullContent | Omit = omit,
         objective: Optional[str] | Omit = omit,
         search_queries: Optional[SequenceNotStr[str]] | Omit = omit,
+        session_id: Optional[str] | Omit = omit,
         betas: List[ParallelBetaParam] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -150,6 +151,10 @@ def extract(
 
           search_queries: If provided, focuses extracted content on the specified keyword search queries.
 
+          session_id: Session identifier for calls to search and extract made by an agent as part of a
+              larger task. May be a user-generated random string (e.g. a uuid) or a session_id
+              from a previous request.
+
           betas: Optional header to specify the beta version(s) to enable.
 
           extra_headers: Send extra headers
@@ -181,6 +186,7 @@ def extract(
                     "full_content": full_content,
                     "objective": objective,
                     "search_queries": search_queries,
+                    "session_id": session_id,
                 },
                 beta_extract_params.BetaExtractParams,
             ),
@@ -202,6 +208,7 @@ def search(
         objective: Optional[str] | Omit = omit,
         processor: Optional[Literal["base", "pro"]] | Omit = omit,
         search_queries: Optional[SequenceNotStr[str]] | Omit = omit,
+        session_id: Optional[str] | Omit = omit,
         source_policy: Optional[SourcePolicy] | Omit = omit,
         betas: List[ParallelBetaParam] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -244,6 +251,10 @@ def search(
               contain search operators. At least one of objective or search_queries must be
               provided.
 
+          session_id: Session identifier for calls to search and extract made by an agent as part of a
+              larger task. May be a user-generated random string (e.g. a uuid) or a session_id
+              from a previous request.
+
           source_policy: Source policy for web search results.
 
               This policy governs which sources are allowed/disallowed in results.
@@ -282,6 +293,7 @@ def search(
                     "objective": objective,
                     "processor": processor,
                     "search_queries": search_queries,
+                    "session_id": session_id,
                     "source_policy": source_policy,
                 },
                 beta_search_params.BetaSearchParams,
@@ -361,6 +373,7 @@ async def extract(
         full_content: beta_extract_params.FullContent | Omit = omit,
         objective: Optional[str] | Omit = omit,
         search_queries: Optional[SequenceNotStr[str]] | Omit = omit,
+        session_id: Optional[str] | Omit = omit,
         betas: List[ParallelBetaParam] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -389,6 +402,10 @@ async def extract(
 
           search_queries: If provided, focuses extracted content on the specified keyword search queries.
 
+          session_id: Session identifier for calls to search and extract made by an agent as part of a
+              larger task. May be a user-generated random string (e.g. a uuid) or a session_id
+              from a previous request.
+
           betas: Optional header to specify the beta version(s) to enable.
 
           extra_headers: Send extra headers
@@ -420,6 +437,7 @@ async def extract(
                     "full_content": full_content,
                     "objective": objective,
                     "search_queries": search_queries,
+                    "session_id": session_id,
                 },
                 beta_extract_params.BetaExtractParams,
             ),
@@ -441,6 +459,7 @@ async def search(
         objective: Optional[str] | Omit = omit,
         processor: Optional[Literal["base", "pro"]] | Omit = omit,
         search_queries: Optional[SequenceNotStr[str]] | Omit = omit,
+        session_id: Optional[str] | Omit = omit,
         source_policy: Optional[SourcePolicy] | Omit = omit,
         betas: List[ParallelBetaParam] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -483,6 +502,10 @@ async def search(
               contain search operators. At least one of objective or search_queries must be
               provided.
 
+          session_id: Session identifier for calls to search and extract made by an agent as part of a
+              larger task. May be a user-generated random string (e.g. a uuid) or a session_id
+              from a previous request.
+
           source_policy: Source policy for web search results.
 
               This policy governs which sources are allowed/disallowed in results.
@@ -521,6 +544,7 @@ async def search(
                     "objective": objective,
                     "processor": processor,
                     "search_queries": search_queries,
+                    "session_id": session_id,
                     "source_policy": source_policy,
                 },
                 beta_search_params.BetaSearchParams,