ddchat 0.2.0 → 0.3.0

package/src/types.ts

@@ -1,126 +1,136 @@
-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>;
-};
-
-function toStringList(input: Array<string | number> | undefined): string[] {
-  if (!input) {
-    return [];
-  }
-  return input.map((entry) => String(entry).trim()).filter(Boolean);
-}
-
-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:
-      typeof merged.webhookPath === "string" && merged.webhookPath.trim()
-        ? merged.webhookPath.trim()
-        : "/ddchat/webhook",
-    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),
-  };
-}
+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 +1,3 @@
-# BLOCKERS
-
-- None currently.
+# BLOCKERS
+
+- None currently.

package/task/DOING.md

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

package/task/DONE.md

@@ -1,8 +1,8 @@
-# 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
+# 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 +1,17 @@
-# 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.
+# 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 +1,10 @@
-# 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
+# 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 +1,48 @@
-# 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.
+# 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.