@xgjktech/xg_cwork_im 1.19.41 → 1.19.43

package/dist/src/run-usage-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-usage-session.d.ts","sourceRoot":"","sources":["../../src/run-usage-session.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACtB,GAAG,kBAAkB,GAAG,SAAS,CASjC"}

package/dist/src/run-usage-session.js

@@ -0,0 +1,29 @@
+/**
+ * 从 OpenClaw session store 读取本轮结束后的用量 entry。
+ * 使用 `skipCache: true`，避免读到 dispatch 前的缓存快照。
+ */
+import { loadSessionStore, resolveSessionStoreEntry, } from "openclaw/plugin-sdk/session-store-runtime";
+export function readSessionUsageFields(args) {
+    const storePath = args.storePath?.trim();
+    const sessionKey = args.sessionKey?.trim();
+    if (!storePath || !sessionKey)
+        return undefined;
+    const store = loadSessionStore(storePath, { skipCache: true });
+    const { existing } = resolveSessionStoreEntry({ store, sessionKey });
+    if (!existing)
+        return undefined;
+    return pickUsageFields(existing);
+}
+function pickUsageFields(entry) {
+    return {
+        ...(entry.modelProvider != null ? { modelProvider: entry.modelProvider } : {}),
+        ...(entry.model != null ? { model: entry.model } : {}),
+        ...(entry.inputTokens != null ? { inputTokens: entry.inputTokens } : {}),
+        ...(entry.outputTokens != null ? { outputTokens: entry.outputTokens } : {}),
+        ...(entry.totalTokens != null ? { totalTokens: entry.totalTokens } : {}),
+        ...(entry.cacheRead != null ? { cacheRead: entry.cacheRead } : {}),
+        ...(entry.cacheWrite != null ? { cacheWrite: entry.cacheWrite } : {}),
+        ...(entry.estimatedCostUsd != null ? { estimatedCostUsd: entry.estimatedCostUsd } : {}),
+    };
+}
+//# sourceMappingURL=run-usage-session.js.map

package/dist/src/run-usage-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-usage-session.js","sourceRoot":"","sources":["../../src/run-usage-session.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,gBAAgB,EAChB,wBAAwB,GAE3B,MAAM,2CAA2C,CAAC;AAGnD,MAAM,UAAU,sBAAsB,CAAC,IAGtC;IACG,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC;IACzC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAI,CAAC,SAAS,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAEhD,MAAM,KAAK,GAAG,gBAAgB,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,MAAM,EAAE,QAAQ,EAAE,GAAG,wBAAwB,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IACrE,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,eAAe,CAAC,KAAmB;IACxC,OAAO;QACH,GAAG,CAAC,KAAK,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,GAAG,CAAC,KAAK,CAAC,gBAAgB,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1F,CAAC;AACN,CAAC"}

package/dist/src/run-usage.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 一轮 dispatch 结束后的用量：从 OpenClaw session store 的结构化字段汇总，
+ * 供 WS `RUN_USAGE` 回传业务系统。
+ *
+ * 数据源唯一：`sessions.json` 中本 sessionKey 的 entry
+ * （agent-runner 在回合结束时写入 modelProvider / model / inputTokens / outputTokens 等）。
+ * 不解析 deliver 正文 usage footer / usage bar。
+ */
+/** session store 中与用量相关的字段（子集） */
+export type SessionUsageFields = {
+    modelProvider?: string;
+    model?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    cacheRead?: number;
+    cacheWrite?: number;
+    estimatedCostUsd?: number;
+};
+export type RunUsageSnapshot = {
+    provider?: string;
+    model?: string;
+    modelRef?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+    estimatedCostUsd?: number;
+    runId?: string;
+    /** 固定为 session：结构化 session entry */
+    source: "session";
+};
+export type ImStreamRunUsageData = {
+    groupId: string;
+    replyToMsgId: string;
+    usage: RunUsageSnapshot;
+};
+/** 本轮是否值得发 RUN_USAGE（至少有模型或 token 之一）。 */
+export declare function hasReportableUsage(usage: RunUsageSnapshot | undefined): boolean;
+/**
+ * 从 session entry 构建用量快照。
+ * entry 缺字段时不捏造；完全无信息返回 undefined。
+ */
+export declare function buildRunUsageFromSessionEntry(entry: SessionUsageFields | undefined | null, opts?: {
+    runId?: string;
+}): RunUsageSnapshot | undefined;
+export declare function toImStreamRunUsageData(usage: RunUsageSnapshot, anchors: {
+    groupId: string;
+    replyToMsgId: string;
+}): ImStreamRunUsageData;
+//# sourceMappingURL=run-usage.d.ts.map

