@xgjktech/xg_cwork_im 1.19.28 → 1.19.30

package/dist/src/agent-stream-client-registry.d.ts

@@ -0,0 +1,8 @@
+import type { ImStreamClient } from "./connection.js";
+export declare function registerStreamClient(agentId: string, client: ImStreamClient): void;
+export declare function getStreamClient(agentId: string): ImStreamClient | undefined;
+/** 仅当该 agentId 当前仍指向同一 client 时移除，避免误删其它账号注册的流客户端。 */
+export declare function deregisterStreamClient(agentId: string, client: ImStreamClient): void;
+/** 插件卸载/重载时清空流客户端登记表。 */
+export declare function clearStreamClients(): void;
+//# sourceMappingURL=agent-stream-client-registry.d.ts.map

package/dist/src/agent-stream-client-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-stream-client-registry.d.ts","sourceRoot":"","sources":["../../src/agent-stream-client-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAItD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAElF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE3E;AAED,sDAAsD;AACtD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAIpF;AAED,yBAAyB;AACzB,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/src/agent-stream-client-registry.js

@@ -0,0 +1,19 @@
+import { getSharedMap } from "./process-shared-store.js";
+const agentStreamClients = getSharedMap("agent-stream-clients");
+export function registerStreamClient(agentId, client) {
+    agentStreamClients.set(agentId, client);
+}
+export function getStreamClient(agentId) {
+    return agentStreamClients.get(agentId);
+}
+/** 仅当该 agentId 当前仍指向同一 client 时移除，避免误删其它账号注册的流客户端。 */
+export function deregisterStreamClient(agentId, client) {
+    if (agentStreamClients.get(agentId) === client) {
+        agentStreamClients.delete(agentId);
+    }
+}
+/** 插件卸载/重载时清空流客户端登记表。 */
+export function clearStreamClients() {
+    agentStreamClients.clear();
+}
+//# sourceMappingURL=agent-stream-client-registry.js.map

package/dist/src/agent-stream-client-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-stream-client-registry.js","sourceRoot":"","sources":["../../src/agent-stream-client-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,MAAM,kBAAkB,GAAG,YAAY,CAAyB,sBAAsB,CAAC,CAAC;AAExF,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,MAAsB;IAC1E,kBAAkB,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,MAAsB;IAC5E,IAAI,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC;QAC/C,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,yBAAyB;AACzB,MAAM,UAAU,kBAAkB;IAChC,kBAAkB,CAAC,KAAK,EAAE,CAAC;AAC7B,CAAC"}

package/dist/src/apply-sync-mapping.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 处理 IM WebSocket 下发的 openclawApplySyncMapping 信令。
+ */
+import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
+import type { Log } from "./auth.js";
+import type { XgImConfig } from "./types.js";
+export interface ApplySyncMappingContext {
+    config: XgImConfig;
+    cfg: OpenClawConfig;
+    rt: unknown;
+    log: Log;
+    logPrefix: string;
+}
+export declare function applySyncMappingFromWsParams(ctx: ApplySyncMappingContext, rawParams: unknown): Promise<void>;
+//# sourceMappingURL=apply-sync-mapping.d.ts.map

package/dist/src/apply-sync-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-sync-mapping.d.ts","sourceRoot":"","sources":["../../src/apply-sync-mapping.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAIrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK7C,MAAM,WAAW,uBAAuB;IACpC,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,EAAE,cAAc,CAAC;IACpB,EAAE,EAAE,OAAO,CAAC;IACZ,GAAG,EAAE,GAAG,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,4BAA4B,CAC9C,GAAG,EAAE,uBAAuB,EAC5B,SAAS,EAAE,OAAO,GACnB,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/dist/src/apply-sync-mapping.js

