@zhin.js/core 1.3.2 → 1.3.3

package/lib/built/segment-contract/validate.d.ts

@@ -0,0 +1,138 @@
+import { Schema } from '@zhin.js/schema';
+import type { MediaRef, Segment } from './types.js';
+export declare const mediaRefSchema: Schema<{
+    kind?: any;
+    value?: string | undefined;
+    mime_type?: string | undefined;
+}, {
+    kind?: any;
+    value?: string | undefined;
+    mime_type?: string | undefined;
+}>;
+export declare const textSegmentSchema: Schema<{
+    type?: "text" | undefined;
+    data?: {
+        text?: string | undefined;
+    } | undefined;
+    platform?: Record<string, any> | undefined;
+}, {
+    type?: "text" | undefined;
+    data?: {
+        text?: string | undefined;
+    } | undefined;
+    platform?: Record<string, any> | undefined;
+}>;
+export declare const mentionSegmentSchema: Schema<{
+    type?: "mention" | undefined;
+    data?: {
+        target?: string | undefined;
+        name?: string | undefined;
+    } | undefined;
+    platform?: Record<string, any> | undefined;
+}, {
+    type?: "mention" | undefined;
+    data?: {
+        target?: string | undefined;
+        name?: string | undefined;
+    } | undefined;
+    platform?: Record<string, any> | undefined;
+}>;
+export declare const imageSegmentSchema: Schema<{
+    type?: "image" | undefined;
+    data?: {
+        media?: {
+            kind?: any;
+            value?: string | undefined;
+            mime_type?: string | undefined;
+        } | undefined;
+        alt?: string | undefined;
+    } | undefined;
+    platform?: Record<string, any> | undefined;
+}, {
+    type?: "image" | undefined;
+    data?: {
+        media?: {
+            kind?: any;
+            value?: string | undefined;
+            mime_type?: string | undefined;
+        } | undefined;
+        alt?: string | undefined;
+    } | undefined;
+    platform?: Record<string, any> | undefined;
+}>;
+export declare const replySegmentSchema: Schema<{
+    type?: "reply" | undefined;
+    data?: {
+        message_id?: string | undefined;
+    } | undefined;
+    platform?: Record<string, any> | undefined;
+}, {
+    type?: "reply" | undefined;
+    data?: {
+        message_id?: string | undefined;
+    } | undefined;
+    platform?: Record<string, any> | undefined;
+}>;
+export declare const forwardSegmentSchema: Schema<{
+    type?: "forward" | undefined;
+    data?: {
+        forward_id?: string | undefined;
+        title?: string | undefined;
+        messages?: any[][] | undefined;
+    } | undefined;
+    platform?: Record<string, any> | undefined;
+}, {
+    type?: "forward" | undefined;
+    data?: {
+        forward_id?: string | undefined;
+        title?: string | undefined;
+        messages?: any[][] | undefined;
+    } | undefined;
+    platform?: Record<string, any> | undefined;
+}>;
+export declare const faceSegmentSchema: Schema<{
+    type?: "face" | undefined;
+    data?: {
+        id?: any;
+        name?: string | undefined;
+    } | undefined;
+    platform?: Record<string, any> | undefined;
+}, {
+    type?: "face" | undefined;
+    data?: {
+        id?: any;
+        name?: string | undefined;
+    } | undefined;
+    platform?: Record<string, any> | undefined;
+}>;
+export declare const diceSegmentSchema: Schema<{
+    type?: "dice" | undefined;
+    data?: {
+        result?: number | undefined;
+    } | undefined;
+    platform?: Record<string, any> | undefined;
+}, {
+    type?: "dice" | undefined;
+    data?: {
+        result?: number | undefined;
+    } | undefined;
+    platform?: Record<string, any> | undefined;
+}>;
+export declare const rpsSegmentSchema: Schema<{
+    type?: "rps" | undefined;
+    data?: {
+        result?: number | undefined;
+    } | undefined;
+    platform?: Record<string, any> | undefined;
+}, {
+    type?: "rps" | undefined;
+    data?: {
+        result?: number | undefined;
+    } | undefined;
+    platform?: Record<string, any> | undefined;
+}>;
+export declare const canonicalSegmentSchema: Schema<any, any>;
+export declare const segmentArraySchema: Schema<any[], any[]>;
+export declare function isMediaRef(value: unknown): value is MediaRef;
+/** 严格 canonical 段校验（@zhin.js/schema validate-only） */
+export declare function isStrictCanonicalSegment(value: unknown): value is Segment;

package/lib/built/segment-contract/validate.js

