@xgjktech/xg_cwork_im 1.19.41 → 1.19.43

package/dist/src/subagent-monitor.test.js

@@ -0,0 +1,214 @@
+import assert from "node:assert/strict";
+import { afterEach, describe, it } from "node:test";
+import { __resetActiveRoundRegistryForTests, registerActiveRound } from "./active-round-registry.js";
+import { __resetSubagentMonitorForTests, __tickForTests, hasActiveSubagents, markSubagentCompleted, prepareSubagentInterrupt, setPluginApi, startMonitor, } from "./subagent-monitor.js";
+afterEach(() => {
+    __resetSubagentMonitorForTests();
+    __resetActiveRoundRegistryForTests();
+});
+function createClient(events) {
+    return {
+        start: async () => undefined,
+        streamProgress: async () => undefined,
+        streamUsage: async () => undefined,
+        sendEvent: async (event) => {
+            const list = event.data.subagentList ?? [];
+            events.push(`SUBAGENT_STAT:${list.map((s) => `${s.runId}:${s.status}`).join(",") || "(empty)"}`);
+        },
+        end: async (reason) => {
+            events.push(`FINISHED:${reason}`);
+        },
+    };
+}
+function createPluginApi(overrides) {
+    return {
+        runtime: {
+            subagent: {
+                waitForRun: overrides.waitForRun ?? (async () => ({ status: "timeout" })),
+                getSessionMessages: overrides.getSessionMessages ?? (async () => ({ messages: [] })),
+            },
+        },
+    };
+}
+function setupRound(events) {
+    const client = createClient(events);
+    const round = registerActiveRound({
+        accountId: "account-a",
+        groupId: "group-1",
+        agentId: "main",
+        sessionKey: "session-1",
+        replyToMsgId: "reply-1",
+        streamClient: client,
+    });
+    return { round, client };
+}
+function spawnParams(round, client, childSessionKey, runId) {
+    return {
+        roundKey: round.roundKey,
+        generation: round.generation,
+        groupId: round.groupId,
+        agentId: round.agentId,
+        streamClient: client,
+        replyToMsgId: round.replyToMsgId,
+        spawn: { childSessionKey, runId },
+    };
+}
+const settle = () => new Promise((resolve) => setImmediate(resolve));
+describe("subagent-monitor completion matching", () => {
+    it("subagent_ended runId 与 spawn 不一致时仍按 childSessionKey 完成", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        assert.equal(startMonitor(spawnParams(round, client, "child-1", "run-1")), true);
+        events.length = 0;
+        markSubagentCompleted("child-1", "run-2");
+        await settle();
+        assert.deepEqual(events, ["SUBAGENT_STAT:run-1:completed"]);
+        assert.equal(hasActiveSubagents(round.roundKey, round.generation), false);
+    });
+    it("subagent_ended 缺失 runId 时按 childSessionKey 完成", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        startMonitor(spawnParams(round, client, "child-1", "run-1"));
+        events.length = 0;
+        markSubagentCompleted("child-1", undefined);
+        await settle();
+        assert.deepEqual(events, ["SUBAGENT_STAT:run-1:completed"]);
+        assert.equal(hasActiveSubagents(round.roundKey, round.generation), false);
+    });
+    it("中断后同 childSessionKey 重新 spawn（新 runId）的结束事件不被 tombstone 误挡", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        assert.equal(startMonitor(spawnParams(round, client, "child-1", "run-1")), true);
+        prepareSubagentInterrupt(round.roundKey, round.generation);
+        events.length = 0;
+        const round2 = registerActiveRound({
+            accountId: "account-a",
+            groupId: "group-2",
+            agentId: "main",
+            sessionKey: "session-1",
+            replyToMsgId: "reply-1",
+            streamClient: client,
+        });
+        assert.equal(startMonitor(spawnParams(round2, client, "child-1", "run-2")), true);
+        events.length = 0;
+        markSubagentCompleted("child-1", "run-2");
+        await settle();
+        assert.deepEqual(events, ["SUBAGENT_STAT:run-2:completed"]);
+        assert.equal(hasActiveSubagents(round2.roundKey, round2.generation), false);
+    });
+    it("中断后被中断旧 run 的迟到结束事件不会完成新 record", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        assert.equal(startMonitor(spawnParams(round, client, "child-1", "run-1")), true);
+        prepareSubagentInterrupt(round.roundKey, round.generation);
+        const round2 = registerActiveRound({
+            accountId: "account-a",
+            groupId: "group-2",
+            agentId: "main",
+            sessionKey: "session-1",
+            replyToMsgId: "reply-1",
+            streamClient: client,
+        });
+        assert.equal(startMonitor(spawnParams(round2, client, "child-1", "run-2")), true);
+        events.length = 0;
+        markSubagentCompleted("child-1", "run-1");
+        await settle();
+        assert.equal(events.some((e) => e.includes(":completed")), false);
+        assert.equal(hasActiveSubagents(round2.roundKey, round2.generation), true);
+    });
+});
+describe("subagent-monitor tick reconciliation", () => {
+    it("waitForRun 返回 ok → 标记完成并收口", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        setPluginApi(createPluginApi({
+            waitForRun: async () => ({ status: "ok" }),
+        }));
+        startMonitor(spawnParams(round, client, "child-1", "run-1"));
+        events.length = 0;
+        await __tickForTests();
+        assert.ok(events.some((e) => e === "SUBAGENT_STAT:run-1:completed"));
+        assert.equal(hasActiveSubagents(round.roundKey, round.generation), false);
+    });
+    it("waitForRun 返回 timeout → 保持 running 且不收口", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        setPluginApi(createPluginApi({
+            waitForRun: async () => ({ status: "timeout" }),
+        }));
+        startMonitor(spawnParams(round, client, "child-1", "run-1"));
+        events.length = 0;
+        await __tickForTests();
+        assert.ok(events.some((e) => e === "SUBAGENT_STAT:run-1:running"));
+        assert.equal(hasActiveSubagents(round.roundKey, round.generation), true);
+    });
+    it("getSessionMessages 抛错 → tick 不被拖垮，仍发 stat 且保持 running", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        setPluginApi(createPluginApi({
+            getSessionMessages: async () => {
+                throw new Error("Plugin runtime subagent methods are only available during a gateway request.");
+            },
+            waitForRun: async () => ({ status: "timeout" }),
+        }));
+        startMonitor(spawnParams(round, client, "child-1", "run-1"));
+        events.length = 0;
+        await __tickForTests();
+        assert.ok(events.some((e) => e === "SUBAGENT_STAT:run-1:running"));
+        assert.equal(hasActiveSubagents(round.roundKey, round.generation), true);
+    });
+    it("waitForRun 返回 error → 标记完成并收口", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        setPluginApi(createPluginApi({
+            waitForRun: async () => ({ status: "error", error: "boom" }),
+        }));
+        startMonitor(spawnParams(round, client, "child-1", "run-1"));
+        events.length = 0;
+        await __tickForTests();
+        assert.ok(events.some((e) => e === "SUBAGENT_STAT:run-1:completed"));
+        assert.equal(hasActiveSubagents(round.roundKey, round.generation), false);
+    });
+    it("waitForRun 抛异常 → 保持 running，由事件路径兜底", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        setPluginApi(createPluginApi({
+            waitForRun: async () => {
+                throw new Error("run not found");
+            },
+        }));
+        startMonitor(spawnParams(round, client, "child-1", "run-1"));
+        events.length = 0;
+        await __tickForTests();
+        assert.equal(hasActiveSubagents(round.roundKey, round.generation), true);
+        markSubagentCompleted("child-1", "run-1");
+        await settle();
+        assert.equal(hasActiveSubagents(round.roundKey, round.generation), false);
+    });
+    it("多 subagent 的 waitForRun 探测并发执行（互不阻塞累加）", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        let inFlight = 0;
+        let maxInFlight = 0;
+        setPluginApi(createPluginApi({
+            waitForRun: async () => {
+                inFlight += 1;
+                maxInFlight = Math.max(maxInFlight, inFlight);
+                await new Promise((resolve) => setTimeout(resolve, 20));
+                inFlight -= 1;
+                return { status: "timeout" };
+            },
+        }));
+        startMonitor(spawnParams(round, client, "child-1", "run-1"));
+        startMonitor(spawnParams(round, client, "child-2", "run-2"));
+        events.length = 0;
+        // startMonitor 会触发一次立即 tick（fire-and-forget），先等它跑完再单独测量。
+        await new Promise((resolve) => setTimeout(resolve, 30));
+        inFlight = 0;
+        maxInFlight = 0;
+        await __tickForTests();
+        assert.equal(maxInFlight, 2);
+        assert.equal(hasActiveSubagents(round.roundKey, round.generation), true);
+    });
+});
+//# sourceMappingURL=subagent-monitor.test.js.map

