feat: add tmux-style process key helpers

src/agents/pty-keys.test.ts

@@ -0,0 +1,33 @@
+import { expect, test } from "vitest";
+
+import { BRACKETED_PASTE_END, BRACKETED_PASTE_START, encodeKeySequence, encodePaste } from "./pty-keys.js";
+
+test("encodeKeySequence maps common keys and modifiers", () => {
+  const enter = encodeKeySequence({ keys: ["Enter"] });
+  expect(enter.data).toBe("\r");
+
+  const ctrlC = encodeKeySequence({ keys: ["C-c"] });
+  expect(ctrlC.data).toBe("\x03");
+
+  const altX = encodeKeySequence({ keys: ["M-x"] });
+  expect(altX.data).toBe("\x1bx");
+
+  const shiftTab = encodeKeySequence({ keys: ["S-Tab"] });
+  expect(shiftTab.data).toBe("\x1b[Z");
+});
+
+test("encodeKeySequence supports hex + literal with warnings", () => {
+  const result = encodeKeySequence({
+    literal: "hi",
+    hex: ["0d", "0x0a", "zz"],
+    keys: ["Enter"],
+  });
+  expect(result.data).toBe("hi\r\n\r");
+  expect(result.warnings.length).toBe(1);
+});
+
+test("encodePaste wraps bracketed sequences by default", () => {
+  const payload = encodePaste("line1\nline2\n");
+  expect(payload.startsWith(BRACKETED_PASTE_START)).toBe(true);
+  expect(payload.endsWith(BRACKETED_PASTE_END)).toBe(true);
+});