@xgjktech/xg_cwork_im 1.19.22 → 1.19.23

package/dist/src/inbound-archive.js

@@ -0,0 +1,105 @@
+import { existsSync } from "node:fs";
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import AdmZip from "adm-zip";
+import * as tar from "tar";
+const ARCHIVE_EXTS = [".zip", ".tar.gz", ".tgz", ".tar"];
+const MAX_FILE_COUNT = 500;
+const MAX_TOTAL_BYTES = 500 * 1024 * 1024;
+export function isArchiveFile(filePath) {
+    const lower = filePath.toLowerCase();
+    for (const ext of ARCHIVE_EXTS) {
+        if (lower.endsWith(ext))
+            return true;
+    }
+    return false;
+}
+export function archiveExtractDirPath(archivePath) {
+    const lower = archivePath.toLowerCase();
+    let base = archivePath;
+    for (const ext of ARCHIVE_EXTS) {
+        if (lower.endsWith(ext)) {
+            base = archivePath.slice(0, -ext.length);
+            break;
+        }
+    }
+    return base.replace(/\.$/, "");
+}
+function isSafeEntry(entryPath) {
+    const normalized = path.normalize(entryPath).replace(/\\/g, "/");
+    if (normalized === "." || normalized === "./")
+        return false;
+    if (normalized.startsWith("../") || normalized === "..")
+        return false;
+    if (normalized.includes("/../"))
+        return false;
+    if (path.isAbsolute(normalized))
+        return false;
+    return true;
+}
+export async function extractArchive(archivePath, destDir) {
+    const lower = archivePath.toLowerCase();
+    await mkdir(destDir, { recursive: true });
+    if (lower.endsWith(".zip")) {
+        return extractZip(archivePath, destDir);
+    }
+    if (lower.endsWith(".tar") || lower.endsWith(".tar.gz") || lower.endsWith(".tgz")) {
+        return extractTar(archivePath, destDir);
+    }
+    throw new Error(`unsupported archive format: ${archivePath}`);
+}
+async function extractZip(archivePath, destDir) {
+    const zip = new AdmZip(archivePath);
+    const entries = zip.getEntries();
+    let totalBytes = 0;
+    let fileCount = 0;
+    const extracted = [];
+    for (const entry of entries) {
+        if (entry.isDirectory)
+            continue;
+        if (!isSafeEntry(entry.entryName))
+            continue;
+        fileCount++;
+        if (fileCount > MAX_FILE_COUNT) {
+            throw new Error(`archive contains more than ${MAX_FILE_COUNT} files, extraction aborted`);
+        }
+        const data = entry.getData();
+        totalBytes += data.length;
+        if (totalBytes > MAX_TOTAL_BYTES) {
+            throw new Error(`archive uncompressed size exceeds ${MAX_TOTAL_BYTES} bytes, extraction aborted`);
+        }
+        const targetPath = path.join(destDir, entry.entryName);
+        await mkdir(path.dirname(targetPath), { recursive: true });
+        if (!existsSync(targetPath)) {
+            await writeFile(targetPath, data);
+        }
+        extracted.push(entry.entryName);
+    }
+    return extracted.sort();
+}
+async function extractTar(archivePath, destDir) {
+    const extractedFiles = [];
+    let fileCount = 0;
+    const filter = (entryPath, entry) => {
+        const entryType = typeof entry === "object" && entry !== null && "type" in entry
+            ? entry.type
+            : undefined;
+        if (entryType === "Directory")
+            return true;
+        if (!entryPath || !isSafeEntry(entryPath))
+            return true;
+        fileCount++;
+        if (fileCount > MAX_FILE_COUNT) {
+            throw new Error(`archive contains more than ${MAX_FILE_COUNT} files, extraction aborted`);
+        }
+        extractedFiles.push(entryPath);
+        return true;
+    };
+    await tar.extract({
+        file: archivePath,
+        cwd: destDir,
+        filter,
+    });
+    return extractedFiles.sort();
+}
+//# sourceMappingURL=inbound-archive.js.map