package/dist/src/subagent-monitor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-monitor.test.js","sourceRoot":"","sources":["../../src/subagent-monitor.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAEpD,OAAO,EAAE,kCAAkC,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAErG,OAAO,EACH,8BAA8B,EAC9B,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,wBAAwB,EACxB,YAAY,EACZ,YAAY,GACf,MAAM,uBAAuB,CAAC;AAE/B,SAAS,CAAC,GAAG,EAAE;IACX,8BAA8B,EAAE,CAAC;IACjC,kCAAkC,EAAE,CAAC;AACzC,CAAC,CAAC,CAAC;AAIH,SAAS,YAAY,CAAC,MAAgB;IAClC,OAAO;QACH,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;QAC5B,cAAc,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;QACrC,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;QAClC,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvB,MAAM,IAAI,GAAI,KAAK,CAAC,IAAI,CAAC,YAAyD,IAAI,EAAE,CAAC;YACzF,MAAM,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC;QACrG,CAAC;QACD,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YAClB,MAAM,CAAC,IAAI,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC;QACtC,CAAC;KACJ,CAAC;AACN,CAAC;AAED,SAAS,eAAe,CAAC,SAGxB;IACG,OAAO;QACH,OAAO,EAAE;YACL,QAAQ,EAAE;gBACN,UAAU,EAAE,SAAS,CAAC,UAAU,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;gBACzE,kBAAkB,EAAE,SAAS,CAAC,kBAAkB,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;aACvF;SACJ;KAC4B,CAAC;AACtC,CAAC;AAED,SAAS,UAAU,CAAC,MAAgB;IAChC,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,mBAAmB,CAAC;QAC9B,SAAS,EAAE,WAAW;QACtB,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,MAAM;QACf,UAAU,EAAE,WAAW;QACvB,YAAY,EAAE,SAAS;QACvB,YAAY,EAAE,MAAM;KACvB,CAAC,CAAC;IACH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC;AAED,SAAS,WAAW,CAAC,KAA6C,EAAE,MAAsB,EAAE,eAAuB,EAAE,KAAa;IAC9H,OAAO;QACH,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,YAAY,EAAE,MAAM;QACpB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,KAAK,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE;KACpC,CAAC;AACN,CAAC;AAED,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AAE3E,QAAQ,CAAC,sCAAsC,EAAE,GAAG,EAAE;IAClD,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACjF,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAElB,qBAAqB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,MAAM,EAAE,CAAC;QAEf,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,+BAA+B,CAAC,CAAC,CAAC;QAC5D,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAC7C,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAElB,qBAAqB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC5C,MAAM,MAAM,EAAE,CAAC;QAEf,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,+BAA+B,CAAC,CAAC,CAAC;QAC5D,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACjF,wBAAwB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAC3D,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAElB,MAAM,MAAM,GAAG,mBAAmB,CAAC;YAC/B,SAAS,EAAE,WAAW;YACtB,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE,MAAM;YACf,UAAU,EAAE,WAAW;YACvB,YAAY,EAAE,SAAS;YACvB,YAAY,EAAE,MAAM;SACvB,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAClF,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAElB,qBAAqB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,MAAM,EAAE,CAAC;QAEf,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,+BAA+B,CAAC,CAAC,CAAC;QAC5D,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACjF,wBAAwB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAE3D,MAAM,MAAM,GAAG,mBAAmB,CAAC;YAC/B,SAAS,EAAE,WAAW;YACtB,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE,MAAM;YACf,UAAU,EAAE,WAAW;YACvB,YAAY,EAAE,SAAS;YACvB,YAAY,EAAE,MAAM;SACvB,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAClF,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAElB,qBAAqB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,MAAM,EAAE,CAAC;QAEf,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAClE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,sCAAsC,EAAE,GAAG,EAAE;IAClD,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;QACxC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAC7C,YAAY,CACR,eAAe,CAAC;YACZ,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;SAC7C,CAAC,CACL,CAAC;QACF,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAElB,MAAM,cAAc,EAAE,CAAC;QAEvB,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,+BAA+B,CAAC,CAAC,CAAC;QACrE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAC7C,YAAY,CACR,eAAe,CAAC;YACZ,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;SAClD,CAAC,CACL,CAAC;QACF,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAElB,MAAM,cAAc,EAAE,CAAC;QAEvB,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,6BAA6B,CAAC,CAAC,CAAC;QACnE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAC7C,YAAY,CACR,eAAe,CAAC;YACZ,kBAAkB,EAAE,KAAK,IAAI,EAAE;gBAC3B,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;YACpG,CAAC;YACD,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;SAClD,CAAC,CACL,CAAC;QACF,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAElB,MAAM,cAAc,EAAE,CAAC;QAEvB,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,6BAA6B,CAAC,CAAC,CAAC;QACnE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAC7C,YAAY,CACR,eAAe,CAAC;YACZ,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;SAC/D,CAAC,CACL,CAAC;QACF,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAElB,MAAM,cAAc,EAAE,CAAC;QAEvB,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,+BAA+B,CAAC,CAAC,CAAC;QACrE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAC7C,YAAY,CACR,eAAe,CAAC;YACZ,UAAU,EAAE,KAAK,IAAI,EAAE;gBACnB,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;YACrC,CAAC;SACJ,CAAC,CACL,CAAC;QACF,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAElB,MAAM,cAAc,EAAE,CAAC;QAEvB,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;QAEzE,qBAAqB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,MAAM,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,YAAY,CACR,eAAe,CAAC;YACZ,UAAU,EAAE,KAAK,IAAI,EAAE;gBACnB,QAAQ,IAAI,CAAC,CAAC;gBACd,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;gBAC9C,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;gBAC9D,QAAQ,IAAI,CAAC,CAAC;gBACd,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YACjC,CAAC;SACJ,CAAC,CACL,CAAC;QACF,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7D,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAElB,yDAAyD;QACzD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QAC9D,QAAQ,GAAG,CAAC,CAAC;QACb,WAAW,GAAG,CAAC,CAAC;QAEhB,MAAM,cAAc,EAAE,CAAC;QAEvB,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,220 @@
+/**
+ * IM → OpenClaw：目录同步映射 WebSocket 信令（openclawApplySyncMapping）
+ */
+import { z } from "zod";
+/** 与 openclaw-xgkb-sync `syncDirection` 一致（MANAGEMENT_API.md） */
+export declare const SYNC_DIRECTIONS: readonly ["bidirectional", "push", "pull"];
+export type SyncDirection = (typeof SYNC_DIRECTIONS)[number];
+/** IM 信令：localRoot 统一为 { kind, path } */
+declare const localRootSchema: z.ZodObject<{
+    kind: z.ZodEnum<["workspace_relative", "host_absolute"]>;
+    path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "workspace_relative" | "host_absolute";
+    path: string;
+}, {
+    kind: "workspace_relative" | "host_absolute";
+    path: string;
+}>;
+declare const upsertParamsSchema: z.ZodObject<{
+    action: z.ZodLiteral<"upsert">;
+    mappingId: z.ZodString;
+    appKey: z.ZodString;
+    localRoot: z.ZodObject<{
+        kind: z.ZodEnum<["workspace_relative", "host_absolute"]>;
+        path: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "workspace_relative" | "host_absolute";
+        path: string;
+    }, {
+        kind: "workspace_relative" | "host_absolute";
+        path: string;
+    }>;
+    /** 知识库目录 fileId；与 remoteRootFolderPath 二选一，优先使用本字段 */
+    remoteRootFolderId: z.ZodOptional<z.ZodString>;
+    /** 知识库内逻辑路径；remoteRootFolderId 未填时必填 */
+    remoteRootFolderPath: z.ZodOptional<z.ZodString>;
+    kbProjectId: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    sync: z.ZodOptional<z.ZodObject<{
+        direction: z.ZodOptional<z.ZodEnum<["bidirectional", "push", "pull"]>>;
+        filePatterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        excludePatterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        direction?: "push" | "bidirectional" | "pull" | undefined;
+        filePatterns?: string[] | undefined;
+        excludePatterns?: string[] | undefined;
+    }, {
+        direction?: "push" | "bidirectional" | "pull" | undefined;
+        filePatterns?: string[] | undefined;
+        excludePatterns?: string[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    localRoot: {
+        kind: "workspace_relative" | "host_absolute";
+        path: string;
+    };
+    appKey: string;
+    action: "upsert";
+    mappingId: string;
+    remoteRootFolderPath?: string | undefined;
+    enabled?: boolean | undefined;
+    remoteRootFolderId?: string | undefined;
+    kbProjectId?: string | undefined;
+    sync?: {
+        direction?: "push" | "bidirectional" | "pull" | undefined;
+        filePatterns?: string[] | undefined;
+        excludePatterns?: string[] | undefined;
+    } | undefined;
+}, {
+    localRoot: {
+        kind: "workspace_relative" | "host_absolute";
+        path: string;
+    };
+    appKey: string;
+    action: "upsert";
+    mappingId: string;
+    remoteRootFolderPath?: string | undefined;
+    enabled?: boolean | undefined;
+    remoteRootFolderId?: string | undefined;
+    kbProjectId?: string | undefined;
+    sync?: {
+        direction?: "push" | "bidirectional" | "pull" | undefined;
+        filePatterns?: string[] | undefined;
+        excludePatterns?: string[] | undefined;
+    } | undefined;
+}>;
+declare const deleteParamsSchema: z.ZodObject<{
+    action: z.ZodLiteral<"delete">;
+    mappingId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    action: "delete";
+    mappingId: string;
+}, {
+    action: "delete";
+    mappingId: string;
+}>;
+export declare const syncMappingParamsSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
+    action: z.ZodLiteral<"upsert">;
+    mappingId: z.ZodString;
+    appKey: z.ZodString;
+    localRoot: z.ZodObject<{
+        kind: z.ZodEnum<["workspace_relative", "host_absolute"]>;
+        path: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "workspace_relative" | "host_absolute";
+        path: string;
+    }, {
+        kind: "workspace_relative" | "host_absolute";
+        path: string;
+    }>;
+    /** 知识库目录 fileId；与 remoteRootFolderPath 二选一，优先使用本字段 */
+    remoteRootFolderId: z.ZodOptional<z.ZodString>;
+    /** 知识库内逻辑路径；remoteRootFolderId 未填时必填 */
+    remoteRootFolderPath: z.ZodOptional<z.ZodString>;
+    kbProjectId: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    sync: z.ZodOptional<z.ZodObject<{
+        direction: z.ZodOptional<z.ZodEnum<["bidirectional", "push", "pull"]>>;
+        filePatterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        excludePatterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        direction?: "push" | "bidirectional" | "pull" | undefined;
+        filePatterns?: string[] | undefined;
+        excludePatterns?: string[] | undefined;
+    }, {
+        direction?: "push" | "bidirectional" | "pull" | undefined;
+        filePatterns?: string[] | undefined;
+        excludePatterns?: string[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    localRoot: {
+        kind: "workspace_relative" | "host_absolute";
+        path: string;
+    };
+    appKey: string;
+    action: "upsert";
+    mappingId: string;
+    remoteRootFolderPath?: string | undefined;
+    enabled?: boolean | undefined;
+    remoteRootFolderId?: string | undefined;
+    kbProjectId?: string | undefined;
+    sync?: {
+        direction?: "push" | "bidirectional" | "pull" | undefined;
+        filePatterns?: string[] | undefined;
+        excludePatterns?: string[] | undefined;
+    } | undefined;
+}, {
+    localRoot: {
+        kind: "workspace_relative" | "host_absolute";
+        path: string;
+    };
+    appKey: string;
+    action: "upsert";
+    mappingId: string;
+    remoteRootFolderPath?: string | undefined;
+    enabled?: boolean | undefined;
+    remoteRootFolderId?: string | undefined;
+    kbProjectId?: string | undefined;
+    sync?: {
+        direction?: "push" | "bidirectional" | "pull" | undefined;
+        filePatterns?: string[] | undefined;
+        excludePatterns?: string[] | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"delete">;
+    mappingId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    action: "delete";
+    mappingId: string;
+}, {
+    action: "delete";
+    mappingId: string;
+}>]>, {
+    localRoot: {
+        kind: "workspace_relative" | "host_absolute";
+        path: string;
+    };
+    appKey: string;
+    action: "upsert";
+    mappingId: string;
+    remoteRootFolderPath?: string | undefined;
+    enabled?: boolean | undefined;
+    remoteRootFolderId?: string | undefined;
+    kbProjectId?: string | undefined;
+    sync?: {
+        direction?: "push" | "bidirectional" | "pull" | undefined;
+        filePatterns?: string[] | undefined;
+        excludePatterns?: string[] | undefined;
+    } | undefined;
+} | {
+    action: "delete";
+    mappingId: string;
+}, {
+    localRoot: {
+        kind: "workspace_relative" | "host_absolute";
+        path: string;
+    };
+    appKey: string;
+    action: "upsert";
+    mappingId: string;
+    remoteRootFolderPath?: string | undefined;
+    enabled?: boolean | undefined;
+    remoteRootFolderId?: string | undefined;
+    kbProjectId?: string | undefined;
+    sync?: {
+        direction?: "push" | "bidirectional" | "pull" | undefined;
+        filePatterns?: string[] | undefined;
+        excludePatterns?: string[] | undefined;
+    } | undefined;
+} | {
+    action: "delete";
+    mappingId: string;
+}>;
+export type SyncMappingParams = z.infer<typeof syncMappingParamsSchema>;
+export type SyncMappingUpsertParams = z.infer<typeof upsertParamsSchema>;
+export type SyncMappingDeleteParams = z.infer<typeof deleteParamsSchema>;
+export type SyncMappingLocalRoot = z.infer<typeof localRootSchema>;
+export declare function parseSyncMappingParams(raw: unknown): SyncMappingParams;
+export {};
+//# sourceMappingURL=sync-mapping-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync-mapping-types.d.ts","sourceRoot":"","sources":["../../src/sync-mapping-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,iEAAiE;AACjE,eAAO,MAAM,eAAe,4CAA6C,CAAC;AAC1E,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAU7D,yCAAyC;AACzC,QAAA,MAAM,eAAe;;;;;;;;;EAGnB,CAAC;AAEH,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;IAKpB,sDAAsD;;IAEtD,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK1C,CAAC;AAEH,QAAA,MAAM,kBAAkB;;;;;;;;;EAGtB,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;IAdhC,sDAAsD;;IAEtD,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyBtC,CAAC;AAEP,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACzE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACzE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAEnE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB,CAEtE"}

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

@@ -0,0 +1,55 @@
+/**
+ * IM → OpenClaw：目录同步映射 WebSocket 信令（openclawApplySyncMapping）
+ */
+import { z } from "zod";
+import { LOCAL_ROOT_KINDS } from "./project-path-normalize.js";
+/** 与 openclaw-xgkb-sync `syncDirection` 一致（MANAGEMENT_API.md） */
+export const SYNC_DIRECTIONS = ["bidirectional", "push", "pull"];
+const syncOptionsSchema = z
+    .object({
+    direction: z.enum(SYNC_DIRECTIONS).optional(),
+    filePatterns: z.array(z.string().min(1)).optional(),
+    excludePatterns: z.array(z.string().min(1)).optional(),
+})
+    .optional();
+/** IM 信令：localRoot 统一为 { kind, path } */
+const localRootSchema = z.object({
+    kind: z.enum(LOCAL_ROOT_KINDS),
+    path: z.string().min(1),
+});
+const upsertParamsSchema = z.object({
+    action: z.literal("upsert"),
+    mappingId: z.string().min(1),
+    appKey: z.string().min(1),
+    localRoot: localRootSchema,
+    /** 知识库目录 fileId；与 remoteRootFolderPath 二选一，优先使用本字段 */
+    remoteRootFolderId: z.string().min(1).optional(),
+    /** 知识库内逻辑路径；remoteRootFolderId 未填时必填 */
+    remoteRootFolderPath: z.string().min(1).optional(),
+    kbProjectId: z.string().min(1).optional(),
+    enabled: z.boolean().optional(),
+    sync: syncOptionsSchema,
+});
+const deleteParamsSchema = z.object({
+    action: z.literal("delete"),
+    mappingId: z.string().min(1),
+});
+export const syncMappingParamsSchema = z
+    .discriminatedUnion("action", [upsertParamsSchema, deleteParamsSchema])
+    .superRefine((data, ctx) => {
+    if (data.action !== "upsert")
+        return;
+    const hasId = Boolean(data.remoteRootFolderId?.trim());
+    const hasPath = Boolean(data.remoteRootFolderPath?.trim());
+    if (!hasId && !hasPath) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "remoteRootFolderId 与 remoteRootFolderPath 至少填一个",
+            path: ["remoteRootFolderId"],
+        });
+    }
+});
+export function parseSyncMappingParams(raw) {
+    return syncMappingParamsSchema.parse(raw);
+}
+//# sourceMappingURL=sync-mapping-types.js.map

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

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

