ddchat 0.3.0 → 0.4.1

package/src/types.ts

@@ -1,136 +0,0 @@
-import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
-import { DDCHAT_CHANNEL_ID, DDCHAT_DEFAULT_ACCOUNT_ID } from "./constants.js";
-
-export type DdchatStreamingMode = "chunk" | "token";
-export type DdchatConnectionMode = "websocket" | "webhook";
-export type DdchatPolicy = "open" | "pairing" | "allowlist";
-
-export type DdchatResolvedAccount = {
-  accountId: string;
-  enabled: boolean;
-  configured: boolean;
-  token?: string;
-  wsUrl?: string;
-  webhookPath?: string;
-  webhookPort?: number;
-  connectionMode: DdchatConnectionMode;
-  dmPolicy: DdchatPolicy;
-  groupPolicy: "open" | "allowlist" | "disabled";
-  requireMention: boolean;
-  streaming: boolean;
-  streamingMode: DdchatStreamingMode;
-  allowFrom: string[];
-  groupAllowFrom: string[];
-  heartbeatSec: number;
-};
-
-type DdchatAccountConfig = {
-  enabled?: boolean;
-  token?: string;
-  wsUrl?: string;
-  webhookPath?: string;
-  webhookPort?: number;
-  connectionMode?: DdchatConnectionMode;
-  dmPolicy?: DdchatPolicy;
-  groupPolicy?: "open" | "allowlist" | "disabled";
-  requireMention?: boolean;
-  streaming?: boolean;
-  streamingMode?: DdchatStreamingMode;
-  allowFrom?: Array<string | number>;
-  groupAllowFrom?: Array<string | number>;
-  heartbeatSec?: number;
-};
-
-type DdchatChannelConfig = DdchatAccountConfig & {
-  defaultAccount?: string;
-  accounts?: Record<string, DdchatAccountConfig | undefined>;
-};
-
-export function resolveDdchatMediaMaxBytes(cfg: OpenClawConfig): number | undefined {
-  const mb = cfg.agents?.defaults?.mediaMaxMb;
-  if (!mb || mb <= 0) {
-    return undefined;
-  }
-  return mb * 1024 * 1024;
-}
-
-function toStringList(input: Array<string | number> | undefined): string[] {
-  if (!input) {
-    return [];
-  }
-  return input.map((entry) => String(entry).trim()).filter(Boolean);
-}
-
-function normalizeWebhookPath(path: string | undefined): string {
-  const trimmed = path?.trim();
-  return trimmed?.startsWith("/") ? trimmed : "/ddchat/webhook";
-}
-
-function normalizeConnectionMode(mode: string | undefined): DdchatConnectionMode {
-  return mode === "webhook" ? "webhook" : "websocket";
-}
-
-function normalizeStreamingMode(mode: string | undefined): DdchatStreamingMode {
-  return mode === "token" ? "token" : "chunk";
-}
-
-function readChannelConfig(cfg: OpenClawConfig): DdchatChannelConfig {
-  return ((cfg.channels as Record<string, unknown> | undefined)?.[DDCHAT_CHANNEL_ID] ?? {}) as DdchatChannelConfig;
-}
-
-function mergeAccountConfig(params: {
-  root: DdchatChannelConfig;
-  account?: DdchatAccountConfig;
-}): DdchatAccountConfig {
-  const { root, account } = params;
-  return {
-    ...root,
-    ...account,
-  };
-}
-
-export function listDdchatAccountIds(cfg: OpenClawConfig): string[] {
-  const channelCfg = readChannelConfig(cfg);
-  const keys = Object.keys(channelCfg.accounts ?? {}).filter((key) => key.trim().length > 0);
-  return keys.length > 0 ? keys : [DDCHAT_DEFAULT_ACCOUNT_ID];
-}
-
-export function resolveDefaultDdchatAccountId(cfg: OpenClawConfig): string {
-  const channelCfg = readChannelConfig(cfg);
-  const ids = listDdchatAccountIds(cfg);
-  const configured = channelCfg.defaultAccount?.trim();
-  return configured && ids.includes(configured) ? configured : ids[0];
-}
-
-export function resolveDdchatAccount(
-  cfg: OpenClawConfig,
-  accountId?: string | null,
-): DdchatResolvedAccount {
-  const channelCfg = readChannelConfig(cfg);
-  const resolvedAccountId = accountId?.trim() || resolveDefaultDdchatAccountId(cfg);
-  const named = channelCfg.accounts?.[resolvedAccountId];
-  const merged = mergeAccountConfig({ root: channelCfg, account: named });
-  const token = typeof merged.token === "string" ? merged.token.trim() : "";
-  const wsUrl = typeof merged.wsUrl === "string" ? merged.wsUrl.trim() : "";
-  return {
-    accountId: resolvedAccountId,
-    enabled: merged.enabled !== false,
-    configured: Boolean(token),
-    token: token || undefined,
-    wsUrl: wsUrl || undefined,
-    webhookPath: normalizeWebhookPath(merged.webhookPath),
-    webhookPort:
-      typeof merged.webhookPort === "number" && Number.isFinite(merged.webhookPort)
-        ? merged.webhookPort
-        : 3010,
-    connectionMode: normalizeConnectionMode(merged.connectionMode),
-    dmPolicy: merged.dmPolicy ?? "pairing",
-    groupPolicy: merged.groupPolicy ?? "allowlist",
-    requireMention: merged.requireMention === true,
-    streaming: merged.streaming !== false,
-    streamingMode: normalizeStreamingMode(merged.streamingMode),
-    allowFrom: toStringList(merged.allowFrom),
-    groupAllowFrom: toStringList(merged.groupAllowFrom),
-    heartbeatSec: Math.max(15, Number(merged.heartbeatSec ?? 60) || 60),
-  };
-}

