agent-messenger 2.0.0 → 2.2.0

package/docs/content/docs/cli/channeltalk.mdx

@@ -3,14 +3,14 @@ title: Channel Talk
 description: Complete reference for the agent-channeltalk CLI.
 ---
 
-> **Beta**: Channel Talk support is in beta. Some features may change. macOS and Windows only.
+> **Beta**: Channel Talk support is in beta. Some features may change.
 
 > **Tip**: `agent-channeltalk` is a shortcut for `agent-messenger channeltalk`.
 
 ## Quick Start
 
 ```bash
-# 1. Credentials are extracted automatically from Channel Talk desktop app
+# 1. Credentials are extracted automatically from Channel Talk desktop app or browser
 agent-channeltalk snapshot --pretty
 
 # 2. Send a message to a group
@@ -37,7 +37,7 @@ Channel Talk has different terminology from Slack or Discord:
 
 ### Zero-Config Credential Extraction
 
-agent-channeltalk automatically extracts cookies from the Channel Talk desktop app. No manual setup required, no API keys needed.
+agent-channeltalk automatically extracts cookies from the Channel Talk desktop app (or Chromium browser as fallback). No manual setup required, no API keys needed.
 
 ```bash
 # Usually automatic — just run any command
@@ -47,7 +47,7 @@ agent-channeltalk snapshot
 agent-channeltalk auth extract
 ```
 
-The CLI reads two cookies from the desktop app's SQLite database:
+The CLI reads two cookies from the desktop app's SQLite database (or Chromium browser cookies as fallback):
 
 - `x-account` (JWT) — your account identity
 - `ch-session-1` (JWT) — your session token
@@ -75,7 +75,7 @@ agent-channeltalk auth remove <workspace-id>
 ### Authentication Commands
 
 ```bash
-# Extract cookies from desktop app (usually automatic)
+# Extract cookies from desktop app or browser (usually automatic)
 agent-channeltalk auth extract
 
 # Check auth status
@@ -222,7 +222,7 @@ The CLI looks for the Channel Talk desktop app's cookie database in:
 **Windows:**
 1. `%APPDATA%\Channel Talk\Network\Cookies`
 
-If none exist, install the Channel Talk desktop app and log in.
+If none exist, either install the Channel Talk desktop app and log in, or log in via a Chromium browser (Chrome, Edge, Arc, Brave, etc.) — the CLI will fall back to browser extraction automatically.
 
 ### Cookies expired
 
@@ -246,7 +246,7 @@ npx -y agent-messenger channeltalk snapshot --pretty
 
 ## Limitations
 
-- macOS and Windows only (Channel Talk desktop app required)
+- Desktop app extraction: macOS and Windows only; browser fallback also supports Linux
 - No real-time events / WebSocket connection
 - No file upload support
 - No message editing or deletion

package/docs/content/docs/cli/discord.mdx

@@ -8,7 +8,7 @@ description: Complete reference for the agent-discord CLI.
 ## Quick Start
 
 ```bash
-# 1. Extract credentials from Discord desktop app (zero-config!)
+# 1. Extract credentials from Discord desktop app or browser (zero-config!)
 agent-discord auth extract
 
 # 2. Get server snapshot
@@ -22,7 +22,7 @@ agent-discord message send <channel-id> "Hello from AI agent!"
 
 ### Seamless Token Extraction
 
-agent-discord automatically extracts your Discord credentials from the desktop app:
+agent-discord automatically extracts your Discord credentials from the desktop app or Chromium browser:
 
 ```bash
 agent-discord auth extract
@@ -34,7 +34,7 @@ agent-discord auth extract --debug
 This command:
 
 - Auto-detects your platform (macOS/Linux/Windows)
-- Extracts Discord user token from the desktop app
+- Extracts Discord user token from the desktop app (with browser fallback)
 - Validates token against Discord API
 - Discovers ALL joined servers
 - Stores credentials securely in `~/.config/agent-messenger/`

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

@@ -9,26 +9,45 @@ description: Complete reference for the agent-instagram CLI.
 
 Instagram integration uses a private mobile API (not the official Graph API). No new npm dependencies are required:
 
-- Authenticates with **username and password**, with support for 2FA and login challenges.
+- **Browser cookie extraction** (recommended): Extracts session cookies from Chromium browsers (Chrome, Chrome Canary, Edge, Arc, Brave, Vivaldi, Chromium). Zero-config.
+- **Username/password auth** (fallback): Authenticates with credentials, with support for 2FA and login challenges.
 - Each command makes HTTP requests on demand. No persistent connection or background process.
 - Multiple Instagram accounts can be linked simultaneously.
 
 ## Quick Start
 
 ```bash
-# Log in with your Instagram credentials
-agent-instagram auth login
+# 1. Extract cookies from browser (recommended — zero-config)
+agent-instagram auth extract
 
-# List DM threads
+# 2. List DM threads
 agent-instagram chat list
 
-# Send a message
+# 3. Send a message
 agent-instagram message send 12345678901 "Hello from agent-instagram"
 ```
 
 ## Authentication
 
