@xgjktech/xg_cwork_im 1.11.3 → 1.11.4

package/{src/group-history-tool.ts → dist/src/group-history-tool.js}

@@ -1,204 +1,168 @@
-/**
- * XG-IM 群聊历史记录工具（供 AI 按需调用）
- *
- * 通过 OpenClaw 的 api.registerTool() 注入，让 AI 在感知到需要上下文时
- * 主动拉取群聊最近 N 条历史消息，而不是每次收到 @ 都强行拉取。
- */
-
-import axios from "axios";
-import { Type, type Static } from "@sinclair/typebox";
-import type { AnyAgentTool } from "openclaw/plugin-sdk";
-import { toolJsonResult } from "./tool-json-result.js";
-import { getToken } from "./auth.js";
-import type { BotIdentity, WsMessageParams, XgImConfig } from "./types.js";
-
-// ─── 工具参数 Schema ─────────────────────────────────────────────────────────
-
-const GroupHistoryParams = Type.Object({
-    groupId: Type.String({
-        description: "群聊 ID，即当前消息来自的群组唯一标识符",
-    }),
-    userId: Type.Optional(
-        Type.String({
-            description: "（可选）以哪个用户身份拉取历史消息的 userId，普通对话场景建议传当前发消息用户 ID；若为空则按后台默认身份查询",
-        }),
-    ),
-    accountId: Type.Optional(
-        Type.String({
-            description:
-                "（可选）要使用的 xg_cwork_im 账户 ID（即 accounts 的 key，例如 main/orchestrator）。",
-        }),
-    ),
-    limit: Type.Optional(
-        Type.Number({
-            description: "需要获取的消息条数（5~30），默认 10",
-            minimum: 1,
-            maximum: 30,
-            default: 10,
-        }),
-    ),
-});
-
-// ─── 内部 HTTP 工具 ──────────────────────────────────────────────────────────
-
-/** 从 OpenClaw 配置中提取 xg_cwork_im 顶层配置（保留 accounts 以便多账户路由） */
-export function extractXgCworkImConfig(cfg: unknown): XgImConfig | null {
-    const raw = (cfg as Record<string, Record<string, unknown>>)?.channels?.xg_cwork_im as XgImConfig | undefined;
-    if (!raw?.baseUrl) return null;
-    return raw;
-}
-
-/**
- * 根据 accountId 解析具体账号配置。
- *
- * - 若传入 accountId 且能解析为有效下标，则优先使用对应 accounts[accountId]。
- * - 否则：有 accounts 时默认使用 accounts[0]；无 accounts 时使用顶层配置。
- */
-export function resolveAccountConfig(base: XgImConfig, accountId?: string | null): XgImConfig {
-    const accounts = base.accounts;
-    if (!accounts) {
-        return base;
-    }
-
-    const map = accounts as Record<string, XgImConfig | undefined>;
-    const defaults = map.default ? { ...map.default } : undefined;
-
-    if (accountId && accountId !== "default") {
-        const hit = map[accountId];
-        if (hit) return { ...base, ...(defaults ?? {}), ...hit };
-    }
-    const firstKey = Object.keys(map).find((k) => k !== "default");
-    const first = firstKey ? map[firstKey] : undefined;
-    return first ? { ...base, ...(defaults ?? {}), ...first } : base;
-}
-
-/** 调用 IM 接口拉取群聊最近 N 条消息 */
-async function fetchGroupHistory(
-    config: XgImConfig,
-    token: string,
-    groupId: string,
-    limit: number,
-    userId?: string,
-): Promise<WsMessageParams[]> {
-    const url = `${config.baseUrl}/im/message/getLatestMsgListForAI`;
-
-    const params: Record<string, unknown> = {
-        groupId,
-        msgCount: limit,
-    };
-    if (userId) {
-        params.userId = userId;
-    }
-
-    const res = await axios.get<{
-        resultCode: number;
-        message?: string;
-        data?: WsMessageParams[];
-    }>(url, {
-        params,
-        headers: { "access-token": token },
-        timeout: 8_000,
-    });
-
-    const body = res.data;
-    if ((body.resultCode !== 1 && body.resultCode !== 200) || !Array.isArray(body.data)) {
-        return [];
-    }
-    return body.data;
-}
-
-// ─── 工具构建函数（直接传 config，而非 factory 模式）──────────────────────────
-
-/**
- * 构建群聊历史工具对象（使用注册时已知的 config，绕开 factory 工厂模式的命名限制）。
- * 由 index.ts 在 register() 里调用，并将构建好的工具对象静态地传给 api.registerTool(tool)。
- */
-export function buildGroupHistoryTool(config: XgImConfig): AnyAgentTool {
-    return {
-        name: "xg_cwork_im_get_group_chat_history",
-        label: "【xg_cwork_im】获取群聊历史记录",
-        description: [
-            "【仅限 xg_cwork_im 通道】获取当前 IM 群聊的最近消息历史，用于理解对话上下文背景。",
-            "",
-            "以下情况你必须先调用此工具，不得直接向用户反问或要求澄清：",
-            "- 用户使用了指代词却没说清楚指的是什么（如'这'、'那'、'上面说的'、'刚才提到的'、'这两家公司'等）",
-            "- 用户的问题依赖之前的对话才能正确理解（如'对吗'、'怎么查的'、'分析一下'但没给出主语）",
-            "- 你不确定用户问题的背景或主语时",
-            "",
-            "调用此工具后你会获得最近 N 条消息，用于还原上下文再给出回答。",
-            "groupId 必须从会话元数据 group_channel 字段中解析，当且仅当其前缀为 agent:main:xg_cwork_im:group:<groupId> 时才可以调用本工具。",
-            "",
-            "【只有在以下情况才可以不调用】：用户的问题明确且自洽，不依赖任何历史对话。",
-        ].join("\n"),
-        parameters: GroupHistoryParams,
-        async execute(_toolCallId: string, params: Static<typeof GroupHistoryParams>) {
-            const limit = params.limit ?? 10;
-            const { groupId, accountId, userId } = params;
-
-            console.log(`[cwork_im][tool] xg_cwork_im_get_group_chat_history called: groupId=${groupId} limit=${limit}`);
-
-            let identity: BotIdentity;
-            try {
-                const accountConfig = resolveAccountConfig(config, accountId);
-                identity = await getToken(accountConfig);
-                console.log(`[cwork_im][tool] token acquired for userId=${identity.userId}`);
-            } catch (err: unknown) {
-                return toolJsonResult({
-                    ok: false,
-                    error: `Failed to obtain access token: ${String(err)}`,
-                    messages: [],
-                });
-            }
-
-            let messages: WsMessageParams[];
-            try {
-                const accountConfig = resolveAccountConfig(config, accountId);
-                messages = await fetchGroupHistory(accountConfig, identity.token, groupId, limit, userId);
-                console.log(
-                    `[cwork_im][tool] fetched ${messages.length} messages from group ${groupId} using accountId=${accountId ?? "0"} userId=${userId ?? "N/A"}`,
-                );
-            } catch (err: unknown) {
-                return toolJsonResult({
-                    ok: false,
-                    error: `Failed to fetch group history: ${String(err)}`,
-                    messages: [],
-                });
-            }
-
-            // 格式化成对话摘要，方便 AI 理解
-            const formatted = messages
-                .filter((m) => {
-                    const t = m.msgContent?.type;
-                    return t === "text" || t === "file";
-                })
-                .map((m) => {
-                    const senderId = m.userInfo?.id ?? "";
-                    const senderName = m.userInfo?.name || senderId || "未知用户";
-                    const isBot = senderId === identity.userId;
-                    const sender = isBot ? "[AI]" : senderName;
-                    const ts = m.timestamp ?? m.msgSendTime ?? 0;
-                    const time = new Date(ts).toLocaleTimeString("zh-CN", { hour12: false });
-                    const c = m.msgContent;
-                    const body =
-                        c?.type === "file" && c.files?.length
-                            ? [
-                                c.text?.trim(),
-                                `[附件 ${c.files.length} 个: ${c.files
-                                    .map((f) => f.name?.trim() || f.fileId || "文件")
-                                    .join("、")}]`,
-                            ]
-                                .filter(Boolean)
-                                .join(" ")
-                            : (c?.text ?? "");
-                    return `[${time}] ${sender}: ${body}`;
-                });
-
-            return toolJsonResult({
-                ok: true,
-                groupId,
-                count: formatted.length,
-                messages: formatted,
-            });
-        },
-    };
-}
+/**
+ * XG-IM 群聊历史记录工具（供 AI 按需调用）
+ *
+ * 通过 OpenClaw 的 api.registerTool() 注入，让 AI 在感知到需要上下文时
+ * 主动拉取群聊最近 N 条历史消息，而不是每次收到 @ 都强行拉取。
+ */
+import axios from "axios";
+import { Type } from "@sinclair/typebox";
+import { toolJsonResult } from "./tool-json-result.js";
+import { getToken } from "./auth.js";
+// ─── 工具参数 Schema ─────────────────────────────────────────────────────────
+const GroupHistoryParams = Type.Object({
+    groupId: Type.String({
+        description: "群聊 ID，即当前消息来自的群组唯一标识符",
+    }),
+    userId: Type.Optional(Type.String({
+        description: "（可选）以哪个用户身份拉取历史消息的 userId，普通对话场景建议传当前发消息用户 ID；若为空则按后台默认身份查询",
+    })),
+    accountId: Type.Optional(Type.String({
+        description: "（可选）要使用的 xg_cwork_im 账户 ID（即 accounts 的 key，例如 main/orchestrator）。",
+    })),
+    limit: Type.Optional(Type.Number({
+        description: "需要获取的消息条数（5~30），默认 10",
+        minimum: 1,
+        maximum: 30,
+        default: 10,
+    })),
+});
+// ─── 内部 HTTP 工具 ──────────────────────────────────────────────────────────
+/** 从 OpenClaw 配置中提取 xg_cwork_im 顶层配置（保留 accounts 以便多账户路由） */
+export function extractXgCworkImConfig(cfg) {
+    const raw = cfg?.channels?.xg_cwork_im;
+    if (!raw?.baseUrl)
+        return null;
+    return raw;
+}
+/**
+ * 根据 accountId 解析具体账号配置。
+ *
+ * - 若传入 accountId 且能解析为有效下标，则优先使用对应 accounts[accountId]。
+ * - 否则：有 accounts 时默认使用 accounts[0]；无 accounts 时使用顶层配置。
+ */
+export function resolveAccountConfig(base, accountId) {
+    const accounts = base.accounts;
+    if (!accounts) {
+        return base;
+    }
+    const map = accounts;
+    const defaults = map.default ? { ...map.default } : undefined;
+    if (accountId && accountId !== "default") {
+        const hit = map[accountId];
+        if (hit)
+            return { ...base, ...(defaults ?? {}), ...hit };
+    }
+    const firstKey = Object.keys(map).find((k) => k !== "default");
+    const first = firstKey ? map[firstKey] : undefined;
+    return first ? { ...base, ...(defaults ?? {}), ...first } : base;
+}
+/** 调用 IM 接口拉取群聊最近 N 条消息 */
+async function fetchGroupHistory(config, token, groupId, limit, userId) {
+    const url = `${config.baseUrl}/im/message/getLatestMsgListForAI`;
+    const params = {
+        groupId,
+        msgCount: limit,
+    };
+    if (userId) {
+        params.userId = userId;
+    }
+    const res = await axios.get(url, {
+        params,
+        headers: { "access-token": token },
+        timeout: 8_000,
+    });
+    const body = res.data;
+    if ((body.resultCode !== 1 && body.resultCode !== 200) || !Array.isArray(body.data)) {
+        return [];
+    }
+    return body.data;
+}
+// ─── 工具构建函数（直接传 config，而非 factory 模式）──────────────────────────
+/**
+ * 构建群聊历史工具对象（使用注册时已知的 config，绕开 factory 工厂模式的命名限制）。
+ * 由 index.ts 在 register() 里调用，并将构建好的工具对象静态地传给 api.registerTool(tool)。
+ */
+export function buildGroupHistoryTool(config) {
+    return {
+        name: "xg_cwork_im_get_group_chat_history",
+        label: "【xg_cwork_im】获取群聊历史记录",
+        description: [
+            "【仅限 xg_cwork_im 通道】获取当前 IM 群聊的最近消息历史，用于理解对话上下文背景。",
+            "",
+            "以下情况你必须先调用此工具，不得直接向用户反问或要求澄清：",
+            "- 用户使用了指代词却没说清楚指的是什么（如'这'、'那'、'上面说的'、'刚才提到的'、'这两家公司'等）",
+            "- 用户的问题依赖之前的对话才能正确理解（如'对吗'、'怎么查的'、'分析一下'但没给出主语）",
+            "- 你不确定用户问题的背景或主语时",
+            "",
+            "调用此工具后你会获得最近 N 条消息，用于还原上下文再给出回答。",
+            "groupId 必须从会话元数据 group_channel 字段中解析，当且仅当其前缀为 agent:main:xg_cwork_im:group:<groupId> 时才可以调用本工具。",
+            "",
+            "【只有在以下情况才可以不调用】：用户的问题明确且自洽，不依赖任何历史对话。",
+        ].join("\n"),
+        parameters: GroupHistoryParams,
+        async execute(_toolCallId, params) {
+            const limit = params.limit ?? 10;
+            const { groupId, accountId, userId } = params;
+            console.log(`[cwork_im][tool] xg_cwork_im_get_group_chat_history called: groupId=${groupId} limit=${limit}`);
+            let identity;
+            try {
+                const accountConfig = resolveAccountConfig(config, accountId);
+                identity = await getToken(accountConfig);
+                console.log(`[cwork_im][tool] token acquired for userId=${identity.userId}`);
+            }
+            catch (err) {
+                return toolJsonResult({
+                    ok: false,
+                    error: `Failed to obtain access token: ${String(err)}`,
+                    messages: [],
+                });
+            }
+            let messages;
+            try {
+                const accountConfig = resolveAccountConfig(config, accountId);
+                messages = await fetchGroupHistory(accountConfig, identity.token, groupId, limit, userId);
+                console.log(`[cwork_im][tool] fetched ${messages.length} messages from group ${groupId} using accountId=${accountId ?? "0"} userId=${userId ?? "N/A"}`);
+            }
+            catch (err) {
+                return toolJsonResult({
+                    ok: false,
+                    error: `Failed to fetch group history: ${String(err)}`,
+                    messages: [],
+                });
+            }
+            // 格式化成对话摘要，方便 AI 理解
+            const formatted = messages
+                .filter((m) => {
+                const t = m.msgContent?.type;
+                return t === "text" || t === "file";
+            })
+                .map((m) => {
+                const senderId = m.userInfo?.id ?? "";
+                const senderName = m.userInfo?.name || senderId || "未知用户";
+                const isBot = senderId === identity.userId;
+                const sender = isBot ? "[AI]" : senderName;
+                const ts = m.timestamp ?? m.msgSendTime ?? 0;
+                const time = new Date(ts).toLocaleTimeString("zh-CN", { hour12: false });
+                const c = m.msgContent;
+                const body = c?.type === "file" && c.files?.length
+                    ? [
+                        c.text?.trim(),
+                        `[附件 ${c.files.length} 个: ${c.files
+                            .map((f) => f.name?.trim() || f.fileId || "文件")
+                            .join("、")}]`,
+                    ]
+                        .filter(Boolean)
+                        .join(" ")
+                    : (c?.text ?? "");
+                return `[${time}] ${sender}: ${body}`;
+            });
+            return toolJsonResult({
+                ok: true,
+                groupId,
+                count: formatted.length,
+                messages: formatted,
+            });
+        },
+    };
+}
+//# sourceMappingURL=group-history-tool.js.map

