打包发布

Ageniti 可以把同一个 app definition 转成可分发的 CLI、MCP、manifest 和 skill 文档产物。

会生成什么

bundle target 会写出:

ageniti.manifest.json
ageniti.actions.json
ageniti.mcp.json
cli.mjs
mcp-stdio.mjs
GUIDE.md
package.json
README.md
ageniti.bundle.json

这些文件描述 app、提供可运行 launcher,并让 app 可以被安装或审查。

必需的 App Module

Launcher target 需要一个 Node-safe module 来 export 你的 Ageniti app。

src/ageniti/app.js

不要从这个入口 import React components、browser-only APIs、route files 或 mobile runtime code。

Build

task-app build bundle --app-module ./src/ageniti/app.js --app-export app --out-dir ./dist/ageniti

如果项目里有 ageniti.config.json,build command 可以读取其中的默认配置。

Package

task-app package --app-module ./src/ageniti/app.js --app-export app --out-dir ./dist/ageniti

这个命令会构建 bundle,并在生成的 output directory 里运行 npm pack

Publish

task-app publish --app-module ./src/ageniti/app.js --app-export app --out-dir ./dist/ageniti

publish 默认是 dry run。只有确定要真实发布时,才传 --live

task-app publish --live --access public --tag latest --app-module ./src/ageniti/app.js --app-export app --out-dir ./dist/ageniti

MCP Descriptor

ageniti.mcp.json 包含 command metadata,以及常见 MCP host 的配置片段。生成的 stdio command 指向:

node ./mcp-stdio.mjs

Skill 文档

GUIDE.md 从 app 和 action metadata 生成。它给 Agent、coding assistant 和自动化系统提供一份紧凑的能力使用说明。

发布前审查

发布新 bundle 前建议:

  • 检查 ageniti.manifest.json
  • 检查 ageniti.actions.json
  • 检查 ageniti.mcp.json
  • 运行生成的 cli.mjs
  • 用 MCP host 测试生成的 mcp-stdio.mjs
  • task-app diff 对比新旧 manifests