perplexityai 0.13.0__py3-none-any.whl → 0.14.0__py3-none-any.whl

perplexity/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "perplexity"
-__version__ = "0.13.0"  # x-release-please-version
+__version__ = "0.14.0"  # x-release-please-version

perplexity/resources/async_/chat/completions.py

@@ -58,10 +58,7 @@ class CompletionsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CompletionCreateResponse:
         """
-        FastAPI wrapper around async chat completions
-
-        This endpoint creates an asynchronous chat completion job and returns a job ID
-        that can be used to poll for results.
+        Submit an asynchronous chat completion request.
 
         Args:
           extra_headers: Send extra headers
@@ -97,7 +94,7 @@ class CompletionsResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CompletionListResponse:
-        """list all async chat completion requests for a given user."""
+        """Retrieve a list of all asynchronous chat completion requests for a given user."""
         return self._get(
             "/async/chat/completions",
             options=make_request_options(
@@ -113,6 +110,7 @@ class CompletionsResource(SyncAPIResource):
         local_mode: bool | Omit = omit,
         x_client_env: str | Omit = omit,
         x_client_name: str | Omit = omit,
+        x_created_at_epoch_seconds: str | Omit = omit,
         x_request_time: str | Omit = omit,
         x_usage_tier: str | Omit = omit,
         x_user_id: str | Omit = omit,
@@ -124,7 +122,7 @@ class CompletionsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CompletionGetResponse:
         """
-        get the response for a given async chat completion request.
+        Retrieve the response for a given asynchronous chat completion request.
 
         Args:
           extra_headers: Send extra headers
