@zhin.js/core 1.3.2 → 1.3.4

package/lib/built/interactive-segments/onebot-keyboard.js

@@ -0,0 +1,53 @@
+import { isKeyboardSegment } from './types.js';
+import { KeyboardSegment } from './keyboard-segment.js';
+/** OneBot / QQ 系 keyboard 段（各 adapter 在 $sendMessage 中识别） */
+export function keyboardToOneBotSegment(data) {
+    return {
+        type: 'keyboard',
+        data: {
+            rows: data.rows.map((row) => row.map((btn) => ({
+                label: btn.label,
+                data: btn.payload,
+                enter: false,
+                action_type: 'callback',
+                disable: !!btn.disabled,
+            }))),
+        },
+    };
+}
+/** @deprecated 使用 {@link keyboardToOneBotSegment} */
+export const interactiveToKeyboardSegment = keyboardToOneBotSegment;
+function asKeyboardData(item) {
+    if (item instanceof KeyboardSegment)
+        return item.data;
+    if (isKeyboardSegment(item))
+        return item.data;
+    return null;
+}
+/** 出站前将 core keyboard 段展开为 OneBot keyboard（保留前置 text 等段） */
+export function expandKeyboardSegmentsInContent(content) {
+    const items = Array.isArray(content) ? content : [content];
+    const out = [];
+    for (const item of items) {
+        if (typeof item === 'string') {
+            out.push(item);
+            continue;
+        }
+        if (typeof item.type !== 'string') {
+            continue;
+        }
+        const data = asKeyboardData(item);
+        if (data) {
+            out.push(keyboardToOneBotSegment(data));
+            continue;
+        }
+        out.push(item);
+    }
+    if (out.length === 0)
+        return { type: 'text', data: { text: '' } };
+    if (out.length === 1)
+        return out[0];
+    return out;
+}
+/** @deprecated 使用 {@link expandKeyboardSegmentsInContent} */
+export const expandInteractiveSegmentsInContent = expandKeyboardSegmentsInContent;

package/lib/built/interactive-segments/resolve.d.ts

@@ -0,0 +1,9 @@
+import type { SendContent } from '../../types.js';
+import { type InteractivePolicy } from './types.js';
+export declare function hasKeyboardSegment(content: SendContent | undefined): boolean;
+/** @deprecated 使用 {@link hasKeyboardSegment} */
+export declare const hasInteractiveSegment: typeof hasKeyboardSegment;
+/** 按 Adapter interactivePolicy 将 keyboard 段转为 native 保留或文本降级 */
+export declare function resolveKeyboardSegments(content: SendContent, policy: InteractivePolicy): SendContent;
+/** @deprecated 使用 {@link resolveKeyboardSegments} */
+export declare const resolveInteractiveSegments: typeof resolveKeyboardSegments;

package/lib/built/interactive-segments/resolve.js

