@napuketto/adapter 0.8.4 → 0.9.0

package/dist/index-h-tsUu0j.d.mts

@@ -0,0 +1,240 @@
+import { ConfigBase, ConfigFormat, KernelErrorCode } from "@napuketto/kernel";
+import { ZodType } from "zod";
+import { EventBroadcaster } from "@napuketto/network";
+//#region src/core/base-action.d.ts
+/** 动作执行结果（含 retcode，协议错误码由协议层映射表提供）。 */
+interface ActionResult<T> {
+  retcode: number;
+  status: string;
+  data: T | null;
+  message: string;
+  echo?: unknown;
+}
+/** 协议错误码映射表：KernelErrorCode → 协议错误码（各协议各自实现，ADR-017）。 */
+type ErrorCodeMap = Record<KernelErrorCode, number>;
+/** 动作基类：校验失败 retcode=400（HTTP）/1400（WS）。 */
+declare abstract class BaseAction<TPayload, TReturn> {
+  abstract readonly name: string;
+  abstract readonly schema: ZodType<TPayload>;
+  protected abstract readonly errorCodeMap: ErrorCodeMap;
+  /** 校验并执行（HTTP 入口）。 */
+  handle(payload: unknown): Promise<ActionResult<TReturn>>;
+  /** 校验并执行（WS 入口，echo 透传）。 */
+  websocketHandle(payload: unknown, echo?: unknown): Promise<ActionResult<TReturn>>;
+  private run;
+  protected abstract _handle(payload: TPayload): Promise<TReturn>;
+  private mapError;
+  private fail;
+}
+//#endregion
+//#region src/core/action-registry.d.ts
+declare class ActionRegistry<TAction extends {
+  name: string;
+} = BaseAction<unknown, unknown>> {
+  private readonly actions;
+  register(action: TAction): void;
+  get(name: string): TAction | undefined;
+  has(name: string): boolean;
+  get names(): string[];
+}
+//#endregion
+//#region src/core/adapter-registry.d.ts
+/**
+ * 适配器注册表：cli 按 enabledProtocols 装配用。
+ */
+/** 协议适配器基类类型（避免 core 与具体协议循环依赖的轻量接口）。 */
+interface ProtocolAdapterLike {
+  readonly protocol: string;
+  start: () => Promise<void>;
+  stop: () => Promise<void>;
+}
+declare class AdapterRegistry {
+  private readonly adapters;
+  register(adapter: ProtocolAdapterLike): void;
+  get(protocol: string): ProtocolAdapterLike | undefined;
+  startAll(): Promise<void>;
+  stopAll(): Promise<void>;
+}
+//#endregion
+//#region src/core/config.d.ts
+/** 协议配置基类：zod schema + 文本读写（JSON/TOML，文件路径由装配层传入）。 */
+declare class ProtocolConfig<T> extends ConfigBase<T> {
+  constructor(opts: {
+    path: string;
+    schema: ZodType<T>;
+    defaults: T;
+    /** 内存初值（全局 TOML 分段装配：seed 存在时 load() 直接用它）。 */
+    seed?: T;
+    format?: ConfigFormat;
+  });
+}
+//#endregion
+//#region src/core/base-protocol-adapter.d.ts
+/** 适配器生命周期钩子：由协议层实现（配置校验、初始化、资源清理）。 */
+interface ProtocolHooks {
+  /** 配置校验通过后初始化（如建立 kernel 事件订阅）。 */
+  onStart: (config: unknown) => Promise<void>;
+  /** 停止时清理资源（退订、关闭传输等）。 */
+  onStop: () => Promise<void>;
+  /** 配置热更新。 */
+  onReload: (config: unknown) => Promise<void>;
+}
+/**
+ * 协议适配器骨架。
+ * @typeParam TConfig - 协议配置类型
+ */
+declare abstract class BaseProtocolAdapter<TConfig> {
+  abstract readonly protocol: string;
+  protected readonly config: ProtocolConfig<TConfig>;
+  protected readonly hooks: ProtocolHooks;
+  private readonly broadcaster;
+  private started;
+  constructor(opts: {
+    config: ProtocolConfig<TConfig>;
+    hooks: ProtocolHooks;
+    broadcaster?: EventBroadcaster;
+  });
+  /** 启动：加载配置 → 校验 → 协议层初始化。 */
+  start(): Promise<void>;
+  /** 停止：协议层清理资源。 */
+  stop(): Promise<void>;
+  /** 配置热更新：重新加载 → 校验 → 协议层处理。 */
+  reload(): Promise<void>;
+  /** 广播协议事件给所有 network 适配器。 */
+  protected broadcastEvent<T>(event: T): void;
+  /** 获取广播器（传输装配等内部使用；未传入返回 undefined）。 */
+  protected getBroadcaster(): EventBroadcaster | undefined;
+}
+//#endregion
+//#region src/core/media.d.ts
+/**
+ * 语音转码：非 silk 输入（任意音频格式，经 @napuketto/media 归一化）转 silk。
+ * 已是 silk（#!SILK_V3 头）原样返回；转码失败原样返回（由 kernel 发送时兜底）。
+ */
+declare function ensureSilk(path: string): Promise<string>;
+//#endregion
+//#region src/core/sysmsg.d.ts
+/**
+ * sysmsg 解码与识别共享层（2026-11-01 自 onebot11/helper/sysmsg.ts 上移，
+ * milky.md §0.8.3/§0.8.6——OB11 与 Milky 共用同一识别机制）
+ *
+ * Msg/onRecvSysMsg 是群名片/头衔/精华/表情回应等系统事件的 sys msg 总闸，payload =
+ * 原始 protobuf 字节（djinni int8 数组透传，实测 `[[10,64,…]]` 形状）。本模块：
+ *  - decodeProtoTree：手写 protobuf wire-format 解码器（varint/length-delimited，
+ *    零依赖，BigInt 保 64 位精度）
+ *  - narrowSysMsgBlobs：回调参数防御性收窄（未知形状 → null，调用方打 raw 日志）
+ *  - extractSysMsgEnvelope：按实测样本布局提取信封（逐字段可空）
+ *  - recognizeSysMsg + SysMsgKindRule<TEvent>：(msgType, subType) → 协议事件。
+ *    识别表按协议各自维护（onebot11/helper/sysmsg.ts / milky/helper/sysmsg.ts），
+ *    表条目随录制窗口样本扩充；未识别一律走结构化校准日志，不广播。
+ *
+ * 证据：真实样本（c3 观测窗 2026-09-09 双样本 528/382）+ 批次三轮录制
+ * （2026-11-01，732:16 / 732:1 / 732:21 / 528:349/381/382，wire bytes 全量解码，
+ * milky.md §0.8.6 识别表）+ wrapper.node OnSysMsg* 处理器分类学（原生分发键 =
+ * msg_type/sub_type）。翻译纯函数（ADR-008）。
+ */
+/** protobuf 字段树节点（判别联合）。 */
+type SysMsgField = {
+  readonly no: number;
+  readonly kind: "varint";
+  /** 原始 64 位值（BigInt；安全转换走 varintToNumber）。 */
+  readonly value: bigint;
+} | {
+  readonly no: number;
+  readonly kind: "bytes";
+  readonly value: Uint8Array;
+  /** 子树（try-parse 成功时；null = 不透明字节，empty [] = 空消息）。 */
+  readonly children: readonly SysMsgField[] | null;
+};
+/**
+ * 解码 protobuf wire-format 为递归字段树（不维护字段重复/顺序语义以外的信息）。
+ *
+ * - wire 0 varint / wire 2 length-delimited：支持；wire 2 递归 try-parse，
+ *   子解析失败按不透明字节挂树（ASCII 串偶发误判嵌套无实害——树仅用于观测）。
+ * - wire 1/5（fixed64/32）：跳过（QQ NT blob 未观测到，防御性兼容）。
+ * - wire 3/4（group）、截断、field 0、超限：判失败返回 null。
+ */
+declare function decodeProtoTree(data: Uint8Array, depth?: number): readonly SysMsgField[] | null;
+/** 取字段号首个命中的节点（规则实现用，路径导航原语）。 */
+declare function firstField(tree: readonly SysMsgField[] | null, no: number): SysMsgField | undefined;
+/** bytes 节点的子树（非 bytes/不透明 → null）。 */
+declare function getChildren(field: SysMsgField | undefined): readonly SysMsgField[] | null;
+/** varint → number（超安全整数返回 null，调用方按缺字段处理）。 */
+declare function varintToNumber(value: bigint): number | null;
+/** UTF-8 严格解码 + 可打印检查（含控制字符判不可解码，返回 null）。 */
+declare function decodeText(bytes: Uint8Array): string | null;
+/** 递归收集树内全部可打印字符串（校准观测用；先序遍历，空字节段跳过）。 */
+declare function collectStrings(tree: readonly SysMsgField[]): string[];
+/** 按字段号路径下钻 bytes 子树（每段取首个命中；任一段不成立 → null）。 */
+declare function nodeAt(tree: readonly SysMsgField[] | null, path: readonly number[]): readonly SysMsgField[] | null;
+/** 按路径取 varint 数值（bytes 子树末段的 varint 字段；缺失 → null）。 */
+declare function varintAt(tree: readonly SysMsgField[] | null, path: readonly number[]): number | null;
+/** 单节点内 varint 字段数值（缺失 → null）。 */
+declare function varintOf(node: readonly SysMsgField[] | null, no: number): number | null;
+/** 单节点内 UTF-8 字符串字段（缺失/不可解码 → null）。 */
+declare function textOf(node: readonly SysMsgField[] | null, no: number): string | null;
+/**
+ * onRecvSysMsg 参数 → sysmsg 字节块列表（防御性收窄）。
+ * 接受批数组（实测形状）/ 单块裸数组 / TypedArray；零有效块返回 null
+ * （调用方打 raw 日志，与 narrowOfflineFiles 同模式）。
+ */
+declare function narrowSysMsgBlobs(arg: unknown): readonly Uint8Array[] | null;
+/** 实测样本信封（全部可空 = 提取失败不打死整条事件）。 */
+interface SysMsgEnvelope {
+  /** f1.f1：行为人 uin（观测 = 自身账号；语义待校准）。 */
+  actorUin: number | null;
+  /** f1.f2：行为人 uid。 */
+  actorUid: string | null;
+  /** f1.f5：对象 uin（观测与 actor 相等）。 */
+  targetUin: number | null;
+  /** f1.f6：对象 uid。 */
+  targetUid: string | null;
+  /** f2.f1：msgType（原生分发键之一）。 */
+  msgType: number | null;
+  /** f2.f2：subType（原生分发键之一）。 */
+  subType: number | null;
+  /** f2.f3：备用 subType（观测恒等于 subType）。 */
+  subTypeAlt: number | null;
+  /** f2.f4/f5：群标识对（观测恒相邻整数，语义待校准）。 */
+  groupCodes: readonly [number, number] | null;
+  /** f2.f6：事件时间戳（秒）。 */
+  time: number | null;
+  /** 树内全部可打印字符串（校准观测用，含 base64 文本）。 */
+  strings: readonly string[];
+}
+/** 字段树 → 信封（任何字段缺失/非法 = null，不抛错）。 */
+declare function extractSysMsgEnvelope(tree: readonly SysMsgField[]): SysMsgEnvelope;
+/**
+ * 单条识别规则：表命中后从字段树提取协议事件体；提取失败 → null（降级校准日志）。
+ *
+ * - `kind`：协议侧事件种类（OB11 notice_type / Milky event_type）。
+ * - `collectUids`（可选）：声明提取所需的 uid 集合——调用方批量 uid→uin 后经
+ *   `uinOf` 解析器传入 extract（OB11 group_card 场景；不需要则不声明）。
+ * - `uinOf`：uid → uin 解析器（未收集/解析失败返回 0，协议侧口径自定）。
+ */
+/** 规则执行上下文（信封与调用方装配信息，OB11 补 base 事件头用）。 */
+interface SysMsgRuleContext {
+  /** 机器人自身 uin（数值）。 */
+  selfUin: number;
+  /** 事件时间（Unix 秒；sysmsg 信封 f2.f6，缺省进程当时）。 */
+  time: number;
+}
+interface SysMsgKindRule<TEvent> {
+  readonly kind: string;
+  collectUids?(tree: readonly SysMsgField[], env: SysMsgEnvelope): readonly string[];
+  extract(tree: readonly SysMsgField[], env: SysMsgEnvelope, uinOf: (uid: string) => number, ctx: SysMsgRuleContext): TEvent | null;
+}
+/** 识别结果三态。 */
+type SysMsgRecognition<TEvent> = {
+  readonly kind: "notice";
+  readonly rule: SysMsgKindRule<TEvent>;
+} | {
+  readonly kind: "observed_unnamed";
+} | {
+  readonly kind: "unknown";
+};
+/** 字节块 → 小写 hex（校准日志用；超长由调用方截断）。 */
+declare function toHex(bytes: Uint8Array): string;
+//#endregion
+export { ProtocolAdapterLike as C, ErrorCodeMap as D, BaseAction as E, AdapterRegistry as S, ActionResult as T, varintToNumber as _, collectStrings as a, ProtocolHooks as b, extractSysMsgEnvelope as c, narrowSysMsgBlobs as d, nodeAt as f, varintOf as g, varintAt as h, SysMsgRecognition as i, firstField as l, toHex as m, SysMsgField as n, decodeProtoTree as o, textOf as p, SysMsgKindRule as r, decodeText as s, SysMsgEnvelope as t, getChildren as u, ensureSilk as v, ActionRegistry as w, ProtocolConfig as x, BaseProtocolAdapter as y };
+//# sourceMappingURL=index-h-tsUu0j.d.mts.map

