@zhin.js/core 1.1.33 → 1.1.35

package/lib/built/ai-outbound/extensions/onebot-keyboard.js

@@ -0,0 +1,67 @@
+import { KeyboardSegment } from '../../interactive-segments/keyboard-segment.js';
+const ONEBOT_KEYBOARD_SCHEMA = {
+    type: 'object',
+    properties: {
+        rows: {
+            type: 'array',
+            items: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        label: { type: 'string' },
+                        payload: { type: 'string' },
+                        id: { type: 'string' },
+                    },
+                    required: ['label', 'payload'],
+                },
+            },
+        },
+    },
+    required: ['rows'],
+};
+function toKeyboardSegment(ext) {
+    if (!ext || typeof ext !== 'object')
+        return null;
+    const obj = ext;
+    const rowsRaw = obj.rows;
+    if (!Array.isArray(rowsRaw))
+        return null;
+    const rows = [];
+    for (const row of rowsRaw) {
+        if (!Array.isArray(row))
+            continue;
+        const buttons = [];
+        for (const btn of row) {
+            if (!btn || typeof btn !== 'object')
+                continue;
+            const b = btn;
+            const label = typeof b.label === 'string' ? b.label : '';
+            const payload = typeof b.payload === 'string' ? b.payload : '';
+            if (!label || !payload)
+                continue;
+            buttons.push({
+                id: typeof b.id === 'string' ? b.id : payload,
+                label,
+                payload,
+                disabled: b.disabled === true,
+            });
+        }
+        if (buttons.length)
+            rows.push(buttons);
+    }
+    if (!rows.length)
+        return null;
+    return new KeyboardSegment({ rows }).toElement();
+}
+export const ONEBOT_KEYBOARD_AI_OUTBOUND_EXTENSION = {
+    key: 'onebot.keyboard',
+    schema: ONEBOT_KEYBOARD_SCHEMA,
+    examples: [
+        '{"extensions":{"onebot.keyboard":{"rows":[[{"label":"确认","payload":"ok","id":"ok"}]]}}}',
+    ],
+    toMessageElements(ext, _ctx) {
+        const seg = toKeyboardSegment(ext);
+        return seg ? [seg] : [];
+    },
+};

package/lib/built/ai-outbound/extensions/qq-message.d.ts

@@ -0,0 +1,3 @@
+import type { AiOutboundExtensionDefinition } from '../types.js';
+export declare const QQ_MARKDOWN_AI_OUTBOUND_EXTENSION: AiOutboundExtensionDefinition;
+export declare const QQ_AI_OUTBOUND_EXTENSIONS: readonly AiOutboundExtensionDefinition[];

package/lib/built/ai-outbound/extensions/qq-message.js

@@ -0,0 +1,23 @@
+const QQ_MARKDOWN_SCHEMA = {
+    type: 'object',
+    properties: {
+        content: { type: 'string' },
+    },
+    required: ['content'],
+};
+export const QQ_MARKDOWN_AI_OUTBOUND_EXTENSION = {
+    key: 'qq.markdown',
+    schema: QQ_MARKDOWN_SCHEMA,
+    examples: ['{"extensions":{"qq.markdown":{"content":"# Title\\nBody"}}}'],
+    toMessageElements(ext, _ctx) {
+        if (!ext || typeof ext !== 'object')
+            return [];
+        const content = ext.content;
+        if (typeof content !== 'string' || !content.trim())
+            return [];
+        return [{ type: 'markdown', data: { content: content.trim() } }];
+    },
+};
+export const QQ_AI_OUTBOUND_EXTENSIONS = [
+    QQ_MARKDOWN_AI_OUTBOUND_EXTENSION,
+];

package/lib/built/ai-outbound/index.d.ts

@@ -0,0 +1,9 @@
+export * from './types.js';
+export * from './parse.js';
+export * from './plain-mention-rewrite.js';
+export * from './resolve.js';
+export * from './prompt.js';
+export * from './structured-detect.js';
+export * from './adapter-access.js';
+export * from './extensions/onebot-keyboard.js';
+export * from './extensions/qq-message.js';

package/lib/built/ai-outbound/index.js

@@ -0,0 +1,9 @@
+export * from './types.js';
+export * from './parse.js';
+export * from './plain-mention-rewrite.js';
+export * from './resolve.js';
+export * from './prompt.js';
+export * from './structured-detect.js';
+export * from './adapter-access.js';
+export * from './extensions/onebot-keyboard.js';
+export * from './extensions/qq-message.js';

