@link-assistant/hive-mind 1.69.5 → 1.69.6

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @link-assistant/hive-mind
 
+## 1.69.6
+
+### Patch Changes
+
+- c2c51fa: Allow Telegram `/terminal_watch` and `/watch` to be used by the user who started a tracked session while preserving chat-owner access and private-repository DM routing.
+
 ## 1.69.5
 
 ### Patch Changes

package/package.json

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

package/src/locales/en.lino

@@ -175,10 +175,10 @@ en
   telegram.help_stop_start "*/stop* / */start* - Stop or resume accepting new tasks (owner only)"
   telegram.help_stop_uuid "*/stop* `<uuid>` - Send CTRL+C to an isolated solve/hive session (owner only). Also works as a reply to a message containing the UUID."
   telegram.help_log "*/log* - Fetch isolation session log (owner only). Usage: `/log <uuid>` or reply with `/log`"
-  telegram.help_terminal_watch "*/terminal\\_watch* - Live-update an isolation session log (owner only). Usage: `/terminal_watch <uuid>` or reply with `/terminal_watch`"
+  telegram.help_terminal_watch "*/terminal\\_watch* (alias: */watch*) - Live-update an isolation session log (chat owner or session requester). Usage: `/terminal_watch <uuid>`, `/watch <uuid>`, or reply with either command"
   telegram.help_notifications "🔔 *Session Notifications:* Completion notifications are automatic; use /subscribe for private DM forwards."
   telegram.help_isolation_mode "🔒 *Isolation Mode:* `{{isolationBackend}}` (experimental)"
-  telegram.help_group_note "⚠️ *Note:* /solve, /do, /continue, /claude, /codex, /opencode, /agent, /gemini, /qwen, /task, /split, /hive, /solve\\_queue, /limits, /version, /accept\\_invites, /merge, /stop and /start commands only work in group chats. /terminal\\_watch, /subscribe and /unsubscribe work in private and group chats."
+  telegram.help_group_note "⚠️ *Note:* /solve, /do, /continue, /claude, /codex, /opencode, /agent, /gemini, /qwen, /task, /split, /hive, /solve\\_queue, /limits, /version, /accept\\_invites, /merge, /stop and /start commands only work in group chats. /terminal\\_watch, /watch, /subscribe and /unsubscribe work in private and group chats."
   telegram.help_common_options "🔧 *Common Options:*"
   telegram.help_model_option "• `--model <model>` or `-m` - {{modelDescription}}"
   telegram.help_base_branch_option "• `--base-branch <branch>` or `-b` - Target branch for PR (default: repo default branch)"

package/src/locales/hi.lino

@@ -175,10 +175,10 @@ hi
   telegram.help_stop_start "*/stop* / */start* - नए tasks स्वीकार करना रोकें या फिर शुरू करें (केवल owner)"
   telegram.help_stop_uuid "*/stop* `<uuid>` - isolated solve/hive session को CTRL+C भेजें (केवल owner)। UUID वाले message पर reply के रूप में भी काम करता है।"
   telegram.help_log "*/log* - isolated session log लाएँ (केवल owner)। उपयोग: `/log <uuid>` या `/log` से reply करें"
-  telegram.help_terminal_watch "*/terminal\\_watch* - isolated session log को live-update करें (केवल owner)। उपयोग: `/terminal_watch <uuid>` या `/terminal_watch` से reply करें"
+  telegram.help_terminal_watch "*/terminal\\_watch* (alias: */watch*) - isolated session log को live-update करें (chat owner या session requester)। उपयोग: `/terminal_watch <uuid>`, `/watch <uuid>`, या इनमें से किसी command से reply करें"
   telegram.help_notifications "🔔 *Session Notifications:* completion notifications automatic हैं; private DM forwards के लिए /subscribe उपयोग करें।"
   telegram.help_isolation_mode "🔒 *Isolation Mode:* `{{isolationBackend}}` (experimental)"
