bus-agent 2.3.1 → 2.3.2

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.
Files changed (2) hide show
  1. package/README.md +34 -12
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -206,17 +206,19 @@ node coco-cli.js backup --list
206
206
  npm install -g bus-agent
207
207
  npx bus-agent
208
208
 
209
- # Or from source:
209
+ # Or from source (local folder still 'mcp-coco'):
210
210
  git clone https://github.com/ClewCode/bus-agent.git
211
- cd mcp-coco
211
+ cd bus-agent
212
212
 
213
213
  # MCP mode (for any MCP client)
214
214
  node index.js
215
215
 
216
216
  # CLI mode (for scripts / terminal agents)
217
- node coco-cli.js status
218
- node coco-cli.js agents
219
- node coco-cli.js send hermes "Hello"
217
+ npx bus-agent # Run as MCP server (stdio)
218
+ # Or with global install:
219
+ coco status # Check bus health
220
+ coco agents # List registered agents
221
+ coco send hermes "Hello" # Send a DM
220
222
 
221
223
  # Webhook gateway (optional)
222
224
  node webhook-gateway.js 8080
@@ -230,22 +232,36 @@ Add the following to your MCP client configuration:
230
232
  {
231
233
  "mcpServers": {
232
234
  "coco": {
233
- "command": "node",
234
- "args": ["/path/to/mcp-coco/index.js"]
235
+ "command": "npx",
236
+ "args": ["bus-agent"]
235
237
  }
236
238
  }
237
239
  }
238
240
  ```
239
241
 
240
- Or use `node setup.js` to generate configuration automatically.
242
+ Or from a local clone:
241
243
 
242
- ### Environment Variable
244
+ ```json
245
+ {
246
+ "mcpServers": {
247
+ "coco": {
248
+ "command": "node",
249
+ "args": ["/path/to/bus-agent/index.js"]
250
+ }
251
+ }
252
+ }
253
+ ```
254
+
255
+ ### Environment Variables
243
256
 
244
257
  ```bash
245
- # Set your agent identity
246
- export COCO_AGENT=opencode
258
+ # Your agent name on the bus
259
+ export COCO_AGENT=my-agent
247
260
  # Windows (PowerShell)
248
- $env:COCO_AGENT = "opencode"
261
+ $env:COCO_AGENT = "my-agent"
262
+
263
+ # Optional: custom data directory (default: ./.bus/ in CWD)
264
+ export BUS_DIR=/path/to/my-bus-data
249
265
  ```
250
266
 
251
267
  ---
@@ -280,6 +296,12 @@ $env:COCO_AGENT = "opencode"
280
296
 
281
297
  All bus state is stored as plain JSON files on disk. No database or external service required.
282
298
 
299
+ The data directory (`.bus/`) is resolved at runtime:
300
+ 1. `$BUS_DIR` environment variable (if set)
301
+ 2. `$CWD/.bus/` (current working directory — **default**)
302
+
303
+ This means each user/project gets **their own isolated data**. No cross-user data sharing. The `.bus/` folder is gitignored by default.
304
+
283
305
  ---
284
306
 
285
307
  ## Data Layout
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bus-agent",
3
- "version": "2.3.1",
3
+ "version": "2.3.2",
4
4
  "description": "Universal Agent Communication Hub — Connect any AI agent to any other. MCP bus with messaging, channels, memory, scheduling, workflows, and diagnostics.",
5
5
  "main": "index.js",
6
6
  "bin": {