agent-messenger 2.10.2 → 2.11.0

package/docs/content/docs/cli/slackbot.mdx

@@ -54,6 +54,8 @@ oauth_config:
       - users:read.email
       - reactions:write
       - reactions:read
+      - files:read
+      - files:write
 
 settings:
   org_deploy_enabled: false
@@ -108,18 +110,20 @@ agent-slackbot auth remove deploy
 
 ### Scopes Reference
 
-| Scope              | Used For                         |
-| ------------------ | -------------------------------- |
-| `chat:write`       | Sending and updating messages    |
-| `channels:history` | Reading public channel messages  |
-| `channels:read`    | Listing public channels          |
-| `channels:join`    | Joining public channels          |
-| `groups:history`   | Reading private channel messages |
-| `groups:read`      | Listing private channels         |
-| `users:read`       | Listing users                    |
-| `users:read.email` | Reading user emails              |
-| `reactions:write`  | Adding/removing reactions        |
-| `reactions:read`   | Listing reactions                |
+| Scope              | Used For                             |
+| ------------------ | ------------------------------------ |
+| `chat:write`       | Sending and updating messages        |
+| `channels:history` | Reading public channel messages      |
+| `channels:read`    | Listing public channels              |
+| `channels:join`    | Joining public channels              |
+| `groups:history`   | Reading private channel messages     |
+| `groups:read`      | Listing private channels             |
+| `users:read`       | Listing users                        |
+| `users:read.email` | Reading user emails                  |
+| `reactions:write`  | Adding/removing reactions            |
+| `reactions:read`   | Listing reactions                    |
+| `files:read`       | Listing/inspecting/downloading files |
+| `files:write`      | Uploading and deleting files         |
 
 ### Environment Variables (CI/CD)
 
@@ -166,8 +170,15 @@ agent-slackbot message update <channel> <ts> <new-text>
 
 # Delete a message (bot's own messages only)
 agent-slackbot message delete <channel> <ts> --force
+
+# Show typing/status indicator in an AI Assistant thread
+agent-slackbot message typing <channel> <thread_ts>
+agent-slackbot message typing C0ACZKTDDC0 1234567890.123456 "is analyzing..."
+agent-slackbot message typing C0ACZKTDDC0 1234567890.123456 ""   # clear status
 ```
 
+`message typing` calls Slack's `assistant.threads.setStatus` API. It only works inside **AI Assistant threads** (not regular channels/DMs) and requires the `chat:write` bot scope. The status auto-clears when your bot posts the next message, or after 2 minutes if no message is sent. Pass an empty string `""` to clear the status manually.
+
 ### Channel Commands
 
 ```bash
@@ -202,18 +213,45 @@ agent-slackbot reaction add C0ACZKTDDC0 1234567890.123456 thumbsup
 agent-slackbot reaction remove <channel> <ts> <emoji>
 ```
 
+### File Commands
+
+```bash
+# Upload a file to a channel
+agent-slackbot file upload <channel> <path>
+agent-slackbot file upload C0ACZKTDDC0 ./report.pdf
+agent-slackbot file upload C0ACZKTDDC0 ./log.txt --filename build-log.txt
+agent-slackbot file upload C0ACZKTDDC0 ./screenshot.png --thread 1234567890.123456 --comment "FYI"
+
+# List files visible to the bot
+agent-slackbot file list
+agent-slackbot file list --channel C0ACZKTDDC0
+agent-slackbot file list --user U123 --limit 50
+
+# Show file details
+agent-slackbot file info <file-id>
+
+# Download a file by ID
+agent-slackbot file download <file-id>
+agent-slackbot file download F0123ABC ./downloads/
+
+# Delete a file (bot's own files only)
+agent-slackbot file delete <file-id> --force
+```
+
+`file upload` requires the `files:write` scope; the read commands (`list`, `info`, `download`) require `files:read`. The bot can only delete files it uploaded.
+
 ## Key Differences from agent-slack
 
-| Feature              | agent-slack                     | agent-slackbot               |
-| -------------------- | ------------------------------- | ---------------------------- |
-| Token type           | User token (xoxc-)              | Bot token (xoxb-)            |
-| Token source         | Auto-extracted from desktop app | Manual from Slack App config |
-| Message search       | Yes                             | No                           |
-| File operations      | Yes                             | No                           |
-| Snapshot             | Yes                             | No                           |
-| Edit/delete messages | Any message                     | Bot's own only               |
-| Multi-bot support    | N/A                             | Yes (`--bot` flag)           |
-| CI/CD friendly       | Requires desktop app            | Yes                          |
+| Feature              | agent-slack                     | agent-slackbot                                 |
+| -------------------- | ------------------------------- | ---------------------------------------------- |
+| Token type           | User token (xoxc-)              | Bot token (xoxb-)                              |
+| Token source         | Auto-extracted from desktop app | Manual from Slack App config                   |
+| Message search       | Yes                             | No                                             |
+| File operations      | Yes                             | Upload/list/info/download/delete (with scopes) |
+| Snapshot             | Yes                             | No                                             |
+| Edit/delete messages | Any message                     | Bot's own only                                 |
+| Multi-bot support    | N/A                             | Yes (`--bot` flag)                             |
+| CI/CD friendly       | Requires desktop app            | Yes                                            |
 
 ## AI Agent Integration
 

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

@@ -29,6 +29,10 @@ agent-teams auth extract
 
 # Use --debug for troubleshooting
 agent-teams auth extract --debug
+
+# Scan custom Chromium profile/user-data dirs (repeatable or comma-separated)
+agent-teams auth extract --browser-profile ~/browser-data
+agent-teams auth extract --browser-profile "$HOME/work-profile,$HOME/personal-profile"
 ```
 
 This command:
