@clawling/clawchat-plugin-openclaw 2026.5.12-28

package/dist/src/message-mapper.js

@@ -0,0 +1,146 @@
+const MEDIA_KINDS = new Set(["image", "file", "audio", "video"]);
+function isMediaKind(kind) {
+    return MEDIA_KINDS.has(kind);
+}
+function renderMediaPlaceholder(fragment) {
+    const kind = String(fragment.kind ?? "");
+    const url = typeof fragment.url === "string" ? fragment.url : "";
+    if (!url)
+        return "";
+    const name = typeof fragment.name === "string" && fragment.name.trim()
+        ? fragment.name
+        : kind === "image"
+            ? "image"
+            : kind === "audio"
+                ? "audio"
+                : kind === "video"
+                    ? "video"
+                    : "file";
+    return kind === "image" ? `![${name}](${url})` : `[${name}](${url})`;
+}
+export function fragmentsToText(fragments, opts = {}) {
+    const fallback = opts.mentionFallbackIds ?? [];
+    let fallbackCursor = 0;
+    const parts = fragments.map((fragment) => {
+        const f = fragment;
+        if (f.kind === "text" && typeof f.text === "string") {
+            return f.text;
+        }
+        if (f.kind === "mention") {
+            const display = typeof f.display === "string" ? f.display : undefined;
+            if (display && display.trim()) {
+                const trimmed = display.trim();
+                return trimmed.startsWith("@") ? trimmed : `@${trimmed}`;
+            }
+            const id = typeof f.user_id === "string" ? f.user_id : undefined;
+            if (id && id.trim())
+                return `@${id}`;
+            const fallbackId = fallback[fallbackCursor++];
+            if (fallbackId)
+                return `@${fallbackId}`;
+            return "";
+        }
+        if (typeof f.kind === "string" && isMediaKind(f.kind)) {
+            return renderMediaPlaceholder(f);
+        }
+        return "";
+    });
+    return parts.join("").trim();
+}
+export function textToFragments(text) {
+    if (!text || !text.trim())
+        return [];
+    return [{ kind: "text", text }];
+}
+export function normalizeMentionTargets(mentions) {
+    if (!Array.isArray(mentions) || mentions.length === 0) {
+        throw new Error("clawchat_mention_message requires at least one mention");
+    }
+    const seen = new Set();
+    const normalized = [];
+    for (let i = 0; i < mentions.length; i += 1) {
+        const mention = mentions[i];
+        const userId = typeof mention?.userId === "string" ? mention.userId.trim() : "";
+        if (!userId) {
+            throw new Error(`clawchat_mention_message requires mentions[${i}].userId`);
+        }
+        if (seen.has(userId))
+            continue;
+        const rawDisplay = typeof mention?.display === "string" ? mention.display.trim() : "";
+        const display = rawDisplay ? (rawDisplay.startsWith("@") ? rawDisplay.slice(1) : rawDisplay) : undefined;
+        seen.add(userId);
+        normalized.push(display ? { userId, display } : { userId });
+    }
+    return normalized;
+}
+const MENTION_LABEL_RE = /^@(?<label>\S+)(?<rest>(?:\s+.*)?)$/s;
+export function applyTextMentionLabels(mentions, text) {
+    let remaining = typeof text === "string" ? text.trim() : "";
+    if (!remaining)
+        return { mentions, text: "" };
+    const normalized = mentions.map((mention) => ({ ...mention }));
+    const missingDisplay = normalized.filter((mention) => !mention.display);
+    if (normalized.length === 1 && missingDisplay.length === 1 && remaining.startsWith("@")) {
+        const label = remaining.slice(1).trim();
+        if (label) {
+            missingDisplay[0].display = label;
+            return { mentions: normalized, text: "" };
+        }
+    }
+    for (const mention of normalized) {
+        if (mention.display)
+            continue;
+        const match = MENTION_LABEL_RE.exec(remaining);
+        if (!match?.groups?.label)
+            break;
+        mention.display = match.groups.label.trim();
+        remaining = (match.groups.rest ?? "").trim();
+    }
+    return { mentions: normalized, text: remaining };
+}
+export function buildMentionMessageFragments({ mentions, text, }) {
+    const { mentions: normalized, text: remainingText } = applyTextMentionLabels(normalizeMentionTargets(mentions), text);
+    const fragments = normalized.map((mention) => {
+        const fragment = {
+            kind: "mention",
+            user_id: mention.userId,
+        };
+        if (mention.display)
+            fragment.display = mention.display;
+        return fragment;
+    });
+    if (remainingText) {
+        fragments.push({ kind: "text", text: ` ${remainingText}` });
+    }
+    return fragments;
+}
+/**
+ * Extract media fragments from a body (image/file/audio/video). Skips
+ * entries missing `url`. Preserves all optional metadata fields the
+ * protocol carries through (mime/size/width/height/duration/name).
+ */
+export function extractMediaFragments(fragments) {
+    const out = [];
+    for (const fragment of fragments) {
+        const f = fragment;
+        if (typeof f.kind !== "string" || !isMediaKind(f.kind))
+            continue;
+        if (typeof f.url !== "string" || !f.url)
+            continue;
+        const item = { kind: f.kind, url: f.url };
+        if (typeof f.name === "string")
+            item.name = f.name;
+        if (typeof f.mime === "string")
+            item.mime = f.mime;
+        if (typeof f.size === "number")
+            item.size = f.size;
+        if (typeof f.width === "number")
+            item.width = f.width;
+        if (typeof f.height === "number")
+            item.height = f.height;
+        if (typeof f.duration === "number")
+            item.duration = f.duration;
+        out.push(item);
+    }
+    return out;
+}

package/dist/src/mock-transport.js

@@ -0,0 +1,31 @@
+export class MockTransport {
+    handlers;
+    currentState = "closed";
+    sent = [];
+    get state() {
+        return this.currentState;
+    }
+    async connect(_url, handlers) {
+        this.handlers = handlers;
+        this.currentState = "open";
+        handlers.onOpen();
+    }
+    send(data) {
+        if (this.currentState !== "open") {
+            throw new Error("transport is not open");
+        }
+        this.sent.push(data);
+    }
+    close(code = 1000, reason = "client close") {
+        if (this.currentState === "closed")
+            return;
+        this.currentState = "closed";
+        this.handlers?.onClose(code, reason);
+    }
+    emitInbound(data) {
+        this.handlers?.onMessage(data);
+    }
+    emitError(err) {
+        this.handlers?.onError(err);
+    }
+}