acp-ts 1.1.8 → 1.1.9

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, MsgCursor } from "./group";
+import { ACPGroupClient, GroupOperations, ACPGroupEventHandler, CursorStore, GroupMessageStore, GroupMessage } from "./group";
 declare class AgentCP implements IAgentCP {
     private seedPassword;
     private apUrl;
@@ -178,18 +178,15 @@ declare class AgentCP implements IAgentCP {
     pullAndStoreGroupMessages(groupId: string, afterMsgId?: number, limit?: number): Promise<GroupMessage[]>;
     /**
      * 加入群组会话（完整生命周期）：
-     * 1. register_online → 获取游标状态
-     * 2. 如果有未读消息 → 循环 pull_messages + ACK
+     * 1. register_online → 告知 group.ap 在线
+     * 2. 将群组加入在线列表
      * 3. 启动心跳定时器（首次时启动）
-     *
-     * @returns msg_cursor 游标状态
      */
-    joinGroupSession(groupId: string): Promise<MsgCursor>;
+    joinGroupSession(groupId: string): Promise<void>;
     /**
      * 离开群组会话（优雅退出）：
-     * 1. unregister_online
-     * 2. 从在线群组列表移除
-     * 3. 如果没有在线群组了，停止心跳定时器
+     * 1. 从在线群组列表移除
+     * 2. 如果没有在线群组了，unregister_online + 停止心跳定时器
      */
     leaveGroupSession(groupId: string): Promise<void>;
     /**
@@ -213,7 +210,7 @@ declare class AgentCP implements IAgentCP {
      */
     private _stopHeartbeat;
     /**
-     * 对所有在线群组发送心跳
+     * 发送心跳保活
      */
     private _sendHeartbeats;
     /**

package/dist/agentcp.js

@@ -685,47 +685,38 @@ class AgentCP {
     // ============================================================
     /**
      * 加入群组会话（完整生命周期）：
-     * 1. register_online → 获取游标状态
-     * 2. 如果有未读消息 → 循环 pull_messages + ACK
+     * 1. register_online → 告知 group.ap 在线
+     * 2. 将群组加入在线列表
      * 3. 启动心跳定时器（首次时启动）
-     *
-     * @returns msg_cursor 游标状态
      */
     async joinGroupSession(groupId) {
         if (!this.groupOps || !this._groupTargetAid) {
             throw new Error('群组客户端未初始化，请先调用 initGroupClient');
         }
-        // Step 1: register_online
-        const result = await this.groupOps.registerOnline(this._groupTargetAid, groupId);
-        const cursor = result.msg_cursor;
+        // Step 1: register_online（仅通知 group.ap 在线，不再返回游标）
+        await this.groupOps.registerOnline(this._groupTargetAid);
         this._onlineGroups.add(groupId);
-        console.log(`[Group] joinGroupSession: group=${groupId} unread=${cursor.unread_count} current=${cursor.current_msg_id} latest=${cursor.latest_msg_id}`);
-        // Step 2: 如果有未读消息，使用自动游标模式拉取
-        if (cursor.unread_count > 0) {
-            await this.pullAndStoreGroupMessages(groupId, 0, 0);
-        }
-        // Step 3: 启动心跳定时器（首次加入群组时启动）
+        console.log(`[Group] joinGroupSession: group=${groupId}`);
+        // Step 2: 启动心跳定时器（首次加入群组时启动）
         this._ensureHeartbeat();
-        return cursor;
     }
     /**
      * 离开群组会话（优雅退出）：
-     * 1. unregister_online
-     * 2. 从在线群组列表移除
-     * 3. 如果没有在线群组了，停止心跳定时器
+     * 1. 从在线群组列表移除
+     * 2. 如果没有在线群组了，unregister_online + 停止心跳定时器
      */
     async leaveGroupSession(groupId) {
         if (!this.groupOps || !this._groupTargetAid)
             return;
-        try {
-            await this.groupOps.unregisterOnline(this._groupTargetAid, groupId);
-        }
-        catch (e) {
-            console.warn(`[Group] unregisterOnline failed: group=${groupId}`, e.message || e);
-        }
         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();
         }
     }
@@ -779,16 +770,14 @@ class AgentCP {
         }
     }
     /**
-     * 对所有在线群组发送心跳
+     * 发送心跳保活
      */
     _sendHeartbeats() {
         if (!this.groupOps || !this._groupTargetAid)
             return;
-        for (const groupId of this._onlineGroups) {
-            this.groupOps.heartbeat(this._groupTargetAid, groupId).catch(e => {
-                console.warn(`[Group] heartbeat failed: group=${groupId}`, e.message || e);
-            });
-        }
+        this.groupOps.heartbeat(this._groupTargetAid).catch(e => {
+            console.warn(`[Group] heartbeat failed`, e.message || e);
+        });
     }
     /**
      * 关闭群消息存储，刷新所有未写入的数据

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, RegisterOnlineResp, 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_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 { ACPGroupClient, SendFunc } from './client';
 export { GroupOperations, SyncHandler } from './operations';
 export { ACPGroupEventHandler, EventProcessor, dispatchAcpNotify, dispatchEvent, } from './events';

package/dist/group/operations.d.ts

@@ -3,7 +3,7 @@
  * Mirrors Python SDK: agentcp/group/operations.py
  */
 import { ACPGroupClient } from './client';
