/**
 * 飞书中国版 (Feishu) ↔ 国际版 (Lark) 的 host 单一事实源。
 *
 * brand 是**应用/租户的固有属性**，不是可在运行时切换的偏好：feishu app
 * (open.feishu.cn) 和 lark app (open.larksuite.com) 是两个平台上的两个独立
 * 应用，AppID / 扫码各自独立。所以 botmux 把 brand 做成**每个 bot 一个字段**
 * (BotConfig.brand，持久化进 bots.json)，缺省 / 旧配置 → 'feishu'，向后兼容。
 * 一个部署因此可以同时挂飞书 bot + Lark bot。
 *
 * 所有需要区分品牌的 host 都从这里派生，杜绝散落各处的
 * `brand === 'lark' ? 'open.larksuite.com' : 'open.feishu.cn'` 三元表达式。
 */
export type Brand = 'feishu' | 'lark';
export interface LarkHosts {
    /**
     * open-apis 基址 + 开放平台控制台 (`/app/...` 深链)。也是传给 SDK
     * `Lark.Client({ domain })` / `Lark.WSClient({ domain })` 的值
     * （见 {@link sdkDomain}）。
     */
    openApi: string;
    /** OAuth authorize host (`accounts.*`)——`/login` 用户授权码流程用。 */
    accounts: string;
    /** 客户端 AppLink host（不含 scheme）——拼"打开群聊"等深链用。 */
    applink: string;
}
/**
 * 把任意配置值收敛成合法 {@link Brand}。只有精确等于 `'lark'` 才判国际版，
 * 其余（undefined / '' / 旧配置 / 非字符串 / 大小写不符）一律 → `'feishu'`，
 * 保证旧 bots.json 行为不变。
 */
export declare function normalizeBrand(v: unknown): Brand;
/** 取指定 brand 的 host 三元组，缺省 feishu。 */
export declare function larkHosts(brand?: Brand): LarkHosts;
/**
 * 传给 `new Lark.Client({ domain })` / `new Lark.WSClient({ domain })` 的 domain。
 *
 * SDK 的 `formatDomain` 对已知枚举返回固定 URL，对未知字符串走
 * `default: return domain`——所以直接给 openApi URL 字符串与给
 * `Domain.Lark` 枚举完全等价，且本模块无需依赖 SDK（也让单测无需 mock SDK）。
 */
export declare function sdkDomain(brand?: Brand): string;
/** 构造"在客户端打开群聊"的 AppLink，按 brand 选 applink host。 */
export declare function chatAppLink(chatId: string, brand?: Brand): string;
/**
 * 构造「在飞书/Lark 客户端内，以 appCenter 标签页形态打开一个网页」的 AppLink。
 *
 * 为什么是 appCenter 而不是 sidebar-semi（见 card-builder.ts:sidebarUrl）：
 * sidebar 是一次性侧边浮层，关掉就没了；appCenter 打开的是客户端左侧的应用标签
 * 页，用户可以右键固定，等于给工作台一个常驻入口——这正是「零门槛拿到入口」要
 * 的形态。
 *
 * `targetUrl` 必须整体 encodeURIComponent：工作台目标 URL 自带 `?t=<token>`
 * 查询串和 `#/agent-workbench` fragment，不转义会被客户端当成 AppLink 自己的
 * 参数、并在 `#` 处截断。
 */
export declare function appCenterAppLink(targetUrl: string, brand?: Brand): string;
/** Build an AppLink for a topic inside a topic group. `threadId` is the
 *  `omt_...` topic id, not the `om_...` root-message id used for routing.
 *  Lark's own message AppLinks use `thread_position=-1`; large positive values
 *  stop opening once a topic grows beyond the client's clamp range. */
export declare function threadAppLink(chatId: string, threadId: string, brand?: Brand): string;
//# sourceMappingURL=lark-hosts.d.ts.map