@ihazz/bitrix24 1.1.7 → 1.1.9

package/src/i18n.ts

@@ -10,6 +10,8 @@ export function resolveLocale(lang: string | undefined): string {
   return (lang ?? 'en').toLowerCase().slice(0, 2);
 }
 
+const SUPPORTED_LOCALES = ['en', 'ru', 'de', 'es', 'fr', 'pt'] as const;
+
 function resolve<T>(dict: Record<string, T>, lang: string | undefined): T {
   const code = resolveLocale(lang);
   return dict[code] ?? dict.en;
@@ -216,6 +218,436 @@ export function onboardingMessage(
     : welcomeMessage(lang, botName);
 }
 
+export type CommandGroup = 'status' | 'session' | 'options' | 'management' | 'tools' | 'export';
+
+type CommandText = {
+  description: string;
+  params?: string;
+};
+
+type CommandTextMap = Record<string, CommandText>;
+
+interface CommandHelpTextLabels {
+  conciseHeader: string;
+  fullHeader: string;
+  fullListLabel: string;
+  paramsLabel: string;
+}
+
+interface ModelsCommandReplyLabels {
+  header: string;
+  showProviderModels: string;
+  switchModel: string;
+}
+
+interface NewSessionReplyTexts {
+  started: string;
+  active: string;
+}
+
+const I18N_COMMAND_GROUP_LABELS: Record<string, Record<CommandGroup, string>> = {
+  en: {
+    status: 'Help and status',
+    session: 'Session',
+    options: 'Options',
+    management: 'Management',
+    tools: 'Tools',
+    export: 'Export',
+  },
+  ru: {
+    status: 'Справка и статус',
+    session: 'Сессия',
+    options: 'Параметры',
+    management: 'Управление',
+    tools: 'Инструменты',
+    export: 'Экспорт',
+  },
+  de: {
+    status: 'Hilfe und Status',
+    session: 'Sitzung',
+    options: 'Optionen',
+    management: 'Verwaltung',
+    tools: 'Werkzeuge',
+    export: 'Export',
+  },
+  es: {
+    status: 'Ayuda y estado',
+    session: 'Sesion',
+    options: 'Opciones',
+    management: 'Administracion',
+    tools: 'Herramientas',
+    export: 'Exportacion',
+  },
+  fr: {
+    status: 'Aide et statut',
+    session: 'Session',
+    options: 'Options',
+    management: 'Gestion',
+    tools: 'Outils',
+    export: 'Export',
+  },
+  pt: {
+    status: 'Ajuda e status',
+    session: 'Sessao',
+    options: 'Opcoes',
+    management: 'Gerenciamento',
+    tools: 'Ferramentas',
+    export: 'Exportacao',
+  },
+};
+
+const I18N_COMMAND_HELP_TEXT_LABELS: Record<string, CommandHelpTextLabels> = {
+  en: {
+    conciseHeader: 'Key commands',
+    fullHeader: 'Available commands',
+    fullListLabel: 'Full list',
+    paramsLabel: 'Params',
+  },
+  ru: {
+    conciseHeader: 'Основные команды',
+    fullHeader: 'Доступные команды',
+    fullListLabel: 'Полный список',
+    paramsLabel: 'Параметры',
+  },
+  de: {
+    conciseHeader: 'Wichtige Befehle',
+    fullHeader: 'Verfuegbare Befehle',
+    fullListLabel: 'Vollstaendige Liste',
+    paramsLabel: 'Parameter',
+  },
+  es: {
+    conciseHeader: 'Comandos clave',
+    fullHeader: 'Comandos disponibles',
+    fullListLabel: 'Lista completa',
+    paramsLabel: 'Parametros',
+  },
+  fr: {
+    conciseHeader: 'Commandes principales',
+    fullHeader: 'Commandes disponibles',
+    fullListLabel: 'Liste complete',
+    paramsLabel: 'Parametres',
+  },
+  pt: {
+    conciseHeader: 'Comandos principais',
+    fullHeader: 'Comandos disponiveis',
+    fullListLabel: 'Lista completa',
+    paramsLabel: 'Parametros',
+  },
+};
+
+const I18N_COMMAND_TEXTS: Record<string, CommandTextMap> = {
+  en: {
+    help: { description: 'Show available commands' },
+    commands: { description: 'List all slash commands' },
+    status: { description: 'Show current status' },
+    context: { description: 'Explain how context is built' },
+    whoami: { description: 'Show your sender ID' },
+    usage: { description: 'Usage and cost summary', params: 'off | tokens | full | cost' },
+    new: { description: 'Start a new session' },
+    reset: { description: 'Reset the current session' },
+    stop: { description: 'Stop the current run' },
+    compact: { description: 'Compact the session context', params: 'instructions' },
+    session: { description: 'Manage session settings', params: 'ttl | ...' },
+    model: { description: 'Show or set the model', params: 'model name' },
+    models: { description: 'List available models', params: 'provider' },
+    think: { description: 'Set thinking level', params: 'off | low | medium | high' },
+    verbose: { description: 'Toggle verbose mode', params: 'on | off' },
+    reasoning: { description: 'Toggle reasoning visibility', params: 'on | off | stream' },
+    elevated: { description: 'Toggle elevated mode', params: 'on | off | ask | full' },
+    exec: { description: 'Set exec defaults', params: 'host | security | ask | node' },
+    queue: { description: 'Adjust queue settings', params: 'mode | debounce | cap | drop' },
+    config: { description: 'Show or set config values', params: 'show | get | set | unset' },
+    debug: { description: 'Set runtime debug overrides', params: 'show | reset | set | unset' },
+    approve: { description: 'Approve or deny exec requests' },
+    activation: { description: 'Set group activation mode', params: 'mention | always' },
+    send: { description: 'Set send policy', params: 'on | off | inherit' },
+    subagents: { description: 'Manage subagent runs' },
+    kill: { description: 'Kill a running subagent', params: 'id | all' },
+    steer: { description: 'Send guidance to a subagent', params: 'message' },
+    skill: { description: 'Run a skill by name', params: 'name' },
+    restart: { description: 'Restart OpenClaw' },
+    'export-session': { description: 'Export session to HTML' },
+  },
+  ru: {
+    help: { description: 'Показать доступные команды' },
+    commands: { description: 'Показать все команды' },
+    status: { description: 'Показать текущий статус' },
+    context: { description: 'Объяснить, как формируется контекст' },
+    whoami: { description: 'Показать ваш ID' },
+    usage: { description: 'Использование и стоимость', params: 'off | tokens | full | cost' },
+    new: { description: 'Начать новую сессию' },
+    reset: { description: 'Сбросить текущую сессию' },
+    stop: { description: 'Остановить текущий запуск' },
+    compact: { description: 'Сжать контекст сессии', params: 'instructions' },
+    session: { description: 'Настройки сессии', params: 'ttl | ...' },
+    model: { description: 'Показать или сменить модель', params: 'model name' },
+    models: { description: 'Показать модели', params: 'provider' },
+    think: { description: 'Уровень размышлений', params: 'off | low | medium | high' },
+    verbose: { description: 'Подробный режим', params: 'on | off' },
+    reasoning: { description: 'Видимость рассуждений', params: 'on | off | stream' },
+    elevated: { description: 'Режим с расширенными правами', params: 'on | off | ask | full' },
+    exec: { description: 'Настройки выполнения', params: 'host | security | ask | node' },
+    queue: { description: 'Настройки очереди', params: 'mode | debounce | cap | drop' },
+    config: { description: 'Показать или изменить конфигурацию', params: 'show | get | set | unset' },
+    debug: { description: 'Отладочные настройки', params: 'show | reset | set | unset' },
+    approve: { description: 'Одобрить или отклонить запросы' },
+    activation: { description: 'Режим активации в группах', params: 'mention | always' },
+    send: { description: 'Политика отправки', params: 'on | off | inherit' },
+    subagents: { description: 'Управление субагентами' },
+    kill: { description: 'Остановить субагента', params: 'id | all' },
+    steer: { description: 'Направить субагента', params: 'message' },
+    skill: { description: 'Запустить навык', params: 'name' },
+    restart: { description: 'Перезапустить OpenClaw' },
+    'export-session': { description: 'Экспорт сессии в HTML' },
+  },
+  de: {
+    help: { description: 'Verfuegbare Befehle anzeigen' },
+    commands: { description: 'Alle Slash-Befehle auflisten' },
+    status: { description: 'Aktuellen Status anzeigen' },
+    context: { description: 'Erklaeren, wie der Kontext aufgebaut wird' },
+    whoami: { description: 'Ihre Sender-ID anzeigen' },
+    usage: { description: 'Nutzung und Kostenuebersicht', params: 'off | tokens | full | cost' },
+    new: { description: 'Neue Sitzung starten' },
+    reset: { description: 'Aktuelle Sitzung zuruecksetzen' },
+    stop: { description: 'Aktuellen Lauf stoppen' },
+    compact: { description: 'Sitzungskontext komprimieren', params: 'instructions' },
+    session: { description: 'Sitzungseinstellungen verwalten', params: 'ttl | ...' },
+    model: { description: 'Modell anzeigen oder festlegen', params: 'Modellname' },
+    models: { description: 'Verfuegbare Modelle auflisten', params: 'Anbieter' },
+    think: { description: 'Denkstufe festlegen', params: 'off | low | medium | high' },
+    verbose: { description: 'Ausfuehrlichen Modus umschalten', params: 'on | off' },
+    reasoning: { description: 'Sichtbarkeit des Reasonings umschalten', params: 'on | off | stream' },
+    elevated: { description: 'Erweiterten Modus umschalten', params: 'on | off | ask | full' },
+    exec: { description: 'Exec-Standards festlegen', params: 'host | security | ask | node' },
+    queue: { description: 'Warteschlangeneinstellungen anpassen', params: 'mode | debounce | cap | drop' },
+    config: { description: 'Konfigurationswerte anzeigen oder setzen', params: 'show | get | set | unset' },
+    debug: { description: 'Debug-Ueberschreibungen festlegen', params: 'show | reset | set | unset' },
+    approve: { description: 'Exec-Anfragen genehmigen oder ablehnen' },
+    activation: { description: 'Gruppenaktivierungsmodus festlegen', params: 'mention | always' },
+    send: { description: 'Sendeverhalten festlegen', params: 'on | off | inherit' },
+    subagents: { description: 'Subagent-Laeufe verwalten' },
+    kill: { description: 'Laufenden Subagenten beenden', params: 'id | all' },
+    steer: { description: 'Hinweise an einen Subagenten senden', params: 'Nachricht' },
+    skill: { description: 'Skill nach Namen ausfuehren', params: 'Name' },
+    restart: { description: 'OpenClaw neu starten' },
+    'export-session': { description: 'Sitzung nach HTML exportieren' },
+  },
+  es: {
+    help: { description: 'Mostrar comandos disponibles' },
+    commands: { description: 'Listar todos los comandos con barra' },
+    status: { description: 'Mostrar el estado actual' },
+    context: { description: 'Explicar como se construye el contexto' },
+    whoami: { description: 'Mostrar su ID de remitente' },
+    usage: { description: 'Resumen de uso y costo', params: 'off | tokens | full | cost' },
+    new: { description: 'Iniciar una nueva sesion' },
+    reset: { description: 'Restablecer la sesion actual' },
+    stop: { description: 'Detener la ejecucion actual' },
+    compact: { description: 'Compactar el contexto de la sesion', params: 'instructions' },
+    session: { description: 'Gestionar la configuracion de la sesion', params: 'ttl | ...' },
+    model: { description: 'Mostrar o cambiar el modelo', params: 'nombre del modelo' },
+    models: { description: 'Listar modelos disponibles', params: 'proveedor' },
+    think: { description: 'Definir el nivel de razonamiento', params: 'off | low | medium | high' },
+    verbose: { description: 'Alternar el modo detallado', params: 'on | off' },
+    reasoning: { description: 'Alternar la visibilidad del razonamiento', params: 'on | off | stream' },
+    elevated: { description: 'Alternar el modo elevado', params: 'on | off | ask | full' },
+    exec: { description: 'Definir valores predeterminados de exec', params: 'host | security | ask | node' },
+    queue: { description: 'Ajustar la configuracion de la cola', params: 'mode | debounce | cap | drop' },
+    config: { description: 'Mostrar o establecer valores de configuracion', params: 'show | get | set | unset' },
+    debug: { description: 'Definir anulaciones de depuracion', params: 'show | reset | set | unset' },
+    approve: { description: 'Aprobar o rechazar solicitudes de exec' },
+    activation: { description: 'Definir el modo de activacion en grupos', params: 'mention | always' },
+    send: { description: 'Definir la politica de envio', params: 'on | off | inherit' },
+    subagents: { description: 'Gestionar ejecuciones de subagentes' },
+    kill: { description: 'Finalizar un subagente en ejecucion', params: 'id | all' },
+    steer: { description: 'Enviar instrucciones a un subagente', params: 'mensaje' },
+    skill: { description: 'Ejecutar una habilidad por nombre', params: 'nombre' },
+    restart: { description: 'Reiniciar OpenClaw' },
+    'export-session': { description: 'Exportar la sesion a HTML' },
+  },
+  fr: {
+    help: { description: 'Afficher les commandes disponibles' },
+    commands: { description: 'Lister toutes les commandes slash' },
+    status: { description: 'Afficher le statut actuel' },
+    context: { description: 'Expliquer comment le contexte est construit' },
+    whoami: { description: 'Afficher votre identifiant expediteur' },
+    usage: { description: 'Resume de l utilisation et du cout', params: 'off | tokens | full | cost' },
+    new: { description: 'Demarrer une nouvelle session' },
+    reset: { description: 'Reinitialiser la session actuelle' },
+    stop: { description: 'Arreter l execution en cours' },
+    compact: { description: 'Compacter le contexte de la session', params: 'instructions' },
+    session: { description: 'Gerer les parametres de session', params: 'ttl | ...' },
+    model: { description: 'Afficher ou definir le modele', params: 'nom du modele' },
+    models: { description: 'Lister les modeles disponibles', params: 'fournisseur' },
+    think: { description: 'Definir le niveau de reflexion', params: 'off | low | medium | high' },
+    verbose: { description: 'Activer ou desactiver le mode verbeux', params: 'on | off' },
+    reasoning: { description: 'Afficher ou masquer le raisonnement', params: 'on | off | stream' },
+    elevated: { description: 'Activer ou desactiver le mode eleve', params: 'on | off | ask | full' },
+    exec: { description: 'Definir les valeurs exec par defaut', params: 'host | security | ask | node' },
+    queue: { description: 'Ajuster les parametres de file', params: 'mode | debounce | cap | drop' },
+    config: { description: 'Afficher ou definir les valeurs de configuration', params: 'show | get | set | unset' },
+    debug: { description: 'Definir les surcharges de debug', params: 'show | reset | set | unset' },
+    approve: { description: 'Approuver ou refuser les demandes exec' },
+    activation: { description: 'Definir le mode d activation en groupe', params: 'mention | always' },
+    send: { description: 'Definir la politique d envoi', params: 'on | off | inherit' },
+    subagents: { description: 'Gerer les executions de sous-agents' },
+    kill: { description: 'Arreter un sous-agent en cours', params: 'id | all' },
+    steer: { description: 'Envoyer des instructions a un sous-agent', params: 'message' },
+    skill: { description: 'Executer une competence par nom', params: 'nom' },
+    restart: { description: 'Redemarrer OpenClaw' },
+    'export-session': { description: 'Exporter la session en HTML' },
+  },
+  pt: {
+    help: { description: 'Mostrar comandos disponiveis' },
+    commands: { description: 'Listar todos os comandos com barra' },
+    status: { description: 'Mostrar o status atual' },
+    context: { description: 'Explicar como o contexto e montado' },
+    whoami: { description: 'Mostrar seu ID de remetente' },
+    usage: { description: 'Resumo de uso e custo', params: 'off | tokens | full | cost' },
+    new: { description: 'Iniciar uma nova sessao' },
+    reset: { description: 'Redefinir a sessao atual' },
+    stop: { description: 'Parar a execucao atual' },
+    compact: { description: 'Compactar o contexto da sessao', params: 'instructions' },
+    session: { description: 'Gerenciar configuracoes da sessao', params: 'ttl | ...' },
+    model: { description: 'Mostrar ou definir o modelo', params: 'nome do modelo' },
+    models: { description: 'Listar modelos disponiveis', params: 'provedor' },
+    think: { description: 'Definir nivel de raciocinio', params: 'off | low | medium | high' },
+    verbose: { description: 'Alternar modo detalhado', params: 'on | off' },
+    reasoning: { description: 'Alternar visibilidade do raciocinio', params: 'on | off | stream' },
+    elevated: { description: 'Alternar modo elevado', params: 'on | off | ask | full' },
+    exec: { description: 'Definir padroes de exec', params: 'host | security | ask | node' },
+    queue: { description: 'Ajustar configuracoes da fila', params: 'mode | debounce | cap | drop' },
+    config: { description: 'Mostrar ou definir valores de configuracao', params: 'show | get | set | unset' },
+    debug: { description: 'Definir sobrescritas de debug', params: 'show | reset | set | unset' },
+    approve: { description: 'Aprovar ou recusar solicitacoes de exec' },
+    activation: { description: 'Definir modo de ativacao em grupos', params: 'mention | always' },
+    send: { description: 'Definir politica de envio', params: 'on | off | inherit' },
+    subagents: { description: 'Gerenciar execucoes de subagentes' },
+    kill: { description: 'Encerrar um subagente em execucao', params: 'id | all' },
+    steer: { description: 'Enviar orientacao para um subagente', params: 'mensagem' },
+    skill: { description: 'Executar uma habilidade pelo nome', params: 'nome' },
+    restart: { description: 'Reiniciar OpenClaw' },
+    'export-session': { description: 'Exportar a sessao para HTML' },
+  },
+};
+
+const I18N_MODELS_COMMAND_REPLY_LABELS: Record<string, ModelsCommandReplyLabels> = {
+  en: {
+    header: 'Providers',
+    showProviderModels: 'Show provider models',
+    switchModel: 'Switch model',
+  },
+  ru: {
+    header: 'Провайдеры',
+    showProviderModels: 'Модели провайдера',
+    switchModel: 'Сменить модель',
+  },
+  de: {
+    header: 'Anbieter',
+    showProviderModels: 'Anbietermodelle anzeigen',
+    switchModel: 'Modell wechseln',
+  },
+  es: {
+    header: 'Proveedores',
+    showProviderModels: 'Mostrar modelos del proveedor',
+    switchModel: 'Cambiar modelo',
+  },
+  fr: {
+    header: 'Fournisseurs',
+    showProviderModels: 'Afficher les modeles du fournisseur',
+    switchModel: 'Changer de modele',
+  },
+  pt: {
+    header: 'Provedores',
+    showProviderModels: 'Mostrar modelos do provedor',
+    switchModel: 'Trocar modelo',
+  },
+};
+
+const I18N_NEW_SESSION_REPLY_TEXTS: Record<string, NewSessionReplyTexts> = {
+  en: {
+    started: 'Started a new session.',
+    active: 'You are now in a new session.',
+  },
+  ru: {
+    started: 'Начата новая сессия.',
+    active: 'Теперь вы в новой сессии.',
+  },
+  de: {
+    started: 'Neue Sitzung gestartet.',
+    active: 'Sie sind jetzt in einer neuen Sitzung.',
+  },
+  es: {
+    started: 'Nueva sesion iniciada.',
+    active: 'Ahora esta en una nueva sesion.',
+  },
+  fr: {
+    started: 'Nouvelle session demarree.',
+    active: 'Vous etes maintenant dans une nouvelle session.',
+  },
+  pt: {
+    started: 'Nova sessao iniciada.',
+    active: 'Agora voce esta em uma nova sessao.',
+  },
+};
+
+function resolveCommandTextMap(lang: string | undefined): CommandTextMap {
+  return resolve(I18N_COMMAND_TEXTS, lang);
+}
+
+function resolveCommandText(command: string, lang: string | undefined): CommandText | undefined {
+  const localized = resolveCommandTextMap(lang)[command];
+  if (localized) {
+    return localized;
+  }
+
+  return I18N_COMMAND_TEXTS.en[command];
+}
+
+export function commandGroupLabel(lang: string | undefined, group: CommandGroup): string {
+  return resolve(I18N_COMMAND_GROUP_LABELS, lang)[group];
+}
+
+export function commandHelpTextLabels(lang: string | undefined): CommandHelpTextLabels {
+  return resolve(I18N_COMMAND_HELP_TEXT_LABELS, lang);
+}
+
+export function commandDescription(lang: string | undefined, command: string): string {
+  return resolveCommandText(command, lang)?.description ?? command;
+}
+
+export function commandParams(lang: string | undefined, command: string): string | undefined {
+  return resolveCommandText(command, lang)?.params;
+}
+
+export function commandRegistrationTitle(command: string): Record<string, string> {
+  return Object.fromEntries(
+    SUPPORTED_LOCALES.map((locale) => [
+      locale,
+      I18N_COMMAND_TEXTS[locale]?.[command]?.description ?? I18N_COMMAND_TEXTS.en[command]?.description ?? command,
+    ]),
+  );
+}
+
+export function commandRegistrationParams(command: string): Record<string, string> | undefined {
+  const entries = SUPPORTED_LOCALES
+    .map((locale) => [locale, I18N_COMMAND_TEXTS[locale]?.[command]?.params ?? I18N_COMMAND_TEXTS.en[command]?.params])
+    .filter((entry): entry is [string, string] => typeof entry[1] === 'string');
+
+  if (entries.length === 0) {
+    return undefined;
+  }
+
+  return Object.fromEntries(entries);
+}
+
+export function modelsCommandReplyLabels(lang: string | undefined): ModelsCommandReplyLabels {
+  return resolve(I18N_MODELS_COMMAND_REPLY_LABELS, lang);
+}
+
+export function newSessionReplyTexts(lang: string | undefined): NewSessionReplyTexts {
+  return resolve(I18N_NEW_SESSION_REPLY_TEXTS, lang);
+}
+
 interface CommandKeyboardLabels {
   help: string;
   status: string;
@@ -224,6 +656,14 @@ interface CommandKeyboardLabels {
   models: string;
 }
 
+interface WelcomeKeyboardLabels {
+  todayTasks: string;
+  stalledDeals: string;
+  help: string;
+  newSession: string;
+  commands: string;
+}
+
 const I18N_COMMAND_KEYBOARD_LABELS: Record<string, CommandKeyboardLabels> = {
   en: {
     help: 'Help',
@@ -273,6 +713,55 @@ export function commandKeyboardLabels(lang: string | undefined): CommandKeyboard
   return resolve(I18N_COMMAND_KEYBOARD_LABELS, lang);
 }
 
+const I18N_WELCOME_KEYBOARD_LABELS: Record<string, WelcomeKeyboardLabels> = {
+  en: {
+    todayTasks: "Today's tasks",
+    stalledDeals: 'Stalled deals',
+    help: 'Help',
+    newSession: 'New session',
+    commands: 'Commands',
+  },
+  ru: {
+    todayTasks: 'Задачи на сегодня',
+    stalledDeals: 'Зависшие сделки',
+    help: 'Помощь',
+    newSession: 'Новая сессия',
+    commands: 'Команды',
+  },
+  de: {
+    todayTasks: 'Heutige Aufgaben',
+    stalledDeals: 'Blockierte Deals',
+    help: 'Hilfe',
+    newSession: 'Neue Sitzung',
+    commands: 'Befehle',
+  },
+  es: {
+    todayTasks: 'Tareas de hoy',
+    stalledDeals: 'Negocios atascados',
+    help: 'Ayuda',
+    newSession: 'Nueva sesion',
+    commands: 'Comandos',
+  },
+  fr: {
+    todayTasks: 'Taches du jour',
+    stalledDeals: 'Affaires bloquees',
+    help: 'Aide',
+    newSession: 'Nouvelle session',
+    commands: 'Commandes',
+  },
+  pt: {
+    todayTasks: 'Tarefas de hoje',
+    stalledDeals: 'Negocios travados',
+    help: 'Ajuda',
+    newSession: 'Nova sessao',
+    commands: 'Comandos',
+  },
+};
+
+export function welcomeKeyboardLabels(lang: string | undefined): WelcomeKeyboardLabels {
+  return resolve(I18N_WELCOME_KEYBOARD_LABELS, lang);
+}
+
 const I18N_REPLY_GENERATION_FAILED: Record<string, string> = {
   en: 'I could not prepare a final reply. Please try again. If your request needs web search or external tools, check that they are configured on the server.',
   ru: 'Не удалось подготовить итоговый ответ. Попробуйте повторить запрос. Если вопрос требует веб-поиска или внешних инструментов, проверьте, что они настроены на сервере.',
@@ -285,3 +774,26 @@ const I18N_REPLY_GENERATION_FAILED: Record<string, string> = {
 export function replyGenerationFailed(lang: string | undefined): string {
   return resolve(I18N_REPLY_GENERATION_FAILED, lang);
 }
+
+export function normalizeNewSessionReply(lang: string | undefined, text: string): string | null {
+  const normalized = text.trim();
+  if (!normalized) {
+    return null;
+  }
+
+  const texts = resolve(I18N_NEW_SESSION_REPLY_TEXTS, lang);
+
+  if (/^(?:started|created|opened)(?: a)? new (?:chat|conversation|session)\.?$/i.test(normalized)) {
+    return texts.started;
+  }
+
+  if (/^you are now in a new (?:chat|conversation|session)\.?$/i.test(normalized)) {
+    return texts.active;
+  }
+
+  if (/^(?:hey|hi|hello)\b[\s\S]*\b(?:ready to dive in|ready to get started|ready to help)\b[\s\S]*\b(?:what would you like to work on today|what would you like to work on|how can i help(?: you)? today)\b[.!?]?$/i.test(normalized)) {
+    return texts.started;
+  }
+
+  return null;
+}