@@ -0,0 +1,98 @@
+/**
+ * 处理 IM WebSocket 下发的 openclawApplySyncMapping 信令。
+ */
+import { resolveAgentWorkspaceDir } from "openclaw/plugin-sdk/memory-core-host-engine-foundation";
+import { resolveLocalAbsolutePath, resolveRemoteRootForSync } from "./project-path-normalize.js";
+import { parseSyncMappingParams } from "./sync-mapping-types.js";
+import { deleteSyncMapping, upsertSyncMapping } from "./sync-service-client.js";
+const DEFAULT_FILE_PATTERNS = ["**/*"];
+const DEFAULT_EXCLUDE = ["**/_conflict_*", "**/.tmp/**", "**/.openclaw/**"];
+export async function applySyncMappingFromWsParams(ctx, rawParams) {
+    const { config, cfg, rt, log, logPrefix } = ctx;
+    const syncBase = config.syncServiceBaseUrl?.trim();
+    if (!syncBase) {
+        log.warn?.(`${logPrefix} [sync-mapping] received openclawApplySyncMapping but syncServiceBaseUrl is not configured; ignored`);
+        return;
+    }
+    let params;
+    try {
+        params = parseSyncMappingParams(rawParams);
+    }
+    catch (e) {
+        log.error(`${logPrefix} [sync-mapping] invalid params: ${String(e)}`);
+        return;
+    }
+    if (params.action === "delete") {
+        try {
+            await deleteSyncMapping(syncBase, params.mappingId, log);
+        }
+        catch (e) {
+            log.error(`${logPrefix} [sync-mapping] delete failed: ${String(e)}`);
+        }
+        return;
+    }
+    await applyUpsert(ctx, syncBase, params);
+}
+async function applyUpsert(ctx, syncBase, params) {
+    const { config, cfg, log, logPrefix } = ctx;
+    const localRoot = params.localRoot;
+    const agentId = config.agentId || "main";
+    let remoteRoot;
+    try {
+        remoteRoot = resolveRemoteRootForSync({
+            remoteRootFolderId: params.remoteRootFolderId,
+            remoteRootFolderPath: params.remoteRootFolderPath,
+        });
+    }
+    catch (e) {
+        log.error(`${logPrefix} [sync-mapping] remote root: ${String(e)}`);
+        return;
+    }
+    let workspaceHost;
+    if (localRoot.kind === "workspace_relative") {
+        try {
+            workspaceHost = resolveAgentWorkspaceDir(cfg, agentId);
+        }
+        catch (e) {
+            log.error(`${logPrefix} [sync-mapping] resolveAgentWorkspaceDir(agentId=${agentId}): ${String(e)}`);
+            return;
+        }
+    }
+    let resolvedLocalAbs;
+    try {
+        resolvedLocalAbs = resolveLocalAbsolutePath(localRoot, workspaceHost);
+    }
+    catch (e) {
+        log.error(`${logPrefix} [sync-mapping] resolve local path: ${String(e)}`);
+        return;
+    }
+    const syncOpts = params.sync;
+    const filePatterns = syncOpts?.filePatterns && syncOpts.filePatterns.length > 0 ? syncOpts.filePatterns : DEFAULT_FILE_PATTERNS;
+    const excludePatterns = syncOpts?.excludePatterns && syncOpts.excludePatterns.length > 0
+        ? syncOpts.excludePatterns
+        : DEFAULT_EXCLUDE;
+    const body = {
+        mappingId: params.mappingId,
+        localRoot: resolvedLocalAbs,
+        enabled: params.enabled ?? true,
+        appKey: params.appKey.trim(),
+        ...(remoteRoot.remoteRootFileId ? { remoteRootFileId: remoteRoot.remoteRootFileId } : {}),
+        ...(remoteRoot.remoteRootFolderPath ? { remoteRootFolderPath: remoteRoot.remoteRootFolderPath } : {}),
+        ...(params.kbProjectId?.trim() ? { projectId: params.kbProjectId.trim() } : {}),
+        filePatterns,
+        excludePatterns,
+        ...(syncOpts?.direction ? { syncDirection: syncOpts.direction } : {}),
+    };
+    const remoteLabel = remoteRoot.remoteRootFileId
+        ? `fileId=${remoteRoot.remoteRootFileId}` +
+            (remoteRoot.remoteRootFolderPath ? ` path=${remoteRoot.remoteRootFolderPath}` : "")
+        : `path=${remoteRoot.remoteRootFolderPath}`;
+    log.info(`${logPrefix} [sync-mapping] upsert mappingId=${params.mappingId} agentId=${agentId} workspaceHost=${workspaceHost ?? "(host_absolute)"} localRoot=${resolvedLocalAbs} remote=${remoteLabel}`);
+    try {
+        await upsertSyncMapping(syncBase, params.mappingId, body, log);
+    }
+    catch (e) {
+        log.error(`${logPrefix} [sync-mapping] upsert failed: ${String(e)}`);
+    }
+}
+//# sourceMappingURL=apply-sync-mapping.js.map

