agent-messenger 1.0.0 → 1.2.0

package/skills/agent-discord/references/authentication.md

@@ -23,7 +23,7 @@ This command:
 3. Reads the LevelDB storage containing session data
 4. Extracts user token
 5. Validates token against Discord API before saving
-6. Discovers ALL joined guilds (servers)
+6. Discovers ALL joined servers
 7. Stores credentials securely in `~/.config/agent-messenger/discord-credentials.json`
 
 ### Platform-Specific Paths
@@ -49,16 +49,16 @@ The tool searches within:
 ### What Gets Extracted
 
 - **token**: User token (starts with a base64-encoded user ID)
-- **guilds**: All servers you're a member of
+- **servers**: All servers you're a member of
 
-## Multi-Guild Management
+## Multi-Server Management
 
-### List Guilds
+### List Servers
 
-See all available guilds:
+See all available servers:
 
 ```bash
-agent-discord guild list
+agent-discord server list
 ```
 
 Output:
@@ -77,22 +77,22 @@ Output:
 ]
 ```
 
-### Switch Guild
+### Switch Server
 
-Change the active guild:
+Change the active server:
 
 ```bash
-agent-discord guild switch 9876543210987654321
+agent-discord server switch 9876543210987654321
 ```
 
-All subsequent commands will use the selected guild until you switch again.
+All subsequent commands will use the selected server until you switch again.
 
-### Current Guild
+### Current Server
 
-Check which guild is active:
+Check which server is active:
 
 ```bash
