@napuketto/adapter 0.5.0 → 0.7.0

package/dist/buddy-req-Q7Q4bVuz.mjs

@@ -0,0 +1,43 @@
+//#region src/core/uid-uin.ts
+/**
+* uid → uin 解析（OB11 / Milky 请求与通知翻译共用，P1 2026-10-30 收敛）
+*
+* uidToUin 批量映射由调用方取得后传入；映射缺省退化为 uid 数值（wrapper 部分回调
+* 直接给 uin），非数字返回 0（调用方按 0 兜底展示）。
+*
+* request 事件翻译上下文与毫秒换算常量随本模块共享（OB11 / Milky request 同构）。
+*/
+/** 毫秒 → 秒（Unix 时间戳换算）。 */
+const MS_TO_SEC = 1e3;
+/** uid → uin（映射命中取 uin，未命中退化 uid 数值，非数字返回 0）。 */
+function resolveUin(uid, uidToUin) {
+	if (uid === void 0 || uid === "") return 0;
+	const uin = uidToUin.get(uid);
+	if (uin !== void 0) return Number(uin);
+	const n = Number(uid);
+	return Number.isFinite(n) ? n : 0;
+}
+//#endregion
+//#region src/core/buddy-req.ts
+/** BuddyReq 防御性收窄：仅接受字段形状可用的对象。 */
+function isBuddyReqLike(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const v = value;
+	return typeof v["reqTime"] === "string" && typeof v["friendUid"] === "string";
+}
+/**
+* onBuddyReqChange 回调参数 → BuddyReq 列表（防御性收窄）。
+* 已知候选形状：BuddyReq[] / { buddyReqs: BuddyReq[] }；其余返回 null。
+*/
+function narrowBuddyReqs(arg) {
+	if (Array.isArray(arg)) return arg.every(isBuddyReqLike) ? arg : null;
+	if (typeof arg === "object" && arg !== null) {
+		const reqs = arg["buddyReqs"];
+		if (Array.isArray(reqs) && reqs.every(isBuddyReqLike)) return reqs;
+	}
+	return null;
+}
+//#endregion
+export { MS_TO_SEC as n, resolveUin as r, narrowBuddyReqs as t };
+
+//# sourceMappingURL=buddy-req-Q7Q4bVuz.mjs.map

