@petercatai/whisker-client 6.0.1 → 6.0.202606061614

package/dist/api.d.ts

@@ -163,14 +163,6 @@ export declare enum IOperator {
     And = "and",
     Or = "or"
 }
-/**
- * MemoryTypeEnum
- * Memory lifecycle type
- */
-export declare enum IMemoryTypeEnum {
-    MemoryWorking = "memory_working",
-    MemoryLongTerm = "memory_long_term"
-}
 /**
  * MemoryStatusEnum
  * Memory status enumeration
@@ -680,6 +672,60 @@ export interface IAdminRebuildKnowledgeIndexResponse {
      */
     details?: Record<string, any>[];
 }
+/**
+ * AdminRunSchedulerNowRequest
+ * 管理员强制立即执行某个 scheduler job 请求
+ */
+export interface IAdminRunSchedulerNowRequest {
+    /**
+     * Tenant Id
+     * 租户ID
+     */
+    tenant_id: string;
+    /**
+     * Job Id
+     * job_id；提供时直接执行该 job，忽略筛选条件
+     */
+    job_id?: string | null;
+    /**
+     * Eq Conditions
+     * 等值筛选条件（未提供 job_id 时用于唯一定位 job），如 {'job_type': 'knowledge_refresh', 'target_id': '<space_id>'}
+     */
+    eq_conditions?: Record<string, any> | null;
+    /** 高级筛选条件（未提供 job_id 时使用） */
+    advanced_filter?: IFilterGroup | null;
+}
+/**
+ * AdminRunSchedulerNowResponse
+ * 管理员强制执行 scheduler job 响应
+ */
+export interface IAdminRunSchedulerNowResponse {
+    /**
+     * Tenant Id
+     * 租户ID
+     */
+    tenant_id: string;
+    /**
+     * Job Id
+     * 被执行的 job_id
+     */
+    job_id: string;
+    /**
+     * Status
+     * 执行结果：success / skipped / failed
+     */
+    status: string;
+    /**
+     * Message
+     * 执行信息/错误信息
+     */
+    message?: string | null;
+    /**
+     * Detail
+     * 执行明细（如各知识的刷新结果）
+     */
+    detail?: Record<string, any> | null;
+}
 /**
  * AdminSyncSummaryToStorageRequest
  * 管理员同步 space summary 到自持 tenant 请求
@@ -798,6 +844,14 @@ export interface IAdminTaskRestartResponse {
      */
     task_ids?: string[];
 }
+/** AdminTenantRequest */
+export interface IAdminTenantRequest {
+    /**
+     * Tenant Id
+     * Target tenant ID
+     */
+    tenant_id: string;
+}
 /**
  * AdminUpdateSpaceRequest
  * 管理员更新空间信息请求
@@ -1614,9 +1668,10 @@ export interface IFileUploadCreate {
     file_name: string;
     /**
      * File Ext
-     * 文件扩展名（不含 '.'），如 pdf / md / xlsx
+     * 文件扩展名（不含 '.'），如 pdf / md / xlsx。留空表示未知类型，系统只存储不处理。
+     * @default ""
      */
-    file_ext: string;
+    file_ext?: string;
     /**
      * File Url
      * 文件下载地址
@@ -2953,8 +3008,6 @@ export interface IMemory {
      * Memory content
      */
     content: string;
-    /** Memory lifecycle type */
-    memory_type: IMemoryTypeEnum;
     /** Brain cortex region this memory resides in */
     cortex_region: IMemoryCortexEnum;
     /**
@@ -2972,10 +3025,9 @@ export interface IMemory {
     tags?: string[];
     /**
      * Confidence
-     * Confidence score
-     * @default 1
+     * Confidence score, None means not yet evaluated
      */
-    confidence?: number;
+    confidence?: number | null;
     /**
      * Retrieval Count
      * Retrieval count
@@ -3027,6 +3079,36 @@ export interface IMemoryConsolidateResponse {
      */
     consolidated_count: number;
 }