package/task/BLOCKERS.md

@@ -1,3 +0,0 @@
-# BLOCKERS
-
-- None currently.

package/task/DOING.md

@@ -1,3 +0,0 @@
-# DOING
-
-- [ ] Implement websocket-first inbound and chunk streaming for multi-account `ddchat`

package/task/DONE.md

@@ -1,8 +0,0 @@
-# DONE
-
-- [x] Created `ddchat/task` workflow files (`README/TODO/DOING/DONE/BLOCKERS`)
-  - Date: 2026-04-01
-  - Verification: files exist under `ddchat/task/`
-- [x] Initialized DDChat plugin skeleton and websocket-first runtime scaffold
-  - Date: 2026-04-01
-  - Verification: `ddchat/package.json`, `ddchat/openclaw.plugin.json`, and `ddchat/src/*` core files created

package/task/README.md

@@ -1,17 +0,0 @@
-# DDChat Task Records
-
-This directory tracks development progress for the `ddchat` plugin.
-
-## Files
-
-- `TODO.md`: all pending tasks
-- `DOING.md`: the single task currently in progress
-- `DONE.md`: completed tasks with verification notes
-- `BLOCKERS.md`: blockers, decisions, and risks
-
-## Workflow
-
-1. Move one item from `TODO.md` to `DOING.md` before coding.
-2. When finished, move it to `DONE.md` with date and verification notes.
-3. If blocked, add details to `BLOCKERS.md` and stop starting new work.
-4. Keep `DOING.md` to one active task only.

package/task/TODO.md

@@ -1,10 +0,0 @@
-# TODO
-
-- [ ] Finalize plugin skeleton (`package.json`, `openclaw.plugin.json`, `index.ts`, `setup-entry.ts`)
-- [ ] Implement Feishu-style multi-account config (`channels.ddchat.accounts.*`)
-- [ ] Implement websocket inbound loop (webhook reserved only)
-- [ ] Implement inbound routing for `group` (groupId) and `direct` (userId)
-- [ ] Implement inbound text + file/image handling (base64/url -> saveMediaBuffer)
-- [ ] Implement chunk-level streaming push; keep token-level mode as reserved option
-- [ ] Add compatibility notes for future plugin rename
-- [ ] Add minimal tests for route/media parsing and duplicate suppression