package/dist/src/inbound-archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-archive.js","sourceRoot":"","sources":["../../src/inbound-archive.ts"],"names":[],"mappings":"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"}

package/dist/src/inbound-attachment-meta.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 入站附件来源与业务引用 ID（IM files[] → OpenClaw 展示/结构化字段）。
+ */
+import type { MsgFileVO } from "./types.js";
+export declare function trimAttachmentSource(item: MsgFileVO): string | undefined;
+/** IM fileId → OpenClaw 结构化 refId */
+export declare function trimAttachmentRefId(item: MsgFileVO): string | undefined;
+export declare function attachmentDisplayName(item: MsgFileVO): string;
+/** 正文附件行：`文件名` · **来源：…** · 引用 ID：`…` */
+export declare function formatInboundAttachmentDescriptor(item: MsgFileVO): string;
+/** 附件解析内容块标题下的元信息行（无 Markdown 加粗） */
+export declare function formatInboundAttachmentMetaLine(item: MsgFileVO): string | undefined;
+//# sourceMappingURL=inbound-attachment-meta.d.ts.map

package/dist/src/inbound-attachment-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-attachment-meta.d.ts","sourceRoot":"","sources":["../../src/inbound-attachment-meta.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAGxE;AAED,qCAAqC;AACrC,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAGvE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAE7D;AAED,yCAAyC;AACzC,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAQzE;AAED,qCAAqC;AACrC,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAOnF"}

package/dist/src/inbound-attachment-meta.js

@@ -0,0 +1,39 @@
+/**
+ * 入站附件来源与业务引用 ID（IM files[] → OpenClaw 展示/结构化字段）。
+ */
+export function trimAttachmentSource(item) {
+    const s = item.source?.trim();
+    return s || undefined;
+}
+/** IM fileId → OpenClaw 结构化 refId */
+export function trimAttachmentRefId(item) {
+    const id = item.fileId?.trim();
+    return id || undefined;
+}
+export function attachmentDisplayName(item) {
+    return item.name?.trim() || trimAttachmentRefId(item) || "未命名文件";
+}
+/** 正文附件行：`文件名` · **来源：…** · 引用 ID：`…` */
+export function formatInboundAttachmentDescriptor(item) {
+    const name = attachmentDisplayName(item);
+    const parts = [`\`${name}\``];
+    const source = trimAttachmentSource(item);
+    const refId = trimAttachmentRefId(item);
+    if (source)
+        parts.push(`**来源：${source}**`);
+    if (refId)
+        parts.push(`引用 ID：\`${refId}\``);
+    return parts.join(" · ");
+}
+/** 附件解析内容块标题下的元信息行（无 Markdown 加粗） */
+export function formatInboundAttachmentMetaLine(item) {
+    const bits = [];
+    const source = trimAttachmentSource(item);
+    const refId = trimAttachmentRefId(item);
+    if (source)
+        bits.push(`来源：${source}`);
+    if (refId)
+        bits.push(`引用 ID：${refId}`);
+    return bits.length > 0 ? bits.join(" · ") : undefined;
+}
+//# sourceMappingURL=inbound-attachment-meta.js.map

package/dist/src/inbound-attachment-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-attachment-meta.js","sourceRoot":"","sources":["../../src/inbound-attachment-meta.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,UAAU,oBAAoB,CAAC,IAAe;IAChD,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IAC9B,OAAO,CAAC,IAAI,SAAS,CAAC;AAC1B,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,mBAAmB,CAAC,IAAe;IAC/C,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IAC/B,OAAO,EAAE,IAAI,SAAS,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAe;IACjD,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC;AACrE,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,iCAAiC,CAAC,IAAe;IAC7D,MAAM,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,KAAK,GAAa,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,MAAM,IAAI,CAAC,CAAC;IAC3C,IAAI,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC;IAC5C,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,+BAA+B,CAAC,IAAe;IAC3D,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC;IACtC,IAAI,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC"}

