appback-remoteagent 0.14.6 → 0.15.0

package/dist/adapters/runtime-env.js

@@ -0,0 +1,26 @@
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const CHILD_ENV_BLOCKED_PREFIXES = ["TELEGRAM_"];
+export function buildProviderEnv(extraEnv) {
+    const env = { ...process.env };
+    for (const key of Object.keys(env)) {
+        if (CHILD_ENV_BLOCKED_PREFIXES.some((prefix) => key.startsWith(prefix))) {
+            delete env[key];
+        }
+    }
+    const dataDir = process.env.REMOTEAGENT_DATA_DIR?.trim()
+        || process.env.DATA_DIR?.trim()
+        || path.join(os.homedir(), ".remoteagent");
+    env.DATA_DIR = dataDir;
+    env.REMOTEAGENT_DATA_DIR = dataDir;
+    env.REMOTEAGENT_SECRET_BIN = resolveSecretHelperPath();
+    if (extraEnv) {
+        Object.assign(env, extraEnv);
+    }
+    return env;
+}
+function resolveSecretHelperPath() {
+    const adapterDir = path.dirname(fileURLToPath(import.meta.url));
+    return path.resolve(adapterDir, "..", "secret-helper.js");
+}

package/dist/adapters/shell-adapter.js

@@ -1,6 +1,6 @@
-import process from "node:process";
 import { promisify } from "node:util";
 import { exec as execCallback } from "node:child_process";
