agentlas 1.0.9 → 1.0.11

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## 1.0.11 — 2026-07-27
+
+- **The slash palette repaints in place instead of stacking copies of
+  itself.** Every keystroke left the previous frame on screen, so a few
+  arrow presses filled the terminal with duplicate palettes and pushed the
+  prompt out of view. Two causes, both measured on an emulated terminal:
+  the frame was drawn with the cursor saved and restored by absolute
+  position, and the frame was 18 lines tall with no regard for the window.
+  In a REPL the prompt sits at the bottom of the screen, so drawing below
+  it always scrolls — and after a scroll the saved absolute row points at
+  different content, so the next repaint erased the wrong region and left
+  the old frame behind. The palette now returns to the prompt with a
+  relative cursor move, which survives scrolling, and never draws a frame
+  taller than the window: the list shrinks around the highlighted entry,
+  and the selection detail folds away before the list does, so the
+  highlighted row and the controls hint survive at any height. Verified at
+  14, 18, 24 and 50 rows — one palette on screen, prompt intact.
+- Quitting no longer announces a wait for commands that finish in
+  milliseconds; the notice now appears only after 400ms.
+
+## 1.0.10 — 2026-07-27
+
+Four defects in the REPL's slash surface, all found by sweeping for the shape
+that produced 1.0.8: a v2 caller using a v1-era contract.
+
+- **Quoted arguments survive.** Slash arguments were split on whitespace, so
+  the quotes the palette itself advertises (`/search "<what you need>"`) were
+  passed through as part of the query — `/search "hello world"` searched for
+  `"hello`. The quote-aware tokenizer the top-level CLI uses was exported but
+  had no call sites; the REPL now uses it.
+- **Aliases work inside the REPL.** `agentlas hep-network …` was accepted
+  while `/hep-network …` answered "unknown", because alias resolution lived
+  only in the top-level dispatcher. Both surfaces now resolve the same names,
+  and a test pins every alias to a command that actually exists.
+- **A command issued just before `/quit` is no longer discarded.** Slash
+  commands are async and were fire-and-forget, so closing the prompt resolved
+  immediately and the process exited mid-flight: `/search …` followed by
+  `/quit` printed nothing at all, while the same pair typed 25 seconds apart
+  worked. In-flight commands are now awaited — bounded at 30s, so quitting
+  can never hang — and the wait is announced rather than silent.
+- **The first-run wizard's language applies to the whole session.** Choosing a
+  language wrote it to preferences and to `ui.lang`, but not to `ctx.lang`, so
+  the banner switched while `/help`, the palette, orchestrator notices and the
+  shortcut hints stayed in the OS-locale language until the next launch.
+
 ## 1.0.9 — 2026-07-27
 
 Three repairs of one mistake, found by a live run that a 4-agent task force

package/engine/agentlas-input.cjs

@@ -509,31 +509,56 @@ function renderSlashPalette(rows, selectedIndex, opts = {}) {
   );
   const descWidth = Math.max(0, lineWidth - commandWidth - 1);
   const selected = rows[Math.max(0, Math.min(selectedIndex, rows.length - 1))] || rows[0];
