remote-coder 0.5.1__tar.gz → 0.5.2__tar.gz

{remote_coder-0.5.1/remote_coder.egg-info → remote_coder-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: remote-coder
-Version: 0.5.1
+Version: 0.5.2
 Summary: Telegram-based remote AI coding automation server
 Author: Remote AI Coder contributors
 License:                                  Apache License
@@ -236,7 +236,7 @@ Run Claude Code, Codex, or Gemini on your local development machine by sending a
 - Claude, Codex, and Gemini runners behind the same job flow.
 - Reply-linked jobs continue the same AI CLI session, so follow-ups build on prior context.
 - Local admin UI for project setup, advanced settings, logs, and conversation memory.
-- Read-only `plan:` and `ask:` modes when you want analysis without commits. PLAN mode asks open decisions through inline buttons first, then finalizes the plan from your answers.
+- Read-only `plan:`, `ask:`, and `research:` modes when you want analysis without commits. PLAN mode asks open decisions through inline buttons first, then finalizes the plan from your answers; RESEARCH mode asks the selected AI CLI to use internet search when useful.
 
 ## Quick Start
 
@@ -311,6 +311,7 @@ Natural-language examples:
 Fix the login validation bug with model: codex
 plan: outline the migration before changing code
 /ask what test command does this repo use?
+/research compare current Telegram webhook security guidance
 수정: 방금 작업에서 README 문구만 더 간결하게 바꿔줘
 ```
 

{remote_coder-0.5.1 → remote_coder-0.5.2}/README.md

@@ -15,7 +15,7 @@ Run Claude Code, Codex, or Gemini on your local development machine by sending a
 - Claude, Codex, and Gemini runners behind the same job flow.
 - Reply-linked jobs continue the same AI CLI session, so follow-ups build on prior context.
 - Local admin UI for project setup, advanced settings, logs, and conversation memory.
-- Read-only `plan:` and `ask:` modes when you want analysis without commits. PLAN mode asks open decisions through inline buttons first, then finalizes the plan from your answers.
+- Read-only `plan:`, `ask:`, and `research:` modes when you want analysis without commits. PLAN mode asks open decisions through inline buttons first, then finalizes the plan from your answers; RESEARCH mode asks the selected AI CLI to use internet search when useful.
 
 ## Quick Start
 
@@ -90,6 +90,7 @@ Natural-language examples:
 Fix the login validation bug with model: codex
 plan: outline the migration before changing code
 /ask what test command does this repo use?
+/research compare current Telegram webhook security guidance
 수정: 방금 작업에서 README 문구만 더 간결하게 바꿔줘
 ```
 

{remote_coder-0.5.1 → remote_coder-0.5.2}/app/__init__.py

@@ -1,3 +1,3 @@
 """Remote AI Coder application package."""
 
-__version__ = "0.5.1"
+__version__ = "0.5.2"

{remote_coder-0.5.1 → remote_coder-0.5.2}/app/admin/router.py

@@ -378,9 +378,10 @@ def create_admin_router(
         report = check_prerequisites()
         installed = [cli.name for cli in report.ai_clis if cli.installed]
         _adminlog.info(
-            "prerequisites queried ngrok_ok=%s ai_clis=%s",
+            "prerequisites queried ngrok_ok=%s ai_clis=%s github_cli=%s",
             report.ngrok_ok,
             ",".join(installed) or "-",
+            report.github_cli.installed,
         )
         return report.model_dump()
 

{remote_coder-0.5.1 → remote_coder-0.5.2}/app/admin/static/i18n.js

@@ -146,6 +146,11 @@
       en: "None found (install at least one: claude / codex / gemini)",
       ko: "설치된 것 없음 (claude / codex / gemini 중 최소 1개 설치)",
     },
+    "setup.githubCli": { en: "GitHub CLI", ko: "GitHub CLI" },
+    "setup.githubCliNone": {
+      en: "Not found (install gh before using /pr)",
+      ko: "설치되지 않음 (/pr 사용 전 gh 설치 필요)",
+    },
     "setup.checking": { en: "Checking…", ko: "확인 중…" },
     "setup.recheck": { en: "Re-check", ko: "다시 확인" },
     "setup.cta": { en: "Add your first project", ko: "첫 프로젝트 추가" },

{remote_coder-0.5.1 → remote_coder-0.5.2}/app/admin/templates/admin.html

@@ -248,9 +248,12 @@
       const installed = (report.ai_clis || []).filter((c) => c.installed).map((c) => c.name);
       const aiOk = installed.length > 0;
       const aiDetail = aiOk ? installed.join(", ") : i18n.t("setup.aiCliNone");
+      const ghOk = !!(report.github_cli && report.github_cli.installed);
+      const ghDetail = ghOk ? "gh" : i18n.t("setup.githubCliNone");
       $("#setup-prereq").innerHTML =
         renderPrereqRow(!!report.ngrok_ok, i18n.t("setup.ngrok"), ngrokDetail) +
-        renderPrereqRow(aiOk, i18n.t("setup.aiCli"), aiDetail);
+        renderPrereqRow(aiOk, i18n.t("setup.aiCli"), aiDetail) +
+        renderPrereqRow(ghOk, i18n.t("setup.githubCli"), ghDetail);
     }
 
     async function loadPrerequisites() {

{remote_coder-0.5.1 → remote_coder-0.5.2}/app/ai/base.py

@@ -57,6 +57,18 @@ _PLAN_DECISIONS_INSTRUCTION = (
 )
 
 
+_RESEARCH_INSTRUCTION = (
+    "You are in RESEARCH mode. Read the repository context and answer the user's research "
+    "question. Do not modify files.\n\n"
+    "Use internet search when it is useful or necessary for the question, similar to a deep "
+    "research workflow. Compare multiple perspectives or sources when possible, and clearly "
+    "separate repository-derived facts from external findings. Include citations or source "
+    "links for external claims, call out uncertainty or limitations, and finish with a direct "
+    "answer to the user's problem.\n\n"
+    "User research request:\n"
+)
+
+
 def instruction_for_runner_mode(instruction: str, mode: JobMode) -> str:
     if mode == JobMode.PLAN:
         return f"{_PLAN_DECISIONS_INSTRUCTION}{instruction}"
@@ -66,6 +78,8 @@ def instruction_for_runner_mode(instruction: str, mode: JobMode) -> str:
             "Do not modify files.\n\n"
             f"User question:\n{instruction}"
         )
