export function addrName(addr: string): string;

export interface AutoRelayCtx {
  fromHuman: boolean;
  replyTo?: string;
}

export function autoRelayDecision(ctx: AutoRelayCtx): { relay: boolean; reason: string };

export interface ReplyInstructionCtx {
  fromHuman: boolean;
  replyAddress?: string;
}

export function replyInstruction(ctx: ReplyInstructionCtx): string[];

export interface InboundHeadlineCtx {
  inReplyTo?: string;
  /**
   * parentFrom 是**父邮件的发件人**（服务端 parent_from）。
   *
   * ★ 2026-10-02 补：`.js` 早就认这两个字段（b0c8719 加的），但这份手写声明
   * 没跟上 ⇒ TypeScript 报 TS2353，调用方**不敢传**，于是那行方向判据
   * 在本桥上一直是死代码：单向续信链同样满足 in_reply_to，被逐封宣称
   * 「回的是你那封」，模型把它当新任务处理。pi 桥是唯一接了的。
   *
   * 光有声明不够 —— 调用点也得传，见 src/index.ts 的三处 inboundHeadline。
   * 两者缺一，判据都等于没有。
   */
  parentFrom?: string;
  /** selfName 是本方名字（收件方自己）；`parentFrom === selfName` 才是「我的回复到了」。 */
  selfName?: string;
  fromHuman: boolean;
  catchup?: boolean;
  reused?: boolean;
}

export function inboundHeadline(ctx: InboundHeadlineCtx): string;