dsh-tg-bridge 1.1.0 → 1.1.1

package/bridge.mjs

@@ -800,7 +800,7 @@ async function startProgress(chatId, threadId, lang = 'ru') {
       // Stop is available for as long as the turn runs; the keyboard is cleared
       // when the status turns into the final line, so a stale button cannot be
       // pressed after the work is over.
-      reply_markup: stopKeyboard(sessionKey(chatId, threadId)),
+      reply_markup: stopKeyboard(sessionKey(chatId, threadId), lang),
       ...(threadId > 0 ? { message_thread_id: threadId } : {}),
     });
     messageId = res.message_id;
@@ -878,8 +878,10 @@ async function startProgress(chatId, threadId, lang = 'ru') {
       if (result?.error) {
         // A failed turn leaves the status message as the error report and swaps
         // «Стоп» for «Повторить»: the person's next move is a retry, not a stop.
-        const text = `⚠️ Ход не удался за ${Math.round((Date.now() - started) / 1000)} с\n${String(result.error).slice(0, 1200)}`;
-        await edit(text, errorKeyboard(sessionKey(chatId, threadId)));
+        const failedFor = Math.round((Date.now() - started) / 1000);
+        const unit = lang === 'en' ? 's' : lang === 'zh' ? '秒' : 'с';
+        const text = `⚠️ ${t(lang, 'status.failed')} · ${failedFor} ${unit}\n${String(result.error).slice(0, 1200)}`;
+        await edit(text, errorKeyboard(sessionKey(chatId, threadId), lang));
         return true;
       }
       await edit(body(true), null);
@@ -1340,23 +1342,23 @@ const lastPrompt = new Map();
 const approvals = new Map();
 let approvalSeq = 0;
 
-function stopKeyboard(key) {
+function stopKeyboard(key, lang = 'ru') {
   return {
     inline_keyboard: [
       [
-        { text: '⏹ Стоп', callback_data: 'stop' },
-        { text: '📄 Логи', callback_data: 'logs' },
+        { text: `⏹ ${t(lang, 'btn.stop')}`, callback_data: 'stop' },
+        { text: `📄 ${t(lang, 'btn.logs')}`, callback_data: 'logs' },
       ],
     ],
   };
 }
 
-function errorKeyboard(key) {
+function errorKeyboard(key, lang = 'ru') {
   return {
     inline_keyboard: [
       [
-        { text: '🔁 Повторить', callback_data: 'retry' },
-        { text: '🩺 Диагноз', callback_data: 'doctor' },
+        { text: `🔁 ${t(lang, 'btn.retry')}`, callback_data: 'retry' },
+        { text: `🩺 ${t(lang, 'btn.doctor')}`, callback_data: 'doctor' },
       ],
     ],
   };

package/control.mjs

@@ -700,20 +700,10 @@ export async function handleControl(ctx) {
     }
 
     case '/help': {
-      say(
-        [
-          'Задачу можно писать обычным текстом. Каждая ветка форума — отдельная сессия.',
-          '',
-          'Сессии: /new · /status · /sessions [n] · /resume <id>',
-          'Модель: /models · /model <id> [both]',
-          'Расширения: /plugins [headless] · /plugin add <pkg> · /plugin remove <name> · /plugin disable|enable <id>',
-          'Скиллы: /skills · /skills <name>',
-          'Персона: /soul · /soul <текст>',
-          'Служебное: /stop · /restart confirm · /app restart confirm',
-          'Темы: /seed <текст> — засеять пустую тему и закрепить сообщение',
-          'Команды можно писать и слитно: /apprestart.confirm = /app restart confirm',
-        ].join('\n'),
-      );
+      // One translated body keeps the help in step with the menu; the Russian
+      // text stays as the fallback when a key is missing.
+      const helpLang = normalizeLang(state.lang?.[key] || config.lang) || 'ru';
+      say(t(helpLang, 'help.body'));
       return true;
     }
 

package/i18n.mjs

@@ -1,171 +1,186 @@
-// i18n — three locales for the user-visible surfaces.
-//
-// Scope: everything a person sees without asking for it — the Telegram command
-// menu, the live status message, turn errors and the everyday commands. Long
-// explanatory texts stay in the source language until they are translated
-// properly; a half-translated sentence is worse than a consistent one.
-//
-// Language resolution order: per-topic choice (/lang) -> config.lang -> the
-// sender's Telegram language_code -> 'ru'.
-import { readFileSync } from 'node:fs';
-import { join } from 'node:path';
-
-export const LANGS = ['en', 'ru', 'zh'];
-
-const DICT = {
-  en: {
-    'status.working': 'Working',
-    'status.done': 'Done',
-    'status.failed': 'Turn failed',
-    'status.queued': 'queued',
-    'status.stop': 'Stop',
-    'status.cache': 'cache',
-    'status.steps': 'steps',
-    'status.thinking': 'waiting for the model',
-    'err.timeout': 'no activity for {min} min — turn interrupted',
-    'err.generic': 'something went wrong',
-    'msg.started': 'Telegram bridge for DSH is running (headless). Send a task; /help for commands.',
-    'msg.unknownCommand': 'Unknown command: {cmd}. Open /help — it lists everything this bot can do.',
-    'msg.langSet': 'Language set to English.',
-    'cmd.help.title': 'Commands',
-    'cmd.help.hint': 'Send any text to start a task. In a forum topic: /cd <project> binds the topic to that project.',
-    'cmd.cd.bound': 'Topic bound to project:\n{path}\n\nAll turns run from this directory.',
-    'cmd.cd.reset': 'Topic directory reset to the shared one.',
-    'cmd.cd.none': 'No such directory: {path}',
-    'cmd.new.done': 'New session in this topic. Context cleared.',
-    'cmd.stop.killed': 'Turn stopped.',
-    'cmd.stop.nothing': 'Nothing to stop.',
-    'menu.status': 'Sessions, model, active turns',
-    'menu.cd': 'Bind this topic to a project directory',
-    'menu.send': 'Send a file from the project into the chat',
-    'menu.prices': 'Model prices from the router',
-    'menu.stop': 'Stop the current turn',
-    'menu.new': 'New session in this topic',
-    'menu.seed': 'Seed an empty topic with text and pin it',
-    'menu.sessions': 'Recent sessions',
-    'menu.resume': 'Continue a session by id',
-    'menu.models': 'Available models',
-    'menu.model': 'Show or switch the model',
-    'menu.skills': 'Installed skills',
-    'menu.soul': 'Agent persona',
-    'menu.plugins': 'Installed plugins',
-    'menu.plugin': 'Enable or disable a plugin',
-    'menu.app': 'Desktop app control',
-    'menu.restart': 'Restart the agent',
-    'menu.help': 'All commands and hints',
-    'menu.lang': 'Interface language: en, ru, zh',
-  },
-  ru: {
-    'status.working': 'Работаю',
-    'status.done': 'Готово',
-    'status.failed': 'Ход не удался',
-    'status.queued': 'в очереди',
-    'status.stop': 'Стоп',
-    'status.cache': 'кэш',
-    'status.steps': 'шагов',
-    'status.thinking': 'жду модель',
-    'err.timeout': 'нет активности {min} мин — ход прерван',
-    'err.generic': 'что-то пошло не так',
-    'msg.started': 'Telegram-мост DSH запущен (headless). Пиши задачу; /help — команды.',
-    'msg.unknownCommand': 'Неизвестная команда: {cmd}. Открой /help — там всё, что умеет бот.',
-    'msg.langSet': 'Язык переключён на русский.',
-    'cmd.help.title': 'Команды',
-    'cmd.help.hint': 'Любой текст — задача агенту. В теме форума: /cd <проект> привяжет тему к проекту.',
-    'cmd.cd.bound': 'Тема привязана к проекту:\n{path}\n\nДальше все команды идут отсюда.',
-    'cmd.cd.reset': 'Каталог темы сброшен на общий.',
-    'cmd.cd.none': 'Нет такого каталога: {path}',
-    'cmd.new.done': 'Новая сессия в этой ветке. Контекст очищен.',
-    'cmd.stop.killed': 'Ход остановлен.',
-    'cmd.stop.nothing': 'Нечего останавливать.',
-    'menu.status': 'Сессии, модель, активные ходы',
-    'menu.cd': 'Привязать тему к каталогу проекта',
-    'menu.send': 'Прислать файл из проекта в чат',
-    'menu.prices': 'Цены моделей у роутера',
-    'menu.stop': 'Остановить текущий ход',
-    'menu.new': 'Новая сессия в этой теме',
-    'menu.seed': 'Засеять пустую тему текстом и закрепить',
-    'menu.sessions': 'Последние сессии',
-    'menu.resume': 'Продолжить сессию по id',
-    'menu.models': 'Доступные модели',
-    'menu.model': 'Показать или сменить модель',
-    'menu.skills': 'Установленные скиллы',
-    'menu.soul': 'Персона агента',
-    'menu.plugins': 'Установленные плагины',
-    'menu.plugin': 'Включить или выключить плагин',
-    'menu.app': 'Управление десктоп-приложением',
-    'menu.restart': 'Перезапустить агента',
-    'menu.help': 'Все команды и подсказки',
-    'menu.lang': 'Язык интерфейса: en, ru, zh',
-  },
-  zh: {
-    'status.working': '处理中',
-    'status.done': '完成',
-    'status.failed': '运行失败',
-    'status.queued': '排队中',
-    'status.stop': '停止',
-    'status.cache': '缓存',
-    'status.steps': '步',
-    'status.thinking': '等待模型',
-    'err.timeout': '{min} 分钟无活动 — 已中断',
-    'err.generic': '出现错误',
-    'msg.started': 'DSH 的 Telegram 桥已启动（headless）。直接发送任务；/help 查看命令。',
-    'msg.unknownCommand': '未知命令：{cmd}。打开 /help 查看机器人支持的全部命令。',
-    'msg.langSet': '界面语言已切换为中文。',
-    'cmd.help.title': '命令',
-    'cmd.help.hint': '发送任意文本即可开始任务。在论坛话题中：/cd <项目> 将该话题绑定到项目目录。',
-    'cmd.cd.bound': '话题已绑定到项目：\n{path}\n\n之后所有操作都在此目录执行。',
-    'cmd.cd.reset': '话题目录已恢复为默认。',
-    'cmd.cd.none': '目录不存在：{path}',
-    'cmd.new.done': '已在本话题开始新会话，上下文已清空。',
-    'cmd.stop.killed': '已停止当前任务。',
-    'cmd.stop.nothing': '没有可停止的任务。',
-    'menu.status': '会话、模型、进行中的任务',
-    'menu.cd': '将本话题绑定到项目目录',
-    'menu.send': '把项目中的文件发送到聊天',
-    'menu.prices': '路由器的模型价格',
-    'menu.stop': '停止当前任务',
-    'menu.new': '在本话题开始新会话',
-    'menu.seed': '用文本初始化空话题并置顶',
-    'menu.sessions': '最近的会话',
-    'menu.resume': '按 id 继续会话',
-    'menu.models': '可用模型',
-    'menu.model': '查看或切换模型',
-    'menu.skills': '已安装的技能',
-    'menu.soul': '代理人格设定',
-    'menu.plugins': '已安装的插件',
-    'menu.plugin': '启用或停用插件',
-    'menu.app': '桌面应用控制',
-    'menu.restart': '重启代理',
-    'menu.help': '全部命令与提示',
-    'menu.lang': '界面语言：en、ru、zh',
-  },
-};
-
-/** Telegram sends zh-hans / zh-hans-cn / zh-CN; all of them mean the same locale. */
-export function normalizeLang(code) {
-  const raw = String(code || '').toLowerCase();
-  if (!raw) return '';
-  if (raw.startsWith('zh')) return 'zh';
-  if (raw.startsWith('en')) return 'en';
-  if (raw.startsWith('ru')) return 'ru';
-  return '';
-}
-
-export function t(lang, key, vars = {}) {
-  const table = DICT[lang] || DICT.ru;
-  const text = table[key] ?? DICT.ru[key] ?? key;
-  return String(text).replace(/\{(\w+)\}/g, (_, name) => (vars[name] ?? `{${name}}`));
-}
-
-/** Menu rows for setMyCommands, translated per locale. */
-export function menuFor(lang, commands) {
-  return commands.map((c) => ({ command: c.command, description: t(lang, `menu.${c.command}`) }));
-}
-
-/** Language for a message: topic choice, then config default, then Telegram. */
-export function resolveLang(state, key, msg, config = {}) {
-  const chosen = state?.lang?.[key] || config.lang;
-  // A foreign user must land in English, not Russian: Telegram reports the
-  // sender's own locale, and everything outside ru/zh/en falls back to en.
-  return normalizeLang(chosen) || normalizeLang(msg?.from?.language_code) || 'en';
-}
+// i18n — three locales for the user-visible surfaces.
+//
+// Scope: everything a person sees without asking for it — the Telegram command
+// menu, the live status message, turn errors and the everyday commands. Long
+// explanatory texts stay in the source language until they are translated
+// properly; a half-translated sentence is worse than a consistent one.
+//
+// Language resolution order: per-topic choice (/lang) -> config.lang -> the
+// sender's Telegram language_code -> 'ru'.
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+export const LANGS = ['en', 'ru', 'zh'];
+
+const DICT = {
+  en: {
+    'status.working': 'Working',
+    'status.done': 'Done',
+    'status.failed': 'Turn failed',
+    'status.queued': 'queued',
+    'status.stop': 'Stop',
+    'help.body': "Write the task as plain text. Each forum topic is its own session:\n\nWork: /cd \u003cproject\u003e · /new · /stop · /send \u003cfile\u003e · /seed \u003ctext\u003e\nSessions: /status · /sessions [n] · /resume \u003cid\u003e\nModels: /models · /model \u003cid\u003e · /prices\nExtensions: /skills · /plugins · /plugin add|remove · /soul\nOther: /lang · /doctor · /logs [errors|N] · /app · /restart · /help",
+    'btn.stop': 'Stop',
+    'btn.logs': 'Logs',
+    'btn.retry': 'Retry',
+    'btn.doctor': 'Doctor',
+    'status.cache': 'cache',
+    'status.steps': 'steps',
+    'status.thinking': 'waiting for the model',
+    'err.timeout': 'no activity for {min} min — turn interrupted',
+    'err.generic': 'something went wrong',
+    'msg.started': 'Telegram bridge for DSH is running (headless). Send a task; /help for commands.',
+    'msg.unknownCommand': 'Unknown command: {cmd}. Open /help — it lists everything this bot can do.',
+    'msg.langSet': 'Language set to English.',
+    'cmd.help.title': 'Commands',
+    'cmd.help.hint': 'Send any text to start a task. In a forum topic: /cd <project> binds the topic to that project.',
+    'cmd.cd.bound': 'Topic bound to project:\n{path}\n\nAll turns run from this directory.',
+    'cmd.cd.reset': 'Topic directory reset to the shared one.',
+    'cmd.cd.none': 'No such directory: {path}',
+    'cmd.new.done': 'New session in this topic. Context cleared.',
+    'cmd.stop.killed': 'Turn stopped.',
+    'cmd.stop.nothing': 'Nothing to stop.',
+    'menu.status': 'Sessions, model, active turns',
+    'menu.cd': 'Bind this topic to a project directory',
+    'menu.send': 'Send a file from the project into the chat',
+    'menu.prices': 'Model prices from the router',
+    'menu.stop': 'Stop the current turn',
+    'menu.new': 'New session in this topic',
+    'menu.seed': 'Seed an empty topic with text and pin it',
+    'menu.sessions': 'Recent sessions',
+    'menu.resume': 'Continue a session by id',
+    'menu.models': 'Available models',
+    'menu.model': 'Show or switch the model',
+    'menu.skills': 'Installed skills',
+    'menu.soul': 'Agent persona',
+    'menu.plugins': 'Installed plugins',
+    'menu.plugin': 'Enable or disable a plugin',
+    'menu.app': 'Desktop app control',
+    'menu.restart': 'Restart the agent',
+    'menu.help': 'All commands and hints',
+    'menu.lang': 'Interface language: en, ru, zh',
+  },
+  ru: {
+    'status.working': 'Работаю',
+    'status.done': 'Готово',
+    'status.failed': 'Ход не удался',
+    'status.queued': 'в очереди',
+    'status.stop': 'Стоп',
+    'help.body': "Задачу можно писать обычным текстом. Каждая ветка форума — отдельная сессия:\n\nРабота: /cd \u003cпроект\u003e · /new · /stop · /send \u003cфайл\u003e · /seed \u003cтекст\u003e\nСессии: /status · /sessions [n] · /resume \u003cid\u003e\nМодели: /models · /model \u003cid\u003e · /prices\nРасширения: /skills · /plugins · /plugin add|remove · /soul\nПрочее: /lang · /doctor · /logs [errors|N] · /app · /restart · /help",
+    'btn.stop': 'Стоп',
+    'btn.logs': 'Логи',
+    'btn.retry': 'Повторить',
+    'btn.doctor': 'Диагноз',
+    'status.cache': 'кэш',
+    'status.steps': 'шагов',
+    'status.thinking': 'жду модель',
+    'err.timeout': 'нет активности {min} мин — ход прерван',
+    'err.generic': 'что-то пошло не так',
+    'msg.started': 'Telegram-мост DSH запущен (headless). Пиши задачу; /help — команды.',
+    'msg.unknownCommand': 'Неизвестная команда: {cmd}. Открой /help — там всё, что умеет бот.',
+    'msg.langSet': 'Язык переключён на русский.',
+    'cmd.help.title': 'Команды',
+    'cmd.help.hint': 'Любой текст — задача агенту. В теме форума: /cd <проект> привяжет тему к проекту.',
+    'cmd.cd.bound': 'Тема привязана к проекту:\n{path}\n\nДальше все команды идут отсюда.',
+    'cmd.cd.reset': 'Каталог темы сброшен на общий.',
+    'cmd.cd.none': 'Нет такого каталога: {path}',
+    'cmd.new.done': 'Новая сессия в этой ветке. Контекст очищен.',
+    'cmd.stop.killed': 'Ход остановлен.',
+    'cmd.stop.nothing': 'Нечего останавливать.',
+    'menu.status': 'Сессии, модель, активные ходы',
+    'menu.cd': 'Привязать тему к каталогу проекта',
+    'menu.send': 'Прислать файл из проекта в чат',
+    'menu.prices': 'Цены моделей у роутера',
+    'menu.stop': 'Остановить текущий ход',
+    'menu.new': 'Новая сессия в этой теме',
+    'menu.seed': 'Засеять пустую тему текстом и закрепить',
+    'menu.sessions': 'Последние сессии',
+    'menu.resume': 'Продолжить сессию по id',
+    'menu.models': 'Доступные модели',
+    'menu.model': 'Показать или сменить модель',
+    'menu.skills': 'Установленные скиллы',
+    'menu.soul': 'Персона агента',
+    'menu.plugins': 'Установленные плагины',
+    'menu.plugin': 'Включить или выключить плагин',
+    'menu.app': 'Управление десктоп-приложением',
+    'menu.restart': 'Перезапустить агента',
+    'menu.help': 'Все команды и подсказки',
+    'menu.lang': 'Язык интерфейса: en, ru, zh',
+  },
+  zh: {
+    'status.working': '处理中',
+    'status.done': '完成',
+    'status.failed': '运行失败',
+    'status.queued': '排队中',
+    'status.stop': '停止',
+    'help.body': "任务直接以文本发送。每个论坛话题是一个独立会话：\n\n工作: /cd \u003c项目\u003e · /new · /stop · /send \u003c文件\u003e · /seed \u003c文本\u003e\n会话: /status · /sessions [n] · /resume \u003cid\u003e\n模型: /models · /model \u003cid\u003e · /prices\n扩展: /skills · /plugins · /plugin add|remove · /soul\n其他: /lang · /doctor · /logs [errors|N] · /app · /restart · /help",
+    'btn.stop': '停止',
+    'btn.logs': '日志',
+    'btn.retry': '重试',
+    'btn.doctor': '诊断',
+    'status.cache': '缓存',
+    'status.steps': '步',
+    'status.thinking': '等待模型',
+    'err.timeout': '{min} 分钟无活动 — 已中断',
+    'err.generic': '出现错误',
+    'msg.started': 'DSH 的 Telegram 桥已启动（headless）。直接发送任务；/help 查看命令。',
+    'msg.unknownCommand': '未知命令：{cmd}。打开 /help 查看机器人支持的全部命令。',
+    'msg.langSet': '界面语言已切换为中文。',
+    'cmd.help.title': '命令',
+    'cmd.help.hint': '发送任意文本即可开始任务。在论坛话题中：/cd <项目> 将该话题绑定到项目目录。',
+    'cmd.cd.bound': '话题已绑定到项目：\n{path}\n\n之后所有操作都在此目录执行。',
+    'cmd.cd.reset': '话题目录已恢复为默认。',
+    'cmd.cd.none': '目录不存在：{path}',
+    'cmd.new.done': '已在本话题开始新会话，上下文已清空。',
+    'cmd.stop.killed': '已停止当前任务。',
+    'cmd.stop.nothing': '没有可停止的任务。',
+    'menu.status': '会话、模型、进行中的任务',
+    'menu.cd': '将本话题绑定到项目目录',
+    'menu.send': '把项目中的文件发送到聊天',
+    'menu.prices': '路由器的模型价格',
+    'menu.stop': '停止当前任务',
+    'menu.new': '在本话题开始新会话',
+    'menu.seed': '用文本初始化空话题并置顶',
+    'menu.sessions': '最近的会话',
+    'menu.resume': '按 id 继续会话',
+    'menu.models': '可用模型',
+    'menu.model': '查看或切换模型',
+    'menu.skills': '已安装的技能',
+    'menu.soul': '代理人格设定',
+    'menu.plugins': '已安装的插件',
+    'menu.plugin': '启用或停用插件',
+    'menu.app': '桌面应用控制',
+    'menu.restart': '重启代理',
+    'menu.help': '全部命令与提示',
+    'menu.lang': '界面语言：en、ru、zh',
+  },
+};
+
+/** Telegram sends zh-hans / zh-hans-cn / zh-CN; all of them mean the same locale. */
+export function normalizeLang(code) {
+  const raw = String(code || '').toLowerCase();
+  if (!raw) return '';
+  if (raw.startsWith('zh')) return 'zh';
+  if (raw.startsWith('en')) return 'en';
+  if (raw.startsWith('ru')) return 'ru';
+  return '';
+}
+
+export function t(lang, key, vars = {}) {
+  const table = DICT[lang] || DICT.ru;
+  const text = table[key] ?? DICT.ru[key] ?? key;
+  return String(text).replace(/\{(\w+)\}/g, (_, name) => (vars[name] ?? `{${name}}`));
+}
+
+/** Menu rows for setMyCommands, translated per locale. */
+export function menuFor(lang, commands) {
+  return commands.map((c) => ({ command: c.command, description: t(lang, `menu.${c.command}`) }));
+}
+
+/** Language for a message: topic choice, then config default, then Telegram. */
+export function resolveLang(state, key, msg, config = {}) {
+  const chosen = state?.lang?.[key] || config.lang;
+  // A foreign user must land in English, not Russian: Telegram reports the
+  // sender's own locale, and everything outside ru/zh/en falls back to en.
+  return normalizeLang(chosen) || normalizeLang(msg?.from?.language_code) || 'en';
+}

package/package.json

@@ -1,51 +1,50 @@
 {
-  "name": "dsh-tg-bridge",
-  "version": "1.1.0",
-  "description": "Telegram bridge for DeepSeek Harness: text, voice, photos and project-per-topic sessions without opening the desktop app",
-  "type": "module",
-  "main": "bridge.mjs",
-  "bin": {
-    "dsh-tg": "./cli.mjs"
-  },
-  "files": [
-    "cli.mjs",
-    "i18n.mjs",
-    "bridge.mjs",
-    "setup.mjs",
-    "control.mjs",
-    "bridge-kick.mjs",
-    "bridge-restart-idle.mjs",
-    "restart-after-send.mjs",
-    "prices.mjs",
-    "bot-menu.mjs",
-    "transcribe.py",
-    "patches/",
-    "docs/",
-    "config.example.json",
-    "install.sh",
-    "install.ps1",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "start": "node bridge.mjs",
-    "setup": "node setup.mjs",
-    "check": "node setup.mjs --check",
-    "menu": "node bot-menu.mjs",
-    "doctor": "node bridge-kick.mjs"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "keywords": [
-    "deepseek-harness",
-    "dsh",
-    "telegram",
-    "bridge",
-    "bot",
-    "whisper",
-    "voice"
-  ],
-  "license": "MIT",
-  "dependencies": {}
-}
+    "name":  "dsh-tg-bridge",
+    "version":  "1.1.1",
+    "description":  "Telegram bridge for DeepSeek Harness: text, voice, photos and project-per-topic sessions without opening the desktop app",
+    "type":  "module",
+    "main":  "bridge.mjs",
+    "bin":  {
+                "dsh-tg":  "./cli.mjs"
+            },
+    "scripts":  {
+                    "start":  "node bridge.mjs",
+                    "setup":  "node setup.mjs",
+                    "check":  "node setup.mjs --check",
+                    "menu":  "node bot-menu.mjs",
+                    "doctor":  "node bridge-kick.mjs"
+                },
+    "engines":  {
+                    "node":  "\u003e=20"
+                },
+    "keywords":  [
+                     "deepseek-harness",
+                     "dsh",
+                     "telegram",
+                     "bridge",
+                     "bot",
+                     "whisper",
+                     "voice"
+                 ],
+    "license":  "MIT",
+    "dependencies":  {
+
+                     },
+    "files":  [
+                  "bridge.mjs",
+                  "control.mjs",
+                  "i18n.mjs",
+                  "prices.mjs",
+                  "setup.mjs",
+                  "bot-menu.mjs",
+                  "bridge-kick.mjs",
+                  "bridge-restart-idle.mjs",
+                  "restart-after-send.mjs",
+                  "transcribe.py",
+                  "cli.mjs",
+                  "README.md",
+                  "LICENSE",
+                  "config.example.json",
+                  "patches/"
+              ]
+}

package/docs/CHANGELOG.md

@@ -1,45 +0,0 @@
-# CHANGELOG — DSH Telegram bridge
-
-## 2026-10-24 — v1.1.0
-
-- **Три языка**: `i18n.mjs` (en/ru/zh), `t()`, нормализация `zh-hans → zh`.
-- **Меню на трёх языках**: `setMyCommands` для default/`en`/`zh` (Telegram не принимает `zh-hans`).
-- **`/lang en|ru|zh`**: язык хранится на тему; новый пользователь получает свой по `language_code`,
-  всё вне ru/zh → `en`.
-- **Локализованы**: стартовое сообщение, заголовки прогресса, ошибка хода, `/cd`, `/new`, `/stop`,
-  ответ на неизвестную команду.
-- **Неизвестная команда больше не запускает модель** — отвечает подсказкой.
-- **Сторож**: пауза 25 с и повторная проверка pid перед тревогой; `requireDesktop: false`,
-  алерт говорит про мост, а не про десктоп-приложение.
-- Исправлен импорт i18n в `bridge.mjs` (был `resolveLang is not defined` и застрявшее сообщение).
-
-## 2026-10-23
-
-- **Таймауты переработаны**: убран жёсткий потолок (`turnTimeoutMs: 0`), тишина больше не
-  убивает ход; любой байт stdout/stderr продлевает окно; при молчании раз в 2 минуты
-  обновляется статус (heartbeat), чтобы счётчик времени не замирал.
-- **Fallback-цепочка расширена до 7 моделей**: taynik opus-5-5, unorouter glm-5.3-flash:free,
-  neuraldeep qwen3.6-35b-a3b, ikhdev free-mimo, unorouter deepseek-v4.1-flash:free,
-  taynik opus-4-7, taynik sonnet-4-7.
-- **Триггеры переключения**: добавлены `AUTH`, `403`, `insufficient_user_quota`, `UNKNOWN_MODEL`,
-  `MISSING_CREDENTIAL`; сообщение в чат: «баланс основной модели исчерпан — работаю на X (free)».
-- **Провайдеры**: в профиль headless добавлены `taynik`, `neuraldeep`, `ikhdev`;
-  ключи в `.credentials.yaml` и проброшены в env дочернего процесса CLI.
-- **Субагенты**: `agentOptions` → `unorouter/deepseek-v4.1-flash`.
-- **Команды**: диспетчер берёт единый список `CONTROL_COMMANDS` (был жёсткий whitelist без `/cd`,
-  `/prices`, `/seed` — они уходили в ИИ как текст).
-- **Lock**: `restart.lock` не даёт setup и кику стартовать одновременно (причина двух поллеров и 409).
-- **Сессии**: при ответе «was recorded in … not …» мост сбрасывает сессию и начинает новую.
-- **Документация**: STATE.md, CHANGELOG.md, UX-ANALYSIS.md, обновлён ROADMAP.md.
-
-## 2026-10-22
-
-- Журнал ходов `pending/` + ack после отправки + реплей при старте (фикстура переиграна один раз).
-- Двухфазный рестарт: `restart.pending` → exit(75) → супервизор; минутный `DSH-Bridge-Kick`.
-- `/cd` — привязка темы к проекту; `setup.mjs` ищет мосты по pid-файлу (у elevated-процесса пустой cmdline).
-- Файлы: `/send` (sendDocument) и приём документов в `inbox/`.
-- IPv4 принудительно (`dns` + `net`), backoff поллинга, коды `TG_NET`/`TG_POLL`.
-- Песочница: `workspace-write` + явный пресет `permission` (id сервиса — `permission`, не `permission-presets`).
-- Прогресс: одно статус-сообщение, шаги, кэш в финале.
-- Vision: gemini объявлен с `input: [text, image]`; канарейка «red, 42».
-- Бэкап конфигов и проектов в приватные репозитории GitHub (`agent-config`, 7 проектов).

package/docs/RELEASE-CRITERIA.md

@@ -1,23 +0,0 @@
-# Критерии приёмки публичного релиза
-
-Дата: 24.10.2026. Репозиторий: `dsh-tg-bridge-oss`.
-Проверка — команда или факт, а не намерение.
-
-## R. Готовность к публикации
-
-| # | Критерий | Проверка |
-|---|---|---|
-| R1 | README объясняет, что это, зачем, и подключает с нуля за ≤5 шагов | чтение + прогон шагов на чистой копии |
-| R2 | `config.example.json` без личных данных: без chat id, без путей пользователя | `grep -E "[0-9]{7,}" config.example.json` пусто |
-| R3 | Есть `LICENSE` (MIT) с именем владельца | файл существует, 20+ строк |
-| R4 | `package.json`: имя, версия, описание, scripts (`setup`, `check`, `menu`) | `node -e "require('./package.json')"` |
-| R5 | Документация в `docs/`: STATE, CHANGELOG, ROADMAP, ACCEPTANCE, UX-ANALYSIS | 5 файлов, лишних дублей нет |
-| R6 | Нет секретов и личных id в индексе git | `git ls-files` + grep по токенам/путям |
-| R7 | `git status` чист, есть коммит релиза с тегом версии | `git log --oneline -1`, `git status --short` |
-| R8 | `node setup.mjs --check` не падает на свежем клоне | exit code 0 |
-| R9 | Все runtime-файлы на месте и проходят `node --check` | 5 файлов, синтаксис 0 |
-
-## Что считается «готово»
-
-Релиз считается готовым, когда R1–R9 пройдены **все**, а в README есть раздел
-«Проверка» с командами, которые пользователь может выполнить сам.

package/docs/ROADMAP.md

@@ -1,51 +0,0 @@
-# DSH ↔ Telegram: дорожная карта
-
-Обновлено: 23.10.2026. Источник истины по состоянию — `STATE.md`, история — `CHANGELOG.md`,
-UX-разбор — `UX-ANALYSIS.md`, задание агенту DSH — `DSH-ROADMAP-HANDOFF.md`.
-
-## Сделано (22–23.10)
-
-- Журнал ходов + ack + реплей; двухфазный рестарт; минутный супервизор; лок setup/kick.
-- Один поллер; pid-файл; поиск процессов по pid, а не по пустому cmdline elevated-процесса.
-- 18 команд с единым списком; `/cd` (проект на тему), `/prices`, `/send`, `/sessions`, `/model`.
-- Файлы в обе стороны; входящие документы в `inbox/`.
-- Песочница `workspace-write` + явный пресет; проверено: `C:\Windows` закрыт, проект открыт.
-- Прогресс: одно статус-сообщение, шаги, текст модели, кэш; heartbeat каждые 2 мин.
-- Таймауты: жёсткого потолка нет, тишина не убивает ход.
-- Сеть: IPv4 принудительно, backoff поллинга, коды ошибок.
-- Fallback: 7 моделей; провайдеры taynik/neuraldeep/ikhdev; сообщение «баланс исчерпан — работаю на X (free)».
-- Субагенты: `agentOptions` → unorouter/deepseek-v4.1-flash.
-
-## P0 — следующие (стабильность и контроль)
-
-| # | Задача | Приёмка |
-|---|---|---|
-| 1 | `/doctor` + `/logs <код>` | одна команда: PASS/FAIL по pid, getMe, 409, песочнице, модели, диску |
-| 2 | Fail-fast на 403/quota | при исчерпанном балансе переключение сразу, без 20-минутного хода |
-| 3 | Неизвестная команда → меню | `/abc` не запускает модель и не тратит деньги |
-| 4 | Approvals кнопками | удаление внутри проекта ждёт «Разрешить/Запретить»; отказ = fail-closed |
-| 5 | Кнопки «Стоп»/«Повторить» | нажатие останавливает ход; «Повторить» перезапускает тот же промпт |
-
-## P1 — паритет с UI
-
-6. Стриминг ответа правками сообщения (троттлинг 1.5–2 с).
-7. Итог хода: время, шаги, токены, кэш, стоимость, модель (включая free-переключение).
-8. Очередь с «Отменить»; `/compact`, `/retry`, `/cost`, `/find`, `/rename`.
-9. Worktree: обёртка `git worktree add .worktrees/<name>`, diff в чат.
-10. Health-probe моделей раз в час → `models-health.json`, предупреждение при деградации.
-11. Авто-артефакты: ход создал файл → кнопка «прислать».
-
-## P2 — продукт и open source
-
-12. Конфиг вместо хардкода (user id, пути, язык, лимиты).
-13. Установщики: Windows (schtasks+VBS), macOS (launchd), Linux (systemd --user).
-14. i18n `en`/`ru`, `/lang`.
-15. JSONL-логи со стабильными кодами и hint.
-16. Публичный репозиторий: README EN, MIT, CI на трёх ОС, скриншоты.
-
-## Риски
-
-- Внутренний API DSH — не публичный контракт → версия-гейт и CLI-fallback.
-- Approvals без answerer'а = fail-closed: плагин ставится вместе с мостом.
-- Free-провайдеры нестабильны (503 capacity) → нужна цепочка, а не одна модель.
-- `create_worktree` на этой машине не работает до фикса PATH.

package/docs/STATE.md

@@ -1,64 +0,0 @@
-# STATE — DSH Telegram bridge
-
-Обновлено: 23.10.2026. Формат: что работает → что сломано → что дальше.
-Проверять состояние: `node setup.mjs` (он же пишет `setup.log`), затем `tail bridge.log`.
-
-## Работает (проверено на живой системе)
-
-- **Один поллер**: pid-файл + liveness; минутный супервизор `DSH-Bridge-Kick` (schtasks, код 0);
-  лок `restart.lock` — setup и кик не стартуют одновременно.
-- **Журнал ходов**: `pending/<update_id>.json` (temp+fsync+rename) → offset → ход → отправка → ack;
-  реплей при старте; дедуп по `update_id`, `done.json` с TTL.
-- **Двухфазный рестарт**: `restart.pending` → exit(75) → супервизор поднимает.
-- **Команды**: 18, единый список `CONTROL_COMMANDS`; `/cd`, `/prices`, `/send`, `/sessions`, `/model`.
-- **Проект на тему**: `/cd <проект>` → cwd темы; песочница `workspace-write` режет всё вне каталога.
-- **Файлы**: `/send <путь>` (sendDocument), входящие документы → `inbox/`, путь уходит в ход.
-- **Прогресс**: одно статус-сообщение на ход, правится; шаги, текст модели, счётчик времени,
-  кэш в финале; heartbeat каждые 2 минуты при молчании.
-- **Таймауты**: жёсткого потолка нет (`turnTimeoutMs: 0`); тишина не убивает ход.
-- **Сеть**: IPv4 принудительно, backoff поллинга 5→30 с, коды `TG_NET`/`TG_POLL`.
-- **Модели**: основная unorouter deepseek-v4.1-flash-1017; fallback-цепочка из 7 моделей,
-  первая рабочая free — `taynik/`; при 403/квоте в чат уходит «баланс исчерпан — работаю на X (free)».
-- **Субагенты**: `agentOptions` → unorouter/deepseek-v4.1-flash.
-- **Вижн**: gemini через `--patch vision.yml`; read_image работает (канарейка «red, 42»).
-
-## Известные проблемы
-
-1. **Нет инлайн-кнопок** (`reply_markup`/`callback_query` отсутствуют): «Стоп», «Повторить»,
-   «Прислать файл», approvals — только текстом.
-2. **Нет approvals**: политика `never`, удаление внутри проекта проходит без подтверждения.
-3. **Неизвестная `/команда`** уходит в ИИ-ход (тратит деньги) вместо подсказки.
-4. **Нет `/doctor`** — диагноз собирается вручную.
-5. **`create_worktree` падает** `0xC0000135` (git не виден процессу); ручной `git worktree add` работает.
-6. **Баланс unorouter** близок к нулю; free-провайдеры частично нестабильны (503 capacity).
-7. **Ответ не стримится**: промежуточный текст виден только строкой в статусе.
-8. **opencode_zen** без ключа; DeepSeek-ключ в credentials невалиден (401).
-
-## Следующие доработки
-
-**P0 (стабильность и контроль)**
-1. `/doctor` + `/logs <код>`: pid, getMe, свежие 409, режим песочницы, модель, диск.
-2. Fail-fast: 403/quota ловить сразу (до долгого хода), а не после 20 минут.
-3. Неизвестная команда → меню, без запуска модели.
-4. Approvals кнопками через `dsh-user-approval` (answerer → inline keyboard).
-5. Инлайн-кнопки: «Стоп» под статусом, «Повторить» под ошибкой.
-
-**P1 (паритет с UI)**
-6. Стриминг ответа правками сообщения (троттлинг 1.5–2 с).
-7. Итог хода: время, шаги, токены, кэш, стоимость, модель (включая free-переключение).
-8. Очередь с кнопкой «Отменить»; `/compact`, `/retry`, `/cost`, `/find`, `/rename`.
-9. Worktree: обёртка `git worktree add .worktrees/<name>` + diff в чат.
-10. Периодический health-probe моделей (раз в час) с записью в `models-health.json`.
-
-**P2 (продукт)**
-11. Конфиг вместо хардкода, установщики Windows/macOS/Linux, i18n en/ru.
-12. JSONL-логи со стабильными кодами и hint; публичный репозиторий (README EN, MIT, CI).
-
-## Как проверить
-
-```
-node setup.mjs                     # старт/рестарт + самодиагностика
-node test-control.mjs              # /cd привязывает каталог
-node bridge-kick.mjs               # супервизор: поднимает мост, если pid мёртв
-tail -n 50 bridge.log              # ходы, ошибки, переключения моделей
-```

package/docs/UX-ANALYSIS.md

@@ -1,62 +0,0 @@
-# UX-анализ Telegram-моста DSH (без внедрения)
-
-Дата: 23.10.2026. Основано на живом коде `~/.dsh/tg-bridge` и ответах Bot API.
-
-## 1. Факты
-
-- Команды **зарегистрированы**: `getMyCommands` в default scope отдаёт 18 штук
-  (`new cd status stop prices send seed sessions resume models model skills soul plugins plugin app restart help`).
-  Отдельных scope для чата/групп нет — работает default, этого достаточно.
-- В коде 18 обработчиков; неизвестная `/команда` **не даёт подсказку**, а уходит в ИИ как обычный текст.
-- Инлайн-кнопок нет вообще: `reply_markup` — 0 вхождений, `callback_query` — 0. Значит нет
-  «Стоп» кнопкой, «Повторить», «Прислать файл», подтверждений.
-- Статус-сообщение есть: создаётся на ход, правится (инструменты, текст, счётчик времени, кэш в финале).
-- Typing-индикатор есть (обновляется каждые 4.5 с).
-- Ответ приходит целиком в конце: промежуточный текст модели виден только строкой `• текст: …` в статусе.
-
-## 2. Что из Hermes стоит перенести (по убыванию пользы)
-
-### P0 — ощутимо меняет работу
-1. **Инлайн-кнопки + callback.** «Стоп» под статусом, «Повторить» под ошибкой,
-   «Прислать файл» после хода, «Разрешить / Запретить / Всегда» для approvals.
-   Сейчас всё это только текстом.
-2. **Неизвестная команда — не ход.** Сейчас `/fuck` запускает модель. Должно быть:
-   «Нет такой команды» + меню. Это ещё и экономит деньги.
-3. **`/doctor` и `/logs <код>`.** Диагноз одной командой: pid, getMe, 409, песочница, модель, диск.
-   Без этого каждый сбой превращается в переписку.
-4. **Стриминг ответа.** Редактировать одно сообщение по мере генерации (троттлинг 1.5-2 с),
-   а не отдавать готовый блок через 4 минуты. Telegram позволяет ~20 правок в минуту на чат.
-
-### P1 — комфорт
-5. **Очередь с кнопкой «Отменить»**: «в очереди (2), отменить» вместо молчания.
-6. **Итог хода**: время, шаги, токены, кэш %, стоимость. Сейчас есть только кэш.
-7. **Авто-артефакты**: если ход создал файлы — кнопки «прислать».
-8. **Команды, которых не хватает**: `/compact`, `/retry`, `/cost`, `/find <текст>` по сессиям,
-   `/rename` темы, `/pin`.
-9. **`/help` по группам**: «работа», «сессии», «модели», «диагностика» — 18 строк подряд читать тяжело.
-10. **Ошибки с кодом и hint**: `SANDBOX_DENY`, `DSH_SPAWN_FAIL`, `TG_CONFLICT`, `SESSION_CWD`.
-
-### P2 — полировка
-11. Голосовые ответы (TTS) опционально — для длинных объяснений.
-12. `/stats`: сколько ходов, средняя длительность, доля ошибок за неделю.
-13. Настройка «показывать текст модели» / «только инструменты» — кому-то шумно.
-14. Автопереименование темы по первой задаче (как в Hermes), с подтверждением.
-
-## 3. Ограничения Telegram, которые нельзя обойти
-
-- 4096 символов на сообщение → уже режется на части; правки статуса должны оставаться в одном сообщении.
-- ~20 правок в минуту на чат → троттлинг обязателен (сейчас 3.5 с — можно 1.5-2 с).
-- Инлайн-клавиатура: до 64 кнопок, но на телефоне читаемо максимум 4-6.
-- В группах команды работают, но меню показывается по default scope; отдельные scope не нужны.
-
-## 4. Что уже хорошо и трогать не надо
-
-- Журнал + ack + реплей; двухфазный рестарт; лок setup/kick; один поллер.
-- Статус-сообщение с шагами и кэшем; typing; IPv4-фикс; HTML-код с копированием.
-- `/cd` на проект + песочница, `/send` и приём документов, `/prices`.
-
-## 5. Вывод
-
-Разрыв с Hermes не в командах (они есть), а в **интерактиве**: нет кнопок и callback,
-нет стриминга ответа, неизвестные команды уходят в модель, нет диагностики.
-Четыре пункта P0 закрывают 80% ощущения «работает как Hermes».

package/docs/archive/DSH-ROADMAP-HANDOFF.md

@@ -1,120 +0,0 @@
-# DSH ↔ Telegram: план доработки для агента DSH
-
-Автор: Hermes. Дата: 22.10.2026. Файл лежит на той же машине, что и мост:
-`C:\Users\bistr\Projects\dsh-tg-bridge-oss\DSH-ROADMAP-HANDOFF.md`
-
-Задача: довести мост до уровня, на котором владелец работает через Telegram так же
-полноценно, как в UI Hermes, и при этом использует максимум возможностей DSH.
-
-> **Обновление 23.10.2026 — уже сделано, не переделывать:** жёсткий таймаут убран
-> (`turnTimeoutMs: 0`), тишина не убивает ход, heartbeat раз в 2 минуты; fallback-цепочка
-> из 7 моделей (taynik/neuraldeep/ikhdev/unorouter free) с сообщением «баланс исчерпан —
-> работаю на X (free)»; триггеры переключения включают AUTH/403/quota; субагенты на
-> `unorouter/deepseek-v4.1-flash`; единый `CONTROL_COMMANDS`; `restart.lock`.
-> Актуальный статус — `STATE.md`, история — `CHANGELOG.md`.
-
-## 0. Проверенное состояние на момент передачи
-
-- Мост: один процесс, pid в `C:\Users\bistr\.dsh\tg-bridge\bridge.pid`; минутный супервизор
-  `DSH-Bridge-Kick` (schtasks, LastTaskResult 0); лок `restart.lock` защищает от гонки setup/kick.
-- Журнал ходов: `pending/<update_id>.json` → сдвиг offset → ход → отправка → ack; реплей при старте.
-- Команды: 18, список в `control.mjs` → `CONTROL_COMMANDS` (мост импортирует его, не дублирует).
-- `/cd <проект>` привязывает тему к каталогу; песочница `workspace-write` ограничивает записи
-  этим каталогом (проверено: `C:\Windows` запрещён, проект разрешён).
-- Файлы: `/send <путь>` работает; входящие документы сохраняются в `inbox/` и передаются ходу.
-- Сеть: IPv4 принудительно, backoff поллинга 5→30 с, коды `TG_NET` / `TG_POLL`.
-- Модели: deepseek-v4.1-flash-1017; вижн через gemini; кэш 99,3% при продолжении сессии.
-- Профиль headless: `sandbox-policy` = workspace-write, `approval` = never, сервис пресетов
-  `permission` с таблицей пресетов и `defaultPreset: workspace-write`.
-
-## 1. Правила работы (не нарушать)
-
-1. Не перезапускать мост изнутри хода: процесс — родитель CLI. Только `restart.pending` → exit(75).
-2. Любой рестарт — через `node setup.mjs` (он берёт `restart.lock`); руками не убивать.
-3. После правки — `node --check` каждого изменённого файла и проверка чтением назад.
-4. Секреты не логировать; токен только из `.credentials.yaml`.
-5. Изменения в профиле DSH — с бэкапом `cordis.patch.yml.bak-<дата>`.
-6. Перед «готово» — измеримый тест, а не «должно работать».
-
-## 2. P0 — стабильность и контроль
-
-### 2.1 Живой прогресс + кнопка «Стоп»
-Файлы: `bridge.mjs` (`runTurnLive`, `onEvent`), спека `PROGRESS.md` рядом.
-Сделать:
-- одно сообщение на ход; первый `status`/`tool_call` создаёт его, дальше `editMessageText`;
-- троттлинг 1.5-2 с, игнор `400 message is not modified`, `retry_after` на 429;
-- шапка: `Работаю · 0:42 · шаг 3/7`, последние 3-5 инструментов, после 5 с тишины «жду модель»;
-- финал заменяет статус ответом (сохраняется HTML-код);
-- inline-кнопка «Стоп» → существующий `stopTurn(key)`;
-- на старте моста незавершённые статусы помечать `[!] прервано`.
-Приёмка: ход из 5 инструментов = 1 сообщение + 1 финальная правка; «Стоп» реально убивает ход.
-
-### 2.2 Подтверждения опасных действий
-На чём: `@deepseek-ai/dsh-user-approval` (политика `ask`, answerer'ы — waterfall-слушатели
-`approval/request`; без answerer'а действие fail-closed).
-Сделать:
-- локальный плагин-answerer, который на `approval/request` отправляет в тему сообщение с
-  inline-кнопками «Разрешить / Запретить / Всегда» и ждёт ответ (таймаут → deny);
-- переключить профиль `headless` на `approval: ask`, добавить пару в таблицу `permission`
-  (`workspace-write` + `ask`) и `defaultPreset`;
-- «Всегда» — только для текущей сессии.
-Приёмка: попытка удалить каталог внутри проекта останавливает ход и ждёт кнопку;
-«Запретить» → инструмент получает отказ; «Разрешить» → выполняется.
-
-### 2.3 `dsh-tg doctor`
-Файл: `scripts/doctor.mjs`, запуск `node scripts/doctor.mjs`.
-Проверки: один процесс и pid-файл, `getMe`, свежие 409 за 90 с, режим песочницы, доступность
-профиля, модель и её input, диск, права на задачу планировщика, версия DSH.
-Выход: PASS/FAIL по пунктам + код возврата 1 при любом FAIL.
-Приёмка: при убитом мосте doctor говорит `FAIL pid`, при двух поллерах — `FAIL 409`.
-
-### 2.4 Сессии при смене каталога
-Уже сделано: при ответе «was recorded in ... not ...» мост удаляет сессию и начинает новую.
-Проверить: `/cd` в теме, где уже был ход → следующий ход новый `session-id`, ошибки нет.
-
-### 2.5 Worktree
-Симптом: `create_worktree` падает `0xC0000135` (не находит бинарник; git не виден процессу).
-Сделать: либо пробросить PATH к `git.exe` в env дочернего процесса, либо обёртку в мосте:
-`git worktree add .worktrees/<name> -b <name>` внутри каталога проекта.
-Приёмка: ветка создана, `git worktree list` её показывает, файлы пишутся только в неё.
-
-## 3. P1 — паритет с UI
-
-1. **API-транспорт**: `@deepseek-ai/dsh-api-gateway` (`/api/remote.mux`, клиент `lib/client.node.js`)
-   вместо спавна CLI — поток событий, вложения, approvals без парсинга stdout. CLI оставить fallback.
-2. **Сессии**: `/sessions` с токенами, кэшем и стоимостью хода; `/resume`, переименование,
-   поиск (`dsh-session-query`).
-3. **Jobs**: `/job` — расписание через `dsh-schedule`, результат в тему.
-4. **Plan mode**: `/plan`, отрисовка плана и подтверждение.
-5. **Субагенты**: `/agents` — список, статус, стоп.
-6. **Артефакты**: агент создал файл → кнопка «прислать» (лимит 50 МБ).
-7. **Сжатие**: показывать, когда сработала компакция (кэш падает — владелец должен понимать почему).
-
-## 4. P2 — продукт и open source
-
-1. Конфиг вместо хардкода: user id, путь к DSH, язык, лимиты.
-2. Установщики: Windows (schtasks + VBS), macOS (launchd), Linux (systemd --user).
-3. i18n `en`/`ru` (`/lang`, автоопределение по `language_code`).
-4. Логи JSONL + стабильные коды (`TG_CONFLICT`, `DSH_SPAWN_FAIL`, `SANDBOX_DENY`,
-   `ATTACH_MISSING`, `SESSION_CWD`) + поле `hint`.
-5. Публичный репозиторий: README EN, MIT, CI на трёх ОС, скриншоты.
-6. Опциональный плагин-обёртка (approvals + прогресс) с версия-гейтом.
-
-## 5. Грабли, уже стоившие времени (не повторять)
-
-- Сервис пресетов имеет id **`permission`**, а не `permission-presets`; таблицу пресетов нужно
-  объявлять целиком, иначе `match no preset` и каждый ход падает за 5 с.
-- Сессия DSH привязана к каталогу: смена cwd ломает resume (мост теперь сбрасывает сессию).
-- Диспетчер команд брал жёсткий список; новые команды молча уходили в ИИ. Теперь `CONTROL_COMMANDS`.
-- Задача планировщика под `RunLevel Highest` не убивается `taskkill` (access denied) — только
-  `Stop-ScheduledTask`.
-- У elevated-процесса `Win32_Process.CommandLine` пустой: искать мосты по pid-файлу, не по cmdline.
-- `setup` и кик, стартовавшие одновременно, дают двух поллеров и вечный 409 — лок обязателен.
-- `fetch` выбирает IPv6 и висит: `dns.setDefaultResultOrder('ipv4first')` +
-  `net.setDefaultAutoSelectFamily(false)`.
-- Правка `.ps1`/`.vbs` под Windows: CRLF, ASCII, иначе PowerShell 5.1 ломается на кириллице.
-
-## 6. Порядок выполнения
-
-P0.1 → P0.2 → P0.3 → P0.4 → P0.5, затем P1 по списку. После каждого пункта — приёмка из
-описания, запись в `STATE.md` моста (создать, если нет) и короткий отчёт владельцу в Telegram.

package/docs/archive/PLAN.md

@@ -1,119 +0,0 @@
-# DSH ↔ Telegram Bridge — план упаковки в open-source (v2)
-
-Дата: 22.10.2026. Автор: Hermes. Основание: запрос Aleks (голос, 22.10) + фактический аудит
-текущего моста `C:\Users\bistr\.dsh\tg-bridge` и 296 пакетов DSH из `app.asar`.
-
-## 1. Цель
-
-Публичный репозиторий, который ставится одной командой на Windows/macOS/Linux и даёт
-пользователю DSH полноценный Telegram-интерфейс: текст, голос, фото, файлы, кнопки
-подтверждений, вопросы агента, планы, задачи по расписанию, субагенты — с логами, по которым
-любой агент (DSH, Hermes, Codex, Claude Code) сам находит причину сбоя.
-
-## 2. Что есть сейчас (факты)
-
-- `bridge.mjs` (1144 строки): long-polling getUpdates → спавн `dsh --profile headless --json` на
-  каждое сообщение → один сеанс DSH на чат/тему.
-- Работает: текст, голос (faster-whisper small, локально), фото (gemini через vision-патч),
-  темы форума, меню 15 команд, журнал `pending/` + ack, двухфазный рестарт, минутный кик.
-- Ограничения спавна CLI: нет канала вложений (`--help`: только task/--json/--session-id), нет
-  стриминга в реальном времени, нет approvals/ask-user (интерактив недоступен), стоимость —
-  старт Electron-процесса на каждое сообщение (~2-3 с), 30-минутный потолок хода.
-
-## 3. Целевая архитектура v2: клиент API, а не спавн CLI
-
-В DSH есть `@deepseek-ai/dsh-api-gateway` с типизированным клиентом
-(`lib/client.node.js`) и мультиплексом `/api/remote.mux`, плюс контроллеры
-`dsh-api-session-controller`, `dsh-api-job-controller`, `dsh-api-workspace-controller`,
-`dsh-api-remote-access`. Это тот же канал, которым пользуется штатный web-UI.
-
-Даёт бесплатно:
-- поток событий сессии (status/tool_call/tool_result/text) без парсинга stdout;
-- approvals и `ask_user` как запросы к клиенту → кнопки Telegram;
-- загрузку/выгрузку вложений (файлы, изображения) нативно;
-- список сессий, переименование, поиск, сжатие;
-- jobs/schedule — расписания живут в DSH, а не в крон-задачах ОС;
-- стабильные коды ошибок (`remote-error-codes`) вместо «fetch failed».
-
-План: два транспорта за одним интерфейсом.
-- `transport=api` (по умолчанию, если DSH ≥ 0.2.1 и API включён);
-- `transport=cli` (fallback, текущий код) — для старых сборок и аварийного режима.
-
-Это снимает большинство пунктов «90% UI» без изобретения протокола.
-
-## 4. Кроссплатформенность
-
-| Слой | Windows | macOS | Linux |
-|---|---|---|---|
-| Автозапуск | Task Scheduler (S4U, hidden VBS) | launchd plist `~/Library/LaunchAgents` | systemd --user unit |
-| Супервизор 1 мин | задача `*-Kick` | `StartInterval 60` | `Restart=always` + timer |
-| Скрытый запуск | `wscript` wrapper | нет окон | нет окон |
-| Пид/синглтон | pid-файл + liveness (EPERM=жив) | то же | то же |
-
-Установщик `npx dsh-tg setup` определяет ОС, ставит нужный юнит, проверяет права и пишет,
-что именно сделал (каждый шаг в `setup.log`).
-
-## 5. Упаковка и i18n
-
-- npm-пакет `dsh-telegram-bridge`, bin `dsh-tg` (`setup`, `run`, `doctor`, `logs`, `restart`).
-- Опционально плагин DSH (`dsh plugin add`), если API-режим: тогда мост — это headless-профиль
-  с плагином, без отдельного демона.
-- Языки: `en` (по умолчанию) + `ru`; строки в `locales/<lang>.json`, выбор командой `/lang`,
-  автоопределение из Telegram `language_code`. В DSH уже есть `dsh-client-locale` — можно
-  переиспользовать формат.
-
-## 6. Логи и диагностика (главное требование Aleks)
-
-- Единый JSONL-лог: `ts, level, code, session, chat, tool, ms, msg` + человекочитаемая строка.
-- Каждая ошибка = стабильный `code` (`TG_CONFLICT`, `DSH_SPAWN_FAIL`, `DSH_TIMEOUT`,
-  `NET_IPV6`, `ATTACH_MISSING`, `PID_STALE`, `JOURNAL_CORRUPT`) и поле `hint` с готовым
-  действием. Агент читает код и действует без археологии.
-- `dsh-tg doctor` — самодиагностика: один поллер, pid-файл, getMe, свежие 409, диск, права,
-  версия DSH, доступность профиля, наличие vision-модели. Выход: PASS/FAIL по каждому пункту.
-- Секреты: токен и ключи только из credentials/env; в логах — `[REDACTED]`, тест на это в CI.
-- Ротация: 5 МБ × 3 файла, без потери последних строк при падении.
-
-## 7. Матрица паритета с UI (что закрываем в v2)
-
-| Возможность UI | Telegram | Как |
-|---|---|---|
-| Текст, стриминг шагов | ✅ | заголовок сообщения + editInPlace (throttle 1.5-2 с) |
-| Фото/файлы на вход | ✅ | upload → attachment service |
-| Файлы на выход | ✅ | deliverables → sendDocument |
-| Голос | ✅ | локальный whisper (уже есть), опционально STT-плагин DSH |
-| Approvals | ✅ | inline-клавиатура Да/Нет/Всегда, таймаут = deny |
-| ask_user (вопросы агента) | ✅ | inline-кнопки + свободный текст |
-| Plan mode | ✅ | `/plan` + отрисовка плана и подтверждение |
-| Todo/прогресс | ✅ | одно редактируемое сообщение |
-| Список сессий | ✅ | `/chats` → inline-пагинация |
-| MCP/скиллы | ✅ | наследуются профилем, без изменений |
-| Терминал | ⚠️ | вывод построчно, интерактив — только через `/exec` |
-| Субагенты | ⚠️ | события + `/agents`, без отдельного чата на каждого |
-| Jobs/расписания | ✅ | нативно из DSH + уведомление в чат |
-| Плагин-маркет | ❌ | вне Telegram, ссылка на UI |
-| Редактор файлов | ❌ | заменяется файлами и `/download` |
-
-## 8. Этапы
-
-1. **Каркас пакета** (1-2 дня): структура репо, конфиг, i18n, `doctor`, JSONL-логи, CI на трёх ОС,
-   перенос текущего CLI-транспорта как `transport=cli`.
-2. **API-транспорт** (2-4 дня): спайк на `client.node.js` → события сессии, затем approvals и
-   ask_user кнопками; переключатель транспорта.
-3. **Вложения и файлы** (1-2 дня): вход/выход, лимиты 50 МБ, превью.
-4. **Супервизор и установка** (1-2 дня): три юнита, идемпотентный `setup`, `restart.pending`.
-5. **Наблюдаемость** (1 день): коды ошибок + hints, `dsh-tg logs --grep`, экспорт сессии.
-6. **Публикация**: README (EN), скриншоты, гайд «поставить за 5 минут», CONTRIBUTING, MIT.
-
-## 9. Риски
-
-- API DSH не документирован как публичный контракт → версия-гейт и fallback на CLI обязательны.
-- Разные ОС-супервизоры → CI-матрица, ручной чек-лист на macOS (нет машины под рукой).
-- Утечка токена в логах → тест на редактирование в CI.
-- Windows: окна консолей → только VBS/скрытые обёртки, проверка «нет чёрных окон» в приёмке.
-
-## 10. Открытые вопросы (к Aleks)
-
-1. Транспорт v2: API gateway сразу или сначала CLI-пакет, API — вторым релизом?
-2. Формат поставки: npm + `npx setup`, плагин DSH, или и то и другое?
-3. Языки: en+ru достаточно для первого релиза?
-4. Приоритет после базовой упаковки: approvals/ask-user, jobs, или файлы/делвераблы?

package/docs/archive/PROGRESS.md

@@ -1,94 +0,0 @@
-# Живой прогресс в Telegram — спецификация для tg-bridge
-
-Цель: один редактируемый статус-блок на ход, как в Hermes, вместо сообщений на каждое событие.
-
-## 1. Модель
-
-- На первом событии хода мост создаёт статус-сообщение и запоминает `message_id` по ключу
-  `chat:thread:turn`.
-- Все последующие события **редактируют** это сообщение (`editMessageText`), не создают новые.
-- Финальный ответ: статус редактируется в готовый текст ответа (сохраняется «копировать» у кода),
-  либо удаляется и ответ уходит отдельным сообщением — выбрать одно и не смешивать.
-- Ошибка хода: статус редактируется в `⚠️ <code>: <короткий смысл>` + строка `hint`.
-
-## 2. Что показывать
-
-```
-🟡 Работаю · 0:42 · шаг 3/7
-▸ read_image  canary.png
-▸ terminal    powershell -NoProfile …
-⏳ жду модель (12 с)
-```
-
-- Заголовок: статус (🟡 работает / 🟢 готово / 🔴 ошибка), прошедшее время, счётчик шагов.
-- Последние 3-5 инструментов, по одному в строке: имя + усечённый аргумент (40 симв.).
-- Текущее ожидание, если нет событий > 5 с (`⏳ жду модель`).
-- Опционально: токены/стоимость из `status.usage`.
-
-## 3. Троттлинг и лимиты Telegram
-
-- Минимум 1.5-2 с между правками одного сообщения; события копить и склеивать.
-- Игнорировать `400 message is not modified`.
-- На `429` — уважать `retry_after`, не ретраить сразу.
-- Длина статуса ≤ 3500 символов; обрезать историю шагов, а не ответ.
-- Максимум одно статус-сообщение на тему чата; при новом ходе старое финализируется.
-
-## 4. Скелет
-
-```js
-const statuses = new Map(); // key -> {id, startedAt, steps, lastEdit, pending, timer}
-
-function render(state) {
-  const el = Math.floor((Date.now() - state.startedAt) / 1000);
-  const hdr = state.error ? '🔴 Ошибка' : state.done ? '🟢 Готово' : '🟡 Работаю';
-  const lines = [`${hdr} · ${Math.floor(el/60)}:${String(el%60).padStart(2,'0')} · шаг ${state.step || 0}`];
-  for (const s of state.steps.slice(-4)) lines.push(`▸ ${s.name}  ${truncate(s.arg, 40)}`);
-  if (!state.done && Date.now() - state.lastEvent > 5000) lines.push('⏳ жду модель');
-  return lines.join('\n');
-}
-
-function onEvent(key, ev) {
-  const st = statuses.get(key) ?? { startedAt: Date.now(), steps: [], lastEvent: Date.now() };
-  st.lastEvent = Date.now();
-  if (ev.type === 'tool_call') { st.step++; st.steps.push({ name: ev.name, arg: ev.input }); }
-  if (ev.type === 'status' && ev.phase === 'step_start') st.step = ev.step;
-  statuses.set(key, st);
-  scheduleEdit(key);           // 1.5-2 s debounce, one edit per window
-}
-
-async function scheduleEdit(key) {
-  const st = statuses.get(key);
-  if (st.timer) return;
-  const wait = Math.max(0, 1500 - (Date.now() - (st.lastEdit || 0)));
-  st.timer = setTimeout(async () => {
-    st.timer = null; st.lastEdit = Date.now();
-    try {
-      if (st.id) await tg('editMessageText', { chat_id: st.chat, message_id: st.id, text: render(st) });
-      else { const m = await tg('sendMessage', { chat_id: st.chat, text: render(st) }); st.id = m.message_id; }
-    } catch (e) { if (!/not modified/.test(String(e))) log('status edit failed: ' + e.message); }
-  }, wait);
-}
-
-function finish(key, finalText, opts) {
-  const st = statuses.get(key); if (!st) return sendFinal(key, finalText, opts);
-  statuses.delete(key);
-  return tg('editMessageText', { chat_id: st.chat, message_id: st.id, text: finalText, parse_mode: 'HTML', ...opts })
-    .catch(() => sendFinal(key, finalText, opts));
-}
-```
-
-## 5. Дополнительно (информативность)
-
-- `⏹ Стоп` inline-кнопкой под статусом (уже есть `/stop` — привязать к callback).
-- При втором сообщении во время хода: `⏳ в очереди (2)` вместо тишины.
-- Тайпинг (`sendChatAction typing`) раз в 5 с, пока статус не редактировался.
-- После хода: одна строка итога `🟢 Готово · 19 с · 2 инструмента` в конце ответа (опционально).
-- Ошибки: стабильные коды (`DSH_TIMEOUT`, `DSH_SPAWN_FAIL`, `TG_CONFLICT`, `ATTACH_MISSING`) + hint.
-
-## 6. Приёмка
-
-1. Ход из 5 инструментов даёт ровно одно сообщение-статус и одну финальную правку.
-2. При падении моста посреди хода статус не остаётся «🟡 Работаю» навсегда: на старте помечать
-   незавершённые статусы как `⚠️ прервано`.
-3. При 429 статус не теряется, а догоняет состояние.
-4. Telegram не получает больше 1 правки в 1.5 с на чат.

package/install.ps1

@@ -1,36 +0,0 @@
-# One-line install for Windows:
-#   irm https://raw.githubusercontent.com/aleksvega/dsh-tg-bridge/main/install.ps1 | iex
-$ErrorActionPreference = 'Stop'
-
-$Repo = if ($env:DSH_TG_REPO) { $env:DSH_TG_REPO } else { 'https://github.com/aleksvega/dsh-tg-bridge.git' }
-$Dest = if ($env:DSH_TG_HOME) { $env:DSH_TG_HOME } else { Join-Path $env:USERPROFILE '.dsh\tg-bridge' }
-
-foreach ($tool in 'git', 'node') {
-  if (-not (Get-Command $tool -ErrorAction SilentlyContinue)) { throw "$tool is required" }
-}
-$major = [int]((node -v).TrimStart('v').Split('.')[0])
-if ($major -lt 20) { throw "node >= 20 is required (found $(node -v))" }
-
-if (Test-Path (Join-Path $Dest '.git')) {
-  Write-Host "updating $Dest"
-  git -C $Dest pull --ff-only
-} else {
-  Write-Host "installing into $Dest"
-  New-Item -ItemType Directory -Force -Path (Split-Path $Dest -Parent) | Out-Null
-  git clone --depth 1 $Repo $Dest
-}
-
-Push-Location $Dest
-try {
-  if (-not (Test-Path 'config.json')) {
-    Copy-Item 'config.example.json' 'config.json'
-    Write-Host 'created config.json - edit allowedUserIds and cwd'
-  }
-  node cli.mjs check
-} finally { Pop-Location }
-
-Write-Host ''
-Write-Host 'Next:'
-Write-Host "  1. edit $Dest\config.json  (allowedUserIds, cwd, vision/voice paths)"
-Write-Host "  2. node $Dest\cli.mjs setup"
-Write-Host '  3. in Telegram: /doctor, /help, /cd <project>'

package/install.sh

@@ -1,32 +0,0 @@
-#!/usr/bin/env bash
-# One-line install:
-#   curl -fsSL https://raw.githubusercontent.com/aleksvega/dsh-tg-bridge/main/install.sh | bash
-set -euo pipefail
-
-REPO="${DSH_TG_REPO:-https://github.com/aleksvega/dsh-tg-bridge.git}"
-DEST="${DSH_TG_HOME:-$HOME/.dsh/tg-bridge}"
-
-command -v git >/dev/null || { echo "git is required"; exit 1; }
-command -v node >/dev/null || { echo "node >= 20 is required"; exit 1; }
-node -e 'process.exit(Number(process.versions.node.split(".")[0]) >= 20 ? 0 : 1)' \
-  || { echo "node >= 20 is required (found $(node -v))"; exit 1; }
-
-if [ -d "$DEST/.git" ]; then
-  echo "updating $DEST"
-  git -C "$DEST" pull --ff-only
-else
-  echo "installing into $DEST"
-  mkdir -p "$(dirname "$DEST")"
-  git clone --depth 1 "$REPO" "$DEST"
-fi
-
-cd "$DEST"
-[ -f config.json ] || { cp config.example.json config.json; echo "created config.json — edit allowedUserIds and cwd"; }
-
-echo
-node cli.mjs check || true
-echo
-echo "Next:"
-echo "  1. edit $DEST/config.json  (allowedUserIds, cwd, vision/voice paths)"
-echo "  2. node $DEST/cli.mjs setup"
-echo "  3. in Telegram: /doctor, /help, /cd <project>"