@gakr-gakr/qqbot 0.1.0

package/src/engine/commands/builtin/register-approve.ts

@@ -0,0 +1,201 @@
+import type { ApproveRuntimeGetter } from "../../adapter/commands.port.js";
+import type { SlashCommandRegistry } from "../slash-commands.js";
+import { getApproveRuntimeGetter } from "./state.js";
+
+export function registerApproveCommands(registry: SlashCommandRegistry): void {
+  registry.register({
+    name: "bot-approve",
+    description: "管理命令执行审批配置",
+    requireAuth: true,
+    c2cOnly: true,
+    usage: [
+      `/bot-approve            查看操作指引`,
+      `/bot-approve on         开启审批（白名单模式，推荐）`,
+      `/bot-approve off        关闭审批，命令直接执行`,
+      `/bot-approve always     始终审批，每次执行都需审批`,
+      `/bot-approve reset      恢复框架默认值`,
+      `/bot-approve status     查看当前审批配置`,
+    ].join("\n"),
+    handler: async (ctx) => {
+      const arg = ctx.args.trim().toLowerCase();
+
+      let runtime: ReturnType<NonNullable<ApproveRuntimeGetter>>;
+      try {
+        const getter = getApproveRuntimeGetter();
+        if (!getter) {
+          throw new Error("runtime not available");
+        }
+        runtime = getter();
+      } catch {
+        return [
+          `🔐 命令执行审批配置`,
+          ``,
+          `❌ 当前环境不支持在线配置修改，请通过 CLI 手动配置：`,
+          ``,
+          `\`\`\`shell`,
+          `# 开启审批（白名单模式）`,
+          `autobot config set tools.exec.security allowlist`,
+          `autobot config set tools.exec.ask on-miss`,
+          ``,
+          `# 关闭审批`,
+          `autobot config set tools.exec.security full`,
+          `autobot config set tools.exec.ask off`,
+          `\`\`\``,
+        ].join("\n");
+      }
+
+      const configApi = runtime.config;
+
+      const loadExecConfig = () => {
+        const cfg = configApi.current();
+        const tools = ((cfg as Record<string, unknown>).tools ?? {}) as Record<string, unknown>;
+        const exec = (tools.exec ?? {}) as Record<string, unknown>;
+        const security = typeof exec.security === "string" ? exec.security : "deny";
+        const ask = typeof exec.ask === "string" ? exec.ask : "on-miss";
+        return { security, ask };
+      };
+
+      const writeExecConfig = async (security: string, ask: string) => {
+        const cfg = structuredClone(configApi.current() as Record<string, unknown>);
+        const tools = (cfg.tools ?? {}) as Record<string, unknown>;
+        const exec = (tools.exec ?? {}) as Record<string, unknown>;
+        exec.security = security;
+        exec.ask = ask;
+        tools.exec = exec;
+        cfg.tools = tools;
+        await configApi.replaceConfigFile({ nextConfig: cfg, afterWrite: { mode: "auto" } });
+      };
+
+      const formatStatus = (security: string, ask: string) => {
+        const secIcon = security === "full" ? "🟢" : security === "allowlist" ? "🟡" : "🔴";
+        const askIcon = ask === "off" ? "🟢" : ask === "always" ? "🔴" : "🟡";
+        return [
+          `🔐 当前审批配置`,
+          ``,
+          `${secIcon} 安全模式 (security): **${security}**`,
+          `${askIcon} 审批模式 (ask): **${ask}**`,
+          ``,
+          security === "deny"
+            ? `⚠️ 当前为 deny 模式，所有命令执行被拒绝`
+            : security === "full" && ask === "off"
+              ? `✅ 所有命令无需审批直接执行`
+              : security === "allowlist" && ask === "on-miss"
+                ? `🛡️ 白名单命令直接执行，其余需审批`
+                : ask === "always"
+                  ? `🔒 每次命令执行都需要人工审批`
+                  : `ℹ️ security=${security}, ask=${ask}`,
+        ].join("\n");
+      };
+
+      if (!arg) {
+        return [
+          `🔐 命令执行审批配置`,
+          ``,
+          `<qqbot-cmd-input text="/bot-approve on" show="/bot-approve on"/> 开启审批（白名单模式）`,
+          `<qqbot-cmd-input text="/bot-approve off" show="/bot-approve off"/> 关闭审批`,
+          `<qqbot-cmd-input text="/bot-approve always" show="/bot-approve always"/> 严格模式`,
+          `<qqbot-cmd-input text="/bot-approve reset" show="/bot-approve reset"/> 恢复默认`,
+          `<qqbot-cmd-input text="/bot-approve status" show="/bot-approve status"/> 查看当前配置`,
+        ].join("\n");
+      }
+
+      if (arg === "status") {
+        const { security, ask } = loadExecConfig();
+        return [
+          formatStatus(security, ask),
+          ``,
+          `<qqbot-cmd-input text="/bot-approve on" show="/bot-approve on"/> 开启审批`,
+          `<qqbot-cmd-input text="/bot-approve off" show="/bot-approve off"/> 关闭审批`,
+          `<qqbot-cmd-input text="/bot-approve always" show="/bot-approve always"/> 严格模式`,
+          `<qqbot-cmd-input text="/bot-approve reset" show="/bot-approve reset"/> 恢复默认`,
+        ].join("\n");
+      }
+
+      if (arg === "on") {
+        try {
+          await writeExecConfig("allowlist", "on-miss");
+          return [
+            `✅ 审批已开启`,
+            ``,
+            `• security = allowlist（白名单模式）`,
+            `• ask = on-miss（未命中白名单时需审批）`,
+            ``,
+            `已批准的命令自动加入白名单，下次直接执行。`,
+          ].join("\n");
+        } catch (err: unknown) {
+          return `❌ 配置更新失败: ${err instanceof Error ? err.message : String(err)}`;
+        }
+      }
+
+      if (arg === "off") {
+        try {
+          await writeExecConfig("full", "off");
+          return [
+            `✅ 审批已关闭`,
+            ``,
+            `• security = full（允许所有命令）`,
+            `• ask = off（不需要审批）`,
+            ``,
+            `⚠️ 所有命令将直接执行，不会弹出审批确认。`,
+          ].join("\n");
+        } catch (err: unknown) {
+          return `❌ 配置更新失败: ${err instanceof Error ? err.message : String(err)}`;
+        }
+      }
+
+      if (arg === "always" || arg === "strict") {
+        try {
+          await writeExecConfig("allowlist", "always");
+          return [
+            `✅ 已切换为严格审批模式`,
+            ``,
+            `• security = allowlist`,
+            `• ask = always（每次执行都需审批）`,
+            ``,
+            `每个命令都会弹出审批按钮，需手动确认。`,
+          ].join("\n");
+        } catch (err: unknown) {
+          return `❌ 配置更新失败: ${err instanceof Error ? err.message : String(err)}`;
+        }
+      }
+
+      if (arg === "reset") {
+        try {
+          const cfg = structuredClone(configApi.current() as Record<string, unknown>);
+          const tools = (cfg.tools ?? {}) as Record<string, unknown>;
+          const exec = (tools.exec ?? {}) as Record<string, unknown>;
+          delete exec.security;
+          delete exec.ask;
+          if (Object.keys(exec).length === 0) {
+            delete tools.exec;
+          } else {
+            tools.exec = exec;
+          }
+          if (Object.keys(tools).length === 0) {
+            delete cfg.tools;
+          } else {
+            cfg.tools = tools;
+          }
+          await configApi.replaceConfigFile({ nextConfig: cfg, afterWrite: { mode: "auto" } });
+          return [
+            `✅ 审批配置已重置`,
+            ``,
+            `已移除 tools.exec.security 和 tools.exec.ask`,
+            `框架将使用默认值（security=deny, ask=on-miss）`,
+            ``,
+            `如需开启命令执行，请使用 /bot-approve on`,
+          ].join("\n");
+        } catch (err: unknown) {
+          return `❌ 配置更新失败: ${err instanceof Error ? err.message : String(err)}`;
+        }
+      }
+
+      return [
+        `❌ 未知参数: ${arg}`,
+        ``,
+        `可用选项: on | off | always | reset | status`,
+        `输入 /bot-approve ? 查看详细用法`,
+      ].join("\n");
+    },
+  });
+}