package/dist/src/sync-service-client.d.ts

@@ -0,0 +1,29 @@
+/**
+ * openclaw-xgkb-sync 管理 API 客户端（见 github-openclaw-xgkb-sync/docs/MANAGEMENT_API.md）
+ */
+import type { Log } from "./auth.js";
+import type { SyncDirection } from "./sync-mapping-types.js";
+export interface SyncMappingUpsertBody {
+    mappingId: string;
+    localRoot: string;
+    enabled?: boolean;
+    appKey: string;
+    projectId?: string;
+    /** 知识库远端根目录 fileId（IM 信令 remoteRootFolderId 映射而来） */
+    remoteRootFileId?: string;
+    remoteRootFolderPath?: string;
+    filePatterns?: string[];
+    excludePatterns?: string[];
+    syncDirection?: SyncDirection;
+}
+/** PUT /mappings/:id 成功响应（见 MANAGEMENT_API.md §5） */
+export interface SyncMappingUpsertResult {
+    created: boolean;
+    changed?: string[];
+}
+/**
+ * PUT /mappings/{mappingId} — 同步服务官方 upsert：不存在则创建（201），存在则部分合并更新（200）。
+ */
+export declare function upsertSyncMapping(baseUrl: string, mappingId: string, body: SyncMappingUpsertBody, log?: Log): Promise<SyncMappingUpsertResult>;
+export declare function deleteSyncMapping(baseUrl: string, mappingId: string, log?: Log): Promise<void>;
+//# sourceMappingURL=sync-service-client.d.ts.map

