@xgjktech/xg_cwork_im 1.19.21 → 1.19.23

package/dist/src/plugin/channel-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-log.d.ts","sourceRoot":"","sources":["../../../src/plugin/channel-log.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,MAAM;IACnB,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,qDAAqD;AACrD,wBAAgB,QAAQ,CACpB,IAAI,EACE;IAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GAC5H,SAAS,GAChB,MAAM,CAyCR"}

package/dist/src/plugin/channel-log.js

@@ -0,0 +1,45 @@
+/**
+ * Channel 统一日志适配器：兼容 ChannelLogSink 与带 `log` 方法的 sink。
+ */
+/** ChannelLogSink 的 info/warn/error 方法接受单个 string */
+export function toLogger(sink) {
+    const prefix = "[xg_cwork_im]";
+    const s = sink;
+    const emitInfo = (msg) => {
+        if (typeof s?.info === "function") {
+            s.info(msg);
+            return;
+        }
+        if (typeof s?.log === "function") {
+            s.log(msg);
+            return;
+        }
+        console.log(`${prefix} ${msg}`);
+    };
+    const emitWarn = (msg) => {
+        if (typeof sink?.warn === "function") {
+            sink.warn(msg);
+            return;
+        }
+        console.warn(`${prefix} ${msg}`);
+    };
+    const emitError = (msg) => {
+        if (typeof sink?.error === "function") {
+            sink.error(msg);
+            return;
+        }
+        console.error(`${prefix} ${msg}`);
+    };
+    return {
+        info: emitInfo,
+        warn: emitWarn,
+        error: emitError,
+        debug: (msg) => {
+            if (typeof sink?.debug === "function")
+                sink.debug(msg);
+            else
+                emitInfo(msg);
+        },
+    };
+}
+//# sourceMappingURL=channel-log.js.map

package/dist/src/plugin/channel-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-log.js","sourceRoot":"","sources":["../../../src/plugin/channel-log.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,qDAAqD;AACrD,MAAM,UAAU,QAAQ,CACpB,IAEe;IAEf,MAAM,MAAM,GAAG,eAAe,CAAC;IAC/B,MAAM,CAAC,GAAG,IAAiF,CAAC;IAE5F,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAQ,EAAE;QACnC,IAAI,OAAO,CAAC,EAAE,IAAI,KAAK,UAAU,EAAE,CAAC;YAChC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACZ,OAAO;QACX,CAAC;QACD,IAAI,OAAO,CAAC,EAAE,GAAG,KAAK,UAAU,EAAE,CAAC;YAC/B,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACX,OAAO;QACX,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAQ,EAAE;QACnC,IAAI,OAAO,IAAI,EAAE,IAAI,KAAK,UAAU,EAAE,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACf,OAAO;QACX,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC;IACrC,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,GAAW,EAAQ,EAAE;QACpC,IAAI,OAAO,IAAI,EAAE,KAAK,KAAK,UAAU,EAAE,CAAC;YACpC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAChB,OAAO;QACX,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC;IAEF,OAAO;QACH,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE;YACX,IAAI,OAAO,IAAI,EAAE,KAAK,KAAK,UAAU;gBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;;gBAClD,QAAQ,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/src/plugin/channel.d.ts

@@ -0,0 +1,17 @@
+/**
+ * XG-IM Channel Plugin — 组装层
+ *
+ * 配置与解析见 channel-config.ts；入站正文见 inbound-display.ts；
+ * @ 后派发见 dispatch-mentioned-reply.ts（入站消息直投 OpenClaw，
+ * 忙碌排队/插话由 OpenClaw 原生 messages.queue 处理，见 docs/插件实现逻辑说明.md）。
+ * 单账号 WebSocket 连接运行见 account-connection.ts。
+ *
+ * 账号生命周期由 openclaw 8.1 框架驱动：注册本通道插件后，框架按账号调用
+ * gateway.startAccount（→ account-reconciler.startAccountLifecycle）并持有每账号
+ * AbortSignal；配置变更走 reload.configPrefixes + accountScopedRestart 做账号级
+ * stop→start。插件 register 不再自启连接，避免同账号重复 WebSocket。
+ */
+import type { PluginRuntime, XgImChannelPlugin } from "./types.js";
+export declare function setXgImRuntime(rt: PluginRuntime): void;
+export declare const xgCworkImChannelPlugin: XgImChannelPlugin;
+//# sourceMappingURL=channel.d.ts.map

