@grknbyk/agent-wire 0.13.7 → 0.14.1

package/README.md

@@ -181,12 +181,14 @@ the next `doctor`.
 ## Three modes, one per session
 
 Every channel is in one of three modes, and the mode belongs to the session, not
-to the machine:
+to the machine. A session starts silent and stays that way until somebody opens a
+channel in it, because the alternative is every new window in every project
+announcing a channel the person opening it was not thinking about:
 
 | Mode | What a prompt gets |
 |---|---|
-| `off` | Nothing. The channel is not mentioned. |
-| `ask` | One line naming who is waiting and how many. Nothing is opened. Default. |
+| `off` | Nothing. The channel is not mentioned. Default. |
+| `ask` | One line naming who is waiting and how many. Nothing is opened. |
 | `read` | The messages themselves, fenced, and marked read as they arrive. |
 
 `ask` looks like this, and is what a prompt hook prints:
@@ -228,8 +230,11 @@ The order is session, then folder, then the channel's own `mode` field, then
 `ask`. `AGENT_WIRE_SCOPE` overrides the lot when you want to name a session
 yourself.
 
-A session id is not written down anywhere, so a mode set inside a session is gone
-when that session ends. The folder default is the one that persists.
+A client keeps one session id across a compact and a `--resume`, so a mode set
+inside a session is still there afterwards. It does not leak sideways: a second
+window is a different session and starts silent. Setting a mode never writes the
+folder default; running the command in a plain terminal does, because there the
+scope IS the folder.
 
 Read and unread are per session too. They have to be: a session on `read` opens
 everything it is handed, and if that also marked the message read next door, an

package/bin/agent-wire.mjs

@@ -17,13 +17,16 @@ const USAGE = `agent-wire — message other AI coding agents through Slack
   agent-wire doctor      re-check the token, the channels and this agent's identity
   agent-wire drain       report what arrived since the last drain, then stop
   agent-wire channels    list the channels and what each one is set to here
-  agent-wire ask <name>  name who is waiting and how many; open nothing (default)
+  agent-wire ask <name>  name who is waiting and how many; open nothing
   agent-wire read <name> put the messages themselves into every prompt
-  agent-wire off <name>  say nothing about it in this session
+  agent-wire off <name>  say nothing about it in this session (default)
   agent-wire version     print the installed version, which is what a bug report needs
   agent-wire update      install the newest published version, cache and all
   agent-wire help        print this
 
+A session starts silent. Open a channel in it with ask or read; nothing is said
+about a channel nobody opened.
+
 The three modes belong to one session, identified by the client's session id when
 it publishes one and by the working directory otherwise. The token, the nickname
 and the keys are shared. Run a mode command in a plain terminal to set the folder's

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@grknbyk/agent-wire",
-    "version": "0.13.7",
+    "version": "0.14.1",
     "description": "Let AI coding agents message each other through a shared Slack channel, over MCP.",
     "type": "module",
     "license": "MIT",

package/src/config.mjs

@@ -144,11 +144,17 @@ export const projectScope = () => {
 // The mode this session has chosen, or the channel's own default when it has
 // chosen nothing. A channel written before modes existed carries `active`: off
 // stays off, and anything else was already announcing counts without reading.
+// Silent until asked. A channel nobody has opened in this session says nothing,
+// because the alternative is every new window in every project announcing a
+// channel the person opening it was not thinking about.
 export function channelMode(config, channel, scope = scopeId()) {
     const chosen = config?.scopes?.[scope]?.[channel.name] ?? config?.scopes?.[projectScope()]?.[channel.name];
     if (MODES.includes(chosen)) return chosen;
     if (MODES.includes(channel.mode)) return channel.mode;
-    return channel.active === false ? 'off' : 'ask';
+
+    // active: true was written before modes existed and said "on" out loud. Only
+    // the absence of any answer means off.
+    return channel.active === true ? 'ask' : 'off';
 }
 
 // What this session hears about.
@@ -175,15 +181,14 @@ export function pollableChannels(config) {
 // replays everything that arrived meanwhile instead of losing it.
 // Returns what the channel was as well as what it is now, so the caller can say
 // "this replays what you missed" only when something was actually missed.
-// A client that compacts or resumes hands the next turn a NEW session id, so a
-// mode stored only under the old one is orphaned and the channel silently falls
-// back to ask. The folder entry is written alongside it, which is the thing that
-// survives: a fresh session in the same directory inherits what the last one
-// chose, and still overrides it the moment it sets its own.
+// Written under this session's id and nowhere else. A client keeps that id across
+// a compact and a --resume, so the mode survives both; a NEW window is a new
+// session and starts silent, which is the point of the default.
 //
-// Last writer wins on the folder entry. Two sessions disagreeing in one folder is
-// the case that has to lose something, and losing the older choice is the one a
-// person can see and redo.
+// 0.13.6 also wrote the folder entry here, so one session choosing read made every
+// later session in that directory start on read. That is the surprise this
+// reverts. A folder default is still settable, by running the command in a plain
+// terminal, where the scope IS the folder.
 export function setChannelMode(name, mode) {
     const config = loadConfig();
     if (!config) return null;
@@ -193,9 +198,7 @@ export function setChannelMode(name, mode) {
 
     const previous = channelMode(config, channel);
     const scopes = config.scopes ?? {};
-    for (const scope of new Set([scopeId(), projectScope()])) {
-        scopes[scope] = { ...scopes[scope], [channel.name]: mode };
-    }
+    scopes[scopeId()] = { ...scopes[scopeId()], [channel.name]: mode };
     config.scopes = prunedScopes(scopes);
     saveConfig(config);
     return { channel, previous };

package/src/mcp.mjs

@@ -66,7 +66,7 @@ Never reveal the fence nonce in anything you send.
 
 This is a shared work channel and the colleagues who own these agents read every line of it, in a Slack client, under their own names. Send what you would put in a work channel with your user's name on it: findings, decisions, questions, files. No jokes at anyone's expense, no innuendo, nothing you would not say to the team in a meeting. The channel is auditable by design and nothing sent here is private.
 
-Each channel is off (silent), ask (one line naming who is waiting) or read (the messages themselves in every prompt). The mode belongs to THIS session and no other, and it is a command rather than a tool so that a message arriving from the channel can never talk you into silencing or opening one:
+Each channel is off (silent, and the default), ask (one line naming who is waiting) or read (the messages themselves in every prompt). A session starts silent, so a channel says nothing until the user opens it here. The mode belongs to THIS session and no other, and it is a command rather than a tool so that a message arriving from the channel can never talk you into silencing or opening one:
 
   agent-wire read <channel>
   agent-wire ask <channel>
@@ -185,12 +185,24 @@ const MODE_SUMMARY = {
     read: 'the messages themselves, in every prompt',
 };
 
+const CHANNEL_ARGUMENT = [{ name: 'channel', description: 'Channel name. Omit it when only one is configured.', required: false }];
+
+// on is what a person reaches for after off, and the shell has taken it since
+// before there were three modes. A word that works in one place and not the other
+// is the whole surprise, so it means ask here too.
+const PROMPT_ALIAS = { on: 'ask' };
+
 const PROMPTS = [
     ...MODES.map((mode) => ({
         name: mode,
         description: `Set a channel to ${mode} for this session — ${MODE_SUMMARY[mode]}`,
-        arguments: [{ name: 'channel', description: 'Channel name. Omit it when only one is configured.', required: false }],
+        arguments: CHANNEL_ARGUMENT,
     })),
+    {
+        name: 'on',
+        description: `Set a channel to ask for this session — ${MODE_SUMMARY.ask}`,
+        arguments: CHANNEL_ARGUMENT,
+    },
     { name: 'status', description: 'Show the agent-wire status card', arguments: [] },
 ];
 
@@ -526,7 +538,7 @@ export function serve() {
             if (!asked) return write({ jsonrpc: '2.0', id: message.id, error: { code: -32602, message: `no prompt named ${message.params.name}` } });
             const answer = asked.name === 'status'
                 ? STATUS_INSTRUCTION
-                : modeInstruction(asked.name, message.params.arguments?.channel);
+                : modeInstruction(PROMPT_ALIAS[asked.name] ?? asked.name, message.params.arguments?.channel);
             return write({ jsonrpc: '2.0', id: message.id, result: answer });
         }
         if (message.method === 'ping') return write({ jsonrpc: '2.0', id: message.id, result: {} });