示例

以下示例只使用当前 experimental public contract。

Node.js 一次性任务

import { NextclawHarness } from '@nextclaw/harness';
import { NodePlatform } from '@nextclaw/kernel';

const harness = new NextclawHarness({ platform: new NodePlatform() });
try {
  await harness.start();
  const result = await harness.runTask({ input: '给我一份仓库检查清单' });
  console.log(result.text);
} finally { await harness.dispose(); }

长生命周期 Harness

同一个 Harness 可以运行多次任务。每次省略 sessionId 都会创建新的 exec:<uuid> session；需要连续上下文时显式传入相同 session id。

import { NextclawHarness } from '@nextclaw/harness';
import { NodePlatform } from '@nextclaw/kernel';

const harness = new NextclawHarness({ platform: new NodePlatform() });
await harness.start();
try {
  const first = await harness.runTask({ input: '建立项目摘要', sessionId: 'project-review' });
  const second = await harness.runTask({ input: '基于刚才的摘要列出风险', sessionId: 'project-review' });
  console.log(first.text, second.text);
} finally {
  await harness.dispose();
}

CI 与 JSONL

set -o pipefail
nextclaw exec --format jsonl --timeout 60000 "运行检查并解释结果" \
  > agent-events.jsonl

CI 可以逐行消费 agent-events.jsonl，并用进程退出码判断成功、输入错误、取消或运行失败。需要把上下文附加到 prompt 时，可通过 stdin 管道传入。