devez-vibe 1.2.7 → 1.2.8

package/LICENSE

@@ -1,33 +1,33 @@
-DevezCode source code license
-
-The MIT License below applies only to the DevezCode source code and to files
-that are not listed in the exception below.
-
-Exceptions:
-
-* `Resources/Images/FileTypes/` and `Resources/Licenses/` are Microsoft Visual
-  Studio Image Library materials, subject to the included Microsoft terms.
-* `Resources/Images/ShellPresets/` contains third-party brand assets, subject
-  to their respective owners' terms.
-
-MIT License
-
-Copyright (c) 2026 DevezCode contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+DevezCode source code license
+
+The MIT License below applies only to the DevezCode source code and to files
+that are not listed in the exception below.
+
+Exceptions:
+
+* `Resources/Images/FileTypes/` and `Resources/Licenses/` are Microsoft Visual
+  Studio Image Library materials, subject to the included Microsoft terms.
+* `Resources/Images/ShellPresets/` contains third-party brand assets, subject
+  to their respective owners' terms.
+
+MIT License
+
+Copyright (c) 2026 DevezCode contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/bridge/claude-agent-sdk-bridge.mjs

@@ -497,9 +497,48 @@ function emitItem(session, phase, item) {
   notify(`item/${phase}`, { threadId: session.id, turnId: session.turn?.id, item });
 }
 
-function emitDelta(session, method, itemId, delta) {
-  notify(method, { threadId: session.id, turnId: session.turn?.id, itemId, delta, provider: "Claude" });
-}
+function emitDelta(session, method, itemId, delta) {
+  notify(method, { threadId: session.id, turnId: session.turn?.id, itemId, delta, provider: "Claude" });
+}
+
+function isKoreanPrompt(input) {
+  const prompt = (Array.isArray(input) ? input : [])
+    .filter((item) => item?.type === "text")
+    .map((item) => String(item.text || ""))
+    .join("\n");
+  return /[\uac00-\ud7a3]/.test(prompt);
+}
+
+function openingNotice(input) {
+  return isKoreanPrompt(input)
+    ? "요청 내용을 확인하고 필요한 작업을 진행하겠습니다."
+    : "I’ll review the request and proceed with the necessary work.";
+}
+
+function normalizeProgressText(turn, text) {
+  const value = String(text || "");
+  const trimmed = value.trim();
+  if (turn?.koreanRequest
+    && trimmed.length <= 160
+    && !/[\uac00-\ud7a3]/.test(trimmed)
+    && /^Now\b[^\r\n]*[.!?]?$/i.test(trimmed)) {
+    return "다음 부분을 이어서 확인하겠습니다.";
+  }
+  return value;
+}
+
+// Claude can answer with a tool_use as its first and only content block even
+// when the prompt asks for an opening update. Keep the visible contract stable
+// without duplicating a real model-written update.
+function emitOpeningNotice(session) {
+  if (!session.turn || session.turn.openingNoticeEmitted) return;
+  const text = session.turn.openingNotice;
+  const id = nextItemId(session, "opening");
+  const item = { id, type: "agentMessage", text, provider: "Claude" };
+  emitItem(session, "started", item);
+  emitItem(session, "completed", item);
+  session.turn.openingNoticeEmitted = true;
+}
 
 // Windows rounds larger timer delays up to the next scheduler slice. Ten
 // milliseconds lands near one terminal frame instead of visibly stepping at ~30ms.
@@ -632,7 +671,7 @@ async function processStreamEvent(session, message) {
     flushSmoothStreams(session);
     session.streamBlocks.clear();
   }