@@ -0,0 +1,84 @@
+import { segment } from '../../utils.js';
+import { KeyboardSegment } from './keyboard-segment.js';
+import { KEYBOARD_SEGMENT_TYPE, isKeyboardSegment, } from './types.js';
+function asKeyboardData(item) {
+    if (item instanceof KeyboardSegment)
+        return item.data;
+    if (isKeyboardSegment(item))
+        return item.data;
+    return null;
+}
+function toKeyboardElement(data) {
+    return { type: KEYBOARD_SEGMENT_TYPE, data };
+}
+function asArray(content) {
+    return Array.isArray(content) ? content : [content];
+}
+function packSegments(out) {
+    if (out.length === 0)
+        return { type: 'text', data: { text: '' } };
+    if (out.length === 1)
+        return out[0];
+    return out;
+}
+function renderKeyboardAsText(data) {
+    const lines = [];
+    const flat = data.rows.flat();
+    if (data.fallback?.hint) {
+        lines.push(data.fallback.hint);
+    }
+    else {
+        lines.push('请选择（回复数字）：');
+    }
+    const map = data.fallback?.map ?? {};
+    const entries = Object.keys(map).length > 0
+        ? Object.entries(map).sort(([a], [b]) => Number(a) - Number(b))
+        : flat.map((btn, idx) => [String(idx + 1), btn.payload]);
+    for (const [key, payload] of entries) {
+        const btn = flat.find((b) => b.payload === payload);
+        const label = btn?.label ?? '·';
+        lines.push(`${key}. ${label}${btn?.disabled ? ' (不可用)' : ''}`);
+    }
+    return lines.join('\n');
+}
+export function hasKeyboardSegment(content) {
+    if (content == null)
+        return false;
+    return asArray(content).some((item) => {
+        if (typeof item === 'string')
+            return false;
+        return item instanceof KeyboardSegment || isKeyboardSegment(item);
+    });
+}
+/** @deprecated 使用 {@link hasKeyboardSegment} */
+export const hasInteractiveSegment = hasKeyboardSegment;
+/** 按 Adapter interactivePolicy 将 keyboard 段转为 native 保留或文本降级 */
+export function resolveKeyboardSegments(content, policy) {
+    if (!hasKeyboardSegment(content))
+        return content;
+    const items = asArray(content);
+    const out = [];
+    for (const item of items) {
+        if (typeof item === 'string') {
+            out.push(item);
+            continue;
+        }
+        const data = item instanceof KeyboardSegment
+            ? item.data
+            : isKeyboardSegment(item)
+                ? item.data
+                : null;
+        if (!data) {
+            out.push(item);
+            continue;
+        }
+        if (policy === 'native') {
+            out.push(toKeyboardElement(data));
+            continue;
+        }
+        out.push(segment.text(renderKeyboardAsText(data)));
+    }
+    return packSegments(out);
+}
+/** @deprecated 使用 {@link resolveKeyboardSegments} */
+export const resolveInteractiveSegments = resolveKeyboardSegments;

package/lib/built/interactive-segments/types.d.ts

@@ -0,0 +1,62 @@
+import type { MessageElement } from '../../types.js';
+export declare const KEYBOARD_SEGMENT_TYPE: "keyboard";
+/** @deprecated 使用 {@link KEYBOARD_SEGMENT_TYPE} */
+export declare const INTERACTIVE_SEGMENT_TYPE: "keyboard";
+export declare const ACTION_SEGMENT_TYPE: "action";
+export type ButtonStyle = 'primary' | 'danger' | 'secondary';
+/** @deprecated 使用 {@link ButtonStyle} */
+export type InteractiveButtonStyle = ButtonStyle;
+/** callback：平台回调 action 入站；command：QQ 指令预填后文本入站 */
+export type ButtonInteractionMode = 'callback' | 'command';
+export interface ButtonCommandOptions {
+    /** QQ action.enter — 仅单聊；预填后自动发送 */
+    enter?: boolean;
+    /** QQ action.reply — 预填时引用原消息 */
+    reply?: boolean;
+}
+export interface ButtonData {
+    id: string;
+    label: string;
+    payload: string;
+    disabled?: boolean;
+    style?: ButtonStyle;
+    /** 默认 callback */
+    mode?: ButtonInteractionMode;
+    command?: ButtonCommandOptions;
+}
+/** @deprecated 使用 {@link ButtonData} */
+export type InteractiveButton = ButtonData;
+export interface KeyboardFallback {
+    hint: string;
+    map: Record<string, string>;
+}
+/** @deprecated 使用 {@link KeyboardFallback} */
+export type InteractiveFallback = KeyboardFallback;
+export interface KeyboardSegmentData {
+    rows: ButtonData[][];
+    fallback?: KeyboardFallback;
+}
+/** @deprecated 使用 {@link KeyboardSegmentData} */
+export type InteractiveSegmentData = KeyboardSegmentData;
+export interface ActionSegmentData {
+    id: string;
+    payload: string;
+    sourceMessageId?: string;
+}
+export type InteractivePolicy = 'native' | 'text';
+export declare const DEFAULT_INTERACTIVE_POLICY: InteractivePolicy;
+export type InteractiveHandler = (message: import('../../message.js').Message<any>) => Promise<boolean> | boolean;
+export interface RegisteredInteractiveHandler {
+    prefix: string;
+    handler: InteractiveHandler;
+}
+export declare function isKeyboardSegment(item: MessageElement): item is MessageElement & {
+    type: typeof KEYBOARD_SEGMENT_TYPE;
+    data: KeyboardSegmentData;
+};
+/** @deprecated 使用 {@link isKeyboardSegment} */
+export declare const isInteractiveSegment: typeof isKeyboardSegment;
+export declare function isActionSegment(item: MessageElement): item is MessageElement & {
+    type: typeof ACTION_SEGMENT_TYPE;
+    data: ActionSegmentData;
+};

