Merge pull request #10 from DevRohit06/docs/feature-updates

docs: update agent reference and README with all new features

Author: DevRohit06

README.md

@@ -116,6 +116,8 @@ Every command supports `--json` for machine-readable output.
 ```bash
 discli message send #general "Hello world!"
 discli message send #general "Check this out" --embed-title "News" --embed-desc "Big update"
+discli message send #general "Alert" --embed-color ff0000 --embed-footer "Footer" --embed-field "Name::Value::true"
+discli message bulk-delete #general 111 222 333
 discli message send #general "Here's the report" --file report.pdf
 discli message send #general "Screenshots" --file bug.png --file logs.txt
 discli message list #general --limit 20
@@ -153,6 +155,7 @@ discli dm list alice --limit 10
 discli reaction add #general 123456789 👍
 discli reaction remove #general 123456789 👍
 discli reaction list #general 123456789
+discli reaction users #general 123456789 👍 --limit 100
 ```
 
 ### Channels
@@ -162,6 +165,10 @@ discli channel list --server "My Server"
 discli channel create "My Server" new-channel --type text
 discli channel create "My Server" voice-room --type voice
 discli channel info #general
+discli channel edit #general --name new-name --topic "New topic" --slowmode 10
+discli channel create "My Server" "forum-name" --type forum --topic "Forum topic"
+discli channel forum-post #forum-channel "Post Title" "Post content"
+discli channel set-permissions #general @Moderator --allow send_messages,read_messages --deny manage_messages --target-type role
 discli channel delete #old-channel
 ```
 
@@ -172,6 +179,11 @@ discli thread create #general 123456789 "Support Ticket"
 discli thread list #general
 discli thread send 987654321 "Following up on your issue"
 discli thread send 987654321 "Attached the logs" --file debug.log
+discli thread archive 987654321
+discli thread unarchive 987654321
+discli thread rename 987654321 "New Thread Name"
+discli thread add-member 987654321 123456789
+discli thread remove-member 987654321 123456789
 ```
 
 ### Servers
@@ -188,6 +200,7 @@ discli role list "My Server"
 discli role create "My Server" Moderator --color ff0000
 discli role assign "My Server" alice Moderator
 discli role remove "My Server" alice Moderator
+discli role edit "My Server" Moderator --name "Senior Mod" --color 00ff00 --hoist --mentionable
 discli role delete "My Server" Moderator
 ```
 
@@ -199,6 +212,32 @@ discli member info "My Server" alice
 discli member kick "My Server" alice --reason "Spam"
 discli member ban "My Server" alice --reason "Repeated violations"
 discli member unban "My Server" alice
+discli member timeout "My Server" alice 3600 --reason "Spam"
+discli member timeout "My Server" alice 0    # remove timeout
+```
+
+### Polls
+
+```bash
+discli poll results #general 123456789
+discli poll end #general 123456789
+```
+
+### Webhooks
+
+```bash
+discli webhook list #general
+discli webhook create #general "my-webhook"
+discli webhook delete #general 123456789
+```
+
+### Events
+
+```bash
+discli event list "My Server"
+discli event create "My Server" "Game Night" "2026-04-01T18:00:00" --location "Park" --end-time "2026-04-01T20:00:00"
+discli event create "My Server" "Voice Hangout" "2026-04-01T18:00:00" --channel #voice-room
+discli event delete "My Server" 123456789
 ```
 
 ### Typing Indicator
@@ -218,7 +257,7 @@ discli listen
 discli listen --server "My Server" --channel #general
 
 # Filter by event type
-discli listen --events messages,reactions
+discli listen --events messages,reactions,voice
 
 # Include bot messages (ignored by default)
 discli listen --include-bots
@@ -227,7 +266,7 @@ discli listen --include-bots
 discli --json listen --events messages
 ```
 
-Supported event types: `messages`, `reactions`, `members`, `edits`, `deletes`
+Supported event types: `messages`, `reactions`, `members`, `edits`, `deletes`, `voice`
 
 ### Persistent Bot (serve)
 
@@ -246,15 +285,24 @@ discli serve --server "My Server"
 {"event": "ready", "bot_id": "123", "bot_name": "MyBot#1234"}
 {"event": "message", "channel_id": "456", "author": "alice", "content": "hello", "mentions_bot": true, ...}
 {"event": "slash_command", "command": "paw", "args": {"message": "hi"}, "interaction_token": "abc123", ...}
+{"event": "voice_state", "action": "joined", "member": "alice", "channel": "General", "channel_id": "456"}
+{"event": "component_interaction", "custom_id": "ok_btn", "user": "alice", "interaction_token": "itk"}
+{"event": "modal_submit", "custom_id": "myform", "fields": {"name": "Alice"}, "interaction_token": "itk"}
 ```
 
 **Commands (stdin):**
 ```json
 {"action": "send", "channel_id": "456", "content": "Hello!", "req_id": "1"}
+{"action": "send", "channel_id": "456", "content": "Rich!", "embed": {"title": "T", "description": "D", "color": "ff0000"}}
+{"action": "send", "channel_id": "456", "content": "Click!", "components": [[{"type": "button", "label": "OK", "style": "primary", "custom_id": "ok_btn"}]]}
 {"action": "reply", "channel_id": "456", "message_id": "789", "content": "Hi!", "req_id": "2"}
 {"action": "typing_start", "channel_id": "456"}
 {"action": "typing_stop", "channel_id": "456"}
 {"action": "presence", "status": "idle", "activity_type": "watching", "activity_text": "the logs"}
+{"action": "channel_edit", "channel_id": "456", "topic": "New topic", "slowmode": 10}
+{"action": "forum_post", "channel_id": "456", "title": "Post Title", "content": "Body"}
+{"action": "webhook_create", "channel_id": "456", "name": "My Webhook"}
+{"action": "event_create", "guild_id": "111", "name": "Hangout", "start_time": "2026-04-01T18:00:00"}
 ```
 
 **Streaming edits** (bot response builds in real-time, edited every 1.5s):

