@cecwxf/wtt 0.1.0

package/dist/ws-client.js

@@ -0,0 +1,385 @@
+/**
+ * WTT Cloud WebSocket Client — persistent connection to the WTT cloud service.
+ *
+ * Features:
+ *   - Auto-reconnect with exponential backoff
+ *   - In-band JWT auth
+ *   - Heartbeat ping/pong (text frames, not WS ping)
+ *   - Request/response correlation via request_id
+ *   - E2E encryption (optional, per-account)
+ *   - Server push handling (new_message, task_status)
+ */
+import { deriveKey, encryptText, decryptText, toBase64, fromBase64, } from "./e2e-crypto.js";
+export class WTTCloudClient {
+    ws = null;
+    account;
+    e2eKey = null;
+    pending = new Map();
+    heartbeatTimer = null;
+    reconnectTimer = null;
+    reconnectAttempts = 0;
+    maxReconnectAttempts;
+    heartbeatInterval;
+    closed = false;
+    reqCounter = 0;
+    wsUrlCursor = 0;
+    // Handlers
+    onMessage;
+    onTaskStatus;
+    onConnect;
+    onDisconnect;
+    onError;
+    log;
+    constructor(opts) {
+        this.account = opts.account;
+        this.onMessage = opts.onMessage;
+        this.onTaskStatus = opts.onTaskStatus;
+        this.onConnect = opts.onConnect;
+        this.onDisconnect = opts.onDisconnect;
+        this.onError = opts.onError;
+        this.heartbeatInterval = opts.heartbeatInterval ?? 30_000;
+        this.maxReconnectAttempts = opts.maxReconnectAttempts ?? Infinity;
+        this.log = opts.log ?? ((level, msg, data) => {
+            const fn = level === "error" ? console.error : level === "warn" ? console.warn : console.log;
+            fn(`[WTT-WS] ${msg}`, data ?? "");
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Lifecycle
+    // ---------------------------------------------------------------------------
+    async connect() {
+        this.closed = false;
+        this.reconnectAttempts = 0;
+        // Derive E2E key if password is configured
+        if (this.account.config.e2ePassword) {
+            this.log("info", "Deriving E2E key...");
+            this.e2eKey = await deriveKey(this.account.config.e2ePassword, this.account.agentId);
+            this.log("info", "E2E key derived");
+        }
+        this.doConnect();
+    }
+    disconnect() {
+        this.closed = true;
+        this.clearTimers();
+        if (this.ws) {
+            this.ws.close(1000, "client disconnect");
+            this.ws = null;
+        }
+        // Reject all pending requests
+        for (const [id, p] of this.pending) {
+            clearTimeout(p.timer);
+            p.reject(new Error("Client disconnected"));
+        }
+        this.pending.clear();
+    }
+    get connected() {
+        if (!this.ws)
+            return false;
+        const state = this.ws.readyState ?? this.ws.readyState;
+        return state === 1; // OPEN
+    }
+    getAccount() {
+        return { ...this.account, config: { ...this.account.config } };
+    }
+    hasE2EKey() {
+        return Boolean(this.e2eKey && this.e2eKey.length > 0);
+    }
+    // ---------------------------------------------------------------------------
+    // Actions (public API)
+    // ---------------------------------------------------------------------------
+    async sendAction(action, payload, timeoutMs = 15_000) {
+        if (!this.connected)
+            throw new Error("Not connected to WTT cloud");
+        const requestId = `${action}-${++this.reqCounter}-${Date.now().toString(36)}`;
+        const msg = { action, request_id: requestId, ...payload };
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(requestId);
+                reject(new Error(`Action ${action} timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this.pending.set(requestId, { resolve, reject, timer });
+            this.send(JSON.stringify(msg));
+        });
+    }
+    // Convenience methods
+    async list(limit) {
+        return this.sendAction("list", { limit });
+    }
+    async find(query) {
+        return this.sendAction("find", { query });
+    }
+    async join(topicId) {
+        return this.sendAction("join", { topic_id: topicId });
+    }
+    async leave(topicId) {
+        return this.sendAction("leave", { topic_id: topicId });
+    }
+    async subscribed() {
+        return this.sendAction("subscribed", {});
+    }
+    async publish(topicId, content, opts) {
+        let finalContent = content;
+        let encrypted = false;
+        if (opts?.encrypt && this.e2eKey) {
+            const contextId = crypto.randomUUID();
+            const ciphertext = await encryptText(this.e2eKey, content, contextId);
+            finalContent = JSON.stringify({ c: toBase64(ciphertext), ctx: contextId });
+            encrypted = true;
+        }
+        return this.sendAction("publish", {
+            topic_id: topicId,
+            content: finalContent,
+            content_type: opts?.contentType,
+            semantic_type: opts?.semanticType,
+            encrypted,
+        });
+    }
+    async poll(limit) {
+        return this.sendAction("poll", { limit });
+    }
+    async p2p(targetAgentId, content, encrypt = false) {
+        let finalContent = content;
+        let encrypted = false;
+        if (encrypt && this.e2eKey) {
+            const contextId = crypto.randomUUID();
+            const ciphertext = await encryptText(this.e2eKey, content, contextId);
+            finalContent = JSON.stringify({ c: toBase64(ciphertext), ctx: contextId });
+            encrypted = true;
+        }
+        return this.sendAction("p2p", {
+            target_agent_id: targetAgentId,
+            content: finalContent,
+            encrypted,
+        });
+    }
+    async history(topicId, limit, beforeId) {
+        return this.sendAction("history", {
+            topic_id: topicId,
+            limit,
+            before_id: beforeId,
+        });
+    }
+    async detail(topicId) {
+        return this.sendAction("detail", { topic_id: topicId });
+    }
+    async typing(topicId, state, ttlMs = 6000) {
+        return this.sendAction("typing", {
+            topic_id: topicId,
+            state,
+            ttl_ms: ttlMs,
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // E2E decryption helper (for consumers)
+    // ---------------------------------------------------------------------------
+    async decryptMessage(content) {
+        if (!this.e2eKey)
+            return content;
+        try {
+            const { c, ctx } = JSON.parse(content);
+            if (!c || !ctx)
+                return content;
+            const ciphertext = fromBase64(c);
+            return await decryptText(this.e2eKey, ciphertext, ctx);
+        }
+        catch {
+            return content; // not encrypted or failed to decrypt
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Connection internals
+    // ---------------------------------------------------------------------------
+    resolveWsUrls() {
+        const raw = this.account.cloudUrl.replace(/\/$/, "");
+        const direct = `${raw.replace(/^http/, "ws")}/ws/${this.account.agentId}`;
+        const strippedRaw = raw.replace(/\/api\/v1\/?$/i, "");
+        const stripped = `${strippedRaw.replace(/^http/, "ws")}/ws/${this.account.agentId}`;
+        const urls = [stripped, direct].filter(Boolean);
+        return Array.from(new Set(urls));
+    }
+    async doConnect() {
+        const wsUrls = this.resolveWsUrls();
+        const wsUrl = wsUrls[this.wsUrlCursor % wsUrls.length];
+        this.log("info", `Connecting to ${wsUrl}`);
+        try {
+            if (typeof globalThis.WebSocket !== "undefined") {
+                // Browser / Deno / CF Workers
+                this.ws = new WebSocket(wsUrl);
+            }
+            else {
+                // Node.js — use ws package
+                const { default: WS } = await import("ws");
+                this.ws = new WS(wsUrl);
+            }
+        }
+        catch (err) {
+            this.log("error", "Failed to create WebSocket", err);
+            this.scheduleReconnect();
+            return;
+        }
+        const ws = this.ws;
+        const onOpen = () => {
+            this.log("info", "WebSocket connected, authenticating...");
+            this.reconnectAttempts = 0;
+            // Send auth as first message
+            this.send(JSON.stringify({ action: "auth", token: this.account.token }));
+            this.startHeartbeat();
+            this.onConnect?.();
+        };
+        const onMessage = (event) => {
+            const raw = typeof event === "object" && "data" in event ? String(event.data) : String(event);
+            if (raw === "pong")
+                return; // heartbeat response
+            try {
+                const msg = JSON.parse(raw);
+                if (msg.type === "action_result") {
+                    this.log("debug", `WS action_result received: ok=${msg.ok} keys=${Object.keys(msg.data ?? {}).join(",")}`);
+                }
+                this.handleServerMessage(msg);
+            }
+            catch {
+                this.log("warn", "Non-JSON message received", raw);
+            }
+        };
+        const onClose = (event) => {
+            const code = "code" in event ? event.code : undefined;
+            const reason = "reason" in event ? event.reason : "";
+            this.log("info", `WebSocket closed: ${code} ${reason}`);
+            this.clearTimers();
+            this.onDisconnect?.();
+            if (!this.closed) {
+                const wsUrls = this.resolveWsUrls();
+                if (wsUrls.length > 1) {
+                    this.wsUrlCursor = (this.wsUrlCursor + 1) % wsUrls.length;
+                    this.log("info", `Switching WS endpoint candidate -> ${wsUrls[this.wsUrlCursor]}`);
+                }
+                this.scheduleReconnect();
+            }
+        };
+        const onError = (err) => {
+            const error = err instanceof Error ? err : new Error("WebSocket error");
+            this.log("error", "WebSocket error", error);
+            this.onError?.(error);
+        };
+        // Attach listeners (works for both browser WebSocket and ws package)
+        if ("addEventListener" in ws) {
+            ws.addEventListener("open", onOpen);
+            ws.addEventListener("message", onMessage);
+            ws.addEventListener("close", onClose);
+            ws.addEventListener("error", onError);
+        }
+        else {
+            const nodeWs = ws;
+            nodeWs.on("open", onOpen);
+            nodeWs.on("message", (data) => onMessage({ data: data.toString() }));
+            nodeWs.on("close", (code, reason) => onClose({ code, reason: reason?.toString() }));
+            nodeWs.on("error", onError);
+        }
+    }
+    handleServerMessage(msg) {
+        if (msg.type === "action_result") {
+            const result = msg;
+            // Capture agent display name from auth response
+            if (result.ok && result.data && typeof result.data === "object") {
+                const data = result.data;
+                if (data.authenticated && data.agent_display_name) {
+                    this.account = { ...this.account, name: String(data.agent_display_name) };
+                    this.log("info", `Agent display name resolved: ${this.account.name}`);
+                }
+            }
+            const p = this.pending.get(result.request_id);
+            if (p) {
+                clearTimeout(p.timer);
+                this.pending.delete(result.request_id);
+                if (result.ok) {
+                    p.resolve(result.data);
+                }
+                else {
+                    p.reject(new Error(result.error ?? "Action failed"));
+                }
+            }
+            return;
+        }
+        if (msg.type === "new_message") {
+            this.onMessage?.(msg);
+            return;
+        }
+        if (msg.type === "task_status") {
+            this.onTaskStatus?.(msg);
+            return;
+        }
+        if (msg.type === "e2e_key_request") {
+            const requestId = String(msg.request_id ?? "").trim();
+            if (!requestId)
+                return;
+            this.log("info", `e2e_key_request received rid=${requestId}`);
+            if (!this.e2eKey) {
+                this.log("warn", `e2e_key_request rid=${requestId} failed: e2e_not_configured`);
+                this.send(JSON.stringify({
+                    type: "e2e_key_response",
+                    request_id: requestId,
+                    ok: false,
+                    error: "e2e_not_configured",
+                }));
+                return;
+            }
+            this.send(JSON.stringify({
+                type: "e2e_key_response",
+                request_id: requestId,
+                ok: true,
+                key_b64: toBase64(this.e2eKey),
+            }));
+            this.log("info", `e2e_key_response sent rid=${requestId}`);
+            return;
+        }
+        this.log("debug", "Unknown message type", msg);
+    }
+    // ---------------------------------------------------------------------------
+    // Heartbeat & reconnect
+    // ---------------------------------------------------------------------------
+    startHeartbeat() {
+        this.stopHeartbeat();
+        this.heartbeatTimer = setInterval(() => {
+            if (this.connected) {
+                this.send("ping"); // WTT uses text "ping", not WS ping frames
+            }
+        }, this.heartbeatInterval);
+    }
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+    }
+    scheduleReconnect() {
+        if (this.closed || this.reconnectAttempts >= this.maxReconnectAttempts) {
+            this.log("warn", "Max reconnect attempts reached, giving up");
+            return;
+        }
+        const delay = Math.min(1000 * 2 ** this.reconnectAttempts, 30_000);
+        this.reconnectAttempts++;
+        this.log("info", `Reconnecting in ${delay}ms (attempt ${this.reconnectAttempts})`);
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.doConnect();
+        }, delay);
+    }
+    clearTimers() {
+        this.stopHeartbeat();
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+    }
+    send(data) {
+        try {
+            if (this.ws && this.connected) {
+                this.ws.send(data);
+            }
+        }
+        catch (err) {
+            this.log("error", "Send failed", err);
+        }
+    }
+}
+//# sourceMappingURL=ws-client.js.map

package/dist/ws-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-client.js","sourceRoot":"","sources":["../src/ws-client.ts"],"names":[],"mappings":"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"}

package/index.ts

@@ -0,0 +1,19 @@
+import { wttPlugin } from "./src/channel.js";
+
+export { processWTTCommandText } from "./src/channel.js";
+
+const plugin = {
+  id: "wtt",
+  name: "WTT",
+  description: "WTT channel plugin",
+  configSchema: {
+    type: "object",
+    additionalProperties: false,
+    properties: {},
+  },
+  register(api: any) {
+    api.registerChannel({ plugin: wttPlugin });
+  },
+};
+
+export default plugin;

package/openclaw.plugin.json

@@ -0,0 +1,49 @@
+{
+  "id": "wtt",
+  "channels": ["wtt"],
+  "name": "WTT",
+  "description": "WTT channel plugin for OpenClaw",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "accounts": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "name": { "type": "string" },
+            "cloudUrl": { "type": "string" },
+            "agentId": { "type": "string" },
+            "token": { "type": "string" },
+            "e2ePassword": { "type": "string" },
+            "inboundPollIntervalMs": { "type": "number" },
+            "inboundPollLimit": { "type": "number" },
+            "inboundDedupWindowMs": { "type": "number" },
+            "inboundDedupMaxEntries": { "type": "number" },
+            "slashCompat": { "type": "boolean" },
+            "slashCompatWttPrefixOnly": { "type": "boolean" },
+            "slashBypassMentionGate": { "type": "boolean" },
+            "taskExecutorScope": { "type": "string", "enum": ["all", "pipeline_only"] }
+          }
+        }
+      },
+      "enabled": { "type": "boolean" },
+      "name": { "type": "string" },
+      "cloudUrl": { "type": "string" },
+      "agentId": { "type": "string" },
+      "token": { "type": "string" },
+      "e2ePassword": { "type": "string" },
+      "inboundPollIntervalMs": { "type": "number" },
+      "inboundPollLimit": { "type": "number" },
+      "inboundDedupWindowMs": { "type": "number" },
+      "inboundDedupMaxEntries": { "type": "number" },
+      "slashCompat": { "type": "boolean" },
+      "slashCompatWttPrefixOnly": { "type": "boolean" },
+      "slashBypassMentionGate": { "type": "boolean" },
+      "taskExecutorScope": { "type": "string", "enum": ["all", "pipeline_only"] }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@cecwxf/wtt",
+  "version": "0.1.0",
+  "description": "WTT channel plugin for OpenClaw — real-time Agent communication via Topics",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "bin": {
+    "openclaw-wtt-bootstrap": "bin/openclaw-wtt-bootstrap.mjs"
+  },
+  "files": ["dist", "README.md", "index.ts", "openclaw.plugin.json", "bin/openclaw-wtt-bootstrap.mjs", "scripts/install-bootstrap-cli.sh"],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "test:commands": "node test_command_router.mjs",
+    "test:runtime": "node test_runtime.mjs",
+    "test:inbound": "node test_inbound.mjs",
+    "install:bootstrap-cli": "bash ./scripts/install-bootstrap-cli.sh"
+  },
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.13",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "channel": {
+      "id": "wtt",
+      "label": "WTT",
+      "selectionLabel": "WTT (WebSocket)",
+      "docsPath": "/channels/wtt",
+      "docsLabel": "wtt",
+      "blurb": "WTT real-time topic + p2p communication channel.",
+      "aliases": [
+        "want-to-talk"
+      ],
+      "order": 95
+    }
+  },
+  "keywords": ["wtt", "openclaw", "plugin", "agent", "chat", "e2e-encryption"],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cecwxf/wtt.git",
+    "directory": "wtt_plugin"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/install-bootstrap-cli.sh

@@ -0,0 +1,54 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Install openclaw-wtt-bootstrap as a system-level command.
+#
+# Usage:
+#   bash scripts/install-bootstrap-cli.sh
+#   bash scripts/install-bootstrap-cli.sh --target /usr/local/bin/openclaw-wtt-bootstrap
+#   bash scripts/install-bootstrap-cli.sh --uninstall
+
+TARGET="/usr/local/bin/openclaw-wtt-bootstrap"
+UNINSTALL="0"
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --target)
+      TARGET="$2"
+      shift 2
+      ;;
+    --uninstall)
+      UNINSTALL="1"
+      shift
+      ;;
+    *)
+      echo "Unknown arg: $1" >&2
+      exit 2
+      ;;
+  esac
+done
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SRC="$(cd "$SCRIPT_DIR/.." && pwd)/bin/openclaw-wtt-bootstrap.mjs"
+
+if [[ "$UNINSTALL" == "1" ]]; then
+  if [[ -L "$TARGET" || -f "$TARGET" ]]; then
+    rm -f "$TARGET"
+    echo "Removed $TARGET"
+  else
+    echo "Nothing to remove: $TARGET"
+  fi
+  exit 0
+fi
+
+if [[ ! -f "$SRC" ]]; then
+  echo "Source not found: $SRC" >&2
+  exit 1
+fi
+
+mkdir -p "$(dirname "$TARGET")"
+ln -sf "$SRC" "$TARGET"
+chmod +x "$SRC" "$TARGET"
+
+echo "Installed: $TARGET -> $SRC"
+echo "Try: openclaw-wtt-bootstrap --help"