+    if mode == JobMode.RESEARCH:
+        return f"{_RESEARCH_INSTRUCTION}{instruction}"
     return instruction
 
 

{remote_coder-0.5.1 → remote_coder-0.5.2}/app/ai/codex.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 from pathlib import Path
 
 from app.ai.base import BaseCliRunner, RunnerInput, instruction_for_runner_mode
-from app.jobs.schemas import JobMode
+from app.jobs.schemas import is_read_only_job_mode
 from app.models import CodexSandboxMode
 from app.monitoring.events import EventLogger
 
@@ -16,7 +16,7 @@ class CodexRunner(BaseCliRunner):
         self._sandbox = sandbox
 
     def _resolve_sandbox(self, runner_input: RunnerInput) -> CodexSandboxMode:
-        if runner_input.mode in (JobMode.PLAN, JobMode.ASK):
+        if is_read_only_job_mode(runner_input.mode):
             return CodexSandboxMode.READ_ONLY
         return self._sandbox
 
@@ -29,7 +29,7 @@ class CodexRunner(BaseCliRunner):
 
     def build_argv(self, runner_input: RunnerInput) -> list[str]:
         sandbox = self._resolve_sandbox(runner_input)
-        if runner_input.mode in (JobMode.PLAN, JobMode.ASK):
+        if is_read_only_job_mode(runner_input.mode):
             instruction = instruction_for_runner_mode(runner_input.instruction, runner_input.mode)
         else:
             instruction = runner_input.instruction

{remote_coder-0.5.1 → remote_coder-0.5.2}/app/ai/gemini.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 from pathlib import Path
 
 from app.ai.base import BaseCliRunner, RunnerInput, instruction_for_runner_mode
-from app.jobs.schemas import JobMode
+from app.jobs.schemas import is_read_only_job_mode
 from app.monitoring.events import EventLogger
 
 
@@ -17,7 +17,7 @@ class GeminiRunner(BaseCliRunner):
         return Path.home() / ".gemini" / "sessions"
 
     def build_argv(self, runner_input: RunnerInput) -> list[str]:
