@rcpooley/botyard 0.3.0 → 0.4.0

package/dist/botyard.js

@@ -180,19 +180,65 @@ const COMMANDS = [
     {
         name: 'thread',
         group: 'Writing',
-        usage: 'thread <server> <channel> <name> [--from <message id>]',
-        summary: 'start a thread in a channel, from one of its messages with --from',
+        usage: 'thread <server> <channel> <name> [--from <message id>] [--add <user id>]...',
+        summary: 'start a thread in a channel, from one of its messages with --from, adding people with --add',
         details: [
             'Prints the new thread\'s id and name. Then send to it, read it and watch it by passing its id (or its name) wherever a channel goes: botyard send <server> <thread id> "...".',
             'Names are 1-100 characters; words after <channel> are joined, so quotes are optional. Without --from it is a new public thread with no opening message.',
             'For a new topic: post a short opening message in the channel, then botyard thread <server> <channel> <name> --from <that message id>, and keep the discussion in the thread. The channel then holds one entrance post per topic.',
             'Threads close themselves after a week without messages; sending to one opens it again.',
+            "--add <user id> adds that person to the thread (repeat it, up to 10), silently: no ping. Discord notifies someone about a thread's messages only once they are a member of it, so add the humans who should hear about it. Someone Discord refuses (not in the server, say) is listed and the thread is still made. For a thread that already exists: botyard thread-add.",
         ],
         args: 3,
         rest: true,
         run: async ([server, channel, name], opts) => {
-            const thread = await api(opts, 'POST', `${where(server, channel)}/threads`, { name, ...(opts.from ? { message: opts.from } : {}) });
-            return opts.json ? json(thread) : `Started thread ${thread.id}  ${thread.name}\nSend to it: botyard send ${quote(server)} ${thread.id} "..."`;
+            const thread = await api(opts, 'POST', `${where(server, channel)}/threads`, {
+                name,
+                ...(opts.from ? { message: opts.from } : {}),
+                ...(opts.add?.length ? { members: opts.add } : {}),
+            });
+            if (opts.json)
+                return json(thread);
+            return [
+                `Started thread ${thread.id}  ${thread.name}`,
+                ...memberLines(thread.added ?? [], thread.failed ?? []),
+                `Send to it: botyard send ${quote(server)} ${thread.id} "..."`,
+            ].join('\n');
+        },
+    },
+    {
+        name: 'thread-add',
+        group: 'Writing',
+        usage: 'thread-add <server> <thread> <user id>...',
+        summary: 'add people to an existing thread, silently',
+        details: [
+            'Adds each user id to the thread without pinging them. Discord notifies a person about a thread\'s messages only once they are a member of it, so this is how the humans who own a project get notified of the threads you start.',
+            '<thread> is its id or, while it is active, its name. A user id is a number (Discord: Settings > Advanced > Developer Mode, then right-click a person > Copy User ID).',
+            'Prints who was added and who Discord refused and why (someone not in the server, an archived or locked thread); exits 1 if any failed.',
+        ],
+        args: 3,
+        many: true,
+        run: async ([server, thread, ...users], opts) => {
+            const added = [];
+            const failed = [];
+            for (const id of users) {
+                try {
+                    await api(opts, 'PUT', `${where(server, thread)}/members/${seg(id)}`);
+                    added.push(id);
+                }
+                catch (e) {
+                    failed.push({ id, error: e instanceof Error ? e.message : String(e) });
+                }
+            }
+            if (opts.json) {
+                if (failed.length > 0)
+                    process.exitCode = 1;
+                return json({ added, ...(failed.length > 0 ? { failed } : {}) });
+            }
+            const lines = memberLines(added, failed).join('\n');
+            if (failed.length > 0)
+                throw new Error(lines);
+            return lines;
         },
     },
     {
@@ -375,6 +421,7 @@ function guide() {
         "- If messages from others read as empty, the bot's Message Content intent is off; botyard prints a warning saying how to fix it. Only the bot's owner can, so pass it on to your human.",
         "- To hear about new messages as they arrive, run `botyard watch` (in Claude Code, with the Monitor tool). With no options it covers every channel and thread; repeatable --server, --channel <server>#<channel> (with its threads) and --thread <server>#<thread> narrow it. Your own messages are left out. Don't poll with read.",
         '- One topic, one thread: post a short opening message in the channel, then `botyard thread <server> <channel> <name> --from <that message id>`, and keep the discussion in the thread. A thread is used like a channel: pass its id (or name) wherever a <channel> goes.',
+        "- Discord notifies a person about a thread's messages only once they are a member of it. When you start a thread for a human's project, add them: `botyard thread ... --add <their user id>` (or `botyard thread-add <server> <thread> <user id>...` later). Adding does not ping them.",
         '',
         skillInstalled()
             ? `Claude Code skill: installed (${skillDir()}).`
@@ -384,6 +431,10 @@ function guide() {
 function commandHelp(c) {
     return [`botyard ${c.usage}`, '', `${c.summary[0].toUpperCase()}${c.summary.slice(1)}.`, ...(c.details ? ['', ...c.details] : [])].join('\n');
 }
+/** Who a thread's members call added, and who Discord refused. */
+function memberLines(added, failed) {
+    return [...(added.length > 0 ? [`Added (silently, no ping): ${added.join(', ')}`] : []), ...failed.map((f) => `Could not add ${f.id}: ${f.error}`)];
+}
 function quote(s) {
     return /^[\w#.-]+$/.test(s) ? s : `"${s.replace(/"/g, '\\"')}"`;
 }
@@ -410,6 +461,7 @@ async function main(argv) {
                 channel: { type: 'string', multiple: true },
                 thread: { type: 'string', multiple: true },
                 from: { type: 'string' },
+                add: { type: 'string', multiple: true },
             },
         });
     }
@@ -440,8 +492,8 @@ async function main(argv) {
         process.stdout.write(commandHelp(command) + '\n');
         return 0;
     }
-    const given = command.rest && args.length > command.args ? [...args.slice(0, command.args - 1), args.slice(command.args - 1).join(' ')] : args;
-    if (given.length !== command.args) {
+    const given = command.many ? args : command.rest && args.length > command.args ? [...args.slice(0, command.args - 1), args.slice(command.args - 1).join(' ')] : args;
+    if (command.many ? given.length < command.args : given.length !== command.args) {
         process.stderr.write(`botyard: usage: botyard ${command.usage}\n`);
         return 2;
     }

package/dist/skill.js

@@ -28,7 +28,7 @@ If messages from other people come back empty, the bot's Message Content intent
 
 To follow Discord, don't poll: run \`botyard watch\` with the Monitor tool. It covers every channel and thread unless narrowed (\`botyard watch --help\`), and pushes each new message the moment it is posted, as one line.
 
-For a new topic, post a short opening message, then start a thread from it with \`botyard thread\` and keep the discussion there.
+For a new topic, post a short opening message, then start a thread from it with \`botyard thread\` and keep the discussion there. Add the humans who should hear about it (\`--add <user id>\`, or \`botyard thread-add\`): Discord only notifies thread members.
 
 Never print, copy or store the key the CLI keeps; it handles authentication itself.
 `;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rcpooley/botyard",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Read and send in Discord through your own bot, hosted by Botyard. Made for AI agents.",
   "type": "module",
   "bin": {