@fastagent/bin

@fastagent/bin 提供 FastAgent 的预编译 standalone binary，供 desktop 或其他 first-party bundler 消费。

如果你是终端用户，请安装 @fastagent/cli，不要直接安装这个包。

适用场景

这个包适合：

• desktop 应用在发布时 bundle 固定版本的 fastagent
• 集成方按版本 pin 住 tarball，并在构建时解包出目标平台 binary

这个包不适合：

• 直接 npm install -g 当作用户 CLI 使用
• 在消费端重新编译 FastAgent 源码

包内容

tarball 内包含：

• manifest.json
• fastagent-acp-profile.json
• darwin-arm64/fastagent
• darwin-x64/fastagent
• linux-x64/fastagent
• windows-x64/fastagent.exe

manifest.json 会给出：

• 包版本
• 各平台 binary 的相对路径
• 各平台 binary 的 sha256

fastagent-acp-profile.json 会给出：

• FastAgent ACP profile 的 profile.name/version
• server ext methods
• required client callback methods
• desktop compatibility 所需的 required ext method 子集

推荐消费方式

1. 在你的发布配置里 pin @fastagent/bin 的精确版本
2. 从 npm registry 下载对应版本 tarball
3. 校验 npm 返回的 dist.integrity
4. 解包后读取 manifest.json
5. 按当前目标平台提取对应 binary
6. 再按 manifest.json 中的 sha256 做一次校验
7. 将校验通过的 binary bundle 进你的应用

平台映射

• macOS Apple Silicon: darwin-arm64/fastagent
• macOS Intel: darwin-x64/fastagent
• Linux x64: linux-x64/fastagent
• Windows x64: windows-x64/fastagent.exe

版本规则

@fastagent/bin 的版本与 @fastagent/cli 对齐，因为 binary payload 本身就是 FastAgent CLI runtime。