@openclaw/qqbot 2026.5.2 → 2026.5.3-beta.1

package/src/engine/gateway/gateway.ts

@@ -1,291 +0,0 @@
-/**
- * Core gateway entry point — thin shell that wires together:
- *
- * - GatewayConnection: WebSocket lifecycle, heartbeat, reconnect
- * - buildInboundContext: content building, attachments, quote resolution
- * - dispatchOutbound: AI dispatch, deliver callbacks, timeouts
- *
- * The only responsibilities of this file are:
- * 1. Initialize adapters from EngineAdapters
- * 2. Initialize API config + refIdx cache hook
- * 3. Create the message handler (inbound → outbound pipeline)
- * 4. Start GatewayConnection
- */
-
-import path from "node:path";
-import { initCommands } from "../commands/slash-commands-impl.js";
-import { createNodeSessionStoreReader } from "../group/activation.js";
-import type { HistoryEntry } from "../group/history.js";
-import { setOutboundAudioPort } from "../messaging/outbound.js";
-import {
-  clearTokenCache,
-  getAccessToken,
-  initApiConfig,
-  onMessageSent,
-  sendInputNotify as senderSendInputNotify,
-  createRawInputNotifyFn,
-  accountToCreds,
-} from "../messaging/sender.js";
-import { setRefIndex } from "../ref/store.js";
-import { runDiagnostics } from "../utils/diagnostics.js";
-import { runWithRequestContext } from "../utils/request-context.js";
-import { GatewayConnection } from "./gateway-connection.js";
-import { buildInboundContext, clearGroupPendingHistory } from "./inbound-pipeline.js";
-import { createInteractionHandler } from "./interaction-handler.js";
-import type { QueuedMessage } from "./message-queue.js";
-import { dispatchOutbound } from "./outbound-dispatch.js";
-import type {
-  CoreGatewayContext,
-  GatewayAccount,
-  EngineLogger,
-  RefAttachmentSummary,
-} from "./types.js";
-import { TypingKeepAlive, TYPING_INPUT_SECOND } from "./typing-keepalive.js";
-
-// Re-export context type for consumers.
-export type { CoreGatewayContext } from "./types.js";
-
-// ============ startGateway ============
-
-/**
- * Start the Gateway WebSocket connection with automatic reconnect support.
- */
-export async function startGateway(ctx: CoreGatewayContext): Promise<void> {
-  const { account, log, runtime, adapters } = ctx;
-
-  // ---- 1. Initialize adapters ----
-  setOutboundAudioPort(adapters.outboundAudio);
-  initCommands(adapters.commands);
-
-  // ---- 2. Validate ----
-  if (!account.appId || !account.clientSecret) {
-    throw new Error("QQBot not configured (missing appId or clientSecret)");
-  }
-
-  // ---- 3. Diagnostics ----
-  const diag = await runDiagnostics();
-  if (diag.warnings.length > 0) {
-    for (const w of diag.warnings) {
-      log?.info(w);
-    }
-  }
-
-  // ---- 4. API config ----
-  initApiConfig(account.appId, { markdownSupport: account.markdownSupport });
-  log?.debug?.(`API config: markdownSupport=${account.markdownSupport}`);
-
-  // ---- 5. Outbound refIdx cache hook ----
-  onMessageSent(account.appId, (refIdx, meta) => {
-    log?.info(
-      `onMessageSent called: refIdx=${refIdx}, mediaType=${meta.mediaType}, ttsText=${meta.ttsText?.slice(0, 30)}`,
-    );
-    const attachments: RefAttachmentSummary[] = [];
-    if (meta.mediaType) {
-      const localPath = meta.mediaLocalPath;
-      const filename = localPath ? path.basename(localPath) : undefined;
-      const attachment: RefAttachmentSummary = {
-        type: meta.mediaType,
-        ...(localPath ? { localPath } : {}),
-        ...(filename ? { filename } : {}),
-        ...(meta.mediaUrl ? { url: meta.mediaUrl } : {}),
-      };
-      if (meta.mediaType === "voice" && meta.ttsText) {
-        attachment.transcript = meta.ttsText;
-        attachment.transcriptSource = "tts";
-      }
-      attachments.push(attachment);
-    }
-    setRefIndex(refIdx, {
-      content: meta.text ?? "",
-      senderId: account.accountId,
-      senderName: account.accountId,
-      timestamp: Date.now(),
-      isBot: true,
-      ...(attachments.length > 0 ? { attachments } : {}),
-    });
-  });
-
-  // ---- 6. Group support (per-connection state) ----
-  const groupOpts = {
-    enabled: ctx.group?.enabled ?? true,
-    allowTextCommands: ctx.group?.allowTextCommands,
-    isControlCommand: ctx.group?.isControlCommand,
-    resolveIntroHint: ctx.group?.resolveIntroHint,
-    sessionStoreReader: ctx.group?.sessionStoreReader,
-  };
-  const groupChatEnabled = groupOpts.enabled;
-  const groupHistories: Map<string, HistoryEntry[]> | undefined = groupChatEnabled
-    ? new Map()
-    : undefined;
-  const sessionStoreReader = groupChatEnabled
-    ? (groupOpts.sessionStoreReader ?? createNodeSessionStoreReader())
-    : undefined;
-
-  // ---- 7. Message handler ----
-  const handleMessage = async (event: QueuedMessage): Promise<void> => {
-    log?.info(`Processing message from ${event.senderId}: ${event.content}`, {
-      accountId: account.accountId,
-      messageId: event.messageId,
-      senderId: event.senderId,
-      type: event.type,
-      groupOpenid: event.groupOpenid,
-    });
-
-    runtime.channel.activity.record({
-      channel: "qqbot",
-      accountId: account.accountId,
-      direction: "inbound",
-    });
-
-    const inbound = await buildInboundContext(event, {
-      account,
-      cfg: ctx.cfg,
-      log,
-      runtime,
-      startTyping: (ev) => startTypingForEvent(ev, account, log),
-      groupHistories,
-      sessionStoreReader,
-      allowTextCommands: groupOpts.allowTextCommands,
-      isControlCommand: groupOpts.isControlCommand,
-      resolveGroupIntroHint: groupOpts.resolveIntroHint,
-      adapters,
-    });
-
-    if (inbound.blocked) {
-      log?.info(`Dropped inbound qqbot message: ${inbound.blockReason ?? "blocked by allowFrom"}`, {
-        accountId: account.accountId,
-        messageId: event.messageId,
-        blockReason: inbound.blockReason,
-      });
-      inbound.typing.keepAlive?.stop();
-      return;
-    }
-
-    // Group gate decided to stop early (drop_other_mention, block, skip
-    // no-mention). History has already been recorded inside the
-    // pipeline; there is no outbound to dispatch.
-    if (inbound.skipped) {
-      log?.info(
-        `Skipped group inbound: reason=${inbound.skipReason ?? "unknown"} group=${event.groupOpenid ?? ""}`,
-        {
-          accountId: account.accountId,
-          messageId: event.messageId,
-          skipReason: inbound.skipReason,
-          groupOpenid: event.groupOpenid,
-        },
-      );
-      inbound.typing.keepAlive?.stop();
-      return;
-    }
-
-    try {
-      await runWithRequestContext(
-        {
-          accountId: account.accountId,
-          target: inbound.qualifiedTarget,
-          targetId: inbound.peerId,
-          chatType: event.type,
-        },
-        () => dispatchOutbound(inbound, { runtime, cfg: ctx.cfg, account, log }),
-      );
-    } catch (err) {
-      log?.error(`Message processing failed: ${err instanceof Error ? err.message : String(err)}`);
-    } finally {
-      inbound.typing.keepAlive?.stop();
-      // Reset the buffered non-@ chatter after every @-activation turn
-      // (success or failure), matching the standalone build. Guards
-      // against stale history leaking into the next reply.
-      if (event.type === "group" && event.groupOpenid && inbound.group) {
-        clearGroupPendingHistory({
-          historyMap: groupHistories,
-          groupOpenid: event.groupOpenid,
-          historyLimit: inbound.group.historyLimit,
-          historyPort: adapters.history,
-        });
-      }
-    }
-  };
-
-  // ---- 8. Interaction handler ----
-  const handleInteraction = createInteractionHandler(account, ctx.runtime, log);
-
-  // ---- 9. Start connection ----
-  const connection = new GatewayConnection({
-    account,
-    abortSignal: ctx.abortSignal,
-    cfg: ctx.cfg,
-    log,
-    runtime,
-    onReady: ctx.onReady,
-    onResumed: ctx.onResumed,
-    onError: ctx.onError,
-    onInteraction: handleInteraction,
-    handleMessage,
-  });
-
-  await connection.start();
-}
-
-// ============ Typing helper ============
-
-/**
- * Start typing indicator for a C2C event.
- * Returns the refIdx from InputNotify and a TypingKeepAlive handle.
- */
-async function startTypingForEvent(
-  event: QueuedMessage,
-  account: GatewayAccount,
-  log?: EngineLogger,
-): Promise<{ refIdx?: string; keepAlive: TypingKeepAlive | null }> {
-  const isC2C = event.type === "c2c" || event.type === "dm";
-  if (!isC2C) {
-    return { keepAlive: null };
-  }
-  try {
-    const creds = accountToCreds(account);
-    const rawNotifyFn = createRawInputNotifyFn(account.appId);
-    try {
-      const resp = await senderSendInputNotify({
-        openid: event.senderId,
-        creds,
-        msgId: event.messageId,
-        inputSecond: TYPING_INPUT_SECOND,
-      });
-      const keepAlive = new TypingKeepAlive(
-        () => getAccessToken(account.appId, account.clientSecret),
-        () => clearTokenCache(account.appId),
-        rawNotifyFn,
-        event.senderId,
-        event.messageId,
-        log,
-      );
-      keepAlive.start();
-      return { refIdx: resp.refIdx, keepAlive };
-    } catch (notifyErr) {
-      const errMsg = String(notifyErr);
-      if (errMsg.includes("token") || errMsg.includes("401") || errMsg.includes("11244")) {
-        clearTokenCache(account.appId);
-        const resp = await senderSendInputNotify({
-          openid: event.senderId,
-          creds,
-          msgId: event.messageId,
-          inputSecond: TYPING_INPUT_SECOND,
-        });
-        const keepAlive = new TypingKeepAlive(
-          () => getAccessToken(account.appId, account.clientSecret),
-          () => clearTokenCache(account.appId),
-          rawNotifyFn,
-          event.senderId,
-          event.messageId,
-          log,
-        );
-        keepAlive.start();
-        return { refIdx: resp.refIdx, keepAlive };
-      }
-      throw notifyErr;
-    }
-  } catch (err) {
-    log?.error(`sendInputNotify error: ${err instanceof Error ? err.message : String(err)}`);
-    return { keepAlive: null };
-  }
-}

