@xgjktech/xg_cwork_im 1.19.41 → 1.19.43

package/dist/src/account-reconciler.js

@@ -0,0 +1,294 @@
+/**
+ * 账户级热更新 Reconciler（OpenClaw 6.x，无 accountScopedRestart）。
+ *
+ * 前提：index.ts 通过 api.registerReload({ hotPrefixes: ["channels.xg_cwork_im"] }) 让
+ * Gateway 对通道配置变更走 hot reload（提交运行时快照）但不重启通道。因此本模块
+ * 需要自行轮询 api.runtime.config.current() 感知账号变更，并对变更账号单独启停。
+ *
+ * 运行中账号：Map<accountId, AccountRun>；每个账号一个 AbortController + 一个连接句柄。
+ * diff 指纹（robotKey|appKey|baseUrl|wsBaseUrl|agentId|enabled）后：
+ * - 新增 → 启动
+ * - 删除 / enabled=false → 停止
+ * - 指纹变化 → 重启
+ * - 指纹不变 → 空转（非连接字段由每次入站重读最新 config 生效）
+ */
+import { getXgImConfig, normalizeRobotKey } from "./channel-config.js";
+import { startAccountConnection } from "./account-connection.js";
+import { toLogger } from "./channel-log.js";
+import { deregisterStreamClient } from "./agent-stream-client-registry.js";
+const DEFAULT_POLL_INTERVAL_MS = 3_000;
+const DEFAULT_DEBOUNCE_MS = 500;
+export function fingerprintOf(config) {
+    const normalized = normalizeRobotKey(config);
+    return [
+        normalized.robotKey ?? normalized.appKey ?? "",
+        normalized.baseUrl ?? "",
+        normalized.wsBaseUrl ?? "",
+        normalized.agentId ?? "main",
+        String(config.enabled !== false),
+    ].join("|");
+}
+function isWanted(config) {
+    return config.enabled !== false && Boolean((config.robotKey ?? config.appKey) && config.baseUrl);
+}
+/** 从配置中解析应保持运行的账号集合（与 config.listAccountIds 口径一致，过滤 disabled/未配置）。 */
+export function collectDesiredAccounts(cfg) {
+    const desired = new Map();
+    try {
+        const raw = cfg?.channels
+            ?.xg_cwork_im;
+        if (!raw)
+            return desired;
+        const accounts = raw.accounts;
+        const hasAccountsMap = accounts && typeof accounts === "object" && !Array.isArray(accounts);
+        const keys = hasAccountsMap
+            ? Object.keys(accounts).filter((k) => k !== "default")
+            : [];
+        if (keys.length > 0) {
+            for (const accountId of keys) {
+                const config = getXgImConfig(cfg, accountId);
+                if (isWanted(config))
+                    desired.set(accountId, config);
+            }
+        }
+        else if (!hasAccountsMap) {
+            const config = getXgImConfig(cfg, "default");
+            if (isWanted(config))
+                desired.set("default", config);
+        }
+    }
+    catch {
+        /* 配置暂不可解析时保持现状 */
+    }
+    return desired;
+}
+export class AccountReconciler {
+    options;
+    rt = null;
+    runs = new Map();
+    pollTimer = null;
+    reconcileTimer = null;
+    lastCfg = null;
+    started = false;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    get pollIntervalMs() {
+        return this.options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    }
+    get debounceMs() {
+        return this.options.debounceMs ?? DEFAULT_DEBOUNCE_MS;
+    }
+    setRuntime(rt) {
+        this.rt = rt;
+    }
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        this.pollTimer = setInterval(() => {
+            void this.poll();
+        }, this.pollIntervalMs);
+    }
+    async stopAll() {
+        this.started = false;
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = null;
+        }
+        if (this.reconcileTimer) {
+            clearTimeout(this.reconcileTimer);
+            this.reconcileTimer = null;
+        }
+        for (const accountId of [...this.runs.keys()]) {
+            this.stopAccount(accountId);
+        }
+    }
+    /** Gateway startAccount 委托入口：确保账号运行，并等待 Gateway 端 abort 停止该账号。 */
+    async startAccountLifecycle(ctx) {
+        const log = toLogger(ctx.log);
+        if (!ctx.account.enabled || ctx.account.config.enabled === false) {
+            log.info(`[${ctx.account.accountId}] [reconciler] account disabled, skipping WebSocket start`);
+            this.stopAccount(ctx.account.accountId);
+            return;
+        }
+        if (!this.rt) {
+            ctx.log?.info?.("[xg_cwork_im] [reconciler] runtime not ready, skipping startAccount");
+            return;
+        }
+        await this.syncAccount(ctx.account.accountId, ctx.cfg, ctx.account.config, log);
+        if (!ctx.abortSignal)
+            return;
+        if (ctx.abortSignal.aborted) {
+            this.stopAccount(ctx.account.accountId);
+            return;
+        }
+        await new Promise((resolve) => {
+            const onAbort = () => {
+                ctx.abortSignal?.removeEventListener("abort", onAbort);
+                this.stopAccount(ctx.account.accountId);
+                resolve();
+            };
+            ctx.abortSignal.addEventListener("abort", onAbort, { once: true });
+        });
+    }
+    /** 确保某账号按最新配置运行（新增/指纹变化时启动或重启）。失败会抛错。 */
+    async syncAccount(accountId, cfg, config, logOverride) {
+        const fingerprint = fingerprintOf(config);
+        let run = this.runs.get(accountId);
+        if (run && run.fingerprint !== fingerprint) {
+            run.log.info(`[${accountId}] [reconciler] connection fingerprint changed, restarting`);
+            this.stopRun(run);
+            this.runs.delete(accountId);
+            run = undefined;
+        }
+        if (!run) {
+            run = {
+                accountId,
+                fingerprint,
+                config,
+                abort: new AbortController(),
+                started: null,
+                handle: null,
+                log: logOverride ?? this.channelLog(),
+            };
+            this.runs.set(accountId, run);
+            run.started = this.startRun(run, cfg);
+        }
+        try {
+            await run.started;
+        }
+        catch (err) {
+            if (this.runs.get(accountId) === run) {
+                this.runs.delete(accountId);
+            }
+            throw err;
+        }
+    }
+    startRun(run, cfg) {
+        const rt = this.rt;
+        if (!rt) {
+            run.log.error(`[${run.accountId}] [reconciler] runtime not ready, cannot start`);
+            return Promise.resolve();
+        }
+        return (async () => {
+            try {
+                run.log.info(`[${run.accountId}] [reconciler] Starting xg-cwork-im channel...`);
+                const handle = await startAccountConnection({
+                    cfg,
+                    account: {
+                        accountId: run.accountId,
+                        config: run.config,
+                        enabled: true,
+                        configured: true,
+                    },
+                    config: run.config,
+                    rt,
+                    log: run.log,
+                    abortSignal: run.abort.signal,
+                    cfgProvider: () => this.latestCfg() ?? cfg,
+                });
+                run.handle = handle;
+                run.log.info(`[${run.accountId}] [reconciler] Account connection established`);
+            }
+            catch (err) {
+                // 被主动停止/重启触发的中止：按正常取消处理，不抛错。
+                if (run.abort.signal.aborted) {
+                    run.log.info(`[${run.accountId}] [reconciler] start cancelled (aborted)`);
+                    return;
+                }
+                // 启动失败：移出运行集合，下次轮询自动重试。
+                if (this.runs.get(run.accountId) === run) {
+                    this.runs.delete(run.accountId);
+                }
+                throw err;
+            }
+        })();
+    }
+    stopRun(run) {
+        run.abort.abort();
+        // 防孤儿 Promise unhandled rejection（discard 时该 start 可能仍在飞）。
+        run.started?.catch(() => { });
+        if (run.handle) {
+            run.handle.stop();
+            deregisterStreamClient(run.config.agentId || "main", run.handle.streamClient);
+        }
+    }
+    stopAccount(accountId) {
+        const run = this.runs.get(accountId);
+        if (!run)
+            return;
+        this.stopRun(run);
+        this.runs.delete(accountId);
+    }
+    channelLog() {
+        return toLogger(this.options.logSink);
+    }
+    latestCfg() {
+        try {
+            const cfg = this.rt?.config.current();
+            if (cfg)
+                this.lastCfg = cfg;
+            return cfg ?? this.lastCfg;
+        }
+        catch {
+            return this.lastCfg;
+        }
+    }
+    poll() {
+        if (!this.started || !this.rt)
+            return;
+        const cfg = this.latestCfg();
+        if (!cfg)
+            return;
+        const desired = collectDesiredAccounts(cfg);
+        if (this.snapshotMatches(desired))
+            return;
+        if (this.reconcileTimer)
+            clearTimeout(this.reconcileTimer);
+        this.reconcileTimer = setTimeout(() => {
+            this.reconcileTimer = null;
+            void this.reconcile();
+        }, this.debounceMs);
+    }
+    async reconcile() {
+        if (!this.started || !this.rt)
+            return;
+        const cfg = this.latestCfg();
+        if (!cfg)
+            return;
+        const desired = collectDesiredAccounts(cfg);
+        for (const accountId of [...this.runs.keys()]) {
+            const want = desired.get(accountId);
+            if (!want || want.enabled === false) {
+                this.runs.get(accountId)?.log.info(`[${accountId}] [reconciler] stopping account (removed or disabled)`);
+                this.stopAccount(accountId);
+            }
+        }
+        for (const [accountId, config] of desired) {
+            const run = this.runs.get(accountId);
+            const log = run?.log ?? this.channelLog();
+            try {
+                await this.syncAccount(accountId, cfg, config, log);
+            }
+            catch (err) {
+                log.error(`[${accountId}] [reconciler] reconcile start failed: ${String(err)}`);
+            }
+        }
+    }
+    snapshotMatches(desired) {
+        for (const accountId of this.runs.keys()) {
+            if (!desired.has(accountId))
+                return false;
+        }
+        for (const [accountId, config] of desired) {
+            const run = this.runs.get(accountId);
+            if (!run || run.fingerprint !== fingerprintOf(config))
+                return false;
+        }
+        return true;
+    }
+}
+/** 插件级单例：由 index.ts 注入 runtime 并启动/停止。 */
+export const accountReconciler = new AccountReconciler();
+//# sourceMappingURL=account-reconciler.js.map