package/dist/src/inbound-chat-type.d.ts

@@ -0,0 +1,33 @@
+/**
+ * IM 入站 chatType（SINGLE / GROUP）解析与出站 reply 策略。
+ */
+import type { InboundTrigger } from "./inbound-terminal-state.js";
+import type { SendMessageReply, WsMessage, WsMessageParams } from "./types.js";
+export type { InboundTrigger };
+/** IM `robotMention.params.chatType` 取值 */
+export type ImChatType = "SINGLE" | "GROUP";
+export declare function parseImChatType(raw: unknown): ImChatType | undefined;
+export declare function isImSingleChat(params: WsMessageParams): boolean;
+/** 传给 OpenClaw 入站上下文的 ChatType（影响群聊/单聊 system prompt 与 NO_REPLY 策略）。 */
+export type OpenClawChatType = "direct" | "group";
+export declare function resolveOpenClawChatType(params: WsMessageParams): OpenClawChatType;
+/**
+ * OpenClaw `WasMentioned`：单聊视为始终已提及；群聊沿用 @ 判定结果。
+ */
+export declare function resolveOpenClawWasMentioned(params: WsMessageParams, actuallyMentioned: boolean): boolean;
+/**
+ * 是否应派发 AI 回复。
+ * - SINGLE：无需 @，每条入站均触发（兼容期仍可带 mentions，但不依赖）。
+ * - GROUP / 未传 chatType：沿用 mentions / 正文 @ 判定。
+ */
+export declare function shouldDispatchInboundReply(msg: WsMessage, params: WsMessageParams, bot: {
+    userId: string;
+    name: string;
+}, rawTextForLegacy: string): boolean;
+/**
+ * 群聊出站携带 IM `reply` 元数据；单聊省略（IM 单聊无需引用回复卡片）。
+ */
+export declare function resolveSendMessageReply(params: WsMessageParams): SendMessageReply | undefined;
+/** 入站触发源：用于终态日志与 cron/续跑区分。 */
+export declare function resolveInboundTrigger(rawText: string): "user" | "runtime_continue";
+//# sourceMappingURL=inbound-chat-type.d.ts.map

package/dist/src/inbound-chat-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-chat-type.d.ts","sourceRoot":"","sources":["../../src/inbound-chat-type.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE/E,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,2CAA2C;AAC3C,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE5C,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAOpE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAE/D;AAED,wEAAwE;AACxE,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAEjF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,eAAe,EAAE,iBAAiB,EAAE,OAAO,GAAG,OAAO,CAExG;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACtC,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACrC,gBAAgB,EAAE,MAAM,GACzB,OAAO,CAGT;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,GAAG,SAAS,CAG7F;AAED,+BAA+B;AAC/B,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,kBAAkB,CAMlF"}

package/dist/src/inbound-chat-type.js

@@ -0,0 +1,52 @@
+/**
+ * IM 入站 chatType（SINGLE / GROUP）解析与出站 reply 策略。
+ */
+import { buildTargetReplyMeta, isActuallyMentioned } from "./inbound-display.js";
+export function parseImChatType(raw) {
+    if (typeof raw !== "string")
+        return undefined;
+    const normalized = raw.trim().toUpperCase();
+    if (normalized === "SINGLE" || normalized === "GROUP") {
+        return normalized;
+    }
+    return undefined;
+}
+export function isImSingleChat(params) {
+    return parseImChatType(params.chatType) === "SINGLE";
+}
+export function resolveOpenClawChatType(params) {
+    return isImSingleChat(params) ? "direct" : "group";
+}
+/**
+ * OpenClaw `WasMentioned`：单聊视为始终已提及；群聊沿用 @ 判定结果。
+ */
+export function resolveOpenClawWasMentioned(params, actuallyMentioned) {
+    return isImSingleChat(params) ? true : actuallyMentioned;
+}
+/**
+ * 是否应派发 AI 回复。
+ * - SINGLE：无需 @，每条入站均触发（兼容期仍可带 mentions，但不依赖）。
+ * - GROUP / 未传 chatType：沿用 mentions / 正文 @ 判定。
+ */
+export function shouldDispatchInboundReply(msg, params, bot, rawTextForLegacy) {
+    if (isImSingleChat(params))
+        return true;
+    return isActuallyMentioned(msg, params, bot, rawTextForLegacy);
+}
+/**
+ * 群聊出站携带 IM `reply` 元数据；单聊省略（IM 单聊无需引用回复卡片）。
+ */
+export function resolveSendMessageReply(params) {
+    if (isImSingleChat(params))
+        return undefined;
+    return buildTargetReplyMeta(params);
+}
+/** 入站触发源：用于终态日志与 cron/续跑区分。 */
+export function resolveInboundTrigger(rawText) {
+    const t = rawText.trim();
+    if (/^continue the openclaw runtime event\b/i.test(t)) {
+        return "runtime_continue";
+    }
+    return "user";
+}
+//# sourceMappingURL=inbound-chat-type.js.map