package/dist/src/apply-sync-mapping.js.map

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

package/dist/src/assistant-item-delivery.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 订阅 OpenClaw `assistant` 流，按「每条 assistant 消息(item)」逐条投递 IM。
+ *
+ * 与 block reply 分块路径不同：
+ * - 直接用 item 的完整 text（累计快照），不做分块拼接，天然保留段内换行；
+ * - 每条 assistant 消息一条 IM 消息（中间不同 item 也发）；
+ * - 不含 commentary（带 phase 的模型里 commentary 走 item/preamble，不会进 assistant）；
+ * - item 边界 = itemId 变化；最后一条在整轮 lifecycle 终态时 flush。
+ *
+ * 实际 HTTP 发送由 dispatch 注册的 sink 完成（持有 config/token/reply/终态/去重状态）。
+ */
+type AssistantItemEventData = {
+    text?: unknown;
+    delta?: unknown;
+    replace?: unknown;
+    phase?: unknown;
+    itemId?: unknown;
+};
+/** 处理一条 assistant agent event：累积当前 item，itemId 变化时把上一条交给 sink。 */
+export declare function handleAssistantItemEvent(sessionKey: string, data: AssistantItemEventData): void;
+/** flush 当前 item（整轮终态 / dispatch 收尾调用；返回 Promise 供收尾 await）。 */
+export declare function flushAssistantItem(sessionKey: string): Promise<void>;
+/** 清理会话状态（dispatch 结束时调用；清掉去重基线，避免跨轮误抑制）。 */
+export declare function resetAssistantItem(sessionKey: string): void;
+export declare function disposeAssistantItemDelivery(): void;
+export {};
+//# sourceMappingURL=assistant-item-delivery.d.ts.map

package/dist/src/assistant-item-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-item-delivery.d.ts","sourceRoot":"","sources":["../../src/assistant-item-delivery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,KAAK,sBAAsB,GAAG;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAoFF,kEAAkE;AAClE,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,GAAG,IAAI,CAoB/F;AAED,gEAAgE;AAChE,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW1E;AAED,6CAA6C;AAC7C,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAK3D;AAED,wBAAgB,4BAA4B,IAAI,IAAI,CAInD"}

package/dist/src/assistant-item-delivery.js

