@zhin.js/adapter-icqq 8.0.12 → 8.0.14

package/lib/forward-msg.d.ts

@@ -1,25 +1,6 @@
-import { type MessageSegment, type QuotedMessagePayload } from 'zhin.js';
 import { type IcqqMessageElement } from "./icqq-inbound.js";
+import type { ForwardEntry } from '@zhin.js/im-contract';
 /** 从 QQ 合并转发 json 元素提取 resid */
 export declare function extractForwardResidFromJsonElement(el: IcqqMessageElement): string | undefined;
-/** 从 get_msg 的 raw_message 解析 multimsg resid（XML / JSON / CQ:json） */
-export declare function extractForwardResidFromRawMessage(raw: string): string | undefined;
-/** 从 get_msg 的 message 元素数组解析 multimsg resid */
-export declare function extractForwardResidFromGetMsgElements(elements: IcqqMessageElement[] | undefined): string | undefined;
-/**
- * 从 get_msg 响应解析合并转发 resid（优先 message 数组，其次 raw_message）。
- */
-export declare function extractForwardResidFromGetMsg(data: unknown): string | undefined;
-export declare function extractForwardResidFromSegments(content: MessageSegment[]): string | undefined;
-export declare function extractForwardResidFromPayload(payload: QuotedMessagePayload): string | undefined;
-/** 在 get_msg 原始对象里深度搜索 resid */
-export declare function extractForwardResidDeep(root: unknown, maxDepth?: number): string | undefined;
-export declare function isForwardPlaceholderPayload(payload: QuotedMessagePayload): boolean;
-/** 将 get_forward_msg 响应格式化为可读聊天记录 */
-export declare function formatForwardMsgResponse(data: unknown): string;
-export declare function fetchForwardMsgText(client: {
-    getForwardMsg(resId: string, fileName?: string): Promise<unknown[]>;
-}, id: string): Promise<string>;
-export declare function enrichQuotedPayloadWithForward(client: {
-    getForwardMsg(resId: string, fileName?: string): Promise<unknown[]>;
-} | null | undefined, payload: QuotedMessagePayload, rawData?: unknown): Promise<QuotedMessagePayload>;
+/** Canonical merged-forward entries. Speakers are data actors, never LLM roles. */
+export declare function normalizeForwardMsgResponse(data: unknown): readonly ForwardEntry[];

package/lib/forward-msg.js

@@ -1,8 +1,6 @@
-import { segment } from 'zhin.js';
 import { icqqElementsToSegments, } from "./icqq-inbound.js";