agents/discord-agent.md

@@ -8,6 +8,7 @@ You are a Discord agent with access to the `discli` CLI tool. Use the Bash tool
 ```bash
 discli message send <channel> "text"
 discli message send <channel> "text" --embed-title "Title" --embed-desc "Description"
+discli message send <channel> "text" --embed-color ff0000 --embed-footer "Footer" --embed-image URL --embed-thumbnail URL --embed-author "Author" --embed-field "Name::Value::true"
 discli message send <channel> "text" --file path/to/file.png
 discli message send <channel> "text" --file file1.png --file file2.pdf
 discli message reply <channel> <message_id> "text"
@@ -19,13 +20,15 @@ discli message delete <channel> <message_id>
 discli message search <channel> "query" --limit 100 [--author name] [--before YYYY-MM-DD] [--after YYYY-MM-DD]
 discli message history <channel> --days 7
 discli message history <channel> --hours 24 --limit 500
+discli message bulk-delete <channel> <msg_id1> <msg_id2> ...
 ```
 
 ### Reactions
 ```bash
 discli reaction add <channel> <message_id> <emoji>
 discli reaction remove <channel> <message_id> <emoji>
 discli reaction list <channel> <message_id>
+discli reaction users <channel> <message_id> <emoji> --limit 100
 ```
 
 ### Direct Messages
@@ -39,8 +42,12 @@ discli dm list <user> --limit 10
 ```bash
 discli channel list --server "server name"
 discli channel create "server name" "channel-name" --type text|voice|category
+discli channel create "server" "forum-name" --type forum --topic "Forum topic"
+discli channel edit <channel> --name new-name --topic "New topic" --slowmode 10 --nsfw
 discli channel delete <channel>
 discli channel info <channel>
+discli channel forum-post <channel> "Post Title" "Post content"
+discli channel set-permissions <channel> <role-or-member> --allow send_messages,read_messages --deny manage_messages --target-type role
 ```
 
 ### Threads
@@ -49,6 +56,11 @@ discli thread create <channel> <message_id> "thread name"
 discli thread list <channel>
 discli thread send <thread_id> "text"
 discli thread send <thread_id> "text" --file path/to/file.png
+discli thread archive <thread>
+discli thread unarchive <thread>
+discli thread rename <thread> "New Name"
+discli thread add-member <thread> <member_id>
+discli thread remove-member <thread> <member_id>
 ```
 
 ### Servers
@@ -62,6 +74,7 @@ discli server info "server name"
 discli role list "server name"
 discli role create "server name" "role-name" --color ff0000 --permissions 8
 discli role delete "server name" <role>
+discli role edit "server name" "Role" --name "New Name" --color 00ff00 --hoist --mentionable
 discli role assign "server name" <member> <role>
 discli role remove "server name" <member> <role>
 ```
@@ -73,16 +86,39 @@ discli member info "server name" <member>
 discli member kick "server name" <member> --reason "reason"
 discli member ban "server name" <member> --reason "reason"
 discli member unban "server name" <member>
+discli member timeout "server name" member 3600 --reason "Spam"
+discli member timeout "server name" member 0    # remove timeout
 ```
 
 ### Typing Indicator
 ```bash
 discli typing <channel> --duration 5
 ```
 
+### Polls
+```bash
+discli poll results <channel> <message_id>
+discli poll end <channel> <message_id>
+```
+
+### Webhooks
+```bash
+discli webhook list <channel>
+discli webhook create <channel> "webhook-name"
+discli webhook delete <channel> <webhook_id>
+```
+
+### Events
+```bash
+discli event list "server"
+discli event create "server" "Event Name" "2026-04-01T18:00:00" --location "Park" --end-time "2026-04-01T20:00:00"
+discli event create "server" "Voice Hangout" "2026-04-01T18:00:00" --channel #voice-room
+discli event delete "server" <event_id>
+```
+
 ### Live Monitoring
 ```bash
