@ihazz/bitrix24 1.1.6 → 1.1.8

package/src/commands.ts

@@ -4,12 +4,21 @@
  * Standard OpenClaw bot commands registered via imbot.v2.Command.register.
  */
 
+import {
+  commandDescription,
+  commandGroupLabel,
+  commandHelpTextLabels,
+  commandParams,
+  commandRegistrationParams,
+  commandRegistrationTitle,
+  modelsCommandReplyLabels,
+} from './i18n.js';
+import type { CommandGroup } from './i18n.js';
+
 export interface BotCommandDef {
   command: string;
-  en: string;
-  ru: string;
-  params?: string;
-  group: 'status' | 'session' | 'options' | 'management' | 'tools' | 'export';
+  hasParams?: boolean;
+  group: CommandGroup;
 }
 
 const SHORT_HELP_COMMANDS = new Set(['help', 'status', 'commands', 'new', 'models']);
@@ -17,94 +26,70 @@ const COMMAND_META_COLOR = '#6C788A';
 const COMMAND_GROUP_ORDER = ['status', 'session', 'options', 'management', 'tools', 'export'] as const;
 const MODELS_PROVIDER_LINE_RE = /^[•*-]\s+([^()\s]+)\s+\((\d+)\)$/i;
 
-const COMMAND_GROUP_LABELS = {
-  ru: {
-    status: 'Справка и статус',
-    session: 'Сессия',
-    options: 'Параметры',
-    management: 'Управление',
-    tools: 'Инструменты',
-    export: 'Экспорт',
-  },
-  en: {
-    status: 'Help and status',
-    session: 'Session',
-    options: 'Options',
-    management: 'Management',
-    tools: 'Tools',
-    export: 'Export',
-  },
-} as const;
-
 /**
  * Standard OpenClaw commands.
  * Excludes: focus/unfocus/agents (Discord-specific), allowlist/bash (text-only scope).
  */
 export const OPENCLAW_COMMANDS: BotCommandDef[] = [
   // ── Status ──
-  { command: 'help', en: 'Show available commands', ru: 'Показать доступные команды', group: 'status' },
-  { command: 'commands', en: 'List all slash commands', ru: 'Показать все команды', group: 'status' },
-  { command: 'status', en: 'Show current status', ru: 'Показать текущий статус', group: 'status' },
-  { command: 'context', en: 'Explain how context is built', ru: 'Объяснить, как формируется контекст', group: 'status' },
-  { command: 'whoami', en: 'Show your sender ID', ru: 'Показать ваш ID', group: 'status' },
-  { command: 'usage', en: 'Usage and cost summary', ru: 'Использование и стоимость', params: 'off | tokens | full | cost', group: 'status' },
+  { command: 'help', group: 'status' },
+  { command: 'commands', group: 'status' },
+  { command: 'status', group: 'status' },
+  { command: 'context', group: 'status' },
+  { command: 'whoami', group: 'status' },
+  { command: 'usage', hasParams: true, group: 'status' },
 
   // ── Session ──
-  { command: 'new', en: 'Start a new session', ru: 'Начать новую сессию', group: 'session' },
-  { command: 'reset', en: 'Reset the current session', ru: 'Сбросить текущую сессию', group: 'session' },
-  { command: 'stop', en: 'Stop the current run', ru: 'Остановить текущий запуск', group: 'session' },
-  { command: 'compact', en: 'Compact the session context', ru: 'Сжать контекст сессии', params: 'instructions', group: 'session' },
-  { command: 'session', en: 'Manage session settings', ru: 'Настройки сессии', params: 'ttl | ...', group: 'session' },
+  { command: 'new', group: 'session' },
+  { command: 'reset', group: 'session' },
+  { command: 'stop', group: 'session' },
+  { command: 'compact', hasParams: true, group: 'session' },
+  { command: 'session', hasParams: true, group: 'session' },
 
   // ── Options ──
-  { command: 'model', en: 'Show or set the model', ru: 'Показать или сменить модель', params: 'model name', group: 'options' },
-  { command: 'models', en: 'List available models', ru: 'Показать модели', params: 'provider', group: 'options' },
-  { command: 'think', en: 'Set thinking level', ru: 'Уровень размышлений', params: 'off | low | medium | high', group: 'options' },
-  { command: 'verbose', en: 'Toggle verbose mode', ru: 'Подробный режим', params: 'on | off', group: 'options' },
-  { command: 'reasoning', en: 'Toggle reasoning visibility', ru: 'Видимость рассуждений', params: 'on | off | stream', group: 'options' },
-  { command: 'elevated', en: 'Toggle elevated mode', ru: 'Режим с расширенными правами', params: 'on | off | ask | full', group: 'options' },
-  { command: 'exec', en: 'Set exec defaults', ru: 'Настройки выполнения', params: 'host | security | ask | node', group: 'options' },
-  { command: 'queue', en: 'Adjust queue settings', ru: 'Настройки очереди', params: 'mode | debounce | cap | drop', group: 'options' },
+  { command: 'model', hasParams: true, group: 'options' },
+  { command: 'models', hasParams: true, group: 'options' },
+  { command: 'think', hasParams: true, group: 'options' },
+  { command: 'verbose', hasParams: true, group: 'options' },
+  { command: 'reasoning', hasParams: true, group: 'options' },
+  { command: 'elevated', hasParams: true, group: 'options' },
+  { command: 'exec', hasParams: true, group: 'options' },
+  { command: 'queue', hasParams: true, group: 'options' },
 
   // ── Management ──
-  { command: 'config', en: 'Show or set config values', ru: 'Показать или изменить конфигурацию', params: 'show | get | set | unset', group: 'management' },
-  { command: 'debug', en: 'Set runtime debug overrides', ru: 'Отладочные настройки', params: 'show | reset | set | unset', group: 'management' },
-  { command: 'approve', en: 'Approve or deny exec requests', ru: 'Одобрить или отклонить запросы', group: 'management' },
-  { command: 'activation', en: 'Set group activation mode', ru: 'Режим активации в группах', params: 'mention | always', group: 'management' },
-  { command: 'send', en: 'Set send policy', ru: 'Политика отправки', params: 'on | off | inherit', group: 'management' },
-  { command: 'subagents', en: 'Manage subagent runs', ru: 'Управление субагентами', group: 'management' },
-  { command: 'kill', en: 'Kill a running subagent', ru: 'Остановить субагента', params: 'id | all', group: 'management' },
-  { command: 'steer', en: 'Send guidance to a subagent', ru: 'Направить субагента', params: 'message', group: 'management' },
+  { command: 'config', hasParams: true, group: 'management' },
+  { command: 'debug', hasParams: true, group: 'management' },
+  { command: 'approve', group: 'management' },
+  { command: 'activation', hasParams: true, group: 'management' },
+  { command: 'send', hasParams: true, group: 'management' },
+  { command: 'subagents', group: 'management' },
+  { command: 'kill', hasParams: true, group: 'management' },
+  { command: 'steer', hasParams: true, group: 'management' },
 
   // ── Tools ──
-  { command: 'skill', en: 'Run a skill by name', ru: 'Запустить навык', params: 'name', group: 'tools' },
-  { command: 'restart', en: 'Restart OpenClaw', ru: 'Перезапустить OpenClaw', group: 'tools' },
+  { command: 'skill', hasParams: true, group: 'tools' },
+  { command: 'restart', group: 'tools' },
 
   // ── Export ──
-  { command: 'export-session', en: 'Export session to HTML', ru: 'Экспорт сессии в HTML', group: 'export' },
+  { command: 'export-session', group: 'export' },
 ];
 
 export function buildCommandsHelpText(
   lang: string | undefined,
   options?: { concise?: boolean },
 ): string {
-  const isRu = lang?.toLowerCase().startsWith('ru') ?? false;
   const concise = options?.concise === true;
   const defs = concise
     ? OPENCLAW_COMMANDS.filter((def) => SHORT_HELP_COMMANDS.has(def.command))
     : OPENCLAW_COMMANDS;
-  const labels = isRu ? COMMAND_GROUP_LABELS.ru : COMMAND_GROUP_LABELS.en;
+  const labels = commandHelpTextLabels(lang);
   const header = concise
-    ? (isRu ? '[B]Основные команды[/B]' : '[B]Key commands[/B]')
-    : (isRu ? '[B]Доступные команды[/B]' : '[B]Available commands[/B]');
+    ? `[B]${labels.conciseHeader}[/B]`
+    : `[B]${labels.fullHeader}[/B]`;
   const footer = concise
-    ? (isRu
-      ? `[COLOR=${COMMAND_META_COLOR}]Полный список:[/COLOR] ${formatCommandTrigger({
-        command: 'commands',
-      })}`
-      : `[COLOR=${COMMAND_META_COLOR}]Full list:[/COLOR] ${formatCommandTrigger({
-        command: 'commands',
-      })}`)
+    ? `[COLOR=${COMMAND_META_COLOR}]${labels.fullListLabel}:[/COLOR] ${formatCommandTrigger({
+      command: 'commands',
+    })}`
     : '';
 
   const sections = COMMAND_GROUP_ORDER
@@ -114,12 +99,12 @@ export function buildCommandsHelpText(
         return '';
       }
 
-      const lines = groupDefs.map((def) => formatCommandEntry(def, isRu));
+      const lines = groupDefs.map((def) => formatCommandEntry(def, lang, labels.paramsLabel));
       if (concise) {
         return lines.join('\n');
       }
 
-      return [`[B]${labels[group]}[/B]`, ...lines].join('\n');
+      return [`[B]${commandGroupLabel(lang, group)}[/B]`, ...lines].join('\n');
     })
     .filter(Boolean);
 
