feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 105
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/datamini%2Fasktable-7997d2aebc04c657a434b6b1114b61de06f0d873868ee376ac82f5c50d20884f.yml
-openapi_spec_hash: 08977f6ad1332cbeb03d95dad748f20a
+configured_endpoints: 101
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/datamini%2Fasktable-09c2a1858834d1a4a69bf9c6ac04c236bdc0763873aa14eae4553222afa08ab2.yml
+openapi_spec_hash: aab62076e3b4591fa2def5485c7ddeca
 config_hash: acdf4142177ed1932c2d82372693f811

api.md

@@ -290,21 +290,6 @@ Methods:
 - <code title="patch /v1/preference">client.preferences.<a href="./src/asktable/resources/preferences.py">update</a>(\*\*<a href="src/asktable/types/preference_update_params.py">params</a>) -> <a href="./src/asktable/types/preference_update_response.py">PreferenceUpdateResponse</a></code>
 - <code title="delete /v1/preference">client.preferences.<a href="./src/asktable/resources/preferences.py">delete</a>() -> object</code>
 
-# Trainings
-
-Types:
-
-```python
-from asktable.types import TrainingCreateResponse, TrainingUpdateResponse, TrainingListResponse
-```
-
-Methods:
-
-- <code title="post /v1/training">client.trainings.<a href="./src/asktable/resources/trainings.py">create</a>(\*\*<a href="src/asktable/types/training_create_params.py">params</a>) -> <a href="./src/asktable/types/training_create_response.py">TrainingCreateResponse</a></code>
-- <code title="patch /v1/training/{id}">client.trainings.<a href="./src/asktable/resources/trainings.py">update</a>(id, \*\*<a href="src/asktable/types/training_update_params.py">params</a>) -> <a href="./src/asktable/types/training_update_response.py">TrainingUpdateResponse</a></code>
-- <code title="get /v1/training">client.trainings.<a href="./src/asktable/resources/trainings.py">list</a>(\*\*<a href="src/asktable/types/training_list_params.py">params</a>) -> <a href="./src/asktable/types/training_list_response.py">SyncPage[TrainingListResponse]</a></code>
-- <code title="delete /v1/training/{id}">client.trainings.<a href="./src/asktable/resources/trainings.py">delete</a>(id, \*\*<a href="src/asktable/types/training_delete_params.py">params</a>) -> object</code>
-
 # Project
 
 Types:

src/asktable/_client.py

@@ -46,7 +46,6 @@
         answers,
         project,
         policies,
-        trainings,
         dataframes,
         datasources,
         integration,
@@ -66,7 +65,6 @@
     from .resources.project import ProjectResource, AsyncProjectResource
     from .resources.sys.sys import SysResource, AsyncSysResource
     from .resources.policies import PoliciesResource, AsyncPoliciesResource
-    from .resources.trainings import TrainingsResource, AsyncTrainingsResource
     from .resources.user.user import UserResource, AsyncUserResource
     from .resources.dataframes import DataframesResource, AsyncDataframesResource
     from .resources.chats.chats import ChatsResource, AsyncChatsResource
@@ -233,13 +231,6 @@ def preferences(self) -> PreferencesResource:
 
         return PreferencesResource(self)
 
-    @cached_property
-    def trainings(self) -> TrainingsResource:
-        """训练数据管理"""
-        from .resources.trainings import TrainingsResource
-
-        return TrainingsResource(self)
-
     @cached_property
     def project(self) -> ProjectResource:
         """我的项目"""
@@ -545,13 +536,6 @@ def preferences(self) -> AsyncPreferencesResource:
 
         return AsyncPreferencesResource(self)
 
-    @cached_property
-    def trainings(self) -> AsyncTrainingsResource:
-        """训练数据管理"""
-        from .resources.trainings import AsyncTrainingsResource
-
-        return AsyncTrainingsResource(self)
-
     @cached_property
     def project(self) -> AsyncProjectResource:
         """我的项目"""
