@zeroseed/sdk

ZeroSeed CLI 的 Node.js ESM SDK。要求 Node.js 20 或更高版本，并由调用方显式 提供兼容的 zeroseed 可执行文件路径。

npm install @zeroseed/sdk

import { ZeroSeed } from "@zeroseed/sdk";

const client = new ZeroSeed({ zeroseedPath: "/opt/zeroseed/bin/zeroseed" });
const thread = client.startThread();
const turn = await thread.run("检查当前项目");

console.log(thread.id, turn.finalResponse);

流式调用通过 runStreamed() 返回按 CLI JSONL 顺序产生事件的异步生成器：

const { events } = await thread.runStreamed("继续检查");
for await (const event of events) {
  if (event.type === "item.streaming") {
    process.stdout.write(event.delta);
  }
}

客户端还提供 usage、plugins、configuration、docs、system 管理 API， 以及用于未来或仓库专用非交互命令的 commands.runJson() / runText() 低层入口。 恢复旧 Session 时可通过 migrateAssetBundle: true 显式迁移行为资产。

该包不查找、下载或打包 ZeroSeed 二进制，不直接访问 ZeroSeed 的配置、数据库或 Session 日志，也不自动化 REPL 或 config setup/edit 等 TTY 交互。