-### Username/Password Login
+### Browser Cookie Extraction (Recommended)
+
+Extracts your Instagram session cookies from a Chromium browser where you're logged into instagram.com. Zero-config, no password needed.
+
+```bash
+agent-instagram auth extract
+```
+
+This command:
+
+- Scans Chromium browser profiles for Instagram cookies (SQLite cookie database)
+- Extracts `sessionid`, `csrftoken`, `ds_user_id`, and other session cookies
+- Decrypts encrypted cookies using the browser's encryption key
+- Validates the session against the Instagram API
+- Stores credentials in `~/.config/agent-messenger/`
+- Supported browsers: Chrome, Chrome Canary, Edge, Arc, Brave, Vivaldi, Chromium
+- Auto-extraction runs when no valid session is stored, so manual extraction is rarely needed
+
+### Username/Password Login (Fallback)
 
 The CLI authenticates as a mobile client using your Instagram username and password. Your existing app sessions are never affected.
 
@@ -74,6 +93,9 @@ agent-instagram auth login --username your_username --password your_password --d
 ### Account Management
 
 ```bash
+# Extract cookies from browser (recommended)
+agent-instagram auth extract
+
 # Check current auth state
 agent-instagram auth status
 agent-instagram auth status --account <id>

package/docs/content/docs/cli/meta.json

@@ -6,6 +6,7 @@
     "discord",
     "discordbot",
     "teams",
+    "webex",
     "telegram",
     "whatsapp",
     "whatsappbot",

package/docs/content/docs/cli/slack.mdx

@@ -8,7 +8,7 @@ description: Complete reference for the agent-slack CLI.
 ## Quick Start
 
 ```bash
-# 1. Extract credentials from Slack desktop app (zero-config!)
+# 1. Extract credentials from Slack desktop app or browser (zero-config!)
 agent-slack auth extract
 
 # 2. Get workspace snapshot
@@ -22,7 +22,7 @@ agent-slack message send general "Hello from AI agent!"
 
 ### Seamless Token Extraction
 
-agent-slack automatically extracts your Slack credentials from the desktop app:
+agent-slack automatically extracts your Slack credentials from the desktop app or Chromium browser:
 
 ```bash
 agent-slack auth extract

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

@@ -8,7 +8,7 @@ description: Complete reference for the agent-teams CLI.
 ## Quick Start
 
 ```bash
-# 1. Extract credentials from Teams desktop app (zero-config!)
+# 1. Extract credentials from Teams desktop app or browser (zero-config!)
 agent-teams auth extract
 
 # 2. Get team snapshot
@@ -22,7 +22,7 @@ agent-teams message send <channel-id> "Hello from AI agent!"
 
 ### Seamless Token Extraction
 
-agent-teams automatically extracts your Microsoft Teams credentials from the desktop app:
+agent-teams automatically extracts your Microsoft Teams credentials from the desktop app or Chromium browser:
 
 ```bash
 agent-teams auth extract
@@ -34,7 +34,7 @@ agent-teams auth extract --debug
 This command:
 
 - Auto-detects your platform (macOS/Linux/Windows)
-- Extracts Teams access token from the desktop app
+- Extracts Teams access token from the desktop app (with browser fallback)
 - Validates token against Teams API
 - Discovers ALL joined teams
 - Stores credentials securely in `~/.config/agent-messenger/`
@@ -241,7 +241,7 @@ All commands support these options:
 
 ```bash
 # Teams tokens expire in 60-90 minutes! To refresh:
-# 1. Open Microsoft Teams desktop app
+# 1. Open Microsoft Teams desktop app (or log in via browser)
 # 2. Send any message (this refreshes your session cookies)
 # 3. Re-extract:
 agent-teams auth extract
@@ -281,6 +281,8 @@ Ensure Teams desktop app is:
 2. Currently running
 3. Signed in to your account
 