@@ -808,13 +792,6 @@ def preferences(self) -> preferences.PreferencesResourceWithRawResponse:
 
         return PreferencesResourceWithRawResponse(self._client.preferences)
 
-    @cached_property
-    def trainings(self) -> trainings.TrainingsResourceWithRawResponse:
-        """训练数据管理"""
-        from .resources.trainings import TrainingsResourceWithRawResponse
-
-        return TrainingsResourceWithRawResponse(self._client.trainings)
-
     @cached_property
     def project(self) -> project.ProjectResourceWithRawResponse:
         """我的项目"""
@@ -959,13 +936,6 @@ def preferences(self) -> preferences.AsyncPreferencesResourceWithRawResponse:
 
         return AsyncPreferencesResourceWithRawResponse(self._client.preferences)
 
-    @cached_property
-    def trainings(self) -> trainings.AsyncTrainingsResourceWithRawResponse:
-        """训练数据管理"""
-        from .resources.trainings import AsyncTrainingsResourceWithRawResponse
-
-        return AsyncTrainingsResourceWithRawResponse(self._client.trainings)
-
     @cached_property
     def project(self) -> project.AsyncProjectResourceWithRawResponse:
         """我的项目"""
@@ -1110,13 +1080,6 @@ def preferences(self) -> preferences.PreferencesResourceWithStreamingResponse:
 
         return PreferencesResourceWithStreamingResponse(self._client.preferences)
 
-    @cached_property
-    def trainings(self) -> trainings.TrainingsResourceWithStreamingResponse:
-        """训练数据管理"""
-        from .resources.trainings import TrainingsResourceWithStreamingResponse
-
-        return TrainingsResourceWithStreamingResponse(self._client.trainings)
-
     @cached_property
     def project(self) -> project.ProjectResourceWithStreamingResponse:
         """我的项目"""
@@ -1261,13 +1224,6 @@ def preferences(self) -> preferences.AsyncPreferencesResourceWithStreamingRespon
 
         return AsyncPreferencesResourceWithStreamingResponse(self._client.preferences)
 
-    @cached_property
-    def trainings(self) -> trainings.AsyncTrainingsResourceWithStreamingResponse:
-        """训练数据管理"""
-        from .resources.trainings import AsyncTrainingsResourceWithStreamingResponse
-
-        return AsyncTrainingsResourceWithStreamingResponse(self._client.trainings)
-
     @cached_property
     def project(self) -> project.AsyncProjectResourceWithStreamingResponse:
         """我的项目"""

src/asktable/resources/__init__.py

@@ -112,14 +112,6 @@
     PoliciesResourceWithStreamingResponse,
     AsyncPoliciesResourceWithStreamingResponse,
 )
