huaweicloud-devkit 1.1.4-next.1 → 1.1.4-next.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "huaweicloud-devkit",
   "mcpName": "io.github.huaweicloud/huaweicloud-devkit",
-  "version": "1.1.4-next.1",
+  "version": "1.1.4-next.3",
   "kooCliVersion": "7.2.12",
   "description": "Agent toolkit that helps coding agents use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities safely and accurately.",
   "type": "module",

package/plugins/huaweicloud-core/.claude-plugin/plugin.json

@@ -17,7 +17,7 @@
   "mcpServers": "./.mcp.json",
   "description": "Guide coding agents to use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities with safer execution and less context.",
   "skills": "./skills/",
-  "version": "1.1.4-next.1",
+  "version": "1.1.4-next.3",
   "author": {
     "name": "HuaweiCloud Mate",
     "url": "https://github.com/huaweicloud"

package/plugins/huaweicloud-core/.codex-plugin/plugin.json

@@ -20,7 +20,7 @@
   "mcpServers": "./.mcp.json",
   "description": "Agent toolkit that helps coding agents use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities safely and accurately.",
   "skills": "./skills/",
-  "version": "1.1.4-next.1",
+  "version": "1.1.4-next.3",
   "author": {
     "name": "HuaweiCloud Mate",
     "url": "https://github.com/huaweicloud"

package/plugins/huaweicloud-core/.cursor-plugin/plugin.json

@@ -17,7 +17,7 @@
   "mcpServers": "./.mcp.json",
   "description": "Guide coding agents to use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities with safer execution and less context.",
   "skills": "./skills/",
-  "version": "1.1.4-next.1",
+  "version": "1.1.4-next.3",
   "author": {
     "name": "HuaweiCloud Mate",
     "url": "https://github.com/huaweicloud"

package/plugins/huaweicloud-core/.hermes-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "huaweicloud-devkit",
-  "version": "1.1.4-next.1",
+  "version": "1.1.4-next.3",
   "description": "Guide coding agents to use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities with safer execution and less context.",
   "author": {
     "name": "HuaweiCloud Mate",

package/plugins/huaweicloud-core/.workbuddy-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "huaweicloud-devkit",
-  "version": "1.1.4-next.1",
+  "version": "1.1.4-next.3",
   "description": "Guide coding agents to use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities with safer execution and less context.",
   "author": {
     "name": "HuaweiCloud Mate",

package/plugins/huaweicloud-core/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "name": "huaweicloud-devkit",
   "id": "huaweicloud-devkit",
   "displayName": "HuaweiCloud DevKit",
-  "version": "1.1.4-next.1",
+  "version": "1.1.4-next.3",
   "family": "bundle-plugin",
   "bundleFormat": "codex",
   "description": "Guide coding agents to use Huawei Cloud safely — KooCLI, APIs, SDKs, 28 MCP tools, skills, and safety guardrails.",

package/plugins/huaweicloud-core/skills/huawei-billing/SKILL.md

@@ -16,14 +16,14 @@ Domain expertise for billing queries (BSS). Covers cost tracking, bill details,
 
 ## Critical Warnings
 
-| Trap                                      | Why                                                                                                                                                                                                                                                                                                                     |
-| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Bills delayed ~24h                        | Yesterday's costs may not appear until the next day                                                                                                                                                                                                                                                                     |
-| BSS Admin role needed                     | IAM user must have BSS Administrator or Finance role                                                                                                                                                                                                                                                                    |
-| Currency conversion varies                | Cross-region costs use daily exchange rates                                                                                                                                                                                                                                                                             |
-| Region fixed to cn-north-1                | BSS operations only support `--cli-region=cn-north-1` in KooCLI. This is a KooCLI metadata limitation — the billing data itself covers all regions.                                                                                                                                                                     |
-| English catalog missing BSS               | `Unsupported service: BSS` under the default `en` language is a KooCLI catalog gap, not a missing service. devkit auto-injects `--cli-lang=cn`; manual fallback: add `--cli-lang=cn` or `hcloud configure set --cli-lang=cn` — prefer `--cli-lang=cn` on the command itself so the global output language is untouched. |
-| `缺少必填参数 cli-domain-id` / APIGW.0301 | Invalid credentials — KooCLI can't resolve the account-id                                                                                                                                                                                                                                                               | Re-run `npx huaweicloud-devkit auth init` |
+| Trap                                      | Why                                                                                                                                                                                                                                                                                                                                                           |
+| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Bills delayed ~24h                        | Yesterday's costs may not appear until the next day                                                                                                                                                                                                                                                                                                           |
+| BSS Admin role needed                     | IAM user must have BSS Administrator or Finance role                                                                                                                                                                                                                                                                                                          |
+| Currency conversion varies                | Cross-region costs use daily exchange rates                                                                                                                                                                                                                                                                                                                   |
+| Region fixed to cn-north-1                | BSS operations only support `--cli-region=cn-north-1` in KooCLI. This is a KooCLI metadata limitation — the billing data itself covers all regions.                                                                                                                                                                                                           |
+| English catalog missing BSS               | `Unsupported service: BSS` under the default `en` language is a KooCLI catalog gap, not a missing service. devkit detects it and advises the supported fix `hcloud configure set --cli-lang=cn` (switch is global-only; KooCLI has no per-command `--cli-lang` flag). Running with Chinese mode from the start (see Prerequisites) avoids the issue entirely. |
+| `缺少必填参数 cli-domain-id` / APIGW.0301 | Invalid credentials — KooCLI can't resolve the account-id                                                                                                                                                                                                                                                                                                     | Re-run `npx huaweicloud-devkit auth init` |
 
 ## Common Workflows
 

package/plugins/huaweicloud-core/skills/huaweicloud-cli-and-auth/SKILL.md

@@ -109,8 +109,8 @@ If a command needs an `adminPass` or other password field, do not leave plaintex
 ## Language / Service Catalog Trap
 
 - KooCLI loads the service list from a per-language catalog: `~/.hcloud/metaRepo/services_{cn,en}.json`. The **English catalog is incomplete** (149 services vs 220 in Chinese; ~70 services — BSS, DevStar, CloudTable, FRS, ASM, ... — are missing). A command against a service that only exists in the Chinese catalog fails with a misleading `Unsupported service: X`.
-- `huaweicloud-devkit` auto-injects `--cli-lang=cn` (proactive when the catalog shows `X ∈ cn ∧ X ∉ en`, reactive once if `Unsupported service` still appears) for read and write commands; approved write commands keep their approved argument list (injection happens inside the runner).
-- Manual fallback (do not rely on the auto path alone): append `--cli-lang=cn` to the failing command, or set globally with `hcloud configure set --cli-lang=cn` (this changes ALL CLI output language).
+- KooCLI has **no per-command `--cli-lang` flag** — appending `--cli-lang=cn` is rejected as `不正确的参数:cli-lang`. The language switch is **global only**: `hcloud configure set --cli-lang=cn` (changes ALL CLI output language).
+- `huaweicloud-devkit` detects `Unsupported service: X` and, when the cause is the en-catalog gap, returns an actionable hint to run `hcloud configure set --cli-lang=cn` (or to check the service name / refresh metadata for genuinely unknown services). It never mutates your command.
 - Distinguish from **region** metadata limits (e.g., BSS only supports `cn-north-1`): a region error is NOT solved by switching language.
 
 ## Output Formatting

package/plugins/huaweicloud-core/src/hcloud-cli.mjs

@@ -196,24 +196,6 @@ function obsWriteHint(args) {
   return 'OBS write operations are obsutil-style and always write-class. Before executing, present the full resource manifest (bucket/object list) to the user for ONE batch approval, then run each command through plan → approve (see huawei-iac skill, Provisioning Rules).';
 }
 
-const OBS_SUBCOMMANDS = new Set([
-  'help',
-  'ls',
-  'mb',
-  'cp',
-  'mv',
-  'rm',
-  'chattri',
-  'config',
-  'cors',
-  'lifecycle',
-  'policy',
-  'share',
-  'sync',
-  'url',
-  'sign',
-]);
-
 const CATALOG_TTL_MS = 5 * 60 * 1000;
 let _catalogCache = { dir: null, t: 0, cn: new Set(), en: new Set() };
 
@@ -252,19 +234,9 @@ export function classifyUnsupported(service, metaDir) {
   }
   // One or both catalog files are missing locally — we cannot distinguish
   // "service missing from the en catalog" from "en catalog not downloaded".
-  // Only the reactive fallback may attempt --cli-lang=cn for this case.
   return 'unknown';
 }
 
-export function shouldInjectLang(args, metaDir) {
-  const arr = Array.isArray(args) ? args.map(String) : [];
-  if (arr.some((a) => /^--cli-lang=/.test(a))) return false;
-  const s = (arr[0] || '').toUpperCase();
-  if (!s) return false;
-  if (s === 'OBS' && OBS_SUBCOMMANDS.has((arr[1] || '').toLowerCase())) return false;
-  return classifyUnsupported(s, metaDir) === 'lang-missing';
-}
-
 export function planHcloudCommand(args, options = {}) {
   const normalizedArgs = Array.isArray(args) ? args.map(String) : [];
   const classification = classifyHcloudArgs(normalizedArgs, options);
@@ -301,7 +273,8 @@ const UNSUPPORTED_SERVICE_RE = /Unsupported service:\s*([A-Za-z0-9_-]+)/i;
 function appendLangHint(result, service, metaDir) {
   const cause = classifyUnsupported(service, metaDir);
   if (cause === 'lang-missing' || cause === 'unknown') {
-    const nextStep = 'Re-run with --cli-lang=cn, or set hcloud configure set --cli-lang=cn.';
+    const nextStep =
+      'KooCLI switches language only via global config: hcloud configure set --cli-lang=cn (changes CLI output language; BSS requires Chinese mode).';
     return {
       ...result,
       langCause: cause,
@@ -318,16 +291,6 @@ function appendLangHint(result, service, metaDir) {
   };
 }
 
-function isObsUtilStyle(args) {
-  const s = String(args[0] || '').toUpperCase();
-  return s === 'OBS' && OBS_SUBCOMMANDS.has(String(args[1] || '').toLowerCase());
-}
-
-function canRetryLang(service, metaDir) {
-  const cause = classifyUnsupported(service, metaDir);
-  return cause === 'lang-missing' || cause === 'unknown';
-}
-
 export async function runHcloud(args, options = {}) {
   const normalizedArgs = Array.isArray(args) ? args.map(String) : [];
   const plan = {
@@ -337,44 +300,13 @@ export async function runHcloud(args, options = {}) {
   assertAllowed(plan.classification);
 
   const metaDir = options.metaDir;
-  const langGiven = normalizedArgs.some((a) => /^--cli-lang=/.test(a));
-  const injectedArgs =
-    !langGiven && shouldInjectLang(normalizedArgs, metaDir) ? [...normalizedArgs, '--cli-lang=cn'] : null;
-
-  if (injectedArgs) {
-    const result = await runHcloudOnceWithRetries(
-      {
-        ...plan,
-        rawArgs: injectedArgs,
-      },
-      options,
-    );
-    const tagged = {
-      ...result,
-      autoRetried: true,
-      injection: 'proactive',
-      injectedLang: 'cn',
-    };
-    if (tagged.ok) return tagged;
-    const match = `${result.stderr || ''}\n${result.stdout || ''}`.match(UNSUPPORTED_SERVICE_RE);
-    return match ? appendLangHint(tagged, match[1], metaDir) : tagged;
-  }
 
+  // KooCLI only switches language globally (`hcloud configure set --cli-lang=cn`); there is no
+  // per-command `--cli-lang` flag (it is rejected as "不正确的参数:cli-lang"). So we never mutate
+  // the command — we run it as-is and annotate `Unsupported service` with an actionable cause.
   const result = await runHcloudOnceWithRetries(plan, options);
   const text = `${result.stderr || ''}\n${result.stdout || ''}`;
   const match = text.match(UNSUPPORTED_SERVICE_RE);
-  if (match && !langGiven && !result.ok && canRetryLang(match[1], metaDir) && !isObsUtilStyle(normalizedArgs)) {
-    const retry = await runHcloudOnceWithRetries(
-      {
-        ...plan,
-        rawArgs: [...normalizedArgs, '--cli-lang=cn'],
-      },
-      options,
-    );
-    return retry.ok
-      ? { ...retry, autoRetried: true, reactiveFallback: true, injection: 'reactive', injectedLang: 'cn' }
-      : appendLangHint(retry, match[1], metaDir);
-  }
   if (match && !result.ok) {
     return appendLangHint(result, match[1], metaDir);
   }

package/plugins/huaweicloud-core/src/mcp-protocol.mjs

@@ -22,21 +22,29 @@ for (const base of [pluginRoot, packageRoot]) {
 }
 
 // 会话内首个非 check/upgrade 工具调用附加 _updateInfo，只消费一次。
-let hintConsumed = false;
-function decorateResult(name, result) {
-  if (hintConsumed) return result;
+// 按会话隔离：同进程内不同会话(A/B)各自首次提示；stdio 用固定 'stdin'。
+const consumedBySession = new Map();
+export function _decorateResult(sessionId, name, result) {
+  if (consumedBySession.get(sessionId)) return result;
   try {
     const hint = peekCachedUpdateInfo();
     if (!hint) return result;
     const decorated = applyUpdateHint(result, name, hint);
-    if (decorated !== result) hintConsumed = true;
+    if (decorated !== result) consumedBySession.set(sessionId, true);
     return decorated;
   } catch {
     return result; // 兜底装饰失败绝不影响工具调用
   }
 }
+export function _resetHintConsumption() {
+  consumedBySession.clear();
+}
+export function _isHintConsumed(sessionId) {
+  return Boolean(consumedBySession.get(sessionId));
+}
 
-export async function dispatch(method, params) {
+export async function dispatch(method, params, opts = {}) {
+  const sessionId = opts?.sessionId || 'default';
   if (method === 'initialize') {
     const ci = params.clientInfo || {};
 
@@ -68,7 +76,7 @@ export async function dispatch(method, params) {
 
   if (method === 'tools/call') {
     const result = await callTool(params.name, params.arguments || {});
-    const decorated = decorateResult(params.name, result);
+    const decorated = _decorateResult(sessionId, params.name, result);
     return {
       content: [
         {

package/plugins/huaweicloud-core/src/mcp-server-remote.mjs

@@ -50,7 +50,8 @@ export async function startRemoteServer({ port = DEFAULT_PORT, host = DEFAULT_HO
 
     let response;
     try {
-      const result = await dispatch(message.method, message.params || {});
+      const sessionId = (req.headers['mcp-session-id'] || '').trim() || 'default';
+      const result = await dispatch(message.method, message.params || {}, { sessionId });
       response = { jsonrpc: '2.0', id: message.id, result };
       if (message.method === 'initialize') {
         res.setHeader('MCP-Protocol-Version', result.protocolVersion || '2024-11-05');

package/plugins/huaweicloud-core/src/mcp-server.mjs

@@ -159,7 +159,7 @@ function runStdioServer() {
       return;
     }
     try {
-      const result = await dispatch(message.method, message.params || {});
+      const result = await dispatch(message.method, message.params || {}, { sessionId: 'stdin' });
       writeMessage({ jsonrpc: '2.0', id: message.id, result });
     } catch (error) {
       writeMessage({

package/plugins/huaweicloud-core/src/tools.mjs

@@ -1049,7 +1049,7 @@ function normalizeNumericArgs(args) {
   return out;
 }
 
-export async function callTool(name, rawArgs = {}) {
+export async function callTool(name, rawArgs = {}, opts = {}) {
   const args = normalizeNumericArgs(rawArgs);
   const toolValue = toolInvokeValue(name, args);
   trackToolInvoke(name, toolValue);
@@ -1448,33 +1448,35 @@ export async function callTool(name, rawArgs = {}) {
     case 'huaweicloud_voucher_claim':
       return await hdkitVoucherClaim(args.domain_id);
     case 'huaweicloud_check_update':
-      return await handleCheckUpdate(args);
+      return await handleCheckUpdate(args, { sessionId: opts?.sessionId });
     case 'huaweicloud_upgrade':
-      return await handleUpgrade(args);
+      return await handleUpgrade(args, { sessionId: opts?.sessionId });
     default:
       throw new Error(`Unknown tool: ${name}`);
   }
 }
 
-async function handleCheckUpdate(args = {}) {
+async function handleCheckUpdate(args = {}, opts = {}) {
+  const sessionId = opts?.sessionId || null;
   const current = readInstalledVersion() || '0.0.0';
   if (args.dismiss === true) {
-    const distTags = await getUpdateDistTags(current);
+    const distTags = await getUpdateDistTags(current, { sessionId });
     const target = determineTarget(current, distTags);
     const dismissedVersion =
       typeof args.dismissVersion === 'string' && args.dismissVersion ? args.dismissVersion : target || current;
-    const state = writeSkipState(resolveSkipFilePath(), dismissedVersion);
+    const state = writeSkipState(resolveSkipFilePath(sessionId), dismissedVersion);
     invalidateUpdateCache();
     return judgeUpdate(current, distTags, state);
   }
-  return getCachedUpdateInfo(current);
+  return getCachedUpdateInfo(current, { sessionId });
 }
 
-async function handleUpgrade(args = {}) {
+async function handleUpgrade(args = {}, opts = {}) {
+  const sessionId = opts?.sessionId || null;
   const target = typeof args.target === 'string' && args.target ? args.target : 'all';
   const version = typeof args.version === 'string' && args.version ? args.version : 'latest';
   const current = readInstalledVersion() || '0.0.0';
-  const info = await getCachedUpdateInfo(current);
+  const info = await getCachedUpdateInfo(current, { sessionId });
   if (info && info.result === 'up_to_date') {
     return {
       success: false,

package/plugins/huaweicloud-core/src/update-check.mjs

@@ -152,12 +152,26 @@ export function fallbackSkipFilePath() {
   return join(base, '.config', 'huaweicloud', 'devkit-skip.json');
 }
 
+// 会话化 skip 文件：remote 多会话按 sessionId 拆分，stdio/默认保持原文件(向后兼容)。
+function sanitizeSessionId(sessionId) {
+  return String(sessionId || '').replace(/[^0-9a-zA-Z-]/g, '_');
+}
+
 // A1 定稿: 标准 agent 用插件目录副本(有 package.json); codex 等无副本时回退共享文件
-export function resolveSkipFilePath() {
+export function resolveSkipFilePath(sessionId = null) {
+  let base;
   try {
-    if (existsSync(join(dirname(skipFilePath()), 'package.json'))) return skipFilePath();
-  } catch {}
-  return fallbackSkipFilePath();
+    if (existsSync(join(dirname(skipFilePath()), 'package.json'))) {
+      base = skipFilePath();
+    } else {
+      base = fallbackSkipFilePath();
+    }
+  } catch {
+    base = fallbackSkipFilePath();
+  }
+  // stdio / 默认 / 无 session → 原文件（保持向后兼容）
+  if (!sessionId || sessionId === 'default' || sessionId === 'stdin') return base;
+  return `${base}.${sanitizeSessionId(sessionId)}`;
 }
 
 export function readSkipState(file) {
@@ -293,12 +307,15 @@ function cacheValid(now = Date.now()) {
   return Boolean(cachedDistTags) && now - cachedAt <= TTL_MS;
 }
 
-export async function getCachedUpdateInfo(current, { doQuery = queryDistTags, now = Date.now() } = {}) {
+export async function getCachedUpdateInfo(
+  current,
+  { doQuery = queryDistTags, now = Date.now(), sessionId = null } = {},
+) {
   if (process.env.HUAWEICLOUD_DEVKIT_SKIP_UPDATE === '1') {
     lastHint = judgeUpdate(current, null, undefined, now);
     return lastHint;
   }
-  const skipState = readSkipState(resolveSkipFilePath());
+  const skipState = readSkipState(resolveSkipFilePath(sessionId));
   if (!cacheValid(now)) {
     if (!cachedDistTags && now - failedAt < FAIL_THROTTLE_MS) {
       lastHint = judgeUpdate(current, null, skipState, now);
@@ -331,8 +348,8 @@ export function peekCachedUpdateInfo() {
   return lastHint && lastHint.updateAvailable && lastHint.targetVersion ? lastHint : null;
 }
 
-export async function getUpdateDistTags(current) {
-  const result = await getCachedUpdateInfo(current);
+export async function getUpdateDistTags(current, { sessionId = null } = {}) {
+  const result = await getCachedUpdateInfo(current, { sessionId });
   if (!result) return null;
   return { latest: result.latestStable ?? null, next: result.latestNext ?? null };
 }