agentlas 0.5.2 → 0.6.0

package/engine/agentlas-repl.cjs

@@ -16,6 +16,7 @@ const caps = require("./agentlas-capabilities.cjs");
 const input = require("./agentlas-input.cjs");
 const i18n = require("./agentlas-i18n.cjs");
 const style = require("./agentlas-style.cjs");
+const permissions = require("./agentlas-permissions.cjs");
 
 function runtimeLabel(rt) {
   if (!rt) return "(none)";
@@ -56,6 +57,8 @@ function makeMemoryGuard(ui, heading) {
   };
   return {
     c: ui.c,
+    lang: ui.lang,
+    t: (...a) => ui.t(...a),
     streamStart: () => ui.streamStart(),
     streamDelta: (t) => {
       if (cut) {
@@ -89,6 +92,9 @@ function makeMemoryGuard(ui, heading) {
     ok: (...a) => ui.ok(...a),
     cost: (...a) => ui.cost(...a),
     line: (...a) => ui.line(...a),
+    applyTaskTool: (...a) => ui.applyTaskTool(...a),
+    applyTaskResult: (...a) => ui.applyTaskResult(...a),
+    replaceTasks: (...a) => ui.replaceTasks(...a),
   };
 }
 
@@ -111,10 +117,13 @@ function makeStyleGuard(ui) {
   };
   return {
     c: ui.c,
+    lang: ui.lang,
+    t: (...a) => ui.t(...a),
     streamStart: () => {
       buf = "";
       inCode = false;
-      ui.streamStart();
+      // This guard emits complete lines, so the persistent turn footer can safely stay visible.
+      ui.streamStart(true);
     },
     streamDelta: (text) => {
       if (!text) return;
@@ -143,6 +152,9 @@ function makeStyleGuard(ui) {
     cost: (...a) => ui.cost(...a),
     line: (...a) => ui.line(...a),
     stopSpinner: (...a) => ui.stopSpinner(...a),
+    applyTaskTool: (...a) => ui.applyTaskTool(...a),
+    applyTaskResult: (...a) => ui.applyTaskResult(...a),
+    replaceTasks: (...a) => ui.replaceTasks(...a),
   };
 }
 
@@ -157,7 +169,7 @@ function startRepl(opts) {
   const state = {
     subject: opts.subject || null,
     runtime: opts.runtime,
-    permission: opts.permission || "write",
+    permission: opts.permission == null ? "write" : permissions.normalize(opts.permission),
     cwd: opts.cwd,
     history: [],
     native: {}, // kind → { id }
@@ -197,6 +209,7 @@ function startRepl(opts) {
   let closed = false;
   let currentAbort = null;
   let idleExitArmedUntil = 0;
+  const permissionCycle = permissions.createCycleController();
   rl.on("close", () => {
     if (handoff) return; // intentionally closed to hand stdin to the raw-mode composer
     closed = true;
@@ -235,6 +248,19 @@ function startRepl(opts) {
     return { projectPath: state.projectPath, agentId: state.subject && state.subject.id, permission: state.permission, cwd: state.cwd, lang: ui.lang };
   }
 
+  function setPermission(value, options = {}) {
+    const notify = options.notify !== false;
+    const persist = options.persist !== false;
+    const level = permissions.normalize(value);
+    state.permission = level;
+    if (persist) {
+      prefs.permission = level;
+      if (opts.savePrefs) opts.savePrefs(prefs);
+    }
+    if (notify) ui.ok(ui.t("permSet", level));
+    return level;
+  }
+
   // Session usage ledger — accumulate per runtime label (host advantage: no single-model CLI can show this).
   function recordCost(label, usage) {
     const e = state.cost[label] || (state.cost[label] = { turns: 0, in: 0, out: 0, cost: 0, ms: 0 });
@@ -270,22 +296,28 @@ function startRepl(opts) {
   // ── run one turn ──
   async function runTurn(prompt, runOptions = {}) {
     busy = true;
-    ui.beginTurn(); // 라이브 경과시간 스피너의 턴 시작점
     currentAbort = new AbortController();
     const signal = currentAbort.signal;
-    const recordHistoryEntry = !runOptions.side;
-    const targetLang = H.detectResponseLanguage ? H.detectResponseLanguage(prompt, ui.lang) : ui.lang;
-    const ctx = { ...ctxNow(), lang: targetLang, uiLang: ui.lang };
-    const rt = state.runtime;
-    const costLabel = runtimeLabel(rt);
-    const runEnv = H.buildChildEnv ? await H.buildChildEnv(db, { ...ctx, cwd: state.cwd }) : process.env;
-    Object.assign(process.env, runEnv);
-    ui._lastUsage = null;
-    const assistantUi = makeStyleGuard(ui);
-    const thinkingText = i18n.t(targetLang, "thinkingWith", costLabel);
-    ui.info(thinkingText);
-    ui.status(thinkingText);
     try {
+      ui.beginTurn({
+        ...composerMeta(),
+        usage: () => usageSummaryLine(), // 턴 중에도 최신 사용량을 footer에 라이브 반영
+        onInterrupt: () => {
+          if (!currentAbort || currentAbort.signal.aborted) return;
+          currentAbort.abort();
+          ui.warn(ui.t("interrupted"));
+        },
+      }); // 작업 중에도 composer/status bar와 실제 runtime task 목록을 화면 하단에 유지
+      const recordHistoryEntry = !runOptions.side;
+      const targetLang = H.detectResponseLanguage ? H.detectResponseLanguage(prompt, ui.lang) : ui.lang;
+      const ctx = { ...ctxNow(), lang: targetLang, uiLang: ui.lang };
+      const rt = state.runtime;
+      const costLabel = runtimeLabel(rt);
+      const runEnv = H.buildChildEnv ? await H.buildChildEnv(db, { ...ctx, cwd: state.cwd }) : process.env;
+      ui._lastUsage = null;
+      const assistantUi = makeStyleGuard(ui);
+      const thinkingText = i18n.t(targetLang, "thinkingWith", costLabel);
+      ui.status(thinkingText);
       if (rt.mode === "cli") {
         const bin = H.which(H.RUNTIME_BIN[rt.kind]) || H.RUNTIME_BIN[rt.kind];
         const session = state.native[rt.kind] || (state.native[rt.kind] = {});
@@ -305,7 +337,7 @@ function startRepl(opts) {
           model: rt.model || null, // /model (claude --model, codex -m, gemini -m)
           effort: state.effort || null, // /effort (codex reasoning effort, claude think-keyword)
           mcpServers:
-            (state.permission === "write" || state.permission === "full") && H.mcpServers
+            state.permission === "full" && H.mcpServers
               ? H.mcpServers(db).filter((s) => s.enabled && s.transport === "stdio")
               : [],
           env: runEnv,
@@ -341,7 +373,7 @@ function startRepl(opts) {
           apiKey,
           system: sys,
           messages,
-          ctx,
+          ctx: { ...ctx, env: runEnv },
           ui: guard,
           signal,
         });
@@ -435,6 +467,23 @@ function startRepl(opts) {
     state.routePreambleOnce = null;
     applyRuntimeFor(state.subject);
   }
+  // 직답 모드 — 전문 에이전트 확신이 없을 때. 페르소나 없음 + 능력(이미지) 라우팅 없음:
+  // 런타임은 세션 기본(baseRuntime) 그대로라, 일반 질문이 gemini 등으로 끌려가지 않는다.
+  function setSubjectDirect() {
+    if (state.subject && state.subject.kind === "direct") return; // 연속 직답 — 세션/히스토리 유지
+    state.subject = {
+      kind: "direct",
+      id: null,
+      slug: "agentlas-direct",
+      label: ui.lang === "ko" ? "Agentlas 직답" : "Agentlas direct",
+      system: H.directSystemPrompt ? H.directSystemPrompt(ui.lang) : "You are the Agentlas terminal's default assistant.",
+      capAgent: null,
+    };
+    state.history = [];
+    state.routePreambleOnce = null;
+    state.runtime = baseRuntime;
+    state.native = {};
+  }
   function setSubjectFirm(firm) {
     const sys = H.firmSystemPrompt(db, firm);
     state.subject = {
@@ -551,8 +600,8 @@ function startRepl(opts) {
 
   function printSlashSkills() {
     ui.line("");
-    ui.rule("Skills");
-    for (const entry of input.slashCommandEntries()) {
+    ui.rule(ui.t("skills.title"));
+    for (const entry of input.slashCommandEntries(ui.lang)) {
       const tag = entry.category ? ui.c.faint(entry.category.padEnd(10)) : "";
       ui.line("  " + ui.c.emerald(entry.command.padEnd(18)) + tag + ui.c.dim(entry.description));
       if (!entry.aliasOf && entry.usage) ui.line("  " + ui.c.faint(" ".repeat(18) + entry.usage));
@@ -561,14 +610,10 @@ function startRepl(opts) {
 
   function printPermissions() {
     ui.line("");
-    ui.rule("Permissions");
-    ui.line("  " + ui.c.faint("Current") + "  " + ui.c.emerald(state.permission));
-    const rows = [
-      ["read", "inspect files and answer; no file writes or shell automation"],
-      ["write", "read plus create/edit files in the current work area"],
-      ["full", "write plus shell commands and external local automation"],
-    ];
-    for (const [level, description] of rows) {
+    ui.rule(ui.t("permissions.title"));
+    ui.line("  " + ui.c.faint(ui.t("permissions.current")) + "  " + ui.c.emerald(state.permission));
+    for (const level of permissions.LEVELS) {
+      const description = permissions.copy(level, ui.lang).description;
       const mark = level === state.permission ? "› " : "  ";
       ui.line("  " + ui.c.emerald((mark + level).padEnd(10)) + ui.c.dim(description));
     }
@@ -633,7 +678,8 @@ function startRepl(opts) {
     ui.tool("$ " + cmd);
     const r = spawnSync("bash", ["-lc", cmd], { cwd: state.cwd, encoding: "utf8", timeout: 120000, maxBuffer: 8 * 1024 * 1024 });
     const out = ((r.stdout || "") + (r.stderr || "")).trim();
-    ui.toolResult(out || ("exit " + (r.status == null ? "?" : r.status)), r.status === 0 || r.status == null);
+    // `!command` is explicit user output, unlike autonomous runtime traces: keep it inspectable.
+    ui.toolResult(out || ("exit " + (r.status == null ? "?" : r.status)), r.status === 0 || r.status == null, { verbose: true });
   }
 
   // @path — inline the contents of mentioned files into the prompt as fenced context.
@@ -693,6 +739,31 @@ function startRepl(opts) {
       case "runtime":
         setRuntime(arg);
         return true;
+      case "config":
+      case "toggles": {
+        // 클로드코드 /config 스타일 — 자동 엔진 개입은 전부 명시적 opt-in (기본 off).
+        const ENGINE_FLAGS = [
+          { key: "storm", pref: "autoStorm", label: ui.t("config.storm") },
+          { key: "network", pref: "autoNetwork", label: ui.t("config.network") },
+        ];
+        const showConfig = () => {
+          ui.line("");
+          ui.rule(ui.t("config.title"));
+          for (const f of ENGINE_FLAGS) {
+            const on = !!prefs[f.pref];
+            ui.line("  " + (on ? ui.c.green("● on ") : ui.c.dim("○ off")) + "  " + ui.c.emerald(f.key.padEnd(9)) + ui.c.dim(f.label));
+          }
+          ui.line("  " + ui.c.faint(ui.t("config.usage")));
+        };
+        const [cfgKey, cfgVal] = arg.trim().split(/\s+/);
+        if (!cfgKey) return showConfig(), true;
+        const flag = ENGINE_FLAGS.find((f) => f.key === cfgKey.toLowerCase());
+        if (!flag || !/^(on|off)$/i.test(cfgVal || "")) return ui.warn(ui.t("config.usage")), true;
+        prefs[flag.pref] = /^on$/i.test(cfgVal);
+        if (opts.savePrefs) opts.savePrefs(prefs);
+        ui.ok(ui.t("config.set", flag.key, prefs[flag.pref] ? "on" : "off"));
+        return showConfig(), true;
+      }
       case "storm": {
         if (!arg) return ui.warn("usage: /storm <goal>  [--research]"), true;
         let goal = arg;
@@ -801,16 +872,14 @@ function startRepl(opts) {
           return true;
         }
         if (!["read", "write", "full"].includes(p)) return ui.warn(ui.t("permUsage")), true;
-        state.permission = p;
-        ui.ok(ui.t("permSet", p));
+        setPermission(p);
         return true;
       }
       case "permissions":
         if (arg) {
           const p = (arg || "").toLowerCase();
           if (!["read", "write", "full"].includes(p)) return ui.warn(ui.t("permUsage")), true;
-          state.permission = p;
-          ui.ok(ui.t("permSet", p));
+          setPermission(p);
         } else {
           printPermissions();
         }
@@ -913,10 +982,7 @@ function startRepl(opts) {
         const servers = H.mcpServers ? H.mcpServers(db) : [];
         ui.line("");
         ui.rule("MCP");
-        if (!servers.length) {
-          ui.info(ui.t("mcp.none"));
-          return true;
-        }
+        ui.line("   " + ui.c.emerald(ui.t("mcp.playwright").padEnd(22)) + ui.c.blue("stdio  ") + ui.c.green("on ") + ui.c.dim("  " + ui.t("mcp.fullOnly")));
         for (const s of servers) {
           let envKeys = [];
           try { envKeys = JSON.parse(s.env_keys_json || "[]"); } catch { /* ignore */ }
@@ -925,7 +991,7 @@ function startRepl(opts) {
           const envStr = envKeys.length ? envKeys.join(", ") : "no key";
           ui.line("   " + ui.c.emerald(String(name).padEnd(22)) + ui.c.blue(String(s.transport || "").padEnd(7)) + on + ui.c.dim("  " + envStr));
         }
-        const wired = servers.filter((s) => s.enabled && s.transport === "stdio").length + 1; // +1 = playwright(항상)
+        const wired = servers.filter((s) => s.enabled && s.transport === "stdio").length + 1; // +1 = full-only Playwright
         ui.line("   " + ui.c.faint(ui.t("mcp.wired", String(wired))));
         ui.line("   " + ui.c.faint(ui.t("mcp.usage")));
         return true;
@@ -953,8 +1019,13 @@ function startRepl(opts) {
         const s = n >= 1 && n <= list.length ? list[n - 1] : null;
         if (!s) return ui.warn(ui.t("resume.noNum")), true;
         const agent = H.resolveAgent(db, s.agentSlug);
-        if (!agent) return ui.error(ui.t("noAgent", s.agentSlug)), true;
-        setSubjectAgent(agent);
+        if (agent) {
+          setSubjectAgent(agent);
+        } else if (s.agentSlug === "agentlas-direct") {
+          setSubjectDirect(); // 직답 세션도 이어서 재개
+        } else {
+          return ui.error(ui.t("noAgent", s.agentSlug)), true;
+        }
         if (s.kind && H.RUNTIME_BIN[s.kind] && H.which(H.RUNTIME_BIN[s.kind])) {
           state.runtime = { mode: "cli", kind: s.kind };
           baseRuntime = state.runtime;
@@ -1074,10 +1145,14 @@ function startRepl(opts) {
       if (H.autoRouteAgent) {
         const choice = H.autoRouteAgent(db, t, ui.lang);
         if (choice) {
-          setSubjectAgent(choice.agent);
+          if (choice.direct) {
+            setSubjectDirect();
+          } else {
+            setSubjectAgent(choice.agent);
+          }
           state.routePreambleOnce = H.autoRoutePreamble ? H.autoRoutePreamble(choice, ui.lang) : null;
-          ui.info(H.autoRouteNote ? H.autoRouteNote(choice, ui.lang) : `auto-routed to ${choice.agent.name}`);
-          routingNote(state.subject);
+          ui.info(H.autoRouteNote ? H.autoRouteNote(choice, ui.lang) : `auto-routed to ${state.subject.label}`);
+          if (!choice.direct) routingNote(state.subject);
           await runTurn(t);
           return ask();
         }
@@ -1097,53 +1172,143 @@ function startRepl(opts) {
       await handleSlash(t); // /exit 는 내부에서 process.exit
       return;
     }
-    if (!state.subject) {
-      const ags = H.listAgents(db);
-      const single = !/\s/.test(t);
-      if (/^\d+$/.test(t)) {
-        const n = parseInt(t, 10);
-        if (n >= 1 && n <= ags.length) {
-          setSubjectAgent(ags[n - 1]);
-          ui.ok(ui.t("switched", state.subject.label));
-          routingNote(state.subject);
-          return;
+    // 직답 모드는 대상 고정이 아니라 "자동 라우팅 유지" — 매 메시지 재라우팅해,
+    // 나중에 전문 요청이 오면 해당 에이전트로 자연스럽게 넘어간다.
+    const directMode = !!(state.subject && state.subject.kind === "direct");
+    if (!state.subject || directMode) {
+      if (!state.subject) {
+        const ags = H.listAgents(db);
+        const single = !/\s/.test(t);
+        if (/^\d+$/.test(t)) {
+          const n = parseInt(t, 10);
+          if (n >= 1 && n <= ags.length) {
+            setSubjectAgent(ags[n - 1]);
+            ui.ok(ui.t("switched", state.subject.label));
+            routingNote(state.subject);
+            return;
+          }
+        }
+        if (single) {
+          const a = H.resolveAgent(db, t);
+          if (a) { setSubjectAgent(a); ui.ok(ui.t("switched", state.subject.label)); routingNote(state.subject); return; }
+          const f = H.resolveFirm(db, t);
+          if (f) { setSubjectFirm(f); ui.ok(ui.t("switched", state.subject.label)); routingNote(state.subject); return; }
         }
-      }
-      if (single) {
-        const a = H.resolveAgent(db, t);
-        if (a) { setSubjectAgent(a); ui.ok(ui.t("switched", state.subject.label)); routingNote(state.subject); return; }
-        const f = H.resolveFirm(db, t);
-        if (f) { setSubjectFirm(f); ui.ok(ui.t("switched", state.subject.label)); routingNote(state.subject); return; }
       }
       if (H.autoRouteAgent) {
         const choice = H.autoRouteAgent(db, t, ui.lang);
         if (choice) {
-          setSubjectAgent(choice.agent);
-          state.routePreambleOnce = H.autoRoutePreamble ? H.autoRoutePreamble(choice, ui.lang) : null;
-          ui.info(H.autoRouteNote ? H.autoRouteNote(choice, ui.lang) : `auto-routed to ${choice.agent.name}`);
-          routingNote(state.subject);
+          if (choice.direct) {
+            setSubjectDirect();
+            if (!directMode) {
+              // 첫 직답 진입에만 알림 — 연속 직답 대화에서는 조용히.
+              state.routePreambleOnce = H.autoRoutePreamble ? H.autoRoutePreamble(choice, ui.lang) : null;
+              ui.info(H.autoRouteNote ? H.autoRouteNote(choice, ui.lang) : `direct answer (no agent)`);
+            }
+          } else {
+            setSubjectAgent(choice.agent);
+            state.routePreambleOnce = H.autoRoutePreamble ? H.autoRoutePreamble(choice, ui.lang) : null;
+            ui.info(H.autoRouteNote ? H.autoRouteNote(choice, ui.lang) : `auto-routed to ${choice.agent.name}`);
+            routingNote(state.subject);
+          }
+        }
+      }
+      // 자동 엔진 개입은 명시적 opt-in 전용 (/config, 기본 off): direct 판정 + 실작업형 프롬프트일 때만.
+      if (state.subject && state.subject.kind === "direct" && goalLikePrompt(t)) {
+        if (prefs.autoStorm && H.stormRun) {
+          ui.info(ui.t("config.autoEngage", "stormbreaker", "storm"));
+          await H.stormRun(db, t, { ui, cwd: state.cwd, research: false });
+          return;
+        }
+        if (prefs.autoNetwork && H.hepRun) {
+          ui.info(ui.t("config.autoEngage", "hep-network", "network"));
+          ui.line("");
+          await H.hepRun(["hep-network", t, "--project", state.cwd, "--runtime", "terminal"], { cwd: state.cwd });
+          return;
         }
       }
     }
     await runTurn(expandMentions(t));
   }
 
+  // 실작업(goal)형 프롬프트 감지 — 질문/잡담에는 자동 엔진(storm/network)을 절대 걸지 않는다.
+  function goalLikePrompt(t) {
+    const s = String(t || "").trim();
+    if (s.length < 12) return false;
+    if (/[?？]\s*$/.test(s)) return false;
+    return /(해줘|해라|만들|구현|수정|배포|정리|작성|분석|리팩터|고쳐|추가|빌드|테스트|돌려|실행|자동화|automate|build|implement|fix|refactor|deploy|create|write|run|ship)/i.test(s);
+  }
+
+  // ── 연결 LLM 세션 사용량 요약 (챗 입력창 아래 상시 표시) ──
+  // 호스트 이점: 단일 모델 CLI는 못 보여주는 멀티 LLM 합산 사용량을 항상 노출한다.
+  function fmtTok(n) {
+    if (!n) return "0";
+    if (n >= 1e6) return (n >= 1e7 ? Math.round(n / 1e6) : (n / 1e6).toFixed(1)) + "m";
+    if (n >= 1e3) return (n >= 1e5 ? Math.round(n / 1e3) : (n / 1e3).toFixed(1)) + "k";
+    return String(n);
+  }
+  function usageSummaryLine() {
+    const shortLabel = (label) => (label === "claude-code" ? "claude" : label);
+    const labels = [];
+    const push = (label) => { if (label && label !== "(none)" && !labels.includes(label)) labels.push(label); };
+    for (const kind of installedKinds()) push(kind); // 연결(설치)된 CLI 런타임 — 미사용이어도 표시
+    push(runtimeLabel(state.runtime)); // 현재 런타임 (BYOK/Ollama 포함)
+    for (const label of Object.keys(state.cost)) push(label); // 세션 중 사용한 나머지
+    const parts = labels.map((label) => {
+      const e = state.cost[label];
+      if (!e) return `${shortLabel(label)} 0`;
+      if (e.in || e.out) return `${shortLabel(label)} ${fmtTok(e.in)}→${fmtTok(e.out)}`;
+      return `${shortLabel(label)} ${e.turns}${ui.lang === "ko" ? "턴" : "t"}`;
+    });
+    return `${ui.t("usageBar")}  ${parts.join(" · ")}`;
+  }
+
   // ── composer (raw-mode bottom box) main loop ──
-  function composerStatus() {
+  function composerMeta() {
     const rt = runtimeLabel(state.runtime);
     const subj = state.subject ? state.subject.label : ui.t("composer.autoroute");
     const eff = state.effort ? " · " + state.effort : "";
-    return `${rt} · ${state.permission}${eff} · ${subj} · ${ui.t("composer.hint")}`;
+    const permissionLabel = permissions.copy(state.permission, ui.lang).label;
+    return {
+      lang: ui.lang,
+      permission: state.permission,
+      permissionLabel,
+      status: `${rt}${eff} · ${subj} · ${ui.t("permCycleHint")} · ${ui.t("composer.hint")} · ↑↓ history`,
+      usage: usageSummaryLine(), // 챗 입력창 아래 상시 LLM 사용량 표시줄
+      onCyclePermission: () => {
+        const cycle = permissionCycle.step(state.permission);
+        if (cycle.armed) {
+          return {
+            ...composerMeta(),
+            confirmation: ui.t("permFullArm"),
+            confirmationTone: "danger",
+          };
+        }
+        const level = setPermission(cycle.level, { notify: false, persist: false });
+        return {
+          ...composerMeta(),
+          confirmation: cycle.enteredFull
+            ? ui.t("permFullConfirm")
+            : ui.t("permCycleConfirm", permissions.copy(level, ui.lang).label),
+          confirmationTone: cycle.enteredFull ? "danger" : "normal",
+        };
+      },
+      onPermissionCycleCancel: () => {
+        permissionCycle.cancel();
+        return { ...composerMeta(), confirmation: null, confirmationTone: null };
+      },
+    };
   }
   async function composerLoop() {
     let buffer = "";
     while (!closed) {
       let r;
       try {
+        const meta = composerMeta();
         r = await composer.read({
           glyph: buffer ? "…" : "›",
-          status: composerStatus(),
-          suggest: (l) => input.slashCommandSuggestions(l),
+          ...meta,
+          suggest: (l) => input.slashCommandSuggestions(l, 12, ui.lang),
           complete: completer,
         });
       } catch (e) {
@@ -1176,6 +1341,8 @@ function startRepl(opts) {
     if (closed) return process.exit(0);
     if (slashPalette.setEnabled) slashPalette.setEnabled(true);
     const cont = buffer != null;
+    // 클래식 모드에도 사용량 상시 표시 (composer 모드에선 입력박스 아래 줄이 담당)
+    if (!cont && !composer && Object.keys(state.cost).length) ui.line(ui.c.faint("  " + usageSummaryLine()));
     rl.question(cont ? ui.c.dim("   … ") : "\n" + ui.promptLabel(), async (line) => {
       if (input.isContinuation(line)) {
         return ask((cont ? buffer + "\n" : "") + input.stripContinuation(line));
@@ -1236,10 +1403,10 @@ function startRepl(opts) {
 function printHelp(ui) {
   const c = ui.c;
   ui.line("");
-  ui.rule("Help");
-  ui.line("  " + c.bold(c.text("Agentlas runs local agents from this terminal, with runtime, permission, files, shell, and history controls.")));
+  ui.rule(ui.t("help.title"));
+  ui.line("  " + c.bold(c.text(ui.t("help.intro"))));
   ui.line("");
-  ui.line("  " + c.faint("Commands"));
+  ui.line("  " + c.faint(ui.t("help.commands")));
   const rows = [
     [ui.t("help.talkKey"), ui.t("help.talk")],
     ["/skills", ui.t("help.skills")],
@@ -1297,10 +1464,12 @@ function printKeybindings(ui) {
     ["!cmd", ui.t("help.bang")],
     ["\\ + Enter", ui.t("help.multiline")],
     ["Tab", ui.t("help.tab")],
+    ["Shift-Tab", ui.t("help.shiftTab")],
+    ["Ctrl-T", ui.t("help.ctrlT")],
     ["Up / Down", ui.t("help.arrows")],
     ["Ctrl-C", ui.t("help.ctrlc")],
   ];
   for (const [k, v] of tips) ui.line("  " + c.emerald(k.padEnd(24)) + c.dim(v));
 }
 
-module.exports = { startRepl, runtimeLabel };
+module.exports = { startRepl, runtimeLabel, makeMemoryGuard, makeStyleGuard };

package/engine/agentlas-tasks.cjs

@@ -0,0 +1,111 @@
+"use strict";
+
+/* Normalize only task/todo events emitted by the native runtimes.
+ * Ordinary tool activity is intentionally excluded: a command is not a fabricated plan item.
+ */
+
+function statusOf(value, completed) {
+  if (completed === true) return "completed";
+  const status = String(value || "pending").trim().toLowerCase().replace(/[ -]+/g, "_");
+  if (["completed", "complete", "done", "success", "succeeded"].includes(status)) return "completed";
+  if (["in_progress", "active", "running", "started"].includes(status)) return "in_progress";
+  if (["failed", "error", "blocked", "cancelled", "canceled"].includes(status)) return "failed";
+  return "pending";
+}
+
+function listFrom(payload) {
+  if (Array.isArray(payload)) return payload;
+  if (!payload || typeof payload !== "object") return [];
+  for (const key of ["todos", "items", "tasks"]) {
+    if (Array.isArray(payload[key])) return payload[key];
+  }
+  return [];
+}
+
+function hasExplicitList(payload) {
+  if (Array.isArray(payload)) return true;
+  if (!payload || typeof payload !== "object") return false;
+  return ["todos", "items", "tasks"].some((key) => Array.isArray(payload[key]));
+}
+
+function sanitizeLabel(value, max = 500) {
+  let text = String(value || "");
+  // Runtime task text is untrusted terminal content. Strip OSC/CSI/escape controls,
+  // flatten line breaks, then cap it before it reaches footer row accounting.
+  text = text
+    .replace(/\x1b\][^\x07]*(?:\x07|\x1b\\)/g, "")
+    .replace(/\x1b\[[0-?]*[ -/]*[@-~]/g, "")
+    .replace(/\x1b./g, "")
+    .replace(/[\r\n\t]+/g, " ")
+    .replace(/[\x00-\x1f\x7f-\x9f]/g, "")
+    .replace(/\s+/g, " ")
+    .trim();
+  return Array.from(text).slice(0, max).join("");
+}
+
+function normalizeTaskList(payload, source = "runtime") {
+  return listFrom(payload).flatMap((raw, index) => {
+    if (!raw || typeof raw !== "object") return [];
+    const label = sanitizeLabel(raw.content || raw.subject || raw.description || raw.text || raw.title || raw.activeForm);
+    if (!label) return [];
+    return [{
+      id: String(raw.id || raw.taskId || `${source}:${index}`),
+      label,
+      status: statusOf(raw.status, raw.completed),
+      source,
+    }];
+  });
+}
+
+function applyTaskTool(current, name, payload, toolId) {
+  const tool = String(name || "").toLowerCase();
+  if (tool === "todowrite" || tool === "write_todos") {
+    return normalizeTaskList(payload, tool);
+  }
+
+  if (tool !== "taskcreate" && tool !== "taskupdate") return current;
+
+  const next = Array.isArray(current) ? current.map((task) => ({ ...task })) : [];
+  if (tool === "taskcreate") {
+    const label = sanitizeLabel(payload?.subject || payload?.description || payload?.activeForm);
+    if (!label) return next;
+    next.push({ id: String(payload?.taskId || toolId || `taskcreate:${next.length}`), label, status: "pending", source: "taskcreate" });
+    return next;
+  }
+  if (tool === "taskupdate") {
+    const id = String(payload?.taskId || toolId || "");
+    if (!id) return next;
+    if (String(payload?.status || "").toLowerCase() === "deleted") return next.filter((task) => task.id !== id);
+    const index = next.findIndex((task) => task.id === id);
+    const label = sanitizeLabel(payload?.subject || payload?.description || payload?.activeForm || (index >= 0 && next[index].label) || id);
+    const task = { id, label, status: statusOf(payload?.status), source: "taskupdate" };
+    if (index >= 0) next[index] = { ...next[index], ...task };
+    else next.push(task);
+  }
+  return next;
+}
+
+function applyTaskResult(current, name, payload, toolId) {
+  const tool = String(name || "").toLowerCase();
+  if (!["taskcreate", "taskupdate", "tasklist"].includes(tool)) return current;
+  if (!payload || typeof payload !== "object") return current;
+  if (tool === "tasklist") {
+    return hasExplicitList(payload) ? normalizeTaskList(payload, "tasklist") : current;
+  }
+  const record = payload.task && typeof payload.task === "object" ? payload.task : payload;
+  const id = String(record.id || record.taskId || payload.taskId || "");
+  if (!id) return current;
+  const next = Array.isArray(current) ? current.map((task) => ({ ...task })) : [];
+  const provisional = next.findIndex((task) => task.id === String(toolId || ""));
+  const existing = next.findIndex((task) => task.id === id);
+  const index = existing >= 0 ? existing : provisional;
+  const prior = index >= 0 ? next[index] : null;
+  const label = sanitizeLabel(record.content || record.subject || record.description || record.text || record.title || prior?.label || id);
+  const task = { id, label, status: statusOf(record.status || prior?.status), source: tool || "task-result" };
+  if (index >= 0) next[index] = { ...prior, ...task };
+  else next.push(task);
+  if (existing >= 0 && provisional >= 0 && provisional !== existing) next.splice(provisional, 1);
+  return next;
+}
+
+module.exports = { statusOf, sanitizeLabel, normalizeTaskList, applyTaskTool, applyTaskResult };