@nextclaw/service 0.2.13 → 0.2.14

package/dist/utils/marketplace/marketplace-identity.utils.js

@@ -0,0 +1,79 @@
+//#region src/utils/marketplace/marketplace-identity.utils.ts
+function resolvePublishPackageName(params) {
+	const { explicitPackageName, explicitScope, slug, adminTokenPresent, currentUser } = params;
+	const normalizedExplicitPackageName = explicitPackageName?.trim();
+	if (normalizedExplicitPackageName) return resolveExplicitPackageName(normalizedExplicitPackageName, adminTokenPresent, currentUser);
+	const normalizedScope = explicitScope?.trim().toLowerCase();
+	if (normalizedScope) return resolveScopedPackageName(normalizedScope, slug, adminTokenPresent, currentUser);
+	return resolveDefaultPackageName(slug, adminTokenPresent, currentUser);
+}
+function resolveExplicitPackageName(packageName, adminTokenPresent, currentUser) {
+	const parsed = parsePackageName(packageName, "packageName");
+	if (parsed.scope === "nextclaw") {
+		assertOfficialScopeAllowed(adminTokenPresent, currentUser);
+		return packageName;
+	}
+	assertPersonalScopeAllowed(parsed.scope, currentUser);
+	return packageName;
+}
+function resolveScopedPackageName(scope, slug, adminTokenPresent, currentUser) {
+	if (scope === "nextclaw") {
+		assertOfficialScopeAllowed(adminTokenPresent, currentUser);
+		return `@nextclaw/${slug}`;
+	}
+	assertPersonalScopeAllowed(scope, currentUser);
+	return `@${scope}/${slug}`;
+}
+function resolveDefaultPackageName(slug, adminTokenPresent, currentUser) {
+	if (adminTokenPresent) return `@nextclaw/${slug}`;
+	return `@${requirePlatformUsername(currentUser)}/${slug}`;
+}
+function validateSkillSlug(raw, fieldName) {
+	if (!/^[A-Za-z0-9._-]+$/.test(raw)) throw new Error(`Invalid ${fieldName}: ${raw}`);
+	return raw;
+}
+function validateSkillSelector(raw, fieldName) {
+	if (raw.startsWith("@")) {
+		parsePackageName(raw, fieldName);
+		return raw;
+	}
+	return validateSkillSlug(raw, fieldName);
+}
+function normalizeTags(rawTags) {
+	const seen = /* @__PURE__ */ new Set();
+	const output = [];
+	for (const rawTag of rawTags ?? []) {
+		const tag = rawTag.trim();
+		if (!tag || seen.has(tag)) continue;
+		seen.add(tag);
+		output.push(tag);
+	}
+	return output.length > 0 ? output : ["skill"];
+}
+function canPublishOfficialScope(adminTokenPresent, currentUser) {
+	return adminTokenPresent || currentUser?.user.role === "admin";
+}
+function assertOfficialScopeAllowed(adminTokenPresent, currentUser) {
+	if (!canPublishOfficialScope(adminTokenPresent, currentUser)) throw new Error("Publishing to @nextclaw/* requires admin permission.");
+}
+function assertPersonalScopeAllowed(scope, currentUser) {
+	const username = requirePlatformUsername(currentUser);
+	if (scope !== username) throw new Error(`Personal publish scope must match your username: @${username}/*`);
+}
+function requirePlatformUsername(currentUser) {
+	const username = currentUser?.user.username;
+	if (!username) throw new Error("Set your NextClaw username before publishing personal skills. Open NextClaw Web account settings: https://platform.nextclaw.io/account or run `nextclaw account set-username <username>`.");
+	return username;
+}
+function parsePackageName(raw, fieldName) {
+	const match = raw.match(/^@([a-z0-9](?:[a-z0-9-]{1,30}[a-z0-9])?)\/([A-Za-z0-9._-]+)$/);
+	if (!match) throw new Error(`Invalid ${fieldName}: ${raw}`);
+	return {
+		scope: match[1],
+		name: match[2]
+	};
+}
+//#endregion
+export { normalizeTags, resolvePublishPackageName, validateSkillSelector, validateSkillSlug };
+
+//# sourceMappingURL=marketplace-identity.utils.js.map

