acp-ts 1.1.7 → 1.1.9

package/dist/agentcp.d.ts

@@ -19,6 +19,9 @@ declare class AgentCP implements IAgentCP {
     private _groupTargetAid;
     private _groupSessionId;
     private _persistGroupMessages;
+    private _onlineGroups;
+    private _heartbeatTimer;
+    private _heartbeatIntervalMs;
     get messageStore(): MessageStore;
     constructor(apiUrl: string, seedPassword?: string, basePath?: string, options?: {
         persistMessages?: boolean;
@@ -86,16 +89,23 @@ declare class AgentCP implements IAgentCP {
      */
     setGroupEventHandler(handler: ACPGroupEventHandler): void;
     /**
-     * 创建默认的群组事件处理器（防御性，仅打印日志）。
+     * 创建默认的群组事件处理器。
+     * - onGroupMessage: 自动存储消息到 GroupMessageStore + 自动 ACK
+     * - onJoinApproved: 自动注册到 Home AP + 存储群组
      * 外部可通过 setGroupEventHandler 覆盖。
      */
     private _createDefaultGroupEventHandler;
+    /**
+     * 自动 ACK 消息（SDK 内部行为，对上层透明）
+     */
+    private _autoAckMessage;
     /**
      * 设置群组游标存储
      */
     setGroupCursorStore(store: CursorStore): void;
     /**
-     * 关闭群组客户端
+     * 关闭群组客户端。
+     * 自动停止心跳、清理在线群组状态。
      */
     closeGroupClient(): void;
     /**
@@ -158,9 +168,51 @@ declare class AgentCP implements IAgentCP {
     getGroupLastMsgId(groupId: string): number;
     /**
      * 从服务端拉取新消息并同步到本地存储。
+     * 循环拉取直到 has_more=false，每批拉取后自动 ACK。
      * 返回所有本地缓存的消息（包括新拉取的）。
+     *
+     * @param groupId 群组 ID
+     * @param afterMsgId 从哪条消息之后开始拉取，0 表示使用服务端自动游标模式
+     * @param limit 每次拉取数量上限，0 表示使用服务端默认值
+     */
+    pullAndStoreGroupMessages(groupId: string, afterMsgId?: number, limit?: number): Promise<GroupMessage[]>;
+    /**
+     * 加入群组会话（完整生命周期）：
+     * 1. register_online → 告知 group.ap 在线
+     * 2. 将群组加入在线列表
+     * 3. 启动心跳定时器（首次时启动）
+     */
+    joinGroupSession(groupId: string): Promise<void>;
+    /**
+     * 离开群组会话（优雅退出）：
+     * 1. 从在线群组列表移除
+     * 2. 如果没有在线群组了，unregister_online + 停止心跳定时器
+     */
+    leaveGroupSession(groupId: string): Promise<void>;
+    /**
+     * 离开所有群组会话
+     */
+    leaveAllGroupSessions(): Promise<void>;
+    /**
+     * 获取当前在线群组列表
+     */
+    getOnlineGroups(): string[];
+    /**
+     * 设置心跳间隔（毫秒），默认 180000（3 分钟）
+     */
+    setHeartbeatInterval(intervalMs: number): void;
+    /**
+     * 确保心跳定时器已启动
+     */
+    private _ensureHeartbeat;
+    /**
+     * 停止心跳定时器
+     */
+    private _stopHeartbeat;
+    /**
+     * 发送心跳保活
      */
-    pullAndStoreGroupMessages(groupId: string, limit?: number): Promise<GroupMessage[]>;
+    private _sendHeartbeats;
     /**
      * 关闭群消息存储，刷新所有未写入的数据
      */

package/dist/agentcp.js

@@ -62,6 +62,10 @@ class AgentCP {
         this._groupTargetAid = '';
         this._groupSessionId = '';
         this._persistGroupMessages = false;
+        // Group lifecycle management
+        this._onlineGroups = new Set();
+        this._heartbeatTimer = null;
+        this._heartbeatIntervalMs = 180000; // 3 minutes
         if (!apiUrl) {
             this.handleError("参数缺失：apiUrl不应为空");
         }
@@ -369,11 +373,9 @@ class AgentCP {
         }
         const data = message.data || message;
         const sender = (_a = data.sender) !== null && _a !== void 0 ? _a : "";
-        // console.log(`[Group] handleGroupMessage: sender="${sender}" targetAid="${this._groupTargetAid}" match=${sender === this._groupTargetAid}`);
         if (sender === this._groupTargetAid) {
             try {
                 const rawMsg = (_b = data.message) !== null && _b !== void 0 ? _b : "";
-                // console.log(`[Group] rawMsg type=${typeof rawMsg}, length=${typeof rawMsg === 'string' ? rawMsg.length : 'N/A'}, first 300 chars: ${typeof rawMsg === 'string' ? rawMsg.substring(0, 300) : JSON.stringify(rawMsg).substring(0, 300)}`);
                 if (typeof rawMsg === 'string' && rawMsg) {
                     this.groupClient.handleIncoming(rawMsg);
                 }
@@ -398,7 +400,9 @@ class AgentCP {
         }
     }
     /**
-     * 创建默认的群组事件处理器（防御性，仅打印日志）。
+     * 创建默认的群组事件处理器。
+     * - onGroupMessage: 自动存储消息到 GroupMessageStore + 自动 ACK
+     * - onJoinApproved: 自动注册到 Home AP + 存储群组
      * 外部可通过 setGroupEventHandler 覆盖。
      */
     _createDefaultGroupEventHandler() {
@@ -441,14 +445,28 @@ class AgentCP {
             onJoinRequestReceived(groupId, agentId, message) {
                 console.log(`[Group][DefaultHandler] onJoinRequestReceived: group=${groupId} agent=${agentId}`);
             },
-            onGroupMessage(groupId, msg) {
+            onGroupMessage: (groupId, msg) => {
                 console.log(`[Group][DefaultHandler] onGroupMessage: group=${groupId} msgId=${msg.msg_id} sender=${msg.sender}`);
+                // 自动存储消息到本地
+                this.addGroupMessageToStore(groupId, msg);
+                // 自动 ACK（异步，不阻塞回调）
+                this._autoAckMessage(groupId, msg.msg_id);
             },
             onGroupEvent(groupId, evt) {
                 console.log(`[Group][DefaultHandler] onGroupEvent: group=${groupId} event=${evt.event_type}`);
             },
         };
     }
+    /**
+     * 自动 ACK 消息（SDK 内部行为，对上层透明）
+     */
+    _autoAckMessage(groupId, msgId) {
+        if (!this.groupOps || !this._groupTargetAid)
+            return;
+        this.groupOps.ackMessages(this._groupTargetAid, groupId, msgId).catch(e => {
+            console.warn(`[Group] auto ack failed: group=${groupId} msgId=${msgId}`, e.message || e);
+        });
+    }
     /**
      * 设置群组游标存储
      */
@@ -458,9 +476,12 @@ class AgentCP {
         }
     }
     /**
-     * 关闭群组客户端
+     * 关闭群组客户端。
+     * 自动停止心跳、清理在线群组状态。
      */
     closeGroupClient() {
+        this._stopHeartbeat();
+        this._onlineGroups.clear();
         if (this.groupClient) {
             try {
                 this.groupClient.close();
@@ -614,16 +635,24 @@ class AgentCP {
     }
     /**
      * 从服务端拉取新消息并同步到本地存储。
+     * 循环拉取直到 has_more=false，每批拉取后自动 ACK。
      * 返回所有本地缓存的消息（包括新拉取的）。
+     *
+     * @param groupId 群组 ID
+     * @param afterMsgId 从哪条消息之后开始拉取，0 表示使用服务端自动游标模式
+     * @param limit 每次拉取数量上限，0 表示使用服务端默认值
      */
-    async pullAndStoreGroupMessages(groupId, limit = 50) {
+    async pullAndStoreGroupMessages(groupId, afterMsgId = 0, limit = 50) {
         if (!this.groupOps || !this._groupTargetAid) {
             throw new Error('群组客户端未初始化');
         }
-        const lastMsgId = this.getGroupLastMsgId(groupId);
+        let after = afterMsgId;
         try {
-            const pulled = await this.groupOps.pullMessages(this._groupTargetAid, groupId, lastMsgId, limit);
-            if (pulled.messages && pulled.messages.length > 0) {
+            while (true) {
+                const pulled = await this.groupOps.pullMessages(this._groupTargetAid, groupId, after, limit);
+                if (!pulled.messages || pulled.messages.length === 0) {
+                    break;
+                }
                 const msgs = pulled.messages.map(m => {
                     var _a, _b, _c, _d, _e, _f;
                     return ({
@@ -636,13 +665,120 @@ class AgentCP {
                     });
                 });
                 this.addGroupMessagesToStore(groupId, msgs);
+                // ACK 这批消息中的最后一条
+                const lastMsgId = msgs[msgs.length - 1].msg_id;
+                await this.groupOps.ackMessages(this._groupTargetAid, groupId, lastMsgId);
+                // 更新 after 用于下一轮拉取
+                after = lastMsgId;
+                if (!pulled.has_more) {
+                    break;
+                }
             }
         }
         catch (e) {
-            console.warn('[AgentCP] pullMessages error:', e.message);
+            console.warn('[AgentCP] pullAndStoreGroupMessages error:', e.message);
         }
         return this.getLocalGroupMessages(groupId);
     }
+    // ============================================================
+    // Group Session Lifecycle (register_online / pull / heartbeat / unregister)
+    // ============================================================
+    /**
+     * 加入群组会话（完整生命周期）：
+     * 1. register_online → 告知 group.ap 在线
+     * 2. 将群组加入在线列表
+     * 3. 启动心跳定时器（首次时启动）
+     */
+    async joinGroupSession(groupId) {
+        if (!this.groupOps || !this._groupTargetAid) {
+            throw new Error('群组客户端未初始化，请先调用 initGroupClient');
+        }
+        // Step 1: register_online（仅通知 group.ap 在线，不再返回游标）
+        await this.groupOps.registerOnline(this._groupTargetAid);
+        this._onlineGroups.add(groupId);
+        console.log(`[Group] joinGroupSession: group=${groupId}`);
+        // Step 2: 启动心跳定时器（首次加入群组时启动）
+        this._ensureHeartbeat();
+    }
+    /**
+     * 离开群组会话（优雅退出）：
+     * 1. 从在线群组列表移除
+     * 2. 如果没有在线群组了，unregister_online + 停止心跳定时器
+     */
+    async leaveGroupSession(groupId) {
+        if (!this.groupOps || !this._groupTargetAid)
+            return;
+        this._onlineGroups.delete(groupId);
+        // 如果没有在线群组了，通知 group.ap 下线并停止心跳
+        if (this._onlineGroups.size === 0) {
+            try {
+                await this.groupOps.unregisterOnline(this._groupTargetAid);
+            }
+            catch (e) {
+                console.warn(`[Group] unregisterOnline failed`, e.message || e);
+            }
+            this._stopHeartbeat();
+        }
+    }
+    /**
+     * 离开所有群组会话
+     */
+    async leaveAllGroupSessions() {
+        const groups = Array.from(this._onlineGroups);
+        for (const groupId of groups) {
+            await this.leaveGroupSession(groupId);
+        }
+    }
+    /**
+     * 获取当前在线群组列表
+     */
+    getOnlineGroups() {
+        return Array.from(this._onlineGroups);
+    }
+    /**
+     * 设置心跳间隔（毫秒），默认 180000（3 分钟）
+     */
+    setHeartbeatInterval(intervalMs) {
+        this._heartbeatIntervalMs = intervalMs;
+        // 如果心跳已在运行，重新启动以应用新间隔
+        if (this._heartbeatTimer) {
+            this._stopHeartbeat();
+            this._ensureHeartbeat();
+        }
+    }
+    /**
+     * 确保心跳定时器已启动
+     */
+    _ensureHeartbeat() {
+        if (this._heartbeatTimer)
+            return;
+        if (this._onlineGroups.size === 0)
+            return;
+        this._heartbeatTimer = setInterval(() => {
+            this._sendHeartbeats();
+        }, this._heartbeatIntervalMs);
+        console.log(`[Group] heartbeat started: interval=${this._heartbeatIntervalMs}ms`);
+    }
+    /**
+     * 停止心跳定时器
+     */
+    _stopHeartbeat() {
+        if (this._heartbeatTimer) {
+            clearInterval(this._heartbeatTimer);
+            this._heartbeatTimer = null;
+            console.log(`[Group] heartbeat stopped`);
+        }
+    }
+    /**
+     * 发送心跳保活
+     */
+    _sendHeartbeats() {
+        if (!this.groupOps || !this._groupTargetAid)
+            return;
+        this.groupOps.heartbeat(this._groupTargetAid).catch(e => {
+            console.warn(`[Group] heartbeat failed`, e.message || e);
+        });
+    }
     /**
      * 关闭群消息存储，刷新所有未写入的数据
      */

package/dist/group/client.js

@@ -74,24 +74,21 @@ class ACPGroupClient {
      * Called by the message dispatch chain in AgentCP.
      */
     handleIncoming(payload) {
-        var _a, _b, _c;
-        // console.log(`[GroupClient] <<< handleIncoming raw payload (first 500 chars): ${payload.substring(0, 500)}`);
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
         let data;
         try {
             data = JSON.parse(payload);
         }
         catch (e) {
-            console.error(`[GroupClient] !!! JSON.parse failed for incoming payload:`, e, `payload(first 200): ${payload.substring(0, 200)}`);
+            console.error(`[GroupClient] JSON.parse failed for incoming payload:`, e);
             return;
         }
-        // console.log(`[GroupClient] <<< parsed data: action=${data.action} request_id=${data.request_id} event=${data.event} code=${data.code}`);
         // Try as response (has request_id)
         const requestId = (_a = data.request_id) !== null && _a !== void 0 ? _a : "";
         if (requestId) {
             const resp = (0, types_1.parseGroupResponse)(data);
             const pending = this._pendingReqs.get(requestId);
             if (pending) {
-                // console.log(`[GroupClient] <<< matched pending request: reqId=${requestId}, resolving`);
                 clearTimeout(pending.timer);
                 this._pendingReqs.delete(requestId);
                 pending.resolve(resp);
@@ -119,6 +116,34 @@ class ACPGroupClient {
             }
             return;
         }
+        // Handle action-based push messages from group.ap (e.g. message_push)
+        // These have action field but no event/request_id, need to be mapped to notification events
+        const action = (_d = data.action) !== null && _d !== void 0 ? _d : "";
+        if (action === "message_push" && data.data) {
+            console.log(`[GroupClient] message_push -> group_message: group=${data.group_id} msg_id=${data.data.msg_id}`);
+            const msgData = data.data;
+            const notify = {
+                action: "group_notify",
+                group_id: (_e = data.group_id) !== null && _e !== void 0 ? _e : "",
+                event: types_1.NOTIFY_GROUP_MESSAGE,
+                data: {
+                    msg_id: (_f = msgData.msg_id) !== null && _f !== void 0 ? _f : 0,
+                    sender: (_g = msgData.sender) !== null && _g !== void 0 ? _g : "",
+                    content: (_h = msgData.content) !== null && _h !== void 0 ? _h : "",
+                    content_type: (_j = msgData.content_type) !== null && _j !== void 0 ? _j : "text",
+                    timestamp: (_k = msgData.timestamp) !== null && _k !== void 0 ? _k : 0,
+                    metadata: (_l = msgData.metadata) !== null && _l !== void 0 ? _l : null,
+                },
+                timestamp: (_m = msgData.timestamp) !== null && _m !== void 0 ? _m : 0,
+            };
+            if (this._handler != null) {
+                (0, events_1.dispatchAcpNotify)(this._handler, notify);
+            }
+            else {
+                console.warn(`[GroupClient] !!! message_push dropped: no event handler registered.`);
+            }
+            return;
+        }
         console.warn(`[GroupClient] !!! unhandled incoming message: no request_id and no event field`, JSON.stringify(data).substring(0, 300));
     }
     // -- Lifecycle --

package/dist/group/operations.d.ts

@@ -42,15 +42,36 @@ export declare class GroupOperations {
         inviteCode?: string;
         message?: string;
     }): Promise<string>;
+    /**
+     * 注册上线，告知 group.ap 当前客户端在线，可以接收消息推送。
+     * 客户端每次启动或重新连接时调用一次即可。
+     */
+    registerOnline(targetAid: string): Promise<void>;
+    /**
+     * 主动下线（优雅退出）。
+     * 客户端退出时调用，立即从在线列表移除。
+     */
+    unregisterOnline(targetAid: string): Promise<void>;
+    /**
+     * 心跳保活。
+     * 在线注册有 5 分钟超时，SDK 需定时发送（建议 2~4 分钟）。
+     */
+    heartbeat(targetAid: string): Promise<void>;
     createGroup(targetAid: string, name: string, options?: {
         alias?: string;
         subject?: string;
         visibility?: string;
+        description?: string;
         tags?: string[];
     }): Promise<CreateGroupResp>;
     addMember(targetAid: string, groupId: string, agentId: string, role?: string): Promise<void>;
     sendGroupMessage(targetAid: string, groupId: string, content: string, contentType?: string, metadata?: Record<string, any>): Promise<SendMessageResp>;
-    pullMessages(targetAid: string, groupId: string, afterMsgId: number, limit?: number): Promise<PullMessagesResp>;
+    /**
+     * 拉取消息。
+     * - afterMsgId > 0: 指定位置模式，从该 ID 之后开始拉取
+     * - afterMsgId = 0 或不传: 自动游标模式（推荐），服务端基于 current_msg_id 自动计算
+     */
+    pullMessages(targetAid: string, groupId: string, afterMsgId?: number, limit?: number): Promise<PullMessagesResp>;
     ackMessages(targetAid: string, groupId: string, msgId: number): Promise<void>;
     pullEvents(targetAid: string, groupId: string, afterEventId: number, limit?: number): Promise<PullEventsResp>;
     ackEvents(targetAid: string, groupId: string, eventId: number): Promise<void>;

package/dist/group/operations.js

@@ -59,6 +59,33 @@ class GroupOperations {
         return this.requestJoin(targetAid, groupId, (_a = options === null || options === void 0 ? void 0 : options.message) !== null && _a !== void 0 ? _a : '');
     }
     // ============================================================
+    // Phase 0: Lifecycle (register / heartbeat / unregister)
+    // ============================================================
+    /**
+     * 注册上线，告知 group.ap 当前客户端在线，可以接收消息推送。
+     * 客户端每次启动或重新连接时调用一次即可。
+     */
+    async registerOnline(targetAid) {
+        const resp = await this._client.sendRequest(targetAid, "", "register_online", null);
+        this._check(resp, "register_online");
+    }
+    /**
+     * 主动下线（优雅退出）。
+     * 客户端退出时调用，立即从在线列表移除。
+     */
+    async unregisterOnline(targetAid) {
+        const resp = await this._client.sendRequest(targetAid, "", "unregister_online", null);
+        this._check(resp, "unregister_online");
+    }
+    /**
+     * 心跳保活。
+     * 在线注册有 5 分钟超时，SDK 需定时发送（建议 2~4 分钟）。
+     */
+    async heartbeat(targetAid) {
+        const resp = await this._client.sendRequest(targetAid, "", "heartbeat", null);
+        this._check(resp, "heartbeat");
+    }
+    // ============================================================
     // Phase 1: Basic Operations
     // ============================================================
     async createGroup(targetAid, name, options) {
@@ -70,6 +97,8 @@ class GroupOperations {
             params.subject = options.subject;
         if (options === null || options === void 0 ? void 0 : options.visibility)
             params.visibility = options.visibility;
+        if (options === null || options === void 0 ? void 0 : options.description)
+            params.description = options.description;
         if (options === null || options === void 0 ? void 0 : options.tags)
             params.tags = options.tags;
         const resp = await this._client.sendRequest(targetAid, "", "create_group", params);
@@ -96,12 +125,19 @@ class GroupOperations {
         const d = resp.data || {};
         return { msg_id: (_a = d.msg_id) !== null && _a !== void 0 ? _a : 0, timestamp: (_b = d.timestamp) !== null && _b !== void 0 ? _b : 0 };
     }
-    async pullMessages(targetAid, groupId, afterMsgId, limit = 0) {
+    /**
+     * 拉取消息。
+     * - afterMsgId > 0: 指定位置模式，从该 ID 之后开始拉取
+     * - afterMsgId = 0 或不传: 自动游标模式（推荐），服务端基于 current_msg_id 自动计算
+     */
+    async pullMessages(targetAid, groupId, afterMsgId = 0, limit = 0) {
         var _a, _b, _c;
-        const params = { after_msg_id: afterMsgId };
+        const params = {};
+        if (afterMsgId > 0)
+            params.after_msg_id = afterMsgId;
         if (limit > 0)
             params.limit = limit;
-        const resp = await this._client.sendRequest(targetAid, groupId, "pull_messages", params);
+        const resp = await this._client.sendRequest(targetAid, groupId, "pull_messages", Object.keys(params).length > 0 ? params : null);
         this._check(resp, "pull_messages");
         const d = resp.data || {};
         return {

package/dist/server.js

@@ -32,6 +32,9 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.startServer = startServer;
 const http = __importStar(require("http"));
@@ -39,6 +42,7 @@ const url = __importStar(require("url"));
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const https = __importStar(require("https"));
+const ws_1 = __importDefault(require("ws"));
 const datamanager_1 = require("./datamanager");
 const agentcp_1 = require("./agentcp");
 const agentws_1 = require("./agentws");
@@ -49,6 +53,21 @@ const messagestore_1 = require("./messagestore");
 let globalApiUrl = '';
 let globalDataDir = '';
 const messageStores = new Map();
+// ============================================================
+// Browser ↔ Server WebSocket (real-time group message push)
+// ============================================================
+const browserWsClients = new Set();
+/**
+ * 向所有已连接的浏览器 WS 客户端广播消息
+ */
+function broadcastToBrowser(data) {
+    const payload = JSON.stringify(data);
+    for (const client of browserWsClients) {
+        if (client.readyState === ws_1.default.OPEN) {
+            client.send(payload);
+        }
+    }
+}
 let agentCP = null;
 let currentAid = '';
 const MAX_AIDS = 10;
@@ -186,9 +205,22 @@ async function doEnsureOnline(aid) {
     ws.onStatusChange((status) => {
         instance.wsStatus = status;
         instance.wsConnected = status === 'connected';
+        broadcastToBrowser({ type: 'ws_status', aid, status });
     });
     await ws.startWebSocket();
     instance.online = true;
+    // 上线成功，推送 AID 状态变更到前端
+    getAidStatusList().then(aidStatus => {
+        broadcastToBrowser({ type: 'aid_status', aidStatus });
+    }).catch(() => { });
+    // AID 上线后自动初始化群组功能，确保所有身份都能收到群消息推送
+    try {
+        await ensureGroupClient(instance);
+        console.log(`[Server] AID ${aid} 群组功能自动初始化完成`);
+    }
+    catch (e) {
+        console.warn(`[Server] AID ${aid} 群组功能自动初始化失败(不影响上线):`, e.message);
+    }
     return instance;
 }
 // 确保群组客户端已初始化
@@ -228,16 +260,33 @@ async function ensureGroupClient(instance) {
     instance.agentCP.setGroupEventHandler({
         onNewMessage(groupId, latestMsgId, sender, preview) {
             console.log(`[Group] onNewMessage: group=${groupId} msgId=${latestMsgId} sender=${sender} preview=${preview}`);
-            // 收到新消息通知时，主动拉取并存储到本地
-            instance.agentCP.pullAndStoreGroupMessages(groupId, 20).catch(e => {
-                console.error(`[Group] auto-pull messages failed for group=${groupId}:`, e);
+            // 通知浏览器有新消息（轻量通知，前端可据此决定是否刷新）
+            broadcastToBrowser({
+                type: 'new_message_notify',
+                group_id: groupId,
+                latest_msg_id: latestMsgId,
+                sender,
+                preview,
             });
         },
         onNewEvent(groupId, latestEventId, eventType, summary) {
             console.log(`[Group] onNewEvent: group=${groupId} eventId=${latestEventId} type=${eventType} summary=${summary}`);
+            broadcastToBrowser({
+                type: 'new_event',
+                group_id: groupId,
+                latest_event_id: latestEventId,
+                event_type: eventType,
+                summary,
+            });
         },
         onGroupInvite(groupId, groupAddress, invitedBy) {
             console.log(`[Group] onGroupInvite: group=${groupId} address=${groupAddress} invitedBy=${invitedBy}`);
+            broadcastToBrowser({
+                type: 'group_invite',
+                group_id: groupId,
+                group_address: groupAddress,
+                invited_by: invitedBy,
+            });
         },
         onJoinApproved(groupId, groupAddress) {
             console.log(`[Group] onJoinApproved: group=${groupId} address=${groupAddress}`);
@@ -257,25 +306,71 @@ async function ensureGroupClient(instance) {
                     instance.agentCP.addGroupToStore(groupId, groupName);
                     const groupUrl = groupAddress || `https://${instance.groupTargetAid}/${groupId}`;
                     await instance.agentCP.registerGroupToHomeAP(groupId, groupUrl);
+                    // 新加入的群也立即注册在线
+                    await instance.agentCP.joinGroupSession(groupId);
                 }
                 catch (e) {
                     console.error(`[Group] onJoinApproved processing failed: group=${groupId}`, e.message);
                 }
             })();
+            broadcastToBrowser({
+                type: 'join_approved',
+                group_id: groupId,
+                group_address: groupAddress,
+            });
         },
         onJoinRejected(groupId, reason) {
             console.log(`[Group] onJoinRejected: group=${groupId} reason=${reason}`);
+            broadcastToBrowser({ type: 'join_rejected', group_id: groupId, reason });
         },
         onJoinRequestReceived(groupId, agentId, message) {
             console.log(`[Group] onJoinRequestReceived: group=${groupId} agent=${agentId} msg=${message}`);
+            broadcastToBrowser({ type: 'join_request', group_id: groupId, agent_id: agentId, message });
         },
         onGroupMessage(groupId, msg) {
+            var _a;
             console.log(`[Group] onGroupMessage: group=${groupId} msgId=${msg.msg_id} sender=${msg.sender}`);
+            // 存储消息到本地 + 自动 ACK
+            instance.agentCP.addGroupMessageToStore(groupId, msg);
+            (_a = instance.agentCP.groupOps) === null || _a === void 0 ? void 0 : _a.ackMessages(instance.groupTargetAid, groupId, msg.msg_id).catch(e => {
+                console.warn(`[Group] auto ack failed: group=${groupId} msgId=${msg.msg_id}`, e.message || e);
+            });
+            // 推送给浏览器
+            broadcastToBrowser({
+                type: 'group_message',
+                group_id: groupId,
+                message: msg,
+            });
         },
         onGroupEvent(groupId, evt) {
             console.log(`[Group] onGroupEvent: group=${groupId} event=${evt.event_type}`);
+            broadcastToBrowser({
+                type: 'group_event',
+                group_id: groupId,
+                event: evt,
+            });
         },
     });
+    // 同步群组列表（如未同步过）
+    if (!instance.groupListSynced) {
+        try {
+            await instance.agentCP.syncGroupList();
+            instance.groupListSynced = true;
+        }
+        catch (e) {
+            console.warn('[Group] syncGroupList error:', e.message);
+        }
+    }
+    // 为所有已加入群组注册上线（register_online + 拉取未读 + 启动心跳）
+    const groups = instance.agentCP.getLocalGroupList();
+    for (const group of groups) {
+        try {
+            await instance.agentCP.joinGroupSession(group.group_id);
+        }
+        catch (e) {
+            console.warn(`[Group] joinGroupSession failed: ${group.group_id}`, e.message);
+        }
+    }
     instance.groupInitialized = true;
     instance.groupSessionId = groupSessionId;
     instance.groupTargetAid = targetAid;
@@ -840,8 +935,9 @@ const chatHtml = `<!DOCTYPE html>
         .modal-overlay.show { display:flex; }
         .modal { background:#fff; width:90%; max-width:400px; border-radius:12px; padding:24px; box-shadow:0 10px 25px rgba(0,0,0,0.1); }
         .modal h3 { margin-bottom:16px; font-size:16px; }
-        .modal input { width:100%; padding:10px; border:1px solid var(--border); border-radius:8px; margin-bottom:16px; font-size:14px; }
-        .modal input:focus { outline:none; border-color:var(--primary); }
+        .modal input[type="text"], .modal input[type="password"], .modal input[type="url"] { width:100%; padding:10px; border:1px solid var(--border); border-radius:8px; margin-bottom:16px; font-size:14px; box-sizing:border-box; }
+        .modal input[type="text"]:focus, .modal input[type="password"]:focus, .modal input[type="url"]:focus { outline:none; border-color:var(--primary); }
+        .modal input[type="radio"] { width:auto; margin:0; }
         .modal-btns { display:flex; justify-content:flex-end; gap:10px; }
         .mbtn { padding:8px 16px; border-radius:6px; font-size:13px; cursor:pointer; border:none; }
         .mbtn-cancel { background:#f3f4f6; color:var(--t1); }
@@ -992,7 +1088,15 @@ const chatHtml = `<!DOCTYPE html>
     <div class="modal-overlay" id="createGroupModal">
         <div class="modal">
             <h3>创建群组</h3>
-            <input type="text" id="groupNameInput" placeholder="输入群组名称" onkeypress="if(event.key==='Enter')doCreateGroup()">
+            <input type="text" id="groupNameInput" placeholder="输入群组名称">
+            <textarea id="groupDescInput" placeholder="输入群组描述（可选）" style="width:100%;padding:10px;border:1px solid var(--border);border-radius:8px;margin-bottom:16px;font-size:14px;resize:vertical;min-height:60px;font-family:inherit;"></textarea>
+            <div style="margin-bottom:16px;">
+                <label style="font-size:13px;color:var(--t2);margin-bottom:8px;display:block;">群组类型</label>
+                <div style="display:flex;gap:12px;">
+                    <label style="display:flex;align-items:center;gap:6px;cursor:pointer;font-size:14px;"><input type="radio" name="groupVisibility" value="public" checked> 公开群</label>
+                    <label style="display:flex;align-items:center;gap:6px;cursor:pointer;font-size:14px;"><input type="radio" name="groupVisibility" value="private"> 私密群</label>
+                </div>
+            </div>
             <div class="modal-btns">
                 <button class="mbtn mbtn-cancel" onclick="hideCreateGroupModal()">取消</button>
                 <button class="mbtn mbtn-ok" id="createGroupBtn" onclick="doCreateGroup()">创建</button>
@@ -1095,6 +1199,8 @@ const chatHtml = `<!DOCTYPE html>
                     // 填充 AID 切换下拉
                     S.aidList=d.aidStatus||[];
                     renderAidSelect();
+                    // 初始加载一次ws状态，后续通过WebSocket推送更新
+                    fetch('/api/ws/status').then(function(r){return r.json();}).then(function(d){updateDot(d.status);}).catch(function(){});
                     poll(); setInterval(poll,1000);
                 } else { window.location.href='/'; }
             } catch(e){ console.error(e); }
@@ -1143,18 +1249,12 @@ const chatHtml = `<!DOCTYPE html>
                 } else {
                     await fetch('/api/ws/start',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({aid:S.aid})});
                 }
-                var r=await fetch('/api/aid'); var d=await r.json();
-                S.aidList=d.aidStatus||[];
-                renderAidSelect();
+                // AID 状态变更通过 WS 推送 aid_status 自动更新，无需再拉取
             } catch(e){}
         }
 
-        var _pollCount=0;
         async function poll(){
             try {
-                var wr=await fetch('/api/ws/status');
-                var wd=await wr.json();
-                updateDot(wd.status);
                 // P2P会话和消息仅在P2P标签页时刷新
                 if(S.tab==='p2p'){
                     var [sr,mr] = await Promise.all([fetch('/api/sessions'),fetch('/api/messages')]);
@@ -1163,12 +1263,6 @@ const chatHtml = `<!DOCTYPE html>
                     S.closed=md.closed||false;
                     if(md.messages) renderMsgs(md.messages, S.closed);
                 }
-                // 每5次轮询刷新一次AID在线状态
-                if(++_pollCount%5===0){
-                    var ar=await fetch('/api/aid'); var ad=await ar.json();
-                    S.aidList=ad.aidStatus||[];
-                    renderAidSelect();
-                }
             } catch(e){}
         }
 
@@ -1212,7 +1306,7 @@ const chatHtml = `<!DOCTYPE html>
                 html+='<div class="aid-group-sessions'+(isOpen?' open':'')+'">';
                 list.forEach(function(s){
                     var active=s.sessionId===S.sid;
-                    var time=new Date(s.lastMessageAt).toLocaleTimeString([],{hour:'2-digit',minute:'2-digit'});
+                    var time=fmtTime(s.lastMessageAt);
                     var tc=s.type==='outgoing'?'outgoing':'incoming';
                     var tt=s.type==='outgoing'?'OUT':'IN';
                     var name=s.lastMessage||'';
@@ -1278,7 +1372,7 @@ const chatHtml = `<!DOCTYPE html>
                     });
                 }
                 var avatarSrc = getAvatarSrc(info ? info.type : '');
-                var t=new Date(m.timestamp).toLocaleTimeString([],{hour:'2-digit',minute:'2-digit'});
+                var t=fmtTime(m.timestamp);
                 var c=(typeof marked!=='undefined'&&marked.parse)?marked.parse(m.content):escH(m.content);
                 var name = (info && info.name) ? info.name : sender;
 
@@ -1327,7 +1421,18 @@ const chatHtml = `<!DOCTYPE html>
                     var r=await fetch('/api/group/send',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({groupId:S.activeGroupId,message:txt})});
                     var d=await r.json();
                     if(!d.success) alert(d.error||'发送失败');
-                    else pollGroupMessages();
+                    else {
+                        // 发送成功：立即追加到本地显示（服务端已存储，不用等 WS 推送）
+                        if(d.msg_id){
+                            var sentMsg={msg_id:d.msg_id,sender:S.aid,content:txt,content_type:'text',timestamp:d.timestamp||Date.now()};
+                            var exists=_lastGroupMsgs.some(function(m){ return m.msg_id===sentMsg.msg_id; });
+                            if(!exists){
+                                _lastGroupMsgs.push(sentMsg);
+                                _lastGroupMsgSig='';
+                                renderGroupMsgs(_lastGroupMsgs);
+                            }
+                        }
+                    }
                 } catch(e){ alert('发送失败'); }
                 return;
             }
@@ -1374,6 +1479,21 @@ const chatHtml = `<!DOCTYPE html>
 
         function escH(t){ var d=document.createElement('div'); d.textContent=t; return d.innerHTML; }
         function escA(t){ return t.replace(/\\\\/g,'\\\\\\\\').replace(/'/g,"\\\\'"); }
+        function fmtTime(ts){
+            if(!ts) return '';
+            var n=Number(ts);
+            if(isNaN(n)) return '';
+            if(n<1e12) n=n*1000;
+            var d=new Date(n);
+            if(isNaN(d.getTime())) return '';
+            var now=new Date();
+            var pad=function(v){ return v<10?'0'+v:''+v; };
+            var H=pad(d.getHours()), M=pad(d.getMinutes()), ss=pad(d.getSeconds());
+            if(d.getFullYear()===now.getFullYear()&&d.getMonth()===now.getMonth()&&d.getDate()===now.getDate()){
+                return H+':'+M+':'+ss;
+            }
+            return d.getFullYear()+'/'+pad(d.getMonth()+1)+'/'+pad(d.getDate())+' '+H+':'+M+':'+ss;
+        }
 
         // ============================================================
         // Group Functions
@@ -1491,6 +1611,76 @@ const chatHtml = `<!DOCTYPE html>
             } catch(e){}
         }
 
+        // ============================================================
+        // WebSocket: real-time group message push
+        // ============================================================
+        var _groupWs=null;
+        var _groupWsReconnectTimer=null;
+
+        function connectGroupWs(){
+            if(_groupWs&&(_groupWs.readyState===WebSocket.OPEN||_groupWs.readyState===WebSocket.CONNECTING)) return;
+            var proto=location.protocol==='https:'?'wss:':'ws:';
+            _groupWs=new WebSocket(proto+'//'+location.host+'/ws/group');
+            _groupWs.onopen=function(){
+                console.log('[WS] group connected');
+                if(_groupWsReconnectTimer){ clearTimeout(_groupWsReconnectTimer); _groupWsReconnectTimer=null; }
+                // 重连后主动拉取最新状态，防止断连期间丢失推送
+                fetch('/api/ws/status').then(function(r){return r.json();}).then(function(d){updateDot(d.status);}).catch(function(){});
+                fetch('/api/aid').then(function(r){return r.json();}).then(function(d){if(d.aidStatus){S.aidList=d.aidStatus;renderAidSelect();}}).catch(function(){});
+            };
+            _groupWs.onmessage=function(ev){
+                try {
+                    var data=JSON.parse(ev.data);
+                    handleGroupWsMessage(data);
+                } catch(e){ console.error('[WS] parse error',e); }
+            };
+            _groupWs.onclose=function(){
+                console.log('[WS] group disconnected, reconnecting in 3s...');
+                _groupWs=null;
+                _groupWsReconnectTimer=setTimeout(connectGroupWs,3000);
+            };
+            _groupWs.onerror=function(e){
+                console.error('[WS] group error',e);
+            };
+        }
+
+        function handleGroupWsMessage(data){
+            if(data.type==='ws_status'){
+                if(!data.aid||data.aid===S.aid) updateDot(data.status);
+                return;
+            }
+            if(data.type==='aid_status'){
+                S.aidList=data.aidStatus||[];
+                renderAidSelect();
+                return;
+            }
+            if(data.type==='group_message'){
+                // 实时推送的完整消息
+                var msg=data.message;
+                var gid=data.group_id;
+                if(gid===S.activeGroupId&&S.tab==='group'){
+                    // 追加到当前消息列表并重新渲染
+                    var exists=_lastGroupMsgs.some(function(m){ return m.msg_id===msg.msg_id; });
+                    if(!exists){
+                        _lastGroupMsgs.push(msg);
+                        _lastGroupMsgSig=''; // 强制重新渲染
+                        renderGroupMsgs(_lastGroupMsgs);
+                    }
+                }
+            } else if(data.type==='new_message_notify'){
+                // 轻量通知：如果是当前活跃群组，拉取最新消息（本地读取，很快）
+                if(data.group_id===S.activeGroupId&&S.tab==='group'){
+                    pollGroupMessages();
+                }
+            } else if(data.type==='join_approved'||data.type==='group_invite'){
+                // 群组变动，刷新群组列表
+                pollGroupList();
+            }
+        }
+
+        // 启动 WebSocket 连接
+        connectGroupWs();
+
         var _lastGroupMsgs=[];
         function renderGroupMsgs(msgs){
             var sig=msgs.length+(msgs.length>0?(msgs[msgs.length-1].msg_id||0):'');
@@ -1508,7 +1698,8 @@ const chatHtml = `<!DOCTYPE html>
                 var info=agentInfoCache[sender];
                 if(!info){ needFetch.push(sender); }
                 var avatarSrc=getAvatarSrc(info?info.type:'');
-                var t=m.timestamp?new Date(m.timestamp*1000).toLocaleTimeString([],{hour:'2-digit',minute:'2-digit'}):'';
+                var t=m.timestamp?fmtTime(m.timestamp):'';
+
                 var c=(typeof marked!=='undefined'&&marked.parse)?marked.parse(m.content||''):escH(m.content||'');
                 var name=(info&&info.name)?info.name:sender;
                 return '<div class="message '+(sent?'sent':'received')+'">' +
@@ -1532,7 +1723,7 @@ const chatHtml = `<!DOCTYPE html>
         }
 
         // Group modals
-        function showCreateGroupModal(){ $('createGroupModal').classList.add('show'); $('groupNameInput').value=''; $('groupNameInput').focus(); }
+        function showCreateGroupModal(){ $('createGroupModal').classList.add('show'); $('groupNameInput').value=''; $('groupDescInput').value=''; document.querySelector('input[name="groupVisibility"][value="public"]').checked=true; $('groupNameInput').focus(); }
         function hideCreateGroupModal(){ $('createGroupModal').classList.remove('show'); }
         function showJoinGroupModal(){ $('joinGroupModal').classList.add('show'); $('joinGroupUrlInput').value=''; $('joinGroupUrlInput').focus(); }
         function hideJoinGroupModal(){ $('joinGroupModal').classList.remove('show'); }
@@ -1541,10 +1732,12 @@ const chatHtml = `<!DOCTYPE html>
         async function doCreateGroup(){
             var name=$('groupNameInput').value.trim();
             if(!name) return;
+            var description=$('groupDescInput').value.trim();
+            var visibility=document.querySelector('input[name="groupVisibility"]:checked').value;
             var btn=$('createGroupBtn');
             btn.disabled=true; btn.textContent='创建中...';
             try {
-                var r=await fetch('/api/group/create',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({name:name})});
+                var r=await fetch('/api/group/create',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({name:name,visibility:visibility,description:description||undefined})});
                 var d=await r.json();
                 if(d.success){
                     hideCreateGroupModal();
@@ -1744,7 +1937,7 @@ const chatHtml = `<!DOCTYPE html>
                     var html=d.requests.map(function(req){
                         var aid=req.agent_id||'';
                         var msg=req.message?escH(req.message):'';
-                        var time=req.created_at?new Date(req.created_at*1000).toLocaleString():'';
+                        var time=req.created_at?fmtTime(req.created_at):'';
                         var cachedInfo=agentInfoCache[aid];
                         var avatarSrc=getAvatarSrc(cachedInfo?cachedInfo.type:'');
                         var displayName=(cachedInfo&&cachedInfo.name)?cachedInfo.name:aid;
@@ -1849,12 +2042,8 @@ const chatHtml = `<!DOCTYPE html>
             } catch(e){ $('myGroupsContent').innerHTML='<div style="text-align:center;padding:20px;color:#e74c3c;">请求失败: '+escH(e.message)+'</div>'; }
         }
 
-        // 扩展轮询：群组模式下也轮询群消息
-        var _origPoll=poll;
-        poll=async function(){
-            await _origPoll();
-            if(S.tab==='group'&&S.activeGroupId) pollGroupMessages();
-        };
+        // 扩展轮询：保留 P2P 等基础轮询，群组消息已通过 WebSocket 实时推送
+        // 不再每秒轮询群消息
 
         init();
     <\/script>
@@ -1998,6 +2187,13 @@ async function handleRequest(req, res) {
                 // 切换会话：保存旧 AID 的会话，加载新 AID 的会话
                 await getMessageStoreForAid(aid).loadSessionsForAid(aid);
                 activeSessionId = null;
+                // 切换身份时自动上线（含群组初始化），A/B 同时保持在线
+                try {
+                    await ensureOnline(aid);
+                }
+                catch (e) {
+                    console.warn(`[Select] AID ${aid} 自动上线失败:`, e.message);
+                }
                 sendJson(res, { success: true, aid });
             }
             else {
@@ -2091,6 +2287,20 @@ async function handleRequest(req, res) {
                 sendJson(res, { success: false, error: '该 AID 未上线' });
                 return;
             }
+            if (instance.groupInitialized) {
+                try {
+                    await instance.agentCP.leaveAllGroupSessions();
+                }
+                catch (e) {
+                    console.warn(`[Group] leaveAllGroupSessions error:`, e.message);
+                }
+                try {
+                    await instance.agentCP.closeGroupMessageStore();
+                }
+                catch (e) {
+                    console.warn(`[Group] closeGroupMessageStore error:`, e.message);
+                }
+            }
             if (instance.heartbeatClient) {
                 instance.heartbeatClient.offline();
             }
@@ -2099,6 +2309,10 @@ async function handleRequest(req, res) {
             }
             aidInstances.delete(aid);
             console.log(`[Server] AID ${aid} 已下线`);
+            // 下线后推送 AID 状态变更到前端
+            getAidStatusList().then(aidStatus => {
+                broadcastToBrowser({ type: 'aid_status', aidStatus });
+            }).catch(() => { });
             sendJson(res, { success: true, aid });
         }
         catch (e) {
@@ -2300,7 +2514,7 @@ async function handleRequest(req, res) {
     if (pathname === '/api/group/create' && method === 'POST') {
         try {
             const body = await parseBody(req);
-            const { name } = body;
+            const { name, visibility, description } = body;
             if (!name) {
                 sendJson(res, { success: false, error: '群组名称不能为空' });
                 return;
@@ -2309,7 +2523,12 @@ async function handleRequest(req, res) {
             await ensureGroupClient(instance);
             const ops = instance.agentCP.groupOps;
             const target = instance.groupTargetAid;
-            const result = await ops.createGroup(target, name, body.options);
+            const options = Object.assign({}, (body.options || {}));
+            if (visibility)
+                options.visibility = visibility;
+            if (description)
+                options.description = description;
+            const result = await ops.createGroup(target, name, options);
             console.log('[ACP] createGroup 返回:', JSON.stringify(result, null, 2));
             // 加入本地存储
             instance.agentCP.addGroupToStore(result.group_id, name);
@@ -2407,8 +2626,9 @@ async function handleRequest(req, res) {
                 return;
             }
             await ensureGroupClient(instance);
-            // 从服务端拉取新消息并合并到本地存储
-            const messages = await instance.agentCP.pullAndStoreGroupMessages(groupId, 50);
+            // 只读本地缓存，不再每次请求都去服务端拉取
+            // 新消息通过 WebSocket 推送实时到达并由 SDK 自动存储
+            const messages = instance.agentCP.getLocalGroupMessages(groupId);
             sendJson(res, { success: true, messages });
         }
         catch (e) {
@@ -2617,6 +2837,28 @@ function startServer(port, apiUrl, dataDir = '') {
         }
     }).catch(() => { });
     const server = http.createServer(handleRequest);
+    // WebSocket server for browser ↔ server real-time communication
+    const wss = new ws_1.default.Server({ noServer: true });
+    server.on('upgrade', (req, socket, head) => {
+        const pathname = url.parse(req.url || '', true).pathname;
+        if (pathname === '/ws/group') {
+            wss.handleUpgrade(req, socket, head, (ws) => {
+                browserWsClients.add(ws);
+                console.log(`[WS] browser client connected, total=${browserWsClients.size}`);
+                ws.on('close', () => {
+                    browserWsClients.delete(ws);
+                    console.log(`[WS] browser client disconnected, total=${browserWsClients.size}`);
+                });
+                ws.on('error', (err) => {
+                    console.error('[WS] browser client error:', err.message);
+                    browserWsClients.delete(ws);
+                });
+            });
+        }
+        else {
+            socket.destroy();
+        }
+    });
     // 资源清理函数
     const cleanup = async () => {
         console.log('\n正在关闭服务...');
@@ -2634,6 +2876,20 @@ function startServer(port, apiUrl, dataDir = '') {
         }
         for (const [aid, instance] of aidInstances) {
             console.log(`[Server] 清理 AID: ${aid}`);
+            if (instance.groupInitialized) {
+                try {
+                    await instance.agentCP.leaveAllGroupSessions();
+                }
+                catch (e) {
+                    console.warn(`[Server] leaveAllGroupSessions error:`, e.message);
+                }
+                try {
+                    await instance.agentCP.closeGroupMessageStore();
+                }
+                catch (e) {
+                    console.warn(`[Server] closeGroupMessageStore error:`, e.message);
+                }
+            }
             if (instance.heartbeatClient) {
                 instance.heartbeatClient.offline();
             }
@@ -2642,6 +2898,12 @@ function startServer(port, apiUrl, dataDir = '') {
             }
         }
         aidInstances.clear();
+        // 关闭所有浏览器 WS 连接
+        for (const client of browserWsClients) {
+            client.close();
+        }
+        browserWsClients.clear();
+        wss.close();
         server.close(() => {
             console.log('服务已关闭');
             process.exit(0);

package/dist/websocket.js

@@ -409,16 +409,11 @@ class WSClient {
         const { cmd, data } = message;
         // Raw message interception: allow group protocol routing etc.
         if (cmd === "session_message" && this.rawMessageCallback) {
-            // console.log(`[WS] handleMessage: cmd=session_message, sender=${(data as any)?.sender}, has rawMessageCallback=true`);
             const intercepted = this.rawMessageCallback(message);
-            // console.log(`[WS] rawMessageCallback returned: ${intercepted}`);
             if (intercepted) {
                 return; // intercepted
             }
         }
-        else if (cmd === "session_message") {
-            // console.log(`[WS] handleMessage: cmd=session_message, sender=${(data as any)?.sender}, has rawMessageCallback=false (no interceptor registered!)`);
-        }
         if (cmd === "create_session_ack") {
             const { session_id, identifying_code } = data;
             this.emitter.emit('session', {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acp-ts",
-  "version": "1.1.7",
+  "version": "1.1.9",
   "description": "基于 ACP智能体通信协议 的智能体通信库，提供智能体身份管理和实时通信功能",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",