openclaw/src/agents/bash-tools.process-send-keys.test.ts

/**
 * Regression coverage for process send-keys cursor-mode handling.
 * Cursor-sensitive keys must wait until PTY startup output establishes mode.
 */
import { expect, test } from "vitest";
import { createProcessSessionFixture } from "./bash-process-registry.test-helpers.js";
import { handleProcessSendKeys, type WritableStdin } from "./bash-tools.process-send-keys.js";

function createWritableStdinStub(): WritableStdin {
  return {
    write(dataValue: string, cb?: (err?: Error | null) => void) {
      cb?.();
    },
    end() {},
    destroyed: false,
  };
}

function expectTextContent(content: unknown, text: string) {
  const part = content as { type?: string; text?: string } | undefined;
  expect(part?.type).toBe("text");
  expect(part?.text).toContain(text);
}

test("process send-keys fails loud for unknown cursor mode when arrows depend on it", async () => {
  const result = await handleProcessSendKeys({
    sessionId: "sess-unknown-mode",
    session: createProcessSessionFixture({
      id: "sess-unknown-mode",
      command: "vim",
      backgrounded: true,
      cursorKeyMode: "unknown",
    }),
    stdin: createWritableStdinStub(),
    keys: ["up"],
  });

  expect((result.details as { status?: string }).status).toBe("failed");
  expectTextContent(result.content[0], "cursor key mode is not known yet");
});

test("process send-keys still sends non-cursor keys while mode is unknown", async () => {
  const result = await handleProcessSendKeys({
    sessionId: "sess-unknown-enter",
    session: createProcessSessionFixture({
      id: "sess-unknown-enter",
      command: "vim",
      backgrounded: true,
      cursorKeyMode: "unknown",
    }),
    stdin: createWritableStdinStub(),
    keys: ["Enter"],
  });

  expect((result.details as { status?: string }).status).toBe("running");
});

test("process send-keys reports the UTF-8 byte count", async () => {
  const result = await handleProcessSendKeys({
    sessionId: "sess-literal-bytes",
    session: createProcessSessionFixture({ id: "sess-literal-bytes", command: "cat" }),
    stdin: createWritableStdinStub(),
    literal: "你好😀",
  });

  expectTextContent(result.content[0], "Sent 10 bytes to session sess-literal-bytes");
});