@xgjktech/xg_cwork_im 1.19.21 → 1.19.23

package/dist/src/connection/connection.test.js

@@ -0,0 +1,126 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { buildBeginPayload, buildFinishedPayload, buildProgressPayload, buildRunUsagePayload, buildSendEventPayload, RUN_USAGE_DELTA_EVENT, } from "./connection.js";
+/**
+ * WS `im_stream_msg` 出站契约（前端逐字节依赖，改造/重构不得破坏）：
+ * cmd 恒为 `im_stream_msg`；params.event 为事件名；params.data 字段序固定。
+ * 以下断言 JSON.stringify 后的字节，字段顺序变化会立即失败。
+ */
+function wire(payload) {
+    return JSON.stringify(payload);
+}
+describe("WS im_stream_msg payload builders (frontend wire contract)", () => {
+    it("BEGIN 载荷字节与字段顺序稳定", () => {
+        const p = buildBeginPayload({ groupId: "g-1", replyToMsgId: "msg-1" });
+        assert.notEqual(p, null);
+        assert.equal(wire(p), '{"cmd":"im_stream_msg","params":{"event":"BEGIN","data":{"groupId":"g-1","replyToMsgId":"msg-1","toUserId":null}}}');
+    });
+    it("BEGIN 缺锚点时不发（返回 null）", () => {
+        assert.equal(buildBeginPayload({ groupId: "g-1" }), null);
+        assert.equal(buildBeginPayload({ groupId: "", replyToMsgId: "msg-1" }), null);
+        assert.equal(buildBeginPayload({}), null);
+    });
+    it("BEGIN 的 groupId/replyToMsgId 会 trim", () => {
+        const p = buildBeginPayload({ groupId: "  g-1  ", replyToMsgId: "  msg-1 " });
+        assert.equal(wire(p), '{"cmd":"im_stream_msg","params":{"event":"BEGIN","data":{"groupId":"g-1","replyToMsgId":"msg-1","toUserId":null}}}');
+    });
+    it("TOOL_PHASE / RUN_EVENT 进度载荷：data 字段序 groupId→replyToMsgId→displayText→summary", () => {
+        const p = buildProgressPayload({
+            groupId: "g-1",
+            replyToMsgId: "msg-1",
+            event: "RUN_EVENT",
+            displayText: "正在调用「工具」…",
+            summary: "run cmd (in wd)",
+        });
+        assert.notEqual(p, null);
+        assert.equal(p.params.event, "RUN_EVENT");
+        assert.equal(wire(p), '{"cmd":"im_stream_msg","params":{"event":"RUN_EVENT","data":{"groupId":"g-1","replyToMsgId":"msg-1","displayText":"正在调用「工具」…","summary":"run cmd (in wd)"}}}');
+    });
+    it("进度载荷缺 displayText / 锚点时返回 null", () => {
+        assert.equal(buildProgressPayload({ groupId: "g-1", replyToMsgId: "m", event: "RUN_EVENT", displayText: "   " }), null);
+        assert.equal(buildProgressPayload({ groupId: "g-1", replyToMsgId: "", event: "RUN_EVENT", displayText: "x" }), null);
+    });
+    it("进度 summary 超过 200 字截断并以 … 结尾（无 summary 时 data 不含该键）", () => {
+        const short = buildProgressPayload({
+            groupId: "g-1",
+            replyToMsgId: "m",
+            event: "TOOL_PHASE",
+            displayText: "x",
+        });
+        assert.equal("summary" in short.params.data, false);
+        const raw = "s".repeat(205);
+        const p = buildProgressPayload({
+            groupId: "g-1",
+            replyToMsgId: "m",
+            event: "TOOL_PHASE",
+            displayText: "x",
+            summary: raw,
+        });
+        const summary = p.params.data.summary;
+        assert.equal(summary.length, 200);
+        assert.equal(summary.endsWith("…"), true);
+        assert.equal(summary.slice(0, 199), "s".repeat(199));
+    });
+    it("RUN_USAGE 载荷：event=RUN_USAGE，usage 原样内嵌（键序保持 source 在前）", () => {
+        const p = buildRunUsagePayload({
+            groupId: "g-1",
+            replyToMsgId: "msg-1",
+            usage: {
+                source: "session",
+                provider: "anthropic",
+                model: "claude-sonnet",
+                modelRef: "anthropic/claude-sonnet",
+                inputTokens: 100,
+                outputTokens: 50,
+                totalTokens: 150,
+                runId: "run-1",
+            },
+        });
+        assert.notEqual(p, null);
+        assert.equal(wire(p), '{"cmd":"im_stream_msg","params":{"event":"RUN_USAGE","data":{"groupId":"g-1","replyToMsgId":"msg-1","usage":{"source":"session","provider":"anthropic","model":"claude-sonnet","modelRef":"anthropic/claude-sonnet","inputTokens":100,"outputTokens":50,"totalTokens":150,"runId":"run-1"}}}}');
+    });
+    it("RUN_USAGE_DELTA 载荷：event=RUN_USAGE_DELTA，data 字段序 groupId→replyToMsgId→runId→lifecycleGeneration→outputTokens", () => {
+        const p = buildSendEventPayload({
+            groupId: "g-1",
+            replyToMsgId: "msg-1",
+            event: RUN_USAGE_DELTA_EVENT,
+            data: {
+                groupId: "g-1",
+                replyToMsgId: "msg-1",
+                runId: "run-1",
+                lifecycleGeneration: "gen-1",
+                outputTokens: 120,
+            },
+        });
+        assert.notEqual(p, null);
+        assert.equal(wire(p), '{"cmd":"im_stream_msg","params":{"event":"RUN_USAGE_DELTA","data":{"groupId":"g-1","replyToMsgId":"msg-1","runId":"run-1","lifecycleGeneration":"gen-1","outputTokens":120}}}');
+    });
+    it("sendEvent 自定义事件：groupId/replyToMsgId 先于透传 data；data 展开覆盖顺序稳定", () => {
+        const p = buildSendEventPayload({
+            groupId: "g-1",
+            replyToMsgId: "msg-1",
+            event: "SUBAGENT_STAT",
+            data: { subagentList: [{ runId: "r1", status: "running", messages: [] }] },
+        });
+        assert.notEqual(p, null);
+        assert.equal(wire(p), '{"cmd":"im_stream_msg","params":{"event":"SUBAGENT_STAT","data":{"groupId":"g-1","replyToMsgId":"msg-1","subagentList":[{"runId":"r1","status":"running","messages":[]}]}}}');
+    });
+    it("sendEvent data 展开位于 groupId/replyToMsgId 之后（现有语义：重叠键会被 data 覆盖，调用方不传重叠键）", () => {
+        const p = buildSendEventPayload({
+            groupId: "g-1",
+            replyToMsgId: "msg-1",
+            event: "X",
+            data: { groupId: "g-hack" },
+        });
+        assert.equal(p.params.data.groupId, "g-hack");
+        assert.equal(p.params.data.replyToMsgId, "msg-1");
+    });
+    it("FINISHED 载荷：event=FINISHED，reason 原样透传", () => {
+        const p = buildFinishedPayload("stop", { groupId: "g-1", replyToMsgId: "msg-1" });
+        assert.notEqual(p, null);
+        assert.equal(wire(p), '{"cmd":"im_stream_msg","params":{"event":"FINISHED","data":{"groupId":"g-1","replyToMsgId":"msg-1","reason":"stop"}}}');
+        assert.equal(buildFinishedPayload("aborted", {}), null);
+        assert.equal(buildFinishedPayload("stop"), null);
+    });
+});
+//# sourceMappingURL=connection.test.js.map

