agent-messenger 2.36.0 → 2.37.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-messenger",
-  "version": "2.36.0",
+  "version": "2.37.0",
   "description": "Messaging platform interaction skills for AI agents. Interact with Slack, Discord, Microsoft Teams, Webex, Telegram, Telegram Bot, WhatsApp, LINE, iMessage, Instagram, KakaoTalk, and Channel Talk - send messages, read channels, manage reactions, upload files, and more through simple CLI interfaces.",
   "author": {
     "name": "agent-messenger",

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "agent-messenger",
-    "version": "2.36.0",
+    "version": "2.37.0",
     "description": "Multi-platform messaging CLI for AI agents (Slack, Discord, Teams, Webex, Telegram, Telegram Bot, WhatsApp, LINE, iMessage, Instagram, KakaoTalk, Channel Talk)",
     "repository": {
         "type": "git",

package/dist/src/platforms/kakaotalk/chat-classifier.d.ts

@@ -1,5 +1,6 @@
-import type { KakaoChat } from './types.js';
+import type { KakaoChat, KakaoOpenChatType } from './types.js';
 export type KakaoChatKind = 'dm' | 'group' | 'open' | 'unknown';
+export declare function isOpenKakaoChatType(type: unknown): type is KakaoOpenChatType;
 /**
  * Classify a KakaoTalk chat as `'dm'`, `'group'`, `'open'`, or `'unknown'`.
  *

package/dist/src/platforms/kakaotalk/chat-classifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-classifier.d.ts","sourceRoot":"","sources":["../../../../src/platforms/kakaotalk/chat-classifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAExC,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;AAQ/D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAAC,GAAG,aAAa,CAMjG"}
+{"version":3,"file":"chat-classifier.d.ts","sourceRoot":"","sources":["../../../../src/platforms/kakaotalk/chat-classifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAE3D,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;AAO/D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,iBAAiB,CAE5E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAAC,GAAG,aAAa,CAMjG"}

package/dist/src/platforms/kakaotalk/chat-classifier.js

@@ -1,8 +1,10 @@
-// OpenChat-family `type` codes observed on the wire. KakaoTalk's LOCO
-// protocol exposes a numeric `type` field with no documented mapping; these
-// five codes consistently identify OpenChat rooms across normal OpenChat,
-// OpenChat DMs, and the various OpenChat sub-types seen in production.
-const OPEN_CHAT_TYPE_CODES = new Set([2, 13, 14, 15, 16]);
+// OpenChat-family `type` values observed on the wire. Login/chat-list data
+// uses numeric codes while CHATINFO may return the protocol string tags
+// `OM` / `OD`; both forms must share this single classification owner.
+const OPEN_CHAT_TYPES = new Set([2, 13, 14, 15, 16, 'OM', 'OD']);
+export function isOpenKakaoChatType(type) {
+    return OPEN_CHAT_TYPES.has(type);
+}
 /**
  * Classify a KakaoTalk chat as `'dm'`, `'group'`, `'open'`, or `'unknown'`.
  *
@@ -18,7 +20,7 @@ const OPEN_CHAT_TYPE_CODES = new Set([2, 13, 14, 15, 16]);
  * the case defensively.
  */
 export function classifyKakaoChat(chat) {
-    if (OPEN_CHAT_TYPE_CODES.has(chat.type))
+    if (isOpenKakaoChatType(chat.type))
         return 'open';
     // active_members counts the logged-in user, so a 1:1 DM is exactly 2
     // (self + one other) and a "lone" room with only self is 1.

package/dist/src/platforms/kakaotalk/chat-classifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat-classifier.js","sourceRoot":"","sources":["../../../../src/platforms/kakaotalk/chat-classifier.ts"],"names":[],"mappings":"AAIA,sEAAsE;AACtE,4EAA4E;AAC5E,0EAA0E;AAC1E,uEAAuE;AACvE,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAgD;IAChF,IAAI,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAA;IACtD,qEAAqE;IACrE,4DAA4D;IAC5D,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IACzC,OAAO,OAAO,CAAA;AAChB,CAAC"}
+{"version":3,"file":"chat-classifier.js","sourceRoot":"","sources":["../../../../src/platforms/kakaotalk/chat-classifier.ts"],"names":[],"mappings":"AAIA,2EAA2E;AAC3E,wEAAwE;AACxE,uEAAuE;AACvE,MAAM,eAAe,GAAmC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;AAEhG,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,OAAO,eAAe,CAAC,GAAG,CAAC,IAAyB,CAAC,CAAA;AACvD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAgD;IAChF,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAA;IACjD,qEAAqE;IACrE,4DAA4D;IAC5D,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IACzC,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/src/platforms/kakaotalk/client.d.ts

@@ -1,7 +1,7 @@
 import { type AttachmentInput } from './attachment-router.js';
 import { LocoSession } from './protocol/session.js';
 import type { LocoPacket } from './protocol/types.js';
-import { type KakaoChat, type KakaoDeviceType, type KakaoLeaveChatResult, type KakaoMarkReadResult, type KakaoMember, type KakaoMessage, type KakaoProfile, type KakaoReplyTarget, type KakaoSendResult, type KakaoTypingResult } from './types.js';
+import { type KakaoChat, type KakaoDeviceType, type KakaoLeaveChatResult, type KakaoMarkReadResult, type KakaoMember, type KakaoMemberSnapshot, type KakaoMessage, type KakaoMessagePage, type KakaoProfile, type KakaoReplyTarget, type KakaoSendResult, type KakaoTypingResult } from './types.js';
 export type KakaoSessionEvent = {
     type: 'connected';
     userId: string;
@@ -60,6 +60,14 @@ export declare class KakaoTalkClient {
         search?: string;
         resolveTitles?: boolean;
     }): Promise<KakaoChat[]>;
+    /**
+     * Fetch one chat directly by id via read-only CHATINFO.
+     *
+     * Unlike `getChats()`, this does not depend on the login-time snapshot or
+     * LCHATLIST pagination, so a room first observed from a live push can be
+     * resolved without interpreting protocol fields outside this SDK.
+     */
+    getChat(chatId: string): Promise<KakaoChat>;
     /**
      * Resolve the user-set room title via CHATINFO. Returns null on any error
      * (network, malformed response, or no TITLE meta present). Designed to be
@@ -67,10 +75,22 @@ export declare class KakaoTalkClient {
      */
     getChatTitle(chatId: string): Promise<string | null>;
     private fetchChatTitle;
+    /**
+     * Fetch one forward-only, lossless history page after `from`.
+     *
+     * The page never keeps only the newest `count` entries. If the protocol
+     * returns more entries than requested, the oldest entries are returned and
+     * `complete` remains false so callers can continue from `next_cursor`.
+     */
+    getMessagePage(chatId: string, options?: {
+        count?: number;
+        from?: string;
+    }): Promise<KakaoMessagePage>;
     getMessages(chatId: string, options?: {
         count?: number;
         from?: string;
     }): Promise<KakaoMessage[]>;
+    getMemberSnapshot(chatId: string): Promise<KakaoMemberSnapshot>;
     getMembers(chatId: string): Promise<KakaoMember[]>;
     getMembersByIds(chatId: string, userIds: string[]): Promise<KakaoMember[]>;
     sendMessage(chatId: string, text: string, options?: {

package/dist/src/platforms/kakaotalk/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/platforms/kakaotalk/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/platforms/kakaotalk/client.ts"],"names":[],"mappings":"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"}

package/dist/src/platforms/kakaotalk/client.js

@@ -5,6 +5,7 @@ import { Long } from 'bson';
 import { getConfigDir } from '../../shared/utils/config-dir.js';
 import { warn } from '../../shared/utils/stderr.js';
 import { planAttachments } from './attachment-router.js';
+import { isOpenKakaoChatType } from './chat-classifier.js';
 import { detectImageDimensions } from './image-meta.js';
 import { sha1Hex } from './media-upload.js';
 import { LANG, PC_OS_NAME, getLocoDeviceConfig } from './protocol/config.js';
@@ -166,6 +167,64 @@ function extractTitle(body) {
     const content = titleMeta?.content;
     return typeof content === 'string' && content.length > 0 ? content : null;
 }
+function extractChannelInfo(body, expectedChatId) {
+    const info = body.chatInfo;
+    if (!info || typeof info !== 'object') {
+        throw new Error('CHATINFO response missing chatInfo');
+    }
+    const responseChatId = longToString(info.chatId);
+    if (responseChatId !== expectedChatId) {
+        throw new Error('CHATINFO response chatId mismatch');
+    }
+    return info;
+}
+function requiredNonNegativeInteger(value, field) {
+    if (!Number.isInteger(value) || value < 0) {
+        throw new Error(`CHATINFO response invalid ${field}`);
+    }
+    return value;
+}
+function requiredChatType(value) {
+    if (typeof value === 'string' && isOpenKakaoChatType(value)) {
+        return value;
+    }
+    return requiredNonNegativeInteger(value, 'type');
+}
+function channelInfoToChatData(body, expectedChatId) {
+    const info = extractChannelInfo(body, expectedChatId);
+    const type = requiredChatType(info.type);
+    const activeMembers = requiredNonNegativeInteger(info.activeMembersCount, 'activeMembersCount');
+    const unreadCount = info.invalidNewMessageCount === true ? 0 : requiredNonNegativeInteger(info.newMessageCount, 'newMessageCount');
+    const displayMembers = Array.isArray(info.displayMembers) ? info.displayMembers : [];
+    const memberIds = [];
+    const memberNames = [];
+    for (const member of displayMembers) {
+        if (!member || typeof member !== 'object')
+            continue;
+        if (member.userId === undefined || typeof member.nickName !== 'string')
+            continue;
+        memberIds.push(member.userId);
+        memberNames.push(member.nickName);
+    }
+    return {
+        c: info.chatId,
+        t: type,
+        a: activeMembers,
+        n: unreadCount,
+        l: info.lastChatLog ?? null,
+        ll: info.lastLogId,
+        i: memberIds,
+        k: memberNames,
+        li: info.li,
+    };
+}
+function extractChannelMaxLogId(body, expectedChatId) {
+    const info = extractChannelInfo(body, expectedChatId);
+    const maxLogId = bsonToLong(info.lastLogId);
+    if (!maxLogId)
+        throw new Error('CHATINFO response missing lastLogId');
+    return maxLogId;
+}
 function extractOpenLinkName(body) {
     const ols = body.ols;
     if (!Array.isArray(ols) || ols.length === 0)
@@ -173,9 +232,8 @@ function extractOpenLinkName(body) {
     const ln = ols[0]?.ln;
     return typeof ln === 'string' && ln.length > 0 ? ln : null;
 }
-const OPEN_CHAT_TYPES = new Set(['OM', 'OD']);
 function isOpenChat(chat) {
-    return typeof chat.t === 'string' && OPEN_CHAT_TYPES.has(chat.t);
+    return isOpenKakaoChatType(chat.t);
 }
 function getOpenLinkId(chat) {
     return bsonToLong(chat.li) ?? null;
@@ -359,10 +417,24 @@ function formatMember(member) {
     };
 }
 function memberIdKey(member) {
-    if (member.userId === undefined || member.userId === null)
+    const value = member.userId;
+    if (typeof value === 'number') {
+        return Number.isSafeInteger(value) && value > 0 ? String(value) : null;
+    }
+    if (!value || typeof value !== 'object' || !('low' in value) || !('high' in value)) {
         return null;
-    const key = longToString(member.userId);
-    return key === '0' ? null : key;
+    }
+    const { low, high } = value;
+    if (!Number.isInteger(low) ||
+        !Number.isInteger(high) ||
+        low < -0x80000000 ||
+        low > 0xffffffff ||
+        high < -0x80000000 ||
+        high > 0xffffffff) {
+        return null;
+    }
+    const numeric = (BigInt(high >>> 0) << 32n) | BigInt(low >>> 0);
+    return numeric > 0n && numeric <= BigInt(Number.MAX_SAFE_INTEGER) ? numeric.toString() : null;
 }
 function mergeMemberRecords(primaryMembers, fallbackMembers) {
     const merged = [];
@@ -385,18 +457,43 @@ function mergeMemberRecords(primaryMembers, fallbackMembers) {
         upsert(member);
     return merged;
 }
-function extractChatInfoMembers(body) {
-    if (!body || typeof body !== 'object')
-        return [];
-    const record = body;
-    if (Array.isArray(record.m)) {
-        return record.m;
-    }
-    const chatInfo = record.chatInfo;
-    if (!chatInfo || typeof chatInfo !== 'object')
-        return [];
-    const displayMembers = chatInfo.displayMembers;
-    return Array.isArray(displayMembers) ? displayMembers : [];
+function exactMemberRecords(value, source) {
+    if (!Array.isArray(value)) {
+        throw new Error(`${source} member snapshot missing`);
+    }
+    const records = [];
+    const ids = new Set();
+    for (const raw of value) {
+        if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+            throw new Error(`${source} member snapshot invalid`);
+        }
+        const record = raw;
+        const id = memberIdKey(record);
+        if (!id || ids.has(id)) {
+            throw new Error(`${source} member snapshot invalid`);
+        }
+        ids.add(id);
+        records.push(record);
+    }
+    return { records, ids };
+}
+function sameIds(left, right) {
+    return left.size === right.size && [...left].every((id) => right.has(id));
+}
+function subsetIds(subset, superset) {
+    return [...subset].every((id) => superset.has(id));
+}
+function channelMemberView(body, expectedChatId) {
+    const info = extractChannelInfo(body, expectedChatId);
+    const activeMembers = requiredNonNegativeInteger(info.activeMembersCount, 'activeMembersCount');
+    const displayMembers = exactMemberRecords(info.displayMembers ?? [], 'CHATINFO');
+    if (displayMembers.records.length > activeMembers) {
+        throw new Error('CHATINFO member snapshot invalid');
+    }
+    return {
+        activeMembers,
+        ...displayMembers,
+    };
 }
 function formatMessages(logs, count, chatId, nameCache) {
     logs.sort((a, b) => a.sendAt - b.sendAt);
@@ -410,6 +507,40 @@ function formatMessages(logs, count, chatId, nameCache) {
         sent_at: log.sendAt,
     }));
 }
+function formatForwardMessage(log, chatId, nameCache) {
+    return {
+        log_id: longToString(log.logId),
+        type: log.type,
+        author_id: log.authorId,
+        author_name: nameCache.lookup(chatId, log.authorId),
+        message: log.message,
+        attachment: parseAttachmentJson(log.attachment),
+        sent_at: log.sendAt,
+    };
+}
+function buildMessagePage(logs, count, cursor, protocolComplete, chatId, nameCache) {
+    const cursorValue = BigInt(cursor.toString());
+    const unique = new Map();
+    for (const log of logs) {
+        const logId = longToString(log.logId);
+        if (BigInt(logId) <= cursorValue)
+            continue;
+        if (!unique.has(logId))
+            unique.set(logId, log);
+    }
+    const ordered = [...unique.entries()].sort(([left], [right]) => {
+        const a = BigInt(left);
+        const b = BigInt(right);
+        return a < b ? -1 : a > b ? 1 : 0;
+    });
+    const selected = ordered.slice(0, count);
+    const nextCursor = selected.at(-1)?.[0] ?? null;
+    return {
+        messages: selected.map(([, log]) => formatForwardMessage(log, chatId, nameCache)),
+        next_cursor: nextCursor,
+        complete: protocolComplete && ordered.length <= count,
+    };
+}
 function buildReplyExtra(target) {
     return {
         attach_only: false,
@@ -672,6 +803,43 @@ export class KakaoTalkClient {
             }
         });
     }
+    /**
+     * Fetch one chat directly by id via read-only CHATINFO.
+     *
+     * Unlike `getChats()`, this does not depend on the login-time snapshot or
+     * LCHATLIST pagination, so a room first observed from a live push can be
+     * resolved without interpreting protocol fields outside this SDK.
+     */
+    async getChat(chatId) {
+        const parsedChatId = parseChatId(chatId);
+        const normalizedChatId = longToString(parsedChatId);
+        return this.executeWithReconnect(async ({ session }) => {
+            try {
+                const response = await session.getChannelInfo(parsedChatId);
+                assertLocoOk(response, 'CHATINFO');
+                const body = response.body;
+                const chat = channelInfoToChatData(body, normalizedChatId);
+                this.nameCache.ingest([chat]);
+                let title = extractTitle(body);
+                if (!title && isOpenChat(chat)) {
+                    const linkId = getOpenLinkId(chat);
+                    if (linkId) {
+                        try {
+                            const openLinkResponse = await session.getOpenLinkInfo([linkId]);
+                            title = extractOpenLinkName(openLinkResponse.body);
+                        }
+                        catch {
+                            title = null;
+                        }
+                    }
+                }
+                return formatChat(chat, title, this.nameCache);
+            }
+            catch (error) {
+                throw wrapError(error, 'get_chat_failed');
+            }
+        });
+    }
     /**
      * Resolve the user-set room title via CHATINFO. Returns null on any error
      * (network, malformed response, or no TITLE meta present). Designed to be
@@ -714,6 +882,50 @@ export class KakaoTalkClient {
             return null;
         }
     }
+    /**
+     * Fetch one forward-only, lossless history page after `from`.
+     *
+     * The page never keeps only the newest `count` entries. If the protocol
+     * returns more entries than requested, the oldest entries are returned and
+     * `complete` remains false so callers can continue from `next_cursor`.
+     */
+    async getMessagePage(chatId, options) {
+        const count = options?.count ?? 100;
+        if (!Number.isInteger(count) || count < 1 || count > 100) {
+            throw new KakaoTalkError('Message page count must be an integer between 1 and 100', 'invalid_message_page_count');
+        }
+        const parsedChatId = parseChatId(chatId);
+        const normalizedChatId = longToString(parsedChatId);
+        const cursor = options?.from ? parseLogId(options.from) : Long.fromNumber(0);
+        return this.executeWithReconnect(async ({ session }) => {
+            try {
+                const response = await session.getChatLogs([parsedChatId], [cursor]);
+                assertLocoOk(response, 'MCHATLOGS');
+                const batch = (response.body.chatLogs ?? []).filter((log) => longToString(log.chatId) === normalizedChatId);
+                if (batch.length > 0) {
+                    return buildMessagePage(batch, count, cursor, response.body.eof === true, normalizedChatId, this.nameCache);
+                }
+                // CHATINFO is read-only and supplies a fresh lastLogId even for rooms
+                // absent from the login snapshot. This avoids CHATONROOM, which can
+                // advance server-side unread state.
+                const chatInfoResponse = await session.getChannelInfo(parsedChatId);
+                assertLocoOk(chatInfoResponse, 'CHATINFO');
+                const maxLogId = extractChannelMaxLogId(chatInfoResponse.body, normalizedChatId);
+                if (maxLogId.lessThanOrEqual(cursor)) {
+                    return { messages: [], next_cursor: null, complete: true };
+                }
+                const syncResponse = await session.syncMessages(parsedChatId, Math.min(count, 80), cursor, maxLogId);
+                assertLocoOk(syncResponse, 'SYNCMSG');
+                const syncBatch = (syncResponse.body.chatLogs ?? []).filter((log) => longToString(log.chatId) === normalizedChatId);
+                const maxReturned = findMaxLogId(syncBatch, 'logId');
+                const protocolComplete = syncResponse.body.isOK === true || (maxReturned !== null && maxReturned.greaterThanOrEqual(maxLogId));
+                return buildMessagePage(syncBatch, count, cursor, protocolComplete, normalizedChatId, this.nameCache);
+            }
+            catch (error) {
+                throw wrapError(error, 'get_message_page_failed');
+            }
+        });
+    }
     async getMessages(chatId, options) {
         return this.executeWithReconnect(async ({ session, loginResult }) => {
             try {
@@ -798,30 +1010,58 @@ export class KakaoTalkClient {
             }
         });
     }
-    async getMembers(chatId) {
+    async getMemberSnapshot(chatId) {
         const parsedChatId = parseChatId(chatId);
+        const normalizedChatId = longToString(parsedChatId);
         return this.executeWithReconnect(async ({ session }) => {
             try {
-                const response = await session.getAllMembers(parsedChatId);
-                assertLocoOk(response, 'GETMEM');
-                const members = (response.body.members ?? []);
-                let fallbackMembers = [];
-                try {
-                    // Some KakaoTalk rooms return only a subset from GETMEM even though
-                    // CHATONROOM carries the full active member list in `m`.
-                    const chatInfo = await session.getChatInfo(parsedChatId);
-                    fallbackMembers = extractChatInfoMembers(chatInfo.body);
-                }
-                catch {
-                    fallbackMembers = [];
+                const firstChatResponse = await session.getChannelInfo(parsedChatId);
+                assertLocoOk(firstChatResponse, 'CHATINFO');
+                const firstChat = channelMemberView(firstChatResponse.body, normalizedChatId);
+                const firstMemberResponse = await session.getAllMembers(parsedChatId);
+                assertLocoOk(firstMemberResponse, 'GETMEM');
+                const firstMembers = exactMemberRecords(firstMemberResponse.body.members ?? [], 'GETMEM');
+                const secondChatResponse = await session.getChannelInfo(parsedChatId);
+                assertLocoOk(secondChatResponse, 'CHATINFO');
+                const secondChat = channelMemberView(secondChatResponse.body, normalizedChatId);
+                const secondMemberResponse = await session.getAllMembers(parsedChatId);
+                assertLocoOk(secondMemberResponse, 'GETMEM');
+                const secondMembers = exactMemberRecords(secondMemberResponse.body.members ?? [], 'GETMEM');
+                if (firstChat.activeMembers !== secondChat.activeMembers ||
+                    firstMembers.records.length !== firstChat.activeMembers ||
+                    secondMembers.records.length !== secondChat.activeMembers ||
+                    !sameIds(firstChat.ids, secondChat.ids) ||
+                    !sameIds(firstMembers.ids, secondMembers.ids) ||
+                    !subsetIds(secondChat.ids, secondMembers.ids)) {
+                    throw new Error('member_snapshot_changed_or_incomplete');
                 }
-                return mergeMemberRecords(members, fallbackMembers).map(formatMember);
+                return {
+                    chat_id: normalizedChatId,
+                    active_members: secondChat.activeMembers,
+                    members: mergeMemberRecords(secondMembers.records, secondChat.records).map(formatMember),
+                    complete: true,
+                    consistency_basis: 'stable_double_read_chatinfo_getmem',
+                };
             }
             catch (error) {
-                throw wrapError(error, 'get_members_failed');
+                throw wrapError(error, 'get_member_snapshot_failed');
             }
         });
     }
+    async getMembers(chatId) {
+        try {
+            return (await this.getMemberSnapshot(chatId)).members;
+        }
+        catch (error) {
+            if (error instanceof KakaoTalkError && error.code === 'get_member_snapshot_failed') {
+                throw new KakaoTalkError(error.message, 'get_members_failed', {
+                    cause: error,
+                    serverStatus: error.serverStatus,
+                });
+            }
+            throw error;
+        }
+    }
     async getMembersByIds(chatId, userIds) {
         if (userIds.length === 0)
             return [];