package/dist/src/plugin/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../../src/plugin/channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAYH,OAAO,KAAK,EAAuB,aAAa,EAAmB,iBAAiB,EAAc,MAAM,YAAY,CAAC;AAMrH,wBAAgB,cAAc,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI,CAEtD;AAsSD,eAAO,MAAM,sBAAsB,EAGnB,iBAAiB,CAAC"}

package/dist/src/plugin/channel.js

@@ -0,0 +1,272 @@
+/**
+ * XG-IM Channel Plugin — 组装层
+ *
+ * 配置与解析见 channel-config.ts；入站正文见 inbound-display.ts；
+ * @ 后派发见 dispatch-mentioned-reply.ts（入站消息直投 OpenClaw，
+ * 忙碌排队/插话由 OpenClaw 原生 messages.queue 处理，见 docs/插件实现逻辑说明.md）。
+ * 单账号 WebSocket 连接运行见 account-connection.ts。
+ *
+ * 账号生命周期由 openclaw 8.1 框架驱动：注册本通道插件后，框架按账号调用
+ * gateway.startAccount（→ account-reconciler.startAccountLifecycle）并持有每账号
+ * AbortSignal；配置变更走 reload.configPrefixes + accountScopedRestart 做账号级
+ * stop→start。插件 register 不再自启连接，避免同账号重复 WebSocket。
+ */
+import { randomUUID } from "node:crypto";
+import { buildChannelConfigSchema } from "openclaw/plugin-sdk/core";
+import { getToken } from "./auth.js";
+import { getXgImConfig, isConfigured, XgImConfigSchema } from "./channel-config.js";
+import { toLogger } from "./channel-log.js";
+import { sendReplyDeliverBlock, sendTextMessage } from "../delivery/send-service.js";
+import { toolJsonResult } from "../tools/tool-json-result.js";
+import { accountReconciler } from "../connection/account-reconciler.js";
+// ─── 全局 Runtime（在 index.ts 的 register 中注入）────────────────────────────
+let xgImRuntime = null;
+export function setXgImRuntime(rt) {
+    xgImRuntime = rt;
+}
+const MESSAGE_ACTION_CHANNEL_PREFIX = "xg_cwork_im:";
+function actionFirstNonEmptyString(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+/** 从 message.action 参数中解析目标会话 ID（群/单聊共用 groupId）。 */
+function resolveActionSendTarget(params) {
+    for (const key of ["to", "target", "groupId", "gid", "chatId", "channelId", "conversationId"]) {
+        const raw = params[key];
+        const direct = actionFirstNonEmptyString(raw);
+        if (direct) {
+            return direct.startsWith(MESSAGE_ACTION_CHANNEL_PREFIX)
+                ? direct.slice(MESSAGE_ACTION_CHANNEL_PREFIX.length)
+                : direct;
+        }
+        if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+            const nested = raw;
+            const id = actionFirstNonEmptyString(nested.id ?? nested.groupId ?? nested.chatId ?? nested.conversationId);
+            if (id)
+                return id;
+        }
+    }
+    return undefined;
+}
+/** 从 message.action 参数中解析发送正文；模型可能用 message/text/content/SendMessage 等别名。 */
+function resolveActionSendText(params) {
+    for (const key of ["message", "text", "content", "body", "SendMessage"]) {
+        const value = actionFirstNonEmptyString(params[key]);
+        if (value)
+            return value;
+    }
+    return "";
+}
+function resolveActionSendAtUsers(params) {
+    for (const key of ["atUserIds", "atUsers"]) {
+        const raw = params[key];
+        if (!Array.isArray(raw))
+            continue;
+        const ids = raw
+            .map((entry) => (typeof entry === "string" ? entry.trim() : ""))
+            .filter((entry) => entry.length > 0);
+        if (ids.length > 0)
+            return ids;
+    }
+    return [];
+}
+/**
+ * 处理网关 message.action：
+ * - action != "send" → 明确不支持（supportsAction 在支持该字段的宿主上会先行拦下）。
+ * - dryRun 只做参数校验，不真正发送。
+ * - 发送成功/失败通过抛错或 ok 结果让宿主得到确定语义；不写任何会话去重状态。
+ */
+async function handleChannelMessageAction(ctx) {
+    const channel = "xg_cwork_im";
+    const log = toLogger(undefined);
+    if (String(ctx?.action ?? "") !== "send") {
+        throw new Error(`xg_cwork_im does not support message action "${String(ctx?.action ?? "")}"`);
+    }
+    const params = ctx?.params && typeof ctx.params === "object" && !Array.isArray(ctx.params)
+        ? ctx.params
+        : {};
+    const accountId = actionFirstNonEmptyString(ctx?.accountId ?? ctx?.requesterAccountId) ?? undefined;
+    const groupId = resolveActionSendTarget(params);
+    const text = resolveActionSendText(params);
+    const atUserIds = resolveActionSendAtUsers(params);
+    if (ctx?.dryRun === true) {
+        return toolJsonResult({
+            ok: true,
+            channel,
+            action: "send",
+            dryRun: true,
+            to: groupId ?? null,
+            textLen: text.length,
+        });
+    }
+    if (!groupId) {
+        throw new Error("xg_cwork_im action send requires a target groupId (params.to/groupId/target/chatId)");
+    }
+    if (!text) {
+        throw new Error("xg_cwork_im action send requires text content (params.message/text/content)");
+    }
+    if (!ctx?.cfg) {
+        throw new Error("xg_cwork_im action send missing runtime cfg");
+    }
+    try {
+        const config = getXgImConfig(ctx.cfg, accountId);
+        const identity = await getToken(config, log);
+        log.info(`[action] send via message.action to=${groupId} accountId=${accountId ?? "default"} textLen=${text.length}`);
+        await sendTextMessage(config, identity.token, groupId, text, atUserIds, log);
+        return toolJsonResult({
+            ok: true,
+            channel,
+            action: "send",
+            to: groupId,
+            sentBy: identity.userId,
+        });
+    }
+    catch (err) {
+        log.error(`[action] send failed to=${groupId} accountId=${accountId ?? "default"} err=${String(err)}`);
+        throw err;
+    }
+}
+function buildChannelMessageActions() {
+    return {
+        supportsAction: ({ action }) => action === "send",
+        handleAction: (ctx) => handleChannelMessageAction(ctx),
+    };
+}
+// ─── Channel Plugin 定义 ─────────────────────────────────────────────────────
+const xgCworkImChannelPluginBase = {
+    id: "xg_cwork_im",
+    meta: {
+        id: "xg_cwork_im",
+        label: "XG CWork IM",
+        selectionLabel: "XG CWork IM (工作说说)",
+        docsPath: "/channels/xg_cwork_im",
+        blurb: "工作说说 IM 机器人，通过 WebSocket 长连接接收 @ 消息。",
+        aliases: ["xg_cwork_im", "im"],
+    },
+    configSchema: buildChannelConfigSchema(XgImConfigSchema),
+    reload: {
+        configPrefixes: ["channels.xg_cwork_im"],
+        // openclaw 8.1+ 支持账号级 stop→start；SDK 类型尚未声明该字段，运行时属性存在即生效。
+        accountScopedRestart: true,
+    },
+    capabilities: {
+        chatTypes: ["direct", "group"],
+        reactions: false,
+        threads: false,
+        media: true,
+        nativeCommands: false,
+        blockStreaming: true,
+    },
+    config: {
+        listAccountIds: (cfg) => {
+            try {
+                const config = getXgImConfig(cfg);
+                const accounts = config.accounts;
+                if (accounts) {
+                    if (!Array.isArray(accounts) && typeof accounts === "object") {
+                        const keys = Object.keys(accounts).filter((k) => k !== "default");
+                        return keys;
+                    }
+                }
+                return isConfigured(cfg) ? ["default"] : [];
+            }
+            catch {
+                return [];
+            }
+        },
+        resolveAccount: (cfg, accountId) => {
+            const id = accountId || "default";
+            try {
+                const config = getXgImConfig(cfg, id);
+                return {
+                    accountId: id,
+                    config,
+                    enabled: config.enabled !== false,
+                    configured: Boolean((config.robotKey ?? config.appKey) && config.baseUrl),
+                    name: config.name ?? null,
+                };
+            }
+            catch {
+                return {
+                    accountId: id,
+                    config: {},
+                    enabled: false,
+                    configured: false,
+                    name: null,
+                };
+            }
+        },
+        defaultAccountId: () => "default",
+        isConfigured: (account) => account.configured,
+        describeAccount: (account) => ({
+            accountId: account.accountId,
+            name: account.config?.name ?? "xg_cwork_im",
+            enabled: account.enabled,
+            configured: account.configured,
+        }),
+    },
+    groups: {
+        resolveRequireMention: (params) => {
+            try {
+                const config = getXgImConfig(params.cfg, params.accountId);
+                return config?.groupPolicy !== "open";
+            }
+            catch {
+                return true;
+            }
+        },
+    },
+    outbound: {
+        deliveryMode: "direct",
+        resolveTarget: (params) => {
+            const trimmed = params.to?.trim();
+            if (!trimmed) {
+                return {
+                    ok: false,
+                    error: new Error("XG-IM message requires --to <groupId>"),
+                };
+            }
+            return { ok: true, to: trimmed };
+        },
+        sendText: async (ctx) => {
+            const { cfg, to, text, accountId, log: ctxLog } = ctx;
+            const log = toLogger(ctxLog);
+            const config = getXgImConfig(cfg, accountId);
+            const identity = await getToken(config, log);
+            await sendTextMessage(config, identity.token, to, text, [], log);
+            return {
+                channel: "xg_cwork_im",
+                messageId: randomUUID(),
+            };
+        },
+        sendMedia: async (ctx) => {
+            const { cfg, to, text, mediaUrl, accountId, log: ctxLog } = ctx;
+            const log = toLogger(ctxLog);
+            const config = getXgImConfig(cfg, accountId);
+            const identity = await getToken(config, log);
+            if (!mediaUrl?.trim()) {
+                await sendTextMessage(config, identity.token, to, text || "", [], log);
+                return { channel: "xg_cwork_im", messageId: randomUUID() };
+            }
+            await sendReplyDeliverBlock(config, identity.token, to, { text: text || "", mediaUrl: mediaUrl.trim() }, [], log, undefined, undefined);
+            return {
+                channel: "xg_cwork_im",
+                messageId: randomUUID(),
+            };
+        },
+    },
+    gateway: {
+        startAccount: async (ctx) => {
+            await accountReconciler.startAccountLifecycle(ctx);
+        },
+    },
+};
+// actions 属于 ChannelPlugin 的 message-action 面（宿主版本间字段/类型存在差异），
+// 通过 base + spread 合并，既能保留 base 的字面量类型校验，又避免 actions 类型代际差异破坏构建。
+export const xgCworkImChannelPlugin = {
+    ...xgCworkImChannelPluginBase,
+    actions: buildChannelMessageActions(),
+};
+//# sourceMappingURL=channel.js.map

