feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,3 +1,3 @@
 configured_endpoints: 56
-openapi_spec_hash: 12260ab88069ff15d254606e041debfb
+openapi_spec_hash: 3edbb8139be919b07598ed85ebea9878
 config_hash: 6c3ad84d97bf1d0989ad2ec0cae64078

src/codex/resources/projects/query_logs.py

@@ -147,6 +147,17 @@ def list(
 
           primary_eval_issue: Filter logs that have ANY of these primary evaluation issues (OR operation)
 
+          sort: Field or score to sort by.
+
+              Available fields: 'created_at', 'primary_eval_issue_score'.
+
+              For eval scores, use '.eval.' prefix followed by the eval name.
+
+              Default eval scores: '.eval.trustworthiness', '.eval.context_sufficiency',
+              '.eval.response_helpfulness', '.eval.query_ease', '.eval.response_groundedness'.
+
+              Custom eval scores: '.eval.custom_eval_1', '.eval.custom_eval_2', etc.
+
           tool_call_names: Filter by names of tools called in the assistant response
 
           was_cache_hit: Filter by cache hit status
@@ -286,6 +297,17 @@ def list_by_group(
 
           remediation_ids: List of groups to list child logs for
 
+          sort: Field or score to sort by.
+
+              Available fields: 'created_at', 'primary_eval_issue_score'.
+
+              For eval scores, use '.eval.' prefix followed by the eval name.
+
+              Default eval scores: '.eval.trustworthiness', '.eval.context_sufficiency',
+              '.eval.response_helpfulness', '.eval.query_ease', '.eval.response_groundedness'.
+
+              Custom eval scores: '.eval.custom_eval_1', '.eval.custom_eval_2', etc.
+
           tool_call_names: Filter by names of tools called in the assistant response
 
           was_cache_hit: Filter by cache hit status
@@ -351,8 +373,7 @@ def list_groups(
             List[Literal["hallucination", "search_failure", "unhelpful", "difficult_query", "ungrounded"]]
         ]
         | NotGiven = NOT_GIVEN,
-        sort: Optional[Literal["created_at", "primary_eval_issue_score", "total_count", "custom_rank", "impact_score"]]
-        | NotGiven = NOT_GIVEN,
+        sort: Optional[str] | NotGiven = NOT_GIVEN,
         tool_call_names: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
         was_cache_hit: Optional[bool] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -384,6 +405,18 @@ def list_groups(
 
           primary_eval_issue: Filter logs that have ANY of these primary evaluation issues (OR operation)
 
+          sort: Field or score to sort by.
+
+              Available fields: 'created_at', 'custom_rank', 'impact_score',
+              'primary_eval_issue_score', 'total_count'.
+
+              For eval scores, use '.eval.' prefix followed by the eval name.
+
+              Default eval scores: '.eval.trustworthiness', '.eval.context_sufficiency',
+              '.eval.response_helpfulness', '.eval.query_ease', '.eval.response_groundedness'.
+
+              Custom eval scores: '.eval.custom_eval_1', '.eval.custom_eval_2', etc.
+
           tool_call_names: Filter by names of tools called in the assistant response
 
           was_cache_hit: Filter by cache hit status
@@ -609,6 +642,17 @@ def list(
 
           primary_eval_issue: Filter logs that have ANY of these primary evaluation issues (OR operation)
 
+          sort: Field or score to sort by.
+
+              Available fields: 'created_at', 'primary_eval_issue_score'.
+
+              For eval scores, use '.eval.' prefix followed by the eval name.
+
+              Default eval scores: '.eval.trustworthiness', '.eval.context_sufficiency',
+              '.eval.response_helpfulness', '.eval.query_ease', '.eval.response_groundedness'.
+
+              Custom eval scores: '.eval.custom_eval_1', '.eval.custom_eval_2', etc.
+
           tool_call_names: Filter by names of tools called in the assistant response
 
           was_cache_hit: Filter by cache hit status
@@ -750,6 +794,17 @@ async def list_by_group(
 
           remediation_ids: List of groups to list child logs for
 
+          sort: Field or score to sort by.
+
+              Available fields: 'created_at', 'primary_eval_issue_score'.
+
+              For eval scores, use '.eval.' prefix followed by the eval name.
+
+              Default eval scores: '.eval.trustworthiness', '.eval.context_sufficiency',
+              '.eval.response_helpfulness', '.eval.query_ease', '.eval.response_groundedness'.
+
+              Custom eval scores: '.eval.custom_eval_1', '.eval.custom_eval_2', etc.
+
           tool_call_names: Filter by names of tools called in the assistant response
 
           was_cache_hit: Filter by cache hit status
@@ -815,8 +870,7 @@ def list_groups(
             List[Literal["hallucination", "search_failure", "unhelpful", "difficult_query", "ungrounded"]]
         ]
         | NotGiven = NOT_GIVEN,
-        sort: Optional[Literal["created_at", "primary_eval_issue_score", "total_count", "custom_rank", "impact_score"]]
-        | NotGiven = NOT_GIVEN,
+        sort: Optional[str] | NotGiven = NOT_GIVEN,
         tool_call_names: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
         was_cache_hit: Optional[bool] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -848,6 +902,18 @@ def list_groups(
 
           primary_eval_issue: Filter logs that have ANY of these primary evaluation issues (OR operation)
 
+          sort: Field or score to sort by.
+
+              Available fields: 'created_at', 'custom_rank', 'impact_score',
+              'primary_eval_issue_score', 'total_count'.
+
+              For eval scores, use '.eval.' prefix followed by the eval name.
+
+              Default eval scores: '.eval.trustworthiness', '.eval.context_sufficiency',
+              '.eval.response_helpfulness', '.eval.query_ease', '.eval.response_groundedness'.
+
+              Custom eval scores: '.eval.custom_eval_1', '.eval.custom_eval_2', etc.
+
           tool_call_names: Filter by names of tools called in the assistant response
 
           was_cache_hit: Filter by cache hit status

src/codex/types/projects/query_log_list_by_group_params.py

@@ -52,6 +52,17 @@ class QueryLogListByGroupParams(TypedDict, total=False):
     """List of groups to list child logs for"""
 
     sort: Optional[str]
+    """Field or score to sort by.
+
+    Available fields: 'created_at', 'primary_eval_issue_score'.
+
+    For eval scores, use '.eval.' prefix followed by the eval name.
+
+    Default eval scores: '.eval.trustworthiness', '.eval.context_sufficiency',
+    '.eval.response_helpfulness', '.eval.query_ease', '.eval.response_groundedness'.
+
+    Custom eval scores: '.eval.custom_eval_1', '.eval.custom_eval_2', etc.
+    """
 
     tool_call_names: Optional[SequenceNotStr[str]]
     """Filter by names of tools called in the assistant response"""

src/codex/types/projects/query_log_list_groups_params.py

@@ -48,7 +48,19 @@ class QueryLogListGroupsParams(TypedDict, total=False):
     ]
     """Filter logs that have ANY of these primary evaluation issues (OR operation)"""
 
-    sort: Optional[Literal["created_at", "primary_eval_issue_score", "total_count", "custom_rank", "impact_score"]]
+    sort: Optional[str]
+    """Field or score to sort by.
+
+    Available fields: 'created_at', 'custom_rank', 'impact_score',
+    'primary_eval_issue_score', 'total_count'.
+
+    For eval scores, use '.eval.' prefix followed by the eval name.
+
+    Default eval scores: '.eval.trustworthiness', '.eval.context_sufficiency',
+    '.eval.response_helpfulness', '.eval.query_ease', '.eval.response_groundedness'.
+
+    Custom eval scores: '.eval.custom_eval_1', '.eval.custom_eval_2', etc.
+    """
 
     tool_call_names: Optional[SequenceNotStr[str]]
     """Filter by names of tools called in the assistant response"""

src/codex/types/projects/query_log_list_params.py

@@ -46,6 +46,17 @@ class QueryLogListParams(TypedDict, total=False):
     """Filter logs that have ANY of these primary evaluation issues (OR operation)"""
 
     sort: Optional[str]
+    """Field or score to sort by.
+
+    Available fields: 'created_at', 'primary_eval_issue_score'.
+
+    For eval scores, use '.eval.' prefix followed by the eval name.
+
+    Default eval scores: '.eval.trustworthiness', '.eval.context_sufficiency',
+    '.eval.response_helpfulness', '.eval.query_ease', '.eval.response_groundedness'.
+
+    Custom eval scores: '.eval.custom_eval_1', '.eval.custom_eval_2', etc.
+    """
 
     tool_call_names: Optional[SequenceNotStr[str]]
     """Filter by names of tools called in the assistant response"""

tests/api_resources/projects/test_query_logs.py

@@ -108,7 +108,7 @@ def test_method_list_with_all_params(self, client: Codex) -> None:
             order="asc",
             passed_evals=["string"],
             primary_eval_issue=["hallucination"],
-            sort="sort",
+            sort="created_at",
             tool_call_names=["string"],
             was_cache_hit=True,
         )
@@ -231,7 +231,7 @@ def test_method_list_by_group_with_all_params(self, client: Codex) -> None:
             passed_evals=["string"],
             primary_eval_issue=["hallucination"],
             remediation_ids=["182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"],
-            sort="sort",
+            sort="created_at",
             tool_call_names=["string"],
             was_cache_hit=True,
         )
@@ -527,7 +527,7 @@ async def test_method_list_with_all_params(self, async_client: AsyncCodex) -> No
             order="asc",
             passed_evals=["string"],
             primary_eval_issue=["hallucination"],
-            sort="sort",
+            sort="created_at",
             tool_call_names=["string"],
             was_cache_hit=True,
         )
@@ -650,7 +650,7 @@ async def test_method_list_by_group_with_all_params(self, async_client: AsyncCod
             passed_evals=["string"],
             primary_eval_issue=["hallucination"],
             remediation_ids=["182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"],
-            sort="sort",
+            sort="created_at",
             tool_call_names=["string"],
             was_cache_hit=True,
         )