perplexityai 0.18.0__tar.gz → 0.19.1__tar.gz

perplexityai-0.19.1/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.19.1"
+}

{perplexityai-0.18.0 → perplexityai-0.19.1}/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.19.1 (2025-10-31)
+
+Full Changelog: [v0.19.0...v0.19.1](https://github.com/perplexityai/perplexity-py/compare/v0.19.0...v0.19.1)
+
+### Bug Fixes
+
+* **client:** close streams without requiring full consumption ([2d7b697](https://github.com/perplexityai/perplexity-py/commit/2d7b697dc5fce75416c4e770dc6c086bf0e7ec2a))
+
+
+### Chores
+
+* **internal/tests:** avoid race condition with implicit client cleanup ([5eb163f](https://github.com/perplexityai/perplexity-py/commit/5eb163fcff3a0f0bd9ecbc87407627e044535fee))
+
+## 0.19.0 (2025-10-30)
+
+Full Changelog: [v0.18.0...v0.19.0](https://github.com/perplexityai/perplexity-py/compare/v0.18.0...v0.19.0)
+
+### Features
+
+* **api:** manual updates ([d32c134](https://github.com/perplexityai/perplexity-py/commit/d32c1346744e5521a50da56e0d5a81261fd53f27))
+
 ## 0.18.0 (2025-10-29)
 
 Full Changelog: [v0.17.1...v0.18.0](https://github.com/perplexityai/perplexity-py/compare/v0.17.1...v0.18.0)

{perplexityai-0.18.0 → perplexityai-0.19.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: perplexityai
-Version: 0.18.0
+Version: 0.19.1
 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
@@ -246,9 +246,9 @@ stream_chunk = client.chat.completions.create(
         }
     ],
     model="model",
-    debug_params={},
+    web_search_options={},
 )
-print(stream_chunk.debug_params)
+print(stream_chunk.web_search_options)
 ```
 
 ## Handling errors

{perplexityai-0.18.0 → perplexityai-0.19.1}/README.md

@@ -211,9 +211,9 @@ stream_chunk = client.chat.completions.create(
         }
     ],
     model="model",
-    debug_params={},
+    web_search_options={},
 )
-print(stream_chunk.debug_params)
+print(stream_chunk.web_search_options)
 ```
 
 ## Handling errors

{perplexityai-0.18.0 → perplexityai-0.19.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "perplexityai"
-version = "0.18.0"
+version = "0.19.1"
 description = "The official Python library for the perplexity API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{perplexityai-0.18.0 → perplexityai-0.19.1}/src/perplexity/_streaming.py

@@ -76,9 +76,8 @@ class Stream(Generic[_T]):
             if sse.event is None:
                 yield process_data(data=sse.json(), cast_to=cast_to, response=response)
 
-        # Ensure the entire stream is consumed
-        for _sse in iterator:
-            ...
+        # As we might not fully consume the response stream, we need to close it explicitly
+        response.close()
 
     def __enter__(self) -> Self:
         return self
@@ -159,9 +158,8 @@ class AsyncStream(Generic[_T]):
             if sse.event is None:
                 yield process_data(data=sse.json(), cast_to=cast_to, response=response)
 
-        # Ensure the entire stream is consumed
-        async for _sse in iterator:
-            ...
+        # As we might not fully consume the response stream, we need to close it explicitly
+        await response.aclose()
 
     async def __aenter__(self) -> Self:
         return self

{perplexityai-0.18.0 → perplexityai-0.19.1}/src/perplexity/_version.py

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

{perplexityai-0.18.0 → perplexityai-0.19.1}/src/perplexity/resources/chat/completions.py

@@ -59,7 +59,6 @@ class CompletionsResource(SyncAPIResource):
         best_of: Optional[int] | Omit = omit,
         country: Optional[str] | Omit = omit,
         cum_logprobs: Optional[bool] | Omit = omit,
-        debug_params: Optional[completion_create_params.DebugParams] | Omit = omit,
         disable_search: Optional[bool] | Omit = omit,
         diverse_first_token: Optional[bool] | Omit = omit,
         enable_search_classifier: Optional[bool] | Omit = omit,
@@ -143,7 +142,6 @@ class CompletionsResource(SyncAPIResource):
         best_of: Optional[int] | Omit = omit,
         country: Optional[str] | Omit = omit,
         cum_logprobs: Optional[bool] | Omit = omit,
-        debug_params: Optional[completion_create_params.DebugParams] | Omit = omit,
         disable_search: Optional[bool] | Omit = omit,
         diverse_first_token: Optional[bool] | Omit = omit,
         enable_search_classifier: Optional[bool] | Omit = omit,
@@ -226,7 +224,6 @@ class CompletionsResource(SyncAPIResource):
         best_of: Optional[int] | Omit = omit,
         country: Optional[str] | Omit = omit,
         cum_logprobs: Optional[bool] | Omit = omit,
-        debug_params: Optional[completion_create_params.DebugParams] | Omit = omit,
         disable_search: Optional[bool] | Omit = omit,
         diverse_first_token: Optional[bool] | Omit = omit,
         enable_search_classifier: Optional[bool] | Omit = omit,
@@ -308,7 +305,6 @@ class CompletionsResource(SyncAPIResource):
         best_of: Optional[int] | Omit = omit,
         country: Optional[str] | Omit = omit,
         cum_logprobs: Optional[bool] | Omit = omit,
-        debug_params: Optional[completion_create_params.DebugParams] | Omit = omit,
         disable_search: Optional[bool] | Omit = omit,
         diverse_first_token: Optional[bool] | Omit = omit,
         enable_search_classifier: Optional[bool] | Omit = omit,
@@ -377,7 +373,6 @@ class CompletionsResource(SyncAPIResource):
                     "best_of": best_of,
                     "country": country,
                     "cum_logprobs": cum_logprobs,
-                    "debug_params": debug_params,
                     "disable_search": disable_search,
                     "diverse_first_token": diverse_first_token,
                     "enable_search_classifier": enable_search_classifier,
@@ -473,7 +468,6 @@ class AsyncCompletionsResource(AsyncAPIResource):
         best_of: Optional[int] | Omit = omit,
         country: Optional[str] | Omit = omit,
         cum_logprobs: Optional[bool] | Omit = omit,
-        debug_params: Optional[completion_create_params.DebugParams] | Omit = omit,
         disable_search: Optional[bool] | Omit = omit,
         diverse_first_token: Optional[bool] | Omit = omit,
         enable_search_classifier: Optional[bool] | Omit = omit,
@@ -557,7 +551,6 @@ class AsyncCompletionsResource(AsyncAPIResource):
         best_of: Optional[int] | Omit = omit,
         country: Optional[str] | Omit = omit,
         cum_logprobs: Optional[bool] | Omit = omit,
-        debug_params: Optional[completion_create_params.DebugParams] | Omit = omit,
         disable_search: Optional[bool] | Omit = omit,
         diverse_first_token: Optional[bool] | Omit = omit,
         enable_search_classifier: Optional[bool] | Omit = omit,
@@ -640,7 +633,6 @@ class AsyncCompletionsResource(AsyncAPIResource):
         best_of: Optional[int] | Omit = omit,
         country: Optional[str] | Omit = omit,
         cum_logprobs: Optional[bool] | Omit = omit,
-        debug_params: Optional[completion_create_params.DebugParams] | Omit = omit,
         disable_search: Optional[bool] | Omit = omit,
         diverse_first_token: Optional[bool] | Omit = omit,
         enable_search_classifier: Optional[bool] | Omit = omit,
@@ -722,7 +714,6 @@ class AsyncCompletionsResource(AsyncAPIResource):
         best_of: Optional[int] | Omit = omit,
         country: Optional[str] | Omit = omit,
         cum_logprobs: Optional[bool] | Omit = omit,
-        debug_params: Optional[completion_create_params.DebugParams] | Omit = omit,
         disable_search: Optional[bool] | Omit = omit,
         diverse_first_token: Optional[bool] | Omit = omit,
         enable_search_classifier: Optional[bool] | Omit = omit,
@@ -791,7 +782,6 @@ class AsyncCompletionsResource(AsyncAPIResource):
                     "best_of": best_of,
                     "country": country,
                     "cum_logprobs": cum_logprobs,
-                    "debug_params": debug_params,
                     "disable_search": disable_search,
                     "diverse_first_token": diverse_first_token,
                     "enable_search_classifier": enable_search_classifier,

{perplexityai-0.18.0 → perplexityai-0.19.1}/src/perplexity/types/async_/chat/completion_create_params.py

@@ -11,7 +11,6 @@ from ...shared_params.chat_message_input import ChatMessageInput
 __all__ = [
     "CompletionCreateParams",
     "Request",
-    "RequestDebugParams",
     "RequestResponseFormat",
     "RequestResponseFormatResponseFormatText",
     "RequestResponseFormatResponseFormatJsonSchema",
@@ -32,12 +31,6 @@ class CompletionCreateParams(TypedDict, total=False):
     idempotency_key: Optional[str]
 
 
-class RequestDebugParams(TypedDict, total=False):
-    summarizer_model_override: Optional[str]
-
-    summarizer_prompt_override: Optional[str]
-
-
 class RequestResponseFormatResponseFormatText(TypedDict, total=False):
     type: Required[Literal["text"]]
 
@@ -148,8 +141,6 @@ class Request(TypedDict, total=False):
 
     cum_logprobs: Optional[bool]
 
-    debug_params: Optional[RequestDebugParams]
-
     disable_search: Optional[bool]
 
     diverse_first_token: Optional[bool]

{perplexityai-0.18.0 → perplexityai-0.19.1}/src/perplexity/types/chat/completion_create_params.py

@@ -10,7 +10,6 @@ from ..shared_params.chat_message_input import ChatMessageInput
 
 __all__ = [
     "CompletionCreateParamsBase",
-    "DebugParams",
     "ResponseFormat",
     "ResponseFormatResponseFormatText",
     "ResponseFormatResponseFormatJsonSchema",
@@ -46,8 +45,6 @@ class CompletionCreateParamsBase(TypedDict, total=False):
 
     cum_logprobs: Optional[bool]
 
-    debug_params: Optional[DebugParams]
-
     disable_search: Optional[bool]
 
     diverse_first_token: Optional[bool]
@@ -143,12 +140,6 @@ class CompletionCreateParamsBase(TypedDict, total=False):
     web_search_options: WebSearchOptions
 
 
-class DebugParams(TypedDict, total=False):
-    summarizer_model_override: Optional[str]
-
-    summarizer_prompt_override: Optional[str]
-
-
 class ResponseFormatResponseFormatText(TypedDict, total=False):
     type: Required[Literal["text"]]
 

{perplexityai-0.18.0 → perplexityai-0.19.1}/src/perplexity/types/shared/chat_message_input.py

@@ -155,16 +155,6 @@ class ReasoningStepWebSearch(BaseModel):
 class ReasoningStep(BaseModel):
     thought: str
 
-    type: Literal[
-        "web_search",
-        "fetch_url_content",
-        "execute_python",
-        "agent_progress",
-        "browser_agent",
-        "browser_tool_execution",
-        "file_attachment_search",
-    ]
-
     agent_progress: Optional[ReasoningStepAgentProgress] = None
     """Agent progress class for live-browsing updates"""
 
@@ -183,6 +173,8 @@ class ReasoningStep(BaseModel):
     file_attachment_search: Optional[ReasoningStepFileAttachmentSearch] = None
     """File attachment search step details wrapper class"""
 
+    type: Optional[str] = None
+
     web_search: Optional[ReasoningStepWebSearch] = None
     """Web search step details wrapper class"""
 

{perplexityai-0.18.0 → perplexityai-0.19.1}/src/perplexity/types/shared/chat_message_output.py

@@ -155,16 +155,6 @@ class ReasoningStepWebSearch(BaseModel):
 class ReasoningStep(BaseModel):
     thought: str
 
-    type: Literal[
-        "web_search",
-        "fetch_url_content",
-        "execute_python",
-        "agent_progress",
-        "browser_agent",
-        "browser_tool_execution",
-        "file_attachment_search",
-    ]
-
     agent_progress: Optional[ReasoningStepAgentProgress] = None
     """Agent progress class for live-browsing updates"""
 
@@ -183,6 +173,8 @@ class ReasoningStep(BaseModel):
     file_attachment_search: Optional[ReasoningStepFileAttachmentSearch] = None
     """File attachment search step details wrapper class"""
 
+    type: Optional[str] = None
+
     web_search: Optional[ReasoningStepWebSearch] = None
     """Web search step details wrapper class"""
 

{perplexityai-0.18.0 → perplexityai-0.19.1}/src/perplexity/types/shared_params/chat_message_input.py

@@ -157,18 +157,6 @@ class ReasoningStepWebSearch(TypedDict, total=False):
 class ReasoningStep(TypedDict, total=False):
     thought: Required[str]
 
-    type: Required[
-        Literal[
-            "web_search",
-            "fetch_url_content",
-            "execute_python",
-            "agent_progress",
-            "browser_agent",
-            "browser_tool_execution",
-            "file_attachment_search",
-        ]
-    ]
-
     agent_progress: Optional[ReasoningStepAgentProgress]
     """Agent progress class for live-browsing updates"""
 
@@ -187,6 +175,8 @@ class ReasoningStep(TypedDict, total=False):
     file_attachment_search: Optional[ReasoningStepFileAttachmentSearch]
     """File attachment search step details wrapper class"""
 
+    type: Optional[str]
+
     web_search: Optional[ReasoningStepWebSearch]
     """Web search step details wrapper class"""
 

{perplexityai-0.18.0 → perplexityai-0.19.1}/tests/api_resources/async_/chat/test_completions.py

@@ -49,7 +49,6 @@ class TestCompletions:
                         "reasoning_steps": [
                             {
                                 "thought": "thought",
-                                "type": "web_search",
                                 "agent_progress": {
                                     "action": "action",
                                     "screenshot": "screenshot",
@@ -77,6 +76,7 @@ class TestCompletions:
                                     ]
                                 },
                                 "file_attachment_search": {"attachment_urls": ["string"]},
+                                "type": "type",
                                 "web_search": {
                                     "search_keywords": ["string"],
                                     "search_results": [
@@ -112,10 +112,6 @@ class TestCompletions:
                 "best_of": 0,
                 "country": "country",
                 "cum_logprobs": True,
-                "debug_params": {
-                    "summarizer_model_override": "summarizer_model_override",
-                    "summarizer_prompt_override": "summarizer_prompt_override",
-                },
                 "disable_search": True,
                 "diverse_first_token": True,
                 "enable_search_classifier": True,
@@ -356,7 +352,6 @@ class TestAsyncCompletions:
                         "reasoning_steps": [
                             {
                                 "thought": "thought",
-                                "type": "web_search",
                                 "agent_progress": {
                                     "action": "action",
                                     "screenshot": "screenshot",
@@ -384,6 +379,7 @@ class TestAsyncCompletions:
                                     ]
                                 },
                                 "file_attachment_search": {"attachment_urls": ["string"]},
+                                "type": "type",
                                 "web_search": {
                                     "search_keywords": ["string"],
                                     "search_results": [
@@ -419,10 +415,6 @@ class TestAsyncCompletions:
                 "best_of": 0,
                 "country": "country",
                 "cum_logprobs": True,
-                "debug_params": {
-                    "summarizer_model_override": "summarizer_model_override",
-                    "summarizer_prompt_override": "summarizer_prompt_override",
-                },
                 "disable_search": True,
                 "diverse_first_token": True,
                 "enable_search_classifier": True,

{perplexityai-0.18.0 → perplexityai-0.19.1}/tests/api_resources/chat/test_completions.py

@@ -42,7 +42,6 @@ class TestCompletions:
                     "reasoning_steps": [
                         {
                             "thought": "thought",
-                            "type": "web_search",
                             "agent_progress": {
                                 "action": "action",
                                 "screenshot": "screenshot",
@@ -70,6 +69,7 @@ class TestCompletions:
                                 ]
                             },
                             "file_attachment_search": {"attachment_urls": ["string"]},
+                            "type": "type",
                             "web_search": {
                                 "search_keywords": ["string"],
                                 "search_results": [
@@ -105,10 +105,6 @@ class TestCompletions:
             best_of=0,
             country="country",
             cum_logprobs=True,
-            debug_params={
-                "summarizer_model_override": "summarizer_model_override",
-                "summarizer_prompt_override": "summarizer_prompt_override",
-            },
             disable_search=True,
             diverse_first_token=True,
             enable_search_classifier=True,
@@ -250,7 +246,6 @@ class TestCompletions:
                     "reasoning_steps": [
                         {
                             "thought": "thought",
-                            "type": "web_search",
                             "agent_progress": {
                                 "action": "action",
                                 "screenshot": "screenshot",
@@ -278,6 +273,7 @@ class TestCompletions:
                                 ]
                             },
                             "file_attachment_search": {"attachment_urls": ["string"]},
+                            "type": "type",
                             "web_search": {
                                 "search_keywords": ["string"],
                                 "search_results": [
@@ -314,10 +310,6 @@ class TestCompletions:
             best_of=0,
             country="country",
             cum_logprobs=True,
-            debug_params={
-                "summarizer_model_override": "summarizer_model_override",
-                "summarizer_prompt_override": "summarizer_prompt_override",
-            },
             disable_search=True,
             diverse_first_token=True,
             enable_search_classifier=True,
@@ -464,7 +456,6 @@ class TestAsyncCompletions:
                     "reasoning_steps": [
                         {
                             "thought": "thought",
-                            "type": "web_search",
                             "agent_progress": {
                                 "action": "action",
                                 "screenshot": "screenshot",
@@ -492,6 +483,7 @@ class TestAsyncCompletions:
                                 ]
                             },
                             "file_attachment_search": {"attachment_urls": ["string"]},
+                            "type": "type",
                             "web_search": {
                                 "search_keywords": ["string"],
                                 "search_results": [
@@ -527,10 +519,6 @@ class TestAsyncCompletions:
             best_of=0,
             country="country",
             cum_logprobs=True,
-            debug_params={
-                "summarizer_model_override": "summarizer_model_override",
-                "summarizer_prompt_override": "summarizer_prompt_override",
-            },
             disable_search=True,
             diverse_first_token=True,
             enable_search_classifier=True,
@@ -672,7 +660,6 @@ class TestAsyncCompletions:
                     "reasoning_steps": [
                         {
                             "thought": "thought",
-                            "type": "web_search",
                             "agent_progress": {
                                 "action": "action",
                                 "screenshot": "screenshot",
@@ -700,6 +687,7 @@ class TestAsyncCompletions:
                                 ]
                             },
                             "file_attachment_search": {"attachment_urls": ["string"]},
+                            "type": "type",
                             "web_search": {
                                 "search_keywords": ["string"],
                                 "search_results": [
@@ -736,10 +724,6 @@ class TestAsyncCompletions:
             best_of=0,
             country="country",
             cum_logprobs=True,
-            debug_params={
-                "summarizer_model_override": "summarizer_model_override",
-                "summarizer_prompt_override": "summarizer_prompt_override",
-            },
             disable_search=True,
             diverse_first_token=True,
             enable_search_classifier=True,