package/dist/src/inbound-chat-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-chat-type.js","sourceRoot":"","sources":["../../src/inbound-chat-type.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AASjF,MAAM,UAAU,eAAe,CAAC,GAAY;IACxC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QACpD,OAAO,UAAU,CAAC;IACtB,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAuB;IAClD,OAAO,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC;AACzD,CAAC;AAKD,MAAM,UAAU,uBAAuB,CAAC,MAAuB;IAC3D,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAuB,EAAE,iBAA0B;IAC3F,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACtC,GAAc,EACd,MAAuB,EACvB,GAAqC,EACrC,gBAAwB;IAExB,IAAI,cAAc,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,CAAC,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAuB;IAC3D,IAAI,cAAc,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7C,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACjD,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IACzB,IAAI,yCAAyC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,OAAO,kBAAkB,CAAC;IAC9B,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/src/inbound-display.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 入站消息：附件筛选、展示正文、@ 判定、MediaPath(s)、UntrustedContext、回复元数据。
+ */
+import type { MsgFileVO, WsMessage, WsMessageContent, WsMessageParams } from "./types.js";
+/** 交给 OpenClaw 的结构化附件元数据 */
+export interface InboundAttachmentSummary {
+    name?: string;
+    /** IM 人类可读来源，原样透传 */
+    source?: string;
+    /** IM fileId，业务引用 ID */
+    refId?: string;
+    format?: string;
+    /** 落盘后的本地路径或原始 https 链接 */
+    mediaRef?: string;
+    download?: boolean;
+    downloaded: boolean;
+    /** 曾尝试落盘但失败，mediaRef 仍为远程 URL */
+    downloadDegraded?: boolean;
+    hasContent: boolean;
+}
+/** 仍为远程 IM 下载地址（未落盘或落盘失败） */
+export declare function isRemoteAttachmentUrl(url: string): boolean;
+export declare function collectFileItems(msgContent: WsMessageContent | undefined): MsgFileVO[];
+export declare function buildInboundDisplayText(msgContent: WsMessageContent | undefined, fileItems: MsgFileVO[]): string;
+export declare function isActuallyMentioned(msg: WsMessage, params: WsMessageParams, bot: {
+    userId: string;
+    name: string;
+}, rawTextForLegacy: string): boolean;
+export declare function mediaFieldsFromFileItems(fileItems: MsgFileVO[]): Record<string, unknown>;
+/** 从 ext 中移除已由 agentContext / GroupSystemPrompt 处理的键，避免重复注入 */
+export declare function extForUntrustedContext(msgExt: WsMessageContent["ext"]): Record<string, unknown> | undefined;
+export declare function buildUntrustedContext(msgExt: WsMessageContent["ext"], fileItems: MsgFileVO[]): string[] | undefined;
+/** 结构化附件列表，写入 inboundCtx.XgImAttachments */
+export declare function buildInboundAttachmentsPayload(fileItems: MsgFileVO[]): InboundAttachmentSummary[] | undefined;
+export declare function buildTargetReplyMeta(params: WsMessageParams): {
+    targetMsgId: string;
+    targetUserId: string;
+    targetUserName: string;
+    previewText: string;
+};
+//# sourceMappingURL=inbound-display.d.ts.map

