@xopcai/xopc 0.0.29 → 0.0.31

package/dist/src/agent/skills/marketplace/adapters/skillhub/ecosystem-client.d.ts

@@ -0,0 +1,73 @@
+/**
+ * SkillHub distribution layer (SkillHub CLI `metadata.json` defaults):
+ * curated index on COS, lightmake search/download, COS static zip fallback.
+ *
+ * Registry HTTP: {@link ./registry-client.ts}.
+ */
+/** Same shape as store `MarketplacePackageListItem` (avoid importing store adapter). */
+export interface SkillHubEcosystemListItem {
+    id: string;
+    name: string;
+    type: string;
+    description: string;
+    downloads: number;
+    author: {
+        username: string;
+        avatarUrl: string | null;
+    };
+    latestVersion?: string;
+    updatedAt: string;
+    categories?: string[];
+    stars?: number;
+    sourceLabel?: string;
+}
+export interface SkillHubEcosystemUrls {
+    skillsIndexUrl: string;
+    searchUrl: string;
+    primaryDownloadTemplate: string;
+    fallbackDownloadTemplate: string;
+}
+/**
+ * SkillHub CLI–aligned endpoints (defaults match official `metadata.json`).
+ * Optional env overrides for mirrors/testing only — not part of gateway config.
+ */
+export declare function resolveSkillHubEcosystemUrls(): SkillHubEcosystemUrls;
+export declare function assertSkillHubDownloadUrlAllowed(downloadUrl: string, urls: SkillHubEcosystemUrls): URL;
+export interface SkillHubCuratedIndexSkill {
+    rank?: number;
+    slug: string;
+    name?: string;
+    description?: string;
+    version?: string;
+    homepage?: string;
+    downloads?: number;
+    stars?: number;
+    score?: number;
+    categories?: string[];
+}
+export interface SkillHubCuratedIndex {
+    total?: number;
+    skills: SkillHubCuratedIndexSkill[];
+}
+export declare function fetchSkillHubCuratedIndex(urls: SkillHubEcosystemUrls): Promise<SkillHubCuratedIndex>;
+export declare function curatedSkillsToPackageItems(skills: SkillHubCuratedIndexSkill[]): SkillHubEcosystemListItem[];
+export interface LightmakeSearchHit {
+    slug: string;
+    displayName?: string;
+    name?: string;
+    summary?: string;
+    description?: string;
+    description_zh?: string;
+    version?: string;
+    downloads?: number;
+    installs?: number;
+    stars?: number;
+    owner_name?: string;
+    category?: string;
+    score?: number;
+    updatedAt?: number;
+    updated_at?: number;
+}
+export declare function searchSkillHubLightmake(urls: SkillHubEcosystemUrls, query: string, limit: number, timeoutMs?: number): Promise<SkillHubEcosystemListItem[]>;
+export declare function downloadSkillHubZipFromAllowlistedUrl(urls: SkillHubEcosystemUrls, downloadUrl: string): Promise<Buffer>;
+export declare function downloadSkillHubZipFromEcosystem(urls: SkillHubEcosystemUrls, slug: string): Promise<Buffer>;

package/dist/src/agent/skills/marketplace/adapters/skillhub/ecosystem-client.js

