@michengai/dsh-im-connect 0.1.37 → 0.1.38

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (74) hide show
  1. package/CHANGELOG.md +11 -0
  2. package/CHANGELOG.zh-CN.md +11 -0
  3. package/README.en.md +17 -3
  4. package/README.md +17 -3
  5. package/SECURITY.md +7 -2
  6. package/client.js +3 -2
  7. package/lib/channels/channel-image-download.d.ts +22 -0
  8. package/lib/channels/channel-image-download.d.ts.map +1 -0
  9. package/lib/channels/channel-image-download.js +179 -0
  10. package/lib/channels/channel-image-download.js.map +1 -0
  11. package/lib/channels/dingtalk-token-cache.d.ts +18 -0
  12. package/lib/channels/dingtalk-token-cache.d.ts.map +1 -0
  13. package/lib/channels/dingtalk-token-cache.js +48 -0
  14. package/lib/channels/dingtalk-token-cache.js.map +1 -0
  15. package/lib/channels/dingtalk.d.ts +17 -4
  16. package/lib/channels/dingtalk.d.ts.map +1 -1
  17. package/lib/channels/dingtalk.js +111 -18
  18. package/lib/channels/dingtalk.js.map +1 -1
  19. package/lib/channels/factory.d.ts.map +1 -1
  20. package/lib/channels/factory.js +6 -3
  21. package/lib/channels/factory.js.map +1 -1
  22. package/lib/channels/feishu.d.ts +30 -2
  23. package/lib/channels/feishu.d.ts.map +1 -1
  24. package/lib/channels/feishu.js +141 -26
  25. package/lib/channels/feishu.js.map +1 -1
  26. package/lib/channels/image-host-policy.d.ts +4 -0
  27. package/lib/channels/image-host-policy.d.ts.map +1 -0
  28. package/lib/channels/image-host-policy.js +24 -0
  29. package/lib/channels/image-host-policy.js.map +1 -0
  30. package/lib/channels/qq.d.ts +1 -0
  31. package/lib/channels/qq.d.ts.map +1 -1
  32. package/lib/channels/qq.js +89 -18
  33. package/lib/channels/qq.js.map +1 -1
  34. package/lib/channels/telegram.d.ts.map +1 -1
  35. package/lib/channels/telegram.js +121 -16
  36. package/lib/channels/telegram.js.map +1 -1
  37. package/lib/channels/wecom.d.ts +8 -2
  38. package/lib/channels/wecom.d.ts.map +1 -1
  39. package/lib/channels/wecom.js +60 -11
  40. package/lib/channels/wecom.js.map +1 -1
  41. package/lib/channels/weixin.d.ts.map +1 -1
  42. package/lib/channels/weixin.js +169 -17
  43. package/lib/channels/weixin.js.map +1 -1
  44. package/lib/client.js +3 -2
  45. package/lib/engine/gateway.d.ts +2 -0
  46. package/lib/engine/gateway.d.ts.map +1 -1
  47. package/lib/engine/gateway.js +48 -11
  48. package/lib/engine/gateway.js.map +1 -1
  49. package/lib/engine/image-input.d.ts +8 -0
  50. package/lib/engine/image-input.d.ts.map +1 -0
  51. package/lib/engine/image-input.js +31 -0
  52. package/lib/engine/image-input.js.map +1 -0
  53. package/lib/engine/router.d.ts.map +1 -1
  54. package/lib/engine/router.js +29 -19
  55. package/lib/engine/router.js.map +1 -1
  56. package/lib/manager.d.ts +0 -10
  57. package/lib/manager.d.ts.map +1 -1
  58. package/lib/manager.js +231 -203
  59. package/lib/manager.js.map +1 -1
  60. package/package.json +1 -1
  61. package/src/channels/channel-image-download.ts +154 -0
  62. package/src/channels/dingtalk-token-cache.ts +39 -0
  63. package/src/channels/dingtalk.ts +106 -27
  64. package/src/channels/factory.ts +6 -3
  65. package/src/channels/feishu.ts +126 -24
  66. package/src/channels/image-host-policy.ts +21 -0
  67. package/src/channels/qq.ts +80 -26
  68. package/src/channels/telegram.ts +105 -16
  69. package/src/channels/wecom.ts +57 -12
  70. package/src/channels/weixin.ts +124 -14
  71. package/src/engine/gateway.ts +35 -6
  72. package/src/engine/image-input.ts +26 -0
  73. package/src/engine/router.ts +28 -18
  74. package/src/manager.ts +116 -84
package/CHANGELOG.md CHANGED
@@ -6,6 +6,17 @@ The five most recent published versions are listed below. Git tags and GitHub Re
6
6
 
7
7
  ## Unreleased
8
8
 