-        if runner_input.mode in (JobMode.PLAN, JobMode.ASK):
+        if is_read_only_job_mode(runner_input.mode):
             prompt = instruction_for_runner_mode(runner_input.instruction, runner_input.mode)
             argv = ["gemini", "--skip-trust", "-p", prompt]
         else:

{remote_coder-0.5.1 → remote_coder-0.5.2}/app/cli.py

@@ -32,7 +32,7 @@ def build_parser() -> argparse.ArgumentParser:
         help="Run the server only (skip ngrok and webhook registration)",
     )
 
-    subparsers.add_parser("doctor", help="Check prerequisites (ngrok, AI CLIs)")
+    subparsers.add_parser("doctor", help="Check prerequisites (ngrok, AI CLIs, GitHub CLI)")
     return parser
 
 
@@ -128,6 +128,10 @@ def run_doctor() -> None:
             "  ⚠️ AI CLI (claude/codex/gemini) not found. Install at least one. "
             "(e.g. npm install -g @anthropic-ai/claude-code)"
         )
+    if report.github_cli.installed:
+        print("  ✅ GitHub CLI: gh")
+    else:
+        print("  ⚠️ GitHub CLI (gh) not found. Install it before using /pr.")
 
 
 if __name__ == "__main__":

{remote_coder-0.5.1 → remote_coder-0.5.2}/app/diagnostics.py

@@ -7,6 +7,7 @@ from pydantic import BaseModel
 from app import tunnel
 
 AI_CLI_TOOLS = ("claude", "codex", "gemini")
+GITHUB_CLI_TOOL = "gh"
 
 
 class AiCliStatus(BaseModel):
@@ -18,6 +19,7 @@ class PrerequisitesReport(BaseModel):
     ngrok_ok: bool
     ngrok_detail: str
     ai_clis: list[AiCliStatus]
+    github_cli: AiCliStatus
 
 
 def check_prerequisites() -> PrerequisitesReport:
@@ -34,4 +36,13 @@ def check_prerequisites() -> PrerequisitesReport:
         AiCliStatus(name=tool, installed=shutil.which(tool) is not None)
         for tool in AI_CLI_TOOLS
     ]
-    return PrerequisitesReport(ngrok_ok=ngrok_ok, ngrok_detail=ngrok_detail, ai_clis=ai_clis)
+    github_cli = AiCliStatus(
+        name=GITHUB_CLI_TOOL,
+        installed=shutil.which(GITHUB_CLI_TOOL) is not None,
+    )
+    return PrerequisitesReport(
+        ngrok_ok=ngrok_ok,
+        ngrok_detail=ngrok_detail,
+        ai_clis=ai_clis,
+        github_cli=github_cli,
+    )

{remote_coder-0.5.1 → remote_coder-0.5.2}/app/jobs/execution_pipeline.py

@@ -6,7 +6,7 @@ from pathlib import Path
 from app.ai.base import RunnerInput
 from app.git.commit_message import CommitMessageFormatter
 from app.jobs.plan_decisions import PlanDecisionQuestion, parse_plan_decisions
-from app.jobs.schemas import Job, JobMode
+from app.jobs.schemas import Job, JobMode, is_read_only_job_mode
 from app.monitoring.events import EventLogger
 
 _joblog = EventLogger("app.jobs.lifecycle", "job.lifecycle")
@@ -50,7 +50,7 @@ def run_job(manager, job_id: str) -> Job:
     created_worktree_for_job = False
     failed_stage: str | None = None
     remote = manager._effective_git_remote_name()
-    read_only_job = job.request.mode in (JobMode.PLAN, JobMode.ASK)
+    read_only_job = is_read_only_job_mode(job.request.mode)
     plan_decision_questions: list[PlanDecisionQuestion] | None = None
     try:
         job.mark_running()
@@ -238,9 +238,7 @@ def run_job(manager, job_id: str) -> Job:
     finally:
         manager._cancel_events.pop(job_id, None)
         manager._cancelled_job_ids.discard(job_id)
