minimal-agent 0.2.0 → 0.3.0

package/plugins/workflow-runner/test/expressions.test.ts

@@ -1,140 +0,0 @@
-/**
- * ============================================================
- *  test/workflows/expressions.test.ts
- * ------------------------------------------------------------
- *  workflow 表达式引擎单测：tokenizer / evalExpr / interpolate /
- *  interpolateDeep。重点覆盖：
- *    - 变量点路径（inputs.book）
- *    - 比较 + 布尔运算
- *    - 白名单内置函数（fileExists / length / lower / upper）
- *    - ${} 插值（包括括号匹配 + 转义 + 对象 JSON 化）
- *    - 安全：禁止 eval/Function 等被插入
- * ============================================================
- */
-
-import { afterEach, beforeEach, describe, expect, it, mock } from 'bun:test';
-import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-
-import { _resetWorkingDir } from '../../../src/bootstrap/workingDir.ts';
-import {
-  evalExpr,
-  interpolate,
-  interpolateDeep,
-} from '../src/expressions.ts';
-import { VarStack } from '../src/types.ts';
-
-describe('workflows/expressions', () => {
-  let vars: VarStack;
-
-  beforeEach(() => {
-    vars = new VarStack();
-    vars.setGlobal('inputs', { book: '原则', angle: 'insight', n: 3 });
-    vars.set('thumb_prompt', 'a book and a lamp');
-  });
-
-  it('字面量数字 / 字符串 / 布尔', () => {
-    expect(evalExpr('42', vars)).toBe(42);
-    expect(evalExpr('"hello"', vars)).toBe('hello');
-    expect(evalExpr("'x'", vars)).toBe('x');
-    expect(evalExpr('true', vars)).toBe(true);
-    expect(evalExpr('false', vars)).toBe(false);
-    expect(evalExpr('null', vars)).toBe(null);
-  });
-
-  it('变量 + 点路径', () => {
-    expect(evalExpr('thumb_prompt', vars)).toBe('a book and a lamp');
-    expect(evalExpr('inputs.book', vars)).toBe('原则');
-    expect(evalExpr('inputs.n', vars)).toBe(3);
-    expect(evalExpr('inputs.missing', vars)).toBeUndefined();
-  });
-
-  it('比较运算 ==/!=/>/<', () => {
-    expect(evalExpr('inputs.n == 3', vars)).toBe(true);
-    expect(evalExpr('inputs.n != 4', vars)).toBe(true);
-    expect(evalExpr('inputs.n > 2', vars)).toBe(true);
-    expect(evalExpr('inputs.n < 2', vars)).toBe(false);
-    expect(evalExpr('"a" == "a"', vars)).toBe(true);
-  });
-
-  it('布尔运算 && / || / !', () => {
-    expect(evalExpr('true && false', vars)).toBe(false);
-    expect(evalExpr('true || false', vars)).toBe(true);
-    expect(evalExpr('!false', vars)).toBe(true);
-    expect(evalExpr('inputs.n > 0 && inputs.book == "原则"', vars)).toBe(true);
-  });
-
-  it('白名单函数 length / lower / upper', () => {
-    expect(evalExpr('length("abcd")', vars)).toBe(4);
-    expect(evalExpr('length(inputs.book)', vars)).toBe(2);
-    expect(evalExpr('lower("HELLO")', vars)).toBe('hello');
-    expect(evalExpr('upper("hi")', vars)).toBe('HI');
-  });
-
-  it('未知函数被拒绝（白名单外）', () => {
-    expect(() => evalExpr('eval("1+1")', vars)).toThrow();
-    expect(() => evalExpr('require("fs")', vars)).toThrow();
-    expect(() => evalExpr('Function("x")', vars)).toThrow();
-  });
-
-  it('interpolate ${EXPR} 替换变量', () => {
-    expect(interpolate('book=${inputs.book}', vars)).toBe('book=原则');
-    expect(interpolate('${inputs.n} times', vars)).toBe('3 times');
-  });
-
-  it('interpolate 处理对象 → JSON.stringify', () => {
-    const out = interpolate('${inputs}', vars);
-    expect(out).toContain('原则');
-    expect(out).toContain('insight');
-  });
-
-  it('interpolate 支持 \\$ 转义', () => {
-    expect(interpolate('price=\\${inputs.n}', vars)).toBe('price=${inputs.n}');
-  });
-
-  it('interpolate 未闭合 ${ 原样保留', () => {
-    expect(interpolate('hello ${unclosed', vars)).toBe('hello ${unclosed');
-  });
-
-  it('interpolateDeep 递归处理对象/数组', () => {
-    const input = {
-      file_path: 'videos/${inputs.book}/script.txt',
-      content: '${thumb_prompt}',
-      nested: { list: ['${inputs.angle}', 'static'] },
-    };
-    const out = interpolateDeep(input, vars);
-    expect(out.file_path).toBe('videos/原则/script.txt');
-    expect(out.content).toBe('a book and a lamp');
-    expect(out.nested.list[0]).toBe('insight');
-    expect(out.nested.list[1]).toBe('static');
-  });
-});
-
-describe('workflows/expressions::fileExists', () => {
-  let tmp: string;
-
-  beforeEach(() => {
-    tmp = mkdtempSync(join(tmpdir(), 'wf-expr-'));
-    process.env.MINIMAL_AGENT_CWD = tmp;
-    _resetWorkingDir();
-    mock.module('../../../src/bootstrap/workingDir.ts', () => ({
-      getWorkingDir: () => tmp,
-      initWorkingDir: () => tmp,
-      _resetWorkingDir: () => {},
-    }));
-  });
-
-  afterEach(() => {
-    delete process.env.MINIMAL_AGENT_CWD;
-    _resetWorkingDir();
-    rmSync(tmp, { recursive: true, force: true });
-  });
-
-  it('fileExists 命中真实文件', () => {
-    writeFileSync(join(tmp, 'a.txt'), 'x');
-    const vars = new VarStack();
-    expect(evalExpr('fileExists("a.txt")', vars)).toBe(true);
-    expect(evalExpr('fileExists("missing.txt")', vars)).toBe(false);
-  });
-});

