@alankyshum/slack-cli 1.0.0 → 1.1.0

package/README.md

@@ -1,3 +1,6 @@
+[![npm version](https://img.shields.io/npm/v/@alankyshum/slack-cli)](https://www.npmjs.com/package/@alankyshum/slack-cli)
+[![PyPI version](https://img.shields.io/pypi/v/slack-cli-agent)](https://pypi.org/project/slack-cli-agent/)
+
 # slack-cli
 
 A Slack CLI designed for coding agents (Claude Code, Cursor, etc.) that provides structured JSON access to Slack workspaces via the Web API.

package/bin/slack-cli

@@ -7,7 +7,7 @@
 #   slack-cli auth [--domain <workspace>.slack.com]  - Extract tokens from browser
 #   slack-cli search <query>       - Search messages (Slack query syntax)
 #   slack-cli read <channel> [n]   - Read messages from a channel
-#   slack-cli draft <channel> <msg> - Save a draft locally (does NOT send)
+#   slack-cli draft <channel> <msg> - Save a draft to Slack (syncs across devices)
 #   slack-cli send <draft_id>      - Send a draft (with confirmation)
 #   slack-cli help                 - Show full help
 
@@ -15,7 +15,6 @@ set -euo pipefail
 
 CONFIG_DIR="${SLACK_CLI_HOME:-$HOME/.slack-cli}"
 CREDS_FILE="$CONFIG_DIR/credentials.json"
-DRAFTS_FILE="$CONFIG_DIR/drafts.json"
 SLACK_API="https://slack.com/api"
 
 # ── Helpers ──────────────────────────────────────────────────────────────────
@@ -36,6 +35,13 @@ _check_creds() {
 _token() { jq -r .token "$CREDS_FILE"; }
 _cookie() { jq -r .d_cookie "$CREDS_FILE"; }
 _domain() { jq -r '.domain // empty' "$CREDS_FILE"; }
+_workspace_api() {
+  # Enterprise Grid uses workspace-specific URL for drafts API
+  local domain
+  domain=$(_domain)
+  local workspace="${domain%%.*}"
+  echo "https://grid-${workspace}.enterprise.slack.com/api"
+}
 
 _api() {
   local method="$1"; shift
@@ -57,12 +63,46 @@ _api() {
   echo "$response"
 }
 
+_api_workspace() {
+  # Multipart form API call to workspace-specific URL (matches Slack client behavior)
+  local method="$1"; shift
+  # Remaining args are -F field pairs
+  local response
+  response=$(curl -s "$(_workspace_api)/$method" \
+    -H "Cookie: d=$(_cookie)" \
+    -F "token=$(_token)" \
+    "$@")
+
+  local ok err
+  ok=$(echo "$response" | jq -r '.ok')
+  if [[ "$ok" != "true" ]]; then
+    err=$(echo "$response" | jq -r '.error // empty')
+    if [[ "$err" == "token_revoked" || "$err" == "invalid_auth" || "$err" == "not_authed" ]]; then
+      echo '{"ok":false,"error":"Token expired. Run: slack-cli auth --domain '"$(_domain)"'"}' | jq .
+      exit 1
+    fi
+  fi
+  echo "$response"
+}
+
 _urlencode() {
   python3 -c "import sys,urllib.parse; print(urllib.parse.quote(sys.stdin.read().strip()))" 2>/dev/null
 }
 
 _resolve_channel() {
   local name="${1#\#}"
+  name="${name#@}"
+
+  # User ID → open a DM conversation to get channel ID
+  if [[ "$name" =~ ^U[A-Z0-9]+$ ]]; then
+    local response channel_id
+    response=$(_api conversations.open "users=$name")
+    channel_id=$(echo "$response" | jq -r '.channel.id // empty')
+    echo "$channel_id"
+    return
+  fi
+
+  # Otherwise search for channel by name
   local response channel_id
   response=$(_api search.messages "query=in:%23${name}&count=1")
   channel_id=$(echo "$response" | jq -r '.messages.matches[0]?.channel.id // empty')
@@ -359,7 +399,15 @@ cmd_draft() {
   fi
 
   local channel_id="$channel"
-  if [[ ! "$channel" =~ ^[CDG][A-Z0-9]+$ ]]; then
+  if [[ "$channel" =~ ^[CDG][A-Z0-9]+$ ]]; then
+    : # Already a channel ID
+  elif [[ "$channel" =~ ^U[A-Z0-9]+$ ]]; then
+    channel_id=$(_resolve_channel "$channel")
+    if [[ -z "$channel_id" || "$channel_id" == "null" ]]; then
+      echo "{\"ok\":false,\"error\":\"Could not open DM with user: $channel\"}" | jq .
+      return 1
+    fi
+  else
     channel_id=$(_resolve_channel "$channel")
     if [[ -z "$channel_id" || "$channel_id" == "null" ]]; then
       echo "{\"ok\":false,\"error\":\"Could not resolve channel: $channel\"}" | jq .
@@ -367,35 +415,66 @@ cmd_draft() {
     fi
   fi
 
-  mkdir -p "$CONFIG_DIR"
-  local draft_id
-  draft_id=$(date +%s)
-  local draft_entry
-  draft_entry=$(jq -n \
-    --arg id "$draft_id" \
-    --arg channel "$channel" \
-    --arg channel_id "$channel_id" \
-    --arg message "$message" \
-    --arg created "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
-    '{id:$id, channel:$channel, channel_id:$channel_id, message:$message, created:$created, status:"draft"}')
-
-  if [[ -f "$DRAFTS_FILE" ]]; then
-    local existing
-    existing=$(cat "$DRAFTS_FILE")
-    echo "$existing" | jq --argjson new "$draft_entry" '. + [$new]' > "$DRAFTS_FILE"
+  # Create server-side draft via Slack API (syncs across devices)
+  local client_msg_id
+  client_msg_id=$(python3 -c "import uuid; print(str(uuid.uuid4()))")
+
+  local blocks
+  blocks=$(jq -n --arg text "$message" \
+    '[{type:"rich_text", elements:[{type:"rich_text_section", elements:[{type:"text", text:$text}]}]}]')
+  local destinations
+  destinations=$(jq -n --arg ch "$channel_id" '[{channel_id:$ch}]')
+
+  local response
+  response=$(_api_workspace drafts.create \
+    -F "blocks=$blocks" \
+    -F "client_msg_id=$client_msg_id" \
+    -F "attachments=" \
+    -F "destinations=$destinations" \
+    -F "file_ids=[]" \
+    -F "is_from_composer=false" \
+    -F "_x_reason=MessageInput:updateDraft" \
+    -F "_x_mode=online" \
+    -F "_x_sonic=true" \
+    -F "_x_app_name=client")
+
+  local ok
+  ok=$(echo "$response" | jq -r '.ok')
+  if [[ "$ok" == "true" ]]; then
+    echo "$response" | jq '{ok, action:"draft_saved", info:"Draft saved to Slack (syncs across devices). Use slack-cli drafts to list, slack-cli send <id> to send.", draft: {id:.draft.id, channel_id:.draft.destinations[0].channel_id, text:([.draft.blocks[]?.elements[]?.elements[]? | select(.type == "text") | .text] | join("")), created:.draft.date_created}}'
   else
-    echo "[$draft_entry]" | jq . > "$DRAFTS_FILE"
+    echo "$response" | jq '{ok, error}'
+    return 1
   fi
-
-  echo "$draft_entry" | jq '{ok:true, action:"draft_saved", info:"Use '\''slack-cli drafts'\'' to list, '\''slack-cli send <id>'\'' to send.", draft:.}'
 }
 
 cmd_drafts() {
-  if [[ ! -f "$DRAFTS_FILE" ]]; then
-    echo '{"ok":true,"drafts":[]}' | jq .
-    return 0
+  _check_creds
+
+  # List server-side drafts from Slack API
+  local response
+  response=$(_api_workspace drafts.list \
+    -F "is_active=true" \
+    -F "limit=25" \
+    -F "_x_reason=client-drafts-list" \
+    -F "_x_mode=online" \
+    -F "_x_sonic=true" \
+    -F "_x_app_name=client")
+
+  local ok
+  ok=$(echo "$response" | jq -r '.ok')
+  if [[ "$ok" == "true" ]]; then
+    echo "$response" | jq '{ok, drafts: [.drafts[]? | select(.is_deleted == false and .is_sent == false) | {
+      id: .id,
+      channel_id: .destinations[0].channel_id,
+      text: ([.blocks[]?.elements[]?.elements[]? | select(.type == "text") | .text] | join("")),
+      created: .date_created,
+      last_updated_ts: .last_updated_ts
+    }]}'
+  else
+    echo "$response" | jq '{ok, error}'
+    return 1
   fi
-  jq '{ok:true, drafts:[.[] | select(.status == "draft")]}' "$DRAFTS_FILE"
 }
 
 cmd_send() {
@@ -406,21 +485,26 @@ cmd_send() {
     return 1
   fi
 
-  if [[ ! -f "$DRAFTS_FILE" ]]; then
-    echo '{"ok":false,"error":"No drafts found"}' | jq .
-    return 1
-  fi
+  # Fetch drafts to find the one to send
+  local drafts_response
+  drafts_response=$(_api_workspace drafts.list \
+    -F "is_active=true" \
+    -F "limit=25" \
+    -F "_x_reason=client-drafts-list" \
+    -F "_x_mode=online" \
+    -F "_x_sonic=true" \
+    -F "_x_app_name=client")
 
   local draft
-  draft=$(jq -r --arg id "$draft_id" '.[] | select(.id == $id and .status == "draft")' "$DRAFTS_FILE")
+  draft=$(echo "$drafts_response" | jq -r --arg id "$draft_id" '.drafts[]? | select(.id == $id and .is_deleted == false and .is_sent == false)')
   if [[ -z "$draft" ]]; then
-    echo '{"ok":false,"error":"Draft not found or already sent"}' | jq .
+    echo '{"ok":false,"error":"Draft not found or already sent. Use slack-cli drafts to list available drafts."}' | jq .
     return 1
   fi
 
   local channel_id message
-  channel_id=$(echo "$draft" | jq -r '.channel_id')
-  message=$(echo "$draft" | jq -r '.message')
+  channel_id=$(echo "$draft" | jq -r '.destinations[0].channel_id')
+  message=$(echo "$draft" | jq -r '[.blocks[]?.elements[]?.elements[]? | select(.type == "text") | .text] | join("")')
 
   echo "About to send to channel $channel_id:" >&2
   echo "$message" >&2
@@ -440,8 +524,17 @@ cmd_send() {
   local ok
   ok=$(echo "$response" | jq -r '.ok')
   if [[ "$ok" == "true" ]]; then
-    jq --arg id "$draft_id" '[.[] | if .id == $id then .status = "sent" else . end]' "$DRAFTS_FILE" > "${DRAFTS_FILE}.tmp"
-    mv "${DRAFTS_FILE}.tmp" "$DRAFTS_FILE"
+    # Delete the server-side draft after successful send
+    local now_ts
+    now_ts=$(python3 -c "import time; print(f'{time.time():.6f}')")
+    _api_workspace drafts.delete \
+      -F "draft_id=$draft_id" \
+      -F "client_last_updated_ts=$now_ts" \
+      -F "_x_reason=MessageInput:deleteDraft" \
+      -F "_x_mode=online" \
+      -F "_x_sonic=true" \
+      -F "_x_app_name=client" > /dev/null 2>&1
+
     echo "$response" | jq '{ok, action:"sent", channel:.channel, ts:.ts}'
   else
     echo "$response" | jq '{ok, error}'
@@ -523,7 +616,7 @@ COMMANDS:
   search <query>             Search messages (full Slack query syntax)
   read <channel> [count]     Read messages from a channel (name or ID)
   unreads                    Show recent activity
-  draft <channel> <message>  Save a draft locally (does NOT send)
+  draft <channel> <message>  Save a draft to Slack (syncs across devices)
   drafts                     List saved drafts
   send <draft_id>            Send a draft (interactive confirmation)
   channels                   List your channels

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alankyshum/slack-cli",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Slack CLI for coding agents — search, read, and draft messages via the Slack Web API using browser-extracted tokens",
   "bin": {
     "slack-cli": "./bin/slack-cli"