-import { RegisterOnlineResp, CreateGroupResp, SendMessageResp, PullMessagesResp, PullEventsResp, CursorState, GroupInfoResp, BanlistResp, BatchReviewResp, PendingRequestsResp, MembersResp, AdminsResp, RulesResp, AnnouncementResp, JoinRequirementsResp, MasterResp, InviteCodeResp, InviteCodeListResp, BroadcastLockResp, BroadcastPermissionResp, SyncStatusResp, SyncLogResp, ChecksumResp, PublicGroupInfoResp, SearchGroupsResp, DigestResp, ListMyGroupsResp, GetFileResp, GetSummaryResp, GetMetricsResp } from './types';
+import { CreateGroupResp, SendMessageResp, PullMessagesResp, PullEventsResp, CursorState, GroupInfoResp, BanlistResp, BatchReviewResp, PendingRequestsResp, MembersResp, AdminsResp, RulesResp, AnnouncementResp, JoinRequirementsResp, MasterResp, InviteCodeResp, InviteCodeListResp, BroadcastLockResp, BroadcastPermissionResp, SyncStatusResp, SyncLogResp, ChecksumResp, PublicGroupInfoResp, SearchGroupsResp, DigestResp, ListMyGroupsResp, GetFileResp, GetSummaryResp, GetMetricsResp } from './types';
 /**
  * Callback interface for syncGroup.
  */
@@ -43,20 +43,20 @@ export declare class GroupOperations {
         message?: string;
     }): Promise<string>;
     /**
-     * 注册上线，获取游标状态。
-     * 客户端每次启动或重新连接时，必须对每个群组调用。
+     * 注册上线，告知 group.ap 当前客户端在线，可以接收消息推送。
+     * 客户端每次启动或重新连接时调用一次即可。
      */
-    registerOnline(targetAid: string, groupId: string): Promise<RegisterOnlineResp>;
+    registerOnline(targetAid: string): Promise<void>;
     /**
      * 主动下线（优雅退出）。
      * 客户端退出时调用，立即从在线列表移除。
      */
-    unregisterOnline(targetAid: string, groupId: string): Promise<void>;
+    unregisterOnline(targetAid: string): Promise<void>;
     /**
      * 心跳保活。
      * 在线注册有 5 分钟超时，SDK 需定时发送（建议 2~4 分钟）。
      */
-    heartbeat(targetAid: string, groupId: string): Promise<void>;
+    heartbeat(targetAid: string): Promise<void>;
     createGroup(targetAid: string, name: string, options?: {
         alias?: string;
         subject?: string;

package/dist/group/operations.js

@@ -62,31 +62,27 @@ class GroupOperations {
     // Phase 0: Lifecycle (register / heartbeat / unregister)
     // ============================================================
     /**
-     * 注册上线，获取游标状态。
-     * 客户端每次启动或重新连接时，必须对每个群组调用。
+     * 注册上线，告知 group.ap 当前客户端在线，可以接收消息推送。
+     * 客户端每次启动或重新连接时调用一次即可。
      */
-    async registerOnline(targetAid, groupId) {
-        const resp = await this._client.sendRequest(targetAid, groupId, "register_online", null);
+    async registerOnline(targetAid) {
+        const resp = await this._client.sendRequest(targetAid, "", "register_online", null);
         this._check(resp, "register_online");
-        const d = resp.data || {};
-        return {
-            msg_cursor: (0, types_1.createMsgCursor)(d.msg_cursor),
-        };
     }
     /**
      * 主动下线（优雅退出）。
      * 客户端退出时调用，立即从在线列表移除。
      */
-    async unregisterOnline(targetAid, groupId) {
-        const resp = await this._client.sendRequest(targetAid, groupId, "unregister_online", null);
+    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, groupId) {
-        const resp = await this._client.sendRequest(targetAid, groupId, "heartbeat", null);
+    async heartbeat(targetAid) {
+        const resp = await this._client.sendRequest(targetAid, "", "heartbeat", null);
         this._check(resp, "heartbeat");
     }
     // ============================================================

package/dist/group/types.d.ts

@@ -85,9 +85,6 @@ export interface CursorState {
     msg_cursor: MsgCursor;
     event_cursor: EventCursor;
 }
-export interface RegisterOnlineResp {
-    msg_cursor: MsgCursor;
-}
 export interface CreateGroupResp {
     group_id: string;
     group_url: string;

package/package.json

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