-        read_only_succeeded = (
-            job.request.mode in (JobMode.PLAN, JobMode.ASK) and job.status.value == "succeeded"
-        )
+        read_only_succeeded = is_read_only_job_mode(job.request.mode) and job.status.value == "succeeded"
         cleanup_on_success = read_only_succeeded or not manager._effective_keep_worktree_on_success()
         _joblog.info(
             "job finalizing status=%s created_worktree=%s cleanup_on_success=%s",

{remote_coder-0.5.1 → remote_coder-0.5.2}/app/jobs/schemas.py

@@ -26,9 +26,17 @@ class JobMode(StrEnum):
     AGENT = "agent"
     PLAN = "plan"
     ASK = "ask"
+    RESEARCH = "research"
     AGENT_FIX = "agent_fix"
 
 
+READ_ONLY_JOB_MODES = frozenset({JobMode.PLAN, JobMode.ASK, JobMode.RESEARCH})
+
+
+def is_read_only_job_mode(mode: JobMode) -> bool:
+    return mode in READ_ONLY_JOB_MODES
+
+
 class FixKind(StrEnum):
     SOURCE = "source"
 

{remote_coder-0.5.1 → remote_coder-0.5.2}/app/jobs/worktree_planner.py

@@ -4,7 +4,7 @@ from dataclasses import dataclass
 from pathlib import Path
 
 from app.git.service import GitWorktreeService
-from app.jobs.schemas import Job, JobMode
+from app.jobs.schemas import Job, is_read_only_job_mode
 from app.monitoring.events import EventLogger
 
 _joblog = EventLogger("app.jobs.lifecycle", "job.lifecycle")
@@ -27,7 +27,7 @@ def prepare_worktree_plan(
     job_ctx: dict[str, object],
 ) -> WorktreePlan:
     requested_branch = job.request.branch
-    if job.request.mode in (JobMode.PLAN, JobMode.ASK):
+    if is_read_only_job_mode(job.request.mode):
         path = git_service.prepare_detached_worktree(
             project_path, job.id, worktree_base_dir=worktree_base
         )

{remote_coder-0.5.1 → remote_coder-0.5.2}/app/telegram/commands/base.py

@@ -100,8 +100,9 @@ HELP_TEXT = "\n".join(
         "- no commit",
         "- plan: <natural language> or /plan <natural language> - plan mode (plan only; no code changes)",
         "- ask: <natural language> or /ask <natural language> - ask mode (analysis and answers; no code edits)",
+        "- research: <natural language> or /research <natural language> - research mode (internet-backed answers; no code edits)",
         "- fix: <natural language> or /fix - fix mode (reply to a job result; amends that commit)",
-        "- Korean aliases 계획:, 질문:, and 수정: instead of plan:/ask:/fix: (colons `:` or full-width `：` allowed)",
+        "- Korean aliases 계획:, 질문:, 조사:, and 수정: instead of plan:/ask:/research:/fix: (colons `:` or full-width `：` allowed)",
         "",
         "📋 Commands",
         render_command_list(_HELP_COMMAND_ROWS),
@@ -122,7 +123,7 @@ HELP_AGENT_TOPIC = "\n".join(
         "- model: codex branch: remote-auth strengthen tests",
         "- no commit just verify the doc wording",
         "",
-        "A job is accepted after project/branch/model checks via `y`/`Y` or inline buttons.",
+        "A job is accepted after project/branch/model checks with inline Yes/No buttons.",
     ]
 )
 
@@ -131,7 +132,7 @@ HELP_PLAN_TOPIC = "\n".join(
         "📐 Plan mode (plan)",
         "",
         "Receive change plans only; no code edits. Like agent mode, a job is accepted after confirmation "
-        "(`y`/`Y` or inline buttons).",
+        "with inline Yes/No buttons.",
         "",
         "💡 Examples",
         "- plan: summarize the login validation flow",
@@ -147,7 +148,7 @@ HELP_ASK_TOPIC = "\n".join(
         "❓ Ask mode (ask)",
         "",
         "Answer questions using the repository; no code edits, commits, or pushes. Jobs are accepted like "
-        "agent mode after confirmation (`y`/`Y` or inline buttons).",
+        "agent mode after confirmation with inline Yes/No buttons.",
         "",
         "💡 Examples",
         "- ask: how do I run pytest in this project?",
@@ -158,6 +159,22 @@ HELP_ASK_TOPIC = "\n".join(
     ]
 )
 
+HELP_RESEARCH_TOPIC = "\n".join(
+    [
+        "🔎 Research mode (research)",
+        "",
+        "Answer research questions using repository context and internet search when useful; no code edits, "
+        "commits, or pushes. Jobs are accepted like agent mode after confirmation with inline Yes/No buttons.",
+        "",
+        "💡 Examples",
+        "- research: compare webhook retry strategies for this service",
+        "- /research model: codex find current FastAPI deployment guidance",
+        "- 조사：Telegram webhook 보안 권장사항 조사",
+        "",
+        "See /help for more options.",
+    ]
+)
+
 HELP_FIX_TOPIC = "\n".join(
     [
         "🔧 Fix mode (fix)",

{remote_coder-0.5.1 → remote_coder-0.5.2}/app/telegram/commands/branch.py

@@ -17,6 +17,26 @@ from app.telegram.commands.base import (
 from app.telegram.i18n import ui_message
 
 
+_MISSING_GH_ERROR = "GitHub CLI (gh) is not installed or not available on PATH."
+
+
+def _format_pr_error(exc: RuntimeError) -> str:
+    message = str(exc)
+    if _MISSING_GH_ERROR in message:
+        return ui_message(
+            "pr.gh_missing",
+            "/pr failed: GitHub CLI (gh) is not installed or not available on PATH.\n\n"
+            "To create PRs from Telegram:\n"
+            "1. Install GitHub CLI:\n"
+            "   - macOS: `brew install gh`\n"
+            "   - Windows: `winget install --id GitHub.cli`\n"
+            "   - Ubuntu/Debian: `sudo apt install gh`\n"
+            "2. Sign in: `gh auth login`\n"
+            "3. Restart Remote AI Coder: `remote-coder up`",
+        )
+    return f"/pr failed: {message}"
+
+
 class BranchCommand(TelegramCommand):
     name = "/branch"
     description = "Show the current branch or switch to a local branch"
@@ -261,7 +281,7 @@ class PrCommand(TelegramCommand):
             try:
                 branches = self._load_pr_candidates(message, ctx)
             except RuntimeError as exc:
-                return f"/pr failed: {exc}"
+                return _format_pr_error(exc)
             if not branches:
                 return ui_message(
                     "pr.no_candidates",
@@ -301,7 +321,7 @@ class PrCommand(TelegramCommand):
                 entry.root_path, remote, ""
             )
         except RuntimeError as exc:
-            return f"/pr failed: {exc}"
+            return _format_pr_error(exc)
         if branch not in remote_branches:
             return ui_message(
                 "pr.remote_branch_missing",
@@ -314,7 +334,7 @@ class PrCommand(TelegramCommand):
         try:
             base_branch = ctx.git_service.resolve_integrate_branch(entry.root_path)
         except RuntimeError as exc:
-            return f"/pr failed: {exc}"
+            return _format_pr_error(exc)
 
         title, body = self._build_pr_content(branch, project_name, message.chat_id, ctx)
 
@@ -327,7 +347,7 @@ class PrCommand(TelegramCommand):
                 body,
             )
         except RuntimeError as exc:
-            return f"/pr failed: {exc}"
+            return _format_pr_error(exc)
 
         return f"PR created:\n{pr_url}"
 

{remote_coder-0.5.1 → remote_coder-0.5.2}/app/telegram/commands/registry.py

@@ -37,7 +37,7 @@ class CommandRegistry:
                 ctx.confirmation_store.pop(scope_project, message.chat_id)
                 return init_cmd.execute(message, ctx)
 
-        if head in {"/plan", "/ask", "/fix"}:
+        if head in {"/plan", "/ask", "/research", "/fix"}:
             return None
 
         pending = ctx.confirmation_store.get(scope_project, message.chat_id)
@@ -89,6 +89,13 @@ class CommandRegistry:
                 "command": "ask",
                 "description": translate_text("ask mode message (example: /ask explain the JobManager role)", language),
             },
+            {
+                "command": "research",
+                "description": translate_text(
+                    "research mode message (example: /research compare webhook retry strategies)",
+                    language,
+                ),
+            },
         ]
 
 

{remote_coder-0.5.1 → remote_coder-0.5.2}/app/telegram/commands/system.py

@@ -6,6 +6,7 @@ from app.telegram.commands.base import (
     HELP_ASK_TOPIC,
     HELP_FIX_TOPIC,
     HELP_PLAN_TOPIC,
+    HELP_RESEARCH_TOPIC,
     HELP_TEXT,
     CommandContext,
     InlineButton,
@@ -98,6 +99,9 @@ class StartCommand(TelegramCommand):
                         InlineButton("AGENTS mode", "/help agent"),
                         InlineButton("PLAN mode", "/help plan"),
                         InlineButton("ASK mode", "/help ask"),
+                    ],
+                    [
+                        InlineButton("RESEARCH mode", "/help research"),
                         InlineButton("FIX mode", "/help fix"),
                     ],
                 ],
@@ -121,7 +125,13 @@ class HelpCommand(TelegramCommand):
         tokens = message.text.strip().split()
         if len(tokens) >= 2:
             raw = tokens[1]
-            topic_aliases = {"에이전트": "agent", "계획": "plan", "질문": "ask", "수정": "fix"}
+            topic_aliases = {
+                "에이전트": "agent",
+                "계획": "plan",
+                "질문": "ask",
+                "조사": "research",
+                "수정": "fix",
+            }
             topic = topic_aliases.get(raw, raw.lower())
             if topic in ("agent", "agents"):
                 return HELP_AGENT_TOPIC
@@ -129,6 +139,8 @@ class HelpCommand(TelegramCommand):
                 return HELP_PLAN_TOPIC
             if topic == "ask":
                 return HELP_ASK_TOPIC
+            if topic == "research":
+                return HELP_RESEARCH_TOPIC
             if topic == "fix":
                 return HELP_FIX_TOPIC
         if len(tokens) >= 2 and self._registry is not None:

{remote_coder-0.5.1 → remote_coder-0.5.2}/app/telegram/handlers/job_submission.py

@@ -7,7 +7,7 @@ from fastapi import BackgroundTasks
 from app.ai.model_catalog import format_model_selection
 from app.ai.usage import format_token_usage
 from app.jobs.manager import JobManager
-from app.jobs.schemas import Job, JobMode, JobRequest
+from app.jobs.schemas import Job, JobRequest, is_read_only_job_mode
 from app.monitoring.events import EventLogger
 from app.telegram.conversation import SQLiteConversationStore
 
@@ -26,7 +26,7 @@ def format_job_result_memory_summary(final_job: Job) -> str:
     token_usage = format_token_usage(final_job.runner_token_usage)
     if token_usage:
         summary += f" tokens={token_usage}"
-    if final_job.request.mode in (JobMode.PLAN, JobMode.ASK) and final_job.runner_stdout_summary:
+    if is_read_only_job_mode(final_job.request.mode) and final_job.runner_stdout_summary:
         preview = final_job.runner_stdout_summary[:_JOB_RESULT_MEMORY_READ_ONLY_STDOUT_PREVIEW]
         summary += f" stdout_preview={preview}"
     return summary

{remote_coder-0.5.1 → remote_coder-0.5.2}/app/telegram/handlers/natural_flow.py

@@ -177,7 +177,12 @@ class NaturalFlow:
     ) -> dict[str, str]:
         cc = req.command_context
         cc.confirmation_store.pop(req.scope_project, req.chat_id)
-        mode_prefix = "/plan" if pending.action == JobMode.PLAN.value else "/ask"
+        mode_prefixes = {
+            JobMode.PLAN.value: "/plan",
+            JobMode.ASK.value: "/ask",
+            JobMode.RESEARCH.value: "/research",
+        }
+        mode_prefix = mode_prefixes.get(pending.action, "/ask")
         try:
             parsed_request = self._parser.parse_natural(
                 f"{mode_prefix} {req.message.text}",

{remote_coder-0.5.1 → remote_coder-0.5.2}/app/telegram/handlers/presenters.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from app.ai.model_catalog import format_model_selection
-from app.jobs.schemas import JobMode, JobRequest
+from app.jobs.schemas import JobMode, JobRequest, is_read_only_job_mode
 from app.telegram.commands import InlineButton
 from app.telegram.commands import NAV_CLOSE_CALLBACK
 
@@ -24,10 +24,8 @@ def format_natural_job_confirmation(
         f"- Work branch: {current_branch}",
         f"- Model: {format_model_selection(request.model, request.model_id)}",
     ]
-    if request.mode is JobMode.PLAN:
-        lines.append("- Mode: plan (read-only, no commit/push)")
-    elif request.mode is JobMode.ASK:
-        lines.append("- Mode: ask (read-only, no commit/push)")
+    if is_read_only_job_mode(request.mode):
+        lines.append(f"- Mode: {request.mode.value} (read-only, no commit/push)")
     else:
         lines.append("- Mode: agent (may edit code, commit, and push)")
     if request.branch:
@@ -81,6 +79,12 @@ def format_mode_input_prompt(mode: JobMode) -> str:
             "Example: Explain the JobManager flow\n"
             "Example: model: codex How do I run pytest?"
         )
+    if mode is JobMode.RESEARCH:
+        return (
+            "Send the research question to run in research mode.\n\n"
+            "Example: Compare FastAPI deployment options for this project\n"
+            "Example: model: codex Research the safest webhook retry strategy"
+        )
     raise AssertionError(mode)
 
 
@@ -98,4 +102,3 @@ def format_fix_requires_reply_message() -> str:
         "Example: reply to a job result, then send /fix\n"
         "Example: reply to a job result with fix: add missing tests"
     )
