@robota-sdk/agent-ui-terminal 3.0.0-beta.93 → 3.0.0-beta.94

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robota-sdk/agent-ui-terminal",
-  "version": "3.0.0-beta.93",
+  "version": "3.0.0-beta.94",
   "description": "Terminal UI package (React + Ink) for the Robota SDK",
   "type": "module",
   "main": "dist/node/index.js",
@@ -38,15 +38,15 @@
     "marked-terminal": "^7.3.0",
     "react": "19.2.8",
     "string-width": "^8.2.2",
-    "@robota-sdk/agent-core": "3.0.0-beta.93",
-    "@robota-sdk/agent-framework": "3.0.0-beta.93",
-    "@robota-sdk/agent-interface-analytics": "3.0.0-beta.93",
-    "@robota-sdk/agent-interface-command": "3.0.0-beta.93",
-    "@robota-sdk/agent-interface-execution": "3.0.0-beta.93",
-    "@robota-sdk/agent-interface-session": "3.0.0-beta.93",
-    "@robota-sdk/agent-interface-transport": "3.0.0-beta.93",
-    "@robota-sdk/agent-interface-tui": "3.0.0-beta.93",
-    "@robota-sdk/agent-transport": "3.0.0-beta.93"
+    "@robota-sdk/agent-core": "3.0.0-beta.94",
+    "@robota-sdk/agent-interface-analytics": "3.0.0-beta.94",
+    "@robota-sdk/agent-framework": "3.0.0-beta.94",
+    "@robota-sdk/agent-interface-session": "3.0.0-beta.94",
+    "@robota-sdk/agent-interface-execution": "3.0.0-beta.94",
+    "@robota-sdk/agent-interface-transport": "3.0.0-beta.94",
+    "@robota-sdk/agent-interface-tui": "3.0.0-beta.94",
+    "@robota-sdk/agent-interface-command": "3.0.0-beta.94",
+    "@robota-sdk/agent-transport": "3.0.0-beta.94"
   },
   "devDependencies": {
     "@homebridge/node-pty-prebuilt-multiarch": "^0.14.1",
@@ -57,7 +57,7 @@
     "tsx": "^4.23.1",
     "typescript": "^6.0.3",
     "vitest": "^3.2.6",
-    "@robota-sdk/agent-command": "3.0.0-beta.93"
+    "@robota-sdk/agent-command": "3.0.0-beta.94"
   },
   "license": "AGPL-3.0-only OR LicenseRef-Commercial",
   "publishConfig": {

package/src/__tests__/__fixtures__/korean-text.json

@@ -0,0 +1,17 @@
+{
+  "greeting": "안녕하세요",
+  "greetingWithoutLastSyllable": "안녕하세",
+  "greetingWithoutMiddle": "안세요",
+  "greetingFirstTwoSyllables": "안녕",
+  "greetingFirstThreeSyllables": "안녕하",
+  "greetingMiddleTwoSyllables": "녕하",
+  "greetingFirstSyllable": "안",
+  "greetingThirdSyllable": "하",
+  "greetingLastSyllable": "요",
+  "hangulWord": "한글",
+  "hangulWordPlusTe": "한글테",
+  "hangulWordPlusTest": "한글테스트",
+  "hanSyllable": "한",
+  "longResponseStreaming": "긴 한국어 응답과 emoji 🎉 를 스트리밍합니다",
+  "longResponseDisplay": "긴 한국어 응답과 emoji 🎉 를 표시합니다"
+}

package/src/__tests__/cjk-defer-submit.test.tsx

@@ -4,6 +4,7 @@ import { describe, expect, it, vi } from 'vitest';
 
 import CjkTextInput from '../CjkTextInput.js';
 import { IME_SUBMIT_DEFER_MS } from '../flows/defer-submit.js';
+import korean from './__fixtures__/korean-text.json';
 
 /**
  * CLI-061 — integration proof that the CjkTextInput defer-submit includes a trailing IME character whose stdin
@@ -29,23 +30,23 @@ function Harness({ onSubmit }: { onSubmit: (value: string) => void }): React.Rea
 }
 
 describe('CLI-061 — CjkTextInput defer-submit (integration)', () => {
-  it('includes a trailing syllable that arrives after Enter (안녕하세 + Enter + 요 → 안녕하세요)', async () => {
+  it('includes a trailing syllable that arrives after Enter (greeting without its last syllable + Enter + last syllable → full greeting)', async () => {
     const onSubmit = vi.fn();
     const { stdin } = render(<Harness onSubmit={onSubmit} />);
     await tick();
 
-    stdin.write('안녕하세'); // composed so far
+    stdin.write(korean.greetingWithoutLastSyllable); // composed so far
     await tick();
     stdin.write('\r'); // Enter — schedules the deferred submit, does NOT submit synchronously
     await tick();
     expect(onSubmit).not.toHaveBeenCalled(); // deferred, not immediate
 
-    stdin.write('요'); // the final syllable's stdin event lands after Enter; the pipeline is still live
+    stdin.write(korean.greetingLastSyllable); // the final syllable's stdin event lands after Enter; the pipeline is still live
     await tick();
 
     await waitDefer(); // the defer window elapses → the deferred submit fires, re-reading the LATEST value
     expect(onSubmit).toHaveBeenCalledTimes(1);
-    expect(onSubmit).toHaveBeenCalledWith('안녕하세요');
+    expect(onSubmit).toHaveBeenCalledWith(korean.greeting);
   }, 10_000);
 
   it('a second Enter within the window does not double-submit', async () => {

package/src/__tests__/cjk-fallback-render.test.tsx

@@ -16,6 +16,7 @@ import React from 'react';
 import { afterAll, beforeAll, describe, expect, it } from 'vitest';
 
 import CjkTextInput from '../CjkTextInput.js';
+import korean from './__fixtures__/korean-text.json';
 
 const noop = (): void => {};
 const tick = (): Promise<void> => new Promise((r) => setTimeout(r, 30));
@@ -43,9 +44,9 @@ describe('CLI-062 — fallback rendering is byte-identical to pre-change output'
   });
 
   it('CJK value with drawn end-of-line cursor', async () => {
-    const { lastFrame, unmount } = render(<CjkTextInput value="안녕하세요" onChange={noop} />);
+    const { lastFrame, unmount } = render(<CjkTextInput value={korean.greeting} onChange={noop} />);
     await tick();
-    expect(lastFrame()).toBe('안녕하세요\u001b[7m \u001b[27m');
+    expect(lastFrame()).toBe(`${korean.greeting}\u001b[7m \u001b[27m`);
     unmount();
   });
 
@@ -69,10 +70,20 @@ describe('CLI-062 — fallback rendering is byte-identical to pre-change output'
 
   it('long value wraps identically (the <Box ref> wrapper must not change layout)', async () => {
     const { lastFrame, unmount } = render(
-      <CjkTextInput value={'a'.repeat(150) + '안녕'} onChange={noop} availableWidth={58} />,
+      <CjkTextInput
+        value={'a'.repeat(150) + korean.greetingFirstTwoSyllables}
+        onChange={noop}
+        availableWidth={58}
+      />,
     );
     await tick();
-    expect(lastFrame()).toBe('a'.repeat(100) + '\n' + 'a'.repeat(50) + '안녕\u001b[7m \u001b[27m');
+    expect(lastFrame()).toBe(
+      'a'.repeat(100) +
+        '\n' +
+        'a'.repeat(50) +
+        korean.greetingFirstTwoSyllables +
+        '\u001b[7m \u001b[27m',
+    );
     unmount();
   });
 });

package/src/__tests__/cjk-text-input-flow.test.ts

@@ -1,4 +1,5 @@
 import { describe, expect, it } from 'vitest';
+import korean from './__fixtures__/korean-text.json';
 import {
   applyCjkTextInput,
   applyCjkTextPaste,
@@ -53,10 +54,10 @@ describe('cjk text input flow', () => {
   it('Given Ink usePaste single-line text When applied Then text is inserted at cursor', () => {
     const state = { ...createCjkTextInputFlowState('ab'), cursor: 1 };
 
-    const result = applyCjkTextPaste(state, '한글', { canPaste: true });
+    const result = applyCjkTextPaste(state, korean.hangulWord, { canPaste: true });
 
-    expect(result.state).toMatchObject({ value: 'a한글b', cursor: 3 });
-    expect(result.effect).toEqual({ type: 'change', value: 'a한글b' });
+    expect(result.state).toMatchObject({ value: `a${korean.hangulWord}b`, cursor: 3 });
+    expect(result.effect).toEqual({ type: 'change', value: `a${korean.hangulWord}b` });
   });
 
   it('Given Ink usePaste multiline text When applied Then normalized paste effect is emitted', () => {

package/src/__tests__/cjk-text-input.test.ts

@@ -6,6 +6,7 @@
  */
 
 import { describe, it, expect } from 'vitest';
+import korean from './__fixtures__/korean-text.json';
 import {
   filterPrintable,
   insertAtCursor,
@@ -31,7 +32,7 @@ describe('filterPrintable', () => {
   });
 
   it('passes through Korean characters', () => {
-    expect(filterPrintable('안녕하세요')).toBe('안녕하세요');
+    expect(filterPrintable(korean.greeting)).toBe(korean.greeting);
   });
 
   it('passes through emoji', () => {
@@ -99,8 +100,12 @@ describe('insertAtCursor', () => {
   });
 
   it('handles Korean character insertion', () => {
-    const result = insertAtCursor('안세요', 1, '녕하');
-    expect(result.value).toBe('안녕하세요');
+    const result = insertAtCursor(
+      korean.greetingWithoutMiddle,
+      1,
+      korean.greetingMiddleTwoSyllables,
+    );
+    expect(result.value).toBe(korean.greeting);
     expect(result.cursor).toBe(3);
   });
 
@@ -126,24 +131,24 @@ describe('displayOffset', () => {
   });
 
   it('cursor before CJK char is at end of previous content', () => {
-    // "abcd한" width 5: cursor before "한" is at col 4 on line 0
-    // gap happens when "한" renders, not at cursor position
-    expect(displayOffset([...'abcd한'], 4, 5)).toBe(4);
-    // cursor after "한": 4(gap included) + 2 = 7 → but via offset: gap is at render
-    expect(displayOffset([...'abcd한'], 5, 5)).toBe(7);
+    // "abcd" + one wide syllable, width 5: cursor before the syllable is at col 4 on line 0
+    // gap happens when the syllable renders, not at cursor position
+    expect(displayOffset([...`abcd${korean.hanSyllable}`], 4, 5)).toBe(4);
+    // cursor after the syllable: 4(gap included) + 2 = 7 → but via offset: gap is at render
+    expect(displayOffset([...`abcd${korean.hanSyllable}`], 5, 5)).toBe(7);
   });
 
   it('handles pure CJK', () => {
-    // "한글" width 5: "한"=2, "글"=2 → total 4, fits on one line
-    expect(displayOffset([...'한글'], 2, 5)).toBe(4);
+    // two wide syllables, width 5: 2 + 2 → total 4, fits on one line
+    expect(displayOffset([...korean.hangulWord], 2, 5)).toBe(4);
   });
 
   it('handles CJK wrapping', () => {
-    // "한글테" width 5: cursor before "테" is after "글" (offset 4)
-    // "테" doesn't fit at col 4, but cursor is BEFORE the wrap
-    expect(displayOffset([...'한글테'], 2, 5)).toBe(4);
-    // cursor after "테": gap(1) + 2 = offset 7
-    expect(displayOffset([...'한글테'], 3, 5)).toBe(7);
+    // three wide syllables, width 5: cursor before the third is after the second (offset 4)
+    // the third syllable doesn't fit at col 4, but cursor is BEFORE the wrap
+    expect(displayOffset([...korean.hangulWordPlusTe], 2, 5)).toBe(4);
+    // cursor after the third syllable: gap(1) + 2 = offset 7
+    expect(displayOffset([...korean.hangulWordPlusTe], 3, 5)).toBe(7);
   });
 });
 
@@ -171,7 +176,7 @@ describe('charIndexAtDisplayOffset', () => {
   });
 
   it('round-trips with displayOffset for CJK', () => {
-    const text = '한글테스트';
+    const text = korean.hangulWordPlusTest;
     const chars = [...text];
     const width = 5;
     for (let i = 0; i <= chars.length; i++) {

package/src/__tests__/message-list-rendering.test.tsx

@@ -15,6 +15,7 @@ import { describe, it, expect } from 'vitest';
 import MessageList from '../MessageList.js';
 import { STATUS_SYMBOL, statusGlyphColor } from '../status-glyph.js';
 import { DARK_THEME } from '../theme/built-in-themes.js';
+import korean from './__fixtures__/korean-text.json';
 import type { IHistoryEntry } from '@robota-sdk/agent-core';
 import {
   createUserMessage,
@@ -154,7 +155,7 @@ describe('MessageList rendering', () => {
   });
 
   it('assistant message preserves CJK and emoji content', () => {
-    const content = '긴 한국어 응답과 emoji 🎉 를 표시합니다';
+    const content = korean.longResponseDisplay;
     const history: IHistoryEntry[] = [messageToHistoryEntry(createAssistantMessage(content))];
     const { lastFrame } = render(<MessageList history={history} />);
 

package/src/__tests__/pty/ime-cursor-tmux.ptytest.ts

@@ -27,6 +27,7 @@ import { tmpdir } from 'node:os';
 import { join, resolve } from 'node:path';
 
 import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import korean from '../__fixtures__/korean-text.json';
 
 import { fixtureProductEnvironment } from './isolated-home.js';
 
@@ -38,7 +39,7 @@ const GIT_BIN =
     .map((directory) => join(directory, 'git'))
     .find((candidate) => existsSync(candidate)) ?? '/usr/bin/git';
 const COLS = 80;
-const COMPOSITION = '안녕';
+const COMPOSITION = korean.greetingFirstTwoSyllables;
 const COMPOSITION_WIDTH = 4;
 
 function resolveTmux(): string | undefined {

package/src/__tests__/pty/ime-cursor.ptytest.ts

@@ -23,6 +23,7 @@ import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 
 import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import korean from '../__fixtures__/korean-text.json';
 
 import { spawnTui, writeTuiProviderSettings } from './pty-driver.js';
 import {
@@ -39,8 +40,8 @@ import type { ICursorShowEvent } from '../helpers/vt-cursor-interpreter.js';
 
 const COLS = 80;
 const PROMPT_PLACEHOLDER = /Type a message or \/help/;
-const COMPOSITION = '안녕';
-/** `안녕` occupies 4 display columns; the prompt adds `> `. */
+const COMPOSITION = korean.greetingFirstTwoSyllables;
+/** The composition occupies 4 display columns; the prompt adds `> `. */
 const COMPOSITION_WIDTH = 4;
 /** Let ink's throttled (≤30fps) frame writes flush after the last keystroke. */
 const flush = (): Promise<void> => new Promise((r) => setTimeout(r, 400));
@@ -48,7 +49,7 @@ const flush = (): Promise<void> => new Promise((r) => setTimeout(r, 400));
 interface IProbeResult {
   /** Cursor shows emitted after boot — the composition window the OS IME would act on. */
   compositionShows: ICursorShowEvent[];
-  /** Screen row holding `> 안녕`, or -1 when the composition never rendered. */
+  /** Screen row holding `> ` followed by the composition, or -1 when the composition never rendered. */
   inputRow: number;
   /** Column of the `> ` prompt on the input row, or -1. */
   promptCol: number;

package/src/__tests__/real-cursor-positioning.test.tsx

@@ -23,6 +23,7 @@ import { afterAll, afterEach, beforeAll, describe, expect, it, vi } from 'vitest
 import { interpretVtStream } from './helpers/vt-cursor-interpreter.js';
 import CjkTextInput from '../CjkTextInput.js';
 import { TerminalCapabilitiesProvider } from '../terminal-capabilities-context.js';
+import korean from './__fixtures__/korean-text.json';
 
 const COLS = 60;
 const ROWS = 24;
@@ -143,7 +144,7 @@ describe('CLI-062 — real cursor positioning (interactive ink render)', () => {
     const { stdout, stdin, unmount } = renderScenario();
     await settle();
 
-    stdin.send('안녕');
+    stdin.send(korean.greetingFirstTwoSyllables);
     await settle();
 
     const afterTwo = interpretVtStream(stdout.stream(), ROWS, COLS);
@@ -153,10 +154,10 @@ describe('CLI-062 — real cursor positioning (interactive ink render)', () => {
     for (const event of showsAfterTwo) {
       expect(event.row).toBe(INPUT_ROW);
     }
-    // Composition column: '> ' (2 cols) + 안녕 (2 wide chars = 4 cols).
+    // Composition column: '> ' (2 cols) + two syllables (2 wide chars = 4 cols).
     expect(showsAfterTwo.at(-1)).toMatchObject({ row: INPUT_ROW, col: 6 });
 
-    stdin.send('하'); // one more wide char → +2 columns
+    stdin.send(korean.greetingThirdSyllable); // one more wide char → +2 columns
     await settle();
 
     const afterThree = interpretVtStream(stdout.stream(), ROWS, COLS);
@@ -189,7 +190,7 @@ describe('CLI-062 — real cursor positioning (interactive ink render)', () => {
     for (const bannerLines of [1, 4]) {
       const { stdout, stdin, unmount } = renderScenario(true, bannerLines);
       await settle();
-      stdin.send('안녕');
+      stdin.send(korean.greetingFirstTwoSyllables);
       await settle();
 
       const vt = interpretVtStream(stdout.stream(), ROWS, COLS);
@@ -234,7 +235,7 @@ describe('CLI-062 — real cursor positioning (interactive ink render)', () => {
       },
     );
     await settle();
-    stdin.send('안');
+    stdin.send(korean.greetingFirstSyllable);
     await settle();
     expect(interpretVtStream(stdout.stream(), ROWS, COLS).showEvents.length).toBeGreaterThan(0);
 

package/src/__tests__/streaming-indicator.test.tsx

@@ -3,6 +3,7 @@ import { describe, it, expect } from 'vitest';
 import { render } from 'ink-testing-library';
 import StreamingIndicator from '../StreamingIndicator.js';
 import { ScreenReaderProvider } from '../screen-reader-context.js';
+import korean from './__fixtures__/korean-text.json';
 
 describe('StreamingIndicator', () => {
   it('renders empty when no tools and no text', () => {
@@ -52,7 +53,7 @@ describe('StreamingIndicator', () => {
   });
 
   it('preserves CJK and emoji text in streaming output', () => {
-    const text = '긴 한국어 응답과 emoji 🎉 를 스트리밍합니다';
+    const text = korean.longResponseStreaming;
     const { lastFrame } = render(<StreamingIndicator text={text} activeTools={[]} />);
 
     expect(lastFrame()).toContain(text);

package/src/attention/__tests__/focus-input-filter.test.ts

@@ -1,6 +1,7 @@
 import { EventEmitter } from 'node:events';
 
 import { describe, expect, it, vi } from 'vitest';
+import korean from '../../__tests__/__fixtures__/korean-text.json';
 
 import { filterFocusSequences, FocusReportingStdin } from '../focus-input-filter.js';
 import { createFocusReportingWriter } from '../../terminal-focus-reporting.js';
@@ -33,8 +34,8 @@ describe('focus input filter (SCREEN-1992 TC-06)', () => {
     expect(filterFocusSequences(Buffer.from('A'), true).forwarded.toString()).toBe('A');
     const paste = '\x1b[200~pasted \x1b[I text\x1b[201~';
     expect(filterFocusSequences(Buffer.from(paste), false).forwarded.toString()).toBe(paste);
-    const utf8 = Buffer.from('한글\x1b[O😀');
-    expect(filterFocusSequences(utf8, true).forwarded.toString()).toBe('한글😀');
+    const utf8 = Buffer.from(`${korean.hangulWord}\x1b[O😀`);
+    expect(filterFocusSequences(utf8, true).forwarded.toString()).toBe(`${korean.hangulWord}😀`);
   });
 
   it('proxies stdin: reports focus and keystrokes, forwards isTTY/setRawMode/ref/unref', async () => {

package/src/flows/__tests__/defer-submit.test.ts

@@ -5,6 +5,7 @@ import {
   createDeferSubmitState,
   scheduleDeferredSubmit,
 } from '../defer-submit.js';
+import korean from '../../__tests__/__fixtures__/korean-text.json';
 
 /**
  * CLI-061 — the deferred-submit orchestration. The load-bearing property: at fire time the submit reads
@@ -30,16 +31,16 @@ describe('scheduleDeferredSubmit (CLI-061)', () => {
     const sched = manualScheduler();
 
     // Value at Enter/schedule time is the pre-trailing-char string...
-    let live = '안녕하세';
+    let live: string = korean.greetingWithoutLastSyllable;
     scheduleDeferredSubmit(state, () => live, submit, 50, sched.schedule);
     expect(submit).not.toHaveBeenCalled(); // deferred, not immediate
 
     // ...the trailing syllable lands during the window...
-    live = '안녕하세요';
+    live = korean.greeting;
     sched.fire();
 
     expect(submit).toHaveBeenCalledTimes(1);
-    expect(submit).toHaveBeenCalledWith('안녕하세요'); // FULL value — fails on the pre-fix immediate submit
+    expect(submit).toHaveBeenCalledWith(korean.greeting); // FULL value — fails on the pre-fix immediate submit
   });
 
   it('ignores a second submit while one is in flight (no double-submit)', () => {

package/src/flows/__tests__/real-cursor-flow.test.ts

@@ -9,6 +9,7 @@
  */
 
 import { describe, expect, it } from 'vitest';
+import korean from '../../__tests__/__fixtures__/korean-text.json';
 
 import { computeCursorCell, shouldPositionRealCursor } from '../real-cursor-flow.js';
 
@@ -23,8 +24,15 @@ describe('computeCursorCell', () => {
     expect(computeCursorCell({ ...origin, value: 'hello', cursor: 0 })).toEqual({ x: 3, y: 2 });
   });
 
-  it('CJK wide chars count 2 columns each (안녕 → 4 columns)', () => {
-    expect(computeCursorCell({ ...origin, value: '안녕', cursor: 2, availableWidth: 20 })).toEqual({
+  it('CJK wide chars count 2 columns each (two syllables → 4 columns)', () => {
+    expect(
+      computeCursorCell({
+        ...origin,
+        value: korean.greetingFirstTwoSyllables,
+        cursor: 2,
+        availableWidth: 20,
+      }),
+    ).toEqual({
       x: 7,
       y: 2,
     });
@@ -32,12 +40,14 @@ describe('computeCursorCell', () => {
 
   it('mid-string cursor inside a CJK value', () => {
     expect(
-      computeCursorCell({ ...origin, value: '안녕하세요', cursor: 2, availableWidth: 20 }),
+      computeCursorCell({ ...origin, value: korean.greeting, cursor: 2, availableWidth: 20 }),
     ).toEqual({ x: 7, y: 2 });
   });
 
   it('no wrap width: CJK offset is the plain display-width sum', () => {
-    expect(computeCursorCell({ ...origin, value: '안녕하', cursor: 3 })).toEqual({ x: 9, y: 2 });
+    expect(
+      computeCursorCell({ ...origin, value: korean.greetingFirstThreeSyllables, cursor: 3 }),
+    ).toEqual({ x: 9, y: 2 });
   });
 
   it('wraps to the next row when the offset passes the width', () => {
@@ -56,7 +66,12 @@ describe('computeCursorCell', () => {
     // 9 ASCII cols + a wide char that cannot fit in the last column: displayOffset skips the
     // dead column (9 → 10) then adds the wide char (→ 12) — cursor lands at row+1, col 2.
     expect(
-      computeCursorCell({ ...origin, value: 'aaaaaaaaa안', cursor: 10, availableWidth: 10 }),
+      computeCursorCell({
+        ...origin,
+        value: `aaaaaaaaa${korean.greetingFirstSyllable}`,
+        cursor: 10,
+        availableWidth: 10,
+      }),
     ).toEqual({ x: 5, y: 3 });
   });
 

package/src/flows/defer-submit.ts

@@ -3,7 +3,7 @@
  *
  * IME composition is finalized by the terminal, which writes the final composed character into the pty as its
  * OWN stdin event that arrives JUST AFTER the confirming `\r`. If we submit synchronously on Enter, the trailing
- * syllable has not yet been applied to the input state, so it is dropped (`안녕하세요` → `안녕하세`). Deferring the
+ * syllable has not yet been applied to the input state, so it is dropped (a five-syllable Korean greeting loses its last syllable). Deferring the
  * submit a few milliseconds lets that trailing event land, after which we re-read the LATEST value and submit it.
  *
  * This is the same app-layer fix Gemini CLI applied on the same Ink (PR #4987/#7556); no framework change and