@@ -0,0 +1,200 @@
+import { MAX_SKILL_ZIP_BYTES } from "../../../managed-store.js";
+//#region src/agent/skills/marketplace/adapters/skillhub/ecosystem-client.ts
+/**
+* SkillHub distribution layer (SkillHub CLI `metadata.json` defaults):
+* curated index on COS, lightmake search/download, COS static zip fallback.
+*
+* Registry HTTP: {@link ./registry-client.ts}.
+*/
+const DEFAULT_SKILLS_INDEX_URL = "https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/skills.json";
+const DEFAULT_SEARCH_URL = "https://lightmake.site/api/v1/search";
+const DEFAULT_PRIMARY_DOWNLOAD_TEMPLATE = "https://lightmake.site/api/v1/download?slug={slug}";
+const DEFAULT_FALLBACK_DOWNLOAD_TEMPLATE = "https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/skills/{slug}.zip";
+const DEFAULT_ALLOWED_DOWNLOAD_HOSTS = new Set([
+	"lightmake.site",
+	"api.skillhub.cn",
+	"skillhub-1388575217.cos.ap-guangzhou.myqcloud.com"
+]);
+const LIGHTMAKE_SEARCH_MAX = 100;
+function templateWithSlug(template, slug) {
+	const raw = template.trim();
+	if (!raw) return "";
+	if (raw.includes("{slug}")) return raw.replaceAll("{slug}", encodeURIComponent(slug.trim()));
+	return `${raw.replace(/\/$/, "")}/${encodeURIComponent(slug.trim())}.zip`;
+}
+function hostFromTemplate(template) {
+	const t = templateWithSlug(template, "x");
+	try {
+		return new URL(t).hostname.toLowerCase();
+	} catch {
+		return;
+	}
+}
+/**
+* SkillHub CLI–aligned endpoints (defaults match official `metadata.json`).
+* Optional env overrides for mirrors/testing only — not part of gateway config.
+*/
+function resolveSkillHubEcosystemUrls() {
+	return {
+		skillsIndexUrl: process.env.XOPC_SKILLHUB_SKILLS_INDEX_URL?.trim() || DEFAULT_SKILLS_INDEX_URL,
+		searchUrl: process.env.XOPC_SKILLHUB_SEARCH_URL?.trim() || DEFAULT_SEARCH_URL,
+		primaryDownloadTemplate: process.env.XOPC_SKILLHUB_PRIMARY_DOWNLOAD_TEMPLATE?.trim() || DEFAULT_PRIMARY_DOWNLOAD_TEMPLATE,
+		fallbackDownloadTemplate: process.env.XOPC_SKILLHUB_FALLBACK_DOWNLOAD_TEMPLATE?.trim() || DEFAULT_FALLBACK_DOWNLOAD_TEMPLATE
+	};
+}
+function allowedDownloadHosts(urls) {
+	const hosts = new Set(DEFAULT_ALLOWED_DOWNLOAD_HOSTS);
+	for (const h of [hostFromTemplate(urls.primaryDownloadTemplate), hostFromTemplate(urls.fallbackDownloadTemplate)]) if (h) hosts.add(h);
+	try {
+		hosts.add(new URL(urls.skillsIndexUrl).hostname.toLowerCase());
+	} catch {}
+	try {
+		hosts.add(new URL(urls.searchUrl).hostname.toLowerCase());
+	} catch {}
+	return hosts;
+}
+function assertSkillHubDownloadUrlAllowed(downloadUrl, urls) {
+	let u;
+	try {
+		u = new URL(downloadUrl);
+	} catch {
+		throw new Error("Invalid SkillHub download URL");
+	}
+	if (u.protocol !== "https:") throw new Error("SkillHub download URL must use HTTPS");
+	const host = u.hostname.toLowerCase();
+	if (!allowedDownloadHosts(urls).has(host)) throw new Error("SkillHub download URL host is not allowlisted");
+	return u;
+}
+async function fetchJson(url, init) {
+	const res = await fetch(url, {
+		...init,
+		headers: {
+			Accept: "application/json",
+			...init?.headers
+		}
+	});
+	const text = await res.text();
+	if (!res.ok) {
+		let msg = `SkillHub ecosystem request failed (${res.status})`;
+		try {
+			const j = JSON.parse(text);
+			if (j.message) msg = j.message;
+			else if (j.error) msg = j.error;
+		} catch {
+			if (text) msg = text.slice(0, 200);
+		}
+		throw new Error(msg);
+	}
+	try {
+		return JSON.parse(text);
+	} catch {
+		throw new Error("SkillHub ecosystem returned invalid JSON");
+	}
+}
+async function fetchSkillHubCuratedIndex(urls) {
+	const raw = await fetchJson(urls.skillsIndexUrl);
+	if (Array.isArray(raw)) return { skills: raw };
+	if (raw && typeof raw === "object" && Array.isArray(raw.skills)) return raw;
+	throw new Error("SkillHub index JSON must be an object with a skills array");
+}
+function sourceLabelFromHomepage(homepage) {
+	const h = homepage?.trim().toLowerCase() ?? "";
+	if (h.includes("clawhub")) return "ClawHub";
+	if (h.includes("skillhub")) return "SkillHub";
+}
+function curatedSkillsToPackageItems(skills) {
+	return skills.map((s) => ({
+		id: s.slug,
+		name: (s.name ?? s.slug).trim() || s.slug,
+		type: "skill",
+		description: (s.description ?? "").trim(),
+		downloads: typeof s.downloads === "number" ? s.downloads : 0,
+		author: {
+			username: "skillhub",
+			avatarUrl: null
+		},
+		latestVersion: (s.version ?? "").trim() || void 0,
+		updatedAt: String(s.rank ?? s.score ?? 0),
+		categories: (s.categories ?? []).map((c) => String(c).trim()).filter(Boolean),
+		stars: typeof s.stars === "number" ? s.stars : void 0,
+		sourceLabel: sourceLabelFromHomepage(s.homepage)
+	}));
+}
+function lightmakeHitToPackageItem(hit) {
+	const slug = String(hit.slug || "").trim();
+	const desc = (hit.summary ?? hit.description_zh ?? hit.description ?? "").trim() || "";
+	const updated = hit.updatedAt ?? hit.updated_at ?? 0;
+	const cat = hit.category?.trim();
+	return {
+		id: slug,
+		name: (hit.displayName ?? hit.name ?? slug).trim() || slug,
+		type: "skill",
+		description: desc,
+		downloads: typeof hit.downloads === "number" ? hit.downloads : 0,
+		author: {
+			username: (hit.owner_name ?? "skillhub").trim() || "skillhub",
+			avatarUrl: null
+		},
+		latestVersion: (hit.version ?? "").trim() || void 0,
+		updatedAt: String(updated),
+		categories: cat ? [cat] : [],
+		stars: typeof hit.stars === "number" ? hit.stars : void 0,
+		sourceLabel: "Lightmake"
+	};
+}
+async function searchSkillHubLightmake(urls, query, limit, timeoutMs = 8e3) {
+	const q = query.trim().toLowerCase();
+	if (!q) return [];
+	const search = new URL(urls.searchUrl);
+	if (search.protocol !== "https:") throw new Error("SkillHub search URL must use HTTPS");
+	search.searchParams.set("q", q);
+	search.searchParams.set("limit", String(Math.max(1, Math.min(LIGHTMAKE_SEARCH_MAX, limit))));
+	const controller = new AbortController();
+	const timer = setTimeout(() => controller.abort(), timeoutMs);
+	try {
+		const results = (await fetchJson(search.toString(), { signal: controller.signal })).results;
+		if (!Array.isArray(results)) return [];
+		const out = [];
+		for (const item of results) {
+			if (!item || typeof item !== "object") continue;
+			if (!String(item.slug ?? "").trim()) continue;
+			out.push(lightmakeHitToPackageItem(item));
+		}
+		return out;
+	} finally {
+		clearTimeout(timer);
+	}
+}
+async function downloadSkillHubZipFromAllowlistedUrl(urls, downloadUrl) {
+	const normalized = assertSkillHubDownloadUrlAllowed(downloadUrl, urls);
+	const res = await fetch(normalized.toString(), { redirect: "follow" });
+	if (!res.ok) throw new Error(`Failed to download skill archive (${res.status})`);
+	const len = res.headers.get("content-length");
+	if (len) {
+		const n = Number(len);
+		if (Number.isFinite(n) && n > 15728640) throw new Error(`Zip exceeds maximum size (${MAX_SKILL_ZIP_BYTES} bytes)`);
+	}
+	const ab = await res.arrayBuffer();
+	const buf = Buffer.from(ab);
+	if (buf.length > 15728640) throw new Error(`Zip exceeds maximum size (${MAX_SKILL_ZIP_BYTES} bytes)`);
+	return buf;
+}
+async function downloadSkillHubZipFromEcosystem(urls, slug) {
+	const candidates = [templateWithSlug(urls.primaryDownloadTemplate, slug), templateWithSlug(urls.fallbackDownloadTemplate, slug)].filter(Boolean);
+	const seen = /* @__PURE__ */ new Set();
+	let lastErr;
+	for (const url of candidates) {
+		if (seen.has(url)) continue;
+		seen.add(url);
+		try {
+			return await downloadSkillHubZipFromAllowlistedUrl(urls, url);
+		} catch (e) {
+			lastErr = e instanceof Error ? e : new Error(String(e));
+		}
+	}
+	throw lastErr ?? /* @__PURE__ */ new Error("SkillHub ecosystem download failed");
+}
+//#endregion
+export { assertSkillHubDownloadUrlAllowed, curatedSkillsToPackageItems, downloadSkillHubZipFromAllowlistedUrl, downloadSkillHubZipFromEcosystem, fetchSkillHubCuratedIndex, resolveSkillHubEcosystemUrls, searchSkillHubLightmake };
+
+//# sourceMappingURL=ecosystem-client.js.map