@@ -0,0 +1,124 @@
+import { Schema } from '@zhin.js/schema';
+const platformSchema = Schema.dict(Schema.any());
+const mediaKindSchema = Schema.union([
+    Schema.const('url'),
+    Schema.const('path'),
+    Schema.const('base64'),
+]);
+export const mediaRefSchema = Schema.object({
+    kind: mediaKindSchema.required(),
+    value: Schema.string().required(),
+    mime_type: Schema.string(),
+});
+export const textSegmentSchema = Schema.object({
+    type: Schema.const('text'),
+    data: Schema.object({ text: Schema.string().required() }).required(),
+    platform: platformSchema,
+});
+export const mentionSegmentSchema = Schema.object({
+    type: Schema.const('mention'),
+    data: Schema.object({
+        target: Schema.string().required(),
+        name: Schema.string(),
+    }).required(),
+    platform: platformSchema,
+});
+export const imageSegmentSchema = Schema.object({
+    type: Schema.const('image'),
+    data: Schema.object({
+        media: mediaRefSchema.required(),
+        alt: Schema.string(),
+    }).required(),
+    platform: platformSchema,
+});
+export const replySegmentSchema = Schema.object({
+    type: Schema.const('reply'),
+    data: Schema.object({ message_id: Schema.string().required() }).required(),
+    platform: platformSchema,
+});
+export const forwardSegmentSchema = Schema.object({
+    type: Schema.const('forward'),
+    data: Schema.object({
+        forward_id: Schema.string().required(),
+        title: Schema.string(),
+        messages: Schema.list(Schema.list(Schema.any())),
+    }).required(),
+    platform: platformSchema,
+});
+const stringOrNumberSchema = Schema.union([
+    Schema.string(),
+    Schema.number(),
+]);
+export const faceSegmentSchema = Schema.object({
+    type: Schema.const('face'),
+    data: Schema.object({
+        id: stringOrNumberSchema.required(),
+        name: Schema.string(),
+    }).required(),
+    platform: platformSchema,
+});
+export const diceSegmentSchema = Schema.object({
+    type: Schema.const('dice'),
+    data: Schema.object({ result: Schema.number() }).required(),
+    platform: platformSchema,
+});
+export const rpsSegmentSchema = Schema.object({
+    type: Schema.const('rps'),
+    data: Schema.object({ result: Schema.number() }).required(),
+    platform: platformSchema,
+});
+export const canonicalSegmentSchema = Schema.discriminatedUnion('type', {
+    text: {
+        data: Schema.object({ text: Schema.string().required() }).required(),
+        platform: platformSchema,
+    },
+    mention: {
+        data: Schema.object({
+            target: Schema.string().required(),
+            name: Schema.string(),
+        }).required(),
+        platform: platformSchema,
+    },
+    image: {
+        data: Schema.object({
+            media: mediaRefSchema.required(),
+            alt: Schema.string(),
+        }).required(),
+        platform: platformSchema,
+    },
+    reply: {
+        data: Schema.object({ message_id: Schema.string().required() }).required(),
+        platform: platformSchema,
+    },
+    forward: {
+        data: Schema.object({
+            forward_id: Schema.string().required(),
+            title: Schema.string(),
+            messages: Schema.list(Schema.list(Schema.any())),
+        }).required(),
+        platform: platformSchema,
+    },
+    face: {
+        data: Schema.object({
+            id: stringOrNumberSchema.required(),
+            name: Schema.string(),
+        }).required(),
+        platform: platformSchema,
+    },
+    dice: {
+        data: Schema.object({ result: Schema.number() }).required(),
+        platform: platformSchema,
+    },
+    rps: {
+        data: Schema.object({ result: Schema.number() }).required(),
+        platform: platformSchema,
+    },
+});
+export const segmentArraySchema = Schema.list(canonicalSegmentSchema);
+export function isMediaRef(value) {
+    return mediaRefSchema.safeParse(value).success;
+}
+/** 严格 canonical 段校验（@zhin.js/schema validate-only） */
+export function isStrictCanonicalSegment(value) {
+    return canonicalSegmentSchema.safeParse(value).success;
+}

package/lib/built/skill.d.ts

@@ -118,4 +118,3 @@ export declare class SkillFeature extends Feature<Skill> {
      */
     toJSON(pluginName?: string): FeatureJSON;
 }
-//# sourceMappingURL=skill.d.ts.map

package/lib/built/skill.js

@@ -149,4 +149,3 @@ export class SkillFeature extends Feature {
         };
     }
 }
-//# sourceMappingURL=skill.js.map

package/lib/built/speech-loader.d.ts

@@ -5,9 +5,10 @@ export interface LoadSpeechPipelineOptions {
     getConfig?: () => Record<string, unknown> | undefined;
     warn?: (message: string) => void;
 }
+/** zhin 启动时已创建 pipeline 时注入 */
+export declare function seedSpeechPipeline(pipeline: SpeechPipelineForRichSegment): void;
 /** 动态加载 @zhin.js/speech；未安装时 warn 一次并返回 undefined */
 export declare function loadSpeechPipeline(opts?: LoadSpeechPipelineOptions): Promise<SpeechPipelineForRichSegment | undefined>;
 /** 测试用：重置加载缓存 */
 export declare function resetSpeechLoaderForTests(): void;
 export type { SpeechPipelineForRichSegment };
-//# sourceMappingURL=speech-loader.d.ts.map

package/lib/built/speech-loader.js

@@ -1,15 +1,20 @@
 import { createWarnOnce, resetWarnOnceForTests } from '@zhin.js/logger';
