@link-assistant/hive-mind 2.17.0 → 2.19.0

package/src/hive-models.lib.mjs

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+
+/**
+ * Shared runner for the `hive-models` bin command (issue #2202, R5).
+ *
+ * R5 asks for a listing that merges what this installation ships with what the
+ * providers are serving right now, "from fully supported, to hot loaded", per
+ * tool. This module is the CLI half of that; `telegram-models-command.lib.mjs`
+ * is the `/models` half, and both render through
+ * `model-catalogue-render.lib.mjs` so the two can never disagree.
+ *
+ * R6 is honoured here too: before printing a catalogue the runner gives the
+ * agentic CLIs a chance to update, because a stale `codex` binary is exactly
+ * what makes a new model look unavailable.
+ *
+ * @see https://github.com/link-assistant/hive-mind/issues/2202
+ */
+
+import { ensureAgenticCliFreshness, describeFreshnessResult } from './agentic-cli-freshness.lib.mjs';
+import { parseCliArgumentsWithLino } from './cli-arguments.lib.mjs';
+import { MODEL_CATALOGUE_TOOLS, getMergedModelCatalogue } from './model-catalogue.lib.mjs';
+import { formatModelCatalogueText } from './model-catalogue-render.lib.mjs';
+
+export const HIVE_MODELS_HELP = `Usage: hive-models [--tool <name>...] [--refresh] [--details] [--json] [--no-update] [--verbose]
+
+List the models Hive Mind can drive, merged from every source that can be read
+without spending a token — the router's live catalogue, the provider listing
+endpoints, the codex CLI's own catalogue, models.dev metadata, and the models
+bundled with this installation.
+
+Models are grouped so it is obvious what each one is:
+  Bundled and live   shipped here and confirmed reachable now
+  Hot loaded         a live source has it, this installation does not ship it
+  Bundled only       shipped here, no live source confirmed it
+
+Options:
+  -t, --tool <name>    Restrict to one tool (${MODEL_CATALOGUE_TOOLS.join(', ')}).
+                       Repeatable; defaults to every tool.
+      --refresh        Ignore the cached answer and re-read every live source
+      --details        Show context window, pricing, and which source had it
+      --json           Print machine-readable JSON instead of text
+      --no-update      Do not check the agentic CLIs for a newer version first
+                       (also spelled --no-tool-update, as in /solve and /task)
+  -v, --verbose        Print diagnostics to stderr
+  -h, --help           Show this help and exit
+
+Environment:
+  HIVE_MIND_MODELS_HOT_LOAD=0            Only list the bundled catalogue
+  HIVE_MIND_MODELS_ROUTER=0              Skip the router source specifically
+  HIVE_MIND_MODEL_CATALOGUE_TTL_MINUTES  Raise the 60 minute cache lifetime
+  HIVE_MIND_AGENTIC_CLI_AUTO_UPDATE=0    Never update the CLIs
+
+Examples:
+  hive-models                      # every tool, cached answers
+  hive-models --tool codex         # just codex
+  hive-models --tool claude --details --refresh
+  hive-models --json | jq '.tools.claude.liveOnly'
+
+Reference:
+  https://github.com/link-assistant/hive-mind/issues/2202
+`;
+
+const VALUE_FLAGS = new Set(['--tool', '-t']);
+const BOOLEAN_FLAGS = new Set(['--refresh', '--details', '--json', '--no-update', '--no-tool-update', '--verbose', '-v', '--help', '-h']);
+
+// `/solve`, `/hive` and `/task` spell the opt-out `--no-tool-update` (it lives in
+// their `tool-*` namespace). Accept that spelling here too, so the flag an
+// operator already knows works everywhere it makes sense (issue #2202, R6).
+const normaliseUpdateFlag = arg => (arg === '--no-tool-update' ? '--no-update' : arg);
+
+const createHiveModelsYargsConfig = yargsInstance => yargsInstance.usage('Usage: hive-models [--tool <name>...] [--refresh] [--details] [--json] [--no-update] [--verbose]').option('tool', { type: 'array', alias: 't', default: [] }).option('refresh', { type: 'boolean', default: false }).option('details', { type: 'boolean', default: false }).option('json', { type: 'boolean', default: false }).option('update', { type: 'boolean', default: true }).option('verbose', { type: 'boolean', alias: 'v', default: false }).option('help', { type: 'boolean', alias: 'h', default: false }).help(false).version(false).strict(false);
+
+/**
+ * Parse argv for `hive-models`. Returns `error` as a string rather than
+ * throwing, so the bin can print it and exit non-zero.
+ */
+export const parseHiveModelsArgs = argv => {
+  const result = { tools: [], refresh: false, details: false, json: false, update: true, verbose: false, help: false, error: null };
+  const help = argv.includes('--help') || argv.includes('-h');
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    const [name] = arg.split('=');
+    if (VALUE_FLAGS.has(name)) {
+      if (!arg.includes('=')) index += 1;
+      continue;
+    }
+    if (!BOOLEAN_FLAGS.has(arg)) {
+      result.error = `Unknown option: ${arg}`;
+      return result;
+    }
+  }
+
+  let parsed;
+  try {
+    parsed = parseCliArgumentsWithLino({
+      argv: argv.filter(arg => arg !== '--help' && arg !== '-h').map(normaliseUpdateFlag),
+      commandName: 'hive-models',
+      createYargsConfig: createHiveModelsYargsConfig,
+      lenv: { enabled: false },
+      getenv: { enabled: false },
+    });
+  } catch (err) {
+    result.error = err.message || String(err);
+    return result;
+  }
+
+  result.help = help;
+  result.refresh = parsed.refresh === true;
+  result.details = parsed.details === true;
+  result.json = parsed.json === true;
+  result.update = parsed.update !== false;
+  result.verbose = parsed.verbose === true || parsed.v === true;
+
+  const requested = []
+    .concat(parsed.tool ?? [])
+    .flatMap(entry =>
+      String(entry)
+        .split(',')
+        .map(part => part.trim().toLowerCase())
+    )
+    .filter(Boolean);
+  for (const tool of requested) {
+    if (!MODEL_CATALOGUE_TOOLS.includes(tool)) {
+      result.error = `Unknown tool: ${tool}. Known tools: ${MODEL_CATALOGUE_TOOLS.join(', ')}`;
+      return result;
+    }
+    if (!result.tools.includes(tool)) result.tools.push(tool);
+  }
+  if (result.tools.length === 0) result.tools = [...MODEL_CATALOGUE_TOOLS];
+  return result;
+};
+
+/**
+ * Top-level orchestrator used by the bin. `deps` is injected so tests can run
+ * the whole command without a network, a router, or a package registry.
+ */
+export const runHiveModels = async (argv, deps = {}) => {
+  const { env = process.env, log = (...args) => console.log(...args), error = (...args) => console.error(...args), loadCatalogue = getMergedModelCatalogue, freshness = ensureAgenticCliFreshness } = deps;
+
+  const args = parseHiveModelsArgs(argv);
+  if (args.help) {
+    log(HIVE_MODELS_HELP);
+    return 0;
+  }
+  if (args.error) {
+    error(args.error);
+    return 1;
+  }
+
+  const debug = args.verbose ? (...parts) => error('[hive-models]', ...parts) : () => {};
+
+  // R6: refresh the CLIs before answering, so the list describes the binaries
+  // the next run will actually use. Best-effort — never fatal.
+  const refreshed = await freshness({ tools: args.tools, env, verbose: args.verbose, enabled: args.update, log: async message => debug(message) });
+  debug(`cli freshness: ${refreshed.status}${refreshed.reason ? ` (${refreshed.reason})` : ''}`);
+  const freshnessLine = describeFreshnessResult(refreshed);
+
+  const results = {};
+  let failures = 0;
+  for (const tool of args.tools) {
+    try {
+      results[tool] = await loadCatalogue({ tool, env, refresh: args.refresh, log: async message => debug(message) });
+    } catch (err) {
+      failures += 1;
+      error(`Could not build the ${tool} catalogue: ${err?.message ?? err}`);
+    }
+  }
+
+  if (args.json) {
+    log(JSON.stringify({ generatedAt: new Date().toISOString(), cliUpdate: refreshed, tools: results }, null, 2));
+    return failures > 0 && Object.keys(results).length === 0 ? 1 : 0;
+  }
+
+  if (freshnessLine) log(freshnessLine);
+  const sections = Object.values(results).map(merged => formatModelCatalogueText(merged, { details: args.details, defaultModel: merged.default }));
+  log(sections.join('\n\n'));
+  return failures > 0 && sections.length === 0 ? 1 : 0;
+};
+
+export default { HIVE_MODELS_HELP, parseHiveModelsArgs, runHiveModels };