package/dist/src/account-reconciler.js.map

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

package/dist/src/account-reconciler.test.d.ts

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

package/dist/src/account-reconciler.test.d.ts.map

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

package/dist/src/account-reconciler.test.js

@@ -0,0 +1,148 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { collectDesiredAccounts, fingerprintOf } from "./account-reconciler.js";
+function cfgWith(channels) {
+    return { channels };
+}
+describe("account-reconciler: fingerprintOf", () => {
+    const base = {
+        robotKey: "rk-1",
+        baseUrl: "https://im.example.com",
+        wsBaseUrl: "wss://ws.example.com",
+        agentId: "assistant-a",
+        enabled: true,
+    };
+    it("same connection fields produce equal fingerprints", () => {
+        assert.equal(fingerprintOf(base), fingerprintOf({ ...base }));
+    });
+    it("robotKey change changes fingerprint", () => {
+        assert.notEqual(fingerprintOf(base), fingerprintOf({ ...base, robotKey: "rk-2" }));
+    });
+    it("baseUrl change changes fingerprint", () => {
+        assert.notEqual(fingerprintOf(base), fingerprintOf({ ...base, baseUrl: "https://other.example.com" }));
+    });
+    it("wsBaseUrl change changes fingerprint", () => {
+        assert.notEqual(fingerprintOf(base), fingerprintOf({ ...base, wsBaseUrl: "wss://ws-2.example.com" }));
+    });
+    it("agentId change changes fingerprint", () => {
+        assert.notEqual(fingerprintOf(base), fingerprintOf({ ...base, agentId: "assistant-b" }));
+    });
+    it("enabled toggle changes fingerprint", () => {
+        assert.notEqual(fingerprintOf(base), fingerprintOf({ ...base, enabled: false }));
+    });
+    it("non-connection fields (name/systemPrompt/groupPolicy) keep fingerprint", () => {
+        assert.equal(fingerprintOf(base), fingerprintOf({ ...base, name: "新名称", systemPrompt: "you are kind", groupPolicy: "open" }));
+    });
+    it("appKey and robotKey normalize to same fingerprint", () => {
+        assert.equal(fingerprintOf({ ...base, robotKey: "rk-1", appKey: undefined }), fingerprintOf({ ...base, robotKey: undefined, appKey: "rk-1" }));
+    });
+});
+describe("account-reconciler: collectDesiredAccounts", () => {
+    it("collects named accounts with inherited top-level baseUrl", () => {
+        const cfg = cfgWith({
+            xg_cwork_im: {
+                baseUrl: "https://im.example.com",
+                accounts: {
+                    default: { baseUrl: "https://im.example.com" },
+                    "assistant-1": { robotKey: "rk-1" },
+                    "assistant-2": { robotKey: "rk-2" },
+                },
+            },
+        });
+        const desired = collectDesiredAccounts(cfg);
+        assert.deepEqual([...desired.keys()].sort(), ["assistant-1", "assistant-2"]);
+        assert.equal(desired.get("assistant-1")?.baseUrl, "https://im.example.com");
+    });
+    it("excludes disabled accounts", () => {
+        const cfg = cfgWith({
+            xg_cwork_im: {
+                baseUrl: "https://im.example.com",
+                accounts: {
+                    "assistant-1": { robotKey: "rk-1" },
+                    "assistant-2": { robotKey: "rk-2", enabled: false },
+                },
+            },
+        });
+        const desired = collectDesiredAccounts(cfg);
+        assert.deepEqual([...desired.keys()], ["assistant-1"]);
+    });
+    it("excludes accounts missing robotKey", () => {
+        const cfg = cfgWith({
+            xg_cwork_im: {
+                baseUrl: "https://im.example.com",
+                accounts: {
+                    "assistant-1": { robotKey: "rk-1" },
+                    "assistant-2": {},
+                },
+            },
+        });
+        const desired = collectDesiredAccounts(cfg);
+        assert.deepEqual([...desired.keys()], ["assistant-1"]);
+    });
+    it("empty accounts map yields no accounts", () => {
+        const cfg = cfgWith({
+            xg_cwork_im: { baseUrl: "https://im.example.com", accounts: {} },
+        });
+        assert.equal(collectDesiredAccounts(cfg).size, 0);
+    });
+    it("single-account mode (no accounts map) yields default", () => {
+        const cfg = cfgWith({
+            xg_cwork_im: { robotKey: "rk-1", baseUrl: "https://im.example.com" },
+        });
+        const desired = collectDesiredAccounts(cfg);
+        assert.deepEqual([...desired.keys()], ["default"]);
+    });
+    it("returns empty when channel config is missing", () => {
+        assert.equal(collectDesiredAccounts(cfgWith({})).size, 0);
+    });
+    it("adding an account changes the desired set", () => {
+        const before = cfgWith({
+            xg_cwork_im: {
+                baseUrl: "https://im.example.com",
+                accounts: { "assistant-1": { robotKey: "rk-1" } },
+            },
+        });
+        const after = cfgWith({
+            xg_cwork_im: {
+                baseUrl: "https://im.example.com",
+                accounts: {
+                    "assistant-1": { robotKey: "rk-1" },
+                    "assistant-2": { robotKey: "rk-2" },
+                },
+            },
+        });
+        assert.deepEqual([...collectDesiredAccounts(after).keys()].sort(), ["assistant-1", "assistant-2"]);
+        assert.equal(collectDesiredAccounts(before).size, 1);
+    });
+    it("removing an account removes it from the desired set", () => {
+        const cfg = cfgWith({
+            xg_cwork_im: {
+                baseUrl: "https://im.example.com",
+                accounts: { "assistant-1": { robotKey: "rk-1" } },
+            },
+        });
+        assert.equal(collectDesiredAccounts(cfg).has("assistant-1"), true);
+        const removed = cfgWith({
+            xg_cwork_im: { baseUrl: "https://im.example.com", accounts: {} },
+        });
+        assert.equal(collectDesiredAccounts(removed).has("assistant-1"), false);
+    });
+    it("robotKey change yields a different fingerprint for the account", () => {
+        const cfgA = cfgWith({
+            xg_cwork_im: {
+                baseUrl: "https://im.example.com",
+                accounts: { "assistant-1": { robotKey: "rk-1" } },
+            },
+        });
+        const cfgB = cfgWith({
+            xg_cwork_im: {
+                baseUrl: "https://im.example.com",
+                accounts: { "assistant-1": { robotKey: "rk-9" } },
+            },
+        });
+        const a = collectDesiredAccounts(cfgA).get("assistant-1");
+        const b = collectDesiredAccounts(cfgB).get("assistant-1");
+        assert.notEqual(fingerprintOf(a), fingerprintOf(b));
+    });
+});
+//# sourceMappingURL=account-reconciler.test.js.map

