agent-slack 0.3.0 → 0.4.1

package/README.md

@@ -27,6 +27,7 @@ npm i -g agent-slack
 - **Search**: messages + files (with filters)
 - **Artifacts**: auto-download snippets/images/files to local paths for agents
 - **Write**: reply, edit/delete messages, add reactions
+- **Channels**: create channels and invite users by id/handle/email
 - **Canvas**: fetch Slack canvases as Markdown
 
 ## Agent skill
@@ -50,6 +51,7 @@ bash ./scripts/install-skill.sh
 
 ```text
 agent-slack
+├── update                            # self-update (detects npm/bun/binary)
 ├── auth
 │   ├── whoami
 │   ├── test
@@ -60,11 +62,15 @@ agent-slack
 │   ├── get   <target>             # fetch 1 message (+ thread meta )
 │   ├── list  <target>             # fetch thread or recent channel messages
 │   ├── send  <target> <text>      # send / reply (does the right thing)
+│   ├── draft <target> [text]      # open Slack-like editor in browser
 │   ├── edit  <target> <text>      # edit a message
 │   ├── delete <target>            # delete a message
 │   └── react
 │       ├── add    <target> <emoji>
 │       └── remove <target> <emoji>
+├── channel
+│   ├── new                         # create channel
+│   └── invite                      # invite users to channel
 ├── user
 │   ├── list
 │   └── get <user>
@@ -168,6 +174,23 @@ Optional:
 agent-slack message get "https://workspace.slack.com/archives/C123/p1700000000000000" --include-reactions
 ```
 
+### Draft a message (browser editor)
+
+Opens a Slack-like WYSIWYG editor in your browser for composing messages with full formatting support (bold, italic, strikethrough, links, lists, quotes, code, code blocks).
+
+```bash
+# Open editor for a channel
+agent-slack message draft "#general"
+
+# Open editor with initial text
+agent-slack message draft "#general" "Here's my update"
+
+# Reply in a thread
+agent-slack message draft "https://workspace.slack.com/archives/C123/p1700000000000000"
+```
+
+After sending, the editor shows a "View in Slack" link to the posted message.
+
 ### Reply, edit, delete, and react
 
 ```bash
@@ -185,6 +208,31 @@ agent-slack message edit "#general" "Updated text" --workspace "myteam" --ts "17
 agent-slack message delete "#general" --workspace "myteam" --ts "1770165109.628379"
 ```
 
+### Create channels and invite users
+
+```bash
+# Create a public channel
+agent-slack channel new --name "incident-war-room"
+
+# Create a private channel
+agent-slack channel new --name "incident-leads" --private
+
+# Invite users by id, handle, or email
+agent-slack channel invite --channel "incident-war-room" --users "U01AAAA,@alice,bob@example.com"
+
+# Invite external Slack Connect users by email (restricted by default)
+agent-slack channel invite --channel "incident-war-room" --users "partner@vendor.com" --external
+
+# External invite with permission for invitees to invite others
+agent-slack channel invite --channel "incident-war-room" --users "partner@vendor.com" --external --allow-external-user-invites
+```
+
+Notes:
+
+- `--external` maps to `conversations.inviteShared` and expects email targets.
+- External invites default to restricted mode (`external_limited=true`); add `--allow-external-user-invites` to disable that restriction.
+- External invites require Slack Connect permissions/scopes in your workspace.
+
 ### Message get vs list
 
 **`message get`** fetches a single message. If the message is in a thread, it also returns thread metadata (reply count, participants) but **not** the full thread contents: