@link-assistant/hive-mind 1.23.11 → 1.23.13

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @link-assistant/hive-mind
 
+## 1.23.13
+
+### Patch Changes
+
+- af1f456: fix: suppress dotenvx MISSING_ENV_FILE warnings in hive-telegram-bot --version
+  - Add early --version handling before loading dotenvx to avoid warnings
+  - Add ignore: ['MISSING_ENV_FILE'] option to make .env file optional
+  - Add tests for version output in tests/test-telegram-bot-version.mjs
+
+## 1.23.12
+
+### Patch Changes
+
+- 50a69ae: Update free models: replace minimax-m2.1-free with minimax-m2.5-free
+
+  OpenCode Zen:
+  - Replace `minimax-m2.1-free` with `minimax-m2.5-free` (M2.1 no longer free)
+  - Remove `glm-4.7-free` from recommended free models (no longer free)
+
+  Kilo Gateway:
+  - Add `glm-4.5-air-free` (agent-centric model)
+  - Add `minimax-m2.5-free` (upgraded from M2.1)
+  - Add `deepseek-r1-free` (advanced reasoning model)
+
+  Breaking change: Users relying on `minimax-m2.1-free` or `glm-4.7-free` should switch to the updated models. Deprecated models are kept for backward compatibility but may not work.
+
 ## 1.23.11
 
 ### Patch Changes

package/README.md

@@ -149,11 +149,14 @@ Run the Hive Mind using Docker for safer local installation - no manual setup re
 # Pull the latest image from Docker Hub
 docker pull konard/hive-mind:latest
 
-# Run an interactive session
-docker run -it konard/hive-mind:latest
+# Start hive-mind container
+docker run -dit --name hive-mind konard/hive-mind:latest
 
-# IMPORTANT: Authenticate AFTER the Docker image is installed
-# This avoids build timeouts and allows the installation to complete successfully
+# Verify container started
+docker ps -a
+
+# Enter additional terminal process to do installation
+docker exec -it hive-mind /bin/bash
 
 # Inside the container, authenticate with GitHub
 gh-setup-git-identity
@@ -163,6 +166,15 @@ claude
 
 # Now you can use hive and solve commands
 solve https://github.com/owner/repo/issues/123
+
+# Or you can run telegram bot:
+
+# Run an to main process
+docker attach hive-mind
+
+# Run bot here
+
+# Press Ctrl + P, Ctrl + Q to detach without destroying the container (no stopping of main bash process)
 ```
 
 **Benefits of Docker:**
@@ -477,15 +489,14 @@ Examples:
 
 Free Models (with --tool agent):
 /solve https://github.com/owner/repo/issues/123 --tool agent --model kimi-k2.5-free
-/solve https://github.com/owner/repo/issues/123 --tool agent --model minimax-m2.1-free
+/solve https://github.com/owner/repo/issues/123 --tool agent --model minimax-m2.5-free
 /solve https://github.com/owner/repo/issues/123 --tool agent --model gpt-5-nano
-/solve https://github.com/owner/repo/issues/123 --tool agent --model glm-4.7-free
 /solve https://github.com/owner/repo/issues/123 --tool agent --model big-pickle
 
 Free Models via Kilo Gateway (with --tool agent):
 /solve https://github.com/owner/repo/issues/123 --tool agent --model kilo/glm-5-free
-/solve https://github.com/owner/repo/issues/123 --tool agent --model kilo/glm-4.7-free
-/solve https://github.com/owner/repo/issues/123 --tool agent --model kilo/kimi-k2.5-free
+/solve https://github.com/owner/repo/issues/123 --tool agent --model kilo/glm-4.5-air-free
+/solve https://github.com/owner/repo/issues/123 --tool agent --model kilo/deepseek-r1-free
 ```
 
 > **📖 Free Models Guide**: See [docs/FREE_MODELS.md](./docs/FREE_MODELS.md) for comprehensive information about all free models including OpenCode Zen and Kilo Gateway providers.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/hive-mind",
-  "version": "1.23.11",
+  "version": "1.23.13",
   "description": "AI-powered issue solver and hive mind for collaborative problem solving",
   "main": "src/hive.mjs",
   "type": "module",

package/src/agent.lib.mjs

@@ -94,6 +94,7 @@ const getOriginalProviderName = providerId => {
     moonshot: 'Moonshot AI',
     google: 'Google',
     opencode: 'OpenCode Zen',
+    kilo: 'Kilo Gateway',
     grok: 'xAI',
   };
 