+import { importOptionalPeerPackage } from './optional-peer-import.js';
 /** 动态 import 时使用的包名（与 @zhin.js/speech package.json 一致） */
 export const SPEECH_PACKAGE = '@zhin.js/speech';
 let cached;
 const speechPeerWarnOnce = createWarnOnce('speech');
+/** zhin 启动时已创建 pipeline 时注入 */
+export function seedSpeechPipeline(pipeline) {
+    cached = pipeline;
+}
 /** 动态加载 @zhin.js/speech；未安装时 warn 一次并返回 undefined */
 export async function loadSpeechPipeline(opts) {
     if (cached !== undefined) {
         return cached ?? undefined;
     }
     try {
-        const mod = await import(SPEECH_PACKAGE);
+        const mod = await importOptionalPeerPackage(SPEECH_PACKAGE);
         const speechConfig = opts?.getConfig?.()?.speech;
         cached = mod.createSpeechPipeline(speechConfig);
         return cached;
@@ -25,4 +30,3 @@ export function resetSpeechLoaderForTests() {
     cached = undefined;
     resetWarnOnceForTests('speech');
 }
-//# sourceMappingURL=speech-loader.js.map

package/lib/built/tool.d.ts

@@ -147,4 +147,3 @@ export declare class ToolFeature extends Feature<Tool> {
     };
 }
 export {};
-//# sourceMappingURL=tool.d.ts.map

package/lib/built/tool.js

@@ -3,7 +3,6 @@
  * 工具仅面向 AI（通过 MCP 注册），不再与 Command 互转
  */
 import { Feature } from "@zhin.js/kernel";
-import { getPlugin } from "../plugin.js";
 import { isBuiltinPermit, isPlatformPermit } from './permit-parse.js';
 import { checkBuiltinPermit } from './permit-check.js';
 import { checkPlatformPermit } from './platform-permit.js';
@@ -386,7 +385,7 @@ export class ToolFeature extends Feature {
         const feature = this;
         return {
             addTool(tool) {
-                const plugin = getPlugin();
+                const plugin = this;
                 const toolObj = isZhinTool(tool) ? tool.toTool() : tool;
                 const dispose = feature.addTool(tool, plugin.name);
                 plugin.recordFeatureContribution(feature.name, toolObj.name);
@@ -396,4 +395,3 @@ export class ToolFeature extends Feature {
         };
     }
 }
-//# sourceMappingURL=tool.js.map

package/lib/command.d.ts

@@ -1,9 +1,9 @@
-import { MatchResult, SegmentMatcher } from "segment-matcher";
-import { AdapterMessage, SendContent } from "./types.js";
-import { RegisteredAdapter } from "./types.js";
-import type { Message } from "./message.js";
-import { MaybePromise } from "./types.js";
-import { Plugin } from "./plugin.js";
+import { MatchResult, SegmentMatcher } from 'segment-matcher';
+import { AdapterMessage, SendContent, RegisteredAdapter, MaybePromise } from './types.js';
+import type { Message } from './message.js';
+import { Plugin } from './plugin.js';
+type ConstructFirstParam<T extends new (...args: any[]) => any> = T extends new (...args: [infer U, ...any[]]) => any ? U : never;
+type ConstructSecondParam<T extends new (...args: any[]) => any> = T extends new (...args: [any, infer V, ...any[]]) => any ? V : never;
 /**
  * MessageCommand类：命令系统核心，基于segment-matcher实现。
  * 支持多平台命令注册、作用域限制、参数解析、异步处理等。
@@ -11,6 +11,7 @@ import { Plugin } from "./plugin.js";
 export declare class MessageCommand<T extends RegisteredAdapter = RegisteredAdapter> extends SegmentMatcher {
     #private;
     get helpInfo(): MessageCommand.HelpInfo;
+    constructor(C: ConstructFirstParam<typeof SegmentMatcher>, P?: ConstructSecondParam<typeof SegmentMatcher>);
     get help(): string;
     desc(...desc: string[]): MessageCommand<T>;
     usage(...usage: string[]): MessageCommand<T>;
@@ -21,6 +22,10 @@ export declare class MessageCommand<T extends RegisteredAdapter = RegisteredAdap
      */
     action(callback: MessageCommand.Callback<T>): MessageCommand<T>;
     permit(...permissions: string[]): MessageCommand<T>;
+    /** 命令要求的 permit 列表（空表示所有人可用） */
+    get requiredPermits(): readonly string[];
+    /** 与 handle 一致的 permit 校验，供帮助菜单等场景过滤不可见命令 */
+    checkPermits(message: Message<AdapterMessage<T>>, plugin: Plugin): Promise<boolean>;
     /**
      * 处理消息，自动匹配命令并执行回调
      * @param message 消息对象
@@ -39,4 +44,4 @@ export declare namespace MessageCommand {
         examples: string[];
     };
 }
-//# sourceMappingURL=command.d.ts.map
+export {};

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

@@ -564,4 +564,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 } : {}),
+    };
+}