-  telegram.help_group_note "⚠️ *नोट:* /solve, /do, /continue, /claude, /codex, /opencode, /agent, /gemini, /qwen, /task, /split, /hive, /solve\\_queue, /limits, /version, /accept\\_invites, /merge, /stop और /start commands केवल group chats में काम करती हैं। /terminal\\_watch, /subscribe और /unsubscribe private और group chats में काम करती हैं।"
+  telegram.help_group_note "⚠️ *नोट:* /solve, /do, /continue, /claude, /codex, /opencode, /agent, /gemini, /qwen, /task, /split, /hive, /solve\\_queue, /limits, /version, /accept\\_invites, /merge, /stop और /start commands केवल group chats में काम करती हैं। /terminal\\_watch, /watch, /subscribe और /unsubscribe private और group chats में काम करती हैं।"
   telegram.help_common_options "🔧 *Common Options:*"
   telegram.help_model_option "• `--model <model>` या `-m` - {{modelDescription}}"
   telegram.help_base_branch_option "• `--base-branch <branch>` या `-b` - PR के लिए target branch (default: repo default branch)"

package/src/locales/ru.lino

@@ -175,10 +175,10 @@ ru
   telegram.help_stop_start "*/stop* / */start* - Остановить или возобновить прием новых задач (только владелец)"
   telegram.help_stop_uuid "*/stop* `<uuid>` - Отправить CTRL+C в изолированный сеанс solve/hive (только владелец). Также работает ответом на сообщение с UUID."
   telegram.help_log "*/log* - Получить лог изолированного сеанса (только владелец). Использование: `/log <uuid>` или ответ `/log`"
-  telegram.help_terminal_watch "*/terminal\\_watch* - Обновлять лог изолированного сеанса вживую (только владелец). Использование: `/terminal_watch <uuid>` или ответ `/terminal_watch`"
+  telegram.help_terminal_watch "*/terminal\\_watch* (псевдоним: */watch*) - Обновлять лог изолированного сеанса вживую (владелец чата или пользователь, запустивший сеанс). Использование: `/terminal_watch <uuid>`, `/watch <uuid>` или ответ одной из этих команд"
   telegram.help_notifications "🔔 *Уведомления о сеансах:* Уведомления о завершении автоматические; используйте /subscribe для личных пересылок."
   telegram.help_isolation_mode "🔒 *Режим изоляции:* `{{isolationBackend}}` (экспериментально)"
-  telegram.help_group_note "⚠️ *Замечание:* команды /solve, /do, /continue, /claude, /codex, /opencode, /agent, /gemini, /qwen, /task, /split, /hive, /solve\\_queue, /limits, /version, /accept\\_invites, /merge, /stop и /start работают только в групповых чатах. /terminal\\_watch, /subscribe и /unsubscribe работают в личных и групповых чатах."
+  telegram.help_group_note "⚠️ *Замечание:* команды /solve, /do, /continue, /claude, /codex, /opencode, /agent, /gemini, /qwen, /task, /split, /hive, /solve\\_queue, /limits, /version, /accept\\_invites, /merge, /stop и /start работают только в групповых чатах. /terminal\\_watch, /watch, /subscribe и /unsubscribe работают в личных и групповых чатах."
   telegram.help_common_options "🔧 *Общие опции:*"
   telegram.help_model_option "• `--model <model>` или `-m` - {{modelDescription}}"
   telegram.help_base_branch_option "• `--base-branch <branch>` или `-b` - Целевая ветка для PR (по умолчанию ветка репозитория)"

package/src/locales/zh.lino

@@ -175,10 +175,10 @@ zh
   telegram.help_stop_start "*/stop* / */start* - 停止或恢复接收新任务（仅所有者）"
   telegram.help_stop_uuid "*/stop* `<uuid>` - 向隔离的 solve/hive 会话发送 CTRL+C（仅所有者）。也可回复包含 UUID 的消息。"
   telegram.help_log "*/log* - 获取隔离会话日志（仅所有者）。用法：`/log <uuid>` 或回复 `/log`"
-  telegram.help_terminal_watch "*/terminal\\_watch* - 实时更新隔离会话日志（仅所有者）。用法：`/terminal_watch <uuid>` 或回复 `/terminal_watch`"
+  telegram.help_terminal_watch "*/terminal\\_watch*（别名：*/watch*）- 实时更新隔离会话日志（聊天所有者或会话请求者）。用法：`/terminal_watch <uuid>`、`/watch <uuid>`，或用任一命令回复"
   telegram.help_notifications "🔔 *会话通知：* 完成通知会自动发送；使用 /subscribe 获取私聊转发。"
   telegram.help_isolation_mode "🔒 *隔离模式：* `{{isolationBackend}}`（实验性）"