package/dist/src/plugin/channel.js.map

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

package/dist/src/plugin/plugin-dispose.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 插件卸载/重载时的统一拆解入口。
+ *
+ * 语义（跨模块共享改造后）：
+ * - 真卸载 / gateway_stop：`disposePluginModule()`（skipConnections=false）——连同进程级共享的
+ *   account-reconciler 一起 stopAll，并清空全部共享内存态（连接/流客户端/会话上下文/轮次/去重/env/
+ *   subagent 监控）。由 index.ts 的 gateway_stop 钩子触发，且用 once 闸门保证只执行一次。
+ * - 插件热重载 / registry 代际交替：cleanup 以 `disposePluginModule({ skipConnections: true,
+ *   skipPlanResources: true })` 调用——只收尾可安全代际清理的句柄，保留动作读库与 plan-ws 路由，
+ *   **绝不 stopAll、绝不清理共享连接/内存态**。连接只在 AccountReconciler（配置 diff，账号级）
+ *   与 gateway_stop（进程停机）处拆解，避免 OpenClaw runtime 代际交替误拆全部 WebSocket。
+ */
+export interface DisposePluginModuleOptions {
+    /** 注册表代际交替（热重载）场景：只收尾独占句柄，跳过共享连接与共享内存态。 */
+    skipConnections?: boolean;
+    /** 注册表代际交替时保留计划读库、动作读库句柄与计划 WS 路由——这些资源仍被代际交替后
+     *  可能继续调用的旧中间件读取路径使用，清空会令反查在打开数据库前即失败；gateway_stop 使用默认 false 完整清理。 */
+    skipPlanResources?: boolean;
+}
+/** skipConnections=false（gateway_stop）时停连接+清共享态；true（cleanup）只收尾独占句柄。 */
+export declare function disposePluginModule(options?: DisposePluginModuleOptions): Promise<void>;
+//# sourceMappingURL=plugin-dispose.d.ts.map

