@zhin.js/core 1.1.50 → 1.1.51

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 (65) hide show
  1. package/README.md +4 -0
  2. package/lib/built/ai-trigger.d.ts +3 -1
  3. package/lib/built/ai-trigger.js +1 -0
  4. package/lib/built/generic-segment-mapper.js +2 -1
  5. package/lib/built/interaction-messages.d.ts +1 -0
  6. package/lib/built/interaction-messages.js +29 -0
  7. package/lib/built/message-enrich.d.ts +2 -0
  8. package/lib/built/message-enrich.js +3 -0
  9. package/lib/built/user-interaction.d.ts +4 -3
  10. package/lib/built/user-interaction.js +49 -40
  11. package/lib/feature/command-public-api.d.ts +5 -0
  12. package/lib/feature/command-public-api.js +5 -0
  13. package/lib/feature/command.d.ts +4 -0
  14. package/lib/feature/command.js +2 -0
  15. package/lib/feature/middleware-public-api.d.ts +1 -0
  16. package/lib/feature/middleware-public-api.js +1 -0
  17. package/lib/feature/middleware.d.ts +2 -0
  18. package/lib/feature/middleware.js +1 -0
  19. package/lib/notice.d.ts +4 -0
  20. package/lib/notice.js +2 -0
  21. package/lib/plugin-runtime/im/command-feedback.d.ts +38 -0
  22. package/lib/plugin-runtime/im/command-feedback.js +73 -0
  23. package/lib/plugin-runtime/im/command-menu-navigation.d.ts +1 -1
  24. package/lib/plugin-runtime/im/command-menu-navigation.js +16 -7
  25. package/lib/plugin-runtime/im/command-menu-presentation.d.ts +14 -0
  26. package/lib/plugin-runtime/im/command-menu-presentation.js +25 -0
  27. package/lib/plugin-runtime/im/contracts.d.ts +25 -2
  28. package/lib/plugin-runtime/im/contracts.js +21 -1
  29. package/lib/plugin-runtime/im/conversation-runtime.d.ts +6 -2
  30. package/lib/plugin-runtime/im/conversation-runtime.js +71 -3
  31. package/lib/plugin-runtime/im/endpoint-runtime.d.ts +5 -2
  32. package/lib/plugin-runtime/im/endpoint-runtime.js +3 -1
  33. package/lib/plugin-runtime/im/im-runtime.d.ts +3 -1
  34. package/lib/plugin-runtime/im/im-runtime.js +39 -2
  35. package/lib/plugin-runtime/im/inbound-runtime.d.ts +4 -1
  36. package/lib/plugin-runtime/im/inbound-runtime.js +20 -6
  37. package/lib/plugin-runtime/im/index.d.ts +2 -1
  38. package/lib/plugin-runtime/im/index.js +1 -0
  39. package/lib/plugin-runtime/im/interaction-runtime.d.ts +2 -0
  40. package/lib/plugin-runtime/im/interaction-runtime.js +15 -11
  41. package/lib/plugin-runtime/im/jsx-button-registry.js +2 -1
  42. package/lib/plugin-runtime/im/locale.d.ts +5 -0
  43. package/lib/plugin-runtime/im/locale.js +12 -0
  44. package/lib/plugin-runtime/im/member-welcome.d.ts +8 -0
  45. package/lib/plugin-runtime/im/member-welcome.js +11 -0
  46. package/lib/plugin-runtime/im/message-dispatcher.d.ts +16 -2
  47. package/lib/plugin-runtime/im/message-dispatcher.js +24 -28
  48. package/lib/plugin-runtime/im/message-events.d.ts +20 -0
  49. package/lib/plugin-runtime/im/message-events.js +17 -0
  50. package/lib/plugin-runtime/im/outbound-delivery-runtime.js +7 -1
  51. package/lib/plugin-runtime/im/outbound-presentation.d.ts +19 -0
  52. package/lib/plugin-runtime/im/outbound-presentation.js +41 -0
  53. package/lib/plugin-runtime/im/outbound-projection.d.ts +2 -0
  54. package/lib/plugin-runtime/im/outbound-projection.js +3 -3
  55. package/lib/plugin-runtime/im/outbound-renderer.js +4 -1
  56. package/lib/side-event/dispatch.js +26 -4
  57. package/lib/side-event/index.d.ts +1 -0
  58. package/lib/side-event/index.js +1 -0
  59. package/lib/side-event/normalize.js +2 -1
  60. package/lib/side-event/scene-events.d.ts +40 -0
  61. package/lib/side-event/scene-events.js +147 -0
  62. package/lib/side-event/types.d.ts +1 -1
  63. package/lib/side-event/types.js +7 -0
  64. package/lib/types.d.ts +8 -0
  65. package/package.json +14 -14
