feat(api): add expert answer endpoints

Author: stainless-app[bot]

.stats.yml

@@ -1,3 +1,3 @@
-configured_endpoints: 56
+configured_endpoints: 65
 openapi_spec_hash: d273ca5158facc1251efa0a5f9e723c5
-config_hash: 9e0ed146f9f6e6d1884a4c0589d6f1c2
+config_hash: cd9208a2204f43e0aa5ab35ac85ef90d

api.md

@@ -244,14 +244,43 @@ from codex.types.projects import (
 
 Methods:
 
-- <code title="post /api/projects/{project_id}/remediations/">client.projects.remediations.<a href="./src/codex/resources/projects/remediations.py">create</a>(project_id, \*\*<a href="src/codex/types/projects/remediation_create_params.py">params</a>) -> <a href="./src/codex/types/projects/remediation_create_response.py">RemediationCreateResponse</a></code>
-- <code title="get /api/projects/{project_id}/remediations/{remediation_id}">client.projects.remediations.<a href="./src/codex/resources/projects/remediations.py">retrieve</a>(remediation_id, \*, project_id) -> <a href="./src/codex/types/projects/remediation_retrieve_response.py">RemediationRetrieveResponse</a></code>
-- <code title="get /api/projects/{project_id}/remediations/">client.projects.remediations.<a href="./src/codex/resources/projects/remediations.py">list</a>(project_id, \*\*<a href="src/codex/types/projects/remediation_list_params.py">params</a>) -> <a href="./src/codex/types/projects/remediation_list_response.py">SyncOffsetPageRemediations[RemediationListResponse]</a></code>
-- <code title="delete /api/projects/{project_id}/remediations/{remediation_id}">client.projects.remediations.<a href="./src/codex/resources/projects/remediations.py">delete</a>(remediation_id, \*, project_id) -> None</code>
-- <code title="patch /api/projects/{project_id}/remediations/{remediation_id}/edit_answer">client.projects.remediations.<a href="./src/codex/resources/projects/remediations.py">edit_answer</a>(remediation_id, \*, project_id, \*\*<a href="src/codex/types/projects/remediation_edit_answer_params.py">params</a>) -> <a href="./src/codex/types/projects/remediation_edit_answer_response.py">RemediationEditAnswerResponse</a></code>
-- <code title="patch /api/projects/{project_id}/remediations/{remediation_id}/edit_draft_answer">client.projects.remediations.<a href="./src/codex/resources/projects/remediations.py">edit_draft_answer</a>(remediation_id, \*, project_id, \*\*<a href="src/codex/types/projects/remediation_edit_draft_answer_params.py">params</a>) -> <a href="./src/codex/types/projects/remediation_edit_draft_answer_response.py">RemediationEditDraftAnswerResponse</a></code>
-- <code title="get /api/projects/{project_id}/remediations/{remediation_id}/resolved_logs_count">client.projects.remediations.<a href="./src/codex/resources/projects/remediations.py">get_resolved_logs_count</a>(remediation_id, \*, project_id) -> <a href="./src/codex/types/projects/remediation_get_resolved_logs_count_response.py">RemediationGetResolvedLogsCountResponse</a></code>
-- <code title="get /api/projects/{project_id}/remediations/{remediation_id}/resolved_logs">client.projects.remediations.<a href="./src/codex/resources/projects/remediations.py">list_resolved_logs</a>(remediation_id, \*, project_id) -> <a href="./src/codex/types/projects/remediation_list_resolved_logs_response.py">RemediationListResolvedLogsResponse</a></code>
-- <code title="patch /api/projects/{project_id}/remediations/{remediation_id}/pause">client.projects.remediations.<a href="./src/codex/resources/projects/remediations.py">pause</a>(remediation_id, \*, project_id) -> <a href="./src/codex/types/projects/remediation_pause_response.py">RemediationPauseResponse</a></code>
-- <code title="patch /api/projects/{project_id}/remediations/{remediation_id}/publish">client.projects.remediations.<a href="./src/codex/resources/projects/remediations.py">publish</a>(remediation_id, \*, project_id) -> <a href="./src/codex/types/projects/remediation_publish_response.py">RemediationPublishResponse</a></code>
-- <code title="patch /api/projects/{project_id}/remediations/{remediation_id}/unpause">client.projects.remediations.<a href="./src/codex/resources/projects/remediations.py">unpause</a>(remediation_id, \*, project_id) -> <a href="./src/codex/types/projects/remediation_unpause_response.py">RemediationUnpauseResponse</a></code>
+- <code title="post /api/projects/{project_id}/remediations/">client.projects.remediations.<a href="./src/codex/resources/projects/remediations/remediations.py">create</a>(project_id, \*\*<a href="src/codex/types/projects/remediation_create_params.py">params</a>) -> <a href="./src/codex/types/projects/remediation_create_response.py">RemediationCreateResponse</a></code>
+- <code title="get /api/projects/{project_id}/remediations/{remediation_id}">client.projects.remediations.<a href="./src/codex/resources/projects/remediations/remediations.py">retrieve</a>(remediation_id, \*, project_id) -> <a href="./src/codex/types/projects/remediation_retrieve_response.py">RemediationRetrieveResponse</a></code>
+- <code title="get /api/projects/{project_id}/remediations/">client.projects.remediations.<a href="./src/codex/resources/projects/remediations/remediations.py">list</a>(project_id, \*\*<a href="src/codex/types/projects/remediation_list_params.py">params</a>) -> <a href="./src/codex/types/projects/remediation_list_response.py">SyncOffsetPageRemediations[RemediationListResponse]</a></code>
+- <code title="delete /api/projects/{project_id}/remediations/{remediation_id}">client.projects.remediations.<a href="./src/codex/resources/projects/remediations/remediations.py">delete</a>(remediation_id, \*, project_id) -> None</code>
+- <code title="patch /api/projects/{project_id}/remediations/{remediation_id}/edit_answer">client.projects.remediations.<a href="./src/codex/resources/projects/remediations/remediations.py">edit_answer</a>(remediation_id, \*, project_id, \*\*<a href="src/codex/types/projects/remediation_edit_answer_params.py">params</a>) -> <a href="./src/codex/types/projects/remediation_edit_answer_response.py">RemediationEditAnswerResponse</a></code>
+- <code title="patch /api/projects/{project_id}/remediations/{remediation_id}/edit_draft_answer">client.projects.remediations.<a href="./src/codex/resources/projects/remediations/remediations.py">edit_draft_answer</a>(remediation_id, \*, project_id, \*\*<a href="src/codex/types/projects/remediation_edit_draft_answer_params.py">params</a>) -> <a href="./src/codex/types/projects/remediation_edit_draft_answer_response.py">RemediationEditDraftAnswerResponse</a></code>
+- <code title="get /api/projects/{project_id}/remediations/{remediation_id}/resolved_logs_count">client.projects.remediations.<a href="./src/codex/resources/projects/remediations/remediations.py">get_resolved_logs_count</a>(remediation_id, \*, project_id) -> <a href="./src/codex/types/projects/remediation_get_resolved_logs_count_response.py">RemediationGetResolvedLogsCountResponse</a></code>
+- <code title="get /api/projects/{project_id}/remediations/{remediation_id}/resolved_logs">client.projects.remediations.<a href="./src/codex/resources/projects/remediations/remediations.py">list_resolved_logs</a>(remediation_id, \*, project_id) -> <a href="./src/codex/types/projects/remediation_list_resolved_logs_response.py">RemediationListResolvedLogsResponse</a></code>
+- <code title="patch /api/projects/{project_id}/remediations/{remediation_id}/pause">client.projects.remediations.<a href="./src/codex/resources/projects/remediations/remediations.py">pause</a>(remediation_id, \*, project_id) -> <a href="./src/codex/types/projects/remediation_pause_response.py">RemediationPauseResponse</a></code>
+- <code title="patch /api/projects/{project_id}/remediations/{remediation_id}/publish">client.projects.remediations.<a href="./src/codex/resources/projects/remediations/remediations.py">publish</a>(remediation_id, \*, project_id) -> <a href="./src/codex/types/projects/remediation_publish_response.py">RemediationPublishResponse</a></code>
+- <code title="patch /api/projects/{project_id}/remediations/{remediation_id}/unpause">client.projects.remediations.<a href="./src/codex/resources/projects/remediations/remediations.py">unpause</a>(remediation_id, \*, project_id) -> <a href="./src/codex/types/projects/remediation_unpause_response.py">RemediationUnpauseResponse</a></code>
+
+### ExpertAnswers
+
+Types:
+
+```python
+from codex.types.projects.remediations import (
+    ExpertAnswerCreateResponse,
+    ExpertAnswerRetrieveResponse,
+    ExpertAnswerListResponse,
+    ExpertAnswerEditAnswerResponse,
+    ExpertAnswerEditDraftAnswerResponse,
+    ExpertAnswerPauseResponse,
+    ExpertAnswerPublishResponse,
+    ExpertAnswerUnpauseResponse,
+)
+```
+
+Methods:
+
+- <code title="post /api/projects/{project_id}/expert_answers/">client.projects.remediations.expert_answers.<a href="./src/codex/resources/projects/remediations/expert_answers.py">create</a>(project_id, \*\*<a href="src/codex/types/projects/remediations/expert_answer_create_params.py">params</a>) -> <a href="./src/codex/types/projects/remediations/expert_answer_create_response.py">ExpertAnswerCreateResponse</a></code>
+- <code title="get /api/projects/{project_id}/expert_answers/{expert_answer_id}">client.projects.remediations.expert_answers.<a href="./src/codex/resources/projects/remediations/expert_answers.py">retrieve</a>(expert_answer_id, \*, project_id) -> <a href="./src/codex/types/projects/remediations/expert_answer_retrieve_response.py">ExpertAnswerRetrieveResponse</a></code>
+- <code title="get /api/projects/{project_id}/expert_answers/">client.projects.remediations.expert_answers.<a href="./src/codex/resources/projects/remediations/expert_answers.py">list</a>(project_id, \*\*<a href="src/codex/types/projects/remediations/expert_answer_list_params.py">params</a>) -> <a href="./src/codex/types/projects/remediations/expert_answer_list_response.py">SyncOffsetPageExpertAnswers[ExpertAnswerListResponse]</a></code>
+- <code title="delete /api/projects/{project_id}/expert_answers/{expert_answer_id}">client.projects.remediations.expert_answers.<a href="./src/codex/resources/projects/remediations/expert_answers.py">delete</a>(expert_answer_id, \*, project_id) -> None</code>
+- <code title="patch /api/projects/{project_id}/expert_answers/{expert_answer_id}/edit_expert_answer">client.projects.remediations.expert_answers.<a href="./src/codex/resources/projects/remediations/expert_answers.py">edit_answer</a>(expert_answer_id, \*, project_id, \*\*<a href="src/codex/types/projects/remediations/expert_answer_edit_answer_params.py">params</a>) -> <a href="./src/codex/types/projects/remediations/expert_answer_edit_answer_response.py">ExpertAnswerEditAnswerResponse</a></code>
+- <code title="patch /api/projects/{project_id}/expert_answers/{expert_answer_id}/edit_draft_expert_answer">client.projects.remediations.expert_answers.<a href="./src/codex/resources/projects/remediations/expert_answers.py">edit_draft_answer</a>(expert_answer_id, \*, project_id, \*\*<a href="src/codex/types/projects/remediations/expert_answer_edit_draft_answer_params.py">params</a>) -> <a href="./src/codex/types/projects/remediations/expert_answer_edit_draft_answer_response.py">ExpertAnswerEditDraftAnswerResponse</a></code>
+- <code title="patch /api/projects/{project_id}/expert_answers/{expert_answer_id}/pause">client.projects.remediations.expert_answers.<a href="./src/codex/resources/projects/remediations/expert_answers.py">pause</a>(expert_answer_id, \*, project_id) -> <a href="./src/codex/types/projects/remediations/expert_answer_pause_response.py">ExpertAnswerPauseResponse</a></code>
+- <code title="patch /api/projects/{project_id}/expert_answers/{expert_answer_id}/publish">client.projects.remediations.expert_answers.<a href="./src/codex/resources/projects/remediations/expert_answers.py">publish</a>(expert_answer_id, \*, project_id) -> <a href="./src/codex/types/projects/remediations/expert_answer_publish_response.py">ExpertAnswerPublishResponse</a></code>
+- <code title="patch /api/projects/{project_id}/expert_answers/{expert_answer_id}/unpause">client.projects.remediations.expert_answers.<a href="./src/codex/resources/projects/remediations/expert_answers.py">unpause</a>(expert_answer_id, \*, project_id) -> <a href="./src/codex/types/projects/remediations/expert_answer_unpause_response.py">ExpertAnswerUnpauseResponse</a></code>

src/codex/pagination.py

@@ -22,6 +22,8 @@
     "AsyncOffsetPageQueryLogGroups",
     "SyncOffsetPageQueryLogsByGroup",
     "AsyncOffsetPageQueryLogsByGroup",
+    "SyncOffsetPageExpertAnswers",
+    "AsyncOffsetPageExpertAnswers",
 ]
 
 _BaseModelT = TypeVar("_BaseModelT", bound=BaseModel)