package/dist/src/plugin/plugin-dispose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-dispose.d.ts","sourceRoot":"","sources":["../../../src/plugin/plugin-dispose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAqBH,MAAM,WAAW,0BAA0B;IACvC,2CAA2C;IAC3C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;2EACuE;IACvE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,yEAAyE;AACzE,wBAAsB,mBAAmB,CACrC,OAAO,GAAE,0BAA+B,GACzC,OAAO,CAAC,IAAI,CAAC,CAkCf"}

package/dist/src/plugin/plugin-dispose.js

@@ -0,0 +1,66 @@
+/**
+ * 插件卸载/重载时的统一拆解入口。
+ *
+ * 语义（跨模块共享改造后）：
+ * - 真卸载 / gateway_stop：`disposePluginModule()`（skipConnections=false）——连同进程级共享的
+ *   account-reconciler 一起 stopAll，并清空全部共享内存态（连接/流客户端/会话上下文/轮次/去重/env/
+ *   subagent 监控）。由 index.ts 的 gateway_stop 钩子触发，且用 once 闸门保证只执行一次。
+ * - 插件热重载 / registry 代际交替：cleanup 以 `disposePluginModule({ skipConnections: true,
+ *   skipPlanResources: true })` 调用——只收尾可安全代际清理的句柄，保留动作读库与 plan-ws 路由，
+ *   **绝不 stopAll、绝不清理共享连接/内存态**。连接只在 AccountReconciler（配置 diff，账号级）
+ *   与 gateway_stop（进程停机）处拆解，避免 OpenClaw runtime 代际交替误拆全部 WebSocket。
+ */
+import { accountReconciler } from "../connection/account-reconciler.js";
+import { disposeAssistantItemSinks } from "../delivery/assistant-item-sink.js";
+import { disposeActiveCronContextStore } from "../tools/active-cron-context-store.js";
+import { clearStreamClients } from "../connection/agent-stream-client-registry.js";
+import { disposeActiveRoundRegistry } from "../turn/active-round-registry.js";
+import { disposeActionStore } from "../plan/action-store-access.js";
+import { clearAllTokenCache } from "./auth.js";
+import { disposeCronAppKeyBindingStore } from "../tools/cron-appkey-binding-store.js";
+import { disposeGlobalTerminalSent } from "../delivery/inbound-terminal-state.js";
+import { clearSessionNasVolumeStates } from "../workspace/nas-volumes.js";
+import { clearAllPendingPerMessageModel } from "../session/per-message-model-pending.js";
+import { disposeSessionEnvStore } from "../session/session-env-store.js";
+import { disposePlanWsRegistry } from "../plan/plan-ws-registry.js";
+import { disposeSessionImContext } from "../session/session-im-context.js";
+import { clearAllSessionGroupPrompts } from "../session/session-group-prompt.js";
+import { disposeSubagentMonitor } from "../turn/subagent-monitor.js";
+import { disposeTurnAgentEvents } from "../turn/turn-agent-event-subscription.js";
+import { disposeTurnEndController } from "../turn/turn-end-controller.js";
+/** skipConnections=false（gateway_stop）时停连接+清共享态；true（cleanup）只收尾独占句柄。 */
+export async function disposePluginModule(options = {}) {
+    const { skipConnections = false } = options;
+    const { skipPlanResources = false } = options;
+    if (skipConnections) {
+        console.log(`[xg_cwork_im] [reload] disposePluginModule skipConnections=true ` +
+            `skipPlanResources=${skipPlanResources} (registry cycle)`);
+    }
+    else {
+        // gateway_stop：停共享连接 + 清空共享热路径内存态（含 subagent 监控 maps/ticker）。
+        await accountReconciler.stopAll("gateway-stop");
+        disposeSubagentMonitor();
+        disposeTurnAgentEvents();
+        disposeAssistantItemSinks();
+        disposeTurnEndController();
+        clearStreamClients();
+        disposeSessionImContext();
+        clearAllSessionGroupPrompts();
+        disposeActiveRoundRegistry();
+        disposeGlobalTerminalSent();
+        clearAllPendingPerMessageModel();
+        clearSessionNasVolumeStates();
+        disposeSessionEnvStore();
+        disposeActiveCronContextStore();
+        disposeCronAppKeyBindingStore();
+    }
+    // 动作读库与 plan-ws 路由可能被代际交替后仍在调用的旧中间件/旧发送路径继续使用：旧 cleanup 绝不能清空
+    // 它们的配置/句柄——action 若被清空，getActionById 会在打开数据库之前就因 stateDir 缺失而失败，
+    // 表现为「反查不到 action，跳过 ACTION_DISPATCH 发送」；gateway_stop（skipPlanResources=false）仍完整释放。
+    if (!skipPlanResources) {
+        disposeActionStore();
+        disposePlanWsRegistry();
+    }
+    clearAllTokenCache();
+}
+//# sourceMappingURL=plugin-dispose.js.map