package/lib/built/interactive-segments/types.js

@@ -0,0 +1,13 @@
+export const KEYBOARD_SEGMENT_TYPE = 'keyboard';
+/** @deprecated 使用 {@link KEYBOARD_SEGMENT_TYPE} */
+export const INTERACTIVE_SEGMENT_TYPE = KEYBOARD_SEGMENT_TYPE;
+export const ACTION_SEGMENT_TYPE = 'action';
+export const DEFAULT_INTERACTIVE_POLICY = 'text';
+export function isKeyboardSegment(item) {
+    return item != null && typeof item === 'object' && 'type' in item && item.type === KEYBOARD_SEGMENT_TYPE;
+}
+/** @deprecated 使用 {@link isKeyboardSegment} */
+export const isInteractiveSegment = isKeyboardSegment;
+export function isActionSegment(item) {
+    return item != null && typeof item === 'object' && 'type' in item && item.type === ACTION_SEGMENT_TYPE;
+}

package/lib/built/introspection-format.d.ts

@@ -8,4 +8,3 @@ export interface EndpointRow {
 }
 export declare function formatEndpointsList(endpoints: EndpointRow[]): string;
 export declare function endpointHelpText(): string;
-//# sourceMappingURL=introspection-format.d.ts.map

package/lib/built/introspection-format.js

@@ -21,8 +21,8 @@ export function endpointHelpText() {
         '  /endpoint start <adapter> <name>',
         '  /endpoint stop <adapter> <name>',
         '  /endpoint cancel          — 取消进行中的添加/绑定',
+        '  /endpoint sync            — 将内存 endpoint 写回 zhin.config',
         '  /endpoint help',
         '  /endpoints                — 查看运行时在线状态',
     ].join('\n');
 }
-//# sourceMappingURL=introspection-format.js.map

package/lib/built/login-assist.d.ts

@@ -58,4 +58,3 @@ declare module '../plugin.js' {
         }
     }
 }
-//# sourceMappingURL=login-assist.d.ts.map

package/lib/built/login-assist.js

@@ -72,4 +72,3 @@ export class LoginAssist {
         this.pending.clear();
     }
 }
-//# sourceMappingURL=login-assist.js.map

package/lib/built/management-command-guard.d.ts

@@ -5,7 +5,11 @@ import { resolveSenderRoles, type AITriggerConfig } from './ai-trigger.js';
 import type { Message } from '../message.js';
 import type { Plugin } from '../plugin.js';
 export declare const MANAGEMENT_COMMAND_DENIED = "\u26A0\uFE0F \u8BE5\u547D\u4EE4\u4EC5 Endpoint Owner\uFF08master\uFF09\u6216 trusted \u64CD\u4F5C\u5458\u53EF\u7528\u3002";