package/test/README.md

@@ -1,48 +0,0 @@
-# DDChat Local Mock IM
-
-Local WebSocket IM simulator for testing the `ddchat` plugin.
-
-## Start
-
-From repo root:
-
-```bash
-node ddchat/test/server.mjs
-```
-
-Then open:
-
-- UI: `http://127.0.0.1:9020`
-- WS endpoint for plugin: `ws://127.0.0.1:9001` (override plugin `constants.ts` for local dev, or run against your mock URL)
-
-## Plugin config example
-
-```json
-{
-  "channels": {
-    "ddchat": {
-      "defaultAccount": "xkx",
-      "accounts": {
-        "xkx": {
-          "enabled": true,
-          "token": "your-plugin-token",
-          "connectionMode": "websocket",
-          "wsUrl": "ws://127.0.0.1:9001",
-          "dmPolicy": "open",
-          "groupPolicy": "open",
-          "requireMention": false,
-          "streaming": true,
-          "streamingMode": "chunk"
-        }
-      }
-    }
-  }
-}
-```
-
-## Features
-
-- Send direct/group inbound message payloads.
-- Upload files/images from browser (sent as base64 in `files[]`).
-- Optional URL-based file input.
-- View stream chunks (`stream_chunk`) and final outbound messages.

package/test/chat.html

