@petercatai/whisker-client 2.0.0 → 3.0.0

package/dist/api.d.ts

@@ -206,7 +206,10 @@ export declare enum IKnowledgeTypeEnum {
     Json = "json",
     Docx = "docx",
     Pdf = "pdf",
+    Powerpoint = "powerpoint",
+    Webpage = "webpage",
     Qa = "qa",
+    Folder = "folder",
     Yuquedoc = "yuquedoc",
     YuqueBook = "yuque_book",
     GithubRepo = "github_repo",
@@ -251,12 +254,26 @@ export declare enum IKnowledgeSourceEnum {
     GithubFile = "github_file",
     UserInputText = "user_input_text",
     CloudStorageText = "cloud_storage_text",
+    CloudStorageFile = "cloud_storage_file",
     CloudStorageImage = "cloud_storage_image",
+    Os = "os",
     Yuque = "yuque",
     YuquePersonalDoc = "yuque_personal_doc",
     YuquePersonalNote = "yuque_personal_note",
     HituNodePackage = "hitu_node_package"
 }
+/** CliChangeOp */
+export declare enum ICliChangeOp {
+    Add = "add",
+    Modify = "modify",
+    Delete = "delete"
+}
+/** CliApplyStatus */
+export declare enum ICliApplyStatus {
+    Applied = "applied",
+    Skipped = "skipped",
+    Failed = "failed"
+}
 /** Action */
 export declare enum IAction {
     Create = "create",
@@ -1130,6 +1147,96 @@ export interface ICleanupHistoryResponse {
      */
     before_time: string;
 }
+/** CliApplyRequest */
+export interface ICliApplyRequest {
+    /** Space Id */
+    space_id: string;
+    /** Expected Snapshot Token */
+    expected_snapshot_token?: string | null;
+    /**
+     * Force
+     * @default false
+     */
+    force?: boolean;
+    /** Entries */
+    entries: ICliChangesetEntry[];
+}
+/** CliApplyResponse */
+export interface ICliApplyResponse {
+    /** Space Id */
+    space_id: string;
+    /** Expected Snapshot Token */
+    expected_snapshot_token?: string | null;
+    /** Snapshot Token Before */
+    snapshot_token_before: string;
+    /** Snapshot Token After */
+    snapshot_token_after: string;
+    /**
+     * Version Conflict
+     * @default false
+     */
+    version_conflict?: boolean;
+    /**
+     * Applied
+     * @default 0
+     */
+    applied?: number;
+    /**
+     * Skipped
+     * @default 0
+     */
+    skipped?: number;
+    /**
+     * Failed
+     * @default 0
+     */
+    failed?: number;
+    /** Results */
+    results: ICliApplyResultItem[];
+}
+/** CliApplyResultItem */
+export interface ICliApplyResultItem {
+    /** Path */
+    path: string;
+    op: ICliChangeOp;
+    status: ICliApplyStatus;
+    /** Knowledge Id */
+    knowledge_id?: string | null;
+    /** Knowledge Name */
+    knowledge_name?: string | null;
+    /** Knowledge Type */
+    knowledge_type?: string | null;
+    /** Message */
+    message?: string | null;
+}
+/** CliChangesetEntry */
+export interface ICliChangesetEntry {
+    op: ICliChangeOp;
+    /** Path */
+    path: string;
+    /** Knowledge Id */
+    knowledge_id?: string | null;
+    /** Knowledge Name */
+    knowledge_name?: string | null;
+    /** Knowledge Type */
+    knowledge_type?: string | null;
+    /** Source Type */
+    source_type?: string | null;
+    /** Source Config */
+    source_config?: Record<string, any>;
+    /** Embedding Model Name */
+    embedding_model_name?: string | null;
+    /** Split Config */
+    split_config?: Record<string, any>;
+    /** Metadata */
+    metadata?: Record<string, any>;
+    /** File Sha */
+    file_sha?: string | null;
+    /** File Size */
+    file_size?: number | null;
+    /** Parent Id */
+    parent_id?: string | null;
+}
 /** Condition */
 export interface ICondition {
     /** Field */
@@ -1185,6 +1292,90 @@ export interface IFilterGroup {
     /** Conditions */
     conditions: (ICondition | IFilterGroup)[];
 }
+/** FolderCreate */
+export interface IFolderCreate {
+    /**
+     * Space Id
+     * the space of knowledge, example: petercat bot id, github repo name
+     */
+    space_id: string;
+    /**
+     * Knowledge Type
+     * folder knowledge type
+     * @default "folder"
+     */
+    knowledge_type?: "folder";
+    /**
+     * Knowledge Name
+     * name of the knowledge resource
+     * @maxLength 255
+     */
+    knowledge_name: string;
+    /**
+     * Metadata
+     * additional metadata, user can update it
+     * @default {}
+     */
+    metadata?: Record<string, any>;
+    /**
+     * Source Type
+     * folder source type
+     * @default "os"
+     */
+    source_type?: "os";
+    /**
+     * Embedding Model Name
+     * name of the embedding model. you can set any other model if target embedding service registered
+     */
+    embedding_model_name: string;
+    /**
+     * File Sha
+     * SHA of the file
+     */
+    file_sha?: string | null;
+    /**
+     * File Size
+     * size of the file
+     */
+    file_size?: number | null;
+    /**
+     * Parent Id
+     * parent id of the knowledge
+     */
+    parent_id?: string | null;
+    /** folder source config */
+    source_config: IFolderSourceConfig;
+    /**
+     * folder split config
+     * @default {"type":"folder"}
+     */
+    split_config?: IFolderSplitConfig;
+}
+/**
+ * FolderSourceConfig
+ * 文件夹来源配置
+ *
+ * 路径必须是绝对路径，以 / 开头，不允许相对路径。
+ */
+export interface IFolderSourceConfig {
+    /**
+     * Path
+     * 文件夹绝对路径，必须以 / 开头，如 /docs/api/
+     * @default "/"
+     */
+    path?: string;
+}
+/**
+ * FolderSplitConfig
+ * 文件夹分块配置（空配置，folder 不分块）
+ */
+export interface IFolderSplitConfig {
+    /**
+     * Type
+     * @default "folder"
+     */
+    type?: "folder";
+}
 /**
  * GeaGraphSplitConfig
  * JSON document split configuration
@@ -1698,7 +1889,7 @@ export interface IKnowledgeInput {
      * Source Config
      * source config of the knowledge
      */
-    source_config: IGithubRepoSourceConfig | IGithubFileSourceConfig | IS3SourceConfig | IOpenUrlSourceConfig | ITextSourceConfig | IOpenIdSourceConfig | IYuqueSourceConfig | IYuquePersonalDocSourceConfig | IYuquePersonalNoteSourceConfig | INodePackageSourceConfig;
+    source_config: IGithubRepoSourceConfig | IGithubFileSourceConfig | IS3SourceConfig | IOpenUrlSourceConfig | ITextSourceConfig | IOpenIdSourceConfig | IYuqueSourceConfig | IYuquePersonalDocSourceConfig | IYuquePersonalNoteSourceConfig | INodePackageSourceConfig | IFolderSourceConfig;
     /**
      * Embedding Model Name
      * name of the embedding model. you can set any other model if target embedding service registered
@@ -1708,7 +1899,7 @@ export interface IKnowledgeInput {
      * Split Config
      * configuration for splitting the knowledge
      */
-    split_config: IBaseCharSplitConfig | IMarkdownSplitConfig | ITextSplitConfig | IJSONSplitConfig | IPDFSplitConfig | IYuqueSplitConfig | IGeaGraphSplitConfig | IGithubRepoParseConfig | IBaseCodeSplitConfig | IImageSplitConfig | INodePackageParseConfig | IMemorySplitConfig;
+    split_config: IMarkdownSplitConfig | ITextSplitConfig | IJSONSplitConfig | IPDFSplitConfig | IYuqueSplitConfig | IGeaGraphSplitConfig | IGithubRepoParseConfig | IBaseCodeSplitConfig | IImageSplitConfig | INodePackageParseConfig | IMemorySplitConfig | IFolderSplitConfig | IBaseCharSplitConfig;
     /**
      * File Sha
      * SHA of the file
@@ -1784,7 +1975,7 @@ export interface IKnowledgeOutput {
      * Source Config
      * source config of the knowledge
      */
-    source_config: IGithubRepoSourceConfig | IGithubFileSourceConfig | IS3SourceConfig | IOpenUrlSourceConfig | ITextSourceConfig | IOpenIdSourceConfig | IYuqueSourceConfig | IYuquePersonalDocSourceConfig | IYuquePersonalNoteSourceConfig | INodePackageSourceConfig;
+    source_config: IGithubRepoSourceConfig | IGithubFileSourceConfig | IS3SourceConfig | IOpenUrlSourceConfig | ITextSourceConfig | IOpenIdSourceConfig | IYuqueSourceConfig | IYuquePersonalDocSourceConfig | IYuquePersonalNoteSourceConfig | INodePackageSourceConfig | IFolderSourceConfig;
     /**
      * Embedding Model Name
      * name of the embedding model. you can set any other model if target embedding service registered
@@ -1794,7 +1985,7 @@ export interface IKnowledgeOutput {
      * Split Config
      * configuration for splitting the knowledge
      */
-    split_config: IBaseCharSplitConfig | IMarkdownSplitConfig | ITextSplitConfig | IJSONSplitConfig | IPDFSplitConfig | IYuqueSplitConfig | IGeaGraphSplitConfig | IGithubRepoParseConfig | IBaseCodeSplitConfig | IImageSplitConfig | INodePackageParseConfig | IMemorySplitConfig;
+    split_config: IMarkdownSplitConfig | ITextSplitConfig | IJSONSplitConfig | IPDFSplitConfig | IYuqueSplitConfig | IGeaGraphSplitConfig | IGithubRepoParseConfig | IBaseCodeSplitConfig | IImageSplitConfig | INodePackageParseConfig | IMemorySplitConfig | IFolderSplitConfig | IBaseCharSplitConfig;
     /**
      * File Sha
      * SHA of the file
@@ -2036,7 +2227,7 @@ export interface IKnowledgeResponse {
      * Source Config
      * source config of the knowledge
      */
-    source_config: IGithubRepoSourceConfig | IGithubFileSourceConfig | IS3SourceConfig | IOpenUrlSourceConfig | ITextSourceConfig | IOpenIdSourceConfig | IYuqueSourceConfig | IYuquePersonalDocSourceConfig | IYuquePersonalNoteSourceConfig | INodePackageSourceConfig;
+    source_config: IGithubRepoSourceConfig | IGithubFileSourceConfig | IS3SourceConfig | IOpenUrlSourceConfig | ITextSourceConfig | IOpenIdSourceConfig | IYuqueSourceConfig | IYuquePersonalDocSourceConfig | IYuquePersonalNoteSourceConfig | INodePackageSourceConfig | IFolderSourceConfig;
     /**
      * Embedding Model Name
      * name of the embedding model. you can set any other model if target embedding service registered
@@ -2046,7 +2237,7 @@ export interface IKnowledgeResponse {
      * Split Config
      * configuration for splitting the knowledge
      */
-    split_config: IBaseCharSplitConfig | IMarkdownSplitConfig | ITextSplitConfig | IJSONSplitConfig | IPDFSplitConfig | IYuqueSplitConfig | IGeaGraphSplitConfig | IGithubRepoParseConfig | IBaseCodeSplitConfig | IImageSplitConfig | INodePackageParseConfig | IMemorySplitConfig;
+    split_config: IMarkdownSplitConfig | ITextSplitConfig | IJSONSplitConfig | IPDFSplitConfig | IYuqueSplitConfig | IGeaGraphSplitConfig | IGithubRepoParseConfig | IBaseCodeSplitConfig | IImageSplitConfig | INodePackageParseConfig | IMemorySplitConfig | IFolderSplitConfig | IBaseCharSplitConfig;
     /**
      * File Sha
      * SHA of the file
@@ -2570,6 +2761,16 @@ export interface IMemoryUpdate {
      */
     metadata?: Record<string, any> | null;
 }
+/**
+ * MoveKnowledgeRequest
+ * 移动知识请求
+ */
+export interface IMoveKnowledgeRequest {
+    /** Knowledge Ids */
+    knowledge_ids: string[];
+    /** Target Folder Id */
+    target_folder_id?: string | null;
+}
 /** NodePackageParseConfig */
 export interface INodePackageParseConfig {
     /**
@@ -2620,7 +2821,10 @@ export interface IOpenUrlSourceConfig {
      */
     auth_info?: string | Record<string, any> | null;
 }
-/** PDFCreate */
+/**
+ * PDFCreate
+ * PDF 文档创建 DTO - 通过 markitdown 转换为 Markdown 后处理
+ */
 export interface IPDFCreate {
     /**
      * Space Id
@@ -2656,12 +2860,12 @@ export interface IPDFCreate {
      * File Sha
      * SHA of the file
      */
-    file_sha: string;
+    file_sha?: string | null;
     /**
      * File Size
      * Byte size of the file
      */
-    file_size: number;
+    file_size?: number | null;
     /**
      * Parent Id
      * parent id of the knowledge
@@ -2672,8 +2876,8 @@ export interface IPDFCreate {
      * source config of the knowledge
      */
     source_config: IOpenUrlSourceConfig | IOpenIdSourceConfig | IS3SourceConfig;
-    /** split config of the knowledge */
-    split_config: IPDFSplitConfig;
+    /** split config of the knowledge (markdown after markitdown conversion) */
+    split_config: IMarkdownSplitConfig;
 }
 /**
  * PDFSplitConfig
@@ -3434,6 +3638,64 @@ export interface IPermission {
     /** Conditions */
     conditions?: Record<string, any> | null;
 }
+/**
+ * PowerPointCreate
+ * PowerPoint 文档创建 DTO - 通过 markitdown 转换为 Markdown 后处理
+ */
+export interface IPowerPointCreate {
+    /**
+     * Space Id
+     * the space of knowledge, example: petercat bot id, github repo name
+     */
+    space_id: string;
+    /**
+     * Knowledge Type
+     * type of knowledge resource
+     * @default "powerpoint"
+     */
+    knowledge_type?: "powerpoint";
+    /**
+     * Knowledge Name
+     * name of the knowledge resource
+     * @maxLength 255
+     */
+    knowledge_name: string;
+    /**
+     * Metadata
+     * additional metadata, user can update it
+     * @default {}
+     */
+    metadata?: Record<string, any>;
+    /** source type */
+    source_type: IKnowledgeSourceEnum;
+    /**
+     * Embedding Model Name
+     * name of the embedding model. you can set any other model if target embedding service registered
+     */
+    embedding_model_name: string;
+    /**
+     * File Sha
+     * SHA of the file
+     */
+    file_sha: string;
+    /**
+     * File Size
+     * Byte size of the file
+     */
+    file_size: number;
+    /**
+     * Parent Id
+     * parent id of the knowledge
+     */
+    parent_id?: string | null;
+    /**
+     * Source Config
+     * source config of the knowledge
+     */
+    source_config: IOpenUrlSourceConfig | IOpenIdSourceConfig | IS3SourceConfig;
+    /** split config of the knowledge (markdown after markitdown conversion) */
+    split_config: IMarkdownSplitConfig;
+}
 /** QACreate */
 export interface IQACreate {
     /**
@@ -3622,6 +3884,14 @@ export interface IResponseModelCleanupHistoryResponse {
     /** Message */
     message?: string | null;
 }
+/** ResponseModel[CliApplyResponse] */
+export interface IResponseModelCliApplyResponse {
+    /** Success */
+    success: boolean;
+    data?: ICliApplyResponse | null;
+    /** Message */
+    message?: string | null;
+}
 /** ResponseModel[Dict[str, Any]] */
 export interface IResponseModelDictStrAny {
     /** Success */
@@ -3698,6 +3968,15 @@ export interface IResponseModelListArtifactIndex {
     /** Message */
     message?: string | null;
 }
+/** ResponseModel[List[Dict[str, Any]]] */
+export interface IResponseModelListDictStrAny {
+    /** Success */
+    success: boolean;
+    /** Data */
+    data?: Record<string, any>[] | null;
+    /** Message */
+    message?: string | null;
+}
 /** ResponseModel[List[Knowledge]] */
 export interface IResponseModelListKnowledge {
     /** Success */
@@ -3965,6 +4244,22 @@ export interface IResponseModelStatusStatisticsPageResponseTask {
     /** Message */
     message?: string | null;
 }
+/** ResponseModel[SyncMaterializeData] */
+export interface IResponseModelSyncMaterializeData {
+    /** Success */
+    success: boolean;
+    data?: ISyncMaterializeData | null;
+    /** Message */
+    message?: string | null;
+}
+/** ResponseModel[SyncSnapshotData] */
+export interface IResponseModelSyncSnapshotData {
+    /** Success */
+    success: boolean;
+    data?: ISyncSnapshotData | null;
+    /** Message */
+    message?: string | null;
+}
 /** ResponseModel[Tag] */
 export interface IResponseModelTag {
     /** Success */
@@ -4707,6 +5002,77 @@ export interface IStatusStatisticsPageResponseTask {
      */
     deleted?: number;
 }
+/** SyncMaterializeData */
+export interface ISyncMaterializeData {
+    /** Space Id */
+    space_id: string;
+    /** Items */
+    items: ISyncMaterializeItem[];
+}
+/** SyncMaterializeItem */
+export interface ISyncMaterializeItem {
+    /** Knowledge Id */
+    knowledge_id: string;
+    /** Knowledge Name */
+    knowledge_name: string;
+    /** Knowledge Type */
+    knowledge_type: string;
+    /** Source Type */
+    source_type: string;
+    /** File Sha */
+    file_sha?: string | null;
+    /** File Size */
+    file_size?: number | null;
+    /** Parent Id */
+    parent_id?: string | null;
+    /** Metadata */
+    metadata?: Record<string, any>;
+    /** Text Content */
+    text_content?: string | null;
+    /** File Url */
+    file_url?: string | null;
+    /** Source Locator */
+    source_locator?: Record<string, any> | null;
+    /** Materialize Error */
+    materialize_error?: string | null;
+}
+/** SyncMaterializeRequest */
+export interface ISyncMaterializeRequest {
+    /** Space Id */
+    space_id: string;
+    /** Knowledge Ids */
+    knowledge_ids?: string[];
+}
+/** SyncSnapshotData */
+export interface ISyncSnapshotData {
+    /** Space Id */
+    space_id: string;
+    /** Snapshot Token */
+    snapshot_token: string;
+    /** Items */
+    items: ISyncSnapshotItem[];
+}
+/** SyncSnapshotItem */
+export interface ISyncSnapshotItem {
+    /** Knowledge Id */
+    knowledge_id: string;
+    /** Knowledge Name */
+    knowledge_name: string;
+    /** Knowledge Type */
+    knowledge_type: string;
+    /** Source Type */
+    source_type: string;
+    /** File Sha */
+    file_sha?: string | null;
+    /** File Size */
+    file_size?: number | null;
+    /** Updated At */
+    updated_at?: string | null;
+    /** Metadata Digest */
+    metadata_digest?: string | null;
+    /** Parent Id */
+    parent_id?: string | null;
+}
 /** Tag */
 export interface ITag {
     /**
@@ -5385,6 +5751,61 @@ export interface IWebhookTestResponse {
     /** Error */
     error: string | null;
 }
+/**
+ * WebpageCreate
+ * 网页 URL 创建 DTO - 通过 markdown.new 转换为 Markdown 后处理
+ */
+export interface IWebpageCreate {
+    /**
+     * Space Id
+     * the space of knowledge, example: petercat bot id, github repo name
+     */
+    space_id: string;
+    /**
+     * Knowledge Type
+     * type of knowledge resource
+     * @default "webpage"
+     */
+    knowledge_type?: "webpage";
+    /**
+     * Knowledge Name
+     * name of the knowledge resource
+     * @maxLength 255
+     */
+    knowledge_name: string;
+    /**
+     * Metadata
+     * additional metadata, user can update it
+     * @default {}
+     */
+    metadata?: Record<string, any>;
+    /** source type */
+    source_type: IKnowledgeSourceEnum;
+    /**
+     * Embedding Model Name
+     * name of the embedding model. you can set any other model if target embedding service registered
+     */
+    embedding_model_name: string;
+    /**
+     * File Sha
+     * SHA of the file
+     */
+    file_sha?: string | null;
+    /**
+     * File Size
+     * size of the file
+     */
+    file_size?: number | null;
+    /**
+     * Parent Id
+     * parent id of the knowledge
+     */
+    parent_id?: string | null;
+    /** source config of the knowledge (webpage URL) */
+    source_config: IOpenUrlSourceConfig;
+    /** split config of the knowledge (markdown after markdown.new conversion) */
+    split_config: IMarkdownSplitConfig;
+}
 /**
  * WohuProductSpace
  * 产品空间响应模型
@@ -5665,7 +6086,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @summary Add Knowledge
          * @request POST:/api/knowledge/add
          */
-        addKnowledge: (data: (ITextCreate | IImageCreate | IJSONCreate | IMarkdownCreate | IPDFCreate | IGithubRepoCreate | IQACreate | IYuqueCreate | IHituNodePackageCreate | IHituNodePackageElementCreate)[], params?: RequestParams) => Promise<HttpResponse<IResponseModelListKnowledge, void | IHTTPValidationError>>;
+        addKnowledge: (data: (ITextCreate | IImageCreate | IJSONCreate | IMarkdownCreate | IPDFCreate | IPowerPointCreate | IWebpageCreate | IGithubRepoCreate | IQACreate | IYuqueCreate | IHituNodePackageCreate | IHituNodePackageElementCreate | IFolderCreate)[], params?: RequestParams) => Promise<HttpResponse<IResponseModelListKnowledge, void | IHTTPValidationError>>;
         /**
          * @description 更新知识（全量更新） 更新知识的完整信息，支持以下字段变更： - 元数据(metadata)变更：同步更新对应 chunk 的 metadata - 启用状态(enabled)变更：同步更新对应 chunk 的启用状态 - 嵌入模型/分片配置/来源配置变更：自动触发重新入库任务 注意：knowledge_type、source_type 等核心字段不可变更。 Args: knowledge: 完整的知识对象，需包含 knowledge_id Returns: 更新后的知识对象（auth_info 字段已脱敏）
          *
@@ -5733,7 +6154,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
             knowledge_id: string;
         }, params?: RequestParams) => Promise<HttpResponse<IResponseModelKnowledge, void | IHTTPValidationError>>;
         /**
-         * @description 删除知识 级联删除知识及其关联数据： - 删除 MySQL 中的知识记录和相关任务 - 删除向量数据库中的所有 chunk 数据 - 清除所属 Space 的总结时间标记（下次总结时将进行全量总结） Args: knowledge_id: 要删除的知识ID Raises: 404: 知识不存在
+         * @description 删除知识 如果删除的是 folder 类型，会自动级联删除所有子孙节点。 级联删除知识及其关联数据： - 删除 MySQL 中的知识记录和相关任务 - 删除向量数据库中的所有 chunk 数据 - 清除所属 Space 的总结时间标记（下次总结时将进行全量总结） Args: knowledge_id: 要删除的知识ID Raises: 404: 知识不存在
          *
          * @tags knowledge
          * @name DeleteKnowledge
@@ -5752,7 +6173,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @summary Get Embedding Models List
          * @request GET:/api/knowledge/embedding/models
          */
-        getEmbeddingModelsList: (params?: RequestParams) => Promise<HttpResponse<any, void | IHTTPValidationError>>;
+        getEmbeddingModelsList: (params?: RequestParams) => Promise<HttpResponse<IResponseModelListDictStrAny, void | IHTTPValidationError>>;
         /**
          * @description 根据名称批量查询知识 在指定 Space 下，根据知识名称列表批量查询知识详情。 适用于已知知识名称需要获取完整信息的场景。 Args: body.space_id: 空间ID body.knowledge_names: 知识名称列表 Returns: 符合条件的知识列表（auth_info 字段已脱敏）
          *
@@ -5801,6 +6222,35 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @request POST:/api/knowledge/refresh/by_conditions
          */
         refreshKnowledgeByConditions: (data: IKnowledgeRefreshByConditionsRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelKnowledgeRefreshResult, void | IHTTPValidationError>>;
+        /**
+         * @description 获取目录树结构 获取指定空间下的文件夹树形结构，返回嵌套的树形数据。 自动检测并处理循环引用。 Args: space_id: 空间ID root_id: 根节点ID，None 表示从空间根目录开始 Returns: 嵌套的树形结构，包含 items 列表
+         *
+         * @tags knowledge
+         * @name GetFolderTree
+         * @summary Get Folder Tree
+         * @request GET:/api/knowledge/folder/tree
+         */
+        getFolderTree: (query: {
+            /**
+             * Space Id
+             * 空间ID
+             */
+            space_id: string;
+            /**
+             * Root Id
+             * 根节点ID，None 表示从空间根目录开始
+             */
+            root_id?: string | null;
+        }, params?: RequestParams) => Promise<HttpResponse<IResponseModelDictStrAny, void | IHTTPValidationError>>;
+        /**
+         * @description 移动知识到指定文件夹下 将指定的知识批量移动到目标文件夹。如果目标文件夹不存在或不是文件夹类型， 将抛出异常。不支持将文件夹移动到自身或其子文件夹下。 Args: body.knowledge_ids: 要移动的知识ID列表 body.target_folder_id: 目标文件夹ID，None 表示移动到根目录 Returns: 成功时返回 None
+         *
+         * @tags knowledge
+         * @name MoveKnowledgeToFolder
+         * @summary Move Knowledge To Folder
+         * @request POST:/api/knowledge/folder/move
+         */
+        moveKnowledgeToFolder: (data: IMoveKnowledgeRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelNoneType, void | IHTTPValidationError>>;
     };
     knowledgeIndex: {
         /**
@@ -6054,7 +6504,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
             page_size?: number;
         }, params?: RequestParams) => Promise<HttpResponse<IResponseModelPageResponseTenant, void | IHTTPValidationError>>;
         /**
-         * @description 获取当前租户信息 通过请求头中的认证信息（secret_key）获取当前租户的详细信息。 无需传入任何参数，系统自动从认证上下文中识别租户身份。 Returns: 当前认证租户的详细信息（secret_key 字段已脱敏）
+         * @description 获取当前租户信息 Returns: 当前租户的详细信息（secret_key 字段已脱敏）
          *
          * @tags tenant
          * @name GetTenant
@@ -6796,7 +7246,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
     };
     file: {
         /**
-         * @description 上传文件到 AFTS 存储 这是一个开放接口，无需权限校验。上传的文件会被存储到 AFTS（Ant File Transfer Service）。 文件路径生成规则： - 使用日期做分隔：{year}/{month}/{day}/ - 随机码作为路径层级：{random_code}/ - 文件名保持原样：{filename} - 最终格式：2026/03/01/abc123def456/image.png 设计意图： - 文件名保持原样，方便识别和管理 - 随机码作为路径层级，增加不可预测性 - 文件可读，但路径不可猜测 Args: file: 上传的文件 Returns: FileUploadResponse: 包含文件 ID、URL、路径等信息
+         * @description 上传文件到 AFTS 存储 需要 FILE 资源的 CREATE 权限。上传的文件会被存储到 AFTS（Ant File Transfer Service）。 文件路径生成规则： - tenant_id 作为根路径：{tenant_id}/ - 使用日期做分隔：{year}/{month}/{day}/ - 随机码作为路径层级：{random_code}/ - 文件名保持原样：{filename} - 最终格式：tenant_xxx/2026/03/01/abc123def456/image.png 设计意图： - tenant_id 追踪文件归属 - 文件名保持原样，方便识别和管理 - 随机码作为路径层级，增加不可预测性 - 文件可读，但路径不可猜测 Args: file: 上传的文件 Returns: FileUploadResponse: 包含文件 ID、URL、路径等信息
          *
          * @tags file
          * @name UploadFile
@@ -6805,6 +7255,38 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         uploadFile: (data: IBodyUploadFile, params?: RequestParams) => Promise<HttpResponse<IResponseModelFileUploadResponse, void | IHTTPValidationError>>;
     };
+    cli: {
+        /**
+         * No description
+         *
+         * @tags cli_sync
+         * @name CliSyncSnapshot
+         * @summary Get Sync Snapshot
+         * @request GET:/api/cli/sync/snapshot
+         */
+        cliSyncSnapshot: (query: {
+            /** Space Id */
+            space_id: string;
+        }, params?: RequestParams) => Promise<HttpResponse<IResponseModelSyncSnapshotData, void | IHTTPValidationError>>;
+        /**
+         * No description
+         *
+         * @tags cli_sync
+         * @name CliSyncMaterialize
+         * @summary Materialize Sync Knowledge
+         * @request POST:/api/cli/sync/materialize
+         */
+        cliSyncMaterialize: (data: ISyncMaterializeRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelSyncMaterializeData, void | IHTTPValidationError>>;
+        /**
+         * No description
+         *
+         * @tags cli_sync
+         * @name CliSyncApply
+         * @summary Apply Sync Changeset
+         * @request POST:/api/cli/sync/apply
+         */
+        cliSyncApply: (data: ICliApplyRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelCliApplyResponse, void | IHTTPValidationError>>;
+    };
     healthChecker: {
         /**
          * No description

package/dist/api.js

@@ -22,7 +22,7 @@ var __rest = (this && this.__rest) || function (s, e) {
     return t;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Api = exports.HttpClient = exports.ContentType = exports.IAction = exports.IKnowledgeSourceEnum = exports.IKnowledgeTypeEnum = exports.ILanguage = exports.IMemoryStatusEnum = exports.IMemoryTypeEnum = exports.IOperator = exports.IResource = exports.ISchedulerCronTimezone = exports.ISchedulerIntervalType = exports.ISchedulerJobStatus = exports.ISchedulerJobType = exports.ISchedulerRunResult = exports.ISchedulerTargetType = exports.ITagObjectType = exports.ITaskStatus = exports.ITextKnowledgeContentUpdateStatusEnum = exports.IWebhookDeliveryStatus = exports.IWebhookEventType = exports.IWebhookOutboxStatus = exports.IWebhookSubscriptionStatus = void 0;
+exports.Api = exports.HttpClient = exports.ContentType = exports.IAction = exports.ICliApplyStatus = exports.ICliChangeOp = exports.IKnowledgeSourceEnum = exports.IKnowledgeTypeEnum = exports.ILanguage = exports.IMemoryStatusEnum = exports.IMemoryTypeEnum = exports.IOperator = exports.IResource = exports.ISchedulerCronTimezone = exports.ISchedulerIntervalType = exports.ISchedulerJobStatus = exports.ISchedulerJobType = exports.ISchedulerRunResult = exports.ISchedulerTargetType = exports.ITagObjectType = exports.ITaskStatus = exports.ITextKnowledgeContentUpdateStatusEnum = exports.IWebhookDeliveryStatus = exports.IWebhookEventType = exports.IWebhookOutboxStatus = exports.IWebhookSubscriptionStatus = void 0;
 /**
  * WebhookSubscriptionStatus
  * Webhook订阅状态
@@ -250,7 +250,10 @@ var IKnowledgeTypeEnum;
     IKnowledgeTypeEnum["Json"] = "json";
     IKnowledgeTypeEnum["Docx"] = "docx";
     IKnowledgeTypeEnum["Pdf"] = "pdf";
+    IKnowledgeTypeEnum["Powerpoint"] = "powerpoint";
+    IKnowledgeTypeEnum["Webpage"] = "webpage";
     IKnowledgeTypeEnum["Qa"] = "qa";
+    IKnowledgeTypeEnum["Folder"] = "folder";
     IKnowledgeTypeEnum["Yuquedoc"] = "yuquedoc";
     IKnowledgeTypeEnum["YuqueBook"] = "yuque_book";
     IKnowledgeTypeEnum["GithubRepo"] = "github_repo";
@@ -296,12 +299,28 @@ var IKnowledgeSourceEnum;
     IKnowledgeSourceEnum["GithubFile"] = "github_file";
     IKnowledgeSourceEnum["UserInputText"] = "user_input_text";
     IKnowledgeSourceEnum["CloudStorageText"] = "cloud_storage_text";
+    IKnowledgeSourceEnum["CloudStorageFile"] = "cloud_storage_file";
     IKnowledgeSourceEnum["CloudStorageImage"] = "cloud_storage_image";
+    IKnowledgeSourceEnum["Os"] = "os";
     IKnowledgeSourceEnum["Yuque"] = "yuque";
     IKnowledgeSourceEnum["YuquePersonalDoc"] = "yuque_personal_doc";
     IKnowledgeSourceEnum["YuquePersonalNote"] = "yuque_personal_note";
     IKnowledgeSourceEnum["HituNodePackage"] = "hitu_node_package";
 })(IKnowledgeSourceEnum || (exports.IKnowledgeSourceEnum = IKnowledgeSourceEnum = {}));
+/** CliChangeOp */
+var ICliChangeOp;
+(function (ICliChangeOp) {
+    ICliChangeOp["Add"] = "add";
+    ICliChangeOp["Modify"] = "modify";
+    ICliChangeOp["Delete"] = "delete";
+})(ICliChangeOp || (exports.ICliChangeOp = ICliChangeOp = {}));
+/** CliApplyStatus */
+var ICliApplyStatus;
+(function (ICliApplyStatus) {
+    ICliApplyStatus["Applied"] = "applied";
+    ICliApplyStatus["Skipped"] = "skipped";
+    ICliApplyStatus["Failed"] = "failed";
+})(ICliApplyStatus || (exports.ICliApplyStatus = ICliApplyStatus = {}));
 /** Action */
 var IAction;
 (function (IAction) {
@@ -555,7 +574,7 @@ class Api extends HttpClient {
              */
             getKnowledgeById: (query, params = {}) => this.request(Object.assign({ path: `/api/knowledge/detail`, method: "GET", query: query, format: "json" }, params)),
             /**
-             * @description 删除知识 级联删除知识及其关联数据： - 删除 MySQL 中的知识记录和相关任务 - 删除向量数据库中的所有 chunk 数据 - 清除所属 Space 的总结时间标记（下次总结时将进行全量总结） Args: knowledge_id: 要删除的知识ID Raises: 404: 知识不存在
+             * @description 删除知识 如果删除的是 folder 类型，会自动级联删除所有子孙节点。 级联删除知识及其关联数据： - 删除 MySQL 中的知识记录和相关任务 - 删除向量数据库中的所有 chunk 数据 - 清除所属 Space 的总结时间标记（下次总结时将进行全量总结） Args: knowledge_id: 要删除的知识ID Raises: 404: 知识不存在
              *
              * @tags knowledge
              * @name DeleteKnowledge
@@ -617,6 +636,24 @@ class Api extends HttpClient {
              * @request POST:/api/knowledge/refresh/by_conditions
              */
             refreshKnowledgeByConditions: (data, params = {}) => this.request(Object.assign({ path: `/api/knowledge/refresh/by_conditions`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
+            /**
+             * @description 获取目录树结构 获取指定空间下的文件夹树形结构，返回嵌套的树形数据。 自动检测并处理循环引用。 Args: space_id: 空间ID root_id: 根节点ID，None 表示从空间根目录开始 Returns: 嵌套的树形结构，包含 items 列表
+             *
+             * @tags knowledge
+             * @name GetFolderTree
+             * @summary Get Folder Tree
+             * @request GET:/api/knowledge/folder/tree
+             */
+            getFolderTree: (query, params = {}) => this.request(Object.assign({ path: `/api/knowledge/folder/tree`, method: "GET", query: query, format: "json" }, params)),
+            /**
+             * @description 移动知识到指定文件夹下 将指定的知识批量移动到目标文件夹。如果目标文件夹不存在或不是文件夹类型， 将抛出异常。不支持将文件夹移动到自身或其子文件夹下。 Args: body.knowledge_ids: 要移动的知识ID列表 body.target_folder_id: 目标文件夹ID，None 表示移动到根目录 Returns: 成功时返回 None
+             *
+             * @tags knowledge
+             * @name MoveKnowledgeToFolder
+             * @summary Move Knowledge To Folder
+             * @request POST:/api/knowledge/folder/move
+             */
+            moveKnowledgeToFolder: (data, params = {}) => this.request(Object.assign({ path: `/api/knowledge/folder/move`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
         };
         this.knowledgeIndex = {
             /**
@@ -853,7 +890,7 @@ class Api extends HttpClient {
              */
             getTenantList: (query, params = {}) => this.request(Object.assign({ path: `/api/tenant/list`, method: "GET", query: query, format: "json" }, params)),
             /**
-             * @description 获取当前租户信息 通过请求头中的认证信息（secret_key）获取当前租户的详细信息。 无需传入任何参数，系统自动从认证上下文中识别租户身份。 Returns: 当前认证租户的详细信息（secret_key 字段已脱敏）
+             * @description 获取当前租户信息 Returns: 当前租户的详细信息（secret_key 字段已脱敏）
              *
              * @tags tenant
              * @name GetTenant
@@ -1566,7 +1603,7 @@ class Api extends HttpClient {
         };
         this.file = {
             /**
-             * @description 上传文件到 AFTS 存储 这是一个开放接口，无需权限校验。上传的文件会被存储到 AFTS（Ant File Transfer Service）。 文件路径生成规则： - 使用日期做分隔：{year}/{month}/{day}/ - 随机码作为路径层级：{random_code}/ - 文件名保持原样：{filename} - 最终格式：2026/03/01/abc123def456/image.png 设计意图： - 文件名保持原样，方便识别和管理 - 随机码作为路径层级，增加不可预测性 - 文件可读，但路径不可猜测 Args: file: 上传的文件 Returns: FileUploadResponse: 包含文件 ID、URL、路径等信息
+             * @description 上传文件到 AFTS 存储 需要 FILE 资源的 CREATE 权限。上传的文件会被存储到 AFTS（Ant File Transfer Service）。 文件路径生成规则： - tenant_id 作为根路径：{tenant_id}/ - 使用日期做分隔：{year}/{month}/{day}/ - 随机码作为路径层级：{random_code}/ - 文件名保持原样：{filename} - 最终格式：tenant_xxx/2026/03/01/abc123def456/image.png 设计意图： - tenant_id 追踪文件归属 - 文件名保持原样，方便识别和管理 - 随机码作为路径层级，增加不可预测性 - 文件可读，但路径不可猜测 Args: file: 上传的文件 Returns: FileUploadResponse: 包含文件 ID、URL、路径等信息
              *
              * @tags file
              * @name UploadFile
@@ -1575,6 +1612,35 @@ class Api extends HttpClient {
              */
             uploadFile: (data, params = {}) => this.request(Object.assign({ path: `/api/file/upload`, method: "POST", body: data, type: ContentType.FormData, format: "json" }, params)),
         };
+        this.cli = {
+            /**
+             * No description
+             *
+             * @tags cli_sync
+             * @name CliSyncSnapshot
+             * @summary Get Sync Snapshot
+             * @request GET:/api/cli/sync/snapshot
+             */
+            cliSyncSnapshot: (query, params = {}) => this.request(Object.assign({ path: `/api/cli/sync/snapshot`, method: "GET", query: query, format: "json" }, params)),
+            /**
+             * No description
+             *
+             * @tags cli_sync
+             * @name CliSyncMaterialize
+             * @summary Materialize Sync Knowledge
+             * @request POST:/api/cli/sync/materialize
+             */
+            cliSyncMaterialize: (data, params = {}) => this.request(Object.assign({ path: `/api/cli/sync/materialize`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
+            /**
+             * No description
+             *
+             * @tags cli_sync
+             * @name CliSyncApply
+             * @summary Apply Sync Changeset
+             * @request POST:/api/cli/sync/apply
+             */
+            cliSyncApply: (data, params = {}) => this.request(Object.assign({ path: `/api/cli/sync/apply`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
+        };
         this.healthChecker = {
             /**
              * No description

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@petercatai/whisker-client",
-    "version": "2.0.0",
+    "version": "3.0.0",
     "description": "Generated API client (Production)",
     "main": "dist/api.js",
     "types": "dist/api.d.ts",