-  if (event.type === "content_block_start") {
+  if (event.type === "content_block_start") {
     const block = event.content_block || {};
     if (block.type !== "text" && block.type !== "thinking") return;
     const id = nextItemId(session, block.type);
@@ -642,24 +681,54 @@ async function processStreamEvent(session, message) {
     const smooth = block.type === "text"
       ? new SmoothTextStream((delta) => emitDelta(session, "item/agentMessage/delta", id, delta))
       : null;
-    session.streamBlocks.set(event.index, { id, type: block.type, text: "", smooth });
+    session.streamBlocks.set(event.index, {
+      id,
+      type: block.type,
+      text: "",
+      smooth,
+      languagePending: block.type === "text" && session.turn.koreanRequest ? "" : null,
+      holdEnglishProgress: false,
+    });
     emitItem(session, "started", item);
     return;
   }
-  if (event.type === "content_block_delta") {
+  if (event.type === "content_block_delta") {
     const current = session.streamBlocks.get(event.index);
     if (!current) return;
-    const delta = event.delta?.text || event.delta?.thinking || "";
-    if (!delta) return;
-    current.text += delta;
-    if (current.smooth) current.smooth.push(delta);
-    else emitDelta(session, "item/reasoning/summaryTextDelta", current.id, delta);
-    return;
-  }
+    const delta = event.delta?.text || event.delta?.thinking || "";
+    if (!delta) return;
+    current.text += delta;
+    if (current.type === "text") session.turn.sawVisibleText = true;
+    if (!current.smooth) {
+      emitDelta(session, "item/reasoning/summaryTextDelta", current.id, delta);
+      return;
+    }
+    if (current.languagePending != null) {
+      current.languagePending += delta;
+      const probe = current.languagePending.trimStart();
+      const lower = probe.toLowerCase();
+      if (!current.holdEnglishProgress && "now".startsWith(lower)) return;
+      if (/^now(?:\s|$)/i.test(probe)) {
+        current.holdEnglishProgress = true;
+        return;
+      }
+      current.smooth.push(current.languagePending);
+      current.languagePending = null;
+      return;
+    }
+    current.smooth.push(delta);
+    return;
+  }
   if (event.type === "content_block_stop") {
-    const current = session.streamBlocks.get(event.index);
-    if (!current) return;
-    await current.smooth?.finish();
+    const current = session.streamBlocks.get(event.index);
+    if (!current) return;
+    if (current.languagePending != null) {
+      const visible = normalizeProgressText(session.turn, current.languagePending);
+      current.text = visible;
+      current.smooth?.push(visible);
+      current.languagePending = null;
+    }
+    await current.smooth?.finish();
     const item = current.type === "text"
       ? { id: current.id, type: "agentMessage", text: current.text, provider: "Claude" }
       : { id: current.id, type: "reasoning", summary: [current.text] };
@@ -684,22 +753,29 @@ function processAssistant(session, message) {
     message.message?.model,
     session.model,
   );
-  const content = Array.isArray(message.message?.content) ? message.message.content : [];
-  for (const block of content) {
-    if (block.type === "tool_use") processToolUse(session, block);
-  }
-  if (!session.streamBlocks.size && !session.turn.sawStreamText) {
-    for (const block of content) {
-      if (block.type !== "text" && block.type !== "thinking") continue;
-      const id = nextItemId(session, block.type);
-      const item = block.type === "text"
-        ? { id, type: "agentMessage", text: block.text || "", provider: "Claude" }
-        : { id, type: "reasoning", summary: [block.thinking || ""] };
-      emitItem(session, "started", item);
-      emitItem(session, "completed", item);
-    }
-  }
-}
+  const content = Array.isArray(message.message?.content) ? message.message.content : [];
+  const hasToolUse = content.some((block) => block.type === "tool_use");
+  const hasVisibleText = session.turn.sawVisibleText || content.some(
+    (block) => block.type === "text" && String(block.text || "").trim(),
+  );
+  // Without partial SDK events, replay completed text before tool items so the
+  // visible order still matches the assistant content order.
+  if (!session.streamBlocks.size && !session.turn.sawStreamText) {
+    for (const block of content) {
+      if (block.type !== "text" && block.type !== "thinking") continue;
+      const id = nextItemId(session, block.type);
+      const item = block.type === "text"
+        ? { id, type: "agentMessage", text: normalizeProgressText(session.turn, block.text), provider: "Claude" }
+        : { id, type: "reasoning", summary: [block.thinking || ""] };
+      emitItem(session, "started", item);
+      emitItem(session, "completed", item);
+    }
+  }
+  if (hasToolUse && !hasVisibleText) emitOpeningNotice(session);
+  for (const block of content) {
+    if (block.type === "tool_use") processToolUse(session, block);
+  }
+}
 
 function processToolUse(session, block) {
   const name = block.name || "Tool";
@@ -762,51 +838,51 @@ function prepareTaskPlanForCreate(tasks, subject) {
   if (numberedTaskIndex(subject) === 1) tasks.clear();
 }
 
-function applyTaskUpdate(tasks, input, turnId, onIntermediate) {
-  const task = tasks.get(String(input.taskId));
-  if (!task) return false;
-  if (input.subject) task.subject = input.subject;
-  const status = input.status;
-  if (status === "in_progress" || status === "completed") {
-    const entries = [...tasks.values()];
-    const targetIndex = entries.indexOf(task);
-
-    // Claude occasionally closes a later pending task at the end of a turn
-    // without ever starting it. Keep the visible plan truthful and sequential:
-    // every skipped predecessor and the target itself pass through in_progress.
-    for (let index = 0; index < targetIndex; index++) {
-      const previous = entries[index];
-      if (previous.status === "completed") continue;
-      if (previous.status !== "in_progress") {
-        previous.status = "in_progress";
-        previous.turnId = turnId;
-        onIntermediate?.();
-      }
-      previous.status = "completed";
-      previous.turnId = turnId;
-      onIntermediate?.();
-    }
-
-    for (let index = 0; index < entries.length; index++) {
-      const other = entries[index];
-      if (other === task || other.status !== "in_progress") continue;
-      other.status = index < targetIndex ? "completed" : "pending";
-      other.turnId = turnId;
-      onIntermediate?.();
-    }
-
-    if (status === "completed" && task.status !== "in_progress" && task.status !== "completed") {
-      task.status = "in_progress";
-      task.turnId = turnId;
-      onIntermediate?.();
-    }
-    task.status = status;
-  } else if (status) {
-    task.status = status;
-  }
-  task.turnId = turnId;
-  return true;
-}
+function applyTaskUpdate(tasks, input, turnId, onIntermediate) {
+  const task = tasks.get(String(input.taskId));
+  if (!task) return false;
+  if (input.subject) task.subject = input.subject;
+  const status = input.status;
+  if (status === "in_progress" || status === "completed") {
+    const entries = [...tasks.values()];
+    const targetIndex = entries.indexOf(task);
+
+    // Claude occasionally closes a later pending task at the end of a turn
+    // without ever starting it. Keep the visible plan truthful and sequential:
+    // every skipped predecessor and the target itself pass through in_progress.
+    for (let index = 0; index < targetIndex; index++) {
+      const previous = entries[index];
+      if (previous.status === "completed") continue;
+      if (previous.status !== "in_progress") {
+        previous.status = "in_progress";
+        previous.turnId = turnId;
+        onIntermediate?.();
+      }
+      previous.status = "completed";
+      previous.turnId = turnId;
+      onIntermediate?.();
+    }
+
+    for (let index = 0; index < entries.length; index++) {
+      const other = entries[index];
+      if (other === task || other.status !== "in_progress") continue;
+      other.status = index < targetIndex ? "completed" : "pending";
+      other.turnId = turnId;
+      onIntermediate?.();
+    }
+
+    if (status === "completed" && task.status !== "in_progress" && task.status !== "completed") {
+      task.status = "in_progress";
+      task.turnId = turnId;
+      onIntermediate?.();
+    }
+    task.status = status;
+  } else if (status) {
+    task.status = status;
+  }
+  task.turnId = turnId;
+  return true;
+}
 
 // TaskList에는 예전 계획까지 함께 들어올 수 있다. 마지막으로 번호가 1부터
 // 시작한 묶음만 현재 계획으로 삼되, 번호가 없는 목록은 손실 없이 그대로 둔다.
@@ -829,9 +905,9 @@ function updatePlanFromToolUse(session, name, toolUseId, input) {
       status: "pending",
       turnId,
     });
-  } else if (name === "TaskUpdate") {
-    applyTaskUpdate(session.tasks, input, turnId, () => emitPlan(session));
-  }
+  } else if (name === "TaskUpdate") {
+    applyTaskUpdate(session.tasks, input, turnId, () => emitPlan(session));
+  }
   emitPlan(session);
 }
 
