@hasna/skills 0.1.55 → 0.1.57

package/bin/index.js

@@ -36860,7 +36860,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/skills",
-    version: "0.1.55",
+    version: "0.1.57",
     description: "Skills library for AI coding agents",
     type: "module",
     bin: {
@@ -60253,6 +60253,53 @@ 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 : {};
@@ -75774,7 +75821,7 @@ var MCP_CONTRACT_SCHEMA_VERSION = 1, stringSchema = (description) => ({
   type: "array",
   items,
   ...description ? { description } : {}
-}), skillNameInput, optionalAgentInput, scopeInput, runInputSchema, runArgsSchema, paidRunApprovalSchema, errorSchema, pricingSchema, skillSummarySchema, toolPrimitiveSummarySchema, skillToolDependencySchema, validationMessageSchema, validationOutputSchema, installOutputSchema, runOutputSchema, toolContracts, contracts, resourceContracts;
+}), skillNameInput, optionalAgentInput, scopeInput, runInputSchema, runArgsSchema, paidRunApprovalSchema, errorSchema, pricingSchema, skillAvailabilitySchema, skillSummarySchema, toolPrimitiveSummarySchema, skillToolDependencySchema, validationMessageSchema, validationOutputSchema, installOutputSchema, runOutputSchema, toolContracts, contracts, resourceContracts;
 var init_mcp_contracts = __esm(() => {
   skillNameInput = stringSchema("skill name or alias.");
   optionalAgentInput = stringSchema("Optional target agent slug. Use MCP registration instead of direct skill-folder installs.");
@@ -75812,6 +75859,16 @@ var init_mcp_contracts = __esm(() => {
     quoteDependsOnInput: { type: "boolean", description: "Whether input affects the quote." },
     quoteRequired: { type: "boolean", description: "Whether callers should quote before running." }
   }, [], "Public pricing metadata.");
+  skillAvailabilitySchema = objectSchema({
+    status: {
+      type: "string",
+      enum: ["available", "unavailable"],
+      description: "Whether hosted execution is currently available for this skill."
+    },
+    code: stringSchema("Optional stable unavailability code."),
+    message: stringSchema("Optional human-readable availability message."),
+    details: stringArraySchema("Optional availability details.")
+  }, ["status"], "Hosted skill availability metadata.");
   skillSummarySchema = objectSchema({
     name: stringSchema("Canonical skill slug."),
     category: stringSchema("Skill category."),
@@ -76167,7 +76224,14 @@ var init_mcp_contracts = __esm(() => {
       sideEffects: "none",
       stable: true,
       inputSchema: objectSchema({ name: skillNameInput, input: runInputSchema, args: runArgsSchema }, ["name"]),
-      outputSchema: objectSchema({ skill: stringSchema("Skill slug."), pricing: pricingSchema }, ["skill", "pricing"])
+      outputSchema: objectSchema({
+        skill: stringSchema("Skill slug."),
+        pricing: pricingSchema,
+        availability: skillAvailabilitySchema,
+        error: stringSchema("Optional error message when the quote cannot be used to run."),
+        code: stringSchema("Optional stable error code."),
+        details: stringArraySchema("Optional error details.")
+      }, ["skill", "pricing", "availability"])
     },
     {
       name: "run_skill",
@@ -77014,9 +77078,33 @@ function registerOperationTools(server) {
         return mcpError("INVALID_BLOG_ARTICLE_OPTIONS", validation.errors.join(" "));
       }
     }
+    const pricing = getPublicSkillPricing2(skill.name, runInput, runArgs);
+    const hostedAvailability = getHostedRunAvailability(skill.name);
+    if (!hostedAvailability.ok) {
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({
+            skill: skill.name,
+            pricing,
+            error: hostedAvailability.message,
+            code: hostedAvailability.code,
+            details: hostedAvailability.details,
+            availability: {
+              status: "unavailable",
+              code: hostedAvailability.code,
+              message: hostedAvailability.message,
+              details: hostedAvailability.details
+            }
+          })
+        }],
+        isError: true
+      };
+    }
     return mcpJson({
       skill: skill.name,
-      pricing: getPublicSkillPricing2(skill.name, runInput, runArgs)
+      pricing,
+      availability: { status: "available" }
     });
   });
   server.registerTool("run_skill", {
@@ -77059,6 +77147,18 @@ function registerOperationTools(server) {
       remote: isPremiumSkill2(skillName),
       costCents
     });
+    if (isPremiumSkill2(skillName)) {
+      const hostedAvailability = getHostedRunAvailability(skillName);
+      if (!hostedAvailability.ok) {
+        const error48 = `${hostedAvailability.code}: ${hostedAvailability.message}`;
+        writeRunLogs(runContext, "", `${error48}
+${hostedAvailability.details.join(`
+`)}
+`);
+        const run = completeSkillRun(runContext, { status: "failed", error: error48, costCents });
+        return mcpError(hostedAvailability.code, `${hostedAvailability.message}. ${hostedAvailability.details.join(" ")} Local run metadata: ${run.paths.runDir}/run.json`);
+      }
+    }
     if (isPremiumSkill2(skillName) && !apiKey) {
       const cost = formatCost2(costCents ?? 0);
       const error48 = `${skillName} is a hosted skill (${cost}). Run: skills setup --mode hosted && skills auth login`;
@@ -77302,6 +77402,7 @@ var init_operation_tools = __esm(() => {
   init_run_state();
   init_portable_skills();
   init_helpers();
+  init_hosted_availability();
 });
 
 // src/lib/feedback.ts
@@ -78710,7 +78811,20 @@ function handleQuote(name, args2, options) {
     }
   }
   const pricing = getPublicSkillPricing(skill.name, {}, quoteArgs);
-  const payload = { skill: skill.name, pricing };
+  const hostedAvailability = getHostedRunAvailability(skill.name);
+  if (!hostedAvailability.ok) {
+    const payload2 = unavailableHostedPayload(skill.name, pricing, hostedAvailability);
+    if (json2) {
+      console.log(JSON.stringify(payload2, null, 2));
+    } else {
+      console.error(source_default.red(`${skill.name}: ${hostedAvailability.message}`));
+      for (const detail of hostedAvailability.details)
+        console.error(source_default.dim(`  ${detail}`));
+    }
+    process.exitCode = 1;
+    return;
+  }
+  const payload = { skill: skill.name, pricing, availability: { status: "available" } };
   if (json2) {
     console.log(JSON.stringify(payload, null, 2));
     return;
@@ -78760,6 +78874,32 @@ async function handleRun(name, args2, options) {
     costCents
   });
   if (isPremium) {
+    const hostedAvailability = getHostedRunAvailability(skill.name);
+    if (!hostedAvailability.ok) {
+      const payload = unavailableHostedPayload(skill.name, publicPricing, hostedAvailability);
+      const error48 = `${hostedAvailability.code}: ${hostedAvailability.message}`;
+      writeRunLogs(runContext, "", `${error48}
+${hostedAvailability.details.join(`
+`)}
+`);
+      const run = completeSkillRun(runContext, { status: "failed", error: error48, costCents });
+      if (options.json) {
+        console.log(JSON.stringify({
+          contractVersion: REMOTE_SKILL_RUN_CONTRACT_VERSION,
+          args: args2,
+          exitCode: 1,
+          remote: true,
+          ...payload,
+          run
+        }, null, 2));
+      } else {
+        console.error(source_default.red(`${skill.name}: ${hostedAvailability.message}`));
+        for (const detail of hostedAvailability.details)
+          console.error(source_default.dim(`  ${detail}`));
+      }
+      process.exitCode = 1;
+      return;
+    }
     const { getApiKey: getApiKey2 } = await Promise.resolve().then(() => (init_auth_store(), exports_auth_store));
     const apiKey = getApiKey2();
     if (!apiKey) {
@@ -78912,6 +79052,21 @@ async function handleRun(name, args2, options) {
   }
   process.exitCode = result2.exitCode;
 }
+function unavailableHostedPayload(skill, pricing, availability) {
+  return {
+    skill,
+    pricing,
+    error: availability.message,
+    code: availability.code,
+    details: availability.details,
+    availability: {
+      status: "unavailable",
+      code: availability.code,
+      message: availability.message,
+      details: availability.details
+    }
+  };
+}
 async function approvePaidHostedRun(params) {
   if (params.yes)
     return { approved: true };
@@ -79355,6 +79510,7 @@ var init_runtime = __esm(() => {
   init_skillinfo();
   init_pricing();
   init_config();
+  init_hosted_availability();
   init_run_state();
   init_runtime_mcp();
 });
@@ -79822,6 +79978,18 @@ Next: skills schedule list --cursor ${page.nextOffset} --limit ${page.limit}`));
       return;
     }
     const dueDetails = await Promise.all(due.map((schedule) => describeDueSchedule(schedule)));
+    const unavailable = dueDetails.filter((schedule) => schedule.availability?.status === "unavailable");
+    if (unavailable.length > 0 && !options.dryRun) {
+      const code = unavailable[0]?.availability?.code ?? "HOSTED_PROVIDER_UNAVAILABLE";
+      const error48 = `Hosted execution is temporarily unavailable for ${unavailable.map((schedule) => schedule.skill).join(", ")}. No balance was charged.`;
+      if (options.json) {
+        console.log(JSON.stringify({ ran: 0, error: error48, code, unavailable, schedules: dueDetails }));
+      } else {
+        console.error(source_default.red(`\u2717 ${error48}`));
+      }
+      process.exitCode = 1;
+      return;
+    }
     const paidTotalCents = dueDetails.reduce((total, schedule) => total + (schedule.costCents ?? 0), 0);
     if (options.dryRun) {
       console.log(options.json ? JSON.stringify({ due: dueDetails, paidTotalCents, paidTotal: formatCost2(paidTotalCents) }) : source_default.bold(`${due.length} schedule(s) due:
@@ -79907,6 +80075,11 @@ async function executeScheduledSkill(skillName, args2, options) {
     throw new Error(`Skill '${skillName}' not found`);
   const pricing = await Promise.resolve().then(() => (init_pricing(), exports_pricing));
   if (pricing.isPremiumSkill(skill.name)) {
+    const { getHostedRunAvailability: getHostedRunAvailability2 } = await Promise.resolve().then(() => (init_hosted_availability(), exports_hosted_availability));
+    const hostedAvailability = getHostedRunAvailability2(skill.name);
+    if (!hostedAvailability.ok) {
+      throw new Error(`${hostedAvailability.code}: ${hostedAvailability.message}. ${hostedAvailability.details.join(" ")}`);
+    }
     const publicPricing = pricing.getPublicSkillPricing(skill.name, {}, args2);
     if (!options.allowPaid) {
       throw new Error(`${skill.name} is a paid hosted skill (${publicPricing.formattedCost}). Review with skills schedule run --dry-run, then rerun with --allow-paid --max-paid-cents ${publicPricing.costCents}.`);
@@ -79933,16 +80106,24 @@ async function executeScheduledSkill(skillName, args2, options) {
 async function describeDueSchedule(schedule) {
   const { getSkill: getSkill2 } = await Promise.resolve().then(() => (init_registry(), exports_registry));
   const pricing = await Promise.resolve().then(() => (init_pricing(), exports_pricing));
+  const { getHostedRunAvailability: getHostedRunAvailability2 } = await Promise.resolve().then(() => (init_hosted_availability(), exports_hosted_availability));
   const skill = getSkill2(schedule.skill);
   const paid = Boolean(skill && pricing.isPremiumSkill(skill.name));
   const publicPricing = paid && skill ? pricing.getPublicSkillPricing(skill.name, {}, schedule.args ?? []) : null;
+  const availability = skill ? getHostedRunAvailability2(skill.name) : { ok: true };
   return {
     name: schedule.name,
     skill: schedule.skill,
     cron: schedule.cron,
     paid,
     costCents: publicPricing?.costCents,
-    cost: publicPricing?.formattedCost
+    cost: publicPricing?.formattedCost,
+    availability: availability.ok ? { status: "available" } : {
+      status: "unavailable",
+      code: availability.code,
+      message: availability.message,
+      details: availability.details
+    }
   };
 }
 function parseMaxPaidCents(value) {

package/bin/mcp.js

@@ -21819,7 +21819,7 @@ class StdioServerTransport {
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.1.55",
+  version: "0.1.57",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {
@@ -33056,6 +33056,16 @@ var pricingSchema = objectSchema({
   quoteDependsOnInput: { type: "boolean", description: "Whether input affects the quote." },
   quoteRequired: { type: "boolean", description: "Whether callers should quote before running." }
 }, [], "Public pricing metadata.");
+var skillAvailabilitySchema = objectSchema({
+  status: {
+    type: "string",
+    enum: ["available", "unavailable"],
+    description: "Whether hosted execution is currently available for this skill."
+  },
+  code: stringSchema("Optional stable unavailability code."),
+  message: stringSchema("Optional human-readable availability message."),
+  details: stringArraySchema("Optional availability details.")
+}, ["status"], "Hosted skill availability metadata.");
 var skillSummarySchema = objectSchema({
   name: stringSchema("Canonical skill slug."),
   category: stringSchema("Skill category."),
@@ -33411,7 +33421,14 @@ var toolContracts = [
     sideEffects: "none",
     stable: true,
     inputSchema: objectSchema({ name: skillNameInput, input: runInputSchema, args: runArgsSchema }, ["name"]),
-    outputSchema: objectSchema({ skill: stringSchema("Skill slug."), pricing: pricingSchema }, ["skill", "pricing"])
+    outputSchema: objectSchema({
+      skill: stringSchema("Skill slug."),
+      pricing: pricingSchema,
+      availability: skillAvailabilitySchema,
+      error: stringSchema("Optional error message when the quote cannot be used to run."),
+      code: stringSchema("Optional stable error code."),
+      details: stringArraySchema("Optional error details.")
+    }, ["skill", "pricing", "availability"])
   },
   {
     name: "run_skill",
@@ -34829,6 +34846,45 @@ function mimeForPath(path) {
       return "application/octet-stream";
   }
 }
+// src/lib/hosted-availability.ts
+init_skill_aliases();
+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."
+    ]
+  };
+}
 
 // src/mcp/operation-tools.ts
 function registerOperationTools(server) {
@@ -35045,9 +35101,33 @@ function registerOperationTools(server) {
         return mcpError("INVALID_BLOG_ARTICLE_OPTIONS", validation.errors.join(" "));
       }
     }
+    const pricing = getPublicSkillPricing2(skill.name, runInput, runArgs);
+    const hostedAvailability = getHostedRunAvailability(skill.name);
+    if (!hostedAvailability.ok) {
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({
+            skill: skill.name,
+            pricing,
+            error: hostedAvailability.message,
+            code: hostedAvailability.code,
+            details: hostedAvailability.details,
+            availability: {
+              status: "unavailable",
+              code: hostedAvailability.code,
+              message: hostedAvailability.message,
+              details: hostedAvailability.details
+            }
+          })
+        }],
+        isError: true
+      };
+    }
     return mcpJson({
       skill: skill.name,
-      pricing: getPublicSkillPricing2(skill.name, runInput, runArgs)
+      pricing,
+      availability: { status: "available" }
     });
   });
   server.registerTool("run_skill", {
@@ -35090,6 +35170,18 @@ function registerOperationTools(server) {
       remote: isPremiumSkill2(skillName),
       costCents
     });
+    if (isPremiumSkill2(skillName)) {
+      const hostedAvailability = getHostedRunAvailability(skillName);
+      if (!hostedAvailability.ok) {
+        const error48 = `${hostedAvailability.code}: ${hostedAvailability.message}`;
+        writeRunLogs(runContext, "", `${error48}
+${hostedAvailability.details.join(`
+`)}
+`);
+        const run = completeSkillRun(runContext, { status: "failed", error: error48, costCents });
+        return mcpError(hostedAvailability.code, `${hostedAvailability.message}. ${hostedAvailability.details.join(" ")} Local run metadata: ${run.paths.runDir}/run.json`);
+      }
+    }
     if (isPremiumSkill2(skillName) && !apiKey) {
       const cost = formatCost2(costCents ?? 0);
       const error48 = `${skillName} is a hosted skill (${cost}). Run: skills setup --mode hosted && skills auth login`;

package/dist/index.js

@@ -19265,7 +19265,7 @@ import { dirname as dirname4, relative as relative3 } from "path";
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.1.55",
+  version: "0.1.57",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {
@@ -19491,6 +19491,16 @@ var pricingSchema = objectSchema({
   quoteDependsOnInput: { type: "boolean", description: "Whether input affects the quote." },
   quoteRequired: { type: "boolean", description: "Whether callers should quote before running." }
 }, [], "Public pricing metadata.");
+var skillAvailabilitySchema = objectSchema({
+  status: {
+    type: "string",
+    enum: ["available", "unavailable"],
+    description: "Whether hosted execution is currently available for this skill."
+  },
+  code: stringSchema("Optional stable unavailability code."),
+  message: stringSchema("Optional human-readable availability message."),
+  details: stringArraySchema("Optional availability details.")
+}, ["status"], "Hosted skill availability metadata.");
 var skillSummarySchema = objectSchema({
   name: stringSchema("Canonical skill slug."),
   category: stringSchema("Skill category."),
@@ -19846,7 +19856,14 @@ var toolContracts = [
     sideEffects: "none",
     stable: true,
     inputSchema: objectSchema({ name: skillNameInput, input: runInputSchema, args: runArgsSchema }, ["name"]),
-    outputSchema: objectSchema({ skill: stringSchema("Skill slug."), pricing: pricingSchema }, ["skill", "pricing"])
+    outputSchema: objectSchema({
+      skill: stringSchema("Skill slug."),
+      pricing: pricingSchema,
+      availability: skillAvailabilitySchema,
+      error: stringSchema("Optional error message when the quote cannot be used to run."),
+      code: stringSchema("Optional stable error code."),
+      details: stringArraySchema("Optional error details.")
+    }, ["skill", "pricing", "availability"])
   },
   {
     name: "run_skill",

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

@@ -0,0 +1,11 @@
+export interface HostedRunUnavailable {
+    ok: false;
+    status: 503;
+    code: "HOSTED_PROVIDER_UNAVAILABLE";
+    message: string;
+    details: string[];
+}
+export type HostedRunAvailability = {
+    ok: true;
+} | HostedRunUnavailable;
+export declare function getHostedRunAvailability(slug: string): HostedRunAvailability;

package/package.json

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