@clawchatsai/connector 0.1.4 → 0.1.6

package/README.md

@@ -77,6 +77,69 @@ Config is read in priority order:
 2. `~/.openclaw/openclaw.json` (OpenClaw gateway config)
 3. `config.js` in the plugin directory (local override, gitignored)
 
+## Development
+
+To work on the connector locally alongside the ClawChats frontend:
+
+### Prerequisites
+
+- Node.js 22+
+- OpenClaw installed and on your `PATH`
+- The `clawchats` repo cloned at `~/clawchats` (or set `CONNECTOR_DIR` when calling its `dev.sh`)
+
+### Build
+
+```bash
+npm install
+npm run build        # tsc — compiles src/ → dist/
+node esbuild.config.mjs   # bundles server/ → server.js (production deploy only)
+```
+
+Or use the dev script:
+
+```bash
+./dev.sh             # watch-mode tsc (recompiles on save)
+./dev.sh --once      # single build
+./dev.sh --server    # esbuild bundle (for deploy)
+```
+
+### Running the full stack
+
+The connector runs as an OpenClaw plugin — it can't run standalone. Use the ClawChats dev stack to run everything together:
+
+```bash
+# From the clawchats repo:
+cd ~/clawchats && ./dev.sh --skip-build
+```
+
+See the ClawChats frontend repo for the full dev stack setup flow.
+
+### Hot-reload loop
+
+```bash
+# Terminal 1 — watch-mode compiler
+cd ~/connector && ./dev.sh
+
+# Terminal 2 — full stack (no rebuild)
+cd ~/clawchats && ./dev.sh --skip-build
+```
+
+After each tsc rebuild, reload the plugin:
+```bash
+openclaw --dev gateway restart
+```
+
+### Publishing
+
+Releases are automated via GitHub Actions. Push a tag to trigger:
+
+```bash
+git tag v0.1.3
+git push origin main --tags
+```
+
+The workflow runs `npm publish` to `@clawchatsai/connector` automatically. Do not run `npm publish` manually.
+
 ## License
 
 [AGPL-3.0-only](LICENSE) — source is open for audit and contribution.

package/dist/index.js

@@ -564,6 +564,7 @@ function setupDataChannelHandler(dc, connectionId, ctx) {
     dc.onClosed(() => {
         connectedClients.delete(connectionId);
         cleanupAuth(connectionId);
+        app?.debugLogger.handleClientDisconnect(dc);
     });
 }
 /**
@@ -661,6 +662,24 @@ function processAuthenticatedMessage(dc, connectionId, msg, ctx) {
         case 'ping':
             dc.send(JSON.stringify({ type: 'pong' }));
             break;
+        case 'clawchats':
+        case 'shellchat': {
+            if (!app)
+                break;
+            const action = msg['action'];
+            if (action === 'debug-start') {
+                const ts = typeof msg['ts'] === 'string' ? msg['ts'] : new Date().toISOString();
+                const r = app.debugLogger.start(ts, dc);
+                dc.send(JSON.stringify(r.error === 'already-active'
+                    ? { type: 'clawchats', event: 'debug-error', error: 'Recording already active in another tab', sessionId: r.sessionId }
+                    : { type: 'clawchats', event: 'debug-started', sessionId: r.sessionId }));
+            }
+            else if (action === 'debug-dump') {
+                const r = app.debugLogger.saveDump(msg);
+                dc.send(JSON.stringify({ type: 'clawchats', event: 'debug-saved', sessionId: r.sessionId, files: r.files }));
+            }
+            break;
+        }
         default:
             // Unknown message type — ignore silently.
             // (Sending an error response would break heartbeat backward-compat
@@ -1055,13 +1074,13 @@ async function handleSetupTotp() {
         }
         else {
             // Expired — generate a fresh one
-            totpSecret = generateTotpSecret();
+            totpSecret = process.env.CLAWCHATS_DEV_TOTP_SECRET || generateTotpSecret();
             config.totpPending = { secret: totpSecret, generatedAt: new Date().toISOString() };
             saveConfig(config);
         }
     }
     else {
-        totpSecret = generateTotpSecret();
+        totpSecret = process.env.CLAWCHATS_DEV_TOTP_SECRET || generateTotpSecret();
         config.totpPending = { secret: totpSecret, generatedAt: new Date().toISOString() };
         saveConfig(config);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawchatsai/connector",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "type": "module",
   "description": "ClawChats OpenClaw plugin — P2P tunnel + local API bridge",
   "main": "dist/index.js",

package/server/index.js

@@ -344,6 +344,7 @@ export function createApp(config = {}) {
     closeAllDbs: closeAll,
     gatewayClient,
     setupBrowserWs,
+    debugLogger,
     dataDir: DATA_DIR,
   };
 }