@xopcai/xopc 0.0.83 → 0.0.85

package/dist/extensions/telegram/src/workflow-progress.js

@@ -0,0 +1,73 @@
+import { init_session_key, parseSessionKey } from "../../../src/routing/session-key.js";
+import { createLogger } from "../../../src/utils/logger/index.js";
+import { init_logger } from "../../../src/utils/logger.js";
+//#region extensions/telegram/src/workflow-progress.ts
+init_session_key();
+init_logger();
+const log = createLogger("TelegramWorkflowProgress");
+/** Telegram bot API: 4096 char hard cap; leave 96 chars of headroom for re-renders. */
+const TELEGRAM_TEXT_MAX = 4e3;
+/** Telegram bot edit rate ≈ 1/s per chat; broker default 5 s leaves ample headroom. */
+const DEFAULT_THROTTLE_MS = 5e3;
+function createTelegramWorkflowProgressCapability(accountManager) {
+	return {
+		channelId: "telegram",
+		supportsEdit: true,
+		defaultThrottleMs: DEFAULT_THROTTLE_MS,
+		defaultMode: "edit",
+		async postProgress(input) {
+			const target = resolveTarget(input.sessionKey);
+			if (!target) throw new Error(`telegram workflow progress: cannot route sessionKey "${input.sessionKey}"`);
+			const bot = accountManager.getBot(target.accountId);
+			if (!bot) throw new Error(`telegram workflow progress: no bot for accountId "${target.accountId}" (sessionKey "${input.sessionKey}")`);
+			const text = clampForTelegram(input.text);
+			if (input.previousMessageId && !input.isFinal) try {
+				await bot.api.editMessageText(target.chatId, Number(input.previousMessageId), text);
+				return { messageId: input.previousMessageId };
+			} catch (err) {
+				if (isMessageNotModified(err)) return { messageId: input.previousMessageId };
+				if (isEditTargetGone(err)) log.debug({
+					sessionKey: input.sessionKey,
+					previousMessageId: input.previousMessageId
+				}, "edit target gone; falling back to sendMessage");
+				else throw err;
+			}
+			const sent = await bot.api.sendMessage(target.chatId, text, {
+				message_thread_id: target.threadId ? Number(target.threadId) : void 0,
+				disable_notification: !input.isFinal
+			});
+			return { messageId: String(sent.message_id) };
+		}
+	};
+}
+function resolveTarget(sessionKey) {
+	const parsed = parseSessionKey(sessionKey);
+	if (!parsed) return null;
+	if (parsed.source !== "telegram") return null;
+	if (!parsed.peerId) return null;
+	return {
+		accountId: parsed.accountId,
+		chatId: parsed.peerId,
+		threadId: parsed.threadId
+	};
+}
+function clampForTelegram(text) {
+	if (text.length <= TELEGRAM_TEXT_MAX) return text;
+	return `${text.slice(0, TELEGRAM_TEXT_MAX - 1)}…`;
+}
+function isMessageNotModified(err) {
+	return errorMessage(err).toLowerCase().includes("message is not modified");
+}
+function isEditTargetGone(err) {
+	const msg = errorMessage(err).toLowerCase();
+	return msg.includes("message to edit not found") || msg.includes("message can't be edited") || msg.includes("chat not found");
+}
+function errorMessage(err) {
+	if (!err) return "";
+	if (err instanceof Error) return err.message;
+	return String(err);
+}
+//#endregion
+export { createTelegramWorkflowProgressCapability };
+
+//# sourceMappingURL=workflow-progress.js.map