+/** 运维 / 内省 / Endpoint 管理命令：仅 master 或 trusted 可执行与展示 */
+export declare const MANAGEMENT_OPERATOR_PERMIT: "role(master,trusted)";
+/** Endpoint Owner 私聊专用命令（如 /approve） */
+export declare const OWNER_OPERATOR_PERMIT: "role(master)";
+export declare const OWNER_PRIVATE_PERMITS: readonly ["role(master)", "private(*)"];
 export declare function resolveManagementCommandRoles(message: Message, root: Plugin, triggerConfig?: AITriggerConfig): ReturnType<typeof resolveSenderRoles>['roles'];
 /** 通过返回 null；拒绝返回用户可见提示文案 */
 export declare function rejectUnlessManagementOperator(message: Message, root: Plugin, triggerConfig?: AITriggerConfig): string | null;
-//# sourceMappingURL=management-command-guard.d.ts.map

package/lib/built/management-command-guard.js

@@ -4,6 +4,11 @@
 import { mergeAITriggerConfig, resolveSenderRoles, } from './ai-trigger.js';
 import { hasSenderRole } from './roles.js';
 export const MANAGEMENT_COMMAND_DENIED = '⚠️ 该命令仅 Endpoint Owner（master）或 trusted 操作员可用。';
+/** 运维 / 内省 / Endpoint 管理命令：仅 master 或 trusted 可执行与展示 */
+export const MANAGEMENT_OPERATOR_PERMIT = 'role(master,trusted)';
+/** Endpoint Owner 私聊专用命令（如 /approve） */
+export const OWNER_OPERATOR_PERMIT = 'role(master)';
+export const OWNER_PRIVATE_PERMITS = [OWNER_OPERATOR_PERMIT, 'private(*)'];
 export function resolveManagementCommandRoles(message, root, triggerConfig) {
     const cfg = mergeAITriggerConfig(triggerConfig ?? {});
     const adapterInstance = root.inject(message.$adapter);
@@ -18,4 +23,3 @@ export function rejectUnlessManagementOperator(message, root, triggerConfig) {
     }
     return MANAGEMENT_COMMAND_DENIED;
 }
-//# sourceMappingURL=management-command-guard.js.map

package/lib/built/message-enrich.d.ts

@@ -5,7 +5,7 @@ import type { Plugin } from '../plugin.js';
 import { Message, type MessageChannel } from '../message.js';
 import type { Adapters } from '../adapter.js';
 import type { SendContent } from '../types.js';
-import type { SenderRole } from './roles.js';
+import { type SenderRole } from './roles.js';
 /** Agent turn 可挂载在 Message 扩展字段上的元数据 */
 export type AgentTurnMessage = Message<{
     extra?: Record<string, unknown>;
@@ -37,4 +37,3 @@ export declare function createSyntheticMessage(input: SyntheticMessageInput): Ag
 export declare function commMessageFromHookContext(context: Record<string, unknown>): Message<any> | undefined;
 /** 兼容 tool parameters 上的 contextKey（endpointId / sceneId / scope 等） */
 export declare function resolveContextKey(message: Message<any>, key: string): unknown;
-//# sourceMappingURL=message-enrich.d.ts.map

package/lib/built/message-enrich.js

@@ -79,4 +79,3 @@ export function resolveContextKey(message, key) {
         }
     }
 }
-//# sourceMappingURL=message-enrich.js.map

package/lib/built/message-filter.d.ts

@@ -174,4 +174,3 @@ export declare class MessageFilterFeature extends Feature<FilterRule> {
         setDefaultFilterPolicy(policy: FilterAction): void;
     };
 }
-//# sourceMappingURL=message-filter.d.ts.map

package/lib/built/message-filter.js

@@ -13,7 +13,6 @@
  *   - 插件通过 `addFilterRule()` 动态注册规则，卸载时自动清理
  */
 import { Feature } from '@zhin.js/kernel';
-import { getPlugin } from '../plugin.js';
 // ============================================================================
 // 规则工厂
 // ============================================================================
@@ -155,7 +154,7 @@ export class MessageFilterFeature extends Feature {
         const feature = this;
         return {
             addFilterRule(rule) {
-                const plugin = getPlugin();
+                const plugin = this;
                 const dispose = feature.add(rule, plugin.name);
                 plugin.recordFeatureContribution(feature.name, rule.name);
                 plugin.onDispose(dispose);
@@ -238,4 +237,3 @@ export class MessageFilterFeature extends Feature {
         });
     }
 }