package/dist/src/plugin/plugin-dispose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-dispose.js","sourceRoot":"","sources":["../../../src/plugin/plugin-dispose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AACnF,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AACtF,OAAO,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AAClF,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAClF,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAU1E,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACrC,UAAsC,EAAE;IAExC,MAAM,EAAE,eAAe,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAC5C,MAAM,EAAE,iBAAiB,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAC9C,IAAI,eAAe,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CACP,kEAAkE;YAC9D,qBAAqB,iBAAiB,mBAAmB,CAChE,CAAC;IACN,CAAC;SAAM,CAAC;QACJ,8DAA8D;QAC9D,MAAM,iBAAiB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAChD,sBAAsB,EAAE,CAAC;QACzB,sBAAsB,EAAE,CAAC;QACzB,yBAAyB,EAAE,CAAC;QAC5B,wBAAwB,EAAE,CAAC;QAC3B,kBAAkB,EAAE,CAAC;QACrB,uBAAuB,EAAE,CAAC;QAC1B,2BAA2B,EAAE,CAAC;QAC9B,0BAA0B,EAAE,CAAC;QAC7B,yBAAyB,EAAE,CAAC;QAC5B,8BAA8B,EAAE,CAAC;QACjC,2BAA2B,EAAE,CAAC;QAC9B,sBAAsB,EAAE,CAAC;QACzB,6BAA6B,EAAE,CAAC;QAChC,6BAA6B,EAAE,CAAC;IACpC,CAAC;IACD,8DAA8D;IAC9D,kEAAkE;IAClE,qFAAqF;IACrF,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACrB,kBAAkB,EAAE,CAAC;QACrB,qBAAqB,EAAE,CAAC;IAC5B,CAAC;IACD,kBAAkB,EAAE,CAAC;AACzB,CAAC"}