package/dist/src/account-reconciler.test.js.map

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

package/dist/src/action-run-event.d.ts

@@ -0,0 +1,20 @@
+import type { ActionDispatchEvent } from "./action-store-access.js";
+/**
+ * 构造 ACTION_DISPATCH 的前端数据，只保留前端消费动作所需的业务字段。
+ * `origin` 是内部路由信息，`event` 与 `version` 不属于该事件的 wire 契约，均不透传。
+ */
+export declare function toWireAction(action: ActionDispatchEvent): {
+    eventId: string;
+    action: string;
+    topic?: string;
+    target: string;
+    status: ActionDispatchEvent["status"];
+    scopeControl?: ActionDispatchEvent["scopeControl"];
+    payload: ActionDispatchEvent["payload"];
+    timestamp: string;
+};
+/**
+ * 将权威 action 状态发给前端。必须保持同步返回：网络发送在内部 fire-and-forget。
+ */
+export declare function sendActionRunEvent(action: ActionDispatchEvent): void;
+//# sourceMappingURL=action-run-event.d.ts.map

package/dist/src/action-run-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-run-event.d.ts","sourceRoot":"","sources":["../../src/action-run-event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAsBpE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,mBAAmB,CAAC,cAAc,CAAC,CAAC;IACnD,OAAO,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;CACrB,CAWA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CA2BpE"}