-  const out = [
+  const head = [
     c.faint(truncateVisible(`${i18n.t(lang, "palette.title")}  ${i18n.t(lang, "palette.search")}`, lineWidth)),
     c.faint("─".repeat(lineWidth)),
   ];
-  rows.forEach((row, index) => {
-    const command = padVisible(truncateVisible(row.command, commandWidth), commandWidth);
-    const desc = truncateVisible(row.description, descWidth);
-    const body = " " + c.blue(command) + c.text(desc);
-    out.push(index === selectedIndex ? c.inverse(padVisible(body, lineWidth)) : body);
-  });
-  out.push(c.faint("─".repeat(lineWidth)));
+  /*
+   * 꼬리(구분선·선택 상세·조작 안내)를 먼저 만든다 — 목록만 예산에 맞춰 줄이고
+   * 머리와 꼬리는 어떤 높이에서도 지키기 위해서다.
+   */
+  const tail = [c.faint("─".repeat(lineWidth))];
+  const tailStart = tail.length; // 이 뒤는 자리가 모자라면 접는다 (상세 → 예시 순으로 버림)
+  const out = head;
   if (selected) {
     const usage = truncateVisible(selected.usage || selected.command, lineWidth - 2);
     const detail = truncateVisible(selected.detail || selected.description || "", lineWidth - 2);
     const category = selected.category ? i18n.t(lang, "palette.category", selected.category) : "";
     const categoryRoom = Math.max(0, lineWidth - visibleWidthLite(usage) - 3);
     const categoryText = categoryRoom > 0 ? truncateVisible(category, categoryRoom) : "";
-    out.push(" " + c.text(usage) + (categoryText ? c.dim("  " + categoryText) : ""));
-    if (detail) out.push(" " + c.dim(detail));
+    tail.push(" " + c.text(usage) + (categoryText ? c.dim("  " + categoryText) : ""));
+    if (detail) tail.push(" " + c.dim(detail));
     if (selected.examples && selected.examples.length) {
-      out.push(c.dim(truncateVisible(" " + i18n.t(lang, "palette.examples", selected.examples.slice(0, 2).join("  |  ")), lineWidth)));
+      tail.push(c.dim(truncateVisible(" " + i18n.t(lang, "palette.examples", selected.examples.slice(0, 2).join("  |  ")), lineWidth)));
     }
   }
-  out.push(c.dim(truncateVisible(" " + i18n.t(lang, "palette.controls"), lineWidth)));
-  return out.join("\n");
+  /*
+   * 화면 높이 예산. 터미널보다 긴 프레임을 쏟으면 그리는 도중 스크롤이 나고, 그 순간
+   * 오버레이가 제자리를 잃어 이전 프레임이 화면에 남는다(실측: 24행에서 18행짜리
+   * 프레임 → 블록이 겹겹이 쌓이고 프롬프트가 화면 밖으로 밀려남).
+   * 선택 항목이 잘려 나가지 않도록 강조 위치를 중심으로 창을 잡는다.
+   */
+  const controls = c.dim(truncateVisible(" " + i18n.t(lang, "palette.controls"), lineWidth));
+  const budget = Math.max(1, Math.floor(Number(opts.maxRows) || (rows.length + head.length + tail.length + 1)));
+  /*
+   * 자리가 모자라면 선택 상세부터 접는다. 목록 한 줄과 조작 안내는 마지막까지 지킨다 —
+   * 아무것도 못 고르는 팔레트나 나가는 법을 모르는 팔레트는 없느니만 못하다.
+   * 최소 프레임은 5줄(제목·구분선·목록 1줄·구분선·조작 안내)이며, 그보다 좁은 예산도 5줄이다.
+   */
+  while (tail.length > tailStart && budget - head.length - tail.length - 1 < 1) tail.pop();
+  const listBudget = Math.max(1, budget - head.length - tail.length - 1);
+  const start = Math.min(
+    Math.max(0, selectedIndex - listBudget + 1),
+    Math.max(0, rows.length - listBudget),
+  );
+  rows.slice(start, start + listBudget).forEach((row, offset) => {
+    const index = start + offset;
+    const command = padVisible(truncateVisible(row.command, commandWidth), commandWidth);
+    const desc = truncateVisible(row.description, descWidth);
+    const body = " " + c.blue(command) + c.text(desc);
+    out.push(index === selectedIndex ? c.inverse(padVisible(body, lineWidth)) : body);
+  });
+  return out.concat(tail, [controls]).join("\n");
 }
 
 function attachSlashPalette(rl, opts = {}) {
@@ -574,9 +599,25 @@ function attachSlashPalette(rl, opts = {}) {
     rl.write(null, { ctrl: true, name: "u" });
     rl.write(value);
   }
+  /*
+   * 커서 복원은 상대 이동으로만 한다.
+   *
+   * 예전 구현은 DECSC/DECRC(`\x1b7`/`\x1b8`)로 절대 위치를 저장·복원했다. 그런데 REPL은
+   * 프롬프트가 화면 맨 아래에 있는 게 보통이라, 그 아래로 프레임을 그리면 반드시 스크롤이
+   * 난다. 스크롤 뒤 저장된 절대 행은 다른 내용을 가리키므로 복원이 어긋나고, 다음 렌더의
+   * "커서 아래 전부 지우기"가 이전 프레임을 못 지운다 — 화면에 팔레트가 겹겹이 쌓였다.
+   * (pyte 에뮬레이션 실측: 24행에서 ↓ 3회 → 잔상 블록 + 프롬프트 유실.)
+   * `\x1b[nA` 같은 상대 이동은 내용과 함께 밀리므로 스크롤이 나도 어긋나지 않는다.
+   */
+  function promptColumn() {
+    const prompt = typeof rl.getPrompt === "function" ? rl.getPrompt() : "";
+    const typed = String(rl.line || "").slice(0, rl.cursor);
+    return visibleWidthLite(String(prompt)) + visibleWidthLite(typed) + 1;
+  }
   function clear() {
     if (!state.visible) return;
-    stream.write("\x1b7\x1b[E\x1b[0J\x1b8");
+    // 그린 뒤에는 프롬프트 아래에 자리가 있으므로 커서 아래로 이동은 스크롤을 만들지 않는다.
+    stream.write(`\x1b[1B\r\x1b[0J\x1b[1A\x1b[${promptColumn()}G`);
     state.visible = false;
   }
   function render() {
@@ -596,10 +637,16 @@ function attachSlashPalette(rl, opts = {}) {
     if (state.selected < 0 || state.selected >= list.length) state.selected = 0;
     const body = renderSlashPalette(list, state.selected, {
       columns: stream.columns || process.stdout.columns || 88,
+      // 프롬프트 줄과 여유 한 줄을 남긴다 — 프레임이 화면을 다 먹으면 제자리 갱신이 불가능하다.
+      maxRows: Math.max(5, (stream.rows || process.stdout.rows || 24) - 2),
       colors,
       lang: opts.lang || (opts.ui && opts.ui.lang) || "en",
     });
-    stream.write("\x1b7\x1b[E\x1b[0J" + body + "\x1b8");
+    if (!body) { clear(); return; }
+    const lines = body.split("\n");
+    // 첫 줄바꿈은 프롬프트 아래로 내려가며, 자리가 없으면 여기서 화면이 한 번 밀린다.
+    // 그린 만큼 그대로 되올라오므로 이후 갱신은 제자리에서 일어난다.
+    stream.write(`\r\n\x1b[0J${lines.join("\r\n")}\x1b[${lines.length}A\x1b[${promptColumn()}G`);
     state.visible = true;
   }
   /*

package/engine/ui/repl.cjs

@@ -23,6 +23,7 @@ const { findAgent, listAgents } = require("../agents/registry.cjs");
 const { resolveRuntime, NoRuntimeError } = require("../runtimes/resolve.cjs");
 const permissions = require("../agentlas-permissions.cjs");
 const i18n = require("../agentlas-i18n.cjs");
+const { tokenizeCommandLine } = require("../agentlas-input.cjs");
 
 const DEFAULT_AGENT_SLUG = "agentlas-orchestrator";
 
@@ -90,7 +91,8 @@ function pickDefaultAgent(db) {
 }
 
 async function startRepl(ctx, opts = {}) {
-  const en = ctx.lang === "en";
+  // 마법사가 언어를 바꾸면 이 뒤의 문구도 따라가야 한다 — 아래 온보딩 블록에서 갱신한다.
+  let en = ctx.lang === "en";
   const ui = ctx.uiInstance;
   const db = ctx.db();
 
@@ -103,7 +105,17 @@ async function startRepl(ctx, opts = {}) {
       const { runWizard } = require("../commands/setup.cjs");
       const result = await runWizard(ctx, wizardRl);
       if (result) {
-        if (result.lang) { ctx.prefs.language = result.lang; }
+        /*
+         * 고른 언어를 이번 세션에도 즉시 반영한다. 예전에는 prefs 에만 적어서,
+         * runOnboard 가 손댄 ui.lang 덕에 배너만 새 언어로 나오고 /help·팔레트·
+         * 오케스트레이터·단축키 안내는 재시작 전까지 OS 로케일 언어로 남았다.
+         */
+        if (result.lang) {
+          ctx.prefs.language = result.lang;
+          ctx.lang = result.lang;
+          ui.lang = result.lang;
+          en = ctx.lang === "en";
+        }
         if (result.permission) ctx.prefs.permission = result.permission;
         if (result.runtime) ctx.prefs.runtime = result.runtime;
         ctx.prefs.onboarded = !!result.onboarded;
@@ -186,6 +198,13 @@ async function startRepl(ctx, opts = {}) {
       getSessionKeys: () => orch.list().map((r) => r.key),
       getCwd: () => process.cwd(),
     });
+    // 진행 중인 비동기 슬래시 명령 — 종료가 이걸 잘라먹지 않도록 close 핸들러가 기다린다.
+    const pendingCommands = new Set();
+    const trackCommand = (promise) => {
+      pendingCommands.add(promise);
+      promise.then(() => pendingCommands.delete(promise), () => pendingCommands.delete(promise));
+      return promise;
+    };
     // Shift-Tab 이 온 턴에는 완성 후보를 비운다 — 아래 권한 순환 주석 참고.
     let swallowCompletion = false;
     const rl = readline.createInterface({
@@ -299,7 +318,7 @@ async function startRepl(ctx, opts = {}) {
 
       if (input.startsWith("/")) {
         try {
-          const quit = handleSlash(ctx, input.slice(1), { orch, renderer, ensureMainSession, resolveRt, setPermission: (p) => { permission = p; }, getPermission: () => permission, setRuntime: (r) => { runtimeOverride = r; } });
+          const quit = handleSlash(ctx, input.slice(1), { orch, renderer, ensureMainSession, resolveRt, track: trackCommand, setPermission: (p) => { permission = p; }, getPermission: () => permission, setRuntime: (r) => { runtimeOverride = r; } });
           if (quit === "quit") { rl.close(); return; }
         } catch (e) {
           ui.error(String((e && e.message) || e));
@@ -341,9 +360,28 @@ async function startRepl(ctx, opts = {}) {
       process.stdin.removeListener("keypress", onShortcutKey);
       slashPalette.detach();
       renderer.detach();
-      orch.shutdown();
-      ui.ensureNl();
-      resolve(0);
+      /*
+       * 슬래시 명령은 비동기다. 예전에는 close 가 곧바로 resolve 해서 프로세스가 끝나 버렸고,
+       * `/search …` 직후 `/quit` 을 치면 그 명령이 출력 한 줄 없이 사라졌다(실측: 같은 입력을
+       * 25초 벌려 치면 결과가 나온다). 진행 중인 명령을 먼저 기다린다.
+       *
+       * 다만 무한정 기다리지는 않는다 — 종료를 누른 사용자를 응답 없는 프로세스에 가둘 수 없다.
+       */
+      const finish = () => { orch.shutdown(); ui.ensureNl(); resolve(0); };
+      if (!pendingCommands.size) { finish(); return; }
+      let settled = false;
+      const once = () => { if (settled) return; settled = true; clearTimeout(notice); finish(); };
+      // 곧 끝나는 명령까지 매번 고지하면 종료 화면이 시끄러워진다 — 실제로 기다릴 때만 알린다.
+      const notice = setTimeout(() => {
+        ui.ensureNl();
+        ui.line(ui.c.dim(en
+          ? `finishing ${pendingCommands.size} command(s)…`
+          : `실행 중인 명령 ${pendingCommands.size}개를 마무리하는 중…`));
+      }, 400);
+      if (notice.unref) notice.unref();
+      const cap = setTimeout(once, 30_000);
+      if (cap.unref) cap.unref();
+      Promise.allSettled([...pendingCommands]).then(() => { clearTimeout(cap); once(); }, once);
     });
 
     prompt();
@@ -448,8 +486,19 @@ function handleSlash(ctx, cmdline, api) {
   const en = ctx.lang === "en";
   const ui = ctx.uiInstance;
   const { orch, renderer, ensureMainSession } = api;
-  const [cmd, ...rest] = cmdline.split(/\s+/);
-  const restStr = cmdline.slice(cmd.length).trim();
+  const commands = require("../commands/index.cjs");
+  /*
+   * 인자는 따옴표를 인식해 쪼갠다. 공백 분해는 따옴표를 인자 안에 그대로 남겨,
+   * 팔레트가 안내하는 그대로 `/search "무엇이 필요한지"` 를 치면 따옴표째 검색어가 됐다.
+   * 최상위 CLI 와 같은 토크나이저를 쓴다. restStr 은 원문 꼬리를 그대로 넘기는 자리
+   * (/spawn·/steer·/broadcast)라 계속 원문에서 자른다.
+   */
+  const rawCmd = cmdline.split(/\s+/)[0] || "";
+  const rest = tokenizeCommandLine(cmdline).slice(1);
+  const restStr = cmdline.slice(rawCmd.length).trim();
+  // 별칭도 최상위 CLI 와 동일하게 해석한다 — `agentlas hep-network` 는 되는데
+  // `/hep-network` 는 "알 수 없는 명령" 이던 비대칭을 없앤다.
+  const cmd = commands.resolveCommandName(rawCmd);
 
   switch (cmd) {
     case "quit": case "exit": return "quit";
@@ -564,11 +613,11 @@ function handleSlash(ctx, cmdline, api) {
        */
       // help/agents/list/chats/mcp/doctor 등은 위 케이스에서 이미 처리된다.
       const REPL_EXCLUDED = new Set(["chat", "open", "firm", "setup", "run"]);
-      const commands = require("../commands/index.cjs");
       if (!REPL_EXCLUDED.has(cmd) && commands.COMMANDS[cmd]) {
         const result = commands.COMMANDS[cmd]().run(ctx, rest);
-        if (result && typeof result.catch === "function") {
-          result.catch((e) => ctx.err(String((e && e.message) || e)));
+        if (result && typeof result.then === "function") {
+          // 진행 중임을 REPL 이 알아야 종료가 이걸 잘라먹지 않는다 (close 핸들러 참고).
+          api.track(result.catch((e) => ctx.err(String((e && e.message) || e))));
         }
         return;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentlas",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "Agentlas agent terminal — chat with your installed AI agents and teams from the terminal, Claude Code style. Standalone: no desktop app required.",
   "bin": {
     "agentlas": "bin/agentlas.cjs"