acp-ts 1.2.3 → 1.2.4

package/dist/group/message_store.js

@@ -11,13 +11,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GroupMessageStore = void 0;
 const websocket_1 = require("../websocket");
+const utils_1 = require("../utils");
 class GroupMessageStore {
     constructor(options) {
         var _a, _b;
         this.ownerAid = '';
         this.groups = new Map();
         this._indexDirty = false;
-        this._flushIndexPromise = null;
         this.persistMessages = options.persistMessages;
         this.basePath = options.basePath;
         this.maxMessagesPerGroup = (_a = options.maxMessagesPerGroup) !== null && _a !== void 0 ? _a : 5000;
@@ -44,12 +44,12 @@ class GroupMessageStore {
         const path = require('path');
         return path.join(this.getGroupDir(aid, groupId), 'events.jsonl');
     }
-    async ensureDir(dir) {
+    ensureDir(dir) {
         if (!websocket_1.isNodeEnvironment)
             return;
         const fs = require('fs');
         if (!fs.existsSync(dir)) {
-            await fs.promises.mkdir(dir, { recursive: true });
+            fs.mkdirSync(dir, { recursive: true });
         }
     }
     // ---- load ----
@@ -64,45 +64,41 @@ class GroupMessageStore {
         if (!fs.existsSync(indexPath))
             return;
         try {
-            const raw = await fs.promises.readFile(indexPath, 'utf-8');
+            const raw = fs.readFileSync(indexPath, 'utf-8');
             const records = JSON.parse(raw);
             if (!Array.isArray(records))
                 return;
             for (const r of records) {
-                const messages = await this.readJsonl(this.getMessagesPath(ownerAid, r.groupId));
-                const events = await this.readJsonl(this.getEventsPath(ownerAid, r.groupId));
+                const messages = this.readJsonl(this.getMessagesPath(ownerAid, r.groupId));
+                const events = this.readJsonl(this.getEventsPath(ownerAid, r.groupId));
                 this.groups.set(r.groupId, { record: r, messages, events });
             }
         }
         catch (e) {
-            console.error('[GroupMessageStore] 加载索引失败:', e);
+            utils_1.logger.error('[GroupMessageStore] 加载索引失败:', e);
         }
     }
-    async readJsonl(filePath) {
+    readJsonl(filePath) {
         if (!websocket_1.isNodeEnvironment)
             return [];
         const fs = require('fs');
         if (!fs.existsSync(filePath))
             return [];
         try {
-            const raw = await fs.promises.readFile(filePath, 'utf-8');
+            const raw = fs.readFileSync(filePath, 'utf-8');
             const items = [];
-            const lines = raw.split('\n');
-            for (let i = 0; i < lines.length; i++) {
-                const l = lines[i].trim();
+            for (const line of raw.split('\n')) {
+                const l = line.trim();
                 if (!l)
                     continue;
                 try {
                     items.push(JSON.parse(l));
                 }
-                catch (lineErr) {
-                    console.warn(`[GroupMessageStore] JSONL 解析失败 (${filePath} 行${i + 1}): ${l.substring(0, 80)}`, lineErr);
-                }
+                catch (_a) { }
             }
             return items;
         }
-        catch (e) {
-            console.warn(`[GroupMessageStore] 读取 JSONL 文件失败 (${filePath}):`, e);
+        catch (_b) {
             return [];
         }
     }
@@ -119,7 +115,7 @@ class GroupMessageStore {
             data = { record, messages: [], events: [] };
             this.groups.set(groupId, data);
             this._indexDirty = true;
-            this.flushIndexQueued();
+            this.flushIndexAsync();
         }
         return data.record;
     }
@@ -147,17 +143,18 @@ class GroupMessageStore {
                 }
             }
             catch (e) {
-                console.error(`[GroupMessageStore] 删除群目录失败 (${groupId}):`, e);
+                utils_1.logger.error(`[GroupMessageStore] 删除群目录失败 (${groupId}):`, e);
             }
             await this.flushIndex();
         }
         return true;
     }
     // ---- message storage ----
-    async addMessage(groupId, msg) {
+    addMessage(groupId, msg) {
         const data = this.groups.get(groupId);
         if (!data)
             return;
+        // dedup: skip if msg_id already seen
         if (msg.msg_id <= data.record.lastMsgId)
             return;
         data.messages.push(msg);
@@ -165,35 +162,37 @@ class GroupMessageStore {
         data.record.messageCount = data.messages.length;
         data.record.lastMessageAt = msg.timestamp || Date.now();
         this._indexDirty = true;
+        // truncate if over limit
         if (data.messages.length > this.maxMessagesPerGroup) {
             const excess = data.messages.length - this.maxMessagesPerGroup;
             data.messages.splice(0, excess);
             data.record.messageCount = data.messages.length;
-            await this.flushMessages(groupId);
+            this.flushMessages(groupId);
         }
         else {
-            await this.appendJsonl(this.getMessagesPath(this.ownerAid, groupId), msg);
+            this.appendJsonl(this.getMessagesPath(this.ownerAid, groupId), msg);
         }
-        this.flushIndexQueued();
+        this.flushIndexAsync();
     }
-    async addMessages(groupId, msgs) {
+    addMessages(groupId, msgs) {
         const data = this.groups.get(groupId);
-        if (!data)
+        if (!data) {
+            utils_1.logger.warn(`[GroupMessageStore] addMessages: group=${groupId} NOT FOUND in store! Available groups: [${Array.from(this.groups.keys()).join(', ')}]`);
             return;
-        const sorted = [...msgs].sort((a, b) => a.msg_id - b.msg_id);
-        const existingIds = new Set(data.messages.map(m => m.msg_id));
+        }
+        utils_1.logger.log(`[GroupMessageStore] addMessages: group=${groupId} incoming=${msgs.length} currentLastMsgId=${data.record.lastMsgId} incomingMsgIds=[${msgs.map(m => m.msg_id).join(',')}]`);
         let added = 0;
-        for (const msg of sorted) {
-            if (existingIds.has(msg.msg_id))
+        for (const msg of msgs) {
+            if (msg.msg_id <= data.record.lastMsgId) {
+                utils_1.logger.log(`[GroupMessageStore] addMessages: SKIP duplicate msg_id=${msg.msg_id} <= lastMsgId=${data.record.lastMsgId}`);
                 continue;
-            data.messages.push(msg);
-            existingIds.add(msg.msg_id);
-            if (msg.msg_id > data.record.lastMsgId) {
-                data.record.lastMsgId = msg.msg_id;
             }
+            data.messages.push(msg);
+            data.record.lastMsgId = msg.msg_id;
             data.record.lastMessageAt = msg.timestamp || Date.now();
             added++;
         }
+        utils_1.logger.log(`[GroupMessageStore] addMessages result: group=${groupId} added=${added}/${msgs.length} newLastMsgId=${data.record.lastMsgId} totalMessages=${data.messages.length}`);
         if (added === 0)
             return;
         data.record.messageCount = data.messages.length;
@@ -202,9 +201,12 @@ class GroupMessageStore {
             const excess = data.messages.length - this.maxMessagesPerGroup;
             data.messages.splice(0, excess);
             data.record.messageCount = data.messages.length;
+            this.flushMessages(groupId);
+        }
+        else {
+            this.flushMessages(groupId);
         }
-        await this.flushMessages(groupId);
-        this.flushIndexQueued();
+        this.flushIndexAsync();
     }
     getMessages(groupId, options) {
         const data = this.groups.get(groupId);
@@ -229,7 +231,7 @@ class GroupMessageStore {
         return data.messages.slice(-limit);
     }
     // ---- event storage ----
-    async addEvent(groupId, evt) {
+    addEvent(groupId, evt) {
         const data = this.groups.get(groupId);
         if (!data)
             return;
@@ -243,14 +245,14 @@ class GroupMessageStore {
             const excess = data.events.length - this.maxEventsPerGroup;
             data.events.splice(0, excess);
             data.record.eventCount = data.events.length;
-            await this.flushEvents(groupId);
+            this.flushEvents(groupId);
         }
         else {
-            await this.appendJsonl(this.getEventsPath(this.ownerAid, groupId), evt);
+            this.appendJsonl(this.getEventsPath(this.ownerAid, groupId), evt);
         }
-        this.flushIndexQueued();
+        this.flushIndexAsync();
     }
-    async addEvents(groupId, evts) {
+    addEvents(groupId, evts) {
         const data = this.groups.get(groupId);
         if (!data)
             return;
@@ -271,8 +273,8 @@ class GroupMessageStore {
             data.events.splice(0, excess);
             data.record.eventCount = data.events.length;
         }
-        await this.flushEvents(groupId);
-        this.flushIndexQueued();
+        this.flushEvents(groupId);
+        this.flushIndexAsync();
     }
     getEvents(groupId, options) {
         const data = this.groups.get(groupId);
@@ -288,54 +290,47 @@ class GroupMessageStore {
         return result;
     }
     // ---- persistence ----
-    async appendJsonl(filePath, item) {
+    appendJsonl(filePath, item) {
         if (!this.persistMessages || !websocket_1.isNodeEnvironment || !this.ownerAid)
             return;
         const fs = require('fs');
         const path = require('path');
-        await this.ensureDir(path.dirname(filePath));
+        this.ensureDir(path.dirname(filePath));
         try {
-            await fs.promises.appendFile(filePath, JSON.stringify(item) + '\n');
+            fs.appendFileSync(filePath, JSON.stringify(item) + '\n');
         }
         catch (e) {
-            console.error(`[GroupMessageStore] 追加写入失败 (${filePath}):`, e);
+            utils_1.logger.error(`[GroupMessageStore] 追加写入失败 (${filePath}):`, e);
         }
     }
-    async writeJsonl(filePath, items) {
+    writeJsonl(filePath, items) {
         if (!this.persistMessages || !websocket_1.isNodeEnvironment || !this.ownerAid)
             return;
         const fs = require('fs');
         const path = require('path');
-        await this.ensureDir(path.dirname(filePath));
+        this.ensureDir(path.dirname(filePath));
         try {
             const lines = items.map(i => JSON.stringify(i)).join('\n');
-            const content = lines ? lines + '\n' : '';
-            const tmpPath = filePath + '.tmp';
-            await fs.promises.writeFile(tmpPath, content);
-            await fs.promises.rename(tmpPath, filePath);
+            fs.writeFileSync(filePath, lines ? lines + '\n' : '');
         }
         catch (e) {
-            console.error(`[GroupMessageStore] 全量写入失败 (${filePath}):`, e);
+            utils_1.logger.error(`[GroupMessageStore] 全量写入失败 (${filePath}):`, e);
         }
     }
-    async flushMessages(groupId) {
+    flushMessages(groupId) {
         const data = this.groups.get(groupId);
         if (!data || !this.ownerAid)
             return;
-        await this.writeJsonl(this.getMessagesPath(this.ownerAid, groupId), data.messages);
+        this.writeJsonl(this.getMessagesPath(this.ownerAid, groupId), data.messages);
     }
-    async flushEvents(groupId) {
+    flushEvents(groupId) {
         const data = this.groups.get(groupId);
         if (!data || !this.ownerAid)
             return;
-        await this.writeJsonl(this.getEventsPath(this.ownerAid, groupId), data.events);
+        this.writeJsonl(this.getEventsPath(this.ownerAid, groupId), data.events);
     }
-    flushIndexQueued() {
-        var _a;
-        const prev = (_a = this._flushIndexPromise) !== null && _a !== void 0 ? _a : Promise.resolve();
-        this._flushIndexPromise = prev.then(() => this.flushIndex()).catch(e => {
-            console.error('[GroupMessageStore] 索引刷盘失败:', e);
-        });
+    flushIndexAsync() {
+        this.flushIndex().catch(() => { });
     }
     async flushIndex() {
         if (!this.persistMessages || !websocket_1.isNodeEnvironment || !this.ownerAid)
@@ -344,18 +339,15 @@ class GroupMessageStore {
             return;
         const fs = require('fs');
         const dir = this.getGroupsDir(this.ownerAid);
-        await this.ensureDir(dir);
+        this.ensureDir(dir);
         const records = Array.from(this.groups.values())
             .map(d => d.record);
         try {
-            const indexPath = this.getIndexPath(this.ownerAid);
-            const tmpPath = indexPath + '.tmp';
-            await fs.promises.writeFile(tmpPath, JSON.stringify(records, null, 2));
-            await fs.promises.rename(tmpPath, indexPath);
+            fs.writeFileSync(this.getIndexPath(this.ownerAid), JSON.stringify(records, null, 2));
             this._indexDirty = false;
         }
         catch (e) {
-            console.error('[GroupMessageStore] 写入索引失败:', e);
+            utils_1.logger.error('[GroupMessageStore] 写入索引失败:', e);
         }
     }
     async flush(ownerAid) {
@@ -363,9 +355,9 @@ class GroupMessageStore {
             return;
         this.ownerAid = ownerAid;
         await this.flushIndex();
-        for (const [groupId] of this.groups) {
-            await this.flushMessages(groupId);
-            await this.flushEvents(groupId);
+        for (const [groupId, data] of this.groups) {
+            this.flushMessages(groupId);
+            this.flushEvents(groupId);
         }
     }
     async flushAll() {

package/dist/group/operations.d.ts

@@ -3,7 +3,7 @@
  * Mirrors Python SDK: agentcp/group/operations.py
  */
 import { ACPGroupClient } from './client';
-import { CreateGroupResp, SendMessageResp, PullMessagesResp, PullEventsResp, CursorState, GroupInfoResp, BanlistResp, BatchReviewResp, PendingRequestsResp, RequestJoinResp, MembersResp, AdminsResp, RulesResp, AnnouncementResp, JoinRequirementsResp, MasterResp, InviteCodeResp, InviteCodeListResp, BroadcastLockResp, BroadcastPermissionResp, SyncStatusResp, SyncLogResp, ChecksumResp, PublicGroupInfoResp, SearchGroupsResp, DigestResp, ListMyGroupsResp, GetFileResp, GetSummaryResp, GetMetricsResp, DutyConfig, DutyStatusResp, DispatchDecisionParams } from './types';
+import { CreateGroupResp, SendMessageResp, PullMessagesResp, PullEventsResp, CursorState, GroupInfoResp, BanlistResp, BatchReviewResp, PendingRequestsResp, RequestJoinResp, MembersResp, AdminsResp, RulesResp, AnnouncementResp, JoinRequirementsResp, MasterResp, InviteCodeResp, InviteCodeListResp, BroadcastLockResp, BroadcastPermissionResp, SyncStatusResp, SyncLogResp, ChecksumResp, PublicGroupInfoResp, SearchGroupsResp, DigestResp, ListMyGroupsResp, GetFileResp, GetSummaryResp, GetMetricsResp, DutyConfig, DutyStatusResp } from './types';
 /**
  * Callback interface for syncGroup.
  */
@@ -146,10 +146,6 @@ export declare class GroupOperations {
      * 获取值班状态，包含 config 和 state。
      */
     getDutyStatus(targetAid: string, groupId: string): Promise<DutyStatusResp>;
-    /**
-     * 值班 Agent 提交仲裁决策。
-     */
-    dispatchDecision(targetAid: string, groupId: string, params: DispatchDecisionParams): Promise<void>;
     /**
      * 重新获取所有成员的 agent.md 并更新 AgentType。
      */

package/dist/group/operations.js

@@ -634,11 +634,11 @@ class GroupOperations {
             params.shift_duration_ms = config.shift_duration_ms;
         if (config.max_messages_per_shift != null)
             params.max_messages_per_shift = config.max_messages_per_shift;
-        if (config.dispatch_timeout_ms != null)
-            params.dispatch_timeout_ms = config.dispatch_timeout_ms;
-        if (config.timeout_fallback != null)
-            params.timeout_fallback = config.timeout_fallback;
-        const resp = await this._client.sendRequest(targetAid, groupId, "update_duty_config", params);
+        if (config.duty_priority_window_ms != null)
+            params.duty_priority_window_ms = config.duty_priority_window_ms;
+        if (config.enable_rule_prelude != null)
+            params.enable_rule_prelude = config.enable_rule_prelude;
+        const resp = await this._client.sendRequest(targetAid, groupId, "update_duty_config", { duty_config: params });
         this._check(resp, "update_duty_config");
     }
     /**
@@ -658,13 +658,6 @@ class GroupOperations {
         const d = resp.data || {};
         return { config: (_a = d.config) !== null && _a !== void 0 ? _a : {}, state: (_b = d.state) !== null && _b !== void 0 ? _b : {} };
     }
-    /**
-     * 值班 Agent 提交仲裁决策。
-     */
-    async dispatchDecision(targetAid, groupId, params) {
-        const resp = await this._client.sendRequest(targetAid, groupId, "dispatch_decision", params);
-        this._check(resp, "dispatch_decision");
-    }
     /**
      * 重新获取所有成员的 agent.md 并更新 AgentType。
      */

package/dist/group/types.d.ts

@@ -20,8 +20,6 @@ export declare enum GroupErrorCode {
     ACTION_NOT_IMPL = 1099,
     DUTY_NOT_ENABLED = 1020,
     NOT_DUTY_AGENT = 1021,
-    DISPATCH_NOT_FOUND = 1022,
-    INVALID_DECISION = 1023,
     AGENT_MD_NOT_FOUND = 1024,
     AGENT_MD_INVALID = 1025
 }
@@ -258,8 +256,8 @@ export declare const NOTIFY_GROUP_INVITE = "group_invite";
 export declare const NOTIFY_JOIN_APPROVED = "join_approved";
 export declare const NOTIFY_JOIN_REJECTED = "join_rejected";
 export declare const NOTIFY_JOIN_REQUEST_RECEIVED = "join_request_received";
+export declare const NOTIFY_GROUP_MESSAGE = "group_message";
 export declare const NOTIFY_GROUP_EVENT = "group_event";
-export declare const NOTIFY_DUTY_DISPATCH = "duty_dispatch";
 export declare const EVENT_MEMBER_JOINED = "member_joined";
 export declare const EVENT_MEMBER_REMOVED = "member_removed";
 export declare const EVENT_MEMBER_LEFT = "member_left";
@@ -275,37 +273,13 @@ export declare const EVENT_MEMBER_UNBANNED = "member_unbanned";
 export declare const EVENT_JOIN_REQUIREMENTS_UPDATED = "join_requirements_updated";
 export declare const EVENT_INVITE_CODE_CREATED = "invite_code_created";
 export declare const EVENT_INVITE_CODE_REVOKED = "invite_code_revoked";
-export interface DutyMemberInfo {
-    agent_id: string;
-    agent_type: string;
-}
-export interface DutyContext {
-    needs_dispatch: boolean;
-    original_msg_id: number;
-    sender_id: string;
-    sender_type: string;
-    group_member_count: number;
-    online_ai_members: DutyMemberInfo[];
-    human_members: DutyMemberInfo[];
-}
-export interface DispatchDecisionParams {
-    original_msg_id: number;
-    type: "broadcast" | "selective" | "suppress";
-    hint?: string;
-    reply_mode?: string;
-}
-export interface DispatchMetadata {
-    type: string;
-    hint: string;
-    reply_mode: string;
-}
 export interface DutyConfig {
     mode: "none" | "fixed" | "rotation";
     rotation_strategy?: "round_robin" | "random";
     shift_duration_ms?: number;
     max_messages_per_shift?: number;
-    dispatch_timeout_ms?: number;
-    timeout_fallback?: "broadcast" | "next_duty";
+    duty_priority_window_ms?: number;
+    enable_rule_prelude?: boolean;
     agents?: string[];
 }
 export interface DutyState {

package/dist/group/types.js

@@ -4,7 +4,7 @@
  * Mirrors Python SDK: agentcp/group/types.py
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ACTION_MESSAGE_BATCH_PUSH = exports.EVENT_INVITE_CODE_REVOKED = exports.EVENT_INVITE_CODE_CREATED = exports.EVENT_JOIN_REQUIREMENTS_UPDATED = exports.EVENT_MEMBER_UNBANNED = exports.EVENT_GROUP_RESUMED = exports.EVENT_GROUP_SUSPENDED = exports.EVENT_MASTER_TRANSFERRED = exports.EVENT_GROUP_DISSOLVED = exports.EVENT_ANNOUNCEMENT_UPDATED = exports.EVENT_RULES_UPDATED = exports.EVENT_META_UPDATED = exports.EVENT_MEMBER_BANNED = exports.EVENT_MEMBER_LEFT = exports.EVENT_MEMBER_REMOVED = exports.EVENT_MEMBER_JOINED = exports.NOTIFY_DUTY_DISPATCH = exports.NOTIFY_GROUP_EVENT = exports.NOTIFY_JOIN_REQUEST_RECEIVED = exports.NOTIFY_JOIN_REJECTED = exports.NOTIFY_JOIN_APPROVED = exports.NOTIFY_GROUP_INVITE = exports.NOTIFY_NEW_EVENT = exports.NOTIFY_NEW_MESSAGE = exports.GroupError = exports.GroupErrorCode = void 0;
+exports.ACTION_MESSAGE_BATCH_PUSH = exports.EVENT_INVITE_CODE_REVOKED = exports.EVENT_INVITE_CODE_CREATED = exports.EVENT_JOIN_REQUIREMENTS_UPDATED = exports.EVENT_MEMBER_UNBANNED = exports.EVENT_GROUP_RESUMED = exports.EVENT_GROUP_SUSPENDED = exports.EVENT_MASTER_TRANSFERRED = exports.EVENT_GROUP_DISSOLVED = exports.EVENT_ANNOUNCEMENT_UPDATED = exports.EVENT_RULES_UPDATED = exports.EVENT_META_UPDATED = exports.EVENT_MEMBER_BANNED = exports.EVENT_MEMBER_LEFT = exports.EVENT_MEMBER_REMOVED = exports.EVENT_MEMBER_JOINED = exports.NOTIFY_GROUP_EVENT = exports.NOTIFY_GROUP_MESSAGE = exports.NOTIFY_JOIN_REQUEST_RECEIVED = exports.NOTIFY_JOIN_REJECTED = exports.NOTIFY_JOIN_APPROVED = exports.NOTIFY_GROUP_INVITE = exports.NOTIFY_NEW_EVENT = exports.NOTIFY_NEW_MESSAGE = exports.GroupError = exports.GroupErrorCode = void 0;
 exports.buildGroupRequest = buildGroupRequest;
 exports.groupRequestToJson = groupRequestToJson;
 exports.parseGroupResponse = parseGroupResponse;
@@ -34,8 +34,6 @@ var GroupErrorCode;
     // Duty error codes
     GroupErrorCode[GroupErrorCode["DUTY_NOT_ENABLED"] = 1020] = "DUTY_NOT_ENABLED";
     GroupErrorCode[GroupErrorCode["NOT_DUTY_AGENT"] = 1021] = "NOT_DUTY_AGENT";
-    GroupErrorCode[GroupErrorCode["DISPATCH_NOT_FOUND"] = 1022] = "DISPATCH_NOT_FOUND";
-    GroupErrorCode[GroupErrorCode["INVALID_DECISION"] = 1023] = "INVALID_DECISION";
     GroupErrorCode[GroupErrorCode["AGENT_MD_NOT_FOUND"] = 1024] = "AGENT_MD_NOT_FOUND";
     GroupErrorCode[GroupErrorCode["AGENT_MD_INVALID"] = 1025] = "AGENT_MD_INVALID";
 })(GroupErrorCode || (exports.GroupErrorCode = GroupErrorCode = {}));
@@ -56,8 +54,6 @@ const CODE_MESSAGES = {
     1013: "broadcast conflict",
     1020: "duty not enabled",
     1021: "not duty agent",
-    1022: "dispatch not found",
-    1023: "invalid decision",
     1024: "agent.md not found",
     1025: "agent.md invalid",
     1099: "action not implemented",
@@ -133,8 +129,8 @@ exports.NOTIFY_GROUP_INVITE = "group_invite";
 exports.NOTIFY_JOIN_APPROVED = "join_approved";
 exports.NOTIFY_JOIN_REJECTED = "join_rejected";
 exports.NOTIFY_JOIN_REQUEST_RECEIVED = "join_request_received";
+exports.NOTIFY_GROUP_MESSAGE = "group_message";
 exports.NOTIFY_GROUP_EVENT = "group_event";
-exports.NOTIFY_DUTY_DISPATCH = "duty_dispatch";
 // Group Event Type Constants
 exports.EVENT_MEMBER_JOINED = "member_joined";
 exports.EVENT_MEMBER_REMOVED = "member_removed";

package/dist/heartbeat.js

@@ -106,12 +106,12 @@ class HeartbeatClient {
         try {
             const privateKey = await (0, utils_1.getDecryptKey)(this.agentId, this.seedPassword);
             if (!privateKey) {
-                console.error('[Heartbeat] 获取私钥失败');
+                utils_1.logger.error('[Heartbeat] 获取私钥失败');
                 return false;
             }
             const { publicKeyPem, certPem } = await (0, cert_1.getPublicKeyPem)(this.agentId);
             if (!certPem) {
-                console.error('[Heartbeat] 获取证书失败');
+                utils_1.logger.error('[Heartbeat] 获取证书失败');
                 return false;
             }
             // 确保使用 HTTPS
@@ -121,23 +121,23 @@ class HeartbeatClient {
             }
             const result = await (0, api_1.signIn)(this.agentId, serverUrl, privateKey, publicKeyPem, certPem);
             if (!result || !result.signData) {
-                console.error('[Heartbeat] signIn 失败');
+                utils_1.logger.error('[Heartbeat] signIn 失败');
                 return false;
             }
             const { server_ip, port, sign_cookie, signature } = result.signData;
             if (!server_ip || !port || sign_cookie === undefined) {
-                console.error('[Heartbeat] signIn 返回数据不完整');
+                utils_1.logger.error('[Heartbeat] signIn 返回数据不完整');
                 return false;
             }
             this.serverIp = server_ip;
             this.port = parseInt(port, 10);
             this.signCookie = parseInt(sign_cookie, 10);
             this.signature = signature || '';
-            console.log(`[Heartbeat] signIn 成功: ${this.serverIp}:${this.port}`);
+            utils_1.logger.log(`[Heartbeat] signIn 成功: ${this.serverIp}:${this.port}`);
             return true;
         }
         catch (error) {
-            console.error('[Heartbeat] signIn 异常:', error);
+            utils_1.logger.error('[Heartbeat] signIn 异常:', error);
             return false;
         }
     }
@@ -151,7 +151,7 @@ class HeartbeatClient {
             this.handleMessage(msg);
         });
         this.udpSocket.on('error', (err) => {
-            console.error('[Heartbeat] Socket 错误:', err);
+            utils_1.logger.error('[Heartbeat] Socket 错误:', err);
             this.recvFailures++;
             if (this.recvFailures >= HeartbeatClient.MAX_RECV_FAILURES) {
                 this.reconnect('recv_failures_threshold');
@@ -192,7 +192,7 @@ class HeartbeatClient {
                 this.recvFailures = 0;
                 // 检查是否需要重新认证
                 if (resp.NextBeat === 401) {
-                    console.warn('[Heartbeat] 收到 401，需要重新认证');
+                    utils_1.logger.warn('[Heartbeat] 收到 401，需要重新认证');
                     this.reconnect('401_auth_failed');
                     return;
                 }
@@ -204,7 +204,7 @@ class HeartbeatClient {
             else if (header.MessageType === message_serialize_1.MessageType.INVITE_REQ) {
                 // 邀请请求
                 const { req } = message_serialize_1.InviteMessageReq.deserialize(data, 0);
-                console.log(`[Heartbeat] 收到邀请请求: inviter=${req.InviterAgentId}, session=${req.SessionId}`);
+                utils_1.logger.log(`[Heartbeat] 收到邀请请求: inviter=${req.InviterAgentId}, session=${req.SessionId}`);
                 // 发送邀请响应
                 this.sendInviteResponse(req);
                 // 触发回调
@@ -219,7 +219,7 @@ class HeartbeatClient {
             }
         }
         catch (error) {
-            console.error('[Heartbeat] 处理消息异常:', error);
+            utils_1.logger.error('[Heartbeat] 处理消息异常:', error);
         }
     }
     /**
@@ -242,15 +242,15 @@ class HeartbeatClient {
             const data = resp.serialize();
             this.udpSocket.send(data, this.port, this.serverIp, (err) => {
                 if (err) {
-                    console.error('[Heartbeat] 发送邀请响应失败:', err);
+                    utils_1.logger.error('[Heartbeat] 发送邀请响应失败:', err);
                 }
                 else {
-                    console.log('[Heartbeat] 邀请响应已发送');
+                    utils_1.logger.log('[Heartbeat] 邀请响应已发送');
                 }
             });
         }
         catch (error) {
-            console.error('[Heartbeat] 发送邀请响应异常:', error);
+            utils_1.logger.error('[Heartbeat] 发送邀请响应异常:', error);
         }
     }
     /**
@@ -265,7 +265,7 @@ class HeartbeatClient {
         if (this.lastHbRecv > 0) {
             const timeoutThreshold = HeartbeatClient.MAX_MISSED_HEARTBEATS * this.heartbeatInterval;
             if (now - this.lastHbRecv > timeoutThreshold) {
-                console.warn(`[Heartbeat] 心跳响应超时: ${now - this.lastHbRecv}ms > ${timeoutThreshold}ms`);
+                utils_1.logger.warn(`[Heartbeat] 心跳响应超时: ${now - this.lastHbRecv}ms > ${timeoutThreshold}ms`);
                 this.reconnect('heartbeat_response_timeout');
                 return;
             }
@@ -287,7 +287,7 @@ class HeartbeatClient {
             const data = req.serialize();
             this.udpSocket.send(data, this.port, this.serverIp, (err) => {
                 if (err) {
-                    console.error('[Heartbeat] 发送心跳失败:', err);
+                    utils_1.logger.error('[Heartbeat] 发送心跳失败:', err);
                     this.sendFailures++;
                     if (this.sendFailures >= HeartbeatClient.MAX_SEND_FAILURES) {
                         this.reconnect('send_failures_threshold');
@@ -299,7 +299,7 @@ class HeartbeatClient {
             });
         }
         catch (error) {
-            console.error('[Heartbeat] 发送心跳异常:', error);
+            utils_1.logger.error('[Heartbeat] 发送心跳异常:', error);
             this.sendFailures++;
         }
     }
@@ -318,14 +318,14 @@ class HeartbeatClient {
             // 限流：至少间隔 5 秒
             if (elapsed < 5000) {
                 const backoff = Math.min(5000 - elapsed, HeartbeatClient.RECONNECT_BACKOFF_MAX);
-                console.log(`[Heartbeat] 重连退避: ${backoff}ms`);
+                utils_1.logger.log(`[Heartbeat] 重连退避: ${backoff}ms`);
                 await new Promise(resolve => setTimeout(resolve, backoff));
             }
-            console.log(`[Heartbeat] 开始重连，原因: ${reason}`);
+            utils_1.logger.log(`[Heartbeat] 开始重连，原因: ${reason}`);
             this.lastReconnectTs = Date.now();
             // 重新登录
             if (!await this.signIn()) {
-                console.error('[Heartbeat] 重连失败: signIn 返回 false');
+                utils_1.logger.error('[Heartbeat] 重连失败: signIn 返回 false');
                 this.updateStatus('error');
                 // 重置 lastHbRecv 避免下次 tick 立即再次触发重连
                 this.lastHbRecv = Date.now();
@@ -337,7 +337,7 @@ class HeartbeatClient {
             this.sendFailures = 0;
             this.recvFailures = 0;
             this.lastHbRecv = Date.now();
-            console.log('[Heartbeat] 重连成功');
+            utils_1.logger.log('[Heartbeat] 重连成功');
             this.updateStatus('online');
             // 通知外部组件（如 WebSocket）进行重连
             if (this.onReconnectCallback) {
@@ -345,13 +345,13 @@ class HeartbeatClient {
                     this.onReconnectCallback();
                 }
                 catch (e) {
-                    console.error('[Heartbeat] onReconnect 回调异常:', e);
+                    utils_1.logger.error('[Heartbeat] onReconnect 回调异常:', e);
                 }
             }
             return true;
         }
         catch (error) {
-            console.error('[Heartbeat] 重连异常:', error);
+            utils_1.logger.error('[Heartbeat] 重连异常:', error);
             this.updateStatus('error');
             return false;
         }
@@ -364,7 +364,7 @@ class HeartbeatClient {
      */
     async online() {
         if (this.isRunning) {
-            console.log('[Heartbeat] 已经在线');
+            utils_1.logger.log('[Heartbeat] 已经在线');
             return true;
         }
         this.updateStatus('connecting');
@@ -422,7 +422,7 @@ class HeartbeatClient {
             return [];
         }
         catch (error) {
-            console.error('[Heartbeat] 查询在线状态异常:', error);
+            utils_1.logger.error('[Heartbeat] 查询在线状态异常:', error);
             return [];
         }
     }