+/**
+ * MemoryForgetResult
+ * Memory forgetting result DTO
+ */
+export interface IMemoryForgetResult {
+    /**
+     * Total Scanned
+     * Memories scanned (expiring or uninitialized)
+     * @default 0
+     */
+    total_scanned?: number;
+    /**
+     * Forgotten Count
+     * Memories deleted by low retention score
+     * @default 0
+     */
+    forgotten_count?: number;
+    /**
+     * Renewed Count
+     * Memories renewed with extended expires_at
+     * @default 0
+     */
+    renewed_count?: number;
+    /**
+     * Total Deleted
+     * Total memories deleted
+     * @default 0
+     */
+    total_deleted?: number;
+}
 /**
  * MemoryRecord
  * Retrieved memory record
@@ -3044,8 +3126,6 @@ export interface IMemoryRecord {
      * Memory content
      */
     content: string;
-    /** Memory type */
-    memory_type: IMemoryTypeEnum;
     /**
      * Similarity
      * Semantic similarity with query (0-1)
@@ -3067,10 +3147,9 @@ export interface IMemoryRecord {
     tags?: string[];
     /**
      * Confidence
-     * Confidence
-     * @default 1
+     * Confidence, None means not yet evaluated
      */
-    confidence?: number;
+    confidence?: number | null;
     /**
      * Retrieval Count
      * Historical retrieval count
@@ -3099,11 +3178,6 @@ export interface IMemoryRetrievalConfig {
      * Cortex regions to search. None means search all regions.
      */
     cortex_regions?: IMemoryCortexEnum[] | null;
-    /**
-     * Memory Types
-     * Specify memory types, None means retrieve all types
-     */
-    memory_types?: IMemoryTypeEnum[] | null;
     /**
      * Include Working Memory
      * Whether to include working memory from hippocampus
@@ -3143,6 +3217,11 @@ export interface IMemoryRetrievalConfig {
      * @default "jina_v3"
      */
     embedding_model_name?: string | null;
+    /**
+     * Session Id
+     * Current session ID, working memories from this session will be excluded
+     */
+    session_id?: string | null;
     [key: string]: any;
 }
 /**
@@ -3171,18 +3250,6 @@ export interface IMemoryRetrievalResponse {
      * @default []
      */
     memories?: IMemoryRecord[];
-    /**
-     * Working Memory Count
-     * Count from working memory
-     * @default 0
-     */
-    working_memory_count?: number;
-    /**
-     * Long Term Memory Count
-     * Count from long-term memory
-     * @default 0
-     */
-    long_term_memory_count?: number;
     /**
      * Total Count
      * Total retrieval count
@@ -3231,6 +3298,20 @@ export interface IMemorySplitConfig {
      */
     type?: "memory";
 }
+/**
+ * MetadataUpdate
+ * 仅更新 metadata 的请求体。
+ *
+ * metadata_updates 中的 key 会按 dict.update 语义合并进既有 metadata（同名 key 整体替换、
+ * 未提供的 key 保持不变）。不触发 source 解析 / file_sha 重算 / 重新切分，
+ * 也不做 split_config × knowledge_type 兼容校验，适用于 AI 标注、关联（_xiaohu_links）等场景。
+ */
+export interface IMetadataUpdate {
+    /** Knowledge Id */
+    knowledge_id: string;
+    /** Metadata Updates */
+    metadata_updates?: Record<string, any>;
+}
 /**
  * MoveKnowledgeRequest
  * 移动知识请求
@@ -4276,6 +4357,14 @@ export interface IResponseModelAdminRebuildKnowledgeIndexResponse {
     /** Message */
     message?: string | null;
 }
