@hulistmi/hulistmi 1.0.0

package/src/lib/skill.ts

@@ -0,0 +1,100 @@
+import { HTTPException } from "hono/http-exception";
+
+export const SKILL_NAME = "hulistmi";
+
+export const skillHeaders = {
+  "Access-Control-Allow-Origin": "*",
+  "Cache-Control": "public, max-age=300, s-maxage=600",
+  "Content-Type": "text/markdown; charset=utf-8",
+};
+
+export const skillIndexHeaders = {
+  "Access-Control-Allow-Origin": "*",
+  "Cache-Control": "public, max-age=300, s-maxage=600",
+  "Content-Type": "application/json; charset=utf-8",
+};
+
+export interface SkillArtifact {
+  bytes: ArrayBuffer;
+  description: string;
+  name: string;
+}
+
+export async function loadSkill(
+  assets: Fetcher,
+  baseUrl: string,
+): Promise<SkillArtifact> {
+  const skillResponse = await assets.fetch(
+    new Request(new URL("/SKILL.md", baseUrl).toString()),
+  );
+  if (!skillResponse.ok)
+    throw new HTTPException(500, { message: "Failed to load SKILL.md" });
+  const bytes = await skillResponse.arrayBuffer();
+  const frontmatter = parseSkillFrontmatter(new TextDecoder().decode(bytes));
+  if (frontmatter.name !== SKILL_NAME)
+    throw new HTTPException(500, {
+      message: `Expected skill name "${SKILL_NAME}".`,
+    });
+  if (!frontmatter.description)
+    throw new HTTPException(500, { message: "Skill description is required." });
+  return {
+    bytes,
+    description: frontmatter.description,
+    name: frontmatter.name,
+  };
+}
+
+export async function skillExists(
+  assets: Fetcher,
+  baseUrl: string,
+): Promise<boolean> {
+  const response = await assets.fetch(
+    new Request(new URL("/SKILL.md", baseUrl).toString(), { method: "HEAD" }),
+  );
+  return response.ok;
+}
+
+export async function createSkillIndex(skill: SkillArtifact) {
+  return {
+    $schema: "https://schemas.agentskills.io/discovery/0.2.0/schema.json",
+    skills: [
+      {
+        name: skill.name,
+        type: "skill-md",
+        description: skill.description,
+        url: `/.well-known/agent-skills/${skill.name}/SKILL.md`,
+        digest: `sha256:${await sha256Hex(skill.bytes)}`,
+        files: ["SKILL.md"],
+      },
+    ],
+  };
+}
+
+function parseSkillFrontmatter(markdown: string): Record<string, string> {
+  const match = markdown.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/);
+  if (!match)
+    throw new HTTPException(500, {
+      message: "SKILL.md must start with YAML frontmatter.",
+    });
+  const fields: Record<string, string> = {};
+  for (const line of match[1].split(/\r?\n/)) {
+    if (!line.trim()) continue;
+    const separator = line.indexOf(":");
+    if (separator === -1)
+      throw new HTTPException(500, {
+        message: `Invalid SKILL.md frontmatter line: ${line}`,
+      });
+    fields[line.slice(0, separator).trim()] = line
+      .slice(separator + 1)
+      .trim()
+      .replace(/^['"]|['"]$/g, "");
+  }
+  return fields;
+}
+
+async function sha256Hex(bytes: ArrayBuffer): Promise<string> {
+  const digest = await crypto.subtle.digest("SHA-256", bytes);
+  return [...new Uint8Array(digest)]
+    .map((byte) => byte.toString(16).padStart(2, "0"))
+    .join("");
+}

package/src/lib/types.ts

@@ -0,0 +1,18 @@
+export interface HarmonyContentBlock {
+  content: string;
+}
+
+export interface HarmonyDocumentValue {
+  status: string;
+  title: string;
+  content: HarmonyContentBlock | null;
+  anchorList?: Array<{ title?: string; anchorId?: string }>;
+  docId?: string | number;
+  updatedDate?: string;
+}
+
+export interface HarmonyDocumentResponse {
+  code: number | string;
+  message?: string;
+  value?: HarmonyDocumentValue;
+}

package/src/lib/upstream-contract.json

@@ -0,0 +1,103 @@
+{
+  "allowedHosts": ["svc-drcn.developer.huawei.com"],
+  "allowedPaths": [
+    "/community/servlet/consumer/cn/documentPortal/getCatalogTree",
+    "/community/servlet/consumer/cn/documentPortal/getDocumentById",
+    "/community/servlet/consumer/cn/documentPortal/getNavigationAddress",
+    "/community/servlet/consumer/cn/documentPortal/checkCenterGrayUser",
+    "/community/servlet/consumer/cn/documentPortal/getCenterRootNodeTree",
+    "/community/servlet/consumer/cn/documentPortal/getCenterDocument",
+    "/community/servlet/consumer/partnerCommunityService/developer/search"
+  ],
+  "catalogs": {
+    "harmonyos-guides": {
+      "request": {
+        "url": "https://svc-drcn.developer.huawei.com/community/servlet/consumer/cn/documentPortal/getCatalogTree",
+        "headers": {},
+        "body": {
+          "language": "en",
+          "catalogName": "harmonyos-guides",
+          "showHide": "1"
+        }
+      },
+      "responseHeaders": { "content-type": "application/json" }
+    },
+    "harmonyos-references": {
+      "request": {
+        "url": "https://svc-drcn.developer.huawei.com/community/servlet/consumer/cn/documentPortal/getCatalogTree",
+        "headers": {},
+        "body": {
+          "language": "en",
+          "catalogName": "harmonyos-references",
+          "showHide": "1"
+        }
+      },
+      "responseHeaders": { "content-type": "application/json" }
+    }
+  },
+  "documents": {
+    "harmonyos-guides/start-overview": {
+      "checkCenterGrayUser": {
+        "url": "https://svc-drcn.developer.huawei.com/community/servlet/consumer/cn/documentPortal/checkCenterGrayUser",
+        "headers": {},
+        "body": {
+          "catalogName": "harmonyos-guides",
+          "language": "en",
+          "fileName": "start-overview",
+          "grayId": "11111111111111111111111111111111"
+        }
+      },
+      "getDocumentById": {
+        "url": "https://svc-drcn.developer.huawei.com/community/servlet/consumer/cn/documentPortal/getDocumentById",
+        "headers": {},
+        "body": {
+          "objectId": "start-overview",
+          "nodeAlias": null,
+          "catalogName": "harmonyos-guides",
+          "language": "en"
+        }
+      }
+    },
+    "harmonyos-references/js-apis-app-ability-uiability": {
+      "checkCenterGrayUser": {
+        "url": "https://svc-drcn.developer.huawei.com/community/servlet/consumer/cn/documentPortal/checkCenterGrayUser",
+        "headers": {},
+        "body": {
+          "catalogName": "harmonyos-references",
+          "language": "en",
+          "fileName": "js-apis-app-ability-uiability",
+          "grayId": "11111111111111111111111111111111"
+        }
+      },
+      "getDocumentById": {
+        "url": "https://svc-drcn.developer.huawei.com/community/servlet/consumer/cn/documentPortal/getDocumentById",
+        "headers": {},
+        "body": {
+          "objectId": "js-apis-app-ability-uiability",
+          "nodeAlias": null,
+          "catalogName": "harmonyos-references",
+          "language": "en"
+        }
+      }
+    }
+  },
+  "search": {
+    "url": "https://svc-drcn.developer.huawei.com/community/servlet/consumer/partnerCommunityService/developer/search",
+    "headers": {},
+    "responseHeaders": { "content-type": "application/json" },
+    "bodyForUIAbility": {
+      "deviceId": "ESN",
+      "deviceType": "1",
+      "language": "en",
+      "country": "CN",
+      "requestOrgin": 5,
+      "whetherToCorrect": 1,
+      "keyWord": "UIAbility",
+      "cutPage": { "offset": 0, "length": 20 },
+      "developerVertical": { "categoryList": [1], "language": "en" }
+    },
+    "maxQueryLength": 120,
+    "defaultLength": 20,
+    "maxLength": 20
+  }
+}

package/src/lib/upstream-contract.ts

@@ -0,0 +1,3 @@
+import contract from "./upstream-contract.json";
+
+export const UPSTREAM_CONTRACT = contract;

package/src/lib/url.ts

@@ -0,0 +1,50 @@
+const HUAWEI_DOC_ORIGIN = "https://developer.huawei.com";
+const DOC_PREFIX = "/consumer/en/doc/";
+
+export function normalizeDocsPath(path: string): string {
+  return path.trim().replace(/^\/+/, "").replace(/\/+$/, "");
+}
+
+export function generateHuaweiDocUrl(path: string): string {
+  return `${HUAWEI_DOC_ORIGIN}${DOC_PREFIX}${normalizeDocsPath(path)}`;
+}
+
+export function isValidHuaweiDocUrl(input: string): boolean {
+  try {
+    const url = new URL(input);
+    return (
+      url.protocol === "https:" &&
+      url.hostname === "developer.huawei.com" &&
+      url.pathname.startsWith(DOC_PREFIX)
+    );
+  } catch {
+    return false;
+  }
+}
+
+export function huaweiUrlToPath(input: string): string {
+  const url = new URL(input);
+  if (!url.pathname.startsWith(DOC_PREFIX))
+    throw new Error(`Unsupported Huawei documentation URL: ${input}`);
+  return normalizeDocsPath(url.pathname.slice(DOC_PREFIX.length));
+}
+
+export function splitDocsPath(path: string): {
+  catalogName: "harmonyos-guides" | "harmonyos-references";
+  pagePath: string;
+} {
+  const normalized = normalizeDocsPath(path);
+  if (normalized.startsWith("harmonyos-guides/")) {
+    return {
+      catalogName: "harmonyos-guides",
+      pagePath: normalized.slice("harmonyos-guides/".length),
+    };
+  }
+  if (normalized.startsWith("harmonyos-references/")) {
+    return {
+      catalogName: "harmonyos-references",
+      pagePath: normalized.slice("harmonyos-references/".length),
+    };
+  }
+  throw new Error(`Unsupported HarmonyOS documentation path: ${path}`);
+}

package/src/lib/webmcp.ts

@@ -0,0 +1,19 @@
+import { TOOL_DEFINITIONS } from "./mcp";
+
+export function buildWebMcpManifest(origin = "https://hulistmi.ai") {
+  return {
+    name: "hulistmi.ai",
+    description: "AI-readable HarmonyOS documentation.",
+    mcp: `${origin}/mcp`,
+    tools: Object.entries(TOOL_DEFINITIONS).map(([name, definition]) => ({
+      name,
+      description: definition.description,
+      http: {
+        ...definition.http,
+        path: definition.http.path
+          ? `${origin}${definition.http.path}`
+          : undefined,
+      },
+    })),
+  };
+}

package/wrangler.jsonc

@@ -0,0 +1,18 @@
+{
+  "$schema": "node_modules/wrangler/config-schema.json",
+  "name": "hulistmi-ai",
+  "main": "src/index.ts",
+  "compatibility_date": "2026-03-10",
+  "compatibility_flags": ["nodejs_compat"],
+  "assets": {
+    "binding": "ASSETS",
+    "directory": "./public",
+    "run_worker_first": ["/", "/.well-known/agent-skills/*"]
+  },
+  "observability": {
+    "enabled": true
+  },
+  "vars": {
+    "NODE_ENV": "production"
+  }
+}