package/dist/src/group-history-tool.js.map

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

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

@@ -0,0 +1,40 @@
+/**
+ * 入站附件：可选落盘到当前 Agent workspace 下指定子目录（相对路径）。
+ *
+ * 目录约定：{subdir}/{userId}/{YYYY-MM-DD}/{stem}_{HHmmssmmm}{ext}
+ * 时间取写入时的本地时区。
+ */
+import type { OpenClawConfig } from "openclaw/plugin-sdk";
+import type { Log } from "./auth.js";
+import type { MsgFileVO, XgImConfig } from "./types.js";
+/** 校验：非空、相对路径、不含 `..` 段 */
+export declare function normalizeInboundWorkspaceSubdir(subdir: string): string | null;
+export declare function resolveAgentWorkspaceDirFromRuntime(rt: unknown, cfg: OpenClawConfig): string | undefined;
+export declare function ensureAgentWorkspaceFromRuntime(rt: unknown, cfg: OpenClawConfig): Promise<void>;
+/** `HHmmss` + 三位毫秒，如 `120459237` */
+export declare function formatInboundTimeSuffix(d: Date): string;
+/**
+ * 将落盘绝对路径转为 OpenClaw / 沙箱可用的 workspace 相对引用（POSIX 风格，带 `./` 前缀）。
+ * 若文件不在 workspaceRoot 之下则返回 null（调用方应回退 file:// 或报错）。
+ */
+export declare function absPathToWorkspaceRelativeOpenClawRef(workspaceRoot: string, absPath: string): string | null;
+/**
+ * 沙箱内常用挂载点（如 `/workspace`）+ 相对 workspace 的路径，供 read 等工具按「绝对路径」解析。
+ * 若未配置 sandboxRootPrefix，则仍用 `./xg_im_inbound/...`（相对当前 cwd，部分沙箱工具会误判为不可访问）。
+ */
+export declare function sandboxWorkspaceMediaRef(workspaceRoot: string, absPath: string, sandboxRootPrefix: string): string | null;
+/** `report_120459237.pdf` */
+export declare function buildInboundStoredFilename(originalFilename: string, at: Date): string;
+/**
+ * 将入站附件下载到 workspace 下子目录；失败项保留原 URL。
+ */
+export declare function saveInboundFilesToWorkspace(args: {
+    rt: unknown;
+    cfg: OpenClawConfig;
+    config: XgImConfig;
+    workspaceSubdir: string;
+    senderUserId: string | undefined;
+    fileItems: MsgFileVO[];
+    log?: Log;
+}): Promise<MsgFileVO[]>;
+//# sourceMappingURL=inbound-media-local.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-media-local.d.ts","sourceRoot":"","sources":["../../src/inbound-media-local.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExD,2BAA2B;AAC3B,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS7E;AAED,wBAAgB,mCAAmC,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAWxG;AAED,wBAAsB,+BAA+B,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CASrG;AAgBD,oCAAoC;AACpC,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAMvD;AAcD;;;GAGG;AACH,wBAAgB,qCAAqC,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ3G;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACpC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,MAAM,GAC1B,MAAM,GAAG,IAAI,CAMf;AA2BD,6BAA6B;AAC7B,wBAAgB,0BAA0B,CAAC,gBAAgB,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,GAAG,MAAM,CAMrF;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACpD,EAAE,EAAE,OAAO,CAAC;IACZ,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,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,CAsEvB"}