package/dist/src/action-run-event.js

@@ -0,0 +1,62 @@
+import { getPlanWsClient } from "./plan-ws-registry.js";
+const LOG_PREFIX = "[xg_cwork_im] [action-run-event]";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * action 存储契约为 `payload.data`，但当前上游会将实际业务参数再包进 `payload.data.data`。
+ * 仅当外层没有其他字段时才解包，防止丢失未来上游追加的元数据。
+ */
+function toWirePayload(payload) {
+    const outerData = payload.data;
+    const nestedData = outerData.data;
+    if (Object.keys(outerData).length === 1 && isRecord(nestedData)) {
+        return { data: nestedData };
+    }
+    return payload;
+}
+/**
+ * 构造 ACTION_DISPATCH 的前端数据，只保留前端消费动作所需的业务字段。
+ * `origin` 是内部路由信息，`event` 与 `version` 不属于该事件的 wire 契约，均不透传。
+ */
+export function toWireAction(action) {
+    return {
+        eventId: action.eventId,
+        action: action.action,
+        ...(action.topic ? { topic: action.topic } : {}),
+        target: action.target,
+        status: action.status,
+        ...(action.scopeControl ? { scopeControl: action.scopeControl } : {}),
+        payload: toWirePayload(action.payload),
+        timestamp: action.timestamp,
+    };
+}
+/**
+ * 将权威 action 状态发给前端。必须保持同步返回：网络发送在内部 fire-and-forget。
+ */
+export function sendActionRunEvent(action) {
+    const channel = action.origin?.channel;
+    const to = action.origin?.to;
+    if (channel !== "xg_cwork_im" || !to) {
+        console.warn(`${LOG_PREFIX} action.origin 缺失或非本通道，跳过 ACTION_DISPATCH eventId=${action.eventId}`);
+        return;
+    }
+    const target = getPlanWsClient(to);
+    if (!target) {
+        console.warn(`${LOG_PREFIX} 未登记 WS client，跳过 ACTION_DISPATCH eventId=${action.eventId} groupId=${to}`);
+        return;
+    }
+    const logContext = `eventId=${action.eventId} groupId=${to} action=${action.action} target=${action.target}`;
+    console.info(`${LOG_PREFIX} 准备发送 ACTION_DISPATCH ${logContext}`);
+    void target.client.sendEvent({
+        groupId: to,
+        replyToMsgId: target.replyToMsgId,
+        event: "ACTION_DISPATCH",
+        data: toWireAction(action),
+    }).then(() => {
+        console.info(`${LOG_PREFIX} ACTION_DISPATCH 已发送 ${logContext}`);
+    }).catch((err) => {
+        console.warn(`${LOG_PREFIX} 发送失败 eventId=${action.eventId} groupId=${to}: ${String(err)}`);
+    });
+}
+//# sourceMappingURL=action-run-event.js.map

