@harmonyos-arkts/opencode-plugin 0.0.18 → 0.0.20

package/dist/index.js

@@ -31911,9 +31911,6 @@ function createHmAgent() {
     permission: {
       "*": "allow",
       doom_loop: "ask",
-      external_directory: {
-        "*": "ask"
-      },
       "skillSearch": "allow",
       ascf_build: "deny",
       skill: {
@@ -44872,10 +44869,10 @@ async function updateEtsCache(sessionManager, sessionID, directory) {
 var CHECK_ETS_TEMPLATE_MODES = /* @__PURE__ */ new Set(["atomic", "application"]);
 function createHmTemplateTool(managers) {
   return tool({
-    description: "Create an empty HarmonyOS project template. Supports three modes: 'application' (full app), 'module' (sub-module), 'atomic' (atomic service). Defaults to the current working directory unless the user specifies a different directory.",
+    description: "Create an empty HarmonyOS project template. Supports three modes: 'application' (full app), 'module' (sub-module), 'atomic' (atomic service). Defaults to the current working directory unless the user specifies a different directory.\n\nParameters:\n- filePath: Absolute path of the target directory where the template will be created. Defaults to the current working directory if not specified.\n- mode: Template type: 'application' (\u5E94\u7528), 'module' (\u6A21\u5757), or 'atomic' (\u5143\u670D\u52A1).",
     args: {
-      filePath: tool.schema.string("Absolute path of the target directory where the template will be created. Defaults to the current working directory if not specified."),
-      mode: tool.schema.string("Template type: 'application' (\u5E94\u7528), 'module' (\u6A21\u5757), or 'atomic' (\u5143\u670D\u52A1)")
+      filePath: tool.schema.string(),
+      mode: tool.schema.string()
     },
     execute: async (args, context) => {
       try {
@@ -45584,11 +45581,11 @@ function formatUpdateTime(utcTimeStr) {
 // src/tools/skill-search/skill-search-tool.ts
 function skillSearchTool(managers) {
   return tool({
-    description: "Search HarmonyOS development knowledge across BOTH local skill documents AND official Huawei documentation. Returns two sections: (1) Local Skill Results \u2014 file paths to curated code examples, best practices, and SDK API info from the harmonyos-atomic-dev skill directory; (2) Official Documentation \u2014 search results from developer.huawei.com with titles, URLs, breadcrumbs, and excerpts. Use this tool for any HarmonyOS API, component, Kit, or development pattern lookup. After reviewing results, read local skill files for code patterns and use harmony-doc-view to read full official documents by URL. IMPORTANT: This tool already searches official documentation \u2014 do NOT also call harmony-doc-view for the same purpose. Only use harmony-doc-view to read a specific document page from the URLs listed below. Each scenario only supports ONE tool call. Do NOT call this tool multiple times.",
+    description: "Search HarmonyOS development knowledge across BOTH local skill documents AND official Huawei documentation. Returns two sections: (1) Local Skill Results \u2014 file paths to curated code examples, best practices, and SDK API info from the harmonyos-atomic-dev skill directory; (2) Official Documentation \u2014 search results from developer.huawei.com with titles, URLs, breadcrumbs, and excerpts. Use this tool for any HarmonyOS API, component, Kit, or development pattern lookup. After reviewing results, read local skill files for code patterns and use harmony-doc-view to read full official documents by URL. IMPORTANT: This tool already searches official documentation \u2014 do NOT also call harmony-doc-view for the same purpose. Only use harmony-doc-view to read a specific document page from the URLs listed below. Each scenario only supports ONE tool call. Do NOT call this tool multiple times.\n\nParameters:\n- skill_path: The COMPLETE absolute filesystem path to the harmonyos-atomic-dev skill directory (e.g. '/home/user/.opencode/skills/harmonyos-atomic-dev'). Do NOT pass just the skill name 'harmonyos-atomic-dev' \u2014 you MUST resolve and provide the full absolute path. Do NOT include any prefix like 'file://' or suffix like 'SKILL.md' or 'index.json'.\n- query: A decomposed requirement or intent describing what you want to find, broken down into searchable keywords separated by spaces. QUERY TIPS: For best results, decompose your intent into short space-separated keywords instead of long sentences. Include: 1) Kit or component name (e.g. ScanKit, AdsKit, ShareKit), 2) specific API or method names (e.g. scanBarcode, loadAd, ShareController), 3) feature keywords (e.g. \u626B\u7801, \u5E7F\u544A\u52A0\u8F7D, \u5206\u4EAB). Example: 'ScanKit \u626B\u7801 scanBarcode startScanForResult' instead of '\u5E2E\u6211\u5B9E\u73B0\u4E00\u4E2A\u626B\u7801\u529F\u80FD'.\n- topK: Maximum number of top-ranked documents to return (1-3, default 3). Actual results may be fewer depending on query relevance.",
     args: {
-      skill_path: tool.schema.string("Absolute path to the harmonyos-atomic-dev skill directory. IMPORTANT: this path should not contain any prefix or suffix like 'file://' or 'SKILL.md'."),
-      query: tool.schema.string("A decomposed requirement or intent describing what you want to find, broken down into searchable keywords separated by spaces. QUERY TIPS: For best results, decompose your intent into short space-separated keywords instead of long sentences. Include: 1) Kit or component name (e.g. ScanKit, AdsKit, ShareKit), 2) specific API or method names (e.g. scanBarcode, loadAd, ShareController), 3) feature keywords (e.g. \u626B\u7801, \u5E7F\u544A\u52A0\u8F7D, \u5206\u4EAB). Example: 'ScanKit \u626B\u7801 scanBarcode startScanForResult' instead of '\u5E2E\u6211\u5B9E\u73B0\u4E00\u4E2A\u626B\u7801\u529F\u80FD'. "),
-      topK: tool.schema.number("Maximum number of top-ranked documents to return. Actual results may be fewer depending on query relevance.").min(1).max(3).default(3)
+      skill_path: tool.schema.string(),
+      query: tool.schema.string(),
+      topK: tool.schema.number().min(1).max(3).default(3)
     },
     execute: async (args, context) => {
       const [localResults, docResults] = await Promise.all([
@@ -45697,14 +45694,10 @@ async function resolvePrototypePreview(directory, filePathInput) {
 }
 function htmlPreviewTool(_managers) {
   return tool({
-    description: "Send the UX prototype preview to the frontend. Call this immediately after writing prototype.html. You MUST pass filePath with the exact local path of the written file so the frontend can locate and preview it.",
+    description: "Send the UX prototype preview to the frontend. Call this immediately after writing prototype.html. You MUST pass filePath with the exact local path of the written file so the frontend can locate and preview it.\n\nParameters:\n- filePath: Local path to prototype.html. Use the same path from the write step, e.g. prototype.html, /Users/yanqing/coding/your-project/prototype.html, or file:///.../prototype.html.\n- title: (optional) Title shown in the preview panel.",
     args: {
-      filePath: tool.schema.string(
-        "Local path to prototype.html. Use the same path from the write step, e.g. prototype.html, /Users/yanqing/coding/your-project/prototype.html, or file:///.../prototype.html."
-      ),
-      title: tool.schema.optional(
-        tool.schema.string("Optional title shown in the preview panel")
-      )
+      filePath: tool.schema.string(),
+      title: tool.schema.optional(tool.schema.string())
     },
     execute: async (args, context) => {
       try {
@@ -46803,10 +46796,10 @@ function setCache(objectId, doc, markdown, breadcrumb) {
 }
 function harmonyDocViewTool(_managers) {
   return tool({
-    description: "View a HarmonyOS official documentation page by URL with full Markdown content and pagination. Use this tool to read official API references, guides, and best practices from developer.huawei.com. Typically used with URLs obtained from skillSearch's Official Documentation results. Supports pagination for long documents \u2014 use the 'page' parameter to continue reading.",
+    description: "View a HarmonyOS official documentation page by URL with full Markdown content and pagination. Use this tool to read official API references, guides, and best practices from developer.huawei.com. Typically used with URLs obtained from skillSearch's Official Documentation results. Supports pagination for long documents \u2014 use the 'page' parameter to continue reading.\n\nParameters:\n- url: Full URL of the document to view. Must be a developer.huawei.com URL, typically from skillSearch results.\n- page: Page number for long documents. Starts at 1. Default is 1.",
     args: {
-      url: tool.schema.string("Full URL of the document to view. Must be a developer.huawei.com URL, typically from skillSearch results."),
-      page: tool.schema.number("Page number for long documents. Starts at 1.").min(1).default(1)
+      url: tool.schema.string(),
+      page: tool.schema.number().min(1).default(1)
     },
     execute: async (args, _context) => {
       return executeView(args.url, args.page);
@@ -47531,6 +47524,7 @@ function createToolHooks(sessionManager, projectDir) {
       injectAiCodeChange(input, output);
       await injectHtmlPreview(input, output, projectDir);
       await updateEtsCount(sessionManager, projectDir, input);
+      markCompactAfterHtmlPreview(input, sessionManager);
     }
   };
 }
@@ -47620,28 +47614,63 @@ function injectAiCodeChange(input, output) {
     log("aiCodeChange after hook error", { tool: input.tool, error: String(e) });
   }
 }
+function markCompactAfterHtmlPreview(input, sessionManager) {
+  if (input.tool !== "html_preview") return;
+  const sessionID = input.sessionID;
+  if (!sessionID) return;
+  let session = sessionManager.get(sessionID);
+  if (!session) {
+    session = sessionManager.create(sessionID);
+  }
+  session.data.set("compactAfterPreviewActive", true);
+  log("Activated persistent context compaction after html_preview", { sessionID });
+}
 
 // src/commands/env-check.ts
 import { execSync } from "child_process";
-function runEnvCheck() {
-  const checks = [
-    { name: "Java", cmd: "java -version" },
-    { name: "Node.js", cmd: "node -v" },
-    { name: "ohpm", cmd: "ohpm -v" },
-    { name: "hvigorw", cmd: "hvigorw -v" }
-  ];
-  const lines = [];
-  lines.push("HarmonyOS Development Environment Check\uFF1A");
-  for (const check3 of checks) {
+import { readFileSync as readFileSync2, unlinkSync as unlinkSync2 } from "fs";
+import { join as join7 } from "path";
+import { tmpdir as tmpdir2 } from "os";
+function runCmdRaw(cmd) {
+  try {
+    const output = execSync(`${cmd} 2>&1`, { timeout: 1e4, encoding: "utf-8" });
+    return output.split(/\r?\n/)[0]?.trim() || void 0;
+  } catch (err) {
+    const output = (err.stderr?.toString() || err.stdout?.toString() || "").trim();
+    return output.split(/\r?\n/)[0]?.trim() || void 0;
+  }
+}
+function runCmdToFile(cmd) {
+  const tmpFile = join7(tmpdir2(), `hm-env-${Date.now()}.txt`);
+  try {
+    execSync(`${cmd} > "${tmpFile}" 2>&1`, { timeout: 1e4 });
+    const content = readFileSync2(tmpFile, "utf-8");
+    return content.split(/\r?\n/)[0]?.trim() || void 0;
+  } catch {
+    return void 0;
+  } finally {
     try {
-      const output = execSync(`${check3.cmd} 2>&1`, { timeout: 1e4, encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
-      const firstLine = output.split(/\r?\n/)[0]?.trim() || "";
-      const suffix = check3.name === "Java" ? " (requires >= 17)" : "";
-      lines.push(`[${check3.name}] ${firstLine}${suffix}`);
-    } catch (err) {
-      lines.push(`[${check3.name}] NOT FOUND`);
+      unlinkSync2(tmpFile);
+    } catch {
     }
   }
+}
+function runCmd(cmd, { retry = false } = {}) {
+  const result = runCmdRaw(cmd) || runCmdToFile(cmd);
+  if (result || !retry) return result;
+  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 2e3);
+  return runCmdRaw(cmd) || runCmdToFile(cmd);
+}
+function runEnvCheck() {
+  const lines = [];
+  lines.push("HarmonyOS Development Environment Check\uFF1A");
+  const java = runCmd("java -version", { retry: true });
+  lines.push(`[Java] ${java ?? "NOT FOUND"}${java ? " (requires >= 17)" : ""}`);
+  lines.push(`[Node.js] ${process.version}`);
+  const ohpm = runCmd("ohpm -v");
+  lines.push(`[ohpm] ${ohpm ?? "NOT FOUND"}`);
+  const hvigorw = runCmd("hvigorw -v") || runCmdToFile("hvigorw -v");
+  lines.push(`[hvigorw] ${hvigorw ?? "NOT FOUND"}`);
   const sdkHome = process.env.DEVECO_SDK_HOME;
   lines.push(`[DEVECO_SDK_HOME] ${sdkHome ?? "NOT SET"}`);
   return lines.join("\n\n");

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@harmonyos-arkts/opencode-plugin",
-  "version": "0.0.18",
+  "version": "0.0.20",
   "description": "HarmonyOS Full-Lifecycle Development Assistant. Specialized in the complete development lifecycle of HarmonyOS applications, including project creation, UI development, state management, network requests, data storage, permission requests, performance optimization, testing, and release.",
   "type": "module",
   "license": "MIT",