@@ -142,6 +140,7 @@ class CompletionsResource(SyncAPIResource):
                 {
                     "x-client-env": x_client_env,
                     "x-client-name": x_client_name,
+                    "x-created-at-epoch-seconds": x_created_at_epoch_seconds,
                     "x-request-time": x_request_time,
                     "x-usage-tier": x_usage_tier,
                     "x-user-id": x_user_id,
@@ -195,10 +194,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CompletionCreateResponse:
         """
-        FastAPI wrapper around async chat completions
-
-        This endpoint creates an asynchronous chat completion job and returns a job ID
-        that can be used to poll for results.
+        Submit an asynchronous chat completion request.
 
         Args:
           extra_headers: Send extra headers
@@ -234,7 +230,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CompletionListResponse:
-        """list all async chat completion requests for a given user."""
+        """Retrieve a list of all asynchronous chat completion requests for a given user."""
         return await self._get(
             "/async/chat/completions",
             options=make_request_options(
@@ -250,6 +246,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         local_mode: bool | Omit = omit,
         x_client_env: str | Omit = omit,
         x_client_name: str | Omit = omit,
+        x_created_at_epoch_seconds: str | Omit = omit,
         x_request_time: str | Omit = omit,
         x_usage_tier: str | Omit = omit,
         x_user_id: str | Omit = omit,
@@ -261,7 +258,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CompletionGetResponse:
         """
-        get the response for a given async chat completion request.
+        Retrieve the response for a given asynchronous chat completion request.
 
         Args:
           extra_headers: Send extra headers
@@ -279,6 +276,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
                 {
                     "x-client-env": x_client_env,
                     "x-client-name": x_client_name,
+                    "x-created-at-epoch-seconds": x_created_at_epoch_seconds,
                     "x-request-time": x_request_time,
                     "x-usage-tier": x_usage_tier,
                     "x-user-id": x_user_id,

perplexity/resources/chat/completions.py

@@ -68,6 +68,7 @@ class CompletionsResource(SyncAPIResource):
         has_image_url: bool | Omit = omit,
         image_domain_filter: Optional[SequenceNotStr[str]] | Omit = omit,
         image_format_filter: Optional[SequenceNotStr[str]] | Omit = omit,
+        language_preference: Optional[str] | Omit = omit,
         last_updated_after_filter: Optional[str] | Omit = omit,
         last_updated_before_filter: Optional[str] | Omit = omit,
         latitude: Optional[float] | Omit = omit,
@@ -95,7 +96,9 @@ class CompletionsResource(SyncAPIResource):
         search_tenant: Optional[str] | Omit = omit,
         stop: Union[str, SequenceNotStr[str], None] | Omit = omit,
         stream: Optional[Literal[False]] | Omit = omit,
+        stream_mode: Literal["full", "concise"] | Omit = omit,
         temperature: Optional[float] | Omit = omit,
+        thread_id: Optional[str] | Omit = omit,
         tool_choice: Optional[Literal["none", "auto", "required"]] | Omit = omit,
         tools: Optional[Iterable[completion_create_params.Tool]] | Omit = omit,
         top_k: Optional[int] | Omit = omit,
@@ -103,6 +106,7 @@ class CompletionsResource(SyncAPIResource):
         top_p: Optional[float] | Omit = omit,
         updated_after_timestamp: Optional[int] | Omit = omit,
         updated_before_timestamp: Optional[int] | Omit = omit,
+        use_threads: Optional[bool] | Omit = omit,
         web_search_options: completion_create_params.WebSearchOptions | 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.
@@ -112,7 +116,7 @@ class CompletionsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> StreamChunk:
         """
-        FastAPI wrapper around chat completions
+        Generate a chat completion response for the given conversation.
 
         Args:
           extra_headers: Send extra headers
@@ -148,6 +152,7 @@ class CompletionsResource(SyncAPIResource):
         has_image_url: bool | Omit = omit,
         image_domain_filter: Optional[SequenceNotStr[str]] | Omit = omit,
         image_format_filter: Optional[SequenceNotStr[str]] | Omit = omit,
+        language_preference: Optional[str] | Omit = omit,
         last_updated_after_filter: Optional[str] | Omit = omit,
         last_updated_before_filter: Optional[str] | Omit = omit,
         latitude: Optional[float] | Omit = omit,
@@ -174,7 +179,9 @@ class CompletionsResource(SyncAPIResource):
         search_recency_filter: Optional[Literal["hour", "day", "week", "month", "year"]] | Omit = omit,
         search_tenant: Optional[str] | Omit = omit,
         stop: Union[str, SequenceNotStr[str], None] | Omit = omit,
+        stream_mode: Literal["full", "concise"] | Omit = omit,
         temperature: Optional[float] | Omit = omit,
+        thread_id: Optional[str] | Omit = omit,
         tool_choice: Optional[Literal["none", "auto", "required"]] | Omit = omit,
         tools: Optional[Iterable[completion_create_params.Tool]] | Omit = omit,
         top_k: Optional[int] | Omit = omit,
@@ -182,6 +189,7 @@ class CompletionsResource(SyncAPIResource):
         top_p: Optional[float] | Omit = omit,
         updated_after_timestamp: Optional[int] | Omit = omit,
         updated_before_timestamp: Optional[int] | Omit = omit,
+        use_threads: Optional[bool] | Omit = omit,
         web_search_options: completion_create_params.WebSearchOptions | 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.
@@ -191,7 +199,7 @@ class CompletionsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> Stream[StreamChunk]:
         """
-        FastAPI wrapper around chat completions
+        Generate a chat completion response for the given conversation.
 
         Args:
           extra_headers: Send extra headers
@@ -227,6 +235,7 @@ class CompletionsResource(SyncAPIResource):
         has_image_url: bool | Omit = omit,
         image_domain_filter: Optional[SequenceNotStr[str]] | Omit = omit,
         image_format_filter: Optional[SequenceNotStr[str]] | Omit = omit,
+        language_preference: Optional[str] | Omit = omit,
         last_updated_after_filter: Optional[str] | Omit = omit,
         last_updated_before_filter: Optional[str] | Omit = omit,
         latitude: Optional[float] | Omit = omit,
@@ -253,7 +262,9 @@ class CompletionsResource(SyncAPIResource):
         search_recency_filter: Optional[Literal["hour", "day", "week", "month", "year"]] | Omit = omit,
         search_tenant: Optional[str] | Omit = omit,
         stop: Union[str, SequenceNotStr[str], None] | Omit = omit,
+        stream_mode: Literal["full", "concise"] | Omit = omit,
         temperature: Optional[float] | Omit = omit,
+        thread_id: Optional[str] | Omit = omit,
         tool_choice: Optional[Literal["none", "auto", "required"]] | Omit = omit,
         tools: Optional[Iterable[completion_create_params.Tool]] | Omit = omit,
         top_k: Optional[int] | Omit = omit,
@@ -261,6 +272,7 @@ class CompletionsResource(SyncAPIResource):
         top_p: Optional[float] | Omit = omit,
         updated_after_timestamp: Optional[int] | Omit = omit,
         updated_before_timestamp: Optional[int] | Omit = omit,
+        use_threads: Optional[bool] | Omit = omit,
         web_search_options: completion_create_params.WebSearchOptions | 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.
@@ -270,7 +282,7 @@ class CompletionsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> StreamChunk | Stream[StreamChunk]:
         """
-        FastAPI wrapper around chat completions
+        Generate a chat completion response for the given conversation.
 
         Args:
           extra_headers: Send extra headers
@@ -305,6 +317,7 @@ class CompletionsResource(SyncAPIResource):
         has_image_url: bool | Omit = omit,
         image_domain_filter: Optional[SequenceNotStr[str]] | Omit = omit,
         image_format_filter: Optional[SequenceNotStr[str]] | Omit = omit,
+        language_preference: Optional[str] | Omit = omit,
         last_updated_after_filter: Optional[str] | Omit = omit,
         last_updated_before_filter: Optional[str] | Omit = omit,
         latitude: Optional[float] | Omit = omit,
@@ -332,7 +345,9 @@ class CompletionsResource(SyncAPIResource):
         search_tenant: Optional[str] | Omit = omit,
         stop: Union[str, SequenceNotStr[str], None] | Omit = omit,
         stream: Optional[Literal[False]] | Literal[True] | Omit = omit,
+        stream_mode: Literal["full", "concise"] | Omit = omit,
         temperature: Optional[float] | Omit = omit,
+        thread_id: Optional[str] | Omit = omit,
         tool_choice: Optional[Literal["none", "auto", "required"]] | Omit = omit,
         tools: Optional[Iterable[completion_create_params.Tool]] | Omit = omit,
         top_k: Optional[int] | Omit = omit,
@@ -340,6 +355,7 @@ class CompletionsResource(SyncAPIResource):
         top_p: Optional[float] | Omit = omit,
         updated_after_timestamp: Optional[int] | Omit = omit,
         updated_before_timestamp: Optional[int] | Omit = omit,
+        use_threads: Optional[bool] | Omit = omit,
         web_search_options: completion_create_params.WebSearchOptions | 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.
@@ -370,6 +386,7 @@ class CompletionsResource(SyncAPIResource):
                     "has_image_url": has_image_url,
                     "image_domain_filter": image_domain_filter,
                     "image_format_filter": image_format_filter,
+                    "language_preference": language_preference,
                     "last_updated_after_filter": last_updated_after_filter,
                     "last_updated_before_filter": last_updated_before_filter,
                     "latitude": latitude,
@@ -397,7 +414,9 @@ class CompletionsResource(SyncAPIResource):
                     "search_tenant": search_tenant,
                     "stop": stop,
                     "stream": stream,
+                    "stream_mode": stream_mode,
                     "temperature": temperature,
+                    "thread_id": thread_id,
                     "tool_choice": tool_choice,
                     "tools": tools,
                     "top_k": top_k,
@@ -405,6 +424,7 @@ class CompletionsResource(SyncAPIResource):
                     "top_p": top_p,
                     "updated_after_timestamp": updated_after_timestamp,
                     "updated_before_timestamp": updated_before_timestamp,
+                    "use_threads": use_threads,
                     "web_search_options": web_search_options,
                 },
                 completion_create_params.CompletionCreateParamsStreaming
@@ -462,6 +482,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         has_image_url: bool | Omit = omit,
         image_domain_filter: Optional[SequenceNotStr[str]] | Omit = omit,
         image_format_filter: Optional[SequenceNotStr[str]] | Omit = omit,
+        language_preference: Optional[str] | Omit = omit,
         last_updated_after_filter: Optional[str] | Omit = omit,
         last_updated_before_filter: Optional[str] | Omit = omit,
         latitude: Optional[float] | Omit = omit,
@@ -489,7 +510,9 @@ class AsyncCompletionsResource(AsyncAPIResource):
         search_tenant: Optional[str] | Omit = omit,
         stop: Union[str, SequenceNotStr[str], None] | Omit = omit,
         stream: Optional[Literal[False]] | Omit = omit,
+        stream_mode: Literal["full", "concise"] | Omit = omit,
         temperature: Optional[float] | Omit = omit,
+        thread_id: Optional[str] | Omit = omit,
         tool_choice: Optional[Literal["none", "auto", "required"]] | Omit = omit,
         tools: Optional[Iterable[completion_create_params.Tool]] | Omit = omit,
         top_k: Optional[int] | Omit = omit,
@@ -497,6 +520,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         top_p: Optional[float] | Omit = omit,
         updated_after_timestamp: Optional[int] | Omit = omit,
         updated_before_timestamp: Optional[int] | Omit = omit,
+        use_threads: Optional[bool] | Omit = omit,
         web_search_options: completion_create_params.WebSearchOptions | 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.
@@ -506,7 +530,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> StreamChunk:
         """
-        FastAPI wrapper around chat completions
+        Generate a chat completion response for the given conversation.
 
         Args:
           extra_headers: Send extra headers
@@ -542,6 +566,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         has_image_url: bool | Omit = omit,
         image_domain_filter: Optional[SequenceNotStr[str]] | Omit = omit,
         image_format_filter: Optional[SequenceNotStr[str]] | Omit = omit,
+        language_preference: Optional[str] | Omit = omit,
         last_updated_after_filter: Optional[str] | Omit = omit,
         last_updated_before_filter: Optional[str] | Omit = omit,
         latitude: Optional[float] | Omit = omit,
@@ -568,7 +593,9 @@ class AsyncCompletionsResource(AsyncAPIResource):
         search_recency_filter: Optional[Literal["hour", "day", "week", "month", "year"]] | Omit = omit,
         search_tenant: Optional[str] | Omit = omit,
         stop: Union[str, SequenceNotStr[str], None] | Omit = omit,
+        stream_mode: Literal["full", "concise"] | Omit = omit,
         temperature: Optional[float] | Omit = omit,
+        thread_id: Optional[str] | Omit = omit,
         tool_choice: Optional[Literal["none", "auto", "required"]] | Omit = omit,
         tools: Optional[Iterable[completion_create_params.Tool]] | Omit = omit,
         top_k: Optional[int] | Omit = omit,
@@ -576,6 +603,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         top_p: Optional[float] | Omit = omit,
         updated_after_timestamp: Optional[int] | Omit = omit,
         updated_before_timestamp: Optional[int] | Omit = omit,
+        use_threads: Optional[bool] | Omit = omit,
         web_search_options: completion_create_params.WebSearchOptions | 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.
@@ -585,7 +613,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AsyncStream[StreamChunk]:
         """
-        FastAPI wrapper around chat completions
+        Generate a chat completion response for the given conversation.
 
         Args:
           extra_headers: Send extra headers
@@ -621,6 +649,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         has_image_url: bool | Omit = omit,
         image_domain_filter: Optional[SequenceNotStr[str]] | Omit = omit,
         image_format_filter: Optional[SequenceNotStr[str]] | Omit = omit,
+        language_preference: Optional[str] | Omit = omit,
         last_updated_after_filter: Optional[str] | Omit = omit,
         last_updated_before_filter: Optional[str] | Omit = omit,
         latitude: Optional[float] | Omit = omit,
@@ -647,7 +676,9 @@ class AsyncCompletionsResource(AsyncAPIResource):
         search_recency_filter: Optional[Literal["hour", "day", "week", "month", "year"]] | Omit = omit,
         search_tenant: Optional[str] | Omit = omit,
         stop: Union[str, SequenceNotStr[str], None] | Omit = omit,
+        stream_mode: Literal["full", "concise"] | Omit = omit,
         temperature: Optional[float] | Omit = omit,
+        thread_id: Optional[str] | Omit = omit,
         tool_choice: Optional[Literal["none", "auto", "required"]] | Omit = omit,
         tools: Optional[Iterable[completion_create_params.Tool]] | Omit = omit,
         top_k: Optional[int] | Omit = omit,
@@ -655,6 +686,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         top_p: Optional[float] | Omit = omit,
         updated_after_timestamp: Optional[int] | Omit = omit,
         updated_before_timestamp: Optional[int] | Omit = omit,
+        use_threads: Optional[bool] | Omit = omit,
         web_search_options: completion_create_params.WebSearchOptions | 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.
@@ -664,7 +696,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> StreamChunk | AsyncStream[StreamChunk]:
         """
-        FastAPI wrapper around chat completions
+        Generate a chat completion response for the given conversation.
 
         Args:
           extra_headers: Send extra headers
@@ -699,6 +731,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         has_image_url: bool | Omit = omit,
         image_domain_filter: Optional[SequenceNotStr[str]] | Omit = omit,
         image_format_filter: Optional[SequenceNotStr[str]] | Omit = omit,
+        language_preference: Optional[str] | Omit = omit,
         last_updated_after_filter: Optional[str] | Omit = omit,
         last_updated_before_filter: Optional[str] | Omit = omit,
         latitude: Optional[float] | Omit = omit,
@@ -726,7 +759,9 @@ class AsyncCompletionsResource(AsyncAPIResource):
         search_tenant: Optional[str] | Omit = omit,
         stop: Union[str, SequenceNotStr[str], None] | Omit = omit,
         stream: Optional[Literal[False]] | Literal[True] | Omit = omit,
+        stream_mode: Literal["full", "concise"] | Omit = omit,
         temperature: Optional[float] | Omit = omit,
+        thread_id: Optional[str] | Omit = omit,
         tool_choice: Optional[Literal["none", "auto", "required"]] | Omit = omit,
         tools: Optional[Iterable[completion_create_params.Tool]] | Omit = omit,
         top_k: Optional[int] | Omit = omit,
@@ -734,6 +769,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         top_p: Optional[float] | Omit = omit,
         updated_after_timestamp: Optional[int] | Omit = omit,
         updated_before_timestamp: Optional[int] | Omit = omit,
+        use_threads: Optional[bool] | Omit = omit,
         web_search_options: completion_create_params.WebSearchOptions | 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.
@@ -764,6 +800,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
                     "has_image_url": has_image_url,
                     "image_domain_filter": image_domain_filter,
                     "image_format_filter": image_format_filter,
+                    "language_preference": language_preference,
                     "last_updated_after_filter": last_updated_after_filter,
                     "last_updated_before_filter": last_updated_before_filter,
                     "latitude": latitude,
@@ -791,7 +828,9 @@ class AsyncCompletionsResource(AsyncAPIResource):
                     "search_tenant": search_tenant,
                     "stop": stop,
                     "stream": stream,
+                    "stream_mode": stream_mode,
                     "temperature": temperature,
+                    "thread_id": thread_id,
                     "tool_choice": tool_choice,
                     "tools": tools,
                     "top_k": top_k,
@@ -799,6 +838,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
                     "top_p": top_p,
                     "updated_after_timestamp": updated_after_timestamp,
                     "updated_before_timestamp": updated_before_timestamp,
+                    "use_threads": use_threads,
                     "web_search_options": web_search_options,
                 },
                 completion_create_params.CompletionCreateParamsStreaming

perplexity/resources/search.py

@@ -48,7 +48,7 @@ class SearchResource(SyncAPIResource):
         self,
         *,
         query: Union[str, SequenceNotStr[str]],
-        country: Optional[str] | Omit = omit,
+        display_server_time: bool | Omit = omit,
         max_results: int | Omit = omit,
         max_tokens: int | Omit = omit,
         max_tokens_per_page: int | Omit = omit,
@@ -61,7 +61,7 @@ class SearchResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SearchCreateResponse:
         """
-        Search
+        Search the web and retrieve relevant web page contents.
 
         Args:
           extra_headers: Send extra headers
@@ -77,7 +77,7 @@ class SearchResource(SyncAPIResource):
             body=maybe_transform(
                 {
                     "query": query,
-                    "country": country,
+                    "display_server_time": display_server_time,
                     "max_results": max_results,
                     "max_tokens": max_tokens,
                     "max_tokens_per_page": max_tokens_per_page,
@@ -116,7 +116,7 @@ class AsyncSearchResource(AsyncAPIResource):
         self,
         *,
         query: Union[str, SequenceNotStr[str]],
-        country: Optional[str] | Omit = omit,
+        display_server_time: bool | Omit = omit,
         max_results: int | Omit = omit,
         max_tokens: int | Omit = omit,
         max_tokens_per_page: int | Omit = omit,
@@ -129,7 +129,7 @@ class AsyncSearchResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SearchCreateResponse:
         """
-        Search
+        Search the web and retrieve relevant web page contents.
 
         Args:
           extra_headers: Send extra headers
@@ -145,7 +145,7 @@ class AsyncSearchResource(AsyncAPIResource):
             body=await async_maybe_transform(
                 {
                     "query": query,
-                    "country": country,
+                    "display_server_time": display_server_time,
                     "max_results": max_results,
                     "max_tokens": max_tokens,
                     "max_tokens_per_page": max_tokens_per_page,

perplexity/types/async_/chat/completion_create_params.py

@@ -124,7 +124,7 @@ class RequestWebSearchOptions(TypedDict, total=False):
 
     search_context_size: Literal["low", "medium", "high"]
 
-    search_type: Literal["fast", "pro", "auto"]
+    search_type: Optional[Literal["fast", "pro", "auto"]]
 
     user_location: Optional[RequestWebSearchOptionsUserLocation]
 
@@ -166,6 +166,8 @@ class Request(TypedDict, total=False):
 
     image_format_filter: Optional[SequenceNotStr[str]]
 
+    language_preference: Optional[str]
+
     last_updated_after_filter: Optional[str]
 
     last_updated_before_filter: Optional[str]
@@ -220,8 +222,12 @@ class Request(TypedDict, total=False):
 
     stream: Optional[bool]
 
+    stream_mode: Literal["full", "concise"]
+
     temperature: Optional[float]
 
+    thread_id: Optional[str]
+
     tool_choice: Optional[Literal["none", "auto", "required"]]
 
     tools: Optional[Iterable[RequestTool]]
@@ -236,4 +242,6 @@ class Request(TypedDict, total=False):
 
     updated_before_timestamp: Optional[int]
 
+    use_threads: Optional[bool]
+
     web_search_options: RequestWebSearchOptions

perplexity/types/async_/chat/completion_get_params.py

@@ -16,6 +16,8 @@ class CompletionGetParams(TypedDict, total=False):
 
     x_client_name: Annotated[str, PropertyInfo(alias="x-client-name")]
 
+    x_created_at_epoch_seconds: Annotated[str, PropertyInfo(alias="x-created-at-epoch-seconds")]
+
     x_request_time: Annotated[str, PropertyInfo(alias="x-request-time")]
 
     x_usage_tier: Annotated[str, PropertyInfo(alias="x-usage-tier")]

perplexity/types/chat/completion_create_params.py

@@ -64,6 +64,8 @@ class CompletionCreateParamsBase(TypedDict, total=False):
 
     image_format_filter: Optional[SequenceNotStr[str]]
 
+    language_preference: Optional[str]
+
     last_updated_after_filter: Optional[str]
 
     last_updated_before_filter: Optional[str]
@@ -116,8 +118,12 @@ class CompletionCreateParamsBase(TypedDict, total=False):
 
     stop: Union[str, SequenceNotStr[str], None]
 
+    stream_mode: Literal["full", "concise"]
+
     temperature: Optional[float]
 
+    thread_id: Optional[str]
+
     tool_choice: Optional[Literal["none", "auto", "required"]]
 
     tools: Optional[Iterable[Tool]]
@@ -132,6 +138,8 @@ class CompletionCreateParamsBase(TypedDict, total=False):
 
     updated_before_timestamp: Optional[int]
 
+    use_threads: Optional[bool]
+
     web_search_options: WebSearchOptions
 
 
@@ -225,7 +233,7 @@ class WebSearchOptions(TypedDict, total=False):
 
     search_context_size: Literal["low", "medium", "high"]
 
-    search_type: Literal["fast", "pro", "auto"]
+    search_type: Optional[Literal["fast", "pro", "auto"]]
 
     user_location: Optional[WebSearchOptionsUserLocation]
 

perplexity/types/search_create_params.py

@@ -13,7 +13,7 @@ __all__ = ["SearchCreateParams"]
 class SearchCreateParams(TypedDict, total=False):
     query: Required[Union[str, SequenceNotStr[str]]]
 
-    country: Optional[str]
+    display_server_time: bool
 
     max_results: int
 

perplexity/types/search_create_response.py

@@ -23,3 +23,5 @@ class SearchCreateResponse(BaseModel):
     id: str
 
     results: List[Result]
+
+    server_time: Optional[str] = None

perplexity/types/shared/api_public_search_result.py

@@ -1,6 +1,7 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 from typing import Optional
+from typing_extensions import Literal
 
 from ..._models import BaseModel
 
@@ -17,3 +18,5 @@ class APIPublicSearchResult(BaseModel):
     last_updated: Optional[str] = None
 
     snippet: Optional[str] = None
+
+    source: Optional[Literal["web", "attachment"]] = None

perplexity/types/shared_params/api_public_search_result.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from typing import Optional
-from typing_extensions import Required, TypedDict
+from typing_extensions import Literal, Required, TypedDict
 
 __all__ = ["APIPublicSearchResult"]
 
@@ -18,3 +18,5 @@ class APIPublicSearchResult(TypedDict, total=False):
     last_updated: Optional[str]
 
     snippet: str
+
+    source: Literal["web", "attachment"]

perplexity/types/stream_chunk.py

@@ -20,8 +20,6 @@ class StreamChunk(BaseModel):
 
     model: str
 
-    usage: UsageInfo
-
     citations: Optional[List[str]] = None
 
     object: Optional[str] = None
@@ -31,3 +29,5 @@ class StreamChunk(BaseModel):
     status: Optional[Literal["PENDING", "COMPLETED"]] = None
 
     type: Optional[Literal["message", "info", "end_of_stream"]] = None
+
+    usage: Optional[UsageInfo] = None

{perplexityai-0.13.0.dist-info → perplexityai-0.14.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: perplexityai
-Version: 0.13.0
+Version: 0.14.0
 Summary: The official Python library for the perplexity API
 Project-URL: Homepage, https://github.com/perplexityai/perplexity-py
 Project-URL: Repository, https://github.com/perplexityai/perplexity-py

{perplexityai-0.13.0.dist-info → perplexityai-0.14.0.dist-info}/RECORD

@@ -11,7 +11,7 @@ perplexity/_resource.py,sha256=Pgc8KNBsIc1ltJn94uhDcDl0-3n5RLbe3iC2AiiNRnE,1124
 perplexity/_response.py,sha256=bpqzmVGq6jnivoMkUgt3OI0Rh6xHd6BMcp5PHgSFPb0,28842
 perplexity/_streaming.py,sha256=0IcQb2A1XAarVUZD3Wgll7S8D4ps1qVXSu5-HEI7-vw,11254
 perplexity/_types.py,sha256=BPuUCddonHjZ2AeEModCeb-zAYCRRT5XtxneIQhJxAk,7240
-perplexity/_version.py,sha256=nIzXJlfQywEDeOjx2PoSEuRVs7EtSZe66R6BQmVWKjs,163
+perplexity/_version.py,sha256=fJGOwcjY6lFfX7I7tUtfxwSpPhIlddGJz58x9orVjn8,163
 perplexity/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 perplexity/_utils/__init__.py,sha256=7fch0GT9zpNnErbciSpUNa-SjTxxjY6kxHxKMOM4AGs,2305
 perplexity/_utils/_compat.py,sha256=D8gtAvjJQrDWt9upS0XaG9Rr5l1QhiAx_I_1utT_tt0,1195
@@ -27,38 +27,38 @@ perplexity/_utils/_typing.py,sha256=N_5PPuFNsaygbtA_npZd98SVN1LQQvFTKL6bkWPBZGU,
 perplexity/_utils/_utils.py,sha256=0dDqauUbVZEXV0NVl7Bwu904Wwo5eyFCZpQThhFNhyA,12253
 perplexity/lib/.keep,sha256=wuNrz-5SXo3jJaJOJgz4vFHM41YH_g20F5cRQo0vLes,224
 perplexity/resources/__init__.py,sha256=Tb4UViVZDl2k8DgP1lKfn08Qaqz1uiezsogWRW9YTfQ,1414
-perplexity/resources/search.py,sha256=M72I8ZPJ_KxGwgn7FDm3kdvvRqeiFgps_Bce-AdGm8E,7146
+perplexity/resources/search.py,sha256=WEYqHwqIJcjnCa_omOVgzKuZwQtqK8pirR2OieLSabA,7298
 perplexity/resources/async_/__init__.py,sha256=hvcoEKx4nCYPDoBSO_sk-uNVQ7y-fmNhzvAlvX19TIo,964
 perplexity/resources/async_/async_.py,sha256=XzvC3AMbXXQ9mqe9TI10ZSmEuXaWPRwNC4E7AjvNdg0,3534
 perplexity/resources/async_/chat/__init__.py,sha256=BVAfz9TM3DT5W9f_mt0P9YRxL_MsUxKCWAH6u1iogmA,1041
 perplexity/resources/async_/chat/chat.py,sha256=M3hN3sfZKAt1C8FhOaWtxFPJAmPyE-GXkiU_LSN9EiA,3682
-perplexity/resources/async_/chat/completions.py,sha256=xAhxfRXduWZy3JdCSLX7eTStd_rG55qsGqmsDqFI3gM,14007
+perplexity/resources/async_/chat/completions.py,sha256=6SuFVsjkXld0iASJKVKcjPKeFivLzLToZQqqA8nqLr8,14075
 perplexity/resources/chat/__init__.py,sha256=BVAfz9TM3DT5W9f_mt0P9YRxL_MsUxKCWAH6u1iogmA,1041
 perplexity/resources/chat/chat.py,sha256=yvQmxxpr7k9-A8UwUukL5QIXHahfsdFjHQqRFWWbkzE,3680
-perplexity/resources/chat/completions.py,sha256=cAcNfJSM6xDR6sKBHC930QlZPXkvj6IpLfhxldfdxTo,43442
+perplexity/resources/chat/completions.py,sha256=fmQv0dEC1YWQr7H8Wv5sWTtxazZ2ZEf_pryu_luCVt0,45754
 perplexity/types/__init__.py,sha256=LpZgQmlRWsFC0_xIzJhxSd2VY-vxDdAplR0Oqmtnu4M,544
-perplexity/types/search_create_params.py,sha256=5cc01O0upHO7-dZrIHEi3KKhFYlCANUlhRSty4jQpHc,556
-perplexity/types/search_create_response.py,sha256=lOteaJs4qpULkx5GLtEs6HhetqIBhM0I1AC1moWTeI8,426
-perplexity/types/stream_chunk.py,sha256=TL8M2JVcxxPYiHcAuKqToUgK88yFpWgTvADR-GoBXUI,765
+perplexity/types/search_create_params.py,sha256=8K_Px2vrQ06GnyAHi89wDPV-6-iLkXaOAZ8HWkYPG1g,559
+perplexity/types/search_create_response.py,sha256=u4biwHjn5krPDOTRuolb1DyCPBRNATsuFs_Hynqxgro,465
+perplexity/types/stream_chunk.py,sha256=GxPn4KENvDhhJ8sLc297_fd3XrhZeEansYbTtjl21kA,782
 perplexity/types/async_/__init__.py,sha256=OKfJYcKb4NObdiRObqJV_dOyDQ8feXekDUge2o_4pXQ,122
 perplexity/types/async_/chat/__init__.py,sha256=xo2Cya_CfjEBRos2yvW_Wrq39PZiXFBT7ukZZBNvIUM,552
-perplexity/types/async_/chat/completion_create_params.py,sha256=qV8XTu_H9NDJmNEL5uiHxTgAaJD5_B6Pwyk1qe5QPss,5541
+perplexity/types/async_/chat/completion_create_params.py,sha256=3XC001rMxst9ZM2unL1gpVPAWYB7tr758brQCGvZOkA,5699
 perplexity/types/async_/chat/completion_create_response.py,sha256=XXYz7p2TVGn5iu5TklCm7nNpMjufuUO3YHNGPTpAmWU,676
-perplexity/types/async_/chat/completion_get_params.py,sha256=3nh10bMw1nYn3oriD5CIBPyL7hN25Xz4vbVfxEf33Zw,670
+perplexity/types/async_/chat/completion_get_params.py,sha256=1z3T0rG-xkDubzUtuBzXkI1M-pb4jcfpWpbF-Qoco7g,768
 perplexity/types/async_/chat/completion_get_response.py,sha256=YTbspM1VcWRpUa5Wxmg6P7oA3S8yLLcY2mPuBXZqECI,670
 perplexity/types/async_/chat/completion_list_response.py,sha256=63QSRV-2YA6gMZhyrmiZuzxasjjwT-kM3MyFuadTnZs,658
 perplexity/types/chat/__init__.py,sha256=9VtUhUp2vFpm5fgy2tMc-XF9NfkBXdFZvSzLmNprkqk,210
-perplexity/types/chat/completion_create_params.py,sha256=8Rl9eTRQ_eozRFrcQpcpkA3Fdh9Uh9R_YX38P5cL2dk,5545
+perplexity/types/chat/completion_create_params.py,sha256=N03I713Ck__mE9Tn5IiqOy90OGrDnQP8_hvBFOz5uDQ,5703
 perplexity/types/shared/__init__.py,sha256=-RlflcttJZ_q_lP6YD0mVWbKhU33j91tUVuMO5OqMAM,397
-perplexity/types/shared/api_public_search_result.py,sha256=0Wu4nwHvyQqV6jLvCVdEMWndCZ9DG7lgL3Y174rISX0,364
+perplexity/types/shared/api_public_search_result.py,sha256=Udw-8Or0dr_24LAhDQp-9OTkli2hw3WWp2BNEWuEeTI,461
 perplexity/types/shared/chat_message_input.py,sha256=wgqL1qb6hHU-sZgybgjL3VdAJFHdY0HjjNecey6CHLU,6118
 perplexity/types/shared/chat_message_output.py,sha256=ejnHnPuYphBCo44u5d9RKIc5tQJ98SHcbGLYR7St-CQ,6120
 perplexity/types/shared/choice.py,sha256=enGVvSlz6W4fC6scq9j_E1zxvMnSG_IxU0plF9jYiJE,427
 perplexity/types/shared/usage_info.py,sha256=_jE7Nal9cMxtEpJjT4t2SAs6z3MufrjwPugsRomqc9c,782
 perplexity/types/shared_params/__init__.py,sha256=v5gr6-wq7IWgrQ8un401oApylzh3KnsIF_ilz-roX0s,241
-perplexity/types/shared_params/api_public_search_result.py,sha256=n4VUQnGOFGGWUdwYd8P5o-vEqZKhRuI5R0dBs_ZsHtE,418
+perplexity/types/shared_params/api_public_search_result.py,sha256=JPT8jm4IALOc51HgTQGUiMbSgTt10oeh4zti4KjcnkU,469
 perplexity/types/shared_params/chat_message_input.py,sha256=BsNwhjwOFydvUo2OfrF9AHx--a1uPidSxdDyBGrK-sc,6690
-perplexityai-0.13.0.dist-info/METADATA,sha256=VFMGNqBhWuLA0axrwdV9oGmrnz2lFN-XNWpuDeAhKcI,16552
-perplexityai-0.13.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-perplexityai-0.13.0.dist-info/licenses/LICENSE,sha256=hkCriG3MT4vBhhc0roAOsrCE7IEDr1ywVEMonVHGmAQ,11340
-perplexityai-0.13.0.dist-info/RECORD,,
+perplexityai-0.14.0.dist-info/METADATA,sha256=-mdezuTZlUrTFtSswPM6pHth7XvsSYjTv2qx9vBHy_U,16552
+perplexityai-0.14.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+perplexityai-0.14.0.dist-info/licenses/LICENSE,sha256=hkCriG3MT4vBhhc0roAOsrCE7IEDr1ywVEMonVHGmAQ,11340
+perplexityai-0.14.0.dist-info/RECORD,,