package/dist/utils/marketplace/marketplace-identity.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace-identity.utils.js","names":[],"sources":["../../../src/utils/marketplace/marketplace-identity.utils.ts"],"sourcesContent":["import type { PlatformMeResult } from \"@nextclaw-service/controllers/commands/platform-auth-command.controller.js\";\n\nexport function resolvePublishPackageName(params: {\n  explicitPackageName?: string;\n  explicitScope?: string;\n  slug: string;\n  adminTokenPresent: boolean;\n  currentUser: PlatformMeResult | null;\n}): string {\n  const {\n    explicitPackageName,\n    explicitScope,\n    slug,\n    adminTokenPresent,\n    currentUser\n  } = params;\n  const normalizedExplicitPackageName = explicitPackageName?.trim();\n  if (normalizedExplicitPackageName) {\n    return resolveExplicitPackageName(normalizedExplicitPackageName, adminTokenPresent, currentUser);\n  }\n\n  const normalizedScope = explicitScope?.trim().toLowerCase();\n  if (normalizedScope) {\n    return resolveScopedPackageName(normalizedScope, slug, adminTokenPresent, currentUser);\n  }\n\n  return resolveDefaultPackageName(slug, adminTokenPresent, currentUser);\n}\n\nfunction resolveExplicitPackageName(\n  packageName: string,\n  adminTokenPresent: boolean,\n  currentUser: PlatformMeResult | null\n): string {\n  const parsed = parsePackageName(packageName, \"packageName\");\n  if (parsed.scope === \"nextclaw\") {\n    assertOfficialScopeAllowed(adminTokenPresent, currentUser);\n    return packageName;\n  }\n  assertPersonalScopeAllowed(parsed.scope, currentUser);\n  return packageName;\n}\n\nfunction resolveScopedPackageName(\n  scope: string,\n  slug: string,\n  adminTokenPresent: boolean,\n  currentUser: PlatformMeResult | null\n): string {\n  if (scope === \"nextclaw\") {\n    assertOfficialScopeAllowed(adminTokenPresent, currentUser);\n    return `@nextclaw/${slug}`;\n  }\n  assertPersonalScopeAllowed(scope, currentUser);\n  return `@${scope}/${slug}`;\n}\n\nfunction resolveDefaultPackageName(\n  slug: string,\n  adminTokenPresent: boolean,\n  currentUser: PlatformMeResult | null\n): string {\n  if (adminTokenPresent) {\n    return `@nextclaw/${slug}`;\n  }\n  const username = requirePlatformUsername(currentUser);\n  return `@${username}/${slug}`;\n}\n\nexport function validateSkillSlug(raw: string, fieldName: string): string {\n  if (!/^[A-Za-z0-9._-]+$/.test(raw)) {\n    throw new Error(`Invalid ${fieldName}: ${raw}`);\n  }\n  return raw;\n}\n\nexport function validateSkillSelector(raw: string, fieldName: string): string {\n  if (raw.startsWith(\"@\")) {\n    parsePackageName(raw, fieldName);\n    return raw;\n  }\n  return validateSkillSlug(raw, fieldName);\n}\n\nexport function normalizeTags(rawTags: string[] | undefined): string[] {\n  const seen = new Set<string>();\n  const output: string[] = [];\n  for (const rawTag of rawTags ?? []) {\n    const tag = rawTag.trim();\n    if (!tag || seen.has(tag)) {\n      continue;\n    }\n    seen.add(tag);\n    output.push(tag);\n  }\n  return output.length > 0 ? output : [\"skill\"];\n}\n\nfunction canPublishOfficialScope(\n  adminTokenPresent: boolean,\n  currentUser: PlatformMeResult | null\n): boolean {\n  return adminTokenPresent || currentUser?.user.role === \"admin\";\n}\n\nfunction assertOfficialScopeAllowed(adminTokenPresent: boolean, currentUser: PlatformMeResult | null): void {\n  if (!canPublishOfficialScope(adminTokenPresent, currentUser)) {\n    throw new Error(\"Publishing to @nextclaw/* requires admin permission.\");\n  }\n}\n\nfunction assertPersonalScopeAllowed(scope: string, currentUser: PlatformMeResult | null): void {\n  const username = requirePlatformUsername(currentUser);\n  if (scope !== username) {\n    throw new Error(`Personal publish scope must match your username: @${username}/*`);\n  }\n}\n\nfunction requirePlatformUsername(currentUser: PlatformMeResult | null): string {\n  const username = currentUser?.user.username;\n  if (!username) {\n    throw new Error(\n      \"Set your NextClaw username before publishing personal skills. \"\n      + \"Open NextClaw Web account settings: https://platform.nextclaw.io/account \"\n      + \"or run `nextclaw account set-username <username>`.\"\n    );\n  }\n  return username;\n}\n\nfunction parsePackageName(raw: string, fieldName: string): { scope: string; name: string } {\n  const match = raw.match(/^@([a-z0-9](?:[a-z0-9-]{1,30}[a-z0-9])?)\\/([A-Za-z0-9._-]+)$/);\n  if (!match) {\n    throw new Error(`Invalid ${fieldName}: ${raw}`);\n  }\n  return {\n    scope: match[1],\n    name: match[2]\n  };\n}\n"],"mappings":";AAEA,SAAgB,0BAA0B,QAM/B;CACT,MAAM,EACJ,qBACA,eACA,MACA,mBACA,gBACE;CACJ,MAAM,gCAAgC,qBAAqB,MAAM;AACjE,KAAI,8BACF,QAAO,2BAA2B,+BAA+B,mBAAmB,YAAY;CAGlG,MAAM,kBAAkB,eAAe,MAAM,CAAC,aAAa;AAC3D,KAAI,gBACF,QAAO,yBAAyB,iBAAiB,MAAM,mBAAmB,YAAY;AAGxF,QAAO,0BAA0B,MAAM,mBAAmB,YAAY;;AAGxE,SAAS,2BACP,aACA,mBACA,aACQ;CACR,MAAM,SAAS,iBAAiB,aAAa,cAAc;AAC3D,KAAI,OAAO,UAAU,YAAY;AAC/B,6BAA2B,mBAAmB,YAAY;AAC1D,SAAO;;AAET,4BAA2B,OAAO,OAAO,YAAY;AACrD,QAAO;;AAGT,SAAS,yBACP,OACA,MACA,mBACA,aACQ;AACR,KAAI,UAAU,YAAY;AACxB,6BAA2B,mBAAmB,YAAY;AAC1D,SAAO,aAAa;;AAEtB,4BAA2B,OAAO,YAAY;AAC9C,QAAO,IAAI,MAAM,GAAG;;AAGtB,SAAS,0BACP,MACA,mBACA,aACQ;AACR,KAAI,kBACF,QAAO,aAAa;AAGtB,QAAO,IADU,wBAAwB,YAAY,CACjC,GAAG;;AAGzB,SAAgB,kBAAkB,KAAa,WAA2B;AACxE,KAAI,CAAC,oBAAoB,KAAK,IAAI,CAChC,OAAM,IAAI,MAAM,WAAW,UAAU,IAAI,MAAM;AAEjD,QAAO;;AAGT,SAAgB,sBAAsB,KAAa,WAA2B;AAC5E,KAAI,IAAI,WAAW,IAAI,EAAE;AACvB,mBAAiB,KAAK,UAAU;AAChC,SAAO;;AAET,QAAO,kBAAkB,KAAK,UAAU;;AAG1C,SAAgB,cAAc,SAAyC;CACrE,MAAM,uBAAO,IAAI,KAAa;CAC9B,MAAM,SAAmB,EAAE;AAC3B,MAAK,MAAM,UAAU,WAAW,EAAE,EAAE;EAClC,MAAM,MAAM,OAAO,MAAM;AACzB,MAAI,CAAC,OAAO,KAAK,IAAI,IAAI,CACvB;AAEF,OAAK,IAAI,IAAI;AACb,SAAO,KAAK,IAAI;;AAElB,QAAO,OAAO,SAAS,IAAI,SAAS,CAAC,QAAQ;;AAG/C,SAAS,wBACP,mBACA,aACS;AACT,QAAO,qBAAqB,aAAa,KAAK,SAAS;;AAGzD,SAAS,2BAA2B,mBAA4B,aAA4C;AAC1G,KAAI,CAAC,wBAAwB,mBAAmB,YAAY,CAC1D,OAAM,IAAI,MAAM,uDAAuD;;AAI3E,SAAS,2BAA2B,OAAe,aAA4C;CAC7F,MAAM,WAAW,wBAAwB,YAAY;AACrD,KAAI,UAAU,SACZ,OAAM,IAAI,MAAM,qDAAqD,SAAS,IAAI;;AAItF,SAAS,wBAAwB,aAA8C;CAC7E,MAAM,WAAW,aAAa,KAAK;AACnC,KAAI,CAAC,SACH,OAAM,IAAI,MACR,4LAGD;AAEH,QAAO;;AAGT,SAAS,iBAAiB,KAAa,WAAoD;CACzF,MAAM,QAAQ,IAAI,MAAM,+DAA+D;AACvF,KAAI,CAAC,MACH,OAAM,IAAI,MAAM,WAAW,UAAU,IAAI,MAAM;AAEjD,QAAO;EACL,OAAO,MAAM;EACb,MAAM,MAAM;EACb"}

package/dist/utils/marketplace/marketplace-metadata.utils.d.ts

@@ -0,0 +1,21 @@
+import { LocalizedTextMap, buildLocalizedTextMap, parseSkillFrontmatter } from "@nextclaw/kernel";
+
+//#region src/utils/marketplace/marketplace-metadata.utils.d.ts
+type MarketplaceSkillPublishMetadata = {
+  slug?: string;
+  name?: string;
+  summary?: string;
+  summaryI18n?: LocalizedTextMap;
+  description?: string;
+  descriptionI18n?: LocalizedTextMap;
+  author?: string;
+  tags?: string[];
+  sourceRepo?: string;
+  homepage?: string;
+  publishedAt?: string;
+  updatedAt?: string;
+};
+declare function readMarketplaceMetadataFile(skillDir: string, explicitMetaFile?: string): MarketplaceSkillPublishMetadata;
+//#endregion
+export { type LocalizedTextMap, MarketplaceSkillPublishMetadata, buildLocalizedTextMap, parseSkillFrontmatter, readMarketplaceMetadataFile };
+//# sourceMappingURL=marketplace-metadata.utils.d.ts.map

package/dist/utils/marketplace/marketplace-metadata.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace-metadata.utils.d.ts","names":[],"sources":["../../../src/utils/marketplace/marketplace-metadata.utils.ts"],"mappings":";;;KAgBY,+BAAA;EACV,IAAA;EACA,IAAA;EACA,OAAA;EACA,WAAA,GAAc,gBAAA;EACd,WAAA;EACA,eAAA,GAAkB,gBAAA;EAClB,MAAA;EACA,IAAA;EACA,UAAA;EACA,QAAA;EACA,WAAA;EACA,SAAA;AAAA;AAAA,iBAGc,2BAAA,CACd,QAAA,UACA,gBAAA,YACC,+BAAA"}

package/dist/utils/marketplace/marketplace-metadata.utils.js

@@ -0,0 +1,74 @@
+import { buildLocalizedTextMap, parseSkillFrontmatter } from "@nextclaw/kernel";
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+//#region src/utils/marketplace/marketplace-metadata.utils.ts
+const DEFAULT_MARKETPLACE_META_FILENAME = "marketplace.json";
+function readMarketplaceMetadataFile(skillDir, explicitMetaFile) {
+	const metadataPath = resolveMarketplaceMetadataPath(skillDir, explicitMetaFile);
+	if (!metadataPath) return {};
+	let parsed;
+	try {
+		parsed = JSON.parse(readFileSync(metadataPath, "utf8"));
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		throw new Error(`Invalid marketplace metadata file: ${metadataPath} (${message})`);
+	}
+	if (!isRecord(parsed)) throw new Error(`Invalid marketplace metadata file: ${metadataPath} (root must be an object)`);
+	return {
+		slug: readMetadataString(parsed, "slug"),
+		name: readMetadataString(parsed, "name"),
+		summary: readMetadataString(parsed, "summary"),
+		summaryI18n: readMetadataLocalizedTextMap(parsed, "summaryI18n"),
+		description: readMetadataString(parsed, "description"),
+		descriptionI18n: readMetadataLocalizedTextMap(parsed, "descriptionI18n"),
+		author: readMetadataString(parsed, "author"),
+		tags: readMetadataStringArray(parsed, "tags"),
+		sourceRepo: readMetadataString(parsed, "sourceRepo"),
+		homepage: readMetadataString(parsed, "homepage"),
+		publishedAt: readMetadataString(parsed, "publishedAt"),
+		updatedAt: readMetadataString(parsed, "updatedAt")
+	};
+}
+function resolveMarketplaceMetadataPath(skillDir, explicitMetaFile) {
+	const resolved = explicitMetaFile?.trim() ? resolve(explicitMetaFile) : resolve(skillDir, DEFAULT_MARKETPLACE_META_FILENAME);
+	return existsSync(resolved) ? resolved : void 0;
+}
+function readMetadataString(record, fieldName) {
+	const value = record[fieldName];
+	if (value == null) return;
+	if (typeof value !== "string") throw new Error(`Invalid marketplace metadata field: ${fieldName} must be a string`);
+	return value.trim() || void 0;
+}
+function readMetadataStringArray(record, fieldName) {
+	const value = record[fieldName];
+	if (value == null) return;
+	if (!Array.isArray(value)) throw new Error(`Invalid marketplace metadata field: ${fieldName} must be an array`);
+	const tags = value.map((entry, index) => {
+		if (typeof entry !== "string") throw new Error(`Invalid marketplace metadata field: ${fieldName}[${index}] must be a string`);
+		return entry.trim();
+	}).filter(Boolean);
+	return tags.length > 0 ? tags : void 0;
+}
+function readMetadataLocalizedTextMap(record, fieldName) {
+	const value = record[fieldName];
+	if (value == null) return;
+	if (!isRecord(value)) throw new Error(`Invalid marketplace metadata field: ${fieldName} must be an object`);
+	const localized = {};
+	for (const [locale, text] of Object.entries(value)) {
+		if (typeof text !== "string") throw new Error(`Invalid marketplace metadata field: ${fieldName}.${locale} must be a string`);
+		const normalized = text.trim();
+		if (!normalized) continue;
+		localized[normalizeLocaleTag(locale)] = normalized;
+	}
+	return Object.keys(localized).length > 0 ? localized : void 0;
+}
+function normalizeLocaleTag(raw) {
+	return raw.trim().toLowerCase();
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//#endregion
+export { buildLocalizedTextMap, parseSkillFrontmatter, readMarketplaceMetadataFile };
+
+//# sourceMappingURL=marketplace-metadata.utils.js.map

package/dist/utils/marketplace/marketplace-metadata.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace-metadata.utils.js","names":[],"sources":["../../../src/utils/marketplace/marketplace-metadata.utils.ts"],"sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport {\n  buildLocalizedTextMap,\n  parseSkillFrontmatter,\n  type LocalizedTextMap,\n} from \"@nextclaw/kernel\";\n\nconst DEFAULT_MARKETPLACE_META_FILENAME = \"marketplace.json\";\n\nexport {\n  buildLocalizedTextMap,\n  parseSkillFrontmatter,\n  type LocalizedTextMap,\n};\n\nexport type MarketplaceSkillPublishMetadata = {\n  slug?: string;\n  name?: string;\n  summary?: string;\n  summaryI18n?: LocalizedTextMap;\n  description?: string;\n  descriptionI18n?: LocalizedTextMap;\n  author?: string;\n  tags?: string[];\n  sourceRepo?: string;\n  homepage?: string;\n  publishedAt?: string;\n  updatedAt?: string;\n};\n\nexport function readMarketplaceMetadataFile(\n  skillDir: string,\n  explicitMetaFile?: string\n): MarketplaceSkillPublishMetadata {\n  const metadataPath = resolveMarketplaceMetadataPath(skillDir, explicitMetaFile);\n  if (!metadataPath) {\n    return {};\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(readFileSync(metadataPath, \"utf8\"));\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    throw new Error(`Invalid marketplace metadata file: ${metadataPath} (${message})`);\n  }\n\n  if (!isRecord(parsed)) {\n    throw new Error(`Invalid marketplace metadata file: ${metadataPath} (root must be an object)`);\n  }\n\n  return {\n    slug: readMetadataString(parsed, \"slug\"),\n    name: readMetadataString(parsed, \"name\"),\n    summary: readMetadataString(parsed, \"summary\"),\n    summaryI18n: readMetadataLocalizedTextMap(parsed, \"summaryI18n\"),\n    description: readMetadataString(parsed, \"description\"),\n    descriptionI18n: readMetadataLocalizedTextMap(parsed, \"descriptionI18n\"),\n    author: readMetadataString(parsed, \"author\"),\n    tags: readMetadataStringArray(parsed, \"tags\"),\n    sourceRepo: readMetadataString(parsed, \"sourceRepo\"),\n    homepage: readMetadataString(parsed, \"homepage\"),\n    publishedAt: readMetadataString(parsed, \"publishedAt\"),\n    updatedAt: readMetadataString(parsed, \"updatedAt\")\n  };\n}\n\nfunction resolveMarketplaceMetadataPath(skillDir: string, explicitMetaFile?: string): string | undefined {\n  const resolved = explicitMetaFile?.trim()\n    ? resolve(explicitMetaFile)\n    : resolve(skillDir, DEFAULT_MARKETPLACE_META_FILENAME);\n  return existsSync(resolved) ? resolved : undefined;\n}\n\nfunction readMetadataString(record: Record<string, unknown>, fieldName: string): string | undefined {\n  const value = record[fieldName];\n  if (value == null) {\n    return undefined;\n  }\n  if (typeof value !== \"string\") {\n    throw new Error(`Invalid marketplace metadata field: ${fieldName} must be a string`);\n  }\n  const normalized = value.trim();\n  return normalized || undefined;\n}\n\nfunction readMetadataStringArray(record: Record<string, unknown>, fieldName: string): string[] | undefined {\n  const value = record[fieldName];\n  if (value == null) {\n    return undefined;\n  }\n  if (!Array.isArray(value)) {\n    throw new Error(`Invalid marketplace metadata field: ${fieldName} must be an array`);\n  }\n  const tags = value.map((entry, index) => {\n    if (typeof entry !== \"string\") {\n      throw new Error(`Invalid marketplace metadata field: ${fieldName}[${index}] must be a string`);\n    }\n    return entry.trim();\n  }).filter(Boolean);\n  return tags.length > 0 ? tags : undefined;\n}\n\nfunction readMetadataLocalizedTextMap(record: Record<string, unknown>, fieldName: string): LocalizedTextMap | undefined {\n  const value = record[fieldName];\n  if (value == null) {\n    return undefined;\n  }\n  if (!isRecord(value)) {\n    throw new Error(`Invalid marketplace metadata field: ${fieldName} must be an object`);\n  }\n  const localized: LocalizedTextMap = {};\n  for (const [locale, text] of Object.entries(value)) {\n    if (typeof text !== \"string\") {\n      throw new Error(`Invalid marketplace metadata field: ${fieldName}.${locale} must be a string`);\n    }\n    const normalized = text.trim();\n    if (!normalized) {\n      continue;\n    }\n    localized[normalizeLocaleTag(locale)] = normalized;\n  }\n  return Object.keys(localized).length > 0 ? localized : undefined;\n}\n\nfunction normalizeLocaleTag(raw: string): string {\n  return raw.trim().toLowerCase();\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"],"mappings":";;;;AAQA,MAAM,oCAAoC;AAuB1C,SAAgB,4BACd,UACA,kBACiC;CACjC,MAAM,eAAe,+BAA+B,UAAU,iBAAiB;AAC/E,KAAI,CAAC,aACH,QAAO,EAAE;CAGX,IAAI;AACJ,KAAI;AACF,WAAS,KAAK,MAAM,aAAa,cAAc,OAAO,CAAC;UAChD,OAAO;EACd,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACtE,QAAM,IAAI,MAAM,sCAAsC,aAAa,IAAI,QAAQ,GAAG;;AAGpF,KAAI,CAAC,SAAS,OAAO,CACnB,OAAM,IAAI,MAAM,sCAAsC,aAAa,2BAA2B;AAGhG,QAAO;EACL,MAAM,mBAAmB,QAAQ,OAAO;EACxC,MAAM,mBAAmB,QAAQ,OAAO;EACxC,SAAS,mBAAmB,QAAQ,UAAU;EAC9C,aAAa,6BAA6B,QAAQ,cAAc;EAChE,aAAa,mBAAmB,QAAQ,cAAc;EACtD,iBAAiB,6BAA6B,QAAQ,kBAAkB;EACxE,QAAQ,mBAAmB,QAAQ,SAAS;EAC5C,MAAM,wBAAwB,QAAQ,OAAO;EAC7C,YAAY,mBAAmB,QAAQ,aAAa;EACpD,UAAU,mBAAmB,QAAQ,WAAW;EAChD,aAAa,mBAAmB,QAAQ,cAAc;EACtD,WAAW,mBAAmB,QAAQ,YAAY;EACnD;;AAGH,SAAS,+BAA+B,UAAkB,kBAA+C;CACvG,MAAM,WAAW,kBAAkB,MAAM,GACrC,QAAQ,iBAAiB,GACzB,QAAQ,UAAU,kCAAkC;AACxD,QAAO,WAAW,SAAS,GAAG,WAAW,KAAA;;AAG3C,SAAS,mBAAmB,QAAiC,WAAuC;CAClG,MAAM,QAAQ,OAAO;AACrB,KAAI,SAAS,KACX;AAEF,KAAI,OAAO,UAAU,SACnB,OAAM,IAAI,MAAM,uCAAuC,UAAU,mBAAmB;AAGtF,QADmB,MAAM,MAAM,IACV,KAAA;;AAGvB,SAAS,wBAAwB,QAAiC,WAAyC;CACzG,MAAM,QAAQ,OAAO;AACrB,KAAI,SAAS,KACX;AAEF,KAAI,CAAC,MAAM,QAAQ,MAAM,CACvB,OAAM,IAAI,MAAM,uCAAuC,UAAU,mBAAmB;CAEtF,MAAM,OAAO,MAAM,KAAK,OAAO,UAAU;AACvC,MAAI,OAAO,UAAU,SACnB,OAAM,IAAI,MAAM,uCAAuC,UAAU,GAAG,MAAM,oBAAoB;AAEhG,SAAO,MAAM,MAAM;GACnB,CAAC,OAAO,QAAQ;AAClB,QAAO,KAAK,SAAS,IAAI,OAAO,KAAA;;AAGlC,SAAS,6BAA6B,QAAiC,WAAiD;CACtH,MAAM,QAAQ,OAAO;AACrB,KAAI,SAAS,KACX;AAEF,KAAI,CAAC,SAAS,MAAM,CAClB,OAAM,IAAI,MAAM,uCAAuC,UAAU,oBAAoB;CAEvF,MAAM,YAA8B,EAAE;AACtC,MAAK,MAAM,CAAC,QAAQ,SAAS,OAAO,QAAQ,MAAM,EAAE;AAClD,MAAI,OAAO,SAAS,SAClB,OAAM,IAAI,MAAM,uCAAuC,UAAU,GAAG,OAAO,mBAAmB;EAEhG,MAAM,aAAa,KAAK,MAAM;AAC9B,MAAI,CAAC,WACH;AAEF,YAAU,mBAAmB,OAAO,IAAI;;AAE1C,QAAO,OAAO,KAAK,UAAU,CAAC,SAAS,IAAI,YAAY,KAAA;;AAGzD,SAAS,mBAAmB,KAAqB;AAC/C,QAAO,IAAI,MAAM,CAAC,aAAa;;AAGjC,SAAS,SAAS,OAAkD;AAClE,QAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,MAAM"}

package/dist/utils/marketplace/marketplace-network-retry.utils.d.ts

@@ -0,0 +1,5 @@
+//#region src/utils/marketplace/marketplace-network-retry.utils.d.ts
+declare function runWithMarketplaceNetworkRetry<T>(action: () => Promise<T>): Promise<T>;
+//#endregion
+export { runWithMarketplaceNetworkRetry };
+//# sourceMappingURL=marketplace-network-retry.utils.d.ts.map

package/dist/utils/marketplace/marketplace-network-retry.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace-network-retry.utils.d.ts","names":[],"sources":["../../../src/utils/marketplace/marketplace-network-retry.utils.ts"],"mappings":";iBAoCsB,8BAAA,GAAA,CAAkC,MAAA,QAAc,OAAA,CAAQ,CAAA,IAAK,OAAA,CAAQ,CAAA"}

package/dist/utils/marketplace/marketplace-network-retry.utils.js

@@ -0,0 +1,34 @@
+//#region src/utils/marketplace/marketplace-network-retry.utils.ts
+const MARKETPLACE_NETWORK_RETRY_ATTEMPTS = 5;
+const MARKETPLACE_NETWORK_RETRY_BASE_MS = 350;
+function sleepMs(ms) {
+	return new Promise((resolve) => {
+		setTimeout(resolve, ms);
+	});
+}
+function isRetryableMarketplaceNetworkError(error) {
+	if (!(error instanceof Error)) return false;
+	if (error.name === "AbortError") return false;
+	const cause = error.cause;
+	if (cause && typeof cause === "object" && cause !== null && "code" in cause) {
+		const code = cause.code;
+		if (code === "ECONNRESET" || code === "ECONNREFUSED" || code === "ETIMEDOUT" || code === "EPIPE" || code === "ENOTFOUND" || code === "EAI_AGAIN") return true;
+	}
+	if (error instanceof TypeError && error.message === "fetch failed") return true;
+	return false;
+}
+async function runWithMarketplaceNetworkRetry(action) {
+	let last;
+	for (let attempt = 1; attempt <= MARKETPLACE_NETWORK_RETRY_ATTEMPTS; attempt++) try {
+		return await action();
+	} catch (error) {
+		last = error;
+		if (attempt === MARKETPLACE_NETWORK_RETRY_ATTEMPTS || !isRetryableMarketplaceNetworkError(error)) throw error;
+		await sleepMs(MARKETPLACE_NETWORK_RETRY_BASE_MS * 2 ** (attempt - 1));
+	}
+	throw last;
+}
+//#endregion
+export { runWithMarketplaceNetworkRetry };
+
+//# sourceMappingURL=marketplace-network-retry.utils.js.map

