@zhin.js/core 1.5.11 → 1.5.13

package/lib/plugin-runtime/im/index.d.ts

@@ -1,8 +1,10 @@
 export * from './contracts.js';
 export * from './im-runtime.js';
 export * from './interactive.js';
+export * from './login-assist-host.js';
 export * from './message-bus.js';
 export * from './message-dispatcher.js';
 export * from './outbound-renderer.js';
 export * from './outbound-segments.js';
 export * from './service-tokens.js';
+export * from './side-event-gateway.js';

package/lib/plugin-runtime/im/index.js

@@ -1,8 +1,10 @@
 export * from './contracts.js';
 export * from './im-runtime.js';
 export * from './interactive.js';
+export * from './login-assist-host.js';
 export * from './message-bus.js';
 export * from './message-dispatcher.js';
 export * from './outbound-renderer.js';
 export * from './outbound-segments.js';
 export * from './service-tokens.js';
+export * from './side-event-gateway.js';

package/lib/plugin-runtime/im/login-assist-host.d.ts

@@ -0,0 +1,6 @@
+import { LoginAssist } from '../../built/login-assist.js';
+/**
+ * Plugin Runtime login-assist port（与 messageGatewayToken / sideEventGatewayToken 并列）。
+ * 适配器 waitForInput；Console / stdin 经 listPending + submit 消费。
+ */
+export declare const loginAssistToken: import("@zhin.js/plugin-runtime").Token<LoginAssist>;

package/lib/plugin-runtime/im/login-assist-host.js

@@ -0,0 +1,6 @@
+import { createToken } from '@zhin.js/plugin-runtime';
+/**
+ * Plugin Runtime login-assist port（与 messageGatewayToken / sideEventGatewayToken 并列）。
+ * 适配器 waitForInput；Console / stdin 经 listPending + submit 消费。
+ */
+export const loginAssistToken = createToken('zhin.im.login-assist');

package/lib/plugin-runtime/im/message-dispatcher.d.ts

@@ -1,4 +1,4 @@
-import { type CommandPromptFactory } from '@zhin.js/command';
+import type { UserInteractionFactory } from '@zhin.js/interaction';
 import type { RuntimeSnapshot } from '@zhin.js/plugin-runtime';
 import type { Message, MessageDispatchResult } from './contracts.js';
 /**
@@ -14,5 +14,5 @@ export declare const defaultCommandPrefixResolver: CommandPrefixResolver;
 export declare class MessageDispatcher {
     private readonly resolvePrefix;
     constructor(resolvePrefix?: CommandPrefixResolver);
-    dispatch(message: Message, snapshot: RuntimeSnapshot, promptFactory?: CommandPromptFactory): Promise<MessageDispatchResult>;
+    dispatch(message: Message, snapshot: RuntimeSnapshot, interactionFactory?: UserInteractionFactory): Promise<MessageDispatchResult>;
 }

package/lib/plugin-runtime/im/message-dispatcher.js

@@ -26,7 +26,7 @@ export class MessageDispatcher {
     constructor(resolvePrefix = defaultCommandPrefixResolver) {
         this.resolvePrefix = resolvePrefix;
     }
-    async dispatch(message, snapshot, promptFactory) {
+    async dispatch(message, snapshot, interactionFactory) {
         const prefix = this.resolvePrefix(message, snapshot);
         let input = message.content.trim();
         if (prefix && !input.startsWith(prefix)) {
@@ -43,7 +43,7 @@ export class MessageDispatcher {
             ? stripCommandPrefix(message.segments, prefix)
             : undefined;
         const matchInput = structuredInput ?? input;
-        const result = await commands.dispatch(matchInput, message, promptFactory, prefix);
+        const result = await commands.dispatch(matchInput, message, interactionFactory, prefix);
         if (result.matched && result.value !== undefined) {
             if (!result.owner)
                 throw new Error('Matched Command is missing its owner');

package/lib/plugin-runtime/im/outbound-segments.d.ts

@@ -35,6 +35,7 @@ export type OutboundMediaPolicy = 'base64' | 'url-or-text' | 'passthrough';
 export interface OutboundSegmentsPolicy {
     readonly outboundMedia: readonly ('url' | 'path' | 'base64' | 'upload')[];
     readonly interactive?: InteractivePolicy;
+    readonly markdown?: 'native' | 'text';
 }
 export interface NormalizeOutboundOptions {
     /** 缺省 `url-or-text`（未声明 adapter 的保守兜底：仅 URL 媒体可达）。 */