-  telegram.help_group_note "⚠️ *注意：* /solve、/do、/continue、/claude、/codex、/opencode、/agent、/gemini、/qwen、/task、/split、/hive、/solve\\_queue、/limits、/version、/accept\\_invites、/merge、/stop 和 /start 仅在群聊中有效。/terminal\\_watch、/subscribe 和 /unsubscribe 在私聊和群聊中有效。"
+  telegram.help_group_note "⚠️ *注意：* /solve、/do、/continue、/claude、/codex、/opencode、/agent、/gemini、/qwen、/task、/split、/hive、/solve\\_queue、/limits、/version、/accept\\_invites、/merge、/stop 和 /start 仅在群聊中有效。/terminal\\_watch、/watch、/subscribe 和 /unsubscribe 在私聊和群聊中有效。"
   telegram.help_common_options "🔧 *常用选项：*"
   telegram.help_model_option "• `--model <model>` 或 `-m` - {{modelDescription}}"
   telegram.help_base_branch_option "• `--base-branch <branch>` 或 `-b` - PR 目标分支（默认：仓库默认分支）"

package/src/telegram-terminal-watch-command.lib.mjs

@@ -17,7 +17,7 @@ const activeWatches = new Map();
 
 function splitCommandArgs(text) {
   const body = String(text || '')
-    .replace(/^\/terminal_watch(?:@\w+)?\b/i, '')
+    .replace(/^\/(?:terminal_watch|watch)(?:@\w+)?\b/i, '')
     .trim();
   return body.match(/"[^"]*"|'[^']*'|\S+/g)?.map(token => token.replace(/^(['"])(.*)\1$/, '$2')) || [];
 }
@@ -171,6 +171,12 @@ async function querySessionStatusWithRetry(querySessionStatus, sessionId, verbos
   return null;
 }
 