-//# sourceMappingURL=message-filter.js.map

package/lib/built/optional-peer-import.d.ts

@@ -0,0 +1,3 @@
+/** 从应用根（ZHIN_PROJECT_ROOT / cwd）解析 optional peer，避免 core 包目录下 dynamic import 失败 */
+export declare function resolveOptionalPeerPackage(packageName: string): string | undefined;
+export declare function importOptionalPeerPackage<T = Record<string, unknown>>(packageName: string): Promise<T>;

package/lib/built/optional-peer-import.js

@@ -0,0 +1,33 @@
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+/** 从应用根（ZHIN_PROJECT_ROOT / cwd）解析 optional peer，避免 core 包目录下 dynamic import 失败 */
+export function resolveOptionalPeerPackage(packageName) {
+    const roots = new Set();
+    const envRoot = process.env.ZHIN_PROJECT_ROOT?.trim();
+    if (envRoot)
+        roots.add(path.resolve(envRoot));
+    roots.add(process.cwd());
+    for (const root of roots) {
+        try {
+            const req = createRequire(path.join(root, 'package.json'));
+            return req.resolve(packageName);
+        }
+        catch {
+            // try next root
+        }
+    }
+    try {
+        return createRequire(import.meta.url).resolve(packageName);
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function importOptionalPeerPackage(packageName) {
+    const resolved = resolveOptionalPeerPackage(packageName);
+    if (resolved) {
+        return import(pathToFileURL(resolved).href);
+    }
+    return import(packageName);
+}

package/lib/built/outbound-media-contract.d.ts

@@ -20,4 +20,3 @@ export type OutboundMediaMaterializer = (content: SendContent, ctx: OutboundMedi
 export declare function assertAdapterDeclaresRichSegmentPolicy(adapterClass: {
     outboundRichSegmentPolicy?: Record<string, string>;
 }): void;
-//# sourceMappingURL=outbound-media-contract.d.ts.map

package/lib/built/outbound-media-contract.js

@@ -8,4 +8,3 @@ export function assertAdapterDeclaresRichSegmentPolicy(adapterClass) {
         throw new Error('outboundRichSegmentPolicy must be a non-empty object');
     }
 }
-//# sourceMappingURL=outbound-media-contract.js.map

package/lib/built/outbound-media-utils.d.ts

@@ -7,4 +7,3 @@ export declare function resolveLocalMediaPath(data: Record<string, unknown>): st
 export declare function asMessageElements(content: SendContent): MessageElement[];
 export declare function isMediaSegmentType(type: string): boolean;
 export declare function collectOutboundMediaKinds(content: SendContent | undefined): string[];
-//# sourceMappingURL=outbound-media-utils.d.ts.map

package/lib/built/outbound-media-utils.js

@@ -60,4 +60,3 @@ export function collectOutboundMediaKinds(content) {
     }
     return [...kinds];
 }
-//# sourceMappingURL=outbound-media-utils.js.map

package/lib/built/permission.d.ts

@@ -53,4 +53,3 @@ export declare namespace Permissions {
  * @deprecated Use PermissionFeature instead
  */
 export declare const PermissionService: typeof PermissionFeature;
-//# sourceMappingURL=permission.d.ts.map

package/lib/built/permission.js

@@ -4,7 +4,6 @@
  */
 import { Feature } from "@zhin.js/kernel";
 import logger, { formatCompact } from "@zhin.js/logger";
-import { getPlugin } from "../plugin.js";
 import { isBuiltinPermit, parsePermitName } from "./permit-parse.js";
 import { checkBuiltinPermit } from "./permit-check.js";
 import { senderRolesFromMessage } from "./message-enrich.js";
@@ -81,7 +80,7 @@ export class PermissionFeature extends Feature {
         const feature = this;
         return {
             addPermission(permission) {
-                const plugin = getPlugin();
+                const plugin = this;
                 const dispose = feature.add(permission, plugin.name);
                 const permName = permission.name instanceof RegExp ? permission.name.source : permission.name;
                 plugin.recordFeatureContribution(feature.name, permName);
@@ -102,4 +101,3 @@ export var Permissions;
  * @deprecated Use PermissionFeature instead
  */
 export const PermissionService = PermissionFeature;
-//# sourceMappingURL=permission.js.map

package/lib/built/permit-check.d.ts

@@ -2,7 +2,6 @@
  * 内置 permit 同步校验（adapter/group/private/channel/user/role）
  */
 import type { Message } from '../message.js';
-import type { SenderRole } from './roles.js';
+import { type SenderRole } from './roles.js';
 export declare function checkBuiltinPermit(name: string, message: Message<any>, roles: readonly SenderRole[]): boolean;
 export declare function checkBuiltinPermitList(permits: readonly string[], message: Message<any>, roles: readonly SenderRole[]): boolean;
-//# sourceMappingURL=permit-check.d.ts.map

package/lib/built/permit-check.js

@@ -33,4 +33,3 @@ export function checkBuiltinPermit(name, message, roles) {
 export function checkBuiltinPermitList(permits, message, roles) {
     return permits.every((p) => checkBuiltinPermit(p, message, roles));
 }
-//# sourceMappingURL=permit-check.js.map

package/lib/built/permit-parse.d.ts

@@ -14,4 +14,3 @@ export interface ParsedPlatformPermit {
 }
 export declare function parsePlatformPermitName(name: string): ParsedPlatformPermit | null;
 export declare function isPlatformPermit(name: string): boolean;
-//# sourceMappingURL=permit-parse.d.ts.map

package/lib/built/permit-parse.js

@@ -30,4 +30,3 @@ export function parsePlatformPermitName(name) {
 export function isPlatformPermit(name) {
     return PLATFORM_PERMIT_RE.test(name);
 }
-//# sourceMappingURL=permit-parse.js.map

package/lib/built/platform-permit.d.ts

@@ -1,5 +1,5 @@
 /**
- * Platform permit — 适配器注册的平台级权限校验（群管、频道身份等）
+ * Platform permit — 适配器注册的平台级权限校验（场景治理、频道身份等）
  */
 import type { Message } from '../message.js';
 export type PlatformPermitChecker = (perm: string, message: Message<any>) => boolean;
@@ -14,8 +14,7 @@ export declare function applyQqSenderRoleToMessageSender(sender: {
     role?: string;
     permissions?: string[];
 }, role?: string): void;
-/** 常见 IM 平台群身份：$sender.role 为 owner / admin */
-export declare function createGroupRolePlatformChecker(): PlatformPermitChecker;
-/** 为适配器注册默认群管 platform checker（幂等） */
-export declare function registerDefaultGroupPlatformPermitChecker(adapter: string): () => void;
-//# sourceMappingURL=platform-permit.d.ts.map
+/** 常见 IM 平台场景身份：$sender.role 为 owner / admin */
+export declare function createSceneRolePlatformChecker(): PlatformPermitChecker;
+/** 为适配器注册默认场景治理 platform checker（幂等） */
+export declare function registerDefaultScenePlatformPermitChecker(adapter: string): () => void;

package/lib/built/platform-permit.js

@@ -1,6 +1,6 @@
 import { parsePlatformPermitName, isPlatformPermit } from './permit-parse.js';
 const checkers = new Map();
-const registeredDefaultGroupCheckers = new Set();
+const registeredDefaultSceneCheckers = new Set();
 export function registerPlatformPermitChecker(adapter, checker) {
     const key = String(adapter);
     checkers.set(key, checker);
@@ -12,7 +12,7 @@ export function registerPlatformPermitChecker(adapter, checker) {
 }
 export function clearPlatformPermitCheckers() {
     checkers.clear();
-    registeredDefaultGroupCheckers.clear();
+    registeredDefaultSceneCheckers.clear();
 }
 export function checkPlatformPermit(name, message) {
     const parsed = parsePlatformPermitName(name);
@@ -44,24 +44,23 @@ export function applyQqSenderRoleToMessageSender(sender, role) {
     sender.role = normalized;
     sender.permissions = [normalized];
 }
-/** 常见 IM 平台群身份：$sender.role 为 owner / admin */
-export function createGroupRolePlatformChecker() {
+/** 常见 IM 平台场景身份：$sender.role 为 owner / admin */
+export function createSceneRolePlatformChecker() {
     return (perm, message) => {
         const role = message.$sender?.role;
-        if (perm === 'group_admin')
+        if (perm === 'scene_admin')
             return role === 'admin' || role === 'owner';
-        if (perm === 'group_owner')
+        if (perm === 'scene_owner')
             return role === 'owner';
         return false;
     };
 }
-/** 为适配器注册默认群管 platform checker（幂等） */
-export function registerDefaultGroupPlatformPermitChecker(adapter) {
+/** 为适配器注册默认场景治理 platform checker（幂等） */
+export function registerDefaultScenePlatformPermitChecker(adapter) {
     const key = String(adapter);
-    if (registeredDefaultGroupCheckers.has(key)) {
+    if (registeredDefaultSceneCheckers.has(key)) {
         return () => { };
     }
-    registeredDefaultGroupCheckers.add(key);
-    return registerPlatformPermitChecker(key, createGroupRolePlatformChecker());
+    registeredDefaultSceneCheckers.add(key);
+    return registerPlatformPermitChecker(key, createSceneRolePlatformChecker());
 }
-//# sourceMappingURL=platform-permit.js.map

package/lib/built/prepend-quote-context.d.ts

@@ -32,4 +32,3 @@ export declare function resolveQuoteContextBlock(message: Message<any>, root: Pl
 export declare function prependQuoteContext(message: Message<any>, root: Plugin, userText: string, options?: {
     enabled?: boolean;
 }): Promise<string>;
-//# sourceMappingURL=prepend-quote-context.d.ts.map

package/lib/built/prepend-quote-context.js

@@ -128,4 +128,3 @@ export async function prependQuoteContext(message, root, userText, options) {
     const quoteBlock = await resolveQuoteContextBlock(message, root, options);
     return buildUserTurnWithQuoteContext(userText, quoteBlock);
 }
-//# sourceMappingURL=prepend-quote-context.js.map

package/lib/built/qrcode-segment.d.ts

@@ -16,4 +16,3 @@ export declare function resolveQrcodeSegmentsToImages(content: SendContent | und
 export declare function resolveQrcodeSegmentsToTerminal(content: SendContent | undefined): Promise<SendContent | undefined>;
 /** 不支持图片的平台：仅输出链接文本 */
 export declare function coerceQrcodeSegmentsToText(content: SendContent): SendContent;
-//# sourceMappingURL=qrcode-segment.d.ts.map

package/lib/built/qrcode-segment.js

@@ -76,4 +76,3 @@ export function coerceQrcodeSegmentsToText(content) {
     }
     return packSegments(out);
 }
-//# sourceMappingURL=qrcode-segment.js.map

package/lib/built/queue-im-field-contract.d.ts

@@ -1,5 +1,6 @@
 import type { MessageType } from '../message.js';
 import type { SendContent, SendOptions } from '../types.js';
+import { type IMDeliveryTarget } from '../im-scene.js';
 export interface QueueEnvelope<TDetail extends Record<string, unknown> = Record<string, unknown>> {
     kind: string;
     type: string;
@@ -23,5 +24,9 @@ export declare function isMessageType(value: unknown): value is MessageType;
 /** Normalize queue outbound detail into the canonical queue-IM shape. */
 export declare function normalizeQueueOutboundDetail(record: Record<string, unknown>): NormalizedQueueOutboundDetail;
 export declare function toSendOptions(detail: NormalizedQueueOutboundDetail): SendOptions;
+export interface QueueIMSceneTargetDetail {
+    target: IMDeliveryTarget;
+    content: SendContent;
+}
+export declare function sceneTargetToSendOptions(detail: QueueIMSceneTargetDetail): SendOptions;
 export declare function normalizeRecordToSendOptions(record: Record<string, unknown>): SendOptions;
-//# sourceMappingURL=queue-im-field-contract.d.ts.map

package/lib/built/queue-im-field-contract.js

@@ -1,3 +1,4 @@
+import { sceneRefToSendOptions } from '../im-scene.js';
 export class QueueIMFieldContractError extends Error {
     code;
     field;
@@ -52,7 +53,15 @@ export function toSendOptions(detail) {
         content: detail.content,
     };
 }
+export function sceneTargetToSendOptions(detail) {
+    return sceneRefToSendOptions(detail.target, detail.content);
+}
 export function normalizeRecordToSendOptions(record) {
+    if (record.target && typeof record.target === 'object') {
+        return sceneTargetToSendOptions({
+            target: record.target,
+            content: requireContent(record.content),
+        });
+    }
     return toSendOptions(normalizeQueueOutboundDetail(record));
 }
-//# sourceMappingURL=queue-im-field-contract.js.map

package/lib/built/rich-segments/adapter-policies.d.ts

@@ -1,4 +1,4 @@
-import type { OutboundRichSegmentPolicy } from './types.js';
+import { type OutboundRichSegmentPolicy } from './types.js';
 /** 全功能 IM：html/markdown/qrcode→image，tts→audio */
 export declare const OUTBOUND_RICH_SEGMENT_POLICY_IM_FULL: OutboundRichSegmentPolicy;
 /** 仅文本降级（无富媒体出站能力） */
@@ -7,4 +7,3 @@ export declare const OUTBOUND_RICH_SEGMENT_POLICY_TEXT_ONLY: OutboundRichSegment
 export declare const OUTBOUND_RICH_SEGMENT_POLICY_IM_DEFAULT: OutboundRichSegmentPolicy;
 /** 无音频出站（tts 降级 text） */
 export declare const OUTBOUND_RICH_SEGMENT_POLICY_NO_AUDIO: OutboundRichSegmentPolicy;
-//# sourceMappingURL=adapter-policies.d.ts.map

package/lib/built/rich-segments/adapter-policies.js

@@ -25,4 +25,3 @@ export const OUTBOUND_RICH_SEGMENT_POLICY_NO_AUDIO = {
     ...OUTBOUND_RICH_SEGMENT_POLICY_IM_FULL,
     [BUILTIN_RICH_SEGMENT_KINDS.TTS]: RICH_SEGMENT_MODE.TEXT,
 };
-//# sourceMappingURL=adapter-policies.js.map

package/lib/built/rich-segments/base.d.ts

@@ -9,4 +9,3 @@ export declare abstract class RichSegment<TData> {
 }
 export declare function isRichSegment(item: unknown): item is RichSegment<unknown>;
 export declare function richSegmentKind(item: MessageElement | string): string | null;
-//# sourceMappingURL=base.d.ts.map

package/lib/built/rich-segments/base.js

@@ -22,4 +22,3 @@ export function richSegmentKind(item) {
     }
     return null;
 }
-//# sourceMappingURL=base.js.map

package/lib/built/rich-segments/builtins.d.ts

@@ -2,4 +2,3 @@
 export declare const DEFAULT_OUTBOUND_RICH_SEGMENT_POLICY: import("./types.js").OutboundRichSegmentPolicy;
 /** 测试：清空 registry 后重新注册内置 kind */
 export declare function resetBuiltinRichSegmentKindsForTests(): void;
-//# sourceMappingURL=builtins.d.ts.map

package/lib/built/rich-segments/builtins.js

@@ -38,4 +38,3 @@ export function resetBuiltinRichSegmentKindsForTests() {
     richSegmentRegistry.clearForTests();
     registerBuiltinRichSegmentKinds();
 }
-//# sourceMappingURL=builtins.js.map