+Alternatively, log in via a Chromium browser (Chrome, Edge, Arc, Brave, etc.) — the CLI will fall back to browser extraction automatically.
+
 ```bash
 # Debug extraction
 agent-teams auth extract --debug

package/docs/content/docs/cli/webex.mdx

@@ -0,0 +1,310 @@
+---
+title: Webex
+description: Complete reference for the agent-webex CLI.
+---
+
+> **Tip**: `agent-webex` is a shortcut for `agent-messenger webex`.
+
+## Quick Start
+
+```bash
+# 1. Extract token from browser (recommended — messages appear as you)
+agent-webex auth extract
+
+# 2. Get workspace snapshot
+agent-webex snapshot
+
+# 3. Send a message
+agent-webex message send <space-id> "Hello from AI agent!"
+```
+
+## Authentication
+
+### Browser Token Extraction (Recommended)
+
+Extracts your first-party Webex session token from a Chromium browser where you're logged into web.webex.com. Messages appear as you — no "via agent-messenger" label. Zero-config.
+
+```bash
+agent-webex auth extract
+```
+
+This command:
+
+- Scans Chromium browser profiles for Webex localStorage data (LevelDB)
+- Extracts the first-party supertoken and device URL
+- Validates the token against the Webex API
+- Stores credentials in `~/.config/agent-messenger/`
+- Supported browsers: Chrome, Chrome Canary, Edge, Arc, Brave, Vivaldi, Chromium
+- Auto-extraction runs when no valid token is stored, so manual extraction is rarely needed
+
+### OAuth Device Grant (Fallback)
+
+Uses OAuth Device Grant flow with built-in Integration credentials. No tokens to copy, no developer portal setup needed. Messages show "via agent-messenger".
+
+```bash
+agent-webex auth login
+```
+
+This command:
+
+- Requests a device code from Webex
+- Opens your browser to the Webex verification page
+- Displays a user code for you to enter
+- Polls automatically until you approve
+- Stores access and refresh tokens securely in `~/.config/agent-messenger/`
+- Auto-refreshes expired access tokens (14-day access, 90-day refresh)
+
+### How Login Works
+
+1. Run `agent-webex auth extract` (recommended) or `agent-webex auth login` (fallback)
+2. For extraction: CLI reads your browser's Webex session — no prompts needed
+3. For Device Grant: Browser opens, enter the displayed code, CLI stores tokens
+4. Access tokens are refreshed automatically
+
+### Token Types
+
+| Type | Lifetime | Best For |
+| --- | --- | --- |
+| Browser Extraction (recommended) | Session-based (re-extract when expired) | Interactive use, sending as yourself |
+| OAuth Device Grant | 14-day access, 90-day refresh (auto-refresh) | Fallback when no browser session |
+| Bot Token | Never expires | CI/CD, long-running automation |
+| Personal Access Token (PAT) | 12 hours | Quick testing |
+
+### Authentication Commands
+
+```bash
+# Extract token from browser (recommended)
+agent-webex auth extract
+
+# Log in (Device Grant flow, opens browser)
+agent-webex auth login
+
+# Log in with custom Integration credentials
+agent-webex auth login --client-id <id> --client-secret <secret>
+
+# Log in with a bot token (never expires)
+agent-webex auth login --token <bot-token>
+
+# Log in with a PAT (12-hour lifetime)
+agent-webex auth login --token <pat>
+
+# Check auth status
+agent-webex auth status
+
+# Log out (clear stored credentials)
+agent-webex auth logout
+```
+
+### Environment Variables
+
+Override the built-in Integration credentials with your own:
+
+| Variable | Description |
+| --- | --- |
+| `AGENT_WEBEX_CLIENT_ID` | Webex Integration client ID |
+| `AGENT_WEBEX_CLIENT_SECRET` | Webex Integration client secret |
+
+Both must be set together. When set, `auth login` (without `--token`) uses these instead of the built-in credentials.
+
+## Commands
+
+### Space Commands
+
+Webex organizes conversations into "spaces" (group spaces and direct messages).
+
+```bash
+# List spaces
+agent-webex space list
+agent-webex space list --type group
+agent-webex space list --type direct
+agent-webex space list --limit 20
+
+# Get space info
+agent-webex space info <space-id>
+```
+
+### Message Commands
+
+```bash
+# Send a message
+agent-webex message send <space-id> <text>
+agent-webex message send abc123 "Hello world"
+
+# Send a markdown message
+agent-webex message send <space-id> "**Bold** and _italic_" --markdown
+
+# Send a direct message by email
+agent-webex message dm <email> <text>
+agent-webex message dm alice@example.com "Hey, quick question"
+agent-webex message dm alice@example.com "**Build failed**" --markdown
+
+# List messages in a space
+agent-webex message list <space-id>
+agent-webex message list abc123 --limit 50
+
+# Get a specific message
+agent-webex message get <message-id>
+
+# Edit a message
+agent-webex message edit <message-id> <space-id> <text>
+agent-webex message edit msg123 abc123 "Updated text" --markdown
+
+# Delete a message
+agent-webex message delete <message-id>
+agent-webex message delete <message-id> --force
+```
+
+### Member Commands
+
+```bash
+# List members of a space
+agent-webex member list <space-id>
+agent-webex member list abc123 --limit 100
+```
+
+### Snapshot Command
+
+Get comprehensive workspace state for AI agents:
+
+```bash
+# Full snapshot (spaces, members, recent messages)
+agent-webex snapshot
+
+# Filtered snapshots
+agent-webex snapshot --spaces-only
+agent-webex snapshot --members-only
+
+# Limit messages per space
+agent-webex snapshot --limit 10
+```
+
+> **Note**: `--members-only` fetches members from the first 10 spaces only (to avoid excessive API calls). Use `member list <space-id>` for specific spaces.
+
+## Global Options
+
+All commands support these options:
+
+```bash
+--pretty      # Pretty-print JSON output (default is compact JSON)
+```
+
+## Key Differences: Webex vs Slack vs Discord vs Teams
+
+| Concept | Slack | Discord | Teams | Webex |
+| --- | --- | --- | --- | --- |
+| Server/Workspace | Workspace | Guild | Team | Organization |
+| Channel | Channel | Channel | Channel | Space |
+| Channel ID format | Alphanumeric (C01234567) | Numeric snowflake | UUID | Base64-encoded opaque ID |
+| Message ID format | Timestamp (1234567890.123456) | Numeric snowflake | UUID | Base64-encoded opaque ID |
+| Token lifetime | Long-lived | Long-lived | 60-90 minutes | 14 days (auto-refresh) |
+| API | Slack Web API | Discord API | Teams Messaging API | Webex REST API |
+| Auth method | Desktop app extraction | Desktop app extraction | Desktop app extraction | OAuth Device Grant |
+| Rate limits | Moderate | Moderate | Strict | ~600 req/min |
+
+## Troubleshooting
+
+### "Not authenticated"
+
+No credentials stored. Log in first:
+
+```bash
+agent-webex auth login
+```
+
+### Token Expired (401 Unauthorized)
+
+**If using Device Grant (default)**: Tokens auto-refresh. If you still get 401s, the refresh token may have expired (after 90 days). Re-run:
+
+```bash
+agent-webex auth login
+```
+
+**If using a PAT**: Generate a new one at https://developer.webex.com/docs/getting-started
+
+**If using a bot token**: Bot tokens don't expire. Double-check the full token was copied correctly.
+
+### "Device authorization timed out"
+
+You didn't approve the request in the browser before the code expired. Run `auth login` again:
+
+```bash
+agent-webex auth login
+```
+
+### "Device authorization failed"
+
+Possible causes:
+
+- Network connectivity issues
+- Custom client ID is invalid or revoked
+- Webex API is temporarily unavailable
+
+### Rate Limiting (429 Too Many Requests)
+
+Webex allows roughly 600 API calls per minute. Wait a few seconds and retry:
+
+```bash
+# Add delays between operations in scripts
+sleep 1
+```
+
+### Space or Message Not Found
+
+Webex uses opaque Base64-encoded IDs. You can't guess them. Always get IDs from `space list` or `snapshot` first:
+
+```bash
+agent-webex space list --pretty
+```
+
+### `agent-webex: command not found`
+
+The npm package is `agent-messenger`, not `agent-webex`:
+
+```bash
+npm install -g agent-messenger
+```
+
+## AI Agent Integration
+
+See [`skills/agent-webex/`](https://github.com/devxoul/agent-messenger/tree/main/skills/agent-webex) for:
+
+- Complete skill documentation
+- Common patterns and runnable templates
+
+### Example: AI Agent Workflow
+
+```bash
+#!/bin/bash
+# Example: Daily standup automation
+
+# 1. Check auth
+if ! agent-webex auth status | jq -e '.authenticated' > /dev/null 2>&1; then
+  echo "Not authenticated. Run 'agent-webex auth login' first."
+  exit 1
+fi
+
+# 2. Get workspace context
+agent-webex snapshot --limit 5 > /tmp/webex-context.json
+
+# 3. Send standup reminder
+agent-webex message send $STANDUP_SPACE "Good morning! Time for standup."
+```
+
+### Send and Track Pattern
+
+```bash
+#!/bin/bash
+# Send a message, then update it later
+
+SPACE_ID="Y2lzY29zcGFyazovL..."
+
+# Send initial status
+RESULT=$(agent-webex message send "$SPACE_ID" "Deploying v2.1.0...")
+MSG_ID=$(echo "$RESULT" | jq -r '.id')
+
+# ... do work ...
+sleep 5
+
+# Update the message with final status
+agent-webex message edit "$MSG_ID" "$SPACE_ID" "Deployed v2.1.0 successfully!"
+```

package/docs/content/docs/sdk/meta.json

@@ -1,4 +1,4 @@
 {
   "title": "TypeScript SDK",
-  "pages": ["slack", "discord", "teams", "whatsapp", "whatsappbot", "line", "instagram", "kakaotalk", "channeltalk", "channeltalkbot"]
+  "pages": ["slack", "discord", "teams", "webex", "whatsapp", "whatsappbot", "line", "instagram", "kakaotalk", "channeltalk", "channeltalkbot"]
 }