package/dist/extensions/telegram/src/workflow-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-progress.js","names":[],"sources":["../../../../extensions/telegram/src/workflow-progress.ts"],"sourcesContent":["/**\n * Telegram capability for the {@link WorkflowProgressBroker}.\n *\n * Strategy: send the first progress update as a fresh message, then edit it in\n * place on every subsequent update. The broker enforces per-channel throttle\n * (default 5 s) and bypasses it for key events (phase change / new error /\n * tool_end), so users always see milestones promptly without us hammering\n * Telegram's edit rate limit.\n *\n * Failure handling is intentionally narrow:\n *   - `message is not modified` from `editMessageText` → swallow (it's a\n *     no-op the broker shouldn't retry).\n *   - Lost / inaccessible message during edit → fall back to a new send so\n *     the user always sees the latest snapshot.\n *   - 429 / network → bubble up, broker logs and drops the update; the next\n *     scheduled (or key) tick will retry.\n *\n * We deliberately use plain text (no parse_mode) — the snapshot renderer\n * emits ASCII-friendly output and we don't want HTML/markdown surprises with\n * `<` in agent labels or shell-style payloads.\n */\n\nimport type { ChannelProgressCapability, WorkflowProgressPostInput } from '@xopcai/xopc/agent/workflow/index.js';\nimport { parseSessionKey } from '@xopcai/xopc/routing/session-key.js';\nimport { createLogger } from '@xopcai/xopc/utils/logger.js';\n\nimport type { TelegramAccountManager } from './account-manager.js';\n\nconst log = createLogger('TelegramWorkflowProgress');\n\n/** Telegram bot API: 4096 char hard cap; leave 96 chars of headroom for re-renders. */\nconst TELEGRAM_TEXT_MAX = 4000;\n\n/** Telegram bot edit rate ≈ 1/s per chat; broker default 5 s leaves ample headroom. */\nconst DEFAULT_THROTTLE_MS = 5_000;\n\nexport function createTelegramWorkflowProgressCapability(\n  accountManager: TelegramAccountManager,\n): ChannelProgressCapability {\n  return {\n    channelId: 'telegram',\n    supportsEdit: true,\n    defaultThrottleMs: DEFAULT_THROTTLE_MS,\n    defaultMode: 'edit',\n\n    async postProgress(input: WorkflowProgressPostInput) {\n      const target = resolveTarget(input.sessionKey);\n      if (!target) {\n        throw new Error(`telegram workflow progress: cannot route sessionKey \"${input.sessionKey}\"`);\n      }\n      const bot = accountManager.getBot(target.accountId);\n      if (!bot) {\n        throw new Error(\n          `telegram workflow progress: no bot for accountId \"${target.accountId}\" (sessionKey \"${input.sessionKey}\")`,\n        );\n      }\n\n      const text = clampForTelegram(input.text);\n\n      // Edit-in-place when we have a previous message id and we're not on the\n      // final send (final could be substantially longer; sending fresh keeps\n      // the conclusion visible even when scrolled past the streaming bubble).\n      if (input.previousMessageId && !input.isFinal) {\n        try {\n          await bot.api.editMessageText(\n            target.chatId,\n            Number(input.previousMessageId),\n            text,\n          );\n          return { messageId: input.previousMessageId };\n        } catch (err) {\n          if (isMessageNotModified(err)) {\n            // Snapshot rendered identically to the last edit (e.g. only\n            // running spinner ticked) — silently keep the same message id.\n            return { messageId: input.previousMessageId };\n          }\n          if (isEditTargetGone(err)) {\n            log.debug(\n              { sessionKey: input.sessionKey, previousMessageId: input.previousMessageId },\n              'edit target gone; falling back to sendMessage',\n            );\n            // fall through to the send path below\n          } else {\n            throw err;\n          }\n        }\n      }\n\n      const sent = await bot.api.sendMessage(target.chatId, text, {\n        message_thread_id: target.threadId ? Number(target.threadId) : undefined,\n        disable_notification: !input.isFinal,\n      });\n      return { messageId: String(sent.message_id) };\n    },\n  };\n}\n\ninterface ResolvedTarget {\n  accountId: string;\n  chatId: string;\n  threadId?: string;\n}\n\nfunction resolveTarget(sessionKey: string): ResolvedTarget | null {\n  const parsed = parseSessionKey(sessionKey);\n  if (!parsed) return null;\n  if (parsed.source !== 'telegram') return null;\n  if (!parsed.peerId) return null;\n  return {\n    accountId: parsed.accountId,\n    chatId: parsed.peerId,\n    threadId: parsed.threadId,\n  };\n}\n\nfunction clampForTelegram(text: string): string {\n  if (text.length <= TELEGRAM_TEXT_MAX) return text;\n  return `${text.slice(0, TELEGRAM_TEXT_MAX - 1)}…`;\n}\n\nfunction isMessageNotModified(err: unknown): boolean {\n  const msg = errorMessage(err).toLowerCase();\n  return msg.includes('message is not modified');\n}\n\nfunction isEditTargetGone(err: unknown): boolean {\n  const msg = errorMessage(err).toLowerCase();\n  return (\n    msg.includes('message to edit not found') ||\n    msg.includes(\"message can't be edited\") ||\n    msg.includes('chat not found')\n  );\n}\n\nfunction errorMessage(err: unknown): string {\n  if (!err) return '';\n  if (err instanceof Error) return err.message;\n  return String(err);\n}\n"],"mappings":";;;;kBAuBsE;aACV;AAI5D,MAAM,MAAM,aAAa,2BAA2B;;AAGpD,MAAM,oBAAoB;;AAG1B,MAAM,sBAAsB;AAE5B,SAAgB,yCACd,gBAC2B;AAC3B,QAAO;EACL,WAAW;EACX,cAAc;EACd,mBAAmB;EACnB,aAAa;EAEb,MAAM,aAAa,OAAkC;GACnD,MAAM,SAAS,cAAc,MAAM,WAAW;AAC9C,OAAI,CAAC,OACH,OAAM,IAAI,MAAM,wDAAwD,MAAM,WAAW,GAAG;GAE9F,MAAM,MAAM,eAAe,OAAO,OAAO,UAAU;AACnD,OAAI,CAAC,IACH,OAAM,IAAI,MACR,qDAAqD,OAAO,UAAU,iBAAiB,MAAM,WAAW,IACzG;GAGH,MAAM,OAAO,iBAAiB,MAAM,KAAK;AAKzC,OAAI,MAAM,qBAAqB,CAAC,MAAM,QACpC,KAAI;AACF,UAAM,IAAI,IAAI,gBACZ,OAAO,QACP,OAAO,MAAM,kBAAkB,EAC/B,KACD;AACD,WAAO,EAAE,WAAW,MAAM,mBAAmB;YACtC,KAAK;AACZ,QAAI,qBAAqB,IAAI,CAG3B,QAAO,EAAE,WAAW,MAAM,mBAAmB;AAE/C,QAAI,iBAAiB,IAAI,CACvB,KAAI,MACF;KAAE,YAAY,MAAM;KAAY,mBAAmB,MAAM;KAAmB,EAC5E,gDACD;QAGD,OAAM;;GAKZ,MAAM,OAAO,MAAM,IAAI,IAAI,YAAY,OAAO,QAAQ,MAAM;IAC1D,mBAAmB,OAAO,WAAW,OAAO,OAAO,SAAS,GAAG,KAAA;IAC/D,sBAAsB,CAAC,MAAM;IAC9B,CAAC;AACF,UAAO,EAAE,WAAW,OAAO,KAAK,WAAW,EAAE;;EAEhD;;AASH,SAAS,cAAc,YAA2C;CAChE,MAAM,SAAS,gBAAgB,WAAW;AAC1C,KAAI,CAAC,OAAQ,QAAO;AACpB,KAAI,OAAO,WAAW,WAAY,QAAO;AACzC,KAAI,CAAC,OAAO,OAAQ,QAAO;AAC3B,QAAO;EACL,WAAW,OAAO;EAClB,QAAQ,OAAO;EACf,UAAU,OAAO;EAClB;;AAGH,SAAS,iBAAiB,MAAsB;AAC9C,KAAI,KAAK,UAAU,kBAAmB,QAAO;AAC7C,QAAO,GAAG,KAAK,MAAM,GAAG,oBAAoB,EAAE,CAAC;;AAGjD,SAAS,qBAAqB,KAAuB;AAEnD,QADY,aAAa,IAAI,CAAC,aACpB,CAAC,SAAS,0BAA0B;;AAGhD,SAAS,iBAAiB,KAAuB;CAC/C,MAAM,MAAM,aAAa,IAAI,CAAC,aAAa;AAC3C,QACE,IAAI,SAAS,4BAA4B,IACzC,IAAI,SAAS,0BAA0B,IACvC,IAAI,SAAS,iBAAiB;;AAIlC,SAAS,aAAa,KAAsB;AAC1C,KAAI,CAAC,IAAK,QAAO;AACjB,KAAI,eAAe,MAAO,QAAO,IAAI;AACrC,QAAO,OAAO,IAAI"}

package/dist/extensions/telegram/xopc.extension.json

@@ -2,7 +2,7 @@
   "id": "telegram",
   "name": "Telegram Channel",
   "description": "Bundled Telegram Bot channel (private workspace sources; ships inside @xopcai/xopc dist/)",
-  "version": "0.0.83",
+  "version": "0.0.85",
   "kind": "channel",
   "main": "src/index.ts",
   "channels": ["telegram"],

package/dist/extensions/weixin/src/__tests__/workflow-progress.test.js

@@ -0,0 +1,158 @@
+import { getContextToken } from "../messaging/inbound.js";
+import { sendMessageWeixin } from "../messaging/send.js";
+import { ensureWeixinContextTokenForOutbound } from "../messaging/context-token-init.js";
+import { createWeixinWorkflowProgressCapability } from "../workflow-progress.js";
+import { describe, expect, it, vi } from "vitest";
+//#region extensions/weixin/src/__tests__/workflow-progress.test.ts
+vi.mock("../auth/accounts.js", () => ({ resolveWeixinAccount: () => ({
+	accountId: "default",
+	enabled: true,
+	configured: true,
+	token: "tok-x",
+	baseUrl: "https://example/weixin",
+	routeTag: void 0
+}) }));
+vi.mock("../messaging/inbound.js", () => ({
+	getContextToken: vi.fn(),
+	restoreContextTokens: vi.fn()
+}));
+vi.mock("../messaging/context-token-init.js", () => ({ ensureWeixinContextTokenForOutbound: vi.fn() }));
+vi.mock("../messaging/send.js", async () => {
+	return {
+		...await vi.importActual("../messaging/send.js"),
+		sendMessageWeixin: vi.fn().mockResolvedValue({ messageId: "weixin-1" })
+	};
+});
+const getCtxMock = vi.mocked(getContextToken);
+const ensureMock = vi.mocked(ensureWeixinContextTokenForOutbound);
+const sendMock = vi.mocked(sendMessageWeixin);
+const SESSION = "main:weixin:default:dm:ilink_user_abc";
+function mkCap() {
+	return createWeixinWorkflowProgressCapability({ getConfig: () => ({}) });
+}
+describe("weixin workflow progress capability", () => {
+	it("declares final-only defaults (no editMessage on WeChat)", () => {
+		const cap = mkCap();
+		expect(cap.channelId).toBe("weixin");
+		expect(cap.supportsEdit).toBe(false);
+		expect(cap.defaultMode).toBe("final-only");
+		expect(cap.defaultThrottleMs).toBeGreaterThanOrEqual(3e4);
+	});
+	it("sends the final message when a cached context token exists", async () => {
+		getCtxMock.mockReturnValue("tok-cached");
+		sendMock.mockClear();
+		ensureMock.mockClear();
+		const r = await mkCap().postProgress({
+			sessionKey: SESSION,
+			text: "done",
+			isFinal: true
+		});
+		expect(ensureMock).not.toHaveBeenCalled();
+		expect(sendMock).toHaveBeenCalledWith(expect.objectContaining({
+			to: "ilink_user_abc",
+			text: "done",
+			opts: expect.objectContaining({ contextToken: "tok-cached" })
+		}));
+		expect(r.messageId).toBe("weixin-1");
+	});
+	it("hydrates a context token on demand when cache is empty", async () => {
+		getCtxMock.mockReturnValue(void 0);
+		ensureMock.mockResolvedValue("tok-hydrated");
+		sendMock.mockClear();
+		await mkCap().postProgress({
+			sessionKey: SESSION,
+			text: "done",
+			isFinal: true
+		});
+		expect(ensureMock).toHaveBeenCalled();
+		const sendArg = sendMock.mock.calls[0][0];
+		expect(sendArg.opts.contextToken).toBe("tok-hydrated");
+	});
+	it("returns an empty messageId without sending when no context token can be found", async () => {
+		getCtxMock.mockReturnValue(void 0);
+		ensureMock.mockResolvedValue(void 0);
+		sendMock.mockClear();
+		const r = await mkCap().postProgress({
+			sessionKey: SESSION,
+			text: "done",
+			isFinal: true
+		});
+		expect(sendMock).not.toHaveBeenCalled();
+		expect(r.messageId).toBe("");
+	});
+	it("throws on unroutable sessionKey", async () => {
+		await expect(mkCap().postProgress({
+			sessionKey: "main:telegram:default:dm:123",
+			text: "x",
+			isFinal: true
+		})).rejects.toThrow(/cannot route/);
+	});
+	it("clamps oversized text to WeChat limit", async () => {
+		getCtxMock.mockReturnValue("tok");
+		sendMock.mockClear();
+		await mkCap().postProgress({
+			sessionKey: SESSION,
+			text: "x".repeat(1e4),
+			isFinal: true
+		});
+		const text = sendMock.mock.calls[0][0].text;
+		expect(text.length).toBeLessThanOrEqual(4e3);
+		expect(text.endsWith("…")).toBe(true);
+	});
+	describe("append-mode message decoration", () => {
+		it("prefixes mid-run append messages with \"工作流进展\" header", async () => {
+			getCtxMock.mockReturnValue("tok");
+			sendMock.mockClear();
+			await mkCap().postProgress({
+				sessionKey: SESSION,
+				text: "Inventory done · Review running",
+				isFinal: false,
+				mode: "append"
+			});
+			const text = sendMock.mock.calls[0][0].text;
+			expect(text.startsWith("▾ 工作流进展\n")).toBe(true);
+			expect(text).toContain("Inventory done · Review running");
+		});
+		it("prefixes final append message with \"工作流完成\" header", async () => {
+			getCtxMock.mockReturnValue("tok");
+			sendMock.mockClear();
+			await mkCap().postProgress({
+				sessionKey: SESSION,
+				text: "Top findings (3): …",
+				isFinal: true,
+				mode: "append"
+			});
+			const text = sendMock.mock.calls[0][0].text;
+			expect(text.startsWith("✓ 工作流完成\n")).toBe(true);
+			expect(text).toContain("Top findings (3): …");
+		});
+		it("does NOT add a header in final-only mode (existing behaviour preserved)", async () => {
+			getCtxMock.mockReturnValue("tok");
+			sendMock.mockClear();
+			await mkCap().postProgress({
+				sessionKey: SESSION,
+				text: "Top findings (3): …",
+				isFinal: true,
+				mode: "final-only"
+			});
+			const text = sendMock.mock.calls[0][0].text;
+			expect(text).not.toContain("工作流");
+			expect(text).toBe("Top findings (3): …");
+		});
+		it("does NOT add a header when mode is omitted (back-compat)", async () => {
+			getCtxMock.mockReturnValue("tok");
+			sendMock.mockClear();
+			await mkCap().postProgress({
+				sessionKey: SESSION,
+				text: "plain",
+				isFinal: true
+			});
+			const text = sendMock.mock.calls[0][0].text;
+			expect(text).toBe("plain");
+		});
+	});
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=workflow-progress.test.js.map

package/dist/extensions/weixin/src/__tests__/workflow-progress.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-progress.test.js","names":[],"sources":["../../../../../extensions/weixin/src/__tests__/workflow-progress.test.ts"],"sourcesContent":["import { describe, expect, it, vi } from 'vitest';\n\nimport { createWeixinWorkflowProgressCapability } from '../workflow-progress.js';\n\nvi.mock('../auth/accounts.js', () => ({\n  resolveWeixinAccount: () => ({\n    accountId: 'default',\n    enabled: true,\n    configured: true,\n    token: 'tok-x',\n    baseUrl: 'https://example/weixin',\n    routeTag: undefined,\n  }),\n}));\n\nvi.mock('../messaging/inbound.js', () => ({\n  getContextToken: vi.fn(),\n  restoreContextTokens: vi.fn(),\n}));\n\nvi.mock('../messaging/context-token-init.js', () => ({\n  ensureWeixinContextTokenForOutbound: vi.fn(),\n}));\n\nvi.mock('../messaging/send.js', async () => {\n  const actual = await vi.importActual<typeof import('../messaging/send.js')>('../messaging/send.js');\n  return {\n    ...actual,\n    sendMessageWeixin: vi.fn().mockResolvedValue({ messageId: 'weixin-1' }),\n  };\n});\n\nimport { getContextToken } from '../messaging/inbound.js';\nimport { ensureWeixinContextTokenForOutbound } from '../messaging/context-token-init.js';\nimport { sendMessageWeixin } from '../messaging/send.js';\n\nconst getCtxMock = vi.mocked(getContextToken);\nconst ensureMock = vi.mocked(ensureWeixinContextTokenForOutbound);\nconst sendMock = vi.mocked(sendMessageWeixin);\n\nconst SESSION = 'main:weixin:default:dm:ilink_user_abc';\n\nfunction mkCap() {\n  return createWeixinWorkflowProgressCapability({\n    getConfig: () => ({}) as never,\n  });\n}\n\ndescribe('weixin workflow progress capability', () => {\n  it('declares final-only defaults (no editMessage on WeChat)', () => {\n    const cap = mkCap();\n    expect(cap.channelId).toBe('weixin');\n    expect(cap.supportsEdit).toBe(false);\n    expect(cap.defaultMode).toBe('final-only');\n    expect(cap.defaultThrottleMs).toBeGreaterThanOrEqual(30_000);\n  });\n\n  it('sends the final message when a cached context token exists', async () => {\n    getCtxMock.mockReturnValue('tok-cached');\n    sendMock.mockClear();\n    ensureMock.mockClear();\n    const cap = mkCap();\n    const r = await cap.postProgress({ sessionKey: SESSION, text: 'done', isFinal: true });\n    expect(ensureMock).not.toHaveBeenCalled();\n    expect(sendMock).toHaveBeenCalledWith(\n      expect.objectContaining({\n        to: 'ilink_user_abc',\n        text: 'done',\n        opts: expect.objectContaining({ contextToken: 'tok-cached' }),\n      }),\n    );\n    expect(r.messageId).toBe('weixin-1');\n  });\n\n  it('hydrates a context token on demand when cache is empty', async () => {\n    getCtxMock.mockReturnValue(undefined);\n    ensureMock.mockResolvedValue('tok-hydrated');\n    sendMock.mockClear();\n    const cap = mkCap();\n    await cap.postProgress({ sessionKey: SESSION, text: 'done', isFinal: true });\n    expect(ensureMock).toHaveBeenCalled();\n    const sendArg = sendMock.mock.calls[0][0];\n    expect(sendArg.opts.contextToken).toBe('tok-hydrated');\n  });\n\n  it('returns an empty messageId without sending when no context token can be found', async () => {\n    getCtxMock.mockReturnValue(undefined);\n    ensureMock.mockResolvedValue(undefined);\n    sendMock.mockClear();\n    const cap = mkCap();\n    const r = await cap.postProgress({ sessionKey: SESSION, text: 'done', isFinal: true });\n    expect(sendMock).not.toHaveBeenCalled();\n    expect(r.messageId).toBe('');\n  });\n\n  it('throws on unroutable sessionKey', async () => {\n    const cap = mkCap();\n    await expect(\n      cap.postProgress({\n        sessionKey: 'main:telegram:default:dm:123',\n        text: 'x',\n        isFinal: true,\n      }),\n    ).rejects.toThrow(/cannot route/);\n  });\n\n  it('clamps oversized text to WeChat limit', async () => {\n    getCtxMock.mockReturnValue('tok');\n    sendMock.mockClear();\n    const cap = mkCap();\n    await cap.postProgress({ sessionKey: SESSION, text: 'x'.repeat(10_000), isFinal: true });\n    const text = sendMock.mock.calls[0][0].text;\n    expect(text.length).toBeLessThanOrEqual(4_000);\n    expect(text.endsWith('…')).toBe(true);\n  });\n\n  describe('append-mode message decoration', () => {\n    it('prefixes mid-run append messages with \"工作流进展\" header', async () => {\n      getCtxMock.mockReturnValue('tok');\n      sendMock.mockClear();\n      const cap = mkCap();\n      await cap.postProgress({\n        sessionKey: SESSION,\n        text: 'Inventory done · Review running',\n        isFinal: false,\n        mode: 'append',\n      });\n      const text = sendMock.mock.calls[0][0].text;\n      expect(text.startsWith('▾ 工作流进展\\n')).toBe(true);\n      expect(text).toContain('Inventory done · Review running');\n    });\n\n    it('prefixes final append message with \"工作流完成\" header', async () => {\n      getCtxMock.mockReturnValue('tok');\n      sendMock.mockClear();\n      const cap = mkCap();\n      await cap.postProgress({\n        sessionKey: SESSION,\n        text: 'Top findings (3): …',\n        isFinal: true,\n        mode: 'append',\n      });\n      const text = sendMock.mock.calls[0][0].text;\n      expect(text.startsWith('✓ 工作流完成\\n')).toBe(true);\n      expect(text).toContain('Top findings (3): …');\n    });\n\n    it('does NOT add a header in final-only mode (existing behaviour preserved)', async () => {\n      getCtxMock.mockReturnValue('tok');\n      sendMock.mockClear();\n      const cap = mkCap();\n      await cap.postProgress({\n        sessionKey: SESSION,\n        text: 'Top findings (3): …',\n        isFinal: true,\n        mode: 'final-only',\n      });\n      const text = sendMock.mock.calls[0][0].text;\n      expect(text).not.toContain('工作流');\n      expect(text).toBe('Top findings (3): …');\n    });\n\n    it('does NOT add a header when mode is omitted (back-compat)', async () => {\n      getCtxMock.mockReturnValue('tok');\n      sendMock.mockClear();\n      const cap = mkCap();\n      await cap.postProgress({ sessionKey: SESSION, text: 'plain', isFinal: true });\n      const text = sendMock.mock.calls[0][0].text;\n      expect(text).toBe('plain');\n    });\n  });\n});\n"],"mappings":"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"}

package/dist/extensions/weixin/src/api/api.js

@@ -1,8 +1,8 @@
 import { logger } from "../util/logger.js";
 import { redactBody, redactUrl } from "../util/redact.js";
-import crypto from "node:crypto";
-import fsSync from "node:fs";
 import path from "node:path";
+import fsSync from "node:fs";
+import crypto from "node:crypto";
 import { fileURLToPath } from "node:url";
 import { Agent, fetch as fetch$1 } from "undici";
 //#region extensions/weixin/src/api/api.ts

package/dist/extensions/weixin/src/auth/accounts.js

@@ -1,8 +1,8 @@
 import { logger } from "../util/logger.js";
 import { normalizeWeixinAccountId } from "./weixin-account-id.js";
 import { resolveWeixinRootDir } from "../storage/state-dir.js";
-import fsSync from "node:fs";
 import path from "node:path";
+import fsSync from "node:fs";
 //#region extensions/weixin/src/auth/accounts.ts
 const DEFAULT_BASE_URL = "https://ilinkai.weixin.qq.com";
 const CDN_BASE_URL = "https://novac2c.cdn.weixin.qq.com/c2c";

package/dist/extensions/weixin/src/cdn/upload.js

@@ -6,9 +6,9 @@ import { getUploadUrl } from "../api/api.js";
 import { getExtensionFromContentTypeOrUrl } from "../media/mime.js";
 import { aesEcbPaddedSize } from "./aes-ecb.js";
 import { uploadBufferToCdn } from "./cdn-upload.js";
+import path from "node:path";
 import crypto from "node:crypto";
 import fs from "node:fs/promises";
-import path from "node:path";
 //#region extensions/weixin/src/cdn/upload.ts
 /**
 * Download a remote media URL (image, video, file) to a local temp file in destDir.

package/dist/extensions/weixin/src/media/data-url.js

@@ -1,7 +1,7 @@
 import { getExtensionFromMime } from "./mime.js";
+import path from "node:path";
 import { randomBytes } from "node:crypto";
 import fs from "node:fs/promises";
-import path from "node:path";
 //#region extensions/weixin/src/media/data-url.ts
 /**
 * Parse `data:mime;base64,...` into buffer (aligned with Telegram `parseDataUrl`).

package/dist/extensions/weixin/src/messaging/debug-mode.js

@@ -1,7 +1,7 @@
 import { logger } from "../util/logger.js";
 import { resolveWeixinRootDir } from "../storage/state-dir.js";
-import fsSync from "node:fs";
 import path from "node:path";
+import fsSync from "node:fs";
 //#region extensions/weixin/src/messaging/debug-mode.ts
 /**
 * Per-bot debug mode toggle, persisted to disk so it survives gateway restarts.

package/dist/extensions/weixin/src/messaging/inbound.js

@@ -3,8 +3,8 @@ import { generateId } from "../util/random.js";
 import { MessageItemType } from "../api/types.js";
 import { canonicalWeixinPeerId, normalizeWeixinAccountId } from "../auth/weixin-account-id.js";
 import { resolveWeixinRootDir } from "../storage/state-dir.js";
-import fsSync from "node:fs";
 import path from "node:path";
+import fsSync from "node:fs";
 //#region extensions/weixin/src/messaging/inbound.ts
 /**
 * contextToken is issued per-message by the Weixin getupdates API and must

package/dist/extensions/weixin/src/messaging/process-message.js

@@ -11,9 +11,9 @@ import { downloadMediaFromItem } from "../media/media-download.js";
 import { isDebugMode } from "./debug-mode.js";
 import { sendMessageWeixin } from "./send.js";
 import { handleSlashCommand } from "./slash-commands.js";
+import path from "node:path";
 import { randomBytes } from "node:crypto";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
-import path from "node:path";
 //#region extensions/weixin/src/messaging/process-message.ts
 function extractTextBody(itemList) {
 	if (!itemList?.length) return "";

package/dist/extensions/weixin/src/plugin.d.ts

@@ -39,6 +39,8 @@ export declare class WeixinChannelPlugin implements ChannelPlugin<ResolvedWeixin
     private bus;
     private cfg;
     private abortControllers;
+    /** Unregister fn for the workflow-progress capability registered against the global broker. */
+    private workflowProgressUnregister;
     config: {
         listAccountIds: (cfg: Config) => string[];
         resolveAccount: (cfg: Config, accountId?: string | null) => ResolvedWeixinAccount;

package/dist/extensions/weixin/src/plugin.js

@@ -1,6 +1,8 @@
+import { WeixinConfigSchema, init_config_schema } from "./config-schema.js";
 import { createLogger } from "../../../src/utils/logger/index.js";
 import { init_logger } from "../../../src/utils/logger.js";
-import { WeixinConfigSchema, init_config_schema } from "./config-schema.js";
+import { getWorkflowProgressBroker } from "../../../src/agent/workflow/progress-broker.js";
+import "../../../src/agent/workflow/index.js";
 import { evaluateAccess, resolveDmPolicy } from "../../../src/channels/security.js";
 import { createStandardPairingAdapter } from "../../../src/channels/pairing/pairing-store-adapter.js";
 import { restoreContextTokens } from "./messaging/inbound.js";
@@ -11,6 +13,7 @@ import { createWeixinOutboundHandlers, weixinTextChunker } from "./outbound-send
 import { normalizeWeixinCronDeliveryToResolved } from "./delivery-to.js";
 import { weixinConfigSurface } from "./config-surface.js";
 import { weixinOnboardAdapter } from "./adapters/onboard-cli.js";
+import { createWeixinWorkflowProgressCapability } from "./workflow-progress.js";
 import { isDeepStrictEqual } from "node:util";
 //#region extensions/weixin/src/plugin.ts
 /**
@@ -81,6 +84,8 @@ var WeixinChannelPlugin = class {
 	bus;
 	cfg;
 	abortControllers = /* @__PURE__ */ new Map();
+	/** Unregister fn for the workflow-progress capability registered against the global broker. */
+	workflowProgressUnregister = null;
 	config = {
 		listAccountIds: (cfg) => listWeixinAccountIds(cfg),
 		resolveAccount: (cfg, accountId) => resolveWeixinAccount(cfg, accountId),
@@ -130,6 +135,7 @@ var WeixinChannelPlugin = class {
 	async init(options) {
 		this.bus = options.bus;
 		this.cfg = options.config;
+		this.workflowProgressUnregister = getWorkflowProgressBroker().registerChannel(createWeixinWorkflowProgressCapability({ getConfig: () => this.cfg }));
 		log.debug("Weixin plugin initialized");
 	}
 	async start(options) {
@@ -168,6 +174,10 @@ var WeixinChannelPlugin = class {
 				this.abortControllers.delete(id);
 			}
 		}
+		if (!accountId) {
+			this.workflowProgressUnregister?.();
+			this.workflowProgressUnregister = null;
+		}
 	}
 	channelIsRunning(cfg) {
 		return listWeixinAccountIds(cfg).some((id) => {

package/dist/extensions/weixin/src/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","names":[],"sources":["../../../../extensions/weixin/src/plugin.ts"],"sourcesContent":["/**\n * Weixin (WeChat ilink) channel — long-poll getUpdates, QR login, direct messages only.\n */\n\nimport { isDeepStrictEqual } from 'node:util';\n\nimport type { Config } from '@xopcai/xopc/config/schema.js';\nimport type { MessageBus } from '@xopcai/xopc/infra/bus/index.js';\nimport type {\n  ChannelCapabilities,\n  ChannelPlugin,\n  ChannelPluginDefaults,\n  ChannelPluginInitOptions,\n  ChannelPluginReloadMeta,\n  ChannelPluginStartOptions,\n  ChannelSecurityContext,\n  ChannelStreamingAdapter,\n  ChatType,\n} from '@xopcai/xopc/channels/plugin-types.js';\nimport { evaluateAccess, resolveDmPolicy } from '@xopcai/xopc/channels/security.js';\nimport { createStandardPairingAdapter } from '@xopcai/xopc/channels/pairing/pairing-store-adapter.js';\nimport { createLogger } from '@xopcai/xopc/utils/logger.js';\n\nimport { restoreContextTokens } from './messaging/inbound.js';\nimport { monitorWeixinProvider } from './monitor/monitor.js';\nimport type { ChannelCliLoginAdapter, ChannelCronDeliveryAdapter } from '@xopcai/xopc/channels/plugins/types.adapters.js';\nimport {\n  listWeixinAccountIds,\n  resolveWeixinAccount,\n  type ResolvedWeixinAccount,\n} from './auth/accounts.js';\nimport { readFrameworkAllowFromList } from './auth/pairing.js';\nimport { createWeixinOutboundHandlers, weixinTextChunker } from './outbound-send.js';\nimport { normalizeWeixinCronDeliveryToResolved } from './delivery-to.js';\nimport { weixinConfigSurface } from './config-surface.js';\nimport { WeixinConfigSchema } from './config-schema.js';\nimport { weixinOnboardAdapter } from './adapters/onboard-cli.js';\n\nconst log = createLogger('WeixinPlugin');\n\nexport class WeixinChannelPlugin implements ChannelPlugin<ResolvedWeixinAccount> {\n  readonly id = 'weixin' as const;\n\n  readonly reload: ChannelPluginReloadMeta = {\n    configPrefixes: ['channels.weixin'],\n  };\n\n  readonly meta = {\n    id: 'weixin',\n    label: 'Weixin',\n    selectionLabel: 'Weixin (ilink)',\n    docsPath: '/channels/weixin',\n    blurb: 'WeChat via Tencent ilink bot API (QR login, direct chat).',\n    order: 3,\n    deferConnectUntilAfterListen: true,\n  } as const;\n\n  readonly capabilities: ChannelCapabilities = {\n    chatTypes: ['direct'] as ChatType[],\n    reactions: false,\n    threads: false,\n    media: true,\n    polls: false,\n    nativeCommands: false,\n    blockStreaming: true,\n  };\n\n  readonly configSchema = {\n    schema: {},\n    validate: (raw: unknown) => {\n      const r = WeixinConfigSchema.safeParse(raw);\n      return r.success ? { ok: true as const } : { ok: false as const, errors: [r.error.message] };\n    },\n  };\n\n  readonly cronDelivery: ChannelCronDeliveryAdapter = {\n    async normalizeDeliveryTarget(to, sessionStore) {\n      const { chatId, accountId } = await normalizeWeixinCronDeliveryToResolved(to, sessionStore);\n      return { chatId, accountId };\n    },\n  };\n\n  readonly onboard = weixinOnboardAdapter;\n\n  readonly cliLogin: ChannelCliLoginAdapter = {\n    async runLogin(params) {\n      const { runWeixinQrLoginCli } = await import('./cli/qr-login.js');\n      return runWeixinQrLoginCli({\n        configPath: params.configPath,\n        verbose: params.verbose,\n        timeoutMs: params.timeoutMs,\n        account: params.accountId,\n        writeConfig: params.writeConfig,\n      });\n    },\n  };\n\n  readonly configSurface = weixinConfigSurface;\n\n  readonly pairing = createStandardPairingAdapter('weixin');\n\n  readonly defaults: ChannelPluginDefaults = {\n    queue: { debounceMs: 0 },\n    outbound: { textChunkLimit: 4000 },\n    streaming: {\n      blockStreamingCoalesce: {\n        minChars: 200,\n        idleMs: 3000,\n      },\n    },\n  };\n\n  private bus!: ChannelPluginInitOptions['bus'];\n  private cfg!: Config;\n  private abortControllers = new Map<string, AbortController>();\n\n  config = {\n    listAccountIds: (cfg: Config) => listWeixinAccountIds(cfg),\n    resolveAccount: (cfg: Config, accountId?: string | null) => resolveWeixinAccount(cfg, accountId),\n    isConfigured: async (account: ResolvedWeixinAccount) => account.configured,\n    describeAccount: (account: ResolvedWeixinAccount, _cfg: Config) => ({\n      accountId: account.accountId,\n      channelId: 'weixin',\n      name: account.name,\n      enabled: account.enabled,\n      configured: account.configured,\n      status: undefined,\n    }),\n  };\n\n  security = {\n    resolveDmPolicy: ({ account }: { account: ResolvedWeixinAccount }) =>\n      resolveDmPolicy(account.dmPolicy, 'open'),\n    checkAccess: (ctx: ChannelSecurityContext, account: ResolvedWeixinAccount, _cfg: Config) => {\n      const allowFrom = [...(account.allowFrom ?? []), ...readFrameworkAllowFromList(account.accountId)];\n      return evaluateAccess({\n        context: {\n          channel: 'weixin',\n          accountId: account.accountId,\n          chatId: ctx.chatId,\n          senderId: ctx.senderId,\n          senderName: ctx.senderName,\n          isGroup: false,\n          isDm: true,\n        },\n        dmPolicy: account.dmPolicy,\n        allowFrom,\n      });\n    },\n  };\n\n  outbound = {\n    deliveryMode: 'direct' as const,\n    chunker: weixinTextChunker,\n    chunkerMode: 'text' as const,\n    textChunkLimit: 4000,\n    ...createWeixinOutboundHandlers(),\n  };\n\n  streaming: ChannelStreamingAdapter = {\n    startStream: () => null,\n  };\n\n  /** Channel plugin hints (cron targets, media paths). */\n  agentPrompt = {\n    augmentSystemPrompt: (): string =>\n      [\n        'Weixin (ilink): direct chat only. To send an image or file, use the message tool with action send and set media to a local absolute path or an HTTPS URL; relative paths may fail.',\n        'For cron or scheduled delivery to a Weixin contact, set delivery.to to the user Weixin id (ending in @im.wechat) and delivery.accountId to the bot account id, or outbound may pick the wrong account.',\n        'When using MEDIA: to attach a file, put the MEDIA: line alone on its own line, not inline with other text.',\n      ].join('\\n'),\n  };\n\n  async init(options: ChannelPluginInitOptions): Promise<void> {\n    this.bus = options.bus;\n    this.cfg = options.config;\n    log.debug('Weixin plugin initialized');\n  }\n\n  async start(options?: ChannelPluginStartOptions): Promise<void> {\n    const ids = options?.accountId\n      ? [options.accountId]\n      : listWeixinAccountIds(this.cfg);\n\n    for (const accountId of ids) {\n      const account = resolveWeixinAccount(this.cfg, accountId);\n      if (!account.enabled || !account.configured || !account.token) continue;\n\n      if (this.abortControllers.has(accountId)) continue;\n\n      restoreContextTokens(account.accountId);\n\n      const ac = new AbortController();\n      this.abortControllers.set(accountId, ac);\n\n      void monitorWeixinProvider({\n        account,\n        config: this.cfg,\n        bus: this.bus,\n        abortSignal: ac.signal,\n      }).catch((err) => {\n        if ((err as { name?: string; message?: string } | undefined)?.name === 'AbortError') {\n          log.debug({ accountId }, 'Weixin monitor stopped');\n          return;\n        }\n        log.error({ err, accountId }, 'Weixin monitor exited with error');\n      });\n\n      log.info({ accountId }, 'Weixin monitor started');\n    }\n  }\n\n  async stop(accountId?: string): Promise<void> {\n    const ids = accountId ? [accountId] : [...this.abortControllers.keys()];\n    for (const id of ids) {\n      const ac = this.abortControllers.get(id);\n      if (ac) {\n        ac.abort();\n        this.abortControllers.delete(id);\n      }\n    }\n  }\n\n  channelIsRunning(cfg: Config): boolean {\n    return listWeixinAccountIds(cfg).some((id) => {\n      const a = resolveWeixinAccount(cfg, id);\n      return a.configured && a.enabled !== false && this.abortControllers.has(id);\n    });\n  }\n\n  async onConfigUpdated(cfg: Config): Promise<void> {\n    const prevWx = this.cfg.channels?.weixin as unknown;\n    const nextWx = cfg.channels?.weixin as { enabled?: boolean } | undefined;\n    const channelOff = !nextWx || nextWx.enabled !== true;\n\n    if (channelOff) {\n      this.cfg = cfg;\n      await this.stop();\n      return;\n    }\n\n    this.cfg = cfg;\n\n    if (isDeepStrictEqual(prevWx, nextWx) && this.channelIsRunning(cfg)) {\n      return;\n    }\n\n    await this.stop();\n    await this.start();\n  }\n\n  /**\n   * Restart long-poll monitors after credentials were written to disk without a `channels.weixin` JSON\n   * delta (e.g. only token files / account index updated). Gateway calls this after QR login completes.\n   *\n   * Pass `bus` explicitly: if Weixin was disabled at gateway boot, `init()` was skipped and `this.bus` was never set.\n   */\n  async reloadMonitorsWithConfig(cfg: Config, bus: MessageBus): Promise<void> {\n    this.bus = bus;\n    this.cfg = cfg;\n    await this.stop();\n    await this.start();\n  }\n}\n\nexport const weixinPlugin = new WeixinChannelPlugin();\n"],"mappings":"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"}
+{"version":3,"file":"plugin.js","names":[],"sources":["../../../../extensions/weixin/src/plugin.ts"],"sourcesContent":["/**\n * Weixin (WeChat ilink) channel — long-poll getUpdates, QR login, direct messages only.\n */\n\nimport { isDeepStrictEqual } from 'node:util';\n\nimport type { Config } from '@xopcai/xopc/config/schema.js';\nimport type { MessageBus } from '@xopcai/xopc/infra/bus/index.js';\nimport type {\n  ChannelCapabilities,\n  ChannelPlugin,\n  ChannelPluginDefaults,\n  ChannelPluginInitOptions,\n  ChannelPluginReloadMeta,\n  ChannelPluginStartOptions,\n  ChannelSecurityContext,\n  ChannelStreamingAdapter,\n  ChatType,\n} from '@xopcai/xopc/channels/plugin-types.js';\nimport { evaluateAccess, resolveDmPolicy } from '@xopcai/xopc/channels/security.js';\nimport { createStandardPairingAdapter } from '@xopcai/xopc/channels/pairing/pairing-store-adapter.js';\nimport { createLogger } from '@xopcai/xopc/utils/logger.js';\n\nimport { restoreContextTokens } from './messaging/inbound.js';\nimport { monitorWeixinProvider } from './monitor/monitor.js';\nimport type { ChannelCliLoginAdapter, ChannelCronDeliveryAdapter } from '@xopcai/xopc/channels/plugins/types.adapters.js';\nimport {\n  listWeixinAccountIds,\n  resolveWeixinAccount,\n  type ResolvedWeixinAccount,\n} from './auth/accounts.js';\nimport { readFrameworkAllowFromList } from './auth/pairing.js';\nimport { createWeixinOutboundHandlers, weixinTextChunker } from './outbound-send.js';\nimport { normalizeWeixinCronDeliveryToResolved } from './delivery-to.js';\nimport { weixinConfigSurface } from './config-surface.js';\nimport { WeixinConfigSchema } from './config-schema.js';\nimport { weixinOnboardAdapter } from './adapters/onboard-cli.js';\nimport { getWorkflowProgressBroker } from '@xopcai/xopc/agent/workflow/index.js';\nimport { createWeixinWorkflowProgressCapability } from './workflow-progress.js';\n\nconst log = createLogger('WeixinPlugin');\n\nexport class WeixinChannelPlugin implements ChannelPlugin<ResolvedWeixinAccount> {\n  readonly id = 'weixin' as const;\n\n  readonly reload: ChannelPluginReloadMeta = {\n    configPrefixes: ['channels.weixin'],\n  };\n\n  readonly meta = {\n    id: 'weixin',\n    label: 'Weixin',\n    selectionLabel: 'Weixin (ilink)',\n    docsPath: '/channels/weixin',\n    blurb: 'WeChat via Tencent ilink bot API (QR login, direct chat).',\n    order: 3,\n    deferConnectUntilAfterListen: true,\n  } as const;\n\n  readonly capabilities: ChannelCapabilities = {\n    chatTypes: ['direct'] as ChatType[],\n    reactions: false,\n    threads: false,\n    media: true,\n    polls: false,\n    nativeCommands: false,\n    blockStreaming: true,\n  };\n\n  readonly configSchema = {\n    schema: {},\n    validate: (raw: unknown) => {\n      const r = WeixinConfigSchema.safeParse(raw);\n      return r.success ? { ok: true as const } : { ok: false as const, errors: [r.error.message] };\n    },\n  };\n\n  readonly cronDelivery: ChannelCronDeliveryAdapter = {\n    async normalizeDeliveryTarget(to, sessionStore) {\n      const { chatId, accountId } = await normalizeWeixinCronDeliveryToResolved(to, sessionStore);\n      return { chatId, accountId };\n    },\n  };\n\n  readonly onboard = weixinOnboardAdapter;\n\n  readonly cliLogin: ChannelCliLoginAdapter = {\n    async runLogin(params) {\n      const { runWeixinQrLoginCli } = await import('./cli/qr-login.js');\n      return runWeixinQrLoginCli({\n        configPath: params.configPath,\n        verbose: params.verbose,\n        timeoutMs: params.timeoutMs,\n        account: params.accountId,\n        writeConfig: params.writeConfig,\n      });\n    },\n  };\n\n  readonly configSurface = weixinConfigSurface;\n\n  readonly pairing = createStandardPairingAdapter('weixin');\n\n  readonly defaults: ChannelPluginDefaults = {\n    queue: { debounceMs: 0 },\n    outbound: { textChunkLimit: 4000 },\n    streaming: {\n      blockStreamingCoalesce: {\n        minChars: 200,\n        idleMs: 3000,\n      },\n    },\n  };\n\n  private bus!: ChannelPluginInitOptions['bus'];\n  private cfg!: Config;\n  private abortControllers = new Map<string, AbortController>();\n  /** Unregister fn for the workflow-progress capability registered against the global broker. */\n  private workflowProgressUnregister: (() => void) | null = null;\n\n  config = {\n    listAccountIds: (cfg: Config) => listWeixinAccountIds(cfg),\n    resolveAccount: (cfg: Config, accountId?: string | null) => resolveWeixinAccount(cfg, accountId),\n    isConfigured: async (account: ResolvedWeixinAccount) => account.configured,\n    describeAccount: (account: ResolvedWeixinAccount, _cfg: Config) => ({\n      accountId: account.accountId,\n      channelId: 'weixin',\n      name: account.name,\n      enabled: account.enabled,\n      configured: account.configured,\n      status: undefined,\n    }),\n  };\n\n  security = {\n    resolveDmPolicy: ({ account }: { account: ResolvedWeixinAccount }) =>\n      resolveDmPolicy(account.dmPolicy, 'open'),\n    checkAccess: (ctx: ChannelSecurityContext, account: ResolvedWeixinAccount, _cfg: Config) => {\n      const allowFrom = [...(account.allowFrom ?? []), ...readFrameworkAllowFromList(account.accountId)];\n      return evaluateAccess({\n        context: {\n          channel: 'weixin',\n          accountId: account.accountId,\n          chatId: ctx.chatId,\n          senderId: ctx.senderId,\n          senderName: ctx.senderName,\n          isGroup: false,\n          isDm: true,\n        },\n        dmPolicy: account.dmPolicy,\n        allowFrom,\n      });\n    },\n  };\n\n  outbound = {\n    deliveryMode: 'direct' as const,\n    chunker: weixinTextChunker,\n    chunkerMode: 'text' as const,\n    textChunkLimit: 4000,\n    ...createWeixinOutboundHandlers(),\n  };\n\n  streaming: ChannelStreamingAdapter = {\n    startStream: () => null,\n  };\n\n  /** Channel plugin hints (cron targets, media paths). */\n  agentPrompt = {\n    augmentSystemPrompt: (): string =>\n      [\n        'Weixin (ilink): direct chat only. To send an image or file, use the message tool with action send and set media to a local absolute path or an HTTPS URL; relative paths may fail.',\n        'For cron or scheduled delivery to a Weixin contact, set delivery.to to the user Weixin id (ending in @im.wechat) and delivery.accountId to the bot account id, or outbound may pick the wrong account.',\n        'When using MEDIA: to attach a file, put the MEDIA: line alone on its own line, not inline with other text.',\n      ].join('\\n'),\n  };\n\n  async init(options: ChannelPluginInitOptions): Promise<void> {\n    this.bus = options.bus;\n    this.cfg = options.config;\n\n    // Workflow progress broker capability — WeChat has no editMessage, so the\n    // capability runs in `final-only` mode: the broker silently drops every\n    // mid-run snapshot and only invokes us once when `tool_end` lands.\n    this.workflowProgressUnregister = getWorkflowProgressBroker().registerChannel(\n      createWeixinWorkflowProgressCapability({ getConfig: () => this.cfg }),\n    );\n\n    log.debug('Weixin plugin initialized');\n  }\n\n  async start(options?: ChannelPluginStartOptions): Promise<void> {\n    const ids = options?.accountId\n      ? [options.accountId]\n      : listWeixinAccountIds(this.cfg);\n\n    for (const accountId of ids) {\n      const account = resolveWeixinAccount(this.cfg, accountId);\n      if (!account.enabled || !account.configured || !account.token) continue;\n\n      if (this.abortControllers.has(accountId)) continue;\n\n      restoreContextTokens(account.accountId);\n\n      const ac = new AbortController();\n      this.abortControllers.set(accountId, ac);\n\n      void monitorWeixinProvider({\n        account,\n        config: this.cfg,\n        bus: this.bus,\n        abortSignal: ac.signal,\n      }).catch((err) => {\n        if ((err as { name?: string; message?: string } | undefined)?.name === 'AbortError') {\n          log.debug({ accountId }, 'Weixin monitor stopped');\n          return;\n        }\n        log.error({ err, accountId }, 'Weixin monitor exited with error');\n      });\n\n      log.info({ accountId }, 'Weixin monitor started');\n    }\n  }\n\n  async stop(accountId?: string): Promise<void> {\n    const ids = accountId ? [accountId] : [...this.abortControllers.keys()];\n    for (const id of ids) {\n      const ac = this.abortControllers.get(id);\n      if (ac) {\n        ac.abort();\n        this.abortControllers.delete(id);\n      }\n    }\n    // Only unregister the broker capability on a full stop. Per-account stops\n    // still leave the cap usable for other accounts.\n    if (!accountId) {\n      this.workflowProgressUnregister?.();\n      this.workflowProgressUnregister = null;\n    }\n  }\n\n  channelIsRunning(cfg: Config): boolean {\n    return listWeixinAccountIds(cfg).some((id) => {\n      const a = resolveWeixinAccount(cfg, id);\n      return a.configured && a.enabled !== false && this.abortControllers.has(id);\n    });\n  }\n\n  async onConfigUpdated(cfg: Config): Promise<void> {\n    const prevWx = this.cfg.channels?.weixin as unknown;\n    const nextWx = cfg.channels?.weixin as { enabled?: boolean } | undefined;\n    const channelOff = !nextWx || nextWx.enabled !== true;\n\n    if (channelOff) {\n      this.cfg = cfg;\n      await this.stop();\n      return;\n    }\n\n    this.cfg = cfg;\n\n    if (isDeepStrictEqual(prevWx, nextWx) && this.channelIsRunning(cfg)) {\n      return;\n    }\n\n    await this.stop();\n    await this.start();\n  }\n\n  /**\n   * Restart long-poll monitors after credentials were written to disk without a `channels.weixin` JSON\n   * delta (e.g. only token files / account index updated). Gateway calls this after QR login completes.\n   *\n   * Pass `bus` explicitly: if Weixin was disabled at gateway boot, `init()` was skipped and `this.bus` was never set.\n   */\n  async reloadMonitorsWithConfig(cfg: Config, bus: MessageBus): Promise<void> {\n    this.bus = bus;\n    this.cfg = cfg;\n    await this.stop();\n    await this.start();\n  }\n}\n\nexport const weixinPlugin = new WeixinChannelPlugin();\n"],"mappings":"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"}

package/dist/extensions/weixin/src/storage/sync-buf.js

@@ -1,6 +1,6 @@
 import { resolveWeixinRootDir } from "./state-dir.js";
-import fsSync from "node:fs";
 import path from "node:path";
+import fsSync from "node:fs";
 //#region extensions/weixin/src/storage/sync-buf.ts
 function resolveAccountsDir() {
 	return path.join(resolveWeixinRootDir(), "accounts");

package/dist/extensions/weixin/src/workflow-progress.d.ts

@@ -0,0 +1,26 @@
+/**
+ * WeChat capability for the workflow progress broker.
+ *
+ * WeChat (ilink/personal account) does not expose an "edit message" API for
+ * bot replies, so live edit-in-place — what Telegram and Feishu do — is
+ * structurally impossible. Trying to fake it with a `append` mode would
+ * spam the chat with one message per tick, which violates the social
+ * properties of the surface ("Don't @ me twenty times").
+ *
+ * Strategy: **final-only**. The broker silently drops every mid-run update;
+ * when `tool_end` fires, the broker calls us once with `isFinal: true` and
+ * the full final snapshot rendered as text. The user sees a single
+ * tasteful summary at the end.
+ *
+ * Routing: sessionKey `main:weixin:<accountId>:dm:<ilinkUserId>`. We need a
+ * valid `contextToken` for the recipient — which requires the user to have
+ * recently messaged the bot (the token is harvested from inbound). If
+ * missing, we throw and the broker logs; the run still completes, just
+ * without a WeChat notification. This is consistent with how other WeChat
+ * outbound paths behave.
+ */
+import type { ChannelProgressCapability } from '@xopcai/xopc/agent/workflow/index.js';
+import type { Config } from '@xopcai/xopc/config/schema.js';
+export declare function createWeixinWorkflowProgressCapability(opts: {
+    getConfig: () => Config | undefined;
+}): ChannelProgressCapability;

package/dist/extensions/weixin/src/workflow-progress.js

@@ -0,0 +1,99 @@
+import { init_session_key, parseSessionKey } from "../../../src/routing/session-key.js";
+import { createLogger } from "../../../src/utils/logger/index.js";
+import { init_logger } from "../../../src/utils/logger.js";
+import { getContextToken } from "./messaging/inbound.js";
+import { resolveWeixinAccount } from "./auth/accounts.js";
+import { sendMessageWeixin } from "./messaging/send.js";
+import { ensureWeixinContextTokenForOutbound } from "./messaging/context-token-init.js";
+//#region extensions/weixin/src/workflow-progress.ts
+init_session_key();
+init_logger();
+const log = createLogger("WeixinWorkflowProgress");
+const WEIXIN_TEXT_MAX = 4e3;
+/**
+* Conservative throttle — only enforced when the user overrides the default
+* `final-only` mode to `append`. Set so back-to-back workflows can't spam.
+*/
+const DEFAULT_THROTTLE_MS = 6e4;
+function createWeixinWorkflowProgressCapability(opts) {
+	return {
+		channelId: "weixin",
+		supportsEdit: false,
+		defaultThrottleMs: DEFAULT_THROTTLE_MS,
+		defaultMode: "final-only",
+		async postProgress(input) {
+			const cfg = opts.getConfig();
+			if (!cfg) throw new Error("weixin workflow progress: no config loaded");
+			const target = resolveTarget(input.sessionKey);
+			if (!target) throw new Error(`weixin workflow progress: cannot route sessionKey "${input.sessionKey}"`);
+			let account;
+			try {
+				account = resolveWeixinAccount(cfg, target.accountId);
+			} catch (err) {
+				throw new Error(`weixin workflow progress: cannot resolve account "${target.accountId}": ${errorMessage(err)}`);
+			}
+			if (!account.configured || !account.token) throw new Error(`weixin workflow progress: account "${target.accountId}" not configured / logged in`);
+			let ctxTok = getContextToken(account.accountId, target.to)?.trim();
+			if (!ctxTok) ctxTok = (await ensureWeixinContextTokenForOutbound(account.accountId, target.to, account))?.trim();
+			if (!ctxTok) {
+				log.debug({
+					sessionKey: input.sessionKey,
+					accountId: account.accountId
+				}, "no context token for recipient; skipping workflow progress send");
+				return { messageId: "" };
+			}
+			const text = clampForWeixin(decorateForWeixin(input.text, input.mode, input.isFinal));
+			return { messageId: (await sendMessageWeixin({
+				to: target.to,
+				text,
+				opts: {
+					baseUrl: account.baseUrl,
+					token: account.token,
+					routeTag: account.routeTag,
+					contextToken: ctxTok
+				}
+			})).messageId };
+		}
+	};
+}
+function resolveTarget(sessionKey) {
+	const parsed = parseSessionKey(sessionKey);
+	if (!parsed) return null;
+	if (parsed.source !== "weixin") return null;
+	if (!parsed.peerId) return null;
+	return {
+		accountId: parsed.accountId || "default",
+		to: parsed.peerId
+	};
+}
+function clampForWeixin(text) {
+	if (text.length <= WEIXIN_TEXT_MAX) return text;
+	return `${text.slice(0, WEIXIN_TEXT_MAX - 1)}…`;
+}
+/**
+* Add a one-line header on append-mode messages so the user can tell mid-run
+* snapshots apart from the final summary — WeChat has no editMessage, so they
+* pile up as separate messages and look identical without a marker.
+*
+*   - `final-only` mode: no header (default; one summary message per run).
+*   - `append` mode + mid-run: "▾ 工作流进展" header so the user knows more
+*     updates are coming.
+*   - `append` mode + final: "✓ 工作流完成" header to mark the conclusion.
+*
+* `edit` mode is never reached on WeChat (`supportsEdit: false`), so we don't
+* branch on it. Unknown / missing mode falls through to no header — safe
+* default for hand-rolled callers and tests.
+*/
+function decorateForWeixin(text, mode, isFinal) {
+	if (mode !== "append") return text;
+	return `${isFinal ? "✓ 工作流完成" : "▾ 工作流进展"}\n${text}`;
+}
+function errorMessage(err) {
+	if (!err) return "";
+	if (err instanceof Error) return err.message;
+	return String(err);
+}
+//#endregion
+export { createWeixinWorkflowProgressCapability };
+
+//# sourceMappingURL=workflow-progress.js.map

package/dist/extensions/weixin/src/workflow-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-progress.js","names":[],"sources":["../../../../extensions/weixin/src/workflow-progress.ts"],"sourcesContent":["/**\n * WeChat capability for the workflow progress broker.\n *\n * WeChat (ilink/personal account) does not expose an \"edit message\" API for\n * bot replies, so live edit-in-place — what Telegram and Feishu do — is\n * structurally impossible. Trying to fake it with a `append` mode would\n * spam the chat with one message per tick, which violates the social\n * properties of the surface (\"Don't @ me twenty times\").\n *\n * Strategy: **final-only**. The broker silently drops every mid-run update;\n * when `tool_end` fires, the broker calls us once with `isFinal: true` and\n * the full final snapshot rendered as text. The user sees a single\n * tasteful summary at the end.\n *\n * Routing: sessionKey `main:weixin:<accountId>:dm:<ilinkUserId>`. We need a\n * valid `contextToken` for the recipient — which requires the user to have\n * recently messaged the bot (the token is harvested from inbound). If\n * missing, we throw and the broker logs; the run still completes, just\n * without a WeChat notification. This is consistent with how other WeChat\n * outbound paths behave.\n */\n\nimport type {\n  ChannelProgressCapability,\n  WorkflowProgressPostInput,\n} from '@xopcai/xopc/agent/workflow/index.js';\nimport type { Config } from '@xopcai/xopc/config/schema.js';\nimport { parseSessionKey } from '@xopcai/xopc/routing/session-key.js';\nimport { createLogger } from '@xopcai/xopc/utils/logger.js';\n\nimport { resolveWeixinAccount } from './auth/accounts.js';\nimport { ensureWeixinContextTokenForOutbound } from './messaging/context-token-init.js';\nimport { getContextToken } from './messaging/inbound.js';\nimport { sendMessageWeixin } from './messaging/send.js';\n\nconst log = createLogger('WeixinWorkflowProgress');\n\nconst WEIXIN_TEXT_MAX = 4_000;\n/**\n * Conservative throttle — only enforced when the user overrides the default\n * `final-only` mode to `append`. Set so back-to-back workflows can't spam.\n */\nconst DEFAULT_THROTTLE_MS = 60_000;\n\nexport function createWeixinWorkflowProgressCapability(opts: {\n  getConfig: () => Config | undefined;\n}): ChannelProgressCapability {\n  return {\n    channelId: 'weixin',\n    supportsEdit: false,\n    defaultThrottleMs: DEFAULT_THROTTLE_MS,\n    defaultMode: 'final-only',\n\n    async postProgress(input: WorkflowProgressPostInput) {\n      const cfg = opts.getConfig();\n      if (!cfg) {\n        throw new Error('weixin workflow progress: no config loaded');\n      }\n      const target = resolveTarget(input.sessionKey);\n      if (!target) {\n        throw new Error(`weixin workflow progress: cannot route sessionKey \"${input.sessionKey}\"`);\n      }\n\n      let account;\n      try {\n        account = resolveWeixinAccount(cfg, target.accountId);\n      } catch (err) {\n        throw new Error(\n          `weixin workflow progress: cannot resolve account \"${target.accountId}\": ${errorMessage(err)}`,\n        );\n      }\n      if (!account.configured || !account.token) {\n        throw new Error(\n          `weixin workflow progress: account \"${target.accountId}\" not configured / logged in`,\n        );\n      }\n\n      let ctxTok = getContextToken(account.accountId, target.to)?.trim();\n      if (!ctxTok) {\n        ctxTok = (await ensureWeixinContextTokenForOutbound(account.accountId, target.to, account))?.trim();\n      }\n      if (!ctxTok) {\n        // No usable context token — without one WeChat refuses outbound. Better\n        // to drop the progress notice than to spam an error; the parent agent\n        // still surfaces the result through its normal reply path.\n        log.debug(\n          { sessionKey: input.sessionKey, accountId: account.accountId },\n          'no context token for recipient; skipping workflow progress send',\n        );\n        return { messageId: '' };\n      }\n\n      const text = clampForWeixin(decorateForWeixin(input.text, input.mode, input.isFinal));\n      const r = await sendMessageWeixin({\n        to: target.to,\n        text,\n        opts: {\n          baseUrl: account.baseUrl,\n          token: account.token,\n          routeTag: account.routeTag,\n          contextToken: ctxTok,\n        },\n      });\n      return { messageId: r.messageId };\n    },\n  };\n}\n\ninterface ResolvedTarget {\n  accountId: string;\n  to: string;\n}\n\nfunction resolveTarget(sessionKey: string): ResolvedTarget | null {\n  const parsed = parseSessionKey(sessionKey);\n  if (!parsed) return null;\n  if (parsed.source !== 'weixin') return null;\n  if (!parsed.peerId) return null;\n  return {\n    accountId: parsed.accountId || 'default',\n    to: parsed.peerId,\n  };\n}\n\nfunction clampForWeixin(text: string): string {\n  if (text.length <= WEIXIN_TEXT_MAX) return text;\n  return `${text.slice(0, WEIXIN_TEXT_MAX - 1)}…`;\n}\n\n/**\n * Add a one-line header on append-mode messages so the user can tell mid-run\n * snapshots apart from the final summary — WeChat has no editMessage, so they\n * pile up as separate messages and look identical without a marker.\n *\n *   - `final-only` mode: no header (default; one summary message per run).\n *   - `append` mode + mid-run: \"▾ 工作流进展\" header so the user knows more\n *     updates are coming.\n *   - `append` mode + final: \"✓ 工作流完成\" header to mark the conclusion.\n *\n * `edit` mode is never reached on WeChat (`supportsEdit: false`), so we don't\n * branch on it. Unknown / missing mode falls through to no header — safe\n * default for hand-rolled callers and tests.\n */\nfunction decorateForWeixin(\n  text: string,\n  mode: string | undefined,\n  isFinal: boolean,\n): string {\n  if (mode !== 'append') return text;\n  const header = isFinal ? '✓ 工作流完成' : '▾ 工作流进展';\n  return `${header}\\n${text}`;\n}\n\nfunction errorMessage(err: unknown): string {\n  if (!err) return '';\n  if (err instanceof Error) return err.message;\n  return String(err);\n}\n"],"mappings":";;;;;;;;kBA2BsE;aACV;AAO5D,MAAM,MAAM,aAAa,yBAAyB;AAElD,MAAM,kBAAkB;;;;;AAKxB,MAAM,sBAAsB;AAE5B,SAAgB,uCAAuC,MAEzB;AAC5B,QAAO;EACL,WAAW;EACX,cAAc;EACd,mBAAmB;EACnB,aAAa;EAEb,MAAM,aAAa,OAAkC;GACnD,MAAM,MAAM,KAAK,WAAW;AAC5B,OAAI,CAAC,IACH,OAAM,IAAI,MAAM,6CAA6C;GAE/D,MAAM,SAAS,cAAc,MAAM,WAAW;AAC9C,OAAI,CAAC,OACH,OAAM,IAAI,MAAM,sDAAsD,MAAM,WAAW,GAAG;GAG5F,IAAI;AACJ,OAAI;AACF,cAAU,qBAAqB,KAAK,OAAO,UAAU;YAC9C,KAAK;AACZ,UAAM,IAAI,MACR,qDAAqD,OAAO,UAAU,KAAK,aAAa,IAAI,GAC7F;;AAEH,OAAI,CAAC,QAAQ,cAAc,CAAC,QAAQ,MAClC,OAAM,IAAI,MACR,sCAAsC,OAAO,UAAU,8BACxD;GAGH,IAAI,SAAS,gBAAgB,QAAQ,WAAW,OAAO,GAAG,EAAE,MAAM;AAClE,OAAI,CAAC,OACH,WAAU,MAAM,oCAAoC,QAAQ,WAAW,OAAO,IAAI,QAAQ,GAAG,MAAM;AAErG,OAAI,CAAC,QAAQ;AAIX,QAAI,MACF;KAAE,YAAY,MAAM;KAAY,WAAW,QAAQ;KAAW,EAC9D,kEACD;AACD,WAAO,EAAE,WAAW,IAAI;;GAG1B,MAAM,OAAO,eAAe,kBAAkB,MAAM,MAAM,MAAM,MAAM,MAAM,QAAQ,CAAC;AAWrF,UAAO,EAAE,YAAW,MAVJ,kBAAkB;IAChC,IAAI,OAAO;IACX;IACA,MAAM;KACJ,SAAS,QAAQ;KACjB,OAAO,QAAQ;KACf,UAAU,QAAQ;KAClB,cAAc;KACf;IACF,CAAC,EACoB,WAAW;;EAEpC;;AAQH,SAAS,cAAc,YAA2C;CAChE,MAAM,SAAS,gBAAgB,WAAW;AAC1C,KAAI,CAAC,OAAQ,QAAO;AACpB,KAAI,OAAO,WAAW,SAAU,QAAO;AACvC,KAAI,CAAC,OAAO,OAAQ,QAAO;AAC3B,QAAO;EACL,WAAW,OAAO,aAAa;EAC/B,IAAI,OAAO;EACZ;;AAGH,SAAS,eAAe,MAAsB;AAC5C,KAAI,KAAK,UAAU,gBAAiB,QAAO;AAC3C,QAAO,GAAG,KAAK,MAAM,GAAG,kBAAkB,EAAE,CAAC;;;;;;;;;;;;;;;;AAiB/C,SAAS,kBACP,MACA,MACA,SACQ;AACR,KAAI,SAAS,SAAU,QAAO;AAE9B,QAAO,GADQ,UAAU,YAAY,UACpB,IAAI;;AAGvB,SAAS,aAAa,KAAsB;AAC1C,KAAI,CAAC,IAAK,QAAO;AACjB,KAAI,eAAe,MAAO,QAAO,IAAI;AACrC,QAAO,OAAO,IAAI"}