@@ -0,0 +1,134 @@
+/**
+ * 订阅 OpenClaw `assistant` 流，按「每条 assistant 消息(item)」逐条投递 IM。
+ *
+ * 与 block reply 分块路径不同：
+ * - 直接用 item 的完整 text（累计快照），不做分块拼接，天然保留段内换行；
+ * - 每条 assistant 消息一条 IM 消息（中间不同 item 也发）；
+ * - 不含 commentary（带 phase 的模型里 commentary 走 item/preamble，不会进 assistant）；
+ * - item 边界 = itemId 变化；最后一条在整轮 lifecycle 终态时 flush。
+ *
+ * 实际 HTTP 发送由 dispatch 注册的 sink 完成（持有 config/token/reply/终态/去重状态）。
+ */
+import { getAssistantItemSink } from "./assistant-item-sink.js";
+import { getSharedMap } from "./process-shared-store.js";
+const currentBySession = getSharedMap("assistant-item-current");
+const lastSentBySession = getSharedMap("assistant-item-last-sent");
+/** 每会话「在途 HTTP 发送」Promise 链：串行化同一会话的多条 item，并让收尾方 await 到全部在途发送。 */
+const inFlightBySession = getSharedMap("assistant-item-inflight");
+function isXgImGroupSessionKey(sessionKey) {
+    return sessionKey.startsWith("agent:") && sessionKey.includes(":xg_cwork_im:group:");
+}
+function normalizeComparable(text) {
+    return text.replace(/\s+/g, " ").trim();
+}
+function readString(value) {
+    return typeof value === "string" ? value : "";
+}
+/** 计算 item 的最新累计正文：优先接受增长型快照，其次 append delta。 */
+function resolveItemText(params) {
+    const { prevText, text, delta, replace } = params;
+    if (replace) {
+        return text;
+    }
+    if (!prevText) {
+        return text || prevText;
+    }
+    if (text && text.startsWith(prevText)) {
+        return text;
+    }
+    if (delta) {
+        return `${prevText}${delta}`;
+    }
+    return text || prevText;
+}
+function flushItem(sessionKey, state) {
+    currentBySession.delete(sessionKey);
+    const text = state.text.trim();
+    if (!text)
+        return Promise.resolve();
+    const sink = getAssistantItemSink(sessionKey);
+    if (!sink)
+        return Promise.resolve();
+    const comparable = normalizeComparable(text);
+    if (!comparable)
+        return Promise.resolve();
+    if (lastSentBySession.get(sessionKey) === comparable)
+        return Promise.resolve();
+    lastSentBySession.set(sessionKey, comparable);
+    // 串到本会话的在途链上：既保证同一会话多条 item 的顺序发送，也让收尾方
+    // （flushAssistantItem）能 await 到「item 边界 / lifecycle 触发但未 await」的在途发送，
+    // 避免终态判定与 WS FINISHED 抢在正文 HTTP 完成之前。
+    // 无在途前驱时同步触发 sink（保持既有「立即发出」语义），有前驱时才排队。
+    const invoke = () => {
+        try {
+            return Promise.resolve(sink(state.itemId, text));
+        }
+        catch (err) {
+            console.warn(`[xg_cwork_im] [assistant-item] sink failed: ${String(err)}`);
+            return Promise.resolve();
+        }
+    };
+    const previous = inFlightBySession.get(sessionKey);
+    const run = (previous ? previous.catch(() => { }).then(invoke) : invoke())
+        .catch((err) => {
+        console.warn(`[xg_cwork_im] [assistant-item] sink failed: ${String(err)}`);
+    })
+        .finally(() => {
+        if (inFlightBySession.get(sessionKey) === run) {
+            inFlightBySession.delete(sessionKey);
+        }
+    });
+    inFlightBySession.set(sessionKey, run);
+    return run;
+}
+/** 处理一条 assistant agent event：累积当前 item，itemId 变化时把上一条交给 sink。 */
+export function handleAssistantItemEvent(sessionKey, data) {
+    if (!sessionKey || !isXgImGroupSessionKey(sessionKey))
+        return;
+    const phase = readString(data.phase);
+    if (phase === "commentary")
+        return;
+    const itemId = readString(data.itemId);
+    if (!itemId)
+        return;
+    const text = readString(data.text);
+    const delta = readString(data.delta);
+    const replace = data.replace === true;
+    const current = currentBySession.get(sessionKey);
+    if (current && current.itemId !== itemId) {
+        void flushItem(sessionKey, current);
+    }
+    const base = currentBySession.get(sessionKey);
+    const prevText = base?.itemId === itemId ? base.text : "";
+    currentBySession.set(sessionKey, {
+        itemId,
+        text: resolveItemText({ prevText, text, delta, replace }),
+    });
+}
+/** flush 当前 item（整轮终态 / dispatch 收尾调用；返回 Promise 供收尾 await）。 */
+export async function flushAssistantItem(sessionKey) {
+    const current = currentBySession.get(sessionKey);
+    if (current) {
+        await flushItem(sessionKey, current);
+    }
+    // 当前 item 之外，可能还有 item 边界 / lifecycle 触发的在途发送未被 await，
+    // 必须一并等到，收尾判定才不会漏掉这批业务回复。
+    const inFlight = inFlightBySession.get(sessionKey);
+    if (inFlight) {
+        await inFlight;
+    }
+}
+/** 清理会话状态（dispatch 结束时调用；清掉去重基线，避免跨轮误抑制）。 */
+export function resetAssistantItem(sessionKey) {
+    if (!sessionKey)
+        return;
+    currentBySession.delete(sessionKey);
+    lastSentBySession.delete(sessionKey);
+    inFlightBySession.delete(sessionKey);
+}
+export function disposeAssistantItemDelivery() {
+    currentBySession.clear();
+    lastSentBySession.clear();
+    inFlightBySession.clear();
+}
+//# sourceMappingURL=assistant-item-delivery.js.map