9
+ ## 0.1.38 - 2026-09-08
10
+
11
+ - Fix #11: move the settings API to `/api/dsh-im-connect`, following the REST prefix used by other DSH plugins. The route uses DSH’s public `connection.requestRejection`, preserving trusted-host, Origin, and authority-bound browser-cookie checks behind reverse proxies. Local requests also require login; unavailable authentication fails closed with retry/upgrade guidance.
12
+ - Keep account, model, pairing, and session routes unchanged; send same-origin credentials explicitly, disable management caching, and cover real Host authentication plus frontend transport regressions.
13
+
14
+ - Add native inbound images for WeChat, WeCom, DingTalk, Feishu, Lark, QQ, and Telegram through DSH Chat's current-session model checks and durable attachment admission; prevent account defaults from overriding Chat's selected model.
15
+ - Route QQ image downloads through the DNS-validated downloader while preserving whole-message budgets, cancellation, and deadlines. Allow administrators to configure additional exact image hosts per account instead of patching region-specific COS/OSS origins.
16
+ - Reuse DingTalk access tokens per account, coalesce concurrent token requests, and invalidate the cache on expiry, stop, or restart.
17
+ - Classify WeChat image failures and retry transient network/server failures within a bounded budget. Never downgrade failed image captions to text commands or retry/deliver stale input after stop.
18
+ - Extend image security, ordering, lifecycle, real host-admission, and durable-storage regression tests. Track live channel and vision-model verification separately from transport fixtures.
19
+
9
20
  ## 0.1.37 - 2026-09-07
10
21
 
11
22
  - Withdraw the unfinished proactive delivery feature, including account delivery settings, `im-send`, Agent tools, and delivery HTTP endpoints. Existing IM replies and plugin update controls are retained.
@@ -6,6 +6,17 @@
6
6
 
7
7
  ## 未发布
8
8
 
9
+ ## 0.1.38 - 2026-09-08
10
+
11
+ - 修复 #11:设置页管理 API 迁至 `/api/dsh-im-connect`,遵循其他 DSH 插件的 REST 前缀。接口通过 DSH 公开的 `connection.requestRejection`,反向代理下保留可信 Host、Origin 和绑定访问地址的浏览器 Cookie 校验。本机请求也必须登录;认证不可用时安全关闭并提示稍后重试或升级。
12
+ - 保留账号、模型、扫码与会话管理路由;前端显式携带同源凭据,禁止缓存管理数据,并增加真实宿主认证及前端调用回归测试。
13
+
14
+ - 为微信、企业微信、钉钉、飞书、Lark、QQ 和 Telegram 接入原生图片消息,复用 DSH Chat 的当前会话模型判断、附件校验与持久化;修复账号默认模型覆盖 Chat 会话模型的问题。
15
+ - QQ 图片下载统一使用连接时 DNS 校验的安全下载器,保留整条消息大小预算、取消与超时;支持管理员按账号配置额外的精确图片主机,避免为区域 COS/OSS 地址反复修改代码。
16
+ - 钉钉图片下载复用账号级 access token 缓存,合并并发取 token 请求,并在到期、停止或重新连接时失效。
17
+ - 微信图片下载区分失败原因,对瞬时网络/服务端故障进行有限重试;失败时不把图片附言降级为纯文字指令,停止后不继续重试或投递旧消息。
18
+ - 增加图片安全、顺序、生命周期、宿主图片准入和附件持久化回归测试;真实渠道与视觉模型联调状态单独记录,不以自动化夹具替代。
19
+
9
20
  ## 0.1.37 - 2026-09-07
10
21
 
11
22
  - 撤回尚未开发完成的主动投递功能,包括账号投递设置、`im-send`、Agent 工具及投递 HTTP 接口;保留原有 IM 对话回复和插件更新功能。
package/README.en.md CHANGED
@@ -73,6 +73,18 @@ WeChat is QR-only and DM-only, so the same WeChat account that scanned can talk
73
73
 
74
74
  ✅ Ready = text in and out works | *WeChat = official iLink only, no reverse-engineered personal protocol | Groups still require an @ mention
75
75
 
76
+ ## Image input
77
+
78
+ Image input follows DSH Chat's model-capability and attachment rules rather than guessing vision support from model names:
79
+
80
+ The receive paths cover WeChat, WeCom, DingTalk, Feishu, Lark, QQ, and Telegram. See the [image-input verification guide](docs/image-input.md) for protocol forms and live checks.
81
+
82
+ - Use the model currently selected for the IM session, not just the global default.
83
+ - When the model declares `image` support, store images as standard DSH attachments and submit image content to the model. Session history keeps image references rather than only local-path text.
84
+ - When the model explicitly excludes image input, tell the sender to switch models instead of silently dropping the image. Missing capability metadata follows Chat's compatibility behavior and is not, by itself, a reason to reject an image.
85
+ - Channel download limits, host attachment size and format limits, DM access rules, and group mention requirements still apply.
86
+ - This is inbound image analysis, not a promise that every channel supports sending images from the bot or generating images.
87
+
76
88
  ## Screenshots
77
89
 
78
90
  Add accounts under each channel in **Settings → IM Assistant**. Expand a channel, select an account, and configure its workspace, model, permission, private access, and receive state independently on the right:
@@ -215,7 +227,7 @@ DingTalk replies prefer official AI Card streaming and fall back to plain text.
215
227
  | Item | Current behavior |
216
228
  | --- | --- |
217
229
  | Access | Groups need no binding, only a mention. Each account can allow only approved users or all DM users; approved-only is the default, and WeChat / Feishu / Lark / QQ QR scanners are added to that account's allowlist automatically |
218
- | Management API | Enforces both a loopback peer and loopback host (`localhost`, `127.0.0.1`, `[::1]`); mutations require JSON and the plugin client header |
230
+ | Management API | Uses `/api/dsh-im-connect`, following the REST prefix used by other DSH plugins. It delegates Host, Origin, and Cookie checks to Host `connection.requestRejection`, including local requests. Unavailable authentication returns 503; mutations retain JSON, client-header, and 1 MiB limits |
219
231
  | Secrets | WeChat tokens and other secrets prefer DSH `ctx.credentials`; otherwise they use plaintext `%DSH_HOME%\dsh-im-connect\secrets.json`, restricted to the current user and never safe to sync or share |
