@napuketto/adapter 0.0.1

package/dist/onebot11/index.d.mts

@@ -0,0 +1,798 @@
+import { l as ErrorCodeMap, o as ActionRegistry, r as ProtocolConfig, t as BaseProtocolAdapter } from "../index-C1nIfPiU.mjs";
+import { CanonicalElement, FriendApi, GroupApi, GroupCache, GroupNotifyApi, MsgApi, MsgEventChannel, Peer, ProfileApi, ProfileLikeApi, RichMediaApi, TicketApi, WebApi } from "@napuketto/kernel";
+import { z } from "zod";
+import { EventBroadcaster, TransportAdapter } from "@napuketto/network";
+//#region src/onebot11/action/error-map.d.ts
+/** OB11 错误码映射表（send_msg 等所有 OB11 动作共用）。 */
+declare const ob11ErrorCodeMap: ErrorCodeMap;
+//#endregion
+//#region src/onebot11/action/group/get-group-at-all-remain.d.ts
+/** @全体剩余次数返回结构。 */
+interface AtAllRemainInfo {
+  can_at_all: boolean;
+  remain_at_all_count_for_uin: number;
+  remain_at_all_count_for_group: number;
+}
+//#endregion
+//#region src/onebot11/helper/message-unique.d.ts
+declare class MessageUnique {
+  /** NT msgId → OB11 message_id。 */
+  private readonly msgIdToInt;
+  /** OB11 message_id → NT msgId。 */
+  private readonly intToMsgId;
+  /** NT msgId → Peer（delete_msg / get_msg 等只有 message_id 时反查用）。 */
+  private readonly msgIdToPeer;
+  /** 递增计数器。 */
+  private cursor;
+  /** 已释放的槽位（可复用）。 */
+  private readonly freed;
+  /**
+   * 为新 NT 消息分配 OB11 message_id（幂等：同一 msgId 返回同一 id）。
+   * peer 可选：传入则记录，供 message_id → peer 反查。
+   */
+  alloc(msgId: string, peer?: Peer): number;
+  /** OB11 message_id → NT msgId。 */
+  getMsgId(messageId: number): string | undefined;
+  /** NT msgId → OB11 message_id（未分配返回 undefined）。 */
+  getMessageId(msgId: string): number | undefined;
+  /** NT msgId → Peer（alloc 时未记录返回 undefined）。 */
+  getPeer(msgId: string): Peer | undefined;
+  /** 释放 NT msgId 占用的槽位（消息过期/删除时调用，可选）。 */
+  release(msgId: string): void;
+  /** 取下一个可用 id：优先释放池，否则递增（溢出后线性扫描空洞）。 */
+  private nextFreeId;
+}
+//#endregion
+//#region src/onebot11/api/one-bot-api.d.ts
+/** 系统类本地回调（get_version_info / clean_cache / download_file / 进程控制用）。 */
+interface OneBotSystemOptions {
+  /** 运行版本（get_version_info 用，缺省 unknown）。 */
+  appVersion: string;
+  /** 缓存清理回调（clean_cache 用，未配置抛错）。 */
+  cleanCache?: () => Promise<void>;
+  /** 缓存目录（download_file 保存路径）。 */
+  cacheDir?: string;
+  /** 进程退出回调（bot_exit 用）。 */
+  exit?: () => Promise<void>;
+  /** 进程重启回调（set_restart 用，缺省退化为退出）。 */
+  restart?: () => Promise<void>;
+}
+/** OneBotApi 构造参数。 */
+interface OneBotApiOptions {
+  msgApi: MsgApi;
+  groupApi: GroupApi;
+  groupNotifyApi: GroupNotifyApi;
+  friendApi: FriendApi;
+  ticketApi: TicketApi;
+  richMediaApi: RichMediaApi;
+  profileApi: ProfileApi;
+  profileLikeApi: ProfileLikeApi;
+  webApi: WebApi;
+  /** 登录身份（get_login_info 用）。 */
+  self: {
+    uin: string;
+    nickname: string;
+  };
+  /** 系统类本地信息。 */
+  system: OneBotSystemOptions;
+  /** 群/成员缓存（ADR-008，读缓存动作用；未装配时动作直查 api）。 */
+  groupCache?: GroupCache;
+}
+/**
+ * OneBot 11 动作统一依赖聚合（P2-16）。
+ * 各动作经 `Pick<OneBotApi, ...>` 取所需成员；注册处只构造一次本对象。
+ */
+declare class OneBotApi {
+  /** kernel 消息 API（send_msg 等消息类动作用）。 */
+  readonly msgApi: MsgApi;
+  /** kernel 群 API。 */
+  readonly groupApi: GroupApi;
+  /** kernel 群通知 API（群请求/禁言列表用）。 */
+  readonly groupNotifyApi: GroupNotifyApi;
+  /** kernel 好友 API。 */
+  readonly friendApi: FriendApi;
+  /** kernel 票据 API（get_clientkey/get_cookies 用）。 */
+  readonly ticketApi: TicketApi;
+  /** kernel 富媒体 API（群文件/翻译用）。 */
+  readonly richMediaApi: RichMediaApi;
+  /** kernel 资料 API（签名/昵称/头像用）。 */
+  readonly profileApi: ProfileApi;
+  /** kernel 点赞 API（send_like 用）。 */
+  readonly profileLikeApi: ProfileLikeApi;
+  /** kernel 群空间 web API（精华/荣誉用）。 */
+  readonly webApi: WebApi;
+  /** 群/成员缓存（ADR-008；翻译层只读消费，缺失惰性回填）。 */
+  readonly groupCache: GroupCache | undefined;
+  /** OB11 message_id ↔ NT msgId 双向映射（收链路与动作共用同一映射空间）。 */
+  readonly messageUnique: MessageUnique;
+  /** 登录身份（get_login_info 用）。 */
+  readonly self: {
+    uin: string;
+    nickname: string;
+  };
+  /** 机器人自身 uin（get_cookies / csrf 用）。 */
+  readonly selfUin: string;
+  /** 运行版本（get_version_info 用）。 */
+  readonly appVersion: string;
+  /** 缓存清理回调（clean_cache 用）。 */
+  readonly cleanCache: (() => Promise<void>) | undefined;
+  /** 缓存目录（download_file 用）。 */
+  readonly cacheDir: string | undefined;
+  /** 进程退出回调（bot_exit 用）。 */
+  readonly exit: (() => Promise<void>) | undefined;
+  /** 进程重启回调（set_restart 用）。 */
+  readonly restart: (() => Promise<void>) | undefined;
+  constructor(opts: OneBotApiOptions);
+  /** uin→uid 转换（委托 groupApi；私聊目标/成员 user_id 用）。 */
+  uinToUid(uins: string[]): Promise<Map<string, string>>;
+  /** uid→uin 转换（委托 groupApi；notice/grayTip 用）。 */
+  uidToUin(uids: string[]): Promise<Map<string, string>>;
+}
+//#endregion
+//#region src/onebot11/action/index.d.ts
+/** 动作注册表依赖（P2-16：动作只依赖一个聚合对象）。 */
+interface Ob11ActionDeps {
+  /** OneBotApi 聚合（9 个 kernel apis + messageUnique + self/system）。 */
+  api: OneBotApi;
+}
+/** 构建 OB11 动作注册表（所有 OB11 动作在此注册，按组拆分控制行数）。 */
+declare function createOb11ActionRegistry(deps: Ob11ActionDeps): ActionRegistry;
+//#endregion
+//#region src/onebot11/helper/config.d.ts
+/** OB11 配置 schema。 */
+declare const ob11ConfigSchema: z.ZodObject<{
+  token: z.ZodOptional<z.ZodString>;
+  heartbeatInterval: z.ZodDefault<z.ZodNumber>;
+  reportSelfMessage: z.ZodDefault<z.ZodBoolean>;
+  messagePostFormat: z.ZodDefault<z.ZodEnum<{
+    array: "array";
+    string: "string";
+  }>>;
+  httpServers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    host: z.ZodDefault<z.ZodString>;
+    port: z.ZodDefault<z.ZodNumber>;
+    token: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>>;
+  httpPostUrls: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    url: z.ZodOptional<z.ZodString>;
+    token: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>>>;
+  wsServers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    host: z.ZodDefault<z.ZodString>;
+    port: z.ZodDefault<z.ZodNumber>;
+    token: z.ZodOptional<z.ZodString>;
+    heartbeatInterval: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>>>;
+  wsReverseUrls: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    url: z.ZodOptional<z.ZodString>;
+    token: z.ZodOptional<z.ZodString>;
+    reconnectDelayMs: z.ZodDefault<z.ZodNumber>;
+    maxReconnectAttempts: z.ZodOptional<z.ZodNumber>;
+    rejectUnauthorized: z.ZodDefault<z.ZodBoolean>;
+    heartbeatInterval: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+/** OB11 配置类型（由 schema 推导）。 */
+type OB11Config = z.infer<typeof ob11ConfigSchema>;
+//#endregion
+//#region src/onebot11/helper/cqcode.d.ts
+/**
+ * CQ 码编解码（OneBot 11 消息段序列化格式）
+ *
+ * 纯函数、无 OB11 类型依赖：本文件只处理「文本 ↔ CQ 码片段」的通用编解码，
+ * segment 级别的映射在 data.ts（OB11Constructor）。
+ *
+ * 转义规则（OneBot 11 规范）：
+ * - 纯文本：& → &amp;，[ → &#91;，] → &#93;
+ * - 参数值：额外 , → &#44;
+ */
+/** CQ 码片段（[CQ:type,key=value,...] 的结构化表示）。 */
+interface CqCode {
+  type: string;
+  params: Record<string, string>;
+}
+/** 转义纯文本（& [ ]；& 必须先转，避免二次转义）。 */
+declare function escapeCqText(text: string): string;
+/** 转义 CQ 码参数值（& [ ] ,）。 */
+declare function escapeCqParam(value: string): string;
+/** 反转义（&#44; &#93; &#91; &amp;；&amp; 必须最后解，避免二次转义误伤）。 */
+declare function unescapeCqText(text: string): string;
+/** 编码单个 CQ 码（undefined 参数自动省略）。 */
+declare function encodeCqCode(type: string, params: Record<string, string | number | undefined>): string;
+/** 解析一条消息文本 → 文本片段与 CQ 码片段的混合数组（文本已反转义）。 */
+declare function parseCqMessage(text: string): Array<string | CqCode>;
+/** 将混合片段数组序列化回消息文本（parseCqMessage 的逆操作）。 */
+declare function serializeCqParts(parts: Array<string | CqCode>): string;
+//#endregion
+//#region src/onebot11/types/index.d.ts
+/**
+ * OneBot 11 类型定义（自研描述，参考公开协议规范）
+ * 对应 ADR-001：接口签名是外部协议事实，可自研描述，不复制实现。
+ */
+/** OB11 统一返回结构。 */
+interface OB11Return<T> {
+  status: "ok" | "failed";
+  retcode: number;
+  data: T;
+  message: string;
+  echo?: unknown;
+}
+/** OB11 消息段（segment）。 */
+type OB11MessageSegment = {
+  type: "text";
+  data: {
+    text: string;
+  };
+} | {
+  type: "at";
+  data: {
+    qq: string;
+    name?: string;
+  };
+} | {
+  type: "face";
+  data: {
+    id: string;
+  };
+} | {
+  type: "image";
+  data: {
+    file: string;
+    url?: string;
+  };
+} | {
+  type: "record";
+  data: {
+    file: string;
+    url?: string;
+  };
+} | {
+  type: "video";
+  data: {
+    file: string;
+    url?: string;
+  };
+} | {
+  type: "reply";
+  data: {
+    id: string;
+  };
+} | {
+  type: "forward";
+  data: {
+    id: string;
+  };
+} | {
+  type: "json";
+  data: {
+    data: string;
+  };
+} | {
+  type: "xml";
+  data: {
+    data: string;
+  };
+} | {
+  type: "string";
+  data: {
+    text: string;
+  };
+};
+/** OB11 消息（segment 数组或 CQ 码字符串）。 */
+type OB11Message = string | OB11MessageSegment[];
+/** 消息发送来源。 */
+interface Sender {
+  user_id: number;
+  nickname?: string;
+  card?: string;
+  role?: "owner" | "admin" | "member";
+}
+/** 群信息（get_group_info 返回）。 */
+interface GroupInfo {
+  group_id: number;
+  group_name: string;
+  member_count?: number;
+  max_member_count?: number;
+}
+/** 登录信息（get_login_info 返回）。 */
+interface LoginInfo {
+  user_id: number;
+  nickname: string;
+}
+/** OB11 消息信息（get_msg / 历史消息返回项）。 */
+interface OB11MessageInfo {
+  message_id: number;
+  real_id?: number;
+  message_type: "group" | "private";
+  sender: {
+    user_id: number;
+    nickname: string;
+    card?: string;
+    role?: "owner" | "admin" | "member";
+  };
+  time: number;
+  message: OB11MessageSegment[];
+  raw_message: string;
+  group_id?: number;
+  user_id?: number;
+}
+/** 性别枚举。 */
+type Sex = "male" | "female" | "unknown";
+/** 群成员信息（get_group_member_info 返回，含 go-cqhttp 扩展字段）。 */
+interface GroupMemberInfo {
+  group_id: number;
+  user_id: number;
+  nickname: string;
+  card?: string;
+  sex?: Sex;
+  age?: number;
+  area?: string;
+  join_time?: number;
+  last_sent_time?: number;
+  level?: string;
+  role: "owner" | "admin" | "member";
+  unfriendly?: boolean;
+  title?: string;
+  title_expire_time?: number;
+  card_changeable?: boolean;
+  /** go-cqhttp 扩展。 */
+  qq_level?: number;
+  group_level?: number;
+  special_title?: string;
+  shut_up_timestamp?: number;
+  is_friend?: boolean;
+  is_bot?: boolean;
+}
+/** 好友信息（get_friend_list 返回）。 */
+interface FriendInfo {
+  user_id: number;
+  nickname: string;
+  remark?: string;
+}
+/** 陌生人信息（get_stranger_info 返回）。 */
+interface StrangerInfo {
+  user_id: number;
+  nickname: string;
+  sex?: Sex;
+  age?: number;
+  /** go-cqhttp 扩展。 */
+  qid?: string;
+  level?: number;
+  login_days?: number;
+  uid?: string;
+}
+/** 群荣誉成员项（get_group_honor_info 返回列表项）。 */
+interface HonorMember {
+  user_id: number;
+  nickname: string;
+  avatar?: string;
+  day_count?: number;
+  description?: string;
+}
+/** 当前龙王（可能为 null）。 */
+interface CurrentTalkative {
+  user_id: number;
+  nickname: string;
+  day_count: number;
+}
+/** 群荣誉信息（get_group_honor_info 返回）。 */
+interface GroupHonorInfo {
+  group_id: number;
+  current_talkative?: CurrentTalkative | null;
+  talkative_list: HonorMember[];
+  performer_list: HonorMember[];
+  legend_list: HonorMember[];
+  strong_newbie_list: HonorMember[];
+  emotion_list: HonorMember[];
+}
+/** 版本信息（get_version_info 返回，含 go-cqhttp 扩展字段）。 */
+interface VersionInfo {
+  app_name: string;
+  app_version: string;
+  protocol_version: "v11";
+  /** go-cqhttp 扩展。 */
+  app_full_name?: string;
+  runtime_version?: string;
+  runtime_os?: string;
+  sign_library?: Record<string, unknown>;
+  configuration?: Record<string, unknown>;
+  walle_version?: string;
+}
+//#endregion
+//#region src/onebot11/helper/data.d.ts
+/** canonical 元素数组 → OB11 segment 数组（无法表达的元素静默跳过）。 */
+declare function canonicalToSegments(elements: CanonicalElement[]): OB11MessageSegment[];
+/** OB11 segment 数组 → canonical 元素数组。 */
+declare function segmentsToCanonical(segments: OB11MessageSegment[]): CanonicalElement[];
+/** OB11 segment 数组 → CQ 码字符串（text 段转义拼接，特殊段编码）。 */
+declare function segmentsToCqMessage(segments: OB11MessageSegment[]): string;
+/** CQ 码字符串 → OB11 segment 数组（未知 CQ 类型保留为 text 段原文）。 */
+declare function cqMessageToSegments(text: string): OB11MessageSegment[];
+/** canonical 元素数组 → CQ 码字符串。 */
+declare function canonicalToCqMessage(elements: CanonicalElement[]): string;
+/** CQ 码字符串 → canonical 元素数组。 */
+declare function cqMessageToCanonical(text: string): CanonicalElement[];
+//#endregion
+//#region src/onebot11/event/base.d.ts
+/**
+ * OneBot 11 事件基类（OB11 公开协议规范，自研描述）
+ *
+ * 所有事件共有的三个字段：time（Unix 秒）/ self_id（机器人 QQ 号）/ post_type（事件大类）。
+ * 各事件类型通过 post_type + 二级判别字段（message_type/notice_type/request_type/meta_event_type）
+ * 组成可判别联合，适配器广播与第三方框架消费都靠判别字段收窄。
+ */
+/** OB11 post_type（事件大类）。 */
+type OB11PostType = "message" | "notice" | "request" | "meta_event";
+/** OB11 事件基类。 */
+interface OB11BaseEvent {
+  /** 事件发生时间（Unix 秒）。 */
+  time: number;
+  /** 机器人自身 QQ 号。 */
+  self_id: number;
+  /** 事件大类。 */
+  post_type: OB11PostType;
+}
+//#endregion
+//#region src/onebot11/event/message.d.ts
+/** 匿名用户信息（群匿名消息，go-cqhttp 兼容）。 */
+interface Anonymous {
+  id: number;
+  name: string;
+  flag: string;
+}
+/** 群消息发送者（role 必填 + 群头衔）。 */
+interface GroupSender extends Sender {
+  role: "owner" | "admin" | "member";
+  title?: string;
+}
+/** 群消息事件。 */
+interface OB11GroupMessageEvent extends OB11BaseEvent {
+  post_type: "message";
+  message_type: "group";
+  /** 消息子类型：normal 普通 / anonymous 匿名 / notice 系统提示。 */
+  sub_type: "normal" | "anonymous" | "notice";
+  message_id: number;
+  group_id: number;
+  user_id: number;
+  message: OB11Message;
+  raw_message: string;
+  font: number;
+  sender: GroupSender;
+  anonymous?: Anonymous;
+}
+/** 私聊消息事件。 */
+interface OB11PrivateMessageEvent extends OB11BaseEvent {
+  post_type: "message";
+  message_type: "private";
+  /** 消息子类型：friend 好友 / group 临时会话 / other / self 自身。 */
+  sub_type: "friend" | "group" | "other" | "self";
+  message_id: number;
+  user_id: number;
+  message: OB11Message;
+  raw_message: string;
+  font: number;
+  sender: Sender;
+  /** 临时会话来源（0=未知，其他=来源群号）。 */
+  temp_source?: number;
+}
+/** OB11 消息事件联合。 */
+type OB11MessageEvent = OB11GroupMessageEvent | OB11PrivateMessageEvent;
+//#endregion
+//#region src/onebot11/event/meta.d.ts
+/** 运行状态（get_status 返回 + 心跳 status，扩展字段透传）。 */
+interface OB11Status {
+  online: boolean;
+  good: boolean;
+  [key: string]: unknown;
+}
+/** 生命周期事件（适配器 enable/disable/connect 时广播）。 */
+interface OB11LifecycleMetaEvent extends OB11BaseEvent {
+  post_type: "meta_event";
+  meta_event_type: "lifecycle";
+  sub_type: "enable" | "disable" | "connect";
+}
+/** 心跳事件（按配置 interval 毫秒定时广播）。 */
+interface OB11HeartbeatMetaEvent extends OB11BaseEvent {
+  post_type: "meta_event";
+  meta_event_type: "heartbeat";
+  /** 心跳间隔（毫秒）。 */
+  interval: number;
+  status: OB11Status;
+}
+/** OB11 元事件联合。 */
+type OB11MetaEvent = OB11LifecycleMetaEvent | OB11HeartbeatMetaEvent;
+//#endregion
+//#region src/onebot11/event/notice.d.ts
+/** 群文件信息（group_upload 的 file 字段）。 */
+interface GroupFileInfo {
+  id: string;
+  name: string;
+  size: number;
+  busid: number;
+}
+/** 离线文件信息（offline_file 的 file 字段）。 */
+interface OfflineFileInfo {
+  name: string;
+  size: number;
+  url: string;
+}
+/** 消息表情回应项（msg_emoji_like 的 likes 项）。 */
+interface EmojiLikeItem {
+  nickname: string;
+  user_id: number;
+  face_id: number;
+}
+/** 群文件上传（群成员上传了文件）。 */
+interface OB11GroupUploadNoticeEvent extends OB11BaseEvent {
+  post_type: "notice";
+  notice_type: "group_upload";
+  group_id: number;
+  user_id: number;
+  file: GroupFileInfo;
+}
+/** 群管理员变更。 */
+interface OB11GroupAdminNoticeEvent extends OB11BaseEvent {
+  post_type: "notice";
+  notice_type: "group_admin";
+  sub_type: "set" | "unset";
+  group_id: number;
+  user_id: number;
+}
+/** 群成员减少（主动退群 / 被踢 / 机器人被踢）。 */
+interface OB11GroupDecreaseNoticeEvent extends OB11BaseEvent {
+  post_type: "notice";
+  notice_type: "group_decrease";
+  sub_type: "leave" | "kick" | "kick_me";
+  group_id: number;
+  operator_id: number;
+  user_id: number;
+}
+/** 群成员增加（管理员同意入群 / 成员邀请入群）。 */
+interface OB11GroupIncreaseNoticeEvent extends OB11BaseEvent {
+  post_type: "notice";
+  notice_type: "group_increase";
+  sub_type: "approve" | "invite";
+  group_id: number;
+  operator_id: number;
+  user_id: number;
+}
+/** 群禁言（禁言 / 解除禁言）。 */
+interface OB11GroupBanNoticeEvent extends OB11BaseEvent {
+  post_type: "notice";
+  notice_type: "group_ban";
+  sub_type: "ban" | "lift_ban";
+  group_id: number;
+  operator_id: number;
+  user_id: number;
+  /** 禁言时长（秒，0 表示解除禁言）。 */
+  duration: number;
+}
+/** 好友添加。 */
+interface OB11FriendAddNoticeEvent extends OB11BaseEvent {
+  post_type: "notice";
+  notice_type: "friend_add";
+  user_id: number;
+}
+/** 群消息撤回。 */
+interface OB11GroupRecallNoticeEvent extends OB11BaseEvent {
+  post_type: "notice";
+  notice_type: "group_recall";
+  group_id: number;
+  user_id: number;
+  operator_id: number;
+  message_id: number;
+}
+/** 好友消息撤回。 */
+interface OB11FriendRecallNoticeEvent extends OB11BaseEvent {
+  post_type: "notice";
+  notice_type: "friend_recall";
+  user_id: number;
+  message_id: number;
+}
+/** 群成员名片变更（go-cqhttp 扩展）。 */
+interface OB11GroupCardNoticeEvent extends OB11BaseEvent {
+  post_type: "notice";
+  notice_type: "group_card";
+  group_id: number;
+  user_id: number;
+  card_new: string;
+  card_old: string;
+}
+/** 群消息精华（go-cqhttp 扩展）。 */
+interface OB11GroupEssenceNoticeEvent extends OB11BaseEvent {
+  post_type: "notice";
+  notice_type: "group_essence";
+  sub_type: "add" | "delete";
+  group_id: number;
+  sender_id: number;
+  operator_id: number;
+  message_id: number;
+}
+/** 系统通知（go-cqhttp 扩展）：戳一戳 / 红包运气王 / 群荣誉。 */
+interface OB11NotifyNoticeEvent extends OB11BaseEvent {
+  post_type: "notice";
+  notice_type: "notify";
+  sub_type: "poke" | "lucky_notify" | "honor";
+  group_id: number;
+  user_id: number;
+  target_id: number;
+  /** honor 子类型时的荣誉类型（talkative 龙王 / performer 群聊之火 / emotion 快乐源泉）。 */
+  honor_type?: "talkative" | "performer" | "emotion";
+}
+/** 离线文件上传（go-cqhttp 扩展）。 */
+interface OB11OfflineFileNoticeEvent extends OB11BaseEvent {
+  post_type: "notice";
+  notice_type: "offline_file";
+  user_id: number;
+  file: OfflineFileInfo;
+}
+/** 群签到（NapCat 扩展）。 */
+interface OB11GroupSignNoticeEvent extends OB11BaseEvent {
+  post_type: "notice";
+  notice_type: "group_sign";
+  group_id: number;
+  user_id: number;
+}
+/** 消息表情回应（NapCat 扩展）。 */
+interface OB11MsgEmojiLikeNoticeEvent extends OB11BaseEvent {
+  post_type: "notice";
+  notice_type: "msg_emoji_like";
+  user_id: number;
+  group_id: number;
+  message_id: number;
+  likes: EmojiLikeItem[];
+}
+/** 群成员头衔变更（NapCat 扩展）。 */
+interface OB11GroupTitleNoticeEvent extends OB11BaseEvent {
+  post_type: "notice";
+  notice_type: "group_title";
+  group_id: number;
+  user_id: number;
+  title: string;
+}
+/** OB11 通知事件联合。 */
+type OB11NoticeEvent = OB11GroupUploadNoticeEvent | OB11GroupAdminNoticeEvent | OB11GroupDecreaseNoticeEvent | OB11GroupIncreaseNoticeEvent | OB11GroupBanNoticeEvent | OB11FriendAddNoticeEvent | OB11GroupRecallNoticeEvent | OB11FriendRecallNoticeEvent | OB11GroupCardNoticeEvent | OB11GroupEssenceNoticeEvent | OB11NotifyNoticeEvent | OB11OfflineFileNoticeEvent | OB11GroupSignNoticeEvent | OB11MsgEmojiLikeNoticeEvent | OB11GroupTitleNoticeEvent;
+//#endregion
+//#region src/onebot11/event/request.d.ts
+/** 加好友请求。 */
+interface OB11FriendRequestEvent extends OB11BaseEvent {
+  post_type: "request";
+  request_type: "friend";
+  user_id: number;
+  /** 验证信息。 */
+  comment: string;
+  /** 请求 flag，应答时原样传回。 */
+  flag: string;
+}
+/** 加群请求 / 邀请。 */
+interface OB11GroupRequestEvent extends OB11BaseEvent {
+  post_type: "request";
+  request_type: "group";
+  /** add 他人申请入群 / invite 群主或管理邀请。 */
+  sub_type: "add" | "invite";
+  group_id: number;
+  user_id: number;
+  comment: string;
+  flag: string;
+}
+/** OB11 请求事件联合。 */
+type OB11RequestEvent = OB11FriendRequestEvent | OB11GroupRequestEvent;
+//#endregion
+//#region src/onebot11/event/index.d.ts
+/** OB11 事件联合（所有事件共用 time/self_id/post_type，按 post_type 收窄）。 */
+type OB11Event = OB11MessageEvent | OB11NoticeEvent | OB11RequestEvent | OB11MetaEvent;
+//#endregion
+//#region src/onebot11/adapter.d.ts
+/** 适配器构造参数（api 相关字段继承 OneBotApiOptions，P2-16 聚合）。 */
+interface OneBot11AdapterOptions extends OneBotApiOptions {
+  /** 协议配置（zod 校验 + JSON 读写）。 */
+  config: ProtocolConfig<OB11Config>;
+  /** network 事件广播（注册传输适配器后 emit 推给第三方）。 */
+  broadcaster: EventBroadcaster;
+  /** kernel 消息事件通道（消息收链路入口）。 */
+  msgChannel: MsgEventChannel;
+}
+/** OneBot 11 协议适配器。 */
+declare class NapukettoOneBot11Adapter extends BaseProtocolAdapter<OB11Config> {
+  readonly protocol = "onebot11";
+  readonly configSchema: import("zod").ZodObject<{
+    token: import("zod").ZodOptional<import("zod").ZodString>;
+    heartbeatInterval: import("zod").ZodDefault<import("zod").ZodNumber>;
+    reportSelfMessage: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    messagePostFormat: import("zod").ZodDefault<import("zod").ZodEnum<{
+      array: "array";
+      string: "string";
+    }>>;
+    httpServers: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
+      enabled: import("zod").ZodDefault<import("zod").ZodBoolean>;
+      host: import("zod").ZodDefault<import("zod").ZodString>;
+      port: import("zod").ZodDefault<import("zod").ZodNumber>;
+      token: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>>;
+    httpPostUrls: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
+      enabled: import("zod").ZodDefault<import("zod").ZodBoolean>;
+      url: import("zod").ZodOptional<import("zod").ZodString>;
+      token: import("zod").ZodOptional<import("zod").ZodString>;
+      timeoutMs: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>>;
+    wsServers: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
+      enabled: import("zod").ZodDefault<import("zod").ZodBoolean>;
+      host: import("zod").ZodDefault<import("zod").ZodString>;
+      port: import("zod").ZodDefault<import("zod").ZodNumber>;
+      token: import("zod").ZodOptional<import("zod").ZodString>;
+      heartbeatInterval: import("zod").ZodDefault<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>>;
+    wsReverseUrls: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
+      enabled: import("zod").ZodDefault<import("zod").ZodBoolean>;
+      url: import("zod").ZodOptional<import("zod").ZodString>;
+      token: import("zod").ZodOptional<import("zod").ZodString>;
+      reconnectDelayMs: import("zod").ZodDefault<import("zod").ZodNumber>;
+      maxReconnectAttempts: import("zod").ZodOptional<import("zod").ZodNumber>;
+      rejectUnauthorized: import("zod").ZodDefault<import("zod").ZodBoolean>;
+      heartbeatInterval: import("zod").ZodDefault<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>>;
+  }, import("zod/v4/core").$strip>;
+  private readonly msgChannel;
+  private readonly selfUin;
+  private readonly oneBotApi;
+  private readonly registry;
+  private unsubscribe;
+  private transports;
+  private heartbeatTimer;
+  private reportSelfMessage;
+  private messageFormat;
+  constructor(opts: OneBot11AdapterOptions);
+  /** 启动传输：装配（HTTP/WS）+ 打开 server/client + 广播 lifecycle enable + 起心跳。 */
+  private startTransports;
+  /** 心跳 meta 事件（interval 毫秒，0 关闭）。 */
+  private startHeartbeat;
+  /** 停止：心跳 + 传输 + 退订。 */
+  private stopAll;
+  /** 订阅 kernel 消息事件（幂等）。 */
+  private subscribe;
+  /**
+   * 广播消息事件（P2-19：接收方向 ID 转换）。
+   * 收集 at uid → 一次批量 uidToUin → 构造上下文 → 翻译广播。
+   * 翻译失败退化为原样（不阻塞上报）。
+   */
+  private broadcastMessageEvent;
+  /** 广播 grayTip → notice 事件（批量 uidToUin 后翻译，纯函数）。 */
+  private broadcastNotice;
+  /** 退订（幂等）。 */
+  private unsubscribeAll;
+  /**
+   * 请求分发（挂到 network transport 的 onRequest）：
+   * OB11 标准请求 { action, params, echo } → 动作注册表 → handle（HTTP）/websocketHandle（WS）。
+   */
+  handleRequest(req: unknown, respond: (res: unknown) => void): Promise<void>;
+}
+//#endregion
+//#region src/onebot11/transport.d.ts
+/** 传输装配结果。 */
+interface Ob11TransportSet {
+  /** 反向 server（HTTP/WS，第三方调用入口）。 */
+  servers: TransportAdapter[];
+  /** 事件上报传输（正向 client，已注册到 broadcaster）。 */
+  transports: TransportAdapter[];
+  /** 停止：关闭全部传输（幂等）。 */
+  close: () => Promise<void>;
+}
+/** 传输装配选项。 */
+interface AssembleOb11TransportsOptions {
+  /** OB11 配置。 */
+  config: OB11Config;
+  /** 事件广播（正向上报传输注册到它）。 */
+  broadcaster: EventBroadcaster;
+  /** 请求分发（adapter.handleRequest，HTTP/WS 共用）。 */
+  handleRequest: (req: unknown, respond: (res: unknown) => void) => void;
+}
+/** 按配置装配 OB11 传输。 */
+declare function assembleOb11Transports(opts: AssembleOb11TransportsOptions): Ob11TransportSet;
+//#endregion
+export { type AssembleOb11TransportsOptions, type AtAllRemainInfo, type CqCode, type CurrentTalkative, type FriendInfo, type GroupHonorInfo, type GroupInfo, type GroupMemberInfo, type HonorMember, type LoginInfo, MessageUnique, NapukettoOneBot11Adapter, type OB11BaseEvent, type OB11Config, type OB11Event, type OB11FriendRequestEvent, type OB11GroupMessageEvent, type OB11GroupRequestEvent, type OB11HeartbeatMetaEvent, type OB11LifecycleMetaEvent, type OB11Message, type OB11MessageEvent, type OB11MessageInfo, type OB11MessageSegment, type OB11MetaEvent, type OB11NoticeEvent, type OB11PostType, type OB11PrivateMessageEvent, type OB11RequestEvent, type OB11Return, type OB11Status, type Ob11ActionDeps, type Ob11TransportSet, type OneBot11AdapterOptions, OneBotApi, type OneBotApiOptions, type OneBotSystemOptions, type Sender, type Sex, type StrangerInfo, type VersionInfo, assembleOb11Transports, canonicalToCqMessage, canonicalToSegments, cqMessageToCanonical, cqMessageToSegments, createOb11ActionRegistry, encodeCqCode, escapeCqParam, escapeCqText, ob11ConfigSchema, ob11ErrorCodeMap, parseCqMessage, segmentsToCanonical, segmentsToCqMessage, serializeCqParts, unescapeCqText };
+//# sourceMappingURL=index.d.mts.map