@harmonyos-arkts/opencode-plugin 0.0.12 → 0.0.14

package/dist/index.js

@@ -5052,32 +5052,32 @@ var require_URL = __commonJS({
           else
             return basepath.substring(0, lastslash + 1) + refpath;
         }
-        function remove_dot_segments(path7) {
-          if (!path7) return path7;
+        function remove_dot_segments(path9) {
+          if (!path9) return path9;
           var output = "";
-          while (path7.length > 0) {
-            if (path7 === "." || path7 === "..") {
-              path7 = "";
+          while (path9.length > 0) {
+            if (path9 === "." || path9 === "..") {
+              path9 = "";
               break;
             }
-            var twochars = path7.substring(0, 2);
-            var threechars = path7.substring(0, 3);
-            var fourchars = path7.substring(0, 4);
+            var twochars = path9.substring(0, 2);
+            var threechars = path9.substring(0, 3);
+            var fourchars = path9.substring(0, 4);
             if (threechars === "../") {
-              path7 = path7.substring(3);
+              path9 = path9.substring(3);
             } else if (twochars === "./") {
-              path7 = path7.substring(2);
+              path9 = path9.substring(2);
             } else if (threechars === "/./") {
-              path7 = "/" + path7.substring(3);
-            } else if (twochars === "/." && path7.length === 2) {
-              path7 = "/";
-            } else if (fourchars === "/../" || threechars === "/.." && path7.length === 3) {
-              path7 = "/" + path7.substring(4);
+              path9 = "/" + path9.substring(3);
+            } else if (twochars === "/." && path9.length === 2) {
+              path9 = "/";
+            } else if (fourchars === "/../" || threechars === "/.." && path9.length === 3) {
+              path9 = "/" + path9.substring(4);
               output = output.replace(/\/?[^\/]*$/, "");
             } else {
-              var segment = path7.match(/(\/?([^\/]*))/)[0];
+              var segment = path9.match(/(\/?([^\/]*))/)[0];
               output += segment;
-              path7 = path7.substring(segment.length);
+              path9 = path9.substring(segment.length);
             }
           }
           return output;
@@ -18304,10 +18304,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path7) {
-  if (!path7)
+function getElementAtPath(obj, path9) {
+  if (!path9)
     return obj;
-  return path7.reduce((acc, key) => acc?.[key], obj);
+  return path9.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -18690,11 +18690,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path7, issues) {
+function prefixIssues(path9, issues) {
   return issues.map((iss) => {
     var _a2;
     (_a2 = iss).path ?? (_a2.path = []);
-    iss.path.unshift(path7);
+    iss.path.unshift(path9);
     return iss;
   });
 }
@@ -18877,7 +18877,7 @@ function formatError(error92, mapper = (issue3) => issue3.message) {
 }
 function treeifyError(error92, mapper = (issue3) => issue3.message) {
   const result = { errors: [] };
-  const processError = (error93, path7 = []) => {
+  const processError = (error93, path9 = []) => {
     var _a2, _b;
     for (const issue3 of error93.issues) {
       if (issue3.code === "invalid_union" && issue3.errors.length) {
@@ -18887,7 +18887,7 @@ function treeifyError(error92, mapper = (issue3) => issue3.message) {
       } else if (issue3.code === "invalid_element") {
         processError({ issues: issue3.issues }, issue3.path);
       } else {
-        const fullpath = [...path7, ...issue3.path];
+        const fullpath = [...path9, ...issue3.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue3));
           continue;
@@ -18919,8 +18919,8 @@ function treeifyError(error92, mapper = (issue3) => issue3.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path7 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path7) {
+  const path9 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path9) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -30897,13 +30897,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path7 = ref.slice(1).split("/").filter(Boolean);
-  if (path7.length === 0) {
+  const path9 = ref.slice(1).split("/").filter(Boolean);
+  if (path9.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path7[0] === defsKey) {
-    const key = path7[1];
+  if (path9[0] === defsKey) {
+    const key = path9[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -31452,31 +31452,28 @@ import path2 from "path";
 import fs from "fs/promises";
 import os2 from "os";
 var paths = envPaths("hm-plugin");
-var HMGlobal;
-((HMGlobal2) => {
-  HMGlobal2.Path = {
-    // Allow override via OPENCODE_TEST_HOME for test isolation
-    get home() {
-      return process.env.OPENCODE_TEST_HOME || os2.homedir();
-    },
-    data: paths.data,
-    bin: path2.join(paths.data, "bin"),
-    log: paths.log,
-    cache: paths.cache,
-    config: paths.config,
-    state: paths.data
-  };
-})(HMGlobal || (HMGlobal = {}));
+var Path = {
+  // Allow override via OPENCODE_TEST_HOME for test isolation
+  get home() {
+    return process.env.OPENCODE_TEST_HOME || os2.homedir();
+  },
+  data: paths.data,
+  bin: path2.join(paths.data, "bin"),
+  log: paths.log,
+  cache: paths.cache,
+  config: paths.config,
+  state: paths.data
+};
 await Promise.all([
-  fs.mkdir(HMGlobal.Path.data, { recursive: true }),
-  fs.mkdir(HMGlobal.Path.config, { recursive: true }),
-  fs.mkdir(HMGlobal.Path.state, { recursive: true }),
-  fs.mkdir(HMGlobal.Path.log, { recursive: true }),
-  fs.mkdir(HMGlobal.Path.bin, { recursive: true })
+  fs.mkdir(Path.data, { recursive: true }),
+  fs.mkdir(Path.config, { recursive: true }),
+  fs.mkdir(Path.state, { recursive: true }),
+  fs.mkdir(Path.log, { recursive: true }),
+  fs.mkdir(Path.bin, { recursive: true })
 ]);
 
 // src/shared/log.ts
-var logFile = path3.join(HMGlobal.Path.log, "plugin.log");
+var logFile = path3.join(Path.log, "plugin.log");
 var logDir = path3.dirname(logFile);
 var MAX_LOG_SIZE_BYTES = 5 * 1024 * 1024;
 var MAX_LOG_AGE_DAYS = 7;
@@ -31568,10 +31565,11 @@ cleanupRotatedLogs();
 
 // src/agents/prompt.ts
 var HM_DESIGN = `
-### Prd Phase
+### Design Phase
 - Use the \`harmonyos-prd-design\` skill to create prd desgin documents
 - Reference design patterns and best practices from the skill documentation
 - Design documents should be stored in the project's \`.harmonyos/\` directory
+- After UX renders the prototype, write it as \`prototype.html\`, then call \`html_preview\` with \`filePath\` set to that file's local path so the frontend can open it reliably
 `;
 var HM_DEVELOP = `
 ### Development Phase
@@ -31733,33 +31731,29 @@ function buildPlanPrompt(type) {
   }
 }
 function buildAllAgentPrompt() {
-  return `All HarmonyOS development tasks can be broadly categorized into three main phases: Design, Development, Build. Each phase has its own set of best practices and workflows to ensure efficient and successful project completion.
+  return `- **New project (greenfield)**: Design \u2192 Development \u2192 Build. Do not skip the design phase, as it is critical for planning and architectural decisions.
+- **Complex tasks**: List a plan \u2192 Discuss plan details with the user if needed \u2192 Development \u2192 Build.
+- **Simple tasks**: Development \u2192 Build directly.
+
+Each phase has its own set of best practices and workflows to ensure efficient and successful project completion.
+
 ${HM_DESIGN}
 ${HM_DEVELOP}
 ${HM_BUILD}
-
-Follow these workflows:
-- **New project (greenfield)**: PRD Design \u2192 Development \u2192 Build.
-- **Complex tasks**: List a plan \u2192 Discuss plan details with the user if needed \u2192 Development \u2192 Build.
-- **Simple tasks**: Development \u2192 Build directly.
 `;
 }
 function buildHmAgentPrompt(type) {
   return `You are HarmonyOS Dev Assistant(HDACode), an expert coding agent specialized in HarmonyOS development.
-
 You are an interactive CLI tool that helps users with software engineering tasks. Use the instructions below and the tools available to you to assist the user.
-
 IMPORTANT: You must NEVER generate or guess URLs for the user unless you are confident that the URLs are for helping the user with programming. You may use URLs provided by the user in their messages or local files.
-
 When the user directly asks about HDACode (eg. "can HDACode do...", "does HDACode have..."), or asks in second person (eg. "are you able...", "can you do..."), or asks how to use a specific HDACode feature (eg. implement a hook, write a slash command, or install an MCP server), use the WebFetch tool to gather information to answer the question from HDACode docs.
-
 **IMPORTANT**: All HarmonyOS development tasks must follow these workflows:
 
 ${buildPlanPrompt(type)}
 
 # Tone and style
 - Only use emojis if the user explicitly requests it. Avoid using emojis in all communication unless asked.
-- Unless the user specifies a language, reply in the user's language; code encoding content is excluded from this rule.
+- You MUST reply in Chinese (\u7B80\u4F53\u4E2D\u6587) at all times; code, technical identifiers, and file paths are excluded from this rule.
 - Your output will be displayed on a command line interface. You can use GitHub-flavored markdown for formatting, and will be rendered in a monospace font using the CommonMark specification.
 - Keep your responses brief and direct. Lead with the answer or action, not the reasoning. Skip preamble and postamble (e.g., "The answer is...", "Based on the information provided..."). Only elaborate when the user asks for detail.
 - Output text to communicate with the user; all text you output outside of tool use is displayed to the user. Only use tools to complete tasks. Never use tools like Bash or code comments as means to communicate with the user during the session.
@@ -31796,24 +31790,6 @@ The first item has been fixed, let me mark the first todo as completed, and move
 </example>
 In the above example, the assistant completes all the tasks, including the 10 error fixes and running the build and fixing all errors.
 
-<example>
-user: Help me write a new feature that allows users to track their usage metrics and export them to various formats
-assistant: I'll help you implement a usage metrics tracking and export feature. Let me first use the TodoWrite tool to plan this task.
-Adding the following todos to the todo list:
-1. Research existing metrics tracking in the codebase
-2. Design the metrics collection system
-3. Implement core metrics tracking functionality
-4. Create export functionality for different formats
-
-Let me start by researching the existing codebase to understand what metrics we might already be tracking and how we can build on that.
-
-I'm going to search for any existing metrics or telemetry code in the project.
-
-I've found some existing telemetry code. Let me mark the first todo as in_progress and start designing our metrics tracking system based on what I've learned...
-
-[Assistant continues implementing the feature step by step, marking todos as in_progress and completed as they go]
-</example>
-
 
 # Doing tasks
 The user will primarily request you perform software engineering tasks. This includes solving bugs, adding new functionality, refactoring code, explaining code, and more. For these tasks the following steps are recommended:
@@ -32938,10 +32914,10 @@ function mergeDefs2(...defs) {
 function cloneDef2(schema) {
   return mergeDefs2(schema._zod.def);
 }
-function getElementAtPath2(obj, path7) {
-  if (!path7)
+function getElementAtPath2(obj, path9) {
+  if (!path9)
     return obj;
-  return path7.reduce((acc, key) => acc?.[key], obj);
+  return path9.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject2(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -33302,11 +33278,11 @@ function aborted2(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues2(path7, issues) {
+function prefixIssues2(path9, issues) {
   return issues.map((iss) => {
     var _a2;
     (_a2 = iss).path ?? (_a2.path = []);
-    iss.path.unshift(path7);
+    iss.path.unshift(path9);
     return iss;
   });
 }
@@ -33474,7 +33450,7 @@ function treeifyError2(error92, _mapper) {
     return issue3.message;
   };
   const result = { errors: [] };
-  const processError = (error93, path7 = []) => {
+  const processError = (error93, path9 = []) => {
     var _a2, _b;
     for (const issue3 of error93.issues) {
       if (issue3.code === "invalid_union" && issue3.errors.length) {
@@ -33484,7 +33460,7 @@ function treeifyError2(error92, _mapper) {
       } else if (issue3.code === "invalid_element") {
         processError({ issues: issue3.issues }, issue3.path);
       } else {
-        const fullpath = [...path7, ...issue3.path];
+        const fullpath = [...path9, ...issue3.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue3));
           continue;
@@ -33516,8 +33492,8 @@ function treeifyError2(error92, _mapper) {
 }
 function toDotPath2(_path) {
   const segs = [];
-  const path7 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path7) {
+  const path9 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path9) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -44630,7 +44606,7 @@ function tool(input) {
 tool.schema = external_exports2;
 
 // src/tools/create-template/download-template.ts
-import { cpSync, mkdirSync } from "fs";
+import { cpSync, existsSync } from "fs";
 import path6 from "path";
 import { fileURLToPath } from "url";
 
@@ -44720,7 +44696,9 @@ async function downloadTemplate(mode, filePath) {
   }
   const targetDir = path6.resolve(filePath);
   const templateDir = path6.join(__dirname, "templates", templateType);
-  mkdirSync(targetDir, { recursive: true });
+  if (!existsSync(targetDir)) {
+    throw new Error(`Directory does not exist: ${targetDir}. Please create it first.`);
+  }
   cpSync(templateDir, targetDir, { recursive: true });
   const sdkInfo = getSdkVersion();
   if (sdkInfo) {
@@ -44835,15 +44813,15 @@ 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). Downloads and extracts the template to the specified 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.",
     args: {
-      filePath: tool.schema.string("Absolute path of the target directory where the template will be created"),
+      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)")
     },
     execute: async (args, context) => {
       try {
         if (CHECK_ETS_TEMPLATE_MODES.has(args.mode)) {
-          const fileCount = await checkEtsExists(context.directory);
+          const fileCount = await checkEtsExists(args.filePath);
           if (fileCount > 0) {
             log("[createHmTemplate] skipped, ets files exist", { fileCount });
             return `Skipped: Current directory already contains ${fileCount} .ets file(s). Template download is not needed.`;
@@ -44860,7 +44838,7 @@ function createHmTemplateTool(managers) {
 }
 
 // src/tools/skill-search/search-skill.ts
-import { readFileSync, existsSync } from "node:fs";
+import { readFileSync, existsSync as existsSync2 } from "node:fs";
 import { join as join4 } from "node:path";
 
 // src/tools/skill-search/tokenizer.ts
@@ -44895,7 +44873,10 @@ function tokenize(text) {
 var BM25Retriever = class {
   k1;
   b;
-  documents = [];
+  _documents = [];
+  get documents() {
+    return this._documents;
+  }
   tokenizedDocs = [];
   df = /* @__PURE__ */ new Map();
   tfMaps = [];
@@ -44905,7 +44886,7 @@ var BM25Retriever = class {
     this.b = opts?.b ?? 0.75;
   }
   addDocuments(docs, tokenized) {
-    this.documents = [...this.documents, ...docs];
+    this._documents = [...this._documents, ...docs];
     this.tokenizedDocs = [...this.tokenizedDocs, ...tokenized];
     const totalLen = this.tokenizedDocs.reduce(
       (sum, doc) => sum + doc.length,
@@ -44990,12 +44971,12 @@ var HybridRetriever = class {
     this.keyword.addDocuments(docs, tokenized);
   }
   search(query, topK = 5) {
-    if (this.bm25["documents"].length === 0) return [];
+    if (this.bm25.documents.length === 0) return [];
     const poolSize = topK * 3;
     const bm25Results = this.bm25.search(query, poolSize);
     const keywordResults = this.keyword.search(query, poolSize);
     const rrfK = 60;
-    const documents = this.bm25["documents"];
+    const documents = this.bm25.documents;
     const scores = /* @__PURE__ */ new Map();
     for (let rank = 0; rank < bm25Results.length; rank++) {
       const idx = bm25Results[rank].index;
@@ -45226,7 +45207,7 @@ async function loadAndCache(resolvedPath) {
   log("start load sdk cache", sdk_path);
   if (sdk_path !== void 0) {
     const sdkIndexPath = join4(import.meta.dirname, "sdk-index.json");
-    if (!existsSync(sdkIndexPath)) {
+    if (!existsSync2(sdkIndexPath)) {
       log("sdk path is not exist, need to build");
       await buildSDKIndex(sdk_path);
     }
@@ -45253,7 +45234,7 @@ async function loadAndCache(resolvedPath) {
 function loadSdkIndex() {
   if (cachedSdkRetriever) return true;
   const sdkIndexPath = join4(import.meta.dirname, "sdk-index.json");
-  if (!existsSync(sdkIndexPath)) return false;
+  if (!existsSync2(sdkIndexPath)) return false;
   try {
     const raw = readFileSync(sdkIndexPath, "utf-8");
     const entries = JSON.parse(raw);
@@ -45285,7 +45266,8 @@ async function searchSkill(skill_path, query, topK = 3) {
       preFiltered.push({
         ets_file_path: "",
         experience_file_path: join4(prefix, entry.path),
-        sdk_file_path: ""
+        sdk_file_path: "",
+        score: 0
       });
       query = (query.slice(0, idx) + query.slice(idx + category.length)).trim();
     }
@@ -45297,7 +45279,8 @@ async function searchSkill(skill_path, query, topK = 3) {
   const sdkResults = loadSdkIndex() ? cachedSdkRetriever.search(query, topK).filter((r) => r.score >= MIN_SCORE).map((r) => ({
     ets_file_path: "",
     experience_file_path: "",
-    sdk_file_path: cachedSdkEntries[r.index].path
+    sdk_file_path: cachedSdkEntries[r.index].path,
+    score: r.score
   })) : [];
   const searchResults = cachedRetriever.search(query, topK);
   const filtered = searchResults.filter((r) => r.score >= MIN_SCORE);
@@ -45313,6 +45296,9 @@ function aggregateByExperience(results) {
       if (r.ets_file_path) {
         existing.ets_file_path = existing.ets_file_path ? existing.ets_file_path + "\n" + r.ets_file_path : r.ets_file_path;
       }
+      if (r.score > existing.score) {
+        existing.score = r.score;
+      }
     } else {
       map3.set(key, { ...r });
     }
@@ -45328,7 +45314,8 @@ function convert_search_result(searchResults, prefix) {
     return {
       ets_file_path: join4(prefix, entry.path),
       experience_file_path: experience?.path ? join4(prefix, experience.path) : "",
-      sdk_file_path: ""
+      sdk_file_path: "",
+      score: result.score
     };
   });
 }
@@ -45341,22 +45328,22 @@ var HEADERS = {
   "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36"
 };
 var REQUEST_TIMEOUT_MS = 1e4;
-async function post(path7, body) {
+async function post(path9, body) {
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
   try {
-    const res = await fetch(BASE_URL + path7, {
+    const res = await fetch(BASE_URL + path9, {
       method: "POST",
       headers: HEADERS,
       body: JSON.stringify(body),
       signal: controller.signal
     });
     if (!res.ok) {
-      throw new Error(`API request failed: ${res.status} ${res.statusText} for ${path7}`);
+      throw new Error(`API request failed: ${res.status} ${res.statusText} for ${path9}`);
     }
     const data = await res.json();
     if (data.code && data.code !== 0 && data.code !== "0") {
-      throw new Error(`API error [${data.code}]: ${data.message} for ${path7}`);
+      throw new Error(`API error [${data.code}]: ${data.message} for ${path9}`);
     }
     return data;
   } finally {
@@ -45563,6 +45550,7 @@ ${localResults.message}`);
       } else {
         const localInfo = localResults.map((r) => {
           const lines = [];
+          lines.push(`score ${r.score.toFixed(4)}`);
           if (r.experience_file_path) lines.push(`- experience path: ${r.experience_file_path}`);
           if (r.ets_file_path) lines.push(`- sample code path: ${r.ets_file_path}`);
           if (r.sdk_file_path) lines.push(`- sdk info path: ${r.sdk_file_path}`);
@@ -45613,6 +45601,82 @@ Use harmony-doc-view with a URL above to read any official document in full.`
   });
 }
 
+// src/tools/html-preview/html-preview-tool.ts
+import { access } from "fs/promises";
+import path7 from "path";
+import { fileURLToPath as fileURLToPath2, pathToFileURL } from "url";
+var PROTOTYPE_HTML_FILENAME = "prototype.html";
+function toFileUrl(filePath) {
+  return pathToFileURL(path7.resolve(filePath)).href;
+}
+async function fileExists(filePath) {
+  try {
+    await access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function resolvePrototypePath(directory, input) {
+  const trimmed = input.trim();
+  if (!trimmed) {
+    throw new Error("filePath is required");
+  }
+  if (trimmed.startsWith("file://")) {
+    return fileURLToPath2(trimmed);
+  }
+  return path7.isAbsolute(trimmed) ? trimmed : path7.resolve(directory, trimmed);
+}
+async function resolvePrototypePreview(directory, filePathInput) {
+  const filePath = resolvePrototypePath(directory, filePathInput);
+  if (!await fileExists(filePath)) {
+    throw new Error(
+      `Prototype HTML not found: ${filePath}. Pass the exact local path where ${PROTOTYPE_HTML_FILENAME} was written.`
+    );
+  }
+  return { url: toFileUrl(filePath), filePath };
+}
+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.",
+    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")
+      )
+    },
+    execute: async (args, context) => {
+      try {
+        log("[html_preview]", { filePath: args.filePath, title: args.title });
+        const { url: url3, filePath } = await resolvePrototypePreview(context.directory, args.filePath);
+        const title = args.title?.trim() || "Prototype Preview";
+        const metadata = {
+          url: url3,
+          filePath,
+          fileName: path7.basename(filePath),
+          title
+        };
+        context.metadata({
+          title,
+          metadata: {
+            htmlPreview: metadata
+          }
+        });
+        return [
+          "Prototype preview sent to frontend.",
+          `Title: ${title}`,
+          `Local path: ${filePath}`,
+          `Preview URL: ${url3}`
+        ].join("\n");
+      } catch (e) {
+        return `Error: ${e instanceof Error ? e.message : String(e)}`;
+      }
+    }
+  });
+}
+
 // node_modules/turndown/lib/turndown.es.js
 function extend3(destination) {
   for (var i = 1; i < arguments.length; i++) {
@@ -46786,6 +46850,7 @@ function createBuiltinTools(managers) {
   return {
     createHmTemplate: createHmTemplateTool(managers),
     skillSearch: skillSearchTool(managers),
+    html_preview: htmlPreviewTool(managers),
     "harmony-doc-view": harmonyDocViewTool(managers)
   };
 }
@@ -46910,11 +46975,11 @@ Diff.prototype = {
       }
     }
   },
-  addToPath: function addToPath(path7, added, removed, oldPosInc, options) {
-    var last = path7.lastComponent;
+  addToPath: function addToPath(path9, added, removed, oldPosInc, options) {
+    var last = path9.lastComponent;
     if (last && !options.oneChangePerToken && last.added === added && last.removed === removed) {
       return {
-        oldPos: path7.oldPos + oldPosInc,
+        oldPos: path9.oldPos + oldPosInc,
         lastComponent: {
           count: last.count + 1,
           added,
@@ -46924,7 +46989,7 @@ Diff.prototype = {
       };
     } else {
       return {
-        oldPos: path7.oldPos + oldPosInc,
+        oldPos: path9.oldPos + oldPosInc,
         lastComponent: {
           count: 1,
           added,
@@ -47361,6 +47426,9 @@ arrayDiff.join = arrayDiff.removeEmpty = function(value) {
   return value;
 };
 
+// src/hooks/tool-hooks.ts
+import path8 from "path";
+
 // src/compress/compile-hvigorw.ts
 function processHvigorwCompileInfo(input, output) {
   if (input.tool !== "bash") return;
@@ -47402,6 +47470,7 @@ function createToolHooks(sessionManager, projectDir) {
     "tool.execute.after": async (input, output) => {
       processHvigorwCompileInfo(input, output);
       injectAiCodeChange(input, output);
+      await injectHtmlPreview(input, output, projectDir);
       await updateEtsCount(sessionManager, projectDir, input);
     }
   };
@@ -47427,6 +47496,30 @@ async function updateEtsCount(sessionManager, projectDir, input) {
     }
   }
 }
+async function injectHtmlPreview(input, output, projectDir) {
+  if (input.tool !== "html_preview") return;
+  try {
+    const existing = output.metadata.htmlPreview;
+    if (existing?.url) {
+      output.title = existing.title?.trim() || "Prototype Preview";
+      return;
+    }
+    const filePathArg = input.args?.filePath;
+    if (!filePathArg) return;
+    const title = input.args?.title?.trim() || "Prototype Preview";
+    const { url: url3, filePath } = await resolvePrototypePreview(projectDir, filePathArg);
+    output.title = title;
+    output.metadata.htmlPreview = {
+      url: url3,
+      filePath,
+      fileName: path8.basename(filePath),
+      title
+    };
+    log("htmlPreview injected", { url: url3, title });
+  } catch (e) {
+    log("htmlPreview after hook error", { tool: input.tool, error: String(e) });
+  }
+}
 function injectAiCodeChange(input, output) {
   try {
     if (input.tool === "write") {
@@ -47571,7 +47664,7 @@ function createHooks(args) {
     ["tool.execute.before", () => toolHooks["tool.execute.before"]],
     ["tool.execute.after", () => toolHooks["tool.execute.after"]],
     ["command.execute.before", () => commandHooks["command.execute.before"]],
-    ["event", () => sessionHooks["event"]],
+    ["event", () => sessionHooks.event],
     ["chat.params", () => createChatParamsHandler(config3)],
     ["chat.message", () => createChatMessageHandler(ctx, managers)]
   ];

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@harmonyos-arkts/opencode-plugin",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "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",