-from .trainings import (
-    TrainingsResource,
-    AsyncTrainingsResource,
-    TrainingsResourceWithRawResponse,
-    AsyncTrainingsResourceWithRawResponse,
-    TrainingsResourceWithStreamingResponse,
-    AsyncTrainingsResourceWithStreamingResponse,
-)
 from .dataframes import (
     DataframesResource,
     AsyncDataframesResource,
@@ -248,12 +240,6 @@
     "AsyncPreferencesResourceWithRawResponse",
     "PreferencesResourceWithStreamingResponse",
     "AsyncPreferencesResourceWithStreamingResponse",
-    "TrainingsResource",
-    "AsyncTrainingsResource",
-    "TrainingsResourceWithRawResponse",
-    "AsyncTrainingsResourceWithRawResponse",
-    "TrainingsResourceWithStreamingResponse",
-    "AsyncTrainingsResourceWithStreamingResponse",
     "ProjectResource",
     "AsyncProjectResource",
     "ProjectResourceWithRawResponse",

src/asktable/resources/datasources/datasources.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Dict, Optional
 from typing_extensions import Literal
 
 import httpx
@@ -253,11 +253,12 @@ def update(
         ]
         | Omit = omit,
         field_count: Optional[int] | Omit = omit,
-        meta_error: Optional[str] | Omit = omit,
-        meta_status: Optional[Literal["processing", "failed", "success", "unprocessed"]] | Omit = omit,
+        meta_status: Optional[Literal["unavailable", "available"]] | Omit = omit,
         name: Optional[str] | Omit = omit,
         sample_questions: Optional[str] | Omit = omit,
         schema_count: Optional[int] | Omit = omit,
+        sync_error: Optional[Dict[str, object]] | Omit = omit,
+        sync_status: Optional[Literal["processing", "success", "failed", "warning"]] | Omit = omit,
         table_count: Optional[int] | 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.
@@ -278,16 +279,18 @@ def update(
 
           field_count: 字段数量
 
-          meta_error: 元数据处理错误
-
-          meta_status: 元数据处理状态
+          meta_status: 数据源可用性
 
           name: 数据源的名称
 
           sample_questions: 示例问题
 
           schema_count: 库数量
 
+          sync_error: 同步错误信息
+
+          sync_status: 同步状态
+
           table_count: 表数量
 
           extra_headers: Send extra headers
@@ -308,11 +311,12 @@ def update(
                     "desc": desc,
                     "engine": engine,
                     "field_count": field_count,
-                    "meta_error": meta_error,
                     "meta_status": meta_status,
                     "name": name,
                     "sample_questions": sample_questions,
                     "schema_count": schema_count,
+                    "sync_error": sync_error,
+                    "sync_status": sync_status,
                     "table_count": table_count,
                 },
                 datasource_update_params.DatasourceUpdateParams,
@@ -773,11 +777,12 @@ async def update(
         ]
         | Omit = omit,
         field_count: Optional[int] | Omit = omit,
-        meta_error: Optional[str] | Omit = omit,
-        meta_status: Optional[Literal["processing", "failed", "success", "unprocessed"]] | Omit = omit,
+        meta_status: Optional[Literal["unavailable", "available"]] | Omit = omit,
         name: Optional[str] | Omit = omit,
         sample_questions: Optional[str] | Omit = omit,
         schema_count: Optional[int] | Omit = omit,
+        sync_error: Optional[Dict[str, object]] | Omit = omit,
+        sync_status: Optional[Literal["processing", "success", "failed", "warning"]] | Omit = omit,
         table_count: Optional[int] | 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.
@@ -798,16 +803,18 @@ async def update(
 
           field_count: 字段数量
 
-          meta_error: 元数据处理错误
-
-          meta_status: 元数据处理状态
+          meta_status: 数据源可用性
 
           name: 数据源的名称
 
           sample_questions: 示例问题
 
           schema_count: 库数量
 
+          sync_error: 同步错误信息
+
+          sync_status: 同步状态
+
           table_count: 表数量
 
           extra_headers: Send extra headers
@@ -828,11 +835,12 @@ async def update(
                     "desc": desc,
                     "engine": engine,
                     "field_count": field_count,
-                    "meta_error": meta_error,
                     "meta_status": meta_status,
                     "name": name,
                     "sample_questions": sample_questions,
                     "schema_count": schema_count,
+                    "sync_error": sync_error,
+                    "sync_status": sync_status,
                     "table_count": table_count,
                 },
                 datasource_update_params.DatasourceUpdateParams,

src/asktable/resources/datasources/meta.py

@@ -61,11 +61,7 @@ def create(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> object:
         """
-        创建数据源的 meta，如果已经存在，则删除旧的
-
-        如果上传了 meta，则使用用户上传的数据创建。
-
-        否则从数据源中自动获取。
+        初始化数据源的 meta。不允许覆盖已成功初始化的 meta，需使用 PUT 更新。
 
         Args:
           extra_headers: Send extra headers
@@ -257,11 +253,7 @@ async def create(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> object:
         """
-        创建数据源的 meta，如果已经存在，则删除旧的
-
-        如果上传了 meta，则使用用户上传的数据创建。
-
-        否则从数据源中自动获取。
+        初始化数据源的 meta。不允许覆盖已成功初始化的 meta，需使用 PUT 更新。
 
         Args:
           extra_headers: Send extra headers