package/dist/src/assistant-item-delivery.js.map

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

package/dist/src/assistant-item-delivery.test.d.ts

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

package/dist/src/assistant-item-delivery.test.d.ts.map

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

package/dist/src/assistant-item-delivery.test.js

@@ -0,0 +1,116 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { disposeAssistantItemDelivery, flushAssistantItem, handleAssistantItemEvent, resetAssistantItem, } from "./assistant-item-delivery.js";
+import { clearAssistantItemSink, setAssistantItemSink } from "./assistant-item-sink.js";
+const SESSION = "agent:main:xg_cwork_im:group:g1";
+function collectSink() {
+    const sent = [];
+    resetAssistantItem(SESSION);
+    setAssistantItemSink(SESSION, (itemId, text) => {
+        sent.push({ itemId, text });
+    });
+    return sent;
+}
+describe("assistant item delivery", () => {
+    it("sends one message per assistant item on item boundary", () => {
+        const sent = collectSink();
+        handleAssistantItemEvent(SESSION, { itemId: "i1", text: "第一段" });
+        handleAssistantItemEvent(SESSION, { itemId: "i1", text: "第一段\n\n第二段" });
+        handleAssistantItemEvent(SESSION, { itemId: "i2", text: "第三段" });
+        assert.deepEqual(sent, [{ itemId: "i1", text: "第一段\n\n第二段" }]);
+        return flushAssistantItem(SESSION).then(() => {
+            assert.deepEqual(sent, [
+                { itemId: "i1", text: "第一段\n\n第二段" },
+                { itemId: "i2", text: "第三段" },
+            ]);
+        });
+    });
+    it("skips commentary and non-xg sessions", async () => {
+        const sent = collectSink();
+        handleAssistantItemEvent(SESSION, { itemId: "c1", text: "我先看下", phase: "commentary" });
+        await flushAssistantItem(SESSION);
+        handleAssistantItemEvent("agent:main:other:group:g1", { itemId: "x1", text: "ignored" });
+        await flushAssistantItem("agent:main:other:group:g1");
+        assert.deepEqual(sent, []);
+    });
+    it("appends delta when snapshot does not extend previous", async () => {
+        const sent = collectSink();
+        handleAssistantItemEvent(SESSION, { itemId: "i1", text: "Hello" });
+        handleAssistantItemEvent(SESSION, { itemId: "i1", delta: " world" });
+        await flushAssistantItem(SESSION);
+        assert.deepEqual(sent, [{ itemId: "i1", text: "Hello world" }]);
+    });
+    it("replace resets the current item text", async () => {
+        const sent = collectSink();
+        handleAssistantItemEvent(SESSION, { itemId: "i1", text: "旧内容" });
+        handleAssistantItemEvent(SESSION, { itemId: "i1", text: "新内容", replace: true });
+        await flushAssistantItem(SESSION);
+        assert.deepEqual(sent, [{ itemId: "i1", text: "新内容" }]);
+    });
+    it("suppresses duplicate item text", async () => {
+        const sent = collectSink();
+        handleAssistantItemEvent(SESSION, { itemId: "i1", text: "同一条" });
+        await flushAssistantItem(SESSION);
+        handleAssistantItemEvent(SESSION, { itemId: "i2", text: "同一条" });
+        await flushAssistantItem(SESSION);
+        assert.equal(sent.length, 1);
+    });
+    it("reset clears dedup baseline", async () => {
+        const sent = collectSink();
+        handleAssistantItemEvent(SESSION, { itemId: "i1", text: "同一条" });
+        await flushAssistantItem(SESSION);
+        resetAssistantItem(SESSION);
+        handleAssistantItemEvent(SESSION, { itemId: "i2", text: "同一条" });
+        await flushAssistantItem(SESSION);
+        assert.equal(sent.length, 2);
+    });
+    it("awaits the sink promise so callers can flush before finalizing", async () => {
+        resetAssistantItem(SESSION);
+        const order = [];
+        setAssistantItemSink(SESSION, async () => {
+            await new Promise((resolve) => setTimeout(resolve, 5));
+            order.push("sink");
+        });
+        handleAssistantItemEvent(SESSION, { itemId: "i1", text: "正文" });
+        await flushAssistantItem(SESSION);
+        order.push("after");
+        assert.deepEqual(order, ["sink", "after"]);
+        clearAssistantItemSink(SESSION);
+        disposeAssistantItemDelivery();
+    });
+    it("waits for in-flight item-boundary sends before resolving flush", async () => {
+        resetAssistantItem(SESSION);
+        const tick = () => new Promise((resolve) => setImmediate(resolve));
+        const releases = [];
+        const started = [];
+        setAssistantItemSink(SESSION, (_itemId, text) => {
+            started.push(text);
+            return new Promise((resolve) => {
+                releases.push(resolve);
+            });
+        });
+        handleAssistantItemEvent(SESSION, { itemId: "i1", text: "第一段" });
+        // itemId 变化 → i1 的发送 fire-and-forget（在途，未被任何人 await）
+        handleAssistantItemEvent(SESSION, { itemId: "i2", text: "第二段" });
+        await tick();
+        assert.deepEqual(started, ["第一段"]);
+        let flushed = false;
+        const flushP = flushAssistantItem(SESSION).then(() => {
+            flushed = true;
+        });
+        await tick();
+        // i1 未释放前，flush 不能 resolve（且 i2 需等 i1 完成后再发）
+        assert.equal(flushed, false);
+        assert.deepEqual(started, ["第一段"]);
+        releases.shift()?.();
+        await tick();
+        assert.deepEqual(started, ["第一段", "第二段"]);
+        assert.equal(flushed, false);
+        releases.shift()?.();
+        await flushP;
+        assert.equal(flushed, true);
+        clearAssistantItemSink(SESSION);
+        disposeAssistantItemDelivery();
+    });
+});
+//# sourceMappingURL=assistant-item-delivery.test.js.map