@@ -38,6 +42,7 @@ This command:
 - Validates token against Teams API
 - Discovers ALL joined teams
 - Stores credentials securely in `~/.config/agent-messenger/`
+- Supports `--browser-profile <path>` for agent-browser profiles, custom Chrome user data dirs, or portable browser profiles
 
 ### TOKEN EXPIRY WARNING
 

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

@@ -26,6 +26,8 @@ Extracts your first-party Webex session token from a Chromium browser where you'
 
 ```bash
 agent-webex auth extract
+agent-webex auth extract --browser-profile ~/browser-data
+agent-webex auth extract --browser-profile "$HOME/work-profile,$HOME/personal-profile"
 ```
 
 This command:
@@ -36,6 +38,7 @@ This command:
 - Validates the token against the Webex API
 - Stores credentials and encryption keys in `~/.config/agent-messenger/`
 - Supported browsers: Chrome, Chrome Canary, Edge, Arc, Brave, Vivaldi, Chromium
+- Supports `--browser-profile <path>` for agent-browser profiles, custom Chrome user data dirs, or portable browser profiles; repeatable and comma-separated values are accepted
 - Auto-extraction runs when no valid token is stored, so manual extraction is rarely needed
 - Messages are encrypted client-side (JWE/AES-256-GCM) when encryption keys are available; falls back to plaintext otherwise. Re-run `auth extract` to refresh keys for new conversations.
 

package/docs/content/docs/sdk/channeltalkbot.mdx

@@ -180,7 +180,7 @@ const blocks = ChannelBotClient.wrapTextInBlocks('Hello, world!')
 
 ## ChannelBotCredentialManager
 
-Manages Channel Talk Bot credentials stored at `~/.config/agent-messenger/channelbot-credentials.json`. Files are written with `0o600` permissions. The environment variables `E2E_CHANNELBOT_ACCESS_KEY` and `E2E_CHANNELBOT_ACCESS_SECRET` take precedence when calling `getCredentials()` without a `workspaceId`.
+Manages Channel Talk Bot credentials stored at `~/.config/agent-messenger/channeltalkbot-credentials.json`. Files are written with `0o600` permissions. If a legacy `channelbot-credentials.json` exists from an older version, it is migrated automatically on first load. The environment variables `E2E_CHANNELTALKBOT_ACCESS_KEY` and `E2E_CHANNELTALKBOT_ACCESS_SECRET` (or legacy `E2E_CHANNELBOT_*`) take precedence when calling `getCredentials()` without a `workspaceId`.
 
 ```typescript
 import { ChannelBotCredentialManager } from 'agent-messenger/channeltalkbot'
@@ -273,6 +273,43 @@ import {
 } from 'agent-messenger/channeltalkbot'
 ```
 
+## ChannelBotError
+
+All client methods throw `ChannelBotError` on failure. The error includes a `code` field describing the failure category — useful for retry logic and structured error reporting.
+
+```typescript
+import { ChannelBotClient, ChannelBotError } from 'agent-messenger/channeltalkbot'
+
+const client = await new ChannelBotClient().login({ accessKey, accessSecret })
+
+try {
+  const blocks = ChannelBotClient.wrapTextInBlocks('Hello!')
+  await client.sendGroupMessage('group_id', blocks, 'My Bot')
+} catch (err) {
+  if (err instanceof ChannelBotError) {
+    console.error(`[${err.code}] ${err.message}`)
+
+    if (err.code === 'rate_limited') {
+      // Back off and retry
+    } else if (err.code === 'missing_access_key' || err.code === 'missing_access_secret') {
+      // Re-run auth set with valid credentials
+    }
+  } else {
+    throw err
+  }
+}
+```
+
+Error codes thrown by the client:
+
+- `missing_access_key` — `login()` called without an access key
+- `missing_access_secret` — `login()` called without an access secret
+- `not_authenticated` — Method called before `login()` resolved
+- `rate_limited` — Channel Talk returned 429; the client retries with backoff, then surfaces this if retries are exhausted
+- `network_error` — Fetch failed (DNS, connection refused, timeout)
+- `http_<status>` — Channel Talk returned an unexpected status (e.g., `http_500`) without a structured `code` in the error body
+- Channel Talk API error codes (string) — When the response body includes a `code` field, it is propagated as-is. See the [Channel Talk Open API error reference](https://developers.channel.io/reference/error-handling) for codes such as `WorkspaceNotFoundException`, `BotNotFoundException`, etc.
+
 ## Examples
 
 ### Auto-Reply Bot