package/dist/buddy-req-Q7Q4bVuz.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"buddy-req-Q7Q4bVuz.mjs","names":[],"sources":["../src/core/uid-uin.ts","../src/core/buddy-req.ts"],"sourcesContent":["/**\n * uid → uin 解析（OB11 / Milky 请求与通知翻译共用，P1 2026-10-30 收敛）\n *\n * uidToUin 批量映射由调用方取得后传入；映射缺省退化为 uid 数值（wrapper 部分回调\n * 直接给 uin），非数字返回 0（调用方按 0 兜底展示）。\n *\n * request 事件翻译上下文与毫秒换算常量随本模块共享（OB11 / Milky request 同构）。\n */\n\n/** 毫秒 → 秒（Unix 时间戳换算）。 */\nexport const MS_TO_SEC = 1000;\n\n/** request 事件翻译上下文（uid→uin 映射，调用方批量转换）。 */\nexport interface RequestTranslateContext {\n    selfUin: string;\n    uidToUin: Map<string, string>;\n}\n\n/** uid → uin（映射命中取 uin，未命中退化 uid 数值，非数字返回 0）。 */\nexport function resolveUin(uid: string | undefined, uidToUin: Map<string, string>): number {\n    if (uid === undefined || uid === \"\") {\n        return 0;\n    }\n    const uin = uidToUin.get(uid);\n    if (uin !== undefined) {\n        return Number(uin);\n    }\n    const n = Number(uid);\n    return Number.isFinite(n) ? n : 0;\n}\n","/**\n * BuddyReq 防御收窄（OB11 / Milky 共用，P1 2026-10-30 从 onebot11 收敛）\n *\n * onBuddyReqChange 回调参数形状未经真实事件校准（wrapper 字符串证据仅有方法名），\n * 仅接受字段形状可用的对象；未知形状返回 null 由调用方打 raw 日志积累校准数据。\n */\nimport type { BuddyReq } from \"@napuketto/kernel\";\n\n/** BuddyReq 防御性收窄：仅接受字段形状可用的对象。 */\nexport function isBuddyReqLike(value: unknown): value is BuddyReq {\n    if (typeof value !== \"object\" || value === null) {\n        return false;\n    }\n    const v = value as Record<string, unknown>;\n    return typeof v[\"reqTime\"] === \"string\" && typeof v[\"friendUid\"] === \"string\";\n}\n\n/**\n * onBuddyReqChange 回调参数 → BuddyReq 列表（防御性收窄）。\n * 已知候选形状：BuddyReq[] / { buddyReqs: BuddyReq[] }；其余返回 null。\n */\nexport function narrowBuddyReqs(arg: unknown): BuddyReq[] | null {\n    if (Array.isArray(arg)) {\n        return arg.every(isBuddyReqLike) ? (arg as BuddyReq[]) : null;\n    }\n    if (typeof arg === \"object\" && arg !== null) {\n        const reqs = (arg as Record<string, unknown>)[\"buddyReqs\"];\n        if (Array.isArray(reqs) && reqs.every(isBuddyReqLike)) {\n            return reqs as BuddyReq[];\n        }\n    }\n    return null;\n}\n"],"mappings":";;;;;;;;;;AAUA,MAAa,YAAY;;AASzB,SAAgB,WAAW,KAAyB,UAAuC;CACvF,IAAI,QAAQ,KAAA,KAAa,QAAQ,IAC7B,OAAO;CAEX,MAAM,MAAM,SAAS,IAAI,GAAG;CAC5B,IAAI,QAAQ,KAAA,GACR,OAAO,OAAO,GAAG;CAErB,MAAM,IAAI,OAAO,GAAG;CACpB,OAAO,OAAO,SAAS,CAAC,IAAI,IAAI;AACpC;;;;ACpBA,SAAgB,eAAe,OAAmC;CAC9D,IAAI,OAAO,UAAU,YAAY,UAAU,MACvC,OAAO;CAEX,MAAM,IAAI;CACV,OAAO,OAAO,EAAE,eAAe,YAAY,OAAO,EAAE,iBAAiB;AACzE;;;;;AAMA,SAAgB,gBAAgB,KAAiC;CAC7D,IAAI,MAAM,QAAQ,GAAG,GACjB,OAAO,IAAI,MAAM,cAAc,IAAK,MAAqB;CAE7D,IAAI,OAAO,QAAQ,YAAY,QAAQ,MAAM;EACzC,MAAM,OAAQ,IAAgC;EAC9C,IAAI,MAAM,QAAQ,IAAI,KAAK,KAAK,MAAM,cAAc,GAChD,OAAO;CAEf;CACA,OAAO;AACX"}

package/dist/gray-tip-LwBee5mo.mjs

@@ -0,0 +1,33 @@
+//#region src/core/gray-tip.ts
+/** 非空 uid 才加入集合。 */
+function collectUids(uids, ...candidates) {
+	for (const uid of candidates) if (uid !== void 0 && uid !== "") uids.add(uid);
+}
+/** 收集 grayTip 涉及的 uid（批量 uidToUin 用）。 */
+function collectGrayTipUids(msg) {
+	const uids = /* @__PURE__ */ new Set();
+	for (const el of msg.elements) {
+		const g = el.grayTipElement;
+		if (g === void 0) continue;
+		collectUids(uids, g.revokeElement?.operatorUid, g.aioOpGrayTipElement?.peerUid);
+		const grp = g.groupElement;
+		if (grp === void 0) continue;
+		collectUids(uids, grp.memberUid, grp.adminUid, grp.shutUp?.admin?.uid, grp.shutUp?.member?.uid);
+	}
+	return [...uids];
+}
+/**
+* 第一条「已挂载但不可翻译」的 grayTip 元素（校准日志入口）。
+* 与 OB11 / Milky notice 翻译共用：翻译函数返回 null 时用本函数定位元素打 raw
+* 日志，两协议的日志口径一致（跳过 REVOKE——撤回翻译独立成事件）。
+*/
+function firstUntranslatedGrayTip(msg) {
+	for (const el of msg.elements) {
+		const g = el.grayTipElement;
+		if (g !== void 0 && g.revokeElement === void 0) return g;
+	}
+}
+//#endregion
+export { firstUntranslatedGrayTip as n, collectGrayTipUids as t };
+
+//# sourceMappingURL=gray-tip-LwBee5mo.mjs.map

