@petercatai/whisker-client 5.0.202604071229 → 6.0.1

package/dist/api.d.ts

@@ -1091,6 +1091,100 @@ export interface IBatchQueryRequest {
     /** Knowledge Names */
     knowledge_names: string[];
 }
+/**
+ * BindMemoryConsolidationRequest
+ * 批量绑定记忆巩固 scheduler job 请求
+ *
+ * 调度配置字段与 SchedulerJobCreate 保持一致，
+ * job_type / target_type / target_id 由接口自动填充。
+ */
+export interface IBindMemoryConsolidationRequest {
+    /**
+     * Tenant Id Prefix
+     * 租户 ID 前缀，只对匹配的活跃租户绑定
+     * @default "personal"
+     */
+    tenant_id_prefix?: string;
+    /**
+     * Dry Run
+     * 预演模式：仅列出将被绑定的租户，不实际创建
+     * @default false
+     */
+    dry_run?: boolean;
+    /**
+     * Enabled
+     * 是否启用
+     * @default true
+     */
+    enabled?: boolean;
+    /** 调度类型：cron / interval */
+    interval_type: ISchedulerIntervalType;
+    /**
+     * Cron Expression
+     * Cron 表达式，interval_type=cron 时必填
+     */
+    cron_expression?: string | null;
+    /**
+     * Cron 时区
+     * @default "UTC"
+     */
+    cron_timezone?: ISchedulerCronTimezone;
+    /**
+     * Interval Seconds
+     * 间隔秒数，interval_type=interval 时必填
+     */
+    interval_seconds?: number | null;
+    /** Payload Ext */
+    payload_ext?: Record<string, any>;
+    /** Policy Ext */
+    policy_ext?: Record<string, any>;
+}
+/**
+ * BindMemoryConsolidationResponse
+ * 批量绑定记忆巩固 scheduler job 响应
+ */
+export interface IBindMemoryConsolidationResponse {
+    /** Tenant Id Prefix */
+    tenant_id_prefix: string;
+    /**
+     * Matched Count
+     * 匹配到的租户数量
+     */
+    matched_count: number;
+    /**
+     * Created Count
+     * @default 0
+     */
+    created_count?: number;
+    /**
+     * Updated Count
+     * @default 0
+     */
+    updated_count?: number;
+    /**
+     * Failed Count
+     * @default 0
+     */
+    failed_count?: number;
+    /**
+     * Dry Run
+     * @default false
+     */
+    dry_run?: boolean;
+    /** Details */
+    details?: IBindResultItem[];
+}
+/** BindResultItem */
+export interface IBindResultItem {
+    /** Tenant Id */
+    tenant_id: string;
+    /** Status */
+    status: "created" | "updated" | "failed";
+    /** Job Id */
+    job_id?: string | null;
+    /** Error */
+    error?: string | null;
+}
 /**
  * Blob
  * Raw data abstraction for document loading and file processing.
@@ -1499,6 +1593,63 @@ export interface IEnableStatusUpdate {
     /** Status */
     status: boolean;
 }
+/**
+ * FileUploadCreate
+ * 通过文件上传信息创建知识的简化 DTO。
+ *
+ * 系统根据 file_ext 自动推导 knowledge_type、source_type、source_config、split_config，
+ * 调用方无需了解内部配置细节。
+ */
+export interface IFileUploadCreate {
+    /**
+     * Space Id
+     * 空间 ID
+     */
+    space_id: string;
+    /**
+     * File Name
+     * 文件名（含扩展名），同时作为 knowledge_name
+     * @maxLength 255
+     */
+    file_name: string;
+    /**
+     * File Ext
+     * 文件扩展名（不含 '.'），如 pdf / md / xlsx
+     */
+    file_ext: string;
+    /**
+     * File Url
+     * 文件下载地址
+     */
+    file_url: string;
+    /**
+     * File Sha
+     * 文件 MD5 摘要
+     */
+    file_sha: string;
+    /**
+     * File Size
+     * 文件大小（字节）
+     * @min 0
+     */
+    file_size: number;
+    /**
+     * Embedding Model Name
+     * embedding 模型名
+     */
+    embedding_model_name: string;
+    /**
+     * Metadata
+     * 附加元数据
+     * @default {}
+     */
+    metadata?: Record<string, any>;
+    /**
+     * Parent Id
+     * 父级知识 ID
+     */
+    parent_id?: string | null;
+}
 /**
  * FileUploadResponse
  * 文件上传响应
@@ -2178,10 +2329,11 @@ export interface IKnowledgeInput {
      */
     tenant_id: string;
     /**
+     * Knowledge Type
      * type of knowledge resource
      * @default "text"
      */
