@zhin.js/core 1.5.16 → 1.7.0

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 (334) hide show
  1. package/README.md +78 -195
  2. package/lib/ai-completion-contract.d.ts +135 -0
  3. package/lib/ai-completion-contract.js +69 -0
  4. package/lib/built/ai-access.d.ts +2 -21
  5. package/lib/built/ai-access.js +1 -46
  6. package/lib/built/ai-outbound/index.d.ts +0 -2
  7. package/lib/built/ai-outbound/index.js +0 -2
  8. package/lib/built/ai-outbound/prompt.d.ts +2 -0
  9. package/lib/built/ai-outbound/prompt.js +2 -0
  10. package/lib/built/ai-outbound/types.d.ts +1 -10
  11. package/lib/built/ai-trigger.d.ts +39 -78
  12. package/lib/built/ai-trigger.js +3 -254
  13. package/lib/built/common-adapter-tools.d.ts +21 -6
  14. package/lib/built/common-adapter-tools.js +28 -17
  15. package/lib/built/generic-segment-mapper.js +4 -1
  16. package/lib/built/html-segment-fallback.d.ts +6 -7
  17. package/lib/built/html-segment-fallback.js +1 -16
  18. package/lib/built/html-to-text.d.ts +0 -3
  19. package/lib/built/html-to-text.js +131 -40
  20. package/lib/built/interaction-messages.d.ts +1 -0
  21. package/lib/built/interaction-messages.js +30 -0
  22. package/lib/built/interactive-segments/action.d.ts +3 -4
  23. package/lib/built/interactive-segments/action.js +2 -5
  24. package/lib/built/interactive-segments/index.d.ts +0 -2
  25. package/lib/built/interactive-segments/index.js +0 -2
  26. package/lib/built/interactive-segments/keyboard-segment.d.ts +0 -1
  27. package/lib/built/interactive-segments/keyboard-segment.js +0 -1
  28. package/lib/built/interactive-segments/onebot-keyboard.d.ts +0 -1
  29. package/lib/built/interactive-segments/onebot-keyboard.js +0 -2
  30. package/lib/built/interactive-segments/resolve.d.ts +2 -3
  31. package/lib/built/interactive-segments/resolve.js +21 -14
  32. package/lib/built/interactive-segments/types.d.ts +2 -7
  33. package/lib/built/interactive-segments/types.js +22 -2
  34. package/lib/built/login-assist.d.ts +330 -25
  35. package/lib/built/login-assist.js +1156 -75
  36. package/lib/built/login-captcha.d.ts +62 -0
  37. package/lib/built/login-captcha.js +107 -0
  38. package/lib/built/message-enrich.d.ts +24 -27
  39. package/lib/built/message-enrich.js +53 -49
  40. package/lib/built/outbound-content-arrays.d.ts +4 -0
  41. package/lib/built/outbound-content-arrays.js +32 -0
  42. package/lib/built/outbound-media-trust.d.ts +46 -0
  43. package/lib/built/outbound-media-trust.js +245 -0
  44. package/lib/built/outbound-media-utils.d.ts +5 -3
  45. package/lib/built/outbound-media-utils.js +5 -3
  46. package/lib/built/readable-link.d.ts +4 -0
  47. package/lib/built/readable-link.js +32 -0
  48. package/lib/built/rich-segments/markdown-to-text.d.ts +1 -2
  49. package/lib/built/rich-segments/markdown-to-text.js +141 -17
  50. package/lib/built/roles.d.ts +141 -12
  51. package/lib/built/roles.js +253 -52
  52. package/lib/built/segment-contract/assert.js +8 -2
  53. package/lib/built/segment-contract/delivery.js +1 -0
  54. package/lib/built/segment-contract/index.d.ts +3 -3
  55. package/lib/built/segment-contract/index.js +2 -2
  56. package/lib/built/segment-contract/json-schema.d.ts +39 -5
  57. package/lib/built/segment-contract/json-schema.js +207 -24
  58. package/lib/built/segment-contract/preview.js +8 -1
  59. package/lib/built/segment-contract/text.js +1 -1
  60. package/lib/built/segment-contract/types.d.ts +2 -2
  61. package/lib/built/segment-contract/validate.d.ts +1553 -224
  62. package/lib/built/segment-contract/validate.js +39 -3
  63. package/lib/built/tool-access.d.ts +5 -0
  64. package/lib/built/tool-access.js +17 -0
  65. package/lib/built/user-interaction.d.ts +5 -4
  66. package/lib/built/user-interaction.js +64 -52
  67. package/lib/errors.d.ts +1 -18
  68. package/lib/errors.js +1 -26
  69. package/lib/feature/command-public-api.d.ts +5 -0
  70. package/lib/feature/command-public-api.js +5 -0
  71. package/lib/feature/command.d.ts +2 -0
  72. package/lib/feature/command.js +1 -0
  73. package/lib/feature/component.d.ts +1 -0
  74. package/lib/feature/component.js +1 -0
  75. package/lib/feature/handler.d.ts +13 -7
  76. package/lib/feature/handler.js +2 -1
  77. package/lib/feature/middleware-public-api.d.ts +6 -0
  78. package/lib/feature/middleware-public-api.js +6 -0
  79. package/lib/feature/middleware.d.ts +22 -2
  80. package/lib/feature/middleware.js +7 -2
  81. package/lib/im-scene.d.ts +4 -3
  82. package/lib/im-scene.js +9 -9
  83. package/lib/im-session-id.d.ts +20 -12
  84. package/lib/im-session-id.js +8 -8
  85. package/lib/index.d.ts +20 -48
  86. package/lib/index.js +15 -41
  87. package/lib/jsx/intrinsic-elements.d.ts +83 -0
  88. package/lib/jsx/message-renderer.d.ts +13 -0
  89. package/lib/jsx/message-renderer.js +128 -0
  90. package/lib/jsx/message-tags.d.ts +133 -0
  91. package/lib/jsx/message-tags.js +50 -0
  92. package/lib/jsx-dev-runtime.d.ts +2 -2
  93. package/lib/jsx-dev-runtime.js +1 -2
  94. package/lib/jsx-runtime.d.ts +2 -12
  95. package/lib/jsx-runtime.js +1 -10
  96. package/lib/jsx.d.ts +6 -30
  97. package/lib/jsx.js +3 -93
  98. package/lib/message.d.ts +0 -40
  99. package/lib/message.js +1 -27
  100. package/lib/models/system-log.d.ts +0 -2
  101. package/lib/models/system-log.js +1 -8
  102. package/lib/models/user.d.ts +0 -2
  103. package/lib/models/user.js +1 -7
  104. package/lib/notice.d.ts +38 -33
  105. package/lib/notice.js +23 -7
  106. package/lib/plugin-runtime/im/command-feedback.d.ts +59 -0
  107. package/lib/plugin-runtime/im/command-feedback.js +148 -0
  108. package/lib/plugin-runtime/im/contracts.d.ts +217 -32
  109. package/lib/plugin-runtime/im/contracts.js +141 -23
  110. package/lib/plugin-runtime/im/conversation-runtime.d.ts +42 -0
  111. package/lib/plugin-runtime/im/conversation-runtime.js +451 -0
  112. package/lib/plugin-runtime/im/endpoint-runtime.d.ts +112 -0
  113. package/lib/plugin-runtime/im/endpoint-runtime.js +434 -0
  114. package/lib/plugin-runtime/im/feature-gate.d.ts +21 -0
  115. package/lib/plugin-runtime/im/feature-gate.js +88 -0
  116. package/lib/plugin-runtime/im/host/component-host-installer.d.ts +2 -0
  117. package/lib/plugin-runtime/im/host/component-host-installer.js +14 -0
  118. package/lib/plugin-runtime/im/host/conversation-migration.d.ts +5 -0
  119. package/lib/plugin-runtime/im/host/conversation-migration.js +75 -0
  120. package/lib/plugin-runtime/im/host/database-config.d.ts +10 -0
  121. package/lib/plugin-runtime/im/host/database-config.js +152 -0
  122. package/lib/plugin-runtime/im/host/database-console-schema.d.ts +79 -0
  123. package/lib/plugin-runtime/im/host/database-console-schema.js +477 -0
  124. package/lib/plugin-runtime/im/host/database-console-sql.d.ts +66 -0
  125. package/lib/plugin-runtime/im/host/database-console-sql.js +459 -0
  126. package/lib/plugin-runtime/im/host/database-host-installer.d.ts +60 -0
  127. package/lib/plugin-runtime/im/host/database-host-installer.js +1166 -0
  128. package/lib/plugin-runtime/im/host/database-state.d.ts +9 -0
  129. package/lib/plugin-runtime/im/host/database-state.js +91 -0
  130. package/lib/plugin-runtime/im/host/index.d.ts +8 -0
  131. package/lib/plugin-runtime/im/host/index.js +8 -0
  132. package/lib/plugin-runtime/im/host/locale-host-installer.d.ts +3 -0
  133. package/lib/plugin-runtime/im/host/locale-host-installer.js +60 -0
  134. package/lib/plugin-runtime/im/host/outbound-host-installer.d.ts +8 -0
  135. package/lib/plugin-runtime/im/host/outbound-host-installer.js +153 -0
  136. package/lib/plugin-runtime/im/host/sender-enrichment.d.ts +34 -0
  137. package/lib/plugin-runtime/im/host/sender-enrichment.js +82 -0
  138. package/lib/plugin-runtime/im/im-runtime.d.ts +40 -111
  139. package/lib/plugin-runtime/im/im-runtime.js +235 -1059
  140. package/lib/plugin-runtime/im/inbound-dedup.d.ts +84 -0
  141. package/lib/plugin-runtime/im/inbound-dedup.js +322 -0
  142. package/lib/plugin-runtime/im/inbound-origin.d.ts +150 -0
  143. package/lib/plugin-runtime/im/inbound-origin.js +183 -0
  144. package/lib/plugin-runtime/im/inbound-runtime.d.ts +59 -0
  145. package/lib/plugin-runtime/im/inbound-runtime.js +478 -0
  146. package/lib/plugin-runtime/im/inbound-spine.d.ts +196 -0
  147. package/lib/plugin-runtime/im/inbound-spine.js +335 -0
  148. package/lib/plugin-runtime/im/index.d.ts +15 -4
  149. package/lib/plugin-runtime/im/index.js +11 -4
  150. package/lib/plugin-runtime/im/interaction-runtime.d.ts +50 -0
  151. package/lib/plugin-runtime/im/interaction-runtime.js +390 -0
  152. package/lib/plugin-runtime/im/interactive-router.d.ts +81 -0
  153. package/lib/plugin-runtime/im/interactive-router.js +382 -0
  154. package/lib/plugin-runtime/im/message-diagnostics.d.ts +70 -0
  155. package/lib/plugin-runtime/im/message-diagnostics.js +182 -0
  156. package/lib/plugin-runtime/im/message-dispatcher.d.ts +18 -4
  157. package/lib/plugin-runtime/im/message-dispatcher.js +138 -20
  158. package/lib/plugin-runtime/im/message-events.d.ts +85 -0
  159. package/lib/plugin-runtime/im/message-events.js +113 -0
  160. package/lib/plugin-runtime/im/outbound-delivery-runtime.d.ts +39 -0
  161. package/lib/plugin-runtime/im/outbound-delivery-runtime.js +450 -0
  162. package/lib/plugin-runtime/im/outbound-renderer.d.ts +52 -3
  163. package/lib/plugin-runtime/im/outbound-renderer.js +188 -8
  164. package/lib/plugin-runtime/im/outbound-segments.d.ts +29 -5
  165. package/lib/plugin-runtime/im/outbound-segments.js +130 -36
  166. package/lib/plugin-runtime/im/progressive-reply.d.ts +58 -0
  167. package/lib/plugin-runtime/im/progressive-reply.js +501 -0
  168. package/lib/plugin-runtime/im/public-api.d.ts +1 -1
  169. package/lib/request.d.ts +27 -36
  170. package/lib/request.js +14 -6
  171. package/lib/side-event/base.d.ts +64 -44
  172. package/lib/side-event/base.js +72 -19
  173. package/lib/side-event/index.d.ts +1 -1
  174. package/lib/side-event/index.js +1 -1
  175. package/lib/side-event/normalize.d.ts +7 -38
  176. package/lib/side-event/normalize.js +4 -109
  177. package/lib/side-event/scene-events.d.ts +40 -0
  178. package/lib/side-event/scene-events.js +147 -0
  179. package/lib/side-event/types.d.ts +4 -13
  180. package/lib/side-event/types.js +1 -55
  181. package/lib/system-event.d.ts +17 -12
  182. package/lib/system-event.js +8 -6
  183. package/lib/types.d.ts +23 -167
  184. package/lib/utils.d.ts +50 -33
  185. package/lib/utils.js +12 -185
  186. package/lib/venue/contracts.d.ts +21 -0
  187. package/lib/venue/contracts.js +3 -0
  188. package/lib/venue/floor-controller.d.ts +11 -0
  189. package/lib/venue/floor-controller.js +63 -0
  190. package/lib/venue/index.d.ts +13 -0
  191. package/lib/venue/index.js +11 -0
  192. package/lib/venue/membership-port.d.ts +23 -0
  193. package/lib/venue/membership-port.js +141 -0
  194. package/lib/venue/projector.d.ts +38 -0
  195. package/lib/venue/projector.js +45 -0
  196. package/lib/venue/registry.d.ts +16 -0
  197. package/lib/venue/registry.js +63 -0
  198. package/lib/venue/router.d.ts +19 -0
  199. package/lib/venue/router.js +101 -0
  200. package/lib/venue/send-limiter.d.ts +17 -0
  201. package/lib/venue/send-limiter.js +73 -0
  202. package/lib/venue/validator.d.ts +6 -0
  203. package/lib/venue/validator.js +160 -0
  204. package/package.json +24 -50
  205. package/lib/adapter.d.ts +0 -145
  206. package/lib/adapter.js +0 -377
  207. package/lib/built/adapter-process.d.ts +0 -58
  208. package/lib/built/adapter-process.js +0 -128
  209. package/lib/built/agent-preset.d.ts +0 -64
  210. package/lib/built/agent-preset.js +0 -79
  211. package/lib/built/ai-outbound/adapter-access.d.ts +0 -3
  212. package/lib/built/ai-outbound/adapter-access.js +0 -9
  213. package/lib/built/ai-outbound/extensions/qq-message.d.ts +0 -3
  214. package/lib/built/ai-outbound/extensions/qq-message.js +0 -23
  215. package/lib/built/authorization.d.ts +0 -10
  216. package/lib/built/authorization.js +0 -76
  217. package/lib/built/command.d.ts +0 -72
  218. package/lib/built/command.js +0 -105
  219. package/lib/built/component.d.ts +0 -67
  220. package/lib/built/component.js +0 -97
  221. package/lib/built/config.d.ts +0 -98
  222. package/lib/built/config.js +0 -372
  223. package/lib/built/connect-endpoint-instance.d.ts +0 -17
  224. package/lib/built/connect-endpoint-instance.js +0 -42
  225. package/lib/built/database.d.ts +0 -68
  226. package/lib/built/database.js +0 -106
  227. package/lib/built/dispatcher.d.ts +0 -141
  228. package/lib/built/dispatcher.js +0 -383
  229. package/lib/built/endpoint-commands.d.ts +0 -3
  230. package/lib/built/endpoint-commands.js +0 -99
  231. package/lib/built/endpoint-lifecycle-service.d.ts +0 -28
  232. package/lib/built/endpoint-lifecycle-service.js +0 -242
  233. package/lib/built/endpoint-lifecycle.d.ts +0 -27
  234. package/lib/built/endpoint-lifecycle.js +0 -36
  235. package/lib/built/endpoint-manager.d.ts +0 -34
  236. package/lib/built/html-renderer-loader.d.ts +0 -13
  237. package/lib/built/html-renderer-loader.js +0 -33
  238. package/lib/built/inbound-pipeline.d.ts +0 -37
  239. package/lib/built/inbound-pipeline.js +0 -63
  240. package/lib/built/inbound-runner.d.ts +0 -22
  241. package/lib/built/inbound-runner.js +0 -34
  242. package/lib/built/interactive-segment-contract.d.ts +0 -6
  243. package/lib/built/interactive-segment-contract.js +0 -9
  244. package/lib/built/interactive-segments/fallback-store.d.ts +0 -29
  245. package/lib/built/interactive-segments/fallback-store.js +0 -63
  246. package/lib/built/interactive-segments/handlers.d.ts +0 -16
  247. package/lib/built/interactive-segments/handlers.js +0 -74
  248. package/lib/built/introspection-format.d.ts +0 -10
  249. package/lib/built/introspection-format.js +0 -28
  250. package/lib/built/management-command-guard.d.ts +0 -15
  251. package/lib/built/management-command-guard.js +0 -25
  252. package/lib/built/message-filter.d.ts +0 -176
  253. package/lib/built/message-filter.js +0 -239
  254. package/lib/built/optional-peer-import.d.ts +0 -3
  255. package/lib/built/optional-peer-import.js +0 -33
  256. package/lib/built/outbound-media-contract.d.ts +0 -22
  257. package/lib/built/outbound-media-contract.js +0 -10
  258. package/lib/built/permission.d.ts +0 -51
  259. package/lib/built/permission.js +0 -99
  260. package/lib/built/permit-check.d.ts +0 -7
  261. package/lib/built/permit-check.js +0 -35
  262. package/lib/built/permit-parse.d.ts +0 -16
  263. package/lib/built/permit-parse.js +0 -32
  264. package/lib/built/platform-permit.d.ts +0 -20
  265. package/lib/built/platform-permit.js +0 -91
  266. package/lib/built/queue-im-field-contract.d.ts +0 -32
  267. package/lib/built/queue-im-field-contract.js +0 -67
  268. package/lib/built/rich-segments/adapter-policies.d.ts +0 -9
  269. package/lib/built/rich-segments/adapter-policies.js +0 -27
  270. package/lib/built/rich-segments/base.d.ts +0 -11
  271. package/lib/built/rich-segments/base.js +0 -24
  272. package/lib/built/rich-segments/builtins.d.ts +0 -4
  273. package/lib/built/rich-segments/builtins.js +0 -40
  274. package/lib/built/rich-segments/capabilities.d.ts +0 -6
  275. package/lib/built/rich-segments/capabilities.js +0 -38
  276. package/lib/built/rich-segments/html-segment.d.ts +0 -15
  277. package/lib/built/rich-segments/html-segment.js +0 -62
  278. package/lib/built/rich-segments/index.d.ts +0 -13
  279. package/lib/built/rich-segments/index.js +0 -13
  280. package/lib/built/rich-segments/markdown-segment.d.ts +0 -14
  281. package/lib/built/rich-segments/markdown-segment.js +0 -58
  282. package/lib/built/rich-segments/qrcode-segment.d.ts +0 -18
  283. package/lib/built/rich-segments/qrcode-segment.js +0 -73
  284. package/lib/built/rich-segments/registry.d.ts +0 -16
  285. package/lib/built/rich-segments/registry.js +0 -52
  286. package/lib/built/rich-segments/resolve.d.ts +0 -5
  287. package/lib/built/rich-segments/resolve.js +0 -87
  288. package/lib/built/rich-segments/tts-segment.d.ts +0 -13
  289. package/lib/built/rich-segments/tts-segment.js +0 -51
  290. package/lib/built/rich-segments/types.d.ts +0 -79
  291. package/lib/built/rich-segments/types.js +0 -17
  292. package/lib/built/runtime-io.d.ts +0 -9
  293. package/lib/built/runtime-io.js +0 -67
  294. package/lib/built/schedule.d.ts +0 -54
  295. package/lib/built/schedule.js +0 -112
  296. package/lib/built/schema-endpoint-manager.d.ts +0 -17
  297. package/lib/built/schema-endpoint-manager.js +0 -73
  298. package/lib/built/schema-feature.d.ts +0 -77
  299. package/lib/built/schema-feature.js +0 -130
  300. package/lib/built/skill.d.ts +0 -120
  301. package/lib/built/skill.js +0 -151
  302. package/lib/built/speech-loader.d.ts +0 -14
  303. package/lib/built/speech-loader.js +0 -32
  304. package/lib/built/tool.d.ts +0 -151
  305. package/lib/built/tool.js +0 -388
  306. package/lib/command.d.ts +0 -50
  307. package/lib/command.js +0 -106
  308. package/lib/component.d.ts +0 -26
  309. package/lib/component.js +0 -583
  310. package/lib/endpoint-capabilities.d.ts +0 -46
  311. package/lib/endpoint-capabilities.js +0 -55
  312. package/lib/endpoint.d.ts +0 -19
  313. package/lib/endpoint.js +0 -3
  314. package/lib/host-plugin-registry.d.ts +0 -8
  315. package/lib/host-plugin-registry.js +0 -12
  316. package/lib/plugin-context.d.ts +0 -27
  317. package/lib/plugin-context.js +0 -64
  318. package/lib/plugin-runtime/im/interactive.d.ts +0 -26
  319. package/lib/plugin-runtime/im/interactive.js +0 -46
  320. package/lib/plugin-runtime/im/login-assist-host.d.ts +0 -6
  321. package/lib/plugin-runtime/im/login-assist-host.js +0 -6
  322. package/lib/plugin-runtime/im/message-bus.d.ts +0 -38
  323. package/lib/plugin-runtime/im/message-bus.js +0 -40
  324. package/lib/plugin-runtime/im/service-tokens.d.ts +0 -18
  325. package/lib/plugin-runtime/im/service-tokens.js +0 -13
  326. package/lib/plugin.d.ts +0 -268
  327. package/lib/plugin.js +0 -583
  328. package/lib/schema-interaction.d.ts +0 -117
  329. package/lib/schema-interaction.js +0 -247
  330. package/lib/side-event/dispatch.d.ts +0 -15
  331. package/lib/side-event/dispatch.js +0 -140
  332. package/lib/tool-zod.d.ts +0 -43
  333. package/lib/tool-zod.js +0 -184
  334. /package/lib/{built/endpoint-manager.js → jsx/intrinsic-elements.js} +0 -0