220
232
  | Account state | `channels.json` stores per-account workspace, model, permission, private access, enablement, and credential refs, not raw secrets |
221
233
  | Browser payloads | Never include tokens, secrets, App Secrets, or internal error details |
@@ -223,14 +235,14 @@ DingTalk replies prefer official AI Card streaming and fall back to plain text.
223
235
  | Tool approval | Only a user on the current account's allowlist can grant or deny in a DM. Even when all DM users may chat, unapproved users cannot approve tools; approvals cannot cross conversations or come from groups |
224
236
  | Interactive questions | Single-choice, multiple-choice, and custom questions return to the originating IM conversation; one conversation handles them in order, and only the initiating user can answer in a group |
225
237
 
226
- Do not expose DSH Web beyond this machine. Permission presets use the same host sandbox-policy values as Chat; `danger-full-access` does not wrap a sandbox.
238
+ Keep the DSH backend listening on loopback. Remote access should use a controlled HTTPS reverse proxy, the actual authority in the Host's `trustedHosts`, and a login through that authority. Do not spoof localhost or remove authentication to bypass 403. Image-download `additionalImageHosts` does not configure management access; see [management authentication](SECURITY.md#管理面). Permission presets use the same host sandbox-policy values as Chat; `danger-full-access` does not wrap a sandbox.
227
239
 
228
240
  ## Secondary development
229
241
 
230
242
  This repository develops in `src` and builds to `lib`:
231
243
 
232
244
  - [src\index.ts](src/index.ts): host entry, config, and lifecycle.
233
- - [src\manager.ts](src/manager.ts): channel start/stop, loopback API, and credential persistence.
245
+ - [src\manager.ts](src/manager.ts): channel start/stop, authenticated management API, and credential persistence.
234
246
  - [src\engine](src/engine): session routing, slash commands, approval, splitting, and outbound push.
235
247
  - [src\channels](src/channels): DingTalk, Feishu, Lark, WeChat, WeCom, QQ, and Telegram adapters.
236
248
  - `client.js`: settings page and workspace channel sidebar.
@@ -249,6 +261,8 @@ When changing channel or session logic, keep the engine platform-agnostic, keep
249
261
 
250
262
  ## Validation
251
263
 
264
+ For real management-authentication tests, set `DSH_CONNECTION_CONTRACT_ROOT` to the isolated `@deepseek-ai/dsh-client-connection` package root. The Gateway-coexistence case also uses `DSH_CHAT_CONTRACT_ROOT` from the image contracts. Local runs skip these contracts when unconfigured; CI supplies both. Tests use temporary HTTP servers and credentials, not a live Cloudflare deployment.
265
+
252
266
  ```powershell
253
267
  [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
254
268
  $OutputEncoding = [System.Text.Encoding]::UTF8
package/README.md CHANGED
@@ -73,6 +73,18 @@
73
73
 
74
74
  ✅ 可用 = 文字收发可用 | *微信 = 只走腾讯官方 iLink,不做逆向个人号 | 群聊都需要 @ 机器人才回复
75
75
 
76
+ ## 图片输入
77
+
78
+ 图片输入使用与 DSH Chat 一致的模型能力和附件规则,不按模型名称猜测视觉能力:
79
+
80
+ 覆盖微信、企业微信、钉钉、飞书、Lark、QQ 和 Telegram;具体平台消息形式和联调检查见[图片输入验收](docs/image-input.md)。
81
+
82
+ - 以当前 IM 会话实际使用的模型为准,而不是只看全局默认模型。
83
+ - 模型声明支持 `image` 时,将图片保存为 DSH 标准图片附件并提交给模型;会话记录保留图片引用,而不是只有本地文件路径文字。
84
+ - 模型明确不支持图片时,在 IM 提示切换模型,不静默丢图。模型未提供能力元数据时,遵循 Chat 的兼容规则,不仅因元数据缺失而拒绝。
85
+ - 图片仍受渠道下载限制、宿主附件大小与格式限制,以及原有私聊准入和群聊 @ 规则约束。
86
+ - 此功能是用户向机器人发送图片进行分析,不代表所有渠道都支持机器人发送图片或生成图片。
87
+
76
88
  ## 界面预览
77
89
 
78
90
  在「设置 → IM助理」按渠道添加账号。展开渠道后选择账号,在右侧独立配置工作区、模型、权限、私聊准入和接收状态:
@@ -215,7 +227,7 @@ dsh --profile web --dump-config
215
227
  | 项 | 当前行为 |
216
228
  | --- | --- |
217
229
  | 用户准入 | 群聊不用绑定,只需 @。每个账号可选择「仅已批准用户」或「允许所有私聊用户」;默认仅批准用户可用,微信 / 飞书 / Lark / QQ 扫码者会自动加入该账号白名单 |
218
- | 管理接口 | 强制校验本机回环来源及 Host(`localhost` / `127.0.0.1` / `[::1]`);写接口要求 JSON 和插件客户端请求头 |
230
+ | 管理接口 | `/api/dsh-im-connect`;通过宿主 `connection.requestRejection` 验证 Host、Origin 和 Cookie,本机也须登录;认证不可用返回 503,写接口保留 JSON、客户端请求头和 1 MiB 限制 |
219
231
  | 敏感字段 | 包括微信 token 在内均优先写入 DSH `ctx.credentials`;没有该服务时落到 `%DSH_HOME%\dsh-im-connect\secrets.json`(明文,仅限当前用户,禁止同步或分享) |
220
232
  | 账号状态 | `channels.json` 按账号保存工作区、模型、权限、私聊准入、启用状态和凭据引用,不保存明文 Secret |
221
233
  | 浏览器回包 | 不返回 token、secret、App Secret 或内部异常详情 |
@@ -223,14 +235,14 @@ dsh --profile web --dump-config
223
235
  | 工具批准 | 仅私聊且发送者已在当前账号白名单时生效;即使账号允许所有私聊用户,未批准用户也不能审批工具,且不能跨会话或在群里批准 |
224
236
  | 交互问题 | 单选、多选和自定义问题回到发起任务的 IM 会话;同一会话按顺序处理,群聊只接受任务发起者回答 |
225
237
 
226
- 不要把 DSH Web 暴露到非本机地址。权限预设与 Chat 使用相同的 Host sandbox-policy;`danger-full-access` 不套沙箱。
238
+ DSH 后端保持本机监听;远程访问使用受控 HTTPS 反向代理,并在宿主配置实际访问地址的 `trustedHosts`、通过该地址登录。不要伪装 localhost 或删除认证检查来绕过 403;图片下载的 `additionalImageHosts` 不用于管理接口。详见 [管理面认证](SECURITY.md#管理面)。权限预设与 Chat 使用相同的 Host sandbox-policy;`danger-full-access` 不套沙箱。
227
239
 
228
240
  ## 二次开发
229
241
 
230
242
  本仓库用 `src` 开发,构建到 `lib`:
231
243
 
232
244
  - [src\index.ts](src/index.ts):Host 入口、配置和生命周期。
233
- - [src\manager.ts](src/manager.ts):渠道启停、本机 API、凭据落盘。
245
+ - [src\manager.ts](src/manager.ts):渠道启停、已认证管理 API、凭据落盘。
234
246
  - [src\engine](src/engine):会话路由、斜杠命令、审批、分片和回推。
235
247
  - [src\channels](src/channels):钉钉、飞书、Lark、微信、企业微信、QQ、Telegram 适配器。
236
248
  - `client.js`:设置页和工作区频道侧栏。
@@ -249,6 +261,8 @@ dsh plugin --profile web add .
249
261
 
250
262
  ## 验证
251
263
 
264
+ 真实管理认证测试需要把 `DSH_CONNECTION_CONTRACT_ROOT` 指向隔离安装的 `@deepseek-ai/dsh-client-connection` 包根目录;与 Gateway 共存的用例同时使用图片契约的 `DSH_CHAT_CONTRACT_ROOT`。未配置时本地会跳过对应契约测试,CI 已配置执行。测试使用临时 HTTP 服务和临时凭据,不代表真实 Cloudflare 部署联调。
265
+
252
266
  ```powershell