package/plugins/workflow-runner/test/fixtures/cli-e2e.yaml

@@ -1,27 +0,0 @@
-name: cli-e2e
-description: CLI 端到端测试 fixture：纯 Write + assert，不调 LLM 不调网络
-version: "0.1"
-
-inputs:
-  - name: topic
-    type: string
-    required: true
-
-steps:
-  - id: write_note
-    tool: Write
-    args:
-      file_path: "out/${inputs.topic}/note.txt"
-      content: "topic=${inputs.topic} ok"
-    capture:
-      args.content: note_body
-
-  - id: verify_file
-    type: assert
-    condition: 'fileExists("out/${inputs.topic}/note.txt")'
-    onFail: "note.txt 未落盘"
-
-  - id: verify_capture
-    type: assert
-    condition: 'length(note_body) > 0'
-    onFail: "capture 没绑到 note_body"

package/plugins/workflow-runner/test/fixtures/hello-workflow.yaml

@@ -1,49 +0,0 @@
-name: hello-workflow
-description: |
-  E2E 测试用极简 workflow：不依赖 LLM、不调网络，只用确定性工具。
-  覆盖：input 必填校验 / ${var} 插值 / 嵌套目录 / 多步 capture / assert+fileExists。
-version: "0.1"
-
-inputs:
-  - name: name
-    type: string
-    required: true
-    description: 收件人名字
-  - name: lang
-    type: enum
-    values: [zh, en]
-    default: en
-
-steps:
-  # 1. 写问候语文件 + capture 内容
-  - id: write_greeting
-    tool: Write
-    args:
-      file_path: "greetings/${inputs.name}/hello.txt"
-      content: "Hello, ${inputs.name}! (lang=${inputs.lang})"
-    capture:
-      args.content: greeting_text
-
-  # 2. 写 meta json
-  - id: write_meta
-    tool: Write
-    args:
-      file_path: "greetings/${inputs.name}/meta.json"
-      content: |
-        {
-          "name": "${inputs.name}",
-          "lang": "${inputs.lang}",
-          "greeting_length": ${length(greeting_text)}
-        }
-
-  # 3. 守门 assert：两个文件都得在
-  - id: verify_files
-    type: assert
-    condition: 'fileExists("greetings/${inputs.name}/hello.txt") && fileExists("greetings/${inputs.name}/meta.json")'
-    onFail: "hello-workflow 文件未全部落盘"
-
-  # 4. 守门 assert：capture 的变量非空
-  - id: verify_capture
-    type: assert
-    condition: 'length(greeting_text) > 0'
-    onFail: "capture 没绑到 greeting_text"