package/dist/src/assistant-item-delivery.test.js.map

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

package/dist/src/assistant-item-sink.d.ts

@@ -0,0 +1,17 @@
+/**
+ * assistant item 投递回调注册表。
+ *
+ * `assistant` 流订阅按「每条 assistant 消息(item)」汇总正文；每条的 HTTP 投递由正在处理该
+ * 会话的 dispatch 负责（它持有 config/token/reply 元数据/终态控制器/去重状态）。订阅侧只做
+ * 「识别 item 边界 + 把完整正文交给 sink」，避免订阅模块自己重复持有鉴权与发送逻辑。
+ *
+ * sink 在 dispatch 开始时按 sessionKey 注册、结束时清除。
+ */
+/** 收到一条完整 assistant item 正文时的投递回调；可返回 Promise 供收尾时 await。 */
+export type AssistantItemSink = (itemId: string, text: string) => void | Promise<void>;
+export declare function setAssistantItemSink(sessionKey: string, sink: AssistantItemSink): void;
+export declare function getAssistantItemSink(sessionKey: string): AssistantItemSink | undefined;
+/** 清除 sink；传入 sink 时仅在仍是同引用时清除，避免误清新 dispatch 的注册。 */
+export declare function clearAssistantItemSink(sessionKey: string, sink?: AssistantItemSink): void;
+export declare function disposeAssistantItemSinks(): void;
+//# sourceMappingURL=assistant-item-sink.d.ts.map

package/dist/src/assistant-item-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-item-sink.d.ts","sourceRoot":"","sources":["../../src/assistant-item-sink.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,6DAA6D;AAC7D,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAIvF,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAGtF;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEtF;AAED,sDAAsD;AACtD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAMzF;AAED,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/src/assistant-item-sink.js