@@ -1335,7 +1411,7 @@ async function startPrompt(params) {
   return runPrompt(session, params);
 }
 
-async function runPrompt(session, params) {
+async function runPrompt(session, params) {
   const id = session.id;
   if (params.model) {
     const model = stripClaudeModel(params.model);
@@ -1346,12 +1422,13 @@ async function runPrompt(session, params) {
   if (effort) {
     await session.query.applyFlagSettings({ effortLevel: effort });
   }
-  session.effort = effort;
-  await applyPermissionMode(session, params.permissionMode);
-  const turnId = beginTurn(session);
-  session.queue.push({
-    type: "user",
-    message: { role: "user", content: await inputContent(params.input, params.handoffContext) },
+  session.effort = effort;
+  await applyPermissionMode(session, params.permissionMode);
+  const content = await inputContent(params.input, params.handoffContext);
+  const turnId = beginTurn(session, params.input);
+  session.queue.push({
+    type: "user",
+    message: { role: "user", content },
     parent_tool_use_id: null,
     session_id: id,
     origin: { kind: "human" },
@@ -1361,9 +1438,16 @@ async function runPrompt(session, params) {
 
 // A background task notification is an internal user message that starts its
 // own Claude response even though the host did not submit a new prompt.
-function beginTurn(session) {
-  const turnId = `claude-turn-${session.turnSequence++}-${randomUUID()}`;
-  session.turn = { id: turnId, sawStreamText: false };
+function beginTurn(session, input = []) {
+  const turnId = `claude-turn-${session.turnSequence++}-${randomUUID()}`;
+  session.turn = {
+    id: turnId,
+    sawStreamText: false,
+    sawVisibleText: false,
+    koreanRequest: isKoreanPrompt(input),
+    openingNotice: openingNotice(input),
+    openingNoticeEmitted: false,
+  };
   session.lastContextUsage = null;
   notify("turn/started", { threadId: session.id, turn: { id: turnId } });
   return turnId;
@@ -1717,33 +1801,33 @@ async function runSelfTest() {
   }
   applyTaskUpdate(restoredTasks, { taskId: "26", status: "completed" }, "resumed-turn");
   applyTaskUpdate(restoredTasks, { taskId: "27", status: "in_progress" }, "resumed-turn");
-  if (restoredTasks.size !== 6
-    || restoredTasks.get("25")?.status !== "completed"
-    || restoredTasks.get("26")?.status !== "completed"
-    || restoredTasks.get("27")?.status !== "in_progress"
-    || [...restoredTasks.values()].filter((task) => task.status === "in_progress").length !== 1) {
-    throw new Error(`Claude sequential task update self-test failed: ${JSON.stringify([...restoredTasks])}`);
-  }
-  const skippedTasks = new Map([
-    ["1", { id: "1", subject: "1. 조사", status: "pending" }],
-    ["2", { id: "2", subject: "2. 분석", status: "pending" }],
-    ["3", { id: "3", subject: "3. 검증", status: "pending" }],
-  ]);
-  const transitions = [];
-  const snapshot = () => transitions.push([...skippedTasks.values()].map((task) => task.status).join(","));
-  applyTaskUpdate(skippedTasks, { taskId: "3", status: "completed" }, "turn", snapshot);
-  snapshot();
-  if (transitions.join("|") !== [
-    "in_progress,pending,pending",
-    "completed,pending,pending",
-    "completed,in_progress,pending",
-    "completed,completed,pending",
-    "completed,completed,in_progress",
-    "completed,completed,completed",
-  ].join("|")) {
-    throw new Error(`Claude skipped task transition self-test failed: ${transitions.join("|")}`);
-  }
-  const mixedPlans = new Map([
+  if (restoredTasks.size !== 6
+    || restoredTasks.get("25")?.status !== "completed"
+    || restoredTasks.get("26")?.status !== "completed"
+    || restoredTasks.get("27")?.status !== "in_progress"
+    || [...restoredTasks.values()].filter((task) => task.status === "in_progress").length !== 1) {
+    throw new Error(`Claude sequential task update self-test failed: ${JSON.stringify([...restoredTasks])}`);
+  }
+  const skippedTasks = new Map([
+    ["1", { id: "1", subject: "1. 조사", status: "pending" }],
+    ["2", { id: "2", subject: "2. 분석", status: "pending" }],
+    ["3", { id: "3", subject: "3. 검증", status: "pending" }],
+  ]);
+  const transitions = [];
+  const snapshot = () => transitions.push([...skippedTasks.values()].map((task) => task.status).join(","));
+  applyTaskUpdate(skippedTasks, { taskId: "3", status: "completed" }, "turn", snapshot);
+  snapshot();
+  if (transitions.join("|") !== [
+    "in_progress,pending,pending",
+    "completed,pending,pending",
+    "completed,in_progress,pending",
+    "completed,completed,pending",
+    "completed,completed,in_progress",
+    "completed,completed,completed",
+  ].join("|")) {
+    throw new Error(`Claude skipped task transition self-test failed: ${transitions.join("|")}`);
+  }
+  const mixedPlans = new Map([
     ["old-1", { subject: "1. 이전 작업", status: "completed" }],
     ["old-2", { subject: "2. 이전 검증", status: "completed" }],
     ...[...restoredTasks],
@@ -1882,13 +1966,91 @@ async function runSelfTest() {
     .filter(Boolean)
     .map((line) => JSON.parse(line));
   const lifecycleMethods = lifecycleEvents.map((event) => event.method);
-  if (!lifecycleMethods.includes("turn/subagents/updated")
-    || lifecycleMethods.filter((method) => method === "turn/started").length < 3
-    || !lifecycleEvents.some((event) => event.method === "turn/subagent/line"
-      && event.params?.line?.kind === "error")) {
-    throw new Error(`Claude subagent lifecycle events self-test failed: ${lifecycleMethods}`);
-  }
-  const smoothText = "Claude가 👨‍👩‍👧‍👦 한 문장을 한꺼번에 보내도 부드럽게 표시합니다.";
+  if (!lifecycleMethods.includes("turn/subagents/updated")
+    || lifecycleMethods.filter((method) => method === "turn/started").length < 3
+    || !lifecycleEvents.some((event) => event.method === "turn/subagent/line"
+      && event.params?.line?.kind === "error")) {
+    throw new Error(`Claude subagent lifecycle events self-test failed: ${lifecycleMethods}`);
+  }
+  const openingSession = {
+    id: "opening-self-test",
+    model: "claude:default",
+    models: [],
+    turn: null,
+    turnSequence: 1,
+    itemSequence: 1,
+    streamBlocks: new Map(),
+    tools: new Map(),
+    tasks: new Map(),
+    subagents: new Map(),
+    knownSubagents: new Map(),
+    lastContextUsage: null,
+    lastContextWindow: 0,
+  };
+  const openingCaptured = [];
+  process.stdout.write = (chunk) => {
+    openingCaptured.push(String(chunk));
+    return true;
+  };
+  try {
+    beginTurn(openingSession, [{ type: "text", text: "provider 메뉴를 수정해" }]);
+    processAssistant(openingSession, {
+      message: {
+        content: [{ type: "tool_use", id: "read-1", name: "Read", input: { file_path: "src/main.rs" } }],
+      },
+    });
+  } finally {
+    process.stdout.write = stdoutWrite;
+  }
+  const openingEvents = openingCaptured
+    .join("")
+    .trim()
+    .split("\n")
+    .filter(Boolean)
+    .map((line) => JSON.parse(line));
+  const openingMessageIndex = openingEvents.findIndex((event) =>
+    event.method === "item/completed"
+      && event.params?.item?.type === "agentMessage"
+      && event.params.item.text === "요청 내용을 확인하고 필요한 작업을 진행하겠습니다.");
+  const openingToolIndex = openingEvents.findIndex((event) =>
+    event.method === "item/started" && event.params?.item?.type === "dynamicToolCall");
+  if (openingMessageIndex < 0 || openingToolIndex < 0 || openingMessageIndex > openingToolIndex) {
+    throw new Error(`Claude opening notice order self-test failed: ${JSON.stringify(openingEvents)}`);
+  }
+  const languageCaptured = [];
+  process.stdout.write = (chunk) => {
+    languageCaptured.push(String(chunk));
+    return true;
+  };
+  try {
+    openingSession.streamBlocks.clear();
+    await processStreamEvent(openingSession, {
+      event: { type: "content_block_start", index: 0, content_block: { type: "text" } },
+    });
+    await processStreamEvent(openingSession, {
+      event: { type: "content_block_delta", index: 0, delta: { text: "Now the tile view logic." } },
+    });
+    await processStreamEvent(openingSession, {
+      event: { type: "content_block_stop", index: 0 },
+    });
+  } finally {
+    process.stdout.write = stdoutWrite;
+  }
+  const languageEvents = languageCaptured
+    .join("")
+    .trim()
+    .split("\n")
+    .filter(Boolean)
+    .map((line) => JSON.parse(line));
+  const visibleLanguage = languageEvents
+    .filter((event) => event.method === "item/agentMessage/delta")
+    .map((event) => event.params?.delta || "")
+    .join("");
+  if (visibleLanguage !== "다음 부분을 이어서 확인하겠습니다."
+    || languageEvents.some((event) => JSON.stringify(event).includes("Now the tile view logic."))) {
+    throw new Error(`Claude Korean progress normalization self-test failed: ${JSON.stringify(languageEvents)}`);
+  }
+  const smoothText = "Claude가 👨‍👩‍👧‍👦 한 문장을 한꺼번에 보내도 부드럽게 표시합니다.";
   const emitted = [];
   const smooth = new SmoothTextStream((chunk) => emitted.push(chunk), 0);
   smooth.push(smoothText);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devez-vibe",
-  "version": "1.2.7",
+  "version": "1.2.8",
   "description": "Stable terminal UI for Codex and Claude Agent SDK",
   "keywords": [
     "codex",