NeuroAgentHarness

一个面向多宿主的 Agent Harness：提供 Profile、Run Kernel、append-only Session、Invocation 生命周期、approval、compaction、顺序/并行工具循环、事件恢复，以及可替换的 Session Store 与 Model Runtime。

当前阶段是独立库开发与合同验证，已通过 llmlint 的 analysis/optimize 灰度 Adapter 验证为第二消费者；NeuroBook 仍未接入。

安装

bun add @notnotype/[email protected]

Node.js 22 ESM 项目也可以使用 npm 安装；包内只包含编译后的 ESM、类型声明、文档和许可证。

设计目标

• 默认保留 sessionId: number 与 JSONL Session 存储。
• JSONL 只是第一方 Adapter；测试使用 Memory Store，未来可接 Prisma。
• NeuroBook 的 NeuroSessionContext、Skill Catalog、Variables、Profile Home、Low-Code Form、Project Workspace 通过 Session projection、Host Context、Capability 和 Profile Facet 承载，Core 不硬依赖这些产品概念。
• Snapshot 是恢复真相源；事件使用 (eventEpoch, seq) cursor。
• Tool 和 Profile 不获得完整 Harness 或 Store，避免穿透 Module。
• approval waiting/resume、compaction 切分与并行 Tool commit 顺序由 Harness 统一维护。
• steer/follow-up 由 Invocation Coordinator 管理；summarizer 等后台任务通过 commit Workflow Scheduler 扩展。
• JSONL 默认保持完整 Snapshot record，也可启用 delta + checkpoint 实验模式。
• 宿主可以在 settleFailure Hook 返回结构化 output；Harness 会在 abort/failed terminal commit 前持久化它，支持改写类 Profile 保留部分结果。

开发

bun install
bun run verify
bun run pack:smoke

包结构

• 根导出：Harness、Profile、Tool、Capability、Session/Event/Model 合同。
• storage/memory：测试与本地原型 Adapter。
• storage/jsonl：正式 JSONL Adapter，默认正整数 Session ID。
• testing：Scripted Model Runtime 等黑盒测试工具。

许可证

AGPL-3.0-only。