package/dist/utils/marketplace/marketplace-network-retry.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace-network-retry.utils.js","names":[],"sources":["../../../src/utils/marketplace/marketplace-network-retry.utils.ts"],"sourcesContent":["const MARKETPLACE_NETWORK_RETRY_ATTEMPTS = 5;\nconst MARKETPLACE_NETWORK_RETRY_BASE_MS = 350;\n\nfunction sleepMs(ms: number): Promise<void> {\n  return new Promise((resolve) => {\n    setTimeout(resolve, ms);\n  });\n}\n\nfunction isRetryableMarketplaceNetworkError(error: unknown): boolean {\n  if (!(error instanceof Error)) {\n    return false;\n  }\n  if (error.name === \"AbortError\") {\n    return false;\n  }\n  const cause = (error as Error & { cause?: unknown }).cause;\n  if (cause && typeof cause === \"object\" && cause !== null && \"code\" in cause) {\n    const code = (cause as { code?: unknown }).code;\n    if (\n      code === \"ECONNRESET\"\n      || code === \"ECONNREFUSED\"\n      || code === \"ETIMEDOUT\"\n      || code === \"EPIPE\"\n      || code === \"ENOTFOUND\"\n      || code === \"EAI_AGAIN\"\n    ) {\n      return true;\n    }\n  }\n  if (error instanceof TypeError && error.message === \"fetch failed\") {\n    return true;\n  }\n  return false;\n}\n\nexport async function runWithMarketplaceNetworkRetry<T>(action: () => Promise<T>): Promise<T> {\n  let last: unknown;\n  for (let attempt = 1; attempt <= MARKETPLACE_NETWORK_RETRY_ATTEMPTS; attempt++) {\n    try {\n      return await action();\n    } catch (error) {\n      last = error;\n      if (attempt === MARKETPLACE_NETWORK_RETRY_ATTEMPTS || !isRetryableMarketplaceNetworkError(error)) {\n        throw error;\n      }\n      await sleepMs(MARKETPLACE_NETWORK_RETRY_BASE_MS * 2 ** (attempt - 1));\n    }\n  }\n  throw last;\n}\n"],"mappings":";AAAA,MAAM,qCAAqC;AAC3C,MAAM,oCAAoC;AAE1C,SAAS,QAAQ,IAA2B;AAC1C,QAAO,IAAI,SAAS,YAAY;AAC9B,aAAW,SAAS,GAAG;GACvB;;AAGJ,SAAS,mCAAmC,OAAyB;AACnE,KAAI,EAAE,iBAAiB,OACrB,QAAO;AAET,KAAI,MAAM,SAAS,aACjB,QAAO;CAET,MAAM,QAAS,MAAsC;AACrD,KAAI,SAAS,OAAO,UAAU,YAAY,UAAU,QAAQ,UAAU,OAAO;EAC3E,MAAM,OAAQ,MAA6B;AAC3C,MACE,SAAS,gBACN,SAAS,kBACT,SAAS,eACT,SAAS,WACT,SAAS,eACT,SAAS,YAEZ,QAAO;;AAGX,KAAI,iBAAiB,aAAa,MAAM,YAAY,eAClD,QAAO;AAET,QAAO;;AAGT,eAAsB,+BAAkC,QAAsC;CAC5F,IAAI;AACJ,MAAK,IAAI,UAAU,GAAG,WAAW,oCAAoC,UACnE,KAAI;AACF,SAAO,MAAM,QAAQ;UACd,OAAO;AACd,SAAO;AACP,MAAI,YAAY,sCAAsC,CAAC,mCAAmC,MAAM,CAC9F,OAAM;AAER,QAAM,QAAQ,oCAAoC,MAAM,UAAU,GAAG;;AAGzE,OAAM"}

package/dist/utils/marketplace/marketplace-skill-lifecycle.utils.d.ts

@@ -0,0 +1,27 @@
+import { MarketplaceSkillUpdateStatus } from "../../stores/marketplace-install-state.store.js";
+
+//#region src/utils/marketplace/marketplace-skill-lifecycle.utils.d.ts
+type MarketplaceSkillInstallKind = "builtin" | "marketplace";
+type MarketplaceSkillInstallOptions = {
+  slug: string;
+  workdir: string;
+  dir?: string;
+  force?: boolean;
+  apiBaseUrl?: string;
+};
+declare function installMarketplaceSkill(options: MarketplaceSkillInstallOptions): Promise<{
+  slug: string;
+  destinationDir: string;
+  alreadyInstalled?: boolean;
+  source: MarketplaceSkillInstallKind;
+}>;
+declare function updateInstalledMarketplaceSkill(options: MarketplaceSkillInstallOptions): Promise<{
+  slug: string;
+  destinationDir: string;
+  updated: boolean;
+  source: MarketplaceSkillInstallKind;
+  status: MarketplaceSkillUpdateStatus;
+}>;
+//#endregion
+export { MarketplaceSkillInstallOptions, installMarketplaceSkill, updateInstalledMarketplaceSkill };
+//# sourceMappingURL=marketplace-skill-lifecycle.utils.d.ts.map

package/dist/utils/marketplace/marketplace-skill-lifecycle.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace-skill-lifecycle.utils.d.ts","names":[],"sources":["../../../src/utils/marketplace/marketplace-skill-lifecycle.utils.ts"],"mappings":";;;KAsBK,2BAAA;AAAA,KAEO,8BAAA;EACV,IAAA;EACA,OAAA;EACA,GAAA;EACA,KAAA;EACA,UAAA;AAAA;AAAA,iBAGoB,uBAAA,CAAwB,OAAA,EAAS,8BAAA,GAAiC,OAAA;EACtF,IAAA;EACA,cAAA;EACA,gBAAA;EACA,MAAA,EAAQ,2BAAA;AAAA;AAAA,iBAyDY,+BAAA,CAAgC,OAAA,EAAS,8BAAA,GAAiC,OAAA;EAC9F,IAAA;EACA,cAAA;EACA,OAAA;EACA,MAAA,EAAQ,2BAAA;EACR,MAAA,EAAQ,4BAAA;AAAA"}

package/dist/utils/marketplace/marketplace-skill-lifecycle.utils.js

@@ -0,0 +1,206 @@
+import { buildMarketplaceSkillInstallState, hasLocalMarketplaceSkillDrift, isLocalMarketplaceInstallStateFile, readMarketplaceSkillInstallState, resolveMarketplaceSkillUpdateStatus, writeMarketplaceSkillInstallState } from "../../stores/marketplace-install-state.store.js";
+import { fetchMarketplaceSkillFiles, fetchMarketplaceSkillItem, resolveMarketplaceApiBase, writeMarketplaceSkillFiles } from "./marketplace-client.utils.js";
+import { validateSkillSelector } from "./marketplace-identity.utils.js";
+import { DEFAULT_SKILLS_DIR } from "@nextclaw/core";
+import { SkillManager } from "@nextclaw/kernel";
+import { existsSync, mkdirSync, readdirSync, rmSync } from "node:fs";
+import { isAbsolute, join, relative, resolve } from "node:path";
+//#region src/utils/marketplace/marketplace-skill-lifecycle.utils.ts
+async function installMarketplaceSkill(options) {
+	const { slug, workdir: rawWorkdir, dir, force, apiBaseUrl } = options;
+	const selector = validateSkillSelector(slug.trim(), "slug");
+	const workdir = resolve(rawWorkdir);
+	if (!existsSync(workdir)) throw new Error(`Workdir does not exist: ${workdir}`);
+	const apiBase = resolveMarketplaceApiBase(apiBaseUrl);
+	const item = await fetchMarketplaceSkillItem(apiBase, selector);
+	const installSlug = item.slug;
+	const resolvedSlug = item.packageName || item.slug;
+	const destinationDir = resolveMarketplaceSkillDestinationDir({
+		workdir,
+		slug: installSlug,
+		dir
+	});
+	if (item.install.kind === "builtin") {
+		const builtinResult = resolveBuiltinMarketplaceInstallResult({
+			workdir,
+			slug: installSlug
+		});
+		builtinResult.slug = resolvedSlug;
+		return builtinResult;
+	}
+	const filesPayload = await fetchMarketplaceSkillFiles(apiBase, selector);
+	const existingInstall = prepareMarketplaceSkillDestinationDir({
+		destinationDir,
+		files: filesPayload.files,
+		force,
+		slug: installSlug
+	});
+	if (existingInstall) {
+		existingInstall.slug = resolvedSlug;
+		return existingInstall;
+	}
+	const writtenFiles = await writeMarketplaceSkillFiles({
+		destinationDir,
+		files: filesPayload.files,
+		apiBase,
+		slug: selector
+	});
+	ensureInstalledMarketplaceSkill(destinationDir, installSlug);
+	writeMarketplaceSkillInstallState({
+		destinationDir,
+		state: buildMarketplaceSkillInstallState({
+			item,
+			apiBase,
+			files: writtenFiles
+		})
+	});
+	return buildMarketplaceInstallResult(resolvedSlug, destinationDir);
+}
+async function updateInstalledMarketplaceSkill(options) {
+	const { slug, workdir: rawWorkdir, dir, force, apiBaseUrl } = options;
+	const selector = validateSkillSelector(slug.trim(), "slug");
+	const workdir = resolve(rawWorkdir);
+	if (!existsSync(workdir)) throw new Error(`Workdir does not exist: ${workdir}`);
+	const apiBase = resolveMarketplaceApiBase(apiBaseUrl);
+	const item = await fetchMarketplaceSkillItem(apiBase, selector);
+	const destinationDir = resolveMarketplaceSkillDestinationDir({
+		workdir,
+		slug: item.slug,
+		dir
+	});
+	if (item.install.kind === "builtin") return {
+		slug: item.packageName || item.slug,
+		destinationDir: resolveBuiltinSkillDir(workdir, item.slug),
+		updated: false,
+		source: "builtin",
+		status: "up-to-date"
+	};
+	if (!existsSync(destinationDir)) throw new Error(`Marketplace skill is not installed: ${item.slug}`);
+	const currentState = readMarketplaceSkillInstallState(destinationDir);
+	if (!currentState && !force) throw new Error(`Missing marketplace install state for ${item.slug}; use --force to replace this skill from marketplace.`);
+	if (!force && currentState && hasLocalMarketplaceSkillDrift(destinationDir, currentState)) throw new Error(`Local skill files changed since install: ${item.slug}; use --force to overwrite local changes.`);
+	const status = resolveMarketplaceSkillUpdateStatus(currentState, item.updatedAt);
+	if (!force && status === "up-to-date") return {
+		slug: item.packageName || item.slug,
+		destinationDir,
+		updated: false,
+		source: "marketplace",
+		status
+	};
+	const filesPayload = await fetchMarketplaceSkillFiles(apiBase, selector);
+	rmSync(destinationDir, {
+		recursive: true,
+		force: true
+	});
+	mkdirSync(destinationDir, { recursive: true });
+	const writtenFiles = await writeMarketplaceSkillFiles({
+		destinationDir,
+		files: filesPayload.files,
+		apiBase,
+		slug: selector
+	});
+	ensureInstalledMarketplaceSkill(destinationDir, item.slug);
+	writeMarketplaceSkillInstallState({
+		destinationDir,
+		state: buildMarketplaceSkillInstallState({
+			item,
+			apiBase,
+			files: writtenFiles
+		})
+	});
+	return {
+		slug: item.packageName || item.slug,
+		destinationDir,
+		updated: true,
+		source: "marketplace",
+		status: "up-to-date"
+	};
+}
+function resolveMarketplaceSkillDestinationDir(params) {
+	const { workdir, slug, dir } = params;
+	const dirName = dir?.trim() || DEFAULT_SKILLS_DIR;
+	return isAbsolute(dirName) ? resolve(dirName, slug) : resolve(workdir, dirName, slug);
+}
+function resolveBuiltinMarketplaceInstallResult(params) {
+	return {
+		slug: params.slug,
+		destinationDir: resolveBuiltinSkillDir(params.workdir, params.slug),
+		alreadyInstalled: true,
+		source: "builtin"
+	};
+}
+function prepareMarketplaceSkillDestinationDir(params) {
+	const { destinationDir, files, force, slug } = params;
+	if (!force && existsSync(destinationDir)) {
+		const existingDirState = inspectMarketplaceSkillDirectory(destinationDir, files);
+		if (existingDirState === "installed") return {
+			slug,
+			destinationDir,
+			alreadyInstalled: true,
+			source: "marketplace"
+		};
+		if (existingDirState !== "recoverable") throw new Error(`Skill directory already exists: ${destinationDir} (use --force)`);
+		rmSync(destinationDir, {
+			recursive: true,
+			force: true
+		});
+	}
+	if (force && existsSync(destinationDir)) rmSync(destinationDir, {
+		recursive: true,
+		force: true
+	});
+	mkdirSync(destinationDir, { recursive: true });
+	return null;
+}
+function ensureInstalledMarketplaceSkill(destinationDir, slug) {
+	if (!existsSync(join(destinationDir, "SKILL.md"))) throw new Error(`Marketplace skill ${slug} does not include SKILL.md`);
+}
+function buildMarketplaceInstallResult(slug, destinationDir) {
+	return {
+		slug,
+		destinationDir,
+		source: "marketplace"
+	};
+}
+function inspectMarketplaceSkillDirectory(destinationDir, files) {
+	if (existsSync(join(destinationDir, "SKILL.md"))) return "installed";
+	const discoveredFiles = collectRelativeFiles(destinationDir);
+	if (discoveredFiles === null) return "conflict";
+	const relevantFiles = discoveredFiles.filter((file) => !isIgnorableMarketplaceResidue(file));
+	if (relevantFiles.length === 0) return "recoverable";
+	const manifestPaths = new Set(files.map((file) => normalizeMarketplaceRelativePath(file.path)));
+	return relevantFiles.every((file) => manifestPaths.has(normalizeMarketplaceRelativePath(file))) ? "recoverable" : "conflict";
+}
+function collectRelativeFiles(rootDir) {
+	const output = [];
+	const walk = (dir) => {
+		const entries = readdirSync(dir, { withFileTypes: true });
+		for (const entry of entries) {
+			const absolute = join(dir, entry.name);
+			if (entry.isDirectory()) {
+				if (!walk(absolute)) return false;
+				continue;
+			}
+			if (!entry.isFile()) return false;
+			const relativePath = relative(rootDir, absolute);
+			output.push(normalizeMarketplaceRelativePath(relativePath));
+		}
+		return true;
+	};
+	return walk(rootDir) ? output : null;
+}
+function normalizeMarketplaceRelativePath(path) {
+	return path.replace(/\\/g, "/");
+}
+function isIgnorableMarketplaceResidue(path) {
+	return path === ".DS_Store" || isLocalMarketplaceInstallStateFile(path);
+}
+function resolveBuiltinSkillDir(workdir, skillName) {
+	const skillDir = new SkillManager({ workspace: workdir }).resolveBuiltinSkillDir(skillName);
+	if (!skillDir) throw new Error(`Built-in skill not found in local installation: ${skillName}`);
+	return skillDir;
+}
+//#endregion
+export { installMarketplaceSkill, updateInstalledMarketplaceSkill };
+
+//# sourceMappingURL=marketplace-skill-lifecycle.utils.js.map

package/dist/utils/marketplace/marketplace-skill-lifecycle.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace-skill-lifecycle.utils.js","names":[],"sources":["../../../src/utils/marketplace/marketplace-skill-lifecycle.utils.ts"],"sourcesContent":["import { existsSync, mkdirSync, readdirSync, rmSync } from \"node:fs\";\nimport { isAbsolute, join, relative, resolve } from \"node:path\";\nimport { DEFAULT_SKILLS_DIR } from \"@nextclaw/core\";\nimport { SkillManager } from \"@nextclaw/kernel\";\nimport {\n  fetchMarketplaceSkillFiles,\n  fetchMarketplaceSkillItem,\n  resolveMarketplaceApiBase,\n  type MarketplaceSkillFileManifestEntry,\n  writeMarketplaceSkillFiles\n} from \"@nextclaw-service/utils/marketplace/marketplace-client.utils.js\";\nimport {\n  buildMarketplaceSkillInstallState,\n  hasLocalMarketplaceSkillDrift,\n  isLocalMarketplaceInstallStateFile,\n  readMarketplaceSkillInstallState,\n  resolveMarketplaceSkillUpdateStatus,\n  type MarketplaceSkillUpdateStatus,\n  writeMarketplaceSkillInstallState\n} from \"@nextclaw-service/stores/marketplace-install-state.store.js\";\nimport { validateSkillSelector } from \"@nextclaw-service/utils/marketplace/marketplace-identity.utils.js\";\n\ntype MarketplaceSkillInstallKind = \"builtin\" | \"marketplace\";\n\nexport type MarketplaceSkillInstallOptions = {\n  slug: string;\n  workdir: string;\n  dir?: string;\n  force?: boolean;\n  apiBaseUrl?: string;\n};\n\nexport async function installMarketplaceSkill(options: MarketplaceSkillInstallOptions): Promise<{\n  slug: string;\n  destinationDir: string;\n  alreadyInstalled?: boolean;\n  source: MarketplaceSkillInstallKind;\n}> {\n  const { slug, workdir: rawWorkdir, dir, force, apiBaseUrl } = options;\n  const selector = validateSkillSelector(slug.trim(), \"slug\");\n  const workdir = resolve(rawWorkdir);\n  if (!existsSync(workdir)) {\n    throw new Error(`Workdir does not exist: ${workdir}`);\n  }\n\n  const apiBase = resolveMarketplaceApiBase(apiBaseUrl);\n  const item = await fetchMarketplaceSkillItem(apiBase, selector);\n  const installSlug = item.slug;\n  const resolvedSlug = item.packageName || item.slug;\n  const destinationDir = resolveMarketplaceSkillDestinationDir({\n    workdir,\n    slug: installSlug,\n    dir,\n  });\n\n  if (item.install.kind === \"builtin\") {\n    const builtinResult = resolveBuiltinMarketplaceInstallResult({\n      workdir,\n      slug: installSlug,\n    });\n    builtinResult.slug = resolvedSlug;\n    return builtinResult;\n  }\n\n  const filesPayload = await fetchMarketplaceSkillFiles(apiBase, selector);\n  const existingInstall = prepareMarketplaceSkillDestinationDir({\n    destinationDir,\n    files: filesPayload.files,\n    force,\n    slug: installSlug,\n  });\n  if (existingInstall) {\n    existingInstall.slug = resolvedSlug;\n    return existingInstall;\n  }\n  const writtenFiles = await writeMarketplaceSkillFiles({\n    destinationDir,\n    files: filesPayload.files,\n    apiBase,\n    slug: selector,\n  });\n  ensureInstalledMarketplaceSkill(destinationDir, installSlug);\n  writeMarketplaceSkillInstallState({\n    destinationDir,\n    state: buildMarketplaceSkillInstallState({\n      item,\n      apiBase,\n      files: writtenFiles,\n    }),\n  });\n  return buildMarketplaceInstallResult(resolvedSlug, destinationDir);\n}\n\nexport async function updateInstalledMarketplaceSkill(options: MarketplaceSkillInstallOptions): Promise<{\n  slug: string;\n  destinationDir: string;\n  updated: boolean;\n  source: MarketplaceSkillInstallKind;\n  status: MarketplaceSkillUpdateStatus;\n}> {\n  const { slug, workdir: rawWorkdir, dir, force, apiBaseUrl } = options;\n  const selector = validateSkillSelector(slug.trim(), \"slug\");\n  const workdir = resolve(rawWorkdir);\n  if (!existsSync(workdir)) {\n    throw new Error(`Workdir does not exist: ${workdir}`);\n  }\n\n  const apiBase = resolveMarketplaceApiBase(apiBaseUrl);\n  const item = await fetchMarketplaceSkillItem(apiBase, selector);\n  const destinationDir = resolveMarketplaceSkillDestinationDir({\n    workdir,\n    slug: item.slug,\n    dir,\n  });\n\n  if (item.install.kind === \"builtin\") {\n    return {\n      slug: item.packageName || item.slug,\n      destinationDir: resolveBuiltinSkillDir(workdir, item.slug),\n      updated: false,\n      source: \"builtin\",\n      status: \"up-to-date\",\n    };\n  }\n\n  if (!existsSync(destinationDir)) {\n    throw new Error(`Marketplace skill is not installed: ${item.slug}`);\n  }\n\n  const currentState = readMarketplaceSkillInstallState(destinationDir);\n  if (!currentState && !force) {\n    throw new Error(`Missing marketplace install state for ${item.slug}; use --force to replace this skill from marketplace.`);\n  }\n\n  if (!force && currentState && hasLocalMarketplaceSkillDrift(destinationDir, currentState)) {\n    throw new Error(`Local skill files changed since install: ${item.slug}; use --force to overwrite local changes.`);\n  }\n\n  const status = resolveMarketplaceSkillUpdateStatus(currentState, item.updatedAt);\n  if (!force && status === \"up-to-date\") {\n    return {\n      slug: item.packageName || item.slug,\n      destinationDir,\n      updated: false,\n      source: \"marketplace\",\n      status,\n    };\n  }\n\n  const filesPayload = await fetchMarketplaceSkillFiles(apiBase, selector);\n  rmSync(destinationDir, { recursive: true, force: true });\n  mkdirSync(destinationDir, { recursive: true });\n  const writtenFiles = await writeMarketplaceSkillFiles({\n    destinationDir,\n    files: filesPayload.files,\n    apiBase,\n    slug: selector,\n  });\n  ensureInstalledMarketplaceSkill(destinationDir, item.slug);\n  writeMarketplaceSkillInstallState({\n    destinationDir,\n    state: buildMarketplaceSkillInstallState({\n      item,\n      apiBase,\n      files: writtenFiles,\n    }),\n  });\n\n  return {\n    slug: item.packageName || item.slug,\n    destinationDir,\n    updated: true,\n    source: \"marketplace\",\n    status: \"up-to-date\",\n  };\n}\n\nfunction resolveMarketplaceSkillDestinationDir(params: {\n  workdir: string;\n  slug: string;\n  dir?: string;\n}): string {\n  const { workdir, slug, dir } = params;\n  const dirName = dir?.trim() || DEFAULT_SKILLS_DIR;\n  return isAbsolute(dirName)\n    ? resolve(dirName, slug)\n    : resolve(workdir, dirName, slug);\n}\n\nfunction resolveBuiltinMarketplaceInstallResult(params: {\n  workdir: string;\n  slug: string;\n}): {\n  slug: string;\n  destinationDir: string;\n  alreadyInstalled: true;\n  source: \"builtin\";\n} {\n  return {\n    slug: params.slug,\n    destinationDir: resolveBuiltinSkillDir(params.workdir, params.slug),\n    alreadyInstalled: true,\n    source: \"builtin\",\n  };\n}\n\nfunction prepareMarketplaceSkillDestinationDir(params: {\n  destinationDir: string;\n  files: MarketplaceSkillFileManifestEntry[];\n  force?: boolean;\n  slug: string;\n}): {\n  slug: string;\n  destinationDir: string;\n  alreadyInstalled: true;\n  source: \"marketplace\";\n} | null {\n  const { destinationDir, files, force, slug } = params;\n  if (!force && existsSync(destinationDir)) {\n    const existingDirState = inspectMarketplaceSkillDirectory(destinationDir, files);\n    if (existingDirState === \"installed\") {\n      return {\n        slug,\n        destinationDir,\n        alreadyInstalled: true,\n        source: \"marketplace\",\n      };\n    }\n    if (existingDirState !== \"recoverable\") {\n      throw new Error(`Skill directory already exists: ${destinationDir} (use --force)`);\n    }\n    rmSync(destinationDir, { recursive: true, force: true });\n  }\n\n  if (force && existsSync(destinationDir)) {\n    rmSync(destinationDir, { recursive: true, force: true });\n  }\n\n  mkdirSync(destinationDir, { recursive: true });\n  return null;\n}\n\nfunction ensureInstalledMarketplaceSkill(destinationDir: string, slug: string): void {\n  if (!existsSync(join(destinationDir, \"SKILL.md\"))) {\n    throw new Error(`Marketplace skill ${slug} does not include SKILL.md`);\n  }\n}\n\nfunction buildMarketplaceInstallResult(slug: string, destinationDir: string): {\n  slug: string;\n  destinationDir: string;\n  source: \"marketplace\";\n} {\n  return {\n    slug,\n    destinationDir,\n    source: \"marketplace\",\n  };\n}\n\nfunction inspectMarketplaceSkillDirectory(\n  destinationDir: string,\n  files: MarketplaceSkillFileManifestEntry[]\n): \"installed\" | \"recoverable\" | \"conflict\" {\n  if (existsSync(join(destinationDir, \"SKILL.md\"))) {\n    return \"installed\";\n  }\n\n  const discoveredFiles = collectRelativeFiles(destinationDir);\n  if (discoveredFiles === null) {\n    return \"conflict\";\n  }\n\n  const relevantFiles = discoveredFiles.filter((file) => !isIgnorableMarketplaceResidue(file));\n  if (relevantFiles.length === 0) {\n    return \"recoverable\";\n  }\n\n  const manifestPaths = new Set(files.map((file) => normalizeMarketplaceRelativePath(file.path)));\n  return relevantFiles.every((file) => manifestPaths.has(normalizeMarketplaceRelativePath(file)))\n    ? \"recoverable\"\n    : \"conflict\";\n}\n\nfunction collectRelativeFiles(rootDir: string): string[] | null {\n  const output: string[] = [];\n  const walk = (dir: string): boolean => {\n    const entries = readdirSync(dir, { withFileTypes: true });\n    for (const entry of entries) {\n      const absolute = join(dir, entry.name);\n      if (entry.isDirectory()) {\n        if (!walk(absolute)) {\n          return false;\n        }\n        continue;\n      }\n      if (!entry.isFile()) {\n        return false;\n      }\n      const relativePath = relative(rootDir, absolute);\n      output.push(normalizeMarketplaceRelativePath(relativePath));\n    }\n    return true;\n  };\n\n  return walk(rootDir) ? output : null;\n}\n\nfunction normalizeMarketplaceRelativePath(path: string): string {\n  return path.replace(/\\\\/g, \"/\");\n}\n\nfunction isIgnorableMarketplaceResidue(path: string): boolean {\n  return path === \".DS_Store\" || isLocalMarketplaceInstallStateFile(path);\n}\n\nfunction resolveBuiltinSkillDir(workdir: string, skillName: string): string {\n  const skillDir = new SkillManager({ workspace: workdir }).resolveBuiltinSkillDir(skillName);\n  if (!skillDir) {\n    throw new Error(`Built-in skill not found in local installation: ${skillName}`);\n  }\n  return skillDir;\n}\n"],"mappings":"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"}

package/dist/utils/marketplace/marketplace.utils.d.ts

@@ -0,0 +1,34 @@
+import { LocalizedTextMap } from "./marketplace-metadata.utils.js";
+import { MarketplaceSkillInstallOptions, installMarketplaceSkill, updateInstalledMarketplaceSkill } from "./marketplace-skill-lifecycle.utils.js";
+
+//#region src/utils/marketplace/marketplace.utils.d.ts
+type MarketplaceSkillPublishOptions = {
+  skillDir: string;
+  metaFile?: string;
+  slug?: string;
+  packageName?: string;
+  scope?: string;
+  name?: string;
+  summary?: string;
+  summaryI18n?: LocalizedTextMap;
+  description?: string;
+  descriptionI18n?: LocalizedTextMap;
+  author?: string;
+  tags?: string[];
+  sourceRepo?: string;
+  homepage?: string;
+  publishedAt?: string;
+  updatedAt?: string;
+  apiBaseUrl?: string;
+  token?: string;
+  requireExisting?: boolean;
+};
+declare function publishMarketplaceSkill(options: MarketplaceSkillPublishOptions): Promise<{
+  created: boolean;
+  slug: string;
+  packageName: string;
+  fileCount: number;
+}>;
+//#endregion
+export { type MarketplaceSkillInstallOptions, MarketplaceSkillPublishOptions, installMarketplaceSkill, publishMarketplaceSkill, updateInstalledMarketplaceSkill };
+//# sourceMappingURL=marketplace.utils.d.ts.map

package/dist/utils/marketplace/marketplace.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace.utils.d.ts","names":[],"sources":["../../../src/utils/marketplace/marketplace.utils.ts"],"mappings":";;;;KA2BY,8BAAA;EACV,QAAA;EACA,QAAA;EACA,IAAA;EACA,WAAA;EACA,KAAA;EACA,IAAA;EACA,OAAA;EACA,WAAA,GAAc,gBAAA;EACd,WAAA;EACA,eAAA,GAAkB,gBAAA;EAClB,MAAA;EACA,IAAA;EACA,UAAA;EACA,QAAA;EACA,WAAA;EACA,SAAA;EACA,UAAA;EACA,KAAA;EACA,eAAA;AAAA;AAAA,iBAGoB,uBAAA,CAAwB,OAAA,EAAS,8BAAA,GAAiC,OAAA;EACtF,OAAA;EACA,IAAA;EACA,WAAA;EACA,SAAA;AAAA"}