package/dist/gray-tip-LwBee5mo.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gray-tip-LwBee5mo.mjs","names":[],"sources":["../src/core/gray-tip.ts"],"sourcesContent":["/**\n * grayTip 元素工具（OB11 / Satori 共用，2026-08-08 克隆合并）\n *\n * grayTip（系统提示消息）涉及的操作者/成员 uid 需要批量 uid→uin 转换，\n * 两协议翻译层共用同一套收集逻辑。\n */\nimport type { GrayTipElement, RawMessage } from \"@napuketto/kernel\";\n\n/** 非空 uid 才加入集合。 */\nfunction collectUids(uids: Set<string>, ...candidates: Array<string | undefined>): void {\n    for (const uid of candidates) {\n        if (uid !== undefined && uid !== \"\") {\n            uids.add(uid);\n        }\n    }\n}\n\n/** 收集 grayTip 涉及的 uid（批量 uidToUin 用）。 */\nexport function collectGrayTipUids(msg: RawMessage): string[] {\n    const uids = new Set<string>();\n    for (const el of msg.elements) {\n        const g = el.grayTipElement;\n        if (g === undefined) {\n            continue;\n        }\n        collectUids(uids, g.revokeElement?.operatorUid, g.aioOpGrayTipElement?.peerUid);\n        const grp = g.groupElement;\n        if (grp === undefined) {\n            continue;\n        }\n        collectUids(\n            uids,\n            grp.memberUid,\n            grp.adminUid,\n            grp.shutUp?.admin?.uid,\n            grp.shutUp?.member?.uid,\n        );\n    }\n    return [...uids];\n}\n\n/**\n * 第一条「已挂载但不可翻译」的 grayTip 元素（校准日志入口）。\n * 与 OB11 / Milky notice 翻译共用：翻译函数返回 null 时用本函数定位元素打 raw\n * 日志，两协议的日志口径一致（跳过 REVOKE——撤回翻译独立成事件）。\n */\nexport function firstUntranslatedGrayTip(msg: RawMessage): GrayTipElement | undefined {\n    for (const el of msg.elements) {\n        const g = el.grayTipElement;\n        if (g !== undefined && g.revokeElement === undefined) {\n            return g;\n        }\n    }\n    return undefined;\n}\n"],"mappings":";;AASA,SAAS,YAAY,MAAmB,GAAG,YAA6C;CACpF,KAAK,MAAM,OAAO,YACd,IAAI,QAAQ,KAAA,KAAa,QAAQ,IAC7B,KAAK,IAAI,GAAG;AAGxB;;AAGA,SAAgB,mBAAmB,KAA2B;CAC1D,MAAM,uBAAO,IAAI,IAAY;CAC7B,KAAK,MAAM,MAAM,IAAI,UAAU;EAC3B,MAAM,IAAI,GAAG;EACb,IAAI,MAAM,KAAA,GACN;EAEJ,YAAY,MAAM,EAAE,eAAe,aAAa,EAAE,qBAAqB,OAAO;EAC9E,MAAM,MAAM,EAAE;EACd,IAAI,QAAQ,KAAA,GACR;EAEJ,YACI,MACA,IAAI,WACJ,IAAI,UACJ,IAAI,QAAQ,OAAO,KACnB,IAAI,QAAQ,QAAQ,GACxB;CACJ;CACA,OAAO,CAAC,GAAG,IAAI;AACnB;;;;;;AAOA,SAAgB,yBAAyB,KAA6C;CAClF,KAAK,MAAM,MAAM,IAAI,UAAU;EAC3B,MAAM,IAAI,GAAG;EACb,IAAI,MAAM,KAAA,KAAa,EAAE,kBAAkB,KAAA,GACvC,OAAO;CAEf;AAEJ"}

package/dist/milky/index.d.mts

@@ -1,13 +1,21 @@
 import { i as ProtocolConfig, n as BaseProtocolAdapter, s as ActionRegistry } from "../index-CDKj-jus.mjs";