package/lib/built/ai-outbound/parse.d.ts

@@ -0,0 +1,13 @@
+import type { Segment } from '../segment-contract/types.js';
+import type { ZhinAiOutboundPayload } from './types.js';
+/** 解析单条 outbound segment（canonical type/data 形态）。 */
+export declare function parseOutboundSegment(raw: unknown): Segment | null;
+/** 去掉嵌入 JSON 候选末尾的 markdown 围栏（模型常见 ```json … ``` 误输出）。 */
+export declare function trimTrailingMarkdownFence(raw: string): string;
+export declare function unwrapAiOutboundJsonCandidate(raw: string): string;
+/** Extract an embedded AI outbound JSON object from mixed prose. */
+export declare function extractEmbeddedAiOutboundJson(plain: string): {
+    prose: string;
+    jsonRaw: string;
+} | null;
+export declare function parseAiOutboundJson(raw: string): ZhinAiOutboundPayload | null;

package/lib/built/ai-outbound/parse.js

@@ -0,0 +1,104 @@
+import { isCanonicalSegment } from '../segment-contract/assert.js';
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** 解析单条 outbound segment（canonical type/data 形态）。 */
+export function parseOutboundSegment(raw) {
+    if (!isPlainObject(raw))
+        return null;
+    const type = typeof raw.type === 'string' && raw.type.trim() ? raw.type.trim() : undefined;
+    if (!type)
+        return null;
+    const data = isPlainObject(raw.data) ? raw.data : {};
+    const platform = isPlainObject(raw.platform) ? raw.platform : undefined;
+    const segment = platform ? { type, data, platform } : { type, data };
+    return isCanonicalSegment(segment) ? segment : null;
+}
+/** 去掉嵌入 JSON 候选末尾的 markdown 围栏（模型常见 ```json … ``` 误输出）。 */
+export function trimTrailingMarkdownFence(raw) {
+    let s = raw.trim();
+    if (s.endsWith('```'))
+        s = s.slice(0, -3).trimEnd();
+    return s;
+}
+export function unwrapAiOutboundJsonCandidate(raw) {
+    const trimmed = raw.trim();
+    const fenced = readMarkdownFence(trimmed);
+    if (fenced && fenced.full)
+        return fenced.body.trim();
+    if (fenced && trimmed.indexOf('{') >= 0) {
+        return trimTrailingMarkdownFence(fenced.body.trim());
+    }
+    return trimTrailingMarkdownFence(trimmed);
+}
+/** Extract an embedded AI outbound JSON object from mixed prose. */
+export function extractEmbeddedAiOutboundJson(plain) {
+    const trimmed = plain.trim();
+    if (!trimmed.includes('{'))
+        return null;
+    const fenced = readMarkdownFence(trimmed);
+    if (fenced) {
+        const jsonRaw = trimTrailingMarkdownFence(fenced.body.trim());
+        const payload = parseAiOutboundJson(jsonRaw);
+        if (payload?.mentions?.length && payload.text?.trim()) {
+            const prose = trimmed.slice(0, fenced.start).trim();
+            return { prose, jsonRaw };
+        }
+    }
+    let idx = trimmed.indexOf('{');
+    while (idx >= 0) {
+        const jsonRaw = trimTrailingMarkdownFence(trimmed.slice(idx).trim());
+        const payload = parseAiOutboundJson(jsonRaw);
+        if (payload?.mentions?.length && payload.text?.trim()) {
+            return { prose: trimmed.slice(0, idx).trim(), jsonRaw };
+        }
+        idx = trimmed.indexOf('{', idx + 1);
+    }
+    return null;
+}
+function readMarkdownFence(text) {
+    const start = text.indexOf('```');
+    if (start < 0)
+        return null;
+    let bodyStart = start + 3;
+    const langEnd = text.indexOf('\n', bodyStart);
+    if (langEnd >= 0) {
+        const lang = text.slice(bodyStart, langEnd).trim().toLowerCase();
+        if (lang === '' || lang === 'json')
+            bodyStart = langEnd + 1;
+    }
+    const end = text.indexOf('```', bodyStart);
+    if (end < 0)
+        return null;
+    return { start, body: text.slice(bodyStart, end), full: start === 0 && text.slice(end + 3).trim() === '' };
+}
+export function parseAiOutboundJson(raw) {
+    const candidate = unwrapAiOutboundJsonCandidate(raw);
+    if (!candidate.startsWith('{'))
+        return null;
+    try {
+        const parsed = JSON.parse(candidate);
+        const text = typeof parsed.text === 'string' ? parsed.text.trim() : undefined;
+        const mentionsRaw = parsed.mentions;
+        const mentions = Array.isArray(mentionsRaw)
+            ? mentionsRaw.map((m) => String(m).trim()).filter(Boolean)
+            : undefined;
+        const segmentsRaw = parsed.segments;
+        const segments = Array.isArray(segmentsRaw)
+            ? segmentsRaw
+                .map((item) => parseOutboundSegment(item))
+                .filter((s) => s != null)
+            : undefined;
+        const extensions = parsed.extensions != null && typeof parsed.extensions === 'object' && !Array.isArray(parsed.extensions)
+            ? parsed.extensions
+            : undefined;
+        if (!text && !mentions?.length && !segments?.length && !extensions)
+            return null;
+        if (mentions?.length && !text)
+            return null;
+        return { text, mentions, segments, extensions };
+    }
+    catch {
+        return null;
+    }
+}

