@rk0429/agentic-relay 19.2.0 → 19.2.1

package/dist/interfaces/cli/relay-shell.js

@@ -1,10 +1,11 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useState } from "react";
-import { Box, render, useApp, useInput } from "ink";
+import { useEffect, useRef, useState } from "react";
+import { Box, render, useApp, useStdin } from "ink";
 import { Header } from "./components/Header.js";
 import { MessageList } from "./components/MessageList.js";
 import { InputBar } from "./components/InputBar.js";
 import { StatusBar } from "./components/StatusBar.js";
+import { classifyInput, deleteLastGrapheme, ENABLE_BRACKETED_PASTE, DISABLE_BRACKETED_PASTE, } from "./text-input-utils.js";
 export async function runRelayInteractiveShell(options) {
     const instance = render(_jsx(RelayShellApp, { service: options.service, initialSession: options.initialSession }));
     await instance.waitUntilExit();
@@ -12,65 +13,98 @@ export async function runRelayInteractiveShell(options) {
 }
 function RelayShellApp(props) {
     const { exit } = useApp();
+    // ink's internal_eventEmitter provides decoded stdin chunks without
+    // conflicting with ink's readable-mode pipeline. This is an internal
+    // API (ink 6.x); if ink is upgraded, verify the emitter still exists.
+    // eslint-disable-next-line @typescript-eslint/naming-convention
+    const { setRawMode, internal_eventEmitter } = useStdin();
     const [session, setSession] = useState(props.initialSession);
     const [input, setInput] = useState("");
     const [busy, setBusy] = useState(false);
     const [notice, setNotice] = useState();
-    useInput((keyInput, key) => {
-        if (key.ctrl && keyInput === "c") {
-            exit();
-            return;
-        }
-        if (busy) {
-            return;
-        }
-        if (key.ctrl && keyInput.toLowerCase() === "b") {
-            const nextSession = props.service.cycleInteractiveBackend(session);
-            setSession(nextSession);
-            setNotice(nextSession.currentBackend === session.currentBackend
-                ? "No alternative backend is available."
-                : `Switched to ${nextSession.currentBackend}.`);
-            return;
-        }
-        if (key.return) {
-            const prompt = input.trim();
-            if (!prompt) {
+    // Refs to avoid re-registering the stdin listener on every state change.
+    const inputRef = useRef(input);
+    const sessionRef = useRef(session);
+    const busyRef = useRef(busy);
+    inputRef.current = input;
+    sessionRef.current = session;
+    busyRef.current = busy;
+    // Enable raw mode + bracketed paste on mount; clean up on unmount.
+    useEffect(() => {
+        setRawMode(true);
+        process.stdout.write(ENABLE_BRACKETED_PASTE);
+        return () => {
+            setRawMode(false);
+            process.stdout.write(DISABLE_BRACKETED_PASTE);
+        };
+    }, [setRawMode]);
+    // Custom stdin handler — replaces ink's useInput so that multi-byte
+    // CJK characters and bracketed-paste sequences are kept intact.
+    useEffect(() => {
+        const handleData = (data) => {
+            const action = classifyInput(data);
+            if (action.kind === "control" && action.name === "ctrl-c") {
+                exit();
                 return;
             }
-            setBusy(true);
-            setNotice(undefined);
-            setInput("");
-            void props.service
-                .submitInteractivePrompt(session, prompt)
-                .then((result) => {
-                setSession(result.session);
-                setNotice(result.handoff
-                    ? `Started ${result.session.currentBackend} with handoff from ${result.handoff.source_backend}.`
-                    : undefined);
-            })
-                .catch((error) => {
-                const message = error instanceof Error ? error.message : String(error);
-                setSession((previous) => props.service.appendInteractiveMessage(previous, {
-                    role: "error",
-                    backend: previous.currentBackend,
-                    content: message,
-                }));
-                setNotice(message);
-            })
-                .finally(() => {
-                setBusy(false);
-            });
-            return;
-        }
-        if (key.backspace || key.delete) {
-            setInput((previous) => previous.slice(0, -1));
-            return;
-        }
-        if (key.ctrl || key.meta || key.escape || !keyInput) {
-            return;
-        }
-        setInput((previous) => previous + keyInput);
-    });
+            if (busyRef.current)
+                return;
+            if (action.kind === "control") {
+                switch (action.name) {
+                    case "ctrl-b": {
+                        const current = sessionRef.current;
+                        const nextSession = props.service.cycleInteractiveBackend(current);
+                        setSession(nextSession);
+                        setNotice(nextSession.currentBackend === current.currentBackend
+                            ? "No alternative backend is available."
+                            : `Switched to ${nextSession.currentBackend}.`);
+                        return;
+                    }
+                    case "return": {
+                        const prompt = inputRef.current.trim();
+                        if (!prompt)
+                            return;
+                        setBusy(true);
+                        setNotice(undefined);
+                        setInput("");
+                        void props.service
+                            .submitInteractivePrompt(sessionRef.current, prompt)
+                            .then((result) => {
+                            setSession(result.session);
+                            setNotice(result.handoff
+                                ? `Started ${result.session.currentBackend} with handoff from ${result.handoff.source_backend}.`
+                                : undefined);
+                        })
+                            .catch((error) => {
+                            const message = error instanceof Error ? error.message : String(error);
+                            setSession((previous) => props.service.appendInteractiveMessage(previous, {
+                                role: "error",
+                                backend: previous.currentBackend,
+                                content: message,
+                            }));
+                            setNotice(message);
+                        })
+                            .finally(() => {
+                            setBusy(false);
+                        });
+                        return;
+                    }
+                    case "backspace":
+                        setInput((previous) => deleteLastGrapheme(previous));
+                        return;
+                    default:
+                        return;
+                }
+            }
+            if (action.kind === "text") {
+                setInput((previous) => previous + action.value);
+            }
+        };
+        internal_eventEmitter?.on("input", handleData);
+        return () => {
+            internal_eventEmitter?.removeListener("input", handleData);
+        };
+    }, [internal_eventEmitter, exit, props.service]);
     return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Header, { session: session }), _jsx(MessageList, { session: session }), _jsx(InputBar, { input: input, busy: busy }), _jsx(StatusBar, { notice: notice, busy: busy })] }));
 }
 //# sourceMappingURL=relay-shell.js.map

