@decentchat/decentclaw 0.1.1 → 0.1.3

package/README.md

@@ -1,88 +1,154 @@
-# decent-openclaw
+# @decentchat/decentclaw
 
-OpenClaw channel plugin for DecentChat.
+OpenClaw channel plugin for [DecentChat](https://github.com/Alino/DecentChat) -- peer-to-peer encrypted chat over WebRTC.
 
-## Setup
+Connects your OpenClaw agent to DecentChat workspaces so it can read and reply to messages in channels, groups, DMs, and threads.
 
-1. Add this plugin path to your OpenClaw config under `plugins.load.paths`.
-2. Configure channel settings under `channels.decentchat`:
-   - `enabled`
-   - `seedPhrase` (required; BIP39 mnemonic)
-   - `signalingServer` (optional; default `https://decentchat.app/peerjs`)
-   - `invites` (optional DecentChat invite URIs)
-3. Enable OpenClaw in the DecentChat settings panel.
-4. Use `/activation` in any channel if you want responses to all messages.
+## Install
 
+```
+openclaw plugins install @decentchat/decentclaw
+```
+
+## Configure
 
-## Status
+Add a `channels.decentchat` block to your OpenClaw config (`~/.openclaw/openclaw.json` or per-project):
+
+```yaml
+channels:
+  decentchat:
+    enabled: true
+    seedPhrase: "your twelve word BIP39 mnemonic goes here ..."
+```
 
-- Thread-aware routing is supported (including `replyToId` fallback).
-- Per-chat-type reply mode overrides are supported via `replyToModeByChatType`.
-- Active implementation plan: `docs/plans/2026-02-28-decent-openclaw-parity-threading.md`.
+That's the minimum. The bot will join the DecentChat network using the default signaling server (`https://decentchat.app/peerjs`), respond to all messages, and call itself "DecentChat Bot".
 
+### Optional settings
 
-## Config migration (threading parity)
+| Key | Default | What it does |
+|-----|---------|-------------|
+| `signalingServer` | `https://decentchat.app/peerjs` | PeerJS signaling endpoint |
+| `invites` | `[]` | DecentChat invite URIs to auto-join |
+| `alias` | `"DecentChat Bot"` | Display name for the bot |
+| `dataDir` | auto | Override the data directory |
+| `dmPolicy` | `"open"` | DM access: `open`, `pairing`, `allowlist`, or `disabled` |
+| `streamEnabled` | `true` | Stream responses token-by-token |
+| `replyToMode` | `"all"` | Reply behavior: `off`, `first`, or `all` |
 
-If you are upgrading from pre-parity config, migrate from global-only reply mode to explicit chat-type/thread settings.
+### Reply mode per chat type
 
-Before:
+You can override `replyToMode` for specific chat types:
 
 ```yaml
 channels:
   decentchat:
     enabled: true
+    seedPhrase: "..."
     replyToMode: all
+    replyToModeByChatType:
+      direct: "off"
+      group: "all"
+      channel: "all"
 ```
 
-After:
+### Thread settings
 
 ```yaml
 channels:
   decentchat:
-    enabled: true
-    replyToMode: all
-    replyToModeByChatType:
-      direct: off
-      group: all
-      channel: all
     thread:
-      historyScope: thread
+      historyScope: "thread"     # "thread" or "channel"
       inheritParent: false
-      initialHistoryLimit: 10
+      initialHistoryLimit: 20
 ```
 
-## Feature flags and safe defaults
+- `historyScope: thread` -- the bot only sees messages in the current thread (not the full channel history)
+- `inheritParent: false` -- don't prepend the parent message to thread context
+- `initialHistoryLimit` -- how many prior thread messages to load for context
 
-Recommended safe defaults:
+### Huddle (voice) settings
 
-- `replyToMode: all`
-- `replyToModeByChatType.direct: off`
-- `thread.historyScope: thread`
-- `thread.initialHistoryLimit: 10`
+```yaml
+channels:
+  decentchat:
+    huddle:
+      enabled: true
+      autoJoin: false
+      sttEngine: "whisper-cpp"    # whisper-cpp | whisper-python | openai | groq
+      whisperModel: "base.en"
+      sttLanguage: "en"
+      ttsVoice: "alloy"
+      vadSilenceMs: 800
+      vadThreshold: 0.5
+```
 
-Fast safety toggles if behavior is noisy:
+### Company simulation
 
-- Disable thread splitting entirely:
-  - `replyToMode: off`
-- Keep channel-wide session history (no per-thread split):
-  - `thread.historyScope: channel`
-- Disable bootstrap thread-context prefill:
-  - `thread.initialHistoryLimit: 0`
+The plugin includes a company simulation subsystem (`@decentchat/company-sim`) that lets you run multi-agent teams inside DecentChat workspaces. Configure it per-account:
 
-## Rollback checklist
+```yaml
+channels:
+  decentchat:
+    companySim:
+      enabled: true
+      manifestPath: "./company-manifest.yaml"
+      companyId: "acme"
+      employeeId: "bot-1"
+    companySimBootstrap:
+      enabled: true
+      mode: "runtime"
+```
+
+### Multiple accounts
 
-1. Revert to previous known-good commit.
-2. Set conservative config:
+Run multiple bot identities from one OpenClaw instance:
 
 ```yaml
 channels:
   decentchat:
-    replyToMode: off
-    thread:
-      historyScope: channel
-      initialHistoryLimit: 0
+    defaultAccount: "main"
+    accounts:
+      main:
+        seedPhrase: "first mnemonic ..."
+        alias: "Bot A"
+      secondary:
+        seedPhrase: "second mnemonic ..."
+        alias: "Bot B"
+        dmPolicy: "disabled"
+```
+
+Each account gets its own peer connection and data directory.
+
+## Quick safety toggles
+
+If the bot is too chatty:
+
+```yaml
+# Shut off all replies
+replyToMode: "off"
+
+# Keep replies but use full channel history (no per-thread split)
+thread:
+  historyScope: "channel"
+
+# Disable thread context prefill
+thread:
+  initialHistoryLimit: 0
 ```
 
-3. Restart OpenClaw runtime.
-4. Validate route logs and one direct + one group reply path.
-5. Re-enable features gradually (`replyToMode`, then `historyScope`, then `initialHistoryLimit`).
+## How it works
+
+The plugin creates a DecentChat peer (using `@decentchat/protocol` and `@decentchat/transport-webrtc`) that joins the P2P mesh. Incoming messages are routed through OpenClaw's agent pipeline. Responses are sent back to the originating chat, with thread-aware routing so replies land in the right thread.
+
+All traffic is end-to-end encrypted (ECDH + AES-GCM-256). The bot's identity is derived from the seed phrase, same as any other DecentChat client.
+
+## Dependencies
+
+- [@decentchat/protocol](https://npmjs.com/package/@decentchat/protocol) -- DecentChat SDK
+- [@decentchat/transport-webrtc](https://npmjs.com/package/@decentchat/transport-webrtc) -- WebRTC transport layer
+- [@decentchat/company-sim](https://npmjs.com/package/@decentchat/company-sim) -- company simulation subsystem
+- [openclaw](https://openclaw.ai) -- peer dependency (the host runtime)
+
+## License
+
+MIT

package/index.ts

@@ -4,7 +4,7 @@ import { decentChatPlugin } from './src/channel.js';
 import { setDecentChatRuntime } from './src/runtime.js';
 
 const plugin = {
-  id: 'decentchat',
+  id: 'decentclaw',
   name: 'DecentChat',
   description: 'DecentChat P2P channel plugin',
   configSchema: emptyPluginConfigSchema(),

package/openclaw.plugin.json

@@ -1,5 +1,5 @@
 {
-  "id": "decentchat",
+  "id": "decentclaw",
   "name": "DecentChat",
   "version": "0.1.1",
   "channels": ["decentchat"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decentchat/decentclaw",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "OpenClaw channel plugin for DecentChat — P2P encrypted chat",
   "type": "module",
   "main": "index.ts",
@@ -31,9 +31,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@decentchat/company-sim": "^0.1.0",
-    "decent-protocol": "^0.1.0",
-    "decent-transport-webrtc": "^0.1.0",
+    "@decentchat/company-sim": "^0.1.1",
+    "@decentchat/protocol": "^0.1.0",
+    "@decentchat/transport-webrtc": "^0.1.0",
     "node-datachannel": "^0.32.1",
     "opusscript": "^0.1.1",
     "yaml": "^2.8.2",

package/src/peer/DecentChatNodePeer.ts

@@ -15,7 +15,7 @@ import {
   SeedPhraseManager,
   WorkspaceManager,
   Negentropy,
-} from 'decent-protocol';
+} from '@decentchat/protocol';
 import type {
   Workspace,
   WorkspaceMember,
@@ -31,8 +31,8 @@ import type {
   SyncManifestSummary,
   SyncManifestSnapshot,
   ManifestStoreState,
-} from 'decent-protocol';
-import { PeerTransport } from 'decent-transport-webrtc';
+} from '@decentchat/protocol';
+import { PeerTransport } from '@decentchat/transport-webrtc';
 import { createHash, randomUUID } from 'node:crypto';
 import { FileStore } from './FileStore.js';
 import { NodeMessageProtocol } from './NodeMessageProtocol.js';

package/src/peer/NodeMessageProtocol.ts

@@ -17,7 +17,7 @@ import {
   planLocalOneTimePreKeyLifecycle,
   normalizePeerPreKeyBundle as normalizePeerPreKeyBundlePolicy,
   hasPeerPreKeyBundleChanged,
-} from 'decent-protocol';
+} from '@decentchat/protocol';
 import type {
   KeyPair,
   RatchetState,
@@ -27,7 +27,7 @@ import type {
   PersistedLocalPreKeyState,
   PreKeySessionInitPayload,
   PreKeyType,
-} from 'decent-protocol';
+} from '@decentchat/protocol';
 
 interface EnvelopeMetadata {
   fileName?: string;

package/src/peer/SyncProtocol.ts

@@ -12,9 +12,9 @@ import {
   type WorkspaceMember,
   MessageStore,
   WorkspaceManager,
-} from 'decent-protocol';
-import type { ServerDiscovery } from 'decent-protocol';
-import type { NegentropyQuery, NegentropyResponse } from 'decent-protocol';
+} from '@decentchat/protocol';
+import type { ServerDiscovery } from '@decentchat/protocol';
+import type { NegentropyQuery, NegentropyResponse } from '@decentchat/protocol';
 
 export type SendFn = (peerId: string, data: any) => boolean;
 export type OnEvent = (event: SyncEvent) => void;