+export function isTerminalWatchSessionRequester({ sessionInfo = null, userId = null } = {}) {
+  if (userId === null || userId === undefined) return false;
+  if (sessionInfo?.requesterUserId === null || sessionInfo?.requesterUserId === undefined) return false;
+  return String(sessionInfo.requesterUserId) === String(userId);
+}
+
 // Note: /terminal_watch never uploads the full session log itself (issue #1720).
 // Use /log <uuid> if you want the log file delivered as a document.
 function getDisplayedTerminalSnapshot(logText, options) {
@@ -229,7 +235,7 @@ export function watchTerminalLogSession({ bot, chatId, messageId, sessionId, log
 }
 
 function buildUsage() {
-  return 'Usage:\n• `/terminal_watch <UUID>`\n• Reply to a session message with `/terminal_watch`\n\nOptions: `--size 120x25`, `--width 120`, `--height 25`, `--interval-ms 2500`, `--max-chars 3400`';
+  return 'Usage:\n• `/terminal_watch <UUID>` (alias: `/watch <UUID>`)\n• Reply to a session message with `/terminal_watch` or `/watch`\n\nOptions: `--size 120x25`, `--width 120`, `--height 25`, `--interval-ms 2500`, `--max-chars 3400`';
 }
 
 async function createWatchMessage({ ctx, targetChatId, replyToMessageId, text }) {
@@ -302,12 +308,14 @@ export async function startAutoTerminalWatchForSession({ bot, ctx, sessionId, se
 
 export async function registerTerminalWatchCommand(bot, options) {
   const { VERBOSE = false, isOldMessage, isChatAuthorized, isTopicAuthorized, buildAuthErrorMessage } = options;
-  const runner = await import('./isolation-runner.lib.mjs');
+  const runner = !options.querySessionStatus || !options.isTerminalSessionStatus ? await import('./isolation-runner.lib.mjs') : null;
+  const querySessionStatus = options.querySessionStatus || runner.querySessionStatus;
+  const isTerminalSessionStatus = options.isTerminalSessionStatus || runner.isTerminalSessionStatus;
   const getTrackedSessionInfo = options.getTrackedSessionInfo || (await import('./session-monitor.lib.mjs')).getTrackedSessionInfo;
   const detectRepositoryVisibility = options.detectRepositoryVisibility || (await import('./github.lib.mjs')).detectRepositoryVisibility;
   const parseGitHubUrl = options.parseGitHubUrl || (await import('./github.lib.mjs')).parseGitHubUrl;
 
-  bot.command('terminal_watch', async ctx => {
+  const handleTerminalWatchCommand = async ctx => {
     VERBOSE && console.log('[VERBOSE] /terminal_watch command received');
     if (isOldMessage && isOldMessage(ctx)) return;
 
@@ -327,17 +335,23 @@ export async function registerTerminalWatchCommand(bot, options) {
       return;
     }
 
+    const sessionInfo = getTrackedSessionInfo ? getTrackedSessionInfo(sessionId) : null;
+
     if (chat.type !== 'private') {
-      try {
-        const member = await ctx.telegram.getChatMember(chat.id, ctx.from.id);
-        if (!member || member.status !== 'creator') {
-          await ctx.reply('❌ /terminal_watch is only available to the chat owner.', { reply_to_message_id: message.message_id });
+      if (isTerminalWatchSessionRequester({ sessionInfo, userId: ctx.from?.id })) {
+        VERBOSE && console.log(`[VERBOSE] /terminal_watch allowed for session requester ${ctx.from?.id} on ${sessionId}`);
+      } else {
+        try {
+          const member = await ctx.telegram.getChatMember(chat.id, ctx.from.id);
+          if (!member || member.status !== 'creator') {
+            await ctx.reply('❌ /terminal_watch is only available to the chat owner or the user who started this session.', { reply_to_message_id: message.message_id });
+            return;
+          }
+        } catch (error) {
+          console.error('[ERROR] /terminal_watch: getChatMember failed:', error);
+          await ctx.reply('❌ Failed to verify permissions for /terminal_watch.', { reply_to_message_id: message.message_id });
           return;
         }
-      } catch (error) {
-        console.error('[ERROR] /terminal_watch: getChatMember failed:', error);
-        await ctx.reply('❌ Failed to verify permissions for /terminal_watch.', { reply_to_message_id: message.message_id });
-        return;
       }
     }
 
@@ -349,7 +363,7 @@ export async function registerTerminalWatchCommand(bot, options) {
 
     let statusResult;
     try {
-      statusResult = await runner.querySessionStatus(sessionId, VERBOSE);
+      statusResult = await querySessionStatus(sessionId, VERBOSE);
     } catch (error) {
       console.error('[ERROR] /terminal_watch: querySessionStatus failed:', error);
       await ctx.reply(`❌ Failed to query session status: ${error.message || String(error)}`, { reply_to_message_id: message.message_id });
@@ -361,7 +375,6 @@ export async function registerTerminalWatchCommand(bot, options) {
       return;
     }
 
-    const sessionInfo = getTrackedSessionInfo ? getTrackedSessionInfo(sessionId) : null;
     const { repoVisibility, repoDescription } = await resolveTerminalWatchRepository({ sessionInfo, statusResult, parseGitHubUrl, detectRepositoryVisibility });
     const decision = decideLogDestination({ statusResult, sessionInfo, repoVisibility, chatType: chat.type });
     if (decision.destination === 'reject') {
@@ -378,13 +391,16 @@ export async function registerTerminalWatchCommand(bot, options) {
     }
 
     try {
-      await startWatchFromResolvedSession({ bot, ctx, sessionId, statusResult, sessionInfo, decision, logPath, watchOptions: parsedArgs.options, querySessionStatus: runner.querySessionStatus, isTerminalSessionStatus: runner.isTerminalSessionStatus, repoDescription, verbose: VERBOSE });
+      await startWatchFromResolvedSession({ bot, ctx, sessionId, statusResult, sessionInfo, decision, logPath, watchOptions: parsedArgs.options, querySessionStatus, isTerminalSessionStatus, repoDescription, verbose: VERBOSE });
     } catch (error) {
       console.error('[ERROR] /terminal_watch: failed to start watch:', error);
       const friendly = error?.code === 403 || /chat not found|bot can't initiate conversation/i.test(error?.message || '') ? 'I could not send you a DM. Please open a private chat with me and send /start, then try again.' : `Failed to start terminal watch: ${error.message || String(error)}`;
       await ctx.reply(`❌ ${friendly}`, { reply_to_message_id: message.message_id });
     }
-  });
+  };
+
+  bot.command('terminal_watch', handleTerminalWatchCommand);
+  bot.command('watch', handleTerminalWatchCommand);
 }
 
 export const __INTERNAL_FOR_TESTS__ = {