package/dist/index-h-tsUu0j.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-h-tsUu0j.d.mts","names":[],"sources":["../src/core/base-action.ts","../src/core/action-registry.ts","../src/core/adapter-registry.ts","../src/core/config.ts","../src/core/base-protocol-adapter.ts","../src/core/media.ts","../src/core/sysmsg.ts"],"mappings":";;;;;UAgBiB,aAAa;EAC1B;EACA;EACA,MAAM;EACN;EACA;;;KAIQ,eAAe,OAAO;;uBAGZ,WAAW,UAAU;oBACrB;oBACA,QAAQ,QAAQ;8BACN,cAAc;;EAG1C,OAAO,mBAAmB,QAAQ,aAAa;;EAKzC,gBAAgB,kBAAkB,iBAAiB,QAAQ,aAAa;UAQhE;qBAaK,QAAQ,SAAS,WAAW,QAAQ;UAE/C;UAaA;;;;cCrEC,eAAe;EAAkB;IAAiB;mBAC1C;EAEjB,SAAS,QAAQ;EAIjB,IAAI,eAAe;EAInB,IAAI;MAIA;;;;;;;;UChBS;WACJ;EACT,aAAa;EACb,YAAY;;cAGH;mBACQ;EAEjB,SAAS,SAAS;EAIlB,IAAI,mBAAmB;EAIjB,YAAY;EAIZ,WAAW;;;;;cClBR,eAAe,WAAW,WAAW;EAC9C,YAAY;IACR;IACA,QAAQ,QAAQ;IAChB,UAAU;;IAEV,OAAO;IACP,SAAS;;;;;;UCJA;;EAEb,UAAU,oBAAoB;;EAE9B,cAAc;;EAEd,WAAW,oBAAoB;;;;;;uBAOb,oBAAoB;oBACpB;qBAEC,QAAQ,eAAe;qBACvB,OAAO;mBACT;UACT;EAER,YAAY;IACR,QAAQ,eAAe;IACvB,OAAO;IACP,cAAc;;;EAQZ,SAAS;;EAUT,QAAQ;;EASR,UAAU;;YAQN,eAAe,GAAG,OAAO;;YAKzB,kBAAkB;;;;;;;;iBCjDV,WAAW,eAAe;;;;;;;;;;;;;;;;;;;;;;;KCQpC;WAEO;WACA;;WAEA;;WAGA;WACA;WACA,OAAO;;WAEP,mBAAmB;;;;;;;;;;iBAoItB,gBAAgB,MAAM,YAAY,0BAAqB;;iBAuBvD,WACZ,eAAe,sBACf,aACD;;iBAKa,YAAY,OAAO,mCAAmC;;iBAKtD,eAAe;;iBAKf,WAAW,OAAO;;iBAgBlB,eAAe,eAAe;;iBAkB9B,OACZ,eAAe,sBACf,mCACQ;;iBAYI,SACZ,eAAe,sBACf;;iBAWY,SAAS,eAAe,sBAAsB;;iBAM9C,OAAO,eAAe,sBAAsB;;;;;;iBAsD5C,kBAAkB,wBAAwB;;UAoBzC;;EAEb;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;;iBA0CY,sBAAsB,eAAe,gBAAgB;;;;;;;;;;UAyBpD;;EAEb;;EAEA;;UAGa,eAAe;WACnB;EACT,aAAa,eAAe,eAAe,KAAK;EAChD,QACI,eAAe,eACf,KAAK,gBACL,QAAQ,wBACR,KAAK,oBACN;;;KAIK,kBAAkB;WACb;WAAyB,MAAM,eAAe;;WAC9C;;WACA;;;iBAyBD,MAAM,OAAO"}