package/dist/src/inbound-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-display.d.ts","sourceRoot":"","sources":["../../src/inbound-display.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE1F,4BAA4B;AAC5B,MAAM,WAAW,wBAAwB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;CACvB;AAED,6BAA6B;AAC7B,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG1D;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,gBAAgB,GAAG,SAAS,GAAG,SAAS,EAAE,CAEtF;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,gBAAgB,GAAG,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,MAAM,CAwEhH;AAOD,wBAAgB,mBAAmB,CAC/B,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACrC,gBAAgB,EAAE,MAAM,GACzB,OAAO,CAST;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWxF;AAED,+DAA+D;AAC/D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAS3G;AAED,wBAAgB,qBAAqB,CACjC,MAAM,EAAE,gBAAgB,CAAC,KAAK,CAAC,EAC/B,SAAS,EAAE,SAAS,EAAE,GACvB,MAAM,EAAE,GAAG,SAAS,CAkBtB;AAED,4CAA4C;AAC5C,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,wBAAwB,EAAE,GAAG,SAAS,CAoB7G;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACvB,CAOA"}

package/dist/src/inbound-display.js

@@ -0,0 +1,170 @@
+/**
+ * 入站消息：附件筛选、展示正文、@ 判定、MediaPath(s)、UntrustedContext、回复元数据。
+ */
+import { attachmentDisplayName, formatInboundAttachmentDescriptor, formatInboundAttachmentMetaLine, trimAttachmentRefId, trimAttachmentSource, } from "./inbound-attachment-meta.js";
+import { parseFileDownloadFlag, shouldDownloadInboundFile } from "./inbound-file-download.js";
+/** 仍为远程 IM 下载地址（未落盘或落盘失败） */
+export function isRemoteAttachmentUrl(url) {
+    const u = url.trim();
+    return /^https?:\/\//i.test(u);
+}
+export function collectFileItems(msgContent) {
+    return (msgContent?.files ?? []).filter((f) => f.url?.trim() || f.content?.trim());
+}
+export function buildInboundDisplayText(msgContent, fileItems) {
+    let rawText = msgContent?.text ?? "";
+    if (fileItems.length > 0) {
+        const lines = fileItems.map((f) => {
+            const label = formatInboundAttachmentDescriptor(f);
+            const ref = f.url?.trim();
+            const archiveFiles = f.archiveExtractedFiles;
+            if (archiveFiles && ref) {
+                const fileList = archiveFiles.map((p) => `    - ${p}`).join("\n");
+                return `- ${label}（压缩包，已解压 → \`${ref}\`）\n${fileList}`;
+            }
+            if (ref) {
+                return `- ${label} → \`${ref}\``;
+            }
+            return `- ${label}`;
+        });
+        const block = `**附件（${fileItems.length}）**\n${lines.join("\n")}`;
+        rawText = rawText.trim() ? `${rawText.trim()}\n\n${block}` : block;
+        const parsedParts = fileItems
+            .map((f) => {
+            const c = f.content?.trim();
+            if (!c)
+                return null;
+            const name = attachmentDisplayName(f);
+            const meta = formatInboundAttachmentMetaLine(f);
+            const metaBlock = meta ? `\n\n${meta}` : "";
+            return `### ${name}${metaBlock}\n\n${c}`;
+        })
+            .filter((x) => x != null);
+        if (parsedParts.length > 0) {
+            const parsedBlock = `**附件解析内容**\n\n${parsedParts.join("\n\n")}`;
+            rawText = `${rawText.trim()}\n\n${parsedBlock}`;
+        }
+        const hasLocalRefs = fileItems.some((f) => {
+            const ref = f.url?.trim();
+            return ref && !isRemoteAttachmentUrl(ref);
+        });
+        const hasRemoteUrlRefs = fileItems.some((f) => {
+            const ref = f.url?.trim();
+            return ref && isRemoteAttachmentUrl(ref);
+        });
+        if (hasLocalRefs) {
+            rawText =
+                `${rawText.trim()}\n\n` +
+                    "**附件已下载到本地**\n" +
+                    "处理附件时请使用上文与 MediaPath 中的路径；勿改用原始 IM URL。";
+        }
+        if (hasRemoteUrlRefs) {
+            const hasDownloadDegraded = fileItems.some((f) => shouldDownloadInboundFile(f) && f.url?.trim() && isRemoteAttachmentUrl(f.url));
+            const hasExplicitContentLink = fileItems.some((f) => f.url?.trim() &&
+                isRemoteAttachmentUrl(f.url) &&
+                parseFileDownloadFlag(f.download) === false);
+            if (hasDownloadDegraded) {
+                rawText =
+                    `${rawText.trim()}\n\n` +
+                        "**附件落盘失败（超时或体积限制）**\n" +
+                        "请通过 MediaPath 与上文中的完整 URL 交由 OpenClaw 读取（如 http 工具/read），勿当作本地路径。";
+            }
+            else {
+                const linkNote = hasExplicitContentLink
+                    ? "**可读链接（未落盘）**\n请直接通过 MediaPath 或上文完整 URL 读取内容（如 mdContent 页面），不要当作本地文件路径。"
+                    : "**附件 URL 使用约束**\n处理远程附件时必须逐字原样使用消息与 MediaPath 中的完整 URL；禁止修改、删除或重排任何 query 参数。";
+                rawText = `${rawText.trim()}\n\n${linkNote}`;
+            }
+        }
+    }
+    return rawText;
+}
+function normalizeMentionIds(mentions) {
+    if (!Array.isArray(mentions))
+        return [];
+    return mentions.map((id) => String(id));
+}
+export function isActuallyMentioned(msg, params, bot, rawTextForLegacy) {
+    const mentionIds = normalizeMentionIds(params.mentions);
+    const botUserId = String(bot.userId);
+    const isMentioned = mentionIds.includes(botUserId) || mentionIds.includes("all");
+    const isLegacyMentioned = msg.cmd === "robotMention" &&
+        (!params.mentions || params.mentions.length === 0) &&
+        new RegExp(`@${bot.name}\\b`).test(rawTextForLegacy);
+    return isMentioned || isLegacyMentioned;
+}
+export function mediaFieldsFromFileItems(fileItems) {
+    const urlItems = fileItems.filter((f) => f.url?.trim());
+    if (urlItems.length === 0)
+        return {};
+    if (urlItems.length === 1) {
+        return {
+            MediaPath: urlItems[0].url,
+        };
+    }
+    return {
+        MediaPaths: urlItems.map((f) => f.url),
+    };
+}
+/** 从 ext 中移除已由 agentContext / GroupSystemPrompt 处理的键，避免重复注入 */
+export function extForUntrustedContext(msgExt) {
+    if (!msgExt || typeof msgExt !== "object")
+        return undefined;
+    const copy = { ...msgExt };
+    delete copy.openclaw;
+    delete copy.agentContext;
+    /** 传输元数据，由单轮模型/推理覆盖（pending + before_model_resolve / thinkingLevelOverride）消费，勿进 UntrustedContext */
+    delete copy.ai_model;
+    delete copy.ai_thinking;
+    return Object.keys(copy).length > 0 ? copy : undefined;
+}
+export function buildUntrustedContext(msgExt, fileItems) {
+    const parts = [];
+    const extRest = extForUntrustedContext(msgExt);
+    if (extRest)
+        parts.push(JSON.stringify(extRest));
+    if (fileItems.length > 0) {
+        const summary = fileItems.map((f) => ({
+            name: f.name ?? null,
+            format: f.format ?? null,
+            source: trimAttachmentSource(f) ?? null,
+            refId: trimAttachmentRefId(f) ?? null,
+            size: f.size ?? null,
+            download: parseFileDownloadFlag(f.download) ?? null,
+            downloaded: Boolean(f.url?.trim() && !isRemoteAttachmentUrl(f.url)),
+            contentChars: f.content?.trim() ? f.content.trim().length : null,
+        }));
+        parts.push(`xg_cwork_im.attachments: ${JSON.stringify(summary)}`);
+    }
+    return parts.length > 0 ? parts : undefined;
+}
+/** 结构化附件列表，写入 inboundCtx.XgImAttachments */
+export function buildInboundAttachmentsPayload(fileItems) {
+    if (fileItems.length === 0)
+        return undefined;
+    return fileItems.map((f) => {
+        const ref = f.url?.trim();
+        const downloaded = Boolean(ref && !isRemoteAttachmentUrl(ref));
+        const downloadDegraded = Boolean(ref && isRemoteAttachmentUrl(ref) && shouldDownloadInboundFile(f));
+        return {
+            name: f.name?.trim() || undefined,
+            source: trimAttachmentSource(f),
+            refId: trimAttachmentRefId(f),
+            format: f.format?.trim() || undefined,
+            mediaRef: ref || undefined,
+            download: parseFileDownloadFlag(f.download),
+            downloaded,
+            downloadDegraded,
+            hasContent: Boolean(f.content?.trim()),
+        };
+    });
+}
+export function buildTargetReplyMeta(params) {
+    return {
+        targetMsgId: params.msgId,
+        targetUserId: params.userInfo?.id ?? "",
+        targetUserName: params.userInfo?.name ?? "未知用户",
+        previewText: params.msgContent?.text ?? "",
+    };
+}
+//# sourceMappingURL=inbound-display.js.map