package/dist/src/action-run-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-run-event.js","sourceRoot":"","sources":["../../src/action-run-event.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,UAAU,GAAG,kCAAkC,CAAC;AAEtD,SAAS,QAAQ,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAChF,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,OAAuC;IAC1D,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAC/B,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC;IAClC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9D,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAA2B;IAUpD,OAAO;QACH,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC;QACtC,SAAS,EAAE,MAAM,CAAC,SAAS;KAC9B,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA2B;IAC1D,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,aAAa,IAAI,CAAC,EAAE,EAAE,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,qDAAqD,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACjG,OAAO;IACX,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,6CAA6C,MAAM,CAAC,OAAO,YAAY,EAAE,EAAE,CAAC,CAAC;QACvG,OAAO;IACX,CAAC;IAED,MAAM,UAAU,GAAG,WAAW,MAAM,CAAC,OAAO,YAAY,EAAE,WAAW,MAAM,CAAC,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC;IAC7G,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,yBAAyB,UAAU,EAAE,CAAC,CAAC;IAEjE,KAAK,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;QACzB,OAAO,EAAE,EAAE;QACX,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,KAAK,EAAE,iBAAiB;QACxB,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC;KAC7B,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;QACT,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,wBAAwB,UAAU,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACtB,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,iBAAiB,MAAM,CAAC,OAAO,YAAY,EAAE,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/F,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/src/action-run-event.test.d.ts

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

