@xgjktech/xg_cwork_im 1.19.26 → 1.19.27

package/dist/src/send-file-tool.js

@@ -0,0 +1,363 @@
+/**
+ * XG-IM 文件发送工具（`xg_cwork_im_send_file`）
+ *
+ * 直接发送当前 Agent workspace 内的文件到**当前 IM 会话**：校验 workspace 路径与文件 → 上传资源中心 →
+ * 发送 FILE 消息。避免 HTML/SVG 等经 `MEDIA:` + OpenClaw 本地媒体安全规则被拦截。
+ *
+ * 与 `xg_cwork_im_send_group_message`（仅纯文本、需模型给 groupId）不同：
+ * - groupId / accountId 从注入的会话上下文（deliveryContext）获取，模型不可指定；
+ * - 上传或发送失败一律返回 `ok:false`，绝不降级成文本后谎报成功。
+ */
+import { Type } from "@sinclair/typebox";
+import { readFile, realpath, stat } from "node:fs/promises";
+import path from "node:path";
+import { getToken } from "./auth.js";
+import { resolveAccountConfig } from "./group-history-tool.js";
+import { formatFromFilename, resolveMaxAttachmentBytes, resolveResourceUploadUrl, uploadWholeResourceFileWithRetry, } from "./resource-file.js";
+import { sendFileRunEvent } from "./send-file-event.js";
+import { generateClientMsgId, sendUploadedFileMessage } from "./send-service.js";
+import { toolJsonResult } from "./tool-json-result.js";
+// ─── 工具参数 Schema ─────────────────────────────────────────────────────────
+const SendFileParams = Type.Object({
+    path: Type.String({
+        minLength: 1,
+        description: "当前 Agent workspace 内的文件相对路径，例如 report.html 或 output/report.pdf；" +
+            "可选前缀 ./ 或 /workspace/。禁止绝对路径、URL、UNC、workspace 外或 .. 越界路径。",
+    }),
+    caption: Type.Optional(Type.String({
+        description: "附件说明文字（可选）",
+        maxLength: 2000,
+    })),
+    fileName: Type.Optional(Type.String({
+        description: "用户看到的文件名（可选）；省略时使用源文件名。扩展名以源文件为准，不可修改。",
+    })),
+    atUserIds: Type.Optional(Type.Array(Type.String(), { maxItems: 50 })),
+});
+export class SendFileError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "SendFileError";
+        this.code = code;
+    }
+}
+/** 默认拒绝的可执行 / 脚本扩展名（去掉点、小写） */
+const BLOCKED_EXTENSIONS = new Set(["exe", "dll", "bat", "cmd", "msi", "ps1", "sh"]);
+// ─── 路径安全解析 ─────────────────────────────────────────────────────────────
+function isUrlLike(ref) {
+    return /^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(ref) || ref.startsWith("file:");
+}
+/**
+ * 将模型传入的 path 解析为 workspace 内的宿主机绝对路径。
+ *
+ * 校验顺序与 docs/send-file-tool-design.md §3 一致：
+ * 去前缀 → 拒绝绝对/URL/UNC/.. → resolve 后仍在 workspace → realpath 防符号链接逃逸 →
+ * isFile → 存在/非空/不超限 → 拒绝可执行扩展名。
+ *
+ * @returns 解析后的真实路径、字节数与源文件名。
+ */
+export async function resolveWorkspaceFile(workspaceDir, inputPath, maxBytes) {
+    const raw = inputPath.trim();
+    const posix = raw.replace(/\\/g, "/");
+    if (isUrlLike(raw)) {
+        throw new SendFileError("PATH_OUTSIDE_WORKSPACE", "不支持 URL 或 file:// 路径，只能发送 workspace 内文件。");
+    }
+    // Windows 盘符绝对路径 / UNC
+    if (/^[a-zA-Z]:[/\\]/.test(raw) || posix.startsWith("//")) {
+        throw new SendFileError("PATH_OUTSIDE_WORKSPACE", "不支持宿主机绝对路径或 UNC 路径。");
+    }
+    // 去掉可选前缀：/workspace/、./
+    let rel;
+    if (posix === "/workspace" || posix === "/workspace/") {
+        rel = "";
+    }
+    else if (posix.startsWith("/workspace/")) {
+        rel = posix.slice("/workspace/".length);
+    }
+    else if (posix.startsWith("./")) {
+        rel = posix.slice(2);
+    }
+    else if (posix.startsWith("/")) {
+        // 其它绝对路径（如 /tmp/openclaw/...）一律拒绝
+        throw new SendFileError("PATH_OUTSIDE_WORKSPACE", "不支持 workspace 外的绝对路径。");
+    }
+    else {
+        rel = posix;
+    }
+    rel = rel.replace(/^\/+/, "").trim();
+    if (!rel || rel === ".") {
+        throw new SendFileError("PATH_IS_DIRECTORY", "指定路径是 workspace 根目录，不是可发送文件。");
+    }
+    if (rel.split("/").some((seg) => seg === "..")) {
+        throw new SendFileError("PATH_OUTSIDE_WORKSPACE", "路径包含 .. ，越出 workspace。");
+    }
+    const absolutePath = path.resolve(workspaceDir, rel);
+    const relToRoot = path.relative(workspaceDir, absolutePath);
+    if (relToRoot === ".." || relToRoot.startsWith(`..${path.sep}`) || path.isAbsolute(relToRoot)) {
+        throw new SendFileError("PATH_OUTSIDE_WORKSPACE", "解析后的路径不在当前 Agent workspace 内。");
+    }
+    // realpath 防止符号链接逃逸；workspace 自身也 realpath 以对齐比较基准。
+    let realWorkspace;
+    try {
+        realWorkspace = await realpath(workspaceDir);
+    }
+    catch {
+        realWorkspace = path.resolve(workspaceDir);
+    }
+    let realPath;
+    try {
+        realPath = await realpath(absolutePath);
+    }
+    catch (err) {
+        if (err?.code === "ENOENT") {
+            throw new SendFileError("FILE_NOT_FOUND", "文件不存在。请先在 workspace 内创建该文件。");
+        }
+        throw new SendFileError("READ_FAILED", `无法解析文件路径：${String(err)}`);
+    }
+    const realRel = path.relative(realWorkspace, realPath);
+    if (realRel === ".." || realRel.startsWith(`..${path.sep}`) || path.isAbsolute(realRel)) {
+        throw new SendFileError("SYMLINK_ESCAPE", "符号链接指向 workspace 之外，已拒绝。");
+    }
+    const st = await stat(realPath);
+    if (st.isDirectory()) {
+        throw new SendFileError("PATH_IS_DIRECTORY", "指定路径是目录，不是可发送文件。");
+    }
+    if (!st.isFile()) {
+        throw new SendFileError("FILE_NOT_FOUND", "指定路径不是普通文件。");
+    }
+    if (st.size <= 0) {
+        throw new SendFileError("EMPTY_FILE", "文件为空，无法发送。");
+    }
+    if (st.size > maxBytes) {
+        throw new SendFileError("FILE_TOO_LARGE", `文件大小 ${st.size} 字节超过上限 ${maxBytes} 字节。`);
+    }
+    const sourceName = path.basename(realPath) || "file";
+    const ext = path.extname(sourceName).replace(/^\./, "").toLowerCase();
+    if (ext && BLOCKED_EXTENSIONS.has(ext)) {
+        throw new SendFileError("EXTENSION_NOT_ALLOWED", `默认禁止发送 .${ext} 可执行/脚本文件。`);
+    }
+    return { realPath, size: st.size, sourceName };
+}
+/**
+ * 依据可选的 fileName 生成用户可见文件名：
+ * 去掉路径部分与非法字符，并强制沿用源文件扩展名（不允许模型改扩展名）。
+ */
+export function resolveDisplayFileName(sourceName, fileNameParam) {
+    if (!fileNameParam || !fileNameParam.trim())
+        return sourceName;
+    const sourceExt = path.extname(sourceName); // 含点，可能为空
+    const base = path.basename(fileNameParam.replace(/\\/g, "/"));
+    // 去掉调用方自带扩展名，统一使用源扩展名
+    const baseNoExt = sourceExt && base.toLowerCase().endsWith(sourceExt.toLowerCase())
+        ? base.slice(0, base.length - sourceExt.length)
+        : base.replace(/\.[^.]*$/, "");
+    // 过滤控制字符与文件系统非法字符
+    const cleaned = baseNoExt
+        .replace(/[\x00-\x1f\x7f/\\:*?"<>|]/g, "")
+        .replace(/\s+/g, " ")
+        .trim();
+    if (!cleaned)
+        return sourceName;
+    return `${cleaned}${sourceExt}`;
+}
+// ─── 账户严格解析 ─────────────────────────────────────────────────────────────
+/**
+ * 从两个可信来源（deliveryContext.accountId、agentAccountId）确定账户 ID：
+ * 两者都存在且不一致时视为上下文冲突，拒绝执行（避免用错机器人）。
+ */
+export function selectTrustedAccountId(deliveryAccountId, channelAccountId) {
+    const a = deliveryAccountId?.trim() || undefined;
+    const b = channelAccountId?.trim() || undefined;
+    if (a && b && a !== b)
+        return { conflict: { a, b } };
+    return { accountId: a ?? b };
+}
+/**
+ * 严格解析账户配置：
+ * - 单账户模式（无 accounts）：直接返回顶层配置。
+ * - 多账户模式：指定账户必须存在；未指定账户时仅当只有一个非 default 账户才可自动选定，
+ *   否则视为无法确定账户而拒绝。**不会**像 {@link resolveAccountConfig} 那样静默回退到第一个账户。
+ */
+export function resolveAccountConfigStrict(base, accountId) {
+    const accounts = base.accounts;
+    if (!accounts || typeof accounts !== "object") {
+        return { config: base, accountId };
+    }
+    const map = accounts;
+    const nonDefaultKeys = Object.keys(map).filter((k) => k !== "default" && map[k]);
+    if (accountId && accountId !== "default") {
+        if (!map[accountId]) {
+            return {
+                error: "ACCOUNT_NOT_FOUND",
+                message: `指定账户 ${accountId} 不存在，已拒绝以免用错机器人发送。`,
+            };
+        }
+        return { config: resolveAccountConfig(base, accountId), accountId };
+    }
+    // 未提供明确账户：只有唯一非 default 账户时才可自动选定。
+    if (nonDefaultKeys.length === 1) {
+        return { config: resolveAccountConfig(base, nonDefaultKeys[0]), accountId: nonDefaultKeys[0] };
+    }
+    if (nonDefaultKeys.length === 0) {
+        // 仅有 default：交给 resolveAccountConfig 合并 default 到顶层。
+        return { config: resolveAccountConfig(base, undefined), accountId };
+    }
+    return {
+        error: "ACCOUNT_NOT_FOUND",
+        message: "存在多个账户但当前会话未提供明确账户，无法安全选择，已拒绝。",
+    };
+}
+// ─── 工具构建函数 ─────────────────────────────────────────────────────────────
+export function buildSendFileTool(config, hints) {
+    return {
+        name: "xg_cwork_im_send_file",
+        label: "【xg_cwork_im】发送 workspace 文件到当前会话",
+        description: [
+            "【用途】把**当前 Agent workspace 内的文件**发送到**当前 IM 会话**（生成/返回/发送报告、HTML、PDF 等文件时使用）。",
+            "【为何用它】HTML、SVG 等经 MEDIA 会被 OpenClaw 本地媒体安全规则拦截；本工具直接上传资源中心并发 FILE 消息，用户可直接下载。",
+            "【流程】先在 workspace 内创建具体文件 → 用相对路径调用本工具（path 支持 ./ 或 /workspace/ 前缀）。",
+            "【约束】groupId / 账户由会话上下文自动决定，不用也不能传；只能发 workspace 内文件，禁止 URL、宿主机绝对路径、workspace 外或 .. 路径。",
+            "【判成功】仅当返回 ok:true 才能告知用户已发送；ok:false 时按 code 修正文件或路径，不得谎报成功。",
+        ].join("\n"),
+        parameters: SendFileParams,
+        async execute(_toolCallId, params) {
+            const log = makeConsoleLog();
+            const delivery = hints?.deliveryContext ?? null;
+            const channel = delivery?.channel ?? undefined;
+            const groupId = (delivery?.to ?? "").trim();
+            const workspaceDir = hints?.workspaceDir?.trim();
+            const fail = (code, error) => {
+                console.warn(`[cwork_im][tool] xg_cwork_im_send_file rejected code=${code}: ${error}`);
+                return toolJsonResult({ ok: false, code, error });
+            };
+            // 该工具限定「当前 xg_cwork_im 会话」：channel 必须严格等于 xg_cwork_im（缺失也拒绝）。
+            if (channel !== "xg_cwork_im") {
+                return fail("NO_XG_IM_CONTEXT", "当前会话不是 xg_cwork_im 通道（或缺少通道标识），无法使用本工具。");
+            }
+            if (!groupId) {
+                return fail("NO_DELIVERY_TARGET", "缺少当前 IM 会话目标（groupId），无法发送。");
+            }
+            if (!workspaceDir) {
+                return fail("NO_WORKSPACE", "缺少当前 Agent workspace，无法解析文件路径。");
+            }
+            // 账户：两个可信来源冲突时拒绝；随后严格解析（不存在/无法确定时拒绝，绝不回退到第一个账户）。
+            const selected = selectTrustedAccountId(delivery?.accountId, hints?.channelAccountId);
+            if ("conflict" in selected) {
+                return fail("ACCOUNT_MISMATCH", `会话上下文账户不一致（${selected.conflict.a} ≠ ${selected.conflict.b}），已拒绝以免用错机器人。`);
+            }
+            const resolvedAccount = resolveAccountConfigStrict(config, selected.accountId);
+            if ("error" in resolvedAccount) {
+                return fail(resolvedAccount.error, resolvedAccount.message);
+            }
+            const accountConfig = resolvedAccount.config;
+            const effectiveAccountId = resolvedAccount.accountId;
+            // 账户级 maxAttachmentBytes 优先于顶层，避免账户级限制被绕过。
+            const maxBytes = resolveMaxAttachmentBytes(accountConfig);
+            // 1) 路径与文件安全校验
+            let resolved;
+            try {
+                resolved = await resolveWorkspaceFile(workspaceDir, params.path, maxBytes);
+            }
+            catch (err) {
+                if (err instanceof SendFileError)
+                    return fail(err.code, err.message);
+                return fail("READ_FAILED", `路径校验失败：${String(err)}`);
+            }
+            const displayName = resolveDisplayFileName(resolved.sourceName, params.fileName);
+            const displayRel = path.relative(workspaceDir, resolved.realPath).split(path.sep).join("/");
+            console.log(`[cwork_im][tool] xg_cwork_im_send_file start groupId=${groupId} agentId=${hints?.agentId ?? "?"} ` +
+                `file=${displayName} bytes=${resolved.size} accountId=${effectiveAccountId ?? "0"}`);
+            // 2) 鉴权
+            let identity;
+            try {
+                identity = await getToken(accountConfig, log);
+            }
+            catch (err) {
+                return fail("AUTH_FAILED", `获取鉴权 token 失败：${String(err)}`);
+            }
+            // 3) 读取文件，并按实际字节数复核（防止校验后文件继续写入导致超限/清空）
+            let buffer;
+            try {
+                buffer = await readFile(resolved.realPath);
+            }
+            catch (err) {
+                return fail("READ_FAILED", `读取文件失败：${String(err)}`);
+            }
+            if (buffer.length <= 0) {
+                return fail("EMPTY_FILE", "读取到空文件，无法发送。");
+            }
+            if (buffer.length > maxBytes) {
+                return fail("FILE_TOO_LARGE", `读取后文件大小 ${buffer.length} 字节超过上限 ${maxBytes} 字节（可能校验后仍在写入）。`);
+            }
+            // 4) 上传资源中心（带重试）
+            const formField = accountConfig.fileUploadFormField?.trim() || "file";
+            let fileId;
+            try {
+                const uploaded = await uploadWholeResourceFileWithRetry({
+                    fileUploadUrl: resolveResourceUploadUrl(accountConfig.baseUrl),
+                    token: identity.token,
+                    buffer,
+                    filename: displayName,
+                    formField,
+                    log,
+                });
+                fileId = uploaded.fileId;
+            }
+            catch (err) {
+                return fail("UPLOAD_FAILED", `上传文件失败：${String(err)}`);
+            }
+            // 5) 发送 FILE 消息（失败即失败，绝不降级为文本谎报成功）
+            const attachment = {
+                fileId,
+                fileType: "FILE",
+                format: formatFromFilename(displayName),
+                name: displayName,
+                size: buffer.length,
+                source: "resource",
+            };
+            const clientMsgId = generateClientMsgId();
+            try {
+                const sent = await sendUploadedFileMessage({
+                    config: accountConfig,
+                    token: identity.token,
+                    groupId,
+                    caption: params.caption,
+                    attachment,
+                    atUserIds: params.atUserIds ?? [],
+                    clientMsgId,
+                    log,
+                });
+                console.log(`[cwork_im][tool] xg_cwork_im_send_file success groupId=${groupId} fileId=${fileId} ` +
+                    `serverMsgId=${sent.serverMsgId ?? "unknown"}`);
+                sendFileRunEvent({
+                    groupId,
+                    fileId,
+                    fileName: displayName,
+                    fileSize: buffer.length,
+                    format: attachment.format,
+                    path: displayRel,
+                });
+                return toolJsonResult({
+                    ok: true,
+                    path: displayRel,
+                    fileName: displayName,
+                    size: buffer.length,
+                    fileId,
+                    clientMsgId: sent.clientMsgId,
+                    ...(sent.serverMsgId ? { serverMsgId: sent.serverMsgId } : {}),
+                });
+            }
+            catch (err) {
+                return fail("MESSAGE_SEND_FAILED", `发送文件消息失败：${String(err)}`);
+            }
+        },
+    };
+}
+function makeConsoleLog() {
+    return {
+        info: (m) => console.log(`[cwork_im] ${m}`),
+        warn: (m) => console.warn(`[cwork_im] ${m}`),
+        error: (m) => console.error(`[cwork_im] ${m}`),
+    };
+}
+//# sourceMappingURL=send-file-tool.js.map

package/dist/src/send-file-tool.js.map

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

package/dist/src/send-file-tool.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=send-file-tool.test.d.ts.map

package/dist/src/send-file-tool.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-file-tool.test.d.ts","sourceRoot":"","sources":["../../src/send-file-tool.test.ts"],"names":[],"mappings":""}

package/dist/src/send-file-tool.test.js

@@ -0,0 +1,176 @@
+import assert from "node:assert/strict";
+import { mkdir, symlink, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { describe, it } from "node:test";
+import { resolveAccountConfigStrict, resolveDisplayFileName, resolveWorkspaceFile, selectTrustedAccountId, SendFileError, } from "./send-file-tool.js";
+async function makeWorkspace() {
+    const root = path.join(os.tmpdir(), `cwork-sendfile-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+    await mkdir(root, { recursive: true });
+    return root;
+}
+async function writeWorkspaceFile(root, rel, content = "hello") {
+    const abs = path.join(root, rel);
+    await mkdir(path.dirname(abs), { recursive: true });
+    await writeFile(abs, content, "utf8");
+    return abs;
+}
+async function expectCode(promise, code) {
+    await assert.rejects(promise, (err) => {
+        assert.ok(err instanceof SendFileError, `expected SendFileError, got ${String(err)}`);
+        assert.equal(err.code, code);
+        return true;
+    });
+}
+const MAX = 50 * 1024 * 1024;
+describe("resolveWorkspaceFile - accepts", () => {
+    it("accepts plain relative path", async () => {
+        const root = await makeWorkspace();
+        await writeWorkspaceFile(root, "report.html", "<h1>ok</h1>");
+        const r = await resolveWorkspaceFile(root, "report.html", MAX);
+        assert.equal(r.sourceName, "report.html");
+        assert.ok(r.size > 0);
+    });
+    it("accepts ./ prefix and nested output path", async () => {
+        const root = await makeWorkspace();
+        await writeWorkspaceFile(root, "output/report.pdf", "pdfbytes");
+        const r = await resolveWorkspaceFile(root, "./output/report.pdf", MAX);
+        assert.equal(r.sourceName, "report.pdf");
+    });
+    it("accepts /workspace/ logical prefix", async () => {
+        const root = await makeWorkspace();
+        await writeWorkspaceFile(root, "xg-cwork-im/NORMAL/202607/项目报告.html", "<p>报告</p>");
+        const r = await resolveWorkspaceFile(root, "/workspace/xg-cwork-im/NORMAL/202607/项目报告.html", MAX);
+        assert.equal(r.sourceName, "项目报告.html");
+    });
+});
+describe("resolveWorkspaceFile - rejects", () => {
+    it("rejects .. traversal", async () => {
+        const root = await makeWorkspace();
+        await expectCode(resolveWorkspaceFile(root, "../secret.txt", MAX), "PATH_OUTSIDE_WORKSPACE");
+    });
+    it("rejects windows drive absolute path", async () => {
+        const root = await makeWorkspace();
+        await expectCode(resolveWorkspaceFile(root, "C:\\Users\\x\\secret.txt", MAX), "PATH_OUTSIDE_WORKSPACE");
+    });
+    it("rejects UNC path", async () => {
+        const root = await makeWorkspace();
+        await expectCode(resolveWorkspaceFile(root, "\\\\server\\share\\file.html", MAX), "PATH_OUTSIDE_WORKSPACE");
+    });
+    it("rejects non-workspace absolute path", async () => {
+        const root = await makeWorkspace();
+        await expectCode(resolveWorkspaceFile(root, "/tmp/openclaw/file.html", MAX), "PATH_OUTSIDE_WORKSPACE");
+    });
+    it("rejects file:// and http(s) urls", async () => {
+        const root = await makeWorkspace();
+        await expectCode(resolveWorkspaceFile(root, "file:///etc/passwd", MAX), "PATH_OUTSIDE_WORKSPACE");
+        await expectCode(resolveWorkspaceFile(root, "https://example.com/file.html", MAX), "PATH_OUTSIDE_WORKSPACE");
+    });
+    it("rejects nonexistent file", async () => {
+        const root = await makeWorkspace();
+        await expectCode(resolveWorkspaceFile(root, "nope.pdf", MAX), "FILE_NOT_FOUND");
+    });
+    it("rejects a directory", async () => {
+        const root = await makeWorkspace();
+        await mkdir(path.join(root, "subdir"), { recursive: true });
+        await expectCode(resolveWorkspaceFile(root, "subdir", MAX), "PATH_IS_DIRECTORY");
+    });
+    it("rejects empty file", async () => {
+        const root = await makeWorkspace();
+        await writeWorkspaceFile(root, "empty.txt", "");
+        await expectCode(resolveWorkspaceFile(root, "empty.txt", MAX), "EMPTY_FILE");
+    });
+    it("rejects oversized file", async () => {
+        const root = await makeWorkspace();
+        await writeWorkspaceFile(root, "big.bin", "0123456789");
+        await expectCode(resolveWorkspaceFile(root, "big.bin", 4), "FILE_TOO_LARGE");
+    });
+    it("rejects blocked executable extensions", async () => {
+        const root = await makeWorkspace();
+        for (const ext of ["exe", "dll", "bat", "cmd", "msi", "ps1", "sh"]) {
+            await writeWorkspaceFile(root, `evil.${ext}`, "x");
+            await expectCode(resolveWorkspaceFile(root, `evil.${ext}`, MAX), "EXTENSION_NOT_ALLOWED");
+        }
+    });
+    it("rejects symlink escaping workspace", async (t) => {
+        const root = await makeWorkspace();
+        const outside = await makeWorkspace();
+        const secret = await writeWorkspaceFile(outside, "secret.txt", "top secret");
+        const linkPath = path.join(root, "link.txt");
+        try {
+            await symlink(secret, linkPath);
+        }
+        catch {
+            t.skip("symlink not permitted on this platform");
+            return;
+        }
+        await expectCode(resolveWorkspaceFile(root, "link.txt", MAX), "SYMLINK_ESCAPE");
+    });
+});
+describe("selectTrustedAccountId", () => {
+    it("returns single provided id", () => {
+        assert.deepEqual(selectTrustedAccountId("main", undefined), { accountId: "main" });
+        assert.deepEqual(selectTrustedAccountId(undefined, "main"), { accountId: "main" });
+    });
+    it("returns undefined when neither provided", () => {
+        assert.deepEqual(selectTrustedAccountId(undefined, undefined), { accountId: undefined });
+    });
+    it("accepts consistent ids from both sources", () => {
+        assert.deepEqual(selectTrustedAccountId("main", "main"), { accountId: "main" });
+    });
+    it("flags conflict when the two trusted ids differ", () => {
+        const r = selectTrustedAccountId("main", "backup");
+        assert.ok("conflict" in r);
+    });
+});
+describe("resolveAccountConfigStrict", () => {
+    const base = (accounts) => ({ baseUrl: "https://im.example.com", ...(accounts ? { accounts } : {}) });
+    it("single-account mode returns top-level config", () => {
+        const r = resolveAccountConfigStrict(base(), "whatever");
+        assert.ok("config" in r);
+    });
+    it("rejects a non-existent account instead of falling back to first", () => {
+        const r = resolveAccountConfigStrict(base({ main: { robotKey: "k1" }, backup: { robotKey: "k2" } }), "ghost");
+        assert.ok("error" in r);
+        assert.equal(r.error, "ACCOUNT_NOT_FOUND");
+    });
+    it("resolves an existing account", () => {
+        const r = resolveAccountConfigStrict(base({ main: { robotKey: "k1" }, backup: { robotKey: "k2" } }), "main");
+        assert.ok("config" in r);
+        assert.equal(r.accountId, "main");
+    });
+    it("auto-selects the only non-default account when id omitted", () => {
+        const r = resolveAccountConfigStrict(base({ default: { maxAttachmentBytes: 5 }, only: { robotKey: "k" } }));
+        assert.ok("config" in r);
+        assert.equal(r.accountId, "only");
+    });
+    it("rejects when multiple accounts but no id provided (ambiguous)", () => {
+        const r = resolveAccountConfigStrict(base({ main: { robotKey: "k1" }, backup: { robotKey: "k2" } }));
+        assert.ok("error" in r);
+    });
+    it("applies account-level maxAttachmentBytes over top-level", () => {
+        const cfg = base({ main: { robotKey: "k1", maxAttachmentBytes: 1024 } });
+        cfg.maxAttachmentBytes = 50 * 1024 * 1024;
+        const r = resolveAccountConfigStrict(cfg, "main");
+        assert.ok("config" in r);
+        assert.equal(r.config.maxAttachmentBytes, 1024);
+    });
+});
+describe("resolveDisplayFileName", () => {
+    it("keeps source name when fileName omitted (no UUID/suffix)", () => {
+        assert.equal(resolveDisplayFileName("项目报告.html"), "项目报告.html");
+    });
+    it("strips path parts from fileName and keeps source extension", () => {
+        assert.equal(resolveDisplayFileName("report.pdf", "../../evil/我的报告"), "我的报告.pdf");
+    });
+    it("does not let fileName change the source extension", () => {
+        assert.equal(resolveDisplayFileName("report.pdf", "report.exe"), "report.pdf");
+    });
+    it("removes illegal filesystem characters", () => {
+        assert.equal(resolveDisplayFileName("a.md", 'na:me*?"<>|'), "name.md");
+    });
+    it("falls back to source name when sanitized result is empty", () => {
+        assert.equal(resolveDisplayFileName("report.pdf", "///"), "report.pdf");
+    });
+});
+//# sourceMappingURL=send-file-tool.test.js.map

package/dist/src/send-file-tool.test.js.map

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

package/dist/src/send-group-message-tool.d.ts

@@ -0,0 +1,17 @@
+/**
+ * XG-IM「主动推消息」工具（供 OpenClaw 在非对话场景下调用）
+ *
+ * 用途：定时任务、Cron、后台任务等需要 **经本 channel 主动把结果推送到 IM 群** 时，发一条纯文本。
+ * **不用于**用户正通过 IM 与助手聊天时的回合内回复——那种情况走正常助手回复流，用不上本工具。
+ *
+ * 通过 api.registerTool() 注入，工具内部自动获取机器人 token。
+ */
+import type { AnyAgentTool } from "openclaw/plugin-sdk/agent-harness-runtime";
+import type { XgImConfig } from "./types.js";
+import { type XgImToolSessionHints } from "./group-history-tool.js";
+/**
+ * 构建「主动推送群消息」工具（纯文本）。
+ * 建议使用工厂 `(ctx) => buildSendGroupMessageTool(cfg, hints)` 注册以带上通道账户上下文。
+ */
+export declare function buildSendGroupMessageTool(config: XgImConfig, hints?: XgImToolSessionHints): AnyAgentTool;
+//# sourceMappingURL=send-group-message-tool.d.ts.map

package/dist/src/send-group-message-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-group-message-tool.d.ts","sourceRoot":"","sources":["../../src/send-group-message-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAK9E,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AA0B1F;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,oBAAoB,GAAG,YAAY,CAoDxG"}