[KevinZhang19870314]

为什么要改

platform 侧（agenzo-platform MR !495，已合并到 develop）给 data-aisa 的 describe / search 加了 price_estimate_usd：当 price_usd 为 null（按用量计价、事前不可知）时，给出一个数量级估价。

verb-schema.ts 是 agent 读的运行时契约。响应里出现了字段但 schema 不声明，agent 就不知道它存在 —— 于是在一个可能超过 2 USD 的调用前毫无预期地直接下手。所以这个声明必须跟着 platform 一起落地，不能等。

改了什么

dataDescribeSchema.response

新增 price_estimate_usd，并把 price_usd 的说明写准确：

	说明
旧	null = not knowable in advance; the actual amount comes back as cost_usd.
新	0 明确为免费；null 说成"没有固定价（按用量计价）"，并分别指向 price_estimate_usd 看量级、cost_usd 看实付

price_estimate_usd 的说明里写了两件事，都是刻意的：

1. 只在 price_usd 为 null 时出现 —— 两者互斥，不会同时给。有确定价的时候再给一个估价，只会让调用方犹豫该看哪个。
2. 它不是承诺价，只给量级。措辞里直接点出"有些单次调用超过 2 USD" —— 这个量级信息就是它存在的全部理由，不写出来这个字段等于白给。

dataSearchSchema.response.results

条目说明同步补上该字段，口径与 describe 一致（{operationId, method, tags, summary, price_usd} 加上 price_usd 为 null 时的 price_estimate_usd）。

版本

@agenzo/merchant-cli 0.10.2 → 0.10.3。纯新增字段声明，对既有调用方向后兼容，走 patch 位。

合并后发 npm，下游 agenzo-agent-orchestrator-base 的 Dockerfile 里 ARG MERCHANT_CLI_VERSION 会跟着升到 0.10.3。

验证

• tsc --noEmit → 退出码 0
• vitest run → 1007 passed / 2 skipped（66 文件通过；skip 的 hotel-e2e 需要真实环境）
• npm run build → 五个包全部 build success，merchant-cli 产物按 0.10.3 打出