package/dist/src/action-run-event.test.d.ts.map

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

package/dist/src/action-run-event.test.js

@@ -0,0 +1,83 @@
+import assert from "node:assert/strict";
+import { beforeEach, describe, it } from "node:test";
+import { resetPlanWsRegistryForTest, setPlanWsClient } from "./plan-ws-registry.js";
+import { sendActionRunEvent, toWireAction } from "./action-run-event.js";
+function makeAction(overrides = {}) {
+    return {
+        eventId: "evt-1", event: "action_dispatch", action: "ui_refresh", target: "order_detail",
+        version: 1, status: "completed", payload: { data: { id: "ORD-1" } }, timestamp: "2026-08-13T00:00:00.000Z",
+        ...overrides,
+    };
+}
+function makeRecordingClient() {
+    const calls = [];
+    return {
+        calls,
+        client: {
+            start: async () => { }, streamProgress: async () => { }, streamUsage: async () => { },
+            sendEvent: async (opts) => { calls.push(opts); }, end: async () => { },
+        },
+    };
+}
+beforeEach(() => resetPlanWsRegistryForTest());
+describe("sendActionRunEvent", () => {
+    it("按 origin 路由为 ACTION_DISPATCH，透传精简 action 字段且剥离 origin", () => {
+        const { client, calls } = makeRecordingClient();
+        setPlanWsClient("g-1", client, "msg-1");
+        const action = makeAction({
+            origin: { channel: "xg_cwork_im", to: "g-1", sessionKey: "secret" },
+            payload: {
+                data: {
+                    data: {
+                        target_kind: "ops",
+                        trigger: "user_request",
+                        source: "xg_cwork_im",
+                    },
+                },
+            },
+        });
+        sendActionRunEvent(action);
+        assert.equal(calls.length, 1);
+        assert.equal(calls[0].event, "ACTION_DISPATCH");
+        assert.equal(calls[0].groupId, "g-1");
+        assert.equal(calls[0].replyToMsgId, "msg-1");
+        assert.deepEqual(calls[0].data, {
+            eventId: "evt-1",
+            action: "ui_refresh",
+            target: "order_detail",
+            status: "completed",
+            payload: {
+                data: {
+                    target_kind: "ops",
+                    trigger: "user_request",
+                    source: "xg_cwork_im",
+                },
+            },
+            timestamp: "2026-08-13T00:00:00.000Z",
+        });
+        assert.equal(action.origin?.sessionKey, "secret", "不 mutate 入参");
+    });
+    it("缺少当前通道 origin 时不发送", () => {
+        const { client, calls } = makeRecordingClient();
+        setPlanWsClient("g-1", client, "msg-1");
+        assert.doesNotThrow(() => sendActionRunEvent(makeAction()));
+        assert.equal(calls.length, 0);
+    });
+    it("toWireAction 不 mutate 入参", () => {
+        const action = makeAction({ origin: { channel: "xg_cwork_im", to: "g-1" } });
+        const wire = toWireAction(action);
+        assert.equal("origin" in wire, false);
+        assert.equal("event" in wire, false);
+        assert.equal("version" in wire, false);
+        assert.deepEqual(action.origin, { channel: "xg_cwork_im", to: "g-1" });
+    });
+    it("payload.data 含其他字段时不解包，避免丢失上游元数据", () => {
+        const wire = toWireAction(makeAction({
+            payload: { data: { data: { id: "ORD-1" }, source: "upstream" } },
+        }));
+        assert.deepEqual(wire.payload, {
+            data: { data: { id: "ORD-1" }, source: "upstream" },
+        });
+    });
+});
+//# sourceMappingURL=action-run-event.test.js.map