package/dist/src/agent/skills/marketplace/adapters/skillhub/ecosystem-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecosystem-client.js","names":[],"sources":["../../../../../../../src/agent/skills/marketplace/adapters/skillhub/ecosystem-client.ts"],"sourcesContent":["/**\n * SkillHub distribution layer (SkillHub CLI `metadata.json` defaults):\n * curated index on COS, lightmake search/download, COS static zip fallback.\n *\n * Registry HTTP: {@link ./registry-client.ts}.\n */\n\nimport { MAX_SKILL_ZIP_BYTES } from '../../../managed-store.js';\n\n/** Same shape as store `MarketplacePackageListItem` (avoid importing store adapter). */\nexport interface SkillHubEcosystemListItem {\n  id: string;\n  name: string;\n  type: string;\n  description: string;\n  downloads: number;\n  author: { username: string; avatarUrl: string | null };\n  latestVersion?: string;\n  updatedAt: string;\n  categories?: string[];\n  stars?: number;\n  sourceLabel?: string;\n}\n\nconst DEFAULT_SKILLS_INDEX_URL = 'https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/skills.json';\nconst DEFAULT_SEARCH_URL = 'https://lightmake.site/api/v1/search';\nconst DEFAULT_PRIMARY_DOWNLOAD_TEMPLATE = 'https://lightmake.site/api/v1/download?slug={slug}';\nconst DEFAULT_FALLBACK_DOWNLOAD_TEMPLATE =\n  'https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/skills/{slug}.zip';\n\nconst DEFAULT_ALLOWED_DOWNLOAD_HOSTS = new Set([\n  'lightmake.site',\n  'api.skillhub.cn',\n  'skillhub-1388575217.cos.ap-guangzhou.myqcloud.com',\n]);\n\nconst LIGHTMAKE_SEARCH_MAX = 100;\n\nexport interface SkillHubEcosystemUrls {\n  skillsIndexUrl: string;\n  searchUrl: string;\n  primaryDownloadTemplate: string;\n  fallbackDownloadTemplate: string;\n}\n\nfunction templateWithSlug(template: string, slug: string): string {\n  const raw = template.trim();\n  if (!raw) return '';\n  if (raw.includes('{slug}')) {\n    return raw.replaceAll('{slug}', encodeURIComponent(slug.trim()));\n  }\n  const base = raw.replace(/\\/$/, '');\n  return `${base}/${encodeURIComponent(slug.trim())}.zip`;\n}\n\nfunction hostFromTemplate(template: string): string | undefined {\n  const t = templateWithSlug(template, 'x');\n  try {\n    return new URL(t).hostname.toLowerCase();\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * SkillHub CLI–aligned endpoints (defaults match official `metadata.json`).\n * Optional env overrides for mirrors/testing only — not part of gateway config.\n */\nexport function resolveSkillHubEcosystemUrls(): SkillHubEcosystemUrls {\n  return {\n    skillsIndexUrl: process.env.XOPC_SKILLHUB_SKILLS_INDEX_URL?.trim() || DEFAULT_SKILLS_INDEX_URL,\n    searchUrl: process.env.XOPC_SKILLHUB_SEARCH_URL?.trim() || DEFAULT_SEARCH_URL,\n    primaryDownloadTemplate:\n      process.env.XOPC_SKILLHUB_PRIMARY_DOWNLOAD_TEMPLATE?.trim() || DEFAULT_PRIMARY_DOWNLOAD_TEMPLATE,\n    fallbackDownloadTemplate:\n      process.env.XOPC_SKILLHUB_FALLBACK_DOWNLOAD_TEMPLATE?.trim() || DEFAULT_FALLBACK_DOWNLOAD_TEMPLATE,\n  };\n}\n\nfunction allowedDownloadHosts(urls: SkillHubEcosystemUrls): Set<string> {\n  const hosts = new Set(DEFAULT_ALLOWED_DOWNLOAD_HOSTS);\n  for (const h of [hostFromTemplate(urls.primaryDownloadTemplate), hostFromTemplate(urls.fallbackDownloadTemplate)]) {\n    if (h) hosts.add(h);\n  }\n  try {\n    hosts.add(new URL(urls.skillsIndexUrl).hostname.toLowerCase());\n  } catch {\n    /* ignore */\n  }\n  try {\n    hosts.add(new URL(urls.searchUrl).hostname.toLowerCase());\n  } catch {\n    /* ignore */\n  }\n  return hosts;\n}\n\nexport function assertSkillHubDownloadUrlAllowed(downloadUrl: string, urls: SkillHubEcosystemUrls): URL {\n  let u: URL;\n  try {\n    u = new URL(downloadUrl);\n  } catch {\n    throw new Error('Invalid SkillHub download URL');\n  }\n  if (u.protocol !== 'https:') {\n    throw new Error('SkillHub download URL must use HTTPS');\n  }\n  const host = u.hostname.toLowerCase();\n  if (!allowedDownloadHosts(urls).has(host)) {\n    throw new Error('SkillHub download URL host is not allowlisted');\n  }\n  return u;\n}\n\nexport interface SkillHubCuratedIndexSkill {\n  rank?: number;\n  slug: string;\n  name?: string;\n  description?: string;\n  version?: string;\n  homepage?: string;\n  downloads?: number;\n  stars?: number;\n  score?: number;\n  categories?: string[];\n}\n\nexport interface SkillHubCuratedIndex {\n  total?: number;\n  skills: SkillHubCuratedIndexSkill[];\n}\n\nasync function fetchJson<T>(url: string, init?: RequestInit): Promise<T> {\n  const res = await fetch(url, {\n    ...init,\n    headers: { Accept: 'application/json', ...init?.headers },\n  });\n  const text = await res.text();\n  if (!res.ok) {\n    let msg = `SkillHub ecosystem request failed (${res.status})`;\n    try {\n      const j = JSON.parse(text) as { message?: string; error?: string };\n      if (j.message) msg = j.message;\n      else if (j.error) msg = j.error;\n    } catch {\n      if (text) msg = text.slice(0, 200);\n    }\n    throw new Error(msg);\n  }\n  try {\n    return JSON.parse(text) as T;\n  } catch {\n    throw new Error('SkillHub ecosystem returned invalid JSON');\n  }\n}\n\nexport async function fetchSkillHubCuratedIndex(urls: SkillHubEcosystemUrls): Promise<SkillHubCuratedIndex> {\n  const raw = await fetchJson<unknown>(urls.skillsIndexUrl);\n  if (Array.isArray(raw)) {\n    return { skills: raw as SkillHubCuratedIndexSkill[] };\n  }\n  if (raw && typeof raw === 'object' && Array.isArray((raw as SkillHubCuratedIndex).skills)) {\n    return raw as SkillHubCuratedIndex;\n  }\n  throw new Error('SkillHub index JSON must be an object with a skills array');\n}\n\nfunction sourceLabelFromHomepage(homepage?: string): string | undefined {\n  const h = homepage?.trim().toLowerCase() ?? '';\n  if (h.includes('clawhub')) return 'ClawHub';\n  if (h.includes('skillhub')) return 'SkillHub';\n  return undefined;\n}\n\nexport function curatedSkillsToPackageItems(skills: SkillHubCuratedIndexSkill[]): SkillHubEcosystemListItem[] {\n  return skills.map((s) => ({\n    id: s.slug,\n    name: (s.name ?? s.slug).trim() || s.slug,\n    type: 'skill',\n    description: (s.description ?? '').trim(),\n    downloads: typeof s.downloads === 'number' ? s.downloads : 0,\n    author: { username: 'skillhub', avatarUrl: null },\n    latestVersion: (s.version ?? '').trim() || undefined,\n    updatedAt: String(s.rank ?? s.score ?? 0),\n    categories: (s.categories ?? []).map((c) => String(c).trim()).filter(Boolean),\n    stars: typeof s.stars === 'number' ? s.stars : undefined,\n    sourceLabel: sourceLabelFromHomepage(s.homepage),\n  }));\n}\n\nexport interface LightmakeSearchHit {\n  slug: string;\n  displayName?: string;\n  name?: string;\n  summary?: string;\n  description?: string;\n  description_zh?: string;\n  version?: string;\n  downloads?: number;\n  installs?: number;\n  stars?: number;\n  owner_name?: string;\n  category?: string;\n  score?: number;\n  updatedAt?: number;\n  updated_at?: number;\n}\n\nfunction lightmakeHitToPackageItem(hit: LightmakeSearchHit): SkillHubEcosystemListItem {\n  const slug = String(hit.slug || '').trim();\n  const desc =\n    (hit.summary ?? hit.description_zh ?? hit.description ?? '').trim() || '';\n  const updated = hit.updatedAt ?? hit.updated_at ?? 0;\n  const cat = hit.category?.trim();\n  return {\n    id: slug,\n    name: (hit.displayName ?? hit.name ?? slug).trim() || slug,\n    type: 'skill',\n    description: desc,\n    downloads: typeof hit.downloads === 'number' ? hit.downloads : 0,\n    author: {\n      username: (hit.owner_name ?? 'skillhub').trim() || 'skillhub',\n      avatarUrl: null,\n    },\n    latestVersion: (hit.version ?? '').trim() || undefined,\n    updatedAt: String(updated),\n    categories: cat ? [cat] : [],\n    stars: typeof hit.stars === 'number' ? hit.stars : undefined,\n    sourceLabel: 'Lightmake',\n  };\n}\n\nexport async function searchSkillHubLightmake(\n  urls: SkillHubEcosystemUrls,\n  query: string,\n  limit: number,\n  timeoutMs = 8000,\n): Promise<SkillHubEcosystemListItem[]> {\n  const q = query.trim().toLowerCase();\n  if (!q) return [];\n\n  const search = new URL(urls.searchUrl);\n  if (search.protocol !== 'https:') {\n    throw new Error('SkillHub search URL must use HTTPS');\n  }\n  search.searchParams.set('q', q);\n  search.searchParams.set('limit', String(Math.max(1, Math.min(LIGHTMAKE_SEARCH_MAX, limit))));\n\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), timeoutMs);\n  try {\n    const raw = await fetchJson<{ results?: LightmakeSearchHit[] }>(search.toString(), {\n      signal: controller.signal,\n    });\n    const results = raw.results;\n    if (!Array.isArray(results)) {\n      return [];\n    }\n    const out: SkillHubEcosystemListItem[] = [];\n    for (const item of results) {\n      if (!item || typeof item !== 'object') continue;\n      const slug = String((item as LightmakeSearchHit).slug ?? '').trim();\n      if (!slug) continue;\n      out.push(lightmakeHitToPackageItem(item as LightmakeSearchHit));\n    }\n    return out;\n  } finally {\n    clearTimeout(timer);\n  }\n}\n\nexport async function downloadSkillHubZipFromAllowlistedUrl(\n  urls: SkillHubEcosystemUrls,\n  downloadUrl: string,\n): Promise<Buffer> {\n  const normalized = assertSkillHubDownloadUrlAllowed(downloadUrl, urls);\n  const res = await fetch(normalized.toString(), { redirect: 'follow' });\n  if (!res.ok) {\n    throw new Error(`Failed to download skill archive (${res.status})`);\n  }\n  const len = res.headers.get('content-length');\n  if (len) {\n    const n = Number(len);\n    if (Number.isFinite(n) && n > MAX_SKILL_ZIP_BYTES) {\n      throw new Error(`Zip exceeds maximum size (${MAX_SKILL_ZIP_BYTES} bytes)`);\n    }\n  }\n  const ab = await res.arrayBuffer();\n  const buf = Buffer.from(ab);\n  if (buf.length > MAX_SKILL_ZIP_BYTES) {\n    throw new Error(`Zip exceeds maximum size (${MAX_SKILL_ZIP_BYTES} bytes)`);\n  }\n  return buf;\n}\n\nexport async function downloadSkillHubZipFromEcosystem(\n  urls: SkillHubEcosystemUrls,\n  slug: string,\n): Promise<Buffer> {\n  const primary = templateWithSlug(urls.primaryDownloadTemplate, slug);\n  const fallback = templateWithSlug(urls.fallbackDownloadTemplate, slug);\n  const candidates = [primary, fallback].filter(Boolean);\n  const seen = new Set<string>();\n  let lastErr: Error | undefined;\n  for (const url of candidates) {\n    if (seen.has(url)) continue;\n    seen.add(url);\n    try {\n      return await downloadSkillHubZipFromAllowlistedUrl(urls, url);\n    } catch (e) {\n      lastErr = e instanceof Error ? e : new Error(String(e));\n    }\n  }\n  throw lastErr ?? new Error('SkillHub ecosystem download failed');\n}\n"],"mappings":"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"}

