@xopcai/xopc 0.0.103 → 0.0.104

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';\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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"}
+{"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 {\n  ChannelCliLoginAdapter,\n  ChannelCronDeliveryAdapter,\n  ChannelRuntimeActionAdapter,\n} 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 runtimeActions: ChannelRuntimeActionAdapter = {\n    runAction: async ({ actionId, accountId, input, locale }) => {\n      const zh = locale?.toLowerCase().startsWith('zh') === true;\n      if (actionId === 'login.start') {\n        const { startWeixinGatewayQrLogin } = await import('./cli/gateway-qr-login.js');\n        const inputRecord =\n          input && typeof input === 'object' && !Array.isArray(input)\n            ? (input as Record<string, unknown>)\n            : {};\n        const timeoutMs = typeof inputRecord.timeoutMs === 'number' ? inputRecord.timeoutMs : 480_000;\n        const start = await startWeixinGatewayQrLogin({\n          account: accountId,\n          timeoutMs,\n          onPersisted: async (result) => {\n            if (!result.ok) return;\n            const { loadConfig } = await import('@xopcai/xopc/config/loader.js');\n            await this.reloadMonitorsWithConfig(loadConfig(), this.bus);\n          },\n        });\n        if (start.ok === false) {\n          return { ok: false, message: start.message };\n        }\n        return {\n          ok: true,\n          payload: {\n            type: 'qr',\n            sessionKey: start.sessionKey,\n            qrcodeUrl: start.qrcodeUrl,\n            statusAction: 'login.status',\n            pollIntervalMs: 2500,\n            message: zh ? '请使用微信扫描二维码。' : 'Scan the QR code with WeChat.',\n          },\n        };\n      }\n\n      if (actionId === 'login.status') {\n        const inputRecord =\n          input && typeof input === 'object' && !Array.isArray(input)\n            ? (input as Record<string, unknown>)\n            : {};\n        const sessionKey = typeof inputRecord.sessionKey === 'string' ? inputRecord.sessionKey : '';\n        if (!sessionKey) return { ok: false, message: zh ? '缺少登录 sessionKey' : 'Missing login sessionKey' };\n        const { getWeixinGatewayQrLoginStatus } = await import('./cli/gateway-qr-login.js');\n        const status = getWeixinGatewayQrLoginStatus(sessionKey);\n        if (status.phase === 'polling') {\n          return {\n            ok: true,\n            payload: {\n              type: 'poll',\n              phase: 'pending',\n              qrcodeUrl: status.qrcodeUrl,\n              qrStatus: status.qrStatus,\n              message: status.qrStatus,\n            },\n          };\n        }\n        if (status.phase === 'done') {\n          return {\n            ok: true,\n            payload: {\n              type: 'poll',\n              phase: 'done',\n              ok: status.ok,\n              accountId: status.ok ? status.accountId : undefined,\n              message: status.ok === true ? (zh ? '微信登录完成。' : 'Weixin login complete.') : status.message,\n              configChanged: status.ok,\n            },\n          };\n        }\n        return {\n          ok: true,\n          payload: {\n            type: 'poll',\n            phase: 'unknown',\n            ok: false,\n            message: status.message,\n          },\n        };\n      }\n\n      return { ok: false, message: `Unsupported Weixin action: ${actionId}` };\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/xopc.extension.json

@@ -6,6 +6,58 @@
   "kind": "channel",
   "main": "src/index.ts",
   "channels": ["weixin"],
+  "channelContributions": {
+    "weixin": {
+      "label": "Weixin",
+      "description": "Personal WeChat channel through QR login",
+      "docsPath": "/channels/weixin",
+      "order": 20,
+      "configPath": "channels.weixin",
+      "capabilities": {
+        "login": true,
+        "pairing": true,
+        "doctor": false,
+        "multiAccount": true,
+        "streaming": true,
+        "media": true
+      },
+      "configSchema": {
+        "type": "object",
+        "additionalProperties": true,
+        "properties": {
+          "enabled": { "type": "boolean", "default": false, "title": "Enabled" },
+          "accounts": { "type": "object", "additionalProperties": true, "title": "Accounts" },
+          "dmPolicy": {
+            "type": "string",
+            "enum": ["pairing", "allowlist", "open", "disabled"],
+            "default": "open",
+            "title": "DM policy"
+          }
+        }
+      },
+      "actions": {
+        "login.start": { "label": "Log in", "result": "qr" },
+        "login.status": { "label": "Login status", "result": "poll" }
+      },
+      "i18n": {
+        "zh": {
+          "label": "微信",
+          "description": "通过扫码登录的个人微信消息通道",
+          "configSchema": {
+            "properties": {
+              "enabled": { "title": "启用" },
+              "accounts": { "title": "账号" },
+              "dmPolicy": { "title": "私聊策略" }
+            }
+          },
+          "actions": {
+            "login.start": { "label": "微信扫码登录" },
+            "login.status": { "label": "登录状态" }
+          }
+        }
+      }
+    }
+  },
   "activation": {
     "onChannels": ["weixin"],
     "onCapabilities": ["channel"]