@openclaw/qqbot 2026.5.2-beta.2 → 2026.5.3-beta.1

package/src/engine/config/credentials.ts

@@ -1,76 +0,0 @@
-/**
- * QQBot credential management (pure logic layer).
- * QQBot 凭证管理（纯逻辑层）。
- *
- * Credential clearing and field-level cleanup for logout and setup
- * flows. All functions operate on plain objects (Record<string, unknown>)
- * and stay framework-agnostic.
- */
-
-import { asOptionalObjectRecord as asRecord } from "../utils/string-normalize.js";
-import { DEFAULT_ACCOUNT_ID } from "./resolve.js";
-
-// ---- Logout: clear all credential fields for an account ----
-
-interface ClearCredentialsResult {
-  nextCfg: Record<string, unknown>;
-  cleared: boolean;
-  changed: boolean;
-}
-
-/**
- * Remove clientSecret / clientSecretFile from a QQBot account config.
- *
- * Returns a shallow-cloned config with credentials removed, plus flags
- * indicating whether anything actually changed.
- */
-export function clearAccountCredentials(
-  cfg: Record<string, unknown>,
-  accountId: string,
-): ClearCredentialsResult {
-  const nextCfg = { ...cfg };
-  const channels = asRecord(cfg.channels);
-  const nextQQBot = channels?.qqbot ? { ...asRecord(channels.qqbot) } : undefined;
-  let cleared = false;
-  let changed = false;
-
-  if (nextQQBot) {
-    const qqbot = nextQQBot as Record<string, unknown>;
-    if (accountId === DEFAULT_ACCOUNT_ID) {
-      if (qqbot.clientSecret) {
-        delete qqbot.clientSecret;
-        cleared = true;
-        changed = true;
-      }
-      if (qqbot.clientSecretFile) {
-        delete qqbot.clientSecretFile;
-        cleared = true;
-        changed = true;
-      }
-    }
-    const accounts = qqbot.accounts as Record<string, Record<string, unknown>> | undefined;
-    if (accounts && accountId in accounts) {
-      const entry = accounts[accountId] as Record<string, unknown> | undefined;
-      if (entry && "clientSecret" in entry) {
-        delete entry.clientSecret;
-        cleared = true;
-        changed = true;
-      }
-      if (entry && "clientSecretFile" in entry) {
-        delete entry.clientSecretFile;
-        cleared = true;
-        changed = true;
-      }
-      if (entry && Object.keys(entry).length === 0) {
-        delete accounts[accountId];
-        changed = true;
-      }
-    }
-  }
-
-  if (changed && nextQQBot) {
-    nextCfg.channels = { ...channels, qqbot: nextQQBot };
-  }
-
-  return { nextCfg, cleared, changed };
-}

package/src/engine/config/group.test.ts