package/dist/src/run-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-usage.d.ts","sourceRoot":"","sources":["../../src/run-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,kCAAkC;AAClC,MAAM,MAAM,kBAAkB,GAAG;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,MAAM,EAAE,SAAS,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,gBAAgB,CAAC;CAC3B,CAAC;AAaF,0CAA0C;AAC1C,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAa/E;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CACzC,KAAK,EAAE,kBAAkB,GAAG,SAAS,GAAG,IAAI,EAC5C,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,gBAAgB,GAAG,SAAS,CAoC9B;AAkBD,wBAAgB,sBAAsB,CAClC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACnD,oBAAoB,CAMtB"}

package/dist/src/run-usage.js

@@ -0,0 +1,93 @@
+/**
+ * 一轮 dispatch 结束后的用量：从 OpenClaw session store 的结构化字段汇总，
+ * 供 WS `RUN_USAGE` 回传业务系统。
+ *
+ * 数据源唯一：`sessions.json` 中本 sessionKey 的 entry
+ * （agent-runner 在回合结束时写入 modelProvider / model / inputTokens / outputTokens 等）。
+ * 不解析 deliver 正文 usage footer / usage bar。
+ */
+function positiveInt(n) {
+    if (typeof n !== "number" || !Number.isFinite(n) || n < 0)
+        return undefined;
+    return Math.round(n);
+}
+function nonEmpty(s) {
+    if (typeof s !== "string")
+        return undefined;
+    const t = s.trim();
+    return t.length > 0 ? t : undefined;
+}
+/** 本轮是否值得发 RUN_USAGE（至少有模型或 token 之一）。 */
+export function hasReportableUsage(usage) {
+    if (!usage)
+        return false;
+    if (usage.modelRef || usage.model || usage.provider)
+        return true;
+    if (usage.inputTokens != null ||
+        usage.outputTokens != null ||
+        usage.totalTokens != null ||
+        usage.cacheReadTokens != null ||
+        usage.cacheWriteTokens != null) {
+        return true;
+    }
+    return false;
+}
+/**
+ * 从 session entry 构建用量快照。
+ * entry 缺字段时不捏造；完全无信息返回 undefined。
+ */
+export function buildRunUsageFromSessionEntry(entry, opts) {
+    if (!entry)
+        return undefined;
+    const provider = nonEmpty(entry.modelProvider);
+    const model = nonEmpty(entry.model);
+    const modelRef = provider && model ? `${provider}/${model}` : model || undefined;
+    const inputTokens = positiveInt(entry.inputTokens);
+    const outputTokens = positiveInt(entry.outputTokens);
+    const cacheReadTokens = positiveInt(entry.cacheRead);
+    const cacheWriteTokens = positiveInt(entry.cacheWrite);
+    const estimatedCostUsd = typeof entry.estimatedCostUsd === "number" && Number.isFinite(entry.estimatedCostUsd)
+        ? entry.estimatedCostUsd
+        : undefined;
+    let totalTokens = positiveInt(entry.totalTokens);
+    if (totalTokens == null && inputTokens != null && outputTokens != null) {
+        totalTokens = inputTokens + outputTokens;
+    }
+    const snapshot = {
+        ...(provider ? { provider } : {}),
+        ...(model ? { model } : {}),
+        ...(modelRef ? { modelRef } : {}),
+        ...(inputTokens != null ? { inputTokens } : {}),
+        ...(outputTokens != null ? { outputTokens } : {}),
+        ...(totalTokens != null ? { totalTokens } : {}),
+        ...(cacheReadTokens != null ? { cacheReadTokens } : {}),
+        ...(cacheWriteTokens != null ? { cacheWriteTokens } : {}),
+        ...(estimatedCostUsd != null ? { estimatedCostUsd } : {}),
+        ...(opts?.runId?.trim() ? { runId: opts.runId.trim() } : {}),
+        source: "session",
+    };
+    return hasReportableUsage(snapshot) ? snapshot : undefined;
+}
+function runUsageSnapshotToWire(usage) {
+    return {
+        source: usage.source,
+        ...(usage.provider ? { provider: usage.provider } : {}),
+        ...(usage.model ? { model: usage.model } : {}),
+        ...(usage.modelRef ? { modelRef: usage.modelRef } : {}),
+        ...(usage.inputTokens != null ? { inputTokens: usage.inputTokens } : {}),
+        ...(usage.outputTokens != null ? { outputTokens: usage.outputTokens } : {}),
+        ...(usage.totalTokens != null ? { totalTokens: usage.totalTokens } : {}),
+        ...(usage.cacheReadTokens != null ? { cacheReadTokens: usage.cacheReadTokens } : {}),
+        ...(usage.cacheWriteTokens != null ? { cacheWriteTokens: usage.cacheWriteTokens } : {}),
+        ...(usage.estimatedCostUsd != null ? { estimatedCostUsd: usage.estimatedCostUsd } : {}),
+        ...(usage.runId ? { runId: usage.runId } : {}),
+    };
+}
+export function toImStreamRunUsageData(usage, anchors) {
+    return {
+        groupId: anchors.groupId,
+        replyToMsgId: anchors.replyToMsgId,
+        usage: runUsageSnapshotToWire(usage),
+    };
+}
+//# sourceMappingURL=run-usage.js.map

