@hasna/skills 0.1.57 → 0.1.58

package/bin/index.js

@@ -36860,7 +36860,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/skills",
-    version: "0.1.57",
+    version: "0.1.58",
     description: "Skills library for AI coding agents",
     type: "module",
     bin: {
@@ -57778,6 +57778,65 @@ var init_auth_store = __esm(() => {
   LEGACY_AUTH_FILE = join9(homedir4(), ".skills", "auth.json");
 });
 
+// src/lib/hosted-availability.ts
+var exports_hosted_availability = {};
+__export(exports_hosted_availability, {
+  getHostedRunAvailability: () => getHostedRunAvailability,
+  getHostedAvailabilityMetadata: () => getHostedAvailabilityMetadata
+});
+function getHostedRunAvailability(slug) {
+  const canonicalSlug = resolveSkillAlias(slug);
+  if (!UNAVAILABLE_HOSTED_PROVIDER_SKILLS.has(canonicalSlug)) {
+    return { ok: true };
+  }
+  return {
+    ok: false,
+    status: 503,
+    code: "HOSTED_PROVIDER_UNAVAILABLE",
+    message: "hosted execution is temporarily unavailable for this skill",
+    details: [
+      "This skill requires a platform-managed execution path that is not enabled for live hosted runs yet.",
+      "No balance was charged."
+    ]
+  };
+}
+function getHostedAvailabilityMetadata(slug) {
+  const availability = getHostedRunAvailability(slug);
+  if (availability.ok)
+    return { status: "available" };
+  return {
+    status: "unavailable",
+    code: availability.code,
+    message: availability.message,
+    details: availability.details
+  };
+}
+var UNAVAILABLE_HOSTED_PROVIDER_SKILLS;
+var init_hosted_availability = __esm(() => {
+  init_skill_aliases();
+  UNAVAILABLE_HOSTED_PROVIDER_SKILLS = new Set([
+    "audio",
+    "brand-photo-shoot",
+    "browse",
+    "deepresearch",
+    "generate-book-cover",
+    "icon-pack",
+    "image",
+    "music",
+    "music-album",
+    "pdf-read",
+    "photo-album",
+    "playlist-maker",
+    "read-pdf",
+    "remove-background",
+    "short-video-pack",
+    "transcript",
+    "video",
+    "voiceover-jingle-pack",
+    "webcrawling"
+  ]);
+});
+
 // src/lib/remote-registry.ts
 function getConfiguredApiUrl(config2 = loadConfig(), env3 = process.env) {
   const raw = env3["SKILLS_API_URL"] || config2.apiUrl;
@@ -57819,9 +57878,30 @@ function normalizeRemoteSkill(skill) {
     dependencies: skill.dependencies,
     ...skill.version ? { version: skill.version } : {},
     ...skill.pricing ? { pricing: skill.pricing } : {},
+    availability: normalizeRemoteAvailability(name, skill.availability),
     source: "remote"
   };
 }
+function normalizeRemoteAvailability(name, availability) {
+  if (!availability)
+    return getHostedAvailabilityMetadata(name);
+  if (availability.status === "available")
+    return { status: "available" };
+  return {
+    status: availability.status,
+    ...safeAvailabilityCode(availability.code) ? { code: safeAvailabilityCode(availability.code) } : {},
+    ...availability.message ? { message: sanitizeAvailabilityText(availability.message) } : {},
+    ...availability.details ? { details: availability.details.map(sanitizeAvailabilityText).filter(Boolean) } : {}
+  };
+}
+function safeAvailabilityCode(code) {
+  if (!code)
+    return;
+  return /^[A-Z0-9_]+$/.test(code) ? code : undefined;
+}
+function sanitizeAvailabilityText(text) {
+  return secretValuePatterns.reduce((value, pattern) => value.replace(pattern, "credential"), sanitizePublicDiscoveryText(text).replace(/\b[A-Z0-9_]*(?:API_KEY|SECRET|TOKEN|CREDENTIAL)[A-Z0-9_]*\b/g, "credential")).replace(/\s{2,}/g, " ").trim();
+}
 function parseRemoteRegistryPayload(payload) {
   const parsed = parseRemoteContract(remoteRegistrySchema, payload, "Remote registry payload did not match the expected skills contract");
   const rawSkills = Array.isArray(parsed) ? parsed : ("skills" in parsed) ? parsed.skills : parsed.data;
@@ -57883,11 +57963,19 @@ async function loadRemoteSkill(name, options = {}) {
   const url2 = buildSkillsApiUrl(apiUrl, options.endpoint ?? `/skills/${slug}`);
   return parseRemoteSkillPayload(await fetchRemoteJson(url2, options));
 }
-var remotePricingSchema, remoteSkillSchema, remoteSkillDetailSchema, remoteRegistrySchema;
+var remoteAvailabilitySchema, remotePricingSchema, remoteSkillSchema, secretValuePatterns, remoteSkillDetailSchema, remoteRegistrySchema;
 var init_remote_registry = __esm(() => {
   init_zod();
   init_auth_store();
   init_config();
+  init_discovery();
+  init_hosted_availability();
+  remoteAvailabilitySchema = exports_external.object({
+    status: exports_external.enum(["available", "unavailable"]),
+    code: exports_external.string().optional(),
+    message: exports_external.string().optional(),
+    details: exports_external.array(exports_external.string()).optional()
+  }).passthrough();
   remotePricingSchema = exports_external.object({
     formattedCost: exports_external.string(),
     tier: exports_external.string().optional(),
@@ -57909,10 +57997,22 @@ var init_remote_registry = __esm(() => {
     tags: exports_external.array(exports_external.string()).optional(),
     dependencies: exports_external.array(exports_external.string()).optional(),
     version: exports_external.string().optional(),
-    pricing: remotePricingSchema.optional()
+    pricing: remotePricingSchema.optional(),
+    availability: remoteAvailabilitySchema.optional()
   }).passthrough().refine((skill) => skill.name || skill.slug, {
     message: "Remote skill requires name or slug"
   });
+  secretValuePatterns = [
+    /\bsk-[A-Za-z0-9_-]{8,}\b/g,
+    /\bgh[opsur]_[A-Za-z0-9_]{8,}\b/g,
+    /\bgithub_pat_[A-Za-z0-9_]{8,}\b/g,
+    /\bnpm_[A-Za-z0-9_]{8,}\b/g,
+    /\bAKIA[A-Z0-9]{12,}\b/g,
+    /\bAIza[A-Za-z0-9_-]{10,}\b/g,
+    new RegExp("\\bsecret" + "-token:\\s*[A-Za-z0-9._-]+", "gi"),
+    /\bctx7sk\-[A-Za-z0-9_-]{8,}\b/g,
+    /\bxai\-[A-Za-z0-9_-]{8,}\b/g
+  ];
   remoteSkillDetailSchema = exports_external.union([
     remoteSkillSchema,
     exports_external.object({ skill: remoteSkillSchema }),
@@ -60253,53 +60353,6 @@ var init_diagnostic = __esm(() => {
   init_installer();
 });
 
-// src/lib/hosted-availability.ts
-var exports_hosted_availability = {};
-__export(exports_hosted_availability, {
-  getHostedRunAvailability: () => getHostedRunAvailability
-});
-function getHostedRunAvailability(slug) {
-  const canonicalSlug = resolveSkillAlias(slug);
-  if (!UNAVAILABLE_HOSTED_PROVIDER_SKILLS.has(canonicalSlug)) {
-    return { ok: true };
-  }
-  return {
-    ok: false,
-    status: 503,
-    code: "HOSTED_PROVIDER_UNAVAILABLE",
-    message: "hosted execution is temporarily unavailable for this skill",
-    details: [
-      "This skill requires a platform-managed execution path that is not enabled for live hosted runs yet.",
-      "No balance was charged."
-    ]
-  };
-}
-var UNAVAILABLE_HOSTED_PROVIDER_SKILLS;
-var init_hosted_availability = __esm(() => {
-  init_skill_aliases();
-  UNAVAILABLE_HOSTED_PROVIDER_SKILLS = new Set([
-    "audio",
-    "brand-photo-shoot",
-    "browse",
-    "deepresearch",
-    "generate-book-cover",
-    "icon-pack",
-    "image",
-    "music",
-    "music-album",
-    "pdf-read",
-    "photo-album",
-    "playlist-maker",
-    "read-pdf",
-    "remove-background",
-    "short-video-pack",
-    "transcript",
-    "video",
-    "voiceover-jingle-pack",
-    "webcrawling"
-  ]);
-});
-
 // src/lib/remote-run-contract.ts
 function normalizeRemoteSkillRunContract(payload, fallbackSkill) {
   const record2 = isRecord2(payload) ? payload : {};
@@ -80345,6 +80398,54 @@ function writeCommandError(err, fallback, json2) {
     console.error(source_default.red(String(payload.detail || payload.error || fallback)));
   process.exitCode = 1;
 }
+function envApiKey() {
+  const key = process.env.SKILLS_API_KEY || process.env.SKILL_API_KEY;
+  const trimmed = key?.trim();
+  return trimmed || null;
+}
+function stringField2(value) {
+  return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function recordField(value) {
+  return isRecord3(value) ? value : undefined;
+}
+function authIdentityPayload(authSource, live, cached2, offline = false) {
+  const root = recordField(live) ?? {};
+  const data = recordField(root.data);
+  const user = recordField(root.user) ?? recordField(data?.user);
+  const organization = recordField(root.organization) ?? recordField(root.org) ?? recordField(data?.organization);
+  const email3 = stringField2(user?.email) ?? cached2?.email;
+  const orgSlug = stringField2(organization?.slug) ?? cached2?.orgSlug;
+  const orgName = stringField2(organization?.name);
+  const userId = stringField2(user?.id) ?? cached2?.userId;
+  const orgId = stringField2(organization?.id) ?? cached2?.orgId;
+  const role = stringField2(user?.role);
+  return {
+    status: "authenticated",
+    authSource,
+    ...offline ? { offline: true } : {},
+    ...email3 ? { email: email3 } : {},
+    ...orgSlug ? { organization: orgSlug } : {},
+    ...orgName ? { organizationName: orgName } : {},
+    ...userId ? { userId } : {},
+    ...orgId ? { orgId } : {},
+    ...role ? { role } : {}
+  };
+}
+function printWhoami(payload) {
+  if (payload.email)
+    console.log(source_default.bold("Email:  ") + payload.email);
+  if (payload.organization)
+    console.log(source_default.bold("Org:    ") + payload.organization);
+  if (payload.role)
+    console.log(source_default.bold("Role:   ") + payload.role);
+  if (payload.organizationName)
+    console.log(source_default.bold("Name:   ") + payload.organizationName);
+  if (payload.authSource === "env")
+    console.log(source_default.dim("Auth:   SKILLS_API_KEY"));
+  if (payload.offline)
+    console.log(source_default.dim("(offline \u2014 showing cached info)"));
+}
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -80609,26 +80710,39 @@ function registerAuth(parent) {
     clearAuthConfig();
     console.log(source_default.green(`\u2713 Signed out (was ${existing.email})`));
   });
-  auth.command("whoami").description("Show current account info").action(async () => {
+  auth.command("whoami").description("Show current account info").option("--json", "Output as JSON", false).action(async (options) => {
+    const envKey = envApiKey();
     const config2 = getAuthConfig();
-    if (!config2) {
-      console.log(source_default.dim("Not signed in. Run: skills auth login"));
+    const apiKey = envKey ?? config2?.apiKey;
+    if (!apiKey) {
+      const payload = { status: "unauthenticated", error: "Not signed in. Run: skills auth login" };
+      if (options.json)
+        console.log(JSON.stringify(payload, null, 2));
+      else
+        console.log(source_default.dim(payload.error));
       return;
     }
-    console.log(source_default.bold("Email:  ") + config2.email);
-    console.log(source_default.bold("Org:    ") + config2.orgSlug);
+    const authSource = envKey ? "env" : "stored";
     try {
       const res = await apiRequest("/api/auth/whoami", {
-        headers: { Authorization: `Bearer ${config2.apiKey}` }
+        headers: { Authorization: `Bearer ${apiKey}` }
       });
-      if (res.user) {
-        console.log(source_default.bold("Role:   ") + res.user.role);
+      const payload = authIdentityPayload(authSource, res, envKey ? null : config2);
+      if (options.json) {
+        console.log(JSON.stringify(payload, null, 2));
+      } else {
+        printWhoami(payload);
       }
-      if (res.organization) {
-        console.log(source_default.bold("Name:   ") + res.organization.name);
+    } catch (err) {
+      if (config2 && !envKey) {
+        const payload = authIdentityPayload("stored", {}, config2, true);
+        if (options.json)
+          console.log(JSON.stringify(payload, null, 2));
+        else
+          printWhoami(payload);
+        return;
       }
-    } catch {
-      console.log(source_default.dim("(offline \u2014 showing cached info)"));
+      writeCommandError(err, "Failed to fetch current account", options.json);
     }
   });
   auth.command("status").description("Show hosted billing status").option("--json", "Output as JSON", false).action(handleBillingStatus);

package/bin/mcp.js

@@ -21819,7 +21819,7 @@ class StdioServerTransport {
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.1.57",
+  version: "0.1.58",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {

package/dist/index.js

@@ -18159,7 +18159,193 @@ function getApiUrl() {
   return normalizeSkillsApiOrigin(process.env.SKILLS_API_URL || loadConfig().apiUrl || "https://skills.md");
 }
 
+// src/lib/discovery.ts
+var VENDOR_TERMS = [
+  "Google Gemini",
+  "OpenAI Sora",
+  "MiniMax Hailuo",
+  "Claude Code",
+  "Claude Vision",
+  "DALL-E 3",
+  "GPT-4o Mini",
+  "Cerebras",
+  "OpenRouter",
+  "Firecrawl",
+  "ElevenLabs",
+  "Anthropic",
+  "OpenAI",
+  "Minimax",
+  "MiniMax",
+  "Gemini",
+  "Claude",
+  "Whisper",
+  "Seedance",
+  "Lyria",
+  "Sora",
+  "Veo",
+  "Exa.ai",
+  "Exa",
+  "XAI",
+  "xAI"
+];
+var VENDOR_TAGS = new Set([
+  "anthropic",
+  "cerebras",
+  "claude",
+  "exa",
+  "firecrawl",
+  "gemini",
+  "google",
+  "minimax",
+  "openai",
+  "openrouter",
+  "seedance",
+  "whisper",
+  "xai"
+]);
+var VENDOR_ENV_PREFIXES = [
+  "ANTHROPIC_",
+  "CEREBRAS_",
+  "EXA_",
+  "FIRECRAWL_",
+  "GEMINI_",
+  "GOOGLE_",
+  "MINIMAX_",
+  "OPENAI_",
+  "OPENROUTER_",
+  "XAI_"
+];
+var VENDOR_PACKAGE_PATTERNS = [
+  /anthropic/i,
+  /cerebras/i,
+  /exa/i,
+  /firecrawl/i,
+  /gemini/i,
+  /minimax/i,
+  /openai/i,
+  /openrouter/i,
+  /xai/i
+];
+var vendorPattern = new RegExp(`\\b(${VENDOR_TERMS.map(escapeRegExp).join("|")})\\b`, "gi");
+function getCompactSkillDiscovery(skill) {
+  return {
+    name: skill.name,
+    category: skill.category,
+    pricing: resolveDiscoveryPricing(skill)
+  };
+}
+function getPublicSkillDiscovery(skill) {
+  return {
+    ...skill,
+    description: sanitizePublicDiscoveryText(skill.description),
+    tags: publicDiscoveryTags(skill.tags),
+    pricing: resolveDiscoveryPricing(skill)
+  };
+}
+function publicDiscoveryPriceLabel(skill) {
+  return (skill.pricing ?? getPublicSkillPricing(skill.name)).formattedCost;
+}
+function publicDiscoveryTags(tags) {
+  return tags.filter((tag) => !VENDOR_TAGS.has(tag.toLowerCase()));
+}
+function sanitizePublicDiscoveryText(text) {
+  let sanitized = text.replace(vendorPattern, "hosted AI").replace(/\bLLM\b/g, "AI").replace(/\s{2,}/g, " ");
+  let previous;
+  do {
+    previous = sanitized;
+    sanitized = sanitized.replace(/\bhosted AI(?: providers)?\s*,\s*hosted AI(?: providers)?\b/gi, "hosted AI providers").replace(/\bhosted AI(?: providers)?\s*,?\s*and\s*hosted AI(?: providers)?\b/gi, "hosted AI providers").replace(/\bhosted AI(?: providers)?\s+or\s+hosted AI(?: providers)?\b/gi, "hosted AI providers").replace(/\bhosted AI providers\s+hosted AI\b/gi, "hosted AI providers").replace(/\bhosted AI providers\s+providers\b/gi, "hosted AI providers");
+  } while (sanitized !== previous);
+  return sanitized.trim();
+}
+function publicDiscoveryEnvVars(skillName, envVars) {
+  if (!isPremiumSkill(skillName))
+    return envVars;
+  const filtered = envVars.filter((envVar) => envVar !== "SKILL_API_KEY" && !VENDOR_ENV_PREFIXES.some((prefix) => envVar.startsWith(prefix)));
+  return filtered.includes("SKILLS_API_KEY") ? filtered : ["SKILLS_API_KEY", ...filtered];
+}
+function publicDiscoveryDependencies(skillName, dependencies) {
+  if (!isPremiumSkill(skillName))
+    return dependencies;
+  return Object.fromEntries(Object.entries(dependencies).filter(([name]) => !VENDOR_PACKAGE_PATTERNS.some((pattern) => pattern.test(name))));
+}
+function publicDiscoveryDocumentation(skill, documentation) {
+  if (!documentation)
+    return documentation;
+  if (!isPremiumSkill(skill.name))
+    return documentation;
+  return [
+    `# ${skill.displayName || skill.name}`,
+    sanitizePublicDiscoveryText(skill.description),
+    `Pricing: ${getPublicSkillPricing(skill.name).formattedCost}.`,
+    "Set `SKILLS_API_KEY` or run `skills auth login` for hosted runtime execution. Runtime routing and model selection are managed by the hosted Skills runtime."
+  ].join(`
+
+`);
+}
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function resolveDiscoveryPricing(skill) {
+  return skill.pricing && typeof skill.pricing.formattedCost === "string" ? skill.pricing : getPublicSkillPricing(skill.name);
+}
+
+// src/lib/hosted-availability.ts
+var UNAVAILABLE_HOSTED_PROVIDER_SKILLS = new Set([
+  "audio",
+  "brand-photo-shoot",
+  "browse",
+  "deepresearch",
+  "generate-book-cover",
+  "icon-pack",
+  "image",
+  "music",
+  "music-album",
+  "pdf-read",
+  "photo-album",
+  "playlist-maker",
+  "read-pdf",
+  "remove-background",
+  "short-video-pack",
+  "transcript",
+  "video",
+  "voiceover-jingle-pack",
+  "webcrawling"
+]);
+function getHostedRunAvailability(slug) {
+  const canonicalSlug = resolveSkillAlias(slug);
+  if (!UNAVAILABLE_HOSTED_PROVIDER_SKILLS.has(canonicalSlug)) {
+    return { ok: true };
+  }
+  return {
+    ok: false,
+    status: 503,
+    code: "HOSTED_PROVIDER_UNAVAILABLE",
+    message: "hosted execution is temporarily unavailable for this skill",
+    details: [
+      "This skill requires a platform-managed execution path that is not enabled for live hosted runs yet.",
+      "No balance was charged."
+    ]
+  };
+}
+function getHostedAvailabilityMetadata(slug) {
+  const availability = getHostedRunAvailability(slug);
+  if (availability.ok)
+    return { status: "available" };
+  return {
+    status: "unavailable",
+    code: availability.code,
+    message: availability.message,
+    details: availability.details
+  };
+}
+
 // src/lib/remote-registry.ts
+var remoteAvailabilitySchema = exports_external.object({
+  status: exports_external.enum(["available", "unavailable"]),
+  code: exports_external.string().optional(),
+  message: exports_external.string().optional(),
+  details: exports_external.array(exports_external.string()).optional()
+}).passthrough();
 var remotePricingSchema = exports_external.object({
   formattedCost: exports_external.string(),
   tier: exports_external.string().optional(),
@@ -18181,10 +18367,22 @@ var remoteSkillSchema = exports_external.object({
   tags: exports_external.array(exports_external.string()).optional(),
   dependencies: exports_external.array(exports_external.string()).optional(),
   version: exports_external.string().optional(),
-  pricing: remotePricingSchema.optional()
+  pricing: remotePricingSchema.optional(),
+  availability: remoteAvailabilitySchema.optional()
 }).passthrough().refine((skill) => skill.name || skill.slug, {
   message: "Remote skill requires name or slug"
 });
+var secretValuePatterns = [
+  /\bsk-[A-Za-z0-9_-]{8,}\b/g,
+  /\bgh[opsur]_[A-Za-z0-9_]{8,}\b/g,
+  /\bgithub_pat_[A-Za-z0-9_]{8,}\b/g,
+  /\bnpm_[A-Za-z0-9_]{8,}\b/g,
+  /\bAKIA[A-Z0-9]{12,}\b/g,
+  /\bAIza[A-Za-z0-9_-]{10,}\b/g,
+  new RegExp("\\bsecret" + "-token:\\s*[A-Za-z0-9._-]+", "gi"),
+  /\bctx7sk\-[A-Za-z0-9_-]{8,}\b/g,
+  /\bxai\-[A-Za-z0-9_-]{8,}\b/g
+];
 var remoteSkillDetailSchema = exports_external.union([
   remoteSkillSchema,
   exports_external.object({ skill: remoteSkillSchema }),
@@ -18235,9 +18433,30 @@ function normalizeRemoteSkill(skill) {
     dependencies: skill.dependencies,
     ...skill.version ? { version: skill.version } : {},
     ...skill.pricing ? { pricing: skill.pricing } : {},
+    availability: normalizeRemoteAvailability(name, skill.availability),
     source: "remote"
   };
 }
+function normalizeRemoteAvailability(name, availability) {
+  if (!availability)
+    return getHostedAvailabilityMetadata(name);
+  if (availability.status === "available")
+    return { status: "available" };
+  return {
+    status: availability.status,
+    ...safeAvailabilityCode(availability.code) ? { code: safeAvailabilityCode(availability.code) } : {},
+    ...availability.message ? { message: sanitizeAvailabilityText(availability.message) } : {},
+    ...availability.details ? { details: availability.details.map(sanitizeAvailabilityText).filter(Boolean) } : {}
+  };
+}
+function safeAvailabilityCode(code) {
+  if (!code)
+    return;
+  return /^[A-Z0-9_]+$/.test(code) ? code : undefined;
+}
+function sanitizeAvailabilityText(text) {
+  return secretValuePatterns.reduce((value, pattern) => value.replace(pattern, "credential"), sanitizePublicDiscoveryText(text).replace(/\b[A-Z0-9_]*(?:API_KEY|SECRET|TOKEN|CREDENTIAL)[A-Z0-9_]*\b/g, "credential")).replace(/\s{2,}/g, " ").trim();
+}
 function parseRemoteRegistryPayload(payload) {
   const parsed = parseRemoteContract(remoteRegistrySchema, payload, "Remote registry payload did not match the expected skills contract");
   const rawSkills = Array.isArray(parsed) ? parsed : ("skills" in parsed) ? parsed.skills : parsed.data;
@@ -18299,135 +18518,6 @@ async function loadRemoteSkill(name, options = {}) {
   const url2 = buildSkillsApiUrl(apiUrl, options.endpoint ?? `/skills/${slug}`);
   return parseRemoteSkillPayload(await fetchRemoteJson(url2, options));
 }
-// src/lib/discovery.ts
-var VENDOR_TERMS = [
-  "Google Gemini",
-  "OpenAI Sora",
-  "MiniMax Hailuo",
-  "Claude Code",
-  "Claude Vision",
-  "DALL-E 3",
-  "GPT-4o Mini",
-  "Cerebras",
-  "OpenRouter",
-  "Firecrawl",
-  "ElevenLabs",
-  "Anthropic",
-  "OpenAI",
-  "Minimax",
-  "MiniMax",
-  "Gemini",
-  "Claude",
-  "Whisper",
-  "Seedance",
-  "Lyria",
-  "Sora",
-  "Veo",
-  "Exa.ai",
-  "Exa",
-  "XAI",
-  "xAI"
-];
-var VENDOR_TAGS = new Set([
-  "anthropic",
-  "cerebras",
-  "claude",
-  "exa",
-  "firecrawl",
-  "gemini",
-  "google",
-  "minimax",
-  "openai",
-  "openrouter",
-  "seedance",
-  "whisper",
-  "xai"
-]);
-var VENDOR_ENV_PREFIXES = [
-  "ANTHROPIC_",
-  "CEREBRAS_",
-  "EXA_",
-  "FIRECRAWL_",
-  "GEMINI_",
-  "GOOGLE_",
-  "MINIMAX_",
-  "OPENAI_",
-  "OPENROUTER_",
-  "XAI_"
-];
-var VENDOR_PACKAGE_PATTERNS = [
-  /anthropic/i,
-  /cerebras/i,
-  /exa/i,
-  /firecrawl/i,
-  /gemini/i,
-  /minimax/i,
-  /openai/i,
-  /openrouter/i,
-  /xai/i
-];
-var vendorPattern = new RegExp(`\\b(${VENDOR_TERMS.map(escapeRegExp).join("|")})\\b`, "gi");
-function getCompactSkillDiscovery(skill) {
-  return {
-    name: skill.name,
-    category: skill.category,
-    pricing: resolveDiscoveryPricing(skill)
-  };
-}
-function getPublicSkillDiscovery(skill) {
-  return {
-    ...skill,
-    description: sanitizePublicDiscoveryText(skill.description),
-    tags: publicDiscoveryTags(skill.tags),
-    pricing: resolveDiscoveryPricing(skill)
-  };
-}
-function publicDiscoveryPriceLabel(skill) {
-  return (skill.pricing ?? getPublicSkillPricing(skill.name)).formattedCost;
-}
-function publicDiscoveryTags(tags) {
-  return tags.filter((tag) => !VENDOR_TAGS.has(tag.toLowerCase()));
-}
-function sanitizePublicDiscoveryText(text) {
-  let sanitized = text.replace(vendorPattern, "hosted AI").replace(/\bLLM\b/g, "AI").replace(/\s{2,}/g, " ");
-  let previous;
-  do {
-    previous = sanitized;
-    sanitized = sanitized.replace(/\bhosted AI(?: providers)?\s*,\s*hosted AI(?: providers)?\b/gi, "hosted AI providers").replace(/\bhosted AI(?: providers)?\s*,?\s*and\s*hosted AI(?: providers)?\b/gi, "hosted AI providers").replace(/\bhosted AI(?: providers)?\s+or\s+hosted AI(?: providers)?\b/gi, "hosted AI providers").replace(/\bhosted AI providers\s+hosted AI\b/gi, "hosted AI providers").replace(/\bhosted AI providers\s+providers\b/gi, "hosted AI providers");
-  } while (sanitized !== previous);
-  return sanitized.trim();
-}
-function publicDiscoveryEnvVars(skillName, envVars) {
-  if (!isPremiumSkill(skillName))
-    return envVars;
-  const filtered = envVars.filter((envVar) => envVar !== "SKILL_API_KEY" && !VENDOR_ENV_PREFIXES.some((prefix) => envVar.startsWith(prefix)));
-  return filtered.includes("SKILLS_API_KEY") ? filtered : ["SKILLS_API_KEY", ...filtered];
-}
-function publicDiscoveryDependencies(skillName, dependencies) {
-  if (!isPremiumSkill(skillName))
-    return dependencies;
-  return Object.fromEntries(Object.entries(dependencies).filter(([name]) => !VENDOR_PACKAGE_PATTERNS.some((pattern) => pattern.test(name))));
-}
-function publicDiscoveryDocumentation(skill, documentation) {
-  if (!documentation)
-    return documentation;
-  if (!isPremiumSkill(skill.name))
-    return documentation;
-  return [
-    `# ${skill.displayName || skill.name}`,
-    sanitizePublicDiscoveryText(skill.description),
-    `Pricing: ${getPublicSkillPricing(skill.name).formattedCost}.`,
-    "Set `SKILLS_API_KEY` or run `skills auth login` for hosted runtime execution. Runtime routing and model selection are managed by the hosted Skills runtime."
-  ].join(`
-
-`);
-}
-function escapeRegExp(value) {
-  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function resolveDiscoveryPricing(skill) {
-  return skill.pricing && typeof skill.pricing.formattedCost === "string" ? skill.pricing : getPublicSkillPricing(skill.name);
-}
 // src/lib/tool-primitives.ts
 var TOOL_PRIMITIVE_SCHEMA_VERSION = 1;
 var TOOL_PRIMITIVES = [
@@ -19265,7 +19355,7 @@ import { dirname as dirname4, relative as relative3 } from "path";
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.1.57",
+  version: "0.1.58",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {

package/dist/lib/hosted-availability.d.ts

@@ -1,3 +1,4 @@
+import type { SkillAvailabilityMetadata } from "./registry-types.js";
 export interface HostedRunUnavailable {
     ok: false;
     status: 503;
@@ -9,3 +10,4 @@ export type HostedRunAvailability = {
     ok: true;
 } | HostedRunUnavailable;
 export declare function getHostedRunAvailability(slug: string): HostedRunAvailability;
+export declare function getHostedAvailabilityMetadata(slug: string): SkillAvailabilityMetadata;

package/dist/lib/registry-types.d.ts

@@ -7,6 +7,7 @@ export interface SkillMeta {
     dependencies?: string[];
     version?: string;
     pricing?: SkillPricingMetadata;
+    availability?: SkillAvailabilityMetadata;
     source?: "official" | "custom" | "remote";
 }
 export interface SkillPricingMetadata {
@@ -21,6 +22,12 @@ export interface SkillPricingMetadata {
     quoteRequired?: boolean;
     description?: string;
 }
+export interface SkillAvailabilityMetadata {
+    status: "available" | "unavailable";
+    code?: string;
+    message?: string;
+    details?: string[];
+}
 export declare const CATEGORIES: readonly ["Development Tools", "Business & Marketing", "Productivity & Organization", "Project Management", "Content Generation", "Finance & Compliance", "Data & Analysis", "Media Processing", "Design & Branding", "Web & Browser", "Research & Writing", "Science & Academic", "Education & Learning", "Communication", "Health & Wellness", "Travel & Lifestyle", "Event Management"];
 export type Category = (typeof CATEGORIES)[number];
 export declare const BASIC_SKILL_NAMES: readonly ["image", "video", "audio", "music", "transcript", "audio-extract", "read-image", "read-pdf", "pdf-read", "pdf-to-markdown", "doc-read", "pdf-generate", "doc-generate", "read-csv", "read-excel", "excel", "convert"];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/skills",
-  "version": "0.1.57",
+  "version": "0.1.58",
   "description": "Skills library for AI coding agents",
   "type": "module",
   "bin": {