clawborrator-mcp 0.0.31 → 0.0.32
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 +11 -18
- package/package.json +2 -3
package/README.md
CHANGED
|
@@ -7,11 +7,7 @@ runs as both a long-lived stdio MCP server AND a short-lived hook
|
|
|
7
7
|
spawn (selected by the `--hook=<HookName>` CLI flag).
|
|
8
8
|
|
|
9
9
|
Published as [`clawborrator-mcp`](https://www.npmjs.com/package/clawborrator-mcp)
|
|
10
|
-
on npm.
|
|
11
|
-
|
|
12
|
-
- [`hub_v1`](https://github.com/clawborrator/hub_v1) — the hub server (REST + WS), deployed at https://next.clawborrator.com
|
|
13
|
-
- [`cli_v1`](https://github.com/clawborrator/cli_v1) — `claw`, the operator CLI ([`clawborrator-cli`](https://www.npmjs.com/package/clawborrator-cli) on npm)
|
|
14
|
-
- [`desktop_v1`](https://github.com/clawborrator/desktop_v1) — `clawborrator-supervisor`, the desktop daemon for managed CC sessions
|
|
10
|
+
on npm.
|
|
15
11
|
|
|
16
12
|
> **Status: production hub at [`next.clawborrator.com`](https://next.clawborrator.com).**
|
|
17
13
|
> Local dev uses `ws://localhost:8787`. Both supported.
|
|
@@ -129,7 +125,8 @@ for the dispatcher-pattern setup.
|
|
|
129
125
|
## Hook coverage
|
|
130
126
|
|
|
131
127
|
Maps each Claude Code hook to a hub event. The hook script is
|
|
132
|
-
`dist-hook/clawborrator-tail.mjs`;
|
|
128
|
+
`dist-hook/clawborrator-tail.mjs`; auto-installed on first MCP
|
|
129
|
+
startup (no separate install step).
|
|
133
130
|
|
|
134
131
|
| Hook | Hub event | Notes |
|
|
135
132
|
|---|---|---|
|
|
@@ -139,27 +136,23 @@ Maps each Claude Code hook to a hub event. The hook script is
|
|
|
139
136
|
| `PostToolUseFailure` | `tail/PostToolUseFailure` | |
|
|
140
137
|
| `Stop` | `tail/Stop` (+ `chat/reply` if assistant_text present) | Turn-end signal. |
|
|
141
138
|
| `Notification` | `tail/Notification` | CC user notifications (idle / permission). |
|
|
142
|
-
| `SessionStart` / `SessionEnd` | `tail/SessionStart` / `tail/SessionEnd` | |
|
|
143
139
|
| `TaskCreated` / `TaskCompleted` | `tail/TaskCreated` / `tail/TaskCompleted` | Carries `task_id`, `task_subject`, `task_description`. |
|
|
144
140
|
| `SubagentStart` / `SubagentStop` | `tail/SubagentStart` / `tail/SubagentStop` | SubagentStop carries `last_assistant_message` recap. |
|
|
145
141
|
|
|
142
|
+
`SessionStart` / `SessionEnd` are intentionally **not** hooked by
|
|
143
|
+
this MCP. The hook spawn had a fundamental race — the sidecar
|
|
144
|
+
isn't written yet at SessionStart, and is already gone by SessionEnd
|
|
145
|
+
— so lifecycle is now emitted server-side from the `/channel` WS
|
|
146
|
+
welcome / close transitions (`hub_v1/server/src/ws/channel.ts`).
|
|
147
|
+
Hub-authoritative, captures actual channel liveness, no hook timing
|
|
148
|
+
involved.
|
|
149
|
+
|
|
146
150
|
The tail reads the CC transcript file directly to enrich `PreToolUse`
|
|
147
151
|
with the assistant's pre-reply text (which CC doesn't put on the
|
|
148
152
|
hook payload directly). See `transcript.ts` for the walker.
|
|
149
153
|
|
|
150
154
|
---
|
|
151
155
|
|
|
152
|
-
## Phases (all shipped)
|
|
153
|
-
|
|
154
|
-
- **Phase A** ✓ — connect / register / heartbeat / reconnect
|
|
155
|
-
- **Phase B** ✓ — hooks + event forwarding via sidecar
|
|
156
|
-
- **Phase C** ✓ — bidirectional permission relay (channel → hub → operator → back)
|
|
157
|
-
- **Phase D** ✓ — MCP tools (above)
|
|
158
|
-
- **Phase E** ✓ — public-agent dispatch (`dispatch_to_agent`, `list_agents`); 15-min timeouts; cyclomatic-complexity refactor
|
|
159
|
-
- **Phase F** ✓ — streaming `reply_chunk` (incremental output), `read_file` / `download_to_path` for cross-session file exchange
|
|
160
|
-
|
|
161
|
-
---
|
|
162
|
-
|
|
163
156
|
## Local dev (linked to a sibling hub_v1 checkout)
|
|
164
157
|
|
|
165
158
|
```bash
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "clawborrator-mcp",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.32",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "clawborrator channel for hub_v1 — MCP server that connects Claude Code to a hub over WebSocket, with hooks for activity capture and tools for cross-session routing.",
|
|
6
6
|
"license": "MIT",
|
|
@@ -19,8 +19,7 @@
|
|
|
19
19
|
"websocket",
|
|
20
20
|
"remote",
|
|
21
21
|
"ai",
|
|
22
|
-
"agent"
|
|
23
|
-
"hub-v1"
|
|
22
|
+
"agent"
|
|
24
23
|
],
|
|
25
24
|
"main": "dist/index.js",
|
|
26
25
|
"bin": {
|