package/dist/src/connection/connection.test.js.map

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

package/dist/src/connection/ws-inbound-schema.d.ts

@@ -0,0 +1,14 @@
+/**
+ * WebSocket 入站 robotMention / groupMessage 结构校验。
+ */
+import type { WsMessage } from "../plugin/types.js";
+export type ParseWsInboundResult = {
+    ok: true;
+    message: WsMessage;
+} | {
+    ok: false;
+    error: string;
+};
+/** 校验 IM WebSocket 入站信封；失败时返回可读错误（不含原始 payload）。 */
+export declare function parseWsInboundMessage(raw: unknown): ParseWsInboundResult;
+//# sourceMappingURL=ws-inbound-schema.d.ts.map

package/dist/src/connection/ws-inbound-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-inbound-schema.d.ts","sourceRoot":"","sources":["../../../src/connection/ws-inbound-schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAmDpD,MAAM,MAAM,oBAAoB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,SAAS,CAAA;CAAE,GAChC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC,oDAAoD;AACpD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,oBAAoB,CAkBxE"}

package/dist/src/connection/ws-inbound-schema.js

@@ -0,0 +1,68 @@
+/**
+ * WebSocket 入站 robotMention / groupMessage 结构校验。
+ */
+import { z } from "zod";
+const msgFileVOSchema = z
+    .object({
+    url: z.string().optional(),
+    format: z.string().optional(),
+    source: z.string().optional(),
+    fileId: z.string().optional(),
+    size: z.number().optional(),
+    name: z.string().optional(),
+    content: z.string().optional(),
+    download: z.union([z.boolean(), z.string(), z.number()]).optional(),
+})
+    .passthrough();
+const msgContentSchema = z
+    .object({
+    type: z.string().min(1, "msgContent.type is required"),
+    text: z.string().optional(),
+    files: z.array(msgFileVOSchema).optional(),
+    ext: z.record(z.unknown()).optional(),
+})
+    .passthrough();
+const userInfoSchema = z.object({
+    id: z.string().min(1, "userInfo.id is required"),
+    name: z.string().optional(),
+    background: z.string().optional(),
+    appKey: z.string().optional(),
+});
+const wsMessageParamsSchema = z
+    .object({
+    msgId: z.string().min(1, "msgId is required"),
+    groupId: z.string().min(1, "groupId is required"),
+    userInfo: userInfoSchema,
+    msgContent: msgContentSchema,
+    agentContext: z.unknown().optional(),
+    msgSendTime: z.number().optional(),
+    timestamp: z.number().optional(),
+    mentions: z.array(z.union([z.string(), z.number()])).nullable().optional(),
+    chatType: z.string().optional(),
+})
+    .passthrough();
+const wsInboundEnvelopeSchema = z.object({
+    cmd: z.enum(["robotMention", "groupMessage"]),
+    params: wsMessageParamsSchema,
+    ts: z.number().optional(),
+});
+/** 校验 IM WebSocket 入站信封；失败时返回可读错误（不含原始 payload）。 */
+export function parseWsInboundMessage(raw) {
+    const parsed = wsInboundEnvelopeSchema.safeParse(raw);
+    if (!parsed.success) {
+        const issue = parsed.error.issues[0];
+        const path = issue?.path?.length ? issue.path.join(".") : "payload";
+        const detail = issue?.message ?? parsed.error.message;
+        return { ok: false, error: `${path}: ${detail}` };
+    }
+    const { cmd, params, ts } = parsed.data;
+    return {
+        ok: true,
+        message: {
+            cmd,
+            params: params,
+            ts: typeof ts === "number" ? ts : Date.now(),
+        },
+    };
+}
+//# sourceMappingURL=ws-inbound-schema.js.map

