@jpssff/vanor 0.1.0

package/base/test/statusbar.test.js

@@ -0,0 +1,143 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { StatusBar } from "../transport/statusbar.js";
+
+// 在受控的“伪 TTY”下捕获 StatusBar 的输出
+function captureTTY(fn) {
+  const out = [];
+  const orig = {
+    write: process.stdout.write,
+    isTTY: process.stdout.isTTY,
+    columns: process.stdout.columns,
+    rows: process.stdout.rows,
+  };
+  try {
+    process.stdout.isTTY = true;
+    process.stdout.columns = 80;
+    process.stdout.rows = 24;
+    process.stdout.write = (s) => {
+      out.push(s);
+      return true;
+    };
+    fn();
+  } finally {
+    process.stdout.write = orig.write;
+    process.stdout.isTTY = orig.isTTY;
+    process.stdout.columns = orig.columns;
+    process.stdout.rows = orig.rows;
+  }
+  return out.join("");
+}
+
+test("TTY 下渲染上下文/模型，并设置滚动区", () => {
+  const joined = captureTTY(() => {
+    const sb = new StatusBar(() => ({ used: 10, total: 100, model: "p/m", cwd: "/tmp/x" }));
+    sb.enable();
+    sb.render();
+    sb.disable();
+  });
+  assert.match(joined, /ctx 10\/100/);
+  assert.match(joined, /p\/m/);
+  assert.match(joined, /tmp\/x/);
+  assert.match(joined, /\x1b\[1;23r/); // 滚动区 1..rows-1
+  assert.match(joined, /\x1b\[r/); // disable 时重置滚动区
+});
+
+test("auto 审批模式显示 ⚡auto 标记", () => {
+  const joined = captureTTY(() => {
+    const sb = new StatusBar(() => ({ used: 1, total: 100, model: "m", cwd: "/", approval: "auto" }));
+    sb.enable();
+    sb.render();
+    sb.disable();
+  });
+  assert.match(joined, /auto/);
+});
+
+test("可为固定输入行预留滚动区底部空间", () => {
+  const joined = captureTTY(() => {
+    const sb = new StatusBar(() => ({ used: 1, total: 100, model: "m", cwd: "/" }), { reservedInputLines: 1 });
+    sb.enable();
+    sb.disable();
+  });
+  assert.match(joined, /\x1b\[1;22r/); // 24 行终端：1..22 输出滚动，23 输入，24 状态
+});
+
+test("disable 清理底部保留区域，避免退出后残留输入行/状态栏", () => {
+  const joined = captureTTY(() => {
+    const sb = new StatusBar(() => ({ used: 1, total: 100, model: "m", cwd: "/" }), { reservedInputLines: 1 });
+    sb.enable();
+    sb.disable();
+  });
+  assert.match(joined, /\x1b\[r/); // 重置滚动区
+  assert.match(joined, /\x1b\[23;1H\x1b\[J/); // 从输入行清到屏幕底部
+});
+
+test("非 TTY 下不启用、不输出", () => {
+  const sb = new StatusBar(() => ({ used: 1, total: 2, model: "m", cwd: "/" }));
+  // 默认测试环境非 TTY
+  sb.enable();
+  assert.equal(sb.enabled, false);
+});
+
+test("脏检查：内容不变时重复渲染不再写入（防闪）", () => {
+  let writes = 0;
+  const orig = {
+    write: process.stdout.write,
+    isTTY: process.stdout.isTTY,
+    columns: process.stdout.columns,
+    rows: process.stdout.rows,
+  };
+  try {
+    process.stdout.isTTY = true;
+    process.stdout.columns = 80;
+    process.stdout.rows = 24;
+    process.stdout.write = () => {
+      writes++;
+      return true;
+    };
+    const sb = new StatusBar(() => ({ used: 5, total: 100, model: "m", cwd: "/" }));
+    sb.enable();
+    const baseline = writes; // enable 已完成首次绘制
+    sb.render();
+    sb.render();
+    assert.equal(writes, baseline); // 内容相同：不产生任何新的写入
+    sb.disable();
+  } finally {
+    process.stdout.write = orig.write;
+    process.stdout.isTTY = orig.isTTY;
+    process.stdout.columns = orig.columns;
+    process.stdout.rows = orig.rows;
+  }
+});
+
+test("内容变化时重新渲染（脏检查不误伤）", () => {
+  let used = 5;
+  let writes = 0;
+  const orig = {
+    write: process.stdout.write,
+    isTTY: process.stdout.isTTY,
+    columns: process.stdout.columns,
+    rows: process.stdout.rows,
+  };
+  try {
+    process.stdout.isTTY = true;
+    process.stdout.columns = 80;
+    process.stdout.rows = 24;
+    process.stdout.write = () => {
+      writes++;
+      return true;
+    };
+    const sb = new StatusBar(() => ({ used, total: 100, model: "m", cwd: "/" }));
+    sb.enable();
+    const baseline = writes;
+    used = 42; // 上下文用量变化
+    sb.render();
+    assert.ok(writes > baseline); // 内容变化：应重新写入
+    sb.disable();
+  } finally {
+    process.stdout.write = orig.write;
+    process.stdout.isTTY = orig.isTTY;
+    process.stdout.columns = orig.columns;
+    process.stdout.rows = orig.rows;
+  }
+});

package/base/test/tools.test.js

@@ -0,0 +1,127 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { createSecurity } from "../security/index.js";
+import { defaultRegistry, createToolContext, runToolCall } from "../tools/index.js";
+import { NullLogger } from "../logger.js";
+
+function tempWorkspace() {
+  return fs.mkdtempSync(path.join(os.tmpdir(), "vanor-test-"));
+}
+
+function ctxFor(ws, overrides = {}) {
+  const security = createSecurity({
+    security: { approval: "ask", allowlist: [], denylist: ["rm -rf *"], workspaceRoot: ws, ...overrides },
+  });
+  return createToolContext({ security, logger: new NullLogger(), confirm: async () => true });
+}
+
+test("write_file 与 read_file 往返", async () => {
+  const ws = tempWorkspace();
+  const reg = defaultRegistry();
+  const ctx = ctxFor(ws);
+
+  const w = await runToolCall(
+    { id: "1", name: "write_file", arguments: { path: "a.txt", content: "HELLO" } },
+    reg,
+    ctx,
+  );
+  assert.ok(!w.meta.isError);
+
+  const r = await runToolCall({ id: "2", name: "read_file", arguments: { path: "a.txt" } }, reg, ctx);
+  assert.equal(r.content, "HELLO");
+});
+
+test("路径越界被拒绝", async () => {
+  const ws = tempWorkspace();
+  const reg = defaultRegistry();
+  const ctx = ctxFor(ws);
+  const r = await runToolCall(
+    { id: "1", name: "read_file", arguments: { path: "/etc/hosts" } },
+    reg,
+    ctx,
+  );
+  assert.ok(r.meta.isError);
+});
+
+test("参数缺失返回错误", async () => {
+  const ws = tempWorkspace();
+  const reg = defaultRegistry();
+  const ctx = ctxFor(ws);
+  const r = await runToolCall({ id: "1", name: "read_file", arguments: {} }, reg, ctx);
+  assert.ok(r.meta.isError);
+});
+
+test("未知工具返回错误", async () => {
+  const ws = tempWorkspace();
+  const reg = defaultRegistry();
+  const ctx = ctxFor(ws);
+  const r = await runToolCall({ id: "1", name: "nope", arguments: {} }, reg, ctx);
+  assert.ok(r.meta.isError);
+});
+
+test("confirm 拒绝则不执行写入", async () => {
+  const ws = tempWorkspace();
+  const reg = defaultRegistry();
+  const security = createSecurity({ security: { approval: "ask", workspaceRoot: ws } });
+  const ctx = createToolContext({ security, logger: new NullLogger(), confirm: async () => false });
+  const r = await runToolCall(
+    { id: "1", name: "write_file", arguments: { path: "b.txt", content: "x" } },
+    reg,
+    ctx,
+  );
+  assert.ok(r.meta.isError);
+  assert.ok(!fs.existsSync(path.join(ws, "b.txt")));
+});
+
+test("setApproval(auto) 后写文件无需确认", async () => {
+  const ws = tempWorkspace();
+  const reg = defaultRegistry();
+  const security = createSecurity({ security: { approval: "ask", workspaceRoot: ws } });
+  let confirmCalls = 0;
+  const ctx = createToolContext({
+    security,
+    logger: new NullLogger(),
+    confirm: async () => {
+      confirmCalls++;
+      return false;
+    },
+  });
+  // ask 模式：confirm 返回 false → 拒绝
+  const r1 = await runToolCall({ id: "1", name: "write_file", arguments: { path: "a.txt", content: "x" } }, reg, ctx);
+  assert.ok(r1.meta.isError);
+  // 运行时切到 auto → 不再询问，直接放行
+  security.setApproval("auto");
+  const r2 = await runToolCall({ id: "2", name: "write_file", arguments: { path: "b.txt", content: "y" } }, reg, ctx);
+  assert.ok(!r2.meta.isError);
+  assert.equal(confirmCalls, 1);
+});
+
+test("setApproval(auto) 不绕过 denylist", async () => {
+  const ws = tempWorkspace();
+  const reg = defaultRegistry();
+  const security = createSecurity({
+    security: { approval: "ask", denylist: ["rm -rf *"], workspaceRoot: ws },
+  });
+  security.setApproval("auto");
+  const ctx = createToolContext({ security, logger: new NullLogger(), confirm: async () => true });
+  const r = await runToolCall({ id: "1", name: "exec", arguments: { command: "rm -rf /tmp/x" } }, reg, ctx);
+  assert.ok(r.meta.isError);
+});
+
+test("denylist 命中 exec 被拒", async () => {
+  const ws = tempWorkspace();
+  const security = createSecurity({
+    security: { approval: "auto", denylist: ["rm -rf *"], workspaceRoot: ws },
+  });
+  const ctx = createToolContext({ security, logger: new NullLogger(), confirm: async () => true });
+  const reg = defaultRegistry();
+  const r = await runToolCall(
+    { id: "1", name: "exec", arguments: { command: "rm -rf /tmp/x" } },
+    reg,
+    ctx,
+  );
+  assert.ok(r.meta.isError);
+});

package/base/test/trace.test.js

@@ -0,0 +1,62 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { createTracer, maskValue, redactHeaders } from "../llm/trace.js";
+import { EVENTS } from "../events.js";
+
+function fakeLogger() {
+  return {
+    calls: [],
+    info(event, detail) {
+      this.calls.push({ event, detail });
+    },
+    debug() {},
+    warn() {},
+    error() {},
+  };
+}
+
+test("maskValue 掩码长串保留首尾", () => {
+  const m = maskValue("Bearer sk-tr-v1-0123456789abcdef");
+  assert.match(m, /…/);
+  assert.notEqual(m, "Bearer sk-tr-v1-0123456789abcdef");
+});
+
+test("默认关闭时不记录", () => {
+  const log = fakeLogger();
+  const t = createTracer({ logging: { llmTrace: false } }, log);
+  assert.equal(t.enabled, false);
+  t.request({ provider: "p", model: "m", url: "u", headers: {}, body: {} });
+  t.response({ provider: "p", model: "m", status: 200 });
+  assert.equal(log.calls.length, 0);
+});
+
+test("开启时记录请求并默认脱敏 Authorization", () => {
+  const log = fakeLogger();
+  const t = createTracer({ logging: { llmTrace: true } }, log);
+  t.request({
+    provider: "p",
+    model: "m",
+    url: "https://x/api",
+    headers: { Authorization: "Bearer sk-tr-v1-0123456789abcdef", "Content-Type": "application/json" },
+    body: { model: "m" },
+  });
+  assert.equal(log.calls.length, 1);
+  assert.equal(log.calls[0].event, EVENTS.llm.requestDetail);
+  const h = log.calls[0].detail.headers;
+  assert.match(h.Authorization, /…/);
+  assert.equal(h["Content-Type"], "application/json");
+});
+
+test("关闭脱敏时保留完整 Authorization", () => {
+  const headers = { Authorization: "Bearer sk-tr-v1-0123456789abcdef" };
+  const redacted = redactHeaders(headers, false);
+  assert.equal(redacted.Authorization, headers.Authorization);
+});
+
+test("记录响应详情含返回内容", () => {
+  const log = fakeLogger();
+  const t = createTracer({ logging: { llmTrace: true } }, log);
+  t.response({ provider: "p", model: "m", status: 200, ms: 12, text: "hi", toolCalls: [], usage: null });
+  assert.equal(log.calls[0].event, EVENTS.llm.responseDetail);
+  assert.equal(log.calls[0].detail.text, "hi");
+});

package/base/test/tui.test.js

@@ -0,0 +1,242 @@
+import { EventEmitter } from "node:events";
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { advanceCursor, charWidth, displayWidth, stripAnsi, TerminalUI } from "../transport/tui.js";
+
+class FakeInput extends EventEmitter {
+  constructor() {
+    super();
+    this.isTTY = true;
+    this.raw = false;
+  }
+  setRawMode(v) {
+    this.raw = v;
+  }
+  setEncoding() {}
+  resume() {}
+}
+
+class FakeOutput {
+  constructor() {
+    this.isTTY = true;
+    this.rows = 24;
+    this.columns = 80;
+    this.out = [];
+  }
+  write(s) {
+    this.out.push(String(s));
+    return true;
+  }
+  text() {
+    return this.out.join("");
+  }
+}
+
+function fakeStatusBar() {
+  return {
+    inputRow: () => 23,
+    scrollBottom: () => 22,
+  };
+}
+
+test("stripAnsi 去除颜色序列", () => {
+  assert.equal(stripAnsi("\x1b[36m› \x1b[0mhello"), "› hello");
+});
+
+test("中文宽字符按 2 列计算", () => {
+  assert.equal(charWidth("你"), 2);
+  assert.equal(displayWidth("你好 Vanor"), 10);
+});
+
+test("advanceCursor 在滚动区底部换行时保持在底部", () => {
+  assert.deepEqual(advanceCursor({ row: 22, col: 1, cols: 80, bottom: 22 }, "abc\n"), { row: 22, col: 1 });
+  assert.deepEqual(advanceCursor({ row: 21, col: 79, cols: 80, bottom: 22 }, "ab"), { row: 22, col: 1 });
+});
+
+test("advanceCursor 按终端显示列宽推进中文输出", () => {
+  assert.deepEqual(advanceCursor({ row: 22, col: 1, cols: 80, bottom: 22 }, "你"), { row: 22, col: 3 });
+  assert.deepEqual(advanceCursor({ row: 22, col: 1, cols: 80, bottom: 22 }, "你好"), { row: 22, col: 5 });
+});
+
+test("TerminalUI 渲染固定输入行并在输出后重画草稿", () => {
+  const input = new FakeInput();
+  const output = new FakeOutput();
+  const tui = new TerminalUI({ input, output, statusBar: fakeStatusBar(), prompt: "› " });
+  assert.equal(tui.enable(), true);
+
+  input.emit("data", "下一轮问题");
+  const before = output.text();
+  assert.match(before, /\x1b\[23;1H\x1b\[2K› 下一轮问题/);
+
+  tui.write("agent output\n");
+  const after = output.text();
+  assert.match(after, /\x1b\[22;1Hagent output\n\x1b8/); // 输出写入滚动区底部
+  assert.match(after, /\x1b\[23;1H\x1b\[2K› 下一轮问题/); // 草稿仍在固定输入行
+});
+
+test("TerminalUI 中文流式分片不会互相覆盖", () => {
+  const input = new FakeInput();
+  const output = new FakeOutput();
+  const tui = new TerminalUI({ input, output, statusBar: fakeStatusBar(), prompt: "› " });
+  tui.enable();
+
+  tui.write("你");
+  tui.write("好");
+
+  const out = output.text();
+  assert.match(out, /\x1b\[22;1H你\x1b8/);
+  assert.match(out, /\x1b\[22;3H好\x1b8/);
+});
+
+test("TerminalUI 中文输入光标按显示列定位", () => {
+  const input = new FakeInput();
+  const output = new FakeOutput();
+  const tui = new TerminalUI({ input, output, statusBar: fakeStatusBar(), prompt: "› " });
+  tui.enable();
+
+  input.emit("data", "你");
+
+  assert.match(output.text(), /\x1b\[23;1H\x1b\[2K› 你\x1b\[23;5H/);
+});
+
+test("TerminalUI 运行中提交的输入会排队", async () => {
+  const input = new FakeInput();
+  const output = new FakeOutput();
+  const tui = new TerminalUI({ input, output, statusBar: fakeStatusBar(), prompt: "› " });
+  tui.enable();
+
+  input.emit("data", "queued");
+  input.emit("data", "\r");
+  assert.equal(await tui.readLine(), "queued");
+});
+
+test("TerminalUI 上下键切换提交历史", async () => {
+  const input = new FakeInput();
+  const output = new FakeOutput();
+  const tui = new TerminalUI({ input, output, statusBar: fakeStatusBar(), prompt: "› " });
+  tui.enable();
+
+  input.emit("data", "first");
+  input.emit("data", "\r");
+  input.emit("data", "second");
+  input.emit("data", "\r");
+  assert.equal(await tui.readLine(), "first");
+  assert.equal(await tui.readLine(), "second");
+
+  input.emit("data", "draft");
+  input.emit("data", "\x1b[A");
+  assert.equal(tui.buffer, "second");
+  input.emit("data", "\x1b[A");
+  assert.equal(tui.buffer, "first");
+  input.emit("data", "\x1b[B");
+  assert.equal(tui.buffer, "second");
+  input.emit("data", "\x1b[B");
+  assert.equal(tui.buffer, "draft");
+});
+
+test("TerminalUI 支持被拆分的上下键转义序列", async () => {
+  const input = new FakeInput();
+  const output = new FakeOutput();
+  const tui = new TerminalUI({ input, output, statusBar: fakeStatusBar(), prompt: "› " });
+  tui.enable();
+
+  input.emit("data", "history");
+  input.emit("data", "\r");
+  assert.equal(await tui.readLine(), "history");
+
+  input.emit("data", "\x1b");
+  input.emit("data", "[");
+  input.emit("data", "A");
+  assert.equal(tui.buffer, "history");
+  assert.doesNotMatch(tui.buffer, /\[A/);
+
+  input.emit("data", "\x1b");
+  input.emit("data", "[");
+  input.emit("data", "B");
+  assert.equal(tui.buffer, "");
+  assert.doesNotMatch(tui.buffer, /\[B/);
+});
+
+test("TerminalUI 支持粘贴整段文本并提交", async () => {
+  const input = new FakeInput();
+  const output = new FakeOutput();
+  const tui = new TerminalUI({ input, output, statusBar: fakeStatusBar(), prompt: "› " });
+  tui.enable();
+
+  input.emit("data", "粘贴文本\r");
+  assert.equal(await tui.readLine(), "粘贴文本");
+});
+
+test("TerminalUI 开启和关闭 bracketed paste", () => {
+  const input = new FakeInput();
+  const output = new FakeOutput();
+  const tui = new TerminalUI({ input, output, statusBar: fakeStatusBar(), prompt: "› " });
+  tui.enable();
+  tui.disable();
+
+  const out = output.text();
+  assert.match(out, /\x1b\[\?2004h/);
+  assert.match(out, /\x1b\[\?2004l/);
+});
+
+test("TerminalUI bracketed paste 多行文本作为同一条输入提交", async () => {
+  const input = new FakeInput();
+  const output = new FakeOutput();
+  const tui = new TerminalUI({ input, output, statusBar: fakeStatusBar(), prompt: "› " });
+  tui.enable();
+
+  input.emit("data", "\x1b[200~第一行\n第二行\n第三行\x1b[201~");
+  assert.equal(tui.queue.length, 0); // 粘贴中的换行不触发提交
+  assert.equal(tui.buffer, "第一行\n第二行\n第三行");
+  assert.match(output.text(), /第一行↵ 第二行↵ 第三行/);
+
+  input.emit("data", "\r");
+  assert.equal(await tui.readLine(), "第一行\n第二行\n第三行");
+});
+
+test("TerminalUI bracketed paste 支持跨 data chunk", async () => {
+  const input = new FakeInput();
+  const output = new FakeOutput();
+  const tui = new TerminalUI({ input, output, statusBar: fakeStatusBar(), prompt: "› " });
+  tui.enable();
+
+  input.emit("data", "\x1b[200~a\n");
+  input.emit("data", "b\nc");
+  input.emit("data", "\x1b[201~\r");
+
+  assert.equal(await tui.readLine(), "a\nb\nc");
+});
+
+test("TerminalUI confirm 临时占用输入行后恢复草稿", async () => {
+  const input = new FakeInput();
+  const output = new FakeOutput();
+  const tui = new TerminalUI({ input, output, statusBar: fakeStatusBar(), prompt: "› " });
+  tui.enable();
+  input.emit("data", "draft");
+
+  const answer = tui.ask("确认? ");
+  input.emit("data", "y");
+  input.emit("data", "\r");
+  assert.equal(await answer, "y");
+  assert.equal(tui.buffer, "draft");
+  assert.match(output.text(), /› draft/);
+});
+
+test("TerminalUI confirm 中 Ctrl-C 取消当前确认而不触发全局中断", async () => {
+  const input = new FakeInput();
+  const output = new FakeOutput();
+  const tui = new TerminalUI({ input, output, statusBar: fakeStatusBar(), prompt: "› " });
+  let interrupted = false;
+  tui.onSigint = () => {
+    interrupted = true;
+  };
+  tui.enable();
+  input.emit("data", "draft");
+
+  const answer = tui.ask("确认? ");
+  input.emit("data", "\x03");
+
+  assert.equal(await answer, "");
+  assert.equal(interrupted, false);
+  assert.equal(tui.buffer, "draft");
+});

package/base/test/utils.test.js

@@ -0,0 +1,35 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { validateSchema, globToRegExp, deepMerge, estimateTokens } from "../utils.js";
+
+test("validateSchema 校验类型与必填", () => {
+  const schema = {
+    type: "object",
+    properties: { name: { type: "string" }, age: { type: "integer" } },
+    required: ["name"],
+  };
+  assert.deepEqual(validateSchema(schema, { name: "a", age: 3 }), []);
+  assert.ok(validateSchema(schema, { age: 3 }).length === 1); // 缺 name
+  assert.ok(validateSchema(schema, { name: "a", age: 1.5 }).length === 1); // age 非整数
+});
+
+test("validateSchema 支持 enum", () => {
+  const schema = { type: "string", enum: ["a", "b"] };
+  assert.deepEqual(validateSchema(schema, "a"), []);
+  assert.equal(validateSchema(schema, "c").length, 1);
+});
+
+test("globToRegExp 通配匹配", () => {
+  assert.ok(globToRegExp("git *").test("git status"));
+  assert.ok(!globToRegExp("git *").test("npm install"));
+  assert.ok(globToRegExp("rm -rf *").test("rm -rf /tmp/x"));
+});
+
+test("deepMerge 深合并", () => {
+  assert.deepEqual(deepMerge({ a: { x: 1, y: 2 } }, { a: { y: 3 } }), { a: { x: 1, y: 3 } });
+});
+
+test("estimateTokens 近似", () => {
+  assert.equal(estimateTokens("abcd"), 1);
+  assert.equal(estimateTokens(""), 0);
+});