-import { parseCqMessage } from "./cq-message.js";
+import { toCanonicalSegments } from '@zhin.js/core';
 const RESID_IN_XML_RE = /(?:m_resid|resid|fileid|res_id)=["']?([A-Za-z0-9+/=_.-]{8,})/i;
-const FORWARD_PLACEHOLDER_RE = /\[聊天记录\]|合并转发|转发消息|聊天记录/i;
 function parseJsonPayload(raw) {
     if (raw && typeof raw === "object" && !Array.isArray(raw)) {
         return raw;
@@ -64,313 +62,46 @@ export function extractForwardResidFromJsonElement(el) {
         return String(direct).trim();
     return undefined;
 }
-/** 从 get_msg 的 raw_message 解析 multimsg resid（XML / JSON / CQ:json） */
-export function extractForwardResidFromRawMessage(raw) {
-    const text = raw.trim();
-    if (!text)
-        return undefined;
-    const xml = text.match(RESID_IN_XML_RE);
-    if (xml?.[1])
-        return xml[1].trim();
-    const asJson = parseJsonPayload(text);
-    if (asJson) {
-        const fromJson = extractForwardResidFromJsonElement({
-            type: "json",
-            data: asJson,
-        });
-        if (fromJson)
-            return fromJson;
-    }
-    for (const match of text.matchAll(/\[CQ:json(?:,([^\]]*))?\]/gi)) {
-        const arg = match[1] ?? "";
-        const dataMatch = arg.match(/(?:^|,)data=(.+)$/s);
-        if (!dataMatch?.[1])
-            continue;
-        const record = parseJsonPayload(dataMatch[1].trim());
-        if (!record)
-            continue;
-        const fromCq = extractForwardResidFromJsonElement({
-            type: "json",
-            data: record,
-        });
-        if (fromCq)
-            return fromCq;
-    }
-    const segs = parseCqMessage(text);
-    return extractForwardResidFromSegments(segs);
-}
-/** 从 get_msg 的 message 元素数组解析 multimsg resid */
-export function extractForwardResidFromGetMsgElements(elements) {
-    if (!elements?.length)
-        return undefined;
-    for (const el of elements) {
-        if (!el || typeof el !== "object")
-            continue;
-        if (el.type === "forward") {
-            const id = String(el.id ?? el.resid ?? el.res_id ?? el.file ?? "").trim();
-            if (id)
-                return id;
-        }
-        const fromJson = extractForwardResidFromJsonElement(el);
-        if (fromJson)
-            return fromJson;
-    }
-    const segs = icqqElementsToSegments(elements);
-    if (segs?.length) {
-        return extractForwardResidFromSegments(segs);
-    }
-    return extractForwardResidDeep(elements);
-}
-/**
- * 从 get_msg 响应解析合并转发 resid（优先 message 数组，其次 raw_message）。
- */
-export function extractForwardResidFromGetMsg(data) {
-    if (!data || typeof data !== "object")
-        return undefined;
-    const record = data;
-    if (Array.isArray(record.message)) {
-        const fromElements = extractForwardResidFromGetMsgElements(record.message);
-        if (fromElements)
-            return fromElements;
-    }
-    if (typeof record.raw_message === "string" && record.raw_message.trim()) {
-        const fromRaw = extractForwardResidFromRawMessage(record.raw_message);
-        if (fromRaw)
-            return fromRaw;
-    }
-    if (typeof record.message === "string" && record.message.trim()) {
-        return extractForwardResidFromRawMessage(record.message);
-    }
-    return undefined;
-}
-export function extractForwardResidFromSegments(content) {
-    for (const seg of content) {
-        if (seg.type === "forward") {
-            const id = seg.data?.id ?? seg.data?.resid;
-            if (id != null && String(id).trim())
-                return String(id).trim();
-        }
-        if (seg.type === "json" && seg.data) {
-            const resid = extractForwardResidFromJsonElement(seg.data);
-            if (resid)
-                return resid;
-            const raw = seg.data.data ?? seg.data.text;
-            const record = parseJsonPayload(raw);
-            if (record) {
-                const fromEl = extractForwardResidFromJsonElement({
-                    type: "json",
-                    data: record,
-                });
-                if (fromEl)
-                    return fromEl;
-            }
-        }
-    }
-    const raw = segment.raw(content);
-    const m = raw.match(RESID_IN_XML_RE);
-    return m?.[1]?.trim();
-}
-export function extractForwardResidFromPayload(payload) {
-    if (Array.isArray(payload.content)) {
-        const fromSeg = extractForwardResidFromSegments(payload.content);
-        if (fromSeg)
-            return fromSeg;
-    }
-    if (typeof payload.raw === "string") {
-        const m = payload.raw.match(RESID_IN_XML_RE);
-        if (m?.[1])
-            return m[1].trim();
-        const record = parseJsonPayload(payload.raw);
-        if (record) {
-            return extractForwardResidFromJsonElement({ type: "json", data: record });
-        }
-    }
-    return undefined;
-}
-/** 在 get_msg 原始对象里深度搜索 resid */
-export function extractForwardResidDeep(root, maxDepth = 14) {
-    const seen = new Set();
-    function walk(node, depth) {
-        if (depth > maxDepth || node == null)
-            return undefined;
-        if (typeof node === "string") {
-            const m = node.match(RESID_IN_XML_RE);
-            if (m?.[1])
-                return m[1].trim();
-            const record = parseJsonPayload(node);
-            if (record) {
-                const fromJson = extractForwardResidFromJsonElement({
-                    type: "json",
-                    data: record,
-                });
-                if (fromJson)
-                    return fromJson;
-            }
-            return undefined;
-        }
-        if (typeof node !== "object")
-            return undefined;
-        if (seen.has(node))
-            return undefined;
-        seen.add(node);
-        if (Array.isArray(node)) {
-            for (const item of node) {
-                const hit = walk(item, depth + 1);
-                if (hit)
-                    return hit;
-            }
-            return undefined;
-        }
-        const fromEl = extractForwardResidFromJsonElement({
-            type: "json",
-            data: node,
-        });
-        if (fromEl)
-            return fromEl;
-        for (const value of Object.values(node)) {
-            const hit = walk(value, depth + 1);
-            if (hit)
-                return hit;
-        }
-        return undefined;
-    }
-    return walk(root, 0);
-}
-export function isForwardPlaceholderPayload(payload) {
-    if (Array.isArray(payload.content) &&
-        payload.content.some((s) => s.type === "forward")) {
-        return true;
-    }
-    const raw = Array.isArray(payload.content)
-        ? segment.raw(payload.content)
-        : String(payload.content ?? payload.raw ?? "");
-    return FORWARD_PLACEHOLDER_RE.test(raw);
-}
-function hasMergedForwardBlock(payload) {
-    const raw = Array.isArray(payload.content)
-        ? segment.raw(payload.content)
-        : String(payload.content ?? "");
-    return raw.includes("[Merged chat history");
-}
-function senderLabel(sender) {
-    if (!sender || typeof sender !== "object")
-        return "unknown";
-    const s = sender;
-    const name = s.nickname ?? s.name ?? s.card;
-    const id = s.user_id ?? s.uin ?? s.uid ?? s.id;
-    if (name && id)
-        return `${name} (${id})`;
-    if (name)
-        return String(name);
-    if (id != null)
-        return String(id);
-    return "unknown";
-}
-function messageBodyToText(body) {
-    if (body == null)
-        return "";
-    if (typeof body === "string")
-        return body.trim();
-    if (Array.isArray(body)) {
-        const segs = icqqElementsToSegments(body);
-        return segs?.length ? segment.raw(segs).trim() : segment.raw(body).trim();
-    }
-    if (typeof body === "object") {
-        const r = body;
-        if (typeof r.raw_message === "string" && r.raw_message.trim()) {
-            return r.raw_message.trim();
-        }
-        if (Array.isArray(r.message)) {
-            return messageBodyToText(r.message);
-        }
-        if (Array.isArray(r.elements)) {
-            return messageBodyToText(r.elements);
-        }
-        if (typeof r.content === "string")
-            return r.content.trim();
-    }
-    return "";
-}
-/** 将 get_forward_msg 响应格式化为可读聊天记录 */
-export function formatForwardMsgResponse(data) {
-    if (!data)
-        return "";
-    const root = data && typeof data === "object" && !Array.isArray(data)
+/** Canonical merged-forward entries. Speakers are data actors, never LLM roles. */
+export function normalizeForwardMsgResponse(data) {
+    const root = data && typeof data === 'object' && !Array.isArray(data)
         ? data
-        : null;
+        : undefined;
     const list = Array.isArray(data)
         ? data
-        : Array.isArray(root?.messages)
-            ? root.messages
-            : Array.isArray(root?.msgList)
-                ? root.msgList
-                : Array.isArray(root?.msg_list)
-                    ? root.msg_list
-                    : Array.isArray(root?.message)
-                        ? root.message
+        : Array.isArray(root?.messages) ? root.messages
+            : Array.isArray(root?.msgList) ? root.msgList
+                : Array.isArray(root?.msg_list) ? root.msg_list
+                    : Array.isArray(root?.message) ? root.message
                         : [];
-    if (!list.length)
-        return "";
-    const lines = [];
-    let index = 0;
-    for (const item of list) {
-        if (!item || typeof item !== "object")
-            continue;
+    return Object.freeze(list.flatMap((item) => {
+        if (!item || typeof item !== 'object')
+            return [];
         const row = item;
-        index += 1;
-        const who = senderLabel(row.sender ?? row.user);
-        const time = typeof row.time === "number"
-            ? new Date(row.time * (row.time > 1e12 ? 1 : 1000)).toISOString()
-            : "";
-        const text = messageBodyToText(row.message ??
-            row.content ??
-            row.raw_message ??
-            row.elements ??
-            row);
-        const head = time ? `${index}. ${who} @ ${time}` : `${index}. ${who}`;
-        lines.push(text ? `${head}\n${text}` : `${head}\n(非文本或无法解析的内容)`);
-    }
-    return lines.join("\n\n");
-}
-export async function fetchForwardMsgText(client, id) {
-    try {
-        const messages = await client.getForwardMsg(id);
-        const text = formatForwardMsgResponse(messages);
-        if (text.trim())
-            return text.trim();
-    }
-    catch { /* ignore */ }
-    return "";
-}
-function appendForwardBlock(payload, block) {
-    if (Array.isArray(payload.content)) {
-        return {
-            ...payload,
-            content: [...payload.content, { type: "text", data: { text: block } }],
-        };
-    }
-    const prev = typeof payload.content === "string" ? payload.content.trim() : "";
-    return {
-        ...payload,
-        content: prev ? `${prev}\n\n${block}` : block,
-    };
-}
-export async function enrichQuotedPayloadWithForward(client, payload, rawData) {
-    if (!client || hasMergedForwardBlock(payload))
-        return payload;
-    const resid = extractForwardResidFromPayload(payload) ??
-        (rawData ? extractForwardResidFromGetMsg(rawData) : undefined) ??
-        (rawData ? extractForwardResidDeep(rawData) : undefined);
-    const fetchIds = [
-        resid,
-        isForwardPlaceholderPayload(payload) ? payload.messageId : undefined,
-    ].filter((v, i, a) => !!v && a.indexOf(v) === i);
-    for (const fetchId of fetchIds) {
-        const forwardText = await fetchForwardMsgText(client, fetchId);
-        if (!forwardText.trim())
-            continue;
-        const block = `[Merged chat history — id ${fetchId}]\n${forwardText.trim()}`;
-        return appendForwardBlock(payload, block);
-    }
-    return payload;
+        const sender = row.sender && typeof row.sender === 'object'
+            ? row.sender
+            : row.user && typeof row.user === 'object'
+                ? row.user
+                : undefined;
+        const id = sender?.user_id ?? sender?.uin ?? sender?.id;
+        const displayName = sender?.nickname ?? sender?.card ?? sender?.name;
+        const body = row.message ?? row.content ?? row.elements ?? row.raw_message;
+        let segments;
+        if (Array.isArray(body))
+            segments = toCanonicalSegments(icqqElementsToSegments(body) ?? body);
+        else if (typeof body === 'string' && body.trim())
+            segments = [{ type: 'text', data: { text: body.trim() } }];
+        else
+            segments = [];
+        if (segments.length === 0)
+            return [];
+        return [Object.freeze({
+                ...(id != null ? { actor: Object.freeze({
+                        id: String(id),
+                        ...(displayName != null && String(displayName).trim() ? { displayName: String(displayName) } : {}),
+                    }) } : {}),
+                ...(typeof row.time === 'number' ? { timestamp: row.time < 1e12 ? row.time * 1000 : row.time } : {}),
+                segments: Object.freeze(segments),
+            })];
+    }));
 }

package/lib/icqq-inbound.d.ts

@@ -1,7 +1,7 @@
 /**
  * icqq 入站事件归一化（post_type / message_type / message 段）
  */
-import { type MessageSegment, type QuotedMessagePayload } from "zhin.js";
+import { type MessageSegment } from "zhin.js";
 import type { GroupRole } from "./types.js";
 /** 守护进程推送的通用事件壳 */
 export interface IcqqEventBase {
@@ -60,6 +60,16 @@ export interface IcqqMessageSource {
     };
     [key: string]: unknown;
 }
+interface IcqqMessageLookup {
+    readonly messageId: string;
+    readonly sender?: Readonly<{
+        id?: string;
+        name?: string;
+    }>;
+    readonly content: readonly MessageSegment[] | string;
+    readonly raw?: string;
+    readonly time?: number;
+}
 export type IcqqMessageElement = {
     type: string;
     text?: string;
@@ -68,8 +78,23 @@ export type IcqqMessageElement = {
     id?: string | number;
     url?: string;
     file?: string;
+    fid?: string;
+    name?: string;
+    size?: number;
+    seconds?: number;
     [key: string]: unknown;
 };
+export interface IcqqInboundMediaResolver {
+    getPttUrl(element: IcqqMessageElement): Promise<string | null | undefined>;
+    getVideoUrl(element: IcqqMessageElement): Promise<string | null | undefined>;
+}
+/**
+ * Resolve ICQQ's opaque protobuf media references while the endpoint-owned
+ * native client is still available. Resolution failure preserves the opaque
+ * reference, so canonical ingress stays truthful and can report unsupported
+ * media instead of inventing a URL.
+ */
+export declare function resolveIcqqInboundMedia(elements: IcqqMessageElement[] | undefined, resolver: IcqqInboundMediaResolver): Promise<void>;
 /** 归一化后供适配器使用的入站消息 */
 export interface NormalizedIcqqInbound {
     messageId: string;
@@ -125,8 +150,8 @@ export declare function icqqElementsToSegments(elements: IcqqMessageElement[] |
 export declare function findIcqqNestedMessageSource(root: unknown, maxDepth?: number): IcqqMessageSource | undefined;
 /** 从 oicq MessageEvent.source 解析被引用消息的 message_id */
 export declare function resolveQuoteIdFromIcqqSource(source: unknown): string | undefined;
-/** 将 source 转为 QuotedMessagePayload（供 $getMsg 缓存，避免重复拉取） */
-export declare function quotedPayloadFromIcqqSource(source: unknown): QuotedMessagePayload | null;
+/** Convert an ICQQ source into the adapter-local lookup payload. */
+export declare function messageLookupFromIcqqSource(source: unknown): IcqqMessageLookup | null;
 /** 从事件顶层字段解析引用 message_id（与 message 段互补） */
 export declare function resolveIcqqQuoteIdFromEvent(data: IcqqMessageEvent): string | undefined;
 export declare function resolveInboundContent(data: IcqqMessageEvent): MessageSegment[];
@@ -137,3 +162,4 @@ export declare class InboundMessageDeduper {
     shouldProcess(messageId: string): boolean;
     clear(): void;
 }
+export {};

package/lib/icqq-inbound.js

@@ -1,9 +1,37 @@
 /**
  * icqq 入站事件归一化（post_type / message_type / message 段）
  */
-import { Message, toCanonicalSegments } from "zhin.js";
+import { toCanonicalSegments } from "zhin.js";
 import { parseCqMessage, icqqMediaRefFromString } from "./cq-message.js";
 import { extractForwardResidFromJsonElement } from "./forward-msg.js";
+/**
+ * Resolve ICQQ's opaque protobuf media references while the endpoint-owned
+ * native client is still available. Resolution failure preserves the opaque
+ * reference, so canonical ingress stays truthful and can report unsupported
+ * media instead of inventing a URL.
+ */
+export async function resolveIcqqInboundMedia(elements, resolver) {
+    if (!elements?.length)
+        return;
+    await Promise.all(elements.map(async (element) => {
+        if (!element || typeof element !== "object")
+            return;
+        if (typeof element.url === "string" && element.url)
+            return;
+        try {
+            const url = element.type === "record" || element.type === "audio"
+                ? await resolver.getPttUrl(element)
+                : element.type === "video"
+                    ? await resolver.getVideoUrl(element)
+                    : undefined;
+            if (typeof url === "string" && url)
+                element.url = url;
+        }
+        catch {
+            // The original platform reference remains the canonical fallback.
+        }
+    }));
+}
 const DEDUPE_TTL_MS = 120_000;
 const ICQQ_GROUP_ROLES = new Set(["owner", "admin", "member"]);
 /** 从 sender.role 解析群成员角色（供 Message.$sender → resolveSenderRoles） */
@@ -212,9 +240,21 @@ export function icqqElementsToSegments(elements) {
                 break;
             case "image": {
                 const value = String(el.url ?? el.file ?? "");
+                if (!value)
+                    break;
+                out.push({
+                    type: "image",
+                    data: { media: icqqMediaRefFromElement(value, el) },
+                });
+                break;
+            }
+            case "flash": {
+                const value = String(el.url ?? el.file ?? "");
+                if (!value)
+                    break;
                 out.push({
                     type: "image",
-                    data: { media: icqqMediaRefFromString(value) },
+                    data: { media: icqqMediaRefFromElement(value, el), flash: true },
                 });
                 break;
             }
@@ -281,18 +321,42 @@ export function icqqElementsToSegments(elements) {
             }
             case "record":
             case "audio": {
-                const value = String(el.file ?? el.url ?? "");
+                const value = String(el.url ?? el.file ?? "");
+                if (!value)
+                    break;
                 out.push({
-                    type: "record",
-                    data: { media: icqqMediaRefFromString(value) },
+                    type: "audio",
+                    data: {
+                        media: icqqMediaRefFromElement(value, el),
+                        ...(typeof el.seconds === "number" ? { duration: el.seconds } : {}),
+                    },
                 });
                 break;
             }
             case "video": {
-                const value = String(el.file ?? el.url ?? "");
+                const value = String(el.url ?? el.file ?? "");
+                if (!value)
+                    break;
                 out.push({
                     type: "video",
-                    data: { media: icqqMediaRefFromString(value) },
+                    data: {
+                        media: icqqMediaRefFromElement(value, el),
+                        ...(typeof el.seconds === "number" ? { duration: el.seconds } : {}),
+                    },
+                });
+                break;
+            }
+            case "file": {
+                const value = String(el.url ?? el.file ?? el.fid ?? "");
+                if (!value)
+                    break;
+                const name = typeof el.name === "string" && el.name ? el.name : undefined;
+                out.push({
+                    type: "file",
+                    data: {
+                        media: icqqMediaRefFromElement(value, el),
+                        ...(name ? { name } : {}),
+                    },
                 });
                 break;
             }
@@ -305,6 +369,20 @@ export function icqqElementsToSegments(elements) {
     }
     return out.length ? out : null;
 }
+function icqqMediaRefFromElement(value, element) {
+    const media = icqqMediaRefFromString(value);
+    const fileName = typeof element.name === "string" && element.name
+        ? element.name
+        : undefined;
+    const size = typeof element.size === "number" && Number.isFinite(element.size)
+        ? element.size
+        : undefined;
+    return {
+        ...media,
+        ...(fileName ? { file_name: fileName } : {}),
+        ...(size != null ? { size } : {}),
+    };
+}
 function resolveReplyIdFromJsonElement(el) {
     let payload = el.data ?? el;
     if (typeof payload === "string") {
@@ -422,8 +500,8 @@ function icqqSourceToContentSegments(s) {
     }
     return [];
 }
-/** 将 source 转为 QuotedMessagePayload（供 $getMsg 缓存，避免重复拉取） */
-export function quotedPayloadFromIcqqSource(source) {
+/** Convert an ICQQ source into the adapter-local lookup payload. */
+export function messageLookupFromIcqqSource(source) {
     if (!source || typeof source !== "object")
         return null;
     const s = source;
@@ -481,10 +559,10 @@ export function resolveIcqqQuoteIdFromEvent(data) {
     return undefined;
 }
 function mergeReplyFromRawMessage(content, rawMessage) {
-    if (!rawMessage || Message.quoteIdFromContent(content))
+    if (!rawMessage || quoteIdFromSegments(content))
         return content;
     const fromRaw = parseCqMessage(rawMessage);
-    const quoteFromRaw = Message.quoteIdFromContent(fromRaw);
+    const quoteFromRaw = quoteIdFromSegments(fromRaw);
     if (!quoteFromRaw)
         return content;
     return [
@@ -493,7 +571,7 @@ function mergeReplyFromRawMessage(content, rawMessage) {
     ];
 }
 function mergeReplyFromSource(content, data) {
-    if (Message.quoteIdFromContent(content))
+    if (quoteIdFromSegments(content))
         return content;
     const quoteId = resolveQuoteIdFromIcqqSource(data.source) ??
         resolveQuoteIdFromIcqqSource(findIcqqNestedMessageSource(data));
@@ -504,6 +582,11 @@ function mergeReplyFromSource(content, data) {
         ...content.filter((s) => s.type !== "reply"),
     ];
 }
+function quoteIdFromSegments(content) {
+    const reply = content.find((item) => item.type === 'reply');
+    const value = reply?.data?.message_id ?? reply?.data?.id;
+    return value == null || !String(value).trim() ? undefined : String(value).trim();
+}
 export function resolveInboundContent(data) {
     const fromElements = icqqElementsToSegments(data.message);
     const raw = data.raw_message ?? "";

package/lib/icqq-login-assist.d.ts

@@ -0,0 +1,27 @@
+import type { LoginAssist, LoginAssistType } from '@zhin.js/core';
+type IcqqLoginClient = {
+    login(password?: string): Promise<unknown>;
+    submitSlider(ticket: string): Promise<unknown>;
+    sendSmsCode(): Promise<unknown>;
+    submitSmsCode(code: string): Promise<unknown>;
+};
+type Logger = {
+    info(message: string): void;
+    warn(message: string): void;
+};
+/**
+ * Drive ICQQ login challenges through LoginAssist (refresh-safe pending tasks).
+ * Mirrors the classic stdin flow: qrcode/auth → login(); slider → submitSlider;
+ * device → sendSmsCode then submitSmsCode.
+ */
+export declare function runIcqqLoginAssistStep(input: {
+    assist: LoginAssist;
+    client: IcqqLoginClient;
+    adapter: string;
+    endpointKey: string;
+    owner: object;
+    logger: Logger;
+    step: LoginAssistType;
+    event: unknown;
+}): Promise<void>;
+export {};