claudekit-cli 3.41.3-dev.3 → 3.41.4-dev.1

package/dist/index.js

@@ -45409,6 +45409,9 @@ var VALIDATION_PATTERNS;
 var init_config_validator = __esm(() => {
   VALIDATION_PATTERNS = {
     GEMINI_API_KEY: /^AIza[0-9A-Za-z_-]{35}$/,
+    OPENROUTER_API_KEY: /^sk-or-v1-[A-Za-z0-9_-]+$/,
+    MINIMAX_API_KEY: /^[A-Za-z0-9_-]{16,}$/,
+    IMAGE_GEN_PROVIDER: /^(auto|google|openrouter|minimax)$/,
     DISCORD_WEBHOOK_URL: /^https:\/\/discord\.com\/api\/webhooks\//,
     TELEGRAM_BOT_TOKEN: /^\d+:[A-Za-z0-9_-]{35}$/
   };
@@ -57323,7 +57326,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "claudekit-cli",
-    version: "3.41.3-dev.3",
+    version: "3.41.4-dev.1",
     description: "CLI tool for bootstrapping and updating ClaudeKit projects",
     type: "module",
     repository: {
@@ -72021,13 +72024,17 @@ var setupCommandHelp;
 var init_setup_command_help = __esm(() => {
   setupCommandHelp = {
     name: "setup",
-    description: "Run guided setup for API keys and optional packages",
+    description: "Run guided setup for provider API keys, preferred image provider, and optional packages",
     usage: "ck setup [options]",
     examples: [
       {
         command: "ck setup",
         description: "Run setup wizard in current project"
       },
+      {
+        command: "ck setup --global",
+        description: "Configure global provider keys and a preferred image-generation path"
+      },
       {
         command: "ck setup --global --skip-packages",
         description: "Configure global setup without package installation"
@@ -78650,42 +78657,131 @@ init_path_resolver();
 init_dist2();
 var import_fs_extra9 = __toESM(require_lib(), 1);
 import { join as join65 } from "node:path";
+var IMAGE_PROVIDER_ENV_KEYS = [
+  "GEMINI_API_KEY",
+  "OPENROUTER_API_KEY",
+  "MINIMAX_API_KEY"
+];
+var IMAGE_PROVIDER_KEY_MAP = {
+  GEMINI_API_KEY: "google",
+  OPENROUTER_API_KEY: "openrouter",
+  MINIMAX_API_KEY: "minimax"
+};
+var IMAGE_PROVIDER_VALIDATION_PATTERNS = {
+  GEMINI_API_KEY: VALIDATION_PATTERNS.GEMINI_API_KEY,
+  OPENROUTER_API_KEY: VALIDATION_PATTERNS.OPENROUTER_API_KEY,
+  MINIMAX_API_KEY: VALIDATION_PATTERNS.MINIMAX_API_KEY
+};
+var IMAGE_PROVIDER_META = {
+  auto: {
+    label: "Auto-detect provider",
+    hint: "Prefer Gemini when configured; otherwise fall back through your remaining provider path"
+  },
+  google: {
+    label: "Google Gemini",
+    hint: "Best fit when you want Gemini analysis plus Google image generation"
+  },
+  openrouter: {
+    label: "OpenRouter",
+    hint: "Use routed image models through OpenRouter"
+  },
+  minimax: {
+    label: "MiniMax",
+    hint: "Use MiniMax as the default image/media provider path"
+  }
+};
 var REQUIRED_ENV_KEYS = [
-  { key: "GEMINI_API_KEY", label: "Gemini API Key" }
+  {
+    key: "IMAGE_PROVIDER_API_KEY",
+    label: "Image generation provider API key",
+    alternativeKeys: [...IMAGE_PROVIDER_ENV_KEYS]
+  }
 ];
+function isImageProviderEnvKey(key) {
+  return IMAGE_PROVIDER_ENV_KEYS.includes(key);
+}
+function hasValidImageProviderValue(key, value) {
+  if (!value || value.trim() === "") {
+    return false;
+  }
+  return validateApiKey2(value.trim(), IMAGE_PROVIDER_VALIDATION_PATTERNS[key]);
+}
 async function checkRequiredKeysExist(envPath) {
   const envExists = await import_fs_extra9.pathExists(envPath);
   if (!envExists) {
-    return { allPresent: false, missing: REQUIRED_ENV_KEYS, envExists: false };
+    return {
+      allPresent: false,
+      missing: REQUIRED_ENV_KEYS,
+      envExists: false,
+      configuredProviders: []
+    };
   }
   const env2 = await parseEnvFile(envPath);
+  const configuredProviders = getConfiguredImageProviders(env2);
   const missing = [];
   for (const required of REQUIRED_ENV_KEYS) {
-    const value = env2[required.key];
-    if (!value || value.trim() === "") {
+    const candidateKeys = required.alternativeKeys ?? [required.key];
+    const hasConfiguredValue = candidateKeys.some((candidateKey) => {
+      if (isImageProviderEnvKey(candidateKey)) {
+        return hasValidImageProviderValue(candidateKey, env2[candidateKey]);
+      }
+      const value = env2[candidateKey];
+      return !!value && value.trim() !== "";
+    });
+    if (!hasConfiguredValue) {
       missing.push(required);
     }
   }
   return {
     allPresent: missing.length === 0,
     missing,
-    envExists: true
+    envExists: true,
+    configuredProviders
   };
 }
+function getConfiguredImageProviders(env2) {
+  return IMAGE_PROVIDER_ENV_KEYS.filter((key) => hasValidImageProviderValue(key, env2[key])).map((key) => IMAGE_PROVIDER_KEY_MAP[key]);
+}
+function getDefaultImageProviderSelection(configuredProviders, existingPreference) {
+  if (existingPreference && validateApiKey2(existingPreference, VALIDATION_PATTERNS.IMAGE_GEN_PROVIDER)) {
+    if (existingPreference === "auto" && configuredProviders.includes("google")) {
+      return "auto";
+    }
+    if (configuredProviders.includes(existingPreference)) {
+      return existingPreference;
+    }
+  }
+  if (configuredProviders.includes("google")) {
+    return "auto";
+  }
+  return configuredProviders[0] ?? "auto";
+}
 var ESSENTIAL_CONFIGS = [
   {
     key: "GEMINI_API_KEY",
     label: "Google Gemini API Key",
-    hint: "Required for ai-multimodal skill. Get from: https://aistudio.google.com/apikey",
-    required: true,
+    hint: "Optional. Recommended for full ai-multimodal analysis and Google image generation.",
     validate: VALIDATION_PATTERNS.GEMINI_API_KEY,
     mask: true
   },
+  {
+    key: "OPENROUTER_API_KEY",
+    label: "OpenRouter API Key",
+    hint: "Optional. Alternative image-generation provider. Get from: https://openrouter.ai/settings/keys",
+    validate: VALIDATION_PATTERNS.OPENROUTER_API_KEY,
+    mask: true
+  },
+  {
+    key: "MINIMAX_API_KEY",
+    label: "MiniMax API Key",
+    hint: "Optional. Alternative image/video/speech/music provider.",
+    validate: VALIDATION_PATTERNS.MINIMAX_API_KEY,
+    mask: true
+  },
   {
     key: "DISCORD_WEBHOOK_URL",
     label: "Discord Webhook URL (optional)",
     hint: "For Discord notifications. Leave empty to skip.",
-    required: false,
     validate: VALIDATION_PATTERNS.DISCORD_WEBHOOK_URL,
     mask: false
   },
@@ -78693,7 +78789,6 @@ var ESSENTIAL_CONFIGS = [
     key: "TELEGRAM_BOT_TOKEN",
     label: "Telegram Bot Token (optional)",
     hint: "For Telegram notifications. Leave empty to skip.",
-    required: false,
     validate: VALIDATION_PATTERNS.TELEGRAM_BOT_TOKEN,
     mask: true
   }
@@ -78750,6 +78845,7 @@ async function runSetupWizard(options2) {
   if (hasGlobalConfig && Object.keys(globalEnv).length > 0) {
     f2.success("Global config detected - values will be inherited automatically");
   }
+  f2.info("Configure at least one image-generation provider. Leave unused provider fields blank.");
   const values = {};
   for (const config of ESSENTIAL_CONFIGS) {
     const globalValue = globalEnv[config.key] || "";
@@ -78774,12 +78870,9 @@ async function runSetupWizard(options2) {
       message: config.label,
       placeholder: config.hint,
       validate: (value) => {
-        if (!value && !config.required) {
+        if (!value) {
           return;
         }
-        if (!value && config.required) {
-          return "This field is required";
-        }
         if (value && config.validate && !validateApiKey2(value, config.validate)) {
           return "Invalid format. Please check and try again.";
         }
@@ -78794,6 +78887,11 @@ async function runSetupWizard(options2) {
       values[config.key] = result;
     }
   }
+  const configuredProviders = getConfiguredImageProviders(values);
+  if (configuredProviders.length === 0) {
+    f2.error("At least one image-generation provider key is required: GEMINI_API_KEY, OPENROUTER_API_KEY, or MINIMAX_API_KEY.");
+    return false;
+  }
   if (values.GEMINI_API_KEY) {
     const additionalKeys = await promptForAdditionalGeminiKeys(values.GEMINI_API_KEY);
     for (let i = 0;i < additionalKeys.length; i++) {
@@ -78804,6 +78902,38 @@ async function runSetupWizard(options2) {
       f2.success(`✓ Configured ${totalKeys} Gemini API keys for rotation`);
     }
   }
+  if (configuredProviders.length === 1) {
+    const [onlyProvider] = configuredProviders;
+    if (onlyProvider !== "google") {
+      values.IMAGE_GEN_PROVIDER = onlyProvider;
+      f2.info(`Set IMAGE_GEN_PROVIDER=${onlyProvider} to match your configured provider path`);
+    } else {
+      f2.info("Using auto mode for Gemini (default; no IMAGE_GEN_PROVIDER needed)");
+    }
+  } else {
+    const selectedProvider = await ie({
+      message: "Which image-generation provider should ClaudeKit prefer by default?",
+      options: [
+        {
+          value: "auto",
+          label: IMAGE_PROVIDER_META.auto.label,
+          hint: IMAGE_PROVIDER_META.auto.hint
+        },
+        ...configuredProviders.map((provider) => ({
+          value: provider,
+          label: IMAGE_PROVIDER_META[provider].label,
+          hint: IMAGE_PROVIDER_META[provider].hint
+        }))
+      ],
+      initialValue: getDefaultImageProviderSelection(configuredProviders, globalEnv.IMAGE_GEN_PROVIDER)
+    });
+    if (lD(selectedProvider)) {
+      f2.warning("Setup cancelled");
+      return false;
+    }
+    values.IMAGE_GEN_PROVIDER = selectedProvider;
+    f2.info(`Set IMAGE_GEN_PROVIDER=${selectedProvider}`);
+  }
   await generateEnvFile(targetDir, values);
   f2.success(`Configuration saved to ${join65(targetDir, ".env")}`);
   return true;
@@ -78862,7 +78992,7 @@ async function promptSetupWizardIfNeeded(options2) {
     return;
   }
   const missingKeys = missing.map((m2) => m2.label).join(", ");
-  const promptMessage = envExists ? `Missing required: ${missingKeys}. Set up now?` : "Set up API keys now? (Gemini API key for ai-multimodal skill, optional webhooks)";
+  const promptMessage = envExists ? `Missing required: ${missingKeys}. Set up now?` : "Set up API keys now? (Choose Gemini, OpenRouter, or MiniMax for ai-multimodal image generation, then optionally set a preferred provider; webhooks optional)";
   const shouldSetup = await prompts.confirm(promptMessage);
   if (shouldSetup) {
     await runSetupWizard({
@@ -78871,12 +79001,32 @@ async function promptSetupWizardIfNeeded(options2) {
     });
   } else {
     prompts.note(`Create ${envPath} manually or run 'ck init' again.
-Required: GEMINI_API_KEY
-Optional: DISCORD_WEBHOOK_URL, TELEGRAM_BOT_TOKEN`, "Configuration skipped");
+Required: one of GEMINI_API_KEY, OPENROUTER_API_KEY, MINIMAX_API_KEY
+Optional: IMAGE_GEN_PROVIDER, DISCORD_WEBHOOK_URL, TELEGRAM_BOT_TOKEN`, "Configuration skipped");
   }
 }
 
 // src/domains/health-checks/checkers/env-keys-checker.ts
+var GLOBAL_PROVIDER_SETUP_SUGGESTION = "Run: ck init --global (configure Gemini, OpenRouter, or MiniMax)";
+var PROVIDER_SETUP_SUGGESTION = "Run: ck init (configure Gemini, OpenRouter, or MiniMax)";
+function formatConfiguredProviderMessage(providers2) {
+  if (providers2.length === 0) {
+    return "No supported image-generation provider keys configured";
+  }
+  const labels = providers2.map((provider) => {
+    switch (provider) {
+      case "google":
+        return "Gemini";
+      case "openrouter":
+        return "OpenRouter";
+      case "minimax":
+        return "MiniMax";
+      default:
+        return provider;
+    }
+  });
+  return `Configured image providers: ${labels.join(", ")}`;
+}
 async function checkEnvKeys(setup) {
   const results = [];
   if (setup.global.path) {
@@ -78892,7 +79042,7 @@ async function checkEnvKeys(setup) {
         status: "warn",
         message: globalCheck.envExists ? `Missing: ${missingKeys}` : ".env file not found",
         details: globalEnvPath,
-        suggestion: "Run: ck init --global",
+        suggestion: GLOBAL_PROVIDER_SETUP_SUGGESTION,
         autoFixable: false
       });
     } else {
@@ -78902,7 +79052,7 @@ async function checkEnvKeys(setup) {
         group: "claudekit",
         priority: "standard",
         status: "pass",
-        message: `${REQUIRED_ENV_KEYS.length} required key(s) configured`,
+        message: formatConfiguredProviderMessage(globalCheck.configuredProviders),
         details: globalEnvPath,
         autoFixable: false
       });
@@ -78921,7 +79071,7 @@ async function checkEnvKeys(setup) {
         status: "warn",
         message: projectCheck.envExists ? `Missing: ${missingKeys}` : ".env file not found",
         details: projectEnvPath,
-        suggestion: "Run: ck init",
+        suggestion: PROVIDER_SETUP_SUGGESTION,
         autoFixable: false
       });
     } else {
@@ -78931,7 +79081,7 @@ async function checkEnvKeys(setup) {
         group: "claudekit",
         priority: "standard",
         status: "pass",
-        message: `${REQUIRED_ENV_KEYS.length} required key(s) configured`,
+        message: formatConfiguredProviderMessage(projectCheck.configuredProviders),
         details: projectEnvPath,
         autoFixable: false
       });
@@ -83920,8 +84070,11 @@ import { platform as platform9 } from "node:os";
 // src/types/skills-dependencies.ts
 var SKILLS_DEPENDENCIES = {
   python: [
-    { name: "google-genai", description: "Required for ai-multimodal skill (Gemini API)" },
-    { name: "pillow, pypdf", description: "Image/PDF processing" },
+    { name: "google-genai", description: "Required for ai-multimodal Gemini provider support" },
+    {
+      name: "pillow, pypdf, requests",
+      description: "Image/PDF processing and provider HTTP clients"
+    },
     { name: "python-dotenv", description: "Environment variable management" }
   ],
   system: [

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "claudekit-cli",
-	"version": "3.41.3-dev.3",
+	"version": "3.41.4-dev.1",
 	"description": "CLI tool for bootstrapping and updating ClaudeKit projects",
 	"type": "module",
 	"repository": {