openagentflow 0.1.3 → 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

@@ -23,8 +23,9 @@ import { fileURLToPath } from 'url';
 import { execSync, spawn } from 'child_process';
 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 ───────────────────────────────────────────────────────────────
 
@@ -42,7 +43,7 @@ const colors = {
 // ─── Helpers ───────────────────────────────────────────────────────────────────
 
 function printBanner() {
-  console.log(`${colors.cyan}${colors.bold}OpenAgentFlow${colors.reset} ${colors.dim}v0.1.0${colors.reset}`);
+  console.log(`${colors.cyan}${colors.bold}OpenAgentFlow${colors.reset} ${colors.dim}v${VERSION}${colors.reset}`);
   console.log();
 }
 
@@ -332,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);
     }
   }
@@ -546,7 +551,7 @@ function main() {
   }
 
   if (rawArgs.includes('--version') || rawArgs.includes('-v')) {
-    console.log('0.1.0');
+    console.log(VERSION);
     process.exit(0);
   }
 

package/compiler/index.js

@@ -5,3 +5,4 @@
 export { Compiler, CompilationResult } from './compiler.js';
 export { SemanticValidator, Diagnostic, ValidationResult } from './validator.js';
 export { IRGenerator } from './ir-generator.js';
+export { VERSION, getVersion } from './version.js';

package/compiler/ir-generator.js

@@ -7,7 +7,9 @@
  * Pipeline: Validated AST → [IR Generator] → IR (JSON)
  */
 
-const IR_VERSION = '0.1.0';
+import { VERSION } from './version.js';
+
+const IR_VERSION = VERSION;
 
 export class IRGenerator {
   /**

package/compiler/version.js

@@ -0,0 +1,26 @@
+/**
+ * OpenAgentFlow Version Utility
+ *
+ * Dynamically loads and caches the current version from package.json
+ * to ensure a single source of truth across the compiler, CLI, and adapters.
+ */
+
+import { readFileSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+let cachedVersion = null;
+
+export function getVersion() {
+  if (cachedVersion !== null) return cachedVersion;
+  try {
+    const pkgPath = resolve(dirname(fileURLToPath(import.meta.url)), '..', 'package.json');
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    cachedVersion = pkg.version || '0.1.0';
+  } catch {
+    cachedVersion = '0.1.0';
+  }
+  return cachedVersion;
+}
+
+export const VERSION = getVersion();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openagentflow",
-  "version": "0.1.3",
+  "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",
@@ -24,6 +24,9 @@
   ],
   "scripts": {
     "test": "node --test tests/**/*.test.js",
+    "test:update-snapshots": "node -e \"process.env.UPDATE_SNAPSHOTS='1'; import('./tests/snapshot.test.js')\"",
+    "preversion": "npm test",
+    "version": "npm run test:update-snapshots && git add tests/snapshots",
     "oaf": "node cli/index.js"
   },
   "keywords": [