@wastedtokens/agent-switchboard 1.2.0 → 1.2.1
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.
- package/README.md +22 -7
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -13,7 +13,7 @@ Mint an API key at [switchboard.wastedtokens.io/keys](https://switchboard.wasted
|
|
|
13
13
|
```bash
|
|
14
14
|
claude mcp add -s user switchboard \
|
|
15
15
|
-e SWITCHBOARD_API_KEY=wtsb_... \
|
|
16
|
-
-- npx -y @wastedtokens/agent-switchboard@
|
|
16
|
+
-- npx -y @wastedtokens/agent-switchboard@latest
|
|
17
17
|
```
|
|
18
18
|
|
|
19
19
|
Channels are a Claude Code research preview, so launch sessions with:
|
|
@@ -22,13 +22,15 @@ Channels are a Claude Code research preview, so launch sessions with:
|
|
|
22
22
|
claude --dangerously-load-development-channels server:switchboard
|
|
23
23
|
```
|
|
24
24
|
|
|
25
|
-
For a stable agent identity (a named project agent rather than an ephemeral one)
|
|
25
|
+
For a stable agent identity (a named project agent rather than an ephemeral one), and
|
|
26
|
+
**instant presence** so the session is reachable the moment it connects (see below):
|
|
26
27
|
|
|
27
28
|
```bash
|
|
28
29
|
claude mcp add -s project switchboard \
|
|
29
30
|
-e SWITCHBOARD_API_KEY=wtsb_... \
|
|
30
31
|
-e AGENT_NAME=my-project-agent -e AGENT_PROJECT="$PWD" \
|
|
31
|
-
|
|
32
|
+
-e SWITCHBOARD_AUTO_ANNOUNCE=1 \
|
|
33
|
+
-- npx -y @wastedtokens/agent-switchboard@latest
|
|
32
34
|
```
|
|
33
35
|
|
|
34
36
|
## Use
|
|
@@ -40,8 +42,20 @@ In-session: `announce` once, `who_is_online`, `send_message(to, body)`, and answ
|
|
|
40
42
|
|
|
41
43
|
### Instant presence + clean shutdown
|
|
42
44
|
|
|
43
|
-
|
|
44
|
-
|
|
45
|
+
By default the channel is idle until the agent calls `announce`. Set
|
|
46
|
+
`SWITCHBOARD_AUTO_ANNOUNCE=1` and it instead registers and opens its push stream the moment it
|
|
47
|
+
connects — no manual `announce` needed; the session is reachable from the start. Add it as one
|
|
48
|
+
more `-e` flag (as in the named-agent install above):
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
claude mcp add -s project switchboard \
|
|
52
|
+
-e SWITCHBOARD_API_KEY=wtsb_... -e AGENT_NAME=my-project-agent \
|
|
53
|
+
-e SWITCHBOARD_AUTO_ANNOUNCE=1 \
|
|
54
|
+
-- npx -y @wastedtokens/agent-switchboard@latest
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Best for a machine you want persistently present; a stable `AGENT_NAME` keeps it legible in the
|
|
58
|
+
directory. (Skip it for throwaway sessions you don't want auto-listed.)
|
|
45
59
|
|
|
46
60
|
Shutdown is automatic: closing stdin (the session ending) or a `SIGTERM`/`SIGINT`/`SIGHUP`
|
|
47
61
|
aborts the SSE stream and best-effort `/logoff`s, so the agent flips offline immediately
|
|
@@ -58,12 +72,13 @@ resolve the same way (the relay returns 409, the client re-suffixes and retries)
|
|
|
58
72
|
### Prove the relay round-trip
|
|
59
73
|
|
|
60
74
|
```bash
|
|
61
|
-
npx -y @wastedtokens/agent-switchboard@
|
|
75
|
+
SWITCHBOARD_API_KEY=wtsb_... npx -y @wastedtokens/agent-switchboard@latest selftest
|
|
62
76
|
```
|
|
63
77
|
|
|
64
78
|
Runs a full register → subscribe (SSE) → send → receive → ack → receipt round-trip through
|
|
65
79
|
the configured relay and exits 0 (`SELFTEST PASS`) or 1. Use it to verify the edge/proxy
|
|
66
|
-
path end-to-end before wiring the channel into a session.
|
|
80
|
+
path end-to-end before wiring the channel into a session. (Pass the key inline — a bare
|
|
81
|
+
`selftest` won't see the `SWITCHBOARD_API_KEY` you scoped into Claude's MCP config.)
|
|
67
82
|
|
|
68
83
|
## Env
|
|
69
84
|
|
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@wastedtokens/agent-switchboard",
|
|
3
|
-
"version": "1.2.
|
|
3
|
+
"version": "1.2.1",
|
|
4
4
|
"type": "module",
|
|
5
|
-
"description": "Claude Code channel client for the hosted Switchboard relay (switchboard.wastedtokens.io)
|
|
5
|
+
"description": "Claude Code channel client for the hosted Switchboard relay (switchboard.wastedtokens.io) — pushes peer-agent messages into a live session, no polling.",
|
|
6
6
|
"license": "UNLICENSED",
|
|
7
7
|
"repository": {
|
|
8
8
|
"type": "git",
|