+import { buildProviderEnv } from "./runtime-env.js";
 const exec = promisify(execCallback);
 export class ShellAdapter {
     provider;
@@ -12,8 +12,7 @@ export class ShellAdapter {
         this.timeoutMs = timeoutMs;
     }
     async send(request) {
-        const env = {
-            ...process.env,
+        const env = buildProviderEnv({
             BRIDGE_PROVIDER: this.provider,
             BRIDGE_BOT_ID: request.botId ?? "",
             BRIDGE_CHAT_ID: request.chatId,
@@ -21,7 +20,7 @@ export class ShellAdapter {
             BRIDGE_PUBLIC_SESSION_ID: request.publicSessionId ?? "",
             BRIDGE_CWD: request.cwd,
             BRIDGE_MESSAGE: request.message,
-        };
+        });
         const { stdout, stderr } = await exec(this.command, {
             env,
             timeout: this.currentTimeoutMs(),

package/dist/adapters/windows-shell.js

@@ -1,34 +1,17 @@
 import process from "node:process";
-import path from "node:path";
-import os from "node:os";
 import { execFile, spawn } from "node:child_process";
+import { buildProviderEnv } from "./runtime-env.js";
 const activeCommands = new Map();
-const CHILD_ENV_BLOCKED_PREFIXES = ["TELEGRAM_"];
-function buildChildEnv(extraEnv) {
-    const env = { ...process.env };
-    for (const key of Object.keys(env)) {
-        if (CHILD_ENV_BLOCKED_PREFIXES.some((prefix) => key.startsWith(prefix))) {
-            delete env[key];
-        }
-    }
-    const dataDir = process.env.DATA_DIR?.trim() || path.join(os.homedir(), ".remoteagent");
-    env.REMOTEAGENT_DATA_DIR = dataDir;
-    env.REMOTEAGENT_SECRET_BIN = path.resolve(process.cwd(), "dist", "secret-helper.js");
-    if (extraEnv) {
-        Object.assign(env, extraEnv);
-    }
-    return env;
-}
 export function spawnWithPlatformShell(bin, args, cwd, timeoutMs, input, executionKey, extraEnv) {
     return new Promise((resolve, reject) => {
         const command = process.platform === "win32"
             ? spawn("cmd.exe", ["/d", "/c", "call", bin, ...args], {
                 cwd,
-                env: buildChildEnv(extraEnv),
+                env: buildProviderEnv(extraEnv),
             })
             : spawn(bin, args, {
                 cwd,
-                env: buildChildEnv(extraEnv),
+                env: buildProviderEnv(extraEnv),
                 detached: true,
             });
         if (executionKey) {

package/dist/bot.js

@@ -18,6 +18,7 @@ const HELP_TEXT = [
     "/list [-a]",
     "/new",
     "/switch <session>",
+    "/plan <count>",
     "/batch start|send|cancel|status",
     "/attach codex <thread_id>",
     "/attach claude <session_id>",
@@ -29,7 +30,8 @@ const HELP_TEXT = [
     "/state [clear|note <text>]",
     "/artifacts list|cleanup <days>",
     "/secret set|list|remove",
-    "/docs pin|find|list|remove",
+    "/docs pin|find|list|remove|reinforce",
+    "/보강 <count>",
     "/bots",
     "/bot add <token>",
     "/bot doctor",
@@ -70,6 +72,7 @@ const RECOGNIZED_COMMANDS = new Set([
     "list",
     "new",
     "switch",
+    "plan",
     "batch",
     "attach",
     "model",
@@ -258,6 +261,19 @@ export function createBot(token, bridge, botManagement, botInfo) {
             throw error;
         }
     };
+    const runPlanDocumentReinforcement = async (ctx, count) => {
+        if (!ctx.chat) {
+            throw new Error("Telegram chat context is missing.");
+        }
+        const botId = getBotId();
+        const chatId = String(ctx.chat.id);
+        await bridge.logSystem(botId, chatId, `Plan document reinforcement requested (${count} turns max).`);
+        await runWithPendingAnimation(token, ctx.chat.id, async (helpers) => {
+            return {
+                chunks: await routeTelegramWorkLoop(bridge, botId, chatId, formatPlanDocumentReinforcementPrompt(count), "Plan document reinforcement", botManagement, helpers, autoContinue, memoryService, (blocks) => blocks, { maxTurns: count }),
+            };
+        });
+    };
     bot.use(async (ctx, next) => {
         const updateKind = Object.keys(ctx.update).join(",");
         const text = ctx.message?.text ?? ctx.editedMessage?.text ?? ctx.channelPost?.text ?? "";
@@ -365,6 +381,19 @@ ${bridge.formatStatus(mapping)}`);
         }
         await reply(ctx, `Switched this chat to session ${sessionId}.\n\n${bridge.formatCurrentSession(mapping)}`);
     });
+    bot.command("plan", async (ctx) => {
+        const { args, rest } = parseCommand(ctx.message?.text, 1);
+        if (rest?.trim()) {
+            await reply(ctx, "Usage: `/plan <1-10>`", { parse_mode: "Markdown" });
+            return;
+        }
+        const parsed = parsePlanReinforcementCount(args[0]?.trim());
+        if (parsed.kind === "invalid") {
+            await reply(ctx, "Usage: `/plan <1-10>`", { parse_mode: "Markdown" });
+            return;
+        }
+        await runPlanDocumentReinforcement(ctx, parsed.count);
+    });
     bot.command("batch", async (ctx) => {
         const botId = getBotId();
         const chatId = String(ctx.chat.id);
@@ -649,6 +678,19 @@ ${bridge.formatStatus(mapping)}`);
         const { args, rest } = parseCommand(ctx.message?.text, 2);
         const action = args[0]?.toLowerCase() || "list";
         const keyword = args[1]?.trim();
+        if (action === "reinforce") {
+            if (rest?.trim()) {
+                await reply(ctx, "Usage: `/docs reinforce <1-10>`", { parse_mode: "Markdown" });
+                return;
+            }
+            const parsed = parsePlanReinforcementCount(keyword);
+            if (parsed.kind === "invalid") {
+                await reply(ctx, "Usage: `/docs reinforce <1-10>`", { parse_mode: "Markdown" });
+                return;
+            }
+            await runPlanDocumentReinforcement(ctx, parsed.count);
+            return;
+        }
         if (action === "list") {
             await reply(ctx, await memoryService.listDocuments());
             return;
@@ -681,7 +723,7 @@ ${bridge.formatStatus(mapping)}`);
             await reply(ctx, removed ? `Removed docs keyword ${keyword}.` : `Docs keyword was not found: ${keyword}`);
             return;
         }
-        await reply(ctx, "Usage: `/docs list`, `/docs find <keyword>`, `/docs pin <keyword> <path>`, or `/docs remove <keyword>`", { parse_mode: "Markdown" });
+        await reply(ctx, "Usage: `/docs list`, `/docs find <keyword>`, `/docs pin <keyword> <path>`, `/docs remove <keyword>`, or `/docs reinforce <1-10>`", { parse_mode: "Markdown" });
     });
     bot.command("bots", async (ctx) => {
         await ensureOwnerControlAccess(ctx);
@@ -799,6 +841,15 @@ ${bridge.formatStatus(mapping)}`);
         const voice = ctx.message.voice;
         const audio = ctx.message.audio;
         const text = ctx.message.text?.trim();
+        const planReinforcement = parseKoreanPlanReinforcementCommand(text, botId);
+        if (planReinforcement.kind === "matched") {
+            await runPlanDocumentReinforcement(ctx, planReinforcement.count);
+            return;
+        }
+        if (planReinforcement.kind === "invalid") {
+            await reply(ctx, "Usage: `/보강 <1-10>`", { parse_mode: "Markdown" });
+            return;
+        }
         if (text && isRecognizedSlashCommand(text, botId)) {
             return;
         }
@@ -1130,7 +1181,7 @@ async function runWithPendingAnimation(botToken, chatId, task) {
         }
     }
 }
-async function routeTelegramWorkLoop(bridge, botId, chatId, message, label, botManagement, helpers, autoContinue, memoryService, transform = (blocks) => blocks) {
+async function routeTelegramWorkLoop(bridge, botId, chatId, message, label, botManagement, helpers, autoContinue, memoryService, transform = (blocks) => blocks, options = {}) {
     const currentSession = await bridge.status(botId, chatId);
     const sessionId = currentSession?.session.sessionId;
     const activeKey = workLoopKey(botId, chatId, sessionId);
@@ -1151,7 +1202,7 @@ async function routeTelegramWorkLoop(bridge, botId, chatId, message, label, botM
         : "";
     autoContinue.clear(botId, chatId, sessionId);
     let prompt = appendManagedContext(appendReportProtocol(message), managedContext);
-    const maxTurns = config.telegramAutoProgressMaxTurns;
+    const maxTurns = options.maxTurns ?? config.telegramAutoProgressMaxTurns;
     const emptyResponseRetries = config.telegramEmptyResponseRetries;
     const retryableErrorRetries = config.telegramRetryableErrorRetries;
     const retryableErrorDelayMs = config.telegramRetryableErrorDelayMs;
@@ -1683,6 +1734,57 @@ function parseCommand(text, headCount) {
         rest: remaining || undefined,
     };
 }
+function parsePlanReinforcementCount(raw) {
+    const value = raw?.trim();
+    if (!value) {
+        return { kind: "valid", count: 5 };
+    }
+    if (!/^\d+$/.test(value)) {
+        return { kind: "invalid" };
+    }
+    const count = Number(value);
+    if (!Number.isInteger(count) || count < 1 || count > 10) {
+        return { kind: "invalid" };
+    }
+    return { kind: "valid", count };
+}
+function parseKoreanPlanReinforcementCommand(text, botId) {
+    const trimmed = text?.trim();
+    if (!trimmed?.startsWith("/")) {
+        return { kind: "none" };
+    }
+    const [commandToken, maybeCount, ...extra] = trimmed.slice(1).split(/\s+/);
+    const [name, mention] = commandToken.split("@", 2);
+    if (name !== "보강") {
+        return { kind: "none" };
+    }
+    if (mention && mention.toLowerCase() !== botId.toLowerCase()) {
+        return { kind: "none" };
+    }
+    if (extra.length > 0) {
+        return { kind: "invalid" };
+    }
+    const parsed = parsePlanReinforcementCount(maybeCount);
+    return parsed.kind === "valid" ? { kind: "matched", count: parsed.count } : { kind: "invalid" };
+}
+function formatPlanDocumentReinforcementPrompt(count) {
+    return [
+        `계획문서를 처음부터 끝까지 확인하고, 최대 ${count}회까지만 보강 루프를 수행하세요.`,
+        "",
+        "반복 절차:",
+        "1. 계획문서와 관련 문서를 실제로 읽고 보강할 내용이 있는지 판단하세요.",
+        "2. 보강할 내용이 있으면 직접 문서를 수정하세요.",
+        "3. 수정 후 같은 기준으로 다시 점검하세요.",
+        `4. 더 이상 보강할 내용이 없거나 ${count}회에 도달하면 종료하세요.`,
+        "",
+        "중요 규칙:",
+        "- 추정하지 말고 실제 파일 경로와 확인 근거를 남기세요.",
+        "- 같은 보강을 반복하지 마세요.",
+        "- 보강할 내용이 없으면 없다고 보고하고 종료하세요.",
+        "- 권한, 정보, 파일 위치가 부족하면 REPORT:blocked로 정확한 blocker를 말하세요.",
+        "- 완료 시 확인한 문서, 변경한 문서, 남은 위험, 검증 결과를 짧게 보고하세요.",
+    ].join("\n");
+}
 function commandTarget(args, rest) {
     return (rest?.trim() || args.slice(1).join(" ").trim() || args[0]?.trim() || "");
 }

package/dist/telegram-command-menu.js

@@ -6,6 +6,7 @@ export const TELEGRAM_COMMAND_MENU = [
     { command: "list", description: "List sessions" },
     { command: "new", description: "Start a fresh session" },
     { command: "switch", description: "Switch to a session" },
+    { command: "plan", description: "Reinforce planning documents" },
     { command: "status", description: "Show current session status" },
     { command: "attach", description: "Attach an existing provider session" },
     { command: "state", description: "Show or edit session state notes" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appback-remoteagent",
-  "version": "0.14.6",
+  "version": "0.15.0",
   "description": "Personal installable session server for continuing local AI work across PC and Telegram",
   "license": "MIT",
   "type": "module",