+/** ResponseModel[AdminRunSchedulerNowResponse] */
+export interface IResponseModelAdminRunSchedulerNowResponse {
+    /** Success */
+    success: boolean;
+    data?: IAdminRunSchedulerNowResponse | null;
+    /** Message */
+    message?: string | null;
+}
 /** ResponseModel[AdminSyncSummaryToStorageResponse] */
 export interface IResponseModelAdminSyncSummaryToStorageResponse {
     /** Success */
@@ -4565,6 +4654,14 @@ export interface IResponseModelMemoryConsolidateResponse {
     /** Message */
     message?: string | null;
 }
+/** ResponseModel[MemoryForgetResult] */
+export interface IResponseModelMemoryForgetResult {
+    /** Success */
+    success: boolean;
+    data?: IMemoryForgetResult | null;
+    /** Message */
+    message?: string | null;
+}
 /** ResponseModel[MemoryRetrievalResponse] */
 export interface IResponseModelMemoryRetrievalResponse {
     /** Success */
@@ -5696,13 +5793,13 @@ export interface ITaggingCreate {
      */
     tag_name: string;
     /**
-     * 对象类型，当前仅支持 "space"
+     * 对象类型：space 或 knowledge
      * @default "space"
      */
     object_type?: ITagObjectType;
     /**
      * Object Id
-     * 被打标签对象ID（如 space_id）
+     * 被打标签对象ID（space_id 或 knowledge_id）
      * @maxLength 255
      */
     object_id: string;
@@ -6425,8 +6522,8 @@ export interface IWohuSpaceMemberGrant {
  * WorkingMemoryCreate
  * Create working memory request DTO
  *
- * Working memory is always written to hippocampus and always uses
- * `memory_working`. Callers cannot override those invariants.
+ * Working memory is always written to hippocampus.
+ * Callers cannot override this invariant.
  */
 export interface IWorkingMemoryCreate {
     /**
@@ -6771,6 +6868,15 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @request POST:/api/knowledge/update/filter_fields
          */
         updateKnowledgeFilterFields: (data: IFilterFieldsUpdate, params?: RequestParams) => Promise<HttpResponse<IResponseModelKnowledge, void | IHTTPValidationError>>;
+        /**
+         * @description 仅更新知识的 metadata 字段 将 body.metadata_updates 按 dict.update 语义合并进既有 metadata（同名 key 整体替换、 未提供的 key 保持不变）。与全量 /update 不同：不触发 source 解析 / file_sha 重算 / 重新切分，也不做 split_config × knowledge_type 兼容校验，避免「仅改 metadata 却被历史 不兼容的 split_config（如 html + markdown）拒绝」。适用于 AI 标注、双向关联（_xiaohu_links）等场景。 Args: body.knowledge_id: 知识ID body.metadata_updates: 要合并写入的 metadata 键值 Returns: 更新后的知识对象（auth_info 字段已脱敏）
+         *
+         * @tags knowledge
+         * @name UpdateKnowledgeMetadata
+         * @summary Update Knowledge Metadata
+         * @request POST:/api/knowledge/update/metadata
+         */
+        updateKnowledgeMetadata: (data: IMetadataUpdate, params?: RequestParams) => Promise<HttpResponse<IResponseModelKnowledge, void | IHTTPValidationError>>;
         /**
          * @description 分页查询知识列表 支持灵活的查询条件： - eq_conditions: 等值查询条件，如 {"space_id": "xxx", "enabled": true} - advanced_filter: 高级过滤条件，支持 AND/OR 组合及多种比较操作符 - order_by/order_direction: 排序字段和方向 Args: body: 分页查询参数，包含 page、page_size 和过滤条件 Returns: 分页结果，包含 items、total、page、page_size、total_pages
          *
@@ -7717,6 +7823,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（在当前 API 进程内同步执行）。 - 不要求 job 处于 due 状态，不影响常规调度节奏，会落一条运行历史。 - 当定时调度所在 FaaS 环境网络受限时，在此执行可绕过该限制并直接看到结果。 - 未提供 job_id 时，按筛选条件唯一定位 job（匹配到多个会报错）。
+         *
+         * @tags admin
+         * @name AdminRunSchedulerNow
+         * @summary Admin Run Scheduler Now
+         * @request POST:/api/admin/scheduler/run-now
+         */
+        adminRunSchedulerNow: (data: IAdminRunSchedulerNowRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelAdminRunSchedulerNowResponse, void | IHTTPValidationError>>;
         /**
          * @description 批量为指定前缀的租户绑定记忆巩固 scheduler job。 对每个匹配的活跃租户，使用 upsert 语义创建或更新 job_type=memory_consolidation / target_type=space / target_id=mem_hippocampus 的定时任务。
          *
@@ -7726,6 +7841,24 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
          * @request POST:/api/admin/scheduler/bind-memory-consolidation
          */
         adminBindMemoryConsolidationJobs: (data: IBindMemoryConsolidationRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelBindMemoryConsolidationResponse, void | IHTTPValidationError>>;
+        /**
+         * @description Admin: immediately trigger memory consolidation for a specific tenant.
+         *
+         * @tags admin
+         * @name AdminTriggerMemoryConsolidation
+         * @summary Admin Trigger Memory Consolidation
+         * @request POST:/api/admin/memory/consolidate
+         */
+        adminTriggerMemoryConsolidation: (data: IAdminTenantRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelMemoryConsolidateResponse, void | IHTTPValidationError>>;
+        /**
+         * @description Admin: scan long-term memories and forget stale ones by retention score.
+         *
+         * @tags admin
+         * @name AdminTriggerMemoryForget
+         * @summary Admin Trigger Memory Forget
+         * @request POST:/api/admin/memory/forget
+         */
+        adminTriggerMemoryForget: (data: IAdminTenantRequest, params?: RequestParams) => Promise<HttpResponse<IResponseModelMemoryForgetResult, void | IHTTPValidationError>>;
         /**
          * @description 管理员接口：校验 tenant 下 chunk 与 knowledge 的存在一致性。 使用 ES 聚合（composite terms）获取 distinct knowledge_id 集合； 以 DB 校验知识是否存在；对缺失 knowledge_id 对应 chunk 做物理删除。
          *

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.ICliApplyStatus = exports.ICliChangeOp = exports.IKnowledgeSourceEnum = exports.IKnowledgeTypeEnum = exports.ILanguage = exports.IMemoryCortexEnum = exports.IMemoryInputTypeEnum = exports.IMemoryStatusEnum = exports.IMemoryTypeEnum = exports.IOperator = exports.IPublicEndpointId = 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 = exports.IWohuSpaceRole = void 0;
+exports.Api = exports.HttpClient = exports.ContentType = exports.IAction = exports.ICliApplyStatus = exports.ICliChangeOp = exports.IKnowledgeSourceEnum = exports.IKnowledgeTypeEnum = exports.ILanguage = exports.IMemoryCortexEnum = exports.IMemoryInputTypeEnum = exports.IMemoryStatusEnum = exports.IOperator = exports.IPublicEndpointId = 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 = exports.IWohuSpaceRole = void 0;
 /** WohuSpaceRole */
 var IWohuSpaceRole;
 (function (IWohuSpaceRole) {
@@ -205,15 +205,6 @@ var IOperator;
     IOperator["And"] = "and";
     IOperator["Or"] = "or";
 })(IOperator || (exports.IOperator = IOperator = {}));
-/**
- * MemoryTypeEnum
- * Memory lifecycle type
- */
-var IMemoryTypeEnum;
-(function (IMemoryTypeEnum) {
-    IMemoryTypeEnum["MemoryWorking"] = "memory_working";
-    IMemoryTypeEnum["MemoryLongTerm"] = "memory_long_term";
-})(IMemoryTypeEnum || (exports.IMemoryTypeEnum = IMemoryTypeEnum = {}));
 /**
  * MemoryStatusEnum
  * Memory status enumeration
@@ -610,6 +601,15 @@ class Api extends HttpClient {
              * @request POST:/api/knowledge/update/filter_fields
              */
             updateKnowledgeFilterFields: (data, params = {}) => this.request(Object.assign({ path: `/api/knowledge/update/filter_fields`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
+            /**
+             * @description 仅更新知识的 metadata 字段 将 body.metadata_updates 按 dict.update 语义合并进既有 metadata（同名 key 整体替换、 未提供的 key 保持不变）。与全量 /update 不同：不触发 source 解析 / file_sha 重算 / 重新切分，也不做 split_config × knowledge_type 兼容校验，避免「仅改 metadata 却被历史 不兼容的 split_config（如 html + markdown）拒绝」。适用于 AI 标注、双向关联（_xiaohu_links）等场景。 Args: body.knowledge_id: 知识ID body.metadata_updates: 要合并写入的 metadata 键值 Returns: 更新后的知识对象（auth_info 字段已脱敏）
+             *
+             * @tags knowledge
+             * @name UpdateKnowledgeMetadata
+             * @summary Update Knowledge Metadata
+             * @request POST:/api/knowledge/update/metadata
+             */
+            updateKnowledgeMetadata: (data, params = {}) => this.request(Object.assign({ path: `/api/knowledge/update/metadata`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
             /**
              * @description 分页查询知识列表 支持灵活的查询条件： - eq_conditions: 等值查询条件，如 {"space_id": "xxx", "enabled": true} - advanced_filter: 高级过滤条件，支持 AND/OR 组合及多种比较操作符 - order_by/order_direction: 排序字段和方向 Args: body: 分页查询参数，包含 page、page_size 和过滤条件 Returns: 分页结果，包含 items、total、page、page_size、total_pages
              *
@@ -1487,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（在当前 API 进程内同步执行）。 - 不要求 job 处于 due 状态，不影响常规调度节奏，会落一条运行历史。 - 当定时调度所在 FaaS 环境网络受限时，在此执行可绕过该限制并直接看到结果。 - 未提供 job_id 时，按筛选条件唯一定位 job（匹配到多个会报错）。
+             *
+             * @tags admin
+             * @name AdminRunSchedulerNow
+             * @summary Admin Run Scheduler Now
+             * @request POST:/api/admin/scheduler/run-now
+             */
+            adminRunSchedulerNow: (data, params = {}) => this.request(Object.assign({ path: `/api/admin/scheduler/run-now`, 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 的定时任务。
              *
@@ -1496,6 +1505,24 @@ class Api extends HttpClient {
              * @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 Admin: immediately trigger memory consolidation for a specific tenant.
+             *
+             * @tags admin
+             * @name AdminTriggerMemoryConsolidation
+             * @summary Admin Trigger Memory Consolidation
+             * @request POST:/api/admin/memory/consolidate
+             */
+            adminTriggerMemoryConsolidation: (data, params = {}) => this.request(Object.assign({ path: `/api/admin/memory/consolidate`, method: "POST", body: data, type: ContentType.Json, format: "json" }, params)),
+            /**
+             * @description Admin: scan long-term memories and forget stale ones by retention score.
+             *
+             * @tags admin
+             * @name AdminTriggerMemoryForget
+             * @summary Admin Trigger Memory Forget
+             * @request POST:/api/admin/memory/forget
+             */
+            adminTriggerMemoryForget: (data, params = {}) => this.request(Object.assign({ path: `/api/admin/memory/forget`, 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": "6.0.1",
+    "version": "6.0.202606061614",
     "description": "Generated API client (Production)",
     "main": "dist/api.js",
     "types": "dist/api.d.ts",
@@ -16,8 +16,8 @@
         "tag": "latest"
     },
     "devDependencies": {
-        "@types/node": "^25.5.2",
-        "axios": "^1.15.0",
-        "typescript": "^6.0.2"
+        "@types/node": "^25.9.2",
+        "axios": "^1.17.0",
+        "typescript": "^6.0.3"
     }
 }