package/dist/src/run-usage.js.map

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

package/dist/src/run-usage.test.d.ts

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

package/dist/src/run-usage.test.d.ts.map

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

package/dist/src/run-usage.test.js

@@ -0,0 +1,90 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { buildRunUsageFromSessionEntry, hasReportableUsage, toImStreamRunUsageData, } from "./run-usage.js";
+describe("buildRunUsageFromSessionEntry", () => {
+    it("maps session store fields to RUN_USAGE snapshot", () => {
+        const u = buildRunUsageFromSessionEntry({
+            modelProvider: "openai",
+            model: "gpt-5.5",
+            inputTokens: 1_200,
+            outputTokens: 89,
+            cacheRead: 10_000,
+            cacheWrite: 0,
+            estimatedCostUsd: 0.0123,
+        }, { runId: "run-1" });
+        assert.ok(u);
+        assert.equal(u.source, "session");
+        assert.equal(u.provider, "openai");
+        assert.equal(u.model, "gpt-5.5");
+        assert.equal(u.modelRef, "openai/gpt-5.5");
+        assert.equal(u.inputTokens, 1_200);
+        assert.equal(u.outputTokens, 89);
+        assert.equal(u.totalTokens, 1_289);
+        assert.equal(u.cacheReadTokens, 10_000);
+        assert.equal(u.cacheWriteTokens, 0);
+        assert.equal(u.estimatedCostUsd, 0.0123);
+        assert.equal(u.runId, "run-1");
+    });
+    it("prefers explicit totalTokens from session", () => {
+        const u = buildRunUsageFromSessionEntry({
+            modelProvider: "xgjk-newapi",
+            model: "MiniMax-M2.7-Cloud",
+            inputTokens: 100,
+            outputTokens: 20,
+            totalTokens: 26_002,
+        });
+        assert.ok(u);
+        assert.equal(u.totalTokens, 26_002);
+    });
+    it("accepts model-only entry", () => {
+        const u = buildRunUsageFromSessionEntry({
+            modelProvider: "openai",
+            model: "gpt-5.5",
+        });
+        assert.ok(u);
+        assert.equal(u.modelRef, "openai/gpt-5.5");
+        assert.equal(u.inputTokens, undefined);
+        assert.equal(hasReportableUsage(u), true);
+    });
+    it("accepts tokens-only entry", () => {
+        const u = buildRunUsageFromSessionEntry({
+            inputTokens: 10,
+            outputTokens: 2,
+        });
+        assert.ok(u);
+        assert.equal(u.totalTokens, 12);
+        assert.equal(u.modelRef, undefined);
+    });
+    it("returns undefined for empty entry", () => {
+        assert.equal(buildRunUsageFromSessionEntry({}), undefined);
+        assert.equal(buildRunUsageFromSessionEntry(null), undefined);
+        assert.equal(buildRunUsageFromSessionEntry(undefined), undefined);
+    });
+});
+describe("toImStreamRunUsageData", () => {
+    it("omits undefined optional fields", () => {
+        const data = toImStreamRunUsageData({
+            provider: "openai",
+            model: "gpt-5.5",
+            modelRef: "openai/gpt-5.5",
+            inputTokens: 100,
+            outputTokens: 5,
+            totalTokens: 105,
+            source: "session",
+        }, { groupId: "g1", replyToMsgId: "m1" });
+        assert.deepEqual(data, {
+            groupId: "g1",
+            replyToMsgId: "m1",
+            usage: {
+                provider: "openai",
+                model: "gpt-5.5",
+                modelRef: "openai/gpt-5.5",
+                inputTokens: 100,
+                outputTokens: 5,
+                totalTokens: 105,
+                source: "session",
+            },
+        });
+    });
+});
+//# sourceMappingURL=run-usage.test.js.map