-

{remote_coder-0.5.1 → remote_coder-0.5.2}/app/telegram/handlers/update_handler.py

@@ -180,8 +180,13 @@ class WebhookUpdateHandler:
         if pending_result is not None:
             return pending_result
 
-        if message_head_lower in {"/plan", "/ask"} and len(message_tokens) == 1:
-            mode = JobMode.PLAN if message_head_lower == "/plan" else JobMode.ASK
+        if message_head_lower in {"/plan", "/ask", "/research"} and len(message_tokens) == 1:
+            mode_by_command = {
+                "/plan": JobMode.PLAN,
+                "/ask": JobMode.ASK,
+                "/research": JobMode.RESEARCH,
+            }
+            mode = mode_by_command[message_head_lower]
             return self._natural_flow_factory().prompt_for_mode_instruction(req, mode)
 
         if message_head_lower == "/fix" and len(message_tokens) == 1:

{remote_coder-0.5.1 → remote_coder-0.5.2}/app/telegram/i18n.py

@@ -120,12 +120,14 @@ def command_parse_error_empty_instruction_plan_ask(language: UiLanguage) -> str:
         return (
             "작업 지시문이 비어 있습니다.\n\n"
             "예: plan: 로그인 수정 계획 세워줘\n"
-            "예: /ask JobManager 흐름 설명해줘"
+            "예: /ask JobManager 흐름 설명해줘\n"
+            "예: /research webhook 보안 권장사항 조사"
         )
     return (
         "The work instruction is empty.\n\n"
         "Example: plan: outline the login refactor\n"
-        "Example: /ask explain JobManager routing"
+        "Example: /ask explain JobManager routing\n"
+        "Example: /research compare webhook security guidance"
     )
 
 
