feat(api): update via SDK Studio

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 46
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/contextual-ai%2Fsunrise-c978f14e96782dd2ca8a8dbfdd822941e52df70306cb99d93218c61363460f03.yml
-openapi_spec_hash: 57aec46adc855c43bcd349940fbc247d
-config_hash: 47781a5702123e4592e019351ce8cf45
+configured_endpoints: 52
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/contextual-ai%2Fsunrise-1ec5b5b63e3fe6f99de6eae32dc51fde7c2bc960703b43c99e58fdfe4e3b4c21.yml
+openapi_spec_hash: e75e261b83ee7c3d524a3c28c949d227
+config_hash: f0c8dfba598e8ad313dc6b95c7b34df6

README.md

@@ -150,8 +150,13 @@ client = ContextualAI()
 create_agent_output = client.agents.create(
     name="xxx",
     agent_configs={
-        "filter_and_rerank_config": {"top_k_reranked_chunks": 0},
+        "filter_and_rerank_config": {
+            "rerank_instructions": "rerank_instructions",
+            "reranker_score_filter_threshold": 0,
+            "top_k_reranked_chunks": 0,
+        },
         "generate_response_config": {
+            "avoid_commentary": True,
             "calculate_groundedness": True,
             "frequency_penalty": 0,
             "max_new_tokens": 0,
@@ -163,6 +168,7 @@ create_agent_output = client.agents.create(
             "enable_filter": True,
             "enable_multi_turn": True,
             "enable_rerank": True,
+            "should_check_retrieval_need": True,
         },
         "retrieval_config": {
             "lexical_alpha": 0,

api.md

@@ -9,6 +9,7 @@ from contextual.types import (
     DatastoreMetadata,
     ListDatastoresResponse,
     DatastoreDeleteResponse,
+    DatastoreResetResponse,
 )
 ```
 
@@ -18,6 +19,7 @@ Methods:
 - <code title="get /datastores">client.datastores.<a href="./src/contextual/resources/datastores/datastores.py">list</a>(\*\*<a href="src/contextual/types/datastore_list_params.py">params</a>) -> <a href="./src/contextual/types/datastore.py">SyncDatastoresPage[Datastore]</a></code>
 - <code title="delete /datastores/{datastore_id}">client.datastores.<a href="./src/contextual/resources/datastores/datastores.py">delete</a>(datastore_id) -> <a href="./src/contextual/types/datastore_delete_response.py">object</a></code>
 - <code title="get /datastores/{datastore_id}/metadata">client.datastores.<a href="./src/contextual/resources/datastores/datastores.py">metadata</a>(datastore_id) -> <a href="./src/contextual/types/datastore_metadata.py">DatastoreMetadata</a></code>
+- <code title="put /datastores/{datastore_id}/reset">client.datastores.<a href="./src/contextual/resources/datastores/datastores.py">reset</a>(datastore_id) -> <a href="./src/contextual/types/datastore_reset_response.py">object</a></code>
 
 ## Documents
 
@@ -53,6 +55,8 @@ from contextual.types import (
     ListAgentsResponse,
     AgentUpdateResponse,
     AgentDeleteResponse,
+    AgentMetadataResponse,
+    AgentResetResponse,
 )
 ```
 
@@ -62,7 +66,8 @@ Methods:
 - <code title="put /agents/{agent_id}">client.agents.<a href="./src/contextual/resources/agents/agents.py">update</a>(agent_id, \*\*<a href="src/contextual/types/agent_update_params.py">params</a>) -> <a href="./src/contextual/types/agent_update_response.py">object</a></code>
 - <code title="get /agents">client.agents.<a href="./src/contextual/resources/agents/agents.py">list</a>(\*\*<a href="src/contextual/types/agent_list_params.py">params</a>) -> <a href="./src/contextual/types/agent.py">SyncPage[Agent]</a></code>
 - <code title="delete /agents/{agent_id}">client.agents.<a href="./src/contextual/resources/agents/agents.py">delete</a>(agent_id) -> <a href="./src/contextual/types/agent_delete_response.py">object</a></code>
-- <code title="get /agents/{agent_id}/metadata">client.agents.<a href="./src/contextual/resources/agents/agents.py">metadata</a>(agent_id) -> <a href="./src/contextual/types/agent_metadata.py">AgentMetadata</a></code>
+- <code title="get /agents/{agent_id}/metadata">client.agents.<a href="./src/contextual/resources/agents/agents.py">metadata</a>(agent_id) -> <a href="./src/contextual/types/agent_metadata_response.py">AgentMetadataResponse</a></code>
+- <code title="put /agents/{agent_id}/reset">client.agents.<a href="./src/contextual/resources/agents/agents.py">reset</a>(agent_id) -> <a href="./src/contextual/types/agent_reset_response.py">object</a></code>
 
 ## Query
 
@@ -250,3 +255,23 @@ from contextual.types import GenerateCreateResponse
 Methods:
 
 - <code title="post /generate">client.generate.<a href="./src/contextual/resources/generate.py">create</a>(\*\*<a href="src/contextual/types/generate_create_params.py">params</a>) -> <a href="./src/contextual/types/generate_create_response.py">GenerateCreateResponse</a></code>
+
+# Parse
+
+Types:
+
+```python
+from contextual.types import (
+    ParseCreateResponse,
+    ParseJobResultsResponse,
+    ParseJobStatusResponse,
+    ParseJobsResponse,
+)
+```
+
+Methods:
+
+- <code title="post /parse">client.parse.<a href="./src/contextual/resources/parse.py">create</a>(\*\*<a href="src/contextual/types/parse_create_params.py">params</a>) -> <a href="./src/contextual/types/parse_create_response.py">ParseCreateResponse</a></code>
+- <code title="get /parse/jobs/{job_id}/results">client.parse.<a href="./src/contextual/resources/parse.py">job_results</a>(job_id, \*\*<a href="src/contextual/types/parse_job_results_params.py">params</a>) -> <a href="./src/contextual/types/parse_job_results_response.py">ParseJobResultsResponse</a></code>
+- <code title="get /parse/jobs/{job_id}/status">client.parse.<a href="./src/contextual/resources/parse.py">job_status</a>(job_id) -> <a href="./src/contextual/types/parse_job_status_response.py">ParseJobStatusResponse</a></code>
+- <code title="get /parse/jobs">client.parse.<a href="./src/contextual/resources/parse.py">jobs</a>(\*\*<a href="src/contextual/types/parse_jobs_params.py">params</a>) -> <a href="./src/contextual/types/parse_jobs_response.py">ParseJobsResponse</a></code>

src/contextual/_client.py

@@ -31,7 +31,8 @@
 )
 
 if TYPE_CHECKING:
-    from .resources import users, agents, lmunit, rerank, generate, datastores
+    from .resources import parse, users, agents, lmunit, rerank, generate, datastores
+    from .resources.parse import ParseResource, AsyncParseResource
     from .resources.users import UsersResource, AsyncUsersResource
     from .resources.lmunit import LMUnitResource, AsyncLMUnitResource
     from .resources.rerank import RerankResource, AsyncRerankResource
@@ -150,6 +151,12 @@ def generate(self) -> GenerateResource:
 
         return GenerateResource(self)
 
+    @cached_property
+    def parse(self) -> ParseResource:
+        from .resources.parse import ParseResource
+
+        return ParseResource(self)
+
     @cached_property
     def with_raw_response(self) -> ContextualAIWithRawResponse:
         return ContextualAIWithRawResponse(self)
@@ -367,6 +374,12 @@ def generate(self) -> AsyncGenerateResource:
 
         return AsyncGenerateResource(self)
 
+    @cached_property
+    def parse(self) -> AsyncParseResource:
+        from .resources.parse import AsyncParseResource
+
+        return AsyncParseResource(self)
+
     @cached_property
     def with_raw_response(self) -> AsyncContextualAIWithRawResponse:
         return AsyncContextualAIWithRawResponse(self)
@@ -527,6 +540,12 @@ def generate(self) -> generate.GenerateResourceWithRawResponse:
 
         return GenerateResourceWithRawResponse(self._client.generate)
 
+    @cached_property
+    def parse(self) -> parse.ParseResourceWithRawResponse:
+        from .resources.parse import ParseResourceWithRawResponse
+
+        return ParseResourceWithRawResponse(self._client.parse)
+
 
 class AsyncContextualAIWithRawResponse:
     _client: AsyncContextualAI
@@ -570,6 +589,12 @@ def generate(self) -> generate.AsyncGenerateResourceWithRawResponse:
 
         return AsyncGenerateResourceWithRawResponse(self._client.generate)
 
+    @cached_property
+    def parse(self) -> parse.AsyncParseResourceWithRawResponse:
+        from .resources.parse import AsyncParseResourceWithRawResponse
+
+        return AsyncParseResourceWithRawResponse(self._client.parse)
+
 
 class ContextualAIWithStreamedResponse:
     _client: ContextualAI
@@ -613,6 +638,12 @@ def generate(self) -> generate.GenerateResourceWithStreamingResponse:
 
         return GenerateResourceWithStreamingResponse(self._client.generate)
 
+    @cached_property
+    def parse(self) -> parse.ParseResourceWithStreamingResponse:
+        from .resources.parse import ParseResourceWithStreamingResponse
+
+        return ParseResourceWithStreamingResponse(self._client.parse)
+
 
 class AsyncContextualAIWithStreamedResponse:
     _client: AsyncContextualAI
@@ -656,6 +687,12 @@ def generate(self) -> generate.AsyncGenerateResourceWithStreamingResponse:
 
         return AsyncGenerateResourceWithStreamingResponse(self._client.generate)
 
+    @cached_property
+    def parse(self) -> parse.AsyncParseResourceWithStreamingResponse:
+        from .resources.parse import AsyncParseResourceWithStreamingResponse
+
+        return AsyncParseResourceWithStreamingResponse(self._client.parse)
+
 
 Client = ContextualAI
 

src/contextual/resources/__init__.py

@@ -1,5 +1,13 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+from .parse import (
+    ParseResource,
+    AsyncParseResource,
+    ParseResourceWithRawResponse,
+    AsyncParseResourceWithRawResponse,
+    ParseResourceWithStreamingResponse,
+    AsyncParseResourceWithStreamingResponse,
+)
 from .users import (
     UsersResource,
     AsyncUsersResource,
@@ -86,4 +94,10 @@
     "AsyncGenerateResourceWithRawResponse",
     "GenerateResourceWithStreamingResponse",
     "AsyncGenerateResourceWithStreamingResponse",
+    "ParseResource",
+    "AsyncParseResource",
+    "ParseResourceWithRawResponse",
+    "AsyncParseResourceWithRawResponse",
+    "ParseResourceWithStreamingResponse",
+    "AsyncParseResourceWithStreamingResponse",
 ]