@@ -150,14 +135,10 @@ export function formatModelsCommandReply(
     return null;
   }
 
-  const isRu = lang?.toLowerCase().startsWith('ru') ?? false;
-  const header = isRu ? '[B]Провайдеры[/B]' : '[B]Providers[/B]';
-  const showModelsLabel = isRu
-    ? `[COLOR=${COMMAND_META_COLOR}]Модели провайдера:[/COLOR]`
-    : `[COLOR=${COMMAND_META_COLOR}]Show provider models:[/COLOR]`;
-  const switchModelLabel = isRu
-    ? `[COLOR=${COMMAND_META_COLOR}]Сменить модель:[/COLOR]`
-    : `[COLOR=${COMMAND_META_COLOR}]Switch model:[/COLOR]`;
+  const labels = modelsCommandReplyLabels(lang);
+  const header = `[B]${labels.header}[/B]`;
+  const showModelsLabel = `[COLOR=${COMMAND_META_COLOR}]${labels.showProviderModels}:[/COLOR]`;
+  const switchModelLabel = `[COLOR=${COMMAND_META_COLOR}]${labels.switchModel}:[/COLOR]`;
 
   const providerLines = providers.map((provider) => {
     return `• [send=/models ${provider.name}]${provider.name}[/send] [COLOR=${COMMAND_META_COLOR}](${provider.count})[/COLOR]`;
@@ -172,25 +153,38 @@ export function formatModelsCommandReply(
   ].join('\n');
 }
 
-function formatCommandEntry(def: BotCommandDef, isRu: boolean): string {
-  const description = isRu ? def.ru : def.en;
-  const paramsLabel = isRu ? 'Параметры' : 'Params';
+export function getCommandRegistrationPayload(def: BotCommandDef): {
+  title: Record<string, string>;
+  params?: Record<string, string>;
+} {
+  const title = commandRegistrationTitle(def.command);
+  const params = commandRegistrationParams(def.command);
+
+  return {
+    title,
+    ...(params ? { params } : {}),
+  };
+}
+
+function formatCommandEntry(def: BotCommandDef, lang: string | undefined, paramsLabel: string): string {
+  const description = commandDescription(lang, def.command);
+  const params = commandParams(lang, def.command);
   const command = formatCommandTrigger(def);
 
-  if (!def.params) {
+  if (!params) {
     return `${command} — ${description}`;
   }
 
   return [
     `${command} — ${description}`,
-    `[COLOR=${COMMAND_META_COLOR}]${paramsLabel}: ${def.params}[/COLOR]`,
+    `[COLOR=${COMMAND_META_COLOR}]${paramsLabel}: ${params}[/COLOR]`,
   ].join('\n');
 }
 
-function formatCommandTrigger(def: Pick<BotCommandDef, 'command' | 'params'>): string {
+function formatCommandTrigger(def: Pick<BotCommandDef, 'command' | 'hasParams'>): string {
   const visibleCommand = `/${def.command}`;
 
-  if (!def.params) {
+  if (!def.hasParams) {
     return `[send=/${def.command}]${visibleCommand}[/send]`;
   }