@petercatai/whisker-client 0.0.1760329074-dev → 0.0.1760329155-dev

package/dist/api.d.ts

@@ -127,14 +127,6 @@ export declare enum IKnowledgeSourceEnum {
     CloudStorageImage = "cloud_storage_image",
     Yuque = "yuque"
 }
-/** EmbeddingModelEnum */
-export declare enum IEmbeddingModelEnum {
-    Openai = "openai",
-    SentenceTransformersAllMiniLML6V2 = "sentence-transformers/all-MiniLM-L6-v2",
-    SentenceTransformersAllMpnetBaseV2 = "sentence-transformers/all-mpnet-base-v2",
-    SentenceTransformersParaphraseMultilingualMiniLML12V2 = "sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2",
-    Shibing624Text2VecBaseChinese = "shibing624/text2vec-base-chinese"
-}
 /** Action */
 export declare enum IAction {
     Create = "create",
@@ -180,7 +172,7 @@ export interface IAPIKey {
      * Permissions
      * permissions config
      */
-    permissions?: IPermission[];
+    permissions?: Record<string, any>[];
     /**
      * Rate Limit
      * rate limit per minute
@@ -231,29 +223,25 @@ export interface IAPIKeyCreate {
 }
 /** APIKeyUpdate */
 export interface IAPIKeyUpdate {
-    /**
-     * Key Name
-     * @default ""
-     */
-    key_name?: string;
+    /** Key Id */
+    key_id: string;
+    /** Key Name */
+    key_name?: string | null;
     /** Description */
     description?: string | null;
     /** Permissions */
-    permissions?: IPermission[];
-    /**
-     * Rate Limit
-     * @default 0
-     */
+    permissions?: IPermission[] | null;
+    /** Rate Limit */
     rate_limit?: number | null;
     /**
      * Expires At
      * Expiration time in ISO8601 format with timezone (e.g., 2024-12-31T23:59:59+00:00)
      */
     expires_at?: string | null;
+    /** Is Active */
+    is_active?: boolean | null;
     /** Metadata */
     metadata?: Record<string, any> | null;
-    /** Key Id */
-    key_id: string;
 }
 /** ActiveStatusUpdate */
 export interface IActiveStatusUpdate {
@@ -356,11 +344,6 @@ export interface IArtifactSpaceUpdate {
     /** New Space Id */
     new_space_id: string;
 }
-/** Audio */
-export interface IAudio {
-    /** Id */
-    id: string;
-}
 /**
  * BaseCharSplitConfig
  * Base char split configuration class
@@ -418,108 +401,6 @@ export interface IBaseCodeSplitConfig {
      */
     chunk_overlap?: number;
 }
-/** ChatCompletionAssistantMessageParam */
-export interface IChatCompletionAssistantMessageParam {
-    /** Role */
-    role: "assistant";
-    audio?: IAudio | null;
-    /** Content */
-    content?: string | (IChatCompletionContentPartTextParam | IChatCompletionContentPartRefusalParam)[] | null;
-    function_call?: IFunctionCall | null;
-    /** Name */
-    name?: string;
-    /** Refusal */
-    refusal?: string | null;
-    /** Tool Calls */
-    tool_calls?: (IChatCompletionMessageFunctionToolCallParam | IChatCompletionMessageCustomToolCallParam)[];
-}
-/** ChatCompletionContentPartImageParam */
-export interface IChatCompletionContentPartImageParam {
-    image_url: IImageURL;
-    /** Type */
-    type: "image_url";
-}
-/** ChatCompletionContentPartInputAudioParam */
-export interface IChatCompletionContentPartInputAudioParam {
-    input_audio: IInputAudio;
-    /** Type */
-    type: "input_audio";
-}
-/** ChatCompletionContentPartRefusalParam */
-export interface IChatCompletionContentPartRefusalParam {
-    /** Refusal */
-    refusal: string;
-    /** Type */
-    type: "refusal";
-}
-/** ChatCompletionContentPartTextParam */
-export interface IChatCompletionContentPartTextParam {
-    /** Text */
-    text: string;
-    /** Type */
-    type: "text";
-}
-/** ChatCompletionDeveloperMessageParam */
-export interface IChatCompletionDeveloperMessageParam {
-    /** Content */
-    content: string | IChatCompletionContentPartTextParam[];
-    /** Role */
-    role: "developer";
-    /** Name */
-    name?: string;
-}
-/** ChatCompletionFunctionMessageParam */
-export interface IChatCompletionFunctionMessageParam {
-    /** Content */
-    content: string | null;
-    /** Name */
-    name: string;
-    /** Role */
-    role: "function";
-}
-/** ChatCompletionMessageCustomToolCallParam */
-export interface IChatCompletionMessageCustomToolCallParam {
-    /** Id */
-    id: string;
-    custom: ICustom;
-    /** Type */
-    type: "custom";
-}
-/** ChatCompletionMessageFunctionToolCallParam */
-export interface IChatCompletionMessageFunctionToolCallParam {
-    /** Id */
-    id: string;
-    function: IFunction;
-    /** Type */
-    type: "function";
-}
-/** ChatCompletionSystemMessageParam */
-export interface IChatCompletionSystemMessageParam {
-    /** Content */
-    content: string | IChatCompletionContentPartTextParam[];
-    /** Role */
-    role: "system";
-    /** Name */
-    name?: string;
-}
-/** ChatCompletionToolMessageParam */
-export interface IChatCompletionToolMessageParam {
-    /** Content */
-    content: string | IChatCompletionContentPartTextParam[];
-    /** Role */
-    role: "tool";
-    /** Tool Call Id */
-    tool_call_id: string;
-}
-/** ChatCompletionUserMessageParam */
-export interface IChatCompletionUserMessageParam {
-    /** Content */
-    content: string | (IChatCompletionContentPartTextParam | IChatCompletionContentPartImageParam | IChatCompletionContentPartInputAudioParam | IFile)[];
-    /** Role */
-    role: "user";
-    /** Name */
-    name?: string;
-}
 /** Chunk */
 export interface IChunk {
     /**
@@ -572,7 +453,7 @@ export interface IChunk {
      * Embedding Model Name
      * name of the embedding model
      */
-    embedding_model_name?: string;
+    embedding_model_name: string;
     /**
      * Metadata
      * Arbitrary metadata associated with the content.
@@ -621,11 +502,23 @@ export interface IChunkSave {
     embedding_model_name: string;
     /** Metadata */
     metadata?: Record<string, any> | null;
+    /** Tags */
+    tags?: string[] | null;
+    /** F1 */
+    f1?: string | null;
+    /** F2 */
+    f2?: string | null;
+    /** F3 */
+    f3?: string | null;
+    /** F4 */
+    f4?: string | null;
+    /** F5 */
+    f5?: string | null;
 }
 /** ChunkUpdate */
 export interface IChunkUpdate {
     /** Chunk Id */
-    chunk_id?: string;
+    chunk_id?: string | null;
     /** Context */
     context?: string | null;
     /** Embedding Model Name */
@@ -642,13 +535,6 @@ export interface ICondition {
     /** Value */
     value: any;
 }
-/** Custom */
-export interface ICustom {
-    /** Input */
-    input: string;
-    /** Name */
-    name: string;
-}
 /** EnableStatusUpdate */
 export interface IEnableStatusUpdate {
     /** Knowledge Id */
@@ -656,41 +542,12 @@ export interface IEnableStatusUpdate {
     /** Status */
     status: boolean;
 }
-/** File */
-export interface IFile {
-    file: IFileFile;
-    /** Type */
-    type: "file";
-}
-/** FileFile */
-export interface IFileFile {
-    /** File Data */
-    file_data?: string;
-    /** File Id */
-    file_id?: string;
-    /** Filename */
-    filename?: string;
-}
 /** FilterGroup */
 export interface IFilterGroup {
     operator: IOperator;
     /** Conditions */
     conditions: (ICondition | IFilterGroup)[];
 }
-/** Function */
-export interface IFunction {
-    /** Arguments */
-    arguments: string;
-    /** Name */
-    name: string;
-}
-/** FunctionCall */
-export interface IFunctionCall {
-    /** Arguments */
-    arguments: string;
-    /** Name */
-    name: string;
-}
 /**
  * GeaGraphSplitConfig
  * JSON document split configuration
@@ -772,9 +629,8 @@ export interface IGithubRepoCreate {
     /**
      * Embedding Model Name
      * name of the embedding model. you can set any other model if target embedding service registered
-     * @default "openai"
      */
-    embedding_model_name?: IEmbeddingModelEnum | string;
+    embedding_model_name: string;
     /**
      * File Sha
      * SHA of the file
@@ -922,9 +778,8 @@ export interface IImageCreate {
     /**
      * Embedding Model Name
      * name of the embedding model. you can set any other model if target embedding service registered
-     * @default "openai"
      */
-    embedding_model_name?: IEmbeddingModelEnum | string;
+    embedding_model_name: string;
     /**
      * File Sha
      * SHA of the file, if source_type is cloud_storage_text, this field is the sha of the text file
@@ -959,20 +814,6 @@ export interface IImageSplitConfig {
      */
     type?: "image";
 }
-/** ImageURL */
-export interface IImageURL {
-    /** Url */
-    url: string;
-    /** Detail */
-    detail?: "auto" | "low" | "high";
-}
-/** InputAudio */
-export interface IInputAudio {
-    /** Data */
-    data: string;
-    /** Format */
-    format: "wav" | "mp3";
-}
 /** JSONCreate */
 export interface IJSONCreate {
     /**
@@ -1003,9 +844,8 @@ export interface IJSONCreate {
     /**
      * Embedding Model Name
      * name of the embedding model. you can set any other model if target embedding service registered
-     * @default "openai"
      */
-    embedding_model_name?: IEmbeddingModelEnum | string;
+    embedding_model_name: string;
     /**
      * File Sha
      * SHA of the file
@@ -1105,9 +945,8 @@ export interface IKnowledgeInput {
     /**
      * Embedding Model Name
      * name of the embedding model. you can set any other model if target embedding service registered
-     * @default "openai"
      */
-    embedding_model_name?: IEmbeddingModelEnum | string;
+    embedding_model_name: string;
     /**
      * Split Config
      * configuration for splitting the knowledge
@@ -1193,7 +1032,7 @@ export interface IKnowledgeOutput {
      * Embedding Model Name
      * name of the embedding model. you can set any other model if target embedding service registered
      */
-    embedding_model_name?: string;
+    embedding_model_name: string;
     /**
      * Split Config
      * configuration for splitting the knowledge
@@ -1232,13 +1071,6 @@ export interface IKnowledgeOutput {
      */
     enabled?: boolean;
 }
-/** KnowledgeScope */
-export interface IKnowledgeScope {
-    /** Space Ids */
-    space_ids?: string[] | null;
-    /** Auth Info */
-    auth_info: string;
-}
 /** MarkdownCreate */
 export interface IMarkdownCreate {
     /**
@@ -1269,9 +1101,8 @@ export interface IMarkdownCreate {
     /**
      * Embedding Model Name
      * name of the embedding model. you can set any other model if target embedding service registered
-     * @default "openai"
      */
-    embedding_model_name?: IEmbeddingModelEnum | string;
+    embedding_model_name: string;
     /**
      * File Sha
      * SHA of the file
@@ -1395,9 +1226,8 @@ export interface IPDFCreate {
     /**
      * Embedding Model Name
      * name of the embedding model. you can set any other model if target embedding service registered
-     * @default "openai"
      */
-    embedding_model_name?: IEmbeddingModelEnum | string;
+    embedding_model_name: string;
     /**
      * File Sha
      * SHA of the file
@@ -1874,53 +1704,6 @@ export interface IPermission {
     /** Conditions */
     conditions?: Record<string, any> | null;
 }
-/** ProResearchRequest */
-export interface IProResearchRequest {
-    /**
-     * Messages
-     * The messages to be sent to the agent.
-     * @default []
-     */
-    messages?: (IChatCompletionDeveloperMessageParam | IChatCompletionSystemMessageParam | IChatCompletionUserMessageParam | IChatCompletionAssistantMessageParam | IChatCompletionToolMessageParam | IChatCompletionFunctionMessageParam)[];
-    /**
-     * Model
-     * The name of the language model to use for the agent's query generation.
-     * @default "wohu_qwen3_235b_a22b"
-     */
-    model?: string;
-    /**
-     * Number Of Initial Queries
-     * The number of initial search queries to generate.
-     * @default 3
-     */
-    number_of_initial_queries?: number;
-    /**
-     * Max Research Loops
-     * The maximum number of research loops to perform.
-     * @default 2
-     */
-    max_research_loops?: number;
-    /**
-     * Enable Knowledge Retrieval
-     * Whether to enable knowledge retrieval functionality.
-     * @default true
-     */
-    enable_knowledge_retrieval?: boolean;
-    /**
-     * Enable Web Search
-     * Whether to enable web search functionality.
-     * @default false
-     */
-    enable_web_search?: boolean;
-    /**
-     * Knowledge Scope List
-     * List of knowledge scopes to search within.
-     * @default []
-     */
-    knowledge_scope_list?: IKnowledgeScope[];
-    /** Knowledge retrieval configuration. */
-    knowledge_retrieval_config?: IRetrievalConfig | null;
-}
 /** QACreate */
 export interface IQACreate {
     /**
@@ -1955,9 +1738,8 @@ export interface IQACreate {
     /**
      * Embedding Model Name
      * name of the embedding model. you can set any other model if target embedding service registered
-     * @default "openai"
      */
-    embedding_model_name?: IEmbeddingModelEnum | string;
+    embedding_model_name: string;
     /**
      * File Sha
      * SHA of the file
@@ -2246,7 +2028,7 @@ export interface IRetrievalByKnowledgeRequest {
      * Embedding Model Name
      * The name of the embedding model
      */
-    embedding_model_name: IEmbeddingModelEnum | string;
+    embedding_model_name: string;
     /**
      * Similarity Threshold
      * The similarity threshold, ranging from 0.0 to 1.0.
@@ -2285,7 +2067,7 @@ export interface IRetrievalBySpaceRequest {
      * Embedding Model Name
      * The name of the embedding model
      */
-    embedding_model_name: IEmbeddingModelEnum | string;
+    embedding_model_name: string;
     /**
      * Similarity Threshold
      * The similarity threshold, ranging from 0.0 to 1.0.
@@ -2370,7 +2152,7 @@ export interface IRetrievalChunk {
      * Embedding Model Name
      * name of the embedding model
      */
-    embedding_model_name?: string;
+    embedding_model_name: string;
     /**
      * Metadata
      * Arbitrary metadata associated with the content.
@@ -2900,8 +2682,6 @@ export interface ITenantLogQuery {
 }
 /** TenantUpdate */
 export interface ITenantUpdate {
-    /** Tenant Id */
-    tenant_id: string;
     /** Tenant Name */
     tenant_name?: string | null;
     /** Email */
@@ -2939,9 +2719,8 @@ export interface ITextCreate {
     /**
      * Embedding Model Name
      * name of the embedding model. you can set any other model if target embedding service registered
-     * @default "openai"
      */
-    embedding_model_name?: IEmbeddingModelEnum | string;
+    embedding_model_name: string;
     /**
      * File Sha
      * SHA of the file
@@ -3065,9 +2844,8 @@ export interface IYuqueCreate {
     /**
      * Embedding Model Name
      * name of the embedding model. you can set any other model if target embedding service registered
-     * @default "openai"
      */
-    embedding_model_name?: IEmbeddingModelEnum | string;
+    embedding_model_name: string;
     /**
      * File Sha
      * SHA of the file
@@ -3229,7 +3007,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
     homePageGet: (params?: RequestParams) => Promise<HttpResponse<any, any>>;
     knowledge: {
         /**
-         * @description Duplicate file_sha entries are prohibited. Any modifications to split_config or embedding model_name parameters must be performed using dedicated API endpoints."
+         * @description 添加知识 使用DDD架构创建新的知识，禁止重复的file_sha条目。 通过TaskCoordinationService统一协调知识创建和任务执行，确保事务一致性。
          *
          * @tags knowledge
          * @name AddKnowledge
@@ -3238,7 +3016,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         addKnowledge: (data: (ITextCreate | IImageCreate | IJSONCreate | IMarkdownCreate | IPDFCreate | IGithubRepoCreate | IQACreate | IYuqueCreate)[], params?: RequestParams) => Promise<HttpResponse<IResponseModelListKnowledge, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 更新知识 使用DDD架构更新知识信息，支持元数据和状态更新。
          *
          * @tags knowledge
          * @name UpdateKnowledge
@@ -3247,7 +3025,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         updateKnowledge: (data: IKnowledgeInput, params?: RequestParams) => Promise<HttpResponse<IResponseModelKnowledge, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 更新知识启用状态 使用DDD架构更新知识的启用状态。
          *
          * @tags knowledge
          * @name UpdateKnowledgeEnableStatus
@@ -3256,7 +3034,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         updateKnowledgeEnableStatus: (data: IEnableStatusUpdate, params?: RequestParams) => Promise<HttpResponse<IResponseModelNoneType, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 获取知识列表 使用DDD架构的KnowledgeService进行分页查询，支持条件过滤和排序。
          *
          * @tags knowledge
          * @name GetKnowledgeList
@@ -3265,7 +3043,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         getKnowledgeList: (data: IPageQueryParamsKnowledge, params?: RequestParams) => Promise<HttpResponse<IResponseModelPageResponseKnowledge, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 根据ID获取知识详情 使用DDD架构获取知识详细信息。
          *
          * @tags knowledge
          * @name GetKnowledgeById
@@ -3277,7 +3055,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
             knowledge_id: string;
         }, params?: RequestParams) => Promise<HttpResponse<IResponseModelKnowledge, void | IHTTPValidationError>>;
         /**
-         * @description Deletes a knowledge entry by its ID.
+         * @description 删除知识 包括级联删除相关的任务和向量数据。
          *
          * @tags knowledge
          * @name DeleteKnowledge
@@ -3297,15 +3075,6 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @request GET:/api/knowledge/embedding/models
          */
         getEmbeddingModelsList: (params?: RequestParams) => Promise<HttpResponse<any, void | IHTTPValidationError>>;
-        /**
-         * @description 处理不同类型的webhook：knowledge, deployment, notification等
-         *
-         * @tags knowledge
-         * @name HandleWebhookApiKnowledgeWebhookTypeSourceAuthInfoKnowledgeBaseIdPost
-         * @summary 通用webhook处理器
-         * @request POST:/api/knowledge/{webhook_type}/{source}/{auth_info}/{knowledge_base_id}
-         */
-        handleWebhookApiKnowledgeWebhookTypeSourceAuthInfoKnowledgeBaseIdPost: (webhookType: string, source: string, authInfo: string, knowledgeBaseId: string, data: Record<string, any>, params?: RequestParams) => Promise<HttpResponse<any, void | IHTTPValidationError>>;
     };
     retrieval: {
         /**
@@ -3318,7 +3087,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         retrieveKnowledgeContent: (data: IRetrievalByKnowledgeRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelListRetrievalChunk, void | IHTTPValidationError>>;
         /**
-         * @description Retrieve chunks within a space_id, for example, given a petercat bot_id, retrieve all chunks under that bot_id.
+         * @description Retrieve chunks within a space_id, for example, given a petercat bot_id, retrieve all chunks under that bot_id. 使用DDD架构的RetrievalService进行空间检索。
          *
          * @tags retrieval
          * @name RetrieveSpaceContent
@@ -3327,7 +3096,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         retrieveSpaceContent: (data: IRetrievalBySpaceRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelListRetrievalChunk, void | IHTTPValidationError>>;
         /**
-         * @description Retrieve chunks within a space_id, for example, given a petercat bot_id, retrieve all chunks under that bot_id.
+         * @description Retrieve chunks within a space_id, for example, given a petercat bot_id, retrieve all chunks under that bot_id. 使用DDD架构的RetrievalService进行检索。
          *
          * @tags retrieval
          * @name Retrieve
@@ -3338,7 +3107,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
     };
     task: {
         /**
-         * No description
+         * @description 重启任务 使用DDD架构的TaskService进行任务重启并执行。
          *
          * @tags task
          * @name RestartTask
@@ -3347,7 +3116,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         restartTask: (data: ITaskRestartRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelListTask, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 取消任务 使用DDD架构的TaskService进行任务取消。
          *
          * @tags task
          * @name CancelTask
@@ -3356,7 +3125,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         cancelTask: (data: ITaskRestartRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelListTask, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 获取任务列表 使用DDD架构的TaskService进行分页查询。
          *
          * @tags task
          * @name GetTaskList
@@ -3365,7 +3134,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         getTaskList: (data: IPageQueryParamsTask, params?: RequestParams) => Promise<HttpResponse<IResponseModelStatusStatisticsPageResponseTask, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 获取任务详情 使用DDD架构的TaskService获取任务详情。
          *
          * @tags task
          * @name GetTaskDetail
@@ -3377,7 +3146,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
             task_id: string;
         }, params?: RequestParams) => Promise<HttpResponse<IResponseModelTask, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 删除任务 使用DDD架构的TaskService进行任务删除。
          *
          * @tags task
          * @name DeleteTaskById
@@ -3391,7 +3160,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
     };
     chunk: {
         /**
-         * No description
+         * @description 获取Chunk列表
          *
          * @tags chunk
          * @name GetChunkList
@@ -3400,7 +3169,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         getChunkList: (data: IPageQueryParamsChunk, params?: RequestParams) => Promise<HttpResponse<IResponseModelPageResponseChunk, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 根据ID删除Chunk 使用DDD架构删除指定的Chunk。
          *
          * @tags chunk
          * @name DeleteChunkById
@@ -3409,7 +3178,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         deleteChunkById: (id: string, modelName: string, params?: RequestParams) => Promise<HttpResponse<IResponseModelObject, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 根据ID获取Chunk 使用DDD架构获取指定的Chunk详情。
          *
          * @tags chunk
          * @name GetChunkById
@@ -3418,7 +3187,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         getChunkById: (id: string, modelName: string, params?: RequestParams) => Promise<HttpResponse<IResponseModelChunk, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 添加Chunk 使用DDD架构创建新的Chunk。
          *
          * @tags chunk
          * @name AddChunk
@@ -3427,7 +3196,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         addChunk: (data: IChunkSave, params?: RequestParams) => Promise<HttpResponse<IResponseModelChunk, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 更新Chunk 使用DDD架构更新指定的Chunk。
          *
          * @tags chunk
          * @name UpdateChunk
@@ -3438,7 +3207,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
     };
     tenant: {
         /**
-         * No description
+         * @description 创建租户
          *
          * @tags tenant
          * @name CreateTenant
@@ -3447,7 +3216,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         createTenant: (data: ITenantCreate, params?: RequestParams) => Promise<HttpResponse<IResponseModelTenant, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 根据ID查询租户
          *
          * @tags tenant
          * @name GetTenantById
@@ -3456,7 +3225,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         getTenantById: (id: string, params?: RequestParams) => Promise<HttpResponse<IResponseModelTenant, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 删除租户
          *
          * @tags tenant
          * @name DeleteTenantById
@@ -3465,7 +3234,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         deleteTenantById: (id: string, params?: RequestParams) => Promise<HttpResponse<IResponseModelObject, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 更新租户
          *
          * @tags tenant
          * @name UpdateTenant
@@ -3474,7 +3243,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         updateTenant: (data: ITenantUpdate, params?: RequestParams) => Promise<HttpResponse<IResponseModelTenant, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 获取租户列表
          *
          * @tags tenant
          * @name GetTenantList
@@ -3494,18 +3263,18 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
             page_size?: number;
         }, params?: RequestParams) => Promise<HttpResponse<IResponseModelPageResponseTenant, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 获取当前租户信息 直接返回认证系统中的租户信息。 get_tenant_with_permissions 已经包含了完整的认证和权限检查。
          *
          * @tags tenant
          * @name GetTenant
          * @summary Get Tenant
          * @request GET:/api/tenant/me
          */
-        getTenant: (params?: RequestParams) => Promise<HttpResponse<any, void | IHTTPValidationError>>;
+        getTenant: (params?: RequestParams) => Promise<HttpResponse<IResponseModelTenant, void | IHTTPValidationError>>;
     };
     space: {
         /**
-         * No description
+         * @description 获取空间列表 使用DDD架构的SpaceService进行分页查询，支持条件过滤和排序。
          *
          * @tags space
          * @name GetSpaceList
@@ -3514,7 +3283,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         getSpaceList: (data: IPageQueryParamsSpace, params?: RequestParams) => Promise<HttpResponse<IResponseModelPageResponseSpaceResponse, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 创建空间,使用DDD架构创建新的空间，支持KIS集成和元数据配置。
          *
          * @tags space
          * @name AddSpace
@@ -3523,7 +3292,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         addSpace: (data: ISpaceCreate, params?: RequestParams) => Promise<HttpResponse<IResponseModelSpaceResponse, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 删除空间,包括级联删除相关的知识、任务和向量数据。
          *
          * @tags space
          * @name DeleteSpace
@@ -3532,7 +3301,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         deleteSpace: (spaceId: string, params?: RequestParams) => Promise<HttpResponse<IResponseModelNoneType, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 更新空间 使用DDD架构更新空间信息，支持KIS集成配置更新。
          *
          * @tags space
          * @name UpdateSpace
@@ -3541,7 +3310,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         updateSpace: (spaceId: string, data: ISpaceCreate, params?: RequestParams) => Promise<HttpResponse<IResponseModelSpaceResponse, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 根据ID获取空间详情 使用DDD架构获取空间详细信息，包括统计数据。
          *
          * @tags space
          * @name GetSpaceById
@@ -3552,7 +3321,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
     };
     v1: {
         /**
-         * No description
+         * @description 获取系统全局统计信息 使用DDD架构的DashboardService获取系统级别的统计数据。
          *
          * @tags dashboard
          * @name GetGlobalInfo
@@ -3561,23 +3330,14 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         getGlobalInfo: (params?: RequestParams) => Promise<HttpResponse<IResponseModelGlobalInfo, void>>;
         /**
-         * No description
+         * @description 获取租户日志 使用DDD架构的DashboardService获取租户级别的日志数据。 注意：改为POST方法以支持复杂的查询参数。
          *
          * @tags dashboard
          * @name GetTenantLog
          * @summary Get Tenant Log
-         * @request GET:/api/v1/dashboard/tenant_log
+         * @request POST:/api/v1/dashboard/tenant_log
          */
         getTenantLog: (data: ITenantLogQuery, params?: RequestParams) => Promise<HttpResponse<IResponseModelListTenantLog, void | IHTTPValidationError>>;
-        /**
-         * No description
-         *
-         * @tags agent
-         * @name ProResearchApiV1AgentProResearchPost
-         * @summary Pro Research
-         * @request POST:/api/v1/agent/pro_research
-         */
-        proResearchApiV1AgentProResearchPost: (data: IProResearchRequest, params?: RequestParams) => Promise<HttpResponse<any, void | IHTTPValidationError>>;
         /**
          * @description whisker 通用 webhook
          *
@@ -3588,7 +3348,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         handleWebhookApiV1WebhookWebhookTypeSourceAuthInfoKnowledgeBaseIdPost: (webhookType: string, source: string, authInfo: string, knowledgeBaseId: string, data: Record<string, any>, params?: RequestParams) => Promise<HttpResponse<any, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 分页获取标签关联列表 使用DDD架构的TaggingService进行分页查询。
          *
          * @tags tagging
          * @name GetTaggingList
@@ -3597,7 +3357,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         getTaggingList: (data: IPageQueryParamsTagging, params?: RequestParams) => Promise<HttpResponse<IResponseModelPageResponseTagging, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 批量新增标签关联 使用DDD架构创建新的标签关联列表。
          *
          * @tags tagging
          * @name AddTaggingList
@@ -3606,7 +3366,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         addTaggingList: (data: ITaggingCreate[], params?: RequestParams) => Promise<HttpResponse<IResponseModelListTagging, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 删除标签关联 使用DDD架构删除标签关联记录。
          *
          * @tags tagging
          * @name DeleteTaggingById
@@ -3624,7 +3384,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         getTagList: (data: IPageQueryParamsTag, params?: RequestParams) => Promise<HttpResponse<IResponseModelPageResponseTag, void | IHTTPValidationError>>;
         /**
-         * @description 批量新增标签 注意：根据接口定义，DB 插件方法签名为 add_tag_list(tag_list: List[TagCreate])， 因此此处直接传入 body。若 TagCreate 需要携带 tenant_id，应由模型或插件内部处理。
+         * @description 批量新增标签
          *
          * @tags tag
          * @name AddTagList
@@ -3642,7 +3402,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         getTagById: (tagId: string, params?: RequestParams) => Promise<HttpResponse<IResponseModelTag, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 删除标签
          *
          * @tags tag
          * @name DeleteTagById
@@ -3651,7 +3411,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         deleteTagById: (tagId: string, params?: RequestParams) => Promise<HttpResponse<IResponseModelNoneType, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 更新标签
          *
          * @tags tag
          * @name UpdateTag
@@ -3660,7 +3420,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         updateTag: (data: ITagUpdate, params?: RequestParams) => Promise<HttpResponse<IResponseModelTag, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 分页获取工件列表 使用DDD架构的ArtifactService进行分页查询。
          *
          * @tags artifact
          * @name GetArtifactList
@@ -3669,7 +3429,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         getArtifactList: (data: IPageQueryParamsArtifactIndex, params?: RequestParams) => Promise<HttpResponse<IResponseModelPageResponseArtifactIndex, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 批量新增工件 使用DDD架构创建新的工件列表。
          *
          * @tags artifact
          * @name AddArtifactList
@@ -3678,7 +3438,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         addArtifactList: (data: IArtifactIndexCreate[], params?: RequestParams) => Promise<HttpResponse<IResponseModelListArtifactIndex, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 获取工件详情 使用DDD架构获取工件详细信息。
          *
          * @tags artifact
          * @name GetArtifactById
@@ -3687,7 +3447,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         getArtifactById: (artifactId: string, params?: RequestParams) => Promise<HttpResponse<IResponseModelArtifactIndex, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 删除工件 使用DDD架构删除工件记录。
          *
          * @tags artifact
          * @name DeleteArtifactById
@@ -3696,18 +3456,18 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         deleteArtifactById: (artifactId: string, params?: RequestParams) => Promise<HttpResponse<IResponseModelNoneType, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 更新工件空间绑定 使用DDD架构更新工件的空间关联。
          *
          * @tags artifact
          * @name UpdateArtifactSpaceId
          * @summary Update Artifact Space Id
-         * @request POST:/api/v1/artifact/update_space
+         * @request POST:/api/v1/artifact/update/space_id
          */
         updateArtifactSpaceId: (data: IArtifactSpaceUpdate, params?: RequestParams) => Promise<HttpResponse<IResponseModelArtifactIndex, void | IHTTPValidationError>>;
     };
     rule: {
         /**
-         * No description
+         * @description 获取租户全局规则 使用DDD架构的RuleService获取租户级别的规则配置。
          *
          * @tags rule
          * @name GetGlobalRule
@@ -3716,7 +3476,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         getGlobalRule: (params?: RequestParams) => Promise<HttpResponse<IResponseModelStr, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 获取空间规则 使用DDD架构的RuleService获取空间级别的规则配置。
          *
          * @tags rule
          * @name GetSpaceRule
@@ -3727,7 +3487,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
     };
     apiKey: {
         /**
-         * No description
+         * @description 创建API Key
          *
          * @tags api key
          * @name CreateApiKey
@@ -3736,7 +3496,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         createApiKey: (data: IAPIKeyCreate, params?: RequestParams) => Promise<HttpResponse<IResponseModelAPIKey, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 更新API Key
          *
          * @tags api key
          * @name UpdateApiKey
@@ -3745,7 +3505,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         updateApiKey: (data: IAPIKeyUpdate, params?: RequestParams) => Promise<HttpResponse<IResponseModelAPIKey, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 获取API Key列表
          *
          * @tags api key
          * @name GetApiKeyList
@@ -3754,7 +3514,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         getApiKeyList: (data: IPageQueryParamsAPIKey, params?: RequestParams) => Promise<HttpResponse<IResponseModelPageResponseAPIKey, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 删除API Key
          *
          * @tags api key
          * @name DeleteApiKey
@@ -3763,7 +3523,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         deleteApiKey: (keyId: string, params?: RequestParams) => Promise<HttpResponse<IResponseModelNoneType, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 更改API Key激活状态
          *
          * @tags api key
          * @name DeactivateApiKey
@@ -3772,7 +3532,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         deactivateApiKey: (keyId: string, data: IActiveStatusUpdate, params?: RequestParams) => Promise<HttpResponse<IResponseModelNoneType, void | IHTTPValidationError>>;
         /**
-         * No description
+         * @description 获取所有过期的API Key
          *
          * @tags api key
          * @name GetAllExpiredApiKeys