@@ -389,3 +391,63 @@ def next_page_info(self) -> Optional[PageInfo]:
             return PageInfo(params={"offset": current_count})
 
         return None
+
+
+class SyncOffsetPageExpertAnswers(BaseSyncPage[_T], BasePage[_T], Generic[_T]):
+    expert_answers: List[_T]
+    total_count: Optional[int] = None
+
+    @override
+    def _get_page_items(self) -> List[_T]:
+        expert_answers = self.expert_answers
+        if not expert_answers:
+            return []
+        return expert_answers
+
+    @override
+    def next_page_info(self) -> Optional[PageInfo]:
+        offset = self._options.params.get("offset") or 0
+        if not isinstance(offset, int):
+            raise ValueError(f'Expected "offset" param to be an integer but got {offset}')
+
+        length = len(self._get_page_items())
+        current_count = offset + length
+
+        total_count = self.total_count
+        if total_count is None:
+            return None
+
+        if current_count < total_count:
+            return PageInfo(params={"offset": current_count})
+
+        return None
+
+
+class AsyncOffsetPageExpertAnswers(BaseAsyncPage[_T], BasePage[_T], Generic[_T]):
+    expert_answers: List[_T]
+    total_count: Optional[int] = None
+
+    @override
+    def _get_page_items(self) -> List[_T]:
+        expert_answers = self.expert_answers
+        if not expert_answers:
+            return []
+        return expert_answers
+
+    @override
+    def next_page_info(self) -> Optional[PageInfo]:
+        offset = self._options.params.get("offset") or 0
+        if not isinstance(offset, int):
+            raise ValueError(f'Expected "offset" param to be an integer but got {offset}')
+
+        length = len(self._get_page_items())
+        current_count = offset + length
+
+        total_count = self.total_count
+        if total_count is None:
+            return None
+
+        if current_count < total_count:
+            return PageInfo(params={"offset": current_count})
+
+        return None

