agent-messenger 1.15.0 → 2.0.0

package/docs/content/docs/cli/line.mdx

@@ -0,0 +1,306 @@
+---
+title: LINE
+description: Complete reference for the agent-line CLI.
+---
+
+> **Tip**: After `npm install -g agent-messenger`, `agent-line` is available directly. For one-off execution without a global install you can use `npm exec --package agent-messenger agent-line ...`, `pnpm dlx --package agent-messenger agent-line ...`, `yarn dlx agent-messenger agent-line ...`, or `bunx --package agent-messenger agent-line ...`.
+
+## Key Concepts
+
+Before diving in, a few things about LINE's architecture:
+
+| Term                       | Description                                                                                         |
+| -------------------------- | --------------------------------------------------------------------------------------------------- |
+| **MID**                    | LINE's unique identifier for users, chats, and rooms. Prefixed with `u` (user), `c` (group chat), or `r` (room). |
+| **QR code login**          | The primary authentication method. Scan a QR code with the LINE mobile app to authorize the CLI.    |
+| **ANDROIDSECONDARY**       | The default device type. Registers as a secondary Android device so your phone and desktop sessions stay active. |
+| **E2EE (Letter Sealing)**  | LINE's end-to-end encryption. The CLI attempts E2EE first and falls back to plaintext if keys aren't available. |
+| **Device types**           | Controls which device slot the CLI occupies. Secondary devices coexist with your other sessions.    |
+| **PIN verification**       | During login, LINE may display a PIN that you confirm on your phone to authorize the new device.    |
+
+## Quick Start
+
+```bash
+# 1. Login (QR code — opens in browser, scan with LINE app)
+agent-line auth login
+
+# 2. List chat rooms
+agent-line chat list
+
+# 3. Send a message
+agent-line message send <chat-id> "Hello from agent-line!"
+
+# 4. List messages in a chat
+agent-line message list <chat-id>
+```
+
+## Authentication
+
+LINE offers three authentication methods. **QR code login** is recommended because it doesn't require your email or password.
+
+### Method 1: QR Code Login (Recommended)
+
+Registers the CLI as a secondary device using the **ANDROIDSECONDARY** slot by default. Your phone and desktop sessions keep running.
+
+```bash
+# Interactive — opens QR code in browser + prints to terminal
+agent-line auth login
+```
+
+On login:
+
+1. The CLI generates a QR code URL and opens it in your browser
+2. The QR code also prints in the terminal as a fallback
+3. Scan the QR code with the LINE mobile app
+4. LINE may display a PIN to confirm on your phone
+5. Login completes automatically after confirmation
+
+### Method 2: Email/Password Login
+
+Uses email and password credentials. LINE may still require PIN verification on your phone.
+
+```bash
+# Interactive — prompts for email and password
+agent-line auth login --email user@example.com --password mypass
+```
+
+### Method 3: Token Login
+
+Directly authenticates with an existing auth token. Useful when you already have a valid token from another source.
+
+```bash
+agent-line auth login --token <auth-token>
+```
+
+### Device Types
+
+LINE allows multiple simultaneous sessions depending on the device type:
+
+| Device             | Default? | Side Effect                                    |
+| ------------------ | -------- | ---------------------------------------------- |
+| ANDROIDSECONDARY   | Yes      | Secondary device, coexists with all sessions   |
+| IOSIPAD            | No       | Secondary device, coexists with all sessions   |
+| DESKTOPMAC         | No       | Replaces existing macOS desktop session        |
+| DESKTOPWIN         | No       | Replaces existing Windows desktop session      |
+
+```bash
+# Default: ANDROIDSECONDARY (safe for most users)
+agent-line auth login
+
+# Use iPad slot instead
+agent-line auth login --device IOSIPAD
+
+# Replace desktop session (kicks LINE desktop)
+agent-line auth login --device DESKTOPMAC
+```
+
+### Non-Interactive Mode (AI Agents)
+
+When running outside a TTY (no interactive terminal), the CLI returns a `next_action` JSON response instead of displaying the QR code:
+
+```json
+{
+  "next_action": "run_interactive",
+  "message": "QR code login requires an interactive terminal. Run agent-line auth login in a terminal with TTY support."
+}
+```
+
+For non-interactive environments, use `--email`/`--password` or `--token` to authenticate without a QR code.
+
+### Auth Management
+
+```bash
+# Check auth status
+agent-line auth status
+
+# List all stored accounts
+agent-line auth list
+
+# Switch active account
+agent-line auth use <account-id>
+
+# Remove stored credentials
+agent-line auth logout
+agent-line auth logout <account-id>
+```
+
+## Commands
+
+### Profile Command
+
+```bash
+# Get your LINE profile
+agent-line profile
+agent-line profile --pretty
+```
+
+Output includes:
+
+- `mid` — your LINE user ID
+- `display_name` — your display name
+- `status_message` — your status message
+- `picture_url` — profile picture URL
+
+### Friend Commands
+
+```bash
+# List all friends
+agent-line friend list
+agent-line friend list --pretty
+```
+
+Output includes:
+
+- `mid` — friend's LINE user ID
+- `display_name` — friend's display name
+- `status_message` — friend's status message
+- `picture_url` — friend's profile picture URL
+
+### Chat Commands
+
+```bash
+# List conversations (DMs and groups)
+agent-line chat list
+agent-line chat list --pretty
+
+# Limit number of chats returned
+agent-line chat list -n 20
+```
+
+Output includes:
+
+- `chat_id` — MID of the chat (u/c/r prefix)
+- `type` — chat type (user, group, room, square)
+- `display_name` — chat or contact name
+- `member_count` — number of members (groups only)
+
+### Message Commands
+
+```bash
+# List messages in a chat room
+agent-line message list <chat-id>
+agent-line message list <chat-id> -n 50
+agent-line message list <chat-id> --pretty
+
+# Send a text message
+agent-line message send <chat-id> "Hello world"
+agent-line message send <chat-id> "Hello world" --pretty
+```
+
+Each message includes:
+
+- `message_id` — unique message identifier
+- `chat_id` — which chat the message belongs to
+- `author_id` — sender's MID
+- `text` — message text content (null for non-text messages)
+- `content_type` — message type (NONE = text, IMAGE, VIDEO, etc.)
+- `sent_at` — ISO 8601 timestamp
+
+#### Fetching More Messages
+
+Use the `-n` flag to control how many messages to fetch in a single request:
+
+```bash
+# Get latest 20 messages (default)
+agent-line message list c7a8b9c0d1e2f3a4b5c6d7e8
+
+# Get 50 messages
+agent-line message list c7a8b9c0d1e2f3a4b5c6d7e8 -n 50
+
+# Get 200 messages
+agent-line message list c7a8b9c0d1e2f3a4b5c6d7e8 -n 200
+```
+
+## Global Options
+
+| Option     | Description                           |
+| ---------- | ------------------------------------- |
+| `--pretty` | Human-readable output instead of JSON |
+
+## Storage
+
+- Credentials stored in `~/.config/agent-messenger/line-credentials.json` (0600 permissions)
+- E2EE key storage in `~/.config/agent-messenger/line-storage/`
+
+## Limitations
+
+- No file upload or download
+- No channel/chat room creation or management
+- No reactions or emoji
+- No message editing or deletion
+- No search across chats
+- Plain text messages only (no photos, videos, or rich content)
+- Chat IDs are MID strings, not human-readable — use `chat list` to discover them
+
+## Troubleshooting
+
+### `agent-line: command not found`
+
+**`agent-line` is NOT the npm package name.** The npm package is `agent-messenger`.
+
+```bash
+# If installed globally
+agent-line chat list --pretty
+
+# If not installed, use --package
+npx -y --package agent-messenger agent-line chat list --pretty
+```
+
+**NEVER run `npx agent-line`** without `--package agent-messenger`. It will fail or install a wrong package.
+
+### No credentials found
+
+If `auth status` shows no account:
+
+1. Run `agent-line auth login` to authenticate via QR code
+2. Or use `agent-line auth login --email ... --password ...` for email login
+3. Verify it worked with `agent-line auth status`
+
+### QR code not displaying
+
+If the QR code doesn't open in your browser:
+
+1. Check the terminal output for the ASCII QR code fallback
+2. The QR URL is also printed — you can open it manually
+3. Make sure you're running in an interactive terminal (TTY)
+
+### E2EE errors
+
+The CLI tries E2EE (Letter Sealing) first and falls back automatically. If you see E2EE-related warnings, messages are still sent successfully without encryption.
+
+### PIN verification timeout
+
+If the PIN expires before you confirm on your phone:
+
+1. Run `agent-line auth login` again — a new QR code and PIN will be generated
+2. Confirm the PIN on your phone within the time limit
+3. The CLI automatically completes login after confirmation
+
+## SDK Usage
+
+For programmatic access, import `LineClient` directly:
+
+```typescript
+import { LineClient } from 'agent-messenger/line'
+
+const client = await new LineClient().login()
+try {
+  const profile = await client.getProfile()
+  console.log(profile.display_name)
+
+  const chats = await client.getChats()
+  const firstChat = chats[0]
+  if (!firstChat) throw new Error('No chats available')
+
+  await client.sendMessage(firstChat.chat_id, 'Hello from SDK!')
+} finally {
+  client.close()
+}
+```
+
+## AI Agent Integration
+
+See [`skills/agent-line/`](https://github.com/devxoul/agent-messenger/tree/main/skills/agent-line) for:
+
+- Complete skill documentation
+- Common patterns for AI agent workflows

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

@@ -0,0 +1,18 @@
+{
+  "title": "Platform Guides",
+  "pages": [
+    "slack",
+    "slackbot",
+    "discord",
+    "discordbot",
+    "teams",
+    "telegram",
+    "whatsapp",
+    "whatsappbot",
+    "line",
+    "instagram",
+    "kakaotalk",
+    "channeltalk",
+    "channeltalkbot"
+  ]
+}

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

@@ -0,0 +1,395 @@
+---
+title: Slack
+description: Complete reference for the agent-slack CLI.
+---
+
+> **Tip**: `agent-slack` is a shortcut for `agent-messenger slack`.
+
+## Quick Start
+
+```bash
+# 1. Extract credentials from Slack desktop app (zero-config!)
+agent-slack auth extract
+
+# 2. Get workspace snapshot
+agent-slack snapshot
+
+# 3. Send a message
+agent-slack message send general "Hello from AI agent!"
+```
+
+## Authentication
+
+### Seamless Token Extraction
+
+agent-slack automatically extracts your Slack credentials from the desktop app:
+
+```bash
+agent-slack auth extract
+
+# Use --debug for troubleshooting
+agent-slack auth extract --debug
+```
+
+This command:
+
+- Auto-detects your platform (macOS/Linux/Windows)
+- Supports both direct download and App Store versions on macOS
+- Extracts xoxc token and xoxd cookie
+- Validates tokens against Slack API
+- Discovers ALL logged-in workspaces
+- Stores credentials securely in `~/.config/agent-messenger/`
+
+### Multi-Workspace Management
+
+```bash
+# List all authenticated workspaces
+agent-slack workspace list
+
+# Switch to a different workspace
+agent-slack workspace switch <workspace-id>
+
+# Show current workspace
+agent-slack workspace current
+
+# Remove a workspace
+agent-slack workspace remove <workspace-id>
+
+# Check auth status
+agent-slack auth status
+
+# Logout from a workspace (defaults to current)
+agent-slack auth logout
+agent-slack auth logout <workspace-id>
+```
+
+## Commands
+
+### Message Commands
+
+```bash
+# Send a message
+agent-slack message send <channel> <text>
+agent-slack message send general "Hello world"
+
+# Send a threaded reply
+agent-slack message send general "Reply" --thread <ts>
+
+# List messages
+agent-slack message list <channel>
+agent-slack message list general --limit 50
+
+# Get a single message by timestamp
+agent-slack message get <channel> <ts>
+agent-slack message get general 1234567890.123456
+
+# Get thread replies
+agent-slack message replies <channel> <thread_ts>
+agent-slack message replies general 1234567890.123456 --limit 50
+
+# Search messages across workspace
+agent-slack message search <query>
+agent-slack message search "project update" --limit 50
+
+# Update a message
+agent-slack message update <channel> <ts> <new-text>
+
+# Delete a message
+agent-slack message delete <channel> <ts> --force
+
+# Schedule a message (post-at is a Unix timestamp)
+agent-slack message schedule <channel> <text> <post-at>
+agent-slack message schedule general "Friday update" 1700000000
+agent-slack message schedule general "Thread reply" 1700000000 --thread 1234567890.123456
+
+# List scheduled messages
+agent-slack message scheduled-list
+agent-slack message scheduled-list --channel general
+
+# Delete a scheduled message
+agent-slack message scheduled-delete <channel> <scheduled-message-id>
+
+# Send an ephemeral message (visible to one user only)
+agent-slack message ephemeral <channel> <user-id> <text>
+
+# Get permalink for a message
+agent-slack message permalink <channel> <ts>
+```
+
+### Channel Commands
+
+```bash
+# List channels (excludes archived by default)
+agent-slack channel list
+agent-slack channel list --type public
+agent-slack channel list --type private
+agent-slack channel list --type dm
+agent-slack channel list --include-archived
+
+# Get channel info
+agent-slack channel info <channel>
+agent-slack channel info general
+
+# Get channel message history (alias for message list)
+agent-slack channel history <channel>
+agent-slack channel history general --limit 100
+
+# Open a DM channel with a user (returns channel ID)
+agent-slack channel open <user_id>
+agent-slack channel open U0ABC123,U0DEF456
+
+# List users in a channel
+agent-slack channel users <channel>
+agent-slack channel users general --include-bots
+
+# Create a channel
+agent-slack channel create <name>
+agent-slack channel create my-project --private
+
+# Archive a channel
+agent-slack channel archive <channel>
+
+# Set channel topic
+agent-slack channel set-topic <channel> <topic>
+
+# Set channel purpose
+agent-slack channel set-purpose <channel> <purpose>
+
+# Invite users to channel
+agent-slack channel invite <channel> <users>
+agent-slack channel invite general U0ABC123,U0DEF456
+
+# Join a channel
+agent-slack channel join <channel>
+
+# Leave a channel
+agent-slack channel leave <channel>
+```
+
+### User Commands
+
+```bash
+# List users
+agent-slack user list
+agent-slack user list --include-bots
+
+# Get user info
+agent-slack user info <user>
+
+# Get current user
+agent-slack user me
+
+# Look up user by email
+agent-slack user lookup <email>
+agent-slack user lookup alice@example.com
+
+# Get user profile
+agent-slack user profile <user-id>
+
+# Set your status (emoji name without colons)
+agent-slack user set-status "In a meeting"
+agent-slack user set-status "In a meeting" --emoji calendar
+agent-slack user set-status "On vacation" --emoji palm_tree --expiration 1700100000
+```
+
+### Reaction Commands
+
+```bash
+# Add reaction
+agent-slack reaction add <channel> <ts> <emoji>
+agent-slack reaction add general 1234567890.123456 thumbsup
+
+# Remove reaction
+agent-slack reaction remove <channel> <ts> <emoji>
+
+# List reactions
+agent-slack reaction list <channel> <ts>
+```
+
+### File Commands
+
+```bash
+# Upload file
+agent-slack file upload <channel> <path>
+agent-slack file upload general ./report.pdf
+
+# List files
+agent-slack file list
+agent-slack file list --channel general
+
+# Get file info
+agent-slack file info <file-id>
+
+# Download file
+agent-slack file download <file-id>
+agent-slack file download <file-id> [output-path]
+agent-slack file download F0ABC123 ./downloads/
+
+# Delete a file
+agent-slack file delete <file-id>
+```
+
+### Snapshot Command
+
+Get comprehensive workspace state for AI agents:
+
+```bash
+# Full snapshot
+agent-slack snapshot
+
+# Filtered snapshots
+agent-slack snapshot --channels-only
+agent-slack snapshot --users-only
+
+# Limit messages per channel
+agent-slack snapshot --limit 10
+```
+
+### Activity Commands
+
+```bash
+# List activity feed
+agent-slack activity list
+agent-slack activity list --limit 50
+
+# Show only unread activity
+agent-slack activity list --unread
+
+# Filter by activity types
+agent-slack activity list --types thread_reply,message_reaction,at_user,at_channel,keyword
+```
+
+### Unread Commands
+
+```bash
+# Get unread counts for all channels
+agent-slack unread counts
+
+# Get thread subscription details
+agent-slack unread threads <channel> <thread_ts>
+
+# Mark channel as read up to a timestamp
+agent-slack unread mark <channel> <ts>
+```
+
+### Drafts Commands
+
+```bash
+# List message drafts
+agent-slack drafts list
+agent-slack drafts list --limit 10
+agent-slack drafts list --cursor <next_cursor>
+```
+
+### Saved Items Commands
+
+```bash
+# List saved items
+agent-slack saved list
+agent-slack saved list --limit 10
+agent-slack saved list --cursor <next_cursor>
+```
+
+### Sections Commands
+
+```bash
+# List channel sections (sidebar folders)
+agent-slack sections list
+```
+
+### Pin Commands
+
+```bash
+# Pin a message
+agent-slack pin add <channel> <ts>
+agent-slack pin add general 1234567890.123456
+
+# Unpin a message
+agent-slack pin remove <channel> <ts>
+
+# List pinned messages
+agent-slack pin list <channel>
+agent-slack pin list general
+```
+
+### Bookmark Commands
+
+```bash
+# Add a bookmark to a channel
+agent-slack bookmark add <channel> <title> <link>
+agent-slack bookmark add general "Design Docs" "https://example.com/docs" --emoji :bookmark:
+
+# Edit a bookmark
+agent-slack bookmark edit <channel> <bookmark-id> --title "New Title" --link "https://new.url"
+
+# Remove a bookmark
+agent-slack bookmark remove <channel> <bookmark-id>
+
+# List bookmarks
+agent-slack bookmark list <channel>
+```
+
+### Reminder Commands
+
+```bash
+# Add a reminder (time is a Unix timestamp)
+agent-slack reminder add <text> <time>
+agent-slack reminder add "Review PR" 1700000000
+agent-slack reminder add "Team standup" 1700003600 --user U0ABC123
+
+# List reminders
+agent-slack reminder list
+
+# Complete a reminder
+agent-slack reminder complete <reminder-id>
+
+# Delete a reminder
+agent-slack reminder delete <reminder-id>
+```
+
+### Usergroup Commands
+
+```bash
+# List all user groups
+agent-slack usergroup list
+agent-slack usergroup list --include-disabled
+agent-slack usergroup list --include-users
+
+# Create a user group
+agent-slack usergroup create <name>
+agent-slack usergroup create "Marketing Team" --handle marketing-team --description "Marketing gurus"
+agent-slack usergroup create "Engineering" --channels C012ABC,C034DEF
+
+# Update a user group
+agent-slack usergroup update <usergroup-id> --name "New Name"
+agent-slack usergroup update S0616NG6M --handle new-handle --description "Updated description"
+agent-slack usergroup update S0616NG6M --channels C012ABC,C034DEF
+
+# Enable a disabled user group
+agent-slack usergroup enable <usergroup-id>
+
+# Disable a user group
+agent-slack usergroup disable <usergroup-id>
+
+# List members of a user group
+agent-slack usergroup members <usergroup-id>
+agent-slack usergroup members S0616NG6M --include-disabled
+
+# Update members of a user group (replaces all members)
+agent-slack usergroup members-update <usergroup-id> <user-ids>
+agent-slack usergroup members-update S0616NG6M U060R4BJ4,U060RNRCZ
+```
+
+### Emoji Commands
+
+```bash
+# List custom workspace emoji
+agent-slack emoji list
+```
+
+## AI Agent Integration
+
+See [`skills/agent-slack/`](https://github.com/devxoul/agent-messenger/tree/main/skills/agent-slack) for:
+
+- Complete skill documentation
+- Runnable templates