@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.
- package/README.md +78 -195
- package/lib/ai-completion-contract.d.ts +135 -0
- package/lib/ai-completion-contract.js +69 -0
- package/lib/built/ai-access.d.ts +2 -21
- package/lib/built/ai-access.js +1 -46
- package/lib/built/ai-outbound/index.d.ts +0 -2
- package/lib/built/ai-outbound/index.js +0 -2
- package/lib/built/ai-outbound/prompt.d.ts +2 -0
- package/lib/built/ai-outbound/prompt.js +2 -0
- package/lib/built/ai-outbound/types.d.ts +1 -10
- package/lib/built/ai-trigger.d.ts +39 -78
- package/lib/built/ai-trigger.js +3 -254
- package/lib/built/common-adapter-tools.d.ts +21 -6
- package/lib/built/common-adapter-tools.js +28 -17
- package/lib/built/generic-segment-mapper.js +4 -1
- package/lib/built/html-segment-fallback.d.ts +6 -7
- package/lib/built/html-segment-fallback.js +1 -16
- package/lib/built/html-to-text.d.ts +0 -3
- package/lib/built/html-to-text.js +131 -40
- package/lib/built/interaction-messages.d.ts +1 -0
- package/lib/built/interaction-messages.js +30 -0
- package/lib/built/interactive-segments/action.d.ts +3 -4
- package/lib/built/interactive-segments/action.js +2 -5
- package/lib/built/interactive-segments/index.d.ts +0 -2
- package/lib/built/interactive-segments/index.js +0 -2
- package/lib/built/interactive-segments/keyboard-segment.d.ts +0 -1
- package/lib/built/interactive-segments/keyboard-segment.js +0 -1
- package/lib/built/interactive-segments/onebot-keyboard.d.ts +0 -1
- package/lib/built/interactive-segments/onebot-keyboard.js +0 -2
- package/lib/built/interactive-segments/resolve.d.ts +2 -3
- package/lib/built/interactive-segments/resolve.js +21 -14
- package/lib/built/interactive-segments/types.d.ts +2 -7
- package/lib/built/interactive-segments/types.js +22 -2
- package/lib/built/login-assist.d.ts +330 -25
- package/lib/built/login-assist.js +1156 -75
- package/lib/built/login-captcha.d.ts +62 -0
- package/lib/built/login-captcha.js +107 -0
- package/lib/built/message-enrich.d.ts +24 -27
- package/lib/built/message-enrich.js +53 -49
- package/lib/built/outbound-content-arrays.d.ts +4 -0
- package/lib/built/outbound-content-arrays.js +32 -0
- package/lib/built/outbound-media-trust.d.ts +46 -0
- package/lib/built/outbound-media-trust.js +245 -0
- package/lib/built/outbound-media-utils.d.ts +5 -3
- package/lib/built/outbound-media-utils.js +5 -3
- package/lib/built/readable-link.d.ts +4 -0
- package/lib/built/readable-link.js +32 -0
- package/lib/built/rich-segments/markdown-to-text.d.ts +1 -2
- package/lib/built/rich-segments/markdown-to-text.js +141 -17
- package/lib/built/roles.d.ts +141 -12
- package/lib/built/roles.js +253 -52
- package/lib/built/segment-contract/assert.js +8 -2
- package/lib/built/segment-contract/delivery.js +1 -0
- package/lib/built/segment-contract/index.d.ts +3 -3
- package/lib/built/segment-contract/index.js +2 -2
- package/lib/built/segment-contract/json-schema.d.ts +39 -5
- package/lib/built/segment-contract/json-schema.js +207 -24
- package/lib/built/segment-contract/preview.js +8 -1
- package/lib/built/segment-contract/text.js +1 -1
- package/lib/built/segment-contract/types.d.ts +2 -2
- package/lib/built/segment-contract/validate.d.ts +1553 -224
- package/lib/built/segment-contract/validate.js +39 -3
- package/lib/built/tool-access.d.ts +5 -0
- package/lib/built/tool-access.js +17 -0
- package/lib/built/user-interaction.d.ts +5 -4
- package/lib/built/user-interaction.js +64 -52
- package/lib/errors.d.ts +1 -18
- package/lib/errors.js +1 -26
- package/lib/feature/command-public-api.d.ts +5 -0
- package/lib/feature/command-public-api.js +5 -0
- package/lib/feature/command.d.ts +2 -0
- package/lib/feature/command.js +1 -0
- package/lib/feature/component.d.ts +1 -0
- package/lib/feature/component.js +1 -0
- package/lib/feature/handler.d.ts +13 -7
- package/lib/feature/handler.js +2 -1
- package/lib/feature/middleware-public-api.d.ts +6 -0
- package/lib/feature/middleware-public-api.js +6 -0
- package/lib/feature/middleware.d.ts +22 -2
- package/lib/feature/middleware.js +7 -2
- package/lib/im-scene.d.ts +4 -3
- package/lib/im-scene.js +9 -9
- package/lib/im-session-id.d.ts +20 -12
- package/lib/im-session-id.js +8 -8
- package/lib/index.d.ts +20 -48
- package/lib/index.js +15 -41
- package/lib/jsx/intrinsic-elements.d.ts +83 -0
- package/lib/jsx/message-renderer.d.ts +13 -0
- package/lib/jsx/message-renderer.js +128 -0
- package/lib/jsx/message-tags.d.ts +133 -0
- package/lib/jsx/message-tags.js +50 -0
- package/lib/jsx-dev-runtime.d.ts +2 -2
- package/lib/jsx-dev-runtime.js +1 -2
- package/lib/jsx-runtime.d.ts +2 -12
- package/lib/jsx-runtime.js +1 -10
- package/lib/jsx.d.ts +6 -30
- package/lib/jsx.js +3 -93
- package/lib/message.d.ts +0 -40
- package/lib/message.js +1 -27
- package/lib/models/system-log.d.ts +0 -2
- package/lib/models/system-log.js +1 -8
- package/lib/models/user.d.ts +0 -2
- package/lib/models/user.js +1 -7
- package/lib/notice.d.ts +38 -33
- package/lib/notice.js +23 -7
- package/lib/plugin-runtime/im/command-feedback.d.ts +59 -0
- package/lib/plugin-runtime/im/command-feedback.js +148 -0
- package/lib/plugin-runtime/im/contracts.d.ts +217 -32
- package/lib/plugin-runtime/im/contracts.js +141 -23
- package/lib/plugin-runtime/im/conversation-runtime.d.ts +42 -0
- package/lib/plugin-runtime/im/conversation-runtime.js +451 -0
- package/lib/plugin-runtime/im/endpoint-runtime.d.ts +112 -0
- package/lib/plugin-runtime/im/endpoint-runtime.js +434 -0
- package/lib/plugin-runtime/im/feature-gate.d.ts +21 -0
- package/lib/plugin-runtime/im/feature-gate.js +88 -0
- package/lib/plugin-runtime/im/host/component-host-installer.d.ts +2 -0
- package/lib/plugin-runtime/im/host/component-host-installer.js +14 -0
- package/lib/plugin-runtime/im/host/conversation-migration.d.ts +5 -0
- package/lib/plugin-runtime/im/host/conversation-migration.js +75 -0
- package/lib/plugin-runtime/im/host/database-config.d.ts +10 -0
- package/lib/plugin-runtime/im/host/database-config.js +152 -0
- package/lib/plugin-runtime/im/host/database-console-schema.d.ts +79 -0
- package/lib/plugin-runtime/im/host/database-console-schema.js +477 -0
- package/lib/plugin-runtime/im/host/database-console-sql.d.ts +66 -0
- package/lib/plugin-runtime/im/host/database-console-sql.js +459 -0
- package/lib/plugin-runtime/im/host/database-host-installer.d.ts +60 -0
- package/lib/plugin-runtime/im/host/database-host-installer.js +1166 -0
- package/lib/plugin-runtime/im/host/database-state.d.ts +9 -0
- package/lib/plugin-runtime/im/host/database-state.js +91 -0
- package/lib/plugin-runtime/im/host/index.d.ts +8 -0
- package/lib/plugin-runtime/im/host/index.js +8 -0
- package/lib/plugin-runtime/im/host/locale-host-installer.d.ts +3 -0
- package/lib/plugin-runtime/im/host/locale-host-installer.js +60 -0
- package/lib/plugin-runtime/im/host/outbound-host-installer.d.ts +8 -0
- package/lib/plugin-runtime/im/host/outbound-host-installer.js +153 -0
- package/lib/plugin-runtime/im/host/sender-enrichment.d.ts +34 -0
- package/lib/plugin-runtime/im/host/sender-enrichment.js +82 -0
- package/lib/plugin-runtime/im/im-runtime.d.ts +40 -111
- package/lib/plugin-runtime/im/im-runtime.js +235 -1059
- package/lib/plugin-runtime/im/inbound-dedup.d.ts +84 -0
- package/lib/plugin-runtime/im/inbound-dedup.js +322 -0
- package/lib/plugin-runtime/im/inbound-origin.d.ts +150 -0
- package/lib/plugin-runtime/im/inbound-origin.js +183 -0
- package/lib/plugin-runtime/im/inbound-runtime.d.ts +59 -0
- package/lib/plugin-runtime/im/inbound-runtime.js +478 -0
- package/lib/plugin-runtime/im/inbound-spine.d.ts +196 -0
- package/lib/plugin-runtime/im/inbound-spine.js +335 -0
- package/lib/plugin-runtime/im/index.d.ts +15 -4
- package/lib/plugin-runtime/im/index.js +11 -4
- package/lib/plugin-runtime/im/interaction-runtime.d.ts +50 -0
- package/lib/plugin-runtime/im/interaction-runtime.js +390 -0
- package/lib/plugin-runtime/im/interactive-router.d.ts +81 -0
- package/lib/plugin-runtime/im/interactive-router.js +382 -0
- package/lib/plugin-runtime/im/message-diagnostics.d.ts +70 -0
- package/lib/plugin-runtime/im/message-diagnostics.js +182 -0
- package/lib/plugin-runtime/im/message-dispatcher.d.ts +18 -4
- package/lib/plugin-runtime/im/message-dispatcher.js +138 -20
- package/lib/plugin-runtime/im/message-events.d.ts +85 -0
- package/lib/plugin-runtime/im/message-events.js +113 -0
- package/lib/plugin-runtime/im/outbound-delivery-runtime.d.ts +39 -0
- package/lib/plugin-runtime/im/outbound-delivery-runtime.js +450 -0
- package/lib/plugin-runtime/im/outbound-renderer.d.ts +52 -3
- package/lib/plugin-runtime/im/outbound-renderer.js +188 -8
- package/lib/plugin-runtime/im/outbound-segments.d.ts +29 -5
- package/lib/plugin-runtime/im/outbound-segments.js +130 -36
- package/lib/plugin-runtime/im/progressive-reply.d.ts +58 -0
- package/lib/plugin-runtime/im/progressive-reply.js +501 -0
- package/lib/plugin-runtime/im/public-api.d.ts +1 -1
- package/lib/request.d.ts +27 -36
- package/lib/request.js +14 -6
- package/lib/side-event/base.d.ts +64 -44
- package/lib/side-event/base.js +72 -19
- package/lib/side-event/index.d.ts +1 -1
- package/lib/side-event/index.js +1 -1
- package/lib/side-event/normalize.d.ts +7 -38
- package/lib/side-event/normalize.js +4 -109
- package/lib/side-event/scene-events.d.ts +40 -0
- package/lib/side-event/scene-events.js +147 -0
- package/lib/side-event/types.d.ts +4 -13
- package/lib/side-event/types.js +1 -55
- package/lib/system-event.d.ts +17 -12
- package/lib/system-event.js +8 -6
- package/lib/types.d.ts +23 -167
- package/lib/utils.d.ts +50 -33
- package/lib/utils.js +12 -185
- package/lib/venue/contracts.d.ts +21 -0
- package/lib/venue/contracts.js +3 -0
- package/lib/venue/floor-controller.d.ts +11 -0
- package/lib/venue/floor-controller.js +63 -0
- package/lib/venue/index.d.ts +13 -0
- package/lib/venue/index.js +11 -0
- package/lib/venue/membership-port.d.ts +23 -0
- package/lib/venue/membership-port.js +141 -0
- package/lib/venue/projector.d.ts +38 -0
- package/lib/venue/projector.js +45 -0
- package/lib/venue/registry.d.ts +16 -0
- package/lib/venue/registry.js +63 -0
- package/lib/venue/router.d.ts +19 -0
- package/lib/venue/router.js +101 -0
- package/lib/venue/send-limiter.d.ts +17 -0
- package/lib/venue/send-limiter.js +73 -0
- package/lib/venue/validator.d.ts +6 -0
- package/lib/venue/validator.js +160 -0
- package/package.json +24 -50
- package/lib/adapter.d.ts +0 -145
- package/lib/adapter.js +0 -377
- package/lib/built/adapter-process.d.ts +0 -58
- package/lib/built/adapter-process.js +0 -128
- package/lib/built/agent-preset.d.ts +0 -64
- package/lib/built/agent-preset.js +0 -79
- package/lib/built/ai-outbound/adapter-access.d.ts +0 -3
- package/lib/built/ai-outbound/adapter-access.js +0 -9
- package/lib/built/ai-outbound/extensions/qq-message.d.ts +0 -3
- package/lib/built/ai-outbound/extensions/qq-message.js +0 -23
- package/lib/built/authorization.d.ts +0 -10
- package/lib/built/authorization.js +0 -76
- package/lib/built/command.d.ts +0 -72
- package/lib/built/command.js +0 -105
- package/lib/built/component.d.ts +0 -67
- package/lib/built/component.js +0 -97
- package/lib/built/config.d.ts +0 -98
- package/lib/built/config.js +0 -372
- package/lib/built/connect-endpoint-instance.d.ts +0 -17
- package/lib/built/connect-endpoint-instance.js +0 -42
- package/lib/built/database.d.ts +0 -68
- package/lib/built/database.js +0 -106
- package/lib/built/dispatcher.d.ts +0 -141
- package/lib/built/dispatcher.js +0 -383
- package/lib/built/endpoint-commands.d.ts +0 -3
- package/lib/built/endpoint-commands.js +0 -99
- package/lib/built/endpoint-lifecycle-service.d.ts +0 -28
- package/lib/built/endpoint-lifecycle-service.js +0 -242
- package/lib/built/endpoint-lifecycle.d.ts +0 -27
- package/lib/built/endpoint-lifecycle.js +0 -36
- package/lib/built/endpoint-manager.d.ts +0 -34
- package/lib/built/html-renderer-loader.d.ts +0 -13
- package/lib/built/html-renderer-loader.js +0 -33
- package/lib/built/inbound-pipeline.d.ts +0 -37
- package/lib/built/inbound-pipeline.js +0 -63
- package/lib/built/inbound-runner.d.ts +0 -22
- package/lib/built/inbound-runner.js +0 -34
- package/lib/built/interactive-segment-contract.d.ts +0 -6
- package/lib/built/interactive-segment-contract.js +0 -9
- package/lib/built/interactive-segments/fallback-store.d.ts +0 -29
- package/lib/built/interactive-segments/fallback-store.js +0 -63
- package/lib/built/interactive-segments/handlers.d.ts +0 -16
- package/lib/built/interactive-segments/handlers.js +0 -74
- package/lib/built/introspection-format.d.ts +0 -10
- package/lib/built/introspection-format.js +0 -28
- package/lib/built/management-command-guard.d.ts +0 -15
- package/lib/built/management-command-guard.js +0 -25
- package/lib/built/message-filter.d.ts +0 -176
- package/lib/built/message-filter.js +0 -239
- package/lib/built/optional-peer-import.d.ts +0 -3
- package/lib/built/optional-peer-import.js +0 -33
- package/lib/built/outbound-media-contract.d.ts +0 -22
- package/lib/built/outbound-media-contract.js +0 -10
- package/lib/built/permission.d.ts +0 -51
- package/lib/built/permission.js +0 -99
- package/lib/built/permit-check.d.ts +0 -7
- package/lib/built/permit-check.js +0 -35
- package/lib/built/permit-parse.d.ts +0 -16
- package/lib/built/permit-parse.js +0 -32
- package/lib/built/platform-permit.d.ts +0 -20
- package/lib/built/platform-permit.js +0 -91
- package/lib/built/queue-im-field-contract.d.ts +0 -32
- package/lib/built/queue-im-field-contract.js +0 -67
- package/lib/built/rich-segments/adapter-policies.d.ts +0 -9
- package/lib/built/rich-segments/adapter-policies.js +0 -27
- package/lib/built/rich-segments/base.d.ts +0 -11
- package/lib/built/rich-segments/base.js +0 -24
- package/lib/built/rich-segments/builtins.d.ts +0 -4
- package/lib/built/rich-segments/builtins.js +0 -40
- package/lib/built/rich-segments/capabilities.d.ts +0 -6
- package/lib/built/rich-segments/capabilities.js +0 -38
- package/lib/built/rich-segments/html-segment.d.ts +0 -15
- package/lib/built/rich-segments/html-segment.js +0 -62
- package/lib/built/rich-segments/index.d.ts +0 -13
- package/lib/built/rich-segments/index.js +0 -13
- package/lib/built/rich-segments/markdown-segment.d.ts +0 -14
- package/lib/built/rich-segments/markdown-segment.js +0 -58
- package/lib/built/rich-segments/qrcode-segment.d.ts +0 -18
- package/lib/built/rich-segments/qrcode-segment.js +0 -73
- package/lib/built/rich-segments/registry.d.ts +0 -16
- package/lib/built/rich-segments/registry.js +0 -52
- package/lib/built/rich-segments/resolve.d.ts +0 -5
- package/lib/built/rich-segments/resolve.js +0 -87
- package/lib/built/rich-segments/tts-segment.d.ts +0 -13
- package/lib/built/rich-segments/tts-segment.js +0 -51
- package/lib/built/rich-segments/types.d.ts +0 -79
- package/lib/built/rich-segments/types.js +0 -17
- package/lib/built/runtime-io.d.ts +0 -9
- package/lib/built/runtime-io.js +0 -67
- package/lib/built/schedule.d.ts +0 -54
- package/lib/built/schedule.js +0 -112
- package/lib/built/schema-endpoint-manager.d.ts +0 -17
- package/lib/built/schema-endpoint-manager.js +0 -73
- package/lib/built/schema-feature.d.ts +0 -77
- package/lib/built/schema-feature.js +0 -130
- package/lib/built/skill.d.ts +0 -120
- package/lib/built/skill.js +0 -151
- package/lib/built/speech-loader.d.ts +0 -14
- package/lib/built/speech-loader.js +0 -32
- package/lib/built/tool.d.ts +0 -151
- package/lib/built/tool.js +0 -388
- package/lib/command.d.ts +0 -50
- package/lib/command.js +0 -106
- package/lib/component.d.ts +0 -26
- package/lib/component.js +0 -583
- package/lib/endpoint-capabilities.d.ts +0 -46
- package/lib/endpoint-capabilities.js +0 -55
- package/lib/endpoint.d.ts +0 -19
- package/lib/endpoint.js +0 -3
- package/lib/host-plugin-registry.d.ts +0 -8
- package/lib/host-plugin-registry.js +0 -12
- package/lib/plugin-context.d.ts +0 -27
- package/lib/plugin-context.js +0 -64
- package/lib/plugin-runtime/im/interactive.d.ts +0 -26
- package/lib/plugin-runtime/im/interactive.js +0 -46
- package/lib/plugin-runtime/im/login-assist-host.d.ts +0 -6
- package/lib/plugin-runtime/im/login-assist-host.js +0 -6
- package/lib/plugin-runtime/im/message-bus.d.ts +0 -38
- package/lib/plugin-runtime/im/message-bus.js +0 -40
- package/lib/plugin-runtime/im/service-tokens.d.ts +0 -18
- package/lib/plugin-runtime/im/service-tokens.js +0 -13
- package/lib/plugin.d.ts +0 -268
- package/lib/plugin.js +0 -583
- package/lib/schema-interaction.d.ts +0 -117
- package/lib/schema-interaction.js +0 -247
- package/lib/side-event/dispatch.d.ts +0 -15
- package/lib/side-event/dispatch.js +0 -140
- package/lib/tool-zod.d.ts +0 -43
- package/lib/tool-zod.js +0 -184
- /package/lib/{built/endpoint-manager.js → jsx/intrinsic-elements.js} +0 -0
|
@@ -0,0 +1,183 @@
|
|
|
1
|
+
import { createHash } from 'node:crypto';
|
|
2
|
+
import { createToken } from '@zhin.js/plugin-runtime';
|
|
3
|
+
import { getLogger } from '@zhin.js/logger';
|
|
4
|
+
import { segmentsToPlainText } from '../../built/segment-contract/text.js';
|
|
5
|
+
const MAX_ENTRIES = 2000;
|
|
6
|
+
const TTL_MS = 10 * 60_000;
|
|
7
|
+
const DIGEST_WINDOW_MS = 30_000;
|
|
8
|
+
const MIN_DIGEST_TEXT = 4;
|
|
9
|
+
/**
|
|
10
|
+
* scope 键不含 endpoint id:同一个群里不同 Bot 的 conversationRefKey 不同,
|
|
11
|
+
* 但它们互相的回显仍属同一会话。
|
|
12
|
+
*/
|
|
13
|
+
export function ledgerScopeOf(conversation) {
|
|
14
|
+
return [
|
|
15
|
+
conversation.endpoint.adapter,
|
|
16
|
+
conversation.kind,
|
|
17
|
+
conversation.id,
|
|
18
|
+
conversation.parent?.kind ?? '',
|
|
19
|
+
conversation.parent?.id ?? '',
|
|
20
|
+
conversation.threadId ?? '',
|
|
21
|
+
].join('\0');
|
|
22
|
+
}
|
|
23
|
+
export function digestText(text) {
|
|
24
|
+
const normalized = text.replace(/\s+/g, ' ').trim();
|
|
25
|
+
if (normalized.length < MIN_DIGEST_TEXT)
|
|
26
|
+
return undefined;
|
|
27
|
+
return createHash('sha256').update(normalized).digest('hex').slice(0, 16);
|
|
28
|
+
}
|
|
29
|
+
function payloadText(payload) {
|
|
30
|
+
if (typeof payload === 'string')
|
|
31
|
+
return payload;
|
|
32
|
+
if (Array.isArray(payload)) {
|
|
33
|
+
return segmentsToPlainText(payload.filter((item) => !!item && typeof item === 'object' && typeof item.type === 'string'));
|
|
34
|
+
}
|
|
35
|
+
return '';
|
|
36
|
+
}
|
|
37
|
+
export class OutboundLedger {
|
|
38
|
+
now;
|
|
39
|
+
#entries = [];
|
|
40
|
+
constructor(now = Date.now) {
|
|
41
|
+
this.now = now;
|
|
42
|
+
}
|
|
43
|
+
get size() {
|
|
44
|
+
return this.#entries.length;
|
|
45
|
+
}
|
|
46
|
+
/** 仅在 `receipt.status === 'sent'` 时记录;`payload` 应为最终投影后的 payload。 */
|
|
47
|
+
record(conversation, receipt, payload) {
|
|
48
|
+
if (receipt.status !== 'sent')
|
|
49
|
+
return;
|
|
50
|
+
const at = this.now();
|
|
51
|
+
this.#prune(at);
|
|
52
|
+
const rawId = receipt.message?.id;
|
|
53
|
+
const messageId = rawId === undefined || rawId === null || String(rawId) === '' ? undefined : String(rawId);
|
|
54
|
+
const digest = digestText(payloadText(payload));
|
|
55
|
+
if (messageId === undefined && digest === undefined)
|
|
56
|
+
return;
|
|
57
|
+
this.#entries.push({
|
|
58
|
+
scope: ledgerScopeOf(conversation),
|
|
59
|
+
endpointId: conversation.endpoint.id,
|
|
60
|
+
...(messageId !== undefined ? { messageId } : {}),
|
|
61
|
+
...(digest !== undefined ? { digest } : {}),
|
|
62
|
+
at,
|
|
63
|
+
digestConsumed: false,
|
|
64
|
+
});
|
|
65
|
+
while (this.#entries.length > MAX_ENTRIES)
|
|
66
|
+
this.#entries.shift();
|
|
67
|
+
}
|
|
68
|
+
matchById(scope, messageId) {
|
|
69
|
+
if (typeof messageId !== 'string' && typeof messageId !== 'number')
|
|
70
|
+
return undefined;
|
|
71
|
+
const id = String(messageId);
|
|
72
|
+
if (id === '')
|
|
73
|
+
return undefined;
|
|
74
|
+
const at = this.now();
|
|
75
|
+
for (let i = this.#entries.length - 1; i >= 0; i--) {
|
|
76
|
+
const entry = this.#entries[i];
|
|
77
|
+
if (at - entry.at > TTL_MS)
|
|
78
|
+
continue;
|
|
79
|
+
if (entry.scope === scope && entry.messageId === id)
|
|
80
|
+
return { endpointId: entry.endpointId };
|
|
81
|
+
}
|
|
82
|
+
return undefined;
|
|
83
|
+
}
|
|
84
|
+
/**
|
|
85
|
+
* 摘要兜底(“账号 id 对不上”时):30 秒窗口、一次性。
|
|
86
|
+
* 权衡:人类在窗口内原样复读 Bot 刚发的文本,会被当作回显丢弃一次。
|
|
87
|
+
*/
|
|
88
|
+
matchByDigest(scope, text, now = this.now()) {
|
|
89
|
+
const digest = digestText(typeof text === 'string' ? text : '');
|
|
90
|
+
if (digest === undefined)
|
|
91
|
+
return undefined;
|
|
92
|
+
for (let i = this.#entries.length - 1; i >= 0; i--) {
|
|
93
|
+
const entry = this.#entries[i];
|
|
94
|
+
if (now - entry.at > DIGEST_WINDOW_MS)
|
|
95
|
+
continue;
|
|
96
|
+
if (entry.digestConsumed || entry.scope !== scope || entry.digest !== digest)
|
|
97
|
+
continue;
|
|
98
|
+
entry.digestConsumed = true;
|
|
99
|
+
return { endpointId: entry.endpointId };
|
|
100
|
+
}
|
|
101
|
+
return undefined;
|
|
102
|
+
}
|
|
103
|
+
#prune(at) {
|
|
104
|
+
let drop = 0;
|
|
105
|
+
while (drop < this.#entries.length && at - this.#entries[drop].at > TTL_MS)
|
|
106
|
+
drop++;
|
|
107
|
+
if (drop > 0)
|
|
108
|
+
this.#entries.splice(0, drop);
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
const logger = getLogger('im.inbound.origin');
|
|
112
|
+
/** @internal */
|
|
113
|
+
export const MESSAGE_ORIGINS = Object.freeze(['self', 'member', 'peer_bot', 'human']);
|
|
114
|
+
export function isMessageOrigin(value) {
|
|
115
|
+
return typeof value === 'string' && MESSAGE_ORIGINS.includes(value);
|
|
116
|
+
}
|
|
117
|
+
export const roomMembershipToken = createToken('zhin.im.room-membership');
|
|
118
|
+
/** @internal */
|
|
119
|
+
export function createInboundOriginClassifier(options) {
|
|
120
|
+
const { registry, ledger } = options;
|
|
121
|
+
return {
|
|
122
|
+
classify(input, membership) {
|
|
123
|
+
let ready = false;
|
|
124
|
+
try {
|
|
125
|
+
const { conversation } = input;
|
|
126
|
+
const endpointId = conversation.endpoint.id;
|
|
127
|
+
const adapter = conversation.endpoint.adapter;
|
|
128
|
+
ready = registry.isReady(endpointId);
|
|
129
|
+
const scope = ledgerScopeOf(conversation);
|
|
130
|
+
const rawSender = input.sender?.id;
|
|
131
|
+
const senderId = typeof rawSender === 'string' || typeof rawSender === 'number'
|
|
132
|
+
? String(rawSender).trim()
|
|
133
|
+
: '';
|
|
134
|
+
const mapForeign = (foreignEndpointId, basis) => {
|
|
135
|
+
if (foreignEndpointId === endpointId)
|
|
136
|
+
return { origin: 'self', basis, ready };
|
|
137
|
+
const peer = senderId === '' ? undefined : registry.lookup(adapter, senderId);
|
|
138
|
+
const isMember = membership?.isMember({ adapter, userId: senderId, endpointIds: peer?.endpointIds ?? [foreignEndpointId] }, conversation) === true;
|
|
139
|
+
return { origin: isMember ? 'member' : 'peer_bot', basis, ready };
|
|
140
|
+
};
|
|
141
|
+
const byId = ledger.matchById(scope, input.messageId);
|
|
142
|
+
if (byId)
|
|
143
|
+
return mapForeign(byId.endpointId, 'ledger');
|
|
144
|
+
if (senderId === '')
|
|
145
|
+
return { origin: 'human', basis: 'none', ready };
|
|
146
|
+
if (registry.selfOf(endpointId) === senderId)
|
|
147
|
+
return { origin: 'self', basis: 'registry', ready };
|
|
148
|
+
const peer = registry.lookup(adapter, senderId);
|
|
149
|
+
if (peer) {
|
|
150
|
+
const isMember = membership?.isMember({ adapter: peer.adapter, userId: peer.userId, endpointIds: peer.endpointIds }, conversation) === true;
|
|
151
|
+
return { origin: isMember ? 'member' : 'peer_bot', basis: 'registry', ready };
|
|
152
|
+
}
|
|
153
|
+
// Digest fallback: group/channel only, and only while the endpoint's account is unknown.
|
|
154
|
+
// Reaching here means the sender is not self and not in the Registry; if the endpoint is
|
|
155
|
+
// ready with a known account, the sender is a known human, so skip (and keep the one-shot
|
|
156
|
+
// digest unconsumed). A digest hit is at worst record-only and never maps to `self`.
|
|
157
|
+
// Private conversations are excluded on purpose, even when this Endpoint is not ready
|
|
158
|
+
// (selfUserId unknown): a private echo of our own message is classified `human`
|
|
159
|
+
// (basis 'none', ready=false) instead of digest-matched. Trade-off: a private chat has one
|
|
160
|
+
// counterpart and no peer bots, so guessing by digest would risk tagging a real user who
|
|
161
|
+
// repeats bot text as peer_bot; the echo is only suppressed once the account or ledger id is known.
|
|
162
|
+
const digestEligible = (conversation.kind === 'group' || conversation.kind === 'channel')
|
|
163
|
+
&& !(ready && registry.selfOf(endpointId) !== undefined);
|
|
164
|
+
if (digestEligible && typeof input.content === 'string') {
|
|
165
|
+
const byDigest = ledger.matchByDigest(scope, input.content);
|
|
166
|
+
if (byDigest) {
|
|
167
|
+
const isMember = membership?.isMember({ adapter, userId: senderId, endpointIds: [byDigest.endpointId] }, conversation) === true;
|
|
168
|
+
return { origin: isMember ? 'member' : 'peer_bot', basis: 'ledger', ready };
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
return { origin: 'human', basis: 'none', ready };
|
|
172
|
+
}
|
|
173
|
+
catch (error) {
|
|
174
|
+
// Fail closed: undecidable is neither human nor self/member; record only.
|
|
175
|
+
try {
|
|
176
|
+
logger.warn(`origin classification failed: ${error instanceof Error ? error.message : String(error)}`);
|
|
177
|
+
}
|
|
178
|
+
catch { /* logging must not throw */ }
|
|
179
|
+
return { origin: 'peer_bot', basis: 'error', ready };
|
|
180
|
+
}
|
|
181
|
+
},
|
|
182
|
+
};
|
|
183
|
+
}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import type { EndpointEvent, PeerRegistry } from '@zhin.js/adapter';
|
|
2
|
+
import type { CommandExecutionBudget, CommandOperationController } from '@zhin.js/command/internal/execution';
|
|
3
|
+
import type { OperationResourceView } from '@zhin.js/feature-kit';
|
|
4
|
+
import { type DeliveryReceipt, type UserInteraction } from '@zhin.js/im-contract';
|
|
5
|
+
import type { GenerationAdmissionGate, PluginId, RuntimeSnapshot, SnapshotLease } from '@zhin.js/plugin-runtime';
|
|
6
|
+
import type { Notice } from '../../notice.js';
|
|
7
|
+
import type { Request } from '../../request.js';
|
|
8
|
+
import { RuntimeMessage, type CaptureEndpointOperationInput, type CapturedEndpointOperation, type IncomingMessage, type Message, type MessageSenderRef, type SendRequest } from './contracts.js';
|
|
9
|
+
import type { InboundDeduper } from './inbound-dedup.js';
|
|
10
|
+
import type { InboundOriginClassifier } from './inbound-origin.js';
|
|
11
|
+
import { type InboundInteractionPort } from './inbound-spine.js';
|
|
12
|
+
import type { RuntimeMessageDiagnostics } from './message-diagnostics.js';
|
|
13
|
+
import { type RuntimeMessageEvent } from './message-events.js';
|
|
14
|
+
interface InboundRuntimeContext {
|
|
15
|
+
readonly commandExecution?: CommandExecutionBudget;
|
|
16
|
+
runCommandOperation?<T>(controller: CommandOperationController, operation: () => T): T;
|
|
17
|
+
readonly diagnostics?: RuntimeMessageDiagnostics;
|
|
18
|
+
readonly interactions: InboundInteractionPort;
|
|
19
|
+
captureOperation(input: CaptureEndpointOperationInput): CapturedEndpointOperation;
|
|
20
|
+
createOperationResources?(input: Readonly<{
|
|
21
|
+
lease: SnapshotLease;
|
|
22
|
+
message: RuntimeMessage;
|
|
23
|
+
owner: PluginId;
|
|
24
|
+
signal: AbortSignal;
|
|
25
|
+
}>): OperationResourceView | undefined;
|
|
26
|
+
readonly inboundClaim?: (message: Message) => boolean | Promise<boolean>;
|
|
27
|
+
/** Trusted origin classifier. Absent: messages carry no origin (legacy behavior). */
|
|
28
|
+
readonly originClassifier?: InboundOriginClassifier;
|
|
29
|
+
/** Cross-Endpoint dedup of human group messages. Absent: no dedup. */
|
|
30
|
+
readonly deduper?: Pick<InboundDeduper, 'claim'> & Partial<Pick<InboundDeduper, 'arbitrate'>>;
|
|
31
|
+
/** Registry probes handed to the Room Router (account / availability). */
|
|
32
|
+
readonly registry?: Pick<PeerRegistry, 'isReady' | 'selfOf'>;
|
|
33
|
+
/** Process-level prompt probe (`inboundClaim`-style). Absent: false. */
|
|
34
|
+
readonly inboundClaimPending?: (conversation: IncomingMessage['conversation'], senderId: string) => boolean;
|
|
35
|
+
/** Resolve a replied-to message id to the local Endpoint that sent it (outbound ledger). */
|
|
36
|
+
readonly resolveReplyTarget?: (conversation: IncomingMessage['conversation'], messageId: string) => string | undefined;
|
|
37
|
+
readonly enrichSender?: (sender: MessageSenderRef | undefined, conversation: IncomingMessage['conversation'], snapshot: RuntimeSnapshot) => MessageSenderRef | undefined;
|
|
38
|
+
acquire(): SnapshotLease;
|
|
39
|
+
release(lease: SnapshotLease): void;
|
|
40
|
+
deliver(request: SendRequest, snapshot: RuntimeSnapshot): Promise<DeliveryReceipt>;
|
|
41
|
+
recordIncoming(input: IncomingMessage, sender: MessageSenderRef | undefined): Promise<number | undefined>;
|
|
42
|
+
recordNotice(notice: Notice): Promise<unknown>;
|
|
43
|
+
/** #996: join requests into a group/channel are conversation facts too. */
|
|
44
|
+
recordRequest?(request: Request): Promise<unknown>;
|
|
45
|
+
/** Keep a message that answered an interaction prompt out of later agent context. */
|
|
46
|
+
markInteractionAnswer?(message: NonNullable<IncomingMessage['message']>): void;
|
|
47
|
+
publish(event: RuntimeMessageEvent): void;
|
|
48
|
+
}
|
|
49
|
+
/** Owns Endpoint ingress normalization, routing, dispatch, and side-event action scopes. */
|
|
50
|
+
export declare class InboundRuntime {
|
|
51
|
+
#private;
|
|
52
|
+
private readonly context;
|
|
53
|
+
constructor(context: InboundRuntimeContext, commandPrefix?: string);
|
|
54
|
+
createInteraction(message: Message, bind?: {
|
|
55
|
+
readonly subjectId: string;
|
|
56
|
+
}): UserInteraction | undefined;
|
|
57
|
+
receive(event: EndpointEvent, admission?: GenerationAdmissionGate): Promise<unknown>;
|
|
58
|
+
}
|
|
59
|
+
export {};
|