@@ -1,62 +1,263 @@
1
- const FRAMEWORK_SENDER_ROLES = new Set(['user', 'trusted', 'master']);
2
- export function isFrameworkSenderRole(role) {
3
- return FRAMEWORK_SENDER_ROLES.has(role);
4
- }
5
- /** 匹配工具要求时的隐含升格(不写入持久化 roles 集合) */
6
- const ROLE_IMPLIES = {
7
- master: ['trusted'],
8
- };
9
- export function expandImpliedRoles(roles) {
10
- const out = new Set(roles);
11
- for (const role of [...out]) {
12
- for (const implied of ROLE_IMPLIES[role] ?? []) {
13
- out.add(implied);
14
- }
1
+ /**
2
+ * ADR 0056: chat roles — zhin roles at four levels, next to (never derived from) the normalized
3
+ * platform standing.
4
+ *
5
+ * - zhin roles: `owner` ⊃ `admin` ⊃ `trusted`, held by a platform identity `(adapter alias, userId)`
6
+ * at one scope (`''`, `<alias>`, `<alias>/<endpointId>` or a conversation key) and effective at
7
+ * that scope and every scope under it. They come only from stored grants (the instance's
8
+ * `chat_roles` table, including grants migrated from the old configuration lists).
9
+ * - Platform standing (group owner / admin, platform roles and permissions) is *not* converted into
10
+ * a zhin role (ADR 0056 §4, revised 2026-11-12); it is a separate dimension read by `platform:*`
11
+ * permits, and the Bot account's own standing by `bot:*` permits.
12
+ * - Every inbound message gets `sender.chatRole` (highest role effective in its conversation) and a
13
+ * normalized `sender.platform` from {@link createChatRoleSenderEnricher}.
14
+ */
15
+ import { normalizePlatformStanding, } from '@zhin.js/im-contract';
16
+ import { featureKeyLevel, formatFeatureResolutionKey, parseFeatureConversationKey, parseFeatureResolutionKey, resolveEndpointFeatureKey, } from '@zhin.js/plugin-runtime';
17
+ export { CHAT_ROLE_LEVELS, chatRoleHeldAt, hostChatRole, isChatRoleLevel, normalizeChatRoleLevels, } from '@zhin.js/im-contract';
18
+ export const CHAT_ROLES = Object.freeze(['owner', 'admin', 'trusted']);
19
+ const RANK = Object.freeze({ trusted: 1, admin: 2, owner: 3 });
20
+ export function isChatRole(value) {
21
+ return value === 'owner' || value === 'admin' || value === 'trusted';
22
+ }
23
+ /** `owner` ⊃ `admin` ⊃ `trusted`. */
24
+ export function chatRoleIncludes(held, required) {
25
+ return held !== undefined && RANK[held] >= RANK[required];
26
+ }
27
+ /** The higher of two roles. */
28
+ export function higherChatRole(left, right) {
29
+ if (!left)
30
+ return right;
31
+ if (!right)
32
+ return left;
33
+ return RANK[right] > RANK[left] ? right : left;
34
+ }
35
+ /** Whether a role list (expanded or not, other strings ignored) holds `required`. */
36
+ export function chatRolesInclude(roles, required) {
37
+ return (roles ?? []).some(role => isChatRole(role) && chatRoleIncludes(role, required));
38
+ }
39
+ /** `owner` → `[owner, admin, trusted]`, `admin` → `[admin, trusted]`, none → `[]`. */
40
+ export function expandChatRole(role) {
41
+ return role ? CHAT_ROLES.filter(candidate => chatRoleIncludes(role, candidate)) : [];
42
+ }
43
+ // ============================================================================
44
+ // Identities and scopes
45
+ // ============================================================================
46
+ const ADAPTER_ALIAS = /^[a-z0-9][a-z0-9-]*$/u;
47
+ // eslint-disable-next-line no-control-regex
48
+ const CONTROL = /[\u0000-\u001f\u007f]/u;
49
+ export function isChatIdentity(value) {
50
+ const identity = value;
51
+ return !!identity && typeof identity.adapter === 'string' && ADAPTER_ALIAS.test(identity.adapter)
52
+ && typeof identity.userId === 'string' && identity.userId.length > 0 && identity.userId.length <= 256 && !CONTROL.test(identity.userId);
53
+ }
54
+ /** Validates `level` + `key` and returns the normalized scope key; throws TypeError. */
55
+ export function normalizeChatRoleScope(level, key) {
56
+ if (level === 'global') {
57
+ if (key !== undefined && key !== '')
58
+ throw new TypeError('global scope takes no key');
59
+ return '';
60
+ }
61
+ if (level !== 'adapter' && level !== 'endpoint' && level !== 'conversation')
62
+ throw new TypeError('level must be global, adapter, endpoint or conversation');
63
+ if (typeof key !== 'string' || !key)
64
+ throw new TypeError('key is required');
65
+ let normalized;
66
+ try {
67
+ normalized = formatFeatureResolutionKey(parseFeatureResolutionKey(key));
15
68
  }
16
- return out;
69
+ catch {
70
+ throw new TypeError(`key does not address the ${level} level`);
71
+ }
72
+ if (normalized !== key || featureKeyLevel(key) !== level)
73
+ throw new TypeError(`key does not address the ${level} level`);
74
+ if (!ADAPTER_ALIAS.test(parseFeatureResolutionKey(key).adapter ?? ''))
75
+ throw new TypeError('key must start with an adapter instance alias');
76
+ return key;
77
+ }
78
+ /** Scope keys from global down to `key` (`''`, `qq`, `qq/bot`, `qq/bot/group:1`). */
79
+ export function chatScopeChain(key) {
80
+ const parsed = parseFeatureResolutionKey(key);
81
+ const chain = [''];
82
+ if (parsed.adapter !== undefined)
83
+ chain.push(parsed.adapter);
84
+ if (parsed.endpointId !== undefined)
85
+ chain.push(`${parsed.adapter}/${parsed.endpointId}`);
86
+ if (parsed.conversation !== undefined)
87
+ chain.push(formatFeatureResolutionKey(parsed));
88
+ return Object.freeze(chain);
17
89
  }
18
- export function roleSatisfies(callerRoles, requiredAnyRole) {
19
- if (!requiredAnyRole?.length)
20
- return true;
21
- const expanded = expandImpliedRoles(callerRoles);
22
- return requiredAnyRole.some((req) => expanded.has(req));
90
+ /** Whether scope `upper` is `lower` or one of its ancestors. */
91
+ export function chatScopeCovers(upper, lower) {
92
+ return chatScopeChain(lower).includes(upper);
23
93
  }
24
- /** 去重;无其它角色时返回 ['user'] */
25
- export function normalizeSenderRoles(roles) {
26
- const set = new Set();
27
- for (const r of roles) {
28
- if (r !== 'user')
29
- set.add(r);
94
+ export function chatScopeLevel(key) {
95
+ return key === '' ? 'global' : featureKeyLevel(key);
96
+ }
97
+ /** Per role, the level of the topmost entry holding it (entries sorted global first). */
98
+ function chatRoleLevelsOf(entries) {
99
+ const levels = {};
100
+ for (const role of CHAT_ROLES) {
101
+ const top = entries.find(entry => chatRoleIncludes(entry.role, role));
102
+ if (top)
103
+ levels[role] = top.level;
30
104
  }
31
- if (set.size === 0)
32
- return ['user'];
33
- return [...set];
105
+ return Object.freeze(levels);
34
106
  }
35
- export function hasSenderRole(roles, role) {
36
- return expandImpliedRoles(roles).has(role);
107
+ function highest(entries) {
108
+ let best;
109
+ for (const entry of entries)
110
+ best = higherChatRole(best, entry.role);
111
+ return best;
37
112
  }
38
- export function formatSenderRolesForLabel(roles) {
39
- return roles.filter((r) => r !== 'user').join(',') || 'user';
113
+ /**
114
+ * Resolution over stored grants (ADR 0056 §2): for a message the chain is
115
+ * conversation → endpoint → adapter → global and the highest role wins.
116
+ */
117
+ export class ChatRoleService {
118
+ store;
119
+ constructor(options) {
120
+ this.store = options.store;
121
+ }
122
+ /** Entries of `identity` effective at `scopeKey` (own scope and every ancestor). */
123
+ entriesFor(identity, scopeKey) {
124
+ const chain = chatScopeChain(scopeKey);
125
+ const stored = this.store.list().filter(entry => entry.adapter === identity.adapter && entry.userId === identity.userId && chain.includes(entry.key));
126
+ return Object.freeze([...stored].sort((left, right) => chain.indexOf(left.key) - chain.indexOf(right.key)));
127
+ }
128
+ /** Highest role of `identity` effective at `scopeKey`. */
129
+ roleAt(identity, scopeKey) {
130
+ return highest(this.entriesFor(identity, scopeKey));
131
+ }
132
+ hasRole(identity, scopeKey, role) {
133
+ return chatRoleIncludes(this.roleAt(identity, scopeKey), role);
134
+ }
135
+ /**
136
+ * Per role, the topmost level at which `identity` holds that role (or a higher one) on the chain
137
+ * of `scopeKey` (`sender.chatRoleLevels`).
138
+ */
139
+ levelsFor(identity, scopeKey) {
140
+ return chatRoleLevelsOf(this.entriesFor(identity, scopeKey));
141
+ }
142
+ /** Highest role held at a scope strictly above `scopeKey`. */
143
+ roleAbove(identity, scopeKey) {
144
+ return highest(this.entriesFor(identity, scopeKey).filter(entry => entry.key !== scopeKey));
145
+ }
146
+ /** Sender roles for a message (`undefined` outside a keyed conversation). */
147
+ effectiveRoles(snapshot, message) {
148
+ const subject = chatRoleMessageContext(snapshot, message);
149
+ if (!subject)
150
+ return undefined;
151
+ const entries = this.entriesFor(subject.identity, subject.context.conversationKey);
152
+ const role = highest(entries);
153
+ return Object.freeze({ identity: subject.identity, conversationKey: subject.context.conversationKey, ...(role ? { role } : {}), entries });
154
+ }
155
+ /** Stored entries covering `scopeKey` (and below it with `descendants`). */
156
+ list(scopeKey, descendants = false) {
157
+ const relevant = (key) => chatScopeCovers(key, scopeKey) || (descendants && chatScopeCovers(scopeKey, key));
158
+ return Object.freeze(this.store.list().filter(entry => relevant(entry.key)));
159
+ }
160
+ /**
161
+ * Stored `owner`s of `scopeKey` and its ancestors whose identity is on `adapter`, closest scope
162
+ * first (who to ask for owner approval on an account).
163
+ */
164
+ ownersOf(scopeKey, adapter) {
165
+ const chain = chatScopeChain(scopeKey);
166
+ const owners = this.store.list()
167
+ .filter(entry => entry.role === 'owner' && entry.adapter === adapter && chain.includes(entry.key))
168
+ .sort((left, right) => chain.indexOf(right.key) - chain.indexOf(left.key));
169
+ return Object.freeze([...new Set(owners.map(entry => entry.userId))]);
170
+ }
40
171
  }
41
- /** 剥离用户正文里自造的发送者前缀 */
42
- export function stripUserSpoofedSenderPrefix(rawContent) {
43
- let text = rawContent.trimStart();
44
- const prefixRe = /^\[sender:(?:id=[^\]]*|[^\]]*)\]\s*/i;
45
- const rolesRe = /^\[sender:id=[^\s\]]+(?:\s+name=[^\]]+)?\s+roles=[^\]]+\]\s*/i;
46
- let changed = true;
47
- while (changed) {
48
- changed = false;
49
- const m1 = text.match(prefixRe);
50
- if (m1) {
51
- text = text.slice(m1[0].length);
52
- changed = true;
53
- continue;
172
+ // ============================================================================
173
+ // Platform standing
174
+ // ============================================================================
175
+ const record = (value) => !!value && typeof value === 'object' && !Array.isArray(value);
176
+ /** Normalized platform standing of a sender (`sender.platform`, ADR 0056 §1). */
177
+ export function platformStandingOf(sender) {
178
+ return record(sender) ? normalizePlatformStanding(sender.platform) : undefined;
179
+ }
180
+ /** `platform:admin` is met by `admin` and `owner` standings, `platform:owner` only by `owner`. */
181
+ export function platformStandingIncludes(held, required) {
182
+ return required === 'owner' ? held === 'owner' : held === 'owner' || held === 'admin';
183
+ }
184
+ /**
185
+ * Identity + context of a message's sender. `context.conversationKey` is the conversation key, or —
186
+ * when the conversation cannot be keyed (unknown kind, an id that cannot be part of a key) — the
187
+ * receiving endpoint's key, so roles granted at the endpoint level and above still resolve.
188
+ * Threads / topics (`conversation.threadId`) share their parent conversation's key, and a platform
189
+ * container (`conversation.parent`, e.g. a guild) adds no level (ADR 0056 §2).
190
+ * Undefined when not even the endpoint can be addressed.
191
+ */
192
+ export function chatRoleMessageContext(snapshot, message) {
193
+ if (!record(message) || !record(message.conversation) || !record(message.conversation.endpoint))
194
+ return undefined;
195
+ const conversation = message.conversation;
196
+ if (typeof conversation.endpoint.id !== 'string')
197
+ return undefined;
198
+ const key = resolveEndpointFeatureKey(snapshot, conversation.endpoint.id, typeof message.endpointId === 'string' ? message.endpointId : undefined, conversation);
199
+ if (!key)
200
+ return undefined;
201
+ let adapter;
202
+ try {
203
+ adapter = parseFeatureResolutionKey(key).adapter;
204
+ }
205
+ catch {
206
+ return undefined;
207
+ }
208
+ if (!adapter)
209
+ return undefined;
210
+ const parsed = parseFeatureConversationKey(key);
211
+ const sender = record(message.sender) ? message.sender : undefined;
212
+ const identity = { adapter, userId: typeof sender?.id === 'string' ? sender.id : '' };
213
+ if (!isChatIdentity(identity))
214
+ return undefined;
215
+ const kind = parsed?.conversation.kind ?? conversation.kind;
216
+ const platform = kind === 'private' ? undefined : platformStandingOf(sender);
217
+ return { identity, context: { conversationKey: key, ...(platform ? { platform } : {}) } };
218
+ }
219
+ /**
220
+ * Inbound sender enricher: drops any adapter-supplied `chatRole` / `chatRoleLevels`, normalizes
221
+ * `platform` (not in private chats) and sets `chatRole` to the highest role effective in the
222
+ * conversation and `chatRoleLevels` to where each role comes from.
223
+ */
224
+ export function createChatRoleSenderEnricher(options) {
225
+ return (sender, conversation, snapshot) => {
226
+ if (!sender?.id)
227
+ return sender;
228
+ const { chatRole: _spoofed, chatRoleLevels: _spoofedLevels, platform: _reported, ...rest } = sender;
229
+ const platform = conversation.kind === 'private' ? undefined : platformStandingOf(sender);
230
+ const base = { ...rest, ...(platform ? { platform } : {}) };
231
+ const service = options.roles();
232
+ if (!service || !snapshot)
233
+ return Object.freeze(base);
234
+ const subject = chatRoleMessageContext(snapshot, { conversation, sender: base });
235
+ if (!subject)
236
+ return Object.freeze(base);
237
+ let entries;
238
+ try {
239
+ entries = service.entriesFor(subject.identity, subject.context.conversationKey);
54
240
  }
55
- const m2 = text.match(rolesRe);
56
- if (m2) {
57
- text = text.slice(m2[0].length);
58
- changed = true;
241
+ catch {
242
+ entries = [];
59
243
  }
60
- }
61
- return text;
244
+ const role = highest(entries);
245
+ return Object.freeze({ ...base, ...(role ? { chatRole: role, chatRoleLevels: chatRoleLevelsOf(entries) } : {}) });
246
+ };
247
+ }
248
+ // ============================================================================
249
+ // Prompt label hygiene
250
+ // ============================================================================
251
+ // 空白与零宽字符(不含 U+200D:会破坏 emoji ZWJ 序列)。
252
+ const SPOOF_GAP = '[\\s\\u200B\\u200C\\u2060\\uFEFF]';
253
+ const spoofWord = (word) => word.split('').join(`${SPOOF_GAP}*`);
254
+ const SPOOFED_LABEL_RE = new RegExp(`\\[(?=${SPOOF_GAP}*(?:${spoofWord('sender')}|${spoofWord('origin')})${SPOOF_GAP}*[::])`, 'gi');
255
+ /**
256
+ * 转义用户正文里所有自造的 `[sender:` / `[origin:` 标签(任意位置、大小写不敏感,
257
+ * 容忍 `[ sender :`、零宽字符、全角冒号)。命中时把开头的 ASCII `[` 换成全角 `[`,
258
+ * 其余原样保留:模型仍能看出这是用户文本,但它不再是权威标签。
259
+ * 幂等(已转义文本再次调用不变),不再剥离开头,也不 trim 原文空白。
260
+ */
261
+ export function stripUserSpoofedSenderPrefix(rawContent) {
262
+ return rawContent.replace(SPOOFED_LABEL_RE, '[');
62
263
  }
@@ -1,12 +1,14 @@
1
1
  import { isStrictCanonicalSegment } from './validate.js';
2
+ import { isActionSegment, isKeyboardSegment } from '../interactive-segments/types.js';
2
3
  const STRICT_CANONICAL_TYPES = new Set([
3
- 'text', 'mention', 'image', 'audio', 'video', 'file', 'reply', 'forward', 'face', 'dice', 'rps',
4
+ 'text', 'mention', 'image', 'audio', 'video', 'file', 'reply', 'forward',
5
+ 'face', 'dice', 'rps', 'share',
4
6
  ]);
5
7
  // These are Core-owned wire extensions rather than canonical data types. Keep
6
8
  // their gradual contracts isolated here; third-party extensions must be
7
9
  // namespaced so a future canonical type cannot silently collide with them.
8
10
  const CORE_EXTENSION_TYPES = new Set([
9
- 'action', 'html', 'keyboard', 'link', 'markdown', 'qrcode', 'record', 'tts', 'voice',
11
+ 'action', 'card', 'html', 'keyboard', 'link', 'markdown', 'qrcode', 'record', 'tts', 'voice',
10
12
  ]);
11
13
  const extensionTypePattern = /^[a-z][a-z0-9-]*(?::[a-z][a-z0-9-]*)+$/u;
12
14
  function isPlainObject(value) {
@@ -25,6 +27,10 @@ export function isCanonicalSegment(value) {
25
27
  return false;
26
28
  if (STRICT_CANONICAL_TYPES.has(value.type))
27
29
  return isStrictCanonicalSegment(value);
30
+ if (value.type === 'keyboard')
31
+ return isKeyboardSegment(value);
32
+ if (value.type === 'action')
33
+ return isActionSegment(value);
28
34
  return CORE_EXTENSION_TYPES.has(value.type) || extensionTypePattern.test(value.type);
29
35
  }
30
36
  export function assertCanonicalSegments(segments) {
@@ -15,6 +15,7 @@ const IM_VISIBLE_TYPES = new Set([
15
15
  'link',
16
16
  'dice',
17
17
  'rps',
18
+ 'share',
18
19
  'markdown',
19
20
  'html',
20
21
  'qrcode',
@@ -1,7 +1,7 @@
1
- export type { Segment, SegmentBase, MediaRef, TextSegment, MentionSegment, ImageSegment, AudioSegment, VideoSegment, FileSegment, ReplySegment, ForwardSegment, FaceSegment, DiceSegment, RpsSegment, } from './types.js';
2
- export { mediaRefSchema, textSegmentSchema, mentionSegmentSchema, imageSegmentSchema, audioSegmentSchema, videoSegmentSchema, fileSegmentSchema, replySegmentSchema, forwardSegmentSchema, faceSegmentSchema, diceSegmentSchema, rpsSegmentSchema, canonicalSegmentSchema, segmentArraySchema, } from './validate.js';
1
+ export type { Segment, SegmentBase, MediaRef, TextSegment, MentionSegment, ImageSegment, AudioSegment, VideoSegment, FileSegment, ReplySegment, ForwardSegment, ShareSegment, FaceSegment, DiceSegment, RpsSegment, } from './types.js';
2
+ export { mediaRefSchema, textSegmentSchema, mentionSegmentSchema, imageSegmentSchema, audioSegmentSchema, videoSegmentSchema, fileSegmentSchema, replySegmentSchema, forwardSegmentSchema, faceSegmentSchema, diceSegmentSchema, rpsSegmentSchema, shareSegmentSchema, canonicalSegmentSchema, segmentArraySchema, } from './validate.js';
3
3
  export { assertCanonicalSegments, isCanonicalSegment } from './assert.js';
4
- export { mediaRefJsonSchema, outboundSegmentJsonSchema, aiOutboundJsonSchema, STRICT_OUTBOUND_SEGMENT_TYPES, } from './json-schema.js';
4
+ export { mediaRefJsonSchema, outboundSegmentJsonSchema, aiOutboundJsonSchema, buildAiOutboundJsonSchema, AI_OUTBOUND_SEGMENT_TYPES, DEFAULT_AI_OUTBOUND_SEGMENT_TYPES, STRICT_OUTBOUND_SEGMENT_TYPES, type AiOutboundSegmentType, type AiSegmentExtension, type AiSegmentExtensions, type AiOutboundSegmentProfile, type AiReactionProfile, } from './json-schema.js';
5
5
  export { segmentsForImDelivery } from './delivery.js';
6
6
  export { isMediaRef, collectSegmentMedia, type SegmentMediaRef, } from './media.js';
7
7
  export { createImageSegment } from './image.js';
@@ -1,6 +1,6 @@
1
- export { mediaRefSchema, textSegmentSchema, mentionSegmentSchema, imageSegmentSchema, audioSegmentSchema, videoSegmentSchema, fileSegmentSchema, replySegmentSchema, forwardSegmentSchema, faceSegmentSchema, diceSegmentSchema, rpsSegmentSchema, canonicalSegmentSchema, segmentArraySchema, } from './validate.js';
1
+ export { mediaRefSchema, textSegmentSchema, mentionSegmentSchema, imageSegmentSchema, audioSegmentSchema, videoSegmentSchema, fileSegmentSchema, replySegmentSchema, forwardSegmentSchema, faceSegmentSchema, diceSegmentSchema, rpsSegmentSchema, shareSegmentSchema, canonicalSegmentSchema, segmentArraySchema, } from './validate.js';
2
2
  export { assertCanonicalSegments, isCanonicalSegment } from './assert.js';
3
- export { mediaRefJsonSchema, outboundSegmentJsonSchema, aiOutboundJsonSchema, STRICT_OUTBOUND_SEGMENT_TYPES, } from './json-schema.js';
3
+ export { mediaRefJsonSchema, outboundSegmentJsonSchema, aiOutboundJsonSchema, buildAiOutboundJsonSchema, AI_OUTBOUND_SEGMENT_TYPES, DEFAULT_AI_OUTBOUND_SEGMENT_TYPES, STRICT_OUTBOUND_SEGMENT_TYPES, } from './json-schema.js';
4
4
  export { segmentsForImDelivery } from './delivery.js';
5
5
  export { isMediaRef, collectSegmentMedia, } from './media.js';
6
6
  export { createImageSegment } from './image.js';
@@ -13,16 +13,50 @@ type JsonSchemaObject = Record<string, unknown>;
13
13
  /** MediaRef(canonical 媒体引用):types.ts 的 MediaRef 接口 */
14
14
  export declare const mediaRefJsonSchema: JsonSchemaObject;
15
15
  /** 严格段类型集合(SSOT:assert.ts STRICT_CANONICAL_TYPES) */
16
- export declare const STRICT_OUTBOUND_SEGMENT_TYPES: readonly ["text", "mention", "image", "reply", "forward", "face", "dice", "rps"];
16
+ export declare const STRICT_OUTBOUND_SEGMENT_TYPES: readonly ["text", "mention", "image", "audio", "video", "file", "reply", "forward", "face", "dice", "rps", "share"];
17
17
  /**
18
18
  * 单条 outbound 消息段的 JSON Schema。
19
- * 严格段镜像 validate.ts 的 data 约束;宽松段走 generic 分支。
19
+ * 严格段镜像 validate.ts,交互段镜像 interactive-segments/types.ts;其他扩展段走宽松分支。
20
20
  */
21
21
  export declare const outboundSegmentJsonSchema: JsonSchemaObject;
22
22
  /**
23
- * AI 结构化出站根对象(ADR 0025 JSON DSL 的 schema 形态)。
24
- * 与 parseAiOutboundJson / ZhinAiOutboundPayload 对齐:text、mentions、segments
25
- * 均为可选(provider strict 模式兼容性考虑),"至少一项"由 prompt 与下游校验兜底。
23
+ * Segment types a model may author in a final reply. reply / forward / face are
24
+ * left out: they carry platform ids (message, forward, emoji) the model has no
25
+ * reliable source for.
26
26
  */
27
+ export declare const AI_OUTBOUND_SEGMENT_TYPES: readonly ["text", "mention", "image", "audio", "video", "file", "markdown", "keyboard", "share", "dice", "rps"];
28
+ export type AiOutboundSegmentType = typeof AI_OUTBOUND_SEGMENT_TYPES[number];
29
+ /**
30
+ * Adapter-declared model extension for one segment type (`segments.model`):
31
+ * optional string fields of the canonical segment the model may fill, and a
32
+ * platform hint appended to the reply instruction.
33
+ */
34
+ export interface AiSegmentExtension {
35
+ readonly fields?: readonly string[];
36
+ readonly hint?: string;
37
+ }
38
+ export type AiSegmentExtensions = Readonly<Partial<Record<AiOutboundSegmentType, AiSegmentExtension>>>;
39
+ /** Reactions the model may put on the message it answers (platform value + meaning). */
40
+ export interface AiReactionProfile {
41
+ readonly values: readonly {
42
+ readonly value: string;
43
+ readonly label: string;
44
+ }[];
45
+ }
46
+ /** What one reply endpoint lets the model author: offered types plus their declared extensions. */
47
+ export interface AiOutboundSegmentProfile {
48
+ readonly types: readonly AiOutboundSegmentType[];
49
+ readonly extensions?: AiSegmentExtensions;
50
+ /** Present when the endpoint can react to the current message in this conversation. */
51
+ readonly reaction?: AiReactionProfile;
52
+ }
53
+ /** Offered when the adapter declares no `segments.supported` list. */
54
+ export declare const DEFAULT_AI_OUTBOUND_SEGMENT_TYPES: readonly AiOutboundSegmentType[];
55
+ /**
56
+ * The model's final reply: one or more chat messages, sent in order. Each message
57
+ * is an ordered segment array; the model decides how to split, like a person
58
+ * sending a few short messages. No text/mentions shorthand.
59
+ */
60
+ export declare function buildAiOutboundJsonSchema(types?: readonly AiOutboundSegmentType[], extensions?: AiSegmentExtensions, reaction?: AiReactionProfile): JsonSchemaObject;
27
61
  export declare const aiOutboundJsonSchema: JsonSchemaObject;
28
62
  export {};