-    knowledge_type?: IKnowledgeTypeEnum;
+    knowledge_type?: IKnowledgeTypeEnum | string;
     /**
      * Knowledge Name
      * name of the knowledge resource
@@ -2207,7 +2359,7 @@ export interface IKnowledgeInput {
      * Split Config
      * configuration for splitting the knowledge
      */
-    split_config: IMarkdownSplitConfig | ITextSplitConfig | IJSONSplitConfig | IYuqueSplitConfig | IGeaGraphSplitConfig | IGithubRepoParseConfig | IBaseCodeSplitConfig | IImageSplitConfig | INodePackageParseConfig | IMemorySplitConfig | IFolderSplitConfig | IBaseCharSplitConfig;
+    split_config: IMarkdownSplitConfig | ITextSplitConfig | IJSONSplitConfig | IYuqueSplitConfig | IGeaGraphSplitConfig | IGithubRepoParseConfig | IBaseCodeSplitConfig | IImageSplitConfig | INodePackageParseConfig | IMemorySplitConfig | IFolderSplitConfig | IBaseCharSplitConfig | Record<string, any>;
     /**
      * File Sha
      * SHA of the file
@@ -2279,7 +2431,10 @@ export interface IKnowledgeOutput {
      * tenant id
      */
     tenant_id: string;
-    /** type of knowledge resource */
+    /**
+     * Knowledge Type
+     * type of knowledge resource
+     */
     knowledge_type?: string;
     /**
      * Knowledge Name
@@ -2303,7 +2458,7 @@ export interface IKnowledgeOutput {
      * Split Config
      * configuration for splitting the knowledge
      */
-    split_config: IMarkdownSplitConfig | ITextSplitConfig | IJSONSplitConfig | IYuqueSplitConfig | IGeaGraphSplitConfig | IGithubRepoParseConfig | IBaseCodeSplitConfig | IImageSplitConfig | INodePackageParseConfig | IMemorySplitConfig | IFolderSplitConfig | IBaseCharSplitConfig;
+    split_config: IMarkdownSplitConfig | ITextSplitConfig | IJSONSplitConfig | IYuqueSplitConfig | IGeaGraphSplitConfig | IGithubRepoParseConfig | IBaseCodeSplitConfig | IImageSplitConfig | INodePackageParseConfig | IMemorySplitConfig | IFolderSplitConfig | IBaseCharSplitConfig | Record<string, any>;
     /**
      * File Sha
      * SHA of the file
@@ -2541,7 +2696,10 @@ export interface IKnowledgeResponse {
      * tenant id
      */
     tenant_id: string;
-    /** type of knowledge resource */
+    /**
+     * Knowledge Type
+     * type of knowledge resource
+     */
     knowledge_type?: string;
     /**
      * Knowledge Name
@@ -2565,7 +2723,7 @@ export interface IKnowledgeResponse {
      * Split Config
      * configuration for splitting the knowledge
      */
-    split_config: IMarkdownSplitConfig | ITextSplitConfig | IJSONSplitConfig | IYuqueSplitConfig | IGeaGraphSplitConfig | IGithubRepoParseConfig | IBaseCodeSplitConfig | IImageSplitConfig | INodePackageParseConfig | IMemorySplitConfig | IFolderSplitConfig | IBaseCharSplitConfig;
+    split_config: IMarkdownSplitConfig | ITextSplitConfig | IJSONSplitConfig | IYuqueSplitConfig | IGeaGraphSplitConfig | IGithubRepoParseConfig | IBaseCodeSplitConfig | IImageSplitConfig | INodePackageParseConfig | IMemorySplitConfig | IFolderSplitConfig | IBaseCharSplitConfig | Record<string, any>;
     /**
      * File Sha
      * SHA of the file
@@ -2651,19 +2809,6 @@ export interface ILongTermMemoryCreate {
      * @default []
      */
     tags?: string[];
