@inkeep/agents-cli 0.22.4 → 0.22.5

package/dist/index.js

@@ -234313,10 +234313,24 @@ ${errorText}`);
           if (response.status === 404) {
             throw new Error(`Project "${projectId}" not found`);
           }
-          if (response.status === 401) {
-            throw new Error("Unauthorized - check your API key");
-          }
-          throw new Error(`Failed to fetch project: ${response.statusText}`);
+          if (response.status === 401 || response.status === 403) {
+            const errorText2 = await response.text().catch(() => "");
+            let errorMessage = "Authentication failed - check your API key configuration\n\n";
+            errorMessage += "Common issues:\n";
+            errorMessage += "  \u2022 Missing or invalid API key in inkeep.config.ts\n";
+            errorMessage += "  \u2022 API key does not have access to this tenant/project\n";
+            errorMessage += "  \u2022 For local development, ensure INKEEP_AGENTS_MANAGE_API_BYPASS_SECRET is set\n";
+            if (errorText2) {
+              errorMessage += `
+Server response: ${errorText2}`;
+            }
+            throw new Error(errorMessage);
+          }
+          const errorText = await response.text().catch(() => "");
+          throw new Error(
+            `Failed to fetch project: ${response.statusText}${errorText ? `
+${errorText}` : ""}`
+          );
         }
         const responseData = await response.json();
         return responseData.data;
@@ -239011,13 +239025,24 @@ function createProjectStructure(projectDir, projectId, useCurrentDirectory = fal
 }
 async function pullProjectCommand(options) {
   performBackgroundVersionCheck();
-  if (!env2.ANTHROPIC_API_KEY) {
+  const anthropicKey = env2.ANTHROPIC_API_KEY?.trim();
+  if (!anthropicKey) {
+    console.error(
+      chalk9.red("\n\u274C Error: ANTHROPIC_API_KEY is required for the pull command")
+    );
     console.error(
-      chalk9.red("Error: ANTHROPIC_API_KEY environment variable is required for the pull command.")
+      chalk9.yellow(
+        "\nThe pull command uses AI to generate TypeScript files from your project configuration."
+      )
     );
-    console.error(chalk9.gray("Please set your Anthropic API key:"));
-    console.error(chalk9.gray("  export ANTHROPIC_API_KEY=your_api_key_here"));
-    console.error(chalk9.gray("  or add it to your .env file"));
+    console.error(chalk9.yellow("This requires a valid Anthropic API key.\n"));
+    console.error(chalk9.cyan("How to fix:"));
+    console.error(chalk9.gray("  1. Get an API key from: https://console.anthropic.com/"));
+    console.error(chalk9.gray("  2. Set it in your environment:"));
+    console.error(chalk9.gray("     export ANTHROPIC_API_KEY=your_api_key_here"));
+    console.error(chalk9.gray("  3. Or add it to your .env file:"));
+    console.error(chalk9.gray("     ANTHROPIC_API_KEY=your_api_key_here\n"));
+    console.error(chalk9.yellow("\u{1F4A1} Note: Make sure the value is not empty or whitespace-only"));
     process.exit(1);
   }
   const spinner = ora5("Loading configuration...").start();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-cli",
-  "version": "0.22.4",
+  "version": "0.22.5",
   "description": "Inkeep CLI tool",
   "type": "module",
   "main": "./dist/index.js",
@@ -46,8 +46,8 @@
     "recast": "^0.23.0",
     "ts-morph": "^26.0.0",
     "tsx": "^4.20.5",
-    "@inkeep/agents-core": "^0.22.4",
-    "@inkeep/agents-sdk": "^0.22.4"
+    "@inkeep/agents-core": "^0.22.5",
+    "@inkeep/agents-sdk": "^0.22.5"
   },
   "devDependencies": {
     "@types/degit": "^2.8.6",