@@ -0,0 +1,34 @@
+/**
+ * assistant item 投递回调注册表。
+ *
+ * `assistant` 流订阅按「每条 assistant 消息(item)」汇总正文；每条的 HTTP 投递由正在处理该
+ * 会话的 dispatch 负责（它持有 config/token/reply 元数据/终态控制器/去重状态）。订阅侧只做
+ * 「识别 item 边界 + 把完整正文交给 sink」，避免订阅模块自己重复持有鉴权与发送逻辑。
+ *
+ * sink 在 dispatch 开始时按 sessionKey 注册、结束时清除。
+ */
+import { getSharedMap } from "./process-shared-store.js";
+const sinks = getSharedMap("assistant-item-sinks");
+export function setAssistantItemSink(sessionKey, sink) {
+    if (!sessionKey)
+        return;
+    sinks.set(sessionKey, sink);
+}
+export function getAssistantItemSink(sessionKey) {
+    return sessionKey ? sinks.get(sessionKey) : undefined;
+}
+/** 清除 sink；传入 sink 时仅在仍是同引用时清除，避免误清新 dispatch 的注册。 */
+export function clearAssistantItemSink(sessionKey, sink) {
+    if (!sessionKey)
+        return;
+    const current = sinks.get(sessionKey);
+    if (!current)
+        return;
+    if (sink && current !== sink)
+        return;
+    sinks.delete(sessionKey);
+}
+export function disposeAssistantItemSinks() {
+    sinks.clear();
+}
+//# sourceMappingURL=assistant-item-sink.js.map

package/dist/src/assistant-item-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-item-sink.js","sourceRoot":"","sources":["../../src/assistant-item-sink.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAKzD,MAAM,KAAK,GAAG,YAAY,CAA4B,sBAAsB,CAAC,CAAC;AAE9E,MAAM,UAAU,oBAAoB,CAAC,UAAkB,EAAE,IAAuB;IAC5E,IAAI,CAAC,UAAU;QAAE,OAAO;IACxB,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACnD,OAAO,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,sBAAsB,CAAC,UAAkB,EAAE,IAAwB;IAC/E,IAAI,CAAC,UAAU;QAAE,OAAO;IACxB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACtC,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,IAAI,IAAI,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO;IACrC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,yBAAyB;IACrC,KAAK,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC"}

package/dist/src/auth.d.ts

@@ -0,0 +1,32 @@
+/**
+ * XG-IM 认证模块
+ *
+ * 通过 robotKey（或兼容旧字段 appKey）换取 access_token 和机器人 userId。
+ *
+ * **缓存策略（进程内）**
+ * - 按 `baseUrl:robotKey` 缓存 `BotIdentity`；网关存活期间复用，避免每条消息重复调登录接口。
+ * - 网关重启后缓存清空，会重新 `getToken`（符合「重启拿新 token」的预期）。
+ * - IM 侧为滑动有效期（常用即续期，长期不用才过期）；插件不在本地做 TTL，持续使用同一缓存即可。
+ * - `clearTokenCache` 仅在网关停止等场景主动失效；不做磁盘持久化（避免 token 落盘风险）。
+ */
+import type { BotIdentity, XgImConfig } from "./types.js";
+export type Log = {
+    info: (msg: string) => void;
+    warn?: (msg: string) => void;
+    error: (msg: string) => void;
+    debug?: (msg: string) => void;
+};
+/**
+ * 通过 robotKey 获取机器人身份信息（token + userId）。
+ * 若缓存中已有有效 token，直接返回缓存；否则请求接口。
+ *
+ * @param config  插件配置
+ * @param log     日志接口
+ * @param force   强制重新获取（忽略缓存）
+ */
+export declare function getToken(config: XgImConfig, log?: Log, force?: boolean): Promise<BotIdentity>;
+/** 清除指定账户的 token 缓存（用于重连时强制重新鉴权） */
+export declare function clearTokenCache(config: XgImConfig): void;
+/** 插件卸载/重载时清空全部 token 缓存。 */
+export declare function clearAllTokenCache(): void;
+//# sourceMappingURL=auth.d.ts.map

package/dist/src/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAoB,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5E,MAAM,MAAM,GAAG,GAAG;IACd,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,CAAC;AAKF;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC1B,MAAM,EAAE,UAAU,EAClB,GAAG,CAAC,EAAE,GAAG,EACT,KAAK,UAAQ,GACd,OAAO,CAAC,WAAW,CAAC,CA4CtB;AAED,oCAAoC;AACpC,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAKxD;AAED,6BAA6B;AAC7B,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}