acp-ts 1.1.9 → 1.2.1

package/dist/agentcp.d.ts

@@ -1,7 +1,7 @@
 import { IAgentCP, IAgentIdentity } from "./interfaces";
 import { MessageStore } from "./messagestore";
 import { AgentMdOptions } from "./agentmd";
-import { ACPGroupClient, GroupOperations, ACPGroupEventHandler, CursorStore, GroupMessageStore, GroupMessage } from "./group";
+import { ACPGroupClient, GroupOperations, ACPGroupEventHandler, CursorStore, GroupMessageStore, GroupMessage, GroupMessageBatch } from "./group";
 declare class AgentCP implements IAgentCP {
     private seedPassword;
     private apUrl;
@@ -90,15 +90,20 @@ declare class AgentCP implements IAgentCP {
     setGroupEventHandler(handler: ACPGroupEventHandler): void;
     /**
      * 创建默认的群组事件处理器。
-     * - onGroupMessage: 自动存储消息到 GroupMessageStore + 自动 ACK
+     * - onGroupMessageBatch: 自动存储消息 + watermark ACK
      * - onJoinApproved: 自动注册到 Home AP + 存储群组
      * 外部可通过 setGroupEventHandler 覆盖。
      */
     private _createDefaultGroupEventHandler;
     /**
-     * 自动 ACK 消息（SDK 内部行为，对上层透明）
+     * 处理批量推送消息：排序、存储、ACK 最后一条。
+     * 返回排序后的消息列表，供上层使用（如推送给浏览器）。
      */
-    private _autoAckMessage;
+    processAndAckBatch(groupId: string, batch: GroupMessageBatch): Promise<GroupMessage[]>;
+    /**
+     * 异步 ACK 消息（不阻塞调用方）
+     */
+    private _ackMessage;
     /**
      * 设置群组游标存储
      */
@@ -142,10 +147,6 @@ declare class AgentCP implements IAgentCP {
      * 添加群组到本地存储
      */
     addGroupToStore(groupId: string, name: string): void;
-    /**
-     * 将加入的群组注册到 Home AP（内部方法）
-     */
-    registerGroupToHomeAP(groupId: string, groupUrl: string, role?: string): Promise<void>;
     /**
      * 从本地存储删除群组
      */
@@ -157,11 +158,11 @@ declare class AgentCP implements IAgentCP {
     /**
      * 添加群消息到本地存储
      */
-    addGroupMessageToStore(groupId: string, msg: GroupMessage): void;
+    addGroupMessageToStore(groupId: string, msg: GroupMessage): Promise<void>;
     /**
      * 批量添加群消息到本地存储
      */
-    addGroupMessagesToStore(groupId: string, msgs: GroupMessage[]): void;
+    addGroupMessagesToStore(groupId: string, msgs: GroupMessage[]): Promise<void>;
     /**
      * 获取本地存储中群组的最新消息ID（用于增量拉取）
      */

package/dist/agentcp.js

@@ -61,7 +61,7 @@ class AgentCP {
         this.groupMessageStore = null;
         this._groupTargetAid = '';
         this._groupSessionId = '';
-        this._persistGroupMessages = false;
+        this._persistGroupMessages = true;
         // Group lifecycle management
         this._onlineGroups = new Set();
         this._heartbeatTimer = null;
@@ -80,7 +80,7 @@ class AgentCP {
         this._basePath = basePath || process.cwd();
         this.apUrl = `${baseUrl}/api/accesspoint`;
         this.msgUrl = `${baseUrl}/api/message`;
-        this._persistGroupMessages = (_a = options === null || options === void 0 ? void 0 : options.persistGroupMessages) !== null && _a !== void 0 ? _a : false;
+        this._persistGroupMessages = (_a = options === null || options === void 0 ? void 0 : options.persistGroupMessages) !== null && _a !== void 0 ? _a : true;
         this._messageStore = new messagestore_1.MessageStore({
             persistMessages: (_b = options === null || options === void 0 ? void 0 : options.persistMessages) !== null && _b !== void 0 ? _b : false,
             basePath: this._basePath,
@@ -401,7 +401,7 @@ class AgentCP {
     }
     /**
      * 创建默认的群组事件处理器。
-     * - onGroupMessage: 自动存储消息到 GroupMessageStore + 自动 ACK
+     * - onGroupMessageBatch: 自动存储消息 + watermark ACK
      * - onJoinApproved: 自动注册到 Home AP + 存储群组
      * 外部可通过 setGroupEventHandler 覆盖。
      */
@@ -431,8 +431,6 @@ class AgentCP {
                         }
                         catch (_) { }
                         this.addGroupToStore(groupId, groupName);
-                        const groupUrl = groupAddress || `https://${this._groupTargetAid}/${groupId}`;
-                        await this.registerGroupToHomeAP(groupId, groupUrl);
                     }
                     catch (e) {
                         console.error(`[Group][DefaultHandler] onJoinApproved processing failed: group=${groupId}`, e.message);
@@ -445,12 +443,11 @@ class AgentCP {
             onJoinRequestReceived(groupId, agentId, message) {
                 console.log(`[Group][DefaultHandler] onJoinRequestReceived: group=${groupId} agent=${agentId}`);
             },
-            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);
+            onGroupMessageBatch: (groupId, batch) => {
+                console.log(`[Group][DefaultHandler] onGroupMessageBatch: group=${groupId} count=${batch.count} range=[${batch.start_msg_id}, ${batch.latest_msg_id}]`);
+                this.processAndAckBatch(groupId, batch).catch(e => {
+                    console.error(`[Group][DefaultHandler] processAndAckBatch failed: group=${groupId}`, e);
+                });
             },
             onGroupEvent(groupId, evt) {
                 console.log(`[Group][DefaultHandler] onGroupEvent: group=${groupId} event=${evt.event_type}`);
@@ -458,13 +455,27 @@ class AgentCP {
         };
     }
     /**
-     * 自动 ACK 消息（SDK 内部行为，对上层透明）
+     * 处理批量推送消息：排序、存储、ACK 最后一条。
+     * 返回排序后的消息列表，供上层使用（如推送给浏览器）。
+     */
+    async processAndAckBatch(groupId, batch) {
+        const sorted = [...batch.messages].sort((a, b) => a.msg_id - b.msg_id);
+        await this.addGroupMessagesToStore(groupId, sorted);
+        // ACK batch 中最后一条消息
+        if (sorted.length > 0) {
+            const lastMsgId = sorted[sorted.length - 1].msg_id;
+            this._ackMessage(groupId, lastMsgId);
+        }
+        return sorted;
+    }
+    /**
+     * 异步 ACK 消息（不阻塞调用方）
      */
-    _autoAckMessage(groupId, msgId) {
+    _ackMessage(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);
+            console.warn(`[Group] ack failed: group=${groupId} msgId=${msgId}`, e.message || e);
         });
     }
     /**
@@ -552,6 +563,17 @@ class AgentCP {
                 this.groupMessageStore.getOrCreateGroup(membership.group_id, this._groupTargetAid, name);
             }
         }
+        // 清理本地有但服务端已不存在的群组
+        if (this.groupMessageStore) {
+            const serverGroupIds = new Set(result.groups.map(g => g.group_id));
+            const localGroups = this.groupMessageStore.getGroupList();
+            for (const local of localGroups) {
+                if (!serverGroupIds.has(local.groupId)) {
+                    await this.groupMessageStore.deleteGroup(local.groupId);
+                    console.log(`[Group] syncGroupList: 清理本地已退出群组 ${local.groupId}`);
+                }
+            }
+        }
         return groups;
     }
     /**
@@ -574,20 +596,6 @@ class AgentCP {
             return;
         this.groupMessageStore.getOrCreateGroup(groupId, this._groupTargetAid, name);
     }
-    /**
-     * 将加入的群组注册到 Home AP（内部方法）
-     */
-    async registerGroupToHomeAP(groupId, groupUrl, role = 'member') {
-        if (!this.groupOps || !this._groupTargetAid)
-            return;
-        try {
-            await this.groupOps.registerMembership(this._groupTargetAid, groupId, groupUrl, this._groupTargetAid, this._groupSessionId, role);
-            console.log(`[Group] registerGroupToHomeAP success: group=${groupId}`);
-        }
-        catch (e) {
-            console.error(`[Group] registerGroupToHomeAP failed: group=${groupId}`, e.message);
-        }
-    }
     /**
      * 从本地存储删除群组
      */
@@ -610,18 +618,18 @@ class AgentCP {
     /**
      * 添加群消息到本地存储
      */
-    addGroupMessageToStore(groupId, msg) {
+    async addGroupMessageToStore(groupId, msg) {
         if (!this.groupMessageStore)
             return;
-        this.groupMessageStore.addMessage(groupId, msg);
+        await this.groupMessageStore.addMessage(groupId, msg);
     }
     /**
      * 批量添加群消息到本地存储
      */
-    addGroupMessagesToStore(groupId, msgs) {
+    async addGroupMessagesToStore(groupId, msgs) {
         if (!this.groupMessageStore)
             return;
-        this.groupMessageStore.addMessages(groupId, msgs);
+        await this.groupMessageStore.addMessages(groupId, msgs);
     }
     /**
      * 获取本地存储中群组的最新消息ID（用于增量拉取）
@@ -664,7 +672,7 @@ class AgentCP {
                         metadata: (_f = m.metadata) !== null && _f !== void 0 ? _f : null,
                     });
                 });
-                this.addGroupMessagesToStore(groupId, msgs);
+                await this.addGroupMessagesToStore(groupId, msgs);
                 // ACK 这批消息中的最后一条
                 const lastMsgId = msgs[msgs.length - 1].msg_id;
                 await this.groupOps.ackMessages(this._groupTargetAid, groupId, lastMsgId);
@@ -697,7 +705,15 @@ class AgentCP {
         await this.groupOps.registerOnline(this._groupTargetAid);
         this._onlineGroups.add(groupId);
         console.log(`[Group] joinGroupSession: group=${groupId}`);
-        // Step 2: 启动心跳定时器（首次加入群组时启动）
+        // Step 2: 冷启动同步 — 拉取历史消息对齐，再进入批推送接收
+        try {
+            const lastMsgId = this.getGroupLastMsgId(groupId);
+            await this.pullAndStoreGroupMessages(groupId, lastMsgId, 50);
+        }
+        catch (e) {
+            console.warn(`[Group] cold-start sync failed: group=${groupId}`, e.message || e);
+        }
+        // Step 3: 启动心跳定时器（首次加入群组时启动）
         this._ensureHeartbeat();
     }
     /**

package/dist/group/client.js

@@ -74,7 +74,7 @@ class ACPGroupClient {
      * Called by the message dispatch chain in AgentCP.
      */
     handleIncoming(payload) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
         let data;
         try {
             data = JSON.parse(payload);
@@ -116,31 +116,33 @@ 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
+        // Handle batch push from group.ap
         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 (action === types_1.ACTION_MESSAGE_BATCH_PUSH && data.data) {
+            const batchData = data.data;
+            const batch = {
+                messages: ((_e = batchData.messages) !== null && _e !== void 0 ? _e : []).map((m) => {
+                    var _a, _b, _c, _d, _e, _f;
+                    return ({
+                        msg_id: (_a = m.msg_id) !== null && _a !== void 0 ? _a : 0,
+                        sender: (_b = m.sender) !== null && _b !== void 0 ? _b : "",
+                        content: (_c = m.content) !== null && _c !== void 0 ? _c : "",
+                        content_type: (_d = m.content_type) !== null && _d !== void 0 ? _d : "text/plain",
+                        timestamp: (_e = m.timestamp) !== null && _e !== void 0 ? _e : 0,
+                        metadata: (_f = m.metadata) !== null && _f !== void 0 ? _f : null,
+                    });
+                }),
+                start_msg_id: (_f = batchData.start_msg_id) !== null && _f !== void 0 ? _f : 0,
+                latest_msg_id: (_g = batchData.latest_msg_id) !== null && _g !== void 0 ? _g : 0,
+                count: (_h = batchData.count) !== null && _h !== void 0 ? _h : 0,
             };
+            const groupId = (_j = data.group_id) !== null && _j !== void 0 ? _j : "";
+            console.log(`[GroupClient] message_batch_push: group=${groupId} count=${batch.count} range=[${batch.start_msg_id}, ${batch.latest_msg_id}]`);
             if (this._handler != null) {
-                (0, events_1.dispatchAcpNotify)(this._handler, notify);
+                this._handler.onGroupMessageBatch(groupId, batch);
             }
             else {
-                console.warn(`[GroupClient] !!! message_push dropped: no event handler registered.`);
+                console.warn(`[GroupClient] !!! message_batch_push dropped: no event handler registered.`);
             }
             return;
         }
@@ -158,7 +160,9 @@ class ACPGroupClient {
         this._pendingReqs.clear();
         if (this._cursorStore != null) {
             try {
-                this._cursorStore.close();
+                this._cursorStore.close().catch(e => {
+                    console.error("[ACPGroupClient] cursor store close error:", e);
+                });
             }
             catch (e) {
                 console.error("[ACPGroupClient] cursor store close error:", e);

package/dist/group/cursor_store.d.ts

@@ -10,8 +10,8 @@ export interface CursorStore {
     saveEventCursor(groupId: string, eventCursor: number): void;
     loadCursor(groupId: string): [number, number];
     removeCursor(groupId: string): void;
-    flush(): void;
-    close(): void;
+    flush(): Promise<void>;
+    close(): Promise<void>;
 }
 /**
  * In-memory + JSON file cursor store.
@@ -24,13 +24,18 @@ export declare class LocalCursorStore implements CursorStore {
     private _cursors;
     private _filePath;
     private _dirty;
+    private _flushTimer;
+    private _flushPromise;
+    private _loaded;
     constructor(filePath?: string);
+    init(): Promise<void>;
     saveMsgCursor(groupId: string, msgCursor: number): void;
     saveEventCursor(groupId: string, eventCursor: number): void;
     loadCursor(groupId: string): [number, number];
     removeCursor(groupId: string): void;
-    flush(): void;
-    close(): void;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+    private _flushDebounced;
     private _write;
     private _load;
 }

package/dist/group/cursor_store.js

@@ -17,9 +17,15 @@ class LocalCursorStore {
     constructor(filePath = "") {
         this._cursors = {};
         this._dirty = false;
+        this._flushTimer = null;
+        this._flushPromise = null;
+        this._loaded = false;
         this._filePath = filePath;
-        if (filePath && websocket_1.isNodeEnvironment) {
-            this._load();
+    }
+    async init() {
+        if (this._filePath && websocket_1.isNodeEnvironment && !this._loaded) {
+            await this._load();
+            this._loaded = true;
         }
     }
     saveMsgCursor(groupId, msgCursor) {
@@ -29,6 +35,7 @@ class LocalCursorStore {
         if (msgCursor > this._cursors[groupId].msg_cursor) {
             this._cursors[groupId].msg_cursor = msgCursor;
             this._dirty = true;
+            this._flushDebounced();
         }
     }
     saveEventCursor(groupId, eventCursor) {
@@ -38,6 +45,7 @@ class LocalCursorStore {
         if (eventCursor > this._cursors[groupId].event_cursor) {
             this._cursors[groupId].event_cursor = eventCursor;
             this._dirty = true;
+            this._flushDebounced();
         }
     }
     loadCursor(groupId) {
@@ -51,37 +59,58 @@ class LocalCursorStore {
         if (groupId in this._cursors) {
             delete this._cursors[groupId];
             this._dirty = true;
+            this._flushDebounced();
         }
     }
-    flush() {
+    async flush() {
         if (!this._filePath || !websocket_1.isNodeEnvironment) {
             return;
         }
         if (!this._dirty) {
             return;
         }
-        this._write();
+        await this._write();
+    }
+    async close() {
+        if (this._flushTimer) {
+            clearTimeout(this._flushTimer);
+            this._flushTimer = null;
+        }
+        await this.flush();
     }
-    close() {
-        this.flush();
+    _flushDebounced() {
+        if (this._flushTimer)
+            return;
+        this._flushTimer = setTimeout(async () => {
+            this._flushTimer = null;
+            try {
+                await this.flush();
+            }
+            catch (e) {
+                console.error('[CursorStore] debounced flush failed:', e);
+            }
+        }, 500);
     }
-    _write() {
+    async _write() {
         try {
             const fs = require('fs');
-            fs.writeFileSync(this._filePath, JSON.stringify(this._cursors, null, 2), 'utf-8');
+            const content = JSON.stringify(this._cursors, null, 2);
+            const tmpPath = this._filePath + '.tmp';
+            await fs.promises.writeFile(tmpPath, content, 'utf-8');
+            await fs.promises.rename(tmpPath, this._filePath);
             this._dirty = false;
         }
         catch (e) {
             console.error(`[CursorStore] write to ${this._filePath} failed:`, e);
         }
     }
-    _load() {
+    async _load() {
         try {
             const fs = require('fs');
             if (!fs.existsSync(this._filePath)) {
                 return;
             }
-            const content = fs.readFileSync(this._filePath, 'utf-8');
+            const content = await fs.promises.readFile(this._filePath, 'utf-8');
             if (content) {
                 this._cursors = JSON.parse(content);
             }

package/dist/group/events.d.ts

@@ -2,7 +2,7 @@
  * Group event handler interfaces and dispatch logic.
  * Mirrors Python SDK: agentcp/group/events.py
  */
-import { GroupNotify, GroupMessage, GroupEvent } from './types';
+import { GroupNotify, GroupEvent, GroupMessageBatch } from './types';
 /**
  * Abstract handler for ACP group notifications.
  */
@@ -13,7 +13,7 @@ export interface ACPGroupEventHandler {
     onJoinApproved(groupId: string, groupAddress: string): void;
     onJoinRejected(groupId: string, reason: string): void;
     onJoinRequestReceived(groupId: string, agentId: string, message: string): void;
-    onGroupMessage(groupId: string, msg: GroupMessage): void;
+    onGroupMessageBatch(groupId: string, batch: GroupMessageBatch): void;
     onGroupEvent(groupId: string, evt: GroupEvent): void;
 }
 /**

package/dist/group/events.js

@@ -38,9 +38,6 @@ function dispatchAcpNotify(handler, notify) {
         else if (event === types_1.NOTIFY_JOIN_REQUEST_RECEIVED) {
             handler.onJoinRequestReceived(gid, (_l = data.agent_id) !== null && _l !== void 0 ? _l : "", (_m = data.message) !== null && _m !== void 0 ? _m : "");
         }
-        else if (event === types_1.NOTIFY_GROUP_MESSAGE) {
-            handler.onGroupMessage(gid, data);
-        }
         else if (event === types_1.NOTIFY_GROUP_EVENT) {
             handler.onGroupEvent(gid, data);
         }

package/dist/group/index.d.ts

@@ -2,7 +2,7 @@
  * ACP Group Operations package.
  * Mirrors Python SDK: agentcp/group/__init__.py
  */
-export { GroupErrorCode, GroupError, GroupRequest, GroupResponse, GroupNotify, buildGroupRequest, groupRequestToJson, parseGroupResponse, parseGroupNotify, GroupMessage, GroupEvent, MsgCursor, EventCursor, CursorState, createMsgCursor, createEventCursor, CreateGroupResp, SendMessageResp, PullMessagesResp, PullEventsResp, GroupInfoResp, BanlistResp, BatchReviewResp, PendingRequestsResp, MembersResp, AdminsResp, RulesResp, AnnouncementResp, JoinRequirementsResp, MasterResp, InviteCodeResp, InviteCodeListResp, BroadcastLockResp, BroadcastPermissionResp, SyncStatusResp, SyncLogResp, ChecksumResp, PublicGroupInfoResp, SearchGroupsResp, DigestResp, MembershipInfo, ListMyGroupsResp, GetFileResp, GetSummaryResp, GetMetricsResp, NOTIFY_NEW_MESSAGE, NOTIFY_NEW_EVENT, NOTIFY_GROUP_INVITE, NOTIFY_JOIN_APPROVED, NOTIFY_JOIN_REJECTED, NOTIFY_JOIN_REQUEST_RECEIVED, NOTIFY_GROUP_MESSAGE, NOTIFY_GROUP_EVENT, EVENT_MEMBER_JOINED, EVENT_MEMBER_REMOVED, EVENT_MEMBER_LEFT, EVENT_MEMBER_BANNED, EVENT_META_UPDATED, EVENT_RULES_UPDATED, EVENT_ANNOUNCEMENT_UPDATED, EVENT_GROUP_DISSOLVED, EVENT_MASTER_TRANSFERRED, EVENT_GROUP_SUSPENDED, EVENT_GROUP_RESUMED, EVENT_MEMBER_UNBANNED, EVENT_JOIN_REQUIREMENTS_UPDATED, EVENT_INVITE_CODE_CREATED, EVENT_INVITE_CODE_REVOKED, } from './types';
+export { GroupErrorCode, GroupError, GroupRequest, GroupResponse, GroupNotify, buildGroupRequest, groupRequestToJson, parseGroupResponse, parseGroupNotify, GroupMessage, GroupEvent, MsgCursor, EventCursor, CursorState, createMsgCursor, createEventCursor, CreateGroupResp, SendMessageResp, PullMessagesResp, PullEventsResp, GroupInfoResp, BanlistResp, BatchReviewResp, PendingRequestsResp, MembersResp, AdminsResp, RulesResp, AnnouncementResp, JoinRequirementsResp, MasterResp, InviteCodeResp, InviteCodeListResp, BroadcastLockResp, BroadcastPermissionResp, SyncStatusResp, SyncLogResp, ChecksumResp, PublicGroupInfoResp, SearchGroupsResp, DigestResp, MembershipInfo, ListMyGroupsResp, GetFileResp, GetSummaryResp, GetMetricsResp, NOTIFY_NEW_MESSAGE, NOTIFY_NEW_EVENT, NOTIFY_GROUP_INVITE, NOTIFY_JOIN_APPROVED, NOTIFY_JOIN_REJECTED, NOTIFY_JOIN_REQUEST_RECEIVED, NOTIFY_GROUP_EVENT, EVENT_MEMBER_JOINED, EVENT_MEMBER_REMOVED, EVENT_MEMBER_LEFT, EVENT_MEMBER_BANNED, EVENT_META_UPDATED, EVENT_RULES_UPDATED, EVENT_ANNOUNCEMENT_UPDATED, EVENT_GROUP_DISSOLVED, EVENT_MASTER_TRANSFERRED, EVENT_GROUP_SUSPENDED, EVENT_GROUP_RESUMED, EVENT_MEMBER_UNBANNED, EVENT_JOIN_REQUIREMENTS_UPDATED, EVENT_INVITE_CODE_CREATED, EVENT_INVITE_CODE_REVOKED, ACTION_MESSAGE_BATCH_PUSH, GroupMessageBatch, } from './types';
 export { ACPGroupClient, SendFunc } from './client';
 export { GroupOperations, SyncHandler } from './operations';
 export { ACPGroupEventHandler, EventProcessor, dispatchAcpNotify, dispatchEvent, } from './events';

package/dist/group/index.js

@@ -4,7 +4,7 @@
  * Mirrors Python SDK: agentcp/group/__init__.py
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GroupMessageStore = exports.LocalCursorStore = exports.dispatchAcpNotify = exports.GroupOperations = exports.ACPGroupClient = 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.createEventCursor = exports.createMsgCursor = exports.parseGroupNotify = exports.parseGroupResponse = exports.groupRequestToJson = exports.buildGroupRequest = exports.GroupError = exports.GroupErrorCode = void 0;
+exports.GroupMessageStore = exports.LocalCursorStore = exports.dispatchAcpNotify = exports.GroupOperations = exports.ACPGroupClient = 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_JOIN_REQUEST_RECEIVED = exports.NOTIFY_JOIN_REJECTED = exports.NOTIFY_JOIN_APPROVED = exports.NOTIFY_GROUP_INVITE = exports.NOTIFY_NEW_EVENT = exports.NOTIFY_NEW_MESSAGE = exports.createEventCursor = exports.createMsgCursor = exports.parseGroupNotify = exports.parseGroupResponse = exports.groupRequestToJson = exports.buildGroupRequest = exports.GroupError = exports.GroupErrorCode = void 0;
 // Types
 var types_1 = require("./types");
 Object.defineProperty(exports, "GroupErrorCode", { enumerable: true, get: function () { return types_1.GroupErrorCode; } });
@@ -22,7 +22,6 @@ Object.defineProperty(exports, "NOTIFY_GROUP_INVITE", { enumerable: true, get: f
 Object.defineProperty(exports, "NOTIFY_JOIN_APPROVED", { enumerable: true, get: function () { return types_1.NOTIFY_JOIN_APPROVED; } });
 Object.defineProperty(exports, "NOTIFY_JOIN_REJECTED", { enumerable: true, get: function () { return types_1.NOTIFY_JOIN_REJECTED; } });
 Object.defineProperty(exports, "NOTIFY_JOIN_REQUEST_RECEIVED", { enumerable: true, get: function () { return types_1.NOTIFY_JOIN_REQUEST_RECEIVED; } });
-Object.defineProperty(exports, "NOTIFY_GROUP_MESSAGE", { enumerable: true, get: function () { return types_1.NOTIFY_GROUP_MESSAGE; } });
 Object.defineProperty(exports, "NOTIFY_GROUP_EVENT", { enumerable: true, get: function () { return types_1.NOTIFY_GROUP_EVENT; } });
 // Group event type constants
 Object.defineProperty(exports, "EVENT_MEMBER_JOINED", { enumerable: true, get: function () { return types_1.EVENT_MEMBER_JOINED; } });
@@ -40,6 +39,8 @@ Object.defineProperty(exports, "EVENT_MEMBER_UNBANNED", { enumerable: true, get:
 Object.defineProperty(exports, "EVENT_JOIN_REQUIREMENTS_UPDATED", { enumerable: true, get: function () { return types_1.EVENT_JOIN_REQUIREMENTS_UPDATED; } });
 Object.defineProperty(exports, "EVENT_INVITE_CODE_CREATED", { enumerable: true, get: function () { return types_1.EVENT_INVITE_CODE_CREATED; } });
 Object.defineProperty(exports, "EVENT_INVITE_CODE_REVOKED", { enumerable: true, get: function () { return types_1.EVENT_INVITE_CODE_REVOKED; } });
+// Batch push
+Object.defineProperty(exports, "ACTION_MESSAGE_BATCH_PUSH", { enumerable: true, get: function () { return types_1.ACTION_MESSAGE_BATCH_PUSH; } });
 // Client
 var client_1 = require("./client");
 Object.defineProperty(exports, "ACPGroupClient", { enumerable: true, get: function () { return client_1.ACPGroupClient; } });

package/dist/group/message_store.d.ts

@@ -27,6 +27,7 @@ export declare class GroupMessageStore {
     private maxEventsPerGroup;
     private groups;
     private _indexDirty;
+    private _flushIndexPromise;
     constructor(options: {
         persistMessages: boolean;
         basePath: string;
@@ -45,16 +46,16 @@ export declare class GroupMessageStore {
     getGroupList(): GroupRecord[];
     getGroup(groupId: string): GroupRecord | null;
     deleteGroup(groupId: string): Promise<boolean>;
-    addMessage(groupId: string, msg: GroupMessage): void;
-    addMessages(groupId: string, msgs: GroupMessage[]): void;
+    addMessage(groupId: string, msg: GroupMessage): Promise<void>;
+    addMessages(groupId: string, msgs: GroupMessage[]): Promise<void>;
     getMessages(groupId: string, options?: {
         afterMsgId?: number;
         beforeMsgId?: number;
         limit?: number;
     }): GroupMessage[];
     getLatestMessages(groupId: string, limit?: number): GroupMessage[];
-    addEvent(groupId: string, evt: GroupEvent): void;
-    addEvents(groupId: string, evts: GroupEvent[]): void;
+    addEvent(groupId: string, evt: GroupEvent): Promise<void>;
+    addEvents(groupId: string, evts: GroupEvent[]): Promise<void>;
     getEvents(groupId: string, options?: {
         afterEventId?: number;
         limit?: number;
@@ -63,7 +64,7 @@ export declare class GroupMessageStore {
     private writeJsonl;
     private flushMessages;
     private flushEvents;
-    private flushIndexAsync;
+    private flushIndexQueued;
     flushIndex(): Promise<void>;
     flush(ownerAid: string): Promise<void>;
     flushAll(): Promise<void>;