package/dist/src/plugin/process-shared-store.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 进程级共享存储（跨插件模块重载实例存活）。
+ *
+ * OpenClaw 热重载插件时会重新 import 插件模块 → 新模块作用域里的「模块级单例」与旧实例不互通，
+ * 旧模块由 registerRuntimeLifecycle cleanup 拆解。为了做到「WebSocket 连接与 runtime 不随模块
+ * 重建」，把必须在重载后仍存活的状态放到 globalThis（Symbol key），任何一代模块实例读写同一份。
+ *
+ * 用途：
+ * - 模块代际（epoch）：模块每次（重）import 时取号，register() 后 cleanup 据此判断「是否已有更新的
+ *   模块实例接管」，接管时不再拆连接。
+ * - runtime 持有：每次 register() 把最新 PluginRuntime 写入，连接派发时按需现取，避免绑定旧代际。
+ * - 通用 namespace：后续状态迁移（reconciler 等）统一放这里。
+ */
+export interface ProcessSharedStore {
+    /** 模块代际计数：每个模块实例在顶层（重）import 时递增取号（仅用于观测重载）。 */
+    moduleEpoch: number;
+    /** register() 序列：每次 register() 自增（仅观测用，不再作为 teardown 判定依据）。 */
+    registerSeq: number;
+    /** 当前生效的插件 runtime（每次 register() 覆盖）。 */
+    runtime: unknown;
+    /** 进程级共享命名空间（连接/reconciler 等状态）。 */
+    namespace: Record<string, unknown>;
+    /** gateway_stop 全量 teardown 只执行一次的闸门。 */
+    fullTeardownDone: boolean;
+}
+/** 模块实例顶层调用一次：领取一个全局单调递增的代际号（仅观测用）。 */
+export declare function nextModuleEpoch(): number;
+/** 读取当前最大的模块代际号。 */
+export declare function currentModuleEpoch(): number;
+/** register() 时调用：领取本次 register 的全局序列号。 */
+export declare function nextRegisterSeq(): number;
+/** 读取当前最大的 register 序列号。 */
+export declare function currentRegisterSeq(): number;
+/** 全量 teardown（gateway_stop）幂等闸门：首次调用返回 true，其后返回 false。 */
+export declare function requestFullTeardownOnce(): boolean;
+/** 出现新的 register() 时复位 teardown 闸门（允许下次停机再次 teardown）。 */
+export declare function resetFullTeardownGate(): void;
+/** register() 时写入最新 runtime（连接派发按需现取）。 */
+export declare function setSharedRuntime(rt: unknown): void;
+/** 读取当前最新 runtime。 */
+export declare function getSharedRuntime<T = unknown>(): T | undefined;
+/** 进程级 getOrCreate：跨模块重载共享单例（如 account-reconciler）。 */
+export declare function getOrCreateShared<T>(key: string, factory: () => T): T;
+/** 进程级共享 Map：跨模块重载共享状态（旧连接派发写入 / 新模块 hooks 读取同一份）。 */
+export declare function getSharedMap<K, V>(key: string): Map<K, V>;
+/** 仅供测试：整表重置（避免测试文件间串状态）。 */
+export declare function __resetProcessSharedStoreForTests(): void;
+//# sourceMappingURL=process-shared-store.d.ts.map