package/dist/src/agent/skills/marketplace/adapters/skillhub/registry-client.d.ts

@@ -0,0 +1,137 @@
+/**
+ * HTTP client for api.skillhub.cn (registry: detail, files, versions, batch, skillsets, download).
+ */
+/** Max bytes when fetching SKILL.md / README for marketplace preview (redirects to COS). */
+export declare const MAX_SKILLHUB_README_BYTES: number;
+/**
+ * Prefer SKILL.md, then README.md, then HOW_TO_USE.md (basename match, any directory depth).
+ */
+export declare function pickSkillHubDocFilePath(files: SkillHubFile[]): string | null;
+/**
+ * Fetches a single text file from the registry (follows redirect to COS when applicable).
+ */
+export declare function getSkillHubSkillFileText(slug: string, filePath: string, version?: string): Promise<string>;
+/** skillhub.cn skill metadata */
+export interface SkillHubSkill {
+    slug: string;
+    displayName: string;
+    summary: string;
+    summary_zh?: string;
+    category: string;
+    iconUrl: string | null;
+    source: string;
+    labels: {
+        requires_api_key?: string;
+    };
+    stats: {
+        downloads: number;
+        installs: number;
+        stars: number;
+        comments: number;
+        versions: number;
+    };
+    createdAt: number;
+    updatedAt: number;
+    tags: Record<string, string>;
+}
+export interface SkillHubSkillDetail {
+    skill: SkillHubSkill;
+    latestVersion: {
+        version: string;
+        changelog: string | null;
+        createdAt: number;
+        securityReports?: {
+            keen?: {
+                status: string;
+                statusText: string;
+                reportUrl?: string;
+            };
+            sanbu?: {
+                status: string;
+                statusText: string;
+                reportUrl?: string;
+            };
+        };
+    };
+    owner: {
+        handle: string;
+        displayName: string;
+        image: string | null;
+    };
+}
+export interface SkillHubFile {
+    path: string;
+    sha256: string;
+    size: number;
+}
+export interface SkillHubVersion {
+    slug: string;
+    version: string;
+    createdAt: number;
+    changelog: string | null;
+    securityReports?: {
+        keen?: {
+            status: string;
+            statusText: string;
+            reportUrl?: string;
+        };
+        sanbu?: {
+            status: string;
+            statusText: string;
+            reportUrl?: string;
+        };
+    };
+}
+export interface SkillHubSkillset {
+    id: number;
+    slug: string;
+    displayName: string;
+    summary: string;
+    scene: string;
+    subScene: string;
+    content: string;
+    skillSlugs: string[];
+    skillCount: number;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface SkillHubSkillsetListResponse {
+    skillSets: SkillHubSkillset[];
+    total: number;
+}
+/** Official taxonomy from GET /api/v1/categories (registry). */
+export interface SkillHubRegistryCategoryItem {
+    key: string;
+    name: string;
+    nameEn: string;
+    sortOrder: number;
+    active: boolean;
+}
+/**
+ * SkillHub registry category taxonomy (ids align with {@link SkillHubSkill.category}).
+ */
+export declare function listSkillHubRegistryCategories(): Promise<SkillHubRegistryCategoryItem[]>;
+export declare function getSkillHubSkill(slug: string): Promise<SkillHubSkillDetail>;
+export declare function getSkillHubSkillFiles(slug: string, version?: string): Promise<{
+    files: SkillHubFile[];
+    version: string;
+}>;
+export declare function getSkillHubSkillVersions(slug: string): Promise<SkillHubVersion[]>;
+export declare function downloadSkillHubZipBuffer(slug: string, version?: string): Promise<{
+    buffer: Buffer;
+    version: string;
+}>;
+export interface SkillHubSkillsetListParams {
+    page?: number;
+    pageSize?: number;
+    keyword?: string;
+    scene?: string;
+}
+export declare function listSkillHubSkillsets(opts?: SkillHubSkillsetListParams): Promise<SkillHubSkillsetListResponse>;
+export declare function getSkillHubSkillset(slug: string): Promise<SkillHubSkillset>;
+export declare function batchGetSkillHubSkills(slugs: string[]): Promise<SkillHubSkillDetail[]>;
+export declare function getDefaultSkillSlugs(): Promise<string[]>;
+export declare function searchSkillHubSkills(query: string, maxSlugs?: number): Promise<{
+    slugs: string[];
+    total: number;
+}>;

package/dist/src/agent/skills/marketplace/adapters/skillhub/registry-client.js

@@ -0,0 +1,217 @@
+import { MAX_SKILL_ZIP_BYTES } from "../../../managed-store.js";
+import { fetch } from "undici";
+//#region src/agent/skills/marketplace/adapters/skillhub/registry-client.ts
+/**
+* HTTP client for api.skillhub.cn (registry: detail, files, versions, batch, skillsets, download).
+*/
+const SKILLHUB_API_BASE = "https://api.skillhub.cn";
+/** Max bytes when fetching SKILL.md / README for marketplace preview (redirects to COS). */
+const MAX_SKILLHUB_README_BYTES = 512 * 1024;
+function basenameSkillPath(p) {
+	const norm = p.replace(/\\/g, "/");
+	const parts = norm.split("/");
+	return parts[parts.length - 1] || norm;
+}
+/**
+* Prefer SKILL.md, then README.md, then HOW_TO_USE.md (basename match, any directory depth).
+*/
+function pickSkillHubDocFilePath(files) {
+	const rows = files.map((f) => ({
+		path: f.path.replace(/\\/g, "/"),
+		base: basenameSkillPath(f.path).toLowerCase()
+	}));
+	const firstBase = (name) => rows.find((r) => r.base === name.toLowerCase());
+	const skillMd = firstBase("SKILL.md") ?? firstBase("skill.md");
+	if (skillMd) return skillMd.path;
+	const readme = firstBase("README.md") ?? firstBase("readme.md");
+	if (readme) return readme.path;
+	const how = firstBase("HOW_TO_USE.md");
+	if (how) return how.path;
+	return null;
+}
+function assertSkillHubReadmeResponseUrl(finalUrl) {
+	let u;
+	try {
+		u = new URL(finalUrl);
+	} catch {
+		throw new Error("Invalid SkillHub file response URL");
+	}
+	if (u.protocol !== "https:") throw new Error("SkillHub file response must use HTTPS");
+	const host = u.hostname.toLowerCase();
+	if (host === "api.skillhub.cn") return;
+	if (host.endsWith(".myqcloud.com")) return;
+	throw new Error("SkillHub file redirect host is not allowlisted");
+}
+/**
+* Fetches a single text file from the registry (follows redirect to COS when applicable).
+*/
+async function getSkillHubSkillFileText(slug, filePath, version) {
+	const enc = encodeURIComponent(slug.trim());
+	const normPath = filePath.replace(/\\/g, "/");
+	const sp = new URLSearchParams({ path: normPath });
+	if (version?.trim()) sp.set("version", version.trim());
+	const res = await fetch(`${SKILLHUB_API_BASE}/api/v1/skills/${enc}/file?${sp.toString()}`, {
+		redirect: "follow",
+		headers: { Accept: "text/markdown,text/plain,*/*" }
+	});
+	if (!res.ok) {
+		const text = await res.text().catch(() => "");
+		let msg = `SkillHub file request failed (${res.status})`;
+		try {
+			const j = JSON.parse(text);
+			if (typeof j.message === "string") msg = j.message;
+			else if (typeof j.error === "string") msg = j.error;
+		} catch {
+			if (text) msg = text.slice(0, 200);
+		}
+		throw new Error(msg);
+	}
+	assertSkillHubReadmeResponseUrl(res.url);
+	const len = res.headers.get("content-length");
+	if (len) {
+		const n = Number(len);
+		if (Number.isFinite(n) && n > 524288) throw new Error(`SkillHub file exceeds maximum size (${MAX_SKILLHUB_README_BYTES} bytes)`);
+	}
+	const ab = await res.arrayBuffer();
+	if (ab.byteLength > 524288) throw new Error(`SkillHub file exceeds maximum size (${MAX_SKILLHUB_README_BYTES} bytes)`);
+	return new TextDecoder("utf-8").decode(ab);
+}
+/**
+* SkillHub registry category taxonomy (ids align with {@link SkillHubSkill.category}).
+*/
+async function listSkillHubRegistryCategories() {
+	const raw = await fetchJson(`${SKILLHUB_API_BASE}/api/v1/categories`);
+	return (Array.isArray(raw.items) ? raw.items : []).filter((c) => c && typeof c.key === "string" && c.key.trim().length > 0 && c.active !== false);
+}
+async function fetchJson(url, init) {
+	const res = await fetch(url, {
+		...init,
+		headers: {
+			Accept: "application/json",
+			...init?.headers
+		}
+	});
+	const text = await res.text();
+	if (!res.ok) {
+		let msg = `SkillHub request failed (${res.status})`;
+		try {
+			const j = JSON.parse(text);
+			if (j.message) msg = j.message;
+			else if (j.error) msg = j.error;
+		} catch {
+			if (text) msg = text.slice(0, 200);
+		}
+		throw new Error(msg);
+	}
+	try {
+		return JSON.parse(text);
+	} catch {
+		throw new Error("SkillHub returned invalid JSON");
+	}
+}
+async function getSkillHubSkill(slug) {
+	return fetchJson(`${SKILLHUB_API_BASE}/api/v1/skills/${encodeURIComponent(slug.trim())}`);
+}
+async function getSkillHubSkillFiles(slug, version) {
+	return fetchJson(`${SKILLHUB_API_BASE}/api/v1/skills/${encodeURIComponent(slug.trim())}/files${version ? `?version=${encodeURIComponent(version)}` : ""}`);
+}
+async function getSkillHubSkillVersions(slug) {
+	return fetchJson(`${SKILLHUB_API_BASE}/api/v1/skills/${encodeURIComponent(slug.trim())}/versions`);
+}
+async function downloadSkillHubZipBuffer(slug, version) {
+	let url = `${SKILLHUB_API_BASE}/api/v1/download?slug=${encodeURIComponent(slug.trim())}`;
+	if (version?.trim()) url += `&version=${encodeURIComponent(version.trim())}`;
+	const res = await fetch(url, { redirect: "follow" });
+	if (!res.ok) throw new Error(`Failed to download skill archive (${res.status})`);
+	const len = res.headers.get("content-length");
+	if (len) {
+		const n = Number(len);
+		if (Number.isFinite(n) && n > 15728640) throw new Error(`Zip exceeds maximum size (${MAX_SKILL_ZIP_BYTES} bytes)`);
+	}
+	const ab = await res.arrayBuffer();
+	const buf = Buffer.from(ab);
+	if (buf.length > 15728640) throw new Error(`Zip exceeds maximum size (${MAX_SKILL_ZIP_BYTES} bytes)`);
+	let resolvedVersion = version ?? "1.0.0";
+	if (!version?.trim()) try {
+		resolvedVersion = (await getSkillHubSkillFiles(slug)).version;
+	} catch {}
+	return {
+		buffer: buf,
+		version: resolvedVersion
+	};
+}
+async function listSkillHubSkillsets(opts = {}) {
+	const page = opts.page ?? 1;
+	const pageSize = opts.pageSize ?? 20;
+	const sp = new URLSearchParams({
+		page: String(page),
+		pageSize: String(pageSize)
+	});
+	if (opts.keyword?.trim()) sp.set("keyword", opts.keyword.trim());
+	if (opts.scene?.trim()) sp.set("scene", opts.scene.trim());
+	return fetchJson(`${SKILLHUB_API_BASE}/api/v1/skillsets?${sp.toString()}`);
+}
+async function getSkillHubSkillset(slug) {
+	return fetchJson(`${SKILLHUB_API_BASE}/api/v1/skillsets/${encodeURIComponent(slug.trim())}`);
+}
+async function batchGetSkillHubSkills(slugs) {
+	if (slugs.length === 0) return [];
+	return (await fetchJson(`${SKILLHUB_API_BASE}/api/v1/skills/batch`, {
+		method: "POST",
+		headers: { "Content-Type": "application/json" },
+		body: JSON.stringify({ slugs })
+	})).items ?? [];
+}
+const SKILLSET_DISCOVERY_PAGE_CAP = 25;
+const MAX_DEFAULT_SLUGS = 200;
+async function getDefaultSkillSlugs() {
+	const slugs = /* @__PURE__ */ new Set();
+	let page = 1;
+	const pageSize = 50;
+	let total = Infinity;
+	while (page <= SKILLSET_DISCOVERY_PAGE_CAP && slugs.size < MAX_DEFAULT_SLUGS) {
+		const response = await listSkillHubSkillsets({
+			page,
+			pageSize
+		});
+		total = response.total;
+		for (const skillset of response.skillSets) for (const slug of skillset.skillSlugs) slugs.add(slug);
+		if (page * pageSize >= total) break;
+		page += 1;
+	}
+	return Array.from(slugs).slice(0, MAX_DEFAULT_SLUGS);
+}
+async function searchSkillHubSkills(query, maxSlugs = 200) {
+	const keyword = query.trim();
+	if (!keyword) return {
+		slugs: [],
+		total: 0
+	};
+	const slugs = [];
+	const seen = /* @__PURE__ */ new Set();
+	let page = 1;
+	const batchSize = 50;
+	while (page <= SKILLSET_DISCOVERY_PAGE_CAP) {
+		const response = await listSkillHubSkillsets({
+			page,
+			pageSize: batchSize,
+			keyword
+		});
+		const totalSkillsets = response.total;
+		for (const skillset of response.skillSets) for (const slug of skillset.skillSlugs) if (!seen.has(slug)) {
+			seen.add(slug);
+			slugs.push(slug);
+		}
+		if (page * batchSize >= totalSkillsets) break;
+		page += 1;
+	}
+	const capped = slugs.slice(0, maxSlugs);
+	return {
+		slugs: capped,
+		total: capped.length
+	};
+}
+//#endregion
+export { MAX_SKILLHUB_README_BYTES, batchGetSkillHubSkills, downloadSkillHubZipBuffer, getDefaultSkillSlugs, getSkillHubSkill, getSkillHubSkillFileText, getSkillHubSkillFiles, getSkillHubSkillVersions, getSkillHubSkillset, listSkillHubRegistryCategories, listSkillHubSkillsets, pickSkillHubDocFilePath, searchSkillHubSkills };
+
+//# sourceMappingURL=registry-client.js.map