package/dist/src/run-usage.test.js.map

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

package/dist/src/send-file-event.d.ts

@@ -0,0 +1,26 @@
+export interface SendFileEventParams {
+    groupId: string;
+    fileId: string;
+    fileName: string;
+    fileSize: number;
+    format: string;
+    path: string;
+}
+export interface SendFileEventData extends Record<string, unknown> {
+    status: "completed";
+    payload: {
+        data: {
+            fileId: string;
+            fileName: string;
+            fileSize: number;
+            format: string;
+            path: string;
+        };
+    };
+}
+/**
+ * 当文件发送成功后，向前端 WS 客户端推送 CHAT_FILE 事件。
+ * 保持同步返回：网络发送在内部 fire-and-forget。
+ */
+export declare function sendFileRunEvent(params: SendFileEventParams): void;
+//# sourceMappingURL=send-file-event.d.ts.map

package/dist/src/send-file-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-file-event.d.ts","sourceRoot":"","sources":["../../src/send-file-event.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAkB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9D,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE;QACL,IAAI,EAAE;YACF,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,MAAM,CAAC;YACjB,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,EAAE,MAAM,CAAC;YACf,IAAI,EAAE,MAAM,CAAC;SAChB,CAAC;KACL,CAAC;CACL;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CA6BlE"}

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

@@ -0,0 +1,33 @@
+import { getPlanWsClient } from "./plan-ws-registry.js";
+const LOG_PREFIX = "[xg_cwork_im] [send-file-event]";
+/**
+ * 当文件发送成功后，向前端 WS 客户端推送 CHAT_FILE 事件。
+ * 保持同步返回：网络发送在内部 fire-and-forget。
+ */
+export function sendFileRunEvent(params) {
+    const { groupId, fileId, fileName, fileSize, format, path } = params;
+    if (!groupId) {
+        console.warn(`${LOG_PREFIX} groupId 缺失，跳过 CHAT_FILE fileId=${fileId}`);
+        return;
+    }
+    const target = getPlanWsClient(groupId);
+    if (!target) {
+        console.warn(`${LOG_PREFIX} 未登记 WS client，跳过 CHAT_FILE fileId=${fileId} groupId=${groupId}`);
+        return;
+    }
+    const data = {
+        status: "completed",
+        payload: {
+            data: { fileId, fileName, fileSize, format, path },
+        },
+    };
+    void target.client.sendEvent({
+        groupId,
+        replyToMsgId: target.replyToMsgId,
+        event: "CHAT_FILE",
+        data,
+    }).catch((err) => {
+        console.warn(`${LOG_PREFIX} 发送失败 fileId=${fileId} groupId=${groupId}: ${String(err)}`);
+    });
+}
+//# sourceMappingURL=send-file-event.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"send-file-event.js","sourceRoot":"","sources":["../../src/send-file-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,UAAU,GAAG,iCAAiC,CAAC;AAwBrD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA2B;IACxD,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IAErE,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,mCAAmC,MAAM,EAAE,CAAC,CAAC;QACvE,OAAO;IACX,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,sCAAsC,MAAM,YAAY,OAAO,EAAE,CAAC,CAAC;QAC7F,OAAO;IACX,CAAC;IAED,MAAM,IAAI,GAAsB;QAC5B,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE;YACL,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;SACrD;KACJ,CAAC;IAEF,KAAK,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;QACzB,OAAO;QACP,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,KAAK,EAAE,WAAW;QAClB,IAAI;KACP,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACtB,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,gBAAgB,MAAM,YAAY,OAAO,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;AACP,CAAC"}

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

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

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

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

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