package/src/engine/gateway/inbound-attachments.test.ts

@@ -1,126 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from "vitest";
-import { processAttachments, type AudioConvertPort } from "./inbound-attachments.js";
-
-const downloadFileMock = vi.hoisted(() => vi.fn());
-const resolveSTTConfigMock = vi.hoisted(() => vi.fn());
-const transcribeAudioMock = vi.hoisted(() => vi.fn());
-
-vi.mock("../utils/file-utils.js", () => ({
-  downloadFile: downloadFileMock,
-}));
-
-vi.mock("../utils/platform.js", () => ({
-  getQQBotMediaDir: () => "/tmp/openclaw-qqbot-downloads",
-}));
-
-vi.mock("../utils/stt.js", () => ({
-  resolveSTTConfig: resolveSTTConfigMock,
-  transcribeAudio: transcribeAudioMock,
-}));
-
-function createAudioConvert(overrides: Partial<AudioConvertPort> = {}): AudioConvertPort {
-  return {
-    convertSilkToWav: vi.fn(async () => null),
-    formatDuration: (seconds: number) => `${seconds}s`,
-    isVoiceAttachment: (att: { content_type: string; filename?: string }) =>
-      att.content_type === "voice" || att.content_type.startsWith("audio/"),
-    ...overrides,
-  };
-}
-
-describe("engine/gateway/inbound-attachments", () => {
-  let audioConvert: AudioConvertPort;
-
-  beforeEach(() => {
-    vi.clearAllMocks();
-    resolveSTTConfigMock.mockReturnValue(null);
-    transcribeAudioMock.mockResolvedValue(null);
-    audioConvert = createAudioConvert();
-  });
-
-  it("returns an empty result when no attachments are present", async () => {
-    await expect(
-      processAttachments(undefined, { accountId: "qq", cfg: {}, audioConvert }),
-    ).resolves.toMatchObject({
-      attachmentInfo: "",
-      imageUrls: [],
-      voiceAttachmentPaths: [],
-      attachmentLocalPaths: [],
-    });
-  });
-
-  it("uses remote image URL when image download fails", async () => {
-    downloadFileMock.mockResolvedValue(null);
-
-    const result = await processAttachments(
-      [{ content_type: "image/png", url: "//cdn.example.test/a.png", filename: "a.png" }],
-      { accountId: "qq", cfg: {}, audioConvert },
-    );
-
-    expect(downloadFileMock).toHaveBeenCalledWith(
-      "https://cdn.example.test/a.png",
-      "/tmp/openclaw-qqbot-downloads",
-      "a.png",
-    );
-    expect(result.imageUrls).toEqual(["https://cdn.example.test/a.png"]);
-    expect(result.imageMediaTypes).toEqual(["image/png"]);
-    expect(result.attachmentLocalPaths).toEqual([null]);
-  });
-
-  it("prefers voice_wav_url for voice downloads and transcribes with configured STT", async () => {
-    downloadFileMock.mockResolvedValue("/tmp/openclaw-qqbot-downloads/voice.wav");
-    resolveSTTConfigMock.mockReturnValue({
-      baseUrl: "https://stt.example.test",
-      apiKey: "key",
-      model: "whisper-1",
-    });
-    transcribeAudioMock.mockResolvedValue("transcribed voice");
-
-    const result = await processAttachments(
-      [
-        {
-          content_type: "voice",
-          url: "https://cdn.example.test/voice.silk",
-          filename: "voice.silk",
-          voice_wav_url: "//cdn.example.test/voice.wav",
-          asr_refer_text: "platform text",
-        },
-      ],
-      { accountId: "qq", cfg: { channels: { qqbot: { stt: {} } } }, audioConvert },
-    );
-
-    expect(downloadFileMock).toHaveBeenCalledWith(
-      "https://cdn.example.test/voice.wav",
-      "/tmp/openclaw-qqbot-downloads",
-    );
-    expect(transcribeAudioMock).toHaveBeenCalledWith("/tmp/openclaw-qqbot-downloads/voice.wav", {
-      channels: { qqbot: { stt: {} } },
-    });
-    expect(result.voiceAttachmentPaths).toEqual(["/tmp/openclaw-qqbot-downloads/voice.wav"]);
-    expect(result.voiceAttachmentUrls).toEqual(["https://cdn.example.test/voice.wav"]);
-    expect(result.voiceAsrReferTexts).toEqual(["platform text"]);
-    expect(result.voiceTranscripts).toEqual(["transcribed voice"]);
-    expect(result.voiceTranscriptSources).toEqual(["stt"]);
-  });
-
-  it("falls back to platform ASR text when voice download fails", async () => {
-    downloadFileMock.mockResolvedValue(null);
-
-    const result = await processAttachments(
-      [
-        {
-          content_type: "voice",
-          url: "https://cdn.example.test/voice.silk",
-          filename: "voice.silk",
-          asr_refer_text: "platform text",
-        },
-      ],
-      { accountId: "qq", cfg: {}, audioConvert },
-    );
-
-    expect(result.voiceAttachmentUrls).toEqual(["https://cdn.example.test/voice.silk"]);
-    expect(result.voiceTranscripts).toEqual(["platform text"]);
-    expect(result.voiceTranscriptSources).toEqual(["asr"]);
-    expect(result.attachmentLocalPaths).toEqual([null]);
-  });
-});