package/dist/src/inbound-display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-display.js","sourceRoot":"","sources":["../../src/inbound-display.ts"],"names":[],"mappings":"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"}

package/dist/src/inbound-file-download.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 入站附件是否落盘：由 IM files[].download 与 content 决定。
+ */
+import type { MsgFileVO } from "./types.js";
+/** 解析 IM 下发的 download（boolean / 字符串 / 数字） */
+export declare function parseFileDownloadFlag(download: unknown): boolean | undefined;
+/**
+ * 是否应将带 url 的附件下载到本地 input。
+ *
+ * - download=true：一定下载
+ * - download=false：不下载，保留 url 给 OpenClaw
+ * - download 未传/为空：有 content 则不下载，否则下载
+ */
+export declare function shouldDownloadInboundFile(item: MsgFileVO): boolean;
+//# sourceMappingURL=inbound-file-download.d.ts.map

package/dist/src/inbound-file-download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-file-download.d.ts","sourceRoot":"","sources":["../../src/inbound-file-download.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,6CAA6C;AAC7C,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAe5E;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAUlE"}

package/dist/src/inbound-file-download.js

@@ -0,0 +1,48 @@
+/**
+ * 入站附件是否落盘：由 IM files[].download 与 content 决定。
+ */
+/** 解析 IM 下发的 download（boolean / 字符串 / 数字） */
+export function parseFileDownloadFlag(download) {
+    if (download === undefined || download === null)
+        return undefined;
+    if (typeof download === "boolean")
+        return download;
+    if (typeof download === "number") {
+        if (download === 1)
+            return true;
+        if (download === 0)
+            return false;
+        return undefined;
+    }
+    if (typeof download === "string") {
+        const t = download.trim().toLowerCase();
+        if (!t)
+            return undefined;
+        if (t === "true" || t === "1" || t === "yes")
+            return true;
+        if (t === "false" || t === "0" || t === "no")
+            return false;
+    }
+    return undefined;
+}
+/**
+ * 是否应将带 url 的附件下载到本地 input。
+ *
+ * - download=true：一定下载
+ * - download=false：不下载，保留 url 给 OpenClaw
+ * - download 未传/为空：有 content 则不下载，否则下载
+ */
+export function shouldDownloadInboundFile(item) {
+    const url = item.url?.trim();
+    if (!url)
+        return false;
+    const flag = parseFileDownloadFlag(item.download);
+    if (flag === true)
+        return true;
+    if (flag === false)
+        return false;
+    if (item.content?.trim())
+        return false;
+    return true;
+}
+//# sourceMappingURL=inbound-file-download.js.map