@@ -52,6 +53,9 @@ export declare function isOutboundSegment(value: unknown): value is OutboundSegm
  * `segments.interactive`，否则按平台名查内置表，未知平台回退 'text'。
  */
 export declare function resolveOutboundInteractivePolicy(adapter: CapabilityId, snapshot: RuntimeSnapshot): InteractivePolicy;
+/** Preserve semantic Markdown only when the endpoint explicitly declares native consumption. */
+export declare function resolveOutboundMarkdownPolicy(adapter: CapabilityId, snapshot: RuntimeSnapshot): 'native' | 'text';
+export declare function applyOutboundMarkdownPolicy(payload: unknown, policy: 'native' | 'text'): unknown;
 /**
  * keyboard 段中央降级：'text' 端点把 keyboard 渲染为编号文本（复用旧轨
  * `renderKeyboardAsText`），并把有效 fallback 映射经 `remember` 回调写入

package/lib/plugin-runtime/im/outbound-segments.js

@@ -3,6 +3,7 @@ import { toCanonicalSegments } from '../../built/generic-segment-mapper.js';
 import { effectiveKeyboardFallbackMap, renderKeyboardAsText, } from '../../built/interactive-segments/resolve.js';
 import { DEFAULT_INTERACTIVE_POLICY, isKeyboardSegment, } from '../../built/interactive-segments/types.js';
 import { isMediaRef } from '../../built/segment-contract/index.js';
+import { markdownToPlainText } from '../../built/rich-segments/markdown-to-text.js';
 const DEFAULT_CARD_WIDTH = 540;
 const DEFAULT_CARD_FILENAME = 'card.png';
 const DEFAULT_MEDIA_POLICY = 'url-or-text';
@@ -63,6 +64,31 @@ export function resolveOutboundInteractivePolicy(adapter, snapshot) {
     return (adapterType ? OUTBOUND_INTERACTIVE_POLICY_BY_ADAPTER[adapterType] : undefined)
         ?? DEFAULT_INTERACTIVE_POLICY;
 }
+/** Preserve semantic Markdown only when the endpoint explicitly declares native consumption. */
+export function resolveOutboundMarkdownPolicy(adapter, snapshot) {
+    const slot = snapshot.capabilities.get(adapter)
+        ?? snapshot.capabilities.get(baseSlotCapabilityId(adapter));
+    if (!slot?.definition || typeof slot.definition !== 'object')
+        return 'text';
+    const segments = slot.definition.segments;
+    if (!segments || typeof segments !== 'object')
+        return 'text';
+    return segments.markdown === 'native' ? 'native' : 'text';
+}
+export function applyOutboundMarkdownPolicy(payload, policy) {
+    if (policy === 'native')
+        return payload;
+    const convert = (item) => {
+        if (!item || typeof item !== 'object' || Array.isArray(item))
+            return item;
+        const segment = item;
+        if (segment.type !== 'markdown')
+            return item;
+        const content = String(segment.data?.content ?? segment.data?.text ?? '');
+        return { type: 'text', data: { text: markdownToPlainText(content) } };
+    };
+    return Array.isArray(payload) ? payload.map(convert) : convert(payload);
+}
 function readDeclaredInteractivePolicy(definition) {
     if (!definition || typeof definition !== 'object')
         return undefined;

package/lib/plugin-runtime/im/side-event-gateway.d.ts

@@ -0,0 +1,13 @@
+import type { Notice } from '../../notice.js';
+import type { Request } from '../../request.js';
+import type { SystemEvent } from '../../system-event.js';
+/**
+ * Plugin Runtime 侧事件入站口（与 messageGatewayToken 并列）。
+ * 适配器归一 Notice / Request / SystemEvent 后调用，由 ImRuntime 分发给 HandlerIndex。
+ */
+export interface SideEventGateway {
+    receiveNotice(notice: Notice): Promise<void>;
+    receiveRequest(request: Request): Promise<void>;
+    receiveSystem(event: SystemEvent): Promise<void>;
+}
+export declare const sideEventGatewayToken: import("@zhin.js/plugin-runtime").Token<SideEventGateway>;

package/lib/plugin-runtime/im/side-event-gateway.js

@@ -0,0 +1,2 @@
+import { createToken } from '@zhin.js/plugin-runtime';
+export const sideEventGatewayToken = createToken('zhin.im.side-event-gateway');

package/lib/plugin.d.ts

@@ -185,6 +185,7 @@ export declare namespace Plugin {
         'endpoint.error': [import('./built/endpoint-lifecycle.js').EndpointLifecyclePayload];
         "request.receive": [import('./request.js').Request];
         "notice.receive": [import('./notice.js').Notice];
+        "system.receive": [import('./system-event.js').SystemEvent];
         "ai.processing.start": [Plugin.AIEventPayload];
         "ai.processing.finish": [Plugin.AIEventPayload];
         "ai.processing.error": [Plugin.AIEventPayload];

package/lib/{prompt.d.ts → schema-interaction.d.ts}

@@ -5,10 +5,10 @@ import { Schema } from '@zhin.js/schema';
 /**
  * Prompt类：用于实现机器人与用户的交互式提问与输入收集。
  * 支持文本、数字、确认、列表、选项、Schema等多种输入类型，自动处理超时、默认值、格式化等。
- * 典型用法：await new Prompt(plugin, event).text('请输入内容')
+ * 典型用法：await new SchemaInteraction(plugin, event).text('请输入内容')
  * @template P 适配器类型
  */
-export declare class Prompt<P extends RegisteredAdapter> {
+export declare class SchemaInteraction<P extends RegisteredAdapter> {
     private plugin;
     private event;
     /**
@@ -25,7 +25,7 @@ export declare class Prompt<P extends RegisteredAdapter> {
      * 通用提问方法，支持自定义格式化、超时、默认值等
      * @param config 提问配置
      */
-    private prompt;
+    private collect;
     /**
      * 注册一次性消息中间件，等待用户输入或超时
      * @param callback 输入回调
@@ -52,7 +52,7 @@ export declare class Prompt<P extends RegisteredAdapter> {
     /**
      * 列表输入，支持多值分隔
      */
-    list<T extends Prompt.SingleType = 'text'>(tips: string, config?: Prompt.ListConfig<T>, timeoutText?: string): Promise<Prompt.Result<T>[]>;
+    list<T extends SchemaInteraction.SingleType = 'text'>(tips: string, config?: SchemaInteraction.ListConfig<T>, timeoutText?: string): Promise<SchemaInteraction.Result<T>[]>;
     /**
      * 返回常量值（用于Schema）
      */
@@ -60,7 +60,7 @@ export declare class Prompt<P extends RegisteredAdapter> {
     /**
      * 选项选择，支持单选/多选
      */
-    pick<T extends Prompt.SingleType, M extends boolean = false>(tips: string, config: Prompt.PickConfig<T, M>, timeoutText?: string): Promise<Prompt.PickResult<T, M>>;
+    pick<T extends SchemaInteraction.SingleType, M extends boolean = false>(tips: string, config: SchemaInteraction.PickConfig<T, M>, timeoutText?: string): Promise<SchemaInteraction.PickResult<T, M>>;
     /**
      * 基于Schema的选项选择
      */
@@ -79,7 +79,7 @@ export declare class Prompt<P extends RegisteredAdapter> {
 /**
  * Prompt命名空间：类型辅助定义
  */
-export declare namespace Prompt {
+export declare namespace SchemaInteraction {
     interface SingleMap {
         text: string;
         number: number;

package/lib/{prompt.js → schema-interaction.js}

@@ -1,10 +1,10 @@
 /**
  * Prompt类：用于实现机器人与用户的交互式提问与输入收集。
  * 支持文本、数字、确认、列表、选项、Schema等多种输入类型，自动处理超时、默认值、格式化等。
- * 典型用法：await new Prompt(plugin, event).text('请输入内容')
+ * 典型用法：await new SchemaInteraction(plugin, event).text('请输入内容')
  * @template P 适配器类型
  */
-export class Prompt {
+export class SchemaInteraction {
     plugin;
     event;
     /**
@@ -26,10 +26,10 @@ export class Prompt {
      * 通用提问方法，支持自定义格式化、超时、默认值等
      * @param config 提问配置
      */
-    prompt(config) {
+    collect(config) {
         return new Promise(async (resolve, reject) => {
             if (!this.event.$reply) {
-                reject(new Error('Prompt requires outbound capability on the current endpoint'));
+                reject(new Error('SchemaInteraction requires outbound capability on the current endpoint'));
                 return;
             }
             const id = await this.event.$reply(config.tips);
@@ -72,7 +72,7 @@ export class Prompt {
      * 文本输入
      */
     async text(tips, timeout, defaultValue = '', timeoutText) {
-        return this.prompt({
+        return this.collect({
             tips,
             defaultValue,
             timeoutText,
@@ -84,7 +84,7 @@ export class Prompt {
      * 任意输入
      */
     async any(tips, timeout, defaultValue = '', timeoutText) {
-        return this.prompt({
+        return this.collect({
             tips,
             defaultValue,
             timeoutText,
@@ -96,7 +96,7 @@ export class Prompt {
      * 数字输入
      */
     async number(tips, timeout, defaultValue = 0, timeoutText) {
-        return this.prompt({
+        return this.collect({
             tips,
             defaultValue,
             timeoutText,
@@ -108,7 +108,7 @@ export class Prompt {
      * 确认输入（如 yes/no）
      */
     async confirm(tips, condition = 'yes', timeout, defaultValue = false, timeoutText) {
-        return this.prompt({
+        return this.collect({
             tips: `${tips}\n输入“${condition}”以确认`,
             defaultValue,
             timeout,
@@ -121,7 +121,7 @@ export class Prompt {
      */
     async list(tips, config = { type: 'text' }, timeoutText) {
         const separator = config.separator || ',';
-        return this.prompt({
+        return this.collect({
             tips: `${tips}\n值之间使用“${separator}”分隔`,
             defaultValue: config.defaultValue || [],
             timeout: config.timeout,
@@ -154,7 +154,7 @@ export class Prompt {
         const separator = config.separator || ',';
         if (config.multiple)
             moreTextArr.push(`多选请用“${separator}”分隔`);
-        return this.prompt({
+        return this.collect({
             tips: `${tips}\n${moreTextArr.join('\n')}`,
             defaultValue: config.defaultValue,
             timeout: config.timeout,
@@ -218,13 +218,13 @@ export class Prompt {
                     throw new Error('Object schema missing object definition');
                 return (await this.getValueWithSchemas(schema.options.object));
             case 'date':
-                return await this.prompt({
+                return await this.collect({
                     tips: schema.meta.description || schema.meta.key || 'Enter a date',
                     defaultValue: schema.meta.default || new Date(),
                     format: (input) => new Date(input),
                 });
             case 'regexp':
-                return await this.prompt({
+                return await this.collect({
                     tips: schema.meta.description || schema.meta.key || 'Enter a regex pattern',
                     defaultValue: schema.meta.default || '',
                     format: (input) => new RegExp(input),

package/lib/side-event/base.d.ts

@@ -25,6 +25,13 @@ export interface SideEventBase {
     $target?: MessageSender;
     /** 毫秒时间戳 */
     $timestamp: number;
+    /** Canonical relation fields populated by the Adapter boundary. */
+    $message_id?: string;
+    $reaction?: string;
+    $operation?: 'added' | 'removed';
+    $duration_seconds?: number;
+    $role?: string;
+    $enabled?: boolean;
 }
 /** 组合 Side Event 完整类型名 */
 export declare function composeSideEventName(type: string, sceneType: string | undefined, subType: string | undefined): string;

package/lib/side-event/dispatch.d.ts

@@ -0,0 +1,15 @@
+import type { SideEventGateway } from '../plugin-runtime/im/side-event-gateway.js';
+import { type OneBotLikeRawEvent, type SideEventPlatform } from './normalize.js';
+export interface OneBotLikeSideEventInput {
+    readonly adapter: string;
+    readonly endpointKey: string;
+    readonly platform?: SideEventPlatform;
+    readonly raw: OneBotLikeRawEvent;
+    readonly approve?: (flag: string, remark?: string) => void | Promise<void>;
+    readonly reject?: (flag: string, reason?: string) => void | Promise<void>;
+}
+/**
+ * Normalize OneBot / icqq-style notice|request|meta payloads and forward to SideEventGateway.
+ * Returns which kind was dispatched, or null when the payload is not a side event.
+ */
+export declare function receiveOneBotLikeSideEvent(gateway: SideEventGateway, input: OneBotLikeSideEventInput): Promise<'notice' | 'request' | 'system' | null>;

package/lib/side-event/dispatch.js

@@ -0,0 +1,140 @@
+import { buildNotice, buildRequest, buildSystem, mapNoticeParts, mapRequestParts, resolveSideEventDedupeKey, senderFromId, } from './normalize.js';
+/**
+ * Normalize OneBot / icqq-style notice|request|meta payloads and forward to SideEventGateway.
+ * Returns which kind was dispatched, or null when the payload is not a side event.
+ */
+export async function receiveOneBotLikeSideEvent(gateway, input) {
+    const raw = input.raw;
+    const platform = input.platform ?? 'onebot';
+    const postType = String(raw.post_type ?? raw.type ?? '');
+    if (postType === 'notice' || postType.startsWith('notice.')) {
+        const noticeType = String(raw.notice_type ?? (postType.replace(/^notice\.?/, '') || 'unknown'));
+        const parts = mapNoticeParts(platform, noticeType, {
+            sub_type: raw.sub_type != null ? String(raw.sub_type) : undefined,
+            is_group: raw.group_id != null,
+        });
+        const id = resolveSideEventDedupeKey(raw, 'notice');
+        const memberEvent = ['member_increase', 'member_decrease', 'ban', 'admin_change'].includes(parts.sub_type);
+        const actorId = raw.operator_id
+            ?? (!memberEvent ? raw.user_id : undefined);
+        const targetId = memberEvent
+            ? raw.user_id
+            : parts.sub_type === 'poke'
+                ? raw.target_id ?? raw.self_id
+                : raw.user_id != null && String(raw.user_id) !== String(raw.operator_id ?? '')
+                    ? raw.user_id
+                    : undefined;
+        const notice = buildNotice(raw, {
+            $id: id,
+            $adapter: input.adapter,
+            $endpoint: input.endpointKey,
+            $type: 'notice',
+            $scene_id: String(raw.group_id ?? raw.user_id ?? input.endpointKey),
+            $scene_type: parts.scene_type,
+            $sub_type: parts.sub_type,
+            $actor: senderFromId(actorId),
+            $target: senderFromId(targetId),
+            $timestamp: toMillis(raw.time),
+            ...(raw.message_id != null ? { $message_id: String(raw.message_id) } : {}),
+            ...(raw.emoji_id != null || raw.code != null
+                ? { $reaction: String(raw.emoji_id ?? raw.code) }
+                : {}),
+            ...(parts.sub_type === 'emoji_reaction'
+                ? { $operation: /delete|remove/i.test(String(raw.sub_type ?? noticeType)) ? 'removed' : 'added' }
+                : {}),
+            ...(raw.duration != null ? { $duration_seconds: Math.max(0, Number(raw.duration) || 0) } : {}),
+            ...(parts.sub_type === 'admin_change'
+                ? { $role: 'admin', $enabled: String(raw.sub_type ?? '') === 'set' }
+                : {}),
+        });
+        await gateway.receiveNotice(notice);
+        return 'notice';
+    }
+    if (postType === 'request' || postType.startsWith('request.')) {
+        const requestType = String(raw.request_type ?? (postType.replace(/^request\.?/, '') || 'friend'));
+        const parts = mapRequestParts(platform, requestType, raw.sub_type != null ? String(raw.sub_type) : undefined);
+        const flag = raw.flag != null ? String(raw.flag) : '';
+        const id = flag || resolveSideEventDedupeKey(raw, 'request');
+        const actor = senderFromId(raw.user_id);
+        if (!actor)
+            return null;
+        const approve = input.approve;
+        const reject = input.reject;
+        let active = true;
+        const actions = new Set();
+        const requireActiveAction = () => {
+            if (!active)
+                throw new Error('Request action port expired with its generation operation');
+        };
+        const runAction = (action) => {
+            requireActiveAction();
+            const operation = Promise.resolve().then(action);
+            actions.add(operation);
+            void operation.then(() => actions.delete(operation), () => actions.delete(operation));
+            return operation;
+        };
+        const request = buildRequest(raw, {
+            $id: id,
+            $adapter: input.adapter,
+            $endpoint: input.endpointKey,
+            $type: 'request',
+            $scene_id: String(raw.group_id ?? raw.user_id ?? input.endpointKey),
+            $scene_type: parts.scene_type,
+            $sub_type: parts.sub_type,
+            $actor: actor,
+            $comment: raw.comment != null ? String(raw.comment) : undefined,
+            $timestamp: toMillis(raw.time),
+            async $approve(remark) {
+                if (!approve || !flag)
+                    throw new Error('Request approve is not available');
+                await runAction(() => approve(flag, remark));
+            },
+            async $reject(reason) {
+                if (!reject || !flag)
+                    throw new Error('Request reject is not available');
+                await runAction(() => reject(flag, reason));
+            },
+        });
+        try {
+            await gateway.receiveRequest(request);
+        }
+        finally {
+            active = false;
+            await Promise.allSettled([...actions]);
+        }
+        return 'request';
+    }
+    if (postType === 'meta_event'
+        || postType === 'meta'
+        || postType.startsWith('meta.')
+        || postType.startsWith('system.')) {
+        const metaType = String(raw.meta_event_type
+            ?? raw.detail_type
+            ?? (postType.replace(/^(meta_event|meta|system)\.?/, '') || 'unknown'));
+        const subType = raw.sub_type != null ? String(raw.sub_type) : undefined;
+        const sceneType = postType.startsWith('system.')
+            ? (postType.split('.')[1] ?? 'system')
+            : metaType === 'lifecycle' || metaType === 'heartbeat'
+                ? metaType
+                : 'meta';
+        const system = buildSystem(raw, {
+            $id: `system:${toMillis(raw.time)}_${metaType}_${subType ?? ''}`,
+            $adapter: input.adapter,
+            $endpoint: input.endpointKey,
+            $type: 'system',
+            $scene_id: String(raw.self_id ?? input.endpointKey),
+            $scene_type: sceneType,
+            $sub_type: subType ?? metaType,
+            $timestamp: toMillis(raw.time),
+        });
+        await gateway.receiveSystem(system);
+        return 'system';
+    }
+    return null;
+}
+function toMillis(time) {
+    const seconds = Number(time);
+    return Number.isFinite(seconds) && seconds > 0
+        ? (seconds < 1e12 ? seconds * 1000 : seconds)
+        : Date.now();
+}

package/lib/side-event/index.d.ts

@@ -1,3 +1,4 @@
 export * from './base.js';
 export * from './types.js';
 export * from './normalize.js';
+export * from './dispatch.js';

package/lib/side-event/index.js

@@ -1,3 +1,4 @@
 export * from './base.js';
 export * from './types.js';
 export * from './normalize.js';
+export * from './dispatch.js';

package/lib/side-event/normalize.d.ts

@@ -1,5 +1,6 @@
 import { Notice, type NoticeBase } from '../notice.js';
 import { Request, type RequestBase } from '../request.js';
+import { SystemEvent, type SystemEventBase } from '../system-event.js';
 import { type ComposedNoticeName, type ComposedRequestName, type SideEventParts } from './types.js';
 export type SideEventPlatform = 'onebot' | 'icqq' | 'napcat' | 'kook' | (string & {});
 export interface OneBotLikeRawEvent {
@@ -38,3 +39,4 @@ export declare function senderFromId(id: unknown, name?: string): {
 } | undefined;
 export declare function buildNotice<T extends object>(input: T, format: NoticeBase): Notice<T>;
 export declare function buildRequest<T extends object>(input: T, format: RequestBase): Request<T>;
+export declare function buildSystem<T extends object>(input: T, format: SystemEventBase): SystemEvent<T>;

package/lib/side-event/normalize.js

@@ -1,5 +1,6 @@
 import { Notice } from '../notice.js';
 import { Request } from '../request.js';
+import { SystemEvent } from '../system-event.js';
 import { composeSideEventName, parseSideEventName, } from './base.js';
 import { KOOK_NOTICE_PARTS_MAP, ONEBOT_NOTICE_PARTS_MAP, SLACK_NOTICE_PARTS_MAP } from './types.js';
 /** 去重用：notice / request 无稳定 id 时组合键 */
@@ -115,3 +116,6 @@ export function buildNotice(input, format) {
 export function buildRequest(input, format) {
     return Request.from(input, format);
 }
+export function buildSystem(input, format) {
+    return SystemEvent.from(input, format);
+}

package/lib/side-event/types.d.ts

@@ -1,14 +1,16 @@
 /**
  * Side Event 标准类型。
- * 运行时 `$type` 仅存命名空间（`notice` / `request`）；
+ * 运行时 `$type` 仅存命名空间（`notice` / `request` / `system`）；
  * 完整名由 `${$type}.${$scene_type}.${$sub_type}` 组合。
  */
-export type SideEventKind = 'notice' | 'request';
+export type SideEventKind = 'notice' | 'request' | 'system';
 export type NoticeKind = 'notice';
 export type RequestKind = 'request';
+export type SystemKind = 'system';
 /** 完整组合名（测试 / 文档 / 消费者匹配用） */
 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 & {});
 export type ComposedRequestName = 'request.friend.add' | 'request.group.add' | 'request.group.invite' | (string & {});
+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 & {});
 export interface SideEventParts {
     scene_type: string;
     sub_type: string;

package/lib/side-event/types.js

@@ -1,6 +1,6 @@
 /**
  * Side Event 标准类型。
- * 运行时 `$type` 仅存命名空间（`notice` / `request`）；
+ * 运行时 `$type` 仅存命名空间（`notice` / `request` / `system`）；
  * 完整名由 `${$type}.${$scene_type}.${$sub_type}` 组合。
  */
 /** OneBot / icqq 等平台 notice_type 原始值 → 标准 scene_type + sub_type */

package/lib/system-event.d.ts

@@ -0,0 +1,15 @@
+import type { Adapters } from './adapter.js';
+import type { SideEventBase } from './side-event/base.js';
+/**
+ * 系统/登录侧事件（扫码、滑块、掉线等）。
+ * `$scene_type`：`login` / `offline` / `online` 等；
+ * `$sub_type`：`qrcode` / `slider` / `device` / `kickoff` / `network` 等。
+ */
+export interface SystemEventBase extends SideEventBase {
+    $adapter: keyof Adapters;
+    $type: 'system';
+}
+export type SystemEvent<T extends object = {}> = SystemEventBase & T;
+export declare namespace SystemEvent {
+    function from<T extends object>(input: T, format: SystemEventBase): SystemEvent<T>;
+}

package/lib/system-event.js

@@ -0,0 +1,7 @@
+export var SystemEvent;
+(function (SystemEvent) {
+    function from(input, format) {
+        return Object.assign(input, format);
+    }
+    SystemEvent.from = from;
+})(SystemEvent || (SystemEvent = {}));

package/lib/types.d.ts

@@ -61,21 +61,6 @@ export type MaybeArray<T> = T | T[];
  * 消息发送内容类型
  */
 export type SendContent = MaybeArray<string | MessageElement>;
-/** $getMsg 返回的被引用消息载荷 */
-export interface QuotedMessagePayload {
-    messageId: string;
-    sender?: {
-        id?: string;
-        name?: string;
-    };
-    content: MessageElement[] | string;
-    raw?: string;
-    time?: number;
-}
-/** 支持按 message_id 拉取历史消息的 Bot（可选实现） */
-export interface QuotableEndpoint {
-    $getMsg(messageId: string): Promise<QuotedMessagePayload>;
-}
 /** 可选：编辑已发送消息（交互式棋盘更新） */
 export interface EditMessageOptions {
     messageId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/core",
-  "version": "1.5.11",
+  "version": "1.5.13",
   "description": "Zhin机器人核心框架",
   "type": "module",
   "main": "./lib/index.js",
@@ -75,17 +75,18 @@
     "segment-matcher": "^1.0.5",
     "smol-toml": "^1.7.1",
     "yaml": "^2.9.0",
-    "@zhin.js/adapter": "1.1.10",
-    "@zhin.js/command": "1.0.14",
-    "@zhin.js/component": "1.0.11",
+    "@zhin.js/adapter": "1.2.0",
+    "@zhin.js/component": "1.0.12",
+    "@zhin.js/command": "1.0.15",
     "@zhin.js/database": "1.0.79",
-    "@zhin.js/handler": "1.0.2",
-    "@zhin.js/im-contract": "1.0.3",
+    "@zhin.js/handler": "1.0.3",
+    "@zhin.js/im-contract": "1.0.4",
+    "@zhin.js/interaction": "1.0.1",
     "@zhin.js/kernel": "1.0.7",
     "@zhin.js/logger": "1.0.76",
-    "@zhin.js/middleware": "1.0.11",
-    "@zhin.js/permission": "1.0.2",
-    "@zhin.js/plugin-runtime": "1.1.6",
+    "@zhin.js/middleware": "1.0.12",
+    "@zhin.js/plugin-runtime": "1.1.7",
+    "@zhin.js/permission": "1.0.3",
     "@zhin.js/schema": "1.0.73"
   },
   "peerDependencies": {
@@ -101,7 +102,7 @@
     "@types/qrcode": "^1.5.6",
     "ajv": "8.18.0",
     "typescript": "^6.0.3",
-    "@zhin.js/ai": "1.5.5"
+    "@zhin.js/ai": "1.5.6"
   },
   "repository": {
     "type": "git",