-agent-discord guild current
+agent-discord server current
 ```
 
 ## Credential Storage
@@ -109,15 +109,15 @@ Credentials are stored in:
 ```json
 {
   "token": "user_token_here",
-  "current_guild": "1234567890123456789",
-  "guilds": {
+  "current_server": "1234567890123456789",
+  "servers": {
     "1234567890123456789": {
-      "guild_id": "1234567890123456789",
-      "guild_name": "My Server"
+      "server_id": "1234567890123456789",
+      "server_name": "My Server"
     },
     "9876543210987654321": {
-      "guild_id": "9876543210987654321",
-      "guild_name": "Another Server"
+      "server_id": "9876543210987654321",
+      "server_name": "Another Server"
     }
   }
 }
@@ -142,8 +142,8 @@ Output when authenticated:
 {
   "authenticated": true,
   "user": "username",
-  "current_guild": "1234567890123456789",
-  "guilds_count": 5
+  "current_server": "1234567890123456789",
+  "servers_count": 5
 }
 ```
 
@@ -190,7 +190,7 @@ This shows:
 - Which Discord directory was found
 - Token extraction progress
 - Token validation results
-- Guild discovery details
+- Server discovery details
 
 ### "Discord desktop app not found"
 
@@ -254,7 +254,7 @@ With extracted credentials, agent-discord has the same permissions as you in Dis
 ### Best Practices
 
 1. **Protect credentials.json**: Never commit to version control
-2. **Use guild switching**: Keep different contexts separate
+2. **Use server switching**: Keep different contexts separate
 3. **Re-extract periodically**: Keep tokens fresh
 4. **Revoke if compromised**: Change your Discord password to invalidate tokens
 
@@ -270,11 +270,11 @@ mkdir -p ~/.config/agent-messenger
 cat > ~/.config/agent-messenger/discord-credentials.json << 'EOF'
 {
   "token": "YOUR_TOKEN_HERE",
-  "current_guild": "1234567890123456789",
-  "guilds": {
+  "current_server": "1234567890123456789",
+  "servers": {
     "1234567890123456789": {
-      "guild_id": "1234567890123456789",
-      "guild_name": "My Server"
+      "server_id": "1234567890123456789",
+      "server_name": "My Server"
     }
   }
 }

package/skills/agent-discord/references/common-patterns.md

@@ -70,7 +70,7 @@ done
 
 **Limitations**: Polling-based, not real-time. For production bots, use Discord's Gateway API with a proper bot token.
 
-## Pattern 3: Get Guild Overview
+## Pattern 3: Get Server Overview
 
 **Use case**: Understand server state before taking action
 
@@ -81,11 +81,11 @@ done
 SNAPSHOT=$(agent-discord snapshot)
 
 # Extract key information
-GUILD_NAME=$(echo "$SNAPSHOT" | jq -r '.guild.name')
+SERVER_NAME=$(echo "$SNAPSHOT" | jq -r '.server.name')
 CHANNEL_COUNT=$(echo "$SNAPSHOT" | jq -r '.channels | length')
 MEMBER_COUNT=$(echo "$SNAPSHOT" | jq -r '.members | length')
 
-echo "Server: $GUILD_NAME"
+echo "Server: $SERVER_NAME"
 echo "Channels: $CHANNEL_COUNT"
 echo "Members: $MEMBER_COUNT"
 
@@ -207,7 +207,7 @@ fi
 CHANNEL_ID="1234567890123456789"
 USERNAME="john"
 
-# Get guild members
+# Get server members
 USERS=$(agent-discord user list)
 USER_ID=$(echo "$USERS" | jq -r --arg name "$USERNAME" '.[] | select(.username | contains($name)) | .id' | head -1)
 
@@ -303,26 +303,26 @@ send_with_retry "$CHANNEL_ID" "Important message!"
 
 **When to use**: Production scripts, critical notifications, unreliable networks.
 
-## Pattern 10: Switch Guilds for Operations
+## Pattern 10: Switch Servers for Operations
 
 **Use case**: Work with multiple Discord servers
 
 ```bash
 #!/bin/bash
 
-# List all guilds
-GUILDS=$(agent-discord guild list)
-echo "Available guilds:"
-echo "$GUILDS" | jq -r '.[] | "  \(.name) (\(.id)) \(if .current then "[current]" else "" end)"'
+# List all servers
+SERVERS=$(agent-discord server list)
+echo "Available servers:"
+echo "$SERVERS" | jq -r '.[] | "  \(.name) (\(.id)) \(if .current then "[current]" else "" end)"'
 
-# Switch to a specific guild
-TARGET_GUILD=$(echo "$GUILDS" | jq -r '.[] | select(.name | contains("Production")) | .id')
-if [ -n "$TARGET_GUILD" ]; then
-  agent-discord guild switch "$TARGET_GUILD"
-  echo "Switched to Production guild"
+# Switch to a specific server
+TARGET_SERVER=$(echo "$SERVERS" | jq -r '.[] | select(.name | contains("Production")) | .id')
+if [ -n "$TARGET_SERVER" ]; then
+  agent-discord server switch "$TARGET_SERVER"
+  echo "Switched to Production server"
 fi
 
-# Now operations use the new guild
+# Now operations use the new server
 agent-discord channel list
 ```
 

package/skills/agent-discord/templates/post-message.sh

@@ -128,15 +128,15 @@ if echo "$AUTH_STATUS" | jq -e '.error' > /dev/null 2>&1; then
 fi
 
 USER_NAME=$(echo "$AUTH_STATUS" | jq -r '.user // "Unknown"')
-GUILD_ID=$(echo "$AUTH_STATUS" | jq -r '.current_guild // ""')
+SERVER_ID=$(echo "$AUTH_STATUS" | jq -r '.current_server // ""')
 echo -e "${GREEN}Authenticated as: $USER_NAME${NC}"
 
-if [ -z "$GUILD_ID" ]; then
-  echo -e "${RED}No guild selected!${NC}"
+if [ -z "$SERVER_ID" ]; then
+  echo -e "${RED}No server selected!${NC}"
   echo ""
-  echo "Run this to select a guild:"
-  echo "  agent-discord guild list"
-  echo "  agent-discord guild switch <guild-id>"
+  echo "Run this to select a server:"
+  echo "  agent-discord server list"
+  echo "  agent-discord server switch <server-id>"
   exit 1
 fi
 

package/skills/agent-discord/templates/{guild-summary.sh → server-summary.sh}

@@ -1,16 +1,16 @@
 #!/bin/bash
 #
-# guild-summary.sh - Generate a comprehensive Discord guild summary
+# server-summary.sh - Generate a comprehensive Discord server summary
 #
 # Usage:
-#   ./guild-summary.sh [--json]
+#   ./server-summary.sh [--json]
 #
 # Options:
 #   --json  Output raw JSON instead of formatted text
 #
 # Example:
-#   ./guild-summary.sh
-#   ./guild-summary.sh --json > summary.json
+#   ./server-summary.sh
+#   ./server-summary.sh --json > summary.json
 
 set -euo pipefail
 
@@ -45,17 +45,17 @@ if echo "$AUTH_STATUS" | jq -e '.error' > /dev/null 2>&1; then
   exit 1
 fi
 
-CURRENT_GUILD=$(echo "$AUTH_STATUS" | jq -r '.current_guild // ""')
-if [ -z "$CURRENT_GUILD" ]; then
-  echo -e "${RED}No guild selected!${NC}" >&2
+CURRENT_SERVER=$(echo "$AUTH_STATUS" | jq -r '.current_server // ""')
+if [ -z "$CURRENT_SERVER" ]; then
+  echo -e "${RED}No server selected!${NC}" >&2
   echo "" >&2
-  echo "Run this to select a guild:" >&2
-  echo "  agent-discord guild list" >&2
-  echo "  agent-discord guild switch <guild-id>" >&2
+  echo "Run this to select a server:" >&2
+  echo "  agent-discord server list" >&2
+  echo "  agent-discord server switch <server-id>" >&2
   exit 1
 fi
 
-echo -e "${YELLOW}Fetching guild snapshot...${NC}" >&2
+echo -e "${YELLOW}Fetching server snapshot...${NC}" >&2
 SNAPSHOT=$(agent-discord snapshot 2>&1)
 
 if echo "$SNAPSHOT" | jq -e '.error' > /dev/null 2>&1; then
@@ -70,8 +70,8 @@ if [ "$OUTPUT_JSON" = true ]; then
   exit 0
 fi
 
-GUILD_NAME=$(echo "$SNAPSHOT" | jq -r '.guild.name // "Unknown"')
-GUILD_ID=$(echo "$SNAPSHOT" | jq -r '.guild.id // "Unknown"')
+SERVER_NAME=$(echo "$SNAPSHOT" | jq -r '.server.name // "Unknown"')
+SERVER_ID=$(echo "$SNAPSHOT" | jq -r '.server.id // "Unknown"')
 
 CHANNELS=$(echo "$SNAPSHOT" | jq '.channels // []')
 CHANNEL_COUNT=$(echo "$CHANNELS" | jq 'length')
@@ -87,11 +87,11 @@ MESSAGE_COUNT=$(echo "$MESSAGES" | jq 'length')
 
 echo ""
 echo -e "${BOLD}${BLUE}=====================================================${NC}"
-echo -e "${BOLD}${BLUE}  Discord Guild Summary${NC}"
+echo -e "${BOLD}${BLUE}  Discord Server Summary${NC}"
 echo -e "${BOLD}${BLUE}=====================================================${NC}"
 echo ""
-echo -e "${BOLD}Guild:${NC}     $GUILD_NAME"
-echo -e "${BOLD}ID:${NC}        $GUILD_ID"
+echo -e "${BOLD}Server:${NC}    $SERVER_NAME"
+echo -e "${BOLD}ID:${NC}        $SERVER_ID"
 echo ""
 
 echo -e "${BOLD}${CYAN}Channels (${CHANNEL_COUNT} total)${NC}"
@@ -153,15 +153,15 @@ echo -e "  ${GREEN}# Get user info${NC}"
 FIRST_USER=$(echo "$MEMBERS" | jq -r '.[0].id // "USER_ID"')
 echo -e "  agent-discord user info $FIRST_USER"
 echo ""
-echo -e "  ${GREEN}# Switch to another guild${NC}"
-echo -e "  agent-discord guild list"
-echo -e "  agent-discord guild switch <guild-id>"
+echo -e "  ${GREEN}# Switch to another server${NC}"
+echo -e "  agent-discord server list"
+echo -e "  agent-discord server switch <server-id>"
 echo ""
 
 echo -e "${BOLD}${BLUE}=====================================================${NC}"
 echo ""
 
-SNAPSHOT_FILE="guild-snapshot-$(date +%Y%m%d-%H%M%S).json"
+SNAPSHOT_FILE="server-snapshot-$(date +%Y%m%d-%H%M%S).json"
 echo "$SNAPSHOT" > "$SNAPSHOT_FILE"
 echo -e "${GREEN}Full snapshot saved to: $SNAPSHOT_FILE${NC}"
 echo ""

package/skills/agent-slack/SKILL.md

@@ -162,6 +162,59 @@ agent-slack file list --channel general
 agent-slack file info <file-id>
 ```
 
+### Unread Commands
+
+```bash
+# List unread channels
+agent-slack unread list
+agent-slack unread list --pretty
+
+# Get unread counts summary
+agent-slack unread count
+
+# Mark channel as read
+agent-slack mark read <channel>
+agent-slack mark read general
+```
+
+### Activity Commands
+
+```bash
+# List activity feed (mentions, reactions, replies)
+agent-slack activity list
+agent-slack activity list --limit 50
+```
+
+### Saved Items Commands
+
+```bash
+# List saved items
+agent-slack saved list
+
+# Add item to saved
+agent-slack saved add <channel> <ts>
+agent-slack saved add general 1234567890.123456
+
+# Remove item from saved
+agent-slack saved remove <channel> <ts>
+```
+
+### Drafts Commands
+
+```bash
+# List all drafts
+agent-slack drafts list
+agent-slack drafts list --pretty
+```
+
+### Channel Sections Commands
+
+```bash
+# List channel sections (sidebar organization)
+agent-slack section list
+agent-slack section list --pretty
+```
+
 ### Snapshot Command
 
 Get comprehensive workspace state for AI agents:

package/skills/agent-teams/SKILL.md

@@ -0,0 +1,292 @@
+---
+name: agent-teams
+description: Interact with Microsoft Teams - send messages, read channels, manage reactions
+allowed-tools: Bash(agent-teams:*)
+---
+
+# Agent Teams
+
+A TypeScript CLI tool that enables AI agents and humans to interact with Microsoft Teams through a simple command interface. Features seamless token extraction from the Teams desktop app and multi-team support.
+
+## TOKEN EXPIRY WARNING
+
+**CRITICAL**: Microsoft Teams tokens expire in **60-90 minutes**! Unlike Discord/Slack, Teams tokens have a short lifespan. You MUST:
+
+1. Check token validity before operations
+2. Re-extract credentials when tokens expire
+3. Handle `401 Unauthorized` errors gracefully
+
+```bash
+# Always check auth status first
+agent-teams auth status
+
+# If expired, re-extract
+agent-teams auth extract
+```
+
+## Quick Start
+
+```bash
+# Extract credentials from Teams desktop app (zero-config)
+agent-teams auth extract
+
+# Get team snapshot
+agent-teams snapshot
+
+# Send a message
+agent-teams message send <channel-id> "Hello from AI agent!"
+
+# List channels
+agent-teams channel list
+```
+
+## Authentication
+
+### Seamless Token Extraction
+
+agent-teams automatically extracts your Teams credentials from the desktop app:
+
+```bash
+# Just run this - no manual token copying needed
+agent-teams auth extract
+
+# Use --debug for troubleshooting
+agent-teams auth extract --debug
+```
+
+This command:
+- Auto-detects your platform (macOS/Linux/Windows)
+- Extracts skypetoken_asm from Teams desktop app's Cookies SQLite database
+- Validates token against Teams API before saving
+- Discovers ALL joined teams
+- Stores credentials securely in `~/.config/agent-messenger/`
+
+### Multi-Team Support
+
+```bash
+# List all available teams
+agent-teams team list
+
+# Switch to a different team
+agent-teams team switch <team-id>
+
+# Show current team
+agent-teams team current
+
+# Check auth status (includes token expiry info)
+agent-teams auth status
+```
+
+## Commands
+
+### Message Commands
+
+```bash
+# Send a message
+agent-teams message send <channel-id> <content>
+agent-teams message send 19:abc123@thread.tacv2 "Hello world"
+
+# List messages
+agent-teams message list <channel-id>
+agent-teams message list 19:abc123@thread.tacv2 --limit 50
+
+# Get a single message by ID
+agent-teams message get <channel-id> <message-id>
+
+# Delete a message
+agent-teams message delete <channel-id> <message-id> --force
+```
+
+### Channel Commands
+
+```bash
+# List channels in current team
+agent-teams channel list
+
+# Get channel info
+agent-teams channel info <channel-id>
+agent-teams channel info 19:abc123@thread.tacv2
+
+# Get channel history (alias for message list)
+agent-teams channel history <channel-id> --limit 100
+```
+
+### Team Commands
+
+```bash
+# List all teams
+agent-teams team list
+
+# Get team info
+agent-teams team info <team-id>
+
+# Switch active team
+agent-teams team switch <team-id>
+
+# Show current team
+agent-teams team current
+```
+
+### User Commands
+
+```bash
+# List team members
+agent-teams user list
+
+# Get user info
+agent-teams user info <user-id>
+
+# Get current user
+agent-teams user me
+```
+
+### Reaction Commands
+
+```bash
+# Add reaction (use emoji name)
+agent-teams reaction add <channel-id> <message-id> <emoji>
+agent-teams reaction add 19:abc123@thread.tacv2 1234567890 like
+
+# Remove reaction
+agent-teams reaction remove <channel-id> <message-id> <emoji>
+
+# List reactions on a message
+agent-teams reaction list <channel-id> <message-id>
+```
+
+### File Commands
+
+```bash
+# Upload file
+agent-teams file upload <channel-id> <path>
+agent-teams file upload 19:abc123@thread.tacv2 ./report.pdf
+
+# List files in channel
+agent-teams file list <channel-id>
+
+# Get file info
+agent-teams file info <channel-id> <file-id>
+```
+
+### Snapshot Command
+
+Get comprehensive team state for AI agents:
+
+```bash
+# Full snapshot
+agent-teams snapshot
+
+# Filtered snapshots
+agent-teams snapshot --channels-only
+agent-teams snapshot --users-only
+
+# Limit messages per channel
+agent-teams snapshot --limit 10
+```
+
+Returns JSON with:
+- Team metadata (id, name)
+- Channels (id, name, type, description)
+- Recent messages (id, content, author, timestamp)
+- Members (id, displayName, email)
+
+## Output Format
+
+### JSON (Default)
+
+All commands output JSON by default for AI consumption:
+
+```json
+{
+  "id": "19:abc123@thread.tacv2",
+  "content": "Hello world",
+  "author": "John Doe",
+  "timestamp": "2024-01-15T10:30:00.000Z"
+}
+```
+
+### Pretty (Human-Readable)
+
+Use `--pretty` flag for formatted output:
+
+```bash
+agent-teams channel list --pretty
+```
+
+## Key Differences from Discord/Slack
+
+| Feature | Teams | Discord | Slack |
+|---------|-------|---------|-------|
+| Server terminology | Team | Guild | Workspace |
+| Channel identifiers | UUID format (19:xxx@thread.tacv2) | Snowflake IDs | Channel name or ID |
+| Token storage | Cookies SQLite | LevelDB | LevelDB |
+| Token expiry | **60-90 minutes** | Rarely expires | Rarely expires |
+| Mentions | `<at id="user-id">Name</at>` | `<@user_id>` | `<@USER_ID>` |
+
+**Important**: Teams uses UUID-style channel IDs (like `19:abc123@thread.tacv2`). You cannot use channel names directly - use `channel list` to find IDs first.
+
+## Common Patterns
+
+See `references/common-patterns.md` for typical AI agent workflows.
+
+## Templates
+
+See `templates/` directory for runnable examples:
+- `post-message.sh` - Send messages with error handling
+- `monitor-channel.sh` - Monitor channel for new messages (with token refresh)
+- `team-summary.sh` - Generate team summary
+
+## Error Handling
+
+All commands return consistent error format:
+
+```json
+{
+  "error": "Not authenticated. Run \"auth extract\" first."
+}
+```
+
+Common errors:
+- `Not authenticated`: No valid token - run `auth extract`
+- `Token expired`: Token has expired (60-90 min limit) - run `auth extract` again
+- `No current team set`: Run `team switch <id>` first
+- `Message not found`: Invalid message ID
+- `Channel not found`: Invalid channel ID
+- `401 Unauthorized`: Token expired - re-authenticate immediately
+
+## Configuration
+
+Credentials stored in: `~/.config/agent-messenger/teams-credentials.json`
+
+Format:
+```json
+{
+  "token": "skypetoken_asm_value_here",
+  "token_extracted_at": "2024-01-15T10:00:00.000Z",
+  "current_team": "team-uuid-here",
+  "teams": {
+    "team-uuid-here": {
+      "team_id": "team-uuid-here",
+      "team_name": "My Team"
+    }
+  }
+}
+```
+
+**Security**: File permissions set to 0600 (owner read/write only)
+
+## Limitations
+
+- No real-time events / WebSocket connection
+- No voice/video channel support
+- No team management (create/delete channels, roles)
+- No meeting support
+- No webhook support
+- Plain text messages only (no adaptive cards in v1)
+- User tokens only (no app tokens)
+- **Token expires in 60-90 minutes** - must re-authenticate frequently
+
+## References
+
+- [Authentication Guide](references/authentication.md)
+- [Common Patterns](references/common-patterns.md)