openclaw-plugin-yuanbao 2.12.0 → 2.13.0

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-declare const _default: import("openclaw/plugin-sdk/channel-entry-contract").BundledChannelEntryContract<import("openclaw/plugin-sdk/channel-core").ChannelPlugin>;
+declare const _default: import("openclaw/plugin-sdk/channel-entry-contract").BundledChannelEntryContract<import("openclaw/plugin-sdk").ChannelPlugin>;
 export default _default;

package/dist/index.js

@@ -1,4 +1,5 @@
 import { defineBundledChannelEntry, loadBundledEntryExportSync, } from "openclaw/plugin-sdk/channel-entry-contract";
+import { YUANBAO_PLUGIN_ID } from "./src/channel-shared.js";
 function registerTools(api) {
     const register = loadBundledEntryExportSync(import.meta.url, {
         specifier: "./api.js",
@@ -36,7 +37,7 @@ function initLogger(api) {
     init(api);
 }
 export default defineBundledChannelEntry({
-    id: "openclaw-plugin-yuanbao",
+    id: YUANBAO_PLUGIN_ID,
     name: "YuanBao",
     description: "YuanBao channel plugin",
     importMetaUrl: import.meta.url,

package/dist/setup-entry.d.ts

@@ -1,2 +1,2 @@
-declare const _default: import("openclaw/plugin-sdk/channel-entry-contract").BundledChannelSetupEntryContract<import("openclaw/plugin-sdk/channel-core").ChannelPlugin>;
+declare const _default: import("openclaw/plugin-sdk/channel-entry-contract").BundledChannelSetupEntryContract<import("openclaw/plugin-sdk").ChannelPlugin>;
 export default _default;

package/dist/src/business/commands/log-upload/extractor.js

@@ -1,5 +1,5 @@
 import { readFile, readdir, stat } from "node:fs/promises";
-import { runPluginCommandWithTimeout } from "openclaw/plugin-sdk/matrix";
+import { runPluginCommandWithTimeout } from "openclaw/plugin-sdk/run-command";
 import { createLog } from "../../../logger.js";
 import { getYuanbaoRuntime } from "../../../runtime.js";
 const EXEC_TIMEOUT_MS = 10_000;

package/dist/src/business/commands/upgrade/env.js

@@ -1,5 +1,5 @@
 import { dirname } from "node:path";
-import { runPluginCommandWithTimeout } from "openclaw/plugin-sdk/matrix";
+import { runPluginCommandWithTimeout } from "openclaw/plugin-sdk/run-command";
 export function makeEnv() {
     const nodeBinDir = dirname(process.execPath);
     const currentPath = process.env.PATH ?? "";

package/dist/src/business/commands/upgrade/upgrade.js

@@ -1,5 +1,5 @@
 import { createLog } from "../../../logger.js";
-import { getLatestStableVersion, isPublishedVersionOnNpm, isValidVersion, PLUGIN_ID, readInstalledVersion, runOpenClawCommand, runOpenClawCommandWithRetry, snapshotYuanbaoChannelConfig, } from "./utils.js";
+import { checkTargetVersionHostCompatibility, getLatestStableVersion, isPublishedVersionOnNpm, isValidVersion, PLUGIN_ID, readInstalledVersion, runOpenClawCommand, runOpenClawCommandWithRetry, snapshotYuanbaoChannelConfig, } from "./utils.js";
 const log = createLog("upgrade");
 const INSTALL_SCRIPT_TIMEOUT_MS = 5 * 60 * 1000;
 var MessageEnum;
@@ -153,6 +153,12 @@ async function runRegularUpgradeFlow(params) {
     if (!latestStableVersion) {
         log.warn("未获取到 npm 最新正式版本，将直接执行 update");
     }
+    if (latestStableVersion) {
+        const hostCheckError = await checkTargetVersionHostCompatibility(latestStableVersion);
+        if (hostCheckError) {
+            return { ok: false, message: hostCheckError };
+        }
+    }
     await onProgress?.(currentVersion && latestStableVersion
         ? `🔄 正在将**元宝 Bot 插件**从 **v${currentVersion}** 升级至 **v${latestStableVersion}** ，请稍等片刻。`
         : "⏳ 正在将**元宝 Bot 插件**升级至最新版本，请稍等片刻。");
@@ -207,6 +213,10 @@ export async function performUpgrade(config, accountId, onProgress, targetVersio
             log.error("指定版本在 npm 不存在，升级流程中止", { targetVersion });
             return `❌ 指定版本 \`${targetVersion}\` 不存在或暂不可用，请确认版本号后重试。`;
         }
+        const hostCheckError = await checkTargetVersionHostCompatibility(requestedVersion);
+        if (hostCheckError) {
+            return hostCheckError;
+        }
     }
     const currentVersion = await readInstalledVersion(PLUGIN_ID);
     log.info("读取当前版本", {

package/dist/src/business/commands/upgrade/utils.d.ts

@@ -1,10 +1,11 @@
 import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
-export declare const PLUGIN_ID = "openclaw-plugin-yuanbao";
+export declare const PLUGIN_ID: "openclaw-plugin-yuanbao";
 export declare function isValidVersion(version: string): boolean;
 export declare function getLatestStableVersion(): Promise<string | null>;
 export declare function isPublishedVersionOnNpm(version: string): Promise<boolean>;
 export declare function readInstalledVersion(pluginId: string): Promise<string | null>;
 export declare function snapshotYuanbaoChannelConfig(config: OpenClawConfig): string | null;
+export declare function checkTargetVersionHostCompatibility(targetVersion: string): Promise<string | null>;
 export declare function runOpenClawCommand(args: string[], timeoutMs?: number): Promise<{
     ok: boolean;
     stdout?: string;

package/dist/src/business/commands/upgrade/utils.js

@@ -1,8 +1,11 @@
-import { runPluginCommandWithTimeout } from "openclaw/plugin-sdk/matrix";
+import semver from "semver";
+import { runPluginCommandWithTimeout } from "openclaw/plugin-sdk/run-command";
+import { YUANBAO_PLUGIN_ID } from "../../../channel-shared.js";
+import { getOpenclawVersion } from "../../../infra/env.js";
 import { createLog } from "../../../logger.js";
 import { makeEnv, nodeExecPath, resolveNpmBin, resolveOpenClawBin } from "./env.js";
 const log = createLog("upgrade");
-export const PLUGIN_ID = "openclaw-plugin-yuanbao";
+export const PLUGIN_ID = YUANBAO_PLUGIN_ID;
 const EXEC_TIMEOUT_MS = 3 * 60 * 1000;
 const PLUGIN_CMD_RETRY_MAX_ATTEMPTS = 5;
 const PLUGIN_CMD_RETRY_DELAY_MS = 3000;
@@ -18,7 +21,7 @@ export function isValidVersion(version) {
     return /^\d+\.\d+\.\d+(-[\w.]+)?$/.test(version);
 }
 function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
+    return new Promise(resolve => setTimeout(resolve, ms));
 }
 export async function getLatestStableVersion() {
     const npmBin = await resolveNpmBin();
@@ -145,6 +148,52 @@ function firstLine(e) {
     }
     return String(e).split("\n")[0];
 }
+export async function checkTargetVersionHostCompatibility(targetVersion) {
+    const hostVersion = getOpenclawVersion();
+    if (!hostVersion) {
+        return null;
+    }
+    const npmBin = await resolveNpmBin();
+    try {
+        const result = await runPluginCommandWithTimeout({
+            argv: [
+                npmBin,
+                "view",
+                `${PLUGIN_ID}@${targetVersion}`,
+                "openclaw.install.minHostVersion",
+            ],
+            timeoutMs: 15_000,
+            env: makeEnv(),
+        });
+        if (result.code !== 0) {
+            log.warn("Failed to query target version minHostVersion from npm", {
+                targetVersion,
+                stderr: result.stderr.trim(),
+            });
+            return null;
+        }
+        const constraint = result.stdout.trim();
+        if (!constraint) {
+            return null;
+        }
+        if (!semver.satisfies(hostVersion, constraint)) {
+            log.warn("Target version requires newer OpenClaw host", {
+                targetVersion,
+                constraint,
+                hostVersion,
+            });
+            return (`❌ 目标版本 v${targetVersion} 要求 OpenClaw ${constraint}，`
+                + `但当前版本为 ${hostVersion}。请先升级 OpenClaw 后再更新插件。`);
+        }
+    }
+    catch (e) {
+        log.warn("Failed to check target version host compatibility", {
+            targetVersion,
+            error: firstLine(e),
+        });
+    }
+    return null;
+}
 export async function runOpenClawCommand(args, timeoutMs = EXEC_TIMEOUT_MS) {
     const openclawBin = await resolveOpenClawBin();
     const argv = [openclawBin, ...args];

package/dist/src/channel-shared.d.ts

@@ -3,9 +3,10 @@ import { yuanbaoConfigSchema } from "./config-schema.js";
 import { yuanbaoSetupAdapter } from "./setup-core.js";
 import { yuanbaoSetupWizard } from "./setup-surface.js";
 import type { ResolvedYuanbaoAccount } from "./types.js";
-export declare const YUANBAO_CHANNEL_ID: "openclaw-plugin-yuanbao";
+export declare const YUANBAO_PLUGIN_ID: "openclaw-plugin-yuanbao";
+export declare const YUANBAO_CHANNEL_ID: "yuanbao";
 export declare const yuanbaoMeta: {
-    readonly id: "openclaw-plugin-yuanbao";
+    readonly id: "yuanbao";
     readonly label: "Yuanbao";
     readonly selectionLabel: "Yuanbao (腾讯元宝)";
     readonly detailLabel: "Yuanbao";

package/dist/src/channel-shared.js

@@ -3,7 +3,8 @@ import { listYuanbaoAccountIds, resolveDefaultYuanbaoAccountId, resolveYuanbaoAc
 import { yuanbaoConfigSchema } from "./config-schema.js";
 import { yuanbaoSetupAdapter } from "./setup-core.js";
 import { yuanbaoSetupWizard } from "./setup-surface.js";
-export const YUANBAO_CHANNEL_ID = "openclaw-plugin-yuanbao";
+export const YUANBAO_PLUGIN_ID = "openclaw-plugin-yuanbao";
+export const YUANBAO_CHANNEL_ID = "yuanbao";
 export const yuanbaoMeta = {
     id: YUANBAO_CHANNEL_ID,
     label: "Yuanbao",

package/dist/src/infra/env.js

@@ -1,16 +1,38 @@
 import { createRequire } from "module";
 import os from "os";
+import semver from "semver";
 let _pluginVersion = "";
 let _openclawVersion = "";
 export const getPluginVersion = () => _pluginVersion;
 export const getOpenclawVersion = () => _openclawVersion;
 export const getOperationSystem = () => os.type();
+const getMinHostVersion = () => {
+    try {
+        const _require = createRequire(import.meta.url);
+        const pkg = _require("../../../package.json");
+        return pkg?.openclaw?.install?.minHostVersion;
+    }
+    catch {
+        return undefined;
+    }
+};
+const assertHostVersionCompatible = (hostVersion) => {
+    const constraint = getMinHostVersion();
+    if (!constraint)
+        return;
+    if (!semver.satisfies(hostVersion, constraint)) {
+        throw new Error(`openclaw-plugin-yuanbao requires openclaw ${constraint}, but current version is ${hostVersion}. Please upgrade openclaw first.`);
+    }
+};
 export const initEnv = (api) => {
     _pluginVersion = api?.version || "";
     _openclawVersion = api?.config?.meta?.lastTouchedVersion || "";
     if (!_pluginVersion || !_openclawVersion) {
         legacyInitEnv();
     }
+    if (_openclawVersion) {
+        assertHostVersionCompatible(_openclawVersion);
+    }
 };
 const legacyInitEnv = () => {
     try {

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "openclaw-plugin-yuanbao",
   "name": "YuanBao",
   "description": "YuanBao channel plugin",
-  "version": "2.12.0",
+  "version": "2.13.0",
   "channels": [
     "yuanbao"
   ],

package/package.json

@@ -1,17 +1,12 @@
 {
   "name": "openclaw-plugin-yuanbao",
-  "version": "2.12.0",
+  "version": "2.13.0",
   "type": "module",
   "description": "Tencent YuanBao intelligent bot channel plugin",
   "license": "MIT",
-  "main": "./index.ts",
+  "main": "./dist/index.js",
   "files": [
     "dist",
-    "src",
-    "index.ts",
-    "api.ts",
-    "runtime-api.ts",
-    "setup-entry.ts",
     "openclaw.plugin.json",
     "README.md"
   ],
@@ -25,11 +20,11 @@
   "author": "Tencent YuanBao Team",
   "openclaw": {
     "extensions": [
-      "./index.ts"
+      "./dist/index.js"
     ],
-    "setupEntry": "./setup-entry.ts",
+    "setupEntry": "./dist/setup-entry.js",
     "channel": {
-      "id": "openclaw-plugin-yuanbao",
+      "id": "yuanbao",
       "label": "Yuanbao",
       "selectionLabel": "Yuanbao (元宝)",
       "detailLabel": "Yuanbao",
@@ -52,7 +47,7 @@
       "npmSpec": "openclaw-plugin-yuanbao",
       "localPath": "extensions/yuanbao",
       "defaultChoice": "npm",
-      "minHostVersion": ">=2026.4.14"
+      "minHostVersion": ">=2026.4.5"
     }
   },
   "private": false,
@@ -67,6 +62,7 @@
     "@semantic-release/npm": "^13.1.5",
     "@semantic-release/release-notes-generator": "^14.1.0",
     "@types/node": "^20.19.37",
+    "@types/semver": "^7.7.1",
     "@types/ws": "^8.18.1",
     "semantic-release": "^25.0.3",
     "typescript": "^5.0.0"
@@ -74,6 +70,7 @@
   "dependencies": {
     "cos-nodejs-sdk-v5": "^2.15.4",
     "protobufjs": "^8.0.0",
+    "semver": "^7.7.4",
     "uuid": "^13.0.0",
     "ws": "^8.19.0"
   },
@@ -83,7 +80,7 @@
     "yauzl": ">=3.2.1"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.4.14"
+    "openclaw": ">=2026.4.5"
   },
   "scripts": {
     "build": "tsc",

package/api.ts

@@ -1,16 +0,0 @@
-/**
- * Aggregated export file
- * 供 index.ts 通过 loadBundledEntryExportSync 懒加载引用
- */
-
-export { yuanbaoPlugin } from "./src/channel.js";
-export { yuanbaoSetupPlugin } from "./src/channel.setup.js";
-export { initLogger } from "./src/logger.js";
-export { initEnv } from "./src/infra/env.js";
-export { registerTools } from "./src/business/tools/index.js";
-export {
-  yuanbaoUpgradeCommand,
-  yuanbaobotUpgradeCommand,
-} from "./src/business/commands/upgrade/index.js";
-export { logUploadCommandDefinition } from "./src/business/commands/log-upload/index.js";
-export { initBuiltinStickers } from "./src/business/actions/sticker/init-builtin-stickers.js";

package/index.ts

@@ -1,83 +0,0 @@
-import {
-  defineBundledChannelEntry,
-  loadBundledEntryExportSync,
-} from "openclaw/plugin-sdk/channel-entry-contract";
-import type { OpenClawPluginApi } from "openclaw/plugin-sdk/channel-entry-contract";
-
-/** 懒加载注册工具 */
-function registerTools(api: OpenClawPluginApi) {
-  const register = loadBundledEntryExportSync<(api: OpenClawPluginApi) => void>(import.meta.url, {
-    specifier: "./api.js",
-    exportName: "registerTools",
-  });
-  register(api);
-}
-
-/** Lazy-load and register all slash commands */
-function registerCommands(api: OpenClawPluginApi) {
-  const yuanbaoUpgradeCommand = loadBundledEntryExportSync<Parameters<OpenClawPluginApi["registerCommand"]>[0]>(
-    import.meta.url,
-    { specifier: "./api.js", exportName: "yuanbaoUpgradeCommand" },
-  );
-  const yuanbaobotUpgradeCommand = loadBundledEntryExportSync<Parameters<OpenClawPluginApi["registerCommand"]>[0]>(
-    import.meta.url,
-    { specifier: "./api.js", exportName: "yuanbaobotUpgradeCommand" },
-  );
-  const logUploadCommandDefinition = loadBundledEntryExportSync<Parameters<OpenClawPluginApi["registerCommand"]>[0]>(
-    import.meta.url,
-    { specifier: "./api.js", exportName: "logUploadCommandDefinition" },
-  );
-
-  api.registerCommand(yuanbaoUpgradeCommand);
-  api.registerCommand(yuanbaobotUpgradeCommand);
-  api.registerCommand(logUploadCommandDefinition);
-}
-
-/** 懒加载初始化内置表情缓存 */
-function initBuiltinStickers() {
-  const init = loadBundledEntryExportSync<() => void>(import.meta.url, {
-    specifier: "./api.js",
-    exportName: "initBuiltinStickers",
-  });
-  init();
-}
-
-/** 懒加载初始化环境变量 */
-function initEnv(api: OpenClawPluginApi) {
-  const init = loadBundledEntryExportSync<(api: OpenClawPluginApi) => void>(import.meta.url, {
-    specifier: "./api.js",
-    exportName: "initEnv",
-  });
-  init(api);
-}
-
-/** 懒加载初始化日志 */
-function initLogger(api: OpenClawPluginApi) {
-  const init = loadBundledEntryExportSync<(api: OpenClawPluginApi) => void>(import.meta.url, {
-    specifier: "./api.js",
-    exportName: "initLogger",
-  });
-  init(api);
-}
-
-export default defineBundledChannelEntry({
-  id: "openclaw-plugin-yuanbao",
-  name: "YuanBao",
-  description: "YuanBao channel plugin",
-  importMetaUrl: import.meta.url,
-  plugin: {
-    specifier: "./api.js",
-    exportName: "yuanbaoPlugin",
-  },
-  runtime: {
-    specifier: "./runtime-api.js",
-    exportName: "setYuanbaoRuntime",
-  },
-  registerFull(api) {
-    initEnv(api);
-    initLogger(api);
-    registerTools(api);
-    registerCommands(api);
-    initBuiltinStickers();
-  },
-});

package/runtime-api.ts

@@ -1,9 +0,0 @@
-export type { ChannelPlugin, OpenClawPluginApi, PluginRuntime } from "openclaw/plugin-sdk/core";
-export type { OpenClawConfig } from "openclaw/plugin-sdk/config-runtime";
-export type {
-  OpenClawPluginService,
-  OpenClawPluginServiceContext,
-  PluginLogger,
-} from "openclaw/plugin-sdk/core";
-export type { ResolvedYuanbaoAccount } from "./src/types.js";
-export { getYuanbaoRuntime, setYuanbaoRuntime } from "./src/runtime.js";

package/setup-entry.ts

@@ -1,9 +0,0 @@
-import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract";
-
-export default defineBundledChannelSetupEntry({
-  importMetaUrl: import.meta.url,
-  plugin: {
-    specifier: "./api.js",
-    exportName: "yuanbaoSetupPlugin",
-  },
-});

package/src/access/api.ts

@@ -1,22 +0,0 @@
-/**
- * Yuanbao API client.
- *
- * Backward-compatible re-export entry point.
- * Implementation split into:
- *   - http/request.ts  — Types, token cache, signing, auth headers, HTTP utilities
- *   - http/main.ts     — Business APIs (uploadInfo / downloadUrl)
- */
-
-export type { SignTokenData, AuthHeaders, CosUploadConfig, Log } from "./http/request.js";
-export {
-  clearSignTokenCache,
-  clearAllSignTokenCache,
-  getTokenStatus,
-  verifySignature,
-  getSignToken,
-  forceRefreshSignToken,
-  getAuthHeaders,
-  yuanbaoPost,
-  yuanbaoGet,
-} from "./http/request.js";
-export { apiGetUploadInfo, apiGetDownloadUrl } from "./http/main.js";

package/src/access/http/bot-id-cache.ts

@@ -1,30 +0,0 @@
-/**
- * Lightweight botId cache shared between the HTTP sign-token client and
- * account resolution.
- *
- * Kept in its own module (rather than inlined in `request.ts`) so that
- * `accounts.ts` — which is on the `openclaw setup` / `openclaw configure`
- * code path — can look up a previously-resolved botId without statically
- * pulling in the full HTTP/crypto/env runtime stack.
- */
-
-const botIdCache = new Map<string, string>();
-
-/** Read the last-known botId for an account, if any. */
-export function getCachedBotId(accountId: string): string | undefined {
-  const value = botIdCache.get(accountId);
-  return value && value.length > 0 ? value : undefined;
-}
-
-/** Record a botId obtained during sign-token exchange. */
-export function setCachedBotId(accountId: string, botId: string | undefined): void {
-  if (!accountId || !botId) {
-    return;
-  }
-  botIdCache.set(accountId, botId);
-}
-
-/** Clear the cached botId (e.g. when tearing down an account). */
-export function clearCachedBotId(accountId: string): void {
-  botIdCache.delete(accountId);
-}

package/src/access/http/main.ts

@@ -1,59 +0,0 @@
-/**
- * Yuanbao business API.
- *
- * Upload pre-sign config retrieval, resource download URL retrieval, etc.
- * Auth and HTTP utilities are in request.ts.
- */
-
-import type { ResolvedYuanbaoAccount } from "../../types.js";
-import type { Log, CosUploadConfig } from "./request.js";
-import { yuanbaoPost, yuanbaoGet } from "./request.js";
-
-const UPLOAD_INFO_PATH = "/api/resource/genUploadInfo";
-const DOWNLOAD_INFO_PATH = "/api/resource/v1/download";
-
-/**
- * Get COS upload pre-sign config.
- */
-export async function apiGetUploadInfo(
-  account: ResolvedYuanbaoAccount,
-  fileName: string,
-  fileId: string,
-  log?: Log,
-): Promise<CosUploadConfig> {
-  const data = await yuanbaoPost<CosUploadConfig>(
-    account,
-    UPLOAD_INFO_PATH,
-    { fileName, fileId, docFrom: "localDoc", docOpenId: "" },
-    log,
-  );
-
-  if (!data.bucketName || !data.location) {
-    throw new Error(`[yuanbao-api] genUploadInfo incomplete config: ${JSON.stringify(data)}`);
-  }
-
-  return data;
-}
-
-/**
- * Get COS download URL for a given resourceId.
- */
-export async function apiGetDownloadUrl(
-  account: ResolvedYuanbaoAccount,
-  resourceId: string,
-  log?: Log,
-): Promise<string> {
-  const data = await yuanbaoGet<{ url?: string; realUrl?: string }>(
-    account,
-    DOWNLOAD_INFO_PATH,
-    { resourceId },
-    log,
-  );
-
-  const downloadUrl = data.url ?? data.realUrl;
-  if (!downloadUrl) {
-    throw new Error(`[yuanbao-api] resource/v1/download returned no valid URL: ${JSON.stringify(data)}`);
-  }
-
-  return downloadUrl;
-}