@@ -1,234 +0,0 @@
-import { describe, expect, it } from "vitest";
-import {
-  DEFAULT_GROUP_HISTORY_LIMIT,
-  resolveGroupConfig,
-  resolveGroupName,
-  resolveGroupPrompt,
-  resolveGroupSettings,
-  resolveGroupToolPolicy,
-  resolveHistoryLimit,
-  resolveIgnoreOtherMentions,
-  resolveMentionPatterns,
-  resolveRequireMention,
-} from "./group.js";
-
-describe("engine/config/group", () => {
-  describe("resolveGroupConfig precedence", () => {
-    it("returns defaults when no config exists", () => {
-      const cfg = resolveGroupConfig({}, "G1");
-      expect(cfg).toMatchObject({
-        requireMention: true,
-        ignoreOtherMentions: false,
-        toolPolicy: "restricted",
-        name: "",
-        historyLimit: DEFAULT_GROUP_HISTORY_LIMIT,
-      });
-      expect(cfg.prompt).toBeUndefined();
-    });
-
-    it("falls back to wildcard when specific is missing", () => {
-      const cfg = {
-        channels: {
-          qqbot: {
-            appId: "1",
-            groups: {
-              "*": {
-                requireMention: false,
-                toolPolicy: "full",
-                historyLimit: 20,
-                name: "wild",
-              },
-            },
-          },
-        },
-      };
-      const resolved = resolveGroupConfig(cfg, "G1");
-      expect(resolved.requireMention).toBe(false);
-      expect(resolved.toolPolicy).toBe("full");
-      expect(resolved.historyLimit).toBe(20);
-      expect(resolved.name).toBe("wild");
-    });
-
-    it("specific overrides wildcard and defaults", () => {
-      const cfg = {
-        channels: {
-          qqbot: {
-            appId: "1",
-            groups: {
-              "*": { requireMention: true, toolPolicy: "restricted", historyLimit: 20 },
-              GROUPA: { requireMention: false, toolPolicy: "none", historyLimit: 5, name: "A" },
-            },
-          },
-        },
-      };
-      const resolved = resolveGroupConfig(cfg, "GROUPA");
-      expect(resolved.requireMention).toBe(false);
-      expect(resolved.toolPolicy).toBe("none");
-      expect(resolved.historyLimit).toBe(5);
-      expect(resolved.name).toBe("A");
-    });
-
-    it("historyLimit is clamped to >= 0 and floored", () => {
-      const cfg = {
-        channels: {
-          qqbot: { appId: "1", groups: { "*": { historyLimit: -3.7 } } },
-        },
-      };
-      expect(resolveHistoryLimit(cfg, "G")).toBe(0);
-    });
-
-    it("non-finite historyLimit falls back to default", () => {
-      const cfg = {
-        channels: {
-          qqbot: { appId: "1", groups: { "*": { historyLimit: "not a number" } } },
-        },
-      };
-      expect(resolveHistoryLimit(cfg, "G")).toBe(DEFAULT_GROUP_HISTORY_LIMIT);
-    });
-
-    it("invalid toolPolicy values are ignored", () => {
-      const cfg = {
-        channels: {
-          qqbot: { appId: "1", groups: { "*": { toolPolicy: "invalid" } } },
-        },
-      };
-      expect(resolveGroupToolPolicy(cfg, "G")).toBe("restricted");
-    });
-  });
-
-  describe("named accounts", () => {
-    it("reads groups from the named-account scope", () => {
-      const cfg = {
-        channels: {
-          qqbot: {
-            accounts: {
-              bot2: {
-                appId: "9",
-                groups: { "*": { requireMention: false, historyLimit: 7 } },
-              },
-            },
-          },
-        },
-      };
-      expect(resolveRequireMention(cfg, "G", "bot2")).toBe(false);
-      expect(resolveHistoryLimit(cfg, "G", "bot2")).toBe(7);
-    });
-  });
-
-  describe("resolveGroupName", () => {
-    it("uses the first 8 chars of openid when name is unset", () => {
-      expect(resolveGroupName({}, "ABCDEFGH1234")).toBe("ABCDEFGH");
-    });
-
-    it("prefers the configured name", () => {
-      const cfg = {
-        channels: { qqbot: { appId: "1", groups: { ABCDEFGH1234: { name: "Foo" } } } },
-      };
-      expect(resolveGroupName(cfg, "ABCDEFGH1234")).toBe("Foo");
-    });
-  });
-
-  describe("resolveGroupPrompt", () => {
-    it("returns the default prompt when nothing configured", () => {
-      expect(resolveGroupPrompt({}, "G")).toContain("bot");
-    });
-
-    it("prefers specific over wildcard", () => {
-      const cfg = {
-        channels: {
-          qqbot: {
-            appId: "1",
-            groups: { "*": { prompt: "WILD" }, G1: { prompt: "SPEC" } },
-          },
-        },
-      };
-      expect(resolveGroupPrompt(cfg, "G1")).toBe("SPEC");
-      expect(resolveGroupPrompt(cfg, "G2")).toBe("WILD");
-    });
-  });
-
-  describe("resolveIgnoreOtherMentions", () => {
-    it("defaults to false", () => {
-      expect(resolveIgnoreOtherMentions({}, "G")).toBe(false);
-    });
-
-    it("honours wildcard override", () => {
-      const cfg = {
-        channels: { qqbot: { appId: "1", groups: { "*": { ignoreOtherMentions: true } } } },
-      };
-      expect(resolveIgnoreOtherMentions(cfg, "G")).toBe(true);
-    });
-  });
-
-  describe("resolveMentionPatterns", () => {
-    it("returns [] when nothing configured", () => {
-      expect(resolveMentionPatterns({})).toEqual([]);
-    });
-
-    it("reads global patterns", () => {
-      const cfg = { messages: { groupChat: { mentionPatterns: ["/^hey/"] } } };
-      expect(resolveMentionPatterns(cfg)).toEqual(["/^hey/"]);
-    });
-
-    it("agent-level overrides global", () => {
-      const cfg = {
-        messages: { groupChat: { mentionPatterns: ["g"] } },
-        agents: {
-          list: [{ id: "main", groupChat: { mentionPatterns: ["a", "b"] } }],
-        },
-      };
-      expect(resolveMentionPatterns(cfg, "main")).toEqual(["a", "b"]);
-      expect(resolveMentionPatterns(cfg, "OTHER")).toEqual(["g"]);
-    });
-
-    it("filters non-string entries", () => {
-      const cfg = { messages: { groupChat: { mentionPatterns: ["ok", 42, null] } } };
-      expect(resolveMentionPatterns(cfg)).toEqual(["ok"]);
-    });
-  });
-
-  describe("resolveGroupSettings (aggregate)", () => {
-    it("returns merged config + name + mentionPatterns in one call", () => {
-      const cfg = {
-        channels: {
-          qqbot: {
-            appId: "1",
-            groups: {
-              G1: { requireMention: false, name: "Dev" },
-              "*": { historyLimit: 10 },
-            },
-          },
-        },
-        messages: { groupChat: { mentionPatterns: ["@bot"] } },
-      };
-      const settings = resolveGroupSettings({ cfg, groupOpenid: "G1" });
-      expect(settings.config.requireMention).toBe(false);
-      expect(settings.config.historyLimit).toBe(10);
-      expect(settings.name).toBe("Dev");
-      expect(settings.mentionPatterns).toEqual(["@bot"]);
-    });
-
-    it("falls back to the first 8 chars of the openid for name", () => {
-      const settings = resolveGroupSettings({
-        cfg: {},
-        groupOpenid: "ABCDEFGHIJKLMNOP",
-      });
-      expect(settings.name).toBe("ABCDEFGH");
-    });
-
-    it("applies agent-level mentionPatterns over global", () => {
-      const cfg = {
-        agents: {
-          list: [{ id: "custom", groupChat: { mentionPatterns: ["@agent"] } }],
-        },
-        messages: { groupChat: { mentionPatterns: ["@global"] } },
-      };
-      const settings = resolveGroupSettings({
-        cfg,
-        groupOpenid: "G1",
-        agentId: "custom",
-      });
-      expect(settings.mentionPatterns).toEqual(["@agent"]);
-    });
-  });
-});