package/plugins/workflow-runner/test/graceful.test.ts

@@ -1,139 +0,0 @@
-/**
- * ============================================================
- *  test/workflows/graceful.test.ts
- * ------------------------------------------------------------
- *  降级契约（R1）：
- *    - workflows/ 不存在 → listWorkflows() 返回包内自带 [包内 yaml]，绝不抛错
- *    - 全是坏 yaml → 跳过坏的，列出好的
- *    - findWorkflowByName 未命中 → 返回 null（让调用方 yield 友好 error）
- *    - runWorkflowFromCommand 对未知 name → yield error，不污染 history
- *    - runWorkflowsList 在空列表时 yield 友好提示
- * ============================================================
- */
-
-import { afterEach, beforeEach, describe, expect, it, mock } from 'bun:test';
-import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-
-import { _resetWorkingDir } from '../../../src/bootstrap/workingDir.ts';
-import { listWorkflows } from '../src/loader.ts';
-import {
-  runWorkflowFromCommand,
-  runWorkflowsList,
-} from '../src/index.ts';
-import type { LoopEvent, Provider } from '../../../src/types.ts';
-import type { WorkflowEvent } from '../src/types.ts';
-
-type WfOrLoop = WorkflowEvent | LoopEvent;
-
-const fakeProvider: Provider = {
-  name: 'test',
-  baseURL: '',
-  apiKey: '',
-  model: 'm',
-  contextWindow: 128000,
-};
-
-async function collect(
-  gen: AsyncGenerator<WfOrLoop, void, void>,
-): Promise<WfOrLoop[]> {
-  const out: WfOrLoop[] = [];
-  for await (const ev of gen) out.push(ev);
-  return out;
-}
-
-describe('workflows/graceful', () => {
-  let tmp: string;
-
-  beforeEach(() => {
-    tmp = mkdtempSync(join(tmpdir(), 'wf-graceful-'));
-    process.env.MINIMAL_AGENT_CWD = tmp;
-    _resetWorkingDir();
-    mock.module('../../../src/bootstrap/workingDir.ts', () => ({
-      getWorkingDir: () => tmp,
-      initWorkingDir: () => tmp,
-      _resetWorkingDir: () => {},
-    }));
-  });
-
-  afterEach(() => {
-    delete process.env.MINIMAL_AGENT_CWD;
-    _resetWorkingDir();
-    rmSync(tmp, { recursive: true, force: true });
-  });
-
-  it('cwd 下无 workflows/ 目录 → listWorkflows() 仍返回（packageRoot fallback 也只是空降级，不抛）', async () => {
-    const list = await listWorkflows();
-    // 至少应该包含包内自带的 book-review-short
-    expect(Array.isArray(list)).toBe(true);
-  });
-
-  it('cwd 下 workflows/ 全空 → 不抛，不增加任何条目', async () => {
-    mkdirSync(join(tmp, 'workflows'), { recursive: true });
-    const list = await listWorkflows();
-    expect(Array.isArray(list)).toBe(true);
-  });
-
-  it('cwd 下全是坏 yaml → 不抛，只跳过坏的', async () => {
-    mkdirSync(join(tmp, 'workflows'), { recursive: true });
-    writeYamlIn(tmp, 'bad1.yaml', 'name: x\n  : weird:::\n');
-    writeYamlIn(tmp, 'bad2.yaml', '@@@@@@\n');
-    const list = await listWorkflows();
-    // 不抛错，至少包内自带的仍然可见
-    expect(Array.isArray(list)).toBe(true);
-  });
-
-  it('/workflow unknown-name → yield error，无 workflow_start', async () => {
-    const events = await collect(
-      runWorkflowFromCommand('definitely-not-a-real-wf-xyz', {
-        provider: fakeProvider,
-        history: [],
-      }),
-    );
-    expect(events.some((e) => e.type === 'error')).toBe(true);
-    expect(events.some((e) => e.type === 'workflow_start')).toBe(false);
-  });
-
-  it('/workflow（不带 name）→ yield 用法提示 error', async () => {
-    const events = await collect(
-      runWorkflowFromCommand('', {
-        provider: fakeProvider,
-        history: [],
-      }),
-    );
-    const err = events.find(
-      (e): e is Extract<LoopEvent, { type: 'error' }> => e.type === 'error',
-    );
-    expect(err).toBeDefined();
-    expect(err!.error).toContain('/workflow');
-  });
-
-  it('/workflows 列表 yield text 事件 + turn_done', async () => {
-    const events = await collect(runWorkflowsList());
-    expect(events.some((e) => e.type === 'text')).toBe(true);
-    expect(events[events.length - 1].type).toBe('turn_done');
-  });
-
-  it('缺必填 input → yield error，不进入 runWorkflow', async () => {
-    // book-review-short 要求 book 必填
-    const events = await collect(
-      runWorkflowFromCommand('book-review-short', {
-        provider: fakeProvider,
-        history: [],
-      }),
-    );
-    const err = events.find(
-      (e): e is Extract<LoopEvent, { type: 'error' }> => e.type === 'error',
-    );
-    expect(err).toBeDefined();
-    expect(err!.error).toContain('book');
-    // 没有 workflow_start
-    expect(events.some((e) => e.type === 'workflow_start')).toBe(false);
-  });
-});
-
-function writeYamlIn(root: string, name: string, body: string) {
-  mkdirSync(join(root, 'workflows'), { recursive: true });
-  writeFileSync(join(root, 'workflows', name), body, 'utf8');
-}