package/src/hive-models.mjs

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+
+/**
+ * `hive-models` — list every model Hive Mind can drive, merging the models
+ * bundled with this installation with the ones the providers are serving right
+ * now (issue #2202, R5).
+ *
+ * Live sources are read only through endpoints that cannot bill a token, and
+ * the merged answer is cached for an hour, so running this repeatedly is free.
+ *
+ * See issue #2202.
+ */
+
+import { runHiveModels } from './hive-models.lib.mjs';
+import { setupStdioLogInterceptor } from './lib.mjs';
+
+setupStdioLogInterceptor();
+
+const exitCode = await runHiveModels(process.argv.slice(2));
+process.exit(exitCode);

package/src/hive.mjs

@@ -86,6 +86,8 @@ if (isRunningDirectly) {
     const { validateYouTrackConfig, testYouTrackConnection, createYouTrackConfigFromEnv } = youTrackLib;
     const youTrackSync = await import('./youtrack/youtrack-sync.mjs');
     const { syncYouTrackToGitHub, formatIssuesForHive } = youTrackSync;
+    // Issue #2194: recovery diagnostics for URLs that had to be repaired before parsing.
+    const { formatUrlRepairs, hasNotableRepair, revealHiddenCharacters } = await import('./github-url-recovery.lib.mjs');
     const memCheck = await import('./memory-check.mjs');
     const { checkSystem } = memCheck;
     const exitHandler = await import('./exit-handler.lib.mjs');
@@ -185,6 +187,14 @@ if (isRunningDirectly) {
         console.error('  - owner/repo (will be converted to https://github.com/owner/repo)');
         await safeExit(1, 'Error occurred');
       }
+      // Issue #2194: report a repaired URL before monitoring starts, so the user
+      // can catch a wrong guess instead of watching the wrong repository.
+      if (hasNotableRepair(parsedUrl.repairs)) {
+        console.error('ℹ️  Repaired the GitHub URL before monitoring:');
+        console.error(`     You typed: ${revealHiddenCharacters(githubUrl)}`);
+        console.error(`     Using:     ${parsedUrl.canonical || parsedUrl.normalized}`);
+        console.error(`     Repaired:  ${formatUrlRepairs(parsedUrl.repairs, { notableOnly: true })}`);
+      }
       // Check if it's a valid type for hive (user or repo)
       if (parsedUrl.type !== 'user' && parsedUrl.type !== 'repo') {
         console.error('Error: Invalid GitHub URL for monitoring');

package/src/locales/en.lino

@@ -508,6 +508,13 @@ en
       must
         be
           type "URL must be a GitHub {{allowedTypes}} (not {{type}})"
+      recovered """
+        ℹ️ I repaired the link before starting.
+
+        You sent: {{original}}
+        Using: {{used}}
+        Repaired: {{repairs}}
+      """
     language
       invalid """
         ❌ Invalid language. Supported: {{supported}}.
@@ -583,6 +590,7 @@ en
         usage "Usage: `/hive <github-url> [options]`"
         example "Example: `/hive https://github.com/owner/repo`"
         disabled "*/hive* - ❌ Disabled"
+      models "*/models* - List available models, merged from this installation and every live source. Usage: `/models [--tool claude|codex|...] [--details] [--refresh] [--all]`"
       limits "*/limits* - Show usage limits"
       version "*/version* - Show bot and runtime versions"
       language "*/language* `[en|ru|zh|hi]` - Set or show your preferred reply language (in-memory only, per-user)"
@@ -604,7 +612,7 @@ en
       isolation
         mode "🔒 *Isolation Mode:* `{{isolationBackend}}` (experimental)"
       group
-        note "⚠️ *Note:* /solve, /do, /continue, /claude, /codex, /opencode, /agent, /gemini, /qwen, /task, /split, /fix, /hive, /queue, /limits, /version, /accept\\_invites, /merge, /stop and /start commands only work in group chats. /terminal\\_watch, /watch, /subscribe and /unsubscribe work in private and group chats."
+        note "⚠️ *Note:* /solve, /do, /continue, /claude, /codex, /opencode, /agent, /gemini, /qwen, /task, /split, /fix, /hive, /queue, /models, /limits, /version, /accept\\_invites, /merge, /stop and /start commands only work in group chats. /terminal\\_watch, /watch, /subscribe and /unsubscribe work in private and group chats."
       common
         options "🔧 *Common Options:*"
       model

package/src/locales/hi.lino

@@ -508,6 +508,13 @@ hi
       must
         be
           type "URL GitHub {{allowedTypes}} होना चाहिए ({{type}} नहीं)"
+      recovered """
+        ℹ️ शुरू करने से पहले लिंक ठीक की गई।
+
+        आपने भेजा: {{original}}
+        उपयोग किया जा रहा है: {{used}}
+        ठीक किया गया: {{repairs}}
+      """
     language
       invalid """
         ❌ अमान्य भाषा। समर्थित: {{supported}}।
@@ -583,6 +590,7 @@ hi
         usage "उपयोग: `/hive <github-url> [options]`"
         example "उदाहरण: `/hive https://github.com/owner/repo`"
         disabled "*/hive* - ❌ अक्षम"
+      models "*/models* - उपलब्ध models दिखाएँ, जो इस installation और सभी live sources से मिलाकर बनाई गई हैं। उपयोग: `/models [--tool claude|codex|...] [--details] [--refresh] [--all]`"
       limits "*/limits* - उपयोग सीमाएँ दिखाएँ"
       version "*/version* - bot और runtime versions दिखाएँ"
       language "*/language* `[en|ru|zh|hi]` - अपनी पसंदीदा reply language सेट या दिखाएँ (in-memory, per-user)"
@@ -604,7 +612,7 @@ hi
       isolation
         mode "🔒 *Isolation Mode:* `{{isolationBackend}}` (experimental)"
       group
-        note "⚠️ *नोट:* /solve, /do, /continue, /claude, /codex, /opencode, /agent, /gemini, /qwen, /task, /split, /fix, /hive, /queue, /limits, /version, /accept\\_invites, /merge, /stop और /start commands केवल group chats में काम करती हैं। /terminal\\_watch, /watch, /subscribe और /unsubscribe private और group chats में काम करती हैं।"
+        note "⚠️ *नोट:* /solve, /do, /continue, /claude, /codex, /opencode, /agent, /gemini, /qwen, /task, /split, /fix, /hive, /queue, /models, /limits, /version, /accept\\_invites, /merge, /stop और /start commands केवल group chats में काम करती हैं। /terminal\\_watch, /watch, /subscribe और /unsubscribe private और group chats में काम करती हैं।"
       common
         options "🔧 *Common Options:*"
       model

package/src/locales/ru.lino

@@ -508,6 +508,13 @@ ru
       must
         be
           type "URL должен быть GitHub {{allowedTypes}} (не {{type}})"
+      recovered """
+        ℹ️ Ссылка была исправлена перед запуском.
+
+        Вы отправили: {{original}}
+        Используется: {{used}}
+        Исправлено: {{repairs}}
+      """
     language
       invalid """
         ❌ Неверный язык. Поддерживаются: {{supported}}.
@@ -583,6 +590,7 @@ ru
         usage "Использование: `/hive <github-url> [options]`"
         example "Пример: `/hive https://github.com/owner/repo`"
         disabled "*/hive* - ❌ Отключено"
+      models "*/models* - Показать доступные модели, объединённые из этой установки и всех живых источников. Использование: `/models [--tool claude|codex|...] [--details] [--refresh] [--all]`"
       limits "*/limits* - Показать лимиты использования"
       version "*/version* - Показать версии бота и среды выполнения"
       language "*/language* `[en|ru|zh|hi]` - Установить или показать предпочитаемый язык ответов (в памяти, для пользователя)"
@@ -604,7 +612,7 @@ ru
       isolation
         mode "🔒 *Режим изоляции:* `{{isolationBackend}}` (экспериментально)"
       group
-        note "⚠️ *Замечание:* команды /solve, /do, /continue, /claude, /codex, /opencode, /agent, /gemini, /qwen, /task, /split, /fix, /hive, /queue, /limits, /version, /accept\\_invites, /merge, /stop и /start работают только в групповых чатах. /terminal\\_watch, /watch, /subscribe и /unsubscribe работают в личных и групповых чатах."
+        note "⚠️ *Замечание:* команды /solve, /do, /continue, /claude, /codex, /opencode, /agent, /gemini, /qwen, /task, /split, /fix, /hive, /queue, /models, /limits, /version, /accept\\_invites, /merge, /stop и /start работают только в групповых чатах. /terminal\\_watch, /watch, /subscribe и /unsubscribe работают в личных и групповых чатах."
       common
         options "🔧 *Общие опции:*"
       model

package/src/locales/zh.lino

@@ -508,6 +508,13 @@ zh
       must
         be
           type "URL 必须是 GitHub {{allowedTypes}}（不是 {{type}}）"
+      recovered """
+        ℹ️ 开始前已修复链接。
+
+        您发送的：{{original}}
+        实际使用：{{used}}
+        修复内容：{{repairs}}
+      """
     language
       invalid """
         ❌ 语言无效。支持的语言：{{supported}}。
@@ -583,6 +590,7 @@ zh
         usage "用法：`/hive <github-url> [options]`"
         example "示例：`/hive https://github.com/owner/repo`"
         disabled "*/hive* - ❌ 已禁用"
+      models "*/models* - 列出可用模型，合并本次安装自带的模型与所有实时来源的模型。用法：`/models [--tool claude|codex|...] [--details] [--refresh] [--all]`"
       limits "*/limits* - 显示使用限额"
       version "*/version* - 显示机器人和运行时版本"
       language "*/language* `[en|ru|zh|hi]` - 设置或显示首选回复语言（内存中，按用户）"
@@ -604,7 +612,7 @@ zh
       isolation
         mode "🔒 *隔离模式：* `{{isolationBackend}}`（实验性）"
       group
-        note "⚠️ *注意：* /solve、/do、/continue、/claude、/codex、/opencode、/agent、/gemini、/qwen、/task、/split、/fix、/hive、/queue、/limits、/version、/accept\\_invites、/merge、/stop 和 /start 仅在群聊中有效。/terminal\\_watch、/watch、/subscribe 和 /unsubscribe 在私聊和群聊中有效。"
+        note "⚠️ *注意：* /solve、/do、/continue、/claude、/codex、/opencode、/agent、/gemini、/qwen、/task、/split、/fix、/hive、/queue、/models、/limits、/version、/accept\\_invites、/merge、/stop 和 /start 仅在群聊中有效。/terminal\\_watch、/watch、/subscribe 和 /unsubscribe 在私聊和群聊中有效。"
       common
         options "🔧 *常用选项：*"
       model