@harmonyos-arkts/opencode-plugin 0.0.11 → 0.0.13

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}`);
     }
@@ -31572,6 +31572,7 @@ var HM_DESIGN = `
 - 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
@@ -32938,10 +32939,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 +33303,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 +33475,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 +33485,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 +33517,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")
@@ -45333,37 +45334,6 @@ function convert_search_result(searchResults, prefix) {
   });
 }
 
-// src/tools/skill-search/skill-search-tool.ts
-function skillSearchTool(managers) {
-  return tool({
-    description: "Search for relevant documents within the harmonyos-atomic-dev skill directory by keywords. Returns the top K most relevant document snippets from the skill directory, ranked by keyword match frequency. Use this tool instead of Glob/Grep when you need to find specific knowledge or documentation within harmonyos-atomic-dev skill. The results include experience_file_path (path to the matching experience document best practices) and ets_file_path (path to the ETS code examples and SDK API file). IMPORTANT: Each scenario only supports ONE tool call. Do NOT call this tool multiple times.",
-    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)
-    },
-    execute: async (args, context) => {
-      try {
-        const results = await searchSkill(args.skill_path, args.query, args.topK);
-        if (results.length === 0) {
-          return "No relative items found in the skill directory.";
-        }
-        const sdkInfo = results.map((r) => {
-          const parts = [];
-          if (r.experience_file_path) parts.push(`experience path ${r.experience_file_path}`);
-          if (r.ets_file_path) parts.push(`sample code path ${r.ets_file_path}`);
-          if (r.sdk_file_path) parts.push(`sdk info path ${r.sdk_file_path}`);
-          return parts.join("\n");
-        }).join("\n\n");
-        return `You can read the following files as needed to obtain information. 
- ${sdkInfo}`;
-      } catch (e) {
-        return `Error: ${e instanceof Error ? e.message : String(e)}`;
-      }
-    }
-  });
-}
-
 // src/tools/harmony-doc/api-client.ts
 var BASE_URL = "https://svc-drcn.developer.huawei.com/community/servlet";
 var HEADERS = {
@@ -45371,46 +45341,28 @@ var HEADERS = {
   Referer: "https://developer.huawei.com/consumer/cn/doc/",
   "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36"
 };
-var MAX_RETRIES = 2;
-var RETRY_DELAY_MS = 1e3;
-async function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-async function post(path7, body) {
-  let lastError;
-  for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
-    try {
-      const res = await fetch(BASE_URL + path7, {
-        method: "POST",
-        headers: HEADERS,
-        body: JSON.stringify(body)
-      });
-      if (!res.ok) {
-        const retriable = res.status === 429 || res.status >= 500;
-        if (retriable && attempt < MAX_RETRIES) {
-          lastError = new Error(`API request failed: ${res.status} ${res.statusText} for ${path7}`);
-          await sleep(RETRY_DELAY_MS * (attempt + 1));
-          continue;
-        }
-        throw new Error(`API request failed: ${res.status} ${res.statusText} for ${path7}`);
-      }
-      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}`);
-      }
-      return data;
-    } catch (e) {
-      if (e instanceof TypeError && e.message.includes("fetch")) {
-        lastError = e;
-        if (attempt < MAX_RETRIES) {
-          await sleep(RETRY_DELAY_MS * (attempt + 1));
-          continue;
-        }
-      }
-      throw e;
+var REQUEST_TIMEOUT_MS = 1e4;
+async function post(path9, body) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+  try {
+    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 ${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 ${path9}`);
+    }
+    return data;
+  } finally {
+    clearTimeout(timer);
   }