package/dist/src/sync-service-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-service-client.d.ts","sourceRoot":"","sources":["../../src/sync-service-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAC;CACjC;AAuBD,qDAAqD;AACrD,MAAM,WAAW,uBAAuB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACnC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,qBAAqB,EAC3B,GAAG,CAAC,EAAE,GAAG,GACV,OAAO,CAAC,uBAAuB,CAAC,CAyClC;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAapG"}

package/dist/src/sync-service-client.js

@@ -0,0 +1,72 @@
+/**
+ * openclaw-xgkb-sync 管理 API 客户端（见 github-openclaw-xgkb-sync/docs/MANAGEMENT_API.md）
+ */
+function trimBaseUrl(baseUrl) {
+    return baseUrl.trim().replace(/\/+$/, "");
+}
+async function readJson(res) {
+    const text = await res.text();
+    if (!text)
+        return {};
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return { raw: text };
+    }
+}
+function errorMessage(body, status) {
+    if (body && typeof body === "object" && "error" in body && typeof body.error === "string") {
+        return body.error;
+    }
+    return `HTTP ${status}`;
+}
+/**
+ * PUT /mappings/{mappingId} — 同步服务官方 upsert：不存在则创建（201），存在则部分合并更新（200）。
+ */
+export async function upsertSyncMapping(baseUrl, mappingId, body, log) {
+    const base = trimBaseUrl(baseUrl);
+    const encodedId = encodeURIComponent(mappingId);
+    const url = `${base}/mappings/${encodedId}`;
+    const payload = { ...body, mappingId };
+    const res = await fetch(url, {
+        method: "PUT",
+        headers: { "Content-Type": "application/json; charset=utf-8" },
+        body: JSON.stringify(payload),
+    });
+    const json = await readJson(res);
+    // 成功：201 新建、200 更新（含「无字段变化、跳过重载」）
+    if (res.status !== 200 && res.status !== 201) {
+        const msg = errorMessage(json, res.status);
+        log?.error?.(`[sync] PUT ${url} failed (${res.status}): ${msg}`);
+        throw new Error(`同步映射 upsert 失败: ${msg}`);
+    }
+    const created = json &&
+        typeof json === "object" &&
+        "created" in json &&
+        typeof json.created === "boolean"
+        ? json.created
+        : res.status === 201;
+    const changed = json &&
+        typeof json === "object" &&
+        Array.isArray(json.changed)
+        ? (json.changed ?? [])
+        : undefined;
+    log?.info?.(`[sync] mapping upsert ok mappingId=${mappingId} created=${created} localRoot=${body.localRoot}` +
+        (changed && changed.length > 0 ? ` changed=[${changed.join(",")}]` : ""));
+    return { created, changed };
+}
+export async function deleteSyncMapping(baseUrl, mappingId, log) {
+    const base = trimBaseUrl(baseUrl);
+    const encodedId = encodeURIComponent(mappingId);
+    const url = `${base}/mappings/${encodedId}`;
+    const res = await fetch(url, { method: "DELETE" });
+    const json = await readJson(res);
+    if (!res.ok) {
+        const msg = errorMessage(json, res.status);
+        log?.error?.(`[sync] DELETE ${url} failed: ${msg}`);
+        throw new Error(`同步映射删除失败: ${msg}`);
+    }
+    log?.info?.(`[sync] mapping deleted mappingId=${mappingId}`);
+}
+//# sourceMappingURL=sync-service-client.js.map