package/dist/kurobot/index.d.mts

@@ -1,4 +1,4 @@
-import { i as ProtocolConfig, n as BaseProtocolAdapter } from "../index-CDKj-jus.mjs";
+import { x as ProtocolConfig, y as BaseProtocolAdapter } from "../index-h-tsUu0j.mjs";
 import { CanonicalElement, MsgEventChannel, Peer, RawMessage } from "@napuketto/kernel";
 import { z } from "zod";
 //#region src/kurobot/config.d.ts

package/dist/kurobot/index.mjs

@@ -1,4 +1,4 @@
-import { r as BaseProtocolAdapter } from "../core-DyXyDUcU.mjs";
+import { _ as BaseProtocolAdapter } from "../core-DW5i42XH.mjs";
 import { t as forEachRawMessage } from "../raw-message-D_ecJy4C.mjs";
 import { createRequire } from "node:module";
 import { ChatType, toCanonicalElements } from "@napuketto/kernel";

package/dist/milky/index.d.mts

@@ -1,5 +1,5 @@
-import { i as ProtocolConfig, n as BaseProtocolAdapter, s as ActionRegistry } from "../index-CDKj-jus.mjs";
-import { BuddyEventChannel, ChatType, FriendApi, GroupApi, GroupCache, GroupEventChannel, GroupNotifyApi, KernelErrorCode, MsgApi, MsgEventChannel, Peer, ProfileApi, ProfileLikeApi, RawMessage, RecentContactApi, RichMediaApi, TicketApi, WebApi } from "@napuketto/kernel";
+import { w as ActionRegistry, x as ProtocolConfig, y as BaseProtocolAdapter } from "../index-h-tsUu0j.mjs";
+import { BuddyEventChannel, ChatType, FriendApi, GroupApi, GroupCache, GroupEventChannel, GroupNotifyApi, KernelErrorCode, LoginEventChannel, MsgApi, MsgEventChannel, Peer, ProfileApi, ProfileLikeApi, RawMessage, RecentContactApi, RecentContactEventChannel, RichMediaApi, TicketApi, WebApi } from "@napuketto/kernel";
 import { ZodType, z } from "zod";
 import { EventBroadcaster, TransportAdapter } from "@napuketto/network";
 //#region src/milky/helper/seq-index.d.ts