package/src/engine/config/group.ts

@@ -1,299 +0,0 @@
-/**
- * QQBot group configuration resolution (pure logic).
- * QQBot 群配置解析（纯逻辑层）。
- *
- * Resolves per-group settings that the inbound pipeline needs to decide how
- * to gate and contextualize group messages. Reads from a raw config object
- * produced by the framework's config loader, with a `specific > wildcard
- * ("*") > default` precedence chain.
- *
- * All functions are **pure** (no I/O, no external state) — making them
- * portable to the standalone plugin build and trivially unit-testable.
- */
-
-import { asOptionalObjectRecord as asRecord } from "../utils/string-normalize.js";
-import { resolveAccountBase } from "./resolve.js";
-
-// ============ Types ============
-
-/**
- * Tool policy — which tool palette an agent should use in a given group.
- *
- * - `full`:       default allow everything (no engine-side restriction).
- * - `restricted`: engine returns an empty allowlist so the framework falls
- *                 back to its built-in restricted palette.
- * - `none`:       deny all tools.
- */
-type GroupToolPolicy = "full" | "restricted" | "none";
-
-/** Per-group configuration — everything that may be overridden per group. */
-interface GroupConfig {
-  /** Whether the bot requires @mention to respond. Defaults to true. */
-  requireMention: boolean;
-  /**
-   * When true, group messages that @other users (but not the bot) are
-   * dropped silently without reaching the AI pipeline.
-   */
-  ignoreOtherMentions: boolean;
-  /** Tool palette policy. Defaults to "restricted". */
-  toolPolicy: GroupToolPolicy;
-  /** Human-readable group name. Empty string if not configured. */
-  name: string;
-  /** Per-group behaviour prompt appended to the system prompt. */
-  prompt?: string;
-  /**
-   * Number of non-@ history messages buffered per group. Clamped to 0 when
-   * disabled. The default matches the standalone build's `50`.
-   */
-  historyLimit: number;
-}
-
-// ============ Defaults ============
-
-/** Default history limit — matches the standalone build. */
-export const DEFAULT_GROUP_HISTORY_LIMIT = 50;
-
-/** Default group behaviour prompt. Exported so the gating stage can use
- *  the same fallback when no per-group `prompt` is configured. */
-export const DEFAULT_GROUP_PROMPT =
-  "If the sender is a bot, respond only when they explicitly @mention you to ask a question or request assistance with a specific task; keep your replies concise and clear, avoiding the urge to race other bots to answer or engage in lengthy, unproductive exchanges. In group chats, prioritize responding to messages from human users; bots should maintain a collaborative rather than competitive dynamic to ensure the conversation remains orderly and does not result in message flooding.";
-
-const DEFAULT_GROUP_CONFIG: Readonly<Omit<GroupConfig, "prompt">> = {
-  requireMention: true,
-  ignoreOtherMentions: false,
-  toolPolicy: "restricted",
-  name: "",
-  historyLimit: DEFAULT_GROUP_HISTORY_LIMIT,
-};
-
-// ============ Helpers ============
-
-/** Read a named account's raw `groups` map from an OpenClawConfig. */
-function readGroupsMap(
-  cfg: Record<string, unknown>,
-  accountId?: string | null,
-): Record<string, Record<string, unknown>> {
-  const account = resolveAccountBase(cfg, accountId);
-  const groups = asRecord(account.config.groups);
-  if (!groups) {
-    return {};
-  }
-  // Only keep sub-objects; skip scalars produced by user mistakes.
-  const normalized: Record<string, Record<string, unknown>> = {};
-  for (const [key, value] of Object.entries(groups)) {
-    const sub = asRecord(value);
-    if (sub) {
-      normalized[key] = sub;
-    }
-  }
-  return normalized;
-}
-
-function readBoolean(obj: Record<string, unknown>, key: string): boolean | undefined {
-  const v = obj[key];
-  return typeof v === "boolean" ? v : undefined;
-}
-
-function readString(obj: Record<string, unknown>, key: string): string | undefined {
-  const v = obj[key];
-  return typeof v === "string" && v.length > 0 ? v : undefined;
-}
-
-function readToolPolicy(obj: Record<string, unknown>, key: string): GroupToolPolicy | undefined {
-  const v = obj[key];
-  return v === "full" || v === "restricted" || v === "none" ? v : undefined;
-}
-
-function readHistoryLimit(obj: Record<string, unknown>, key: string): number | undefined {
-  const v = obj[key];
-  if (typeof v !== "number" || !Number.isFinite(v)) {
-    return undefined;
-  }
-  return Math.max(0, Math.floor(v));
-}
-
-// ============ Public API ============
-
-/**
- * Resolve per-group configuration with `specific > "*" > default` precedence.
- *
- * When `groupOpenid` is not provided, only the wildcard/default values are
- * returned. This lets callers query the "default" behaviour for new groups.
- */
-export function resolveGroupConfig(
-  cfg: Record<string, unknown>,
-  groupOpenid?: string | null,
-  accountId?: string | null,
-): GroupConfig {
-  const groups = readGroupsMap(cfg, accountId);
-  const wildcard = groups["*"] ?? {};
-  const specific = groupOpenid ? (groups[groupOpenid] ?? {}) : {};
-
-  return {
-    requireMention:
-      readBoolean(specific, "requireMention") ??
-      readBoolean(wildcard, "requireMention") ??
-      DEFAULT_GROUP_CONFIG.requireMention,
-    ignoreOtherMentions:
-      readBoolean(specific, "ignoreOtherMentions") ??
-      readBoolean(wildcard, "ignoreOtherMentions") ??
-      DEFAULT_GROUP_CONFIG.ignoreOtherMentions,
-    toolPolicy:
-      readToolPolicy(specific, "toolPolicy") ??
-      readToolPolicy(wildcard, "toolPolicy") ??
-      DEFAULT_GROUP_CONFIG.toolPolicy,
-    name: readString(specific, "name") ?? readString(wildcard, "name") ?? DEFAULT_GROUP_CONFIG.name,
-    prompt: readString(specific, "prompt") ?? readString(wildcard, "prompt"),
-    historyLimit:
-      readHistoryLimit(specific, "historyLimit") ??
-      readHistoryLimit(wildcard, "historyLimit") ??
-      DEFAULT_GROUP_CONFIG.historyLimit,
-  };
-}
-
-/** Resolve the effective `historyLimit` (>= 0) for a given group. */
-export function resolveHistoryLimit(
-  cfg: Record<string, unknown>,
-  groupOpenid?: string | null,
-  accountId?: string | null,
-): number {
-  return resolveGroupConfig(cfg, groupOpenid, accountId).historyLimit;
-}
-
-/** Resolve `requireMention` for a given group. */
-export function resolveRequireMention(
-  cfg: Record<string, unknown>,
-  groupOpenid?: string | null,
-  accountId?: string | null,
-): boolean {
-  return resolveGroupConfig(cfg, groupOpenid, accountId).requireMention;
-}
-
-/** Resolve `ignoreOtherMentions` for a given group. */
-export function resolveIgnoreOtherMentions(
-  cfg: Record<string, unknown>,
-  groupOpenid?: string | null,
-  accountId?: string | null,
-): boolean {
-  return resolveGroupConfig(cfg, groupOpenid, accountId).ignoreOtherMentions;
-}
-
-/** Resolve tool policy for a given group. */
-export function resolveGroupToolPolicy(
-  cfg: Record<string, unknown>,
-  groupOpenid?: string | null,
-  accountId?: string | null,
-): GroupToolPolicy {
-  return resolveGroupConfig(cfg, groupOpenid, accountId).toolPolicy;
-}
-
-/**
- * Resolve the behaviour prompt (PE) for a group. Falls back to the built-in
- * default when neither specific nor wildcard configuration provides one.
- */
-export function resolveGroupPrompt(
-  cfg: Record<string, unknown>,
-  groupOpenid?: string | null,
-  accountId?: string | null,
-): string {
-  return resolveGroupConfig(cfg, groupOpenid, accountId).prompt ?? DEFAULT_GROUP_PROMPT;
-}
-
-/**
- * Resolve the display name for a group.
- *
- * When no name is configured, the first 8 characters of the openid are used
- * as a short identifier so log lines stay compact.
- */
-export function resolveGroupName(
-  cfg: Record<string, unknown>,
-  groupOpenid: string,
-  accountId?: string | null,
-): string {
-  const name = resolveGroupConfig(cfg, groupOpenid, accountId).name;
-  return name || groupOpenid.slice(0, 8);
-}
-
-// ============ GroupSettings (aggregate) ============
-
-/**
- * Per-inbound aggregate of everything the pipeline needs about a group.
- *
- * Built once at the top of the group-gate stage so downstream consumers
- * don't repeatedly re-parse the same `cfg` tree. Superset of
- * {@link GroupConfig}: also includes the effective `mentionPatterns`
- * (which depend on `agentId`, not on the group itself) and a
- * pre-computed display name for logging.
- */
-interface GroupSettings {
-  /** Merged group config (specific > wildcard > defaults). */
-  config: GroupConfig;
-  /** Display name — `config.name` or the first 8 chars of the openid. */
-  name: string;
-  /** Raw mentionPatterns (agent > global > []). */
-  mentionPatterns: string[];
-}
-
-/**
- * Resolve all per-inbound group-related settings in one pass.
- *
- * Prefer this over calling `resolveHistoryLimit` / `resolveRequireMention`
- * / etc. individually in hot paths — each of those currently re-walks
- * the config tree on its own.
- */
-export function resolveGroupSettings(params: {
-  cfg: Record<string, unknown>;
-  groupOpenid: string;
-  accountId?: string | null;
-  agentId?: string | null;
-}): GroupSettings {
-  const config = resolveGroupConfig(params.cfg, params.groupOpenid, params.accountId);
-  const name = config.name || params.groupOpenid.slice(0, 8);
-  const mentionPatterns = resolveMentionPatterns(params.cfg, params.agentId);
-  return { config, name, mentionPatterns };
-}
-
-interface AgentEntry {
-  id?: unknown;
-  groupChat?: { mentionPatterns?: unknown };
-}
-
-/**
- * Resolve mentionPatterns with `agent > global > []` precedence.
- *
- * Mirrors the framework's `messages.groupChat.mentionPatterns` / per-agent
- * `agents.list[].groupChat.mentionPatterns` chain.
- */
-export function resolveMentionPatterns(
-  cfg: Record<string, unknown>,
-  agentId?: string | null,
-): string[] {
-  // ---- 1. Agent-level ----
-  if (agentId) {
-    const agents = asRecord(cfg.agents);
-    const list = Array.isArray(agents?.list) ? (agents?.list as AgentEntry[]) : [];
-    const entry = list.find(
-      (a) => typeof a.id === "string" && a.id.trim().toLowerCase() === agentId.trim().toLowerCase(),
-    );
-    const agentGroupChat = entry?.groupChat;
-    if (agentGroupChat && Object.hasOwn(agentGroupChat, "mentionPatterns")) {
-      const patterns = agentGroupChat.mentionPatterns;
-      return Array.isArray(patterns)
-        ? patterns.filter((p): p is string => typeof p === "string")
-        : [];
-    }
-  }
-
-  // ---- 2. Global level ----
-  const messages = asRecord(cfg.messages);
-  const globalGroupChat = asRecord(messages?.groupChat);
-  if (globalGroupChat && Object.hasOwn(globalGroupChat, "mentionPatterns")) {
-    const patterns = globalGroupChat.mentionPatterns;
-    return Array.isArray(patterns)
-      ? patterns.filter((p): p is string => typeof p === "string")
-      : [];
-  }
-
-  // ---- 3. Default ----
-  return [];
-}