ddchat 0.2.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/src/inbound.ts DELETED
@@ -1,394 +0,0 @@
1
- import type { IncomingMessage } from "node:http";
2
- import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
3
- import { DDCHAT_CHANNEL_ID } from "./constants.js";
4
- import { resolveDdchatOutboundMediaFields } from "./outbound.js";
5
- import { getDdchatState } from "./runtime.js";
6
- import { resolveDdchatAccount } from "./types.js";
7
-
8
- type InboundReq = IncomingMessage & { body?: unknown; rawBody?: unknown };
9
-
10
- type DdchatInboundFile = {
11
- name?: string;
12
- type?: string;
13
- mimeType?: string;
14
- base64?: string;
15
- url?: string;
16
- };
17
-
18
- type DdchatInboundPayload = {
19
- accountId?: string;
20
- messageId?: string;
21
- chatType?: "direct" | "group";
22
- userId?: string;
23
- groupId?: string;
24
- text?: string;
25
- files?: DdchatInboundFile[];
26
- // legacy compatibility fields
27
- mediaUrl?: string;
28
- mediaType?: string;
29
- mediaName?: string;
30
- type?: "text" | "image" | "file" | "audio";
31
- };
32
-
33
- function parseBodyLike(raw: unknown): DdchatInboundPayload {
34
- if (!raw) {
35
- return {};
36
- }
37
- if (typeof raw === "object" && !Buffer.isBuffer(raw)) {
38
- return raw as DdchatInboundPayload;
39
- }
40
- const text = Buffer.isBuffer(raw) ? raw.toString("utf-8") : String(raw);
41
- if (!text.trim()) {
42
- return {};
43
- }
44
- try {
45
- const parsed = JSON.parse(text);
46
- return typeof parsed === "object" && parsed ? (parsed as DdchatInboundPayload) : {};
47
- } catch {
48
- return {};
49
- }
50
- }
51
-
52
- async function readRawBodyFromStream(req: IncomingMessage): Promise<string> {
53
- const chunks: Buffer[] = [];
54
- for await (const chunk of req) {
55
- chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
56
- }
57
- return Buffer.concat(chunks).toString("utf-8");
58
- }
59
-
60
- async function readBody(req: InboundReq): Promise<DdchatInboundPayload> {
61
- const direct = req.rawBody ?? req.body;
62
- if (direct !== undefined) {
63
- return parseBodyLike(direct);
64
- }
65
- const rawText = await readRawBodyFromStream(req);
66
- return parseBodyLike(rawText);
67
- }
68
-
69
- function resolveMediaFetchMaxBytes(
70
- cfg: ReturnType<OpenClawPluginApi["runtime"]["config"]["loadConfig"]>,
71
- ): number | undefined {
72
- const mb = cfg.agents?.defaults?.mediaMaxMb;
73
- if (!mb || mb <= 0) {
74
- return undefined;
75
- }
76
- return mb * 1024 * 1024;
77
- }
78
-
79
- function resolveInboundIdentity(body: DdchatInboundPayload): {
80
- messageId: string;
81
- chatType: "direct" | "group";
82
- userId: string;
83
- groupId?: string;
84
- } {
85
- const messageId = String(body.messageId ?? "").trim();
86
- const chatType = body.chatType === "group" ? "group" : "direct";
87
- const userId = String(body.userId ?? "").trim();
88
- const groupId = String(body.groupId ?? "").trim();
89
- if (!messageId) {
90
- throw new Error("missing messageId");
91
- }
92
- if (!userId) {
93
- throw new Error("missing userId");
94
- }
95
- if (chatType === "group" && !groupId) {
96
- throw new Error("missing groupId for group chatType");
97
- }
98
- return {
99
- messageId,
100
- chatType,
101
- userId,
102
- groupId: groupId || undefined,
103
- };
104
- }
105
-
106
- function toInboundFiles(body: DdchatInboundPayload): DdchatInboundFile[] {
107
- if (Array.isArray(body.files) && body.files.length > 0) {
108
- return body.files;
109
- }
110
- if (body.mediaUrl) {
111
- return [
112
- {
113
- name: body.mediaName,
114
- type: body.mediaType,
115
- url: body.mediaUrl,
116
- },
117
- ];
118
- }
119
- return [];
120
- }
121
-
122
- async function resolveInboundMedia(params: {
123
- channelRuntime: OpenClawPluginApi["runtime"]["channel"];
124
- cfg: ReturnType<OpenClawPluginApi["runtime"]["config"]["loadConfig"]>;
125
- files: DdchatInboundFile[];
126
- logInfo?: (message: string) => void;
127
- }): Promise<Array<{ path: string; contentType?: string }>> {
128
- const out: Array<{ path: string; contentType?: string }> = [];
129
- const maxBytes = resolveMediaFetchMaxBytes(params.cfg);
130
-
131
- for (const file of params.files) {
132
- const name = typeof file.name === "string" ? file.name : undefined;
133
- const mediaType =
134
- (typeof file.type === "string" && file.type.trim()) ||
135
- (typeof file.mimeType === "string" && file.mimeType.trim()) ||
136
- undefined;
137
- const base64 = typeof file.base64 === "string" ? file.base64.trim() : "";
138
- const url = typeof file.url === "string" ? file.url.trim() : "";
139
- try {
140
- let buffer: Buffer;
141
- let contentType = mediaType;
142
- if (base64) {
143
- buffer = Buffer.from(base64, "base64");
144
- } else if (url) {
145
- const fetched = await params.channelRuntime.media.fetchRemoteMedia({
146
- url,
147
- maxBytes,
148
- });
149
- buffer = fetched.buffer;
150
- contentType = fetched.contentType ?? contentType;
151
- } else {
152
- continue;
153
- }
154
- const saved = await params.channelRuntime.media.saveMediaBuffer(
155
- buffer,
156
- contentType,
157
- "inbound/ddchat",
158
- maxBytes,
159
- name,
160
- );
161
- out.push({
162
- path: saved.path,
163
- contentType: saved.contentType ?? contentType,
164
- });
165
- } catch (error) {
166
- params.logInfo?.(`ddchat media parse failed: ${String(error)}`);
167
- }
168
- }
169
- return out;
170
- }
171
-
172
- function inferBodyFromMedia(mediaList: Array<{ contentType?: string }>): string {
173
- const firstType = mediaList[0]?.contentType;
174
- if (!firstType) {
175
- return "<media:file>";
176
- }
177
- if (firstType.startsWith("image/")) {
178
- return "<media:image>";
179
- }
180
- if (firstType.startsWith("audio/")) {
181
- return "<media:audio>";
182
- }
183
- if (firstType.startsWith("video/")) {
184
- return "<media:video>";
185
- }
186
- return "<media:file>";
187
- }
188
-
189
- function buildLocalAgentMediaPayload(
190
- mediaList: Array<{ path: string; contentType?: string }>,
191
- ): {
192
- MediaPath?: string;
193
- MediaType?: string;
194
- MediaUrl?: string;
195
- MediaPaths?: string[];
196
- MediaUrls?: string[];
197
- MediaTypes?: string[];
198
- } {
199
- const first = mediaList[0];
200
- const mediaPaths = mediaList.map((media) => media.path);
201
- const mediaTypes = mediaList.map((media) => media.contentType).filter(Boolean) as string[];
202
- return {
203
- MediaPath: first?.path,
204
- MediaType: first?.contentType ?? undefined,
205
- MediaUrl: first?.path,
206
- MediaPaths: mediaPaths.length > 0 ? mediaPaths : undefined,
207
- MediaUrls: mediaPaths.length > 0 ? mediaPaths : undefined,
208
- MediaTypes: mediaTypes.length > 0 ? mediaTypes : undefined,
209
- };
210
- }
211
-
212
- export function registerDdchatWebhook(api: OpenClawPluginApi): void {
213
- api.registerHttpRoute({
214
- path: "/ddchat/webhook",
215
- auth: "plugin",
216
- handler: async (req, res) => {
217
- try {
218
- const body = await readBody(req as InboundReq);
219
- const result = await processDdchatInboundWithChannelRuntime({
220
- channelRuntime: api.runtime.channel,
221
- cfg: api.runtime.config.loadConfig(),
222
- body,
223
- source: "webhook",
224
- logInfo: (message) =>
225
- api.runtime.logging.getChildLogger({ module: "ddchat-inbound" }).info(message),
226
- });
227
- res.statusCode = 200;
228
- res.setHeader("Content-Type", "application/json; charset=utf-8");
229
- res.end(JSON.stringify(result));
230
- } catch (error) {
231
- res.statusCode = 400;
232
- res.setHeader("Content-Type", "text/plain; charset=utf-8");
233
- res.end(error instanceof Error ? error.message : "invalid request");
234
- }
235
- return true;
236
- },
237
- });
238
- }
239
-
240
- export async function processDdchatInboundWithChannelRuntime(params: {
241
- channelRuntime: OpenClawPluginApi["runtime"]["channel"];
242
- cfg: ReturnType<OpenClawPluginApi["runtime"]["config"]["loadConfig"]>;
243
- body: unknown;
244
- fallbackAccountId?: string;
245
- source?: "webhook" | "ws";
246
- logInfo?: (message: string) => void;
247
- }): Promise<
248
- | { ok: true; duplicate: true; messageId: string; accountId: string }
249
- | { ok: true; sessionKey: string; agentId: string; deliveredCount: number; delivered: Array<{ messageId?: string; text?: string }> }
250
- > {
251
- const body = parseBodyLike(params.body);
252
- const accountId = String(body.accountId ?? params.fallbackAccountId ?? "default").trim() || "default";
253
- const account = resolveDdchatAccount(params.cfg, accountId);
254
- const identity = resolveInboundIdentity(body);
255
-
256
- if (getDdchatState().dedupe.isDuplicate(account.accountId, identity.messageId)) {
257
- return {
258
- ok: true,
259
- duplicate: true,
260
- messageId: identity.messageId,
261
- accountId: account.accountId,
262
- };
263
- }
264
-
265
- const peer = identity.chatType === "group"
266
- ? { kind: "group" as const, id: identity.groupId! }
267
- : { kind: "direct" as const, id: identity.userId };
268
- const route = params.channelRuntime.routing.resolveAgentRoute({
269
- cfg: params.cfg,
270
- channel: DDCHAT_CHANNEL_ID,
271
- accountId: account.accountId,
272
- peer,
273
- });
274
-
275
- const mediaList = await resolveInboundMedia({
276
- channelRuntime: params.channelRuntime,
277
- cfg: params.cfg,
278
- files: toInboundFiles(body),
279
- logInfo: params.logInfo,
280
- });
281
- const mediaPayload = buildLocalAgentMediaPayload(mediaList);
282
- const inboundText = typeof body.text === "string" && body.text.trim()
283
- ? body.text.trim()
284
- : mediaList.length > 0
285
- ? inferBodyFromMedia(mediaList)
286
- : "";
287
- if (!inboundText) {
288
- throw new Error("missing text/files");
289
- }
290
-
291
- const timestamp = Date.now();
292
- const from = `ddchat:${identity.userId}`;
293
- const to = identity.chatType === "group" ? `group:${identity.groupId}` : `user:${identity.userId}`;
294
- const ctxPayload = params.channelRuntime.reply.finalizeInboundContext({
295
- Body: inboundText,
296
- BodyForAgent: inboundText,
297
- RawBody: inboundText,
298
- CommandBody: inboundText,
299
- From: from,
300
- To: to,
301
- SessionKey: route.sessionKey,
302
- AccountId: route.accountId,
303
- ChatType: identity.chatType,
304
- GroupSubject: identity.chatType === "group" ? identity.groupId : undefined,
305
- SenderId: identity.userId,
306
- MessageSid: identity.messageId,
307
- Timestamp: timestamp,
308
- Provider: DDCHAT_CHANNEL_ID,
309
- Surface: DDCHAT_CHANNEL_ID,
310
- OriginatingChannel: DDCHAT_CHANNEL_ID,
311
- OriginatingTo: to,
312
- CommandAuthorized: true,
313
- ...mediaPayload,
314
- });
315
-
316
- const delivered: Array<{ messageId?: string; text?: string }> = [];
317
- const streamId = `ddchat-stream-${identity.messageId}`;
318
- let streamText = "";
319
- const streamMode = account.streamingMode;
320
- const emitStream = (patch: { delta?: string; done: boolean }) => {
321
- getDdchatState().wsSend?.({
322
- type: "stream_chunk",
323
- streamId,
324
- accountId: account.accountId,
325
- source: params.source ?? "ws",
326
- sessionKey: route.sessionKey,
327
- agentId: route.agentId,
328
- mode: streamMode,
329
- delta: patch.delta ?? "",
330
- fullText: streamText,
331
- done: patch.done,
332
- from: "plugin",
333
- ts: Date.now(),
334
- });
335
- };
336
-
337
- await params.channelRuntime.reply.dispatchReplyWithBufferedBlockDispatcher({
338
- ctx: ctxPayload,
339
- cfg: params.cfg,
340
- dispatcherOptions: {
341
- deliver: async (payload: {
342
- text?: string;
343
- body?: string;
344
- mediaUrl?: string;
345
- mediaUrls?: string[];
346
- }) => {
347
- const text = payload.text ?? payload.body ?? "";
348
- const mediaUrl = payload.mediaUrl?.trim() || payload.mediaUrls?.find((u) => u?.trim())?.trim();
349
- if (!text && !mediaUrl) {
350
- return;
351
- }
352
- const mediaFields = mediaUrl
353
- ? await resolveDdchatOutboundMediaFields(params.cfg, mediaUrl)
354
- : {};
355
- const outbound = {
356
- type: "outbound_message",
357
- from: "plugin",
358
- channel: DDCHAT_CHANNEL_ID,
359
- accountId: account.accountId,
360
- targetType: identity.chatType,
361
- targetId: identity.chatType === "group" ? identity.groupId : identity.userId,
362
- text,
363
- mediaUrl,
364
- ...mediaFields,
365
- };
366
- let sent = false;
367
- if (!account.streaming || !text) {
368
- sent = getDdchatState().wsSend?.(outbound) ?? false;
369
- }
370
- delivered.push({
371
- messageId: `ddchat-out-${Date.now()}`,
372
- text,
373
- });
374
- if (account.streaming && text) {
375
- streamText += text;
376
- emitStream({ delta: text, done: false });
377
- }
378
- },
379
- onReplyStart: () => {
380
- params.logInfo?.("ddchat agent reply started");
381
- },
382
- },
383
- });
384
- if (account.streaming) {
385
- emitStream({ done: true });
386
- }
387
- return {
388
- ok: true,
389
- sessionKey: route.sessionKey,
390
- agentId: route.agentId,
391
- deliveredCount: delivered.length,
392
- delivered,
393
- };
394
- }
package/src/outbound.ts DELETED
@@ -1,183 +0,0 @@
1
- import { loadWebMedia } from "openclaw/plugin-sdk/web-media";
2
- import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
3
- import { DDCHAT_CHANNEL_ID } from "./constants.js";
4
- import { getDdchatState } from "./runtime.js";
5
- import { pathToFileURL } from "url";
6
-
7
- function resolveMediaMaxBytes(cfg: OpenClawConfig): number | undefined {
8
- const mb = cfg.agents?.defaults?.mediaMaxMb;
9
- if (!mb || mb <= 0) {
10
- return undefined;
11
- }
12
- return mb * 1024 * 1024;
13
- }
14
-
15
- /** Check if URL is a local file path */
16
- function isLocalFilePath(url: string): boolean {
17
- if (url.startsWith("file://")) return true;
18
- if (/^[a-zA-Z]:[\\/]/.test(url)) return true; // Windows path
19
- if (url.startsWith("/") && !url.startsWith("//")) return true; // Unix absolute path
20
- return false;
21
- }
22
-
23
- /** Convert local path to file:// URL */
24
- function toFileUrl(path: string): string {
25
- if (path.startsWith("file://")) return path;
26
- return pathToFileURL(path).href;
27
- }
28
-
29
- /** Load media for WS outbound; same limits as sendMedia. URL-only fallback on failure. */
30
- export async function resolveDdchatOutboundMediaFields(
31
- cfg: OpenClawConfig,
32
- mediaUrl: string,
33
- ): Promise<{ mediaBase64?: string; mediaType?: string; mediaName?: string; error?: string }> {
34
- try {
35
- // Handle local file paths
36
- let resolvedUrl = mediaUrl;
37
- if (isLocalFilePath(mediaUrl)) {
38
- resolvedUrl = toFileUrl(mediaUrl);
39
- }
40
- console.log(`[ddchat] Resolved media URL: ${resolvedUrl}`);
41
-
42
- const media = await loadWebMedia(resolvedUrl, {
43
- maxBytes: resolveMediaMaxBytes(cfg),
44
- });
45
- console.log(`[ddchat] Media loaded successfully: ${media.fileName}, type: ${media.contentType}, size: ${media.buffer.length}`);
46
- return {
47
- mediaBase64: media.buffer.toString("base64"),
48
- mediaType: media.contentType,
49
- mediaName: media.fileName,
50
- };
51
- } catch (error) {
52
- const errorMsg = error instanceof Error ? error.message : String(error);
53
- console.error(`[ddchat] Failed to load media from ${mediaUrl}: ${errorMsg}`);
54
- return { error: errorMsg };
55
- }
56
- }
57
-
58
- function resolveTarget(to: string): { targetType: "group" | "direct"; targetId: string } {
59
- const normalized = to.trim();
60
- if (normalized.startsWith("group:")) {
61
- return { targetType: "group", targetId: normalized.slice("group:".length) };
62
- }
63
- if (normalized.startsWith("chat:")) {
64
- return { targetType: "group", targetId: normalized.slice("chat:".length) };
65
- }
66
- if (normalized.startsWith("user:")) {
67
- return { targetType: "direct", targetId: normalized.slice("user:".length) };
68
- }
69
- return { targetType: "direct", targetId: normalized };
70
- }
71
-
72
- export const ddchatOutbound = {
73
- deliveryMode: "direct",
74
- textChunkLimit: 4000,
75
- chunkerMode: "markdown",
76
- sendText: async ({ to, text, accountId }) => {
77
- const messageId = `ddchat-text-${Date.now()}`;
78
- const target = resolveTarget(to);
79
-
80
- // Check WebSocket connection
81
- const state = getDdchatState();
82
- console.log(`[ddchat] sendText called - wsConnected: ${state.wsConnected}, wsSend available: ${!!state.wsSend}`);
83
-
84
- if (!state.wsSend || !state.wsConnected) {
85
- console.error(`[ddchat] WebSocket not connected, cannot send text message`);
86
- throw new Error("DDChat WebSocket not connected");
87
- }
88
-
89
- const payload = {
90
- type: "outbound_message",
91
- from: "plugin",
92
- channel: DDCHAT_CHANNEL_ID,
93
- accountId,
94
- messageId,
95
- targetType: target.targetType,
96
- targetId: target.targetId,
97
- text,
98
- };
99
- console.log(`[ddchat] Sending text payload:`, JSON.stringify(payload, null, 2));
100
- const sent = state.wsSend(payload);
101
- if (!sent) {
102
- throw new Error("Failed to send text message via WebSocket");
103
- }
104
- return {
105
- messageId,
106
- to,
107
- channel: DDCHAT_CHANNEL_ID,
108
- text,
109
- transport: "ws",
110
- };
111
- },
112
- sendMedia: async ({ cfg, to, text, mediaUrl, accountId }) => {
113
- const messageId = `ddchat-media-${Date.now()}`;
114
- const target = resolveTarget(to);
115
-
116
- // Check WebSocket connection
117
- const state = getDdchatState();
118
- console.log(`[ddchat] sendMedia called - wsConnected: ${state.wsConnected}, wsSend available: ${!!state.wsSend}`);
119
-
120
- if (!state.wsSend || !state.wsConnected) {
121
- console.error(`[ddchat] WebSocket not connected, cannot send media`);
122
- throw new Error("DDChat WebSocket not connected");
123
- }
124
-
125
- // Load media
126
- console.log(`[ddchat] Loading media from: ${mediaUrl}`);
127
- const { mediaBase64, mediaType, mediaName, error } = await resolveDdchatOutboundMediaFields(
128
- cfg,
129
- mediaUrl,
130
- );
131
-
132
- if (error) {
133
- console.error(`[ddchat] Media loading failed: ${error}`);
134
- throw new Error(`Failed to load media: ${error}`);
135
- }
136
-
137
- // Validate media data
138
- if (!mediaBase64) {
139
- console.error(`[ddchat] No media data available for ${mediaUrl}`);
140
- throw new Error("No media data available");
141
- }
142
-
143
- const payload = {
144
- type: "outbound_message",
145
- from: "plugin",
146
- channel: DDCHAT_CHANNEL_ID,
147
- accountId,
148
- messageId,
149
- targetType: target.targetType,
150
- targetId: target.targetId,
151
- text,
152
- mediaUrl,
153
- mediaBase64,
154
- mediaType,
155
- mediaName,
156
- };
157
-
158
- console.log(`[ddchat] Sending media message:`, {
159
- messageId,
160
- targetType: target.targetType,
161
- targetId: target.targetId,
162
- mediaType,
163
- mediaName,
164
- mediaSize: mediaBase64?.length,
165
- });
166
-
167
- const sent = state.wsSend(payload);
168
- if (!sent) {
169
- throw new Error("Failed to send media message via WebSocket");
170
- }
171
-
172
- return {
173
- messageId,
174
- to,
175
- channel: DDCHAT_CHANNEL_ID,
176
- text,
177
- mediaUrl,
178
- mediaType,
179
- mediaName,
180
- transport: "ws",
181
- };
182
- },
183
- };
package/src/pairing.ts DELETED
@@ -1,9 +0,0 @@
1
- import { createPairingPrefixStripper } from "openclaw/plugin-sdk/channel-pairing";
2
-
3
- export const ddchatPairing = {
4
- idLabel: "ddchatUserId",
5
- normalizeAllowEntry: createPairingPrefixStripper(/^(ddchat|user):/i),
6
- notifyApproval: async ({ runtime, id }) => {
7
- runtime?.log?.(`[ddchat] pairing approved for ${id}`);
8
- },
9
- };
package/src/runtime.ts DELETED
@@ -1,27 +0,0 @@
1
- import { DdchatDedupeStore } from "./dedupe.js";
2
-
3
- export type DdchatPluginRuntimeState = {
4
- dedupe: DdchatDedupeStore;
5
- wsSend?: (payload: Record<string, unknown>) => boolean;
6
- wsConnected: boolean;
7
- };
8
-
9
- const state: DdchatPluginRuntimeState = {
10
- dedupe: new DdchatDedupeStore(),
11
- wsConnected: false,
12
- };
13
-
14
- export function getDdchatState(): DdchatPluginRuntimeState {
15
- // console.log(`[ddchat] getDdchatState called - wsConnected: ${state.wsConnected}, wsSend available: ${!!state.wsSend}`);
16
- return state;
17
- }
18
-
19
- export function setDdchatWsRuntime(params: {
20
- send?: (payload: Record<string, unknown>) => boolean;
21
- connected: boolean;
22
- }): void {
23
- // console.log(`[ddchat] setDdchatWsRuntime called - connected: ${params.connected}, send available: ${!!params.send}`);
24
- state.wsSend = params.send;
25
- state.wsConnected = params.connected;
26
- // console.log(`[ddchat] State updated - wsConnected: ${state.wsConnected}, wsSend available: ${!!state.wsSend}`);
27
- }
package/src/session.ts DELETED
@@ -1,19 +0,0 @@
1
- export function buildDdchatSessionKey(params: {
2
- peerKind: "direct" | "group";
3
- peerId: string;
4
- senderId?: string;
5
- threadId?: string | null;
6
- }): string {
7
- const base =
8
- params.peerKind === "group"
9
- ? `ddchat:group:${params.peerId}`
10
- : `ddchat:direct:${params.peerId}`;
11
- const thread = params.threadId?.trim();
12
- if (!thread) {
13
- return base;
14
- }
15
- if (params.peerKind === "group" && params.senderId) {
16
- return `${base}:thread:${thread}:sender:${params.senderId}`;
17
- }
18
- return `${base}:thread:${thread}`;
19
- }