openagentflow 0.1.4 → 0.1.5

package/adapters/langgraph/templates.js

@@ -224,7 +224,7 @@ export function generateLlmHelperTemplate({ defaultModel, defaultTemperature })
     `            raise RuntimeError("Missing package: pip install langchain-anthropic")`,
     `    else:`,
     `        raise RuntimeError(`,
-    `            "No LLM provider available or configured. Set GOOGLE_API_KEY (Gemini), OPENAI_API_KEY (OpenAI), or ANTHROPIC_API_KEY (Anthropic)."`,
+    `            "No LLM provider available or configured. Run 'npx openagentflow auth' to set up credentials, or set GOOGLE_API_KEY / OPENAI_API_KEY / ANTHROPIC_API_KEY in your local .env file."`,
     `        )`,
     ``,
     `def _parse_llm_output(raw_content, outputs):`,
@@ -431,8 +431,8 @@ export function generateMainTemplate({ workflowName, initialStateFields, require
     `    # Ensure at least one API key is set`,
     `    if not _LLM_PROVIDER:`,
     `        print("Error: No LLM provider configured.")`,
-    `        print("  Set GOOGLE_API_KEY (Gemini, preferred) or OPENAI_API_KEY (OpenAI).")`,
-    `        print("  Example: export GOOGLE_API_KEY='your-key-here'")`,
+    `        print("  Run 'npx openagentflow auth' to configure credentials or edit your local .env file.")`,
+    `        print("  Or set manually: export GOOGLE_API_KEY='AIza...'")`,
     `        exit(1)`,
     ``,
     `    print(f"Default fallback provider: {_LLM_PROVIDER}")`,

package/cli/env.js

@@ -55,6 +55,29 @@ export function parseDotEnv(content) {
   return result;
 }
 
+/**
+ * Check if an environment variable value is a dummy placeholder string or unset.
+ * Returns true if val is null, undefined, empty, or contains typical template placeholder markers.
+ */
+export function isPlaceholder(val) {
+  if (val === null || val === undefined || typeof val !== 'string') {
+    return true;
+  }
+  const trimmed = val.trim();
+  if (trimmed === '') {
+    return true;
+  }
+  const lower = trimmed.toLowerCase();
+  return (
+    lower.startsWith('your_') ||
+    lower.startsWith('your-') ||
+    lower.includes('_here') ||
+    lower.includes('-here') ||
+    lower === 'todo' ||
+    lower === 'placeholder'
+  );
+}
+
 /**
  * Resolve environment variables across the 4-tier hierarchy:
  * 1. Inline CLI overrides & System Environment Variables (already in process.env)
@@ -82,23 +105,24 @@ export function resolveEnvHierarchy(targetFilePath = null) {
     } catch (err) {}
   }
 
-  let localEnvPath = null;
-  if (targetFilePath && existsSync(targetFilePath)) {
-    const absTarget = resolve(targetFilePath);
+  let localEnv = {};
+  const cwdEnvPath = join(process.cwd(), '.env');
+  let localEnvPath = cwdEnvPath;
+  if (existsSync(cwdEnvPath)) {
     try {
-      const dir = statSync(absTarget).isDirectory() ? absTarget : dirname(absTarget);
-      localEnvPath = join(dir, '.env');
-    } catch (err) {
-      localEnvPath = join(process.cwd(), '.env');
-    }
-  } else {
-    localEnvPath = join(process.cwd(), '.env');
+      localEnv = parseDotEnv(readFileSync(cwdEnvPath, 'utf-8'));
+    } catch (err) {}
   }
 
-  let localEnv = {};
-  if (localEnvPath && existsSync(localEnvPath)) {
+  if (targetFilePath && existsSync(targetFilePath)) {
+    const absTarget = resolve(targetFilePath);
     try {
-      localEnv = parseDotEnv(readFileSync(localEnvPath, 'utf-8'));
+      const dir = statSync(absTarget).isDirectory() ? absTarget : dirname(absTarget);
+      const targetEnvPath = join(dir, '.env');
+      if (resolve(targetEnvPath) !== resolve(cwdEnvPath) && existsSync(targetEnvPath)) {
+        localEnvPath = targetEnvPath;
+        Object.assign(localEnv, parseDotEnv(readFileSync(targetEnvPath, 'utf-8')));
+      }
     } catch (err) {}
   }
 

package/cli/index.js

@@ -25,7 +25,7 @@ import os from 'os';
 import { Compiler } from '../compiler/compiler.js';
 import { VERSION } from '../compiler/version.js';
 import { LangGraphAdapter } from '../adapters/langgraph/index.js';
-import { resolveEnvHierarchy, setupAuth } from './env.js';
+import { resolveEnvHierarchy, setupAuth, isPlaceholder } from './env.js';
 
 // ─── ANSI Colors ───────────────────────────────────────────────────────────────
 
@@ -333,44 +333,48 @@ function cmdRun(filePath, flags, positional = []) {
         else if (targetModel.startsWith('gemini-') || targetModel.startsWith('gemma-')) provider = 'gemini';
       }
 
-      if (provider === 'anthropic' && !process.env.ANTHROPIC_API_KEY) {
+      if (provider === 'anthropic' && (!process.env.ANTHROPIC_API_KEY || isPlaceholder(process.env.ANTHROPIC_API_KEY))) {
         console.error(`${colors.red}Error:${colors.reset} Missing required API key "ANTHROPIC_API_KEY" for agent "${agent.id}" (provider: anthropic).`);
         console.error(`Looked in order of priority:`);
         console.error(`  1. Inline CLI overrides`);
         console.error(`  2. Local Project .env`);
         console.error(`  3. System Environment Variables`);
         console.error(`  4. Global OAF Store (~/.oaf/.env)`);
-        console.error(`Run \`oaf auth\` to set up your global credentials or create a local .env file.`);
+        console.error(`Run \`npx openagentflow auth\` (or \`oaf auth\` if globally installed) to set up your credentials or edit your local .env file.`);
         process.exit(1);
-      } else if (provider === 'openai' && !process.env.OPENAI_API_KEY) {
+      } else if (provider === 'openai' && (!process.env.OPENAI_API_KEY || isPlaceholder(process.env.OPENAI_API_KEY))) {
         console.error(`${colors.red}Error:${colors.reset} Missing required API key "OPENAI_API_KEY" for agent "${agent.id}" (provider: openai).`);
         console.error(`Looked in order of priority:`);
         console.error(`  1. Inline CLI overrides`);
         console.error(`  2. Local Project .env`);
         console.error(`  3. System Environment Variables`);
         console.error(`  4. Global OAF Store (~/.oaf/.env)`);
-        console.error(`Run \`oaf auth\` to set up your global credentials or create a local .env file.`);
+        console.error(`Run \`npx openagentflow auth\` (or \`oaf auth\` if globally installed) to set up your credentials or edit your local .env file.`);
         process.exit(1);
-      } else if (provider === 'gemini' && !process.env.GOOGLE_API_KEY) {
+      } else if (provider === 'gemini' && (!process.env.GOOGLE_API_KEY || isPlaceholder(process.env.GOOGLE_API_KEY))) {
         console.error(`${colors.red}Error:${colors.reset} Missing required API key "GOOGLE_API_KEY" for agent "${agent.id}" (provider: gemini).`);
         console.error(`Looked in order of priority:`);
         console.error(`  1. Inline CLI overrides`);
         console.error(`  2. Local Project .env`);
         console.error(`  3. System Environment Variables`);
         console.error(`  4. Global OAF Store (~/.oaf/.env)`);
-        console.error(`Run \`oaf auth\` to set up your global credentials or create a local .env file.`);
+        console.error(`Run \`npx openagentflow auth\` (or \`oaf auth\` if globally installed) to set up your credentials or edit your local .env file.`);
         process.exit(1);
       }
     }
 
-    if (!process.env.GOOGLE_API_KEY && !process.env.OPENAI_API_KEY && !process.env.ANTHROPIC_API_KEY && result.ir.agents.length > 0) {
+    const hasValidGoogle = process.env.GOOGLE_API_KEY && !isPlaceholder(process.env.GOOGLE_API_KEY);
+    const hasValidOpenAI = process.env.OPENAI_API_KEY && !isPlaceholder(process.env.OPENAI_API_KEY);
+    const hasValidAnthropic = process.env.ANTHROPIC_API_KEY && !isPlaceholder(process.env.ANTHROPIC_API_KEY);
+
+    if (!hasValidGoogle && !hasValidOpenAI && !hasValidAnthropic && result.ir.agents.length > 0) {
       console.error(`${colors.red}Error:${colors.reset} No LLM API key configured. Set GOOGLE_API_KEY (Gemini), OPENAI_API_KEY (OpenAI), or ANTHROPIC_API_KEY (Anthropic) to execute workflows.`);
       console.error(`Looked in order of priority:`);
       console.error(`  1. Inline CLI overrides`);
       console.error(`  2. Local Project .env`);
       console.error(`  3. System Environment Variables`);
       console.error(`  4. Global OAF Store (~/.oaf/.env)`);
-      console.error(`Run \`oaf auth\` to set up your global credentials or create a local .env file.`);
+      console.error(`Run \`npx openagentflow auth\` (or \`oaf auth\` if globally installed) to set up your credentials or edit your local .env file.`);
       process.exit(1);
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openagentflow",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "An open, portable specification for describing AI agent workflows using a human-readable text language.",
   "type": "module",
   "main": "compiler/index.js",