@@ -81,8 +81,9 @@ declare const milkyConfigSchema: z.ZodObject<{
 type MilkyConfig = z.infer<typeof milkyConfigSchema>;
 //#endregion
 //#region src/milky/transport.d.ts
-/** 校准 logger 最小面（webhook 失败 / 配置异常提示；缺省静默）。 */
+/** 校准 logger 最小面（webhook 失败 / 配置异常 / 批次三事件校准数据；缺省静默）。 */
 interface MilkyLoggerLike {
+  debug(obj: unknown, msg?: string): void;
   warn(obj: unknown, msg?: string): void;
   info(obj: unknown, msg?: string): void;
 }
@@ -187,6 +188,10 @@ interface MilkyAdapterOptions extends MilkyApiOptions {
   groupChannel?: GroupEventChannel;
   /** kernel 好友事件通道（P1：好友申请推送；缺省不订阅）。 */
   buddyChannel?: BuddyEventChannel;
+  /** kernel 会话列表事件通道（批次三：peer_pin_change；缺省不订阅）。 */
+  recentContactChannel?: RecentContactEventChannel;
+  /** kernel 登录状态事件通道（批次三：bot_offline；缺省不订阅）。 */
+  loginChannel?: LoginEventChannel;
   /** 校准日志（webhook 失败 / 启停提示 / 未知事件形状；IPC 模式传 loader pino 实例）。 */
   logger?: MilkyLoggerLike;
 }
@@ -195,6 +200,18 @@ declare class NapukettoMilkyAdapter extends BaseProtocolAdapter<MilkyConfig> {
   private readonly msgChannel;
   private readonly groupChannel;
   private readonly buddyChannel;
+  private readonly recentContactChannel;
+  private readonly loginChannel;
+  /** peer_pin 翻转检测（批次三；启动期 getPinnedContacts 播种）。 */
+  private readonly pinWatch;
+  /** friend_file_upload 双回调去重（同载荷，按 msgId）。 */
+  private readonly fileKeys;
+  /** essence 双路径去重（732:1 快路径 vs 列表 diff，键 群:seq:方向）。 */
+  private readonly essenceKeys;
+  /** 精华列表缓存（群号 → seq → 操作者 uin，空串 = 未知）。 */
+  private readonly essenceCaches;
+  /** 精华列表拉取串行链（并发回写乱序会把新列表覆盖成旧列表）。 */
+  private essenceChain;
   private readonly calibLogger;
   private readonly api;
   private readonly seqIndex;
@@ -211,6 +228,10 @@ declare class NapukettoMilkyAdapter extends BaseProtocolAdapter<MilkyConfig> {
   private stopAll;
   /** 订阅 kernel 事件（消息 + 群通知 + 好友请求，幂等）。 */
   private subscribe;
+  /** 群通知 + 好友请求通道（P1 事件源；通道缺省不订阅）。 */
+  private subscribeGroupAndBuddy;
+  /** 批次三通道：精华列表变更 / 置顶翻转（含播种基线）/ bot_offline。 */
+  private subscribeBatch3;
   /** 退订（幂等）。 */
   private unsubscribeAll;
   /** 单条消息：seq 登记 → grayTip→notice / 群文件上传 / message_receive（自消息不上报）。 */
@@ -235,6 +256,39 @@ declare class NapukettoMilkyAdapter extends BaseProtocolAdapter<MilkyConfig> {
   private fillGroupEntities;
   /** 转发 resId → 定位登记（get_forwarded_messages 反查用）。 */
   private recordForward;
+  /**
+   * sysmsg 总闸：解码 → 识别 → 表命中才广播（732:16 表情回应 / 732:1 精华
+   * 设置）；未识别 debug 校准日志。规则提取失败不广播半成品事件。
+   */
+  private handleSysMsg;
+  /** 单条字节块：解码 → 识别 → 提取；任一步失败走校准日志返回 null。 */
+  private handleSysMsgBlob;
+  /** 解码 + 识别 + 提取（每步失败各自打 debug 校准日志）。 */
+  private sysMsgHit;
+  /** 识别 + 规则提取（未识别/提取失败 → 校准日志 + null）。 */
+  private sysMsgRule;
+  /** 精华快路径去重守卫：非精华事件恒 true；精华事件 claim 失败（已由列表 diff 抢发）→ false。 */
+  private claimEssenceFastPath;
+  /** 私聊文件消息 → friend_file_upload（双回调同载荷，按 msgId 去重）。 */
+  private handleFileMessages;
+  /** 精华列表变更：拉全量列表 diff（remove 路径 + operator 回填；串行防乱序）。 */
+  private handleEssenceChange;
+  /** 单群精华列表同步：拉取 → diff → 广播 → 更新缓存（基线未建立只建基线）。 */
+  private syncEssenceList;
+  /** diff 新增项广播（is_set=true；operator = add_digest_uin；快路径已发则跳过）。 */
+  private broadcastEssenceAdded;
+  /** diff 移除项广播（is_set=false；取消无 sysmsg，operator 不可得省略）。 */
+  private broadcastEssenceRemoved;
+  /** 会话列表变更 → peer_pin_change（topFlag 翻转检测，条目自带 chatType 判场景）。 */
+  private handlePinChanges;
+  /** 单个变更列表：changedList 逐条目翻转检测 + 广播。 */
+  private handlePinChangeList;
+  /** 单个变更条目：翻译 + 翻转检测 + 广播（首见/未变/不支持场景静默跳过）。 */
+  private handlePinEntry;
+  /** 启动基线：置顶会话播种（重启后首个取消置顶也能观测到翻转；失败静默）。 */
+  private seedPinWatch;
+  /** bot_offline：Login 桥回调（载荷零样本，reason 固定值 + raw 校准日志待野捕）。 */
+  private broadcastBotOffline;
   /** uid 批量 → uin（空集/失败返回 undefined 语义：调用方用空 Map）。 */
   private resolveUidToUin;
 }

package/dist/milky/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/milky/helper/seq-index.ts","../../src/milky/action/error-map.ts","../../src/milky/action/base-action.ts","../../src/milky/config.ts","../../src/milky/transport.ts","../../src/milky/api.ts","../../src/milky/action/index.ts","../../src/milky/adapter.ts"],"mappings":";;;;;;UAuBiB;EACb,UAAU;EACV;EACA;;cAGS;;mBAEQ;;mBAEA;;mBAEA;;EAGjB,OAAO,KAAK;;EAeZ,aAAa,UAAU,UAAU,iBAAiB;;;;;EAQlD,iBACI,mBACD;IAAc;IAAoB;IAAkB;;;UAgB/C;;;;;EAQR,cAAc,eAAe,OAAO;;EAepC,eAAe,gBAAgB;;UAKvB;;;;;KClGA,oBAAoB,OAAO;;;;UCItB,kBAAkB;EAC/B;EACA;EACA,MAAM;EACN;;uBAYkB,YAAY,UAAU;oBACtB;oBACA,QAAQ,QAAQ;8BACN,cAAc;qBAEvB,QAAQ,SAAS,WAAW,QAAQ;;EAGjD,OAAO,mBAAmB,QAAQ,kBAAkB;;;;;cC5BjD,mBAAiB,EAAA;;;;;;;;;;;GAe5B,EAAA,KAAA;;KAGU,cAAc,EAAE,aAAa;;;;UCQxB;EACb,KAAK,cAAc;EACnB,KAAK,cAAc;;;;;UCTN;EACb,QAAQ;EACR,UAAU;EACV,WAAW;EACX,YAAY;;EAEZ,gBAAgB;EAChB,WAAW;EACX,QAAQ;EACR,gBAAgB;EAChB,cAAc;;EAEd,kBAAkB;;EAElB;IAAQ;IAAa;IAAkB;;;EAEvC,aAAa;;EAEb;;EAEA;;EAEA;;EAEA,SAAS;;cAGA;WACA,QAAQ;WACR,UAAU;WACV,WAAW;WACX,YAAY;WACZ,gBAAgB;WAChB,WAAW;WACX,QAAQ;WACR,gBAAgB;WAChB,cAAc;WACd,kBAAkB;WAClB;IAAQ;IAAa;IAAkB;;WACvC,YAAY;WACZ;WACA;WACA;;WAEA,QAAQ;;WAER,UAAU;EAEnB,YAAY,MAAM,iBAAiB,UAAU;;EAqB7C,SAAS,iBAAiB,QAAQ;;EAKlC,SAAS,iBAAiB,QAAQ;;;;;EAQ5B,kBAAkB,uBAAuB;;;;;EAiBzC,YAAY,oCAAoC,aAAa,QAAQ;;;;;EAqBrE,kBACF,MAAM,MACN,aACA,UAAU,mBACX;;EAeG,kBACF,MAAM,MACN,gBACD;IAAU;IAAqB;;;;;;iBCrFtB,0BAA0B;EACtC,KAAK;IACL,eAAe;;;;UCxCF,4BAA4B;EACzC,QAAQ,eAAe;EACvB,aAAa;;EAEb,YAAY;;EAEZ,eAAe;;EAEf,eAAe;;EAEf,SAAS;;cAGA,8BAA8B,oBAAoB;WAClD;mBAEQ;mBACA;mBACA;mBACA;mBACA;mBACA;;WAER,UAAU,kBAAkB;UAC7B;UACA;EAER,YAAY,MAAM;;UAoBJ;;UA2BA;;UAMA;;UASN;;UA4BA;;UAQM;;UAuBA;;UAeN;;UASM;;UAWN;;UAkBM;;UASA;;UAgBA;;UAkBN;;UAWM;;UAaN;;UAcA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/milky/helper/seq-index.ts","../../src/milky/action/error-map.ts","../../src/milky/action/base-action.ts","../../src/milky/config.ts","../../src/milky/transport.ts","../../src/milky/api.ts","../../src/milky/action/index.ts","../../src/milky/adapter.ts"],"mappings":";;;;;;UAuBiB;EACb,UAAU;EACV;EACA;;cAGS;;mBAEQ;;mBAEA;;mBAEA;;EAGjB,OAAO,KAAK;;EAeZ,aAAa,UAAU,UAAU,iBAAiB;;;;;EAQlD,iBACI,mBACD;IAAc;IAAoB;IAAkB;;;UAgB/C;;;;;EAQR,cAAc,eAAe,OAAO;;EAepC,eAAe,gBAAgB;;UAKvB;;;;;KClGA,oBAAoB,OAAO;;;;UCItB,kBAAkB;EAC/B;EACA;EACA,MAAM;EACN;;uBAYkB,YAAY,UAAU;oBACtB;oBACA,QAAQ,QAAQ;8BACN,cAAc;qBAEvB,QAAQ,SAAS,WAAW,QAAQ;;EAGjD,OAAO,mBAAmB,QAAQ,kBAAkB;;;;;cC5BjD,mBAAiB,EAAA;;;;;;;;;;;GAe5B,EAAA,KAAA;;KAGU,cAAc,EAAE,aAAa;;;;UCQxB;EACb,MAAM,cAAc;EACpB,KAAK,cAAc;EACnB,KAAK,cAAc;;;;;UCVN;EACb,QAAQ;EACR,UAAU;EACV,WAAW;EACX,YAAY;;EAEZ,gBAAgB;EAChB,WAAW;EACX,QAAQ;EACR,gBAAgB;EAChB,cAAc;;EAEd,kBAAkB;;EAElB;IAAQ;IAAa;IAAkB;;;EAEvC,aAAa;;EAEb;;EAEA;;EAEA;;EAEA,SAAS;;cAGA;WACA,QAAQ;WACR,UAAU;WACV,WAAW;WACX,YAAY;WACZ,gBAAgB;WAChB,WAAW;WACX,QAAQ;WACR,gBAAgB;WAChB,cAAc;WACd,kBAAkB;WAClB;IAAQ;IAAa;IAAkB;;WACvC,YAAY;WACZ;WACA;WACA;;WAEA,QAAQ;;WAER,UAAU;EAEnB,YAAY,MAAM,iBAAiB,UAAU;;EAqB7C,SAAS,iBAAiB,QAAQ;;EAKlC,SAAS,iBAAiB,QAAQ;;;;;EAQ5B,kBAAkB,uBAAuB;;;;;EAiBzC,YAAY,oCAAoC,aAAa,QAAQ;;;;;EAqBrE,kBACF,MAAM,MACN,aACA,UAAU,mBACX;;EAeG,kBACF,MAAM,MACN,gBACD;IAAU;IAAqB;;;;;;iBCrFtB,0BAA0B;EACtC,KAAK;IACL,eAAe;;;;UCpBF,4BAA4B;EACzC,QAAQ,eAAe;EACvB,aAAa;;EAEb,YAAY;;EAEZ,eAAe;;EAEf,eAAe;;EAEf,uBAAuB;;EAEvB,eAAe;;EAEf,SAAS;;cAUA,8BAA8B,oBAAoB;WAClD;mBAEQ;mBACA;mBACA;mBACA;mBACA;;mBAEA;;mBAEA;;mBAEA;;mBAEA;;UAET;mBACS;mBACA;mBACA;;WAER,UAAU,kBAAkB;UAC7B;UACA;EAER,YAAY,MAAM;;UAsBJ;;UA2BA;;UAMA;;UASN;;UA6BA;;UAoBA;;UAiCA;;UAQM;;UAuBA;;UAeN;;UASM;;UAWN;;UAkBM;;UASA;;UAgBA;;UAkBN;;UAWM;;UAaN;;;;;UAsBA;;UAeA;;UAiBA;;UAkBA;;UAmCA;;UASA;;UA2BA;;UAgBM;;UAwBN;;UAsBA;;UAoBA;;UAQA;;UAOA;;UAiBA;;UAUA;;UAcA"}