agent-messenger 2.4.0 → 2.6.0

package/docs/content/docs/cli/whatsapp.mdx

@@ -9,14 +9,17 @@ description: Complete reference for the agent-whatsapp CLI.
 
 WhatsApp integration uses [Baileys](https://github.com/WhiskeySockets/Baileys), a reverse-engineered WhatsApp Web API:
 
-- Links as a **companion device** via pairing code, so your phone stays connected.
+- Links as a **companion device** via QR code or pairing code, so your phone stays connected.
 - Each command opens a WebSocket connection on demand and disconnects when done. No persistent background process.
 - Multiple WhatsApp accounts can be linked simultaneously.
 
 ## Quick Start
 
 ```bash
-# Link as companion device (enter the pairing code on your phone)
+# Link as companion device via QR code (scan with your phone)
+agent-whatsapp auth login --qr
+
+# Or link via pairing code (enter the code on your phone)
 agent-whatsapp auth login --phone +1234567890
 
 # List chats
@@ -28,16 +31,23 @@ agent-whatsapp message send +1234567890 "Hello from agent-whatsapp"
 
 ## Authentication
 
-### Pairing Code Login
+The CLI supports two authentication methods. Both register as a companion (linked) device, so your phone session is never affected.
 
-The CLI registers as a companion (linked) device using a numeric pairing code. Your phone session is never affected.
+### QR Code Login
+
+```bash
+agent-whatsapp auth login --qr
+```
+
+A QR code is displayed in the terminal and opened in the browser. Scan it with WhatsApp on your phone: Settings > Linked Devices > Link a Device.
+
+### Pairing Code Login
 
 ```bash
-# Start login (displays a pairing code)
 agent-whatsapp auth login --phone +1234567890
 ```
 
-The CLI outputs a pairing code. Enter it on your phone: WhatsApp > Settings > Linked Devices > Link a Device.
+A numeric pairing code is displayed. Enter it on your phone: WhatsApp > Settings > Linked Devices > Link with phone number.
 
 ### Account Management
 
@@ -59,6 +69,17 @@ agent-whatsapp auth logout --account <id>
 
 ## Commands
 
+### Whoami Command
+
+```bash
+# Show current authenticated user
+agent-whatsapp whoami
+agent-whatsapp whoami --pretty
+agent-whatsapp whoami --account <account-id>
+```
+
+Output includes the authenticated user's identity information.
+
 ### Chat Commands
 
 ```bash
@@ -135,6 +156,14 @@ npx -y --package agent-messenger agent-whatsapp chat list --pretty
 
 **NEVER run `npx agent-whatsapp`** without `--package agent-messenger`. It will fail or install a wrong package.
 
+### QR code not scanning
+
+1. Make sure WhatsApp is open on your phone
+2. Go to Settings > Linked Devices > Link a Device
+3. Point your phone camera at the QR code in the terminal or browser
+4. If the QR code expires, run `auth login --qr` again for a fresh code
+5. If QR scanning fails, try pairing code: `auth login --phone <number>`
+
 ### Pairing code not working
 
 1. Make sure WhatsApp is open on your phone
@@ -152,7 +181,7 @@ WhatsApp may disconnect linked devices that are inactive for extended periods. I
 agent-whatsapp auth status
 
 # Re-link if needed
-agent-whatsapp auth login --phone +1234567890
+agent-whatsapp auth login --qr
 ```
 
 ## AI Agent Integration

package/docs/content/docs/cli/whatsappbot.mdx

@@ -74,6 +74,15 @@ agent-whatsappbot auth remove <account-id>
 
 ## Commands
 
+### Whoami Command
+
+```bash
+# Show current authenticated bot
+agent-whatsappbot whoami
+agent-whatsappbot whoami --pretty
+agent-whatsappbot whoami --account <account-id>
+```
+
 ### Message Commands
 
 ```bash

package/e2e/config.ts

@@ -344,7 +344,7 @@ export async function validateKakaoTalkEnvironment(): Promise<boolean> {
 
   const result = await runCLI('kakaotalk', ['auth', 'status'])
   if (result.exitCode !== 0) {
-    throw new Error('KakaoTalk authentication failed. Run: agent-kakaotalk auth login or agent-kakaotalk auth extract')
+    throw new Error('KakaoTalk authentication failed. Run: agent-kakaotalk auth login')
   }
 
   return true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-messenger",
-  "version": "2.4.0",
+  "version": "2.6.0",
   "description": "Multi-platform messaging CLI for AI agents (Slack, Discord, Teams, Webex, Telegram, WhatsApp, LINE, Instagram, KakaoTalk, Channel Talk)",
   "repository": {
     "type": "git",
@@ -138,6 +138,8 @@
   },
   "dependencies": {
     "@evex/linejs": "https://npm.jsr.io/~/11/@jsr/evex__linejs/2.3.7.tgz",
+    "@jsr/evex__linejs-types": "https://npm.jsr.io/~/11/@jsr/evex__linejs-types/2.3.7.tgz",
+    "@jsr/evex__loose-types": "https://npm.jsr.io/~/11/@jsr/evex__loose-types/1.0.1.tgz",
     "@hapi/boom": "^10.0.1",
     "@slack/web-api": "^6.9.0",
     "@whiskeysockets/baileys": "^7.0.0-rc.9",

package/skills/agent-channeltalk/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-channeltalk
 description: Interact with Channel Talk using extracted desktop app or browser credentials - read chats, send messages, search messages, manage groups
-version: 2.4.0
+version: 2.6.0
 allowed-tools: Bash(agent-channeltalk:*)
 metadata:
   openclaw:
@@ -186,6 +186,17 @@ agent-channeltalk auth use <workspace-id>
 agent-channeltalk auth remove <workspace-id>
 ```
 
+### Whoami Command
+
+```bash
+# Show current authenticated user
+agent-channeltalk whoami
+agent-channeltalk whoami --pretty
+agent-channeltalk whoami --workspace <workspace-id>
+```
+
+Output includes the authenticated user's identity information.
+
 ### Message Commands
 
 ```bash

package/skills/agent-channeltalkbot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-channeltalkbot
 description: Interact with Channel Talk workspaces using API credentials - send messages, read chats, manage groups and bots
-version: 2.4.0
+version: 2.6.0
 allowed-tools: Bash(agent-channeltalkbot:*)
 metadata:
   openclaw:
@@ -184,6 +184,15 @@ agent-channeltalkbot auth remove <workspace-id>
 agent-channeltalkbot auth bot <name>
 ```
 
+### Whoami Command
+
+```bash
+# Show current authenticated bot
+agent-channeltalkbot whoami
+agent-channeltalkbot whoami --pretty
+agent-channeltalkbot whoami --workspace <workspace-id>
+```
+
 ### Message Commands
 
 ```bash

package/skills/agent-discord/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-discord
 description: Interact with Discord servers - send messages, read channels, manage reactions
-version: 2.4.0
+version: 2.6.0
 allowed-tools: Bash(agent-discord:*)
 metadata:
   openclaw:
@@ -145,6 +145,16 @@ agent-discord auth status
 agent-discord auth logout
 ```
 
+### Whoami Command
+
+```bash
+# Show current authenticated user
+agent-discord whoami
+agent-discord whoami --pretty
+```
+
+Output includes the authenticated user's identity information.
+
 ### Message Commands
 
 ```bash

package/skills/agent-discordbot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-discordbot
 description: Interact with Discord servers using bot tokens - send messages, read channels, manage reactions
-version: 2.4.0
+version: 2.6.0
 allowed-tools: Bash(agent-discordbot:*)
 metadata:
   openclaw:
@@ -158,6 +158,15 @@ agent-discordbot auth use <bot-id>
 agent-discordbot auth remove <bot-id>
 ```
 
+### Whoami Command
+
+```bash
+# Show current authenticated bot
+agent-discordbot whoami
+agent-discordbot whoami --pretty
+agent-discordbot whoami --bot <bot-id>
+```
+
 ### Server Commands
 
 ```bash

package/skills/agent-instagram/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-instagram
 description: Interact with Instagram DMs - send messages, read conversations, manage accounts
-version: 2.4.0
+version: 2.6.0
 allowed-tools: Bash(agent-instagram:*)
 metadata:
   openclaw:
@@ -242,6 +242,17 @@ agent-instagram auth logout
 agent-instagram auth logout --account <id>
 ```
 
+### Whoami Command
+
+```bash
+# Show current authenticated user
+agent-instagram whoami
+agent-instagram whoami --pretty
+agent-instagram whoami --account <account-id>
+```
+
+Output includes the authenticated user's identity information.
+
 ### Chat Commands
 
 ```bash

package/skills/agent-kakaotalk/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-kakaotalk
 description: Interact with KakaoTalk - send messages, read chats, manage conversations
-version: 2.4.0
+version: 2.6.0
 allowed-tools: Bash(agent-kakaotalk:*)
 metadata:
   openclaw:
@@ -16,7 +16,7 @@ metadata:
 
 # Agent KakaoTalk
 
-A TypeScript CLI tool that enables AI agents and humans to interact with KakaoTalk through a simple command interface. Features credential extraction from the KakaoTalk desktop app and sub-device login that keeps your desktop app running.
+A TypeScript CLI tool that enables AI agents and humans to interact with KakaoTalk through a simple command interface. Features sub-device login that keeps your desktop app running.
 
 ## Key Concepts
 
@@ -32,12 +32,9 @@ Before diving in, a few things about KakaoTalk's architecture:
 ## Quick Start
 
 ```bash
-# Login (recommended — registers as sub-device, desktop app stays running)
+# Login (registers as sub-device, desktop app stays running)
 agent-kakaotalk auth login
 
-# Or extract credentials from desktop app (kicks desktop session)
-agent-kakaotalk auth extract
-
 # List chat rooms
 agent-kakaotalk chat list
 
@@ -47,16 +44,12 @@ agent-kakaotalk message send <chat-id> "Hello from AI agent!"
 # List messages in a chat
 agent-kakaotalk message list <chat-id>
 
-# Show your profile
-agent-kakaotalk profile
+# Show your identity
+agent-kakaotalk whoami
 ```
 
 ## Authentication
 
-KakaoTalk offers two authentication methods:
-
-### Method 1: Login (Recommended)
-
 Registers the CLI as a sub-device (tablet slot by default). Your desktop app keeps running.
 
 ```bash
@@ -77,18 +70,7 @@ agent-kakaotalk auth login --email user@example.com --password mypass
 3. The CLI polls until you confirm on your phone
 4. Login completes automatically after confirmation
 
-**IMPORTANT**: NEVER guide the user to open a web browser, use DevTools, or manually copy tokens. Always use `agent-kakaotalk auth login` or `agent-kakaotalk auth extract`.
-
-### Method 2: Extract from Desktop App
-
-Extracts OAuth tokens directly from the KakaoTalk desktop app's cache. This **kicks the desktop session** because it reuses the desktop's credentials.
-
-```bash
-agent-kakaotalk auth extract
-agent-kakaotalk auth extract --debug
-```
-
-On macOS, reads from `~/Library/Containers/com.kakao.KakaoTalkMac/Data/Library/Caches/Cache.db`. On Windows, reads from the registry and `%LocalAppData%\Kakao\login_list.dat`.
+**IMPORTANT**: NEVER guide the user to open a web browser, use DevTools, or manually copy tokens. Always use `agent-kakaotalk auth login`.
 
 ### Agent Behavior (MANDATORY)
 
@@ -102,21 +84,13 @@ agent-kakaotalk auth status
 
 If authenticated → retry the original command.
 
-**Step 2: Try credential extraction first**
-
-```bash
-agent-kakaotalk auth extract
-```
-
-If extraction succeeds → retry the original command. Extraction is silent and requires no user input.
-
-**Step 3: If extraction fails, use login flow**
+**Step 2: Login (registers as sub-device — desktop app stays running)**
 
 ```bash
 agent-kakaotalk auth login
 ```
 
-The CLI will auto-extract the email from the desktop app. On fresh installs, the CLI may prompt for the KakaoTalk password once (one-time device registration). After registration, the password is never needed again.
+The CLI auto-extracts the email (and password if available) from the desktop app. On fresh installs, the CLI may prompt for the KakaoTalk password once (one-time device registration). After registration, the password is never needed again.
 
 Possible responses:
 
@@ -134,7 +108,7 @@ agent-kakaotalk auth login --password-file /tmp/.kakao-pw
 
 The `--password-file` flag reads the password from the file and **deletes the file immediately after reading**. The password never appears in chat, shell history, or process list.
 
-**Step 4: Retry the original command**
+**Step 3: Retry the original command**
 After successful auth, immediately execute whatever the user originally asked for.
 
 ### Device Slots
@@ -157,7 +131,7 @@ agent-kakaotalk auth login --device-type tablet --force
 
 ## Multi-Account
 
-KakaoTalk supports multiple accounts. Each login or extraction stores credentials separately, keyed by user ID.
+KakaoTalk supports multiple accounts. Each login stores credentials separately, keyed by user ID.
 
 ### Listing Accounts
 
@@ -262,11 +236,6 @@ agent-kakaotalk auth login --email <email> --password <password>
 agent-kakaotalk auth login --device-type pc --force
 agent-kakaotalk auth login --debug
 
-# Extract credentials from KakaoTalk desktop app
-agent-kakaotalk auth extract
-agent-kakaotalk auth extract --debug
-agent-kakaotalk auth extract --unsafely-show-secrets
-
 # Check auth status
 agent-kakaotalk auth status
 
@@ -288,13 +257,13 @@ agent-kakaotalk auth status --account <account-id>
 agent-kakaotalk auth logout --account <account-id>
 ```
 
-### Profile Command
+### Whoami Command
 
 ```bash
-# Show your KakaoTalk profile
-agent-kakaotalk profile
-agent-kakaotalk profile --pretty
-agent-kakaotalk profile --account <account-id>
+# Show current authenticated user
+agent-kakaotalk whoami
+agent-kakaotalk whoami --pretty
+agent-kakaotalk whoami --account <account-id>
 ```
 
 Output includes:
@@ -304,6 +273,12 @@ Output includes:
 - `original_profile_image_url` — original profile image URL
 - `status_message` — your status message
 - `account_display_id` — your KakaoTalk ID (may be null if not set)
+- `background_image_url` — background image URL
+- `original_background_image_url` — original background image URL
+- `fullname` — real name (may be null)
+- `account_email` — account email (may be null)
+- `pstn_number` — phone number (may be null)
+- `email_verified` — whether email is verified (may be null)
 
 ### Chat Commands
 
@@ -428,7 +403,7 @@ All commands return consistent error format:
 
 Common errors:
 
-- `No KakaoTalk credentials found` — not authenticated. Run `auth login` or `auth extract`.
+- `No KakaoTalk credentials found` — not authenticated. Run `auth login`.
 - `bad_credentials` — wrong email or password. Cached credentials from the desktop app may be stale. Ask the user to provide credentials manually with `--email` and `--password`.
 - `login_failed` — device slot conflict or unknown login error. Run with `--debug` for the full server response.
 - `passcode_request_failed` — failed to request device verification code.
@@ -513,7 +488,7 @@ See the [KakaoTalk SDK documentation](https://agent-messenger.dev/docs/sdk/kakao
 
 ## Limitations
 
-- macOS and Windows only (desktop app required for credential extraction)
+- macOS and Windows only (desktop app needed for auto-extracting email/password during login)
 - No Linux support (KakaoTalk desktop not available on Linux)
 - No file upload or download
 - No channel/chat room creation or management
@@ -549,17 +524,9 @@ pnpm dlx --package agent-messenger agent-kakaotalk chat list --pretty
 
 **NEVER run `npx agent-kakaotalk`, `bunx agent-kakaotalk`, or `pnpm dlx agent-kakaotalk`** without `--package agent-messenger`. It will fail or install a wrong package since `agent-kakaotalk` is not the npm package name.
 
-### No credentials found
-
-If `auth extract` fails:
-
-1. Make sure the KakaoTalk desktop app is installed and you're logged in
-2. Run `agent-kakaotalk auth extract --debug` for detailed diagnostics
-3. If extraction still fails, use `agent-kakaotalk auth login` instead (recommended)
-
 ### Password prompt on fresh install
 
-On fresh installs, the macOS desktop app hashes the password before caching, so the CLI cannot extract it automatically. The CLI will prompt for the password once to register the device. After registration, the password is never needed again.
+On fresh installs, the desktop app (macOS or Windows) may hash or omit the password from its cache, so the CLI cannot extract it automatically. The CLI will prompt for the password once to register the device — via a native dialog on macOS (AppKit) and Windows (PowerShell WinForms), or via a TTY prompt if a terminal is available. After registration, the password is never needed again.
 
 When the CLI returns `{"next_action": "run_interactive", ...}`, use a tmux session to let the user type their password securely. See "Handling `run_interactive`" above for the exact steps.
 
@@ -591,19 +558,6 @@ If the passcode expires before you confirm on your phone:
 2. Confirm the code on your phone within the time limit
 3. The CLI automatically completes login after confirmation
 
-### Cache.db not found (macOS)
-
-The CLI looks for KakaoTalk's cache at:
-
-```
-~/Library/Containers/com.kakao.KakaoTalkMac/Data/Library/Caches/Cache.db
-```
-
-If this file doesn't exist:
-1. Install KakaoTalk from the Mac App Store
-2. Log in and send at least one message (to populate the cache)
-3. Run `agent-kakaotalk auth extract` again
-
 ## References
 
 - [Authentication Guide](references/authentication.md)

package/skills/agent-kakaotalk/references/authentication.md

@@ -2,12 +2,9 @@
 
 ## Overview
 
-agent-kakaotalk supports two authentication methods:
+agent-kakaotalk authenticates by registering the CLI as a sub-device (tablet or PC slot) using KakaoTalk's Android sub-device API. Your desktop app and phone keep running.
 
-1. **Login** (recommended) — registers the CLI as a sub-device (tablet or PC slot). Your desktop app and phone keep running.
-2. **Extract** — reads OAuth tokens from the KakaoTalk desktop app's local cache. This reuses the desktop's credentials, which kicks the desktop session.
-
-## Method 1: Login Flow
+## Login Flow
 
 ### How It Works
 
@@ -107,65 +104,6 @@ Each device is identified by a UUID. The CLI generates one on first login and re
 
 The UUID is stored in the credentials file alongside the OAuth token.
 
-## Method 2: Extract from Desktop App
-
-### How It Works
-
-The KakaoTalk desktop app (macOS) caches HTTP requests in a SQLite database (`Cache.db`). These cached requests contain:
-
-- `Authorization` header with the OAuth token
-- Login form body with email, password, and device UUID
-- Refresh token from token renewal requests
-
-The CLI reads this cache and stores the extracted credentials.
-
-### macOS
-
-```bash
-agent-kakaotalk auth extract
-```
-
-Cache location:
-```
-~/Library/Containers/com.kakao.KakaoTalkMac/Data/Library/Caches/Cache.db
-```
-
-The CLI:
-1. Copies `Cache.db` (and WAL/SHM journals) to a temp directory
-2. Queries for requests to `talk-pilsner.kakao.com` (messaging API)
-3. Parses binary plist blobs for the OAuth token
-4. Extracts device UUID and refresh token from `login.json` / `renew_token.json` cached requests
-5. Stores extracted credentials
-
-### Windows
-
-```bash
-agent-kakaotalk auth extract
-```
-
-The CLI reads from:
-- Registry: `HKCU\Software\Kakao\KakaoTalk\DeviceInfo` (device UUID)
-- File: `%LocalAppData%\Kakao\login_list.dat` (login credentials)
-
-### Troubleshooting Extraction
-
-Use `--debug` for detailed logs:
-
-```bash
-agent-kakaotalk auth extract --debug
-```
-
-This shows:
-- Which cache path was found
-- How many cached requests were discovered
-- Which tokens were successfully extracted
-
-Use `--unsafely-show-secrets` to see full token values (debug mode only):
-
-```bash
-agent-kakaotalk auth extract --unsafely-show-secrets
-```
-
 ## Credential Storage
 
 ### Location
@@ -237,13 +175,13 @@ Output when not authenticated:
 
 ```json
 {
-  "error": "No account configured. Run \"auth login\" or \"auth extract\" first."
+  "error": "No account configured. Run \"auth login\" first."
 }
 ```
 
 ## Multi-Account
 
-KakaoTalk supports multiple accounts. Each login or extraction stores credentials separately, keyed by user ID.
+KakaoTalk supports multiple accounts. Each login stores credentials separately, keyed by user ID.
 
 ### Listing Accounts
 
@@ -316,9 +254,6 @@ If commands start failing with auth errors:
 # Try login again (reuses saved device UUID to skip passcode)
 agent-kakaotalk auth login
 
-# Or re-extract from desktop app
-agent-kakaotalk auth extract
-
 # Verify it worked
 agent-kakaotalk auth status
 ```

package/skills/agent-kakaotalk/references/common-patterns.md

@@ -144,7 +144,7 @@ NEW_MESSAGES=$(agent-kakaotalk message list "$CHAT_ID" --from "$LAST_SEEN")
 
 **When to use**: Reading long chat histories, catching up on new messages since last check.
 
-**Pagination details**: The sync loop uses the chat's latest `logId` (from `loginResult.chatDatas`) as an upper bound so it only fetches messages up to the current point, avoiding unbounded history scans. As a safety net, pagination is capped at 50 pages (50 × 80 = ~4,000 raw messages). If the cap is hit, a warning is printed to stderr and the returned messages may be incomplete.
+**Pagination details**: The CLI now prefers KakaoTalk's `MCHATLOGS` flow for history reads, fetching message batches from the requested `--from` point and returning the last N messages after deduplication and ascending sort. If that path cannot provide results, it falls back to `CHATONROOM` + `SYNCMSG` for compatibility. As a safety net, both paths are capped at 50 internal pages. A warning is printed to stderr only when that cap is actually hit and the returned history may be incomplete.
 
 ## Pattern 6: Multi-Chat Broadcast
 
@@ -391,6 +391,19 @@ try {
 }
 ```
 
+When passing credentials manually, include `deviceType` to control which session slot the LOCO connection uses:
+
+```typescript
+const client = await new KakaoTalkClient().login({
+  oauthToken: 'token',
+  userId: '1234567890',
+  deviceUuid: 'uuid',
+  deviceType: 'tablet', // 'tablet' (default, safe) or 'pc' (kicks desktop app)
+})
+```
+
+The `deviceType` determines the LOCO protocol identity: `'tablet'` sends `os: 'android'` (tablet sub-device slot), while `'pc'` sends `os: 'mac'` on macOS or `os: 'win'` on Windows (PC slot, conflicts with the desktop app). When using auto-login (`.login()` with no arguments), `deviceType` is read from stored credentials automatically.
+
 ### Auto-Reconnect
 
 `getChats`, `getMessages`, and `sendMessage` automatically reconnect once when the LOCO session dies (e.g. the KakaoTalk desktop app reclaims the session or the network drops). The reconnect is transparent — callers don't need to handle session-drop errors.

package/skills/agent-line/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-line
 description: Interact with LINE - send messages, read chats, manage conversations
-version: 2.4.0
+version: 2.6.0
 allowed-tools: Bash(agent-line:*)
 metadata:
   openclaw:
@@ -237,12 +237,12 @@ agent-line auth logout <account-id>
 agent-line auth logout --pretty
 ```
 
-### Profile Command
+### Whoami Command
 
 ```bash
-# Show your LINE profile
-agent-line profile
-agent-line profile --pretty
+# Show current authenticated user
+agent-line whoami
+agent-line whoami --pretty
 ```
 
 Output includes:

package/skills/agent-slack/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-slack
 description: Interact with Slack workspaces - send messages, read channels, manage reactions
-version: 2.4.0
+version: 2.6.0
 allowed-tools: Bash(agent-slack:*)
 metadata:
   openclaw:
@@ -149,6 +149,16 @@ agent-slack auth logout
 agent-slack auth logout <workspace-id>
 ```
 
+### Whoami Command
+
+```bash
+# Show current authenticated user
+agent-slack whoami
+agent-slack whoami --pretty
+```
+
+Output includes the authenticated user's identity information.
+
 ### Message Commands
 
 ```bash