package/dist/src/connection/ws-inbound-schema.js.map

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

package/dist/src/connection/ws-inbound-schema.test.d.ts

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

package/dist/src/connection/ws-inbound-schema.test.d.ts.map

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

package/dist/src/connection/ws-inbound-schema.test.js

@@ -0,0 +1,58 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { parseWsInboundMessage } from "./ws-inbound-schema.js";
+const base = {
+    cmd: "robotMention",
+    params: {
+        msgId: "msg-1",
+        groupId: "group-1",
+        userInfo: { id: "user-1", name: "张三" },
+        msgContent: { type: "text", text: "hi" },
+    },
+};
+describe("ws-inbound-schema userInfo.appKey", () => {
+    it("解析 appKey", () => {
+        const result = parseWsInboundMessage({
+            ...base,
+            params: {
+                ...base.params,
+                userInfo: { id: "user-1", name: "张三", appKey: "app-key-123" },
+            },
+        });
+        assert.equal(result.ok, true);
+        if (result.ok) {
+            assert.equal(result.message.params.userInfo.appKey, "app-key-123");
+        }
+    });
+    it("缺失 appKey 时为 undefined", () => {
+        const result = parseWsInboundMessage(base);
+        assert.equal(result.ok, true);
+        if (result.ok) {
+            assert.equal(result.message.params.userInfo.appKey, undefined);
+        }
+    });
+    it("空字符串 appKey 解析为空字符串", () => {
+        const result = parseWsInboundMessage({
+            ...base,
+            params: {
+                ...base.params,
+                userInfo: { id: "user-1", name: "张三", appKey: "" },
+            },
+        });
+        assert.equal(result.ok, true);
+        if (result.ok) {
+            assert.equal(result.message.params.userInfo.appKey, "");
+        }
+    });
+    it("非字符串 appKey 校验失败", () => {
+        const result = parseWsInboundMessage({
+            ...base,
+            params: {
+                ...base.params,
+                userInfo: { id: "user-1", name: "张三", appKey: 123 },
+            },
+        });
+        assert.equal(result.ok, false);
+    });
+});
+//# sourceMappingURL=ws-inbound-schema.test.js.map

package/dist/src/connection/ws-inbound-schema.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-inbound-schema.test.js","sourceRoot":"","sources":["../../../src/connection/ws-inbound-schema.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,IAAI,GAAG;IACT,GAAG,EAAE,cAAc;IACnB,MAAM,EAAE;QACJ,KAAK,EAAE,OAAO;QACd,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE;QACtC,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE;KAC3C;CACJ,CAAC;AAEF,QAAQ,CAAC,mCAAmC,EAAE,GAAG,EAAE;IAC/C,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE;QACjB,MAAM,MAAM,GAAG,qBAAqB,CAAC;YACjC,GAAG,IAAI;YACP,MAAM,EAAE;gBACJ,GAAG,IAAI,CAAC,MAAM;gBACd,QAAQ,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE;aAChE;SACJ,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9B,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QACvE,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAC9B,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9B,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACnE,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC3B,MAAM,MAAM,GAAG,qBAAqB,CAAC;YACjC,GAAG,IAAI;YACP,MAAM,EAAE;gBACJ,GAAG,IAAI,CAAC,MAAM;gBACd,QAAQ,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;aACrD;SACJ,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9B,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC5D,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;QACxB,MAAM,MAAM,GAAG,qBAAqB,CAAC;YACjC,GAAG,IAAI;YACP,MAAM,EAAE;gBACJ,GAAG,IAAI,CAAC,MAAM;gBACd,QAAQ,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;aACtD;SACJ,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/src/delivery/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/delivery/assistant-item-delivery.d.ts.map

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

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

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

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

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

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

package/dist/src/delivery/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/delivery/assistant-item-delivery.test.js.map

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

package/dist/src/delivery/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