@@ -1,304 +0,0 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>DDChat Mock IM Chat</title>
-    <style>
-      body {
-        font-family: Consolas, Menlo, monospace;
-        background: #0b1020;
-        color: #d4ddff;
-        margin: 0;
-      }
-      .wrap {
-        max-width: 1080px;
-        margin: 24px auto;
-        padding: 0 16px;
-      }
-      h1 {
-        font-size: 18px;
-        margin: 0 0 12px;
-      }
-      .panel {
-        background: #121a33;
-        border: 1px solid #24315f;
-        border-radius: 10px;
-        padding: 12px;
-        margin-bottom: 12px;
-      }
-      label {
-        font-size: 12px;
-        color: #9fb1f1;
-        display: block;
-        margin-bottom: 4px;
-      }
-      input,
-      textarea,
-      button,
-      select {
-        width: 100%;
-        box-sizing: border-box;
-        border-radius: 8px;
-        border: 1px solid #2f3e74;
-        background: #0f1630;
-        color: #d4ddff;
-        padding: 8px;
-      }
-      textarea {
-        min-height: 80px;
-      }
-      .row {
-        display: grid;
-        gap: 8px;
-        grid-template-columns: repeat(4, 1fr);
-      }
-      .row-3 {
-        display: grid;
-        gap: 8px;
-        grid-template-columns: repeat(3, 1fr);
-      }
-      .log {
-        height: 220px;
-        overflow: auto;
-        background: #090e1f;
-        border: 1px solid #24315f;
-        border-radius: 8px;
-        padding: 8px;
-        white-space: pre-wrap;
-        line-height: 1.35;
-      }
-      .btn {
-        background: #2442ad;
-        cursor: pointer;
-      }
-      .chat {
-        height: 320px;
-        overflow: auto;
-        background: #090e1f;
-        border: 1px solid #24315f;
-        border-radius: 8px;
-        padding: 10px;
-        margin-bottom: 12px;
-      }
-      .msg {
-        margin: 8px 0;
-        padding: 8px 10px;
-        border-radius: 10px;
-        max-width: 86%;
-        white-space: pre-wrap;
-      }
-      .msg.user {
-        margin-left: auto;
-        background: #1e3b87;
-      }
-      .msg.assistant {
-        margin-right: auto;
-        background: #1e2750;
-      }
-      .msg.done {
-        border: 1px solid #3954b3;
-      }
-      .meta {
-        margin-top: 6px;
-        font-size: 12px;
-        color: #9fb1f1;
-      }
-      .preview {
-        margin-top: 8px;
-        border: 1px solid #2f3e74;
-        border-radius: 8px;
-        padding: 8px;
-        background: #0f1630;
-      }
-      .preview img {
-        max-width: 280px;
-        max-height: 220px;
-        border-radius: 6px;
-        display: block;
-      }
-    </style>
-  </head>
-  <body>
-    <div class="wrap">
-      <h1>DDChat Mock IM (WebSocket)</h1>
-      <div class="panel row">
-        <div>
-          <label>Account ID</label>
-          <input id="accountId" value="xkx" />
-        </div>
-        <div>
-          <label>Chat Type</label>
-          <select id="chatType">
-            <option value="direct">direct</option>
-            <option value="group">group</option>
-          </select>
-        </div>
-        <div>
-          <label>User ID</label>
-          <input id="userId" value="u-1001" />
-        </div>
-        <div>
-          <label>Group ID (group 模式必填)</label>
-          <input id="groupId" value="g-1001" />
-        </div>
-      </div>
-      <div class="panel row-3">
-        <div>
-          <label>Message ID</label>
-          <input id="messageId" value="" placeholder="默认自动生成" />
-        </div>
-        <div>
-          <label>文件上传（支持多选）</label>
-          <input id="fileInput" type="file" multiple />
-        </div>
-        <div>
-          <label>或填远程文件 URL（可选）</label>
-          <input id="mediaUrl" placeholder="https://example.com/photo.png" />
-        </div>
-      </div>
-      <div class="panel">
-        <label>Text</label>
-        <textarea id="text">请介绍一下你自己，并分三段回答。</textarea>
-        <button class="btn" id="sendBtn">Send inbound_message</button>
-      </div>
-      <div class="panel">
-        <div id="status">Connecting to ws://127.0.0.1:9001 ...</div>
-        <div class="chat" id="chat"></div>
-        <div class="log" id="log"></div>
-      </div>
-    </div>
-    <script>
-      const ws = new WebSocket("ws://127.0.0.1:9001/?role=ui");
-      const log = document.getElementById("log");
-      const chat = document.getElementById("chat");
-      const status = document.getElementById("status");
-      const streamMap = new Map();
-      const append = (line) => {
-        const now = new Date().toISOString();
-        log.textContent += `[${now}] ${line}\n`;
-        log.scrollTop = log.scrollHeight;
-      };
-      const addUserMessage = (payload) => {
-        const div = document.createElement("div");
-        div.className = "msg user";
-        div.textContent = payload.text || "(empty text)";
-        const meta = document.createElement("div");
-        meta.className = "meta";
-        meta.textContent = `account=${payload.accountId} | ${payload.chatType}:${payload.chatType === "group" ? payload.groupId : payload.userId} | files=${payload.files?.length || 0}`;
-        div.appendChild(meta);
-        chat.appendChild(div);
-        chat.scrollTop = chat.scrollHeight;
-      };
-      const addAssistantMessage = (payload) => {
-        const div = document.createElement("div");
-        div.className = "msg assistant";
-        const text = payload.text || "(no text)";
-        div.textContent = text;
-        if (payload.mediaUrl) {
-          const preview = document.createElement("div");
-          preview.className = "preview";
-          const link = document.createElement("a");
-          link.href = payload.mediaUrl;
-          link.target = "_blank";
-          link.rel = "noreferrer";
-          link.textContent = `media: ${payload.mediaUrl}`;
-          link.style.color = "#9bc4ff";
-          preview.appendChild(link);
-          div.appendChild(preview);
-        }
-        chat.appendChild(div);
-        chat.scrollTop = chat.scrollHeight;
-      };
-      const upsertAssistantStream = (payload) => {
-        const key = payload.streamId || `stream-${Date.now()}`;
-        let node = streamMap.get(key);
-        if (!node) {
-          node = document.createElement("div");
-          node.className = "msg assistant";
-          node.textContent = "";
-          chat.appendChild(node);
-          streamMap.set(key, node);
-        }
-        node.textContent = payload.fullText || node.textContent + (payload.delta || "");
-        if (payload.done) {
-          node.classList.add("done");
-          const meta = document.createElement("div");
-          meta.className = "meta";
-          meta.textContent = `stream done | mode=${payload.mode || "chunk"}`;
-          node.appendChild(meta);
-        }
-        chat.scrollTop = chat.scrollHeight;
-      };
-      ws.addEventListener("open", () => {
-        status.textContent = "Connected";
-        append("connected");
-      });
-      ws.addEventListener("close", () => {
-        status.textContent = "Disconnected";
-        append("disconnected");
-      });
-      ws.addEventListener("message", (ev) => {
-        append(`recv: ${ev.data}`);
-        try {
-          const data = JSON.parse(ev.data);
-          const payload = data?.payload || data;
-          if (payload?.type === "stream_chunk") {
-            upsertAssistantStream(payload);
-          }
-          if (payload?.type === "outbound_message") {
-            addAssistantMessage(payload);
-          }
-        } catch {}
-      });
-
-      async function fileToBase64(file) {
-        const buf = await file.arrayBuffer();
-        let binary = "";
-        const bytes = new Uint8Array(buf);
-        const chunkSize = 0x8000;
-        for (let i = 0; i < bytes.length; i += chunkSize) {
-          binary += String.fromCharCode(...bytes.subarray(i, i + chunkSize));
-        }
-        return btoa(binary);
-      }
-
-      document.getElementById("sendBtn").addEventListener("click", async () => {
-        const fileInput = document.getElementById("fileInput");
-        const files = [];
-        for (const file of Array.from(fileInput.files || [])) {
-          files.push({
-            name: file.name,
-            type: file.type || "application/octet-stream",
-            base64: await fileToBase64(file),
-          });
-        }
-        const mediaUrl = document.getElementById("mediaUrl").value || "";
-        if (mediaUrl.trim()) {
-          files.push({
-            name: undefined,
-            type: undefined,
-            url: mediaUrl.trim(),
-          });
-        }
-
-        const payload = {
-          type: "inbound_message",
-          accountId: document.getElementById("accountId").value || "xkx",
-          chatType: document.getElementById("chatType").value === "group" ? "group" : "direct",
-          userId: document.getElementById("userId").value || "u-1001",
-          groupId: document.getElementById("groupId").value || undefined,
-          messageId: document.getElementById("messageId").value || `m-${Date.now()}`,
-          text: document.getElementById("text").value || "",
-          files: files.length > 0 ? files : undefined,
-        };
-        if (payload.chatType === "direct") {
-          delete payload.groupId;
-        }
-        addUserMessage(payload);
-        ws.send(JSON.stringify(payload));
-        append(`send: ${JSON.stringify({ ...payload, files: payload.files ? `[${payload.files.length} file(s)]` : undefined })}`);
-      });
-    </script>
-  </body>
-</html>