package/plugins/workflow-runner/test/loader.test.ts

@@ -1,216 +0,0 @@
-/**
- * ============================================================
- *  test/workflows/loader.test.ts
- * ------------------------------------------------------------
- *  loader 单测：
- *    - 双源扫描：cwd 优先、packageRoot fallback
- *    - 一个坏 yaml 不污染其它工作流
- *    - 校验阻断：name/description/steps/动作字段
- *    - 内置 book-review-short.yaml 能被解析
- * ============================================================
- */
-
-import { afterEach, beforeEach, describe, expect, it, mock } from 'bun:test';
-import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-
-import { _resetWorkingDir } from '../../../src/bootstrap/workingDir.ts';
-import {
-  findWorkflowByName,
-  listWorkflows,
-  parseWorkflowFile,
-  WorkflowLoadError,
-} from '../src/loader.ts';
-
-describe('workflows/loader', () => {
-  let tmp: string;
-
-  beforeEach(() => {
-    tmp = mkdtempSync(join(tmpdir(), 'wf-loader-'));
-    process.env.MINIMAL_AGENT_CWD = tmp;
-    _resetWorkingDir();
-    // 抵抗其它测试文件（如 pluginRunner.test.ts）通过 mock.module 留下的
-    // workingDir.ts 全局替身——把 getWorkingDir 重新指回本测试的 tmp。
-    mock.module('../../../src/bootstrap/workingDir.ts', () => ({
-      getWorkingDir: () => tmp,
-      initWorkingDir: () => tmp,
-      _resetWorkingDir: () => {},
-    }));
-  });
-
-  afterEach(() => {
-    delete process.env.MINIMAL_AGENT_CWD;
-    _resetWorkingDir();
-    rmSync(tmp, { recursive: true, force: true });
-  });
-
-  function writeYaml(name: string, body: string) {
-    mkdirSync(join(tmp, 'workflows'), { recursive: true });
-    writeFileSync(join(tmp, 'workflows', name), body, 'utf8');
-  }
-
-  it('cwd 下放 yaml 能被 listWorkflows 发现', async () => {
-    writeYaml(
-      'my.yaml',
-      `name: my-wf
-description: hello
-steps:
-  - id: a
-    tool: Read
-    args: { file_path: a.txt }
-`,
-    );
-
-    const list = await listWorkflows();
-    expect(list.find((w) => w.name === 'my-wf')).toBeDefined();
-  });
-
-  it('packageRoot 自带 book-review-short 也能被发现（fallback 路径）', async () => {
-    const list = await listWorkflows();
-    expect(list.find((w) => w.name === 'book-review-short')).toBeDefined();
-  });
-
-  it('cwd 同名 workflow 覆盖 packageRoot', async () => {
-    writeYaml(
-      'override.yaml',
-      `name: book-review-short
-description: cwd override
-steps:
-  - id: only
-    type: assert
-    condition: 'true'
-`,
-    );
-    const def = await findWorkflowByName('book-review-short');
-    expect(def).not.toBeNull();
-    expect(def!.description).toBe('cwd override');
-  });
-
-  it('坏 yaml 不污染其他 workflow（继续列出好的）', async () => {
-    writeYaml('good.yaml', `name: good
-description: ok
-steps:
-  - id: x
-    type: assert
-    condition: 'true'
-`);
-    writeYaml('bad.yaml', 'name: bad\n  bad-indent\n: garbage:::\n');
-
-    const list = await listWorkflows();
-    expect(list.find((w) => w.name === 'good')).toBeDefined();
-    // bad.yaml 不应阻塞其它，也不应被列出
-    expect(list.find((w) => w.name === 'bad')).toBeUndefined();
-  });
-
-  it('findWorkflowByName 未命中返回 null', async () => {
-    const def = await findWorkflowByName('nonexistent-wf-xyz');
-    expect(def).toBeNull();
-  });
-
-  it('listWorkflows 对完全缺失 workflows/ 不抛错', async () => {
-    // 没有 workflows 目录，只有 packageRoot fallback
-    const list = await listWorkflows();
-    expect(Array.isArray(list)).toBe(true);
-  });
-});
-
-describe('workflows/loader::validate', () => {
-  let tmp: string;
-
-  beforeEach(() => {
-    tmp = mkdtempSync(join(tmpdir(), 'wf-loader-v-'));
-  });
-
-  afterEach(() => {
-    rmSync(tmp, { recursive: true, force: true });
-  });
-
-  function writeRaw(body: string): string {
-    const p = join(tmp, 'wf.yaml');
-    writeFileSync(p, body, 'utf8');
-    return p;
-  }
-
-  it('缺 name → 抛 WorkflowLoadError', async () => {
-    const p = writeRaw('description: x\nsteps:\n  - id: a\n    type: assert\n    condition: "true"\n');
-    await expect(parseWorkflowFile(p)).rejects.toThrow(WorkflowLoadError);
-  });
-
-  it('缺 description → 抛错', async () => {
-    const p = writeRaw('name: x\nsteps:\n  - id: a\n    type: assert\n    condition: "true"\n');
-    await expect(parseWorkflowFile(p)).rejects.toThrow();
-  });
-
-  it('steps 空数组 → 抛错', async () => {
-    const p = writeRaw('name: x\ndescription: y\nsteps: []\n');
-    await expect(parseWorkflowFile(p)).rejects.toThrow();
-  });
-
-  it('step 没有任何动作字段 → 抛错', async () => {
-    const p = writeRaw('name: x\ndescription: y\nsteps:\n  - id: a\n');
-    await expect(parseWorkflowFile(p)).rejects.toThrow();
-  });
-
-  it('step 同时设置 tool + llm → 抛错', async () => {
-    const p = writeRaw(`name: x
-description: y
-steps:
-  - id: a
-    tool: Read
-    llm: "say hi"
-`);
-    await expect(parseWorkflowFile(p)).rejects.toThrow();
-  });
-
-  it('assert step 缺 condition → 抛错', async () => {
-    const p = writeRaw(`name: x
-description: y
-steps:
-  - id: a
-    type: assert
-`);
-    await expect(parseWorkflowFile(p)).rejects.toThrow();
-  });
-
-  it('同级 steps id 重复 → 抛错', async () => {
-    const p = writeRaw(`name: x
-description: y
-steps:
-  - id: dup
-    type: assert
-    condition: 'true'
-  - id: dup
-    type: assert
-    condition: 'true'
-`);
-    await expect(parseWorkflowFile(p)).rejects.toThrow();
-  });
-
-  it('合法 yaml 通过 + __source 字段被注入', async () => {
-    const p = writeRaw(`name: ok-wf
-description: nice
-steps:
-  - id: a
-    tool: Read
-    args: { file_path: x.txt }
-`);
-    const def = await parseWorkflowFile(p);
-    expect(def.name).toBe('ok-wf');
-    expect(def.__source).toBe(p);
-  });
-
-  it('inputs[].type=enum 缺 values → 抛错', async () => {
-    const p = writeRaw(`name: x
-description: y
-inputs:
-  - name: foo
-    type: enum
-steps:
-  - id: a
-    type: assert
-    condition: 'true'
-`);
-    await expect(parseWorkflowFile(p)).rejects.toThrow();
-  });
-});