@@ -0,0 +1,86 @@
+import assert from "node:assert/strict";
+import { beforeEach, describe, it } from "node:test";
+import { resetPlanWsRegistryForTest, setPlanWsClient } from "./plan-ws-registry.js";
+import { sendFileRunEvent } from "./send-file-event.js";
+function makeRecordingClient() {
+    const calls = [];
+    return {
+        calls,
+        client: {
+            start: async () => { },
+            streamProgress: async () => { },
+            streamUsage: async () => { },
+            sendEvent: async (opts) => {
+                calls.push(opts);
+            },
+            end: async () => { },
+        },
+    };
+}
+beforeEach(() => resetPlanWsRegistryForTest());
+describe("sendFileRunEvent", () => {
+    it("成功向已登记 WS 客户端推送 CHAT_FILE 事件", () => {
+        const { client, calls } = makeRecordingClient();
+        setPlanWsClient("g-1", client, "msg-1");
+        sendFileRunEvent({
+            groupId: "g-1",
+            fileId: "res-file-123",
+            fileName: "report.pdf",
+            fileSize: 1048576,
+            format: "pdf",
+            path: "output/report.pdf",
+        });
+        assert.equal(calls.length, 1);
+        assert.equal(calls[0].event, "CHAT_FILE");
+        assert.equal(calls[0].groupId, "g-1");
+        assert.equal(calls[0].replyToMsgId, "msg-1");
+        const data = calls[0].data;
+        assert.deepEqual(data, {
+            status: "completed",
+            payload: {
+                data: {
+                    fileId: "res-file-123",
+                    fileName: "report.pdf",
+                    fileSize: 1048576,
+                    format: "pdf",
+                    path: "output/report.pdf",
+                },
+            },
+        });
+    });
+    it("未登记 WS client 时安全跳过且不抛出异常", () => {
+        assert.doesNotThrow(() => {
+            sendFileRunEvent({
+                groupId: "g-unregistered",
+                fileId: "res-file-123",
+                fileName: "report.pdf",
+                fileSize: 1048576,
+                format: "pdf",
+                path: "output/report.pdf",
+            });
+        });
+    });
+    it("sendEvent 异步抛错时静默处理，不中断主流程", () => {
+        const rejectingClient = {
+            start: async () => { },
+            streamProgress: async () => { },
+            streamUsage: async () => { },
+            sendEvent: async () => {
+                throw new Error("WS send error");
+            },
+            end: async () => { },
+        };
+        setPlanWsClient("g-err", rejectingClient, "msg-err");
+        assert.doesNotThrow(() => {
+            sendFileRunEvent({
+                groupId: "g-err",
+                fileId: "res-file-123",
+                fileName: "report.pdf",
+                fileSize: 1048576,
+                format: "pdf",
+                path: "output/report.pdf",
+            });
+        });
+    });
+});
+//# sourceMappingURL=send-file-event.test.js.map

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

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

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

