agent-messenger 2.28.0 → 2.29.1

package/dist/src/tui/adapters/teams-adapter.js

@@ -1,7 +1,9 @@
 import { TeamsClient } from '../../platforms/teams/client.js';
+import { TeamsListener } from '../../platforms/teams/listener.js';
 export class TeamsAdapter {
     name = 'Teams';
     client = null;
+    listener = null;
     teamId = null;
     teamName = null;
     teams = [];
@@ -41,6 +43,25 @@ export class TeamsAdapter {
         this.ensureClient();
         await this.client.sendMessage(this.teamId, channelId, text);
     }
+    async startListening(onMessage) {
+        this.ensureClient();
+        const listener = new TeamsListener(this.client);
+        listener.on('message', (message) => {
+            onMessage({
+                id: message.id,
+                channelId: message.chatId,
+                author: message.author.displayName,
+                content: message.content,
+                timestamp: message.timestamp,
+            });
+        });
+        await listener.start();
+        this.listener = listener;
+    }
+    stopListening() {
+        this.listener?.stop();
+        this.listener = null;
+    }
     async getWorkspaces() {
         return this.teams;
     }

package/dist/src/tui/adapters/teams-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"teams-adapter.js","sourceRoot":"","sources":["../../../../src/tui/adapters/teams-adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"teams-adapter.js","sourceRoot":"","sources":["../../../../src/tui/adapters/teams-adapter.ts"],"names":[],"mappings":"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"}

package/dist/src/tui/app.js

@@ -190,7 +190,7 @@ export async function createApp() {
         left: 0,
         top: 1,
         width: 28,
-        height: '100%-4',
+        height: '100%-5',
         border: { type: 'line' },
         style: {
             border: { fg: '#444444' },
@@ -207,7 +207,7 @@ export async function createApp() {
         left: 28,
         top: 1,
         right: 0,
-        height: '100%-4',
+        height: '100%-5',
         border: { type: 'line' },
         style: {
             border: { fg: '#444444' },
@@ -222,7 +222,7 @@ export async function createApp() {
     });
     const inputBox = blessed.textarea({
         parent: screen,
-        bottom: 0,
+        bottom: 1,
         left: 0,
         right: 0,
         height: 3,

package/docs/content/docs/cli/instagram.mdx

@@ -179,6 +179,7 @@ Thread IDs are numeric strings returned by `chat list` (e.g. `340282366841710300
 
 - Credentials stored in `~/.config/agent-messenger/instagram-credentials.json`
 - Session data stored in `~/.config/agent-messenger/instagram/<account-id>/`
+- A machine-level device profile (synthetic Android device identifiers, no secrets) stored in `~/.config/agent-messenger/instagram/device.json` and shared across all accounts, so repeat logins present a consistent device fingerprint
 
 ## Limitations
 

package/docs/content/docs/cli/teams.mdx

@@ -253,6 +253,42 @@ All commands support these options:
 --team <id>   # Use specific team (overrides current team)
 ```
 
+## Real-time Events (SDK)
+
+Real-time message streaming is available through the SDK's `TeamsListener`, which
+connects to Teams' internal trouter WebSocket as a user — no bot registration and
+no public HTTP endpoint. There is no CLI `watch` command; use the SDK:
+
+```typescript
+import { TeamsClient, TeamsListener } from 'agent-messenger/teams'
+
+const client = await new TeamsClient().login()
+const listener = new TeamsListener(client)
+
+listener.on('message', async (message) => {
+  console.log(`New message in ${message.chatId}: ${message.content}`)
+
+  // Channel messages carry team/channel context and parsed @mentions.
+  if (message.conversationType === 'channel') {
+    for (const mention of message.mentions) {
+      console.log(`Mentioned: ${mention.displayName} (${mention.mri})`)
+    }
+    await client.sendMessage(message.teamId!, message.channelId!, 'On it 👍')
+  }
+})
+
+await listener.start()
+```
+
+Each `message` is a `TeamsRealtimeMessage`. Alongside the unchanged
+`chatId`/`content`/`author`, it carries `conversationType` (`'chat'` or
+`'channel'`), `teamId`/`channelId` (set for channel messages, for use with
+`sendMessage`), and `mentions` (always present, empty when there are no
+`@mentions`; each is `{ id, mri?, displayName }`).
+
+The listener reuses your extracted credentials, so the Teams desktop app must be
+logged in. It reconnects automatically and re-authenticates on token expiry.
+
 ## Key Differences: Teams vs Discord vs Slack
 
 | Concept           | Slack                         | Discord           | Teams                     |

package/docs/content/docs/sdk/teams.mdx

@@ -206,9 +206,39 @@ import type {
   TeamsAccount,
   TeamsConfig,
   TeamsConfigLegacy,
+  TeamsRealtimeMessage,
+  TeamsMention,
+  TeamsListenerEventMap,
+  TeamsTrouterGenericEvent,
 } from 'agent-messenger/teams'
 ```
 
+The real-time listener emits `TeamsRealtimeMessage`:
+
+```typescript
+interface TeamsRealtimeMessage {
+  id: string
+  chatId: string
+  conversationType: 'chat' | 'channel'
+  teamId?: string // set for channel messages
+  channelId?: string // set for channel messages
+  content: string // HTML-stripped text
+  mentions: TeamsMention[] // always present; empty when no @mentions
+  author: { id: string; displayName: string }
+  messageType: string
+  timestamp: string
+}
+
+interface TeamsMention {
+  id: string // positional mention index
+  mri?: string // Skype MRI of the mentioned user/tag
+  displayName: string
+}
+```
+
+These are type-only exports (no Zod schema — the listener constructs the event
+internally rather than parsing untrusted input).
+
 ### Zod Schemas
 
 Runtime-validated schemas are also exported for parsing API responses:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-messenger",
-  "version": "2.28.0",
+  "version": "2.29.1",
   "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/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.28.0
+version: 2.29.1
 allowed-tools: Bash(agent-channeltalk:*)
 metadata:
   openclaw:

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.28.0
+version: 2.29.1
 allowed-tools: Bash(agent-channeltalkbot:*)
 metadata:
   openclaw:

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.28.0
+version: 2.29.1
 allowed-tools: Bash(agent-discord:*)
 metadata:
   openclaw:

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.28.0
+version: 2.29.1
 allowed-tools: Bash(agent-discordbot:*)
 metadata:
   openclaw:

package/skills/agent-imessage/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-imessage
 description: Interact with iMessage on a Mac via the imsg tool - send messages, read chats, watch for new messages
-version: 2.28.0
+version: 2.29.1
 allowed-tools: Bash(agent-imessage:*)
 metadata:
   openclaw:

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.28.0
+version: 2.29.1
 allowed-tools: Bash(agent-instagram:*)
 metadata:
   openclaw:

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

@@ -196,10 +196,21 @@ Session data (cookies and tokens) is stored per account:
 ~/.config/agent-messenger/instagram/<account-id>/
 ```
 
+A device profile (randomized Android device identifiers) is generated once and
+shared across all accounts on this machine, so repeat logins present a
+consistent device fingerprint:
+
+```
+~/.config/agent-messenger/instagram/device.json
+```
+
 ### Security
 
 - Credentials file permissions: `0600` (owner read/write only)
 - Session cookies are stored in plaintext on disk
+- `device.json` holds no secrets — only synthetic device identifiers — but is
+  shared across accounts, so all accounts on this machine share one device
+  fingerprint
 - Keep these files secure. They grant full access to your Instagram account
 - Never commit to version control
 

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.28.0
+version: 2.29.1
 allowed-tools: Bash(agent-kakaotalk:*)
 metadata:
   openclaw:

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.28.0
+version: 2.29.1
 allowed-tools: Bash(agent-line:*)
 metadata:
   openclaw:

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.28.0
+version: 2.29.1
 allowed-tools: Bash(agent-slack:*)
 metadata:
   openclaw:

package/skills/agent-slackbot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-slackbot
 description: Interact with Slack workspaces using bot tokens - send messages, read channels, manage reactions
-version: 2.28.0
+version: 2.29.1
 allowed-tools: Bash(agent-slackbot:*)
 metadata:
   openclaw:

package/skills/agent-teams/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-teams
 description: Interact with Microsoft Teams - send messages, read channels, manage reactions
-version: 2.28.0
+version: 2.29.1
 allowed-tools: Bash(agent-teams:*)
 metadata:
   openclaw:
@@ -33,11 +33,30 @@ agent-teams channel list <team-id>
 
 ## Authentication
 
-Credentials are extracted automatically from the Teams desktop app (or Chromium browser as fallback) on first use. No manual setup required — just run any command and authentication happens silently in the background.
+Two co-equal ways to sign in — pick whichever fits:
 
-Teams tokens expire in 60-90 minutes. The CLI automatically re-extracts a fresh token when the current one expires, so you don't need to manage token lifecycle manually.
+1. **`agent-teams auth login`** (work/school **or** personal Microsoft accounts) — device-code sign-in. Open the printed URL, enter the code, and approve in your browser. No desktop app or browser extraction needed. It prompts for your Microsoft email (or pass `--email <email>`) and auto-detects work vs personal, then starts the matching flow; pass `--account-type work|personal` to force it and skip detection. Only `auth login` stores the AAD refresh token required by `message search`.
+2. **`agent-teams auth extract`** — zero-config extraction from the Teams desktop app, falling back to a Chromium browser. Best when you're already signed into Teams locally. Yields a Skype token only — sufficient for messaging, but **not** for `message search` (see below).
 
-**IMPORTANT**: Always use `agent-teams auth extract` to obtain tokens. The CLI extracts from the desktop app first, falling back to Chromium browsers if the app isn't installed.
+Credentials are also extracted automatically on first use of any command if none are stored, so `auth extract` can happen silently in the background.
+
+Teams tokens are short-lived (60-90 minutes for extraction, a few hours for device-code). **Device-code accounts (`auth login`) refresh silently** — the CLI re-mints an expired token from the stored refresh token with no re-login needed. Extraction accounts re-extract automatically as long as you're still signed into the Teams desktop app or a supported browser; if that fails, re-run `auth extract` (or switch to `auth login`).
+
+### Non-interactive `auth login` (agents / CI)
+
+When there's no TTY, `auth login` splits into two calls:
+
+```bash
+# 1. Start — returns verification_uri, user_code, and device_code as JSON.
+#    Pass --email to auto-detect the account type (no prompt without a TTY),
+#    or --account-type work|personal to force it.
+agent-teams auth login --email <email>
+
+# 2. After the user approves in a browser, finish with the device_code
+agent-teams auth login --device-code <device_code>
+```
+
+`--client-id <id>` overrides the AAD client ID on either call (or set `AGENT_TEAMS_CLIENT_ID`). `--account-type <work|personal>` selects the account (default `work`); it is preserved across the two-call flow, so pass it to both calls when signing in to a personal account non-interactively.
 
 ### Multi-Team Support
 
@@ -145,6 +164,10 @@ If a memorized ID returns an error (channel not found, team not found), remove i
 ### Auth Commands
 
 ```bash
+# Sign in via device code (personal Microsoft accounts).
+agent-teams auth login
+agent-teams auth login --device-code <code>   # finish a non-interactive login
+
 # Extract token from Teams desktop app or browser (usually automatic)
 agent-teams auth extract
 agent-teams auth extract --debug
@@ -191,8 +214,14 @@ agent-teams message get <team-id> <channel-id> <message-id>
 
 # Delete a message
 agent-teams message delete <team-id> <channel-id> <message-id> --force
+
+# Search messages across Teams (requires `auth login` — see Authentication)
+agent-teams message search <query>
+agent-teams message search "deploy" --limit 10 --from 0
 ```
 
+`message search` requires an `auth login` account: it queries Microsoft's Substrate search API with an AAD token that `auth extract` (cookie-based) cannot provide. Cookie-only accounts get a clear error telling you to run `auth login`. `--limit` is a positive integer (default 20); `--from` is a non-negative offset for pagination (default 0).
+
 ### Channel Commands
 
 ```bash
@@ -279,8 +308,15 @@ agent-teams file list <team-id> <channel-id>
 
 # Get file info
 agent-teams file info <team-id> <channel-id> <file-id>
+
+# Download a file (to a path or directory; defaults to the current dir)
+agent-teams file download <team-id> <channel-id> <file-id>
+agent-teams file download <team-id> <channel-id> <file-id> ./report.pdf
+agent-teams file download <team-id> <channel-id> <file-id> ./downloads/ --pretty
 ```
 
+`file download` output: `{ "id", "name", "size", "content_type", "path" }` where `path` is where the file was written. Inline/image attachments download with the extracted Skype token and work for any signed-in account; SharePoint/OneDrive documents download via Microsoft Graph and require an `auth login` account (cookie-only `auth extract` accounts get a clear error telling you to run `auth login`).
+
 ### Snapshot Command
 
 Get team overview for AI agents (brief by default):
@@ -427,13 +463,53 @@ await client.addReaction(teams[0].id, channels[0].id, msg.id, 'like')
 await client.uploadFile(teams[0].id, channels[0].id, './report.pdf')
 ```
 
+### Real-time Events
+
+Stream Teams chat messages in real time over the internal trouter WebSocket — as a user, no bot and no public endpoint. Requires the Teams desktop app to be logged in.
+
+```typescript
+import { TeamsClient, TeamsListener } from 'agent-messenger/teams'
+
+const client = await new TeamsClient().login()
+const listener = new TeamsListener(client)
+
+listener.on('message', async (message) => {
+  console.log(`New message in ${message.chatId}: ${message.content}`)
+
+  // Channel messages carry team/channel context and parsed @mentions.
+  if (message.conversationType === 'channel') {
+    for (const mention of message.mentions) {
+      console.log(`Mentioned: ${mention.displayName} (${mention.mri})`)
+    }
+    await client.sendMessage(message.teamId!, message.channelId!, 'On it 👍')
+  }
+})
+
+await listener.start()
+```
+
+Each `message` is a `TeamsRealtimeMessage`:
+
+| Field | Type | Notes |
+| --- | --- | --- |
+| `id` | `string` | Message id |
+| `chatId` | `string` | Conversation id (unchanged) |
+| `conversationType` | `'chat' \| 'channel'` | `'channel'` for team-channel messages |
+| `teamId` | `string?` | Set for channel messages (use with `sendMessage`) |
+| `channelId` | `string?` | Set for channel messages (use with `sendMessage`) |
+| `content` | `string` | HTML-stripped text (unchanged) |
+| `mentions` | `TeamsMention[]` | Always present; empty when no `@mentions`. Each is `{ id, mri?, displayName }` |
+| `author` | `{ id, displayName }` | Sender (unchanged) |
+| `messageType` | `string` | e.g. `Text`, `RichText/Html` |
+| `timestamp` | `string` | ISO timestamp |
+
 ### Full API Reference
 
 See the [Teams SDK documentation](https://agent-messenger.dev/docs/sdk/teams) for complete method signatures, types, schemas, and examples.
 
 ## Limitations
 
-- No real-time events / WebSocket connection
+- Real-time events are SDK-only (`TeamsListener`); the CLI has no `watch` command
 - No voice/video channel support
 - No team management (create/delete channels, roles)
 - Personal accounts: chats only (no teams/channels); use the `chat` commands
@@ -441,7 +517,7 @@ See the [Teams SDK documentation](https://agent-messenger.dev/docs/sdk/teams) fo
 - No webhook support
 - Plain text messages only (no adaptive cards in v1)
 - User tokens only (no app tokens)
-- **Token expires in 60-90 minutes** - auto-refreshed, but requires Teams desktop app or browser to be logged in
+- **Tokens are short-lived** - device-code (`auth login`) accounts refresh silently from the stored refresh token; extraction accounts auto-refresh but need the Teams desktop app or browser to still be logged in
 
 ## Troubleshooting
 

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

@@ -95,10 +95,21 @@ The tool searches within:
 
 ### What Gets Extracted
 
-- **skypetoken_asm**: Authentication token for Teams API
+- **skypetoken_asm**: Authentication token for Teams API (sent as the `X-Skypetoken` header)
 - **teams**: All teams you're a member of
 - **token_extracted_at**: Timestamp for expiry tracking
 
+### Real-time Auth (`authtoken` / id_token)
+
+The real-time `TeamsListener` (SDK) additionally needs an OAuth Bearer token to
+authenticate its trouter WebSocket connection. This is **not** persisted with
+your credentials — the client extracts it on demand from the Teams `authtoken`
+cookie (a JWE, stored URL-encoded with a `Bearer=` prefix), decrypted with the
+same keychain machinery as `skypetoken_asm`. The listener re-extracts it on
+every (re)connection, so it always uses the current cookie value. Because it is
+read live from the desktop app's cookie store, the Teams desktop app must be
+logged in for real-time streaming to work.
+
 ## Multi-Team Management
 
 ### List Teams
@@ -181,6 +192,25 @@ Credentials are stored in:
 - Keep this file secure - it grants access to your Teams account
 - **Tokens auto-expire in 60-90 minutes** - provides some security
 
+## AAD Tokens (required for `message search`)
+
+Most commands use only the Skype token above. **`message search` is different**: it queries Microsoft's Substrate search API, which requires an AAD Bearer token for the `substrate.office.com` audience — a token the Skype cookie cannot produce.
+
+- **Only `auth login` (device-code) can mint it.** That flow stores an `aad_refresh_token` (and `aad_client_id`) alongside the Skype token. `auth extract` (cookie extraction) yields a Skype token only and therefore **cannot** run `message search` — the CLI returns an actionable error telling you to run `auth login`.
+- **Work and personal accounts** are both supported by `auth login`. It detects the account type from your Microsoft email (prompted interactively, or via `--email <email>`) and starts the matching flow; `--account-type work|personal` forces it and skips detection. If a personal account still reaches the work flow, the CLI stops with an actionable hint to rerun with `--account-type personal`.
+- At search time, the CLI silently exchanges the stored refresh token for a short-lived Substrate access token (per-scope AAD grant), caches it in memory only (never written to disk), and rotates the refresh token. The same mechanism can mint a Graph token for other AAD-gated features.
+
+Credentials for an `auth login` account therefore include additional fields:
+
+```json
+{
+  "account_type": "work",
+  "auth_method": "device-code",
+  "aad_refresh_token": "0.AXoA...redacted...",
+  "aad_client_id": "5e3ce6c0-2b1f-4285-8d4b-75ee78787346"
+}
+```
+
 ## Authentication Status
 
 Check if you're authenticated:

package/skills/agent-telegram/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-telegram
 description: Interact with Telegram through TDLib - authenticate, inspect chats, and send messages
-version: 2.28.0
+version: 2.29.1
 allowed-tools: Bash(agent-telegram:*)
 ---
 

package/skills/agent-telegrambot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-telegrambot
 description: Interact with Telegram using bot tokens - send messages, read chats, manage reactions
-version: 2.28.0
+version: 2.29.1
 allowed-tools: Bash(agent-telegrambot:*)
 metadata:
   openclaw:

package/skills/agent-webex/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-webex
 description: Interact with Cisco Webex - send messages, read spaces, manage memberships
-version: 2.28.0
+version: 2.29.1
 allowed-tools: Bash(agent-webex:*)
 metadata:
   openclaw:

package/skills/agent-webexbot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-webexbot
 description: Interact with Cisco Webex using bot tokens - send messages, reply in threads, upload and download files, look up people, read spaces, manage memberships, stream real-time events
-version: 2.28.0
+version: 2.29.1
 allowed-tools: Bash(agent-webexbot:*)
 metadata:
   openclaw:

package/skills/agent-wechatbot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-wechatbot
 description: Interact with WeChat Official Account using API credentials - send messages, manage templates, list followers
-version: 2.28.0
+version: 2.29.1
 allowed-tools: Bash(agent-wechatbot:*)
 metadata:
   openclaw:

package/skills/agent-whatsapp/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-whatsapp
 description: Interact with WhatsApp - send messages, read chats, manage conversations
-version: 2.28.0
+version: 2.29.1
 allowed-tools: Bash(agent-whatsapp:*)
 metadata:
   openclaw:

package/skills/agent-whatsappbot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-whatsappbot
 description: Interact with WhatsApp using Cloud API credentials - send messages, manage templates
-version: 2.28.0
+version: 2.29.1
 allowed-tools: Bash(agent-whatsappbot:*)
 metadata:
   openclaw: