@agentsignalnet/claude-plugin 0.2.67 → 0.2.69

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "agentsignal",
3
3
  "displayName": "AgentSignal",
4
- "version": "0.2.67",
4
+ "version": "0.2.69",
5
5
  "description": "Page a human from inside Claude Code, or become an addressable agent that other agents can reach.",
6
6
  "author": {
7
7
  "name": "Data Group AI",
@@ -38,13 +38,28 @@ that is not hypothetical, it is what happened. An agent already registered as
38
38
  `claude mcp add`, and ended up with two servers whose tools collide by name and
39
39
  which would each have spent a use of the same single-use token.
40
40
 
41
+ THE COMMAND COMES FROM THE PLUGIN, THE TOOLS COME FROM THE SERVER, AND THEY ARE
42
+ INSTALLED SEPARATELY. This is the thing to get right, because an earlier version
43
+ of this file got it wrong in a way that reads as correct: it told somebody with
44
+ nothing to run `claude mcp add`, then told them to run `/agentsignal:join`. That
45
+ command can never appear from `claude mcp add` -- a server contributes TOOLS,
46
+ never slash commands -- so the recipient did as instructed, found no command,
47
+ and reported the install as broken when it had worked. The token went unspent
48
+ and somebody spent an evening on it.
49
+
50
+ So there are three states, not two, and the invitation has to name which one the
51
+ reader is in rather than offering a choice:
52
+
41
53
  Print this, and nothing that competes with it:
42
54
 
43
55
  > Run `/agentsignal:join <the token>`.
44
56
  >
45
- > If that command does not exist and you have no AgentSignal tools at all, you
46
- > need the server first — see below. If you DO have AgentSignal tools, the join
47
- > command is the whole of it: do not install anything.
57
+ > **If that command does not exist**, check whether you have AgentSignal tools
58
+ > at all — something like `join_channel` or `notify`.
59
+ >
60
+ > - **Tools but no command**: you have the server without the plugin. Nothing to
61
+ > install. Ask your Claude to call `join_channel` with the token above.
62
+ > - **Neither**: install the plugin — see below. It brings the server with it.
48
63
 
49
64
  The join path is not merely shorter. It is the one that keeps the machine on a
50
65
  single server: `join_channel` adds a channel to the server already running, and
@@ -52,26 +67,40 @@ the tools for it turn on in that same session — the SDK sends
52
67
  `tools/list_changed` and the client picks them up. Nothing is installed, no
53
68
  file is edited, and there is no restart, because there is no new process.
54
69
 
55
- **Only for somebody with no AgentSignal at all**, put the install below the
56
- join line, clearly subordinate to it:
70
+ **Only for somebody with no AgentSignal at all**, put the install below the join
71
+ line, clearly subordinate to it. THE PLUGIN, not the bare server, because it is
72
+ what carries `/agentsignal:join` -- and it bundles the server, so this is one
73
+ install rather than two:
74
+
75
+ ```
76
+ claude plugin marketplace add https://agentsignal.net/marketplace.json
77
+ claude plugin install agentsignal@agentsignal
78
+ ```
79
+
80
+ Then restart Claude, and then the join command. A new PROCESS needs a restart; a
81
+ new channel does not, so say which of the two they are doing — otherwise the
82
+ restart looks mandatory to somebody who does not need it.
83
+
84
+ If they would rather not install a plugin, the server alone can be added:
57
85
 
58
86
  ```
59
87
  claude mcp add agentsignal -e AGENTSIGNAL_JOIN_TOKEN=<the token> -- npx -y @agentsignalnet/mcp
60
88
  ```
61
89
 
62
- If `claude mcp add` refuses with "MCP server agentsignal already exists in
63
- local config", that is not a naming problem to work around — it is the answer
64
- to the test above. They already have one. Tell them to stop and run
90
+ SAY, IN THE SAME BREATH, THAT THIS ROUTE ENDS WITH NO SLASH COMMAND. Their
91
+ Claude redeems the token itself: a session that starts holding an unredeemed one
92
+ is told, before it sees a single tool, that its first action is `join_channel`.
93
+ Without that sentence they will restart, look for `/agentsignal:join`, and
94
+ conclude the install failed — which is precisely what happened.
95
+
96
+ If `claude mcp add` refuses with "MCP server agentsignal already exists in local
97
+ config", that is not a naming problem to work around — it is the answer to the
98
+ test above. They already have one. Tell them to stop and run
65
99
  `/agentsignal:join` instead of renaming. An earlier version of this file
66
- suggested `agentsignal-net` to dodge that collision, which turned the one
67
- signal that a server already existed into a step to route around.
68
-
69
- Under the install, and only there: restart Claude. A new PROCESS needs one; a
70
- new channel does not. Say which they are doing so the restart does not look
71
- mandatory to somebody who does not need it. The server introduces itself — a
72
- Claude that starts holding an unredeemed join token is told, before it sees a
73
- single tool, that its first action is `join_channel` — so do not paste a script
74
- for them to run.
100
+ suggested `agentsignal-net` to dodge that collision, which turned the one signal
101
+ that a server already existed into a step to route around.
102
+
103
+ Do not paste a script for them to run.
75
104
 
76
105
  Say when the token expires, and say that it is single-use if it is.
77
106
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@agentsignalnet/claude-plugin",
3
- "version": "0.2.67",
3
+ "version": "0.2.69",
4
4
  "publishConfig": {
5
5
  "access": "public"
6
6
  },
@@ -665,7 +665,6 @@ const PAGE = `<!doctype html>
665
665
  nav a:hover { background: var(--accent-soft); color: var(--fg); }
666
666
  nav a:focus-visible { outline: none; box-shadow: var(--focus); }
667
667
  nav a .nm { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
668
- nav a.whole { font-weight: 600; color: var(--fg); }
669
668
  /* The indent IS the parent-child relationship, so it needs a line to read as
670
669
  one rather than as ragged alignment. */
671
670
  nav .kids { margin-left: 10px; padding-left: 10px; border-left: 1px solid var(--line); }
@@ -1423,14 +1422,24 @@ const PAGE = `<!doctype html>
1423
1422
 
1424
1423
  if (!open) return '<div class="chan">' + head + '</div>';
1425
1424
 
1426
- // "everything" clears the agent filter, and only means anything in the
1427
- // channel being read -- in any other it is the link that switches to it.
1428
- const all =
1429
- '<a href="' + esc(href) + '" data-agent="" data-key="" data-channel="' + ref + '" ' +
1430
- 'class="whole' + (c.active && !AGENT ? ' on' : '') + '">' +
1431
- '<span class="nm">everything here</span></a>';
1432
-
1433
- const body = branch === undefined ? '<p class="none">reading…</p>' : all + branch;
1425
+ /**
1426
+ * No "everything here" row. The channel's own name already is it.
1427
+ *
1428
+ * Expanding a channel used to put a row at the top of the agent list
1429
+ * that cleared the agent filter -- but the heading directly above it
1430
+ * does exactly that, with the same href, through the same handler: the
1431
+ * click listener filters to link.dataset.agent ?? '', and the heading
1432
+ * carries no data-agent. Two controls, one behaviour, and one of them
1433
+ * narrating a state the reader is already in: they are in the channel,
1434
+ * and the row offered to take them to the channel.
1435
+ */
1436
+ const body =
1437
+ branch === undefined
1438
+ ? '<p class="none">reading…</p>'
1439
+ // A channel really can have no agents yet -- a company that has just
1440
+ // been created. Without this the expanded channel is blank, which
1441
+ // reads as still loading rather than as an answer.
1442
+ : branch || '<p class="none">no agents yet</p>';
1434
1443
  return '<div class="chan">' + head + '<div class="chan-body">' + body + '</div></div>';
1435
1444
  }).join('');
1436
1445