-  throw lastError ?? new Error("Request failed after retries");
 }
 var CATALOG_DISPLAY_NAMES = {
   "harmonyos-guides": "\u6307\u5357",
@@ -45475,6 +45427,7 @@ async function searchDocs(keyword, maxResults = 10) {
       title: r.name ?? "",
       url: r.url ?? "",
       excerpt: (r.content ?? "").replace(/\n/g, " ").substring(0, 200),
+      excerptTruncated: (r.content ?? "").replace(/\n/g, " ").length > 200,
       breadcrumb,
       contentType: r.metaData?.type ?? 0,
       timestamp: r.metaData?.timestamp ?? "",
@@ -45583,6 +45536,160 @@ function formatUpdateTime(utcTimeStr) {
   return `${y}-${m}-${d} ${h}:${min}`;
 }
 
+// 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.",
+    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)
+    },
+    execute: async (args, context) => {
+      const [localResults, docResults] = await Promise.all([
+        searchSkill(args.skill_path, args.query, args.topK).catch(
+          (e) => new Error(`Local search failed: ${e instanceof Error ? e.message : String(e)}`)
+        ),
+        searchDocs(args.query, 5).catch(
+          (e) => new Error(`Doc search failed: ${e instanceof Error ? e.message : String(e)}`)
+        )
+      ]);
+      const parts = [];
+      if (localResults instanceof Error) {
+        parts.push(`## Local Skill Results
+
+${localResults.message}`);
+      } else if (localResults.length === 0) {
+        parts.push("## Local Skill Results\n\nNo matching skill documents found.");
+      } else {
+        const localInfo = localResults.map((r) => {
+          const lines = [];
+          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}`);
+          return lines.join("\n");
+        }).join("\n\n");
+        parts.push(`## Local Skill Results
+
+${localInfo}`);
+      }
+      if (docResults instanceof Error) {
+        parts.push(`## Official Documentation
+
+${docResults.message}`);
+      } else if (docResults.length === 0) {
+        parts.push("## Official Documentation\n\nNo matching official documents found.");
+      } else {
+        const docInfo = docResults.map((r, i) => {
+          const lines = [];
+          let title = r.title;
+          if (r.subsection && r.subsection !== r.title) {
+            title += ` #${r.subsection}`;
+          }
+          lines.push(`${i + 1}. **${title}**`);
+          let displayUrl = r.url;
+          if (r.anchorId) {
+            displayUrl += `#${r.anchorId}`;
+          }
+          lines.push(`   URL: ${displayUrl}`);
+          if (r.excerpt) {
+            const suffix = r.excerptTruncated ? "..." : "";
+            lines.push(`   ${r.excerpt}${suffix}`);
+          }
+          if (r.breadcrumb.length > 0) {
+            lines.push(`   \u6765\u81EA: ${r.breadcrumb.join(" > ")}`);
+          }
+          return lines.join("\n");
+        }).join("\n\n");
+        parts.push(
+          `## Official Documentation
+
+${docInfo}
+
+Use harmony-doc-view with a URL above to read any official document in full.`
+        );
+      }
+      return parts.join("\n\n");
+    }
+  });
+}
+
+// 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++) {
@@ -46648,69 +46755,21 @@ function getCached(objectId) {
 function setCache(objectId, doc, markdown, breadcrumb) {
   docCache.set(objectId, { doc, markdown, breadcrumb, fetchedAt: Date.now() });
 }
-function harmonyDocTool(_managers) {
+function harmonyDocViewTool(_managers) {
   return tool({
-    description: "HarmonyOS developer documentation tool with two actions: 'search' and 'view'. Use 'search' to find documents by keyword; use 'view' to read a specific document by URL. Typical workflow: search first, then view the relevant result. NOTE: This tool makes network requests and may take longer to respond. Prefer using skillSearch first for component usage, Kit capabilities, and common development patterns \u2014 only fall back to this tool when skillSearch does not cover the topic.",
+    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.",
     args: {
-      action: tool.schema.enum(["search", "view"]).describe("Action to perform: 'search' to find documents by keyword, 'view' to read a document by URL."),
-      query: tool.schema.string("Search keyword or phrase (for action='search'). Use specific terms, e.g. 'Button component', 'router navigation'.").optional(),
-      maxResults: tool.schema.number("Maximum search results to return (for action='search').").min(1).max(20).default(10),
-      url: tool.schema.string("Full URL of the document to view (for action='view'). Must be a developer.huawei.com URL from search results.").optional(),
-      page: tool.schema.number("Page number for long documents (for action='view'). Starts at 1.").min(1).default(1)
+      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)
     },
     execute: async (args, _context) => {
-      if (args.action === "search") {
-        return executeSearch(args.query, args.maxResults);
-      }
       return executeView(args.url, args.page);
     }
   });
 }
-async function executeSearch(query, maxResults) {
-  if (!query) {
-    return "Error: 'query' is required when action is 'search'.";
-  }
-  try {
-    log("[harmony-doc search]", { query, maxResults });
-    const results = await searchDocs(query, maxResults ?? 10);
-    if (results.length === 0) {
-      return `No results found for "${query}". Try different keywords.`;
-    }
-    const formatted = results.map((r, i) => {
-      const parts = [];
-      let title = r.title;
-      if (r.subsection && r.subsection !== r.title) {
-        title += ` #${r.subsection}`;
-      }
-      parts.push(`${i + 1}. **${title}**`);
-      if (r.breadcrumb.length > 0) {
-        parts.push(`   Path: ${r.breadcrumb.join(" > ")}`);
-      }
-      let displayUrl = r.url;
-      if (r.anchorId) {
-        displayUrl += `#${r.anchorId}`;
-      }
-      parts.push(`   URL: ${displayUrl}`);
-      if (r.excerpt) {
-        parts.push(`   ${r.excerpt}`);
-      }
-      return parts.join("\n");
-    }).join("\n\n");
-    return `Found ${results.length} results for "${query}":
-
-${formatted}
-
-Use action='view' with the URL to read the full document.`;
-  } catch (e) {
-    return `Error: ${e instanceof Error ? e.message : String(e)}`;
-  }
-}
 async function executeView(url3, page) {
-  if (!url3) {
-    return "Error: 'url' is required when action is 'view'.";
-  }
   try {
-    log("[harmony-doc view]", { url: url3, page });
+    log("[harmony-doc-view]", { url: url3, page });
     const objectId = objectIdFromUrl(url3);
     if (!objectId) {
       return `Error: Cannot extract document ID from URL: ${url3}`;
@@ -46723,22 +46782,22 @@ async function executeView(url3, page) {
       doc = cached3.doc;
       markdown = cached3.markdown;
       breadcrumb = cached3.breadcrumb;
-      log("[harmony-doc view] cache hit", { objectId, page });
+      log("[harmony-doc-view] cache hit", { objectId, page });
     } else {
       doc = await fetchDocument(objectId);
       if (!doc.html) {
-        log("[harmony-doc view] API returned empty HTML", { objectId, title: doc.title });
+        log("[harmony-doc-view] API returned empty HTML", { objectId, title: doc.title });
         return `Error: Document content is empty for ${url3} (objectId: ${objectId}). The API returned no HTML content \u2014 the document may not be available through this API.`;
       }
       markdown = htmlToMarkdown(doc.html);
-      log("[harmony-doc view] conversion result", {
+      log("[harmony-doc-view] conversion result", {
         objectId,
         htmlLength: doc.html.length,
         markdownLength: markdown.length,
         markdownPreview: markdown.substring(0, 300)
       });
       if (!markdown.trim()) {
-        log("[harmony-doc view] markdown conversion produced empty output", {
+        log("[harmony-doc-view] markdown conversion produced empty output", {
           objectId,
           htmlLength: doc.html.length
         });
@@ -46749,11 +46808,11 @@ async function executeView(url3, page) {
         try {
           breadcrumb = await resolveBreadcrumb("cn", doc.catalogName, objectId);
         } catch (e) {
-          log("[harmony-doc view] breadcrumb resolution failed", { objectId, error: String(e) });
+          log("[harmony-doc-view] breadcrumb resolution failed", { objectId, error: String(e) });
         }
       }
       setCache(objectId, doc, markdown, breadcrumb);
-      log("[harmony-doc view] cache miss, fetched from network", { objectId });
+      log("[harmony-doc-view] cache miss, fetched from network", { objectId });
     }
     const MAX_LENGTH = 3e4;
     const totalPages = Math.max(1, Math.ceil(markdown.length / MAX_LENGTH));
@@ -46784,9 +46843,9 @@ Source: ${url3}
       output += `
 
 ---
-[Document continues \u2014 call with action='view' and page=${currentPage + 1} to read more]`;
+[Document continues \u2014 call with page=${currentPage + 1} to read more]`;
     }
-    log("[harmony-doc view] RETURN", {
+    log("[harmony-doc-view] RETURN", {
       objectId,
       outputLength: output.length,
       chunkLength: chunk.length,
@@ -46804,7 +46863,8 @@ function createBuiltinTools(managers) {
   return {
     createHmTemplate: createHmTemplateTool(managers),
     skillSearch: skillSearchTool(managers),
-    "harmony-doc": harmonyDocTool(managers)
+    html_preview: htmlPreviewTool(managers),
+    "harmony-doc-view": harmonyDocViewTool(managers)
   };
 }
 
@@ -46928,11 +46988,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,
@@ -46942,7 +47002,7 @@ Diff.prototype = {
       };
     } else {
       return {
-        oldPos: path7.oldPos + oldPosInc,
+        oldPos: path9.oldPos + oldPosInc,
         lastComponent: {
           count: 1,
           added,
@@ -47379,6 +47439,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;
@@ -47420,6 +47483,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);
     }
   };
@@ -47445,6 +47509,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") {

package/package.json

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