package/test/server.mjs

@@ -1,143 +0,0 @@
-import http from "node:http";
-import { readFile } from "node:fs/promises";
-import { WebSocketServer } from "ws";
-
-const HTTP_PORT = Number(process.env.DDCHAT_MOCK_HTTP_PORT ?? 9020);
-const WS_PORT = Number(process.env.DDCHAT_MOCK_WS_PORT ?? 9001);
-
-const clients = new Set();
-const uiClients = new Set();
-let pluginClient = null;
-const history = [];
-
-const server = http.createServer(async (req, res) => {
-  if (!req.url || req.url === "/") {
-    try {
-      const html = await readFile(new URL("./chat.html", import.meta.url), "utf-8");
-      res.statusCode = 200;
-      res.setHeader("Content-Type", "text/html; charset=utf-8");
-      res.end(html);
-      return;
-    } catch (error) {
-      res.statusCode = 500;
-      res.end(String(error));
-      return;
-    }
-  }
-  if (req.url === "/history") {
-    res.statusCode = 200;
-    res.setHeader("Content-Type", "application/json; charset=utf-8");
-    res.end(JSON.stringify(history.slice(-300)));
-    return;
-  }
-  res.statusCode = 404;
-  res.end("not found");
-});
-
-server.listen(HTTP_PORT, () => {
-  console.log(`[ddchat-mock] ui: http://127.0.0.1:${HTTP_PORT}`);
-});
-
-const wss = new WebSocketServer({ port: WS_PORT });
-wss.on("connection", (ws, req) => {
-  clients.add(ws);
-  const role = new URL(req.url ?? "/", "http://localhost").searchParams.get("role");
-  const isUi = role === "ui";
-  if (isUi) {
-    uiClients.add(ws);
-    console.log("[ddchat-mock] ui connected");
-  } else {
-    pluginClient = ws;
-    console.log("[ddchat-mock] ddchat plugin connected");
-  }
-  ws.send(
-    JSON.stringify({
-      type: "hello",
-      role: "ddchat-mock",
-      ts: Date.now(),
-      peerRole: isUi ? "ui" : "plugin",
-    }),
-  );
-  ws.on("close", () => {
-    clients.delete(ws);
-    uiClients.delete(ws);
-    if (pluginClient === ws) {
-      pluginClient = null;
-      console.log("[ddchat-mock] ddchat plugin disconnected");
-    }
-  });
-  ws.on("message", (buf) => {
-    const text = buf.toString("utf-8");
-    let payload;
-    try {
-      payload = JSON.parse(text);
-    } catch {
-      payload = { type: "raw", text };
-    }
-    if (uiClients.has(ws)) {
-      history.push({ direction: "to_plugin", payload, ts: Date.now() });
-      if (pluginClient && pluginClient.readyState === 1) {
-        pluginClient.send(JSON.stringify(payload));
-      }
-      broadcastToUi({
-        type: "event",
-        event: "to_plugin",
-        payload,
-        ts: Date.now(),
-      });
-      return;
-    }
-    history.push({ direction: "from_plugin", payload, ts: Date.now() });
-    broadcastToUi({
-      type: "event",
-      event: "from_plugin",
-      payload,
-      ts: Date.now(),
-    });
-  });
-});
-
-console.log(`[ddchat-mock] websocket: ws://127.0.0.1:${WS_PORT}`);
-
-function broadcastToUi(data) {
-  const text = JSON.stringify(data);
-  for (const ws of uiClients) {
-    try {
-      ws.send(text);
-    } catch {}
-  }
-}
-
-process.stdin.setEncoding("utf-8");
-process.stdin.on("data", (chunk) => {
-  const text = chunk.trim();
-  if (!text) return;
-  if (text === "help") {
-    console.log(
-      'stdin example: {"accountId":"xkx","chatType":"direct","userId":"u-1001","messageId":"m-1","text":"hello"}',
-    );
-    return;
-  }
-  try {
-    const payload = JSON.parse(text);
-    const message = {
-      type: "inbound_message",
-      accountId: payload.accountId ?? "xkx",
-      messageId: payload.messageId ?? `m-${Date.now()}`,
-      chatType: payload.chatType === "group" ? "group" : "direct",
-      userId: payload.userId ?? "u-1001",
-      groupId: payload.groupId,
-      text: payload.text ?? "",
-      files: Array.isArray(payload.files) ? payload.files : undefined,
-      ts: Date.now(),
-    };
-    history.push({ direction: "to_plugin", payload: message, ts: Date.now() });
-    broadcastToUi({ type: "event", event: "to_plugin", payload: message, ts: Date.now() });
-    if (pluginClient && pluginClient.readyState === 1) {
-      pluginClient.send(JSON.stringify(message));
-    }
-    console.log("[ddchat-mock] sent inbound_message");
-  } catch (error) {
-    console.error("[ddchat-mock] invalid json:", error);
-  }
-});