@@ -0,0 +1,147 @@
1
+ /** 场景事件类型(`message.created` / `message.recalled` 不在此列)。 */
2
+ export const SCENE_EVENT_TYPES = Object.freeze([
3
+ 'member.muted',
4
+ 'member.unmuted',
5
+ 'member.joined',
6
+ 'member.left',
7
+ 'member.role_changed',
8
+ 'scene.join_requested',
9
+ 'scene.notice_updated',
10
+ 'conversation.poked',
11
+ 'message.reaction_changed',
12
+ 'member.card_changed',
13
+ 'member.title_changed',
14
+ 'member.remark_changed',
15
+ ]);
16
+ /** 只在 `[Scene events]` 中出现、不进入旧的 conversation context 块的新类型(避免重复注入与落库)。 */
17
+ export const SCENE_ONLY_EVENT_TYPES = new Set([
18
+ 'scene.join_requested',
19
+ 'scene.notice_updated',
20
+ 'member.card_changed',
21
+ 'member.title_changed',
22
+ 'member.remark_changed',
23
+ ]);
24
+ /** 单条摘要的上限(字符)。整段 `[Scene events]` 另有总上限。 */
25
+ export const SCENE_EVENT_SUMMARY_MAX = 60;
26
+ /** 公告/申请附言等用户文本在事件里保存的上限。 */
27
+ export const SCENE_EVENT_TEXT_MAX = 40;
28
+ export function isSceneEvent(event) {
29
+ return SCENE_EVENT_TYPES.includes(event.type);
30
+ }
31
+ /** OneBot 等平台以 user_id 0 表示「全员」。 */
32
+ const WHOLE_SCENE_IDS = new Set(['0', 'all']);
33
+ /**
34
+ * 事件优先级;不是场景事件时返回 undefined。
35
+ * `selfIds` 为 Bot 在该平台的账号候选,用来判断「戳的是不是 Bot」。
36
+ */
37
+ export function sceneEventPriority(event, selfIds = new Set()) {
38
+ switch (event.type) {
39
+ case 'member.muted':
40
+ case 'member.unmuted':
41
+ case 'member.joined':
42
+ case 'member.left':
43
+ case 'scene.join_requested':
44
+ case 'scene.notice_updated':
45
+ return 'high';
46
+ case 'conversation.poked':
47
+ return event.target && selfIds.has(String(event.target.id)) ? 'high' : 'low';
48
+ case 'member.role_changed':
49
+ case 'message.reaction_changed':
50
+ case 'member.card_changed':
51
+ case 'member.title_changed':
52
+ case 'member.remark_changed':
53
+ return 'low';
54
+ default:
55
+ return undefined;
56
+ }
57
+ }
58
+ /** 截断并清理用户文本:去掉换行/控制字符,只留一行。 */
59
+ export function clipSceneText(value, max = SCENE_EVENT_TEXT_MAX) {
60
+ if (typeof value !== 'string')
61
+ return '';
62
+ // eslint-disable-next-line no-control-regex
63
+ const flat = value.replace(/[\u0000-\u001f\u007f]+/g, ' ').replace(/\s+/g, ' ').trim();
64
+ return flat.length > max ? `${flat.slice(0, max - 1)}…` : flat;
65
+ }
66
+ function nameOf(actor, options) {
67
+ if (!actor)
68
+ return 'someone';
69
+ const id = String(actor.id);
70
+ if (options.selfIds?.has(id))
71
+ return 'you';
72
+ if (WHOLE_SCENE_IDS.has(id))
73
+ return 'everyone';
74
+ const name = options.nameOf?.(actor)?.trim() || actor.displayName?.trim() || id;
75
+ return clipSceneText(name, 16) || id;
76
+ }
77
+ function formatDuration(seconds) {
78
+ if (!seconds || seconds <= 0)
79
+ return '';
80
+ if (seconds < 60)
81
+ return ` ${seconds}s`;
82
+ if (seconds < 3600)
83
+ return ` ${Math.round(seconds / 60)}m`;
84
+ if (seconds < 86400)
85
+ return ` ${Math.round(seconds / 3600)}h`;
86
+ return ` ${Math.round(seconds / 86400)}d`;
87
+ }
88
+ /**
89
+ * 一条事件的极短英文摘要(≤ {@link SCENE_EVENT_SUMMARY_MAX} 字符)。不是场景事件时返回空串。
90
+ * 摘要只含称呼、动作与截断后的短文本;没有分数、没有原始字段。
91
+ */
92
+ export function summarizeSceneEvent(event, options = {}) {
93
+ const by = (actor) => (actor ? ` by ${nameOf(actor, options)}` : '');
94
+ let text;
95
+ switch (event.type) {
96
+ case 'member.muted':
97
+ text = WHOLE_SCENE_IDS.has(String(event.member.id))
98
+ ? `mute-all on${by(event.actor)}`
99
+ : `${nameOf(event.member, options)} muted${formatDuration(event.durationSeconds)}${by(event.actor)}`;
100
+ break;
101
+ case 'member.unmuted':
102
+ text = WHOLE_SCENE_IDS.has(String(event.member.id))
103
+ ? `mute-all off${by(event.actor)}`
104
+ : `${nameOf(event.member, options)} unmuted${by(event.actor)}`;
105
+ break;
106
+ case 'member.joined':
107
+ text = `${nameOf(event.member, options)} joined`;
108
+ break;
109
+ case 'member.left':
110
+ text = event.reason === 'removed'
111
+ ? `${nameOf(event.member, options)} removed${by(event.actor)}`
112
+ : `${nameOf(event.member, options)} left`;
113
+ break;
114
+ case 'member.role_changed':
115
+ text = `${nameOf(event.member, options)} ${event.enabled ? 'became' : 'is no longer'} ${event.role}`;
116
+ break;
117
+ case 'scene.join_requested': {
118
+ const comment = clipSceneText(event.comment, 24);
119
+ text = event.invite
120
+ ? `${nameOf(event.actor, options)} invites you to join`
121
+ : `${nameOf(event.actor, options)} asks to join${comment ? `: "${comment}"` : ''}`;
122
+ break;
123
+ }
124
+ case 'scene.notice_updated': {
125
+ const body = clipSceneText(event.text, 30);
126
+ text = `notice updated${by(event.actor)}${body ? `: "${body}"` : ''}`;
127
+ break;
128
+ }
129
+ case 'conversation.poked':
130
+ text = `${nameOf(event.actor, options)} poked ${nameOf(event.target, options)}`;
131
+ break;
132
+ case 'message.reaction_changed':
133
+ text = `${nameOf(event.actor, options)} ${event.operation === 'removed' ? 'removed' : 'reacted'} ${clipSceneText(event.reaction, 8)}`;
134
+ break;
135
+ case 'member.card_changed':
136
+ case 'member.title_changed':
137
+ case 'member.remark_changed': {
138
+ const field = event.type === 'member.card_changed' ? 'card' : event.type === 'member.title_changed' ? 'title' : 'remark';
139
+ const value = clipSceneText(event.value, 16);
140
+ text = `${nameOf(event.member, options)} ${field} → ${value ? `"${value}"` : '(cleared)'}`;
141
+ break;
142
+ }
143
+ default:
144
+ return '';
145
+ }
146
+ return clipSceneText(text, SCENE_EVENT_SUMMARY_MAX);
147
+ }
@@ -5,7 +5,7 @@ export type NoticeKind = 'notice';
5
5
  export type RequestKind = 'request';