253
267
  [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
254
268
  $OutputEncoding = [System.Text.Encoding]::UTF8
package/SECURITY.md CHANGED
@@ -20,8 +20,13 @@
20
20
 
21
21
  ## 管理面
22
22
 
23
- - 设置页与 `/dsh-im-connect/api` 同时校验回环来源地址与回环 Host;即使 Host webServer 误绑到局域网地址,远程请求也会被拒绝。
24
- - 所有写接口必须使用 `application/json`,并携带插件客户端专用请求头;普通跨站表单不能触发连接、批准、删除或权限修改。
23
+ - 设置页使用 `/api/dsh-im-connect`。每个请求都先通过宿主公开的 `connection.requestRejection` 认证,再进入插件业务分发。该接口同时执行 Host/trustedHosts、Origin、跨站标记与绑定访问地址的浏览器 Cookie 校验;本机请求同样需要登录。路径前缀、自定义请求头及回环代理来源都不是身份凭据。
24
+ - 该 REST 前缀遵循其他 DSH 插件的 `/api/<插件名>` 约定,并通过具名路径与宿主 Gateway 共存;不注册第二个 `/api` RPC interceptor,也不改变宿主 Gateway。接口仍为 REST JSON,不是 Remote RPC envelope;既有业务路径、GET/POST 方法、参数和成功返回结构不变。
25
+ - 每次请求通过 `ctx.get('connection')` 读取当前活动服务,不缓存认证实例、不暴露 inactive 服务。宿主缺少公开认证接口或服务暂不可用时返回 503,提示稍后重试或升级;认证异常不会降级为匿名本地访问。
26
+ - 反代应保留外部 Host、Cookie 和 Origin,在宿主 `client-connection.trustedHosts` 配置实际访问地址,并通过该地址的 DSH 登录入口取得 Cookie。不要将 Host 改成 localhost 来绕过校验,不接受插件专用 token 或转发头作为认证。公网入口应使用 HTTPS。
27
+ - 管理回包统一 `Cache-Control: no-store`,前端使用同源 Cookie 且禁用缓存。
28
+ - 所有写接口必须使用 `Content-Type: application/json`,并携带 `x-dsh-im-connect-client: 1`;读取和写入均需宿主登录 Cookie。请求体仍按实际接收字节限制为 1 MiB,普通跨站表单不能触发连接、批准、删除或权限修改。
29
+ - 失败返回 JSON `{ "ok": false, "error": "说明" }`:未登录/无效 Cookie 为 401;不可信 Host、跨站请求或写请求缺客户端标记为 403;认证服务不可用为 503。非法 JSON 为 400,超限为 413,非 JSON 写请求为 415;业务路由其余错误码保持原行为。认证失败不会进入业务读写。
25
30
  - 待批准列表保存在 `channels.json` 的 `pending`,白名单保存在 `allowlist`。
26
31
  - 浏览器回包不返回 token、secret、原始凭据或内部异常详情。
27
32
 
package/client.js CHANGED
@@ -12,7 +12,7 @@ window.__ModuleLoader__.load({
12
12
  const { RiskConfirmation, IconListPenOutline16, IconRefreshOutline16, IconDownloadOutline16, IconCopyOutline16, IconCloseOutline16 } = require("@deepseek-ai/dsh-client-ui-primitives");
13
13
  const EMPTY_EXTRA_TABS = [];
14
14
  const inject = ["slots", "sessions", "workspaces", "locale"];
15
- const API_BASE = "/dsh-im-connect/api";
15
+ const API_BASE = "/api/dsh-im-connect";
16
16
  const TAB_KEY = "dsh-im-connect.sidebar-tab";
17
17
  const ACCOUNT_SELECTION_KEY = "dsh-im-connect.settings.selected-account";
18
18
  const IM_LOCALE_NS = "im-connect";
@@ -243,7 +243,8 @@ window.__ModuleLoader__.load({
243
243
  };
244
244
 
245
245
  const api = (path, opts) => {
246
- const request = Object.assign({}, opts || {});
246
+ // 管理路由复用宿主登录 Cookie,不缓存账号状态或认证错误。
247
+ const request = Object.assign({}, opts || {}, { credentials: "same-origin", cache: "no-store" });
247
248
  const method = String(request.method || "GET").toUpperCase();
248
249
  if (method !== "GET" && method !== "HEAD") {
249
250
  request.headers = Object.assign({ "content-type": "application/json" }, request.headers || {}, { "x-dsh-im-connect-client": "1" });
@@ -0,0 +1,22 @@
1
+ import type { ImMedia } from '../engine/types.js';
2
+ export declare const MAX_CHANNEL_IMAGE_BYTES: number;
3
+ export declare const MAX_CHANNEL_IMAGES = 4;
4
+ /** Only return fixed categories or HTTP status digits; raw SDK errors can hold secrets. */
5
+ export declare function channelImageFailureReason(error: unknown): string;
6
+ /** Diagnostic host only: never emit a signed path/query, userinfo, or AES key. */
7
+ export declare function channelImageDownloadHost(raw?: string): string;
8
+ /** Infer MIME from bytes, not an attacker-controlled filename or Content-Type. */
9
+ export declare function imageMedia(data: Buffer, maxBytes?: number): ImMedia;
10
+ /** HTTPS only; resolve inside the connection lookup, so DNS cannot rebind after validation.
11
+ * No redirects or ambient proxy/credentials. IPv4-only intentionally fails closed on IPv6-only hosts.
12
+ */
13
+ export declare function requestChannelBytes(rawUrl: string, options?: {
14
+ method?: 'GET' | 'POST';
15
+ headers?: Record<string, string>;
16
+ body?: string;
17
+ maxBytes?: number;
18
+ timeoutMs?: number;
19
+ signal?: AbortSignal;
20
+ additionalTrustedHosts?: readonly string[];
21
+ }): Promise<Buffer>;
22
+ //# sourceMappingURL=channel-image-download.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"channel-image-download.d.ts","sourceRoot":"","sources":["../../src/channels/channel-image-download.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAMjD,eAAO,MAAM,uBAAuB,QAAmB,CAAA;AACvD,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAEnC,2FAA2F;AAC3F,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAiBhE;AAED,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAM7D;AAED,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAA0B,GAAG,OAAO,CASpF;AA2BD;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE;IACjE,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC3D,sBAAsB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACtC,GAAG,OAAO,CAAC,MAAM,CAAC,CAuEvB"}
@@ -0,0 +1,179 @@
1
+ import https from 'node:https';
2
+ import { validateAdditionalImageHosts } from './image-host-policy.js';
3
+ import dns from 'node:dns';
4
+ import { BlockList, isIP } from 'node:net';
5
+ export const MAX_CHANNEL_IMAGE_BYTES = 10 * 1024 * 1024;
6
+ export const MAX_CHANNEL_IMAGES = 4;
7
+ /** Only return fixed categories or HTTP status digits; raw SDK errors can hold secrets. */
8
+ export function channelImageFailureReason(error) {
9
+ const value = error;
10
+ const message = typeof value?.message === 'string' ? value.message : '';
11
+ const rawCode = value?.code ?? value?.cause?.code;
12
+ const code = typeof rawCode === 'string' ? rawCode : undefined;
13
+ if (['图片地址不符合安全要求', '不安全的图片地址'].includes(message) || code === 'ERR_INVALID_URL')
14
+ return '下载地址被安全校验拦截';
15
+ const http = /^图片下载 HTTP (\d{3})$/.exec(message);
16
+ if (http)
17
+ return `下载服务器返回 HTTP ${http[1]}`;
18
+ if (/图片.*(大小|过大|数量)/.test(message))
19
+ return '图片数量或大小超过接收限制';
20
+ if (message === '图片下载超时' || ['TimeoutError', 'AbortError'].includes(value?.name ?? '') || code === 'ETIMEDOUT')
21
+ return '下载超时或已取消';
22
+ if (message === '图片解密失败' || code?.startsWith('ERR_OSSL_'))
23
+ return '图片解密失败';
24
+ if (message === '图片缺少下载地址或解密密钥')
25
+ return '图片缺少下载地址或解密信息';
26
+ if (message.startsWith('不支持的图片格式'))
27
+ return '不支持的图片格式';
28
+ if (message === '图片为空')
29
+ return '服务器返回了空图片';
30
+ if (code === 'ENOTFOUND' || code === 'EAI_AGAIN')
31
+ return 'DNS 解析失败';
32
+ if (code?.startsWith('ERR_TLS_') || code?.startsWith('ERR_SSL_') || code === 'CERT_HAS_EXPIRED')
33
+ return 'TLS 连接校验失败';
34
+ return '网络连接或图片处理失败';
35
+ }
36
+ /** Diagnostic host only: never emit a signed path/query, userinfo, or AES key. */
37
+ export function channelImageDownloadHost(raw) {
38
+ try {
39
+ const value = raw ?? '';
40
+ const url = new URL(value.startsWith('//') ? `https:${value}` : /^[a-z][a-z0-9+.-]*:/i.test(value) ? value : `https://${value}`);
41
+ return /^[a-z0-9.-]{1,253}$/i.test(url.hostname) ? url.hostname : '(invalid)';
42
+ }
43
+ catch {
44
+ return '(invalid)';
45
+ }
46
+ }
47
+ /** Infer MIME from bytes, not an attacker-controlled filename or Content-Type. */
48
+ export function imageMedia(data, maxBytes = MAX_CHANNEL_IMAGE_BYTES) {
49
+ if (!data.length || data.length > maxBytes)
50
+ throw new Error('图片超过大小限制或为空');
51
+ let mediaType;
52
+ if (data.subarray(0, 8).equals(Buffer.from('89504e470d0a1a0a', 'hex')))
53
+ mediaType = 'image/png';
54
+ else if (data.subarray(0, 3).equals(Buffer.from('ffd8ff', 'hex')))
55
+ mediaType = 'image/jpeg';
56
+ else if (/^GIF8[79]a$/.test(data.subarray(0, 6).toString('ascii')))
57
+ mediaType = 'image/gif';
58
+ else if (data.subarray(0, 4).toString() === 'RIFF' && data.subarray(8, 12).toString() === 'WEBP')
59
+ mediaType = 'image/webp';
60
+ if (!mediaType)
61
+ throw new Error('不支持的图片格式,请发送 PNG、JPEG、GIF 或 WebP');
62
+ return { kind: 'image', data, mediaType };
63
+ }
64
+ const blocked = new BlockList();
65
+ for (const [address, prefix] of [
66
+ ['0.0.0.0', 8], ['10.0.0.0', 8], ['100.64.0.0', 10], ['127.0.0.0', 8],
67
+ ['169.254.0.0', 16], ['172.16.0.0', 12], ['192.0.0.0', 24], ['192.0.2.0', 24],
68
+ ['192.168.0.0', 16], ['198.18.0.0', 15], ['198.51.100.0', 24], ['203.0.113.0', 24],
69
+ ['224.0.0.0', 4], ['240.0.0.0', 4],
70
+ ])
71
+ blocked.addSubnet(address, prefix);
72
+ // Local proxy/TUN resolvers use RFC 2544 benchmark addresses as virtual routes.
73
+ // Limit this exception to exact platform hosts; never permit RFC1918/loopback,
74
+ // arbitrary hosts, redirects, or disabled TLS hostname/certificate validation.
75
+ const proxyFakeIps = new BlockList();
76
+ proxyFakeIps.addSubnet('198.18.0.0', 15);
77
+ const proxyCompatibleHosts = new Set([
78
+ 'wework.qpic.cn', 'multimedia.nt.qq.com.cn', 'multimedia.nt.qq.com',
79
+ // QQ 聊天图片域名来源:https://github.com/takayama-lily/oicq/discussions/244
80
+ 'gchat.qpic.cn',
81
+ // Exact WeCom AI-bot COS origin observed in authenticated image callbacks.
82
+ // Do not trust arbitrary tenant buckets under myqcloud.com.
83
+ 'ww-aibot-img-1258476243.cos.ap-guangzhou.myqcloud.com',
84
+ 'api.dingtalk.com', 'oapi.dingtalk.com',
85
+ // Exact image origin returned by DingTalk's authenticated messageFiles API.
86
+ 'wukong-file-im-zjk.oss-cn-zhangjiakou.aliyuncs.com',
87
+ ]);
88
+ /** HTTPS only; resolve inside the connection lookup, so DNS cannot rebind after validation.
89
+ * No redirects or ambient proxy/credentials. IPv4-only intentionally fails closed on IPv6-only hosts.
90
+ */
91
+ export async function requestChannelBytes(rawUrl, options = {}) {
92
+ const additionalHosts = new Set(validateAdditionalImageHosts(options.additionalTrustedHosts));
93
+ options.signal?.throwIfAborted();
94
+ const url = new URL(rawUrl);
95
+ if (url.protocol !== 'https:' || url.username || url.password || (url.port && url.port !== '443')
96
+ || isIP(url.hostname) || url.hostname.includes(':') || url.hostname.endsWith('.')) {
97
+ throw new Error('图片地址不符合安全要求');
98
+ }
99
+ return new Promise((resolve, reject) => {
100
+ let settled = false;
101
+ let timer;
102
+ let responseStream;
103
+ const finish = (error, data) => {
104
+ if (settled)
105
+ return;
106
+ settled = true;
107
+ clearTimeout(timer);
108
+ options.signal?.removeEventListener('abort', abort);
109
+ if (error)
110
+ reject(error);
111
+ else
112
+ resolve(data);
113
+ };
114
+ const abort = () => {
115
+ const error = new DOMException('图片下载已取消', 'AbortError');
116
+ finish(error);
117
+ responseStream?.destroy(error);
118
+ req.destroy(error);
119
+ };
120
+ const req = https.request(url, {
121
+ method: options.method ?? 'GET', headers: options.headers, agent: false,
122
+ lookup: (hostname, _options, callback) => {
123
+ dns.lookup(hostname, { all: true, family: 4 }, (error, addresses) => {
124
+ if (settled)
125
+ return;
126
+ if (error)
127
+ return callback(error, '', 4);
128
+ if (!addresses.length || addresses.some(item => item.family !== 4
129
+ || (blocked.check(item.address) && !((proxyCompatibleHosts.has(hostname) || additionalHosts.has(hostname)) && proxyFakeIps.check(item.address))))) {
130
+ return callback(new Error('图片地址不符合安全要求'), '', 4);
131
+ }
132
+ if (_options.all)
133
+ callback(null, addresses);
134
+ else
135
+ callback(null, addresses[0].address, 4);
136
+ });
137
+ },
138
+ }, async (response) => {
139
+ if (settled) {
140
+ response.destroy();
141
+ return;
142
+ }
143
+ responseStream = response;
144
+ const chunks = [];
145
+ const maxBytes = options.maxBytes ?? MAX_CHANNEL_IMAGE_BYTES + 32;
146
+ let size = 0;
147
+ try {
148
+ if (response.statusCode !== 200)
149
+ throw new Error(`图片下载 HTTP ${response.statusCode}`);
150
+ if (Number(response.headers['content-length']) > maxBytes)
151
+ throw new Error('图片超过大小限制');
152
+ for await (const chunk of response) {
153
+ size += chunk.length;
154
+ if (size > maxBytes)
155
+ throw new Error('图片超过大小限制');
156
+ chunks.push(Buffer.from(chunk));
157
+ }
158
+ finish(undefined, Buffer.concat(chunks));
159
+ }
160
+ catch (error) {
161
+ response.destroy();
162
+ finish(error);
163
+ }
164
+ });
165
+ timer = setTimeout(() => {
166
+ const error = new Error('图片下载超时');
167
+ finish(error);
168
+ responseStream?.destroy(error);
169
+ req.destroy(error);
170
+ }, options.timeoutMs ?? 30_000);
171
+ req.on('error', error => finish(error));
172
+ options.signal?.addEventListener('abort', abort, { once: true });
173
+ if (options.signal?.aborted)
174
+ abort();
175
+ else
176
+ req.end(options.body);
177
+ });
178
+ }
179
+ //# sourceMappingURL=channel-image-download.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"channel-image-download.js","sourceRoot":"","sources":["../../src/channels/channel-image-download.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ type TokenResponse = {
2
+ accessToken?: unknown;
3
+ expireIn?: unknown;
4
+ };
5
+ /** 缓存归固定凭据的单个适配器所有,不按 clientId 跨实例共享。 */
6
+ export declare class DingtalkTokenCache {
7
+ private readonly load;
8
+ private readonly now;
9
+ private cached?;
10
+ private pending?;
11
+ private generation;
12
+ clear(): void;
13
+ constructor(load: (signal: AbortSignal) => Promise<TokenResponse>, now?: () => number);
14
+ get(signal: AbortSignal): Promise<string>;
15
+ private fetch;
16
+ }
17
+ export {};
18
+ //# sourceMappingURL=dingtalk-token-cache.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dingtalk-token-cache.d.ts","sourceRoot":"","sources":["../../src/channels/dingtalk-token-cache.ts"],"names":[],"mappings":"AAAA,KAAK,aAAa,GAAG;IAAE,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAElE,yCAAyC;AACzC,qBAAa,kBAAkB;IAYjB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAmD,OAAO,CAAC,QAAQ,CAAC,GAAG;IAXxG,OAAO,CAAC,MAAM,CAAC,CAAsC;IAErD,OAAO,CAAC,OAAO,CAAC,CAAiB;IACjC,OAAO,CAAC,UAAU,CAAI;IAEtB,KAAK,IAAI,IAAI;gBAMgB,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,aAAa,CAAC,EAAmB,GAAG,eAAW;IAE7G,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;YASjC,KAAK;CAYpB"}
@@ -0,0 +1,48 @@
1
+ /** 缓存归固定凭据的单个适配器所有,不按 clientId 跨实例共享。 */
2
+ export class DingtalkTokenCache {
3
+ load;
4
+ now;
5
+ cached;
6
+ pending;
7
+ generation = 0;
8
+ clear() {
9
+ this.generation++;
10
+ this.cached = undefined;
11
+ this.pending = undefined;
12
+ }
13
+ constructor(load, now = Date.now) {
14
+ this.load = load;
15
+ this.now = now;
16
+ }
17
+ async get(signal) {
18
+ signal.throwIfAborted();
19
+ if (this.cached && this.now() < this.cached.expiresAt)
20
+ return this.cached.token;
21
+ if (this.pending)
22
+ return this.pending;
23
+ const pending = this.fetch(signal);
24
+ this.pending = pending;
25
+ try {
26
+ return await pending;
27
+ }
28
+ finally {
29
+ if (this.pending === pending)
30
+ this.pending = undefined;
31
+ }
32
+ }
33
+ async fetch(signal) {
34
+ const startedAt = this.now();
35
+ const generation = this.generation;
36
+ const auth = await this.load(signal);
37
+ signal.throwIfAborted();
38
+ if (generation !== this.generation)
39
+ throw new Error('钉钉图片鉴权已取消');
40
+ if (typeof auth.accessToken !== 'string' || !auth.accessToken.trim())
41
+ throw new Error('钉钉图片鉴权失败');
42
+ const ttl = typeof auth.expireIn === 'number' && Number.isFinite(auth.expireIn) ? auth.expireIn * 1000 : 0;
43
+ const expiresAt = startedAt + ttl - Math.min(60_000, Math.max(5_000, ttl * 0.1));
44
+ this.cached = Number.isFinite(expiresAt) && expiresAt > this.now() ? { token: auth.accessToken, expiresAt } : undefined;
45
+ return auth.accessToken;
46
+ }
47
+ }
48
+ //# sourceMappingURL=dingtalk-token-cache.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dingtalk-token-cache.js","sourceRoot":"","sources":["../../src/channels/dingtalk-token-cache.ts"],"names":[],"mappings":"AAEA,yCAAyC;AACzC,MAAM,OAAO,kBAAkB;IAYA;IAAwE;IAX7F,MAAM,CAAuC;IAE7C,OAAO,CAAkB;IACzB,UAAU,GAAG,CAAC,CAAA;IAEtB,KAAK;QACH,IAAI,CAAC,UAAU,EAAE,CAAA;QACjB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAA;QACvB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;IAC1B,CAAC;IAED,YAA6B,IAAqD,EAAmB,MAAM,IAAI,CAAC,GAAG;QAAtF,SAAI,GAAJ,IAAI,CAAiD;QAAmB,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAEvH,KAAK,CAAC,GAAG,CAAC,MAAmB;QAC3B,MAAM,CAAC,cAAc,EAAE,CAAA;QACvB,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAA;QAC/E,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC,OAAO,CAAA;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC;YAAC,OAAO,MAAM,OAAO,CAAA;QAAC,CAAC;gBAAS,CAAC;YAAC,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO;gBAAE,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;QAAC,CAAC;IACjG,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,MAAmB;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAA;QAClC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACpC,MAAM,CAAC,cAAc,EAAE,CAAA;QACvB,IAAI,UAAU,KAAK,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAA;QAChE,IAAI,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,CAAA;QACjG,MAAM,GAAG,GAAG,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1G,MAAM,SAAS,GAAG,SAAS,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC,CAAA;QAChF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;QACvH,OAAO,IAAI,CAAC,WAAW,CAAA;IACzB,CAAC;CACF"}
@@ -1,9 +1,19 @@
1
- import type { ChannelAdapter } from '../engine/types.js';
1
+ import type { ChannelAdapter, ImMedia } from '../engine/types.js';
2
2
  export interface DingtalkConfig {
3
3
  clientId?: string;
4
4
  clientSecret?: string;
5
+ additionalImageHosts?: readonly string[];
5
6
  }
6
- export declare function parseDingtalkRobotEvent(payload: {
7
+ export interface DingtalkRobotPayload {
8
+ msgtype?: string;
9
+ content?: {
10
+ downloadCode?: string;
11
+ richText?: Array<{
12
+ type?: string;
13
+ text?: string;
14
+ downloadCode?: string;
15
+ }>;
16
+ };
7
17
  text?: {
8
18
  content?: string;
9
19
  };
@@ -15,12 +25,15 @@ export declare function parseDingtalkRobotEvent(payload: {
15
25
  msgId?: string;
16
26
  msgid?: string;
17
27
  msgIdEnc?: string;
18
- }): {
28
+ }
29
+ export declare function parseDingtalkRobotEvent(payload: DingtalkRobotPayload): {
19
30
  chatId: string;
20
31
  userId: string;
21
32
  text: string;
22
33
  kind: 'dm' | 'group';
23
34
  messageId?: string;
24
35
  } | undefined;
25
- export declare function createDingtalkChannel(config: DingtalkConfig, log: (line: string) => void): ChannelAdapter | undefined;
36
+ export declare function createDingtalkChannel(config: DingtalkConfig, log: (line: string) => void, dependencies?: {
37
+ downloadImage?: (downloadCode: string) => Promise<ImMedia>;
38
+ }): ChannelAdapter | undefined;
26
39
  //# sourceMappingURL=dingtalk.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"dingtalk.d.ts","sourceRoot":"","sources":["../../src/channels/dingtalk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAA0B,MAAM,oBAAoB,CAAA;AAIhF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAczG;AACD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,cAAc,GAAG,SAAS,CAiHrH"}
1
+ {"version":3,"file":"dingtalk.d.ts","sourceRoot":"","sources":["../../src/channels/dingtalk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAa,OAAO,EAAe,MAAM,oBAAoB,CAAA;AAkCzF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACzC;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,YAAY,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAA;IAC9G,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAgB7K;AACD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAAE,YAAY,GAAE;IACvG,aAAa,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CACtD,GAAG,cAAc,GAAG,SAAS,CAyJlC"}