package/src/engine/commands/builtin/register-basic.ts

@@ -0,0 +1,95 @@
+import type { SlashCommandRegistry } from "../slash-commands.js";
+import { getPluginVersionString, resolveRuntimeServiceVersion } from "./state.js";
+
+const QQBOT_PLUGIN_GITHUB_URL = "https://github.com/autobot/autobot/tree/main/extensions/qqbot";
+const QQBOT_UPGRADE_GUIDE_URL = "https://q.qq.com/qqbot/autobot/upgrade.html";
+
+export function registerBasicBotCommands(registry: SlashCommandRegistry): void {
+  registry.register({
+    name: "bot-help",
+    description: "查看所有内置命令",
+    usage: [
+      `/bot-help`,
+      ``,
+      `查看所有可用的 QQBot 内置命令及其简要说明。`,
+      `在命令后追加 ? 可查看详细用法。`,
+    ].join("\n"),
+    handler: (ctx) => {
+      const isGroup = ctx.type === "group";
+      const lines = [`### QQBot 内置命令`, ``];
+      for (const [name, cmd] of registry.getAllCommands()) {
+        if (isGroup && cmd.c2cOnly) {
+          continue;
+        }
+        lines.push(`<qqbot-cmd-input text="/${name}" show="/${name}"/> ${cmd.description}`);
+      }
+      lines.push(``, `> 插件版本 v${getPluginVersionString()}`);
+      return lines.join("\n");
+    },
+  });
+
+  registry.register({
+    name: "bot-me",
+    description: "查看当前发送者的账号ID",
+    c2cOnly: true,
+    usage: [`/bot-me`, ``, `显示当前发送者的账号ID`].join("\n"),
+    handler: (ctx) => {
+      return `你的账号ID：\`${ctx.senderId}\``;
+    },
+  });
+
+  registry.register({
+    name: "bot-ping",
+    description: "测试 AutoBot 与 QQ 之间的网络延迟",
+    usage: [
+      `/bot-ping`,
+      ``,
+      `测试当前 AutoBot 宿主机与 QQ 服务器之间的网络延迟。`,
+      `返回网络传输耗时和插件处理耗时。`,
+    ].join("\n"),
+    handler: (ctx) => {
+      const now = Date.now();
+      const eventTime = new Date(ctx.eventTimestamp).getTime();
+      if (Number.isNaN(eventTime)) {
+        return `✅ pong!`;
+      }
+      const totalMs = now - eventTime;
+      const qqToPlugin = ctx.receivedAt - eventTime;
+      const pluginProcess = now - ctx.receivedAt;
+      const lines = [
+        `✅ pong!`,
+        ``,
+        `⏱ 延迟：${totalMs}ms`,
+        `  ├ 网络传输：${qqToPlugin}ms`,
+        `  └ 插件处理：${pluginProcess}ms`,
+      ];
+      return lines.join("\n");
+    },
+  });
+
+  registry.register({
+    name: "bot-version",
+    description: "查看 QQBot 插件版本和 AutoBot 框架版本",
+    c2cOnly: true,
+    usage: [`/bot-version`, ``, `查看当前 QQBot 插件版本和 AutoBot 框架版本。`].join("\n"),
+    handler: async () => {
+      const frameworkVersion = resolveRuntimeServiceVersion();
+      const ver = getPluginVersionString();
+      const lines = [
+        `🦞 AutoBot 框架版本：${frameworkVersion}`,
+        `🤖 QQBot 插件版本：v${ver}`,
+        `🌟 官方 GitHub 仓库：[点击前往](${QQBOT_PLUGIN_GITHUB_URL})`,
+      ];
+      return lines.join("\n");
+    },
+  });
+
+  registry.register({
+    name: "bot-upgrade",
+    description: "查看 QQBot 升级指引",
+    c2cOnly: true,
+    usage: [`/bot-upgrade`, ``, `查看 QQBot 升级说明。`].join("\n"),
+    handler: () =>
+      [`📘 QQBot 升级指引：`, `[点击查看升级说明](${QQBOT_UPGRADE_GUIDE_URL})`].join("\n"),
+  });
+}

