@elisym/cli 0.12.0 → 0.13.0

package/README.md

@@ -127,6 +127,8 @@ my-project/
 
 Skills are defined in `SKILL.md` files inside `./skills/<skill-name>/`. Each file has YAML frontmatter (between `---` delimiters) that describes the skill, followed by a markdown body that becomes the LLM system prompt.
 
+> Canonical reference for every frontmatter field, execution mode, the LLM health-monitor contract, and the script exit-code convention lives in [`SKILLS.md`](./SKILLS.md). The summary below covers the common cases; consult `SKILLS.md` for the full schema.
+
 ```markdown
 ---
 name: youtube-summary

package/dist/index.js

@@ -1969,6 +1969,13 @@ function resolveJobAsset(tags, skills) {
   return skill?.asset ?? NATIVE_SOL;
 }
 var BILLING_BODY_MARKERS3 = ["credit balance", "billing", "insufficient", "insufficient_quota"];
+var AGENT_UNAVAILABLE_MESSAGE = "Agent temporarily unavailable";
+var AgentUnavailableError = class extends Error {
+  constructor() {
+    super(AGENT_UNAVAILABLE_MESSAGE);
+    this.name = "AgentUnavailableError";
+  }
+};
 function bodyLooksLikeBilling3(body) {
   const lower = body.toLowerCase();
   return BILLING_BODY_MARKERS3.some((marker) => lower.includes(marker));
@@ -2064,7 +2071,7 @@ var AgentRuntime = class {
    */
   markHealthFromExecuteError(skill, err, log, jobId) {
     if (!this.healthMonitor) {
-      return;
+      return false;
     }
     const tag = `[${jobId.slice(0, 8)}]`;
     if (err instanceof ScriptBillingExhaustedError) {
@@ -2074,19 +2081,19 @@ var AgentRuntime = class {
         log(
           `${tag} Script returned exit ${err.exitCode} (billing-exhausted) but skill "${skill.name}" did not declare provider/model in SKILL.md - cannot gate future jobs.`
         );
-        return;
+        return false;
       }
       log(
         `${tag} Script signaled billing-exhausted (exit ${err.exitCode}). Marking ${provider}/${model} unhealthy; future jobs against this pair will be refused until recovery probe succeeds.`
       );
       this.healthMonitor.markUnhealthyFromJob(provider, model, "billing", err.message);
-      return;
+      return true;
     }
     if (skill.mode === "llm" && skill.resolvedTriple) {
       const message = err instanceof Error ? err.message : String(err);
       const match = /API error:\s*(\d{3})\b\s*(.*)/i.exec(message);
       if (!match) {
-        return;
+        return false;
       }
       const status = Number(match[1]);
       const body = (match[2] ?? "").slice(0, 200);
@@ -2095,7 +2102,7 @@ var AgentRuntime = class {
       const isBilling400 = status === 400 && bodyLooksLikeBilling3(body);
       const isBilling429 = status === 429 && bodyLooksLikeBilling3(body);
       if (!isBillingStatus && !isAuthStatus && !isBilling400 && !isBilling429) {
-        return;
+        return false;
       }
       const reason = isAuthStatus ? "invalid" : "billing";
       const provider = skill.resolvedTriple.provider;
@@ -2104,7 +2111,9 @@ var AgentRuntime = class {
         `${tag} LLM provider returned HTTP ${status} (${reason}). Marking ${provider}/${model} unhealthy; future jobs against this pair will be refused until recovery probe succeeds.`
       );
       this.healthMonitor.markUnhealthyFromJob(provider, model, reason, body);
+      return true;
     }
+    return false;
   }
   /** Fetch on-chain protocol config (fee, treasury). Always fetches fresh to avoid stale treasury. */
   async fetchProtocolConfig() {
@@ -2271,7 +2280,14 @@ var AgentRuntime = class {
         this.ledger.markFailed(job.jobId);
       }
       this.callbacks.onJobError?.(job.jobId, e.message);
-      const safeMessage = e.message?.includes("API") ? "Internal processing error" : e.message ?? "Unknown error";
+      let safeMessage;
+      if (e instanceof AgentUnavailableError) {
+        safeMessage = e.message;
+      } else if (e.message?.includes("API")) {
+        safeMessage = "Internal processing error";
+      } else {
+        safeMessage = e.message ?? "Unknown error";
+      }
       await this.transport.sendFeedback(job, { type: "error", message: safeMessage }).catch(() => {
       });
     } finally {
@@ -2295,7 +2311,7 @@ var AgentRuntime = class {
         log(`[${job.jobId.slice(0, 8)}] LLM health gate refused job: ${detail}`);
         await this.transport.sendFeedback(job, {
           type: "error",
-          message: "Service temporarily unavailable, try again later"
+          message: AGENT_UNAVAILABLE_MESSAGE
         }).catch(() => {
         });
         return;
@@ -2348,7 +2364,10 @@ var AgentRuntime = class {
         { ...this.skillCtx, signal }
       );
     } catch (err) {
-      this.markHealthFromExecuteError(skill, err, log, job.jobId);
+      const flippedToUnhealthy = this.markHealthFromExecuteError(skill, err, log, job.jobId);
+      if (flippedToUnhealthy) {
+        throw new AgentUnavailableError();
+      }
       throw err;
     }
     this.ledger.markExecuted(job.jobId, output.data);