/**
 * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
 * SPDX-License-Identifier: MIT
 *
 * Shared helper functions for Feishu content converters.
 */
import type { ApiMessageItem, ConvertContext } from './types';
/** 从 mention 的 id 字段提取 open_id（兼容事件推送的对象格式和 API 响应的字符串格式） */
export declare function extractMentionOpenId(id: unknown): string;
/**
 * Build a {@link ConvertContext} from a raw Feishu API message item.
 *
 * Extracts the `mentions` array that the IM API returns on each message
 * item and maps it into the key→MentionInfo / openId→MentionInfo
 * structures the converter system expects.
 */
export declare function buildConvertContextFromItem(item: ApiMessageItem, fallbackMessageId: string, accountId?: string): ConvertContext;
/**
 * Resolve mention placeholders in text.
 *
 * - Bot self-mention + stripBotMentions: leading-only strip. When the
 *   self-mention sits at the very start of the message, drop it (the
 *   `WasMentioned` envelope field already tells the agent "this message
 *   was addressed to you", so the anchor is redundant). When it appears
 *   mid-text, render it as plain `@Name` so the surrounding context still
 *   reads naturally without leaving an inline anchor the LLM might echo
 *   back into its reply.
 * - Non-bot mentions: replace the placeholder key with readable `@name`.
 */
export declare function resolveMentions(text: string, ctx: ConvertContext): string;