package/src/engine/commands/builtin/register-clear-storage.ts

@@ -0,0 +1,187 @@
+import fs from "node:fs";
+import path from "node:path";
+import { getQQBotMediaPath } from "../../utils/platform.js";
+import type { SlashCommandRegistry } from "../slash-commands.js";
+
+function scanDirectoryFiles(dirPath: string): { filePath: string; size: number }[] {
+  const files: { filePath: string; size: number }[] = [];
+  if (!fs.existsSync(dirPath)) {
+    return files;
+  }
+  const walk = (dir: string) => {
+    let entries: fs.Dirent[];
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      const fullPath = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        walk(fullPath);
+      } else if (entry.isFile()) {
+        try {
+          const stat = fs.statSync(fullPath);
+          files.push({ filePath: fullPath, size: stat.size });
+        } catch {
+          // Skip inaccessible files.
+        }
+      }
+    }
+  };
+  walk(dirPath);
+  files.sort((a, b) => b.size - a.size);
+  return files;
+}
+
+function formatBytes(bytes: number): string {
+  if (bytes < 1024) {
+    return `${bytes} B`;
+  }
+  if (bytes < 1024 * 1024) {
+    return `${(bytes / 1024).toFixed(1)} KB`;
+  }
+  if (bytes < 1024 * 1024 * 1024) {
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+  }
+  return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`;
+}
+
+function removeEmptyDirs(dirPath: string): void {
+  if (!fs.existsSync(dirPath)) {
+    return;
+  }
+  let entries: fs.Dirent[];
+  try {
+    entries = fs.readdirSync(dirPath, { withFileTypes: true });
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    if (entry.isDirectory()) {
+      removeEmptyDirs(path.join(dirPath, entry.name));
+    }
+  }
+  try {
+    const remaining = fs.readdirSync(dirPath);
+    if (remaining.length === 0) {
+      fs.rmdirSync(dirPath);
+    }
+  } catch {
+    // Directory may be in use, skip.
+  }
+}
+
+const CLEAR_STORAGE_MAX_DISPLAY = 10;
+
+/**
+ * Resolve the canonical QQBot downloads directory.
+ *
+ * All inbound attachments and outbound fallback downloads are stored directly
+ * under `~/.autobot/media/qqbot/downloads/` without appId subdivision.
+ * The clear-storage command therefore cleans the entire downloads root.
+ */
+function resolveQqbotDownloadsDir(): string {
+  return getQQBotMediaPath("downloads");
+}
+
+export function registerClearStorageCommands(registry: SlashCommandRegistry): void {
+  registry.register({
+    name: "bot-clear-storage",
+    description: "清理通过 QQBot 对话产生的下载文件，释放主机磁盘空间",
+    requireAuth: true,
+    c2cOnly: true,
+    usage: [
+      `/bot-clear-storage`,
+      ``,
+      `扫描 QQBot 下载目录下的所有文件并列出明细。`,
+      `确认后执行删除，释放主机磁盘空间。`,
+      ``,
+      `/bot-clear-storage --force   确认执行清理`,
+      ``,
+      `⚠️ 仅在私聊中可用。`,
+    ].join("\n"),
+    handler: (ctx) => {
+      const isForce = ctx.args.trim() === "--force";
+      const targetDir = resolveQqbotDownloadsDir();
+      const displayDir = `~/.autobot/media/qqbot/downloads`;
+
+      if (!isForce) {
+        const files = scanDirectoryFiles(targetDir);
+
+        if (files.length === 0) {
+          return [`✅ 当前没有需要清理的文件`, ``, `目录 \`${displayDir}\` 为空或不存在。`].join(
+            "\n",
+          );
+        }
+
+        const totalSize = files.reduce((sum, f) => sum + f.size, 0);
+        const lines: string[] = [
+          `即将清理 \`${displayDir}\` 目录下所有文件，总共 ${files.length} 个文件，占用磁盘存储空间 ${formatBytes(totalSize)}。`,
+          ``,
+          `目录文件概况：`,
+        ];
+
+        const displayFiles = files.slice(0, CLEAR_STORAGE_MAX_DISPLAY);
+        for (const f of displayFiles) {
+          const relativePath = path.relative(targetDir, f.filePath).replace(/\\/g, "/");
+          lines.push(`${relativePath} (${formatBytes(f.size)})`, ``, ``);
+        }
+        if (files.length > CLEAR_STORAGE_MAX_DISPLAY) {
+          lines.push(`...[合计：${files.length} 个文件（${formatBytes(totalSize)}）]`, ``);
+        }
+
+        lines.push(
+          ``,
+          `---`,
+          ``,
+          `确认清理后，上述保存在 AutoBot 运行主机磁盘上的文件将永久删除，后续对话过程中 AI 无法再找回相关文件。`,
+          `‼️ 点击指令确认删除`,
+          `<qqbot-cmd-enter text="/bot-clear-storage --force" />`,
+        );
+
+        return lines.join("\n");
+      }
+
+      const files = scanDirectoryFiles(targetDir);
+
+      if (files.length === 0) {
+        return `✅ 目录已为空，无需清理`;
+      }
+
+      let deletedCount = 0;
+      let deletedSize = 0;
+      let failedCount = 0;
+
+      for (const f of files) {
+        try {
+          fs.unlinkSync(f.filePath);
+          deletedCount++;
+          deletedSize += f.size;
+        } catch {
+          failedCount++;
+        }
+      }
+
+      try {
+        removeEmptyDirs(targetDir);
+      } catch {
+        // Non-critical, silently ignore.
+      }
+
+      if (failedCount === 0) {
+        return [
+          `✅ 清理成功`,
+          ``,
+          `已删除 ${deletedCount} 个文件，释放 ${formatBytes(deletedSize)} 磁盘空间。`,
+        ].join("\n");
+      }
+
+      return [
+        `⚠️ 部分清理完成`,
+        ``,
+        `已删除 ${deletedCount} 个文件（${formatBytes(deletedSize)}），${failedCount} 个文件删除失败。`,
+      ].join("\n");
+    },
+  });
+}