package/dist/src/plugin/process-shared-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-shared-store.d.ts","sourceRoot":"","sources":["../../../src/plugin/process-shared-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,WAAW,kBAAkB;IAC/B,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,yCAAyC;IACzC,gBAAgB,EAAE,OAAO,CAAC;CAC7B;AAkBD,uCAAuC;AACvC,wBAAgB,eAAe,IAAI,MAAM,CAIxC;AAED,oBAAoB;AACpB,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,2CAA2C;AAC3C,wBAAgB,eAAe,IAAI,MAAM,CAIxC;AAED,4BAA4B;AAC5B,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,4DAA4D;AAC5D,wBAAgB,uBAAuB,IAAI,OAAO,CAKjD;AAED,0DAA0D;AAC1D,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,0CAA0C;AAC1C,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAElD;AAED,sBAAsB;AACtB,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,GAAG,SAAS,CAE7D;AAED,uDAAuD;AACvD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAMrE;AAED,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAEzD;AAED,6BAA6B;AAC7B,wBAAgB,iCAAiC,IAAI,IAAI,CAKxD"}

package/dist/src/plugin/process-shared-store.js

@@ -0,0 +1,89 @@
+/**
+ * 进程级共享存储（跨插件模块重载实例存活）。
+ *
+ * OpenClaw 热重载插件时会重新 import 插件模块 → 新模块作用域里的「模块级单例」与旧实例不互通，
+ * 旧模块由 registerRuntimeLifecycle cleanup 拆解。为了做到「WebSocket 连接与 runtime 不随模块
+ * 重建」，把必须在重载后仍存活的状态放到 globalThis（Symbol key），任何一代模块实例读写同一份。
+ *
+ * 用途：
+ * - 模块代际（epoch）：模块每次（重）import 时取号，register() 后 cleanup 据此判断「是否已有更新的
+ *   模块实例接管」，接管时不再拆连接。
+ * - runtime 持有：每次 register() 把最新 PluginRuntime 写入，连接派发时按需现取，避免绑定旧代际。
+ * - 通用 namespace：后续状态迁移（reconciler 等）统一放这里。
+ */
+const STORE_KEY = Symbol.for("xg.im.processSharedStore");
+function ensureStore() {
+    const g = globalThis;
+    if (Object.hasOwn(g, STORE_KEY)) {
+        return g[STORE_KEY];
+    }
+    const created = {
+        moduleEpoch: 0,
+        registerSeq: 0,
+        runtime: undefined,
+        namespace: {},
+        fullTeardownDone: false,
+    };
+    g[STORE_KEY] = created;
+    return created;
+}
+/** 模块实例顶层调用一次：领取一个全局单调递增的代际号（仅观测用）。 */
+export function nextModuleEpoch() {
+    const store = ensureStore();
+    store.moduleEpoch += 1;
+    return store.moduleEpoch;
+}
+/** 读取当前最大的模块代际号。 */
+export function currentModuleEpoch() {
+    return ensureStore().moduleEpoch;
+}
+/** register() 时调用：领取本次 register 的全局序列号。 */
+export function nextRegisterSeq() {
+    const store = ensureStore();
+    store.registerSeq += 1;
+    return store.registerSeq;
+}
+/** 读取当前最大的 register 序列号。 */
+export function currentRegisterSeq() {
+    return ensureStore().registerSeq;
+}
+/** 全量 teardown（gateway_stop）幂等闸门：首次调用返回 true，其后返回 false。 */
+export function requestFullTeardownOnce() {
+    const store = ensureStore();
+    if (store.fullTeardownDone)
+        return false;
+    store.fullTeardownDone = true;
+    return true;
+}
+/** 出现新的 register() 时复位 teardown 闸门（允许下次停机再次 teardown）。 */
+export function resetFullTeardownGate() {
+    ensureStore().fullTeardownDone = false;
+}
+/** register() 时写入最新 runtime（连接派发按需现取）。 */
+export function setSharedRuntime(rt) {
+    ensureStore().runtime = rt;
+}
+/** 读取当前最新 runtime。 */
+export function getSharedRuntime() {
+    return ensureStore().runtime;
+}
+/** 进程级 getOrCreate：跨模块重载共享单例（如 account-reconciler）。 */
+export function getOrCreateShared(key, factory) {
+    const ns = ensureStore().namespace;
+    if (!Object.hasOwn(ns, key)) {
+        ns[key] = factory();
+    }
+    return ns[key];
+}
+/** 进程级共享 Map：跨模块重载共享状态（旧连接派发写入 / 新模块 hooks 读取同一份）。 */
+export function getSharedMap(key) {
+    return getOrCreateShared(`map:${key}`, () => new Map());
+}
+/** 仅供测试：整表重置（避免测试文件间串状态）。 */
+export function __resetProcessSharedStoreForTests() {
+    const g = globalThis;
+    if (Object.hasOwn(g, STORE_KEY)) {
+        delete g[STORE_KEY];
+    }
+}
+//# sourceMappingURL=process-shared-store.js.map