package/lib/built/ai-outbound/plain-mention-rewrite.d.ts

@@ -0,0 +1,6 @@
+import type { AiOutboundMentionResolver, ZhinAiOutboundPayload } from './types.js';
+/**
+ * 从正文中提取 cell roster 可识别的假 @（@researcher / @210723495 等），
+ * 剥离后返回等效 ZhinAiOutboundPayload。
+ */
+export declare function rewritePlainTextMentions(plainText: string, mentionResolver: AiOutboundMentionResolver): ZhinAiOutboundPayload | null;

package/lib/built/ai-outbound/plain-mention-rewrite.js

@@ -0,0 +1,37 @@
+const PLAIN_MENTION_PATTERN = /@([\w-]+)/g;
+/**
+ * 从正文中提取 cell roster 可识别的假 @（@researcher / @210723495 等），
+ * 剥离后返回等效 ZhinAiOutboundPayload。
+ */
+export function rewritePlainTextMentions(plainText, mentionResolver) {
+    const trimmed = plainText.trim();
+    if (!trimmed)
+        return null;
+    const mentions = [];
+    let rewritten = trimmed;
+    for (const match of trimmed.matchAll(PLAIN_MENTION_PATTERN)) {
+        const token = match[1];
+        if (!token)
+            continue;
+        const endpointKey = mentionResolver(token);
+        if (!endpointKey)
+            continue;
+        const ref = token;
+        if (!mentions.includes(ref))
+            mentions.push(ref);
+    }
+    if (mentions.length === 0)
+        return null;
+    rewritten = trimmed.replace(PLAIN_MENTION_PATTERN, (full, token) => {
+        const endpointKey = mentionResolver(token);
+        return endpointKey ? '' : full;
+    });
+    rewritten = rewritten
+        .replace(/[ \t]+\n/g, '\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .replace(/^\s+|\s+$/g, '')
+        .trim();
+    if (!rewritten)
+        return null;
+    return { mentions, text: rewritten };
+}

package/lib/built/ai-outbound/prompt.d.ts

@@ -0,0 +1,11 @@
+import type { AiOutboundCapabilities, AiOutboundExtensionDefinition } from './types.js';
+export declare const AI_OUTBOUND_JSON_EXAMPLE = "{\"mentions\":[\"researcher\",\"210723495\"],\"text\":\"\u6B63\u6587\"}";
+export declare function buildCoreAiOutboundPromptHint(capabilities?: AiOutboundCapabilities): string;
+export declare function buildAiOutboundPromptHint(input: {
+    capabilities?: AiOutboundCapabilities;
+    extensions?: readonly AiOutboundExtensionDefinition[];
+    rosterLines?: string[];
+    forceJsonOnly?: boolean;
+}): string;
+/** Detect whether inbound text explicitly requests a structured handoff. */
+export declare function detectInboundHandoffIntent(content: string): boolean;

package/lib/built/ai-outbound/prompt.js

@@ -0,0 +1,44 @@
+export const AI_OUTBOUND_JSON_EXAMPLE = '{"mentions":["researcher","210723495"],"text":"正文"}';
+export function buildCoreAiOutboundPromptHint(capabilities) {
+    const lines = [
+        'When your reply must @ peers, send rich media, buttons, or delegate — output JSON only (no Markdown wrapper):',
+        AI_OUTBOUND_JSON_EXAMPLE,
+        'mentions: peer endpoint ID or pipelineRole; text: message body.',
+        'Do NOT write "@researcher" in plain text — the framework converts JSON mentions to real platform @ segments.',
+    ];
+    if (capabilities?.richSegments?.length) {
+        lines.push(`Rich segments (optional "segments" array): ${capabilities.richSegments.join(', ')}.`);
+    }
+    if (capabilities?.interactive === 'native') {
+        lines.push('Interactive buttons: use extensions field per adapter schema.');
+    }
+    return lines.join('\n');
+}
+export function buildAiOutboundPromptHint(input) {
+    const lines = [];
+    if (input.rosterLines?.length) {
+        lines.push(...input.rosterLines);
+    }
+    lines.push(buildCoreAiOutboundPromptHint(input.capabilities));
+    if (input.extensions?.length) {
+        lines.push('Adapter extensions (optional "extensions" object):');
+        for (const ext of input.extensions) {
+            lines.push(`- ${ext.key}: see platform schema`);
+            if (ext.examples[0])
+                lines.push(`  example: ${ext.examples[0]}`);
+        }
+    }
+    if (input.forceJsonOnly) {
+        lines.push('MUST reply with JSON only when @ peers or handoff — no Markdown body with plain "@role" text.');
+    }
+    return lines.join('\n');
+}
+/** Detect whether inbound text explicitly requests a structured handoff. */
+export function detectInboundHandoffIntent(content) {
+    const t = content.trim();
+    if (!t)
+        return false;
+    if (t.includes('@'))
+        return true;
+    return /依次|自我介绍|叫大家|请各位|handoff|delegate/i.test(t);
+}

package/lib/built/ai-outbound/resolve.d.ts

@@ -0,0 +1,4 @@
+import type { MessageElement } from '../../types.js';
+import type { AiOutboundParseContext, ZhinAiOutboundPayload } from './types.js';
+/** 将 ZhinAiOutboundPayload 转为 MessageElement[]（canonical segments + extensions）。 */
+export declare function resolveAiOutboundToMessageElements(payload: ZhinAiOutboundPayload, ctx: AiOutboundParseContext): Promise<MessageElement[] | null>;

package/lib/built/ai-outbound/resolve.js

@@ -0,0 +1,64 @@
+import { segmentsForImDelivery } from '../segment-contract/delivery.js';
+function buildMentionSegments(endpointKeys, text, ctx) {
+    const segments = [];
+    for (const endpointKey of endpointKeys) {
+        const target = ctx.atIdResolver?.(endpointKey) ?? endpointKey;
+        segments.push({ type: 'mention', data: { target } });
+    }
+    const body = text.trim();
+    segments.push({
+        type: 'text',
+        data: { text: body.startsWith(' ') ? body : ` ${body}` },
+    });
+    return segments;
+}
+function resolveMentionEndpointIds(mentions, ctx) {
+    if (!mentions?.length) {
+        return { ok: false, error: 'mentions 不能为空' };
+    }
+    if (!ctx.mentionResolver) {
+        return { ok: false, error: 'mentionResolver 未配置' };
+    }
+    const endpointKeys = [];
+    for (const ref of mentions) {
+        const resolved = ctx.mentionResolver(ref);
+        if (!resolved) {
+            return { ok: false, error: `未知 peer "${ref}"` };
+        }
+        if (!endpointKeys.includes(resolved))
+            endpointKeys.push(resolved);
+    }
+    return { ok: true, endpointKeys };
+}
+/** 将 ZhinAiOutboundPayload 转为 MessageElement[]（canonical segments + extensions）。 */
+export async function resolveAiOutboundToMessageElements(payload, ctx) {
+    const segments = [];
+    if (payload.mentions?.length) {
+        const resolved = resolveMentionEndpointIds(payload.mentions, ctx);
+        if (!resolved.ok)
+            return null;
+        const text = payload.text?.trim() ?? '';
+        if (!text)
+            return null;
+        segments.push(...buildMentionSegments(resolved.endpointKeys, text, ctx));
+    }
+    else if (payload.text?.trim()) {
+        segments.push({ type: 'text', data: { text: payload.text.trim() } });
+    }
+    if (payload.segments?.length) {
+        segments.push(...payload.segments);
+    }
+    const parts = segments.length
+        ? segmentsForImDelivery(segments)
+        : [];
+    if (payload.extensions && ctx.extensions?.length) {
+        for (const def of ctx.extensions) {
+            const ext = payload.extensions[def.key];
+            if (ext == null || !def.toMessageElements)
+                continue;
+            const extSegments = await def.toMessageElements(ext, ctx);
+            parts.push(...(Array.isArray(extSegments) ? extSegments : [extSegments]));
+        }
+    }
+    return parts.length ? parts : null;
+}

package/lib/built/ai-outbound/structured-detect.d.ts

@@ -0,0 +1,3 @@
+import type { StructuredOutboundDetectInput } from './types.js';
+/** structured_only：满足任一即进入结构化出站模式。 */
+export declare function isStructuredOutboundRequired(input: StructuredOutboundDetectInput): boolean;

package/lib/built/ai-outbound/structured-detect.js

@@ -0,0 +1,6 @@
+/** structured_only：满足任一即进入结构化出站模式。 */
+export function isStructuredOutboundRequired(input) {
+    return Boolean(input.toolRequiresStructured
+        || input.inboundHandoffIntent
+        || input.adapterHasExtensions);
+}

package/lib/built/ai-outbound/types.d.ts

@@ -0,0 +1,58 @@
+import type { Message } from '../../message.js';
+import type { MessageElement } from '../../types.js';
+import type { InteractivePolicy } from '../interactive-segments/types.js';
+import type { Segment } from '../segment-contract/types.js';
+/** AI 结构化出站 payload — 平台无关 DSL（Adapter extensions 承载平台特有段）。 */
+export interface ZhinAiOutboundPayload {
+    text?: string;
+    mentions?: string[];
+    segments?: Segment[];
+    extensions?: Record<string, unknown>;
+}
+/**
+ * @deprecated 使用 canonical `Segment`（`type` + `data` + 可选 `platform`）。
+ * 历史 `kind` → `type`；`mode` 已删除。
+ */
+export interface AiOutboundSegment {
+    kind: string;
+    mode?: string;
+    data?: Record<string, unknown>;
+}
+export interface AiOutboundCapabilities {
+    mentions?: boolean;
+    richSegments?: readonly string[];
+    interactive?: InteractivePolicy;
+}
+export interface AiOutboundExtensionDefinition {
+    /** 平台扩展字段名，如 qq.ark / onebot.keyboard */
+    key: string;
+    /** JSON Schema 子集，对齐平台 SDK 文档 */
+    schema: Record<string, unknown>;
+    examples: readonly string[];
+    toMessageElements?: (ext: unknown, ctx: AiOutboundParseContext) => MessageElement[] | Promise<MessageElement[]>;
+}
+export interface AiOutboundMentionResolver {
+    (ref: string): string | undefined;
+}
+export interface AiOutboundAtIdResolver {
+    (endpointKey: string): string;
+}
+/** 解析 AI 出站 JSON 时的上下文。 */
+export interface AiOutboundParseContext {
+    message: Message;
+    /** 将 peer ref（role/endpoint/primary）解析为 endpointKey */
+    mentionResolver?: AiOutboundMentionResolver;
+    /** 将 endpointKey 解析为 platform @ id */
+    atIdResolver?: AiOutboundAtIdResolver;
+    /** Adapter 声明的 extensions（运行时从 Adapter 静态属性注入） */
+    extensions?: readonly AiOutboundExtensionDefinition[];
+}
+export interface StructuredOutboundDetectInput {
+    /** 工具链要求结构化出站。 */
+    toolRequiresStructured?: boolean;
+    /** 用户入站含 handoff / @ 意图 */
+    inboundHandoffIntent?: boolean;
+    /** Adapter 声明 extensions 且非空 */
+    adapterHasExtensions?: boolean;
+}
+export declare const DEFAULT_AI_OUTBOUND_CAPABILITIES: AiOutboundCapabilities;

package/lib/built/ai-outbound/types.js

@@ -0,0 +1,5 @@
+export const DEFAULT_AI_OUTBOUND_CAPABILITIES = {
+    mentions: true,
+    richSegments: ['qrcode', 'html', 'markdown', 'tts'],
+    interactive: 'text',
+};

package/lib/built/ai-trigger.d.ts

@@ -37,8 +37,6 @@ export interface AITriggerConfig {
     masters?: string[];
     /** 全局 trusted（trigger 级） */
     trusted?: string[];
-    /** 是否在 AI 入参前拉取 $quote_id 对应消息正文（默认 true） */
-    resolveQuotedMessages?: boolean;
 }
 /**
  * AI 触发检查结果
@@ -49,8 +47,8 @@ export interface AITriggerResult {
 }
 /** shouldTriggerAI 可选参数（如适配器提供的平台 @ ID） */
 export interface AITriggerOptions {
-    /** 用于 @ 匹配的 bot 标识符（默认仅 message.$bot） */
-    botAtIds?: string[];
+    /** 用于 @ 匹配的 Endpoint 标识符（默认仅 message.$endpoint） */
+    endpointAtIds?: string[];
 }
 /** 发送者角色解析结果 */
 export interface SenderRolesResult {
@@ -59,38 +57,41 @@ export interface SenderRolesResult {
 }
 export declare const DEFAULT_AI_TRIGGER_CONFIG: Required<AITriggerConfig>;
 /**
- * 收集用于 @ 匹配的 bot 标识符
+ * 收集用于 @ 匹配的 Endpoint 标识符
  */
-export declare function collectBotAtIds<T extends object>(message: Message<T>, extraIds?: string[]): string[];
+export declare function collectEndpointAtIds<T extends object>(message: Message<T>, extraIds?: string[]): string[];
 /**
- * 检查消息是否 @ 了机器人
+ * 检查消息是否 @ 了 Endpoint
  */
-export declare function isAtBot<T extends object>(message: Message<T>, botAtIds?: string[]): boolean;
+export declare function isAtEndpoint<T extends object>(message: Message<T>, endpointAtIds?: string[]): boolean;
 /**
  * 提取消息文本内容（保留富媒体信息）
  * 使用 segment.toString 将 MessageElement 转为 XML 格式
  */
 export declare function extractTextContent<T extends object>(message: Message<T>): string;
+/**
+ * 为群/频道消息构建发送者前缀（与 sender-extra.ts buildSenderPrefix 格式对齐）
+ * 私聊消息返回 null
+ */
+export declare function buildSenderPrefixForMessage<T extends object>(message: Message<T>, roles: SenderRole[]): string | null;
 /**
  * 解析 AI 回复中的富媒体内容
  * 将字符串中的 XML-like 标签解析为 MessageElement
  */
 export declare function parseRichMediaContent(content: string): MessageElement[];
 /**
- * 移除 @ 机器人的部分
+ * 移除 @ Endpoint 的部分
  */
-export declare function removeAtBot<T extends object>(message: Message<T>, botAtIds?: string[]): MessageElement[];
-/** Bot 配置（adapter bots[].$config） */
-export interface BotConfigRoles {
+export declare function removeAtEndpoint<T extends object>(message: Message<T>, endpointAtIds?: string[]): MessageElement[];
+/** Endpoint 配置（adapter endpoints[].$config） */
+export interface EndpointConfigRoles {
     master?: unknown;
     trusted?: unknown;
 }
 /**
- * 解析发送者角色集合（IM 群角色 + trigger + bots[].$config）
+ * 解析发送者角色集合（IM 群角色 + trigger + endpoints[].$config）
  */
-export declare function resolveSenderRoles<T extends object>(message: Message<T>, config: AITriggerConfig, botConfig?: BotConfigRoles | Record<string, unknown> | null): SenderRolesResult;
-/** 从 IM 消息生成 sessionId（platform:botId:type:sceneId） */
-export declare function resolveIMSessionIdFromMessage<T extends object>(message: Message<T>): string;
+export declare function resolveSenderRoles<T extends object>(message: Message<T>, config: AITriggerConfig, endpointConfig?: EndpointConfigRoles | Record<string, unknown> | null): SenderRolesResult;
 /**
  * 检查消息是否应该触发 AI
  */
@@ -99,4 +100,3 @@ export declare function shouldTriggerAI<T extends object>(message: Message<T>, c
  * 合并配置
  */
 export declare function mergeAITriggerConfig(config: AITriggerConfig): Required<AITriggerConfig>;
-//# sourceMappingURL=ai-trigger.d.ts.map