package/dist/interfaces/cli/relay-shell.js.map

@@ -1 +1 @@
-{"version":3,"file":"relay-shell.js","sourceRoot":"","sources":["../../../src/interfaces/cli/relay-shell.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"relay-shell.js","sourceRoot":"","sources":["../../../src/interfaces/cli/relay-shell.tsx"],"names":[],"mappings":"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"}

package/dist/interfaces/cli/text-input-utils.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Delete the last grapheme cluster from a string.
+ * Unlike `str.slice(0, -1)` which operates on UTF-16 code units,
+ * this correctly handles CJK characters, emoji, surrogate pairs,
+ * and combining characters.
+ */
+export declare function deleteLastGrapheme(str: string): string;
+/**
+ * Bracketed paste mode escape sequences.
+ * When enabled, the terminal wraps pasted text in these markers,
+ * allowing the application to distinguish pasted text from typed input.
+ * Some terminals also use this for IME-committed text.
+ */
+export declare const BRACKETED_PASTE_START = "\u001B[200~";
+export declare const BRACKETED_PASTE_END = "\u001B[201~";
+export declare const ENABLE_BRACKETED_PASTE = "\u001B[?2004h";
+export declare const DISABLE_BRACKETED_PASTE = "\u001B[?2004l";
+/**
+ * Extract text from a bracketed paste sequence.
+ * Returns the inner text if the string contains bracketed paste markers,
+ * or undefined if no markers are found.
+ */
+export declare function extractBracketedPaste(data: string): string | undefined;
+export type InputAction = {
+    kind: "text";
+    value: string;
+} | {
+    kind: "control";
+    name: string;
+} | {
+    kind: "ignore";
+};
+/**
+ * Classify a raw stdin chunk into an action.
+ *
+ * Unlike ink's `parseKeypress`, this treats multi-byte CJK characters,
+ * emoji, and bracketed-paste sequences as indivisible text rather than
+ * trying to classify them as key combinations.
+ */
+export declare function classifyInput(data: string): InputAction;

package/dist/interfaces/cli/text-input-utils.js

@@ -0,0 +1,90 @@
+const segmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+/**
+ * Delete the last grapheme cluster from a string.
+ * Unlike `str.slice(0, -1)` which operates on UTF-16 code units,
+ * this correctly handles CJK characters, emoji, surrogate pairs,
+ * and combining characters.
+ */
+export function deleteLastGrapheme(str) {
+    if (str.length === 0) {
+        return str;
+    }
+    const segments = [...segmenter.segment(str)];
+    if (segments.length === 0) {
+        return str;
+    }
+    const last = segments[segments.length - 1];
+    return str.slice(0, last.index);
+}
+/**
+ * Bracketed paste mode escape sequences.
+ * When enabled, the terminal wraps pasted text in these markers,
+ * allowing the application to distinguish pasted text from typed input.
+ * Some terminals also use this for IME-committed text.
+ */
+export const BRACKETED_PASTE_START = "\x1b[200~";
+export const BRACKETED_PASTE_END = "\x1b[201~";
+export const ENABLE_BRACKETED_PASTE = "\x1b[?2004h";
+export const DISABLE_BRACKETED_PASTE = "\x1b[?2004l";
+/**
+ * Extract text from a bracketed paste sequence.
+ * Returns the inner text if the string contains bracketed paste markers,
+ * or undefined if no markers are found.
+ */
+export function extractBracketedPaste(data) {
+    const startIdx = data.indexOf(BRACKETED_PASTE_START);
+    if (startIdx === -1) {
+        return undefined;
+    }
+    const contentStart = startIdx + BRACKETED_PASTE_START.length;
+    const endIdx = data.indexOf(BRACKETED_PASTE_END, contentStart);
+    if (endIdx === -1) {
+        // Paste end marker not found; treat everything after start as pasted text
+        return data.slice(contentStart);
+    }
+    return data.slice(contentStart, endIdx);
+}
+/**
+ * Classify a raw stdin chunk into an action.
+ *
+ * Unlike ink's `parseKeypress`, this treats multi-byte CJK characters,
+ * emoji, and bracketed-paste sequences as indivisible text rather than
+ * trying to classify them as key combinations.
+ */
+export function classifyInput(data) {
+    // --- bracketed paste -------------------------------------------------
+    const pasted = extractBracketedPaste(data);
+    if (pasted !== undefined) {
+        // Strip newlines from pasted text (single-line input bar)
+        const cleaned = pasted.replace(/[\r\n]+/g, " ").trim();
+        return cleaned ? { kind: "text", value: cleaned } : { kind: "ignore" };
+    }
+    // --- ctrl+key --------------------------------------------------------
+    if (data === "\x03")
+        return { kind: "control", name: "ctrl-c" };
+    if (data === "\x02")
+        return { kind: "control", name: "ctrl-b" };
+    // --- enter / return --------------------------------------------------
+    if (data === "\r" || data === "\n")
+        return { kind: "control", name: "return" };
+    // --- backspace / delete ----------------------------------------------
+    if (data === "\x7f" || data === "\b" || data === "\x1b\x7f" || data === "\x1b\b") {
+        return { kind: "control", name: "backspace" };
+    }
+    // --- escape / escape sequences (arrows, function keys, etc.) ---------
+    if (data === "\x1b" || data === "\x1b\x1b")
+        return { kind: "control", name: "escape" };
+    if (data.startsWith("\x1b[") || data.startsWith("\x1bO"))
+        return { kind: "ignore" };
+    if (/^\x1b[a-zA-Z0-9]$/.test(data))
+        return { kind: "ignore" };
+    // --- tab -------------------------------------------------------------
+    if (data === "\t")
+        return { kind: "ignore" };
+    // --- remaining ctrl characters (0x01–0x1a except the ones above) -----
+    if (data.length === 1 && data <= "\x1a")
+        return { kind: "ignore" };
+    // --- printable text (ASCII, CJK, emoji, etc.) ------------------------
+    return { kind: "text", value: data };
+}
+//# sourceMappingURL=text-input-utils.js.map

package/dist/interfaces/cli/text-input-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-input-utils.js","sourceRoot":"","sources":["../../../src/interfaces/cli/text-input-utils.ts"],"names":[],"mappings":"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"}

package/dist/interfaces/mcp/relay-mcp-server.js

@@ -701,7 +701,7 @@ const TOOL_DESCRIPTIONS = {
 export function createRelayMcpServer(options) {
     const server = new McpServer({
         name: "agentic-relay",
-        version: "19.2.0",
+        version: "19.2.1",
     });
     if (options.allowSpawnAgents) {
         server.registerTool("spawn_agents", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rk0429/agentic-relay",
-  "version": "19.2.0",
+  "version": "19.2.1",
   "displayName": "agentic-relay",
   "description": "Unified MCP relay for Claude Code, Codex CLI, and Gemini CLI",
   "type": "module",