-discli listen --events messages,reactions,members,edits,deletes
+discli listen --events messages,reactions,members,edits,deletes,voice
 discli listen --server "server name" --channel "#channel"
 ```
 
@@ -91,9 +127,43 @@ discli listen --server "server name" --channel "#channel"
 ```bash
 discli serve --slash-commands commands.json --status online
 ```
-**stdin commands:** `send`, `reply`, `edit`, `delete`, `typing_start`, `typing_stop`, `presence`, `reaction_add`, `reaction_remove`, `stream_start`, `stream_chunk`, `stream_end`, `interaction_followup`
-
-**stdout events:** `ready`, `message`, `slash_command`, `message_edit`, `message_delete`, `reaction_add`, `reaction_remove`, `member_join`, `member_remove`, `response`, `error`
+**stdin commands:** `send`, `reply`, `edit`, `delete`, `typing_start`, `typing_stop`, `presence`, `reaction_add`, `reaction_remove`, `stream_start`, `stream_chunk`, `stream_end`, `interaction_followup`, `modal_send`, `channel_edit`, `channel_set_permissions`, `forum_post`, `thread_archive`, `thread_rename`, `thread_add_member`, `thread_remove_member`, `member_timeout`, `role_edit`, `reaction_users`, `poll_results`, `poll_end`, `webhook_list`, `webhook_create`, `webhook_delete`, `event_list`, `event_create`, `message_bulk_delete`
+
+**stdin examples:**
+```json
+{"action": "send", "channel_id": "456", "content": "Hello!", "embed": {"title": "T", "description": "D", "color": "ff0000", "footer": "F", "fields": [{"name": "N", "value": "V", "inline": true}]}}
+{"action": "send", "channel_id": "456", "content": "Click!", "components": [[{"type": "button", "label": "OK", "style": "primary", "custom_id": "ok_btn"}]]}
+{"action": "modal_send", "interaction_token": "itk", "title": "Form", "custom_id": "myform", "fields": [{"label": "Name", "custom_id": "name", "style": "short"}]}
+{"action": "channel_edit", "channel_id": "456", "topic": "New topic", "slowmode": 10}
+{"action": "channel_set_permissions", "channel_id": "456", "target_id": "789", "target_type": "role", "allow": ["send_messages"], "deny": ["manage_messages"]}
+{"action": "forum_post", "channel_id": "456", "title": "Post Title", "content": "Body"}
+{"action": "thread_archive", "thread_id": "789", "archived": true}
+{"action": "thread_rename", "thread_id": "789", "name": "New Name"}
+{"action": "thread_add_member", "thread_id": "789", "member_id": "123"}
+{"action": "thread_remove_member", "thread_id": "789", "member_id": "123"}
+{"action": "member_timeout", "guild_id": "111", "member_id": "222", "duration": 3600, "reason": "Spam"}
+{"action": "role_edit", "guild_id": "111", "role_id": "333", "name": "New Name", "color": "ff0000"}
+{"action": "reaction_users", "channel_id": "456", "message_id": "789", "emoji": "👍"}
+{"action": "poll_results", "channel_id": "456", "message_id": "789"}
+{"action": "poll_end", "channel_id": "456", "message_id": "789"}
+{"action": "webhook_list", "channel_id": "456"}
+{"action": "webhook_create", "channel_id": "456", "name": "My Webhook"}
+{"action": "webhook_delete", "channel_id": "456", "webhook_id": "999"}
+{"action": "event_list", "guild_id": "111"}
+{"action": "event_create", "guild_id": "111", "name": "Hangout", "start_time": "2026-04-01T18:00:00", "location": "Park", "end_time": "2026-04-01T20:00:00"}
+{"action": "message_bulk_delete", "channel_id": "456", "message_ids": ["111", "222", "333"]}
+```
+
+**stdout events:** `ready`, `message`, `slash_command`, `message_edit`, `message_delete`, `reaction_add`, `reaction_remove`, `member_join`, `member_remove`, `voice_state`, `component_interaction`, `modal_submit`, `disconnected`, `resumed`, `response`, `error`
+
+**stdout event examples:**
+```json
+{"event": "voice_state", "action": "joined", "member": "alice", "channel": "General", "channel_id": "456"}
+{"event": "component_interaction", "custom_id": "ok_btn", "user": "alice", "interaction_token": "itk"}
+{"event": "modal_submit", "custom_id": "myform", "fields": {"name": "Alice"}, "interaction_token": "itk"}
+{"event": "disconnected"}
+{"event": "resumed"}
+```
 
 ## Important Rules
 
@@ -114,7 +184,7 @@ All commands accept both IDs and names:
 - Threads: `123456789` or `Thread Name`
 
 ### Creating Polls
-Send a message, capture its ID, then add reaction emojis as vote options. Do this in a single bash command:
+Use `discli poll results` and `discli poll end` to check or close polls. For reaction-based polls, send a message, capture its ID, then add reaction emojis as vote options. Do this in a single bash command:
 ```bash
 MSG=$(discli --json message send <channel> "📊 Poll: What should we build?
 1️⃣ CLI Tool