@@ -210,9 +211,10 @@ export const calculateAgentPricing = async (modelId, tokenUsage) => {
 
       const totalCost = inputCost + outputCost + cacheReadCost + cacheWriteCost + reasoningCost;
 
-      // Determine if this is a free model from OpenCode Zen
-      // Models accessed via OpenCode Zen are free, regardless of original provider pricing
-      const isOpencodeFreeModel = providerFromModel === 'opencode' || isFreeVariant || modelName.toLowerCase().includes('free') || modelName.toLowerCase().includes('grok') || providerFromModel === 'moonshot' || providerFromModel === 'openai' || providerFromModel === 'anthropic';
+      // Determine if this is a free model from OpenCode Zen or Kilo Gateway
+      // Models accessed via OpenCode Zen or Kilo Gateway are free, regardless of original provider pricing
+      // Issue #1300: Added kilo provider detection for Kilo Gateway free models
+      const isOpencodeFreeModel = providerFromModel === 'opencode' || providerFromModel === 'kilo' || isFreeVariant || modelName.toLowerCase().includes('free') || modelName.toLowerCase().includes('grok') || providerFromModel === 'moonshot' || providerFromModel === 'openai' || providerFromModel === 'anthropic';
 
       // Use base model's provider for original provider reference if available
       const effectiveOriginalProvider = baseModelInfo?.provider || originalProvider || effectiveModelInfo?.provider || null;
@@ -282,23 +284,36 @@ export const calculateAgentPricing = async (modelId, tokenUsage) => {
 // Model mapping to translate aliases to full model IDs for Agent
 // Agent uses OpenCode Zen's JSON interface and models
 // Issue #1185: Free models use opencode/ prefix (not openai/)
+// Issue #1300: Updated mappings - use opencode/ and kilo/ prefixes only,
+// short names for Kilo-exclusive models map to kilo/ prefix
 export const mapModelToId = model => {
   const modelMap = {
+    // OpenCode Zen free models
     grok: 'opencode/grok-code',
     'grok-code': 'opencode/grok-code',
     'grok-code-fast-1': 'opencode/grok-code',
     'big-pickle': 'opencode/big-pickle',
     'gpt-5-nano': 'opencode/gpt-5-nano',
+    'minimax-m2.5-free': 'opencode/minimax-m2.5-free',
+    'kimi-k2.5-free': 'opencode/kimi-k2.5-free',
+    // Kilo Gateway free models - short names for Kilo-exclusive models (Issue #1300)
+    'glm-5-free': 'kilo/glm-5-free',
+    'glm-4.5-air-free': 'kilo/glm-4.5-air-free',
+    'deepseek-r1-free': 'kilo/deepseek-r1-free',
+    'giga-potato-free': 'kilo/giga-potato-free',
+    'trinity-large-preview': 'kilo/trinity-large-preview',
+    // Premium models
     sonnet: 'anthropic/claude-3-5-sonnet',
     haiku: 'anthropic/claude-3-5-haiku',
     opus: 'anthropic/claude-3-opus',
     'gemini-3-pro': 'google/gemini-3-pro',
-    // Free models mapping for issue #1250
-    'kimi-k2.5-free': 'moonshot/kimi-k2.5-free',
     'gpt-4o-mini': 'openai/gpt-4o-mini',
     'gpt-4o': 'openai/gpt-4o',
     'claude-3.5-haiku': 'anthropic/claude-3.5-haiku',
     'claude-3.5-sonnet': 'anthropic/claude-3.5-sonnet',
+    // Deprecated free models (backward compatibility)
+    'glm-4.7-free': 'opencode/glm-4.7-free',
+    'minimax-m2.1-free': 'opencode/minimax-m2.1-free',
   };
 
   // Return mapped model ID if it's an alias, otherwise return as-is

package/src/model-mapping.lib.mjs

@@ -26,23 +26,36 @@ export const claudeModels = {
 };
 
 // Agent models (OpenCode API and Kilo Gateway via agent CLI)
+// Issue #1300: Updated free models to match agent PR #191
 export const agentModels = {
-  // OpenCode Zen free models
+  // OpenCode Zen free models (current)
   grok: 'opencode/grok-code',
   'grok-code': 'opencode/grok-code',
   'grok-code-fast-1': 'opencode/grok-code',
   'big-pickle': 'opencode/big-pickle',
   'gpt-5-nano': 'opencode/gpt-5-nano',
-  'glm-4.7-free': 'opencode/glm-4.7-free',
-  'minimax-m2.1-free': 'opencode/minimax-m2.1-free',
+  'minimax-m2.5-free': 'opencode/minimax-m2.5-free', // New: upgraded from M2.1
   'kimi-k2.5-free': 'opencode/kimi-k2.5-free',
-  // Kilo Gateway free models (Issue #1282)
+  // Kilo Gateway free models (Issue #1282, updated in #1300)
+  // Short names for Kilo-exclusive models (Issue #1300)
+  'glm-5-free': 'kilo/glm-5-free', // Kilo-exclusive
+  'glm-4.5-air-free': 'kilo/glm-4.5-air-free', // Kilo-exclusive: agent-centric model
+  'deepseek-r1-free': 'kilo/deepseek-r1-free', // Kilo-exclusive: reasoning model
+  'giga-potato-free': 'kilo/giga-potato-free', // Kilo-exclusive
+  'trinity-large-preview': 'kilo/trinity-large-preview', // Kilo-exclusive
+  // Full names with kilo/ prefix
   'kilo/glm-5-free': 'kilo/glm-5-free',
-  'kilo/glm-4.7-free': 'kilo/glm-4.7-free',
-  'kilo/kimi-k2.5-free': 'kilo/kimi-k2.5-free',
-  'kilo/minimax-m2.1-free': 'kilo/minimax-m2.1-free',
+  'kilo/glm-4.5-air-free': 'kilo/glm-4.5-air-free',
+  'kilo/minimax-m2.5-free': 'kilo/minimax-m2.5-free', // Also on OpenCode Zen
+  'kilo/deepseek-r1-free': 'kilo/deepseek-r1-free',
   'kilo/giga-potato-free': 'kilo/giga-potato-free',
   'kilo/trinity-large-preview': 'kilo/trinity-large-preview',
+  // Deprecated free models (kept for backward compatibility)
+  'glm-4.7-free': 'opencode/glm-4.7-free', // Deprecated: no longer free
+  'minimax-m2.1-free': 'opencode/minimax-m2.1-free', // Deprecated: replaced by m2.5
+  'kilo/glm-4.7-free': 'kilo/glm-4.7-free', // Deprecated: replaced by glm-4.5-air-free
+  'kilo/kimi-k2.5-free': 'kilo/kimi-k2.5-free', // Deprecated: not recommended
+  'kilo/minimax-m2.1-free': 'kilo/minimax-m2.1-free', // Deprecated: replaced by m2.5
   // Premium models
   sonnet: 'anthropic/claude-3-5-sonnet',
   haiku: 'anthropic/claude-3-5-haiku',

package/src/model-validation.lib.mjs

@@ -94,23 +94,38 @@ export const CODEX_MODELS = {
 export const AGENT_MODELS = {
   // Free models (via OpenCode Zen)
   // Issue #1185: Model IDs must use opencode/ prefix for OpenCode Zen models
+  // Issue #1300: Updated free models - minimax-m2.5-free replaces m2.1, glm-4.7-free removed
   grok: 'opencode/grok-code',
   'grok-code': 'opencode/grok-code',
   'grok-code-fast-1': 'opencode/grok-code',
   'big-pickle': 'opencode/big-pickle',
   'gpt-5-nano': 'opencode/gpt-5-nano',
-  'glm-4.7-free': 'opencode/glm-4.7-free',
-  'minimax-m2.1-free': 'opencode/minimax-m2.1-free',
+  'minimax-m2.5-free': 'opencode/minimax-m2.5-free', // Upgraded from M2.1 (Issue #1300)
   'kimi-k2.5-free': 'opencode/kimi-k2.5-free',
   // Free models (via Kilo Gateway)
   // Issue #1282: Kilo provider adds access to 500+ models including free tier
+  // Issue #1300: Updated Kilo free models with new offerings
   // See: https://kilo.ai/docs/advanced-usage/free-and-budget-models
-  'kilo/glm-5-free': 'kilo/glm-5-free', // Z.AI flagship model (free limited time)
-  'kilo/glm-4.7-free': 'kilo/glm-4.7-free', // Z.AI agent-centric model
-  'kilo/kimi-k2.5-free': 'kilo/kimi-k2.5-free', // MoonshotAI agentic model
-  'kilo/minimax-m2.1-free': 'kilo/minimax-m2.1-free', // MiniMax general-purpose
-  'kilo/giga-potato-free': 'kilo/giga-potato-free', // Evaluation model
-  'kilo/trinity-large-preview': 'kilo/trinity-large-preview', // Arcee AI preview
+  // Short names for Kilo-exclusive models (Issue #1300)
+  'glm-5-free': 'kilo/glm-5-free', // Kilo-exclusive: Z.AI flagship model
+  'glm-4.5-air-free': 'kilo/glm-4.5-air-free', // Kilo-exclusive: Z.AI agent-centric model
+  'deepseek-r1-free': 'kilo/deepseek-r1-free', // Kilo-exclusive: DeepSeek reasoning model
+  'giga-potato-free': 'kilo/giga-potato-free', // Kilo-exclusive: Evaluation model
+  'trinity-large-preview': 'kilo/trinity-large-preview', // Kilo-exclusive: Arcee AI preview
+  // Full names with kilo/ prefix
+  'kilo/glm-5-free': 'kilo/glm-5-free',
+  'kilo/glm-4.5-air-free': 'kilo/glm-4.5-air-free',
+  'kilo/minimax-m2.5-free': 'kilo/minimax-m2.5-free', // Also on OpenCode Zen
+  'kilo/deepseek-r1-free': 'kilo/deepseek-r1-free',
+  'kilo/giga-potato-free': 'kilo/giga-potato-free',
+  'kilo/trinity-large-preview': 'kilo/trinity-large-preview',
+  // Deprecated free models (kept for backward compatibility)
+  // These models are no longer the recommended options but may still work
+  'glm-4.7-free': 'opencode/glm-4.7-free', // Deprecated: no longer free on OpenCode Zen
+  'minimax-m2.1-free': 'opencode/minimax-m2.1-free', // Deprecated: replaced by m2.5
+  'kilo/glm-4.7-free': 'kilo/glm-4.7-free', // Deprecated: replaced by glm-4.5-air-free
+  'kilo/kimi-k2.5-free': 'kilo/kimi-k2.5-free', // Deprecated: not recommended
+  'kilo/minimax-m2.1-free': 'kilo/minimax-m2.1-free', // Deprecated: replaced by m2.5
   // Premium models (requires OpenCode Zen subscription)
   sonnet: 'anthropic/claude-3-5-sonnet',
   haiku: 'anthropic/claude-3-5-haiku',
@@ -120,9 +135,11 @@ export const AGENT_MODELS = {
   'opencode/grok-code': 'opencode/grok-code',
   'opencode/big-pickle': 'opencode/big-pickle',
   'opencode/gpt-5-nano': 'opencode/gpt-5-nano',
-  'opencode/glm-4.7-free': 'opencode/glm-4.7-free',
-  'opencode/minimax-m2.1-free': 'opencode/minimax-m2.1-free',
+  'opencode/minimax-m2.5-free': 'opencode/minimax-m2.5-free', // New (Issue #1300)
   'opencode/kimi-k2.5-free': 'opencode/kimi-k2.5-free',
+  // Deprecated OpenCode Zen models (kept for backward compatibility)
+  'opencode/glm-4.7-free': 'opencode/glm-4.7-free', // Deprecated
+  'opencode/minimax-m2.1-free': 'opencode/minimax-m2.1-free', // Deprecated
   // Premium models with provider prefix
   'anthropic/claude-3-5-sonnet': 'anthropic/claude-3-5-sonnet',
   'anthropic/claude-3-5-haiku': 'anthropic/claude-3-5-haiku',

package/src/solve.config.lib.mjs

@@ -400,7 +400,7 @@ export const createYargsConfig = yargsInstance => {
   config = config
     .option('model', {
       type: 'string',
-      description: 'Model to use (for claude: opus, sonnet, haiku, haiku-3-5, haiku-3; for opencode: grok, gpt4o; for codex: gpt5, gpt5-codex, o3; for agent: grok, grok-code, big-pickle, gpt-5-nano, glm-4.7-free, minimax-m2.1-free, kimi-k2.5-free)',
+      description: 'Model to use (for claude: opus, sonnet, haiku, haiku-3-5, haiku-3; for opencode: grok, gpt4o; for codex: gpt5, gpt5-codex, o3; for agent: kimi-k2.5-free, big-pickle, gpt-5-nano, minimax-m2.5-free, glm-5-free, deepseek-r1-free)',
       alias: 'm',
       default: currentParsedArgs => {
         // Dynamic default based on tool selection

package/src/telegram-bot.mjs

@@ -1,4 +1,10 @@
 #!/usr/bin/env node
+// Early exit for --version (issue #1318: avoid dotenvx MISSING_ENV_FILE warnings)
+if (process.argv.includes('--version')) {
+  const v = await import('./version.lib.mjs').then(m => m.getVersion()).catch(() => 'unknown');
+  console.log(v);
+  process.exit(v === 'unknown' ? 1 : 0);
+}
 
 import { spawn } from 'child_process';
 import { promisify } from 'util';
@@ -21,7 +27,9 @@ const dotenvx = dotenvxModule.default || dotenvxModule;
 const getenv = await use('getenv');
 
 // Load .env configuration as base
-dotenvx.config({ quiet: true });
+// quiet: true suppresses info messages, ignore: ['MISSING_ENV_FILE'] suppresses error when .env doesn't exist
+// This makes .env file optional (issue #1318)
+dotenvx.config({ quiet: true, ignore: ['MISSING_ENV_FILE'] });
 
 // Load .lenv configuration (if exists)
 // .lenv overrides .env
@@ -30,20 +38,15 @@ loadLenvConfig({ override: true, quiet: true });
 const yargsModule = await use('yargs@17.7.2');
 const yargs = yargsModule.default || yargsModule;
 const { hideBin } = await use('yargs@17.7.2/helpers');
-
-// Import solve and hive yargs configurations for validation
+// Import yargs configurations, GitHub utilities, and telegram helpers
 const { createYargsConfig: createSolveYargsConfig, detectMalformedFlags } = await import('./solve.config.lib.mjs');
 const { createYargsConfig: createHiveYargsConfig } = await import('./hive.config.lib.mjs');
-// Import GitHub URL parser for extracting URLs from messages
 const { parseGitHubUrl } = await import('./github.lib.mjs');
-// Import model validation for early validation with helpful error messages
 const { validateModelName } = await import('./model-validation.lib.mjs');
-// Import libraries for /limits, /version, and markdown escaping
 const { formatUsageMessage, getAllCachedLimits } = await import('./limits.lib.mjs');
 const { getVersionInfo, formatVersionMessage } = await import('./version-info.lib.mjs');
 const { escapeMarkdown, escapeMarkdownV2, cleanNonPrintableChars, makeSpecialCharsVisible } = await import('./telegram-markdown.lib.mjs');
 const { getSolveQueue, createQueueExecuteCallback } = await import('./telegram-solve-queue.lib.mjs');
-// Import extracted message filter functions for testability (issue #1207)
 const { isOldMessage: _isOldMessage, isGroupChat: _isGroupChat, isChatAuthorized: _isChatAuthorized, isForwardedOrReply: _isForwardedOrReply, extractCommandFromText } = await import('./telegram-message-filters.lib.mjs');
 // Import bot launcher with exponential backoff retry (issue #1240)
 const { launchBotWithRetry } = await import('./telegram-bot-launcher.lib.mjs');

package/src/version.lib.mjs

@@ -5,6 +5,11 @@ import { dirname, join } from 'path';
 import { fileURLToPath } from 'url';
 import { getGitVersion } from './git.lib.mjs';
 
+// Cache for version (immutable after first read)
+// This ensures the version remains consistent even if package.json changes during runtime
+// See issue #1318: version should be cached in RAM at startup
+let cachedVersion = null;
+
 async function isRunningAsScript() {
   const __filename = fileURLToPath(import.meta.url);
   const __dirname = dirname(__filename);
@@ -18,6 +23,11 @@ async function isRunningAsScript() {
 }
 
 export async function getVersion() {
+  // Return cached version if already computed (immutable after first read)
+  if (cachedVersion !== null) {
+    return cachedVersion;
+  }
+
   const __filename = fileURLToPath(import.meta.url);
   const __dirname = dirname(__filename);
   const packagePath = join(__dirname, '..', 'package.json');
@@ -28,13 +38,15 @@ export async function getVersion() {
     const currentVersion = packageJson.version;
 
     if (await isRunningAsScript()) {
-      const version = await getGitVersion(undefined, currentVersion);
-      return version;
+      cachedVersion = await getGitVersion(undefined, currentVersion);
+    } else {
+      cachedVersion = currentVersion;
     }
 
-    return currentVersion;
+    return cachedVersion;
   } catch {
-    return 'unknown';
+    cachedVersion = 'unknown';
+    return cachedVersion;
   }
 }