@zhin.js/core 1.3.2 → 1.3.4

package/lib/command.js

@@ -1,5 +1,4 @@
-import { SegmentMatcher } from "segment-matcher";
-import logger, { formatCompact } from "@zhin.js/logger";
+import { SegmentMatcher } from 'segment-matcher';
 /**
  * MessageCommand类：命令系统核心，基于segment-matcher实现。
  * 支持多平台命令注册、作用域限制、参数解析、异步处理等。
@@ -18,6 +17,24 @@ export class MessageCommand extends SegmentMatcher {
             examples: this.#examples
         };
     }
+    constructor(C, P = {}) {
+        super(C, {
+            at: ['qq', 'user_id'],
+            face: ['id'],
+            mention: ['qq', 'user_id'],
+            html: ['content'],
+            markdown: ['content'],
+            image: ['file', 'src', 'url'],
+            video: ['file', 'src', 'url'],
+            audio: ['file', 'src', 'url'],
+            file: ['file', 'src', 'url'],
+            reply: ['id', 'reply_id', 'message_id'],
+            quote: ['id', 'reply_id', 'message_id'],
+            forward: ['id', 'res_id', 'message_id'],
+            location: ['latitude', 'longitude'],
+            ...P,
+        });
+    }
     get help() {
         return [
             this.pattern,
@@ -50,6 +67,23 @@ export class MessageCommand extends SegmentMatcher {
         this.#permissions.push(...permissions);
         return this;
     }
+    /** 命令要求的 permit 列表（空表示所有人可用） */
+    get requiredPermits() {
+        return this.#permissions;
+    }
+    /** 与 handle 一致的 permit 校验，供帮助菜单等场景过滤不可见命令 */
+    async checkPermits(message, plugin) {
+        if (!this.#permissions.length)
+            return true;
+        const auth = plugin.contextIsReady('permission') ? plugin.inject('permission') : null;
+        if (!auth)
+            return false;
+        for (const permit of this.#permissions) {
+            if (!(await auth.check(permit, message)))
+                return false;
+        }
+        return true;
+    }
     /**
      * 处理消息，自动匹配命令并执行回调
      * @param message 消息对象
@@ -57,19 +91,8 @@ export class MessageCommand extends SegmentMatcher {
      * @returns 命令返回内容或undefined
      */
     async handle(message, plugin) {
-        const auth = plugin.contextIsReady('permission') ? plugin.inject('permission') : null;
-        for (const permit of this.#permissions) {
-            const passed = auth ? await auth.check(permit, message) : false;
-            if (!passed) {
-                logger.debug(formatCompact({
-                    op: 'permit_denied',
-                    permit,
-                    senderId: message.$sender.id,
-                    adapter: message.$adapter,
-                    endpoint: message.$endpoint,
-                }));
-                return;
-            }
+        if (!(await this.checkPermits(message, plugin))) {
+            return;
         }
         const matched = this.match(message.$content);
         if (!matched)
@@ -81,4 +104,3 @@ export class MessageCommand extends SegmentMatcher {
         }
     }
 }
-//# sourceMappingURL=command.js.map

package/lib/component.d.ts

@@ -24,4 +24,3 @@ export declare const Fragment: Component<{
     children?: SendContent;
 }>;
 export declare const Fetch: Component<any>;
-//# sourceMappingURL=component.d.ts.map

package/lib/component.js

@@ -176,24 +176,41 @@ function parseAttributeValue(str, startIndex, context) {
 function evaluateQuotedExpression(quotedValue, context) {
     if (!context)
         return quotedValue;
-    // 处理引号内的表达式，将 {expr} 格式转换为 ${expr} 格式
-    let result = quotedValue;
-    const expressionRegex = /\{([^}]+)\}/g;
-    let match;
-    while ((match = expressionRegex.exec(quotedValue)) !== null) {
-        const expr = match[1];
+    let result = '';
+    let cursor = 0;
+    for (const match of readBraceExpressions(quotedValue)) {
+        result += quotedValue.slice(cursor, match.start);
         try {
-            const value = context.getValue(expr);
-            if (value !== undefined && value !== expr) {
+            const value = context.getValue(match.expr);
+            if (value !== undefined && value !== match.expr) {
                 const stringValue = typeof value === 'string' ? value : JSON.stringify(value);
-                result = result.replace(match[0], stringValue);
+                result += stringValue;
+            }
+            else {
+                result += quotedValue.slice(match.start, match.end);
             }
         }
         catch (error) {
-            // 如果求值失败，保持原始表达式
+            result += quotedValue.slice(match.start, match.end);
         }
+        cursor = match.end;
     }
-    return result;
+    return result + quotedValue.slice(cursor);
+}
+function readBraceExpressions(value) {
+    const matches = [];
+    let cursor = 0;
+    while (cursor < value.length) {
+        const start = value.indexOf('{', cursor);
+        if (start < 0)
+            break;
+        const end = value.indexOf('}', start + 1);
+        if (end < 0)
+            break;
+        matches.push({ start, end: end + 1, expr: value.slice(start + 1, end) });
+        cursor = end + 1;
+    }
+    return matches;
 }
 /**
  * 解析表达式值
@@ -564,4 +581,3 @@ export const Fragment = defineComponent(async (props, context) => {
 export const Fetch = defineComponent(async ({ url }) => {
     return await fetch(url, { signal: AbortSignal.timeout(30_000) }).then((r) => r.text());
 }, 'fetch');
-//# sourceMappingURL=component.js.map

package/lib/endpoint-capabilities.d.ts

@@ -2,6 +2,7 @@ import type { Message } from './message.js';
 import type { Notice } from './notice.js';
 import type { Request } from './request.js';
 import type { SendOptions } from './types.js';
+import type { AIAccessScopeConfig } from './built/ai-access.js';
 export type EndpointCapability = 'inbound' | 'outbound';
 export declare const DEFAULT_ENDPOINT_CAPABILITIES: readonly EndpointCapability[];
 /** 入站能力：含连接生命周期 */
@@ -41,5 +42,6 @@ export declare function assertInbound(endpoint: InboundEndpoint | OutboundEndpoi
 export declare function assertOutbound(endpoint: InboundEndpoint | OutboundEndpoint): asserts endpoint is OutboundEndpoint;
 export interface EndpointCapabilitiesConfig {
     capabilities?: EndpointCapability[];
+    /** 本 Endpoint 的 AI 访问控制（覆盖 ai.access 全局默认） */
+    aiAccess?: AIAccessScopeConfig;
 }
-//# sourceMappingURL=endpoint-capabilities.d.ts.map

package/lib/endpoint-capabilities.js

@@ -53,4 +53,3 @@ export function assertOutbound(endpoint) {
         throw new OutboundNotSupportedError('$id' in endpoint ? String(endpoint.$id) : undefined);
     }
 }
-//# sourceMappingURL=endpoint-capabilities.js.map

package/lib/endpoint.d.ts

@@ -12,4 +12,3 @@ export declare namespace Endpoint {
         context: K;
     };
 }
-//# sourceMappingURL=endpoint.d.ts.map

package/lib/endpoint.js

@@ -1,2 +1 @@
 export { DEFAULT_ENDPOINT_CAPABILITIES, OutboundNotSupportedError, InboundNotSupportedError, resolveEndpointCapabilities, registerEndpointCapabilities, getEndpointCapabilities, getAdapterCapabilities, hasInbound, hasOutbound, assertInbound, assertOutbound, } from './endpoint-capabilities.js';
-//# sourceMappingURL=endpoint.js.map

package/lib/errors.d.ts

@@ -19,4 +19,3 @@ export declare class MessageError extends ZhinError {
     readonly channelId?: string;
     constructor(message: string, messageId?: string, channelId?: string, context?: Record<string, any>);
 }
-//# sourceMappingURL=errors.d.ts.map

package/lib/errors.js

@@ -27,4 +27,3 @@ export class MessageError extends ZhinError {
         this.channelId = channelId;
     }
 }
-//# sourceMappingURL=errors.js.map

package/lib/host-plugin-registry.d.ts

@@ -5,4 +5,3 @@
 import type { Plugin } from './plugin.js';
 export declare function setHostRootPlugin(plugin: Plugin | null): void;
 export declare function getHostRootPlugin(): Plugin | null;
-//# sourceMappingURL=host-plugin-registry.d.ts.map

package/lib/host-plugin-registry.js

@@ -5,4 +5,3 @@ export function setHostRootPlugin(plugin) {
 export function getHostRootPlugin() {
     return hostRoot;
 }
-//# sourceMappingURL=host-plugin-registry.js.map

package/lib/im-scene.d.ts

@@ -0,0 +1,29 @@
+import type { Message, MessageType } from './message.js';
+import type { SendContent, SendOptions } from './types.js';
+export type IMSceneKind = MessageType;
+/** Parent scene kind (distinct from sub-channel MessageType.channel). */
+export type IMSceneParentKind = 'group' | 'guild';
+export interface IMSceneParentRef {
+    kind: IMSceneParentKind;
+    sceneId: string;
+}
+export interface IMSceneRef {
+    platform: string;
+    endpointId: string;
+    sceneId: string;
+    kind: IMSceneKind;
+    senderId?: string;
+    parent?: IMSceneParentRef;
+}
+export interface IMDeliveryTarget {
+    channel: 'im';
+    scene: IMSceneRef;
+    threadId?: string;
+    quoteId?: string;
+}
+/** Normalize legacy parent.type channel → guild. */
+export declare function normalizeIMSceneParentKind(value: unknown): IMSceneParentKind | undefined;
+export declare function sceneRefFromMessage(message: Partial<Message<any>>): IMSceneRef | undefined;
+export declare function sceneRefToSendOptions(target: IMDeliveryTarget, content: SendContent): SendOptions;
+export declare function resolveIMSceneSessionId(scene: IMSceneRef): string;
+export declare function messageToIMDeliveryTarget(message: Partial<Message<any>>): IMDeliveryTarget | undefined;

package/lib/im-scene.js

@@ -0,0 +1,77 @@
+import { resolveIMSceneSessionId as resolveIMSceneSessionIdKernel, } from '@zhin.js/kernel';
+function nonEmptyString(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+/** Normalize legacy parent.type channel → guild. */
+export function normalizeIMSceneParentKind(value) {
+    if (value === 'group' || value === 'guild')
+        return value;
+    if (value === 'channel')
+        return 'guild';
+    return undefined;
+}
+export function sceneRefFromMessage(message) {
+    const platform = nonEmptyString(message.$adapter);
+    const endpointId = nonEmptyString(message.$endpoint);
+    const kind = message.$channel?.type;
+    if (!platform || !endpointId || !kind)
+        return undefined;
+    const senderId = nonEmptyString(message.$sender?.id);
+    const channelId = nonEmptyString(message.$channel?.id);
+    const sceneId = kind === 'private'
+        ? senderId ?? channelId
+        : channelId ?? senderId;
+    if (!sceneId)
+        return undefined;
+    const parentKind = message.$channel?.parent
+        ? normalizeIMSceneParentKind(message.$channel.parent.type)
+        : undefined;
+    const parent = parentKind && message.$channel?.parent
+        ? {
+            kind: parentKind,
+            sceneId: String(message.$channel.parent.id),
+        }
+        : undefined;
+    return {
+        platform,
+        endpointId,
+        sceneId,
+        kind,
+        ...(senderId ? { senderId } : {}),
+        ...(parent ? { parent } : {}),
+    };
+}
+export function sceneRefToSendOptions(target, content) {
+    const { scene } = target;
+    return {
+        context: scene.platform,
+        endpoint: scene.endpointId,
+        id: scene.sceneId,
+        type: scene.kind,
+        parent: scene.parent
+            ? { type: scene.parent.kind, id: scene.parent.sceneId }
+            : undefined,
+        content,
+        ...(target.quoteId ? { quoteId: target.quoteId } : {}),
+        ...(target.threadId ? { threadId: target.threadId } : {}),
+    };
+}
+export function resolveIMSceneSessionId(scene) {
+    return resolveIMSceneSessionIdKernel({
+        platform: scene.platform,
+        endpointId: scene.endpointId,
+        sceneId: scene.sceneId,
+        kind: scene.kind,
+    });
+}
+export function messageToIMDeliveryTarget(message) {
+    const scene = sceneRefFromMessage(message);
+    if (!scene)
+        return undefined;
+    const quoteId = nonEmptyString(message.$quote_id);
+    return {
+        channel: 'im',
+        scene,
+        ...(quoteId ? { quoteId } : {}),
+    };
+}

package/lib/im-session-id.d.ts

@@ -1,26 +1,39 @@
 /**
- * IM 会话 ID 解析（无 AI 依赖）
+ * IM 会话 ID 解析（SSOT 在 @zhin.js/kernel + im-scene）
  *
- * 格式：`platform:endpointId:scope:sceneId`
+ * 格式：`platform:endpointId:kind:sceneId`
  */
-export type IMSessionScope = 'private' | 'group' | 'channel';
-export interface ResolveIMSessionIdInput {
-    platform: string;
-    endpointId: string;
-    scope: IMSessionScope;
-    sceneId: string;
-}
+import { type ResolveIMSessionIdInput } from '@zhin.js/kernel';
+import { type IMSceneKind, type IMSceneRef } from './im-scene.js';
+export type { IMSceneKind, ResolveIMSessionIdInput };
 export declare function resolveIMSessionId(input: ResolveIMSessionIdInput): string;
-export declare function resolveIMSceneIdForSession(scope: IMSessionScope, sceneId?: string, senderId?: string): string;
+export declare function resolveIMSessionIdFromScene(scene: IMSceneRef): string;
+export declare function resolveIMSceneIdForSession(kind: IMSceneKind, sceneId?: string, senderId?: string): string;
 export declare function resolveIMSessionIdFromMessage(message: {
     $adapter?: string;
     $endpoint?: string;
     $channel?: {
-        type?: IMSessionScope;
+        type?: IMSceneKind;
         id?: string;
     };
     $sender?: {
         id?: string;
     };
 }): string;
-//# sourceMappingURL=im-session-id.d.ts.map
+/** Canonical scene fields for transcript / session persistence (ADR 0028 SSOT). */
+export declare function resolveSceneFieldsFromMessage(message: {
+    $adapter?: string;
+    $endpoint?: string;
+    $channel?: {
+        type?: IMSceneKind;
+        id?: string;
+    };
+    $sender?: {
+        id?: string;
+    };
+}): {
+    platform: string;
+    endpointId: string;
+    sceneId: string;
+    sceneType: IMSceneKind;
+};

package/lib/im-session-id.js

@@ -1,29 +1,47 @@
 /**
- * IM 会话 ID 解析（无 AI 依赖）
+ * IM 会话 ID 解析（SSOT 在 @zhin.js/kernel + im-scene）
  *
- * 格式：`platform:endpointId:scope:sceneId`
+ * 格式：`platform:endpointId:kind:sceneId`
  */
+import { resolveIMSceneIdForSession as resolveIMSceneIdForSessionKernel, resolveIMSessionId as resolveIMSessionIdKernel, } from '@zhin.js/kernel';
+import { resolveIMSceneSessionId, sceneRefFromMessage, } from './im-scene.js';
 export function resolveIMSessionId(input) {
-    const platform = String(input.platform || 'unknown');
-    const endpointId = String(input.endpointId || 'default');
-    const scope = input.scope || 'private';
-    const sceneId = String(input.sceneId || 'unknown');
-    return `${platform}:${endpointId}:${scope}:${sceneId}`;
+    return resolveIMSessionIdKernel(input);
 }
-export function resolveIMSceneIdForSession(scope, sceneId, senderId) {
-    if (scope === 'group' || scope === 'channel') {
-        return sceneId || senderId || 'unknown';
-    }
-    return senderId || sceneId || 'unknown';
+export function resolveIMSessionIdFromScene(scene) {
+    return resolveIMSceneSessionId(scene);
+}
+export function resolveIMSceneIdForSession(kind, sceneId, senderId) {
+    return resolveIMSceneIdForSessionKernel(kind, sceneId, senderId);
 }
 export function resolveIMSessionIdFromMessage(message) {
-    const scope = (message.$channel?.type || 'private');
-    const sceneId = resolveIMSceneIdForSession(scope, message.$channel?.id, message.$sender?.id);
+    const scene = sceneRefFromMessage(message);
+    if (scene)
+        return resolveIMSceneSessionId(scene);
+    const kind = (message.$channel?.type || 'private');
     return resolveIMSessionId({
         platform: String(message.$adapter || ''),
         endpointId: String(message.$endpoint || ''),
-        scope,
-        sceneId,
+        kind,
+        sceneId: resolveIMSceneIdForSession(kind, message.$channel?.id, message.$sender?.id),
     });
 }
-//# sourceMappingURL=im-session-id.js.map
+/** Canonical scene fields for transcript / session persistence (ADR 0028 SSOT). */
+export function resolveSceneFieldsFromMessage(message) {
+    const scene = sceneRefFromMessage(message);
+    if (scene) {
+        return {
+            platform: scene.platform,
+            endpointId: scene.endpointId,
+            sceneId: scene.sceneId,
+            sceneType: scene.kind,
+        };
+    }
+    const sceneType = (message.$channel?.type || 'private');
+    return {
+        platform: String(message.$adapter || ''),
+        endpointId: String(message.$endpoint || ''),
+        sceneType,
+        sceneId: resolveIMSceneIdForSession(sceneType, message.$channel?.id, message.$sender?.id),
+    };
+}

package/lib/index.d.ts

@@ -5,8 +5,10 @@ export * from './command.js';
 export * from './component.js';
 export * from './adapter.js';
 export * from './message.js';
+export * from './im-scene.js';
 export * from './notice.js';
 export * from './request.js';
+export * from './side-event/index.js';
 export * from './prompt.js';
 export * from './types.js';
 export * from './agent-prompt.js';
@@ -14,7 +16,8 @@ export * from './utils.js';
 export * from './errors.js';
 export * from './built/config.js';
 export * from './built/command.js';
-export * from './built/cron.js';
+export * from './built/schedule.js';
+export type { ScheduleDescriptor, ScheduleHandle, ScheduleContextExtensions } from './built/schedule.js';
 export * from './models/system-log.js';
 export * from './models/user.js';
 export * from './built/permission.js';
@@ -34,16 +37,22 @@ export * from './built/common-adapter-tools.js';
 export * from './built/roles.js';
 export * from './im-session-id.js';
 export * from './built/ai-trigger.js';
+export * from './built/ai-access.js';
 export * from './built/dispatcher.js';
 export * from './built/schema-feature.js';
 export * from './built/login-assist.js';
 export * from './built/generated-qrcode.js';
 export * from './built/qrcode-segment.js';
 export * from './built/rich-segments/index.js';
-export { loadHtmlRenderer, HTML_RENDERER_PACKAGE } from './built/html-renderer-loader.js';
-export { loadSpeechPipeline, SPEECH_PACKAGE } from './built/speech-loader.js';
+export * from './built/interactive-segments/index.js';
+export * from './built/ai-outbound/index.js';
+export { loadHtmlRenderer, seedHtmlRenderer, HTML_RENDERER_PACKAGE } from './built/html-renderer-loader.js';
+export { loadSpeechPipeline, seedSpeechPipeline, SPEECH_PACKAGE } from './built/speech-loader.js';
 export * from './built/outbound-media-utils.js';
 export * from './built/outbound-media-contract.js';
+export * from './built/interactive-segment-contract.js';
+export * from './built/segment-contract/index.js';
+export * from './built/generic-segment-mapper.js';
 export * from './built/adapter-process.js';
 export * from './built/component.js';
 export * from './built/inbound-runner.js';
@@ -61,13 +70,11 @@ export * from './built/introspection-format.js';
 export * from './built/management-command-guard.js';
 export * from './built/html-to-text.js';
 export * from './built/html-segment-fallback.js';
-export * from './built/mcp-mesh-registrar.js';
 export * from './built/prepend-quote-context.js';
 export * from './message-quote.js';
 export * from '@zhin.js/database';
 export * from '@zhin.js/logger';
 export { Schema } from '@zhin.js/schema';
 export type { PluginLike } from '@zhin.js/kernel';
-export { Feature, Cron, Scheduler, getScheduler, setScheduler } from '@zhin.js/kernel';
-export type { FeatureJSON, FeatureListener, Schedule, JobPayload, JobState, ScheduledJob, JobStore, JobCallback, AddJobOptions, IScheduler, SchedulerOptions, } from '@zhin.js/kernel';
-//# sourceMappingURL=index.d.ts.map
+export { Feature, ScheduleEngine, getScheduleEngine, setScheduleEngine, Scheduler, getScheduler, setScheduler, } from '@zhin.js/kernel';
+export type { FeatureJSON, FeatureListener, Schedule, JobPayload, JobState, ScheduledJob, JobStore, JobCallback, AddJobOptions, IScheduler, SchedulerOptions, ScheduleFireCallback, MemoryScheduleRegistration, ScheduleEngineOptions, JobContext, ResolvedJob, ScheduleKind, } from '@zhin.js/kernel';

package/lib/index.js

@@ -6,8 +6,10 @@ export * from './command.js';
 export * from './component.js';
 export * from './adapter.js';
 export * from './message.js';
+export * from './im-scene.js';
 export * from './notice.js';
 export * from './request.js';
+export * from './side-event/index.js';
 export * from './prompt.js';
 export * from './types.js';
 export * from './agent-prompt.js';
@@ -16,7 +18,7 @@ export * from './errors.js';
 // ── Built 模块 ──────────────────────────────────────────────────────
 export * from './built/config.js';
 export * from './built/command.js';
-export * from './built/cron.js';
+export * from './built/schedule.js';
 // Models
 export * from './models/system-log.js';
 export * from './models/user.js';
@@ -36,16 +38,22 @@ export * from './built/common-adapter-tools.js';
 export * from './built/roles.js';
 export * from './im-session-id.js';
 export * from './built/ai-trigger.js';
+export * from './built/ai-access.js';
 export * from './built/dispatcher.js';
 export * from './built/schema-feature.js';
 export * from './built/login-assist.js';
 export * from './built/generated-qrcode.js';
 export * from './built/qrcode-segment.js';
 export * from './built/rich-segments/index.js';
-export { loadHtmlRenderer, HTML_RENDERER_PACKAGE } from './built/html-renderer-loader.js';
-export { loadSpeechPipeline, SPEECH_PACKAGE } from './built/speech-loader.js';
+export * from './built/interactive-segments/index.js';
+export * from './built/ai-outbound/index.js';
+export { loadHtmlRenderer, seedHtmlRenderer, HTML_RENDERER_PACKAGE } from './built/html-renderer-loader.js';
+export { loadSpeechPipeline, seedSpeechPipeline, SPEECH_PACKAGE } from './built/speech-loader.js';
 export * from './built/outbound-media-utils.js';
 export * from './built/outbound-media-contract.js';
+export * from './built/interactive-segment-contract.js';
+export * from './built/segment-contract/index.js';
+export * from './built/generic-segment-mapper.js';
 export * from './built/adapter-process.js';
 export * from './built/component.js';
 export * from './built/inbound-runner.js';
@@ -59,12 +67,10 @@ export * from './built/introspection-format.js';
 export * from './built/management-command-guard.js';
 export * from './built/html-to-text.js';
 export * from './built/html-segment-fallback.js';
-export * from './built/mcp-mesh-registrar.js';
 export * from './built/prepend-quote-context.js';
 export * from './message-quote.js';
 // ── 外部库 re-export ──────────────────────────────────────────────────
 export * from '@zhin.js/database';
 export * from '@zhin.js/logger';
 export { Schema } from '@zhin.js/schema';
-export { Feature, Cron, Scheduler, getScheduler, setScheduler } from '@zhin.js/kernel';
-//# sourceMappingURL=index.js.map
+export { Feature, ScheduleEngine, getScheduleEngine, setScheduleEngine, Scheduler, getScheduler, setScheduler, } from '@zhin.js/kernel';

package/lib/jsx-dev-runtime.d.ts

@@ -1,3 +1,2 @@
 export * from './jsx-runtime.js';
 export { jsx as jsxDEV } from './jsx.js';
-//# sourceMappingURL=jsx-dev-runtime.d.ts.map

package/lib/jsx-dev-runtime.js

@@ -1,3 +1,2 @@
 export * from './jsx-runtime.js';
 export { jsx as jsxDEV } from './jsx.js';
-//# sourceMappingURL=jsx-dev-runtime.js.map

package/lib/jsx-runtime.d.ts

@@ -9,4 +9,3 @@ declare const _default: {
     renderJSX: typeof renderJSX;
 };
 export default _default;
-//# sourceMappingURL=jsx-runtime.d.ts.map

package/lib/jsx-runtime.js

@@ -8,4 +8,3 @@ export default {
     Fragment,
     renderJSX
 };
-//# sourceMappingURL=jsx-runtime.js.map

package/lib/jsx.d.ts

@@ -30,4 +30,3 @@ declare global {
 export declare function jsx(type: JSXElementType, data: JSXProps): MessageComponent<any>;
 export declare function jsxs(type: JSXElementType, props: JSXProps): MessageElement;
 export declare function renderJSX(element: MessageComponent<any>, context?: ComponentContext): Promise<SendContent>;
-//# sourceMappingURL=jsx.d.ts.map

package/lib/jsx.js

@@ -91,4 +91,3 @@ async function renderChildren(children, context) {
     }
     return '';
 }
-//# sourceMappingURL=jsx.js.map

package/lib/message-quote.d.ts

@@ -6,6 +6,5 @@ export declare function quoteIdFromContent(content: MessageElement[]): string |
 export declare function quoteIdFromRaw(raw: unknown): string | undefined;
 /** 无 $quote_id 时从 $content / $raw 回填 */
 export declare function syncQuoteId(message: Message<any>): void;
-/** 将 reply 段的 id / message_id 与 $quote_id 对齐 */
+/** 将 reply 段与 $quote_id 对齐（canonical 仅保留 message_id） */
 export declare function alignReplySegments(content: MessageElement[], quoteId?: string): void;
-//# sourceMappingURL=message-quote.d.ts.map

package/lib/message-quote.js

@@ -75,7 +75,7 @@ export function syncQuoteId(message) {
     if (id)
         message.$quote_id = id;
 }
-/** 将 reply 段的 id / message_id 与 $quote_id 对齐 */
+/** 将 reply 段与 $quote_id 对齐（canonical 仅保留 message_id） */
 export function alignReplySegments(content, quoteId) {
     const id = quoteId ?? quoteIdFromContent(content);
     if (!id)
@@ -84,8 +84,7 @@ export function alignReplySegments(content, quoteId) {
         if (seg.type !== 'reply' || !seg.data || typeof seg.data !== 'object')
             continue;
         const data = seg.data;
-        data.id = id;
         data.message_id = id;
+        delete data.id;
     }
 }
-//# sourceMappingURL=message-quote.js.map

package/lib/message.d.ts

@@ -1,4 +1,4 @@
-import { MessageElement, MessageSender, SendContent } from "./types";
+import { MessageElement, MessageSender, SendContent } from "./types.js";
 import { Component } from "./component.js";
 import { Adapters } from "./adapter.js";
 /**
@@ -17,11 +17,12 @@ export interface MessageChannel {
     id: string;
     type: MessageType;
     /**
-     * 私聊/子频道消息的来源场景（如 QQ 群临时会话：type=private + parent.group）。
-     * 出站时 adapter 据此选择 API（icqq → send_temp_msg）。
+     * 私聊/子频道消息的来源场景：
+     * - 群临时会话：type=private + parent.group
+     * - QQ 子频道：type=channel + parent.guild
      */
     parent?: {
-        type: 'group' | 'channel';
+        type: 'group' | 'channel' | 'guild';
         id: string;
     };
 }
@@ -58,5 +59,6 @@ export declare namespace Message {
     function quoteIdFromContent(content: MessageElement[]): string | undefined;
     function syncQuoteId(message: Message<any>): void;
     function alignReplySegments(content: MessageElement[], quoteId?: string): void;
+    function actionPayload(message: Message<any>): string | undefined;
+    function isAction(message: Message<any>): boolean;
 }
-//# sourceMappingURL=message.d.ts.map