package/dist/src/plugin/process-shared-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-shared-store.js","sourceRoot":"","sources":["../../../src/plugin/process-shared-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AAezD,SAAS,WAAW;IAChB,MAAM,CAAC,GAAG,UAA0C,CAAC;IACrD,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,CAAC,SAAS,CAAuB,CAAC;IAC9C,CAAC;IACD,MAAM,OAAO,GAAuB;QAChC,WAAW,EAAE,CAAC;QACd,WAAW,EAAE,CAAC;QACd,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,EAAE;QACb,gBAAgB,EAAE,KAAK;KAC1B,CAAC;IACF,CAAC,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;IACvB,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,eAAe;IAC3B,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;IACvB,OAAO,KAAK,CAAC,WAAW,CAAC;AAC7B,CAAC;AAED,oBAAoB;AACpB,MAAM,UAAU,kBAAkB;IAC9B,OAAO,WAAW,EAAE,CAAC,WAAW,CAAC;AACrC,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,eAAe;IAC3B,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;IACvB,OAAO,KAAK,CAAC,WAAW,CAAC;AAC7B,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,kBAAkB;IAC9B,OAAO,WAAW,EAAE,CAAC,WAAW,CAAC;AACrC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,uBAAuB;IACnC,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,IAAI,KAAK,CAAC,gBAAgB;QAAE,OAAO,KAAK,CAAC;IACzC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAC9B,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,qBAAqB;IACjC,WAAW,EAAE,CAAC,gBAAgB,GAAG,KAAK,CAAC;AAC3C,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,gBAAgB,CAAC,EAAW;IACxC,WAAW,EAAE,CAAC,OAAO,GAAG,EAAE,CAAC;AAC/B,CAAC;AAED,sBAAsB;AACtB,MAAM,UAAU,gBAAgB;IAC5B,OAAO,WAAW,EAAE,CAAC,OAAwB,CAAC;AAClD,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,iBAAiB,CAAI,GAAW,EAAE,OAAgB;IAC9D,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC,SAAS,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC;QAC1B,EAAE,CAAC,GAAG,CAAC,GAAG,OAAO,EAAE,CAAC;IACxB,CAAC;IACD,OAAO,EAAE,CAAC,GAAG,CAAM,CAAC;AACxB,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,YAAY,CAAO,GAAW;IAC1C,OAAO,iBAAiB,CAAC,OAAO,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,EAAQ,CAAC,CAAC;AAClE,CAAC;AAED,6BAA6B;AAC7B,MAAM,UAAU,iCAAiC;IAC7C,MAAM,CAAC,GAAG,UAA0C,CAAC;IACrD,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC;AACL,CAAC"}

package/dist/src/plugin/process-shared-store.test.d.ts

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

package/dist/src/plugin/process-shared-store.test.d.ts.map

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