-    /**
-     * Confidence
-     * Memory confidence (0-1) for dedup and merge decisions
-     * @min 0
-     * @max 1
-     * @default 1
-     */
-    confidence?: number;
-    /**
-     * Expires At
-     * Expiration time (UTC), None means never expires
-     */
-    expires_at?: string | null;
     /**
      * Metadata
      * Additional metadata following MemoryKnowledgeMetadata constraints
@@ -2677,6 +2822,11 @@ export interface ILongTermMemoryCreate {
     embedding_model_name?: string | null;
     /** Target cortex region for long-term memory storage */
     cortex_region: IMemoryCortexEnum;
+    /**
+     * Expires At
+     * Expiration time (UTC), None means never expires
+     */
+    expires_at?: string | null;
 }
 /** MarkdownCreate */
 export interface IMarkdownCreate {
@@ -4183,6 +4333,14 @@ export interface IResponseModelArtifactIndex {
     /** Message */
     message?: string | null;
 }
+/** ResponseModel[BindMemoryConsolidationResponse] */
+export interface IResponseModelBindMemoryConsolidationResponse {
+    /** Success */
+    success: boolean;
+    data?: IBindMemoryConsolidationResponse | null;
+    /** Message */
+    message?: string | null;
+}
 /** ResponseModel[Chunk] */
 export interface IResponseModelChunk {
     /** Success */
@@ -6287,19 +6445,6 @@ export interface IWorkingMemoryCreate {
      * @default []
      */
     tags?: string[];
-    /**
-     * Confidence
-     * Memory confidence (0-1) for dedup and merge decisions
-     * @min 0
-     * @max 1
-     * @default 1
-     */
-    confidence?: number;
-    /**
-     * Expires At
-     * Expiration time (UTC), None means never expires
-     */
-    expires_at?: string | null;
     /**
      * Metadata
      * Additional metadata following MemoryKnowledgeMetadata constraints
@@ -6572,6 +6717,15 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @request POST:/api/knowledge/add
          */
         addKnowledge: (data: (ITextCreate | IImageCreate | IJSONCreate | IMarkdownCreate | IPDFCreate | IDocxCreate | IPowerPointCreate | IWebpageCreate | IGithubRepoCreate | IQACreate | IYuqueCreate | IHituNodePackageCreate | IHituNodePackageElementCreate | IFolderCreate)[], params?: RequestParams) => Promise<HttpResponse<IResponseModelListKnowledge, void | IHTTPValidationError>>;
+        /**
+         * @description 通过文件信息批量添加知识（简化接口） 仅需提供文件基础信息（名称、扩展名、URL、MD5、大小），系统根据扩展名自动推导 knowledge_type、source_type、source_config、split_config 等配置。 - 扩展名可映射到已知类型（md/txt/json/image/docx/pdf/pptx 等）：自动组装配置并创建处理任务 - 扩展名不可映射：以扩展名原值作为 knowledge_type 存储，不创建处理任务
+         *
+         * @tags knowledge
+         * @name AddKnowledgeByFile
+         * @summary Add Knowledge By File
+         * @request POST:/api/knowledge/add_by_file
+         */
+        addKnowledgeByFile: (data: IFileUploadCreate[], params?: RequestParams) => Promise<HttpResponse<IResponseModelListKnowledge, void | IHTTPValidationError>>;
         /**
          * @description 更新知识（全量更新） 更新知识的完整信息，支持以下字段变更： - 元数据(metadata)变更：同步更新对应 chunk 的 metadata - 启用状态(enabled)变更：同步更新对应 chunk 的启用状态 - 嵌入模型/分片配置/来源配置变更：自动触发重新入库任务 注意：knowledge_type、source_type 等核心字段不可变更。 Args: knowledge: 完整的知识对象，需包含 knowledge_id Returns: 更新后的知识对象（auth_info 字段已脱敏）
          *
@@ -6933,7 +7087,7 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          */
         checkTenantName: (data: ITenantNameCheckRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelTenantNameCheckResponse, void | IHTTPValidationError>>;
         /**
-         * @description 创建租户 创建新租户并自动生成认证密钥（secret_key）： - tenant_id 可自定义或由系统自动生成 - secret_key 由系统自动生成，仅在创建时返回一次 - 创建成功后根据 notify 参数决定是否发送通知邮件 - 如果 metadata.default_space_id 存在，则自动创建默认空间 Args: params.tenant_name: 租户名称，必须唯一 params.email: 联系邮箱，用于接收通知 params.metadata: 自定义元数据（可选），可包含 default_space_id params.notify: 是否发送邮件通知，默认 true params.default_spaces_config: 默认知识库配置（可选） params.tenant_id: 自定义租户ID（可选），支持字母、数字、下划线、中划线 Returns: 创建的租户信息，包含 secret_key（仅此一次） Raises: 400: 租户名称或ID已存在
+         * @description 创建租户 创建新租户并自动生成认证密钥（secret_key）： - tenant_id 可自定义或由系统自动生成 - secret_key 由系统自动生成，仅在创建时返回一次 - 创建成功后根据 notify 参数决定是否发送通知邮件 - 如果 metadata.default_space_id 存在，则自动创建默认空间 Args: params.tenant_name: 租户名称，必须唯一 params.email: 联系邮箱，用于接收通知 params.metadata: 自定义元数据（可选），可包含 default_space_id params.notify: 是否发送邮件通知，默认 true params.default_spaces_config: 默认知识库配置（可选） params.tenant_id: 自定义租户ID（可选），支持字母、数字、下划线、中划线 Returns: 创建的租户信息，包含 secret_key（仅此一次） Raises: 400: 租户名称或ID已存在 403: 无权使用 personal_ 前缀的自定义租户ID
          *
          * @tags tenant
          * @name CreateTenant
@@ -7563,6 +7717,15 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @request POST:/api/admin/scheduler/manage
          */
         adminManageSchedulerByFilter: (data: IAdminManageSchedulerRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelAdminManageSchedulerResponse, void | IHTTPValidationError>>;
+        /**
+         * @description 批量为指定前缀的租户绑定记忆巩固 scheduler job。 对每个匹配的活跃租户，使用 upsert 语义创建或更新 job_type=memory_consolidation / target_type=space / target_id=mem_hippocampus 的定时任务。
+         *
+         * @tags admin
+         * @name AdminBindMemoryConsolidationJobs
+         * @summary Admin Bind Memory Consolidation Jobs
+         * @request POST:/api/admin/scheduler/bind-memory-consolidation
+         */
+        adminBindMemoryConsolidationJobs: (data: IBindMemoryConsolidationRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelBindMemoryConsolidationResponse, void | IHTTPValidationError>>;
         /**
          * @description 管理员接口：校验 tenant 下 chunk 与 knowledge 的存在一致性。 使用 ES 聚合（composite terms）获取 distinct knowledge_id 集合； 以 DB 校验知识是否存在；对缺失 knowledge_id 对应 chunk 做物理删除。
          *

package/dist/api.js

@@ -556,6 +556,15 @@ class Api extends HttpClient {
              * @request POST:/api/knowledge/add
              */
             addKnowledge: (data, params = {}) => this.request(Object.assign({ path: `/api/knowledge/add`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
+            /**
+             * @description 通过文件信息批量添加知识（简化接口） 仅需提供文件基础信息（名称、扩展名、URL、MD5、大小），系统根据扩展名自动推导 knowledge_type、source_type、source_config、split_config 等配置。 - 扩展名可映射到已知类型（md/txt/json/image/docx/pdf/pptx 等）：自动组装配置并创建处理任务 - 扩展名不可映射：以扩展名原值作为 knowledge_type 存储，不创建处理任务
+             *
+             * @tags knowledge
+             * @name AddKnowledgeByFile
+             * @summary Add Knowledge By File
+             * @request POST:/api/knowledge/add_by_file
+             */
+            addKnowledgeByFile: (data, params = {}) => this.request(Object.assign({ path: `/api/knowledge/add_by_file`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
             /**
              * @description 更新知识（全量更新） 更新知识的完整信息，支持以下字段变更： - 元数据(metadata)变更：同步更新对应 chunk 的 metadata - 启用状态(enabled)变更：同步更新对应 chunk 的启用状态 - 嵌入模型/分片配置/来源配置变更：自动触发重新入库任务 注意：knowledge_type、source_type 等核心字段不可变更。 Args: knowledge: 完整的知识对象，需包含 knowledge_id Returns: 更新后的知识对象（auth_info 字段已脱敏）
              *
@@ -891,7 +900,7 @@ class Api extends HttpClient {
              */
             checkTenantName: (data, params = {}) => this.request(Object.assign({ path: `/api/tenant/check-name`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
             /**
-             * @description 创建租户 创建新租户并自动生成认证密钥（secret_key）： - tenant_id 可自定义或由系统自动生成 - secret_key 由系统自动生成，仅在创建时返回一次 - 创建成功后根据 notify 参数决定是否发送通知邮件 - 如果 metadata.default_space_id 存在，则自动创建默认空间 Args: params.tenant_name: 租户名称，必须唯一 params.email: 联系邮箱，用于接收通知 params.metadata: 自定义元数据（可选），可包含 default_space_id params.notify: 是否发送邮件通知，默认 true params.default_spaces_config: 默认知识库配置（可选） params.tenant_id: 自定义租户ID（可选），支持字母、数字、下划线、中划线 Returns: 创建的租户信息，包含 secret_key（仅此一次） Raises: 400: 租户名称或ID已存在
+             * @description 创建租户 创建新租户并自动生成认证密钥（secret_key）： - tenant_id 可自定义或由系统自动生成 - secret_key 由系统自动生成，仅在创建时返回一次 - 创建成功后根据 notify 参数决定是否发送通知邮件 - 如果 metadata.default_space_id 存在，则自动创建默认空间 Args: params.tenant_name: 租户名称，必须唯一 params.email: 联系邮箱，用于接收通知 params.metadata: 自定义元数据（可选），可包含 default_space_id params.notify: 是否发送邮件通知，默认 true params.default_spaces_config: 默认知识库配置（可选） params.tenant_id: 自定义租户ID（可选），支持字母、数字、下划线、中划线 Returns: 创建的租户信息，包含 secret_key（仅此一次） Raises: 400: 租户名称或ID已存在 403: 无权使用 personal_ 前缀的自定义租户ID
              *
              * @tags tenant
              * @name CreateTenant
@@ -1478,6 +1487,15 @@ class Api extends HttpClient {
              * @request POST:/api/admin/scheduler/manage
              */
             adminManageSchedulerByFilter: (data, params = {}) => this.request(Object.assign({ path: `/api/admin/scheduler/manage`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
+            /**
+             * @description 批量为指定前缀的租户绑定记忆巩固 scheduler job。 对每个匹配的活跃租户，使用 upsert 语义创建或更新 job_type=memory_consolidation / target_type=space / target_id=mem_hippocampus 的定时任务。
+             *
+             * @tags admin
+             * @name AdminBindMemoryConsolidationJobs
+             * @summary Admin Bind Memory Consolidation Jobs
+             * @request POST:/api/admin/scheduler/bind-memory-consolidation
+             */
+            adminBindMemoryConsolidationJobs: (data, params = {}) => this.request(Object.assign({ path: `/api/admin/scheduler/bind-memory-consolidation`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
             /**
              * @description 管理员接口：校验 tenant 下 chunk 与 knowledge 的存在一致性。 使用 ES 聚合（composite terms）获取 distinct knowledge_id 集合； 以 DB 校验知识是否存在；对缺失 knowledge_id 对应 chunk 做物理删除。
              *

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@petercatai/whisker-client",
-    "version": "5.0.202604071229",
+    "version": "6.0.1",
     "description": "Generated API client (Production)",
     "main": "dist/api.js",
     "types": "dist/api.d.ts",
@@ -17,7 +17,7 @@
     },
     "devDependencies": {
         "@types/node": "^25.5.2",
-        "axios": "^1.14.0",
+        "axios": "^1.15.0",
         "typescript": "^6.0.2"
     }
 }