6
6
  export type SystemKind = 'system';
7
7
  /** 完整组合名(测试 / 文档 / 消费者匹配用) */
8
- export type ComposedNoticeName = 'notice.group.member_increase' | 'notice.group.member_decrease' | 'notice.group.admin_change' | 'notice.group.ban' | 'notice.group.recall' | 'notice.group.poke' | 'notice.group.transfer' | 'notice.group.upload' | 'notice.group.emoji_reaction' | 'notice.group.card_change' | 'notice.group.essence_add' | 'notice.group.essence_delete' | 'notice.friend.recall' | 'notice.friend.increase' | 'notice.friend.poke' | 'notice.endpoint.lifecycle' | (string & {});
8
+ export type ComposedNoticeName = 'notice.group.member_increase' | 'notice.group.member_decrease' | 'notice.group.admin_change' | 'notice.group.ban' | 'notice.group.recall' | 'notice.group.poke' | 'notice.group.transfer' | 'notice.group.upload' | 'notice.group.emoji_reaction' | 'notice.group.card_change' | 'notice.group.title_change' | 'notice.group.remark_change' | 'notice.group.notice_updated' | 'notice.group.essence_add' | 'notice.group.essence_delete' | 'notice.friend.recall' | 'notice.friend.increase' | 'notice.friend.poke' | 'notice.endpoint.lifecycle' | (string & {});
9
9
  export type ComposedRequestName = 'request.friend.add' | 'request.group.add' | 'request.group.invite' | (string & {});
10
10
  export type ComposedSystemName = 'system.login.qrcode' | 'system.login.slider' | 'system.login.device' | 'system.login.error' | 'system.login.auth' | 'system.offline' | 'system.offline.network' | 'system.offline.kickoff' | 'system.online' | (string & {});