@@ -0,0 +1,81 @@
+/**
+ * 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 { AnyAgentTool } from "openclaw/plugin-sdk";
+import type { XgImConfig } from "./types.js";
+/** 由 OpenClaw 工具工厂上下文（`ctx`）节选注入，模型不可见、不可篡改。 */
+export type XgImSendFileToolHints = {
+    /** Agent 在宿主机上的 workspace 根目录（ctx.workspaceDir） */
+    workspaceDir?: string;
+    /** 当前 Agent ID（ctx.agentId），仅用于日志 */
+    agentId?: string;
+    /** 当前 IM 通道账户（ctx.agentAccountId） */
+    channelAccountId?: string;
+    /** 当前发送者 userId（ctx.requesterSenderId） */
+    requesterSenderId?: string;
+    /** 当前投递目标：channel / to(=groupId) / accountId / threadId（ctx.deliveryContext） */
+    deliveryContext?: {
+        channel?: string | null;
+        to?: string | null;
+        accountId?: string | null;
+        threadId?: string | number | null;
+    } | null;
+};
+export type SendFileErrorCode = "NO_XG_IM_CONTEXT" | "NO_DELIVERY_TARGET" | "NO_WORKSPACE" | "ACCOUNT_MISMATCH" | "ACCOUNT_NOT_FOUND" | "FILE_NOT_FOUND" | "PATH_IS_DIRECTORY" | "PATH_OUTSIDE_WORKSPACE" | "SYMLINK_ESCAPE" | "EMPTY_FILE" | "FILE_TOO_LARGE" | "EXTENSION_NOT_ALLOWED" | "AUTH_FAILED" | "READ_FAILED" | "UPLOAD_FAILED" | "MESSAGE_SEND_FAILED";
+export declare class SendFileError extends Error {
+    readonly code: SendFileErrorCode;
+    constructor(code: SendFileErrorCode, message: string);
+}
+/**
+ * 将模型传入的 path 解析为 workspace 内的宿主机绝对路径。
+ *
+ * 校验顺序与 docs/send-file-tool-design.md §3 一致：
+ * 去前缀 → 拒绝绝对/URL/UNC/.. → resolve 后仍在 workspace → realpath 防符号链接逃逸 →
+ * isFile → 存在/非空/不超限 → 拒绝可执行扩展名。
+ *
+ * @returns 解析后的真实路径、字节数与源文件名。
+ */
+export declare function resolveWorkspaceFile(workspaceDir: string, inputPath: string, maxBytes: number): Promise<{
+    realPath: string;
+    size: number;
+    sourceName: string;
+}>;
+/**
+ * 依据可选的 fileName 生成用户可见文件名：
+ * 去掉路径部分与非法字符，并强制沿用源文件扩展名（不允许模型改扩展名）。
+ */
+export declare function resolveDisplayFileName(sourceName: string, fileNameParam?: string): string;
+/**
+ * 从两个可信来源（deliveryContext.accountId、agentAccountId）确定账户 ID：
+ * 两者都存在且不一致时视为上下文冲突，拒绝执行（避免用错机器人）。
+ */
+export declare function selectTrustedAccountId(deliveryAccountId?: string | null, channelAccountId?: string): {
+    accountId?: string;
+} | {
+    conflict: {
+        a: string;
+        b: string;
+    };
+};
+/**
+ * 严格解析账户配置：
+ * - 单账户模式（无 accounts）：直接返回顶层配置。
+ * - 多账户模式：指定账户必须存在；未指定账户时仅当只有一个非 default 账户才可自动选定，
+ *   否则视为无法确定账户而拒绝。**不会**像 {@link resolveAccountConfig} 那样静默回退到第一个账户。
+ */
+export declare function resolveAccountConfigStrict(base: XgImConfig, accountId?: string): {
+    config: XgImConfig;
+    accountId?: string;
+} | {
+    error: "ACCOUNT_NOT_FOUND";
+    message: string;
+};
+export declare function buildSendFileTool(config: XgImConfig, hints?: XgImSendFileToolHints): AnyAgentTool;
+//# sourceMappingURL=send-file-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"send-file-tool.d.ts","sourceRoot":"","sources":["../../src/send-file-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAYxD,OAAO,KAAK,EAA0C,UAAU,EAAE,MAAM,YAAY,CAAC;AA2BrF,gDAAgD;AAChD,MAAM,MAAM,qBAAqB,GAAG;IAChC,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gFAAgF;IAChF,eAAe,CAAC,EAAE;QACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;KACrC,GAAG,IAAI,CAAC;CACZ,CAAC;AAIF,MAAM,MAAM,iBAAiB,GACvB,kBAAkB,GAClB,oBAAoB,GACpB,cAAc,GACd,kBAAkB,GAClB,mBAAmB,GACnB,gBAAgB,GAChB,mBAAmB,GACnB,wBAAwB,GACxB,gBAAgB,GAChB,YAAY,GACZ,gBAAgB,GAChB,uBAAuB,GACvB,aAAa,GACb,aAAa,GACb,eAAe,GACf,qBAAqB,CAAC;AAE5B,qBAAa,aAAc,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;gBACrB,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM;CAKvD;AAWD;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACtC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAwFjE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBzF;AAID;;;GAGG;AACH,wBAAgB,sBAAsB,CAClC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,EACjC,gBAAgB,CAAC,EAAE,MAAM,GAC1B;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAKjE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACtC,IAAI,EAAE,UAAU,EAChB,SAAS,CAAC,EAAE,MAAM,GACnB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA8B9F;AAID,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,qBAAqB,GAAG,YAAY,CAkKjG"}