package/dist/src/sync-service-client.js.map

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

package/dist/src/thinking-ws-progress.d.ts

@@ -0,0 +1,24 @@
+/** WS `displayText` 对 thinking 的上限（trim + 长度封顶，不做语义改写） */
+export declare const WS_THINKING_DISPLAY_MAX = 2000;
+/** `RUN_EVENT.data.summary`：IM 用其识别「同一条用户指令的输出位」内的 thinking 片段（非新聊天气泡） */
+export declare const THINKING_WS_SUMMARY_HINT = "thinking";
+/**
+ * 将 OpenClaw thinking 文本转为 WS displayText（trim + 长度封顶，不做语义改写）。
+ */
+export declare function clipThinkingForWsDisplay(text: string, max?: number): string;
+/** 仅在裁剪后的 displayText 变化时发送，避免重复 WS。 */
+export declare function resolveThinkingWsDisplayUpdate(lastDisplayed: string, thinkingText: string, max?: number): {
+    displayText: string;
+    changed: boolean;
+};
+/**
+ * 单段 thinking：`onReasoningStream` 只累积，块结束再发 **一条** WS。
+ * （不做 token 级流式拆分，避免 IM 侧出现多条「输出」。）
+ */
+export declare class ThinkingWsBuffer {
+    private buffer;
+    noteStream(text: string): void;
+    /** 取出当前缓冲并清空；无内容时返回 undefined。 */
+    take(): string | undefined;
+}
+//# sourceMappingURL=thinking-ws-progress.d.ts.map

package/dist/src/thinking-ws-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinking-ws-progress.d.ts","sourceRoot":"","sources":["../../src/thinking-ws-progress.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,0EAA0E;AAC1E,eAAO,MAAM,wBAAwB,aAAa,CAAC;AAEnD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAA0B,GAAG,MAAM,CAK5F;AAED,wCAAwC;AACxC,wBAAgB,8BAA8B,CAC1C,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,GAAG,SAA0B,GAC9B;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAK3C;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,MAAM,CAAM;IAEpB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK9B,kCAAkC;IAClC,IAAI,IAAI,MAAM,GAAG,SAAS;CAM7B"}