11
11
  export interface SideEventParts {
@@ -19,6 +19,13 @@ export const ONEBOT_NOTICE_PARTS_MAP = {
19
19
  'friend.increase': { scene_type: 'friend', sub_type: 'increase' },
20
20
  'friend.decrease': { scene_type: 'friend', sub_type: 'recall' },
21
21
  'friend.recall': { scene_type: 'friend', sub_type: 'recall' },
22
+ // icqq: notice_type=group + sub_type(#996 状态感知补齐)
23
+ 'group.poke': { scene_type: 'group', sub_type: 'poke' },
24
+ 'group.reaction': { scene_type: 'group', sub_type: 'emoji_reaction' },
25
+ 'group.transfer': { scene_type: 'group', sub_type: 'transfer' },
26
+ 'group.card': { scene_type: 'group', sub_type: 'card_change' },
27
+ 'group.notice': { scene_type: 'group', sub_type: 'notice_updated' },
28
+ group_notice: { scene_type: 'group', sub_type: 'notice_updated' },
22
29
  };
23
30
  /** KOOK extra.type 原始值 → 标准 scene_type + sub_type */
24
31
  export const KOOK_NOTICE_PARTS_MAP = {
package/lib/types.d.ts CHANGED
@@ -78,6 +78,7 @@ export type MessageMiddleware = (message: Message, next: () => Promise<void>) =>
78
78
  */
79
79
  export type DefineConfig<T> = T | ((env: Record<string, string>) => MaybePromise<T>);
80
80
  export interface SendOptions extends MessageChannel {
81
+ locale?: import('@zhin.js/plugin-runtime').Locale;
81
82
  context: string;
82
83
  endpoint: string;
83
84
  content: SendContent;
@@ -247,6 +248,13 @@ export interface Tool<TArgs extends Record<string, any> = Record<string, any>> {
247
248
  permissions?: string[];
248
249
  /** Per-tool approval policy; `on-risk` remains fail-closed at Agent boundaries. */
249
250
  requiresApproval?: 'always' | 'once' | 'never' | 'on-risk' | 'human';
251
+ /**
252
+ * Hard-gate risk (ADR 0036): `dangerous` tools never run without a fresh human approval,
253
+ * independent of `requiresApproval` and `execApprovalMode`. The Host may only raise it.
254
+ */
255
+ risk?: 'dangerous' | 'safe';
256
+ /** Dangerous category: member / publish / funds (disabled by default) / identity. */
257
+ riskCategory?: 'member' | 'publish' | 'funds' | 'identity';
250
258
  /**
251
259
  * 支持的平台列表
252
260
  * 例如:['qq', 'telegram', 'discord']
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zhin.js/core",
3
- "version": "1.1.50",
3
+ "version": "1.1.51",
4
4
  "description": "Zhin机器人核心框架",
5
5
  "type": "module",
6
6
  "main": "./lib/index.js",
@@ -57,29 +57,29 @@
57
57
  "dependencies": {
58
58
  "qrcode": "^1.5.4",
59
59
  "segment-matcher": "^1.0.5",
60
- "@zhin.js/adapter": "1.1.22",
61
- "@zhin.js/command": "1.1.10",
62
- "@zhin.js/component": "1.1.9",
60
+ "@zhin.js/adapter": "1.1.23",
61
+ "@zhin.js/command": "1.1.11",
62
+ "@zhin.js/component": "1.1.10",
63
+ "@zhin.js/handler": "1.1.9",
64
+ "@zhin.js/im-contract": "1.1.7",
63
65
  "@zhin.js/database": "1.1.5",
64
- "@zhin.js/handler": "1.1.8",
65
66
  "@zhin.js/interaction": "1.1.2",
66
- "@zhin.js/im-contract": "1.1.6",
67
67
  "@zhin.js/kernel": "1.1.5",
68
68
  "@zhin.js/logger": "1.1.2",
69
- "@zhin.js/middleware": "1.1.9",
70
- "@zhin.js/permission": "1.1.8",
71
- "@zhin.js/plugin-runtime": "1.1.16",
72
- "@zhin.js/schedule-feature": "1.1.8",
73
- "@zhin.js/schema": "1.1.3",
74
- "@zhin.js/jsx": "1.1.5",
75
- "@zhin.js/feature-kit": "1.1.8"
69
+ "@zhin.js/middleware": "1.1.10",
70
+ "@zhin.js/plugin-runtime": "1.1.17",
71
+ "@zhin.js/permission": "1.1.9",
72
+ "@zhin.js/schedule-feature": "1.1.9",
73
+ "@zhin.js/schema": "1.1.4",
74
+ "@zhin.js/jsx": "1.1.6",
75
+ "@zhin.js/feature-kit": "1.1.9"
76
76
  },
77
77
  "devDependencies": {
78
78
  "@types/node": "^26.1.2",
79
79
  "@types/qrcode": "^1.5.6",
80
80
  "ajv": "8.18.0",
81
81
  "typescript": "^6.0.3",
82
- "@zhin.js/ai": "1.1.44"
82
+ "@zhin.js/ai": "1.1.46"
83
83
  },
84
84
  "repository": {
85
85
  "type": "git",