src/codex/resources/projects/projects.py

@@ -51,15 +51,15 @@
     AccessKeysResourceWithStreamingResponse,
     AsyncAccessKeysResourceWithStreamingResponse,
 )
-from .remediations import (
+from ..._base_client import make_request_options
+from .remediations.remediations import (
     RemediationsResource,
     AsyncRemediationsResource,
     RemediationsResourceWithRawResponse,
     AsyncRemediationsResourceWithRawResponse,
     RemediationsResourceWithStreamingResponse,
     AsyncRemediationsResourceWithStreamingResponse,
 )
-from ..._base_client import make_request_options
 from ...types.project_list_response import ProjectListResponse
 from ...types.project_return_schema import ProjectReturnSchema
 from ...types.project_detect_response import ProjectDetectResponse

src/codex/resources/projects/remediations/__init__.py

@@ -0,0 +1,33 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .remediations import (
+    RemediationsResource,
+    AsyncRemediationsResource,
+    RemediationsResourceWithRawResponse,
+    AsyncRemediationsResourceWithRawResponse,
+    RemediationsResourceWithStreamingResponse,
+    AsyncRemediationsResourceWithStreamingResponse,
+)
+from .expert_answers import (
+    ExpertAnswersResource,
+    AsyncExpertAnswersResource,
+    ExpertAnswersResourceWithRawResponse,
+    AsyncExpertAnswersResourceWithRawResponse,
+    ExpertAnswersResourceWithStreamingResponse,
+    AsyncExpertAnswersResourceWithStreamingResponse,
+)
+
+__all__ = [
+    "ExpertAnswersResource",
+    "AsyncExpertAnswersResource",
+    "ExpertAnswersResourceWithRawResponse",
+    "AsyncExpertAnswersResourceWithRawResponse",
+    "ExpertAnswersResourceWithStreamingResponse",
+    "AsyncExpertAnswersResourceWithStreamingResponse",
+    "RemediationsResource",
+    "AsyncRemediationsResource",
+    "RemediationsResourceWithRawResponse",
+    "AsyncRemediationsResourceWithRawResponse",
+    "RemediationsResourceWithStreamingResponse",
+    "AsyncRemediationsResourceWithStreamingResponse",
+]