package/dist/src/inbound-file-download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-file-download.js","sourceRoot":"","sources":["../../src/inbound-file-download.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,6CAA6C;AAC7C,MAAM,UAAU,qBAAqB,CAAC,QAAiB;IACnD,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAClE,IAAI,OAAO,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACnD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC/B,IAAI,QAAQ,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAChC,IAAI,QAAQ,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACjC,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACxC,IAAI,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;QACzB,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK;YAAE,OAAO,IAAI,CAAC;QAC1D,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;IAC/D,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAe;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IAEvB,MAAM,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAEjC,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/src/inbound-input-media.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 入站带 URL 的附件：落盘到项目 input 或默认 xg-cwork-im/input，并将本地路径写入 MediaPath。
+ */
+import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
+import type { Log } from "./auth.js";
+import type { RobotMentionAgentContext } from "./agent-context-types.js";
+import type { MsgFileVO, XgImConfig } from "./types.js";
+/** agentContext 指定项目根时，其下的入站附件子目录名 */
+export declare const AGENT_CONTEXT_INPUT_DIR = "input";
+/** 未指定 agentContext 时，相对 workspace 的默认入站目录 */
+export declare const DEFAULT_INBOUND_INPUT_REL = "xg-cwork-im/input";
+export declare function hasInboundUrlDownloads(fileItems: MsgFileVO[]): boolean;
+export interface InboundInputHostLayout {
+    /** 宿主机绝对路径：…/input（其下再按 userId/日期 分目录） */
+    inputHostDir: string;
+    /** 用于生成 OpenClaw MediaPath；文件若在 workspace 外则可能为 undefined */
+    workspaceRoot?: string;
+}
+/**
+ * 解析入站附件落盘根目录（input 文件夹的宿主绝对路径）。
+ */
+export declare function resolveInboundInputHostLayout(args: {
+    cfg: OpenClawConfig;
+    agentId: string;
+    agentContext?: RobotMentionAgentContext;
+    workspaceHostRoot?: string;
+    log?: Log;
+}): InboundInputHostLayout | undefined;
+/**
+ * 将带 URL 的入站附件下载到 input 目录；无 URL 的项原样保留。失败项保留原 URL。
+ */
+export declare function saveInboundFilesToInputDir(args: {
+    rt: unknown;
+    cfg: OpenClawConfig;
+    config: XgImConfig;
+    agentId: string;
+    agentContext?: RobotMentionAgentContext;
+    workspaceHostRoot?: string;
+    senderUserId: string | undefined;
+    fileItems: MsgFileVO[];
+    log?: Log;
+}): Promise<MsgFileVO[]>;
+//# sourceMappingURL=inbound-input-media.d.ts.map

package/dist/src/inbound-input-media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-input-media.d.ts","sourceRoot":"","sources":["../../src/inbound-input-media.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAYzE,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExD,sCAAsC;AACtC,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAE/C,8CAA8C;AAC9C,eAAO,MAAM,yBAAyB,sBAAsB,CAAC;AAmB7D,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,OAAO,CAEtE;AAED,MAAM,WAAW,sBAAsB;IACnC,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,GAAG,CAAC;CACb,GAAG,sBAAsB,GAAG,SAAS,CAoCrC;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACnD,EAAE,EAAE,OAAO,CAAC;IACZ,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,GAAG,CAAC,EAAE,GAAG,CAAC;CACb,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAyKvB"}