@autonoma-ai/planner 0.1.5 → 0.1.6

package/dist/index.js

@@ -65,7 +65,7 @@ var init_context = __esm({
 import { createOpenRouter } from "@openrouter/ai-sdk-provider";
 function getProvider() {
   if (provider == null) {
-    const apiKey = process.env.OPENROUTER_API_KEY;
+    const apiKey = process.env.OPENROUTER_API_KEY?.trim();
     if (!apiKey) throw new Error("OPENROUTER_API_KEY is required");
     provider = createOpenRouter({ apiKey });
   }
@@ -103,6 +103,9 @@ function getIdentity() {
   const id = process.env.AUTONOMA_DISTINCT_ID?.trim();
   return id && id.length > 0 ? id : void 0;
 }
+function getRunId() {
+  return RUN_ID;
+}
 function getDeviceId() {
   if (cachedDeviceId) return cachedDeviceId;
   try {
@@ -190,6 +193,60 @@ import { APICallError, RetryError, LoadAPIKeyError, InvalidPromptError, NoSuchMo
 function sleep(ms) {
   return new Promise((resolve5) => setTimeout(resolve5, ms));
 }
+function chainMessages(err) {
+  const parts = [];
+  let cur = err;
+  for (let depth = 0; cur != null && depth < 10; depth++) {
+    if (cur instanceof Error) {
+      parts.push(cur.message);
+      cur = cur.cause;
+    } else {
+      parts.push(String(cur));
+      break;
+    }
+  }
+  return parts.join(" \u2190 ").toLowerCase();
+}
+function describeKnownError(err) {
+  const msg = chainMessages(err);
+  const status = APICallError.isInstance(err) ? err.statusCode : void 0;
+  const looksLikeAuth = msg.includes("missing authentication header") || msg.includes("no auth credentials") || msg.includes("openrouter_api_key") || msg.includes("user not found") || status === 401 || status === 403;
+  if (looksLikeAuth) {
+    return {
+      title: "OpenRouter rejected the request \u2014 your API key looks missing or invalid.",
+      hint: "Set a valid OPENROUTER_API_KEY (https://openrouter.ai/keys). If it's already set, the key may be revoked, empty, or have a stray space."
+    };
+  }
+  if (msg.includes("insufficient") || msg.includes("credits") || msg.includes("quota") || status === 402) {
+    return {
+      title: "OpenRouter ran out of credits for this account.",
+      hint: "Top up your balance at https://openrouter.ai/credits, then re-run."
+    };
+  }
+  if (NoSuchModelError.isInstance(err) || msg.includes("not a valid model") || msg.includes("no endpoints found") || msg.includes("model not found")) {
+    return {
+      title: "The requested model isn't available on OpenRouter.",
+      hint: "Check OPENROUTER_MODEL, or unset it to use the default."
+    };
+  }
+  if (msg.includes("rate limit") || msg.includes("too many requests") || status === 429) {
+    return {
+      title: "OpenRouter is rate-limiting this account.",
+      hint: "Wait a minute and re-run. If it persists, your key may be on a low-throughput tier."
+    };
+  }
+  return null;
+}
+function supportReference(extra = {}) {
+  const fields = {
+    ref: getRunId(),
+    version: process.env.npm_package_version,
+    node: process.version,
+    platform: `${process.platform}-${process.arch}`,
+    ...extra
+  };
+  return Object.entries(fields).filter(([, v]) => v != null && v !== "").map(([k, v]) => `${k}: ${v}`).join("  ");
+}
 function formatException(err) {
   if (!(err instanceof Error)) return String(err);
   let out = err.stack ?? `${err.name}: ${err.message}`;
@@ -223,11 +280,22 @@ function classifyAgentError(err) {
   }
   return "transient";
 }
-var FATAL_STATUS_CODES, TRANSIENT_MESSAGE_PATTERNS;
+var AgentError, FATAL_STATUS_CODES, TRANSIENT_MESSAGE_PATTERNS;
 var init_errors = __esm({
   "src/core/errors.ts"() {
     "use strict";
     init_esm_shims();
+    init_analytics();
+    AgentError = class extends Error {
+      constructor(message, phase, cause) {
+        super(message);
+        this.phase = phase;
+        this.cause = cause;
+        this.name = "AgentError";
+      }
+      phase;
+      cause;
+    };
     FATAL_STATUS_CODES = /* @__PURE__ */ new Set([400, 401, 403, 404, 422]);
     TRANSIENT_MESSAGE_PATTERNS = [
       "econnreset",
@@ -481,6 +549,15 @@ function buildStepHandler(config) {
 async function runAgent(config, prompt, extractResult) {
   const stepTimeout = config.stepTimeoutMs ?? STEP_TIMEOUT_MS;
   const modelsToTry = [config.model, ...FALLBACK_MODELS.map((id) => getModel(id))];
+  const modelIdOf = (m) => typeof m === "string" ? m : m.modelId;
+  const fail = (err, model) => {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new AgentError(
+      `agent "${config.id}" (model ${modelIdOf(model)}) failed: ${msg}`,
+      config.id,
+      err
+    );
+  };
   const YELLOW5 = "\x1B[33m";
   const RESET8 = "\x1B[0m";
   for (let modelIdx = 0; modelIdx < modelsToTry.length; modelIdx++) {
@@ -520,7 +597,7 @@ async function runAgent(config, prompt, extractResult) {
         return extractResult();
       } catch (err) {
         const errorClass = classifyAgentError(err);
-        if (errorClass === "fatal") throw err;
+        if (errorClass === "fatal") fail(err, model);
         const msg = err instanceof Error ? err.message : String(err);
         if (errorClass === "timeout") {
           console.log(`  ${YELLOW5}[${config.id}] step timed out after ${stepTimeout / 1e3}s${RESET8}`);
@@ -544,7 +621,7 @@ async function runAgent(config, prompt, extractResult) {
           );
           break;
         }
-        throw err;
+        fail(err, model);
       }
     }
   }
@@ -6585,6 +6662,7 @@ function nextPendingStep(state) {
 }
 
 // src/index.ts
+process.setSourceMapsEnabled(true);
 var PAGES_FILE = "pages.json";
 async function savePages(outputDir, pages) {
   const obj = Object.fromEntries(pages);
@@ -6747,10 +6825,17 @@ async function runStep(step, outputDir, state, config, projectContext, nonIntera
     }
   } catch (err) {
     state = await markStep(outputDir, state, step, "failed");
-    const message = err instanceof Error ? err.message : String(err);
-    p9.log.error(`Failed: ${label} \u2014 ${message}`);
-    console.error(`\x1B[2m${formatException(err)}\x1B[0m`);
-    p9.log.info("If you report this, please include the error output above.");
+    const known = describeKnownError(err);
+    if (known) {
+      p9.log.error(`Failed: ${label} \u2014 ${known.title}`);
+      p9.log.info(known.hint);
+    } else {
+      const message = err instanceof Error ? err.message : String(err);
+      p9.log.error(`Failed: ${label} \u2014 ${message}`);
+      console.error(`\x1B[2m${formatException(err)}\x1B[0m`);
+      console.error(`\x1B[2m${supportReference({ step })}\x1B[0m`);
+      p9.log.info("If you report this, please include the error output above.");
+    }
     trackError(err, { step, source: "step_exception" });
   }
   track("cli_step_completed", {
@@ -7034,6 +7119,7 @@ Continue?`
       const message = err instanceof Error ? err.message : String(err);
       p9.log.error(`Failed to upload artifacts: ${message}`);
       console.error(`\x1B[2m${formatException(err)}\x1B[0m`);
+      console.error(`\x1B[2m${supportReference({ phase: "artifact_upload" })}\x1B[0m`);
       p9.log.info(`Your artifacts are saved in ${outputDir}. Re-run the CLI to retry the upload.`);
       track("cli_artifacts_upload_failed", { message });
       trackError(err, { source: "artifact_upload" });
@@ -7042,7 +7128,14 @@ Continue?`
   p9.outro("Done");
 }
 main().then(() => flushAnalytics()).catch(async (err) => {
-  console.error(err);
+  const known = describeKnownError(err);
+  if (known) {
+    console.error(`\x1B[31m${known.title}\x1B[0m`);
+    console.error(known.hint);
+  } else {
+    console.error(err);
+    console.error(`\x1B[2m${supportReference()}\x1B[0m`);
+  }
   trackError(err, { source: "uncaught" }, false);
   await flushAnalytics();
   process.exit(1);