-import { ChatType, FriendApi, GroupApi, GroupCache, KernelErrorCode, MsgApi, MsgEventChannel, Peer, ProfileApi, RawMessage } from "@napuketto/kernel";
+import { BuddyEventChannel, ChatType, FriendApi, GroupApi, GroupCache, GroupEventChannel, GroupNotifyApi, KernelErrorCode, MsgApi, MsgEventChannel, Peer, ProfileApi, ProfileLikeApi, RawMessage, 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
+/** 合并转发 resId → 定位信息（get_forwarded_messages 取 peer 用）。 */
+interface ForwardEntry {
+  chatType: ChatType;
+  peerUid: string;
+  msgId: string;
+}
 declare class MessageSeqIndex {
   /** `${chatType}:${peerUid}:${seq}` → msgId。 */
   private readonly seqToMsg;
   /** msgId → seq 元信息。 */
   private readonly msgToMeta;
+  /** 合并转发 resId → 定位信息（P1：get_forwarded_messages）。 */
+  private readonly forwards;
   /** 接收链路登记（一条消息双向写入；重复 msgId 覆盖）。 */
   record(msg: RawMessage): void;
   /** seq → msgId（反查；未登记返回 undefined）。 */
@@ -23,10 +31,62 @@ declare class MessageSeqIndex {
   }>;
   /** key 规则（chatType 数值 + peerUid + seq；peerUid 群聊=群号，C2C=uid）。 */
   private key;
+  /**
+   * 登记合并转发（接收链路：消息含 multiForwardMsgElement 时调用）。
+   * resId 是 Milky forward_id 的来源；同一 resId 重复覆盖。
+   */
+  recordForward(resId: string, entry: ForwardEntry): void;
+  /** resId → 转发定位（get_forwarded_messages；未登记返回 undefined）。 */
+  resolveForward(resId: string): ForwardEntry | undefined;
   /** FIFO 淘汰到容量上限内。 */
   private evict;
 }
 //#endregion
+//#region src/milky/action/error-map.d.ts
+/** KernelErrorCode → Milky retcode 映射表（-400/-403 规范语义，其余自定负数）。 */
+type MilkyErrorCodeMap = Record<KernelErrorCode, number>;
+//#endregion
+//#region src/milky/action/base-action.d.ts
+/** Milky 动作结果（retcode 为规范负数族；transport 原样组装信封）。 */
+interface MilkyActionResult<T> {
+  status: "ok" | "failed";
+  retcode: number;
+  data: T | null;
+  message: string;
+}
+declare abstract class MilkyAction<TPayload, TReturn> {
+  abstract readonly name: string;
+  abstract readonly schema: ZodType<TPayload>;
+  protected abstract readonly errorCodeMap: MilkyErrorCodeMap;
+  protected abstract _handle(payload: TPayload): Promise<TReturn>;
+  /** 校验并执行（HTTP /api 入口；WS /event 不承载动作）。 */
+  handle(payload: unknown): Promise<MilkyActionResult<TReturn>>;
+}
+//#endregion
+//#region src/milky/config.d.ts
+/** Milky 配置 schema。 */
+declare const milkyConfigSchema: z.ZodObject<{
+  enabled: z.ZodDefault<z.ZodBoolean>;
+  host: z.ZodDefault<z.ZodString>;
+  port: z.ZodDefault<z.ZodNumber>;
+  token: z.ZodDefault<z.ZodString>;
+  eventModes: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+    sse: "sse";
+    ws: "ws";
+  }>>>;
+  webhooks: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  cacheDir: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Milky 配置类型（由 schema 推导）。 */
+type MilkyConfig = z.infer<typeof milkyConfigSchema>;
+//#endregion
+//#region src/milky/transport.d.ts
+/** 校准 logger 最小面（webhook 失败 / 配置异常提示；缺省静默）。 */
+interface MilkyLoggerLike {
+  warn(obj: unknown, msg?: string): void;
+  info(obj: unknown, msg?: string): void;
+}
+//#endregion
 //#region src/milky/api.d.ts
 /** MilkyApi 构造参数。 */
 interface MilkyApiOptions {
@@ -34,10 +94,17 @@ interface MilkyApiOptions {
   groupApi: GroupApi;
   friendApi: FriendApi;
   profileApi: ProfileApi;
-  /** 登录身份（get_login_info / self_id 用）。 */
+  /** P1 扩面依赖（表态度 / 票据 / 精华列表 / 群通知 / 群文件）。 */
+  profileLikeApi: ProfileLikeApi;
+  ticketApi: TicketApi;
+  webApi: WebApi;
+  groupNotifyApi: GroupNotifyApi;
+  richMediaApi: RichMediaApi;
+  /** 登录身份（get_login_info / self_id / target_user_uid 用）。 */
   self: {
     uin: string;
     nickname: string;
+    uid?: string;
   };
   /** 群/成员缓存（群实体回填 / get_group_list；未装配时动作直查 api）。 */
   groupCache?: GroupCache;
@@ -47,27 +114,42 @@ interface MilkyApiOptions {
   implVersion: string;
   /** 发送媒体 http(s)/base64 URI 下载缓存目录（缺省 = 远程媒体发送不可用）。 */
   mediaDir?: string;
+  /** 动作层可观测出口（P2 批次一：forward 临时消息撤回失败 warn；缺省静默）。 */
+  logger?: MilkyLoggerLike;
 }
 declare class MilkyApi {
   readonly msgApi: MsgApi;
   readonly groupApi: GroupApi;
   readonly friendApi: FriendApi;
   readonly profileApi: ProfileApi;
+  readonly profileLikeApi: ProfileLikeApi;
+  readonly ticketApi: TicketApi;
+  readonly webApi: WebApi;
+  readonly groupNotifyApi: GroupNotifyApi;
+  readonly richMediaApi: RichMediaApi;
   readonly self: {
     uin: string;
     nickname: string;
+    uid?: string;
   };
   readonly groupCache: GroupCache | undefined;
   readonly qqVersion: string;
   readonly implVersion: string;
   readonly mediaDir: string | undefined;
+  /** 动作层可观测出口（缺省静默）。 */
+  readonly logger: MilkyLoggerLike | undefined;
   /** message_seq ↔ msgId 双向映射（接收链路 record，动作侧反查）。 */
   readonly seqIndex: MessageSeqIndex;
   constructor(opts: MilkyApiOptions, seqIndex: MessageSeqIndex);
-  /** uin → uid（私聊目标 / at 段发送转换）。 */
+  /** uin → uid（私聊目标 / at 段发送转换 / 群管动作的 uid 入参）。 */
   uinToUid(uins: string[]): Promise<Map<string, string>>;
   /** uid → uin（事件路径 mention 转换）。 */
   uidToUin(uids: string[]): Promise<Map<string, string>>;
+  /**
+   * uin（数字）→ uid（群管动作入参转换）；转换失败抛 INVALID_PARAM
+   * （Milky 入参 user_id 都是 uin，kernel 群管 API 要 uid）。
+   */
+  resolveUidFromUin(uin: number | string): Promise<string>;
   /**
    * message_scene + 数字 ID → NT Peer。
    * group = 群号直作 peerUid；friend/temp = uin → uid（失败退 uin 原样，交 QQ 端判断）。
@@ -85,57 +167,12 @@ declare class MilkyApi {
   }>;
 }
 //#endregion
-//#region src/milky/action/error-map.d.ts
-/** KernelErrorCode → Milky retcode 映射表（-400/-403 规范语义，其余自定负数）。 */
-type MilkyErrorCodeMap = Record<KernelErrorCode, number>;
-//#endregion
-//#region src/milky/action/base-action.d.ts
-/** Milky 动作结果（retcode 为规范负数族；transport 原样组装信封）。 */
-interface MilkyActionResult<T> {
-  status: "ok" | "failed";
-  retcode: number;
-  data: T | null;
-  message: string;
-}
-declare abstract class MilkyAction<TPayload, TReturn> {
-  abstract readonly name: string;
-  abstract readonly schema: ZodType<TPayload>;
-  protected abstract readonly errorCodeMap: MilkyErrorCodeMap;
-  protected abstract _handle(payload: TPayload): Promise<TReturn>;
-  /** 校验并执行（HTTP /api 入口；WS /event 不承载动作）。 */
-  handle(payload: unknown): Promise<MilkyActionResult<TReturn>>;
-}
-//#endregion
 //#region src/milky/action/index.d.ts
-/** Milky 动作注册表（P0 9 动作）。 */
+/** Milky 动作注册表（P0+P1 49 动作）。 */
 declare function createMilkyActionRegistry(opts: {
   api: MilkyApi;
 }): ActionRegistry<MilkyAction<unknown, unknown>>;
 //#endregion
-//#region src/milky/config.d.ts
-/** Milky 配置 schema。 */
-declare const milkyConfigSchema: z.ZodObject<{
-  enabled: z.ZodDefault<z.ZodBoolean>;
-  host: z.ZodDefault<z.ZodString>;
-  port: z.ZodDefault<z.ZodNumber>;
-  token: z.ZodDefault<z.ZodString>;
-  eventModes: z.ZodDefault<z.ZodArray<z.ZodEnum<{
-    sse: "sse";
-    ws: "ws";
-  }>>>;
-  webhooks: z.ZodDefault<z.ZodArray<z.ZodString>>;
-  cacheDir: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-/** Milky 配置类型（由 schema 推导）。 */
-type MilkyConfig = z.infer<typeof milkyConfigSchema>;
-//#endregion
-//#region src/milky/transport.d.ts
-/** 校准 logger 最小面（webhook 失败 / 配置异常提示；缺省静默）。 */
-interface MilkyLoggerLike {
-  warn(obj: unknown, msg?: string): void;
-  info(obj: unknown, msg?: string): void;
-}
-//#endregion
 //#region src/milky/adapter.d.ts
 /** 适配器构造参数（api 相关字段继承 MilkyApiOptions）。 */
 interface MilkyAdapterOptions extends MilkyApiOptions {
@@ -143,12 +180,18 @@ interface MilkyAdapterOptions extends MilkyApiOptions {
   broadcaster: EventBroadcaster;
   /** kernel 消息事件通道（收链路入口）。 */
   msgChannel: MsgEventChannel;
-  /** 校准日志（webhook 失败 / 启停提示；IPC 模式传 loader pino 实例）。 */
+  /** kernel 群事件通道（P1：群请求/邀请推送；缺省不订阅）。 */
+  groupChannel?: GroupEventChannel;
+  /** kernel 好友事件通道（P1：好友申请推送；缺省不订阅）。 */
+  buddyChannel?: BuddyEventChannel;
+  /** 校准日志（webhook 失败 / 启停提示 / 未知事件形状；IPC 模式传 loader pino 实例）。 */
   logger?: MilkyLoggerLike;
 }
 declare class NapukettoMilkyAdapter extends BaseProtocolAdapter<MilkyConfig> {
   readonly protocol = "milky";
   private readonly msgChannel;
+  private readonly groupChannel;
+  private readonly buddyChannel;
   private readonly calibLogger;
   private readonly api;
   private readonly seqIndex;
@@ -163,13 +206,23 @@ declare class NapukettoMilkyAdapter extends BaseProtocolAdapter<MilkyConfig> {
   private reloadTransports;
   /** 停止：退订 + 关传输。 */
   private stopAll;
-  /** 订阅 kernel 消息通道（幂等）。 */
+  /** 订阅 kernel 事件（消息 + 群通知 + 好友请求，幂等）。 */
   private subscribe;
   /** 退订（幂等）。 */
   private unsubscribeAll;
-  /** 单条消息：seq 登记 → grayTip→recall / 普通→message_receive（自消息不上报）。 */
+  /** 单条消息：seq 登记 → grayTip→notice / 群文件上传 / message_receive（自消息不上报）。 */
   private handleIncoming;
-  /** message_receive 组装：at uid→uin + reply 回填 + 群实体回填（全部 fail-soft）。 */
+  /** grayTip → notice 事件广播（REVOKE 走 message_recall，其余走 notice 翻译）。 */
+  private broadcastNotice;
+  /** notice 翻译上下文（uidToUin 缺省空 Map；logger 透传校准日志）。 */
+  private noticeCtx;
+  /** 群通知通道：入群请求 / 成员邀请 / 邀请自身（uid→uin 批量后翻译）。 */
+  private handleGroupNotifies;
+  /** 好友请求通道：Buddy/onBuddyReqChange（防御收窄，未知形状 raw 日志）。 */
+  private handleBuddyReqs;
+  /** request 翻译上下文（uid→uin 批量转换）。 */
+  private requestCtx;
+  /** message_receive 组装：at uid→uin + reply 回填 + 群实体回填 + 转发段（全部 fail-soft）。 */
   private buildMessageReceiveEvent;
   /** at uid → uin 批量转换（mention.user_id 用；失败 mention 段跳过）。 */
   private fillMentionUids;
@@ -177,10 +230,10 @@ declare class NapukettoMilkyAdapter extends BaseProtocolAdapter<MilkyConfig> {
   private fillReplyMeta;
   /** 群场景实体回填（GroupCache 缓存优先，失败最小实体兜底）。 */
   private fillGroupEntities;
-  /** message_recall 组装（非撤回 grayTip 返回 null 静默）。 */
-  private buildRecallEvent;
-  /** 撤回操作者 uid → uin（未撤回/转换失败返回 undefined，operator_id 兜底 0）。 */
-  private resolveOperatorUin;
+  /** 转发 resId → 定位登记（get_forwarded_messages 反查用）。 */
+  private recordForward;
+  /** uid 批量 → uin（空集/失败返回 undefined 语义：调用方用空 Map）。 */
+  private resolveUidToUin;
 }
 //#endregion
 export { type MilkyAdapterOptions, type MilkyConfig, NapukettoMilkyAdapter, milkyConfigSchema };

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/api.ts","../../src/milky/action/error-map.ts","../../src/milky/action/base-action.ts","../../src/milky/action/index.ts","../../src/milky/config.ts","../../src/milky/transport.ts","../../src/milky/adapter.ts"],"mappings":";;;;;cAsBa;;mBAEQ;;mBAEA;;EAGjB,OAAO,KAAK;;EAeZ,aAAa,UAAU,UAAU,iBAAiB;;;;;EAQlD,iBACI,mBACD;IAAc;IAAoB;IAAkB;;;UAgB/C;;UAKA;;;;;UCxDK;EACb,QAAQ;EACR,UAAU;EACV,WAAW;EACX,YAAY;;EAEZ;IAAQ;IAAa;;;EAErB,aAAa;;EAEb;;EAEA;;EAEA;;cAGS;WACA,QAAQ;WACR,UAAU;WACV,WAAW;WACX,YAAY;WACZ;IAAQ;IAAa;;WACrB,YAAY;WACZ;WACA;WACA;;WAEA,UAAU;EAEnB,YAAY,MAAM,iBAAiB,UAAU;;EAc7C,SAAS,iBAAiB,QAAQ;;EAKlC,SAAS,iBAAiB,QAAQ;;;;;EAQ5B,YAAY,oCAAoC,aAAa,QAAQ;;;;;EAqBrE,kBACF,MAAM,MACN,aACA,UAAU,mBACX;;EAeG,kBACF,MAAM,MACN,gBACD;IAAU;IAAqB;;;;;;KC9G1B,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;;;;;iBCf9C,0BAA0B;EACtC,KAAK;IACL,eAAe;;;;cCfN,mBAAiB,EAAA;;;;;;;;;;;GAe5B,EAAA,KAAA;;KAGU,cAAc,EAAE,aAAa;;;;UCQxB;EACb,KAAK,cAAc;EACnB,KAAK,cAAc;;;;;UCRN,4BAA4B;EACzC,QAAQ,eAAe;EACvB,aAAa;;EAEb,YAAY;;EAEZ,SAAS;;cAGA,8BAA8B,oBAAoB;WAClD;mBAEQ;mBACA;mBACA;mBACA;;WAER,UAAU,kBAAkB;UAC7B;UACA;EAER,YAAY,MAAM;;UAkBJ;;UAuBA;;UAMA;;UASN;;UAYA;;UAQM;;UAmBA;;UAUA;;UAkBN;;UAWM;;UAaA;;UASN"}
+{"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;;;;;UCVN;EACb,QAAQ;EACR,UAAU;EACV,WAAW;EACX,YAAY;;EAEZ,gBAAgB;EAChB,WAAW;EACX,QAAQ;EACR,gBAAgB;EAChB,cAAc;;EAEd;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;IAAQ;IAAa;IAAkB;;WACvC,YAAY;WACZ;WACA;WACA;;WAEA,QAAQ;;WAER,UAAU;EAEnB,YAAY,MAAM,iBAAiB,UAAU;;EAoB7C,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;;;;;;iBC/FtB,0BAA0B;EACtC,KAAK;IACL,eAAe;;;;UCzBF,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;;UAuBA;;UAMA;;UASN;;UA4BA;;UAQM;;UAuBA;;UAeN;;UASM;;UAWN;;UAkBM;;UASA;;UAgBA;;UAkBN;;UAWM;;UAaN;;UAcA"}