@@ -191,6 +193,7 @@ _TEXT_REPLACEMENTS_KO_TO_EN_RAW: tuple[tuple[str, str], ...] = (
     ("옵션", "Options"),
     ("계획 모드", "plan mode"),
     ("질문 모드", "ask mode"),
+    ("조사 모드", "research mode"),
     ("명령어 목록:", "Commands:"),
     ("메뉴와 프로젝트 상태를 확인합니다", "Show the menu and project status"),
     ("사용 가능한 명령어를 확인합니다", "Show available commands"),
@@ -233,6 +236,7 @@ _TEXT_REPLACEMENTS_KO_TO_EN_RAW: tuple[tuple[str, str], ...] = (
     ),
     ("계획 모드 메시지", "plan mode message"),
     ("질문 모드 메시지", "ask mode message"),
+    ("조사 모드 메시지", "research mode message"),
     ("로그인 흐름 검토", "review login flow"),
     ("역할 설명", "explain the role"),
     ("기본 모델 변경", "Change the default model"),
@@ -305,6 +309,7 @@ _TEXT_REPLACEMENTS_KO_TO_EN_RAW: tuple[tuple[str, str], ...] = (
     ("🤖 AGENTS 모드 (agent)", "🤖 AGENTS mode (agent)"),
     ("📐 Plan 모드 (plan)", "📐 Plan mode (plan)"),
     ("❓ Ask 모드 (ask)", "❓ Ask mode (ask)"),
+    ("🔎 Research 모드 (research)", "🔎 Research mode (research)"),
     ("🔧 Fix 모드 (fix)", "🔧 Fix mode (fix)"),
     ("💡 팁: 작업 결과에 reply 후 `fix: ...`를 보내면 그 커밋을 보완합니다.", "💡 Tip: Reply to a job result and send `fix: ...` to amend that commit."),
     ("등록 정보 없음", "not registered"),
@@ -376,14 +381,8 @@ _TEXT_REPLACEMENTS_KO_TO_EN_RAW: tuple[tuple[str, str], ...] = (
     ("기억 저장소가 설정되지 않았습니다.", "Memory storage is not configured."),
     ("현재 할 작업을 확인하세요.", "Confirm the work to run."),
     ("실행 여부를 선택하세요.", "Choose whether to run it."),
-    (
-        "실행하려면 `y` 또는 `Y`를 입력하세요. "
-        "새 자연어 요청으로 이 확인을 바꿀 수 있습니다. "
-        "파싱되지 않는 입력은 대기 작업이 취소됩니다.",
-        "Send `y` or `Y` to run. Another natural-language request replaces this confirmation. "
-        "Unparseable input cancels the pending request.",
-    ),
-    ("실행하려면 `y` 또는 `Y`를 입력하세요. 그 외 응답은 취소됩니다.", "Send `y` or `Y` to run it. Any other response cancels it."),
+    ("인라인 Yes/No 버튼으로 확인한 뒤 작업이 접수됩니다.", "A job is accepted after confirmation with inline Yes/No buttons."),
+    ("인라인 Yes/No 버튼으로 작업 실행 여부를 선택하세요.", "Choose whether to run with inline Yes/No buttons."),
     ("작업 요청을 취소했습니다.", "Cancelled the work request."),
     ("알 수 없는 clear 작업입니다.", "Unknown clear action."),
     ("봇에 연결된 프로젝트가 없거나 레지스트리에서 찾을 수 없습니다.", "No project is bound to this bot or found in the registry."),
@@ -413,6 +412,7 @@ _TEXT_REPLACEMENTS_KO_TO_EN_RAW: tuple[tuple[str, str], ...] = (
     ("로컬 브랜치가 없습니다:", "No local branch:"),
     ("plan 모드로 실행할 작업 지시문을 보내주세요.", "Send the instruction to run in plan mode."),
     ("ask 모드로 실행할 질문을 보내주세요.", "Send the question to run in ask mode."),
+    ("research 모드로 실행할 조사 질문을 보내주세요.", "Send the research question to run in research mode."),
     ("읽기 전용 · 커밋·push 없음", "read-only — no commit/push"),
     ("코드 수정·커밋·push 가능", "allows edit, commit, and push"),
     ("요청 브랜치", "Requested branch"),
@@ -512,6 +512,16 @@ _MESSAGE_CATALOG_KO: dict[str, str] = {
         "원격 브랜치 `{branch}`를 `{remote}`에서 찾을 수 없습니다. "
         "Job 완료 후 삭제되었을 수 있습니다."
     ),
+    "pr.gh_missing": (
+        "/pr 실패: GitHub CLI(gh)가 설치되어 있지 않거나 PATH에서 찾을 수 없습니다.\n\n"
+        "Telegram에서 PR을 만들려면 다음 순서로 준비하세요.\n"
+        "1. GitHub CLI 설치:\n"
+        "   - macOS: `brew install gh`\n"
+        "   - Windows: `winget install --id GitHub.cli`\n"
+        "   - Ubuntu/Debian: `sudo apt install gh`\n"
+        "2. GitHub 로그인: `gh auth login`\n"
+        "3. Remote AI Coder 재시작: `remote-coder up`"
+    ),
     "job.heartbeat": "{accepted}\n\n⏳ 실행 중 ({minutes}분 경과)",
     "job.cancelled": "{mode_prefix}⛔ 작업 중단됨\n\n- Job ID: {job_id}{session_line}\n- 프로젝트: {project}",
     "job.readonly_completed": (
@@ -634,6 +644,7 @@ _BUTTON_LABELS = {
     "AGENTS mode": "AGENTS 모드",
     "PLAN mode": "PLAN 모드",
     "ASK mode": "ASK 모드",
+    "RESEARCH mode": "RESEARCH 모드",
 }