ddchat 0.4.1 → 0.4.3

package/src/inbound.js

@@ -1,363 +1,363 @@
-import { randomUUID } from "node:crypto";
-import { DDCHAT_CHANNEL_ID } from "./constants.js";
-import { resolveDdchatOutboundMediaFields } from "./outbound.js";
-import { getDdchatState, getDdchatWsRuntime } from "./runtime.js";
-import { listDdchatAccountIds, resolveDdchatAccount, resolveDdchatMediaMaxBytes } from "./types.js";
-const DEFAULT_WEBHOOK_BODY_MAX_BYTES = 10 * 1024 * 1024;
-function parseBodyLike(raw) {
-    if (!raw) {
-        return {};
-    }
-    if (typeof raw === "object" && !Buffer.isBuffer(raw)) {
-        return raw;
-    }
-    const text = Buffer.isBuffer(raw) ? raw.toString("utf-8") : String(raw);
-    if (!text.trim()) {
-        return {};
-    }
-    try {
-        const parsed = JSON.parse(text);
-        return typeof parsed === "object" && parsed ? parsed : {};
-    }
-    catch {
-        return {};
-    }
-}
-async function readRawBodyFromStream(req, maxBytes) {
-    const chunks = [];
-    let totalBytes = 0;
-    for await (const chunk of req) {
-        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
-        totalBytes += buffer.length;
-        if (totalBytes > maxBytes) {
-            throw new Error("webhook body too large");
-        }
-        chunks.push(buffer);
-    }
-    return Buffer.concat(chunks).toString("utf-8");
-}
-async function readBody(req, maxBytes = DEFAULT_WEBHOOK_BODY_MAX_BYTES) {
-    const direct = req.rawBody ?? req.body;
-    if (direct !== undefined) {
-        if (Buffer.isBuffer(direct) && direct.length > maxBytes) {
-            throw new Error("webhook body too large");
-        }
-        if (typeof direct === "string" && Buffer.byteLength(direct, "utf-8") > maxBytes) {
-            throw new Error("webhook body too large");
-        }
-        return parseBodyLike(direct);
-    }
-    const rawText = await readRawBodyFromStream(req, maxBytes);
-    return parseBodyLike(rawText);
-}
-function resolveInboundIdentity(body) {
-    const messageId = String(body.messageId ?? "").trim();
-    const chatType = body.chatType === "group" ? "group" : "direct";
-    const userId = String(body.userId ?? "").trim();
-    const groupId = String(body.groupId ?? "").trim();
-    if (!messageId) {
-        throw new Error("missing messageId");
-    }
-    if (!userId) {
-        throw new Error("missing userId");
-    }
-    if (chatType === "group" && !groupId) {
-        throw new Error("missing groupId for group chatType");
-    }
-    return {
-        messageId,
-        chatType,
-        userId,
-        groupId: groupId || undefined,
-    };
-}
-function createDdchatMessageId(prefix) {
-    return `${prefix}-${randomUUID()}`;
-}
-function estimateBase64DecodedBytes(input) {
-    const normalized = input.replace(/\s/g, "");
-    const padding = normalized.endsWith("==") ? 2 : normalized.endsWith("=") ? 1 : 0;
-    return Math.floor((normalized.length * 3) / 4) - padding;
-}
-function toInboundFiles(body) {
-    if (Array.isArray(body.files) && body.files.length > 0) {
-        return body.files;
-    }
-    if (body.mediaUrl) {
-        return [
-            {
-                name: body.mediaName,
-                type: body.mediaType,
-                url: body.mediaUrl,
-            },
-        ];
-    }
-    return [];
-}
-async function resolveInboundMedia(params) {
-    const out = [];
-    const maxBytes = resolveDdchatMediaMaxBytes(params.cfg);
-    for (const file of params.files) {
-        const name = typeof file.name === "string" ? file.name : undefined;
-        const mediaType = (typeof file.type === "string" && file.type.trim()) ||
-            (typeof file.mimeType === "string" && file.mimeType.trim()) ||
-            undefined;
-        const base64 = typeof file.base64 === "string" ? file.base64.trim() : "";
-        const url = typeof file.url === "string" ? file.url.trim() : "";
-        try {
-            let buffer;
-            let contentType = mediaType;
-            if (base64) {
-                if (maxBytes && estimateBase64DecodedBytes(base64) > maxBytes) {
-                    throw new Error("media exceeds maximum size");
-                }
-                buffer = Buffer.from(base64, "base64");
-            }
-            else if (url) {
-                const fetched = await params.channelRuntime.media.fetchRemoteMedia({
-                    url,
-                    maxBytes,
-                });
-                buffer = fetched.buffer;
-                contentType = fetched.contentType ?? contentType;
-            }
-            else {
-                continue;
-            }
-            const saved = await params.channelRuntime.media.saveMediaBuffer(buffer, contentType, "inbound/ddchat", maxBytes, name);
-            out.push({
-                path: saved.path,
-                contentType: saved.contentType ?? contentType,
-            });
-        }
-        catch (error) {
-            params.logInfo?.(`ddchat media parse failed: ${String(error)}`);
-        }
-    }
-    return out;
-}
-function inferBodyFromMedia(mediaList) {
-    const firstType = mediaList[0]?.contentType;
-    if (!firstType) {
-        return "<media:file>";
-    }
-    if (firstType.startsWith("image/")) {
-        return "<media:image>";
-    }
-    if (firstType.startsWith("audio/")) {
-        return "<media:audio>";
-    }
-    if (firstType.startsWith("video/")) {
-        return "<media:video>";
-    }
-    return "<media:file>";
-}
-function buildLocalAgentMediaPayload(mediaList) {
-    const first = mediaList[0];
-    const mediaPaths = mediaList.map((media) => media.path);
-    const mediaTypes = mediaList.map((media) => media.contentType).filter(Boolean);
-    return {
-        MediaPath: first?.path,
-        MediaType: first?.contentType ?? undefined,
-        MediaUrl: first?.path,
-        MediaPaths: mediaPaths.length > 0 ? mediaPaths : undefined,
-        MediaUrls: mediaPaths.length > 0 ? mediaPaths : undefined,
-        MediaTypes: mediaTypes.length > 0 ? mediaTypes : undefined,
-    };
-}
-function collectWebhookRoutes(cfg) {
-    const byPath = new Map();
-    const add = (path, accountId) => {
-        const accounts = byPath.get(path) ?? new Set();
-        accounts.add(accountId);
-        byPath.set(path, accounts);
-    };
-    byPath.set("/ddchat/webhook", new Set());
-    for (const accountId of listDdchatAccountIds(cfg)) {
-        const account = resolveDdchatAccount(cfg, accountId);
-        add(account.webhookPath ?? "/ddchat/webhook", account.accountId);
-    }
-    return Array.from(byPath.entries()).map(([path, accounts]) => {
-        const accountIds = Array.from(accounts);
-        return {
-            path,
-            fallbackAccountId: accountIds.length === 1 ? accountIds[0] : undefined,
-        };
-    });
-}
-export function registerDdchatWebhook(api) {
-    const cfg = api.runtime.config.loadConfig();
-    for (const route of collectWebhookRoutes(cfg)) {
-        api.registerHttpRoute({
-            path: route.path,
-            auth: "plugin",
-            handler: async (req, res) => {
-                try {
-                    const currentCfg = api.runtime.config.loadConfig();
-                    const body = await readBody(req);
-                    const result = await processDdchatInboundWithChannelRuntime({
-                        channelRuntime: api.runtime.channel,
-                        cfg: currentCfg,
-                        body,
-                        fallbackAccountId: route.fallbackAccountId,
-                        source: "webhook",
-                        logInfo: (message) => api.runtime.logging.getChildLogger({ module: "ddchat-inbound" }).info(message),
-                    });
-                    res.statusCode = 200;
-                    res.setHeader("Content-Type", "application/json; charset=utf-8");
-                    res.end(JSON.stringify(result));
-                }
-                catch (error) {
-                    res.statusCode = 400;
-                    res.setHeader("Content-Type", "text/plain; charset=utf-8");
-                    res.end(error instanceof Error ? error.message : "invalid request");
-                }
-                return true;
-            },
-        });
-    }
-}
-export async function processDdchatInboundWithChannelRuntime(params) {
-    const body = parseBodyLike(params.body);
-    const accountId = String(body.accountId ?? params.fallbackAccountId ?? "default").trim() || "default";
-    const account = resolveDdchatAccount(params.cfg, accountId);
-    if (!account.enabled) {
-        throw new Error(`ddchat account '${account.accountId}' is disabled`);
-    }
-    const identity = resolveInboundIdentity(body);
-    if (getDdchatState().dedupe.isDuplicate(account.accountId, identity.messageId)) {
-        return {
-            ok: true,
-            duplicate: true,
-            messageId: identity.messageId,
-            accountId: account.accountId,
-        };
-    }
-    const peer = identity.chatType === "group"
-        ? { kind: "group", id: identity.groupId }
-        : { kind: "direct", id: identity.userId };
-    const route = params.channelRuntime.routing.resolveAgentRoute({
-        cfg: params.cfg,
-        channel: DDCHAT_CHANNEL_ID,
-        accountId: account.accountId,
-        peer,
-    });
-    const mediaList = await resolveInboundMedia({
-        channelRuntime: params.channelRuntime,
-        cfg: params.cfg,
-        files: toInboundFiles(body),
-        logInfo: params.logInfo,
-    });
-    const mediaPayload = buildLocalAgentMediaPayload(mediaList);
-    const inboundText = typeof body.text === "string" && body.text.trim()
-        ? body.text.trim()
-        : mediaList.length > 0
-            ? inferBodyFromMedia(mediaList)
-            : "";
-    if (!inboundText) {
-        throw new Error("missing text/files");
-    }
-    const timestamp = Date.now();
-    const from = `ddchat:${identity.userId}`;
-    const to = identity.chatType === "group" ? `group:${identity.groupId}` : `user:${identity.userId}`;
-    const ctxPayload = params.channelRuntime.reply.finalizeInboundContext({
-        Body: inboundText,
-        BodyForAgent: inboundText,
-        RawBody: inboundText,
-        CommandBody: inboundText,
-        From: from,
-        To: to,
-        SessionKey: route.sessionKey,
-        AccountId: route.accountId,
-        ChatType: identity.chatType,
-        GroupSubject: identity.chatType === "group" ? identity.groupId : undefined,
-        SenderId: identity.userId,
-        MessageSid: identity.messageId,
-        Timestamp: timestamp,
-        Provider: DDCHAT_CHANNEL_ID,
-        Surface: DDCHAT_CHANNEL_ID,
-        OriginatingChannel: DDCHAT_CHANNEL_ID,
-        OriginatingTo: to,
-        CommandAuthorized: true,
-        ...mediaPayload,
-    });
-    const delivered = [];
-    const streamId = `ddchat-stream-${identity.messageId}`;
-    let streamText = "";
-    const streamMode = account.streamingMode;
-    const emitStream = (patch) => {
-        const runtime = getDdchatWsRuntime(account.accountId);
-        const sent = runtime.send?.({
-            type: "stream_chunk",
-            streamId,
-            accountId: account.accountId,
-            source: params.source ?? "ws",
-            sessionKey: route.sessionKey,
-            agentId: route.agentId,
-            mode: streamMode,
-            delta: patch.delta ?? "",
-            fullText: streamText,
-            done: patch.done,
-            from: "claw",
-            ts: Date.now(),
-        }) ?? false;
-        if (!sent) {
-            params.logInfo?.(`ddchat stream send failed for account ${account.accountId}`);
-        }
-    };
-    await params.channelRuntime.reply.dispatchReplyWithBufferedBlockDispatcher({
-        ctx: ctxPayload,
-        cfg: params.cfg,
-        dispatcherOptions: {
-            deliver: async (payload) => {
-                const text = payload.text ?? payload.body ?? "";
-                const mediaUrl = payload.mediaUrl?.trim() || payload.mediaUrls?.find((u) => u?.trim())?.trim();
-                if (!text && !mediaUrl) {
-                    return;
-                }
-                const mediaFields = mediaUrl
-                    ? await resolveDdchatOutboundMediaFields(params.cfg, mediaUrl)
-                    : {};
-                const outbound = {
-                    type: "outbound_message",
-                    from: "claw",
-                    channel: DDCHAT_CHANNEL_ID,
-                    accountId: account.accountId,
-                    targetType: identity.chatType,
-                    targetId: identity.chatType === "group" ? identity.groupId : identity.userId,
-                    text,
-                    mediaUrl,
-                    ...mediaFields,
-                };
-                if (!account.streaming || !text) {
-                    const runtime = getDdchatWsRuntime(account.accountId);
-                    const sent = runtime.send?.(outbound) ?? false;
-                    if (!sent) {
-                        params.logInfo?.(`ddchat outbound send failed for account ${account.accountId}`);
-                    }
-                }
-                delivered.push({
-                    messageId: createDdchatMessageId("ddchat-out"),
-                    text,
-                });
-                if (account.streaming && text) {
-                    streamText += text;
-                    emitStream({ delta: text, done: false });
-                }
-            },
-            onReplyStart: () => {
-                params.logInfo?.("ddchat agent reply started");
-            },
-        },
-    });
-    if (account.streaming) {
-        emitStream({ done: true });
-    }
-    return {
-        ok: true,
-        sessionKey: route.sessionKey,
-        agentId: route.agentId,
-        deliveredCount: delivered.length,
-        delivered,
-    };
-}
+import { randomUUID } from "node:crypto";
+import { DDCHAT_CHANNEL_ID } from "./constants.js";
+import { resolveDdchatOutboundMediaFields } from "./outbound.js";
+import { getDdchatState, getDdchatWsRuntime } from "./runtime.js";
+import { listDdchatAccountIds, resolveDdchatAccount, resolveDdchatMediaMaxBytes } from "./types.js";
+const DEFAULT_WEBHOOK_BODY_MAX_BYTES = 10 * 1024 * 1024;
+function parseBodyLike(raw) {
+    if (!raw) {
+        return {};
+    }
+    if (typeof raw === "object" && !Buffer.isBuffer(raw)) {
+        return raw;
+    }
+    const text = Buffer.isBuffer(raw) ? raw.toString("utf-8") : String(raw);
+    if (!text.trim()) {
+        return {};
+    }
+    try {
+        const parsed = JSON.parse(text);
+        return typeof parsed === "object" && parsed ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+async function readRawBodyFromStream(req, maxBytes) {
+    const chunks = [];
+    let totalBytes = 0;
+    for await (const chunk of req) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        totalBytes += buffer.length;
+        if (totalBytes > maxBytes) {
+            throw new Error("webhook body too large");
+        }
+        chunks.push(buffer);
+    }
+    return Buffer.concat(chunks).toString("utf-8");
+}
+async function readBody(req, maxBytes = DEFAULT_WEBHOOK_BODY_MAX_BYTES) {
+    const direct = req.rawBody ?? req.body;
+    if (direct !== undefined) {
+        if (Buffer.isBuffer(direct) && direct.length > maxBytes) {
+            throw new Error("webhook body too large");
+        }
+        if (typeof direct === "string" && Buffer.byteLength(direct, "utf-8") > maxBytes) {
+            throw new Error("webhook body too large");
+        }
+        return parseBodyLike(direct);
+    }
+    const rawText = await readRawBodyFromStream(req, maxBytes);
+    return parseBodyLike(rawText);
+}
+function resolveInboundIdentity(body) {
+    const messageId = String(body.messageId ?? "").trim();
+    const chatType = body.chatType === "group" ? "group" : "direct";
+    const userId = String(body.userId ?? "").trim();
+    const groupId = String(body.groupId ?? "").trim();
+    if (!messageId) {
+        throw new Error("missing messageId");
+    }
+    if (!userId) {
+        throw new Error("missing userId");
+    }
+    if (chatType === "group" && !groupId) {
+        throw new Error("missing groupId for group chatType");
+    }
+    return {
+        messageId,
+        chatType,
+        userId,
+        groupId: groupId || undefined,
+    };
+}
+function createDdchatMessageId(prefix) {
+    return `${prefix}-${randomUUID()}`;
+}
+function estimateBase64DecodedBytes(input) {
+    const normalized = input.replace(/\s/g, "");
+    const padding = normalized.endsWith("==") ? 2 : normalized.endsWith("=") ? 1 : 0;
+    return Math.floor((normalized.length * 3) / 4) - padding;
+}
+function toInboundFiles(body) {
+    if (Array.isArray(body.files) && body.files.length > 0) {
+        return body.files;
+    }
+    if (body.mediaUrl) {
+        return [
+            {
+                name: body.mediaName,
+                type: body.mediaType,
+                url: body.mediaUrl,
+            },
+        ];
+    }
+    return [];
+}
+async function resolveInboundMedia(params) {
+    const out = [];
+    const maxBytes = resolveDdchatMediaMaxBytes(params.cfg);
+    for (const file of params.files) {
+        const name = typeof file.name === "string" ? file.name : undefined;
+        const mediaType = (typeof file.type === "string" && file.type.trim()) ||
+            (typeof file.mimeType === "string" && file.mimeType.trim()) ||
+            undefined;
+        const base64 = typeof file.base64 === "string" ? file.base64.trim() : "";
+        const url = typeof file.url === "string" ? file.url.trim() : "";
+        try {
+            let buffer;
+            let contentType = mediaType;
+            if (base64) {
+                if (maxBytes && estimateBase64DecodedBytes(base64) > maxBytes) {
+                    throw new Error("media exceeds maximum size");
+                }
+                buffer = Buffer.from(base64, "base64");
+            }
+            else if (url) {
+                const fetched = await params.channelRuntime.media.fetchRemoteMedia({
+                    url,
+                    maxBytes,
+                });
+                buffer = fetched.buffer;
+                contentType = fetched.contentType ?? contentType;
+            }
+            else {
+                continue;
+            }
+            const saved = await params.channelRuntime.media.saveMediaBuffer(buffer, contentType, "inbound/ddchat", maxBytes, name);
+            out.push({
+                path: saved.path,
+                contentType: saved.contentType ?? contentType,
+            });
+        }
+        catch (error) {
+            params.logInfo?.(`ddchat media parse failed: ${String(error)}`);
+        }
+    }
+    return out;
+}
+function inferBodyFromMedia(mediaList) {
+    const firstType = mediaList[0]?.contentType;
+    if (!firstType) {
+        return "<media:file>";
+    }
+    if (firstType.startsWith("image/")) {
+        return "<media:image>";
+    }
+    if (firstType.startsWith("audio/")) {
+        return "<media:audio>";
+    }
+    if (firstType.startsWith("video/")) {
+        return "<media:video>";
+    }
+    return "<media:file>";
+}
+function buildLocalAgentMediaPayload(mediaList) {
+    const first = mediaList[0];
+    const mediaPaths = mediaList.map((media) => media.path);
+    const mediaTypes = mediaList.map((media) => media.contentType).filter(Boolean);
+    return {
+        MediaPath: first?.path,
+        MediaType: first?.contentType ?? undefined,
+        MediaUrl: first?.path,
+        MediaPaths: mediaPaths.length > 0 ? mediaPaths : undefined,
+        MediaUrls: mediaPaths.length > 0 ? mediaPaths : undefined,
+        MediaTypes: mediaTypes.length > 0 ? mediaTypes : undefined,
+    };
+}
+function collectWebhookRoutes(cfg) {
+    const byPath = new Map();
+    const add = (path, accountId) => {
+        const accounts = byPath.get(path) ?? new Set();
+        accounts.add(accountId);
+        byPath.set(path, accounts);
+    };
+    byPath.set("/ddchat/webhook", new Set());
+    for (const accountId of listDdchatAccountIds(cfg)) {
+        const account = resolveDdchatAccount(cfg, accountId);
+        add(account.webhookPath ?? "/ddchat/webhook", account.accountId);
+    }
+    return Array.from(byPath.entries()).map(([path, accounts]) => {
+        const accountIds = Array.from(accounts);
+        return {
+            path,
+            fallbackAccountId: accountIds.length === 1 ? accountIds[0] : undefined,
+        };
+    });
+}
+export function registerDdchatWebhook(api) {
+    const cfg = api.runtime.config.loadConfig();
+    for (const route of collectWebhookRoutes(cfg)) {
+        api.registerHttpRoute({
+            path: route.path,
+            auth: "plugin",
+            handler: async (req, res) => {
+                try {
+                    const currentCfg = api.runtime.config.loadConfig();
+                    const body = await readBody(req);
+                    const result = await processDdchatInboundWithChannelRuntime({
+                        channelRuntime: api.runtime.channel,
+                        cfg: currentCfg,
+                        body,
+                        fallbackAccountId: route.fallbackAccountId,
+                        source: "webhook",
+                        logInfo: (message) => api.runtime.logging.getChildLogger({ module: "ddchat-inbound" }).info(message),
+                    });
+                    res.statusCode = 200;
+                    res.setHeader("Content-Type", "application/json; charset=utf-8");
+                    res.end(JSON.stringify(result));
+                }
+                catch (error) {
+                    res.statusCode = 400;
+                    res.setHeader("Content-Type", "text/plain; charset=utf-8");
+                    res.end(error instanceof Error ? error.message : "invalid request");
+                }
+                return true;
+            },
+        });
+    }
+}
+export async function processDdchatInboundWithChannelRuntime(params) {
+    const body = parseBodyLike(params.body);
+    const accountId = String(body.accountId ?? params.fallbackAccountId ?? "default").trim() || "default";
+    const account = resolveDdchatAccount(params.cfg, accountId);
+    if (!account.enabled) {
+        throw new Error(`ddchat account '${account.accountId}' is disabled`);
+    }
+    const identity = resolveInboundIdentity(body);
+    if (getDdchatState().dedupe.isDuplicate(account.accountId, identity.messageId)) {
+        return {
+            ok: true,
+            duplicate: true,
+            messageId: identity.messageId,
+            accountId: account.accountId,
+        };
+    }
+    const peer = identity.chatType === "group"
+        ? { kind: "group", id: identity.groupId }
+        : { kind: "direct", id: identity.userId };
+    const route = params.channelRuntime.routing.resolveAgentRoute({
+        cfg: params.cfg,
+        channel: DDCHAT_CHANNEL_ID,
+        accountId: account.accountId,
+        peer,
+    });
+    const mediaList = await resolveInboundMedia({
+        channelRuntime: params.channelRuntime,
+        cfg: params.cfg,
+        files: toInboundFiles(body),
+        logInfo: params.logInfo,
+    });
+    const mediaPayload = buildLocalAgentMediaPayload(mediaList);
+    const inboundText = typeof body.text === "string" && body.text.trim()
+        ? body.text.trim()
+        : mediaList.length > 0
+            ? inferBodyFromMedia(mediaList)
+            : "";
+    if (!inboundText) {
+        throw new Error("missing text/files");
+    }
+    const timestamp = Date.now();
+    const from = `ddchat:${identity.userId}`;
+    const to = identity.chatType === "group" ? `group:${identity.groupId}` : `user:${identity.userId}`;
+    const ctxPayload = params.channelRuntime.reply.finalizeInboundContext({
+        Body: inboundText,
+        BodyForAgent: inboundText,
+        RawBody: inboundText,
+        CommandBody: inboundText,
+        From: from,
+        To: to,
+        SessionKey: route.sessionKey,
+        AccountId: route.accountId,
+        ChatType: identity.chatType,
+        GroupSubject: identity.chatType === "group" ? identity.groupId : undefined,
+        SenderId: identity.userId,
+        MessageSid: identity.messageId,
+        Timestamp: timestamp,
+        Provider: DDCHAT_CHANNEL_ID,
+        Surface: DDCHAT_CHANNEL_ID,
+        OriginatingChannel: DDCHAT_CHANNEL_ID,
+        OriginatingTo: to,
+        CommandAuthorized: true,
+        ...mediaPayload,
+    });
+    const delivered = [];
+    const streamId = `ddchat-stream-${identity.messageId}`;
+    let streamText = "";
+    const streamMode = account.streamingMode;
+    const emitStream = (patch) => {
+        const runtime = getDdchatWsRuntime(account.accountId);
+        const sent = runtime.send?.({
+            type: "stream_chunk",
+            streamId,
+            accountId: account.accountId,
+            source: params.source ?? "ws",
+            sessionKey: route.sessionKey,
+            agentId: route.agentId,
+            mode: streamMode,
+            delta: patch.delta ?? "",
+            fullText: streamText,
+            done: patch.done,
+            from: "claw",
+            ts: Date.now(),
+        }) ?? false;
+        if (!sent) {
+            params.logInfo?.(`ddchat stream send failed for account ${account.accountId}`);
+        }
+    };
+    await params.channelRuntime.reply.dispatchReplyWithBufferedBlockDispatcher({
+        ctx: ctxPayload,
+        cfg: params.cfg,
+        dispatcherOptions: {
+            deliver: async (payload) => {
+                const text = payload.text ?? payload.body ?? "";
+                const mediaUrl = payload.mediaUrl?.trim() || payload.mediaUrls?.find((u) => u?.trim())?.trim();
+                if (!text && !mediaUrl) {
+                    return;
+                }
+                const mediaFields = mediaUrl
+                    ? await resolveDdchatOutboundMediaFields(params.cfg, mediaUrl)
+                    : {};
+                const outbound = {
+                    type: "outbound_message",
+                    from: "claw",
+                    channel: DDCHAT_CHANNEL_ID,
+                    accountId: account.accountId,
+                    targetType: identity.chatType,
+                    targetId: identity.chatType === "group" ? identity.groupId : identity.userId,
+                    text,
+                    mediaUrl,
+                    ...mediaFields,
+                };
+                if (!account.streaming || !text) {
+                    const runtime = getDdchatWsRuntime(account.accountId);
+                    const sent = runtime.send?.(outbound) ?? false;
+                    if (!sent) {
+                        params.logInfo?.(`ddchat outbound send failed for account ${account.accountId}`);
+                    }
+                }
+                delivered.push({
+                    messageId: createDdchatMessageId("ddchat-out"),
+                    text,
+                });
+                if (account.streaming && text) {
+                    streamText += text;
+                    emitStream({ delta: text, done: false });
+                }
+            },
+            onReplyStart: () => {
+                params.logInfo?.("ddchat agent reply started");
+            },
+        },
+    });
+    if (account.streaming) {
+        emitStream({ done: true });
+    }
+    return {
+        ok: true,
+        sessionKey: route.sessionKey,
+        agentId: route.agentId,
+        deliveredCount: delivered.length,
+        delivered,
+    };
+}