package/src/engine/commands/builtin/register-logs.ts

@@ -0,0 +1,20 @@
+import type { SlashCommandRegistry } from "../slash-commands.js";
+import { buildBotLogsResult } from "./log-helpers.js";
+
+export function registerLogCommands(registry: SlashCommandRegistry): void {
+  registry.register({
+    name: "bot-logs",
+    description: "导出本地日志文件",
+    requireAuth: true,
+    c2cOnly: true,
+    usage: [
+      `/bot-logs`,
+      ``,
+      `导出最近的 AutoBot 日志文件（最多 4 个文件）。`,
+      `每个文件只保留最后 1000 行，并作为附件返回。`,
+    ].join("\n"),
+    handler: () => {
+      return buildBotLogsResult();
+    },
+  });
+}

package/src/engine/commands/builtin/register-streaming.ts

@@ -0,0 +1,138 @@
+import type { ApproveRuntimeGetter } from "../../adapter/commands.port.js";
+import type { SlashCommandRegistry } from "../slash-commands.js";
+import {
+  getApproveRuntimeGetter,
+  getPluginVersionString,
+  resolveRuntimeServiceVersion,
+} from "./state.js";
+
+function isStreamingConfigEnabled(streaming: unknown): boolean {
+  if (streaming === true) {
+    return true;
+  }
+  if (streaming === false || streaming === undefined || streaming === null) {
+    return false;
+  }
+  if (typeof streaming === "object") {
+    const o = streaming as Record<string, unknown>;
+    if (o.c2cStreamApi === true) {
+      return true;
+    }
+    if (o.mode === "off") {
+      return false;
+    }
+    return true;
+  }
+  return false;
+}
+
+export function registerStreamingCommands(registry: SlashCommandRegistry): void {
+  registry.register({
+    name: "bot-streaming",
+    description: "一键开关流式消息",
+    requireAuth: true,
+    c2cOnly: true,
+    usage: [
+      `/bot-streaming on     开启流式消息`,
+      `/bot-streaming off    关闭流式消息`,
+      `/bot-streaming        查看当前流式消息状态`,
+      ``,
+      `开启后，AI 的回复会以流式形式逐步显示（打字机效果）。`,
+      `注意：仅 C2C（私聊）支持流式消息。`,
+    ].join("\n"),
+    handler: async (ctx) => {
+      const arg = ctx.args.trim().toLowerCase();
+      const currentOn = isStreamingConfigEnabled(ctx.accountConfig?.streaming);
+
+      if (!arg) {
+        return [
+          `📡 流式消息状态：${currentOn ? "✅ 已开启" : "❌ 已关闭"}`,
+          ``,
+          `使用 <qqbot-cmd-input text="/bot-streaming on" show="/bot-streaming on"/> 开启`,
+          `使用 <qqbot-cmd-input text="/bot-streaming off" show="/bot-streaming off"/> 关闭`,
+        ].join("\n");
+      }
+
+      if (arg !== "on" && arg !== "off") {
+        return `❌ 参数错误，请使用 on 或 off\n\n示例：/bot-streaming on`;
+      }
+
+      const wantOn = arg === "on";
+      if (wantOn === currentOn) {
+        return `📡 流式消息已经是${wantOn ? "开启" : "关闭"}状态，无需操作`;
+      }
+
+      let runtime: ReturnType<NonNullable<ApproveRuntimeGetter>>;
+      try {
+        const getter = getApproveRuntimeGetter();
+        if (!getter) {
+          throw new Error("runtime not available");
+        }
+        runtime = getter();
+      } catch {
+        const fwVer = resolveRuntimeServiceVersion();
+        const ver = getPluginVersionString();
+        return [
+          `❌ 当前版本不支持该指令`,
+          ``,
+          `🦞框架版本：${fwVer}`,
+          `🤖QQBot 插件版本：v${ver}`,
+          ``,
+          `可通过以下命令手动开启流式消息：`,
+          ``,
+          `\`\`\`shell`,
+          `# 1. 开启流式消息`,
+          `autobot config set channels.qqbot.streaming true`,
+          ``,
+          `# 2. 重启网关使配置生效`,
+          `autobot gateway restart`,
+          `\`\`\``,
+        ].join("\n");
+      }
+
+      try {
+        const configApi = runtime.config;
+        const currentCfg = structuredClone(configApi.current() as Record<string, unknown>);
+        const qqbot = ((currentCfg.channels ?? {}) as Record<string, unknown>).qqbot as
+          | Record<string, unknown>
+          | undefined;
+
+        if (!qqbot) {
+          return `❌ 配置文件中未找到 qqbot 通道配置`;
+        }
+
+        const accountId = ctx.accountId;
+        const newVal: unknown = wantOn;
+
+        if (accountId !== "default") {
+          const prevAccounts =
+            (qqbot.accounts as Record<string, Record<string, unknown>> | undefined) ?? {};
+          const nextAccounts = { ...prevAccounts };
+          const acct = { ...nextAccounts[accountId] };
+          acct.streaming = newVal;
+          nextAccounts[accountId] = acct;
+          qqbot.accounts = nextAccounts;
+        } else {
+          qqbot.streaming = newVal;
+          const accs = qqbot.accounts as Record<string, Record<string, unknown>> | undefined;
+          if (accs?.default && typeof accs.default === "object") {
+            const nextAccs = { ...accs };
+            const def = { ...accs.default, streaming: newVal };
+            nextAccs.default = def;
+            qqbot.accounts = nextAccs;
+          }
+        }
+
+        await configApi.replaceConfigFile({ nextConfig: currentCfg, afterWrite: { mode: "auto" } });
+
+        return [
+          `✅ 流式消息已${wantOn ? "开启" : "关闭"}`,
+          ``,
+          wantOn ? `AI 的回复将以流式形式逐步显示（仅私聊生效）。` : `AI 的回复将恢复为完整发送。`,
+        ].join("\n");
+      } catch (err: unknown) {
+        return `❌ 配置写入失败: ${err instanceof Error ? err.message : String(err)}`;
+      }
+    },
+  });
+}

package/src/engine/commands/builtin/state.ts

@@ -0,0 +1,31 @@
+import type { ApproveRuntimeGetter, CommandsPort } from "../../adapter/commands.port.js";
+
+let resolveVersionGetter: () => string = () => "unknown";
+let approveRuntimeGetter: ApproveRuntimeGetter | null = null;
+let PLUGIN_VERSION = "unknown";
+
+/**
+ * Initialize command dependencies from the EngineAdapters.commands port.
+ * Called once by the bridge layer during startup.
+ */
+export function initSlashCommandDeps(port: CommandsPort): void {
+  resolveVersionGetter = port.resolveVersion;
+  PLUGIN_VERSION = port.pluginVersion;
+  approveRuntimeGetter = port.approveRuntimeGetter ?? null;
+}
+
+export function resolveRuntimeServiceVersion(): string {
+  return resolveVersionGetter();
+}
+
+export function getPluginVersionString(): string {
+  return PLUGIN_VERSION;
+}
+
+export function getFrameworkVersionString(): string {
+  return resolveVersionGetter();
+}
+
+export function getApproveRuntimeGetter(): ApproveRuntimeGetter | null {
+  return approveRuntimeGetter;
+}