agent-messenger 2.37.0 → 2.37.2

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-messenger",
-  "version": "2.37.0",
+  "version": "2.37.2",
   "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.37.0",
+    "version": "2.37.2",
     "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,4 +1,4 @@
-import type { KakaoChat, KakaoOpenChatType } from './types.js';
+import { type KakaoChat, type KakaoOpenChatType } from './types.js';
 export type KakaoChatKind = 'dm' | 'group' | 'open' | 'unknown';
 export declare function isOpenKakaoChatType(type: unknown): type is KakaoOpenChatType;
 /**
@@ -11,9 +11,9 @@ export declare function isOpenKakaoChatType(type: unknown): type is KakaoOpenCha
  * NOT "simplify" this back to a pure type-code mapping without verifying
  * against a real KakaoTalk session.
  *
- * `'unknown'` is reserved for future protocol drift; the current heuristic
- * never returns it, but it is part of the union so consumers can handle
- * the case defensively.
+ * `'unknown'` is reserved for future string protocol drift so consumers fail
+ * closed instead of silently classifying an unrecognized server value by
+ * member count.
  */
 export declare function classifyKakaoChat(chat: Pick<KakaoChat, 'type' | 'active_members'>): KakaoChatKind;
 //# sourceMappingURL=chat-classifier.d.ts.map

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,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"}
+{"version":3,"file":"chat-classifier.d.ts","sourceRoot":"","sources":["../../../../src/platforms/kakaotalk/chat-classifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAE5F,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,CASjG"}

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

@@ -1,3 +1,4 @@
+import { isKnownKakaoChatStringType } from './types.js';
 // 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.
@@ -15,13 +16,16 @@ export function isOpenKakaoChatType(type) {
  * NOT "simplify" this back to a pure type-code mapping without verifying
  * against a real KakaoTalk session.
  *
- * `'unknown'` is reserved for future protocol drift; the current heuristic
- * never returns it, but it is part of the union so consumers can handle
- * the case defensively.
+ * `'unknown'` is reserved for future string protocol drift so consumers fail
+ * closed instead of silently classifying an unrecognized server value by
+ * member count.
  */
 export function classifyKakaoChat(chat) {
     if (isOpenKakaoChatType(chat.type))
         return 'open';
+    if (typeof chat.type === 'string' && !isKnownKakaoChatStringType(chat.type)) {
+        return 'unknown';
+    }
     // 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.
     if (chat.active_members <= 2)

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,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"}
+{"version":3,"file":"chat-classifier.js","sourceRoot":"","sources":["../../../../src/platforms/kakaotalk/chat-classifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAA0C,MAAM,SAAS,CAAA;AAI5F,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,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5E,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,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

@@ -13,12 +13,21 @@ export type KakaoSessionEvent = {
 };
 export type KakaoPushHandler = (packet: LocoPacket) => void;
 export type KakaoSessionEventHandler = (event: KakaoSessionEvent) => void;
+export type KakaoTalkResponseFailureKind = 'provider_rejection' | 'transient_or_unknown';
+export type KakaoTalkResponseStatusSource = 'packet' | 'body';
+export type KakaoTalkGetChatFailureReason = 'provider_rejection' | 'synthetic_connection_close' | 'chat_info_absent' | 'transport_or_unknown';
 export declare class KakaoTalkError extends Error {
     code: string;
     readonly serverStatus?: number;
+    readonly responseFailureKind?: KakaoTalkResponseFailureKind;
+    readonly responseStatusSource?: KakaoTalkResponseStatusSource;
+    readonly getChatFailureReason?: KakaoTalkGetChatFailureReason;
     constructor(message: string, code: string, options?: {
         cause?: unknown;
         serverStatus?: number;
+        responseFailureKind?: KakaoTalkResponseFailureKind;
+        responseStatusSource?: KakaoTalkResponseStatusSource;
+        getChatFailureReason?: KakaoTalkGetChatFailureReason;
     });
 }
 export declare class KakaoTalkClient {
@@ -66,6 +75,9 @@ export declare class KakaoTalkClient {
      * 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.
+     * The returned chat type preserves numeric values and non-empty protocol
+     * strings, including DirectChat, MultiChat, PlusChat, MemoChat, OM, and OD;
+     * unknown non-empty strings are preserved for forward compatibility.
      */
     getChat(chatId: string): Promise<KakaoChat>;
     /**

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

@@ -9,17 +9,36 @@ 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';
+import { isSyntheticConnectionClose } from './protocol/login-response.js';
 import { uploadMediaToLoco, uploadMultiMediaEntry } from './protocol/media-uploader.js';
 import { LocoSession } from './protocol/session.js';
 import { KAKAO_MESSAGE_TYPE, } from './types.js';
 export class KakaoTalkError extends Error {
     code;
     serverStatus;
+    responseFailureKind;
+    responseStatusSource;
+    getChatFailureReason;
     constructor(message, code, options) {
         super(message, options);
         this.name = 'KakaoTalkError';
         this.code = code;
         this.serverStatus = options?.serverStatus;
+        this.responseFailureKind = options?.responseFailureKind;
+        this.responseStatusSource = options?.responseStatusSource;
+        this.getChatFailureReason = options?.getChatFailureReason;
+    }
+}
+class LocoResponseError extends Error {
+    serverStatus;
+    responseFailureKind;
+    responseStatusSource;
+    constructor(message, responseFailureKind, options) {
+        super(message);
+        this.name = 'LocoResponseError';
+        this.serverStatus = options?.serverStatus;
+        this.responseFailureKind = responseFailureKind;
+        this.responseStatusSource = options?.responseStatusSource;
     }
 }
 class MemberNameCache {
@@ -76,6 +95,19 @@ function bsonToLong(v) {
     }
     return undefined;
 }
+// LCHATLIST cursor fields (lastTokenId/lastChatId) arrive as plain numbers when the
+// value fits in a safe integer, because bson promotes them, and as { low, high }
+// otherwise. bsonToLong only accepts the object form, so a numeric cursor became
+// undefined and getChatList() re-requested the first page until MAX_PAGES.
+// Kept separate from bsonToLong on purpose: its other callers (log ids, open link
+// ids) rely on a numeric 0 staying absent rather than becoming a Long.
+function cursorToLong(v) {
+    if (typeof v === 'number' && Number.isSafeInteger(v))
+        return Long.fromNumber(v);
+    if (typeof v === 'bigint')
+        return Long.fromBigInt(v);
+    return bsonToLong(v);
+}
 function longToString(v) {
     if (v && typeof v === 'object' && 'high' in v && 'low' in v) {
         const { high, low } = v;
@@ -142,7 +174,7 @@ function formatChat(chat, title, nameCache) {
     const chatId = longToString(chat.c);
     return {
         chat_id: chatId,
-        type: chat.t,
+        type: requiredChatType(chat.t),
         display_name: displayName,
         title,
         active_members: chat.a,
@@ -185,7 +217,7 @@ function requiredNonNegativeInteger(value, field) {
     return value;
 }
 function requiredChatType(value) {
-    if (typeof value === 'string' && isOpenKakaoChatType(value)) {
+    if (typeof value === 'string' && value.length > 0) {
         return value;
     }
     return requiredNonNegativeInteger(value, 'type');
@@ -267,11 +299,39 @@ function collectChats(chatDatas, into, seen) {
         }
     }
 }
-function wrapError(error, code) {
-    if (error instanceof KakaoTalkError)
-        return error;
+function wrapError(error, code, options) {
+    if (error instanceof KakaoTalkError) {
+        const responseFailureKind = error.responseFailureKind ?? (options?.classifyResponseFailure ? 'transient_or_unknown' : undefined);
+        const getChatFailureReason = error.getChatFailureReason ?? (options?.classifyGetChatFailure ? 'transport_or_unknown' : undefined);
+        if (responseFailureKind === error.responseFailureKind && getChatFailureReason === error.getChatFailureReason) {
+            return error;
+        }
+        return new KakaoTalkError(error.message, error.code, {
+            cause: error.cause ?? error,
+            serverStatus: error.serverStatus,
+            responseFailureKind,
+            responseStatusSource: error.responseStatusSource,
+            getChatFailureReason,
+        });
+    }
     const message = error instanceof Error ? error.message : String(error);
-    return new KakaoTalkError(message, code, { cause: error });
+    return new KakaoTalkError(message, code, {
+        cause: error,
+        serverStatus: error instanceof LocoResponseError ? error.serverStatus : undefined,
+        responseStatusSource: error instanceof LocoResponseError ? error.responseStatusSource : undefined,
+        responseFailureKind: error instanceof LocoResponseError
+            ? error.responseFailureKind
+            : options?.classifyResponseFailure
+                ? 'transient_or_unknown'
+                : undefined,
+        getChatFailureReason: options?.classifyGetChatFailure
+            ? error instanceof LocoResponseError && error.responseFailureKind === 'provider_rejection'
+                ? 'provider_rejection'
+                : error instanceof LocoResponseError && error.responseStatusSource === 'packet' && error.serverStatus === -1
+                    ? 'synthetic_connection_close'
+                    : 'transport_or_unknown'
+            : undefined,
+    });
 }
 function isLoginResponseError(error) {
     if (!(error instanceof Error))
@@ -393,12 +453,27 @@ function isNonZeroLong(v) {
 // caller-visible error channel (e.g. GETMEM/MEMBER return `[]` for both empty rooms and dead
 // sockets). Throwing here lets executeWithReconnect detect session death and reconnect.
 function assertLocoOk(response, command) {
+    if (typeof response.statusCode !== 'number' || !Number.isFinite(response.statusCode)) {
+        throw new LocoResponseError(`${command} failed: response status unavailable`, 'transient_or_unknown');
+    }
+    if (isSyntheticConnectionClose(response)) {
+        throw new LocoResponseError(`${command} failed: connection closed`, 'transient_or_unknown', {
+            serverStatus: response.statusCode,
+            responseStatusSource: 'packet',
+        });
+    }
     if (response.statusCode !== 0) {
-        throw new Error(`${command} failed: statusCode=${response.statusCode}`);
+        throw new LocoResponseError(`${command} failed: statusCode=${response.statusCode}`, 'provider_rejection', {
+            serverStatus: response.statusCode,
+            responseStatusSource: 'packet',
+        });
     }
     const bodyStatus = response.body.status;
     if (typeof bodyStatus === 'number' && bodyStatus !== 0) {
-        throw new Error(`${command} failed: body.status=${bodyStatus}`);
+        throw new LocoResponseError(`${command} failed: body.status=${bodyStatus}`, 'provider_rejection', {
+            serverStatus: bodyStatus,
+            responseStatusSource: 'body',
+        });
     }
 }
 function formatMember(member) {
@@ -767,6 +842,7 @@ export class KakaoTalkClient {
                 if (options?.all || options?.search || snapshotEmpty) {
                     let cursor = loginResult;
                     let pages = 0;
+                    const requireCompleteList = options?.all === true;
                     while (pages < MAX_PAGES) {
                         // Trust eof only when the snapshot had data. When the snapshot was empty
                         // (new device), ignore eof for the first iteration so we always attempt
@@ -775,17 +851,29 @@ export class KakaoTalkClient {
                             break;
                         if (cursor.eof && snapshotEmpty && pages > 0)
                             break;
-                        const lastTokenId = bsonToLong(cursor.lastTokenId);
-                        const lastChatId = bsonToLong(cursor.lastChatId);
+                        const lastTokenId = cursorToLong(cursor.lastTokenId);
+                        const lastChatId = cursorToLong(cursor.lastChatId);
                         const response = await session.getChatList(lastTokenId, lastChatId);
+                        if (requireCompleteList)
+                            assertLocoOk(response, 'LCHATLIST');
                         const body = response.body;
+                        if (requireCompleteList && !Array.isArray(body.chatDatas)) {
+                            throw new Error('LCHATLIST pagination incomplete: chatDatas unavailable');
+                        }
                         const chatDatas = (body.chatDatas ?? []);
-                        if (chatDatas.length === 0)
+                        cursor = body;
+                        pages++;
+                        if (chatDatas.length === 0) {
+                            if (requireCompleteList && body.eof !== true) {
+                                throw new Error('LCHATLIST pagination incomplete: empty non-EOF page');
+                            }
                             break;
+                        }
                         collectChats(chatDatas, allChats, seenChatIds);
                         this.nameCache.ingest(chatDatas);
-                        cursor = body;
-                        pages++;
+                    }
+                    if (requireCompleteList && cursor.eof !== true) {
+                        throw new Error(`LCHATLIST pagination incomplete after ${pages} pages`);
                     }
                 }
                 allChats.sort((a, b) => (b.o ?? 0) - (a.o ?? 0));
@@ -809,6 +897,9 @@ export class KakaoTalkClient {
      * 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.
+     * The returned chat type preserves numeric values and non-empty protocol
+     * strings, including DirectChat, MultiChat, PlusChat, MemoChat, OM, and OD;
+     * unknown non-empty strings are preserved for forward compatibility.
      */
     async getChat(chatId) {
         const parsedChatId = parseChatId(chatId);
@@ -818,6 +909,20 @@ export class KakaoTalkClient {
                 const response = await session.getChannelInfo(parsedChatId);
                 assertLocoOk(response, 'CHATINFO');
                 const body = response.body;
+                const chatInfo = body.chatInfo;
+                const isLeftChatInfo = chatInfo !== null &&
+                    typeof chatInfo === 'object' &&
+                    !Array.isArray(chatInfo) &&
+                    chatInfo.left === true;
+                if (isLeftChatInfo) {
+                    extractChannelInfo(body, normalizedChatId);
+                }
+                if (chatInfo === undefined || chatInfo === null || isLeftChatInfo) {
+                    throw new KakaoTalkError('CHATINFO response missing chatInfo', 'get_chat_failed', {
+                        responseFailureKind: 'transient_or_unknown',
+                        getChatFailureReason: 'chat_info_absent',
+                    });
+                }
                 const chat = channelInfoToChatData(body, normalizedChatId);
                 this.nameCache.ingest([chat]);
                 let title = extractTitle(body);
@@ -836,7 +941,10 @@ export class KakaoTalkClient {
                 return formatChat(chat, title, this.nameCache);
             }
             catch (error) {
-                throw wrapError(error, 'get_chat_failed');
+                throw wrapError(error, 'get_chat_failed', {
+                    classifyResponseFailure: true,
+                    classifyGetChatFailure: true,
+                });
             }
         });
     }