@zhin.js/adapter-icqq 6.0.2 → 6.0.3

package/agent/tools/send_user_like.ts

@@ -1,7 +1,7 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineTool<{ endpoint_id: string; user_id: number; times?: number }>({
+export default defineAgentTool<{ endpoint_id: string; user_id: number; times?: number }>({
   description: '给用户点赞（竖大拇指），每人每天最多 20 次',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint QQ号'),

package/agent/tools/set_anonymous.ts

@@ -1,7 +1,7 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineTool<{ endpoint_id: string; group_id: number; enable?: boolean }>({
+export default defineAgentTool<{ endpoint_id: string; group_id: number; enable?: boolean }>({
   description: '开启或关闭 QQ 群的匿名聊天功能',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint QQ号'),

package/agent/tools/set_title.ts

@@ -1,7 +1,7 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getIcqqAgentDeps } from '../../src/icqq-agent-deps.js';
-export default defineTool<{ endpoint_id: string; group_id: number; user_id: number; title: string; duration?: number }>({
+export default defineAgentTool<{ endpoint_id: string; group_id: number; user_id: number; title: string; duration?: number }>({
   description: '设置 QQ 群成员的专属头衔',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint QQ号'),

package/lib/agent-prompt.d.ts

@@ -0,0 +1,2 @@
+import type { AgentPromptContributor } from 'zhin.js';
+export declare function createIcqqAgentPromptContributor(): AgentPromptContributor;

package/lib/{src/agent-prompt.js → agent-prompt.js}

@@ -100,4 +100,3 @@ export function createIcqqAgentPromptContributor() {
         },
     };
 }
-//# sourceMappingURL=agent-prompt.js.map

package/lib/cq-message.d.ts

@@ -0,0 +1,9 @@
+/**
+ * CQ 码与 MessageSegment 互转。
+ * 出站：@icqqjs/cli 要求 message 为非空字符串；引用段编码为 [reply:id]（需 cli parse-message 支持 reply，见 scripts/patch-icqq-cli-reply.mjs）。
+ */
+import { MessageSegment, SendContent } from "zhin.js";
+export declare function parseCqMessage(raw: string): MessageSegment[];
+/** 构建 icqq IPC send_*_msg 的 message 字符串（非空） */
+export declare function buildIcqqIpcMessage(content: SendContent): string;
+export declare function toCqString(content: SendContent): string;

package/lib/{src/cq-message.js → cq-message.js}

@@ -145,4 +145,3 @@ export function toCqString(content) {
     })
         .join("");
 }
-//# sourceMappingURL=cq-message.js.map

package/lib/endpoint.d.ts

@@ -0,0 +1,51 @@
+/**
+ * IcqqIpcEndpoint — lifecycle, outbound, IPC subscribe/admit for ICQQ daemon.
+ */
+import type { EndpointInstance } from '@zhin.js/adapter';
+import type { MessageGateway } from '@zhin.js/core/runtime';
+import type { CapabilityId } from '@zhin.js/plugin-runtime';
+import { type IcqqInboundMessage, type IpcEvent, type IpcResponse, type ResolvedIcqqConfig } from './protocol.js';
+import type { IpcFriendInfo, IpcGroupInfo } from './types.js';
+/** Minimal IPC surface used by the endpoint (real IpcClient or test mock). */
+export interface IcqqIpcTransport {
+    request(action: string, params?: Record<string, unknown>): Promise<IpcResponse>;
+    subscribe(action: string, params: Record<string, unknown>, handler: (event: IpcEvent) => void): {
+        unsubscribe: () => Promise<void>;
+    };
+    setOnRemoteDisconnect(handler: (() => void) | null): void;
+    close(): void;
+}
+export type CreateIcqqIpc = (config: ResolvedIcqqConfig) => Promise<IcqqIpcTransport>;
+export interface IcqqEndpointOptions {
+    readonly id: CapabilityId;
+    readonly gateway: MessageGateway;
+    readonly config: ResolvedIcqqConfig;
+    readonly createIpc?: CreateIcqqIpc;
+}
+export declare class IcqqIpcEndpoint implements EndpointInstance {
+    #private;
+    readonly name: string;
+    /** Populated after start(); agent tools read this. */
+    ipc: IcqqIpcTransport;
+    readonly friends: Map<number, IpcFriendInfo>;
+    readonly groups: Map<number, IpcGroupInfo>;
+    constructor(options: IcqqEndpointOptions);
+    request(action: string, params?: Record<string, unknown>): Promise<IpcResponse>;
+    start(): Promise<void>;
+    open(): void;
+    close(): void;
+    stop(): Promise<void>;
+    send({ target, payload }: {
+        readonly target: string;
+        readonly payload: unknown;
+    }): Promise<string>;
+    private static readonly EMOJI_MAP;
+    private getEmojiId;
+    /** Activity-feedback / OutboundHost reaction surface. */
+    addReaction(messageId: string, emoji: string): Promise<string | null>;
+    removeReaction(messageId: string, reactionId: string): Promise<void>;
+    /** Activity-feedback autoRemove / Console recall. */
+    recallMessage(messageId: string): Promise<void>;
+    /** Test / internal: admit when open. */
+    admit(msg: IcqqInboundMessage): void;
+}

package/lib/endpoint.js

@@ -0,0 +1,483 @@
+import { formatCompact, getLogger } from '@zhin.js/logger';
+import { registerIcqqAgentEndpoint } from './icqq-agent-deps.js';
+import { InboundMessageDeduper, findIcqqNestedMessageSource, isIcqqBotMentioned, isIcqqMessagePostType, normalizeIcqqInboundMessage, quotedPayloadFromIcqqSource, resolveIcqqQuoteIdFromEvent, shouldSkipSelfInboundMessage, unwrapIcqqIpcEventPayload, } from './icqq-inbound.js';
+import { isIcqqGuildIpcEvent, normalizeIcqqGuildInboundMessage, } from './icqq-guild.js';
+import { IpcClient } from './ipc-client.js';
+import { materializeOutboundBase64, resolveIcqqOutboundMediaMode, } from './outbound-media.js';
+import { Actions, formatInboundContent, formatInboundTarget, formatOutboundBody, parseSendTarget, } from './protocol.js';
+const logger = getLogger('icqq');
+export class IcqqIpcEndpoint {
+    #options;
+    #createIpc;
+    name;
+    /** Populated after start(); agent tools read this. */
+    ipc;
+    friends = new Map();
+    groups = new Map();
+    #open = false;
+    #started = false;
+    #subscriptions = [];
+    #inboundDeduper = new InboundMessageDeduper();
+    #unregisterAgent;
+    /** 用户主动 stop 时为 true，阻止自动重连 */
+    #intentionalDisconnect = false;
+    /** 是否已有重连循环在跑（避免多次 schedule 叠套） */
+    #reconnectRunning = false;
+    constructor(options) {
+        this.#options = options;
+        this.name = options.config.name;
+        this.#createIpc = options.createIpc ?? defaultCreateIpc;
+    }
+    async request(action, params) {
+        if (!this.ipc) {
+            throw new Error(`icqq endpoint ${this.name} 未连接（IPC 未初始化或已停止），无法发起请求: ${action}`);
+        }
+        return this.ipc.request(action, params);
+    }
+    async start() {
+        if (this.#started)
+            return;
+        this.#started = true;
+        this.#intentionalDisconnect = false;
+        try {
+            await this.#bindIpcSession();
+            this.#unregisterAgent = registerIcqqAgentEndpoint(this.name, this);
+            logger.info(formatCompact({
+                op: 'connect',
+                endpoint: this.name,
+                mode: this.#options.config.rpc ? 'rpc' : 'ipc',
+                friends: this.friends.size,
+                groups: this.groups.size,
+            }));
+        }
+        catch (error) {
+            await this.stop();
+            // Startup connect failures are surfaced once (with stack) by AdapterIndex;
+            // keep this at debug to avoid a duplicate error-level log.
+            logger.debug(`Failed to connect ICQQ IPC: ${error instanceof Error ? error.stack ?? error.message : String(error)}`);
+            throw error;
+        }
+    }
+    /** 建立或恢复与守护进程的 IPC/RPC 会话（订阅、缓存列表） */
+    async #bindIpcSession() {
+        // 旧连接上的订阅句柄已失效，不再对死 socket 发 unsubscribe
+        this.#subscriptions = [];
+        this.ipc = await this.#createIpc(this.#options.config);
+        if (this.#options.config.autoReconnect !== false) {
+            this.ipc.setOnRemoteDisconnect(() => this.#scheduleReconnect());
+        }
+        await this.#refreshLists();
+        const sub = this.ipc.subscribe(Actions.SUBSCRIBE, {}, (event) => {
+            this.#handleEvent(event);
+        });
+        this.#subscriptions.push(sub);
+    }
+    /** IPC/RPC 意外断开时调度重连（指数退避） */
+    #scheduleReconnect() {
+        if (this.#options.config.autoReconnect === false)
+            return;
+        if (this.#intentionalDisconnect)
+            return;
+        if (this.#reconnectRunning)
+            return;
+        this.#reconnectRunning = true;
+        void this.#runReconnectLoop();
+    }
+    async #runReconnectLoop() {
+        try {
+            for (let attempt = 0; !this.#intentionalDisconnect; attempt++) {
+                const base = Math.min(30_000, 500 * 2 ** Math.min(attempt, 6));
+                const jitter = Math.floor(Math.random() * 400);
+                const delayMs = base + jitter;
+                // 首次断开 WARN，后续重试静默为 DEBUG，避免刷屏
+                const disconnectLog = attempt === 0 ? logger.warn.bind(logger) : logger.debug.bind(logger);
+                disconnectLog(formatCompact({
+                    op: 'disconnect',
+                    endpoint: this.name,
+                    ok: false,
+                    delay_ms: delayMs,
+                    attempt: attempt + 1,
+                }));
+                await new Promise((r) => setTimeout(r, delayMs));
+                if (this.#intentionalDisconnect)
+                    break;
+                try {
+                    await this.#bindIpcSession();
+                    logger.info(formatCompact({
+                        op: 'reconnect',
+                        endpoint: this.name,
+                        ok: true,
+                        attempts: attempt + 1,
+                        friends: this.friends.size,
+                        groups: this.groups.size,
+                    }));
+                    break;
+                }
+                catch (error) {
+                    const retryLog = attempt === 0 ? logger.warn.bind(logger) : logger.debug.bind(logger);
+                    retryLog(formatCompact({
+                        op: 'reconnect',
+                        endpoint: this.name,
+                        ok: false,
+                        attempt: attempt + 1,
+                        error: error instanceof Error ? error.message : String(error),
+                    }));
+                }
+            }
+        }
+        finally {
+            this.#reconnectRunning = false;
+        }
+    }
+    open() {
+        this.#open = true;
+    }
+    close() {
+        this.#open = false;
+    }
+    async stop() {
+        this.#intentionalDisconnect = true;
+        this.#open = false;
+        this.ipc?.setOnRemoteDisconnect(null);
+        for (const sub of this.#subscriptions.splice(0)) {
+            await sub.unsubscribe().catch(() => { });
+        }
+        this.#unregisterAgent?.();
+        this.#unregisterAgent = undefined;
+        this.#inboundDeduper.clear();
+        this.friends.clear();
+        this.groups.clear();
+        try {
+            this.ipc?.close();
+        }
+        catch {
+            /* ignore */
+        }
+        // 置空 ipc：start 前 / stop 后的 request() 走防御性报错而非 TypeError
+        this.ipc = undefined;
+        this.#started = false;
+        logger.debug(formatCompact({ op: 'disconnect', endpoint: this.name }));
+    }
+    async send({ target, payload }) {
+        if (!this.ipc) {
+            throw new Error(`icqq endpoint ${this.name} 未连接（IPC 未初始化或已停止），无法发送消息`);
+        }
+        const mediaMode = resolveIcqqOutboundMediaMode(this.#options.config);
+        const content = Array.isArray(payload)
+            ? materializeOutboundBase64(payload, mediaMode)
+            : payload;
+        const message = formatOutboundBody(content);
+        const parsed = parseSendTarget(target);
+        let action;
+        let params;
+        switch (parsed.kind) {
+            case 'private':
+                action = Actions.SEND_PRIVATE_MSG;
+                params = { user_id: parsed.userId, message };
+                break;
+            case 'group':
+                action = Actions.SEND_GROUP_MSG;
+                params = { group_id: parsed.groupId, message };
+                break;
+            case 'temp':
+                action = Actions.SEND_TEMP_MSG;
+                params = {
+                    group_id: parsed.groupId,
+                    user_id: parsed.userId,
+                    message,
+                };
+                break;
+            case 'channel':
+                action = Actions.GUILD_SEND_MSG;
+                params = {
+                    guild_id: parsed.guildId,
+                    channel_id: parsed.channelId,
+                    message,
+                };
+                break;
+        }
+        const resp = await this.ipc.request(action, params);
+        if (!resp.ok) {
+            throw new Error(`发送消息失败: ${resp.error}`);
+        }
+        const messageId = String(resp.data?.message_id ?? `sent_${Date.now()}`);
+        logger.debug(formatCompact({
+            op: 'icqq_send',
+            endpoint: this.name,
+            target,
+            messageId,
+        }));
+        return messageId;
+    }
+    // ── 消息回应（activity-feedback / typing reaction）────────────────────
+    static EMOJI_MAP = {
+        '⏳': '1468368274',
+        '👍': '128077',
+        '❤️': '10084',
+        '😊': '128522',
+        '🎉': '127881',
+        '🔥': '128293',
+        '✅': '9989',
+        '❌': '10060',
+        '⭐': '11088',
+        '💯': '128175',
+    };
+    getEmojiId(emoji) {
+        if (/^\d+$/u.test(emoji))
+            return emoji;
+        return IcqqIpcEndpoint.EMOJI_MAP[emoji] ?? String(emoji.codePointAt(0) || 0);
+    }
+    /** Activity-feedback / OutboundHost reaction surface. */
+    async addReaction(messageId, emoji) {
+        try {
+            const emojiId = this.getEmojiId(emoji);
+            const resp = await this.request(Actions.GROUP_SET_REACTION, {
+                message_id: messageId,
+                id: emojiId,
+            });
+            if (!resp.ok) {
+                logger.warn(formatCompact({
+                    op: 'add_reaction',
+                    endpoint: this.name,
+                    message_id: messageId,
+                    emoji,
+                    id: emojiId,
+                    ok: false,
+                    error: resp.error,
+                }));
+                return null;
+            }
+            logger.debug(formatCompact({
+                op: 'add_reaction',
+                endpoint: this.name,
+                message_id: messageId,
+                emoji,
+                id: emojiId,
+                ok: true,
+            }));
+            return emojiId;
+        }
+        catch (error) {
+            logger.warn(formatCompact({
+                op: 'add_reaction',
+                endpoint: this.name,
+                message_id: messageId,
+                emoji,
+                ok: false,
+                error: error instanceof Error ? error.message : String(error),
+            }));
+            return null;
+        }
+    }
+    async removeReaction(messageId, reactionId) {
+        try {
+            const parts = reactionId.split('_');
+            const emojiId = parts.length >= 2 ? parts[1] : reactionId;
+            const resp = await this.request(Actions.GROUP_DEL_REACTION, {
+                message_id: messageId,
+                id: emojiId,
+            });
+            if (!resp.ok) {
+                logger.warn(formatCompact({
+                    op: 'remove_reaction',
+                    endpoint: this.name,
+                    message_id: messageId,
+                    reaction_id: reactionId,
+                    id: emojiId,
+                    ok: false,
+                    error: resp.error,
+                }));
+                return;
+            }
+            logger.debug(formatCompact({
+                op: 'remove_reaction',
+                endpoint: this.name,
+                message_id: messageId,
+                reaction_id: reactionId,
+                id: emojiId,
+                ok: true,
+            }));
+        }
+        catch (error) {
+            logger.warn(formatCompact({
+                op: 'remove_reaction',
+                endpoint: this.name,
+                message_id: messageId,
+                reaction_id: reactionId,
+                ok: false,
+                error: error instanceof Error ? error.message : String(error),
+            }));
+        }
+    }
+    /** Activity-feedback autoRemove / Console recall. */
+    async recallMessage(messageId) {
+        if (!messageId || messageId.startsWith('outbound:'))
+            return;
+        try {
+            const resp = await this.request(Actions.RECALL_MSG, { message_id: messageId });
+            if (!resp.ok) {
+                logger.warn(formatCompact({
+                    op: 'recall_message',
+                    endpoint: this.name,
+                    message_id: messageId,
+                    ok: false,
+                    error: resp.error,
+                }));
+                return;
+            }
+            logger.debug(formatCompact({
+                op: 'recall_message',
+                endpoint: this.name,
+                message_id: messageId,
+                ok: true,
+            }));
+        }
+        catch (error) {
+            logger.warn(formatCompact({
+                op: 'recall_message',
+                endpoint: this.name,
+                message_id: messageId,
+                ok: false,
+                error: error instanceof Error ? error.message : String(error),
+            }));
+        }
+    }
+    /** Test / internal: admit when open. */
+    admit(msg) {
+        if (!this.#open)
+            return;
+        // 新 Runtime Message.content 为纯文本：@ 本机（uin = name）只能经 metadata 传递
+        const mentioned = isIcqqBotMentioned({ uin: this.name, rawMessage: msg.content });
+        void this.#options.gateway.receive({
+            adapter: this.#options.id,
+            target: msg.target,
+            content: msg.content,
+            sender: msg.sender,
+            id: msg.id,
+            metadata: Object.freeze({
+                endpoint: this.name,
+                channelType: msg.channelType,
+                ...msg.metadata,
+                ...(mentioned ? { mentioned: true } : {}),
+            }),
+        }).catch((err) => {
+            logger.warn(formatCompact({
+                op: 'icqq_gateway_receive_failed',
+                target: msg.target,
+                error: err instanceof Error ? err.message : String(err),
+            }));
+        });
+    }
+    async #refreshLists() {
+        const [flResp, glResp] = await Promise.all([
+            this.ipc.request(Actions.LIST_FRIENDS),
+            this.ipc.request(Actions.LIST_GROUPS),
+        ]);
+        this.friends.clear();
+        if (flResp.ok && Array.isArray(flResp.data)) {
+            for (const f of flResp.data) {
+                this.friends.set(f.user_id, f);
+            }
+        }
+        this.groups.clear();
+        if (glResp.ok && Array.isArray(glResp.data)) {
+            for (const g of glResp.data) {
+                this.groups.set(g.group_id, g);
+            }
+        }
+    }
+    #handleEvent(event) {
+        if (isIcqqGuildIpcEvent(event.event)) {
+            this.#handleGuildEvent(event);
+            return;
+        }
+        const payload = unwrapIcqqIpcEventPayload(event);
+        if (!payload || typeof payload !== 'object')
+            return;
+        if (!isIcqqMessagePostType(payload))
+            return;
+        const data = payload;
+        if (shouldSkipSelfInboundMessage(data))
+            return;
+        const normalized = normalizeIcqqInboundMessage(data);
+        if (!normalized)
+            return;
+        if (!this.#inboundDeduper.shouldProcess(normalized.messageId))
+            return;
+        this.admit({
+            id: normalized.messageId,
+            target: formatInboundTarget({
+                channelType: normalized.channelType,
+                channelId: normalized.channelId,
+                channelParentGroupId: normalized.channelParentGroupId,
+            }),
+            content: formatInboundContent(normalized.rawMessage),
+            sender: normalized.userId,
+            channelType: normalized.channelType,
+            metadata: buildIcqqQuoteMetadata(data, {
+                nickname: normalized.nickname,
+                senderRole: normalized.senderRole,
+            }),
+        });
+    }
+    #handleGuildEvent(event) {
+        const payload = event.data;
+        if (!payload || typeof payload !== 'object')
+            return;
+        const normalized = normalizeIcqqGuildInboundMessage(payload);
+        if (!normalized)
+            return;
+        if (!this.#inboundDeduper.shouldProcess(`guild:${normalized.messageId}`))
+            return;
+        this.admit({
+            id: normalized.messageId,
+            target: formatInboundTarget({
+                channelType: 'channel',
+                channelId: normalized.channelId,
+                guildId: normalized.guildId,
+            }),
+            content: formatInboundContent(normalized.rawMessage),
+            sender: normalized.userId,
+            channelType: 'channel',
+            metadata: {
+                guildId: normalized.guildId,
+                nickname: normalized.nickname,
+            },
+        });
+    }
+}
+/**
+ * 组装入站 metadata：在基础字段上补充 quote 链路信息。
+ * - quote_id：被引用消息 id（resolveIcqqQuoteIdFromEvent，无则不写）
+ * - quote_sender_id / quote_sender_name / quote_content：source 可用时的平铺摘要
+ */
+function buildIcqqQuoteMetadata(data, base) {
+    const metadata = { ...base };
+    const quoteId = resolveIcqqQuoteIdFromEvent(data);
+    if (quoteId)
+        metadata.quote_id = quoteId;
+    const quoted = quotedPayloadFromIcqqSource(findIcqqNestedMessageSource(data));
+    if (quoted?.sender?.id)
+        metadata.quote_sender_id = quoted.sender.id;
+    if (quoted?.sender?.name)
+        metadata.quote_sender_name = quoted.sender.name;
+    const quoteText = quoted
+        ? (typeof quoted.content === 'string'
+            ? quoted.content
+            : quoted.content
+                .map((seg) => seg && typeof seg === 'object' && seg.type === 'text'
+                ? String(seg.data?.text ?? '')
+                : '')
+                .join('')).trim() || quoted.raw || ''
+        : '';
+    if (quoteText)
+        metadata.quote_content = quoteText;
+    return metadata;
+}
+async function defaultCreateIpc(config) {
+    const uin = Number(config.name);
+    if (config.rpc) {
+        return IpcClient.connectRpc(config.rpc);
+    }
+    return IpcClient.connect(uin);
+}

package/lib/forward-msg.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 合并转发（聊天记录）解析：从 json/xml 提取 resid，经 IPC get_forward_msg 拉取正文。
+ */
+import { type MessageSegment, type QuotedMessagePayload } from 'zhin.js';
+import type { IpcClient } from "./ipc-client.js";
+import { type IcqqMessageElement } from "./icqq-inbound.js";
+/** 从 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 / IPC 原始对象里深度搜索 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(ipc: IpcClient, id: string): Promise<string>;
+/** 若 payload 含合并转发，拉取并追加到 content */
+export declare function enrichQuotedPayloadWithForward(ipc: IpcClient | null | undefined, payload: QuotedMessagePayload, ipcRaw?: unknown): Promise<QuotedMessagePayload>;

package/lib/{src/forward-msg.js → forward-msg.js}

@@ -387,4 +387,3 @@ export async function enrichQuotedPayloadWithForward(ipc, payload, ipcRaw) {
     }
     return payload;
 }
-//# sourceMappingURL=forward-msg.js.map

package/lib/icqq-agent-deps.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Agent tool deps for icqq.
+ * Endpoints register themselves on start; tools look up by config name / QQ uin.
+ */
+import type { IpcFriendInfo, IpcGroupInfo } from './types.js';
+import type { IpcResponse } from './protocol.js';
+export interface IcqqAgentEndpoint {
+    readonly name: string;
+    readonly ipc: {
+        request(action: string, params?: Record<string, unknown>): Promise<IpcResponse>;
+    };
+    readonly friends: Map<number, IpcFriendInfo>;
+    readonly groups: Map<number, IpcGroupInfo>;
+    request(action: string, params?: Record<string, unknown>): Promise<IpcResponse>;
+}
+export interface IcqqAgentDeps {
+    getEndpoint: (endpointId: string) => IcqqAgentEndpoint;
+    getAdapter?: () => {
+        getEndpoint: (id: string) => IcqqAgentEndpoint;
+    };
+}
+export declare function registerIcqqAgentEndpoint(endpointId: string, endpoint: IcqqAgentEndpoint): () => void;
+/** Optional override used by tests / transitional callers. Pass `null` to clear. */
+export declare function setIcqqAgentDeps(deps: IcqqAgentDeps | null): void;
+export declare function getIcqqAgentDeps(): IcqqAgentDeps;