koishi-plugin-chatluna-toolbox 0.0.1

package/lib/index.js

@@ -0,0 +1,1480 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name2 in all)
+    __defProp(target, name2, { get: all[name2], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Config: () => ConfigSchema,
+  ConfigSchema: () => ConfigSchema,
+  DEFAULT_MEMBER_INFO_ITEMS: () => DEFAULT_MEMBER_INFO_ITEMS,
+  NativeToolsSchema: () => NativeToolsSchema,
+  RAW_INTERCEPTOR_TAG: () => RAW_INTERCEPTOR_TAG,
+  VariablesSchema: () => VariablesSchema,
+  XmlToolsSchema: () => XmlToolsSchema,
+  apply: () => apply,
+  callOneBotAPI: () => callOneBotAPI,
+  createBotInfoProvider: () => createBotInfoProvider,
+  createDeleteMessageTool: () => createDeleteMessageTool,
+  createGroupInfoProvider: () => createGroupInfoProvider,
+  createLogger: () => createLogger,
+  createPokeTool: () => createPokeTool,
+  createRandomProvider: () => createRandomProvider,
+  createSetGroupCardTool: () => createSetGroupCardTool,
+  createSetMsgEmojiTool: () => createSetMsgEmojiTool,
+  createSetProfileTool: () => createSetProfileTool,
+  createUserInfoProvider: () => createUserInfoProvider,
+  createXmlInterceptor: () => createXmlInterceptor,
+  ensureOneBotSession: () => ensureOneBotSession,
+  getSession: () => getSession,
+  inject: () => inject,
+  name: () => name,
+  parseXmlActions: () => parseXmlActions,
+  registerNativeTools: () => registerNativeTools,
+  registerVariables: () => registerVariables,
+  registerXmlTools: () => registerXmlTools,
+  resolveOneBotProtocol: () => resolveOneBotProtocol,
+  sendDeleteMessage: () => sendDeleteMessage,
+  sendMsgEmoji: () => sendMsgEmoji,
+  sendPoke: () => sendPoke
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/schema/index.ts
+var import_koishi4 = require("koishi");
+
+// src/schema/native-tools.ts
+var import_koishi = require("koishi");
+var NativeToolsSchema = import_koishi.Schema.object({
+  enableNapCatProtocol: import_koishi.Schema.boolean().default(true).description("\u542F\u7528 NapCat OneBot \u534F\u8BAE\uFF08\u4E0E LLBot \u4E8C\u9009\u4E00\uFF09"),
+  enableLlbotProtocol: import_koishi.Schema.boolean().default(false).description("\u542F\u7528 LLBot OneBot \u534F\u8BAE\uFF08\u4E0E NapCat \u4E8C\u9009\u4E00\uFF09"),
+  enablePokeTool: import_koishi.Schema.boolean().default(false).description("\u6CE8\u518C ChatLuna \u5DE5\u5177\uFF1A\u6233\u4E00\u6233\uFF08\u5EFA\u8BAE\u4E0E XML\u5DE5\u5177 \u4E8C\u9009\u4E00\uFF09"),
+  pokeToolName: import_koishi.Schema.string().default("poke_user").description("ChatLuna \u5DE5\u5177\u540D\u79F0\uFF1A\u6233\u4E00\u6233"),
+  enableSetSelfProfileTool: import_koishi.Schema.boolean().default(false).description("\u6CE8\u518C ChatLuna \u5DE5\u5177\uFF1A\u4FEE\u6539\u81EA\u8EAB\u8D26\u6237\u4FE1\u606F"),
+  setSelfProfileToolName: import_koishi.Schema.string().default("set_self_profile").description("ChatLuna \u5DE5\u5177\u540D\u79F0\uFF1A\u4FEE\u6539\u81EA\u8EAB\u8D26\u6237\u4FE1\u606F\uFF08\u652F\u6301\u6635\u79F0/\u7B7E\u540D/\u6027\u522B\uFF09"),
+  enableSetGroupCardTool: import_koishi.Schema.boolean().default(false).description("\u6CE8\u518C ChatLuna \u5DE5\u5177\uFF1A\u4FEE\u6539\u7FA4\u6210\u5458\u6635\u79F0"),
+  setGroupCardToolName: import_koishi.Schema.string().default("set_group_card").description("ChatLuna \u5DE5\u5177\u540D\u79F0\uFF1A\u4FEE\u6539\u7FA4\u6210\u5458\u6635\u79F0"),
+  enableSetMsgEmojiTool: import_koishi.Schema.boolean().default(false).description("\u6CE8\u518C ChatLuna \u5DE5\u5177\uFF1A\u7ED9\u6D88\u606F\u6DFB\u52A0\u8868\u60C5\uFF08\u9700 chatluna-character \u5F00\u542F enableMessageId\uFF0C\u5EFA\u8BAE\u4E0E XML\u5DE5\u5177 \u4E8C\u9009\u4E00\uFF09"),
+  setMsgEmojiToolName: import_koishi.Schema.string().default("set_msg_emoji").description("ChatLuna \u5DE5\u5177\u540D\u79F0\uFF1A\u7ED9\u6D88\u606F\u6DFB\u52A0\u8868\u60C5"),
+  enableDeleteMessageTool: import_koishi.Schema.boolean().default(false).description("\u6CE8\u518C ChatLuna \u5DE5\u5177\uFF1A\u64A4\u56DE\u6D88\u606F\uFF08\u9700 chatluna-character \u5F00\u542F enableMessageId\uFF0C\u5EFA\u8BAE\u4E0E XML\u5DE5\u5177 \u4E8C\u9009\u4E00\uFF09"),
+  deleteMessageToolName: import_koishi.Schema.string().default("delete_msg").description("ChatLuna \u5DE5\u5177\u540D\u79F0\uFF1A\u64A4\u56DE\u6D88\u606F")
+}).description("\u539F\u751F\u5DE5\u5177");
+
+// src/schema/xml-tools.ts
+var import_koishi2 = require("koishi");
+var DEFAULT_XML_REFERENCE_PROMPT = `## \u52A8\u4F5C\u6307\u4EE4
+\u4F60\u53EF\u4EE5\u6839\u636E\u9700\u8981\u521B\u5EFA\u4E00\u4E2A\u72EC\u7ACB\u7684 <actions> \u5143\u7D20\u3002\u5B83\u7528\u4E8E\u6267\u884C\u975E\u8BED\u8A00\u7684\u7CFB\u7EDF\u6307\u4EE4\u3002\u5982\u679C\u4E0D\u9700\u8981\u6267\u884C\u4EFB\u4F55\u52A8\u4F5C\uFF0C\u8BF7\u7701\u7565\u6B64\u5143\u7D20\u3002
+1. \u6233\u4E00\u6233: <poke id=""/>
+  - id: user_id
+  - \u9002\u7528\u573A\u666F:
+    - \u5F53\u4F60\u60F3\u5F15\u8D77\u67D0\u4EBA\u7684\u6CE8\u610F\u65F6\u3002
+    - \u5F53\u5BF9\u65B9\u8BF4\u4E86\u8BA9\u4F60\u611F\u5230\u65E0\u8BED\u3001\u65E0\u89C6\u4F60\u3001\u6216\u8005\u4F60\u60F3\u901A\u8FC7\u80A2\u4F53\u4E92\u52A8\u8C03\u4F83\u5BF9\u65B9\u65F6\u3002
+    - \u4F5C\u4E3A\u4E00\u79CD\u4FCF\u76AE\u7684\u6253\u62DB\u547C\u65B9\u5F0F\u3002
+2. \u8868\u60C5\u56DE\u5E94: <emoji message_id="" emoji_id=""/>
+  - message_id: \u6D88\u606F ID
+  - emoji_id \u5BF9\u5E94\u8868:
+    - 424: \u8D5E\u540C (\u7EA2\u8272\u6309\u94AE)
+    - 10068: \u95EE\u53F7
+    - 265: \u9006\u5929 (\u5730\u94C1\u8001\u4EBA\u624B\u673A)
+    - 76: \u8D5E
+    - 66: \u7231\u5FC3
+  - \u9002\u7528\u573A\u666F:
+    - \u7528\u4E8E\u5BF9\u4E0A\u4E0B\u6587\u4E2D\u7684\u7279\u5B9A\u6D88\u606F\u8FDB\u884C\u8868\u60C5\u56DE\u5E94\u3002
+3. \u64A4\u56DE\u6D88\u606F: <delete message_id=""/>
+  - message_id: \u6D88\u606F ID
+  - \u9002\u7528\u573A\u666F:
+    - \u4F60\u5728\u672C\u7FA4\u4E3A\u7BA1\u7406\u5458
+    - \u7528\u4E8E\u64A4\u56DE\u6307\u5B9A\u6D88\u606F
+
+\u683C\u5F0F\u793A\u4F8B:
+\`\`\`xml
+  <actions>
+    <poke id="123456"/>
+    <emoji message_id="346234" emoji_id="66"/>
+    <delete message_id="435663"/>
+  </actions>
+\`\`\``;
+var XmlToolsSchema = import_koishi2.Schema.object({
+  enablePokeXmlTool: import_koishi2.Schema.boolean().default(false).description("\u542F\u7528 XML \u5F62\u5F0F\u7684\u6233\u4E00\u6233\u8C03\u7528"),
+  enableEmojiXmlTool: import_koishi2.Schema.boolean().default(false).description("\u542F\u7528 XML \u5F62\u5F0F\u7684\u6D88\u606F\u8868\u60C5\u8C03\u7528"),
+  enableDeleteXmlTool: import_koishi2.Schema.boolean().default(false).description("\u542F\u7528 XML \u5F62\u5F0F\u7684\u6D88\u606F\u64A4\u56DE\u8C03\u7528"),
+  referencePrompt: import_koishi2.Schema.string().role("textarea").default(DEFAULT_XML_REFERENCE_PROMPT).description("\u53C2\u8003\u63D0\u793A\u8BCD")
+}).description("XML \u5DE5\u5177");
+
+// src/schema/variables.ts
+var import_koishi3 = require("koishi");
+
+// src/constants/defaults.ts
+var DEFAULT_MEMBER_INFO_ITEMS = [
+  "nickname",
+  "userId",
+  "role",
+  "level",
+  "title",
+  "gender",
+  "age",
+  "area",
+  "joinTime",
+  "lastSentTime"
+];
+var RAW_INTERCEPTOR_TAG = "__chatlunaToolboxRawInterceptor";
+
+// src/schema/variables.ts
+var VariablesSchema = import_koishi3.Schema.object({
+  userInfo: import_koishi3.Schema.object({
+    variableName: import_koishi3.Schema.string().default("userInfo").description("\u53D8\u91CF\u540D\u79F0"),
+    items: import_koishi3.Schema.array(
+      import_koishi3.Schema.union([
+        import_koishi3.Schema.const("userId").description("\u7528\u6237 ID"),
+        import_koishi3.Schema.const("nickname").description("\u7FA4\u6635\u79F0"),
+        import_koishi3.Schema.const("role").description("\u7FA4\u5185\u8EAB\u4EFD"),
+        import_koishi3.Schema.const("level").description("\u7FA4\u7B49\u7EA7"),
+        import_koishi3.Schema.const("title").description("\u7FA4\u5934\u8854"),
+        import_koishi3.Schema.const("gender").description("\u6027\u522B"),
+        import_koishi3.Schema.const("age").description("\u5E74\u9F84"),
+        import_koishi3.Schema.const("area").description("\u5730\u533A"),
+        import_koishi3.Schema.const("joinTime").description("\u5165\u7FA4\u65F6\u95F4"),
+        import_koishi3.Schema.const("lastSentTime").description("\u6700\u540E\u53D1\u8A00\u65F6\u95F4")
+      ])
+    ).role("checkbox").default([...DEFAULT_MEMBER_INFO_ITEMS]).description("\u663E\u793A\u7684\u8BE6\u7EC6\u4FE1\u606F\u9879")
+  }).description("\u7528\u6237\u4FE1\u606F\u53D8\u91CF").collapse(),
+  botInfo: import_koishi3.Schema.object({
+    variableName: import_koishi3.Schema.string().default("botInfo").description("\u53D8\u91CF\u540D\u79F0"),
+    items: import_koishi3.Schema.array(
+      import_koishi3.Schema.union([
+        import_koishi3.Schema.const("userId").description("\u673A\u5668\u4EBA ID"),
+        import_koishi3.Schema.const("nickname").description("\u7FA4\u6635\u79F0"),
+        import_koishi3.Schema.const("role").description("\u7FA4\u5185\u8EAB\u4EFD"),
+        import_koishi3.Schema.const("level").description("\u7FA4\u7B49\u7EA7"),
+        import_koishi3.Schema.const("title").description("\u7FA4\u5934\u8854"),
+        import_koishi3.Schema.const("gender").description("\u6027\u522B"),
+        import_koishi3.Schema.const("age").description("\u5E74\u9F84"),
+        import_koishi3.Schema.const("area").description("\u5730\u533A"),
+        import_koishi3.Schema.const("joinTime").description("\u5165\u7FA4\u65F6\u95F4"),
+        import_koishi3.Schema.const("lastSentTime").description("\u6700\u540E\u53D1\u8A00\u65F6\u95F4")
+      ])
+    ).role("checkbox").default([...DEFAULT_MEMBER_INFO_ITEMS]).description("\u663E\u793A\u7684\u673A\u5668\u4EBA\u8BE6\u7EC6\u4FE1\u606F\u9879")
+  }).description("\u673A\u5668\u4EBA\u4FE1\u606F\u53D8\u91CF").collapse(),
+  groupInfo: import_koishi3.Schema.object({
+    variableName: import_koishi3.Schema.string().default("groupInfo").description("\u53D8\u91CF\u540D\u79F0"),
+    includeMemberCount: import_koishi3.Schema.boolean().default(true).description("\u662F\u5426\u5305\u542B\u6210\u5458\u6570\u91CF"),
+    includeCreateTime: import_koishi3.Schema.boolean().default(true).description("\u662F\u5426\u5305\u542B\u521B\u5EFA\u65F6\u95F4"),
+    includeOwnersAndAdmins: import_koishi3.Schema.boolean().default(true).description("\u662F\u5426\u5C55\u793A\u7FA4\u4E3B\u4E0E\u7BA1\u7406\u5458\u540D\u5355")
+  }).description("\u7FA4\u4FE1\u606F\u53D8\u91CF").collapse(),
+  random: import_koishi3.Schema.object({
+    variableName: import_koishi3.Schema.string().default("random").description("\u53D8\u91CF\u540D\u79F0"),
+    min: import_koishi3.Schema.number().default(0).description("\u9ED8\u8BA4\u968F\u673A\u6570\u4E0B\u9650"),
+    max: import_koishi3.Schema.number().default(100).description("\u9ED8\u8BA4\u968F\u673A\u6570\u4E0A\u9650")
+  }).description("\u968F\u673A\u6570\u53D8\u91CF").collapse()
+}).default({
+  userInfo: { variableName: "userInfo", items: [...DEFAULT_MEMBER_INFO_ITEMS] },
+  botInfo: { variableName: "botInfo", items: [...DEFAULT_MEMBER_INFO_ITEMS] },
+  groupInfo: {
+    variableName: "groupInfo",
+    includeMemberCount: true,
+    includeCreateTime: true,
+    includeOwnersAndAdmins: true
+  },
+  random: { variableName: "random", min: 0, max: 100 }
+}).description("\u5176\u4ED6\u53D8\u91CF");
+
+// src/schema/index.ts
+var OtherSettingsSchema = import_koishi4.Schema.object({
+  debugLogging: import_koishi4.Schema.boolean().default(false).description("\u8F93\u51FA\u8C03\u8BD5\u65E5\u5FD7")
+}).description("\u5176\u4ED6\u8BBE\u7F6E");
+var name = "chatluna-toolbox";
+var inject = {
+  required: ["chatluna"],
+  optional: ["chatluna_character"]
+};
+var ConfigSchema = import_koishi4.Schema.intersect([
+  NativeToolsSchema,
+  XmlToolsSchema,
+  VariablesSchema,
+  OtherSettingsSchema
+]);
+
+// src/helpers/logger.ts
+function createLogger(ctx, config) {
+  const logger = ctx.logger("chatluna-toolbox");
+  return (level, message, meta) => {
+    if (level === "debug" && !config.debugLogging) return;
+    if (meta === void 0) {
+      logger[level](message);
+      return;
+    }
+    logger[level](message, meta);
+  };
+}
+
+// src/features/native-tools/tools/delete-msg.ts
+var import_zod = require("zod");
+
+// src/features/native-tools/onebot-api.ts
+function ensureOneBotSession(session) {
+  if (!session) return { error: "\u7F3A\u5C11\u4F1A\u8BDD\u4E0A\u4E0B\u6587\uFF0C\u65E0\u6CD5\u6267\u884C OneBot \u5DE5\u5177\u3002" };
+  if (session.platform !== "onebot")
+    return { error: "\u8BE5\u5DE5\u5177\u4EC5\u652F\u6301 OneBot \u5E73\u53F0\u3002" };
+  if (!session.bot) return { error: "\u5F53\u524D\u4F1A\u8BDD\u7F3A\u5C11 bot \u5B9E\u4F8B\uFF0C\u65E0\u6CD5\u6267\u884C\u5DE5\u5177\u3002" };
+  const internal = session.bot.internal;
+  if (!internal) return { error: "Bot \u9002\u914D\u5668\u672A\u66B4\u9732 OneBot internal \u63A5\u53E3\u3002" };
+  return { session, internal };
+}
+async function callOneBotAPI(internal, action, params, fallbacks = []) {
+  if (typeof internal._request === "function") {
+    return internal._request(action, params);
+  }
+  for (const key of fallbacks) {
+    if (typeof internal[key] === "function") {
+      return internal[key](params);
+    }
+  }
+  throw new Error(`\u5F53\u524D OneBot \u9002\u914D\u5668\u4E0D\u652F\u6301 ${action} \u63A5\u53E3\u3002`);
+}
+
+// src/features/native-tools/session.ts
+function getSession(runnable) {
+  return runnable?.configurable?.session || null;
+}
+
+// src/features/native-tools/tools/delete-msg.ts
+async function sendDeleteMessage(params) {
+  const { session, messageId, log } = params;
+  try {
+    if (!session) return "No session context available.";
+    const messageIdRaw = messageId.trim();
+    if (!messageIdRaw) return "messageId is required.";
+    const numericId = /^\d+$/.test(messageIdRaw) ? Number(messageIdRaw) : messageIdRaw;
+    if (session.platform === "onebot") {
+      const { error, internal } = ensureOneBotSession(session);
+      if (error) return error;
+      await callOneBotAPI(internal, "delete_msg", { message_id: numericId }, [
+        "deleteMsg"
+      ]);
+      const success = `Message deleted by ID ${messageIdRaw}.`;
+      log?.("info", success);
+      return success;
+    }
+    const bot = session.bot;
+    if (typeof bot?.deleteMessage === "function") {
+      const channelId = session.channelId || session?.guildId || session?.roomId || session?.channel?.id || "";
+      if (!channelId) return "Cannot determine channel to delete message.";
+      await bot.deleteMessage(channelId, messageIdRaw);
+      const success = `Message deleted by ID ${messageIdRaw}.`;
+      log?.("info", success);
+      return success;
+    }
+    return "Delete message is not supported on this platform.";
+  } catch (error) {
+    log?.("warn", "delete_msg failed", error);
+    return `delete_msg failed: ${error.message}`;
+  }
+}
+function createDeleteMessageTool(deps) {
+  const { toolName, log } = deps;
+  const tool = {
+    name: toolName || "delete_msg",
+    description: "Deletes (recalls) a message by messageId only.",
+    schema: import_zod.z.object({
+      messageId: import_zod.z.string().min(1, "messageId is required").describe("Specific message ID to delete.")
+    }),
+    async _call(input, _manager, runnable) {
+      try {
+        const session = getSession(runnable);
+        return await sendDeleteMessage({
+          session,
+          messageId: input.messageId,
+          log
+        });
+      } catch (error) {
+        log?.("warn", "delete_msg failed", error);
+        return `delete_msg failed: ${error.message}`;
+      }
+    }
+  };
+  return tool;
+}
+
+// src/features/native-tools/tools/poke.ts
+var import_zod2 = require("zod");
+var import_tools = require("@langchain/core/tools");
+async function sendPoke(params) {
+  try {
+    const { session, userId, groupId, log, protocol } = params;
+    const {
+      error,
+      internal,
+      session: validatedSession
+    } = ensureOneBotSession(session);
+    if (error) return error;
+    const resolvedGroupId = groupId?.trim() || validatedSession?.guildId || validatedSession?.channelId || validatedSession?.roomId;
+    const payload = { user_id: userId };
+    if (resolvedGroupId) payload.group_id = resolvedGroupId;
+    if (protocol === "llbot") {
+      const action = payload.group_id ? "group_poke" : "friend_poke";
+      if (typeof internal._request === "function") {
+        await internal._request(action, payload);
+      } else if (typeof internal[action] === "function") {
+        await internal[action](payload);
+      } else {
+        throw new Error(`\u5F53\u524D\u9002\u914D\u5668\u672A\u5B9E\u73B0 ${action} API\u3002`);
+      }
+    } else if (typeof internal._request === "function") {
+      await internal._request("send_poke", payload);
+    } else if (typeof internal.sendPoke === "function") {
+      await internal.sendPoke(
+        payload.group_id,
+        payload.user_id
+      );
+    } else if (typeof internal.pokeUser === "function") {
+      await internal.pokeUser(payload);
+    } else {
+      throw new Error("\u5F53\u524D\u9002\u914D\u5668\u672A\u5B9E\u73B0 send_poke API\u3002");
+    }
+    const location = payload.group_id ? `\u7FA4 ${payload.group_id}` : "\u79C1\u804A";
+    const message = `\u5DF2\u5728 ${location} \u6233\u4E86\u4E00\u4E0B ${payload.user_id}\u3002`;
+    log?.("info", message);
+    return message;
+  } catch (error) {
+    params.log?.("warn", "\u6233\u4E00\u6233\u5DE5\u5177\u6267\u884C\u5931\u8D25", error);
+    return `\u6233\u4E00\u6233\u5931\u8D25\uFF1A${error.message}`;
+  }
+}
+function createPokeTool(deps) {
+  const { toolName, log, protocol } = deps;
+  return new class extends import_tools.StructuredTool {
+    name = toolName || "poke_user";
+    description = "Poke (nudge) a specified user in a group or private conversation.";
+    schema = import_zod2.z.object({
+      userId: import_zod2.z.string().min(1, "userId is required").describe("The user ID to poke."),
+      groupId: import_zod2.z.string().optional().describe("Optional: specify a different group ID.")
+    });
+    async _call(input, _manager, runnable) {
+      const session = getSession(runnable);
+      return sendPoke({
+        session,
+        userId: input.userId,
+        groupId: input.groupId,
+        log,
+        protocol
+      });
+    }
+  }();
+}
+
+// src/features/native-tools/tools/set-group-card.ts
+var import_zod3 = require("zod");
+var import_tools2 = require("@langchain/core/tools");
+function createSetGroupCardTool(deps) {
+  const { toolName, log } = deps;
+  return new class extends import_tools2.StructuredTool {
+    name = toolName || "set_group_card";
+    description = "Update a group member nickname (group card).";
+    schema = import_zod3.z.object({
+      groupId: import_zod3.z.string().optional().describe("Target group ID. Defaults to current session group."),
+      userId: import_zod3.z.string().min(1, "userId is required").describe("Target member user ID."),
+      card: import_zod3.z.string().min(1, "card is required").describe("New group card for the member.")
+    });
+    async _call(input, _manager, runnable) {
+      try {
+        const session = getSession(runnable);
+        if (!session) return "No session context available.";
+        const groupId = input.groupId?.trim() || (session.guildId ? String(session.guildId).trim() : "") || (session.channelId ? String(session.channelId).trim() : "");
+        if (!groupId)
+          return "Missing groupId. Provide groupId explicitly or run inside a group session.";
+        const userId = input.userId.trim();
+        const card = input.card.trim();
+        if (!userId) return "userId is required.";
+        if (!card) return "card is required.";
+        const { error, internal } = ensureOneBotSession(session);
+        if (error) return error;
+        await callOneBotAPI(
+          internal,
+          "set_group_card",
+          { group_id: groupId, user_id: userId, card },
+          ["setGroupCard"]
+        );
+        const message = `\u7FA4\u6635\u79F0\u5DF2\u66F4\u65B0\uFF1A${userId} -> ${card}`;
+        log?.("info", message);
+        return message;
+      } catch (error) {
+        log?.("warn", "set_group_card failed", error);
+        return `set_group_card failed: ${error.message}`;
+      }
+    }
+  }();
+}
+
+// src/features/native-tools/tools/set-msg-emoji.ts
+var import_zod4 = require("zod");
+var import_tools3 = require("@langchain/core/tools");
+async function sendMsgEmoji(params) {
+  try {
+    const { session, messageId, emojiId, log, protocol } = params;
+    if (!session) return "No session context available.";
+    if (session.platform !== "onebot")
+      return "This tool only supports OneBot platform.";
+    if (protocol === "llbot" && !session.guildId && !session.channelId) {
+      return "\u5F53\u524D\u4F1A\u8BDD\u4E0D\u662F\u7FA4\u804A\uFF0CLLBot \u4E0D\u652F\u6301\u79C1\u804A\u8868\u60C5\u56DE\u5E94\u3002";
+    }
+    const messageIdRaw = messageId.trim();
+    const emojiIdRaw = emojiId.trim();
+    if (!messageIdRaw) return "message_id is required.";
+    if (!emojiIdRaw) return "emoji_id is required.";
+    const numericMessageId = /^\d+$/.test(messageIdRaw) ? Number(messageIdRaw) : messageIdRaw;
+    const { error, internal } = ensureOneBotSession(session);
+    if (error) return error;
+    await callOneBotAPI(
+      internal,
+      "set_msg_emoji_like",
+      { message_id: numericMessageId, emoji_id: emojiIdRaw },
+      ["setMsgEmojiLike"]
+    );
+    const success = `Emoji ${emojiIdRaw} sent to message ${messageIdRaw}.`;
+    log?.("info", success);
+    return success;
+  } catch (error) {
+    params.log?.("warn", "set_msg_emoji failed", error);
+    return `set_msg_emoji failed: ${error.message}`;
+  }
+}
+function createSetMsgEmojiTool(deps) {
+  const { toolName, log, protocol } = deps;
+  return new class extends import_tools3.StructuredTool {
+    name = toolName || "set_msg_emoji";
+    description = "React to a message with an emoji by messageId.";
+    schema = import_zod4.z.object({
+      messageId: import_zod4.z.string().min(1, "message_id is required").describe("Target message ID."),
+      emojiId: import_zod4.z.string().min(1, "emoji_id is required").describe("Emoji ID to send.")
+    });
+    async _call(input, _manager, runnable) {
+      const session = getSession(runnable);
+      return sendMsgEmoji({
+        session,
+        messageId: input.messageId,
+        emojiId: input.emojiId,
+        log,
+        protocol
+      });
+    }
+  }();
+}
+
+// src/features/native-tools/tools/profile.ts
+var import_zod5 = require("zod");
+var import_tools4 = require("@langchain/core/tools");
+var genders = {
+  unknown: "0",
+  male: "1",
+  female: "2"
+};
+function createSetProfileTool(deps) {
+  const { toolName, log, protocol } = deps;
+  return new class extends import_tools4.StructuredTool {
+    name = toolName || "set_self_profile";
+    description = "Update the bot's own QQ profile (nickname, signature, gender).";
+    schema = import_zod5.z.object({
+      nickname: import_zod5.z.string().min(1, "nickname is required").describe("The new nickname for the bot."),
+      signature: import_zod5.z.string().optional().describe("Optional: the new personal signature."),
+      gender: import_zod5.z.enum(["unknown", "male", "female"]).optional().describe("Optional: the new gender.")
+    });
+    async _call(input, _manager, runnable) {
+      try {
+        const session = getSession(runnable);
+        const { error, internal } = ensureOneBotSession(session);
+        if (error) return error;
+        const payload = { nickname: input.nickname };
+        if (input.signature) payload.personal_note = input.signature;
+        if (input.gender && protocol !== "llbot")
+          payload.sex = genders[input.gender];
+        await callOneBotAPI(internal, "set_qq_profile", payload, [
+          "setQQProfile"
+        ]);
+        const message = "\u673A\u5668\u4EBA\u8D44\u6599\u5DF2\u66F4\u65B0\u3002";
+        log?.("info", message);
+        return message;
+      } catch (error) {
+        log?.("warn", "\u4FEE\u6539\u673A\u5668\u4EBA\u8D26\u6237\u4FE1\u606F\u5931\u8D25", error);
+        return `\u4FEE\u6539\u673A\u5668\u4EBA\u8D26\u6237\u4FE1\u606F\u5931\u8D25\uFF1A${error.message}`;
+      }
+    }
+  }();
+}
+
+// src/features/native-tools/register.ts
+function resolveOneBotProtocol(config, log) {
+  if (config.enableNapCatProtocol && config.enableLlbotProtocol) {
+    log?.("warn", "NapCat \u4E0E LLBot \u534F\u8BAE\u540C\u65F6\u542F\u7528\uFF0C\u5C06\u4F18\u5148\u4F7F\u7528 LLBot\u3002");
+    return "llbot";
+  }
+  if (config.enableLlbotProtocol) return "llbot";
+  if (config.enableNapCatProtocol) return "napcat";
+  log?.("warn", "\u672A\u542F\u7528 OneBot \u534F\u8BAE\u9009\u9879\uFF0C\u9ED8\u8BA4\u4F7F\u7528 NapCat\u3002");
+  return "napcat";
+}
+function registerNativeTools(deps) {
+  const { ctx, config, plugin, protocol, log } = deps;
+  if (config.enablePokeTool) {
+    const toolName = String(config.pokeToolName || "poke_user").trim();
+    plugin.registerTool(toolName, {
+      selector: () => true,
+      authorization: (session) => session?.platform === "onebot",
+      createTool: () => createPokeTool({ ctx, toolName, log, protocol })
+    });
+    log?.("info", `\u6233\u4E00\u6233\u5DE5\u5177\u5DF2\u6CE8\u518C: ${toolName}`);
+  }
+  if (config.enableSetSelfProfileTool) {
+    const toolName = String(
+      config.setSelfProfileToolName || "set_self_profile"
+    ).trim();
+    plugin.registerTool(toolName, {
+      selector: () => true,
+      authorization: (session) => session?.platform === "onebot",
+      createTool: () => createSetProfileTool({ ctx, toolName, log, protocol })
+    });
+    log?.("info", `\u8BBE\u7F6E\u8D44\u6599\u5DE5\u5177\u5DF2\u6CE8\u518C: ${toolName}`);
+  }
+  if (config.enableSetGroupCardTool) {
+    const toolName = String(
+      config.setGroupCardToolName || "set_group_card"
+    ).trim();
+    plugin.registerTool(toolName, {
+      selector: () => true,
+      authorization: (session) => session?.platform === "onebot",
+      createTool: () => createSetGroupCardTool({ ctx, toolName, log })
+    });
+    log?.("info", `\u7FA4\u6635\u79F0\u5DE5\u5177\u5DF2\u6CE8\u518C: ${toolName}`);
+  }
+  if (config.enableSetMsgEmojiTool) {
+    const toolName = String(
+      config.setMsgEmojiToolName || "set_msg_emoji"
+    ).trim();
+    plugin.registerTool(toolName, {
+      selector: () => true,
+      authorization: (session) => session?.platform === "onebot",
+      createTool: () => createSetMsgEmojiTool({ toolName, log, protocol })
+    });
+    log?.("info", `\u6D88\u606F\u8868\u60C5\u5DE5\u5177\u5DF2\u6CE8\u518C: ${toolName}`);
+  }
+  if (config.enableDeleteMessageTool) {
+    const toolName = String(
+      config.deleteMessageToolName || "delete_msg"
+    ).trim();
+    plugin.registerTool(toolName, {
+      selector: () => true,
+      authorization: (session) => session?.platform === "onebot",
+      createTool: () => createDeleteMessageTool({ toolName, log })
+    });
+    log?.("info", `\u5220\u9664\u6D88\u606F\u5DE5\u5177\u5DF2\u6CE8\u518C: ${toolName}`);
+  }
+}
+
+// src/features/xml-tools/interceptor.ts
+function createXmlInterceptor(deps) {
+  const { ctx, config, log, onResponse } = deps;
+  const sessionMap = /* @__PURE__ */ new Map();
+  let currentGuildId = null;
+  let lastSession = null;
+  const pendingSessions = [];
+  let monitorHandle = null;
+  let fastRetryHandle = null;
+  let startupHandle = null;
+  let activeService = null;
+  let activeLogger = null;
+  let originalDebug = null;
+  let collectorBound = false;
+  const restore = () => {
+    if (activeLogger && originalDebug) {
+      activeLogger.debug = originalDebug;
+    }
+    activeLogger = null;
+    originalDebug = null;
+  };
+  const isActive = () => {
+    const characterService = ctx.chatluna_character;
+    const debugFn = characterService?.logger?.debug;
+    return Boolean(debugFn?.[RAW_INTERCEPTOR_TAG]);
+  };
+  const resolveSession = () => {
+    while (pendingSessions.length > 100) pendingSessions.shift();
+    const now = Date.now();
+    while (pendingSessions.length > 0 && now - pendingSessions[0].timestamp > 12e3) {
+      pendingSessions.shift();
+    }
+    if (pendingSessions.length === 0) {
+      return (currentGuildId ? sessionMap.get(currentGuildId) : null) || lastSession || null;
+    }
+    const contextKeys = /* @__PURE__ */ new Set();
+    for (let i = 0; i < pendingSessions.length; i++) {
+      contextKeys.add(pendingSessions[i].key || "__null__");
+    }
+    let resolved = pendingSessions[pendingSessions.length - 1];
+    if (currentGuildId) {
+      for (let i = pendingSessions.length - 1; i >= 0; i--) {
+        if (pendingSessions[i].key === currentGuildId) {
+          resolved = pendingSessions[i];
+          break;
+        }
+      }
+    }
+    pendingSessions.length = 0;
+    if (contextKeys.size > 1 && config.debugLogging) {
+      log?.("warn", "\u68C0\u6D4B\u5230\u591A\u4E2A\u4F1A\u8BDD\u4E0A\u4E0B\u6587\uFF0C\u5DF2\u4F7F\u7528\u6700\u8FD1\u4F1A\u8BDD\u7EE7\u7EED\u6267\u884C XML", {
+        contextCount: contextKeys.size,
+        preferredGuildId: currentGuildId,
+        resolvedGuildId: resolved.key
+      });
+    }
+    return resolved.key ? sessionMap.get(resolved.key) || resolved.session : resolved.session;
+  };
+  const attach = () => {
+    const characterService = ctx.chatluna_character;
+    if (!characterService) return false;
+    if (activeService !== characterService) {
+      activeService = characterService;
+      collectorBound = false;
+    }
+    if (!collectorBound && typeof characterService.collect === "function") {
+      characterService.collect(async (session) => {
+        const guildId = session?.guildId || session?.channelId || session?.userId || null;
+        currentGuildId = guildId;
+        if (guildId) sessionMap.set(guildId, session);
+        lastSession = session;
+        pendingSessions.push({ key: guildId, session, timestamp: Date.now() });
+      });
+      collectorBound = true;
+    }
+    const loggerService = characterService.logger;
+    if (!loggerService || typeof loggerService.debug !== "function")
+      return false;
+    const tagged = loggerService.debug;
+    if (!tagged[RAW_INTERCEPTOR_TAG]) {
+      restore();
+      const raw = loggerService.debug.bind(loggerService);
+      const wrapped = (...args) => {
+        raw(...args);
+        const message = args[0];
+        if (typeof message !== "string" || !message.startsWith("model response: "))
+          return;
+        const response = message.substring("model response: ".length);
+        if (!response) return;
+        const session = resolveSession();
+        if (!session && config.debugLogging) {
+          log?.("warn", "\u62E6\u622A\u5230\u539F\u59CB\u8F93\u51FA\u4F46\u7F3A\u5C11\u4F1A\u8BDD\u4E0A\u4E0B\u6587\uFF0CXML \u5DE5\u5177\u4E0D\u4F1A\u6267\u884C", {
+            length: response.length
+          });
+        }
+        onResponse(response, session);
+      };
+      wrapped[RAW_INTERCEPTOR_TAG] = true;
+      loggerService.debug = wrapped;
+      activeLogger = loggerService;
+      originalDebug = raw;
+    }
+    return true;
+  };
+  const stopFastRetry = () => {
+    if (!fastRetryHandle) return;
+    fastRetryHandle();
+    fastRetryHandle = null;
+  };
+  const startFastRetry = () => {
+    if (fastRetryHandle) return;
+    fastRetryHandle = ctx.setInterval(() => {
+      if (isActive()) {
+        stopFastRetry();
+        return;
+      }
+      const ready = attach();
+      if (ready) {
+        log?.("info", "\u539F\u59CB\u8F93\u51FA\u62E6\u622A\u5DF2\u6062\u590D");
+        stopFastRetry();
+      }
+    }, 3e3);
+  };
+  const ensureActive = () => {
+    if (isActive()) {
+      stopFastRetry();
+      return;
+    }
+    const ready = attach();
+    if (!ready) {
+      startFastRetry();
+    }
+  };
+  const startMonitor = () => {
+    if (monitorHandle) return;
+    monitorHandle = ctx.setInterval(() => {
+      ensureActive();
+    }, 5e3);
+  };
+  const stopMonitor = () => {
+    if (!monitorHandle) return;
+    monitorHandle();
+    monitorHandle = null;
+  };
+  return {
+    start: () => {
+      const delay = 3e3;
+      if (startupHandle) return;
+      startupHandle = ctx.setTimeout(() => {
+        startupHandle = null;
+        const ready = attach();
+        if (ready) {
+          log?.("info", "\u5DF2\u542F\u7528\u539F\u59CB\u8F93\u51FA\u62E6\u622A\u6A21\u5F0F");
+        } else {
+          log?.("warn", "chatluna_character \u670D\u52A1\u4E0D\u53EF\u7528\uFF0C\u5C06\u6BCF3\u79D2\u91CD\u8BD5\u4E00\u6B21");
+          startFastRetry();
+        }
+        startMonitor();
+      }, delay);
+    },
+    stop: () => {
+      if (startupHandle) {
+        startupHandle();
+        startupHandle = null;
+      }
+      stopFastRetry();
+      stopMonitor();
+      restore();
+      sessionMap.clear();
+      pendingSessions.length = 0;
+      currentGuildId = null;
+      lastSession = null;
+      activeService = null;
+    }
+  };
+}
+
+// src/features/xml-tools/parser.ts
+function unique(values) {
+  return Array.from(new Set(values.map((item) => item.trim()).filter(Boolean)));
+}
+function parseXmlActions(response) {
+  const pokeMatches = Array.from(response.matchAll(/<poke\s+id="([^"]+)"\s*\/>/gi));
+  const emojiMatches = Array.from(
+    response.matchAll(/<emoji\s+message_id="([^"]+)"\s+emoji_id="([^"]+)"\s*\/>/gi)
+  );
+  const deleteMatches = Array.from(response.matchAll(/<delete\s+message_id="([^"]+)"\s*\/?>/gi));
+  return {
+    pokeUserIds: unique(pokeMatches.map((match) => String(match[1] || ""))),
+    emojis: emojiMatches.map((match) => ({
+      messageId: String(match[1] || "").trim(),
+      emojiId: String(match[2] || "").trim()
+    })).filter((item) => item.messageId && item.emojiId),
+    deleteMessageIds: unique(deleteMatches.map((match) => String(match[1] || "")))
+  };
+}
+
+// src/features/xml-tools/register.ts
+function registerXmlTools(deps) {
+  const { ctx, config, protocol, log } = deps;
+  const interceptor = createXmlInterceptor({
+    ctx,
+    config,
+    log,
+    onResponse: (response, session) => {
+      const actions = parseXmlActions(response);
+      if (config.enablePokeXmlTool && actions.pokeUserIds.length > 0) {
+        if (!session) {
+          log?.("warn", "\u68C0\u6D4B\u5230\u6233\u4E00\u6233\u6807\u8BB0\u4F46\u7F3A\u5C11\u4F1A\u8BDD\u4E0A\u4E0B\u6587");
+        } else {
+          for (const userId of actions.pokeUserIds) {
+            void sendPoke({ session, userId, protocol, log }).catch((error) => {
+              log?.("warn", "XML \u89E6\u53D1 poke \u5931\u8D25", error);
+            });
+          }
+        }
+      }
+      if (config.enableEmojiXmlTool && actions.emojis.length > 0) {
+        if (!session) {
+          log?.("warn", "\u68C0\u6D4B\u5230\u8868\u60C5\u6807\u8BB0\u4F46\u7F3A\u5C11\u4F1A\u8BDD\u4E0A\u4E0B\u6587");
+        } else {
+          for (const item of actions.emojis) {
+            void sendMsgEmoji({
+              session,
+              messageId: item.messageId,
+              emojiId: item.emojiId,
+              protocol,
+              log
+            }).catch((error) => {
+              log?.("warn", "XML \u89E6\u53D1\u8868\u60C5\u5931\u8D25", error);
+            });
+          }
+        }
+      }
+      if (config.enableDeleteXmlTool && actions.deleteMessageIds.length > 0) {
+        if (!session) {
+          log?.("warn", "\u68C0\u6D4B\u5230\u64A4\u56DE\u6807\u8BB0\u4F46\u7F3A\u5C11\u4F1A\u8BDD\u4E0A\u4E0B\u6587");
+        } else {
+          for (const messageId of actions.deleteMessageIds) {
+            void sendDeleteMessage({ session, messageId, log }).catch(
+              (error) => {
+                log?.("warn", "XML \u89E6\u53D1\u64A4\u56DE\u5931\u8D25", error);
+              }
+            );
+          }
+        }
+      }
+    }
+  });
+  return {
+    start: () => interceptor.start(),
+    stop: () => interceptor.stop()
+  };
+}
+
+// src/features/variables/providers/bot-info.ts
+function pickFirst(...values) {
+  for (const value of values) {
+    if (value === null || value === void 0) continue;
+    const text = String(value).trim();
+    if (!text) continue;
+    return value;
+  }
+  return null;
+}
+function normalizeTimestamp(raw) {
+  if (raw === null || raw === void 0 || raw === "") return null;
+  const numeric = Number(raw);
+  if (!Number.isFinite(numeric)) return null;
+  return numeric < 1e11 ? numeric * 1e3 : numeric;
+}
+function formatDateOnly(value) {
+  if (!value) return "";
+  const date = new Date(value);
+  if (Number.isNaN(date.valueOf())) return "";
+  return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")}`;
+}
+function formatDateTime(value) {
+  if (!value) return "";
+  const date = new Date(value);
+  if (Number.isNaN(date.valueOf())) return "";
+  return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")} ${String(date.getHours()).padStart(2, "0")}:${String(date.getMinutes()).padStart(2, "0")}`;
+}
+function translateGender(value) {
+  if (value == null) return "";
+  const text = String(value).trim().toLowerCase();
+  if (!text) return "";
+  if (["male", "man", "m", "1", "boy"].includes(text)) return "\u7537";
+  if (["female", "woman", "f", "2", "girl"].includes(text)) return "\u5973";
+  if (["\u672A\u77E5", "unknown", "0", "secret"].includes(text)) return "";
+  return String(value);
+}
+function normalizeRole(value) {
+  if (value == null) return "\u7FA4\u5458";
+  const raw = String(value).trim();
+  const text = raw.toLowerCase();
+  if (!text) return "\u7FA4\u5458";
+  if (["owner", "group_owner", "\u7FA4\u4E3B"].includes(text)) return "\u7FA4\u4E3B";
+  if (["admin", "administrator", "group_admin", "\u7BA1\u7406\u5458"].includes(text))
+    return "\u7BA1\u7406\u5458";
+  if (["member", "normal", "\u7FA4\u5458"].includes(text)) return "\u7FA4\u5458";
+  return raw;
+}
+async function fetchMember(session, userId) {
+  try {
+    const guildId = session.guildId || session?.event?.guild?.id;
+    if (!guildId) return null;
+    const bot = session.bot;
+    if (!bot) return null;
+    if (session.platform === "onebot") {
+      const internal = bot?.internal;
+      if (internal) {
+        if (typeof internal.getGroupMemberInfo === "function") {
+          const result = await internal.getGroupMemberInfo(Number(guildId), Number(userId), false);
+          if (result) return result;
+        }
+        if (typeof internal._request === "function") {
+          const result = await internal._request("get_group_member_info", {
+            group_id: Number(guildId),
+            user_id: Number(userId),
+            no_cache: false
+          });
+          if (result) return result;
+        }
+      }
+    }
+    if (typeof bot.getGuildMember === "function") {
+      return await bot.getGuildMember(guildId, userId);
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function renderBotInfo(session, member, items) {
+  const botId = String(
+    session.selfId || session.bot?.selfId || ""
+  ).trim();
+  const values = [];
+  for (const item of items) {
+    switch (item) {
+      case "nickname": {
+        const name2 = String(
+          pickFirst(
+            member?.card,
+            member?.remark,
+            member?.displayName,
+            member?.nick,
+            member?.nickname,
+            member?.name,
+            botId
+          ) || ""
+        ).trim();
+        if (name2) values.push(`name:${name2}`);
+        break;
+      }
+      case "userId":
+        if (botId) values.push(`id:${botId}`);
+        break;
+      case "role": {
+        const role = normalizeRole(
+          pickFirst(
+            member?.role,
+            member?.roleName,
+            member?.permission,
+            member?.identity
+          )
+        );
+        values.push(`\u7FA4\u5185\u8EAB\u4EFD:${role}`);
+        break;
+      }
+      case "level": {
+        const level = pickFirst(
+          member?.level,
+          member?.levelName,
+          member?.level_name,
+          member?.level_info?.current_level
+        );
+        if (level !== null) values.push(`\u7FA4\u7B49\u7EA7:${level}`);
+        break;
+      }
+      case "title": {
+        const title = pickFirst(
+          member?.title,
+          member?.specialTitle,
+          member?.special_title
+        );
+        if (title !== null) values.push(`\u5934\u8854:${title}`);
+        break;
+      }
+      case "gender": {
+        const gender = translateGender(member?.sex ?? member?.gender);
+        if (gender) values.push(`\u6027\u522B:${gender}`);
+        break;
+      }
+      case "age": {
+        const age = Number(member?.age);
+        if (Number.isFinite(age) && age > 0) values.push(`\u5E74\u9F84:${age}`);
+        break;
+      }
+      case "area": {
+        const area = pickFirst(member?.area, member?.region, member?.location);
+        if (area !== null) values.push(`\u5730\u533A:${area}`);
+        break;
+      }
+      case "joinTime": {
+        const joinTime = formatDateOnly(
+          normalizeTimestamp(
+            pickFirst(
+              member?.join_time,
+              member?.joined_at,
+              member?.joinTime,
+              member?.joinedAt
+            )
+          )
+        );
+        if (joinTime) values.push(`\u5165\u7FA4:${joinTime}`);
+        break;
+      }
+      case "lastSentTime": {
+        const lastSentTime = formatDateTime(
+          normalizeTimestamp(
+            pickFirst(
+              member?.last_sent_time,
+              member?.lastSentTime,
+              member?.lastSpeakTimestamp
+            )
+          )
+        );
+        if (lastSentTime) values.push(`\u6D3B\u8DC3:${lastSentTime}`);
+        break;
+      }
+      default:
+        break;
+    }
+  }
+  if (values.length === 0) return botId || "\u672A\u77E5\u673A\u5668\u4EBA";
+  return values.join(", ");
+}
+function createBotInfoProvider(deps) {
+  const { config } = deps;
+  return async (_args, _variables, configurable) => {
+    const session = configurable?.session;
+    if (!session) return "\u672A\u77E5\u673A\u5668\u4EBA";
+    const items = Array.isArray(config.botInfo?.items) && config.botInfo.items.length ? config.botInfo.items : ["nickname", "userId"];
+    const botId = String(
+      session.selfId || session.bot?.selfId || ""
+    ).trim();
+    if (!botId) return "\u672A\u77E5\u673A\u5668\u4EBA";
+    const member = await fetchMember(session, botId);
+    return renderBotInfo(session, member, items);
+  };
+}
+
+// src/features/variables/providers/group-info.ts
+async function fetchGroupInfo(session) {
+  if (session.platform !== "onebot") return null;
+  const bot = session.bot;
+  const internal = bot?.internal;
+  if (!internal) return null;
+  const groupId = Number(session.guildId);
+  if (!groupId || !Number.isFinite(groupId)) return null;
+  try {
+    if (typeof internal.getGroupInfo === "function") {
+      return await internal.getGroupInfo(groupId, false);
+    }
+    if (typeof internal._request === "function") {
+      return await internal._request("get_group_info", {
+        group_id: groupId,
+        no_cache: false
+      });
+    }
+  } catch {
+    return null;
+  }
+  return null;
+}
+async function fetchOwnersAndAdmins(session, log) {
+  try {
+    if (session.platform !== "onebot") return null;
+    const guildId = session.guildId;
+    if (!guildId) return null;
+    const bot = session.bot;
+    const internal = bot?.internal;
+    let members = null;
+    if (internal) {
+      if (typeof internal.getGroupMemberList === "function") {
+        members = await internal.getGroupMemberList(guildId);
+      } else if (typeof internal._request === "function") {
+        members = await internal._request("get_group_member_list", {
+          group_id: Number(guildId)
+        });
+      }
+    }
+    if (!members && typeof bot.getGuildMemberList === "function") {
+      const list = await bot.getGuildMemberList(guildId);
+      members = list?.data || null;
+    }
+    if (!members || !Array.isArray(members) || members.length === 0) return null;
+    const owners = [];
+    const admins = [];
+    for (const member of members) {
+      const roleRaw = member.role || member.roleName || member.permission || member.identity || (Array.isArray(member.roles) ? member.roles[0] : "") || "";
+      const role = String(roleRaw || "").toLowerCase();
+      const userId = String(member.user_id || member.userId || member.id || member.qq || member.uid || "");
+      const candidates = [member.card, member.remark, member.displayName, member.nick, member.nickname, member.name].map(
+        (item) => item ? String(item).trim() : ""
+      );
+      const name2 = candidates.find((item) => item) || userId;
+      const label = userId ? `${name2}(${userId})` : name2;
+      if (role === "owner" || role === "master" || role === "leader") {
+        owners.push(label);
+      } else if (role === "admin" || role === "administrator" || role === "manager") {
+        admins.push(label);
+      }
+    }
+    return { owners, admins };
+  } catch (error) {
+    log?.("debug", "\u83B7\u53D6\u7FA4\u7BA1\u7406\u4FE1\u606F\u5931\u8D25", error);
+    return null;
+  }
+}
+function formatGroupInfo(group, options) {
+  const { includeMemberCount, includeCreateTime } = options;
+  const id = group.group_id ?? group.groupId ?? group.id ?? "\u672A\u77E5\u7FA4\u53F7";
+  const name2 = group.group_name ?? group.groupName ?? group.name ?? "\u672A\u547D\u540D\u7FA4";
+  const memberCount = group.member_count ?? group.memberCount ?? group.max_member_count;
+  let createTime = "";
+  if (includeCreateTime) {
+    const raw = group.create_time ?? group.createTime;
+    if (raw) {
+      const timestamp = Number(raw);
+      if (Number.isFinite(timestamp)) {
+        const date = new Date(timestamp < 1e11 ? timestamp * 1e3 : timestamp);
+        if (!Number.isNaN(date.valueOf())) {
+          createTime = `\uFF0C\u521B\u5EFA\u65F6\u95F4\uFF1A${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")}`;
+        }
+      }
+    }
+  }
+  const members = includeMemberCount ? `\uFF0C\u4EBA\u6570: ${memberCount ?? "\u672A\u77E5"}` : "";
+  return `\u7FA4\u53F7\uFF1A${id}\uFF0C\u7FA4\u540D\u79F0\uFF1A${name2}${members}${createTime}`;
+}
+function createGroupInfoProvider(deps) {
+  const { config, log } = deps;
+  return async (_args, _variables, configurable) => {
+    const session = configurable?.session;
+    if (!session) return "\u6682\u65E0\u7FA4\u4FE1\u606F\u3002";
+    if (!session.guildId) return "";
+    if (session.platform !== "onebot") return "\u5F53\u524D\u5E73\u53F0\u6682\u4E0D\u652F\u6301\u67E5\u8BE2\u7FA4\u4FE1\u606F\u3002";
+    const groupInfoCfg = config.groupInfo || {
+      includeMemberCount: true,
+      includeCreateTime: true,
+      includeOwnersAndAdmins: true
+    };
+    try {
+      const groupInfo = await fetchGroupInfo(session);
+      if (!groupInfo) return "\u672A\u80FD\u83B7\u53D6\u5F53\u524D\u7FA4\u4FE1\u606F\u3002";
+      const baseText = formatGroupInfo(groupInfo, {
+        includeMemberCount: groupInfoCfg.includeMemberCount !== false,
+        includeCreateTime: groupInfoCfg.includeCreateTime !== false
+      });
+      if (groupInfoCfg.includeOwnersAndAdmins) {
+        const roles = await fetchOwnersAndAdmins(session, log);
+        if (roles) {
+          const ownersText = roles.owners.length ? roles.owners.join("\u3001") : "\u65E0";
+          const adminsText = roles.admins.length ? roles.admins.join("\u3001") : "\u65E0";
+          return `${baseText}
+\u7FA4\u4E3B\uFF1A${ownersText}
+\u7BA1\u7406\u5458\uFF1A${adminsText}`;
+        }
+      }
+      return baseText;
+    } catch (error) {
+      log?.("debug", "\u7FA4\u4FE1\u606F\u53D8\u91CF\u89E3\u6790\u5931\u8D25", error);
+      return "\u83B7\u53D6\u7FA4\u4FE1\u606F\u5931\u8D25\u3002";
+    }
+  };
+}
+
+// src/features/variables/providers/random.ts
+function createRandomProvider(deps) {
+  const { config } = deps;
+  return () => {
+    const randomConfig = config.random || {
+      min: 0,
+      max: 100
+    };
+    const randomMin = randomConfig.min ?? 0;
+    const randomMax = randomConfig.max ?? 100;
+    return Math.floor(Math.random() * (randomMax - randomMin + 1)) + randomMin;
+  };
+}
+
+// src/features/variables/providers/user-info.ts
+function translateGender2(value) {
+  if (value == null) return "";
+  const text = String(value).trim().toLowerCase();
+  if (!text) return "";
+  if (["male", "man", "m", "1", "boy"].includes(text)) return "\u7537";
+  if (["female", "woman", "f", "2", "girl"].includes(text)) return "\u5973";
+  if (["\u672A\u77E5", "unknown", "0", "secret"].includes(text)) return "";
+  return String(value);
+}
+function normalizeTimestamp2(raw) {
+  if (raw === null || raw === void 0 || raw === "") return null;
+  const numeric = Number(raw);
+  if (!Number.isFinite(numeric)) return null;
+  return numeric < 1e11 ? numeric * 1e3 : numeric;
+}
+function formatDateOnly2(value) {
+  if (!value) return "";
+  const date = new Date(value);
+  if (Number.isNaN(date.valueOf())) return "";
+  return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")}`;
+}
+function formatDateTime2(value) {
+  if (!value) return "";
+  const date = new Date(value);
+  if (Number.isNaN(date.valueOf())) return "";
+  return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")} ${String(date.getHours()).padStart(2, "0")}:${String(date.getMinutes()).padStart(2, "0")}`;
+}
+function pickFirst2(...values) {
+  for (const value of values) {
+    if (value === null || value === void 0) continue;
+    const text = String(value).trim();
+    if (!text) continue;
+    return value;
+  }
+  return null;
+}
+function normalizeRole2(value) {
+  if (value == null) return "\u7FA4\u5458";
+  const raw = String(value).trim();
+  const text = raw.toLowerCase();
+  if (!text) return "\u7FA4\u5458";
+  if (["owner", "group_owner", "\u7FA4\u4E3B"].includes(text)) return "\u7FA4\u4E3B";
+  if (["admin", "administrator", "group_admin", "\u7BA1\u7406\u5458"].includes(text))
+    return "\u7BA1\u7406\u5458";
+  if (["member", "normal", "\u7FA4\u5458"].includes(text)) return "\u7FA4\u5458";
+  return raw;
+}
+async function fetchMember2(session, userId) {
+  try {
+    const guildId = session.guildId || session?.event?.guild?.id;
+    if (!guildId) return null;
+    const bot = session.bot;
+    if (!bot) return null;
+    if (session.platform === "onebot") {
+      const internal = bot?.internal;
+      if (internal) {
+        if (typeof internal.getGroupMemberInfo === "function") {
+          const result = await internal.getGroupMemberInfo(Number(guildId), Number(userId), false);
+          if (result) return result;
+        }
+        if (typeof internal._request === "function") {
+          const result = await internal._request("get_group_member_info", {
+            group_id: Number(guildId),
+            user_id: Number(userId),
+            no_cache: false
+          });
+          if (result) return result;
+        }
+      }
+    }
+    if (typeof bot.getGuildMember === "function") {
+      return await bot.getGuildMember(guildId, userId);
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function renderUserInfo(session, member, items) {
+  const userId = String(session.userId || "").trim();
+  const values = [];
+  for (const item of items) {
+    switch (item) {
+      case "nickname": {
+        const name2 = String(
+          pickFirst2(
+            member?.card,
+            member?.remark,
+            member?.displayName,
+            member?.nick,
+            member?.nickname,
+            member?.name,
+            session.username,
+            userId
+          ) || ""
+        ).trim();
+        if (name2) values.push(`name:${name2}`);
+        break;
+      }
+      case "userId":
+        if (userId) values.push(`id:${userId}`);
+        break;
+      case "role": {
+        const role = normalizeRole2(
+          pickFirst2(
+            member?.role,
+            member?.roleName,
+            member?.permission,
+            member?.identity
+          )
+        );
+        values.push(`\u7FA4\u5185\u8EAB\u4EFD:${role}`);
+        break;
+      }
+      case "level": {
+        const level = pickFirst2(
+          member?.level,
+          member?.levelName,
+          member?.level_name,
+          member?.level_info?.current_level
+        );
+        if (level !== null) values.push(`\u7FA4\u7B49\u7EA7:${level}`);
+        break;
+      }
+      case "title": {
+        const title = pickFirst2(
+          member?.title,
+          member?.specialTitle,
+          member?.special_title
+        );
+        if (title !== null) values.push(`\u5934\u8854:${title}`);
+        break;
+      }
+      case "gender": {
+        const gender = translateGender2(member?.sex ?? member?.gender);
+        if (gender) values.push(`\u6027\u522B:${gender}`);
+        break;
+      }
+      case "age": {
+        const age = Number(member?.age);
+        if (Number.isFinite(age) && age > 0) values.push(`\u5E74\u9F84:${age}`);
+        break;
+      }
+      case "area": {
+        const area = pickFirst2(member?.area, member?.region, member?.location);
+        if (area !== null) values.push(`\u5730\u533A:${area}`);
+        break;
+      }
+      case "joinTime": {
+        const joinTime = formatDateOnly2(
+          normalizeTimestamp2(
+            pickFirst2(
+              member?.join_time,
+              member?.joined_at,
+              member?.joinTime,
+              member?.joinedAt
+            )
+          )
+        );
+        if (joinTime) values.push(`\u5165\u7FA4:${joinTime}`);
+        break;
+      }
+      case "lastSentTime": {
+        const lastSentTime = formatDateTime2(
+          normalizeTimestamp2(
+            pickFirst2(
+              member?.last_sent_time,
+              member?.lastSentTime,
+              member?.lastSpeakTimestamp
+            )
+          )
+        );
+        if (lastSentTime) values.push(`\u6D3B\u8DC3:${lastSentTime}`);
+        break;
+      }
+      default:
+        break;
+    }
+  }
+  if (values.length === 0) return userId ? `id:${userId}` : "\u672A\u77E5\u7528\u6237";
+  return values.join(", ");
+}
+function createUserInfoProvider(deps) {
+  const { config } = deps;
+  return async (_args, _variables, configurable) => {
+    const session = configurable?.session;
+    if (!session?.userId) return "\u672A\u77E5\u7528\u6237";
+    const items = Array.isArray(config.userInfo?.items) && config.userInfo.items.length ? config.userInfo.items : ["nickname", "userId"];
+    const member = await fetchMember2(session, session.userId);
+    return renderUserInfo(session, member, items);
+  };
+}
+
+// src/features/variables/register.ts
+function registerVariables(deps) {
+  const { ctx, config, log } = deps;
+  const chatlunaService = ctx.chatluna;
+  const promptRenderer = chatlunaService?.promptRenderer;
+  if (!promptRenderer?.registerFunctionProvider) return;
+  const userInfoProvider = createUserInfoProvider({ config });
+  const userInfoName = String(
+    config.userInfo?.variableName || "userInfo"
+  ).trim();
+  if (userInfoName) {
+    promptRenderer.registerFunctionProvider(userInfoName, userInfoProvider);
+    log?.("info", `\u7528\u6237\u4FE1\u606F\u53D8\u91CF\u5DF2\u6CE8\u518C: ${userInfoName}`);
+  }
+  const botInfoProvider = createBotInfoProvider({ config });
+  const botInfoName = String(config.botInfo?.variableName || "botInfo").trim();
+  if (botInfoName) {
+    promptRenderer.registerFunctionProvider(botInfoName, botInfoProvider);
+    log?.("info", `Bot\u4FE1\u606F\u53D8\u91CF\u5DF2\u6CE8\u518C: ${botInfoName}`);
+  }
+  const groupInfoProvider = createGroupInfoProvider({ config, log });
+  const groupInfoName = String(
+    config.groupInfo?.variableName || "groupInfo"
+  ).trim();
+  if (groupInfoName) {
+    promptRenderer.registerFunctionProvider(groupInfoName, groupInfoProvider);
+    log?.("info", `\u7FA4\u7EC4\u4FE1\u606F\u53D8\u91CF\u5DF2\u6CE8\u518C: ${groupInfoName}`);
+  }
+  const randomProvider = createRandomProvider({ config });
+  const randomName = String(config.random?.variableName || "random").trim();
+  if (randomName) {
+    promptRenderer.registerFunctionProvider(randomName, randomProvider);
+    log?.("info", `\u968F\u673A\u6570\u53D8\u91CF\u5DF2\u6CE8\u518C: ${randomName}`);
+  }
+}
+
+// src/plugin.ts
+function apply(ctx, config) {
+  const chatlunaService = ctx.chatluna;
+  const plugin = {
+    registerTool: (name2, tool) => {
+      chatlunaService?.platform?.registerTool?.(name2, tool);
+    }
+  };
+  const log = createLogger(ctx, config);
+  let xmlRuntime = null;
+  const initializeServices = async () => {
+    log("info", "toolbox \u521D\u59CB\u5316\u5F00\u59CB");
+    registerVariables({ ctx, config, log });
+    const protocol = resolveOneBotProtocol(config, log);
+    registerNativeTools({ ctx, config, plugin, protocol, log });
+    if (config.enablePokeXmlTool || config.enableEmojiXmlTool || config.enableDeleteXmlTool) {
+      xmlRuntime = registerXmlTools({ ctx, config, protocol, log });
+      xmlRuntime.start();
+      log("info", "XML \u5DE5\u5177\u5DF2\u542F\u7528");
+    }
+    log("info", "toolbox \u521D\u59CB\u5316\u5B8C\u6210");
+  };
+  const dispose = () => {
+    xmlRuntime?.stop();
+    xmlRuntime = null;
+  };
+  ctx.on("dispose", dispose);
+  if (ctx.root.lifecycle.isActive) {
+    void initializeServices();
+  } else {
+    ctx.on("ready", () => {
+      void initializeServices();
+    });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Config,
+  ConfigSchema,
+  DEFAULT_MEMBER_INFO_ITEMS,
+  NativeToolsSchema,
+  RAW_INTERCEPTOR_TAG,
+  VariablesSchema,
+  XmlToolsSchema,
+  apply,
+  callOneBotAPI,
+  createBotInfoProvider,
+  createDeleteMessageTool,
+  createGroupInfoProvider,
+  createLogger,
+  createPokeTool,
+  createRandomProvider,
+  createSetGroupCardTool,
+  createSetMsgEmojiTool,
+  createSetProfileTool,
+  createUserInfoProvider,
+  createXmlInterceptor,
+  ensureOneBotSession,
+  getSession,
+  inject,
+  name,
+  parseXmlActions,
+  registerNativeTools,
+  registerVariables,
+  registerXmlTools,
+  resolveOneBotProtocol,
+  sendDeleteMessage,
+  sendMsgEmoji,
+  sendPoke
+});